@shwfed/config 2.0.3 → 2.1.1

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

@@ -0,0 +1,44 @@
+import { Schema } from "effect";
+import { Locale } from "../../../../../share/locale.js";
+import { TableConfig, defaultTableConfig } from "../../../../table/schema.js";
+import { commonFieldFields } from "../../../utils/common.js";
+export const type = "com.shwfed.form.field.table";
+export const compatibilityDate = "2026-05-18";
+export const metadata = {
+  name: "\u8868\u683C",
+  icon: "fluent:table-20-regular",
+  w: { initial: 12, min: 6, max: Infinity },
+  h: { initial: 10, min: 5, max: Infinity, grow: true }
+};
+export function schema(configure) {
+  const Table = Schema.suspend(
+    () => TableConfig(configure)
+  );
+  return Schema.Struct({
+    type: Schema.Literal(type),
+    compatibilityDate: Schema.Literal(compatibilityDate),
+    ...commonFieldFields(configure),
+    label: Schema.optional(Locale.annotations({
+      title: "\u6807\u7B7E",
+      description: "\u8868\u683C\u4E0A\u65B9\u5C55\u793A\u7684\u6587\u672C\uFF1B\u7559\u7A7A\u5219\u4E0D\u6E32\u67D3\u6807\u7B7E"
+    })),
+    tooltip: Schema.optional(Locale.annotations({
+      title: "\u63D0\u793A",
+      description: "\u9F20\u6807\u60AC\u505C\u5728\u6807\u7B7E\u4E0A\u65F6\u5C55\u793A\u7684\u8BF4\u660E\uFF0C\u652F\u6301 Markdown"
+    })),
+    binding: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
+      title: "\u7ED1\u5B9A\u8DEF\u5F84",
+      description: "\u8868\u683C\u5F53\u524D\u6570\u636E\u5B9E\u65F6\u5199\u5165\u8868\u5355\u72B6\u6001\u7684 `dot-prop` \u8DEF\u5F84\uFF0C\u4F8B\u5982 `rows`\uFF1B\u7559\u7A7A\u5219\u4E0D\u5199\u5165\u8868\u5355\u72B6\u6001"
+    })),
+    table: Table.annotations({
+      title: "\u8868\u683C\u914D\u7F6E",
+      description: "\u5185\u5D4C\u8868\u683C\u7684\u5B8C\u6574\u914D\u7F6E\uFF1B\u6570\u636E\u7531\u8868\u683C\u81EA\u5DF1\u7684\u6570\u636E\u6E90\u52A0\u8F7D\uFF0C\u7528\u6237\u7684\u672C\u5730\u589E\u5220\u6539\u5B9E\u65F6\u56DE\u5199\u5230\u300C\u7ED1\u5B9A\u8DEF\u5F84\u300D"
+    })
+  }).annotations({
+    title: "TableField",
+    description: "\u628A\u4E00\u4E2A\u53EF\u672C\u5730\u7F16\u8F91\u7684\u8868\u683C\u5D4C\u5165\u8868\u5355\uFF0C\u5176\u5B9E\u65F6\u6570\u636E\u5199\u5165\u7ED1\u5B9A\u8DEF\u5F84"
+  });
+}
+export function defaults() {
+  return { table: defaultTableConfig() };
+}

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

@@ -167,15 +167,16 @@ const gridStyle = computed(() => {
       const hi = Math.min(l.rows, y2 - 1);
       for (let r = lo; r <= hi; r++) grows[r - 1] = true;
     }
-    rowTemplate = grows.map((g) => g ? "auto" : "minmax(0, 1fr)").join(" ");
+    rowTemplate = grows.map((g) => g ? "auto" : "minmax(auto, 1fr)").join(" ");
   }
+  const gap = `calc(${l.gap ?? DEFAULT_GAP} * 0.25rem)`;
+  const colGap = l.columns > 1 ? `min(${gap}, calc(100% / ${l.columns - 1}))` : gap;
   const parts = [
     "display: grid",
     `grid-template-columns: ${colTemplate}`,
     rowTemplate ? `grid-template-rows: ${rowTemplate}` : "",
-    // A missing `gap` resolves to `DEFAULT_GAP`, not 0 — same fallback the
-    // layout editor shows, so editor and render agree. `gap: 0` stays 0.
-    `gap: calc(${l.gap ?? DEFAULT_GAP} * 0.25rem)`,
+    `column-gap: ${colGap}`,
+    `row-gap: ${gap}`,
     l.style ?? ""
   ].filter(Boolean);
   return parts.join("; ");

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

@@ -68,6 +68,16 @@ export declare function FormUnit(configure: (env: Environment) => void): Schema.
         }>;
     }>>>;
 }>>;
+/**
+ * Register the form-wide `now` / `form` live variables on `env`, skipping any
+ * already declared. Idempotent so it composes safely from either side: a
+ * `FormConfig` nested inside another (the `table` form field embeds a table
+ * whose `query` is its own sub-form, and the embedding `configure` advertises
+ * the same pair) would otherwise register `form` twice on one env and the CEL
+ * registry throws `'form' is already registered`. Mirrors
+ * `registerRowVariablesIfAbsent`.
+ */
+export declare function registerFormVariablesIfAbsent(env: Environment): void;
 export declare function FormConfig(configure: (env: Environment) => void): Schema.refine<{
     readonly initial?: string | undefined;
     readonly kind: "shwfed.component.form";

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

@@ -37,10 +37,14 @@ export function FormUnit(configure) {
     description: "\u4E00\u7EC4\u8868\u5355\u5B57\u6BB5\u53CA\u5176\u5E03\u5C40"
   });
 }
+export function registerFormVariablesIfAbsent(env) {
+  const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
+  if (!declared.has("now")) env.registerVariable("now", "Date", { description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4" });
+  if (!declared.has("form")) env.registerVariable("form", "dyn", { description: "\u5F53\u524D\u8868\u5355\u72B6\u6001" });
+}
 export function FormConfig(configure) {
   const formConfigure = (env) => {
-    env.registerVariable("now", "Date", { description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4" });
-    env.registerVariable("form", "dyn", { description: "\u5F53\u524D\u8868\u5355\u72B6\u6001" });
+    registerFormVariablesIfAbsent(env);
     configure(env);
   };
   const CelFormInitial = Expression({ configure: formConfigure, resultType: "dyn" });

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

@@ -1,4 +1,6 @@
+import { type CELContext } from '../../utils/cel-context.js';
 import type { FieldValue, FormUnitValue } from './schema.js';
+import type { Environment } from '../../vendor/cel-js/lib/index.js';
 export type UnitExtra = {
     id: string;
     label: string;
@@ -17,6 +19,20 @@ type __VLS_Props = {
      * v-model — hosts read which extra is active via `selection.value`.
      */
     extras?: ReadonlyArray<UnitExtra>;
+    /**
+     * Host-registered CEL variables. Forwarded to the drilled field-list's
+     * "AI 生成字段" button so the model can advertise host variables in
+     * generated expressions. Absent → only `form` / `now` are in scope.
+     */
+    configure?: (env: Environment) => void;
+    /**
+     * Extra CEL variables in scope for the unit's *field* editors — the list
+     * field passes `item` (the current row). Advertised to every drilled field
+     * config's ExpressionEditor via `provideCELContext` below; the host's own
+     * `extras-pane` slot is excluded, since slotted content injects through the
+     * host component, above this provide.
+     */
+    fieldCelScope?: CELContext;
 };
 type __VLS_Slots = {
     /** Pane content for the currently-selected extra. Receives `{ id }`. */

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

@@ -6,7 +6,8 @@ import { computed, inject, onBeforeUnmount, provide, ref, useTemplateRef, watch
 import { toast } from "vue-sonner";
 import {
   celBindings,
-  injectCELContext
+  injectCELContext,
+  provideCELContext
 } from "../../utils/cel-context";
 import { findFreePlacement, normalizeLayoutSet } from "../../share/layout";
 import { getLocalizedText } from "../../share/locale";
@@ -20,13 +21,16 @@ import { Button } from "../ui/button";
 import { ScrollArea } from "../ui/scroll-area";
 import { Separator } from "../ui/separator";
 import { FIELDS, findField } from "./utils/resolve";
+import ShwfedFormAiFieldsButton from "./ai/fields-button.vue";
 defineOptions({ name: "ShwfedFormUnitConfig" });
 const unit = defineModel({ type: Object, ...{ required: true } });
 const selection = defineModel("selection", { type: Object, ...{
   default: () => ({ kind: "layout" })
 } });
-defineProps({
-  extras: { type: Array, required: false }
+const props = defineProps({
+  extras: { type: Array, required: false },
+  configure: { type: Function, required: false },
+  fieldCelScope: { type: Object, required: false }
 });
 defineSlots();
 const activeLayoutIndex = ref(0);
@@ -40,6 +44,7 @@ function popOne() {
 const breadcrumbExt = inject(BREADCRUMB_EXTENSION_KEY, null);
 const fullPane = ref(false);
 provide(FORM_FIELD_LAYOUT_KEY, { fullPane });
+provideCELContext(props.fieldCelScope ?? {});
 const takeover = inject(SIDEBAR_TAKEOVER_KEY, null);
 const takeoverTarget = computed(() => takeover?.target.value ?? null);
 const activeFieldId = computed(() => {
@@ -171,6 +176,16 @@ function removeFields(ids) {
     stack.value = stack.value.slice(0, -1);
   }
 }
+function applyAiFields(generated) {
+  const valid = generated.filter(
+    (f) => !!findField(f.type, f.compatibilityDate)
+  );
+  if (valid.length === 0) return;
+  unit.value = {
+    ...unit.value,
+    fields: [...unit.value.fields, ...valid]
+  };
+}
 function updateActiveField(next) {
   const id = activeFieldId.value;
   if (!id) return;
@@ -311,6 +326,12 @@ function isExtraActive(id) {
           </button>
         </div>
       </ScrollArea>
+
+      <ShwfedFormAiFieldsButton
+        :configure="configure"
+        :fields="unit.fields"
+        @apply="applyAiFields"
+      />
     </template>
   </Teleport>
 
@@ -388,6 +409,12 @@ function isExtraActive(id) {
             </button>
           </div>
         </ScrollArea>
+
+        <ShwfedFormAiFieldsButton
+          :configure="configure"
+          :fields="unit.fields"
+          @apply="applyAiFields"
+        />
       </template>
     </div>
 

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

@@ -1,4 +1,6 @@
+import { type CELContext } from '../../utils/cel-context.js';
 import type { FieldValue, FormUnitValue } from './schema.js';
+import type { Environment } from '../../vendor/cel-js/lib/index.js';
 export type UnitExtra = {
     id: string;
     label: string;
@@ -17,6 +19,20 @@ type __VLS_Props = {
      * v-model — hosts read which extra is active via `selection.value`.
      */
     extras?: ReadonlyArray<UnitExtra>;
+    /**
+     * Host-registered CEL variables. Forwarded to the drilled field-list's
+     * "AI 生成字段" button so the model can advertise host variables in
+     * generated expressions. Absent → only `form` / `now` are in scope.
+     */
+    configure?: (env: Environment) => void;
+    /**
+     * Extra CEL variables in scope for the unit's *field* editors — the list
+     * field passes `item` (the current row). Advertised to every drilled field
+     * config's ExpressionEditor via `provideCELContext` below; the host's own
+     * `extras-pane` slot is excluded, since slotted content injects through the
+     * host component, above this provide.
+     */
+    fieldCelScope?: CELContext;
 };
 type __VLS_Slots = {
     /** Pane content for the currently-selected extra. Receives `{ id }`. */

package/dist/runtime/components/form/utils/cel-scope.d.ts

@@ -0,0 +1,13 @@
+import { Environment } from '../../../vendor/cel-js/lib/index.js';
+import type { CELContext } from '../../../utils/cel-context.js';
+/**
+ * Builds the CEL variable scope advertised to a form's expression editors and
+ * AI assists. Seeds the form-wide `form` / `now` live variables, then probes a
+ * throwaway `Environment` with the host's `configure` to surface any
+ * host-registered variables (their type / label / description).
+ *
+ * Values are left `undefined` — this scope is for designer-time advertising
+ * and prompt rendering, never evaluation. Extracted from `form/config.vue` so
+ * the field-list AI button can reuse the exact same scope.
+ */
+export declare function buildFormCelScope(configure: (env: Environment) => void): CELContext;

package/dist/runtime/components/form/utils/cel-scope.js

@@ -0,0 +1,32 @@
+import { Environment } from "../../../vendor/cel-js/lib/index.js";
+export function buildFormCelScope(configure) {
+  const probe = new Environment({ unlistedVariablesAreDyn: false });
+  const baseline = new Set(probe.getDefinitions().variables.map((v) => v.name));
+  configure(probe);
+  const out = {
+    form: {
+      type: "dyn",
+      label: "\u8868\u5355\u503C",
+      description: "\u5F53\u524D\u8868\u5355\u72B6\u6001",
+      value: void 0
+    },
+    // Mirrors the runtime `now` binding in `form/index.vue`. Editors and
+    // prompts never evaluate, so we leave `value` undefined.
+    now: {
+      type: "Date",
+      label: "now",
+      description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4",
+      value: void 0
+    }
+  };
+  for (const v of probe.getDefinitions().variables) {
+    if (baseline.has(v.name)) continue;
+    out[v.name] = {
+      type: v.type,
+      label: v.label ?? v.name,
+      description: v.description ?? void 0,
+      value: void 0
+    };
+  }
+  return out;
+}

package/dist/runtime/components/form/utils/schema-meta.d.ts

@@ -2,4 +2,17 @@ import { type Schema } from 'effect';
 type AnySchema = Schema.Schema<any, any, any>;
 export declare function getStructFieldTitle(schema: AnySchema, fieldName: string): string | undefined;
 export declare function getStructFieldDescription(schema: AnySchema, fieldName: string): string | undefined;
+export type StructFieldInfo = {
+    name: string;
+    title?: string;
+    description?: string;
+    optional: boolean;
+};
+/**
+ * Lists a struct schema's property signatures, pairing each with its `@title` /
+ * `@description` annotation and optionality. Used to auto-derive the per-field
+ * documentation surfaced to the AI field generator — a new field folder becomes
+ * discoverable with zero edits there. Returns `[]` for non-struct schemas.
+ */
+export declare function listStructFields(schema: AnySchema): StructFieldInfo[];
 export {};

package/dist/runtime/components/form/utils/schema-meta.js

@@ -46,3 +46,18 @@ export function getStructFieldTitle(schema, fieldName) {
 export function getStructFieldDescription(schema, fieldName) {
   return getFieldAnnotation(schema, fieldName, SchemaAST.getDescriptionAnnotation);
 }
+export function listStructFields(schema) {
+  const tl = getTypeLiteral(schema.ast);
+  if (!tl) return [];
+  return tl.propertySignatures.map((ps) => {
+    const name = String(ps.name);
+    const title = getStructFieldTitle(schema, name);
+    const description = getStructFieldDescription(schema, name);
+    return {
+      name,
+      ...title !== void 0 ? { title } : {},
+      ...description !== void 0 ? { description } : {},
+      optional: ps.isOptional
+    };
+  });
+}

package/dist/runtime/components/table/ai/columns-task.md

@@ -4,7 +4,7 @@ The `columns` array is a **full replacement**: whatever you emit becomes the ent
 
 # Hard rules
 
-1. **NEVER** emit a column with `type === "com.shwfed.table.column.actions"`. Action columns are wired by a separate registry; emitting one will be rejected and you will be retried.
+1. **NEVER add** a new column with `type === "com.shwfed.table.column.actions"`. Action columns are wired by a separate registry — you cannot synthesize one, and a fabricated actions column will be rejected and you will be retried. The **one exception**: if the current configuration already contains an actions column, echo it back verbatim (same `id`, `type`, `compatibilityDate`, and all fields) in its render position. Never invent an actions column the user merely describes when none already exists.
 2. **ONLY** emit a column with `type === "com.shwfed.table.column.markdown"` when the user **explicitly** asks for markdown / rich content / formatted body / 富文本 / Markdown. Otherwise prefer `com.shwfed.table.column.text`.
 3. **NEVER** set `enableSorting: true`. Client-side sorting is rarely the right call in practice (paginated/server-driven data, mixed types, etc.) and the user should opt in manually. Omit the field or set it to `false`.
 4. **NEVER** wrap the `accessor` in type coercions (`string(...)`, `int(...)`, `double(...)`) and **NEVER** supply a default via `.orValue(...)`. Emit the bare optional access — e.g. `row.?name`, `row.?age`. Coercion and defaults make it impossible for the user to distinguish real data from filler, which is actively harmful.
@@ -41,4 +41,13 @@ Always use optional access (`row.?field`) rather than `row.field` to avoid runti
 
 If the user gives a sample response, derive accessors directly from its shape. Otherwise, infer field names from the user's prose (e.g. "show name and email" → `row.?name`, `row.?email`).
 
+# Rendering recipes
+
+**Boolean / `0`-`1` values.** When a field is a boolean or a `0`/`1` flag (e.g. `enabled`, `isActive`, a `0/1` status), render it with `com.shwfed.table.column.icon` rather than `text` — a green check / red cross reads far faster than the literal `true` or `1`. Build both the `accessor` and the `color` as CEL ternaries on the condition:
+
+- `accessor`: `<condition> ? 'fluent:checkmark-20-filled' : 'fluent:dismiss-20-filled'`
+- `color`: `<condition> ? '#00c950' : '#fb2c36'`
+
+where `<condition>` is a bare optional-access test — `row.?enabled == true` for a boolean field, `row.?status == 1` for a `0/1` field. This is a comparison, not a coercion, so hard rule 4 still holds: do not wrap in `string(...)`/`int(...)` or add `.orValue(...)`.
+
 The current configuration (existing data source + columns) is appended to the user prompt under `Current configuration`. Use it only to (a) reuse existing column `id`s where the user's described column clearly corresponds to an existing one, and (b) inform field shapes (e.g. response keys). Do **not** copy columns forward that the user did not describe — the user's prompt is the source of truth for which columns should exist.

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.markdown/config.vue

@@ -154,8 +154,8 @@ const copyExpressionModel = computed({
         </FieldLabel>
         <ExpressionEditor
           v-model="copyExpressionModel"
-          placeholder="如 row.name"
-          result-type="string"
+          placeholder="如 row.name 或 row.?name"
+          :result-type="['string', 'optional']"
           class="min-h-10"
         />
       </Field>

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.markdown/runtime.vue

@@ -24,12 +24,22 @@ const rendered = computed(() => {
 const isEmpty = computed(() => rendered.value.trim().length === 0);
 const align = computed(() => isEmpty.value ? "center" : props.column.align ?? "left");
 const justifyClass = computed(() => JUSTIFY_CLASS[align.value] ?? JUSTIFY_CLASS.left);
-const showCopy = computed(() => !!props.column.copyExpression && !isEmpty.value);
+const copyText = computed(() => {
+  const { copyExpression } = props.column;
+  if (!copyExpression) return void 0;
+  try {
+    const value = Effect.runSync($cel(copyExpression, celBindings(celContext)));
+    return value === void 0 || value === null ? void 0 : String(value);
+  } catch (e) {
+    console.error("[shwfed-table] markdown copy expression failed", e);
+    return void 0;
+  }
+});
+const showCopy = computed(() => copyText.value !== void 0 && !isEmpty.value);
 const onCopy = async () => {
-  const { column } = props;
-  if (!column.copyExpression) return;
+  const text = copyText.value;
+  if (text === void 0) return;
   try {
-    const text = String(Effect.runSync($cel(column.copyExpression, celBindings(celContext))));
     await navigator.clipboard.writeText(text);
   } catch (e) {
     console.error("[shwfed-table] markdown copy failed", e);

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.markdown/schema.js

@@ -7,8 +7,9 @@ export const metadata = {
   name: "MD",
   icon: "fluent:markdown-20-regular"
 };
+const isCopyExpressionType = (t) => t === "string" || t === "dyn" || t.startsWith("optional");
 export function schema(configure) {
-  const cel = CelRowAccess(configure, { resultType: "string" });
+  const cel = CelRowAccess(configure, { resultType: isCopyExpressionType });
   const localeMarkdown = LocaleMarkdownWithRow(configure);
   return Schema.Struct({
     type: Schema.Literal(type),
@@ -34,7 +35,7 @@ export function schema(configure) {
     }),
     copyExpression: Schema.optional(cel.annotations({
       title: "\u590D\u5236\u8868\u8FBE\u5F0F",
-      description: "\u590D\u5236\u503C\u7684 CEL \u8868\u8FBE\u5F0F"
+      description: "\u590D\u5236\u503C\u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u53EF\u8FD4\u56DE optional\uFF08\u5982 `row.?field`\uFF09\uFF0C\u4E3A\u7A7A\u65F6\u4E0D\u663E\u793A\u590D\u5236\u6309\u94AE"
     }))
   }).annotations({ title: "MarkdownRenderer", description: "MD" });
 }

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.text/config.vue

@@ -188,8 +188,8 @@ const copyExpressionModel = computed({
         </FieldLabel>
         <ExpressionEditor
           v-model="copyExpressionModel"
-          placeholder="如 row.name"
-          result-type="string"
+          placeholder="如 row.name 或 row.?name"
+          :result-type="['string', 'optional']"
           class="min-h-10"
         />
       </Field>

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.text/runtime.vue

@@ -16,12 +16,22 @@ const rawValue = computed(() => props.ctx.cell.getValue());
 const isMissing = computed(() => rawValue.value === void 0 || rawValue.value === null);
 const align = computed(() => isMissing.value ? "center" : props.column.align ?? "left");
 const justifyClass = computed(() => JUSTIFY_CLASS[align.value] ?? JUSTIFY_CLASS.left);
-const showCopy = computed(() => !!props.column.copyExpression && !isMissing.value && rawValue.value !== "");
+const copyText = computed(() => {
+  const { copyExpression } = props.column;
+  if (!copyExpression) return void 0;
+  try {
+    const value = Effect.runSync($cel(copyExpression, celBindings(celContext)));
+    return value === void 0 || value === null ? void 0 : String(value);
+  } catch (e) {
+    console.error("[shwfed-table] text copy expression failed", e);
+    return void 0;
+  }
+});
+const showCopy = computed(() => copyText.value !== void 0 && !isMissing.value && rawValue.value !== "");
 const onCopy = async () => {
-  const { column } = props;
-  if (!column.copyExpression) return;
+  const text = copyText.value;
+  if (text === void 0) return;
   try {
-    const text = String(Effect.runSync($cel(column.copyExpression, celBindings(celContext))));
     await navigator.clipboard.writeText(text);
   } catch (e) {
     console.error("[shwfed-table] text copy failed", e);

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.text/schema.js

@@ -6,8 +6,9 @@ export const metadata = {
   name: "\u6587\u672C",
   icon: "fluent:text-field-20-regular"
 };
+const isCopyExpressionType = (t) => t === "string" || t === "dyn" || t.startsWith("optional");
 export function schema(configure) {
-  const cel = CelRowAccess(configure, { resultType: "string" });
+  const cel = CelRowAccess(configure, { resultType: isCopyExpressionType });
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
@@ -22,7 +23,7 @@ export function schema(configure) {
     ),
     copyExpression: Schema.optional(cel.annotations({
       title: "\u590D\u5236\u8868\u8FBE\u5F0F",
-      description: "\u590D\u5236\u503C\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u5B58\u5728\u65F6\u542F\u7528\u590D\u5236\u529F\u80FD"
+      description: "\u590D\u5236\u503C\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u5B58\u5728\u65F6\u542F\u7528\u590D\u5236\u529F\u80FD\uFF1B\u53EF\u8FD4\u56DE optional\uFF08\u5982 `row.?field`\uFF09\uFF0C\u4E3A\u7A7A\u65F6\u4E0D\u663E\u793A\u590D\u5236\u6309\u94AE"
     }))
   }).annotations({ title: "TextRenderer", description: "\u6587\u672C\u6E32\u67D3\u5668" });
 }

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

@@ -7,10 +7,20 @@ type __VLS_ModelProps = {
     modelValue: AnyRecord;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare var __VLS_201: {};
+type __VLS_Slots = {} & {
+    'general-extra'?: (props: typeof __VLS_201) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: AnyRecord) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: AnyRecord) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -1251,6 +1251,10 @@ const tableQueryValue = computed({
               </InputGroup>
             </Field>
 
+            <!-- Host extension slot: a wrapping editor (e.g. the `table` form
+                 field config) injects its own fields into the general pane. -->
+            <slot name="general-extra" />
+
             <div class="flex items-center gap-2">
               <h3 class="text-xs font-medium text-zinc-500">
                 {{ generalFieldTitle("dataSource") }}

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

@@ -7,10 +7,20 @@ type __VLS_ModelProps = {
     modelValue: AnyRecord;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare var __VLS_201: {};
+type __VLS_Slots = {} & {
+    'general-extra'?: (props: typeof __VLS_201) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: AnyRecord) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: AnyRecord) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -12,6 +12,7 @@ declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import("vue").DefineComponent<{
     config?: TableConfigValue;
+    rows?: Array<unknown>;
 }, import("@tanstack/vue-table").Table<unknown>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:config": (value: Readonly<{
         kind: "shwfed.component.table";
@@ -52,8 +53,10 @@ declare const __VLS_export: import("vue").DefineComponent<{
             rowSelection: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
         }>>;
     }> | undefined) => any;
+    "update:rows": (value: unknown[]) => any;
 }, string, import("vue").PublicProps, Readonly<{
     config?: TableConfigValue;
+    rows?: Array<unknown>;
 }> & Readonly<{
     "onUpdate:config"?: ((value: Readonly<{
         kind: "shwfed.component.table";
@@ -94,4 +97,5 @@ declare const __VLS_export: import("vue").DefineComponent<{
             rowSelection: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
         }>>;
     }> | undefined) => any) | undefined;
+    "onUpdate:rows"?: ((value: unknown[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -13,7 +13,7 @@ import { useVirtualizer } from "@tanstack/vue-virtual";
 import { Effect, Fiber, Option } from "effect";
 import { Fetch } from "fx-fetch";
 import { Pagination } from "reka-ui/namespaced";
-import { computed, defineComponent, h, onMounted, ref, watch } from "vue";
+import { computed, defineComponent, h, onMounted, ref, toRaw, watch } from "vue";
 import { useI18n } from "vue-i18n";
 import { celBindings, provideCELContext, injectCELContext } from "../../utils/cel-context";
 import { getLocalizedText } from "../../share/locale";
@@ -29,7 +29,7 @@ import { provideEventTarget } from "../../share/event-bus";
 import { findColumn } from "./utils/resolve";
 import { interpolateMarkdown } from "./utils/runtime";
 const config = defineModel("config", { type: Object });
-const rowData = ref([]);
+const rowData = defineModel("rows", { type: Array, ...{ default: () => [] } });
 const serverTotal = ref(void 0);
 const isFetching = ref(false);
 const queryState = ref({});
@@ -301,6 +301,14 @@ async function resetQuery() {
     queryState.value = {};
   }
 }
+function cloneRow(row) {
+  if (!row || typeof row !== "object") return row;
+  try {
+    return structuredClone(toRaw(row));
+  } catch {
+    return { ...row };
+  }
+}
 const tableInstanceId = config.value?.id ?? crypto.randomUUID();
 provideTableInstanceId(tableInstanceId);
 provideEventTarget(tableInstanceId, {
@@ -312,6 +320,24 @@ provideEventTarget(tableInstanceId, {
   "search": () => Effect.promise(fetchDataSource),
   "clear-selection": () => Effect.sync(() => {
     tableApi.resetRowSelection(true);
+  }),
+  // Local row edits — mutate `rowData` in place, no server round-trip. Each
+  // re-assigns the array so the `rows` model re-emits and a host (the
+  // `table` form field) sees the live list. Intended for client-side data:
+  // with server pagination (`dataSource.total`) `rowData` is only the
+  // current page, so a fetch will overwrite these edits.
+  "add-row": () => Effect.sync(() => {
+    rowData.value = [...rowData.value, {}];
+  }),
+  "duplicate-selected": () => Effect.sync(() => {
+    const clones = tableApi.getSelectedRowModel().rows.map((r) => cloneRow(r.original));
+    if (clones.length > 0) rowData.value = [...rowData.value, ...clones];
+  }),
+  "delete-selected": () => Effect.sync(() => {
+    const drop = new Set(tableApi.getSelectedRowModel().rows.map((r) => r.index));
+    if (drop.size === 0) return;
+    rowData.value = rowData.value.filter((_, i) => !drop.has(i));
+    tableApi.resetRowSelection(true);
   })
 });
 const queryRef = ref(null);

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

@@ -12,6 +12,7 @@ declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import("vue").DefineComponent<{
     config?: TableConfigValue;
+    rows?: Array<unknown>;
 }, import("@tanstack/vue-table").Table<unknown>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:config": (value: Readonly<{
         kind: "shwfed.component.table";
@@ -52,8 +53,10 @@ declare const __VLS_export: import("vue").DefineComponent<{
             rowSelection: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
         }>>;
     }> | undefined) => any;
+    "update:rows": (value: unknown[]) => any;
 }, string, import("vue").PublicProps, Readonly<{
     config?: TableConfigValue;
+    rows?: Array<unknown>;
 }> & Readonly<{
     "onUpdate:config"?: ((value: Readonly<{
         kind: "shwfed.component.table";
@@ -94,4 +97,5 @@ declare const __VLS_export: import("vue").DefineComponent<{
             rowSelection: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
         }>>;
     }> | undefined) => any) | undefined;
+    "onUpdate:rows"?: ((value: unknown[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;