@gx-design-vue/pro-layout 0.1.0-alpha.8 → 0.1.0-alpha.9

package/dist/ProLayout.js

@@ -117,15 +117,11 @@ const GProLayout = /* @__PURE__ */ defineComponent((props, { emit, expose, slots
 	const footerConfig = computed(() => normalizeSectionConfig(props.footerConfig, DEFAULT_LAYOUT_CONFIG.footerConfig));
 	const breadcrumbConfig = computed(() => normalizeSectionConfig(props.breadcrumb, DEFAULT_LAYOUT_CONFIG.breadcrumb));
 	const pageContainerConfig = computed(() => ({
-		...DEFAULT_LAYOUT_CONFIG.pageContainerConfig,
+		...DEFAULT_LAYOUT_CONFIG.pageContainer,
 		...props.pageContainer || {}
 	}));
 	const tabsConf = computed(() => normalizeSectionConfig(props.tabsConfig, DEFAULT_LAYOUT_CONFIG.tabsConfig));
 	const tabsStateConfig = computed(() => tabsConf.value ?? {});
-	const tabsModel = useVModel(props, "tabs", emit, {
-		passive: true,
-		defaultValue: []
-	});
 	const collapsedWidth = computed(() => collapseConfig.value?.width ?? DEFAULT_LAYOUT_CONFIG.collapse.width);
 	/** Sider 实际渲染宽度：0 表示不可见，否则 = 折叠/展开的真实宽度 */
 	const siderWidth = computed(() => {
@@ -141,7 +137,6 @@ const GProLayout = /* @__PURE__ */ defineComponent((props, { emit, expose, slots
 		return collapsed.value ? collapsedWidth.value : width;
 	});
 	const tabsState = useTabsState({
-		tabs: tabsModel,
 		config: tabsStateConfig,
 		flatMenus: menuState.flatMenus,
 		siderWidth,
@@ -150,9 +145,6 @@ const GProLayout = /* @__PURE__ */ defineComponent((props, { emit, expose, slots
 		onTabsChange: (val) => {
 			emit("tabsChange", val);
 		},
-		onUpdateTabs: (val) => {
-			emit("update:tabs", val);
-		},
 		onReloadPage: () => {
 			emit("reloadPage");
 			renderRouterView.value = false;
@@ -346,10 +338,6 @@ const GProLayout = /* @__PURE__ */ defineComponent((props, { emit, expose, slots
 			type: Array,
 			required: false
 		},
-		tabs: {
-			type: Array,
-			required: false
-		},
 		token: { required: false },
 		proStyles: {
 			type: Object,
@@ -494,7 +482,6 @@ const GProLayout = /* @__PURE__ */ defineComponent((props, { emit, expose, slots
 		"update:theme",
 		"update:selectedKeys",
 		"update:openKeys",
-		"update:tabs",
 		"select",
 		"openChange",
 		"darkChange",

package/dist/components/PageTransition/index.d.ts

@@ -49,8 +49,8 @@ declare const GPageTransition: _$vue.DefineComponent<_$vue.ExtractPropTypes<{
     default: string;
   };
 }>> & Readonly<{}>, {
-  direction: string;
   reverse: boolean;
+  direction: string;
   name: string;
   disabled: boolean;
 }, SlotsType<GPageTransitionSlots>, {}, {}, string, _$vue.ComponentProvideOptions, true, {}, any>;

package/dist/components/Tabs/index.js

@@ -155,7 +155,6 @@ const LayoutTabs = /* @__PURE__ */ defineComponent((props, { slots }) => {
 		}
 	},
 	emits: [
-		"update:tabs",
 		"tabsChange",
 		"reloadPage",
 		"contentFullscreenChange"

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

@@ -4,13 +4,11 @@ import { Tab } from "antdv-next/dist/tabs";
 
 //#region src/components/Tabs/interface.d.ts
 interface LayoutTabsEmits {
-  'update:tabs': (tabs: LayoutMenuRoute[]) => void;
   'tabsChange': (tabs: LayoutMenuRoute[]) => void;
   'reloadPage': () => void;
   'contentFullscreenChange': (fullscreen: boolean) => void;
 }
 interface LayoutTabsEmitsProps {
-  'onUpdate:tabs'?: LayoutTabsEmits['update:tabs'];
   onTabsChange?: LayoutTabsEmits['tabsChange'];
   onReloadPage?: LayoutTabsEmits['reloadPage'];
   onContentFullscreenChange?: LayoutTabsEmits['contentFullscreenChange'];

package/dist/hooks/useLayoutBase.d.ts

@@ -40,33 +40,33 @@ declare function useLayoutBase(props?: {
   openKeys: _$vue.ComputedRef<string[]>;
   proClasses: _$vue.ComputedRef<{
     content?: string;
-    root?: string;
     header?: string;
     sider?: string;
+    breadcrumb?: string;
+    logo?: string;
+    root?: string;
     siderChildren?: string;
     siderHeader?: string;
     siderFooter?: string;
-    logo?: string;
     logoImage?: string;
     footer?: string;
     menu?: string;
     tabs?: string;
-    breadcrumb?: string;
   }>;
   proStyles: _$vue.ComputedRef<{
     content?: _$vue.CSSProperties;
-    root?: _$vue.CSSProperties;
     header?: _$vue.CSSProperties;
     sider?: _$vue.CSSProperties;
+    breadcrumb?: _$vue.CSSProperties;
+    logo?: _$vue.CSSProperties;
+    root?: _$vue.CSSProperties;
     siderChildren?: _$vue.CSSProperties;
     siderHeader?: _$vue.CSSProperties;
     siderFooter?: _$vue.CSSProperties;
-    logo?: _$vue.CSSProperties;
     logoImage?: _$vue.CSSProperties;
     footer?: _$vue.CSSProperties;
     menu?: _$vue.CSSProperties;
     tabs?: _$vue.CSSProperties;
-    breadcrumb?: _$vue.CSSProperties;
   }>;
   breadcrumbRender: _$vue.Ref<(props: LayoutBreadcrumbSlotProps) => any, (props: LayoutBreadcrumbSlotProps) => any>;
   breadcrumbConfig: _$vue.ComputedRef<LayoutBreadcrumbConfig>;

package/dist/hooks/useTabs.d.ts

@@ -8,11 +8,9 @@ interface MenuDataState {
   normal: LayoutMenuRoute[];
 }
 interface UseTabsStateOptions {
-  /** v-model:tabs 绑定值 */
-  tabs: Ref<LayoutMenuRoute[]>;
   /** 标签栏配置 */
   config: ComputedRef<LayoutTabsConfig>;
-  /** 扁平菜单列表（用于固定标签扫描 & 过滤无效标签） */
+  /** 扁平菜单列表（用于固定标签扫描 & 过滤无效 fixed 标签） */
   flatMenus: ComputedRef<LayoutMenuRoute[]>;
   /** 侧边栏展开宽度（支持响应式 — 路由切换时 Sider 可见性可能变化） */
   siderWidth: ComputedRef<number | string>;
@@ -20,14 +18,13 @@ interface UseTabsStateOptions {
   isMobile: ComputedRef<boolean>;
   /** 内容是否全屏 */
   contentFullscreen: Ref<boolean>;
-  /** 事件回调 */
+  /** 事件回调（单向通知，不再有 v-model 回流） */
   onTabsChange: (tabs: LayoutMenuRoute[]) => void;
-  onUpdateTabs: (tabs: LayoutMenuRoute[]) => void;
   onReloadPage: () => void;
   onContentFullscreenChange: (fullscreen: boolean) => void;
 }
 interface UseTabsStateReturn {
-  /** 标签原始状态（fixed + normal） */
+  /** 标签原始状态（fixed + normal） — 单一真相源 */
   menuDataState: MenuDataState;
   /** 合并后的完整标签列表 */
   dataSource: ComputedRef<LayoutMenuRoute[]>;

package/dist/hooks/useTabs.js

@@ -1,5 +1,5 @@
 import { useInjectLayoutContext } from "../context/index.js";
-import { computed, reactive, toRaw, watch } from "vue";
+import { computed, reactive, ref, toRaw, watch } from "vue";
 import { unit } from "@gx-design-vue/pro-provider";
 import { isBoolean } from "@gx-design-vue/pro-utils";
 import { useLocalStorage, useThrottleFn } from "@vueuse/core";
@@ -86,22 +86,8 @@ function isFixedTabRoute(route) {
 	const { fixed } = route?.meta?.tabState ?? {};
 	return isBoolean(fixed) ? fixed : false;
 }
-function splitTabsByFixed(tabs) {
-	const state = {
-		fixed: [],
-		normal: []
-	};
-	const seenNames = /* @__PURE__ */ new Set();
-	tabs?.forEach((tab) => {
-		if (!tab?.name || seenNames.has(tab.name)) return;
-		seenNames.add(tab.name);
-		const normalized = normalizeTabRoute(tab);
-		state[isFixedTabRoute(normalized) ? "fixed" : "normal"].push(normalized);
-	});
-	return state;
-}
-function getInitialTabsState(tabs, storageTabs, persistent) {
-	if (tabs.value?.length) return splitTabsByFixed(tabs.value);
+/** 初始状态：仅从 localStorage 恢复（单一外部源，不再有 v-model 优先级） */
+function getInitialTabsState(storageTabs, persistent) {
 	if (persistent && storageTabs.value) return {
 		fixed: storageTabs.value.fixed?.map(normalizeTabRoute) ?? [],
 		normal: storageTabs.value.normal?.map(normalizeTabRoute) ?? []
@@ -111,11 +97,8 @@ function getInitialTabsState(tabs, storageTabs, persistent) {
 		normal: []
 	};
 }
-function getTabsSignature(tabs) {
-	return JSON.stringify((tabs ?? []).map((tab) => toStorageTabRoute(tab)));
-}
 function useTabsState(options) {
-	const { tabs, config, flatMenus, siderWidth, isMobile, contentFullscreen, onTabsChange, onUpdateTabs, onReloadPage, onContentFullscreenChange } = options;
+	const { config, flatMenus, siderWidth, isMobile, contentFullscreen, onTabsChange, onReloadPage, onContentFullscreenChange } = options;
 	const router = useRouter();
 	const currentRoute = useRoute();
 	const isPersistent = computed(() => config.value.persistent !== false);
@@ -123,11 +106,8 @@ function useTabsState(options) {
 		fixed: [],
 		normal: []
 	});
-	const initialTabsState = getInitialTabsState(tabs, storageTabs, isPersistent.value);
-	const menuDataState = reactive({
-		fixed: initialTabsState.fixed,
-		normal: initialTabsState.normal
-	});
+	const menuDataState = reactive(getInitialTabsState(storageTabs, isPersistent.value));
+	const menusReady = ref(flatMenus.value.length > 0);
 	const dataSource = computed(() => [...menuDataState.fixed, ...menuDataState.normal]);
 	const activeKey = computed(() => currentRoute.name);
 	const tabsWidth = computed(() => {
@@ -168,12 +148,21 @@ function useTabsState(options) {
 		const fixed = checkIsFixed(record);
 		const name = getTabName(record);
 		const tabData = normalizeTabRoute(record);
-		if (dataSource.value.some((item) => getTabName(item) === name)) changeTabsList(record, {
+		const existing = dataSource.value.find((item) => getTabName(item) === name);
+		if (!existing) {
+			menuDataState[fixed ? "fixed" : "normal"].push(tabData);
+			return;
+		}
+		if (checkIsFixed(existing) !== fixed) {
+			changeTabsList(existing, {
+				type: "remove",
+				params: existing
+			});
+			menuDataState[fixed ? "fixed" : "normal"].push(mergeTabRoute(existing, tabData));
+		} else changeTabsList(record, {
 			type: "merge",
 			params: tabData
 		});
-		else if (fixed) menuDataState.fixed.push(tabData);
-		else menuDataState.normal.push(tabData);
 	}
 	/** 导航到最后一个标签 */
 	function navigateToLastTab() {
@@ -265,11 +254,12 @@ function useTabsState(options) {
 	}, 500);
 	watch(flatMenus, (menus) => {
 		if (!menus.length) return;
-		const menuNameSet = new Set(menus.map((m) => m.name));
+		if (!menusReady.value) menusReady.value = true;
+		const menuNameSet = new Set(menus.map((menuItem) => menuItem.name));
 		if (menuDataState.fixed.length) menuDataState.fixed = menuDataState.fixed.filter((item) => menuNameSet.has(item.name));
-		if (menuDataState.normal.length) menuDataState.normal = menuDataState.normal.filter((item) => menuNameSet.has(item.name));
+		const openedNames = new Set(dataSource.value.map((tab) => getTabName(tab)));
 		menus.forEach((item) => {
-			if (checkIsFixed(item)) handleAddTabs(item);
+			if (openedNames.has(getTabName(item)) || checkIsFixed(item)) handleAddTabs(item);
 		});
 	}, { immediate: true });
 	watch(() => {
@@ -287,16 +277,9 @@ function useTabsState(options) {
 	}, () => {
 		if (currentRoute?.name) handleAddTabs(currentRoute);
 	}, { immediate: true });
-	watch(() => getTabsSignature(tabs.value), (modelSignature) => {
-		if (modelSignature === getTabsSignature(dataSource.value)) return;
-		const nextState = splitTabsByFixed(tabs.value);
-		menuDataState.fixed = nextState.fixed;
-		menuDataState.normal = nextState.normal;
-	});
 	watch(dataSource, (allTabs) => {
-		if (isPersistent.value) storageTabs.value = toStorageMenuDataState(menuDataState);
+		if (isPersistent.value && menusReady.value) storageTabs.value = toStorageMenuDataState(menuDataState);
 		onTabsChange(allTabs);
-		onUpdateTabs(allTabs);
 	});
 	return {
 		menuDataState,
@@ -309,20 +292,51 @@ function useTabsState(options) {
 		handleContextMenuAction,
 		checkIsFixed,
 		tabsController: {
-			clean() {
+			getTabs: () => dataSource.value.map((item) => normalizeTabRoute(item)),
+			getActive: () => activeKey.value,
+			isActive: (name) => activeKey.value === name,
+			isFixed: (name) => {
+				const route = getCurrentRoute(name);
+				return route ? checkIsFixed(route) : false;
+			},
+			add: (record) => handleAddTabs(record),
+			close: (name) => handleTabRemove(name ?? activeKey.value),
+			closeOthers: (name) => handleContextMenuAction("closeOthersTabs", name ?? activeKey.value),
+			closeLeft: (name) => handleContextMenuAction("closeLeftTabs", name ?? activeKey.value),
+			closeRight: (name) => handleContextMenuAction("closeRightTabs", name ?? activeKey.value),
+			closeAll: () => handleContextMenuAction("closeAllTabs", activeKey.value),
+			clean: () => {
 				menuDataState.fixed = [];
 				menuDataState.normal = [];
 			},
-			close(name) {
-				handleTabRemove(name ?? activeKey.value);
+			switchTo: (name) => handleTabClick(name),
+			toggleFixed: (name, fixed) => {
+				const route = getCurrentRoute(name);
+				if (!route) return;
+				const currentFixed = checkIsFixed(route);
+				if ((fixed ?? !currentFixed) !== currentFixed) handleContextMenuAction("fixed", name);
 			},
-			update(record, operation) {
-				changeTabsList(record, {
-					type: operation.type,
-					addType: operation.addType,
-					params: operation.params ?? record
-				});
-			}
+			reload: (name) => {
+				const target = name ?? activeKey.value;
+				const run = () => throttledReload();
+				if (target !== activeKey.value) {
+					const route = getCurrentRoute(target);
+					if (route) {
+						router.push({
+							path: getRoutePath(route),
+							...getExtraProps(route)
+						}).then(run);
+						return;
+					}
+				}
+				run();
+			},
+			toggleFullscreen: () => handleContextMenuAction("fullScreen", activeKey.value),
+			update: (record, op) => changeTabsList(record, {
+				type: op.type,
+				addType: op.addType,
+				params: op.params ?? record
+			})
 		}
 	};
 }
@@ -331,8 +345,21 @@ function useTabsState(options) {
 * 通过 inject 获取 `GProLayout` 暴露的 tabs 控制器。
 */
 const fallbackController = {
-	clean: () => {},
+	getTabs: () => [],
+	getActive: () => "",
+	isActive: () => false,
+	isFixed: () => false,
+	add: () => {},
 	close: () => {},
+	closeOthers: () => {},
+	closeLeft: () => {},
+	closeRight: () => {},
+	closeAll: () => {},
+	clean: () => {},
+	switchTo: () => {},
+	toggleFixed: () => {},
+	reload: () => {},
+	toggleFullscreen: () => {},
 	update: () => {}
 };
 /**

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import { LAYOUT_MENU_SLOT_KEYS, LayoutMenuEmits, LayoutMenuEmitsProps, LayoutMen
 import { LayoutSiderEmits, LayoutSiderEmitsProps, LayoutSiderProps, LayoutSiderSlots } from "./components/Sider/interface.js";
 import { LayoutTabsEmits, LayoutTabsEmitsProps, LayoutTabsProps, LayoutTabsSlots } from "./components/Tabs/interface.js";
 import { LayoutContentEmits, LayoutContentEmitsProps, LayoutContentProps, LayoutContentSlots } from "./components/WrapContent/interface.js";
-import { APP_PAGE_SLOT_KEYS, AppPageSlotKey, AppPageSpinning, BreadcrumbItemType, CardProps, DeepPartial, EmptyEmits, FOOTER_TOOLBAR_SLOT_KEYS, FooterToolbarClassNamesType, FooterToolbarSemanticName, FooterToolbarSlotKey, FooterToolbarStylesType, GFooterToolbarProps, GFooterToolbarSlots, GPageContainerEmits, GPageContainerEmitsProps, GPageContainerProps, GPageContainerSlots, GPageTransitionProps, GPageTransitionSlots, GProAppPageProps, GProAppPageSlots, GProLayoutEmits, GProLayoutEmitsProps, GProLayoutProps, GProLayoutRef, GProLayoutSlots, LAYOUT_SLOT_KEYS, LayoutBreadcrumbConfig, LayoutBreadcrumbSlotProps, LayoutClassNamesType, LayoutCollapseConfig, LayoutFooterConfig, LayoutFooterLink, LayoutHeaderConfig, LayoutHeaderSlotProps, LayoutLogoConfig, LayoutMenuConfig, LayoutMenuItemSlotProps, LayoutMenuRoute, LayoutPageContainerConfig, LayoutSelectInfo, LayoutSemanticName, LayoutSiderConfig, LayoutSiderSlotProps, LayoutStylesType, LayoutTabsConfig, LayoutTabsController, MenuClassNamesType, MenuClickInfo, MenuProps, MenuRenderItem, MenuSelectInfo, MenuSemanticName, MenuStylesType, Meta, PAGE_CONTAINER_SLOT_KEYS, PageContainerCard, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, SiderProps, SpinProps, Tab, TabsMeta, TabsProps, WatermarkProps } from "./interface.js";
+import { APP_PAGE_SLOT_KEYS, AppPageSlotKey, AppPageSpinning, BreadcrumbItemType, CardProps, DeepPartial, EmptyEmits, FOOTER_TOOLBAR_SLOT_KEYS, FooterToolbarClassNamesType, FooterToolbarSemanticName, FooterToolbarSlotKey, FooterToolbarStylesType, GFooterToolbarProps, GFooterToolbarSlots, GPageContainerEmits, GPageContainerEmitsProps, GPageContainerProps, GPageContainerSlots, GPageTransitionProps, GPageTransitionSlots, GProAppPageProps, GProAppPageSlots, GProLayoutEmits, GProLayoutEmitsProps, GProLayoutProps, GProLayoutRef, GProLayoutSlots, LAYOUT_SLOT_KEYS, LayoutBreadcrumbConfig, LayoutBreadcrumbSlotProps, LayoutClassNamesType, LayoutCollapseConfig, LayoutFooterConfig, LayoutFooterLink, LayoutHeaderConfig, LayoutHeaderSlotProps, LayoutLogoConfig, LayoutMenuConfig, LayoutMenuItemSlotProps, LayoutMenuRoute, LayoutPageContainerConfig, LayoutSelectInfo, LayoutSemanticName, LayoutSiderConfig, LayoutSiderSlotProps, LayoutStylesType, LayoutTabsConfig, LayoutTabsController, LayoutTabsUpdateOp, MenuClassNamesType, MenuClickInfo, MenuProps, MenuRenderItem, MenuSelectInfo, MenuSemanticName, MenuStylesType, Meta, PAGE_CONTAINER_SLOT_KEYS, PageContainerCard, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, SiderProps, SpinProps, Tab, TabsMeta, TabsProps, WatermarkProps } from "./interface.js";
 import GProLayout from "./ProLayout.js";
 import { ProAppPageContext, useAppPageContext } from "./components/AppPage/context.js";
 import ProAppPage from "./components/AppPage/index.js";
@@ -19,4 +19,4 @@ import { MenuLookupEntry, MenuMetaPatch, MenuModel, MenuRoutePatch, MenuTreeMuta
 import { LayoutMenuState, UseLayoutMenuOptions, UseLayoutMenuReturn, useMenu } from "./hooks/useMenu.js";
 import { useTabs } from "./hooks/useTabs.js";
 import { LayoutContextProps, useInjectLayoutContext } from "./context/index.js";
-export { APP_PAGE_SLOT_KEYS, AppPageSlotKey, AppPageSpinning, BreadcrumbItemType, CardProps, DeepPartial, EmptyEmits, FOOTER_TOOLBAR_SLOT_KEYS, FooterToolbarClassNamesType, FooterToolbarSemanticName, FooterToolbarSlotKey, FooterToolbarStylesType, GFooterToolbar, GFooterToolbarProps, GFooterToolbarSlots, GPageContainerEmits, GPageContainerEmitsProps, GPageContainerProps, GPageContainerSlots, GPageTransition, GPageTransitionProps, GPageTransitionSlots, ProAppPage as GProAppPage, GProAppPageProps, GProAppPageSlots, GProLayout, GProLayoutEmits, GProLayoutEmitsProps, GProLayoutProps, GProLayoutRef, GProLayoutSlots, ProPageContainer as GProPageContainer, LAYOUT_MENU_SLOT_KEYS, LAYOUT_SLOT_KEYS, LayoutBreadcrumbConfig, LayoutBreadcrumbProps, LayoutBreadcrumbSlotProps, LayoutBreadcrumbSlots, LayoutClassNamesType, LayoutCollapseButtonEmits, LayoutCollapseButtonEmitsProps, LayoutCollapseButtonProps, LayoutCollapseButtonSlots, LayoutCollapseConfig, LayoutContentEmits, LayoutContentEmitsProps, LayoutContentProps, LayoutContentSlots, type LayoutContextProps, LayoutFooterConfig, LayoutFooterLink, LayoutFooterProps, LayoutFooterSlots, LayoutHeaderConfig, LayoutHeaderEmits, LayoutHeaderEmitsProps, LayoutHeaderProps, LayoutHeaderSlotProps, LayoutHeaderSlots, LayoutLogoConfig, LayoutLogoEmits, LayoutLogoEmitsProps, LayoutLogoProps, LayoutLogoSlots, LayoutMenu, LayoutMenuConfig, LayoutMenuEmits, LayoutMenuEmitsProps, LayoutMenuItemSlotProps, LayoutMenuProps, LayoutMenuRoute, LayoutMenuSlots, type LayoutMenuState, LayoutPageContainerConfig, LayoutSelectInfo, LayoutSemanticName, LayoutSiderConfig, LayoutSiderEmits, LayoutSiderEmitsProps, LayoutSiderProps, LayoutSiderSlotProps, LayoutSiderSlots, LayoutStylesType, LayoutTabsConfig, LayoutTabsController, LayoutTabsEmits, LayoutTabsEmitsProps, LayoutTabsProps, LayoutTabsSlots, MenuClassNamesType, MenuClickInfo, MenuLookupEntry, MenuMetaPatch, MenuModel, MenuProps, MenuRenderItem, MenuRoutePatch, MenuSelectInfo, MenuSemanticName, MenuStylesType, MenuTreeMutationOptions, Meta, PAGE_CONTAINER_SLOT_KEYS, PageContainerCard, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, type ProAppPageContext, ResolveRouteResult, SiderProps, SpinProps, Tab, TabsMeta, TabsProps, type UseLayoutMenuOptions, type UseLayoutMenuReturn, WatermarkProps, buildBreadcrumbRoutes, buildMenuLookup, cleanMenus, collectMenuNames, getLastPath, insertMenuAtPath, normalizeMenus, partitionFixedMenus, removeMenuAtPath, resolveMatchedChain, resolveRouteTarget, routesToMenus, selectMenuBranch, sortMenusByOrder, toBreadcrumbItems, updateMenuAtPath, updateMenuMetaAtPath, useAppPageContext, useInjectLayoutContext, useMenu, useTabs };
+export { APP_PAGE_SLOT_KEYS, AppPageSlotKey, AppPageSpinning, BreadcrumbItemType, CardProps, DeepPartial, EmptyEmits, FOOTER_TOOLBAR_SLOT_KEYS, FooterToolbarClassNamesType, FooterToolbarSemanticName, FooterToolbarSlotKey, FooterToolbarStylesType, GFooterToolbar, GFooterToolbarProps, GFooterToolbarSlots, GPageContainerEmits, GPageContainerEmitsProps, GPageContainerProps, GPageContainerSlots, GPageTransition, GPageTransitionProps, GPageTransitionSlots, ProAppPage as GProAppPage, GProAppPageProps, GProAppPageSlots, GProLayout, GProLayoutEmits, GProLayoutEmitsProps, GProLayoutProps, GProLayoutRef, GProLayoutSlots, ProPageContainer as GProPageContainer, LAYOUT_MENU_SLOT_KEYS, LAYOUT_SLOT_KEYS, LayoutBreadcrumbConfig, LayoutBreadcrumbProps, LayoutBreadcrumbSlotProps, LayoutBreadcrumbSlots, LayoutClassNamesType, LayoutCollapseButtonEmits, LayoutCollapseButtonEmitsProps, LayoutCollapseButtonProps, LayoutCollapseButtonSlots, LayoutCollapseConfig, LayoutContentEmits, LayoutContentEmitsProps, LayoutContentProps, LayoutContentSlots, type LayoutContextProps, LayoutFooterConfig, LayoutFooterLink, LayoutFooterProps, LayoutFooterSlots, LayoutHeaderConfig, LayoutHeaderEmits, LayoutHeaderEmitsProps, LayoutHeaderProps, LayoutHeaderSlotProps, LayoutHeaderSlots, LayoutLogoConfig, LayoutLogoEmits, LayoutLogoEmitsProps, LayoutLogoProps, LayoutLogoSlots, LayoutMenu, LayoutMenuConfig, LayoutMenuEmits, LayoutMenuEmitsProps, LayoutMenuItemSlotProps, LayoutMenuProps, LayoutMenuRoute, LayoutMenuSlots, type LayoutMenuState, LayoutPageContainerConfig, LayoutSelectInfo, LayoutSemanticName, LayoutSiderConfig, LayoutSiderEmits, LayoutSiderEmitsProps, LayoutSiderProps, LayoutSiderSlotProps, LayoutSiderSlots, LayoutStylesType, LayoutTabsConfig, LayoutTabsController, LayoutTabsEmits, LayoutTabsEmitsProps, LayoutTabsProps, LayoutTabsSlots, LayoutTabsUpdateOp, MenuClassNamesType, MenuClickInfo, MenuLookupEntry, MenuMetaPatch, MenuModel, MenuProps, MenuRenderItem, MenuRoutePatch, MenuSelectInfo, MenuSemanticName, MenuStylesType, MenuTreeMutationOptions, Meta, PAGE_CONTAINER_SLOT_KEYS, PageContainerCard, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, type ProAppPageContext, ResolveRouteResult, SiderProps, SpinProps, Tab, TabsMeta, TabsProps, type UseLayoutMenuOptions, type UseLayoutMenuReturn, WatermarkProps, buildBreadcrumbRoutes, buildMenuLookup, cleanMenus, collectMenuNames, getLastPath, insertMenuAtPath, normalizeMenus, partitionFixedMenus, removeMenuAtPath, resolveMatchedChain, resolveRouteTarget, routesToMenus, selectMenuBranch, sortMenusByOrder, toBreadcrumbItems, updateMenuAtPath, updateMenuMetaAtPath, useAppPageContext, useInjectLayoutContext, useMenu, useTabs };

package/dist/interface.d.ts

@@ -224,7 +224,6 @@ interface GProLayoutEmits {
   'update:theme': (theme: ThemeValue) => void;
   'update:selectedKeys': (keys: string[]) => void;
   'update:openKeys': (keys: string[]) => void;
-  'update:tabs': (tabs: LayoutMenuRoute[]) => void;
   'select': (info: LayoutSelectInfo) => void;
   'openChange': (keys: string[]) => void;
   'darkChange': (dark: boolean) => void;
@@ -238,7 +237,6 @@ interface GProLayoutEmitsProps {
   'onUpdate:theme'?: GProLayoutEmits['update:theme'];
   'onUpdate:selectedKeys'?: GProLayoutEmits['update:selectedKeys'];
   'onUpdate:openKeys'?: GProLayoutEmits['update:openKeys'];
-  'onUpdate:tabs'?: GProLayoutEmits['update:tabs'];
   onSelect?: GProLayoutEmits['select'];
   onOpenChange?: GProLayoutEmits['openChange'];
   onDarkChange?: GProLayoutEmits['darkChange'];
@@ -266,8 +264,6 @@ interface GProLayoutProps extends GProLayoutEmitsProps {
   selectedKeys?: string[];
   /** v-model:openKeys 展开菜单 */
   openKeys?: string[];
-  /** v-model:tabs 多标签数据 */
-  tabs?: LayoutMenuRoute[];
   token?: DeepPartial<ProAliasToken>;
   proStyles?: LayoutStylesType;
   proClasses?: LayoutClassNamesType;
@@ -278,7 +274,7 @@ interface GProLayoutProps extends GProLayoutEmitsProps {
   menu?: LayoutMenuConfig;
   /** 面包屑配置 */
   breadcrumb?: LayoutBreadcrumbConfig | false;
-  /** 多标签配置（数据走 v-model:tabs）；false 关闭标签栏 */
+  /** 多标签配置；false 关闭标签栏。标签数据由组件内部管理，通过 expose.tabs 控制、tabsChange 通知 */
   tabsConfig?: LayoutTabsConfig | false;
   /** Logo 组件配置；false 不渲染默认 Logo 区域 */
   logo?: LayoutLogoConfig | false;
@@ -348,15 +344,50 @@ interface GProLayoutSlots {
   footer?: () => any;
   copyright?: () => any;
 }
-/** tabs 命令式控制器 */
+/** tabs 底层操作参数（add/merge/remove） */
+interface LayoutTabsUpdateOp {
+  type: 'add' | 'merge' | 'remove';
+  addType?: 'push' | 'unshift';
+  params?: Partial<LayoutMenuRoute>;
+}
+/**
+ * tabs 命令式控制器。
+ * 通过 GProLayout 实例的 expose.tabs，或 useTabs() hook 获取。
+ * 标签数据内部管理（单一真相源），外部仅能通过本控制器修改、通过 tabsChange 监听。
+ */
 interface LayoutTabsController {
-  clean: () => void;
+  /** 当前全部标签（fixed + normal） */
+  getTabs: () => LayoutMenuRoute[];
+  /** 当前激活标签 name（route.name） */
+  getActive: () => string;
+  /** 指定标签是否激活 */
+  isActive: (name: string) => boolean;
+  /** 指定标签是否固定 */
+  isFixed: (name: string) => boolean;
+  /** 新增标签（已存在则合并更新） */
+  add: (record: LayoutMenuRoute) => void;
+  /** 关闭标签，默认关闭当前激活项 */
   close: (name?: string) => void;
-  update: (record: LayoutMenuRoute, op: {
-    type: 'add' | 'merge' | 'remove';
-    addType?: 'push' | 'unshift';
-    params?: Partial<LayoutMenuRoute>;
-  }) => void;
+  /** 关闭其它标签（保留目标 + fixed） */
+  closeOthers: (name?: string) => void;
+  /** 关闭左侧标签 */
+  closeLeft: (name?: string) => void;
+  /** 关闭右侧标签 */
+  closeRight: (name?: string) => void;
+  /** 关闭全部 normal 标签（保留 fixed） */
+  closeAll: () => void;
+  /** 清空全部标签（含 fixed） */
+  clean: () => void;
+  /** 切换到指定标签（等价于点击） */
+  switchTo: (name: string) => void;
+  /** 切换固定状态；省略 fixed 时取反 */
+  toggleFixed: (name: string, fixed?: boolean) => void;
+  /** 刷新标签，默认刷新当前激活项 */
+  reload: (name?: string) => void;
+  /** 切换内容全屏 */
+  toggleFullscreen: () => void;
+  /** 底层增删改（add/merge/remove），语义化方法的兜底 */
+  update: (record: LayoutMenuRoute, op: LayoutTabsUpdateOp) => void;
 }
 interface GProLayoutRef {
   tabs: LayoutTabsController;
@@ -486,4 +517,4 @@ interface GPageTransitionSlots {
   default?: () => any;
 }
 //#endregion
-export { APP_PAGE_SLOT_KEYS, AppPageSlotKey, AppPageSpinning, type BreadcrumbItemType, type CardProps, DeepPartial, EmptyEmits, FOOTER_TOOLBAR_SLOT_KEYS, FooterToolbarClassNamesType, FooterToolbarSemanticName, FooterToolbarSlotKey, FooterToolbarStylesType, GFooterToolbarProps, GFooterToolbarSlots, GPageContainerEmits, GPageContainerEmitsProps, GPageContainerProps, GPageContainerSlots, GPageTransitionProps, GPageTransitionSlots, GProAppPageProps, GProAppPageSlots, GProLayoutEmits, GProLayoutEmitsProps, GProLayoutProps, GProLayoutRef, GProLayoutSlots, LAYOUT_MENU_SLOT_KEYS, LAYOUT_SLOT_KEYS, LayoutBreadcrumbConfig, LayoutBreadcrumbProps, LayoutBreadcrumbSlotProps, LayoutBreadcrumbSlots, LayoutClassNamesType, LayoutCollapseButtonEmits, LayoutCollapseButtonEmitsProps, LayoutCollapseButtonProps, LayoutCollapseButtonSlots, LayoutCollapseConfig, LayoutContentEmits, LayoutContentEmitsProps, LayoutContentProps, LayoutContentSlots, LayoutFooterConfig, LayoutFooterLink, LayoutFooterProps, LayoutFooterSlots, LayoutHeaderConfig, LayoutHeaderEmits, LayoutHeaderEmitsProps, LayoutHeaderProps, LayoutHeaderSlotProps, LayoutHeaderSlots, LayoutLogoConfig, LayoutLogoEmits, LayoutLogoEmitsProps, LayoutLogoProps, LayoutLogoSlots, LayoutMenuConfig, LayoutMenuEmits, LayoutMenuEmitsProps, LayoutMenuItemSlotProps, LayoutMenuProps, LayoutMenuRoute, LayoutMenuSlots, LayoutPageContainerConfig, LayoutSelectInfo, LayoutSemanticName, LayoutSiderConfig, LayoutSiderEmits, LayoutSiderEmitsProps, LayoutSiderProps, LayoutSiderSlotProps, LayoutSiderSlots, LayoutStylesType, LayoutTabsConfig, LayoutTabsController, LayoutTabsEmits, LayoutTabsEmitsProps, LayoutTabsProps, LayoutTabsSlots, MenuClassNamesType, MenuClickInfo, type MenuProps, MenuRenderItem, MenuSelectInfo, MenuSemanticName, MenuStylesType, Meta, PAGE_CONTAINER_SLOT_KEYS, PageContainerCard, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, type SiderProps, type SpinProps, type Tab, TabsMeta, type TabsProps, type WatermarkProps };
+export { APP_PAGE_SLOT_KEYS, AppPageSlotKey, AppPageSpinning, type BreadcrumbItemType, type CardProps, DeepPartial, EmptyEmits, FOOTER_TOOLBAR_SLOT_KEYS, FooterToolbarClassNamesType, FooterToolbarSemanticName, FooterToolbarSlotKey, FooterToolbarStylesType, GFooterToolbarProps, GFooterToolbarSlots, GPageContainerEmits, GPageContainerEmitsProps, GPageContainerProps, GPageContainerSlots, GPageTransitionProps, GPageTransitionSlots, GProAppPageProps, GProAppPageSlots, GProLayoutEmits, GProLayoutEmitsProps, GProLayoutProps, GProLayoutRef, GProLayoutSlots, LAYOUT_MENU_SLOT_KEYS, LAYOUT_SLOT_KEYS, LayoutBreadcrumbConfig, LayoutBreadcrumbProps, LayoutBreadcrumbSlotProps, LayoutBreadcrumbSlots, LayoutClassNamesType, LayoutCollapseButtonEmits, LayoutCollapseButtonEmitsProps, LayoutCollapseButtonProps, LayoutCollapseButtonSlots, LayoutCollapseConfig, LayoutContentEmits, LayoutContentEmitsProps, LayoutContentProps, LayoutContentSlots, LayoutFooterConfig, LayoutFooterLink, LayoutFooterProps, LayoutFooterSlots, LayoutHeaderConfig, LayoutHeaderEmits, LayoutHeaderEmitsProps, LayoutHeaderProps, LayoutHeaderSlotProps, LayoutHeaderSlots, LayoutLogoConfig, LayoutLogoEmits, LayoutLogoEmitsProps, LayoutLogoProps, LayoutLogoSlots, LayoutMenuConfig, LayoutMenuEmits, LayoutMenuEmitsProps, LayoutMenuItemSlotProps, LayoutMenuProps, LayoutMenuRoute, LayoutMenuSlots, LayoutPageContainerConfig, LayoutSelectInfo, LayoutSemanticName, LayoutSiderConfig, LayoutSiderEmits, LayoutSiderEmitsProps, LayoutSiderProps, LayoutSiderSlotProps, LayoutSiderSlots, LayoutStylesType, LayoutTabsConfig, LayoutTabsController, LayoutTabsEmits, LayoutTabsEmitsProps, LayoutTabsProps, LayoutTabsSlots, LayoutTabsUpdateOp, MenuClassNamesType, MenuClickInfo, type MenuProps, MenuRenderItem, MenuSelectInfo, MenuSemanticName, MenuStylesType, Meta, PAGE_CONTAINER_SLOT_KEYS, PageContainerCard, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, type SiderProps, type SpinProps, type Tab, TabsMeta, type TabsProps, type WatermarkProps };