@digitaldefiance/i18n-lib 3.8.2 → 3.8.3

package/src/interfaces/global-active-context.d.ts

@@ -0,0 +1,23 @@
+import type { LanguageContextSpace } from '../types';
+import type { CurrencyCode } from '../utils/currency';
+import type { Timezone } from '../utils/timezone';
+import type { IActiveContext } from './active-context.interface';
+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;
+}
+//# sourceMappingURL=global-active-context.d.ts.map

package/src/interfaces/global-active-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-active-context.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/global-active-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,oBAAoB,CACnC,SAAS,SAAS,MAAM,EACxB,cAAc,SAAS,cAAc,CAAC,SAAS,CAAC;IAEhD,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,SAAS,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,SAAS,CAAC;IACzB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,YAAY,EAAE,QAAQ,CAAC;IACvB,aAAa,EAAE,QAAQ,CAAC;IAExB,aAAa,CACX,eAAe,EAAE,SAAS,EAC1B,oBAAoB,CAAC,EAAE,SAAS,EAChC,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,CAAC;IAElB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAEzC,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzD,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1D,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3E,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAE5D,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpD"}

package/src/interfaces/global-active-context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=global-active-context.js.map

package/src/interfaces/global-active-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-active-context.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/global-active-context.ts"],"names":[],"mappings":""}

package/src/interfaces/handleable-error-options.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Options for creating a HandleableError.
+ */
+export interface HandleableErrorOptions {
+    /** The original error that caused this error */
+    cause?: Error;
+    /** Whether this error has been handled */
+    handled?: boolean;
+    /** HTTP status code associated with this error */
+    statusCode?: number;
+    /** Optional source data related to the error */
+    sourceData?: unknown;
+}
+//# sourceMappingURL=handleable-error-options.d.ts.map

package/src/interfaces/handleable-error-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleable-error-options.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/handleable-error-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/src/interfaces/handleable-error-options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=handleable-error-options.js.map

package/src/interfaces/handleable-error-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleable-error-options.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/handleable-error-options.ts"],"names":[],"mappings":""}

package/src/interfaces/handleable.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Interface for errors that can be marked as handled and serialized to JSON.
+ */
+export interface IHandleable {
+    /**
+     * Converts the error to a JSON-serializable object.
+     * @returns A plain object representation of the error
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Gets the handled state of this error.
+     * @returns True if the error has been handled, false otherwise
+     */
+    get handled(): boolean;
+    /**
+     * Sets the handled state of this error.
+     * @param value - The new handled state
+     */
+    set handled(value: boolean);
+}
+//# sourceMappingURL=handleable.d.ts.map

package/src/interfaces/handleable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/handleable.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAAC;IACvB;;;OAGG;IACH,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE;CAC7B"}

package/src/interfaces/handleable.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=handleable.js.map

package/src/interfaces/handleable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleable.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/handleable.ts"],"names":[],"mappings":""}

package/src/interfaces/i18n-engine.interface.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Core I18n Engine interface
+ */
+import { ComponentConfig } from './component-config.interface';
+import { LanguageDefinition } from './language-definition.interface';
+import { ValidationResult } from './validation-result.interface';
+/**
+ * Main interface for the I18n engine, defining all translation and management operations.
+ */
+export interface II18nEngine {
+    /** Registers a new component with its translations */
+    register(config: ComponentConfig): ValidationResult;
+    /** Registers a component only if it doesn't already exist */
+    registerIfNotExists(config: ComponentConfig): ValidationResult;
+    /** Updates strings for an existing component */
+    updateStrings(componentId: string, strings: Record<string, Record<string, string>>): ValidationResult;
+    /** Checks if a component is registered */
+    hasComponent(componentId: string): boolean;
+    /** Gets all registered components */
+    getComponents(): readonly ComponentConfig[];
+    /** Translates a string key for a component */
+    translate(componentId: string, key: string, variables?: Record<string, any>, language?: string): string;
+    /** Safely translates a string key, returning a fallback on error */
+    safeTranslate(componentId: string, key: string, variables?: Record<string, any>, language?: string): string;
+    /** Template processor that handles embedded component.key patterns */
+    t(template: string, variables?: Record<string, any>, language?: string): string;
+    /** Registers a new language */
+    registerLanguage(language: LanguageDefinition): void;
+    /** Sets the current user-facing language */
+    setLanguage(language: string): void;
+    /** Sets the administrative language */
+    setAdminLanguage(language: string): void;
+    /** Gets all registered languages */
+    getLanguages(): readonly LanguageDefinition[];
+    /** Checks if a language is registered */
+    hasLanguage(language: string): boolean;
+    /** Switches to admin context */
+    switchToAdmin(): void;
+    /** Switches to user context */
+    switchToUser(): void;
+    /** Gets the currently active language based on context */
+    getCurrentLanguage(): string;
+    /** Validates all registered components */
+    validate(): ValidationResult;
+}
+//# sourceMappingURL=i18n-engine.interface.d.ts.map

package/src/interfaces/i18n-engine.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-engine.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/i18n-engine.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,WAAW;IAE1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC;IACpD,6DAA6D;IAC7D,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAC/D,gDAAgD;IAChD,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC;IACtG,0CAA0C;IAC1C,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,qCAAqC;IACrC,aAAa,IAAI,SAAS,eAAe,EAAE,CAAC;IAG5C,8CAA8C;IAC9C,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxG,oEAAoE;IACpE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5G,sEAAsE;IACtE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGhF,+BAA+B;IAC/B,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrD,4CAA4C;IAC5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uCAAuC;IACvC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,oCAAoC;IACpC,YAAY,IAAI,SAAS,kBAAkB,EAAE,CAAC;IAC9C,yCAAyC;IACzC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAGvC,gCAAgC;IAChC,aAAa,IAAI,IAAI,CAAC;IACtB,+BAA+B;IAC/B,YAAY,IAAI,IAAI,CAAC;IACrB,0DAA0D;IAC1D,kBAAkB,IAAI,MAAM,CAAC;IAG7B,0CAA0C;IAC1C,QAAQ,IAAI,gBAAgB,CAAC;CAC9B"}

package/src/interfaces/i18n-engine.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core I18n Engine interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=i18n-engine.interface.js.map

package/src/interfaces/i18n-engine.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-engine.interface.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/i18n-engine.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/src/interfaces/{index.ts → index.d.ts}

@@ -2,7 +2,6 @@
  * Interface exports
  * Using type-only exports to prevent runtime circular dependencies
  */
-
 export type * from './active-context.interface';
 export type * from './component-config.interface';
 export type * from './engine-config.interface';
@@ -11,3 +10,4 @@ export type * from './i18n-engine.interface';
 export type * from './language-definition.interface';
 export type * from './translation-options.interface';
 export type * from './validation-result.interface';
+//# sourceMappingURL=index.d.ts.map

package/src/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,iCAAiC,CAAC;AACrD,mBAAmB,+BAA+B,CAAC"}

package/src/interfaces/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Interface exports
+ * Using type-only exports to prevent runtime circular dependencies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/src/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/index.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/src/interfaces/language-definition.interface.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Language definition interface
+ */
+/**
+ * Defines a language with its metadata.
+ */
+export interface LanguageDefinition {
+    /** Unique identifier for the language (e.g., 'en-US') */
+    readonly id: string;
+    /** Display name in the native language */
+    readonly name: string;
+    /** ISO language code */
+    readonly code: string;
+    /** Whether this is the default/fallback language */
+    readonly isDefault?: boolean;
+}
+//# sourceMappingURL=language-definition.interface.d.ts.map

package/src/interfaces/language-definition.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-definition.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/language-definition.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/src/interfaces/language-definition.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Language definition interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=language-definition.interface.js.map

package/src/interfaces/language-definition.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-definition.interface.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/language-definition.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/src/interfaces/translation-options.interface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Translation options interface
+ */
+/**
+ * Options that can be passed when requesting a translation.
+ */
+export interface TranslationOptions {
+    /** Variables to replace in template strings */
+    readonly variables?: Record<string, any>;
+    /** Language code to use for the translation */
+    readonly language?: string;
+    /** Fallback value to return if translation fails */
+    readonly fallback?: string;
+}
+//# sourceMappingURL=translation-options.interface.d.ts.map

package/src/interfaces/translation-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-options.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/translation-options.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/src/interfaces/translation-options.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Translation options interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=translation-options.interface.js.map

package/src/interfaces/translation-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-options.interface.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/translation-options.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/src/interfaces/validation-result.interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Validation result interface
+ */
+/**
+ * Result of validating a component registration or the entire engine.
+ */
+export interface ValidationResult {
+    /** Whether the validation passed */
+    readonly isValid: boolean;
+    /** Array of validation errors */
+    readonly errors: readonly string[];
+    /** Array of validation warnings */
+    readonly warnings: readonly string[];
+    /** Detailed information about missing translation keys */
+    readonly missingKeys?: readonly {
+        /** The language ID where the key is missing */
+        languageId: string;
+        /** The component ID where the key is missing */
+        componentId: string;
+        /** The string key that is missing */
+        stringKey: string;
+    }[];
+}
+//# sourceMappingURL=validation-result.interface.d.ts.map

package/src/interfaces/validation-result.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-result.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/validation-result.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;QAC9B,+CAA+C;QAC/C,UAAU,EAAE,MAAM,CAAC;QACnB,gDAAgD;QAChD,WAAW,EAAE,MAAM,CAAC;QACpB,qCAAqC;QACrC,SAAS,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;CACL"}

package/src/interfaces/validation-result.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Validation result interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=validation-result.interface.js.map

package/src/interfaces/validation-result.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-result.interface.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/validation-result.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/src/language-codes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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.
+ */
+export declare const LanguageCodes: {
+    readonly EN_US: "en-US";
+    readonly EN_GB: "en-GB";
+    readonly FR: "fr";
+    readonly ES: "es";
+    readonly DE: "de";
+    readonly ZH_CN: "zh-CN";
+    readonly JA: "ja";
+    readonly UK: "uk";
+};
+/**
+ * Type representing any language code (string)
+ */
+export type LanguageCode = string;
+/**
+ * Type representing the common language codes provided by this library
+ */
+export type CommonLanguageCode = (typeof LanguageCodes)[keyof typeof LanguageCodes];
+/**
+ * Helper to get display names for common language codes
+ */
+export declare const LanguageDisplayNames: Record<CommonLanguageCode, string>;
+//# sourceMappingURL=language-codes.d.ts.map

package/src/language-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-codes.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/language-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CASnE,CAAC"}

package/src/language-codes.js

@@ -0,0 +1,32 @@
+"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]: 'Українська',
+};
+//# sourceMappingURL=language-codes.js.map

package/src/language-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-codes.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/language-codes.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,OAAO;IACd,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;CACA,CAAC;AAaX;;GAEG;AACU,QAAA,oBAAoB,GAAuC;IACtE,CAAC,qBAAa,CAAC,KAAK,CAAC,EAAE,cAAc;IACrC,CAAC,qBAAa,CAAC,KAAK,CAAC,EAAE,cAAc;IACrC,CAAC,qBAAa,CAAC,EAAE,CAAC,EAAE,UAAU;IAC9B,CAAC,qBAAa,CAAC,EAAE,CAAC,EAAE,SAAS;IAC7B,CAAC,qBAAa,CAAC,EAAE,CAAC,EAAE,SAAS;IAC7B,CAAC,qBAAa,CAAC,KAAK,CAAC,EAAE,IAAI;IAC3B,CAAC,qBAAa,CAAC,EAAE,CAAC,EAAE,KAAK;IACzB,CAAC,qBAAa,CAAC,EAAE,CAAC,EAAE,YAAY;CACjC,CAAC"}

package/src/language-definition.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=language-definition.d.ts.map

package/src/language-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-definition.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/language-definition.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/src/language-definition.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=language-definition.js.map

package/src/language-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-definition.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/language-definition.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,164 @@
+/**
+ * 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 type { IActiveContext } from './interfaces/active-context.interface';
+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;
+    private readonly aliasToComponent;
+    private readonly componentKeyLookup;
+    /**
+     * 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>>, options?: {
+        instanceKey?: string;
+        registerInstance?: boolean;
+        setAsDefault?: boolean;
+    });
+    private resolveComponentAndKey;
+    private registerComponentMetadata;
+    private normalizeLegacyKey;
+    /**
+     * 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;
+    /**
+     * Register a component only if it doesn't already exist
+     */
+    registerComponentIfNotExists<TStringKeys extends string>(registration: ComponentRegistration<TStringKeys, TLanguages>): import("./validation-result").ValidationResult | {
+        isValid: boolean;
+        errors: never[];
+        warnings: never[];
+    };
+    /**
+     * 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;
+}
+//# sourceMappingURL=plugin-i18n-engine.d.ts.map

package/src/plugin-i18n-engine.d.ts.map

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