@digitaldefiance/i18n-lib 3.8.1 → 3.8.3

package/src/utils.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Replaces variables in a string with their corresponding values from vars or constants.
+ * @param str - The string containing variables to replace
+ * @param vars - An object mapping variable names to their replacement values
+ * @param constants - An object containing constant values for replacement
+ * @returns The string with variables replaced
+ */
+export declare function replaceVariables(str: string, vars?: Record<string, string | number>, constants?: any): string;
+/**
+ * Checks if a given key indicates a template string.
+ * @param key - The key to check
+ * @returns True if the key indicates a template, false otherwise
+ */
+export declare function isTemplate(key: string): boolean;
+/**
+ * Checks if a given timezone string is valid.
+ * @param timezone - The timezone string to validate
+ * @returns
+ */
+export declare function isValidTimezone(timezone: string): boolean;
+/**
+ * Converts parts to a single string key, joining with underscores.
+ * @param parts - The parts to join
+ * @returns The joined string key
+ */
+export declare function toStringKey<TStringKey extends string>(...parts: string[]): TStringKey;
+/**
+ * Converts an enum value to a string key by joining parts with underscores and appending the enum value.
+ * @param value - The enum value
+ * @param parts - Additional parts to join
+ * @returns The constructed string key
+ */
+export declare function toStringKeyFromEnum<TStringKey extends string>(value: string, ...parts: string[]): TStringKey;
+/**
+ * Type that constructs string keys from enum values with prefixes and optional template suffix
+ */
+type BuildStringKey<TEnumValue extends string, TPrefixes extends readonly string[], TIsTemplate extends boolean = false> = TPrefixes extends readonly [] ? `${TEnumValue}${TIsTemplate extends true ? 'Template' : ''}` : TPrefixes extends readonly [infer First, ...infer Rest] ? First extends string ? Rest extends readonly string[] ? `${First}_${BuildStringKey<TEnumValue, Rest, TIsTemplate>}` : never : never : never;
+/**
+ * Type that maps all enum values to their corresponding string keys
+ */
+type ReasonMapFromEnum<TEnum extends Record<string, string>, TStringKey extends string, TPrefixes extends readonly string[] = [], TTemplateKeys extends Set<TEnum[keyof TEnum]> = never> = {
+    [K in TEnum[keyof TEnum]]: BuildStringKey<K, TPrefixes, TTemplateKeys extends Set<K> ? true : false> extends TStringKey ? BuildStringKey<K, TPrefixes, TTemplateKeys extends Set<K> ? true : false> : never;
+};
+/**
+ * Builds a reason map from an enum object, mapping each enum value to a string key.
+ * @param enumObj - The enum object
+ * @param prefixes - Prefixes to prepend to each string key
+ * @param templateKeys - Optional set of enum values that should have 'Template' suffix for template processing
+ * @returns The constructed reason map
+ */
+export declare function buildReasonMap<TEnum extends Record<string, string>, TStringKey extends string>(enumObj: TEnum, prefixes?: string[], templateKeys?: Set<TEnum[keyof TEnum]>): Record<TEnum[keyof TEnum], TStringKey>;
+/**
+ * Type-safe version of buildReasonMap that ensures all enum values are mapped and all string keys exist
+ */
+export declare function buildTypeSafeReasonMap<TEnum extends Record<string, string>, TStringKey extends string, TPrefixes extends readonly string[] = [], TTemplateKeys extends Set<TEnum[keyof TEnum]> = never>(enumObj: TEnum, prefixes: TPrefixes, templateKeys?: TTemplateKeys): ReasonMapFromEnum<TEnum, TStringKey, TPrefixes, TTemplateKeys>;
+/**
+ * Validates that a reason map has entries for all enum values
+ */
+export declare function validateReasonMap<TEnum extends Record<string, string>, TStringKey extends string>(enumObj: TEnum, reasonMap: Partial<Record<TEnum[keyof TEnum], TStringKey>>): reasonMap is Record<TEnum[keyof TEnum], TStringKey>;
+/**
+ * Creates a complete reason map ensuring all enum values are covered
+ */
+export declare function createCompleteReasonMap<TEnum extends Record<string, string>, TStringKey extends string>(enumObj: TEnum, prefixes?: readonly string[], templateKeys?: Set<TEnum[keyof TEnum]>): Record<TEnum[keyof TEnum], TStringKey>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/src/utils.d.ts.map

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

package/src/utils.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceVariables = replaceVariables;
+exports.isTemplate = isTemplate;
+exports.isValidTimezone = isValidTimezone;
+exports.toStringKey = toStringKey;
+exports.toStringKeyFromEnum = toStringKeyFromEnum;
+exports.buildReasonMap = buildReasonMap;
+exports.buildTypeSafeReasonMap = buildTypeSafeReasonMap;
+exports.validateReasonMap = validateReasonMap;
+exports.createCompleteReasonMap = createCompleteReasonMap;
+const tslib_1 = require("tslib");
+const moment_timezone_1 = tslib_1.__importDefault(require("moment-timezone"));
+/**
+ * Replaces variables in a string with their corresponding values from vars or constants.
+ * @param str - The string containing variables to replace
+ * @param vars - An object mapping variable names to their replacement values
+ * @param constants - An object containing constant values for replacement
+ * @returns The string with variables replaced
+ */
+function replaceVariables(str, vars, constants) {
+    // Ensure input is a string
+    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) {
+            replacement = String(vars[varName]);
+        }
+        else if (constants && varName in constants) {
+            replacement = String(constants[varName]);
+        }
+        if (replacement) {
+            result = result.replace(variable, replacement);
+        }
+    }
+    return result;
+}
+/**
+ * Checks if a given key indicates a template string.
+ * @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');
+}
+/**
+ * Checks if a given timezone string is valid.
+ * @param timezone - The timezone string to validate
+ * @returns
+ */
+function isValidTimezone(timezone) {
+    return moment_timezone_1.default.tz.zone(timezone) !== null;
+}
+/**
+ * Converts parts to a single string key, joining with underscores.
+ * @param parts - The parts to join
+ * @returns The joined string key
+ */
+function toStringKey(...parts) {
+    return parts.join('_');
+}
+/**
+ * Converts an enum value to a string key by joining parts with underscores and appending the enum value.
+ * @param value - The enum value
+ * @param parts - Additional parts to join
+ * @returns The constructed string key
+ */
+function toStringKeyFromEnum(value, ...parts) {
+    const allParts = [...parts, value];
+    return allParts.join('_');
+}
+/**
+ * Builds a reason map from an enum object, mapping each enum value to a string key.
+ * @param enumObj - The enum object
+ * @param prefixes - Prefixes to prepend to each string key
+ * @param templateKeys - Optional set of enum values that should have 'Template' suffix for template processing
+ * @returns The constructed reason map
+ */
+function buildReasonMap(enumObj, prefixes = [], templateKeys) {
+    const map = {};
+    Object.values(enumObj).forEach((value) => {
+        const baseKey = [...prefixes, value].join('_');
+        const finalKey = templateKeys?.has(value)
+            ? baseKey + 'Template'
+            : baseKey;
+        map[value] = finalKey;
+    });
+    return map;
+}
+/**
+ * Type-safe version of buildReasonMap that ensures all enum values are mapped and all string keys exist
+ */
+function buildTypeSafeReasonMap(enumObj, prefixes, templateKeys) {
+    const map = {};
+    Object.values(enumObj).forEach((value) => {
+        const baseKey = [...prefixes, value].join('_');
+        const finalKey = templateKeys?.has(value)
+            ? baseKey + 'Template'
+            : baseKey;
+        map[value] = finalKey;
+    });
+    return map;
+}
+/**
+ * Validates that a reason map has entries for all enum values
+ */
+function validateReasonMap(enumObj, reasonMap) {
+    return Object.values(enumObj).every((value) => value in reasonMap &&
+        reasonMap[value] !== undefined);
+}
+/**
+ * Creates a complete reason map ensuring all enum values are covered
+ */
+function createCompleteReasonMap(enumObj, prefixes = [], templateKeys) {
+    const map = buildReasonMap(enumObj, [...prefixes], templateKeys);
+    if (!validateReasonMap(enumObj, map)) {
+        const missing = Object.values(enumObj).filter((value) => !(value in map));
+        throw new Error(`Missing reason map entries for: ${missing.join(', ')}`);
+    }
+    return map;
+}
+//# sourceMappingURL=utils.js.map

package/src/utils.js.map

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

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

@@ -1 +1,2 @@
 export * from './plural-validator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/src/validation/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./plural-validator"), exports);
+//# sourceMappingURL=index.js.map

package/src/validation/index.js.map

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

package/src/validation/plural-validator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Plural form validation
+ */
+import { PluralString } from '../types/plural-types';
+/**
+ * Result of validating plural forms.
+ */
+export interface PluralValidationResult {
+    /** Whether the validation passed */
+    isValid: boolean;
+    /** Array of validation errors */
+    errors: string[];
+    /** Array of validation warnings */
+    warnings: string[];
+}
+/**
+ * Options for plural form validation.
+ */
+export interface PluralValidationOptions {
+    /** If true, treat missing required forms as errors instead of warnings */
+    strict?: boolean;
+    /** If true, warn about unused plural forms */
+    checkUnused?: boolean;
+    /** If true, check for consistent variable usage across forms */
+    checkVariables?: boolean;
+}
+/**
+ * Validate plural forms for a specific language.
+ * Checks that all required plural forms are present and optionally validates variable consistency.
+ * @param value - The plural string value to validate
+ * @param language - The language code
+ * @param key - The translation key (for error messages)
+ * @param options - Validation options
+ * @returns Validation result with errors and warnings
+ */
+export declare function validatePluralForms(value: PluralString, language: string, key: string, options?: PluralValidationOptions): PluralValidationResult;
+/**
+ * Validate that count variable exists when plural forms are used.
+ * Pluralization requires a 'count' variable to determine which form to use.
+ * @param value - The plural string value
+ * @param variables - The variables object to check
+ * @param key - The translation key (for error messages)
+ * @returns Validation result with warnings if count is missing
+ */
+export declare function validateCountVariable(value: PluralString, variables: Record<string, any> | undefined, key: string): PluralValidationResult;
+//# sourceMappingURL=plural-validator.d.ts.map

package/src/validation/plural-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural-validator.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-i18n-lib/src/validation/plural-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA8CxB;AAsDD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EAC1C,GAAG,EAAE,MAAM,GACV,sBAAsB,CASxB"}

package/src/validation/plural-validator.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Plural form validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePluralForms = validatePluralForms;
+exports.validateCountVariable = validateCountVariable;
+const plural_types_1 = require("../types/plural-types");
+const language_plural_map_1 = require("../pluralization/language-plural-map");
+/**
+ * Validate plural forms for a specific language.
+ * Checks that all required plural forms are present and optionally validates variable consistency.
+ * @param value - The plural string value to validate
+ * @param language - The language code
+ * @param key - The translation key (for error messages)
+ * @param options - Validation options
+ * @returns Validation result with errors and warnings
+ */
+function validatePluralForms(value, language, key, options = {}) {
+    const errors = [];
+    const warnings = [];
+    if (!(0, plural_types_1.isPluralString)(value)) {
+        return { isValid: true, errors, warnings };
+    }
+    const required = (0, language_plural_map_1.getRequiredPluralForms)(language);
+    const all = (0, language_plural_map_1.getAllPluralForms)(language);
+    const provided = Object.keys(value);
+    // Check required forms
+    for (const form of required) {
+        if (!value[form]) {
+            if (options.strict) {
+                errors.push(`Missing required plural form '${form}' for language '${language}' in key '${key}'`);
+            }
+            else {
+                warnings.push(`Missing required plural form '${form}' for language '${language}' in key '${key}'`);
+            }
+        }
+    }
+    // Check unused forms
+    if (options.checkUnused) {
+        for (const form of provided) {
+            if (!all.includes(form)) {
+                warnings.push(`Unused plural form '${form}' for language '${language}' in key '${key}'`);
+            }
+        }
+    }
+    // Check variable consistency
+    if (options.checkVariables) {
+        const variables = extractVariables(value);
+        const inconsistent = findInconsistentVariables(value, variables);
+        for (const [form, missing] of Object.entries(inconsistent)) {
+            warnings.push(`Plural form '${form}' in key '${key}' missing variables: ${missing.join(', ')}`);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Extract all variables from plural forms.
+ * Scans all plural form texts for {variable} patterns.
+ * @param value - The plural string value
+ * @returns Set of all variable names found
+ */
+function extractVariables(value) {
+    const vars = new Set();
+    if (typeof value === 'string')
+        return vars;
+    for (const text of Object.values(value)) {
+        if (text) {
+            const matches = text.match(/\{(\w+)\}/g);
+            if (matches) {
+                matches.forEach(m => vars.add(m.slice(1, -1)));
+            }
+        }
+    }
+    return vars;
+}
+/**
+ * Find forms with inconsistent variables.
+ * Identifies plural forms that are missing variables used in other forms.
+ * @param value - The plural string value
+ * @param allVars - Set of all variables found across all forms
+ * @returns Object mapping form names to arrays of missing variable names
+ */
+function findInconsistentVariables(value, allVars) {
+    const inconsistent = {};
+    if (typeof value === 'string')
+        return inconsistent;
+    for (const [form, text] of Object.entries(value)) {
+        if (text) {
+            const formVars = new Set();
+            const matches = text.match(/\{(\w+)\}/g);
+            if (matches) {
+                matches.forEach(m => formVars.add(m.slice(1, -1)));
+            }
+            const missing = Array.from(allVars).filter(v => !formVars.has(v));
+            if (missing.length > 0) {
+                inconsistent[form] = missing;
+            }
+        }
+    }
+    return inconsistent;
+}
+/**
+ * Validate that count variable exists when plural forms are used.
+ * Pluralization requires a 'count' variable to determine which form to use.
+ * @param value - The plural string value
+ * @param variables - The variables object to check
+ * @param key - The translation key (for error messages)
+ * @returns Validation result with warnings if count is missing
+ */
+function validateCountVariable(value, variables, key) {
+    const errors = [];
+    const warnings = [];
+    if ((0, plural_types_1.isPluralString)(value) && (!variables || variables.count === undefined)) {
+        warnings.push(`Plural forms used in key '${key}' but no 'count' variable provided`);
+    }
+    return { isValid: true, errors, warnings };
+}
+//# sourceMappingURL=plural-validator.js.map

package/src/validation/plural-validator.js.map

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

package/src/validation-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration for component registration validation
+ */
+export interface ValidationConfig {
+    /** Whether to require all languages to have all strings */
+    readonly requireCompleteStrings: boolean;
+    /** Whether to allow registration with missing strings (will use fallbacks) */
+    readonly allowPartialRegistration: boolean;
+    /** Default language to fall back to for missing strings */
+    readonly fallbackLanguageId: string;
+}
+//# sourceMappingURL=validation-config.d.ts.map

package/src/validation-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-config.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/validation-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC"}

package/src/validation-config.js

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

package/src/validation-config.js.map

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

package/src/validation-result.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation result for component registration
+ */
+export interface ValidationResult {
+    readonly isValid: boolean;
+    readonly missingKeys: ReadonlyArray<{
+        readonly languageId: string;
+        readonly componentId: string;
+        readonly stringKey: string;
+    }>;
+    readonly errors: readonly string[];
+}
+//# sourceMappingURL=validation-result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation-result.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-i18n-lib/src/validation-result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}

package/src/validation-result.js

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

package/src/validation-result.js.map

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

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Digital Defiance
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/builders/i18n-builder.ts

@@ -1,82 +0,0 @@
-/**
- * Fluent builder for I18n Engine
- */
-
-import { I18nEngine } from '../core/i18n-engine';
-import { EngineConfig, LanguageDefinition } from '../interfaces';
-
-export class I18nBuilder {
-  private languages: LanguageDefinition[] = [];
-  private config: EngineConfig = {};
-  private instanceKey = 'default';
-  private registerInstance = true;
-  private setAsDefault = true;
-
-  private constructor() {}
-
-  static create(): I18nBuilder {
-    return new I18nBuilder();
-  }
-
-  withLanguages(languages: readonly LanguageDefinition[]): this {
-    this.languages = [...languages];
-    return this;
-  }
-
-  withDefaultLanguage(languageId: string): this {
-    this.config.defaultLanguage = languageId;
-    return this;
-  }
-
-  withFallbackLanguage(languageId: string): this {
-    this.config.fallbackLanguage = languageId;
-    return this;
-  }
-
-  withConstants(constants: Record<string, any>): this {
-    this.config.constants = constants;
-    return this;
-  }
-
-  withValidation(validation: EngineConfig['validation']): this {
-    this.config.validation = validation;
-    return this;
-  }
-
-  withInstanceKey(key: string): this {
-    this.instanceKey = key;
-    return this;
-  }
-
-  withRegisterInstance(register: boolean): this {
-    this.registerInstance = register;
-    return this;
-  }
-
-  withSetAsDefault(setDefault: boolean): this {
-    this.setAsDefault = setDefault;
-    return this;
-  }
-
-  isolated(): this {
-    this.registerInstance = false;
-    return this;
-  }
-
-  asDefault(): this {
-    this.setAsDefault = true;
-    return this;
-  }
-
-  build(): I18nEngine {
-    if (this.languages.length === 0) {
-      throw new Error('At least one language must be provided');
-    }
-
-    return new I18nEngine(this.languages, this.config, {
-      instanceKey: this.instanceKey,
-      registerInstance: this.registerInstance,
-      setAsDefault: this.setAsDefault,
-    });
-  }
-}

package/src/component-definition.ts

@@ -1,11 +0,0 @@
-/**
- * Component definition with its string keys
- */
-export interface ComponentDefinition<TStringKeys extends string> {
-  /** Unique identifier for the component */
-  readonly id: string;
-  /** Human-readable name for the component */
-  readonly name: string;
-  /** Array of all string keys this component requires */
-  readonly stringKeys: readonly TStringKeys[];
-}

package/src/component-registration.ts

@@ -1,29 +0,0 @@
-import { ComponentDefinition } from './component-definition';
-import { PartialComponentLanguageStrings } from './types';
-
-/**
- * Registration payload for a component with its strings
- */
-export interface ComponentRegistration<
-  TStringKeys extends string,
-  TLanguages extends string,
-> {
-  readonly component: ComponentDefinition<TStringKeys>;
-  readonly strings: PartialComponentLanguageStrings<TStringKeys, TLanguages>;
-  readonly enumName?: string;
-  readonly enumObject?: Record<string, TStringKeys>;
-  readonly aliases?: readonly string[];
-}
-
-/**
- * Type utility to extract string keys from a component definition
- */
-type ExtractStringKeys<T> = T extends ComponentDefinition<infer K> ? K : never;
-
-/**
- * Type utility to create a strongly typed component registration
- */
-export type CreateComponentRegistration<
-  TComponent extends ComponentDefinition<any>,
-  TLanguages extends string,
-> = ComponentRegistration<ExtractStringKeys<TComponent>, TLanguages>;