@done-coding/admin-core 0.12.1 → 0.12.2-alpha.0

package/types/components/form/FormVerifyCode.vue.d.ts

@@ -3,20 +3,11 @@ declare const _default: <P extends Record<string, any>>(__VLS_props: NonNullable
         readonly "onUpdate:modelValue"?: ((value: string) => any) | undefined;
     } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onUpdate:modelValue"> & {
         modelValue: string;
-        /** 发送频率 */
         hz?: number;
         api: (params?: P) => Promise<void>;
-        /** 请求参数 */
         params?: P;
-        /** 重置标识
-         * 内部检测变化以重新计时
-         * @example  const resetKey = ref(1);
-         * 需要重置时 resetKey.value++;
-         *  */
         resetKey?: number;
-        /** 是否禁用 */
         disabled?: boolean;
-        /** 发送按钮文本 */
         btnText?: string;
     } & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;

package/types/components/form/FormVerifyImage.vue.d.ts

@@ -6,7 +6,6 @@ declare const _default: <P extends Record<string, any>>(__VLS_props: NonNullable
         imgWidth?: number;
         api: (params?: P) => Promise<string>;
         params?: P;
-        /** 是否自动销毁图片链接 */
         autoRevokeUrl?: boolean;
     } & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;

package/types/components/form/form-search-utils.d.ts

@@ -1,23 +1,9 @@
 import { ColProps } from 'element-plus';
 import { Breakpoint } from '../../hooks/use-breakpoint';
 export declare const computeItemsPerRow: (span: number) => number;
-/**
- * 计算按钮 ElCol 的 offset，使其推到当前行最右。
- * ElRow 共 24 格。
- *
- * @param visibleCount 可见表单项数量（不含按钮自身）
- * @param span         当前断点下每个表单项的 span
- */
 export declare const computeButtonOffset: (visibleCount: number, span: number) => number;
-/**
- * 按每个响应断点分别计算按钮的 { span, offset }，
- * 返回可直接 v-bind 到 ElCol 的对象。
- */
 export declare const computeButtonColProps: (layout: Partial<ColProps> | undefined, visibleCount: number) => Record<string, {
     span: number;
     offset: number;
 }>;
-/**
- * 计算当前断点下每行能容纳的表单项数。
- */
 export declare const getCurrentSpan: (layout: Partial<ColProps> | undefined, breakpoint: Breakpoint) => number;

package/types/components/form/nest-form-item-list.d.ts

@@ -3,61 +3,33 @@ import { ColProps } from 'element-plus';
 import { FormItemConfig, FormItemConfigList } from './types';
 import { ActionBtnConfirmConfig } from '../display';
 export interface NestFormItemListOptions {
-    /** 父 item key */
     key: string;
-    /** 父 item label */
     label: string;
-    /** 每行子表单配置列表 */
     list: FormItemConfigList;
-    /** 行稳定标识字段（指向行对象内稳定 id）；缺省走内部自增 rowId */
     rowKey?: string;
-    /** 新增行工厂；缺省 generateFormData(list) */
     itemFactory?: () => Record<string, any>;
-    /** 最少行数 */
     min?: number;
-    /** 最多行数 */
     max?: number;
-    /** 父 item 栅格布局 */
     layout?: Partial<ColProps>;
-    /** 每行子表单行间距 */
     rowGutter?: number;
-    /** 新增 / 删除按钮文案 */
     addText?: string;
     removeText?: string;
-    /** 顶部自定义渲染（render-fn；label 由父 FormItem 渲染，本组件不出 title） */
     headerRender?: (scope: {
         count: number;
         max: number;
     }) => VNodeChild;
-    /** 底部自定义渲染；缺省 = 内置「新增」按钮 */
     footerRender?: (scope: {
         count: number;
         max: number;
         canAdd: boolean;
         add: () => void;
     }) => VNodeChild;
-    /** 联结组件外环 + 每行分割阴影颜色 */
     shadowColor?: string;
-    /** 业务校验规则；与自动织入的 min/max 长度规则合并（长度规则在前） */
     rules?: FormItemConfig["rules"];
-    /** 覆盖默认 init（缺省 = 空数组 []，[MUST NOT] 改初始值补 min；min/max 走校验） */
     init?: FormItemConfig["init"];
-    /** 覆盖默认 stringify（缺省 = 数组逐项 `stringifyFormData(t, list)`） */
     stringify?: FormItemConfig["stringify"];
-    /** 覆盖默认 parse（缺省 = 数组逐项 `parseFormData(t, list)`） */
     parse?: FormItemConfig["parse"];
-    /** 是否叠本层嵌套布局 rebase（P3，缺省 true；false = 逆向逃生口，子层 layout 原样直透） */
     rebase?: boolean;
-    /** 行删除二次确认（缺省 true=默认 popconfirm「确认删除该项？」；false=直删；对象=自定义） */
     removeConfirm?: boolean | ActionBtnConfirmConfig;
 }
-/**
- * 生成「父 item 内嵌数组子表单（N 行 FormMain）」的 FormItemConfig（C4 配套 helper）
- * ----
- * render 出口挂 FormItemNestFormList（值贯通数组 in-place + 增删 + 聚合校验穿透自动接线）。
- * ----
- * **序列化 pack（ADR-6，对齐 §34）**：自动织入 init/stringify/parse —— 父 FormMain 的
- * generate()/stringify()/parse() 逐项命中即对数组逐项递归（行内若再嵌 nestFormItem /
- * nestFormItemList → 逐层组合）。业务传 init/stringify/parse 则以业务为准。
- */
 export declare function nestFormItemList(options: NestFormItemListOptions): FormItemConfig;

package/types/components/form/nest-form-item.d.ts

@@ -1,36 +1,15 @@
 import { ColProps } from 'element-plus';
 import { FormItemConfig, FormItemConfigList } from './types';
 export interface NestFormItemOptions {
-    /** 父 item key */
     key: string;
-    /** 父 item label */
     label: string;
-    /** 子表单配置列表 */
     list: FormItemConfigList;
-    /** 父 item 栅格布局 */
     layout?: Partial<ColProps>;
-    /** 子表单行间距 */
     rowGutter?: number;
-    /** 联结组件外环阴影颜色 */
     shadowColor?: string;
-    /** 覆盖默认 init（缺省 = `generateFormData(list)`，产子默认对象） */
     init?: FormItemConfig["init"];
-    /** 覆盖默认 stringify（缺省 = 递归 `stringifyFormData(value, list)`） */
     stringify?: FormItemConfig["stringify"];
-    /** 覆盖默认 parse（缺省 = 递归 `parseFormData(value, list)`） */
     parse?: FormItemConfig["parse"];
-    /** 是否叠本层嵌套布局 rebase（P3，缺省 true；false = 逆向逃生口，子层 layout 原样直透） */
     rebase?: boolean;
 }
-/**
- * 生成「父 item 内嵌子 FormMain」的 FormItemConfig（C1 配套 helper）
- * ----
- * 降低业务方手写 h(FormItemNestForm) 噪音：传 key/label/子 list 即得一个满足 FormItemConfig
- * 的配置项，渲染出口挂 FormItemNestForm（值贯通 + 校验级联自动接线）。
- * ----
- * **stringify/parse/init 自动 pack**：FormItemConfig 的 per-item `init`/`stringify`/`parse`
- * 钩子 + 纯 list 驱动 util（generate/stringify/parseFormData）→ 自动织入「递归进子 list」，
- * 父 FormMain 的 `generate()`/`stringify()`/`parse()` 逐项命中即递归序列化/回显嵌套子表单，
- * 多层自然组合（孙 nestFormItem 的钩子同理逐层）。业务传 init/stringify/parse 则以业务为准。
- */
 export declare function nestFormItem(options: NestFormItemOptions): FormItemConfig;

package/types/components/form/nest-registry.d.ts

@@ -1,22 +1,8 @@
 import { FormMainInstance } from './types';
-/**
- * 嵌套子 FormMain 级联 expose 子集
- * ----
- * 联结组件（FormItemNestForm）把所持子 FormMain 的级联方法注册进父 FormMain 的 exposeMap，
- * 使父顶层 validate/clearValidate/resetFields 可级联到子。
- */
 export interface NestFormExpose {
     validate: FormMainInstance["validate"];
     clearValidate: FormMainInstance["clearValidate"];
     resetFields: FormMainInstance["resetFields"];
 }
-/**
- * 嵌套子表单 exposeMap
- * ----
- * key = 联结组件所属父 item 的 key（天然唯一，供父 FormMain 对齐 hideKeyList：隐藏 item 不级联 validate）。
- * 用 `shallowReactive`：顶层 key 增删响应式（注册/摘除可被响应式消费），value（expose 对象）保持 raw
- * 不深代理——既规避 expose 引用循环，又留响应式消费口。每个 FormMain 经工厂在闭包内 new 一份，零模块级单例。
- */
 export type NestFormExposeMap = Record<string, NestFormExpose>;
-/** 创建一个嵌套子表单 exposeMap（shallowReactive） */
 export declare function createNestFormExposeMap(): NestFormExposeMap;

package/types/components/form/types.d.ts

@@ -5,132 +5,61 @@ export type OnlyOneKey<T extends Record<string, any>> = {
         [P in K]?: T[P];
     } & Partial<Record<Exclude<keyof T, K>, never>>;
 }[keyof T];
-/** 额外扩展表单配置项 */
 export type FormItemConfigExtra = OnlyOneKey<{
-    /** 是输入类型 */
     isInput: boolean;
-    /** 是选择类型 */
     isSelect: boolean;
 }> & {
-    /** 回车提交 */
     enterSubmit?: boolean;
-    /** 失去焦点提交[isInput默认为true] */
     blurSubmit?: boolean;
-    /** 变化提交 [isSelect默认为true] */
     changeSubmit?: boolean;
 };
 interface WrapProps extends FormItemProps {
     [key: string]: any;
 }
-/** formItem联动配置 */
 interface FormItemLinkConfig<K extends string, BV, OV> {
-    /** 关联(该宿主配置)表单项的key */
     key: K;
-    /**
-     * 获取该项的值
-     * @param hostValue 宿主/依赖项的值
-     * @param ownValue 该(寄生/收集依赖)项的值
-     * @param attachInfo 附加信息，可用于表单渲染为自定义组件时触发事件triggerChangeLink, 此场景 寄生项的值内部会去拿
-     * @example emit('triggerChangeLink', hostValue, attachInfo)
-     */
     getValue: (hostValue: BV, ownValue: OV, attachInfo?: any) => void;
 }
-/** formItem配置 */
-export interface FormItemConfig<PO extends Record<string, any> = Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any> = Record<string, any>, 
-/** 解析的模型的key */
-PK extends Extract<keyof PO, string> = Extract<keyof PO, string>, 
-/** 解析的模型的值 */
-PV extends PO[PK] = PO[PK], 
-/** 需要格式化的模型的值 */
-SV extends PK extends keyof SO ? SO[PK] : PV = PK extends keyof SO ? SO[PK] : PV> {
-    /** 表单项key __大写视为忽略 等价于 ignore = true */
+export interface FormItemConfig<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>, PK extends Extract<keyof PO, string> = Extract<keyof PO, string>, PV extends PO[PK] = PO[PK], SV extends PK extends keyof SO ? SO[PK] : PV = PK extends keyof SO ? SO[PK] : PV> {
     key: PK;
-    /** 表单项label */
     label: string;
-    /**
-     * 隐藏 label 且不占位（label-wrap 整体 display:none，表单元素顶满整行）。
-     * 仅当 label 有值时生效——无 label 时 element-plus 会给 content 加 margin-left 留白，需改用 labelWidth:0。
-     */
     labelHide?: boolean;
-    /** 提示信息 */
     tip?: string | (() => VNode);
-    /** 表单布局 优先级高于FormMain同名属性 */
     layout?: Partial<ColProps>;
-    /** 表单外FormItem属性 */
     wrapProps?: Partial<WrapProps> | ((scope: FormScope<PO, SO, PK, PV, SV>) => Partial<WrapProps>);
-    /** 表单主体属性 */
     props?: Record<string, any> | ((scope: FormScope<PO, SO, PK, PV, SV>) => Record<string, any>);
-    /** 表单渲染函数/渲染标签/组件 */
     render?: string | Record<string, any> | ((props: {
         modelValue: PV;
         ["onUpdate:modelValue"]: (value: PV) => void;
         placeholder?: string;
         ["onTriggerChangeLink"]?: (value: SV, attachInfo?: any) => void;
     } & Record<string, any>) => VNode);
-    /** 表单校验规则 */
     rules?: FormItemRule[] | ((scope: FormScope<PO, SO, PK, PV, SV>) => FormItemRule[]);
-    /** 表单初始值 */
     init?: (() => PV) | PV;
-    /** 表单回显解析处理 */
     parse?: (value: any, parseData: Partial<PO>, originData: ExtractFormStringifyFromObject<PO, SO>) => PV | void;
-    /** 表单序列化处理 */
     stringify?: (value: any, stringifyData: Partial<ExtractFormStringifyFromObject<PO, SO>>, originData: PO) => SV | void;
-    /**
-     * 是否在初始化数据、解析数据、序列化数据时忽略处理
-     */
     ignore?: boolean;
-    /**
-     * 是否在表单中隐藏
-     */
     hide?: boolean | ((scope: FormScope<PO, SO, PK, PV, SV> & {
         getInitValue: () => PV;
     }) => boolean);
-    /**
-     * 被关联配置
-     * 1. 不要配置当前表单项的key
-     * 2. 最好不要循环关联
-     * 3. 必须循环关联时，避免循环引用
-     */
     beLink?: FormItemLinkConfig<PK, PV, any> | FormItemLinkConfig<PK, PV, any>[];
-    /**
-     * 额外一些配置
-     */
     extra?: FormItemConfigExtra;
 }
-/** form配置 */
 export type FormItemConfigList<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> = FormItemConfig<PO, SO>[];
-/** 表单数据 */ export type FormModel<L> = L extends FormItemConfigList<infer PO, any> ? PO : Record<string, any>;
-/** 提取格式化原始对象 */
+export type FormModel<L> = L extends FormItemConfigList<infer PO, any> ? PO : Record<string, any>;
 export type ExtractFormStringifyRawFromObject<PO extends Record<string, any>, SO extends Record<string, any>> = {
     [K in keyof PO | keyof SO]: K extends keyof SO ? SO[K] extends never ? never : SO[K] extends undefined ? K extends keyof PO ? PO[K] : never : SO[K] : K extends keyof PO ? PO[K] : never;
 };
-/** 表单序列化数据原始 */
 export type ExtractFormStringifyRawFromList<L> = L extends FormItemConfigList<infer PO, infer SO> ? PO extends Record<string, any> ? SO extends Record<string, any> ? ExtractFormStringifyFromObject<PO, SO> : Record<string, any> : Record<string, any> : Record<string, any>;
-/** 提取除never以外的属性值 */
 export type ExcludeNeverProperties<T> = {
     [K in keyof T as T[K] extends never ? never : K]: T[K];
 };
 export type ExtractFormStringifyFromObject<PO extends Record<string, any>, SO extends Record<string, any>> = ExcludeNeverProperties<ExtractFormStringifyRawFromObject<PO, SO>>;
-/** 表单序列化数据 */
 export type ExtractFormStringifyFromList<L> = ExcludeNeverProperties<ExtractFormStringifyRawFromList<L>>;
-/** form作用域数据 */
-export interface FormScope<
-/** 解析的模型 */
-PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>, 
-/** 解析的模型的key */
-PK extends Extract<keyof PO, string>, 
-/** 解析的模型的值 */
-PV extends PO[PK], 
-/** 需要格式化的模型的值 */
-SV extends PK extends keyof SO ? SO[PK] : PV> {
+export interface FormScope<PO extends Record<string, any>, SO extends Record<string, any>, PK extends Extract<keyof PO, string>, PV extends PO[PK], SV extends PK extends keyof SO ? SO[PK] : PV> {
     data: PO;
     config: FormItemConfig<PO, SO, PK, PV, SV>;
 }
-/** FormMain expose类型 */
 export interface FormMainInstance<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> {
     validate: () => Promise<void>;
     resetFields: () => void;
@@ -139,59 +68,44 @@ export interface FormMainInstance<PO extends Record<string, any> = Record<string
     parse: (stringifyData: ExtractFormStringifyFromObject<PO, SO>) => PO;
     stringify: () => ExcludeNeverProperties<ExtractFormStringifyRawFromObject<PO, SO>>;
 }
-/** FormSearch expose类型 */
 export interface FormSearchInstance<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> extends Omit<FormMainInstance<PO, SO>, "generate" | "parse" | "stringify"> {
-    /** 触发搜索 */
     triggerSearch: () => void;
-    /** 触发重置 */
     triggerReset: () => void;
-    /** 切换折叠状态 */
     toggleCollapse: (nextValue?: boolean) => void;
-    /** 当前折叠状态 */
     isCollapsed: ComputedRef<boolean>;
 }
-/** FormItem props */
 export interface FormMainItemProps {
     config: FormItemConfig<Record<string, any>, Record<string, any>>;
     data: Record<string, any>;
 }
-/** FormMain props */
 export interface FormMainProps<PO extends Record<string, any>, SO extends Record<string, any>> {
     list: FormItemConfigList<PO, SO>;
     data: PO;
     layout?: Partial<ColProps>;
     rowGutter?: number;
-    /** P3 嵌套 rebase 累乘因子（缺省 1 = 顶级行为不变，向后兼容）。由联结薄壳算出后传子 FormMain */
     layoutScale?: number;
 }
-/** FormSearch props */
 export interface FormSearchProps<PO extends Record<string, any>, SO extends Record<string, any>, SQ extends Record<string, any>> extends FormMainProps<PO, SO> {
     labelPosition?: "right" | "left" | "top";
     labelWidth?: string;
-    /** 静态参数(非表单 非分页参数) */
     staticQuery?: SQ;
-    /** 最多展示行数，超出折叠。0 = 不折叠。默认 2 */
     maxRows?: number;
 }
-/** form item loading 信息 */
 export interface FormItemLoadingInfo {
     key: string;
     label: string;
     message: string;
 }
-/** form item 加载状态信息 */
 export type FormItemLoadingChangeFunc = (data: {
     key: string;
     message?: string;
 }) => void;
-/** 选项类型 */
 export interface OptionItem extends Record<string, any> {
     label: string | number;
     value: string | number;
     disabled?: boolean;
     [key: string]: any;
 }
-/** form tree 单项类型 */
 export interface FormTreeItem {
     id: string | number;
     label: string;
@@ -199,136 +113,45 @@ export interface FormTreeItem {
     disabled?: boolean;
     [key: string]: any;
 }
-/** form单项表单提交类型 */
 export type FormItemSubmitType = "blur" | "change" | "enter";
-/** 表单搜索搜索类型 */
 export type FormSearchSearchType = "search" | "reset" | FormItemSubmitType;
-/**
- * ElDatePicker 原生 `shortcuts` 项（时间段快捷）。
- * 直接传给 `<ElDatePicker :shortcuts="...">`，由 ElDatePicker 自身的
- * pick 管线按其 value-format 归一化输出，无需额外格式化依赖。
- */
 export interface DatePickerShortcut {
     text: string;
     value: () => [Date, Date];
 }
-export type FormItemConfigSwiftOptionsCommon<PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>> = Omit<FormItemConfig<PO, SO>, "rules"> & {
-    /** label */
-    /**
-     *  表单类型
-     * ----
-     *  input: 会补齐 extra.isInput = true 最终表现在组件会默认设置placeholder `请输入${label}`,同时如果设置了required 会自动添加一条校验规则 提示信息同 placeholder;
-     *
-     *  select: 会补齐 extra.isSelect = true 最终表现在组件会默认设置placeholder `请选择${label}`,同时如果设置了required 会自动添加一条校验规则 提示信息同 placeholder;
-     *  如果不设置此项 不会补齐 extra
-     */
+export type FormItemConfigSwiftOptionsCommon<PO extends Record<string, any>, SO extends Record<string, any>> = Omit<FormItemConfig<PO, SO>, "rules"> & {
     type?: "input" | "select";
 };
-/** 表单配置项快捷生成类型 - 设置required */
-export interface FormItemConfigSwiftOptionsRequired<PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>> extends FormItemConfigSwiftOptionsCommon<PO, SO> {
-    /**
-     * 是否必填
-     * -----
-     * 设置了此项 不能设置 rules, 如果校验规则只是验证必填 使用此选项更方便
-     */
+export interface FormItemConfigSwiftOptionsRequired<PO extends Record<string, any>, SO extends Record<string, any>> extends FormItemConfigSwiftOptionsCommon<PO, SO> {
     required?: true;
 }
-/** 表单配置项快捷生成类型 - 设置rules */
-export interface FormItemConfigSwiftOptionsRules<PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>> extends FormItemConfigSwiftOptionsCommon<PO, SO> {
-    /**
-     * 校验规则
-     * ---
-     * 设置了此项 不能直接设置 required, 如果校验规则特殊 或者 要基于数据值动态校验 请使用 rules
-     */
+export interface FormItemConfigSwiftOptionsRules<PO extends Record<string, any>, SO extends Record<string, any>> extends FormItemConfigSwiftOptionsCommon<PO, SO> {
     rules?: FormItemConfig["rules"];
 }
-/** 表单数据信息 */
-export interface FormDataInfo<PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>> {
-    /** 表单模型数据 */
+export interface FormDataInfo<PO extends Record<string, any>, SO extends Record<string, any>> {
     parseData: PO;
-    /** 表单序列化数据 */
     stringifyData: ExtractFormStringifyFromObject<PO, SO>;
 }
-/** 表单配置项快捷生成类型 */
-export type FormItemConfigSwiftOptions<PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>> = FormItemConfigSwiftOptionsRequired<PO, SO> | FormItemConfigSwiftOptionsRules<PO, SO>;
-/** 表单提交按钮 */
+export type FormItemConfigSwiftOptions<PO extends Record<string, any>, SO extends Record<string, any>> = FormItemConfigSwiftOptionsRequired<PO, SO> | FormItemConfigSwiftOptionsRules<PO, SO>;
 export type FormSubmitBtnProps<PO extends Record<string, any>, SO extends Record<string, any>> = Omit<ButtonProps, "loading"> & {
-    /** form main expose */
     formMainInstance: FormMainInstance<PO, SO>;
-    /** 提交按钮文本 */
     submitText?: string;
-    /** 提交方法 */
     submitFn: (stringifyData: ExcludeNeverProperties<ExtractFormStringifyRawFromObject<PO, SO>>) => Promise<unknown>;
 };
-/** 表单提交按钮扁平属性 */
 export type FormSubmitPanelFlatProps = Extract<keyof FormSubmitBtnProps<Record<string, any>, Record<string, any>>, "submitText" | "submitFn">;
-/**
- * 表单提交面板 props——= FormMain props 透传 + 提交相关。
- * 容器内编排 FormMain + FormSubmitBtn（formMainInstance 内部自动接线），对称 FormSearch。
- */
 export type FormSubmitPanelProps<PO extends Record<string, any>, SO extends Record<string, any>> = Omit<FormMainProps<PO, SO>, "data"> & {
-    /**
-     * 序列化的数据
-     * -----
-     * 此属性不为空 那么优先使用此字段转换为PO数据模型， 否则内部会基于表单配置化 生成初始化 PO 数据模型
-     */
     stringifyData?: ExcludeNeverProperties<ExtractFormStringifyRawFromObject<PO, SO>>;
 } & Pick<FormSubmitBtnProps<PO, SO>, FormSubmitPanelFlatProps> & {
     submitBtnProps?: Omit<FormSubmitBtnProps<PO, SO>, FormSubmitPanelFlatProps | "formMainInstance">;
 } & {
     labelPosition?: "right" | "left" | "top";
     labelWidth?: string;
-    /**
-     * 取消按钮
-     * -----
-     * 同名插槽优先级高于props,如果是props则只是取消按钮的文字 为空则不展示
-     * ----
-     * 默认的cancelBtn插槽的按钮点击后触发 cancel 事件
-     */
     cancelBtn?: string;
-    /** 重置按钮
-     * -----
-     * 同名插槽优先级高于props,如果是props则只是重置按钮的文字 为空则不展示
-     * ----
-     * 默认的resetBtn插槽的按钮点击后重置内部 parseData，并通过 parseDataChange 通知外部
-     */
     resetBtn?: string;
-    /** 操作区位置
-     * ----
-     * 默认值 bottom-center
-     */
     operationPosition?: "bottom-center" | "bottom-right" | "top-right";
-    /** 操作区是否做图钉
-     * ----
-     * 默认值 false
-     */
     operationAffix?: boolean | AffixProps;
-    /** 操作区分隔线（含外侧圆角）
-     * ----
-     * 默认值 true；置 false 去掉分隔线 + 圆角（极简 / 单按钮场景）
-     */
     divider?: boolean;
-    /** 操作区无内边距（bare）
-     * ----
-     * 默认 false；置 true 去掉操作区 padding（嵌入 / 极简场景）。
-     * 与 divider 正交：divider 管边框+圆角，bare 管 padding，可叠加全 flush。
-     */
     bare?: boolean;
-    /** 根面板自定义 class（显式根出口）
-     * ----
-     * inheritAttrs:false 下消费方 `class` 经 v-bind 转发内层 FormMain（对标 FormSearch），
-     * 根面板 `.form-submit-panel` 拿不到。需给根面板加类时用本 prop。
-     */
     rootClass?: string | string[] | Record<string, boolean>;
 };
 export {};

package/types/components/form/use-form-submit.d.ts

@@ -1,25 +1,13 @@
 import { Ref } from 'vue';
 import { FormMainInstance, FormSubmitBtnProps, FormDataInfo } from './types';
-/** useFormSubmit 入参——提交管线的 4 个外部接线点 */
 export interface UseFormSubmitOptions<PO extends Record<string, any>, SO extends Record<string, any>> {
-    /** 惰性取 FormMain 实例（首渲染 undefined 容忍，click 时才用） */
     getFormMainInstance: () => FormMainInstance<PO, SO>;
-    /** 提交方法（每次调用时读取，保留响应式） */
     submitFn: FormSubmitBtnProps<PO, SO>["submitFn"];
-    /** 成功回调（载荷 = stringifyData） */
     onSuccess?: (data: FormDataInfo<PO, SO>["stringifyData"]) => void;
-    /** 失败回调（校验未过 / submitFn reject） */
     onFail?: (error: unknown) => void;
 }
-/** useFormSubmit 返回——loading 态 + 提交触发器 */
 export interface UseFormSubmitReturn {
-    /** 提交中 loading 态 */
     submitting: Ref<boolean>;
-    /** 触发提交：validate → stringify → submitFn → onSuccess / onFail */
     submit: () => Promise<void>;
 }
-/**
- * 表单提交管线 composable——validate→stringify→submitFn 全程接管 loading。
- * FormSubmitBtn 与 FormSubmitPanel(#submitBtn slot) 共用，单一事实源。
- */
 export declare function useFormSubmit<PO extends Record<string, any>, SO extends Record<string, any>>(options: UseFormSubmitOptions<PO, SO>): UseFormSubmitReturn;

package/types/components/form/use-nest-form-list.d.ts

@@ -1,20 +1,7 @@
 import { MaybeRefOrGetter } from 'vue';
 import { FormMainInstance } from './types';
 export interface UseNestFormListOptions {
-    /** 当前存活行子 FormMain 实例（getter，每次取最新存活集合） */
     rowInstances: () => FormMainInstance[];
-    /**
-     * 父 item key——注册到父 FormMain exposeMap 的索引（C4 必传）；
-     * 无父 FormMain registry（脱离嵌套上下文）时 inject 返回 null → 跳过注册。
-     */
     key?: MaybeRefOrGetter<string | undefined>;
 }
-/**
- * 数组子表单聚合注册 composable（C4 配套，ADR-1/2）
- * ----
- * 向最近祖先 FormMain registry 注册【1 个聚合 expose】（key = 本 item key），方法体
- * fan-out 遍历当前存活 N 行子 FormMain：validate=Promise.all、clearValidate/resetFields=forEach。
- * → 父 registry 仍「1 item 1 entry」，父 validate 的 hideKeyList 过滤按 item key 命中（守 ADR-8）。
- * 职责收窄：仅聚合注册 + 摘除，[MUST NOT] 碰值贯通 / 增删（组件自管）。
- */
 export declare function useNestFormList(options: UseNestFormListOptions): void;

package/types/components/form/use-nest-form.d.ts

@@ -1,24 +1,9 @@
 import { MaybeRefOrGetter, Ref } from 'vue';
 import { FormMainInstance } from './types';
 export interface UseNestFormOptions {
-    /** 子 FormMain 实例 ref（联结组件内 FormMain 的 defineExpose） */
     childRef: Ref<FormMainInstance | undefined>;
-    /**
-     * 所属父 item key——注册到父 FormMain exposeMap 时必传（C1 form 族，作 map 索引）；
-     * panel 上下文（C3）无父 FormMain exposeMap，可省（inject 返回 null → 跳过注册）。
-     * 接受 ref/getter，挂载/摘除时经 toValue 取值（避免 setup 根作用域读 props 失响应式）。
-     */
     key?: MaybeRefOrGetter<string | undefined>;
 }
-/**
- * 嵌套联结组件子表单接线 composable
- * ----
- * 职责（ADR-7，刻意收窄）：
- * 1. 代理子 FormMain 的 validate / clearValidate / resetFields；
- * 2. context 自适应注册——inject 到最近祖先 FormMain 的 exposeMap 则按 key 写入（onMounted）+
- *    删除（onBeforeUnmount）；无（panel 上下文）则跳过。
- * [MUST NOT] 在此处理值贯通——值语义 form/panel 两族不同（ADR-5），由各联结组件自管。
- */
 export declare function useNestForm(options: UseNestFormOptions): {
     validateChild: () => Promise<void>;
     clearChild: (k?: string) => void;

package/types/components/form/use-nest-layout-scale.d.ts

@@ -1,17 +1,5 @@
 import { MaybeRefOrGetter, ComputedRef } from 'vue';
-/**
- * 联结薄壳计算子 Form/PanelMain 的嵌套布局 rebase 因子（P3，4 薄壳共用）。
- * ----
- * `childScale = parentScale × (24 / parentSpan)`：
- * - parentScale 经 inject 从最近祖先 Form/PanelMain 取（顶级 / 未嵌套 → 缺省 1）；
- * - parentSpan = 父 item 实际分配的代表 span（薄壳由 helper 经 props 传入，缺省 24 = 本层不缩）；
- * - `rebase === false`（逆向逃生口）→ 不叠本层因子（= parentScale），layout 原样直透子层。
- * ----
- * 返回 ComputedRef，薄壳作 `layoutScale` 传子 FormMain/PanelMain（其再 resolveFormLayout 取整到档集）。
- */
 export declare function useNestLayoutScale(options: {
-    /** 父 item 代表 span（来自 helper 的 resolveLayoutSpan(layout)） */
     parentSpan: MaybeRefOrGetter<number | undefined>;
-    /** 是否叠本层 rebase 因子（缺省 true；false = 逆向逃生口） */
     rebase: MaybeRefOrGetter<boolean | undefined>;
 }): ComputedRef<number>;