// Один источник языка для всех профилей. Браузерные настройки имеют приоритет // над системным языком. Списки и словари живут в соседних JSON-файлах. const STORAGE_KEY = 'shine-ui-language-v1'; const FALLBACK_LANGUAGE = 'en'; const BOOT_LANGUAGES = [ { code: 'ru', name: 'Русский' }, { code: 'en', name: 'English' }, ]; let availableLanguages = BOOT_LANGUAGES; let defaultLanguage = FALLBACK_LANGUAGE; let activeLanguage = FALLBACK_LANGUAGE; let initialized = null; const dictionaries = new Map(); const loadingDictionaries = new Map(); const subscribers = new Set(); function normalizeCode(value) { const code = String(value || '').trim().toLowerCase().replace(/_/g, '-'); return /^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/u.test(code) ? code : ''; } function matchLanguage(value, languages = availableLanguages) { const code = normalizeCode(value); if (!code) return ''; const codes = new Set(languages.map((item) => item.code)); if (codes.has(code)) return code; // Например: ru-RU → ru, en-US → en. Неподдерживаемый язык → далее по списку. const base = code.split('-')[0]; return codes.has(base) ? base : ''; } function savedLanguage(languages) { try { return matchLanguage(globalThis.localStorage?.getItem(STORAGE_KEY), languages); } catch { return ''; } } export function resolvePreferredLanguage({ saved = '', browserLanguages = [], languages = availableLanguages, fallback = FALLBACK_LANGUAGE, } = {}) { const selected = matchLanguage(saved, languages); if (selected) return selected; for (const locale of browserLanguages) { const supported = matchLanguage(locale, languages); if (supported) return supported; } return matchLanguage(fallback, languages) || languages[0]?.code || FALLBACK_LANGUAGE; } function browserLanguages() { try { const list = globalThis.navigator?.languages; return Array.isArray(list) && list.length ? list : [globalThis.navigator?.language].filter(Boolean); } catch { return []; } } function preferredLanguage(languages) { return resolvePreferredLanguage({ saved: savedLanguage(languages), browserLanguages: browserLanguages(), languages, fallback: defaultLanguage, }); } activeLanguage = preferredLanguage(availableLanguages); function assetUrl(path) { const url = new URL(path, import.meta.url); const hash = String(globalThis.window?.__SHINE_BUILD_HASH__ || '').trim(); if (hash) url.searchParams.set('v', hash); return url; } async function readJson(path) { const response = await fetch(assetUrl(path), { cache: 'default' }); if (!response.ok) throw new Error(`i18n: ${path}: HTTP ${response.status}`); return response.json(); } function validateManifest(raw) { if (!raw || !Array.isArray(raw.languages)) return null; const codes = new Set(); const languages = raw.languages.flatMap((item) => { const code = normalizeCode(item?.code); if (!code || codes.has(code) || !String(item?.name || '').trim()) return []; codes.add(code); return [{ code, name: String(item.name).trim() }]; }); if (!languages.length) return null; return { languages, fallback: matchLanguage(raw.default, languages) || matchLanguage(FALLBACK_LANGUAGE, languages) || languages[0].code, }; } async function loadDictionary(code) { if (dictionaries.has(code)) return dictionaries.get(code); if (loadingDictionaries.has(code)) return loadingDictionaries.get(code); const promise = readJson(`./locales/${code}.json`) .then((data) => { if (!data || typeof data !== 'object' || Array.isArray(data)) throw new Error('Invalid locale dictionary'); dictionaries.set(code, data); return data; }) .catch((error) => { console.warn(`[i18n] Failed to load ${code}`, error); // Ошибка загрузки словаря не должна блокировать приложение; при следующем // переключении попытка может быть повторена. return {}; }) .finally(() => loadingDictionaries.delete(code)); loadingDictionaries.set(code, promise); return promise; } function updateDocumentLanguage() { if (globalThis.document?.documentElement) document.documentElement.lang = activeLanguage; } export function getLanguage() { return activeLanguage; } export function getLanguages() { return availableLanguages.map((item) => ({ ...item })); } export function getLanguageName(code = activeLanguage) { return availableLanguages.find((item) => item.code === code)?.name || code; } export async function initI18n() { if (initialized) return initialized; initialized = (async () => { try { const manifest = validateManifest(await readJson('./languages.json')); if (manifest) { availableLanguages = manifest.languages; defaultLanguage = manifest.fallback; } } catch (error) { console.warn('[i18n] Using built-in language list', error); } activeLanguage = preferredLanguage(availableLanguages); updateDocumentLanguage(); // Оба стартовых языка предзагружены: переключение ru ↔ en без ожидания сети. const preloaded = [defaultLanguage, activeLanguage, 'ru', 'en'] .filter((code) => availableLanguages.some((item) => item.code === code)); await Promise.all([...new Set(preloaded)].map(loadDictionary)); return activeLanguage; })(); return initialized; } function lookup(dictionary, key) { return key.split('.').reduce((value, part) => ( value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, part) ? value[part] : undefined ), dictionary); } // t('settings.save') или t('messages.unread', { count: 3 }); // Если перевода нет, используется английский словарь, затем сам ключ. export function t(key, variables = {}) { const path = String(key || ''); const translated = lookup(dictionaries.get(activeLanguage), path); const fallback = lookup(dictionaries.get(defaultLanguage), path); const russian = lookup(dictionaries.get('ru'), path); const text = typeof translated === 'string' ? translated : (typeof fallback === 'string' ? fallback : (typeof russian === 'string' ? russian : path)); return text.replace(/\{([a-zA-Z0-9_]+)\}/gu, (whole, name) => ( Object.prototype.hasOwnProperty.call(variables, name) ? String(variables[name]) : whole )); } export function th(key, variables = {}) { return t(key, variables).replace(/[&<>"']/gu, (character) => ({ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''', })[character]); } export function onLanguageChange(callback) { if (typeof callback !== 'function') return () => {}; subscribers.add(callback); return () => subscribers.delete(callback); } export async function setLanguage(value) { await initI18n(); const code = matchLanguage(value, availableLanguages); if (!code) return false; await loadDictionary(code); const changed = code !== activeLanguage; activeLanguage = code; updateDocumentLanguage(); try { globalThis.localStorage?.setItem(STORAGE_KEY, code); } catch {} if (changed) { subscribers.forEach((callback) => { try { callback(code); } catch (error) { console.error('[i18n] Language listener failed', error); } }); } return true; }