mirror of
https://github.com/stablyai/orca.git
synced 2026-11-17 03:15:01 +00:00
* 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>
78 lines
2.6 KiB
TypeScript
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
|
|
}
|