@fukict/i18n 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fukict Team
+
+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/dist/I18n.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @fukict/i18n - I18n Class
+ *
+ * Core i18n class implementation
+ */
+import type { I18nInstance, I18nListener, I18nOptions, Unsubscribe } from './types';
+/**
+ * I18n class
+ */
+export declare class I18n<Messages extends Record<string, any>> implements I18nInstance<Messages> {
+    /**
+     * Current locale
+     */
+    private currentLocale;
+    /**
+     * Translation messages
+     */
+    private messages;
+    /**
+     * Configuration options
+     */
+    private options;
+    /**
+     * Subscribers
+     */
+    private listeners;
+    /**
+     * Loading locales (track loading state)
+     */
+    private loadingLocales;
+    /**
+     * Loaded locales (track loaded state)
+     */
+    private loadedLocales;
+    /**
+     * Translation cache
+     */
+    private translationCache;
+    /**
+     * Constructor
+     */
+    constructor(options: I18nOptions<Messages>);
+    /**
+     * Get current locale
+     */
+    get locale(): string;
+    /**
+     * Translate text
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    /**
+     * Internal translate function
+     */
+    private translate;
+    /**
+     * Get text by key from locale
+     */
+    private getTextByKey;
+    /**
+     * Get plural form based on count
+     */
+    private getPluralForm;
+    /**
+     * Interpolate variables in text
+     */
+    private interpolate;
+    /**
+     * Handle missing translation
+     */
+    private handleMissing;
+    /**
+     * Change locale
+     */
+    changeLocale(locale: string): Promise<void>;
+    /**
+     * Wait for locale to finish loading
+     */
+    private waitForLocale;
+    /**
+     * Subscribe to locale changes
+     */
+    subscribe(listener: I18nListener): Unsubscribe;
+    /**
+     * Notify all subscribers
+     */
+    private notify;
+    /**
+     * Get current locale messages
+     */
+    getMessages(): Messages[keyof Messages];
+    /**
+     * Get available locales
+     */
+    getAvailableLocales(): string[];
+    /**
+     * Add messages for a locale
+     */
+    addMessages(locale: string, messages: Messages[keyof Messages]): void;
+    /**
+     * Format number
+     */
+    n(value: number, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Format date
+     */
+    d(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Format relative time
+     */
+    rt(value: number, unit: Intl.RelativeTimeFormatUnit): string;
+}
+//# sourceMappingURL=I18n.d.ts.map

package/dist/I18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18n.d.ts","sourceRoot":"","sources":["../src/I18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,IAAI,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACpD,YAAW,YAAY,CAAC,QAAQ,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAW;IAE3B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAwB;IAEvC;;OAEG;IACH,OAAO,CAAC,SAAS,CAAgC;IAEjD;;OAEG;IACH,OAAO,CAAC,cAAc,CAAqB;IAE3C;;OAEG;IACH,OAAO,CAAC,aAAa,CAAqB;IAE1C;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAA6B;IAErD;;OAEG;gBACS,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;IAW1C;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAgBhE;;OAEG;IACH,OAAO,CAAC,SAAS;IAiCjB;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCjD;;OAEG;YACW,aAAa;IAa3B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW;IAQ9C;;OAEG;IACH,OAAO,CAAC,MAAM;IAUd;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,QAAQ,CAAC;IAKvC;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,QAAQ,CAAC,GAAG,IAAI;IAQrE;;OAEG;IACH,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM;IAI5D;;OAEG;IACH,CAAC,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM;IAIrE;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,sBAAsB,GAAG,MAAM;CAG7D"}

package/dist/I18n.js

@@ -0,0 +1,278 @@
+/**
+ * I18n class
+ */
+export class I18n {
+    /**
+     * Current locale
+     */
+    currentLocale;
+    /**
+     * Translation messages
+     */
+    messages;
+    /**
+     * Configuration options
+     */
+    options;
+    /**
+     * Subscribers
+     */
+    listeners = new Set();
+    /**
+     * Loading locales (track loading state)
+     */
+    loadingLocales = new Set();
+    /**
+     * Loaded locales (track loaded state)
+     */
+    loadedLocales = new Set();
+    /**
+     * Translation cache
+     */
+    translationCache = new Map();
+    /**
+     * Constructor
+     */
+    constructor(options) {
+        this.options = options;
+        this.currentLocale = options.locale || options.defaultLocale;
+        this.messages = options.messages;
+        // Mark initially provided locales as loaded
+        for (const locale of Object.keys(options.messages)) {
+            this.loadedLocales.add(locale);
+        }
+    }
+    /**
+     * Get current locale
+     */
+    get locale() {
+        return this.currentLocale;
+    }
+    /**
+     * Translate text
+     */
+    t(key, params) {
+        // Check cache
+        const cacheKey = `${this.currentLocale}:${key}:${JSON.stringify(params || {})}`;
+        if (this.translationCache.has(cacheKey)) {
+            return this.translationCache.get(cacheKey);
+        }
+        // Get translation
+        const result = this.translate(key, params);
+        // Cache result
+        this.translationCache.set(cacheKey, result);
+        return result;
+    }
+    /**
+     * Internal translate function
+     */
+    translate(key, params) {
+        // Try current locale
+        let text = this.getTextByKey(key, this.currentLocale);
+        // Try fallback locale
+        if (text === undefined && this.options.fallbackLocale) {
+            text = this.getTextByKey(key, this.options.fallbackLocale);
+        }
+        // Handle missing translation
+        if (text === undefined) {
+            return this.handleMissing(key, this.currentLocale);
+        }
+        // Handle plural forms
+        if (params && 'count' in params && typeof text === 'object') {
+            text = this.getPluralForm(text, params.count);
+        }
+        // Handle interpolation
+        if (params && typeof text === 'string') {
+            text = this.interpolate(text, params);
+        }
+        return text;
+    }
+    /**
+     * Get text by key from locale
+     */
+    getTextByKey(key, locale) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const messages = this.messages[locale];
+        if (!messages)
+            return undefined;
+        // Support dot notation: 'user.name'
+        const keys = key.split('.');
+        let current = messages;
+        for (const k of keys) {
+            if (current &&
+                typeof current === 'object' &&
+                k in current &&
+                current !== null) {
+                current = current[k];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return current;
+    }
+    /**
+     * Get plural form based on count
+     */
+    getPluralForm(pluralObj, count) {
+        // Use Intl.PluralRules to determine plural category
+        const rules = new Intl.PluralRules(this.currentLocale);
+        const category = rules.select(count);
+        // Try to get the plural form
+        if (category in pluralObj) {
+            return pluralObj[category];
+        }
+        // Fallback to 'other'
+        if ('other' in pluralObj) {
+            return pluralObj.other;
+        }
+        // Return empty if no match
+        return '';
+    }
+    /**
+     * Interpolate variables in text
+     */
+    interpolate(text, params) {
+        return text.replace(/\{(\w+)\}/g, (match, key) => {
+            return key in params ? String(params[key]) : match;
+        });
+    }
+    /**
+     * Handle missing translation
+     */
+    handleMissing(key, locale) {
+        const handler = this.options.missingHandler;
+        if (typeof handler === 'function') {
+            return handler(key, locale);
+        }
+        if (handler === 'fallback' && this.options.fallbackLocale) {
+            const fallbackText = this.getTextByKey(key, this.options.fallbackLocale);
+            if (fallbackText !== undefined && typeof fallbackText === 'string') {
+                return fallbackText;
+            }
+        }
+        // Default: return key
+        return key;
+    }
+    /**
+     * Change locale
+     */
+    async changeLocale(locale) {
+        // Already current locale
+        if (locale === this.currentLocale) {
+            return;
+        }
+        // If already loaded, just switch
+        if (this.loadedLocales.has(locale)) {
+            this.currentLocale = locale;
+            this.notify();
+            return;
+        }
+        // If loading, wait for it
+        if (this.loadingLocales.has(locale)) {
+            await this.waitForLocale(locale);
+            return;
+        }
+        // Load new locale
+        if (this.options.loadMessages) {
+            this.loadingLocales.add(locale);
+            try {
+                const messages = await this.options.loadMessages(locale);
+                this.addMessages(locale, messages);
+                this.loadedLocales.add(locale);
+                this.currentLocale = locale;
+                this.notify();
+            }
+            catch (error) {
+                console.error(`Failed to load locale ${locale}:`, error);
+                throw error;
+            }
+            finally {
+                this.loadingLocales.delete(locale);
+            }
+        }
+        else {
+            // No lazy loading, just switch (might have missing translations)
+            this.currentLocale = locale;
+            this.notify();
+        }
+    }
+    /**
+     * Wait for locale to finish loading
+     */
+    async waitForLocale(locale) {
+        return new Promise(resolve => {
+            const check = () => {
+                if (!this.loadingLocales.has(locale)) {
+                    resolve();
+                }
+                else {
+                    setTimeout(check, 50);
+                }
+            };
+            check();
+        });
+    }
+    /**
+     * Subscribe to locale changes
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * Notify all subscribers
+     */
+    notify() {
+        // Clear cache on locale change
+        this.translationCache.clear();
+        // Notify subscribers
+        this.listeners.forEach(listener => {
+            listener();
+        });
+    }
+    /**
+     * Get current locale messages
+     */
+    getMessages() {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return this.messages[this.currentLocale];
+    }
+    /**
+     * Get available locales
+     */
+    getAvailableLocales() {
+        return Object.keys(this.messages);
+    }
+    /**
+     * Add messages for a locale
+     */
+    addMessages(locale, messages) {
+        this.messages = {
+            ...this.messages,
+            [locale]: messages,
+        };
+        this.loadedLocales.add(locale);
+    }
+    /**
+     * Format number
+     */
+    n(value, options) {
+        return new Intl.NumberFormat(this.currentLocale, options).format(value);
+    }
+    /**
+     * Format date
+     */
+    d(value, options) {
+        return new Intl.DateTimeFormat(this.currentLocale, options).format(value);
+    }
+    /**
+     * Format relative time
+     */
+    rt(value, unit) {
+        return new Intl.RelativeTimeFormat(this.currentLocale).format(value, unit);
+    }
+}
+//# sourceMappingURL=I18n.js.map

package/dist/I18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18n.js","sourceRoot":"","sources":["../src/I18n.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAO,IAAI;IAGf;;OAEG;IACK,aAAa,CAAS;IAE9B;;OAEG;IACK,QAAQ,CAAW;IAE3B;;OAEG;IACK,OAAO,CAAwB;IAEvC;;OAEG;IACK,SAAS,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEjD;;OAEG;IACK,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C;;OAEG;IACK,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C;;OAEG;IACK,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD;;OAEG;IACH,YAAY,OAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAEjC,4CAA4C;QAC5C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,CAAC,CAAC,GAAW,EAAE,MAAwC;QACrD,cAAc;QACd,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,GAAa,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1F,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QAC9C,CAAC;QAED,kBAAkB;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE3C,eAAe;QACf,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,SAAS,CACf,GAAW,EACX,MAAwC;QAExC,qBAAqB;QACrB,IAAI,IAAI,GAAgD,IAAI,CAAC,YAAY,CACvE,GAAG,EACH,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,sBAAsB;QACtB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YACtD,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7D,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;QAED,sBAAsB;QACtB,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5D,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAe,CAAC,CAAC;QAC1D,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,YAAY,CAClB,GAAW,EACX,MAAc;QAEd,mEAAmE;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,oCAAoC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,OAAO,GAAY,QAAQ,CAAC;QAEhC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IACE,OAAO;gBACP,OAAO,OAAO,KAAK,QAAQ;gBAC3B,CAAC,IAAI,OAAO;gBACZ,OAAO,KAAK,IAAI,EAChB,CAAC;gBACD,OAAO,GAAI,OAAmC,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,OAA0C,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,SAAiC,EACjC,KAAa;QAEb,oDAAoD;QACpD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAErC,6BAA6B;QAC7B,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,2BAA2B;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,WAAW,CACjB,IAAY,EACZ,MAAuC;QAEvC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;YACvD,OAAO,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,GAAW,EAAE,MAAc;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAE5C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACzE,IAAI,YAAY,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACnE,OAAO,YAAY,CAAC;YACtB,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,yBAAyB;QACzB,IAAI,MAAM,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,iCAAiC;QACjC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACzD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC/B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;gBAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;gBACzD,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iEAAiE;YACjE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,MAAc;QACxC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;YAC3B,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC;YACF,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAsB;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM;QACZ,+BAA+B;QAC/B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAE9B,qBAAqB;QACrB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAChC,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW;QACT,+DAA+D;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAc,EAAE,QAAkC;QAC5D,IAAI,CAAC,QAAQ,GAAG;YACd,GAAG,IAAI,CAAC,QAAQ;YAChB,CAAC,MAAM,CAAC,EAAE,QAAQ;SACP,CAAC;QACd,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,CAAC,CAAC,KAAa,EAAE,OAAkC;QACjD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,CAAC,CAAC,KAAoB,EAAE,OAAoC;QAC1D,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,KAAa,EAAE,IAAiC;QACjD,OAAO,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/createI18n.d.ts

@@ -0,0 +1,17 @@
+import type { I18nInstance, I18nOptions } from './types';
+/**
+ * Create i18n instance
+ *
+ * @example
+ * ```typescript
+ * const i18n = createI18n({
+ *   defaultLocale: 'en',
+ *   messages: {
+ *     en: { hello: 'Hello' },
+ *     zh: { hello: '你好' },
+ *   },
+ * });
+ * ```
+ */
+export declare function createI18n<Messages extends Record<string, any>>(options: I18nOptions<Messages>): I18nInstance<Messages>;
+//# sourceMappingURL=createI18n.d.ts.map

package/dist/createI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createI18n.d.ts","sourceRoot":"","sources":["../src/createI18n.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC7B,YAAY,CAAC,QAAQ,CAAC,CAExB"}

package/dist/createI18n.js

@@ -0,0 +1,24 @@
+/**
+ * @fukict/i18n - createI18n
+ *
+ * Factory function to create i18n instance
+ */
+import { I18n } from './I18n';
+/**
+ * Create i18n instance
+ *
+ * @example
+ * ```typescript
+ * const i18n = createI18n({
+ *   defaultLocale: 'en',
+ *   messages: {
+ *     en: { hello: 'Hello' },
+ *     zh: { hello: '你好' },
+ *   },
+ * });
+ * ```
+ */
+export function createI18n(options) {
+    return new I18n(options);
+}
+//# sourceMappingURL=createI18n.js.map

package/dist/createI18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createI18n.js","sourceRoot":"","sources":["../src/createI18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CACxB,OAA8B;IAE9B,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fukict/i18n
+ *
+ * Type-safe internationalization library for Fukict framework
+ */
+import { METADATA } from './metadata.js';
+export { METADATA };
+export declare const VERSION: "0.1.0";
+export { I18n } from './I18n';
+export { createI18n } from './createI18n';
+export type { I18nInstance, I18nListener, I18nOptions, KeyPath, TranslationKey, Unsubscribe, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,eAAO,MAAM,OAAO,SAAmB,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,EACP,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @fukict/i18n
+ *
+ * Type-safe internationalization library for Fukict framework
+ */
+// Package metadata
+import { METADATA } from './metadata.js';
+export { METADATA };
+export const VERSION = METADATA.version;
+export { I18n } from './I18n';
+export { createI18n } from './createI18n';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,mBAAmB;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Package metadata
+ * Auto-generated by extract-metadata.ts - DO NOT EDIT MANUALLY
+ */
+export declare const METADATA: {
+    readonly name: "@fukict/i18n";
+    readonly version: "0.1.0";
+    readonly description: "Type-safe internationalization library for Fukict framework";
+    readonly author: "Fukict Team";
+    readonly license: "MIT";
+    readonly homepage: "";
+    readonly repository: "https://github.com/fukict/fukict.git";
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;CAQX,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,14 @@
+/**
+ * Package metadata
+ * Auto-generated by extract-metadata.ts - DO NOT EDIT MANUALLY
+ */
+export const METADATA = {
+    name: '@fukict/i18n',
+    version: '0.1.0',
+    description: 'Type-safe internationalization library for Fukict framework',
+    author: 'Fukict Team',
+    license: 'MIT',
+    homepage: '',
+    repository: 'https://github.com/fukict/fukict.git',
+};
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,6DAA6D;IAC1E,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,sCAAsC;CAC1C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fukict/i18n - Types
+ *
+ * Type definitions for i18n library
+ */
+/**
+ * Listener function type
+ */
+export type I18nListener = () => void;
+/**
+ * Unsubscribe function type
+ */
+export type Unsubscribe = () => void;
+/**
+ * Recursively extract key paths from nested object
+ */
+export type KeyPath<T, Prefix extends string = ''> = T extends object ? {
+    [K in keyof T & string]: T[K] extends string ? Prefix extends '' ? K : `${Prefix}.${K}` : KeyPath<T[K], Prefix extends '' ? K : `${Prefix}.${K}`>;
+}[keyof T & string] : never;
+/**
+ * Extract translation key type from messages
+ */
+export type TranslationKey<Messages> = Messages extends Record<string, infer Msg> ? KeyPath<Msg> : never;
+/**
+ * I18n configuration options
+ */
+export interface I18nOptions<Messages extends Record<string, any>> {
+    /**
+     * Default locale
+     */
+    defaultLocale: string;
+    /**
+     * Current locale (optional, defaults to defaultLocale)
+     */
+    locale?: string;
+    /**
+     * Translation messages
+     */
+    messages: Messages;
+    /**
+     * Missing translation handler
+     * - 'key': return the key itself (default)
+     * - 'fallback': use fallbackLocale
+     * - function: custom handler
+     */
+    missingHandler?: 'key' | 'fallback' | ((key: string, locale: string) => string);
+    /**
+     * Fallback locale (when translation is missing)
+     */
+    fallbackLocale?: string;
+    /**
+     * Lazy load messages function
+     */
+    loadMessages?: (locale: string) => Promise<Messages[keyof Messages]>;
+}
+/**
+ * I18n instance interface
+ */
+export interface I18nInstance<Messages extends Record<string, any>> {
+    /**
+     * Current locale (readonly)
+     */
+    readonly locale: string;
+    /**
+     * Translate text
+     */
+    t(key: string, params?: Record<string, any>): string;
+    /**
+     * Change locale
+     */
+    changeLocale(locale: string): Promise<void>;
+    /**
+     * Subscribe to locale changes
+     */
+    subscribe(listener: I18nListener): Unsubscribe;
+    /**
+     * Get current locale messages
+     */
+    getMessages(): Messages[keyof Messages];
+    /**
+     * Get available locales
+     */
+    getAvailableLocales(): string[];
+    /**
+     * Add messages for a locale
+     */
+    addMessages(locale: string, messages: Messages[keyof Messages]): void;
+    /**
+     * Format number
+     */
+    n(value: number, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Format date
+     */
+    d(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Format relative time
+     */
+    rt(value: number, unit: Intl.RelativeTimeFormatUnit): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,EAAE,IAAI,CAAC,SAAS,MAAM,GACjE;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACxC,MAAM,SAAS,EAAE,GACf,CAAC,GACD,GAAG,MAAM,IAAI,CAAC,EAAE,GAClB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;CAC5D,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GACnB,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,IACjC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC/D;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;;;OAKG;IACH,cAAc,CAAC,EACX,KAAK,GACL,UAAU,GACV,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAE9C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAChE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IAErD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC;IAE/C;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC;IAEtE;;OAEG;IACH,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC;IAE7D;;OAEG;IACH,CAAC,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC;IAEtE;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC;CAC9D"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @fukict/i18n - Types
+ *
+ * Type definitions for i18n library
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@fukict/i18n",
+  "version": "0.1.0",
+  "description": "Type-safe internationalization library for Fukict framework",
+  "keywords": [
+    "fukict",
+    "i18n",
+    "internationalization",
+    "localization",
+    "translation",
+    "reactive"
+  ],
+  "bugs": {
+    "url": "https://github.com/fukict/fukict/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fukict/fukict.git",
+    "directory": "packages/i18n"
+  },
+  "license": "MIT",
+  "author": "Fukict Team",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsx ../../scripts/build-package.ts --pkg-name i18n --no-watch",
+    "dev": "tsx ../../scripts/build-package.ts --pkg-name i18n --watch",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}