@digitaldefiance/i18n-lib 3.8.2 → 3.8.4

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslatableGenericError = void 0;
+const i18n_engine_1 = require("../core/i18n-engine");
+/**
+ * Generic translatable error that works with any plugin engine and component.
+ *
+ * Uses lazy initialization to avoid circular dependencies with core modules.
+ * The I18nEngine is only accessed when the error is constructed, not at module load time.
+ *
+ * **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;
+    componentId;
+    language;
+    variables;
+    metadata;
+    /**
+     * Create a translatable error
+     * @param componentId - The component ID to translate from
+     * @param stringKey - The translation key
+     * @param variables - Variables for interpolation
+     * @param language - Optional language override
+     * @param metadata - Additional error metadata
+     * @param instanceKey - Optional engine instance key
+     */
+    constructor(componentId, stringKey, variables, language, metadata, instanceKey) {
+        // Lazy initialization: getInstance() is only called when error is constructed
+        let translatedMessage;
+        try {
+            const engine = i18n_engine_1.I18nEngine.getInstance(instanceKey);
+            translatedMessage = engine.safeTranslate(componentId, stringKey, variables, language);
+        }
+        catch (error) {
+            // Fallback if engine not found - TranslatableGenericError is designed to be flexible
+            translatedMessage = `[${componentId}.${stringKey}]`;
+        }
+        super(translatedMessage);
+        this.name = 'TranslatableGenericError';
+        this.stringKey = stringKey;
+        this.componentId = componentId;
+        this.language = language;
+        this.variables = variables;
+        this.metadata = metadata;
+    }
+    /**
+     * Create error with explicit engine instance
+     */
+    static withEngine(engine, componentId, stringKey, variables, language, metadata) {
+        const translatedMessage = engine.safeTranslate(componentId, stringKey, variables, language);
+        const error = Object.create(TranslatableGenericError.prototype);
+        Error.call(error, translatedMessage);
+        error.name = 'TranslatableGenericError';
+        error.stringKey = stringKey;
+        error.componentId = componentId;
+        error.language = language;
+        error.variables = variables;
+        error.metadata = metadata;
+        error.message = translatedMessage;
+        return error;
+    }
+    /**
+     * Retranslate the error message in a different language
+     */
+    retranslate(language, instanceKey) {
+        try {
+            const engine = i18n_engine_1.I18nEngine.getInstance(instanceKey);
+            return engine.safeTranslate(this.componentId, this.stringKey, this.variables, language);
+        }
+        catch (error) {
+            // Fallback if engine not found
+            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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,116 @@
+import { IHandleable } from '../interfaces/handleable';
+import { TranslatableGenericError } from './translatable-generic';
+import { GenderCategory } from '../gender/gender-categories';
+/**
+ * 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;
+    readonly cause?: Error;
+    readonly statusCode: number;
+    readonly sourceData?: unknown;
+    /**
+     * Create a translatable error
+     * @param componentId - The component ID to translate from
+     * @param stringKey - The translation key
+     * @param variables - Variables for interpolation
+     * @param language - Optional language override
+     * @param metadata - Additional error metadata
+     * @param instanceKey - Optional engine instance key
+     */
+    constructor(componentId: string, stringKey: TStringKey, variables?: Record<string, string | number>, language?: string, metadata?: Record<string, any>, instanceKey?: string, handleableOptions?: {
+        statusCode?: number;
+        cause?: Error;
+        sourceData?: unknown;
+    });
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslatableHandleableGenericError = void 0;
+const translatable_generic_1 = require("./translatable-generic");
+/**
+ * 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;
+    cause;
+    statusCode;
+    sourceData;
+    /**
+     * Create a translatable error
+     * @param componentId - The component ID to translate from
+     * @param stringKey - The translation key
+     * @param variables - Variables for interpolation
+     * @param language - Optional language override
+     * @param metadata - Additional error metadata
+     * @param instanceKey - Optional engine instance key
+     */
+    constructor(componentId, stringKey, variables, language, metadata, instanceKey, handleableOptions) {
+        super(componentId, stringKey, variables, language, metadata, instanceKey);
+        this.statusCode = handleableOptions?.statusCode ?? 500;
+        this.cause = handleableOptions?.cause;
+        this.sourceData = handleableOptions?.sourceData;
+        this.name = 'TranslatableHandleableGenericError';
+    }
+    get handled() {
+        return this._handled;
+    }
+    set handled(value) {
+        this._handled = value;
+    }
+    toJSON() {
+        return {
+            statusCode: this.statusCode,
+            message: this.message,
+            cause: this.cause,
+            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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,63 @@
+import { GenderCategory } from '../gender/gender-categories';
+/**
+ * Translatable error class with full i18n 3.0/3.5 feature support.
+ *
+ * Uses lazy initialization to avoid circular dependencies with core modules.
+ * The I18nEngine is only accessed when the error is constructed, not at module load time.
+ * If the i18n engine is not initialized, falls back to displaying the raw key.
+ *
+ * **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

@@ -0,0 +1 @@
+{"version":3,"file":"translatable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,iBAAiB,CAC5B,UAAU,SAAS,MAAM,GAAG,MAAM,CAClC,SAAQ,KAAK;IACb,SAAyB,WAAW,EAAE,MAAM,CAAC;IAC7C,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;IAanB;;;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

@@ -0,0 +1,85 @@
+"use strict";
+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.
+ *
+ * Uses lazy initialization to avoid circular dependencies with core modules.
+ * The I18nEngine is only accessed when the error is constructed, not at module load time.
+ * If the i18n engine is not initialized, falls back to displaying the raw key.
+ *
+ * **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) {
+        // Lazy initialization: getInstance() is only called when error is constructed, not at module load
+        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, { count, ...otherVars }, 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, { gender, ...otherVars }, 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, { number, ...otherVars }, 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, { value, ...otherVars }, language);
+    }
+}
+exports.TranslatableError = TranslatableError;
+//# sourceMappingURL=translatable.js.map

package/src/errors/translatable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translatable.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAa,iBAEX,SAAQ,KAAK;IACY,WAAW,CAAS;IAC7B,SAAS,CAAa;IACtB,SAAS,CAAmC;IAC5C,QAAQ,CAAU;IAElC,YACE,WAAmB,EACnB,SAAqB,EACrB,SAA2C,EAC3C,QAAiB;QAEjB,kGAAkG;QAClG,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,KAAK,EAAE,GAAG,SAAS,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,MAAM,EAAE,GAAG,SAAS,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,MAAM,EAAE,GAAG,SAAS,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,KAAK,EAAE,GAAG,SAAS,EAAE,EACvB,QAAQ,CACT,CAAC;IACJ,CAAC;CACF;AApGD,8CAoGC"}

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

@@ -0,0 +1,62 @@
+import { IHandleable } from '../interfaces/handleable';
+import { HandleableErrorOptions } from '../interfaces/handleable-error-options';
+import { HandleableError } from './handleable';
+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];
+    readonly reasonMap: CompleteReasonMap<TEnum, TStringKey>;
+    readonly language?: string;
+    readonly otherVars?: Record<string, string | number>;
+    constructor(componentId: string, type: TEnum[keyof TEnum], reasonMap: CompleteReasonMap<TEnum, TStringKey>, source: Error, options?: HandleableErrorOptions, language?: string, otherVars?: Record<string, string | number>);
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=typed-handleable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typed-handleable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/typed-handleable.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,oBAAoB,CAC7B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,UAAU,SAAS,MAAM,CAE3B,SAAQ,eACR,YAAW,WAAW;IAEtB,SAAyB,WAAW,EAAE,MAAM,CAAC;IAC7C,SAAyB,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAClD,SAAyB,SAAS,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,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;IAsD7B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlD"}