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

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'
+};

package/es/ProLayout/components/TabsManager/style/index.less

@@ -0,0 +1,179 @@
+.pro-layout-tabs {
+  --pro-layout-tabs-primary: var(--ant-primary-color, #1677ff);
+  --pro-layout-tabs-active-bg: var(--ant-color-success, #00b578);
+  --pro-layout-tabs-text-color: var(--ant-color-text, #1f1f1f);
+
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+
+  &-header {
+    display: flex;
+    align-items: center;
+    min-height: 48px;
+    padding: 12px 0;
+    border-bottom: none;
+
+    .pro-layout-tab-list {
+      display: flex;
+      flex: 1;
+      gap: 12px;
+      overflow-x: auto;
+      overflow-y: hidden;
+
+      &::-webkit-scrollbar {
+        height: 3px;
+      }
+
+      &::-webkit-scrollbar-track {
+        background: transparent;
+      }
+
+      &::-webkit-scrollbar-thumb {
+        background: #d9d9d9;
+        border-radius: 3px;
+
+        &:hover {
+          background: #bfbfbf;
+        }
+      }
+    }
+
+    &-extra {
+      flex-shrink: 0;
+      padding: 0 16px;
+    }
+  }
+
+  &-content {
+    .tab-pane {
+      &.hidden {
+        display: none;
+      }
+    }
+  }
+}
+
+.pro-layout-tab-item {
+  position: relative;
+  display: flex;
+  flex-shrink: 0;
+  align-items: center;
+  min-height: 36px;
+  padding: 0;
+  background: #ffffff;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
+  user-select: none;
+
+  &:hover {
+    background: #ffffff;
+    border-color: rgba(0, 0, 0, 0.06);
+  }
+
+  &.active {
+    z-index: 2;
+    background: var(--zaui-primary);
+    border-color: transparent;
+
+    &::before {
+      display: none;
+    }
+  }
+
+  .pro-layout-tab-content {
+    display: flex;
+    align-items: center;
+    min-width: 100px;
+    padding: 6px 12px;
+    text-align: left;
+
+    .pro-layout-tab-icon {
+      display: flex;
+      flex-shrink: 0;
+      align-items: center;
+      margin-right: 8px;
+
+      .iconfont {
+        color: inherit;
+        font-size: 14px;
+      }
+
+      img {
+        width: 16px;
+        height: 16px;
+        object-fit: contain;
+      }
+    }
+
+    .pro-layout-tab-title {
+      flex: 1;
+      overflow: hidden;
+      color: var(--pro-layout-tabs-text-color);
+      font-weight: 500;
+      font-size: 14px;
+      white-space: nowrap;
+      text-overflow: ellipsis;
+      transition: color 0.3s;
+    }
+
+    .pro-layout-tab-close {
+      display: flex;
+      flex-shrink: 0;
+      align-items: center;
+      justify-content: center;
+      margin-left: 8px;
+      padding: 3px;
+      color: rgba(0, 0, 0, 0.45);
+      border-radius: 4px;
+      opacity: 0.7;
+      transition: all 0.3s;
+
+      &:hover {
+        color: #ff4d4f;
+        background: rgba(255, 77, 79, 0.15);
+        opacity: 1;
+      }
+    }
+  }
+
+  &.active .pro-layout-tab-content {
+    .pro-layout-tab-title {
+      color: #ffffff;
+      font-weight: 600;
+    }
+
+    .pro-layout-tab-icon {
+      .iconfont {
+        color: #ffffff;
+      }
+    }
+
+    .pro-layout-tab-close {
+      color: #ffffff;
+
+      &:hover {
+        background: rgba(255, 255, 255, 0.2);
+      }
+    }
+  }
+}
+
+.pro-layout-dark .pro-layout-tabs {
+  --pro-layout-tabs-text-color: rgba(255, 255, 255, 0.85);
+}
+
+// 响应式适配
+@media (max-width: 768px) {
+  .pro-layout-tab-item {
+    .pro-layout-tab-content {
+      padding: 6px 8px;
+
+      .pro-layout-tab-title {
+        max-width: 80px;
+      }
+    }
+  }
+}

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

@@ -0,0 +1,38 @@
+import { TabItem, MenusType } from '../../../propTypes';
+/**
+ * 根据菜单项生成TabItem
+ */
+export declare const createTabFromMenu: (menuItem: MenusType, index?: number) => TabItem;
+/**
+ * 生成唯一的tab ID
+ */
+export declare const generateTabId: (menuItem: MenusType, existingIds: string[]) => string;
+/**
+ * 检查菜单项是否应该外部跳转
+ */
+export declare const shouldOpenExternal: (menuItem: MenusType, target?: string) => boolean;
+/**
+ * 处理外部跳转
+ */
+export declare const handleExternalOpen: (menuItem: MenusType) => void;
+/**
+ * 检查是否超出最大标签页限制
+ */
+export declare const checkTabLimit: (currentTabs: TabItem[], maxTabs: number) => boolean;
+/**
+ * 移除最旧的标签页（根据访问时间或创建时间）
+ */
+export declare const removeOldestTab: (tabs: TabItem[]) => TabItem[];
+/**
+ * 获取右侧标签页
+ */
+export declare const getRightTabs: (tabs: TabItem[], currentTabId: string) => TabItem[];
+/**
+ * 扁平化菜单数据
+ */
+export declare const flattenMenuData: (menus?: MenusType[]) => MenusType[];
+/**
+ * 判断菜单项是否为最后一级（叶子节点）
+ * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点
+ */
+export declare const isLeafMenuItem: (menuItem: MenusType) => boolean;

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

@@ -0,0 +1,106 @@
+/**
+ * 根据菜单项生成TabItem
+ */
+export var createTabFromMenu = function createTabFromMenu(menuItem) {
+  var index = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  return {
+    id: String(menuItem.id || menuItem.code || menuItem.url || index),
+    code: menuItem.code,
+    name: menuItem.name,
+    title: menuItem.name,
+    url: menuItem.url,
+    closable: true,
+    menuItem,
+    icon: menuItem.icon || menuItem.imgUrl
+  };
+};
+
+/**
+ * 生成唯一的tab ID
+ */
+export var generateTabId = (menuItem, existingIds) => {
+  var baseId = String(menuItem.id || menuItem.code || menuItem.url);
+  var finalId = baseId;
+  var counter = 1;
+
+  // 如果ID已存在，则添加数字后缀
+  while (existingIds.includes(finalId)) {
+    finalId = `${baseId}_${counter}`;
+    counter += 1;
+  }
+  return finalId;
+};
+
+/**
+ * 检查菜单项是否应该外部跳转
+ */
+export var shouldOpenExternal = (menuItem, target) => {
+  return target === '_blank' || menuItem.redirectUrl && menuItem.redirectUrl !== menuItem.url || menuItem.type === 'EXTERNAL';
+};
+
+/**
+ * 处理外部跳转
+ */
+export var handleExternalOpen = menuItem => {
+  var url = menuItem.redirectUrl || menuItem.url;
+  if (url) {
+    window.open(url, '_blank');
+  }
+};
+
+/**
+ * 检查是否超出最大标签页限制
+ */
+export var checkTabLimit = (currentTabs, maxTabs) => {
+  return currentTabs.length >= maxTabs;
+};
+
+/**
+ * 移除最旧的标签页（根据访问时间或创建时间）
+ */
+export var removeOldestTab = tabs => {
+  if (tabs.length === 0) return tabs;
+
+  // 找到可关闭的最旧标签页
+  var closableTabs = tabs.filter(tab => tab.closable);
+  if (closableTabs.length === 0) return tabs;
+
+  // 移除第一个可关闭的标签页
+  var oldestTab = closableTabs[0];
+  return tabs.filter(tab => tab.id !== oldestTab.id);
+};
+
+/**
+ * 获取右侧标签页
+ */
+export var getRightTabs = (tabs, currentTabId) => {
+  var currentIndex = tabs.findIndex(tab => tab.id === currentTabId);
+  if (currentIndex === -1) return [];
+  return tabs.slice(currentIndex + 1);
+};
+
+/**
+ * 扁平化菜单数据
+ */
+export var flattenMenuData = function flattenMenuData() {
+  var menus = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var flatMenus = [];
+  menus.forEach(item => {
+    flatMenus.push(item);
+    if (item.children) {
+      flatMenus = [...flatMenus, ...flattenMenuData(item.children)];
+    }
+  });
+  return flatMenus;
+};
+
+/**
+ * 判断菜单项是否为最后一级（叶子节点）
+ * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点
+ */
+export var isLeafMenuItem = menuItem => {
+  var _ref = menuItem || {},
+    children = _ref.children;
+  // 如果 children 不存在、为 null、为 undefined，或者为空数组，则认为是叶子节点
+  return !children || Array.isArray(children) && children.length === 0;
+};

package/es/ProLayout/index.d.ts

@@ -1,14 +1,31 @@
 /// <reference types="react" />
-import type { ProLayoutType } from './propTypes';
-export declare const LayoutContext: import("react").Context<{
+import type { ProLayoutStatesType, ProLayoutType } from './propTypes';
+import { useProLayoutTabs } from './components/TabsManager/hooks/useProLayoutTabs';
+import { useActiveTab } from './components/TabsManager/hooks/useActiveTab';
+interface LayoutContextValue {
     selectedPath: string;
-    onSelected: (params: any) => void;
+    onSelected: (params: Partial<ProLayoutStatesType>) => void;
     target: '_blank' | '_parent' | '_self' | '_top';
-}>;
+}
+export declare const LayoutContext: import("react").Context<LayoutContextValue>;
 declare const ProLayout: {
     (props: ProLayoutType): import("react/jsx-runtime").JSX.Element;
+    defaultProps: {
+        menus: any[];
+        iconfontUrl: string;
+        title: string;
+        collapsed: boolean;
+        routerMatch: string;
+        pure: boolean;
+        theme: string;
+        headerHeight: number;
+        contentStyle: {};
+    };
     ProCollapse: (props: import("./components/ProCollapse/PropTypes").ProCollapseType) => import("react/jsx-runtime").JSX.Element;
     ProFooter: import("react").MemoExoticComponent<(props: import("./components/ProFooter/PropTypes").ProFooterType) => import("react/jsx-runtime").JSX.Element>;
     ProHeader: import("react").MemoExoticComponent<(props: import("./components/ProHeader/PropTypes").ProHeaderType) => import("react/jsx-runtime").JSX.Element>;
+    useProLayoutTabs: typeof useProLayoutTabs;
+    useActiveTab: () => import("./propTypes").TabItem;
 };
+export { useProLayoutTabs, useActiveTab };
 export default ProLayout;