@shwfed/config 2.4.1 → 2.5.1

package/dist/mcp.mjs

@@ -14094,13 +14094,13 @@ function requireDataType() {
   }
   return dataType;
 }
-var defaults$l = {};
+var defaults$y = {};
 var hasRequiredDefaults;
 function requireDefaults() {
-  if (hasRequiredDefaults) return defaults$l;
+  if (hasRequiredDefaults) return defaults$y;
   hasRequiredDefaults = 1;
-  Object.defineProperty(defaults$l, "__esModule", { value: true });
-  defaults$l.assignDefaults = void 0;
+  Object.defineProperty(defaults$y, "__esModule", { value: true });
+  defaults$y.assignDefaults = void 0;
   const codegen_1 = /* @__PURE__ */ requireCodegen();
   const util_1 = /* @__PURE__ */ requireUtil$1();
   function assignDefaults(it, ty) {
@@ -14113,7 +14113,7 @@ function requireDefaults() {
       items2.forEach((sch, i) => assignDefault(it, i, sch.default));
     }
   }
-  defaults$l.assignDefaults = assignDefaults;
+  defaults$y.assignDefaults = assignDefaults;
   function assignDefault(it, prop, defaultValue) {
     const { gen: gen2, compositeRule, data, opts } = it;
     if (defaultValue === void 0)
@@ -14129,7 +14129,7 @@ function requireDefaults() {
     }
     gen2.if(condition, (0, codegen_1._)`${childData} = ${(0, codegen_1.stringify)(defaultValue)}`);
   }
-  return defaults$l;
+  return defaults$y;
 }
 var keyword = {};
 var code$1 = {};
@@ -82980,13 +82980,13 @@ function schema$_(configure) {
     description: "日期范围选择输入"
   });
 }
-function defaults$k() {
+function defaults$x() {
   return { rangeSeparatorIcon: "fluent:arrow-right-20-regular" };
 }
 const __vite_glob_0_6$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$_,
-  defaults: defaults$k,
+  defaults: defaults$x,
   metadata: metadata$_,
   presetSchema: presetSchema$4,
   schema: schema$_,
@@ -83210,7 +83210,7 @@ function schema$Y(configure) {
     description: "日期时间范围选择输入"
   });
 }
-function defaults$j() {
+function defaults$w() {
   return { rangeSeparatorIcon: "fluent:arrow-right-20-regular" };
 }
 const __vite_glob_0_8$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -83219,7 +83219,7 @@ const __vite_glob_0_8$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.d
   TIME_GRANULARITIES: TIME_GRANULARITIES$2,
   TIME_GRANULARITY_OPTIONS: TIME_GRANULARITY_OPTIONS$2,
   compatibilityDate: compatibilityDate$Y,
-  defaults: defaults$j,
+  defaults: defaults$w,
   metadata: metadata$Y,
   presetSchema: presetSchema$2,
   schema: schema$Y,
@@ -83372,7 +83372,7 @@ function schema$W(configure) {
     description: "时间范围选择输入"
   });
 }
-function defaults$i() {
+function defaults$v() {
   return { rangeSeparatorIcon: "fluent:arrow-right-20-regular" };
 }
 const __vite_glob_0_10$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -83381,7 +83381,7 @@ const __vite_glob_0_10$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.
   TIME_GRANULARITIES,
   TIME_GRANULARITY_OPTIONS,
   compatibilityDate: compatibilityDate$W,
-  defaults: defaults$i,
+  defaults: defaults$v,
   metadata: metadata$W,
   schema: schema$W,
   type: type$W
@@ -83548,13 +83548,13 @@ function schema$U(configure) {
     description: "数值范围输入"
   });
 }
-function defaults$h() {
+function defaults$u() {
   return { rangeSeparatorIcon: "fluent:arrow-right-20-regular" };
 }
 const __vite_glob_0_12$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$U,
-  defaults: defaults$h,
+  defaults: defaults$u,
   metadata: metadata$U,
   schema: schema$U,
   type: type$U
@@ -89299,7 +89299,7 @@ function schema$P(configure) {
     description: "可新增/删除/重排的同构子表单列表"
   });
 }
-function defaults$g() {
+function defaults$t() {
   return {
     unit: {
       fields: [],
@@ -89310,7 +89310,7 @@ function defaults$g() {
 const __vite_glob_0_17$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$P,
-  defaults: defaults$g,
+  defaults: defaults$t,
   metadata: metadata$P,
   schema: schema$P,
   type: type$P
@@ -90892,9 +90892,13 @@ function columnFields(configure) {
         | 数据量 | **全量**，能够跨越多页 | 当前页 |
         | 开发量 | 需要后端支持，可能影响性能 | **配置即启用，无需后端支持** |
 
-        注意：对于服务端排序，除了在这里打开排序开关，你还需要在「通用配置 → 数据源 → 请求」处，**将正在排序字段、排序状态传给后端**。
+        注意：对于服务端排序，除了在这里打开排序开关，你还需要在「通用配置 → 数据源 → 请求」处，通过 \`sorts\` 变量**将各列「排序字段」(sortKey)、排序方向传给后端**。
       `
     })),
+    sortKey: optional(String$.pipe(minLength(1)).annotations({
+      title: "排序字段",
+      description: "服务端排序时通过数据源请求的 `sorts` 变量传给后端的字段标识；启用排序时必填"
+    })),
     size: optional(Number$.pipe(finite(), positive()).annotations({
       title: "列宽",
       description: "指定一个合适的表格列宽度，当列内容长度大于这里指定的宽度后，会导致超出的部分被截断。"
@@ -90913,7 +90917,11 @@ function editableColumnFields() {
     }),
     enableSorting: optional(Boolean$.annotations({
       title: "允许排序",
-      description: "显示排序按钮；启用客户端排序，按当前 `binding` 路径上的值排序"
+      description: "显示排序按钮；客户端排序按当前 `binding` 路径上的值排序，服务端排序则通过数据源请求的 `sorts` 变量将「排序字段」(sortKey) 传给后端"
+    })),
+    sortKey: optional(String$.pipe(minLength(1)).annotations({
+      title: "排序字段",
+      description: "服务端排序时通过数据源请求的 `sorts` 变量传给后端的字段标识；启用排序时必填"
     })),
     size: optional(Number$.pipe(finite(), positive()).annotations({
       title: "列宽",
@@ -90991,6 +90999,14 @@ function schema$M(configure) {
     ...actionFieldsForColumn
   }).annotations({ title: "ActionsRenderer", description: "操作渲染器" });
 }
+function defaults$s() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    size: 200,
+    groups: [],
+    items: []
+  };
+}
 function toColumnDef$t(value, { getLocaleText }) {
   return {
     header: value.title ? getLocaleText(value.title) : void 0,
@@ -91005,6 +91021,7 @@ function toColumnDef$t(value, { getLocaleText }) {
 const __vite_glob_0_0 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$M,
+  defaults: defaults$s,
   metadata: metadata$M,
   registerRowVariables,
   schema: schema$M,
@@ -91031,6 +91048,14 @@ function schema$L(configure) {
     })
   }).annotations({ title: "DateRenderer", description: "日期渲染器" });
 }
+function defaults$r() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    accessor: "",
+    format: "yyyy-MM-dd",
+    size: 120
+  };
+}
 function toColumnDef$s(value, { getLocaleText, $cel, inheritedContext }) {
   return {
     header: getLocaleText(value.title),
@@ -91053,6 +91078,7 @@ function toColumnDef$s(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_1$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$L,
+  defaults: defaults$r,
   metadata: metadata$L,
   schema: schema$L,
   toColumnDef: toColumnDef$s,
@@ -91082,6 +91108,13 @@ function schema$K(configure) {
     align: optionalWith(Align.annotations({ title: "对齐" }), { default: () => "center" })
   }).annotations({ title: "IconRenderer", description: "图标渲染器" });
 }
+function defaults$q() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    accessor: "",
+    size: 120
+  };
+}
 function toColumnDef$r(value, { getLocaleText, $cel, inheritedContext }) {
   return {
     header: getLocaleText(value.title),
@@ -91104,6 +91137,7 @@ function toColumnDef$r(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_2$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$K,
+  defaults: defaults$q,
   metadata: metadata$K,
   schema: schema$K,
   toColumnDef: toColumnDef$r,
@@ -91147,6 +91181,13 @@ function schema$J(configure) {
     }))
   }).annotations({ title: "MarkdownRenderer", description: "MD" });
 }
+function defaults$p() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    markdown: [{ locale: "zh", message: "" }],
+    size: 120
+  };
+}
 function toColumnDef$q(value, { getLocaleText }) {
   return {
     header: getLocaleText(value.title),
@@ -91161,6 +91202,7 @@ function toColumnDef$q(value, { getLocaleText }) {
 const __vite_glob_0_3$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$J,
+  defaults: defaults$p,
   metadata: metadata$J,
   schema: schema$J,
   toColumnDef: toColumnDef$q,
@@ -91195,6 +91237,14 @@ function schema$I(configure) {
     }))
   }).annotations({ title: "NumberRenderer", description: "数值渲染器" });
 }
+function defaults$o() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    accessor: "",
+    size: 120,
+    align: "right"
+  };
+}
 function toColumnDef$p(value, { getLocaleText, $cel, inheritedContext }) {
   return {
     header: getLocaleText(value.title),
@@ -91217,6 +91267,7 @@ function toColumnDef$p(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_4$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$I,
+  defaults: defaults$o,
   metadata: metadata$I,
   schema: schema$I,
   toColumnDef: toColumnDef$p,
@@ -91259,6 +91310,11 @@ function schema$H(configure) {
     })
   }).annotations({ title: "SelectRenderer", description: "选择渲染器" });
 }
+function defaults$n() {
+  return {
+    mode: "checkbox"
+  };
+}
 function toColumnDef$o(value) {
   return {
     header: (ctx) => vueExports.h(__vite_glob_2_5, { column: value, ctx }),
@@ -91271,6 +91327,7 @@ function toColumnDef$o(value) {
 const __vite_glob_0_5$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$H,
+  defaults: defaults$n,
   metadata: metadata$H,
   schema: schema$H,
   toColumnDef: toColumnDef$o,
@@ -91303,6 +91360,13 @@ function schema$G(configure) {
     }))
   }).annotations({ title: "TextRenderer", description: "文本渲染器" });
 }
+function defaults$m() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    accessor: "",
+    size: 120
+  };
+}
 function toColumnDef$n(value, { getLocaleText, $cel, inheritedContext }) {
   return {
     header: getLocaleText(value.title),
@@ -91326,6 +91390,7 @@ function toColumnDef$n(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_6 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$G,
+  defaults: defaults$m,
   metadata: metadata$G,
   schema: schema$G,
   toColumnDef: toColumnDef$n,
@@ -91377,6 +91442,13 @@ function schema$F(configure) {
     }))
   }).annotations({ title: "SwitchRenderer", description: "开关渲染器（可编辑）" });
 }
+function defaults$l() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    accessor: "",
+    size: 120
+  };
+}
 const migrateFrom$e = [
   { type: "com.shwfed.table.column.switch", compatibilityDate: compatibilityDate$F }
 ];
@@ -91412,6 +91484,7 @@ function toColumnDef$m(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_7 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$F,
+  defaults: defaults$l,
   metadata: metadata$F,
   migrate: migrate$e,
   migrateFrom: migrateFrom$e,
@@ -91841,6 +91914,13 @@ function schema$C(configure) {
     derived: derivedRowField(configure, "number")
   }).annotations({ title: "NumberInputRenderer", description: "数值输入渲染器（可编辑）" });
 }
+function defaults$k() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 120
+  };
+}
 function toColumnDef$j(value, { getLocaleText }) {
   return {
     header: editableHeader(getLocaleText(value.title)),
@@ -91865,6 +91945,7 @@ function toColumnDef$j(value, { getLocaleText }) {
 const __vite_glob_0_10 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$C,
+  defaults: defaults$k,
   metadata: metadata$C,
   schema: schema$C,
   toColumnDef: toColumnDef$j,
@@ -91905,6 +91986,13 @@ function schema$B(configure) {
     derived: derivedRowField(configure, "bool")
   }).annotations({ title: "SwitchRenderer", description: "开关渲染器（可编辑、本地）" });
 }
+function defaults$j() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 120
+  };
+}
 const migrateFrom$d = [
   { type: "com.shwfed.table.column.switch", compatibilityDate: compatibilityDate$B }
 ];
@@ -91940,6 +92028,7 @@ function toColumnDef$i(value, { getLocaleText }) {
 const __vite_glob_0_11 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$B,
+  defaults: defaults$j,
   metadata: metadata$B,
   migrate: migrate$d,
   migrateFrom: migrateFrom$d,
@@ -92041,6 +92130,13 @@ function schema$z(configure) {
     derived: derivedRowField(configure, "string")
   }).annotations({ title: "TextInputRenderer", description: "文本输入渲染器（可编辑）" });
 }
+function defaults$i() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 120
+  };
+}
 function toColumnDef$g(value, { getLocaleText }) {
   return {
     header: editableHeader(getLocaleText(value.title)),
@@ -92062,6 +92158,7 @@ function toColumnDef$g(value, { getLocaleText }) {
 const __vite_glob_0_13 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$z,
+  defaults: defaults$i,
   metadata: metadata$z,
   schema: schema$z,
   toColumnDef: toColumnDef$g,
@@ -93663,7 +93760,7 @@ function schema$o(configure) {
     })
   }).annotations({ title: "TreeComboboxMultiRenderer", description: "下拉树多选渲染器（可编辑）" });
 }
-function defaults$f() {
+function defaults$h() {
   return {
     dataSource: { data: "[]" },
     nodeKey: "string(node.id)",
@@ -93692,7 +93789,7 @@ function toColumnDef$5(value, { getLocaleText }) {
 const __vite_glob_0_24$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$o,
-  defaults: defaults$f,
+  defaults: defaults$h,
   metadata: metadata$o,
   schema: schema$o,
   toColumnDef: toColumnDef$5,
@@ -93797,7 +93894,7 @@ function schema$n(configure) {
     })
   }).annotations({ title: "TreeComboboxSingleRenderer", description: "下拉树单选渲染器（可编辑）" });
 }
-function defaults$e() {
+function defaults$g() {
   return {
     dataSource: { data: "[]" },
     nodeKey: "string(node.id)",
@@ -93825,7 +93922,7 @@ function toColumnDef$4(value, { getLocaleText }) {
 const __vite_glob_0_25$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$n,
-  defaults: defaults$e,
+  defaults: defaults$g,
   metadata: metadata$n,
   schema: schema$n,
   toColumnDef: toColumnDef$4,
@@ -94009,6 +94106,7 @@ function schema$m(configure) {
       description: "返回 `true` 时仅以纯文本展示当前已选项的标签"
     })),
     enableSorting: display.enableSorting,
+    sortKey: display.sortKey,
     size: display.size,
     grow: display.grow,
     tooltip: display.tooltip,
@@ -94023,11 +94121,19 @@ function schema$m(configure) {
     description: "下拉多选渲染器"
   });
 }
+function defaults$f() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    size: 200,
+    write: { kind: "binding", binding: "" },
+    options: { kind: "static", items: [] }
+  };
+}
 const migrateFrom$8 = [
   { type: "com.shwfed.table.column.combobox-multi", compatibilityDate: "2026-05-26" },
   { type: "com.shwfed.table.column.combobox-multi.remote", compatibilityDate: "2026-05-26" }
 ];
-const CARRY$1 = ["id", "groupId", "title", "size", "grow", "tooltip", "enableSorting", "placeholder", "hidden", "disabled", "readonly"];
+const CARRY$1 = ["id", "groupId", "title", "size", "grow", "tooltip", "enableSorting", "sortKey", "placeholder", "hidden", "disabled", "readonly"];
 const migrate$8 = (prev) => try_({
   try: () => {
     if (!prev || typeof prev !== "object") {
@@ -94096,6 +94202,7 @@ function toColumnDef$3(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_26$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$m,
+  defaults: defaults$f,
   itemSchema: itemSchema$3,
   metadata: metadata$m,
   migrate: migrate$8,
@@ -94285,6 +94392,7 @@ function schema$l(configure) {
       description: "返回 `true` 时仅以纯文本展示当前选项的标签"
     })),
     enableSorting: display.enableSorting,
+    sortKey: display.sortKey,
     size: display.size,
     grow: display.grow,
     tooltip: display.tooltip,
@@ -94299,11 +94407,19 @@ function schema$l(configure) {
     description: "下拉单选渲染器"
   });
 }
+function defaults$e() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    size: 200,
+    write: { kind: "binding", binding: "" },
+    options: { kind: "static", items: [] }
+  };
+}
 const migrateFrom$7 = [
   { type: "com.shwfed.table.column.combobox-single", compatibilityDate: "2026-05-26" },
   { type: "com.shwfed.table.column.combobox-single.remote", compatibilityDate: "2026-05-26" }
 ];
-const CARRY = ["id", "groupId", "title", "size", "grow", "tooltip", "enableSorting", "placeholder", "hidden", "disabled", "readonly"];
+const CARRY = ["id", "groupId", "title", "size", "grow", "tooltip", "enableSorting", "sortKey", "placeholder", "hidden", "disabled", "readonly"];
 const migrate$7 = (prev) => try_({
   try: () => {
     if (!prev || typeof prev !== "object") {
@@ -94372,6 +94488,7 @@ function toColumnDef$2(value, { getLocaleText, $cel, inheritedContext }) {
 const __vite_glob_0_27$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   compatibilityDate: compatibilityDate$l,
+  defaults: defaults$e,
   itemSchema: itemSchema$2,
   metadata: metadata$l,
   migrate: migrate$7,
@@ -94496,6 +94613,9 @@ function schema$k(configure) {
 }
 function defaults$d() {
   return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 200,
     dataSource: { data: "[]" },
     nodeKey: "string(node.id)",
     nodeChildren: "has(node.children) ? node.children : null",
@@ -94650,6 +94770,9 @@ function schema$j(configure) {
 }
 function defaults$c() {
   return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 200,
     dataSource: { data: "[]" },
     nodeKey: "string(node.id)",
     nodeChildren: "has(node.children) ? node.children : null",
@@ -94858,7 +94981,8 @@ const COLUMNS = registry$2.ENTRIES.map((e) => ({
   deprecated: e.deprecated,
   ...e.supersededBy !== void 0 ? { supersededBy: e.supersededBy } : {},
   ...e.module.migrate !== void 0 ? { migrate: e.module.migrate } : {},
-  ...e.module.migrateFrom !== void 0 ? { migrateFrom: e.module.migrateFrom } : {}
+  ...e.module.migrateFrom !== void 0 ? { migrateFrom: e.module.migrateFrom } : {},
+  ...e.module.defaults !== void 0 ? { defaults: e.module.defaults } : {}
 }));
 (() => {
   const map2 = /* @__PURE__ */ new Map();
@@ -95029,6 +95153,15 @@ const ColumnGroup = Struct({
   description: "列分组定义"
 });
 const QUERY_VAR_DESCRIPTION = "搜索条件当前状态；未配置搜索条件时为空对象";
+const JSON_VAR_DESCRIPTION = "已解析的 JSON 响应；未配置 `request` 时为 `none`";
+const SORTS_VAR_DESCRIPTION = md`
+  当前的排序状态，为一个**列表**，每个元素包含两个字段：
+
+  - \`key: string\` 为该列上配置的键
+  - \`mode: 'asc' | 'desc'\` 为该列的排序状态
+
+  未排序的字段，**不会出现在这个列表中**。
+`;
 function configureTableActionsScope(env, configure) {
   configure(env);
   env.registerVariable("selected", "list<dyn>", {
@@ -95039,12 +95172,43 @@ function configureTableActionsScope(env, configure) {
     label: "搜索条件",
     description: QUERY_VAR_DESCRIPTION
   });
+  env.registerVariable("sorts", "list<map<string, string>>", {
+    label: "排序状态",
+    description: SORTS_VAR_DESCRIPTION
+  });
+}
+function registerDataSourceRequestVars(env) {
+  env.registerVariable("pageIndex", "number", {
+    label: "当前页码",
+    description: "从 `0` 开始；未启用分页时为 `0`"
+  });
+  env.registerVariable("pageSize", "number", {
+    label: "每页行数",
+    description: "当前每页行数；未启用分页时为 `0`"
+  });
+  env.registerVariable("sorts", "list<map<string, string>>", {
+    label: "排序状态",
+    description: SORTS_VAR_DESCRIPTION
+  });
+  env.registerVariable("query", "dyn", {
+    label: "搜索条件",
+    description: QUERY_VAR_DESCRIPTION
+  });
+}
+function registerDataSourceResponseVars(env) {
+  env.registerVariable("json", "optional<dyn>", {
+    label: "HTTP 响应体",
+    description: JSON_VAR_DESCRIPTION
+  });
+  env.registerVariable("query", "dyn", {
+    label: "搜索条件",
+    description: QUERY_VAR_DESCRIPTION
+  });
 }
 function DataSource(configure, extras) {
   const CelRequest = Expression({
     configure: (env) => {
       configure(env);
-      extras?.request?.(env);
     },
     resultType: "HttpRequest"
   });
@@ -95054,7 +95218,6 @@ function DataSource(configure, extras) {
       env.registerVariable("json", "optional<dyn>", {
         description: "HTTP 响应体（已解析 JSON）；未配置 request 时为 none"
       });
-      extras?.data?.(env);
     },
     resultType: (type2) => type2.startsWith("list") || type2 === "dyn" || type2.startsWith("optional")
   });
@@ -95073,28 +95236,36 @@ function DataSource(configure, extras) {
   });
 }
 function tableDataSource(configure) {
-  const base2 = DataSource(configure, {
-    request: (env) => {
-      env.registerVariable("pageIndex", "number", { description: "当前页码（从 0 开始）；未启用分页时为 0" });
-      env.registerVariable("pageSize", "number", { description: "每页行数；未启用分页时为 0" });
-      env.registerVariable("query", "dyn", { description: QUERY_VAR_DESCRIPTION });
+  const CelRequest = Expression({
+    configure: (env) => {
+      configure(env);
+      registerDataSourceRequestVars(env);
     },
-    data: (env) => {
-      env.registerVariable("query", "dyn", { description: QUERY_VAR_DESCRIPTION });
-    }
+    resultType: "HttpRequest"
+  });
+  const CelRows = Expression({
+    configure: (env) => {
+      configure(env);
+      registerDataSourceResponseVars(env);
+    },
+    resultType: (type2) => type2.startsWith("list") || type2 === "dyn" || type2.startsWith("optional")
   });
   const CelTotal = Expression({
     configure: (env) => {
       configure(env);
-      env.registerVariable("json", "optional<dyn>", {
-        description: "HTTP 响应体（已解析 JSON）；未配置 request 时为 none"
-      });
-      env.registerVariable("query", "dyn", { description: QUERY_VAR_DESCRIPTION });
+      registerDataSourceResponseVars(env);
     },
     resultType: (type2) => type2 === "number" || type2 === "dyn" || type2.startsWith("optional")
   });
   return Struct({
-    ...base2.fields,
+    request: optional(CelRequest).annotations({
+      title: "请求",
+      description: "可选的 HTTP 请求表达式；未配置时数据从 `data` 表达式中读取（通常引用上下文变量）"
+    }),
+    data: CelRows.annotations({
+      title: "数据",
+      description: "返回行数据列表（`list<dyn>`）的 CEL 表达式；在配置了 `request` 时可通过 `json` 引用响应体"
+    }),
     total: optional(CelTotal).annotations({
       title: "总数",
       description: "返回总行数（`number`）的 CEL 表达式；配置后启用服务端分页，留空则走前端分页"
@@ -95185,6 +95356,12 @@ function TableConfig(configure) {
     if (cfg.dataSource?.total !== void 0 && cfg.pagination === void 0) {
       return "配置了 dataSource.total 时必须启用分页";
     }
+    for (const col of cfg.columns) {
+      const c = col;
+      if (c.enableSorting === true && (c.sortKey === void 0 || c.sortKey.length === 0)) {
+        return "启用排序的列必须填写「排序字段」(sortKey)";
+      }
+    }
     return true;
   })).annotations({
     title: "TableConfig",
@@ -97068,6 +97245,11 @@ function allFieldSchemas(configure) {
     identifier: `${entry.type}@${entry.compatibilityDate}`
   }));
 }
+function registerFormVariablesIfAbsent(env) {
+  const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
+  if (!declared.has("now")) env.registerVariable("now", "Date", { label: "当前时间", description: "当前日期/时间" });
+  if (!declared.has("form")) env.registerVariable("form", "dyn", { label: "表单值", description: "当前表单状态" });
+}
 const KIND$1 = "shwfed.component.form";
 function unitFields(configure) {
   const fieldSchemas = allFieldSchemas(configure);
@@ -97096,11 +97278,6 @@ function FormUnit(configure) {
     description: "一组表单字段及其布局"
   });
 }
-function registerFormVariablesIfAbsent(env) {
-  const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
-  if (!declared.has("now")) env.registerVariable("now", "Date", { label: "当前时间", description: "当前日期/时间" });
-  if (!declared.has("form")) env.registerVariable("form", "dyn", { label: "表单值", description: "当前表单状态" });
-}
 function FormConfig(configure) {
   const formConfigure = (env) => {
     registerFormVariablesIfAbsent(env);

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "shwfed",
   "configKey": "shwfed",
-  "version": "2.4.1",
+  "version": "2.5.1",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"