@digitaldefiance/i18n-lib 3.6.4 → 3.7.0

package/src/errors/translatable-generic.d.ts

@@ -1,6 +1,35 @@
 import { I18nEngine } from '../core';
+import { GenderCategory } from '../gender/gender-categories';
 /**
- * Generic translatable error that works with any plugin engine and component
+ * Generic translatable error that works with any plugin engine and component.
+ *
+ * **Full i18n 3.0/3.5 Feature Support:**
+ * - ICU MessageFormat (all formatters: plural, select, selectordinal)
+ * - Pluralization for 37 languages with CLDR rules
+ * - Gender-aware translations (male, female, neutral, other)
+ * - Number formatting (integer, currency, percent)
+ * - Date/Time formatting (short, medium, long, full)
+ * - Nested messages up to 4 levels deep
+ * - Context variable injection
+ *
+ * **Usage Examples:**
+ * ```typescript
+ * // Plural-aware error
+ * new TranslatableGenericError('component', 'errorKey', { count: 5 });
+ * // Translation: \"{count, plural, one {# error} other {# errors}}\"
+ *
+ * // Gender-aware error
+ * new TranslatableGenericError('component', 'userError', { gender: 'female', name: 'Alice' });
+ * // Translation: \"{gender, select, male {He} female {She}} {name} caused an error\"
+ *
+ * // Number formatting
+ * new TranslatableGenericError('component', 'thresholdError', { value: 1500.50, limit: 1000 });
+ * // Translation: \"Value {value, number, currency} exceeds {limit, number, currency}\"
+ *
+ * // SelectOrdinal
+ * new TranslatableGenericError('component', 'stepError', { step: 3 });
+ * // Translation: \"Failed at {step, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} step\"
+ * ```
  */
 export declare class TranslatableGenericError<TStringKey extends string = string> extends Error {
     readonly stringKey: TStringKey;
@@ -26,5 +55,30 @@ export declare class TranslatableGenericError<TStringKey extends string = string
      * Retranslate the error message in a different language
      */
     retranslate(language: string, instanceKey?: string): string;
+    /**
+     * Create error with plural count
+     * Translation string should use ICU plural format
+     */
+    static withCount<TStringKey extends string>(componentId: string, stringKey: TStringKey, count: number, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string): TranslatableGenericError<TStringKey>;
+    /**
+     * Create error with gender context
+     * Translation string should use ICU select format
+     */
+    static withGender<TStringKey extends string>(componentId: string, stringKey: TStringKey, gender: GenderCategory, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string): TranslatableGenericError<TStringKey>;
+    /**
+     * Create error with ordinal number
+     * Translation string should use ICU selectordinal format
+     */
+    static withOrdinal<TStringKey extends string>(componentId: string, stringKey: TStringKey, ordinalNumber: number, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string): TranslatableGenericError<TStringKey>;
+    /**
+     * Create error with number formatting
+     * Translation string should use ICU number format
+     */
+    static withNumberFormat<TStringKey extends string>(componentId: string, stringKey: TStringKey, value: number, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string): TranslatableGenericError<TStringKey>;
+    /**
+     * Create error with multiple i18n features combined
+     * Translation string can use nested ICU messages
+     */
+    static withMultipleFeatures<TStringKey extends string>(componentId: string, stringKey: TStringKey, features: Record<string, string | number>, language?: string, instanceKey?: string): TranslatableGenericError<TStringKey>;
 }
 //# sourceMappingURL=translatable-generic.d.ts.map

package/src/errors/translatable-generic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translatable-generic.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-generic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,qBAAa,wBAAwB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IACrF,SAAgB,SAAS,EAAE,UAAU,CAAC;IACtC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5D,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/C;;;;;;;;OAQG;gBAED,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM;IA0BtB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,SAAS,MAAM,EACzC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,wBAAwB,CAAC,UAAU,CAAC;IAqBvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;CAa5D"}
+{"version":3,"file":"translatable-generic.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-generic.ts"],"names":[],"mappings":"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"}

package/src/errors/translatable-generic.js

@@ -3,7 +3,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TranslatableGenericError = void 0;
 const core_1 = require("../core");
 /**
- * Generic translatable error that works with any plugin engine and component
+ * Generic translatable error that works with any plugin engine and component.
+ *
+ * **Full i18n 3.0/3.5 Feature Support:**
+ * - ICU MessageFormat (all formatters: plural, select, selectordinal)
+ * - Pluralization for 37 languages with CLDR rules
+ * - Gender-aware translations (male, female, neutral, other)
+ * - Number formatting (integer, currency, percent)
+ * - Date/Time formatting (short, medium, long, full)
+ * - Nested messages up to 4 levels deep
+ * - Context variable injection
+ *
+ * **Usage Examples:**
+ * ```typescript
+ * // Plural-aware error
+ * new TranslatableGenericError('component', 'errorKey', { count: 5 });
+ * // Translation: \"{count, plural, one {# error} other {# errors}}\"
+ *
+ * // Gender-aware error
+ * new TranslatableGenericError('component', 'userError', { gender: 'female', name: 'Alice' });
+ * // Translation: \"{gender, select, male {He} female {She}} {name} caused an error\"
+ *
+ * // Number formatting
+ * new TranslatableGenericError('component', 'thresholdError', { value: 1500.50, limit: 1000 });
+ * // Translation: \"Value {value, number, currency} exceeds {limit, number, currency}\"
+ *
+ * // SelectOrdinal
+ * new TranslatableGenericError('component', 'stepError', { step: 3 });
+ * // Translation: \"Failed at {step, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} step\"
+ * ```
  */
 class TranslatableGenericError extends Error {
     stringKey;
@@ -66,6 +94,41 @@ class TranslatableGenericError extends Error {
             return `[${this.componentId}.${this.stringKey}]`;
         }
     }
+    /**
+     * Create error with plural count
+     * Translation string should use ICU plural format
+     */
+    static withCount(componentId, stringKey, count, otherVars, language, instanceKey) {
+        return new TranslatableGenericError(componentId, stringKey, { ...otherVars, count }, language, undefined, instanceKey);
+    }
+    /**
+     * Create error with gender context
+     * Translation string should use ICU select format
+     */
+    static withGender(componentId, stringKey, gender, otherVars, language, instanceKey) {
+        return new TranslatableGenericError(componentId, stringKey, { ...otherVars, gender }, language, undefined, instanceKey);
+    }
+    /**
+     * Create error with ordinal number
+     * Translation string should use ICU selectordinal format
+     */
+    static withOrdinal(componentId, stringKey, ordinalNumber, otherVars, language, instanceKey) {
+        return new TranslatableGenericError(componentId, stringKey, { ...otherVars, ordinalNumber }, language, undefined, instanceKey);
+    }
+    /**
+     * Create error with number formatting
+     * Translation string should use ICU number format
+     */
+    static withNumberFormat(componentId, stringKey, value, otherVars, language, instanceKey) {
+        return new TranslatableGenericError(componentId, stringKey, { ...otherVars, value }, language, undefined, instanceKey);
+    }
+    /**
+     * Create error with multiple i18n features combined
+     * Translation string can use nested ICU messages
+     */
+    static withMultipleFeatures(componentId, stringKey, features, language, instanceKey) {
+        return new TranslatableGenericError(componentId, stringKey, features, language, undefined, instanceKey);
+    }
 }
 exports.TranslatableGenericError = TranslatableGenericError;
 //# sourceMappingURL=translatable-generic.js.map

package/src/errors/translatable-generic.js.map

@@ -1 +1 @@
-{"version":3,"file":"translatable-generic.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-generic.ts"],"names":[],"mappings":";;;AAAA,kCAAqC;AAErC;;GAEG;AACH,MAAa,wBAA6D,SAAQ,KAAK;IACrE,SAAS,CAAa;IACtB,WAAW,CAAS;IACpB,QAAQ,CAAU;IAClB,SAAS,CAAmC;IAC5C,QAAQ,CAAuB;IAE/C;;;;;;;;OAQG;IACH,YACE,WAAmB,EACnB,SAAqB,EACrB,SAA2C,EAC3C,QAAiB,EACjB,QAA8B,EAC9B,WAAoB;QAEpB,IAAI,iBAAyB,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,iBAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACnD,iBAAiB,GAAG,MAAM,CAAC,aAAa,CACtC,WAAW,EACX,SAAS,EACT,SAAS,EACT,QAAQ,CACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gEAAgE;YAChE,iBAAiB,GAAG,IAAI,WAAW,IAAI,SAAS,GAAG,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,MAAkB,EAClB,WAAmB,EACnB,SAAqB,EACrB,SAA2C,EAC3C,QAAiB,EACjB,QAA8B;QAE9B,MAAM,iBAAiB,GAAG,MAAM,CAAC,aAAa,CAC5C,WAAW,EACX,SAAS,EACT,SAAS,EACT,QAAQ,CACT,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACxC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;QAChC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1B,KAAK,CAAC,OAAO,GAAG,iBAAiB,CAAC;QAElC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB,EAAE,WAAoB;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,iBAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC,aAAa,CACzB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,EACd,QAAQ,CACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AA/FD,4DA+FC"}
+{"version":3,"file":"translatable-generic.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-generic.ts"],"names":[],"mappings":"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"}

package/src/errors/translatable-handleable-generic.d.ts

@@ -1,7 +1,49 @@
 import { IHandleable } from '../interfaces/handleable';
 import { TranslatableGenericError } from './translatable-generic';
+import { GenderCategory } from '../gender/gender-categories';
 /**
- * Generic translatable error that works with any plugin engine and component
+ * Generic translatable handleable error with full i18n feature support.
+ *
+ * Combines translation capabilities with handleable error patterns and provides
+ * static factory methods for all i18n features.
+ *
+ * **Supported i18n Features:**
+ * - ICU MessageFormat: plural, select, selectordinal
+ * - Pluralization: 37 languages with CLDR rules
+ * - Gender support: male, female, neutral, other
+ * - Number formatting: integer, currency, percent
+ * - Nested messages: complex multi-level patterns
+ *
+ * **Usage Examples:**
+ * ```typescript
+ * // Pluralization with handleable options
+ * throw TranslatableHandleableGenericError.withCount(
+ *   'api', 'validationError', 5,
+ *   {}, 'en-US', 'default',
+ *   { statusCode: 400 }
+ * );
+ *
+ * // Gender-aware messages
+ * throw TranslatableHandleableGenericError.withGender(
+ *   'user', 'accountError', 'female',
+ *   {}, 'en-US', 'default',
+ *   { statusCode: 403 }
+ * );
+ *
+ * // Number formatting with error handling
+ * throw TranslatableHandleableGenericError.withNumberFormat(
+ *   'payment', 'amountExceeded', 1599.99,
+ *   { limit: 1000 }, 'en-US', 'default',
+ *   { statusCode: 402 }
+ * );
+ *
+ * // Ordinal formatting (1st, 2nd, 3rd)
+ * throw TranslatableHandleableGenericError.withOrdinal(
+ *   'workflow', 'stepFailed', 3,
+ *   {}, 'en-US', 'default',
+ *   { statusCode: 500, retryable: true }
+ * );
+ * ```
  */
 export declare class TranslatableHandleableGenericError<TStringKey extends string = string> extends TranslatableGenericError<TStringKey> implements IHandleable {
     private _handled;
@@ -25,5 +67,50 @@ export declare class TranslatableHandleableGenericError<TStringKey extends strin
     get handled(): boolean;
     set handled(value: boolean);
     toJSON(): Record<string, unknown>;
+    /**
+     * Create error with pluralization support
+     * Translation string should include: "{count, plural, one {...} other {...}}"
+     */
+    static withCount<TStringKey extends string>(componentId: string, stringKey: TStringKey, count: number, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string, handleableOptions?: {
+        statusCode?: number;
+        cause?: Error;
+        sourceData?: unknown;
+    }): TranslatableHandleableGenericError<TStringKey>;
+    /**
+     * Create error with gender-aware messages
+     * Translation string should include: "{gender, select, male {...} female {...} other {...}}"
+     */
+    static withGender<TStringKey extends string>(componentId: string, stringKey: TStringKey, gender: GenderCategory, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string, handleableOptions?: {
+        statusCode?: number;
+        cause?: Error;
+        sourceData?: unknown;
+    }): TranslatableHandleableGenericError<TStringKey>;
+    /**
+     * Create error with ordinal formatting (1st, 2nd, 3rd)
+     * Translation string should include: "{number, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}"
+     */
+    static withOrdinal<TStringKey extends string>(componentId: string, stringKey: TStringKey, ordinalNumber: number, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string, handleableOptions?: {
+        statusCode?: number;
+        cause?: Error;
+        sourceData?: unknown;
+    }): TranslatableHandleableGenericError<TStringKey>;
+    /**
+     * Create error with number formatting (currency, percent, integer)
+     * Translation string should include: "{value, number, integer}" or "{amount, number, currency}"
+     */
+    static withNumberFormat<TStringKey extends string>(componentId: string, stringKey: TStringKey, value: number, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string, handleableOptions?: {
+        statusCode?: number;
+        cause?: Error;
+        sourceData?: unknown;
+    }): TranslatableHandleableGenericError<TStringKey>;
+    /**
+     * Create error with multiple i18n features combined
+     * Translation string can combine: plural, select, number formatting, etc.
+     */
+    static withMultipleFeatures<TStringKey extends string>(componentId: string, stringKey: TStringKey, features: Record<string, string | number>, language?: string, instanceKey?: string, handleableOptions?: {
+        statusCode?: number;
+        cause?: Error;
+        sourceData?: unknown;
+    }): TranslatableHandleableGenericError<TStringKey>;
 }
 //# sourceMappingURL=translatable-handleable-generic.d.ts.map

package/src/errors/translatable-handleable-generic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translatable-handleable-generic.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-handleable-generic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;GAEG;AACH,qBAAa,kCAAkC,CAC3C,UAAU,SAAS,MAAM,GAAG,MAAM,CAEpC,SAAQ,wBAAwB,CAAC,UAAU,CAC3C,YAAW,WAAW;IAEtB,OAAO,CAAC,QAAQ,CAAS;IACzB,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;IACvC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,UAAU,CAAC,EAAE,OAAO,CAAC;IAErC;;;;;;;;OAQG;gBAED,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB;IAQH,IAAW,OAAO,IAAI,OAAO,CAE5B;IACD,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAEhC;IACD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}
+{"version":3,"file":"translatable-handleable-generic.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-handleable-generic.ts"],"names":[],"mappings":"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"}

package/src/errors/translatable-handleable-generic.js

@@ -3,7 +3,48 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TranslatableHandleableGenericError = void 0;
 const translatable_generic_1 = require("./translatable-generic");
 /**
- * Generic translatable error that works with any plugin engine and component
+ * Generic translatable handleable error with full i18n feature support.
+ *
+ * Combines translation capabilities with handleable error patterns and provides
+ * static factory methods for all i18n features.
+ *
+ * **Supported i18n Features:**
+ * - ICU MessageFormat: plural, select, selectordinal
+ * - Pluralization: 37 languages with CLDR rules
+ * - Gender support: male, female, neutral, other
+ * - Number formatting: integer, currency, percent
+ * - Nested messages: complex multi-level patterns
+ *
+ * **Usage Examples:**
+ * ```typescript
+ * // Pluralization with handleable options
+ * throw TranslatableHandleableGenericError.withCount(
+ *   'api', 'validationError', 5,
+ *   {}, 'en-US', 'default',
+ *   { statusCode: 400 }
+ * );
+ *
+ * // Gender-aware messages
+ * throw TranslatableHandleableGenericError.withGender(
+ *   'user', 'accountError', 'female',
+ *   {}, 'en-US', 'default',
+ *   { statusCode: 403 }
+ * );
+ *
+ * // Number formatting with error handling
+ * throw TranslatableHandleableGenericError.withNumberFormat(
+ *   'payment', 'amountExceeded', 1599.99,
+ *   { limit: 1000 }, 'en-US', 'default',
+ *   { statusCode: 402 }
+ * );
+ *
+ * // Ordinal formatting (1st, 2nd, 3rd)
+ * throw TranslatableHandleableGenericError.withOrdinal(
+ *   'workflow', 'stepFailed', 3,
+ *   {}, 'en-US', 'default',
+ *   { statusCode: 500, retryable: true }
+ * );
+ * ```
  */
 class TranslatableHandleableGenericError extends translatable_generic_1.TranslatableGenericError {
     _handled = false;
@@ -40,6 +81,41 @@ class TranslatableHandleableGenericError extends translatable_generic_1.Translat
             sourceData: this.sourceData,
         };
     }
+    /**
+     * Create error with pluralization support
+     * Translation string should include: "{count, plural, one {...} other {...}}"
+     */
+    static withCount(componentId, stringKey, count, otherVars, language, instanceKey, handleableOptions) {
+        return new TranslatableHandleableGenericError(componentId, stringKey, { count, ...otherVars }, language, undefined, instanceKey, handleableOptions);
+    }
+    /**
+     * Create error with gender-aware messages
+     * Translation string should include: "{gender, select, male {...} female {...} other {...}}"
+     */
+    static withGender(componentId, stringKey, gender, otherVars, language, instanceKey, handleableOptions) {
+        return new TranslatableHandleableGenericError(componentId, stringKey, { gender, ...otherVars }, language, undefined, instanceKey, handleableOptions);
+    }
+    /**
+     * Create error with ordinal formatting (1st, 2nd, 3rd)
+     * Translation string should include: "{number, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}"
+     */
+    static withOrdinal(componentId, stringKey, ordinalNumber, otherVars, language, instanceKey, handleableOptions) {
+        return new TranslatableHandleableGenericError(componentId, stringKey, { number: ordinalNumber, ...otherVars }, language, undefined, instanceKey, handleableOptions);
+    }
+    /**
+     * Create error with number formatting (currency, percent, integer)
+     * Translation string should include: "{value, number, integer}" or "{amount, number, currency}"
+     */
+    static withNumberFormat(componentId, stringKey, value, otherVars, language, instanceKey, handleableOptions) {
+        return new TranslatableHandleableGenericError(componentId, stringKey, { value, ...otherVars }, language, undefined, instanceKey, handleableOptions);
+    }
+    /**
+     * Create error with multiple i18n features combined
+     * Translation string can combine: plural, select, number formatting, etc.
+     */
+    static withMultipleFeatures(componentId, stringKey, features, language, instanceKey, handleableOptions) {
+        return new TranslatableHandleableGenericError(componentId, stringKey, features, language, undefined, instanceKey, handleableOptions);
+    }
 }
 exports.TranslatableHandleableGenericError = TranslatableHandleableGenericError;
 //# sourceMappingURL=translatable-handleable-generic.js.map

package/src/errors/translatable-handleable-generic.js.map

@@ -1 +1 @@
-{"version":3,"file":"translatable-handleable-generic.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-handleable-generic.ts"],"names":[],"mappings":";;;AACA,iEAAkE;AAElE;;GAEG;AACH,MAAa,kCAGX,SAAQ,+CAAoC;IAGpC,QAAQ,GAAG,KAAK,CAAC;IACA,KAAK,CAAS;IACvB,UAAU,CAAS;IACnB,UAAU,CAAW;IAErC;;;;;;;;OAQG;IACH,YACE,WAAmB,EACnB,SAAqB,EACrB,SAA2C,EAC3C,QAAiB,EACjB,QAA8B,EAC9B,WAAoB,EACpB,iBAIC;QAED,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,GAAG,iBAAiB,EAAE,UAAU,IAAI,GAAG,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,iBAAiB,EAAE,KAAK,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,iBAAiB,EAAE,UAAU,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACnD,CAAC;IACD,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IACD,IAAW,OAAO,CAAC,KAAc;QAC/B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,MAAM;QACJ,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF;AArDD,gFAqDC"}
+{"version":3,"file":"translatable-handleable-generic.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-handleable-generic.ts"],"names":[],"mappings":"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"}

package/src/errors/translatable.d.ts

@@ -1,4 +1,59 @@
+import { GenderCategory } from '../gender/gender-categories';
+/**
+ * Translatable error class with full i18n 3.0/3.5 feature support.
+ *
+ * **Supported Features:**
+ * - ICU MessageFormat (variables, plural, select, selectordinal)
+ * - Pluralization (37 languages, CLDR rules)
+ * - Gender-aware translations
+ * - Number formatting (integer, currency, percent)
+ * - Date/Time formatting
+ * - Nested messages (4 levels deep)
+ * - Context variables
+ *
+ * **Translation String Examples:**
+ * ```typescript
+ * // ICU plural
+ * "{count, plural, one {# error occurred} other {# errors occurred}}"
+ *
+ * // ICU select + gender
+ * "{gender, select, male {He encountered} female {She encountered}} an error"
+ *
+ * // Number formatting
+ * "Threshold {limit, number, integer} exceeded by {value, number, percent}"
+ *
+ * // SelectOrdinal
+ * "Failed at {step, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} step"
+ *
+ * // Nested messages
+ * "{severity, select, low {Minor: {count, plural, one {# issue} other {# issues}}} high {Critical error}}"
+ * ```
+ */
 export declare class TranslatableError<TStringKey extends string = string> extends Error {
+    readonly componentId: string;
+    readonly stringKey: TStringKey;
+    readonly variables?: Record<string, string | number>;
+    readonly language?: string;
     constructor(componentId: string, stringKey: TStringKey, otherVars?: Record<string, string | number>, language?: string);
+    /**
+     * Create error with plural count
+     * Translation string should use: {count, plural, one {...} other {...}}
+     */
+    static withCount<TStringKey extends string>(componentId: string, stringKey: TStringKey, count: number, otherVars?: Record<string, string | number>, language?: string): TranslatableError<TStringKey>;
+    /**
+     * Create error with gender context
+     * Translation string should use: {gender, select, male {...} female {...} other {...}}
+     */
+    static withGender<TStringKey extends string>(componentId: string, stringKey: TStringKey, gender: GenderCategory, otherVars?: Record<string, string | number>, language?: string): TranslatableError<TStringKey>;
+    /**
+     * Create error with ordinal number
+     * Translation string should use: {number, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}
+     */
+    static withOrdinal<TStringKey extends string>(componentId: string, stringKey: TStringKey, number: number, otherVars?: Record<string, string | number>, language?: string): TranslatableError<TStringKey>;
+    /**
+     * Create error with formatted number
+     * Translation string should use: {value, number, integer|currency|percent}
+     */
+    static withNumber<TStringKey extends string>(componentId: string, stringKey: TStringKey, value: number, otherVars?: Record<string, string | number>, language?: string): TranslatableError<TStringKey>;
 }
 //# sourceMappingURL=translatable.d.ts.map

package/src/errors/translatable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translatable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAiB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;gBAE5E,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM;CAOpB"}
+{"version":3,"file":"translatable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,iBAAiB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAC9E,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,UAAU,CAAC;IACtC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5D,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM;IAYnB;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,SAAS,MAAM,EACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,UAAU,CAAC;IAShC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,SAAS,MAAM,EACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,cAAc,EACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,UAAU,CAAC;IAShC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,SAAS,MAAM,EAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,UAAU,CAAC;IAShC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,SAAS,MAAM,EACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,UAAU,CAAC;CAQjC"}

package/src/errors/translatable.js

@@ -2,13 +2,79 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TranslatableError = void 0;
 const i18n_engine_1 = require("../core/i18n-engine");
+/**
+ * Translatable error class with full i18n 3.0/3.5 feature support.
+ *
+ * **Supported Features:**
+ * - ICU MessageFormat (variables, plural, select, selectordinal)
+ * - Pluralization (37 languages, CLDR rules)
+ * - Gender-aware translations
+ * - Number formatting (integer, currency, percent)
+ * - Date/Time formatting
+ * - Nested messages (4 levels deep)
+ * - Context variables
+ *
+ * **Translation String Examples:**
+ * ```typescript
+ * // ICU plural
+ * "{count, plural, one {# error occurred} other {# errors occurred}}"
+ *
+ * // ICU select + gender
+ * "{gender, select, male {He encountered} female {She encountered}} an error"
+ *
+ * // Number formatting
+ * "Threshold {limit, number, integer} exceeded by {value, number, percent}"
+ *
+ * // SelectOrdinal
+ * "Failed at {step, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} step"
+ *
+ * // Nested messages
+ * "{severity, select, low {Minor: {count, plural, one {# issue} other {# issues}}} high {Critical error}}"
+ * ```
+ */
 class TranslatableError extends Error {
+    componentId;
+    stringKey;
+    variables;
+    language;
     constructor(componentId, stringKey, otherVars, language) {
         const engine = i18n_engine_1.I18nEngine.getInstance('default');
         super(engine.safeTranslate(componentId, stringKey, otherVars, language));
         this.name = 'TranslatableError';
+        this.componentId = componentId;
+        this.stringKey = stringKey;
+        this.variables = otherVars;
+        this.language = language;
         Object.setPrototypeOf(this, TranslatableError.prototype);
     }
+    /**
+     * Create error with plural count
+     * Translation string should use: {count, plural, one {...} other {...}}
+     */
+    static withCount(componentId, stringKey, count, otherVars, language) {
+        return new TranslatableError(componentId, stringKey, { ...otherVars, count }, language);
+    }
+    /**
+     * Create error with gender context
+     * Translation string should use: {gender, select, male {...} female {...} other {...}}
+     */
+    static withGender(componentId, stringKey, gender, otherVars, language) {
+        return new TranslatableError(componentId, stringKey, { ...otherVars, gender }, language);
+    }
+    /**
+     * Create error with ordinal number
+     * Translation string should use: {number, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}
+     */
+    static withOrdinal(componentId, stringKey, number, otherVars, language) {
+        return new TranslatableError(componentId, stringKey, { ...otherVars, number }, language);
+    }
+    /**
+     * Create error with formatted number
+     * Translation string should use: {value, number, integer|currency|percent}
+     */
+    static withNumber(componentId, stringKey, value, otherVars, language) {
+        return new TranslatableError(componentId, stringKey, { ...otherVars, value }, language);
+    }
 }
 exports.TranslatableError = TranslatableError;
 //# sourceMappingURL=translatable.js.map

package/src/errors/translatable.js.map

@@ -1 +1 @@
-{"version":3,"file":"translatable.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAEjD,MAAa,iBAAsD,SAAQ,KAAK;IAC9E,YACE,WAAmB,EACnB,SAAqB,EACrB,SAA2C,EAC3C,QAAiB;QAEjB,MAAM,MAAM,GAAG,wBAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACjD,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAZD,8CAYC"}
+{"version":3,"file":"translatable.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAa,iBAAsD,SAAQ,KAAK;IAC9D,WAAW,CAAS;IACpB,SAAS,CAAa;IACtB,SAAS,CAAmC;IAC5C,QAAQ,CAAU;IAElC,YACE,WAAmB,EACnB,SAAqB,EACrB,SAA2C,EAC3C,QAAiB;QAEjB,MAAM,MAAM,GAAG,wBAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACjD,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS,CACd,WAAmB,EACnB,SAAqB,EACrB,KAAa,EACb,SAA2C,EAC3C,QAAiB;QAEjB,OAAO,IAAI,iBAAiB,CAC1B,WAAW,EACX,SAAS,EACT,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,EACvB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CACf,WAAmB,EACnB,SAAqB,EACrB,MAAsB,EACtB,SAA2C,EAC3C,QAAiB;QAEjB,OAAO,IAAI,iBAAiB,CAC1B,WAAW,EACX,SAAS,EACT,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,EACxB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,CAChB,WAAmB,EACnB,SAAqB,EACrB,MAAc,EACd,SAA2C,EAC3C,QAAiB;QAEjB,OAAO,IAAI,iBAAiB,CAC1B,WAAW,EACX,SAAS,EACT,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,EACxB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CACf,WAAmB,EACnB,SAAqB,EACrB,KAAa,EACb,SAA2C,EAC3C,QAAiB;QAEjB,OAAO,IAAI,iBAAiB,CAC1B,WAAW,EACX,SAAS,EACT,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,EACvB,QAAQ,CACT,CAAC;IACJ,CAAC;CACF;AAjGD,8CAiGC"}

package/src/errors/typed-handleable.d.ts

@@ -2,6 +2,54 @@ import { HandleableError } from './handleable';
 import { IHandleable } from '../interfaces/handleable';
 import { HandleableErrorOptions } from '../interfaces/handleable-error-options';
 import { CompleteReasonMap } from './typed';
+/**
+ * TypedHandleableError with full i18n feature support.
+ *
+ * Combines typed errors with handleable error patterns and full i18n capabilities.
+ *
+ * **Supported i18n Features** (via translation strings):
+ * - ICU MessageFormat: plural, select, selectordinal
+ * - Pluralization: 37 languages with CLDR rules
+ * - Gender support: male, female, neutral, other
+ * - Number formatting: integer, currency, percent
+ * - Nested messages: up to 4 levels deep
+ *
+ * **Translation String Examples:**
+ * ```typescript
+ * // Define error types
+ * enum NetworkError {
+ *   Timeout = 'timeout',
+ *   RateLimit = 'rateLimit'
+ * }
+ *
+ * // Register translations with ICU
+ * engine.registerComponent({
+ *   component: { id: 'network', stringKeys: ['timeout', 'rateLimit'] },
+ *   strings: {
+ *     'en-US': {
+ *       timeout: \"{count, plural, one {# request timed out} other {# requests timed out}} after {seconds, number, integer} seconds\",
+ *       rateLimit: \"Rate limit exceeded. {remaining, number, integer} requests remaining. Resets in {minutes, number, integer} minutes.\"
+ *     }
+ *   }
+ * });
+ *
+ * // Use typed handleable error
+ * try {
+ *   await apiCall();
+ * } catch (error) {
+ *   throw new TypedHandleableError(
+ *     'network',
+ *     NetworkError.Timeout,
+ *     reasonMap,
+ *     error,
+ *     { retryable: true },
+ *     'en-US',
+ *     { count: 1, seconds: 30 }
+ *   );
+ * }
+ * // Result: \"1 request timed out after 30 seconds\"
+ * ```
+ */
 export declare class TypedHandleableError<TEnum extends Record<string, string>, TStringKey extends string> extends HandleableError implements IHandleable {
     readonly componentId: string;
     readonly type: TEnum[keyof TEnum];

package/src/errors/typed-handleable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-handleable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/typed-handleable.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,qBAAa,oBAAoB,CAC7B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,UAAU,SAAS,MAAM,CAE3B,SAAQ,eACR,YAAW,WAAW;IAEtB,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACzC,SAAgB,SAAS,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChE,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;gBAG1D,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EACxB,SAAS,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,EAC/C,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,sBAAsB,EAChC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IA4C7B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlD"}
+{"version":3,"file":"typed-handleable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/typed-handleable.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,oBAAoB,CAC7B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,UAAU,SAAS,MAAM,CAE3B,SAAQ,eACR,YAAW,WAAW;IAEtB,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACzC,SAAgB,SAAS,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChE,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;gBAG1D,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EACxB,SAAS,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,EAC/C,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,sBAAsB,EAChC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IA4C7B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlD"}