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

package/es/ProForm/components/combination/ProModalSelect/index.js

@@ -168,8 +168,9 @@ const ProModalSelect = (props, ref) => {
     transformParams,
     transformResponse
   }, {
-    ready: (initParams || defaultOne) && nextMode === 'input' || open,
-    ...useRequest?.options
+    ...useRequest?.options,
+    ready: useRequest?.options?.ready ?? ((initParams || defaultOne) && nextMode === 'input' ? true : undefined),
+    manual: useRequest?.options?.manual ?? ((initParams || defaultOne) && nextMode === 'input' ? undefined : true)
   });
   const defaultOptionRender = rowData => rowData?.[labelKey];
   let handleFormat = onFormat || defaultOptionRender;
@@ -190,6 +191,16 @@ const ProModalSelect = (props, ref) => {
     if (typeof data === 'string' || typeof data === 'number') {
       return data;
     }
+    // lodash isObject 对数组也为 true，必须先判数组，否则多选展示永远走对象臂
+    if (_isArray(data)) {
+      return data.map(item => {
+        return handleFormat({
+          ...item,
+          value: item[valueKey],
+          label: item[labelKey]
+        });
+      }).join('、');
+    }
     if (_isObject(data)) {
       return handleFormat({
         ...data,
@@ -197,13 +208,7 @@ const ProModalSelect = (props, ref) => {
         label: data[labelKey]
       });
     }
-    return _isArray(data) ? data?.map(item => {
-      return handleFormat({
-        ...item,
-        value: item[valueKey],
-        label: item[labelKey]
-      });
-    })?.join('、') : '';
+    return '';
   };
   const viewText = useMemo(() => {
     let nextValue = labelInValue ? value : _value;
@@ -334,6 +339,18 @@ const ProModalSelect = (props, ref) => {
       d: Date.now()
     });
   };
+  const handleReset = () => {
+    form.resetFields();
+    formColumns?.forEach(column => {
+      if (column?.name !== undefined && Object.prototype.hasOwnProperty.call(column, 'initialValue')) {
+        form.setFieldValue(column.name, column.initialValue);
+      }
+    });
+    onSearch({
+      ...form.getFieldsValue(),
+      d: Date.now()
+    });
+  };
   const _rowSelection = {
     type,
     // 多选时开启，保证翻页/筛选后不丢弃不在当前页的已选 key
@@ -501,9 +518,6 @@ const ProModalSelect = (props, ref) => {
   });
   useEffect(() => {
     if (onOff && !open) {
-      if (useRequest?.options?.manual !== true) {
-        onReset();
-      }
       const nextState = {
         open: true
       };
@@ -531,6 +545,11 @@ const ProModalSelect = (props, ref) => {
       setState(nextState);
     }
   }, [onOff, open, JSON.stringify(value)]);
+  useEffect(() => {
+    if (open && useRequest?.options?.ready !== false && useRequest?.options?.manual === undefined) {
+      onSearch(form.getFieldsValue(), true);
+    }
+  }, [open, useRequest?.options?.manual, useRequest?.options?.ready]);
   useEffect(() => {
     hideTooltipIfOpen(fieldRef.current, open);
   }, [open]);
@@ -741,6 +760,7 @@ const ProModalSelect = (props, ref) => {
         form: form,
         columns: formColumns,
         onFinish: handleSearch,
+        onCancel: handleReset,
         confirmLoading: loading,
         footer: formColumns?.length > 1
       }), /*#__PURE__*/_jsx(ProTable, {

package/es/ProForm/components/combination/ProRangeLimit/index.js

@@ -18,7 +18,7 @@ const useControlled = props => {
     const internalValue = [props.value?.[0] && dayjs(props.value[0], props.format), props.value?.[1] && dayjs(props.value[1], props.format)];
     const handleChange = (value, other) => {
       if (!value) {
-        props?.onChange(value, other);
+        props?.onChange?.(value, other);
       } else {
         const [start, end] = value;
         if (props?.onChange) {

package/es/ProForm/components/render/Render.js

@@ -173,8 +173,8 @@ const Render = props => {
 
   // 防抖记忆化：handlerRef 始终指向最新 handler，debounce 仅按 debounceWait 重建，避免每次渲染重置定时器导致防抖失效
   const debounceWait = lastComponentProps?.debounceWait;
-  const handlerRef = useRef(() => undefined);
-  const debouncedHandleChange = useMemo(() => _debounce((...args) => handlerRef.current(...args), debounceWait), [debounceWait]);
+  const handlerRef = useRef(undefined);
+  const debouncedHandleChange = useMemo(() => _debounce((...args) => handlerRef.current?.(...args), debounceWait), [debounceWait]);
   useEffect(() => () => debouncedHandleChange.cancel(), [debouncedHandleChange]);
   const itemClassName = classNames({
     [className]: className,

package/es/ProForm/hooks/useWatch.js

@@ -49,14 +49,15 @@ function setValueByPath(obj, path, value) {
 
 // 创建之后namepath就不可变的警告
 // selector 模式（dependencies 为函数）下跳过：函数引用每次渲染不同，无法稳定 stringify
-const useWatchWarning = process.env.NODE_ENV !== 'production' ? dependencies => {
+// warning 在 production 下本身为空操作；始终走同一实现，避免 Jest 下 production 空函数不可达
+const useWatchWarning = dependencies => {
   const isSelector = typeof dependencies === 'function';
   const depsStr = isSelector ? '__selector__' : JSON.stringify(dependencies);
   const depsStrRef = useRef(depsStr);
   if (!isSelector) {
     warning(depsStrRef.current === depsStr, '`useWatch` is not support dynamic `namePath`. Please provide static instead.');
   }
-} : () => {};
+};
 
 /**
  * selector 函数：接收所有表单值，返回派生值
@@ -151,8 +152,8 @@ function useWatch(dependencies, form, wait) {
     if (!formInstance) return undefined;
 
     // 创建更新状态的函数
-    const updateState = () => {
-      const values = formInstance.getFieldsValue(true);
+    const updateState = watchValues => {
+      const values = watchValues ?? formInstance.getFieldsValue(true);
 
       // selector 模式：直接调用 selector 计算派生值
       if (isSelector && selectorRef.current) {
@@ -190,10 +191,8 @@ function useWatch(dependencies, form, wait) {
     const {
       registerWatch
     } = getInternalHooks('RC_FORM_INTERNAL_HOOKS');
-    const cancelWatch = registerWatch(values => {
-      if (values) {
-        updateState();
-      }
+    const cancelWatch = registerWatch((values, allValues) => {
+      updateState(allValues ?? values);
     });
 
     // 清理订阅

package/es/ProForm/utils/index.js

@@ -129,12 +129,12 @@ export const getAllNamePath = (object, currentPath = []) => {
 
     // 拆开组合key (组合key只可能存在于最外层)
     if (key.includes('-')) {
-      resultKeys.concat(key.split('-').map(keyStr => keyStr.split('_')));
+      resultKeys.push(...key.split('-').map(keyStr => keyStr.split('_')));
     }
 
     // 深度获取对象key
     if (_isObject(value)) {
-      resultKeys.concat(getAllNamePath(value, [...currentPath, key]));
+      resultKeys.push(...getAllNamePath(value, [...currentPath, key]));
     }
     resultKeys.push([...currentPath, key]);
   });

package/es/ProLayout/components/Layout/Menu/OpenMenu/index.js

@@ -49,6 +49,7 @@ const OpenMenu = props => {
   // 特殊处理：如果layoutSelectedPath是'##EMPTY##'，表示有意清空选中状态
   const preferredPath = query.get('activeMenu') || (layoutSelectedPath === '##EMPTY##' ? null : layoutSelectedPath) || window.location.pathname;
   const selectKeyIdPath = preferredPath ? getIdsByPathName(menus, preferredPath)?.map(item => String(item)) || [] : [];
+  const selectedRootKey = selectKeyIdPath[0];
   const itemsTransform = useMemo(() => {
     const result = _cloneDeep(menus);
     if (!Array.isArray(result) || !result.length) {
@@ -66,7 +67,7 @@ const OpenMenu = props => {
           children: [/*#__PURE__*/_jsx(_Fragment, {
             children: item.imgUrl && isFirstMenu ? /*#__PURE__*/_jsx("img", {
               className: "pro-layout-icon",
-              src: selectKeyIdPath[0] === String(item.id) ? item.imgActiveUrl || item.imgUrl : item.imgUrl,
+              src: selectedRootKey === String(item.id) ? item.imgActiveUrl || item.imgUrl : item.imgUrl,
               alt: "icon"
             }) : item.icon && isFirstMenu ? /*#__PURE__*/_jsx(ProIcon, {
               type: item.icon || '',
@@ -102,7 +103,7 @@ const OpenMenu = props => {
     };
     menuDeep(result);
     return result;
-  }, [dataSource]);
+  }, [dataSource, selectedRootKey]);
   useDeepCompareEffect(() => {
     if (Array.isArray(selectKeyIdPath)) {
       const newState = {
@@ -140,14 +141,13 @@ const OpenMenu = props => {
         });
       },
       onClick: ({
-        item,
         keyPath,
-        key,
-        domEvent
+        key
       }) => {
         // 查找完整的菜单项数据
         const menuItem = findMenuItemByKey(menus, key);
         const menuKeyPath = menuItem?.keyIdPath ? menuItem.keyIdPath.map(id => String(id)) : keyPath;
+        const menuRouter = menuItem?.redirectUrl || menuItem?.router || menuItem?.url;
 
         // 调用用户传入的onMenuClick回调，获取返回值（是否应该激活菜单）
         let shouldActivate = true;
@@ -168,13 +168,13 @@ const OpenMenu = props => {
         if (menuItem && canOpenAsTab(menuItem) && shouldActivate) {
           setState({
             selectedKeys: keyPath,
-            router: item?.props?.router
+            router: menuRouter
           });
           layoutOnSelected?.({
-            selectedPath: item?.props?.router
+            selectedPath: menuRouter
           });
           if (layoutTarget) {
-            window.open(item?.props?.router, layoutTarget);
+            window.open(menuRouter, layoutTarget);
           } else {
             setTimeout(() => {
               // 路由变更，且不再demo文档中

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

@@ -157,7 +157,7 @@ const Menu = props => {
       onMenuClick: onMenuClick,
       style: {
         display: collapsed ? 'none' : 'block',
-        height: `calc(100vh - ${headerHeight + (notice ? 32 : 0) + 48 || 0}px)`
+        height: `calc(100vh - ${(headerHeight ?? 0) + (notice ? 32 : 0) + 48}px)`
       }
     }), sideMenuFooterRender || /*#__PURE__*/_jsx("div", {
       className: "pro-layout-menu-collapsed",

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

@@ -31,11 +31,12 @@ const ProFooter = props => {
     'pro-footer': true,
     [`${className}`]: className
   });
+  const sideWidth = size?.width ?? 0;
   return /*#__PURE__*/_jsx("div", {
     className: cls,
     style: {
       zIndex,
-      width: `calc(100% - ${size?.width + 1}px)`,
+      width: `calc(100% - ${sideWidth + 1}px)`,
       ...props.style
     },
     children: /*#__PURE__*/_jsx(Space, {

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

@@ -46,7 +46,9 @@ export const DescribeValue = ({
     children: [link ? /*#__PURE__*/_jsx("a", {
       onClick: () => {
         const newWindow = window.open(link);
-        newWindow.opener = null;
+        if (newWindow) {
+          newWindow.opener = null;
+        }
       },
       children: value
     }) : value, copyable && _isString(value) ? /*#__PURE__*/_jsx(Copy, {

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import { CloseOutlined } from '@ant-design/icons';
-import ProTooltip from "../../../../ProTooltip";
+import { Tooltip } from 'antd';
 import { TabContextMenu } from "./TabContextMenu";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const MAX_TAB_TITLE_LENGTH = 12;
@@ -70,12 +70,13 @@ const TabItemComponent = ({
           }) : tab.icon
         }), /*#__PURE__*/_jsx("div", {
           className: "pro-layout-tab-title",
-          children: isTitleOverflow ? /*#__PURE__*/_jsx(ProTooltip, {
-            text: displayTitle,
+          children: isTitleOverflow ? /*#__PURE__*/_jsx(Tooltip, {
             title: tabTitle,
-            line: 1,
             placement: "top",
-            scrollFollowParent: false
+            children: /*#__PURE__*/_jsx("span", {
+              className: "pro-tooltip",
+              children: displayTitle
+            })
           }) : tabTitle
         }), tab.closable && /*#__PURE__*/_jsx("span", {
           className: "pro-layout-tab-close",

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, resolveTabMenuItem, derivePinned, getPinnedBoundary, pinTab as pinTabInList, unpinTab as unpinTabInList, reorderWithPinConstraint } from "../utils";
+import { createTabFromMenu, generateTabId, shouldOpenExternal, handleExternalOpen, checkTabLimit, getRightTabs, flattenMenuData, canOpenAsTab, getMenuRoute, findExistingTab, normalizeTabUrl, isSafeExternalUrl, isSafeHttpUrl, resolveTabMenuItem, derivePinned, getPinnedBoundary, pinTab as pinTabInList, unpinTab as unpinTabInList, reorderWithPinConstraint } from "../utils";
 
 /**
  * 标签页状态管理Hook
@@ -21,6 +21,7 @@ export const useTabsState = options => {
     ...DEFAULT_TABS_CONFIG,
     ...config
   };
+  const urlSyncEnabled = finalConfig.urlSync === true || typeof finalConfig.urlSync === 'object' && finalConfig.urlSync !== null;
 
   // 初始化状态
   const [state, setState] = useState(() => ({
@@ -47,7 +48,10 @@ export const useTabsState = options => {
   const [isInitialized, setIsInitialized] = useState(false);
 
   // 从缓存恢复状态
+  const hasRestoredCacheRef = useRef(false);
   useEffect(() => {
+    if (hasRestoredCacheRef.current) return;
+    hasRestoredCacheRef.current = true;
     const cachedState = restoreFromCache();
     if (cachedState && cachedState.tabsList && cachedState.tabsList.length > 0) {
       // 兼容旧缓存：如果缓存中有 activeTab 但没有 activeTabInfo，进行迁移
@@ -67,11 +71,33 @@ export const useTabsState = options => {
         pinned: tab.pinned === undefined ? derivePinned(tab) : tab.pinned
       }));
       restoredState.activeKey = restoredState.activeKey === undefined || restoredState.activeKey === null ? '' : String(restoredState.activeKey);
+      if (urlSyncEnabled) {
+        const retainedTabByUrl = new Map();
+        const retainedIdByOriginalId = new Map();
+        restoredState.tabsList.forEach(tab => {
+          const normalizedUrl = normalizeTabUrl(tab.url);
+          if (!normalizedUrl) return;
+          const retainedTab = retainedTabByUrl.get(normalizedUrl);
+          if (retainedTab) {
+            retainedIdByOriginalId.set(tab.id, retainedTab.id);
+            return;
+          }
+          const normalizedTab = {
+            ...tab,
+            url: normalizedUrl
+          };
+          retainedTabByUrl.set(normalizedUrl, normalizedTab);
+          retainedIdByOriginalId.set(tab.id, normalizedTab.id);
+        });
+        restoredState.tabsList = Array.from(retainedTabByUrl.values());
+        restoredState.activeKey = retainedIdByOriginalId.get(restoredState.activeKey) || restoredState.tabsList[0]?.id || '';
+      }
       restoredState.activeTabInfo = restoredState.tabsList.find(tab => tab.id === restoredState.activeKey);
+      restoredState.activeComponent = restoredState.activeTabInfo ? restoredState.activeTabInfo.menuItem?.code || restoredState.activeTabInfo.id : '';
       setState(restoredState);
     }
     setIsInitialized(true);
-  }, [restoreFromCache]);
+  }, [restoreFromCache, urlSyncEnabled]);
   const lastActiveKeyRef = useRef('');
   const shouldSkipSaveRef = useRef(false);
   const initialTabsAppliedRef = useRef(false);
@@ -128,9 +154,11 @@ export const useTabsState = options => {
       return false;
     }
 
-    // 如果 forceNew = false（默认），检查是否已存在相同的标签页
-    if (!forceNew) {
-      const existingTab = findExistingTab(state.tabsList, menuItem);
+    // URL 同步模式下完整 URL 始终唯一，forceNew 不能绕过身份匹配。
+    if (urlSyncEnabled || !forceNew) {
+      const existingTab = findExistingTab(state.tabsList, menuItem, {
+        urlSync: urlSyncEnabled
+      });
       if (existingTab) {
         // 如果已存在，可以添加（会切换到已存在的标签页）
         return true;
@@ -143,7 +171,7 @@ export const useTabsState = options => {
       return false;
     }
     return true;
-  }, [state.tabsList, finalConfig]);
+  }, [state.tabsList, finalConfig, urlSyncEnabled]);
 
   /**
    * 添加标签页
@@ -156,15 +184,33 @@ export const useTabsState = options => {
     setState(prevState => {
       if (!canOpenAsTab(menuItem)) return prevState;
       if (shouldOpenExternal(menuItem)) {
-        handleExternalOpen(menuItem);
+        const externalUrl = getMenuRoute(menuItem);
+        if (!urlSyncEnabled || isSafeHttpUrl(externalUrl)) {
+          handleExternalOpen(menuItem, urlSyncEnabled);
+        }
+        return prevState;
+      }
+      const rawUrl = getMenuRoute(menuItem);
+      const normalizedUrl = urlSyncEnabled ? normalizeTabUrl(rawUrl) : undefined;
+      if (urlSyncEnabled && rawUrl && !normalizedUrl) {
+        if (isSafeExternalUrl(rawUrl)) {
+          handleExternalOpen(menuItem, true);
+        }
         return prevState;
       }
+      const resolvedMenuItem = normalizedUrl ? {
+        ...menuItem,
+        url: normalizedUrl,
+        redirectUrl: undefined
+      } : menuItem;
 
       // 非强制新建时，查找已存在的标签页并切换
-      const existingTab = !forceNew ? findExistingTab(prevState.tabsList, menuItem) : undefined;
+      const existingTab = urlSyncEnabled || !forceNew ? findExistingTab(prevState.tabsList, resolvedMenuItem, {
+        urlSync: urlSyncEnabled
+      }) : undefined;
       if (existingTab) {
         // 若来源菜单明确标记 closable: false 而已有 tab 未继承，则修正
-        const correctedTab = menuItem.closable === false && existingTab.closable !== false ? {
+        const correctedTab = resolvedMenuItem.closable === false && existingTab.closable !== false ? {
           ...existingTab,
           closable: false
         } : existingTab;
@@ -184,8 +230,8 @@ export const useTabsState = options => {
         return prevState;
       }
       const existingIds = prevState.tabsList.map(tab => tab.id);
-      const tabId = generateTabId(menuItem, existingIds);
-      const newTab = createTabFromMenu(menuItem, prevState.newTabIndex);
+      const tabId = generateTabId(resolvedMenuItem, existingIds);
+      const newTab = createTabFromMenu(resolvedMenuItem, 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];
@@ -198,10 +244,10 @@ export const useTabsState = options => {
         activeKey: shouldActivate ? tabId : prevState.activeKey,
         activeTabInfo: shouldActivate ? newTab : prevState.activeTabInfo,
         newTabIndex: prevState.newTabIndex + 1,
-        activeComponent: shouldActivate ? menuItem.code || tabId : prevState.activeComponent
+        activeComponent: shouldActivate ? resolvedMenuItem.code || tabId : prevState.activeComponent
       };
     });
-  }, [finalConfig]);
+  }, [finalConfig, urlSyncEnabled]);
 
   // 普通初始标签只在当前 TabsManager 挂载周期应用一次。
   // 缓存恢复已有标签时只消费默认值；closeAll 后 ref 保持 true，避免再次补签。
@@ -344,6 +390,46 @@ export const useTabsState = options => {
     });
   }, []);
 
+  /**
+   * Router blocker 拒绝 URL 导航时，将激活状态还原到上一个已提交页签。
+   * 首次打开页签就被拦截时，同时移除未提交的新页签。
+   */
+  const rollbackTabActivation = useCallback((previousTabId, attemptedTabId, removeAttemptedTab) => {
+    setState(prevState => {
+      if (prevState.activeKey !== attemptedTabId) return prevState;
+      const nextTabsList = removeAttemptedTab ? prevState.tabsList.filter(tab => tab.id !== attemptedTabId) : prevState.tabsList;
+      const previousTab = nextTabsList.find(tab => tab.id === previousTabId);
+      return {
+        ...prevState,
+        tabsList: nextTabsList,
+        activeKey: previousTab?.id || '',
+        activeTabInfo: previousTab,
+        activeComponent: previousTab ? previousTab.menuItem?.code || previousTab.id : ''
+      };
+    });
+  }, []);
+
+  /**
+   * 更新页签当前 URL，保持 tab.id 和 menuItem 的菜单基础路由不变。
+   */
+  const updateTabUrl = useCallback((tabId, url) => {
+    setState(prevState => {
+      const targetIndex = prevState.tabsList.findIndex(tab => tab.id === tabId);
+      if (targetIndex === -1 || prevState.tabsList[targetIndex].url === url) return prevState;
+      const nextTab = {
+        ...prevState.tabsList[targetIndex],
+        url
+      };
+      const nextTabsList = [...prevState.tabsList];
+      nextTabsList[targetIndex] = nextTab;
+      return {
+        ...prevState,
+        tabsList: nextTabsList,
+        activeTabInfo: prevState.activeKey === tabId ? nextTab : prevState.activeTabInfo
+      };
+    });
+  }, []);
+
   /**
    * 关闭其他标签页
    */
@@ -474,9 +560,9 @@ export const useTabsState = options => {
     });
   }, []);
 
-  // 监听 URL 变化并同步 Tabs (仅在初始化和 location 变化时)
-  // 放在最后以确保可以使用 addTab 和 switchTab
+  // URL 不同步模式保留旧有的 pathname -> Tabs 初始匹配，但不写回 URL。
   useEffect(() => {
+    if (urlSyncEnabled) return;
     if (!dataSource || !('menus' in dataSource)) return;
     const currentPath = window.location.pathname;
     const activeTab = state.tabsList.find(tab => tab.id === state.activeKey);
@@ -490,7 +576,7 @@ export const useTabsState = options => {
       return;
     }
     addTab(targetMenu);
-  }, [dataSource, state.tabsList, state.activeKey, addTab, switchTab]);
+  }, [urlSyncEnabled, dataSource, state.tabsList, state.activeKey, addTab, switchTab]);
   return {
     state,
     isInitialized,
@@ -498,7 +584,9 @@ export const useTabsState = options => {
     canAddTab,
     removeTab,
     updateTab,
+    updateTabUrl,
     switchTab,
+    rollbackTabActivation,
     closeOtherTabs,
     closeRightTabs,
     closeAllTabs,

package/es/ProLayout/components/TabsManager/hooks/useTabsUrlSync.d.ts

@@ -0,0 +1,19 @@
+import type { TabsConfig, TabsState } from '../../../propTypes';
+import type { TabsManagerProps, UseTabsStateReturn } from '../propTypes';
+interface UseTabsUrlSyncOptions {
+    config: TabsConfig;
+    dataSource: TabsManagerProps['dataSource'];
+    state: TabsState;
+    isInitialized: boolean;
+    addTab: UseTabsStateReturn['addTab'];
+    switchTab: UseTabsStateReturn['switchTab'];
+    updateTabUrl: UseTabsStateReturn['updateTabUrl'];
+    rollbackTabActivation: UseTabsStateReturn['rollbackTabActivation'];
+    interactionSequence: number;
+}
+/**
+ * 维护浏览器 location 与活动页签 URL 的双向同步。
+ * 未开启 config.urlSync 时不安装任何 History 监听或写入逻辑。
+ */
+export declare const useTabsUrlSync: ({ config, dataSource, state, isInitialized, addTab, switchTab, updateTabUrl, rollbackTabActivation, interactionSequence, }: UseTabsUrlSyncOptions) => void;
+export {};