@tmagic/form 1.8.0-beta.25 → 1.8.0-beta.27

package/types/index.d.ts

@@ -1,8 +1,8 @@
-import { App, AppContext, Component, ComputedRef, 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";
 declare namespace schema_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_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";
 /**
@@ -33,16 +33,14 @@ interface FormDiffConfig {
 declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
 declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
 /**
- * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+ * 宿主业务上下文，由 `MForm`（或更外层的 Editor）通过 `provide` 下发。
  *
- * Container 会基于该标记，并对照 `getSilentLeafFieldTypes()`（默认 `LEAF_FIELD_TYPES`）
- * 跳过叶子字段的渲染，只保留 FormItem：字段校验由 FormItem 基于 model 值完成，与叶子 UI 组件实例无关。
- * 重型字段组件（如 vs-code）也可 inject 该标记跳过自身渲染，省去无谓的实例化开销。
+ * 嵌套表单（Link 子表单、FormBox、临时校验表单等）会自动继承最近祖先的 context，
+ * 无需层层透传。
  *
- * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
- * 字段组件可以安全跳过，接入前需逐一审计；业务扩展请使用 `registerSilentLeafFieldTypes`。
+ * 配置回调统一通过 `mForm.xxx` 读取，由 formState 的读穿 Proxy 落到这里。
  */
-declare const FORM_SILENT_MODE_KEY: InjectionKey<boolean>;
+declare const FORM_CONTEXT_KEY: InjectionKey<ComputedRef<FormContext>>;
 interface ValidateError {
   message: string;
   field: string;
@@ -73,7 +71,68 @@ 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` 注册表始终为空
+ * （该注册表在整个仓库中只写不读，不参与校验）。
+ */
+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,
+ * });
+ * ```
+ */
+declare const validateValues: (options: ValidateValuesOptions) => Promise<ValidateValuesResult>;
+//#endregion
+//#region temp/packages/form/src/utils/submitHeadless.d.ts
 /**
  * submitForm 函数参数（与 Form.vue 组件 props 对齐）
  */
@@ -93,7 +152,7 @@ interface SubmitFormOptions {
   stepActive?: string | number;
   size?: 'small' | 'default' | 'large';
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
@@ -102,7 +161,8 @@ interface SubmitFormOptions {
    * 默认 `true`，置为 `false` 时直接使用字段 name。
    */
   useFieldTextInError?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /** 宿主业务上下文，与 MForm 的同名 prop 语义一致 */
+  context?: schema_d_exports.FormContext;
   /** 透传给 Form.submitForm 的参数：是否直接返回原始响应式 values */
   native?: boolean;
   /**
@@ -112,29 +172,27 @@ interface SubmitFormOptions {
   returnChangeRecords?: boolean;
   /**
    * 父级应用上下文，用于继承全局组件、指令、provide 等。
-   * 通常通过 `app._context` 或 `getCurrentInstance()?.appContext` 获取。
+   * 仅 `dialog: true` 时生效。`@tmagic/form/headless` 不支持弹层。
    */
   appContext?: AppContext | null;
-  /** 等待表单初始化的最长时间（毫秒），超时将以错误 reject。默认 10000ms */
-  timeout?: number;
   /**
-   * 调试模式。默认 `false`。
+   * 是否以弹层展示表单。默认 `false`。
    *
-   * - `false`：表单以隐藏方式挂载，初始化完成后自动提交（原有行为）。
-   * - `true`：将表单以弹层形式可见地渲染在页面上，需手动点击「确定」才会触发校验/提交，
-   *   点击「取消」则以 reject 中断；校验失败时保留弹层并展示错误信息，便于修正后重试。
-   *   调试模式下 `timeout` 不生效（等待人工操作）。
+   * `@tmagic/form/headless` 不支持 `dialog: true`，请从 `@tmagic/form` 引入。
+   */
+  dialog?: boolean;
+  /**
+   * 弹层标题，仅 `dialog: true` 时生效。
    */
-  debug?: boolean;
+  title?: string;
   typeMatchValid?: boolean;
   /**
-   * 外部中断信号。abort 时会立即以 `signal.reason` reject 并卸载临时表单实例、移除容器。
-   * 主要用于 `debug` 模式（无超时兜底）下取消一个被放弃的表单弹层，避免其无限驻留在页面上。
+   * 外部中断信号。abort 时会立即以 `signal.reason` reject。
    */
   signal?: AbortSignal;
 }
 /**
- * 开启 `returnChangeNodes` 时 submitForm 的返回结果
+ * 开启 `returnChangeRecords` 时 submitForm 的返回结果
  */
 interface SubmitFormResult {
   /** 校验通过后的表单值 */
@@ -142,43 +200,6 @@ interface SubmitFormResult {
   /** 表单变更记录 */
   changeRecords: ChangeRecord[];
 }
-/**
- * 以命令式方式调用 Form.vue 完成一次表单校验/提交。
- *
- * 类似 ElMessage 的用法：传入 props（包含 `config`/`initValues` 等），函数内部会临时挂载
- * 一个不可见的 Form 组件实例，等待初始化完成后调用其 `submitForm` 方法，
- * 校验通过则 resolve 表单值，校验失败则 reject 错误信息，最后自动卸载实例。
- *
- * @example
- * ```ts
- * import { submitForm } from '@tmagic/form';
- *
- * try {
- *   const values = await submitForm({
- *     config: [...],
- *     initValues: { name: 'foo' },
- *   });
- *   console.log(values);
- * } catch (e) {
- *   console.error(e);
- * }
- *
- * // 需要同时获取变更记录时：
- * const { values, changeRecords } = await submitForm({
- *   config: [...],
- *   initValues: { name: 'foo' },
- *   returnChangeRecords: true,
- * });
- *
- * // 调试模式：可见地渲染表单，点击「确定」才提交：
- * const values = await submitForm({
- *   config: [...],
- *   initValues: { name: 'foo' },
- *   debug: true,
- * });
- * ```
- */
-declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
 /**
  * validateForm 函数参数（与 Form.vue 组件 props 对齐，取校验所需子集）
  */
@@ -195,30 +216,30 @@ interface ValidateFormOptions {
    * 默认 `true`，置为 `false` 时直接使用字段 name。
    */
   useFieldTextInError?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /** 宿主业务上下文，与 MForm 的同名 prop 语义一致 */
+  context?: schema_d_exports.FormContext;
   /**
-   * 父级应用上下文，用于继承全局组件、指令、provide 等。
-   * 通常通过 `app._context` 或 `getCurrentInstance()?.appContext` 获取。
+   * 父级应用上下文。仅 `dialog: true` 时生效。`@tmagic/form/headless` 不支持弹层。
    */
   appContext?: AppContext | null;
-  /** 等待表单初始化的最长时间（毫秒），超时将以错误 reject。默认 10000ms */
-  timeout?: number;
   /**
-   * 调试模式。默认 `false`。
+   * 是否以弹层展示表单。默认 `false`。
    *
-   * - `false`：以隐藏方式挂载，初始化完成后自动校验并 resolve 错误文案（原有静默行为）。
-   * - `true`：将表单以弹层形式可见地渲染在页面上，需手动点击「确定」才会触发校验，
-   *   点击「取消」则以 reject 中断；校验失败时在弹层内展示错误信息并保留弹层，便于修正后重试，
-   *   校验通过则 resolve 空字符串。调试模式下 `timeout` 不生效（等待人工操作）。
+   * `@tmagic/form/headless` 不支持 `dialog: true`，请从 `@tmagic/form` 引入。
+   */
+  dialog?: boolean;
+  /**
+   * 弹层标题，仅 `dialog: true` 时生效。
    */
-  debug?: boolean;
+  title?: string;
   typeMatchValid?: boolean;
   /**
-   * 外部中断信号。abort 时会立即以 `signal.reason` reject 并卸载临时表单实例、移除容器。
-   * 主要用于 `debug` 模式（无超时兜底）下取消一个被放弃的表单弹层，避免其无限驻留在页面上。
+   * 外部中断信号。abort 时会立即以 `signal.reason` reject。
    */
   signal?: AbortSignal;
 }
+//#endregion
+//#region temp/packages/form/src/submitForm.d.ts
 /**
  * 返回一份去除了 tab 标签页 lazy 的配置副本。
  *
@@ -228,43 +249,39 @@ interface ValidateFormOptions {
  */
 declare const stripTabItemsLazy: (config: schema_d_exports.FormConfig) => schema_d_exports.FormConfig;
 /**
- * 以命令式方式对一份「表单配置 + 值」做一次静默校验，**不依赖也不影响任何已渲染的表单**。
+ * 以命令式方式对一份「表单配置 + 值」做一次校验并取回表单值。
  *
- * 与 `submitForm` 类似，内部会临时挂载一个不可见的 MForm 实例，等待其初始化完成后调用
- * 实例的 `validate` 方法，返回汇总后的错误文案，随后自动卸载实例。
- *
- * 与 `submitForm` 的区别：
- * - 「静默」：校验失败不抛异常、不触发 `error` 事件、不返回表单值；
- * - 仅用于「探测」配置是否合法，适合源码保存后校验、批量校验组件配置等场景。
- *
- * 由于每次都新建一个独立的 MForm 实例，调用方无需持有任何表单 ref，也不会污染
- * 页面上正在展示的表单状态。
+ * 默认走无渲染实现（见 `@tmagic/form/headless`）。`dialog: true` 会把表单以弹层渲染出来。
+ */
+declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
+/**
+ * 以命令式方式对一份「表单配置 + 值」做一次静默校验。
  *
- * @returns 校验通过返回空字符串 `''`，否则返回以 `<br>` 拼接的错误文案。
- *   仅在初始化超时或挂载失败等异常情况下才会 reject。
+ * 默认走无渲染实现。`dialog: true` 的处理详见 `submitForm`。
+ */
+declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
+//#endregion
+//#region temp/packages/form/src/utils/formStateProxy.d.ts
+/**
+ * 按优先级分层合并上下文，**靠后的层优先**。
  *
- * @example
- * ```ts
- * import { validateForm } from '@tmagic/form';
+ * 用读穿 Proxy 而非 `{ ...a, ...b }`：展开会立即执行 accessor，
+ * 而宿主允许用 `{ get stage() { ... } }` 这类读时求值的描述符。
+ */
+declare const mergeFormContexts: (...layers: (schema_d_exports.FormContext | undefined | null)[]) => schema_d_exports.FormContext;
+/**
+ * 将 coreState 与宿主业务上下文关联：读取时优先 core，miss 再读穿到 context。
  *
- * const error = await validateForm({
- *   config: [...],
- *   initValues: { name: 'foo' },
- *   appContext: getCurrentInstance()?.appContext,
- * });
- * if (error) {
- *   // 配置不合法，error 为错误文案
- * }
+ * - `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。
  *
- * // 调试模式：可见地渲染表单，点击「确定」才校验，校验失败保留弹层可修正重试：
- * const error = await validateForm({
- *   config: [...],
- *   initValues: { name: 'foo' },
- *   debug: true,
- * });
- * ```
+ * 独立成文件，避免与 `form.ts` ↔ `typeMatch.ts` 形成循环依赖。
  */
-declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
+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
 type AsyncValidatorFn = (rule: any, value: any, callback: Function, source?: any, options?: any) => any;
@@ -274,9 +291,54 @@ type AsyncValidatorFn = (rule: any, value: any, callback: Function, source?: any
  */
 declare const adaptFormValidator: (validator: AsyncValidatorFn) => AsyncValidatorFn;
 declare const createValues: (mForm: schema_d_exports.FormState | undefined, config?: schema_d_exports.FormConfig | schema_d_exports.TabPaneConfig[], initValue?: schema_d_exports.FormValue, value?: schema_d_exports.FormValue) => schema_d_exports.FormValue;
+declare const 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`）共用，两者对「该不该下钻」
+ * 的判断必须一致。
+ */
+declare const isValidName: (name: unknown) => boolean;
+/**
+ * 在 `prop` 后追加一段路径。
+ *
+ * 用于容器把 `prop` 透传给子级时再拼上索引 / key（如 group-list 的行、table 的行）。
+ */
+declare const appendProp: (prop: string | undefined, key: string | number) => string;
+/**
+ * 由父级 `prop` 与配置项 `name` 拼出该配置项的完整 `prop`（即 FormItem 的 prop）。
+ *
+ * 调用方传入的 name 已按 `config.name || ''` 归一化，空 name 表示该配置项不占据值路径上的一层，
+ * 此时沿用父级 `prop`。
+ */
+declare const getItemProp: (prop?: string | undefined, name?: string | number | undefined) => string;
+/**
+ * 归一化配置项的 `type`：求值动态 type、剥离容器语义的 type、驼峰转中划线、补默认值。
+ *
+ * 供 `Container.vue` 与无渲染校验共用，保证两者分派到的 type 完全一致。
+ */
+declare const resolveItemType: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => string;
 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, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: ComputedRef<boolean>) => schema_d_exports.Rule[];
+declare const getRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: MaybeRef<boolean>) => schema_d_exports.Rule[];
+/**
+ * 与 `getRules` 相同，但 validator 保持 async-validator（Element Plus）原生签名，不做 UI 库适配。
+ *
+ * 供无渲染校验（`validateValues`）使用：它直接把规则交给 async-validator 执行，
+ * 不经过 TDesign 的 `validator(val)` 调用约定，因此不能套 `adaptFormValidator`。
+ */
+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[];
 declare const initValue: (mForm: schema_d_exports.FormState | undefined, { initValues, config }: {
   initValues: schema_d_exports.FormValue;
   config: schema_d_exports.FormConfig;
@@ -285,31 +347,13 @@ declare const datetimeFormatter: (v: string | Date, defaultValue?: string, forma
 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;
-/**
- * 将 extendState 返回的扩展字段合并进 formState。
- *
- * - data 描述符（普通字段）通过 `formState[key] = value` 写入，走 reactive proxy 的 set，
- *   触发依赖通知；
- * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
- *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
- *
- * 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
- * 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
- * config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
- * post 等），命中这些 key 时统一跳过并告警。
- *
- * 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
- * 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
- * `TypeError: 'set' on proxy: trap returned falsish`。
- */
-declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined, reservedKeys?: Set<string | symbol>) => void;
 declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/useAddField.d.ts
 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;
@@ -335,7 +379,7 @@ type __VLS_Props$30 = {
   stepActive?: string | number;
   size?: 'small' | 'default' | 'large';
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
@@ -346,7 +390,12 @@ type __VLS_Props$30 = {
    * - `false`：跳过查找，直接使用字段 name 作为错误提示前缀（形如 `字段name -> 错误信息`）。
    */
   useFieldTextInError?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 宿主业务上下文。也可由祖先 `provide(FORM_CONTEXT_KEY)` 下发，本 prop 覆盖祖先的同名字段。
+   *
+   * 配置回调通过 `mForm.xxx` 读取，由 formState 的读穿 Proxy 落到这里。
+   */
+  context?: schema_d_exports.FormContext;
   /**
    * 自定义"是否展示对比内容"的判断函数（仅在 `isCompare === true` 时生效）。
    *
@@ -388,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;
@@ -431,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>;
@@ -439,13 +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;
-  useFieldTextInError: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$30: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
+declare const __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;
   };
@@ -466,7 +515,7 @@ type __VLS_Props$29 = {
   disabled?: boolean;
   title?: string;
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   zIndex?: number;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
@@ -478,8 +527,8 @@ type __VLS_Props$29 = {
   showCancel?: boolean;
   /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
   useFieldTextInError?: boolean;
-  /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /** 透传给内部 `MForm` 的宿主业务上下文 */
+  context?: schema_d_exports.FormContext;
   /**
    * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
    * 计算结果会再次 `provide` 出去，使得 Dialog 被 Teleport 到 body 后，内部子树
@@ -488,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: {};
@@ -513,12 +562,12 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       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 useFieldTextInError?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -558,12 +607,12 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       stepActive?: string | number;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
       useFieldTextInError?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -580,7 +629,7 @@ 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;
@@ -598,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>;
@@ -606,9 +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;
-      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -633,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>;
@@ -641,9 +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;
-    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -658,12 +707,12 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     stepActive?: string | number;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
     useFieldTextInError?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -677,10 +726,10 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
+  }>, "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;
@@ -707,12 +756,12 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       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 useFieldTextInError?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -752,12 +801,12 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       stepActive?: string | number;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
       useFieldTextInError?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -774,7 +823,7 @@ 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;
@@ -792,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>;
@@ -800,9 +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;
-      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -827,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>;
@@ -835,9 +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;
-    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -852,12 +901,12 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     stepActive?: string | number;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
     useFieldTextInError?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -871,10 +920,10 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
+  }>, "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;
@@ -908,14 +957,14 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   destroyOnClose: boolean;
   showClose: boolean;
   config: schema_d_exports.FormConfig;
-  validateOnInit: boolean;
   useFieldTextInError: boolean;
+  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;
   };
@@ -939,14 +988,14 @@ type __VLS_Props$28 = {
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   preventSubmitDefault?: boolean;
   /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
   useFieldTextInError?: boolean;
   /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
   beforeClose?: (_done: (_cancel?: boolean) => void) => void;
-  /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /** 透传给内部 `MForm` 的宿主业务上下文 */
+  context?: schema_d_exports.FormContext;
   /**
    * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
    * 计算结果会再次 `provide` 出去，使得 Drawer 被 Teleport 到 body 后，内部子树
@@ -955,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: {};
@@ -980,12 +1029,12 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       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 useFieldTextInError?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -1025,12 +1074,12 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       stepActive?: string | number;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
       useFieldTextInError?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -1047,7 +1096,7 @@ 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;
@@ -1065,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>;
@@ -1073,9 +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;
-      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1100,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>;
@@ -1108,9 +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;
-    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1125,12 +1174,12 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     stepActive?: string | number;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
     useFieldTextInError?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1144,10 +1193,10 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
+  }>, "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;
@@ -1174,12 +1223,12 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       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 useFieldTextInError?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -1219,12 +1268,12 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       stepActive?: string | number;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
       useFieldTextInError?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -1241,7 +1290,7 @@ 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;
@@ -1259,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>;
@@ -1267,9 +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;
-      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1294,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>;
@@ -1302,9 +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;
-    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1319,12 +1368,12 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     stepActive?: string | number;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
     useFieldTextInError?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1338,10 +1387,10 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
+  }>, "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;
@@ -1380,13 +1429,13 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   values: Object;
   closeOnPressEscape: boolean;
   config: schema_d_exports.FormConfig;
-  validateOnInit: boolean;
   useFieldTextInError: boolean;
+  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;
   };
@@ -1408,21 +1457,22 @@ type __VLS_Props$27 = {
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
   inline?: boolean;
-  labelPosition?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   preventSubmitDefault?: boolean;
   /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
   useFieldTextInError?: boolean;
-  extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /** 透传给内部 `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: {};
@@ -1440,12 +1490,12 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       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 useFieldTextInError?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -1485,12 +1535,12 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       stepActive?: string | number;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
       useFieldTextInError?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -1507,7 +1557,7 @@ 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;
@@ -1525,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>;
@@ -1533,9 +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;
-      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1560,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>;
@@ -1568,9 +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;
-    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1585,12 +1635,12 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     stepActive?: string | number;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
     useFieldTextInError?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1604,10 +1654,10 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
+  }>, "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;
@@ -1634,12 +1684,12 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       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 useFieldTextInError?: boolean | undefined;
-      readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
+      readonly context?: schema_d_exports.FormContext | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
         lastValue: any;
@@ -1679,12 +1729,12 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       stepActive?: string | number;
       size?: "small" | "default" | "large";
       inline?: boolean;
-      labelPosition?: string;
+      labelPosition?: "top" | "left" | "right";
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
       useFieldTextInError?: boolean;
-      extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+      context?: schema_d_exports.FormContext;
       showDiff?: (_data: {
         curValue: any;
         lastValue: any;
@@ -1701,7 +1751,7 @@ 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;
@@ -1719,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>;
@@ -1727,9 +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;
-      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1754,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>;
@@ -1762,9 +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;
-    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1779,12 +1829,12 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     stepActive?: string | number;
     size?: "small" | "default" | "large";
     inline?: boolean;
-    labelPosition?: string;
+    labelPosition?: "top" | "left" | "right";
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
     useFieldTextInError?: boolean;
-    extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+    context?: schema_d_exports.FormContext;
     showDiff?: (_data: {
       curValue: any;
       lastValue: any;
@@ -1798,10 +1848,10 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "validate" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "validateOnInit" | "useFieldTextInError")> & {
+  }>, "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;
@@ -1826,20 +1876,20 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
 }>, {
   values: Object;
   config: schema_d_exports.FormConfig;
-  validateOnInit: boolean;
   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;
@@ -1849,6 +1899,7 @@ type __VLS_Props$26 = {
   prop?: string;
   disabled?: boolean;
   labelWidth?: string | number;
+  labelPosition?: 'top' | 'left' | 'right';
   expandMore?: boolean;
   stepActive?: string | number;
   size?: string;
@@ -1857,7 +1908,7 @@ type __VLS_Props$26 = {
   /** 是否在行容器中 */
   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<{
@@ -1870,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;
   };
@@ -1881,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>;
@@ -1912,6 +1964,7 @@ type __VLS_Props$24 = {
   config: FlexLayoutConfig;
   name?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop?: string;
   size?: string;
   disabled?: boolean;
@@ -1933,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, {
@@ -1954,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;
   };
@@ -1970,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;
@@ -1993,6 +2048,7 @@ type __VLS_Props$21 = {
   name: string;
   size?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   prop?: string;
   expandMore?: boolean;
   disabled?: boolean;
@@ -2019,6 +2075,7 @@ type __VLS_Props$20 = {
   name: string;
   prop?: string;
   labelWidth?: string;
+  labelPosition?: 'top' | 'left' | 'right';
   disabled?: boolean;
   size?: string;
   enableToggleMode?: true;
@@ -2026,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;
@@ -2037,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>;
@@ -2061,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;
@@ -2090,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;
@@ -2099,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;
@@ -2162,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;
@@ -2180,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;
@@ -2243,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;
@@ -2252,22 +2319,179 @@ 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 回调自身抛错时抛出（机制故障，不是漏登记） */
+declare class FieldInnerConfigError extends Error {
+  readonly code = "FIELD_INNER_CONFIG";
+  readonly type: string;
+  readonly prop: string;
+  constructor(type: string, prop: string, cause: unknown);
+}
+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 带规则的字段列表
+ */
+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 - 表单值（会被就地修改）
+ */
+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/silentLeafFieldTypes.d.ts
+//#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;
+}
 /**
- * 注册可在静默校验中跳过渲染的叶子字段 type（追加到默认 `LEAF_FIELD_TYPES` 之上）。
+ * 复合字段的内部配置回调。
+ *
+ * 有一类字段组件会在自身内部再渲染 `MContainer` 并传入组件内部临时算出来的 config
+ * （如编辑器的 `code-select` / `event-select` / `style-setter`），这些内部字段同样会向
+ * 父级表单注册 FormItem、参与父表单校验。无渲染校验（`validateValues`）只遍历调用方
+ * 传入的 config 树，看不到这些运行期才产生的配置，因此需要字段作者通过
+ * `registerField(type, { innerConfig })` 把内部配置交出来。
  *
- * 仅应纳入「无嵌套 FormItem、无挂载值副作用」的字段；复合 / 动态子表单不可加入。
+ * 返回 `null` / `undefined` 表示该字段本次没有内部配置（例如某些分支下不渲染子表单）。
+ *
+ * 既未登记 innerConfig、也不在叶子字段表里的 type：配置里有 `items` 会下钻子项，
+ * 自身有 `rules` 会校验自身。
  */
-declare const registerSilentLeafFieldTypes: (types: Iterable<string>) => void;
-/** 当前生效的静默叶子字段集合：内置默认 ∪ 已注册扩展 */
-declare const getSilentLeafFieldTypes: () => ReadonlySet<string>;
-/** 清空业务侧追加的静默叶子字段（不影响内置默认集合；主要用于单测） */
-declare const clearSilentLeafFieldTypes: () => void;
+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 是否为叶子
+ */
+declare const isLeafFieldType: (type: string) => boolean;
 //#endregion
 //#region temp/packages/form/src/utils/typeMatch.d.ts
 interface TypeMatchValidateContext {
@@ -2282,15 +2506,11 @@ interface TypeMatchValidateContext {
  * 支持返回 Promise，用于需要异步确认取值是否合法的场景（如请求接口校验 id 是否存在）。
  */
 type TypeMatchValidator = (value: any, context: TypeMatchValidateContext) => string | undefined | Promise<string | undefined>;
-/** 注册或覆盖某个字段 type 的 typeMatch 校验规则 */
-declare const registerTypeMatchRule: (type: string, validator: TypeMatchValidator) => void;
-/** 批量注册 typeMatch 校验规则 */
-declare const registerTypeMatchRules: (rules: Record<string, TypeMatchValidator>) => void;
-/** 获取某个字段 type 的自定义 typeMatch 校验规则 */
+/** 获取某个字段 type 的 typeMatch 校验规则（业务侧优先于内置） */
 declare const getTypeMatchRule: (type: string) => TypeMatchValidator | undefined;
-/** 删除某个字段 type 的自定义 typeMatch 校验规则 */
+/** 删除业务侧 typeMatch 校验规则（不影响内置） */
 declare const deleteTypeMatchRule: (type: string) => boolean;
-/** 清空所有自定义 typeMatch 校验规则 */
+/** 清空业务侧 typeMatch 校验规则（不影响内置） */
 declare const clearTypeMatchRules: () => void;
 /**
  * 将值格式化为可读的参考示例字符串。
@@ -2310,19 +2530,158 @@ declare const optionSuggestion: (optionValues: any[]) => string;
  */
 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 合并后的登记表
+ */
+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`
+ */
+declare const registerField: (type: string, options?: FieldOptions, app?: App) => void;
+/**
+ * 批量登记字段。
+ *
+ * @param fields - type 到登记项的映射
+ * @param [app] - Vue 应用；省略则不调用 `app.component`
+ */
+declare const registerFields: (fields: Record<string, FieldOptions>, app?: App) => void;
+/**
+ * 登记内置字段（`clearFields` / `unregisterField` 不会清掉）。
+ *
+ * @param fields - type 到登记项的映射
+ * @param [app] - Vue 应用；省略则不调用 `app.component`
+ */
+declare const registerBuiltInFields: (fields: Record<string, FieldOptions>, app?: App) => void;
+/**
+ * 删除业务侧对指定 type 的登记（不影响内置；主要用于单测）。
+ *
+ * @param type - 字段 type
+ */
+declare const unregisterField: (type: string) => void;
+/** 清空业务侧登记（不影响内置；主要用于单测）。 */
+declare const clearFields: () => void;
+//#endregion
+//#region temp/packages/form/src/utils/builtInFields.d.ts
+/**
+ * 内置字段的无渲染登记表（不含 Vue 组件）。
+ *
+ * 本模块只导出数据，不登记。调用方自行 `registerBuiltInFields(builtInFields)`，
+ * 或 `app.use(MagicForm)`（install 里会登记叠上 Vue 组件后的表）。
+ */
+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
+ */
+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 拼接后的错误文案；无错误时为空串
+ */
+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 的 typeMatch 校验规则，可覆盖内置规则或扩展业务字段 */
-  typeMatchRules?: Record<string, TypeMatchValidator>;
+  /**
+   * 自定义字段 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, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, 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, adaptFormValidator, applyExtendState, clearSilentLeafFieldTypes, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getSilentLeafFieldTypes, getTypeMatchRule, initValue, optionSuggestion, registerField as registerFormField, registerSilentLeafFieldTypes, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+  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;
 //#endregion
-export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, 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$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearSilentLeafFieldTypes, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getSilentLeafFieldTypes, getTypeMatchRule, initValue, optionSuggestion, registerField as registerFormField, registerSilentLeafFieldTypes, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+export { ChangeRecord, type CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, type FieldInnerConfig, type FieldInnerConfigContext, FieldInnerConfigError, type FieldInnerConfigResult, type FieldMountValueEffect, type FieldMountValueEffectContext, type FieldOptions, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, type HeadlessFieldOptions, type 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$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, ValidateError, type ValidateFormOptions, type ValidateValuesOptions, type 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 };