Add i18n foundation and translations (#1027)

* feat: add i18n foundation * feat: localize sessions sidebar * Localize multirun/scheduled tasks and fix dialog dropdown interactions * localize git sidebar surface and add zh-CN keys * feat(ui): localize context panel, diff/plan views, and context sidebar content * fix(config): resolve user config home via fs/home before embedded home * localize header/chat UI and complete model/worktree panel strings * localize worktree + github issue/pr dialog flows * localize settings sections and split settings i18n dictionaries * localize additional settings sections and sidebars * localize more settings pages and dialogs * fix settings select trigger localization * localize tunnel settings ui surface * localize additional settings sections * localize keyboard shortcuts labels in settings * localize terminal and utility dialogs surfaces * feat(i18n): localize remaining UI strings * Add Ukrainian locale * Add Spanish locale * Add Brazilian Portuguese locale * Polish locale translations
2026-04-26 14:03:39 +03:00
parent 87db2ea210
commit 7d7285655d
198 changed files with 24173 additions and 4365 deletions
@@ -0,0 +1,90 @@
+import { create } from 'zustand';
+
+import { dict as enDict, type I18nKey } from './messages/en';
+import { DEFAULT_LOCALE, detectInitialLocale, type Locale, writeStoredLocale } from './runtime';
+
+export type I18nParams = Record<string, string | number | boolean | null | undefined>;
+export type I18nDictionary = Record<I18nKey, string>;
+
+type I18nState = {
+  locale: Locale;
+  dictionary: I18nDictionary;
+  loadingLocale: Locale | null;
+  setLocale: (locale: Locale) => void;
+};
+
+const dictionaries = new Map<Locale, I18nDictionary>([[DEFAULT_LOCALE, enDict]]);
+
+async function loadDictionary(locale: Locale): Promise<I18nDictionary> {
+  const cached = dictionaries.get(locale);
+  if (cached) {
+    return cached;
+  }
+
+  const mod = locale === 'zh-CN'
+    ? await import('./messages/zh-CN') as { dict: I18nDictionary }
+    : locale === 'es'
+      ? await import('./messages/es') as { dict: I18nDictionary }
+    : locale === 'pt-BR'
+      ? await import('./messages/pt-BR') as { dict: I18nDictionary }
+    : locale === 'uk'
+      ? await import('./messages/uk') as { dict: I18nDictionary }
+      : { dict: enDict };
+  dictionaries.set(locale, mod.dict);
+  return mod.dict;
+}
+
+export const useI18nStore = create<I18nState>()((set, get) => ({
+  locale: DEFAULT_LOCALE,
+  dictionary: enDict,
+  loadingLocale: null,
+  setLocale: (locale) => {
+    const current = get();
+    if (current.locale === locale && current.loadingLocale !== locale) {
+      return;
+    }
+
+    writeStoredLocale(locale);
+
+    const cached = dictionaries.get(locale);
+    set({
+      locale,
+      dictionary: cached ?? current.dictionary,
+      loadingLocale: cached ? null : locale,
+    });
+
+    if (cached) {
+      return;
+    }
+
+    void loadDictionary(locale).then((dictionary) => {
+      if (get().locale !== locale) {
+        return;
+      }
+      set({ dictionary, loadingLocale: null });
+    }).catch((error) => {
+      console.error(`[i18n] failed to load locale ${locale}`, error);
+      if (get().locale === locale) {
+        set({ dictionary: enDict, loadingLocale: null });
+      }
+    });
+  },
+}));
+
+export function initializeLocale(): void {
+  useI18nStore.getState().setLocale(detectInitialLocale());
+}
+
+export function formatMessage(dictionary: I18nDictionary, key: I18nKey, params?: I18nParams): string {
+  const template = dictionary[key] ?? enDict[key] ?? key;
+  if (!params) {
+    return template;
+  }
+
+  return template.replace(/\{([^{}]+)\}/g, (match, rawKey) => {
+    const value = params[rawKey.trim()];
+    return value === null || value === undefined ? match : String(value);
+  });
+}
+
+export type { I18nKey, Locale };