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

package/src/theme/group-list.scss

@@ -70,27 +70,60 @@
       flex-shrink: 0;
       gap: 8px;
     }
+  }
 
-    // 卡片标题吸顶；补不透明背景，避免滚动时正文透出。
-    // z-index 必须低于吸底 footer，否则标题会盖住「新增」按钮。
-    > .el-card__header,
-    > .t-card__header {
-      position: sticky;
-      top: var(--m-group-list-header-sticky-top, 0px);
-      z-index: 7;
-      background-color: var(--m-group-list-header-bg, #fff);
-    }
+  // 嵌套吸底按钮叠在外层 footer 之上（如「新增条件」叠在「新增条件组」上面）。
+  // 每穿过一层「自己渲染了吸底 footer」的列表才多让出一个 footer 高度，外层没有吸底按钮时
+  // 内层不能凭空抬高。自定义属性不能自增，所以用 item / list 两个变量交替接力。
+  > .m-fields-group-list-item {
+    --m-group-list-item-footer-bottom: var(
+      --m-group-list-nested-footer-bottom,
+      0px
+    );
+  }
+
+  &.is-footer-sticky > .m-fields-group-list-item {
+    --m-group-list-item-footer-bottom: calc(
+      var(--m-group-list-nested-footer-bottom, 0px) +
+        var(--m-group-list-footer-height)
+    );
   }
 
-  // 嵌套标题叠在外层标题之下，层级更低以免盖住外层底部分隔线
-  .m-fields-group-list-item .m-fields-group-list-item {
-    > .el-card__header,
-    > .t-card__header {
-      top: calc(
-        var(--m-group-list-header-sticky-top, 0px) +
-          var(--m-group-list-header-height)
+  .m-fields-group-list-item .m-fields-group-list {
+    --m-group-list-nested-footer-bottom: var(
+      --m-group-list-item-footer-bottom,
+      0px
+    );
+  }
+
+  // 仅 header.sticky 时标题吸顶；直接子 item，避免外层吸顶带动未开启的内层
+  &.is-header-sticky {
+    // 从外层 item 接过已累加的偏移；最外层没有该变量时走 fallback
+    --m-group-list-nested-sticky-top: var(--m-group-list-child-list-sticky-top);
+    --m-group-list-nested-header-z: var(--m-group-list-child-list-header-z);
+
+    > .m-fields-group-list-item {
+      --m-group-list-item-sticky-top: var(
+        --m-group-list-nested-sticky-top,
+        var(--m-group-list-header-sticky-top, 0px)
       );
-      z-index: 6;
+      --m-group-list-item-header-z: var(--m-group-list-nested-header-z, 7);
+      --m-group-list-child-list-sticky-top: calc(
+        var(--m-group-list-item-sticky-top) + var(--m-group-list-header-height)
+      );
+      --m-group-list-child-list-header-z: calc(
+        var(--m-group-list-item-header-z) - 1
+      );
+
+      // 卡片标题吸顶；补不透明背景，避免滚动时正文透出。
+      // z-index 必须低于吸底 footer，否则标题会盖住「新增」按钮。
+      > .el-card__header,
+      > .t-card__header {
+        position: sticky;
+        top: var(--m-group-list-item-sticky-top);
+        z-index: var(--m-group-list-item-header-z);
+        background-color: var(--m-group-list-header-bg, #fff);
+      }
     }
   }
 
@@ -113,10 +146,10 @@
   }
 
   // 吸底全宽主按钮（event-select / code-select / display-conds 外层列表）
-  // z-index 高于 item header，避免吸顶标题挡住新增按钮
+  // z-index 高于 item header，避免吸顶标题挡住新增按钮；多层时 bottom 由内层 list 累加
   > .m-fields-group-list-footer.is-sticky-full {
     position: sticky;
-    bottom: 0;
+    bottom: var(--m-group-list-nested-footer-bottom, 0px);
     z-index: 7;
     margin-bottom: 0;
     padding: var(--m-group-list-footer-padding-top) 0
@@ -133,14 +166,6 @@
       height: var(--m-group-list-footer-button-height);
     }
   }
-
-  // 嵌套吸底按钮叠在外层 footer 之上（如「新增条件」叠在「新增条件组」上面）
-  .m-fields-group-list-item
-    .m-fields-group-list
-    > .m-fields-group-list-footer.is-sticky-full {
-    bottom: var(--m-group-list-footer-height);
-    z-index: 7;
-  }
 }
 
 /** 最外层的groupList需要每个item需要增加空白区域界限时，增加outer-gorup_list可以实现 */

package/src/utils/form.ts

@@ -368,11 +368,14 @@ export const filterFunction = <T = any>(
   props: any,
 ) => {
   if (typeof config === 'function') {
+    const formValue = readonly(mForm?.values || props.model);
     return (config as FilterFunction<T>)(mForm, {
       values: readonly(mForm?.initValues || {}),
       model: readonly(props.model),
       parent: readonly(mForm?.parentValues || {}),
-      formValue: readonly(mForm?.values || props.model),
+      formValue,
+      // Select.vue / SelectOptionFunction 使用 formValues 别名
+      formValues: formValue,
       prop: props.prop,
       config: props.config,
       index: props.index,

package/src/utils/tableGroupList.ts

@@ -18,7 +18,9 @@
 
 import { cloneDeep } from 'lodash-es';
 
-import type { GroupListConfig, TableColumnConfig, TableConfig } from '../schema';
+import { isNumber } from '@tmagic/utils';
+
+import type { GroupListConfig, GroupListHeaderConfig, TableColumnConfig, TableConfig } from '../schema';
 
 /**
  * table / group-list 是同一份配置的两种展示形态，可以互相切换（`TableGroupList.vue`）。
@@ -31,6 +33,31 @@ import type { GroupListConfig, TableColumnConfig, TableConfig } from '../schema'
 /** group-list 形态的 type（兼容驼峰与中划线两种写法） */
 export const isGroupListType = (type: unknown): boolean => type === 'groupList' || type === 'group-list';
 
+/**
+ * 归一成带单位的 CSS 长度。
+ *
+ * 配置常常来自 JSON 或表单输入，`'48'` 这类无单位数字串很常见；直接写进 CSS 变量会让
+ * 嵌套层的 `calc()` 整体失效、吸顶静默失灵，所以纯数字一律补 `px`。
+ */
+const toCssLength = (height: number | string | undefined): string | undefined => {
+  const value = `${height ?? ''}`.trim();
+  if (!value) return undefined;
+
+  if (isNumber(value)) return `${value}px`;
+  // 走到这里还是 number 的只剩 NaN / Infinity，不写变量，交给样式默认值兜底
+  return typeof height === 'number' ? undefined : value;
+};
+
+/** header.sticky 开启时把 height 写成 CSS 变量，给嵌套吸顶偏移用 */
+export const getGroupListHeaderVars = (
+  header: GroupListHeaderConfig | undefined,
+): Record<string, string> | undefined => {
+  if (!header?.sticky) return undefined;
+
+  const height = toCssLength(header.height);
+  return height ? { '--m-group-list-header-height': height } : undefined;
+};
+
 /** 按 label 文案长度估算 label 宽度（中文按 20px、其他按 8px，最小 80px） */
 export const calcLabelWidth = (label: string): string => {
   if (!label) return '0px';

package/src/utils/typeMatch.ts

@@ -56,6 +56,18 @@ const builtInTypeMatchRules = new Map<string, TypeMatchValidator>();
 const isPromise = (value: any): value is Promise<unknown> =>
   typeof value === 'object' && value !== null && typeof value.then === 'function';
 
+/**
+ * 同步校验无法等待 Promise。调用方会丢掉返回值，这里挂上空 handler，避免变成未捕获 rejection。
+ */
+const ignorePromise = (value: any): value is Promise<unknown> => {
+  if (!isPromise(value)) return false;
+  value.then(
+    () => {},
+    () => {},
+  );
+  return true;
+};
+
 /** 注册或覆盖某个字段 type 的 typeMatch 校验规则。`builtIn` 登记不受 `clearTypeMatchRules` / `deleteTypeMatchRule` 影响。 */
 export const registerTypeMatchRule = (type: string, validator: TypeMatchValidator, builtIn = false): void => {
   (builtIn ? builtInTypeMatchRules : extraTypeMatchRules).set(toLine(type), validator);
@@ -89,11 +101,14 @@ const resolveConfig = <T = any>(
   props: any,
 ): T | undefined => {
   if (typeof config === 'function') {
+    const formValue = readonly(mForm?.values || props.model);
     return (config as Function)(mForm, {
       values: readonly(mForm?.initValues || {}),
       model: readonly(props.model),
       parent: readonly(mForm?.parentValues || {}),
-      formValue: readonly(mForm?.values || props.model),
+      formValue,
+      // Select.vue / SelectOptionFunction 使用 formValues 别名
+      formValues: formValue,
       prop: props.prop,
       config: props.config,
       index: props.index,
@@ -200,7 +215,7 @@ const resolveFieldDefaultValue = (mForm: FormState | undefined, props: any): any
   if (typeof defaultValue === 'undefined' || defaultValue === 'undefined') return undefined;
   const resolvedDefaultValue = resolveConfig(mForm, defaultValue, props);
   // resolveConfig 返回 Promise（如 defaultValue 为异步函数）时无法同步获取默认值，回退到通用示例
-  if (isPromise(resolvedDefaultValue)) {
+  if (ignorePromise(resolvedDefaultValue)) {
     return undefined;
   }
   return resolvedDefaultValue;
@@ -331,9 +346,21 @@ const flattenSelectOptions = (options: any[]): any[] => {
   return values;
 };
 
-const resolveOptions = (props: any): any[] => {
-  const { options } = props.config || {};
-  return Array.isArray(options) ? options : [];
+/**
+ * 解析字段 options：静态数组原样返回；函数型与 `display` / `type` 一样当场求值。
+ *
+ * 函数返回 Promise、非数组或抛错时当作「还没有可选项」，交由调用方按空 options 跳过枚举。
+ * `remote` / `allowCreate` 仍由 `validateSelectValue` 单独放行，不在这里区分。
+ */
+const resolveOptions = (mForm: FormState | undefined, props: any): any[] => {
+  let resolved: unknown;
+  try {
+    resolved = resolveConfig(mForm, props.config?.options, props);
+  } catch {
+    return [];
+  }
+  if (ignorePromise(resolved) || !Array.isArray(resolved)) return [];
+  return resolved;
 };
 
 const includesOptionValue = (optionValues: any[], value: any) => optionValues.some((item) => Object.is(item, value));
@@ -440,9 +467,6 @@ const validateSelectValue = (
     return undefined;
   }
 
-  // 仅当 options 为静态数组时才校验值是否在可选项中，动态 options（函数形式）跳过
-  const isStaticOptions = Array.isArray(config.options);
-
   if (config.multiple) {
     if (!Array.isArray(value)) {
       return defaultMessage(
@@ -451,13 +475,13 @@ const validateSelectValue = (
         optionExampleSuggestion(optionValues, '["选项1", "选项2"]', true),
       );
     }
-    if (isStaticOptions && value.some((item) => !includesOptionValue(optionValues, item))) {
+    if (value.some((item) => !includesOptionValue(optionValues, item))) {
       return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
     }
     return undefined;
   }
 
-  if (isStaticOptions && !includesOptionValue(optionValues, value)) {
+  if (!includesOptionValue(optionValues, value)) {
     return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
   }
   return undefined;
@@ -470,7 +494,7 @@ const validateCascaderValue = (
   mForm: FormState | undefined,
   message: string | undefined,
 ): string | undefined => {
-  const options = resolveOptions(props) as CascaderOption[];
+  const options = resolveOptions(mForm, props) as CascaderOption[];
 
   if (!options.length) {
     return;
@@ -478,7 +502,7 @@ const validateCascaderValue = (
 
   const valueSeparator = resolveConfig<string | undefined>(mForm, config.valueSeparator, props);
   // resolveConfig 返回 Promise（如 valueSeparator 为异步函数）时无法同步确定分隔符，跳过校验
-  if (isPromise(valueSeparator)) {
+  if (ignorePromise(valueSeparator)) {
     return undefined;
   }
   const emitPath = config.emitPath !== false;
@@ -631,12 +655,12 @@ const validateBuiltinTypeMatch = (
   }
 
   if (fieldType === 'select') {
-    const optionValues = flattenSelectOptions(resolveOptions(props));
+    const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
     return validateSelectValue(value, config, optionValues, message);
   }
 
   if (fieldType === 'radio-group') {
-    const optionValues = flattenSelectOptions(resolveOptions(props));
+    const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
 
     if (optionValues.length === 0) {
       return undefined;
@@ -649,7 +673,7 @@ const validateBuiltinTypeMatch = (
   }
 
   if (fieldType === 'checkbox-group') {
-    const optionValues = flattenSelectOptions(resolveOptions(props));
+    const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
 
     if (optionValues.length === 0) {
       return undefined;
@@ -727,12 +751,19 @@ export const validateTypeMatch = (
   }
 
   const rawFieldType = 'type' in (props.config || {}) ? props.config.type : '';
-  if (typeof rawFieldType !== 'string' || !rawFieldType) {
+  let resolvedType: unknown;
+  try {
+    resolvedType = resolveConfig<string>(mForm, rawFieldType, props);
+  } catch {
+    return undefined;
+  }
+  // 函数型 type 与 Container 的 resolveItemType 对齐；异步 type 无法同步判定，跳过
+  if (ignorePromise(resolvedType) || typeof resolvedType !== 'string' || !resolvedType) {
     return undefined;
   }
 
   // 统一将驼峰形式（如 radioGroup）归一化为连字符形式（radio-group），与内置规则的 key 保持一致
-  const fieldType = toLine(rawFieldType);
+  const fieldType = toLine(resolvedType);
 
   const customValidator = getTypeMatchRule(fieldType);
 

package/types/headless.d.ts

@@ -10,7 +10,7 @@ import * as import__tmagic_form_schema from "@tmagic/form-schema";
  * 所有层级的 Container（含嵌套在 fieldset / panel 等容器组件内部的 Container）通过 `inject` 获取，
  * 无需逐层透传 prop。
  */
-interface FormDiffConfig {
+export interface FormDiffConfig {
   /**
    * 自定义"是否展示对比内容"的判断函数（仅在对比模式下生效）。
    *
@@ -30,8 +30,8 @@ interface FormDiffConfig {
    */
   selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
 }
-declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
-declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
+export declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
+export declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
 /**
  * 宿主业务上下文，由 `MForm`（或更外层的 Editor）通过 `provide` 下发。
  *
@@ -40,21 +40,21 @@ declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
  *
  * 配置回调统一通过 `mForm.xxx` 读取，由 formState 的读穿 Proxy 落到这里。
  */
-declare const FORM_CONTEXT_KEY: InjectionKey<ComputedRef<FormContext>>;
-interface ValidateError {
+export declare const FORM_CONTEXT_KEY: InjectionKey<ComputedRef<FormContext>>;
+export interface ValidateError {
   message: string;
   field: string;
 }
-interface ChangeRecord {
+export interface ChangeRecord {
   propPath?: string;
   value: any;
 }
-interface ContainerChangeEventData {
+export interface ContainerChangeEventData {
   modifyKey?: string;
   changeRecords?: ChangeRecord[];
 }
 /** 自定义 label slot 的作用域参数 */
-interface FormLabelSlotProps {
+export interface FormLabelSlotProps {
   /** 当前表单项配置 */
   config: FormItemConfig;
   /** 经处理后的类型 */
@@ -67,7 +67,7 @@ interface FormLabelSlotProps {
   disabled?: boolean;
 }
 /** Form / Container 暴露的具名 slot 定义 */
-interface FormSlots {
+export interface FormSlots {
   label(_props: FormLabelSlotProps): any;
 }
 //#endregion
@@ -78,7 +78,7 @@ interface FormSlots {
  * 用读穿 Proxy 而非 `{ ...a, ...b }`：展开会立即执行 accessor，
  * 而宿主允许用 `{ get stage() { ... } }` 这类读时求值的描述符。
  */
-declare const mergeFormContexts: (...layers: (schema_d_exports.FormContext | undefined | null)[]) => schema_d_exports.FormContext;
+export declare const mergeFormContexts: (...layers: (schema_d_exports.FormContext | undefined | null)[]) => schema_d_exports.FormContext;
 /**
  * 将 coreState 与宿主业务上下文关联：读取时优先 core，miss 再读穿到 context。
  *
@@ -91,7 +91,7 @@ declare const mergeFormContexts: (...layers: (schema_d_exports.FormContext | und
  *
  * 独立成文件，避免与 `form.ts` ↔ `typeMatch.ts` 形成循环依赖。
  */
-declare const createFormStateProxy: (coreState: schema_d_exports.FormState, getContext: (() => schema_d_exports.FormContext) | Ref<schema_d_exports.FormContext>) => schema_d_exports.FormState;
+export declare const createFormStateProxy: (coreState: schema_d_exports.FormState, getContext: (() => schema_d_exports.FormContext) | Ref<schema_d_exports.FormContext>) => schema_d_exports.FormState;
 //#endregion
 //#region temp/packages/form/src/utils/form.d.ts
 type AsyncValidatorFn = (rule: any, value: any, callback: Function, source?: any, options?: any) => any;
@@ -99,9 +99,9 @@ type AsyncValidatorFn = (rule: any, value: any, callback: Function, source?: any
  * 将 async-validator（Element Plus）风格的 validator 适配到当前 UI 库。
  * TDesign 调用签名为 `(val) => boolean | CustomValidateObj | Promise`，无 callback。
  */
-declare const adaptFormValidator: (validator: AsyncValidatorFn) => AsyncValidatorFn;
-declare const createValues: (mForm: schema_d_exports.FormState | undefined, config?: schema_d_exports.FormConfig | schema_d_exports.TabPaneConfig[], initValue?: schema_d_exports.FormValue, value?: schema_d_exports.FormValue) => schema_d_exports.FormValue;
-declare const createFormStateBase: (ui?: {
+export declare const adaptFormValidator: (validator: AsyncValidatorFn) => AsyncValidatorFn;
+export declare const createValues: (mForm: schema_d_exports.FormState | undefined, config?: schema_d_exports.FormConfig | schema_d_exports.TabPaneConfig[], initValue?: schema_d_exports.FormValue, value?: schema_d_exports.FormValue) => schema_d_exports.FormValue;
+export declare const createFormStateBase: (ui?: {
   $message?: any;
   $messageBox?: any;
 }) => {
@@ -119,45 +119,45 @@ declare const createFormStateBase: (ui?: {
  * 供 `Container.vue` 与无渲染校验（`collectValidatableFields`）共用，两者对「该不该下钻」
  * 的判断必须一致。
  */
-declare const isValidName: (name: unknown) => boolean;
+export declare const isValidName: (name: unknown) => boolean;
 /**
  * 在 `prop` 后追加一段路径。
  *
  * 用于容器把 `prop` 透传给子级时再拼上索引 / key（如 group-list 的行、table 的行）。
  */
-declare const appendProp: (prop: string | undefined, key: string | number) => string;
+export 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;
+export 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?: MaybeRef<boolean>) => schema_d_exports.Rule[];
+export declare const resolveItemType: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => string;
+export declare const filterFunction: <T = any>(mForm: schema_d_exports.FormState | undefined, config: T | schema_d_exports.FilterFunction<T> | undefined, props: any) => T | undefined;
+export declare const display: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => any;
+export declare const getRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: MaybeRef<boolean>) => schema_d_exports.Rule[];
 /**
  * 与 `getRules` 相同，但 validator 保持 async-validator（Element Plus）原生签名，不做 UI 库适配。
  *
  * 供无渲染校验（`validateValues`）使用：它直接把规则交给 async-validator 执行，
  * 不经过 TDesign 的 `validator(val)` 调用约定，因此不能套 `adaptFormValidator`。
  */
-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 }: {
+export declare const getNativeRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: MaybeRef<boolean>) => schema_d_exports.Rule[];
+export declare const initValue: (mForm: schema_d_exports.FormState | undefined, { initValues, config }: {
   initValues: schema_d_exports.FormValue;
   config: schema_d_exports.FormConfig;
 }) => Promise<schema_d_exports.FormValue>;
-declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
-declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
-declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
-declare const sortChange: (data: any[], { prop, order }: schema_d_exports.SortProp) => void;
-declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
+export declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
+export declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
+export declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
+export declare const sortChange: (data: any[], { prop, order }: schema_d_exports.SortProp) => void;
+export declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/collectFields.d.ts
 /** 一个参与校验的字段：与渲染式校验中「一个带 rules 的 TMagicFormItem」一一对应 */
@@ -172,13 +172,13 @@ interface CollectedField {
   model: schema_d_exports.FormValue;
 }
 /** 已登记的 innerConfig 回调自身抛错时抛出（机制故障，不是漏登记） */
-declare class FieldInnerConfigError extends Error {
+export 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;
+export declare const isFieldInnerConfigError: (error: unknown) => error is FieldInnerConfigError;
 /**
  * 遍历模式。同一套遍历规则服务两个用途，避免两条链路各写一份而产生偏差：
  *
@@ -229,7 +229,7 @@ type ContainerWalker = (_ctx: WalkContext, _node: WalkNode, _itemProp: string) =
  *   `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[];
+export declare const collectValidatableFields: (mForm: schema_d_exports.FormState | undefined, config: schema_d_exports.FormConfig, values: schema_d_exports.FormValue, typeMatchValid?: boolean) => CollectedField[];
 /**
  * 执行「一份 config + 一份 values」中所有叶子字段登记的值初始化写入，就地改写 `values`。
  *
@@ -248,7 +248,7 @@ declare const collectValidatableFields: (mForm: schema_d_exports.FormState | und
  * @param config - 表单配置
  * @param values - 表单值（会被就地修改）
  */
-declare const applyMountValueEffects: (mForm: schema_d_exports.FormState | undefined, config: schema_d_exports.FormConfig, values: schema_d_exports.FormValue) => void;
+export declare const applyMountValueEffects: (mForm: schema_d_exports.FormState | undefined, config: schema_d_exports.FormConfig, values: schema_d_exports.FormValue) => void;
 //#endregion
 //#region temp/packages/form/src/utils/fieldInnerConfig.d.ts
 /** innerConfig 回调的入参：字段自身的配置、所在层级的 model、完整字段路径与表单状态 */
@@ -331,7 +331,7 @@ type FieldMountValueEffect = (_ctx: FieldMountValueEffectContext) => void;
  * @param type - 字段 type
  * @returns 是否为叶子
  */
-declare const isLeafFieldType: (type: string) => boolean;
+export declare const isLeafFieldType: (type: string) => boolean;
 //#endregion
 //#region temp/packages/form/src/utils/typeMatch.d.ts
 interface TypeMatchValidateContext {
@@ -347,28 +347,28 @@ interface TypeMatchValidateContext {
  */
 type TypeMatchValidator = (value: any, context: TypeMatchValidateContext) => string | undefined | Promise<string | undefined>;
 /** 获取某个字段 type 的 typeMatch 校验规则（业务侧优先于内置） */
-declare const getTypeMatchRule: (type: string) => TypeMatchValidator | undefined;
+export declare const getTypeMatchRule: (type: string) => TypeMatchValidator | undefined;
 /** 删除业务侧 typeMatch 校验规则（不影响内置） */
-declare const deleteTypeMatchRule: (type: string) => boolean;
+export declare const deleteTypeMatchRule: (type: string) => boolean;
 /** 清空业务侧 typeMatch 校验规则（不影响内置） */
-declare const clearTypeMatchRules: () => void;
+export declare const clearTypeMatchRules: () => void;
 /**
  * 将值格式化为可读的参考示例字符串。
  */
-declare const stringifyExampleValue: (value: any) => string;
+export declare const stringifyExampleValue: (value: any) => string;
 /** 参考建议中可选值全量展示上限；超出时仅举例 EXAMPLE_SUGGESTION_COUNT 个并标明总数。 */
-declare const MAX_SUGGESTION_OPTIONS = 20;
+export declare const MAX_SUGGESTION_OPTIONS = 20;
 /**
  * 生成可选项参考建议；无可选值时返回空字符串（不追加建议）。
  * 未超过 MAX_SUGGESTION_OPTIONS 时全部列举；超过时仅举例前 EXAMPLE_SUGGESTION_COUNT 个并标明总数，避免 AI 误以为仅有举例值合法。
  */
-declare const optionSuggestion: (optionValues: any[]) => string;
+export declare const optionSuggestion: (optionValues: any[]) => string;
 /**
  * 校验取值与字段 type 是否匹配；通过返回 undefined，否则返回错误文案。
  *
  * 命中的自定义规则是异步校验器时返回 Promise，内置规则始终同步返回。
  */
-declare const validateTypeMatch: (value: any, mForm: schema_d_exports.FormState | undefined, props: any, message?: string) => string | undefined | Promise<string | undefined>;
+export declare const validateTypeMatch: (value: any, mForm: schema_d_exports.FormState | undefined, props: any, message?: string) => string | undefined | Promise<string | undefined>;
 //#endregion
 //#region temp/packages/form/src/utils/registerField.d.ts
 /**
@@ -416,7 +416,7 @@ type HeadlessFieldOptions = Omit<FieldOptions, 'component' | 'container'>;
  * @param tables - 待合并的登记表，`undefined` 会被跳过
  * @returns 合并后的登记表
  */
-declare const mergeFieldOptions: (...tables: Array<Record<string, HeadlessFieldOptions | FieldOptions> | undefined>) => Record<string, FieldOptions>;
+export declare const mergeFieldOptions: (...tables: Array<Record<string, HeadlessFieldOptions | FieldOptions> | undefined>) => Record<string, FieldOptions>;
 /**
  * 按字段 type 取已登记的渲染组件（`codeSelect` 与 `code-select` 等价）。
  *
@@ -435,29 +435,29 @@ declare const getField: (type: string) => Component | undefined;
  * @param [options] - 登记项；省略或空对象视为叶子
  * @param [app] - Vue 应用；省略则不调用 `app.component`
  */
-declare const registerField: (type: string, options?: FieldOptions, app?: App) => void;
+export 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;
+export 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;
+export declare const registerBuiltInFields: (fields: Record<string, FieldOptions>, app?: App) => void;
 /**
  * 删除业务侧对指定 type 的登记（不影响内置；主要用于单测）。
  *
  * @param type - 字段 type
  */
-declare const unregisterField: (type: string) => void;
+export declare const unregisterField: (type: string) => void;
 /** 清空业务侧登记（不影响内置；主要用于单测）。 */
-declare const clearFields: () => void;
+export declare const clearFields: () => void;
 //#endregion
 //#region temp/packages/form/src/utils/builtInFields.d.ts
 /**
@@ -466,7 +466,7 @@ declare const clearFields: () => void;
  * 本模块只导出数据，不登记。调用方自行 `registerBuiltInFields(builtInFields)`，
  * 或 `app.use(MagicForm)`（install 里会登记叠上 Vue 组件后的表）。
  */
-declare const builtInFields: Record<string, HeadlessFieldOptions>;
+export declare const builtInFields: Record<string, HeadlessFieldOptions>;
 //#endregion
 //#region temp/packages/form/src/utils/validateValues.d.ts
 /** 构造无渲染 formState 所需的参数（与 MForm 的同名 props 对齐） */
@@ -488,7 +488,7 @@ interface HeadlessFormStateOptions {
  * 差异：没有真实的表单实例，因此 `$emit` 为空实现、`fields` 注册表始终为空
  * （该注册表在整个仓库中只写不读，不参与校验）。
  */
-declare const createHeadlessFormState: (options: HeadlessFormStateOptions) => schema_d_exports.FormState;
+export declare const createHeadlessFormState: (options: HeadlessFormStateOptions) => schema_d_exports.FormState;
 /** `validateValues` 参数 */
 interface ValidateValuesOptions extends HeadlessFormStateOptions {
   /** 是否开启类型匹配校验 */
@@ -527,7 +527,7 @@ interface ValidateValuesResult {
  * });
  * ```
  */
-declare const validateValues: (options: ValidateValuesOptions) => Promise<ValidateValuesResult>;
+export declare const validateValues: (options: ValidateValuesOptions) => Promise<ValidateValuesResult>;
 //#endregion
 //#region temp/packages/form/src/utils/validateError.d.ts
 /**
@@ -537,7 +537,7 @@ declare const validateValues: (options: ValidateValuesOptions) => Promise<Valida
  * @param config - 表单配置数组
  * @returns 找到的 text 值，如果未找到则返回 undefined
  */
-declare const getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
+export declare const getTextByName: (name: string, config?: schema_d_exports.FormConfig) => string | undefined;
 /**
  * 将校验返回的 invalidFields 汇总为可读的错误文案（多条以 `<br>` 拼接）。
  *
@@ -552,7 +552,7 @@ declare const getTextByName: (name: string, config?: schema_d_exports.FormConfig
  * @param [options.useFieldTextInError=true] - 错误前缀是否使用字段 text
  * @returns 拼接后的错误文案；无错误时为空串
  */
-declare const formatValidateError: (invalidFields: Record<string, any>, { config, useFieldTextInError }?: {
+export declare const formatValidateError: (invalidFields: Record<string, any>, { config, useFieldTextInError }?: {
   config?: schema_d_exports.FormConfig;
   useFieldTextInError?: boolean;
 }) => string;
@@ -668,15 +668,15 @@ interface ValidateFormOptions {
  *
  * `@tmagic/form/headless` 不支持 `dialog: true`。
  */
-declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
+export declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
 /**
  * 以命令式方式对一份「表单配置 + 值」做一次静默校验（无渲染）。
  *
  * `@tmagic/form/headless` 不支持 `dialog: true`。
  */
-declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
+export declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
 declare namespace headless_d_exports {
   export { ChangeRecord, CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfig, FieldInnerConfigContext, FieldInnerConfigError, FieldInnerConfigResult, FieldMountValueEffect, FieldMountValueEffectContext, FieldOptions, FormDiffConfig, FormLabelSlotProps, FormSlots, HeadlessFieldOptions, HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, ValidateValuesOptions, ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, 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, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };
 }
 //#endregion
-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, FormLabelSlotProps, FormSlots, type HeadlessFieldOptions, type HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, type SubmitFormOptions, type SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, type ValidateFormOptions, type ValidateValuesOptions, type ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, 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, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };
+export { type CollectedField, type FieldInnerConfig, type FieldInnerConfigContext, type FieldInnerConfigResult, type FieldMountValueEffect, type FieldMountValueEffectContext, type FieldOptions, type HeadlessFieldOptions, type HeadlessFormStateOptions, type SubmitFormOptions, type SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, type ValidateFormOptions, type ValidateValuesOptions, type ValidateValuesResult, getField as getFormField };