@digitaldefiance/i18n-lib 3.8.2 → 3.8.3

package/src/core-i18n.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Core I18n component with default languages and system strings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coreI18nEngine = exports.CoreComponentDefinition = exports.CoreI18nComponentId = void 0;
+exports.createDefaultLanguages = createDefaultLanguages;
+exports.createCoreComponentStrings = createCoreComponentStrings;
+exports.createCoreComponentRegistration = createCoreComponentRegistration;
+exports.createCoreComponentConfig = createCoreComponentConfig;
+exports.getCoreLanguageCodes = getCoreLanguageCodes;
+exports.getCoreLanguageDefinitions = getCoreLanguageDefinitions;
+exports.getCoreI18nEngine = getCoreI18nEngine;
+exports.resetCoreI18nEngine = resetCoreI18nEngine;
+exports.getCoreTranslation = getCoreTranslation;
+exports.safeCoreTranslation = safeCoreTranslation;
+const core_component_id_1 = require("./core-component-id");
+Object.defineProperty(exports, "CoreI18nComponentId", { enumerable: true, get: function () { return core_component_id_1.CoreI18nComponentId; } });
+const core_string_key_1 = require("./core-string-key");
+const i18n_engine_1 = require("./core/i18n-engine");
+const language_codes_1 = require("./language-codes");
+const strict_types_1 = require("./strict-types");
+const de_1 = require("./strings/de");
+const en_GB_1 = require("./strings/en-GB");
+const en_US_1 = require("./strings/en-US");
+const es_1 = require("./strings/es");
+const fr_1 = require("./strings/fr");
+const ja_1 = require("./strings/ja");
+const uk_1 = require("./strings/uk");
+const zh_CN_1 = require("./strings/zh-CN");
+/**
+ * Helper function to create multiple language definitions
+ */
+function createLanguageDefinitions(languages) {
+    return languages.map((lang) => ({
+        id: lang.id,
+        name: lang.name,
+        code: lang.code,
+        isDefault: lang.isDefault || false,
+    }));
+}
+/**
+ * Create default language definitions
+ */
+function createDefaultLanguages() {
+    return createLanguageDefinitions([
+        {
+            id: language_codes_1.LanguageCodes.EN_US,
+            name: 'English (US)',
+            code: 'en-US',
+            isDefault: true,
+        },
+        {
+            id: language_codes_1.LanguageCodes.EN_GB,
+            name: 'English (UK)',
+            code: 'en-GB',
+        },
+        {
+            id: language_codes_1.LanguageCodes.FR,
+            name: 'Français',
+            code: 'fr',
+        },
+        {
+            id: language_codes_1.LanguageCodes.ES,
+            name: 'Español',
+            code: 'es',
+        },
+        {
+            id: language_codes_1.LanguageCodes.DE,
+            name: 'Deutsch',
+            code: 'de',
+        },
+        {
+            id: language_codes_1.LanguageCodes.ZH_CN,
+            name: '中文 (简体)',
+            code: 'zh-CN',
+        },
+        {
+            id: language_codes_1.LanguageCodes.JA,
+            name: '日本語',
+            code: 'ja',
+        },
+        {
+            id: language_codes_1.LanguageCodes.UK,
+            name: 'Українська',
+            code: 'uk',
+        },
+    ]);
+}
+/**
+ * Core component definition
+ */
+exports.CoreComponentDefinition = {
+    id: core_component_id_1.CoreI18nComponentId,
+    name: 'Core I18n System',
+    stringKeys: Object.values(core_string_key_1.CoreStringKey),
+};
+/**
+ * Core component strings for all default languages
+ */
+function createCoreComponentStrings() {
+    return (0, strict_types_1.createCompleteComponentStrings)({
+        [language_codes_1.LanguageCodes.EN_US]: en_US_1.americanEnglishString,
+        [language_codes_1.LanguageCodes.EN_GB]: en_GB_1.BritishEnglishStrings,
+        [language_codes_1.LanguageCodes.FR]: fr_1.frenchStrings,
+        [language_codes_1.LanguageCodes.ES]: es_1.spanishStrings,
+        [language_codes_1.LanguageCodes.DE]: de_1.germanStrings,
+        [language_codes_1.LanguageCodes.ZH_CN]: zh_CN_1.mandarinStrings,
+        [language_codes_1.LanguageCodes.JA]: ja_1.japaneseStrings,
+        [language_codes_1.LanguageCodes.UK]: uk_1.ukrainianStrings,
+    });
+}
+/**
+ * Create core component registration (for PluginI18nEngine)
+ */
+function createCoreComponentRegistration() {
+    return {
+        component: exports.CoreComponentDefinition,
+        strings: createCoreComponentStrings(),
+    };
+}
+/**
+ * Create core component config (for I18nEngine)
+ */
+function createCoreComponentConfig() {
+    return {
+        id: core_component_id_1.CoreI18nComponentId,
+        strings: createCoreComponentStrings(),
+        aliases: ['CoreStringKey'],
+    };
+}
+/**
+ * Get core language codes as array (for Mongoose enums, etc.)
+ */
+function getCoreLanguageCodes() {
+    return Object.values(language_codes_1.LanguageCodes);
+}
+/**
+ * Get core language definitions
+ */
+function getCoreLanguageDefinitions() {
+    return createDefaultLanguages();
+}
+// 1.x definitions moved to core-plugin-factory.ts to break circular dependency
+// Import these from './core-plugin-factory' or from the main index
+// 2.x definitions
+//------------------------------
+/**
+ * Create Core i18n engine instance
+ * Uses i18n 2.0 pattern with runtime validation
+ * IMPORTANT: Uses 'default' as instance key so TypedHandleableError can find it
+ */
+function createInstance(config) {
+    const engine = i18n_engine_1.I18nEngine.registerIfNotExists('default', createDefaultLanguages(), config);
+    // Register core component if not already registered
+    const coreReg = createCoreComponentRegistration();
+    engine.registerIfNotExists({
+        id: coreReg.component.id,
+        strings: coreReg.strings,
+    });
+    return engine;
+}
+/**
+ * Lazy initialization with Proxy (like core-i18n.ts pattern)
+ */
+let _coreEngine;
+function getCoreI18nEngine() {
+    // Lazy initialization on first access
+    if (!_coreEngine) {
+        // Check if instance exists before creating
+        if (i18n_engine_1.I18nEngine.hasInstance('default')) {
+            _coreEngine = i18n_engine_1.I18nEngine.getInstance('default');
+        }
+        else {
+            _coreEngine = createInstance();
+        }
+        return _coreEngine;
+    }
+    // Lazy re-initialization if instance was cleared
+    if (i18n_engine_1.I18nEngine.hasInstance('default')) {
+        return _coreEngine;
+    }
+    else {
+        _coreEngine = createInstance();
+        return _coreEngine;
+    }
+}
+/**
+ * Proxy for backward compatibility
+ */
+exports.coreI18nEngine = new Proxy({}, {
+    get(target, prop) {
+        return getCoreI18nEngine()[prop];
+    },
+});
+/**
+ * Reset function for tests
+ */
+function resetCoreI18nEngine() {
+    _coreEngine = undefined;
+}
+/**
+ * Helper to translate Core strings
+ */
+function getCoreTranslation(stringKey, variables, language) {
+    return getCoreI18nEngine().translate(core_component_id_1.CoreI18nComponentId, stringKey, variables, language);
+}
+/**
+ * Safe translation with fallback
+ */
+function safeCoreTranslation(stringKey, variables, language) {
+    try {
+        return getCoreTranslation(stringKey, variables, language);
+    }
+    catch {
+        return `[${stringKey}]`;
+    }
+}
+//# sourceMappingURL=core-i18n.js.map

package/src/core-i18n.js.map

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

package/src/core-plugin-factory.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Factory for creating core plugin I18n engine instances
+ * This file breaks the circular dependency between core-i18n.ts and plugin-i18n-engine.ts
+ */
+import { PluginI18nEngine } from './plugin-i18n-engine';
+import { RegistryConfig } from './registry-config';
+/**
+ * Create a pre-configured I18n engine with core components
+ * Returns engine with string type - use registry for language validation
+ */
+export declare function createCorePluginI18nEngine(instanceKey?: string, config?: Partial<RegistryConfig<string>>): PluginI18nEngine<string>;
+export declare function getCorePluginI18nEngine(): PluginI18nEngine<string>;
+export declare const corePluginI18nEngine: PluginI18nEngine<string>;
+export declare function resetCorePluginI18nEngine(): void;
+/**
+ * Type alias for easier usage
+ */
+export type CorePluginI18nEngine = PluginI18nEngine<string>;
+/**
+ * Helper function to get core translation
+ * Uses the core engine instance to ensure core strings are available
+ */
+export declare function getCorePluginTranslation(stringKey: string, variables?: Record<string, string | number>, language?: string, instanceKey?: string): string;
+/**
+ * Helper function to safely get core translation with fallback
+ */
+export declare function safeCorePluginTranslation(stringKey: string, variables?: Record<string, string | number>, language?: string, instanceKey?: string): string;
+//# sourceMappingURL=core-plugin-factory.d.ts.map

package/src/core-plugin-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-plugin-factory.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-plugin-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,GAAE,MAA2B,EACxC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GACvC,gBAAgB,CAAC,MAAM,CAAC,CAS1B;AAMD,wBAAgB,uBAAuB,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAelE;AAGD,eAAO,MAAM,oBAAoB,0BAK/B,CAAC;AAGH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAWR"}

package/src/core-plugin-factory.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Factory for creating core plugin I18n engine instances
+ * This file breaks the circular dependency between core-i18n.ts and plugin-i18n-engine.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.corePluginI18nEngine = void 0;
+exports.createCorePluginI18nEngine = createCorePluginI18nEngine;
+exports.getCorePluginI18nEngine = getCorePluginI18nEngine;
+exports.resetCorePluginI18nEngine = resetCorePluginI18nEngine;
+exports.getCorePluginTranslation = getCorePluginTranslation;
+exports.safeCorePluginTranslation = safeCorePluginTranslation;
+const core_i18n_1 = require("./core-i18n");
+const plugin_i18n_engine_1 = require("./plugin-i18n-engine");
+const DefaultInstanceKey = 'default';
+/**
+ * Create a pre-configured I18n engine with core components
+ * Returns engine with string type - use registry for language validation
+ */
+function createCorePluginI18nEngine(instanceKey = DefaultInstanceKey, config) {
+    const languages = (0, core_i18n_1.createDefaultLanguages)();
+    const engine = plugin_i18n_engine_1.PluginI18nEngine.createInstance(instanceKey, languages, config);
+    engine.registerComponent((0, core_i18n_1.createCoreComponentRegistration)());
+    return engine;
+}
+// Note: Lazy initialization to avoid circular dependency issues
+// Tests should call resetCorePluginI18nEngine() after PluginI18nEngine.resetAll()
+let _corePluginI18nEngine;
+function getCorePluginI18nEngine() {
+    // Lazy initialization on first access
+    if (!_corePluginI18nEngine) {
+        _corePluginI18nEngine = createCorePluginI18nEngine();
+        return _corePluginI18nEngine;
+    }
+    // Lazy re-initialization if instance was cleared
+    try {
+        plugin_i18n_engine_1.PluginI18nEngine.getInstance(DefaultInstanceKey);
+        return _corePluginI18nEngine;
+    }
+    catch {
+        _corePluginI18nEngine = createCorePluginI18nEngine();
+        return _corePluginI18nEngine;
+    }
+}
+// Getter for direct reference - lazily initialized
+exports.corePluginI18nEngine = new Proxy({}, {
+    get(_target, prop) {
+        const engine = getCorePluginI18nEngine();
+        return engine[prop];
+    },
+});
+// Reset function for tests
+function resetCorePluginI18nEngine() {
+    _corePluginI18nEngine = undefined;
+}
+/**
+ * Helper function to get core translation
+ * Uses the core engine instance to ensure core strings are available
+ */
+function getCorePluginTranslation(stringKey, variables, language, instanceKey) {
+    // Use string literal to avoid circular dependency
+    const coreComponentId = 'core';
+    // Use core engine if no instance key specified, otherwise use specified instance
+    const engine = instanceKey
+        ? plugin_i18n_engine_1.PluginI18nEngine.getInstance(instanceKey)
+        : getCorePluginI18nEngine();
+    return engine.translate(coreComponentId, stringKey, variables, language);
+}
+/**
+ * Helper function to safely get core translation with fallback
+ */
+function safeCorePluginTranslation(stringKey, variables, language, instanceKey) {
+    try {
+        return getCorePluginTranslation(stringKey, variables, language, instanceKey);
+    }
+    catch {
+        return `[CoreStringKey.${stringKey}]`;
+    }
+}
+//# sourceMappingURL=core-plugin-factory.js.map

package/src/core-plugin-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-plugin-factory.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-plugin-factory.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAeH,gEAYC;AAMD,0DAeC;AAWD,8DAEC;AAWD,4DAcC;AAKD,8DAgBC;AAzGD,2CAGqB;AACrB,6DAAwD;AAGxD,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,SAAgB,0BAA0B,CACxC,cAAsB,kBAAkB,EACxC,MAAwC;IAExC,MAAM,SAAS,GAAG,IAAA,kCAAsB,GAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,qCAAgB,CAAC,cAAc,CAC5C,WAAW,EACX,SAAS,EACT,MAAM,CACP,CAAC;IACF,MAAM,CAAC,iBAAiB,CAAC,IAAA,2CAA+B,GAAE,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gEAAgE;AAChE,kFAAkF;AAClF,IAAI,qBAA2D,CAAC;AAEhE,SAAgB,uBAAuB;IACrC,sCAAsC;IACtC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,qBAAqB,GAAG,0BAA0B,EAAE,CAAC;QACrD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC;QACH,qCAAgB,CAAC,WAAW,CAAS,kBAAkB,CAAC,CAAC;QACzD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB,GAAG,0BAA0B,EAAE,CAAC;QACrD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,mDAAmD;AACtC,QAAA,oBAAoB,GAAG,IAAI,KAAK,CAAC,EAA8B,EAAE;IAC5E,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,IAAsC,CAAC,CAAC;IACxD,CAAC;CACF,CAAC,CAAC;AAEH,2BAA2B;AAC3B,SAAgB,yBAAyB;IACvC,qBAAqB,GAAG,SAAS,CAAC;AACpC,CAAC;AAOD;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,SAAiB,EACjB,SAA2C,EAC3C,QAAiB,EACjB,WAAoB;IAEpB,kDAAkD;IAClD,MAAM,eAAe,GAAG,MAAM,CAAC;IAE/B,iFAAiF;IACjF,MAAM,MAAM,GAAG,WAAW;QACxB,CAAC,CAAC,qCAAgB,CAAC,WAAW,CAAS,WAAW,CAAC;QACnD,CAAC,CAAC,uBAAuB,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CACvC,SAAiB,EACjB,SAA2C,EAC3C,QAAiB,EACjB,WAAoB;IAEpB,IAAI,CAAC;QACH,OAAO,wBAAwB,CAC7B,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,CACZ,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,SAAS,GAAG,CAAC;IACxC,CAAC;AACH,CAAC"}

package/src/core-string-key.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Core system string keys
+ */
+export declare enum CoreStringKey {
+    Common_Yes = "common_yes",
+    Common_No = "common_no",
+    Common_Cancel = "common_cancel",
+    Common_OK = "common_ok",
+    Common_Save = "common_save",
+    Common_Delete = "common_delete",
+    Common_Edit = "common_edit",
+    Common_Create = "common_create",
+    Common_Update = "common_update",
+    Common_Loading = "common_loading",
+    Common_Error = "common_error",
+    Common_Success = "common_success",
+    Common_Warning = "common_warning",
+    Common_Info = "common_info",
+    Common_Disposed = "common_disposed",
+    Common_Test = "common_test",
+    Error_InvalidInput = "error_invalidInput",
+    Error_NetworkError = "error_networkError",
+    Error_NotFound = "error_notFound",
+    Error_AccessDenied = "error_accessDenied",
+    Error_InternalServer = "error_internalServer",
+    Error_ValidationFailed = "error_validationFailed",
+    Error_RequiredField = "error_requiredField",
+    Error_InvalidContext = "error_invalidContext",
+    Error_InvalidContextTemplate = "error_invalidContextTemplate",
+    Error_InvalidCurrencyCodeTemplate = "error_invalidCurrencyCodeTemplate",
+    Error_ComponentNotFoundTemplate = "error_componentNotFoundTemplate",
+    Error_LanguageNotFoundTemplate = "error_languageNotFoundTemplate",
+    Error_StringKeyNotFoundTemplate = "error_stringKeyNotFoundTemplate",
+    Error_IncompleteRegistrationTemplate = "error_incompleteRegistrationTemplate",
+    Error_DuplicateComponentTemplate = "error_duplicateComponentTemplate",
+    Error_DuplicateLanguageTemplate = "error_duplicateLanguageTemplate",
+    Error_ValidationFailedTemplate = "error_validationFailedTemplate",
+    Error_MissingTranslationKeyTemplate = "error_missingTranslationKeyTemplate",
+    System_Welcome = "system_welcome",
+    System_Goodbye = "system_goodbye",
+    System_PleaseWait = "system_pleaseWait",
+    System_ProcessingRequest = "system_processingRequest",
+    System_OperationComplete = "system_operationComplete",
+    System_NoDataAvailable = "system_noDataAvailable",
+    Error_InstanceAlreadyExistsTemplate = "error_instanceAlreadyExistsTemplate",
+    Error_InstanceNotFoundTemplate = "error_instanceNotFoundTemplate",
+    Error_MissingStringCollectionTemplate = "error_missingStringCollectionTemplate",
+    Error_MissingTranslationTemplate = "error_missingTranslationTemplate",
+    Error_DefaultLanguageNoCollectionTemplate = "error_defaultLanguageNoCollectionTemplate",
+    Error_MissingTranslationKeyForTypeTemplate = "error_missingTranslationKeyForTypeTemplate"
+}
+//# sourceMappingURL=core-string-key.d.ts.map

package/src/core-string-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-string-key.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-string-key.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IAEvB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAE3B,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,4BAA4B,iCAAiC;IAC7D,iCAAiC,sCAAsC;IAGvE,+BAA+B,oCAAoC;IACnE,8BAA8B,mCAAmC;IACjE,+BAA+B,oCAAoC;IACnE,oCAAoC,yCAAyC;IAC7E,gCAAgC,qCAAqC;IACrE,+BAA+B,oCAAoC;IACnE,8BAA8B,mCAAmC;IACjE,mCAAmC,wCAAwC;IAG3E,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,wBAAwB,6BAA6B;IACrD,wBAAwB,6BAA6B;IACrD,sBAAsB,2BAA2B;IAGjD,mCAAmC,wCAAwC;IAC3E,8BAA8B,mCAAmC;IACjE,qCAAqC,0CAA0C;IAC/E,gCAAgC,qCAAqC;IACrE,yCAAyC,8CAA8C;IACvF,0CAA0C,+CAA+C;CAC1F"}

package/src/core-string-key.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreStringKey = void 0;
+/**
+ * Core system string keys
+ */
+var CoreStringKey;
+(function (CoreStringKey) {
+    // Common/General
+    CoreStringKey["Common_Yes"] = "common_yes";
+    CoreStringKey["Common_No"] = "common_no";
+    CoreStringKey["Common_Cancel"] = "common_cancel";
+    CoreStringKey["Common_OK"] = "common_ok";
+    CoreStringKey["Common_Save"] = "common_save";
+    CoreStringKey["Common_Delete"] = "common_delete";
+    CoreStringKey["Common_Edit"] = "common_edit";
+    CoreStringKey["Common_Create"] = "common_create";
+    CoreStringKey["Common_Update"] = "common_update";
+    CoreStringKey["Common_Loading"] = "common_loading";
+    CoreStringKey["Common_Error"] = "common_error";
+    CoreStringKey["Common_Success"] = "common_success";
+    CoreStringKey["Common_Warning"] = "common_warning";
+    CoreStringKey["Common_Info"] = "common_info";
+    CoreStringKey["Common_Disposed"] = "common_disposed";
+    CoreStringKey["Common_Test"] = "common_test";
+    // Error Messages
+    CoreStringKey["Error_InvalidInput"] = "error_invalidInput";
+    CoreStringKey["Error_NetworkError"] = "error_networkError";
+    CoreStringKey["Error_NotFound"] = "error_notFound";
+    CoreStringKey["Error_AccessDenied"] = "error_accessDenied";
+    CoreStringKey["Error_InternalServer"] = "error_internalServer";
+    CoreStringKey["Error_ValidationFailed"] = "error_validationFailed";
+    CoreStringKey["Error_RequiredField"] = "error_requiredField";
+    CoreStringKey["Error_InvalidContext"] = "error_invalidContext";
+    CoreStringKey["Error_InvalidContextTemplate"] = "error_invalidContextTemplate";
+    CoreStringKey["Error_InvalidCurrencyCodeTemplate"] = "error_invalidCurrencyCodeTemplate";
+    // Registry Errors (templates support variables)
+    CoreStringKey["Error_ComponentNotFoundTemplate"] = "error_componentNotFoundTemplate";
+    CoreStringKey["Error_LanguageNotFoundTemplate"] = "error_languageNotFoundTemplate";
+    CoreStringKey["Error_StringKeyNotFoundTemplate"] = "error_stringKeyNotFoundTemplate";
+    CoreStringKey["Error_IncompleteRegistrationTemplate"] = "error_incompleteRegistrationTemplate";
+    CoreStringKey["Error_DuplicateComponentTemplate"] = "error_duplicateComponentTemplate";
+    CoreStringKey["Error_DuplicateLanguageTemplate"] = "error_duplicateLanguageTemplate";
+    CoreStringKey["Error_ValidationFailedTemplate"] = "error_validationFailedTemplate";
+    CoreStringKey["Error_MissingTranslationKeyTemplate"] = "error_missingTranslationKeyTemplate";
+    // System Messages
+    CoreStringKey["System_Welcome"] = "system_welcome";
+    CoreStringKey["System_Goodbye"] = "system_goodbye";
+    CoreStringKey["System_PleaseWait"] = "system_pleaseWait";
+    CoreStringKey["System_ProcessingRequest"] = "system_processingRequest";
+    CoreStringKey["System_OperationComplete"] = "system_operationComplete";
+    CoreStringKey["System_NoDataAvailable"] = "system_noDataAvailable";
+    // DefaultStringKey
+    CoreStringKey["Error_InstanceAlreadyExistsTemplate"] = "error_instanceAlreadyExistsTemplate";
+    CoreStringKey["Error_InstanceNotFoundTemplate"] = "error_instanceNotFoundTemplate";
+    CoreStringKey["Error_MissingStringCollectionTemplate"] = "error_missingStringCollectionTemplate";
+    CoreStringKey["Error_MissingTranslationTemplate"] = "error_missingTranslationTemplate";
+    CoreStringKey["Error_DefaultLanguageNoCollectionTemplate"] = "error_defaultLanguageNoCollectionTemplate";
+    CoreStringKey["Error_MissingTranslationKeyForTypeTemplate"] = "error_missingTranslationKeyForTypeTemplate";
+})(CoreStringKey || (exports.CoreStringKey = CoreStringKey = {}));
+//# sourceMappingURL=core-string-key.js.map

package/src/core-string-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-string-key.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-string-key.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,aAuDX;AAvDD,WAAY,aAAa;IACvB,iBAAiB;IACjB,0CAAyB,CAAA;IACzB,wCAAuB,CAAA;IACvB,gDAA+B,CAAA;IAC/B,wCAAuB,CAAA;IACvB,4CAA2B,CAAA;IAC3B,gDAA+B,CAAA;IAC/B,4CAA2B,CAAA;IAC3B,gDAA+B,CAAA;IAC/B,gDAA+B,CAAA;IAC/B,kDAAiC,CAAA;IACjC,8CAA6B,CAAA;IAC7B,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,4CAA2B,CAAA;IAC3B,oDAAmC,CAAA;IACnC,4CAA2B,CAAA;IAC3B,iBAAiB;IACjB,0DAAyC,CAAA;IACzC,0DAAyC,CAAA;IACzC,kDAAiC,CAAA;IACjC,0DAAyC,CAAA;IACzC,8DAA6C,CAAA;IAC7C,kEAAiD,CAAA;IACjD,4DAA2C,CAAA;IAC3C,8DAA6C,CAAA;IAC7C,8EAA6D,CAAA;IAC7D,wFAAuE,CAAA;IAEvE,gDAAgD;IAChD,oFAAmE,CAAA;IACnE,kFAAiE,CAAA;IACjE,oFAAmE,CAAA;IACnE,8FAA6E,CAAA;IAC7E,sFAAqE,CAAA;IACrE,oFAAmE,CAAA;IACnE,kFAAiE,CAAA;IACjE,4FAA2E,CAAA;IAE3E,kBAAkB;IAClB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,wDAAuC,CAAA;IACvC,sEAAqD,CAAA;IACrD,sEAAqD,CAAA;IACrD,kEAAiD,CAAA;IAEjD,mBAAmB;IACnB,4FAA2E,CAAA;IAC3E,kFAAiE,CAAA;IACjE,gGAA+E,CAAA;IAC/E,sFAAqE,CAAA;IACrE,wGAAuF,CAAA;IACvF,0GAAyF,CAAA;AAC3F,CAAC,EAvDW,aAAa,6BAAb,aAAa,QAuDxB"}

package/src/create-translation-adapter.d.ts

@@ -0,0 +1,33 @@
+import { PluginI18nEngine } from './plugin-i18n-engine';
+import { TranslationEngine } from './translation-engine';
+/**
+ * Creates a TranslationEngine adapter from a PluginI18nEngine for a specific component.
+ * This allows PluginI18nEngine to be used where TranslationEngine interface is expected.
+ *
+ * The adapter supports both calling conventions:
+ * - Full TranslationEngine interface: `translate(componentId, key, vars, lang)`
+ * - Simplified interface: `translate(key, vars, lang)` (componentId is bound)
+ *
+ * @param pluginEngine - The PluginI18nEngine instance to wrap
+ * @param componentId - The component ID to use for translations
+ * @returns A TranslationEngine that delegates to the PluginI18nEngine
+ *
+ * @example
+ * ```typescript
+ * const pluginEngine = getMyPluginI18nEngine();
+ * const adapter = createTranslationAdapter(pluginEngine, 'my-component');
+ *
+ * // Simplified interface (componentId is bound)
+ * const text1 = adapter.translate('key');
+ * const text2 = adapter.translate('key', { var: 'value' });
+ * const text3 = adapter.translate('key', { var: 'value' }, 'fr');
+ *
+ * // Full TranslationEngine interface
+ * const text4 = adapter.translate('other-component', 'key', { var: 'value' }, 'fr');
+ * ```
+ */
+export declare function createTranslationAdapter<TStringKey extends string, TLanguage extends string>(pluginEngine: PluginI18nEngine<TLanguage>, componentId: string): TranslationEngine<TStringKey> & {
+    translate(key: TStringKey, vars?: Record<string, string | number>, lang?: TLanguage): string;
+    safeTranslate(key: TStringKey, vars?: Record<string, string | number>, lang?: TLanguage): string;
+};
+//# sourceMappingURL=create-translation-adapter.d.ts.map

package/src/create-translation-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-translation-adapter.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/create-translation-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM,EAExB,YAAY,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACzC,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAAC,UAAU,CAAC,GAAG;IACjC,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7F,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAClG,CAsDA"}

package/src/create-translation-adapter.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTranslationAdapter = createTranslationAdapter;
+/**
+ * Creates a TranslationEngine adapter from a PluginI18nEngine for a specific component.
+ * This allows PluginI18nEngine to be used where TranslationEngine interface is expected.
+ *
+ * The adapter supports both calling conventions:
+ * - Full TranslationEngine interface: `translate(componentId, key, vars, lang)`
+ * - Simplified interface: `translate(key, vars, lang)` (componentId is bound)
+ *
+ * @param pluginEngine - The PluginI18nEngine instance to wrap
+ * @param componentId - The component ID to use for translations
+ * @returns A TranslationEngine that delegates to the PluginI18nEngine
+ *
+ * @example
+ * ```typescript
+ * const pluginEngine = getMyPluginI18nEngine();
+ * const adapter = createTranslationAdapter(pluginEngine, 'my-component');
+ *
+ * // Simplified interface (componentId is bound)
+ * const text1 = adapter.translate('key');
+ * const text2 = adapter.translate('key', { var: 'value' });
+ * const text3 = adapter.translate('key', { var: 'value' }, 'fr');
+ *
+ * // Full TranslationEngine interface
+ * const text4 = adapter.translate('other-component', 'key', { var: 'value' }, 'fr');
+ * ```
+ */
+function createTranslationAdapter(pluginEngine, componentId) {
+    const adapter = {
+        translate: (keyOrComponentId, varsOrKey, langOrVars, maybeLang) => {
+            let actualKey;
+            let actualVars;
+            let actualLang;
+            if (arguments.length >= 4 || (typeof varsOrKey === 'string')) {
+                actualKey = varsOrKey;
+                actualVars = langOrVars;
+                actualLang = maybeLang;
+            }
+            else {
+                actualKey = keyOrComponentId;
+                actualVars = varsOrKey;
+                actualLang = langOrVars;
+            }
+            try {
+                return pluginEngine.translate(componentId, actualKey, actualVars, actualLang);
+            }
+            catch (error) {
+                return String(actualKey);
+            }
+        },
+        safeTranslate: (keyOrComponentId, varsOrKey, langOrVars, maybeLang) => {
+            let actualKey;
+            let actualVars;
+            let actualLang;
+            if (arguments.length >= 4 || (typeof varsOrKey === 'string')) {
+                actualKey = varsOrKey;
+                actualVars = langOrVars;
+                actualLang = maybeLang;
+            }
+            else {
+                actualKey = keyOrComponentId;
+                actualVars = varsOrKey;
+                actualLang = langOrVars;
+            }
+            return pluginEngine.safeTranslate(componentId, actualKey, actualVars, actualLang);
+        },
+    };
+    return adapter;
+}
+//# sourceMappingURL=create-translation-adapter.js.map

package/src/create-translation-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-translation-adapter.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/create-translation-adapter.ts"],"names":[],"mappings":";;AA6BA,4DA+DC;AAzFD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,wBAAwB,CAItC,YAAyC,EACzC,WAAmB;IAKnB,MAAM,OAAO,GAAQ;QACnB,SAAS,EAAE,CACT,gBAAqC,EACrC,SAAwD,EACxD,UAAwD,EACxD,SAAqB,EACb,EAAE;YACV,IAAI,SAAqB,CAAC;YAC1B,IAAI,UAAuD,CAAC;YAC5D,IAAI,UAAiC,CAAC;YAEtC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC7D,SAAS,GAAG,SAAuB,CAAC;gBACpC,UAAU,GAAG,UAAyD,CAAC;gBACvE,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,gBAA8B,CAAC;gBAC3C,UAAU,GAAG,SAAwD,CAAC;gBACtE,UAAU,GAAG,UAAmC,CAAC;YACnD,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;YAChF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,aAAa,EAAE,CACb,gBAAqC,EACrC,SAAwD,EACxD,UAAwD,EACxD,SAAqB,EACb,EAAE;YACV,IAAI,SAAqB,CAAC;YAC1B,IAAI,UAAuD,CAAC;YAC5D,IAAI,UAAiC,CAAC;YAEtC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC7D,SAAS,GAAG,SAAuB,CAAC;gBACpC,UAAU,GAAG,UAAyD,CAAC;gBACvE,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,gBAA8B,CAAC;gBAC3C,UAAU,GAAG,SAAwD,CAAC;gBACtE,UAAU,GAAG,UAAmC,CAAC;YACnD,CAAC;YAED,OAAO,YAAY,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/enum-registry.d.ts

@@ -0,0 +1,65 @@
+import { EnumLanguageTranslation } from './types';
+/**
+ * Registry for managing translations of enum values across multiple languages.
+ *
+ * @template TStringKey Type of translation key used in error messages.
+ * @template TLanguage Type of supported language codes.
+ */
+export declare class EnumTranslationRegistry<TStringKey extends string, TLanguage extends string> {
+    protected translations: Map<any, Partial<{ [L in TLanguage]: import("./types").EnumTranslation<any>; }>>;
+    protected enumNames: WeakMap<any, string>;
+    protected availableLanguages: Set<TLanguage>;
+    protected translateFn?: (key: TStringKey, vars?: Record<string, any>) => string;
+    /**
+     * Creates a new EnumTranslationRegistry.
+     *
+     * @param availableLanguages Array of supported language codes.
+     * @param translateFn Optional translation function for error templates.
+     */
+    constructor(availableLanguages: TLanguage[], translateFn?: (key: TStringKey, vars?: Record<string, any>) => string);
+    /**
+     * Registers an enum and its language-specific translations.
+     *
+     * @template TEnum Enum value type (string or number).
+     * @param enumObj The enum object to register.
+     * @param translations Mapping of language codes to value-to-string translations.
+     * @param enumName Human-readable name of the enum (used in errors).
+     * @throws {Error} If translations contain languages not in availableLanguages.
+     */
+    register<TEnum extends string | number>(enumObj: Record<string, TEnum>, translations: EnumLanguageTranslation<TEnum, TLanguage>, enumName: string): void;
+    /**
+     * Translates a specific enum value into the target language.
+     *
+     * @template TEnum Enum value type.
+     * @param enumObj The enum object registered previously.
+     * @param value The enum value to translate.
+     * @param language The target language code.
+     * @returns The translated string.
+     * @throws {Error} If the enum or language or value is not found.
+     */
+    translate<TEnum extends string | number>(enumObj: Record<string, TEnum>, value: TEnum, language: TLanguage): string;
+    /**
+     * Checks whether translations exist for the given enum object.
+     *
+     * @param enumObj The enum object to check.
+     * @returns True if registered, false otherwise.
+     */
+    has(enumObj: any): boolean;
+    /**
+     * Internal: Retrieves the human-readable name of the enum.
+     *
+     * @param enumObj The enum object.
+     * @returns Registered enum name or 'UnknownEnum' if not set.
+     */
+    private getEnumName;
+    /**
+     * Internal: Validates that translation entries only use available languages.
+     *
+     * @template TEnum Enum value type.
+     * @param translations Mapping of language codes to translations.
+     * @param enumName Enum name for error reporting.
+     * @throws {Error} If a translation language is not available.
+     */
+    private validateTranslations;
+}
+//# sourceMappingURL=enum-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enum-registry.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/enum-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,uBAAuB,CAClC,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,MAAM;IAExB,SAAS,CAAC,YAAY,mFAA2D;IACjF,SAAS,CAAC,SAAS,uBAA8B;IACjD,SAAS,CAAC,kBAAkB,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;IAEhF;;;;;OAKG;gBAED,kBAAkB,EAAE,SAAS,EAAE,EAC/B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM;IAMvE;;;;;;;;OAQG;IACI,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9B,YAAY,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,EACvD,QAAQ,EAAE,MAAM,GACf,IAAI;IAMP;;;;;;;;;OASG;IACI,SAAS,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,SAAS,GAClB,MAAM;IA2CT;;;;;OAKG;IACI,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CAgB7B"}