@zat-design/sisyphus-react 3.13.23 → 3.14.0-beta.1

package/lib/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/lib/ProLayout/components/TabsManager/hooks/useTabsState.js

@@ -0,0 +1,364 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useTabsState = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var _react = require("react");
+var _propTypes = require("../propTypes");
+var _useTabsCache2 = require("./useTabsCache");
+var _utils = require("../utils");
+/**
+ * 标签页状态管理Hook
+ */
+var useTabsState = options => {
+  var _options$initialState = options.initialState,
+    initialState = _options$initialState === void 0 ? {} : _options$initialState,
+    config = options.config,
+    dataSource = options.dataSource;
+
+  // 合并默认配置
+  var finalConfig = (0, _objectSpread2.default)((0, _objectSpread2.default)({}, _propTypes.DEFAULT_TABS_CONFIG), config);
+
+  // 初始化状态
+  var _useState = (0, _react.useState)(() => (0, _objectSpread2.default)({
+      tabsList: [],
+      activeKey: '',
+      activeTabInfo: undefined,
+      newTabIndex: 0,
+      activeComponent: ''
+    }, initialState)),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    state = _useState2[0],
+    setState = _useState2[1];
+
+  // 缓存管理
+  var _useTabsCache = (0, _useTabsCache2.useTabsCache)({
+      cacheKey: finalConfig.cacheKey,
+      storage: finalConfig.storage,
+      enabled: true
+    }),
+    saveToCache = _useTabsCache.saveToCache,
+    restoreFromCache = _useTabsCache.restoreFromCache,
+    clearCache = _useTabsCache.clearCache;
+
+  // 初始化标记，确保只在初始化后保存缓存
+  var _useState3 = (0, _react.useState)(false),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    isInitialized = _useState4[0],
+    setIsInitialized = _useState4[1];
+
+  // 从缓存恢复状态
+  (0, _react.useEffect)(() => {
+    var cachedState = restoreFromCache();
+    if (cachedState && cachedState.tabsList && cachedState.tabsList.length > 0) {
+      // 兼容旧缓存：如果缓存中有 activeTab 但没有 activeTabInfo，进行迁移
+      var restoredState = (0, _objectSpread2.default)({}, cachedState);
+      if ('activeTab' in restoredState && !restoredState.activeTabInfo) {
+        restoredState.activeTabInfo = restoredState.activeTab;
+        delete restoredState.activeTab;
+      }
+      setState(restoredState);
+    }
+    setIsInitialized(true);
+  }, [restoreFromCache]);
+  var lastActiveKeyRef = (0, _react.useRef)('');
+  var shouldSkipSaveRef = (0, _react.useRef)(false);
+
+  // 保存状态到缓存
+  (0, _react.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 = (0, _react.useCallback)((menuItem, options) => {
+    var _ref = options || {},
+      _ref$forceNew = _ref.forceNew,
+      forceNew = _ref$forceNew === void 0 ? false : _ref$forceNew;
+    setState(prevState => {
+      // 只有最后一级菜单（叶子节点）才能添加标签页
+      if (!(0, _utils.isLeafMenuItem)(menuItem)) {
+        return prevState;
+      }
+
+      // 检查是否需要外部跳转
+      if ((0, _utils.shouldOpenExternal)(menuItem)) {
+        (0, _utils.handleExternalOpen)(menuItem);
+        return prevState;
+      }
+      var existingIds = prevState.tabsList.map(tab => tab.id);
+      var tabId = (0, _utils.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 = (0, _objectSpread2.default)((0, _objectSpread2.default)({}, 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 ((0, _utils.checkTabLimit)(prevState.tabsList, finalConfig.max)) {
+        // 达到最大值时，不添加新标签页，直接返回
+        return prevState;
+      }
+
+      // 创建新标签页
+      var newTab = (0, _utils.createTabFromMenu)(menuItem, prevState.newTabIndex);
+      newTab.id = tabId;
+      var newState = (0, _objectSpread2.default)((0, _objectSpread2.default)({}, prevState), {}, {
+        tabsList: [...prevState.tabsList, newTab],
+        activeKey: tabId,
+        activeTabInfo: newTab,
+        newTabIndex: prevState.newTabIndex + 1,
+        activeComponent: menuItem.code || tabId
+      });
+      return newState;
+    });
+  }, [finalConfig]);
+
+  /**
+   * 移除标签页
+   */
+  var removeTab = (0, _react.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) {
+          console.log('[useTabsState] removeTab: Calling onTabChange with empty state');
+          setTimeout(() => {
+            finalConfig.onTabChange('', undefined, []);
+          }, 0);
+        }
+      }
+      return (0, _objectSpread2.default)((0, _objectSpread2.default)({}, prevState), {}, {
+        tabsList: newTabs,
+        activeKey: newActiveKey,
+        activeTabInfo: newActiveTabInfo,
+        activeComponent: newActiveComponent
+      });
+    });
+  }, [clearCache, finalConfig]);
+
+  /**
+   * 切换标签页
+   */
+  var switchTab = (0, _react.useCallback)(tabId => {
+    setState(prevState => {
+      var _targetTab$menuItem;
+      var targetTab = prevState.tabsList.find(tab => tab.id === tabId);
+      if (!targetTab) return prevState;
+      var newState = (0, _objectSpread2.default)((0, _objectSpread2.default)({}, 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 = (0, _react.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 (0, _objectSpread2.default)((0, _objectSpread2.default)({}, 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 = (0, _react.useCallback)(currentTabId => {
+    setState(prevState => {
+      var rightTabs = (0, _utils.getRightTabs)(prevState.tabsList, currentTabId);
+      var tabsToKeep = prevState.tabsList.filter(tab => !rightTabs.includes(tab) || !tab.closable);
+      return (0, _objectSpread2.default)((0, _objectSpread2.default)({}, prevState), {}, {
+        tabsList: tabsToKeep
+      });
+    });
+  }, []);
+
+  /**
+   * 关闭全部标签页
+   */
+  var closeAllTabs = (0, _react.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) {
+        console.log('[useTabsState] closeAllTabs: Calling onTabChange with empty state');
+        setTimeout(() => {
+          finalConfig.onTabChange('', undefined, []);
+        }, 0);
+      }
+      return (0, _objectSpread2.default)((0, _objectSpread2.default)({}, prevState), {}, {
+        tabsList: newTabs,
+        activeKey: newActiveKey,
+        activeTabInfo: undefined,
+        activeComponent: newActiveComponent
+      });
+    });
+  }, [clearCache, finalConfig]);
+
+  /**
+   * 重置状态
+   */
+  var resetTabs = (0, _react.useCallback)(() => {
+    setState({
+      tabsList: [],
+      activeKey: '',
+      newTabIndex: 0,
+      activeComponent: ''
+    });
+  }, []);
+
+  // 监听 URL 变化并同步 Tabs (仅在初始化和 location 变化时)
+  // 放在最后以确保可以使用 addTab 和 switchTab
+  (0, _react.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 = (0, _utils.flattenMenuData)(dataSource.menus || []);
+    var targetMenu = flatMenus.find(item => item.url === currentPath);
+    if (targetMenu) {
+      // 只有最后一级菜单（叶子节点）才能添加标签页
+      if (!(0, _utils.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
+  };
+};
+exports.useTabsState = useTabsState;

package/lib/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/lib/ProLayout/components/TabsManager/index.js

@@ -0,0 +1,175 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _react = require("react");
+var _useTabsState2 = require("./hooks/useTabsState");
+var _TabItem = require("./components/TabItem");
+var _TabsContext = require("./components/TabsContext");
+require("./style/index.less");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * 标签页管理器主组件
+ */var TabsManager = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
+  var config = _ref.config,
+    children = _ref.children,
+    dataSource = _ref.dataSource,
+    originalOnMenuClick = _ref.originalOnMenuClick;
+  // 使用标签页状态管理Hook
+  var _useTabsState = (0, _useTabsState2.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 = (0, _react.useState)(new Set()),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    visitedTabIds = _useState2[0],
+    setVisitedTabIds = _useState2[1];
+
+  // 监听 activeKey 变化，更新 visitedTabIds
+  (0, _react.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 = (0, _react.useCallback)(params => {
+    if (params.item) {
+      // 添加到标签页
+      _addTab(params.item);
+    }
+
+    // 如果有原始的菜单点击处理函数，也调用它
+    originalOnMenuClick === null || originalOnMenuClick === void 0 || originalOnMenuClick(params);
+  }, [_addTab, originalOnMenuClick]);
+
+  // 获取当前激活的标签页
+  var activeTabInfo = (0, _react.useMemo)(() => {
+    return state.tabsList.find(tab => tab.id === state.activeKey);
+  }, [state.tabsList, state.activeKey]);
+
+  // 创建标签页实例 API
+  var tabsInstance = (0, _react.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__*/(0, _jsxRuntime.jsx)("div", {
+      className: "pro-layout-tabs-header",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+        className: "pro-layout-tab-list",
+        children: state.tabsList.map(tab => /*#__PURE__*/(0, _jsxRuntime.jsx)(_TabItem.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__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.jsx)(ResolvedComponent, (0, _objectSpread2.default)({}, tab.menuItem.extra || {}));
+          }
+        }
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+          className: `tab-pane ${isActive ? '' : 'hidden'}`,
+          "data-testid": `tab-pane-${tab.id}`,
+          children: content
+        }, tab.id);
+      }), state.tabsList.length === 0 && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+        className: "tab-pane",
+        "data-testid": "default-content",
+        children: emptyComponent || children
+      })]
+    });
+  };
+
+  // 暴露方法给父组件
+  (0, _react.useImperativeHandle)(ref, () => ({
+    handleMenuClick
+  }), [handleMenuClick]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_TabsContext.TabsContext.Provider, {
+    value: tabsInstance,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+      className: "pro-layout-tabs",
+      "data-testid": "tabs-manager",
+      children: [renderTabList(), renderContent()]
+    })
+  });
+});
+TabsManager.displayName = 'TabsManager';
+var _default = exports.default = TabsManager;

package/lib/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/lib/ProLayout/components/TabsManager/propTypes.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_TABS_CONFIG = void 0;
+// TabsManager组件Props
+
+// 右键菜单组件Props
+
+// 状态管理Hook选项
+
+// 状态管理Hook返回值
+
+// 缓存管理器接口
+
+// 默认配置
+var DEFAULT_TABS_CONFIG = exports.DEFAULT_TABS_CONFIG = {
+  max: 20,
+  storage: 'localStorage',
+  cacheKey: 'pro_layout_tabs'
+};