@digitaldefiance/i18n-lib 1.1.1 → 1.1.3

package/README.md

@@ -721,6 +721,52 @@ yarn test enum-registry.spec.ts
 yarn test i18n-engine.spec.ts
 ```
 
+### Test Cleanup and Instance Management
+
+For proper test isolation when using the plugin-based architecture, use the cleanup utilities:
+
+```typescript
+import { PluginI18nEngine, resetAllI18nEngines } from '@digitaldefiance/i18n-lib';
+
+describe('My tests', () => {
+  beforeEach(() => {
+    // Clean up any existing instances before each test
+    PluginI18nEngine.clearAllInstances();
+  });
+
+  afterEach(() => {
+    // Or use the convenience function
+    resetAllI18nEngines();
+  });
+
+  // Or use specific cleanup methods
+  it('should manage instances', () => {
+    const engine1 = PluginI18nEngine.createInstance('app1', [englishLang]);
+    const engine2 = PluginI18nEngine.createInstance('app2', [frenchLang]);
+
+    // Check if instances exist
+    expect(PluginI18nEngine.hasInstance('app1')).toBe(true);
+    expect(PluginI18nEngine.hasInstance('app2')).toBe(true);
+
+    // Remove specific instance
+    PluginI18nEngine.removeInstance('app1');
+    expect(PluginI18nEngine.hasInstance('app1')).toBe(false);
+
+    // Clear all instances and component registrations
+    PluginI18nEngine.resetAll();
+    expect(PluginI18nEngine.hasInstance('app2')).toBe(false);
+  });
+});
+```
+
+#### Available Cleanup Methods
+
+- `PluginI18nEngine.clearAllInstances()` - Remove all engine instances
+- `PluginI18nEngine.removeInstance(key?)` - Remove specific instance by key
+- `PluginI18nEngine.hasInstance(key?)` - Check if instance exists  
+- `PluginI18nEngine.resetAll()` - Clear instances and component registrations
+- `resetAllI18nEngines()` - Convenience function that calls `resetAll()`
+
 ## Extensible Configuration
 
 The library supports layered extension across multiple libraries using TypeScript module augmentation:
@@ -890,6 +936,16 @@ Part of the DigitalBurnbag project - a secure file sharing and automated protoco
 
 ## ChangeLog
 
+### Version 1.1.3
+
+- Tuesday 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)
+  - Added cleanup mechanisms for other modules to deregister, etc.
+
 ### Version 1.1.1
 
 - Sat Oct 11 2025 17:47: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/component-registry.d.ts

@@ -61,4 +61,8 @@ export declare class ComponentRegistry<TLanguages extends string> {
      * Merge existing strings with new strings
      */
     private mergeStrings;
+    /**
+     * Clear all components and their strings (useful for testing)
+     */
+    clearAllComponents(): void;
 }

package/dist/component-registry.js

@@ -234,5 +234,12 @@ class ComponentRegistry {
         }
         return result;
     }
+    /**
+     * Clear all components and their strings (useful for testing)
+     */
+    clearAllComponents() {
+        this.components.clear();
+        this.componentStrings.clear();
+    }
 }
 exports.ComponentRegistry = ComponentRegistry;

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';
@@ -33,3 +37,8 @@ export * from './translation-response';
 export { createCoreI18nEngine as createCoreI18n } from './core-i18n';
 export { I18nEngine as I18n } from './i18n-engine';
 export { PluginI18nEngine as PluginI18n } from './plugin-i18n-engine';
+/**
+ * Reset all I18n engines and clear component registrations
+ * Useful for test cleanup
+ */
+export declare function resetAllI18nEngines(): void;

package/dist/index.js

@@ -15,18 +15,23 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PluginI18n = exports.I18n = exports.createCoreI18n = void 0;
+exports.resetAllI18nEngines = resetAllI18nEngines;
 // Legacy exports (for backwards compatibility)
 __exportStar(require("./active-context"), exports);
 __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);
@@ -55,3 +60,12 @@ var i18n_engine_1 = require("./i18n-engine");
 Object.defineProperty(exports, "I18n", { enumerable: true, get: function () { return i18n_engine_1.I18nEngine; } });
 var plugin_i18n_engine_1 = require("./plugin-i18n-engine");
 Object.defineProperty(exports, "PluginI18n", { enumerable: true, get: function () { return plugin_i18n_engine_1.PluginI18nEngine; } });
+// Testing utilities
+const plugin_i18n_engine_2 = require("./plugin-i18n-engine");
+/**
+ * Reset all I18n engines and clear component registrations
+ * Useful for test cleanup
+ */
+function resetAllI18nEngines() {
+    plugin_i18n_engine_2.PluginI18nEngine.resetAll();
+}

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

@@ -123,4 +123,25 @@ export declare class PluginI18nEngine<TLanguages extends string> {
         errors: string[];
         warnings: string[];
     };
+    /**
+     * Clear all component registrations for this instance (useful for testing)
+     */
+    clearAllComponents(): void;
+    /**
+     * Clear all named instances (useful for testing)
+     */
+    static clearAllInstances(): void;
+    /**
+     * Remove a specific named instance
+     */
+    static removeInstance(key?: string): boolean;
+    /**
+     * Check if an instance exists
+     */
+    static hasInstance(key?: string): boolean;
+    /**
+     * Reset all plugin engines and clear component registrations
+     * Useful for test cleanup
+     */
+    static resetAll(): void;
 }

package/dist/plugin-i18n-engine.js

@@ -49,6 +49,11 @@ class PluginI18nEngine {
             timezone: this.config.timezone,
             adminTimezone: this.config.adminTimezone,
         };
+        // Auto-register as default instance if none exists
+        if (!PluginI18nEngine._defaultKey) {
+            PluginI18nEngine._instances.set(PluginI18nEngine.DefaultInstanceKey, this);
+            PluginI18nEngine._defaultKey = PluginI18nEngine.DefaultInstanceKey;
+        }
     }
     /**
      * Create a new instance with a specific key
@@ -256,6 +261,50 @@ class PluginI18nEngine {
         }
         return { isValid, errors, warnings };
     }
+    /**
+     * Clear all component registrations for this instance (useful for testing)
+     */
+    clearAllComponents() {
+        this.componentRegistry.clearAllComponents();
+    }
+    /**
+     * Clear all named instances (useful for testing)
+     */
+    static clearAllInstances() {
+        PluginI18nEngine._instances.clear();
+        PluginI18nEngine._defaultKey = null;
+    }
+    /**
+     * Remove a specific named instance
+     */
+    static removeInstance(key) {
+        const instanceKey = key || PluginI18nEngine.DefaultInstanceKey;
+        const removed = PluginI18nEngine._instances.delete(instanceKey);
+        // If we removed the default instance, clear the default key
+        if (removed && PluginI18nEngine._defaultKey === instanceKey) {
+            PluginI18nEngine._defaultKey = null;
+        }
+        return removed;
+    }
+    /**
+     * Check if an instance exists
+     */
+    static hasInstance(key) {
+        const instanceKey = key || PluginI18nEngine.DefaultInstanceKey;
+        return PluginI18nEngine._instances.has(instanceKey);
+    }
+    /**
+     * Reset all plugin engines and clear component registrations
+     * Useful for test cleanup
+     */
+    static resetAll() {
+        for (const [key, engine] of PluginI18nEngine._instances) {
+            // Clear component registrations for each engine
+            engine.clearAllComponents();
+        }
+        PluginI18nEngine._instances.clear();
+        PluginI18nEngine._defaultKey = null;
+    }
 }
 exports.PluginI18nEngine = PluginI18nEngine;
 /**

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.1",
+  "version": "1.1.3",
   "description": "Generic i18n library with enum translation support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",