@shwfed/config 3.0.7 → 3.0.8

package/dist/runtime/components/config/utils/ai-host-manuals.d.ts

@@ -0,0 +1,2 @@
+/** The L1 manual for a host kind (`table` / `form` / `page-slot`), or undefined. */
+export declare function getHostManual(kind: string): string | undefined;

package/dist/runtime/components/config/utils/ai-host-manuals.js

@@ -0,0 +1,19 @@
+import rawTable from "../../table/ai-l1.md?raw";
+import rawForm from "../../form/ai-l1.md?raw";
+import rawActions from "../../actions/ai-l1.md?raw";
+import rawPageSlot from "../ai-page-slot.l1.md?raw";
+const manuals = {
+  "table": rawTable,
+  "form": rawForm,
+  "actions": rawActions,
+  "page-slot": rawPageSlot
+};
+if (import.meta.hot) {
+  import.meta.hot.accept("../../table/ai-l1.md?raw", (m) => void (typeof m?.default === "string" && (manuals.table = m.default)));
+  import.meta.hot.accept("../../form/ai-l1.md?raw", (m) => void (typeof m?.default === "string" && (manuals.form = m.default)));
+  import.meta.hot.accept("../../actions/ai-l1.md?raw", (m) => void (typeof m?.default === "string" && (manuals.actions = m.default)));
+  import.meta.hot.accept("../ai-page-slot.l1.md?raw", (m) => void (typeof m?.default === "string" && (manuals["page-slot"] = m.default)));
+}
+export function getHostManual(kind) {
+  return manuals[kind];
+}

package/dist/runtime/components/config/utils/linkage.d.ts

@@ -1,7 +1,14 @@
 export type LinkageKind = 'operation' | 'step' | 'scope';
+/**
+ * Why the linkage is bad. `missing` — the uuid is defined nowhere in the tree.
+ * `unreachable` — it is defined, but not on the reference's own chain of
+ * enclosing nodes (operation targets only; see the header).
+ */
+export type LinkageFault = 'missing' | 'unreachable';
 export type DanglingLinkage = Readonly<{
     kind: LinkageKind;
-    /** The referenced uuid that is not defined anywhere in the tree. */
+    fault: LinkageFault;
+    /** The referenced uuid. */
     id: string;
     /**
      * Property path from the config root to the offending reference
@@ -19,11 +26,13 @@ export type DanglingLinkage = Readonly<{
  */
 export declare function definedIds(node: unknown): Set<string>;
 /**
- * Find every linkage in `config` whose target uuid is not defined anywhere in
- * the tree. `PAGE_TARGET_ID` (the singleton page target sentinel) is always
- * valid — it names the outermost page, which carries no stored id. Each result
- * carries the property path from the config root to the offending reference, so
- * the caller can render a field-level breadcrumb (see `describePath`).
+ * Find every linkage in `config` that a save must refuse: one whose uuid is
+ * defined nowhere (`missing`), or an operation target that is defined but not on
+ * the trigger's own chain of enclosing nodes (`unreachable`). `PAGE_TARGET_ID`
+ * (the singleton page target sentinel) is always valid — it names the outermost
+ * page, which carries no stored id and encloses everything. Each result carries
+ * the property path from the config root to the offending reference, so the
+ * caller can render a field-level breadcrumb (see `describePath`).
  */
 export declare function findDanglingLinkages(config: unknown): DanglingLinkage[];
 export declare const LINKAGE_KIND_LABEL: Record<LinkageKind, string>;

package/dist/runtime/components/config/utils/linkage.js

@@ -22,9 +22,9 @@ export function definedIds(node) {
   collectDefinedIds(node, out);
   return out;
 }
-function collectRefs(node, path, into) {
+function collectRefs(node, path, enclosing, into) {
   if (Array.isArray(node)) {
-    node.forEach((v, i) => collectRefs(v, [...path, i], into));
+    node.forEach((v, i) => collectRefs(v, [...path, i], enclosing, into));
     return;
   }
   if (!isObject(node)) {
@@ -35,22 +35,38 @@ function collectRefs(node, path, into) {
     return;
   }
   if (typeof node.target === "string" && typeof node.operation === "string" && UUID_RE.test(node.target)) {
-    into.push({ kind: "operation", id: node.target, path: [...path, "target"] });
+    into.push({ kind: "operation", id: node.target, path: [...path, "target"], enclosing });
   }
-  for (const [k, v] of Object.entries(node)) collectRefs(v, [...path, k], into);
+  const inner = typeof node.id === "string" && UUID_RE.test(node.id) ? [...enclosing, node.id] : enclosing;
+  for (const [k, v] of Object.entries(node)) collectRefs(v, [...path, k], inner, into);
 }
 export function findDanglingLinkages(config) {
   const defined = /* @__PURE__ */ new Set();
   collectDefinedIds(config, defined);
   const refs = [];
-  collectRefs(config, [], refs);
-  return refs.filter((r) => r.id !== PAGE_TARGET_ID && !defined.has(r.id));
+  collectRefs(config, [], [], refs);
+  const out = [];
+  for (const ref of refs) {
+    if (ref.id === PAGE_TARGET_ID) continue;
+    if (!defined.has(ref.id)) {
+      out.push({ kind: ref.kind, fault: "missing", id: ref.id, path: ref.path });
+      continue;
+    }
+    if (ref.enclosing && !ref.enclosing.includes(ref.id)) {
+      out.push({ kind: ref.kind, fault: "unreachable", id: ref.id, path: ref.path });
+    }
+  }
+  return out;
 }
 export const LINKAGE_KIND_LABEL = {
   operation: "\u89E6\u53D1\u64CD\u4F5C",
   step: "\u6B65\u9AA4\u5F15\u7528",
   scope: "\u8DE8\u5C42\u4F5C\u7528\u57DF\u5F15\u7528"
 };
+const LINKAGE_FAULT_TEXT = {
+  missing: "\u5F15\u7528\u4E86\u5DF2\u5931\u6548\u7684\u8D44\u6E90\uFF08\u6765\u6E90\u4E0D\u5B58\u5728\u4E8E\u5F53\u524D\u914D\u7F6E\u4E2D\uFF09",
+  unreachable: "\u6307\u5411\u4E86\u5F53\u524D\u4F4D\u7F6E\u65E0\u6CD5\u8BBF\u95EE\u7684\u76EE\u6807\uFF08\u8BE5\u76EE\u6807\u5B58\u5728\uFF0C\u4F46\u4E0D\u662F\u5B83\u7684\u4E0A\u5C42\u7EC4\u4EF6\uFF0C\u901A\u5E38\u662F\u590D\u5236\u540E\u672A\u91CD\u65B0\u6307\u5411\uFF09"
+};
 export function formatDanglingLinkages(dangling, rootData, blockLabelAt) {
   const first = dangling[0];
   if (!first) return "";
@@ -58,5 +74,5 @@ export function formatDanglingLinkages(dangling, rootData, blockLabelAt) {
   const segs = describePath(first.path, rootData, blockLabelAt);
   const where = segs.length > 0 ? `\u300C${segs.join(" \u203A ")}\u300D\u7684${kind}` : kind;
   const suffix = dangling.length > 1 ? `\uFF08\u8FD8\u6709 ${dangling.length - 1} \u4E2A\uFF09` : "";
-  return `${where}\u5F15\u7528\u4E86\u5DF2\u5931\u6548\u7684\u8D44\u6E90\uFF08\u6765\u6E90\u4E0D\u5B58\u5728\u4E8E\u5F53\u524D\u914D\u7F6E\u4E2D\uFF09\uFF0C\u8BF7\u4FEE\u6B63\u540E\u518D\u4FDD\u5B58${suffix}`;
+  return `${where}${LINKAGE_FAULT_TEXT[first.fault]}\uFF0C\u8BF7\u4FEE\u6B63\u540E\u518D\u4FDD\u5B58${suffix}`;
 }

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

@@ -1,6 +1,7 @@
 import type { Component } from 'vue';
 import { Schema } from 'effect';
 import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+import { type RegistryEdge } from '../../../share/define-registry.js';
 type AnySchema = Schema.Schema<any, any, never>;
 /**
  * Container blocks (e.g. tabs) receive a recursive `blockRef` second arg so
@@ -32,6 +33,12 @@ export type BlockSizeRange = Readonly<{
 export type BlockMetadata = Readonly<{
     name: string;
     icon: string;
+    /**
+     * 一句话说明该块的适用场景；AI 在 `list_available_block_types` 工具里看到。
+     * **可选** —— 缺失时工具返回里省略该字段（人类 picker / 旧调用点不受影响）。
+     * 镜像 `ColumnMetadata.description`，把非列宿主的「一句话何时用我」补齐。
+     */
+    description?: string;
     w: BlockSizeRange;
     h: BlockSizeRange;
     /**
@@ -65,6 +72,10 @@ export type BlockEntry = Readonly<{
     defaultBody: () => Record<string, unknown>;
     config: Component;
     runtime: Component;
+    /** Recursion edges the AI scope cursor walks (empty for leaf blocks). */
+    edges: ReadonlyArray<RegistryEdge>;
+    /** The block's `prompt.md` (L2 fragment) raw text, when authored. */
+    prompt?: string;
 }>;
 export declare const BLOCKS: ReadonlyArray<BlockEntry>;
 /**
@@ -74,4 +85,12 @@ export declare const BLOCKS: ReadonlyArray<BlockEntry>;
 export declare function blockRef(configure: (env: Environment) => void): AnySchema;
 export declare function allBlockSchemas(configure: (env: Environment) => void): ReadonlyArray<AnySchema>;
 export declare function findBlock(type: string, compatibilityDate: string): BlockEntry | undefined;
+export declare function latestBlockByType(): ReadonlyArray<BlockEntry>;
+/**
+ * AI 工具可见的块集合：按 `type` 取最新 `compatibilityDate`。镜像
+ * `activeColumns()` / `activeFields()`；块目前没有 deprecation 机制（无
+ * `migrateFrom` / 废弃标记），所以「最新版本」即活跃集，无第二层过滤。人类
+ * picker 走 `BLOCKS`（`pickerEntries` 已自行 dedupe）。
+ */
+export declare function activeBlocks(): ReadonlyArray<BlockEntry>;
 export {};

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

@@ -13,12 +13,22 @@ const runtimeModules = import.meta.glob(
   "../blocks/*/*/runtime.vue",
   { eager: true, import: "default", exhaustive: true }
 );
+const promptModules = import.meta.glob(
+  "../blocks/*/*/prompt.md",
+  { eager: true, query: "?raw", import: "default", exhaustive: true }
+);
 const registry = defineRegistry({
   hostName: "shwfed-config",
   dirSegment: "blocks",
   schemaModules,
   configModules,
-  runtimeModules
+  runtimeModules,
+  promptModules,
+  // Build each edge-declaring block's schema with inert args (no-op configure,
+  // a stand-in `blockRef`) purely to verify each declared edge `key` is a real
+  // top-level field. Only invoked for blocks that declare `edges`.
+  buildSchemaForEdges: (mod) => mod.schema(() => {
+  }, Schema.Unknown)
 });
 export const BLOCKS = registry.ENTRIES.map((e) => ({
   type: e.type,
@@ -27,7 +37,9 @@ export const BLOCKS = registry.ENTRIES.map((e) => ({
   schema: e.module.schema,
   defaultBody: e.module.defaultBody,
   config: e.config,
-  runtime: e.runtime
+  runtime: e.runtime,
+  edges: e.module.edges ?? [],
+  ...e.prompt !== void 0 ? { prompt: e.prompt } : {}
 }));
 const unionCache = /* @__PURE__ */ new WeakMap();
 function getOrBuildUnion(configure) {
@@ -61,4 +73,15 @@ export function allBlockSchemas(configure) {
 export function findBlock(type, compatibilityDate) {
   return BLOCKS.find((b) => b.type === type && b.compatibilityDate === compatibilityDate);
 }
+export function latestBlockByType() {
+  const byType = /* @__PURE__ */ new Map();
+  for (const b of BLOCKS) {
+    const prev = byType.get(b.type);
+    if (!prev || b.compatibilityDate > prev.compatibilityDate) byType.set(b.type, b);
+  }
+  return [...byType.values()];
+}
+export function activeBlocks() {
+  return latestBlockByType();
+}
 registerFindBlock(findBlock);

package/dist/runtime/components/form/ai-l1.md

@@ -0,0 +1,22 @@
+你正在配置一个「表单块」内嵌的 Form。表单 = 一组字段 + 网格布局。发现式推进：`list_available_field_types` → `describe_specific_field_type` 看清字段类型与契约，再增改；配完 `leave_node` 返回页面。
+
+## 字段
+
+- 用 `list_available_field_types`（一句话目录）→ `describe_specific_field_type`（完整字段契约 + 默认值 + 默认尺寸 `w`/`h` + 可能的 `guide`）选型。
+- `insert_field` 新增（**不要**传 `id` / `compatibilityDate`，harness 分配）。字段创建后处于「未放置」态，不会渲染，直到 `place_field` 放入布局。
+- `list_fields` 查看现有字段与放置，`delete_fields` 删除。
+
+## 绑定与取值
+
+- 多数字段有 `binding`：字段值写入表单数据的键；同一表单里 `binding` 应唯一。
+- 字段间引用用 CEL 变量 `form`（如 `form.startDate`）——先 `describe_form_settings` 查看该表单可用的 CEL 变量表与函数目录，再书写。
+- 需要根据其它字段动态显示 / 计算时，用字段自带的可见性 / 默认值 / 派生表达式（见 `describe_specific_field_type` 的字段契约）。
+
+## 布局
+
+- `place_field` 用 `w.initial` / `h.initial`（来自 describe）作为放置尺寸的宽高；`min`/`max` 界定可调范围。
+- `area` 为 `[[x1,y1],[x2,y2]]`（1 基网格线，右下不含）。放置不要重叠，harness 会拒绝重叠并让你重试；列数会自动生长以容纳放置。
+
+## 校验
+
+字段可带校验规则（必填、格式、范围等），随字段契约暴露。按业务需要设置必填与格式约束；不确定的规则**向用户确认**，不要臆造。

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.markdown/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-22";
 export declare const metadata: {
     readonly name: "Markdown";
     readonly icon: "fluent:markdown-20-regular";
+    readonly description: "展示一段本地化 Markdown 文本（仅展示，不收集输入）";
     readonly w: {
         readonly initial: 8;
         readonly min: 2;

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.markdown/schema.js

@@ -6,6 +6,7 @@ export const compatibilityDate = "2026-04-22";
 export const metadata = {
   name: "Markdown",
   icon: "fluent:markdown-20-regular",
+  description: "\u5C55\u793A\u4E00\u6BB5\u672C\u5730\u5316 Markdown \u6587\u672C\uFF08\u4EC5\u5C55\u793A\uFF0C\u4E0D\u6536\u96C6\u8F93\u5165\uFF09",
   w: { initial: 8, min: 2, max: Infinity },
   h: { initial: 2, min: 2, max: Infinity, grow: true }
 };

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.text/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-22";
 export declare const metadata: {
     readonly name: "文本输入";
     readonly icon: "fluent:text-field-20-regular";
+    readonly description: "单行文本输入";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.text/schema.js

@@ -19,6 +19,7 @@ export const compatibilityDate = "2026-04-22";
 export const metadata = {
   name: "\u6587\u672C\u8F93\u5165",
   icon: "fluent:text-field-20-regular",
+  description: "\u5355\u884C\u6587\u672C\u8F93\u5165",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-22";
 export declare const metadata: {
     readonly name: "多行文本输入";
     readonly icon: "fluent:text-description-20-regular";
+    readonly description: "多行文本输入";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-04-22";
 export const metadata = {
   name: "\u591A\u884C\u6587\u672C\u8F93\u5165",
   icon: "fluent:text-description-20-regular",
+  description: "\u591A\u884C\u6587\u672C\u8F93\u5165",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 3, min: 2, max: Infinity, grow: true }
 };

package/dist/runtime/components/form/fields/2026-04-24/com.shwfed.form.field.actions/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.actions";
 export declare const compatibilityDate: "2026-04-24";
+export declare const edges: readonly [{
+    readonly key: "items";
+    readonly host: "actions";
+    readonly label: "操作按钮";
+    readonly self: true;
+}];
 export declare const metadata: {
     readonly name: "操作";
     readonly icon: "fluent:cursor-click-20-regular";
+    readonly description: "渲染一组操作按钮（仅展示，不参与表单提交）";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-24/com.shwfed.form.field.actions/schema.js

@@ -3,9 +3,13 @@ import { ActionSchemaFields } from "../../../../actions/schema.js";
 import { commonFieldFields } from "../../../utils/common.js";
 export const type = "com.shwfed.form.field.actions";
 export const compatibilityDate = "2026-04-24";
+export const edges = [
+  { key: "items", host: "actions", label: "\u64CD\u4F5C\u6309\u94AE", self: true }
+];
 export const metadata = {
   name: "\u64CD\u4F5C",
   icon: "fluent:cursor-click-20-regular",
+  description: "\u6E32\u67D3\u4E00\u7EC4\u64CD\u4F5C\u6309\u94AE\uFF08\u4EC5\u5C55\u793A\uFF0C\u4E0D\u53C2\u4E0E\u8868\u5355\u63D0\u4EA4\uFF09",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: Infinity },
   // Drills into its own nested button layout editor — too complex for the

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.date/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-27";
 export declare const metadata: {
     readonly name: "日期";
     readonly icon: "fluent:calendar-ltr-20-regular";
+    readonly description: "选择一个日期";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.date/schema.js

@@ -8,6 +8,7 @@ export const compatibilityDate = "2026-04-27";
 export const metadata = {
   name: "\u65E5\u671F",
   icon: "fluent:calendar-ltr-20-regular",
+  description: "\u9009\u62E9\u4E00\u4E2A\u65E5\u671F",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.daterange/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-27";
 export declare const metadata: {
     readonly name: "日期范围";
     readonly icon: "fluent:calendar-arrow-right-20-regular";
+    readonly description: "选择一个日期区间";
     readonly w: {
         readonly initial: 10;
         readonly min: 10;

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.daterange/schema.js

@@ -18,6 +18,7 @@ const bindingSchema = Schema.Union(BindingPath, SplitBinding).annotations({
 export const metadata = {
   name: "\u65E5\u671F\u8303\u56F4",
   icon: "fluent:calendar-arrow-right-20-regular",
+  description: "\u9009\u62E9\u4E00\u4E2A\u65E5\u671F\u533A\u95F4",
   w: { initial: 10, min: 10, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetime/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-27";
 export declare const metadata: {
     readonly name: "日期时间";
     readonly icon: "fluent:calendar-clock-20-regular";
+    readonly description: "选择一个日期时间";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetime/schema.js

@@ -8,6 +8,7 @@ export const compatibilityDate = "2026-04-27";
 export const metadata = {
   name: "\u65E5\u671F\u65F6\u95F4",
   icon: "fluent:calendar-clock-20-regular",
+  description: "\u9009\u62E9\u4E00\u4E2A\u65E5\u671F\u65F6\u95F4",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetimerange/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-27";
 export declare const metadata: {
     readonly name: "日期时间范围";
     readonly icon: "fluent:calendar-clock-20-regular";
+    readonly description: "选择一个日期时间区间";
     readonly w: {
         readonly initial: 14;
         readonly min: 14;

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetimerange/schema.js

@@ -18,6 +18,7 @@ const bindingSchema = Schema.Union(BindingPath, SplitBinding).annotations({
 export const metadata = {
   name: "\u65E5\u671F\u65F6\u95F4\u8303\u56F4",
   icon: "fluent:calendar-clock-20-regular",
+  description: "\u9009\u62E9\u4E00\u4E2A\u65E5\u671F\u65F6\u95F4\u533A\u95F4",
   w: { initial: 14, min: 14, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.time/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-27";
 export declare const metadata: {
     readonly name: "时间";
     readonly icon: "fluent:clock-20-regular";
+    readonly description: "选择一个时间";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.time/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-04-27";
 export const metadata = {
   name: "\u65F6\u95F4",
   icon: "fluent:clock-20-regular",
+  description: "\u9009\u62E9\u4E00\u4E2A\u65F6\u95F4",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.timerange/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-27";
 export declare const metadata: {
     readonly name: "时间范围";
     readonly icon: "fluent:clock-arrow-download-20-regular";
+    readonly description: "选择一个时间区间";
     readonly w: {
         readonly initial: 14;
         readonly min: 14;

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.timerange/schema.js

@@ -17,6 +17,7 @@ const bindingSchema = Schema.Union(BindingPath, SplitBinding).annotations({
 export const metadata = {
   name: "\u65F6\u95F4\u8303\u56F4",
   icon: "fluent:clock-arrow-download-20-regular",
+  description: "\u9009\u62E9\u4E00\u4E2A\u65F6\u95F4\u533A\u95F4",
   w: { initial: 14, min: 14, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.number/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-28";
 export declare const metadata: {
     readonly name: "数值输入";
     readonly icon: "fluent:number-symbol-20-regular";
+    readonly description: "数值输入";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.number/schema.js

@@ -19,6 +19,7 @@ export const compatibilityDate = "2026-04-28";
 export const metadata = {
   name: "\u6570\u503C\u8F93\u5165",
   icon: "fluent:number-symbol-20-regular",
+  description: "\u6570\u503C\u8F93\u5165",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.numberrange/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-28";
 export declare const metadata: {
     readonly name: "数值范围";
     readonly icon: "fluent:arrow-bidirectional-left-right-20-regular";
+    readonly description: "数值区间输入";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.numberrange/schema.js

@@ -17,6 +17,7 @@ const bindingSchema = Schema.Union(BindingPath, SplitBinding).annotations({
 export const metadata = {
   name: "\u6570\u503C\u8303\u56F4",
   icon: "fluent:arrow-bidirectional-left-right-20-regular",
+  description: "\u6570\u503C\u533A\u95F4\u8F93\u5165",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.switch/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-28";
 export declare const metadata: {
     readonly name: "开关";
     readonly icon: "fluent:toggle-left-20-regular";
+    readonly description: "布尔开关";
     readonly w: {
         readonly initial: 4;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-04-28/com.shwfed.form.field.switch/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-04-28";
 export const metadata = {
   name: "\u5F00\u5173",
   icon: "fluent:toggle-left-20-regular",
+  description: "\u5E03\u5C14\u5F00\u5173",
   w: { initial: 4, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-05-13/com.shwfed.form.field.combobox.single.remote/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-05-13";
 export declare const metadata: {
     readonly name: "下拉单选（远程）";
     readonly icon: "fluent:cloud-arrow-down-20-regular";
+    readonly description: "下拉单选，选项从远端接口按输入搜索加载";
     readonly w: {
         readonly initial: 8;
         readonly min: 4;

package/dist/runtime/components/form/fields/2026-05-13/com.shwfed.form.field.combobox.single.remote/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-05-13";
 export const metadata = {
   name: "\u4E0B\u62C9\u5355\u9009\uFF08\u8FDC\u7A0B\uFF09",
   icon: "fluent:cloud-arrow-down-20-regular",
+  description: "\u4E0B\u62C9\u5355\u9009\uFF0C\u9009\u9879\u4ECE\u8FDC\u7AEF\u63A5\u53E3\u6309\u8F93\u5165\u641C\u7D22\u52A0\u8F7D",
   w: { initial: 8, min: 4, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

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

@@ -0,0 +1,8 @@
+## 列表字段
+
+可新增 / 删除 / 重排的同构子表单列表：`unit` 定义**每一行**的字段与布局（enter_node 进入后用表单字段工具族配置），`binding` 存整个列表（行对象数组）。
+
+- unit 里字段的 CEL（默认值 / 隐藏 / 校验等）额外可用 `item`（当前行对象）与 `index`（行序号，0 起）——引用兄弟字段写 `item.<绑定路径>` 而不是 `form.<...>`。
+- `locale`（列表项摘要）配置后行可折叠，折叠时渲染该行内 Markdown 摘要，插值同样可用 `item` / `index` / `form`。
+- 关闭 `addable` 后新增交给外部按钮：用「写入表单状态」按钮向绑定路径追加，如 `form.<路径> + [{}]`。
+- `min` / `max` 约束行数；`reorderable` 控制能否上下移动。

package/dist/runtime/components/form/fields/2026-05-13/com.shwfed.form.field.list/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.list";
 export declare const compatibilityDate: "2026-05-13";
+export declare const edges: readonly [{
+    readonly key: "unit";
+    readonly host: "form";
+    readonly label: "列表项配置";
+    readonly celScope: "loop-item";
+}];
 export declare const metadata: {
     readonly name: "列表";
     readonly icon: "fluent:list-20-regular";
+    readonly description: "可新增 / 删除 / 重排的同构子表单列表";
     readonly w: {
         readonly initial: 12;
         readonly min: 4;

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

@@ -5,9 +5,13 @@ import { FormUnit } from "../../../schema.js";
 import { commonFieldFields } from "../../../utils/common.js";
 export const type = "com.shwfed.form.field.list";
 export const compatibilityDate = "2026-05-13";
+export const edges = [
+  { key: "unit", host: "form", label: "\u5217\u8868\u9879\u914D\u7F6E", celScope: "loop-item" }
+];
 export const metadata = {
   name: "\u5217\u8868",
   icon: "fluent:list-20-regular",
+  description: "\u53EF\u65B0\u589E / \u5220\u9664 / \u91CD\u6392\u7684\u540C\u6784\u5B50\u8868\u5355\u5217\u8868",
   w: { initial: 12, min: 4, max: Infinity },
   h: { initial: 6, min: 4, max: Infinity, grow: true },
   // Hosts a nested sub-form (its own fields + layout) — too complex for the

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.checkbox.group/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-05-17";
 export declare const metadata: {
     readonly name: "复选框组";
     readonly icon: "fluent:checkbox-checked-20-regular";
+    readonly description: "从一组选项中多选（复选框组）";
     readonly w: {
         readonly initial: 8;
         readonly min: 2;

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.checkbox.group/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-05-17";
 export const metadata = {
   name: "\u590D\u9009\u6846\u7EC4",
   icon: "fluent:checkbox-checked-20-regular",
+  description: "\u4ECE\u4E00\u7EC4\u9009\u9879\u4E2D\u591A\u9009\uFF08\u590D\u9009\u6846\u7EC4\uFF09",
   w: { initial: 8, min: 2, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.radio.group/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-05-17";
 export declare const metadata: {
     readonly name: "单选框组";
     readonly icon: "fluent:radio-button-20-regular";
+    readonly description: "从一组选项中单选（单选框组）";
     readonly w: {
         readonly initial: 8;
         readonly min: 2;

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.radio.group/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-05-17";
 export const metadata = {
   name: "\u5355\u9009\u6846\u7EC4",
   icon: "fluent:radio-button-20-regular",
+  description: "\u4ECE\u4E00\u7EC4\u9009\u9879\u4E2D\u5355\u9009\uFF08\u5355\u9009\u6846\u7EC4\uFF09",
   w: { initial: 8, min: 2, max: Infinity },
   h: { initial: 2, min: 2, max: 2 }
 };

package/dist/runtime/components/form/fields/2026-05-18/com.shwfed.form.field.table/prompt.md

@@ -0,0 +1,12 @@
+**何时用我**：在表单里嵌入一个**可本地编辑的表格**（明细行、子项列表），其行数据实时读写表单状态的某个路径。适合「主表单 + 一组可增删改的明细」。
+
+**配置配方**
+
+- `binding`：表格行数据在表单状态里的 dot-prop 路径（如 `rows`）。表格从 `form.<binding>` 读取行、本地增删改实时写回**同一路径**。留空则表格无数据、行编辑不持久化。
+- `table`：内嵌表格的完整配置。**数据源自动绑定到 `form.<binding>`，无需单独配置 `dataSource`**——不要给它配 request / data，行数据来自表单本身。
+- 其余就是一张普通表格：用列工具配列（文本 / 数值 / 日期 / 可编辑列等）。
+
+**坑**
+
+- 别给内嵌表配数据源；行数据来自 `form.<binding>`，配了 `dataSource` 会与表单的 `initial` 抢喋。
+- 这是嵌套的表格宿主：`describe_specific_field_type` 里 `table` 字段是一整份 TableConfig，配列请像配普通表格那样思考（在当前实现中，字段内嵌表格的深层列配置尚需在编辑器画布内微调）。

package/dist/runtime/components/form/fields/2026-05-18/com.shwfed.form.field.table/schema.d.ts

@@ -2,9 +2,15 @@ import { Schema } from 'effect';
 import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
 export declare const type: "com.shwfed.form.field.table";
 export declare const compatibilityDate: "2026-05-18";
+export declare const edges: readonly [{
+    readonly key: "table";
+    readonly host: "table";
+    readonly label: "表格配置";
+}];
 export declare const metadata: {
     readonly name: "表格";
     readonly icon: "fluent:table-20-regular";
+    readonly description: "内嵌一个可本地编辑的表格，其数据写入绑定路径";
     readonly w: {
         readonly initial: 12;
         readonly min: 6;