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

package/types/components/app-layout/AppSidebar.vue.d.ts

@@ -1,8 +1,6 @@
 import { RouteMetaResolveRaw } from '../../types';
 type __VLS_Props = {
-    /** 整体不用管 AppLayout 控制 用在定位出去的子元素的显隐 */
     show: boolean;
-    /** 层级是否高于 header（#7.5 期；true 时 z-index 提升盖住 header） */
     aboveHeader?: boolean;
     menus: RouteMetaResolveRaw[];
     menuFlatList: RouteMetaResolveRaw[];

package/types/components/app-layout/types.d.ts

@@ -1,157 +1,32 @@
 import { Component, VNode } from 'vue';
 import { createAppStore, createUserStore } from '../../store';
-import { AdminBridge } from '../../bridge';
+import { CoreBridge } from '../../bridge';
 import { RouteMetaResolveRaw } from '../../types';
-/**
- * AppLayout 族 app store 消费契约（props/inject 切面）。
- *
- * 调用方通过 props 注入 store 实例，AppLayout 集中 provide，子组件
- * （AppBody / AppHeader / AppSidebar / AppFooter）经 `APP_LAYOUT_APP_STORE_KEY`
- * inject 自取——废除原 AppLayout → 子组件 `:style` / `:showBreadcrumb` props 透传链。
- *
- * 类型由 `createAppStore` 工厂 ReturnType 推导（store 实例完整类型），自动跟随
- * 工厂演化、零手维护字段清单——放弃 narrow 换取 0 维护成本。`UserInfo` /
- * `LoginParams` 泛型未显式实例化时走工厂 default `Record<string, any>` /
- * `unknown`（D-a 原则——core 不锁 UserInfo 具体 shape）。
- *
- * app-layout 族下沉 core 后此 slice 仍是 props/inject 契约——core 端无法直接
- * `useAppStore()`，必须由业务侧通过 props 注入。
- */
 export type AppLayoutAppStoreSlice<UserInfo = Record<string, any>> = ReturnType<ReturnType<typeof createAppStore<UserInfo>>>;
-/**
- * AppLayout 族 user store 消费契约（props/inject 切面）。
- *
- * 调用方通过 props 注入，AppLayout 集中 provide，子组件（AppHeader）经
- * `APP_LAYOUT_USER_STORE_KEY` inject 自取。
- *
- * 类型由 `createUserStore` 工厂 ReturnType 推导。`UserInfo` 走工厂 default
- * `Record<string, any>`（D-a 原则——core 不锁 UserInfo 具体 shape），业务侧
- * （如 AppLayout watermark content / AppHeader user dropdown）按需 cast 为本应用
- * 具体 shape。
- */
 export type AppLayoutUserStoreSlice<UserInfo = Record<string, any>> = ReturnType<ReturnType<typeof createUserStore<UserInfo>>>;
-/**
- * AppLayout 族 admin bridge 消费契约（props/inject 切面，#7.6 期挂载）。
- *
- * AppLayout 通过 `props.adminBridge` 注入 + `provide(APP_LAYOUT_BRIDGE_KEY, ...)`，
- * 子组件（AppBody / AppHeader / AppSidebar / AppLayout 自身菜单派生）inject 自取——
- * 与 `AppLayoutAppStoreSlice` / `AppLayoutUserStoreSlice` 完全对称范式。
- *
- * 仅暴露 layout 子组件实际读取的字段：12 readonly 配置属性 + 2 派生方法
- * （getRoutes / generateRouteMetaRawTree）。loginApi / refreshToken 等 auth
- * 面不通过本 slice 暴露（业务侧通过 appAdminBridge 直读）。
- */
-export type AppLayoutBridgeSlice = Pick<AdminBridge, "APP_BASE_INFO" | "APP_ENV_INFO" | "APP_CACHE_CONFIG" | "APP_LAYOUT_HEADER_CONFIG" | "APP_LAYOUT_FOOTER_CONFIG" | "APP_LAYOUT_SIDEBAR_CONFIG" | "APP_LAYOUT_BREADCRUMB_CONFIG" | "APP_LAYOUT_BODY_CONFIG" | "APP_LAYOUT_VIEWPORT_CONFIG" | "APP_LAYOUT_GAP_CONFIG" | "APP_LAYOUT_CONFIG" | "APP_ROUTER_META_DEFAULT_CONFIG" | "APP_ROUTER_CONFIG" | "APP_ROUTER_PATHS_CONFIG" | "APP_THEME_CONFIG" | "theme" | "themeStyle" | "themeMode" | "themeIsDark" | "themeLayout" | "themeDensity" | "themeMotion" | "themeColors" | "showThemeStyleSwitcher" | "getRoutes" | "generateRouteMetaRawTree">;
-/**
- * 内容锚 slot 名集（焊缝契约 ③，纯功能语义；P1' 去布局化重做）。
- *
- * 业务 slot 为**内容锚**（描述「是什么功能」非「放哪」）——同一份业务原料，落位权归
- * AppShell：不同 AppShell 把同一内容锚渲染到不同区域 = 不同布局人格。AppLayout 用
- * `v-for` 整组动态透传给 AppShell（[MUST NOT] 在 AppLayout 写死任一内容锚落位）。
- *
- * - `brand`：品牌 / logo / 应用名入口
- * - `userEntry`：用户下拉 / 登录按钮 / 用户态入口
- * - `settings`：设置 / 配置入口
- * - `themeSwitcher`：主题（风格 + 亮暗）切换器（scope 传内置 AppTheme 默认内容）
- * - `aside`（P4 加）：右侧补充区内容中转锚 → 喂进 `AppAside` 默认 slot。
- *   **与 sidebar 同构：全局单实例 + 应用层切入**——App.vue 填一次 `#aside`（同
- *   `#brand` / `#userEntry` 范式），`showAside=true`（路由 `meta.layout.aside` 派生）
- *   的页面都显示这同一份；宽度 / 位置 / 容器归主题（`preset.layout.aside.width` +
- *   AppAside 积木）。per-page 内容随页变化 = **业务页面开发自决**（如自往 `#aside` 塞
- *   `<RouterView name="aside" />`），**不属本布局体系范围**，core 不建 per-route 投递机制。
- *
- * 去 `nav*` 位置锚：菜单走数据流（`menuFlatList`），渲染成何种导航由 AppShell 自由
- * （复用导出积木 `MenuTree` / `AppSidebar` 或自 DIY）。
- * 内置默认 AppShell 的落位映射（1:1 镜像经典布局）见 `AppShell.vue` 注释。
- */
+export type AppLayoutBridgeSlice = Pick<CoreBridge, "APP_BASE_INFO" | "APP_ENV_INFO" | "APP_CACHE_CONFIG" | "APP_LAYOUT_HEADER_CONFIG" | "APP_LAYOUT_FOOTER_CONFIG" | "APP_LAYOUT_SIDEBAR_CONFIG" | "APP_LAYOUT_ASIDE_CONFIG" | "APP_LAYOUT_BREADCRUMB_CONFIG" | "APP_LAYOUT_BODY_CONFIG" | "APP_LAYOUT_VIEWPORT_CONFIG" | "APP_LAYOUT_GAP_CONFIG" | "APP_LAYOUT_CONFIG" | "APP_ROUTER_META_DEFAULT_CONFIG" | "APP_ROUTER_CONFIG" | "APP_ROUTER_PATHS_CONFIG" | "APP_THEME_CONFIG" | "theme" | "themeStyle" | "themeMode" | "themeIsDark" | "themeLayout" | "themeDensity" | "themeMotion" | "themeColors" | "showThemeStyleSwitcher" | "getRoutes" | "generateRouteMetaRawTree">;
 export type AppShellContentAnchor = "brand" | "userEntry" | "settings" | "themeSwitcher" | "aside";
-/**
- * AppShell 扁平注入面 props（焊缝契约 ①-props）。
- *
- * 原分喂 AppHeader / AppSidebar 的 props **扁平合并为一份**，三处零件由 AppShell
- * 内部自行分发。样式 / themeColors / 折叠态 / changeSidebarCollapseStatus 走
- * **inject**（`APP_LAYOUT_APP_STORE_KEY` / `APP_LAYOUT_BRIDGE_KEY`，AppLayout 已 provide），
- * 不进 props——AppShell setup 内自取（同内置 AppHeader/AppSidebar 既有范式）。
- */
 export interface AppShellProps {
-    /** 完整菜单树（经权限 / menuShow 过滤、排序） */
     menus: RouteMetaResolveRaw[];
-    /** 扁平菜单列表（喂 AppBody / 子零件高度链 + 路由匹配） */
     menuFlatList: RouteMetaResolveRaw[];
-    /** sidebar 区菜单（分流后） */
     sidebarMenus: RouteMetaResolveRaw[];
-    /** header 区菜单（分流后；extractLevel1ToHeader=true 时为 1 级模块） */
     headerMenus: RouteMetaResolveRaw[];
-    /** 当前聚焦菜单 */
     activeMenu?: RouteMetaResolveRaw;
-    /** 当前聚焦模块菜单（header 模块高亮） */
     activeModuleMenu?: RouteMetaResolveRaw;
-    /**
-     * 是否展示 header（路由 meta.layout 基线意图）。AppShell 自解读：决定喂给哪个区域的
-     * `show`（内置默认 shell 喂 AppHeader）。
-     */
     showHeader: boolean;
-    /**
-     * 是否展示 sidebar（路由 meta.layout 基线意图）。语义同 `showHeader`——
-     * 内置默认 shell 喂 AppSidebar 的 `show`。
-     */
     showSidebar: boolean;
-    /**
-     * 是否展示右侧 aside 补充区（路由 meta.layout 基线意图，additive，默认 false）。
-     * 内置经典 shell 不渲染 aside（经典无右栏）；自定义 shell 据此渲染右侧区。
-     */
     showAside: boolean;
-    /**
-     * sidebar 层级是否高于 header（透传内置 AppSidebar.aboveHeader）。
-     * 默认 false；自定义 shell 可忽略。
-     */
     sidebarAboveHeader: boolean;
 }
-/**
- * AppShell emits（焊缝契约 ①-emits）。
- *
- * 当前空——作为统一预留通道。后续 AppShell 需向 AppLayout 反向通知（如布局态变更）
- * 时在此扩展，[MUST NOT] 自造平行回调 props。
- */
 export interface AppShellEmits {
 }
-/**
- * AppShell 默认 scoped slot 作用域参数（焊缝契约 ①-slots，default slot）。
- *
- * AppShell 在「主体该出现的位置」吐出本作用域 → AppLayout 接住后：
- * 用 `Footer` 组件引用组装进 `AppBody #footer`，并把 AppBody（持有 menuFlatList、
- * 守高度链）塞回该默认 slot 位置。这绕过「父传子 slot 是父作用域 vnode、子无法
- * 反向注入子 slot」的 Vue 约束（footer 走「AppShell 吐组件引用 → AppLayout 组装」）。
- */
 export interface AppShellDefaultSlotScope {
-    /**
-     * AppShell 选定的 footer 组件引用（默认 = `componentFallBack.AppFooter`；
-     * 自定义 shell 可吐自定义 footer）。AppLayout 用 `<component :is="Footer" />`
-     * 渲染进 `AppBody #footer`。
-     */
     Footer: Component;
 }
-/**
- * 功能锚 scoped slot 作用域参数（焊缝契约 ①-slots，内容锚 scope）。
- *
- * AppShell 经各功能锚 slot 的 scope 传「内置默认内容组件引用」给布局，布局可用可无视：
- * - `themeSwitcher` 锚 `Default` = 内置 `AppTheme`（保证主题切换功能以某形式可达；布局
- *   无视默认内容时须自供等效切换 UI，否则违约——见声明驱动测试纪律）。
- * - `brand` / `userEntry` / `settings` / `aside` 锚 `Default` = `undefined`（不预设未遇到的需求，随时可扩）。
- */
 export interface AppShellAnchorScope {
-    /** 该功能锚的内置默认内容组件引用（仅 themeSwitcher 提供，markRaw）；其余 undefined */
     Default?: Component;
 }
-/**
- * AppShell slots 契约（焊缝契约 ①-slots 全集）。
- *
- * - `default`：作用域 = {@link AppShellDefaultSlotScope}，AppLayout 在此塞 AppBody（持高度链）。
- * - 各内容锚（{@link AppShellContentAnchor}）：scoped slot（scope = {@link AppShellAnchorScope}），
- *   AppLayout `v-for` 整组转发业务侧填的同名 slot；AppShell 自行决定每个内容锚落到哪个区域。
- */
 export type AppShellSlots = {
-    /** 默认 slot：AppLayout 在此塞 AppBody（scoped，拿 Footer 组件引用组装 #footer） */
     default: (scope: AppShellDefaultSlotScope) => VNode[];
 } & {
     [K in AppShellContentAnchor]?: (scope: AppShellAnchorScope) => VNode[];

package/types/components/app-layout/viewport.d.ts

@@ -1,30 +1,2 @@
-/**
- * viewport 镂空 SVG 装饰边框基础设施常量（焊缝契约 ⑤，P1 冻结）。
- *
- * 把 viewport 那圈留白（`APP_LAYOUT_VIEWPORT_CONFIG` 四边 padding 让出的边距）
- * 从消极留白变积极画布：AppShell 可 teleport 一个铺满视口的大 SVG 到 body、
- * 镂空出内容区，在边框圈里画渐变 / 动画 / 填充色。
- *
- * - **叠加非替代**：现有 `useAdminViewportApply` 的 padding 留白机制保留；SVG 只在
- *   让出的那圈里画装饰。镂空矩形尺寸 = AppShell 经 inject 读 `APP_LAYOUT_VIEWPORT_CONFIG`
- *   四边算（响应式）。
- * - **teleport + pointer-events:none**：teleport 到 body（避开层叠上下文 / overflow
- *   裁切），`pointer-events: none` 绝不挡交互。
- *
- * z-index 双档（core 导出常量，AppShell / 主题资产按需选档）：
- * 业务自造 z-index 字面量会与 el 弹窗（2000 起动态自增）打架——故 core 冻结两档安全值。
- */
-/**
- * viewport 装饰 z-index——**弹窗下档**（默认，绝对安全）。
- *
- * `800 < 2000`（el 弹窗 base z-index）→ 装饰永远在弹窗下，绝不盖住 dialog / message。
- * 大多数边框装饰用此档（装饰是背景氛围，不该盖业务弹窗）。
- */
-export declare const ADMIN_CORE_VIEWPORT_DECOR_ZINDEX_BELOW = 800;
-/**
- * viewport 装饰 z-index——**弹窗上档**（盖住弹窗，慎用）。
- *
- * el z-index 自 2000 动态自增（每开一层 +N），`10000` 实践绝对安全盖住弹窗档。
- * 仅当装饰需覆盖弹窗（如全屏切换动画遮罩 / 边框需压住一切）时用此档。
- */
-export declare const ADMIN_CORE_VIEWPORT_DECOR_ZINDEX_ABOVE = 10000;
+export declare const CORE_VIEWPORT_DECOR_ZINDEX_BELOW = 800;
+export declare const CORE_VIEWPORT_DECOR_ZINDEX_ABOVE = 10000;

package/types/components/data-view/DataListViewItem.vue.d.ts

@@ -1,12 +1,4 @@
-/**
- * DataListView 单项容器
- * ---
- * 仅承载选中态 class 钩子 + 项内容插槽，由 DataListView 内部 v-for 使用。
- * [MUST NOT] 写死视觉样式（卡片阴影/圆角等归消费方）；
- * [MUST NOT] 内置选中状态机（状态机在 DataListView）。
- */
 type __VLS_Props = {
-    /** 当前项是否选中（由 DataListView 传入） */
     selected: boolean;
 };
 declare function __VLS_template(): {

package/types/components/data-view/index.d.ts

@@ -1,8 +1,4 @@
 import { default as DataListView } from './DataListView.vue';
 import { default as DataListViewItem } from './DataListViewItem.vue';
 export * from './types';
-/**
- * data-view 是 table 的内部衍生品：仅供 TableMain 内部 import，
- * [MUST NOT] 对外导出 / 全局注册 / 提供 install 插件（不进 core 顶层 export）。
- */
 export { DataListView, DataListViewItem };

package/types/components/data-view/types.d.ts

@@ -1,64 +1,23 @@
 import { Component } from 'vue';
 import { ElTableColumnProps, TableColumnDefaultScope, TableInstance } from '../table';
-/**
- * DataListView 字段渲染作用域
- * ---
- * 喂给 FieldColumn.render 的作用域；布局无关，仅含行数据与索引。
- */
 export interface DataListViewRenderScope<T extends Record<string, any> = Record<string, any>> {
-    /** 当前行数据 */
     row: T;
-    /** 当前行索引 */
     index: number;
 }
-/**
- * DataListView 列配置（table 的内部衍生品：从 ElTableColumnProps Pick 复用子集，
- * ElTableColumnProps 零触碰；本类型不对外导出，仅 table 内部消费）
- */
 export type DataViewColumn<T extends Record<string, any> = Record<string, any>> = Partial<Pick<ElTableColumnProps<T, any>, "prop" | "label" | "type" | "render">>;
-/**
- * DataListView props
- * ---
- * 布局无关的数据项容器：分页数据由外部传入，一行几个由消费方在 #item
- * 外层用 CSS 决定，本组件不内置任何列数 / 布局。
- */
 export interface DataListViewProps<T extends Record<string, any>, F extends Record<string, any>> {
-    /** 当前页数据（外部传入，组件不持有请求 / 分页逻辑） */
     data: T[];
-    /** 行唯一键：行数据键名 或 取键函数（内部统一 String 化） */
     rowKey: Extract<keyof T, string> | ((row: T) => string);
-    /** 列配置，内部归一为 fieldComponentMap 喂 #item */
     columns: DataViewColumn<T>[];
-    /** 最大高度；传入时容器超出内容出现垂直滚动条，缺省不限高 */
     maxHeight?: number;
-    /** 是否启用选中能力，缺省关闭 */
     selectable?: boolean;
-    /** 获取column 列 上下文 render参数 */
     getRenderCtxParams: () => Pick<TableColumnDefaultScope<T, F>, "injectInfo" | "exposeInfo">;
 }
-/**
- * DataListView 对外实例方法 对齐 elTableInstance
- * -----
- * 未实现的会抛错
- */
 export type DataListViewInstance = TableInstance;
-/**
- * #item 作用域插槽 props
- * ---
- * fieldComponentMap：列 key（prop / $type_index / $type_selection）→ 稳定字段组件
- * （标识跨渲染稳定，对齐 FormItem 范式）。消费方：
- * `<component :is="fieldComponentMap['x']" :row="row" :index="index"
- *   :selected="selected" :toggle-select="toggleSelect" />`（数据走 props）。
- */
 export interface DataListViewItemScope<T extends Record<string, any> = Record<string, any>> {
-    /** 列 key → 稳定字段组件（props: row/index/selected/toggleSelect） */
     fieldComponentMap: Record<string, Component>;
-    /** 当前行数据 */
     row: T;
-    /** 当前行索引 */
     index: number;
-    /** 当前行是否选中 */
     selected: boolean;
-    /** 翻转当前行选中态 */
     toggleSelect: () => void;
 }

package/types/components/data-view/utils.d.ts

@@ -1,5 +1,2 @@
 import { DataListViewInstance } from './types';
-/**
- * 创建 DataListView 实例
- */
 export declare const createDataListViewInstance: (mainMethods: Pick<DataListViewInstance, "clearSelection" | "getSelectionRows" | "toggleRowSelection" | "toggleAllSelection" | "columns">) => DataListViewInstance;

package/types/components/display/TabsHeader.vue.d.ts

@@ -1,9 +1,7 @@
 import { TabsHeaderVariant, TabsMainItem } from './types';
 type __VLS_Props = {
     tabs: TabsMainItem[];
-    /** 视觉嵌套层级,只控字号(1=16 / 2=14 / 3=12 / 4+=12,超 4 钳到 4) */
     level?: number;
-    /** 视觉风格变体;不传按 level 推导默认 */
     variant?: TabsHeaderVariant;
 };
 type __VLS_PublicProps = {

package/types/components/display/TabsMain.vue.d.ts

@@ -1,13 +1,11 @@
 import { VNode } from 'vue';
 import { TabsMainItem, TabsMainProps } from './types';
 type __VLS_Props = TabsMainProps;
-/** 内容插槽 #{key} 的 scope（TabPane 渲染时注入；key = tab.key） */
 interface TabsMainContentScope {
     tab?: TabsMainItem;
     active: boolean;
     viewportHeight?: number;
 }
-/** 标题插槽 #header-{key} 的 scope（中转 TabsHeader 的 #{key}） */
 interface TabsMainHeaderScope {
     tab: TabsMainItem;
     active: boolean;

package/types/components/display/TabsRefineFlow.vue.d.ts

@@ -5,7 +5,6 @@ interface TabsRefineFlowProps {
     channel?: string;
     parentChannel?: string;
     padding?: TabsMainPadding;
-    /** 精细化预留高度(px),从 viewportHeightFinal 中预扣(在 padding 扣减与 HeightProvider header reserve 扣减之外) */
     refineReduceHeight?: number;
 }
 declare function __VLS_template(): {

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

@@ -5,41 +5,5 @@ import { default as ActionBtn } from './ActionBtn.vue';
 import { default as ActionConfirm } from './ActionConfirm.vue';
 import { default as ActionBtnGroup } from './ActionBtnGroup.vue';
 import { default as BooleanTag } from './BooleanTag.vue';
-export { 
-/** 尺寸监听容器：debounce 测默认槽内容宽/高，`@height-change` / `@size-change` 上报 */
-WatchSize, 
-/**
- * Tab 容器：手写 tab-bar + 滑动下划线 + 懒渲染 KeepAlive。
- * 嵌套联动用 `channel="x"` / `parentChannel="x"` 字符串显式配对（[MUST NOT] 响应式）。
- */
-TabsMain, 
-/**
- * 纯数值高度预算节点：`available = max(viewportHeight - reserve, minHeight ?? 0)`，
- * 默认槽 `{ height }` 暴露。Fragment 双根，不撑开自身，不 inject 不 provide。
- * 消费方 [MUST] 用 slot scope `:height` 自设容器高。
- */
-HeightProvider, 
-/**
- * ElButton 超集按钮原语：透传全 ElButton props + 默认槽 label + `confirmConfig`
- * 确认闸门 + `beforeOpen` 异步预取 + onClick 返 Promise 自动 loading（内部接管）。
- */
-ActionBtn, 
-/**
- * confirm 原语（扁平，可独立于 ActionBtn 消费）：触发元素由默认 slot 提供，
- * 弹层可见性 `v-model:show` 声明式驱动；`submitFn` 返 Promise 时仅成功才关弹层。
- */
-ActionConfirm, 
-/**
- * 配置式按钮组（泛型 Ctx 由消费方决定形状）。
- * - 二选一渲染：`actionBtnProps`（走 ActionBtn 带 confirm/beforeOpen）优先 / `props`（走 ElButton）。
- * - `render` 对标 FormItem.render 三态：string | Component | (props:{ctx})=>VNode。
- * - `show` 函数过滤；`defaultSize` 给基础 size，业务侧显式 size 优先。
- * - 典型消费：TableMain.toolbar 内置 / 表格 OPERATE 列（BL-5 推广）。
- */
-ActionBtnGroup, 
-/**
- * boolean 只读展示为彩色标签（纯展示，无交互）：`value` → active/inactive 文本 + ElTag 色彩。
- * 编辑布尔用 ElSwitch；[MUST NOT] 给展示标签挂 onClick toggle 改数据（展示≠编辑，详见 paradigm §9）。
- */
-BooleanTag, };
+export { WatchSize, TabsMain, HeightProvider, ActionBtn, ActionConfirm, ActionBtnGroup, BooleanTag, };
 export * from './types';

package/types/components/display/types.d.ts

@@ -1,206 +1,75 @@
 import { Component, ComputedRef, VNode } from 'vue';
 import { ButtonProps, TagProps } from 'element-plus';
-/** ActionConfirm 确认交互形态：弹层气泡 / 居中模态框 */
 export type ActionConfirmMode = "popconfirm" | "messageConfirm";
-/**
- * ActionConfirm 文案解析器。
- * - string：直接渲染
- * - 无参函数：返回字符串或 VNode 数组（富文本）；动态数据由调用方闭包捕获
- */
 export type ActionConfirmTextResolver = string | (() => string | VNode[]);
-/**
- * ActionBtn 的确认配置（嵌套对象；无此配置则为普通按钮，不触发确认）。
- *
- * ⚠️ 瞬时用户激活限制：`confirmConfig` 与 `beforeOpen` 均会异步打断点击的瞬时
- * 用户激活窗口（transient user activation）——confirm 后 / beforeOpen 之后的
- * handler 与原始点击之间隔了一次异步等待，原始激活此时已过期（注意：事件对象
- * `isTrusted` 仍为 true，失效的是激活窗口而非事件本身）。故 confirm 后 /
- * beforeOpen 之后的 handler [MUST NOT] 调用依赖瞬时用户激活的 API——
- * `window.open`、`navigator.clipboard.*`、`requestFullscreen` 等会被浏览器
- * 拦截。需要这类操作时改用无 `confirmConfig` 且无 `beforeOpen` 的 ActionBtn /
- * 普通按钮。此为 confirm-gate / async-prefetch 模式固有代价，组件层无法绕过。
- */
 export interface ActionBtnConfirmConfig {
-    /** 确认标题 */
     title?: ActionConfirmTextResolver;
-    /** 确认正文内容 */
     content?: ActionConfirmTextResolver;
-    /** 确认按钮文案，默认"确定" */
     confirmText?: string;
-    /** 取消按钮文案，默认"取消" */
     cancelText?: string;
-    /** 确认按钮 type */
     type?: ButtonProps["type"];
 }
-/**
- * ActionBtn 组件 props。
- * 完全兼容 ElButton（继承 ButtonProps），仅一处改写 + 三个增量：
- * - `loading` 被 Omit：有意的 ElButton 不兼容，唯一接管项——loading 由组件内部
- *   独占，对接异步 confirm / beforeOpen 的进行态（innerLoading），对外不可设置。
- * - `disabled` 原生透传，不改写不扩展。
- * - 增量：`confirmMode` / `confirmConfig` / `beforeOpen`。
- * - 泛型 `T`：由 `beforeOpen` 返回值反推，并透传给 `confirmConfig` 函数形态的
- *   入参；未传 `beforeOpen` 时默认 `T = void`，函数形态的 `data = undefined`。
- */
 export type ActionBtnProps<T = void> = Omit<ButtonProps, "loading"> & {
-    /** 确认交互形态，仅在 confirmConfig 存在时生效，默认 "popconfirm" */
     confirmMode?: ActionConfirmMode;
-    /**
-     * 确认配置；存在时点击需经确认闸门，确认后才触发 click。
-     * - 对象形态：静态确认配置（向后兼容）。
-     * - 函数形态：`(data: T) => ActionBtnConfirmConfig`，`data` 来自 `beforeOpen`
-     *   返回值；无 `beforeOpen` 时 `data = undefined`（T 默认 `void`）。
-     */
     confirmConfig?: ActionBtnConfirmConfig | ((data: T) => ActionBtnConfirmConfig);
-    /**
-     * 点击后、弹层前的异步预取钩子。
-     * - 返回值类型 `T` 反推给 `confirmConfig` 函数形态的入参。
-     * - 失败时静默退出（不弹层、不触发 `@click` handler）；调用方 [MUST] 在内部
-     *   自行 catch 并显示反馈（如 `ElMessage.error`），忘记 catch 会"点了没反应"。
-     * - 期间按钮显 loading 态（`innerLoading`）；同 `confirmConfig` 一样消耗
-     *   瞬时用户激活（详见 {@link ActionBtnConfirmConfig} 顶部注释）。
-     */
     beforeOpen?: () => Promise<T>;
 };
-/**
- * ActionConfirm 组件 props（扁平，confirm 原语；可独立于 ActionBtn 消费）。
- * 触发元素由默认 slot 提供；弹层可见性由 `v-model:show` 声明式驱动。
- */
 export interface ActionConfirmProps {
-    /** 确认交互形态 */
     mode: ActionConfirmMode;
-    /** 确认标题 */
     title?: ActionConfirmTextResolver;
-    /** 确认正文内容 */
     content?: ActionConfirmTextResolver;
-    /** 确认按钮文案，默认"确定" */
     confirmText?: string;
-    /** 取消按钮文案，默认"取消" */
     cancelText?: string;
-    /** 确认按钮 type */
     type?: ButtonProps["type"];
-    /**
-     * 点击确认后调用。返回 Promise 时确认按钮 loading + 弹层保持不关，
-     * **仅成功（fulfill）才关闭弹层**；失败（reject 或同步 throw）时清 loading、
-     * 弹层保持打开，错误由 `submitFn` 内部自行 catch 反馈。
-     */
     submitFn: () => void | Promise<void>;
 }
-/** ActionBtnGroup 按钮 size 枚举(对齐 element-plus ElButton size) */
 export type ActionBtnSize = "large" | "default" | "small";
-/**
- * ActionBtnGroup 单项配置
- * ---
- * 泛型 Ctx 由消费方决定形状(toolbar 传 ToolbarButtonContext / 表格 OPERATE 列传 row 上下文 / 等)。
- * 与 FormItem.render 三态对标:string(全局组件名)/ Component(对象/异步)/ functional((props) => VNode)。
- */
 export interface ActionBtnConfigItem<Ctx = void> {
-    /** 唯一标识 */
     key: string;
-    /** ActionBtn props 工厂(含 confirmConfig / beforeOpen / ElButton 全透传),与 props 二选一优先 */
     actionBtnProps?: (ctx: Ctx) => Record<string, any>;
-    /** ElButton props 工厂,与 actionBtnProps 二选一 */
     props?: (ctx: Ctx) => Record<string, any>;
-    /** 按钮文字;render 缺省时回退 */
     label?: string;
-    /**
-     * 按钮内容 render(对标 FormItem.render 三态);优先级高于 label。
-     * - string:全局注册组件名
-     * - Component:对象/异步组件
-     * - functional:`(props: { ctx }) => VNode`——通过 `:ctx` prop 拿到上下文
-     */
     render?: string | Component | ((props: {
         ctx: Ctx;
     }) => VNode);
-    /** 显示条件,返回 false 跳过该项;缺省视为 true */
     show?: (ctx: Ctx) => boolean;
 }
-/** ActionBtnGroup props */
 export interface ActionBtnGroupProps<Ctx = void> {
-    /** 按钮配置列表 */
     configs?: ActionBtnConfigItem<Ctx>[];
-    /** 渲染上下文(透传给每项 actionBtnProps / props / render / show) */
     ctx: Ctx;
-    /**
-     * 默认按钮 size——未传时不强加 size(沿用 ElButton 自身默认);
-     * 传入时作为基础 size 注入每项,业务侧 actionBtnProps / props 返回对象内显式 size 优先。
-     */
     defaultSize?: ActionBtnSize;
 }
-/** HeightProvider props——见组件 JSDoc */
 export interface HeightProviderProps {
-    /** px，视口可用高度（必填） */
     viewportHeight: number;
-    /** px，默认槽可用高度兜底下限；超 viewportHeight 时会撑破父容器（有意设计） */
     minHeight?: number;
 }
-/** TabsMain 单个 tab 项配置 */
 export interface TabsMainItem {
-    /** 唯一标识，v-model 值与槽名（#{key} / #header-{key}）以此为准 */
     key: string;
-    /** 标题文本，#header-{key} 槽缺省时回退 */
     title: string;
-    /** 内容组件，#{key} 槽缺省时回退渲染 */
     component?: Component;
 }
-/** tabs 族跨节点高度联动 channel 的 inject payload */
 export interface TabsChannelPayload {
-    /** 下一级 TabsMain 可消费的视口高度（响应式） */
     viewportHeight: ComputedRef<number>;
-    /** 下一级嵌套深度（非响应式），顶层 = 1，每嵌套 +1；本期预埋不消费 */
     level: number;
 }
-/** [top, right, bottom, left] px——TabsMain 默认插槽容器内置 padding（top+bottom 同步从 channel viewportHeight 扣减） */
 export type TabsMainPadding = [number, number, number, number];
-/**
- * TabsHeader 视觉风格变体(与 level 字号解耦)。
- * - card:浏览器 tabs 风格(active 三面 border + 两侧 100vw separator,真打通)
- * - indicator:标准 2px 下划线
- * - indicator-compact:紧凑 1px 下划线
- * - plain:无装饰(active 加粗 + primary 字色)
- */
 export type TabsHeaderVariant = "card" | "indicator" | "indicator-compact" | "plain";
-/**
- * TabsMain props。
- *
- * 高度优先级：parentChannel inject > viewportHeight > inject `BODY_CONTENT_VIEWPORT_HEIGHT` > 0。
- * channel / parentChannel [MUST NOT] 响应式变更（setup 期快照，变更 console.error 忽略）。
- */
 export interface TabsMainProps {
-    /** tab 配置列表 */
     tabs: TabsMainItem[];
-    /** px，视口可用高度；未传时降级 BODY_CONTENT_VIEWPORT_HEIGHT 老链 */
     viewportHeight?: number;
-    /** px，默认内容区高度兜底下限 */
     minHeight?: number;
-    /** 作为父时的通道标识（字符串，内部 Symbol.for 跨包共享键） */
     channel?: string;
-    /** 作为子时要消费的父通道标识 */
     parentChannel?: string;
-    /** 默认插槽容器内置 padding [top,right,bottom,left]，默认 [10,0,0,0]；top+bottom 同步从 slot scope/channel viewportHeight 扣减 */
     padding?: TabsMainPadding;
-    /** 精细化布局:false(默认) 不包 HeightProvider,默认槽 viewportHeight 直接给 viewportHeightFinal(不扣减),业务自然流;true 走 HeightProvider 精确扣 header reserve + padding 给 available */
     refine?: boolean;
-    /** 精细化预留高度(px),从 viewportHeightFinal 中预扣,refine=false 时同样生效 */
     refineReduceHeight?: number;
-    /** 显式指定 TabsHeader 视觉风格,不传则按 visualLevel 推导默认(L1=card / L2=indicator / L3=indicator-compact / L4=plain)。字号始终跟随 level,不受 variant 影响。 */
     variant?: TabsHeaderVariant;
 }
-/** BooleanTag 标签色彩类型（派生 ElTag type，不重定义） */
 export type BooleanTagType = NonNullable<TagProps["type"]>;
-/**
- * BooleanTag props——boolean 只读展示为彩色标签（纯展示，无交互 / 无 v-model）。
- * enum / number 状态在调用点一行映射为 boolean 传入（组件保持 boolean 纯粹）。
- */
 export interface BooleanTagProps {
-    /** 待展示布尔值 */
     value: boolean;
-    /** true 时标签文本，默认「是」 */
     activeText?: string;
-    /** false 时标签文本，默认「否」 */
     inactiveText?: string;
-    /** true 时标签色彩（派生 ElTag type），默认 success */
     activeTagType?: BooleanTagType;
-    /** false 时标签色彩，默认 info */
     inactiveTagType?: BooleanTagType;
 }

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

@@ -1,17 +1,12 @@
 import { FormItemConfigList } from './types';
 import { ColProps } from 'element-plus';
 type __VLS_Props = {
-    /** 所属父 item key（注册到父 FormMain exposeMap 的索引） */
     nestKey: string;
-    /** 子表单配置列表 */
     list: FormItemConfigList;
     layout?: Partial<ColProps>;
     rowGutter?: number;
-    /** 联结组件外环阴影颜色；缺省走 CSS 变量主题自适配（亮/暗），仅显式传时内联覆盖 */
     shadowColor?: string;
-    /** 父 item 代表 span（P3 rebase 算因子用；helper 经 resolveLayoutSpan(layout) 传入） */
     parentSpan?: number;
-    /** 是否叠本层嵌套布局 rebase（缺省 true；false = 逆向逃生口，layout 原样直透） */
     rebase?: boolean;
 };
 type __VLS_PublicProps = {

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

@@ -8,46 +8,29 @@ declare const _default: <T extends Record<string, any>>(__VLS_props: NonNullable
     } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onUpdate:modelValue"> & ({
         modelValue?: T[];
     } & {
-        /** 所属父 item key（注册到父 FormMain exposeMap 的索引） */
         nestKey: string;
-        /** 每行子表单配置列表 */
         list: FormItemConfigList;
-        /** 行稳定标识字段（指向 T 内稳定 id）；缺省走内部自增 rowId */
         rowKey?: string;
-        /** 新增行工厂；缺省 generateFormData(list) 产子默认对象 */
         itemFactory?: () => T;
-        /** 最少行数（删到 min 禁删；硬约束走父 item rules 长度校验） */
         min?: number;
-        /** 最多行数（达上限禁新增；硬约束走父 item rules 长度校验） */
         max?: number;
         layout?: Partial<ColProps>;
         rowGutter?: number;
         addText?: string;
         removeText?: string;
-        /** 顶部自定义渲染（render-fn prop，替代 template slot；label 由父 FormItem 渲染） */
         headerRender?: (scope: {
             count: number;
             max: number;
         }) => VNodeChild;
-        /** 底部自定义渲染；缺省 = 内置「新增」按钮 */
         footerRender?: (scope: {
             count: number;
             max: number;
             canAdd: boolean;
             add: () => void;
         }) => VNodeChild;
-        /** 联结组件外环 + 每行分割阴影颜色 */
         shadowColor?: string;
-        /** 父 item 代表 span（P3 rebase 算因子用；helper 经 resolveLayoutSpan(layout) 传入） */
         parentSpan?: number;
-        /** 是否叠本层嵌套布局 rebase（缺省 true；false = 逆向逃生口，layout 原样直透） */
         rebase?: boolean;
-        /**
-         * 行删除二次确认（破坏性操作防误删）：
-         * - `true`（默认）→ 默认 popconfirm「确认删除该项？」（danger）
-         * - `false` → 不弹确认，直删（回旧行为）
-         * - 对象 → 自定义 ActionBtnConfirmConfig
-         */
         removeConfirm?: boolean | ActionBtnConfirmConfig;
     }) & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;