@shwfed/config 2.4.1 → 2.5.1

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-multi/config.vue.d.ts

@@ -44,6 +44,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly data: string;
             readonly request?: string | undefined;
         };
+        readonly enableSorting?: boolean | undefined;
+        readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -53,9 +55,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly expandAll: boolean;
-        readonly cascade: "independent" | "cascade-down" | "cascade-both";
-        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -64,6 +63,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
+        readonly sortKey?: string | undefined;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -107,6 +108,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly data: string;
             readonly request?: string | undefined;
         };
+        readonly enableSorting?: boolean | undefined;
+        readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -116,9 +119,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly expandAll: boolean;
-        readonly cascade: "independent" | "cascade-down" | "cascade-both";
-        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -127,6 +127,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
+        readonly sortKey?: string | undefined;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-multi/schema.d.ts

@@ -72,6 +72,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     }>]>;
     binding: Schema.refine<string, typeof Schema.String>;
     enableSorting: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    sortKey: Schema.optional<Schema.refine<string, typeof Schema.String>>;
     size: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
     grow: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
     tooltip: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-multi/schema.js

@@ -122,6 +122,9 @@ export function schema(configure) {
 }
 export function defaults() {
   return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 200,
     dataSource: { data: "[]" },
     nodeKey: "string(node.id)",
     nodeChildren: "has(node.children) ? node.children : null",

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-single/config.d.vue.ts

@@ -44,6 +44,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly data: string;
             readonly request?: string | undefined;
         };
+        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -53,8 +54,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly expandAll: boolean;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -63,6 +62,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
+        readonly sortKey?: string | undefined;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -106,6 +107,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly data: string;
             readonly request?: string | undefined;
         };
+        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -115,8 +117,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly expandAll: boolean;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -125,6 +125,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
+        readonly sortKey?: string | undefined;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-single/config.vue

@@ -537,14 +537,10 @@ const derivedModel = computed({
     <Separator />
     <div class="flex flex-wrap gap-x-8 gap-y-3">
       <Field
-        orientation="horizontal"
-        class="w-auto gap-2"
+        orientation="vertical"
+        class="w-full max-w-xs"
       >
-        <Switch
-          :model-value="value.enableSorting ?? false"
-          @update:model-value="(v) => value = { ...value, enableSorting: v }"
-        />
-        <FieldLabel class="text-sm text-zinc-600">
+        <FieldLabel class="text-xs text-zinc-500">
           <template
             v-if="fieldDescription('enableSorting')"
             #tooltip
@@ -557,6 +553,23 @@ const derivedModel = computed({
           </template>
           {{ fieldTitle("enableSorting") }}
         </FieldLabel>
+        <InputGroup>
+          <InputGroupInput
+            :model-value="value.sortKey"
+            placeholder="例：created_at"
+            @update:model-value="(v) => value = { ...value, sortKey: v || void 0 }"
+          />
+          <InputGroupAddon align="inline-end">
+            <InputGroupButton
+              :variant="value.enableSorting ? 'primary' : 'ghost'"
+              size="xs"
+              @click="value = { ...value, enableSorting: !value.enableSorting }"
+            >
+              <Icon :icon="value.enableSorting ? 'fluent:arrow-sort-up-16-regular' : 'fluent:arrow-sort-16-regular'" />
+              {{ fieldTitle("enableSorting") }}
+            </InputGroupButton>
+          </InputGroupAddon>
+        </InputGroup>
       </Field>
     </div>
   </div>

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-single/config.vue.d.ts

@@ -44,6 +44,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly data: string;
             readonly request?: string | undefined;
         };
+        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -53,8 +54,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly expandAll: boolean;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -63,6 +62,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
+        readonly sortKey?: string | undefined;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -106,6 +107,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly data: string;
             readonly request?: string | undefined;
         };
+        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -115,8 +117,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly expandAll: boolean;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -125,6 +125,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
+        readonly sortKey?: string | undefined;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-single/schema.d.ts

@@ -69,6 +69,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     }>]>;
     binding: Schema.refine<string, typeof Schema.String>;
     enableSorting: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    sortKey: Schema.optional<Schema.refine<string, typeof Schema.String>>;
     size: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
     grow: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
     tooltip: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{

package/dist/runtime/components/table/columns/2026-05-28/com.shwfed.table.column.tree-combobox-single/schema.js

@@ -115,6 +115,9 @@ export function schema(configure) {
 }
 export function defaults() {
   return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 200,
     dataSource: { data: "[]" },
     nodeKey: "string(node.id)",
     nodeChildren: "has(node.children) ? node.children : null",

package/dist/runtime/components/table/config.vue

@@ -5,7 +5,7 @@ import { BREADCRUMB_EXTENSION_KEY } from "../config/breadcrumb-extension";
 import { TABLE_COLUMN_LAYOUT_KEY } from "./column-layout";
 import { Icon } from "@iconify/vue";
 import { ParseResult, Schema } from "effect";
-import { TableConfig, Pagination, ColumnGroup, tableDataSource, configureTableActionsScope, metadata as tableMetadata } from "./schema";
+import { TableConfig, Pagination, ColumnGroup, tableDataSource, configureTableActionsScope, registerDataSourceRequestVars, registerDataSourceResponseVars, metadata as tableMetadata } from "./schema";
 import { COLUMNS, findColumn as findColumnEntry } from "./utils/resolve";
 import {
   useTreeDnd
@@ -36,6 +36,22 @@ import ShwfedFormConfig from "../form/config.vue";
 import { defaultFormConfig } from "../form/schema";
 import { Environment } from "../../vendor/cel-js/lib/index";
 defineOptions({ name: "ShwfedTableConfig" });
+function probeCELContext(register) {
+  const probe = new Environment({ unlistedVariablesAreDyn: false });
+  const baseline = new Set(probe.getDefinitions().variables.map((v) => v.name));
+  register(probe);
+  const out = {};
+  for (const v of probe.getDefinitions().variables) {
+    if (baseline.has(v.name)) continue;
+    out[v.name] = {
+      type: v.type,
+      label: v.label ?? v.name,
+      description: v.description ?? void 0,
+      value: void 0
+    };
+  }
+  return out;
+}
 const RowKeyCELContext = defineComponent({
   name: "RowKeyCELContext",
   setup(_, { slots }) {
@@ -97,40 +113,14 @@ const CellStyleCELContext = defineComponent({
 const RequestCELContext = defineComponent({
   name: "RequestCELContext",
   setup(_, { slots }) {
-    provideCELContext({
-      pageIndex: {
-        type: "number",
-        label: "\u5F53\u524D\u9875\u7801",
-        description: "\u4ECE `0` \u5F00\u59CB\uFF1B\u672A\u542F\u7528\u5206\u9875\u65F6\u4E3A `0`\u3002",
-        value: 0
-      },
-      pageSize: {
-        type: "number",
-        label: "\u6BCF\u9875\u884C\u6570",
-        description: "\u5F53\u524D\u6BCF\u9875\u884C\u6570\uFF1B\u672A\u542F\u7528\u5206\u9875\u65F6\u4E3A `0`\u3002",
-        value: 0
-      },
-      query: {
-        type: "dyn",
-        label: "\u641C\u7D22\u6761\u4EF6",
-        description: "\u641C\u7D22\u6761\u4EF6\u5F53\u524D\u72B6\u6001\uFF1B\u672A\u914D\u7F6E\u65F6\u4E3A\u7A7A\u5BF9\u8C61\u3002",
-        value: {}
-      }
-    });
+    provideCELContext(probeCELContext(registerDataSourceRequestVars));
     return () => slots.default?.();
   }
 });
 const JsonCELContext = defineComponent({
   name: "JsonCELContext",
   setup(_, { slots }) {
-    provideCELContext({
-      json: {
-        type: "optional<dyn>",
-        label: "HTTP \u54CD\u5E94\u4F53",
-        description: "\u5DF2\u89E3\u6790\u7684 JSON \u54CD\u5E94\uFF1B\u672A\u914D\u7F6E `request` \u65F6\u4E3A `none`\u3002",
-        value: void 0
-      }
-    });
+    provideCELContext(probeCELContext(registerDataSourceResponseVars));
     return () => slots.default?.();
   }
 });
@@ -165,22 +155,7 @@ function configureTableQuery(env) {
 const tableConfigSchema = TableConfig(configure);
 const dataSourceSchema = tableDataSource(configure);
 const pickerEntries = computed(() => COLUMNS.filter((e) => !e.deprecated));
-const advertisedHostContext = (() => {
-  const probe = new Environment({ unlistedVariablesAreDyn: false });
-  const baseline = new Set(probe.getDefinitions().variables.map((v) => v.name));
-  configure(probe);
-  const out = {};
-  for (const v of probe.getDefinitions().variables) {
-    if (baseline.has(v.name)) continue;
-    out[v.name] = {
-      type: v.type,
-      label: v.label ?? v.name,
-      description: v.description ?? void 0,
-      value: void 0
-    };
-  }
-  return out;
-})();
+const advertisedHostContext = probeCELContext(configure);
 provideCELContext(advertisedHostContext);
 const generalFieldTitle = (f) => getStructFieldTitle(tableConfigSchema, f) ?? f;
 const generalFieldDescription = (f) => getStructFieldDescription(tableConfigSchema, f);
@@ -471,62 +446,8 @@ function getColumnTypeLabel(type, compatibilityDate) {
   return findColumnEntry(type, compatibilityDate)?.metadata.name ?? type;
 }
 function getColumnDefaults(id, type, compatibilityDate) {
-  switch (type) {
-    case "com.shwfed.table.column.text":
-      return { id, type, compatibilityDate, title: [{ locale: "zh", message: "" }], accessor: "", size: 120 };
-    case "com.shwfed.table.column.date":
-      return { id, type, compatibilityDate, title: [{ locale: "zh", message: "" }], accessor: "", format: "yyyy-MM-dd", size: 120 };
-    case "com.shwfed.table.column.number":
-      return { id, type, compatibilityDate, title: [{ locale: "zh", message: "" }], accessor: "", size: 120, align: "right" };
-    case "com.shwfed.table.column.select":
-      return { id, type, compatibilityDate, mode: "checkbox" };
-    case "com.shwfed.table.column.markdown":
-      return { id, type, compatibilityDate, title: [{ locale: "zh", message: "" }], markdown: [{ locale: "zh", message: "" }], size: 120 };
-    case "com.shwfed.table.column.actions":
-      return { id, type, compatibilityDate, title: [{ locale: "zh", message: "" }], size: 200, groups: [], items: [] };
-    case "com.shwfed.table.column.combobox-multi":
-    case "com.shwfed.table.column.combobox-single":
-      return {
-        id,
-        type,
-        compatibilityDate,
-        title: [{ locale: "zh", message: "" }],
-        size: 200,
-        write: { kind: "binding", binding: "" },
-        options: { kind: "static", items: [] }
-      };
-    case "com.shwfed.table.column.tree-combobox-single":
-      return {
-        id,
-        type,
-        compatibilityDate,
-        title: [{ locale: "zh", message: "" }],
-        binding: "",
-        size: 200,
-        dataSource: { data: "[]" },
-        nodeKey: "string(node.id)",
-        nodeChildren: "has(node.children) ? node.children : null",
-        nodeLabel: [{ locale: "zh", message: "{{ node.label }}" }],
-        expandAll: false
-      };
-    case "com.shwfed.table.column.tree-combobox-multi":
-      return {
-        id,
-        type,
-        compatibilityDate,
-        title: [{ locale: "zh", message: "" }],
-        binding: "",
-        size: 200,
-        dataSource: { data: "[]" },
-        nodeKey: "string(node.id)",
-        nodeChildren: "has(node.children) ? node.children : null",
-        nodeLabel: [{ locale: "zh", message: "{{ node.label }}" }],
-        cascade: "independent",
-        expandAll: false
-      };
-    default:
-      return { id, type, compatibilityDate };
-  }
+  const entry = findColumnEntry(type, compatibilityDate);
+  return { ...entry?.defaults?.() ?? {}, id, type, compatibilityDate };
 }
 function addColumn(columnType, compatibilityDate) {
   const col = getColumnDefaults(crypto.randomUUID(), columnType, compatibilityDate);
@@ -610,9 +531,9 @@ if (breadcrumbExt) {
     crumb.dispose();
   });
 }
-function patchColumn(id, patch) {
+function patchColumn(id, next) {
   editingColumns.value = editingColumns.value.map(
-    (c) => c.id === id ? { ...c, ...patch } : c
+    (c) => c.id === id ? { ...next, id } : c
   );
 }
 function patchSelectedColumn(next) {

package/dist/runtime/components/table/index.vue

@@ -95,7 +95,13 @@ function getLocaleText(value) {
   return getLocalizedText(value, locale.value);
 }
 function mergeCelContext(local) {
-  return { ...celBindings(inheritedContext), query: queryState.value, ...local };
+  return { ...celBindings(inheritedContext), query: queryState.value, sorts: currentSorts(), ...local };
+}
+function currentSorts() {
+  const sortKeyById = new Map(
+    (config.value?.columns ?? []).map((c) => [c.id, c.sortKey]).filter((e) => typeof e[1] === "string" && e[1].length > 0)
+  );
+  return tableApi.getState().sorting.map((s) => ({ key: sortKeyById.get(s.id), mode: s.desc ? "desc" : "asc" })).filter((s) => s.key !== void 0);
 }
 function translateColumn(column) {
   const entry = findColumn(column.type, column.compatibilityDate);
@@ -222,6 +228,11 @@ const tableApi = useVueTable({
   get manualPagination() {
     return isManualPagination.value;
   },
+  // Defer to server order under server pagination — the page only holds one
+  // server-sorted slice, so client re-sorting it would be wrong.
+  get manualSorting() {
+    return isManualPagination.value;
+  },
   get rowCount() {
     return isManualPagination.value ? serverTotal.value : void 0;
   },
@@ -256,6 +267,14 @@ provideCELContext({
     get value() {
       return queryState.value;
     }
+  },
+  sorts: {
+    type: "list<map<string, string>>",
+    label: "\u6392\u5E8F\u72B6\u6001",
+    description: '\u5F53\u524D\u6392\u5E8F\u5217\u8868\uFF0C\u6BCF\u9879\u4E3A `{key, mode}`\uFF1B`key` \u53D6\u81EA\u5217\u7684\u300C\u6392\u5E8F\u5B57\u6BB5\u300D(sortKey)\uFF0C`mode` \u4E3A `"asc"`/`"desc"`\uFF1B\u672A\u6392\u5E8F\u65F6\u4E3A\u7A7A\u6570\u7EC4\u3002',
+    get value() {
+      return currentSorts();
+    }
   }
 });
 provideSharedFetchLayer();
@@ -423,7 +442,8 @@ watch(
   () => {
     if (!isManualPagination.value) return null;
     const { pageIndex, pageSize } = tableApi.getState().pagination;
-    return `${pageIndex}:${pageSize}`;
+    const sorting = tableApi.getState().sorting;
+    return `${pageIndex}:${pageSize}:${JSON.stringify(sorting)}`;
   },
   (next, prev) => {
     if (next !== null && next !== prev) void fetchDataSource();

package/dist/runtime/components/table/schema.d.ts

@@ -96,6 +96,8 @@ export declare const ColumnGroup: Schema.Struct<{
     }>]>>;
 }>;
 export declare function configureTableActionsScope(env: Environment, configure: (env: Environment) => void): void;
+export declare function registerDataSourceRequestVars(env: Environment): void;
+export declare function registerDataSourceResponseVars(env: Environment): void;
 export declare function DataSource(configure: (env: Environment) => void, extras?: {
     request?: (env: Environment) => void;
     data?: (env: Environment) => void;
@@ -104,9 +106,9 @@ export declare function DataSource(configure: (env: Environment) => void, extras
     data: Schema.Schema<string, string, never>;
 }>;
 export declare function tableDataSource(configure: (env: Environment) => void): Schema.Struct<{
-    total: Schema.optional<Schema.Schema<string, string, never>>;
     request: Schema.optional<Schema.Schema<string, string, never>>;
     data: Schema.Schema<string, string, never>;
+    total: Schema.optional<Schema.Schema<string, string, never>>;
 }>;
 export declare function TableConfig(configure: (env: Environment) => void): Schema.refine<{
     readonly style?: string | undefined;
@@ -304,9 +306,9 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
         default: () => never[];
     }>;
     dataSource: Schema.optional<Schema.Struct<{
-        total: Schema.optional<Schema.Schema<string, string, never>>;
         request: Schema.optional<Schema.Schema<string, string, never>>;
         data: Schema.Schema<string, string, never>;
+        total: Schema.optional<Schema.Schema<string, string, never>>;
     }>>;
     actions: Schema.optional<Schema.Struct<{
         size: Schema.optionalWith<Schema.Literal<["default", "sm", "xs"]>, {

package/dist/runtime/components/table/schema.js

@@ -1,6 +1,7 @@
 import { Schema } from "effect";
 import { Expression } from "../../share/expression.js";
 import { Locale } from "../../share/locale.js";
+import { md } from "../../share/markdown.js";
 import { ActionSchemaFields } from "../actions/schema.js";
 import { FormConfig } from "../form/schema.js";
 import { allColumnSchemas } from "./utils/resolve.js";
@@ -127,6 +128,15 @@ export const ColumnGroup = Schema.Struct({
   description: "\u5217\u5206\u7EC4\u5B9A\u4E49"
 });
 const QUERY_VAR_DESCRIPTION = "\u641C\u7D22\u6761\u4EF6\u5F53\u524D\u72B6\u6001\uFF1B\u672A\u914D\u7F6E\u641C\u7D22\u6761\u4EF6\u65F6\u4E3A\u7A7A\u5BF9\u8C61";
+const JSON_VAR_DESCRIPTION = "\u5DF2\u89E3\u6790\u7684 JSON \u54CD\u5E94\uFF1B\u672A\u914D\u7F6E `request` \u65F6\u4E3A `none`";
+const SORTS_VAR_DESCRIPTION = md`
+  当前的排序状态，为一个**列表**，每个元素包含两个字段：
+
+  - \`key: string\` 为该列上配置的键
+  - \`mode: 'asc' | 'desc'\` 为该列的排序状态
+
+  未排序的字段，**不会出现在这个列表中**。
+`;
 export function configureTableActionsScope(env, configure) {
   configure(env);
   env.registerVariable("selected", "list<dyn>", {
@@ -137,6 +147,38 @@ export function configureTableActionsScope(env, configure) {
     label: "\u641C\u7D22\u6761\u4EF6",
     description: QUERY_VAR_DESCRIPTION
   });
+  env.registerVariable("sorts", "list<map<string, string>>", {
+    label: "\u6392\u5E8F\u72B6\u6001",
+    description: SORTS_VAR_DESCRIPTION
+  });
+}
+export function registerDataSourceRequestVars(env) {
+  env.registerVariable("pageIndex", "number", {
+    label: "\u5F53\u524D\u9875\u7801",
+    description: "\u4ECE `0` \u5F00\u59CB\uFF1B\u672A\u542F\u7528\u5206\u9875\u65F6\u4E3A `0`"
+  });
+  env.registerVariable("pageSize", "number", {
+    label: "\u6BCF\u9875\u884C\u6570",
+    description: "\u5F53\u524D\u6BCF\u9875\u884C\u6570\uFF1B\u672A\u542F\u7528\u5206\u9875\u65F6\u4E3A `0`"
+  });
+  env.registerVariable("sorts", "list<map<string, string>>", {
+    label: "\u6392\u5E8F\u72B6\u6001",
+    description: SORTS_VAR_DESCRIPTION
+  });
+  env.registerVariable("query", "dyn", {
+    label: "\u641C\u7D22\u6761\u4EF6",
+    description: QUERY_VAR_DESCRIPTION
+  });
+}
+export function registerDataSourceResponseVars(env) {
+  env.registerVariable("json", "optional<dyn>", {
+    label: "HTTP \u54CD\u5E94\u4F53",
+    description: JSON_VAR_DESCRIPTION
+  });
+  env.registerVariable("query", "dyn", {
+    label: "\u641C\u7D22\u6761\u4EF6",
+    description: QUERY_VAR_DESCRIPTION
+  });
 }
 export function DataSource(configure, extras) {
   const CelRequest = Expression({
@@ -171,28 +213,36 @@ export function DataSource(configure, extras) {
   });
 }
 export function tableDataSource(configure) {
-  const base = DataSource(configure, {
-    request: (env) => {
-      env.registerVariable("pageIndex", "number", { description: "\u5F53\u524D\u9875\u7801\uFF08\u4ECE 0 \u5F00\u59CB\uFF09\uFF1B\u672A\u542F\u7528\u5206\u9875\u65F6\u4E3A 0" });
-      env.registerVariable("pageSize", "number", { description: "\u6BCF\u9875\u884C\u6570\uFF1B\u672A\u542F\u7528\u5206\u9875\u65F6\u4E3A 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: (type) => type.startsWith("list") || type === "dyn" || type.startsWith("optional")
   });
   const CelTotal = Expression({
     configure: (env) => {
       configure(env);
-      env.registerVariable("json", "optional<dyn>", {
-        description: "HTTP \u54CD\u5E94\u4F53\uFF08\u5DF2\u89E3\u6790 JSON\uFF09\uFF1B\u672A\u914D\u7F6E request \u65F6\u4E3A none"
-      });
-      env.registerVariable("query", "dyn", { description: QUERY_VAR_DESCRIPTION });
+      registerDataSourceResponseVars(env);
     },
     resultType: (type) => type === "number" || type === "dyn" || type.startsWith("optional")
   });
   return Schema.Struct({
-    ...base.fields,
+    request: Schema.optional(CelRequest).annotations({
+      title: "\u8BF7\u6C42",
+      description: "\u53EF\u9009\u7684 HTTP \u8BF7\u6C42\u8868\u8FBE\u5F0F\uFF1B\u672A\u914D\u7F6E\u65F6\u6570\u636E\u4ECE `data` \u8868\u8FBE\u5F0F\u4E2D\u8BFB\u53D6\uFF08\u901A\u5E38\u5F15\u7528\u4E0A\u4E0B\u6587\u53D8\u91CF\uFF09"
+    }),
+    data: CelRows.annotations({
+      title: "\u6570\u636E",
+      description: "\u8FD4\u56DE\u884C\u6570\u636E\u5217\u8868\uFF08`list<dyn>`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u5728\u914D\u7F6E\u4E86 `request` \u65F6\u53EF\u901A\u8FC7 `json` \u5F15\u7528\u54CD\u5E94\u4F53"
+    }),
     total: Schema.optional(CelTotal).annotations({
       title: "\u603B\u6570",
       description: "\u8FD4\u56DE\u603B\u884C\u6570\uFF08`number`\uFF09\u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u914D\u7F6E\u540E\u542F\u7528\u670D\u52A1\u7AEF\u5206\u9875\uFF0C\u7559\u7A7A\u5219\u8D70\u524D\u7AEF\u5206\u9875"
@@ -283,6 +333,12 @@ export function TableConfig(configure) {
     if (cfg.dataSource?.total !== void 0 && cfg.pagination === void 0) {
       return "\u914D\u7F6E\u4E86 dataSource.total \u65F6\u5FC5\u987B\u542F\u7528\u5206\u9875";
     }
+    for (const col of cfg.columns) {
+      const c = col;
+      if (c.enableSorting === true && (c.sortKey === void 0 || c.sortKey.length === 0)) {
+        return "\u542F\u7528\u6392\u5E8F\u7684\u5217\u5FC5\u987B\u586B\u5199\u300C\u6392\u5E8F\u5B57\u6BB5\u300D(sortKey)";
+      }
+    }
     return true;
   })).annotations({
     title: "TableConfig",

package/dist/runtime/components/table/utils/resolve.d.ts

@@ -43,6 +43,14 @@ export type MigrateSource = Readonly<{
     type: string;
     compatibilityDate: string;
 }>;
+/**
+ * Optional creation-time defaults factory. Returns a partial config that
+ * merges into the seed when the user adds a new column, so newly-added
+ * columns arrive with their required fields populated. Schemas remain pure
+ * validators — defaults live next to them. Mirrors `FieldDefaults` in the
+ * form host's `resolve.ts`.
+ */
+export type ColumnDefaults = () => Record<string, any>;
 export type ColumnEntry = Readonly<{
     type: string;
     compatibilityDate: string;
@@ -64,6 +72,12 @@ export type ColumnEntry = Readonly<{
     supersededBy?: MigrateSource;
     migrate?: MigrateFn;
     migrateFrom?: ReadonlyArray<MigrateSource>;
+    /**
+     * Optional creation-time defaults. The host merges the returned partial
+     * onto the seed when the user adds a new column via the picker. Absent →
+     * the column is created with only `{ id, type, compatibilityDate }`.
+     */
+    defaults?: ColumnDefaults;
 }>;
 export declare const COLUMNS: ReadonlyArray<ColumnEntry>;
 export declare function allColumnSchemas(configure: (env: Environment) => void): ReadonlyArray<AnySchema>;

package/dist/runtime/components/table/utils/resolve.js

@@ -76,7 +76,8 @@ export const COLUMNS = registry.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 migrationTargets = (() => {
   const map = /* @__PURE__ */ new Map();