orion/static/shared/js/i18n.js

/**
 * JavaScript i18n Support
 *
 * Loads translations from module locale files for use in JavaScript.
 * Provides the same translation interface as the Python/Jinja2 system.
 *
 * Usage:
 *   // Initialize with language and modules to preload
 *   await I18n.init('en', ['catalog', 'orders']);
 *
 *   // Or load modules later
 *   await I18n.loadModule('inventory');
 *
 *   // Translate
 *   const message = I18n.t('catalog.messages.product_created');
 *   const withVars = I18n.t('common.welcome', { name: 'John' });
 */
const I18n = {
    _translations: {},
    _language: 'en',
    _loaded: new Set(),
    _loading: new Map(),  // Track in-progress loads

    /**
     * Initialize with language (call once on page load)
     * @param {string} language - Language code (en, fr, de, lb)
     * @param {string[]} modules - Optional array of modules to preload
     */
    async init(language = 'en', modules = []) {
        this._language = language;
        // Load shared translations first
        await this.loadShared();
        // Preload any specified modules
        if (modules && modules.length > 0) {
            await Promise.all(modules.map(m => this.loadModule(m)));
        }
    },

    /**
     * Load shared/common translations from static/locales
     */
    async loadShared() {
        if (this._loaded.has('shared')) return;

        try {
            const response = await fetch(`/static/locales/${this._language}.json`);
            if (response.ok) {
                const data = await response.json();
                this._translations = { ...this._translations, ...data };
                this._loaded.add('shared');
            }
        } catch (e) {
            console.warn('[i18n] Failed to load shared translations:', e);
        }
    },

    /**
     * Load module-specific translations
     * @param {string} module - Module name (e.g., 'catalog', 'orders')
     */
    async loadModule(module) {
        if (this._loaded.has(module)) return;

        try {
            const response = await fetch(`/static/modules/${module}/locales/${this._language}.json`);
            if (response.ok) {
                const data = await response.json();
                // Namespace under module code (matching Python i18n behavior)
                this._translations[module] = data;
                this._loaded.add(module);
            }
        } catch (e) {
            console.warn(`[i18n] Failed to load ${module} translations:`, e);
        }
    },

    /**
     * Get translation by key path
     * @param {string} key - Dot-notation key (e.g., 'catalog.messages.product_created')
     * @param {object} vars - Variables for interpolation
     * @returns {string} Translated string or key if not found
     */
    t(key, vars = {}) {
        const keys = key.split('.');
        let value = this._translations;

        for (const k of keys) {
            if (value && typeof value === 'object' && k in value) {
                value = value[k];
            } else {
                console.warn(`[i18n] Missing translation: ${key}`);
                return key;
            }
        }

        if (typeof value !== 'string') return key;

        // Interpolate variables: {name} -> value
        return value.replace(/\{(\w+)\}/g, (match, name) => {
            return vars[name] !== undefined ? vars[name] : match;
        });
    },

    /**
     * Check if a translation key exists
     * @param {string} key - Dot-notation key
     * @returns {boolean} True if key exists
     */
    has(key) {
        const keys = key.split('.');
        let value = this._translations;

        for (const k of keys) {
            if (value && typeof value === 'object' && k in value) {
                value = value[k];
            } else {
                return false;
            }
        }

        return typeof value === 'string';
    },

    /**
     * Get current language
     * @returns {string} Current language code
     */
    getLanguage() {
        return this._language;
    },

    /**
     * Change language (reloads all loaded modules)
     * @param {string} language - New language code
     */
    async setLanguage(language) {
        if (language === this._language) return;

        const loadedModules = [...this._loaded];
        this._language = language;
        this._translations = {};
        this._loaded.clear();

        // Reload all previously loaded modules
        for (const module of loadedModules) {
            if (module === 'shared') {
                await this.loadShared();
            } else {
                await this.loadModule(module);
            }
        }
    }
};

// Export for module usage
if (typeof window !== 'undefined') {
    window.I18n = I18n;
}