@shwfed/config 3.0.16 → 3.0.17

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

@@ -42,6 +42,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly validations?: readonly {
+            readonly message: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]];
+            readonly warning?: boolean | undefined;
+            readonly when: string;
+        }[] | undefined;
         readonly addon?: {
             readonly size: "default" | "sm" | "xs";
             readonly style?: string | undefined;
@@ -109,17 +120,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
             }[];
         } | undefined;
-        readonly validations?: readonly {
-            readonly message: readonly [{
-                readonly locale: "zh";
-                readonly message: string;
-            }, ...{
-                readonly locale: "en" | "ja" | "ko";
-                readonly message: string;
-            }[]];
-            readonly warning?: boolean | undefined;
-            readonly when: string;
-        }[] | undefined;
         readonly precision?: number | undefined;
         readonly roundingMode?: "round" | "floor" | "ceil" | undefined;
         readonly valueAsString?: boolean | undefined;
@@ -165,6 +165,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly validations?: readonly {
+            readonly message: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]];
+            readonly warning?: boolean | undefined;
+            readonly when: string;
+        }[] | undefined;
         readonly addon?: {
             readonly size: "default" | "sm" | "xs";
             readonly style?: string | undefined;
@@ -232,17 +243,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
             }[];
         } | undefined;
-        readonly validations?: readonly {
-            readonly message: readonly [{
-                readonly locale: "zh";
-                readonly message: string;
-            }, ...{
-                readonly locale: "en" | "ja" | "ko";
-                readonly message: string;
-            }[]];
-            readonly warning?: boolean | undefined;
-            readonly when: string;
-        }[] | undefined;
         readonly precision?: number | undefined;
         readonly roundingMode?: "round" | "floor" | "ceil" | undefined;
         readonly valueAsString?: boolean | undefined;

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

@@ -42,6 +42,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly validations?: readonly {
+            readonly message: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]];
+            readonly warning?: boolean | undefined;
+            readonly when: string;
+        }[] | undefined;
         readonly addon?: {
             readonly size: "default" | "sm" | "xs";
             readonly style?: string | undefined;
@@ -109,17 +120,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
             }[];
         } | undefined;
-        readonly validations?: readonly {
-            readonly message: readonly [{
-                readonly locale: "zh";
-                readonly message: string;
-            }, ...{
-                readonly locale: "en" | "ja" | "ko";
-                readonly message: string;
-            }[]];
-            readonly warning?: boolean | undefined;
-            readonly when: string;
-        }[] | undefined;
         readonly precision?: number | undefined;
         readonly roundingMode?: "round" | "floor" | "ceil" | undefined;
         readonly valueAsString?: boolean | undefined;
@@ -165,6 +165,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
+        readonly validations?: readonly {
+            readonly message: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]];
+            readonly warning?: boolean | undefined;
+            readonly when: string;
+        }[] | undefined;
         readonly addon?: {
             readonly size: "default" | "sm" | "xs";
             readonly style?: string | undefined;
@@ -232,17 +243,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly variant?: "default" | "link" | "destructive" | "primary" | "ghost" | undefined;
             }[];
         } | undefined;
-        readonly validations?: readonly {
-            readonly message: readonly [{
-                readonly locale: "zh";
-                readonly message: string;
-            }, ...{
-                readonly locale: "en" | "ja" | "ko";
-                readonly message: string;
-            }[]];
-            readonly warning?: boolean | undefined;
-            readonly when: string;
-        }[] | undefined;
         readonly precision?: number | undefined;
         readonly roundingMode?: "round" | "floor" | "ceil" | undefined;
         readonly valueAsString?: boolean | undefined;

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

@@ -1,7 +1,7 @@
 <script setup>
 import { cel as _rawCel } from "../../utils/cel";
 import { TZDate } from "@date-fns/tz";
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 import { Fetch } from "fx-fetch";
 import { computed } from "vue";
 import {
@@ -17,8 +17,10 @@ import { provideDerivedQuiescence, useDerived } from "./utils/derived";
 import { useFormHistory } from "./utils/history";
 import { evaluateInitial } from "./utils/initial";
 import { provideEventTarget } from "../../share/event-bus";
+import * as stateWriteOp from "../operations/2026-07-19/com.shwfed.operation.form.state.write/schema";
 import { provideFormReadonly } from "./utils/readonly";
 import { provideFormState } from "./utils/state";
+import { mergeAtPath } from "./utils/state-write";
 import { provideOptionsRegistry, provideSelectionsRegistry } from "../../utils/selections-registry";
 import { provideValidation } from "./utils/validation";
 defineOptions({ name: "ShwfedForm" });
@@ -116,7 +118,60 @@ provideEventTarget(formInstanceId, {
   }),
   "undo": () => Effect.sync(formHistory.undo),
   "redo": () => Effect.sync(formHistory.redo),
-  "reset-to-initial": () => Effect.sync(formHistory.reset)
+  "reset-to-initial": () => Effect.sync(formHistory.reset),
+  // Host-coupled `state.write` op: it writes into THIS form's state bag, which
+  // a generic handler can't reach (the bag lives on the Vue inject chain), so
+  // like the table's `add-row` it ships no `runtime.ts` and is hand-wired here.
+  // It is the button's「写入表单状态」capability lifted out so any trigger list can
+  // dispatch it — but, being one step of a chain, it carries no bracketing
+  // 写入前/写入后 lists (the surrounding chain is the bracket).
+  //
+  // Params are decoded with the same loose posture the table uses for
+  // `add-row` — a plain cast, tolerating absent/malformed shapes — since the
+  // authoritative validation already ran in the trigger editor against the op's
+  // schema. Rows commit in LIST ORDER via `setAt` (dirty-marking is intended —
+  // an op write is user intent, as with the button and per `state.ts`'s
+  // "explicit clear counts as a touch"). Unlike the button there is no
+  // "commit out of the form I'm in" walk: the op explicitly targets THIS form,
+  // so it writes THIS form's own bag.
+  //
+  // Each `value` is evaluated with the emit-site evaluator (`cel` — the
+  // dispatching button's own scope, where a row action's `row` is live) when
+  // present, else the form's own `$cel`; both bind `{ steps }` (the chain's
+  // earlier outputs) into the context. A row whose evaluation or write throws
+  // logs UNGATED — designers configure inside the production-built app, so an
+  // `import.meta.dev`-gated log is one they can never see (see the button
+  // runtime's note) — then HALTS the remaining rows and the rest of the trigger
+  // chain via a defect, keeping the handler's `void` error channel (the guard
+  // shape `validate` uses above). `tapErrorCause` covers both a failed
+  // evaluation and a throwing `setAt`.
+  [stateWriteOp.type]: (params, cel, step) => {
+    const writes = params?.writes ?? [];
+    const steps = step?.outputs() ?? {};
+    return Effect.forEach(
+      writes,
+      (write) => {
+        const path = write.path?.trim() ?? "";
+        if (path.length === 0) return Effect.void;
+        const evaluated = cel ? cel(write.value, { steps }) : $cel(write.value, { steps });
+        return Effect.map(evaluated, (result) => {
+          formState.setAt(path, mergeAtPath(formState.getAt(path), result));
+        }).pipe(
+          Effect.tapErrorCause((cause) => Effect.sync(() => {
+            console.error(
+              `[shwfed-form] state.write: failed to write "${path}" for ${formInstanceId}:`,
+              Cause.squash(cause)
+            );
+          })),
+          // Re-raise as a defect so the chain halts (later rows + the rest of
+          // the trigger list stay skipped) without widening the infallible
+          // `void` error channel — same reason `validate` uses `Effect.die`.
+          Effect.catchAllCause((cause) => Effect.die(Cause.squash(cause)))
+        );
+      },
+      { discard: true }
+    );
+  }
 });
 defineExpose({
   seeded,

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

@@ -26,6 +26,11 @@ export declare const metadata: {
         readonly id: "reset-to-initial";
         readonly name: "重置为初始值";
         readonly icon: "fluent:arrow-reset-20-regular";
+    }, {
+        readonly id: "com.shwfed.operation.form.state.write";
+        readonly compatibilityDate: "2026-07-19";
+        readonly name: "写入表单状态";
+        readonly icon: "fluent:document-edit-20-regular";
     }];
 };
 type AnySchema = Schema.Schema<any, any, never>;

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

@@ -2,6 +2,7 @@ import { Schema } from "effect";
 import { Expression, HttpRequestResult } from "../../share/expression.js";
 import { allFieldSchemas } from "./utils/resolve.js";
 import { registerFormVariablesIfAbsent } from "./utils/form-vars.js";
+import * as stateWriteOp from "../operations/2026-07-19/com.shwfed.operation.form.state.write/schema.js";
 import { md } from "../../share/markdown.js";
 import {
   LayoutSet,
@@ -23,7 +24,19 @@ export const metadata = {
     { id: "validate", name: "\u6821\u9A8C", icon: "fluent:checkmark-circle-20-regular" },
     { id: "undo", name: "\u64A4\u9500", icon: "fluent:arrow-undo-20-regular" },
     { id: "redo", name: "\u91CD\u505A", icon: "fluent:arrow-redo-20-regular" },
-    { id: "reset-to-initial", name: "\u91CD\u7F6E\u4E3A\u521D\u59CB\u503C", icon: "fluent:arrow-reset-20-regular" }
+    { id: "reset-to-initial", name: "\u91CD\u7F6E\u4E3A\u521D\u59CB\u503C", icon: "fluent:arrow-reset-20-regular" },
+    // Parameterized (but host-coupled) op: `compatibilityDate` marks it as
+    // carrying params, so the trigger editor renders the op's `config.vue` and
+    // seeds its `defaults()`. Like the table's `add-row` it ships no
+    // `runtime.ts` — the write touches this form instance's private state bag,
+    // so the handler is hand-wired in `index.vue`'s `provideEventTarget`. `id`
+    // doubles as the operation-block `type`.
+    {
+      id: stateWriteOp.type,
+      compatibilityDate: stateWriteOp.compatibilityDate,
+      name: stateWriteOp.metadata.name,
+      icon: stateWriteOp.metadata.icon
+    }
   ]
 };
 function unitFields(configure) {

package/dist/runtime/components/form/utils/state-write.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Merge one write row's `next` value into the `current` value at its path.
+ *
+ * Only deep-merge when both sides are records. Otherwise the new value
+ * replaces wholesale — scalars, arrays, null, and mixed-type writes all fall
+ * through to a plain replace (`setAt(path, next)` at the call site). Arrays
+ * nested inside two merged records replace last-write-wins, per `mergeObjects`.
+ */
+export declare function mergeAtPath(current: unknown, next: unknown): unknown;

package/dist/runtime/components/form/utils/state-write.js

@@ -0,0 +1,16 @@
+import { createDefu } from "defu";
+const mergeObjects = createDefu((obj, key, value) => {
+  if (Array.isArray(obj[key]) && Array.isArray(value)) {
+    obj[key] = value;
+    return true;
+  }
+});
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export function mergeAtPath(current, next) {
+  if (isPlainObject(current) && isPlainObject(next)) {
+    return mergeObjects({ ...next }, current);
+  }
+  return next;
+}

package/dist/runtime/components/operations/2026-07-19/com.shwfed.operation.form.state.write/config.d.vue.ts

@@ -0,0 +1,21 @@
+import { type Value } from './schema.js';
+type __VLS_ModelProps = {
+    modelValue: Value;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: {
+        readonly writes: readonly {
+            readonly path: string;
+            readonly value: string;
+        }[];
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: {
+        readonly writes: readonly {
+            readonly path: string;
+            readonly value: string;
+        }[];
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/operations/2026-07-19/com.shwfed.operation.form.state.write/config.vue

@@ -0,0 +1,100 @@
+<script setup>
+import { computed } from "vue";
+import { Icon } from "@iconify/vue";
+import { Button } from "../../../ui/button";
+import { Field, FieldLabel } from "../../../ui/field";
+import { ExpressionEditor } from "../../../ui/expression-editor";
+import { Markdown } from "../../../ui/markdown";
+import { InputGroupButton } from "../../../ui/input-group";
+import { getStructFieldDescription, getStructFieldTitle } from "../../../../share/schema-meta";
+import { schema } from "./schema";
+defineOptions({ name: "ShwfedFormStateWriteOperationConfig" });
+const value = defineModel({ type: null, ...{ required: true } });
+const opSchema = schema(() => {
+});
+const fieldTitle = (f) => getStructFieldTitle(opSchema, f) ?? f;
+const fieldDescription = (f) => getStructFieldDescription(opSchema, f);
+const writes = computed(() => value.value.writes ?? []);
+function patchWrites(next) {
+  value.value = { ...value.value, writes: next };
+}
+function updateRow(index, patch) {
+  patchWrites(writes.value.map((w, i) => i === index ? { ...w, ...patch } : w));
+}
+function addRow() {
+  patchWrites([...writes.value, { path: "", value: "" }]);
+}
+function removeRow(index) {
+  patchWrites(writes.value.filter((_, i) => i !== index));
+}
+</script>
+
+<template>
+  <Field orientation="vertical">
+    <FieldLabel class="text-xs text-zinc-500">
+      <template
+        v-if="fieldDescription('writes')"
+        #tooltip
+      >
+        <Markdown
+          :source="fieldDescription('writes')"
+          block
+          class="prose prose-sm prose-zinc"
+        />
+      </template>
+      {{ fieldTitle("writes") }}
+    </FieldLabel>
+
+    <div class="flex flex-col gap-3">
+      <!-- One write item per multiline editor: the monofont binding path as a
+           full-width `leading` header row, the value expression wrapping below
+           (its own `{x}` badge), and a destructive delete in the `trailing`
+           bottom row. Reuses the ExpressionEditor's own InputGroup. -->
+      <ExpressionEditor
+        v-for="(row, index) in writes"
+        :key="index"
+        :model-value="row.value"
+        multiline
+        placeholder="值，如 selected[?0].?exchangeRate"
+        class="min-h-16"
+        @update:model-value="(v) => updateRow(index, { value: v })"
+      >
+        <template #leading>
+          <input
+            type="text"
+            data-slot="state-write-path"
+            :value="row.path"
+            placeholder="路径"
+            class="w-full min-w-0 bg-transparent font-mono text-sm text-zinc-700 outline-none placeholder:text-zinc-300"
+            :aria-label="`\u5199\u5165\u8DEF\u5F84 ${index + 1}`"
+            @input="updateRow(index, { path: $event.target.value })"
+          >
+        </template>
+        <template #trailing>
+          <InputGroupButton
+            variant="destructive"
+            size="icon-xs"
+            as-child
+          >
+            <button
+              type="button"
+              :aria-label="`\u79FB\u9664\u5199\u5165\u9879 ${index + 1}`"
+              @click="removeRow(index)"
+            >
+              <Icon icon="fluent:delete-20-regular" />
+            </button>
+          </InputGroupButton>
+        </template>
+      </ExpressionEditor>
+
+      <Button
+        type="button"
+        class="justify-center"
+        @click="addRow"
+      >
+        <Icon icon="fluent:add-20-regular" />
+        <span>添加写入项</span>
+      </Button>
+    </div>
+  </Field>
+</template>

package/dist/runtime/components/operations/2026-07-19/com.shwfed.operation.form.state.write/config.vue.d.ts

@@ -0,0 +1,21 @@
+import { type Value } from './schema.js';
+type __VLS_ModelProps = {
+    modelValue: Value;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: {
+        readonly writes: readonly {
+            readonly path: string;
+            readonly value: string;
+        }[];
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: {
+        readonly writes: readonly {
+            readonly path: string;
+            readonly value: string;
+        }[];
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/operations/2026-07-19/com.shwfed.operation.form.state.write/schema.d.ts

@@ -0,0 +1,18 @@
+import { Schema } from 'effect';
+import type { Environment } from '../../../../vendor/cel-js/lib/index.js';
+export declare const type: "com.shwfed.operation.form.state.write";
+export declare const compatibilityDate: "2026-07-19";
+export declare const metadata: {
+    readonly name: "写入表单状态";
+    readonly icon: "fluent:document-edit-20-regular";
+    readonly description: "按列表顺序把每个 CEL 求值结果写入目标表单状态的对应绑定路径；作为触发链中的一步派发";
+};
+export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
+    writes: Schema.Array$<Schema.Struct<{
+        path: Schema.SchemaClass<string, string, never>;
+        value: Schema.Schema<string, string, never>;
+    }>>;
+}>;
+export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;
+export type WriteValue = Value['writes'][number];
+export declare function defaults(): Partial<Value>;

package/dist/runtime/components/operations/2026-07-19/com.shwfed.operation.form.state.write/schema.js

@@ -0,0 +1,47 @@
+import { Schema } from "effect";
+import { Expression } from "../../../../share/expression.js";
+import { md } from "../../../../share/markdown.js";
+import { registerStepsVariableIfAbsent } from "../../utils/step-vars.js";
+export const type = "com.shwfed.operation.form.state.write";
+export const compatibilityDate = "2026-07-19";
+export const metadata = {
+  name: "\u5199\u5165\u8868\u5355\u72B6\u6001",
+  icon: "fluent:document-edit-20-regular",
+  description: "\u6309\u5217\u8868\u987A\u5E8F\u628A\u6BCF\u4E2A CEL \u6C42\u503C\u7ED3\u679C\u5199\u5165\u76EE\u6807\u8868\u5355\u72B6\u6001\u7684\u5BF9\u5E94\u7ED1\u5B9A\u8DEF\u5F84\uFF1B\u4F5C\u4E3A\u89E6\u53D1\u94FE\u4E2D\u7684\u4E00\u6B65\u6D3E\u53D1"
+};
+export function schema(configure) {
+  const withSteps = (env) => {
+    configure(env);
+    registerStepsVariableIfAbsent(env);
+  };
+  const Write = Schema.Struct({
+    path: Schema.String.annotations({
+      title: "\u8DEF\u5F84",
+      description: "\u5199\u5165\u7684\u7ED1\u5B9A\u8DEF\u5F84\uFF0C\u5982 `dataJson.cus_currency`"
+    }),
+    value: Expression({ configure: withSteps }).annotations({
+      title: "\u503C",
+      description: '\u6C42\u503C\u7ED3\u679C\u5199\u5165\u8BE5\u8DEF\u5F84\uFF1B\u53EF\u7ECF `steps["<\u6B65\u9AA4\u6807\u8BC6>"]` \u5F15\u7528\u540C\u4E00\u89E6\u53D1\u94FE\u4E2D\u524D\u5E8F\u6B65\u9AA4\u7684\u8F93\u51FA'
+    })
+  });
+  return Schema.Struct({
+    writes: Schema.Array(Write).annotations({
+      title: "\u5199\u5165\u503C",
+      description: md`
+        按列表顺序逐行求值并写入到目标表单的状态：每行的 \`值\`
+        表达式结果写入其 \`路径\`。对象值与当前值深合并（数组整体替换），
+        其他类型直接替换。留空表示不进行任何写入。
+      `
+    })
+  }).annotations({
+    title: "FormStateWriteOperation",
+    description: md`
+      按顺序将每个 CEL 表达式的结果写回目标表单状态的对应路径。作为触发链中的
+      一步派发；写入值可经 \`steps["<步骤标识>"]\` 引用同一触发链中前序步骤的输出。
+      任一行求值或写入失败将中止本次触发链——其后各行与后续操作不再执行。
+    `
+  });
+}
+export function defaults() {
+  return { writes: [] };
+}

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.combobox-single/config.d.vue.ts

@@ -23,6 +23,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-05-20";
         readonly grow?: boolean | undefined;
         readonly items: readonly {
@@ -87,6 +88,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-05-20";
         readonly grow?: boolean | undefined;
         readonly items: readonly {

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.combobox-single/config.vue

@@ -77,6 +77,17 @@ const readonlyModel = computed({
     }
   }
 });
+const requiredModel = computed({
+  get: () => value.value.required ?? "",
+  set: (v) => {
+    if (v === "") {
+      const { required: _omit, ...rest } = value.value;
+      value.value = rest;
+    } else {
+      value.value = { ...value.value, required: v };
+    }
+  }
+});
 const derivedModel = computed({
   get: () => value.value.derived,
   set: (v) => {
@@ -479,6 +490,27 @@ function setItemTooltip(index, tooltip) {
           :extra-vars="ROW_VARS"
         />
       </Field>
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template
+            v-if="fieldDescription('required')"
+            #tooltip
+          >
+            <Markdown
+              :source="fieldDescription('required')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("required") }}
+        </FieldLabel>
+        <ExpressionEditor
+          v-model="requiredModel"
+          placeholder="例：row.type == 'company'"
+          result-type="bool"
+          :extra-vars="ROW_VARS"
+        />
+      </Field>
       <Field
         orientation="vertical"
         class="col-span-2"

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.combobox-single/config.vue.d.ts

@@ -23,6 +23,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-05-20";
         readonly grow?: boolean | undefined;
         readonly items: readonly {
@@ -87,6 +88,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-05-20";
         readonly grow?: boolean | undefined;
         readonly items: readonly {

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.combobox-single/schema.d.ts

@@ -158,6 +158,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         readonly locale: "en" | "ja" | "ko";
         readonly message: string;
     }[]], never>>;
+    required: Schema.optional<Schema.Schema<string, string, never>>;
     id: Schema.refine<string, typeof Schema.String>;
     groupId: Schema.optional<typeof Schema.UUID>;
     type: Schema.Literal<["com.shwfed.table.column.combobox-single"]>;

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.combobox-single/schema.js

@@ -49,7 +49,7 @@ export function schema(configure) {
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
-    ...editableColumnFields(),
+    ...editableColumnFields(configure),
     placeholder: Schema.optional(Locale.annotations({
       title: "\u5360\u4F4D\u7B26",
       description: "\u672A\u9009\u4E2D\u4EFB\u4F55\u9009\u9879\u65F6\u8F93\u5165\u6846\u4E2D\u7684\u5360\u4F4D\u6587\u672C"

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.number-input/config.vue

@@ -138,6 +138,17 @@ const readonlyModel = computed({
     }
   }
 });
+const requiredModel = computed({
+  get: () => value.value.required ?? "",
+  set: (v) => {
+    if (v === "") {
+      const { required: _drop, ...rest } = value.value;
+      value.value = rest;
+    } else {
+      value.value = { ...value.value, required: v };
+    }
+  }
+});
 const derivedModel = computed({
   get: () => value.value.derived,
   set: (v) => {
@@ -575,6 +586,27 @@ function onMaxChange(v) {
           :extra-vars="ROW_VARS"
         />
       </Field>
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template
+            v-if="fieldDescription('required')"
+            #tooltip
+          >
+            <Markdown
+              :source="fieldDescription('required')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("required") }}
+        </FieldLabel>
+        <ExpressionEditor
+          v-model="requiredModel"
+          placeholder="例：row.type == 'company'"
+          result-type="bool"
+          :extra-vars="ROW_VARS"
+        />
+      </Field>
       <Field
         orientation="vertical"
         class="col-span-2"

package/dist/runtime/components/table/columns/2026-05-20/com.shwfed.table.column.number-input/schema.d.ts

@@ -205,6 +205,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         readonly message: string;
     }[]], never>>;
     hidden: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    required: Schema.optional<Schema.Schema<string, string, never>>;
     id: Schema.refine<string, typeof Schema.String>;
     groupId: Schema.optional<typeof Schema.UUID>;
     type: Schema.Literal<["com.shwfed.table.column.number-input"]>;