@zat-design/sisyphus-react 4.0.0-beta.9 → 4.0.1

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;

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

@@ -0,0 +1,180 @@
+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); }
+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; }
+import { useCallback, useMemo, forwardRef, useImperativeHandle, useState, useEffect } from 'react';
+import { useTabsState } from "./hooks/useTabsState";
+import { TabItemComponent } from "./components/TabItem";
+import { TabsContext } from "./components/TabsContext";
+import "./style/index.less";
+
+/**
+ * 标签页管理器主组件
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var TabsManager = /*#__PURE__*/forwardRef((_ref, ref) => {
+  var config = _ref.config,
+    children = _ref.children,
+    dataSource = _ref.dataSource,
+    originalOnMenuClick = _ref.originalOnMenuClick;
+  // 使用标签页状态管理Hook
+  var _useTabsState = useTabsState({
+      config,
+      dataSource
+    }),
+    state = _useTabsState.state,
+    _addTab = _useTabsState.addTab,
+    removeTab = _useTabsState.removeTab,
+    switchTab = _useTabsState.switchTab,
+    closeOtherTabs = _useTabsState.closeOtherTabs,
+    closeRightTabs = _useTabsState.closeRightTabs,
+    closeAllTabs = _useTabsState.closeAllTabs;
+
+  // 记录已访问过的 Tab ID，用于懒加载
+  var _useState = useState(new Set()),
+    _useState2 = _slicedToArray(_useState, 2),
+    visitedTabIds = _useState2[0],
+    setVisitedTabIds = _useState2[1];
+
+  // 监听 activeKey 变化，更新 visitedTabIds
+  useEffect(() => {
+    if (state.activeKey) {
+      setVisitedTabIds(prev => {
+        if (prev.has(state.activeKey)) return prev;
+        var newSet = new Set(prev);
+        newSet.add(state.activeKey);
+        return newSet;
+      });
+    }
+  }, [state.activeKey]);
+
+  // 处理菜单点击 - 拦截原有的菜单点击逻辑
+  var handleMenuClick = useCallback(params => {
+    if (params.item) {
+      // 添加到标签页
+      _addTab(params.item);
+    }
+
+    // 如果有原始的菜单点击处理函数，也调用它
+    originalOnMenuClick === null || originalOnMenuClick === void 0 || originalOnMenuClick(params);
+  }, [_addTab, originalOnMenuClick]);
+
+  // 获取当前激活的标签页
+  var activeTabInfo = useMemo(() => {
+    return state.tabsList.find(tab => tab.id === state.activeKey);
+  }, [state.tabsList, state.activeKey]);
+
+  // 创建标签页实例 API
+  var tabsInstance = useMemo(() => ({
+    addTab: (params, options) => {
+      var code = params.code,
+        name = params.name,
+        extra = params.extra;
+      var menuItem = {
+        id: Date.now(),
+        // 生成临时 ID
+        code,
+        name,
+        url: `/${code}`,
+        // 生成 URL
+        extra
+      };
+      _addTab(menuItem, options);
+    },
+    removeTab,
+    getTabInfo: () => ({
+      tabsList: state.tabsList,
+      activeTabInfo: state.tabsList.find(tab => tab.id === state.activeKey),
+      activeComponent: state.activeComponent
+    })
+  }), [_addTab, removeTab, state.tabsList, state.activeKey, state.activeComponent]);
+
+  // 渲染标签页列表
+  var renderTabList = () => {
+    if (state.tabsList.length === 0) return null;
+    return /*#__PURE__*/_jsx("div", {
+      className: "pro-layout-tabs-header",
+      children: /*#__PURE__*/_jsx("div", {
+        className: "pro-layout-tab-list",
+        children: state.tabsList.map(tab => /*#__PURE__*/_jsx(TabItemComponent, {
+          tab: tab,
+          active: tab.id === state.activeKey,
+          onClick: () => switchTab(tab.id),
+          onClose: () => removeTab(tab.id),
+          onCloseOthers: () => closeOtherTabs(tab.id),
+          onCloseRight: () => closeRightTabs(tab.id),
+          onCloseAll: closeAllTabs,
+          tabsList: state.tabsList,
+          menuItems: config === null || config === void 0 ? void 0 : config.menuItems,
+          tabMenuClick: config === null || config === void 0 ? void 0 : config.tabMenuClick
+        }, tab.id))
+      })
+    });
+  };
+
+  // 从 config 中获取组件解析函数和空状态组件
+  var activeComponent = config === null || config === void 0 ? void 0 : config.activeComponent;
+  var emptyComponent = config === null || config === void 0 ? void 0 : config.empty;
+
+  // 渲染内容区域
+  var renderContent = () => {
+    return /*#__PURE__*/_jsxs("div", {
+      className: "pro-layout-tabs-content",
+      children: [state.tabsList.map(tab => {
+        var _tab$menuItem;
+        var isActive = tab.id === state.activeKey;
+        var hasVisited = visitedTabIds.has(tab.id);
+
+        // 如果既不是当前激活，也没有访问过，则只渲染占位符（懒加载）
+        if (!isActive && !hasVisited) {
+          return /*#__PURE__*/_jsx("div", {
+            className: "tab-pane hidden",
+            "data-testid": `tab-pane-${tab.id}`
+          }, tab.id);
+        }
+        var content = children;
+
+        // 如果提供了组件解析函数，尝试解析组件
+        if (activeComponent && (_tab$menuItem = tab.menuItem) !== null && _tab$menuItem !== void 0 && _tab$menuItem.code) {
+          var ResolvedComponent = activeComponent(tab.menuItem.code);
+          if (ResolvedComponent) {
+            // 将 extra 中的所有属性作为 props 传递给组件
+            content = /*#__PURE__*/_jsx(ResolvedComponent, _objectSpread({}, tab.menuItem.extra || {}));
+          }
+        }
+        return /*#__PURE__*/_jsx("div", {
+          className: `tab-pane ${isActive ? '' : 'hidden'}`,
+          "data-testid": `tab-pane-${tab.id}`,
+          children: content
+        }, tab.id);
+      }), state.tabsList.length === 0 && /*#__PURE__*/_jsx("div", {
+        className: "tab-pane",
+        "data-testid": "default-content",
+        children: emptyComponent || children
+      })]
+    });
+  };
+
+  // 暴露方法给父组件
+  useImperativeHandle(ref, () => ({
+    handleMenuClick
+  }), [handleMenuClick]);
+  return /*#__PURE__*/_jsx(TabsContext.Provider, {
+    value: tabsInstance,
+    children: /*#__PURE__*/_jsxs("div", {
+      className: "pro-layout-tabs",
+      "data-testid": "tabs-manager",
+      children: [renderTabList(), renderContent()]
+    })
+  });
+});
+TabsManager.displayName = 'TabsManager';
+export default TabsManager;

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

@@ -0,0 +1,74 @@
+import { ReactNode } from 'react';
+import type { MenuProps } from 'antd';
+import { TabsState, MenusType, DataSourceType, TabsConfig, AddTabOptions, TabItem } from '../../propTypes';
+export interface TabsManagerProps {
+    /** 标签页配置 */
+    config: TabsConfig;
+    /** 子元素内容 */
+    children: ReactNode;
+    /** 菜单数据源 */
+    dataSource: DataSourceType | Partial<MenusType>;
+    /** 原始菜单点击处理 */
+    originalOnMenuClick?: (params: {
+        item: MenusType | null;
+        key: string;
+        keyPath: string[];
+    }) => void;
+}
+export interface TabContextMenuProps {
+    tabId: string;
+    children: React.ReactElement;
+    closable?: boolean;
+    onClose: (tabId: string) => void;
+    onCloseOthers: (tabId: string) => void;
+    onCloseRight: (tabId: string) => void;
+    onCloseAll: () => void;
+    /** 自定义菜单项，会与默认菜单项合并 */
+    menuItems?: MenuProps['items'];
+    /** 自定义菜单项点击回调 */
+    tabMenuClick?: (params: {
+        key: string;
+        tab: TabItem;
+        tabs: TabItem[];
+    }) => void;
+    /** 当前标签页信息 */
+    tab?: TabItem;
+    /** 所有标签页列表 */
+    tabs?: TabItem[];
+}
+export interface UseTabsStateOptions {
+    /** 初始状态 */
+    initialState?: Partial<TabsState>;
+    /** 配置 */
+    config: TabsManagerProps['config'];
+    /** 数据源 */
+    dataSource?: TabsManagerProps['dataSource'];
+}
+export interface UseTabsStateReturn {
+    /** 当前状态 */
+    state: TabsState;
+    /** 添加标签页 */
+    addTab: (menuItem: MenusType, options?: AddTabOptions) => void;
+    /** 移除标签页 */
+    removeTab: (tabId: string) => void;
+    /** 切换标签页 */
+    switchTab: (tabId: string) => void;
+    /** 关闭其他标签页 */
+    closeOtherTabs: (currentTabId: string) => void;
+    /** 关闭右侧标签页 */
+    closeRightTabs: (currentTabId: string) => void;
+    /** 关闭全部标签页 */
+    closeAllTabs: () => void;
+    /** 重置状态 */
+    resetTabs: () => void;
+}
+export interface TabsCacheManager {
+    save: (state: TabsState) => void;
+    restore: () => TabsState | null;
+    clear: () => void;
+}
+export declare const DEFAULT_TABS_CONFIG: {
+    max: number;
+    storage: "localStorage";
+    cacheKey: string;
+};

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

@@ -0,0 +1,16 @@
+// TabsManager组件Props
+
+// 右键菜单组件Props
+
+// 状态管理Hook选项
+
+// 状态管理Hook返回值
+
+// 缓存管理器接口
+
+// 默认配置
+export var DEFAULT_TABS_CONFIG = {
+  max: 20,
+  storage: 'localStorage',
+  cacheKey: 'pro_layout_tabs'
+};