talizen 0.2.1 → 0.2.3

package/cms.js

@@ -1,4 +1,20 @@
 import { requestJson } from "./core.js";
+import { getLocale } from "./i18n.js";
+// 字段级本地化解码：把 body._i18n[当前语言] 覆盖到同级字段并删除 _i18n。
+// 无论 SSR（getServerSideProps 取数）、客户端还是编辑器预览，都在此处按当前语言解码——
+// 渲染引擎不再解码 CMS，只透传原始 body（含 _i18n）。用 getLocale()（非 hook），
+// 因此在 getServerSideProps 里调用也合法。当前语言由引擎注入的 __TALIZEN_I18N__ 提供。
+function decodeBodyLocalization(body) {
+    if (!body || typeof body !== "object" || !("_i18n" in body))
+        return body;
+    const { _i18n, ...base } = body;
+    const locale = getLocale().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 +30,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 +40,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 +56,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

@@ -23,6 +23,20 @@ declare global {
  * ```
  */
 export declare function useLocale(): LocaleRuntime;
+/**
+ * 读取当前语言运行时信息——与 useLocale() 完全等价，但命名为 get*（**不是 hook**），
+ * 用于 getServerSideProps / generateMetadata 等**服务端取数场景**（对齐 next-intl 的 getLocale）。
+ * 组件渲染里用 useLocale()。SSR 与客户端返回一致。
+ *
+ * ```ts
+ * export async function getServerSideProps(ctx) {
+ *   const { locale } = getLocale()          // ✅ 服务端取数用 get*
+ *   const posts = await listContents("blog") // 内部按当前 locale 自动解码 CMS
+ *   return { props: { posts } }
+ * }
+ * ```
+ */
+export declare function getLocale(): LocaleRuntime;
 /**
  * 给站内路径加语言前缀（默认语言不加前缀）。不传 `locale` 时使用当前语言。
  * 站外链接（协议 / 协议相对 URL）与页内锚点（`#...`）原样返回。
@@ -63,15 +77,17 @@ declare global {
 }
 /** 翻译函数：按 key 取文案（支持点路径），`{var}` 插值；缺失时返回 key 本身。 */
 export type Translator = (key: string, vars?: Record<string, unknown>) => string;
+export declare function useTranslations(namespace?: string): Translator;
 /**
- * 读取 UI 文案翻译器。`namespace` 可将后续 key 限定到 messages 的某个子树（对齐 next-intl）。
+ * 读取 UI 文案翻译器——与 useTranslations() 等价，但命名为 get*（**不是 hook**），
+ * 用于 getServerSideProps / generateMetadata 等**服务端取数场景**（对齐 next-intl 的 getTranslations）。
+ * 组件渲染里用 useTranslations()。
  *
- * ```tsx
- * const t = useTranslations("home")
- * t("title")                    // messages.home.title
- * t("greeting", { name })       // "你好 {name}" -> "你好 小明"
+ * ```ts
+ * export async function generateMetadata() {
+ *   const t = getTranslations("seo")
+ *   return { title: t("home_title") }
+ * }
  * ```
- *
- * UI chrome 用 useTranslations；文章等内容用 CMS 字段级 _i18n（见 listContents/getContent）。
  */
-export declare function useTranslations(namespace?: string): Translator;
+export declare function getTranslations(namespace?: string): Translator;

package/i18n.js

@@ -19,6 +19,22 @@ function readLocaleRuntime() {
 export function useLocale() {
     return readLocaleRuntime();
 }
+/**
+ * 读取当前语言运行时信息——与 useLocale() 完全等价，但命名为 get*（**不是 hook**），
+ * 用于 getServerSideProps / generateMetadata 等**服务端取数场景**（对齐 next-intl 的 getLocale）。
+ * 组件渲染里用 useLocale()。SSR 与客户端返回一致。
+ *
+ * ```ts
+ * export async function getServerSideProps(ctx) {
+ *   const { locale } = getLocale()          // ✅ 服务端取数用 get*
+ *   const posts = await listContents("blog") // 内部按当前 locale 自动解码 CMS
+ *   return { props: { posts } }
+ * }
+ * ```
+ */
+export function getLocale() {
+    return readLocaleRuntime();
+}
 /**
  * 给站内路径加语言前缀（默认语言不加前缀）。不传 `locale` 时使用当前语言。
  * 站外链接（协议 / 协议相对 URL）与页内锚点（`#...`）原样返回。
@@ -83,7 +99,7 @@ function lookupMessage(obj, path) {
  *
  * UI chrome 用 useTranslations；文章等内容用 CMS 字段级 _i18n（见 listContents/getContent）。
  */
-export function useTranslations(namespace) {
+function buildTranslator(namespace) {
     const messages = readMessages();
     const scoped = namespace ? lookupMessage(messages, namespace) : messages;
     const base = (scoped && typeof scoped === "object" ? scoped : {});
@@ -95,3 +111,21 @@ export function useTranslations(namespace) {
         return text.replace(/\{(\w+)\}/g, (_, k) => (k in vars ? String(vars[k]) : `{${k}}`));
     };
 }
+export function useTranslations(namespace) {
+    return buildTranslator(namespace);
+}
+/**
+ * 读取 UI 文案翻译器——与 useTranslations() 等价，但命名为 get*（**不是 hook**），
+ * 用于 getServerSideProps / generateMetadata 等**服务端取数场景**（对齐 next-intl 的 getTranslations）。
+ * 组件渲染里用 useTranslations()。
+ *
+ * ```ts
+ * export async function generateMetadata() {
+ *   const t = getTranslations("seo")
+ *   return { title: t("home_title") }
+ * }
+ * ```
+ */
+export function getTranslations(namespace) {
+    return buildTranslator(namespace);
+}

package/package.json

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