@done-coding/admin-core 0.3.0 → 0.4.0

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

@@ -1,46 +1,102 @@
-import { Component } from 'vue';
+import { Component, ComputedRef, VNode } from 'vue';
 
+/** ActionBtnGroup 按钮 size 枚举(对齐 element-plus ElButton size) */
+export type ActionBtnSize = "large" | "default" | "small";
 /**
- * `HeightProvider` 组件 props。
- *
- * 单组件即一个高度预算节点：预算优先级严格为
- * `height`（显式传入）→ 同 channel 最近祖先 HeightProvider 经 inject 下分的
- * 剩余高度 → 兜底 `0`。节点扣除自身 `#header` 槽实测高度后，
- * 将剩余可用高度沿同 channel `provide` 给后代，形成递归预算链。
+ * 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，预算最高优先级来源（非空时无视祖先 inject；height=0 视为显式 0） */
-    height?: number;
-    /** 预算 channel，默认 FULLSCREEN_HEIGHT_CHANNEL */
-    channel?: symbol;
+    /** px，视口可用高度（必填） */
+    viewportHeight: number;
+    /** px，默认槽可用高度兜底下限；超 viewportHeight 时会撑破父容器（有意设计） */
+    minHeight?: number;
 }
-/**
- * `TabsMain` 单个 tab 项配置。
- *
- * 内容渲染优先级：`#{key}` 内容槽 > `component` > 空。
- * 标题渲染优先级：`#header-{key}` 标题槽 > `title` 文本。
- */
+/** TabsMain 单个 tab 项配置 */
 export interface TabsMainItem {
-    /** tab 唯一标识，v-model 值与槽名（#{key} / #header-{key}）均以此为准 */
+    /** 唯一标识，v-model 值与槽名（#{key} / #header-{key}）以此为准 */
     key: string;
-    /** tab 标题文本，#header-{key} 槽缺省时回退此文本 */
+    /** 标题文本，#header-{key} 槽缺省时回退 */
     title: string;
-    /** tab 内容组件，#{key} 槽缺省时回退渲染此组件 */
+    /** 内容组件，#{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。
+ * TabsMain props。
  *
- * `channel` / `height` 原样透传内部组合的 HeightProvider，
- * tab-bar 占用 HeightProvider 的 `#header` 槽并计入 reserve，
- * 内容区消费剩余可用高度。激活 tab 由 `v-model<string>` 双向绑定，
- * 非法或空值自动归一到首个 tab。
+ * 高度优先级：parentChannel inject > viewportHeight > inject `BODY_CONTENT_VIEWPORT_HEIGHT` > 0。
+ * channel / parentChannel [MUST NOT] 响应式变更（setup 期快照，变更 console.error 忽略）。
  */
 export interface TabsMainProps {
     /** tab 配置列表 */
     tabs: TabsMainItem[];
-    /** 预算 channel，默认 FULLSCREEN_HEIGHT_CHANNEL，透传内部 HeightProvider */
-    channel?: symbol;
-    /** px，透传 HeightProvider 供顶层使用 */
-    height?: number;
+    /** 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;
+    /** 精细化布局:true(默认) 走 HeightProvider 精确扣 header reserve + padding 给 available;false 不包 HeightProvider,默认槽 viewportHeight 直接给 viewportHeightFinal(不扣减),业务自然流 */
+    refine?: boolean;
+    /** 精细化预留高度(px),从 viewportHeightFinal 中预扣,refine=false 时同样生效 */
+    refineReduceHeight?: number;
+    /** 显式指定 TabsHeader 视觉风格,不传则按 visualLevel 推导默认(L1=card / L2=indicator / L3=indicator-compact / L4=plain)。字号始终跟随 level,不受 variant 影响。 */
+    variant?: TabsHeaderVariant;
 }

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

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

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

@@ -1,5 +1,5 @@
 import { FormItemRule, ColProps, FormItemProps } from 'element-plus';
-import { VNode } from 'vue';
+import { VNode, ComputedRef } from 'vue';
 
 export type OnlyOneKey<T extends Record<string, any>> = {
     [K in keyof T]: {
@@ -143,6 +143,10 @@ export interface FormSearchInstance extends FormMainInstance {
     triggerSearch: () => void;
     /** 触发重置 */
     triggerReset: () => void;
+    /** 切换折叠状态 */
+    toggleCollapse: (nextValue?: boolean) => void;
+    /** 当前折叠状态 */
+    isCollapsed: ComputedRef<boolean>;
 }
 /** FormItem props */
 export interface FormMainItemProps {
@@ -162,6 +166,8 @@ export interface FormSearchProps<PO extends Record<string, any>, SO extends Reco
     labelWidth?: string;
     /** 静态参数(非表单 非分页参数) */
     staticQuery?: SQ;
+    /** 最多展示行数，超出折叠。0 = 不折叠。默认 2 */
+    maxRows?: number;
 }
 /** form item loading 信息 */
 export interface FormItemLoadingInfo {

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

@@ -3,7 +3,7 @@ import { TableApiParams, TableApiResult, TableMainInstance, TableMainProps } fro
 
 export type FormSearchOptionsKey = "staticQuery";
 export type FormSearchRewriteKey = "list";
-export type TableMainOptionsKey = "refine" | "refineReduceHeight";
+export type TableMainOptionsKey = "refine" | "refineReduceHeight" | "viewportHeight" | "parentChannel";
 export type TableMainRequiredKey = "columns" | "rowKey";
 export type TableMainRewriteKey = "api" | "query" | "injectInfo";
 export type ListPageInnerInjectInfo<PO extends Record<string, any>, 

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,7 +6,17 @@ 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, ActionButton, ActionButtonDanger, ActionButtonWarn, ActionBtn, ActionConfirm, };
+export { TriggerAutoImport, AutoRefresh, ActionBtn, ActionConfirm, SelectModule, };
+/**
+ * @deprecated 改用 {@link ActionBtn}——`ActionBtn` 通过 `confirmConfig` 一体化承载
+ * loading 自动接管 + 同步/异步 confirm-gate（popconfirm / message-box 两种 mode），
+ * 并对 ElButton 全部 props 透传。`ActionButton` / `ActionButtonDanger` / `ActionButtonWarn`
+ * 三个旧组件计划后续版本移除；新代码请直接使用 `ActionBtn`，
+ * 危险态用 `<ActionBtn type="danger" :confirm-config="{ type: 'danger', ... }">`，
+ * 警告态用 `<ActionBtn :confirm-config="{ type: 'warning', ... }">`。
+ */
+export { ActionButton, ActionButtonDanger, ActionButtonWarn };
 export declare const miscInstall: Plugin;

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,9 +84,11 @@ declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractP
     reverse: boolean;
     closeOnPressEscape: boolean;
     closeOnClickModal: boolean;
+    type: string;
 }>>> & Readonly<{
     "onUpdate:show"?: ((value: boolean) => any) | undefined;
 }>, {
+    type: "" | "default" | "primary" | "success" | "warning" | "info" | "danger" | "text";
     showClose: boolean;
     cancelText: string | (() => VNode);
     confirmText: string | (() => VNode);

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/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 */
@@ -173,4 +171,8 @@ F extends Record<string, any>> {
     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/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/hooks/index.d.ts

@@ -1,4 +1,6 @@
+export * from './use-breakpoint';
 export * from './activated';
 export * from './feel-size';
 export * from './menus-dispatch';
 export * from './timeout';
+export * from './use-channel-viewport-height';

package/types/hooks/use-breakpoint.d.ts

@@ -0,0 +1,4 @@
+export type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl";
+export declare const useBreakpoint: () => {
+    activeBreakpoint: Readonly<globalThis.Ref<Breakpoint, Breakpoint>>;
+};

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

@@ -0,0 +1,28 @@
+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/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;