@digitaldefiance/i18n-lib 4.1.2 → 4.2.1

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

@@ -1,6 +1,107 @@
+/**
+ * Enum translation registry (v2 - no generics)
+ *
+ * This module provides the `EnumRegistry` class for managing translations of enum
+ * values across multiple languages. It supports both traditional TypeScript enums
+ * and branded enums from `@digitaldefiance/branded-enum`.
+ *
+ * ## Overview
+ *
+ * The `EnumRegistry` is the v2 implementation of enum translation management,
+ * designed to work with the `I18nEngine`. It provides:
+ *
+ * - Registration of enums with their translations
+ * - Translation of enum values to localized strings
+ * - Automatic name inference for branded enums
+ * - Full backward compatibility with traditional enums
+ *
+ * ## Branded Enum Support
+ *
+ * When registering branded enums, the registry can automatically infer the enum
+ * name from the branded enum's component ID, eliminating the need to provide
+ * an explicit name parameter.
+ *
+ * @example Traditional enum usage
+ * ```typescript
+ * enum Status { Active = 'active', Inactive = 'inactive' }
+ *
+ * const registry = new EnumRegistry();
+ * registry.register(Status, {
+ *   en: { active: 'Active', inactive: 'Inactive' },
+ *   es: { active: 'Activo', inactive: 'Inactivo' },
+ * }, 'Status');
+ *
+ * registry.translate(Status, Status.Active, 'en'); // 'Active'
+ * ```
+ *
+ * @example Branded enum usage (name inferred)
+ * ```typescript
+ * import { createBrandedEnum } from '@digitaldefiance/branded-enum';
+ *
+ * const Status = createBrandedEnum('status', { Active: 'active', Inactive: 'inactive' });
+ *
+ * const registry = new EnumRegistry();
+ * registry.register(Status, {
+ *   en: { active: 'Active', inactive: 'Inactive' },
+ * }); // Name 'status' is inferred from branded enum
+ *
+ * registry.translate(Status, Status.Active, 'en'); // 'Active'
+ * ```
+ *
+ * @module core/enum-registry
+ * @see {@link EnumTranslationRegistry} - Legacy registry with language validation
+ * @see {@link I18nEngine} - Main engine that uses this registry
+ */
+import type { AnyBrandedEnum, BrandedEnumValue } from '@digitaldefiance/branded-enum';
 /**
  * Registry for managing translations of enum values across multiple languages.
- * Provides a centralized way to register and translate enum values.
+ *
+ * Provides a centralized way to register and translate enum values with support
+ * for both traditional TypeScript enums and branded enums from
+ * `@digitaldefiance/branded-enum`.
+ *
+ * ## Key Features
+ *
+ * - **Dual Enum Support**: Works with both traditional and branded enums
+ * - **Automatic Name Inference**: Branded enums can have their name inferred from component ID
+ * - **Multi-Language**: Supports translations across any number of languages
+ * - **Type Safety**: Full TypeScript support with proper type inference
+ *
+ * ## Registration
+ *
+ * Use {@link register} to add an enum with its translations. For branded enums,
+ * the `enumName` parameter is optional and will be inferred from the component ID.
+ *
+ * ## Translation
+ *
+ * Use {@link translate} to get the localized string for an enum value. The method
+ * handles both traditional enum values and branded enum values.
+ *
+ * @example Complete workflow
+ * ```typescript
+ * import { createBrandedEnum } from '@digitaldefiance/branded-enum';
+ *
+ * // Create a branded enum
+ * const Priority = createBrandedEnum('priority', {
+ *   High: 'high',
+ *   Medium: 'medium',
+ *   Low: 'low',
+ * });
+ *
+ * // Create registry and register enum
+ * const registry = new EnumRegistry();
+ * registry.register(Priority, {
+ *   en: { high: 'High Priority', medium: 'Medium Priority', low: 'Low Priority' },
+ *   es: { high: 'Alta Prioridad', medium: 'Prioridad Media', low: 'Baja Prioridad' },
+ * });
+ *
+ * // Check if registered
+ * registry.has(Priority); // true
+ *
+ * // Translate values
+ * registry.translate(Priority, Priority.High, 'en'); // 'High Priority'
+ * registry.translate(Priority, Priority.High, 'es'); // 'Alta Prioridad'
+ * ```
  */
 export declare class EnumRegistry {
     private translations;
@@ -10,29 +111,143 @@ export declare class EnumRegistry {
      * Creates a new EnumRegistry instance.
      * @param translateFn - Optional translation function for error messages
      */
-    constructor(translateFn?: (key: string, vars?: Record<string, any>) => string);
+    constructor(translateFn?: (key: string, vars?: Record<string, unknown>) => string);
     /**
      * Registers an enum with its translations for all languages.
+     *
+     * Supports both traditional TypeScript enums and branded enums from
+     * `@digitaldefiance/branded-enum`. For branded enums, the `enumName` parameter
+     * is optional and will be automatically inferred from the branded enum's
+     * component ID.
+     *
+     * ## Name Resolution
+     *
+     * The enum name is resolved in the following order:
+     * 1. Explicit `enumName` parameter (if provided)
+     * 2. Component ID from branded enum (if branded)
+     * 3. `'UnknownEnum'` (fallback for traditional enums without name)
+     *
+     * ## Translation Structure
+     *
+     * The `translations` object should map language codes to objects that map
+     * enum values to their translated strings:
+     *
+     * ```typescript
+     * {
+     *   'en': { 'value1': 'Translation 1', 'value2': 'Translation 2' },
+     *   'es': { 'value1': 'Traducción 1', 'value2': 'Traducción 2' },
+     * }
+     * ```
+     *
      * @template TEnum - The enum value type (string or number)
-     * @param enumObj - The enum object to register
+     * @param enumObj - The enum object to register (traditional or branded)
      * @param translations - Mapping of language codes to enum value translations
-     * @param enumName - Human-readable name for the enum (used in error messages)
+     * @param enumName - Human-readable name for the enum (optional for branded enums)
+     * @returns The registered translations object
+     *
+     * @example Traditional enum (name required)
+     * ```typescript
+     * enum Status { Active = 'active', Inactive = 'inactive' }
+     *
+     * registry.register(Status, {
+     *   en: { active: 'Active', inactive: 'Inactive' },
+     *   es: { active: 'Activo', inactive: 'Inactivo' },
+     * }, 'Status');
+     * ```
+     *
+     * @example Branded enum (name inferred)
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active', Inactive: 'inactive' });
+     *
+     * // Name 'status' is automatically inferred from the branded enum
+     * registry.register(Status, {
+     *   en: { active: 'Active', inactive: 'Inactive' },
+     * });
+     * ```
+     *
+     * @example Branded enum with explicit name override
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active' });
+     *
+     * // Override the inferred name with a custom name
+     * registry.register(Status, {
+     *   en: { active: 'Active' },
+     * }, 'UserStatus');
+     * ```
+     */
+    register<TEnum extends string | number>(enumObj: Record<string, TEnum> | AnyBrandedEnum | {
+        [key: string]: string | number;
+    }, translations: Record<string, Record<string, string>>, enumName?: string): Record<string, Record<string, string>>;
+    /**
+     * Resolves the enum name from a branded enum's component ID or returns default.
+     * @param enumObj - The enum object
+     * @returns The resolved enum name
      */
-    register<TEnum extends string | number>(enumObj: Record<string, TEnum>, translations: Record<string, Record<string, string>>, enumName: string): void;
+    private resolveEnumName;
     /**
      * Translates an enum value to a specific language.
+     *
+     * Supports both traditional enum values and branded enum values. The method
+     * performs multiple lookup strategies to find the correct translation:
+     *
+     * ## Lookup Strategy
+     *
+     * 1. **Direct value lookup**: Try the string representation of the value
+     * 2. **Numeric enum reverse mapping**: For numeric enums, find the string key
+     * 3. **Branded enum key lookup**: For branded enums, find the enum key name
+     *
+     * ## Error Handling
+     *
+     * The method throws `I18nError` in the following cases:
+     * - Enum not registered: `I18nError.invalidConfig`
+     * - Language not found: `I18nError.languageNotFound`
+     * - Value not found: `I18nError.translationMissing`
+     *
      * @template TEnum - The enum value type
-     * @param enumObj - The registered enum object
+     * @param enumObj - The registered enum object (traditional or branded)
      * @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
+     *
+     * @example Basic translation
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active' });
+     * registry.register(Status, { en: { active: 'Active' }, es: { active: 'Activo' } });
+     *
+     * registry.translate(Status, Status.Active, 'en'); // 'Active'
+     * registry.translate(Status, Status.Active, 'es'); // 'Activo'
+     * ```
+     *
+     * @example Error handling
+     * ```typescript
+     * try {
+     *   registry.translate(UnregisteredEnum, 'value', 'en');
+     * } catch (error) {
+     *   // I18nError: No translations found for enum: UnknownEnum
+     * }
+     * ```
      */
-    translate<TEnum extends string | number>(enumObj: Record<string, TEnum>, value: TEnum, language: string): string;
+    translate<TEnum extends string | number>(enumObj: Record<string, TEnum> | AnyBrandedEnum | {
+        [key: string]: string | number;
+    }, value: TEnum | BrandedEnumValue<AnyBrandedEnum>, language: string): string;
     /**
      * Checks if an enum has been registered.
+     *
+     * Works with both traditional and branded enums. Uses object reference
+     * equality to check registration status.
+     *
      * @param enumObj - The enum object to check
-     * @returns True if the enum is registered, false otherwise
+     * @returns `true` if the enum is registered, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active' });
+     *
+     * registry.has(Status); // false (not registered yet)
+     * registry.register(Status, { en: { active: 'Active' } });
+     * registry.has(Status); // true
+     * ```
      */
     has(enumObj: object): boolean;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"enum-registry.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/enum-registry.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAGhB;IACJ,OAAO,CAAC,SAAS,CAAiC;IAClD,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,MAAM,GAAG,OAAO;IAI7B;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAGpB"}
+{"version":3,"file":"enum-registry.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/enum-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAOvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAGhB;IACJ,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,WAAW,CAAC,CAA0D;IAE9E;;;OAGG;gBAED,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM;IAKvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACpC,OAAO,EACH,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACrB,cAAc,GACd;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,EACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACpD,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAOzC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,SAAS,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACrC,OAAO,EACH,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACrB,cAAc,GACd;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,EACtC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAAC,cAAc,CAAC,EAC/C,QAAQ,EAAE,MAAM,GACf,MAAM;IA4CT;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/src/core/enum-registry.js

@@ -1,14 +1,111 @@
 "use strict";
-/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-return */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnumRegistry = void 0;
 /**
  * Enum translation registry (v2 - no generics)
+ *
+ * This module provides the `EnumRegistry` class for managing translations of enum
+ * values across multiple languages. It supports both traditional TypeScript enums
+ * and branded enums from `@digitaldefiance/branded-enum`.
+ *
+ * ## Overview
+ *
+ * The `EnumRegistry` is the v2 implementation of enum translation management,
+ * designed to work with the `I18nEngine`. It provides:
+ *
+ * - Registration of enums with their translations
+ * - Translation of enum values to localized strings
+ * - Automatic name inference for branded enums
+ * - Full backward compatibility with traditional enums
+ *
+ * ## Branded Enum Support
+ *
+ * When registering branded enums, the registry can automatically infer the enum
+ * name from the branded enum's component ID, eliminating the need to provide
+ * an explicit name parameter.
+ *
+ * @example Traditional enum usage
+ * ```typescript
+ * enum Status { Active = 'active', Inactive = 'inactive' }
+ *
+ * const registry = new EnumRegistry();
+ * registry.register(Status, {
+ *   en: { active: 'Active', inactive: 'Inactive' },
+ *   es: { active: 'Activo', inactive: 'Inactivo' },
+ * }, 'Status');
+ *
+ * registry.translate(Status, Status.Active, 'en'); // 'Active'
+ * ```
+ *
+ * @example Branded enum usage (name inferred)
+ * ```typescript
+ * import { createBrandedEnum } from '@digitaldefiance/branded-enum';
+ *
+ * const Status = createBrandedEnum('status', { Active: 'active', Inactive: 'inactive' });
+ *
+ * const registry = new EnumRegistry();
+ * registry.register(Status, {
+ *   en: { active: 'Active', inactive: 'Inactive' },
+ * }); // Name 'status' is inferred from branded enum
+ *
+ * registry.translate(Status, Status.Active, 'en'); // 'Active'
+ * ```
+ *
+ * @module core/enum-registry
+ * @see {@link EnumTranslationRegistry} - Legacy registry with language validation
+ * @see {@link I18nEngine} - Main engine that uses this registry
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnumRegistry = void 0;
+const branded_enum_utils_1 = require("../branded-enum-utils");
 const i18n_error_1 = require("../errors/i18n-error");
 /**
  * Registry for managing translations of enum values across multiple languages.
- * Provides a centralized way to register and translate enum values.
+ *
+ * Provides a centralized way to register and translate enum values with support
+ * for both traditional TypeScript enums and branded enums from
+ * `@digitaldefiance/branded-enum`.
+ *
+ * ## Key Features
+ *
+ * - **Dual Enum Support**: Works with both traditional and branded enums
+ * - **Automatic Name Inference**: Branded enums can have their name inferred from component ID
+ * - **Multi-Language**: Supports translations across any number of languages
+ * - **Type Safety**: Full TypeScript support with proper type inference
+ *
+ * ## Registration
+ *
+ * Use {@link register} to add an enum with its translations. For branded enums,
+ * the `enumName` parameter is optional and will be inferred from the component ID.
+ *
+ * ## Translation
+ *
+ * Use {@link translate} to get the localized string for an enum value. The method
+ * handles both traditional enum values and branded enum values.
+ *
+ * @example Complete workflow
+ * ```typescript
+ * import { createBrandedEnum } from '@digitaldefiance/branded-enum';
+ *
+ * // Create a branded enum
+ * const Priority = createBrandedEnum('priority', {
+ *   High: 'high',
+ *   Medium: 'medium',
+ *   Low: 'low',
+ * });
+ *
+ * // Create registry and register enum
+ * const registry = new EnumRegistry();
+ * registry.register(Priority, {
+ *   en: { high: 'High Priority', medium: 'Medium Priority', low: 'Low Priority' },
+ *   es: { high: 'Alta Prioridad', medium: 'Prioridad Media', low: 'Baja Prioridad' },
+ * });
+ *
+ * // Check if registered
+ * registry.has(Priority); // true
+ *
+ * // Translate values
+ * registry.translate(Priority, Priority.High, 'en'); // 'High Priority'
+ * registry.translate(Priority, Priority.High, 'es'); // 'Alta Prioridad'
+ * ```
  */
 class EnumRegistry {
     translations = new Map();
@@ -23,23 +120,128 @@ class EnumRegistry {
     }
     /**
      * Registers an enum with its translations for all languages.
+     *
+     * Supports both traditional TypeScript enums and branded enums from
+     * `@digitaldefiance/branded-enum`. For branded enums, the `enumName` parameter
+     * is optional and will be automatically inferred from the branded enum's
+     * component ID.
+     *
+     * ## Name Resolution
+     *
+     * The enum name is resolved in the following order:
+     * 1. Explicit `enumName` parameter (if provided)
+     * 2. Component ID from branded enum (if branded)
+     * 3. `'UnknownEnum'` (fallback for traditional enums without name)
+     *
+     * ## Translation Structure
+     *
+     * The `translations` object should map language codes to objects that map
+     * enum values to their translated strings:
+     *
+     * ```typescript
+     * {
+     *   'en': { 'value1': 'Translation 1', 'value2': 'Translation 2' },
+     *   'es': { 'value1': 'Traducción 1', 'value2': 'Traducción 2' },
+     * }
+     * ```
+     *
      * @template TEnum - The enum value type (string or number)
-     * @param enumObj - The enum object to register
+     * @param enumObj - The enum object to register (traditional or branded)
      * @param translations - Mapping of language codes to enum value translations
-     * @param enumName - Human-readable name for the enum (used in error messages)
+     * @param enumName - Human-readable name for the enum (optional for branded enums)
+     * @returns The registered translations object
+     *
+     * @example Traditional enum (name required)
+     * ```typescript
+     * enum Status { Active = 'active', Inactive = 'inactive' }
+     *
+     * registry.register(Status, {
+     *   en: { active: 'Active', inactive: 'Inactive' },
+     *   es: { active: 'Activo', inactive: 'Inactivo' },
+     * }, 'Status');
+     * ```
+     *
+     * @example Branded enum (name inferred)
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active', Inactive: 'inactive' });
+     *
+     * // Name 'status' is automatically inferred from the branded enum
+     * registry.register(Status, {
+     *   en: { active: 'Active', inactive: 'Inactive' },
+     * });
+     * ```
+     *
+     * @example Branded enum with explicit name override
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active' });
+     *
+     * // Override the inferred name with a custom name
+     * registry.register(Status, {
+     *   en: { active: 'Active' },
+     * }, 'UserStatus');
+     * ```
      */
     register(enumObj, translations, enumName) {
+        const resolvedName = enumName ?? this.resolveEnumName(enumObj);
         this.translations.set(enumObj, translations);
-        this.enumNames.set(enumObj, enumName);
+        this.enumNames.set(enumObj, resolvedName);
+        return translations;
+    }
+    /**
+     * Resolves the enum name from a branded enum's component ID or returns default.
+     * @param enumObj - The enum object
+     * @returns The resolved enum name
+     */
+    resolveEnumName(enumObj) {
+        if ((0, branded_enum_utils_1.isBrandedEnum)(enumObj)) {
+            const componentId = (0, branded_enum_utils_1.getBrandedEnumComponentId)(enumObj);
+            return componentId ?? 'UnknownEnum';
+        }
+        return 'UnknownEnum';
     }
     /**
      * Translates an enum value to a specific language.
+     *
+     * Supports both traditional enum values and branded enum values. The method
+     * performs multiple lookup strategies to find the correct translation:
+     *
+     * ## Lookup Strategy
+     *
+     * 1. **Direct value lookup**: Try the string representation of the value
+     * 2. **Numeric enum reverse mapping**: For numeric enums, find the string key
+     * 3. **Branded enum key lookup**: For branded enums, find the enum key name
+     *
+     * ## Error Handling
+     *
+     * The method throws `I18nError` in the following cases:
+     * - Enum not registered: `I18nError.invalidConfig`
+     * - Language not found: `I18nError.languageNotFound`
+     * - Value not found: `I18nError.translationMissing`
+     *
      * @template TEnum - The enum value type
-     * @param enumObj - The registered enum object
+     * @param enumObj - The registered enum object (traditional or branded)
      * @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
+     *
+     * @example Basic translation
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active' });
+     * registry.register(Status, { en: { active: 'Active' }, es: { active: 'Activo' } });
+     *
+     * registry.translate(Status, Status.Active, 'en'); // 'Active'
+     * registry.translate(Status, Status.Active, 'es'); // 'Activo'
+     * ```
+     *
+     * @example Error handling
+     * ```typescript
+     * try {
+     *   registry.translate(UnregisteredEnum, 'value', 'en');
+     * } catch (error) {
+     *   // I18nError: No translations found for enum: UnknownEnum
+     * }
+     * ```
      */
     translate(enumObj, value, language) {
         const translations = this.translations.get(enumObj);
@@ -60,6 +262,13 @@ class EnumRegistry {
                 result = langTranslations[stringKey];
             }
         }
+        // For branded enums, try looking up by the enum key name
+        if (!result && (0, branded_enum_utils_1.isBrandedEnum)(enumObj)) {
+            const enumKey = Object.keys(enumObj).find((key) => enumObj[key] === value);
+            if (enumKey) {
+                result = langTranslations[enumKey];
+            }
+        }
         if (!result) {
             throw i18n_error_1.I18nError.translationMissing('enum', String(value), language);
         }
@@ -67,8 +276,21 @@ class EnumRegistry {
     }
     /**
      * Checks if an enum has been registered.
+     *
+     * Works with both traditional and branded enums. Uses object reference
+     * equality to check registration status.
+     *
      * @param enumObj - The enum object to check
-     * @returns True if the enum is registered, false otherwise
+     * @returns `true` if the enum is registered, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * const Status = createBrandedEnum('status', { Active: 'active' });
+     *
+     * registry.has(Status); // false (not registered yet)
+     * registry.register(Status, { en: { active: 'Active' } });
+     * registry.has(Status); // true
+     * ```
      */
     has(enumObj) {
         return this.translations.has(enumObj);

package/src/core/enum-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum-registry.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/enum-registry.ts"],"names":[],"mappings":";AAAA,2PAA2P;;;AAE3P;;GAEG;AAEH,qDAAiD;AAEjD;;;GAGG;AACH,MAAa,YAAY;IACf,YAAY,GAAG,IAAI,GAAG,EAG3B,CAAC;IACI,SAAS,GAAG,IAAI,OAAO,EAAkB,CAAC;IAC1C,WAAW,CAAuD;IAE1E;;;OAGG;IACH,YACE,WAAiE;QAEjE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACN,OAA8B,EAC9B,YAAoD,EACpD,QAAgB;QAEhB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CACP,OAA8B,EAC9B,KAAY,EACZ,QAAgB;QAEhB,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,sBAAS,CAAC,aAAa,CAC3B,mCAAmC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,sBAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAED,qCAAqC;QACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAExC,wEAAwE;QACxE,IAAI,CAAC,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACzC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAChC,CAAC;YACF,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,sBAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACK,WAAW,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC;IACtD,CAAC;CACF;AAlGD,oCAkGC"}
+{"version":3,"file":"enum-registry.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/enum-registry.ts"],"names":[],"mappings":"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"}