talizen 0.2.0 → 0.2.1

package/i18n.d.ts

@@ -53,3 +53,25 @@ export type LinkProps = React.AnchorHTMLAttributes<HTMLAnchorElement> & {
  * ```
  */
 export declare function Link(props: LinkProps): React.ReactElement;
+/**
+ * 当前语言的 UI 文案（界面 chrome，非 CMS 内容）。由渲染引擎按当前 locale 从站点
+ * `/messages/{locale}.json` 读取、与默认语言逐 key 合并后注入 `globalThis.__TALIZEN_MESSAGES__`
+ * （SSR 与浏览器端一致）。缺失的 key 已在引擎侧回退默认语言，这里再兜底返回 key 本身。
+ */
+declare global {
+    var __TALIZEN_MESSAGES__: Record<string, unknown> | undefined;
+}
+/** 翻译函数：按 key 取文案（支持点路径），`{var}` 插值；缺失时返回 key 本身。 */
+export type Translator = (key: string, vars?: Record<string, unknown>) => string;
+/**
+ * 读取 UI 文案翻译器。`namespace` 可将后续 key 限定到 messages 的某个子树（对齐 next-intl）。
+ *
+ * ```tsx
+ * const t = useTranslations("home")
+ * t("title")                    // messages.home.title
+ * t("greeting", { name })       // "你好 {name}" -> "你好 小明"
+ * ```
+ *
+ * UI chrome 用 useTranslations；文章等内容用 CMS 字段级 _i18n（见 listContents/getContent）。
+ */
+export declare function useTranslations(namespace?: string): Translator;

package/i18n.js

@@ -60,3 +60,38 @@ export function Link(props) {
     };
     return React.createElement("a", { ...rest, href: finalHref, onClick: handleClick });
 }
+function readMessages() {
+    return (typeof globalThis !== "undefined" ? globalThis.__TALIZEN_MESSAGES__ : undefined) ?? {};
+}
+function lookupMessage(obj, path) {
+    let cur = obj;
+    for (const seg of path.split(".")) {
+        if (cur == null || typeof cur !== "object")
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+/**
+ * 读取 UI 文案翻译器。`namespace` 可将后续 key 限定到 messages 的某个子树（对齐 next-intl）。
+ *
+ * ```tsx
+ * const t = useTranslations("home")
+ * t("title")                    // messages.home.title
+ * t("greeting", { name })       // "你好 {name}" -> "你好 小明"
+ * ```
+ *
+ * UI chrome 用 useTranslations；文章等内容用 CMS 字段级 _i18n（见 listContents/getContent）。
+ */
+export function useTranslations(namespace) {
+    const messages = readMessages();
+    const scoped = namespace ? lookupMessage(messages, namespace) : messages;
+    const base = (scoped && typeof scoped === "object" ? scoped : {});
+    return (key, vars) => {
+        const raw = lookupMessage(base, key);
+        const text = typeof raw === "string" ? raw : key;
+        if (!vars)
+            return text;
+        return text.replace(/\{(\w+)\}/g, (_, k) => (k in vars ? String(vars[k]) : `{${k}}`));
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talizen",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Talizen frontend SDK types for cms, form and core.",
   "type": "module",
   "license": "MIT",