@digitaldefiance/i18n-lib 3.8.2 → 3.8.4

package/src/utils/{plural-helpers.ts → plural-helpers.d.ts}

@@ -1,36 +1,26 @@
 /**
  * Helper functions for creating plural and gender strings
  */
-
 import { PluralCategory } from '../pluralization/plural-categories';
 import { PluralString } from '../types/plural-types';
 import { GenderCategory, GenderedString } from '../gender/gender-categories';
-import { getRequiredPluralForms as getRequiredFormsFromMap } from '../pluralization/language-plural-map';
-
 /**
  * Creates a PluralString from a partial record of plural forms.
  * @param forms - Object mapping plural categories to their string forms
  * @returns A PluralString that can be used in translations
  */
-export function createPluralString(forms: Partial<Record<PluralCategory, string>>): PluralString {
-  return forms;
-}
-
+export declare function createPluralString(forms: Partial<Record<PluralCategory, string>>): PluralString;
 /**
  * Creates a GenderedString from a partial record of gender forms.
  * @param forms - Object mapping gender categories to their string forms
  * @returns A GenderedString that can be used in translations
  */
-export function createGenderedString(forms: Partial<Record<GenderCategory, string>>): GenderedString {
-  return forms;
-}
-
+export declare function createGenderedString(forms: Partial<Record<GenderCategory, string>>): GenderedString;
 /**
  * Gets the required plural forms for a given language.
  * Different languages have different plural rules and require different forms.
  * @param language - The language code
  * @returns Array of plural categories required for the language
  */
-export function getRequiredPluralForms(language: string): PluralCategory[] {
-  return getRequiredFormsFromMap(language) as PluralCategory[];
-}
+export declare function getRequiredPluralForms(language: string): PluralCategory[];
+//# sourceMappingURL=plural-helpers.d.ts.map

package/src/utils/plural-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural-helpers.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/plural-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG,YAAY,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG,cAAc,CAEnG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAEzE"}

package/src/utils/plural-helpers.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Helper functions for creating plural and gender strings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPluralString = createPluralString;
+exports.createGenderedString = createGenderedString;
+exports.getRequiredPluralForms = getRequiredPluralForms;
+const language_plural_map_1 = require("../pluralization/language-plural-map");
+/**
+ * Creates a PluralString from a partial record of plural forms.
+ * @param forms - Object mapping plural categories to their string forms
+ * @returns A PluralString that can be used in translations
+ */
+function createPluralString(forms) {
+    return forms;
+}
+/**
+ * Creates a GenderedString from a partial record of gender forms.
+ * @param forms - Object mapping gender categories to their string forms
+ * @returns A GenderedString that can be used in translations
+ */
+function createGenderedString(forms) {
+    return forms;
+}
+/**
+ * Gets the required plural forms for a given language.
+ * Different languages have different plural rules and require different forms.
+ * @param language - The language code
+ * @returns Array of plural categories required for the language
+ */
+function getRequiredPluralForms(language) {
+    return (0, language_plural_map_1.getRequiredPluralForms)(language);
+}
+//# sourceMappingURL=plural-helpers.js.map

package/src/utils/plural-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural-helpers.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/plural-helpers.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,gDAEC;AAOD,oDAEC;AAQD,wDAEC;AA5BD,8EAAyG;AAEzG;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAA8C;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,KAA8C;IACjF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,QAAgB;IACrD,OAAO,IAAA,4CAAuB,EAAC,QAAQ,CAAqB,CAAC;AAC/D,CAAC"}

package/src/utils/safe-object.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Safe object utilities to prevent prototype pollution
+ */
+/**
+ * Creates a safe object without a prototype chain.
+ * This prevents prototype pollution attacks.
+ * @template T - The type of values in the object
+ * @returns A new object without a prototype
+ */
+export declare function createSafeObject<T = any>(): Record<string, T>;
+/**
+ * Checks if a key is in the list of dangerous keys that could enable prototype pollution.
+ * @param key - The key to check
+ * @returns True if the key is dangerous, false otherwise
+ */
+export declare function isDangerousKey(key: string): boolean;
+/**
+ * Safely assigns properties from source objects to a target object.
+ * Filters out dangerous keys to prevent prototype pollution.
+ * @template T - The type of the target object
+ * @param target - The target object to assign to
+ * @param sources - One or more source objects to copy properties from
+ * @returns The target object with properties assigned
+ */
+export declare function safeAssign<T extends Record<string, any>>(target: T, ...sources: Array<Record<string, any> | undefined>): T;
+/**
+ * Gets key-value pairs from an object, filtering out dangerous keys.
+ * @template T - The type of values in the object
+ * @param obj - The object to get entries from
+ * @returns Array of [key, value] pairs, excluding dangerous keys
+ */
+export declare function safeObjectEntries<T>(obj: Record<string, T>): Array<[string, T]>;
+/**
+ * Validates that an object does not contain dangerous keys.
+ * @param obj - The object to validate
+ * @throws {Error} If a dangerous key is detected
+ */
+export declare function validateObjectKeys(obj: Record<string, any>): void;
+//# sourceMappingURL=safe-object.d.ts.map

package/src/utils/safe-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-object.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/safe-object.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,MAAM,EAAE,CAAC,EACT,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,GACjD,CAAC,CAYH;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GACrB,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAEpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAUjE"}

package/src/utils/{safe-object.ts → safe-object.js}

@@ -1,31 +1,34 @@
+"use strict";
 /**
  * Safe object utilities to prevent prototype pollution
  */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSafeObject = createSafeObject;
+exports.isDangerousKey = isDangerousKey;
+exports.safeAssign = safeAssign;
+exports.safeObjectEntries = safeObjectEntries;
+exports.validateObjectKeys = validateObjectKeys;
 /**
  * List of dangerous keys that should never be set on objects to prevent prototype pollution.
  */
 const DANGEROUS_KEYS = ['__proto__', 'constructor', 'prototype'];
-
 /**
  * Creates a safe object without a prototype chain.
  * This prevents prototype pollution attacks.
  * @template T - The type of values in the object
  * @returns A new object without a prototype
  */
-export function createSafeObject<T = any>(): Record<string, T> {
-  return Object.create(null);
+function createSafeObject() {
+    return Object.create(null);
 }
-
 /**
  * Checks if a key is in the list of dangerous keys that could enable prototype pollution.
  * @param key - The key to check
  * @returns True if the key is dangerous, false otherwise
  */
-export function isDangerousKey(key: string): boolean {
-  return DANGEROUS_KEYS.includes(key);
+function isDangerousKey(key) {
+    return DANGEROUS_KEYS.includes(key);
 }
-
 /**
  * Safely assigns properties from source objects to a target object.
  * Filters out dangerous keys to prevent prototype pollution.
@@ -34,48 +37,42 @@ export function isDangerousKey(key: string): boolean {
  * @param sources - One or more source objects to copy properties from
  * @returns The target object with properties assigned
  */
-export function safeAssign<T extends Record<string, any>>(
-  target: T,
-  ...sources: Array<Record<string, any> | undefined>
-): T {
-  for (const source of sources) {
-    if (!source) continue;
-
-    for (const key of Object.keys(source)) {
-      if (!isDangerousKey(key)) {
-        // Type-safe property assignment using index signature
-        (target as Record<string, any>)[key] = source[key];
-      }
+function safeAssign(target, ...sources) {
+    for (const source of sources) {
+        if (!source)
+            continue;
+        for (const key of Object.keys(source)) {
+            if (!isDangerousKey(key)) {
+                // Type-safe property assignment using index signature
+                target[key] = source[key];
+            }
+        }
     }
-  }
-  return target;
+    return target;
 }
-
 /**
  * Gets key-value pairs from an object, filtering out dangerous keys.
  * @template T - The type of values in the object
  * @param obj - The object to get entries from
  * @returns Array of [key, value] pairs, excluding dangerous keys
  */
-export function safeObjectEntries<T>(
-  obj: Record<string, T>,
-): Array<[string, T]> {
-  return Object.entries(obj).filter(([key]) => !isDangerousKey(key));
+function safeObjectEntries(obj) {
+    return Object.entries(obj).filter(([key]) => !isDangerousKey(key));
 }
-
 /**
  * Validates that an object does not contain dangerous keys.
  * @param obj - The object to validate
  * @throws {Error} If a dangerous key is detected
  */
-export function validateObjectKeys(obj: Record<string, any>): void {
-  if (!obj || typeof obj !== 'object') return;
-
-  // Check for dangerous keys in Object.keys and getOwnPropertyNames
-  const allKeys = [...Object.keys(obj), ...Object.getOwnPropertyNames(obj)];
-  for (const key of allKeys) {
-    if (DANGEROUS_KEYS.includes(key)) {
-      throw new Error(`Dangerous key detected: ${key}`);
+function validateObjectKeys(obj) {
+    if (!obj || typeof obj !== 'object')
+        return;
+    // Check for dangerous keys in Object.keys and getOwnPropertyNames
+    const allKeys = [...Object.keys(obj), ...Object.getOwnPropertyNames(obj)];
+    for (const key of allKeys) {
+        if (DANGEROUS_KEYS.includes(key)) {
+            throw new Error(`Dangerous key detected: ${key}`);
+        }
     }
-  }
 }
+//# sourceMappingURL=safe-object.js.map

package/src/utils/safe-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-object.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/safe-object.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,4CAEC;AAOD,wCAEC;AAUD,gCAeC;AAQD,8CAIC;AAOD,gDAUC;AA5ED;;GAEG;AACH,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CACxB,MAAS,EACT,GAAG,OAA+C;IAElD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,sDAAsD;gBACrD,MAA8B,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,GAAsB;IAEtB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,GAAwB;IACzD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO;IAE5C,kEAAkE;IAClE,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC"}

package/src/utils/string-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * String utility functions
+ */
+/**
+ * Options for the replaceVariables function.
+ */
+export interface ReplaceVariablesOptions {
+    /** If true, HTML-escapes the replaced values */
+    escapeHtml?: boolean;
+}
+/**
+ * Replaces variables in a string template with values from vars or constants.
+ * Variables are denoted by {variableName} in the template string.
+ * @param str - The template string containing variables
+ * @param vars - Optional object mapping variable names to values
+ * @param constants - Optional object containing constant values
+ * @param options - Optional configuration including HTML escaping
+ * @returns The string with variables replaced
+ */
+export declare function replaceVariables(str: string, vars?: Record<string, any>, constants?: Record<string, any>, options?: ReplaceVariablesOptions): string;
+/**
+ * Checks if a string key indicates a template that expects variable replacement.
+ * Template keys end with 'template' (case-insensitive).
+ * @param key - The key to check
+ * @returns True if the key indicates a template, false otherwise
+ */
+export declare function isTemplate(key: string): boolean;
+//# sourceMappingURL=string-utils.d.ts.map

package/src/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,OAAO,CAAC,EAAE,uBAAuB,GAChC,MAAM,CAyBR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C"}

package/src/utils/string-utils.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * String utility functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceVariables = replaceVariables;
+exports.isTemplate = isTemplate;
+const html_escape_1 = require("./html-escape");
+/**
+ * Extract the actual value from an object that might be a wrapper (CurrencyCode, Timezone, etc.).
+ * @param value - The value to extract from
+ * @returns The extracted value or the original value if not a wrapper
+ */
+function extractValue(value) {
+    // Handle objects with a 'value' property (CurrencyCode, Timezone, etc.)
+    if (value && typeof value === 'object' && 'value' in value && typeof value.value !== 'function') {
+        return value.value;
+    }
+    return value;
+}
+/**
+ * Replaces variables in a string template with values from vars or constants.
+ * Variables are denoted by {variableName} in the template string.
+ * @param str - The template string containing variables
+ * @param vars - Optional object mapping variable names to values
+ * @param constants - Optional object containing constant values
+ * @param options - Optional configuration including HTML escaping
+ * @returns The string with variables replaced
+ */
+function replaceVariables(str, vars, constants, options) {
+    if (typeof str !== 'string') {
+        str = String(str);
+    }
+    const variables = str.match(/\{(.+?)\}/g);
+    if (!variables)
+        return str;
+    let result = str;
+    for (const variable of variables) {
+        const varName = variable.slice(1, -1);
+        let replacement = '';
+        if (vars && varName in vars) {
+            const value = extractValue(vars[varName]);
+            replacement = (0, html_escape_1.safeStringify)(value, options);
+            result = result.replace(variable, replacement);
+        }
+        else if (constants && varName in constants) {
+            const value = extractValue(constants[varName]);
+            replacement = (0, html_escape_1.safeStringify)(value, options);
+            result = result.replace(variable, replacement);
+        }
+    }
+    return result;
+}
+/**
+ * Checks if a string key indicates a template that expects variable replacement.
+ * Template keys end with 'template' (case-insensitive).
+ * @param key - The key to check
+ * @returns True if the key indicates a template, false otherwise
+ */
+function isTemplate(key) {
+    return key.trim().toLowerCase().endsWith('template');
+}
+//# sourceMappingURL=string-utils.js.map

package/src/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/string-utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAkCH,4CA8BC;AAQD,gCAEC;AAxED,+CAA0D;AAE1D;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAU;IAC9B,wEAAwE;IACxE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAChG,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAUD;;;;;;;;GAQG;AACH,SAAgB,gBAAgB,CAC9B,GAAW,EACX,IAA0B,EAC1B,SAA+B,EAC/B,OAAiC;IAEjC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC;IAE3B,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,WAAW,GAAG,EAAE,CAAC;QAErB,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1C,WAAW,GAAG,IAAA,2BAAa,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,SAAS,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,WAAW,GAAG,IAAA,2BAAa,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC"}

package/src/utils/timezone.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Timezone utilities (v2)
+ */
+/**
+ * Represents a valid timezone with validation.
+ * Uses moment-timezone for validation and timezone database.
+ */
+export declare class Timezone {
+    private readonly _value;
+    /**
+     * Creates a new Timezone instance.
+     * @param timezone - The timezone name (e.g., 'America/New_York', 'UTC')
+     * @throws {Error} If the timezone is invalid
+     */
+    constructor(timezone: string);
+    /**
+     * Gets the timezone name.
+     * @returns The timezone name
+     */
+    get value(): string;
+    /**
+     * Gets the timezone name (alias for value).
+     * @returns The timezone name
+     */
+    get name(): string;
+    /**
+     * Checks if a timezone name is valid.
+     * @param timezone - The timezone name to validate
+     * @returns True if the timezone is valid, false otherwise
+     */
+    static isValid(timezone: string): boolean;
+    /**
+     * Gets all available timezone names.
+     * @returns Array of timezone names
+     */
+    static getAll(): string[];
+    /**
+     * Attempts to guess the user's timezone based on their system settings.
+     * @returns The guessed timezone name
+     */
+    static guess(): string;
+}
+/**
+ * Checks if a timezone name is valid.
+ * This is a convenience function that delegates to Timezone.isValid().
+ * @param timezone - The timezone name to validate
+ * @returns True if the timezone is valid, false otherwise
+ */
+export declare function isValidTimezone(timezone: string): boolean;
+//# sourceMappingURL=timezone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/timezone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;OAIG;gBACS,QAAQ,EAAE,MAAM;IAO5B;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE;IAIzB;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,MAAM;CAGvB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/src/utils/timezone.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Timezone utilities (v2)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timezone = void 0;
+exports.isValidTimezone = isValidTimezone;
+const tslib_1 = require("tslib");
+const moment_timezone_1 = tslib_1.__importDefault(require("moment-timezone"));
+/**
+ * Represents a valid timezone with validation.
+ * Uses moment-timezone for validation and timezone database.
+ */
+class Timezone {
+    _value;
+    /**
+     * Creates a new Timezone instance.
+     * @param timezone - The timezone name (e.g., 'America/New_York', 'UTC')
+     * @throws {Error} If the timezone is invalid
+     */
+    constructor(timezone) {
+        if (!Timezone.isValid(timezone)) {
+            throw new Error(`Invalid timezone: ${timezone}`);
+        }
+        this._value = timezone;
+    }
+    /**
+     * Gets the timezone name.
+     * @returns The timezone name
+     */
+    get value() {
+        return this._value;
+    }
+    /**
+     * Gets the timezone name (alias for value).
+     * @returns The timezone name
+     */
+    get name() {
+        return this._value;
+    }
+    /**
+     * Checks if a timezone name is valid.
+     * @param timezone - The timezone name to validate
+     * @returns True if the timezone is valid, false otherwise
+     */
+    static isValid(timezone) {
+        return moment_timezone_1.default.tz.zone(timezone) !== null;
+    }
+    /**
+     * Gets all available timezone names.
+     * @returns Array of timezone names
+     */
+    static getAll() {
+        return moment_timezone_1.default.tz.names();
+    }
+    /**
+     * Attempts to guess the user's timezone based on their system settings.
+     * @returns The guessed timezone name
+     */
+    static guess() {
+        return moment_timezone_1.default.tz.guess();
+    }
+}
+exports.Timezone = Timezone;
+/**
+ * Checks if a timezone name is valid.
+ * This is a convenience function that delegates to Timezone.isValid().
+ * @param timezone - The timezone name to validate
+ * @returns True if the timezone is valid, false otherwise
+ */
+function isValidTimezone(timezone) {
+    return Timezone.isValid(timezone);
+}
+//# sourceMappingURL=timezone.js.map

package/src/utils/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/timezone.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAuEH,0CAEC;;AAvED,8EAAqC;AAErC;;;GAGG;AACH,MAAa,QAAQ;IACF,MAAM,CAAS;IAEhC;;;;OAIG;IACH,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,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,QAAgB;QAC7B,OAAO,yBAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,yBAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK;QACV,OAAO,yBAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAvDD,4BAuDC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/src/utils/validation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Input validation utilities
+ */
+/**
+ * Security limits for various input types to prevent abuse.
+ */
+export declare const LIMITS: {
+    readonly MAX_TEMPLATE_LENGTH: 10000;
+    readonly MAX_KEY_LENGTH: 200;
+    readonly MAX_COMPONENT_ID_LENGTH: 100;
+    readonly MAX_LANGUAGE_CODE_LENGTH: 10;
+    readonly MAX_NESTING_DEPTH: 10;
+};
+/**
+ * Validates that a template string does not exceed the maximum allowed length.
+ * @param template - The template string to validate
+ * @throws {Error} If the template exceeds the maximum length
+ */
+export declare function validateTemplateLength(template: string): void;
+/**
+ * Validates that a key does not exceed the maximum allowed length.
+ * @param key - The key to validate
+ * @throws {Error} If the key exceeds the maximum length
+ */
+export declare function validateKeyLength(key: string): void;
+/**
+ * Validates that a component ID meets length and character requirements.
+ * Component IDs must contain only alphanumeric characters, underscores, and hyphens.
+ * @param componentId - The component ID to validate
+ * @throws {Error} If the component ID is invalid
+ */
+export declare function validateComponentId(componentId: string): void;
+/**
+ * Validates that a language code meets BCP 47 format requirements.
+ * Expected format: two lowercase letters, optionally followed by a hyphen and two uppercase letters (e.g., 'en', 'en-US').
+ * @param language - The language code to validate
+ * @throws {Error} If the language code is invalid
+ */
+export declare function validateLanguageCode(language: string): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAInD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAO7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO3D"}

package/src/utils/validation.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Input validation utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIMITS = void 0;
+exports.validateTemplateLength = validateTemplateLength;
+exports.validateKeyLength = validateKeyLength;
+exports.validateComponentId = validateComponentId;
+exports.validateLanguageCode = validateLanguageCode;
+/**
+ * Security limits for various input types to prevent abuse.
+ */
+exports.LIMITS = {
+    MAX_TEMPLATE_LENGTH: 10000,
+    MAX_KEY_LENGTH: 200,
+    MAX_COMPONENT_ID_LENGTH: 100,
+    MAX_LANGUAGE_CODE_LENGTH: 10,
+    MAX_NESTING_DEPTH: 10,
+};
+/**
+ * Validates that a template string does not exceed the maximum allowed length.
+ * @param template - The template string to validate
+ * @throws {Error} If the template exceeds the maximum length
+ */
+function validateTemplateLength(template) {
+    if (template.length > exports.LIMITS.MAX_TEMPLATE_LENGTH) {
+        throw new Error(`Template exceeds maximum length of ${exports.LIMITS.MAX_TEMPLATE_LENGTH}`);
+    }
+}
+/**
+ * Validates that a key does not exceed the maximum allowed length.
+ * @param key - The key to validate
+ * @throws {Error} If the key exceeds the maximum length
+ */
+function validateKeyLength(key) {
+    if (key.length > exports.LIMITS.MAX_KEY_LENGTH) {
+        throw new Error(`Key exceeds maximum length of ${exports.LIMITS.MAX_KEY_LENGTH}`);
+    }
+}
+/**
+ * Validates that a component ID meets length and character requirements.
+ * Component IDs must contain only alphanumeric characters, underscores, and hyphens.
+ * @param componentId - The component ID to validate
+ * @throws {Error} If the component ID is invalid
+ */
+function validateComponentId(componentId) {
+    if (componentId.length > exports.LIMITS.MAX_COMPONENT_ID_LENGTH) {
+        throw new Error(`Component ID exceeds maximum length of ${exports.LIMITS.MAX_COMPONENT_ID_LENGTH}`);
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(componentId)) {
+        throw new Error('Component ID contains invalid characters');
+    }
+}
+/**
+ * Validates that a language code meets BCP 47 format requirements.
+ * Expected format: two lowercase letters, optionally followed by a hyphen and two uppercase letters (e.g., 'en', 'en-US').
+ * @param language - The language code to validate
+ * @throws {Error} If the language code is invalid
+ */
+function validateLanguageCode(language) {
+    if (language.length > exports.LIMITS.MAX_LANGUAGE_CODE_LENGTH) {
+        throw new Error(`Language code exceeds maximum length of ${exports.LIMITS.MAX_LANGUAGE_CODE_LENGTH}`);
+    }
+    if (!/^[a-z]{2}(-[A-Z]{2})?$/.test(language)) {
+        throw new Error('Invalid language code format');
+    }
+}
+//# sourceMappingURL=validation.js.map

package/src/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/utils/validation.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAkBH,wDAIC;AAOD,8CAIC;AAQD,kDAOC;AAQD,oDAOC;AA7DD;;GAEG;AACU,QAAA,MAAM,GAAG;IACpB,mBAAmB,EAAE,KAAK;IAC1B,cAAc,EAAE,GAAG;IACnB,uBAAuB,EAAE,GAAG;IAC5B,wBAAwB,EAAE,EAAE;IAC5B,iBAAiB,EAAE,EAAE;CACb,CAAC;AAEX;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,QAAgB;IACrD,IAAI,QAAQ,CAAC,MAAM,GAAG,cAAM,CAAC,mBAAmB,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,sCAAsC,cAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAW;IAC3C,IAAI,GAAG,CAAC,MAAM,GAAG,cAAM,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,cAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,IAAI,WAAW,CAAC,MAAM,GAAG,cAAM,CAAC,uBAAuB,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,0CAA0C,cAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,cAAM,CAAC,wBAAwB,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,2CAA2C,cAAM,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}