@digitaldefiance/i18n-lib 3.8.2 → 3.8.4

package/src/component-registry.js.map

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

package/src/context-error-type.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Types of context-related errors
+ */
+export declare enum ContextErrorType {
+    /** Error indicating an invalid or non-existent context */
+    InvalidContext = "InvalidContext"
+}
+//# sourceMappingURL=context-error-type.d.ts.map

package/src/context-error-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-error-type.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/context-error-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,0DAA0D;IAC1D,cAAc,mBAAmB;CAClC"}

package/src/context-error-type.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextErrorType = void 0;
+/**
+ * Types of context-related errors
+ */
+var ContextErrorType;
+(function (ContextErrorType) {
+    /** Error indicating an invalid or non-existent context */
+    ContextErrorType["InvalidContext"] = "InvalidContext";
+})(ContextErrorType || (exports.ContextErrorType = ContextErrorType = {}));
+//# sourceMappingURL=context-error-type.js.map

package/src/context-error-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-error-type.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/context-error-type.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,0DAA0D;IAC1D,qDAAiC,CAAA;AACnC,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

package/src/core/component-store.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Component storage (no generics)
+ */
+import { ComponentConfig, ValidationResult } from '../interfaces';
+/**
+ * Class representing a storage for component configurations and translations.
+ */
+export declare class ComponentStore {
+    private components;
+    private aliasMap;
+    private constants?;
+    /**
+     * Creates a new ComponentStore instance.
+     * @param constants - Optional constants to be used in variable replacement.
+     */
+    constructor(constants?: Record<string, any>);
+    /**
+     * Registers a new component configuration.
+     * @param config - The component configuration to register.
+     * @returns ValidationResult indicating the result of the registration.
+     * @throws {I18nError} If the component ID is already registered.
+     */
+    register(config: ComponentConfig): ValidationResult;
+    /**
+     * Updates an existing component's strings.
+     * @param componentId - The ID of the component to update.
+     * @param strings - The new strings to merge into the component.
+     * @returns ValidationResult indicating the result of the update.
+     * @throws {I18nError} If the component is not found.
+     */
+    update(componentId: string, strings: Record<string, Record<string, string>>): ValidationResult;
+    /**
+     * Checks if a component or alias is registered.
+     * @param componentId - The component ID or alias to check.
+     * @returns True if the component or alias is registered, false otherwise.
+     */
+    has(componentId: string): boolean;
+    /**
+     * Retrieves a component configuration by ID or alias.
+     * @param componentId - The component ID or alias to retrieve.
+     * @returns The component configuration.
+     * @throws {I18nError} If the component is not found.
+     */
+    get(componentId: string): ComponentConfig;
+    /**
+     * Retrieves all registered component configurations.
+     * @returns An array of all component configurations.
+     */
+    getAll(): readonly ComponentConfig[];
+    /**
+     * Translates a key for a component in a given language, replacing variables.
+     * @param componentId - The component ID.
+     * @param key - The translation key.
+     * @param variables - Optional variables for replacement.
+     * @param language - Optional language code (default is 'en-US').
+     * @returns The translated string.
+     * @throws {I18nError} If the language or translation key is not found.
+     */
+    translate(componentId: string, key: string, variables?: Record<string, any>, language?: string): string;
+    /**
+     * Resolve plural form from a PluralString based on count variable.
+     * @param value - The string or PluralString to resolve.
+     * @param count - The count for pluralization.
+     * @param language - The language code.
+     * @returns The resolved plural form string.
+     */
+    private resolvePluralForm;
+    /**
+     * Safely translates a key for a component, returning a fallback string on error.
+     * @param componentId - The component ID.
+     * @param key - The translation key.
+     * @param variables - Optional variables for replacement.
+     * @param language - Optional language code.
+     * @returns The translated string or a fallback string if translation fails.
+     */
+    safeTranslate(componentId: string, key: string, variables?: Record<string, any>, language?: string): string;
+    /**
+     * Validates a component configuration for missing keys across languages.
+     * @param config - The component configuration to validate.
+     * @returns ValidationResult containing errors and warnings.
+     */
+    private validate;
+    /**
+     * Sets constants for variable replacement.
+     * @param constants - The constants to set.
+     */
+    setConstants(constants: Record<string, any>): void;
+    /**
+     * Clears all registered components and aliases.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=component-store.d.ts.map

package/src/core/component-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-store.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/component-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKlE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAsB;IAExC;;;OAGG;gBACS,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI3C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAkBnD;;;;;;OAMG;IACH,MAAM,CACJ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9C,gBAAgB;IAenB;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IASzC;;;OAGG;IACH,MAAM,IAAI,SAAS,eAAe,EAAE;IAIpC;;;;;;;;OAQG;IACH,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAoBT;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;;;;;OAOG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAQT;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IA6BhB;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIlD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/src/core/component-store.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Component storage (no generics)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentStore = void 0;
+const i18n_error_1 = require("../errors/i18n-error");
+const language_plural_map_1 = require("../pluralization/language-plural-map");
+const plural_types_1 = require("../types/plural-types");
+const utils_1 = require("../utils");
+/**
+ * Class representing a storage for component configurations and translations.
+ */
+class ComponentStore {
+    components = new Map();
+    aliasMap = new Map();
+    constants;
+    /**
+     * Creates a new ComponentStore instance.
+     * @param constants - Optional constants to be used in variable replacement.
+     */
+    constructor(constants) {
+        this.constants = constants;
+    }
+    /**
+     * Registers a new component configuration.
+     * @param config - The component configuration to register.
+     * @returns ValidationResult indicating the result of the registration.
+     * @throws {I18nError} If the component ID is already registered.
+     */
+    register(config) {
+        if (this.components.has(config.id)) {
+            throw i18n_error_1.I18nError.duplicateComponent(config.id);
+        }
+        const validation = this.validate(config);
+        this.components.set(config.id, config);
+        // Register aliases
+        if (config.aliases) {
+            for (const alias of config.aliases) {
+                this.aliasMap.set(alias, config.id);
+            }
+        }
+        return validation;
+    }
+    /**
+     * Updates an existing component's strings.
+     * @param componentId - The ID of the component to update.
+     * @param strings - The new strings to merge into the component.
+     * @returns ValidationResult indicating the result of the update.
+     * @throws {I18nError} If the component is not found.
+     */
+    update(componentId, strings) {
+        const existing = this.components.get(componentId);
+        if (!existing) {
+            throw i18n_error_1.I18nError.componentNotFound(componentId);
+        }
+        const updated = {
+            ...existing,
+            strings: { ...existing.strings, ...strings },
+        };
+        this.components.set(componentId, updated);
+        return this.validate(updated);
+    }
+    /**
+     * Checks if a component or alias is registered.
+     * @param componentId - The component ID or alias to check.
+     * @returns True if the component or alias is registered, false otherwise.
+     */
+    has(componentId) {
+        return this.components.has(componentId) || this.aliasMap.has(componentId);
+    }
+    /**
+     * Retrieves a component configuration by ID or alias.
+     * @param componentId - The component ID or alias to retrieve.
+     * @returns The component configuration.
+     * @throws {I18nError} If the component is not found.
+     */
+    get(componentId) {
+        const id = this.aliasMap.get(componentId) || componentId;
+        const component = this.components.get(id);
+        if (!component) {
+            throw i18n_error_1.I18nError.componentNotFound(componentId);
+        }
+        return component;
+    }
+    /**
+     * Retrieves all registered component configurations.
+     * @returns An array of all component configurations.
+     */
+    getAll() {
+        return Array.from(this.components.values());
+    }
+    /**
+     * Translates a key for a component in a given language, replacing variables.
+     * @param componentId - The component ID.
+     * @param key - The translation key.
+     * @param variables - Optional variables for replacement.
+     * @param language - Optional language code (default is 'en-US').
+     * @returns The translated string.
+     * @throws {I18nError} If the language or translation key is not found.
+     */
+    translate(componentId, key, variables, language) {
+        const component = this.get(componentId);
+        const lang = language || 'en-US';
+        const langStrings = component.strings[lang];
+        if (!langStrings) {
+            throw i18n_error_1.I18nError.languageNotFound(lang);
+        }
+        const value = langStrings[key];
+        if (!value) {
+            throw i18n_error_1.I18nError.translationMissing(componentId, key, lang);
+        }
+        // Resolve plural form if needed
+        const translation = this.resolvePluralForm(value, variables?.count, lang);
+        return (0, utils_1.replaceVariables)(translation, variables, this.constants);
+    }
+    /**
+     * Resolve plural form from a PluralString based on count variable.
+     * @param value - The string or PluralString to resolve.
+     * @param count - The count for pluralization.
+     * @param language - The language code.
+     * @returns The resolved plural form string.
+     */
+    resolvePluralForm(value, count, language) {
+        // If it's a simple string, return as-is
+        if (typeof value === 'string') {
+            return value;
+        }
+        // If no count provided, use 'other' form or first available
+        if (count === undefined) {
+            return (0, plural_types_1.resolvePluralString)(value, 'other') || '';
+        }
+        // Get the appropriate plural category for this count and language
+        const category = (0, language_plural_map_1.getPluralCategory)(language, count);
+        // Resolve the plural form with fallback logic
+        return (0, plural_types_1.resolvePluralString)(value, category) || '';
+    }
+    /**
+     * Safely translates a key for a component, returning a fallback string on error.
+     * @param componentId - The component ID.
+     * @param key - The translation key.
+     * @param variables - Optional variables for replacement.
+     * @param language - Optional language code.
+     * @returns The translated string or a fallback string if translation fails.
+     */
+    safeTranslate(componentId, key, variables, language) {
+        try {
+            return this.translate(componentId, key, variables, language);
+        }
+        catch {
+            return `[${componentId}.${key}]`;
+        }
+    }
+    /**
+     * Validates a component configuration for missing keys across languages.
+     * @param config - The component configuration to validate.
+     * @returns ValidationResult containing errors and warnings.
+     */
+    validate(config) {
+        const errors = [];
+        const warnings = [];
+        // Check if all languages have all keys
+        const allKeys = new Set();
+        for (const langStrings of Object.values(config.strings)) {
+            for (const key of Object.keys(langStrings)) {
+                allKeys.add(key);
+            }
+        }
+        for (const [lang, langStrings] of Object.entries(config.strings)) {
+            for (const key of allKeys) {
+                if (!langStrings[key]) {
+                    warnings.push(`Missing key '${key}' for language '${lang}' in component '${config.id}'`);
+                }
+            }
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Sets constants for variable replacement.
+     * @param constants - The constants to set.
+     */
+    setConstants(constants) {
+        this.constants = constants;
+    }
+    /**
+     * Clears all registered components and aliases.
+     */
+    clear() {
+        this.components.clear();
+        this.aliasMap.clear();
+    }
+}
+exports.ComponentStore = ComponentStore;
+//# sourceMappingURL=component-store.js.map

package/src/core/component-store.js.map

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

package/src/core/context-manager.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Interface representing the translation context for an I18nEngine instance.
+ */
+export interface Context {
+    /** Current user-facing language code. */
+    language: string;
+    /** Current administrative language code. */
+    adminLanguage: string;
+    /** Active context space: 'admin' or 'user'. */
+    currentSpace: 'admin' | 'user';
+}
+/**
+ * ContextManager handles creation and management of per-instance translation contexts,
+ * including separate user and admin languages and context switching.
+ */
+export declare class ContextManager {
+    private contexts;
+    /**
+     * Creates a new context for a given instance key with a default language.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @param defaultLanguage Language code to initialize both user and admin contexts.
+     * @returns The newly created Context object.
+     */
+    create(instanceKey: string, defaultLanguage: string): Context;
+    /**
+     * Retrieves the context for a given instance key.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @returns The Context object associated with the key.
+     * @throws {Error} If no context exists for the provided key.
+     */
+    get(instanceKey: string): Context;
+    /**
+     * Sets the user-facing language for the specified context.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @param language New language code for user-facing translations.
+     */
+    setLanguage(instanceKey: string, language: string): void;
+    /**
+     * Sets the administrative language for the specified context.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @param language New language code for administrative translations.
+     */
+    setAdminLanguage(instanceKey: string, language: string): void;
+    /**
+     * Switches the active context space to 'admin'.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     */
+    switchToAdmin(instanceKey: string): void;
+    /**
+     * Switches the active context space to 'user'.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     */
+    switchToUser(instanceKey: string): void;
+    /**
+     * Retrieves the currently active language based on the context space.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @returns The active language code ('adminLanguage' or 'language').
+     */
+    getCurrentLanguage(instanceKey: string): string;
+    /**
+     * Clears all stored contexts, removing all instance data.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=context-manager.d.ts.map

package/src/core/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/context-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,YAAY,EAAE,OAAO,GAAG,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;IAU7D;;;;;;OAMG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxD;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK7D;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKvC;;;;;OAKG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAO/C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/src/core/context-manager.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextManager = void 0;
+/**
+ * ContextManager handles creation and management of per-instance translation contexts,
+ * including separate user and admin languages and context switching.
+ */
+class ContextManager {
+    contexts = new Map();
+    /**
+     * Creates a new context for a given instance key with a default language.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @param defaultLanguage Language code to initialize both user and admin contexts.
+     * @returns The newly created Context object.
+     */
+    create(instanceKey, defaultLanguage) {
+        const context = {
+            language: defaultLanguage,
+            adminLanguage: defaultLanguage,
+            currentSpace: 'user',
+        };
+        this.contexts.set(instanceKey, context);
+        return context;
+    }
+    /**
+     * Retrieves the context for a given instance key.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @returns The Context object associated with the key.
+     * @throws {Error} If no context exists for the provided key.
+     */
+    get(instanceKey) {
+        const context = this.contexts.get(instanceKey);
+        if (!context) {
+            throw new Error(`Context '${instanceKey}' not found`);
+        }
+        return context;
+    }
+    /**
+     * Sets the user-facing language for the specified context.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @param language New language code for user-facing translations.
+     */
+    setLanguage(instanceKey, language) {
+        const context = this.get(instanceKey);
+        context.language = language;
+    }
+    /**
+     * Sets the administrative language for the specified context.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @param language New language code for administrative translations.
+     */
+    setAdminLanguage(instanceKey, language) {
+        const context = this.get(instanceKey);
+        context.adminLanguage = language;
+    }
+    /**
+     * Switches the active context space to 'admin'.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     */
+    switchToAdmin(instanceKey) {
+        const context = this.get(instanceKey);
+        context.currentSpace = 'admin';
+    }
+    /**
+     * Switches the active context space to 'user'.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     */
+    switchToUser(instanceKey) {
+        const context = this.get(instanceKey);
+        context.currentSpace = 'user';
+    }
+    /**
+     * Retrieves the currently active language based on the context space.
+     *
+     * @param instanceKey Unique identifier for the context instance.
+     * @returns The active language code ('adminLanguage' or 'language').
+     */
+    getCurrentLanguage(instanceKey) {
+        const context = this.get(instanceKey);
+        return context.currentSpace === 'admin'
+            ? context.adminLanguage
+            : context.language;
+    }
+    /**
+     * Clears all stored contexts, removing all instance data.
+     */
+    clear() {
+        this.contexts.clear();
+    }
+}
+exports.ContextManager = ContextManager;
+//# sourceMappingURL=context-manager.js.map

package/src/core/context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/context-manager.ts"],"names":[],"mappings":";;;AAYA;;;GAGG;AACH,MAAa,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE9C;;;;;;OAMG;IACH,MAAM,CAAC,WAAmB,EAAE,eAAuB;QACjD,MAAM,OAAO,GAAY;YACvB,QAAQ,EAAE,eAAe;YACzB,aAAa,EAAE,eAAe;YAC9B,YAAY,EAAE,MAAM;SACrB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,WAAmB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,WAAW,aAAa,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,WAAmB,EAAE,QAAgB;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,WAAmB,EAAE,QAAgB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,CAAC,aAAa,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,WAAmB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,WAAmB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,WAAmB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC,YAAY,KAAK,OAAO;YACrC,CAAC,CAAC,OAAO,CAAC,aAAa;YACvB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAhGD,wCAgGC"}

package/src/core/enum-registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Enum translation registry (v2 - no generics)
+ */
+/**
+ * Registry for managing translations of enum values across multiple languages.
+ * Provides a centralized way to register and translate enum values.
+ */
+export declare class EnumRegistry {
+    private translations;
+    private enumNames;
+    private translateFn?;
+    /**
+     * Creates a new EnumRegistry instance.
+     * @param translateFn - Optional translation function for error messages
+     */
+    constructor(translateFn?: (key: string, vars?: Record<string, any>) => string);
+    /**
+     * Registers an enum with its translations for all languages.
+     * @template TEnum - The enum value type (string or number)
+     * @param enumObj - The enum object to register
+     * @param translations - Mapping of language codes to enum value translations
+     * @param enumName - Human-readable name for the enum (used in error messages)
+     */
+    register<TEnum extends string | number>(enumObj: Record<string, TEnum>, translations: Record<string, Record<string, string>>, enumName: string): void;
+    /**
+     * Translates an enum value to a specific language.
+     * @template TEnum - The enum value type
+     * @param enumObj - The registered enum object
+     * @param value - The enum value to translate
+     * @param language - The target language code
+     * @returns The translated string
+     * @throws {I18nError} If the enum, language, or value is not found
+     */
+    translate<TEnum extends string | number>(enumObj: Record<string, TEnum>, value: TEnum, language: string): string;
+    /**
+     * Checks if an enum has been registered.
+     * @param enumObj - The enum object to check
+     * @returns True if the enum is registered, false otherwise
+     */
+    has(enumObj: any): boolean;
+    /**
+     * Gets the human-readable name of an enum.
+     * @param enumObj - The enum object
+     * @returns The enum name or 'UnknownEnum' if not set
+     */
+    private getEnumName;
+}
+//# sourceMappingURL=enum-registry.d.ts.map

package/src/core/enum-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-registry.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/enum-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,WAAW,CAAC,CAAsD;IAE1E;;;OAGG;gBAED,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM;IAKnE;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACpD,QAAQ,EAAE,MAAM,GACf,IAAI;IAKP;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM;IAkCT;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAI1B;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAGpB"}