@robot-admin/naive-ui-components 0.22.0 → 0.23.0

package/dist/useFormConfig.d.cts

@@ -0,0 +1,590 @@
+import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.cjs";
+import { t as DictionaryBinding } from "./dictionary.cjs";
+import { t as ComponentDensity } from "./density.cjs";
+import { CSSProperties, ComputedRef, DeepReadonly, VNode } from "vue";
+import { FormInst, FormItemRule } from "naive-ui";
+import { NAIVE_COMBOS, NaiveRule, PRESET_RULES, RuleSpec, RuleSpec as RuleSpec$1, SPEC_RULES } from "@robot-admin/form-validate";
+
+//#region src/components/C_Form/utils/formValidation.d.ts
+/** 原生规则、验证库规则和框架无关规则均可直接作为字段配置。 */
+type FormValidationRule = FormItemRule | NaiveRule | RuleSpec;
+//#endregion
+//#region src/components/C_Form/types.d.ts
+type MaybePromise<T> = T | Promise<T>;
+type FormRecord = Record<string, unknown>;
+type AtomicFormValue = string | number | boolean | bigint | symbol | null | undefined | Date | RegExp | File | Blob;
+/**
+ * 最多展开五次子模型，保留六层字段路径及递归业务模型支持。
+ * 每层引用独立别名，避免 TypeScript 5.8 方差检查递归路径自身时栈溢出。
+ */
+type FieldPathChild<T> = NonNullable<T> extends AtomicFormValue ? never : NonNullable<T> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? never : NonNullable<Item> extends object ? NonNullable<Item> : never : NonNullable<T> extends object ? NonNullable<T> : never;
+type FieldPathStep<T extends object, Children extends { [K in keyof T]: string }> = { [K in Extract<keyof T, string>]: NonNullable<T[K]> extends AtomicFormValue ? K : NonNullable<T[K]> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? K | `${K}.${number}` : NonNullable<Item> extends object ? K | `${K}.${number}` | `${K}.${number}.${Children[K]}` : K : NonNullable<T[K]> extends object ? K | `${K}.${Children[K]}` : K }[Extract<keyof T, string>];
+type NestedFieldPath0<T extends object> = Extract<keyof T, string>;
+type NestedFieldPath1<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath0<FieldPathChild<T[K]>> }>;
+type NestedFieldPath2<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath1<FieldPathChild<T[K]>> }>;
+type NestedFieldPath3<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath2<FieldPathChild<T[K]>> }>;
+type NestedFieldPath4<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath3<FieldPathChild<T[K]>> }>;
+type NestedFieldPath5<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath4<FieldPathChild<T[K]>> }>;
+type FieldPath<T extends object = FormRecord> = keyof T extends never ? string : string extends keyof T ? string : NestedFieldPath5<T>;
+type NestedFieldPathValue<T, P extends string> = T extends readonly (infer Item)[] ? P extends `${number}.${infer Rest}` ? NestedFieldPathValue<NonNullable<Item>, Rest> : P extends `${number}` ? Item : unknown : P extends keyof T ? T[P] : P extends `${infer K}.${infer Rest}` ? K extends keyof T ? NestedFieldPathValue<NonNullable<T[K]>, Rest> : unknown : unknown;
+type FieldPathValue<T extends object, P extends string> = NestedFieldPathValue<T, P>;
+/**
+ * 表单模式
+ * @description create = 新建（空白表单），edit = 编辑（回填已有数据 + 脏检查）
+ */
+type FormMode = 'create' | 'edit';
+/**
+ * 支持的布局类型
+ * @description 定义表单支持的所有布局模式
+ */
+type LayoutType = 'default' | 'inline' | 'grid' | 'card' | 'tabs' | 'steps' | 'dynamic' | 'custom';
+/**
+ * 标签位置类型
+ * @description 表单标签的显示位置
+ */
+type LabelPlacement = 'left' | 'top';
+/**
+ * 支持的表单控件类型
+ * @description 所有支持的表单输入控件类型
+ */
+type ComponentType = 'input' | 'textarea' | 'inputNumber' | 'select' | 'checkbox' | 'radio' | 'switch' | 'slider' | 'rate' | 'datePicker' | 'daterange' | 'timePicker' | 'cascader' | 'colorPicker' | 'upload' | 'editor';
+/**
+ * 选项项接口
+ * @description 用于 select、checkbox、radio 等组件的选项配置
+ */
+interface OptionItem {
+  value: string | number | boolean;
+  label: string;
+  disabled?: boolean;
+  [key: string]: unknown;
+}
+interface AsyncOptionsContext {
+  field: string;
+  reason: 'initialize' | 'dependency' | 'manual';
+  signal: AbortSignal;
+}
+interface FormErrorContext {
+  source: 'initialize' | 'async-options' | 'callback' | 'render' | 'submit';
+  field?: string;
+}
+/** 组件卸载时取消当前提交，业务请求可直接使用 signal。 */
+interface FormSubmitContext {
+  signal: AbortSignal;
+}
+/**
+ * 标签页配置接口
+ * @description 用于标签页布局的单个标签页配置
+ */
+interface TabConfig {
+  key: string;
+  title: string;
+  description?: string;
+  disabled?: boolean;
+  icon?: string;
+  closable?: boolean;
+}
+/**
+ * 步骤配置接口
+ * @description 用于步骤布局的单个步骤配置
+ */
+interface StepConfig {
+  key: string;
+  title: string;
+  description?: string;
+  disabled?: boolean;
+  icon?: string;
+  required?: boolean;
+}
+/**
+ * 分组配置接口
+ * @description 用于卡片布局和自定义布局的分组配置
+ */
+interface GroupConfig {
+  key: string;
+  title: string;
+  description?: string;
+  icon?: string;
+  color?: string;
+  collapsible?: boolean;
+  collapsed?: boolean;
+  defaultExpanded?: boolean;
+}
+/**
+ * 动态字段配置接口
+ * @description 用于动态布局的字段配置
+ */
+interface DynamicFieldConfig {
+  id: string;
+  type: ComponentType | string;
+  prop: string;
+  label: string;
+  visible: boolean;
+  removable: boolean;
+  created: number;
+  placeholder?: string;
+  layout?: {
+    span?: number;
+  };
+  rules?: readonly FormValidationRule[];
+}
+/**
+ * 表单项布局配置
+ * @description 单个表单项的布局相关配置
+ */
+interface ItemLayoutConfig {
+  span?: number;
+  offset?: number;
+  width?: string | number;
+  group?: string;
+  tab?: string;
+  step?: string;
+  dynamic?: boolean;
+  customRender?: boolean;
+  enhanced?: boolean;
+  class?: string;
+  style?: CSSProperties | Record<string, unknown>;
+  hidden?: boolean;
+  suffix?: boolean;
+  /** Legacy nested grid attributes; top-level layout values take precedence. */
+  grid?: {
+    span?: number;
+    offset?: number;
+    suffix?: boolean;
+  };
+}
+/**
+ * 网格布局配置
+ * @description 网格布局的详细配置选项
+ */
+interface GridLayoutConfig {
+  cols?: number;
+  /** 可选的字段最小宽度（包含 label）；responsive=false 时不自动扩展。 */
+  minItemWidth?: number;
+  gutter?: number;
+  yGutter?: number;
+  xGap?: number;
+  yGap?: number;
+  responsive?: boolean;
+  showConfigPanel?: boolean;
+  showStats?: boolean;
+}
+/**
+ * 内联布局配置
+ * @description 内联布局的详细配置选项
+ */
+interface InlineLayoutConfig {
+  gap?: number;
+  rowGap?: number;
+  itemWidth?: number;
+  align?: 'start' | 'center' | 'end' | 'baseline' | 'stretch';
+  wrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+}
+/**
+ * 卡片布局配置
+ * @description 卡片布局的详细配置选项
+ */
+interface CardLayoutConfig {
+  groups?: GroupConfig[];
+  spacing?: number;
+  bordered?: boolean;
+  direction?: 'vertical' | 'horizontal';
+  showLayoutConfig?: boolean;
+  showActionPanel?: boolean;
+  showProgress?: boolean;
+}
+/**
+ * 标签页布局配置
+ * @description 标签页布局的详细配置选项
+ */
+interface TabsLayoutConfig {
+  tabs?: TabConfig[];
+  type?: 'line' | 'card' | 'segment';
+  size?: 'small' | 'medium' | 'large';
+  placement?: 'top' | 'right' | 'bottom' | 'left';
+  defaultTab?: string;
+  animated?: boolean;
+  closable?: boolean;
+  addable?: boolean;
+  showTabHeader?: boolean;
+  showActions?: boolean;
+  showCount?: boolean;
+  validateBeforeSwitch?: boolean;
+}
+/**
+ * 步骤布局配置
+ * @description 步骤布局的详细配置选项
+ */
+interface StepsLayoutConfig {
+  steps?: StepConfig[];
+  vertical?: boolean;
+  size?: 'small' | 'medium';
+  defaultStep?: number;
+  showStepHeader?: boolean;
+  validateBeforeNext?: boolean;
+  prevButtonText?: string;
+  nextButtonText?: string;
+}
+/**
+ * 动态布局配置
+ * @description 动态布局的详细配置选项
+ */
+interface DynamicLayoutConfig {
+  grid?: {
+    cols?: number;
+    gutter?: number;
+  };
+  controls?: {
+    showControls?: boolean;
+    showItemControls?: boolean;
+    showStats?: boolean;
+  };
+  dynamic?: {
+    allowAdd?: boolean;
+    allowRemove?: boolean;
+    allowToggle?: boolean;
+    maxFields?: number;
+  };
+}
+/**
+ * 自定义渲染布局配置
+ * @description 自定义渲染布局的详细配置选项
+ */
+interface CustomLayoutConfig {
+  groups?: GroupConfig[];
+  rendering?: {
+    mode?: 'basic' | 'enhanced';
+    animations?: boolean;
+    tooltips?: boolean;
+  };
+  display?: {
+    showIntro?: boolean;
+    showModeSwitch?: boolean;
+    showGroupActions?: boolean;
+    showStats?: boolean;
+  };
+}
+/**
+ * 完整布局配置
+ * @description 包含所有布局类型的配置选项
+ */
+interface LayoutConfig {
+  type?: LayoutType;
+  grid?: GridLayoutConfig;
+  inline?: InlineLayoutConfig;
+  card?: CardLayoutConfig;
+  tabs?: TabsLayoutConfig;
+  steps?: StepsLayoutConfig;
+  dynamic?: DynamicLayoutConfig;
+  custom?: CustomLayoutConfig;
+}
+/**
+ * 表单配置项接口
+ * @description 单个表单项的完整配置
+ */
+interface FormOptionBase<T extends object> {
+  id?: string;
+  type: ComponentType | string;
+  label?: string;
+  placeholder?: string;
+  rules?: readonly FormValidationRule[];
+  attrs?: Record<string, unknown>;
+  children?: OptionItem[];
+  /** 应用字典名称或直接选项源；asyncOptions、显式 children 优先。 */
+  dictionary?: DictionaryBinding;
+  show?: boolean;
+  layout?: ItemLayoutConfig;
+  help?: string;
+  required?: boolean;
+  dependsOn?: FieldPath<T> | FieldPath<T>[];
+  showWhen?: (formModel: FormModel<T>) => boolean;
+  /** 自定义/虚拟控件准备并返回真实焦点目标；由表单校验状态后执行 focus。 */
+  focusTarget?: (context: {
+    field: FieldPath<T>;
+    element: HTMLElement | null;
+    model: FormModel<T>;
+    signal: AbortSignal;
+  }) => MaybePromise<HTMLElement | null>;
+  /** 字段级禁用（优先级高于全局 config.disabled） */
+  disabled?: boolean | ((formModel: FormModel<T>) => boolean);
+  /** 字段级只读（优先级高于全局 config.readonly） */
+  readonly?: boolean | ((formModel: FormModel<T>) => boolean);
+  /** 异步数据源：select / cascader / checkbox / radio 的远程选项加载 */
+  asyncOptions?: (formModel: FormModel<T>, context?: AsyncOptionsContext) => Promise<readonly OptionItem[]>;
+  /** 联动校验规则：根据表单数据动态返回校验规则 */
+  rulesWhen?: (formModel: FormModel<T>) => readonly FormValidationRule[];
+  /** 跨字段校验：需要引用多个字段值的验证函数，返回错误消息或 null */
+  crossFieldValidator?: (formModel: FormModel<T>) => MaybePromise<string | null>;
+}
+/** 字段名与初值、联动返回值关联；未声明业务模型时保持动态表单的宽松契约。 */
+type FormOption<T extends object = FormRecord> = FormOptionBase<T> & { [P in FieldPath<T>]: {
+  prop: P;
+  value?: FieldPathValue<T, P>; /** 联动赋值：其他字段变化时自动计算本字段的值。 */
+  valueWhen?: (formModel: FormModel<T>) => FieldPathValue<T, P>;
+} }[FieldPath<T>];
+/**
+ * 表单提交事件参数
+ */
+interface SubmitEventPayload<T extends object = FormRecord> {
+  model: FormModel<T>;
+  form: FormInst;
+}
+/**
+ * C_Form 组件实例暴露的方法
+ * @description 表单组件实例对外暴露的所有方法
+ */
+interface FormInstance<T extends object = FormRecord> {
+  validate(): Promise<void>;
+  /** 展开字段所在区域并聚焦可用控件；隐藏、只读、禁用或切换被阻止时返回 false。 */
+  revealField(field: string): Promise<boolean>;
+  validateField(field: FieldPath<T> | FieldPath<T>[]): Promise<void>;
+  validateStep(step: number | string): Promise<boolean>;
+  validateTab(tabKey: string): Promise<boolean>;
+  validateDynamicFields(): Promise<boolean>;
+  validateCustomGroup(groupKey: string): Promise<boolean>;
+  clearValidation(field?: FieldPath<T> | FieldPath<T>[]): void;
+  getModel(): FormModel<T>;
+  setFields(fields: Partial<FormModel<T>>): void;
+  resetFields(): void;
+  setFieldValue<P extends FieldPath<T>>(field: P, value: FieldPathValue<T, P>, shouldValidate?: boolean): Promise<void>;
+  getFieldValue<P extends FieldPath<T>>(field: P): FieldPathValue<T, P>;
+  setFieldsValue(fields: Partial<FormModel<T>>, shouldValidate?: boolean): Promise<void>;
+  formRef: FormInst | null;
+  formModel: FormModel<T>;
+  initialize(): void;
+  layoutType: LayoutType;
+  shouldShowDefaultActions: boolean;
+  /** 表单是否被修改过 */
+  isDirty: boolean;
+  /** 获取被修改的字段列表 */
+  getChangedFields(): FieldPath<T>[];
+  /** 检查某字段是否被修改 */
+  isFieldDirty(field: FieldPath<T>): boolean;
+  /** 将当前值设为初始快照（常用于编辑模式加载数据后） */
+  markAsClean(): void;
+  /** 字段异步选项的 loading 状态 */
+  asyncLoadingMap: Record<string, boolean>;
+  /** 字段异步选项加载错误 */
+  asyncErrorMap: Record<string, unknown>;
+  /** 重新加载全部或指定字段的异步选项 */
+  reloadOptions(field?: FieldPath<T>): Promise<void>;
+  /** 是否正在提交 */
+  isSubmitting: boolean;
+  /** 验证并提交，成功返回 true */
+  submit(): Promise<boolean>;
+}
+/** C_Form 默认操作区插槽参数。 */
+interface FormActionSlotProps<T extends object = FormRecord> {
+  form: FormInst | null;
+  model: FormModel<T>;
+  validate: FormInstance<T>['validate'];
+  validateField: FormInstance<T>['validateField'];
+  reset: FormInstance<T>['resetFields'];
+  setFields: FormInstance<T>['setFields'];
+  getModel: FormInstance<T>['getModel'];
+  clearValidation: FormInstance<T>['clearValidation'];
+  submit: FormInstance<T>['submit'];
+  reloadOptions: FormInstance<T>['reloadOptions'];
+  submitting: boolean;
+}
+/** Tabs 布局操作区插槽参数。 */
+interface FormTabActionsSlotProps {
+  currentTab: string;
+  totalTabs: number;
+  validateTab: () => Promise<boolean>;
+  switchToTab: (targetTab: string) => Promise<boolean>;
+}
+/** Steps 布局操作区插槽参数。 */
+interface FormStepActionsSlotProps {
+  currentStep: number;
+  totalSteps: number;
+  isFirstStep: boolean;
+  isLastStep: boolean;
+  nextStep: () => Promise<void>;
+  previousStep: () => void;
+  goToStep: (stepIndex: number) => Promise<void>;
+  /** Validate and submit the complete form, including fields in other steps. */
+  submit: () => Promise<boolean>;
+  submitting: boolean;
+}
+/** C_Form 对外公开的具名插槽。 */
+interface FormSlots<T extends object = FormRecord> {
+  /** Field-specific named slots are intentionally open-ended. */
+  [slotName: string]: ((props: any) => unknown) | undefined;
+  action?: (props: FormActionSlotProps<T>) => unknown;
+  /** 增加业务按钮，保留组件默认的提交、重置和加载管理。 */
+  'action-extra'?: (props: FormActionSlotProps<T>) => unknown;
+  'tab-actions'?: (props: FormTabActionsSlotProps) => unknown;
+  'step-actions'?: (props: FormStepActionsSlotProps) => unknown;
+}
+/**
+ * 表单数据模型类型（泛型）
+ */
+type FormModel<T extends object = FormRecord> = T;
+/**
+ * 渲染模式类型
+ */
+type RenderMode = 'basic' | 'enhanced';
+/**
+ * 动态表单配置接口
+ */
+interface DynamicFormConfig {
+  maxFields: number;
+  autoSave: boolean;
+  enableSort: boolean;
+  showControls: boolean;
+  showItemControls: boolean;
+}
+/**
+ * 动态表单状态接口
+ */
+interface DynamicFormState {
+  config: DynamicFormConfig;
+  baseFields: FormOption[];
+  dynamicFields: DynamicFieldConfig[];
+  hiddenFieldIds: Set<string>;
+  fieldCounter: number;
+  isInitialized: boolean;
+}
+/**
+ * 动态表单状态控制器
+ * @description 为组合式函数提供稳定的公共返回类型，避免声明文件泄漏依赖库内部类型
+ */
+interface DynamicFormController {
+  state: DeepReadonly<DynamicFormState>;
+  allFields: ComputedRef<FormOption[]>;
+  visibleFields: ComputedRef<FormOption[]>;
+  dynamicFieldsCount: ComputedRef<number>;
+  hiddenFieldsCount: ComputedRef<number>;
+  canAddMoreFields: ComputedRef<boolean>;
+  allVisible: ComputedRef<boolean>;
+  FIELD_TYPE_OPTIONS: ReadonlyArray<{
+    label: string;
+    value: ComponentType;
+  }>;
+  addField(config?: Partial<DynamicFieldConfig>): DynamicFieldConfig | null;
+  removeField(index?: number): DynamicFieldConfig | null;
+  clearDynamicFields(): number;
+  toggleFieldVisibility(fieldId: string): boolean;
+  toggleAllVisibility(): boolean;
+  updateConfig(config: Partial<DynamicFormConfig>): void;
+  exportConfig(): string;
+  initialize(baseFields: FormOption[], config?: Partial<DynamicFormConfig>): void;
+}
+//#endregion
+//#region src/components/C_Form/composables/useFormConfig.d.ts
+/** 布局回调事件 — 替代原先 16 个 emit 中的纯透传事件 */
+interface LayoutCallbacks<T extends object = FormRecord> {
+  onTabChange?: (tabKey: string, tabIndex: number) => void;
+  onTabBeforeChange?: (currentTab: string, targetTab: string) => MaybePromise<boolean | void>;
+  onTabValidate?: (tabKey: string) => void;
+  onStepChange?: (stepIndex: number, stepKey: string) => void;
+  onStepBeforeChange?: (currentStep: number, targetStep: number) => MaybePromise<boolean | void>;
+  onStepValidate?: (stepIndex: number) => void;
+  onFieldAdd?: (fieldConfig: DynamicFieldConfig) => void;
+  onFieldRemove?: (fieldId: string) => void;
+  onFieldToggle?: (fieldId: string, visible: boolean) => void;
+  onFieldsClear?: () => void;
+  onRenderModeChange?: (mode: RenderMode) => void;
+  onGroupToggle?: (groupKey: string, collapsed: boolean) => void;
+  onGroupReset?: (groupKey: string) => void;
+  onFieldsChange?: (fields: FormOption<T>[]) => void;
+  onSubmit?: (payload: SubmitEventPayload<T>, context?: FormSubmitContext) => unknown;
+  onError?: (error: unknown, context: FormErrorContext) => void;
+}
+/**
+ * C_Form 统一配置接口
+ * @description 收拢原先 13 个分散 Props 为 1 个 config 对象
+ * 默认值均在 FORM_DEFAULTS 中集中管理
+ */
+interface FormConfig<T extends object = FormRecord> extends LayoutCallbacks<T> {
+  feedback?: ComponentFeedback;
+  locale?: ComponentLocale;
+  /** 布局类型，默认 'default' */
+  layout?: LayoutType;
+  /** 标签位置，默认 'left' */
+  labelPlacement?: LabelPlacement;
+  /** 标签宽度，默认 'auto' */
+  labelWidth?: string | number;
+  /** 尺寸，默认 'medium' */
+  size?: 'small' | 'medium' | 'large';
+  /** 与表格、搜索表单一致的密度；显式 size 和布局间距优先。 */
+  density?: ComponentDensity;
+  /** 禁用整个表单，默认 false */
+  disabled?: boolean;
+  /** 只读，默认 false */
+  readonly?: boolean;
+  /** 显示默认提交/重置按钮，默认 true */
+  showActions?: boolean;
+  /** 值变化时自动校验，默认 false */
+  validateOnChange?: boolean;
+  /** 动态移除配置项后是否保留其模型值，默认 false */
+  preserveRemovedFields?: boolean;
+  /** 默认提交按钮文案 */
+  submitText?: string;
+  /** 默认重置按钮文案 */
+  resetText?: string;
+  /** 提交完成后的提示；默认不显示，由业务明确配置。 */
+  submitSuccessText?: string;
+  /** 重置完成后的提示；默认不显示。 */
+  resetSuccessText?: string;
+  /** 表单模式：create = 新建（默认），edit = 编辑（配合 initialValues 实现回填 + 脏检查） */
+  mode?: FormMode;
+  /** 编辑模式初始值：设置后自动作为脏检查基准 */
+  initialValues?: Partial<T>;
+  grid?: GridLayoutConfig;
+  inline?: InlineLayoutConfig;
+  card?: CardLayoutConfig;
+  tabs?: TabsLayoutConfig;
+  steps?: StepsLayoutConfig;
+  dynamic?: DynamicLayoutConfig;
+  custom?: CustomLayoutConfig;
+}
+/** Read application-level C_Form defaults without requiring a provider. */
+declare function useFormGlobalConfig(): FormConfig;
+/** Merge nested layout sections while preserving local-over-global precedence. */
+declare function mergeFormConfig(local: FormConfig | undefined, global: FormConfig): FormConfig;
+/** 解析后的配置（所有必填字段均已设置默认值） */
+interface ResolvedFormConfig extends Required<Omit<FormConfig, keyof LayoutCallbacks | 'grid' | 'inline' | 'card' | 'tabs' | 'steps' | 'dynamic' | 'custom' | 'initialValues' | 'feedback' | 'locale'>> {
+  grid?: GridLayoutConfig;
+  inline?: InlineLayoutConfig;
+  card?: CardLayoutConfig;
+  tabs?: TabsLayoutConfig;
+  steps?: StepsLayoutConfig;
+  dynamic?: DynamicLayoutConfig;
+  custom?: CustomLayoutConfig;
+  onTabChange?: LayoutCallbacks['onTabChange'];
+  onTabBeforeChange?: LayoutCallbacks['onTabBeforeChange'];
+  onTabValidate?: LayoutCallbacks['onTabValidate'];
+  onStepChange?: LayoutCallbacks['onStepChange'];
+  onStepBeforeChange?: LayoutCallbacks['onStepBeforeChange'];
+  onStepValidate?: LayoutCallbacks['onStepValidate'];
+  onFieldAdd?: LayoutCallbacks['onFieldAdd'];
+  onFieldRemove?: LayoutCallbacks['onFieldRemove'];
+  onFieldToggle?: LayoutCallbacks['onFieldToggle'];
+  onFieldsClear?: LayoutCallbacks['onFieldsClear'];
+  onRenderModeChange?: LayoutCallbacks['onRenderModeChange'];
+  onGroupToggle?: LayoutCallbacks['onGroupToggle'];
+  onGroupReset?: LayoutCallbacks['onGroupReset'];
+  onFieldsChange?: LayoutCallbacks['onFieldsChange'];
+  onSubmit?: LayoutCallbacks['onSubmit'];
+  onError?: LayoutCallbacks['onError'];
+  initialValues?: Record<string, any>;
+  feedback?: ComponentFeedback;
+  locale?: ComponentLocale;
+}
+declare const FORM_DEFAULTS: ResolvedFormConfig;
+/** 拥有自身控制按钮的布局（不显示默认操作按钮） */
+declare const LAYOUTS_WITH_OWN_CONTROLS: readonly LayoutType[];
+/**
+ * 解析 FormConfig，合并默认值
+ * @param config - 用户传入的配置（可选）
+ * @returns 具有完整默认值的 ResolvedFormConfig
+ */
+declare function resolveFormConfig(config?: FormConfig): ResolvedFormConfig;
+/**
+ * 计算是否显示默认操作按钮
+ * @param resolved - 已解析的配置
+ */
+declare function shouldShowActions(resolved: ResolvedFormConfig): boolean;
+//#endregion
+export { FormTabActionsSlotProps as A, TabsLayoutConfig as B, FormMode as C, FormSlots as D, FormRecord as E, LayoutType as F, SPEC_RULES as G, NAIVE_COMBOS as H, MaybePromise as I, OptionItem as L, InlineLayoutConfig as M, LabelPlacement as N, FormStepActionsSlotProps as O, LayoutConfig as P, StepsLayoutConfig as R, FormInstance as S, FormOption as T, PRESET_RULES as U, FormValidationRule as V, RuleSpec$1 as W, DynamicFormState as _, ResolvedFormConfig as a, FormActionSlotProps as b, shouldShowActions as c, CardLayoutConfig as d, ComponentType as f, DynamicFormController as g, DynamicFormConfig as h, LayoutCallbacks as i, GridLayoutConfig as j, FormSubmitContext as k, useFormGlobalConfig as l, DynamicFieldConfig as m, FormConfig as n, mergeFormConfig as o, CustomLayoutConfig as p, LAYOUTS_WITH_OWN_CONTROLS as r, resolveFormConfig as s, FORM_DEFAULTS as t, AsyncOptionsContext as u, FieldPath as v, FormModel as w, FormErrorContext as x, FieldPathValue as y, SubmitEventPayload as z };