@shwfed/config 2.4.0 → 2.4.1

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.date/config.vue

@@ -5,6 +5,7 @@ import { format as formatDate } from "date-fns";
 import { Button } from "../../../../ui/button";
 import { ExpressionEditor } from "../../../../ui/expression-editor";
 import DerivedValueEditor from "../../../DerivedValueEditor.vue";
+import ValidationRulesField from "../../../ValidationRulesField.vue";
 import { Field, FieldLabel } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText } from "../../../../ui/input-group";
 import { Locale as LocaleField } from "../../../../ui/locale";
@@ -410,6 +411,26 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
     </Field>
 
     <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>
@@ -489,5 +510,22 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
         @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-04-27/com.shwfed.form.field.date/config.vue.d.ts

@@ -22,6 +22,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -40,6 +41,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";
@@ -72,6 +84,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -90,6 +103,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.date/runtime.vue

@@ -7,9 +7,10 @@ import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
 import { DatePicker, DATE_PICKER_DEFAULT_FORMATS } from "../../../../ui/date-picker";
-import { Field, FieldLabel } from "../../../../ui/field";
+import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { Markdown } from "../../../../ui/markdown";
 import { DEFAULT_FIELD_ORIENTATION } from "../../../utils/common";
+import { useFieldValidation } from "../../../utils/validation";
 import { useFormReadonly } from "../../../utils/readonly";
 import { useFormState } from "../../../utils/state";
 defineOptions({ name: "ShwfedDateFieldRuntime" });
@@ -79,6 +80,12 @@ const model = computed({
     setAt(path, next);
   }
 });
+const { isRequired, errors, warnings, visible } = useFieldValidation({
+  fieldId: () => props.fieldId,
+  config: () => props.config,
+  $cel,
+  locale: () => locale.value
+});
 </script>
 
 <template>
@@ -100,7 +107,11 @@ const model = computed({
           class="prose prose-xs prose-zinc"
         />
       </template>
-      {{ labelText }}
+      {{ labelText }}<span
+        v-if="isRequired"
+        aria-hidden="true"
+        class="text-red-600"
+      > *</span>
     </FieldLabel>
     <div
       v-if="effectiveReadonly"
@@ -119,5 +130,10 @@ const model = computed({
       :disabled="isDisabled"
       :shortcuts="shortcuts"
     />
+    <FieldMessages
+      v-if="visible"
+      :errors="errors"
+      :warnings="warnings"
+    />
   </Field>
 </template>

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.date/schema.d.ts

@@ -73,6 +73,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.date"]>;
     compatibilityDate: Schema.Literal<["2026-04-27"]>;
 }>;

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

@@ -22,6 +22,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -49,6 +50,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";
@@ -82,6 +94,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -109,6 +122,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.daterange/config.vue

@@ -5,6 +5,7 @@ import { computed } from "vue";
 import { Button } from "../../../../ui/button";
 import { ExpressionEditor } from "../../../../ui/expression-editor";
 import DerivedValueEditor from "../../../DerivedValueEditor.vue";
+import ValidationRulesField from "../../../ValidationRulesField.vue";
 import { Field, FieldLabel } from "../../../../ui/field";
 import { IconPicker } from "../../../../ui/icon-picker";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupNumberField, InputGroupText } from "../../../../ui/input-group";
@@ -591,6 +592,26 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
     </Field>
 
     <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>
@@ -670,5 +691,22 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
         @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-04-27/com.shwfed.form.field.daterange/config.vue.d.ts

@@ -22,6 +22,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -49,6 +50,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";
@@ -82,6 +94,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -109,6 +122,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.daterange/runtime.vue

@@ -7,9 +7,10 @@ import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
 import { DATE_RANGE_PICKER_DEFAULT_FORMATS, DateRangePicker } from "../../../../ui/date-range-picker";
-import { Field, FieldLabel } from "../../../../ui/field";
+import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { Markdown } from "../../../../ui/markdown";
 import { DEFAULT_FIELD_ORIENTATION } from "../../../utils/common";
+import { useFieldValidation } from "../../../utils/validation";
 import { useFormReadonly } from "../../../utils/readonly";
 import { useFormState } from "../../../utils/state";
 defineOptions({ name: "ShwfedDateRangeFieldRuntime" });
@@ -104,6 +105,12 @@ const model = computed({
     setAt(binding[1], next?.[1]);
   }
 });
+const { isRequired, errors, warnings, visible } = useFieldValidation({
+  fieldId: () => props.fieldId,
+  config: () => props.config,
+  $cel,
+  locale: () => locale.value
+});
 const readonlyText = computed(() => {
   const v = model.value;
   if (!v) return "\u2014";
@@ -130,7 +137,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
       v-if="effectiveReadonly"
@@ -152,5 +163,10 @@ const readonlyText = computed(() => {
       :disabled="isDisabled"
       :shortcuts="shortcuts"
     />
+    <FieldMessages
+      v-if="visible"
+      :errors="errors"
+      :warnings="warnings"
+    />
   </Field>
 </template>

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.daterange/schema.d.ts

@@ -84,6 +84,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.daterange"]>;
     compatibilityDate: Schema.Literal<["2026-04-27"]>;
 }>;

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

@@ -22,6 +22,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -42,6 +43,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly hourCycle?: 12 | 24 | undefined;
         readonly valueFormat?: string | undefined;
         readonly timeGranularity?: "hour" | "minute" | "second" | 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";
@@ -74,6 +86,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -94,6 +107,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly hourCycle?: 12 | 24 | undefined;
         readonly valueFormat?: string | undefined;
         readonly timeGranularity?: "hour" | "minute" | "second" | 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetime/config.vue

@@ -5,6 +5,7 @@ import { format as formatDate } from "date-fns";
 import { Button } from "../../../../ui/button";
 import { ExpressionEditor } from "../../../../ui/expression-editor";
 import DerivedValueEditor from "../../../DerivedValueEditor.vue";
+import ValidationRulesField from "../../../ValidationRulesField.vue";
 import { Field, FieldLabel } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText } from "../../../../ui/input-group";
 import { Locale as LocaleField } from "../../../../ui/locale";
@@ -492,6 +493,26 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
     </div>
 
     <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>
@@ -571,5 +592,22 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
         @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-04-27/com.shwfed.form.field.datetime/config.vue.d.ts

@@ -22,6 +22,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -42,6 +43,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly hourCycle?: 12 | 24 | undefined;
         readonly valueFormat?: string | undefined;
         readonly timeGranularity?: "hour" | "minute" | "second" | 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";
@@ -74,6 +86,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-04-27";
         readonly orientation?: "vertical" | "floating" | undefined;
@@ -94,6 +107,17 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         readonly hourCycle?: 12 | 24 | undefined;
         readonly valueFormat?: string | undefined;
         readonly timeGranularity?: "hour" | "minute" | "second" | 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 presets?: readonly {
             readonly label: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetime/runtime.vue

@@ -7,9 +7,10 @@ import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
 import { DATE_PICKER_DEFAULT_FORMATS, DatePicker } from "../../../../ui/date-picker";
-import { Field, FieldLabel } from "../../../../ui/field";
+import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { Markdown } from "../../../../ui/markdown";
 import { DEFAULT_FIELD_ORIENTATION } from "../../../utils/common";
+import { useFieldValidation } from "../../../utils/validation";
 import { useFormReadonly } from "../../../utils/readonly";
 import { useFormState } from "../../../utils/state";
 defineOptions({ name: "ShwfedDateTimeFieldRuntime" });
@@ -79,6 +80,12 @@ const model = computed({
     setAt(path, next);
   }
 });
+const { isRequired, errors, warnings, visible } = useFieldValidation({
+  fieldId: () => props.fieldId,
+  config: () => props.config,
+  $cel,
+  locale: () => locale.value
+});
 </script>
 
 <template>
@@ -100,7 +107,11 @@ const model = computed({
           class="prose prose-xs prose-zinc"
         />
       </template>
-      {{ labelText }}
+      {{ labelText }}<span
+        v-if="isRequired"
+        aria-hidden="true"
+        class="text-red-600"
+      > *</span>
     </FieldLabel>
     <div
       v-if="effectiveReadonly"
@@ -121,5 +132,10 @@ const model = computed({
       :disabled="isDisabled"
       :shortcuts="shortcuts"
     />
+    <FieldMessages
+      v-if="visible"
+      :errors="errors"
+      :warnings="warnings"
+    />
   </Field>
 </template>

package/dist/runtime/components/form/fields/2026-04-27/com.shwfed.form.field.datetime/schema.d.ts

@@ -85,6 +85,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.datetime"]>;
     compatibilityDate: Schema.Literal<["2026-04-27"]>;
 }>;