vue-stack-tabs 1.1.0 → 1.3.1

package/dist/src/lib/components/TabHeader/index.vue.d.ts

@@ -1,4 +1,4 @@
-import { nextTick, TransitionProps } from 'vue';
+import { TransitionProps } from 'vue';
 import { TabScrollMode } from '../../model/TabModel';
 type __VLS_Props = {
     space: number;
@@ -7,92 +7,13 @@ type __VLS_Props = {
     contextmenu?: boolean | object;
     max?: number;
 };
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: {
-        leftButton?(_: {}): any;
-        rightButton?(_: {}): any;
-    };
-    refs: {
-        scrollContainerRef: ({
-            $: import('vue').ComponentInternalInstance;
-            $data: {};
-            $props: {
-                readonly space?: number | undefined;
-                readonly isScrollWheel?: boolean | undefined;
-                readonly isScrollButton?: boolean | undefined;
-            } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
-            $attrs: {
-                [x: string]: unknown;
-            };
-            $refs: {
-                [x: string]: unknown;
-            } & {
-                headerScroll: HTMLDivElement;
-                container: HTMLDivElement;
-                bar: HTMLDivElement;
-                thumb: HTMLDivElement;
-            };
-            $slots: Readonly<{
-                [name: string]: import('vue').Slot<any> | undefined;
-            }>;
-            $root: import('vue').ComponentPublicInstance | null;
-            $parent: import('vue').ComponentPublicInstance | null;
-            $host: Element | null;
-            $emit: (event: string, ...args: any[]) => void;
-            $el: any;
-            $options: import('vue').ComponentOptionsBase<Readonly<{
-                space?: number;
-                isScrollWheel?: boolean;
-                isScrollButton?: boolean;
-            }> & Readonly<{}>, {
-                scrollIntoView: (el: HTMLElement) => void;
-                isInView: (el: HTMLElement) => boolean;
-            }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
-                space: number;
-                isScrollWheel: boolean;
-                isScrollButton: boolean;
-            }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
-                beforeCreate?: (() => void) | (() => void)[];
-                created?: (() => void) | (() => void)[];
-                beforeMount?: (() => void) | (() => void)[];
-                mounted?: (() => void) | (() => void)[];
-                beforeUpdate?: (() => void) | (() => void)[];
-                updated?: (() => void) | (() => void)[];
-                activated?: (() => void) | (() => void)[];
-                deactivated?: (() => void) | (() => void)[];
-                beforeDestroy?: (() => void) | (() => void)[];
-                beforeUnmount?: (() => void) | (() => void)[];
-                destroyed?: (() => void) | (() => void)[];
-                unmounted?: (() => void) | (() => void)[];
-                renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-                renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-                errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
-            };
-            $forceUpdate: () => void;
-            $nextTick: typeof nextTick;
-            $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
-        } & Readonly<{
-            space: number;
-            isScrollWheel: boolean;
-            isScrollButton: boolean;
-        }> & Omit<Readonly<{
-            space?: number;
-            isScrollWheel?: boolean;
-            isScrollButton?: boolean;
-        }> & Readonly<{}>, "scrollIntoView" | "isInView" | ("space" | "isScrollWheel" | "isScrollButton")> & import('vue').ShallowUnwrapRef<{
-            scrollIntoView: (el: HTMLElement) => void;
-            isInView: (el: HTMLElement) => boolean;
-        }> & {} & import('vue').ComponentCustomProperties & {} & {
-            $slots: {
-                default?(_: {}): any;
-            };
-        }) | null;
-    };
-    rootEl: HTMLDivElement;
+declare var __VLS_1: {}, __VLS_30: {};
+type __VLS_Slots = {} & {
+    leftButton?: (props: typeof __VLS_1) => any;
+} & {
+    rightButton?: (props: typeof __VLS_30) => any;
 };
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     active: (...args: any[]) => void;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onActive?: ((...args: any[]) => any) | undefined;
@@ -101,85 +22,11 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     contextmenu: boolean | object;
     tabScrollMode: TabScrollMode;
     tabTransition: string | TransitionProps;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    scrollContainerRef: ({
-        $: import('vue').ComponentInternalInstance;
-        $data: {};
-        $props: {
-            readonly space?: number | undefined;
-            readonly isScrollWheel?: boolean | undefined;
-            readonly isScrollButton?: boolean | undefined;
-        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
-        $attrs: {
-            [x: string]: unknown;
-        };
-        $refs: {
-            [x: string]: unknown;
-        } & {
-            headerScroll: HTMLDivElement;
-            container: HTMLDivElement;
-            bar: HTMLDivElement;
-            thumb: HTMLDivElement;
-        };
-        $slots: Readonly<{
-            [name: string]: import('vue').Slot<any> | undefined;
-        }>;
-        $root: import('vue').ComponentPublicInstance | null;
-        $parent: import('vue').ComponentPublicInstance | null;
-        $host: Element | null;
-        $emit: (event: string, ...args: any[]) => void;
-        $el: any;
-        $options: import('vue').ComponentOptionsBase<Readonly<{
-            space?: number;
-            isScrollWheel?: boolean;
-            isScrollButton?: boolean;
-        }> & Readonly<{}>, {
-            scrollIntoView: (el: HTMLElement) => void;
-            isInView: (el: HTMLElement) => boolean;
-        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
-            space: number;
-            isScrollWheel: boolean;
-            isScrollButton: boolean;
-        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
-            beforeCreate?: (() => void) | (() => void)[];
-            created?: (() => void) | (() => void)[];
-            beforeMount?: (() => void) | (() => void)[];
-            mounted?: (() => void) | (() => void)[];
-            beforeUpdate?: (() => void) | (() => void)[];
-            updated?: (() => void) | (() => void)[];
-            activated?: (() => void) | (() => void)[];
-            deactivated?: (() => void) | (() => void)[];
-            beforeDestroy?: (() => void) | (() => void)[];
-            beforeUnmount?: (() => void) | (() => void)[];
-            destroyed?: (() => void) | (() => void)[];
-            unmounted?: (() => void) | (() => void)[];
-            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
-            errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
-        };
-        $forceUpdate: () => void;
-        $nextTick: typeof nextTick;
-        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
-    } & Readonly<{
-        space: number;
-        isScrollWheel: boolean;
-        isScrollButton: boolean;
-    }> & Omit<Readonly<{
-        space?: number;
-        isScrollWheel?: boolean;
-        isScrollButton?: boolean;
-    }> & Readonly<{}>, "scrollIntoView" | "isInView" | ("space" | "isScrollWheel" | "isScrollButton")> & import('vue').ShallowUnwrapRef<{
-        scrollIntoView: (el: HTMLElement) => void;
-        isInView: (el: HTMLElement) => boolean;
-    }> & {} & import('vue').ComponentCustomProperties & {} & {
-        $slots: {
-            default?(_: {}): any;
-        };
-    }) | null;
-}, HTMLDivElement>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
+type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;
     };

package/dist/src/lib/hooks/stackTabsContext.d.ts

@@ -0,0 +1,49 @@
+import { App, DefineComponent, InjectionKey, Ref, ShallowRef } from 'vue';
+import { Emitter } from 'mitt';
+import { ITabItem } from '../model/TabModel';
+import { TabEventPayloadMap } from './useTabEventBus';
+import { ScrollPosition } from './tabPanel/state';
+export declare const STACK_TABS_CONTEXT_UNAVAILABLE_MESSAGE = "VueStackTabs runtime context is not available. Render <VueStackTabs> before using vue-stack-tabs composables.";
+export declare const STACK_TABS_DUPLICATE_INSTANCE_MESSAGE = "VueStackTabs only supports one <VueStackTabs> instance per Vue app.";
+export interface StackTabsRuntimeContext {
+    tabs: Ref<ITabItem[]>;
+    defaultTabs: Ref<ITabItem[]>;
+    caches: ShallowRef<string[]>;
+    components: Map<string, DefineComponent>;
+    cacheIdsToEvict: Set<string>;
+    tabIdsToEvict: Set<string>;
+    refreshKey: Ref<number>;
+    scrollPositionsByPageId: Map<string, Map<string, ScrollPosition>>;
+    isInitialized: Ref<boolean>;
+    iframeRefreshKeys: Ref<Record<string, number>>;
+    maxTabCount: Ref<number>;
+    useGlobalScroll: Ref<boolean>;
+    sessionPrefix: Ref<string>;
+    iframePath: Ref<string>;
+    eventBus: Emitter<TabEventPayloadMap>;
+}
+export interface CreateStackTabsRuntimeContextOptions {
+    iframePath?: string;
+    maxTabCount?: number;
+    useGlobalScroll?: boolean;
+    sessionPrefix?: string;
+}
+export interface RegisterStackTabsRuntimeContextOptions {
+    app?: App;
+    isProduction?: boolean;
+}
+export interface UnregisterStackTabsRuntimeContextOptions {
+    app?: App;
+}
+export declare const stackTabsContextKey: InjectionKey<StackTabsRuntimeContext>;
+export declare const maximumKey: InjectionKey<Ref<boolean>>;
+/** 创建一个新的运行时上下文实例 */
+export declare const createStackTabsRuntimeContext: (options?: CreateStackTabsRuntimeContextOptions) => StackTabsRuntimeContext;
+/** 获取当前活跃的运行时上下文（模块级单例） */
+export declare const getActiveStackTabsRuntimeContext: () => StackTabsRuntimeContext | null;
+/** 注册运行时上下文，重复注册会在开发环境抛出错误 */
+export declare const registerStackTabsRuntimeContext: (context: StackTabsRuntimeContext, options?: RegisterStackTabsRuntimeContextOptions) => boolean;
+/** 注销运行时上下文，组件卸载时调用 */
+export declare const unregisterStackTabsRuntimeContext: (context: StackTabsRuntimeContext, options?: UnregisterStackTabsRuntimeContextOptions) => void;
+/** 解析当前可用的运行时上下文，优先使用 inject，回退到模块单例 */
+export declare const resolveStackTabsRuntimeContext: () => StackTabsRuntimeContext;

package/dist/src/lib/hooks/tabPanel/evict.d.ts

@@ -1,62 +1,22 @@
 import { ITabPage } from '../../model/TabModel';
-/**
- * 将指定 cacheName 放入待驱逐集合。
- * 不立即清除，等叫到 evictMarkedCaches 时统一处理。
- */
-export declare const markCacheForEviction: (cacheName: string) => void;
-/**
- * 标记某个标签下所有页面为待驱逐，并标记该标签本身（用于「关闭标签」场景）。
- * tabIdsToEvict 中的标签 ID 会在 updatePageState 中被检测到，
- * 阻止被关闭的标签重新路由时意外复活。
- */
-export declare const markTabPagesForEviction: (tab: {
-    id: string;
-    pages: {
-        list(): ITabPage[];
-    };
-}) => void;
-/**
- * 仅标记标签下所有页面为待驱逐，不标记标签本身（用于「续签/换页」场景）。
- * 适用于刷新标签：旧页面缓存清零，标签本身仍然存活，
- * 导航后由 updatePageState 重新创建页面。
- */
-export declare const markTabPagesForEvictionOnly: (tab: {
-    pages: {
-        list(): ITabPage[];
-    };
-}) => void;
-/**
- * 将 cacheName 加入 <keep-alive> 的 include 列表（caches）。
- * 幂等：已存在时不重复添加，避免 include 数组中出现重复项
- * 影响 <keep-alive> 缓存范围，决定哪些 cacheComponent 实例会被保留。
- */
-export declare const addCache: (cacheName: string) => void;
-/**
- * 将 cacheName 从 include 列表（caches）中移除。
- * Vue 的 <keep-alive> 会以 flush:'post' 的 watcher 检测 include 变更，
- * 在下次渲染后自动销毁不再被 include 的缓存实例。
- */
-export declare const removeCache: (cacheName: string) => void;
-/**
- * 立即、同步、彻底驱逐单个页面的缓存。
- *
- * 操作步骤：
- * 1. 从 cacheIdsToEvict 移除（若存在，防止后续 evictMarkedCaches 二次处理）
- * 2. removeCache(cacheName)   → 从 <keep-alive> include 列表删除，触发 Vue 销毁缓存组件实例
- * 3. components.delete(...)   → 从 components Map 删除组件定义，
- *    使 resolvePageComponent 下次进入时必须重新创建全新的 cacheComponent 实例
- *
- * ⚠️ 调用时机要求：
- * 必须在 router.push() 完成（.then()）之后调用，
- * 不能在导航前调用，否则驱逐触发的响应式更新会导致 StackTabs 以旧路由重渲染，
- * 进而重建刚被删除的组件（竞态）。详见 useTabRouter.ts backward 的注释。
- */
-export declare const evictPageCache: (cacheName: string) => void;
-/**
- * 执行所有已标记缓存的批量驱逐（由 cacheComponent 的 onActivated 调用）。
- *
- * 调用时机：
- * 当 cacheComponent 切换到激活（activated）状态时，说明用户切换到了一个新页面，
- * 相关的旧页面已经稳定进入「不活跃/待驱逐」状态，此时批量清理是安全的。
- */
-export declare const evictMarkedCaches: () => void;
+import { StackTabsRuntimeContext } from '../stackTabsContext';
+export interface TabPanelEvictionApi {
+    markCacheForEviction: (cacheName: string) => void;
+    markTabPagesForEviction: (tab: {
+        id: string;
+        pages: {
+            list(): ITabPage[];
+        };
+    }) => void;
+    markTabPagesForEvictionOnly: (tab: {
+        pages: {
+            list(): ITabPage[];
+        };
+    }) => void;
+    addCache: (cacheName: string) => void;
+    removeCache: (cacheName: string) => void;
+    evictPageCache: (cacheName: string) => void;
+    replacePageCaches: (cacheNamesToEvict: Iterable<string>, cacheNamesToAdd: Iterable<string>) => void;
+    evictMarkedCaches: () => void;
+}
+export declare const createTabPanelEviction: (context: StackTabsRuntimeContext) => TabPanelEvictionApi;

package/dist/src/lib/hooks/tabPanel/navigationTransaction.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 导航事务管理器。
+ *
+ * 将「乐观 UI 更新 → 路由导航 → 确认/回滚」包装为原子事务：
+ * 1. apply()  — 先对 UI 状态做乐观修改，返回快照
+ * 2. navigate() — 执行 router.push 等异步导航
+ * 3. 成功 → commit()；失败/异常 → rollback(snapshot) 恢复快照
+ *
+ * 当连续快速操作导致事务过期时（isCurrent 返回 false），
+ * 不回滚而是调用 cleanupStale() 清理残留状态，避免覆盖新事务的结果。
+ */
+interface NavigationTransactionOptions<TSnapshot, TResult> {
+    /** 乐观应用 UI 变更，返回可用于 rollback 的快照 */
+    apply: () => TSnapshot;
+    /** 执行异步路由导航 */
+    navigate: () => Promise<TResult>;
+    /** 导航失败时回滚到快照状态 */
+    rollback: (snapshot: TSnapshot) => void;
+    /** 导航成功后的确认回调（如驱逐旧缓存） */
+    commit?: () => void;
+    /** 判断导航结果是否为失败（如 vue-router 返回的 NavigationFailure） */
+    isFailureResult?: (result: TResult) => boolean;
+    /** 若为失败结果，是否将其作为异常抛出 */
+    rejectFailureResult?: boolean;
+    /** 检查当前事务是否仍然有效（防止过期事务覆盖新状态） */
+    isCurrent?: () => boolean;
+    /** 事务已过期时的清理回调（替代 rollback） */
+    cleanupStale?: () => void;
+}
+/**
+ * 执行一次导航事务：apply → navigate → commit/rollback。
+ * 保证乐观更新在导航失败时能安全回滚。
+ */
+export declare const runNavigationTransaction: <TSnapshot, TResult>(options: NavigationTransactionOptions<TSnapshot, TResult>) => Promise<TResult>;
+export {};

package/dist/src/lib/hooks/tabPanel/refresh.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+import { ITabItem } from '../../model/TabModel';
+export interface TabPanelRefreshApi {
+    refreshTab: (id: string) => void;
+    refreshAllTabs: () => void;
+}
+export interface CreateTabPanelRefreshOptions {
+    tabs: Ref<ITabItem[]>;
+    iframeRefreshKeys: Ref<Record<string, number>>;
+    getTab: (id: string) => ITabItem | null;
+    createPageId: () => string;
+    addCache: (cacheName: string) => void;
+    evictPageCache: (cacheName: string) => void;
+    replacePageCaches: (cacheNamesToEvict: Iterable<string>, cacheNamesToAdd: Iterable<string>) => void;
+    refreshIframeByPostMessage: (tabId: string) => void;
+}
+export declare const createTabPanelRefresh: (options: CreateTabPanelRefreshOptions) => TabPanelRefreshApi;

package/dist/src/lib/hooks/tabPanel/scroll.d.ts

@@ -1,8 +1,8 @@
-/** 恢复指定页面的滚动位置 */
-export declare const restoreScroller: (pageCacheId: string) => void;
-/** 保存指定页面的滚动位置 */
-export declare const saveScroller: (pageCacheId: string) => void;
-/** 移除指定页面的滚动记录 */
-export declare const removeScroller: (pageCacheId: string) => void;
-/** 为页面注册需要记录滚动位置的选择器 */
-export declare const addPageScroller: (pageCacheId: string, ...selectorIds: string[]) => void;
+import { StackTabsRuntimeContext } from '../stackTabsContext';
+export interface TabPanelScrollApi {
+    restoreScroller: (pageCacheId: string) => void;
+    saveScroller: (pageCacheId: string) => void;
+    removeScroller: (pageCacheId: string) => void;
+    addPageScroller: (pageCacheId: string, ...selectorIds: string[]) => void;
+}
+export declare const createTabPanelScroll: (context: StackTabsRuntimeContext) => TabPanelScrollApi;

package/dist/src/lib/hooks/tabPanel/session.d.ts

@@ -1,9 +1,10 @@
 import { ITabItem } from '../../model/TabModel';
-/** 获取 sessionStorage 的 key */
-export declare const getSessionKey: () => string;
-/** 将当前激活的标签保存到 sessionStorage */
-export declare const saveActiveTabToSession: (tab: ITabItem) => void;
-/** 清除 sessionStorage 中的激活标签 */
-export declare const clearSession: () => void;
-/** 从 sessionStorage 解析恢复的标签（含 Stack 反序列化） */
-export declare const restoreTabFromSession: (storedJson: string | null) => ITabItem | null;
+import { StackTabsRuntimeContext } from '../stackTabsContext';
+export interface TabPanelSessionApi {
+    getSessionKey: () => string;
+    saveActiveTabToSession: (tab: ITabItem) => void;
+    clearSession: () => void;
+    restoreActiveTabSession: (storedJson: string | null) => void;
+    restoreTabFromSession: (storedJson: string | null) => ITabItem | null;
+}
+export declare const createTabPanelSession: (context: StackTabsRuntimeContext) => TabPanelSessionApi;

package/dist/src/lib/hooks/tabPanel/state.d.ts

@@ -1,76 +1,24 @@
+import { DefineComponent, Ref, ShallowRef } from 'vue';
 import { ITabItem } from '../../model/TabModel';
-/** 当前打开的标签列表（含每个标签的页面栈） */
-export declare const tabs: import('vue').Ref<{
-    id: string;
-    closable: boolean;
-    refreshable: boolean;
-    iframe: boolean;
-    iframeRefreshMode?: import('../..').IframeRefreshMode | undefined;
-    url?: string | undefined;
-    active: boolean;
-    pages: {
-        push: (element: import('../..').ITabPage) => void;
-        pop: () => import('../..').ITabPage | undefined;
-        peek: () => import('../..').ITabPage | undefined;
-        isEmpty: () => boolean;
-        size: () => number;
-        clear: () => void;
-        list: () => import('../..').ITabPage[];
-        toJSON: () => import('../..').ITabPage[];
-        toString: () => string;
-    };
-    title: string;
-}[], ITabItem[] | {
-    id: string;
-    closable: boolean;
-    refreshable: boolean;
-    iframe: boolean;
-    iframeRefreshMode?: import('../..').IframeRefreshMode | undefined;
-    url?: string | undefined;
-    active: boolean;
-    pages: {
-        push: (element: import('../..').ITabPage) => void;
-        pop: () => import('../..').ITabPage | undefined;
-        peek: () => import('../..').ITabPage | undefined;
-        isEmpty: () => boolean;
-        size: () => number;
-        clear: () => void;
-        list: () => import('../..').ITabPage[];
-        toJSON: () => import('../..').ITabPage[];
-        toString: () => string;
-    };
-    title: string;
-}[]>;
-/** 初始化时传入的默认标签（用于对比 session 恢复） */
-export declare const defaultTabs: ITabItem[];
-/** keep-alive include 数组，与 Vue 的 keep-alive :include 绑定 */
-export declare const caches: import('vue').Ref<string[], string[]>;
-/** 页面缓存 ID -> 包装后的 DefineComponent */
-export declare const components: Map<string, import('vue').DefineComponent<{}, {}, {}, import('vue').ComputedOptions, import('vue').MethodOptions, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{}>>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>>;
-/** 待驱逐的页面缓存 ID 集合 */
-export declare const cacheIdsToEvict: Set<string>;
-/** 待驱逐的标签 ID 集合 */
-export declare const tabIdsToEvict: Set<string>;
-/** 刷新计数器，变更时触发 component :key 变化 */
-export declare const refreshKey: import('vue').Ref<number, number>;
-/** 刷新时临时加入 keep-alive exclude 的缓存 ID */
-/** pageCacheId -> Map<selector, { top, left }> 滚动位置存储 */
-export declare const scrollPositionsByPageId: Map<string, Map<string, {
+export interface ScrollPosition {
     top: number;
     left: number;
-}>>;
-/** 是否已完成初始化 */
-export declare const isInitialized: import('vue').Ref<boolean, boolean>;
-/** sessionStorage 中存储当前激活标签的 key 前缀 */
+}
+export interface TabPanelRuntimeState {
+    tabs: Ref<ITabItem[]>;
+    defaultTabs: Ref<ITabItem[]>;
+    caches: ShallowRef<string[]>;
+    components: Map<string, DefineComponent>;
+    cacheIdsToEvict: Set<string>;
+    tabIdsToEvict: Set<string>;
+    refreshKey: Ref<number>;
+    scrollPositionsByPageId: Map<string, Map<string, ScrollPosition>>;
+    isInitialized: Ref<boolean>;
+    iframeRefreshKeys: Ref<Record<string, number>>;
+    maxTabCount: Ref<number>;
+    useGlobalScroll: Ref<boolean>;
+    sessionPrefix: Ref<string>;
+}
+/** sessionStorage 中存储当前激活标签的 key 后缀 */
 export declare const SESSION_TAB_NAME = "stacktab-active-tab";
-/** iframe 标签 tabId -> 刷新序号，变更时触发 iframe 重载 */
-export declare const iframeRefreshKeys: import('vue').Ref<Record<string, number>, Record<string, number>>;
-/** 最大标签数量，0 表示不限制 */
-export declare let maxTabCount: number;
-/** 是否使用页面级滚动 */
-export declare let useGlobalScroll: boolean;
-/** sessionStorage key 前缀 */
-export declare let sessionPrefix: string;
-export declare const setMaxTabCount: (n: number) => void;
-export declare const setUseGlobalScroll: (v: boolean) => void;
-export declare const setSessionPrefix: (p: string) => void;
+export declare const createTabPanelRuntimeState: () => TabPanelRuntimeState;

package/dist/src/lib/hooks/useIframeManager.d.ts

@@ -0,0 +1,35 @@
+import { Ref } from 'vue';
+import { ITabData, ITabItem } from '../model/TabModel';
+type IframeLoadStatus = 'idle' | 'loading' | 'loaded' | 'timeout';
+interface IframeLoadState {
+    status: IframeLoadStatus;
+    message?: string;
+}
+export interface UseIframeManagerOptions {
+    tabs: Ref<ITabItem[]>;
+    iframeRefreshKeys: Ref<Record<string, number>>;
+    iframeLoadTimeout: number;
+    t: (key: string) => string;
+}
+export declare function useIframeManager(options: UseIframeManagerOptions): {
+    iframeTabs: import('vue').ComputedRef<ITabItem[]>;
+    activeNonIframeTab: import('vue').ComputedRef<ITabItem | undefined>;
+    hasActiveNonIframeTab: import('vue').ComputedRef<boolean>;
+    iframeSrcMap: import('vue').ComputedRef<Record<string, string>>;
+    getIframeRefreshKey: (frameId: string) => number;
+    getIframeKey: (frame: {
+        id: string;
+    }) => string;
+    getIframeLoadState: (frameId: string) => IframeLoadState;
+    shouldShowIframeLoading: (frameId: string) => boolean;
+    shouldShowIframeError: (frameId: string) => boolean;
+    retryIframe: (frameId: string) => void;
+    setIframeRef: (id: string, el: HTMLIFrameElement | null) => void;
+    handleIframeLoad: (frame: {
+        id: string;
+        url?: string;
+    }, event: Event) => void;
+    handleRefreshIframePostMessage: (tabId: string) => void;
+    createMessageHandler: (allowedOrigins: Ref<string[]>, openTab: (tab: ITabData) => Promise<string | undefined>) => (ev: MessageEvent) => void;
+};
+export {};

package/dist/src/lib/hooks/useTabActions.d.ts

@@ -1,5 +1,4 @@
-import { throttle } from 'throttle-debounce';
-import { ITabData, IframeRefreshMode } from '../model/TabModel';
+import { ITabData } from '../model/TabModel';
 /**
  * useTabActions - 标签操作对外 Hook
  *
@@ -14,55 +13,15 @@ import { ITabData, IframeRefreshMode } from '../model/TabModel';
  * - reset() 重置（关闭所有）
  */
 export default function useTabActions(): {
-    openTab: throttle<(tab: ITabData, renew?: any) => Promise<string | undefined>>;
+    openTab: (tab: ITabData, renew?: boolean) => Promise<string | undefined>;
     closeTab: (id: string) => string;
     closeAllTabs: () => void;
     refreshTab: (id: string) => void;
     refreshAllTabs: () => void;
-    activeTab: (id: string, route?: boolean) => void;
+    activeTab: (id: string, route?: boolean) => Promise<void | import('vue-router').NavigationFailure | undefined>;
     reset: () => void;
-    tabs: import('vue').Ref<{
-        id: string;
-        closable: boolean;
-        refreshable: boolean;
-        iframe: boolean;
-        iframeRefreshMode?: IframeRefreshMode | undefined;
-        url?: string | undefined;
-        active: boolean;
-        pages: {
-            push: (element: import('..').ITabPage) => void;
-            pop: () => import('..').ITabPage | undefined;
-            peek: () => import('..').ITabPage | undefined;
-            isEmpty: () => boolean;
-            size: () => number;
-            clear: () => void;
-            list: () => import('..').ITabPage[];
-            toJSON: () => import('..').ITabPage[];
-            toString: () => string;
-        };
-        title: string;
-    }[], import('..').ITabItem[] | {
-        id: string;
-        closable: boolean;
-        refreshable: boolean;
-        iframe: boolean;
-        iframeRefreshMode?: IframeRefreshMode | undefined;
-        url?: string | undefined;
-        active: boolean;
-        pages: {
-            push: (element: import('..').ITabPage) => void;
-            pop: () => import('..').ITabPage | undefined;
-            peek: () => import('..').ITabPage | undefined;
-            isEmpty: () => boolean;
-            size: () => number;
-            clear: () => void;
-            list: () => import('..').ITabPage[];
-            toJSON: () => import('..').ITabPage[];
-            toString: () => string;
-        };
-        title: string;
-    }[]>;
+    tabs: import('vue').Ref<import('..').ITabItem[], import('..').ITabItem[]>;
     setIFramePath: (path: string) => void;
-    getWrapper: () => Element | undefined;
+    getWrapper: () => Element;
     openInNewWindow: (id: string) => void;
 };