@done-coding/admin-core 0.12.1 → 0.12.2

package/types/components/table/types.d.ts

@@ -5,138 +5,53 @@ import { ExportColumnConfig } from '../../utils';
 import { ExtractPropTypes, VNode } from 'vue';
 import { ActionBtnConfigItem } from '../display';
 import { AutoRefreshGroupProps } from '../misc';
-/** 表格实例 */
 export type TableInstance = Pick<ElTableInstance, "clearSelection" | "getSelectionRows" | "toggleRowSelection" | "toggleAllSelection" | "toggleRowExpansion" | "setCurrentRow" | "clearSort" | "clearFilter" | "doLayout" | "sort" | "scrollTo" | "setScrollTop" | "setScrollLeft" | "columns" | "updateKeyChildren">;
-/** 表格分页信息 */
 export interface TablePageInfo {
-    /** 每页数量 */
     pageSize: number;
-    /** 当前页码 */
     currentPage: number;
-    /** 数据总数（总记录数，非页数） */
     total: number;
 }
-/**
- * 表格请求参数
- * ---
- * 静态参数 SQ + KEY_CONFIG 推导出的 page.page / page.pageSize 嵌套
- */
-export type TableApiParams<
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>> = BuildListParams<typeof APP_API_LIST_MODEL_KEY_CONFIG, SQ>;
-/**
- * 表格响应结果
- * ---
- * items 列表 + page.totalRecord 总数（仅 2 字段子集，不带 page.page / page.pageSize）
- */
+export type TableApiParams<SQ extends Record<string, any> = Record<string, any>> = BuildListParams<typeof APP_API_LIST_MODEL_KEY_CONFIG, SQ>;
 export type TableApiResult<T extends Record<string, any> = Record<string, any>> = UnionToIntersection<DotToObject<typeof APP_API_LIST_MODEL_KEY_CONFIG.LIST_KEY, T[]> | DotToObject<typeof APP_API_LIST_MODEL_KEY_CONFIG.TOTAL_KEY, number>>;
 export interface TableMainInstance {
-    /** 如果关心是否结束（无论成功还是失败 甚至都未发起请求（比如某些状态机未满足）），那么可以await, 等待刷新调用给个结束  */
     refresh: (silent?: boolean) => Promise<unknown>;
-    /** 如果关心是否结束（无论成功还是失败 甚至都未发起请求（比如某些状态机未满足）），那么可以await, 等待刷新调用给个结束  */
     reload: (slice?: boolean) => Promise<unknown>;
     getTableInstance: () => TableInstance | undefined;
 }
-/** 导出类型 */
 export type ExportType = "selected" | "current" | "all";
-/** TableMain 传给 toolbar 的导出上下文 */
-export interface TableExportContext<T extends Record<string, any> = Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> {
-    /** 可导出列 */
+export interface TableExportContext<T extends Record<string, any> = Record<string, any>, SQ extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> {
     columns: Pick<ElTableColumnProps<T, F>, "prop" | "label">[];
-    /** 选中行数据 */
     selectedList: T[];
-    /** 当前页数据 */
     currentPageList: T[];
-    /** 分页 API */
     api: (params: TableApiParams<SQ>) => Promise<TableApiResult<T>>;
-    /** 静态查询参数 */
     query?: SQ;
-    /** 当前数据总数 */
     total: number;
-    /** 是否包含 selection 列 */
     hasSelection: boolean;
 }
-/** toolbar 按钮渲染上下文 */
-export interface ToolbarButtonContext<T extends Record<string, any> = Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> {
-    /** TableMain expose */
+export interface ToolbarButtonContext<T extends Record<string, any> = Record<string, any>, SQ extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> {
     tableExpose: TableMainInstance;
-    /** 表格是否加载中 */
     loading: boolean;
-    /** 导出上下文 */
     exportContext: TableExportContext<T, SQ, F>;
-    /** 当前选中行数据 */
     selectedList: T[];
-    /** 分页信息 */
     pagination: TablePageInfo;
 }
-/**
- * toolbar 额外按钮配置（BL-4 / 2026-05-26 重定义为 ActionBtnConfigItem 别名）
- * ---
- * 跨族迁移到 display/ActionBtnGroup 后,本类型沦为通用配置的 toolbar 特化别名;
- * 字段集与 ActionBtnConfigItem 完全一致(key / actionBtnProps / props / label / render / show)。
- * 旧的 VNode[] 返回函数字段已移除,render 三态(string | Component | functional)
- * 对标 FormItem;升级路径见 MIGRATION.md BL-4 节。
- */
-export type ToolbarButtonConfig<T extends Record<string, any> = Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> = ActionBtnConfigItem<ToolbarButtonContext<T, SQ, F>>;
-/** toolbar (被TableMain) 内部提供的props */
-export interface TableToolbarPrivateProps<T extends Record<string, any> = Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> {
-    /** TableMain expose */
+export type ToolbarButtonConfig<T extends Record<string, any> = Record<string, any>, SQ extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> = ActionBtnConfigItem<ToolbarButtonContext<T, SQ, F>>;
+export interface TableToolbarPrivateProps<T extends Record<string, any> = Record<string, any>, SQ extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> {
     tableExpose: TableMainInstance;
-    /** 表格是否加载中 */
     loading: boolean;
-    /** 导出上下文 */
     exportContext: TableExportContext<T, SQ, F>;
-    /** 当前页码 */
     currentPage: number;
-    /** 每页行数 */
     pageSize: number;
-    /** 是否显示切换视图按钮，默认 false */
     showSwitchView?: boolean;
 }
-/** toolbar props */
-export interface TableToolbarProps<T extends Record<string, any> = Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> extends TableToolbarPrivateProps<T, SQ, F>, Pick<AutoRefreshGroupProps, "showRefresh" | "showAutoRefresh"> {
-    /**
-     * 是否由前端导出，默认 true。
-     * - true：toolbar 内部调 fetchListAll + exportCSV 完成导出
-     * - false：走 exportFn 回调
-     */
+export interface TableToolbarProps<T extends Record<string, any> = Record<string, any>, SQ extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> extends TableToolbarPrivateProps<T, SQ, F>, Pick<AutoRefreshGroupProps, "showRefresh" | "showAutoRefresh"> {
     exportByFe?: boolean;
-    /** 导出方法。传入导出类型，返回 Promise。exportByFe 为 false 时必传 */
     exportFn?: (type: ExportType) => Promise<unknown>;
-    /** 导出列配置。不传则不显示导出按钮。支持 valueMap 自定义取值 */
     exportColumns?: ExportColumnConfig<T>[];
-    /** 左侧额外按钮 */
     leftExtraButtons?: ToolbarButtonConfig<T, SQ, F>[];
-    /** 右侧额外按钮 */
     rightExtraButtons?: ToolbarButtonConfig<T, SQ, F>[];
 }
-/** toolbar 可配置项（通过 TableMain 的 toolbar prop 传入） */
-export type TableToolbarConfig<T extends Record<string, any> = Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> = Omit<TableToolbarProps<T, SQ, F>, keyof TableToolbarPrivateProps<T, SQ, F>>;
-/** 表格列默认作用域 */
+export type TableToolbarConfig<T extends Record<string, any> = Record<string, any>, SQ extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> = Omit<TableToolbarProps<T, SQ, F>, keyof TableToolbarPrivateProps<T, SQ, F>>;
 export interface TableColumnDefaultScope<T extends Record<string, any>, F extends Record<string, any>> {
     row: T;
     column: ElTableColumnProps<T, F>;
@@ -144,11 +59,9 @@ export interface TableColumnDefaultScope<T extends Record<string, any>, F extend
     injectInfo: F;
     exposeInfo: TableMainInstance;
 }
-/** 表格列组件props[$开头的属性vue报错] */
 export type TableColumnComponentProps<T extends Record<string, any>, F extends Record<string, any>> = Omit<TableColumnDefaultScope<T, F>, "$index"> & {
     _index: TableColumnDefaultScope<T, F>["$index"];
 };
-/** 表格列header作用域 */
 export interface TableColumnHeaderScope<T extends Record<string, any>, F extends Record<string, any>> {
     column: ElTableColumnProps<T, F>;
     $index: number;
@@ -156,9 +69,7 @@ export interface TableColumnHeaderScope<T extends Record<string, any>, F extends
     exposeInfo: TableMainInstance;
 }
 export type ExtractElTableColumnProps = ExtractPropTypes<typeof ETC>;
-export type ElTableColumnProps<T extends Record<string, any> = Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any> = {}> = Omit<ExtractPropTypes<typeof ETC>, "prop" | "columnKey" | "type"> & Partial<{
+export type ElTableColumnProps<T extends Record<string, any> = Record<string, any>, F extends Record<string, any> = {}> = Omit<ExtractPropTypes<typeof ETC>, "prop" | "columnKey" | "type"> & Partial<{
     prop: Exclude<Extract<keyof T, string>, "custom-view-item" | "item"> | `${Uppercase<string>}`;
     columnKey: ElTableColumnProps<T, F>["prop"];
     type: "default" | "selection" | "index" | "expand";
@@ -166,54 +77,28 @@ F extends Record<string, any> = {}> = Omit<ExtractPropTypes<typeof ETC>, "prop"
     align: "left" | "center" | "right";
     headerAlign: "left" | "center" | "right";
     filterPlacement: "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end";
-    /** 插槽render */
     render: string | Record<string, any> | ((props: TableColumnComponentProps<T, F>) => VNode);
-    /** 表头插槽render */
     headerRender: string | Record<string, any> | ((props: TableColumnHeaderScope<T, F>) => VNode);
 }>;
-export interface TableMainProps<
-/** 行数据结构 */
-T extends Record<string, any>, 
-/** 静态参数 */
-SQ extends Record<string, any>, 
-/** 期望注入到表格列插槽上的额外内容 */
-F extends Record<string, any>> {
-    /** 展示分页器 */
+export interface TableMainProps<T extends Record<string, any>, SQ extends Record<string, any>, F extends Record<string, any>> {
     showPager?: boolean;
-    /** 是否显示切换视图按钮，默认 false */
     showSwitchView?: boolean;
-    /** 是否显示 toolbar（顶层开关，默认 true，优先级高于 toolbar.leftFeatures / rightFeatures） */
     showToolbar?: boolean;
-    /** toolbar 配置 */
     toolbar?: TableToolbarConfig<T, SQ, F>;
-    /** 参数 */
     query?: SQ;
-    /** 每页条数 */
     pageSizeInit?: number;
     pageSizeOptions?: number[];
     pageLayout?: string;
     rowKey: Extract<keyof T, string> | ((row: T) => string);
-    /** 请求api */
     api: (params: TableApiParams<SQ>) => Promise<TableApiResult<T>>;
     tableProps?: Omit<TableProps<T>, "data" | "maxHeight" | "rowKey"> & Record<`on${Capitalize<string>}`, (...args: any[]) => any>;
     columns: ElTableColumnProps<T, F>[];
-    /** 最大高度 */
     maxHeight?: number;
-    /** @deprecated 表头背景色
-     * ----
-     * 外部通过 --el-table-header-bg-color 自行设置 或者 通过同意修改主题色
-     */
     headerColor?: string;
-    /** 精细化布局 */
     refine?: boolean;
-    /** 精细化预留高度 */
     refineReduceHeight?: number;
-    /** 给插槽注入的方法 */
     injectInfo?: F;
-    /** 数据视口最大高度最小值 */
     dataViewMaxHeightMinValue?: number;
-    /** 视口可用高度(优先级高于 BODY_CONTENT_VIEWPORT_HEIGHT 老链 inject,低于 parentChannel inject);未传时回退 inject 链 + fallback 500 */
     viewportHeight?: number;
-    /** 父级 tabs 族 channel 标识(setup 期 Symbol.for 快照,变更 console.error 忽略);命中后高度从父级 inject 取,优先级最高 */
     parentChannel?: string;
 }

package/types/config/list-model.d.ts

@@ -1,49 +1,20 @@
 import { DotToObject, UnionToIntersection } from '../types';
-/**
- * 列表 KEY 配置接口
- * ---
- * 约束消费方传入的 KEY_CONFIG 对象 shape，后续 BuildListModel / BuildListParams 工具基于本接口推导
- */
 export interface ListModelKeyConfig {
     PAGE_SIZE_KEY: string;
     CURRENT_PAGE_KEY: string;
     TOTAL_KEY: string;
     LIST_KEY: string;
 }
-/**
- * 基于 KEY_CONFIG 联合推导完整列表响应模型
- * ---
- * @example
- *   BuildListModel<typeof APP_API_LIST_MODEL_KEY_CONFIG, User>
- *     -> { items: User[]; page: { page: number; pageSize: number; totalRecord: number } }
- */
 export type BuildListModel<KC extends ListModelKeyConfig, T> = UnionToIntersection<DotToObject<KC["LIST_KEY"], T[]> | DotToObject<KC["TOTAL_KEY"], number> | DotToObject<KC["CURRENT_PAGE_KEY"], number> | DotToObject<KC["PAGE_SIZE_KEY"], number>>;
-/**
- * 基于 KEY_CONFIG 联合推导列表请求参数模型
- * ---
- * @example
- *   BuildListParams<typeof APP_API_LIST_MODEL_KEY_CONFIG, { keyword?: string }>
- *     -> { keyword?: string } & { page: { page: number; pageSize: number } }
- */
 export type BuildListParams<KC extends ListModelKeyConfig, P extends Record<string, any> = Record<string, any>> = P & UnionToIntersection<DotToObject<KC["CURRENT_PAGE_KEY"], number> | DotToObject<KC["PAGE_SIZE_KEY"], number>>;
-/** 应用接口列表模型配置（core 单一来源） */
 export declare const APP_API_LIST_MODEL_KEY_CONFIG: Readonly<{
-    /** 当前页码 key */
     CURRENT_PAGE_KEY: "page.page";
-    /** 每页条数 key */
     PAGE_SIZE_KEY: "page.pageSize";
-    /** 总数 key */
     TOTAL_KEY: "page.totalRecord";
-    /** 数据列表 key */
     LIST_KEY: "items";
 }>;
-/** 应用接口列表模型 */
 export type AppApiListModel<T = any> = BuildListModel<typeof APP_API_LIST_MODEL_KEY_CONFIG, T>;
-/** 应用接口列表分页参数 key */
 export type AppApiListPageParamsKey = typeof APP_API_LIST_MODEL_KEY_CONFIG.PAGE_SIZE_KEY | typeof APP_API_LIST_MODEL_KEY_CONFIG.CURRENT_PAGE_KEY;
-/** 应用接口列表 排除分页参数的 key */
 export type AppApiListNoPageParamsKey = Exclude<string, AppApiListPageParamsKey>;
-/** 应用接口列表请求参数模型 */
 export type AppApiListParamsModel<P extends Record<AppApiListNoPageParamsKey, any> = Record<AppApiListNoPageParamsKey, any>> = BuildListParams<typeof APP_API_LIST_MODEL_KEY_CONFIG, Partial<P>>;
-/** 应用接口列表请求参数模型（排除分页参数） */
 export type AppApiListParamsNoPageParams<P extends BuildListParams<typeof APP_API_LIST_MODEL_KEY_CONFIG>> = Omit<AppApiListParamsModel<P>, keyof UnionToIntersection<DotToObject<(typeof APP_API_LIST_MODEL_KEY_CONFIG)["CURRENT_PAGE_KEY"], number> | DotToObject<(typeof APP_API_LIST_MODEL_KEY_CONFIG)["PAGE_SIZE_KEY"], number>>>;

package/types/config/route.d.ts

@@ -1,4 +1,2 @@
-/** 模块级别的路由 */
 export declare const ROUTE_MODULE_LEVEL = 1;
-/** TabsMain replaceQuery 同步到路由时的 query key */
 export declare const TabsMainReplaceQueryKey = "_tab";

package/types/helpers/form.d.ts

@@ -1,10 +1,5 @@
 import { FormItemRule } from 'element-plus';
-/**
- * 密码规则
- */
 export declare const passwordRule: FormItemRule;
 export declare const getConfirmPasswordRule: (getPassword: () => string) => FormItemRule;
-/** 选择框全选值 */
 export declare const FORM_CONFIG_SELECT_ALL_VALUE: string;
-/** 设置表单组件类型 */
 export declare const setFormComponentType: () => void;

package/types/helpers/list-helper.d.ts

@@ -1,35 +1,9 @@
 import { TableApiParams, TableApiResult } from '../components/table/types';
 export interface FetchListAllOptions {
-    /** 单页大小,默认 200,范围 [1, 1000] */
     pageSize?: number;
-    /** 累计抓取上限,默认 10000;totalRecord > limit 则 throw */
     limit?: number;
 }
-/**
- * 全量翻页拉取(串行,提前终止)
- * ---
- * @param api  原始分页 api 函数(签名同 TableMain :api prop)
- * @param baseParams 业务侧固定参数,会透传到每页 api 调用(不被改写)
- * @param opts pageSize / limit 覆盖
- * @returns 全量 items 数组
- *
- * 行为:
- * - totalRecord = 0 → 直接 [] 返回(仅调 1 次)
- * - 单页 items.length < pageSize → 视为末页提前终止
- * - 任一页 reject → 整体 reject 透传原错误
- * - totalRecord > limit → throw 兜底
- */
 export declare function fetchListAll<T extends Record<string, any>, P extends Record<string, any> = {}>(api: (params: TableApiParams<P>) => Promise<TableApiResult<T>>, baseParams?: P, opts?: FetchListAllOptions): Promise<T[]>;
 export type ListApiSource<T> = T[] | (() => T[]) | (() => Promise<T[]>);
-/**
- * 用本地数组 / 同步函数 / 异步函数生成符合 TableMain :api prop 签名的 api
- * ---
- * 内部识别 source 类型 + 分页切片;无缓存,每次调用 source 重新求值
- */
 export declare function createListApi<T extends Record<string, any>>(source: ListApiSource<T>): (params: TableApiParams<{}>) => Promise<TableApiResult<T>>;
-/**
- * countAll: 仅探测列表总记录数,不拉数据。
- * 1 次 api 调用 page=1/pageSize=1,返回 totalRecord。
- * 用于"探测是否有数据 / 数据计数 / 存在性判断"等场景,替代手工 pageSize: 9999 hack。
- */
 export declare function countAll<P extends Record<string, any> = {}>(api: (params: TableApiParams<P>) => Promise<TableApiResult<any>>, baseParams?: P): Promise<number>;

package/types/helpers/types.d.ts

@@ -1,15 +1,4 @@
-/**
- * 深度递归 Partial(函数类型保持不变,object 类型字段递归可选)
- * ---
- * 应用场景:SDK 请求参数嵌套结构的可选化(如 PagingInput)
- */
 export type DeepPartial<T> = T extends (...args: any[]) => any ? T : T extends object ? {
     [K in keyof T]?: DeepPartial<T[K]>;
 } : T;
-/**
- * 分页请求参数的可选包装
- * ---
- * 与 SDK 1.1.40 嵌套契约耦合:业务侧手包 list api wrapper 时
- * 常以 PagingInput<RawApiParams> 作为入参类型,兜底字段缺失
- */
 export type PagingInput<T> = DeepPartial<T>;

package/types/hooks/activated.d.ts

@@ -1,9 +1,7 @@
-/** 激活信息 */
 export interface ActivatedInfo {
     isActivated: boolean;
     triggerType: "mounted" | "activated" | "deactivated" | "unmounted";
 }
-/** 是否激活 */
 export declare const useActivated: (watchFn?: (info: ActivatedInfo) => void) => {
     isActivated: import('vue').ComputedRef<boolean>;
     activatedInfo: import('vue').ComputedRef<{
@@ -11,13 +9,5 @@ export declare const useActivated: (watchFn?: (info: ActivatedInfo) => void) =>
         readonly triggerType: "mounted" | "activated" | "deactivated" | "unmounted";
     }>;
 };
-/**
- * @deprecated 请使用 useActivated 替代
- * @example useActivated((info) => { info.isActivated && callback(info) })
- * 激活时执行时间 */
 export declare const useActivatedExec: (callback: (info: ActivatedInfo) => void) => void;
-/**
- * @deprecated 请使用 useActivated 替代
- * @example useActivated((info) => { info.isActivated ? bind(info) : unbind(info) })
- * 激活时监听事件 */
 export declare const useActivatedEvent: (bind: (info: ActivatedInfo) => void, unbind: (info: ActivatedInfo) => void) => void;

package/types/hooks/feel-size.d.ts

@@ -1,8 +1,6 @@
-/** 感知元素尺寸变化 */
 export declare const useFeelSize: () => {
     unwatchDom: () => void;
     watchDom: (dom: HTMLElement) => void;
-    /** 元素尺寸信息只读属性 */
     sizeInfo: import('vue').ComputedRef<{
         width: number;
         height: number;

package/types/hooks/index.d.ts

@@ -4,5 +4,5 @@ export * from './feel-size';
 export * from './menus-dispatch';
 export * from './timeout';
 export * from './use-channel-viewport-height';
-export * from './use-admin-theme-apply';
-export * from './use-admin-viewport-apply';
+export * from './use-theme-apply';
+export * from './use-viewport-apply';

package/types/hooks/menus-dispatch.d.ts

@@ -1,11 +1,7 @@
 import { RouteMetaResolveRaw } from '../types';
-/** 应用菜单数据分发 */
 export declare const useMenusDataDispatch: ({ getMenus, getMenuFlatList, getExtractLevel1ToHeader, }: {
-    /** 菜单树 */
     getMenus: () => RouteMetaResolveRaw[];
-    /** 扁平化菜单列表 */
     getMenuFlatList: () => RouteMetaResolveRaw[];
-    /** 判断是否提取1级路由模块到HEADER */
     getExtractLevel1ToHeader: () => boolean;
 }) => {
     sidebarMenus: import('vue').ComputedRef<RouteMetaResolveRaw[]>;

package/types/hooks/timeout.d.ts

@@ -1,7 +1,3 @@
 export type ClearTimer = () => void;
 export type SetTimer = (handler: () => void, timeout: number) => void;
-/**
- * 使用定时器
- * @param autoClear 是否在生命周期结束前自动清除定时器
- */
 export declare const useTimeout: (autoClear?: boolean) => [SetTimer, ClearTimer];

package/types/hooks/use-channel-viewport-height.d.ts

@@ -1,27 +1,13 @@
 import { ComputedRef } from 'vue';
-/** useChannelViewportHeight 第二参数 options */
 export interface UseChannelViewportHeightOptions {
-    /** body inject 未命中时的最终兜底,默认 0 */
     fallback?: number;
 }
-/** useChannelViewportHeight 入参对象形状(约定 reactive,props 即满足) */
 export interface UseChannelViewportHeightMaybeProps {
-    /** props.viewportHeight,优先级位于 parentChannel inject 之下、body inject 之上 */
     viewportHeight?: number;
-    /** tabs 族 channel 父级标识——setup 期 Symbol.for 快照,变更 console.error 忽略 */
     parentChannel?: string;
 }
-/** useChannelViewportHeight 返回值 */
 export interface UseChannelViewportHeightReturn {
-    /** 最终视口高度,链路 parentChannel > viewportHeight > body inject > fallback */
     viewportHeightFinal: ComputedRef<number>;
-    /** parent inject 命中时取 payload.level,否则 0;调用方算 childLevel = parentLevel + 1 */
     parentLevel: ComputedRef<number>;
 }
-/**
- * tabs 族 channel 视口高度解析 hook。
- * 链路:parentChannel inject > maybeProps.viewportHeight > body inject > options.fallback。
- * `parentChannel` setup 期 Symbol.for 快照,变更 console.error 忽略(非响应式)。
- * 入参 maybeProps 约定 reactive 对象(props 即满足);返回 viewportHeightFinal/parentLevel 均为 computed。
- */
 export declare const useChannelViewportHeight: (maybeProps: UseChannelViewportHeightMaybeProps, options?: UseChannelViewportHeightOptions) => UseChannelViewportHeightReturn;

package/types/hooks/use-theme-apply.d.ts

@@ -0,0 +1,11 @@
+import { DeepReadonly } from 'vue';
+import { AppThemeConfig, CoreThemeDensity, CoreThemeMotion } from '../bridge';
+export declare function buildRhythmCss(density: CoreThemeDensity, motion: CoreThemeMotion): string;
+export interface UseThemeApplyOptions {
+    getThemeConfig: () => AppThemeConfig | DeepReadonly<AppThemeConfig>;
+    getThemeIsDark: () => boolean;
+    getThemeDensity?: () => CoreThemeDensity;
+    getThemeMotion?: () => CoreThemeMotion;
+    document?: Document;
+}
+export declare function useThemeApply(options: UseThemeApplyOptions): void;

package/types/hooks/use-viewport-apply.d.ts

@@ -0,0 +1,8 @@
+import { DeepReadonly } from 'vue';
+import { AppLayoutViewportConfig, AppLayoutGapConfig } from '../bridge';
+export interface UseViewportApplyOptions {
+    getViewportConfig: () => AppLayoutViewportConfig | DeepReadonly<AppLayoutViewportConfig>;
+    getGapConfig?: () => AppLayoutGapConfig | DeepReadonly<AppLayoutGapConfig>;
+    document?: Document;
+}
+export declare function useViewportApply(options: UseViewportApplyOptions): void;

package/types/inject/key.d.ts

@@ -1,99 +1,14 @@
 import { InjectionKey, Ref } from 'vue';
-import { AdminBridge } from '../bridge';
+import { CoreBridge } from '../bridge';
 import { ModalLevel, ShelfController } from '../components/modal';
 import { AppLayoutAppStoreSlice, AppLayoutUserStoreSlice, AppLayoutBridgeSlice } from '../components/app-layout';
 import { NestFormExposeMap } from '../components/form';
-/**
- * body 视口高度
- * ---
- * AppBody（留 app）通过 provide 写入；
- * TableMain / ListPage / Page1（核内或核外消费方）通过 inject 读取；
- * ---
- * 使用 `Symbol.for` 全局注册表保证跨包 / 跨 chunk / 跨 ESM 实例的 Symbol 唯一性。
- * `Symbol(key)` 每次调用产生新实例；vite chunk split 或多次模块 evaluate 可能
- * 产生多个 Symbol → inject/provide 失配 → 列表精细化高度计算塌陷至 fallback。
- */
 export declare const BODY_CONTENT_VIEWPORT_HEIGHT: unique symbol;
-/**
- * 弹窗架子 inject key 工厂——按 level 参数化。
- * Symbol.for 全局注册表保证跨包/跨 chunk/跨 ESM 实例唯一（同 BODY_CONTENT_VIEWPORT_HEIGHT）。
- */
 export declare function getModalShelfInjectionKey(level: ModalLevel): InjectionKey<ShelfController>;
-/**
- * TabsMain 视觉嵌套层级 inject key（独立于 channel payload.level）。
- * ---
- * 与 channel 体系完全解耦：
- * - channel level：高度预算用，父未配 channel 时子 selfLevel=1（看是否 inject 命中）
- * - 视觉 level：物理嵌套深度，每层 TabsMain（含 refine=false）+1 → provide 给后代
- * ---
- * 用途：TabsHeader 据此应用层级化样式（L1 卡片 / L2 下划线 / L3 紧凑 / L4+ 仅文字加粗）。
- * setup 期一次性 provide number（不响应式）；Symbol.for 跨包/chunk/ESM 实例唯一（同上）。
- */
 export declare const TABS_MAIN_VISUAL_LEVEL: InjectionKey<number>;
-/**
- * AppLayout 族 app store 窄化消费契约 inject key。
- * ---
- * AppLayout（唯一 `useAppStore()` 调用方）provide；子组件
- * （AppBody / AppHeader / AppSidebar / AppFooter）inject 自取。
- * Symbol.for 保证跨包同一性（同 BODY_CONTENT_VIEWPORT_HEIGHT）。
- */
 export declare const APP_LAYOUT_APP_STORE_KEY: InjectionKey<AppLayoutAppStoreSlice>;
-/**
- * AppLayout 族 user store 窄化消费契约 inject key。
- * ---
- * AppLayout 集中 provide；AppHeader inject 自取（取 userInfo / isLogin / logout 等）。
- * Symbol.for 保证跨包同一性。
- */
 export declare const APP_LAYOUT_USER_STORE_KEY: InjectionKey<AppLayoutUserStoreSlice>;
-/**
- * AppLayout 族 admin bridge 窄化消费契约 inject key（#7.6 期挂载）。
- * ---
- * AppLayout 通过 `props.adminBridge` 接收注入后 provide；子组件
- * （AppBody/AppHeader/AppSidebar/AppLayout 内菜单派生）inject 自取 12 readonly
- * 配置属性 + getRoutes / generateRouteMetaRawTree 派生方法。
- * Symbol.for 保证跨包同一性（同 APP_LAYOUT_APP_STORE_KEY / APP_LAYOUT_USER_STORE_KEY）。
- */
 export declare const APP_LAYOUT_BRIDGE_KEY: InjectionKey<AppLayoutBridgeSlice>;
-/**
- * 整 admin bridge app 级注入 key（#插件系统一期挂载）。
- * ---
- * `bridge.install(app)`（即 `app.use(bridge)`）经 `app.provide(ADMIN_BRIDGE_KEY, bridge)`
- * 把**整个 bridge 实例**注入应用级 provide 链；任意后代组件经 `inject(ADMIN_BRIDGE_KEY)`
- * 取整 bridge（含 7 响应式只读配置视图 + `update` + 全部 auth/api/派生方法）。
- * ---
- * **opt-in**：仅当 app 显式 `app.use(bridge)` 时注入；未 use 则 `inject(ADMIN_BRIDGE_KEY)`
- * 返回 `undefined`（不报错）。
- * ---
- * **区别于 `APP_LAYOUT_BRIDGE_KEY`**：后者是 AppLayout 族**组件级**窄切片（`AppLayoutBridgeSlice`
- * Pick 子集，由 AppLayout 从 `props.adminBridge` 接收后 provide，供 layout 子组件 inject），
- * 两 KEY 各管各、并存——本 KEY 注入的是 app 级**整 bridge**，非 layout 窄切片。
- * ---
- * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（同 APP_LAYOUT_BRIDGE_KEY，规则 8）。
- */
-export declare const ADMIN_BRIDGE_KEY: InjectionKey<AdminBridge>;
-/**
- * 嵌套子 FormMain exposeMap inject key（配置化嵌套联结组件 Nest 三件套挂载）。
- * ---
- * 每个 FormMain `provide` 一份本 key 的空 exposeMap（shallowReactive，按 item key 索引），
- * 供其后代联结组件（FormItemNestForm）`inject` 到**最近祖先** FormMain 的 map 并把子
- * FormMain 的级联 expose 写入（key = 自身 item key）；FormMain 的 validate/clearValidate/
- * resetFields 遍历自身 map 级联子表单。
- * ---
- * provide/inject 链天然实现「只挂最近祖先」（inject 向上解析至最近 provide）。
- * 注册由联结组件显式触发（非裸嵌套 FormMain 自动注册）→ 旧用法零回归（additive）。
- * ---
- * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（规则 8，同上）。
- */
+export declare const CORE_BRIDGE_KEY: InjectionKey<CoreBridge>;
 export declare const FORM_NEST_REGISTRY_KEY: InjectionKey<NestFormExposeMap>;
-/**
- * 嵌套布局 rebase 累乘因子 inject key（P3 嵌套布局 rebase 挂载）。
- * ---
- * 每个 FormMain / PanelMain `provide` 自身 `layoutScale`（缺省 1）的响应式只读引用；
- * 其后代联结组件（FormItemNestForm / FormItemNestFormList / PanelItemNestPanel /
- * PanelItemNestForm）`inject` 到**最近祖先**的 scale，叠本层因子
- * `childScale = parentScale × (24 / parentItemSpan)` 后作 `layoutScale` 传子 Form/PanelMain。
- * ---
- * 顶级 FormMain/PanelMain 未嵌套时 provide 1 → 子层缺省行为不变（向后兼容）。
- * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（规则 8，同上）。
- */
 export declare const NEST_LAYOUT_SCALE_KEY: InjectionKey<Readonly<Ref<number>>>;

package/types/router/guard/index.d.ts

@@ -2,19 +2,6 @@ import { Router } from 'vue-router';
 import { checkLogin } from './login';
 import { checkPermission } from './permission';
 import { CreateGuardOptions } from './types';
-/**
- * 路由守卫工厂——给 router 装登录守卫 + 权限守卫 + document.title 写入。
- *
- * 1:1 镜像原 app `router/guard/index.ts` 行为：
- * - beforeEach: checkLogin → 跳 loginPath；checkPermission → 跳 noPermissionPath
- * - beforeResolve: document.title = to.meta.title
- *
- * @example
- *   createGuard(router, {
- *     bridge: appAdminBridge,
- *     useRoutePermission,
- *   });
- */
 export declare const createGuard: (router: Router, options: CreateGuardOptions) => void;
 export { checkLogin, checkPermission };
 export type { CreateGuardOptions, GuardBridgeSlice, GuardRoutePermissionStore, } from './types';

package/types/router/guard/login.d.ts

@@ -1,4 +1,3 @@
 import { RouteLocationNormalized } from 'vue-router';
 import { GuardRoutePermissionStore } from './types';
-/** 登录检测壳子——复用 store.checkNeedGoToLoginPage */
 export declare const checkLogin: (to: RouteLocationNormalized, store: GuardRoutePermissionStore) => Promise<boolean>;

package/types/router/guard/permission.d.ts

@@ -1,4 +1,3 @@
 import { RouteLocationNormalized } from 'vue-router';
 import { GuardRoutePermissionStore } from './types';
-/** 权限检测壳子——复用 store.checkNeedGoToAuthPage */
 export declare const checkPermission: (to: RouteLocationNormalized, store: GuardRoutePermissionStore) => Promise<boolean>;

package/types/router/guard/types.d.ts

@@ -1,13 +1,10 @@
 import { RouteLocationNormalized } from 'vue-router';
-import { AdminBridge } from '../../bridge';
-/** guard 仅依赖 bridge 的路径配置切片（Pick 表达 → 必 type alias，无法 interface） */
-export type GuardBridgeSlice = Pick<AdminBridge, "APP_ROUTER_PATHS_CONFIG">;
-/** guard 仅依赖 route-permission store 的 2 个 check 方法 */
+import { CoreBridge } from '../../bridge';
+export type GuardBridgeSlice = Pick<CoreBridge, "APP_ROUTER_PATHS_CONFIG">;
 export interface GuardRoutePermissionStore {
     checkNeedGoToLoginPage: (route: RouteLocationNormalized) => boolean;
     checkNeedGoToAuthPage: (route: Pick<RouteLocationNormalized, "path">) => boolean;
 }
-/** createGuard 入参 */
 export interface CreateGuardOptions {
     bridge: GuardBridgeSlice;
     useRoutePermission: () => GuardRoutePermissionStore;