Max P.
4ac5dd4c88
- Adds support for `.jsonc` format alongside `.json` for locale files - Prioritizes `.jsonc` format when both file types are available
83 lines
2.8 KiB
TypeScript
83 lines
2.8 KiB
TypeScript
import { parse as parseJsonc } from '@std/jsonc';
|
|
|
|
/**
|
|
* Initializes the i18n module by loading
|
|
* the appropriate locale file based on the system language.
|
|
*/
|
|
export async function initI18n(): Promise<void> {
|
|
await loadLocale(getCurrentLanguage());
|
|
}
|
|
|
|
/**
|
|
* Contains the loaded translations for the current language.
|
|
* The keys represent i18n identifiers, the values are the localized strings.
|
|
*/
|
|
let translations: Record<string, string> = {};
|
|
|
|
/**
|
|
* Loads the translation file for the specified locale.
|
|
*
|
|
* Accepts both `.jsonc` (JSON with comments) and plain `.json`.
|
|
* When both exist, `.jsonc` takes precedence.
|
|
* Falls back to English ('en') if the specified file does not exist.
|
|
*
|
|
* @param locale - The language code (e.g., 'de', 'en') to load
|
|
* @returns Promise that resolves once the translations have been loaded
|
|
*/
|
|
export async function loadLocale(locale: string): Promise<void> {
|
|
const extensions = ['jsonc', 'json'];
|
|
for (const ext of extensions) {
|
|
try {
|
|
const localeUrl = new URL(`./${locale}.${ext}`, import.meta.url);
|
|
const raw = await Deno.readTextFile(localeUrl);
|
|
// parseJsonc tolerates both pure JSON and JSONC, so we can use it for either.
|
|
translations = parseJsonc(raw) as Record<string, string>;
|
|
return;
|
|
} catch (err) {
|
|
if (err instanceof Deno.errors.NotFound) {
|
|
// Continue with next extension.
|
|
continue;
|
|
}
|
|
console.error(`Error parsing locale '${locale}.${ext}':`, err);
|
|
break;
|
|
}
|
|
}
|
|
if (locale !== 'en') {
|
|
console.warn(`Locale '${locale}' not found – falling back to 'en'.`);
|
|
await loadLocale('en');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Translates a given key using the loaded translation data.
|
|
* Replaces placeholders in the format `{variable}` with the provided values.
|
|
*
|
|
* @param key - The i18n key (e.g., 'timer_created')
|
|
* @param vars - Optional replacements for placeholders in the string
|
|
* @returns The translated string, or the key itself if no translation is found
|
|
*/
|
|
export function t(key: string, vars: Record<string, string> = {}): string {
|
|
let text = translations[key] ?? key;
|
|
for (const [k, v] of Object.entries(vars)) {
|
|
text = text.replace(`{${k}}`, v);
|
|
}
|
|
return text;
|
|
}
|
|
|
|
/**
|
|
* Determines the current language from the system environment.
|
|
*
|
|
* Priority: SYSTEMD_TIMER_LANG > LC_ALL > LC_MESSAGES > LANG.
|
|
*
|
|
* @returns The language code (e.g., 'de', 'en'), defaults to 'en'
|
|
*/
|
|
export function getCurrentLanguage(): string {
|
|
return (
|
|
Deno.env.get('SYSTEMD_TIMER_LANG') ??
|
|
Deno.env.get('LC_ALL') ??
|
|
Deno.env.get('LC_MESSAGES') ??
|
|
Deno.env.get('LANG') ??
|
|
'en'
|
|
).split('.')[0].split('_')[0].toLowerCase();
|
|
}
|