@zat-design/sisyphus-react 4.5.9 → 4.5.10-beta.2

package/es/ProLayout/index.js

@@ -1,8 +1,7 @@
-/* eslint-disable func-call-spacing */
-/* eslint-disable no-spaced-func */
-import { createContext, useMemo, useRef, useCallback, useLayoutEffect, useState } from 'react';
-import classNames from 'classnames';
-import { useSetState, useToggle, useDeepCompareEffect } from 'ahooks';
+import { jsx, jsxs } from "react/jsx-runtime";
+import { createContext, useMemo, useRef, useCallback, useLayoutEffect, useState } from "react";
+import classNames from "classnames";
+import { useSetState, useToggle, useDeepCompareEffect } from "ahooks";
 import { ProWaterMark } from "../index";
 import { ProCollapse, ProFooter, ProHeader } from "./components";
 import { Header, Notice, Menu } from "./components/Layout/index";
@@ -11,17 +10,15 @@ import { isTabsMode, validateTabsProps } from "./propTypes";
 import { useProLayoutTabs } from "./components/TabsManager/hooks/useProLayoutTabs";
 import { useActiveTab } from "./components/TabsManager/hooks/useActiveTab";
 import { transformMenus } from "./utils";
-import { canOpenAsTab } from "./components/TabsManager/utils";
+import { canOpenAsTab, flattenMenuData } from "./components/TabsManager/utils";
 import headerBg from "../assets/header_bg.png";
-
-// 全局上下文
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-export const LayoutContext = /*#__PURE__*/createContext(undefined);
+const LayoutContext = createContext(void 0);
 const TABS_HEADER_MEASURE_SELECTOR = '[data-pro-layout-tabs-measure="true"]';
-const ProLayout = props => {
+const ProLayout = (props) => {
+  var _a;
   const {
     children,
-    className = '',
+    className = "",
     pure = false,
     headerHeight = 64,
     contentStyle = {},
@@ -30,7 +27,7 @@ const ProLayout = props => {
     notice: noticeIn,
     // 修改别名
     dataSource,
-    pathPrefix = '',
+    pathPrefix = "",
     target,
     onCollapsedChange,
     collapsed: propsCollapsed = false,
@@ -39,108 +36,89 @@ const ProLayout = props => {
     headerTitleRender,
     headerContentRender,
     rightContentRender,
-    title = '',
+    title = "",
     logo,
     appsOptions,
     // Menu组件需要的props
-    iconfontUrl = '',
+    iconfontUrl = "",
     sideMenuFooterRender,
     sideMenuHeaderRender,
-    mode = 'normal',
+    mode = "normal",
     tabs
   } = props;
   const isTabsLayout = isTabsMode(props);
   validateTabsProps(mode, tabs);
   const tabsManagerRef = useRef(null);
-
-  // Tab 栏 Portal 挂载目标及动画状态
-  const [{
-    tabsBarEl,
-    hasTabs,
-    isIframePure
-  }, setTabsState] = useSetState({
-    tabsBarEl: null,
-    hasTabs: false,
-    isIframePure: false
-  });
-  // 稳定的 ref 回调，避免内联函数每次渲染都触发 setState 导致无限循环
-  const setTabsBarElRef = useCallback(el => setTabsState({
-    tabsBarEl: el
-  }), []);
-  // TabsManager 会在 layout effect 中调用这两个回调；保持引用稳定，避免父组件每次
-  // render 都让 layout effect 重新执行并再次 setState，形成无限更新循环。
-  const handleTabsChange = useCallback(v => setTabsState({
-    hasTabs: v
-  }), []);
-  const handleIframePureChange = useCallback(v => setTabsState({
-    isIframePure: v
-  }), []);
+  const [{ tabsBarEl, hasTabs, isIframePure }, setTabsState] = useSetState({ tabsBarEl: null, hasTabs: false, isIframePure: false });
+  const setTabsBarElRef = useCallback(
+    (el) => setTabsState({ tabsBarEl: el }),
+    []
+  );
+  const handleTabsChange = useCallback((v) => setTabsState({ hasTabs: v }), []);
+  const handleIframePureChange = useCallback((v) => setTabsState({ isIframePure: v }), []);
   const noticeElRef = useRef(null);
-  const setNoticeElRef = useCallback(el => {
+  const setNoticeElRef = useCallback((el) => {
     noticeElRef.current = el;
   }, []);
-  const [stickyHeights, setStickyHeights] = useState({
-    notice: 0,
-    tabsBar: 0
-  });
-  const [{
-    notice,
-    menus,
-    selectedPath
-  }, setState] = useSetState({
+  const [stickyHeights, setStickyHeights] = useState({ notice: 0, tabsBar: 0 });
+  const [{ notice, menus, selectedPath }, setState] = useSetState({
     notice: headerNotice || noticeIn,
     menus: [],
-    selectedPath: ''
+    selectedPath: ""
   });
   useLayoutEffect(() => {
     const noticeEl = notice && !isIframePure ? noticeElRef.current : null;
     const visibleTabsBarEl = isTabsLayout && hasTabs && !isIframePure ? tabsBarEl : null;
-    const visibleTabsHeaderEl = visibleTabsBarEl?.querySelector(TABS_HEADER_MEASURE_SELECTOR);
+    const visibleTabsHeaderEl = visibleTabsBarEl == null ? void 0 : visibleTabsBarEl.querySelector(
+      TABS_HEADER_MEASURE_SELECTOR
+    );
     let active = true;
     let animationFrameId;
     const measureStickyElements = () => {
-      if (!active) return;
+      if (!active)
+        return;
       const nextHeights = {
-        notice: noticeEl?.getBoundingClientRect().height ?? 0,
-        tabsBar: visibleTabsHeaderEl?.getBoundingClientRect().height ?? 0
+        notice: (noticeEl == null ? void 0 : noticeEl.getBoundingClientRect().height) ?? 0,
+        tabsBar: (visibleTabsHeaderEl == null ? void 0 : visibleTabsHeaderEl.getBoundingClientRect().height) ?? 0
       };
-      setStickyHeights(currentHeights => currentHeights.notice === nextHeights.notice && currentHeights.tabsBar === nextHeights.tabsBar ? currentHeights : nextHeights);
+      setStickyHeights(
+        (currentHeights) => currentHeights.notice === nextHeights.notice && currentHeights.tabsBar === nextHeights.tabsBar ? currentHeights : nextHeights
+      );
     };
     measureStickyElements();
-    if (typeof window.requestAnimationFrame === 'function') {
+    if (typeof window.requestAnimationFrame === "function") {
       animationFrameId = window.requestAnimationFrame(measureStickyElements);
     }
-    const handleTabsTransitionEnd = event => {
-      if (event.target === visibleTabsBarEl && event.propertyName === 'grid-template-rows') {
+    const handleTabsTransitionEnd = (event) => {
+      if (event.target === visibleTabsBarEl && event.propertyName === "grid-template-rows") {
         measureStickyElements();
       }
     };
-    visibleTabsBarEl?.addEventListener('transitionend', handleTabsTransitionEnd);
-    const observedElements = [noticeEl, visibleTabsHeaderEl].filter(element => element !== null && element !== undefined);
-    if (observedElements.length === 0 || typeof ResizeObserver === 'undefined') {
+    visibleTabsBarEl == null ? void 0 : visibleTabsBarEl.addEventListener("transitionend", handleTabsTransitionEnd);
+    const observedElements = [noticeEl, visibleTabsHeaderEl].filter(
+      (element) => element !== null && element !== void 0
+    );
+    if (observedElements.length === 0 || typeof ResizeObserver === "undefined") {
       return () => {
         active = false;
-        if (animationFrameId !== undefined) {
+        if (animationFrameId !== void 0) {
           window.cancelAnimationFrame(animationFrameId);
         }
-        visibleTabsBarEl?.removeEventListener('transitionend', handleTabsTransitionEnd);
+        visibleTabsBarEl == null ? void 0 : visibleTabsBarEl.removeEventListener("transitionend", handleTabsTransitionEnd);
       };
     }
     const resizeObserver = new ResizeObserver(measureStickyElements);
-    observedElements.forEach(element => resizeObserver.observe(element));
+    observedElements.forEach((element) => resizeObserver.observe(element));
     return () => {
       active = false;
-      if (animationFrameId !== undefined) {
+      if (animationFrameId !== void 0) {
         window.cancelAnimationFrame(animationFrameId);
       }
-      visibleTabsBarEl?.removeEventListener('transitionend', handleTabsTransitionEnd);
+      visibleTabsBarEl == null ? void 0 : visibleTabsBarEl.removeEventListener("transitionend", handleTabsTransitionEnd);
       resizeObserver.disconnect();
     };
   }, [hasTabs, isIframePure, isTabsLayout, notice, tabsBarEl]);
-  const [collapsed, {
-    toggle,
-    set
-  }] = useToggle(props.collapsed || false);
+  const [collapsed, { toggle, set }] = useToggle(props.collapsed || false);
   useDeepCompareEffect(() => {
     set(props.collapsed || false);
   }, [props.collapsed]);
@@ -149,27 +127,17 @@ const ProLayout = props => {
       return;
     }
     const userData = transformMenus(dataSource, pathPrefix);
-    // 确保 menus 始终是一个数组
-    const menuData = Array.isArray(userData) ? userData : userData?.menus || [];
-    setState({
-      menus: menuData
-    });
+    const menuData = Array.isArray(userData) ? userData : (userData == null ? void 0 : userData.menus) || [];
+    setState({ menus: menuData });
   }, [dataSource]);
   const menuDataSource = useMemo(() => {
-    // menus 已通过 useDeepCompareEffect 填充，直接使用
     if (Array.isArray(menus) && menus.length > 0) {
-      return {
-        menus
-      };
+      return { menus };
     }
-    // menus state 尚未填充（初始为 []），直接用 dataSource 原始 menus，
-    // 确保 tabsInstance 第一次创建时就能查到完整菜单数据（含 closable 等属性）
-    if (!Array.isArray(dataSource) && Array.isArray(dataSource?.menus)) {
+    if (!Array.isArray(dataSource) && Array.isArray(dataSource == null ? void 0 : dataSource.menus)) {
       return dataSource;
     }
-    return {
-      menus: menus || []
-    };
+    return { menus: menus || [] };
   }, [menus, dataSource]);
   const enhancedTabsConfig = useMemo(() => {
     if (!isTabsLayout || !tabs) {
@@ -178,99 +146,80 @@ const ProLayout = props => {
     return {
       ...tabs,
       onTabChange: (activeKey, activeTab, allTabs) => {
+        var _a2, _b, _c, _d, _e;
         if (!allTabs || allTabs.length === 0) {
-          // 使用一个不可能匹配的路径来清除选中状态，避免 OpenMenu fallback 到 window.location.pathname
-          setState({
-            selectedPath: '##EMPTY##'
-          });
+          setState({ selectedPath: "##EMPTY##" });
           return;
         }
-        const targetPath = activeTab?.url || activeTab?.menuItem?.router || activeTab?.menuItem?.redirectUrl || activeTab?.menuItem?.url;
+        const menuCodeSource = (_a2 = activeTab == null ? void 0 : activeTab.menuCodeSource) == null ? void 0 : _a2.trim();
+        const sourceMenu = menuCodeSource ? flattenMenuData(menuDataSource.menus).find((menu) => menu.code === menuCodeSource) : void 0;
+        const sourcePath = (sourceMenu == null ? void 0 : sourceMenu.redirectUrl) || (sourceMenu == null ? void 0 : sourceMenu.url) || (sourceMenu == null ? void 0 : sourceMenu.router);
+        const targetPath = sourcePath || (activeTab == null ? void 0 : activeTab.url) || ((_b = activeTab == null ? void 0 : activeTab.menuItem) == null ? void 0 : _b.router) || ((_c = activeTab == null ? void 0 : activeTab.menuItem) == null ? void 0 : _c.redirectUrl) || ((_d = activeTab == null ? void 0 : activeTab.menuItem) == null ? void 0 : _d.url);
         if (targetPath && targetPath !== selectedPath) {
-          setState({
-            selectedPath: targetPath
-          });
+          setState({ selectedPath: targetPath });
         }
-        tabs.onTabChange?.(activeKey, activeTab, allTabs);
+        (_e = tabs.onTabChange) == null ? void 0 : _e.call(tabs, activeKey, activeTab, allTabs);
       }
     };
-  }, [isTabsLayout, tabs, selectedPath]);
+  }, [isTabsLayout, menuDataSource.menus, tabs, selectedPath]);
   const renderContent = () => {
     if (!isTabsLayout || !enhancedTabsConfig) {
-      return /*#__PURE__*/_jsx("div", {
-        children: children
-      });
+      return /* @__PURE__ */ jsx("div", { children });
     }
-    return /*#__PURE__*/_jsx(TabsManager, {
-      ref: tabsManagerRef,
-      config: enhancedTabsConfig,
-      dataSource: menuDataSource,
-      originalOnMenuClick: onMenuClick,
-      tabsBarContainer: tabsBarEl,
-      onTabsChange: handleTabsChange,
-      onIframePureChange: handleIframePureChange,
-      children: children
-    });
+    return /* @__PURE__ */ jsx(
+      TabsManager,
+      {
+        ref: tabsManagerRef,
+        config: enhancedTabsConfig,
+        dataSource: menuDataSource,
+        originalOnMenuClick: onMenuClick,
+        tabsBarContainer: tabsBarEl,
+        onTabsChange: handleTabsChange,
+        onIframePureChange: handleIframePureChange,
+        children
+      }
+    );
   };
-  const handleMenuClick = useCallback(params => {
-    // 非 tabs 模式，直接调用原始回调并允许激活
-    if (!isTabsLayout) {
-      onMenuClick?.(params);
-      return true;
-    }
-
-    // tabs 模式：调用 TabsManager 的 handleMenuClick 来添加标签页
-    tabsManagerRef.current?.handleMenuClick?.(params);
-    if (!params.item) {
-      return true;
-    }
-
-    // 只有叶子节点（无 children）可入签；有 children 的节点不激活
-    if (!canOpenAsTab(params.item)) {
-      return false;
-    }
-
-    // 可入签节点：检查是否可以添加标签页（检查 max 限制、_blank 等）
-    const canAdd = tabsManagerRef.current?.canAddTab?.(params.item);
-    if (!canAdd) {
-      // 超过限制，返回 false 阻止菜单激活
+  const handleMenuClick = useCallback(
+    (params) => {
+      var _a2, _b, _c, _d, _e, _f, _g;
+      if (!isTabsLayout) {
+        onMenuClick == null ? void 0 : onMenuClick(params);
+        return true;
+      }
+      (_b = (_a2 = tabsManagerRef.current) == null ? void 0 : _a2.handleMenuClick) == null ? void 0 : _b.call(_a2, params);
+      if (!params.item) {
+        return true;
+      }
+      if (!canOpenAsTab(params.item)) {
+        return false;
+      }
+      const canAdd = (_d = (_c = tabsManagerRef.current) == null ? void 0 : _c.canAddTab) == null ? void 0 : _d.call(_c, params.item);
+      if (!canAdd) {
+        return false;
+      }
+      const targetPath = ((_e = params.item) == null ? void 0 : _e.redirectUrl) || ((_f = params.item) == null ? void 0 : _f.url) || ((_g = params.item) == null ? void 0 : _g.router);
+      if (targetPath && targetPath !== selectedPath) {
+        setState({ selectedPath: targetPath });
+      }
       return false;
-    }
-
-    // 可以添加标签页，设置选中路径（激活菜单）
-    const targetPath = params.item?.redirectUrl || params.item?.url || params.item?.router;
-    if (targetPath && targetPath !== selectedPath) {
-      setState({
-        selectedPath: targetPath
-      });
-    }
-    // tabs 模式下由 Tab 管理内容，阻止菜单默认 Link 跳转
-    return false;
-  }, [isTabsLayout, onMenuClick, selectedPath]);
-
-  /**
-   * 关闭提示框
-   */
+    },
+    [isTabsLayout, onMenuClick, selectedPath]
+  );
   const onCancelNotice = () => {
-    setState({
-      notice: null
-    });
+    setState({ notice: null });
   };
   const contentCls = classNames({
-    'pro-layout-row': true,
-    'pro-layout-row-has-notice': notice,
-    'pro-layout-row-pure': typeof pure === 'boolean' && pure,
-    'pro-layout-row-top-pure': typeof pure !== 'boolean' && pure.topMenu,
-    'pro-layout-row-left-pure': typeof pure !== 'boolean' && pure.leftMenu
+    "pro-layout-row": true,
+    "pro-layout-row-has-notice": notice,
+    "pro-layout-row-pure": typeof pure === "boolean" && pure,
+    "pro-layout-row-top-pure": typeof pure !== "boolean" && pure.topMenu,
+    "pro-layout-row-left-pure": typeof pure !== "boolean" && pure.leftMenu
   });
   const noticeHeight = stickyHeights.notice;
-
-  // pure 模式下 Header 不渲染，有效头部高度为 0
-  const isPureHeader = typeof pure === 'boolean' ? pure : !!pure?.topMenu;
+  const isPureHeader = typeof pure === "boolean" ? pure : !!(pure == null ? void 0 : pure.topMenu);
   const effectiveHeaderHeight = isPureHeader ? 0 : headerHeight;
   const contentStickyTop = effectiveHeaderHeight + noticeHeight + (hasTabs ? stickyHeights.tabsBar : 0);
-
-  // 为Header组件创建专门的props对象
   const headerProps = {
     headerHeight,
     pure,
@@ -281,21 +230,15 @@ const ProLayout = props => {
     logo,
     appsOptions
   };
-
-  // 为Notice组件创建专门的props对象
   const noticeProps = {
     headerHeight: effectiveHeaderHeight,
     notice,
     onCancel: onCancelNotice,
     noticeRef: setNoticeElRef
   };
-
-  // 为Menu组件创建专门的props对象
   const menuProps = {
     headerHeight,
-    dataSource: Array.isArray(menus) ? {
-      menus
-    } : menus,
+    dataSource: Array.isArray(menus) ? { menus } : menus,
     iconfontUrl,
     collapsed,
     notice,
@@ -309,72 +252,74 @@ const ProLayout = props => {
     onMenuClick: handleMenuClick,
     appsOptions
   };
-  const layoutDom = isIframePure ?
-  /*#__PURE__*/
-  /* iframe pure 模式:仅渲染 TabsManager 内容,不渲染 Header/Notice/Menu/tabsBar */
-  _jsx("div", {
-    className: classNames({
-      'pro-layout': true,
-      'pro-layout-light': true,
-      'pro-layout-iframe-pure': true,
-      [`${className}`]: className
-    }),
-    children: renderContent()
-  }) : /*#__PURE__*/_jsxs("div", {
-    className: classNames({
-      'pro-layout': true,
-      'pro-layout-light': true,
-      'pro-layout-pure': typeof pure === 'boolean' ? pure : pure?.topMenu || pure?.leftMenu,
-      [`${className}`]: className
-    }),
-    style: {
-      '--header-bg-image': `url(${headerBg})`,
-      '--pro-layout-header-height': `${effectiveHeaderHeight}px`,
-      '--pro-layout-notice-height': `${noticeHeight}px`,
-      '--pro-layout-content-sticky-top': `${contentStickyTop}px`
-    },
-    children: [/*#__PURE__*/_jsx(Header, {
-      ...headerProps
-    }), /*#__PURE__*/_jsx(Notice, {
-      ...noticeProps
-    }), /*#__PURE__*/_jsx("div", {
-      ref: setTabsBarElRef,
-      className: `pro-layout-tabs-bar-wrapper${hasTabs ? ' tabs-visible' : ''}${collapsed ? ' tabs-menu-open' : ''}`,
-      style: {
-        marginTop: effectiveHeaderHeight + noticeHeight
-      }
-    }), /*#__PURE__*/_jsxs("div", {
-      className: contentCls,
-      children: [/*#__PURE__*/_jsx(Menu, {
-        ...menuProps
-      }), /*#__PURE__*/_jsx("div", {
-        className: `pro-layout-content${hasTabs ? ' pro-layout-content-has-tabs' : ''}`,
-        style: {
-          ...contentStyle,
-          marginTop: 0
-        },
+  const layoutDom = isIframePure ? (
+    /* iframe pure 模式:仅渲染 TabsManager 内容,不渲染 Header/Notice/Menu/tabsBar */
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: classNames({
+          "pro-layout": true,
+          "pro-layout-light": true,
+          "pro-layout-iframe-pure": true,
+          [`${className}`]: className
+        }),
         children: renderContent()
-      })]
-    })]
-  });
-  return /*#__PURE__*/_jsx(LayoutContext.Provider, {
-    value: {
-      selectedPath,
-      target,
-      onSelected: setState
-    },
-    children: !Object.keys(waterMarkProps)?.length ? layoutDom : /*#__PURE__*/_jsx(ProWaterMark, {
-      ...waterMarkProps,
-      children: layoutDom
-    })
-  });
+      }
+    )
+  ) : /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: classNames({
+        "pro-layout": true,
+        "pro-layout-light": true,
+        "pro-layout-pure": typeof pure === "boolean" ? pure : (pure == null ? void 0 : pure.topMenu) || (pure == null ? void 0 : pure.leftMenu),
+        [`${className}`]: className
+      }),
+      style: {
+        "--header-bg-image": `url(${headerBg})`,
+        "--pro-layout-header-height": `${effectiveHeaderHeight}px`,
+        "--pro-layout-notice-height": `${noticeHeight}px`,
+        "--pro-layout-content-sticky-top": `${contentStickyTop}px`
+      },
+      children: [
+        /* @__PURE__ */ jsx(Header, { ...headerProps }),
+        /* @__PURE__ */ jsx(Notice, { ...noticeProps }),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            ref: setTabsBarElRef,
+            className: `pro-layout-tabs-bar-wrapper${hasTabs ? " tabs-visible" : ""}${collapsed ? " tabs-menu-open" : ""}`,
+            style: { marginTop: effectiveHeaderHeight + noticeHeight }
+          }
+        ),
+        /* @__PURE__ */ jsxs("div", { className: contentCls, children: [
+          /* @__PURE__ */ jsx(Menu, { ...menuProps }),
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: `pro-layout-content${hasTabs ? " pro-layout-content-has-tabs" : ""}`,
+              style: {
+                ...contentStyle,
+                marginTop: 0
+              },
+              children: renderContent()
+            }
+          )
+        ] })
+      ]
+    }
+  );
+  return /* @__PURE__ */ jsx(LayoutContext.Provider, { value: { selectedPath, target, onSelected: setState }, children: !((_a = Object.keys(waterMarkProps)) == null ? void 0 : _a.length) ? layoutDom : /* @__PURE__ */ jsx(ProWaterMark, { ...waterMarkProps, children: layoutDom }) });
 };
 ProLayout.ProCollapse = ProCollapse;
 ProLayout.ProFooter = ProFooter;
 ProLayout.ProHeader = ProHeader;
 ProLayout.useProLayoutTabs = useProLayoutTabs;
 ProLayout.useActiveTab = useActiveTab;
-
-// 同时导出Hook供直接使用
-export { useProLayoutTabs, useActiveTab };
-export default ProLayout;
+var ProLayout_default = ProLayout;
+export {
+  LayoutContext,
+  ProLayout_default as default,
+  useActiveTab,
+  useProLayoutTabs
+};

package/es/ProLayout/propTypes.d.ts

@@ -321,7 +321,7 @@ export interface TabItem {
      */
     title: string;
     /**
-     * @description 标签关联路由
+     * @description 标签关联路由。URL 同步模式下保存当前完整的 pathname + search + hash
      */
     url?: string;
     /**
@@ -349,6 +349,10 @@ export interface TabItem {
      * @description 标签页关联键；用于业务详情页复用已有标签页
      */
     relationKey?: string | number;
+    /**
+     * @description 最初打开当前业务标签链路的左侧菜单 code；仅用于激活来源菜单
+     */
+    menuCodeSource?: string;
 }
 export interface TabsState {
     tabsList: TabItem[];
@@ -358,6 +362,13 @@ export interface TabsState {
     activeComponent?: string;
 }
 export type TabsStorageStrategy = 'localStorage' | 'sessionStorage';
+export interface TabsUrlSyncConfig {
+    /**
+     * @description 切换标签页时写入浏览器历史的方式
+     * @default 'replace'
+     */
+    history?: 'replace' | 'push';
+}
 /**
  * @description 添加标签页的业务参数
  */
@@ -370,6 +381,11 @@ export interface AddTabParams {
      * @description 标签页显示名称
      */
     name: string;
+    /**
+     * @description 应用内完整 URL。URL 同步模式下作为页签业务身份
+     * @example '/wjs/workbench/workbench/Record?recordTab=quote'
+     */
+    url?: string;
     /**
      * @description 额外的业务数据
      */
@@ -378,6 +394,10 @@ export interface AddTabParams {
      * @description 标签页关联键；相同关联键的业务详情重复打开时复用已有标签页
      */
     relationKey?: string | number;
+    /**
+     * @description 最初打开当前业务标签链路的左侧菜单 code；仅用于激活来源菜单
+     */
+    menuCodeSource?: string;
 }
 /**
  * @description 添加标签页的选项
@@ -519,6 +539,13 @@ export interface TabsConfig {
     max?: number;
     storage?: TabsStorageStrategy;
     cacheKey?: string;
+    /**
+     * @description 是否将活动页签与浏览器 URL 双向同步。默认不同步，保持现有行为
+     * - true: 开启同步，切换页签时使用 replace
+     * - object: 开启同步并自定义历史写入方式
+     * @default false
+     */
+    urlSync?: boolean | TabsUrlSyncConfig;
     /**
      * @description 普通初始标签页。无缓存时每次 ProLayout 挂载只初始化一次；关闭全部后本次挂载期间不会重新添加
      */