Files
orca/src/shared/ui-language.ts
T
OrcaWinandOrcaWin 12a7d4c13a feat(mobile): localization infrastructure and language setting (#35399)
* feat(mobile): add UI localization infrastructure

Mobile follows the phone's language (or an in-app choice under Settings > Appearance)
across the same 11 languages as desktop, switching live like the theme does.

- i18next with desktop's translate(key, fallback, options) call shape; catalogs in
  mobile/src/i18n/locales load lazily, English fallbacks stay inline
- Hermes lacks Intl.PluralRules: load the FormatJS polyfill with the 11 languages' rules
- OTA pages get the shell's language through an optional bridge init field
- iOS permission prompts localized; iOS and Android 13+ per-app language pickers
- verify:mobile-localization and a coverage ratchet run in lint, check:changed and CI

* fix(mobile): mount pages after the newest language request; tighten localization gates

- Wait for the latest page language activation, not a superseded one
- Keep literal fallbacks when a key also has a dynamic one
- Count headerTitle as visible copy; select the mobile check when the runtime catalog generator changes

* feat(mobile): repaint themed components on language changes

Components that read the theme already subscribe for repaint; a language switch
repaints them too, so labels built by helpers during render follow it. RPC
recordings load the real i18next and JSON catalogs.

* fix(mobile): scope the translate() gate to render bodies and memos; prune stale keys on sync

Handlers and effects may call translate() when they run. sync:mobile-localization now
removes keys no code references from every catalog.

* fix(mobile): use node: imports in the locale config plugin; pass uiLocale in bridge hook test

* chore(mobile): refresh the localization coverage baseline

* fix(mobile): follow render callbacks in the translate() gate; keep used plural siblings on prune

Also let anonymous default-exported screens count as components, flag any plural
family a locale started, and mark JSON modules as ES modules in the recording loader.

* fix(mobile): treat async and named local callbacks as handlers in the translate() gate

* chore(mobile): refresh the localization coverage baseline

* chore(mobile): refresh the localization coverage baseline

---------

Co-authored-by: OrcaWin <293788423+OrcaWin@users.noreply.github.com>
2026-10-28 17:14:05 -07:00

78 lines
2.6 KiB
TypeScript

export const UI_LANGUAGE_SYSTEM = 'system'
export const UI_LANGUAGE_ENGLISH = 'en'
export const UI_LANGUAGE_CHINESE = 'zh'
// Why: a script subtag, not a region — zh-Hant also serves zh-TW/zh-HK/zh-MO users.
export const UI_LANGUAGE_CHINESE_TRADITIONAL = 'zh-Hant'
export const UI_LANGUAGE_KOREAN = 'ko'
export const UI_LANGUAGE_JAPANESE = 'ja'
export const UI_LANGUAGE_SPANISH = 'es'
export const UI_LANGUAGE_FRENCH = 'fr'
export const UI_LANGUAGE_PORTUGUESE = 'pt'
export const UI_LANGUAGE_RUSSIAN = 'ru'
export const UI_LANGUAGE_TURKISH = 'tr'
export const UI_LANGUAGE_GERMAN = 'de'
export type BuiltInUiLanguage =
| typeof UI_LANGUAGE_SYSTEM
| typeof UI_LANGUAGE_ENGLISH
| typeof UI_LANGUAGE_CHINESE
| typeof UI_LANGUAGE_CHINESE_TRADITIONAL
| typeof UI_LANGUAGE_KOREAN
| typeof UI_LANGUAGE_JAPANESE
| typeof UI_LANGUAGE_SPANISH
| typeof UI_LANGUAGE_FRENCH
| typeof UI_LANGUAGE_PORTUGUESE
| typeof UI_LANGUAGE_RUSSIAN
| typeof UI_LANGUAGE_TURKISH
| typeof UI_LANGUAGE_GERMAN
export type PluginUiLanguage = `plugin:${string}`
export type UiLanguage = BuiltInUiLanguage | PluginUiLanguage
// Each language in its own script, so someone stuck in a language they cannot read can find theirs.
export const UI_LANGUAGE_NATIVE_NAMES: Record<BuiltInUiLanguage, string> = {
[UI_LANGUAGE_SYSTEM]: 'System',
[UI_LANGUAGE_ENGLISH]: 'English',
[UI_LANGUAGE_CHINESE]: '中文(简体)',
[UI_LANGUAGE_CHINESE_TRADITIONAL]: '繁體中文(台灣)',
[UI_LANGUAGE_KOREAN]: '한국어',
[UI_LANGUAGE_JAPANESE]: '日本語',
[UI_LANGUAGE_SPANISH]: 'Español',
[UI_LANGUAGE_FRENCH]: 'Français',
[UI_LANGUAGE_PORTUGUESE]: 'Português (Brasil)',
[UI_LANGUAGE_RUSSIAN]: 'Русский',
[UI_LANGUAGE_TURKISH]: 'Türkçe',
[UI_LANGUAGE_GERMAN]: 'Deutsch'
}
const UI_LANGUAGE_VALUES = new Set<BuiltInUiLanguage>([
UI_LANGUAGE_SYSTEM,
UI_LANGUAGE_ENGLISH,
UI_LANGUAGE_CHINESE,
UI_LANGUAGE_CHINESE_TRADITIONAL,
UI_LANGUAGE_KOREAN,
UI_LANGUAGE_JAPANESE,
UI_LANGUAGE_SPANISH,
UI_LANGUAGE_FRENCH,
UI_LANGUAGE_PORTUGUESE,
UI_LANGUAGE_RUSSIAN,
UI_LANGUAGE_TURKISH,
UI_LANGUAGE_GERMAN
])
const PLUGIN_UI_LANGUAGE_RE =
/^plugin:[a-z0-9]+(?:-[a-z0-9]+)*\.[a-z0-9]+(?:-[a-z0-9]+)*\/[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/i
export function isPluginUiLanguage(value: unknown): value is PluginUiLanguage {
return typeof value === 'string' && PLUGIN_UI_LANGUAGE_RE.test(value)
}
export function normalizeUiLanguage(value: unknown): UiLanguage {
if (isPluginUiLanguage(value)) {
return value
}
return UI_LANGUAGE_VALUES.has(value as BuiltInUiLanguage)
? (value as BuiltInUiLanguage)
: UI_LANGUAGE_SYSTEM
}