@digitaldefiance/i18n-lib 3.6.1 → 3.6.3

package/src/errors/i18n-error.js

@@ -4,25 +4,52 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.I18nError = exports.I18nErrorCode = void 0;
+/**
+ * Error codes used throughout the i18n library.
+ */
 exports.I18nErrorCode = {
+    /** Component not found in registry */
     COMPONENT_NOT_FOUND: 'COMPONENT_NOT_FOUND',
+    /** String key not found in component */
     STRING_KEY_NOT_FOUND: 'STRING_KEY_NOT_FOUND',
+    /** Language not found in registry */
     LANGUAGE_NOT_FOUND: 'LANGUAGE_NOT_FOUND',
+    /** Translation missing for specified key and language */
     TRANSLATION_MISSING: 'TRANSLATION_MISSING',
+    /** Invalid configuration provided */
     INVALID_CONFIG: 'INVALID_CONFIG',
+    /** Attempt to register duplicate component */
     DUPLICATE_COMPONENT: 'DUPLICATE_COMPONENT',
+    /** Attempt to register duplicate language */
     DUPLICATE_LANGUAGE: 'DUPLICATE_LANGUAGE',
+    /** Validation failed during registration */
     VALIDATION_FAILED: 'VALIDATION_FAILED',
+    /** I18n instance not found */
     INSTANCE_NOT_FOUND: 'INSTANCE_NOT_FOUND',
+    /** I18n instance already exists */
     INSTANCE_EXISTS: 'INSTANCE_EXISTS',
+    /** Invalid context key provided */
     INVALID_CONTEXT: 'INVALID_CONTEXT',
+    /** Plural form not found for language and category */
     PLURAL_FORM_NOT_FOUND: 'PLURAL_FORM_NOT_FOUND',
+    /** Invalid plural category provided */
     INVALID_PLURAL_CATEGORY: 'INVALID_PLURAL_CATEGORY',
+    /** Count variable missing for plural translation */
     MISSING_COUNT_VARIABLE: 'MISSING_COUNT_VARIABLE',
 };
+/**
+ * Main error class for i18n-related errors.
+ * Includes error code and optional metadata for debugging.
+ */
 class I18nError extends Error {
     code;
     metadata;
+    /**
+     * Creates a new I18nError instance.
+     * @param code - The specific error code
+     * @param message - Human-readable error message
+     * @param metadata - Optional metadata providing context about the error
+     */
     constructor(code, message, metadata) {
         super(message);
         this.code = code;
@@ -30,45 +57,122 @@ class I18nError extends Error {
         this.name = 'I18nError';
         Object.setPrototypeOf(this, I18nError.prototype);
     }
+    /**
+     * Creates an error for when a component is not found.
+     * @param componentId - The ID of the component that was not found
+     * @returns An I18nError instance
+     */
     static componentNotFound(componentId) {
         return new I18nError(exports.I18nErrorCode.COMPONENT_NOT_FOUND, `Component '${componentId}' not found`, { componentId });
     }
+    /**
+     * Creates an error for when a string key is not found in a component.
+     * @param componentId - The ID of the component
+     * @param stringKey - The string key that was not found
+     * @returns An I18nError instance
+     */
     static stringKeyNotFound(componentId, stringKey) {
         return new I18nError(exports.I18nErrorCode.STRING_KEY_NOT_FOUND, `String key '${stringKey}' not found in component '${componentId}'`, { componentId, stringKey });
     }
+    /**
+     * Creates an error for when a language is not found.
+     * @param language - The language code that was not found
+     * @returns An I18nError instance
+     */
     static languageNotFound(language) {
         return new I18nError(exports.I18nErrorCode.LANGUAGE_NOT_FOUND, `Language '${language}' not found`, { language });
     }
+    /**
+     * Creates an error for when a translation is missing.
+     * @param componentId - The ID of the component
+     * @param stringKey - The string key
+     * @param language - The language code
+     * @returns An I18nError instance
+     */
     static translationMissing(componentId, stringKey, language) {
         return new I18nError(exports.I18nErrorCode.TRANSLATION_MISSING, `Translation missing for '${componentId}.${stringKey}' in language '${language}'`, { componentId, stringKey, language });
     }
+    /**
+     * Creates an error for invalid configuration.
+     * @param reason - The reason why the configuration is invalid
+     * @returns An I18nError instance
+     */
     static invalidConfig(reason) {
         return new I18nError(exports.I18nErrorCode.INVALID_CONFIG, reason);
     }
+    /**
+     * Creates an error for duplicate component registration.
+     * @param componentId - The ID of the duplicate component
+     * @returns An I18nError instance
+     */
     static duplicateComponent(componentId) {
         return new I18nError(exports.I18nErrorCode.DUPLICATE_COMPONENT, `Component '${componentId}' already registered`, { componentId });
     }
+    /**
+     * Creates an error for duplicate language registration.
+     * @param language - The language code that is duplicate
+     * @returns An I18nError instance
+     */
     static duplicateLanguage(language) {
         return new I18nError(exports.I18nErrorCode.DUPLICATE_LANGUAGE, `Language '${language}' already registered`, { language });
     }
+    /**
+     * Creates an error for validation failure.
+     * @param errors - Array of validation error messages
+     * @returns An I18nError instance
+     */
     static validationFailed(errors) {
         return new I18nError(exports.I18nErrorCode.VALIDATION_FAILED, `Validation failed: ${errors.join(', ')}`, { errors });
     }
+    /**
+     * Creates an error for when an i18n instance is not found.
+     * @param key - The instance key that was not found
+     * @returns An I18nError instance
+     */
     static instanceNotFound(key) {
         return new I18nError(exports.I18nErrorCode.INSTANCE_NOT_FOUND, `I18n instance '${key}' not found`, { key });
     }
+    /**
+     * Creates an error for when an i18n instance already exists.
+     * @param key - The instance key that already exists
+     * @returns An I18nError instance
+     */
     static instanceExists(key) {
         return new I18nError(exports.I18nErrorCode.INSTANCE_EXISTS, `I18n instance '${key}' already exists`, { key });
     }
+    /**
+     * Creates an error for an invalid context key.
+     * @param contextKey - The invalid context key
+     * @returns An I18nError instance
+     */
     static invalidContext(contextKey) {
         return new I18nError(exports.I18nErrorCode.INVALID_CONTEXT, `Invalid context key '${contextKey}'`, { contextKey });
     }
+    /**
+     * Creates an error for when a plural form is not found.
+     * @param category - The plural category that was not found
+     * @param language - The language code
+     * @param key - The translation key
+     * @param availableForms - Array of available plural forms
+     * @returns An I18nError instance
+     */
     static pluralFormNotFound(category, language, key, availableForms) {
         return new I18nError(exports.I18nErrorCode.PLURAL_FORM_NOT_FOUND, `Plural form '${category}' not found for language '${language}' in key '${key}'. Available forms: ${availableForms.join(', ')}`, { category, language, key, availableForms });
     }
+    /**
+     * Creates an error for an invalid plural category.
+     * @param category - The invalid category
+     * @param validCategories - Array of valid categories
+     * @returns An I18nError instance
+     */
     static invalidPluralCategory(category, validCategories) {
         return new I18nError(exports.I18nErrorCode.INVALID_PLURAL_CATEGORY, `Invalid plural category '${category}'. Valid categories: ${validCategories.join(', ')}`, { category, validCategories });
     }
+    /**
+     * Creates an error for when the count variable is missing for plural forms.
+     * @param key - The translation key that requires a count variable
+     * @returns An I18nError instance
+     */
     static missingCountVariable(key) {
         return new I18nError(exports.I18nErrorCode.MISSING_COUNT_VARIABLE, `Plural forms used in key '${key}' but no 'count' variable provided`, { key });
     }

package/src/errors/i18n-error.js.map

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

package/src/gender/gender-categories.d.ts

@@ -1,7 +1,18 @@
 /**
  * Gender categories for gendered translations
  */
+/**
+ * Standard gender categories for translations that vary by gender.
+ */
 export type GenderCategory = 'male' | 'female' | 'neutral' | 'other';
+/**
+ * A string value that can be either a simple string or an object with gender-specific forms.
+ */
 export type GenderedString = string | Partial<Record<GenderCategory, string>>;
+/**
+ * Checks if a value is a gendered string object (not a simple string).
+ * @param value - The value to check
+ * @returns True if the value is a gendered string object, false otherwise
+ */
 export declare function isGenderedString(value: any): value is Partial<Record<GenderCategory, string>>;
 //# sourceMappingURL=gender-categories.d.ts.map

package/src/gender/gender-categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gender-categories.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAE7F"}
+{"version":3,"file":"gender-categories.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAE7F"}

package/src/gender/gender-categories.js

@@ -4,6 +4,11 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isGenderedString = isGenderedString;
+/**
+ * Checks if a value is a gendered string object (not a simple string).
+ * @param value - The value to check
+ * @returns True if the value is a gendered string object, false otherwise
+ */
 function isGenderedString(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/src/gender/gender-categories.js.map

@@ -1 +1 @@
-{"version":3,"file":"gender-categories.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-categories.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,4CAEC;AAFD,SAAgB,gBAAgB,CAAC,KAAU;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"gender-categories.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-categories.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAiBH,4CAEC;AAPD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAU;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/src/gender/gender-resolver.d.ts

@@ -3,7 +3,12 @@
  */
 import { GenderCategory, GenderedString } from './gender-categories';
 /**
- * Resolve gender form with fallback logic
+ * Resolve a gender-specific form with fallback logic.
+ * If the value is a simple string, it's returned as-is.
+ * For gendered strings, it tries the requested gender, then neutral, then other, then the first available form.
+ * @param value - The gendered string value or simple string
+ * @param gender - The gender category to resolve (optional)
+ * @returns The resolved string form
  */
 export declare function resolveGenderForm(value: GenderedString, gender: GenderCategory | string | undefined): string;
 //# sourceMappingURL=gender-resolver.d.ts.map

package/src/gender/gender-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gender-resolver.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAoB,MAAM,qBAAqB,CAAC;AAEvF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,GAC1C,MAAM,CAsBR"}
+{"version":3,"file":"gender-resolver.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAoB,MAAM,qBAAqB,CAAC;AAEvF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,GAC1C,MAAM,CAsBR"}

package/src/gender/gender-resolver.js

@@ -6,7 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveGenderForm = resolveGenderForm;
 const gender_categories_1 = require("./gender-categories");
 /**
- * Resolve gender form with fallback logic
+ * Resolve a gender-specific form with fallback logic.
+ * If the value is a simple string, it's returned as-is.
+ * For gendered strings, it tries the requested gender, then neutral, then other, then the first available form.
+ * @param value - The gendered string value or simple string
+ * @param gender - The gender category to resolve (optional)
+ * @returns The resolved string form
  */
 function resolveGenderForm(value, gender) {
     if (typeof value === 'string') {

package/src/gender/gender-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"gender-resolver.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-resolver.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,8CAyBC;AA9BD,2DAAuF;AAEvF;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,KAAqB,EACrB,MAA2C;IAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,IAAA,oCAAgB,EAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+DAA+D;IAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAwB,CAAC,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8CAA8C;IAC9C,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC"}
+{"version":3,"file":"gender-resolver.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/gender/gender-resolver.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,8CAyBC;AAnCD,2DAAuF;AAEvF;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAC/B,KAAqB,EACrB,MAA2C;IAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,IAAA,oCAAgB,EAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+DAA+D;IAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAwB,CAAC,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8CAA8C;IAC9C,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/src/interfaces/component-config.interface.d.ts

@@ -2,9 +2,15 @@
  * Simplified component configuration
  */
 import { PluralString } from '../types/plural-types';
+/**
+ * Configuration for registering a component with the i18n system.
+ */
 export interface ComponentConfig {
+    /** Unique identifier for the component */
     readonly id: string;
+    /** Translation strings organized by language and key */
     readonly strings: Record<string, Record<string, string | PluralString>>;
+    /** Optional alternative names for referencing this component */
     readonly aliases?: readonly string[];
 }
 //# sourceMappingURL=component-config.interface.d.ts.map

package/src/interfaces/component-config.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-config.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/component-config.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC"}
+{"version":3,"file":"component-config.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/component-config.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IACxE,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC"}

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

@@ -1,12 +1,21 @@
 /**
  * Engine configuration interface
  */
+/**
+ * Configuration options for the I18n engine.
+ */
 export interface EngineConfig {
+    /** Default language to use when none is specified */
     defaultLanguage?: string;
+    /** Fallback language to use when a translation is missing */
     fallbackLanguage?: string;
+    /** Constants available for variable replacement in templates */
     constants?: Record<string, any>;
+    /** Validation configuration */
     validation?: {
+        /** Whether all string keys must be provided for all languages */
         requireCompleteStrings?: boolean;
+        /** Whether to allow component registration with missing translations */
         allowPartialRegistration?: boolean;
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"engine-config.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/engine-config.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE;QACX,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,wBAAwB,CAAC,EAAE,OAAO,CAAC;KACpC,CAAC;CACH"}
+{"version":3,"file":"engine-config.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/engine-config.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,+BAA+B;IAC/B,UAAU,CAAC,EAAE;QACX,iEAAiE;QACjE,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,wEAAwE;QACxE,wBAAwB,CAAC,EAAE,OAAO,CAAC;KACpC,CAAC;CACH"}

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

@@ -1,7 +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

@@ -1 +1 @@
-{"version":3,"file":"handleable-error-options.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/handleable-error-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}
+{"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.d.ts

@@ -1,6 +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

@@ -1 +1 @@
-{"version":3,"file":"handleable.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/interfaces/handleable.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,OAAO,IAAI,OAAO,CAAC;IACvB,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE;CAC7B"}
+{"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/i18n-engine.interface.d.ts

@@ -4,23 +4,43 @@
 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

@@ -1 +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,MAAM,WAAW,WAAW;IAE1B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC;IACpD,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAC/D,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC;IACtG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,aAAa,IAAI,SAAS,eAAe,EAAE,CAAC;IAG5C,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,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,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGhF,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,YAAY,IAAI,SAAS,kBAAkB,EAAE,CAAC;IAC9C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAGvC,aAAa,IAAI,IAAI,CAAC;IACtB,YAAY,IAAI,IAAI,CAAC;IACrB,kBAAkB,IAAI,MAAM,CAAC;IAG7B,QAAQ,IAAI,gBAAgB,CAAC;CAC9B"}
+{"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/language-definition.interface.d.ts

@@ -1,10 +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

@@ -1 +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,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B"}
+{"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/translation-options.interface.d.ts

@@ -1,9 +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

@@ -1 +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,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}
+{"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/validation-result.interface.d.ts

@@ -1,13 +1,23 @@
 /**
  * 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;
     }[];
 }

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

@@ -1 +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,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;CACL"}
+{"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/registry-error-type.d.ts

@@ -2,12 +2,19 @@
  * Error types for registry operations
  */
 export declare enum RegistryErrorType {
+    /** Error when a requested component is not found in the registry */
     ComponentNotFound = "COMPONENT_NOT_FOUND",
+    /** Error when a requested language is not found in the registry */
     LanguageNotFound = "LANGUAGE_NOT_FOUND",
+    /** Error when a requested string key is not found in a component */
     StringKeyNotFound = "STRING_KEY_NOT_FOUND",
+    /** Error when component registration is incomplete (missing strings) */
     IncompleteRegistration = "INCOMPLETE_REGISTRATION",
+    /** Error when attempting to register a component that already exists */
     DuplicateComponent = "DUPLICATE_COMPONENT",
+    /** Error when attempting to register a language that already exists */
     DuplicateLanguage = "DUPLICATE_LANGUAGE",
+    /** Error when component validation fails */
     ValidationFailed = "VALIDATION_FAILED"
 }
 //# sourceMappingURL=registry-error-type.d.ts.map

package/src/registry-error-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-error-type.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/registry-error-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,iBAAiB,wBAAwB;IACzC,gBAAgB,uBAAuB;IACvC,iBAAiB,yBAAyB;IAC1C,sBAAsB,4BAA4B;IAClD,kBAAkB,wBAAwB;IAC1C,iBAAiB,uBAAuB;IACxC,gBAAgB,sBAAsB;CACvC"}
+{"version":3,"file":"registry-error-type.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/registry-error-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,oEAAoE;IACpE,iBAAiB,wBAAwB;IACzC,mEAAmE;IACnE,gBAAgB,uBAAuB;IACvC,oEAAoE;IACpE,iBAAiB,yBAAyB;IAC1C,wEAAwE;IACxE,sBAAsB,4BAA4B;IAClD,wEAAwE;IACxE,kBAAkB,wBAAwB;IAC1C,uEAAuE;IACvE,iBAAiB,uBAAuB;IACxC,4CAA4C;IAC5C,gBAAgB,sBAAsB;CACvC"}

package/src/registry-error-type.js

@@ -6,12 +6,19 @@ exports.RegistryErrorType = void 0;
  */
 var RegistryErrorType;
 (function (RegistryErrorType) {
+    /** Error when a requested component is not found in the registry */
     RegistryErrorType["ComponentNotFound"] = "COMPONENT_NOT_FOUND";
+    /** Error when a requested language is not found in the registry */
     RegistryErrorType["LanguageNotFound"] = "LANGUAGE_NOT_FOUND";
+    /** Error when a requested string key is not found in a component */
     RegistryErrorType["StringKeyNotFound"] = "STRING_KEY_NOT_FOUND";
+    /** Error when component registration is incomplete (missing strings) */
     RegistryErrorType["IncompleteRegistration"] = "INCOMPLETE_REGISTRATION";
+    /** Error when attempting to register a component that already exists */
     RegistryErrorType["DuplicateComponent"] = "DUPLICATE_COMPONENT";
+    /** Error when attempting to register a language that already exists */
     RegistryErrorType["DuplicateLanguage"] = "DUPLICATE_LANGUAGE";
+    /** Error when component validation fails */
     RegistryErrorType["ValidationFailed"] = "VALIDATION_FAILED";
 })(RegistryErrorType || (exports.RegistryErrorType = RegistryErrorType = {}));
 //# sourceMappingURL=registry-error-type.js.map

package/src/registry-error-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry-error-type.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/registry-error-type.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,iBAQX;AARD,WAAY,iBAAiB;IAC3B,8DAAyC,CAAA;IACzC,4DAAuC,CAAA;IACvC,+DAA0C,CAAA;IAC1C,uEAAkD,CAAA;IAClD,+DAA0C,CAAA;IAC1C,6DAAwC,CAAA;IACxC,2DAAsC,CAAA;AACxC,CAAC,EARW,iBAAiB,iCAAjB,iBAAiB,QAQ5B"}
+{"version":3,"file":"registry-error-type.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/registry-error-type.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,iBAeX;AAfD,WAAY,iBAAiB;IAC3B,oEAAoE;IACpE,8DAAyC,CAAA;IACzC,mEAAmE;IACnE,4DAAuC,CAAA;IACvC,oEAAoE;IACpE,+DAA0C,CAAA;IAC1C,wEAAwE;IACxE,uEAAkD,CAAA;IAClD,wEAAwE;IACxE,+DAA0C,CAAA;IAC1C,uEAAuE;IACvE,6DAAwC,CAAA;IACxC,4CAA4C;IAC5C,2DAAsC,CAAA;AACxC,CAAC,EAfW,iBAAiB,iCAAjB,iBAAiB,QAe5B"}

package/src/strings/de.d.ts

@@ -0,0 +1,3 @@
+import { CoreStringKey } from '../core-string-key';
+export declare const germanStrings: Record<CoreStringKey, string>;
+//# sourceMappingURL=de.d.ts.map

package/src/strings/de.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/strings/de.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAwEnD,CAAC"}