@digitaldefiance/i18n-lib 1.3.11 → 1.3.13

package/dist/index.js

@@ -1,83 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-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("./handleable"), exports);
-__exportStar(require("./i-handleable"), exports);
-__exportStar(require("./i-handleable-error-options"), exports);
-__exportStar(require("./i-global-active-context"), exports);
-__exportStar(require("./i18n-config"), exports);
-__exportStar(require("./i18n-context"), exports);
-__exportStar(require("./i18n-engine"), exports);
-__exportStar(require("./language-definition"), exports);
-__exportStar(require("./template"), exports);
-__exportStar(require("./timezone"), exports);
-__exportStar(require("./plugin-translatable-generic-error"), exports);
-__exportStar(require("./typed-error"), exports);
-__exportStar(require("./typed-handleable"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./utils"), exports);
-__exportStar(require("./validation-config"), exports);
-__exportStar(require("./validation-result"), exports);
-__exportStar(require("./core-i18n"), exports);
-__exportStar(require("./core-string-key"), exports);
-__exportStar(require("./language-codes"), exports);
-__exportStar(require("./language-registry"), exports);
-__exportStar(require("./plugin-i18n-engine"), exports);
-__exportStar(require("./plugin-translatable-generic-error"), exports);
-__exportStar(require("./plugin-translatable-handleable-generic"), exports);
-__exportStar(require("./plugin-typed-handleable"), exports);
-__exportStar(require("./registry-config"), exports);
-__exportStar(require("./registry-error"), exports);
-__exportStar(require("./registry-error-type"), exports);
-__exportStar(require("./translation-engine"), exports);
-__exportStar(require("./translation-request"), exports);
-__exportStar(require("./translation-response"), exports);
-__exportStar(require("./translatable"), exports);
-__exportStar(require("./create-translation-adapter"), exports);
-__exportStar(require("./unified-translator"), exports);
-// Re-export for convenience
-var core_i18n_1 = require("./core-i18n");
-Object.defineProperty(exports, "createCoreI18n", { enumerable: true, get: function () { return core_i18n_1.createCoreI18nEngine; } });
-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/language-codes.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LanguageDisplayNames = exports.LanguageCodes = void 0;
-/**
- * Common language codes following BCP 47 standard.
- * These are provided as constants for convenience, but any string can be used as a language code.
- * Site builders can use these or define their own custom language codes.
- */
-exports.LanguageCodes = {
-    EN_US: 'en-US',
-    EN_GB: 'en-GB',
-    FR: 'fr',
-    ES: 'es',
-    DE: 'de',
-    ZH_CN: 'zh-CN',
-    JA: 'ja',
-    UK: 'uk',
-};
-/**
- * Helper to get display names for common language codes
- */
-exports.LanguageDisplayNames = {
-    [exports.LanguageCodes.EN_US]: 'English (US)',
-    [exports.LanguageCodes.EN_GB]: 'English (UK)',
-    [exports.LanguageCodes.FR]: 'Français',
-    [exports.LanguageCodes.ES]: 'Español',
-    [exports.LanguageCodes.DE]: 'Deutsch',
-    [exports.LanguageCodes.ZH_CN]: '中文',
-    [exports.LanguageCodes.JA]: '日本語',
-    [exports.LanguageCodes.UK]: 'Українська',
-};

package/dist/language-definition.d.ts

@@ -1,13 +0,0 @@
-/**
- * Language definition with its properties
- */
-export interface LanguageDefinition {
-    /** Unique identifier for the language */
-    readonly id: string;
-    /** Display name in the native language */
-    readonly name: string;
-    /** ISO language code (e.g., 'en', 'fr', 'zh-CN') */
-    readonly code: string;
-    /** Whether this is the fallback/default language */
-    readonly isDefault?: boolean;
-}

package/dist/language-definition.js

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

package/dist/language-registry.d.ts

@@ -1,113 +0,0 @@
-/**
- * Language registry for managing supported languages and their properties
- */
-import { LanguageDefinition } from './language-definition';
-/**
- * Static singleton registry for managing supported languages globally
- */
-export declare class LanguageRegistry {
-    private static languages;
-    private static languagesByCodes;
-    private static defaultLanguageId;
-    private constructor();
-    /**
-     * Register a new language
-     */
-    static registerLanguage(language: LanguageDefinition): void;
-    /**
-     * Register multiple languages at once
-     */
-    static registerLanguages(languages: readonly LanguageDefinition[]): void;
-    /**
-     * Get a language by its ID
-     */
-    static getLanguage(languageId: string): LanguageDefinition | undefined;
-    /**
-     * Get a language by its code
-     */
-    static getLanguageByCode(code: string): LanguageDefinition | undefined;
-    /**
-     * Get all registered languages
-     */
-    static getAllLanguages(): ReadonlyArray<LanguageDefinition>;
-    /**
-     * Get all language IDs
-     */
-    static getLanguageIds(): readonly string[];
-    /**
-     * Get all language codes
-     */
-    static getLanguageCodes(): readonly string[];
-    /**
-     * Check if a language is registered
-     */
-    static hasLanguage(languageId: string): boolean;
-    /**
-     * Check if a language code is registered
-     */
-    static hasLanguageCode(code: string): boolean;
-    /**
-     * Get the default language
-     */
-    static getDefaultLanguage(): LanguageDefinition | null;
-    /**
-     * Get the default language ID
-     */
-    static getDefaultLanguageId(): string | null;
-    /**
-     * Get matching language code with fallback logic:
-     * 1. Try requested code
-     * 2. Fall back to user default
-     * 3. Fall back to site default
-     */
-    static getMatchingLanguageCode(requestedCode?: string, userDefaultCode?: string): string;
-    /**
-     * Set the default language
-     */
-    static setDefaultLanguage(languageId: string): void;
-    /**
-     * Get the number of registered languages
-     */
-    static getLanguageCount(): number;
-    /**
-     * Validate that all required languages are present
-     */
-    static validateRequiredLanguages(requiredLanguages: readonly string[]): LanguageValidationResult;
-    /**
-     * Create a mapping of language IDs to their display names
-     */
-    static getLanguageDisplayNames(): Record<string, string>;
-    /**
-     * Create a mapping of language IDs to their codes
-     */
-    static getLanguageCodeMapping(): Record<string, string>;
-    /**
-     * Find languages by partial name match (case-insensitive)
-     */
-    static findLanguagesByName(partialName: string): readonly LanguageDefinition[];
-    /**
-     * Clear all registered languages (useful for testing)
-     */
-    static clear(): void;
-}
-/**
- * Validation result for language operations
- */
-export interface LanguageValidationResult {
-    readonly isValid: boolean;
-    readonly missingLanguages: readonly string[];
-    readonly errors: readonly string[];
-}
-/**
- * Helper function to create language definitions with type safety
- */
-export declare function createLanguageDefinition(id: string, name: string, code: string, isDefault?: boolean): LanguageDefinition;
-/**
- * Helper function to create multiple language definitions
- */
-export declare function createLanguageDefinitions(languages: Array<{
-    id: string;
-    name: string;
-    code: string;
-    isDefault?: boolean;
-}>): LanguageDefinition[];

package/dist/language-registry.js

@@ -1,216 +0,0 @@
-"use strict";
-/**
- * Language registry for managing supported languages and their properties
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LanguageRegistry = void 0;
-exports.createLanguageDefinition = createLanguageDefinition;
-exports.createLanguageDefinitions = createLanguageDefinitions;
-const registry_error_1 = require("./registry-error");
-const registry_error_type_1 = require("./registry-error-type");
-/**
- * Static singleton registry for managing supported languages globally
- */
-class LanguageRegistry {
-    constructor() {
-        // Private constructor - use static methods
-    }
-    /**
-     * Register a new language
-     */
-    static registerLanguage(language) {
-        const languageId = language.id;
-        // Check for duplicate language ID
-        if (LanguageRegistry.languages.has(languageId)) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.DuplicateLanguage, `Language '${languageId}' is already registered`, { languageId });
-        }
-        // Check for duplicate language code
-        if (LanguageRegistry.languagesByCodes.has(language.code)) {
-            const existingLanguageId = LanguageRegistry.languagesByCodes.get(language.code);
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.DuplicateLanguage, `Language code '${language.code}' is already used by language '${existingLanguageId}'`, { languageId, code: language.code, existingLanguageId });
-        }
-        // Register the language
-        LanguageRegistry.languages.set(languageId, language);
-        LanguageRegistry.languagesByCodes.set(language.code, languageId);
-        // Set as default if specified or if it's the first language
-        if (language.isDefault || LanguageRegistry.defaultLanguageId === null) {
-            LanguageRegistry.defaultLanguageId = languageId;
-        }
-    }
-    /**
-     * Register multiple languages at once
-     */
-    static registerLanguages(languages) {
-        for (const language of languages) {
-            LanguageRegistry.registerLanguage(language);
-        }
-    }
-    /**
-     * Get a language by its ID
-     */
-    static getLanguage(languageId) {
-        return LanguageRegistry.languages.get(languageId);
-    }
-    /**
-     * Get a language by its code
-     */
-    static getLanguageByCode(code) {
-        const languageId = LanguageRegistry.languagesByCodes.get(code);
-        return languageId ? LanguageRegistry.languages.get(languageId) : undefined;
-    }
-    /**
-     * Get all registered languages
-     */
-    static getAllLanguages() {
-        return Array.from(LanguageRegistry.languages.values());
-    }
-    /**
-     * Get all language IDs
-     */
-    static getLanguageIds() {
-        return Array.from(LanguageRegistry.languages.keys());
-    }
-    /**
-     * Get all language codes
-     */
-    static getLanguageCodes() {
-        return Array.from(LanguageRegistry.languagesByCodes.keys());
-    }
-    /**
-     * Check if a language is registered
-     */
-    static hasLanguage(languageId) {
-        return LanguageRegistry.languages.has(languageId);
-    }
-    /**
-     * Check if a language code is registered
-     */
-    static hasLanguageCode(code) {
-        return LanguageRegistry.languagesByCodes.has(code);
-    }
-    /**
-     * Get the default language
-     */
-    static getDefaultLanguage() {
-        return LanguageRegistry.defaultLanguageId
-            ? LanguageRegistry.languages.get(LanguageRegistry.defaultLanguageId) || null
-            : null;
-    }
-    /**
-     * Get the default language ID
-     */
-    static getDefaultLanguageId() {
-        return LanguageRegistry.defaultLanguageId;
-    }
-    /**
-     * Get matching language code with fallback logic:
-     * 1. Try requested code
-     * 2. Fall back to user default
-     * 3. Fall back to site default
-     */
-    static getMatchingLanguageCode(requestedCode, userDefaultCode) {
-        // Try requested code first
-        if (requestedCode && LanguageRegistry.hasLanguageCode(requestedCode)) {
-            return requestedCode;
-        }
-        // Try user default
-        if (userDefaultCode && LanguageRegistry.hasLanguageCode(userDefaultCode)) {
-            return userDefaultCode;
-        }
-        // Fall back to site default
-        const defaultLanguage = LanguageRegistry.getDefaultLanguage();
-        if (!defaultLanguage) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.LanguageNotFound, 'No default language configured', {});
-        }
-        return defaultLanguage.code;
-    }
-    /**
-     * Set the default language
-     */
-    static setDefaultLanguage(languageId) {
-        if (!LanguageRegistry.languages.has(languageId)) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.LanguageNotFound, `Language '${languageId}' not found`, { languageId });
-        }
-        LanguageRegistry.defaultLanguageId = languageId;
-    }
-    /**
-     * Get the number of registered languages
-     */
-    static getLanguageCount() {
-        return LanguageRegistry.languages.size;
-    }
-    /**
-     * Validate that all required languages are present
-     */
-    static validateRequiredLanguages(requiredLanguages) {
-        const missingLanguages = [];
-        const errors = [];
-        for (const languageId of requiredLanguages) {
-            if (!LanguageRegistry.languages.has(languageId)) {
-                missingLanguages.push(languageId);
-                errors.push(`Required language '${languageId}' is not registered`);
-            }
-        }
-        return {
-            isValid: missingLanguages.length === 0,
-            missingLanguages,
-            errors,
-        };
-    }
-    /**
-     * Create a mapping of language IDs to their display names
-     */
-    static getLanguageDisplayNames() {
-        const result = {};
-        for (const [languageId, language] of LanguageRegistry.languages) {
-            result[languageId] = language.name;
-        }
-        return result;
-    }
-    /**
-     * Create a mapping of language IDs to their codes
-     */
-    static getLanguageCodeMapping() {
-        const result = {};
-        for (const [languageId, language] of LanguageRegistry.languages) {
-            result[languageId] = language.code;
-        }
-        return result;
-    }
-    /**
-     * Find languages by partial name match (case-insensitive)
-     */
-    static findLanguagesByName(partialName) {
-        const searchTerm = partialName.toLowerCase();
-        return Array.from(LanguageRegistry.languages.values()).filter((language) => language.name.toLowerCase().includes(searchTerm));
-    }
-    /**
-     * Clear all registered languages (useful for testing)
-     */
-    static clear() {
-        LanguageRegistry.languages.clear();
-        LanguageRegistry.languagesByCodes.clear();
-        LanguageRegistry.defaultLanguageId = null;
-    }
-}
-exports.LanguageRegistry = LanguageRegistry;
-LanguageRegistry.languages = new Map();
-LanguageRegistry.languagesByCodes = new Map();
-LanguageRegistry.defaultLanguageId = null;
-/**
- * Helper function to create language definitions with type safety
- */
-function createLanguageDefinition(id, name, code, isDefault) {
-    return {
-        id,
-        name,
-        code,
-        isDefault: isDefault || false,
-    };
-}
-/**
- * Helper function to create multiple language definitions
- */
-function createLanguageDefinitions(languages) {
-    return languages.map((lang) => createLanguageDefinition(lang.id, lang.name, lang.code, lang.isDefault));
-}

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

@@ -1,146 +0,0 @@
-/**
- * Plugin-based internationalization engine with component and language registration
- */
-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 { RegistryConfig } from './registry-config';
-import { TranslationResponse } from './translation-response';
-import { EnumLanguageTranslation } from './types';
-/**
- * Plugin-based I18n Engine with registration capabilities
- */
-export declare class PluginI18nEngine<TLanguages extends string> {
-    private readonly componentRegistry;
-    private readonly enumRegistry;
-    private readonly config;
-    private contextKey;
-    /**
-     * Default template processor instance
-     */
-    readonly t: (str: string, language?: TLanguages, ...otherVars: Record<string, string | number>[]) => string;
-    /**
-     * Static instances for semi-singleton pattern
-     */
-    private static _instances;
-    private static _defaultKey;
-    protected static readonly DefaultInstanceKey = "default";
-    constructor(initialLanguages: readonly LanguageDefinition[], config?: Partial<RegistryConfig<TLanguages>>);
-    /**
-     * Create a new instance with a specific key
-     */
-    static createInstance<TLangs extends string>(key: string, initialLanguages: readonly LanguageDefinition[], config?: Partial<RegistryConfig<TLangs>>): PluginI18nEngine<TLangs>;
-    /**
-     * Get an existing instance by key
-     */
-    static getInstance<TLangs extends string>(key?: string): PluginI18nEngine<TLangs>;
-    /**
-     * Register a new language (updates static registry)
-     */
-    registerLanguage(language: LanguageDefinition): void;
-    /**
-     * Register multiple languages (updates static registry)
-     */
-    registerLanguages(languages: readonly LanguageDefinition[]): void;
-    /**
-     * Register a component with its translations
-     */
-    registerComponent<TStringKeys extends string>(registration: ComponentRegistration<TStringKeys, TLanguages>): import("./validation-result").ValidationResult;
-    /**
-     * Update strings for an existing component
-     */
-    updateComponentStrings<TStringKeys extends string>(componentId: string, strings: Parameters<ComponentRegistry<TLanguages>['updateComponentStrings']>[1]): import("./validation-result").ValidationResult;
-    /**
-     * Register an enum with translations
-     */
-    registerEnum<TEnum extends string | number>(enumObj: Record<string, TEnum>, translations: EnumLanguageTranslation<TEnum, TLanguages>, enumName: string): void;
-    /**
-     * Translate a string for a component
-     */
-    translate<TStringKeys extends string>(componentId: string, stringKey: TStringKeys, variables?: Record<string, string | number>, language?: TLanguages): string;
-    /**
-     * Safe translate that returns a placeholder if translation fails
-     */
-    safeTranslate(componentId: string, stringKey: string, variables?: Record<string, string | number>, language?: TLanguages): string;
-    /**
-     * Translate an enum value
-     */
-    translateEnum<TEnum extends string | number>(enumObj: Record<string, TEnum>, value: TEnum, language?: TLanguages): string;
-    /**
-     * Get detailed translation response
-     */
-    getTranslationDetails<TStringKeys extends string>(componentId: string, stringKey: TStringKeys, variables?: Record<string, string | number>, language?: TLanguages): TranslationResponse;
-    /**
-     * Get current context
-     */
-    getContext(): IActiveContext<TLanguages>;
-    /**
-     * Update context
-     */
-    updateContext(updates: Partial<IActiveContext<TLanguages>>): void;
-    /**
-     * Get current language from global context
-     * Respects language context space (admin vs user)
-     */
-    private getCurrentLanguage;
-    /**
-     * Set current language
-     */
-    setLanguage(language: TLanguages): void;
-    /**
-     * Get available languages from static registry
-     */
-    getLanguages(): readonly LanguageDefinition[];
-    /**
-     * Get registered components
-     */
-    getComponents(): ReadonlyArray<ComponentDefinition<any>>;
-    /**
-     * Check if a component is registered
-     */
-    hasComponent(componentId: string): boolean;
-    /**
-     * Check if a language is registered in static registry
-     */
-    hasLanguage(language: TLanguages): boolean;
-    /**
-     * Get language by code from static registry
-     */
-    getLanguageByCode(code: string): LanguageDefinition | undefined;
-    /**
-     * Get component registry for direct access
-     */
-    getComponentRegistry(): ComponentRegistry<TLanguages>;
-    /**
-     * Get enum registry for direct access
-     */
-    getEnumRegistry(): EnumTranslationRegistry<string, TLanguages>;
-    /**
-     * Validate that all components have complete translations
-     */
-    validateAllComponents(): {
-        isValid: boolean;
-        errors: string[];
-        warnings: string[];
-    };
-    /**
-     * Clear all component registrations for this instance (useful for testing)
-     */
-    clearAllComponents(): 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;
-}