i18n.js

'use strict';

// Interface localization. Visible strings live in each plugin's src/locales/<lang>.js
// keyed by a stable id; missing keys fall back to English, so a partial locale still
// works. The plugin passes its own locale set to initI18n. Language follows Obsidian's
// interface language, read once at init — Obsidian reloads on a language change anyway.
//
// Strings the whole family shows live in ./locales/, folded in by withFamily() below.
let LOCALES = { en: {} };
let dict = LOCALES.en;
let pluralRules = new Intl.PluralRules('en');

function initI18n(locales) {
  LOCALES = locales;
  const sys = (window.localStorage.getItem('language') || '').split('-')[0].toLowerCase();
  const locale = LOCALES[sys] ? sys : 'en';
  dict = LOCALES[locale];
  try { pluralRules = new Intl.PluralRules(locale); } catch (e) { pluralRules = new Intl.PluralRules('en'); }
}

function interpolate(str, vars) {
  if (!vars) return str;
  return str.replace(/\{(\w+)\}/g, (m, k) => (k in vars ? String(vars[k]) : m));
}

function t(key, vars) {
  let entry = dict[key];
  if (entry === undefined) entry = LOCALES.en[key];
  if (entry === undefined) return key;
  return interpolate(entry, vars);
}

// Localized "N noun" phrase. plural.<noun> holds per-category forms
// ({ one, few, many, other } — a subset is fine, missing ones fall back to other).
// pluralRules may not match the dict's locale on platforms with limited Intl data,
// so never assume the selected category exists.
function plural(noun, n) {
  const forms = dict['plural.' + noun] || LOCALES.en['plural.' + noun];
  if (!forms) return n + ' ' + noun;
  let cat;
  try { cat = pluralRules.select(n); } catch (e) { cat = 'other'; }
  const tpl = forms[cat] != null ? forms[cat] : (forms.other != null ? forms.other : Object.values(forms)[0]);
  return interpolate(tpl, { n });
}

// The plugin's own locales with the family's folded in underneath. `kind` is 'prose' or
// 'sigil'; the family's common set applies to both.
//
// Only languages the plugin itself ships are merged: giving it a language it has no
// translation for would swap a consistently-English UI for a half-translated one. And the
// plugin's own table is applied last, so a plugin that needs different wording for a family
// key just keeps that key.
// Required statically, one per line: esbuild can only follow a literal path, and a computed
// one is left in the bundle as a runtime require that Obsidian cannot resolve — which stops
// the plugin loading at all.
const FAMILY = {
  common: require('./locales/common'),
  prose: require('./locales/prose'),
  sigil: require('./locales/sigil'),
};

function withFamily(kind, pluginLocales) {
  const common = FAMILY.common;
  const pair = FAMILY[kind] || {};
  const out = {};
  for (const lang of Object.keys(pluginLocales)) {
    out[lang] = Object.assign({}, common[lang], pair[lang], pluginLocales[lang]);
  }
  return out;
}

module.exports = { initI18n, t, plural, withFamily };