@digitaldefiance/i18n-lib 4.4.0 → 4.6.0

package/README.md

@@ -589,23 +589,109 @@ engine.t('Price in {currency}', { currency: 'USD' }); // "Price in USD"
 
 ### Constants Management
 
-Manage application-wide constants for use in translations:
+Constants are application-wide values available as template variables in all translations (e.g., `{Site}` in a translation string resolves to the registered value). The `ConstantsRegistry` provides structured, per-component registration with conflict detection and ownership tracking.
+
+#### Registration Flow (via `createI18nSetup`)
+
+Library packages declare default constants in their `I18nComponentPackage`. The app overrides them at runtime. The factory handles the ordering automatically:
+
+```typescript
+import { createI18nSetup } from '@digitaldefiance/i18n-lib';
+import { createSuiteCoreComponentPackage } from '@digitaldefiance/suite-core-lib';
+import { AppStringKey } from './enumerations/app-string-key';
+import { Strings } from './strings-collection';
+
+const setup = createI18nSetup({
+  componentId: 'my-app',
+  stringKeyEnum: AppStringKey,
+  strings: Strings,
+  // App constants override library defaults — app always wins
+  constants: { Site: 'My Real Site', SiteTagline: 'We do things' },
+  // Library components register their own defaults
+  libraryComponents: [createSuiteCoreComponentPackage()],
+});
+
+// The factory does this internally:
+// 1. Library components register defaults via registerConstants()
+// 2. App constants override via updateConstants() — app values win
+```
+
+#### Direct Engine API
+
+```typescript
+// Register constants for a component (idempotent, conflict-detecting)
+engine.registerConstants('suite-core', { Site: 'New Site', Version: '1.0' });
+
+// Update/override constants (merges, updater wins ownership)
+engine.updateConstants('my-app', { Site: 'My Real Site' });
+
+// Replace all constants for a component (wipes old keys)
+engine.replaceConstants({ Site: 'Completely New', Version: '2.0' });
+
+// Merge into engine-level constants (legacy, preserved for compat)
+engine.mergeConstants({ ExtraKey: 'value' });
+
+// Query
+engine.hasConstants('suite-core');           // true
+engine.getConstants('suite-core');           // { Site: 'New Site', Version: '1.0' }
+engine.getAllConstants();                     // [{ componentId, constants }, ...]
+engine.resolveConstantOwner('Site');         // 'my-app' (last updater wins)
+```
+
+#### I18nComponentPackage Constants
+
+Library authors can bundle default constants with their component package:
 
 ```typescript
-// Merge constants (adds/updates specific keys, preserves others)
-engine.mergeConstants({ Version: '2.0', NewKey: 'value' });
-// Existing constants preserved, specified ones added/updated
+import type { I18nComponentPackage } from '@digitaldefiance/i18n-lib';
 
-// Update all constants (replaces entire constants object)
-engine.updateConstants({ Site: 'NewSite', Version: '2.0' });
-// All previous constants removed, only these remain
+export function createMyLibComponentPackage(): I18nComponentPackage {
+  return {
+    config: createMyLibComponentConfig(),
+    stringKeyEnum: MyLibStringKey,
+    constants: {
+      LibName: 'My Library',
+      LibVersion: '1.0.0',
+    },
+  };
+}
 ```
 
+These are registered automatically when passed via `libraryComponents` in `createI18nSetup`.
+
+#### I18nSetupResult Helpers
+
+The result from `createI18nSetup` exposes constants helpers:
+
+```typescript
+const setup = createI18nSetup({ /* ... */ });
+
+// Register constants for a new component after setup
+setup.registerConstants('analytics', { TrackingId: 'UA-12345' });
+
+// Override constants at runtime
+setup.updateConstants('my-app', { Site: 'Updated Site Name' });
+```
+
+#### Conflict Detection
+
+If two different components try to `register` the same key with different values, an error is thrown:
+
+```typescript
+engine.registerConstants('lib-a', { Site: 'Alpha' });
+engine.registerConstants('lib-b', { Site: 'Beta' });
+// Throws: I18nError CONSTANT_CONFLICT — "Site" already registered by "lib-a" with a different value
+```
+
+Use `updateConstants` instead of `registerConstants` when you intentionally want to override.
+
 **When to use:**
-- **Constants**: Application-wide values that rarely change (AppName, Version)
+- **Constants**: Application-wide values that rarely change (Site, Version, SiteTagline)
 - **Variables**: Request-specific or dynamic values passed to translate()
 - **Context**: User-specific values (currency, timezone, language)
 
+**Variable priority**: provided variables > context > constants
+
 ### Language Management
 
 ```typescript
@@ -824,6 +910,14 @@ const engine = PluginI18nEngine.createInstance<MyLanguages>('app', [
 - `safeTranslateStringKey(key, variables?, language?)` - Safe version returning placeholder on failure
 - `hasStringKeyEnum(enum)` - Check if a branded enum is registered
 - `getStringKeyEnums()` - Get all registered branded enums
+- `registerConstants(componentId, constants)` - Register constants for a component (idempotent, conflict-detecting)
+- `updateConstants(componentId, constants)` - Update/override constants for a component (merges, updater wins)
+- `replaceConstants(constants)` - Replace all engine-level constants
+- `mergeConstants(constants)` - Merge into engine-level constants
+- `hasConstants(componentId)` - Check if constants are registered for a component
+- `getConstants(componentId)` - Get constants for a specific component
+- `getAllConstants()` - Get all registered constants entries
+- `resolveConstantOwner(key)` - Resolve which component owns a constant key
 
 ### Branded Enum Functions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/i18n-lib",
-  "version": "4.4.0",
+  "version": "4.6.0",
   "description": "i18n library with enum translation support",
   "homepage": "https://github.com/Digital-Defiance/i18n-lib",
   "repository": {
@@ -42,7 +42,7 @@
   "license": "MIT",
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "@digitaldefiance/branded-enum": "0.0.6",
+    "@digitaldefiance/branded-enum": "0.0.7",
     "currency-codes": "^2.2.0",
     "lru-cache": "^5.1.1",
     "moment": "^2.30.1",

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

@@ -0,0 +1,107 @@
+/**
+ * Constants Registry for structured, namespaced constant registration.
+ *
+ * Mirrors the StringKeyEnumRegistry pattern: each component can register
+ * its own constants with an associated component ID. Constants are merged
+ * into a flat lookup for template variable replacement, with conflict
+ * detection when two components try to register the same constant key
+ * with different values.
+ */
+/**
+ * Entry representing a registered constants set and its owning component.
+ */
+export interface ConstantsEntry {
+    /** The component that registered these constants */
+    readonly componentId: string;
+    /** The constants record */
+    readonly constants: Readonly<Record<string, unknown>>;
+}
+/**
+ * Registry that manages per-component constants with conflict detection
+ * and a merged flat lookup for the translation pipeline.
+ */
+export declare class ConstantsRegistry {
+    /** Component ID → constants record */
+    private readonly entries;
+    /** Reverse lookup: constant key → owning component ID (first registrant wins) */
+    private readonly keyOwnership;
+    /** Cached merged constants (invalidated on registration) */
+    private mergedCache;
+    /**
+     * Registers constants for a component.
+     *
+     * If the component already has constants registered, this is a no-op
+     * (idempotent by component ID). If a different component has already
+     * registered a constant with the same key but a different value, an
+     * error is thrown to surface the conflict early.
+     *
+     * @param componentId - The component registering these constants
+     * @param constants - Key-value pairs to register
+     * @throws {I18nError} If a key conflict is detected with a different value
+     */
+    register(componentId: string, constants: Record<string, unknown>): void;
+    /**
+     * Checks if constants are registered for a component.
+     */
+    has(componentId: string): boolean;
+    /**
+     * Updates constants for a component, merging new values into existing ones.
+     *
+     * Unlike `register`, this is NOT idempotent — it always merges the provided
+     * constants into the component's existing set (or creates a new entry).
+     * This is the mechanism for runtime overrides: a library registers defaults
+     * via `register`, and the app overrides specific keys via `update`.
+     *
+     * Conflict detection is skipped for keys already owned by this component.
+     * For keys owned by other components, the ownership is transferred to
+     * this component (the updater wins).
+     *
+     * @param componentId - The component updating these constants
+     * @param constants - Key-value pairs to merge
+     */
+    update(componentId: string, constants: Record<string, unknown>): void;
+    /**
+     * Fully replaces constants for a component, removing old keys.
+     *
+     * Unlike `update` (which merges), this wipes the component's existing
+     * constants and sets the new ones. Ownership of old keys that are no
+     * longer present is released.
+     *
+     * @param componentId - The component replacing its constants
+     * @param constants - The new complete set of constants
+     */
+    replace(componentId: string, constants: Record<string, unknown>): void;
+    /**
+     * Gets the constants registered for a specific component.
+     * Returns undefined if the component has no registered constants.
+     */
+    get(componentId: string): Readonly<Record<string, unknown>> | undefined;
+    /**
+     * Returns all registered entries.
+     */
+    getAll(): readonly ConstantsEntry[];
+    /**
+     * Returns a merged flat record of all registered constants.
+     *
+     * When multiple components have the same key, the owning component's
+     * value wins (ownership is tracked via register/update/replace).
+     *
+     * The result is cached and invalidated when constants change.
+     */
+    getMerged(): Readonly<Record<string, unknown>>;
+    /**
+     * Resolves which component owns a given constant key.
+     * Returns null if the key is not registered.
+     */
+    resolveOwner(key: string): string | null;
+    /**
+     * Clears all registrations.
+     */
+    clear(): void;
+    /**
+     * Detects conflicts: same key registered by a different component
+     * with a different value.
+     */
+    private detectConflicts;
+}
+//# sourceMappingURL=constants-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants-registry.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/core/constants-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAEtE,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D,4DAA4D;IAC5D,OAAO,CAAC,WAAW,CAAwC;IAE3D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAoBvE;;OAEG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAerE;;;;;;;;;OASG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAsBtE;;;OAGG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS;IAIvE;;OAEG;IACH,MAAM,IAAI,SAAS,cAAc,EAAE;IAQnC;;;;;;;OAOG;IACH,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAyB9C;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,OAAO,CAAC,eAAe;CAcxB"}

package/src/core/constants-registry.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Constants Registry for structured, namespaced constant registration.
+ *
+ * Mirrors the StringKeyEnumRegistry pattern: each component can register
+ * its own constants with an associated component ID. Constants are merged
+ * into a flat lookup for template variable replacement, with conflict
+ * detection when two components try to register the same constant key
+ * with different values.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstantsRegistry = void 0;
+const i18n_error_1 = require("../errors/i18n-error");
+const safe_object_1 = require("../utils/safe-object");
+/**
+ * Registry that manages per-component constants with conflict detection
+ * and a merged flat lookup for the translation pipeline.
+ */
+class ConstantsRegistry {
+    /** Component ID → constants record */
+    entries = new Map();
+    /** Reverse lookup: constant key → owning component ID (first registrant wins) */
+    keyOwnership = new Map();
+    /** Cached merged constants (invalidated on registration) */
+    mergedCache = null;
+    /**
+     * Registers constants for a component.
+     *
+     * If the component already has constants registered, this is a no-op
+     * (idempotent by component ID). If a different component has already
+     * registered a constant with the same key but a different value, an
+     * error is thrown to surface the conflict early.
+     *
+     * @param componentId - The component registering these constants
+     * @param constants - Key-value pairs to register
+     * @throws {I18nError} If a key conflict is detected with a different value
+     */
+    register(componentId, constants) {
+        // Idempotent: skip if already registered for this component
+        if (this.entries.has(componentId)) {
+            return;
+        }
+        (0, safe_object_1.validateObjectKeys)(constants);
+        this.detectConflicts(componentId, constants);
+        // Store entry and ownership
+        this.entries.set(componentId, { ...constants });
+        for (const key of Object.keys(constants)) {
+            if (!this.keyOwnership.has(key)) {
+                this.keyOwnership.set(key, componentId);
+            }
+        }
+        this.mergedCache = null;
+    }
+    /**
+     * Checks if constants are registered for a component.
+     */
+    has(componentId) {
+        return this.entries.has(componentId);
+    }
+    /**
+     * Updates constants for a component, merging new values into existing ones.
+     *
+     * Unlike `register`, this is NOT idempotent — it always merges the provided
+     * constants into the component's existing set (or creates a new entry).
+     * This is the mechanism for runtime overrides: a library registers defaults
+     * via `register`, and the app overrides specific keys via `update`.
+     *
+     * Conflict detection is skipped for keys already owned by this component.
+     * For keys owned by other components, the ownership is transferred to
+     * this component (the updater wins).
+     *
+     * @param componentId - The component updating these constants
+     * @param constants - Key-value pairs to merge
+     */
+    update(componentId, constants) {
+        (0, safe_object_1.validateObjectKeys)(constants);
+        const existing = this.entries.get(componentId) ?? {};
+        const merged = { ...existing, ...constants };
+        this.entries.set(componentId, merged);
+        // Update ownership — the updater takes ownership of these keys
+        for (const key of Object.keys(constants)) {
+            this.keyOwnership.set(key, componentId);
+        }
+        this.mergedCache = null;
+    }
+    /**
+     * Fully replaces constants for a component, removing old keys.
+     *
+     * Unlike `update` (which merges), this wipes the component's existing
+     * constants and sets the new ones. Ownership of old keys that are no
+     * longer present is released.
+     *
+     * @param componentId - The component replacing its constants
+     * @param constants - The new complete set of constants
+     */
+    replace(componentId, constants) {
+        (0, safe_object_1.validateObjectKeys)(constants);
+        // Remove ownership of old keys belonging to this component
+        const oldEntry = this.entries.get(componentId);
+        if (oldEntry) {
+            for (const key of Object.keys(oldEntry)) {
+                if (this.keyOwnership.get(key) === componentId) {
+                    this.keyOwnership.delete(key);
+                }
+            }
+        }
+        // Set new entry and ownership
+        this.entries.set(componentId, { ...constants });
+        for (const key of Object.keys(constants)) {
+            this.keyOwnership.set(key, componentId);
+        }
+        this.mergedCache = null;
+    }
+    /**
+     * Gets the constants registered for a specific component.
+     * Returns undefined if the component has no registered constants.
+     */
+    get(componentId) {
+        return this.entries.get(componentId);
+    }
+    /**
+     * Returns all registered entries.
+     */
+    getAll() {
+        const result = [];
+        for (const [componentId, constants] of this.entries) {
+            result.push({ componentId, constants });
+        }
+        return result;
+    }
+    /**
+     * Returns a merged flat record of all registered constants.
+     *
+     * When multiple components have the same key, the owning component's
+     * value wins (ownership is tracked via register/update/replace).
+     *
+     * The result is cached and invalidated when constants change.
+     */
+    getMerged() {
+        if (this.mergedCache !== null) {
+            return this.mergedCache;
+        }
+        const merged = Object.create(null);
+        // First pass: collect all keys from all components
+        for (const [componentId, constants] of this.entries) {
+            for (const [key, value] of Object.entries(constants)) {
+                // The owner's value wins; non-owners only fill gaps
+                const owner = this.keyOwnership.get(key);
+                if (owner === componentId || !(key in merged)) {
+                    merged[key] = value;
+                }
+            }
+        }
+        this.mergedCache = merged;
+        return merged;
+    }
+    /**
+     * Resolves which component owns a given constant key.
+     * Returns null if the key is not registered.
+     */
+    resolveOwner(key) {
+        return this.keyOwnership.get(key) ?? null;
+    }
+    /**
+     * Clears all registrations.
+     */
+    clear() {
+        this.entries.clear();
+        this.keyOwnership.clear();
+        this.mergedCache = null;
+    }
+    /**
+     * Detects conflicts: same key registered by a different component
+     * with a different value.
+     */
+    detectConflicts(componentId, constants) {
+        for (const [key, value] of Object.entries(constants)) {
+            const owner = this.keyOwnership.get(key);
+            if (owner !== undefined && owner !== componentId) {
+                const existingValue = this.entries.get(owner)?.[key];
+                if (existingValue !== value) {
+                    throw i18n_error_1.I18nError.constantConflict(key, componentId, owner);
+                }
+            }
+        }
+    }
+}
+exports.ConstantsRegistry = ConstantsRegistry;
+//# sourceMappingURL=constants-registry.js.map

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

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

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

@@ -3,6 +3,7 @@
  */
 import type { AnyBrandedEnum, BrandedEnumValue } from '@digitaldefiance/branded-enum';
 import { ComponentConfig, EngineConfig, II18nEngine, LanguageDefinition, ValidationResult } from '../interfaces';
+import type { ConstantsEntry } from './constants-registry';
 /**
  * I18nEngine implements the II18nEngine interface, providing translation,
  * component registration, enum translation, and context management.
@@ -15,6 +16,7 @@ export declare class I18nEngine implements II18nEngine {
     private readonly componentStore;
     private readonly enumRegistry;
     private readonly stringKeyEnumRegistry;
+    private readonly constantsRegistry;
     private readonly instanceKey;
     private readonly config;
     private readonly aliasToComponent;
@@ -172,15 +174,17 @@ export declare class I18nEngine implements II18nEngine {
      */
     hasLanguage(language: string): boolean;
     /**
-     * Merges new constants into existing config constants.
+     * Merges new constants into the engine-level constants pool.
+     * These are registered under the '__engine__' component ID in the registry.
      * @param constants - Key-value constants to merge.
      */
-    mergeConstants(constants: Record<string, any>): void;
+    mergeConstants(constants: Record<string, unknown>): void;
     /**
-     * Updates config constants and componentStore constants to new values.
+     * Replaces engine-level constants and syncs to the component store.
+     * @deprecated Use registerConstants/updateConstants with componentId instead.
      * @param constants - New constants record.
      */
-    updateConstants(constants: Record<string, any>): void;
+    replaceConstants(constants: Record<string, unknown>): void;
     /**
      * Switches translation context to admin.
      */
@@ -351,8 +355,9 @@ export declare class I18nEngine implements II18nEngine {
      * will cause an error to be thrown.
      *
      * @param stringKeyEnum - Branded enum created by createI18nStringKeys
-     * @returns The extracted component ID
-     * @throws {I18nError} If not a valid branded enum (INVALID_STRING_KEY_ENUM)
+     * @param componentId - Optional explicit component ID (escape hatch for cross-module scenarios)
+     * @returns The extracted or provided component ID
+     * @throws {I18nError} If not a valid branded enum and no fallback succeeds (INVALID_STRING_KEY_ENUM)
      *
      * @example Basic registration
      * ```typescript
@@ -365,6 +370,11 @@ export declare class I18nEngine implements II18nEngine {
      * console.log(componentId); // 'user'
      * ```
      *
+     * @example Explicit componentId escape hatch
+     * ```typescript
+     * engine.registerStringKeyEnum(plainObj, 'user'); // 'user'
+     * ```
+     *
      * @example Idempotent registration
      * ```typescript
      * engine.registerStringKeyEnum(UserKeys); // 'user'
@@ -374,7 +384,7 @@ export declare class I18nEngine implements II18nEngine {
      * @see {@link translateStringKey} - Translate registered string key values
      * @see {@link hasStringKeyEnum} - Check if an enum is registered
      */
-    registerStringKeyEnum(stringKeyEnum: AnyBrandedEnum): string;
+    registerStringKeyEnum(stringKeyEnum: AnyBrandedEnum, componentId?: string): string;
     /**
      * Translates a branded string key value directly.
      *
@@ -496,6 +506,66 @@ export declare class I18nEngine implements II18nEngine {
         enumObj: AnyBrandedEnum;
         componentId: string;
     }[];
+    /**
+     * Registers constants for a component.
+     *
+     * Constants are available as template variables in all translations
+     * (e.g., `{appName}` in a translation string). Registration is idempotent
+     * per component ID. Conflicts (same key, different value, different component)
+     * throw an error.
+     *
+     * @param componentId - The component registering these constants
+     * @param constants - Key-value pairs to register
+     * @throws {I18nError} If a key conflict is detected (CONSTANT_CONFLICT)
+     *
+     * @example
+     * ```typescript
+     * engine.registerConstants('my-app', { appName: 'MyApp', supportEmail: 'help@example.com' });
+     * // Now {appName} and {supportEmail} are available in all translations
+     * ```
+     */
+    registerConstants(componentId: string, constants: Record<string, unknown>): void;
+    /**
+     * Updates constants for a component, merging new values into existing ones.
+     *
+     * This is the runtime override mechanism. A library registers defaults via
+     * `registerConstants`, and the app overrides specific keys (like `Site`)
+     * via `updateConstants` once the real values are known.
+     *
+     * @param componentId - The component updating these constants
+     * @param constants - Key-value pairs to merge (overrides existing keys)
+     *
+     * @example
+     * ```typescript
+     * // Library registers defaults
+     * engine.registerConstants('suite-core', { Site: 'New Site' });
+     * // App overrides at runtime
+     * engine.updateConstants('suite-core', { Site: 'My Real Site' });
+     * ```
+     */
+    updateConstants(componentId: string, constants: Record<string, unknown>): void;
+    /**
+     * Checks if constants are registered for a component.
+     */
+    hasConstants(componentId: string): boolean;
+    /**
+     * Gets the constants registered for a specific component.
+     */
+    getConstants(componentId: string): Readonly<Record<string, unknown>> | undefined;
+    /**
+     * Gets all registered constants entries with their component IDs.
+     */
+    getAllConstants(): readonly ConstantsEntry[];
+    /**
+     * Resolves which component owns a given constant key.
+     * Returns null if the key is not registered.
+     */
+    resolveConstantOwner(key: string): string | null;
+    /**
+     * Syncs the merged constants from the registry into the component store
+     * so they're available during template variable replacement.
+     */
+    private syncConstantsToStore;
     /**
      * Validates all registered components for missing translations or warnings.
      * @returns ValidationResult containing errors and warnings.

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

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