talizen 0.2.2 → 0.2.3

package/cms.js

@@ -1,12 +1,14 @@
 import { requestJson } from "./core.js";
-import { useLocale } from "./i18n.js";
+import { getLocale } from "./i18n.js";
 // 字段级本地化解码：把 body._i18n[当前语言] 覆盖到同级字段并删除 _i18n。
-// 线上渲染引擎已在服务端解码（body 无 _i18n）→ 此处 no-op；编辑器预览未解码 → 此处按当前语言解码。
+// 无论 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 = useLocale().locale;
+    const locale = getLocale().locale;
     const over = locale && _i18n ? _i18n[locale] : undefined;
     return over && typeof over === "object" ? { ...base, ...over } : base;
 }

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