talizen 0.2.0 → 0.2.2

package/cms.js

@@ -1,4 +1,18 @@
 import { requestJson } from "./core.js";
+import { useLocale } from "./i18n.js";
+// 字段级本地化解码：把 body._i18n[当前语言] 覆盖到同级字段并删除 _i18n。
+// 线上渲染引擎已在服务端解码（body 无 _i18n）→ 此处 no-op；编辑器预览未解码 → 此处按当前语言解码。
+function decodeBodyLocalization(body) {
+    if (!body || typeof body !== "object" || !("_i18n" in body))
+        return body;
+    const { _i18n, ...base } = body;
+    const locale = useLocale().locale;
+    const over = locale && _i18n ? _i18n[locale] : undefined;
+    return over && typeof over === "object" ? { ...base, ...over } : base;
+}
+function decodeItem(item) {
+    return item && item.body ? { ...item, body: decodeBodyLocalization(item.body) } : item;
+}
 export async function getContentCollection(key, options) {
     return requestJson(`/cms/${key}`, undefined, options);
 }
@@ -14,6 +28,8 @@ export async function listContents(key, params = {}, options) {
             filter: params.filter,
         }),
     }, options);
+    if (response.list)
+        response.list = response.list.map(decodeItem);
     return response;
 }
 export async function getContent(key, slug, params, options) {
@@ -22,10 +38,11 @@ export async function getContent(key, slug, params, options) {
     if (params?.builtinRef != null) {
         url.searchParams.set("builtin_ref", String(params.builtinRef));
     }
-    return requestJson(url.pathname + url.search, undefined, options);
+    const item = await requestJson(url.pathname + url.search, undefined, options);
+    return decodeItem(item);
 }
 export async function getContentWithPrevNext(key, slug, params = {}, options) {
-    return requestJson(`/cms/${key}/content_with_prev_next`, {
+    const res = await requestJson(`/cms/${key}/content_with_prev_next`, {
         method: "POST",
         body: JSON.stringify({
             slug,
@@ -37,4 +54,9 @@ export async function getContentWithPrevNext(key, slug, params = {}, options) {
             filter: params.filter,
         }),
     }, options);
+    return {
+        current: res.current ? decodeItem(res.current) : res.current,
+        next: res.next ? decodeItem(res.next) : res.next,
+        prev: res.prev ? decodeItem(res.prev) : res.prev,
+    };
 }

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.2",
   "description": "Talizen frontend SDK types for cms, form and core.",
   "type": "module",
   "license": "MIT",