@shwfed/config 3.0.6 → 3.0.8

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/config.vue.d.ts

@@ -37,15 +37,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -56,15 +56,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -76,6 +67,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -112,15 +112,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -131,15 +131,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -151,6 +142,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/prompt.md

@@ -0,0 +1,9 @@
+## 树（多选）字段
+
+在一棵内联渲染的树里勾选多个节点；绑定值是**已勾选节点 ID 的数组**。
+
+节点契约与树（单选）一致：`dataSource` 返回完整树的根节点列表（`request` + `data`，同表格数据源写法）；`nodeId` / `nodeChildren` / `nodeLabel` / `nodeTooltip` / `nodeSelectable` 都在 `node`（当前节点）作用域下逐节点求值——`nodeChildren` 返回 `none`/`null` 即叶子（常写 `node.?children.orValue(null)`）。
+
+多选特有的是 `cascade`（级联模式）：`independent` 只勾当前节点；`cascade-down` 勾父节点连带勾选全部可选后代；`cascade-both`（默认）在向下级联之上让父节点反映后代状态（半选）。级联仍尊重 `nodeSelectable`。
+
+搜索框（`filter.enabled`）按节点标签匹配，`filter.keywords`（node 作用域）可折入更多字段；过滤只影响显示，不影响已勾选的 ID。

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/schema.d.ts

@@ -6,6 +6,7 @@ export declare const compatibilityDate: "2026-05-28";
 export declare const metadata: {
     readonly name: "树（多选）";
     readonly icon: "fluent:tree-evergreen-20-regular";
+    readonly description: "在树形数据中多选节点";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/schema.js

@@ -9,6 +9,7 @@ export const compatibilityDate = "2026-05-28";
 export const metadata = {
   name: "\u6811\uFF08\u591A\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
+  description: "\u5728\u6811\u5F62\u6570\u636E\u4E2D\u591A\u9009\u8282\u70B9",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 8, min: 4, max: Infinity, grow: true },
   // Publishes its resolved nodes (array, in selection order) to the `selections`

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.d.vue.ts

@@ -37,15 +37,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -55,15 +55,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -75,6 +66,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -111,15 +111,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -129,15 +129,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -149,6 +140,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.vue.d.ts

@@ -37,15 +37,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -55,15 +55,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -75,6 +66,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -111,15 +111,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
+        readonly dataSource: {
+            readonly data: string;
+            readonly request?: string | undefined;
+        };
         readonly binding?: string | undefined;
         readonly derived?: {
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly dataSource: {
-            readonly data: string;
-            readonly request?: string | undefined;
-        };
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: readonly [{
@@ -129,15 +129,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly nodeTooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly nodeSelectable?: string | undefined;
-        readonly expandAll: boolean;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -149,6 +140,15 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly warning?: boolean | undefined;
             readonly when: string;
         }[] | undefined;
+        readonly nodeTooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly nodeSelectable?: string | undefined;
+        readonly expandAll: boolean;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/prompt.md

@@ -0,0 +1,11 @@
+## 树（单选）字段
+
+在一棵内联渲染的树里单选一个节点；绑定值是**所选节点 ID 的字符串**（标量）。
+
+节点契约（树家族共同的配方）：
+
+- `dataSource` 返回**完整树的根节点列表**（`request` 发 HTTP、`data` 从 `json` 里取根列表，同表格数据源写法）；树不做懒加载。
+- 其余节点表达式都在 `node`（当前节点，`dyn`）作用域下逐节点求值：`nodeId`（稳定唯一 ID，结果按字符串存）、`nodeChildren`（子级列表，返回 `none`/`null` 即叶子，常写 `node.?children.orValue(null)`）、`nodeLabel`（本地化 Markdown，`{{ node.name }}` 插值）、`nodeSelectable`（返回 `true` 才可选——常用来限制只能选叶子）。
+- 选中节点的完整记录发布到 `selections["<字段 uuid>"]`，兄弟字段表达式可读整个后端对象，而不只是绑定的 ID。
+
+搜索框（`filter.enabled`）开启后按节点标签匹配；要把别的字段折进搜索面，配 `filter.keywords`（node 作用域，返回参与匹配的字符串列表）。

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-05-28";
 export declare const metadata: {
     readonly name: "树（单选）";
     readonly icon: "fluent:tree-evergreen-20-regular";
+    readonly description: "在树形数据中单选一个节点";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/schema.js

@@ -9,6 +9,7 @@ export const compatibilityDate = "2026-05-28";
 export const metadata = {
   name: "\u6811\uFF08\u5355\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
+  description: "\u5728\u6811\u5F62\u6570\u636E\u4E2D\u5355\u9009\u4E00\u4E2A\u8282\u70B9",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 8, min: 4, max: Infinity, grow: true },
   // Publishes its resolved node (the backend record) to the `selections`

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/prompt.md

@@ -0,0 +1,12 @@
+## 文件上传字段
+
+两种模式，取决于是否配置「即时上传」（`upload`）：
+
+- **不配置**（延迟模式）：选中的文件以原始 `File` 数组存放在绑定值里，随表单一并提交（由提交按钮的请求负责编码）。
+- **配置后**（即时模式）：每次选择文件立刻发起 `upload.request`（CEL 里用 `files` 引用本次选中的文件，如 `http.post(url).body(form({"files": files}))`），再用 `upload.handle` 把响应 `json` **映射成一个列表**追加到绑定值（如 `json.data.map(d, {"cacheKey": d.key, "filename": d.fileOriginalName})`）；`upload.filename` 用 `file` 引用单个已存文件项返回其展示名。绑定值里存的是映射后的对象，不是 `File`。
+
+三个表达式各有各的变量：`request` 见 `files`（本次选择）、`handle` 见 `json`（上传响应）、`filename` 见 `file`（单个存量项）——不要混用。
+
+`templates` 在上传区旁渲染「下载模板」按钮：只配 `request` 则直接下载其响应；再配 `download` 则是两步式——第二步经 `json` 引用第一步响应（如用 `json.data.key` 拼真正的下载地址）。
+
+约束类字段（`accept` / `maxFileSize` / `maxTotalSize` / `maxFiles` / `multiple`）按需设置即可。

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-06-09";
 export declare const metadata: {
     readonly name: "文件上传";
     readonly icon: "fluent:cloud-arrow-up-20-regular";
+    readonly description: "上传文件，值为文件描述对象列表";
     readonly w: {
         readonly initial: 8;
         readonly min: 8;

package/dist/runtime/components/form/fields/2026-06-09/com.shwfed.form.field.upload/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-06-09";
 export const metadata = {
   name: "\u6587\u4EF6\u4E0A\u4F20",
   icon: "fluent:cloud-arrow-up-20-regular",
+  description: "\u4E0A\u4F20\u6587\u4EF6\uFF0C\u503C\u4E3A\u6587\u4EF6\u63CF\u8FF0\u5BF9\u8C61\u5217\u8868",
   w: { initial: 8, min: 8, max: Infinity },
   h: { initial: 6, min: 6, max: Infinity, grow: true }
 };

package/dist/runtime/components/form/fields/2026-06-14/com.shwfed.form.field.combobox.multi/prompt.md

@@ -0,0 +1,14 @@
+**何时用我**：从一组选项中**多选**（可选多个值，绑定为数组）。选项固定用静态，来自接口用远程。与「下拉单选」同构，差别只在选中结果是列表。
+
+**配置配方**
+
+- `binding`：写入表单状态的 dot-prop 路径；选中值是数组。
+- `options` 是判别联合，二选一：
+  - `{ kind: 'static', items: [...] }`：每项 `{ label: <Locale 纯文本>, value: { kind: 'text'|'number', value } }`，可选 `tooltip` / `keywords`。
+  - `{ kind: 'remote', ... }`：`request`（可选，返回 `HttpRequest`，可访问 `form`；留空则直接对 `form` 求值 `options`、`json == null`）、`options`（提取数组，可访问 `form` / `json`）、`optionLabel`（可访问 `option`）、`optionValue`（默认 `option`，通常设为 `option.value`）、`optionKeywords`（可选）。
+
+**坑**
+
+- 静态项 `value` 是判别对象 `{ kind, value }`，不是裸值。
+- 远程 `optionValue` 默认是整个 `option`，多选时通常要设成标量（如 `option.value`），否则数组里塞的是整对象。
+- 选项集合不确定时**先向用户询问**。

package/dist/runtime/components/form/fields/2026-06-14/com.shwfed.form.field.combobox.multi/schema.d.ts

@@ -6,6 +6,7 @@ export declare const compatibilityDate: "2026-06-14";
 export declare const metadata: {
     readonly name: "下拉多选";
     readonly icon: "fluent:chevron-down-20-regular";
+    readonly description: "从一组选项中下拉多选";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-06-14/com.shwfed.form.field.combobox.multi/schema.js

@@ -8,6 +8,7 @@ export const compatibilityDate = "2026-06-14";
 export const metadata = {
   name: "\u4E0B\u62C9\u591A\u9009",
   icon: "fluent:chevron-down-20-regular",
+  description: "\u4ECE\u4E00\u7EC4\u9009\u9879\u4E2D\u4E0B\u62C9\u591A\u9009",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 },
   // Publishes its resolved options (array, in selection order) to the

package/dist/runtime/components/form/fields/2026-06-14/com.shwfed.form.field.combobox.single/prompt.md

@@ -0,0 +1,19 @@
+**何时用我**：从一组选项中单选一个值（角色、状态、分类……）。选项固定就用静态，选项来自接口就用远程。
+
+**配置配方**
+
+- `binding`：写入表单状态的 dot-prop 路径（如 `user.role`）。
+- `options` 是判别联合，二选一：
+  - `{ kind: 'static', items: [...] }`：手配选项。每项 `{ label: <Locale>, value: { kind: 'text'|'number', value } }`；`label` 是**纯文本 Locale**（不支持 Markdown / 插值）。可选 `tooltip` / `keywords`（附加搜索词，不展示）。
+  - `{ kind: 'remote', ... }`：CEL / 远端产出。
+    - `request`（可选）：返回 `HttpRequest` 的表达式，可访问 `form`。**留空则不发请求**，直接对 `form` 求值 `options`（此时 `json == null`）——这是纯 CEL 选项的写法。
+    - `options`：提取选项数组，可访问 `form` 与 `json`（如 `json.?data.orValue([])`）。
+    - `optionLabel`：返回展示文本，可访问 `option`（当前迭代项），如 `option.name` 或 `string(option.code) + ' - ' + option.name`。
+    - `optionValue`（默认 `option`）：从 `option` 提取写入绑定的值，如 `option.value`。
+    - `optionKeywords`（可选）：返回字符串列表，参与搜索但不展示。
+
+**坑**
+
+- 静态项的 `value` 是判别对象 `{ kind, value }`，不是裸值；文本用 `kind: 'text'`，数字用 `kind: 'number'`。
+- 远程 `optionValue` 默认写入整个 `option` 对象——通常要显式设成 `option.value` 之类的标量。
+- 选项集合不确定（有哪些值、对应什么 label）时**先向用户询问**，不要编造。

package/dist/runtime/components/form/fields/2026-06-14/com.shwfed.form.field.combobox.single/schema.d.ts

@@ -6,6 +6,7 @@ export declare const compatibilityDate: "2026-06-14";
 export declare const metadata: {
     readonly name: "下拉单选";
     readonly icon: "fluent:chevron-down-20-regular";
+    readonly description: "从一组选项中下拉单选";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-06-14/com.shwfed.form.field.combobox.single/schema.js

@@ -8,6 +8,7 @@ export const compatibilityDate = "2026-06-14";
 export const metadata = {
   name: "\u4E0B\u62C9\u5355\u9009",
   icon: "fluent:chevron-down-20-regular",
+  description: "\u4ECE\u4E00\u7EC4\u9009\u9879\u4E2D\u4E0B\u62C9\u5355\u9009",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 },
   // Publishes its resolved option to the `selections` registry (runtime.vue), so

package/dist/runtime/components/form/fields/2026-06-20/com.shwfed.form.field.tabs/schema.d.ts

@@ -2,9 +2,16 @@ import { Schema } from 'effect';
 import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
 export declare const type: "com.shwfed.form.field.tabs";
 export declare const compatibilityDate: "2026-06-20";
+export declare const edges: readonly [{
+    readonly key: "tabs";
+    readonly host: "form";
+    readonly label: "标签内容";
+    readonly itemSlot: "unit";
+}];
 export declare const metadata: {
     readonly name: "标签页";
     readonly icon: "fluent:tabs-20-regular";
+    readonly description: "把字段分组到多个标签页（仅视觉分组）";
     readonly w: {
         readonly initial: 12;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-06-20/com.shwfed.form.field.tabs/schema.js

@@ -3,9 +3,13 @@ import { Locale } from "../../../../../share/locale.js";
 import { FormUnit } from "../../../schema.js";
 export const type = "com.shwfed.form.field.tabs";
 export const compatibilityDate = "2026-06-20";
+export const edges = [
+  { key: "tabs", host: "form", label: "\u6807\u7B7E\u5185\u5BB9", itemSlot: "unit" }
+];
 export const metadata = {
   name: "\u6807\u7B7E\u9875",
   icon: "fluent:tabs-20-regular",
+  description: "\u628A\u5B57\u6BB5\u5206\u7EC4\u5230\u591A\u4E2A\u6807\u7B7E\u9875\uFF08\u4EC5\u89C6\u89C9\u5206\u7EC4\uFF09",
   w: { initial: 12, min: 4, max: Infinity },
   h: { initial: 6, min: 2, max: Infinity, grow: true },
   // Hosts a nested sub-form per tab (each tab's own fields + layout) — too

package/dist/runtime/components/form/fields/2026-07-13/com.shwfed.form.field.dynamic/prompt.md

@@ -0,0 +1,14 @@
+**何时用我**：字段集合在运行时才由服务端**字段定义接口**决定（不同租户 / 单据类型的表单项不同），无法在设计时逐个固定。本块自身不渲染，是个**生成器**：拉取字段定义，`transform` 成一批普通字段渲染出来。
+
+**配置配方**
+
+- `request`（可选）：返回 `HttpRequest` 的表达式，拉取字段定义。**作用域是冻结的**——不能引用 `form` / `now` 等表单运行时变量（字段集合必须与用户输入无关，引用会在类型检查期直接报错）。
+- `transform`：把响应 `json`（已解析，未取到为 `none`，用 `json.orValue([])` 解包）映射成一个**字段描述符列表**，每项：
+  - `binding`（必填，dot-prop 路径）、`label`（纯文本）、`kind`（`text` / `number` / `date` / `daterange` / `dropdown` 之一，封闭词表）。
+  - 可选 `required`（布尔）、`default`（初值，仅当该路径当前为空时写入）、`options`（**仅 `dropdown` 用**，`[{ value, label }]`；choice 类缺 `options` 会被丢弃）。
+  - `kind` 到具体渲染字段的映射由本块钉死，`data_type_code → kind` 的判断写在你的 `transform` 里，不在别处。
+
+**坑**
+
+- `transform` 的静态保证只有「返回 `list<dyn>`」；每项运行时按描述符解码，坏项会被丢弃（loud）。字段名、类型、下拉选项等业务映射不确定时**向用户询问**。
+- `request` / `transform` 里写 `form.xxx` 会类型检查失败——这是有意的冻结约束。

package/dist/runtime/components/form/fields/2026-07-13/com.shwfed.form.field.dynamic/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-07-13";
 export declare const metadata: {
     readonly name: "动态字段";
     readonly icon: "fluent:form-multiple-20-regular";
+    readonly description: "运行时按接口返回动态生成一组字段";
     readonly w: {
         readonly initial: 12;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-07-13/com.shwfed.form.field.dynamic/schema.js

@@ -8,6 +8,7 @@ export const compatibilityDate = "2026-07-13";
 export const metadata = {
   name: "\u52A8\u6001\u5B57\u6BB5",
   icon: "fluent:form-multiple-20-regular",
+  description: "\u8FD0\u884C\u65F6\u6309\u63A5\u53E3\u8FD4\u56DE\u52A8\u6001\u751F\u6210\u4E00\u7EC4\u5B57\u6BB5",
   w: { initial: 12, min: 4, max: Infinity },
   h: { initial: 4, min: 2, max: Infinity, grow: true }
   // Hosts a runtime-generated sub-form; its config (two expressions + two

package/dist/runtime/components/form/unit-config.vue

@@ -199,7 +199,7 @@ async function copyFields(ids) {
       if (p) placements[id] = p;
     }
   }
-  if (!await writeClip("form", items, placements)) {
+  if (!await writeClip("form", { items, placements })) {
     toast.error("\u590D\u5236\u5931\u8D25");
     return;
   }
@@ -208,7 +208,7 @@ async function copyFields(ids) {
 async function pasteFields(target) {
   const payload = await readClip();
   if (!payload || payload.surface !== "form") return;
-  const { items, placements } = reidFragment(payload.items, payload.placements);
+  const { items, placements } = reidFragment(payload);
   const pasted = items;
   if (pasted.length === 0) return;
   const place = placements;

package/dist/runtime/components/form/utils/ai-field-tools.d.ts

@@ -1,11 +1,11 @@
 import type { Environment } from '../../../vendor/cel-js/lib/index.js';
 import type { AgenticTool } from '../../../utils/ai/index.js';
 type AnyRecord = Record<string, any>;
-export interface QueryFieldToolDeps {
+export interface FormFieldToolDeps {
     readonly read: () => AnyRecord | undefined;
     readonly write: (next: AnyRecord) => void;
     readonly configure: (env: Environment) => void;
     readonly genUuid: () => string;
 }
-export declare function createQueryFieldTools(deps: QueryFieldToolDeps): AgenticTool[];
+export declare function createFormFieldTools(deps: FormFieldToolDeps): AgenticTool[];
 export {};