@done-coding/admin-core 0.3.1-alpha.0 → 0.4.0

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

@@ -0,0 +1,27 @@
+import { Plugin } from 'vue';
+import { default as AppLayout } from './AppLayout.vue';
+import { default as AppHeader } from './AppHeader.vue';
+import { default as AppSidebar } from './AppSidebar.vue';
+import { default as AppBody } from './AppBody.vue';
+import { default as AppBreadcrumb } from './AppBreadcrumb.vue';
+import { default as AppFooter } from './AppFooter.vue';
+import { default as AppPage } from './AppPage.vue';
+
+export { 
+/** 应用根布局容器：props 注入 adminBridge / appStore / userStore，provide 给子 layout */
+AppLayout, 
+/** 应用头部布局：模块菜单 + 深色切换；#left / #right slot 给业务自渲染 */
+AppHeader, 
+/** 应用侧栏布局：菜单树 + 折叠按钮；#top / #bottom slot 给业务自渲染 */
+AppSidebar, 
+/** 应用主体布局：面包屑 + RouterView keepAlive；#footer slot */
+AppBody, 
+/** 应用面包屑（AppBody 内部消费，业务侧通常不直接使用） */
+AppBreadcrumb, 
+/** 应用底部布局 */
+AppFooter, 
+/** 业务页面容器：fullViewport 满视口 + ModalShelf page level */
+AppPage, };
+/** app-layout 子目录批量 install plugin（同 form/menu/display 子桶范式） */
+export declare const appLayoutInstall: Plugin;
+export * from './types';

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

@@ -0,0 +1,43 @@
+import { createAppStore, createUserStore } from '../../store';
+import { AdminBridge } from '../../bridge';
+
+/**
+ * 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_CONFIG" | "APP_ROUTER_META_DEFAULT_CONFIG" | "APP_ROUTER_CONFIG" | "APP_ROUTER_PATHS_CONFIG" | "APP_THEME_CONFIG" | "getRoutes" | "generateRouteMetaRawTree">;

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

@@ -0,0 +1,16 @@
+import { ActionBtnConfigItem, ActionBtnSize } from './types';
+
+declare const _default: <Ctx = void>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{} & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & {
+        configs?: ActionBtnConfigItem<Ctx>[];
+        ctx: Ctx;
+        defaultSize?: ActionBtnSize;
+    }, keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: ReturnType<() => {}>;
+    emit: typeof __VLS_emit;
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;

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

@@ -6,27 +6,27 @@ declare function __VLS_template(): Partial<Record<string, (_: {
 }) => any>>;
 declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
     activeKey: import('vue').PropType<string>;
-    level: {
-        type: globalThis.PropType<number>;
-        default: number;
-    };
     tabs: {
         type: globalThis.PropType<TabsMainItem[]>;
         required: true;
     };
+    level: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
     variant: {
         type: globalThis.PropType<TabsHeaderVariant>;
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
     activeKey: import('vue').PropType<string>;
-    level: {
-        type: globalThis.PropType<number>;
-        default: number;
-    };
     tabs: {
         type: globalThis.PropType<TabsMainItem[]>;
         required: true;
     };
+    level: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
     variant: {
         type: globalThis.PropType<TabsHeaderVariant>;
     };

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

@@ -2,6 +2,7 @@ import { Plugin } from 'vue';
 import { default as WatchSize } from './WatchSize.vue';
 import { default as TabsMain } from './TabsMain.vue';
 import { default as HeightProvider } from './HeightProvider.vue';
+import { default as ActionBtnGroup } from './ActionBtnGroup.vue';
 
 export { 
 /** 尺寸监听容器：debounce 测默认槽内容宽/高，`@height-change` / `@size-change` 上报 */
@@ -16,6 +17,14 @@ TabsMain,
  * 默认槽 `{ height }` 暴露。Fragment 双根，不撑开自身，不 inject 不 provide。
  * 消费方 [MUST] 用 slot scope `:height` 自设容器高。
  */
-HeightProvider, };
+HeightProvider, 
+/**
+ * 配置式按钮组（泛型 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, };
 export declare const displayInstall: Plugin;
 export * from './types';

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

@@ -1,5 +1,46 @@
-import { Component, ComputedRef } from 'vue';
+import { Component, ComputedRef, VNode } from 'vue';
 
+/** 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，视口可用高度（必填） */

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

@@ -1,26 +1,20 @@
-import { ActionBtnProps } from './types';
+import { ActionBtnConfirmConfig } from './types';
 
-declare function __VLS_template(): {
-    default?(_: {}): any;
+declare const _default: <T = void>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{
+        readonly onClick?: ((evt: MouseEvent) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & (Omit<import('element-plus').ButtonProps, "loading"> & {
+        confirmMode?: import('./types').ActionConfirmMode;
+        confirmConfig?: ActionBtnConfirmConfig | ((data: T) => ActionBtnConfirmConfig) | undefined;
+        beforeOpen?: (() => Promise<T>) | undefined;
+    }), keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: ReturnType<() => {
+        default?(_: {}): any;
+    }>;
+    emit: (evt: "click", evt: MouseEvent) => void;
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
 };
-declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<ActionBtnProps>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    click: (evt: MouseEvent) => void;
-}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<ActionBtnProps>>> & Readonly<{
-    onClick?: ((evt: MouseEvent) => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

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

@@ -1,39 +1,68 @@
-import { ActionConfirmProps } from './types';
+import { ActionConfirmTextResolver } from './types';
 
 declare function __VLS_template(): {
     default?(_: {}): any;
 };
-declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<ActionConfirmProps>, {
-    confirmText: string;
-    cancelText: string;
-}>>, {
-    run: () => Promise<boolean>;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<ActionConfirmProps>, {
-    confirmText: string;
-    cancelText: string;
-}>>> & Readonly<{}>, {
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
+    show: import('vue').PropType<boolean>;
+    type: {
+        type: globalThis.PropType<"" | "default" | "primary" | "success" | "warning" | "info" | "danger" | "text">;
+    };
+    title: {
+        type: globalThis.PropType<ActionConfirmTextResolver>;
+    };
+    content: {
+        type: globalThis.PropType<ActionConfirmTextResolver>;
+    };
+    cancelText: {
+        type: globalThis.PropType<string>;
+        default: string;
+    };
+    confirmText: {
+        type: globalThis.PropType<string>;
+        default: string;
+    };
+    mode: {
+        type: globalThis.PropType<import('./types').ActionConfirmMode>;
+        required: true;
+    };
+    submitFn: {
+        type: globalThis.PropType<() => void | Promise<void>>;
+        required: true;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
+    show: import('vue').PropType<boolean>;
+    type: {
+        type: globalThis.PropType<"" | "default" | "primary" | "success" | "warning" | "info" | "danger" | "text">;
+    };
+    title: {
+        type: globalThis.PropType<ActionConfirmTextResolver>;
+    };
+    content: {
+        type: globalThis.PropType<ActionConfirmTextResolver>;
+    };
+    cancelText: {
+        type: globalThis.PropType<string>;
+        default: string;
+    };
+    confirmText: {
+        type: globalThis.PropType<string>;
+        default: string;
+    };
+    mode: {
+        type: globalThis.PropType<import('./types').ActionConfirmMode>;
+        required: true;
+    };
+    submitFn: {
+        type: globalThis.PropType<() => void | Promise<void>>;
+        required: true;
+    };
+}>> & Readonly<{}>, {
     cancelText: string;
     confirmText: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
-type __VLS_WithDefaults<P, D> = {
-    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
-        default: D[K];
-    }> : P[K];
-};
-type __VLS_Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
 type __VLS_WithTemplateSlots<T, S> = T & {
     new (): {
         $slots: S;

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

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

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

@@ -6,9 +6,10 @@ import { default as ActionButtonDanger } from './ActionButtonDanger.vue';
 import { default as ActionButtonWarn } from './ActionButtonWarn.vue';
 import { default as ActionBtn } from './ActionBtn.vue';
 import { default as ActionConfirm } from './ActionConfirm.vue';
+import { default as SelectModule } from './SelectModule.vue';
 
 export * from './types';
-export { TriggerAutoImport, AutoRefresh, ActionBtn, ActionConfirm };
+export { TriggerAutoImport, AutoRefresh, ActionBtn, ActionConfirm, SelectModule, };
 /**
  * @deprecated 改用 {@link ActionBtn}——`ActionBtn` 通过 `confirmConfig` 一体化承载
  * loading 自动接管 + 同步/异步 confirm-gate（popconfirm / message-box 两种 mode），

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

@@ -12,13 +12,14 @@ export type ActionConfirmTextResolver = string | (() => string | VNode[]);
 /**
  * ActionBtn 的确认配置（嵌套对象；无此配置则为普通按钮，不触发确认）。
  *
- * ⚠️ 瞬时用户激活限制：配置本项后，点击与原始 `@click` handler 之间隔了一次
- * 异步确认。原始点击的瞬时用户激活（transient user activation）此时已过期
- * （注意：事件对象 `isTrusted` 仍为 true，失效的是激活窗口而非事件本身）。
- * 故 confirm 后的 handler [MUST NOT] 调用依赖用户激活的 API——`window.open`、
- * `navigator.clipboard.*`、`requestFullscreen` 等会被浏览器拦截。需要这类
- * 操作时改用不带 confirmConfig 的 ActionBtn / 普通按钮。此为 confirm-gate
- * 模式固有代价，组件层无法绕过。
+ * ⚠️ 瞬时用户激活限制：`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 {
     /** 确认标题 */
@@ -34,22 +35,37 @@ export interface ActionBtnConfirmConfig {
 }
 /**
  * ActionBtn 组件 props。
- * 完全兼容 ElButton（继承 ButtonProps），仅一处改写 + 两个增量：
+ * 完全兼容 ElButton（继承 ButtonProps），仅一处改写 + 三个增量：
  * - `loading` 被 Omit：有意的 ElButton 不兼容，唯一接管项——loading 由组件内部
- *   独占，对接异步 confirm 的进行态（innerLoading），对外不可设置。
+ *   独占，对接异步 confirm / beforeOpen 的进行态（innerLoading），对外不可设置。
  * - `disabled` 原生透传，不改写不扩展。
- * - 增量：`confirmMode` / `confirmConfig`。无 `ctx`、无泛型——动态数据由调用方
- *   在自身作用域闭包捕获，组件不做数据回环。
+ * - 增量：`confirmMode` / `confirmConfig` / `beforeOpen`。
+ * - 泛型 `T`：由 `beforeOpen` 返回值反推，并透传给 `confirmConfig` 函数形态的
+ *   入参；未传 `beforeOpen` 时默认 `T = void`，函数形态的 `data = undefined`。
  */
-export type ActionBtnProps = Omit<ButtonProps, "loading"> & {
+export type ActionBtnProps<T = void> = Omit<ButtonProps, "loading"> & {
     /** 确认交互形态，仅在 confirmConfig 存在时生效，默认 "popconfirm" */
     confirmMode?: ActionConfirmMode;
-    /** 确认配置；存在时点击需经确认闸门，确认后才触发 click */
-    confirmConfig?: ActionBtnConfirmConfig;
+    /**
+     * 确认配置；存在时点击需经确认闸门，确认后才触发 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 提供；确认流程经 defineExpose 的 `run()` 命令式驱动。
+ * 触发元素由默认 slot 提供；弹层可见性由 `v-model:show` 声明式驱动。
  */
 export interface ActionConfirmProps {
     /** 确认交互形态 */
@@ -65,16 +81,9 @@ export interface ActionConfirmProps {
     /** 确认按钮 type */
     type?: ButtonProps["type"];
     /**
-     * 被确认闸住的待执行动作。用户点确认后调用；返回 Promise 时弹层保持不关、
-     * 确认按钮 loading，直到 settle（成功或失败均结束）。
-     */
-    action: () => unknown | Promise<unknown>;
-}
-/** ActionConfirm 实例（defineExpose） */
-export interface ActionConfirmInstance {
-    /**
-     * 驱动一次确认流程。
-     * @returns 已确认并完成 action → true；用户取消 → false
+     * 点击确认后调用。返回 Promise 时确认按钮 loading + 弹层保持不关，
+     * **仅成功（fulfill）才关闭弹层**；失败（reject 或同步 throw）时清 loading、
+     * 弹层保持打开，错误由 `submitFn` 内部自行 catch 反馈。
      */
-    run: () => Promise<boolean>;
+    submitFn: () => void | Promise<void>;
 }

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

@@ -1,3 +1,5 @@
+import { ButtonProps } from 'element-plus';
+
 declare function __VLS_template(): {
     title?(_: {}): any;
     default?(_: {}): any;
@@ -28,6 +30,12 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
     closeOnClickModal?: boolean;
     /** 是否使用确认按钮loading */
     useLoading?: boolean;
+    /**
+     * 确认按钮 type（对齐 element-plus ElButton type）。
+     * 默认 'primary'；danger / warning / success / info 全枚举均支持,
+     * 与 ActionConfirm popconfirm 模式按钮颜色行为对齐。
+     */
+    type?: ButtonProps["type"];
 }>, {
     showClose: boolean;
     cancelText: string;
@@ -37,6 +45,7 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
     reverse: boolean;
     closeOnPressEscape: boolean;
     closeOnClickModal: boolean;
+    type: string;
 }>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:show": (value: boolean) => void;
 }, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
@@ -60,6 +69,12 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
     closeOnClickModal?: boolean;
     /** 是否使用确认按钮loading */
     useLoading?: boolean;
+    /**
+     * 确认按钮 type（对齐 element-plus ElButton type）。
+     * 默认 'primary'；danger / warning / success / info 全枚举均支持,
+     * 与 ActionConfirm popconfirm 模式按钮颜色行为对齐。
+     */
+    type?: ButtonProps["type"];
 }>, {
     showClose: boolean;
     cancelText: string;
@@ -69,15 +84,17 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
     reverse: boolean;
     closeOnPressEscape: boolean;
     closeOnClickModal: boolean;
+    type: string;
 }>>> & Readonly<{
     "onUpdate:show"?: ((value: boolean) => any) | undefined;
 }>, {
-    width: number | string;
-    reverse: boolean;
+    type: "" | "default" | "primary" | "success" | "warning" | "info" | "danger" | "text";
     showClose: boolean;
     cancelText: string | (() => VNode);
     confirmText: string | (() => VNode);
     hiddenCancel: boolean;
+    width: number | string;
+    reverse: boolean;
     closeOnPressEscape: boolean;
     closeOnClickModal: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

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

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

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

@@ -2,14 +2,14 @@ import { ExportType, TableExportContext, TableMainInstance } from './types';
 
 declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    pageSize: {
-        type: globalThis.PropType<number>;
-        required: true;
-    };
     loading: {
         type: globalThis.PropType<boolean>;
         required: true;
     };
+    pageSize: {
+        type: globalThis.PropType<number>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;
@@ -52,14 +52,14 @@ declare const _default: import('vue').DefineComponent<globalThis.ExtractPropType
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
     isAutoRefresh: import('vue').PropType<boolean>;
-    pageSize: {
-        type: globalThis.PropType<number>;
-        required: true;
-    };
     loading: {
         type: globalThis.PropType<boolean>;
         required: true;
     };
+    pageSize: {
+        type: globalThis.PropType<number>;
+        required: true;
+    };
     showRefresh: {
         type: globalThis.PropType<boolean>;
         default: boolean;

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

@@ -3,6 +3,7 @@ import { APP_API_LIST_MODEL_KEY_CONFIG, BuildListParams } from '../../config';
 import { DotToObject, UnionToIntersection } from '../../types';
 import { ExportColumnConfig } from '../../utils';
 import { ExtractPropTypes, VNode } from 'vue';
+import { ActionBtnConfigItem } from '../display';
 
 /**
  * 表格请求参数
@@ -61,18 +62,15 @@ export interface ToolbarButtonContext<T extends Record<string, any> = Record<str
         total: number;
     };
 }
-/** toolbar 额外按钮配置 */
-export interface ToolbarButtonConfig<T extends Record<string, any> = Record<string, any>> {
-    key: string;
-    /** ElButton props，与 actionButtonProps 二选一 */
-    props?: (ctx: ToolbarButtonContext<T>) => Record<string, any>;
-    /** ActionButton props（含 data/tipContent），与 props 二选一 */
-    actionButtonProps?: (ctx: ToolbarButtonContext<T>) => Record<string, any>;
-    /** 按钮文字。btnRender 优先 */
-    label?: string;
-    /** 按钮内容 render，优先级高于 label */
-    btnRender?: (ctx: ToolbarButtonContext<T>) => VNode[];
-}
+/**
+ * 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>> = ActionBtnConfigItem<ToolbarButtonContext<T>>;
 /** toolbar 可配置项（通过 TableMain 的 toolbar prop 传入） */
 export interface TableToolbarConfig {
     /** 是否显示刷新按钮，默认 true */

package/types/helpers/index.d.ts

@@ -1,6 +1,13 @@
 export * from './form';
-export * from './storage';
-export * from './state';
-export * from './route';
 export * from './types';
 export * from './list-helper';
+/** @deprecated 改用 appAdminBridge.useState() */
+export { createUseState } from '../bridge/state';
+/** @deprecated 改用 appAdminBridge.useState() */
+export type { UseStateOptions } from '../bridge/state';
+/** @deprecated 改用 appAdminBridge.generateRouteMetaRawTree() */
+export { createGenerateRouteMetaRawTree } from '../bridge/route';
+/** @deprecated 改用 appAdminBridge.generateRouteMetaRawTree() */
+export type { RouteMetaDefaultConfig } from '../bridge/route';
+/** @deprecated 改用 appAdminBridge.getStorage() */
+export { createStorageWithNamespace } from '../bridge/storage';

package/types/index.d.ts

@@ -7,6 +7,7 @@ import { modalInstall } from './components/modal';
 import { tableInstall } from './components/table';
 import { listPageInstall } from './components/list-page';
 import { panelInstall } from './components/panel';
+import { appLayoutInstall } from './components/app-layout';
 
 export * from './components/form';
 export * from './components/menu';
@@ -16,6 +17,8 @@ export * from './components/modal';
 export * from './components/table';
 export * from './components/list-page';
 export * from './components/panel';
+export * from './components/app-layout';
+export * from './router';
 export * from './utils';
 export * from './hooks';
 export * from './types';
@@ -24,5 +27,5 @@ export * from './inject';
 export * from './helpers';
 export * from './bridge';
 export * from './store';
-export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, panelInstall, };
+export { formInstall, menuInstall, displayInstall, miscInstall, modalInstall, tableInstall, listPageInstall, panelInstall, appLayoutInstall, };
 export declare const installComponents: Plugin;