@zat-design/sisyphus-react 4.5.9 → 4.5.10-beta.2

package/es/ProLayout/components/TabsManager/hooks/useTabsState.js

@@ -1,269 +1,247 @@
-import { useState, useCallback, useEffect, useRef } from 'react';
-import { message } from 'antd';
+import { useState, useCallback, useEffect, useRef } from "react";
+import { message } from "antd";
 import { DEFAULT_TABS_CONFIG } from "../propTypes";
 import { useTabsCache } from "./useTabsCache";
 import locale, { formatMessage } from "../../../../locale";
-import { createTabFromMenu, generateTabId, shouldOpenExternal, handleExternalOpen, checkTabLimit, getRightTabs, flattenMenuData, canOpenAsTab, getMenuRoute, findExistingTab, resolveTabMenuItem, derivePinned, getPinnedBoundary, pinTab as pinTabInList, unpinTab as unpinTabInList, reorderWithPinConstraint } from "../utils";
-
-/**
- * 标签页状态管理Hook
- */
-export const useTabsState = options => {
-  const {
-    initialState = {},
-    config,
-    dataSource,
-    cacheEnabled = true
-  } = options;
-
-  // 合并默认配置
-  const finalConfig = {
-    ...DEFAULT_TABS_CONFIG,
-    ...config
-  };
-
-  // 初始化状态
+import {
+  createTabFromMenu,
+  generateTabId,
+  shouldOpenExternal,
+  handleExternalOpen,
+  checkTabLimit,
+  getRightTabs,
+  flattenMenuData,
+  canOpenAsTab,
+  getMenuRoute,
+  findExistingTab,
+  normalizeTabUrl,
+  isSafeExternalUrl,
+  isSafeHttpUrl,
+  resolveTabMenuItem,
+  derivePinned,
+  getPinnedBoundary,
+  pinTab as pinTabInList,
+  unpinTab as unpinTabInList,
+  reorderWithPinConstraint
+} from "../utils";
+const useTabsState = (options) => {
+  const { initialState = {}, config, dataSource, cacheEnabled = true } = options;
+  const finalConfig = { ...DEFAULT_TABS_CONFIG, ...config };
+  const urlSyncEnabled = finalConfig.urlSync === true || typeof finalConfig.urlSync === "object" && finalConfig.urlSync !== null;
   const [state, setState] = useState(() => ({
     tabsList: [],
-    activeKey: '',
-    activeTabInfo: undefined,
+    activeKey: "",
+    activeTabInfo: void 0,
     newTabIndex: 0,
-    activeComponent: '',
+    activeComponent: "",
     ...initialState
   }));
-
-  // 缓存管理
-  const {
-    saveToCache,
-    restoreFromCache,
-    clearCache
-  } = useTabsCache({
+  const { saveToCache, restoreFromCache, clearCache } = useTabsCache({
     cacheKey: finalConfig.cacheKey,
     storage: finalConfig.storage,
     enabled: cacheEnabled
   });
-
-  // 初始化标记，确保只在初始化后保存缓存
   const [isInitialized, setIsInitialized] = useState(false);
-
-  // 从缓存恢复状态
+  const hasRestoredCacheRef = useRef(false);
   useEffect(() => {
+    var _a, _b;
+    if (hasRestoredCacheRef.current)
+      return;
+    hasRestoredCacheRef.current = true;
     const cachedState = restoreFromCache();
     if (cachedState && cachedState.tabsList && cachedState.tabsList.length > 0) {
-      // 兼容旧缓存：如果缓存中有 activeTab 但没有 activeTabInfo，进行迁移
-      const restoredState = {
-        ...cachedState
-      };
-      if ('activeTab' in restoredState && !restoredState.activeTabInfo) {
+      const restoredState = { ...cachedState };
+      if ("activeTab" in restoredState && !restoredState.activeTabInfo) {
         restoredState.activeTabInfo = restoredState.activeTab;
         delete restoredState.activeTab;
       }
-
-      // 兼容旧缓存：Ant Tabs 的 onChange 始终返回字符串 key；旧版本可能保存数字 id，
-      // 若不归一化，严格比较会导致恢复后的标签无法切换。
-      restoredState.tabsList = restoredState.tabsList.map(tab => ({
+      restoredState.tabsList = restoredState.tabsList.map((tab) => ({
         ...tab,
         id: String(tab.id),
-        pinned: tab.pinned === undefined ? derivePinned(tab) : tab.pinned
+        pinned: tab.pinned === void 0 ? derivePinned(tab) : tab.pinned
       }));
-      restoredState.activeKey = restoredState.activeKey === undefined || restoredState.activeKey === null ? '' : String(restoredState.activeKey);
-      restoredState.activeTabInfo = restoredState.tabsList.find(tab => tab.id === restoredState.activeKey);
+      restoredState.activeKey = restoredState.activeKey === void 0 || restoredState.activeKey === null ? "" : String(restoredState.activeKey);
+      if (urlSyncEnabled) {
+        const retainedTabByUrl = /* @__PURE__ */ new Map();
+        const retainedIdByOriginalId = /* @__PURE__ */ new Map();
+        restoredState.tabsList.forEach((tab) => {
+          const normalizedUrl = normalizeTabUrl(tab.url);
+          if (!normalizedUrl)
+            return;
+          const retainedTab = retainedTabByUrl.get(normalizedUrl);
+          if (retainedTab) {
+            retainedIdByOriginalId.set(tab.id, retainedTab.id);
+            return;
+          }
+          const normalizedTab = { ...tab, url: normalizedUrl };
+          retainedTabByUrl.set(normalizedUrl, normalizedTab);
+          retainedIdByOriginalId.set(tab.id, normalizedTab.id);
+        });
+        restoredState.tabsList = Array.from(retainedTabByUrl.values());
+        restoredState.activeKey = retainedIdByOriginalId.get(restoredState.activeKey) || ((_a = restoredState.tabsList[0]) == null ? void 0 : _a.id) || "";
+      }
+      restoredState.activeTabInfo = restoredState.tabsList.find(
+        (tab) => tab.id === restoredState.activeKey
+      );
+      restoredState.activeComponent = restoredState.activeTabInfo ? ((_b = restoredState.activeTabInfo.menuItem) == null ? void 0 : _b.code) || restoredState.activeTabInfo.id : "";
       setState(restoredState);
     }
     setIsInitialized(true);
-  }, [restoreFromCache]);
-  const lastActiveKeyRef = useRef('');
+  }, [restoreFromCache, urlSyncEnabled]);
+  const lastActiveKeyRef = useRef("");
   const shouldSkipSaveRef = useRef(false);
   const initialTabsAppliedRef = useRef(false);
-
-  // 保存状态到缓存
   useEffect(() => {
-    if (!isInitialized) return;
-
-    // 如果标记了跳过保存（清空缓存后），则跳过本次保存
+    if (!isInitialized)
+      return;
     if (shouldSkipSaveRef.current) {
       shouldSkipSaveRef.current = false;
       return;
     }
-
-    // 处理 onTabChange 调用 - 支持空状态和正常切换
     if (finalConfig.onTabChange && lastActiveKeyRef.current !== state.activeKey) {
       lastActiveKeyRef.current = state.activeKey;
       if (state.activeKey) {
-        // 正常的标签页切换
-        const activeTab = state.tabsList.find(tab => tab.id === state.activeKey);
+        const activeTab = state.tabsList.find((tab) => tab.id === state.activeKey);
         if (activeTab) {
           finalConfig.onTabChange(state.activeKey, activeTab, state.tabsList);
         }
       } else {
-        // 空状态 - 所有标签页都被关闭
-        finalConfig.onTabChange('', undefined, state.tabsList);
+        finalConfig.onTabChange("", void 0, state.tabsList);
       }
     }
-
-    // 如果 tabsList 为空且 activeKey 为空，说明是清空状态，不保存缓存
     if (state.tabsList.length === 0 && !state.activeKey) {
       return;
     }
-
-    // 保存状态到缓存
     saveToCache(state);
   }, [state, saveToCache, finalConfig, isInitialized]);
-
-  /**
-   * 检查是否可以添加标签页（用于在菜单点击时判断是否应该激活菜单）
-   */
-  const canAddTab = useCallback((menuItem, options) => {
-    const {
-      forceNew = false
-    } = options || {};
-
-    // 非叶子节点默认不入签，仅根节点特例可入签
-    if (!canOpenAsTab(menuItem)) {
-      return false;
-    }
-
-    // 检查是否需要外部跳转
-    if (shouldOpenExternal(menuItem)) {
-      return false;
-    }
-
-    // 如果 forceNew = false（默认），检查是否已存在相同的标签页
-    if (!forceNew) {
-      const existingTab = findExistingTab(state.tabsList, menuItem);
-      if (existingTab) {
-        // 如果已存在，可以添加（会切换到已存在的标签页）
-        return true;
+  const canAddTab = useCallback(
+    (menuItem, options2) => {
+      const { forceNew = false } = options2 || {};
+      if (!canOpenAsTab(menuItem)) {
+        return false;
       }
-    }
-
-    // 检查是否超出限制（只有在需要创建新标签页时才检查）
-    if (checkTabLimit(state.tabsList, finalConfig.max)) {
-      // 达到最大值时，不能添加新标签页
-      return false;
-    }
-    return true;
-  }, [state.tabsList, finalConfig]);
-
-  /**
-   * 添加标签页
-   */
-  const addTab = useCallback((menuItem, options) => {
-    const {
-      forceNew = false,
-      silent = false
-    } = options || {};
-    setState(prevState => {
-      if (!canOpenAsTab(menuItem)) return prevState;
       if (shouldOpenExternal(menuItem)) {
-        handleExternalOpen(menuItem);
-        return prevState;
+        return false;
       }
-
-      // 非强制新建时，查找已存在的标签页并切换
-      const existingTab = !forceNew ? findExistingTab(prevState.tabsList, menuItem) : undefined;
-      if (existingTab) {
-        // 若来源菜单明确标记 closable: false 而已有 tab 未继承，则修正
-        const correctedTab = menuItem.closable === false && existingTab.closable !== false ? {
-          ...existingTab,
-          closable: false
-        } : existingTab;
-        const updatedTabsList = correctedTab !== existingTab ? prevState.tabsList.map(t => t.id === existingTab.id ? correctedTab : t) : prevState.tabsList;
+      if (urlSyncEnabled || !forceNew) {
+        const existingTab = findExistingTab(state.tabsList, menuItem, {
+          urlSync: urlSyncEnabled
+        });
+        if (existingTab) {
+          return true;
+        }
+      }
+      if (checkTabLimit(state.tabsList, finalConfig.max)) {
+        return false;
+      }
+      return true;
+    },
+    [state.tabsList, finalConfig, urlSyncEnabled]
+  );
+  const addTab = useCallback(
+    (menuItem, options2) => {
+      const { forceNew = false, silent = false } = options2 || {};
+      setState((prevState) => {
+        var _a;
+        if (!canOpenAsTab(menuItem))
+          return prevState;
+        if (shouldOpenExternal(menuItem)) {
+          const externalUrl = getMenuRoute(menuItem);
+          if (!urlSyncEnabled || isSafeHttpUrl(externalUrl)) {
+            handleExternalOpen(menuItem, urlSyncEnabled);
+          }
+          return prevState;
+        }
+        const rawUrl = getMenuRoute(menuItem);
+        const normalizedUrl = urlSyncEnabled ? normalizeTabUrl(rawUrl) : void 0;
+        if (urlSyncEnabled && rawUrl && !normalizedUrl) {
+          if (isSafeExternalUrl(rawUrl)) {
+            handleExternalOpen(menuItem, true);
+          }
+          return prevState;
+        }
+        const resolvedMenuItem = normalizedUrl ? { ...menuItem, url: normalizedUrl, redirectUrl: void 0 } : menuItem;
+        const existingTab = urlSyncEnabled || !forceNew ? findExistingTab(prevState.tabsList, resolvedMenuItem, { urlSync: urlSyncEnabled }) : void 0;
+        if (existingTab) {
+          const correctedTab = resolvedMenuItem.closable === false && existingTab.closable !== false ? { ...existingTab, closable: false } : existingTab;
+          const updatedTabsList = correctedTab !== existingTab ? prevState.tabsList.map((t) => t.id === existingTab.id ? correctedTab : t) : prevState.tabsList;
+          return {
+            ...prevState,
+            tabsList: updatedTabsList,
+            activeKey: existingTab.id,
+            activeTabInfo: correctedTab,
+            activeComponent: ((_a = existingTab.menuItem) == null ? void 0 : _a.code) || existingTab.id
+          };
+        }
+        if (checkTabLimit(prevState.tabsList, finalConfig.max)) {
+          message.info(
+            formatMessage(locale.ProLayout.tabMaxLimitMessage, { max: finalConfig.max })
+          );
+          return prevState;
+        }
+        const existingIds = prevState.tabsList.map((tab) => tab.id);
+        const tabId = generateTabId(resolvedMenuItem, existingIds);
+        const newTab = createTabFromMenu(resolvedMenuItem, prevState.newTabIndex);
+        newTab.id = tabId;
+        const pinnedBoundary = getPinnedBoundary(prevState.tabsList);
+        const nextTabsList = derivePinned(newTab) ? [
+          ...prevState.tabsList.slice(0, pinnedBoundary),
+          newTab,
+          ...prevState.tabsList.slice(pinnedBoundary)
+        ] : [...prevState.tabsList, newTab];
+        const shouldActivate = !silent || prevState.activeKey === "";
         return {
           ...prevState,
-          tabsList: updatedTabsList,
-          activeKey: existingTab.id,
-          activeTabInfo: correctedTab,
-          activeComponent: existingTab.menuItem?.code || existingTab.id
+          tabsList: nextTabsList,
+          activeKey: shouldActivate ? tabId : prevState.activeKey,
+          activeTabInfo: shouldActivate ? newTab : prevState.activeTabInfo,
+          newTabIndex: prevState.newTabIndex + 1,
+          activeComponent: shouldActivate ? resolvedMenuItem.code || tabId : prevState.activeComponent
         };
-      }
-      if (checkTabLimit(prevState.tabsList, finalConfig.max)) {
-        message.info(formatMessage(locale.ProLayout.tabMaxLimitMessage, {
-          max: finalConfig.max
-        }));
-        return prevState;
-      }
-      const existingIds = prevState.tabsList.map(tab => tab.id);
-      const tabId = generateTabId(menuItem, existingIds);
-      const newTab = createTabFromMenu(menuItem, prevState.newTabIndex);
-      newTab.id = tabId;
-      const pinnedBoundary = getPinnedBoundary(prevState.tabsList);
-      const nextTabsList = derivePinned(newTab) ? [...prevState.tabsList.slice(0, pinnedBoundary), newTab, ...prevState.tabsList.slice(pinnedBoundary)] : [...prevState.tabsList, newTab];
-
-      // silent=true 时,若已有 active 则保留;无 active(首次进入)仍激活以保留默认行为
-      const shouldActivate = !silent || prevState.activeKey === '';
-      return {
-        ...prevState,
-        tabsList: nextTabsList,
-        activeKey: shouldActivate ? tabId : prevState.activeKey,
-        activeTabInfo: shouldActivate ? newTab : prevState.activeTabInfo,
-        newTabIndex: prevState.newTabIndex + 1,
-        activeComponent: shouldActivate ? menuItem.code || tabId : prevState.activeComponent
-      };
-    });
-  }, [finalConfig]);
-
-  // 普通初始标签只在当前 TabsManager 挂载周期应用一次。
-  // 缓存恢复已有标签时只消费默认值；closeAll 后 ref 保持 true，避免再次补签。
+      });
+    },
+    [finalConfig, urlSyncEnabled]
+  );
   useEffect(() => {
     const initialTabs = finalConfig.initialTabs;
     if (!isInitialized || !cacheEnabled || initialTabsAppliedRef.current || !initialTabs || initialTabs.length === 0) {
       return;
     }
     initialTabsAppliedRef.current = true;
-    if (state.tabsList.length > 0) return;
-    const sourceMenus = Array.isArray(dataSource?.menus) ? dataSource.menus : [];
-    initialTabs.forEach(params => {
-      addTab(resolveTabMenuItem(params, sourceMenus), {
-        silent: true
-      });
+    if (state.tabsList.length > 0)
+      return;
+    const sourceMenus = Array.isArray(dataSource == null ? void 0 : dataSource.menus) ? dataSource.menus : [];
+    initialTabs.forEach((params) => {
+      addTab(resolveTabMenuItem(params, sourceMenus), { silent: true });
     });
-  }, [isInitialized, cacheEnabled, finalConfig.initialTabs, dataSource, state.tabsList.length, addTab]);
-
-  /**
-   * 更新已存在标签页的展示信息（保持 tab.id 不变 → 子组件不会 unmount）
-   * - 仅允许更新 name / icon / extra / closable
-   * - extra 为替换语义（直接覆盖原 extra）
-   * - tabId 不存在时 no-op
-   */
+  }, [
+    isInitialized,
+    cacheEnabled,
+    finalConfig.initialTabs,
+    dataSource,
+    state.tabsList.length,
+    addTab
+  ]);
   const updateTab = useCallback((tabId, updates) => {
-    setState(prevState => {
-      const targetIndex = prevState.tabsList.findIndex(tab => tab.id === tabId);
-      if (targetIndex === -1) return prevState;
+    setState((prevState) => {
+      const targetIndex = prevState.tabsList.findIndex((tab) => tab.id === tabId);
+      if (targetIndex === -1)
+        return prevState;
       const target = prevState.tabsList[targetIndex];
       const nextMenuItem = target.menuItem ? {
         ...target.menuItem,
-        ...(updates.name !== undefined && {
-          name: updates.name
-        }),
-        ...(updates.icon !== undefined && {
-          icon: updates.icon
-        }),
-        ...(updates.extra !== undefined && {
-          extra: updates.extra
-        }),
-        ...(updates.closable !== undefined && {
-          closable: updates.closable
-        }),
-        ...(updates.pinned !== undefined && {
-          pinned: updates.pinned
-        })
+        ...updates.name !== void 0 && { name: updates.name },
+        ...updates.icon !== void 0 && { icon: updates.icon },
+        ...updates.extra !== void 0 && { extra: updates.extra },
+        ...updates.closable !== void 0 && { closable: updates.closable },
+        ...updates.pinned !== void 0 && { pinned: updates.pinned }
       } : target.menuItem;
       const nextTab = {
         ...target,
-        ...(updates.name !== undefined && {
-          name: updates.name,
-          title: updates.name
-        }),
-        ...(updates.icon !== undefined && {
-          icon: updates.icon
-        }),
-        ...(updates.closable !== undefined && {
-          closable: updates.closable
-        }),
-        ...(updates.pinned !== undefined && {
-          pinned: updates.pinned
-        }),
+        ...updates.name !== void 0 && { name: updates.name, title: updates.name },
+        ...updates.icon !== void 0 && { icon: updates.icon },
+        ...updates.closable !== void 0 && { closable: updates.closable },
+        ...updates.pinned !== void 0 && { pinned: updates.pinned },
         menuItem: nextMenuItem
       };
       const newTabsList = [...prevState.tabsList];
@@ -275,222 +253,209 @@ export const useTabsState = options => {
       };
     });
   }, []);
-
-  /**
-   * 移除标签页
-   */
-  const removeTab = useCallback(tabId => {
-    setState(prevState => {
-      const tabToRemove = prevState.tabsList.find(tab => tab.id === tabId);
-      if (!tabToRemove || !tabToRemove.closable) {
-        return prevState;
-      }
-      const newTabs = prevState.tabsList.filter(tab => tab.id !== tabId);
-      let newActiveKey = prevState.activeKey;
-      let newActiveTabInfo = prevState.activeTabInfo;
-      let newActiveComponent = prevState.activeComponent;
-
-      // 如果移除的是当前活跃标签页，需要选择新的活跃标签页
-      if (prevState.activeKey === tabId && newTabs.length > 0) {
-        const currentIndex = prevState.tabsList.findIndex(tab => tab.id === tabId);
-        const newActiveIndex = Math.min(currentIndex, newTabs.length - 1);
-        newActiveTabInfo = newTabs[newActiveIndex];
-        newActiveKey = newActiveTabInfo.id;
-        newActiveComponent = newActiveTabInfo.menuItem?.code || newActiveTabInfo.id;
-      } else if (prevState.activeKey === tabId) {
-        // 如果删除后没有标签页了
-        newActiveKey = '';
-        newActiveTabInfo = undefined;
-        newActiveComponent = '';
-      }
-
-      // 如果删除后没有标签页了，清空缓存
-      if (newTabs.length === 0) {
-        // 标记跳过下次保存，避免清空后又被重新保存
-        shouldSkipSaveRef.current = true;
-        clearCache();
-
-        // 直接调用 onTabChange，因为 useEffect 会被跳过
-        if (finalConfig.onTabChange) {
-          setTimeout(() => {
-            finalConfig.onTabChange('', undefined, []);
-          }, 0);
+  const removeTab = useCallback(
+    (tabId) => {
+      setState((prevState) => {
+        var _a;
+        const tabToRemove = prevState.tabsList.find((tab) => tab.id === tabId);
+        if (!tabToRemove || !tabToRemove.closable) {
+          return prevState;
         }
-      }
-      return {
-        ...prevState,
-        tabsList: newTabs,
-        activeKey: newActiveKey,
-        activeTabInfo: newActiveTabInfo,
-        activeComponent: newActiveComponent
-      };
-    });
-  }, [clearCache, finalConfig]);
-
-  /**
-   * 切换标签页
-   */
-  const switchTab = useCallback(tabId => {
-    setState(prevState => {
-      const targetTab = prevState.tabsList.find(tab => tab.id === tabId);
-      if (!targetTab) return prevState;
+        const newTabs = prevState.tabsList.filter((tab) => tab.id !== tabId);
+        let newActiveKey = prevState.activeKey;
+        let newActiveTabInfo = prevState.activeTabInfo;
+        let newActiveComponent = prevState.activeComponent;
+        if (prevState.activeKey === tabId && newTabs.length > 0) {
+          const currentIndex = prevState.tabsList.findIndex((tab) => tab.id === tabId);
+          const newActiveIndex = Math.min(currentIndex, newTabs.length - 1);
+          newActiveTabInfo = newTabs[newActiveIndex];
+          newActiveKey = newActiveTabInfo.id;
+          newActiveComponent = ((_a = newActiveTabInfo.menuItem) == null ? void 0 : _a.code) || newActiveTabInfo.id;
+        } else if (prevState.activeKey === tabId) {
+          newActiveKey = "";
+          newActiveTabInfo = void 0;
+          newActiveComponent = "";
+        }
+        if (newTabs.length === 0) {
+          shouldSkipSaveRef.current = true;
+          clearCache();
+          if (finalConfig.onTabChange) {
+            setTimeout(() => {
+              finalConfig.onTabChange("", void 0, []);
+            }, 0);
+          }
+        }
+        return {
+          ...prevState,
+          tabsList: newTabs,
+          activeKey: newActiveKey,
+          activeTabInfo: newActiveTabInfo,
+          activeComponent: newActiveComponent
+        };
+      });
+    },
+    [clearCache, finalConfig]
+  );
+  const switchTab = useCallback((tabId) => {
+    setState((prevState) => {
+      var _a;
+      const targetTab = prevState.tabsList.find((tab) => tab.id === tabId);
+      if (!targetTab)
+        return prevState;
       const newState = {
         ...prevState,
         activeKey: tabId,
         activeTabInfo: targetTab,
-        activeComponent: targetTab.menuItem?.code || tabId
+        activeComponent: ((_a = targetTab.menuItem) == null ? void 0 : _a.code) || tabId
       };
       return newState;
     });
   }, []);
-
-  /**
-   * 关闭其他标签页
-   */
-  const closeOtherTabs = useCallback(currentTabId => {
-    setState(prevState => {
-      const currentTab = prevState.tabsList.find(tab => tab.id === currentTabId);
-      if (!currentTab) return prevState;
-
-      // 只保留当前标签页和不可关闭的标签页
-      const newTabs = prevState.tabsList.filter(tab => tab.id === currentTabId || !tab.closable);
+  const rollbackTabActivation = useCallback(
+    (previousTabId, attemptedTabId, removeAttemptedTab) => {
+      setState((prevState) => {
+        var _a;
+        if (prevState.activeKey !== attemptedTabId)
+          return prevState;
+        const nextTabsList = removeAttemptedTab ? prevState.tabsList.filter((tab) => tab.id !== attemptedTabId) : prevState.tabsList;
+        const previousTab = nextTabsList.find((tab) => tab.id === previousTabId);
+        return {
+          ...prevState,
+          tabsList: nextTabsList,
+          activeKey: (previousTab == null ? void 0 : previousTab.id) || "",
+          activeTabInfo: previousTab,
+          activeComponent: previousTab ? ((_a = previousTab.menuItem) == null ? void 0 : _a.code) || previousTab.id : ""
+        };
+      });
+    },
+    []
+  );
+  const updateTabUrl = useCallback((tabId, url) => {
+    setState((prevState) => {
+      const targetIndex = prevState.tabsList.findIndex((tab) => tab.id === tabId);
+      if (targetIndex === -1 || prevState.tabsList[targetIndex].url === url)
+        return prevState;
+      const nextTab = { ...prevState.tabsList[targetIndex], url };
+      const nextTabsList = [...prevState.tabsList];
+      nextTabsList[targetIndex] = nextTab;
+      return {
+        ...prevState,
+        tabsList: nextTabsList,
+        activeTabInfo: prevState.activeKey === tabId ? nextTab : prevState.activeTabInfo
+      };
+    });
+  }, []);
+  const closeOtherTabs = useCallback((currentTabId) => {
+    setState((prevState) => {
+      var _a;
+      const currentTab = prevState.tabsList.find((tab) => tab.id === currentTabId);
+      if (!currentTab)
+        return prevState;
+      const newTabs = prevState.tabsList.filter((tab) => tab.id === currentTabId || !tab.closable);
       return {
         ...prevState,
         tabsList: newTabs,
         activeKey: currentTabId,
         activeTabInfo: currentTab,
-        activeComponent: currentTab.menuItem?.code || currentTabId
+        activeComponent: ((_a = currentTab.menuItem) == null ? void 0 : _a.code) || currentTabId
       };
     });
   }, []);
-
-  /**
-   * 关闭右侧标签页
-   */
-  const closeRightTabs = useCallback(currentTabId => {
-    setState(prevState => {
+  const closeRightTabs = useCallback((currentTabId) => {
+    setState((prevState) => {
       const rightTabs = getRightTabs(prevState.tabsList, currentTabId);
-      const tabsToKeep = prevState.tabsList.filter(tab => !rightTabs.includes(tab) || !tab.closable);
+      const tabsToKeep = prevState.tabsList.filter(
+        (tab) => !rightTabs.includes(tab) || !tab.closable
+      );
       return {
         ...prevState,
         tabsList: tabsToKeep
       };
     });
   }, []);
-
-  /**
-   * 关闭全部标签页
-   */
   const closeAllTabs = useCallback(() => {
-    setState(prevState => {
-      // 只保留不可关闭的标签页
-      const newTabs = prevState.tabsList.filter(tab => !tab.closable);
-      let newActiveKey = '';
-      let newActiveComponent = '';
+    setState((prevState) => {
+      var _a;
+      const newTabs = prevState.tabsList.filter((tab) => !tab.closable);
+      let newActiveKey = "";
+      let newActiveComponent = "";
       if (newTabs.length > 0) {
         const firstTab = newTabs[0];
         newActiveKey = firstTab.id;
-        newActiveComponent = firstTab.menuItem?.code || firstTab.id;
+        newActiveComponent = ((_a = firstTab.menuItem) == null ? void 0 : _a.code) || firstTab.id;
       }
-
-      // 关闭全部标签页时，清空缓存
-      // 标记跳过下次保存，避免清空后又被重新保存
       shouldSkipSaveRef.current = true;
       clearCache();
-
-      // 直接调用 onTabChange（useEffect 因 shouldSkipSaveRef 会跳过）
       if (finalConfig.onTabChange) {
-        const firstTab = newTabs.length > 0 ? newTabs[0] : undefined;
+        const firstTab = newTabs.length > 0 ? newTabs[0] : void 0;
         setTimeout(() => {
-          finalConfig.onTabChange(firstTab?.id ?? '', firstTab, newTabs);
+          finalConfig.onTabChange((firstTab == null ? void 0 : firstTab.id) ?? "", firstTab, newTabs);
         }, 0);
       }
       return {
         ...prevState,
         tabsList: newTabs,
         activeKey: newActiveKey,
-        activeTabInfo: newTabs.length > 0 ? newTabs[0] : undefined,
+        activeTabInfo: newTabs.length > 0 ? newTabs[0] : void 0,
         activeComponent: newActiveComponent
       };
     });
   }, [clearCache, finalConfig]);
-
-  /**
-   * 重排标签页顺序（拖拽结束后调用）
-   * 应用固定分区约束：普通标签不可拖入固定区、固定标签不可拖出固定区
-   */
   const reorderTabs = useCallback((activeId, overId) => {
-    setState(prevState => {
+    setState((prevState) => {
       const nextTabsList = reorderWithPinConstraint(prevState.tabsList, activeId, overId);
-      if (nextTabsList === prevState.tabsList) return prevState;
-      return {
-        ...prevState,
-        tabsList: nextTabsList
-      };
+      if (nextTabsList === prevState.tabsList)
+        return prevState;
+      return { ...prevState, tabsList: nextTabsList };
     });
   }, []);
-
-  /**
-   * 固定标签页：设为 pinned/不可关闭并移动到固定区末尾
-   */
-  const pinTab = useCallback(tabId => {
-    setState(prevState => {
+  const pinTab = useCallback((tabId) => {
+    setState((prevState) => {
       const nextTabsList = pinTabInList(prevState.tabsList, tabId);
-      if (nextTabsList === prevState.tabsList) return prevState;
-      const nextActiveTabInfo = prevState.activeKey === tabId ? nextTabsList.find(tab => tab.id === tabId) : prevState.activeTabInfo;
-      return {
-        ...prevState,
-        tabsList: nextTabsList,
-        activeTabInfo: nextActiveTabInfo
-      };
+      if (nextTabsList === prevState.tabsList)
+        return prevState;
+      const nextActiveTabInfo = prevState.activeKey === tabId ? nextTabsList.find((tab) => tab.id === tabId) : prevState.activeTabInfo;
+      return { ...prevState, tabsList: nextTabsList, activeTabInfo: nextActiveTabInfo };
     });
   }, []);
-
-  /**
-   * 取消固定标签页：设为可关闭并移动到普通区最前
-   */
-  const unpinTab = useCallback(tabId => {
-    setState(prevState => {
+  const unpinTab = useCallback((tabId) => {
+    setState((prevState) => {
       const nextTabsList = unpinTabInList(prevState.tabsList, tabId);
-      if (nextTabsList === prevState.tabsList) return prevState;
-      const nextActiveTabInfo = prevState.activeKey === tabId ? nextTabsList.find(tab => tab.id === tabId) : prevState.activeTabInfo;
-      return {
-        ...prevState,
-        tabsList: nextTabsList,
-        activeTabInfo: nextActiveTabInfo
-      };
+      if (nextTabsList === prevState.tabsList)
+        return prevState;
+      const nextActiveTabInfo = prevState.activeKey === tabId ? nextTabsList.find((tab) => tab.id === tabId) : prevState.activeTabInfo;
+      return { ...prevState, tabsList: nextTabsList, activeTabInfo: nextActiveTabInfo };
     });
   }, []);
-
-  /**
-   * 重置状态
-   */
   const resetTabs = useCallback(() => {
     setState({
       tabsList: [],
-      activeKey: '',
+      activeKey: "",
       newTabIndex: 0,
-      activeComponent: ''
+      activeComponent: ""
     });
   }, []);
-
-  // 监听 URL 变化并同步 Tabs (仅在初始化和 location 变化时)
-  // 放在最后以确保可以使用 addTab 和 switchTab
   useEffect(() => {
-    if (!dataSource || !('menus' in dataSource)) return;
+    if (urlSyncEnabled)
+      return;
+    if (!dataSource || !("menus" in dataSource))
+      return;
     const currentPath = window.location.pathname;
-    const activeTab = state.tabsList.find(tab => tab.id === state.activeKey);
-    if (activeTab && activeTab.url === currentPath) return;
+    const activeTab = state.tabsList.find((tab) => tab.id === state.activeKey);
+    if (activeTab && activeTab.url === currentPath)
+      return;
     const flatMenus = flattenMenuData(dataSource.menus || []);
-    const targetMenu = flatMenus.find(item => getMenuRoute(item) === currentPath);
-    if (!targetMenu || !canOpenAsTab(targetMenu)) return;
+    const targetMenu = flatMenus.find((item) => getMenuRoute(item) === currentPath);
+    if (!targetMenu || !canOpenAsTab(targetMenu))
+      return;
     const existingTab = findExistingTab(state.tabsList, targetMenu);
     if (existingTab) {
-      if (state.activeKey !== existingTab.id) switchTab(existingTab.id);
+      if (state.activeKey !== existingTab.id)
+        switchTab(existingTab.id);
       return;
     }
     addTab(targetMenu);
-  }, [dataSource, state.tabsList, state.activeKey, addTab, switchTab]);
+  }, [urlSyncEnabled, dataSource, state.tabsList, state.activeKey, addTab, switchTab]);
   return {
     state,
     isInitialized,
@@ -498,7 +463,9 @@ export const useTabsState = options => {
     canAddTab,
     removeTab,
     updateTab,
+    updateTabUrl,
     switchTab,
+    rollbackTabActivation,
     closeOtherTabs,
     closeRightTabs,
     closeAllTabs,
@@ -507,4 +474,7 @@ export const useTabsState = options => {
     pinTab,
     unpinTab
   };
-};
+};
+export {
+  useTabsState
+};