@tmagic/form 1.8.0-beta.18 → 1.8.0-beta.19

package/dist/es/Form.vue_vue_type_script_setup_true_lang.js

@@ -21,6 +21,10 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 		parentValues: { default: () => ({}) },
 		labelWidth: { default: "200px" },
 		typeMatchValid: { type: Boolean },
+		validateOnInit: {
+			type: Boolean,
+			default: false
+		},
 		disabled: {
 			type: Boolean,
 			default: false
@@ -218,7 +222,7 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 			}).then((value) => {
 				values.value = value;
 				initialized.value = !props.isCompare;
-				nextTick(() => {
+				if (props.validateOnInit) nextTick(() => {
 					tMagicFormRef.value?.validate();
 				});
 			});

package/dist/es/FormBox.vue_vue_type_script_setup_true_lang.js

@@ -14,6 +14,10 @@ var FormBox_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		height: {},
 		labelWidth: {},
 		typeMatchValid: { type: Boolean },
+		validateOnInit: {
+			type: Boolean,
+			default: false
+		},
 		disabled: { type: Boolean },
 		size: {},
 		confirmText: { default: "确定" },
@@ -90,6 +94,7 @@ var FormBox_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 					"use-field-text-in-error": __props.useFieldTextInError,
 					"extend-state": __props.extendState,
 					"type-match-valid": __props.typeMatchValid,
+					"validate-on-init": __props.validateOnInit,
 					onChange: changeHandler
 				}, null, 8, [
 					"size",
@@ -103,7 +108,8 @@ var FormBox_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 					"prevent-submit-default",
 					"use-field-text-in-error",
 					"extend-state",
-					"type-match-valid"
+					"type-match-valid",
+					"validate-on-init"
 				]), renderSlot(_ctx.$slots, "default")]),
 				_: 3
 			})], 4), createElementVNode("div", {

package/dist/es/FormDialog.vue_vue_type_script_setup_true_lang.js

@@ -13,6 +13,10 @@ var FormDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		width: {},
 		labelWidth: {},
 		typeMatchValid: { type: Boolean },
+		validateOnInit: {
+			type: Boolean,
+			default: false
+		},
 		fullscreen: { type: Boolean },
 		disabled: { type: Boolean },
 		title: {},
@@ -203,6 +207,7 @@ var FormDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"prevent-submit-default": __props.preventSubmitDefault,
 					"use-field-text-in-error": __props.useFieldTextInError,
 					"type-match-valid": __props.typeMatchValid,
+					"validate-on-init": __props.validateOnInit,
 					"extend-state": __props.extendState,
 					theme: effectiveTheme.value,
 					onChange: changeHandler
@@ -219,6 +224,7 @@ var FormDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"prevent-submit-default",
 					"use-field-text-in-error",
 					"type-match-valid",
+					"validate-on-init",
 					"extend-state",
 					"theme"
 				]), renderSlot(_ctx.$slots, "default")], 4)) : createCommentVNode("v-if", true)]),

package/dist/es/FormDrawer.vue_vue_type_script_setup_true_lang.js

@@ -13,6 +13,10 @@ var FormDrawer_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		width: {},
 		labelWidth: {},
 		typeMatchValid: { type: Boolean },
+		validateOnInit: {
+			type: Boolean,
+			default: false
+		},
 		disabled: { type: Boolean },
 		closeOnPressEscape: {
 			type: Boolean,
@@ -180,6 +184,7 @@ var FormDrawer_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"prevent-submit-default": __props.preventSubmitDefault,
 					"use-field-text-in-error": __props.useFieldTextInError,
 					"type-match-valid": __props.typeMatchValid,
+					"validate-on-init": __props.validateOnInit,
 					"extend-state": __props.extendState,
 					theme: effectiveTheme.value,
 					onChange: changeHandler
@@ -195,6 +200,7 @@ var FormDrawer_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"prevent-submit-default",
 					"use-field-text-in-error",
 					"type-match-valid",
+					"validate-on-init",
 					"extend-state",
 					"theme"
 				]), renderSlot(_ctx.$slots, "default")], 512)) : createCommentVNode("v-if", true)]),

package/dist/tmagic-form.umd.cjs

@@ -4125,6 +4125,10 @@
 			parentValues: { default: () => ({}) },
 			labelWidth: { default: "200px" },
 			typeMatchValid: { type: Boolean },
+			validateOnInit: {
+				type: Boolean,
+				default: false
+			},
 			disabled: {
 				type: Boolean,
 				default: false
@@ -4322,7 +4326,7 @@
 				}).then((value) => {
 					values.value = value;
 					initialized.value = !props.isCompare;
-					(0, vue.nextTick)(() => {
+					if (props.validateOnInit) (0, vue.nextTick)(() => {
 						tMagicFormRef.value?.validate();
 					});
 				});
@@ -4952,6 +4956,10 @@
 			width: {},
 			labelWidth: {},
 			typeMatchValid: { type: Boolean },
+			validateOnInit: {
+				type: Boolean,
+				default: false
+			},
 			fullscreen: { type: Boolean },
 			disabled: { type: Boolean },
 			title: {},
@@ -5142,6 +5150,7 @@
 						"prevent-submit-default": __props.preventSubmitDefault,
 						"use-field-text-in-error": __props.useFieldTextInError,
 						"type-match-valid": __props.typeMatchValid,
+						"validate-on-init": __props.validateOnInit,
 						"extend-state": __props.extendState,
 						theme: effectiveTheme.value,
 						onChange: changeHandler
@@ -5158,6 +5167,7 @@
 						"prevent-submit-default",
 						"use-field-text-in-error",
 						"type-match-valid",
+						"validate-on-init",
 						"extend-state",
 						"theme"
 					]), (0, vue.renderSlot)(_ctx.$slots, "default")], 4)) : (0, vue.createCommentVNode)("v-if", true)]),
@@ -5192,6 +5202,10 @@
 			width: {},
 			labelWidth: {},
 			typeMatchValid: { type: Boolean },
+			validateOnInit: {
+				type: Boolean,
+				default: false
+			},
 			disabled: { type: Boolean },
 			closeOnPressEscape: {
 				type: Boolean,
@@ -5359,6 +5373,7 @@
 						"prevent-submit-default": __props.preventSubmitDefault,
 						"use-field-text-in-error": __props.useFieldTextInError,
 						"type-match-valid": __props.typeMatchValid,
+						"validate-on-init": __props.validateOnInit,
 						"extend-state": __props.extendState,
 						theme: effectiveTheme.value,
 						onChange: changeHandler
@@ -5374,6 +5389,7 @@
 						"prevent-submit-default",
 						"use-field-text-in-error",
 						"type-match-valid",
+						"validate-on-init",
 						"extend-state",
 						"theme"
 					]), (0, vue.renderSlot)(_ctx.$slots, "default")], 512)) : (0, vue.createCommentVNode)("v-if", true)]),
@@ -5406,6 +5422,10 @@
 			height: {},
 			labelWidth: {},
 			typeMatchValid: { type: Boolean },
+			validateOnInit: {
+				type: Boolean,
+				default: false
+			},
 			disabled: { type: Boolean },
 			size: {},
 			confirmText: { default: "确定" },
@@ -5482,6 +5502,7 @@
 						"use-field-text-in-error": __props.useFieldTextInError,
 						"extend-state": __props.extendState,
 						"type-match-valid": __props.typeMatchValid,
+						"validate-on-init": __props.validateOnInit,
 						onChange: changeHandler
 					}, null, 8, [
 						"size",
@@ -5495,7 +5516,8 @@
 						"prevent-submit-default",
 						"use-field-text-in-error",
 						"extend-state",
-						"type-match-valid"
+						"type-match-valid",
+						"validate-on-init"
 					]), (0, vue.renderSlot)(_ctx.$slots, "default")]),
 					_: 3
 				})], 4), (0, vue.createElementVNode)("div", {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0-beta.18",
+  "version": "1.8.0-beta.19",
   "name": "@tmagic/form",
   "type": "module",
   "sideEffects": [
@@ -52,9 +52,9 @@
   "peerDependencies": {
     "vue": "^3.5.40",
     "typescript": "^6.0.3",
-    "@tmagic/design": "1.8.0-beta.18",
-    "@tmagic/utils": "1.8.0-beta.18",
-    "@tmagic/form-schema": "1.8.0-beta.18"
+    "@tmagic/design": "1.8.0-beta.19",
+    "@tmagic/form-schema": "1.8.0-beta.19",
+    "@tmagic/utils": "1.8.0-beta.19"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/Form.vue

@@ -88,6 +88,13 @@ const props = withDefaults(
     labelWidth?: string;
     /** 是否开启类型匹配校验 */
     typeMatchValid?: boolean;
+    /**
+     * 初始化（`config` / `initValues` 就绪）后是否立即执行一次表单校验。
+     *
+     * - `false`（默认）：不自动校验，避免打开表单时就展示错误态；
+     * - `true`：初始化完成后在 `nextTick` 中调用 `validate()`。
+     */
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -156,6 +163,7 @@ const props = withDefaults(
     labelPosition: 'right',
     keyProp: '__key',
     useFieldTextInError: true,
+    validateOnInit: false,
   },
 );
 
@@ -353,9 +361,11 @@ watch(
       // 非对比模式，初始化完成
       initialized.value = !props.isCompare;
 
-      nextTick(() => {
-        tMagicFormRef.value?.validate();
-      });
+      if (props.validateOnInit) {
+        nextTick(() => {
+          tMagicFormRef.value?.validate();
+        });
+      }
     });
 
     if (props.isCompare) {

package/src/FormBox.vue

@@ -16,6 +16,7 @@
           :use-field-text-in-error="useFieldTextInError"
           :extend-state="extendState"
           :type-match-valid="typeMatchValid"
+          :validate-on-init="validateOnInit"
           @change="changeHandler"
         ></Form>
         <slot></slot>
@@ -59,6 +60,8 @@ const props = withDefaults(
     labelWidth?: string;
     /** 是否开启类型匹配校验 */
     typeMatchValid?: boolean;
+    /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+    validateOnInit?: boolean;
     disabled?: boolean;
     size?: 'small' | 'default' | 'large';
     confirmText?: string;
@@ -74,6 +77,7 @@ const props = withDefaults(
     values: () => ({}),
     confirmText: '确定',
     useFieldTextInError: true,
+    validateOnInit: false,
   },
 );
 

package/src/FormDialog.vue

@@ -33,6 +33,7 @@
         :prevent-submit-default="preventSubmitDefault"
         :use-field-text-in-error="useFieldTextInError"
         :type-match-valid="typeMatchValid"
+        :validate-on-init="validateOnInit"
         :extend-state="extendState"
         :theme="effectiveTheme"
         @change="changeHandler"
@@ -87,6 +88,8 @@ const props = withDefaults(
     labelWidth?: string;
     /** 是否开启类型匹配校验 */
     typeMatchValid?: boolean;
+    /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+    validateOnInit?: boolean;
     fullscreen?: boolean;
     disabled?: boolean;
     title?: string;
@@ -122,6 +125,7 @@ const props = withDefaults(
     showClose: true,
     showCancel: true,
     useFieldTextInError: true,
+    validateOnInit: false,
   },
 );
 

package/src/FormDrawer.vue

@@ -30,6 +30,7 @@
         :prevent-submit-default="preventSubmitDefault"
         :use-field-text-in-error="useFieldTextInError"
         :type-match-valid="typeMatchValid"
+        :validate-on-init="validateOnInit"
         :extend-state="extendState"
         :theme="effectiveTheme"
         @change="changeHandler"
@@ -78,6 +79,8 @@ const props = withDefaults(
     labelWidth?: string;
     /** 是否开启类型匹配校验 */
     typeMatchValid?: boolean;
+    /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+    validateOnInit?: boolean;
     disabled?: boolean;
     closeOnPressEscape?: boolean;
     title?: string;
@@ -106,6 +109,7 @@ const props = withDefaults(
     values: () => ({}),
     confirmText: '确定',
     useFieldTextInError: true,
+    validateOnInit: false,
   },
 );
 

package/types/index.d.ts

@@ -325,6 +325,13 @@ type __VLS_Props$30 = {
   parentValues?: Record<string, any>;
   labelWidth?: string; /** 是否开启类型匹配校验 */
   typeMatchValid?: boolean;
+  /**
+   * 初始化（`config` / `initValues` 就绪）后是否立即执行一次表单校验。
+   *
+   * - `false`（默认）：不自动校验，避免打开表单时就展示错误态；
+   * - `true`：初始化完成后在 `nextTick` 中调用 `validate()`。
+   */
+  validateOnInit?: boolean;
   disabled?: boolean;
   height?: string;
   stepActive?: string | number;
@@ -435,6 +442,7 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   keyProp: string;
   parentValues: Record<string, any>;
   stepActive: string | number;
+  validateOnInit: boolean;
   useFieldTextInError: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$30: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
@@ -452,7 +460,8 @@ type __VLS_Props$29 = {
   parentValues?: Object;
   width?: string | number;
   labelWidth?: string; /** 是否开启类型匹配校验 */
-  typeMatchValid?: boolean;
+  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   fullscreen?: boolean;
   disabled?: boolean;
   title?: string;
@@ -496,6 +505,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
       readonly typeMatchValid?: boolean | undefined;
+      readonly validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -540,6 +550,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       parentValues?: Record<string, any>;
       labelWidth?: string;
       typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -594,6 +605,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      validateOnInit: boolean;
       useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
@@ -628,6 +640,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    validateOnInit: boolean;
     useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
@@ -637,6 +650,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     parentValues?: Record<string, any>;
     labelWidth?: string;
     typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -661,7 +675,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
+  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -685,6 +699,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
       readonly typeMatchValid?: boolean | undefined;
+      readonly validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -729,6 +744,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       parentValues?: Record<string, any>;
       labelWidth?: string;
       typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -783,6 +799,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      validateOnInit: boolean;
       useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
@@ -817,6 +834,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    validateOnInit: boolean;
     useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
@@ -826,6 +844,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     parentValues?: Record<string, any>;
     labelWidth?: string;
     typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -850,7 +869,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
+  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -887,6 +906,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   destroyOnClose: boolean;
   showClose: boolean;
   config: schema_d_exports.FormConfig;
+  validateOnInit: boolean;
   useFieldTextInError: boolean;
   confirmText: string;
   showCancel: boolean;
@@ -906,7 +926,8 @@ type __VLS_Props$28 = {
   parentValues?: Object;
   width?: string | number;
   labelWidth?: string; /** 是否开启类型匹配校验 */
-  typeMatchValid?: boolean;
+  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   disabled?: boolean;
   closeOnPressEscape?: boolean;
   title?: string;
@@ -946,6 +967,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
       readonly typeMatchValid?: boolean | undefined;
+      readonly validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -990,6 +1012,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       parentValues?: Record<string, any>;
       labelWidth?: string;
       typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1044,6 +1067,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      validateOnInit: boolean;
       useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
@@ -1078,6 +1102,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    validateOnInit: boolean;
     useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
@@ -1087,6 +1112,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     parentValues?: Record<string, any>;
     labelWidth?: string;
     typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1111,7 +1137,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
+  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1135,6 +1161,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
       readonly typeMatchValid?: boolean | undefined;
+      readonly validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1179,6 +1206,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       parentValues?: Record<string, any>;
       labelWidth?: string;
       typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1233,6 +1261,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      validateOnInit: boolean;
       useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
@@ -1267,6 +1296,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    validateOnInit: boolean;
     useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
@@ -1276,6 +1306,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     parentValues?: Record<string, any>;
     labelWidth?: string;
     typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1300,7 +1331,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
+  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1342,6 +1373,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   values: Object;
   closeOnPressEscape: boolean;
   config: schema_d_exports.FormConfig;
+  validateOnInit: boolean;
   useFieldTextInError: boolean;
   confirmText: string;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
@@ -1361,7 +1393,8 @@ type __VLS_Props$27 = {
   width?: number;
   height?: number;
   labelWidth?: string; /** 是否开启类型匹配校验 */
-  typeMatchValid?: boolean;
+  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   disabled?: boolean;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
@@ -1391,6 +1424,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
       readonly typeMatchValid?: boolean | undefined;
+      readonly validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1435,6 +1469,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       parentValues?: Record<string, any>;
       labelWidth?: string;
       typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1489,6 +1524,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      validateOnInit: boolean;
       useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
@@ -1523,6 +1559,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    validateOnInit: boolean;
     useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
@@ -1532,6 +1569,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     parentValues?: Record<string, any>;
     labelWidth?: string;
     typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1556,7 +1594,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
+  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1580,6 +1618,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
       readonly typeMatchValid?: boolean | undefined;
+      readonly validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1624,6 +1663,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       parentValues?: Record<string, any>;
       labelWidth?: string;
       typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1678,6 +1718,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      validateOnInit: boolean;
       useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
@@ -1712,6 +1753,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    validateOnInit: boolean;
     useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
@@ -1721,6 +1763,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     parentValues?: Record<string, any>;
     labelWidth?: string;
     typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1745,7 +1788,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
+  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1773,6 +1816,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
 }>, {
   values: Object;
   config: schema_d_exports.FormConfig;
+  validateOnInit: boolean;
   useFieldTextInError: boolean;
   confirmText: string;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;