@zat-design/sisyphus-react 4.0.0-beta.8 → 4.0.0

package/es/ProLayout/components/TabsManager/components/TabItem.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { TabItem } from '../../../propTypes';
+interface TabItemComponentProps {
+    tab: TabItem;
+    active: boolean;
+    onClick: () => void;
+    onClose: () => void;
+    onCloseOthers: () => void;
+    onCloseRight: () => void;
+    onCloseAll: () => void;
+    /** 所有标签页列表 */
+    tabsList?: TabItem[];
+    /** 自定义菜单项 */
+    menuItems?: import('antd').MenuProps['items'];
+    /** 自定义菜单项点击回调 */
+    tabMenuClick?: (params: {
+        key: string;
+        tab: TabItem;
+        tabs: TabItem[];
+    }) => void;
+}
+/**
+ * 单个标签页组件
+ */
+declare const TabItemComponent: React.FC<TabItemComponentProps>;
+export { TabItemComponent };

package/es/ProLayout/components/TabsManager/components/TabItem.js

@@ -0,0 +1,61 @@
+import React from 'react';
+import { CloseOutlined } from '@ant-design/icons';
+import { TabContextMenu } from "./TabContextMenu";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * 单个标签页组件
+ */
+var TabItemComponent = _ref => {
+  var tab = _ref.tab,
+    active = _ref.active,
+    onClick = _ref.onClick,
+    _onClose = _ref.onClose,
+    _onCloseOthers = _ref.onCloseOthers,
+    _onCloseRight = _ref.onCloseRight,
+    onCloseAll = _ref.onCloseAll,
+    _ref$tabsList = _ref.tabsList,
+    tabsList = _ref$tabsList === void 0 ? [] : _ref$tabsList,
+    menuItems = _ref.menuItems,
+    tabMenuClick = _ref.tabMenuClick;
+  var handleCloseClick = e => {
+    e.stopPropagation();
+    _onClose();
+  };
+  return /*#__PURE__*/_jsx(TabContextMenu, {
+    tabId: tab.id,
+    closable: tab.closable,
+    onClose: () => _onClose(),
+    onCloseOthers: () => _onCloseOthers(),
+    onCloseRight: () => _onCloseRight(),
+    onCloseAll: onCloseAll,
+    tab: tab,
+    tabs: tabsList,
+    menuItems: menuItems,
+    tabMenuClick: tabMenuClick,
+    children: /*#__PURE__*/_jsx("div", {
+      className: `pro-layout-tab-item ${active ? 'active' : ''} ${tab.closable ? 'closable' : ''}`,
+      onClick: onClick,
+      "data-testid": `tab-${tab.id}`,
+      children: /*#__PURE__*/_jsxs("div", {
+        className: "pro-layout-tab-content",
+        children: [tab.icon && /*#__PURE__*/_jsx("span", {
+          className: "pro-layout-tab-icon",
+          children: typeof tab.icon === 'string' ? /*#__PURE__*/_jsx("i", {
+            className: `iconfont ${tab.icon}`
+          }) : tab.icon
+        }), /*#__PURE__*/_jsx("span", {
+          className: "pro-layout-tab-title",
+          title: tab.title,
+          children: tab.title
+        }), tab.closable && /*#__PURE__*/_jsx("span", {
+          className: "pro-layout-tab-close",
+          onClick: handleCloseClick,
+          "data-testid": `tab-close-${tab.id}`,
+          children: /*#__PURE__*/_jsx(CloseOutlined, {})
+        })]
+      })
+    })
+  });
+};
+export { TabItemComponent };

package/es/ProLayout/components/TabsManager/components/TabsContext.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="react" />
+import type { ProLayoutTabsInstance } from '../../../propTypes';
+/**
+ * 标签页实例 Context，用于在 ProLayout children 中访问标签页 API
+ */
+export declare const TabsContext: import("react").Context<ProLayoutTabsInstance>;

package/es/ProLayout/components/TabsManager/components/TabsContext.js

@@ -0,0 +1,5 @@
+import { createContext } from 'react';
+/**
+ * 标签页实例 Context，用于在 ProLayout children 中访问标签页 API
+ */
+export var TabsContext = /*#__PURE__*/createContext(null);

package/es/ProLayout/components/TabsManager/hooks/useActiveTab.d.ts

@@ -0,0 +1,6 @@
+import { TabItem } from '../../../propTypes';
+/**
+ * 获取当前激活的 Tab 信息 Hook
+ * @returns 当前激活的 Tab 对象，如果没有激活则返回 undefined
+ */
+export declare const useActiveTab: () => TabItem | undefined;

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

@@ -0,0 +1,14 @@
+import { useContext, useMemo } from 'react';
+import { TabsContext } from "../components/TabsContext";
+
+/**
+ * 获取当前激活的 Tab 信息 Hook
+ * @returns 当前激活的 Tab 对象，如果没有激活则返回 undefined
+ */
+export var useActiveTab = () => {
+  var tabsInstance = useContext(TabsContext);
+  return useMemo(() => {
+    if (!tabsInstance) return undefined;
+    return tabsInstance.getTabInfo().activeTabInfo;
+  }, [tabsInstance]);
+};

package/es/ProLayout/components/TabsManager/hooks/useProLayoutTabs.d.ts

@@ -0,0 +1,18 @@
+import type { ProLayoutTabsInstance } from '../../../propTypes';
+/**
+ * @description 获取 ProLayout 标签页实例的 Hook（类似 Form.useForm）
+ * @returns [ProLayoutTabsInstance] 标签页实例
+ * @example
+ * ```tsx
+ * // 在 ProLayout children 中使用
+ * const [layoutTabs] = useProLayoutTabs();
+ *
+ * // 使用实例方法
+ * layoutTabs.addTab({
+ *   code: 'PolicyInput',
+ *   name: '投保单录入',
+ *   extra: { customData: '自定义数据' }
+ * });
+ * ```
+ */
+export declare function useProLayoutTabs(): [ProLayoutTabsInstance];

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

@@ -0,0 +1,26 @@
+import { useContext } from 'react';
+import { TabsContext } from "../components/TabsContext";
+
+/**
+ * @description 获取 ProLayout 标签页实例的 Hook（类似 Form.useForm）
+ * @returns [ProLayoutTabsInstance] 标签页实例
+ * @example
+ * ```tsx
+ * // 在 ProLayout children 中使用
+ * const [layoutTabs] = useProLayoutTabs();
+ *
+ * // 使用实例方法
+ * layoutTabs.addTab({
+ *   code: 'PolicyInput',
+ *   name: '投保单录入',
+ *   extra: { customData: '自定义数据' }
+ * });
+ * ```
+ */
+export function useProLayoutTabs() {
+  var context = useContext(TabsContext);
+  if (!context) {
+    throw new Error('useProLayoutTabs must be used within ProLayout with mode="tabs"');
+  }
+  return [context];
+}

package/es/ProLayout/components/TabsManager/hooks/useTabsCache.d.ts

@@ -0,0 +1,31 @@
+import { TabsState } from '../../../propTypes';
+import { TabsCacheManager } from '../propTypes';
+/**
+ * 简化的标签页缓存管理器
+ */
+declare class SimpleTabsCache implements TabsCacheManager {
+    private cacheKey;
+    private storage;
+    constructor(keyPrefix: string, strategy: 'localStorage' | 'sessionStorage');
+    /** 保存标签页状态 */
+    save(state: TabsState): void;
+    /** 恢复标签页状态 */
+    restore(): TabsState | null;
+    /** 清空缓存 */
+    clear(): void;
+}
+interface UseTabsCacheOptions {
+    cacheKey: string;
+    storage: 'localStorage' | 'sessionStorage';
+    enabled?: boolean;
+}
+/**
+ * 标签页缓存管理Hook
+ */
+export declare const useTabsCache: (options: UseTabsCacheOptions) => {
+    saveToCache: (state: TabsState) => void;
+    restoreFromCache: () => TabsState | null;
+    clearCache: () => void;
+    cacheManager: SimpleTabsCache;
+};
+export {};

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

@@ -0,0 +1,96 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { useCallback, useMemo } from 'react';
+/**
+ * 简化的标签页缓存管理器
+ */
+class SimpleTabsCache {
+  constructor(keyPrefix, strategy) {
+    _defineProperty(this, "cacheKey", void 0);
+    _defineProperty(this, "storage", void 0);
+    this.cacheKey = `${keyPrefix}_tabs_cache`;
+    this.storage = strategy === 'localStorage' ? localStorage : sessionStorage;
+  }
+
+  /** 保存标签页状态 */
+  save(state) {
+    try {
+      var cacheData = _objectSpread(_objectSpread({}, state), {}, {
+        timestamp: Date.now()
+      });
+      this.storage.setItem(this.cacheKey, JSON.stringify(cacheData));
+    } catch (error) {
+      console.warn('标签页缓存保存失败:', error);
+    }
+  }
+
+  /** 恢复标签页状态 */
+  restore() {
+    try {
+      var cached = this.storage.getItem(this.cacheKey);
+      if (!cached) return null;
+      var cacheData = JSON.parse(cached);
+      // 移除时间戳字段
+      delete cacheData.timestamp;
+      return cacheData;
+    } catch (error) {
+      console.warn('标签页缓存恢复失败:', error);
+      return null;
+    }
+  }
+
+  /** 清空缓存 */
+  clear() {
+    try {
+      this.storage.removeItem(this.cacheKey);
+    } catch (error) {
+      console.warn('标签页缓存清空失败:', error);
+    }
+  }
+}
+/**
+ * 标签页缓存管理Hook
+ */
+export var useTabsCache = options => {
+  var cacheKey = options.cacheKey,
+    storage = options.storage,
+    _options$enabled = options.enabled,
+    enabled = _options$enabled === void 0 ? true : _options$enabled;
+
+  // 创建缓存管理器实例
+  var cacheManager = useMemo(() => {
+    if (!enabled) return null;
+    return new SimpleTabsCache(cacheKey, storage);
+  }, [cacheKey, storage, enabled]);
+
+  // 保存状态到缓存
+  var saveToCache = useCallback(state => {
+    if (cacheManager) {
+      cacheManager.save(state);
+    }
+  }, [cacheManager]);
+
+  // 从缓存恢复状态
+  var restoreFromCache = useCallback(() => {
+    if (cacheManager) {
+      return cacheManager.restore();
+    }
+    return null;
+  }, [cacheManager]);
+
+  // 清空缓存
+  var clearCache = useCallback(() => {
+    if (cacheManager) {
+      cacheManager.clear();
+    }
+  }, [cacheManager]);
+  return {
+    saveToCache,
+    restoreFromCache,
+    clearCache,
+    cacheManager
+  };
+};

package/es/ProLayout/components/TabsManager/hooks/useTabsState.d.ts

@@ -0,0 +1,5 @@
+import { UseTabsStateOptions, UseTabsStateReturn } from '../propTypes';
+/**
+ * 标签页状态管理Hook
+ */
+export declare const useTabsState: (options: UseTabsStateOptions) => UseTabsStateReturn;

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

@@ -0,0 +1,364 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { useState, useCallback, useEffect, useRef } from 'react';
+import { DEFAULT_TABS_CONFIG } from "../propTypes";
+import { useTabsCache } from "./useTabsCache";
+import { createTabFromMenu, generateTabId, shouldOpenExternal, handleExternalOpen, checkTabLimit, getRightTabs, flattenMenuData, isLeafMenuItem } from "../utils";
+
+/**
+ * 标签页状态管理Hook
+ */
+export var useTabsState = options => {
+  var _options$initialState = options.initialState,
+    initialState = _options$initialState === void 0 ? {} : _options$initialState,
+    config = options.config,
+    dataSource = options.dataSource;
+
+  // 合并默认配置
+  var finalConfig = _objectSpread(_objectSpread({}, DEFAULT_TABS_CONFIG), config);
+
+  // 初始化状态
+  var _useState = useState(() => _objectSpread({
+      tabsList: [],
+      activeKey: '',
+      activeTabInfo: undefined,
+      newTabIndex: 0,
+      activeComponent: ''
+    }, initialState)),
+    _useState2 = _slicedToArray(_useState, 2),
+    state = _useState2[0],
+    setState = _useState2[1];
+
+  // 缓存管理
+  var _useTabsCache = useTabsCache({
+      cacheKey: finalConfig.cacheKey,
+      storage: finalConfig.storage,
+      enabled: true
+    }),
+    saveToCache = _useTabsCache.saveToCache,
+    restoreFromCache = _useTabsCache.restoreFromCache,
+    clearCache = _useTabsCache.clearCache;
+
+  // 初始化标记，确保只在初始化后保存缓存
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isInitialized = _useState4[0],
+    setIsInitialized = _useState4[1];
+
+  // 从缓存恢复状态
+  useEffect(() => {
+    var cachedState = restoreFromCache();
+    if (cachedState && cachedState.tabsList && cachedState.tabsList.length > 0) {
+      // 兼容旧缓存：如果缓存中有 activeTab 但没有 activeTabInfo，进行迁移
+      var restoredState = _objectSpread({}, cachedState);
+      if ('activeTab' in restoredState && !restoredState.activeTabInfo) {
+        restoredState.activeTabInfo = restoredState.activeTab;
+        delete restoredState.activeTab;
+      }
+      setState(restoredState);
+    }
+    setIsInitialized(true);
+  }, [restoreFromCache]);
+  var lastActiveKeyRef = useRef('');
+  var shouldSkipSaveRef = useRef(false);
+
+  // 保存状态到缓存
+  useEffect(() => {
+    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) {
+        // 正常的标签页切换
+        var activeTab = state.tabsList.find(tab => tab.id === state.activeKey);
+        if (activeTab) {
+          finalConfig.onTabChange(state.activeKey, activeTab, state.tabsList);
+        }
+      } else {
+        // 空状态 - 所有标签页都被关闭
+        finalConfig.onTabChange('', undefined, state.tabsList);
+      }
+    }
+
+    // 如果 tabsList 为空且 activeKey 为空，说明是清空状态，不保存缓存
+    if (state.tabsList.length === 0 && !state.activeKey) {
+      return;
+    }
+
+    // 保存状态到缓存
+    saveToCache(state);
+  }, [state, saveToCache, finalConfig, isInitialized]);
+
+  /**
+   * 添加标签页
+   */
+  var addTab = useCallback((menuItem, options) => {
+    var _ref = options || {},
+      _ref$forceNew = _ref.forceNew,
+      forceNew = _ref$forceNew === void 0 ? false : _ref$forceNew;
+    setState(prevState => {
+      // 只有最后一级菜单（叶子节点）才能添加标签页
+      if (!isLeafMenuItem(menuItem)) {
+        return prevState;
+      }
+
+      // 检查是否需要外部跳转
+      if (shouldOpenExternal(menuItem)) {
+        handleExternalOpen(menuItem);
+        return prevState;
+      }
+      var existingIds = prevState.tabsList.map(tab => tab.id);
+      var tabId = generateTabId(menuItem, existingIds);
+
+      // 如果 forceNew = false（默认），检查是否已存在相同的标签页
+      if (!forceNew) {
+        var existingTab = prevState.tabsList.find(tab => {
+          var _tab$menuItem;
+          return ((_tab$menuItem = tab.menuItem) === null || _tab$menuItem === void 0 ? void 0 : _tab$menuItem.code) === menuItem.code || tab.url === menuItem.url;
+        });
+        if (existingTab) {
+          var _existingTab$menuItem;
+          // 如果已存在，直接切换到该标签页
+          var _newState = _objectSpread(_objectSpread({}, prevState), {}, {
+            activeKey: existingTab.id,
+            activeTabInfo: existingTab,
+            activeComponent: ((_existingTab$menuItem = existingTab.menuItem) === null || _existingTab$menuItem === void 0 ? void 0 : _existingTab$menuItem.code) || existingTab.id
+          });
+          return _newState;
+        }
+      }
+
+      // 检查是否超出限制
+      if (checkTabLimit(prevState.tabsList, finalConfig.max)) {
+        // 达到最大值时，不添加新标签页，直接返回
+        return prevState;
+      }
+
+      // 创建新标签页
+      var newTab = createTabFromMenu(menuItem, prevState.newTabIndex);
+      newTab.id = tabId;
+      var newState = _objectSpread(_objectSpread({}, prevState), {}, {
+        tabsList: [...prevState.tabsList, newTab],
+        activeKey: tabId,
+        activeTabInfo: newTab,
+        newTabIndex: prevState.newTabIndex + 1,
+        activeComponent: menuItem.code || tabId
+      });
+      return newState;
+    });
+  }, [finalConfig]);
+
+  /**
+   * 移除标签页
+   */
+  var removeTab = useCallback(tabId => {
+    setState(prevState => {
+      var tabToRemove = prevState.tabsList.find(tab => tab.id === tabId);
+      if (!tabToRemove || !tabToRemove.closable) {
+        return prevState;
+      }
+      var newTabs = prevState.tabsList.filter(tab => tab.id !== tabId);
+      var newActiveKey = prevState.activeKey;
+      var newActiveTabInfo = prevState.activeTabInfo;
+      var newActiveComponent = prevState.activeComponent;
+
+      // 如果移除的是当前活跃标签页，需要选择新的活跃标签页
+      if (prevState.activeKey === tabId && newTabs.length > 0) {
+        var _newActiveTabInfo$men;
+        var currentIndex = prevState.tabsList.findIndex(tab => tab.id === tabId);
+        var newActiveIndex = Math.min(currentIndex, newTabs.length - 1);
+        newActiveTabInfo = newTabs[newActiveIndex];
+        newActiveKey = newActiveTabInfo.id;
+        newActiveComponent = ((_newActiveTabInfo$men = newActiveTabInfo.menuItem) === null || _newActiveTabInfo$men === void 0 ? void 0 : _newActiveTabInfo$men.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);
+        }
+      }
+      return _objectSpread(_objectSpread({}, prevState), {}, {
+        tabsList: newTabs,
+        activeKey: newActiveKey,
+        activeTabInfo: newActiveTabInfo,
+        activeComponent: newActiveComponent
+      });
+    });
+  }, [clearCache, finalConfig]);
+
+  /**
+   * 切换标签页
+   */
+  var switchTab = useCallback(tabId => {
+    setState(prevState => {
+      var _targetTab$menuItem;
+      var targetTab = prevState.tabsList.find(tab => tab.id === tabId);
+      if (!targetTab) return prevState;
+      var newState = _objectSpread(_objectSpread({}, prevState), {}, {
+        activeKey: tabId,
+        activeTabInfo: targetTab,
+        activeComponent: ((_targetTab$menuItem = targetTab.menuItem) === null || _targetTab$menuItem === void 0 ? void 0 : _targetTab$menuItem.code) || tabId
+      });
+      return newState;
+    });
+  }, []);
+
+  /**
+   * 关闭其他标签页
+   */
+  var closeOtherTabs = useCallback(currentTabId => {
+    setState(prevState => {
+      var _currentTab$menuItem;
+      var currentTab = prevState.tabsList.find(tab => tab.id === currentTabId);
+      if (!currentTab) return prevState;
+
+      // 只保留当前标签页和不可关闭的标签页
+      var newTabs = prevState.tabsList.filter(tab => tab.id === currentTabId || !tab.closable);
+      return _objectSpread(_objectSpread({}, prevState), {}, {
+        tabsList: newTabs,
+        activeKey: currentTabId,
+        activeTabInfo: currentTab,
+        activeComponent: ((_currentTab$menuItem = currentTab.menuItem) === null || _currentTab$menuItem === void 0 ? void 0 : _currentTab$menuItem.code) || currentTabId
+      });
+    });
+  }, []);
+
+  /**
+   * 关闭右侧标签页
+   */
+  var closeRightTabs = useCallback(currentTabId => {
+    setState(prevState => {
+      var rightTabs = getRightTabs(prevState.tabsList, currentTabId);
+      var tabsToKeep = prevState.tabsList.filter(tab => !rightTabs.includes(tab) || !tab.closable);
+      return _objectSpread(_objectSpread({}, prevState), {}, {
+        tabsList: tabsToKeep
+      });
+    });
+  }, []);
+
+  /**
+   * 关闭全部标签页
+   */
+  var closeAllTabs = useCallback(() => {
+    setState(prevState => {
+      // 只保留不可关闭的标签页
+      var newTabs = prevState.tabsList.filter(tab => !tab.closable);
+      var newActiveKey = '';
+      var newActiveComponent = '';
+      if (newTabs.length > 0) {
+        var _firstTab$menuItem;
+        var firstTab = newTabs[0];
+        newActiveKey = firstTab.id;
+        newActiveComponent = ((_firstTab$menuItem = firstTab.menuItem) === null || _firstTab$menuItem === void 0 ? void 0 : _firstTab$menuItem.code) || firstTab.id;
+      }
+
+      // 关闭全部标签页时，清空缓存
+      // 标记跳过下次保存，避免清空后又被重新保存
+      shouldSkipSaveRef.current = true;
+      clearCache();
+
+      // 如果关闭后没有标签页了，直接调用 onTabChange
+      if (newTabs.length === 0 && finalConfig.onTabChange) {
+        setTimeout(() => {
+          finalConfig.onTabChange('', undefined, []);
+        }, 0);
+      }
+      return _objectSpread(_objectSpread({}, prevState), {}, {
+        tabsList: newTabs,
+        activeKey: newActiveKey,
+        activeTabInfo: undefined,
+        activeComponent: newActiveComponent
+      });
+    });
+  }, [clearCache, finalConfig]);
+
+  /**
+   * 重置状态
+   */
+  var resetTabs = useCallback(() => {
+    setState({
+      tabsList: [],
+      activeKey: '',
+      newTabIndex: 0,
+      activeComponent: ''
+    });
+  }, []);
+
+  // 监听 URL 变化并同步 Tabs (仅在初始化和 location 变化时)
+  // 放在最后以确保可以使用 addTab 和 switchTab
+  useEffect(() => {
+    // 确保数据源存在
+    if (!dataSource || !('menus' in dataSource)) return;
+    var currentPath = window.location.pathname;
+
+    // 如果当前没有 activeKey 或者 activeKey 对应的 URL 与当前 URL 不一致
+    var activeTab = state.tabsList.find(tab => tab.id === state.activeKey);
+
+    // 如果当前已经在正确的 Tab 上，无需处理
+    if (activeTab && activeTab.url === currentPath) return;
+
+    // 在菜单中查找当前 URL 对应的菜单项
+    var flatMenus = flattenMenuData(dataSource.menus || []);
+    var targetMenu = flatMenus.find(item => item.url === currentPath);
+    if (targetMenu) {
+      // 只有最后一级菜单（叶子节点）才能添加标签页
+      if (!isLeafMenuItem(targetMenu)) {
+        return;
+      }
+
+      // 检查是否已在 Tabs 中
+      var existingTab = state.tabsList.find(tab => {
+        var _tab$menuItem2;
+        return ((_tab$menuItem2 = tab.menuItem) === null || _tab$menuItem2 === void 0 ? void 0 : _tab$menuItem2.code) === targetMenu.code || tab.url === targetMenu.url;
+      });
+      if (existingTab) {
+        // 如果已存在，切换到该 Tab
+        if (state.activeKey !== existingTab.id) {
+          switchTab(existingTab.id);
+        }
+      } else {
+        // 如果不存在，添加新 Tab
+        addTab(targetMenu);
+      }
+    }
+  }, [dataSource, state.tabsList, state.activeKey, addTab, switchTab]);
+  return {
+    state,
+    addTab,
+    removeTab,
+    switchTab,
+    closeOtherTabs,
+    closeRightTabs,
+    closeAllTabs,
+    resetTabs
+  };
+};

package/es/ProLayout/components/TabsManager/index.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import { TabsManagerProps } from './propTypes';
+import './style/index.less';
+/**
+ * 标签页管理器主组件
+ */
+declare const TabsManager: import("react").ForwardRefExoticComponent<TabsManagerProps & import("react").RefAttributes<any>>;
+export default TabsManager;