@tmagic/form 1.8.0-beta.2 → 1.8.0-beta.21

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_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
 }
 import * as import__tmagic_form_schema from "@tmagic/form-schema";
 /**
@@ -33,6 +33,17 @@ 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>>;
+/**
+ * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+ *
+ * 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
+ * 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+ *
+ * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
+ * 字段组件可以安全跳过，接入前需逐一审计。
+ */
+declare const FORM_SILENT_MODE_KEY: InjectionKey<boolean>;
 interface ValidateError {
   message: string;
   field: string;
@@ -87,9 +98,19 @@ interface SubmitFormOptions {
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
+  /**
+   * 表单校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   * 默认 `true`，置为 `false` 时直接使用字段 name。
+   */
+  useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
   /** 透传给 Form.submitForm 的参数：是否直接返回原始响应式 values */
   native?: boolean;
+  /**
+   * 是否在 resolve 结果中携带 changeRecords（变更记录）。
+   * 开启后 resolve 的结果为 `{ values, changeRecords }`，否则仅 resolve values。
+   */
+  returnChangeRecords?: boolean;
   /**
    * 父级应用上下文，用于继承全局组件、指令、provide 等。
    * 通常通过 `app._context` 或 `getCurrentInstance()?.appContext` 获取。
@@ -97,6 +118,30 @@ interface SubmitFormOptions {
   appContext?: AppContext | null;
   /** 等待表单初始化的最长时间（毫秒），超时将以错误 reject。默认 10000ms */
   timeout?: number;
+  /**
+   * 调试模式。默认 `false`。
+   *
+   * - `false`：表单以隐藏方式挂载，初始化完成后自动提交（原有行为）。
+   * - `true`：将表单以弹层形式可见地渲染在页面上，需手动点击「确定」才会触发校验/提交，
+   *   点击「取消」则以 reject 中断；校验失败时保留弹层并展示错误信息，便于修正后重试。
+   *   调试模式下 `timeout` 不生效（等待人工操作）。
+   */
+  debug?: boolean;
+  typeMatchValid?: boolean;
+  /**
+   * 外部中断信号。abort 时会立即以 `signal.reason` reject 并卸载临时表单实例、移除容器。
+   * 主要用于 `debug` 模式（无超时兜底）下取消一个被放弃的表单弹层，避免其无限驻留在页面上。
+   */
+  signal?: AbortSignal;
+}
+/**
+ * 开启 `returnChangeNodes` 时 submitForm 的返回结果
+ */
+interface SubmitFormResult {
+  /** 校验通过后的表单值 */
+  values: any;
+  /** 表单变更记录 */
+  changeRecords: ChangeRecord[];
 }
 /**
  * 以命令式方式调用 Form.vue 完成一次表单校验/提交。
@@ -118,15 +163,121 @@ interface SubmitFormOptions {
  * } catch (e) {
  *   console.error(e);
  * }
+ *
+ * // 需要同时获取变更记录时：
+ * const { values, changeRecords } = await submitForm({
+ *   config: [...],
+ *   initValues: { name: 'foo' },
+ *   returnChangeRecords: true,
+ * });
+ *
+ * // 调试模式：可见地渲染表单，点击「确定」才提交：
+ * const values = await submitForm({
+ *   config: [...],
+ *   initValues: { name: 'foo' },
+ *   debug: true,
+ * });
  * ```
  */
 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;
+  /**
+   * 外部中断信号。abort 时会立即以 `signal.reason` reject 并卸载临时表单实例、移除容器。
+   * 主要用于 `debug` 模式（无超时兜底）下取消一个被放弃的表单弹层，避免其无限驻留在页面上。
+   */
+  signal?: AbortSignal;
+}
+/**
+ * 返回一份去除了 tab 标签页 lazy 的配置副本。
+ *
+ * tab 容器开启 lazy 时，非激活标签页的内容不会渲染，导致 validateForm 静默挂载后
+ * 无法校验到这些标签页内的字段。校验场景需要一次性渲染全部字段，故在此统一去除 lazy。
+ * 处理基于深拷贝，不会污染调用方传入的原始 config。
+ */
+declare const stripTabItemsLazy: (config: schema_d_exports.FormConfig) => schema_d_exports.FormConfig;
+/**
+ * 以命令式方式对一份「表单配置 + 值」做一次静默校验，**不依赖也不影响任何已渲染的表单**。
+ *
+ * 与 `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
@@ -141,6 +292,24 @@ declare const sortChange: (data: any[], {
   prop,
   order
 }: schema_d_exports.SortProp) => void;
+/**
+ * 将 extendState 返回的扩展字段合并进 formState。
+ *
+ * - data 描述符（普通字段）通过 `formState[key] = value` 写入，走 reactive proxy 的 set，
+ *   触发依赖通知；
+ * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
+ *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
+ *
+ * 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+ * 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+ * config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+ * post 等），命中这些 key 时统一跳过并告警。
+ *
+ * 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+ * 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+ * `TypeError: 'set' on proxy: trap returned falsish`。
+ */
+declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined, reservedKeys?: Set<string | symbol>) => void;
 declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/useAddField.d.ts
@@ -154,7 +323,15 @@ type __VLS_Props$30 = {
   lastValues?: Record<string, any>; /** 是否开启对比模式 */
   isCompare?: boolean;
   parentValues?: Record<string, any>;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /**
+   * 初始化（`config` / `initValues` 就绪）后是否立即执行一次表单校验。
+   *
+   * - `false`（默认）：不自动校验，避免打开表单时就展示错误态；
+   * - `true`：初始化完成后在 `nextTick` 中调用 `validate()`。
+   */
+  validateOnInit?: boolean;
   disabled?: boolean;
   height?: string;
   stepActive?: string | number;
@@ -164,6 +341,13 @@ type __VLS_Props$30 = {
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
+  /**
+   * 表单校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   *
+   * - `true`（默认）：错误提示形如 `字段文案 -> 错误信息`，找不到 text 时回退为字段 name；
+   * - `false`：跳过查找，直接使用字段 name 作为错误提示前缀（形如 `字段name -> 错误信息`）。
+   */
+  useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
   /**
    * 自定义"是否展示对比内容"的判断函数（仅在 `isCompare === true` 时生效）。
@@ -196,6 +380,15 @@ type __VLS_Props$30 = {
    * 通过 provide 下发，对整棵表单的所有层级 Container 生效，只需在 MForm 这一层传一次。
    */
   selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+  /**
+   * 主题名称：对应 `packages/form/src/theme/themes/<theme>/index.scss` 的目录名。
+   *
+   * 设置后会在表单根元素上追加 `m-form--<theme>` 修饰类，配合按需引入
+   * `@tmagic/form/dist/themes/<theme>.css` 即可启用主题样式。
+   *
+   * 例如：`<MForm theme="magic-admin" />` + `import '@tmagic/form/dist/themes/magic-admin.css'`。
+   */
+  theme?: string;
 };
 declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Props$30, {
   values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
@@ -206,6 +399,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;
@@ -232,6 +442,8 @@ 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>;
 declare const _default$12: typeof __VLS_export$30;
@@ -247,7 +459,9 @@ type __VLS_Props$29 = {
   values?: Object;
   parentValues?: Object;
   width?: string | number;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   fullscreen?: boolean;
   disabled?: boolean;
   title?: string;
@@ -261,8 +475,15 @@ type __VLS_Props$29 = {
   closeOnPressEscape?: boolean;
   destroyOnClose?: boolean;
   showClose?: boolean;
-  showCancel?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
+  showCancel?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
+   * 计算结果会再次 `provide` 出去，使得 Dialog 被 Teleport 到 body 后，内部子树
+   * （包括 `MForm` 以及更深的 popover / dropdown）仍能拿到主题。
+   */
+  theme?: string;
 };
 declare var __VLS_19: {}, __VLS_34: {}, __VLS_42: {};
 type __VLS_Slots$4 = {} & {
@@ -283,6 +504,8 @@ 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 validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -292,6 +515,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -299,6 +523,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -324,6 +549,8 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -333,6 +560,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -340,6 +568,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -355,6 +584,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;
@@ -375,6 +605,8 @@ 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)[];
       created?: (() => void) | (() => void)[];
@@ -408,6 +640,8 @@ 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;
     initValues: Record<string, any>;
@@ -415,6 +649,8 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -424,6 +660,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -431,13 +668,14 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
     "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")> & {
+  }>, "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;
@@ -446,6 +684,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;
@@ -459,6 +698,8 @@ 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 validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -468,6 +709,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -475,6 +717,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -500,6 +743,8 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -509,6 +754,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -516,6 +762,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -531,6 +778,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;
@@ -551,6 +799,8 @@ 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)[];
       created?: (() => void) | (() => void)[];
@@ -584,6 +834,8 @@ 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;
     initValues: Record<string, any>;
@@ -591,6 +843,8 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -600,6 +854,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -607,13 +862,14 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
     "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")> & {
+  }>, "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;
@@ -622,6 +878,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;
@@ -649,6 +906,8 @@ 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;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
@@ -666,7 +925,9 @@ type __VLS_Props$28 = {
   values?: Object;
   parentValues?: Object;
   width?: string | number;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   disabled?: boolean;
   closeOnPressEscape?: boolean;
   title?: string;
@@ -675,9 +936,16 @@ type __VLS_Props$28 = {
   confirmText?: string;
   inline?: boolean;
   labelPosition?: string;
-  preventSubmitDefault?: boolean; /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
+  preventSubmitDefault?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean; /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
   beforeClose?: (_done: (_cancel?: boolean) => void) => void; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
+   * 计算结果会再次 `provide` 出去，使得 Drawer 被 Teleport 到 body 后，内部子树
+   * （包括 `MForm` 以及更深的 popover / dropdown）仍能拿到主题。
+   */
+  theme?: string;
 };
 declare var __VLS_23: {}, __VLS_38: {}, __VLS_46: {};
 type __VLS_Slots$3 = {} & {
@@ -698,6 +966,8 @@ 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 validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -707,6 +977,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -714,6 +985,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -739,6 +1011,8 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -748,6 +1022,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -755,6 +1030,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -770,6 +1046,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;
@@ -790,6 +1067,8 @@ 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)[];
       created?: (() => void) | (() => void)[];
@@ -823,6 +1102,8 @@ 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;
     initValues: Record<string, any>;
@@ -830,6 +1111,8 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -839,6 +1122,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -846,13 +1130,14 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
     "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")> & {
+  }>, "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;
@@ -861,6 +1146,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;
@@ -874,6 +1160,8 @@ 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 validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -883,6 +1171,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -890,6 +1179,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -915,6 +1205,8 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -924,6 +1216,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -931,6 +1224,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -946,6 +1240,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;
@@ -966,6 +1261,8 @@ 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)[];
       created?: (() => void) | (() => void)[];
@@ -999,6 +1296,8 @@ 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;
     initValues: Record<string, any>;
@@ -1006,6 +1305,8 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1015,6 +1316,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -1022,13 +1324,14 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
     "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")> & {
+  }>, "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;
@@ -1037,14 +1340,18 @@ 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;
   }) | undefined>;
   saveFetch: import("@vue/reactivity").Ref<boolean, boolean>;
   bodyHeight: import("@vue/reactivity").Ref<number, number>;
+  close: () => void;
   show: () => void;
   hide: () => void;
+  save: () => Promise<void>;
+  cancel: () => void;
   handleClose: () => void;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   error: (...args: any[]) => void;
@@ -1066,6 +1373,8 @@ 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>;
 declare const __VLS_export$28: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
@@ -1083,16 +1392,19 @@ type __VLS_Props$27 = {
   parentValues?: Object;
   width?: number;
   height?: number;
-  labelWidth?: string;
+  labelWidth?: string; /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   disabled?: boolean;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
   inline?: boolean;
   labelPosition?: string;
-  preventSubmitDefault?: boolean;
+  preventSubmitDefault?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  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;
 } & {
@@ -1111,6 +1423,8 @@ 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 validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1120,6 +1434,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -1127,6 +1442,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -1152,6 +1468,8 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1161,6 +1479,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -1168,6 +1487,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -1183,6 +1503,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;
@@ -1203,6 +1524,8 @@ 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)[];
       created?: (() => void) | (() => void)[];
@@ -1236,6 +1559,8 @@ 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;
     initValues: Record<string, any>;
@@ -1243,6 +1568,8 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1252,6 +1579,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -1259,13 +1587,14 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
     "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")> & {
+  }>, "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;
@@ -1274,6 +1603,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;
@@ -1287,6 +1617,8 @@ 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 validateOnInit?: boolean | undefined;
       readonly disabled?: boolean | undefined;
       readonly height?: string | undefined;
       readonly stepActive?: string | number | undefined;
@@ -1296,6 +1628,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -1303,6 +1636,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -1328,6 +1662,8 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare?: boolean;
       parentValues?: Record<string, any>;
       labelWidth?: string;
+      typeMatchValid?: boolean;
+      validateOnInit?: boolean;
       disabled?: boolean;
       height?: string;
       stepActive?: string | number;
@@ -1337,6 +1673,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -1344,6 +1681,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -1359,6 +1697,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;
@@ -1379,6 +1718,8 @@ 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)[];
       created?: (() => void) | (() => void)[];
@@ -1412,6 +1753,8 @@ 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;
     initValues: Record<string, any>;
@@ -1419,6 +1762,8 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare?: boolean;
     parentValues?: Record<string, any>;
     labelWidth?: string;
+    typeMatchValid?: boolean;
+    validateOnInit?: boolean;
     disabled?: boolean;
     height?: string;
     stepActive?: string | number;
@@ -1428,6 +1773,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -1435,13 +1781,14 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
     "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")> & {
+  }>, "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;
@@ -1450,6 +1797,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;
@@ -1468,6 +1816,8 @@ 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>;
 declare const __VLS_export$27: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
@@ -1490,7 +1840,8 @@ type __VLS_Props$26 = {
   expandMore?: boolean;
   stepActive?: string | number;
   size?: string; /** 是否开启对比模式 */
-  isCompare?: boolean;
+  isCompare?: boolean; /** 是否在行容器中 */
+  isInRow?: boolean;
 };
 declare const __VLS_base$1: import("@vue/runtime-core").DefineComponent<__VLS_Props$26, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData: ContainerChangeEventData) => any;
@@ -1571,6 +1922,7 @@ type __VLS_Props$23 = {
   prop?: string;
   size?: string;
   disabled?: boolean;
+  hideExpand?: boolean;
 };
 declare var __VLS_16: {}, __VLS_18: {};
 type __VLS_Slots = {} & {
@@ -1820,7 +2172,9 @@ declare const __VLS_export$4: import("@vue/runtime-core").DefineComponent<__VLS_
 declare const _default$8: typeof __VLS_export$4;
 //#endregion
 //#region temp/packages/form/src/fields/Link.vue.d.ts
-type __VLS_Props$3 = schema_d_exports.FieldProps<schema_d_exports.LinkConfig>;
+type __VLS_Props$3 = schema_d_exports.FieldProps<schema_d_exports.LinkConfig> & {
+  theme?: string;
+};
 declare const __VLS_export$3: import("@vue/runtime-core").DefineComponent<__VLS_Props$3, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$3> & Readonly<{
@@ -1889,16 +2243,49 @@ 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。
+ *
+ * 支持返回 Promise，用于需要异步确认取值是否合法的场景（如请求接口校验 id 是否存在）。
+ */
+type TypeMatchValidator = (value: any, context: TypeMatchValidateContext) => string | undefined | Promise<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;
+/**
+ * 校验取值与字段 type 是否匹配；通过返回 undefined，否则返回错误文案。
+ *
+ * 命中的自定义规则是异步校验器时返回 Promise，内置规则始终同步返回。
+ */
+declare const validateTypeMatch: (value: any, mForm: schema_d_exports.FormState | undefined, props: any, message?: string) => string | undefined | Promise<string | undefined>;
+//#endregion
 //#region temp/packages/form/src/plugin.d.ts
 interface FormInstallOptions {
+  flat?: boolean;
+  /** 自定义字段 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, 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_SILENT_MODE_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, applyExtendState, 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, stripTabItemsLazy, 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, 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_SILENT_MODE_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, applyExtendState, 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, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };