pftom
af3f96379a
- Updated project name in package.json, package-lock.json, and README files. - Changed CLI commands and references from "ocd" to "od". - Adjusted file structure references in documentation and code to reflect new naming conventions. - Enhanced .gitignore to include new runtime data files. - Updated metadata in LICENSE file to match new project name.
122 lines
3.2 KiB
TypeScript
122 lines
3.2 KiB
TypeScript
import {
|
|
createContext,
|
|
useCallback,
|
|
useContext,
|
|
useEffect,
|
|
useMemo,
|
|
useState,
|
|
type ReactNode,
|
|
} from 'react';
|
|
import { en } from './locales/en';
|
|
import { zhCN } from './locales/zh-CN';
|
|
import { LOCALES, type Dict, type Locale } from './types';
|
|
|
|
export { LOCALES, LOCALE_LABEL } from './types';
|
|
export type { Locale } from './types';
|
|
|
|
type DictKey = keyof Dict;
|
|
|
|
const DICTS: Record<Locale, Dict> = {
|
|
'en': en,
|
|
'zh-CN': zhCN,
|
|
};
|
|
|
|
const LS_KEY = 'open-design:locale';
|
|
|
|
// First-run default is English. We honor an explicit user pick saved to
|
|
// localStorage but never auto-detect from `navigator.language`, so the
|
|
// initial experience is consistent and predictable.
|
|
function detectInitialLocale(): Locale {
|
|
if (typeof window === 'undefined') return 'en';
|
|
try {
|
|
const stored = window.localStorage.getItem(LS_KEY);
|
|
if (stored && (LOCALES as string[]).includes(stored)) {
|
|
return stored as Locale;
|
|
}
|
|
} catch {
|
|
/* ignore */
|
|
}
|
|
return 'en';
|
|
}
|
|
|
|
interface I18nContextValue {
|
|
locale: Locale;
|
|
setLocale: (next: Locale) => void;
|
|
t: (key: DictKey, vars?: Record<string, string | number>) => string;
|
|
}
|
|
|
|
const I18nContext = createContext<I18nContextValue | null>(null);
|
|
|
|
interface ProviderProps {
|
|
initial?: Locale;
|
|
children: ReactNode;
|
|
}
|
|
|
|
export function I18nProvider({ initial, children }: ProviderProps) {
|
|
const [locale, setLocaleState] = useState<Locale>(() => initial ?? detectInitialLocale());
|
|
|
|
// Keep <html lang="…"> in sync so screen readers and CSS hooks pick the
|
|
// right language token without each component having to set lang itself.
|
|
useEffect(() => {
|
|
if (typeof document !== 'undefined') {
|
|
document.documentElement.setAttribute('lang', locale);
|
|
}
|
|
}, [locale]);
|
|
|
|
const setLocale = useCallback((next: Locale) => {
|
|
setLocaleState(next);
|
|
try {
|
|
window.localStorage.setItem(LS_KEY, next);
|
|
} catch {
|
|
/* ignore */
|
|
}
|
|
}, []);
|
|
|
|
const t = useCallback(
|
|
(key: DictKey, vars?: Record<string, string | number>): string => {
|
|
const dict = DICTS[locale] ?? en;
|
|
const raw = dict[key] ?? en[key] ?? key;
|
|
if (!vars) return raw;
|
|
return raw.replace(/\{(\w+)\}/g, (_, name: string) => {
|
|
const v = vars[name];
|
|
return v == null ? `{${name}}` : String(v);
|
|
});
|
|
},
|
|
[locale],
|
|
);
|
|
|
|
const value = useMemo<I18nContextValue>(
|
|
() => ({ locale, setLocale, t }),
|
|
[locale, setLocale, t],
|
|
);
|
|
|
|
return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>;
|
|
}
|
|
|
|
export function useI18n(): I18nContextValue {
|
|
const ctx = useContext(I18nContext);
|
|
if (!ctx) {
|
|
// Fall back to a stand-alone English translator when no provider is
|
|
// mounted (e.g. an isolated test). This keeps the API safe to call
|
|
// without requiring every callsite to wrap in a provider.
|
|
return {
|
|
locale: 'en',
|
|
setLocale: () => {},
|
|
t: (key, vars) => {
|
|
const raw = en[key] ?? key;
|
|
if (!vars) return raw;
|
|
return raw.replace(/\{(\w+)\}/g, (_, n: string) => {
|
|
const v = vars[n];
|
|
return v == null ? `{${n}}` : String(v);
|
|
});
|
|
},
|
|
};
|
|
}
|
|
return ctx;
|
|
}
|
|
|
|
// Convenience for components that only need the translator function.
|
|
export function useT(): I18nContextValue['t'] {
|
|
return useI18n().t;
|
|
}
|