@xivdyetools/core 1.3.7

package/dist/services/localization/LocaleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleLoader.js","sourceRoot":"","sources":["../../../src/services/localization/LocaleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE3D,2DAA2D;AAC3D,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,OAAO,QAAQ,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExE,yCAAyC;AACzC,MAAM,SAAS,GAAgC;IAC7C,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,gCAAgC,CAAC,CAAC;YACrE,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,IAAkB,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,kBAAkB,EAC5B,0BAA0B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAChG,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,IAAa;QACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,IAA+B,CAAC;QAEnD,OAAO,CACL,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;YACnC,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ;YACvC,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;YACzC,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YAC3C,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;YACxC,OAAO,UAAU,CAAC,YAAY,KAAK,QAAQ;YAC3C,OAAO,UAAU,CAAC,WAAW,KAAK,QAAQ,CAC3C,CAAC;IACJ,CAAC;CACF"}

package/dist/services/localization/LocaleRegistry.d.ts

@@ -0,0 +1,73 @@
+/**
+ * LocaleRegistry - Manages loaded locale data cache
+ *
+ * Per R-4: Single Responsibility - caching loaded locales only
+ * Per R-5: Uses Map for O(1) lookup performance
+ *
+ * @module services/localization
+ */
+import type { LocaleCode, LocaleData } from '../../types/index.js';
+/**
+ * Registry for loaded locale data with caching
+ */
+export declare class LocaleRegistry {
+    private locales;
+    /**
+     * Register a loaded locale in the cache
+     *
+     * @param data - Locale data to register
+     *
+     * @example
+     * ```typescript
+     * const registry = new LocaleRegistry();
+     * registry.registerLocale(jaData);
+     * ```
+     */
+    registerLocale(data: LocaleData): void;
+    /**
+     * Check if locale is already loaded
+     *
+     * @param locale - Locale code to check
+     * @returns true if locale is cached
+     *
+     * @example
+     * ```typescript
+     * if (!registry.hasLocale('ja')) {
+     *     await loadJapanese();
+     * }
+     * ```
+     */
+    hasLocale(locale: LocaleCode): boolean;
+    /**
+     * Get loaded locale data
+     *
+     * @param locale - Locale code to retrieve
+     * @returns Locale data if cached, null otherwise
+     *
+     * @example
+     * ```typescript
+     * const jaData = registry.getLocale('ja');
+     * if (jaData) {
+     *     console.log(jaData.labels.dye);
+     * }
+     * ```
+     */
+    getLocale(locale: LocaleCode): LocaleData | null;
+    /**
+     * Clear all loaded locales from cache
+     * Useful for memory management or testing
+     *
+     * @example
+     * ```typescript
+     * registry.clear(); // Free memory
+     * ```
+     */
+    clear(): void;
+    /**
+     * Get number of loaded locales
+     *
+     * @returns Count of cached locales
+     */
+    get size(): number;
+}
+//# sourceMappingURL=LocaleRegistry.d.ts.map

package/dist/services/localization/LocaleRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/localization/LocaleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IAEzD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAItC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAItC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAIhD;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/services/localization/LocaleRegistry.js

@@ -0,0 +1,84 @@
+/**
+ * LocaleRegistry - Manages loaded locale data cache
+ *
+ * Per R-4: Single Responsibility - caching loaded locales only
+ * Per R-5: Uses Map for O(1) lookup performance
+ *
+ * @module services/localization
+ */
+/**
+ * Registry for loaded locale data with caching
+ */
+export class LocaleRegistry {
+    constructor() {
+        this.locales = new Map();
+    }
+    /**
+     * Register a loaded locale in the cache
+     *
+     * @param data - Locale data to register
+     *
+     * @example
+     * ```typescript
+     * const registry = new LocaleRegistry();
+     * registry.registerLocale(jaData);
+     * ```
+     */
+    registerLocale(data) {
+        this.locales.set(data.locale, data);
+    }
+    /**
+     * Check if locale is already loaded
+     *
+     * @param locale - Locale code to check
+     * @returns true if locale is cached
+     *
+     * @example
+     * ```typescript
+     * if (!registry.hasLocale('ja')) {
+     *     await loadJapanese();
+     * }
+     * ```
+     */
+    hasLocale(locale) {
+        return this.locales.has(locale);
+    }
+    /**
+     * Get loaded locale data
+     *
+     * @param locale - Locale code to retrieve
+     * @returns Locale data if cached, null otherwise
+     *
+     * @example
+     * ```typescript
+     * const jaData = registry.getLocale('ja');
+     * if (jaData) {
+     *     console.log(jaData.labels.dye);
+     * }
+     * ```
+     */
+    getLocale(locale) {
+        return this.locales.get(locale) || null;
+    }
+    /**
+     * Clear all loaded locales from cache
+     * Useful for memory management or testing
+     *
+     * @example
+     * ```typescript
+     * registry.clear(); // Free memory
+     * ```
+     */
+    clear() {
+        this.locales.clear();
+    }
+    /**
+     * Get number of loaded locales
+     *
+     * @returns Count of cached locales
+     */
+    get size() {
+        return this.locales.size;
+    }
+}
+//# sourceMappingURL=LocaleRegistry.js.map

package/dist/services/localization/LocaleRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleRegistry.js","sourceRoot":"","sources":["../../../src/services/localization/LocaleRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,OAAO,cAAc;IAA3B;QACU,YAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAyE3D,CAAC;IAvEC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,IAAgB;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAkB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,MAAkB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/services/localization/TranslationProvider.d.ts

@@ -0,0 +1,157 @@
+/**
+ * TranslationProvider - Provides translations with fallback logic
+ *
+ * Per R-4: Single Responsibility - translation retrieval only
+ * Fallback chain: requested locale → English → formatted key
+ *
+ * @module services/localization
+ */
+import type { LocaleCode, TranslationKey, HarmonyTypeKey, VisionType, JobKey, GrandCompanyKey } from '../../types/index.js';
+import type { LocaleRegistry } from './LocaleRegistry.js';
+/**
+ * Provides translations with automatic fallback to English
+ */
+export declare class TranslationProvider {
+    private registry;
+    constructor(registry: LocaleRegistry);
+    /**
+     * Get UI label with fallback chain
+     *
+     * @param key - Translation key
+     * @param locale - Requested locale
+     * @returns Translated label or formatted key
+     *
+     * @example
+     * ```typescript
+     * const label = provider.getLabel('dye', 'ja');
+     * // Returns "カララント:" (ja) or "Dye" (en fallback)
+     * ```
+     */
+    getLabel(key: TranslationKey, locale: LocaleCode): string;
+    /**
+     * Get dye name with fallback
+     *
+     * @param itemID - Dye item ID
+     * @param locale - Requested locale
+     * @returns Localized dye name or null if not found
+     *
+     * @example
+     * ```typescript
+     * const name = provider.getDyeName(5729, 'ja');
+     * // Returns "スノウホワイト" (ja) or "Snow White" (en fallback)
+     * ```
+     */
+    getDyeName(itemID: number, locale: LocaleCode): string | null;
+    /**
+     * Get category name with fallback
+     *
+     * @param category - Category key (e.g., "Reds", "Blues")
+     * @param locale - Requested locale
+     * @returns Localized category name
+     *
+     * @example
+     * ```typescript
+     * const category = provider.getCategory('Reds', 'ja');
+     * // Returns "赤系" (ja) or "Reds" (en fallback)
+     * ```
+     */
+    getCategory(category: string, locale: LocaleCode): string;
+    /**
+     * Get acquisition method with fallback
+     *
+     * @param acquisition - Acquisition key (e.g., "Dye Vendor", "Crafting")
+     * @param locale - Requested locale
+     * @returns Localized acquisition method
+     *
+     * @example
+     * ```typescript
+     * const acq = provider.getAcquisition('Dye Vendor', 'ja');
+     * // Returns "染料販売業者" (ja) or "Dye Vendor" (en fallback)
+     * ```
+     */
+    getAcquisition(acquisition: string, locale: LocaleCode): string;
+    /**
+     * Get metallic dye IDs (locale-independent)
+     *
+     * @param locale - Current locale (for consistency)
+     * @returns Array of metallic dye item IDs
+     *
+     * @example
+     * ```typescript
+     * const metallicIds = provider.getMetallicDyeIds('fr');
+     * // Returns [13116, 13117, ...] for any locale
+     * ```
+     */
+    getMetallicDyeIds(locale: LocaleCode): number[];
+    /**
+     * Get harmony type with fallback
+     *
+     * @param key - Harmony type key
+     * @param locale - Requested locale
+     * @returns Localized harmony type name
+     *
+     * @example
+     * ```typescript
+     * const harmony = provider.getHarmonyType('triadic', 'ja');
+     * // Returns "三色配色" (ja) or "Triadic" (en fallback)
+     * ```
+     */
+    getHarmonyType(key: HarmonyTypeKey, locale: LocaleCode): string;
+    /**
+     * Get vision type with fallback
+     *
+     * @param key - Vision type key
+     * @param locale - Requested locale
+     * @returns Localized vision type name
+     *
+     * @example
+     * ```typescript
+     * const vision = provider.getVisionType('deuteranopia', 'ja');
+     * // Returns "2型色覚（赤緑色盲）" (ja) or English fallback
+     * ```
+     */
+    getVisionType(key: VisionType, locale: LocaleCode): string;
+    /**
+     * Get job name with fallback
+     *
+     * @param key - Job key
+     * @param locale - Requested locale
+     * @returns Localized job name
+     *
+     * @example
+     * ```typescript
+     * const job = provider.getJobName('darkKnight', 'ja');
+     * // Returns "暗黒騎士" (ja) or "Dark Knight" (en fallback)
+     * ```
+     */
+    getJobName(key: JobKey, locale: LocaleCode): string;
+    /**
+     * Get Grand Company name with fallback
+     *
+     * @param key - Grand Company key
+     * @param locale - Requested locale
+     * @returns Localized Grand Company name
+     *
+     * @example
+     * ```typescript
+     * const gc = provider.getGrandCompanyName('maelstrom', 'ja');
+     * // Returns "黒渦団" (ja) or "The Maelstrom" (en fallback)
+     * ```
+     */
+    getGrandCompanyName(key: GrandCompanyKey, locale: LocaleCode): string;
+    /**
+     * Format camelCase/PascalCase key to Title Case
+     *
+     * @param key - Key to format
+     * @returns Formatted string
+     * @private
+     *
+     * @example
+     * ```typescript
+     * formatKey('splitComplementary') // "Split Complementary"
+     * formatKey('cosmicExploration') // "Cosmic Exploration"
+     * ```
+     */
+    private formatKey;
+}
+//# sourceMappingURL=TranslationProvider.d.ts.map

package/dist/services/localization/TranslationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationProvider.d.ts","sourceRoot":"","sources":["../../../src/services/localization/TranslationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,MAAM,EACN,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAE5C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBzD;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAoB7D;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBzD;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB/D;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;IAY/C;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB/D;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoB1D;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBnD;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAoBrE;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,SAAS;CAMlB"}

package/dist/services/localization/TranslationProvider.js

@@ -0,0 +1,289 @@
+/**
+ * TranslationProvider - Provides translations with fallback logic
+ *
+ * Per R-4: Single Responsibility - translation retrieval only
+ * Fallback chain: requested locale → English → formatted key
+ *
+ * @module services/localization
+ */
+/**
+ * Provides translations with automatic fallback to English
+ */
+export class TranslationProvider {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Get UI label with fallback chain
+     *
+     * @param key - Translation key
+     * @param locale - Requested locale
+     * @returns Translated label or formatted key
+     *
+     * @example
+     * ```typescript
+     * const label = provider.getLabel('dye', 'ja');
+     * // Returns "カララント:" (ja) or "Dye" (en fallback)
+     * ```
+     */
+    getLabel(key, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.labels[key]) {
+            return localeData.labels[key];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.labels[key]) {
+                return englishData.labels[key];
+            }
+        }
+        // Final fallback: format key (camelCase → Title Case)
+        return this.formatKey(key);
+    }
+    /**
+     * Get dye name with fallback
+     *
+     * @param itemID - Dye item ID
+     * @param locale - Requested locale
+     * @returns Localized dye name or null if not found
+     *
+     * @example
+     * ```typescript
+     * const name = provider.getDyeName(5729, 'ja');
+     * // Returns "スノウホワイト" (ja) or "Snow White" (en fallback)
+     * ```
+     */
+    getDyeName(itemID, locale) {
+        const localeData = this.registry.getLocale(locale);
+        const idStr = String(itemID);
+        // Try requested locale
+        if (localeData?.dyeNames[idStr]) {
+            return localeData.dyeNames[idStr];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.dyeNames[idStr]) {
+                return englishData.dyeNames[idStr];
+            }
+        }
+        return null;
+    }
+    /**
+     * Get category name with fallback
+     *
+     * @param category - Category key (e.g., "Reds", "Blues")
+     * @param locale - Requested locale
+     * @returns Localized category name
+     *
+     * @example
+     * ```typescript
+     * const category = provider.getCategory('Reds', 'ja');
+     * // Returns "赤系" (ja) or "Reds" (en fallback)
+     * ```
+     */
+    getCategory(category, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.categories[category]) {
+            return localeData.categories[category];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.categories[category]) {
+                return englishData.categories[category];
+            }
+        }
+        // Final fallback: return original category
+        return category;
+    }
+    /**
+     * Get acquisition method with fallback
+     *
+     * @param acquisition - Acquisition key (e.g., "Dye Vendor", "Crafting")
+     * @param locale - Requested locale
+     * @returns Localized acquisition method
+     *
+     * @example
+     * ```typescript
+     * const acq = provider.getAcquisition('Dye Vendor', 'ja');
+     * // Returns "染料販売業者" (ja) or "Dye Vendor" (en fallback)
+     * ```
+     */
+    getAcquisition(acquisition, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.acquisitions[acquisition]) {
+            return localeData.acquisitions[acquisition];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.acquisitions[acquisition]) {
+                return englishData.acquisitions[acquisition];
+            }
+        }
+        // Final fallback: return original acquisition
+        return acquisition;
+    }
+    /**
+     * Get metallic dye IDs (locale-independent)
+     *
+     * @param locale - Current locale (for consistency)
+     * @returns Array of metallic dye item IDs
+     *
+     * @example
+     * ```typescript
+     * const metallicIds = provider.getMetallicDyeIds('fr');
+     * // Returns [13116, 13117, ...] for any locale
+     * ```
+     */
+    getMetallicDyeIds(locale) {
+        const localeData = this.registry.getLocale(locale);
+        if (localeData?.metallicDyeIds) {
+            return localeData.metallicDyeIds;
+        }
+        // Fallback to English
+        const englishData = this.registry.getLocale('en');
+        return englishData?.metallicDyeIds || [];
+    }
+    /**
+     * Get harmony type with fallback
+     *
+     * @param key - Harmony type key
+     * @param locale - Requested locale
+     * @returns Localized harmony type name
+     *
+     * @example
+     * ```typescript
+     * const harmony = provider.getHarmonyType('triadic', 'ja');
+     * // Returns "三色配色" (ja) or "Triadic" (en fallback)
+     * ```
+     */
+    getHarmonyType(key, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.harmonyTypes[key]) {
+            return localeData.harmonyTypes[key];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.harmonyTypes[key]) {
+                return englishData.harmonyTypes[key];
+            }
+        }
+        // Final fallback: format key
+        return this.formatKey(key);
+    }
+    /**
+     * Get vision type with fallback
+     *
+     * @param key - Vision type key
+     * @param locale - Requested locale
+     * @returns Localized vision type name
+     *
+     * @example
+     * ```typescript
+     * const vision = provider.getVisionType('deuteranopia', 'ja');
+     * // Returns "2型色覚（赤緑色盲）" (ja) or English fallback
+     * ```
+     */
+    getVisionType(key, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.visionTypes[key]) {
+            return localeData.visionTypes[key];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.visionTypes[key]) {
+                return englishData.visionTypes[key];
+            }
+        }
+        // Final fallback: format key
+        return this.formatKey(key);
+    }
+    /**
+     * Get job name with fallback
+     *
+     * @param key - Job key
+     * @param locale - Requested locale
+     * @returns Localized job name
+     *
+     * @example
+     * ```typescript
+     * const job = provider.getJobName('darkKnight', 'ja');
+     * // Returns "暗黒騎士" (ja) or "Dark Knight" (en fallback)
+     * ```
+     */
+    getJobName(key, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.jobNames[key]) {
+            return localeData.jobNames[key];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.jobNames[key]) {
+                return englishData.jobNames[key];
+            }
+        }
+        // Final fallback: format key
+        return this.formatKey(key);
+    }
+    /**
+     * Get Grand Company name with fallback
+     *
+     * @param key - Grand Company key
+     * @param locale - Requested locale
+     * @returns Localized Grand Company name
+     *
+     * @example
+     * ```typescript
+     * const gc = provider.getGrandCompanyName('maelstrom', 'ja');
+     * // Returns "黒渦団" (ja) or "The Maelstrom" (en fallback)
+     * ```
+     */
+    getGrandCompanyName(key, locale) {
+        const localeData = this.registry.getLocale(locale);
+        // Try requested locale
+        if (localeData?.grandCompanyNames[key]) {
+            return localeData.grandCompanyNames[key];
+        }
+        // Fallback to English
+        if (locale !== 'en') {
+            const englishData = this.registry.getLocale('en');
+            if (englishData?.grandCompanyNames[key]) {
+                return englishData.grandCompanyNames[key];
+            }
+        }
+        // Final fallback: format key
+        return this.formatKey(key);
+    }
+    /**
+     * Format camelCase/PascalCase key to Title Case
+     *
+     * @param key - Key to format
+     * @returns Formatted string
+     * @private
+     *
+     * @example
+     * ```typescript
+     * formatKey('splitComplementary') // "Split Complementary"
+     * formatKey('cosmicExploration') // "Cosmic Exploration"
+     * ```
+     */
+    formatKey(key) {
+        return key
+            .replace(/([A-Z])/g, ' $1')
+            .replace(/^./, (str) => str.toUpperCase())
+            .trim();
+    }
+}
+//# sourceMappingURL=TranslationProvider.js.map

package/dist/services/localization/TranslationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationProvider.js","sourceRoot":"","sources":["../../../src/services/localization/TranslationProvider.ts"],"names":[],"mappings":"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"}