@pactor-app/i18n 1.57.0 → 1.59.0

package/README.md

@@ -98,7 +98,7 @@ const schema = localizePageDsl({
 });
 ```
 
-统一处理 `$i18n.messages`、`$i18n.key` 与页面 `i18n.bindings` 三种声明；查找顺序为 当前 locale → 显式语言级回退（fallbacks 有序）→ defaultLocale → 描述 fallback（bindings 未显式配置时用目标字段原始字符串）→ key；空字符串视为有效翻译。返回新对象，不修改输入；静态结果输出字符串；含 `${...}` 运行时参数时编译为 `{ $localizedText: { template, params } }`；词条/fallback 含字面量 `${` 抛 `UNSAFE_MESSAGE`。
+统一处理 `$i18n.messages`、`$i18n.key` 与字段内 `$i18n{key:default}` 三种声明；查找顺序为 当前 locale → 显式语言级回退（fallbacks 有序）→ defaultLocale → 描述 fallback（简写中的 default）→ key；空字符串视为有效翻译。返回新对象，不修改输入；静态结果输出字符串；含 `${...}` 运行时参数时编译为 `{ $localizedText: { template, params } }`；词条/fallback 含字面量 `${` 抛 `UNSAFE_MESSAGE`。
 
 ## localizeYamlResource（Node 入口，YAML 资源编排）
 

package/dist/{chunk-3YCHXWF6.js → chunk-QU4YMNND.js}

@@ -529,12 +529,13 @@ var TranslatableFieldRegistry = class {
   }
 };
 function createDefaultTranslatableFieldRegistry() {
-  return new TranslatableFieldRegistry().register("Button", ["props.text", "props.label", "props.description", "props.ariaLabel"]).register("Text", ["props.text", "props.description", "props.ariaLabel"]).register("Input", [
+  return new TranslatableFieldRegistry().register("Page", "props.title").register("Card", "props.title").register("Statistic", "props.title").register("Alert", ["props.message", "props.description"]).register("Typography", "props.text").register("Login", ["props.brand.title", "props.title", "props.submitText"]).register("Header", ["props.user.items[*].label"]).register("DropdownMenu", ["props.items[*].label"]).register("Button", ["props.text", "props.label", "props.description", "props.ariaLabel"]).register("Text", ["props.text", "props.description", "props.ariaLabel"]).register("Input", [
     "props.text",
     "props.label",
     "props.placeholder",
     "props.description",
-    "props.ariaLabel"
+    "props.ariaLabel",
+    "props.rules[*].message"
   ]).register("Table", [
     "props.label",
     "props.description",
@@ -546,7 +547,7 @@ function createDefaultTranslatableFieldRegistry() {
     "props.description",
     "props.ariaLabel",
     "props.options[*].label"
-  ]).registerAction("message", ["params.text"]).registerAction("confirm", ["params.title", "params.content"]);
+  ]).register("DatePicker", ["props.placeholder", "props.presets[*].label"]).register("ToggleGroup", ["props.options[*].label"]).registerAction("message", ["params.text"]).registerAction("confirm", ["params.title", "params.content"]);
 }
 var defaultRegistry;
 function getDefaultTranslatableFieldRegistry() {
@@ -637,7 +638,6 @@ function resolveJsonPointer(root, segments, pointer) {
 // src/dsl-localizer.ts
 import { isDslSourceRef } from "@pactor-app/core";
 var MISSING_TRANSLATION_TEXT = "[missing translation]";
-var FORBIDDEN_BINDING_ROOTS = /* @__PURE__ */ new Set(["state", "dataSources", "requires", "meta", "i18n"]);
 function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -791,7 +791,32 @@ function convertDescriptor(ctx, desc, implicitFallback, path) {
   }
   return template;
 }
+function parseShorthand(value, path) {
+  const invalid = () => new I18nError("I18N_DESCRIPTOR_INVALID", `\u65E0\u6548\u7684\u56FD\u9645\u5316\u7B80\u5199: ${path}`, { path });
+  const colon = value.indexOf(":", 6);
+  if (!value.startsWith("$i18n{") || colon < 7) throw invalid();
+  const key = value.slice(6, colon);
+  if (!isValidMessageKey(key) || /[{}\\]/.test(key)) throw invalid();
+  let fallback = "";
+  for (let i = colon + 1; i < value.length; i++) {
+    const char = value[i];
+    if (char === "}") {
+      if (i !== value.length - 1 || fallback.includes("${")) throw invalid();
+      return { key, fallback };
+    }
+    if (char === "\\") {
+      const next = value[++i];
+      if (next !== "}" && next !== "\\") throw invalid();
+      fallback += next;
+    } else fallback += char;
+  }
+  throw invalid();
+}
 function walkValue(ctx, value, canonical, display, isTranslatable) {
+  if (typeof value === "string" && value.startsWith("$i18n{")) {
+    if (!isTranslatable(canonical)) throw new I18nError("UNREGISTERED_I18N_FIELD", `\u672A\u6CE8\u518C\u7684\u53EF\u7FFB\u8BD1\u5B57\u6BB5: ${display}`, { path: display });
+    return convertDescriptor(ctx, parseShorthand(value, display), void 0, display);
+  }
   if (Array.isArray(value)) {
     for (let i = 0; i < value.length; i += 1) {
       value[i] = walkValue(ctx, value[i], `${canonical}[*]`, `${display}/${i}`, isTranslatable);
@@ -799,6 +824,14 @@ function walkValue(ctx, value, canonical, display, isTranslatable) {
     return value;
   }
   if (isPlainObject3(value)) {
+    if (typeof value["type"] === "string" && isPlainObject3(value["props"])) {
+      walkNode(ctx, value, display);
+      return value;
+    }
+    if (typeof value["action"] === "string") {
+      walkAction(ctx, value, display);
+      return value;
+    }
     if ("$i18n" in value) {
       if (!isTranslatable(canonical)) {
         throw new I18nError(
@@ -887,55 +920,13 @@ function walkNode(ctx, node, display) {
     walkNode(ctx, node["children"], `${display}/children`);
   }
 }
-function assertBindingAllowed(segments, pointer) {
-  const root = segments[0];
-  if (root !== void 0 && FORBIDDEN_BINDING_ROOTS.has(root)) {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u8BE5\u5B57\u6BB5: ${pointer}`, { pointer });
-  }
-  if (root === "page" && segments[1] === "id") {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u9875\u9762\u6807\u8BC6: ${pointer}`, { pointer });
-  }
-  if (segments[segments.length - 1] === "permission") {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u6743\u9650\u5B57\u6BB5: ${pointer}`, { pointer });
-  }
-}
-function applyBindings(ctx, root, bindings) {
-  const seen = /* @__PURE__ */ new Map();
-  for (const [pointer, rawDesc] of Object.entries(bindings)) {
-    const segments = parseJsonPointer(pointer);
-    const canonical = segments.map(escapeJsonPointerSegment).join("/");
-    const previous = seen.get(canonical);
-    if (previous !== void 0) {
-      throw new I18nError("BINDING_INVALID", `bindings \u8DEF\u5F84\u91CD\u590D: ${previous} \u4E0E ${pointer}`, {
-        pointer,
-        previous
-      });
-    }
-    seen.set(canonical, pointer);
-    assertBindingAllowed(segments, pointer);
-    const desc = assertDescriptor(rawDesc, pointer);
-    const resolved = resolveJsonPointer(root, segments, pointer);
-    if (isPlainObject3(resolved.value) && "$i18n" in resolved.value) {
-      throw new I18nError(
-        "BINDING_CONFLICT",
-        `\u540C\u4E00\u5B57\u6BB5\u88AB $i18n \u4E0E bindings \u91CD\u590D\u58F0\u660E: ${pointer}`,
-        { pointer }
-      );
-    }
-    if (typeof resolved.value !== "string") {
-      throw new I18nError("BINDING_INVALID", `bindings \u76EE\u6807\u5FC5\u987B\u662F\u5B57\u7B26\u4E32: ${pointer}`, {
-        pointer,
-        valueType: Array.isArray(resolved.value) ? "array" : typeof resolved.value
-      });
-    }
-    const converted = convertDescriptor(ctx, desc, resolved.value, pointer);
-    resolved.parent[resolved.key] = converted;
-  }
-}
 function dedupeLocales(locales) {
   return [...new Set(locales)];
 }
 function assertNoResidualI18n(value, display) {
+  if (typeof value === "string" && value.startsWith("$i18n{")) {
+    throw new I18nError("UNREGISTERED_I18N_FIELD", `\u56FD\u9645\u5316\u7B80\u5199\u51FA\u73B0\u5728\u4E0D\u53EF\u7FFB\u8BD1\u7684\u4F4D\u7F6E: ${display}`, { path: display });
+  }
   if (Array.isArray(value)) {
     value.forEach((item, index) => assertNoResidualI18n(item, `${display}/${index}`));
     return;
@@ -974,12 +965,17 @@ function localizePageDsl(input) {
     namedComponents: isPlainObject3(page.components) ? page.components : void 0,
     onDiagnostic: input.onDiagnostic
   };
-  const authorI18n = page.i18n;
-  if (authorI18n !== void 0) {
-    if (isPlainObject3(authorI18n.bindings)) {
-      applyBindings(ctx, page, authorI18n.bindings);
+  if (isPlainObject3(page.i18n) && "bindings" in page.i18n) {
+    throw new I18nError("I18N_DESCRIPTOR_INVALID", "i18n.bindings \u5DF2\u79FB\u9664\uFF0C\u8BF7\u4F7F\u7528\u5B57\u6BB5\u5185\u7B80\u5199");
+  }
+  delete page.i18n;
+  if (isPlainObject3(page.page)) {
+    for (const field of ["title", "description"]) {
+      const value = page.page[field];
+      if (typeof value === "string" && value.startsWith("$i18n{")) {
+        page.page[field] = convertDescriptor(ctx, parseShorthand(value, `/page/${field}`), void 0, `/page/${field}`);
+      }
     }
-    delete page.i18n;
   }
   if (page.body !== void 0) {
     walkNode(ctx, page.body, "/body");

package/dist/index.cjs

@@ -572,12 +572,13 @@ var TranslatableFieldRegistry = class {
   }
 };
 function createDefaultTranslatableFieldRegistry() {
-  return new TranslatableFieldRegistry().register("Button", ["props.text", "props.label", "props.description", "props.ariaLabel"]).register("Text", ["props.text", "props.description", "props.ariaLabel"]).register("Input", [
+  return new TranslatableFieldRegistry().register("Page", "props.title").register("Card", "props.title").register("Statistic", "props.title").register("Alert", ["props.message", "props.description"]).register("Typography", "props.text").register("Login", ["props.brand.title", "props.title", "props.submitText"]).register("Header", ["props.user.items[*].label"]).register("DropdownMenu", ["props.items[*].label"]).register("Button", ["props.text", "props.label", "props.description", "props.ariaLabel"]).register("Text", ["props.text", "props.description", "props.ariaLabel"]).register("Input", [
     "props.text",
     "props.label",
     "props.placeholder",
     "props.description",
-    "props.ariaLabel"
+    "props.ariaLabel",
+    "props.rules[*].message"
   ]).register("Table", [
     "props.label",
     "props.description",
@@ -589,7 +590,7 @@ function createDefaultTranslatableFieldRegistry() {
     "props.description",
     "props.ariaLabel",
     "props.options[*].label"
-  ]).registerAction("message", ["params.text"]).registerAction("confirm", ["params.title", "params.content"]);
+  ]).register("DatePicker", ["props.placeholder", "props.presets[*].label"]).register("ToggleGroup", ["props.options[*].label"]).registerAction("message", ["params.text"]).registerAction("confirm", ["params.title", "params.content"]);
 }
 var defaultRegistry;
 function getDefaultTranslatableFieldRegistry() {
@@ -680,7 +681,6 @@ function resolveJsonPointer(root, segments, pointer) {
 // src/dsl-localizer.ts
 var import_core = require("@pactor-app/core");
 var MISSING_TRANSLATION_TEXT = "[missing translation]";
-var FORBIDDEN_BINDING_ROOTS = /* @__PURE__ */ new Set(["state", "dataSources", "requires", "meta", "i18n"]);
 function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -834,7 +834,32 @@ function convertDescriptor(ctx, desc, implicitFallback, path) {
   }
   return template;
 }
+function parseShorthand(value, path) {
+  const invalid = () => new I18nError("I18N_DESCRIPTOR_INVALID", `\u65E0\u6548\u7684\u56FD\u9645\u5316\u7B80\u5199: ${path}`, { path });
+  const colon = value.indexOf(":", 6);
+  if (!value.startsWith("$i18n{") || colon < 7) throw invalid();
+  const key = value.slice(6, colon);
+  if (!isValidMessageKey(key) || /[{}\\]/.test(key)) throw invalid();
+  let fallback = "";
+  for (let i = colon + 1; i < value.length; i++) {
+    const char = value[i];
+    if (char === "}") {
+      if (i !== value.length - 1 || fallback.includes("${")) throw invalid();
+      return { key, fallback };
+    }
+    if (char === "\\") {
+      const next = value[++i];
+      if (next !== "}" && next !== "\\") throw invalid();
+      fallback += next;
+    } else fallback += char;
+  }
+  throw invalid();
+}
 function walkValue(ctx, value, canonical, display, isTranslatable) {
+  if (typeof value === "string" && value.startsWith("$i18n{")) {
+    if (!isTranslatable(canonical)) throw new I18nError("UNREGISTERED_I18N_FIELD", `\u672A\u6CE8\u518C\u7684\u53EF\u7FFB\u8BD1\u5B57\u6BB5: ${display}`, { path: display });
+    return convertDescriptor(ctx, parseShorthand(value, display), void 0, display);
+  }
   if (Array.isArray(value)) {
     for (let i = 0; i < value.length; i += 1) {
       value[i] = walkValue(ctx, value[i], `${canonical}[*]`, `${display}/${i}`, isTranslatable);
@@ -842,6 +867,14 @@ function walkValue(ctx, value, canonical, display, isTranslatable) {
     return value;
   }
   if (isPlainObject3(value)) {
+    if (typeof value["type"] === "string" && isPlainObject3(value["props"])) {
+      walkNode(ctx, value, display);
+      return value;
+    }
+    if (typeof value["action"] === "string") {
+      walkAction(ctx, value, display);
+      return value;
+    }
     if ("$i18n" in value) {
       if (!isTranslatable(canonical)) {
         throw new I18nError(
@@ -930,55 +963,13 @@ function walkNode(ctx, node, display) {
     walkNode(ctx, node["children"], `${display}/children`);
   }
 }
-function assertBindingAllowed(segments, pointer) {
-  const root = segments[0];
-  if (root !== void 0 && FORBIDDEN_BINDING_ROOTS.has(root)) {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u8BE5\u5B57\u6BB5: ${pointer}`, { pointer });
-  }
-  if (root === "page" && segments[1] === "id") {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u9875\u9762\u6807\u8BC6: ${pointer}`, { pointer });
-  }
-  if (segments[segments.length - 1] === "permission") {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u6743\u9650\u5B57\u6BB5: ${pointer}`, { pointer });
-  }
-}
-function applyBindings(ctx, root, bindings) {
-  const seen = /* @__PURE__ */ new Map();
-  for (const [pointer, rawDesc] of Object.entries(bindings)) {
-    const segments = parseJsonPointer(pointer);
-    const canonical = segments.map(escapeJsonPointerSegment).join("/");
-    const previous = seen.get(canonical);
-    if (previous !== void 0) {
-      throw new I18nError("BINDING_INVALID", `bindings \u8DEF\u5F84\u91CD\u590D: ${previous} \u4E0E ${pointer}`, {
-        pointer,
-        previous
-      });
-    }
-    seen.set(canonical, pointer);
-    assertBindingAllowed(segments, pointer);
-    const desc = assertDescriptor(rawDesc, pointer);
-    const resolved = resolveJsonPointer(root, segments, pointer);
-    if (isPlainObject3(resolved.value) && "$i18n" in resolved.value) {
-      throw new I18nError(
-        "BINDING_CONFLICT",
-        `\u540C\u4E00\u5B57\u6BB5\u88AB $i18n \u4E0E bindings \u91CD\u590D\u58F0\u660E: ${pointer}`,
-        { pointer }
-      );
-    }
-    if (typeof resolved.value !== "string") {
-      throw new I18nError("BINDING_INVALID", `bindings \u76EE\u6807\u5FC5\u987B\u662F\u5B57\u7B26\u4E32: ${pointer}`, {
-        pointer,
-        valueType: Array.isArray(resolved.value) ? "array" : typeof resolved.value
-      });
-    }
-    const converted = convertDescriptor(ctx, desc, resolved.value, pointer);
-    resolved.parent[resolved.key] = converted;
-  }
-}
 function dedupeLocales(locales) {
   return [...new Set(locales)];
 }
 function assertNoResidualI18n(value, display) {
+  if (typeof value === "string" && value.startsWith("$i18n{")) {
+    throw new I18nError("UNREGISTERED_I18N_FIELD", `\u56FD\u9645\u5316\u7B80\u5199\u51FA\u73B0\u5728\u4E0D\u53EF\u7FFB\u8BD1\u7684\u4F4D\u7F6E: ${display}`, { path: display });
+  }
   if (Array.isArray(value)) {
     value.forEach((item, index) => assertNoResidualI18n(item, `${display}/${index}`));
     return;
@@ -1017,12 +1008,17 @@ function localizePageDsl(input) {
     namedComponents: isPlainObject3(page.components) ? page.components : void 0,
     onDiagnostic: input.onDiagnostic
   };
-  const authorI18n = page.i18n;
-  if (authorI18n !== void 0) {
-    if (isPlainObject3(authorI18n.bindings)) {
-      applyBindings(ctx, page, authorI18n.bindings);
+  if (isPlainObject3(page.i18n) && "bindings" in page.i18n) {
+    throw new I18nError("I18N_DESCRIPTOR_INVALID", "i18n.bindings \u5DF2\u79FB\u9664\uFF0C\u8BF7\u4F7F\u7528\u5B57\u6BB5\u5185\u7B80\u5199");
+  }
+  delete page.i18n;
+  if (isPlainObject3(page.page)) {
+    for (const field of ["title", "description"]) {
+      const value = page.page[field];
+      if (typeof value === "string" && value.startsWith("$i18n{")) {
+        page.page[field] = convertDescriptor(ctx, parseShorthand(value, `/page/${field}`), void 0, `/page/${field}`);
+      }
     }
-    delete page.i18n;
   }
   if (page.body !== void 0) {
     walkNode(ctx, page.body, "/body");

package/dist/index.d.cts

@@ -209,15 +209,14 @@ declare function resolveJsonPointer(root: unknown, segments: readonly string[],
  * DslLocalizer（设计第 4、6、7、8 节，缺口 G03/G04/G17）。
  *
  * 纯转换入口：语言包作为参数显式传入，不在遍历组件时自行请求。
- * 统一处理三种声明方式（`$i18n.messages`、`$i18n.key`、页面 `i18n.bindings`），
+ * 统一处理三种声明方式（`$i18n.messages`、`$i18n.key`、字段内简写），
  * 返回已本地化的新对象（不修改输入）；编译后移除作者态 `i18n` 字段。
  */
-/** 翻译描述（bindings 值与 `$i18n` 内层共用形态） */
+/** 翻译描述（`$i18n` 内层形态） */
 type TranslationDescriptor = I18nKeyRef | I18nInlineMessages;
 /** 页面作者态 i18n 字段（设计 4.2） */
 interface AuthorPageI18n {
     namespaces?: string[];
-    bindings?: Record<string, TranslationDescriptor>;
 }
 /** 作者态 Page DSL（PageDsl + 顶层 i18n 字段） */
 type AuthorPageDsl = PageDsl & {

package/dist/index.d.ts

@@ -209,15 +209,14 @@ declare function resolveJsonPointer(root: unknown, segments: readonly string[],
  * DslLocalizer（设计第 4、6、7、8 节，缺口 G03/G04/G17）。
  *
  * 纯转换入口：语言包作为参数显式传入，不在遍历组件时自行请求。
- * 统一处理三种声明方式（`$i18n.messages`、`$i18n.key`、页面 `i18n.bindings`），
+ * 统一处理三种声明方式（`$i18n.messages`、`$i18n.key`、字段内简写），
  * 返回已本地化的新对象（不修改输入）；编译后移除作者态 `i18n` 字段。
  */
-/** 翻译描述（bindings 值与 `$i18n` 内层共用形态） */
+/** 翻译描述（`$i18n` 内层形态） */
 type TranslationDescriptor = I18nKeyRef | I18nInlineMessages;
 /** 页面作者态 i18n 字段（设计 4.2） */
 interface AuthorPageI18n {
     namespaces?: string[];
-    bindings?: Record<string, TranslationDescriptor>;
 }
 /** 作者态 Page DSL（PageDsl + 顶层 i18n 字段） */
 type AuthorPageDsl = PageDsl & {

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   resolveJsonPointer,
   resolveRequestLocale,
   validateBundleSetEnvelope
-} from "./chunk-3YCHXWF6.js";
+} from "./chunk-QU4YMNND.js";
 export {
   ApiMessageProvider,
   I18nError,

package/dist/node.cjs

@@ -576,12 +576,13 @@ var TranslatableFieldRegistry = class {
   }
 };
 function createDefaultTranslatableFieldRegistry() {
-  return new TranslatableFieldRegistry().register("Button", ["props.text", "props.label", "props.description", "props.ariaLabel"]).register("Text", ["props.text", "props.description", "props.ariaLabel"]).register("Input", [
+  return new TranslatableFieldRegistry().register("Page", "props.title").register("Card", "props.title").register("Statistic", "props.title").register("Alert", ["props.message", "props.description"]).register("Typography", "props.text").register("Login", ["props.brand.title", "props.title", "props.submitText"]).register("Header", ["props.user.items[*].label"]).register("DropdownMenu", ["props.items[*].label"]).register("Button", ["props.text", "props.label", "props.description", "props.ariaLabel"]).register("Text", ["props.text", "props.description", "props.ariaLabel"]).register("Input", [
     "props.text",
     "props.label",
     "props.placeholder",
     "props.description",
-    "props.ariaLabel"
+    "props.ariaLabel",
+    "props.rules[*].message"
   ]).register("Table", [
     "props.label",
     "props.description",
@@ -593,7 +594,7 @@ function createDefaultTranslatableFieldRegistry() {
     "props.description",
     "props.ariaLabel",
     "props.options[*].label"
-  ]).registerAction("message", ["params.text"]).registerAction("confirm", ["params.title", "params.content"]);
+  ]).register("DatePicker", ["props.placeholder", "props.presets[*].label"]).register("ToggleGroup", ["props.options[*].label"]).registerAction("message", ["params.text"]).registerAction("confirm", ["params.title", "params.content"]);
 }
 var defaultRegistry;
 function getDefaultTranslatableFieldRegistry() {
@@ -684,7 +685,6 @@ function resolveJsonPointer(root, segments, pointer) {
 // src/dsl-localizer.ts
 var import_core = require("@pactor-app/core");
 var MISSING_TRANSLATION_TEXT = "[missing translation]";
-var FORBIDDEN_BINDING_ROOTS = /* @__PURE__ */ new Set(["state", "dataSources", "requires", "meta", "i18n"]);
 function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -838,7 +838,32 @@ function convertDescriptor(ctx, desc, implicitFallback, path) {
   }
   return template;
 }
+function parseShorthand(value, path) {
+  const invalid = () => new I18nError("I18N_DESCRIPTOR_INVALID", `\u65E0\u6548\u7684\u56FD\u9645\u5316\u7B80\u5199: ${path}`, { path });
+  const colon = value.indexOf(":", 6);
+  if (!value.startsWith("$i18n{") || colon < 7) throw invalid();
+  const key = value.slice(6, colon);
+  if (!isValidMessageKey(key) || /[{}\\]/.test(key)) throw invalid();
+  let fallback = "";
+  for (let i = colon + 1; i < value.length; i++) {
+    const char = value[i];
+    if (char === "}") {
+      if (i !== value.length - 1 || fallback.includes("${")) throw invalid();
+      return { key, fallback };
+    }
+    if (char === "\\") {
+      const next = value[++i];
+      if (next !== "}" && next !== "\\") throw invalid();
+      fallback += next;
+    } else fallback += char;
+  }
+  throw invalid();
+}
 function walkValue(ctx, value, canonical, display, isTranslatable) {
+  if (typeof value === "string" && value.startsWith("$i18n{")) {
+    if (!isTranslatable(canonical)) throw new I18nError("UNREGISTERED_I18N_FIELD", `\u672A\u6CE8\u518C\u7684\u53EF\u7FFB\u8BD1\u5B57\u6BB5: ${display}`, { path: display });
+    return convertDescriptor(ctx, parseShorthand(value, display), void 0, display);
+  }
   if (Array.isArray(value)) {
     for (let i = 0; i < value.length; i += 1) {
       value[i] = walkValue(ctx, value[i], `${canonical}[*]`, `${display}/${i}`, isTranslatable);
@@ -846,6 +871,14 @@ function walkValue(ctx, value, canonical, display, isTranslatable) {
     return value;
   }
   if (isPlainObject3(value)) {
+    if (typeof value["type"] === "string" && isPlainObject3(value["props"])) {
+      walkNode(ctx, value, display);
+      return value;
+    }
+    if (typeof value["action"] === "string") {
+      walkAction(ctx, value, display);
+      return value;
+    }
     if ("$i18n" in value) {
       if (!isTranslatable(canonical)) {
         throw new I18nError(
@@ -934,55 +967,13 @@ function walkNode(ctx, node, display) {
     walkNode(ctx, node["children"], `${display}/children`);
   }
 }
-function assertBindingAllowed(segments, pointer) {
-  const root = segments[0];
-  if (root !== void 0 && FORBIDDEN_BINDING_ROOTS.has(root)) {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u8BE5\u5B57\u6BB5: ${pointer}`, { pointer });
-  }
-  if (root === "page" && segments[1] === "id") {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u9875\u9762\u6807\u8BC6: ${pointer}`, { pointer });
-  }
-  if (segments[segments.length - 1] === "permission") {
-    throw new I18nError("BINDING_INVALID", `bindings \u7981\u6B62\u7ED1\u5B9A\u6743\u9650\u5B57\u6BB5: ${pointer}`, { pointer });
-  }
-}
-function applyBindings(ctx, root, bindings) {
-  const seen = /* @__PURE__ */ new Map();
-  for (const [pointer, rawDesc] of Object.entries(bindings)) {
-    const segments = parseJsonPointer(pointer);
-    const canonical = segments.map(escapeJsonPointerSegment).join("/");
-    const previous = seen.get(canonical);
-    if (previous !== void 0) {
-      throw new I18nError("BINDING_INVALID", `bindings \u8DEF\u5F84\u91CD\u590D: ${previous} \u4E0E ${pointer}`, {
-        pointer,
-        previous
-      });
-    }
-    seen.set(canonical, pointer);
-    assertBindingAllowed(segments, pointer);
-    const desc = assertDescriptor(rawDesc, pointer);
-    const resolved = resolveJsonPointer(root, segments, pointer);
-    if (isPlainObject3(resolved.value) && "$i18n" in resolved.value) {
-      throw new I18nError(
-        "BINDING_CONFLICT",
-        `\u540C\u4E00\u5B57\u6BB5\u88AB $i18n \u4E0E bindings \u91CD\u590D\u58F0\u660E: ${pointer}`,
-        { pointer }
-      );
-    }
-    if (typeof resolved.value !== "string") {
-      throw new I18nError("BINDING_INVALID", `bindings \u76EE\u6807\u5FC5\u987B\u662F\u5B57\u7B26\u4E32: ${pointer}`, {
-        pointer,
-        valueType: Array.isArray(resolved.value) ? "array" : typeof resolved.value
-      });
-    }
-    const converted = convertDescriptor(ctx, desc, resolved.value, pointer);
-    resolved.parent[resolved.key] = converted;
-  }
-}
 function dedupeLocales(locales) {
   return [...new Set(locales)];
 }
 function assertNoResidualI18n(value, display) {
+  if (typeof value === "string" && value.startsWith("$i18n{")) {
+    throw new I18nError("UNREGISTERED_I18N_FIELD", `\u56FD\u9645\u5316\u7B80\u5199\u51FA\u73B0\u5728\u4E0D\u53EF\u7FFB\u8BD1\u7684\u4F4D\u7F6E: ${display}`, { path: display });
+  }
   if (Array.isArray(value)) {
     value.forEach((item, index) => assertNoResidualI18n(item, `${display}/${index}`));
     return;
@@ -1021,12 +1012,17 @@ function localizePageDsl(input) {
     namedComponents: isPlainObject3(page.components) ? page.components : void 0,
     onDiagnostic: input.onDiagnostic
   };
-  const authorI18n = page.i18n;
-  if (authorI18n !== void 0) {
-    if (isPlainObject3(authorI18n.bindings)) {
-      applyBindings(ctx, page, authorI18n.bindings);
+  if (isPlainObject3(page.i18n) && "bindings" in page.i18n) {
+    throw new I18nError("I18N_DESCRIPTOR_INVALID", "i18n.bindings \u5DF2\u79FB\u9664\uFF0C\u8BF7\u4F7F\u7528\u5B57\u6BB5\u5185\u7B80\u5199");
+  }
+  delete page.i18n;
+  if (isPlainObject3(page.page)) {
+    for (const field of ["title", "description"]) {
+      const value = page.page[field];
+      if (typeof value === "string" && value.startsWith("$i18n{")) {
+        page.page[field] = convertDescriptor(ctx, parseShorthand(value, `/page/${field}`), void 0, `/page/${field}`);
+      }
     }
-    delete page.i18n;
   }
   if (page.body !== void 0) {
     walkNode(ctx, page.body, "/body");

package/dist/node.js

@@ -17,7 +17,7 @@ import {
   resolveJsonPointer,
   resolveRequestLocale,
   validateBundleSetEnvelope
-} from "./chunk-3YCHXWF6.js";
+} from "./chunk-QU4YMNND.js";
 
 // src/yaml-message-provider.ts
 import { isMap, isPair, isScalar, isSeq, parseDocument } from "yaml";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/i18n",
-  "version": "1.57.0",
+  "version": "1.59.0",
   "description": "Pactor i18n: request locale resolution and message bundle providers (YAML / API)",
   "keywords": [
     "pactor",
@@ -56,8 +56,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pactor-app/core": "1.57.0",
-    "@pactor-app/schema": "1.57.0"
+    "@pactor-app/core": "1.59.0",
+    "@pactor-app/schema": "1.59.0"
   },
   "peerDependencies": {
     "yaml": "^2.9.0"