@shwfed/config 3.0.6 → 3.0.8

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

@@ -36,15 +36,15 @@ 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 nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
@@ -94,15 +94,15 @@ 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 nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;

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

@@ -36,15 +36,15 @@ 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 nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
@@ -94,15 +94,15 @@ 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 nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: 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" };
 }
@@ -610,14 +604,14 @@ async function copyColumns() {
   const set = pickedColumnIdSet.value;
   const cols = orderedColumnIds.value.filter((id) => set.has(id)).map((id) => editingColumns.value.find((c) => c.id === id)).filter((c) => !!c).map(({ groupId: _g, ...rest }) => rest);
   if (cols.length === 0) return;
-  const ok = await writeClip("table", cols);
+  const ok = await writeClip("table", { items: cols });
   if (ok) toast.success(`\u5DF2\u590D\u5236 ${cols.length} \u5217`);
   else toast.error("\u590D\u5236\u5931\u8D25");
 }
 async function pasteColumns() {
   const clip = await readClip();
   if (!clip || clip.surface !== "table") return;
-  const { items } = reidFragment(clip.items);
+  const { items } = reidFragment(clip);
   const pasted = items.map(({ groupId: _g, ...rest }) => rest);
   if (pasted.length === 0) return;
   editingColumns.value = [...editingColumns.value, ...pasted];
@@ -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,23 +141,6 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
     readonly displayName?: string | undefined;
     readonly columns: readonly any[];
     readonly kind: "shwfed.component.table";
-    readonly groups: readonly {
-        readonly id: string;
-        readonly title?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly tooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-    }[];
     readonly query?: {
         readonly style?: string | undefined;
         readonly id?: string | undefined;
@@ -187,11 +170,23 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
         }[];
         readonly readonly?: string | undefined;
     } | undefined;
-    readonly dataSource?: {
-        readonly data: string;
-        readonly total?: string | undefined;
-        readonly request?: string | undefined;
-    } | undefined;
+    readonly groups: readonly {
+        readonly id: string;
+        readonly title?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly tooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+    }[];
     readonly actions?: {
         readonly size: "default" | "sm" | "xs";
         readonly style?: string | undefined;
@@ -259,6 +254,11 @@ export declare function TableConfig(configure: (env: Environment) => void): Sche
             readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
         }[];
     } | undefined;
+    readonly dataSource?: {
+        readonly data: string;
+        readonly total?: string | undefined;
+        readonly request?: string | undefined;
+    } | undefined;
     readonly bottomActions?: {
         readonly size: "default" | "sm" | "xs";
         readonly style?: string | undefined;
@@ -810,23 +810,6 @@ export declare function createTableConfig(body: Omit<Schema.Schema.Type<ReturnTy
     id?: string | undefined;
     displayName?: string | undefined;
     columns: readonly any[];
-    groups: readonly {
-        readonly id: string;
-        readonly title?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-        readonly tooltip?: readonly [{
-            readonly locale: "zh";
-            readonly message: string;
-        }, ...{
-            readonly locale: "en" | "ja" | "ko";
-            readonly message: string;
-        }[]] | undefined;
-    }[];
     query?: {
         readonly style?: string | undefined;
         readonly id?: string | undefined;
@@ -856,11 +839,23 @@ export declare function createTableConfig(body: Omit<Schema.Schema.Type<ReturnTy
         }[];
         readonly readonly?: string | undefined;
     } | undefined;
-    dataSource?: {
-        readonly data: string;
-        readonly total?: string | undefined;
-        readonly request?: string | undefined;
-    } | undefined;
+    groups: readonly {
+        readonly id: string;
+        readonly title?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly tooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+    }[];
     actions?: {
         readonly size: "default" | "sm" | "xs";
         readonly style?: string | undefined;
@@ -928,6 +923,11 @@ export declare function createTableConfig(body: Omit<Schema.Schema.Type<ReturnTy
             readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
         }[];
     } | undefined;
+    dataSource?: {
+        readonly data: string;
+        readonly total?: string | undefined;
+        readonly request?: string | undefined;
+    } | undefined;
     bottomActions?: {
         readonly size: "default" | "sm" | "xs";
         readonly style?: 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
   ];
 }

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

@@ -3,6 +3,7 @@ import type { Schema, Effect } from 'effect';
 import type { ColumnDef } from '@tanstack/vue-table';
 import type { Environment } from '../../../vendor/cel-js/lib/index.js';
 import type { LocaleValue } from '../../../share/locale.js';
+import { type RegistryEdge } from '../../../share/define-registry.js';
 import type { ColumnValue } from '../schema.js';
 type CelEvaluator = <T>(expression: string, context?: Record<string, unknown>) => Effect.Effect<T, any>;
 type AnySchema = Schema.Schema<any, any, never>;
@@ -159,6 +160,10 @@ export type ColumnEntry = Readonly<{
      * `enableRowSelection`. See `ColumnRowSelection`.
      */
     rowSelection?: ColumnRowSelection;
+    /** The column's `prompt.md` (L2 fragment) raw text, surfaced by the AI describe tool. */
+    prompt?: string;
+    /** Recursion edges the AI scope cursor walks (empty for leaf columns). */
+    edges: ReadonlyArray<RegistryEdge>;
 }>;
 export declare const COLUMNS: ReadonlyArray<ColumnEntry>;
 export declare function allColumnSchemas(configure: (env: Environment) => void): ReadonlyArray<AnySchema>;

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

@@ -11,6 +11,10 @@ const runtimeModules = import.meta.glob(
   "../columns/*/*/runtime.vue",
   { eager: true, import: "default", exhaustive: true }
 );
+const promptModules = import.meta.glob(
+  "../columns/*/*/prompt.md",
+  { eager: true, query: "?raw", import: "default", exhaustive: true }
+);
 const sourceKey = (type, compatibilityDate) => `${type}@${compatibilityDate}`;
 const registry = defineRegistry({
   hostName: "shwfed-table",
@@ -18,6 +22,7 @@ const registry = defineRegistry({
   schemaModules,
   configModules,
   runtimeModules,
+  promptModules,
   validateModule: (mod, type, date) => {
     const hasToColumnDef = typeof mod.toColumnDef === "function";
     const hasExpand = typeof mod.expand === "function";
@@ -30,6 +35,10 @@ const registry = defineRegistry({
   // Generator (`expand`) entries have no cell renderer, so they need no
   // sibling `runtime.vue`. Every other column keeps requiring one.
   runtimeOptional: (mod) => typeof mod.expand === "function",
+  // Validate declared `edges` keys against the built schema (only column.actions
+  // declares one today). Inert configure — the edge check only reads field names.
+  buildSchemaForEdges: (mod) => mod.schema(() => {
+  }),
   // Deprecation rules mirror the form host:
   //   (a) date-versioned: another entry shares this entry's `type` with a
   //       strictly greater `compatibilityDate`;
@@ -80,13 +89,15 @@ export const COLUMNS = registry.ENTRIES.map((e) => ({
   config: e.config,
   runtime: e.runtime,
   toColumnDef: e.module.toColumnDef,
+  edges: e.module.edges ?? [],
   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.defaults !== void 0 ? { defaults: e.module.defaults } : {},
   ...e.module.expand !== void 0 ? { expand: e.module.expand } : {},
-  ...e.module.rowSelection !== void 0 ? { rowSelection: e.module.rowSelection } : {}
+  ...e.module.rowSelection !== void 0 ? { rowSelection: e.module.rowSelection } : {},
+  ...e.prompt !== void 0 ? { prompt: e.prompt } : {}
 }));
 const migrationTargets = (() => {
   const map = /* @__PURE__ */ new Map();

package/dist/runtime/share/clipboard.d.ts

@@ -1,8 +1,11 @@
-export type ClipSurface = 'form' | 'block' | 'table';
-export type ClipPayload = Readonly<{
-    surface: ClipSurface;
+export type ClipSurface = 'form' | 'block' | 'table' | 'actions';
+export type ClipFragment = Readonly<{
     items: ReadonlyArray<unknown>;
     placements?: Readonly<Record<string, unknown>>;
+    groups?: ReadonlyArray<unknown>;
+}>;
+export type ClipPayload = ClipFragment & Readonly<{
+    surface: ClipSurface;
 }>;
 /**
  * Deep-clone the fragment with every id (and every reference to a copied id)
@@ -11,16 +14,19 @@ export type ClipPayload = Readonly<{
  */
 export declare function reidItems<T>(items: ReadonlyArray<T>): T[];
 /**
- * Reid items and their placements through one shared map, so the placement keys
- * (which are item ids) and the items' own `id`s land on the same fresh UUIDs.
+ * Reid a whole fragment through one shared map, so every id definition and every
+ * reference to one lands on the same fresh UUID: the placement keys (which are
+ * item ids), an action item's `groupId` and the group's own `id`, and the items'
+ * own `id`s all stay wired to each other.
  */
-export declare function reidFragment<T>(items: ReadonlyArray<T>, placements?: Readonly<Record<string, unknown>>): {
-    items: T[];
+export declare function reidFragment(fragment: ClipFragment): {
+    items: unknown[];
     placements?: Record<string, unknown>;
+    groups?: unknown[];
 };
-export declare function serializeClip(surface: ClipSurface, items: ReadonlyArray<unknown>, placements?: Readonly<Record<string, unknown>>): string;
+export declare function serializeClip(surface: ClipSurface, fragment: ClipFragment): string;
 export declare function parseClip(text: string): ClipPayload | null;
 /** Write a fragment to the system clipboard. Resolves `false` on any failure. */
-export declare function writeClip(surface: ClipSurface, items: ReadonlyArray<unknown>, placements?: Readonly<Record<string, unknown>>): Promise<boolean>;
+export declare function writeClip(surface: ClipSurface, fragment: ClipFragment): Promise<boolean>;
 /** Read a fragment from the system clipboard, or `null` if absent/unreadable. */
 export declare function readClip(): Promise<ClipPayload | null>;