@digitaldefiance/i18n-lib 1.1.2 → 1.1.4

package/README.md

@@ -936,6 +936,16 @@ Part of the DigitalBurnbag project - a secure file sharing and automated protoco
 
 ## ChangeLog
 
+### Version 1.1.4
+
+- Tue Oct 14 2025 14:21:00 GMT-0700 (Pacific Daylight Time)
+  - Removed duplicate parallel RegistryContext and focused on GlobalActiveContext
+
+### Version 1.1.3
+
+- Tue Oct 14 2025 14:00:00 GMT-0700 (Pacific Daylight Time)
+  - Added GlobalActiveContext class instead of plain object
+
 ### Version 1.1.2
 
 - Sat Oct 11 2025 19:25:00 GMT-0700 (Pacific Daylight Time)

package/dist/active-context.d.ts

@@ -1,6 +1,6 @@
-import { LanguageContext } from './types';
-import { Timezone } from './timezone';
 import { CurrencyCode } from './currency-code';
+import { Timezone } from './timezone';
+import { LanguageContextSpace } from './types';
 export interface IActiveContext<TLanguage extends string> {
     /**
      * The default language for the user facing application
@@ -17,7 +17,7 @@ export interface IActiveContext<TLanguage extends string> {
     /**
      * The default language context for the current context
      */
-    currentContext: LanguageContext;
+    currentContext: LanguageContextSpace;
     /**
      * The default timezone for the user facing application
      */

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

@@ -0,0 +1,3 @@
+export declare enum ContextErrorType {
+    InvalidContext = "InvalidContext"
+}

package/dist/context-error-type.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextErrorType = void 0;
+var ContextErrorType;
+(function (ContextErrorType) {
+    ContextErrorType["InvalidContext"] = "InvalidContext";
+})(ContextErrorType || (exports.ContextErrorType = ContextErrorType = {}));

package/dist/context-error.d.ts

@@ -0,0 +1,5 @@
+import { ContextErrorType } from './context-error-type';
+import { CoreTypedError } from './typed-error';
+export declare class ContextError extends CoreTypedError<typeof ContextErrorType> {
+    constructor(type: ContextErrorType, contextKey?: string);
+}

package/dist/context-error.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextError = void 0;
+const context_error_type_1 = require("./context-error-type");
+const core_string_key_1 = require("./core-string-key");
+const plugin_i18n_engine_1 = require("./plugin-i18n-engine");
+const typed_error_1 = require("./typed-error");
+class ContextError extends typed_error_1.CoreTypedError {
+    constructor(type, contextKey) {
+        const engine = plugin_i18n_engine_1.PluginI18nEngine.getInstance();
+        super(engine, type, {
+            [context_error_type_1.ContextErrorType.InvalidContext]: core_string_key_1.CoreStringKey.Error_InvalidContextTemplate,
+        }, undefined, { ...(contextKey && { contextKey }) });
+    }
+}
+exports.ContextError = ContextError;

package/dist/context.d.ts

@@ -1,7 +1,7 @@
 import { CurrencyCode } from './currency-code';
 import { I18nContext } from './i18n-context';
 import { Timezone } from './timezone';
-import { LanguageContext } from './types';
+import { LanguageContextSpace } from './types';
 /**
  * Creates a new I18n context with default values.
  * @param defaultLanguage - The default language for the context
@@ -11,34 +11,34 @@ import { LanguageContext } from './types';
  * @param defaultAdminTimezone - The default admin timezone (defaults to UTC)
  * @returns A new I18nContext instance
  */
-export declare function createContext<TLanguage extends string, TTranslationContext extends string = LanguageContext, TContext extends I18nContext<TLanguage, TTranslationContext> = I18nContext<TLanguage, TTranslationContext>>(defaultLanguage: TLanguage, defaultContext: TTranslationContext, defaultCurrencyCode?: CurrencyCode, defaultTimezone?: Timezone, defaultAdminTimezone?: Timezone): TContext;
+export declare function createContext<TLanguage extends string, TTranslationContext extends string = LanguageContextSpace, TContext extends I18nContext<TLanguage, TTranslationContext> = I18nContext<TLanguage, TTranslationContext>>(defaultLanguage: TLanguage, defaultContext: TTranslationContext, defaultCurrencyCode?: CurrencyCode, defaultTimezone?: Timezone, defaultAdminTimezone?: Timezone): TContext;
 /**
  * Sets the language for the given I18n context.
  * @param context - The I18n context to modify
  * @param language - The language to set
  */
-export declare function setLanguage<TLanguage extends string, TContext extends string = LanguageContext>(context: I18nContext<TLanguage, TContext>, language: TLanguage): void;
+export declare function setLanguage<TLanguage extends string, TContext extends string = LanguageContextSpace>(context: I18nContext<TLanguage, TContext>, language: TLanguage): void;
 /**
  * Sets the admin language for the given I18n context.
  * @param context - The I18n context to modify
  * @param language - The admin language to set
  */
-export declare function setAdminLanguage<TLanguage extends string, TContext extends string = LanguageContext>(context: I18nContext<TLanguage, TContext>, language: TLanguage): void;
+export declare function setAdminLanguage<TLanguage extends string, TContext extends string = LanguageContextSpace>(context: I18nContext<TLanguage, TContext>, language: TLanguage): void;
 /**
  * Sets the current context for the given I18n context.
  * @param context - The I18n context to modify
  * @param languageContext - The language context to set
  */
-export declare function setContext<TLanguage extends string, TContext extends string = LanguageContext>(context: I18nContext<TLanguage, TContext>, languageContext: TContext): void;
+export declare function setContext<TLanguage extends string, TContext extends string = LanguageContextSpace>(context: I18nContext<TLanguage, TContext>, languageContext: TContext): void;
 /**
  * Sets the timezone for the given I18n context.
  * @param context - The I18n context to modify
  * @param timezone - The timezone to set
  */
-export declare function setTimezone<TLanguage extends string, TContext extends string = LanguageContext>(context: I18nContext<TLanguage, TContext>, timezone: Timezone): void;
+export declare function setTimezone<TLanguage extends string, TContext extends string = LanguageContextSpace>(context: I18nContext<TLanguage, TContext>, timezone: Timezone): void;
 /**
  * Sets the admin timezone for the given I18n context.
  * @param context - The I18n context to modify
  * @param timezone - The admin timezone to set
  */
-export declare function setAdminTimezone<TLanguage extends string, TContext extends string = LanguageContext>(context: I18nContext<TLanguage, TContext>, timezone: Timezone): void;
+export declare function setAdminTimezone<TLanguage extends string, TContext extends string = LanguageContextSpace>(context: I18nContext<TLanguage, TContext>, timezone: Timezone): void;

package/dist/core-i18n.js

@@ -100,6 +100,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: 'Internal server error',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: 'Validation failed',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: 'This field is required',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: 'Invalid context: {contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'Component "{componentId}" not found',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: 'Language "{language}" not found',
@@ -140,6 +141,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: 'Internal server error',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: 'Validation failed',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: 'This field is required',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: 'Invalid context: {contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'Component "{componentId}" not found',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: 'Language "{language}" not found',
@@ -180,6 +182,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: 'Erreur interne du serveur',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: 'Échec de la validation',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: 'Ce champ est obligatoire',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: 'Contexte invalide : {contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'Composant "{componentId}" non trouvé',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: 'Langue "{language}" non trouvée',
@@ -220,6 +223,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: 'Error interno del servidor',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: 'Error de validación',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: 'Este campo es obligatorio',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: 'Contexte invalide : {contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'Componente "{componentId}" no encontrado',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: 'Idioma "{language}" no encontrado',
@@ -260,6 +264,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: 'Interner Serverfehler',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: 'Validierung fehlgeschlagen',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: 'Dieses Feld ist erforderlich',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: 'Ungültiger Kontext: {contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'Komponente "{componentId}" nicht gefunden',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: 'Sprache "{language}" nicht gefunden',
@@ -300,6 +305,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: '内部服务器错误',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: '验证失败',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: '此字段为必填项',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: '无效的上下文：{contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: '未找到组件 "{componentId}"',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: '未找到语言 "{language}"',
@@ -340,6 +346,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: '内部サーバーエラー',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: '検証に失敗しました',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: 'このフィールドは必須です',
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: '無効なコンテキスト：{contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'コンポーネント "{componentId}" が見つかりません',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: '言語 "{language}" が見つかりません',
@@ -380,6 +387,7 @@ function createCoreComponentStrings() {
             [core_string_key_1.CoreStringKey.Error_InternalServer]: 'Внутрішня помилка сервера',
             [core_string_key_1.CoreStringKey.Error_ValidationFailed]: 'Перевірка не вдалася',
             [core_string_key_1.CoreStringKey.Error_RequiredField]: "Це поле є обов'язковим",
+            [core_string_key_1.CoreStringKey.Error_InvalidContextTemplate]: 'Неправильний контекст: {contextKey}',
             // Registry Error Templates
             [core_string_key_1.CoreStringKey.Error_ComponentNotFoundTemplate]: 'Компонент "{componentId}" не знайдено',
             [core_string_key_1.CoreStringKey.Error_LanguageNotFoundTemplate]: 'Мову "{language}" не знайдено',

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

@@ -23,6 +23,7 @@ export declare enum CoreStringKey {
     Error_InternalServer = "error_internalServer",
     Error_ValidationFailed = "error_validationFailed",
     Error_RequiredField = "error_requiredField",
+    Error_InvalidContextTemplate = "error_invalidContextTemplate",
     Error_ComponentNotFoundTemplate = "error_componentNotFoundTemplate",
     Error_LanguageNotFoundTemplate = "error_languageNotFoundTemplate",
     Error_StringKeyNotFoundTemplate = "error_stringKeyNotFoundTemplate",

package/dist/core-string-key.js

@@ -29,6 +29,7 @@ var CoreStringKey;
     CoreStringKey["Error_InternalServer"] = "error_internalServer";
     CoreStringKey["Error_ValidationFailed"] = "error_validationFailed";
     CoreStringKey["Error_RequiredField"] = "error_requiredField";
+    CoreStringKey["Error_InvalidContextTemplate"] = "error_invalidContextTemplate";
     // Registry Errors (templates support variables)
     CoreStringKey["Error_ComponentNotFoundTemplate"] = "error_componentNotFoundTemplate";
     CoreStringKey["Error_LanguageNotFoundTemplate"] = "error_languageNotFoundTemplate";

package/dist/enum-registry.js

@@ -33,14 +33,18 @@ class EnumTranslationRegistry {
         const translations = this.translations.get(enumObj);
         if (!translations) {
             const message = this.translateFn
-                ? this.translateFn('Error_EnumNotFoundTemplate', { enumName: this.getEnumName(enumObj) })
+                ? this.translateFn('Error_EnumNotFoundTemplate', {
+                    enumName: this.getEnumName(enumObj),
+                })
                 : `No translations found for enum: ${this.getEnumName(enumObj)}`;
             throw new Error(message);
         }
         const langTranslations = translations[language];
         if (!langTranslations) {
             const message = this.translateFn
-                ? this.translateFn('Error_EnumLanguageNotFoundTemplate', { language })
+                ? this.translateFn('Error_EnumLanguageNotFoundTemplate', {
+                    language,
+                })
                 : `No translations found for language: ${language}`;
             throw new Error(message);
         }
@@ -53,7 +57,9 @@ class EnumTranslationRegistry {
         }
         if (!result) {
             const message = this.translateFn
-                ? this.translateFn('Error_EnumValueNotFoundTemplate', { value: String(value) })
+                ? this.translateFn('Error_EnumValueNotFoundTemplate', {
+                    value: String(value),
+                })
                 : `No translation found for value: ${String(value)}`;
             throw new Error(message);
         }

package/dist/global-active-context.d.ts

@@ -0,0 +1,46 @@
+import { IActiveContext } from './active-context';
+import { CurrencyCode } from './currency-code';
+import { DefaultLanguage } from './default-config';
+import { IGlobalActiveContext } from './i-global-active-context';
+import { Timezone } from './timezone';
+import { LanguageContextSpace } from './types';
+export declare class GlobalActiveContext<TLanguage extends string, TActiveContext extends IActiveContext<TLanguage>> implements IGlobalActiveContext<TLanguage, TActiveContext> {
+    protected static _contextMap: Map<string, IActiveContext<any>>;
+    static readonly defaultContextKey = "default";
+    static readonly defaultLanguage: DefaultLanguage;
+    private static _instance;
+    static get instance(): GlobalActiveContext<any, any>;
+    static getInstance<TLanguage extends string, TActiveContext extends IActiveContext<TLanguage>>(): GlobalActiveContext<TLanguage, TActiveContext>;
+    static overrideInstance(instance: GlobalActiveContext<any, any>): void;
+    createContext(defaultLanguage: TLanguage, defaultAdminLanguage?: TLanguage, key?: string): TActiveContext;
+    getContext(key?: string): TActiveContext;
+    get context(): TActiveContext;
+    set context(ctx: TActiveContext);
+    setUserLanguage<StringLanguage extends string>(language: StringLanguage, key?: string): void;
+    get userLanguage(): TLanguage;
+    set userLanguage(lang: TLanguage);
+    setCurrencyCode<StringLanguage extends string>(code: CurrencyCode, key?: string): void;
+    get currencyCode(): CurrencyCode;
+    set currencyCode(code: CurrencyCode);
+    /**
+     * Sets the admin language for console operations
+     * @param language The language to set for admin operations
+     */
+    setAdminLanguage<StringLanguage extends string>(language: StringLanguage, key?: string): void;
+    get adminLanguage(): TLanguage;
+    set adminLanguage(lang: TLanguage);
+    /**
+     * Sets the language context for the current context
+     * @param context The language context to set
+     */
+    setLanguageContextSpace<StringLanguage extends string>(context: LanguageContextSpace, key?: string): void;
+    getLanguageContextSpace<StringLanguage extends string>(key?: string): LanguageContextSpace;
+    get languageContextSpace(): LanguageContextSpace;
+    set languageContextSpace(context: LanguageContextSpace);
+    setUserTimezone<StringLanguage extends string>(tz: Timezone, key?: string): void;
+    get userTimezone(): Timezone;
+    set userTimezone(tz: Timezone);
+    setAdminTimezone<StringLanguage extends string>(tz: Timezone, key?: string): void;
+    get adminTimezone(): Timezone;
+    set adminTimezone(tz: Timezone);
+}

package/dist/global-active-context.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalActiveContext = void 0;
+const context_error_1 = require("./context-error");
+const context_error_type_1 = require("./context-error-type");
+const currency_code_1 = require("./currency-code");
+const default_config_1 = require("./default-config");
+const timezone_1 = require("./timezone");
+const types_1 = require("./types");
+class GlobalActiveContext {
+    static get instance() {
+        if (!this._instance) {
+            this._instance = new GlobalActiveContext();
+            this._instance.createContext(this.defaultLanguage);
+        }
+        return this._instance;
+    }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new GlobalActiveContext();
+            this._instance.createContext(this.defaultLanguage);
+        }
+        return this._instance;
+    }
+    static overrideInstance(instance) {
+        this._instance = instance;
+    }
+    createContext(defaultLanguage, defaultAdminLanguage = defaultLanguage, key = GlobalActiveContext.defaultContextKey) {
+        const newContext = {
+            /**
+             * The language to use for translations in the user facing ui
+             */
+            language: defaultLanguage,
+            /**
+             * The language to use for console/admin logs
+             */
+            adminLanguage: defaultAdminLanguage,
+            currencyCode: new currency_code_1.CurrencyCode(types_1.DefaultCurrencyCode),
+            /**
+             * The current default context for language translations
+             */
+            currentContext: 'user',
+            /**
+             * The timezone for the user facing UI
+             */
+            timezone: new timezone_1.Timezone(types_1.DefaultTimezone),
+            /**
+             * The timezone for the admin console
+             */
+            adminTimezone: new timezone_1.Timezone('UTC'),
+        };
+        GlobalActiveContext._contextMap.set(key, newContext);
+        return newContext;
+    }
+    getContext(key = GlobalActiveContext.defaultContextKey) {
+        const context = GlobalActiveContext._contextMap.get(key);
+        if (context) {
+            return context;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get context() {
+        return this.getContext(GlobalActiveContext.defaultContextKey);
+    }
+    set context(ctx) {
+        GlobalActiveContext._contextMap.set(GlobalActiveContext.defaultContextKey, ctx);
+    }
+    setUserLanguage(language, key = GlobalActiveContext.defaultContextKey) {
+        const context = GlobalActiveContext._contextMap.get(key);
+        if (context) {
+            context.language = language;
+            return;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get userLanguage() {
+        return this.context.language;
+    }
+    set userLanguage(lang) {
+        this.context.language = lang;
+    }
+    setCurrencyCode(code, key = GlobalActiveContext.defaultContextKey) {
+        const context = GlobalActiveContext._contextMap.get(key);
+        if (context) {
+            context.currencyCode = code;
+            return;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get currencyCode() {
+        return this.context.currencyCode;
+    }
+    set currencyCode(code) {
+        this.context.currencyCode = code;
+    }
+    /**
+     * Sets the admin language for console operations
+     * @param language The language to set for admin operations
+     */
+    setAdminLanguage(language, key = GlobalActiveContext.defaultContextKey) {
+        const context = GlobalActiveContext._contextMap.get(key);
+        if (context) {
+            context.adminLanguage = language;
+            return;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get adminLanguage() {
+        return this.context.adminLanguage;
+    }
+    set adminLanguage(lang) {
+        this.context.adminLanguage = lang;
+    }
+    /**
+     * Sets the language context for the current context
+     * @param context The language context to set
+     */
+    setLanguageContextSpace(context, key = GlobalActiveContext.defaultContextKey) {
+        const ctx = GlobalActiveContext._contextMap.get(key);
+        if (ctx) {
+            ctx.currentContext = context;
+            return;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    getLanguageContextSpace(key = GlobalActiveContext.defaultContextKey) {
+        const ctx = GlobalActiveContext._contextMap.get(key);
+        if (ctx) {
+            return ctx.currentContext;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get languageContextSpace() {
+        return this.context.currentContext;
+    }
+    set languageContextSpace(context) {
+        this.context.currentContext = context;
+    }
+    setUserTimezone(tz, key = GlobalActiveContext.defaultContextKey) {
+        const ctx = GlobalActiveContext._contextMap.get(key);
+        if (ctx) {
+            ctx.timezone = tz;
+            return;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get userTimezone() {
+        return this.context.timezone;
+    }
+    set userTimezone(tz) {
+        this.context.timezone = tz;
+    }
+    setAdminTimezone(tz, key = GlobalActiveContext.defaultContextKey) {
+        const ctx = GlobalActiveContext._contextMap.get(key);
+        if (ctx) {
+            ctx.adminTimezone = tz;
+            return;
+        }
+        throw new context_error_1.ContextError(context_error_type_1.ContextErrorType.InvalidContext, key);
+    }
+    get adminTimezone() {
+        return this.context.adminTimezone;
+    }
+    set adminTimezone(tz) {
+        this.context.adminTimezone = tz;
+    }
+}
+exports.GlobalActiveContext = GlobalActiveContext;
+GlobalActiveContext._contextMap = new Map();
+GlobalActiveContext.defaultContextKey = 'default';
+GlobalActiveContext.defaultLanguage = default_config_1.DefaultLanguage.EnglishUS;

package/dist/i-global-active-context.d.ts

@@ -0,0 +1,22 @@
+import { IActiveContext } from './active-context';
+import { CurrencyCode } from './currency-code';
+import { Timezone } from './timezone';
+import { LanguageContextSpace } from './types';
+export interface IGlobalActiveContext<TLanguage extends string, TActiveContext extends IActiveContext<TLanguage>> {
+    context: TActiveContext;
+    userLanguage: TLanguage;
+    currencyCode: CurrencyCode;
+    adminLanguage: TLanguage;
+    languageContextSpace: LanguageContextSpace;
+    userTimezone: Timezone;
+    adminTimezone: Timezone;
+    createContext(defaultLanguage: TLanguage, defaultAdminLanguage?: TLanguage, key?: string): TActiveContext;
+    getContext(key?: string): TActiveContext;
+    setUserLanguage(language: TLanguage, key?: string): void;
+    setCurrencyCode(code: CurrencyCode, key?: string): void;
+    setAdminLanguage(language: TLanguage, key?: string): void;
+    setLanguageContextSpace(context: LanguageContextSpace, key?: string): void;
+    getLanguageContextSpace(key?: string): LanguageContextSpace;
+    setUserTimezone(tz: Timezone, key?: string): void;
+    setAdminTimezone(tz: Timezone, key?: string): void;
+}

package/dist/i-global-active-context.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/i18n-config.d.ts

@@ -1,10 +1,10 @@
 import { CurrencyCode } from './currency-code';
 import { Timezone } from './timezone';
-import { LanguageCodeCollection, LanguageContext, MasterStringsCollection } from './types';
+import { LanguageCodeCollection, LanguageContextSpace, MasterStringsCollection } from './types';
 /**
  * I18n configuration interface
  */
-export interface I18nConfig<TStringKey extends string, TLanguage extends string, TConstants extends Record<string, any> = Record<string, any>, TTranslationContext extends string = LanguageContext> {
+export interface I18nConfig<TStringKey extends string, TLanguage extends string, TConstants extends Record<string, any> = Record<string, any>, TTranslationContext extends string = LanguageContextSpace> {
     stringNames: TStringKey[];
     strings: MasterStringsCollection<TStringKey, TLanguage>;
     defaultLanguage: TLanguage;

package/dist/i18n-context.d.ts

@@ -1,10 +1,10 @@
 import { CurrencyCode } from './currency-code';
 import { Timezone } from './timezone';
-import { LanguageContext } from './types';
+import { LanguageContextSpace } from './types';
 /**
  * I18n context interface
  */
-export interface I18nContext<TLanguage extends string, TTranslationContext extends string = LanguageContext> {
+export interface I18nContext<TLanguage extends string, TTranslationContext extends string = LanguageContextSpace> {
     language: TLanguage;
     adminLanguage: TLanguage;
     currencyCode: CurrencyCode;

package/dist/i18n-engine.js

@@ -307,9 +307,11 @@ class I18nEngine {
         }
         catch { }
         // Fallback to static templates
-        const template = key.includes('MissingStringCollection') ? I18nEngine.ErrorTemplates.MissingStringCollection :
-            key.includes('MissingTranslation') ? I18nEngine.ErrorTemplates.MissingTranslation :
-                I18nEngine.ErrorTemplates.DefaultLanguageNoCollection;
+        const template = key.includes('MissingStringCollection')
+            ? I18nEngine.ErrorTemplates.MissingStringCollection
+            : key.includes('MissingTranslation')
+                ? I18nEngine.ErrorTemplates.MissingTranslation
+                : I18nEngine.ErrorTemplates.DefaultLanguageNoCollection;
         return (0, utils_1.replaceVariables)(template, vars);
     }
 }
@@ -331,6 +333,6 @@ I18nEngine.DefaultInstanceKey = 'default';
  */
 I18nEngine.ErrorTemplates = {
     MissingStringCollection: 'Missing string collection for language: {language}',
-    MissingTranslation: 'Missing translation for key \'{key}\' in language \'{language}\'',
-    DefaultLanguageNoCollection: 'Default language \'{language}\' has no string collection'
+    MissingTranslation: "Missing translation for key '{key}' in language '{language}'",
+    DefaultLanguageNoCollection: "Default language '{language}' has no string collection",
 };

package/dist/index.d.ts

@@ -3,12 +3,16 @@ export * from './component-definition';
 export * from './component-registration';
 export * from './component-registry';
 export * from './context';
+export * from './context-error';
+export * from './context-error-type';
 export * from './context-manager';
 export * from './currency';
 export * from './currency-code';
 export * from './currency-format';
 export * from './default-config';
 export * from './enum-registry';
+export * from './global-active-context';
+export * from './i-global-active-context';
 export * from './i18n-context';
 export * from './i18n-engine';
 export * from './language-definition';
@@ -25,7 +29,6 @@ export * from './core-string-key';
 export * from './language-registry';
 export * from './plugin-i18n-engine';
 export * from './registry-config';
-export * from './registry-context';
 export * from './registry-error';
 export * from './registry-error-type';
 export * from './translation-request';

package/dist/index.js

@@ -22,12 +22,16 @@ __exportStar(require("./component-definition"), exports);
 __exportStar(require("./component-registration"), exports);
 __exportStar(require("./component-registry"), exports);
 __exportStar(require("./context"), exports);
+__exportStar(require("./context-error"), exports);
+__exportStar(require("./context-error-type"), exports);
 __exportStar(require("./context-manager"), exports);
 __exportStar(require("./currency"), exports);
 __exportStar(require("./currency-code"), exports);
 __exportStar(require("./currency-format"), exports);
 __exportStar(require("./default-config"), exports);
 __exportStar(require("./enum-registry"), exports);
+__exportStar(require("./global-active-context"), exports);
+__exportStar(require("./i-global-active-context"), exports);
 __exportStar(require("./i18n-context"), exports);
 __exportStar(require("./i18n-engine"), exports);
 __exportStar(require("./language-definition"), exports);
@@ -44,7 +48,6 @@ __exportStar(require("./core-string-key"), exports);
 __exportStar(require("./language-registry"), exports);
 __exportStar(require("./plugin-i18n-engine"), exports);
 __exportStar(require("./registry-config"), exports);
-__exportStar(require("./registry-context"), exports);
 __exportStar(require("./registry-error"), exports);
 __exportStar(require("./registry-error-type"), exports);
 __exportStar(require("./translation-request"), exports);

package/dist/plugin-i18n-engine.d.ts

@@ -5,10 +5,10 @@ import { ComponentDefinition } from './component-definition';
 import { ComponentRegistration } from './component-registration';
 import { ComponentRegistry } from './component-registry';
 import { EnumTranslationRegistry } from './enum-registry';
+import { IActiveContext } from './active-context';
 import { LanguageDefinition } from './language-definition';
 import { LanguageRegistry } from './language-registry';
 import { RegistryConfig } from './registry-config';
-import { RegistryContext } from './registry-context';
 import { TranslationResponse } from './translation-response';
 import { EnumLanguageTranslation } from './types';
 /**
@@ -19,7 +19,7 @@ export declare class PluginI18nEngine<TLanguages extends string> {
     private readonly componentRegistry;
     private readonly enumRegistry;
     private readonly config;
-    private context;
+    private contextKey;
     /**
      * Static instances for semi-singleton pattern
      */
@@ -74,11 +74,15 @@ export declare class PluginI18nEngine<TLanguages extends string> {
     /**
      * Get current context
      */
-    getContext(): RegistryContext<TLanguages>;
+    getContext(): IActiveContext<TLanguages>;
     /**
      * Update context
      */
-    updateContext(updates: Partial<RegistryContext<TLanguages>>): void;
+    updateContext(updates: Partial<IActiveContext<TLanguages>>): void;
+    /**
+     * Get current language from global context
+     */
+    private getCurrentLanguage;
     /**
      * Set current language
      */

package/dist/plugin-i18n-engine.js

@@ -7,6 +7,7 @@ exports.PluginI18nEngine = void 0;
 const component_registry_1 = require("./component-registry");
 const currency_code_1 = require("./currency-code");
 const enum_registry_1 = require("./enum-registry");
+const global_active_context_1 = require("./global-active-context");
 const language_registry_1 = require("./language-registry");
 const registry_error_1 = require("./registry-error");
 const registry_error_type_1 = require("./registry-error-type");
@@ -41,14 +42,15 @@ class PluginI18nEngine {
         this.enumRegistry = new enum_registry_1.EnumTranslationRegistry(initialLanguages.map((l) => l.id), (key, vars) => this.safeTranslate('core', key, vars));
         // Register initial languages
         this.languageRegistry.registerLanguages(initialLanguages);
-        // Initialize context
-        this.context = {
-            currentLanguage: this.config.defaultLanguage,
-            fallbackLanguage: this.config.fallbackLanguage,
-            currencyCode: this.config.defaultCurrencyCode,
-            timezone: this.config.timezone,
-            adminTimezone: this.config.adminTimezone,
-        };
+        // Initialize context key for this engine instance
+        this.contextKey = PluginI18nEngine.DefaultInstanceKey;
+        // Create or get the global context for this engine
+        const globalContext = global_active_context_1.GlobalActiveContext.getInstance();
+        // Always create/update the context for this engine
+        globalContext.createContext(this.config.defaultLanguage, this.config.defaultLanguage, this.contextKey);
+        globalContext.setCurrencyCode(this.config.defaultCurrencyCode, this.contextKey);
+        globalContext.setUserTimezone(this.config.timezone, this.contextKey);
+        globalContext.setAdminTimezone(this.config.adminTimezone, this.contextKey);
         // Auto-register as default instance if none exists
         if (!PluginI18nEngine._defaultKey) {
             PluginI18nEngine._instances.set(PluginI18nEngine.DefaultInstanceKey, this);
@@ -63,6 +65,13 @@ class PluginI18nEngine {
             throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.DuplicateComponent, `I18n instance with key '${key}' already exists`, { key });
         }
         const instance = new PluginI18nEngine(initialLanguages, config);
+        instance.contextKey = key;
+        // Create context for this specific instance
+        const globalContext = global_active_context_1.GlobalActiveContext.getInstance();
+        globalContext.createContext(instance.config.defaultLanguage, instance.config.defaultLanguage, key);
+        globalContext.setCurrencyCode(instance.config.defaultCurrencyCode, key);
+        globalContext.setUserTimezone(instance.config.timezone, key);
+        globalContext.setAdminTimezone(instance.config.adminTimezone, key);
         PluginI18nEngine._instances.set(key, instance);
         if (!PluginI18nEngine._defaultKey) {
             PluginI18nEngine._defaultKey = key;
@@ -124,7 +133,7 @@ class PluginI18nEngine {
         const request = {
             componentId,
             stringKey,
-            language: language || this.context.currentLanguage,
+            language: language || this.getCurrentLanguage(),
             variables,
         };
         const response = this.componentRegistry.getTranslation(request);
@@ -146,7 +155,7 @@ class PluginI18nEngine {
      * Translate an enum value
      */
     translateEnum(enumObj, value, language) {
-        return this.enumRegistry.translate(enumObj, value, language || this.context.currentLanguage);
+        return this.enumRegistry.translate(enumObj, value, language || this.getCurrentLanguage());
     }
     /**
      * Get detailed translation response
@@ -155,7 +164,7 @@ class PluginI18nEngine {
         const request = {
             componentId,
             stringKey,
-            language: language || this.context.currentLanguage,
+            language: language || this.getCurrentLanguage(),
             variables,
         };
         return this.componentRegistry.getTranslation(request);
@@ -164,13 +173,33 @@ class PluginI18nEngine {
      * Get current context
      */
     getContext() {
-        return { ...this.context };
+        const globalContext = global_active_context_1.GlobalActiveContext.getInstance();
+        return globalContext.getContext(this.contextKey);
     }
     /**
      * Update context
      */
     updateContext(updates) {
-        this.context = { ...this.context, ...updates };
+        const globalContext = global_active_context_1.GlobalActiveContext.getInstance();
+        if (updates.language)
+            globalContext.setUserLanguage(updates.language, this.contextKey);
+        if (updates.adminLanguage)
+            globalContext.setAdminLanguage(updates.adminLanguage, this.contextKey);
+        if (updates.currencyCode)
+            globalContext.setCurrencyCode(updates.currencyCode, this.contextKey);
+        if (updates.currentContext)
+            globalContext.setLanguageContextSpace(updates.currentContext, this.contextKey);
+        if (updates.timezone)
+            globalContext.setUserTimezone(updates.timezone, this.contextKey);
+        if (updates.adminTimezone)
+            globalContext.setAdminTimezone(updates.adminTimezone, this.contextKey);
+    }
+    /**
+     * Get current language from global context
+     */
+    getCurrentLanguage() {
+        const globalContext = global_active_context_1.GlobalActiveContext.getInstance();
+        return globalContext.getContext(this.contextKey).language;
     }
     /**
      * Set current language
@@ -179,7 +208,8 @@ class PluginI18nEngine {
         if (!this.languageRegistry.hasLanguage(language)) {
             throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.LanguageNotFound, `Language '${language}' is not registered`, { language });
         }
-        this.context.currentLanguage = language;
+        const globalContext = global_active_context_1.GlobalActiveContext.getInstance();
+        globalContext.setUserLanguage(language, this.contextKey);
     }
     /**
      * Get available languages

package/dist/types.d.ts

@@ -2,13 +2,17 @@ import { ComponentDefinition } from './component-definition';
 import { ComponentRegistration } from './component-registration';
 import { LanguageDefinition } from './language-definition';
 /**
- * Standard language contexts
+ * Standard language context spaces
  */
-export type LanguageContext = 'admin' | 'user' | 'system' | 'api';
+export type LanguageContextSpace = 'admin' | 'user' | 'system' | 'api';
 /**
  * Default currency code
  */
 export declare const DefaultCurrencyCode: string;
+/**
+ * Default timezone
+ */
+export declare const DefaultTimezone: string;
 /**
  * Currency position type
  */
@@ -16,7 +20,7 @@ export type CurrencyPosition = 'prefix' | 'postfix' | 'infix';
 /**
  * Custom language context type
  */
-export type CustomLanguageContext<T extends string = LanguageContext> = T;
+export type CustomLanguageContext<T extends string = LanguageContextSpace> = T;
 /**
  * Collection of localized strings for a specific language
  */

package/dist/types.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultCurrencyCode = void 0;
+exports.DefaultTimezone = exports.DefaultCurrencyCode = void 0;
 exports.createTranslations = createTranslations;
 /**
  * Default currency code
  */
 exports.DefaultCurrencyCode = 'USD';
+/**
+ * Default timezone
+ */
+exports.DefaultTimezone = 'UTC';
 /**
  * Helper function to create typed translations for an enumeration
  */

package/dist/utils.d.ts

@@ -23,7 +23,7 @@ export declare function isValidTimezone(timezone: string): boolean;
  * @param parts - The parts to join
  * @returns The joined string key
  */
-export declare function toStringKey<TStringKey extends string>(...parts: (string)[]): TStringKey;
+export declare function toStringKey<TStringKey extends string>(...parts: string[]): TStringKey;
 /**
  * Converts an enum value to a string key by joining parts with underscores and appending the enum value.
  * @param value - The enum value

package/dist/utils.js

@@ -87,9 +87,11 @@ function toStringKeyFromEnum(value, ...parts) {
  */
 function buildReasonMap(enumObj, prefixes = [], templateKeys) {
     const map = {};
-    Object.values(enumObj).forEach(value => {
+    Object.values(enumObj).forEach((value) => {
         const baseKey = [...prefixes, value].join('_');
-        const finalKey = templateKeys?.has(value) ? baseKey + 'Template' : baseKey;
+        const finalKey = templateKeys?.has(value)
+            ? baseKey + 'Template'
+            : baseKey;
         map[value] = finalKey;
     });
     return map;
@@ -99,9 +101,11 @@ function buildReasonMap(enumObj, prefixes = [], templateKeys) {
  */
 function buildTypeSafeReasonMap(enumObj, prefixes, templateKeys) {
     const map = {};
-    Object.values(enumObj).forEach(value => {
+    Object.values(enumObj).forEach((value) => {
         const baseKey = [...prefixes, value].join('_');
-        const finalKey = templateKeys?.has(value) ? baseKey + 'Template' : baseKey;
+        const finalKey = templateKeys?.has(value)
+            ? baseKey + 'Template'
+            : baseKey;
         map[value] = finalKey;
     });
     return map;
@@ -110,7 +114,8 @@ function buildTypeSafeReasonMap(enumObj, prefixes, templateKeys) {
  * Validates that a reason map has entries for all enum values
  */
 function validateReasonMap(enumObj, reasonMap) {
-    return Object.values(enumObj).every(value => value in reasonMap && reasonMap[value] !== undefined);
+    return Object.values(enumObj).every((value) => value in reasonMap &&
+        reasonMap[value] !== undefined);
 }
 /**
  * Creates a complete reason map ensuring all enum values are covered
@@ -118,7 +123,7 @@ function validateReasonMap(enumObj, reasonMap) {
 function createCompleteReasonMap(enumObj, prefixes = [], templateKeys) {
     const map = buildReasonMap(enumObj, [...prefixes], templateKeys);
     if (!validateReasonMap(enumObj, map)) {
-        const missing = Object.values(enumObj).filter(value => !(value in map));
+        const missing = Object.values(enumObj).filter((value) => !(value in map));
         throw new Error(`Missing reason map entries for: ${missing.join(', ')}`);
     }
     return map;

package/package.json

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