@shwfed/config 2.4.0 → 2.5.0

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/config.vue.d.ts

@@ -33,6 +33,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
@@ -56,6 +57,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]];
         readonly expandAll: boolean;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
+        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 nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -96,6 +108,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
@@ -119,6 +132,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         }[]];
         readonly expandAll: boolean;
         readonly cascade: "independent" | "cascade-down" | "cascade-both";
+        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 nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/runtime.vue

@@ -8,7 +8,7 @@ import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
 import { Checkbox } from "../../../../ui/checkbox";
-import { Field, FieldLabel } from "../../../../ui/field";
+import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "../../../../ui/input-group";
 import { Markdown } from "../../../../ui/markdown";
 import { Skeleton } from "../../../../ui/skeleton";
@@ -16,6 +16,7 @@ import { Tree as UiTree } from "../../../../ui/tree";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
 import { useFormReadonly } from "../../../utils/readonly";
 import { useFormState } from "../../../utils/state";
+import { useFieldValidation } from "../../../utils/validation";
 defineOptions({ name: "ShwfedTreeMultiFieldRuntime" });
 const props = defineProps({
   fieldId: { type: String, required: true },
@@ -72,6 +73,12 @@ const isReadonly = computed(
   () => props.config.readonly != null ? evalBool(props.config.readonly, "readonly") : formReadonly.value
 );
 const effectiveReadonly = computed(() => isReadonly.value || props.config.derived?.mode === "formula");
+const { isRequired, errors, warnings, visible } = useFieldValidation({
+  fieldId: () => props.fieldId,
+  config: () => props.config,
+  $cel,
+  locale: () => locale.value
+});
 const uncontrolled = ref([]);
 const model = computed({
   get: () => {
@@ -292,7 +299,11 @@ const readonlyText = computed(() => {
           class="prose prose-xs prose-zinc"
         />
       </template>
-      {{ labelText }}
+      {{ labelText }}<span
+        v-if="isRequired"
+        aria-hidden="true"
+        class="text-red-600"
+      > *</span>
     </FieldLabel>
 
     <div
@@ -397,5 +408,10 @@ const readonlyText = computed(() => {
         </template>
       </UiTree>
     </template>
+    <FieldMessages
+      v-if="visible"
+      :errors="errors"
+      :warnings="warnings"
+    />
   </Field>
 </template>

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/schema.d.ts

@@ -93,6 +93,24 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     id: Schema.refine<string, typeof Schema.String>;
     displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
     hidden: Schema.optional<Schema.Schema<string, string, never>>;
+    required: Schema.optional<Schema.Schema<string, string, never>>;
+    validations: Schema.optional<Schema.Array$<Schema.Struct<{
+        when: Schema.Schema<string, string, never>;
+        warning: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+        message: Schema.refine<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], 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>;
+        }>]>>;
+    }>>>;
     type: Schema.Literal<["com.shwfed.form.field.tree.multi"]>;
     compatibilityDate: Schema.Literal<["2026-05-28"]>;
 }>;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.d.vue.ts

@@ -33,6 +33,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
@@ -55,6 +56,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly expandAll: boolean;
+        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 nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -95,6 +107,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
@@ -117,6 +130,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly expandAll: boolean;
+        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 nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.vue

@@ -2,6 +2,7 @@
 import { computed } from "vue";
 import { ExpressionEditor } from "../../../../ui/expression-editor";
 import DerivedValueEditor from "../../../DerivedValueEditor.vue";
+import ValidationRulesField from "../../../ValidationRulesField.vue";
 import { Field, FieldLabel } from "../../../../ui/field";
 import { InputGroup, InputGroupInput } from "../../../../ui/input-group";
 import { Locale as LocaleField } from "../../../../ui/locale";
@@ -477,6 +478,26 @@ function setFilterKeywords(next) {
 
     <!-- 通用：隐藏 / 禁用 / 只读 + 派生值 — conventionally last -->
     <div class="grid grid-cols-3 gap-3">
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('required') ?? '\u8FD4\u56DE `true` \u65F6\u663E\u793A\u5FC5\u586B\u661F\u53F7\u5E76\u8981\u6C42\u975E\u7A7A'"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("required") }}
+        </FieldLabel>
+        <ExpressionEditor
+          :model-value="value.required ?? ''"
+          placeholder="例：form.type == 'company'"
+          result-type="bool"
+          class="min-h-10"
+          @update:model-value="(v) => value = { ...value, required: v.length > 0 ? v : void 0 }"
+        />
+      </Field>
+
       <Field orientation="vertical">
         <FieldLabel class="text-xs text-zinc-500">
           <template #tooltip>
@@ -556,5 +577,22 @@ function setFilterKeywords(next) {
         @update:model-value="(v) => value = { ...value, derived: v }"
       />
     </Field>
+
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template #tooltip>
+          <Markdown
+            :source="fieldDescription('validations')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("validations") }}
+      </FieldLabel>
+      <ValidationRulesField
+        :model-value="value.validations"
+        @update:model-value="(v) => value = { ...value, validations: v.length > 0 ? v : void 0 }"
+      />
+    </Field>
   </div>
 </template>

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/config.vue.d.ts

@@ -33,6 +33,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
@@ -55,6 +56,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly expandAll: boolean;
+        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 nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -95,6 +107,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly required?: string | undefined;
         readonly displayName?: string | undefined;
         readonly compatibilityDate: "2026-05-28";
         readonly readonly?: string | undefined;
@@ -117,6 +130,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly message: string;
         }[]];
         readonly expandAll: boolean;
+        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 nodeTooltip?: readonly [{
             readonly locale: "zh";
             readonly message: string;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/runtime.vue

@@ -7,7 +7,7 @@ import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
-import { Field, FieldLabel } from "../../../../ui/field";
+import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "../../../../ui/input-group";
 import { Markdown } from "../../../../ui/markdown";
 import { Skeleton } from "../../../../ui/skeleton";
@@ -15,6 +15,7 @@ import { Tree as UiTree } from "../../../../ui/tree";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
 import { useFormReadonly } from "../../../utils/readonly";
 import { useFormState } from "../../../utils/state";
+import { useFieldValidation } from "../../../utils/validation";
 defineOptions({ name: "ShwfedTreeSingleFieldRuntime" });
 const props = defineProps({
   fieldId: { type: String, required: true },
@@ -68,6 +69,12 @@ const isReadonly = computed(
   () => props.config.readonly != null ? evalBool(props.config.readonly, "readonly") : formReadonly.value
 );
 const effectiveReadonly = computed(() => isReadonly.value || props.config.derived?.mode === "formula");
+const { isRequired, errors, warnings, visible } = useFieldValidation({
+  fieldId: () => props.fieldId,
+  config: () => props.config,
+  $cel,
+  locale: () => locale.value
+});
 const uncontrolled = ref(void 0);
 const model = computed({
   get: () => {
@@ -288,7 +295,11 @@ const readonlyText = computed(() => {
           class="prose prose-xs prose-zinc"
         />
       </template>
-      {{ labelText }}
+      {{ labelText }}<span
+        v-if="isRequired"
+        aria-hidden="true"
+        class="text-red-600"
+      > *</span>
     </FieldLabel>
 
     <div
@@ -391,5 +402,10 @@ const readonlyText = computed(() => {
         </template>
       </UiTree>
     </template>
+    <FieldMessages
+      v-if="visible"
+      :errors="errors"
+      :warnings="warnings"
+    />
   </Field>
 </template>

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/schema.d.ts

@@ -89,6 +89,24 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     id: Schema.refine<string, typeof Schema.String>;
     displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
     hidden: Schema.optional<Schema.Schema<string, string, never>>;
+    required: Schema.optional<Schema.Schema<string, string, never>>;
+    validations: Schema.optional<Schema.Array$<Schema.Struct<{
+        when: Schema.Schema<string, string, never>;
+        warning: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+        message: Schema.refine<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], 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>;
+        }>]>>;
+    }>>>;
     type: Schema.Literal<["com.shwfed.form.field.tree.single"]>;
     compatibilityDate: Schema.Literal<["2026-05-28"]>;
 }>;

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

@@ -13,6 +13,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     seeded: Promise<void>;
     flush: () => void;
     settled: () => Promise<void>;
+    validate: () => Promise<boolean>;
     undo: () => void;
     redo: () => void;
     canUndo: import("vue").Ref<boolean, boolean>;

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

@@ -10,12 +10,15 @@ import {
   provideCELContext
 } from "../../utils/cel-context";
 import FormUnitRenderer from "./FormUnitRenderer.vue";
+import { buildFormRuntimeScope } from "./utils/cel-scope";
 import { provideCommitBus } from "./utils/commit-bus";
 import { provideDerivedQuiescence, useDerived } from "./utils/derived";
 import { useFormHistory } from "./utils/history";
 import { evaluateInitial } from "./utils/initial";
+import { provideFormValidate } from "../../share/form-validate";
 import { provideFormReadonly } from "./utils/readonly";
 import { provideFormState } from "./utils/state";
+import { provideValidation } from "./utils/validation";
 defineOptions({ name: "ShwfedForm" });
 const state = defineModel({ type: Object, ...{ default: () => ({}) } });
 const config = defineModel("config", { type: Object, ...{ required: true } });
@@ -25,24 +28,10 @@ const props = defineProps({
 const configure = props.configure ?? (() => {
 });
 void configure;
-provideCELContext({
-  form: {
-    type: "dyn",
-    label: "form",
-    description: "\u5F53\u524D\u8868\u5355\u72B6\u6001",
-    value: () => state.value ?? {}
-  },
-  // Same thunk pattern: `now` stays live (fresh Date at click time, not at
-  // provide time). Must be a `TZDate`: CEL's type registry maps the `Date`
-  // type to the `TZDate` constructor exactly, so a plain `new Date()` fails
-  // the constructor lookup.
-  now: {
-    type: "Date",
-    label: "now",
-    description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4",
-    value: () => new TZDate()
-  }
-});
+provideCELContext(buildFormRuntimeScope({
+  form: () => state.value ?? {},
+  now: () => new TZDate()
+}));
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
 const formState = provideFormState(state);
@@ -82,11 +71,18 @@ useDerived({
   formState,
   quiescence
 });
+const validation = provideValidation({
+  flush: commitBus.flushAll,
+  seeded,
+  settled: quiescence.settled
+});
+provideFormValidate(validation.validate);
 const formHistory = useFormHistory(state, { quiescence, seeded, dirty: formState.dirty });
 defineExpose({
   seeded,
   flush: commitBus.flushAll,
   settled: quiescence.settled,
+  validate: validation.validate,
   undo: formHistory.undo,
   redo: formHistory.redo,
   canUndo: formHistory.canUndo,

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

@@ -13,6 +13,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     seeded: Promise<void>;
     flush: () => void;
     settled: () => Promise<void>;
+    validate: () => Promise<boolean>;
     undo: () => void;
     redo: () => void;
     canUndo: import("vue").Ref<boolean, boolean>;

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

@@ -1,6 +1,7 @@
 import { Schema } from 'effect';
 import type { Environment } from '../../vendor/cel-js/lib/index.js';
 import type { InitialSource } from './utils/initial.js';
+import { registerFormVariablesIfAbsent } from './utils/form-vars.js';
 import { type LayoutSetValue } from '../../share/layout.js';
 export { commonFieldFields } from './utils/common.js';
 export { getStructFieldTitle, getStructFieldDescription } from './utils/schema-meta.js';
@@ -69,16 +70,7 @@ 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 { registerFormVariablesIfAbsent };
 export declare function FormConfig(configure: (env: Environment) => void): Schema.refine<{
     readonly style?: string | undefined;
     readonly initial?: {

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

@@ -1,6 +1,7 @@
 import { Schema } from "effect";
 import { Expression } from "../../share/expression.js";
 import { allFieldSchemas } from "./utils/resolve.js";
+import { registerFormVariablesIfAbsent } from "./utils/form-vars.js";
 import { md } from "../../share/markdown.js";
 import {
   LayoutSet,
@@ -37,11 +38,7 @@ 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 { registerFormVariablesIfAbsent };
 export function FormConfig(configure) {
   const formConfigure = (env) => {
     registerFormVariablesIfAbsent(env);

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

@@ -2,12 +2,21 @@ 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).
+ * AI assists. Probes the form-wide `form` / `now` registrar
+ * (`registerFormVariablesIfAbsent` — the single source of truth, also feeding
+ * every field's expression validator) plus the host's `configure` to surface
+ * host-registered variables.
  *
  * 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;
+/**
+ * Builds the runtime form-wide scope provided by `form/index.vue`. The `form` /
+ * `now` metadata (type/label/description) is probed from the same
+ * `registerFormVariablesIfAbsent` registrar as the designer scope above, so the
+ * two can't drift; `values` overlays the live evaluation thunks the designer
+ * scope leaves `undefined`, keyed by variable name.
+ */
+export declare function buildFormRuntimeScope(values: Record<string, () => unknown>): CELContext;

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

@@ -1,24 +1,10 @@
 import { Environment } from "../../../vendor/cel-js/lib/index.js";
-export function buildFormCelScope(configure) {
+import { registerFormVariablesIfAbsent } from "./form-vars.js";
+function probeCELContext(register) {
   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
-    }
-  };
+  register(probe);
+  const out = {};
   for (const v of probe.getDefinitions().variables) {
     if (baseline.has(v.name)) continue;
     out[v.name] = {
@@ -30,3 +16,16 @@ export function buildFormCelScope(configure) {
   }
   return out;
 }
+export function buildFormCelScope(configure) {
+  return probeCELContext((env) => {
+    registerFormVariablesIfAbsent(env);
+    configure(env);
+  });
+}
+export function buildFormRuntimeScope(values) {
+  const out = probeCELContext(registerFormVariablesIfAbsent);
+  for (const [name, value] of Object.entries(values)) {
+    if (out[name]) out[name].value = value;
+  }
+  return out;
+}

package/dist/runtime/components/form/utils/common.d.ts

@@ -1,9 +1,51 @@
 import { Schema } from 'effect';
 import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+/**
+ * One field-owned validation rule. Extracted so the config editor
+ * (`ValidationRulesField`) can read the `when` / `message` `@title` +
+ * `@description` straight off this struct — single source of truth, no
+ * duplicated label/tooltip copy. `configure` only shapes the CEL environment;
+ * the annotations are static, so a no-op `configure` is fine for metadata.
+ */
+export declare function validationRuleStruct(configure: (env: Environment) => void): Schema.Struct<{
+    when: Schema.Schema<string, string, never>;
+    warning: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    message: Schema.refine<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], 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>;
+    }>]>>;
+}>;
 export declare function commonFieldFields(configure: (env: Environment) => void): {
     id: Schema.refine<string, typeof Schema.String>;
     displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
     hidden: Schema.optional<Schema.Schema<string, string, never>>;
+    required: Schema.optional<Schema.Schema<string, string, never>>;
+    validations: Schema.optional<Schema.Array$<Schema.Struct<{
+        when: Schema.Schema<string, string, never>;
+        warning: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+        message: Schema.refine<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], 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>;
+        }>]>>;
+    }>>>;
 };
 export declare const FIELD_ORIENTATIONS: readonly ["vertical", "floating"];
 export type FieldOrientation = typeof FIELD_ORIENTATIONS[number];