@digitaldefiance/i18n-lib 4.2.2 → 4.3.0

package/README.md

@@ -4,6 +4,24 @@ A production-ready TypeScript internationalization library with component-based
 
 Part of [Express Suite](https://github.com/Digital-Defiance/express-suite)
 
+## What's New in v4.3.0
+
+✨ **String Key Enum Registration** - Register branded string key enums for direct translation without specifying component IDs.
+
+**New Features:**
+- **`registerStringKeyEnum()`**: Register branded enums for automatic component routing
+- **`translateStringKey()`**: Translate keys directly - component ID resolved from branded enum
+- **`safeTranslateStringKey()`**: Safe version returning placeholder on failure
+- **`hasStringKeyEnum()` / `getStringKeyEnums()`**: Query registered enums
+
+```typescript
+// Register your branded enum
+engine.registerStringKeyEnum(MyBrandedKeys);
+
+// Translate without component ID - it's resolved automatically
+const text = engine.translateStringKey(MyBrandedKeys.Welcome, { name: 'Alice' });
+```
+
 ## Features
 
 - **Production-Grade Security**: Comprehensive protection against common attacks
@@ -464,6 +482,33 @@ const engine = I18nBuilder.create()
   .build();
 ```
 
+#### Builder with String Key Enum Registration
+
+Register branded string key enums during engine construction for direct translation via `translateStringKey()`:
+
+```typescript
+import { I18nBuilder, createI18nStringKeysFromEnum } from '@digitaldefiance/i18n-lib';
+
+// Create branded enum from your string keys
+enum MyStringKeys {
+  Welcome = 'welcome',
+  Goodbye = 'goodbye',
+}
+const BrandedKeys = createI18nStringKeysFromEnum('my-component', MyStringKeys);
+
+const engine = I18nBuilder.create()
+  .withLanguages([
+    { id: 'en-US', name: 'English', code: 'en-US', isDefault: true },
+  ])
+  .withStringKeyEnum(BrandedKeys)  // Register single enum
+  // Or register multiple at once:
+  // .withStringKeyEnums([BrandedKeys, OtherKeys])
+  .build();
+
+// Now you can translate directly without component ID
+engine.translateStringKey(BrandedKeys.Welcome);
+```
+
 ### Context Integration
 
 ```typescript
@@ -674,6 +719,11 @@ LanguageCodes.UK     // 'uk'
 - `validate()` - Validate all components
 - `registerBrandedComponent(registration)` - Register component with branded string keys
 - `getCollisionReport()` - Get map of key collisions across components
+- `registerStringKeyEnum(enum)` - Register a branded string key enum for direct translation
+- `translateStringKey(key, variables?, language?)` - Translate a branded string key directly
+- `safeTranslateStringKey(key, variables?, language?)` - Safe version returning placeholder on failure
+- `hasStringKeyEnum(enum)` - Check if a branded enum is registered
+- `getStringKeyEnums()` - Get all registered branded enums
 
 ### Branded Enum Functions
 
@@ -924,6 +974,77 @@ const allValues = getStringKeyValues(AllKeys);
 
 For complete migration guide, see [BRANDED_ENUM_MIGRATION.md](docs/BRANDED_ENUM_MIGRATION.md).
 
+### String Key Enum Registration
+
+Register branded string key enums with the engine for direct translation without specifying component IDs. This simplifies translation calls and enables automatic component routing.
+
+#### Registering String Key Enums
+
+```typescript
+import { createI18nStringKeysFromEnum, PluginI18nEngine } from '@digitaldefiance/i18n-lib';
+
+// Create a branded enum from your string keys
+enum MyStringKeys {
+  Welcome = 'welcome',
+  Goodbye = 'goodbye',
+}
+
+const BrandedKeys = createI18nStringKeysFromEnum('my-component', MyStringKeys);
+
+// Create engine and register component
+const engine = PluginI18nEngine.createInstance('myapp', languages);
+engine.registerBrandedComponent({
+  component: {
+    id: 'my-component',
+    name: 'My Component',
+    brandedStringKeys: BrandedKeys,
+  },
+  strings: {
+    [LanguageCodes.EN_US]: {
+      [BrandedKeys.Welcome]: 'Welcome!',
+      [BrandedKeys.Goodbye]: 'Goodbye!',
+    },
+  },
+});
+
+// Register the enum for direct translation
+engine.registerStringKeyEnum(BrandedKeys);
+```
+
+#### Direct Translation with translateStringKey
+
+Once registered, translate keys directly without specifying the component ID:
+
+```typescript
+// Before: Required component ID
+const text = engine.translate('my-component', BrandedKeys.Welcome, { name: 'Alice' });
+
+// After: Component ID resolved automatically from branded enum
+const text = engine.translateStringKey(BrandedKeys.Welcome, { name: 'Alice' });
+
+// Safe version returns placeholder on failure instead of throwing
+const safeText = engine.safeTranslateStringKey(BrandedKeys.Welcome, { name: 'Alice' });
+```
+
+#### Checking Registration Status
+
+```typescript
+// Check if an enum is registered
+if (engine.hasStringKeyEnum(BrandedKeys)) {
+  console.log('BrandedKeys is registered');
+}
+
+// Get all registered enums
+const registeredEnums = engine.getStringKeyEnums();
+```
+
+#### Benefits
+
+- **Cleaner Code**: No need to repeat component IDs in every translation call
+- **Automatic Routing**: Component ID resolved from branded enum metadata
+- **Type Safety**: Full TypeScript support with branded enum types
+- **Idempotent**: Safe to call `registerStringKeyEnum()` multiple times
+
 ### Branded Enum Translation
 
 The enum translation system supports branded enums from `@digitaldefiance/branded-enum`, enabling automatic name inference and type-safe enum value translations.
@@ -1123,6 +1244,107 @@ Contributions welcome! Please:
 
 ## ChangeLog
 
+### Version 4.3.0
+
+**String Key Enum Registration for Direct Translation**
+
+This release adds the ability to register branded string key enums with the I18nEngine for direct translation via `translateStringKey()`. This enables automatic component ID resolution from branded enum values.
+
+**New Features:**
+
+- **`registerStringKeyEnum()`**: Register a branded string key enum for direct translation support
+  ```typescript
+  import { createI18nStringKeysFromEnum } from '@digitaldefiance/i18n-lib';
+  
+  const MyKeys = createI18nStringKeysFromEnum('my-component', MyStringKeyEnum);
+  engine.registerStringKeyEnum(MyKeys);
+  ```
+
+- **`translateStringKey()`**: Translate a branded string key value directly without specifying component ID
+  ```typescript
+  // Before: engine.translate('my-component', MyKeys.Welcome, { name: 'Alice' });
+  // After:
+  engine.translateStringKey(MyKeys.Welcome, { name: 'Alice' });
+  ```
+
+- **`safeTranslateStringKey()`**: Safe version that returns a placeholder on failure instead of throwing
+
+- **`hasStringKeyEnum()`**: Check if a branded enum is registered
+
+- **`getStringKeyEnums()`**: Get all registered branded enums
+
+**New Error Codes:**
+
+- `INVALID_STRING_KEY_ENUM` - When a non-branded enum is passed to `registerStringKeyEnum()`
+- `STRING_KEY_NOT_REGISTERED` - When translating a key from an unregistered enum
+
+**Benefits:**
+
+- Cleaner translation calls without repeating component IDs
+- Automatic component routing based on branded enum metadata
+- Type-safe translations with full TypeScript support
+- Idempotent registration (safe to call multiple times)
+
+### Version 4.2.0
+
+**Branded Enum Translation Support**
+
+This release adds comprehensive support for translating branded enums from `@digitaldefiance/branded-enum`, enabling automatic name inference and type-safe enum value translations.
+
+**New Features:**
+
+- **Automatic Name Inference**: When registering a branded enum, the name is automatically extracted from the enum's component ID
+  ```typescript
+  const Status = createBrandedEnum('status', { Active: 'active', Inactive: 'inactive' });
+  engine.registerEnum(Status, translations); // Name 'status' inferred automatically
+  ```
+
+- **New Utility Functions**:
+  - `isBrandedEnum()` - Type guard to detect branded enums
+  - `getBrandedEnumComponentId()` - Extract component ID from branded enum
+  - `getBrandedEnumId()` - Get raw brand ID for debugging
+
+- **Enhanced `registerEnum()`**: Now accepts branded enums and returns the registered translations object
+
+- **Property-Based Tests**: Comprehensive property tests for branded enum translation ensuring:
+  - Registration idempotence
+  - Translation consistency across languages
+  - Proper error handling for missing translations
+
+**Documentation:**
+
+- Added "Branded Enum Translation" section to README
+- Comprehensive JSDoc documentation for all new utilities
+
+### Version 4.1.0
+
+**Enhanced Type Documentation and BrandedMasterStringsCollection**
+
+This release focuses on improved documentation and ergonomic type aliases for working with branded enums.
+
+**New Features:**
+
+- **`BrandedMasterStringsCollection<E, TLanguage>`**: Ergonomic type alias for defining translation collections with branded enums
+  ```typescript
+  const translations: BrandedMasterStringsCollection<typeof MyKeys, CoreLanguageCode> = {
+    [LanguageCodes.EN_US]: { 'my.welcome': 'Welcome!' },
+    [LanguageCodes.FR]: { 'my.welcome': 'Bienvenue!' },
+  };
+  ```
+
+- **`BrandedPluralMasterStringsCollection<E, TLanguage>`**: Type alias for plural-aware branded translations
+
+- **Comprehensive Module Documentation**: Added extensive JSDoc documentation to `types.ts` explaining:
+  - Traditional enums vs branded enums
+  - Migration patterns from legacy enums
+  - Complete examples for defining translations
+
+**Documentation:**
+
+- Step-by-step guide for creating branded string keys
+- Examples showing `BrandedMasterStringsCollection` usage
+- Migration guide from traditional `EnumLanguageTranslation` types
+
 ### Version 4.0.4
 
 **Branded Enums for Runtime String Key Identification**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/i18n-lib",
-  "version": "4.2.2",
+  "version": "4.3.0",
   "description": "i18n library with enum translation support",
   "homepage": "https://github.com/Digital-Defiance/i18n-lib",
   "repository": {

package/src/builders/i18n-builder.d.ts

@@ -1,6 +1,7 @@
 /**
  * Fluent builder for I18n Engine
  */
+import type { AnyBrandedEnum } from '@digitaldefiance/branded-enum';
 import { I18nEngine } from '../core/i18n-engine';
 import { EngineConfig, LanguageDefinition } from '../interfaces';
 export declare class I18nBuilder {
@@ -9,6 +10,7 @@ export declare class I18nBuilder {
     private instanceKey;
     private registerInstance;
     private setAsDefault;
+    private stringKeyEnums;
     private constructor();
     static create(): I18nBuilder;
     withLanguages(languages: readonly LanguageDefinition[]): this;
@@ -19,6 +21,17 @@ export declare class I18nBuilder {
     withInstanceKey(key: string): this;
     withRegisterInstance(register: boolean): this;
     withSetAsDefault(setDefault: boolean): this;
+    /**
+     * Register a branded string key enum for direct translation via translateStringKey().
+     * Multiple enums can be registered by calling this method multiple times.
+     * @param stringKeyEnum - Branded enum created by createI18nStringKeys or createI18nStringKeysFromEnum
+     */
+    withStringKeyEnum(stringKeyEnum: AnyBrandedEnum): this;
+    /**
+     * Register multiple branded string key enums for direct translation.
+     * @param stringKeyEnums - Array of branded enums
+     */
+    withStringKeyEnums(stringKeyEnums: readonly AnyBrandedEnum[]): this;
     isolated(): this;
     asDefault(): this;
     build(): I18nEngine;

package/src/builders/i18n-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/builders/i18n-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEjE,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,YAAY,CAAQ;IAE5B,OAAO;IAEP,MAAM,CAAC,MAAM,IAAI,WAAW;IAI5B,aAAa,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAK7D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK7C,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM9C,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKnD,cAAc,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,IAAI;IAK5D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKlC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK7C,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAK3C,QAAQ,IAAI,IAAI;IAKhB,SAAS,IAAI,IAAI;IAKjB,KAAK,IAAI,UAAU;CAWpB"}
+{"version":3,"file":"i18n-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/builders/i18n-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEjE,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO;IAEP,MAAM,CAAC,MAAM,IAAI,WAAW;IAI5B,aAAa,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAK7D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK7C,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM9C,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKnD,cAAc,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,IAAI;IAK5D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKlC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK7C,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAK3C;;;;OAIG;IACH,iBAAiB,CAAC,aAAa,EAAE,cAAc,GAAG,IAAI;IAKtD;;;OAGG;IACH,kBAAkB,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IAKnE,QAAQ,IAAI,IAAI;IAKhB,SAAS,IAAI,IAAI;IAKjB,KAAK,IAAI,UAAU;CAkBpB"}

package/src/builders/i18n-builder.js

@@ -12,6 +12,7 @@ class I18nBuilder {
     instanceKey = 'default';
     registerInstance = true;
     setAsDefault = true;
+    stringKeyEnums = [];
     constructor() { }
     static create() {
         return new I18nBuilder();
@@ -49,6 +50,23 @@ class I18nBuilder {
         this.setAsDefault = setDefault;
         return this;
     }
+    /**
+     * Register a branded string key enum for direct translation via translateStringKey().
+     * Multiple enums can be registered by calling this method multiple times.
+     * @param stringKeyEnum - Branded enum created by createI18nStringKeys or createI18nStringKeysFromEnum
+     */
+    withStringKeyEnum(stringKeyEnum) {
+        this.stringKeyEnums.push(stringKeyEnum);
+        return this;
+    }
+    /**
+     * Register multiple branded string key enums for direct translation.
+     * @param stringKeyEnums - Array of branded enums
+     */
+    withStringKeyEnums(stringKeyEnums) {
+        this.stringKeyEnums.push(...stringKeyEnums);
+        return this;
+    }
     isolated() {
         this.registerInstance = false;
         return this;
@@ -61,11 +79,16 @@ class I18nBuilder {
         if (this.languages.length === 0) {
             throw new Error('At least one language must be provided');
         }
-        return new i18n_engine_1.I18nEngine(this.languages, this.config, {
+        const engine = new i18n_engine_1.I18nEngine(this.languages, this.config, {
             instanceKey: this.instanceKey,
             registerInstance: this.registerInstance,
             setAsDefault: this.setAsDefault,
         });
+        // Register all string key enums
+        for (const enumObj of this.stringKeyEnums) {
+            engine.registerStringKeyEnum(enumObj);
+        }
+        return engine;
     }
 }
 exports.I18nBuilder = I18nBuilder;

package/src/builders/i18n-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/builders/i18n-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,uDAAuD;;;AAEvD,qDAAiD;AAGjD,MAAa,WAAW;IACd,SAAS,GAAyB,EAAE,CAAC;IACrC,MAAM,GAAiB,EAAE,CAAC;IAC1B,WAAW,GAAG,SAAS,CAAC;IACxB,gBAAgB,GAAG,IAAI,CAAC;IACxB,YAAY,GAAG,IAAI,CAAC;IAE5B,gBAAuB,CAAC;IAExB,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,SAAwC;QACpD,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB,CAAC,UAAkB;QACpC,IAAI,CAAC,MAAM,CAAC,eAAe,GAAG,UAAU,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB,CAAC,UAAkB;QACrC,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,UAAU,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8DAA8D;IAC9D,aAAa,CAAC,SAA8B;QAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,UAAsC;QACnD,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe,CAAC,GAAW;QACzB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB,CAAC,QAAiB;QACpC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CAAC,UAAmB;QAClC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS;QACP,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,IAAI,wBAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;YACjD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA3ED,kCA2EC"}
+{"version":3,"file":"i18n-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/builders/i18n-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,uDAAuD;;;AAGvD,qDAAiD;AAGjD,MAAa,WAAW;IACd,SAAS,GAAyB,EAAE,CAAC;IACrC,MAAM,GAAiB,EAAE,CAAC;IAC1B,WAAW,GAAG,SAAS,CAAC;IACxB,gBAAgB,GAAG,IAAI,CAAC;IACxB,YAAY,GAAG,IAAI,CAAC;IACpB,cAAc,GAAqB,EAAE,CAAC;IAE9C,gBAAuB,CAAC;IAExB,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,SAAwC;QACpD,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB,CAAC,UAAkB;QACpC,IAAI,CAAC,MAAM,CAAC,eAAe,GAAG,UAAU,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB,CAAC,UAAkB;QACrC,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,UAAU,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8DAA8D;IAC9D,aAAa,CAAC,SAA8B;QAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,UAAsC;QACnD,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe,CAAC,GAAW;QACzB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB,CAAC,QAAiB;QACpC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CAAC,UAAmB;QAClC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,aAA6B;QAC7C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,cAAyC;QAC1D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS;QACP,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,wBAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;YACzD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QAEH,gCAAgC;QAChC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAtGD,kCAsGC"}

package/src/core/i18n-engine.d.ts

@@ -14,6 +14,7 @@ export declare class I18nEngine implements II18nEngine {
     private static readonly contextManager;
     private readonly componentStore;
     private readonly enumRegistry;
+    private readonly stringKeyEnumRegistry;
     private readonly instanceKey;
     private readonly config;
     private readonly aliasToComponent;
@@ -241,7 +242,7 @@ export declare class I18nEngine implements II18nEngine {
      */
     registerEnum<TEnum extends string | number>(enumObj: Record<string, TEnum> | AnyBrandedEnum | {
         [key: string]: string | number;
-    }, translations: Record<string, Record<TEnum | string, string>>, enumName?: string): Record<string, Record<string, string>>;
+    }, translations: Record<string, Record<TEnum | string, string>>, enumName?: string): Record<string, Record<TEnum, string>>;
     /**
      * Translates an enum value for the current or specified language.
      *
@@ -309,6 +310,172 @@ export declare class I18nEngine implements II18nEngine {
      * @see {@link translateEnum} - Translate registered enum values
      */
     hasEnum(enumObj: object): boolean;
+    /**
+     * Registers a branded string key enum for automatic component ID resolution.
+     *
+     * This method enables direct translation of string key values without requiring
+     * per-component wrapper functions. Once registered, the engine can automatically
+     * resolve the component ID from any string key value belonging to the enum.
+     *
+     * ## Registration Behavior
+     *
+     * - Extracts the component ID from the branded enum's metadata
+     * - Stores a reference to the enum for later lookup
+     * - Idempotent: re-registering the same enum returns the same component ID
+     * - Skips re-registration if another enum with the same component ID exists
+     *
+     * ## Validation
+     *
+     * The method validates that the provided object is a branded enum created
+     * with `createI18nStringKeys` or `createBrandedEnum`. Non-branded objects
+     * will cause an error to be thrown.
+     *
+     * @param stringKeyEnum - Branded enum created by createI18nStringKeys
+     * @returns The extracted component ID
+     * @throws {I18nError} If not a valid branded enum (INVALID_STRING_KEY_ENUM)
+     *
+     * @example Basic registration
+     * ```typescript
+     * const UserKeys = createI18nStringKeys('user', {
+     *   Welcome: 'user.welcome',
+     *   Goodbye: 'user.goodbye',
+     * } as const);
+     *
+     * const componentId = engine.registerStringKeyEnum(UserKeys);
+     * console.log(componentId); // 'user'
+     * ```
+     *
+     * @example Idempotent registration
+     * ```typescript
+     * engine.registerStringKeyEnum(UserKeys); // 'user'
+     * engine.registerStringKeyEnum(UserKeys); // 'user' (same result, no duplicate)
+     * ```
+     *
+     * @see {@link translateStringKey} - Translate registered string key values
+     * @see {@link hasStringKeyEnum} - Check if an enum is registered
+     */
+    registerStringKeyEnum(stringKeyEnum: AnyBrandedEnum): string;
+    /**
+     * Translates a branded string key value directly.
+     *
+     * This method automatically resolves the component ID from the branded string
+     * key value and calls the underlying `translate` method. It eliminates the need
+     * for per-component wrapper functions.
+     *
+     * ## Resolution Process
+     *
+     * 1. Resolves the component ID from the string key value using the registry
+     * 2. Calls `translate(componentId, stringKeyValue, variables, language)`
+     * 3. Returns the translated string
+     *
+     * ## Prerequisites
+     *
+     * The branded enum containing the string key value must be registered via
+     * {@link registerStringKeyEnum} before calling this method.
+     *
+     * @template E - The branded enum type
+     * @param stringKeyValue - Branded string key value to translate
+     * @param variables - Optional variables for template substitution
+     * @param language - Optional language code (defaults to current language)
+     * @returns Translated string
+     * @throws {I18nError} If the string key is not registered (STRING_KEY_NOT_REGISTERED)
+     * @throws {I18nError} If the translation key is not found (KEY_NOT_FOUND)
+     *
+     * @example Basic translation
+     * ```typescript
+     * const UserKeys = createI18nStringKeys('user', { Welcome: 'user.welcome' });
+     * engine.registerStringKeyEnum(UserKeys);
+     *
+     * engine.translateStringKey(UserKeys.Welcome); // 'Welcome!'
+     * ```
+     *
+     * @example With variables
+     * ```typescript
+     * engine.translateStringKey(UserKeys.Greeting, { name: 'John' }); // 'Hello, John!'
+     * ```
+     *
+     * @example With explicit language
+     * ```typescript
+     * engine.translateStringKey(UserKeys.Welcome, undefined, 'es'); // '¡Bienvenido!'
+     * ```
+     *
+     * @see {@link registerStringKeyEnum} - Register enums for translation
+     * @see {@link safeTranslateStringKey} - Safe version that returns placeholder on failure
+     */
+    translateStringKey<E extends AnyBrandedEnum>(stringKeyValue: BrandedEnumValue<E>, variables?: Record<string, unknown>, language?: string): string;
+    /**
+     * Safely translates a branded string key value.
+     *
+     * Returns a placeholder string on failure instead of throwing an exception.
+     * This is useful for UI code where a missing translation should not crash
+     * the application.
+     *
+     * ## Placeholder Format
+     *
+     * - If component ID is resolved: `[componentId.stringKeyValue]`
+     * - If component ID cannot be resolved: `[unknown.stringKeyValue]`
+     *
+     * @template E - The branded enum type
+     * @param stringKeyValue - Branded string key value to translate
+     * @param variables - Optional variables for template substitution
+     * @param language - Optional language code (defaults to current language)
+     * @returns Translated string or placeholder on failure
+     *
+     * @example Safe translation
+     * ```typescript
+     * engine.safeTranslateStringKey(UserKeys.Welcome); // 'Welcome!' or '[user.user.welcome]'
+     * ```
+     *
+     * @see {@link translateStringKey} - Throwing version
+     * @see {@link registerStringKeyEnum} - Register enums for translation
+     */
+    safeTranslateStringKey<E extends AnyBrandedEnum>(stringKeyValue: BrandedEnumValue<E>, variables?: Record<string, unknown>, language?: string): string;
+    /**
+     * Checks if a branded string key enum is registered.
+     *
+     * Uses object reference equality to check registration status.
+     *
+     * @param stringKeyEnum - The branded enum to check
+     * @returns `true` if the enum is registered, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * engine.hasStringKeyEnum(UserKeys); // false (not registered yet)
+     * engine.registerStringKeyEnum(UserKeys);
+     * engine.hasStringKeyEnum(UserKeys); // true
+     * ```
+     *
+     * @see {@link registerStringKeyEnum} - Register enums
+     * @see {@link getStringKeyEnums} - Get all registered enums
+     */
+    hasStringKeyEnum(stringKeyEnum: AnyBrandedEnum): boolean;
+    /**
+     * Gets all registered string key enums with their component IDs.
+     *
+     * Returns a readonly array of entries containing the enum reference
+     * and its associated component ID.
+     *
+     * @returns Readonly array of objects with enumObj and componentId
+     *
+     * @example
+     * ```typescript
+     * engine.registerStringKeyEnum(UserKeys);
+     * engine.registerStringKeyEnum(AdminKeys);
+     *
+     * const enums = engine.getStringKeyEnums();
+     * // [
+     * //   { enumObj: UserKeys, componentId: 'user' },
+     * //   { enumObj: AdminKeys, componentId: 'admin' }
+     * // ]
+     * ```
+     *
+     * @see {@link registerStringKeyEnum} - Register enums
+     * @see {@link hasStringKeyEnum} - Check if an enum is registered
+     */
+    getStringKeyEnums(): readonly {
+        enumObj: AnyBrandedEnum;
+        componentId: string;
+    }[];
     /**
      * Validates all registered components for missing translations or warnings.
      * @returns ValidationResult containing errors and warnings.

package/src/core/i18n-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-engine.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/i18n-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"i18n-engine.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/i18n-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAkBvB;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiC;IACzD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAuB;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAa;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAwB;IAE9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAwB;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0C;IAE7E;;;;;;;;;;;OAWG;gBAED,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,MAAM,GAAE,YAAiB,EACzB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;IAgDH;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAMnD;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAO9D;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAyDjC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;;;;OAKG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9C,gBAAgB;IAInB;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI1C;;;OAGG;IACH,aAAa,IAAI,SAAS,eAAe,EAAE;IAI3C;;;;;;;OAOG;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;IAQT;;;;;;;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;IAaT;;;;;;;OAOG;IACH,CAAC,CACC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IA4CT;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA8E9B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAepB;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIpD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOnC;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOxC;;;OAGG;IACH,YAAY,IAAI,SAAS,kBAAkB,EAAE;IAI7C;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;;OAGG;IAEH,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKpD;;;OAGG;IAEH,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAMrD;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACxC,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,KAAK,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,EAC5D,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAQxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,cAAc,EAC/C,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAAC,cAAc,CAAC,EAC/C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAKT;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,qBAAqB,CAAC,aAAa,EAAE,cAAc,GAAG,MAAM;IAI5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,kBAAkB,CAAC,CAAC,SAAS,cAAc,EACzC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAYT;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,CAAC,SAAS,cAAc,EAC7C,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAeT;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,aAAa,EAAE,cAAc,GAAG,OAAO;IAIxD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,iBAAiB,IAAI,SAAS;QAC5B,OAAO,EAAE,cAAc,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE;IAIH;;;OAGG;IACH,QAAQ,IAAI,gBAAgB;IAiB5B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACnB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,MAAM,CAAC,EAAE,YAAY,GACpB,UAAU;IAQb;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CACxB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,MAAM,CAAC,EAAE,YAAY,GACpB,UAAU;IAOb;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU;IAS5C;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAKzC;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAS5C;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,IAAI;CAUxB"}