@digitaldefiance/i18n-lib 3.8.2 → 3.8.3

package/src/{types.ts → types.d.ts}

@@ -1,142 +1,91 @@
 import { ComponentDefinition } from './component-definition';
 import { LanguageDefinition } from './language-definition';
-
 /**
  * Standard language context spaces
  */
 export type LanguageContextSpace = 'admin' | 'user';
-
 /**
  * Default currency code
  */
-export const DefaultCurrencyCode: string = 'USD';
-
+export declare const DefaultCurrencyCode: string;
 /**
  * Default timezone
  */
-export const DefaultTimezone: string = 'UTC';
-
+export declare const DefaultTimezone: string;
 /**
  * Default language code
  */
-export const DefaultLanguageCode: string = 'en-US';
-
+export declare const DefaultLanguageCode: string;
 /**
  * Currency position type
  */
 export type CurrencyPosition = 'prefix' | 'postfix' | 'infix';
-
 /**
  * Collection of localized strings for a specific language
  */
-export type StringsCollection<TStringKey extends string> = Partial<
-  Record<TStringKey, string>
->;
-
+export type StringsCollection<TStringKey extends string> = Partial<Record<TStringKey, string>>;
 /**
  * Mapping of languages to their respective string collections
  */
-export type MasterStringsCollection<
-  TStringKey extends string,
-  TLanguage extends string,
-> = Partial<Record<TLanguage, StringsCollection<TStringKey>>>;
-
+export type MasterStringsCollection<TStringKey extends string, TLanguage extends string> = Partial<Record<TLanguage, StringsCollection<TStringKey>>>;
 /**
  * Mapping of language codes to their respective languages
  */
-export type LanguageCodeCollection<TLanguage extends string> = Partial<
-  Record<TLanguage, string>
->;
-
+export type LanguageCodeCollection<TLanguage extends string> = Partial<Record<TLanguage, string>>;
 /**
  * Mapping of enumeration values to their translations in multiple languages
  */
-export type EnumTranslationMap<
-  TEnum extends string | number,
-  TLanguage extends string,
-> = Partial<Record<TLanguage, Partial<Record<TEnum, string>>>>;
-
+export type EnumTranslationMap<TEnum extends string | number, TLanguage extends string> = Partial<Record<TLanguage, Partial<Record<TEnum, string>>>>;
 /**
  * String collection for a specific language and component
  */
 export type ComponentStrings<TStringKeys extends string> = {
-  [K in TStringKeys]: string;
+    [K in TStringKeys]: string;
 };
-
 /**
  * Partial string collection (used during registration before validation)
  */
 export type PartialComponentStrings<TStringKeys extends string> = {
-  [K in TStringKeys]?: string;
+    [K in TStringKeys]?: string;
 };
-
 /**
  * Language strings for a component across all registered languages
  */
-export type ComponentLanguageStrings<
-  TStringKeys extends string,
-  TLanguages extends string,
-> = {
-  [L in TLanguages]: ComponentStrings<TStringKeys>;
+export type ComponentLanguageStrings<TStringKeys extends string, TLanguages extends string> = {
+    [L in TLanguages]: ComponentStrings<TStringKeys>;
 };
-
 /**
  * Partial language strings (used during registration before validation)
  */
-export type PartialComponentLanguageStrings<
-  TStringKeys extends string,
-  TLanguages extends string,
-> = {
-  [L in TLanguages]?: PartialComponentStrings<TStringKeys>;
+export type PartialComponentLanguageStrings<TStringKeys extends string, TLanguages extends string> = {
+    [L in TLanguages]?: PartialComponentStrings<TStringKeys>;
 };
-
 /**
  * Generic translation type for any enumeration
  */
 export type EnumTranslation<T extends string | number> = {
-  [K in T]: string;
+    [K in T]: string;
 };
-
 /**
  * Generic language translation type for any enumeration
  */
-export type EnumLanguageTranslation<
-  T extends string | number,
-  TLanguage extends string = string,
-> = Partial<{
-  [L in TLanguage]: EnumTranslation<T>;
+export type EnumLanguageTranslation<T extends string | number, TLanguage extends string = string> = Partial<{
+    [L in TLanguage]: EnumTranslation<T>;
 }>;
-
 /**
  * Type utility to extract string keys from a component definition
  */
-export type ExtractStringKeys<T> = T extends ComponentDefinition<infer K>
-  ? K
-  : never;
-
+export type ExtractStringKeys<T> = T extends ComponentDefinition<infer K> ? K : never;
 /**
  * Type utility to extract languages from registry
  */
-export type ExtractLanguages<T> = T extends LanguageDefinition
-  ? T['id']
-  : never;
-
+export type ExtractLanguages<T> = T extends LanguageDefinition ? T['id'] : never;
 /**
  * Utility type to ensure all string keys are provided for all languages
  */
-export type CompleteComponentStrings<
-  TStringKeys extends string,
-  TLanguages extends string,
-> = ComponentLanguageStrings<TStringKeys, TLanguages>;
-
+export type CompleteComponentStrings<TStringKeys extends string, TLanguages extends string> = ComponentLanguageStrings<TStringKeys, TLanguages>;
 /**
  * Helper function to create typed translations for an enumeration
  */
-export function createTranslations<
-  T extends string | number,
-  TLanguage extends string,
->(
-  translations: EnumLanguageTranslation<T, TLanguage>,
-): EnumLanguageTranslation<T, TLanguage> {
-  return translations;
-}
+export declare function createTranslations<T extends string | number, TLanguage extends string>(translations: EnumLanguageTranslation<T, TLanguage>): EnumLanguageTranslation<T, TLanguage>;
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

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

package/src/types.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultLanguageCode = exports.DefaultTimezone = exports.DefaultCurrencyCode = void 0;
+exports.createTranslations = createTranslations;
+/**
+ * Default currency code
+ */
+exports.DefaultCurrencyCode = 'USD';
+/**
+ * Default timezone
+ */
+exports.DefaultTimezone = 'UTC';
+/**
+ * Default language code
+ */
+exports.DefaultLanguageCode = 'en-US';
+/**
+ * Helper function to create typed translations for an enumeration
+ */
+function createTranslations(translations) {
+    return translations;
+}
+//# sourceMappingURL=types.js.map

package/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/types.ts"],"names":[],"mappings":";;;AAsIA,gDAOC;AArID;;GAEG;AACU,QAAA,mBAAmB,GAAW,KAAK,CAAC;AAEjD;;GAEG;AACU,QAAA,eAAe,GAAW,KAAK,CAAC;AAE7C;;GAEG;AACU,QAAA,mBAAmB,GAAW,OAAO,CAAC;AA8GnD;;GAEG;AACH,SAAgB,kBAAkB,CAIhC,YAAmD;IAEnD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/src/utils/currency.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Currency utilities (v2)
+ */
+/**
+ * Position of the currency symbol relative to the amount.
+ */
+export type CurrencyPosition = 'prefix' | 'postfix' | 'infix';
+/**
+ * Configuration for formatting currency values in a specific locale.
+ */
+export interface CurrencyFormat {
+    /** The currency symbol (e.g., "$", "€") */
+    symbol: string;
+    /** Position of the symbol relative to the amount */
+    position: CurrencyPosition;
+    /** Character used to separate thousands (e.g., ",") */
+    groupSeparator: string;
+    /** Character used to separate decimal places (e.g., ".") */
+    decimalSeparator: string;
+}
+/**
+ * Detailed information about a currency.
+ */
+export interface CurrencyData {
+    /** ISO 4217 currency code (e.g., "USD") */
+    code: string;
+    /** Numeric currency code */
+    number: string;
+    /** Number of decimal digits */
+    digits: number;
+    /** Currency name */
+    currency: string;
+    /** Countries using this currency */
+    countries: string[];
+}
+/**
+ * Represents a valid ISO 4217 currency code with validation.
+ */
+export declare class CurrencyCode {
+    private _value;
+    /**
+     * Creates a new CurrencyCode instance.
+     * @param value - The ISO 4217 currency code (defaults to 'USD')
+     * @throws {Error} If the currency code is invalid
+     */
+    constructor(value?: string);
+    /**
+     * Gets the currency code value.
+     * @returns The ISO 4217 currency code
+     */
+    get value(): string;
+    /**
+     * Gets the currency code (alias for value).
+     * @returns The ISO 4217 currency code
+     */
+    get code(): string;
+    /**
+     * Checks if a currency code is valid according to ISO 4217.
+     * @param code - The currency code to validate
+     * @returns True if the code is valid, false otherwise
+     */
+    static isValid(code: string): boolean;
+    /**
+     * Gets all valid ISO 4217 currency codes.
+     * @returns Array of currency codes
+     */
+    static getAll(): string[];
+    /**
+     * Gets detailed information for all currencies.
+     * @returns Array of currency data objects
+     */
+    static getAllData(): CurrencyData[];
+}
+/**
+ * Gets the currency formatting rules for a specific locale and currency.
+ * @param locale - The locale code (e.g., 'en-US', 'fr-FR')
+ * @param currencyCode - The ISO 4217 currency code
+ * @returns Currency format configuration including symbol, position, and separators
+ */
+export declare function getCurrencyFormat(locale: string, currencyCode: string): CurrencyFormat;
+//# sourceMappingURL=currency.d.ts.map

package/src/utils/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/currency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,KAAK,GAAE,MAAc;IAOjC;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE;IAIzB;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,YAAY,EAAE;CAGpC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,cAAc,CA8BhB"}

package/src/utils/currency.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Currency utilities (v2)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencyCode = void 0;
+exports.getCurrencyFormat = getCurrencyFormat;
+const currency_codes_1 = require("currency-codes");
+/**
+ * Represents a valid ISO 4217 currency code with validation.
+ */
+class CurrencyCode {
+    _value;
+    /**
+     * Creates a new CurrencyCode instance.
+     * @param value - The ISO 4217 currency code (defaults to 'USD')
+     * @throws {Error} If the currency code is invalid
+     */
+    constructor(value = 'USD') {
+        if (!CurrencyCode.isValid(value)) {
+            throw new Error(`Invalid currency code: ${value}`);
+        }
+        this._value = value;
+    }
+    /**
+     * Gets the currency code value.
+     * @returns The ISO 4217 currency code
+     */
+    get value() {
+        return this._value;
+    }
+    /**
+     * Gets the currency code (alias for value).
+     * @returns The ISO 4217 currency code
+     */
+    get code() {
+        return this._value;
+    }
+    /**
+     * Checks if a currency code is valid according to ISO 4217.
+     * @param code - The currency code to validate
+     * @returns True if the code is valid, false otherwise
+     */
+    static isValid(code) {
+        return (0, currency_codes_1.codes)().includes(code);
+    }
+    /**
+     * Gets all valid ISO 4217 currency codes.
+     * @returns Array of currency codes
+     */
+    static getAll() {
+        return (0, currency_codes_1.codes)();
+    }
+    /**
+     * Gets detailed information for all currencies.
+     * @returns Array of currency data objects
+     */
+    static getAllData() {
+        return currency_codes_1.data;
+    }
+}
+exports.CurrencyCode = CurrencyCode;
+/**
+ * Gets the currency formatting rules for a specific locale and currency.
+ * @param locale - The locale code (e.g., 'en-US', 'fr-FR')
+ * @param currencyCode - The ISO 4217 currency code
+ * @returns Currency format configuration including symbol, position, and separators
+ */
+function getCurrencyFormat(locale, currencyCode) {
+    const formatter = new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency: currencyCode,
+    });
+    const parts = formatter.formatToParts(1234567.89);
+    const symbol = parts.find((part) => part.type === 'currency')?.value || '';
+    const symbolIndex = parts.findIndex((part) => part.type === 'currency');
+    const decimalIndex = parts.findIndex((part) => part.type === 'decimal');
+    const integerIndex = parts.findIndex((part) => part.type === 'integer');
+    let position;
+    if (decimalIndex === -1) {
+        position = symbolIndex < integerIndex ? 'prefix' : 'postfix';
+    }
+    else if (symbolIndex < decimalIndex && symbolIndex < integerIndex) {
+        position = 'prefix';
+    }
+    else if (symbolIndex > decimalIndex) {
+        position = 'postfix';
+    }
+    else {
+        position = 'infix';
+    }
+    return {
+        symbol,
+        position,
+        groupSeparator: parts.find((part) => part.type === 'group')?.value || ',',
+        decimalSeparator: parts.find((part) => part.type === 'decimal')?.value || '.',
+    };
+}
+//# sourceMappingURL=currency.js.map

package/src/utils/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/currency.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyGH,8CAiCC;AAxID,mDAA6C;AAqC7C;;GAEG;AACH,MAAa,YAAY;IACf,MAAM,CAAS;IAEvB;;;;OAIG;IACH,YAAY,QAAgB,KAAK;QAC/B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,OAAO,IAAA,sBAAK,GAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAA,sBAAK,GAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,qBAAsB,CAAC;IAChC,CAAC;CACF;AAvDD,oCAuDC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,MAAc,EACd,YAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QAC9C,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAExE,IAAI,QAA0B,CAAC;IAC/B,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;SAAM,IAAI,WAAW,GAAG,YAAY,IAAI,WAAW,GAAG,YAAY,EAAE,CAAC;QACpE,QAAQ,GAAG,QAAQ,CAAC;IACtB,CAAC;SAAM,IAAI,WAAW,GAAG,YAAY,EAAE,CAAC;QACtC,QAAQ,GAAG,SAAS,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ;QACR,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,KAAK,IAAI,GAAG;QACzE,gBAAgB,EACd,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,KAAK,IAAI,GAAG;KAC9D,CAAC;AACJ,CAAC"}

package/src/utils/html-escape.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTML escaping utilities for XSS prevention
+ */
+/**
+ * Escapes HTML special characters to prevent XSS attacks.
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Safely converts a value to a string, optionally escaping HTML.
+ * Rejects objects to prevent toString exploits.
+ * @param value - The value to stringify
+ * @param options - Options including whether to escape HTML
+ * @param options.escapeHtml - If true, HTML-escapes the result
+ * @returns The stringified value
+ * @throws {Error} If the value is an object (to prevent exploits)
+ */
+export declare function safeStringify(value: any, options?: {
+    escapeHtml?: boolean;
+}): string;
+//# sourceMappingURL=html-escape.d.ts.map

package/src/utils/html-escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-escape.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/html-escape.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAepF"}

package/src/utils/html-escape.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * HTML escaping utilities for XSS prevention
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeHtml = escapeHtml;
+exports.safeStringify = safeStringify;
+/**
+ * Map of HTML characters to their escaped equivalents.
+ */
+const HTML_ESCAPES = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#x27;',
+    '/': '&#x2F;',
+};
+/**
+ * Regular expression to match characters that need HTML escaping.
+ */
+const HTML_ESCAPE_REGEX = /[&<>"'/]/g;
+/**
+ * Escapes HTML special characters to prevent XSS attacks.
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+function escapeHtml(str) {
+    return str.replace(HTML_ESCAPE_REGEX, char => HTML_ESCAPES[char]);
+}
+/**
+ * Safely converts a value to a string, optionally escaping HTML.
+ * Rejects objects to prevent toString exploits.
+ * @param value - The value to stringify
+ * @param options - Options including whether to escape HTML
+ * @param options.escapeHtml - If true, HTML-escapes the result
+ * @returns The stringified value
+ * @throws {Error} If the value is an object (to prevent exploits)
+ */
+function safeStringify(value, options) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return options?.escapeHtml ? escapeHtml(value) : value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    // Reject objects to prevent toString exploits
+    throw new Error('Invalid value type for stringification');
+}
+//# sourceMappingURL=html-escape.js.map

package/src/utils/html-escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-escape.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/html-escape.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAwBH,gCAEC;AAWD,sCAeC;AAlDD;;GAEG;AACH,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAEtC;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,KAAU,EAAE,OAAkC;IAC1E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,8CAA8C;IAC9C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC5D,CAAC"}

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

@@ -6,3 +6,4 @@ export * from './timezone';
 export * from './validation';
 export * from './html-escape';
 export * from './lru-cache';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/src/utils/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./plural-helpers"), exports);
+tslib_1.__exportStar(require("./safe-object"), exports);
+tslib_1.__exportStar(require("./string-utils"), exports);
+tslib_1.__exportStar(require("./currency"), exports);
+tslib_1.__exportStar(require("./timezone"), exports);
+tslib_1.__exportStar(require("./validation"), exports);
+tslib_1.__exportStar(require("./html-escape"), exports);
+tslib_1.__exportStar(require("./lru-cache"), exports);
+//# sourceMappingURL=index.js.map

package/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,wDAA8B;AAC9B,yDAA+B;AAC/B,qDAA2B;AAC3B,qDAA2B;AAC3B,uDAA6B;AAC7B,wDAA8B;AAC9B,sDAA4B"}

package/src/utils/lru-cache.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Simple LRU Cache implementation for security
+ */
+/**
+ * Least Recently Used (LRU) cache implementation.
+ * Automatically evicts the oldest entries when the cache reaches maximum size.
+ * @template K - The type of cache keys
+ * @template V - The type of cached values
+ */
+export declare class LRUCache<K, V> {
+    private cache;
+    private readonly maxSize;
+    /**
+     * Creates a new LRUCache instance.
+     * @param maxSize - Maximum number of entries to store (default: 1000)
+     */
+    constructor(maxSize?: number);
+    /**
+     * Retrieves a value from the cache by key.
+     * Accessing an item moves it to the end (marks it as most recently used).
+     * @param key - The key to look up
+     * @returns The cached value, or undefined if not found
+     */
+    get(key: K): V | undefined;
+    /**
+     * Adds or updates a value in the cache.
+     * If the cache is at capacity, the oldest entry is removed.
+     * @param key - The key to store
+     * @param value - The value to cache
+     */
+    set(key: K, value: V): void;
+    /**
+     * Removes all entries from the cache.
+     */
+    clear(): void;
+    /**
+     * Gets the current number of entries in the cache.
+     * @returns The number of cached entries
+     */
+    size(): number;
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/src/utils/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/lru-cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;OAGG;gBACS,OAAO,GAAE,MAAa;IAIlC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAU1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAiB3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/src/utils/lru-cache.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Simple LRU Cache implementation for security
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+/**
+ * Least Recently Used (LRU) cache implementation.
+ * Automatically evicts the oldest entries when the cache reaches maximum size.
+ * @template K - The type of cache keys
+ * @template V - The type of cached values
+ */
+class LRUCache {
+    cache = new Map();
+    maxSize;
+    /**
+     * Creates a new LRUCache instance.
+     * @param maxSize - Maximum number of entries to store (default: 1000)
+     */
+    constructor(maxSize = 1000) {
+        this.maxSize = maxSize;
+    }
+    /**
+     * Retrieves a value from the cache by key.
+     * Accessing an item moves it to the end (marks it as most recently used).
+     * @param key - The key to look up
+     * @returns The cached value, or undefined if not found
+     */
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move to end (most recently used)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    /**
+     * Adds or updates a value in the cache.
+     * If the cache is at capacity, the oldest entry is removed.
+     * @param key - The key to store
+     * @param value - The value to cache
+     */
+    set(key, value) {
+        // Remove if exists to update position
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        // Remove oldest if at capacity
+        if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    /**
+     * Removes all entries from the cache.
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Gets the current number of entries in the cache.
+     * @returns The number of cached entries
+     */
+    size() {
+        return this.cache.size;
+    }
+}
+exports.LRUCache = LRUCache;
+//# sourceMappingURL=lru-cache.js.map

package/src/utils/lru-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/lru-cache.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;;;;GAKG;AACH,MAAa,QAAQ;IACX,KAAK,GAAG,IAAI,GAAG,EAAQ,CAAC;IACf,OAAO,CAAS;IAEjC;;;OAGG;IACH,YAAY,UAAkB,IAAI;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,mCAAmC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,sCAAsC;QACtC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAjED,4BAiEC"}