@gx-design-vue/pro-layout 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/style/rightContent.js

@@ -0,0 +1,74 @@
+import { setAlpha } from "@gx-design-vue/pro-provider";
+//#region src/style/rightContent.ts
+/**
+* RightContent 操作区样式
+* - 注册在 ProLayout 下，使用 ProLayout 扁平 token
+*/
+const genRightContentStyle = (token) => {
+	return { [`${token.componentCls}-right-content`]: {
+		height: "100%",
+		"&-header-actions": {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "flex-end",
+			height: "100%",
+			gap: token.paddingXS,
+			"&-item": {
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				paddingBlock: 0,
+				paddingInline: 2,
+				color: token.headerColorTextRightActionsItem,
+				fontSize: 14,
+				cursor: "pointer",
+				borderRadius: token.borderRadius,
+				[`.anticon`]: {
+					color: token.headerColorTextRightActionsItem,
+					transition: `color ${token.motionDurationMid}, background-color ${token.motionDurationMid}`,
+					"&:hover": { color: token.headerColorTextRightActionsItemHover }
+				},
+				[`&${token.componentCls}-right-content-header-actions-theme`]: { [`${token.componentCls}-right-content-header-actions-icon`]: {
+					paddingInline: 4,
+					paddingBlock: 4,
+					fontSize: 18
+				} },
+				"> *": {
+					paddingInline: 6,
+					paddingBlock: 6,
+					borderRadius: token.borderRadius,
+					transition: `color ${token.motionDurationMid}, background-color ${token.motionDurationMid}`,
+					"&:hover": {
+						color: token.headerColorTextRightActionsItemHover,
+						backgroundColor: token.headerColorBgRightActionsItemHover
+					}
+				}
+			},
+			[`&>${token.antCls}-dropdown-trigger`]: {
+				color: token.colorTextTertiary,
+				paddingInline: 8,
+				paddingBlock: 8,
+				cursor: "pointer",
+				display: "flex",
+				alignItems: "center",
+				height: 44,
+				lineHeight: "44px",
+				borderRadius: token.borderRadius,
+				"&:hover": { backgroundColor: setAlpha(token.colorTextBase, .03) }
+			},
+			"&-avatar": {
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				gap: token.paddingXS,
+				paddingInlineStart: token.padding,
+				paddingInlineEnd: token.padding,
+				cursor: "pointer",
+				color: token.headerColorTextRightActionsItem
+			},
+			"&-name": { color: token.headerColorTextRightActionsItem }
+		}
+	} };
+};
+//#endregion
+export { genRightContentStyle as default };

package/dist/style/search.d.ts

@@ -0,0 +1,12 @@
+import { ProFullToken } from "@gx-design-vue/pro-provider";
+import { CSSObject } from "@antdv-next/cssinjs";
+import { GenerateStyle } from "antdv-next/dist/theme/internal";
+
+//#region src/style/search.d.ts
+/**
+ * Search 搜索框样式（RightContent 子组件）
+ * - 注册在 ProLayout 下，使用 ProLayout 扁平 token
+ */
+declare const genSearchStyle: GenerateStyle<ProFullToken<'ProLayout'>, CSSObject>;
+//#endregion
+export { genSearchStyle as default };

package/dist/style/search.js

@@ -0,0 +1,94 @@
+//#region src/style/search.ts
+/**
+* Search 搜索框样式（RightContent 子组件）
+* - 注册在 ProLayout 下，使用 ProLayout 扁平 token
+*/
+const genSearchStyle = (token) => {
+	const fontSize = token.menuItemIconSize || token.fontSize;
+	return { [`${token.componentCls}-page-search`]: {
+		display: "flex",
+		alignItems: "center",
+		justifyContent: "center",
+		height: 36,
+		gap: 12,
+		cursor: "pointer",
+		fontSize: token.fontSizeSM,
+		color: token.colorTextTertiary,
+		paddingBlock: token.paddingXXS / 2,
+		paddingInline: token.paddingXS,
+		borderRadius: token.borderRadiusLG * 2,
+		backgroundColor: token.headerColorBgRightActionsItemHover,
+		transition: `all ${token.motionDurationMid} ${token.motionEaseInOut}`,
+		">.anticon": {
+			fontSize: token.fontSize,
+			color: token.colorTextTertiary
+		},
+		"&-word-icon": {
+			padding: "4px 6px",
+			lineHeight: `${token.fontSizeSM}px`,
+			borderTopLeftRadius: token.borderRadiusSM,
+			borderBottomLeftRadius: token.borderRadiusSM,
+			borderTopRightRadius: token.borderRadiusLG * 2,
+			borderBottomRightRadius: token.borderRadiusLG * 2,
+			backgroundColor: token.colorBgContainer
+		},
+		"&:hover": { color: token.colorTextSecondary },
+		"&-modal": {
+			"&-footer": {
+				display: "flex",
+				alignItems: "center",
+				gap: token.marginXS,
+				fontSize: 12,
+				color: token.colorTextSecondary
+			},
+			"&-footer-icon": {
+				display: "flex",
+				alignItems: "center",
+				gap: 4
+			}
+		},
+		"&-panel": {
+			"&-title": {
+				color: token.colorTextQuaternary,
+				lineHeight: token.lineHeight,
+				marginBlockEnd: token.marginXS
+			},
+			"&-list": {
+				display: "flex",
+				flexDirection: "column",
+				gap: 12
+			},
+			"&-item": {
+				display: "flex",
+				alignItems: "center",
+				justifyContent: "space-between",
+				cursor: "pointer",
+				fontSize: token.fontSize,
+				lineHeight: token.lineHeight,
+				padding: token.paddingXS,
+				borderRadius: token.borderRadiusLG,
+				backgroundColor: token.colorBgContainer,
+				transition: `all ${token.motionDurationFast} ${token.motionEaseInOut}`,
+				"&-left": {
+					display: "flex",
+					alignItems: "center",
+					gap: token.sizeStep,
+					">.anticon": { fontSize: `${fontSize}px` }
+				},
+				"&.active": {
+					backgroundColor: token.colorPrimary,
+					color: token.colorTextLightSolid
+				}
+			}
+		},
+		"&-result": {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			paddingBlockStart: 60,
+			color: token.colorTextQuaternary
+		}
+	} };
+};
+//#endregion
+export { genSearchStyle as default };

package/dist/style/sider.d.ts

@@ -0,0 +1,8 @@
+import { ProFullToken } from "@gx-design-vue/pro-provider";
+import { CSSObject } from "@antdv-next/cssinjs";
+import { GenerateStyle } from "antdv-next/dist/theme/internal";
+
+//#region src/style/sider.d.ts
+declare const genSiderStyle: GenerateStyle<ProFullToken<'ProLayout'>, CSSObject>;
+//#endregion
+export { genSiderStyle as default };

package/dist/style/sider.js

@@ -0,0 +1,92 @@
+//#region src/style/sider.ts
+const genSiderStyle = (token) => {
+	const { componentCls, antCls } = token;
+	return { [componentCls]: {
+		[`${componentCls}-sider`]: {
+			position: "relative",
+			borderRight: 0,
+			zIndex: 105,
+			background: token.siderColorMenuBackground || "transparent",
+			[`${antCls}-layout-sider-children`]: {
+				position: "relative",
+				display: "flex",
+				flexDirection: "column",
+				borderInlineEnd: `1px solid ${token.colorSplit}`,
+				background: "transparent"
+			},
+			"&-children": {
+				position: "relative",
+				display: "flex",
+				flex: 1,
+				minHeight: 0,
+				height: "100%",
+				flexDirection: "column"
+			},
+			"&-header": {
+				paddingBlock: 0,
+				paddingInline: 0
+			},
+			"&-content": {
+				position: "relative",
+				display: "flex",
+				flex: "1 1 0%",
+				minHeight: 0,
+				flexDirection: "column",
+				overflow: "hidden"
+			},
+			[`${componentCls}-sider-content [data-top-shadow]`]: { flex: "1 1 0%" },
+			"&-menu-view": {
+				paddingInline: token.siderPaddingInlineLayoutMenu || 0,
+				paddingBlock: token.siderPaddingBlockLayoutMenu || 0
+			},
+			[`${componentCls}-sider-content [data-top-shadow="true"] ${componentCls}-sider-menu-container`]: {
+				WebkitMaskImage: `linear-gradient(0deg, ${token.colorBgContainer} calc(100% - var(--scroll-shadow-size, 5%)), transparent)`,
+				maskImage: `linear-gradient(0deg, ${token.colorBgContainer} calc(100% - var(--scroll-shadow-size, 5%)), transparent)`
+			},
+			[`${componentCls}-sider-content [data-bottom-shadow="true"] ${componentCls}-sider-menu-container`]: {
+				WebkitMaskImage: `linear-gradient(180deg, ${token.colorBgContainer} calc(100% - var(--scroll-shadow-size, 5%)), transparent)`,
+				maskImage: `linear-gradient(180deg, ${token.colorBgContainer} calc(100% - var(--scroll-shadow-size, 5%)), transparent)`
+			},
+			[`${componentCls}-sider-content [data-top-shadow="true"][data-bottom-shadow="true"] ${componentCls}-sider-menu-container`]: {
+				WebkitMaskImage: `linear-gradient(
+            ${token.colorBgContainer},
+            ${token.colorBgContainer},
+            transparent 0,
+            ${token.colorBgContainer} var(--scroll-shadow-size, 5%),
+            ${token.colorBgContainer} calc(100% - var(--scroll-shadow-size, 5%)),
+            transparent
+          )`,
+				maskImage: `linear-gradient(
+            ${token.colorBgContainer},
+            ${token.colorBgContainer},
+            transparent 0,
+            ${token.colorBgContainer} var(--scroll-shadow-size, 5%),
+            ${token.colorBgContainer} calc(100% - var(--scroll-shadow-size, 5%)),
+            transparent
+          )`
+			},
+			"&-fixed-menu": {
+				flexShrink: 0,
+				borderTop: `1px solid ${token.colorSplit}`
+			},
+			"&-footer": {
+				paddingBlock: token.paddingXS,
+				paddingInline: token.paddingSM,
+				flexShrink: 0
+			}
+		},
+		[`${componentCls}-sider-fixed`]: {
+			position: "fixed",
+			insetBlockStart: 0,
+			insetInlineStart: 0,
+			height: "100%"
+		},
+		[`${componentCls}-mix`]: { [`${componentCls}-sider`]: { borderBlockEnd: "none" } },
+		[`${componentCls}-wide`]: { [`${componentCls}-sider`]: {
+			position: "sticky",
+			borderRadius: token.pageContainerBorderRadius
+		} }
+	} };
+};
+//#endregion
+export { genSiderStyle as default };

package/dist/style/tabs.d.ts

@@ -0,0 +1,14 @@
+import { ProFullToken } from "@gx-design-vue/pro-provider";
+import { CSSObject } from "@antdv-next/cssinjs";
+import { GenerateStyle } from "antdv-next/dist/theme/internal";
+
+//#region src/style/tabs.d.ts
+/**
+ * LayoutTabs 上层容器样式（标签栏容器 / 标题 / 右侧操作区 / fixed 占位）。
+ *
+ * 卡片页签本身的样式由 `components/Tabs/style`（InnerTabs）承担；
+ * 本文件不再覆盖任何 antdv-next Tabs DOM。
+ */
+declare const genTabsStyle: GenerateStyle<ProFullToken<'ProLayout'>, CSSObject>;
+//#endregion
+export { genTabsStyle as default };

package/dist/style/tabs.js

@@ -0,0 +1,97 @@
+//#region src/style/tabs.ts
+/**
+* LayoutTabs 上层容器样式（标签栏容器 / 标题 / 右侧操作区 / fixed 占位）。
+*
+* 卡片页签本身的样式由 `components/Tabs/style`（InnerTabs）承担；
+* 本文件不再覆盖任何 antdv-next Tabs DOM。
+*/
+const genTabsStyle = (token) => {
+	const { componentCls, calc } = token;
+	const iconBtnSize = token.controlHeightSM;
+	const closeIconBoxSize = token.controlHeightXS;
+	const tabsCls = `${componentCls}-tabs`;
+	return { [tabsCls]: {
+		[`${tabsCls}-content`]: {
+			paddingBlock: token.paddingXXS,
+			paddingInline: token.paddingSM,
+			backgroundColor: token.colorBgContainer,
+			borderBlockEnd: `${token.lineWidth} solid ${token.colorBorderSecondary}`,
+			position: "relative",
+			zIndex: 99,
+			transition: `width ${token.motionDurationMid} ${token.motionEaseInOut}`
+		},
+		"&-title": {
+			display: "inline-flex",
+			alignItems: "center",
+			gap: token.marginXXS,
+			"&-text": {
+				maxWidth: 120,
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap",
+				fontSize: token.fontSizeSM
+			},
+			"&-pin": {
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				width: 12,
+				height: 12,
+				fontSize: 10,
+				color: token.colorPrimary
+			},
+			"&-close": {
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				flex: "0 0 auto",
+				width: closeIconBoxSize,
+				height: closeIconBoxSize,
+				padding: 0,
+				fontSize: calc(token.fontSizeSM).sub(2).equal(),
+				lineHeight: 1,
+				color: token.tabsColorCloseIcon,
+				borderRadius: token.borderRadiusSM,
+				transition: `all ${token.motionDurationMid}`,
+				"&:hover": {
+					color: token.tabsColorCloseIconHover,
+					backgroundColor: token.tabsColorCloseBgHover
+				}
+			},
+			[`.ant-pro-inner-tabs-tab-active &-close:hover`]: {
+				color: token.tabsColorCloseIconActive,
+				backgroundColor: token.tabsColorCloseBgActiveHover
+			}
+		},
+		"&-extra": {
+			display: "inline-flex",
+			alignItems: "center",
+			gap: token.marginXS,
+			marginInlineStart: token.marginSM,
+			"&-btn": {
+				display: "inline-flex",
+				alignItems: "center",
+				justifyContent: "center",
+				width: iconBtnSize,
+				height: iconBtnSize,
+				fontSize: token.fontSize,
+				color: token.colorIcon,
+				cursor: "pointer",
+				borderRadius: token.borderRadiusSM,
+				transition: `all ${token.motionDurationMid}`,
+				"&:hover": {
+					color: token.colorIconHover,
+					backgroundColor: token.colorBgTextHover
+				}
+			}
+		},
+		"&-fixed": { [`${tabsCls}-content`]: {
+			position: "fixed",
+			right: 0,
+			zIndex: 99,
+			transition: `all ${token.motionDurationMid} ${token.motionEaseInOut}`
+		} }
+	} };
+};
+//#endregion
+export { genTabsStyle as default };

package/dist/theme/augment.d.ts

@@ -0,0 +1,20 @@
+import { ComponentToken } from "../components/AppPage/style.js";
+import { ComponentToken as ComponentToken$1 } from "../components/FooterToolbar/style.js";
+import { ComponentToken as ComponentToken$2 } from "../components/Menu/style/index.js";
+import { ComponentToken as ComponentToken$3 } from "../components/PageContainer/style.js";
+import { ComponentToken as ComponentToken$4 } from "../components/PageTransition/style.js";
+import { ComponentToken as ComponentToken$5 } from "../components/Tabs/style/index.js";
+import { ComponentToken as ComponentToken$6 } from "../style/index.js";
+
+//#region src/theme/augment.d.ts
+declare module 'antdv-next/dist/theme/interface/components' {
+  interface ComponentTokenMap {
+    ProLayout?: ComponentToken$6;
+    InnerTabs?: ComponentToken$5;
+    ProAppPage?: ComponentToken;
+    ProMenu?: ComponentToken$2;
+    ProFooterToolbar?: ComponentToken$1;
+    ProPageContainer?: ComponentToken$3;
+    ProPageTransition?: ComponentToken$4;
+  }
+}

package/dist/theme/augment.js

@@ -0,0 +1 @@
+export {};

package/dist/theme/interface/components.d.ts

@@ -0,0 +1,20 @@
+import { ComponentToken } from "../../components/AppPage/style.js";
+import { ComponentToken as ComponentToken$1 } from "../../components/FooterToolbar/style.js";
+import { ComponentToken as ComponentToken$2 } from "../../components/Menu/style/index.js";
+import { ComponentToken as ComponentToken$3 } from "../../components/PageContainer/style.js";
+import { ComponentToken as ComponentToken$4 } from "../../components/PageTransition/style.js";
+import { ComponentToken as ComponentToken$5 } from "../../components/Tabs/style/index.js";
+import { ComponentToken as ComponentToken$6 } from "../../style/index.js";
+
+//#region src/theme/interface/components.d.ts
+interface ComponentTokenMap {
+  ProLayout?: ComponentToken$6;
+  InnerTabs?: ComponentToken$5;
+  ProAppPage?: ComponentToken;
+  ProMenu?: ComponentToken$2;
+  ProFooterToolbar?: ComponentToken$1;
+  ProPageContainer?: ComponentToken$3;
+  ProPageTransition?: ComponentToken$4;
+}
+//#endregion
+export { ComponentTokenMap };

package/dist/theme/interface/components.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/config.d.ts

@@ -0,0 +1,12 @@
+//#region src/utils/config.d.ts
+/**
+ * Normalize layout section config:
+ * - `false` disables the section and returns `null`.
+ * - `undefined` uses defaults.
+ * - objects are shallow-merged over defaults.
+ *
+ * This is layout-domain behavior, not a shared pro-utils primitive.
+ */
+declare function normalizeSectionConfig<T extends object>(config: Partial<T> | false | undefined, defaults: Partial<T>): T | null;
+//#endregion
+export { normalizeSectionConfig };

package/dist/utils/config.js

@@ -0,0 +1,18 @@
+//#region src/utils/config.ts
+/**
+* Normalize layout section config:
+* - `false` disables the section and returns `null`.
+* - `undefined` uses defaults.
+* - objects are shallow-merged over defaults.
+*
+* This is layout-domain behavior, not a shared pro-utils primitive.
+*/
+function normalizeSectionConfig(config, defaults) {
+	if (config === false) return null;
+	return {
+		...defaults,
+		...config ?? {}
+	};
+}
+//#endregion
+export { normalizeSectionConfig };

package/dist/utils/menu.d.ts

@@ -1,24 +1,115 @@
-import { AppRouteModule } from "../types/RouteTypings.js";
-import { RecordType } from "@gx-design-vue/pro-utils";
+import { BreadcrumbItemType, LayoutMenuRoute, Meta } from "../interface.js";
 
 //#region src/utils/menu.d.ts
-interface MenuData {
-  menuData: AppRouteModule[];
-  flatMenus: AppRouteModule[];
-  breadcrumb: RecordType;
-  menuMap: Map<AppRouteModule['name'], AppRouteModule>;
+/**
+ * 菜单数据层（纯函数）。
+ *
+ * 设计原则：
+ * - **不可变**：所有变换都返回新对象，绝不修改入参（源路由可被外部冻结）。
+ * - **零响应式**：`buildMenuLookup` 产出的路由用 `markRaw` 标记，避免大菜单树被 Vue 深度代理，
+ *   这是旧实现内存增长 / 卡顿的根因。
+ * - **查询 O(1)/O(depth)**：用 `Map<name, entry>` + `parentNames` 替代旧的 `key="0-1-2"` 字符串切割。
+ * - **只产路由分支**：数据层只输出清洗 / 排序 / 切分后的 `LayoutMenuRoute[]`；
+ *   route → antdv-next `MenuItemType` 的转换交给 `ProMenu` 组件自洽完成。
+ */
+/** 扁平查找项：route 为 markRaw 的源路由，parentNames 为根→直接父（含序、不含自身）。 */
+interface MenuLookupEntry {
+  route: LayoutMenuRoute;
+  parentNames: string[];
+  path: number[];
 }
-declare function handlePathKey(record: AppRouteModule): string;
-declare function getMenuData(routes: AppRouteModule[]): MenuData;
-declare function clearMenuItem(menusData: AppRouteModule[]): AppRouteModule[];
-declare function flatMap(menusData: AppRouteModule[]): AppRouteModule[];
-declare function getMenuFirstChildren(menus: AppRouteModule[], key?: string): AppRouteModule[];
-declare function getLastPath(data: AppRouteModule[]): string;
-declare function getParentKeys(key: string): string[];
-declare function getMatchedList(menuProps: {
-  flatMenus: AppRouteModule[];
-  menuMap: MenuData['menuMap'];
-}, name: AppRouteModule['name']): AppRouteModule[];
-declare function filterTree(tree: AppRouteModule[], filterFn: (node: AppRouteModule) => boolean): AppRouteModule[];
+/** 一次构建产出的菜单模型。 */
+interface MenuModel {
+  /** 清洗 + 排序后的不可变菜单树 */
+  menus: LayoutMenuRoute[];
+  /** 深度优先、按 name 去重的扁平列表（markRaw） */
+  flatMenus: LayoutMenuRoute[];
+  /** name → 查找项 */
+  lookup: Map<string, MenuLookupEntry>;
+}
+/** `resolveRouteTarget` 的解析结果。 */
+interface ResolveRouteResult {
+  type: 'internal' | 'external';
+  /** 内部跳转目标路径 */
+  path?: string;
+  /** 外链地址（linkStatus===1 且为合法 url） */
+  link?: string;
+  route?: LayoutMenuRoute;
+}
+type MenuRoutePatch = Partial<LayoutMenuRoute>;
+type MenuMetaPatch = Partial<Meta>;
+interface MenuTreeMutationOptions {
+  normalize?: boolean;
+}
+/**
+ * 从 vue-router 的扁平路由表中提取菜单数据源：取根路由（`name==='root'` 或 `path==='/'`）的子级。
+ * 替代旧 `getMenuData` 内的 `childrenRoute` 提取逻辑。
+ */
+declare function routesToMenus(routerRoutes: readonly LayoutMenuRoute[]): LayoutMenuRoute[];
+/**
+ * 清洗菜单树（不可变）。替代旧 `clearMenuItem` + `handleMenuData` 的隐藏继承块。
+ * - 丢弃无 `name` 的项；
+ * - 丢弃重复 `name`（保留首个，重复项汇总 `console.warn` 一次）；
+ * - `meta.hideChildrenInMenu` 的节点剥掉 `children`；
+ * - `hideInMenu` 继承：父 `hideInMenu` / `hideChildrenInMenu` → 子项 `meta.hideInMenu = true`。
+ */
+declare function cleanMenus(menus: LayoutMenuRoute[]): LayoutMenuRoute[];
+/**
+ * 按 `meta.order` 升序排序（不可变、稳定）。替代旧 `handleMenuData` 的 order 兜底 + `.sort`。
+ * 缺省 order 使用原始索引，保证未配置 order 时维持原顺序。
+ */
+declare function sortMenusByOrder(menus: LayoutMenuRoute[]): LayoutMenuRoute[];
+declare function normalizeMenus(menus: LayoutMenuRoute[]): LayoutMenuRoute[];
+/**
+ * 构建扁平列表 + name 查找表。替代旧 `getMenuData` 的 `flatMenus`/`menuMap`
+ * （去掉 `key="0-1-2"`、`omit`、`path.replace` 等副作用）。
+ * 每个 route 用 `markRaw` 标记，避免进入 Vue 响应式系统。
+ */
+declare function buildMenuLookup(menus: LayoutMenuRoute[]): {
+  flatMenus: LayoutMenuRoute[];
+  lookup: Map<string, MenuLookupEntry>;
+};
+declare function updateMenuAtPath(menus: LayoutMenuRoute[], path: number[], updater: MenuRoutePatch | ((route: LayoutMenuRoute) => LayoutMenuRoute)): LayoutMenuRoute[];
+declare function updateMenuMetaAtPath(menus: LayoutMenuRoute[], path: number[], updater: MenuMetaPatch | ((meta: Meta) => Meta)): LayoutMenuRoute[];
+declare function insertMenuAtPath(menus: LayoutMenuRoute[], parentPath: number[] | undefined, menu: LayoutMenuRoute, index?: number): LayoutMenuRoute[];
+declare function removeMenuAtPath(menus: LayoutMenuRoute[], path: number[]): LayoutMenuRoute[];
+declare function collectMenuNames(route: LayoutMenuRoute | undefined): string[];
+/**
+ * 解析当前路由的匹配链（根→自身）。替代 `getMatchedList` + `getParentKeys` + `handlePathKey`，
+ * 用 `parentNames` 直接取链，无字符串切割。
+ * - `meta.menuSelectKey` 会把匹配目标重定向到指定菜单；
+ * - 过滤 `hideInMenu` 的祖先；
+ * - 未知 name 或目标自身 `hideInMenu` 返回 `[]`。
+ */
+declare function resolveMatchedChain(lookup: Map<string, MenuLookupEntry>, name: string | undefined): LayoutMenuRoute[];
+/**
+ * 取第一个可见叶子的跳转路径（不可变、仅依据 `hideInMenu`）。
+ * 用于父级菜单 / 面包屑的默认跳转目标。
+ */
+declare function getLastPath(menus: LayoutMenuRoute[]): string;
+/**
+ * 基于匹配链构建面包屑路由数组（仅保留有标题的项）。
+ * `menuSelectKey` 场景下把当前真实路由追加到链尾（对齐旧行为）。
+ */
+declare function buildBreadcrumbRoutes(chain: LayoutMenuRoute[], options?: {
+  current?: LayoutMenuRoute;
+}): LayoutMenuRoute[];
+/** 将面包屑路由数组转为 antdv-next 面包屑项（纯数据，`onClick` 由组件接）。 */
+declare function toBreadcrumbItems(routes: LayoutMenuRoute[]): BreadcrumbItemType[];
+/**
+ * 解析点击菜单后的跳转目标。替代旧 `BaseMenu` 的 `onClick` 取数逻辑。
+ * 外链（`linkStatus===1` 且 link 合法）走 `window.open`，否则内部 `router.push`。
+ */
+declare function resolveRouteTarget(lookup: Map<string, MenuLookupEntry>, name: string): ResolveRouteResult;
+/**
+ * 取顶层菜单中 `name` 命中项的子级（mix 布局的侧边分支）。
+ * 替代旧 `menuData.find(name===selectedKeys[0])?.children` 与 `getMenuFirstChildren`。
+ */
+declare function selectMenuBranch(menus: LayoutMenuRoute[], name: string | undefined): LayoutMenuRoute[];
+/** 按 `meta.fixed` 拆分菜单（fixed 项钉到侧边栏底部）。替代旧 ProMenu 的 `baseMenus`/`footerMenus`。 */
+declare function partitionFixedMenus(menus: LayoutMenuRoute[]): {
+  baseMenus: LayoutMenuRoute[];
+  fixedMenus: LayoutMenuRoute[];
+};
 //#endregion
-export { MenuData, clearMenuItem, filterTree, flatMap, getLastPath, getMatchedList, getMenuData, getMenuFirstChildren, getParentKeys, handlePathKey };
+export { MenuLookupEntry, MenuMetaPatch, MenuModel, MenuRoutePatch, MenuTreeMutationOptions, ResolveRouteResult, buildBreadcrumbRoutes, buildMenuLookup, cleanMenus, collectMenuNames, getLastPath, insertMenuAtPath, normalizeMenus, partitionFixedMenus, removeMenuAtPath, resolveMatchedChain, resolveRouteTarget, routesToMenus, selectMenuBranch, sortMenusByOrder, toBreadcrumbItems, updateMenuAtPath, updateMenuMetaAtPath };