@zat-design/sisyphus-react 4.5.8-beta.1 → 4.5.8-beta.4

package/es/ProAction/components/CheckModalContent/index.d.ts

@@ -1,8 +1,9 @@
+/// <reference types="react" />
 import './index.less';
 interface propsWithCheckModal {
     errorTitle?: string;
     list?: string[];
     [key: string]: any;
 }
-declare const CheckModalContent: (props: propsWithCheckModal) => import("react/jsx-runtime").JSX.Element;
+declare const CheckModalContent: (props: propsWithCheckModal) => import("react").JSX.Element;
 export default CheckModalContent;

package/es/ProDownload/index.d.ts

@@ -1,6 +1,7 @@
+/// <reference types="react" />
 import type { ProDownloadType } from './propsType';
 declare const ProDownload: {
-    (props: ProDownloadType): import("react/jsx-runtime").JSX.Element;
+    (props: ProDownloadType): import("react").JSX.Element;
     downLoadRequest: import("./utils").DownloadRequestProps;
 };
 export default ProDownload;

package/es/ProDrawerForm/hooks/useConfirmClose.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ProDrawerFormType } from '../propsType';
 interface UseConfirmCloseParams {
     open?: boolean;

package/es/ProEditTable/components/ActionButton/index.d.ts

@@ -1,2 +1,3 @@
-declare const ActionButton: ({ record, index, config, btnConfig }: any) => import("react/jsx-runtime").JSX.Element;
+import React from 'react';
+declare const ActionButton: ({ record, index, config, btnConfig }: any) => React.JSX.Element;
 export default ActionButton;

package/es/ProEditTable/components/RcTable/BaseTable.d.ts

@@ -1,5 +1,6 @@
+/// <reference types="react" />
 declare const _default: import("react").MemoExoticComponent<({ tableProps, ...resetProps }: {
     [x: string]: any;
     tableProps: any;
-}) => import("react/jsx-runtime").JSX.Element>;
+}) => import("react").JSX.Element>;
 export default _default;

package/es/ProEditTable/components/RcTable/DraggableTable.d.ts

@@ -3,5 +3,5 @@ declare const _default: React.MemoExoticComponent<({ tableProps, draggableProps,
     [x: string]: any;
     tableProps: any;
     draggableProps: any;
-}) => import("react/jsx-runtime").JSX.Element>;
+}) => React.JSX.Element>;
 export default _default;

package/es/ProEditTable/components/RenderField/index.d.ts

@@ -1,3 +1,3 @@
 import React from 'react';
-declare const _default: React.MemoExoticComponent<({ text: value, record, index, column, config }: any) => import("react/jsx-runtime").JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ text: value, record, index, column, config }: any) => React.JSX.Element>;
 export default _default;

package/es/ProEditTable/components/RenderToolbar/index.d.ts

@@ -1,2 +1,3 @@
-declare const RenderToolbar: (config: any) => import("react/jsx-runtime").JSX.Element;
+import React from 'react';
+declare const RenderToolbar: (config: any) => React.JSX.Element;
 export default RenderToolbar;

package/es/ProEditTable/components/Summary/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ProEditTableSummaryColumnType } from '../../propsType';
 interface SummaryProps<T = any> {
     data: T[];
@@ -8,5 +9,5 @@ interface SummaryProps<T = any> {
     };
     rowSelection: any;
 }
-declare const Summary: ({ data, summary, rowSelection }: SummaryProps) => import("react/jsx-runtime").JSX.Element;
+declare const Summary: ({ data, summary, rowSelection }: SummaryProps) => import("react").JSX.Element;
 export default Summary;

package/es/ProEditTable/components/Validator/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { NamePath } from 'antd/es/form/interface';
 import { type ErrorStore } from '../../utils/validateAll';
 interface ValidatorProps {

package/es/ProEditTable/utils/config.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 export declare const defaultBtnNameMap: {
     add: any;
     edit: any;
@@ -9,7 +10,7 @@ export declare const defaultBtnNameMap: {
     custom: any;
 };
 export declare const iconMap: {
-    add: import("react/jsx-runtime").JSX.Element;
+    add: import("react").JSX.Element;
 };
 export declare const defaultSingleActionKeys: string[];
 export declare const defaultMultipleActionKeys: string[];

package/es/ProEditTable/utils/tools.d.ts

@@ -12,7 +12,7 @@ export declare const getRandom: () => string;
  * @param rowKey 用户传入的 rowKey prop
  * @returns AntD Table 可用的 rowKey 字符串或函数
  */
-export declare const buildTableRowKey: (rowKey?: string | number | symbol | ((record: any) => any)) => ((record: any) => string);
+export declare const buildTableRowKey: (rowKey?: string | number | symbol | ((record: any) => any)) => (record: any) => string;
 /**
  * 表格行数据的浅比较：仅比较第一层字段引用/值，避免虚拟滚动时整行深比较开销。
  * 行对象在本组件场景通常为扁平标量字段；同引用时由调用方另行处理。

package/es/ProEditTable/utils/transform.d.ts

@@ -3,10 +3,10 @@ declare const _default: {
     RangePicker: () => import("@zat-design/utils/dist/esm/transforms/propTypes").Transform<any>;
     DatePicker: (fieldProps?: {
         format?: string;
-        picker?: DatePickerProps["picker"];
+        picker?: DatePickerProps['picker'];
     }) => {
         normalize: (value: any, prevValue?: any, allValues?: any) => any;
-        getValueProps?: (value: import("rc-field-form/es/interface").StoreValue) => Record<string, unknown>;
+        getValueProps?: (value: any) => Record<string, unknown>;
         shouldUpdate?: import("rc-field-form/es/Field").ShouldUpdate<any>;
     };
 };

package/es/ProEnum/components/Group.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ProEnumType } from '../propsType';
 interface Props extends Pick<ProEnumType, 'id' | 'value' | 'onChange' | 'dataSource'> {
     fieldValue: string;
@@ -6,5 +7,5 @@ interface Props extends Pick<ProEnumType, 'id' | 'value' | 'onChange' | 'dataSou
     allowClear?: boolean;
     button?: boolean;
 }
-declare const Group: (props: Props) => import("react/jsx-runtime").JSX.Element;
+declare const Group: (props: Props) => import("react").JSX.Element;
 export default Group;

package/es/ProEnum/components/Tag.d.ts

@@ -1,7 +1,8 @@
+/// <reference types="react" />
 import type { ProEnumType } from '../propsType';
 interface Props extends Pick<ProEnumType, 'id' | 'value' | 'onChange' | 'dataSource'> {
     fieldValue: string;
     fieldLabel: string;
 }
-declare const ProEnumTag: (props: Props) => import("react/jsx-runtime").JSX.Element;
+declare const ProEnumTag: (props: Props) => import("react").JSX.Element;
 export default ProEnumTag;

package/es/ProEnum/index.d.ts

@@ -1,9 +1,10 @@
+import React from 'react';
 import useEnum from './hooks/useEnum';
 import getEnum from './utils/getEnum';
 import type { ProEnumType } from './propsType';
 declare const ProEnum: {
-    (props: ProEnumType): import("react/jsx-runtime").JSX.Element;
-    getEnumLabel: (code: string | string[], value: any, compose?: boolean, fieldNameLabel?: string, fieldNameValue?: string) => import("react/jsx-runtime").JSX.Element;
+    (props: ProEnumType): React.JSX.Element;
+    getEnumLabel: (code: string | string[], value: any, compose?: boolean, fieldNameLabel?: string, fieldNameValue?: string) => React.JSX.Element;
     useEnum: typeof useEnum;
     getEnum: typeof getEnum;
 };

package/es/ProEnum/utils/getEnumLabel.d.ts

@@ -1,2 +1,3 @@
-declare const getEnumLabel: (code: string | string[], value: any, compose?: boolean, fieldNameLabel?: string, fieldNameValue?: string) => import("react/jsx-runtime").JSX.Element;
+/// <reference types="react" />
+declare const getEnumLabel: (code: string | string[], value: any, compose?: boolean, fieldNameLabel?: string, fieldNameValue?: string) => import("react").JSX.Element;
 export default getEnumLabel;

package/es/ProForm/components/FormFooter/propsType.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ButtonProps, ColProps, FormInstance } from 'antd';
 import type { ModifiedFormInstanceType } from '../../propsType';
 export interface ButtonItem extends ButtonProps {

package/es/ProForm/components/base/Input/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { Props } from './propsType';
-declare const Input: (props: Props) => import("react/jsx-runtime").JSX.Element;
+declare const Input: (props: Props) => React.JSX.Element;
 export default Input;

package/es/ProForm/components/combination/FormList/components/Empty.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { FormInstance, FormListOperation } from 'antd';
 import type { InternalNamePath } from 'antd/es/form/interface';
 import type { ToolbarActionType } from '../propsType';
@@ -9,5 +10,5 @@ interface EmptyProps {
     namePath?: InternalNamePath;
     emptyBtnText?: string;
 }
-declare const Empty: ({ disabled, toolbarProps, operation, form, namePath, emptyBtnText }: EmptyProps) => import("react/jsx-runtime").JSX.Element;
+declare const Empty: ({ disabled, toolbarProps, operation, form, namePath, emptyBtnText }: EmptyProps) => import("react").JSX.Element;
 export default Empty;

package/es/ProForm/components/combination/Group/utils/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="lodash" />
 import { InternalNamePath, NamePath } from 'antd/lib/form/interface';
 import { FormInstance, type FormItemProps } from 'antd';
 import React from 'react';

package/es/ProForm/components/combination/ProCascader/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ProCascaderType } from './propsType';
-declare const _default: import("react").MemoExoticComponent<(props: ProCascaderType) => import("react/jsx-runtime").JSX.Element>;
+declare const _default: import("react").MemoExoticComponent<(props: ProCascaderType) => import("react").JSX.Element>;
 export default _default;

package/es/ProForm/components/combination/ProNumberRange/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ProNumberRangeType } from './propsType';
 declare const _default: import("react").MemoExoticComponent<(props: ProNumberRangeType) => any>;
 export default _default;

package/es/ProForm/components/combination/ProTimeLimit/hooks/useControlled.d.ts

@@ -1,8 +1,9 @@
+import dayjs from 'dayjs';
 import type { Dayjs } from 'dayjs';
 interface Props<T = any> {
     value?: T;
     onChange?: (value: T, ...rest: any[]) => void;
     format?: string;
 }
-declare const useControlled: (props: Props) => [Dayjs | undefined, (value: Dayjs | undefined) => void];
+declare const useControlled: (props: Props) => [dayjs.Dayjs, (value: Dayjs | undefined) => void];
 export default useControlled;

package/es/ProForm/index.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { FormProviderProps } from 'antd/es/form/context';
 import type { ProFormInstanceType } from './propsType';
-declare const ProFormForward: ProFormInstanceType;
+declare const ProFormForward: ProFormInstanceType<any>;
 export declare const ProFormProvider: React.FC<FormProviderProps>;
 export default ProFormForward;

package/es/ProForm/utils/index.d.ts

@@ -76,10 +76,10 @@ export declare const getDecimalDigits: (num: number) => number;
  * @returns {}
  */
 export declare const findOptionByValue: (treeData: any[], value: string | number, fieldNames: {
+    [key: string]: any;
     label?: string;
     value?: string;
     children?: string;
-    [key: string]: any;
 }) => any;
 /** 解析namePath */
 export declare const parseNamePath: (input: string) => any;

package/es/ProForm/utils/reactiveValues.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 /** 列级响应式配置（可能为静态值或 ReactiveFunction） */
 export interface ReactiveProps {
     show?: any;

package/es/ProForm/utils/transformValue.d.ts

@@ -2,5 +2,5 @@ import { FormInstance, FormItemProps } from 'antd';
 import { NamePath } from 'antd/es/form/interface';
 import type { StoreValue, Store } from '@rc-component/form/es/interface';
 import type { TransformType } from '../propsType';
-export declare const transformValue: (names: NamePath[], form: FormInstance, fieldName: NamePath, normalize?: (value: StoreValue, prevValue: StoreValue, allValues: Store) => StoreValue, getValueProps?: FormItemProps["getValueProps"]) => TransformType;
+export declare const transformValue: (names: NamePath[], form: FormInstance, fieldName: NamePath, normalize?: (value: StoreValue, prevValue: StoreValue, allValues: Store) => StoreValue, getValueProps?: FormItemProps['getValueProps']) => TransformType;
 export default transformValue;

package/es/ProLayout/components/Layout/Menu/OpenMenu/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { OpenMenuPropsType } from './propsType';
-declare const OpenMenu: (props: OpenMenuPropsType) => import("react/jsx-runtime").JSX.Element;
+declare const OpenMenu: (props: OpenMenuPropsType) => import("react").JSX.Element;
 export default OpenMenu;

package/es/ProLayout/components/Layout/Notice/index.d.ts

@@ -1,4 +1,7 @@
-import type { FC } from 'react';
+import type { FC, Ref } from 'react';
 import type { ProLayoutType } from '../../../propTypes';
-declare const Notice: FC<ProLayoutType>;
+type NoticeProps = ProLayoutType & {
+    noticeRef?: Ref<HTMLDivElement>;
+};
+declare const Notice: FC<NoticeProps>;
 export default Notice;

package/es/ProLayout/components/Layout/Notice/index.js

@@ -6,12 +6,14 @@ const Notice = props => {
   const {
     headerHeight,
     notice,
-    onCancel
+    onCancel,
+    noticeRef
   } = props;
   if (!notice) {
     return null;
   }
   return /*#__PURE__*/_jsxs("div", {
+    ref: noticeRef,
     className: "pro-layout-header-notice",
     style: {
       top: headerHeight

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { ProCollapseType } from './PropTypes';
-declare const ProCollapse: (props: ProCollapseType) => import("react/jsx-runtime").JSX.Element;
+declare const ProCollapse: (props: ProCollapseType) => React.JSX.Element;
 export default ProCollapse;

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ProFooterType } from './PropTypes';
-declare const _default: import("react").MemoExoticComponent<(props: ProFooterType) => import("react/jsx-runtime").JSX.Element>;
+declare const _default: import("react").MemoExoticComponent<(props: ProFooterType) => import("react").JSX.Element>;
 export default _default;

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

@@ -1,4 +1,5 @@
+/// <reference types="react" />
 declare const Copy: ({ text }: {
     text: any;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;
 export default Copy;

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

@@ -6,15 +6,15 @@ type DescribeValueItem = Pick<DescribeColumnType, 'tag' | 'link' | 'value' | 'co
  * 标签渲染：数组 tag 逐个渲染，单值渲染一个，空则不渲染
  */
 export declare const DescribeTag: ({ tag, parentKey, }: {
-    tag?: DescribeColumnType["tag"];
+    tag?: DescribeColumnType['tag'];
     parentKey: string;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 /**
  * 单行值渲染：link → <a>，copyable+字符串 → 复制按钮，末尾追加 tag
  */
 export declare const DescribeValue: ({ value, link, copyable, tag, parentKey, }: DescribeValueItem & {
     parentKey: string;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 /**
  * 多值渲染：以「、」连接；超 3 个显示「共N个，」前缀；内容溢出时显示「...」并用 Tooltip 展示全部
  */
@@ -22,5 +22,5 @@ export declare const DescribeItems: ({ items, parentKey, containerRef, }: {
     items: DescribeValueItem[];
     parentKey: string;
     containerRef: React.RefObject<HTMLDivElement>;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 export {};

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

@@ -1,4 +1,4 @@
 import React from 'react';
 import type { ProHeaderType } from './PropTypes';
-declare const _default: React.MemoExoticComponent<(props: ProHeaderType) => import("react/jsx-runtime").JSX.Element>;
+declare const _default: React.MemoExoticComponent<(props: ProHeaderType) => React.JSX.Element>;
 export default _default;

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

@@ -372,9 +372,10 @@ const ProHeader = props => {
   // has = 有次级描述 或 有主级描述；no = 无主级描述。二者非严格互斥（原实现即如此，未改动其行为）。
   const noDescribe = _isEmpty(describeColumns);
   const hasDescribe = !_isEmpty(finalSubDescribeColumns) || !noDescribe;
+  const hasFixedTop = fixedTop !== undefined && fixedTop !== null;
   const cls = classnames({
     'pro-header': true,
-    'pro-header-fixed': fixedTop,
+    'pro-header-fixed': hasFixedTop,
     'pro-header-shadow': showShadow,
     // 内部窗口滚动自带阴影场景
     'pro-header-no-back': !backState,
@@ -425,7 +426,9 @@ const ProHeader = props => {
     className: cls,
     style: {
       ...style,
-      top: fixedTop,
+      ...(hasFixedTop ? {
+        top: fixedTop
+      } : {}),
       zIndex
     },
     children: finalTitle ? /*#__PURE__*/_jsx("div", {

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

@@ -13,7 +13,7 @@ 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;
+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} */

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

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

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { ProLayoutTabsInstance } from '../../../propTypes';
 /**
  * 标签页实例 Context，用于在 ProLayout children 中访问标签页 API

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { TabsProps } from 'antd';
 export interface TabsHeaderProps {
     activeKey: string | undefined;
@@ -7,4 +8,4 @@ export interface TabsHeaderProps {
     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;
+export declare function TabsHeader({ activeKey, tabsItems, onTabChange, onTabEdit, draggable, onReorder, }: TabsHeaderProps): React.JSX.Element;

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

@@ -3,7 +3,7 @@ import { message } from 'antd';
 import { DEFAULT_TABS_CONFIG } from "../propTypes";
 import { useTabsCache } from "./useTabsCache";
 import locale, { formatMessage } from "../../../../locale";
-import { createTabFromMenu, generateTabId, shouldOpenExternal, handleExternalOpen, checkTabLimit, getRightTabs, flattenMenuData, canOpenAsTab, getMenuRoute, findExistingTab, derivePinned, pinTab as pinTabInList, unpinTab as unpinTabInList, reorderWithPinConstraint } from "../utils";
+import { createTabFromMenu, generateTabId, shouldOpenExternal, handleExternalOpen, checkTabLimit, getRightTabs, flattenMenuData, canOpenAsTab, getMenuRoute, findExistingTab, resolveTabMenuItem, derivePinned, getPinnedBoundary, pinTab as pinTabInList, unpinTab as unpinTabInList, reorderWithPinConstraint } from "../utils";
 
 /**
  * 标签页状态管理Hook
@@ -74,6 +74,7 @@ export const useTabsState = options => {
   }, [restoreFromCache]);
   const lastActiveKeyRef = useRef('');
   const shouldSkipSaveRef = useRef(false);
+  const initialTabsAppliedRef = useRef(false);
 
   // 保存状态到缓存
   useEffect(() => {
@@ -186,12 +187,14 @@ export const useTabsState = options => {
       const tabId = generateTabId(menuItem, existingIds);
       const newTab = createTabFromMenu(menuItem, prevState.newTabIndex);
       newTab.id = tabId;
+      const pinnedBoundary = getPinnedBoundary(prevState.tabsList);
+      const nextTabsList = derivePinned(newTab) ? [...prevState.tabsList.slice(0, pinnedBoundary), newTab, ...prevState.tabsList.slice(pinnedBoundary)] : [...prevState.tabsList, newTab];
 
       // silent=true 时,若已有 active 则保留;无 active(首次进入)仍激活以保留默认行为
       const shouldActivate = !silent || prevState.activeKey === '';
       return {
         ...prevState,
-        tabsList: [...prevState.tabsList, newTab],
+        tabsList: nextTabsList,
         activeKey: shouldActivate ? tabId : prevState.activeKey,
         activeTabInfo: shouldActivate ? newTab : prevState.activeTabInfo,
         newTabIndex: prevState.newTabIndex + 1,
@@ -200,6 +203,23 @@ export const useTabsState = options => {
     });
   }, [finalConfig]);
 
+  // 普通初始标签只在当前 TabsManager 挂载周期应用一次。
+  // 缓存恢复已有标签时只消费默认值；closeAll 后 ref 保持 true，避免再次补签。
+  useEffect(() => {
+    const initialTabs = finalConfig.initialTabs;
+    if (!isInitialized || !cacheEnabled || initialTabsAppliedRef.current || !initialTabs || initialTabs.length === 0) {
+      return;
+    }
+    initialTabsAppliedRef.current = true;
+    if (state.tabsList.length > 0) return;
+    const sourceMenus = Array.isArray(dataSource?.menus) ? dataSource.menus : [];
+    initialTabs.forEach(params => {
+      addTab(resolveTabMenuItem(params, sourceMenus), {
+        silent: true
+      });
+    });
+  }, [isInitialized, cacheEnabled, finalConfig.initialTabs, dataSource, state.tabsList.length, addTab]);
+
   /**
    * 更新已存在标签页的展示信息（保持 tab.id 不变 → 子组件不会 unmount）
    * - 仅允许更新 name / icon / extra / closable

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { TabsManagerProps } from './propTypes';
 /**
  * 标签页管理器主组件

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

@@ -1,8 +1,8 @@
-import { useCallback, useMemo, forwardRef, useImperativeHandle, useState, useEffect, useRef } from 'react';
+import { useCallback, useMemo, forwardRef, useImperativeHandle, useState, useEffect, useLayoutEffect, useRef } from 'react';
 import { createPortal } from 'react-dom';
 import { useTabsState } from "./hooks/useTabsState";
 import { useIframeRoute } from "./hooks/useIframeRoute";
-import { flattenMenuData, derivePinned } from "./utils";
+import { flattenMenuData, resolveTabMenuItem, derivePinned } from "./utils";
 import { TabItemComponent } from "./components/TabItem";
 import { TabsHeader } from "./components/TabsHeader";
 import { TabsContext } from "./components/TabsContext";
@@ -31,9 +31,14 @@ const TabsManager = /*#__PURE__*/forwardRef(({
   });
 
   // 通知父级(ProLayout)pure 状态变化
-  useEffect(() => {
+  useLayoutEffect(() => {
     onIframePureChange?.(isIframePure);
   }, [isIframePure, onIframePureChange]);
+
+  // TabsManager 退出 tabs 模式或上报目标变更时，释放旧父级持有的 pure 状态。
+  useLayoutEffect(() => () => {
+    onIframePureChange?.(false);
+  }, [onIframePureChange]);
   const {
     state,
     isInitialized,
@@ -150,10 +155,15 @@ const TabsManager = /*#__PURE__*/forwardRef(({
   }, [state.tabsList]);
 
   // 通知父级（ProLayout）当前是否有 Tab
-  useEffect(() => {
+  useLayoutEffect(() => {
     onTabsChange?.(state.tabsList.length > 0);
   }, [state.tabsList.length, onTabsChange]);
 
+  // 卸载时显式复位，避免 ProLayout 在动态退出 tabs 模式后保留偏移状态。
+  useLayoutEffect(() => () => {
+    onTabsChange?.(false);
+  }, [onTabsChange]);
+
   // 处理声明式固定标签页：config.fixed 中的 code 在初始化完成后自动添加，强制 closable=false
   // 用 ref 持有 addTab，避免 addTab 引用变化引起无限循环
   const addTabRef = useRef(addTab);
@@ -221,28 +231,8 @@ const TabsManager = /*#__PURE__*/forwardRef(({
   // 创建标签页实例 API
   const tabsInstance = useMemo(() => ({
     addTab: (params, options) => {
-      const {
-        code,
-        name,
-        extra,
-        relationKey
-      } = params;
-      const sourceMenus = Array.isArray(dataSource?.menus) ? flattenMenuData(dataSource.menus) : [];
-      const matchedMenu = sourceMenus.find(item => item.code === code);
-      const menuItem = matchedMenu ? {
-        ...matchedMenu,
-        // 允许外部覆盖展示名称和附加数据，但保留菜单原始 closable/url 等配置
-        name: name || matchedMenu.name,
-        extra: extra ?? matchedMenu.extra,
-        relationKey: relationKey ?? matchedMenu.relationKey
-      } : {
-        id: Date.now(),
-        code,
-        name,
-        url: `/${code}`,
-        extra,
-        relationKey
-      };
+      const sourceMenus = Array.isArray(dataSource?.menus) ? dataSource.menus : [];
+      const menuItem = resolveTabMenuItem(params, sourceMenus);
       addTab(menuItem, options);
     },
     removeTab,

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

@@ -1,10 +1,10 @@
-import { TabItem, MenusType } from '../../../propTypes';
+import { AddTabParams, TabItem, MenusType } from '../../../propTypes';
 /**
  * 获取菜单实际用于路由/签页的路径
  * 约定优先使用 redirectUrl，其次回退 url
  */
 export declare const getMenuRoute: (menuItem: MenusType) => string;
-export declare const hasRelationKey: (relationKey: MenusType["relationKey"]) => relationKey is string | number;
+export declare const hasRelationKey: (relationKey: MenusType['relationKey']) => relationKey is string | number;
 export declare const findExistingTab: (tabsList: TabItem[], menuItem: MenusType) => TabItem | undefined;
 /**
  * 根据菜单项生成TabItem
@@ -37,6 +37,10 @@ export declare const getRightTabs: (tabs: TabItem[], currentTabId: string) => Ta
  * 扁平化菜单数据
  */
 export declare const flattenMenuData: (menus?: MenusType[]) => MenusType[];
+/**
+ * 将公开 addTab 参数解析为内部菜单项，统一 initialTabs 与实例 API 的匹配规则。
+ */
+export declare const resolveTabMenuItem: (params: AddTabParams, menus?: MenusType[]) => MenusType;
 /**
  * 判断菜单项是否为最后一级（叶子节点）
  * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点

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

@@ -107,6 +107,29 @@ export const flattenMenuData = (menus = []) => {
   return flatMenus;
 };
 
+/**
+ * 将公开 addTab 参数解析为内部菜单项，统一 initialTabs 与实例 API 的匹配规则。
+ */
+export const resolveTabMenuItem = (params, menus = []) => {
+  const matchedMenu = flattenMenuData(menus).find(item => item.code === params.code);
+  if (matchedMenu) {
+    return {
+      ...matchedMenu,
+      name: params.name || matchedMenu.name,
+      extra: params.extra ?? matchedMenu.extra,
+      relationKey: params.relationKey ?? matchedMenu.relationKey
+    };
+  }
+  return {
+    id: Date.now(),
+    code: params.code,
+    name: params.name,
+    url: `/${params.code}`,
+    extra: params.extra,
+    relationKey: params.relationKey
+  };
+};
+
 /**
  * 判断菜单项是否为最后一级（叶子节点）
  * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点