@zat-design/sisyphus-react 4.5.5 → 4.5.6-beta.2

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

@@ -7,26 +7,18 @@ import React, { memo, useEffect, useState, useRef } from 'react';
 import { tools } from '@zat-design/utils';
 import classnames from 'classnames';
 import dayjs from 'dayjs';
-import { useToggle, useSize } from 'ahooks';
+import { useToggle } from 'ahooks';
 import { ReactSVG } from 'react-svg';
 import foldSvg from "../../../assets/arrow.svg";
 import { Copy, ProBackBtn } from "./components";
+import { DescribeItems, DescribeValue } from "./components/Describe";
 import getEnumLabel from "../../../ProEnum/utils/getEnumLabel";
 import locale from "../../../locale";
-import { checkDescribeItemsHidden } from "./utils";
+import { toKeyPart, getDescribeColumnKey, getTagKey, getSubDescribeKey } from "./utils";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const {
   formatAmount
 } = tools;
-const toKeyPart = value => {
-  if (value == null || value === '') return undefined;
-  if (typeof value === 'string' || typeof value === 'number') return String(value);
-  return undefined;
-};
-const getDescribeColumnKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.value) ?? `describe-${index}`;
-const getDescribeValueKey = (item, parentKey, index) => toKeyPart(item.link) ?? toKeyPart(item.value) ?? `${parentKey}-value-${index}`;
-const getTagKey = (tagItem, parentKey, index) => toKeyPart(tagItem) ?? `${parentKey}-tag-${index}`;
-const getSubDescribeKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.code) ?? `sub-describe-${index}`;
 const ProHeader = props => {
   const {
     breadcrumbColumns,
@@ -37,7 +29,6 @@ const ProHeader = props => {
     className,
     bodyOverFlowHidden = false,
     fixedTop,
-    showBack = true,
     showShadow = false,
     zIndex = 98,
     title,
@@ -47,19 +38,32 @@ const ProHeader = props => {
     isConfirmBack = false,
     isConfirmBackModalProps = {}
   } = props;
-  const [backState, setBackState] = useState(showBack);
+
+  // 返回按钮是否显示。
+  // 显式意图优先于 autoBack 启发式：
+  // 1) 用户显式传了 showBack → 完全尊重该值；
+  // 2) 传了 onBack（返回不依赖浏览器历史，如 tab 内返回 / 自定义跳转）→ 显示；
+  // 3) 都没传（纯默认，返回兜底走 window.history.back）→ 由 autoBack 按历史长度智能判断：
+  //    新开页面(history.length <= autoBack)无处可返回，则隐藏。
+  const computeBackState = () => {
+    if (props.showBack !== undefined) return props.showBack;
+    if (onBack) return true;
+    return window.history.length > autoBack;
+  };
+  const [backState, setBackState] = useState(computeBackState);
   const [fold, {
     toggle
   }] = useToggle(collapsed);
   const ref = useRef(null);
-  const size = useSize(ref);
-  let _title = title;
+
+  // 最终用于渲染的标题（title + showBack 时会被转成面包屑，此处置空）
+  let finalTitle = title;
 
   // 面包屑配置数据源
-  const _breadcrumbColumns = breadcrumbColumns || [];
+  const finalBreadcrumbColumns = breadcrumbColumns || [];
 
   // 次级配置数据源
-  const _subDescribeColumns = subDescribeColumns || [];
+  const finalSubDescribeColumns = subDescribeColumns || [];
   useEffect(() => {
     if (bodyOverFlowHidden) {
       const bodyElement = document.querySelector('body');
@@ -70,13 +74,11 @@ const ProHeader = props => {
       bodyElement.style.overflow = '';
     };
   }, [bodyOverFlowHidden]);
+
+  // showBack / onBack / autoBack 变化时同步 backState（避免 props 更新后按钮显隐不同步）
   useEffect(() => {
-    const isNewPage = window.history.length;
-    // history的记录，默认2，代办新开页面
-    if (isNewPage <= autoBack) {
-      setBackState(false);
-    }
-  }, []);
+    setBackState(computeBackState());
+  }, [props.showBack, onBack, autoBack]);
 
   /**
    * 主级描述数据渲染
@@ -108,82 +110,6 @@ const ProHeader = props => {
           return null;
         }
         const onlyTag = tag && !label && !value;
-        const tagRender = params => {
-          if (Array.isArray(params?.tag) && params?.tag.length) {
-            return /*#__PURE__*/_jsx(Space, {
-              size: 4,
-              children: params.tag.map((tagItem, tagIndex) => {
-                return /*#__PURE__*/_jsx("div", {
-                  className: "pro-header-tag",
-                  children: tagItem
-                }, getTagKey(tagItem, describeItemKey, tagIndex));
-              })
-            });
-          }
-          return params?.tag ? /*#__PURE__*/_jsx("div", {
-            className: "pro-header-tag",
-            children: params?.tag
-          }) : null;
-        };
-
-        /** 单行渲染 */
-        const valueRender = params => {
-          return /*#__PURE__*/_jsxs(Space, {
-            size: 4,
-            align: params?.tag ? 'baseline' : 'center',
-            children: [params?.link ? /*#__PURE__*/_jsx("a", {
-              onClick: () => {
-                const newWindow = window.open(params.link);
-                newWindow.opener = null;
-              },
-              children: params?.value
-            }) : params?.value, params?.copyable && _isString(params?.value) ? /*#__PURE__*/_jsx(Copy, {
-              text: params.value
-            }) : null, tagRender({
-              tag: params?.tag
-            })]
-          });
-        };
-
-        /** 多行渲染 */
-        const itemsRender = () => {
-          // items配置是否超长，超长配置... + tip 提示
-          const itemsHidden = checkDescribeItemsHidden(ref?.current);
-          const result = /*#__PURE__*/_jsxs("div", {
-            ref: ref,
-            className: classnames({
-              'pro-header-describe-items': true,
-              'pro-header-describe-items-more': items.length >= 2
-            }),
-            children: [items?.length > 3 ? `共${items?.length}个，` : null, items.map((item, itemIndex) => {
-              return /*#__PURE__*/_jsxs("span", {
-                children: [valueRender(item), items?.length !== itemIndex + 1 ? ' 、' : null]
-              }, getDescribeValueKey(item, describeItemKey, itemIndex));
-            }), itemsHidden ? /*#__PURE__*/_jsx("span", {
-              className: "pro-header-describe-items-omit",
-              children: "..."
-            }) : null]
-          });
-          if (itemsHidden) {
-            const tipResult = /*#__PURE__*/_jsx(_Fragment, {
-              children: items.map((item, itemIndex) => {
-                return /*#__PURE__*/_jsx("p", {
-                  className: "pro-header-describe-items-tip-value",
-                  children: valueRender(item)
-                }, getDescribeValueKey(item, describeItemKey, itemIndex));
-              })
-            });
-            return /*#__PURE__*/_jsx(Tooltip, {
-              placement: "bottomLeft",
-              classNames: {
-                root: 'pro-header-describe-items-tip'
-              },
-              title: tipResult,
-              children: result
-            });
-          }
-          return result;
-        };
         const tagCls = classnames({
           'pro-header-only-tag': onlyTag,
           'pro-header-describe-items-calc': _isString(width) ? width.includes('calc') : false
@@ -200,12 +126,17 @@ const ProHeader = props => {
               children: label
             }) : null, /*#__PURE__*/_jsx("span", {
               className: "pro-header-describe-value",
-              children: items?.length ? itemsRender() : /*#__PURE__*/_jsx("span", {
-                children: valueRender({
-                  value,
-                  copyable,
-                  tag,
-                  link
+              children: items?.length ? /*#__PURE__*/_jsx(DescribeItems, {
+                items: items,
+                parentKey: describeItemKey,
+                containerRef: ref
+              }) : /*#__PURE__*/_jsx("span", {
+                children: /*#__PURE__*/_jsx(DescribeValue, {
+                  value: value,
+                  copyable: copyable,
+                  tag: tag,
+                  link: link,
+                  parentKey: describeItemKey
                 })
               })
             })]
@@ -302,10 +233,10 @@ const ProHeader = props => {
    * 总结信息面板渲染
    */
   const breadcrumbRender = () => {
-    if (Array.isArray(_breadcrumbColumns) && !_breadcrumbColumns.length) {
+    if (Array.isArray(finalBreadcrumbColumns) && !finalBreadcrumbColumns.length) {
       return [];
     }
-    const list = _breadcrumbColumns?.filter(item => {
+    const list = finalBreadcrumbColumns?.filter(item => {
       return item.type === 'breadcrumb';
     });
     return list.map((item, index) => {
@@ -355,10 +286,10 @@ const ProHeader = props => {
    * 头部左侧导航栏后业务信息
    */
   const infoRender = () => {
-    if (!Array.isArray(_breadcrumbColumns)) {
+    if (!Array.isArray(finalBreadcrumbColumns)) {
       return '';
     }
-    const list = _breadcrumbColumns?.filter(item => {
+    const list = finalBreadcrumbColumns?.filter(item => {
       return item.type !== 'breadcrumb';
     });
     if (!list.length) {
@@ -436,24 +367,29 @@ const ProHeader = props => {
       })
     });
   };
+
+  // 说明：以下两个 class 的判断沿用原有等价逻辑（去掉了原表达式里对 describeColumns 的重复判断）。
+  // has = 有次级描述 或 有主级描述；no = 无主级描述。二者非严格互斥（原实现即如此，未改动其行为）。
+  const noDescribe = _isEmpty(describeColumns);
+  const hasDescribe = !_isEmpty(finalSubDescribeColumns) || !noDescribe;
   const cls = classnames({
     'pro-header': true,
     'pro-header-fixed': fixedTop,
     'pro-header-shadow': showShadow,
     // 内部窗口滚动自带阴影场景
     'pro-header-no-back': !backState,
-    'pro-header-has-describe': !_isEmpty(_subDescribeColumns) || !_isEmpty(describeColumns) || !_isEmpty(describeColumns),
-    'pro-header-no-describe': _isEmpty(_subDescribeColumns) && _isEmpty(describeColumns) || _isEmpty(describeColumns),
+    'pro-header-has-describe': hasDescribe,
+    'pro-header-no-describe': noDescribe,
     [`${className}`]: className
   });
-  if (title && !_isEmpty(_breadcrumbColumns)) {
+  if (title && !_isEmpty(finalBreadcrumbColumns)) {
     console.error('warning: The title and the breadcrumbList cannot be used together');
   }
 
   // title默认不显示返回按钮，只有showBack设置为true时才显示
   if (title && props.showBack) {
-    _title = null;
-    _breadcrumbColumns.push({
+    finalTitle = null;
+    finalBreadcrumbColumns.push({
       type: 'breadcrumb',
       value: title
     });
@@ -492,9 +428,9 @@ const ProHeader = props => {
       top: fixedTop,
       zIndex
     },
-    children: _title ? /*#__PURE__*/_jsx("div", {
+    children: finalTitle ? /*#__PURE__*/_jsx("div", {
       className: "pro-header-title",
-      children: _title
+      children: finalTitle
     }) : /*#__PURE__*/_jsxs(_Fragment, {
       children: [/*#__PURE__*/_jsxs("div", {
         className: "pro-header-top",
@@ -516,14 +452,14 @@ const ProHeader = props => {
           className: "pro-header-right",
           children: actionsRender()
         })]
-      }), describeRender(describeColumns), !_isEmpty(_subDescribeColumns) ? /*#__PURE__*/_jsxs("div", {
+      }), describeRender(describeColumns), !_isEmpty(finalSubDescribeColumns) ? /*#__PURE__*/_jsxs("div", {
         className: classnames({
           'pro-header-nav': true,
           'pro-header-nav-open': fold,
           'pro-header-nav-hidden': !fold
         }),
         children: [/*#__PURE__*/_jsx("ul", {
-          children: _subDescribeColumns.map((item, index) => {
+          children: finalSubDescribeColumns.map((item, index) => {
             return /*#__PURE__*/_jsx("li", {
               children: subDescribeRender(item)
             }, getSubDescribeKey(item, index));

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

@@ -0,0 +1,20 @@
+import type React from 'react';
+import type { DescribeColumnType, SubDescribeColumnType } from '../PropTypes';
+/**
+ * 检查描述dom是否部分隐藏
+ * @param ele  dom节点
+ */
+export declare const checkDescribeItemsHidden: (ele?: any) => boolean;
+/**
+ * 将值转为可用于 React key 的字符串片段
+ * 仅 string / number 有效，其余（含 ReactNode、对象、数组、boolean）返回 undefined
+ */
+export declare const toKeyPart: (value: unknown) => string | undefined;
+/** 主级描述项 key：label → value → describe-${index} */
+export declare const getDescribeColumnKey: (item: DescribeColumnType, index: number) => string;
+/** 描述值 key：link → value → ${parentKey}-value-${index} */
+export declare const getDescribeValueKey: (item: Pick<DescribeColumnType, "tag" | "link" | "value" | "copyable">, parentKey: string, index: number) => string;
+/** 标签 key：tagItem → ${parentKey}-tag-${index} */
+export declare const getTagKey: (tagItem: string | React.ReactNode, parentKey: string, index: number) => string;
+/** 次级描述项 key：label → code → sub-describe-${index} */
+export declare const getSubDescribeKey: (item: SubDescribeColumnType, index: number) => string;

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

@@ -11,4 +11,26 @@ export const checkDescribeItemsHidden = ele => {
   const itemsScrollWidth = element.scrollWidth;
   const itemsClientWidth = element.clientWidth;
   return itemsScrollWidth > itemsClientWidth;
-};
+};
+
+/**
+ * 将值转为可用于 React key 的字符串片段
+ * 仅 string / number 有效，其余（含 ReactNode、对象、数组、boolean）返回 undefined
+ */
+export const toKeyPart = value => {
+  if (value == null || value === '') return undefined;
+  if (typeof value === 'string' || typeof value === 'number') return String(value);
+  return undefined;
+};
+
+/** 主级描述项 key：label → value → describe-${index} */
+export const getDescribeColumnKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.value) ?? `describe-${index}`;
+
+/** 描述值 key：link → value → ${parentKey}-value-${index} */
+export const getDescribeValueKey = (item, parentKey, index) => toKeyPart(item.link) ?? toKeyPart(item.value) ?? `${parentKey}-value-${index}`;
+
+/** 标签 key：tagItem → ${parentKey}-tag-${index} */
+export const getTagKey = (tagItem, parentKey, index) => toKeyPart(tagItem) ?? `${parentKey}-tag-${index}`;
+
+/** 次级描述项 key：label → code → sub-describe-${index} */
+export const getSubDescribeKey = (item, index) => toKeyPart(item.label) ?? toKeyPart(item.code) ?? `sub-describe-${index}`;

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

@@ -0,0 +1,7 @@
+import { TabContextMenuProps } from '../propTypes';
+/**
+ * 右键菜单组件 - 兼容Antd 4.x和5.x
+ */
+declare function TabContextMenu({ tabId, children, closable, onClose, onCloseOthers, onCloseRight, onCloseAll, menuItems: customMenuItems, tabMenuClick, tab, tabs, }: TabContextMenuProps): import("react/jsx-runtime").JSX.Element;
+export default TabContextMenu;
+export { TabContextMenu };

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/TabsContext.d.ts

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

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

@@ -0,0 +1,10 @@
+import type { TabsProps } from 'antd';
+export interface TabsHeaderProps {
+    activeKey: string | undefined;
+    tabsItems: TabsProps['items'];
+    onTabChange: (activeKey: string) => void;
+    onTabEdit: (targetKey: string, action: 'add' | 'remove') => void;
+    draggable?: boolean;
+    onReorder?: (activeId: string, overId: string) => void;
+}
+export declare function TabsHeader({ activeKey, tabsItems, onTabChange, onTabEdit, draggable, onReorder, }: TabsHeaderProps): import("react/jsx-runtime").JSX.Element;

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/useIframeRoute.d.ts

@@ -0,0 +1,25 @@
+import type { IframeConfig } from '../../../propTypes';
+export interface UseIframeRouteOptions {
+    /** iframe 嵌入配置 */
+    config: IframeConfig | undefined;
+    /** 命中路由后调用的 addTab(由外部 tabsInstance.addTab 注入) */
+    addTab: (params: {
+        code: string;
+        name: string;
+        extra?: Record<string, any>;
+    }) => void;
+}
+export interface UseIframeRouteReturn {
+    /** 当前是否处于 iframe 嵌入环境(通过 URL query `?isIframe` 判定,大小写不敏感) */
+    isIframe: boolean;
+    /** 是否启用纯净渲染(隐藏 Header/Menu/TabsBar);非 iframe 或未配置 iframe 时始终为 false */
+    pure: boolean;
+}
+/**
+ * iframe 嵌入模式 hook
+ * - 通过 URL query `?isIframe`(大小写不敏感)判定是否处于 iframe 嵌入场景
+ * - 命中时按 routes 静态路径匹配 window.location.pathname,调用 addTab
+ * - query string 自动作为 extra 透传给业务组件
+ * - 暴露 pure 标志供外部 layout 决定渲染范围
+ */
+export declare const useIframeRoute: (options: UseIframeRouteOptions) => UseIframeRouteReturn;

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/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/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/index.d.ts

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

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

@@ -85,6 +85,68 @@ const TabsManager = /*#__PURE__*/forwardRef(({
     }
   }, [state.activeKey]);
 
+  // tab 内子视图栈：按 tabId 隔离。栈底→栈顶顺序，入口页不在其中。
+  // 只活在内存、不进缓存（详情/工作流是运行态 ReactNode，无法 JSON 序列化）。
+  const [viewStacks, setViewStacks] = useState({});
+
+  // 用 ref 持有 activeKey，供稳定的 pushView/back 读取当前激活 tab，避免因 activeKey 变化重建实例
+  const activeKeyRef = useRef(state.activeKey);
+  activeKeyRef.current = state.activeKey;
+
+  // 同步持有最新 viewStacks，使 getViewStack 成为稳定引用且读取不受渲染时序影响
+  const viewStacksRef = useRef(viewStacks);
+  viewStacksRef.current = viewStacks;
+
+  // 在当前激活 tab 内压入一层子视图（入口页/下层随之隐藏但不卸载）
+  const pushView = useCallback(node => {
+    const tabId = activeKeyRef.current;
+    if (!tabId) return;
+    setViewStacks(prev => ({
+      ...prev,
+      [tabId]: [...(prev[tabId] || []), node]
+    }));
+  }, []);
+
+  // 返回：销毁当前激活 tab 的栈顶子视图（栈空时 no-op）
+  const back = useCallback(() => {
+    const tabId = activeKeyRef.current;
+    if (!tabId) return;
+    setViewStacks(prev => {
+      const stack = prev[tabId];
+      if (!stack || stack.length === 0) return prev;
+      const nextStack = stack.slice(0, -1);
+      const next = {
+        ...prev
+      };
+      if (nextStack.length === 0) {
+        delete next[tabId];
+      } else {
+        next[tabId] = nextStack;
+      }
+      return next;
+    });
+  }, []);
+
+  // 获取当前激活 tab 的子视图栈（从 ref 读最新值，稳定引用）
+  const getViewStack = useCallback(() => viewStacksRef.current[activeKeyRef.current] || [], []);
+
+  // 子视图栈与 tabsList 对账：任何关闭路径（removeTab / closeOthers / closeRight /
+  // closeAll）导致某 tab 消失后，清除其残留子视图栈，避免关闭后 node 仍驻留内存。
+  useEffect(() => {
+    setViewStacks(prev => {
+      const keys = Object.keys(prev);
+      if (keys.length === 0) return prev;
+      const aliveIds = new Set(state.tabsList.map(tab => tab.id));
+      const staleKeys = keys.filter(id => !aliveIds.has(id));
+      if (staleKeys.length === 0) return prev;
+      const next = {
+        ...prev
+      };
+      staleKeys.forEach(id => delete next[id]);
+      return next;
+    });
+  }, [state.tabsList]);
+
   // 通知父级（ProLayout）当前是否有 Tab
   useEffect(() => {
     onTabsChange?.(state.tabsList.length > 0);
@@ -169,8 +231,11 @@ const TabsManager = /*#__PURE__*/forwardRef(({
       tabsList: state.tabsList,
       activeTabInfo: state.tabsList.find(tab => tab.id === state.activeKey),
       activeComponent: state.activeComponent
-    })
-  }), [addTab, removeTab, updateTab, state.tabsList, state.activeKey, state.activeComponent, dataSource]);
+    }),
+    pushView,
+    back,
+    getViewStack
+  }), [addTab, removeTab, updateTab, state.tabsList, state.activeKey, state.activeComponent, dataSource, pushView, back, getViewStack]);
   const handleTabChange = useCallback(activeKey => {
     switchTab(activeKey);
   }, [switchTab]);
@@ -227,11 +292,30 @@ const TabsManager = /*#__PURE__*/forwardRef(({
             });
           }
         }
+
+        // 该 tab 的子视图栈：栈底→栈顶。只有「当前激活 tab 的栈顶层」可见，
+        // 入口页与下层子视图 display:none 但保持挂载 → 返回秒回、状态不丢。
+        const stack = viewStacks[tab.id] || [];
+        // 入口页可见条件：该 tab 激活 且 无子视图
+        const entryVisible = isActive && stack.length === 0;
         return /*#__PURE__*/_jsx("div", {
-          className: `tab-pane ${isActive ? '' : 'hidden'}`,
+          className: `tab-pane ${entryVisible ? '' : 'hidden'}`,
           "data-testid": `tab-pane-${tab.id}`,
           children: content
         }, tab.id);
+      }), state.tabsList.map(tab => {
+        const isActive = tab.id === state.activeKey;
+        const stack = viewStacks[tab.id] || [];
+        if (stack.length === 0) return null;
+        const topIndex = stack.length - 1;
+        return stack.map((node, index) => {
+          const layerVisible = isActive && index === topIndex;
+          return /*#__PURE__*/_jsx("div", {
+            className: `tab-pane ${layerVisible ? '' : 'hidden'}`,
+            "data-testid": `tab-subview-${tab.id}-${index}`,
+            children: node
+          }, `${tab.id}-subview-${index}`);
+        });
       }), state.tabsList.length === 0 && /*#__PURE__*/_jsx("div", {
         className: "tab-pane",
         "data-testid": "default-content",