@digitaldefiance/i18n-lib 3.8.2 → 3.8.3

package/src/core/language-registry.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Static language registry (no generics)
+ */
+import { LanguageDefinition } from '../interfaces';
+/**
+ * Class representing a static registry for language definitions.
+ */
+export declare class LanguageRegistry {
+    private static languages;
+    private static defaultLanguageId;
+    /**
+     * Registers a new language definition.
+     * @param language - The language definition to register.
+     * @throws {I18nError} If the language ID or code is already registered.
+     */
+    static register(language: LanguageDefinition): void;
+    /**
+     * Checks if a language ID is registered.
+     * @param languageId - The language ID to check.
+     * @returns True if the language ID is registered, false otherwise.
+     */
+    static has(languageId: string): boolean;
+    /**
+     * Retrieves a language definition by its ID.
+     * @param languageId - The language ID to retrieve.
+     * @returns The language definition.
+     * @throws {I18nError} If the language ID is not found.
+     */
+    static get(languageId: string): LanguageDefinition;
+    /**
+     * Retrieves all registered language definitions.
+     * @returns An array of all language definitions.
+     */
+    static getAll(): readonly LanguageDefinition[];
+    /**
+     * Retrieves all registered language IDs.
+     * @returns An array of all language IDs.
+     */
+    static getIds(): readonly string[];
+    /**
+     * Retrieves all registered language codes.
+     * @returns An array of all language codes.
+     */
+    static getCodes(): readonly string[];
+    /**
+     * Retrieves an array of objects mapping language codes to their labels.
+     * @returns An array of objects with code and label properties.
+     */
+    static getCodeLabelMap(): {
+        code: string;
+        label: string;
+    }[];
+    /**
+     * Retrieves the default language definition.
+     * @returns The default language definition or null if none is set.
+     */
+    static getDefault(): LanguageDefinition | null;
+    /**
+     * Retrieves a language definition by its code.
+     * @param code - The language code to retrieve.
+     * @returns The language definition or undefined if not found.
+     */
+    static getByCode(code: string): LanguageDefinition | undefined;
+    /**
+     * Determines the best matching language code based on requested and user default codes.
+     * @param requestedCode - The requested language code.
+     * @param userDefaultCode - The user's default language code.
+     * @returns The best matching language code.
+     * @throws {I18nError} If no default language is configured.
+     */
+    static getMatchingCode(requestedCode?: string, userDefaultCode?: string): string;
+    /**
+     * Clears all registered languages and resets the default language.
+     */
+    static clear(): void;
+    /**
+     * Checks if a language ID is registered (V1 compatibility).
+     * @param languageId - The language ID to check.
+     * @returns True if the language ID is registered, false otherwise.
+     */
+    static hasLanguage(languageId: string): boolean;
+    /**
+     * Registers a new language definition (V1 compatibility).
+     * @param language - The language definition to register.
+     */
+    static registerLanguage(language: LanguageDefinition): void;
+    /**
+     * Registers multiple language definitions (V1 compatibility).
+     * @param languages - An array of language definitions to register.
+     */
+    static registerLanguages(languages: readonly LanguageDefinition[]): void;
+    /**
+     * Retrieves all registered language IDs (V1 compatibility).
+     * @returns An array of all language IDs.
+     */
+    static getLanguageIds(): readonly string[];
+    /**
+     * Retrieves all registered language definitions (V1 compatibility).
+     * @returns An array of all language definitions.
+     */
+    static getAllLanguages(): readonly LanguageDefinition[];
+    /**
+     * Retrieves a language definition by its code (V1 compatibility).
+     * @param code - The language code to retrieve.
+     * @returns The language definition or undefined if not found.
+     */
+    static getLanguageByCode(code: string): LanguageDefinition | undefined;
+    /**
+     * Retrieves a language definition by its ID (V1 compatibility).
+     * @param languageId - The language ID to retrieve.
+     * @returns The language definition or undefined if not found.
+     */
+    static getLanguage(languageId: string): LanguageDefinition | undefined;
+    /**
+     * Checks if a language code is registered.
+     * @param code - The language code to check.
+     * @returns True if the language code is registered, false otherwise.
+     */
+    static hasLanguageCode(code: string): boolean;
+    /**
+     * Retrieves the default language ID.
+     * @returns The default language ID or null if none is set.
+     */
+    static getDefaultLanguageId(): string | null;
+    /**
+     * Retrieves the count of registered languages.
+     * @returns The number of registered languages.
+     */
+    static getLanguageCount(): number;
+    /**
+     * Retrieves the default language definition.
+     * @returns The default language definition or null if none is set.
+     */
+    static getDefaultLanguage(): LanguageDefinition | null;
+    /**
+     * Sets the default language by its ID.
+     * @param languageId - The language ID to set as default.
+     * @throws {I18nError} If the language ID is not registered.
+     */
+    static setDefaultLanguage(languageId: string): void;
+    /**
+     * Validates that all required languages are registered.
+     * @param requiredLanguages - An array of required language IDs.
+     * @returns An object containing validation results, missing languages, and errors.
+     */
+    static validateRequiredLanguages(requiredLanguages: readonly string[]): {
+        isValid: boolean;
+        missingLanguages: readonly string[];
+        errors: readonly string[];
+    };
+    /**
+     * Retrieves a mapping of language IDs to their display names.
+     * @returns An object mapping language IDs to display names.
+     */
+    static getLanguageDisplayNames(): Record<string, string>;
+    /**
+     * Retrieves a mapping of language IDs to their codes.
+     * @returns An object mapping language IDs to language codes.
+     */
+    static getLanguageCodeMapping(): Record<string, string>;
+    /**
+     * Finds languages whose names include the given partial name (case-insensitive).
+     * @param partialName - The partial name to search for.
+     * @returns An array of matching language definitions.
+     */
+    static findLanguagesByName(partialName: string): readonly LanguageDefinition[];
+    /**
+     * Retrieves all registered language codes.
+     * @returns An array of all language codes.
+     */
+    static getLanguageCodes(): readonly string[];
+    /**
+     * Determines the best matching language code based on requested and user default codes.
+     * @param requestedCode - The requested language code.
+     * @param userDefaultCode - The user's default language code.
+     * @returns The best matching language code.
+     */
+    static getMatchingLanguageCode(requestedCode?: string, userDefaultCode?: string): string;
+}
+//# sourceMappingURL=language-registry.d.ts.map

package/src/core/language-registry.d.ts.map

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

package/src/core/language-registry.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Static language registry (no generics)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LanguageRegistry = void 0;
+const i18n_error_1 = require("../errors/i18n-error");
+/**
+ * Class representing a static registry for language definitions.
+ */
+class LanguageRegistry {
+    static languages = new Map();
+    static defaultLanguageId = null;
+    /**
+     * Registers a new language definition.
+     * @param language - The language definition to register.
+     * @throws {I18nError} If the language ID or code is already registered.
+     */
+    static register(language) {
+        if (this.languages.has(language.id)) {
+            throw i18n_error_1.I18nError.duplicateLanguage(language.id);
+        }
+        const existing = this.getByCode(language.code);
+        if (existing) {
+            throw i18n_error_1.I18nError.duplicateLanguage(language.id);
+        }
+        this.languages.set(language.id, language);
+        if (language.isDefault || !this.defaultLanguageId) {
+            this.defaultLanguageId = language.id;
+        }
+    }
+    /**
+     * Checks if a language ID is registered.
+     * @param languageId - The language ID to check.
+     * @returns True if the language ID is registered, false otherwise.
+     */
+    static has(languageId) {
+        return this.languages.has(languageId);
+    }
+    /**
+     * Retrieves a language definition by its ID.
+     * @param languageId - The language ID to retrieve.
+     * @returns The language definition.
+     * @throws {I18nError} If the language ID is not found.
+     */
+    static get(languageId) {
+        const lang = this.languages.get(languageId);
+        if (!lang) {
+            throw i18n_error_1.I18nError.languageNotFound(languageId);
+        }
+        return lang;
+    }
+    /**
+     * Retrieves all registered language definitions.
+     * @returns An array of all language definitions.
+     */
+    static getAll() {
+        return Array.from(this.languages.values());
+    }
+    /**
+     * Retrieves all registered language IDs.
+     * @returns An array of all language IDs.
+     */
+    static getIds() {
+        return Array.from(this.languages.keys());
+    }
+    /**
+     * Retrieves all registered language codes.
+     * @returns An array of all language codes.
+     */
+    static getCodes() {
+        return Array.from(this.languages.values()).map((l) => l.code);
+    }
+    /**
+     * Retrieves an array of objects mapping language codes to their labels.
+     * @returns An array of objects with code and label properties.
+     */
+    static getCodeLabelMap() {
+        return Array.from(this.languages.values()).map((l) => ({
+            code: l.code,
+            label: l.name,
+        }));
+    }
+    /**
+     * Retrieves the default language definition.
+     * @returns The default language definition or null if none is set.
+     */
+    static getDefault() {
+        if (!this.defaultLanguageId) {
+            return null;
+        }
+        return this.get(this.defaultLanguageId);
+    }
+    /**
+     * Retrieves a language definition by its code.
+     * @param code - The language code to retrieve.
+     * @returns The language definition or undefined if not found.
+     */
+    static getByCode(code) {
+        return Array.from(this.languages.values()).find((l) => l.code === code);
+    }
+    /**
+     * Determines the best matching language code based on requested and user default codes.
+     * @param requestedCode - The requested language code.
+     * @param userDefaultCode - The user's default language code.
+     * @returns The best matching language code.
+     * @throws {I18nError} If no default language is configured.
+     */
+    static getMatchingCode(requestedCode, userDefaultCode) {
+        const trimmedRequested = requestedCode?.trim();
+        const trimmedUserDefault = userDefaultCode?.trim();
+        if (trimmedRequested && this.getByCode(trimmedRequested)) {
+            return trimmedRequested;
+        }
+        if (trimmedUserDefault && this.getByCode(trimmedUserDefault)) {
+            return trimmedUserDefault;
+        }
+        const defaultLang = this.getDefault();
+        if (!defaultLang) {
+            throw i18n_error_1.I18nError.invalidConfig('No default language configured');
+        }
+        return defaultLang.code;
+    }
+    /**
+     * Clears all registered languages and resets the default language.
+     */
+    static clear() {
+        this.languages.clear();
+        this.defaultLanguageId = null;
+    }
+    // V1 compatibility methods
+    /**
+     * Checks if a language ID is registered (V1 compatibility).
+     * @param languageId - The language ID to check.
+     * @returns True if the language ID is registered, false otherwise.
+     */
+    static hasLanguage(languageId) {
+        return this.has(languageId);
+    }
+    /**
+     * Registers a new language definition (V1 compatibility).
+     * @param language - The language definition to register.
+     */
+    static registerLanguage(language) {
+        this.register(language);
+    }
+    /**
+     * Registers multiple language definitions (V1 compatibility).
+     * @param languages - An array of language definitions to register.
+     */
+    static registerLanguages(languages) {
+        languages.forEach((lang) => this.register(lang));
+    }
+    /**
+     * Retrieves all registered language IDs (V1 compatibility).
+     * @returns An array of all language IDs.
+     */
+    static getLanguageIds() {
+        return this.getIds();
+    }
+    /**
+     * Retrieves all registered language definitions (V1 compatibility).
+     * @returns An array of all language definitions.
+     */
+    static getAllLanguages() {
+        return this.getAll();
+    }
+    /**
+     * Retrieves a language definition by its code (V1 compatibility).
+     * @param code - The language code to retrieve.
+     * @returns The language definition or undefined if not found.
+     */
+    static getLanguageByCode(code) {
+        return this.getByCode(code);
+    }
+    /**
+     * Retrieves a language definition by its ID (V1 compatibility).
+     * @param languageId - The language ID to retrieve.
+     * @returns The language definition or undefined if not found.
+     */
+    static getLanguage(languageId) {
+        try {
+            return this.get(languageId);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Checks if a language code is registered.
+     * @param code - The language code to check.
+     * @returns True if the language code is registered, false otherwise.
+     */
+    static hasLanguageCode(code) {
+        return this.getByCode(code) !== undefined;
+    }
+    /**
+     * Retrieves the default language ID.
+     * @returns The default language ID or null if none is set.
+     */
+    static getDefaultLanguageId() {
+        return this.defaultLanguageId;
+    }
+    /**
+     * Retrieves the count of registered languages.
+     * @returns The number of registered languages.
+     */
+    static getLanguageCount() {
+        return this.languages.size;
+    }
+    /**
+     * Retrieves the default language definition.
+     * @returns The default language definition or null if none is set.
+     */
+    static getDefaultLanguage() {
+        return this.getDefault();
+    }
+    /**
+     * Sets the default language by its ID.
+     * @param languageId - The language ID to set as default.
+     * @throws {I18nError} If the language ID is not registered.
+     */
+    static setDefaultLanguage(languageId) {
+        if (!this.has(languageId)) {
+            throw i18n_error_1.I18nError.languageNotFound(languageId);
+        }
+        this.defaultLanguageId = languageId;
+    }
+    /**
+     * Validates that all required languages are registered.
+     * @param requiredLanguages - An array of required language IDs.
+     * @returns An object containing validation results, missing languages, and errors.
+     */
+    static validateRequiredLanguages(requiredLanguages) {
+        const missingLanguages = [];
+        const errors = [];
+        for (const languageId of requiredLanguages) {
+            if (!this.has(languageId)) {
+                missingLanguages.push(languageId);
+                errors.push(`Required language '${languageId}' is not registered`);
+            }
+        }
+        return {
+            isValid: missingLanguages.length === 0,
+            missingLanguages,
+            errors,
+        };
+    }
+    /**
+     * Retrieves a mapping of language IDs to their display names.
+     * @returns An object mapping language IDs to display names.
+     */
+    static getLanguageDisplayNames() {
+        const result = {};
+        for (const [languageId, language] of this.languages) {
+            result[languageId] = language.name;
+        }
+        return result;
+    }
+    /**
+     * Retrieves a mapping of language IDs to their codes.
+     * @returns An object mapping language IDs to language codes.
+     */
+    static getLanguageCodeMapping() {
+        const result = {};
+        for (const [languageId, language] of this.languages) {
+            result[languageId] = language.code;
+        }
+        return result;
+    }
+    /**
+     * Finds languages whose names include the given partial name (case-insensitive).
+     * @param partialName - The partial name to search for.
+     * @returns An array of matching language definitions.
+     */
+    static findLanguagesByName(partialName) {
+        const searchTerm = partialName.toLowerCase();
+        return Array.from(this.languages.values()).filter((language) => language.name.toLowerCase().includes(searchTerm));
+    }
+    /**
+     * Retrieves all registered language codes.
+     * @returns An array of all language codes.
+     */
+    static getLanguageCodes() {
+        return this.getCodes();
+    }
+    /**
+     * Determines the best matching language code based on requested and user default codes.
+     * @param requestedCode - The requested language code.
+     * @param userDefaultCode - The user's default language code.
+     * @returns The best matching language code.
+     */
+    static getMatchingLanguageCode(requestedCode, userDefaultCode) {
+        return this.getMatchingCode(requestedCode, userDefaultCode);
+    }
+}
+exports.LanguageRegistry = LanguageRegistry;
+//# sourceMappingURL=language-registry.js.map

package/src/core/language-registry.js.map

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

package/src/{core-component-id.ts → core-component-id.d.ts}

@@ -2,4 +2,5 @@
  * Core component ID constant
  * Extracted to separate file to avoid circular dependencies
  */
-export const CoreI18nComponentId = 'core';
+export declare const CoreI18nComponentId = "core";
+//# sourceMappingURL=core-component-id.d.ts.map

package/src/core-component-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-component-id.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-component-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,SAAS,CAAC"}

package/src/core-component-id.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreI18nComponentId = void 0;
+/**
+ * Core component ID constant
+ * Extracted to separate file to avoid circular dependencies
+ */
+exports.CoreI18nComponentId = 'core';
+//# sourceMappingURL=core-component-id.js.map

package/src/core-component-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-component-id.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-component-id.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC"}

package/src/core-i18n.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Core I18n component with default languages and system strings
+ */
+import { ComponentDefinition } from './component-definition';
+import { ComponentRegistration } from './component-registration';
+import { CoreI18nComponentId } from './core-component-id';
+import { CoreStringKey } from './core-string-key';
+import { I18nEngine } from './core/i18n-engine';
+import { ComponentConfig } from './interfaces';
+import { LanguageCodes } from './language-codes';
+import { LanguageDefinition } from './language-definition';
+export { CoreI18nComponentId };
+/**
+ * Core language code type - union of supported language codes
+ * Provides compile-time type safety for core languages
+ * For custom languages, extend this type or use string
+ */
+export type CoreLanguageCode = (typeof LanguageCodes)[keyof typeof LanguageCodes];
+/**
+ * Flexible language code type - use when you want runtime-only validation
+ * Alias for string to indicate it's a language code
+ */
+export type FlexibleLanguageCode = string;
+/**
+ * Create default language definitions
+ */
+export declare function createDefaultLanguages(): LanguageDefinition[];
+/**
+ * Core component definition
+ */
+export declare const CoreComponentDefinition: ComponentDefinition<CoreStringKey>;
+/**
+ * Core component strings for all default languages
+ */
+export declare function createCoreComponentStrings(): import("./strict-types").CompleteComponentLanguageStrings<CoreStringKey, string>;
+/**
+ * Create core component registration (for PluginI18nEngine)
+ */
+export declare function createCoreComponentRegistration(): ComponentRegistration<CoreStringKey, string>;
+/**
+ * Create core component config (for I18nEngine)
+ */
+export declare function createCoreComponentConfig(): ComponentConfig;
+/**
+ * Get core language codes as array (for Mongoose enums, etc.)
+ */
+export declare function getCoreLanguageCodes(): string[];
+/**
+ * Get core language definitions
+ */
+export declare function getCoreLanguageDefinitions(): LanguageDefinition[];
+export declare function getCoreI18nEngine(): I18nEngine;
+/**
+ * Proxy for backward compatibility
+ */
+export declare const coreI18nEngine: I18nEngine;
+/**
+ * Reset function for tests
+ */
+export declare function resetCoreI18nEngine(): void;
+/**
+ * Helper to translate Core strings
+ */
+export declare function getCoreTranslation(stringKey: CoreStringKey, variables?: Record<string, string | number>, language?: string): string;
+/**
+ * Safe translation with fallback
+ */
+export declare function safeCoreTranslation(stringKey: CoreStringKey, variables?: Record<string, string | number>, language?: string): string;
+//# sourceMappingURL=core-i18n.d.ts.map

package/src/core-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-i18n.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/core-i18n.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAgB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAY3D,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAqB/B;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,EAAE,CA4C7D;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,CAAC,aAAa,CAItE,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,qFAWzC;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CACtE,aAAa,EACb,MAAM,CACP,CAKA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAM3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,kBAAkB,EAAE,CAEjE;AAmCD,wBAAgB,iBAAiB,IAAI,UAAU,CAmB9C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,YAIzB,CAAC;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,aAAa,EACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR"}