@shwfed/config 3.0.16 → 3.0.18

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

@@ -24,6 +24,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly align: "center" | "left" | "right";
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-06-14";
         readonly grow?: boolean | undefined;
         readonly groupId?: string | undefined;
@@ -45,10 +46,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
@@ -83,6 +84,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly align: "center" | "left" | "right";
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-06-14";
         readonly grow?: boolean | undefined;
         readonly groupId?: string | undefined;
@@ -104,10 +106,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";

package/dist/runtime/components/table/columns/2026-06-14/com.shwfed.table.column.tree-combobox-multi/schema.d.ts

@@ -99,6 +99,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.tree-combobox-multi"]>;

package/dist/runtime/components/table/columns/2026-06-14/com.shwfed.table.column.tree-combobox-multi/schema.js

@@ -68,7 +68,7 @@ export function schema(configure) {
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
-    ...editableColumnFields(),
+    ...editableColumnFields(configure),
     align: Schema.optionalWith(Align.annotations({ title: "\u5BF9\u9F50" }), { default: () => "left" }),
     placeholder: Schema.optional(Locale.annotations({
       title: "\u5360\u4F4D\u7B26",

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

@@ -24,6 +24,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly align: "center" | "left" | "right";
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-06-14";
         readonly grow?: boolean | undefined;
         readonly groupId?: string | undefined;
@@ -45,10 +46,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -82,6 +83,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly align: "center" | "left" | "right";
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-06-14";
         readonly grow?: boolean | undefined;
         readonly groupId?: string | undefined;
@@ -103,10 +105,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

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

@@ -533,6 +533,28 @@ const derivedModel = computed({
           @update:model-value="(v) => setOptionalExpression('readonly', v)"
         />
       </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
+          :model-value="value.required ?? ''"
+          placeholder="例：row.type == 'company'"
+          result-type="bool"
+          :extra-vars="ROW_VARS"
+          @update:model-value="(v) => setOptionalExpression('required', v)"
+        />
+      </Field>
       <Field
         orientation="vertical"
         class="col-span-2"

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

@@ -24,6 +24,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly align: "center" | "left" | "right";
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-06-14";
         readonly grow?: boolean | undefined;
         readonly groupId?: string | undefined;
@@ -45,10 +46,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -82,6 +83,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]] | undefined;
         readonly align: "center" | "left" | "right";
+        readonly required?: string | undefined;
         readonly compatibilityDate: "2026-06-14";
         readonly grow?: boolean | undefined;
         readonly groupId?: string | undefined;
@@ -103,10 +105,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly enableSorting?: boolean | undefined;
         readonly nodeKey: string;
         readonly nodeChildren: string;
         readonly nodeLabel: string;
+        readonly enableSorting?: boolean | undefined;
         readonly nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

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

@@ -96,6 +96,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.tree-combobox-single"]>;

package/dist/runtime/components/table/columns/2026-06-14/com.shwfed.table.column.tree-combobox-single/schema.js

@@ -68,7 +68,7 @@ export function schema(configure) {
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
-    ...editableColumnFields(),
+    ...editableColumnFields(configure),
     align: Schema.optionalWith(Align.annotations({ title: "\u5BF9\u9F50" }), { default: () => "left" }),
     placeholder: Schema.optional(Locale.annotations({
       title: "\u5360\u4F4D\u7B26",

package/dist/runtime/components/table/columns/2026-06-17/com.shwfed.table.column.date-input/config.vue

@@ -202,6 +202,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 disabledDateModel = computed({
   get: () => value.value.disabledDate ?? "",
   set: (v) => {
@@ -473,6 +484,27 @@ const derivedModel = computed({
           :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">
         <FieldLabel class="text-xs text-zinc-500">
           <template

package/dist/runtime/components/table/columns/2026-06-17/com.shwfed.table.column.date-input/schema.d.ts

@@ -233,6 +233,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.date-input"]>;

package/dist/runtime/components/table/columns/2026-06-17/com.shwfed.table.column.date-input/schema.js

@@ -48,7 +48,7 @@ export function schema(configure) {
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
-    ...editableColumnFields(),
+    ...editableColumnFields(configure),
     align: Schema.optionalWith(Align.annotations({ title: "\u5BF9\u9F50" }), { default: () => "left" }),
     placeholder: Schema.optional(Locale.annotations({
       title: "\u5360\u4F4D\u7B26",

package/dist/runtime/components/table/columns/2026-06-22/com.shwfed.table.column.date-range-input/config.vue

@@ -202,6 +202,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 disabledDateModel = computed({
   get: () => value.value.disabledDate ?? "",
   set: (v) => {
@@ -569,6 +580,27 @@ const derivedModel = computed({
           :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">
         <FieldLabel class="text-xs text-zinc-500">
           <template

package/dist/runtime/components/table/columns/2026-06-22/com.shwfed.table.column.date-range-input/schema.d.ts

@@ -118,6 +118,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.date-range-input"]>;

package/dist/runtime/components/table/columns/2026-06-22/com.shwfed.table.column.date-range-input/schema.js

@@ -46,7 +46,7 @@ export function schema(configure) {
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
-    ...editableColumnFields(),
+    ...editableColumnFields(configure),
     align: Schema.optionalWith(Align.annotations({ title: "\u5BF9\u9F50" }), { default: () => "left" }),
     // Swap the inherited single-string `binding` for the range union.
     binding: bindingSchema,

package/dist/runtime/components/table/columns/2026-07-16/com.shwfed.table.column.upload/config.vue

@@ -79,6 +79,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 };
+    }
+  }
+});
 function onHiddenChange(v) {
   if (v) {
     value.value = { ...value.value, hidden: true };
@@ -746,6 +757,27 @@ const DownloadScope = defineComponent({
           :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>
     </div>
 
     <div class="flex flex-wrap gap-x-8 gap-y-3">

package/dist/runtime/components/table/columns/2026-07-16/com.shwfed.table.column.upload/schema.d.ts

@@ -106,6 +106,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.upload"]>;

package/dist/runtime/components/table/columns/2026-07-16/com.shwfed.table.column.upload/schema.js

@@ -46,7 +46,7 @@ export function schema(configure) {
   return Schema.Struct({
     type: Schema.Literal(type),
     compatibilityDate: Schema.Literal(compatibilityDate),
-    ...editableColumnFields(),
+    ...editableColumnFields(configure),
     disabled: Schema.optional(CelBool.annotations({
       title: "\u7981\u7528\u6761\u4EF6",
       description: "\u8FD4\u56DE `true` \u65F6\u6DFB\u52A0\u6309\u94AE\u4ECD\u7136\u6E32\u67D3\u4F46\u4E0D\u53EF\u64CD\u4F5C"

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

@@ -8,6 +8,7 @@ declare module '@tanstack/vue-table' {
         grow?: boolean;
         editable?: boolean;
         readonlyExpr?: string;
+        required?: boolean;
     }
 }
 declare const _default: typeof __VLS_export;

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

@@ -213,9 +213,11 @@ function translateColumn(column) {
   const contribution = entry.toColumnDef(column, { getLocaleText, $cel, inheritedContext: celBindings(inheritedContext) });
   const editable = isEditableHeader(contribution.header);
   const readonlyExpr = editable ? column.readonly : void 0;
+  const requiredExpr = editable ? column.required : void 0;
+  const required = typeof requiredExpr === "string" && requiredExpr.trim().length > 0;
   return {
     ...contribution,
-    meta: { ...contribution.meta, editable, readonlyExpr },
+    meta: { ...contribution.meta, editable, readonlyExpr, required },
     id: column.id,
     // `ctx` is the functional-component props object Vue mutates in place on
     // every update, so its identity stays stable across data refetches.
@@ -998,6 +1000,15 @@ export { TableConfig, createTableConfig, getColumnTechnicalKey } from "./schema"
                         :props="header.getContext()"
                       />
 
+                      <!-- Required star: shown for editable columns carrying a
+                         non-empty `required` expression. Row-agnostic marker,
+                         mirrors the field-label star styling. -->
+                      <span
+                        v-if="!header.isPlaceholder && header.column.columnDef.meta?.required"
+                        aria-hidden="true"
+                        class="text-red-600"
+                      >*</span>
+
                       <!-- Edit affordance: marks an editable column, hidden when
                          the column reads as readonly (form-wide or its own
                          `readonly` condition). -->

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

@@ -8,6 +8,7 @@ declare module '@tanstack/vue-table' {
         grow?: boolean;
         editable?: boolean;
         readonlyExpr?: string;
+        required?: boolean;
     }
 }
 declare const _default: typeof __VLS_export;

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

@@ -43,7 +43,8 @@ export declare function columnFields(configure: (env: Environment) => void): {
     id: Schema.refine<string, typeof Schema.String>;
     groupId: Schema.optional<typeof Schema.UUID>;
 };
-export declare function editableColumnFields(): {
+export declare function editableRequiredField(configure: (env: Environment) => void): Schema.optional<Schema.Schema<string, string, never>>;
+export declare function editableColumnFields(configure: (env: Environment) => void): {
     title: Schema.suspend<readonly [{
         readonly locale: "zh";
         readonly message: string;
@@ -76,6 +77,7 @@ export declare function editableColumnFields(): {
         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>;
 };

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

@@ -59,7 +59,32 @@ export function columnFields(configure) {
     }))
   };
 }
-export function editableColumnFields() {
+function CelColumnRequired(configure) {
+  return Expression({
+    configure: (env) => {
+      configure(env);
+      const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
+      if (!declared.has("row")) {
+        env.registerVariable("row", "dyn", { label: "\u5F53\u524D\u884C", description: "\u5F53\u524D\u884C\u6570\u636E" });
+      }
+      if (!declared.has("index")) {
+        env.registerVariable("index", "number", { label: "\u884C\u5E8F\u53F7", description: "\u884C\u7D22\u5F15" });
+      }
+    },
+    resultType: "bool"
+  });
+}
+export function editableRequiredField(configure) {
+  return Schema.optional(CelColumnRequired(configure).annotations({
+    title: "\u5FC5\u586B",
+    description: md`
+      返回 \`true\` 时，该列**表头显示必填星号**。可访问 \`row\` / \`index\` / \`form\`，因此可写「部分行必填」的条件（例如 \`row.type == 'company'\`）。
+
+      **当前版本星号仅作视觉标识，不会拦截提交**——实际必填校验请在表格字段的「校验规则」中用 CEL 编写（可读整表 \`form.<绑定路径>\`）。后续版本将据此表达式自动完成逐行校验并拦截提交。
+    `
+  }));
+}
+export function editableColumnFields(configure) {
   return {
     ...columnIdentityFields(),
     title: Locale.annotations({ title: "\u540D\u79F0", description: "\u5217\u6807\u9898" }),
@@ -84,7 +109,8 @@ export function editableColumnFields() {
     hidden: Schema.optional(Schema.Boolean.annotations({
       title: "\u9ED8\u8BA4\u9690\u85CF",
       description: "\u5F00\u542F\u540E\u8BE5\u5217\u9ED8\u8BA4\u9690\u85CF\uFF1B\u4F7F\u7528\u8005\u53EF\u5728\u8868\u683C\u7684\u5217\u8BBE\u7F6E\u4E2D\u91CD\u65B0\u663E\u793A\u3002\u4EC5\u4F5C\u4E3A\u521D\u59CB\u72B6\u6001\uFF0C\u4E0D\u968F\u6570\u636E\u53D8\u5316"
-    }))
+    })),
+    required: editableRequiredField(configure)
   };
 }
 const EDITABLE_HEADER_MARKER = Symbol("shwfed-editable-header");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shwfed/config",
-  "version": "3.0.16",
+  "version": "3.0.18",
   "description": "Configurable UI for SHWFED",
   "type": "module",
   "publishConfig": {