@digitaldefiance/i18n-lib 1.3.9 → 1.3.10

package/README.md

@@ -2274,6 +2274,10 @@ For issues, questions, or contributions:
 
 ## ChangeLog
 
+### Version 1.3.10
+
+- Add UnifiedTranslator
+
 ### Version 1.3.9
 
 - Add more handleable/typed classes

package/dist/index.d.ts

@@ -44,6 +44,7 @@ export * from './translation-request';
 export * from './translation-response';
 export * from './translatable';
 export * from './create-translation-adapter';
+export * from './unified-translator';
 export { createCoreI18nEngine as createCoreI18n } from './core-i18n';
 export { I18nEngine as I18n } from './i18n-engine';
 export { PluginI18nEngine as PluginI18n } from './plugin-i18n-engine';

package/dist/index.js

@@ -63,6 +63,7 @@ __exportStar(require("./translation-request"), exports);
 __exportStar(require("./translation-response"), exports);
 __exportStar(require("./translatable"), exports);
 __exportStar(require("./create-translation-adapter"), exports);
+__exportStar(require("./unified-translator"), exports);
 // Re-export for convenience
 var core_i18n_1 = require("./core-i18n");
 Object.defineProperty(exports, "createCoreI18n", { enumerable: true, get: function () { return core_i18n_1.createCoreI18nEngine; } });

package/dist/unified-translator.d.ts

@@ -0,0 +1,29 @@
+import { PluginI18nEngine } from './plugin-i18n-engine';
+import { I18nEngine } from './i18n-engine';
+/**
+ * Unified translator with explicit component/engine specification
+ */
+export declare class UnifiedTranslator<TLanguage extends string = string> {
+    private sources;
+    private defaultLanguage;
+    private defaultSource?;
+    constructor(defaultLanguage: TLanguage);
+    /**
+     * Register a plugin component
+     */
+    registerPlugin(id: string, engine: PluginI18nEngine<any>, componentId: string): void;
+    /**
+     * Register a legacy engine
+     */
+    registerLegacy(id: string, engine: I18nEngine<any, any, any, any>): void;
+    /**
+     * Set default source for unqualified keys
+     */
+    setDefaultSource(id: string): void;
+    /**
+     * Translate with explicit source: 'source:key' or just 'key' (uses default)
+     */
+    translate(key: string, vars?: Record<string, string | number>, language?: TLanguage): string;
+    setLanguage(language: TLanguage): void;
+    getLanguage(): TLanguage;
+}

package/dist/unified-translator.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnifiedTranslator = void 0;
+/**
+ * Unified translator with explicit component/engine specification
+ */
+class UnifiedTranslator {
+    constructor(defaultLanguage) {
+        this.sources = new Map();
+        this.defaultLanguage = defaultLanguage;
+    }
+    /**
+     * Register a plugin component
+     */
+    registerPlugin(id, engine, componentId) {
+        this.sources.set(id, { type: 'plugin', engine, componentId });
+        if (!this.defaultSource)
+            this.defaultSource = id;
+    }
+    /**
+     * Register a legacy engine
+     */
+    registerLegacy(id, engine) {
+        this.sources.set(id, { type: 'legacy', engine });
+        if (!this.defaultSource)
+            this.defaultSource = id;
+    }
+    /**
+     * Set default source for unqualified keys
+     */
+    setDefaultSource(id) {
+        if (!this.sources.has(id)) {
+            throw new Error(`Source '${id}' not registered`);
+        }
+        this.defaultSource = id;
+    }
+    /**
+     * Translate with explicit source: 'source:key' or just 'key' (uses default)
+     */
+    translate(key, vars, language) {
+        const lang = language || this.defaultLanguage;
+        const [sourceName, actualKey] = key.includes(':')
+            ? key.split(':', 2)
+            : [this.defaultSource, key];
+        if (!sourceName)
+            return `[${key}]`;
+        const source = this.sources.get(sourceName);
+        if (!source)
+            return `[${key}]`;
+        if (source.type === 'plugin') {
+            return source.engine.safeTranslate(source.componentId, actualKey, vars, lang);
+        }
+        else {
+            return source.engine.safeTranslate(actualKey, vars, lang);
+        }
+    }
+    setLanguage(language) {
+        this.defaultLanguage = language;
+    }
+    getLanguage() {
+        return this.defaultLanguage;
+    }
+}
+exports.UnifiedTranslator = UnifiedTranslator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/i18n-lib",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "description": "Generic i18n library with enum translation support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",