@digitaldefiance/i18n-lib 3.8.2 → 3.8.4

package/src/errors/i18n-error.js

@@ -0,0 +1,358 @@
+"use strict";
+/**
+ * Unified error class for i18n library with ICU MessageFormat support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.I18nError = exports.I18nErrorCode = void 0;
+const helpers_1 = require("../icu/helpers");
+/**
+ * Error codes used throughout the i18n library.
+ */
+exports.I18nErrorCode = {
+    /** Component not found in registry */
+    COMPONENT_NOT_FOUND: 'COMPONENT_NOT_FOUND',
+    /** String key not found in component */
+    STRING_KEY_NOT_FOUND: 'STRING_KEY_NOT_FOUND',
+    /** Language not found in registry */
+    LANGUAGE_NOT_FOUND: 'LANGUAGE_NOT_FOUND',
+    /** Translation missing for specified key and language */
+    TRANSLATION_MISSING: 'TRANSLATION_MISSING',
+    /** Invalid configuration provided */
+    INVALID_CONFIG: 'INVALID_CONFIG',
+    /** Attempt to register duplicate component */
+    DUPLICATE_COMPONENT: 'DUPLICATE_COMPONENT',
+    /** Attempt to register duplicate language */
+    DUPLICATE_LANGUAGE: 'DUPLICATE_LANGUAGE',
+    /** Validation failed during registration */
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    /** I18n instance not found */
+    INSTANCE_NOT_FOUND: 'INSTANCE_NOT_FOUND',
+    /** I18n instance already exists */
+    INSTANCE_EXISTS: 'INSTANCE_EXISTS',
+    /** Invalid context key provided */
+    INVALID_CONTEXT: 'INVALID_CONTEXT',
+    /** Plural form not found for language and category */
+    PLURAL_FORM_NOT_FOUND: 'PLURAL_FORM_NOT_FOUND',
+    /** Invalid plural category provided */
+    INVALID_PLURAL_CATEGORY: 'INVALID_PLURAL_CATEGORY',
+    /** Count variable missing for plural translation */
+    MISSING_COUNT_VARIABLE: 'MISSING_COUNT_VARIABLE',
+    /** Validation threshold exceeded */
+    VALIDATION_THRESHOLD_EXCEEDED: 'VALIDATION_THRESHOLD_EXCEEDED',
+    /** Operation failed at specific step */
+    OPERATION_STEP_FAILED: 'OPERATION_STEP_FAILED',
+    /** Rate limit exceeded */
+    RATE_LIMIT_EXCEEDED: 'RATE_LIMIT_EXCEEDED',
+    /** Nested validation error with context */
+    NESTED_VALIDATION_ERROR: 'NESTED_VALIDATION_ERROR',
+};
+/**
+ * Main error class for i18n-related errors.
+ * Includes error code and optional metadata for debugging.
+ */
+class I18nError extends Error {
+    code;
+    metadata;
+    /**
+     * Creates a new I18nError instance.
+     * @param code - The specific error code
+     * @param message - Human-readable error message
+     * @param metadata - Optional metadata providing context about the error
+     */
+    constructor(code, message, metadata) {
+        super(message);
+        this.code = code;
+        this.metadata = metadata;
+        this.name = 'I18nError';
+        Object.setPrototypeOf(this, I18nError.prototype);
+    }
+    /**
+     * Creates an error for when a component is not found with nested ICU select formatting.
+     * @param componentId - The ID of the component that was not found
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static componentNotFound(componentId, language = 'en-US') {
+        const hasNamespace = componentId.includes('.');
+        const message = (0, helpers_1.formatICUMessage)('{hasNamespace, select, true {Namespaced component {componentId}} other {Component {componentId}}} not found in registry', { componentId, hasNamespace: hasNamespace ? 'true' : 'false' }, language);
+        return new I18nError(exports.I18nErrorCode.COMPONENT_NOT_FOUND, message, {
+            componentId,
+        });
+    }
+    /**
+     * Creates an error for when a string key is not found in a component with nested ICU formatting.
+     * @param componentId - The ID of the component
+     * @param stringKey - The string key that was not found
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static stringKeyNotFound(componentId, stringKey, language = 'en-US') {
+        const depth = stringKey.split('.').length;
+        const isNested = depth > 1;
+        const message = (0, helpers_1.formatICUMessage)('{isNested, select, true {Nested string key at {depth, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} level {stringKey}} other {String key {stringKey}}} not found in component {componentId}', { componentId, stringKey, depth, isNested: isNested ? 'true' : 'false' }, language);
+        return new I18nError(exports.I18nErrorCode.STRING_KEY_NOT_FOUND, message, {
+            componentId,
+            stringKey,
+        });
+    }
+    /**
+     * Creates an error for when a language is not found with ICU formatting.
+     * @param language - The language code that was not found
+     * @param messageLanguage - Optional language code for error message formatting
+     * @returns An I18nError instance
+     */
+    static languageNotFound(language, messageLanguage = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Language {language} not found', { language }, messageLanguage);
+        return new I18nError(exports.I18nErrorCode.LANGUAGE_NOT_FOUND, message, {
+            language,
+        });
+    }
+    /**
+     * Creates an error for when a translation is missing with nested ICU formatting.
+     * @param componentId - The ID of the component
+     * @param stringKey - The string key
+     * @param language - The language code where translation is missing
+     * @param messageLanguage - Optional language code for error message formatting
+     * @returns An I18nError instance
+     */
+    static translationMissing(componentId, stringKey, language, messageLanguage = 'en-US') {
+        const hasNestedKey = stringKey.includes('.');
+        const message = (0, helpers_1.formatICUMessage)('Translation missing: {hasNested, select, true {nested path} other {key}} {componentId}.{stringKey} not found in language {language}', {
+            componentId,
+            stringKey,
+            language,
+            hasNested: hasNestedKey ? 'true' : 'false',
+        }, messageLanguage);
+        return new I18nError(exports.I18nErrorCode.TRANSLATION_MISSING, message, {
+            componentId,
+            stringKey,
+            language,
+        });
+    }
+    /**
+     * Creates an error for invalid configuration.
+     * @param reason - The reason why the configuration is invalid
+     * @returns An I18nError instance
+     */
+    static invalidConfig(reason) {
+        return new I18nError(exports.I18nErrorCode.INVALID_CONFIG, reason);
+    }
+    /**
+     * Creates an error for duplicate component registration with nested ICU select formatting.
+     * @param componentId - The ID of the duplicate component
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static duplicateComponent(componentId, language = 'en-US') {
+        const hasNamespace = componentId.includes('.');
+        const message = (0, helpers_1.formatICUMessage)('{hasNamespace, select, true {Namespaced component {componentId}} other {Component {componentId}}} is already registered {hasNamespace, select, true {in this namespace} other {in the registry}}', { componentId, hasNamespace: hasNamespace ? 'true' : 'false' }, language);
+        return new I18nError(exports.I18nErrorCode.DUPLICATE_COMPONENT, message, {
+            componentId,
+        });
+    }
+    /**
+     * Creates an error for duplicate language registration with ICU formatting.
+     * @param language - The language code that is duplicate
+     * @param messageLanguage - Optional language code for error message formatting
+     * @returns An I18nError instance
+     */
+    static duplicateLanguage(language, messageLanguage = 'en-US') {
+        const message = `Language '${language}' already registered`;
+        return new I18nError(exports.I18nErrorCode.DUPLICATE_LANGUAGE, message, {
+            language,
+        });
+    }
+    /**
+     * Creates an error for validation failure with ICU plural formatting and number formatting.
+     * @param errors - Array of validation error messages
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static validationFailed(errors, language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Validation failed with {count, plural, one {{count, number, integer} error} other {{count, number, integer} errors}}: {details}', { count: errors.length, details: errors.join(', ') }, language);
+        return new I18nError(exports.I18nErrorCode.VALIDATION_FAILED, message, {
+            errors,
+            count: errors.length,
+        });
+    }
+    /**
+     * Creates an error for when an i18n instance is not found with nested ICU select formatting.
+     * @param key - The instance key that was not found
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static instanceNotFound(key, language = 'en-US') {
+        const isDefault = key === 'default' || key === '';
+        const message = (0, helpers_1.formatICUMessage)('{isDefault, select, true {Default i18n instance not found} other {I18n instance {key} not found}} in registry', { key, isDefault: isDefault ? 'true' : 'false' }, language);
+        return new I18nError(exports.I18nErrorCode.INSTANCE_NOT_FOUND, message, { key });
+    }
+    /**
+     * Creates an error for when an i18n instance already exists with nested ICU select formatting.
+     * @param key - The instance key that already exists
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static instanceExists(key, language = 'en-US') {
+        const isDefault = key === 'default' || key === '';
+        const message = (0, helpers_1.formatICUMessage)("{isDefault, select, true {Default i18n instance 'default' already exists. Use a different key or remove the existing instance first.} other {I18n instance {key} already exists in registry}}", { key, isDefault: isDefault ? 'true' : 'false' }, language);
+        return new I18nError(exports.I18nErrorCode.INSTANCE_EXISTS, message, { key });
+    }
+    /**
+     * Creates an error for an invalid context key with ICU formatting.
+     * @param contextKey - The invalid context key
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static invalidContext(contextKey, language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Invalid context key {contextKey}', { contextKey }, language);
+        return new I18nError(exports.I18nErrorCode.INVALID_CONTEXT, message, {
+            contextKey,
+        });
+    }
+    /**
+     * Creates an error for when a plural form is not found with nested ICU select and plural formatting.
+     * @param category - The plural category that was not found
+     * @param language - The language code
+     * @param key - The translation key
+     * @param availableForms - Array of available plural forms
+     * @returns An I18nError instance
+     */
+    static pluralFormNotFound(category, language, key, availableForms) {
+        const formCount = availableForms.length;
+        const message = (0, helpers_1.formatICUMessage)('Plural form {category} not found for language {language}{hasKey, select, true { in key {keyName}} other {}}. {formCount, plural, one {Available form} other {Available forms}} ({formCount, number, integer}): {forms}', {
+            category,
+            language,
+            keyName: key,
+            hasKey: key ? 'true' : 'false',
+            forms: availableForms.join(', '),
+            formCount,
+        }, language);
+        return new I18nError(exports.I18nErrorCode.PLURAL_FORM_NOT_FOUND, message, {
+            category,
+            language,
+            key,
+            availableForms,
+            formCount,
+        });
+    }
+    /**
+     * Creates an error for an invalid plural category with nested ICU plural and number formatting.
+     * @param category - The invalid category
+     * @param validCategories - Array of valid categories
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static invalidPluralCategory(category, validCategories, language = 'en-US') {
+        const count = validCategories.length;
+        const message = (0, helpers_1.formatICUMessage)('Invalid plural category {category}. {count, plural, one {Valid category ({count, number, integer})} other {Valid categories ({count, number, integer})}}: {categories}', {
+            category,
+            categories: validCategories.join(', '),
+            count,
+        }, language);
+        return new I18nError(exports.I18nErrorCode.INVALID_PLURAL_CATEGORY, message, {
+            category,
+            validCategories,
+            count,
+        });
+    }
+    /**
+     * Creates an error for when the count variable is missing for plural forms with ICU formatting.
+     * @param key - The translation key that requires a count variable
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static missingCountVariable(key, language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)("Plural forms used in key {key} but no 'count' variable provided", { key }, language);
+        return new I18nError(exports.I18nErrorCode.MISSING_COUNT_VARIABLE, message, {
+            key,
+        });
+    }
+    /**
+     * Creates an error for validation threshold violations with ICU number formatting.
+     * Demonstrates currency, percent, and integer formatting based on threshold type.
+     * @param fieldName - The field that exceeded the threshold
+     * @param value - The actual value
+     * @param threshold - The maximum allowed value
+     * @param thresholdType - Type of threshold: 'currency', 'percent', or 'integer'
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static validationThresholdExceeded(fieldName, value, threshold, thresholdType = 'integer', language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Validation failed for {fieldName}: value {value, number, ' +
+            thresholdType +
+            '} exceeds maximum threshold of {threshold, number, ' +
+            thresholdType +
+            '}', { fieldName, value, threshold }, language);
+        return new I18nError(exports.I18nErrorCode.VALIDATION_THRESHOLD_EXCEEDED, message, {
+            fieldName,
+            value,
+            threshold,
+            thresholdType,
+        });
+    }
+    /**
+     * Creates an error for operation failures at specific steps with ICU selectordinal formatting.
+     * Demonstrates 1st, 2nd, 3rd, etc. formatting for step numbers.
+     * @param stepNumber - The step number where the operation failed (1-based)
+     * @param operationName - The name of the operation
+     * @param reason - The reason for failure
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static operationStepFailed(stepNumber, operationName, reason, language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Operation {operationName} failed at {stepNumber, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} step: {reason}', { stepNumber, operationName, reason }, language);
+        return new I18nError(exports.I18nErrorCode.OPERATION_STEP_FAILED, message, {
+            stepNumber,
+            operationName,
+            reason,
+        });
+    }
+    /**
+     * Creates an error for rate limit violations with nested ICU messages.
+     * Demonstrates nested plural, number formatting, and conditional messages.
+     * @param requestCount - Number of requests made
+     * @param limit - Maximum allowed requests
+     * @param windowSeconds - Time window in seconds
+     * @param retryAfterSeconds - Seconds until retry is allowed
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static rateLimitExceeded(requestCount, limit, windowSeconds, retryAfterSeconds, language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Rate limit exceeded: {requestCount, plural, one {# request} other {# requests}} made, exceeding limit of {limit, number, integer} {limit, plural, one {request} other {requests}} per {windowSeconds, number, integer} {windowSeconds, plural, one {second} other {seconds}}. {hasRetry, select, true {Retry after {retryAfterSeconds, number, integer} {retryAfterSeconds, plural, one {second} other {seconds}}.} other {Retry immediately.}}', {
+            requestCount,
+            limit,
+            windowSeconds,
+            retryAfterSeconds,
+            hasRetry: retryAfterSeconds > 0 ? 'true' : 'false',
+        }, language);
+        return new I18nError(exports.I18nErrorCode.RATE_LIMIT_EXCEEDED, message, {
+            requestCount,
+            limit,
+            windowSeconds,
+            retryAfterSeconds,
+        });
+    }
+    /**
+     * Creates a nested validation error with multiple layers of context.
+     * Demonstrates 4-level deep nested ICU messages with plural, select, and number formatting.
+     * @param componentId - The component being validated
+     * @param fieldPath - Nested field path (e.g., 'user.profile.settings.theme')
+     * @param errorCount - Number of errors found
+     * @param errorType - Type of validation error
+     * @param severity - Error severity level
+     * @param language - Optional language code for message formatting
+     * @returns An I18nError instance
+     */
+    static nestedValidationError(componentId, fieldPath, errorCount, errorType, severity, language = 'en-US') {
+        const message = (0, helpers_1.formatICUMessage)('Validation error in component {componentId}: {severity, select, low {Minor issue} medium {Moderate issue} high {Serious issue} critical {Critical issue} other {Issue}} detected in nested field {fieldPath} - {errorType, select, type {Type mismatch} range {Value out of range} format {Invalid format} required {Required field missing} other {Validation error}} with {errorCount, plural, one {# occurrence} other {# occurrences}}', { componentId, fieldPath, errorCount, errorType, severity }, language);
+        return new I18nError(exports.I18nErrorCode.NESTED_VALIDATION_ERROR, message, {
+            componentId,
+            fieldPath,
+            errorCount,
+            errorType,
+            severity,
+        });
+    }
+}
+exports.I18nError = I18nError;
+//# sourceMappingURL=i18n-error.js.map

package/src/errors/i18n-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-error.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/i18n-error.ts"],"names":[],"mappings":"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"}

package/src/errors/{index.ts → index.d.ts}

@@ -7,9 +7,6 @@
  *
  * Import from specific files when possible to minimize module loading.
  */
-
-// Re-export from base (no core dependencies)
 export * from './base';
-
-// Re-export from translatable (uses lazy initialization)
 export * from './translatable-exports';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,wBAAwB,CAAC"}

package/src/errors/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Error exports
+ *
+ * This barrel export is split into separate files to avoid circular dependencies:
+ * - base.ts: Base error classes without core dependencies
+ * - translatable-exports.ts: Errors that use lazy initialization with core modules
+ *
+ * Import from specific files when possible to minimize module loading.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Re-export from base (no core dependencies)
+tslib_1.__exportStar(require("./base"), exports);
+// Re-export from translatable (uses lazy initialization)
+tslib_1.__exportStar(require("./translatable-exports"), exports);
+//# sourceMappingURL=index.js.map

package/src/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,6CAA6C;AAC7C,iDAAuB;AAEvB,yDAAyD;AACzD,iEAAuC"}

package/src/errors/simple-typed-error.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TypedError class with proper type safety
+ *
+ * This class provides a type-safe way to create errors with additional
+ * properties without using type casts. It extends the standard Error class
+ * and adds support for:
+ * - type: Error type classification
+ * - componentId: Component identifier where error originated
+ * - reasonMap: Map of reasons or context for the error
+ * - metadata: Additional metadata associated with the error
+ * - cause: Error cause chaining (ES2022 standard)
+ */
+export interface TypedErrorOptions {
+    /**
+     * Error type classification (e.g., 'validation', 'network', 'auth')
+     */
+    type: string;
+    /**
+     * Component identifier where the error originated
+     */
+    componentId?: string;
+    /**
+     * Map of reasons or context for the error
+     */
+    reasonMap?: Record<string, unknown>;
+    /**
+     * Additional metadata associated with the error
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * The cause of this error (for error chaining)
+     */
+    cause?: Error;
+}
+/**
+ * TypedError class that extends Error with additional type-safe properties
+ */
+export declare class TypedError extends Error {
+    readonly type: string;
+    readonly componentId?: string;
+    readonly reasonMap?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown>;
+    constructor(message: string, options: TypedErrorOptions);
+    /**
+     * Check if an error is a TypedError
+     */
+    static isTypedError(error: unknown): error is TypedError;
+    /**
+     * Convert a standard Error to a TypedError
+     */
+    static fromError(error: Error, options: Omit<TypedErrorOptions, 'cause'>): TypedError;
+}
+//# sourceMappingURL=simple-typed-error.d.ts.map

package/src/errors/simple-typed-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-typed-error.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/simple-typed-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAyB,IAAI,EAAE,MAAM,CAAC;IACtC,SAAyB,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9C,SAAyB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7D,SAAyB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEhD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;IAYvD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU;IAIxD;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GACxC,UAAU;CAMd"}

package/src/errors/simple-typed-error.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * TypedError class with proper type safety
+ *
+ * This class provides a type-safe way to create errors with additional
+ * properties without using type casts. It extends the standard Error class
+ * and adds support for:
+ * - type: Error type classification
+ * - componentId: Component identifier where error originated
+ * - reasonMap: Map of reasons or context for the error
+ * - metadata: Additional metadata associated with the error
+ * - cause: Error cause chaining (ES2022 standard)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedError = void 0;
+/**
+ * TypedError class that extends Error with additional type-safe properties
+ */
+class TypedError extends Error {
+    type;
+    componentId;
+    reasonMap;
+    metadata;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.type = options.type;
+        this.componentId = options.componentId;
+        this.reasonMap = options.reasonMap;
+        this.metadata = options.metadata;
+        this.name = 'TypedError';
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, TypedError.prototype);
+    }
+    /**
+     * Check if an error is a TypedError
+     */
+    static isTypedError(error) {
+        return error instanceof TypedError;
+    }
+    /**
+     * Convert a standard Error to a TypedError
+     */
+    static fromError(error, options) {
+        return new TypedError(error.message, {
+            ...options,
+            cause: error,
+        });
+    }
+}
+exports.TypedError = TypedError;
+//# sourceMappingURL=simple-typed-error.js.map

package/src/errors/simple-typed-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-typed-error.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/simple-typed-error.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AA6BH;;GAEG;AACH,MAAa,UAAW,SAAQ,KAAK;IACV,IAAI,CAAS;IACb,WAAW,CAAU;IACrB,SAAS,CAA2B;IACpC,QAAQ,CAA2B;IAE5D,YAAY,OAAe,EAAE,OAA0B;QACrD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,kCAAkC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAc;QAChC,OAAO,KAAK,YAAY,UAAU,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAY,EACZ,OAAyC;QAEzC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE;YACnC,GAAG,OAAO;YACV,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;CACF;AArCD,gCAqCC"}

package/src/errors/{translatable-exports.ts → translatable-exports.d.ts}

@@ -2,7 +2,6 @@
  * Translatable error exports that use lazy initialization
  * These errors depend on core modules but use lazy loading patterns
  */
-
 export * from './context-error';
 export * from './i18n-error';
 export * from './translatable';
@@ -10,3 +9,4 @@ export * from './translatable-generic';
 export * from './translatable-handleable-generic';
 export * from './typed';
 export * from './typed-handleable';
+//# sourceMappingURL=translatable-exports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translatable-exports.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-exports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC"}

package/src/errors/translatable-exports.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Translatable error exports that use lazy initialization
+ * These errors depend on core modules but use lazy loading patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./context-error"), exports);
+tslib_1.__exportStar(require("./i18n-error"), exports);
+tslib_1.__exportStar(require("./translatable"), exports);
+tslib_1.__exportStar(require("./translatable-generic"), exports);
+tslib_1.__exportStar(require("./translatable-handleable-generic"), exports);
+tslib_1.__exportStar(require("./typed"), exports);
+tslib_1.__exportStar(require("./typed-handleable"), exports);
+//# sourceMappingURL=translatable-exports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translatable-exports.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/errors/translatable-exports.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,0DAAgC;AAChC,uDAA6B;AAC7B,yDAA+B;AAC/B,iEAAuC;AACvC,4EAAkD;AAClD,kDAAwB;AACxB,6DAAmC"}

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

@@ -0,0 +1,87 @@
+import { I18nEngine } from '../core/i18n-engine';
+import { GenderCategory } from '../gender/gender-categories';
+/**
+ * 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\"
+ * ```
+ */
+export declare class TranslatableGenericError<TStringKey extends string = string> extends Error {
+    readonly stringKey: TStringKey;
+    readonly componentId: string;
+    readonly language?: string;
+    readonly variables?: Record<string, string | number>;
+    readonly metadata?: Record<string, any>;
+    /**
+     * 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);
+    /**
+     * Create error with explicit engine instance
+     */
+    static withEngine<TStringKey extends string>(engine: I18nEngine, componentId: string, stringKey: TStringKey, variables?: Record<string, string | number>, language?: string, metadata?: Record<string, any>): TranslatableGenericError<TStringKey>;
+    /**
+     * 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