c317fbc489
Registrations declare a dictionary namespace (locale: NS) and the renderer
synthesizes a typed t prop for the entry's component from the installed
LocaleFace; the seat binding is re-derived per locale revision, so a language
switch hands out fresh t references and memoized consumers re-render through
ordinary shallow comparison. LocaleNamespaceMap is the declare-merge table
(namespace -> dictionary key union); TranslateNS<'ns'> is the
namespace-addressed translate type (namespace keys plus the shared common
vocabulary), carried by the t seat and by the locale service's typed bind.
LocaleService implements the face (lookup ns -> common -> zh -> key,
revision-carrying snapshots with subscriber isolation) and installs it
through the boot-once slots.installLocale seam, mirroring the renderer
install. The typed register(ns, {zh, en}) overload checks each dictionary
against the namespace's key union and requires every shipped locale, so a
missing or extra key and an unbalanced translation are compile errors.
Dictionary registration bumps the face revision without emitting
locale/change — the event now means exactly 'the active locale switched',
so registration-heavy boot cannot storm event listeners.
15 lines
493 B
TypeScript
15 lines
493 B
TypeScript
/** `settings.locale` namespace dictionaries (the Language row's copy). */
|
|
|
|
/** Simplified Chinese dictionary (the key-set source of truth). */
|
|
export const zh = {
|
|
'language.title': '语言',
|
|
} satisfies Record<string, string>
|
|
|
|
/** The settings.locale namespace key union. */
|
|
export type SettingsLocaleKey = keyof typeof zh
|
|
|
|
/** English dictionary, checked complete against the zh key set. */
|
|
export const en = {
|
|
'language.title': 'Language',
|
|
} satisfies Record<SettingsLocaleKey, string>
|