vue-stack-tabs 1.3.1 → 1.4.2

package/src/lib/hooks/useTabRouter.ts

@@ -2,7 +2,6 @@ import { defu } from 'defu'
 import { getCurrentInstance } from 'vue'
 import type { ComponentInternalInstance } from 'vue'
 import type { LocationQueryRaw, RouteLocationPathRaw } from 'vue-router'
-import type { ITabPage } from '../model/TabModel'
 import { isNavigationFailure, useRoute, useRouter } from 'vue-router'
 
 import useTabPanel from './useTabPanel'
@@ -18,18 +17,6 @@ import { runNavigationTransaction } from './tabPanel/navigationTransaction'
 
 import { createPageId } from '../utils/tabInfoEncoder'
 
-interface PageStackLike {
-  clear: () => void
-  push: (page: ITabPage) => void
-}
-
-const restorePages = (stack: PageStackLike, pages: ITabPage[]) => {
-  stack.clear()
-  for (const page of pages) {
-    stack.push(clonePage(page))
-  }
-}
-
 /**
  * useTabRouter - 标签内路由 Hook
  *
@@ -62,7 +49,19 @@ export default function useTabRouter() {
   const route = useRoute()
   const router = useRouter()
   const emitter = useTabEmitter()
-  const { getTab, evictPageCache, addPageScroller, active: activateTab } = useTabPanel()
+  const {
+    getTab,
+    getTopPage,
+    getPages,
+    appendPage,
+    popPages,
+    getPageSnapshot,
+    replacePages,
+    updatePage,
+    evictPageCache,
+    addPageScroller,
+    active: activateTab
+  } = useTabPanel()
 
   /**
    * 当前标签的编码信息字符串，存于 URL query.__tab。
@@ -87,7 +86,7 @@ export default function useTabRouter() {
     const targetQuery = (to.query || {}) as LocationQueryRaw
 
     if (tab) {
-      const top = tab.pages.peek()
+      const top = getTopPage(tab.id)
       if (top && top.path === to.path) {
         if (isSameQueryIgnoringReserved(targetQuery, top.query || {})) {
           if (!tab.active) {
@@ -98,17 +97,19 @@ export default function useTabRouter() {
       }
     }
 
-    const query = defu({ __tab: tabInfo }, to.query)
+    // __tab 是 StackTabs 解析路由归属标签的关键，优先沿用目标 query 已有的值，
+    // 避免被 to.query 中非字符串的同名 key 或缺失值覆盖。
+    const query = defu(to.query, { __tab: tabInfo })
     const transactionVersion = ++navigationVersion
     emitter.emit(TabEventType.FORWARD)
 
     let optimisticPageId = ''
     runNavigationTransaction({
       apply: () => {
-        const snapshot = tab ? tab.pages.readonlyList().map((p) => clonePage(p)) : []
+        const snapshot = tab ? getPageSnapshot(tab.id) : []
         if (tab) {
           optimisticPageId = createPageId()
-          tab.pages.push({
+          appendPage(tab.id, {
             id: optimisticPageId,
             tabId: tab.id,
             path: to.path,
@@ -119,14 +120,14 @@ export default function useTabRouter() {
       },
       navigate: () => router.push({ path: to.path, query }),
       rollback: (snapshot) => {
-        if (tab) restorePages(tab.pages, snapshot)
+        if (tab) replacePages(tab.id, snapshot)
       },
       isFailureResult: isNavigationFailure,
       isCurrent: () => navigationVersion === transactionVersion,
       cleanupStale: () => {
         if (!tab || !optimisticPageId) return
-        const pages = tab.pages.list().filter((page) => page.id !== optimisticPageId)
-        restorePages(tab.pages, pages)
+        const pages = getPages(tab.id).filter((page) => page.id !== optimisticPageId)
+        replacePages(tab.id, pages)
       }
     }).catch((error: unknown) => {
       if (!import.meta.env.PROD) {
@@ -147,7 +148,7 @@ export default function useTabRouter() {
     const tab = getTab(tabId)
     if (!tab) return false
 
-    const stack = tab.pages
+    const pages = getPages(tab.id)
     let steps = 0
 
     if (typeof to === 'number') {
@@ -155,10 +156,9 @@ export default function useTabRouter() {
     } else {
       const parsed = parseUrl(to)
       const targetQuery = parsed.query || {}
-      const pages = stack.readonlyList()
       let found = false
 
-      for (let i = stack.size() - 2; i >= 0; i--) {
+      for (let i = pages.length - 2; i >= 0; i--) {
         steps++
         const page = pages[i]
         if (
@@ -182,38 +182,42 @@ export default function useTabRouter() {
 
     if (steps <= 0) return false
 
-    if (stack.size() <= steps) {
-      steps = stack.size() - 1
+    const availableSteps = pages.length - 1
+    if (availableSteps < steps) {
+      // 请求退栈步数大于当前可用层数时，仅退到栈底（首页）；开发模式下提示维护者。
+      if (!import.meta.env.PROD) {
+        console.warn(
+          `[vue-stack-tabs] backward requested ${steps} steps but stack only has ${availableSteps} available.`
+        )
+      }
+      steps = availableSteps
     }
 
     if (steps <= 0) return false
 
-    const originalPages = stack.readonlyList().map((p) => clonePage(p))
-    const recyclingBin: string[] = []
-    for (let i = 0; i < steps; i++) {
-      const popped = stack.pop()
-      if (popped) recyclingBin.push(popped.id)
-    }
+    const originalPages = getPageSnapshot(tab.id)
+    const recyclingBin = popPages(tab.id, steps).map((page) => page.id)
 
-    const target = stack.peek()
+    const target = getTopPage(tab.id)
     if (!target) {
-      restorePages(stack, originalPages)
+      replacePages(tab.id, originalPages)
       return false
     }
 
     if (backQuery) {
-      target._backParams = backQuery
+      updatePage(tab.id, target.id, { _backParams: backQuery })
     }
 
     emitter.emit(TabEventType.BACKWARD)
 
-    const targetQueryWithTab = defu({ __tab: tabInfo }, target.query || {})
+    // 栈顶 query 已带 __tab 时优先沿用，避免被默认 tabInfo 覆盖导致解析时识别错乱。
+    const targetQueryWithTab = defu(target.query || {}, { __tab: tabInfo })
     const transactionVersion = ++navigationVersion
 
     runNavigationTransaction({
       apply: () => originalPages,
       navigate: () => router.push({ path: target.path, query: targetQueryWithTab }),
-      rollback: (snapshot) => restorePages(stack, snapshot),
+      rollback: (snapshot) => replacePages(tab.id, snapshot),
       isFailureResult: isNavigationFailure,
       isCurrent: () => navigationVersion === transactionVersion,
       commit: () => {
@@ -222,7 +226,7 @@ export default function useTabRouter() {
         }
       },
       cleanupStale: () => {
-        const activePageIds = new Set(stack.list().map((page) => page.id))
+        const activePageIds = new Set(getPages(tab.id).map((page) => page.id))
         for (const id of recyclingBin) {
           if (!activePageIds.has(id)) evictPageCache(id)
         }

package/src/lib/i18n/index.ts

@@ -49,8 +49,8 @@ export const mergeLocaleMessages = (
 }
 
 export default () => {
-  // 引入lang目录下文件
-  // 此处使用了 VITE 的 import.meta.globEager。非 VITE 的 可以使用 require.context
+  // 引入 lang 目录下文件
+  // 非 Vite 构建环境可改用 require.context 替换；当前使用 Vite 原生 glob 即可。
   const modules = import.meta.glob('./lang/*', { eager: true })
 
   /** 从 glob 导入结果中提取语言文件并合并到 msg 对象 */
@@ -58,7 +58,7 @@ export default () => {
     mList: Record<string, { default?: Record<string, unknown> }>,
     msg: Record<string, Record<string, unknown>>
   ) {
-    for (const path in mList) {
+    for (const path of Object.keys(mList)) {
       const mod = mList[path] as { default?: Record<string, unknown> }
       if (mod?.default) {
         const pathName = path.substring(path.lastIndexOf('/') + 1, path.lastIndexOf('.'))

package/src/lib/model/TabModel.ts

@@ -126,7 +126,46 @@ export class Stack<T> {
   }
 
   readonlyList(): readonly T[] {
-    return this.items
+    // 返回浅拷贝避免外部修改内部 items 引用，同时类型为 readonly T[] 提示调用方只读。
+    return [...this.items]
+  }
+
+  /**
+   * 查找首个匹配的元素。
+   * @returns 匹配的元素，未找到返回 undefined。
+   */
+  find(predicate: (element: T, index: number) => boolean): T | undefined {
+    return this.items.find(predicate)
+  }
+
+  /**
+   * 查找首个匹配元素的索引，未找到返回 -1。
+   */
+  findIndex(predicate: (element: T, index: number) => boolean): number {
+    return this.items.findIndex(predicate)
+  }
+
+  /**
+   * 返回所有匹配元素组成的浅拷贝数组。
+   */
+  filter(predicate: (element: T, index: number) => boolean): T[] {
+    return this.items.filter(predicate)
+  }
+
+  /**
+   * 是否存在任意匹配元素。
+   */
+  some(predicate: (element: T, index: number) => boolean): boolean {
+    return this.items.some(predicate)
+  }
+
+  /**
+   * 从顶到底反向遍历每个元素，便于实现「从栈顶开始找」等场景。
+   */
+  forEachTopDown(visit: (element: T, index: number) => void): void {
+    for (let i = this.items.length - 1; i >= 0; i--) {
+      visit(this.items[i] as T, i)
+    }
   }
 
   toJSON(): T[] {

package/src/lib/nuxt/module.ts

@@ -1,10 +1,10 @@
 /**
  * vue-stack-tabs Nuxt 模块。
  *
- * 自动注册客户端插件、注入 composables（useTabActions 等），
- * 并通过 runtimeConfig 传递 locale 配置。
+ * 自动注册客户端插件、注入 composables（useTabActions 等）、
+ * 注册全局组件 <VueStackTabs>，并通过 runtimeConfig 传递 locale 配置。
  */
-import { addPlugin, addImports, createResolver, defineNuxtModule } from 'nuxt/kit'
+import { addComponent, addImports, addPlugin, createResolver, defineNuxtModule } from 'nuxt/kit'
 
 export interface ModuleOptions {
   /** 默认语言 */
@@ -30,6 +30,13 @@ export default defineNuxtModule<ModuleOptions>({
       src: resolve('./runtime/plugin')
     })
 
+    // 自动注册全局组件 <VueStackTabs>，使用方无需在每个页面再 import。
+    addComponent({
+      name: 'VueStackTabs',
+      export: 'VueStackTabs',
+      filePath: resolve('../index.ts')
+    })
+
     addImports([
       { name: 'useTabActions', from: 'vue-stack-tabs' },
       { name: 'useTabRouter', from: 'vue-stack-tabs' },

package/src/lib/nuxt/runtime/plugin.ts

@@ -1,11 +1,22 @@
-/** Nuxt 客户端插件：自动注册 VueStackTabs 并应用 runtimeConfig 中的 locale 配置 */
+/**
+ * Nuxt 客户端插件：自动注册 VueStackTabs 并应用 runtimeConfig 中的 locale 配置。
+ */
 import { defineNuxtPlugin, useRuntimeConfig } from 'nuxt/app'
 import VueStackTabs from 'vue-stack-tabs'
+import { applyStackTabsLocale } from '../../i18n/stackTabsLocale'
+import { useI18n } from 'vue-i18n-lite'
 
 export default defineNuxtPlugin((nuxtApp) => {
   const config = useRuntimeConfig().public.vueStackTabs as {
     locale?: string
   }
+  const locale = config?.locale ?? 'zh-CN'
 
-  nuxtApp.vueApp.use(VueStackTabs, [{ locale: config?.locale ?? 'zh-CN' }])
+  // Vue.use 时把 locale 作为 plugin options 传入，让 i18n 实例按指定 locale 初始化。
+  nuxtApp.vueApp.use(VueStackTabs, [{ locale }])
+
+  // 兜底：应用 vue-stack-tabs 内部 i18n 实例的 locale 切换逻辑，
+  // 避免某些场景下 plugin options 未能正确初始化时 locale 仍是默认 zh-CN。
+  const { changeLocale } = useI18n()
+  applyStackTabsLocale(changeLocale, locale)
 })

package/src/lib/utils/iframeBridge.ts

@@ -53,8 +53,14 @@ export function postOpenTab(
 }
 
 /**
- * 在 iframe 内调用：注册刷新监听，收到父窗口刷新指令时执行 callback
+ * 在 iframe 内调用：注册刷新监听，收到父窗口刷新指令时执行 callback。
+ *
+ * **安全提示**：`options.allowedOrigins` 为空数组（默认值）时**不校验 origin**，
+ * 等同 `targetOrigin: '*'`，任何嵌入此 iframe 的父页面都能触发回调。
+ * 生产环境务必显式传入可信 origin 列表，例如 `['https://app.example.com']`。
+ *
  * @param callback 默认 location.reload()，可自定义
+ * @param options  可选配置，`allowedOrigins` 强烈建议显式传入
  * @returns 取消监听的函数
  */
 export function onRefreshRequest(
@@ -66,6 +72,8 @@ export function onRefreshRequest(
   const allowedOrigins = options.allowedOrigins ?? []
   const handler = (ev: MessageEvent) => {
     if (ev.source !== window.parent) return
+    // allowedOrigins 为空时跳过 origin 校验：刻意保留以便本地调试，
+    // 但必须在文档中向用户强调风险（见上方 JSDoc）。
     if (allowedOrigins.length > 0 && !allowedOrigins.includes(ev.origin)) return
     if (ev.data?.type === MSG_REFRESH) {
       callback()

package/src/lib/utils/scrollUtils.ts

@@ -91,13 +91,46 @@ export const getScrollbarWidth = (function () {
 
 const Z_INDEX_CEILING = 89999
 
-/** 获取指定选择器下元素的最大 z-index + 1，用于最大化时置顶 */
+/**
+ * 缓存条目：保存某选择器下最近一次的最大 z-index 结果。
+ * 在 Z_INDEX_CACHE_TTL 毫秒内的重复请求直接复用，避免反复遍历 DOM。
+ */
+interface ZIndexCacheEntry {
+  value: number
+  timestamp: number
+}
+
+const Z_INDEX_CACHE_TTL = 100
+const zIndexCache = new Map<string, ZIndexCacheEntry>()
+
+/** 在用户主动布局变化后调用，使缓存失效 */
+export const invalidateZIndexCache = (selector?: string): void => {
+  if (selector === undefined) {
+    zIndexCache.clear()
+    return
+  }
+  zIndexCache.delete(selector)
+}
+
+/**
+ * 获取指定选择器下元素的最大 z-index + 1，用于最大化时置顶。
+ * 同一选择器在 Z_INDEX_CACHE_TTL 毫秒内的重复请求会复用上次结果，避免重复 querySelectorAll / getComputedStyle。
+ * 当 DOM 结构发生显著变化时，请调用 invalidateZIndexCache 让缓存失效。
+ */
 export const getMaxZIndex = (key = '.stack-tab__container *'): number => {
+  const now = Date.now()
+  const cached = zIndexCache.get(key)
+  if (cached && now - cached.timestamp < Z_INDEX_CACHE_TTL) {
+    return cached.value
+  }
+
   const elements = document.querySelectorAll(key)
   let max = 0
   for (let i = 0; i < elements.length; i++) {
     const z = +window.getComputedStyle(elements[i]!).zIndex || 0
     if (z < Z_INDEX_CEILING && z > max) max = z
   }
-  return max + 1
+  const value = max + 1
+  zIndexCache.set(key, { value, timestamp: now })
+  return value
 }

package/src/lib/utils/tabInfoEncoder.ts

@@ -20,9 +20,14 @@ interface EncodedTabInfoV1 {
 const MAX_DECODED_TAB_INFO_LENGTH = 2048
 const MAX_ENCODED_TAB_INFO_LENGTH = 4096
 
-const encodeBase64 = (value: string): string => encodeURIComponent(btoa(encodeURIComponent(value)))
-const decodeBase64 = (encoded: string): string =>
-  decodeURIComponent(atob(decodeURIComponent(encoded)))
+/**
+ * 把任意 UTF-8 字符串安全地编码为 base64（避免中文/特殊字符直接 btoa 抛错）。
+ * 使用 encodeURIComponent + unescape 是经典跨浏览器方案，比手动管理 TextEncoder 更简洁。
+ */
+const encodeBase64 = (value: string): string => btoa(unescape(encodeURIComponent(value)))
+
+/** encodeBase64 的逆操作，非合法 base64 时抛错，由调用方 try/catch。 */
+const decodeBase64 = (encoded: string): string => decodeURIComponent(escape(atob(encoded)))
 
 const DEFAULT_TAB_INFO: ITabBase = {
   id: '',
@@ -39,7 +44,7 @@ const toTabInfo = (payload: unknown): ITabBase => {
   if (!isRecord(payload)) return { ...DEFAULT_TAB_INFO }
 
   return {
-    id: typeof payload.id === 'string' ? payload.id : DEFAULT_TAB_INFO.id,
+    id: typeof payload.id === 'string' ? payload.id : undefined,
     title: typeof payload.title === 'string' ? payload.title : DEFAULT_TAB_INFO.title,
     iframe: typeof payload.iframe === 'boolean' ? payload.iframe : DEFAULT_TAB_INFO.iframe,
     closable: typeof payload.closable === 'boolean' ? payload.closable : DEFAULT_TAB_INFO.closable,
@@ -76,13 +81,21 @@ export const encodeTabInfo = (tabData: ITabBase): string => {
 }
 
 export const decodeTabInfo = (encoded: string): ITabBase => {
-  if (encoded.length > MAX_ENCODED_TAB_INFO_LENGTH) return { ...DEFAULT_TAB_INFO }
+  if (typeof encoded !== 'string' || encoded.length > MAX_ENCODED_TAB_INFO_LENGTH) {
+    return { ...DEFAULT_TAB_INFO }
+  }
 
+  let tabString: string
   try {
-    const tabString = decodeBase64(encoded)
-    if (tabString.length > MAX_DECODED_TAB_INFO_LENGTH) return { ...DEFAULT_TAB_INFO }
-    if (!tabString.trim().startsWith('{')) return decodeLegacyTabInfo(tabString)
+    tabString = decodeBase64(encoded)
+  } catch {
+    return { ...DEFAULT_TAB_INFO }
+  }
 
+  if (tabString.length > MAX_DECODED_TAB_INFO_LENGTH) return { ...DEFAULT_TAB_INFO }
+  if (!tabString.trim().startsWith('{')) return decodeLegacyTabInfo(tabString)
+
+  try {
     return toTabInfo(JSON.parse(tabString))
   } catch {
     return { ...DEFAULT_TAB_INFO }

package/src/lib/utils/urlParser.ts

@@ -137,7 +137,9 @@ export function isSameQueryIgnoringReserved(
     const result: Record<string, string | string[]> = {}
     for (const [key, value] of Object.entries(q)) {
       if (STACK_TABS_RESERVED_QUERY_KEYS.has(key) || key === '_back') continue
-      result[key] = Array.isArray(value) ? value.map((item) => String(item ?? '')) : String(value ?? '')
+      result[key] = Array.isArray(value)
+        ? value.map((item) => String(item ?? ''))
+        : String(value ?? '')
     }
     return result
   }

package/src/lib/versionLogger.ts

@@ -1,9 +1,13 @@
 /** 在浏览器控制台输出带样式的库版本标识 */
-const logVersion = (version: string) => {
+const logVersion = (version?: string) => {
   if (typeof window === 'undefined') return
 
+  // 兜底：Vitest / SSR 等环境下 import.meta.env.PACKAGE_VERSION 缺失，
+  // 避免打印出 "vundefined" 这种丑陋的版本号。
+  const displayVersion = typeof version === 'string' && version.length > 0 ? version : 'dev'
+
   window.console.log(
-    '%c vue-stack-tabs %c v' + version + ' %c',
+    '%c vue-stack-tabs %c v' + displayVersion + ' %c',
     'background:#306fff; padding:2px 8px; border-radius:3px 0 0 3px; color:#fff;',
     'background:#00d797; padding:2px 8px; border-radius:0 3px 3px 0; color:#fff;',
     'background:transparent'

package/dist/favicon.svg

@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg id="_图层_1" data-name="图层 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 199.49 199.67">
-  <path d="M79.24,19.73h108.91v29.7h-108.91v-29.7Z" style="fill: #79a7ff; stroke-width: 0px;"/>
-  <path d="M179.24,199.67H20.26C9.05,199.6,0,190.5,0,179.29V20.39C0,9.18,9.05.07,20.26,0h59.49c3.51.07,6.34,2.9,6.41,6.42v44.36c0,3.54-2.87,6.41-6.41,6.41-3.54,0-6.41-2.86-6.42-6.4,0,0,0,0,0,0V12.36H20.25c-4.13.07-7.44,3.44-7.44,7.56v159.41c0,4.13,3.31,7.49,7.44,7.56h158.98c4.13-.07,7.44-3.44,7.44-7.56V51.84c0-3.54,2.87-6.41,6.41-6.42,3.54,0,6.42,2.87,6.42,6.42h0v127.45c0,11.21-9.05,20.32-20.26,20.39h0Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M192.8,60.77c-3.66-.07-6.61-3.02-6.68-6.68v-18.23c.09-4.29-3.32-7.83-7.6-7.92-.05,0-.11,0-.16,0h-96.27c-3.69,0-6.69-2.99-6.69-6.69s2.99-6.69,6.69-6.69h96.27c11.69.08,21.13,9.58,21.13,21.27v18.25c0,3.69-2.99,6.68-6.68,6.68,0,0,0,0,0,0h0Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M193.08,58.67H10.15c-3.61-.08-6.48-3.07-6.41-6.68-.08-3.62,2.79-6.61,6.41-6.69h182.93c3.62.08,6.48,3.08,6.41,6.69.07,3.61-2.79,6.6-6.41,6.68Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M137.2,58.67c-3.42.24-6.4-2.32-6.68-5.74v-28.15c.55-3.69,3.99-6.24,7.69-5.69,2.94.44,5.25,2.75,5.69,5.69v28.15c-.28,3.42-3.26,5.98-6.68,5.74h0Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M99.78,100.48l-12.83-22.22h-18.39l31.22,54.05,31.22-54.05h-18.39l-12.83,22.22Z" style="fill: #00d797; stroke-width: 0px;"/>
-  <path d="M135.28,78.26l-35.49,61.43-35.44-61.43h-20.11l55.55,96.2,55.55-96.2h-20.05Z" style="fill: #306fff; stroke-width: 0px;"/>
-</svg>

package/dist/iframe-bridge.html

@@ -1,77 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Iframe Bridge 测试页面</title>
-    <style>
-      body {
-        font-family: system-ui, sans-serif;
-        padding: 20px;
-        background: #f0f2f5;
-      }
-      .card {
-        background: white;
-        padding: 20px;
-        border-radius: 8px;
-        box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
-      }
-      button {
-        padding: 10px 20px;
-        background: #67c23a;
-        color: white;
-        border: none;
-        border-radius: 4px;
-        cursor: pointer;
-      }
-      .status {
-        margin-top: 10px;
-        color: #606266;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="card">
-      <h2>此页面演示使用封装好的 Bridge 对接方式</h2>
-      <p>页面加载时间: <span id="time"></span></p>
-      <p>
-        使用 <code>iframeBridge.ts</code> 中提供的 <code>postOpenTab</code> 和
-        <code>onRefreshRequest</code>。
-      </p>
-
-      <div style="margin: 20px 0">
-        <button id="btnOpen">使用 Bridge 方法请求打开新 Tab</button>
-      </div>
-      <div class="status" id="status"></div>
-    </div>
-
-    <!-- 注意：在实际项目中，如果是原生 HTML 需要引入编译后的 Bridge 脚本，或者直接使用 type="module" -->
-    <script type="module">
-      // 这里的导入路径仅为本地调试示意，实际推荐将 Bridge 打包为公共库或 CDN 引用
-      import { postOpenTab, onRefreshRequest } from './src/lib/utils/iframeBridge.ts'
-
-      const timeEl = document.getElementById('time')
-      timeEl.innerText = new Date().toLocaleTimeString()
-
-      // 1. 使用 Bridge 封装的方法打开 Tab
-      document.getElementById('btnOpen').onclick = () => {
-        postOpenTab({
-          id: 'bridge_triggered_tab',
-          title: 'Bridge 弹出的新页签',
-          path: '/demo/page1',
-          closable: true
-        })
-      }
-
-      // 2. 使用 Bridge 封装的方法监听刷新请求
-      onRefreshRequest(() => {
-        console.log('[Bridge Child] Received refresh request from parent')
-        const statusEl = document.getElementById('status')
-        statusEl.innerText = '正在执行刷新 logic...'
-        setTimeout(() => {
-          location.reload()
-        }, 500)
-      })
-    </script>
-  </body>
-</html>

package/dist/iframe-child.html

@@ -1,88 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Iframe 子页面测试</title>
-    <style>
-      body {
-        font-family: system-ui, sans-serif;
-        padding: 20px;
-        background: #f0f9eb;
-      }
-      .card {
-        background: white;
-        padding: 20px;
-        border-radius: 8px;
-        box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
-      }
-      button {
-        padding: 10px 20px;
-        background: #409eff;
-        color: white;
-        border: none;
-        border-radius: 4px;
-        cursor: pointer;
-      }
-      input {
-        padding: 8px;
-        width: 200px;
-        margin-right: 10px;
-        border: 1px solid #dcdfe6;
-        border-radius: 4px;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="card">
-      <h2>此页面运行在隔离的 iframe 中</h2>
-      <p>页面加载时间: <span id="time"></span></p>
-      <p>
-        用于测试 iframe 页面的加载、刷新隔离，以及通过 `postMessage` 向外层通信请求打开新 Tab
-        的功能。
-      </p>
-
-      <div style="margin: 20px 0">
-        <label>隔离缓存测试输入框：</label>
-        <input type="text" id="ipt" placeholder="切走该页签是否会销毁内容？" />
-      </div>
-
-      <div style="margin: 20px 0">
-        <button onclick="requestNewTab()">向父级发送 postMessage 请求在外部打开新 Tab</button>
-      </div>
-    </div>
-
-    <script>
-      const timeEl = document.getElementById('time')
-      const updateTime = () => {
-        timeEl.innerText = new Date().toLocaleTimeString()
-      }
-      updateTime()
-
-      // 1. 原生对接：向父窗口请求打开新标签
-      function requestNewTab() {
-        window.parent.postMessage(
-          {
-            type: 'vue-stack-tabs:openTab', // 推荐使用该标准类型，StackTabs 已支持兼容 'openTab'
-            payload: {
-              id: 'native_triggered_tab',
-              title: '原生弹出的新页签',
-              path: '/demo/page2',
-              closable: true
-            }
-          },
-          '*'
-        )
-      }
-
-      // 2. 原生对接：监听父窗口发送的刷新请求
-      window.addEventListener('message', (ev) => {
-        if (ev.data?.type === 'vue-stack-tabs:refresh') {
-          console.log('[Native Child] Received refresh request from parent')
-          // 执行刷新逻辑（例如重新加载页面或局部数据更新）
-          location.reload()
-        }
-      })
-    </script>
-  </body>
-</html>

package/dist/nuxt/favicon.svg

@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg id="_图层_1" data-name="图层 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 199.49 199.67">
-  <path d="M79.24,19.73h108.91v29.7h-108.91v-29.7Z" style="fill: #79a7ff; stroke-width: 0px;"/>
-  <path d="M179.24,199.67H20.26C9.05,199.6,0,190.5,0,179.29V20.39C0,9.18,9.05.07,20.26,0h59.49c3.51.07,6.34,2.9,6.41,6.42v44.36c0,3.54-2.87,6.41-6.41,6.41-3.54,0-6.41-2.86-6.42-6.4,0,0,0,0,0,0V12.36H20.25c-4.13.07-7.44,3.44-7.44,7.56v159.41c0,4.13,3.31,7.49,7.44,7.56h158.98c4.13-.07,7.44-3.44,7.44-7.56V51.84c0-3.54,2.87-6.41,6.41-6.42,3.54,0,6.42,2.87,6.42,6.42h0v127.45c0,11.21-9.05,20.32-20.26,20.39h0Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M192.8,60.77c-3.66-.07-6.61-3.02-6.68-6.68v-18.23c.09-4.29-3.32-7.83-7.6-7.92-.05,0-.11,0-.16,0h-96.27c-3.69,0-6.69-2.99-6.69-6.69s2.99-6.69,6.69-6.69h96.27c11.69.08,21.13,9.58,21.13,21.27v18.25c0,3.69-2.99,6.68-6.68,6.68,0,0,0,0,0,0h0Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M193.08,58.67H10.15c-3.61-.08-6.48-3.07-6.41-6.68-.08-3.62,2.79-6.61,6.41-6.69h182.93c3.62.08,6.48,3.08,6.41,6.69.07,3.61-2.79,6.6-6.41,6.68Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M137.2,58.67c-3.42.24-6.4-2.32-6.68-5.74v-28.15c.55-3.69,3.99-6.24,7.69-5.69,2.94.44,5.25,2.75,5.69,5.69v28.15c-.28,3.42-3.26,5.98-6.68,5.74h0Z" style="fill: #377dff; stroke-width: 0px;"/>
-  <path d="M99.78,100.48l-12.83-22.22h-18.39l31.22,54.05,31.22-54.05h-18.39l-12.83,22.22Z" style="fill: #00d797; stroke-width: 0px;"/>
-  <path d="M135.28,78.26l-35.49,61.43-35.44-61.43h-20.11l55.55,96.2,55.55-96.2h-20.05Z" style="fill: #306fff; stroke-width: 0px;"/>
-</svg>