markuplint/lib/i18n.js

An HTML linter for all markup developers

import { osLocale } from 'os-locale';
import { getJsonModule } from './get-json-module.js';
let cachedLocale = null;
async function getLocale() {
    if (!cachedLocale) {
        cachedLocale = await osLocale({ spawn: true });
    }
    return cachedLocale;
}
/**
 * Loads the locale-specific message set for use in violation messages.
 *
 * If no locale is provided, it auto-detects the OS locale. When the requested
 * locale is not available, it falls back to English (`en`).
 *
 * @param locale - An optional BCP 47 locale string (e.g., `"ja"`, `"en-US"`).
 * @returns The loaded locale set containing translated messages and the resolved locale code.
 */
export async function i18n(locale) {
    locale = locale ?? (await getLocale()) ?? 'en';
    const langCode = locale.split('-')[0] ?? locale;
    const loadLocaleSet = getJsonModule(`@markuplint/i18n/locales/${langCode}.json`);
    const localeSet = loadLocaleSet ?? getJsonModule('@markuplint/i18n/locales/en.json');
    return {
        ...localeSet,
        locale: loadLocaleSet ? langCode : 'en',
    };
}