// extension/i18n.js export const SUPPORTED_LANGUAGES = ['en', 'de', 'fr', 'es', 'pt-BR', 'ru']; export const DEFAULT_LANGUAGE = 'en'; let activeDictionary = {}; /** * Resolves, loads, and merges the target language with the English baseline fallback. * @param {string} langCode - Target language (e.g. 'de') */ export async function loadLocale(langCode) { const resolvedLang = SUPPORTED_LANGUAGES.includes(langCode) ? langCode : DEFAULT_LANGUAGE; try { // Load Baseline English const enResponse = await fetch(chrome.runtime.getURL(`locales/${DEFAULT_LANGUAGE}.json`)); const enDict = await enResponse.json(); if (resolvedLang === DEFAULT_LANGUAGE) { activeDictionary = enDict; return; } // Load Target Locale const targetResponse = await fetch(chrome.runtime.getURL(`locales/${resolvedLang}.json`)); const targetDict = await targetResponse.json(); // Airtight Fallback Merge: target overrides en, missing elements fallback to en activeDictionary = Object.assign({}, enDict, targetDict); } catch (err) { console.error('[i18n] Failed to load locale. Defaulting to English:', err); // Fallback directly to static English if fetching fails try { const enResponse = await fetch(chrome.runtime.getURL(`locales/${DEFAULT_LANGUAGE}.json`)); activeDictionary = await enResponse.json(); } catch (_) { activeDictionary = {}; } } } /** * Returns the translated string for a given key. Supports optional value interpolation. * @param {string} key - Dictionary key * @param {object} [placeholders] - Key-value map for replacements (e.g., { name: 'Alice' }) * @returns {string} Translated string or the key itself */ export function getMessage(key, placeholders = null) { let msg = activeDictionary[key] || key; if (placeholders && typeof placeholders === 'object') { for (const [k, v] of Object.entries(placeholders)) { msg = msg.replace(new RegExp(`{${k}}`, 'g'), v); } } return msg; } /** * Performs dynamic DOM replacements for elements carrying data-i18n attributes. */ export function translateDOM() { // 1. Text Content document.querySelectorAll('[data-i18n]').forEach(el => { const key = el.getAttribute('data-i18n'); const translated = getMessage(key); // Special case: Preserve logo image elements inside headers (like h1 logo) const img = el.querySelector('img'); if (img) { el.innerHTML = ''; el.appendChild(img); el.appendChild(document.createTextNode(' ' + translated)); } else { el.textContent = translated; } }); // 2. Tooltips (titles) document.querySelectorAll('[data-i18n-title]').forEach(el => { const key = el.getAttribute('data-i18n-title'); el.setAttribute('title', getMessage(key)); }); // 3. Placeholders document.querySelectorAll('[data-i18n-placeholder]').forEach(el => { const key = el.getAttribute('data-i18n-placeholder'); el.setAttribute('placeholder', getMessage(key)); }); }