Локализовать интерфейс SHiNE на русский и английский

This commit is contained in:
AidarKC
2026-11-09 16:45:21 +03:00
parent 526941eb33
commit 405b9a91a7
133 changed files with 12464 additions and 3296 deletions
+214
View File
@@ -0,0 +1,214 @@
// Один источник языка для всех профилей. Браузерные настройки имеют приоритет
// над системным языком. Списки и словари живут в соседних 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) => ({
'&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
})[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;
}
+13
View File
@@ -0,0 +1,13 @@
{
"default": "en",
"languages": [
{
"code": "ru",
"name": "Русский"
},
{
"code": "en",
"name": "English"
}
]
}
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff