@done-coding/admin-core 0.3.0 → 0.4.0

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

@@ -0,0 +1,55 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare function __VLS_template(): {
+    left?(_: {}): any;
+    right?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    menus: RouteMetaResolveRaw[];
+    /** 聚焦的路由菜单 */
+    activeMenu?: RouteMetaResolveRaw;
+    /** 聚焦的模块菜单 */
+    activeModuleMenu?: RouteMetaResolveRaw;
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    menus: () => never[];
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    menus: RouteMetaResolveRaw[];
+    /** 聚焦的路由菜单 */
+    activeMenu?: RouteMetaResolveRaw;
+    /** 聚焦的模块菜单 */
+    activeModuleMenu?: RouteMetaResolveRaw;
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    menus: () => never[];
+}>>> & Readonly<{}>, {
+    menus: RouteMetaResolveRaw[];
+}, {}, {}, {}, 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/app-layout/AppLayout.vue.d.ts

@@ -0,0 +1,76 @@
+import { AppLayoutAppStoreSlice, AppLayoutUserStoreSlice, AppLayoutBridgeSlice } from './types';
+import { WatermarkProps } from 'element-plus';
+
+declare function __VLS_template(): {
+    "sidebar-top"?(_: {}): any;
+    "sidebar-bottom"?(_: {}): any;
+    "header-left"?(_: {}): any;
+    "header-right"?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /**
+     * admin bridge 实例（#7.6 期新增必填）。
+     * AppLayout 经 `props.adminBridge` 注入后 provide 给子 layout 组件
+     * （AppBody / AppSidebar 自取 12 readonly 配置 + getRoutes / generateRouteMetaRawTree）。
+     * 业务侧 App.vue 模板：`<AppLayout :admin-bridge="appAdminBridge" ...>`。
+     */
+    adminBridge: AppLayoutBridgeSlice;
+    appStore: AppLayoutAppStoreSlice;
+    userStore: AppLayoutUserStoreSlice;
+    /** 水印内容（空数组/空串/undefined 不展示）；layout 不耦合 UserInfo shape，由业务侧派生 */
+    watermarkContent?: WatermarkProps["content"];
+    /**
+     * sidebar 层级是否高于 header（#7.5 期新增，默认 false）。
+     * true 时 AppSidebar z-index 调高于 AppHeader——适合 sidebar 顶部悬挂内容
+     * 需要覆盖 header 区域的场景（如悬浮 logo/搜索框）。
+     */
+    sidebarAboveHeader?: boolean;
+}>, {
+    sidebarAboveHeader: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /**
+     * admin bridge 实例（#7.6 期新增必填）。
+     * AppLayout 经 `props.adminBridge` 注入后 provide 给子 layout 组件
+     * （AppBody / AppSidebar 自取 12 readonly 配置 + getRoutes / generateRouteMetaRawTree）。
+     * 业务侧 App.vue 模板：`<AppLayout :admin-bridge="appAdminBridge" ...>`。
+     */
+    adminBridge: AppLayoutBridgeSlice;
+    appStore: AppLayoutAppStoreSlice;
+    userStore: AppLayoutUserStoreSlice;
+    /** 水印内容（空数组/空串/undefined 不展示）；layout 不耦合 UserInfo shape，由业务侧派生 */
+    watermarkContent?: WatermarkProps["content"];
+    /**
+     * sidebar 层级是否高于 header（#7.5 期新增，默认 false）。
+     * true 时 AppSidebar z-index 调高于 AppHeader——适合 sidebar 顶部悬挂内容
+     * 需要覆盖 header 区域的场景（如悬浮 logo/搜索框）。
+     */
+    sidebarAboveHeader?: boolean;
+}>, {
+    sidebarAboveHeader: boolean;
+}>>> & Readonly<{}>, {
+    sidebarAboveHeader: boolean;
+}, {}, {}, {}, 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/app-layout/AppPage.vue.d.ts

@@ -0,0 +1,54 @@
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 充满视口 */
+    fullViewport?: boolean;
+    fullMode?: "min-height" | "height";
+    /** 下个viewport高度 */
+    nextViewportMaxHeight?: string;
+    background?: string;
+}>, {
+    fullViewport: boolean;
+    fullMode: string;
+    nextViewportMaxHeight: string;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 充满视口 */
+    fullViewport?: boolean;
+    fullMode?: "min-height" | "height";
+    /** 下个viewport高度 */
+    nextViewportMaxHeight?: string;
+    background?: string;
+}>, {
+    fullViewport: boolean;
+    fullMode: string;
+    nextViewportMaxHeight: string;
+}>>> & Readonly<{}>, {
+    fullViewport: boolean;
+    fullMode: "min-height" | "height";
+    nextViewportMaxHeight: 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/app-layout/AppSidebar.vue.d.ts

@@ -0,0 +1,51 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare function __VLS_template(): {
+    top?(_: {}): any;
+    bottom?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout 控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    /** 层级是否高于 header（#7.5 期；true 时 z-index 提升盖住 header） */
+    aboveHeader?: boolean;
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    aboveHeader: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout 控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    /** 层级是否高于 header（#7.5 期；true 时 z-index 提升盖住 header） */
+    aboveHeader?: boolean;
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    aboveHeader: boolean;
+}>>> & Readonly<{}>, {
+    aboveHeader: boolean;
+}, {}, {}, {}, 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/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/HeightProvider.vue.d.ts

@@ -3,15 +3,19 @@ import { HeightProviderProps } from './types';
 declare function __VLS_template(): {
     header?(_: {}): any;
     default?(_: {
-        height: number;
+        viewportHeight: number;
     }): any;
 };
 declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<HeightProviderProps>, {
-    channel: symbol;
-}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<HeightProviderProps>, {
-    channel: symbol;
-}>>> & Readonly<{}>, {
-    channel: symbol;
+    minHeight: number;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    childViewportHeightChange: (value: number) => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<HeightProviderProps>, {
+    minHeight: number;
+}>>> & Readonly<{
+    onChildViewportHeightChange?: ((value: number) => any) | undefined;
+}>, {
+    minHeight: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

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

@@ -0,0 +1,42 @@
+import { TabsHeaderVariant, TabsMainItem } from './types';
+
+declare function __VLS_template(): Partial<Record<string, (_: {
+    tab: TabsMainItem;
+    active: boolean;
+}) => any>>;
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
+    activeKey: import('vue').PropType<string>;
+    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>;
+    tabs: {
+        type: globalThis.PropType<TabsMainItem[]>;
+        required: true;
+    };
+    level: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
+    variant: {
+        type: globalThis.PropType<TabsHeaderVariant>;
+    };
+}>> & Readonly<{}>, {
+    level: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -6,32 +6,74 @@ declare function __VLS_template(): Partial<Record<`header-${string}`, (_: {
 }) => any>>;
 declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
     modelValue: import('vue').PropType<string>;
-    height: {
+    viewportHeight: {
         type: globalThis.PropType<number>;
     };
+    minHeight: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
     channel: {
-        type: globalThis.PropType<symbol>;
-        default: symbol;
+        type: globalThis.PropType<string>;
+    };
+    parentChannel: {
+        type: globalThis.PropType<string>;
+    };
+    padding: {
+        type: globalThis.PropType<import('./types').TabsMainPadding>;
+    };
+    refineReduceHeight: {
+        type: globalThis.PropType<number>;
+        default: number;
     };
     tabs: {
         type: globalThis.PropType<TabsMainItem[]>;
         required: true;
     };
+    variant: {
+        type: globalThis.PropType<import('./types').TabsHeaderVariant>;
+    };
+    refine: {
+        type: globalThis.PropType<boolean>;
+        default: boolean;
+    };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
     modelValue: import('vue').PropType<string>;
-    height: {
+    viewportHeight: {
         type: globalThis.PropType<number>;
     };
+    minHeight: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
     channel: {
-        type: globalThis.PropType<symbol>;
-        default: symbol;
+        type: globalThis.PropType<string>;
+    };
+    parentChannel: {
+        type: globalThis.PropType<string>;
+    };
+    padding: {
+        type: globalThis.PropType<import('./types').TabsMainPadding>;
+    };
+    refineReduceHeight: {
+        type: globalThis.PropType<number>;
+        default: number;
     };
     tabs: {
         type: globalThis.PropType<TabsMainItem[]>;
         required: true;
     };
+    variant: {
+        type: globalThis.PropType<import('./types').TabsHeaderVariant>;
+    };
+    refine: {
+        type: globalThis.PropType<boolean>;
+        default: boolean;
+    };
 }>> & Readonly<{}>, {
-    channel: symbol;
+    minHeight: number;
+    refineReduceHeight: number;
+    refine: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

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

@@ -0,0 +1,16 @@
+declare function __VLS_template(): {
+    header?(_: {}): any;
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    viewportHeightChange: (value: number | undefined) => void;
+}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{
+    onViewportHeightChange?: ((value: number | undefined) => 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_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,53 @@
+import { TabsMainPadding } from './types';
+
+interface TabsRefineFlowProps {
+    viewportHeight?: number;
+    minHeight?: number;
+    channel?: string;
+    parentChannel?: string;
+    padding?: TabsMainPadding;
+    /** 精细化预留高度(px),从 viewportHeightFinal 中预扣(在 padding 扣减与 HeightProvider header reserve 扣减之外) */
+    refineReduceHeight?: number;
+}
+declare function __VLS_template(): {
+    header?(_: {}): any;
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<TabsRefineFlowProps>, {
+    padding: () => TabsMainPadding;
+    refineReduceHeight: number;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    viewportHeightChange: (value: number | undefined) => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<TabsRefineFlowProps>, {
+    padding: () => TabsMainPadding;
+    refineReduceHeight: number;
+}>>> & Readonly<{
+    onViewportHeightChange?: ((value: number | undefined) => any) | undefined;
+}>, {
+    padding: TabsMainPadding;
+    refineReduceHeight: number;
+}, {}, {}, {}, 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/display/index.d.ts

@@ -2,26 +2,29 @@ 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` 上报，供高度预算等场景复用。
- */
+/** 尺寸监听容器：debounce 测默认槽内容宽/高，`@height-change` / `@size-change` 上报 */
 WatchSize, 
 /**
- * Tab 容器组件：手写 tab-bar + 滑动下划线，内部组合 HeightProvider
- * 做高度预算。激活 tab 经 `v-model<string>` 双向绑定并自动归一；
- * 内容懒渲染（首次激活前不实例化）+ KeepAlive（切走保活、切回复用，
- * 状态保留）。内容槽 `#{key}` > `tabs[].component`，
- * 标题槽 `#header-{key}` > `tabs[].title`，两类槽作用域均 `{ tab, active }`。
+ * Tab 容器：手写 tab-bar + 滑动下划线 + 懒渲染 KeepAlive。
+ * 嵌套联动用 `channel="x"` / `parentChannel="x"` 字符串显式配对（[MUST NOT] 响应式）。
  */
 TabsMain, 
 /**
- * 递归高度预算节点：按 `height` → 祖先同 channel inject → `0` 优先级
- * 取得预算，扣除 `#header` 槽实测高度后将剩余可用高度沿同 channel
- * provide 给后代。默认槽作用域 `{ height }` 提供当前可用高度数值。
+ * 纯数值高度预算节点：`available = max(viewportHeight - reserve, minHeight ?? 0)`，
+ * 默认槽 `{ height }` 暴露。Fragment 双根，不撑开自身，不 inject 不 provide。
+ * 消费方 [MUST] 用 slot scope `:height` 自设容器高。
+ */
+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 推广）。
  */
-HeightProvider, };
+ActionBtnGroup, };
 export declare const displayInstall: Plugin;
 export * from './types';