@done-coding/admin-core 0.29.0 → 0.29.1-alpha.0

package/src/components/view-layout/README.md

@@ -1,10 +1,10 @@
 # view-layout 展示布局族
 
-展示空间布局壳：`ViewLayout` 消费 `props.api`（内部 `useActivated` 激活拉取）+ toolbar 对齐 `TableToolbar`（左/右 `ActionBtnGroup` extra 按钮 + 右侧 `AutoRefreshGroup` 自动刷新 / 手动刷新）+ 默认插槽自由内容。
+展示空间布局壳：`ViewLayout` 消费 `props.api`（内部 `useActivated` 激活拉取）+ toolbar 对齐 `TableToolbar`（左/右 `ActionBtnGroup` extra 按钮 + 右侧 `AutoRefreshGroup` 自动刷新 / 手动刷新）+ 默认插槽自由内容 + `#bottom` 底部区（refine 固定在底 / 自然流平铺在后）。
 
 ## 组件文档（docs/）
 
-- [ViewLayout](./docs/README-ViewLayout.md) — 展示布局（api 拉取 + 自动刷新 + 自由内容插槽）
+- [ViewLayout](./docs/README-ViewLayout.md) — 展示布局（api 拉取 + 自动刷新 + 自由内容插槽 + `#bottom` 底部区）
 
 ## 范式页（apps/reference）
 

package/src/components/view-layout/docs/README-ViewLayout.md

@@ -1,6 +1,6 @@
 # ViewLayout（展示布局）
 
-> 展示空间布局壳：`props.api` 数据拉取（内部 `useActivated` 激活拉取）+ toolbar 对齐 `TableToolbar`（左/右 `ActionBtnGroup` extra 按钮 + 右侧 `AutoRefreshGroup` 自动刷新 / 手动刷新）+ 默认插槽自由内容 + 精细流高度链（refine 上下文默认：AppPage#default / TabsMain 页签内容内开）。
+> 展示空间布局壳：`props.api` 数据拉取（内部 `useActivated` 激活拉取）+ toolbar 对齐 `TableToolbar`（左/右 `ActionBtnGroup` extra 按钮 + 右侧 `AutoRefreshGroup` 自动刷新 / 手动刷新）+ 默认插槽自由内容 + `#bottom` 底部区 + 精细流高度链（refine 上下文默认：AppPage#default / TabsMain 页签内容内开）。
 > 范式页：`apps/reference/src/pages/view-layout/guide/`
 
 ## 定位
@@ -8,7 +8,7 @@
 - **空间一等公民**：展示空间布局首选（页级数据展示的布局壳）——承接 PanelMain 废弃的页级展示场景
 - **何时用**：页级数据展示（详情 / 预览 / 摘要展示）——api 拉数 + 自动刷新 + 内容自由编排
 - **何时不用**：结构化详情字段面板用 `PanelMain`（仅表单预览 / 就地编辑保留场景）；列表用 `ListLayout`
-- 内部组合：`ActionBtnGroup`（左/右 extra 按钮，`default-size="small"` 对齐 table-toolbar 视觉惯例）+ `AutoRefreshGroup`（右侧，refreshFn=api 拉取，经 `HeightProvider` #header 槽 WatchSize 量高）+ 默认插槽（`{ data, loading, refresh, viewportHeight, fetchSeq }` 注入）
+- 内部组合：`ActionBtnGroup`（左/右 extra 按钮，`default-size="small"` 对齐 table-toolbar 视觉惯例）+ `AutoRefreshGroup`（右侧，refreshFn=api 拉取，toolbar 经 `HeightProvider` #header 槽 WatchSize 量高）+ 默认插槽（`{ data, loading, refresh, viewportHeight, fetchSeq }` 注入）+ `#bottom` 底部区（精细流进 `HeightProvider` #footer 槽，同样量高扣减）
 
 ## 快速上手（最小可用）
 
@@ -29,7 +29,7 @@
 - 激活即拉取：首访 mounted / KeepAlive 重新激活自动拉取，失活不拉（数据保留）
 - 右上角 AutoRefreshGroup 自动接管刷新按钮 / 自动刷新开关（`showAutoRefresh` / `showRefresh` 控制显隐）
 - toolbar 对齐 `TableToolbar` 结构：`leftExtraButtons` / `rightExtraButtons`（`ActionBtnGroup` 配置，`default-size="small"`）左右分栏；不含表格特有能力（导出 / 批量下载 / 视图切换）
-- **refine 上下文默认**：置于 AppPage `#default` / TabsMain 页签内容内默认开（精细流）——内容区可用高 = 视口高 − toolbar 高（`scope.viewportHeight` + 容器 max-height 双出口）——超高内滚；其余容器 / 独立使用回落自然流（按自身尺寸）
+- **refine 上下文默认**：置于 AppPage `#default` / TabsMain 页签内容内默认开（精细流）——内容区可用高 = 视口高 − toolbar 高 − `#bottom` 高 − 内容区自身纵向 padding（`scope.viewportHeight` + 容器 max-height 双出口）——超高内滚；其余容器 / 独立使用回落自然流（按自身尺寸）
 
 ## 能力边界 / 按需使用
 
@@ -39,6 +39,7 @@
 - `params`：仅当 api 需要拉取参数时传；⚠️ **响应式变化不自动重拉**（需要时调 `scope.refresh()`）。
 - `showAutoRefresh` / `showRefresh`：仅当不需要自动刷新或手动刷新时关。
 - `leftExtraButtons` / `rightExtraButtons`：仅当 toolbar 需要业务操作按钮时配——配置为 `ActionBtnGroup` 单项（`key` / `label` / `actionBtnProps` / `render` / `show`），ctx 注入 `{ loading, refresh }`（刷新与右上角同源）；按钮默认 `size="small"` 对齐 table-toolbar。
+- **`#bottom`（底部区）：不传即完全不存在。** 传了才渲染（[MUST NOT] 传空 `<template>` 占位）——精细流下它**固定在底部、不随内容滚**，自然流下**平铺在内容之后**。典型用途：合计行 / 固定操作条 / 状态摘要。
 - **插槽内容自由编排**：纯展示 [MUST NOT] 套 PanelMain 作页级根（已废弃场景）；需要结构化字段面板时在插槽内用 PanelMain，自由内容直接写。
 - **完整能力演示**：`apps/reference/src/pages/view-layout/guide/`——能力展示，非推荐默认。
 
@@ -80,10 +81,93 @@
 
 **toolbar 是「条」(bar) 不是「卡」(card)**（甲方 2026-09-16 定性）：底色取「面与底的中点」
 （`color-mix(in srgb, --dc-core-surface 50%, --dc-core-ground)`，亮暗自动跟随），
-但守三条纪律 —— **贴边**（零左右呼吸，否则按钮与下方内容区左边界错位，而内容区的面由
-消费方自持、padding 不受本组件控制）· **通栏**（零圆角）· **不加高**（只留既有的 8px 下呼吸）。
+但守两条纪律 —— **通栏**（零圆角）· **不加高**（零上下呼吸）。
 此前「工具条成卡」被否的根因不是「有面」，而是面顺带塞进 12px 内呼吸把 32px 的条撑到 56px。
 
+横向呼吸**左右不对称**：左 **两份**、右 **一份** —— 左缘那条 3px 主色条已经占住了第一层留白，
+不补第二份的话文字读起来像贴着色条（实测只剩 5px）。
+
+🔴 **左缘那两份是 toolbar 与内容区\*\*共用\*\*的一个值**（源码 `padLeftPx`），[MUST NOT] 只给 toolbar 加倍：
+色条标识的是**整个组件的左缘**、不是 toolbar 一个人的，只给它加倍会让**标题比正文右移一份**
+（实测错开 8px，甲方 2026-09-17 排查色条内外侧时撞出）。标题与正文左对齐是排版底线，
+[MUST NOT] 为装饰破坏它。内容区因此左右不对称（左两份 / 右一份），这是**有据的**：
+左缘有标识、右缘没有。
+
+## 底部区（`#bottom`）
+
+```vue
+<ViewLayout :api="api" title="订单详情">
+  <template #default="{ data }">…长内容…</template>
+  <!-- refine：固定在底部，内容再长也压不到它；自然流：跟在内容之后 -->
+  <template #bottom="{ data, loading }">
+    <ElButton type="primary" :loading="loading">保存</ElButton>
+  </template>
+</ViewLayout>
+```
+
+| 档 | 行为 |
+| --- | --- |
+| `refine` 开（精细流） | **固定在底部** —— 进 `HeightProvider` 的 `#footer` 槽，经 `WatchSize` 量高并从内容区可用高里扣掉，内容再长也不滚走。要它**贴容器底**（内容稀疏时也不浮在半空）再开 `fillHeight`（见下） |
+| `refine` 关（自然流） | **平铺在底部** —— 跟在内容之后按自身尺寸排布，无固定定位 |
+
+- scope：`{ data, loading, fetchSeq }`（底部区常要跟着详情数据走，而这三者都在 setup 里取不到）。
+  比 `#header` 多一个 `fetchSeq` —— 底部区是**放操作条**的地方，提交后常要判「详情真的重拉成功了」
+  （失败不递增，[MUST NOT] 用 `loading` 的 `true→false` 代替）；也让
+  `AppPageListDetailLayout` 的 `#detailBottom` 能原样复用 `#detail` 那份 scope、
+  [MUST NOT] 为凑类型编一个恒 0 的假值。
+- **不传 = 不渲染**：[MUST NOT] 留空盒——那会白占一段 reserve（精细流下内容区凭空少一截）。
+- 🔴 **随内容滚的尾部内容 [MUST NOT] 放这里**：凡进 `#bottom` 的都从可用高里扣。要跟着滚就写在默认插槽末尾。
+- 本槽**不自带面 / 不自带呼吸**：它与内容区之间的间隔由内容区自己的下 padding 给出（见下），装什么面由使用方决定。
+- **自然流下它只是「排在内容之后」**，没有底可贴（那一档本就没有高度预算）。
+
+## 间距归属（谁给的呼吸）
+
+| 段 | 归属 | 值 |
+| --- | --- | --- |
+| toolbar ↔ 内容 | **内容区的上 padding** | 一份 |
+| 内容区上 / 下 / 右 | 内容区自己的 padding（`box-sizing: border-box`） | 一份 |
+| **组件左缘**（toolbar 与内容区**共用**一个值 `padLeftPx`） | 两者各自的左 padding | **两份**（色条占了第一层） |
+| toolbar 右侧 | toolbar 的右 padding | 一份 |
+
+「一份」= 间距阶梯的**模块档**（`APP_LAYOUT_GAP_CONFIG.size` × 密度系数 × 1，默认 **8px**），
+随 `bridge.APP_LAYOUT_GAP_CONFIG.size` 与主题密度档自动缩放，[MUST NOT] 在消费侧写死像素补偿。
+
+🔴 **为什么间隔一律做成「各自盒内的 padding」，[MUST NOT] 用根的 flex `gap` / `margin`**：
+精细流的 reserve 是量 toolbar 的 `clientHeight` 得出的，而 `gap` 跨在两个盒**之间**、
+`margin` 会穿透父盒 —— 两者都不计入 `clientHeight`，量不到 ⇒ **每页恒溢出一段**
+（实测 846 的可用高被占到 854，甲方报障过）。
+
+⚠️ 内容区的纵向 padding **在喂给 `HeightProvider` 之前就先扣掉了**，故 `scope.viewportHeight`
+与向后代 provide 的可用高**恒等于内容盒真正的内高**——嵌套 `ListLayout` / `TabsMain` 直接吃它即可，
+[MUST NOT] 再自行减一遍 padding（那是双扣）。
+
+## `fillHeight` —— 让 `#bottom` 贴容器底（opt-in）
+
+内容盒默认只有 **`max-height` 上限**：内容多短盒子就多矮，于是内容稀疏时 `#bottom` 会
+**跟在内容屁股后面浮在半空**（它没滚走，只是没贴底）。开 `fillHeight` 额外补一条同值
+`min-height` ⇒ 上下界重合 = 定高，底边恒落在预算下沿（抽屉里就是抽屉底、页面里就是内容视口底）。
+
+```vue
+<!-- 详情页底部要钉一条提交栏 -->
+<ViewLayout :api="api" fill-height>
+  <template #default>…可能很短的内容…</template>
+  <template #bottom><ElButton type="primary">提交</ElButton></template>
+</ViewLayout>
+```
+
+| | 内容短 | 内容长 |
+| --- | --- | --- |
+| 默认（关） | 盒子矮，`#bottom` 跟在内容后 | 盒内滚，`#bottom` 停在预算下沿 |
+| `fillHeight` 开 | **盒子占满预算，`#bottom` 贴底** | 同左（长内容下两者无差别） |
+
+- **默认关，且 [MUST] 保持 opt-in**：定高的一体两面是「内容短时盒内留白」。
+  [MUST NOT] 改成默认开、更 [MUST NOT] 把 `max-height` 直接换成 `height` ——
+  那会让**所有** refine 页面一起定高（甲方 2026-09-17：不应波及其他 refine 页面）。
+- 仅 `refine=true` 有意义；自然流没有高度预算，本 prop 无声忽略。
+- 同名同义于 `TableMain.fillHeight`（那边是让分页器被顶到容器底），两处认同一套心智。
+- `AppPageListDetailLayout` 的 `#detailBottom` **自动开**（用了那个槽就是要贴底），
+  仍可经 `viewLayoutProps.fillHeight` 关掉。
+
 ## API
 > ⚠️ API 以 types.ts 与组件源码为真相源；与文档冲突时以源码为准。
 
@@ -99,6 +183,7 @@
 | `channel` | `string?` | — | 作为父时的 scope 标识。⚠️ 与 parentChannel 均 [MUST NOT] 响应式变更（setup 期快照）；且仅 refine=true 路径生效 |
 | `parentChannel` | `string?` | — | 作为子时定向消费的祖先 scope 标识（沿对象链 parent 找匹配） |
 | `minHeight` | `number?` | `100` | 内容区可用高兜底下限（对齐 ListLayout/TabsMain 惯例） |
+| `fillHeight` | `boolean?` | `false` | 内容盒撑满可用高（额外补同值 `min-height` = 定高）。用途 = 让 `#bottom` **贴容器底**；仅 `refine` 下有意义。同名同义于 `TableMain.fillHeight` |
 | `showAutoRefresh` | `boolean?` | `true` | 是否显示自动刷新开关（透传 AutoRefreshGroup） |
 | `showRefresh` | `boolean?` | `true` | 是否显示手动刷新按钮（透传 AutoRefreshGroup） |
 | `showNavigation` | `boolean?` | `true` | 是否显示内置「上一条 / 下一条」导航。⚠️ **真正的显隐判据是可选 inject 探测**：只有置于 `AppPageListDetailLayout` 内才渲染，单独使用 ViewLayout 时无论本值为何都不渲染（老用法零变化）；本 prop 用于在门面内显式关掉 |
@@ -109,7 +194,9 @@
 
 | 槽 | scope | 语义 |
 | --- | --- | --- |
-| 默认 | `{ data, loading, refresh, viewportHeight, fetchSeq }`（`ViewLayoutScope<R>`） | 展示内容；PanelMain 或自由编排皆可；viewportHeight refine 时给可用高、自然流 undefined；`fetchSeq` = **成功**拉取次数（失败不递增），供下游懒加载块判「该重拉了」 |
+| 默认 | `{ data, loading, refresh, viewportHeight, fetchSeq }`（`ViewLayoutScope<R>`） | 展示内容；PanelMain 或自由编排皆可；viewportHeight refine 时给可用高（**已扣内容区自身 padding**）、自然流 undefined；`fetchSeq` = **成功**拉取次数（失败不递增），供下游懒加载块判「该重拉了」 |
+| `#header` | `{ data, loading }` | 标题行（见上「标题行」段）；不传且无 `title` 时不渲染 |
+| `#bottom` | `{ data, loading, fetchSeq }` | 底部区：refine 固定在底部（计入 reserve）/ 自然流平铺在内容之后；不传不渲染。比 `#header` 多 `fetchSeq`（本槽放操作条，提交后要判「真的重拉成功了」） |
 
 ### 内置上/下一条导航（仅列表详情范式内出现）
 
@@ -133,6 +220,10 @@
 - **要重拉不要改 `params` 指望它自动生效**：`params` 响应式变化**刻意**不重拉（防请求风暴的既有设计）。「换了参数要重拉」= 改 `params` **并**动 `refreshToken`（或调 `scope.refresh()`）
 - **[MUST NOT] 把触发值塞进 `params` 当刷新开关**：那会把纯前端的令牌发给后端、污染 API 契约——这正是 `refreshToken` 独立成 prop 的原因
 - **[MUST NOT] 用 `:key="token"` 重建来实现重拉**：会连 toolbar / 按钮一起重建，连续切换时闪烁，且语义错位（chrome 不该随内容重建）——用 `refreshToken`
+- **把随内容滚的东西塞进 `#bottom`**：[MUST NOT]——它是固定区，凡进此槽的都从内容可用高里扣
+- **指望 `#bottom` 默认就贴容器底**：默认不贴（内容盒只有上限、不定高）——要贴底开 `fillHeight`
+- **为了贴底把 `max-height` 改写成 `height`**：[MUST NOT]——那波及所有 refine 页面，是本 prop 存在的理由掉
+- **在消费侧写死像素补偿 toolbar / 内容区的间距**：[MUST NOT]——间距由 gap 阶梯派生，写死会在改 `gap` / 换密度档时脱钩
 - **toolbar 不含表格能力全集**：对齐的是 table-toolbar 的**结构与视觉惯例**（左右分栏 + extra 按钮 + AutoRefreshGroup），[MUST NOT] 期待导出 / 批量下载 / 视图切换等表格特有能力出现在 ViewLayout——需要表格能力用 `ListLayout` / `TableMain`
 
 ## 关联

package/types/bridge/badge.d.ts

@@ -104,6 +104,8 @@ export type BadgeEntry = {
     kind: "beta";
 } | {
     kind: "wip";
+} | {
+    kind: "planned";
 } | {
     kind: "deprecated";
 } | {
@@ -134,7 +136,7 @@ export type BadgeEntry = {
     type?: BadgeProps["type"];
 });
 /** 内置标（非 count / custom）的 kind 联合——文案与语义色由 core 统一定，保证跨 app 一致 */
-export type BadgeBuiltinKind = "new" | "updated" | "beta" | "wip" | "deprecated" | "locked";
+export type BadgeBuiltinKind = "new" | "updated" | "beta" | "wip" | "planned" | "deprecated" | "locked";
 /**
  * 会遮挡宿主交互的 kind——[MUST] 与 `use-badge-mask` 的判据同源，[MUST NOT] 两处各写一份。
  *

package/types/bridge/layout.d.ts

@@ -33,6 +33,24 @@ export interface BridgeLayoutInit {
     /** aside 折叠初值（业务侧无缓存默认）；缺省 false */
     defaultAsideCollapsed?: boolean;
 }
+/**
+ * 侧栏菜单控制器 —— 由 `AppSidebar` 在挂载时注册进来的**接缝**。
+ *
+ * 🔴 bridge 是**纯状态**层、拿不到菜单组件实例，而「展开到某路径」必须调 `ElMenu.open()`。
+ * 故由持有实例的那一层注册能力进来，bridge 只做编排（同「auth facade 由 app 注册钩子」范式）。
+ * [MUST NOT] 反过来让 bridge 去 querySelector 菜单 DOM —— 那会把结构写死进状态层。
+ */
+export interface CoreLayoutMenuController {
+    /** 展开一级子菜单（ElMenu 的 index = 路由 path） */
+    open: (index: string) => void;
+    /**
+     * 解析目标 path 的**沿途父级 path 链**（自顶向下）。
+     * path 不在菜单里 → `undefined`（与「在菜单里但没有父级」的空数组区分开）。
+     */
+    resolveAncestors: (path: string) => string[] | undefined;
+    /** 是否分组形态（`menuGroupMode`）——该形态父级是 section heading、本就全展开 */
+    isGroupMode: () => boolean;
+}
 /**
  * 布局折叠模块（bridge 公开面 `bridge.layout`）。
  *
@@ -52,14 +70,33 @@ export interface CoreLayoutModule {
     setAsideCollapse: (collapsed: boolean) => void;
     /** 反转 aside 折叠态 */
     toggleAside: () => void;
+    /**
+     * 把目标路径**沿途的父级子菜单全部展开**，返回是否成功。
+     *
+     * 缘起：引导要高亮折叠子菜单里的项 —— 那种元素虽在 DOM 里但 `display:none`、rect 全 0，
+     * 引导只能跳过。判据是目标项 `getClientRects().length > 0`，[MUST NOT] 拿「没报错」当成功。
+     *
+     * 三种形态：
+     * - 常规树形 → 逐级 `open()` 沿途父级 → `true`；
+     * - 分组形态（`menuGroupMode`）→ 父级本就全展开 ⇒ **no-op 返回 `true`**；
+     * - **侧栏折叠态 → 先展开侧栏**（`setSidebarCollapse(false)`）再展开父级 → `true`。
+     *
+     * 🔴 折叠态自动展开侧栏是**甲方 2026-09-18 的裁决**，且**事后不还原**：折叠态是持久化到
+     * localStorage 的用户偏好，本方法等于程序化改写它 —— 依据是「引导是用户主动发起的流程，
+     * 为让他看见而展开属正当副作用」。[MUST NOT] 改成「展开后自动还原」：还原时机不可靠
+     * （引导弹窗还开着就还原会当场收起菜单），异常路径 / 快速切路由会让状态泄漏。
+     *
+     * 路径不存在 / 侧栏未注册（无侧栏）→ `false`，且**不动任何状态**。
+     */
+    openMenuTo: (path: string) => boolean;
+    /**
+     * 注册 / 注销侧栏菜单控制器（**内部接缝**，由 `AppSidebar` 调用）。
+     * 业务 [MUST NOT] 直接调它 —— 注册两份会让后注册的覆盖前一份。
+     */
+    registerMenuController: (controller: CoreLayoutMenuController | null) => void;
 }
 /** bridge 布局折叠 hook 工厂返回（聚合到 `bridge.layout`）。 */
 export interface BridgeLayoutHook {
     layout: CoreLayoutModule;
 }
-/**
- * bridge 布局折叠 hook 工厂。
- *
- * init：读持久化恢复 sidebar / aside 折叠态（无持久化值 → 回落初值）。
- */
 export declare function createBridgeLayoutHook(init: BridgeLayoutInit): BridgeLayoutHook;

package/types/components/app-layout/AppSidebar.vue.d.ts

@@ -13,13 +13,297 @@ declare function __VLS_template(): {
         top?(_: {}): any;
         bottom?(_: {}): any;
     };
-    refs: {};
+    refs: {
+        menuTreeRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+            menus: RouteMetaResolveRaw[];
+            menuFlatList: RouteMetaResolveRaw[];
+            routerMode?: boolean;
+            collapse?: boolean;
+            autoClose?: boolean;
+            groupMode?: boolean;
+        }> & Readonly<{}>, {
+            open: (index: string) => void | undefined;
+            close: (index: string) => void | undefined;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+            elMenu: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+                readonly mode: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "horizontal" | "vertical", unknown, "vertical", boolean>;
+                readonly defaultActive: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
+                readonly defaultOpeneds: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string[]) | (() => string[]) | (((new (...args: any[]) => string[]) | (() => string[])) | null)[], unknown, unknown, () => [], boolean>;
+                readonly uniqueOpened: BooleanConstructor;
+                readonly router: BooleanConstructor;
+                readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "click" | "hover", unknown, "hover", boolean>;
+                readonly collapse: BooleanConstructor;
+                readonly backgroundColor: StringConstructor;
+                readonly textColor: StringConstructor;
+                readonly activeTextColor: StringConstructor;
+                readonly closeOnClickOutside: BooleanConstructor;
+                readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+                readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+                readonly popperOffset: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
+                readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
+                readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown, "dark", boolean>;
+                readonly popperClass: StringConstructor;
+                readonly popperStyle: {
+                    readonly type: import('vue').PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
+                    readonly required: false;
+                    readonly validator: ((val: unknown) => boolean) | undefined;
+                    __epPropKey: true;
+                };
+                readonly showTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+                readonly hideTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+                readonly persistent: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+            }>> & Readonly<{
+                onClose?: ((index: string, indexPath: string[]) => any) | undefined;
+                onSelect?: ((index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure> | undefined) => any) | undefined;
+                onOpen?: ((index: string, indexPath: string[]) => any) | undefined;
+            }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                [key: string]: any;
+            }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+                close: (index: string, indexPath: string[]) => boolean;
+                open: (index: string, indexPath: string[]) => boolean;
+                select: (index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure>) => boolean;
+            }, import('vue').PublicProps, {
+                readonly collapse: boolean;
+                readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+                readonly persistent: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+                readonly mode: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "horizontal" | "vertical", unknown>;
+                readonly showTimeout: number;
+                readonly hideTimeout: number;
+                readonly defaultActive: string;
+                readonly defaultOpeneds: string[];
+                readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "click" | "hover", unknown>;
+                readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+                readonly popperOffset: number;
+                readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown>;
+                readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown>;
+                readonly uniqueOpened: boolean;
+                readonly router: boolean;
+                readonly closeOnClickOutside: boolean;
+            }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+                P: {};
+                B: {};
+                D: {};
+                C: {};
+                M: {};
+                Defaults: {};
+            }, Readonly<import('vue').ExtractPropTypes<{
+                readonly mode: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "horizontal" | "vertical", unknown, "vertical", boolean>;
+                readonly defaultActive: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
+                readonly defaultOpeneds: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string[]) | (() => string[]) | (((new (...args: any[]) => string[]) | (() => string[])) | null)[], unknown, unknown, () => [], boolean>;
+                readonly uniqueOpened: BooleanConstructor;
+                readonly router: BooleanConstructor;
+                readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "click" | "hover", unknown, "hover", boolean>;
+                readonly collapse: BooleanConstructor;
+                readonly backgroundColor: StringConstructor;
+                readonly textColor: StringConstructor;
+                readonly activeTextColor: StringConstructor;
+                readonly closeOnClickOutside: BooleanConstructor;
+                readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+                readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+                readonly popperOffset: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
+                readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
+                readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown, "dark", boolean>;
+                readonly popperClass: StringConstructor;
+                readonly popperStyle: {
+                    readonly type: import('vue').PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
+                    readonly required: false;
+                    readonly validator: ((val: unknown) => boolean) | undefined;
+                    __epPropKey: true;
+                };
+                readonly showTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+                readonly hideTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+                readonly persistent: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+            }>> & Readonly<{
+                onClose?: ((index: string, indexPath: string[]) => any) | undefined;
+                onSelect?: ((index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure> | undefined) => any) | undefined;
+                onOpen?: ((index: string, indexPath: string[]) => any) | undefined;
+            }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+                [key: string]: any;
+            }>, {}, {}, {}, {
+                readonly collapse: boolean;
+                readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+                readonly persistent: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+                readonly mode: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "horizontal" | "vertical", unknown>;
+                readonly showTimeout: number;
+                readonly hideTimeout: number;
+                readonly defaultActive: string;
+                readonly defaultOpeneds: string[];
+                readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "click" | "hover", unknown>;
+                readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+                readonly popperOffset: number;
+                readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown>;
+                readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown>;
+                readonly uniqueOpened: boolean;
+                readonly router: boolean;
+                readonly closeOnClickOutside: boolean;
+            }> | null;
+        }, any, import('vue').ComponentProvideOptions, {
+            P: {};
+            B: {};
+            D: {};
+            C: {};
+            M: {};
+            Defaults: {};
+        }, Readonly<{
+            menus: RouteMetaResolveRaw[];
+            menuFlatList: RouteMetaResolveRaw[];
+            routerMode?: boolean;
+            collapse?: boolean;
+            autoClose?: boolean;
+            groupMode?: boolean;
+        }> & Readonly<{}>, {
+            open: (index: string) => void | undefined;
+            close: (index: string) => void | undefined;
+        }, {}, {}, {}, {}> | null;
+    };
     rootEl: HTMLDivElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     aboveHeader: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    menuTreeRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        menus: RouteMetaResolveRaw[];
+        menuFlatList: RouteMetaResolveRaw[];
+        routerMode?: boolean;
+        collapse?: boolean;
+        autoClose?: boolean;
+        groupMode?: boolean;
+    }> & Readonly<{}>, {
+        open: (index: string) => void | undefined;
+        close: (index: string) => void | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        elMenu: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+            readonly mode: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "horizontal" | "vertical", unknown, "vertical", boolean>;
+            readonly defaultActive: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
+            readonly defaultOpeneds: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string[]) | (() => string[]) | (((new (...args: any[]) => string[]) | (() => string[])) | null)[], unknown, unknown, () => [], boolean>;
+            readonly uniqueOpened: BooleanConstructor;
+            readonly router: BooleanConstructor;
+            readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "click" | "hover", unknown, "hover", boolean>;
+            readonly collapse: BooleanConstructor;
+            readonly backgroundColor: StringConstructor;
+            readonly textColor: StringConstructor;
+            readonly activeTextColor: StringConstructor;
+            readonly closeOnClickOutside: BooleanConstructor;
+            readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+            readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+            readonly popperOffset: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
+            readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
+            readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown, "dark", boolean>;
+            readonly popperClass: StringConstructor;
+            readonly popperStyle: {
+                readonly type: import('vue').PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
+                readonly required: false;
+                readonly validator: ((val: unknown) => boolean) | undefined;
+                __epPropKey: true;
+            };
+            readonly showTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+            readonly hideTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+            readonly persistent: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+        }>> & Readonly<{
+            onClose?: ((index: string, indexPath: string[]) => any) | undefined;
+            onSelect?: ((index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure> | undefined) => any) | undefined;
+            onOpen?: ((index: string, indexPath: string[]) => any) | undefined;
+        }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            [key: string]: any;
+        }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+            close: (index: string, indexPath: string[]) => boolean;
+            open: (index: string, indexPath: string[]) => boolean;
+            select: (index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure>) => boolean;
+        }, import('vue').PublicProps, {
+            readonly collapse: boolean;
+            readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+            readonly persistent: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+            readonly mode: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "horizontal" | "vertical", unknown>;
+            readonly showTimeout: number;
+            readonly hideTimeout: number;
+            readonly defaultActive: string;
+            readonly defaultOpeneds: string[];
+            readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "click" | "hover", unknown>;
+            readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+            readonly popperOffset: number;
+            readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown>;
+            readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown>;
+            readonly uniqueOpened: boolean;
+            readonly router: boolean;
+            readonly closeOnClickOutside: boolean;
+        }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+            P: {};
+            B: {};
+            D: {};
+            C: {};
+            M: {};
+            Defaults: {};
+        }, Readonly<import('vue').ExtractPropTypes<{
+            readonly mode: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "horizontal" | "vertical", unknown, "vertical", boolean>;
+            readonly defaultActive: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, unknown, unknown, "", boolean>;
+            readonly defaultOpeneds: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string[]) | (() => string[]) | (((new (...args: any[]) => string[]) | (() => string[])) | null)[], unknown, unknown, () => [], boolean>;
+            readonly uniqueOpened: BooleanConstructor;
+            readonly router: BooleanConstructor;
+            readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropFinalized<StringConstructor, "click" | "hover", unknown, "hover", boolean>;
+            readonly collapse: BooleanConstructor;
+            readonly backgroundColor: StringConstructor;
+            readonly textColor: StringConstructor;
+            readonly activeTextColor: StringConstructor;
+            readonly closeOnClickOutside: BooleanConstructor;
+            readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+            readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+            readonly popperOffset: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
+            readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown, () => import('vue').DefineComponent<{}, void, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, boolean>;
+            readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown, "dark", boolean>;
+            readonly popperClass: StringConstructor;
+            readonly popperStyle: {
+                readonly type: import('vue').PropType<import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties) | (((new (...args: any[]) => string | import('vue').CSSProperties) | (() => string | import('vue').CSSProperties)) | null)[], unknown, unknown>>;
+                readonly required: false;
+                readonly validator: ((val: unknown) => boolean) | undefined;
+                __epPropKey: true;
+            };
+            readonly showTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+            readonly hideTimeout: import('element-plus/es/utils/index.mjs').EpPropFinalized<NumberConstructor, unknown, unknown, 300, boolean>;
+            readonly persistent: import('element-plus/es/utils/index.mjs').EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+        }>> & Readonly<{
+            onClose?: ((index: string, indexPath: string[]) => any) | undefined;
+            onSelect?: ((index: string, indexPath: string[], item: import('element-plus').MenuItemClicked, routerResult?: Promise<void | import('vue-router').NavigationFailure> | undefined) => any) | undefined;
+            onOpen?: ((index: string, indexPath: string[]) => any) | undefined;
+        }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+            [key: string]: any;
+        }>, {}, {}, {}, {
+            readonly collapse: boolean;
+            readonly ellipsis: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+            readonly persistent: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+            readonly mode: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "horizontal" | "vertical", unknown>;
+            readonly showTimeout: number;
+            readonly hideTimeout: number;
+            readonly defaultActive: string;
+            readonly defaultOpeneds: string[];
+            readonly menuTrigger: import('element-plus/es/utils/index.mjs').EpPropMergeType<StringConstructor, "click" | "hover", unknown>;
+            readonly collapseTransition: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
+            readonly popperOffset: number;
+            readonly ellipsisIcon: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component) | (((new (...args: any[]) => (string | import('vue').Component) & {}) | (() => string | import('vue').Component)) | null)[], unknown, unknown>;
+            readonly popperEffect: import('element-plus/es/utils/index.mjs').EpPropMergeType<(new (...args: any[]) => string) | (() => import('element-plus').PopperEffect) | (((new (...args: any[]) => string) | (() => import('element-plus').PopperEffect)) | null)[], unknown, unknown>;
+            readonly uniqueOpened: boolean;
+            readonly router: boolean;
+            readonly closeOnClickOutside: boolean;
+        }> | null;
+    }, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        menus: RouteMetaResolveRaw[];
+        menuFlatList: RouteMetaResolveRaw[];
+        routerMode?: boolean;
+        collapse?: boolean;
+        autoClose?: boolean;
+        groupMode?: boolean;
+    }> & Readonly<{}>, {
+        open: (index: string) => void | undefined;
+        close: (index: string) => void | undefined;
+    }, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/types/components/app-layout/types.d.ts

@@ -41,7 +41,7 @@ export type AppLayoutUserStoreSlice<UserInfo = Record<string, any>> = ReturnType
  * （getRoutes / generateRouteMetaRawTree）。loginApi / refreshToken 等 auth
  * 面不通过本 slice 暴露（业务侧通过 appBridge 直读）。
  */
-export type AppLayoutBridgeSlice = Pick<CoreBridge, "APP_BASE_INFO" | "APP_ENV_INFO" | "APP_CACHE_CONFIG" | "APP_LAYOUT_HEADER_CONFIG" | "APP_LAYOUT_FOOTER_CONFIG" | "APP_LAYOUT_SIDEBAR_CONFIG" | "APP_LAYOUT_ASIDE_CONFIG" | "APP_LAYOUT_BREADCRUMB_CONFIG" | "APP_LAYOUT_BODY_CONFIG" | "APP_LAYOUT_VIEWPORT_CONFIG" | "APP_LAYOUT_GAP_CONFIG" | "APP_LAYOUT_CONFIG" | "APP_ROUTER_META_DEFAULT_CONFIG" | "APP_ROUTER_CONFIG" | "APP_ROUTER_PATHS_CONFIG" | "APP_THEME_CONFIG" | "theme" | "themeStyle" | "themeMode" | "themeIsDark" | "themeLayout" | "themeDensity" | "themeMotion" | "themeColors" | "showThemeStyleSwitcher" | "getRoutes" | "generateRouteMetaRawTree">;
+export type AppLayoutBridgeSlice = Pick<CoreBridge, "APP_BASE_INFO" | "APP_ENV_INFO" | "APP_CACHE_CONFIG" | "APP_LAYOUT_HEADER_CONFIG" | "APP_LAYOUT_FOOTER_CONFIG" | "APP_LAYOUT_SIDEBAR_CONFIG" | "APP_LAYOUT_ASIDE_CONFIG" | "APP_LAYOUT_BREADCRUMB_CONFIG" | "APP_LAYOUT_BODY_CONFIG" | "APP_LAYOUT_VIEWPORT_CONFIG" | "APP_LAYOUT_GAP_CONFIG" | "APP_LAYOUT_CONFIG" | "APP_ROUTER_META_DEFAULT_CONFIG" | "APP_ROUTER_CONFIG" | "APP_ROUTER_PATHS_CONFIG" | "APP_THEME_CONFIG" | "theme" | "themeStyle" | "themeMode" | "themeIsDark" | "themeLayout" | "themeDensity" | "themeMotion" | "themeColors" | "showThemeStyleSwitcher" | "layout" | "getRoutes" | "generateRouteMetaRawTree">;
 /**
  * 内容锚 slot 名集（焊缝契约 ③，纯功能语义；P1' 去布局化重做）。
  *

package/types/components/data-view/DataListViewItem.vue.d.ts

@@ -1,15 +1,20 @@
-/**
- * DataListView 单项容器
- * ---
- * 仅承载选中（勾选）/ 当前项（active）两个 class 钩子 + 项内容插槽，由 DataListView 内部 v-for 使用。
- * [MUST NOT] 写死视觉样式（卡片阴影/圆角等归消费方）；
- * [MUST NOT] 内置选中状态机（状态机在 DataListView）。
- */
 type __VLS_Props = {
     /** 当前项是否选中（勾选语义，由 DataListView 传入） */
     selected: boolean;
     /** 当前项是否为「当前项」（active = 用户点击/激活的那一条，与勾选无关） */
     active?: boolean;
+    /** 套内置卡壳（border/radius/padding，走 token）；由 DataListView 下发 */
+    card?: boolean;
+    /**
+     * 卡壳内呼吸（px）——由 DataListView 按间距阶梯**呼吸档**算好下发。
+     * 🔴 [MUST NOT] 在本组件自造 CSS 变量兜这个值（规则 14）：自造 var 脱离主题两套注入；
+     * 也 [MUST NOT] 写死 12 —— 那样切密度档不跟。
+     */
+    cardPad?: number;
+    /** 瀑布流态（即便本项还没量到跨度，也要吃 `align-self: start`，否则量出来恒等于写进去） */
+    masonry?: boolean;
+    /** 瀑布流跨度（`grid-row-end: span N`）；未测到时不写，退 CSS 兜底跨度 */
+    spanRows?: number;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;