@shwfed/config 2.1.0 → 2.1.2

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

@@ -10,7 +10,8 @@ import { provideFormState } from "../../../utils/state";
 defineOptions({ name: "ShwfedListFieldRow" });
 const state = defineModel({ type: Object, ...{ required: true } });
 const props = defineProps({
-  unit: { type: Object, required: true }
+  unit: { type: Object, required: true },
+  index: { type: Number, required: true }
 });
 const formState = provideFormState(state);
 provideCELContext({
@@ -19,6 +20,12 @@ provideCELContext({
     label: "item",
     description: "\u5F53\u524D\u5217\u8868\u9879",
     value: () => state.value ?? {}
+  },
+  index: {
+    type: "number",
+    label: "index",
+    description: "\u5F53\u524D\u5217\u8868\u9879\u7D22\u5F15\uFF0C\u4ECE 0 \u5F00\u59CB",
+    value: () => props.index
   }
 });
 const inherited = injectCELContext();
@@ -83,14 +90,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}` : "",
-    // Missing `gap` falls back to `DEFAULT_GAP`; see ../../../index.vue.
-    `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/fields/2026-05-13/com.shwfed.form.field.list/row.vue.d.ts

@@ -2,6 +2,7 @@ import type { FormUnitValue } from '../../../schema.js';
 import { type FormState } from '../../../utils/state.js';
 type __VLS_Props = {
     unit: FormUnitValue;
+    index: number;
 };
 type __VLS_ModelProps = {
     modelValue: FormState;

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

@@ -5,6 +5,7 @@ import { computed, ref, watch } from "vue";
 import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { interpolate } from "../../../../../utils/interpolate";
 import { getLocalizedText } from "../../../../../share/locale";
 import {
   useTreeDnd
@@ -31,6 +32,8 @@ const tooltipText = computed(
 const addLabelText = computed(
   () => getLocalizedText(props.config.addLabel, locale.value) || "\u65B0\u589E"
 );
+const summaryTemplate = computed(() => getLocalizedText(props.config.locale, locale.value));
+const collapsible = computed(() => !!summaryTemplate.value);
 function evalBool(expression, label) {
   if (!expression) return false;
   try {
@@ -50,6 +53,28 @@ const items = computed(() => {
   if (!Array.isArray(raw)) return [];
   return raw;
 });
+const rowSummaries = computed(() => {
+  const template = summaryTemplate.value;
+  if (template == null) return [];
+  return items.value.map(
+    (item, i) => interpolate(template, (expression) => {
+      try {
+        const out = Effect.runSync($cel(expression, {
+          form: state.value ?? {},
+          item: item ?? {},
+          index: i
+        }));
+        return out == null ? "" : String(out);
+      } catch (err) {
+        console.error(
+          `[shwfed-form] list field: failed to evaluate summary expression \`${expression}\` for ${props.fieldId}[${i}]:`,
+          err
+        );
+        return "";
+      }
+    })
+  );
+});
 function writeItems(next) {
   const path = props.config.binding;
   if (path == null) {
@@ -74,6 +99,16 @@ watch(
   },
   { immediate: true }
 );
+const expandedKeys = ref(/* @__PURE__ */ new Set());
+function isExpanded(key) {
+  return expandedKeys.value.has(key);
+}
+function toggleExpanded(key) {
+  const next = new Set(expandedKeys.value);
+  if (next.has(key)) next.delete(key);
+  else next.add(key);
+  expandedKeys.value = next;
+}
 const atMax = computed(
   () => props.config.max != null && items.value.length >= props.config.max
 );
@@ -86,13 +121,23 @@ const canReorder = computed(() => !isDisabled.value && reorderable.value);
 function append() {
   if (!canAdd.value) return;
   writeItems([...items.value, {}]);
-  rowKeys.value = [...rowKeys.value, makeId()];
+  const id = makeId();
+  rowKeys.value = [...rowKeys.value, id];
+  const next = new Set(expandedKeys.value);
+  next.add(id);
+  expandedKeys.value = next;
 }
 function removeAt(i) {
   if (!canRemove.value) return;
   if (i < 0 || i >= items.value.length) return;
+  const removedKey = rowKeys.value[i];
   writeItems(items.value.filter((_, j) => j !== i));
   rowKeys.value = rowKeys.value.filter((_, j) => j !== i);
+  if (removedKey != null && expandedKeys.value.has(removedKey)) {
+    const next = new Set(expandedKeys.value);
+    next.delete(removedKey);
+    expandedKeys.value = next;
+  }
 }
 function moveRow(from, to) {
   if (!canReorder.value) return;
@@ -169,37 +214,81 @@ function rowConfig(i) {
         v-for="(item, i) in items"
         :key="rowKeys[i]"
         :ref="dnd.rowRef(rowId(i), rowConfig(i))"
-        class="relative flex items-center gap-2 rounded border border-zinc-200 bg-zinc-50/40 p-3"
+        class="relative rounded border border-zinc-200 bg-zinc-50/40 p-3"
         data-slot="list-row"
         :data-instruction="dnd.instructionFor(rowId(i)) ?? void 0"
       >
-        <Icon
-          v-if="reorderable"
-          icon="fluent:re-order-dots-vertical-20-regular"
-          class="drag-handle size-4 shrink-0 text-zinc-400"
-          :class="canReorder ? 'cursor-grab' : 'cursor-not-allowed opacity-50'"
-          data-slot="list-row-drag-handle"
-        />
+        <div class="flex items-center gap-2">
+          <Icon
+            v-if="reorderable"
+            icon="fluent:re-order-dots-vertical-20-regular"
+            class="drag-handle size-4 shrink-0 text-zinc-400"
+            :class="canReorder ? 'cursor-grab' : 'cursor-not-allowed opacity-50'"
+            data-slot="list-row-drag-handle"
+          />
+
+          <InputGroupButton
+            v-if="collapsible"
+            size="icon-xs"
+            class="shrink-0"
+            data-slot="list-row-collapse"
+            :aria-expanded="isExpanded(rowId(i))"
+            :aria-label="isExpanded(rowId(i)) ? '\u6298\u53E0' : '\u5C55\u5F00'"
+            @click="toggleExpanded(rowId(i))"
+          >
+            <Icon
+              :icon="isExpanded(rowId(i)) ? 'fluent:chevron-down-20-regular' : 'fluent:chevron-right-20-regular'"
+            />
+          </InputGroupButton>
 
-        <div class="min-w-0 flex-1">
+          <div
+            v-if="collapsible"
+            class="min-w-0 flex-1"
+            data-slot="list-row-summary"
+          >
+            <Markdown
+              :source="rowSummaries[i] ?? ''"
+              class="prose prose-xs prose-zinc"
+            />
+          </div>
+          <div
+            v-else
+            class="min-w-0 flex-1"
+          >
+            <Row
+              :model-value="item"
+              :unit="config.unit"
+              :index="i"
+              @update:model-value="(next) => updateRow(i, next)"
+            />
+          </div>
+
+          <InputGroupButton
+            variant="destructive"
+            size="icon-xs"
+            class="shrink-0"
+            :disabled="!canRemove"
+            data-slot="list-row-remove"
+            aria-label="删除"
+            @click="removeAt(i)"
+          >
+            <Icon icon="fluent:delete-20-regular" />
+          </InputGroupButton>
+        </div>
+
+        <div
+          v-if="collapsible"
+          v-show="isExpanded(rowId(i))"
+          class="mt-3 min-w-0"
+          data-slot="list-row-content"
+        >
           <Row
             :model-value="item"
             :unit="config.unit"
+            :index="i"
             @update:model-value="(next) => updateRow(i, next)"
           />
         </div>
-
-        <InputGroupButton
-          variant="destructive"
-          size="icon-xs"
-          class="shrink-0"
-          :disabled="!canRemove"
-          data-slot="list-row-remove"
-          aria-label="删除"
-          @click="removeAt(i)"
-        >
-          <Icon icon="fluent:delete-20-regular" />
-        </InputGroupButton>
       </div>
 
       <Button

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

@@ -36,15 +36,22 @@ export declare function schema(configure: (env: Environment) => void): Schema.re
         readonly locale: "en" | "ja" | "ko";
         readonly message: string;
     }[]] | undefined;
+    readonly locale?: readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]] | undefined;
     readonly displayName?: string | undefined;
     readonly compatibilityDate: "2026-05-13";
     readonly min?: number | undefined;
     readonly max?: number | undefined;
+    readonly binding?: string | undefined;
     readonly unit: Readonly<{
         fields: ReadonlyArray<import("../../../schema.js").FieldValue>;
         layouts: ReadonlyArray<import("../../../schema.js").LayoutSetValue>;
     }>;
-    readonly binding?: string | undefined;
     readonly addLabel?: readonly [{
         readonly locale: "zh";
         readonly message: string;
@@ -94,6 +101,13 @@ export declare function schema(configure: (env: Environment) => void): Schema.re
     min: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
     max: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
     disabled: Schema.optional<Schema.Schema<string, string, never>>;
+    locale: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{
+        locale: Schema.Literal<["zh"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>], [Schema.Struct<{
+        locale: Schema.Literal<["ja", "en", "ko"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>]>>;
     unit: Schema.suspend<Readonly<{
         fields: ReadonlyArray<import("../../../schema.js").FieldValue>;
         layouts: ReadonlyArray<import("../../../schema.js").LayoutSetValue>;

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

@@ -15,9 +15,13 @@ export function schema(configure) {
   const CelBool = Expression({ configure, resultType: "bool" });
   const unitConfigure = (env) => {
     configure(env);
-    if (!env.getDefinitions().variables.some((v) => v.name === "item")) {
+    const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
+    if (!declared.has("item")) {
       env.registerVariable("item", "dyn", { description: "\u5F53\u524D\u5217\u8868\u9879" });
     }
+    if (!declared.has("index")) {
+      env.registerVariable("index", "number", { description: "\u5F53\u524D\u5217\u8868\u9879\u7D22\u5F15\uFF0C\u4ECE 0 \u5F00\u59CB" });
+    }
   };
   const Unit = Schema.suspend(() => FormUnit(unitConfigure));
   return Schema.Struct({
@@ -60,6 +64,10 @@ export function schema(configure) {
       title: "\u7981\u7528\u6761\u4EF6",
       description: "\u8FD4\u56DE `true` \u65F6\u6574\u4E2A\u5217\u8868\u53EA\u8BFB\uFF0C\u4E0D\u80FD\u65B0\u589E/\u5220\u9664/\u91CD\u6392"
     })),
+    locale: Schema.optional(Locale.annotations({
+      title: "\u5217\u8868\u9879\u6458\u8981",
+      description: "\u914D\u7F6E\u540E\u6BCF\u4E2A\u5217\u8868\u9879\u53EF\u6298\u53E0\uFF0C\u6298\u53E0\u65F6\u5C55\u793A\u6B64\u5904\u6587\u672C\u6E32\u67D3\u7684\u884C\u5185 Markdown \u4F5C\u4E3A\u6458\u8981\u3002\u652F\u6301 `{{ \u8868\u8FBE\u5F0F }}` \u63D2\u503C\uFF0C\u8868\u8FBE\u5F0F\u4E3A CEL\uFF0C\u53EF\u8BBF\u95EE `item`\uFF08\u5F53\u524D\u9879\uFF09\u3001`index`\uFF08\u5E8F\u53F7\uFF0C\u4ECE 0 \u5F00\u59CB\uFF09\u4E0E `form`"
+    })),
     unit: Unit.annotations({
       title: "\u5217\u8868\u9879\u914D\u7F6E",
       description: "\u5355\u4E2A\u5217\u8868\u9879\u7684\u5B57\u6BB5\u4E0E\u5E03\u5C40\uFF1B\u6BCF\u4E2A\u5217\u8868\u9879\u90FD\u6309\u6B64\u7ED3\u6784\u6E32\u67D3\u4E00\u4EFD"

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/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>