feat: release v0.26 portable i18n and presentation adapters

errors/catalog.go

@@ -9,16 +9,19 @@ import (
 	"math"
 	"reflect"
 	"strings"
+	"unicode"
+	"unicode/utf8"
 )
 
 // Definition belongs to the project. Code is the public string/integer code;
 // the Catalog map key is the distinct logical identifier used by ByCode.
 // Nil Code retains legacy response code mapping (useful when migrating).
 type Definition struct {
-	Status  int         `json:"status,omitempty"`
-	Code    any         `json:"code,omitempty"`
-	Message string      `json:"message"`
-	Params  []Parameter `json:"params,omitempty"`
+	Status      int          `json:"status,omitempty"`
+	Code        any          `json:"code,omitempty"`
+	Message     string       `json:"message"`
+	Params      []Parameter  `json:"params,omitempty"`
+	Translation *Translation `json:"translation,omitempty"`
 }
 
 type Catalog struct {
@@ -99,6 +102,10 @@ func (c Catalog) Clone() Catalog {
 	out := c
 	out.Definitions = make(map[string]Definition, len(c.Definitions))
 	for key, d := range c.Definitions {
+		if d.Translation != nil {
+			ref := *d.Translation
+			d.Translation = &ref
+		}
 		if d.Params != nil {
 			params := make([]Parameter, len(d.Params))
 			copy(params, d.Params)
@@ -126,6 +133,13 @@ func NewRegistry(c Catalog) (*Registry, error) {
 	}
 	messages := map[string][]messagePart{}
 	for key, d := range c.Definitions {
+		if d.Translation != nil {
+			for _, value := range []string{d.Translation.Namespace, d.Translation.Key} {
+				if value == "" || len(value) > 256 || !utf8.ValidString(value) || strings.TrimSpace(value) != value || strings.IndexFunc(value, unicode.IsControl) >= 0 {
+					return nil, fmt.Errorf("errors: %s has invalid translation reference", key)
+				}
+			}
+		}
 		if strings.TrimSpace(key) == "" || strings.TrimSpace(key) != key || strings.ContainsAny(key, "\r\n\t") {
 			return nil, fmt.Errorf("errors: invalid logical identifier %q", key)
 		}