@zat-design/sisyphus-react 4.3.6 → 4.4.0

package/es/ProEditTable/components/RenderField/ListChangedWrapper.js

@@ -182,8 +182,6 @@ const ListChangedWrapper = props => {
       ...filteredRest
     });
   }
-
-  // const isFocus = useFocus(contentRef.current);
   const tipOpenCalc = () => {
     if (!toolTip) return false;
 

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

@@ -76,34 +76,35 @@ export declare const useFormItemProps: (column: FlexibleGroupColumnType, context
     show?: boolean | ReactiveFunction<any, boolean>;
     component?: React.ReactNode | ReactiveFunction<any, React.ReactNode>;
     children?: React.ReactNode | ((form: FormInstance<any>) => React.ReactNode);
-    trim?: boolean;
-    normalize?: (value: any, prevValue: any, allValues: import("@rc-component/form/lib/interface").Store) => any;
-    prefixCls?: string;
-    trigger?: string;
-    id?: string;
     className?: string;
-    rootClassName?: string;
+    hidden?: boolean;
+    id?: string;
     style?: React.CSSProperties;
+    onReset?: () => void;
+    validateTrigger?: string | false | string[];
+    preserve?: boolean;
+    prefixCls?: string;
+    rootClassName?: string;
+    status?: "" | "warning" | "error" | "success" | "validating";
     isView?: boolean;
-    status?: "" | "success" | "warning" | "error" | "validating";
+    valueType?: import("../../../render/propsType").ProFormValueType;
+    viewType?: import("../../../render/propsType").ViewType;
+    trim?: boolean;
+    normalize?: (value: any, prevValue: any, allValues: import("@rc-component/form/lib/interface").Store) => any;
+    getValueProps?: ((value: any) => Record<string, unknown>) & ((value: any) => Record<string, unknown>);
+    desensitization?: [number, number] | ReactiveFunction<any, [number, number]>;
     vertical?: boolean;
-    hidden?: boolean;
-    layout?: import("antd/es/form/Form").FormItemLayout;
-    help?: React.ReactNode;
-    preserve?: boolean;
     colon?: boolean;
     htmlFor?: string;
     labelAlign?: import("antd/es/form/interface").FormLabelAlign;
     labelCol?: import("antd").ColProps;
     getValueFromEvent?: (...args: import("@rc-component/form/lib/interface").EventArgs) => any;
     shouldUpdate?: import("@rc-component/form/lib/Field").ShouldUpdate<any>;
-    validateTrigger?: string | false | string[];
+    trigger?: string;
     validateDebounce?: number;
     valuePropName?: string;
-    getValueProps?: ((value: any) => Record<string, unknown>) & ((value: any) => Record<string, unknown>);
     messageVariables?: Record<string, string>;
     initialValue?: any;
-    onReset?: () => void;
     onMetaChange?: (meta: import("@rc-component/form/lib/Field").MetaEvent) => void;
     isListField?: boolean;
     isList?: boolean;
@@ -111,22 +112,21 @@ export declare const useFormItemProps: (column: FlexibleGroupColumnType, context
     hasFeedback?: boolean | {
         icons: import("antd/es/form/FormItem").FeedbackIcons;
     };
-    validateStatus?: "" | "success" | "warning" | "error" | "validating";
+    validateStatus?: "" | "warning" | "error" | "success" | "validating";
+    layout?: import("antd/es/form/Form").FormItemLayout;
     wrapperCol?: import("antd").ColProps;
+    help?: React.ReactNode;
     fieldId?: string;
-    valueType?: import("../../../render/propsType").ProFormValueType;
     switchValue?: [any, any];
     viewRender?: (value: any, record: any, { form, index, namePath, }: {
         [key: string]: any;
         form: FormInstance<any>;
         index?: number;
     }) => string | React.ReactElement<any, any>;
-    viewType?: import("../../../render/propsType").ViewType;
     upperCase?: boolean;
     toISOString?: boolean;
     toCSTString?: boolean;
     clearNotShow?: boolean;
-    desensitization?: [number, number] | ReactiveFunction<any, [number, number]>;
     name: any;
     dependencies: any[];
     tooltip: string | {
@@ -141,7 +141,7 @@ export declare const useFormItemProps: (column: FlexibleGroupColumnType, context
  * 创建组件属性
  */
 export declare const createComponentProps: (column: FlexibleGroupColumnType, formItemProps: any) => {
-    componentProps: import("lodash").Omit<any, "format" | "valueType" | "switchValue" | "dependNames" | "toISOString" | "toCSTString" | "clearNotShow" | "precision">;
+    componentProps: import("lodash").Omit<any, "precision" | "valueType" | "format" | "switchValue" | "dependNames" | "toISOString" | "toCSTString" | "clearNotShow">;
     formItemTransform: {
         getValueProps: any;
         normalize: any;

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

@@ -25,7 +25,6 @@ export declare const isTrim: (type: string, trim: boolean, configData: any) => a
  * @returns {}
  */
 export declare const isUpperCase: (type: string, upperCase: boolean) => any;
-export declare const weedOutProps: (data: Record<string, any>, keys: string[]) => {}[];
 export declare const diffField: (prevValues: any, curValues: any, names: NamePath[]) => boolean;
 export declare const splitNameStr: (name: string) => string[][];
 export declare const filterInternalFields: (values: any, optimize?: boolean) => any;
@@ -75,7 +74,6 @@ export declare const view: (obj: any) => boolean;
  * @returns 位数
  */
 export declare const getDecimalDigits: (num: number) => number;
-export declare const deleteForPath: (values: any, namePath: string | number | (string | number)[]) => void;
 /**
  * 获取树状结构option
  * @param treeData 树数据源
@@ -88,10 +86,6 @@ export declare const findOptionByValue: (treeData: any[], value: string | number
     value?: string;
     children?: string;
 }) => any;
-/**
- * 对比依赖列表中的 值是否变更
- */
-export declare const equalDependencies: (dependencies: any, prevValues: any, currentValues: any) => any;
 /** 解析namePath */
 export declare const parseNamePath: (input: string) => any;
 /**

package/es/ProForm/utils/index.js

@@ -95,21 +95,6 @@ export const isUpperCase = (type, upperCase) => {
   return result;
 };
 
-// 剔除otherProps 组成对象返回
-export const weedOutProps = (data, keys) => {
-  const obj = {};
-  const weedOut = {};
-  Object.keys(data).forEach(key => {
-    const included = keys.includes(key);
-    if (included) {
-      weedOut[key] = data[key];
-    } else {
-      obj[key] = data[key];
-    }
-  });
-  return [obj, weedOut];
-};
-
 // 对比字段变化
 export const diffField = (prevValues, curValues, names) => {
   return names.some(name => {
@@ -331,24 +316,6 @@ export const getDecimalDigits = num => {
   const match = num.toString().match(/\.(\d+)/);
   return match ? match[1].length : 0;
 };
-export const deleteForPath = (values, namePath) => {
-  if (Array.isArray(namePath)) {
-    let current = values;
-    namePath.every((nameItem, index) => {
-      if (index === namePath.length - 1) {
-        delete current[nameItem];
-        return false;
-      }
-      if (typeof current[nameItem] !== 'object') {
-        return false;
-      }
-      current = current[nameItem];
-      return true;
-    });
-    return;
-  }
-  delete values[namePath];
-};
 
 /**
  * 获取树状结构option
@@ -374,20 +341,6 @@ export const findOptionByValue = (treeData, value, fieldNames) => {
   }
 };
 
-/**
- * 对比依赖列表中的 值是否变更
- */
-export const equalDependencies = (dependencies, prevValues, currentValues) => {
-  if (dependencies?.length) {
-    return dependencies.some(namePath => {
-      const prevValue = _get(prevValues, namePath);
-      const currentValue = _get(currentValues, namePath);
-      return prevValue !== currentValue;
-    });
-  }
-  return false;
-};
-
 /** 解析namePath */
 export const parseNamePath = input => {
   const parts = input.split('_');

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/useIframeRoute.js

@@ -0,0 +1,63 @@
+import { useEffect, useMemo, useRef } from 'react';
+const detectIframe = () => {
+  if (typeof window === 'undefined') return false;
+  // URL 上带 ?isIframe(大小写不敏感)即视为 iframe 嵌入
+  const params = new URLSearchParams(window.location.search);
+  for (const key of params.keys()) {
+    if (key.toLowerCase() === 'isiframe') return true;
+  }
+  return false;
+};
+const stripSlashes = s => s.replace(/^\/+|\/+$/g, '');
+
+/**
+ * iframe 嵌入模式 hook
+ * - 通过 URL query `?isIframe`(大小写不敏感)判定是否处于 iframe 嵌入场景
+ * - 命中时按 routes 静态路径匹配 window.location.pathname,调用 addTab
+ * - query string 自动作为 extra 透传给业务组件
+ * - 暴露 pure 标志供外部 layout 决定渲染范围
+ */
+export const useIframeRoute = options => {
+  const {
+    config,
+    addTab
+  } = options;
+  const isIframe = useMemo(detectIframe, []);
+  // pure 仅在显式配置 iframe 时才考虑;非 iframe 嵌入(URL 无 ?isIframe)始终为 false
+  const pure = isIframe && config != null && config.pure !== false;
+
+  // 用 ref 持有最新的 addTab/config,避免依赖变化触发副作用重跑
+  const addTabRef = useRef(addTab);
+  addTabRef.current = addTab;
+  const configRef = useRef(config);
+  configRef.current = config;
+  useEffect(() => {
+    if (!isIframe) return;
+    const cfg = configRef.current;
+    if (!cfg?.routes?.length) return;
+    const {
+      pathname,
+      search
+    } = window.location;
+    const searchParams = {};
+    new URLSearchParams(search).forEach((value, key) => {
+      searchParams[key] = value;
+    });
+    const normalizedPath = stripSlashes(pathname);
+    for (let i = 0; i < cfg.routes.length; i += 1) {
+      const route = cfg.routes[i];
+      if (stripSlashes(route.path) === normalizedPath) {
+        addTabRef.current({
+          code: route.code,
+          name: route.name,
+          extra: searchParams
+        });
+        break;
+      }
+    }
+  }, [isIframe]);
+  return {
+    isIframe,
+    pure
+  };
+};

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

@@ -13,7 +13,8 @@ export const useTabsState = options => {
   const {
     initialState = {},
     config,
-    dataSource
+    dataSource,
+    cacheEnabled = true
   } = options;
 
   // 合并默认配置
@@ -40,7 +41,7 @@ export const useTabsState = options => {
   } = useTabsCache({
     cacheKey: finalConfig.cacheKey,
     storage: finalConfig.storage,
-    enabled: true
+    enabled: cacheEnabled
   });
 
   // 初始化标记，确保只在初始化后保存缓存
@@ -140,7 +141,8 @@ export const useTabsState = options => {
    */
   const addTab = useCallback((menuItem, options) => {
     const {
-      forceNew = false
+      forceNew = false,
+      silent = false
     } = options || {};
     setState(prevState => {
       if (!canOpenAsTab(menuItem)) return prevState;
@@ -177,13 +179,16 @@ export const useTabsState = options => {
       const tabId = generateTabId(menuItem, existingIds);
       const newTab = createTabFromMenu(menuItem, prevState.newTabIndex);
       newTab.id = tabId;
+
+      // silent=true 时,若已有 active 则保留;无 active(首次进入)仍激活以保留默认行为
+      const shouldActivate = !silent || prevState.activeKey === '';
       return {
         ...prevState,
         tabsList: [...prevState.tabsList, newTab],
-        activeKey: tabId,
-        activeTabInfo: newTab,
+        activeKey: shouldActivate ? tabId : prevState.activeKey,
+        activeTabInfo: shouldActivate ? newTab : prevState.activeTabInfo,
         newTabIndex: prevState.newTabIndex + 1,
-        activeComponent: menuItem.code || tabId
+        activeComponent: shouldActivate ? menuItem.code || tabId : prevState.activeComponent
       };
     });
   }, [finalConfig]);

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

@@ -1,6 +1,7 @@
 import { useCallback, useMemo, forwardRef, useImperativeHandle, useState, useEffect, useRef } from 'react';
 import { createPortal } from 'react-dom';
 import { useTabsState } from "./hooks/useTabsState";
+import { useIframeRoute } from "./hooks/useIframeRoute";
 import { flattenMenuData } from "./utils";
 import { TabItemComponent } from "./components/TabItem";
 import { TabsHeader } from "./components/TabsHeader";
@@ -16,8 +17,23 @@ const TabsManager = /*#__PURE__*/forwardRef(({
   dataSource,
   originalOnMenuClick,
   tabsBarContainer,
-  onTabsChange
+  onTabsChange,
+  onIframePureChange
 }, ref) => {
+  // iframe 模式检测(在 useTabsState 之前,因为 cacheEnabled 依赖 pure)
+  // addTab 由后续 useTabsState 提供,此处先用占位,后面用 ref 透传
+  const iframeAddTabRef = useRef(() => {});
+  const {
+    pure: isIframePure
+  } = useIframeRoute({
+    config: config?.iframe,
+    addTab: params => iframeAddTabRef.current(params)
+  });
+
+  // 通知父级(ProLayout)pure 状态变化
+  useEffect(() => {
+    onIframePureChange?.(isIframePure);
+  }, [isIframePure, onIframePureChange]);
   const {
     state,
     isInitialized,
@@ -32,9 +48,28 @@ const TabsManager = /*#__PURE__*/forwardRef(({
     reorderTabs
   } = useTabsState({
     config,
-    dataSource
+    dataSource,
+    cacheEnabled: !isIframePure
   });
 
+  // 桥接 useIframeRoute 的 { code, name, extra } → addTab(menuItem)
+  iframeAddTabRef.current = params => {
+    const sourceMenus = Array.isArray(dataSource?.menus) ? flattenMenuData(dataSource.menus) : [];
+    const matchedMenu = sourceMenus.find(item => item.code === params.code);
+    const menuItem = matchedMenu ? {
+      ...matchedMenu,
+      name: params.name || matchedMenu.name,
+      extra: params.extra ?? matchedMenu.extra
+    } : {
+      id: Date.now(),
+      code: params.code,
+      name: params.name,
+      url: `/${params.code}`,
+      extra: params.extra
+    };
+    addTab(menuItem);
+  };
+
   // 记录已访问过的 Tab ID，用于懒加载
   const [visitedTabIds, setVisitedTabIds] = useState(new Set());
 
@@ -60,12 +95,24 @@ const TabsManager = /*#__PURE__*/forwardRef(({
   const addTabRef = useRef(addTab);
   addTabRef.current = addTab;
   useEffect(() => {
+    // iframe pure 模式下不应用 fixed(嵌入页面只显示路由命中的单个 tab)
+    if (isIframePure) return;
     if (!isInitialized || !config.fixed || config.fixed.length === 0) return;
     const sourceMenus = Array.isArray(dataSource?.menus) ? flattenMenuData(dataSource.menus) : [];
 
     // menus 为空说明异步数据尚未返回，等 dataSource 变化后重跑，避免用 code 创建占位 tab
     if (sourceMenus.length === 0) return;
     config.fixed.forEach(code => {
+      // 已存在（如缓存恢复）：仅校正 closable，不调 addTab 以保留缓存中的 activeKey
+      const existing = state.tabsList.find(tab => tab.menuItem?.code === code || tab.code === code);
+      if (existing) {
+        if (existing.closable !== false) {
+          updateTab(existing.id, {
+            closable: false
+          });
+        }
+        return;
+      }
       const matchedMenu = sourceMenus.find(item => item.code === code);
       const menuItem = matchedMenu ? {
         ...matchedMenu,
@@ -77,9 +124,12 @@ const TabsManager = /*#__PURE__*/forwardRef(({
         url: `/${code}`,
         closable: false
       };
-      addTabRef.current(menuItem);
+      // silent: 已有 active(如 iframe 路由命中)时不抢 active;无 active 时仍激活以保留默认行为
+      addTabRef.current(menuItem, {
+        silent: true
+      });
     });
-  }, [isInitialized, config.fixed, dataSource]);
+  }, [isInitialized, config.fixed, dataSource, state.tabsList, updateTab, isIframePure]);
 
   // 处理菜单点击 - 拦截原有的菜单点击逻辑
   const handleMenuClick = useCallback(params => {
@@ -191,7 +241,8 @@ const TabsManager = /*#__PURE__*/forwardRef(({
   };
 
   // TabsHeader 节点：有 tabsBarContainer 时用 Portal 渲染到外部，否则原位 fallback
-  const tabsHeaderNode = state.tabsList.length > 0 ? /*#__PURE__*/_jsx(TabsHeader, {
+  // iframe pure 模式下完全不渲染 tab bar
+  const tabsHeaderNode = state.tabsList.length > 0 && !isIframePure ? /*#__PURE__*/_jsx(TabsHeader, {
     activeKey: state.activeKey || undefined,
     tabsItems: tabsItems,
     onTabChange: handleTabChange,

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

@@ -18,6 +18,8 @@ export interface TabsManagerProps {
     tabsBarContainer?: HTMLElement | null;
     /** Tab 有无变化回调，供 ProLayout 控制 wrapper 动画 */
     onTabsChange?: (hasTabs: boolean) => void;
+    /** iframe pure 模式变化回调,供 ProLayout 决定是否隐藏外壳 */
+    onIframePureChange?: (pure: boolean) => void;
 }
 export interface TabContextMenuProps {
     tabId: string;
@@ -47,6 +49,8 @@ export interface UseTabsStateOptions {
     config: TabsManagerProps['config'];
     /** 数据源 */
     dataSource?: TabsManagerProps['dataSource'];
+    /** 是否启用缓存(读+写),默认 true。iframe pure 模式下传 false */
+    cacheEnabled?: boolean;
 }
 export interface UseTabsStateReturn {
     /** 当前状态 */

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

@@ -27,10 +27,6 @@ export declare const handleExternalOpen: (menuItem: MenusType) => void;
  * @returns 如果超出限制返回 true，否则返回 false
  */
 export declare const checkTabLimit: (currentTabs: TabItem[], maxTabs?: number | null) => boolean;
-/**
- * 移除最旧的标签页（根据访问时间或创建时间）
- */
-export declare const removeOldestTab: (tabs: TabItem[]) => TabItem[];
 /**
  * 获取右侧标签页
  */
@@ -44,10 +40,6 @@ export declare const flattenMenuData: (menus?: MenusType[]) => MenusType[];
  * 只有当菜单项没有子菜单或子菜单为空时，才认为是叶子节点
  */
 export declare const isLeafMenuItem: (menuItem: MenusType) => boolean;
-/**
- * 判断菜单项是否为根节点
- */
-export declare const isRootMenuItem: (menuItem: MenusType) => boolean;
 /**
  * 判断菜单项是否可以在 Tabs 模式下打开
  * 规则：只有叶子节点（无 children）才可打开

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

@@ -72,21 +72,6 @@ export const checkTabLimit = (currentTabs, maxTabs) => {
   return currentTabs.length >= maxTabs;
 };
 
-/**
- * 移除最旧的标签页（根据访问时间或创建时间）
- */
-export const removeOldestTab = tabs => {
-  if (tabs.length === 0) return tabs;
-
-  // 找到可关闭的最旧标签页
-  const closableTabs = tabs.filter(tab => tab.closable);
-  if (closableTabs.length === 0) return tabs;
-
-  // 移除第一个可关闭的标签页
-  const oldestTab = closableTabs[0];
-  return tabs.filter(tab => tab.id !== oldestTab.id);
-};
-
 /**
  * 获取右侧标签页
  */
@@ -122,17 +107,6 @@ export const isLeafMenuItem = menuItem => {
   return !children || Array.isArray(children) && children.length === 0;
 };
 
-/**
- * 判断菜单项是否为根节点
- */
-export const isRootMenuItem = menuItem => {
-  if (!menuItem) return false;
-  if (menuItem.parentId === null || menuItem.parentId === undefined) {
-    return true;
-  }
-  return Array.isArray(menuItem.keyIdPath) && menuItem.keyIdPath.length === 1;
-};
-
 /**
  * 判断菜单项是否可以在 Tabs 模式下打开
  * 规则：只有叶子节点（无 children）才可打开

package/es/ProLayout/index.js

@@ -55,6 +55,8 @@ const ProLayout = props => {
   // Tab 栏 Portal 挂载目标及动画状态
   const [tabsBarEl, setTabsBarEl] = useState(null);
   const [hasTabs, setHasTabs] = useState(false);
+  // TabsManager 通过 onIframePureChange 报告的 pure 状态(iframe 嵌入 + 默认纯净渲染)
+  const [isIframePure, setIsIframePure] = useState(false);
   const [{
     notice,
     menus,
@@ -135,6 +137,7 @@ const ProLayout = props => {
       originalOnMenuClick: onMenuClick,
       tabsBarContainer: tabsBarEl,
       onTabsChange: setHasTabs,
+      onIframePureChange: setIsIframePure,
       children: children
     });
   };
@@ -233,7 +236,18 @@ const ProLayout = props => {
     onMenuClick: handleMenuClick,
     appsOptions
   };
-  const layoutDom = /*#__PURE__*/_jsxs("div", {
+  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,

package/es/ProLayout/propTypes.d.ts

@@ -370,6 +370,12 @@ export interface AddTabOptions {
      * @description 是否强制创建新标签页（忽略已存在的相同标签页），默认 false
      */
     forceNew?: boolean;
+    /**
+     * @description 是否静默追加：true 时新建 tab 不切换 active；当前已有 active 时保留原 active。
+     * 列表为空(activeKey 为空)时仍会激活,以保留首次进入默认激活的行为。
+     * 用于 fixed 声明式注入等不应抢用户 active 的场景。默认 false。
+     */
+    silent?: boolean;
 }
 /**
  * @description 更新标签页的字段（仅允许更新展示与扩展数据）
@@ -426,6 +432,51 @@ export interface ProLayoutTabsInstance {
      */
     getTabInfo: () => TabsInfoResult;
 }
+/**
+ * @description iframe 路由表配置项
+ */
+export interface IframeRoute {
+    /**
+     * @description 静态路径,与 `window.location.pathname` 完全匹配(忽略首尾斜杠)。
+     * 不支持 `:param` 动态片段;动态参数通过 query string 传递,
+     * 自动作为 props 透传给业务组件。
+     * 业务方需保证 URL query 字段名与业务组件 props 名一致。
+     * @example '/wjs/policy/view'
+     * 配合 URL: `/wjs/policy/view?taskId=123&policyId=456`
+     */
+    path: string;
+    /**
+     * @description 命中后用于解析 activeComponent 的业务 code
+     */
+    code: string;
+    /**
+     * @description 命中后的标签名称
+     */
+    name: string;
+}
+/**
+ * @description iframe 嵌入配置
+ *
+ * **触发条件**:URL query 上带 `?isIframe`(大小写不敏感,值不限,只看 key 是否存在)。
+ * 第三方系统通过在 iframe src 上拼 `?isIframe=1` 来触发组件库的嵌入模式。
+ *
+ * 未带该 query 时(独立访问),即使配置了 `tabs.iframe`,组件库也完全不读取,
+ * 维持完整 Layout 渲染。
+ */
+export interface IframeConfig {
+    /**
+     * @description 路由表:按 URL pathname 顺序匹配,命中后自动 addTab
+     * - URL query 自动合并进 extra,作为业务组件 props 透传
+     */
+    routes: IframeRoute[];
+    /**
+     * @description 嵌入时是否使用纯净渲染(只显示内容区域)
+     * - true (默认): 隐藏 Header / Menu / TabsBar,仅渲染当前 tab 内容
+     * - false: 完整 layout 渲染
+     * @default true
+     */
+    pure?: boolean;
+}
 export interface TabsConfig {
     max?: number;
     storage?: TabsStorageStrategy;
@@ -461,6 +512,11 @@ export interface TabsConfig {
      * @example fixed: ['Workspace', 'PolicyInput']
      */
     fixed?: string[];
+    /**
+     * @description iframe 嵌入配置,允许第三方系统通过 URL 定位到具体 tab
+     * 仅在 URL 带 `?isIframe`(大小写不敏感)时生效
+     */
+    iframe?: IframeConfig;
 }
 export type ProLayoutMode = 'normal' | 'tabs';
 export interface ProLayoutTabsProps extends ProLayoutBaseProps {

package/es/ProLayout/propTypes.js

@@ -30,6 +30,20 @@
  * @description ProLayout 标签页实例接口（类似 FormInstance）
  */
 
+/**
+ * @description iframe 路由表配置项
+ */
+
+/**
+ * @description iframe 嵌入配置
+ *
+ * **触发条件**:URL query 上带 `?isIframe`(大小写不敏感,值不限,只看 key 是否存在)。
+ * 第三方系统通过在 iframe src 上拼 `?isIframe=1` 来触发组件库的嵌入模式。
+ *
+ * 未带该 query 时(独立访问),即使配置了 `tabs.iframe`,组件库也完全不读取,
+ * 维持完整 Layout 渲染。
+ */
+
 export const isTabsMode = props => props.mode === 'tabs';
 export const validateTabsProps = (mode = 'normal', tabs) => {
   if (mode === 'tabs' && !tabs) {

package/es/ProLayout/style/index.less

@@ -361,6 +361,11 @@
     }
   }
 
+  // iframe 嵌入 pure 模式：背景固定为白色，覆盖默认 #f7f9fd 与外部全局样式
+  &.pro-layout-iframe-pure {
+    background: #fff;
+  }
+
   .pro-layout-row-pure {
     .pro-layout-content {
       margin: 0 !important;

package/es/utils/index.d.ts

@@ -18,4 +18,3 @@ export declare const isEmpty: (value: any, emptyValue?: string) => boolean;
  * @returns {boolean} 如果内容溢出返回 true，否则返回 false
  */
 export declare const isEllipsisActive: (element: Element) => boolean;
-export declare const useFocus: (element: Element) => boolean;