@shwfed/config 3.0.7 → 3.0.8

package/dist/runtime/components/table/columns/2026-06-14/com.shwfed.table.column.combobox-single/schema.js

@@ -18,6 +18,7 @@ export const compatibilityDate = "2026-06-14";
 export const metadata = {
   name: "\u5355\u9009",
   icon: "fluent:chevron-down-20-regular",
+  description: "\u53EF\u7F16\u8F91\u7684\u4E0B\u62C9\u5355\u9009\u5355\u5143\u683C\uFF0C\u9009\u4E2D\u503C\u5199\u56DE\u884C\u6570\u636E\uFF1B\u9009\u9879\u53EF\u9759\u6001\u914D\u7F6E\u6216\u8FDC\u7A0B\u52A0\u8F7D",
   // Publishes its resolved option (the source record) to the per-row
   // `selections` registry (runtime.vue), readable via `selections["<id>"]`.
   selection: true

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

@@ -36,19 +36,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
@@ -95,19 +95,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";

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

@@ -36,19 +36,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
@@ -95,19 +95,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";

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

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-06-14";
 export declare const metadata: {
     readonly name: "下拉树（多选）";
     readonly icon: "fluent:tree-evergreen-20-regular";
+    readonly description: "可编辑的下拉树多选单元格，选中节点写回行数据";
     readonly selection: true;
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{

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

@@ -17,6 +17,7 @@ export const compatibilityDate = "2026-06-14";
 export const metadata = {
   name: "\u4E0B\u62C9\u6811\uFF08\u591A\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
+  description: "\u53EF\u7F16\u8F91\u7684\u4E0B\u62C9\u6811\u591A\u9009\u5355\u5143\u683C\uFF0C\u9009\u4E2D\u8282\u70B9\u5199\u56DE\u884C\u6570\u636E",
   // Publishes its resolved nodes (array) to the per-row `selections` registry (runtime.vue), readable via `selections["<id>"]`.
   selection: true
 };

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

@@ -36,19 +36,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -94,19 +94,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

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

@@ -36,19 +36,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -94,19 +94,19 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]] | undefined;
         readonly keywords?: string | undefined;
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding: string;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

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

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-06-14";
 export declare const metadata: {
     readonly name: "下拉树（单选）";
     readonly icon: "fluent:tree-evergreen-20-regular";
+    readonly description: "可编辑的下拉树单选单元格，选中节点写回行数据";
     readonly selection: true;
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{

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

@@ -17,6 +17,7 @@ export const compatibilityDate = "2026-06-14";
 export const metadata = {
   name: "\u4E0B\u62C9\u6811\uFF08\u5355\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
+  description: "\u53EF\u7F16\u8F91\u7684\u4E0B\u62C9\u6811\u5355\u9009\u5355\u5143\u683C\uFF0C\u9009\u4E2D\u8282\u70B9\u5199\u56DE\u884C\u6570\u636E",
   // Publishes its resolved node (backend record) to the per-row `selections` registry (runtime.vue), readable via `selections["<id>"]`.
   selection: true
 };

package/dist/runtime/components/table/columns/2026-06-17/com.shwfed.table.column.date-input/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-06-17";
 export declare const metadata: {
     readonly name: "日期输入";
     readonly icon: "fluent:calendar-ltr-20-regular";
+    readonly description: "可编辑的日期输入单元格，值写回行数据";
 };
 export declare function presetSchema(configure: (env: Environment) => void): Schema.Struct<{
     id: Schema.refine<string, typeof Schema.String>;

package/dist/runtime/components/table/columns/2026-06-17/com.shwfed.table.column.date-input/schema.js

@@ -7,7 +7,8 @@ export const type = "com.shwfed.table.column.date-input";
 export const compatibilityDate = "2026-06-17";
 export const metadata = {
   name: "\u65E5\u671F\u8F93\u5165",
-  icon: "fluent:calendar-ltr-20-regular"
+  icon: "fluent:calendar-ltr-20-regular",
+  description: "\u53EF\u7F16\u8F91\u7684\u65E5\u671F\u8F93\u5165\u5355\u5143\u683C\uFF0C\u503C\u5199\u56DE\u884C\u6570\u636E"
 };
 function AddonActions(configure) {
   const configureWithRow = (env) => {

package/dist/runtime/components/table/columns/2026-06-22/com.shwfed.table.column.date-range-input/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-06-22";
 export declare const metadata: {
     readonly name: "日期范围输入";
     readonly icon: "fluent:calendar-arrow-right-20-regular";
+    readonly description: "可编辑的日期范围输入单元格，起止值写回行数据";
 };
 export declare function presetSchema(configure: (env: Environment) => void): Schema.Struct<{
     id: Schema.refine<string, typeof Schema.String>;

package/dist/runtime/components/table/columns/2026-06-22/com.shwfed.table.column.date-range-input/schema.js

@@ -6,7 +6,8 @@ export const type = "com.shwfed.table.column.date-range-input";
 export const compatibilityDate = "2026-06-22";
 export const metadata = {
   name: "\u65E5\u671F\u8303\u56F4\u8F93\u5165",
-  icon: "fluent:calendar-arrow-right-20-regular"
+  icon: "fluent:calendar-arrow-right-20-regular",
+  description: "\u53EF\u7F16\u8F91\u7684\u65E5\u671F\u8303\u56F4\u8F93\u5165\u5355\u5143\u683C\uFF0C\u8D77\u6B62\u503C\u5199\u56DE\u884C\u6570\u636E"
 };
 const BindingPath = Schema.String.pipe(Schema.minLength(1));
 const SplitBinding = Schema.Tuple(BindingPath, BindingPath).pipe(

package/dist/runtime/components/table/columns/2026-07-12/com.shwfed.table.column.dynamic/prompt.md

@@ -0,0 +1,15 @@
+**何时用我**：列集合随租户 / 渠道变化、无法在设计时固定时——由服务端返回的**列定义列表**运行时生成一组普通列。本列自身不渲染单元格，是个**生成器**：它产出的每一列都是普通文本 / 数值 / 日期列，可照常调宽度、排序、隐藏。
+
+**配置配方**
+
+- `request`（列定义请求）：返回 `HttpRequest` 的表达式，拉取列定义。**作用域只有宿主基础变量**——不能引用 `query` / `pageIndex` / `pageSize` / `sorts`（列集合不能依赖翻到第几页、搜了什么、怎么排序，引用会类型检查失败）。
+- `transform`：把响应 `json`（已解析，未取到为 `none`，用 `json.orValue([])` 解包）映射成**列描述符列表**，每项：
+  - `key`（必填，列唯一 id）、`header`（列名，纯文本）、`kind`（`text` / `number` / `date`，封闭词表）、`accessor`（必填，每行取值 CEL，`row` / `index` 在作用域内）。
+  - 可选 `width`（px，默认 150）、`align`、`sortable` / `sortKey`（服务端排序字段）、`hidden`、`tooltip`。
+  - `data_type_code → kind` 的判断写在你的 `transform` 里。
+
+**坑**
+
+- `transform` 的静态保证只有「返回 `list<dyn>`」；每项运行时按描述符解码，坏项被丢弃（loud）。
+- 生成的 `date` 列没有 per-column 日期格式（需要精细格式的列请用静态列），默认 `yyyy-MM-dd`。
+- 列定义的字段名 / 类型映射不确定时**向用户询问**。

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

@@ -9,11 +9,11 @@ type __VLS_ModelProps = {
     modelValue: AnyRecord;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_234: {}, __VLS_236: {};
+declare var __VLS_224: {}, __VLS_226: {};
 type __VLS_Slots = {} & {
-    'general-grid-extra'?: (props: typeof __VLS_234) => any;
+    'general-grid-extra'?: (props: typeof __VLS_224) => any;
 } & {
-    'general-extra'?: (props: typeof __VLS_236) => any;
+    'general-extra'?: (props: typeof __VLS_226) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: AnyRecord) => any;

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

@@ -34,7 +34,6 @@ import {
   InputGroupNumberField
 } from "../ui/input-group";
 import ActionsConfigEditor from "../actions/config.vue";
-import TableAiGenerate from "./ai-generate.vue";
 import ShwfedFormConfig from "../form/config.vue";
 import { defaultFormConfig } from "../form/schema";
 import { Environment } from "../../vendor/cel-js/lib/index";
@@ -251,7 +250,7 @@ function writeGeneralPatch(patch) {
   };
 }
 const editingGeneralConfig = computed(() => readGeneral());
-const selected = ref(props.hideDataSource ? { kind: "general" } : { kind: "ai" });
+const selected = ref({ kind: "general" });
 const fieldErrors = ref({});
 const pickedColumnIds = ref([]);
 const pickedColumnIdSet = computed(() => new Set(pickedColumnIds.value));
@@ -273,7 +272,6 @@ watch(
   },
   { immediate: true, deep: true }
 );
-const selectedAi = computed(() => selected.value.kind === "ai");
 const selectedGeneral = computed(() => selected.value.kind === "general");
 const selectedActions = computed(() => selected.value.kind === "actions");
 const selectedBottomActions = computed(() => selected.value.kind === "bottomActions");
@@ -539,7 +537,6 @@ function resolveSelection() {
     pickedColumnIds.value = pickedColumnIds.value.filter((id) => live.has(id));
   }
   const s = selected.value;
-  if (s.kind === "ai") return;
   if (s.kind === "general") return;
   if (s.kind === "actions") return;
   if (s.kind === "bottomActions") return;
@@ -548,9 +545,6 @@ function resolveSelection() {
   if (s.kind === "column" && findColumn(s.id)) return;
   selected.value = { kind: "general" };
 }
-function selectAi() {
-  selected.value = { kind: "ai" };
-}
 function selectGeneral() {
   selected.value = { kind: "general" };
 }
@@ -1173,21 +1167,6 @@ const tableQueryValue = computed({
       >
         <ScrollArea class="flex-1">
           <div class="flex flex-col gap-1">
-            <div
-              v-if="!hideDataSource"
-              class="row general-row pl-2"
-              :class="[
-  selectedAi ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-600 hover:bg-zinc-50'
-]"
-              @click.stop="selectAi()"
-            >
-              <Icon
-                icon="fluent:sparkle-20-regular"
-                class="size-4 shrink-0"
-              />
-              <span class="flex-1 truncate">AI 生成</span>
-            </div>
-
             <div
               class="row general-row pl-2"
               :class="[
@@ -1396,18 +1375,7 @@ const tableQueryValue = computed({
       </div>
 
       <div class="flex min-h-0 min-w-0 flex-1 flex-col">
-        <!-- The AI chat owns the full right pane and manages its own scroll /
-             composer, so it replaces (not nests inside) the section ScrollArea.
-             `min-w-0` lets this flex item shrink below its content's intrinsic
-             width — without it a long tool-call `<pre>` forces the pane (and the
-             whole editor dialog) wider than the viewport. -->
-        <TableAiGenerate
-          v-if="selectedAi"
-          v-model="config"
-          :configure="configure"
-        />
         <ScrollArea
-          v-else
           class="flex-1"
         >
           <div

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

@@ -9,11 +9,11 @@ type __VLS_ModelProps = {
     modelValue: AnyRecord;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_234: {}, __VLS_236: {};
+declare var __VLS_224: {}, __VLS_226: {};
 type __VLS_Slots = {} & {
-    'general-grid-extra'?: (props: typeof __VLS_234) => any;
+    'general-grid-extra'?: (props: typeof __VLS_224) => any;
 } & {
-    'general-extra'?: (props: typeof __VLS_236) => any;
+    'general-extra'?: (props: typeof __VLS_226) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: AnyRecord) => any;

package/dist/runtime/components/table/row-provider.vue

@@ -60,7 +60,13 @@ useDerived({
   evaluate: (expression) => $cel(expression),
   ready: Promise.resolve(),
   formState,
-  quiescence: useDerivedQuiescence()
+  quiescence: useDerivedQuiescence(),
+  // Selection cells publish into the row's registry only once their (typically
+  // remote) options land and resolve the stored key — after the first
+  // derivation pass, and outside form state. Without this dependency a cell
+  // reading `selections["<column-id>"]` evaluates once against an empty
+  // registry and never recomputes. Mirrors the form host and the list row.
+  dependencies: () => selections.entries.value
 });
 defineExpose({ evaluate: (expression) => Effect.runSync($cel(expression)) });
 </script>

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

@@ -141,6 +141,35 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
     readonly displayName?: string | undefined;
     readonly columns: readonly any[];
     readonly kind: "shwfed.component.table";
+    readonly query?: {
+        readonly style?: string | undefined;
+        readonly id?: string | undefined;
+        readonly initial?: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        } | undefined;
+        readonly displayName?: string | undefined;
+        readonly kind: "shwfed.component.form";
+        readonly fields: readonly any[];
+        readonly layouts: readonly {
+            readonly name: string;
+            readonly layout: {
+                readonly style?: string | undefined;
+                readonly columns: number;
+                readonly gap?: number | undefined;
+                readonly rows?: number | undefined;
+                readonly placements: {
+                    readonly [x: string]: {
+                        readonly area: readonly [readonly [number, number], readonly [number, number]];
+                        readonly v?: "stretch" | "center" | "end" | "start" | undefined;
+                        readonly h?: "stretch" | "center" | "end" | "start" | undefined;
+                    };
+                };
+            };
+            readonly media?: string | undefined;
+        }[];
+        readonly readonly?: string | undefined;
+    } | undefined;
     readonly groups: readonly {
         readonly id: string;
         readonly title?: readonly [{
@@ -225,35 +254,6 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
             readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
         }[];
     } | undefined;
-    readonly query?: {
-        readonly style?: string | undefined;
-        readonly id?: string | undefined;
-        readonly initial?: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        } | undefined;
-        readonly displayName?: string | undefined;
-        readonly kind: "shwfed.component.form";
-        readonly fields: readonly any[];
-        readonly layouts: readonly {
-            readonly name: string;
-            readonly layout: {
-                readonly style?: string | undefined;
-                readonly columns: number;
-                readonly gap?: number | undefined;
-                readonly rows?: number | undefined;
-                readonly placements: {
-                    readonly [x: string]: {
-                        readonly area: readonly [readonly [number, number], readonly [number, number]];
-                        readonly v?: "stretch" | "center" | "end" | "start" | undefined;
-                        readonly h?: "stretch" | "center" | "end" | "start" | undefined;
-                    };
-                };
-            };
-            readonly media?: string | undefined;
-        }[];
-        readonly readonly?: string | undefined;
-    } | undefined;
     readonly dataSource?: {
         readonly data: string;
         readonly total?: string | undefined;
@@ -810,6 +810,35 @@ export declare function createTableConfig(body: Omit<Schema.Schema.Type<ReturnTy
     id?: string | undefined;
     displayName?: string | undefined;
     columns: readonly any[];
+    query?: {
+        readonly style?: string | undefined;
+        readonly id?: string | undefined;
+        readonly initial?: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        } | undefined;
+        readonly displayName?: string | undefined;
+        readonly kind: "shwfed.component.form";
+        readonly fields: readonly any[];
+        readonly layouts: readonly {
+            readonly name: string;
+            readonly layout: {
+                readonly style?: string | undefined;
+                readonly columns: number;
+                readonly gap?: number | undefined;
+                readonly rows?: number | undefined;
+                readonly placements: {
+                    readonly [x: string]: {
+                        readonly area: readonly [readonly [number, number], readonly [number, number]];
+                        readonly v?: "stretch" | "center" | "end" | "start" | undefined;
+                        readonly h?: "stretch" | "center" | "end" | "start" | undefined;
+                    };
+                };
+            };
+            readonly media?: string | undefined;
+        }[];
+        readonly readonly?: string | undefined;
+    } | undefined;
     groups: readonly {
         readonly id: string;
         readonly title?: readonly [{
@@ -894,35 +923,6 @@ export declare function createTableConfig(body: Omit<Schema.Schema.Type<ReturnTy
             readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
         }[];
     } | undefined;
-    query?: {
-        readonly style?: string | undefined;
-        readonly id?: string | undefined;
-        readonly initial?: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        } | undefined;
-        readonly displayName?: string | undefined;
-        readonly kind: "shwfed.component.form";
-        readonly fields: readonly any[];
-        readonly layouts: readonly {
-            readonly name: string;
-            readonly layout: {
-                readonly style?: string | undefined;
-                readonly columns: number;
-                readonly gap?: number | undefined;
-                readonly rows?: number | undefined;
-                readonly placements: {
-                    readonly [x: string]: {
-                        readonly area: readonly [readonly [number, number], readonly [number, number]];
-                        readonly v?: "stretch" | "center" | "end" | "start" | undefined;
-                        readonly h?: "stretch" | "center" | "end" | "start" | undefined;
-                    };
-                };
-            };
-            readonly media?: string | undefined;
-        }[];
-        readonly readonly?: string | undefined;
-    } | undefined;
     dataSource?: {
         readonly data: string;
         readonly total?: string | undefined;

package/dist/runtime/components/table/utils/ai-tools.js

@@ -1,4 +1,5 @@
 import { JSONSchema, ParseResult, Schema } from "effect";
+import { getCelCatalog } from "../../../utils/cel-catalog.js";
 import { coerceFromString } from "../../../share/coerce-from-string.js";
 import { Expression, HttpRequestResult } from "../../../share/expression.js";
 import {
@@ -10,7 +11,7 @@ import {
 import { metadata as formMetadata } from "../../form/schema.js";
 import { registerRowVariablesIfAbsent } from "./shared.js";
 import { activeColumns } from "./resolve.js";
-import { createQueryFieldTools } from "../../form/utils/ai-field-tools.js";
+import { createFormFieldTools } from "../../form/utils/ai-field-tools.js";
 const HARNESS_KEYS = ["id", "groupId", "compatibilityDate"];
 function publicColumnSchema(entry, configure) {
   return entry.schema(configure).pipe(Schema.omit(...HARNESS_KEYS));
@@ -81,7 +82,7 @@ function safeJsonSchema(schema) {
 export function createTableAiTools(deps) {
   const dataSourceSchemas = buildDataSourceExpressionSchemas(deps.configure);
   const rowKeySchema = buildRowKeyExpressionSchema(deps.configure);
-  const queryFieldTools = createQueryFieldTools({
+  const queryFieldTools = createFormFieldTools({
     read: () => deps.read().query,
     write: (next) => {
       const working = deps.read();
@@ -109,7 +110,7 @@ export function createTableAiTools(deps) {
     },
     {
       name: "describe_specific_column_type",
-      description: "Return the JSON Schema (without `id`/`groupId` \u2014 those are managed by the harness) and the default values for one column type. Call this before `insert_column` to learn the field contract. Deprecated types are not accepted.",
+      description: "Return the JSON Schema (without `id`/`groupId` \u2014 those are managed by the harness), the default values, and \u2014 when the type has one \u2014 a prose `guide` (when to use it, config recipe, gotchas) for one column type. Call this before `insert_column` to learn the field contract. Deprecated types are not accepted.",
       inputJsonSchema: {
         type: "object",
         properties: {
@@ -134,15 +135,17 @@ export function createTableAiTools(deps) {
         } catch {
           jsonSchema = "(schema unavailable)";
         }
-        return {
+        const result = {
           schema: jsonSchema,
           defaults: entry.defaults?.() ?? null
         };
+        if (entry.prompt !== void 0) result.guide = entry.prompt;
+        return result;
       }
     },
     {
       name: "describe_general_settings",
-      description: "Return the schema and current values for the table's general settings: `displayName` (internal label), `dataSource` (HTTP request / data extraction / total \u2014 each with its own CEL scope and available variables baked into the JSON Schema description), `rowKey` (per-row CEL expression evaluated against `row` / `index`), and the `pagination` toggle's current on/off state. Call this first when configuring a fresh table from API documentation; the CEL expressions reference the same scopes the inline UI validates against, so what you learn here is what the setters accept.",
+      description: "Return the schema and current values for the table's general settings: `displayName` (internal label), `dataSource` (HTTP request / data extraction / total \u2014 each with its own CEL scope and available variables baked into the JSON Schema description), `rowKey` (per-row CEL expression evaluated against `row` / `index`), and the `pagination` toggle's current on/off state, plus `celFunctions` \u2014 the CEL operator & function catalog. Call this first when configuring a fresh table from API documentation; the CEL expressions reference the same scopes the inline UI validates against, so what you learn here is what the setters accept.",
       inputJsonSchema: {
         type: "object",
         properties: {},
@@ -217,7 +220,13 @@ export function createTableAiTools(deps) {
               kind: "toggle",
               enabled: working.pagination !== void 0
             }
-          ]
+          ],
+          // The CEL operator & function catalog for the expressions above. The
+          // per-field variable scopes are already baked into each `jsonSchema`
+          // description (request / data / total / rowKey scopes differ), so this
+          // is the language reference half — extends the inlined-CEL pattern
+          // rather than duplicating the variable tables.
+          celFunctions: getCelCatalog()
         };
       }
     },
@@ -501,7 +510,7 @@ ${fieldErrors.map((e) => `- ${e}`).join("\n")}`;
         return targets;
       }
     },
-    // ---- 搜索条件（query = 一个 FormConfig；字段工具镜像列工具，放置为新增）----
+    // ---- 搜索条件（query = 一个 FormConfig；通用 `*_field*` 族，放置为新增）----
     ...queryFieldTools
   ];
 }