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

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

@@ -1,87 +1,32 @@
 import { DatePickerShortcut, FormItemConfig, FormItemConfigList, ExtractFormStringifyFromObject, FormItemConfigSwiftOptions } from './types';
 import { ColProps } from 'element-plus';
-/**
- * 嵌套布局 rebase 的栅格档集（P3）。
- * ---
- * FormMain/PanelMain 配置化 `span` 约定用 24 的约数 {6,8,12,24}（admin 常用档）；
- * 子层 rebase（×scale）后 ceil 到这组档，避免非约数（18/16/7）致行铺不满 ragged。
- */
 export declare const NEST_LAYOUT_TIERS: readonly [6, 8, 12, 24];
-/**
- * 把数值 ceil 到档集中 ≥ value 的最近一档（偏宽取向）。
- * ---
- * - value ≤ 下限 → 取下限；value ≥ 上限 → 封顶上限。
- * - 落档间 → 抬到上一档（如 16 → 24，非更近的 12），合「容器窄字段更宽」意图。
- */
 export declare const ceilToTier: (value: number, tiers?: readonly number[]) => number;
-/**
- * 从 layout 解析父 item 实际分配的代表 span（P3 rebase 算因子用）。
- * ---
- * span 优先；无 span 时取 lg→md→sm→xl→xs 首个数值断点代表；都无 → 24（本层不缩）。
- */
 export declare const resolveLayoutSpan: (layout?: Partial<ColProps>) => number;
-/**
- * 将 layout 解析为各屏幕尺寸的显式值：
- * - 配置 span: xxx 时，xs/sm/md/lg/xl 默认全部视为 xxx
- * - 单独设置某个尺寸则该尺寸覆盖 span 推导值
- * ---
- * **P3 嵌套 rebase**：可选第 2 参 `scale`（嵌套累乘因子，缺省 1）。
- * - `scale === 1` → 现状行为不变（非档值原样透传，[MUST NOT] ceil，向后兼容关键）。
- * - `scale !== 1` → span 及各断点数值 `× scale` 后经 `ceilToTier` 取整到档集，
- *   维持子层字段绝对宽与顶级一致（容器变窄 → span 变大）。
- */
 export declare const resolveFormLayout: (layout?: Partial<ColProps>, scale?: number) => Partial<ColProps>;
-/**
- * 生成 ElDatePicker 原生 `shortcuts` 的默认时间段快捷值：今日、昨日、近7日。
- * 直接用于 `<ElDatePicker :shortcuts="getDatePickerShortcuts()">`——
- * 由 ElDatePicker 自身 pick 管线按其 value-format 归一化输出，
- * 与手动选日期完全同源，无需任何额外格式化依赖。
- */
 export declare const getDatePickerShortcuts: () => DatePickerShortcut[];
-/**
- * 生成表单数据
- */
 export declare const generateFormData: <PO extends Record<string, any>, SO extends Record<string, any>>(list: FormItemConfigList<PO, SO>) => PO;
-/**
- * 解析表单数据
- */
 export declare const parseFormData: <PO extends Record<string, any>, SO extends Record<string, any>>(data: ExtractFormStringifyFromObject<PO, SO>, list: FormItemConfigList<PO, SO>) => PO;
-/**
- * 序列化表单数据
- */
 export declare const stringifyFormData: <PO extends Record<string, any>, SO extends Record<string, any>>(data: PO, list: FormItemConfigList<PO, SO>) => import('./types').ExcludeNeverProperties<import('./types').ExtractFormStringifyRawFromObject<PO, SO>>;
-/**
- * 获取v-model语法糖配置
- */
 export declare const getVModelSugar: <PO extends Record<string, any>, SO extends Record<string, any>, PK extends Extract<keyof PO, string>, MK extends string>({ modelValueKey, config, data, updateData, }: {
     modelValueKey?: MK;
     config: FormItemConfig<PO, SO>;
     data: PO;
     updateData?: (val: PO[PK]) => void;
 }) => { [P in MK]: PO[PK]; } & { [E in string as `onUpdate:${MK}`]: (val: PO[PK]) => void; };
-/** 获取placeholder */
 export declare const getPlaceholder: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>) => {
     placeholder?: string;
 };
-/** 获取回车提交 */
 export declare const getEnterSubmit: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>, handler: () => void) => {
     onKeyup: (e: KeyboardEvent) => void;
 } | undefined;
-/** 获取失去焦点提交 */
 export declare const getBlurSubmit: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>, handler: () => void) => {
     onBlur: () => void;
 } | undefined;
-/** 获取变化提交 */
 export declare const getChangeSubmit: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>, handler: () => void) => {
     onChange: () => void;
 } | undefined;
-/** form item 更改loading状态 */
 export declare const FORM_ITEM_CHANGE_LOADING: unique symbol;
-/** 设置输入类型组件 */
 export declare const setInputComponent: (components: any[]) => void;
-/** 设置选择类型组件 */
 export declare const setSelectComponent: (components: any[]) => void;
-/** 快捷配置表单项 */
-export declare const swiftFormItemConfig: <PO extends Record<string, any>, 
-/** 需要格式化的模型 */
-SO extends Record<string, any>>(options: FormItemConfigSwiftOptions<PO, SO>) => FormItemConfig<PO, SO>;
+export declare const swiftFormItemConfig: <PO extends Record<string, any>, SO extends Record<string, any>>(options: FormItemConfigSwiftOptions<PO, SO>) => FormItemConfig<PO, SO>;

package/types/components/list-page/ListPage.vue.d.ts

@@ -29,21 +29,15 @@ declare const _default: <T extends Record<string, any>, PO extends Record<string
     expose(exposed: import('vue').ShallowUnwrapRef<ListPageInstance<PO, Record<string, any>>>): void;
     attrs: any;
     slots: Readonly<{
-        /** 头部插槽（无 scope） */
         header?: () => VNode[];
-        /** 操作区插槽（无 scope） */
         operation?: () => VNode[];
-        /** 自定义视图项插槽 */
         "custom-view-item"?: (scope: DataListViewItemScope<T>) => VNode[];
     } & { [K in `form-${Extract<keyof PO, string>}`]?: ((scope: FormScope<PO, SO, Extract<keyof PO, string>, any, any>) => VNode[]) | undefined; } & { [K_1 in `table-${Uppercase<string>}` | `table-${Exclude<Extract<keyof T, string>, "item" | "custom-view-item"> & {}}`]?: ((scope: TableColumnDefaultScope<T, ListPageInnerInjectInfo<PO, F>>) => VNode[]) | undefined; } & { [K_2 in `table-header-${Uppercase<string>}` | `table-header-${Exclude<Extract<keyof T, string>, "item" | "custom-view-item"> & {}}`]?: ((scope: TableColumnHeaderScope<T, ListPageInnerInjectInfo<PO, F>> & {
         searchFormData: PO;
         triggerSearch: (() => void) | undefined;
     }) => VNode[]) | undefined; }> & {
-        /** 头部插槽（无 scope） */
         header?: () => VNode[];
-        /** 操作区插槽（无 scope） */
         operation?: () => VNode[];
-        /** 自定义视图项插槽 */
         "custom-view-item"?: (scope: DataListViewItemScope<T>) => VNode[];
     } & { [K in `form-${Extract<keyof PO, string>}`]?: ((scope: FormScope<PO, SO, Extract<keyof PO, string>, any, any>) => VNode[]) | undefined; } & { [K_1 in `table-${Uppercase<string>}` | `table-${Exclude<Extract<keyof T, string>, "item" | "custom-view-item"> & {}}`]?: ((scope: TableColumnDefaultScope<T, ListPageInnerInjectInfo<PO, F>>) => VNode[]) | undefined; } & { [K_2 in `table-header-${Uppercase<string>}` | `table-header-${Exclude<Extract<keyof T, string>, "item" | "custom-view-item"> & {}}`]?: ((scope: TableColumnHeaderScope<T, ListPageInnerInjectInfo<PO, F>> & {
         searchFormData: PO;

package/types/components/list-page/types.d.ts

@@ -5,37 +5,20 @@ export type FormSearchRewriteKey = "list";
 export type TableMainOptionsKey = "refine" | "refineReduceHeight" | "viewportHeight" | "parentChannel" | "toolbar" | "showSwitchView";
 export type TableMainRequiredKey = "columns" | "rowKey";
 export type TableMainRewriteKey = "api" | "query" | "injectInfo";
-export type ListPageInnerInjectInfo<PO extends Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any>> = Pick<ListPageInstance<PO>, "triggerReset" | "triggerSearch" | "update"> & F;
-export type ListPageProps<
-/** 行数据结构 */
-T extends Record<string, any>, 
-/** 表单标准结构模型 */
-PO extends Record<string, any>, 
-/** 表单需转换的部分结构模型 */
-SO extends Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any>> = Partial<Pick<FormSearchProps<PO, SO, {}>, FormSearchOptionsKey>> & {
+export type ListPageInnerInjectInfo<PO extends Record<string, any>, F extends Record<string, any>> = Pick<ListPageInstance<PO>, "triggerReset" | "triggerSearch" | "update"> & F;
+export type ListPageProps<T extends Record<string, any>, PO extends Record<string, any>, SO extends Record<string, any>, SQ extends Record<string, any>, F extends Record<string, any>> = Partial<Pick<FormSearchProps<PO, SO, {}>, FormSearchOptionsKey>> & {
     formSearchProps?: Partial<Omit<FormSearchProps<PO, SO, {}>, FormSearchOptionsKey | FormSearchRewriteKey>>;
 } & Pick<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListPageInnerInjectInfo<PO, F>>, TableMainRequiredKey> & Partial<Pick<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListPageInnerInjectInfo<PO, F>>, TableMainOptionsKey>> & {
     tableMainProps?: Partial<Omit<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListPageInnerInjectInfo<PO, F>>, TableMainOptionsKey | TableMainOptionsKey | TableMainRewriteKey>>;
 } & {
     list?: FormItemConfigList<PO, SO>;
-    /** api */
     api: (params: TableApiParams<ExtractFormStringifyFromObject<PO, SO> & SQ>) => Promise<TableApiResult<T>>;
-    /** 静态参数 */
     query?: SQ;
     injectInfo?: F;
-    /** 搜索前的回调[同步] */
     beforeSearch?: (data: ExtractFormStringifyFromObject<PO, SO>, type: FormSearchSearchType) => ExtractFormStringifyFromObject<PO, SO>;
-    /** 在点击搜索重置按钮时，是否同时调用清空表格表头过滤 */
     clearTableFilterOnReset?: boolean;
 };
 export interface ListPageInstance<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> extends FormSearchInstance<PO, SO>, TableMainInstance {
-    /** 更新表单数据 */
     update: (key: Extract<keyof PO, string>, value: any) => void;
 }
 export type ListApiParams<L, SQ extends Record<string, any>> = TableApiParams<ExtractFormStringifyFromList<L> & SQ>;

package/types/components/misc/index.d.ts

@@ -3,9 +3,4 @@ import { default as AutoRefresh } from './AutoRefresh.vue';
 import { default as AutoRefreshGroup } from './AutoRefreshGroup.vue';
 import { default as SelectModule } from './SelectModule.vue';
 export * from './types';
-export { 
-/**
- * @deprecated 全局样式引入后已无用——main.ts `import "element-plus/dist/index.css"`
- * + ElementPlusResolver `importStyle: false` 即可，无需本组件触发按需样式。下个 MAJOR 删除。
- */
-TriggerAutoImport, AutoRefresh, AutoRefreshGroup, SelectModule, };
+export { TriggerAutoImport, AutoRefresh, AutoRefreshGroup, SelectModule, };

package/types/components/misc/types.d.ts

@@ -1,15 +1,9 @@
-/** AutoRefresh 组件 props */
 export interface AutoRefreshProps {
-    /** 刷新方法，返回 Promise。失败不影响下轮定时 */
     refreshFn: () => Promise<unknown>;
-    /** 是否不允许自动刷新。true 时清 timer 且不排下轮 */
     disabled?: boolean;
 }
 export interface AutoRefreshGroupProps extends Omit<AutoRefreshProps, "disabled"> {
-    /** 是否显示自动刷新开关 */
     showAutoRefresh?: boolean;
-    /** 是否显示刷新按钮 */
     showRefresh?: boolean;
-    /** 加载是否正在进行中 */
     loading?: boolean;
 }

package/types/components/modal/ConfirmModal.vue.d.ts

@@ -10,22 +10,12 @@ type __VLS_Props = {
     content?: string | (() => VNode);
     cancelText?: string | (() => VNode);
     confirmText?: string | (() => VNode);
-    /** 是否隐藏取消按钮 */
     hiddenCancel?: boolean;
     width?: number | string;
-    /** 反转按钮位置 */
     reverse?: boolean;
-    /** 按下 ESC 是否关闭 */
     closeOnPressEscape?: boolean;
-    /** 点击遮罩是否关闭 */
     closeOnClickModal?: boolean;
-    /** 是否使用确认按钮loading */
     useLoading?: boolean;
-    /**
-     * 确认按钮 type（对齐 element-plus ElButton type）。
-     * 默认 'primary'；danger / warning / success / info 全枚举均支持,
-     * 与 ActionConfirm popconfirm 模式按钮颜色行为对齐。
-     */
     type?: ButtonProps["type"];
 };
 declare function __VLS_template(): {

package/types/components/modal/modal-shelf-core.d.ts

@@ -1,9 +1,6 @@
 import { Ref } from 'vue';
 import { ModalLevel, ShelfController, ShelfItem } from './modal-shelf-types';
-/** ShelfController 内部扩展：额外暴露渲染用活跃实例列表 */
 export interface ShelfControllerInternal extends ShelfController {
-    /** 渲染用：当前活跃实例列表（多例数组） */
     items: Ref<ShelfItem[]>;
 }
-/** 创建一个架子逻辑控制器（纯逻辑，无 DOM 依赖，可单测） */
 export declare function createShelfController(level: ModalLevel): ShelfControllerInternal;

package/types/components/modal/modal-shelf-hierarchy.d.ts

@@ -1,6 +1,2 @@
 import { ModalLevel } from './modal-shelf-types';
-/**
- * 层级合法性：app 必最顶层；page 祖先允许 app/page（父子页面嵌套场景），仅禁止 custom；custom 可嵌套任何（含 custom 套 custom）。
- * 非法仅开发期 console.error，不抛、不静默。
- */
 export declare function assertLevelHierarchy(level: ModalLevel, ancestorLevels: ModalLevel[]): void;

package/types/components/modal/modal-shelf-types.d.ts

@@ -1,73 +1,39 @@
 import { Component } from 'vue';
-/** 架子层级 */
 export type ModalLevel = "app" | "page" | "custom";
-/** 同 key 再 evoke 策略：recreate=关旧重建(默认)；update=已开则整体替换 props 不 remount */
 export type ModalSameKeyStrategy = "recreate" | "update";
-/**
- * 业务侧 declare merge 扩展此接口声明每个弹窗的业务 props 契约。
- * 例：declare module "@done-coding/admin-core" {
- *   interface ModalShelfMap { detail: { id: string; onConfirm?: (r: unknown) => void } }
- * }
- */
 export interface ModalShelfMap {
 }
-/** 架子注入给弹窗组件的契约（业务 payload 经单 payload 对象传入） */
 export interface ModalInjectedProps<P = Record<string, unknown>> {
-    /** v-model:show 受控可见性 */
     show: boolean;
-    /** 优雅关闭（隐藏→等动画→移除），=== EvokeHandle.close */
     closeFn: () => void;
-    /** 立即移除（无动画） */
     removeFn: () => void;
-    /** 业务 payload（ModalShelfMap[key]） */
     payload: P;
 }
-/** evoke 返回的命令式句柄；只绑稳定 nsKey，调用时现查当前实例（不闭包 id） */
 export interface EvokeHandle {
-    /** 优雅关闭该 nsKey 当前实例；无则 no-op */
     close: () => void;
-    /** 对该 nsKey 当前实例受控增量合并 payload（不 remount）；无则 no-op */
     update: (partialPayload: Record<string, unknown>) => void;
 }
-/** 注册项（扁平，无 options 包裹，无 isSingle——v1 仅多例） */
 export interface RegisterEntry<K extends keyof ModalShelfMap = keyof ModalShelfMap> {
-    /** 弹窗逻辑 key */
     key: K;
-    /** 组件或懒工厂（() => import()） */
     component: Component | (() => Promise<Component>);
-    /** 目标架子：app/page 名称代指，或直接持 ShelfInstance */
     shelf: "app" | "page" | ShelfInstance;
-    /** 同 key 再 evoke 策略，缺省 "recreate" */
     sameKeyStrategy?: ModalSameKeyStrategy;
 }
-/** 架子内部一条活跃实例 */
 export interface ShelfItem {
-    /** 架子内部自增唯一 id，用作渲染 :key */
     id: number;
-    /** porter 命名空间后的注册键 p{porterUid}:{key} */
     nsKey: string;
-    /** 组件或懒工厂 */
     component: Component | (() => Promise<Component>);
-    /** 业务 payload */
     payload: Record<string, unknown>;
-    /** v-model:show */
     show: boolean;
-    /** close 排定的关闭动画定时器句柄；remove 立即移除前 [MUST] clearTimeout 它 */
     timer?: ReturnType<typeof setTimeout>;
 }
-/** ModalShelf 实例 expose === 它 provide 的 controller */
 export interface ShelfController {
-    /** 本架子层级 */
     level: ModalLevel;
-    /** 唤起一条；同 nsKey 先 remove(立即) 旧再新建 */
     evoke: (nsKey: string, component: Component | (() => Promise<Component>), options: {
         payload: Record<string, unknown>;
         sameKeyStrategy?: ModalSameKeyStrategy;
     }) => EvokeHandle;
-    /** 立即移除（不等动画），支持单个或批量 */
     remove: (nsKey: string | string[]) => void;
-    /** 优雅关闭某条（触发隐藏 → 动画结束 → 移除） */
     close: (item: ShelfItem) => void;
 }
-/** ModalShelf 实例引用类型别名（用于 RegisterEntry.shelf 直接持实例定位 custom 架子） */
 export type ShelfInstance = ShelfController;

package/types/components/modal/types.d.ts

@@ -1,36 +1,17 @@
 import { ExtractFormStringifyFromObject, FormItemConfigList, FormMainProps } from '../form';
 import { FormProps } from 'element-plus';
-/** 详情页类型 */
 export type DetailType = "add" | "edit" | "read";
-export interface DetailModalProps<
-/** 表单标准结构模型 */
-PO extends Record<string, any>, 
-/** 表单需转换的部分结构模型 */
-SO extends Record<string, any>> {
-    /** 表单数据 */
+export interface DetailModalProps<PO extends Record<string, any>, SO extends Record<string, any>> {
     data: PO;
-    /** 表单配置 */
     list: FormItemConfigList<PO, SO>;
-    /** 表单类型 */
     type: DetailType;
-    /**
-     * 标题
-     * 最终表现为：新增[标题]、编辑[标题]
-     */
     subTitle?: string;
     show: boolean;
-    /** 新增api */
     addApi?: (data: ExtractFormStringifyFromObject<PO, SO>) => Promise<any>;
-    /** 编辑api */
     editApi?: (data: ExtractFormStringifyFromObject<PO, SO>) => Promise<any>;
-    /** 弹窗宽度 */
     modalWidth?: number | string;
-    /** 表单整体布局 */
     formLayout?: FormMainProps<PO, SO>["layout"];
-    /** elForm其他属性 */
     formProps?: Partial<FormProps>;
-    /** 表单行 gutter，透传给 FormMain */
     formRowGutter?: number;
-    /** 表单 label 宽度 */
     labelWidth?: string;
 }

package/types/components/panel/PanelItemNestForm.vue.d.ts

@@ -1,21 +1,15 @@
 import { ColProps } from 'element-plus';
 import { FormItemConfigList } from '../form';
 type __VLS_Props = {
-    /** 子 FormMain 数据（= 父 item 草稿的嵌套对象，子 in-place 改草稿） */
     data: Record<string, any>;
-    /** 子表单配置列表 */
     list: FormItemConfigList;
     layout?: Partial<ColProps>;
     rowGutter?: number;
     submitText?: string;
     cancelText?: string;
-    /** 校验通过后的业务提交（helper 内 wire submitFn(草稿) → closeEdit）；返回 Promise 自动 loading */
     submit?: () => Promise<unknown> | unknown;
-    /** 取消编辑（helper 内 wire closeEdit） */
     cancel?: () => void;
-    /** 父 item 代表 span（P3 rebase 算因子用；helper 经 resolveLayoutSpan(layout) 传入） */
     parentSpan?: number;
-    /** 是否叠本层嵌套布局 rebase（缺省 true；false = 逆向逃生口，layout 原样直透） */
     rebase?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {

package/types/components/panel/PanelItemNestPanel.vue.d.ts

@@ -1,19 +1,14 @@
 import { PanelItemConfigList } from './types';
 import { ColProps, CardProps } from 'element-plus';
 type __VLS_Props = {
-    /** 子 PanelMain 数据（= 父 item value，嵌套对象） */
     data: Record<string, any>;
-    /** 子 PanelMain 配置列表 */
     list: PanelItemConfigList;
-    /** 子项是否包 Card，缺省继承 PanelMain 默认 */
     itemCard?: boolean | Partial<CardProps & {
         lastMarginBottom?: string;
     }>;
     layout?: Partial<ColProps>;
     rowGutter?: number;
-    /** 父 item 代表 span（P3 rebase 算因子用；helper 经 resolveLayoutSpan(layout) 传入） */
     parentSpan?: number;
-    /** 是否叠本层嵌套布局 rebase（缺省 true；false = 逆向逃生口，layout 原样直透） */
     rebase?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {

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

@@ -2,37 +2,16 @@ import { ColProps } from 'element-plus';
 import { PanelItemConfig, PanelScopeBase } from './types';
 import { FormItemConfigList } from '../form';
 export interface NestPanelFormOptions {
-    /** 父 item key */
     key: string;
-    /** 父 item label */
     label?: string;
-    /** 子 FormMain 配置列表（吃嵌套子对象） */
     list: FormItemConfigList;
-    /** 父 item 栅格布局 */
     layout?: Partial<ColProps>;
-    /** 子表单行间距 */
     rowGutter?: number;
-    /** 提交按钮文案 */
     submitText?: string;
-    /** 取消按钮文案 */
     cancelText?: string;
-    /** 是否可编辑，缺省 true */
     editable?: boolean | ((scope: PanelScopeBase) => boolean);
-    /** 单字段提交：校验通过后回流草稿到父数据（panel 既有 submitFn 语义） */
     submitFn: PanelItemConfig["submitFn"];
-    /** 只读态展示渲染；缺省走 PanelItem 默认（纯文本 data[key]） */
     render?: PanelItemConfig["render"];
-    /** 是否叠本层嵌套布局 rebase（P3，缺省 true；false = 逆向逃生口，子层 layout 原样直透） */
     rebase?: boolean;
 }
-/**
- * 生成「父 panel item 编辑态内嵌子 FormMain」的 PanelItemConfig（C3 配套 helper）
- * ----
- * 走 editorRender（优先级高于 editorConfig，panel/types.ts L65-77）挂 PanelItemNestForm：
- * - 编辑态：PanelEditSwitch 进编辑时深克隆草稿（scope.data），子 FormMain 绑草稿嵌套对象
- *   in-place 编辑（不穿透真实 data，ADR-5 panel 分支）；
- * - 提交：组件内 validateChild 通过 → 本 helper wire 的 submit（`submitFn(草稿) → closeEdit`）回流；
- * - 取消：closeEdit 关编辑态，草稿丢弃，下次进编辑重新克隆。
- * editorConfig 与 editorRender 互斥——C3 用 editorRender，同一 item [MUST NOT] 再配 editorConfig。
- */
 export declare function nestPanelForm(options: NestPanelFormOptions): PanelItemConfig;

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

@@ -1,28 +1,14 @@
 import { ColProps, CardProps } from 'element-plus';
 import { PanelItemConfig, PanelItemConfigList } from './types';
 export interface NestPanelItemOptions {
-    /** 父 item key */
     key: string;
-    /** 父 item label */
     label?: string;
-    /** 子 PanelMain 配置列表（吃嵌套子对象） */
     list: PanelItemConfigList;
-    /** 父 item 栅格布局 */
     layout?: Partial<ColProps>;
-    /** 子 PanelMain 子项是否包 Card */
     itemCard?: boolean | Partial<CardProps & {
         lastMarginBottom?: string;
     }>;
-    /** 子 PanelMain 行间距 */
     rowGutter?: number;
-    /** 是否叠本层嵌套布局 rebase（P3，缺省 true；false = 逆向逃生口，子层 layout 原样直透） */
     rebase?: boolean;
 }
-/**
- * 生成「父 panel item 内嵌子 PanelMain」的 PanelItemConfig（C2 配套 helper）
- * ----
- * 降低业务方手写 h(PanelItemNestPanel) 噪音：传 key/label/子 list 即得一个满足
- * PanelItemConfig 的纯展示配置项，render 出口挂 PanelItemNestPanel（嵌套对象只读展示）。
- * 值贯通：render scope.value（= data[key] 嵌套对象）作子 PanelMain.data。
- */
 export declare function nestPanelItem(options: NestPanelItemOptions): PanelItemConfig;

package/types/components/panel/types.d.ts

@@ -1,96 +1,48 @@
 import { VNode } from 'vue';
 import { ColProps, CardProps } from 'element-plus';
 import { ExtractFormStringifyFromObject, FormDataInfo, FormItemConfig, FormSubmitPanelProps } from '../form';
-/**
- * 通用作用于
- * -----
- * 用于 render 、editorRender 及 判断
- */
 export interface PanelScopeBase<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> {
-    /** 原始数据（只读消费，[MUST NOT] 在 render 内修改） */
     data: ExtractFormStringifyFromObject<PO, SO>;
-    /** data[config.key] */
     value: any;
-    /** 配置项 */
     config: PanelItemConfig<PO, SO>;
 }
-/**
- * Panel render 作用域
- * -----
- * 应用于 render \ editorRender
- */
 export interface PanelRenderScope<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> extends PanelScopeBase<PO, SO> {
-    /** 是否编辑态 */
     editing: boolean;
-    /** 请求 PanelMain 调用 refreshFn；仅用于 render/editorRender 自管刷新，不处理 editorConfig 提交成功 */
     refresh?: () => Promise<unknown> | void;
-    /** 结束编辑态 */
     closeEdit?: () => void;
 }
-/** Panel 配置项 */
 export interface PanelItemConfig<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> {
-    /** 数据键 */
     key: string;
-    /** 标签，非必填 */
     label?: string;
-    /** 栅格布局，复用 resolveFormLayout 语义；缺省继承 PanelMain.layout */
     layout?: Partial<ColProps>;
-    /** 隐藏 */
     hide?: boolean | ((scope: PanelScopeBase<PO, SO>) => boolean);
-    /** 只读渲染；缺省=纯文本 data[key] */
     render?: string | Record<string, any> | ((scope: PanelRenderScope<PO, SO>) => VNode[]);
-    /** 是否可就地编辑 */
     editable?: boolean | ((scope: PanelScopeBase<PO, SO>) => boolean);
-    /** 编辑器渲染；仅 editable 时需要
-     * ----
-     * 使用优先级高于 editorConfig
-     */
     editorRender?: string | Record<string, any> | ((scope: PanelRenderScope<PO, SO>) => VNode[]);
-    /** 编辑器表单配置；仅 editable 时需要
-     * ----
-     * 使用优先级次于 editorRender
-     * 但是优先级高于 render 即编辑态时使用render
-     */
     editorConfig?: Omit<FormItemConfig<PO, SO>, "key" | "label" | "labelHide" | "layout">;
-    /** 单字段提交；仅 editable 时需要。draft = 深克隆副本 */
     submitFn?: FormSubmitPanelProps<PO, SO>["submitFn"];
 }
-/** Panel 配置项列表 */
 export type PanelItemConfigList<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> = PanelItemConfig<PO, SO>[];
-/** PanelMain props */
 export interface PanelMainProps<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> {
     data: ExtractFormStringifyFromObject<PO, SO>;
-    /** 行水平间距 */
     rowGutter?: number;
     layout?: Partial<ColProps>;
-    /** P3 嵌套 rebase 累乘因子（缺省 1 = 顶级行为不变，向后兼容）。由联结薄壳算出后传子 PanelMain */
     layoutScale?: number;
     list: PanelItemConfigList<PO, SO>;
-    /** item是否包括Card */
     itemCard?: boolean | Partial<CardProps & {
-        /** 最后一个 margin bottom */
         lastMarginBottom?: string;
     }>;
-    /** render/editorRender 内 scope.refresh 的回调；editorConfig 提交成功请监听 submitSuccess */
-    refreshFn?: (currentStringifyData: any, 
-    /** 当前的key */
-    key: string) => Promise<unknown> | void;
+    refreshFn?: (currentStringifyData: any, key: string) => Promise<unknown> | void;
 }
-/** PanelItem props */
 export interface PanelItemProps<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> {
     data: ExtractFormStringifyFromObject<PO, SO>;
     config: PanelItemConfig<PO, SO>;
-    /** render/editorRender 内 scope.refresh 的回调；不承接 submitSuccess */
     refreshFn?: (currentStringifyData: FormDataInfo<PO, SO>["stringifyData"]) => Promise<unknown> | void;
 }
-/** PanelEditSwitch props */
 export interface PanelEditSwitchProps<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> extends Partial<Pick<FormSubmitPanelProps<PO, SO>, "submitFn">> {
     data: ExtractFormStringifyFromObject<PO, SO>;
-    /** panel 配置项 */
     config: Omit<PanelItemConfig<PO, SO>, "editorConfig"> & {
-        /** 缺失的key label 由 PanelItem补齐 */
         editorConfig?: FormItemConfig<PO, SO>;
     };
-    /** 是否可编辑 */
     editable?: boolean;
 }