@tmagic/form 1.8.0-beta.11 → 1.8.0-beta.12

package/types/index.d.ts

@@ -1,10 +1,10 @@
-import { App, AppContext, Component, InjectionKey } from "vue";
+import { App, AppContext, Component, ComputedRef, InjectionKey } from "vue";
 import { FlexLayoutConfig, FormItemConfig, GroupListConfig, TableConfig } from "@tmagic/form-schema";
 export * from "@tmagic/form-schema";
 
 //#region \0rolldown/runtime.js
 declare namespace schema_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
+  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
 }
 import * as import__tmagic_form_schema from "@tmagic/form-schema";
 /**
@@ -33,6 +33,7 @@ interface FormDiffConfig {
   selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
 }
 declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
+declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
 interface ValidateError {
   message: string;
   field: string;
@@ -116,9 +117,10 @@ interface SubmitFormOptions {
    *   调试模式下 `timeout` 不生效（等待人工操作）。
    */
   debug?: boolean;
+  typeMatchValid?: boolean;
 }
 /**
- * 开启 `returnChangeRecords` 时 submitForm 的返回结果
+ * 开启 `returnChangeNodes` 时 submitForm 的返回结果
  */
 interface SubmitFormResult {
   /** 校验通过后的表单值 */
@@ -163,12 +165,91 @@ interface SubmitFormResult {
  * ```
  */
 declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
+/**
+ * validateForm 函数参数（与 Form.vue 组件 props 对齐，取校验所需子集）
+ */
+interface ValidateFormOptions {
+  /** 表单配置 */
+  config: schema_d_exports.FormConfig;
+  /** 待校验的表单值 */
+  initValues?: Record<string, any>;
+  parentValues?: Record<string, any>;
+  labelWidth?: string;
+  keyProp?: string;
+  /**
+   * 校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   * 默认 `true`，置为 `false` 时直接使用字段 name。
+   */
+  useFieldTextInError?: boolean;
+  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 父级应用上下文，用于继承全局组件、指令、provide 等。
+   * 通常通过 `app._context` 或 `getCurrentInstance()?.appContext` 获取。
+   */
+  appContext?: AppContext | null;
+  /** 等待表单初始化的最长时间（毫秒），超时将以错误 reject。默认 10000ms */
+  timeout?: number;
+  /**
+   * 调试模式。默认 `false`。
+   *
+   * - `false`：以隐藏方式挂载，初始化完成后自动校验并 resolve 错误文案（原有静默行为）。
+   * - `true`：将表单以弹层形式可见地渲染在页面上，需手动点击「确定」才会触发校验，
+   *   点击「取消」则以 reject 中断；校验失败时在弹层内展示错误信息并保留弹层，便于修正后重试，
+   *   校验通过则 resolve 空字符串。调试模式下 `timeout` 不生效（等待人工操作）。
+   */
+  debug?: boolean;
+  typeMatchValid?: boolean;
+}
+/**
+ * 以命令式方式对一份「表单配置 + 值」做一次静默校验，**不依赖也不影响任何已渲染的表单**。
+ *
+ * 与 `submitForm` 类似，内部会临时挂载一个不可见的 MForm 实例，等待其初始化完成后调用
+ * 实例的 `validate` 方法，返回汇总后的错误文案，随后自动卸载实例。
+ *
+ * 与 `submitForm` 的区别：
+ * - 「静默」：校验失败不抛异常、不触发 `error` 事件、不返回表单值；
+ * - 仅用于「探测」配置是否合法，适合源码保存后校验、批量校验组件配置等场景。
+ *
+ * 由于每次都新建一个独立的 MForm 实例，调用方无需持有任何表单 ref，也不会污染
+ * 页面上正在展示的表单状态。
+ *
+ * @returns 校验通过返回空字符串 `''`，否则返回以 `<br>` 拼接的错误文案。
+ *   仅在初始化超时或挂载失败等异常情况下才会 reject。
+ *
+ * @example
+ * ```ts
+ * import { validateForm } from '@tmagic/form';
+ *
+ * const error = await validateForm({
+ *   config: [...],
+ *   initValues: { name: 'foo' },
+ *   appContext: getCurrentInstance()?.appContext,
+ * });
+ * if (error) {
+ *   // 配置不合法，error 为错误文案
+ * }
+ *
+ * // 调试模式：可见地渲染表单，点击「确定」才校验，校验失败保留弹层可修正重试：
+ * const error = await validateForm({
+ *   config: [...],
+ *   initValues: { name: 'foo' },
+ *   debug: true,
+ * });
+ * ```
+ */
+declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
 //#endregion
 //#region temp/packages/form/src/utils/form.d.ts
+type AsyncValidatorFn = (rule: any, value: any, callback: Function, source?: any, options?: any) => any;
+/**
+ * 将 async-validator（Element Plus）风格的 validator 适配到当前 UI 库。
+ * TDesign 调用签名为 `(val) => boolean | CustomValidateObj | Promise`，无 callback。
+ */
+declare const adaptFormValidator: (validator: AsyncValidatorFn) => AsyncValidatorFn;
 declare const createValues: (mForm: schema_d_exports.FormState | undefined, config?: schema_d_exports.FormConfig | schema_d_exports.TabPaneConfig[], initValue?: schema_d_exports.FormValue, value?: schema_d_exports.FormValue) => schema_d_exports.FormValue;
 declare const filterFunction: <T = any>(mForm: schema_d_exports.FormState | undefined, config: T | schema_d_exports.FilterFunction<T> | undefined, props: any) => T | undefined;
 declare const display: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => any;
-declare const getRules: (mForm: schema_d_exports.FormState | undefined, rules: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any) => schema_d_exports.Rule[];
+declare const getRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: ComputedRef<boolean>) => schema_d_exports.Rule[];
 declare const initValue: (mForm: schema_d_exports.FormState | undefined, {
   initValues,
   config
@@ -196,7 +277,8 @@ type __VLS_Props$30 = {
   lastValues?: Record<string, any>; /** 是否开启对比模式 */
   isCompare?: boolean;
   parentValues?: Record<string, any>;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
   disabled?: boolean;
   height?: string;
   stepActive?: string | number;
@@ -255,6 +337,23 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
   resetForm: () => void;
   submitForm: (native?: boolean) => Promise<any>;
+  /**
+   * 校验：对表单当前值执行校验，返回汇总后的错误文案。
+   *
+   * 与 `submitForm` 的区别：
+   * - 校验失败时不抛异常、不触发 `error` 事件，而是以返回值形式给出错误文案；
+   * - 不重置 `changeRecords`，不改变提交语义，仅用于「探测」当前配置是否合法。
+   *
+   * 注意：本方法只改变「校验结果的返回方式」，并不负责「不污染页面表单状态」——
+   * 若需对一份独立的「配置 + 值」做完全不影响页面上已渲染表单的校验，请使用 `validateForm`
+   * （内部会新建一个隐藏的 MForm 实例，通过 `initValues` 传入待校验值，用完即卸载）。
+   *
+   * 典型用途：作为 `validateForm` 内部复用的校验实现；也可在已渲染的表单实例上主动调用，
+   * 根据返回的错误文案自行决定后续处理（如记录节点错误状态）。
+   *
+   * @returns 校验通过返回空字符串 `''`，否则返回以 `<br>` 拼接的错误文案。
+   */
+  validate: () => Promise<string>;
   getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   error: (...args: any[]) => void;
@@ -297,7 +396,8 @@ type __VLS_Props$29 = {
   values?: Object;
   parentValues?: Object;
   width?: string | number;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
   fullscreen?: boolean;
   disabled?: boolean;
   title?: string;
@@ -334,6 +434,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly isCompare?: boolean | undefined;
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
+      readonly typeMatchValid?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -376,6 +477,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -408,6 +510,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
       resetForm: () => void;
       submitForm: (native?: boolean) => Promise<any>;
+      validate: () => Promise<string>;
       getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
     }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
       error: (...args: any[]) => void;
@@ -470,6 +573,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -493,7 +597,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" | "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" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -502,6 +606,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
     resetForm: () => void;
     submitForm: (native?: boolean) => Promise<any>;
+    validate: () => Promise<string>;
     getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
   } & {} & import("@vue/runtime-core").ComponentCustomProperties & {} & {
     $slots: import("@tmagic/editor").FormSlots;
@@ -515,6 +620,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly isCompare?: boolean | undefined;
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
+      readonly typeMatchValid?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -557,6 +663,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -589,6 +696,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
       resetForm: () => void;
       submitForm: (native?: boolean) => Promise<any>;
+      validate: () => Promise<string>;
       getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
     }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
       error: (...args: any[]) => void;
@@ -651,6 +759,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -674,7 +783,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" | "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" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -683,6 +792,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
     resetForm: () => void;
     submitForm: (native?: boolean) => Promise<any>;
+    validate: () => Promise<string>;
     getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
   } & {} & import("@vue/runtime-core").ComponentCustomProperties & {} & {
     $slots: import("@tmagic/editor").FormSlots;
@@ -728,7 +838,8 @@ type __VLS_Props$28 = {
   values?: Object;
   parentValues?: Object;
   width?: string | number;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
   disabled?: boolean;
   closeOnPressEscape?: boolean;
   title?: string;
@@ -761,6 +872,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly isCompare?: boolean | undefined;
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
+      readonly typeMatchValid?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -803,6 +915,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -835,6 +948,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
       resetForm: () => void;
       submitForm: (native?: boolean) => Promise<any>;
+      validate: () => Promise<string>;
       getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
     }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
       error: (...args: any[]) => void;
@@ -897,6 +1011,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -920,7 +1035,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" | "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" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -929,6 +1044,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
     resetForm: () => void;
     submitForm: (native?: boolean) => Promise<any>;
+    validate: () => Promise<string>;
     getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
   } & {} & import("@vue/runtime-core").ComponentCustomProperties & {} & {
     $slots: import("@tmagic/editor").FormSlots;
@@ -942,6 +1058,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly isCompare?: boolean | undefined;
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
+      readonly typeMatchValid?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -984,6 +1101,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1016,6 +1134,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
       resetForm: () => void;
       submitForm: (native?: boolean) => Promise<any>;
+      validate: () => Promise<string>;
       getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
     }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
       error: (...args: any[]) => void;
@@ -1078,6 +1197,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1101,7 +1221,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" | "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" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1110,6 +1230,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
     resetForm: () => void;
     submitForm: (native?: boolean) => Promise<any>;
+    validate: () => Promise<string>;
     getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
   } & {} & import("@vue/runtime-core").ComponentCustomProperties & {} & {
     $slots: import("@tmagic/editor").FormSlots;
@@ -1157,7 +1278,8 @@ type __VLS_Props$27 = {
   parentValues?: Object;
   width?: number;
   height?: number;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
   disabled?: boolean;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
@@ -1167,7 +1289,7 @@ type __VLS_Props$27 = {
   useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
 };
-declare var __VLS_16$1: {}, __VLS_18$1: {}, __VLS_20: {};
+declare var __VLS_16$1: {}, __VLS_18: {}, __VLS_20: {};
 type __VLS_Slots$2 = {} & {
   default?: (props: typeof __VLS_16$1) => any;
 } & {
@@ -1186,6 +1308,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly isCompare?: boolean | undefined;
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
+      readonly typeMatchValid?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1228,6 +1351,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1260,6 +1384,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
       resetForm: () => void;
       submitForm: (native?: boolean) => Promise<any>;
+      validate: () => Promise<string>;
       getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
     }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
       error: (...args: any[]) => void;
@@ -1322,6 +1447,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1345,7 +1471,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" | "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" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1354,6 +1480,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
     resetForm: () => void;
     submitForm: (native?: boolean) => Promise<any>;
+    validate: () => Promise<string>;
     getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
   } & {} & import("@vue/runtime-core").ComponentCustomProperties & {} & {
     $slots: import("@tmagic/editor").FormSlots;
@@ -1367,6 +1494,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly isCompare?: boolean | undefined;
       readonly parentValues?: Record<string, any> | undefined;
       readonly labelWidth?: string | undefined;
+      readonly typeMatchValid?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1409,6 +1537,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1441,6 +1570,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
       resetForm: () => void;
       submitForm: (native?: boolean) => Promise<any>;
+      validate: () => Promise<string>;
       getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
     }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
       error: (...args: any[]) => void;
@@ -1503,6 +1633,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1526,7 +1657,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" | "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" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1535,6 +1666,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     changeHandler: (v: schema_d_exports.FormValue, eventData: ContainerChangeEventData) => void;
     resetForm: () => void;
     submitForm: (native?: boolean) => Promise<any>;
+    validate: () => Promise<string>;
     getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
   } & {} & import("@vue/runtime-core").ComponentCustomProperties & {} & {
     $slots: import("@tmagic/editor").FormSlots;
@@ -1975,16 +2107,39 @@ declare const registerField: (tagName: string, component: Component) => void;
 declare const getField: (tagName: string) => Component | undefined;
 declare const deleteField: (tagName: string) => boolean;
 //#endregion
+//#region temp/packages/form/src/utils/typeMatch.d.ts
+interface TypeMatchValidateContext {
+  fieldType: string;
+  mForm: schema_d_exports.FormState | undefined;
+  props: any;
+  message?: string;
+}
+/** 自定义 type 校验器：返回错误文案；通过则返回 undefined */
+type TypeMatchValidator = (value: any, context: TypeMatchValidateContext) => string | undefined;
+/** 注册或覆盖某个字段 type 的 typeMatch 校验规则 */
+declare const registerTypeMatchRule: (type: string, validator: TypeMatchValidator) => void;
+/** 批量注册 typeMatch 校验规则 */
+declare const registerTypeMatchRules: (rules: Record<string, TypeMatchValidator>) => void;
+/** 获取某个字段 type 的自定义 typeMatch 校验规则 */
+declare const getTypeMatchRule: (type: string) => TypeMatchValidator | undefined;
+/** 删除某个字段 type 的自定义 typeMatch 校验规则 */
+declare const deleteTypeMatchRule: (type: string) => boolean;
+/** 清空所有自定义 typeMatch 校验规则 */
+declare const clearTypeMatchRules: () => void;
+declare const validateTypeMatch: (value: any, mForm: schema_d_exports.FormState | undefined, props: any, message?: string) => string | undefined;
+//#endregion
 //#region temp/packages/form/src/plugin.d.ts
 interface FormInstallOptions {
+  /** 自定义字段 type 的 typeMatch 校验规则，可覆盖内置规则或扩展业务字段 */
+  typeMatchRules?: Record<string, TypeMatchValidator>;
   [key: string]: any;
 }
 declare const _default$31: {
   install(app: App, opt?: FormInstallOptions): void;
 };
 declare namespace index_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, ValidateError, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, display, filterFunction, getDataByPage, getField as getFormField, getRules, initValue, registerField as registerFormField, sortArray, sortChange, submitForm, useAddField };
+  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, submitForm, useAddField, validateForm, validateTypeMatch };
 }
 declare const createForm: <T extends [] = []>(config: schema_d_exports.FormConfig | T) => schema_d_exports.FormConfig | T;
 //#endregion
-export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, ValidateError, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, display, filterFunction, getDataByPage, getField as getFormField, getRules, initValue, registerField as registerFormField, sortArray, sortChange, submitForm, useAddField };
+export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, submitForm, useAddField, validateForm, validateTypeMatch };