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

package/dist/index.js

@@ -1,24 +1,15 @@
-import { defaultContextKey, provideProLayoutContext, useProLayoutContext } from "./Context/index.js";
-import GlobalFooter_default from "./components/GlobalFooter/index.js";
-import { useProLayoutMenuContext } from "./hooks/menu/context.js";
-import { clearMenuItem, filterTree, flatMap, getLastPath, getMatchedList, getMenuData, getMenuFirstChildren, getParentKeys, handlePathKey } from "./utils/menu.js";
-import { calculateCss, convertCSSPropertiesToString, cssValueToNumber, extractCSSVariableName, getCssVarOrUnit, getCssVarValue, getCssVariableValue, layout } from "./utils/style/index.js";
-import { removeDuplicatesByName } from "./utils/index.js";
-import { defaultSettings, getTokenLayoutTheme } from "./config/index.js";
-import { baseMenuProps } from "./components/BaseMenu/props.js";
-import BaseMenu_default, { LazyIcon } from "./components/BaseMenu/index.js";
-import { iconStyle } from "./style/index.js";
-import SiderMenu_default from "./components/SiderMenu/index.js";
-import { provideProLayoutExposeContext, useProLayoutExposeContext } from "./Context/expose.js";
-import ProLayout_default from "./ProLayout.js";
-import { useLayoutExpose } from "./hooks/layout/useLayoutExpose.js";
-import { usePageContent } from "./hooks/layout/usePageContent.js";
-import AppPage_default from "./components/AppPage/index.js";
-import PageContainer_default from "./components/PageContainer/index.js";
-import { animateSetting } from "./config/animate.js";
-import PageTranstion_default from "./components/PageTranstion/index.js";
-import menu_default from "./hooks/menu/index.js";
-import theme_default from "./hooks/theme/index.js";
-import "./types/typings.js";
-
-export { BaseMenu_default as GBaseMenu, PageTranstion_default as GPageTransition, AppPage_default as GProAppPage, ProLayout_default as GProLayout, PageContainer_default as GProPageContainer, GlobalFooter_default as GlobalFooter, LazyIcon, SiderMenu_default as SiderMenuWrapper, animateSetting, baseMenuProps, calculateCss, clearMenuItem, convertCSSPropertiesToString, cssValueToNumber, defaultContextKey, defaultSettings, extractCSSVariableName, filterTree, flatMap, getCssVarOrUnit, getCssVarValue, getCssVariableValue, getLastPath, getMatchedList, getMenuData, getMenuFirstChildren, getParentKeys, getTokenLayoutTheme, handlePathKey, iconStyle, layout, provideProLayoutContext, provideProLayoutExposeContext, removeDuplicatesByName, useLayoutExpose, menu_default as useLayoutMenu, usePageContent, useProLayoutContext, useProLayoutExposeContext, useProLayoutMenuContext, theme_default as useThemeState };
+import { useInjectLayoutContext } from "./context/index.js";
+import { PRO_MENU_SLOT_KEYS } from "./components/Menu/interface.js";
+import ProMenu from "./components/Menu/index.js";
+import InnerTabs from "./components/Tabs/InnerTabs.js";
+import { buildBreadcrumbRoutes, buildMenuLookup, cleanMenus, collectMenuNames, getLastPath, insertMenuAtPath, normalizeMenus, partitionFixedMenus, removeMenuAtPath, resolveMatchedChain, resolveRouteTarget, routesToMenus, selectMenuBranch, sortMenusByOrder, toBreadcrumbItems, updateMenuAtPath, updateMenuMetaAtPath } from "./utils/menu.js";
+import { useMenu } from "./hooks/useMenu.js";
+import { useTabs } from "./hooks/useTabs.js";
+import { APP_PAGE_SLOT_KEYS, FOOTER_TOOLBAR_SLOT_KEYS, LAYOUT_SLOT_KEYS, PAGE_CONTAINER_SLOT_KEYS } from "./interface.js";
+import GProLayout from "./ProLayout.js";
+import { useAppPageContext } from "./components/AppPage/context.js";
+import ProAppPage from "./components/AppPage/index.js";
+import GFooterToolbar from "./components/FooterToolbar/index.js";
+import ProPageContainer from "./components/PageContainer/index.js";
+import GPageTransition from "./components/PageTransition/index.js";
+export { APP_PAGE_SLOT_KEYS, FOOTER_TOOLBAR_SLOT_KEYS, GFooterToolbar, InnerTabs as GInnerTabs, GPageTransition, ProAppPage as GProAppPage, GProLayout, ProPageContainer as GProPageContainer, LAYOUT_SLOT_KEYS, PAGE_CONTAINER_SLOT_KEYS, PRO_MENU_SLOT_KEYS, ProMenu, 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

@@ -0,0 +1,516 @@
+import { LayoutBreadcrumbProps, LayoutBreadcrumbSlots } from "./components/Breadcrumb/interface.js";
+import { LayoutCollapseButtonEmits, LayoutCollapseButtonEmitsProps, LayoutCollapseButtonProps, LayoutCollapseButtonSlots } from "./components/CollapseButton/interface.js";
+import { LayoutFooterProps, LayoutFooterSlots } from "./components/Footer/interface.js";
+import { LayoutHeaderEmits, LayoutHeaderEmitsProps, LayoutHeaderProps, LayoutHeaderSlots } from "./components/Header/interface.js";
+import { LayoutLogoEmits, LayoutLogoEmitsProps, LayoutLogoProps, LayoutLogoSlots } from "./components/Logo/interface.js";
+import { PRO_MENU_SLOT_KEYS, ProMenuEmits, ProMenuEmitsProps, ProMenuProps, ProMenuSlots } from "./components/Menu/interface.js";
+import { LayoutSiderEmits, LayoutSiderEmitsProps, LayoutSiderProps, LayoutSiderSlots } from "./components/Sider/interface.js";
+import { InnerTabItem, InnerTabsEmits, InnerTabsEmitsProps, InnerTabsProps, InnerTabsSlots, LayoutTabsEmits, LayoutTabsEmitsProps, LayoutTabsProps, LayoutTabsSlots, TabGroup } from "./components/Tabs/interface.js";
+import { LayoutContentEmits, LayoutContentEmitsProps, LayoutContentProps, LayoutContentSlots } from "./components/WrapContent/interface.js";
+import { CSSProperties } from "vue";
+import { ThemeValue } from "@gx-design-vue/context";
+import { ProAliasToken } from "@gx-design-vue/pro-provider";
+import { Breakpoint, CustomRender, RecordType, SemanticClassNames, SemanticStyles, WithFalse } from "@gx-design-vue/pro-utils";
+import { BreadcrumbItemType, CardProps, MenuEmits, MenuProps, SpinProps, TabsProps, WatermarkProps } from "antdv-next";
+import { SiderProps } from "antdv-next/dist/layout";
+import { Tab } from "antdv-next/dist/tabs";
+
+//#region src/interface.d.ts
+type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T;
+/** 无 emits 组件的占位类型（避免使用 `{}` 触发 lint） */
+type EmptyEmits = Record<string, never>;
+/**
+ * antdv-next Menu 透传类型（数据驱动）。
+ * - `MenuRenderItem`：`labelRender`/`iconRender`/`extraRender` 接收的运行时 item。
+ * - `MenuSelectInfo` / `MenuClickInfo`：Menu `select` / `click` 事件载荷。
+ */
+type MenuRenderItem = Parameters<NonNullable<MenuProps['labelRender']>>[0];
+type MenuSelectInfo = Parameters<MenuEmits['select']>[0];
+type MenuClickInfo = Parameters<MenuEmits['click']>[0];
+/** 多标签页签元信息 */
+interface TabsMeta {
+  /** 是否在标签栏隐藏 */
+  hidden?: boolean;
+  /** 是否固定（不可关闭） */
+  fixed?: boolean;
+}
+/**
+ * 路由 meta —— 可见性标志收敛为两个语义正交字段：
+ * - `hideInMenu`：自身不在菜单显示
+ * - `hideChildrenInMenu`：子项不在菜单显示
+ * （旧的 `hidden` / `hideChildren` 已删除）
+ */
+interface Meta {
+  /** 名称 */
+  title?: string;
+  /** 排序 */
+  order?: number;
+  /** 菜单图标，支持 h 渲染 / VNode / string */
+  icon?: any;
+  /** 菜单项级语义样式（对齐旧 BaseMenu route.meta.styles） */
+  styles?: MenuStylesType;
+  /** 菜单项级语义类名（对齐旧 BaseMenu route.meta.classNames） */
+  classNames?: MenuClassNamesType;
+  /** 菜单项右侧内容 */
+  rightContent?: (meta: Meta) => CustomRender;
+  /** iconfont class 前缀 */
+  iconPrefix?: string;
+  /** 是否使用分隔栏 */
+  divider?: boolean;
+  /** 自身不在菜单显示 */
+  hideInMenu?: boolean;
+  /** 子项不在菜单显示 */
+  hideChildrenInMenu?: boolean;
+  /** 外链类型 0:系统内(iframe) 1:系统外(新窗口) */
+  linkStatus?: 0 | 1;
+  /** 外链地址 */
+  link?: string;
+  /** 是否禁止点击 */
+  disabled?: boolean;
+  /** 是否缓存 */
+  keepAlive?: boolean;
+  /** 是否禁用页面动画 */
+  animateDisabled?: boolean;
+  /** 左侧间距 */
+  inlineIndent?: number;
+  /** 菜单项类型 */
+  menuItemType?: 'group';
+  /** 标签页签属性 */
+  tabState?: TabsMeta;
+  /** 所属菜单 selectedKey */
+  menuSelectKey?: string;
+  /** 固定到菜单底部（仅 layout=side 生效） */
+  fixed?: boolean;
+}
+/**
+ * 菜单 / 路由项（旧 `AppRouteModule` 重命名）。
+ * `name` 唯一，作为菜单 key；`meta.title` 作为 label，`meta.icon` 作为 icon。
+ */
+interface LayoutMenuRoute {
+  /** 唯一标识（菜单 key），不可重复 */
+  name: string;
+  meta?: Meta;
+  key?: string;
+  path?: string;
+  fullPath?: string;
+  query?: RecordType;
+  params?: RecordType;
+  redirect?: string;
+  component?: any;
+  children?: LayoutMenuRoute[];
+}
+type LayoutSemanticName = 'root' | 'header' | 'sider' | 'siderChildren' | 'siderHeader' | 'siderFooter' | 'logo' | 'logoImage' | 'content' | 'footer' | 'menu' | 'tabs' | 'breadcrumb';
+type LayoutStylesType = SemanticStyles<LayoutSemanticName>;
+type LayoutClassNamesType = SemanticClassNames<LayoutSemanticName>;
+type MenuSemanticName = 'item' | 'itemTitle' | 'itemTitleText' | 'itemIcon' | 'itemRight' | 'subMenu' | 'subMenuPopup';
+type MenuStylesType = SemanticStyles<MenuSemanticName>;
+type MenuClassNamesType = SemanticClassNames<MenuSemanticName>;
+type PageContainerSemanticName = 'root' | 'header' | 'breadcrumb' | 'title' | 'extra' | 'content' | 'body' | 'card' | 'footer' | 'close';
+type PageContainerStylesType = SemanticStyles<PageContainerSemanticName>;
+type PageContainerClassNamesType = SemanticClassNames<PageContainerSemanticName>;
+type FooterToolbarSemanticName = 'root' | 'left' | 'right';
+type FooterToolbarStylesType = SemanticStyles<FooterToolbarSemanticName>;
+type FooterToolbarClassNamesType = SemanticClassNames<FooterToolbarSemanticName>;
+interface LayoutHeaderConfig {
+  /** 头部高度，默认 48 */
+  height?: number | string;
+  /** 头部是否固定，默认 true */
+  fixed?: boolean;
+  /** 滚动时自动隐藏头部 */
+  autoHide?: boolean;
+  /** 头部主内容区宽度 */
+  mainWidth?: number | string;
+}
+interface LayoutSiderConfig {
+  /** 侧边栏宽度，默认 215 */
+  width?: number | string;
+  /** 侧边栏是否固定 */
+  fixed?: boolean;
+  /** 侧边栏色彩主题 */
+  breakpoint?: Breakpoint | false;
+}
+interface LayoutCollapseConfig {
+  width?: number;
+  placement?: 'sider' | 'header';
+  icon?: GProLayoutSlots['collapse'];
+  render?: GProLayoutSlots['collapseIcon'];
+}
+interface LayoutLogoConfig {
+  /** Logo 图标/内容；string 会渲染为 img，false 不渲染 logo 图标 */
+  image?: WithFalse<CustomRender>;
+  /** Logo 标题；false 不渲染标题 */
+  title?: string;
+  /** Logo 位置渲染 */
+  render?: GProLayoutSlots['logo'];
+}
+interface LayoutFooterLink {
+  key?: string;
+  title: CustomRender;
+  href: string;
+  blank?: boolean;
+}
+interface LayoutFooterConfig {
+  /** 友情链接 */
+  links?: LayoutFooterLink[];
+  /** 版权文案（复杂内容请用 copyright slot） */
+  copyright?: string;
+}
+interface LayoutMenuConfig {
+  /** 菜单 loading */
+  loading?: boolean;
+  /** 选中后自动收起其他展开项 */
+  autoClose?: boolean;
+  /** 菜单项类型 */
+  type?: 'sub' | 'group';
+}
+interface LayoutBreadcrumbConfig {
+  /** 面包屑展示位置，默认 'header' */
+  placement?: 'header' | 'pageHeader';
+  /** 首页图标 */
+  showHome?: WithFalse<boolean>;
+  /** 首页项点击跳转路径，默认 '/' */
+  homePath?: string;
+  render?: GProLayoutSlots['breadcrumb'];
+}
+interface LayoutTabsConfig {
+  fixed?: boolean;
+  /** 标签样式 */
+  type?: 'card' | 'button' | 'google';
+  /** 是否持久化到本地存储，默认 true */
+  persistent?: boolean;
+  /** 内容全屏时隐藏标签栏 */
+  fullscreenOnHide?: boolean;
+  /** 是否开启拖拽排序（组内可拖、不跨级），默认 true */
+  draggable?: boolean;
+}
+interface LayoutPageContainerConfig {
+  /** 内容最大宽度（如 1200），设置后自动居中 */
+  contentWidth?: number | string;
+  /** 默认内容卡片设置 */
+  card?: boolean | CardProps;
+  /** 默认高度模式 */
+  height?: 'auto' | 'fit' | 'full';
+  /** 默认 footer 是否吸底 */
+  affixFooter?: boolean;
+  /** 默认 loading 设置 */
+  loading?: boolean | PageContainerLoading;
+}
+interface LayoutHeaderSlotProps {
+  collapsed: boolean;
+  isMobile: boolean;
+}
+interface LayoutSiderSlotProps {
+  collapsed: boolean;
+  isMobile: boolean;
+}
+interface LayoutBreadcrumbSlotProps {
+  items: BreadcrumbItemType[];
+  routes: LayoutMenuRoute[];
+}
+/** 菜单项渲染 slot 载荷：携带 antdv-next 运行时 item 与原始路由 */
+interface LayoutMenuItemSlotProps {
+  item: MenuRenderItem;
+  route: LayoutMenuRoute;
+}
+/** menu 选中语义载荷（区别于仅回传 keys 的 update:selectedKeys） */
+interface LayoutSelectInfo {
+  key: string;
+  keys: string[];
+  keyPath: string[];
+  route: LayoutMenuRoute;
+}
+interface GProLayoutEmits {
+  'update:collapsed': (collapsed: boolean) => void;
+  'update:theme': (theme: ThemeValue) => void;
+  'update:selectedKeys': (keys: string[]) => void;
+  'update:openKeys': (keys: string[]) => void;
+  'select': (info: LayoutSelectInfo) => void;
+  'openChange': (keys: string[]) => void;
+  'darkChange': (dark: boolean) => void;
+  'logoClick': () => void;
+  'reloadPage': () => void;
+  'tabsChange': (tabs: LayoutMenuRoute[]) => void;
+  'contentFullscreenChange': (fullscreen: boolean) => void;
+}
+interface GProLayoutEmitsProps {
+  'onUpdate:collapsed'?: GProLayoutEmits['update:collapsed'];
+  'onUpdate:theme'?: GProLayoutEmits['update:theme'];
+  'onUpdate:selectedKeys'?: GProLayoutEmits['update:selectedKeys'];
+  'onUpdate:openKeys'?: GProLayoutEmits['update:openKeys'];
+  onSelect?: GProLayoutEmits['select'];
+  onOpenChange?: GProLayoutEmits['openChange'];
+  onDarkChange?: GProLayoutEmits['darkChange'];
+  onLogoClick?: GProLayoutEmits['logoClick'];
+  onReloadPage?: GProLayoutEmits['reloadPage'];
+  onTabsChange?: GProLayoutEmits['tabsChange'];
+  onContentFullscreenChange?: GProLayoutEmits['contentFullscreenChange'];
+}
+interface GProLayoutProps extends GProLayoutEmitsProps {
+  /** 布局模式，默认 'side' */
+  layout?: 'side' | 'top' | 'mix' | 'wide' | 'simple';
+  /** 主色，需要配合 umi 使用 */
+  colorPrimary?: string;
+  /** 菜单 / 路由数据（旧 route） */
+  menus?: LayoutMenuRoute[];
+  /** 无壳模式：不渲染 header/sider/footer */
+  pure?: boolean;
+  /** 全局 loading */
+  loading?: boolean;
+  /** v-model:collapsed 侧边栏折叠 */
+  collapsed?: boolean;
+  /** v-model:theme 应用级主题（暗色） */
+  theme?: ThemeValue;
+  /** v-model:selectedKeys 选中菜单 */
+  selectedKeys?: string[];
+  /** v-model:openKeys 展开菜单 */
+  openKeys?: string[];
+  token?: DeepPartial<ProAliasToken>;
+  proStyles?: LayoutStylesType;
+  proClasses?: LayoutClassNamesType;
+  watermark?: WatermarkProps;
+  header?: LayoutHeaderConfig;
+  sider?: LayoutSiderConfig;
+  footerConfig?: LayoutFooterConfig | false;
+  menu?: LayoutMenuConfig;
+  /** 面包屑配置 */
+  breadcrumb?: LayoutBreadcrumbConfig | false;
+  /** 多标签配置；false 关闭标签栏。标签数据由组件内部管理，通过 expose.tabs 控制、tabsChange 通知 */
+  tabsConfig?: LayoutTabsConfig | false;
+  /** Logo 组件配置；false 不渲染默认 Logo 区域 */
+  logo?: LayoutLogoConfig | false;
+  collapse?: LayoutCollapseConfig | false;
+  /** PageContainer 全局默认配置 */
+  pageContainer?: LayoutPageContainerConfig;
+  /** 头部主内容（等价 #headerContent slot） */
+  headerContent?: (slotProps: LayoutHeaderSlotProps) => CustomRender;
+  /** 头部右侧（等价 #headerRight slot） */
+  headerRight?: (slotProps: LayoutHeaderSlotProps) => CustomRender;
+  /** 头部右侧附加（等价 #headerRightExtra slot） */
+  headerRightExtra?: WithFalse<CustomRender>;
+  /** 侧边菜单头部（等价 #siderHeader slot） */
+  siderHeader?: (slotProps: LayoutSiderSlotProps) => CustomRender;
+  /** 侧边菜单底部（等价 #menuFooter slot） */
+  siderFooter?: (slotProps: LayoutSiderSlotProps) => CustomRender;
+  /** 侧边菜单额外内容（等价 #menuExtra slot） */
+  siderExtra?: WithFalse<CustomRender>;
+  collapseButton?: (slotProps: {
+    collapsed: boolean;
+  }) => CustomRender;
+  /** 菜单项图标（等价 #menuItemIcon slot） */
+  menuItemIcon?: (slotProps: LayoutMenuItemSlotProps) => CustomRender;
+  /** 菜单项文本（等价 #menuItemLabel slot） */
+  menuItemLabel?: (slotProps: LayoutMenuItemSlotProps) => CustomRender;
+  /** 菜单项额外内容（等价 #menuItemExtra slot） */
+  menuItemExtra?: (slotProps: LayoutMenuItemSlotProps) => CustomRender;
+  /** 标签项（等价 #tabBarItem slot） */
+  tabBarItem?: (slotProps: {
+    route: LayoutMenuRoute;
+  }) => CustomRender;
+  /** 页脚（等价 #footer slot） */
+  footer?: WithFalse<CustomRender>;
+  /** 版权（等价 #copyright slot） */
+  copyright?: WithFalse<CustomRender>;
+}
+/**
+ * GProLayout 的 slot key 列表（不含 `default`）。
+ * 供 `getSlotsProps` 一次性合并「prop > slot」并统一下发子组件。
+ */
+declare const LAYOUT_SLOT_KEYS: readonly ["headerContent", "headerRight", "headerRightExtra", "siderHeader", "siderFooter", "siderExtra", "menuItemIcon", "menuItemLabel", "menuItemExtra", "tabBarItem", "footer", "copyright"];
+interface GProLayoutSlots {
+  default?: () => any;
+  logo?: (props: {
+    collapsed: boolean;
+    title?: string;
+  }) => any;
+  headerContent?: (props: LayoutHeaderSlotProps) => any;
+  headerRight?: (props: LayoutHeaderSlotProps) => any;
+  headerRightExtra?: () => any;
+  siderHeader?: (props: LayoutSiderSlotProps) => any;
+  siderFooter?: (props: LayoutSiderSlotProps) => any;
+  siderExtra?: () => any;
+  collapse?: (props: {
+    collapsed: boolean;
+  }) => any;
+  collapseIcon?: (props: {
+    collapsed: boolean;
+  }) => any;
+  menuItemIcon?: (props: LayoutMenuItemSlotProps) => any;
+  menuItemLabel?: (props: LayoutMenuItemSlotProps) => any;
+  menuItemExtra?: (props: LayoutMenuItemSlotProps) => any;
+  breadcrumb?: (props: LayoutBreadcrumbSlotProps) => any;
+  tabBarItem?: (props: {
+    route: LayoutMenuRoute;
+  }) => any;
+  footer?: () => any;
+  copyright?: () => any;
+}
+/** 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 {
+  /** 当前全部标签（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;
+  /** 关闭其它标签（保留目标 + 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;
+}
+interface PageContainerLoading {
+  tip?: string;
+  /** loading 时是否模糊内容 */
+  blur?: boolean;
+}
+interface GPageContainerEmits {
+  'fullscreenChange': (fullscreen: boolean) => void;
+}
+interface GPageContainerEmitsProps {
+  onFullscreenChange?: GPageContainerEmits['fullscreenChange'];
+}
+interface GPageContainerProps extends GPageContainerEmitsProps {
+  class?: string;
+  style?: CSSProperties;
+  prefixCls?: string;
+  title?: string;
+  /** loading：布尔或带 tip/blur 的配置 */
+  loading?: boolean | PageContainerLoading;
+  /**
+   * 内容高度模式：
+   * - `'auto'`（默认）：高度随内容自然撑开，不做 flex 拉伸；适合常规滚动页面
+   * - `'fit'`：容器最小高度占满父级剩余空间，内容超出时可继续撑开并触发页面滚动
+   * - `'full'`：固定占满父级剩余空间，容器自身 `overflow: hidden`；适合内部自行管理滚动的场景
+   */
+  height?: 'auto' | 'fit' | 'full';
+  /** 内容卡片：布尔或 Card 配置 */
+  card?: LayoutPageContainerConfig['card'];
+  breadcrumbConfig?: LayoutBreadcrumbConfig | false;
+  watermark?: WatermarkProps;
+  /** footer 是否吸底 */
+  affixFooter?: boolean;
+  /** 内容最大宽度，覆盖 layout 级 pageContainerConfig.contentWidth */
+  contentWidth?: number | string;
+  proStyles?: PageContainerStylesType;
+  proClasses?: PageContainerClassNamesType;
+  /** 整块页头（等价 #header slot） */
+  header?: WithFalse<CustomRender>;
+  /** 页头内容区（等价 #headerContent slot） */
+  headerContent?: WithFalse<CustomRender>;
+  /** 标题右侧操作（等价 #extra slot） */
+  extra?: WithFalse<CustomRender>;
+  /** 页脚（等价 #footer slot） */
+  footer?: WithFalse<CustomRender>;
+}
+interface GPageContainerSlots {
+  default?: () => any;
+  /** 整块页头 */
+  header?: () => any;
+  /** 页头内容区 */
+  headerContent?: () => any;
+  /** 标题右侧操作 */
+  extra?: () => any;
+  breadcrumb?: (props: LayoutBreadcrumbSlotProps) => any;
+  footer?: () => any;
+}
+/** GPageContainer 的 slot key 列表（不含 `default`），供 `getSlotsProps` 合并。 */
+declare const PAGE_CONTAINER_SLOT_KEYS: readonly ["header", "headerContent", "extra", "breadcrumb", "footer"];
+type PageContainerSlotKey = typeof PAGE_CONTAINER_SLOT_KEYS[number];
+interface GFooterToolbarProps {
+  /** teleport 目标；true → body，string → 选择器，false 不 teleport */
+  teleport?: boolean | string;
+  proStyles?: FooterToolbarStylesType;
+  proClasses?: FooterToolbarClassNamesType;
+  /** 左侧信息区（等价 #extra slot） */
+  extra?: WithFalse<CustomRender>;
+}
+interface GFooterToolbarSlots {
+  /** 右侧操作区 */
+  default?: () => any;
+  /** 左侧信息区 */
+  extra?: () => any;
+}
+/** GFooterToolbar 的 slot key 列表（不含 `default`），供 `getSlotsProps` 合并。 */
+declare const FOOTER_TOOLBAR_SLOT_KEYS: readonly ["extra"];
+type FooterToolbarSlotKey = typeof FOOTER_TOOLBAR_SLOT_KEYS[number];
+/** 应用壳全局 loading 配置 */
+interface AppPageSpinning {
+  /** 是否处于 loading 态 */
+  loading?: boolean;
+  /** loading 遮罩自定义样式 */
+  style?: CSSProperties;
+  /** 是否模糊遮罩下方内容 */
+  blur?: boolean;
+}
+interface GProAppPageProps {
+  class?: string;
+  prefixCls?: string;
+  style?: CSSProperties;
+  /** 全局 loading 配置 */
+  spinning?: AppPageSpinning;
+  /** 全局空态内容（等价 #emptyText slot） */
+  emptyText?: WithFalse<CustomRender>;
+  /** 全局加载指示器（等价 #indicator slot） */
+  indicator?: WithFalse<CustomRender>;
+}
+interface GProAppPageSlots {
+  /** 应用内容（通常为 router-view） */
+  default?: () => any;
+  /** 全局空态内容 */
+  emptyText?: () => any;
+  /** 全局加载指示器 */
+  indicator?: () => any;
+}
+/** GProAppPage 的 slot key 列表（不含 `default`），供 `getSlotsProps` 合并。 */
+declare const APP_PAGE_SLOT_KEYS: readonly ["emptyText", "indicator"];
+type AppPageSlotKey = typeof APP_PAGE_SLOT_KEYS[number];
+interface GPageTransitionProps {
+  /** 禁用动画，直接渲染子节点 */
+  disabled?: boolean;
+  /** 离场时是否反转方向（让动画「倒放」），默认 true */
+  reverse?: boolean;
+  /** 动画名，默认 'fade'（back/bounce/fade/flip/lightSpeed/rotate/roll/zoom/slide） */
+  name?: string;
+  /** 方向变体；未指定则取该预设首个方向 */
+  direction?: string;
+}
+interface GPageTransitionSlots {
+  /** 需要做切换动画的内容（通常为 router-view 单节点） */
+  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, InnerTabItem, InnerTabsEmits, InnerTabsEmitsProps, InnerTabsProps, InnerTabsSlots, 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, LayoutMenuItemSlotProps, LayoutMenuRoute, 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, PRO_MENU_SLOT_KEYS, PageContainerClassNamesType, PageContainerLoading, PageContainerSemanticName, PageContainerSlotKey, PageContainerStylesType, ProMenuEmits, ProMenuEmitsProps, ProMenuProps, ProMenuSlots, type SiderProps, type SpinProps, type Tab, TabGroup, TabsMeta, type TabsProps, type WatermarkProps };

package/dist/interface.js

@@ -0,0 +1,34 @@
+import { PRO_MENU_SLOT_KEYS } from "./components/Menu/interface.js";
+//#region src/interface.ts
+/**
+* GProLayout 的 slot key 列表（不含 `default`）。
+* 供 `getSlotsProps` 一次性合并「prop > slot」并统一下发子组件。
+*/
+const LAYOUT_SLOT_KEYS = [
+	"headerContent",
+	"headerRight",
+	"headerRightExtra",
+	"siderHeader",
+	"siderFooter",
+	"siderExtra",
+	"menuItemIcon",
+	"menuItemLabel",
+	"menuItemExtra",
+	"tabBarItem",
+	"footer",
+	"copyright"
+];
+/** GPageContainer 的 slot key 列表（不含 `default`），供 `getSlotsProps` 合并。 */
+const PAGE_CONTAINER_SLOT_KEYS = [
+	"header",
+	"headerContent",
+	"extra",
+	"breadcrumb",
+	"footer"
+];
+/** GFooterToolbar 的 slot key 列表（不含 `default`），供 `getSlotsProps` 合并。 */
+const FOOTER_TOOLBAR_SLOT_KEYS = ["extra"];
+/** GProAppPage 的 slot key 列表（不含 `default`），供 `getSlotsProps` 合并。 */
+const APP_PAGE_SLOT_KEYS = ["emptyText", "indicator"];
+//#endregion
+export { APP_PAGE_SLOT_KEYS, FOOTER_TOOLBAR_SLOT_KEYS, LAYOUT_SLOT_KEYS, PAGE_CONTAINER_SLOT_KEYS, PRO_MENU_SLOT_KEYS };