@digitaldefiance/i18n-lib 1.0.21 → 1.0.23

package/README.md

@@ -22,7 +22,7 @@ npm install @digitaldefiance/i18n-lib
 ## Quick Start
 
 ```typescript
-import { I18nEngine, I18nConfig, createContext } from '@digitaldefiance/i18n-lib';
+import { I18nEngine, I18nConfig, createContext, CurrencyCode, Timezone } from '@digitaldefiance/i18n-lib';
 
 // Define your enums
 enum MyStrings {
@@ -49,12 +49,15 @@ const config: I18nConfig<MyStrings, MyLanguages> = {
     }
   },
   defaultLanguage: MyLanguages.English,
-  defaultContext: 'user',
+  defaultTranslationContext: 'user',
+  defaultCurrencyCode: new CurrencyCode('USD'),
   languageCodes: {
     [MyLanguages.English]: 'en',
     [MyLanguages.Spanish]: 'es'
   },
-  languages: Object.values(MyLanguages)
+  languages: Object.values(MyLanguages),
+  timezone: new Timezone('UTC'),
+  adminTimezone: new Timezone('UTC')
 };
 
 // Create engine
@@ -216,7 +219,7 @@ I18nEngine.removeInstance('main');
 #### Translation Methods
 - `translate(key, vars?, language?, fallbackLanguage?)` - Translate string with optional variables
 - `translateEnum(enumObj, value, language)` - Translate enum value
-- `t(templateString, language?, ...vars)` - Process template with enum patterns
+- `t(templateString, language?, ...vars)` - Process template string with `{{EnumName.EnumKey}}` patterns
 
 #### Registration
 - `registerEnum(enumObj, translations, enumName)` - Register enum translations
@@ -266,16 +269,19 @@ type EnumLanguageTranslation<T extends string | number, TLanguage extends string
   [L in TLanguage]: EnumTranslation<T>;
 }>;
 
-interface I18nConfig<TStringKey, TLanguage, TConstants?, TContext?> {
+interface I18nConfig<TStringKey, TLanguage, TConstants?, TTranslationContext?> {
   stringNames: TStringKey[];
   strings: MasterStringsCollection<TStringKey, TLanguage>;
   defaultLanguage: TLanguage;
-  defaultContext: TContext;
+  defaultTranslationContext: TTranslationContext;
+  defaultCurrencyCode: CurrencyCode;
   languageCodes: LanguageCodeCollection<TLanguage>;
   languages: TLanguage[];
   constants?: TConstants;
   enumName?: string;
   enumObj?: Record<string, TStringKey>;
+  timezone: Timezone;
+  adminTimezone: Timezone;
 }
 ```
 

package/dist/context.d.ts

@@ -10,7 +10,7 @@ import { I18nContext, LanguageContext } from './types';
  * @param defaultAdminTimezone - The default admin timezone (defaults to UTC)
  * @returns A new I18nContext instance
  */
-export declare function createContext<TLanguage extends string, TContext extends string = LanguageContext>(defaultLanguage: TLanguage, defaultContext: TContext, defaultCurrencyCode?: CurrencyCode, defaultTimezone?: Timezone, defaultAdminTimezone?: Timezone): I18nContext<TLanguage, TContext>;
+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;
 /**
  * Sets the language for the given I18n context.
  * @param context - The I18n context to modify

package/dist/i18n-engine.d.ts

@@ -3,7 +3,7 @@ import { EnumLanguageTranslation, I18nConfig, I18nContext } from './types';
 /**
  * Internationalization engine class
  */
-export declare class I18nEngine<TStringKey extends string, TLanguage extends string, TConstants extends Record<string, any> = Record<string, any>, TContext extends string = string> {
+export declare class I18nEngine<TStringKey extends string, TLanguage extends string, TConstants extends Record<string, any> = Record<string, any>, TTranslationContext extends string = string, TContext extends I18nContext<TLanguage, TTranslationContext> = I18nContext<TLanguage, TTranslationContext>> {
     /**
      * Registry for enum translations
      */
@@ -11,7 +11,7 @@ export declare class I18nEngine<TStringKey extends string, TLanguage extends str
     /**
      * Configuration for the i18n engine
      */
-    readonly config: I18nConfig<TStringKey, TLanguage, TConstants, TContext>;
+    readonly config: I18nConfig<TStringKey, TLanguage, TConstants, TTranslationContext>;
     /**
      * Static instances for semi-singleton pattern
      */
@@ -31,14 +31,14 @@ export declare class I18nEngine<TStringKey extends string, TLanguage extends str
     /**
      * Default template processor instance
      */
-    readonly t: (key: TStringKey, vars?: Record<string, string | number>, language?: TLanguage) => string;
+    readonly t: (str: string, language?: TLanguage, ...otherVars: Record<string, string | number>[]) => string;
     /**
      * Creates a new I18nEngine instance
      * @param config The i18n configuration
      * @param key Optional instance key for the semi-singleton pattern
      * @throws Error if an instance with the same key already exists
      */
-    constructor(config: I18nConfig<TStringKey, TLanguage, TConstants, TContext>, key?: string);
+    constructor(config: I18nConfig<TStringKey, TLanguage, TConstants, TTranslationContext>, key?: string, newContext?: () => TContext);
     /**
      * Gets an instance of the I18nEngine by key. If no key is provided, the default instance is returned.
      * @param key The key of the instance to retrieve
@@ -68,12 +68,12 @@ export declare class I18nEngine<TStringKey extends string, TLanguage extends str
      * Gets the global context for translations
      * @returns The global context object
      */
-    get context(): I18nContext<TLanguage, TContext>;
+    get context(): TContext;
     /**
      * Sets the global context for translations (used if no context is provided) for this instance
      * @param context The context to set
      */
-    set context(context: Partial<I18nContext<TLanguage, TContext>>);
+    set context(context: Partial<TContext>);
     /**
      * Translates a string key into the specified language, replacing any variables as needed.
      * @param key The string key to translate

package/dist/i18n-engine.js

@@ -15,10 +15,10 @@ class I18nEngine {
      * @param key Optional instance key for the semi-singleton pattern
      * @throws Error if an instance with the same key already exists
      */
-    constructor(config, key) {
+    constructor(config, key, newContext = () => (0, context_1.createContext)(config.defaultLanguage, config.defaultTranslationContext, config.defaultCurrencyCode, config.timezone, config.adminTimezone)) {
         this.config = config;
         this.enumRegistry = new enum_registry_1.EnumTranslationRegistry();
-        this._context = (0, context_1.createContext)(config.defaultLanguage, config.defaultTranslationContext, config.defaultCurrencyCode, config.timezone, config.adminTimezone);
+        this._context = newContext();
         const instanceKey = key || I18nEngine.DefaultInstanceKey;
         if (I18nEngine._instances.has(instanceKey)) {
             const existing = I18nEngine._instances.get(instanceKey);
@@ -247,7 +247,8 @@ class I18nEngine {
         I18nEngine._instances.delete(instanceKey);
         if (I18nEngine._defaultKey === instanceKey) {
             const nextKey = I18nEngine._instances.keys().next().value;
-            I18nEngine._defaultKey = I18nEngine._instances.size > 0 && nextKey ? nextKey : null;
+            I18nEngine._defaultKey =
+                I18nEngine._instances.size > 0 && nextKey ? nextKey : null;
         }
     }
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@digitaldefiance/i18n-lib",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Generic i18n library with enum translation support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "yarn tsc",
-    "test": "yarn jest",
+    "test": "yarn jest --detectOpenHandles",
     "lint": "eslint src/**/*.ts tests/**/*.ts",
     "lint:fix": "eslint src/**/*.ts tests/**/*.ts --fix",
     "prettier:check": "prettier --check 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}'",