Files
orca/config/scripts/localization-surfaces.mjs
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

34 lines
1.3 KiB
JavaScript

import path from 'node:path'
// Desktop and mobile ship separate catalogs under one contract: same call shape, key rules and gates.
export const LOCALIZATION_SURFACES = {
desktop: {
localesDir: path.join('src', 'renderer', 'src', 'i18n', 'locales'),
sourceRoots: [path.join('src', 'renderer', 'src'), path.join('src', 'main')],
runtimeRequiredPath: path.join('src', 'renderer', 'src', 'i18n', 'en-runtime-required.json'),
syncCatalogCommand: 'pnpm run sync:localization-catalog',
syncRuntimeCatalogCommand: 'pnpm run sync:localization-runtime-catalog'
},
mobile: {
localesDir: path.join('mobile', 'src', 'i18n', 'locales'),
sourceRoots: [
path.join('mobile', 'app'),
path.join('mobile', 'src'),
path.join('mobile', 'web-entry')
],
runtimeRequiredPath: path.join('mobile', 'src', 'i18n', 'en-runtime-required.json'),
syncCatalogCommand: 'pnpm run sync:mobile-localization',
syncRuntimeCatalogCommand: 'pnpm run sync:mobile-localization'
}
}
export function readLocalizationSurface(argv) {
const index = argv.indexOf('--surface')
const name = index === -1 ? 'desktop' : argv[index + 1]
const surface = Object.hasOwn(LOCALIZATION_SURFACES, name) ? LOCALIZATION_SURFACES[name] : null
if (!surface) {
throw new Error(`Unknown localization surface: ${String(name)}`)
}
return surface
}