@tmagic/form 1.8.0-manmanyu.9 → 1.8.1

package/types/index.d.ts

@@ -1,10 +1,8 @@
-import { App, AppContext, Component, InjectionKey } from "vue";
-import { FlexLayoutConfig, FormItemConfig, GroupListConfig, TableConfig } from "@tmagic/form-schema";
+import { App, AppContext, Component, ComputedRef, InjectionKey, MaybeRef, Ref } from "vue";
+import { FlexLayoutConfig, FormContext, 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_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
 }
 import * as import__tmagic_form_schema from "@tmagic/form-schema";
 /**
@@ -12,7 +10,7 @@ import * as import__tmagic_form_schema from "@tmagic/form-schema";
  * 所有层级的 Container（含嵌套在 fieldset / panel 等容器组件内部的 Container）通过 `inject` 获取，
  * 无需逐层透传 prop。
  */
-interface FormDiffConfig {
+export interface FormDiffConfig {
   /**
    * 自定义"是否展示对比内容"的判断函数（仅在对比模式下生效）。
    *
@@ -32,21 +30,31 @@ interface FormDiffConfig {
    */
   selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
 }
-declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
-interface ValidateError {
+export declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
+export declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
+/**
+ * 宿主业务上下文，由 `MForm`（或更外层的 Editor）通过 `provide` 下发。
+ *
+ * 嵌套表单（Link 子表单、FormBox、临时校验表单等）会自动继承最近祖先的 context，
+ * 无需层层透传。
+ *
+ * 配置回调统一通过 `mForm.xxx` 读取，由 formState 的读穿 Proxy 落到这里。
+ */
+export declare const FORM_CONTEXT_KEY: InjectionKey<ComputedRef<FormContext>>;
+export interface ValidateError {
   message: string;
   field: string;
 }
-interface ChangeRecord {
+export interface ChangeRecord {
   propPath?: string;
   value: any;
 }
-interface ContainerChangeEventData {
+export interface ContainerChangeEventData {
   modifyKey?: string;
   changeRecords?: ChangeRecord[];
 }
 /** 自定义 label slot 的作用域参数 */
-interface FormLabelSlotProps {
+export interface FormLabelSlotProps {
   /** 当前表单项配置 */
   config: FormItemConfig;
   /** 经处理后的类型 */
@@ -59,11 +67,72 @@ interface FormLabelSlotProps {
   disabled?: boolean;
 }
 /** Form / Container 暴露的具名 slot 定义 */
-interface FormSlots {
+export interface FormSlots {
   label(_props: FormLabelSlotProps): any;
 }
 //#endregion
-//#region temp/packages/form/src/submitForm.d.ts
+//#region temp/packages/form/src/utils/validateValues.d.ts
+/** 构造无渲染 formState 所需的参数（与 MForm 的同名 props 对齐） */
+interface HeadlessFormStateOptions {
+  config: schema_d_exports.FormConfig;
+  initValues?: schema_d_exports.FormValue;
+  parentValues?: schema_d_exports.FormValue;
+  keyProp?: string;
+  popperClass?: string;
+  /** 宿主业务上下文，与 MForm 的同名 prop 语义一致 */
+  context?: schema_d_exports.FormContext;
+}
+/**
+ * 构造一个不依赖组件实例的 `formState`。
+ *
+ * 字段结构与 `Form.vue` 中 provide 给子树的 `mForm` 保持一致，使配置里的
+ * `display` / `rules.validator` / `filter` 等回调拿到的上下文与渲染式校验相同。
+ *
+ * 差异：没有真实的表单实例，因此 `$emit` 为空实现、`fields` 注册表始终为空
+ * （该注册表在整个仓库中只写不读，不参与校验）。
+ */
+export declare const createHeadlessFormState: (options: HeadlessFormStateOptions) => schema_d_exports.FormState;
+/** `validateValues` 参数 */
+interface ValidateValuesOptions extends HeadlessFormStateOptions {
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /**
+   * 校验失败时错误提示前缀是否使用字段的 text 文案。默认 `true`。
+   */
+  useFieldTextInError?: boolean;
+}
+/** `validateValues` 结果 */
+interface ValidateValuesResult {
+  /** 经 `initValue` 初始化并执行字段值初始化写入后的表单值 */
+  values: schema_d_exports.FormValue;
+  /** 汇总后的错误文案（多条以 `<br>` 拼接），校验通过为空字符串 */
+  error: string;
+  /** 原始错误映射，形如 `{ [prop]: [{ field, message }] }` */
+  invalidFields: Record<string, any>;
+}
+/**
+ * 不挂载任何组件，纯逻辑地对「一份 config + 一份值」执行一次完整校验。
+ *
+ * 流程与渲染式校验一一对应，但不需要 DOM，也不会实例化任何字段组件：
+ *
+ * 1. 构造 headless `formState` 并挂上 `context` 读穿；
+ * 2. `initValue` 初始化表单值（默认值、嵌套结构、`onInitValue` 等）；
+ * 3. `applyMountValueEffects` 执行字段登记的值初始化写入（与渲染式共用同一份登记表）；
+ * 4. 遍历 config 树收集所有带规则的字段（等价于渲染出的 FormItem 集合）；
+ * 5. 逐字段交给 async-validator 执行，汇总错误文案。
+ *
+ * @example
+ * ```ts
+ * const { error, values } = await validateValues({
+ *   config: [...],
+ *   initValues: { name: '' },
+ *   typeMatchValid: true,
+ * });
+ * ```
+ */
+export declare const validateValues: (options: ValidateValuesOptions) => Promise<ValidateValuesResult>;
+//#endregion
+//#region temp/packages/form/src/utils/submitHeadless.d.ts
 /**
  * submitForm 函数参数（与 Form.vue 组件 props 对齐）
  */
@@ -83,11 +152,17 @@ interface SubmitFormOptions {
   stepActive?: string | number;
   size?: 'small' | 'default' | 'large';
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 表单校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   * 默认 `true`，置为 `false` 时直接使用字段 name。
+   */
+  useFieldTextInError?: boolean;
+  /** 宿主业务上下文，与 MForm 的同名 prop 语义一致 */
+  context?: schema_d_exports.FormContext;
   /** 透传给 Form.submitForm 的参数：是否直接返回原始响应式 values */
   native?: boolean;
   /**
@@ -97,11 +172,24 @@ interface SubmitFormOptions {
   returnChangeRecords?: boolean;
   /**
    * 父级应用上下文，用于继承全局组件、指令、provide 等。
-   * 通常通过 `app._context` 或 `getCurrentInstance()?.appContext` 获取。
+   * 仅 `dialog: true` 时生效。`@tmagic/form/headless` 不支持弹层。
    */
   appContext?: AppContext | null;
-  /** 等待表单初始化的最长时间（毫秒），超时将以错误 reject。默认 10000ms */
-  timeout?: number;
+  /**
+   * 是否以弹层展示表单。默认 `false`。
+   *
+   * `@tmagic/form/headless` 不支持 `dialog: true`，请从 `@tmagic/form` 引入。
+   */
+  dialog?: boolean;
+  /**
+   * 弹层标题，仅 `dialog: true` 时生效。
+   */
+  title?: string;
+  typeMatchValid?: boolean;
+  /**
+   * 外部中断信号。abort 时会立即以 `signal.reason` reject。
+   */
+  signal?: AbortSignal;
 }
 /**
  * 开启 `returnChangeRecords` 时 submitForm 的返回结果
@@ -113,79 +201,201 @@ interface SubmitFormResult {
   changeRecords: ChangeRecord[];
 }
 /**
- * 以命令式方式调用 Form.vue 完成一次表单校验/提交。
+ * 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;
+  /** 宿主业务上下文，与 MForm 的同名 prop 语义一致 */
+  context?: schema_d_exports.FormContext;
+  /**
+   * 父级应用上下文。仅 `dialog: true` 时生效。`@tmagic/form/headless` 不支持弹层。
+   */
+  appContext?: AppContext | null;
+  /**
+   * 是否以弹层展示表单。默认 `false`。
+   *
+   * `@tmagic/form/headless` 不支持 `dialog: true`，请从 `@tmagic/form` 引入。
+   */
+  dialog?: boolean;
+  /**
+   * 弹层标题，仅 `dialog: true` 时生效。
+   */
+  title?: string;
+  typeMatchValid?: boolean;
+  /**
+   * 外部中断信号。abort 时会立即以 `signal.reason` reject。
+   */
+  signal?: AbortSignal;
+}
+//#endregion
+//#region temp/packages/form/src/submitForm.d.ts
+/**
+ * 返回一份去除了 tab 标签页 lazy 的配置副本。
  *
- * 类似 ElMessage 的用法：传入 props（包含 `config`/`initValues` 等），函数内部会临时挂载
- * 一个不可见的 Form 组件实例，等待初始化完成后调用其 `submitForm` 方法，
- * 校验通过则 resolve 表单值，校验失败则 reject 错误信息，最后自动卸载实例。
+ * tab 容器开启 lazy 时，非激活标签页的内容不会渲染，导致 validateForm 静默挂载后
+ * 无法校验到这些标签页内的字段。校验场景需要一次性渲染全部字段，故在此统一去除 lazy。
+ * 处理基于深拷贝，不会污染调用方传入的原始 config。
+ */
+export declare const stripTabItemsLazy: (config: schema_d_exports.FormConfig) => schema_d_exports.FormConfig;
+/**
+ * 以命令式方式对一份「表单配置 + 值」做一次校验并取回表单值。
  *
- * @example
- * ```ts
- * import { submitForm } from '@tmagic/form';
+ * 默认走无渲染实现（见 `@tmagic/form/headless`）。`dialog: true` 会把表单以弹层渲染出来。
+ */
+export declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
+/**
+ * 以命令式方式对一份「表单配置 + 值」做一次静默校验。
+ *
+ * 默认走无渲染实现。`dialog: true` 的处理详见 `submitForm`。
+ */
+export declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
+//#endregion
+//#region temp/packages/form/src/utils/formStateProxy.d.ts
+/**
+ * 按优先级分层合并上下文，**靠后的层优先**。
  *
- * try {
- *   const values = await submitForm({
- *     config: [...],
- *     initValues: { name: 'foo' },
- *   });
- *   console.log(values);
- * } catch (e) {
- *   console.error(e);
- * }
+ * 用读穿 Proxy 而非 `{ ...a, ...b }`：展开会立即执行 accessor，
+ * 而宿主允许用 `{ get stage() { ... } }` 这类读时求值的描述符。
+ */
+export declare const mergeFormContexts: (...layers: (schema_d_exports.FormContext | undefined | null)[]) => schema_d_exports.FormContext;
+/**
+ * 将 coreState 与宿主业务上下文关联：读取时优先 core，miss 再读穿到 context。
  *
- * // 需要同时获取变更记录时：
- * const { values, changeRecords } = await submitForm({
- *   config: [...],
- *   initValues: { name: 'foo' },
- *   returnChangeRecords: true,
- * });
- * ```
+ * - `get` 用属性访问而非 `Reflect.get(t, k, receiver)`，避免破坏 Vue reactive 的 `__v_raw`；
+ * - symbol 键一律只走 core，四个 trap 保持一致。context 是业务数据袋，不承载 symbol 键，
+ *   把 Vue / 工具链的内部 symbol 隔离在 core 上才能让 `toRaw` / `isReactive` 判定正确；
+ * - `ownKeys` + `getOwnPropertyDescriptor` 保证 `Object.entries(formState)` 能枚举到扩展字段
+ *   （admin-web-next 的 `pickPanelFormStateExtendFields` 依赖此语义）；
+ * - `set` 写入 coreState，第三方 `formState.xxx = v` 仍生效且优先于 context。
+ *
+ * 独立成文件，避免与 `form.ts` ↔ `typeMatch.ts` 形成循环依赖。
  */
-declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
+export declare const createFormStateProxy: (coreState: schema_d_exports.FormState, getContext: (() => schema_d_exports.FormContext) | Ref<schema_d_exports.FormContext>) => schema_d_exports.FormState;
 //#endregion
 //#region temp/packages/form/src/utils/form.d.ts
-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 initValue: (mForm: schema_d_exports.FormState | undefined, {
-  initValues,
-  config
-}: {
+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。
+ */
+export declare const adaptFormValidator: (validator: AsyncValidatorFn) => AsyncValidatorFn;
+export 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;
+export declare const createFormStateBase: (ui?: {
+  $message?: any;
+  $messageBox?: any;
+}) => {
+  fields: Map<string, any>;
+  setField: (prop: string, field: any) => Map<string, any>;
+  getField: (prop: string) => any;
+  deleteField: (prop: string) => boolean;
+  $messageBox: any;
+  $message: any;
+  post: (options: any) => any;
+};
+/**
+ * 配置项的 `name` 是否可用于从 model 中下钻取值。
+ *
+ * 供 `Container.vue` 与无渲染校验（`collectValidatableFields`）共用，两者对「该不该下钻」
+ * 的判断必须一致。
+ */
+export declare const isValidName: (name: unknown) => boolean;
+/**
+ * 在 `prop` 后追加一段路径。
+ *
+ * 用于容器把 `prop` 透传给子级时再拼上索引 / key（如 group-list 的行、table 的行）。
+ */
+export declare const appendProp: (prop: string | undefined, key: string | number) => string;
+/**
+ * 由父级 `prop` 与配置项 `name` 拼出该配置项的完整 `prop`（即 FormItem 的 prop）。
+ *
+ * 调用方传入的 name 已按 `config.name || ''` 归一化，空 name 表示该配置项不占据值路径上的一层，
+ * 此时沿用父级 `prop`。
+ */
+export declare const getItemProp: (prop?: string | undefined, name?: string | number | undefined) => string;
+/**
+ * 归一化配置项的 `type`：求值动态 type、剥离容器语义的 type、驼峰转中划线、补默认值。
+ *
+ * 供 `Container.vue` 与无渲染校验共用，保证两者分派到的 type 完全一致。
+ */
+export declare const resolveItemType: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => string;
+export declare const filterFunction: <T = any>(mForm: schema_d_exports.FormState | undefined, config: T | schema_d_exports.FilterFunction<T> | undefined, props: any) => T | undefined;
+export declare const display: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => any;
+export declare const getRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: MaybeRef<boolean>) => schema_d_exports.Rule[];
+/**
+ * 与 `getRules` 相同，但 validator 保持 async-validator（Element Plus）原生签名，不做 UI 库适配。
+ *
+ * 供无渲染校验（`validateValues`）使用：它直接把规则交给 async-validator 执行，
+ * 不经过 TDesign 的 `validator(val)` 调用约定，因此不能套 `adaptFormValidator`。
+ */
+export declare const getNativeRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: MaybeRef<boolean>) => schema_d_exports.Rule[];
+export declare const initValue: (mForm: schema_d_exports.FormState | undefined, { initValues, config }: {
   initValues: schema_d_exports.FormValue;
   config: schema_d_exports.FormConfig;
 }) => Promise<schema_d_exports.FormValue>;
-declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
-declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
-declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
-declare const sortChange: (data: any[], {
-  prop,
-  order
-}: schema_d_exports.SortProp) => void;
-declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
+export declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
+export declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
+export declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
+export declare const sortChange: (data: any[], { prop, order }: schema_d_exports.SortProp) => void;
+export declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/useAddField.d.ts
-declare const useAddField: (prop?: string) => void;
+export declare const useAddField: (prop?: string) => void;
 //#endregion
 //#region temp/packages/form/src/Form.vue.d.ts
-type __VLS_Slots$5 = FormSlots;
+type __VLS_Slots$6 = FormSlots;
 type __VLS_Props$30 = {
-  /** 表单配置 */config: schema_d_exports.FormConfig; /** 表单值 */
-  initValues: Record<string, any>; /** 需对比的值（开启对比模式时传入） */
-  lastValues?: Record<string, any>; /** 是否开启对比模式 */
+  /** 表单配置 */
+  config: schema_d_exports.FormConfig;
+  /** 表单值 */
+  initValues: Record<string, any>;
+  /** 需对比的值（开启对比模式时传入） */
+  lastValues?: Record<string, any>;
+  /** 是否开启对比模式 */
   isCompare?: boolean;
   parentValues?: Record<string, any>;
   labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /**
+   * 初始化（`config` / `initValues` 就绪）后是否立即执行一次表单校验。
+   *
+   * - `false`（默认）：不自动校验，避免打开表单时就展示错误态；
+   * - `true`：初始化完成后在 `nextTick` 中调用 `validate()`。
+   */
+  validateOnInit?: boolean;
   disabled?: boolean;
   height?: string;
   stepActive?: string | number;
   size?: 'small' | 'default' | 'large';
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 表单校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   *
+   * - `true`（默认）：错误提示形如 `字段文案 -> 错误信息`，找不到 text 时回退为字段 name；
+   * - `false`：跳过查找，直接使用字段 name 作为错误提示前缀（形如 `字段name -> 错误信息`）。
+   */
+  useFieldTextInError?: boolean;
+  /**
+   * 宿主业务上下文。也可由祖先 `provide(FORM_CONTEXT_KEY)` 下发，本 prop 覆盖祖先的同名字段。
+   *
+   * 配置回调通过 `mForm.xxx` 读取，由 formState 的读穿 Proxy 落到这里。
+   */
+  context?: schema_d_exports.FormContext;
   /**
    * 自定义"是否展示对比内容"的判断函数（仅在 `isCompare === true` 时生效）。
    *
@@ -227,7 +437,7 @@ type __VLS_Props$30 = {
    */
   theme?: string;
 };
-declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Props$30, {
+declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Props$30, {
   values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
   lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
   formState: schema_d_exports.FormState;
@@ -236,6 +446,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;
@@ -253,7 +480,7 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   disabled: boolean;
   labelWidth: string;
   inline: boolean;
-  labelPosition: string;
+  labelPosition: "top" | "left" | "right";
   config: schema_d_exports.FormConfig;
   height: string;
   initValues: Record<string, any>;
@@ -261,11 +488,13 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   isCompare: boolean;
   keyProp: string;
   parentValues: Record<string, any>;
+  useFieldTextInError: boolean;
   stepActive: string | number;
+  validateOnInit: 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 __VLS_export$30: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
 declare const _default$12: typeof __VLS_export$30;
-type __VLS_WithSlots$5<T, S> = T & {
+type __VLS_WithSlots$6<T, S> = T & {
   new (): {
     $slots: S;
   };
@@ -278,11 +507,15 @@ type __VLS_Props$29 = {
   parentValues?: Object;
   width?: string | number;
   labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   fullscreen?: boolean;
   disabled?: boolean;
   title?: string;
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   zIndex?: number;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
@@ -291,8 +524,11 @@ type __VLS_Props$29 = {
   closeOnPressEscape?: boolean;
   destroyOnClose?: boolean;
   showClose?: boolean;
-  showCancel?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  showCancel?: boolean;
+  /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean;
+  /** 透传给内部 `MForm` 的宿主业务上下文 */
+  context?: schema_d_exports.FormContext;
   /**
    * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
    * 计算结果会再次 `provide` 出去，使得 Dialog 被 Teleport 到 body 后，内部子树
@@ -301,14 +537,14 @@ type __VLS_Props$29 = {
   theme?: string;
 };
 declare var __VLS_19: {}, __VLS_34: {}, __VLS_42: {};
-type __VLS_Slots$4 = {} & {
+type __VLS_Slots$5 = {} & {
   default?: (props: typeof __VLS_19) => any;
 } & {
   left?: (props: typeof __VLS_34) => any;
 } & {
   footer?: (props: typeof __VLS_42) => any;
 };
-declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Props$29, {
+declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Props$29, {
   form: import("@vue/reactivity").Ref<({
     $: import("@vue/runtime-core").ComponentInternalInstance;
     $data: {};
@@ -319,16 +555,19 @@ 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;
       readonly size?: "small" | "default" | "large" | undefined;
       readonly inline?: boolean | undefined;
-      readonly labelPosition?: string | undefined;
+      readonly labelPosition?: "top" | "left" | "right" | undefined;
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -361,16 +600,19 @@ 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;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      useFieldTextInError?: boolean;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -387,12 +629,13 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     }>, {
       values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
       lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
-      formState: schema_d_exports.FormState;
+      formState: import("@tmagic/form-schema").FormState;
       initialized: import("@vue/reactivity").Ref<boolean, boolean>;
       changeRecords: import("@vue/reactivity").ShallowRef<import("@tmagic/editor").ChangeRecord[], import("@tmagic/editor").ChangeRecord[]>;
       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;
@@ -404,7 +647,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       disabled: boolean;
       labelWidth: string;
       inline: boolean;
-      labelPosition: string;
+      labelPosition: "top" | "left" | "right";
       config: schema_d_exports.FormConfig;
       height: string;
       initValues: Record<string, any>;
@@ -412,7 +655,9 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare: boolean;
       keyProp: string;
       parentValues: Record<string, any>;
+      useFieldTextInError: boolean;
       stepActive: string | number;
+      validateOnInit: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -437,7 +682,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     disabled: boolean;
     labelWidth: string;
     inline: boolean;
-    labelPosition: string;
+    labelPosition: "top" | "left" | "right";
     config: schema_d_exports.FormConfig;
     height: string;
     initValues: Record<string, any>;
@@ -445,7 +690,9 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare: boolean;
     keyProp: string;
     parentValues: Record<string, any>;
+    useFieldTextInError: boolean;
     stepActive: string | number;
+    validateOnInit: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -453,16 +700,19 @@ 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;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    useFieldTextInError?: boolean;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -476,15 +726,16 @@ 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")> & {
+  }>, "values" | "changeHandler" | "validate" | "lastValuesProcessed" | "submitForm" | "changeRecords" | "initialized" | "formState" | "resetForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "useFieldTextInError" | "stepActive" | "validateOnInit")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
-    formState: schema_d_exports.FormState;
+    formState: import("@tmagic/form-schema").FormState;
     initialized: boolean;
     changeRecords: import("@tmagic/editor").ChangeRecord[];
     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;
@@ -498,16 +749,19 @@ 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;
       readonly size?: "small" | "default" | "large" | undefined;
       readonly inline?: boolean | undefined;
-      readonly labelPosition?: string | undefined;
+      readonly labelPosition?: "top" | "left" | "right" | undefined;
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -540,16 +794,19 @@ 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;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      useFieldTextInError?: boolean;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -566,12 +823,13 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     }>, {
       values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
       lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
-      formState: schema_d_exports.FormState;
+      formState: import("@tmagic/form-schema").FormState;
       initialized: import("@vue/reactivity").Ref<boolean, boolean>;
       changeRecords: import("@vue/reactivity").ShallowRef<import("@tmagic/editor").ChangeRecord[], import("@tmagic/editor").ChangeRecord[]>;
       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;
@@ -583,7 +841,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       disabled: boolean;
       labelWidth: string;
       inline: boolean;
-      labelPosition: string;
+      labelPosition: "top" | "left" | "right";
       config: schema_d_exports.FormConfig;
       height: string;
       initValues: Record<string, any>;
@@ -591,7 +849,9 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare: boolean;
       keyProp: string;
       parentValues: Record<string, any>;
+      useFieldTextInError: boolean;
       stepActive: string | number;
+      validateOnInit: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -616,7 +876,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     disabled: boolean;
     labelWidth: string;
     inline: boolean;
-    labelPosition: string;
+    labelPosition: "top" | "left" | "right";
     config: schema_d_exports.FormConfig;
     height: string;
     initValues: Record<string, any>;
@@ -624,7 +884,9 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare: boolean;
     keyProp: string;
     parentValues: Record<string, any>;
+    useFieldTextInError: boolean;
     stepActive: string | number;
+    validateOnInit: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -632,16 +894,19 @@ 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;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    useFieldTextInError?: boolean;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -655,15 +920,16 @@ 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")> & {
+  }>, "values" | "changeHandler" | "validate" | "lastValuesProcessed" | "submitForm" | "changeRecords" | "initialized" | "formState" | "resetForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "useFieldTextInError" | "stepActive" | "validateOnInit")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
-    formState: schema_d_exports.FormState;
+    formState: import("@tmagic/form-schema").FormState;
     initialized: boolean;
     changeRecords: import("@tmagic/editor").ChangeRecord[];
     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;
@@ -691,12 +957,14 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   destroyOnClose: boolean;
   showClose: boolean;
   config: schema_d_exports.FormConfig;
+  useFieldTextInError: boolean;
+  validateOnInit: boolean;
   confirmText: string;
   showCancel: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$29: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
+declare const __VLS_export$29: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
 declare const _default$14: typeof __VLS_export$29;
-type __VLS_WithSlots$4<T, S> = T & {
+type __VLS_WithSlots$5<T, S> = T & {
   new (): {
     $slots: S;
   };
@@ -709,6 +977,10 @@ type __VLS_Props$28 = {
   parentValues?: Object;
   width?: string | number;
   labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   disabled?: boolean;
   closeOnPressEscape?: boolean;
   title?: string;
@@ -716,10 +988,14 @@ type __VLS_Props$28 = {
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
   inline?: boolean;
-  labelPosition?: string;
-  preventSubmitDefault?: 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>>;
+  labelPosition?: 'top' | 'left' | 'right';
+  preventSubmitDefault?: boolean;
+  /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean;
+  /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
+  beforeClose?: (_done: (_cancel?: boolean) => void) => void;
+  /** 透传给内部 `MForm` 的宿主业务上下文 */
+  context?: schema_d_exports.FormContext;
   /**
    * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
    * 计算结果会再次 `provide` 出去，使得 Drawer 被 Teleport 到 body 后，内部子树
@@ -728,14 +1004,14 @@ type __VLS_Props$28 = {
   theme?: string;
 };
 declare var __VLS_23: {}, __VLS_38: {}, __VLS_46: {};
-type __VLS_Slots$3 = {} & {
+type __VLS_Slots$4 = {} & {
   default?: (props: typeof __VLS_23) => any;
 } & {
   left?: (props: typeof __VLS_38) => any;
 } & {
   footer?: (props: typeof __VLS_46) => any;
 };
-declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Props$28, {
+declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Props$28, {
   form: import("@vue/reactivity").Ref<({
     $: import("@vue/runtime-core").ComponentInternalInstance;
     $data: {};
@@ -746,16 +1022,19 @@ 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;
       readonly size?: "small" | "default" | "large" | undefined;
       readonly inline?: boolean | undefined;
-      readonly labelPosition?: string | undefined;
+      readonly labelPosition?: "top" | "left" | "right" | undefined;
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -788,16 +1067,19 @@ 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;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      useFieldTextInError?: boolean;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -814,12 +1096,13 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     }>, {
       values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
       lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
-      formState: schema_d_exports.FormState;
+      formState: import("@tmagic/form-schema").FormState;
       initialized: import("@vue/reactivity").Ref<boolean, boolean>;
       changeRecords: import("@vue/reactivity").ShallowRef<import("@tmagic/editor").ChangeRecord[], import("@tmagic/editor").ChangeRecord[]>;
       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;
@@ -831,7 +1114,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       disabled: boolean;
       labelWidth: string;
       inline: boolean;
-      labelPosition: string;
+      labelPosition: "top" | "left" | "right";
       config: schema_d_exports.FormConfig;
       height: string;
       initValues: Record<string, any>;
@@ -839,7 +1122,9 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare: boolean;
       keyProp: string;
       parentValues: Record<string, any>;
+      useFieldTextInError: boolean;
       stepActive: string | number;
+      validateOnInit: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -864,7 +1149,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     disabled: boolean;
     labelWidth: string;
     inline: boolean;
-    labelPosition: string;
+    labelPosition: "top" | "left" | "right";
     config: schema_d_exports.FormConfig;
     height: string;
     initValues: Record<string, any>;
@@ -872,7 +1157,9 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare: boolean;
     keyProp: string;
     parentValues: Record<string, any>;
+    useFieldTextInError: boolean;
     stepActive: string | number;
+    validateOnInit: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -880,16 +1167,19 @@ 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;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    useFieldTextInError?: boolean;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -903,15 +1193,16 @@ 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")> & {
+  }>, "values" | "changeHandler" | "validate" | "lastValuesProcessed" | "submitForm" | "changeRecords" | "initialized" | "formState" | "resetForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "useFieldTextInError" | "stepActive" | "validateOnInit")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
-    formState: schema_d_exports.FormState;
+    formState: import("@tmagic/form-schema").FormState;
     initialized: boolean;
     changeRecords: import("@tmagic/editor").ChangeRecord[];
     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;
@@ -925,16 +1216,19 @@ 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;
       readonly size?: "small" | "default" | "large" | undefined;
       readonly inline?: boolean | undefined;
-      readonly labelPosition?: string | undefined;
+      readonly labelPosition?: "top" | "left" | "right" | undefined;
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -967,16 +1261,19 @@ 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;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      useFieldTextInError?: boolean;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -993,12 +1290,13 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     }>, {
       values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
       lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
-      formState: schema_d_exports.FormState;
+      formState: import("@tmagic/form-schema").FormState;
       initialized: import("@vue/reactivity").Ref<boolean, boolean>;
       changeRecords: import("@vue/reactivity").ShallowRef<import("@tmagic/editor").ChangeRecord[], import("@tmagic/editor").ChangeRecord[]>;
       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;
@@ -1010,7 +1308,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       disabled: boolean;
       labelWidth: string;
       inline: boolean;
-      labelPosition: string;
+      labelPosition: "top" | "left" | "right";
       config: schema_d_exports.FormConfig;
       height: string;
       initValues: Record<string, any>;
@@ -1018,7 +1316,9 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare: boolean;
       keyProp: string;
       parentValues: Record<string, any>;
+      useFieldTextInError: boolean;
       stepActive: string | number;
+      validateOnInit: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1043,7 +1343,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     disabled: boolean;
     labelWidth: string;
     inline: boolean;
-    labelPosition: string;
+    labelPosition: "top" | "left" | "right";
     config: schema_d_exports.FormConfig;
     height: string;
     initValues: Record<string, any>;
@@ -1051,7 +1351,9 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare: boolean;
     keyProp: string;
     parentValues: Record<string, any>;
+    useFieldTextInError: boolean;
     stepActive: string | number;
+    validateOnInit: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1059,16 +1361,19 @@ 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;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    useFieldTextInError?: boolean;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1082,23 +1387,27 @@ 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")> & {
+  }>, "values" | "changeHandler" | "validate" | "lastValuesProcessed" | "submitForm" | "changeRecords" | "initialized" | "formState" | "resetForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "useFieldTextInError" | "stepActive" | "validateOnInit")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
-    formState: schema_d_exports.FormState;
+    formState: import("@tmagic/form-schema").FormState;
     initialized: boolean;
     changeRecords: import("@tmagic/editor").ChangeRecord[];
     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;
@@ -1120,11 +1429,13 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   values: Object;
   closeOnPressEscape: boolean;
   config: schema_d_exports.FormConfig;
+  useFieldTextInError: boolean;
+  validateOnInit: 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>;
+declare const __VLS_export$28: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
 declare const _default$15: typeof __VLS_export$28;
-type __VLS_WithSlots$3<T, S> = T & {
+type __VLS_WithSlots$4<T, S> = T & {
   new (): {
     $slots: S;
   };
@@ -1138,23 +1449,30 @@ type __VLS_Props$27 = {
   width?: number;
   height?: number;
   labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  validateOnInit?: boolean;
   disabled?: boolean;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   preventSubmitDefault?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean;
+  /** 透传给内部 `MForm` 的宿主业务上下文 */
+  context?: schema_d_exports.FormContext;
 };
 declare var __VLS_16$1: {}, __VLS_18$1: {}, __VLS_20: {};
-type __VLS_Slots$2 = {} & {
+type __VLS_Slots$3 = {} & {
   default?: (props: typeof __VLS_16$1) => any;
 } & {
   left?: (props: typeof __VLS_18$1) => any;
 } & {
   footer?: (props: typeof __VLS_20) => any;
 };
-declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Props$27, {
+declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Props$27, {
   form: import("@vue/reactivity").Ref<({
     $: import("@vue/runtime-core").ComponentInternalInstance;
     $data: {};
@@ -1165,16 +1483,19 @@ 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;
       readonly size?: "small" | "default" | "large" | undefined;
       readonly inline?: boolean | undefined;
-      readonly labelPosition?: string | undefined;
+      readonly labelPosition?: "top" | "left" | "right" | undefined;
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -1207,16 +1528,19 @@ 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;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      useFieldTextInError?: boolean;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -1233,12 +1557,13 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     }>, {
       values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
       lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
-      formState: schema_d_exports.FormState;
+      formState: import("@tmagic/form-schema").FormState;
       initialized: import("@vue/reactivity").Ref<boolean, boolean>;
       changeRecords: import("@vue/reactivity").ShallowRef<import("@tmagic/editor").ChangeRecord[], import("@tmagic/editor").ChangeRecord[]>;
       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;
@@ -1250,7 +1575,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       disabled: boolean;
       labelWidth: string;
       inline: boolean;
-      labelPosition: string;
+      labelPosition: "top" | "left" | "right";
       config: schema_d_exports.FormConfig;
       height: string;
       initValues: Record<string, any>;
@@ -1258,7 +1583,9 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare: boolean;
       keyProp: string;
       parentValues: Record<string, any>;
+      useFieldTextInError: boolean;
       stepActive: string | number;
+      validateOnInit: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1283,7 +1610,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     disabled: boolean;
     labelWidth: string;
     inline: boolean;
-    labelPosition: string;
+    labelPosition: "top" | "left" | "right";
     config: schema_d_exports.FormConfig;
     height: string;
     initValues: Record<string, any>;
@@ -1291,7 +1618,9 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare: boolean;
     keyProp: string;
     parentValues: Record<string, any>;
+    useFieldTextInError: boolean;
     stepActive: string | number;
+    validateOnInit: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1299,16 +1628,19 @@ 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;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    useFieldTextInError?: boolean;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1322,15 +1654,16 @@ 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")> & {
+  }>, "values" | "changeHandler" | "validate" | "lastValuesProcessed" | "submitForm" | "changeRecords" | "initialized" | "formState" | "resetForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "useFieldTextInError" | "stepActive" | "validateOnInit")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
-    formState: schema_d_exports.FormState;
+    formState: import("@tmagic/form-schema").FormState;
     initialized: boolean;
     changeRecords: import("@tmagic/editor").ChangeRecord[];
     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;
@@ -1344,16 +1677,19 @@ 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;
       readonly size?: "small" | "default" | "large" | undefined;
       readonly inline?: boolean | undefined;
-      readonly labelPosition?: string | undefined;
+      readonly labelPosition?: "top" | "left" | "right" | undefined;
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -1386,16 +1722,19 @@ 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;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      useFieldTextInError?: boolean;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -1412,12 +1751,13 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     }>, {
       values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
       lastValuesProcessed: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
-      formState: schema_d_exports.FormState;
+      formState: import("@tmagic/form-schema").FormState;
       initialized: import("@vue/reactivity").Ref<boolean, boolean>;
       changeRecords: import("@vue/reactivity").ShallowRef<import("@tmagic/editor").ChangeRecord[], import("@tmagic/editor").ChangeRecord[]>;
       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;
@@ -1429,7 +1769,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       disabled: boolean;
       labelWidth: string;
       inline: boolean;
-      labelPosition: string;
+      labelPosition: "top" | "left" | "right";
       config: schema_d_exports.FormConfig;
       height: string;
       initValues: Record<string, any>;
@@ -1437,7 +1777,9 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       isCompare: boolean;
       keyProp: string;
       parentValues: Record<string, any>;
+      useFieldTextInError: boolean;
       stepActive: string | number;
+      validateOnInit: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1462,7 +1804,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     disabled: boolean;
     labelWidth: string;
     inline: boolean;
-    labelPosition: string;
+    labelPosition: "top" | "left" | "right";
     config: schema_d_exports.FormConfig;
     height: string;
     initValues: Record<string, any>;
@@ -1470,7 +1812,9 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     isCompare: boolean;
     keyProp: string;
     parentValues: Record<string, any>;
+    useFieldTextInError: boolean;
     stepActive: string | number;
+    validateOnInit: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1478,16 +1822,19 @@ 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;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    useFieldTextInError?: boolean;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1501,15 +1848,16 @@ 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")> & {
+  }>, "values" | "changeHandler" | "validate" | "lastValuesProcessed" | "submitForm" | "changeRecords" | "initialized" | "formState" | "resetForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "useFieldTextInError" | "stepActive" | "validateOnInit")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
-    formState: schema_d_exports.FormState;
+    formState: import("@tmagic/form-schema").FormState;
     initialized: boolean;
     changeRecords: import("@tmagic/editor").ChangeRecord[];
     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;
@@ -1528,31 +1876,39 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
 }>, {
   values: Object;
   config: schema_d_exports.FormConfig;
+  useFieldTextInError: boolean;
+  validateOnInit: 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>;
+declare const __VLS_export$27: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
 declare const _default$13: typeof __VLS_export$27;
-type __VLS_WithSlots$2<T, S> = T & {
+type __VLS_WithSlots$3<T, S> = T & {
   new (): {
     $slots: S;
   };
 };
 //#endregion
 //#region temp/packages/form/src/containers/Container.vue.d.ts
-type __VLS_Slots$1 = FormSlots;
+type __VLS_Slots$2 = FormSlots;
 type __VLS_Props$26 = {
-  /** 表单值 */model: schema_d_exports.FormValue; /** 需对比的值（开启对比模式时传入） */
+  /** 表单值 */
+  model: schema_d_exports.FormValue;
+  /** 需对比的值（开启对比模式时传入） */
   lastValues?: schema_d_exports.FormValue;
   config: schema_d_exports.FormItemConfig;
   prop?: string;
   disabled?: boolean;
   labelWidth?: string | number;
+  labelPosition?: 'top' | 'left' | 'right';
   expandMore?: boolean;
   stepActive?: string | number;
-  size?: string; /** 是否开启对比模式 */
+  size?: string;
+  /** 是否开启对比模式 */
   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, {
+declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Props$26, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData: ContainerChangeEventData) => any;
   addDiffCount: () => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$26> & Readonly<{
@@ -1565,9 +1921,9 @@ declare const __VLS_base$1: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   isCompare: boolean;
   expandMore: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$26: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const __VLS_export$26: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
 declare const _default$4: typeof __VLS_export$26;
-type __VLS_WithSlots$1<T, S> = T & {
+type __VLS_WithSlots$2<T, S> = T & {
   new (): {
     $slots: S;
   };
@@ -1576,6 +1932,7 @@ type __VLS_WithSlots$1<T, S> = T & {
 //#region temp/packages/form/src/containers/Fieldset.vue.d.ts
 type __VLS_Props$25 = {
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop: string;
   size?: string;
   model: Record<string, any>;
@@ -1607,6 +1964,7 @@ type __VLS_Props$24 = {
   config: FlexLayoutConfig;
   name?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop?: string;
   size?: string;
   disabled?: boolean;
@@ -1628,18 +1986,19 @@ type __VLS_Props$23 = {
   config: schema_d_exports.PanelConfig;
   name?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop?: string;
   size?: string;
   disabled?: boolean;
   hideExpand?: boolean;
 };
 declare var __VLS_16: {}, __VLS_18: {};
-type __VLS_Slots = {} & {
+type __VLS_Slots$1 = {} & {
   header?: (props: typeof __VLS_16) => any;
 } & {
   default?: (props: typeof __VLS_18) => any;
 };
-declare const __VLS_base: import("@vue/runtime-core").DefineComponent<__VLS_Props$23, {
+declare const __VLS_base$1: import("@vue/runtime-core").DefineComponent<__VLS_Props$23, {
   getExpand: () => boolean;
   setExpand: (v: boolean) => void;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
@@ -1649,9 +2008,9 @@ declare const __VLS_base: import("@vue/runtime-core").DefineComponent<__VLS_Prop
   onChange?: ((v: any, eventData: ContainerChangeEventData) => any) | undefined;
   onAddDiffCount?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$23: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const __VLS_export$23: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
 declare const _default$21: typeof __VLS_export$23;
-type __VLS_WithSlots<T, S> = T & {
+type __VLS_WithSlots$1<T, S> = T & {
   new (): {
     $slots: S;
   };
@@ -1665,6 +2024,7 @@ type __VLS_Props$22 = {
   config: schema_d_exports.RowConfig;
   name: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop?: string;
   size?: string;
   expandMore?: boolean;
@@ -1688,6 +2048,7 @@ type __VLS_Props$21 = {
   name: string;
   size?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop?: string;
   expandMore?: boolean;
   disabled?: boolean;
@@ -1714,6 +2075,7 @@ type __VLS_Props$20 = {
   name: string;
   prop?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   disabled?: boolean;
   size?: string;
   enableToggleMode?: true;
@@ -1721,7 +2083,11 @@ type __VLS_Props$20 = {
   sortKey?: string;
   sort?: boolean;
 };
-declare const __VLS_export$20: import("@vue/runtime-core").DefineComponent<__VLS_Props$20, {
+declare var __VLS_33: any;
+type __VLS_Slots = {} & {
+  title?: (props: typeof __VLS_33) => any;
+};
+declare const __VLS_base: import("@vue/runtime-core").DefineComponent<__VLS_Props$20, {
   toggleRowSelection: (row: any, selected: boolean) => void | undefined;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
@@ -1732,7 +2098,13 @@ declare const __VLS_export$20: import("@vue/runtime-core").DefineComponent<__VLS
   onSelect?: ((...args: any[]) => any) | undefined;
   onAddDiffCount?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$20: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default$16: typeof __VLS_export$20;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
 //#endregion
 //#region temp/packages/form/src/fields/Text.vue.d.ts
 type __VLS_Props$19 = schema_d_exports.FieldProps<schema_d_exports.TextConfig>;
@@ -1756,7 +2128,7 @@ declare const __VLS_export$18: import("@vue/runtime-core").DefineComponent<__VLS
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$19: typeof __VLS_export$18;
 //#endregion
-//#region temp/packages/form/src/fields/NumberRange.vue.d.ts
+//#region temp/packages/form/src/fields/NumberRange/Index.vue.d.ts
 type __VLS_Props$17 = schema_d_exports.FieldProps<schema_d_exports.NumberRangeConfig>;
 declare const __VLS_export$17: import("@vue/runtime-core").DefineComponent<__VLS_Props$17, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (values: [number, number]) => any;
@@ -1785,7 +2157,7 @@ type __VLS_Props$15 = {
 declare const __VLS_export$15: import("@vue/runtime-core").DefineComponent<__VLS_Props$15, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$15> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$17: typeof __VLS_export$15;
 //#endregion
-//#region temp/packages/form/src/fields/Date.vue.d.ts
+//#region temp/packages/form/src/fields/Date/Index.vue.d.ts
 type __VLS_Props$14 = schema_d_exports.FieldProps<schema_d_exports.DateConfig>;
 declare const __VLS_export$14: import("@vue/runtime-core").DefineComponent<__VLS_Props$14, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (value: string) => any;
@@ -1794,7 +2166,7 @@ declare const __VLS_export$14: import("@vue/runtime-core").DefineComponent<__VLS
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$5: typeof __VLS_export$14;
 //#endregion
-//#region temp/packages/form/src/fields/DateTime.vue.d.ts
+//#region temp/packages/form/src/fields/DateTime/Index.vue.d.ts
 type __VLS_Props$13 = schema_d_exports.FieldProps<schema_d_exports.DateTimeConfig>;
 declare const __VLS_export$13: import("@vue/runtime-core").DefineComponent<__VLS_Props$13, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (value: string) => any;
@@ -1857,7 +2229,7 @@ declare const __VLS_export$7: import("@vue/runtime-core").DefineComponent<__VLS_
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$3: typeof __VLS_export$7;
 //#endregion
-//#region temp/packages/form/src/fields/CheckboxGroup.vue.d.ts
+//#region temp/packages/form/src/fields/CheckboxGroup/Index.vue.d.ts
 type __VLS_Props$6 = schema_d_exports.FieldProps<schema_d_exports.CheckboxGroupConfig>;
 declare const __VLS_export$6: import("@vue/runtime-core").DefineComponent<__VLS_Props$6, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
@@ -1875,7 +2247,7 @@ declare const __VLS_export$5: import("@vue/runtime-core").DefineComponent<__VLS_
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$22: typeof __VLS_export$5;
 //#endregion
-//#region temp/packages/form/src/fields/Display.vue.d.ts
+//#region temp/packages/form/src/fields/Display/Index.vue.d.ts
 type __VLS_Props$4 = schema_d_exports.FieldProps<schema_d_exports.DisplayConfig>;
 declare const __VLS_export$4: import("@vue/runtime-core").DefineComponent<__VLS_Props$4, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$4> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$8: typeof __VLS_export$4;
@@ -1938,7 +2310,7 @@ declare const __VLS_export$1: import("@vue/runtime-core").DefineComponent<__VLS_
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export$1;
 //#endregion
-//#region temp/packages/form/src/fields/DynamicField.vue.d.ts
+//#region temp/packages/form/src/fields/DynamicField/Index.vue.d.ts
 type __VLS_Props = schema_d_exports.FieldProps<schema_d_exports.DynamicFieldConfig>;
 declare const __VLS_export: import("@vue/runtime-core").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
@@ -1947,21 +2319,369 @@ declare const __VLS_export: import("@vue/runtime-core").DefineComponent<__VLS_Pr
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$9: typeof __VLS_export;
 //#endregion
-//#region temp/packages/form/src/utils/config.d.ts
-declare const registerField: (tagName: string, component: Component) => void;
-declare const getField: (tagName: string) => Component | undefined;
-declare const deleteField: (tagName: string) => boolean;
+//#region temp/packages/form/src/utils/collectFields.d.ts
+/** 一个参与校验的字段：与渲染式校验中「一个带 rules 的 TMagicFormItem」一一对应 */
+interface CollectedField {
+  /** 字段的完整 prop 路径（从表单根 values 起算，与 FormItem 的 prop 一致） */
+  prop: string;
+  /** 经 `getNativeRules` 处理后的规则（validator 为 async-validator 原生签名） */
+  rules: schema_d_exports.Rule[];
+  /** 字段配置 */
+  config: schema_d_exports.FormItemConfig;
+  /** 字段所在层级的 model 切片 */
+  model: schema_d_exports.FormValue;
+}
+/** 已登记的 innerConfig 回调自身抛错时抛出（机制故障，不是漏登记） */
+export declare class FieldInnerConfigError extends Error {
+  readonly code = "FIELD_INNER_CONFIG";
+  readonly type: string;
+  readonly prop: string;
+  constructor(type: string, prop: string, cause: unknown);
+}
+export declare const isFieldInnerConfigError: (error: unknown) => error is FieldInnerConfigError;
+/**
+ * 遍历模式。同一套遍历规则服务两个用途，避免两条链路各写一份而产生偏差：
+ *
+ * - `collect`：收集带 rules 的字段，按 `display` 过滤（对应「渲染出来的 FormItem 集合」）；
+ * - `effects`：执行字段登记的值初始化写入，不收集字段，且不看 `display`
+ *   （`display: false` 的字段同样要规整；`type: 'hidden'` 在该节点停止，不往下分派）。
+ */
+type WalkMode = 'collect' | 'effects';
+interface WalkContext {
+  mForm: schema_d_exports.FormState | undefined;
+  /**
+   * 是否自动给字段注入 typeMatch 规则，对应 MForm 的 `typeMatchValid`。
+   *
+   * 只在 `collect` 模式下有用：`addField` 把它交给 `getNativeRules`。为 true 且字段
+   * rules 尚未显式声明 `typeMatch`（true / false）时，自动补一条 `{ typeMatch: true }`，
+   * 按字段 `type` 校验当前值形态是否合法（空值放行，必填仍靠 `required`）。
+   * 单字段可在 rules 里写 `typeMatch: false` 关闭自动注入。
+   *
+   * `effects` 模式不收集规则，无需传入。
+   */
+  typeMatchValid?: boolean;
+  fields: CollectedField[];
+  /** 本次遍历处理的表单值根对象（对比模式下为 lastValues 那一份） */
+  values: schema_d_exports.FormValue;
+  mode: WalkMode;
+}
+interface WalkNode {
+  config: schema_d_exports.FormItemConfig;
+  /** 所在层级的 model 切片（对应 Container 的 `props.model`） */
+  model: schema_d_exports.FormValue;
+  /** 父级 prop（对应 Container 的 `props.prop`） */
+  prop: string;
+}
+type ContainerWalker = (_ctx: WalkContext, _node: WalkNode, _itemProp: string) => void;
+/**
+ * 纯逻辑收集「一份 config + 一份 values」中所有参与校验的字段。
+ *
+ * 遍历规则与 `Container.vue` 及各容器组件的模板一一对应，因此产出的 prop / rules
+ * 与渲染式校验（挂载 MForm 后调用 `validate()`）等价，无需任何 DOM 或组件实例。
+ *
+ * 本函数只读不写。字段的值初始化副作用由 `applyMountValueEffects` 负责，
+ * 调用方需在初始化表单值之后、收集字段之前执行一次（`validateValues` 已经这么做）。
+ *
+ * @param mForm - 表单状态；无渲染时由 `createHeadlessFormState` 构造
+ * @param config - 表单配置
+ * @param values - 表单值
+ * @param [typeMatchValid] - 是否自动注入 typeMatch 规则；为 true 时，未显式声明
+ *   `typeMatch` 的字段会补上 `{ typeMatch: true }`，按字段 type 校验值形态
+ * @returns 带规则的字段列表
+ */
+export declare const collectValidatableFields: (mForm: schema_d_exports.FormState | undefined, config: schema_d_exports.FormConfig, values: schema_d_exports.FormValue, typeMatchValid?: boolean) => CollectedField[];
+/**
+ * 执行「一份 config + 一份 values」中所有叶子字段登记的值初始化写入，就地改写 `values`。
+ *
+ * 渲染与无渲染两条链路共用的唯一执行点：字段组件自身不再在 setup 里改写 model，
+ * 由持有完整表单值的一方（`Form.vue` / `validateValues`）在表单值初始化完成、
+ * 且已挂到 `mForm.values` 之后调用一次。这样 effect 与动态 `type` 回调读到的
+ * `formValue` 就是最新值，而不是上一轮的旧值。
+ *
+ * 与 `collectValidatableFields` 的差异：不看 `display`（`display: false` 的字段也会规整）。
+ * `type: 'hidden'` 会在该节点停止遍历，内部字段不执行 effect。
+ *
+ * `prop` 与 `values` 都以传入的 `values` 为根，因此也可以用于 tab / table 新增行这类
+ * 「先构造一份子树的值，再挂到表单上」的场景：传入子树配置与该行的值即可。
+ *
+ * @param mForm - 表单状态；无渲染时由 `createHeadlessFormState` 构造
+ * @param config - 表单配置
+ * @param values - 表单值（会被就地修改）
+ */
+export declare const applyMountValueEffects: (mForm: schema_d_exports.FormState | undefined, config: schema_d_exports.FormConfig, values: schema_d_exports.FormValue) => void;
+//#endregion
+//#region temp/packages/form/src/utils/fieldInnerConfig.d.ts
+/** innerConfig 回调的入参：字段自身的配置、所在层级的 model、完整字段路径与表单状态 */
+interface FieldInnerConfigContext {
+  /** 字段自身的配置（已经过 filterFunction 之外的原样配置） */
+  config: schema_d_exports.FormItemConfig;
+  /** 字段所在层级的 model 切片 */
+  model: schema_d_exports.FormValue;
+  /** 字段的完整 prop 路径（含父级前缀），即字段组件拿到的 `props.prop` */
+  prop: string;
+  /** 字段所在层级的 prop 基准（父级 Container 的 `props.prop`），即 `prop` 去掉自身 name 的部分 */
+  parentProp: string;
+  /** 表单状态 */
+  mForm: schema_d_exports.FormState | undefined;
+}
+/** innerConfig 回调的返回值：需要继续遍历的内部配置及其 model / prop 基准 */
+interface FieldInnerConfigResult {
+  /** 内部配置（对应字段组件内部渲染的 `MContainer` 的 `config`） */
+  config: schema_d_exports.FormItemConfig | schema_d_exports.FormItemConfig[];
+  /**
+   * 内部配置对应的 model 切片，默认沿用字段所在层级的 `model`。
+   *
+   * 例如 `code-select` 内部是 `:model="model[name]"`，就应返回 `model[config.name]`。
+   */
+  model?: schema_d_exports.FormValue;
+  /**
+   * 内部配置对应的 prop 基准，默认沿用字段自身的 `prop`。
+   *
+   * 返回的 config 的 `name` 会被追加到这个基准上。所以当内部配置复用了字段自身的 `name`
+   * （如 `display-conds` 内部的 group-list 就叫 `props.name`）时，要返回 `parentProp`，
+   * 否则 name 会被拼两次。
+   */
+  prop?: string;
+}
+/**
+ * 复合字段的内部配置回调。
+ *
+ * 有一类字段组件会在自身内部再渲染 `MContainer` 并传入组件内部临时算出来的 config
+ * （如编辑器的 `code-select` / `event-select` / `style-setter`），这些内部字段同样会向
+ * 父级表单注册 FormItem、参与父表单校验。无渲染校验（`validateValues`）只遍历调用方
+ * 传入的 config 树，看不到这些运行期才产生的配置，因此需要字段作者通过
+ * `registerField(type, { innerConfig })` 把内部配置交出来。
+ *
+ * 返回 `null` / `undefined` 表示该字段本次没有内部配置（例如某些分支下不渲染子表单）。
+ *
+ * 既未登记 innerConfig、也不在叶子字段表里的 type：配置里有 `items` 会下钻子项，
+ * 自身有 `rules` 会校验自身。
+ */
+type FieldInnerConfig = (_ctx: FieldInnerConfigContext) => FieldInnerConfigResult | null | undefined | void;
+//#endregion
+//#region temp/packages/form/src/utils/fieldValueEffects.d.ts
+/** effect 的入参：字段自身的配置、所在层级的 model、完整字段路径、表单值根对象与表单状态 */
+interface FieldMountValueEffectContext {
+  /** 字段自身的配置 */
+  config: schema_d_exports.FormItemConfig;
+  /** 字段所在层级的 model 切片 */
+  model: schema_d_exports.FormValue;
+  /** 字段的完整 prop 路径（含父级前缀），对应 Container 的 `itemProp` */
+  prop: string;
+  /**
+   * 本次处理的表单值根对象，`prop` 即以它为根。
+   *
+   * 需要按路径跨层级写值时用它，不要用 `mForm.values`：对比模式下处理的是 lastValues 那一份，
+   * tab / table 新增行处理的则是还没挂到表单上的一行值，两者都与 `mForm.values` 不是同一个对象。
+   */
+  values: schema_d_exports.FormValue;
+  /** 表单状态 */
+  mForm: schema_d_exports.FormState | undefined;
+}
+/**
+ * 字段对表单值的初始化写入（如 `display` 的 `initValue`、`date` 的格式归一化）。
+ *
+ * 由 `applyMountValueEffects` 在表单值初始化完成后统一执行一次，渲染与无渲染共用。
+ * 因为可能对同一份值重复执行（如 `initValues` 变化后重新初始化），实现必须幂等。
+ */
+type FieldMountValueEffect = (_ctx: FieldMountValueEffectContext) => void;
+/**
+ * 是否为叶子字段 type（内置 ∪ 已登记）。
+ *
+ * @param type - 字段 type
+ * @returns 是否为叶子
+ */
+export declare const isLeafFieldType: (type: 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 校验规则（业务侧优先于内置） */
+export declare const getTypeMatchRule: (type: string) => TypeMatchValidator | undefined;
+/** 删除业务侧 typeMatch 校验规则（不影响内置） */
+export declare const deleteTypeMatchRule: (type: string) => boolean;
+/** 清空业务侧 typeMatch 校验规则（不影响内置） */
+export declare const clearTypeMatchRules: () => void;
+/**
+ * 将值格式化为可读的参考示例字符串。
+ */
+export declare const stringifyExampleValue: (value: any) => string;
+/** 参考建议中可选值全量展示上限；超出时仅举例 EXAMPLE_SUGGESTION_COUNT 个并标明总数。 */
+export declare const MAX_SUGGESTION_OPTIONS = 20;
+/**
+ * 生成可选项参考建议；无可选值时返回空字符串（不追加建议）。
+ * 未超过 MAX_SUGGESTION_OPTIONS 时全部列举；超过时仅举例前 EXAMPLE_SUGGESTION_COUNT 个并标明总数，避免 AI 误以为仅有举例值合法。
+ */
+export declare const optionSuggestion: (optionValues: any[]) => string;
+/**
+ * 校验取值与字段 type 是否匹配；通过返回 undefined，否则返回错误文案。
+ *
+ * 命中的自定义规则是异步校验器时返回 Promise，内置规则始终同步返回。
+ */
+export 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/utils/registerField.d.ts
+/**
+ * 自定义字段 type 的登记项。
+ *
+ * 不传或只传空对象：当作叶子，不再下钻 `items`。
+ */
+interface FieldOptions {
+  /**
+   * 渲染用的 Vue 组件，写入字段注册表。
+   * 传入 `app` 时同时 `app.component('m-fields-*')`。
+   */
+  component?: Component;
+  /**
+   * 容器组件，写入字段注册表。
+   * 传入 `app` 时同时 `app.component('m-form-*')`。
+   */
+  container?: Component;
+  /** 字段挂载时改写 model 的副作用。可与 `innerConfig` 同时登记。 */
+  effect?: FieldMountValueEffect;
+  /**
+   * 按容器模板遍历（tab / table 等）。
+   * 与 `innerConfig` / `effect` 同时传入时 `walk` 优先。
+   */
+  walk?: ContainerWalker;
+  /**
+   * 把内部会挂到父表单的配置交出来。
+   * 可与 `effect` 同时传入：`effect` 负责本字段的值初始化，`innerConfig` 只做配置派生。
+   */
+  innerConfig?: FieldInnerConfig;
+  /** 该 type 的 typeMatch 校验；可与叶子、walk 或 innerConfig 同时登记。 */
+  typeMatch?: TypeMatchValidator;
+}
+/**
+ * 无渲染校验用的登记项，不含 Vue 组件。
+ *
+ * 给 Node / `validateForm` / `submitForm` 用。
+ */
+type HeadlessFieldOptions = Omit<FieldOptions, 'component' | 'container'>;
+/**
+ * 把多份字段登记表按 type 浅合并。后一份只覆盖自己带了的 key，未出现的 key 保留前一份。
+ *
+ * 安装插件时用：Node 侧只登记 `headless`，浏览器再补 `component` / `container`。
+ *
+ * @param tables - 待合并的登记表，`undefined` 会被跳过
+ * @returns 合并后的登记表
+ */
+export declare const mergeFieldOptions: (...tables: Array<Record<string, HeadlessFieldOptions | FieldOptions> | undefined>) => Record<string, FieldOptions>;
+/**
+ * 按字段 type 取已登记的渲染组件（`codeSelect` 与 `code-select` 等价）。
+ *
+ * @param type - 字段 type
+ * @returns 已登记的 Vue 组件；未登记则为 `undefined`
+ */
+declare const getField: (type: string) => Component | undefined;
+/**
+ * 登记一个字段 type 在无渲染校验里的行为，以及可选的渲染组件。
+ *
+ * `type` 会按 Container 的规则归一化为中划线形式（`codeSelect` 与 `code-select` 等价）。
+ * 对同一 type 重复登记按字段浅合并：后一次只覆盖自己传入的 key，未传入的 key 保留。
+ * 传入 `app` 且带了 `component` / `container` 时，会同步 `app.component('m-fields-*'` / `'m-form-*')`。
+ *
+ * @param type - 字段 type
+ * @param [options] - 登记项；省略或空对象视为叶子
+ * @param [app] - Vue 应用；省略则不调用 `app.component`
+ */
+export declare const registerField: (type: string, options?: FieldOptions, app?: App) => void;
+/**
+ * 批量登记字段。
+ *
+ * @param fields - type 到登记项的映射
+ * @param [app] - Vue 应用；省略则不调用 `app.component`
+ */
+export declare const registerFields: (fields: Record<string, FieldOptions>, app?: App) => void;
+/**
+ * 登记内置字段（`clearFields` / `unregisterField` 不会清掉）。
+ *
+ * @param fields - type 到登记项的映射
+ * @param [app] - Vue 应用；省略则不调用 `app.component`
+ */
+export declare const registerBuiltInFields: (fields: Record<string, FieldOptions>, app?: App) => void;
+/**
+ * 删除业务侧对指定 type 的登记（不影响内置；主要用于单测）。
+ *
+ * @param type - 字段 type
+ */
+export declare const unregisterField: (type: string) => void;
+/** 清空业务侧登记（不影响内置；主要用于单测）。 */
+export declare const clearFields: () => void;
+//#endregion
+//#region temp/packages/form/src/utils/builtInFields.d.ts
+/**
+ * 内置字段的无渲染登记表（不含 Vue 组件）。
+ *
+ * 本模块只导出数据，不登记。调用方自行 `registerBuiltInFields(builtInFields)`，
+ * 或 `app.use(MagicForm)`（install 里会登记叠上 Vue 组件后的表）。
+ */
+export declare const builtInFields: Record<string, HeadlessFieldOptions>;
+//#endregion
+//#region temp/packages/form/src/utils/validateError.d.ts
+/**
+ * 通过 name 从 config 中查找对应的 text
+ *
+ * @param name - 字段名，支持点分隔的路径格式，如 'a.b.c'
+ * @param config - 表单配置数组
+ * @returns 找到的 text 值，如果未找到则返回 undefined
+ */
+export declare const getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
+/**
+ * 将校验返回的 invalidFields 汇总为可读的错误文案（多条以 `<br>` 拼接）。
+ *
+ * `useFieldTextInError` 为 `true`（默认）时用字段的 text 文案作为错误前缀，找不到则回退为字段 name。
+ *
+ * 由渲染式校验（Form.vue 的 `submitForm` / `validate`）与无渲染校验（`validateValues`）共用，
+ * 保证两条校验链路产出的错误文案格式完全一致。
+ *
+ * @param invalidFields - async-validator 产出的字段错误表
+ * @param [options] - 文案选项
+ * @param [options.config] - 用于查找 text 的表单配置
+ * @param [options.useFieldTextInError=true] - 错误前缀是否使用字段 text
+ * @returns 拼接后的错误文案；无错误时为空串
+ */
+export declare const formatValidateError: (invalidFields: Record<string, any>, { config, useFieldTextInError }?: {
+  config?: schema_d_exports.FormConfig;
+  useFieldTextInError?: boolean;
+}) => string;
 //#endregion
 //#region temp/packages/form/src/plugin.d.ts
+/**
+ * `@tmagic/form` 插件安装选项。
+ */
 interface FormInstallOptions {
+  /** 是否启用全局 flat 模式。 */
+  flat?: boolean;
+  /**
+   * 自定义字段 type 的登记（叶子 / innerConfig / walk / typeMatch / component / container）。
+   * 与 `registerFields` 相同。
+   */
+  fields?: Record<string, FieldOptions>;
   [key: string]: any;
 }
 declare const _default$31: {
+  /**
+   * 安装 `@tmagic/form`：登记内置字段、挂载 `m-form` / `m-form-dialog` / `m-form-drawer`。
+   *
+   * @param app - Vue 应用
+   * @param [opt] - 安装选项
+   */
   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, CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfig, FieldInnerConfigContext, FieldInnerConfigError, FieldInnerConfigResult, FieldMountValueEffect, FieldMountValueEffectContext, FieldOptions, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, HeadlessFieldOptions, HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, _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, ValidateValuesOptions, ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createForm, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, unregisterField, useAddField, validateForm, validateTypeMatch, validateValues };
 }
-declare const createForm: <T extends [] = []>(config: schema_d_exports.FormConfig | T) => schema_d_exports.FormConfig | T;
+export 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 { type CollectedField, type FieldInnerConfig, type FieldInnerConfigContext, type FieldInnerConfigResult, type FieldMountValueEffect, type FieldMountValueEffectContext, type FieldOptions, type FormInstallOptions, type HeadlessFieldOptions, type HeadlessFormStateOptions, _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, type SubmitFormOptions, type SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, type ValidateFormOptions, type ValidateValuesOptions, type ValidateValuesResult, _default$31 as default, getField as getFormField };