Appearance
国际化翻译函数
系统概览
国际化翻译函数入口(ADR-059)。提供 t(key, params?) 函数,支持嵌套 key 和参数插值, 底层从 locale.ts 的语言状态获取当前语言,从语言包文件读取翻译文本。
核心职责
t.ts— 翻译函数实现、key 解析、参数插值。
对外 API(节选)
t(key, params?)— 翻译函数,支持嵌套 key 和参数插值。AVAILABLE_LANGS— 可用语言代码列表。
与其他子系统关系
- 语言状态:
./locale.ts。 - 语言包:
./locales/zh-CN.ts/zh-TW.ts/en.ts/ja.ts/ko.ts。 - 被 ar-camera/camera/env-bridge/props/model-loader/vmd-loader 等约 9 个模块直接引用。
不变量
- 单例,无状态。
- 翻译失败时降级为 key 本身,不抛异常。