web-extend-plugin-vue2 0.2.5 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # web-extend-plugin-vue2
 
-面向 **Vue 2.6+** 与 **Vue Router 3** 的 Web 插件运行时：浏览器中拉取**插件清单**、加载入口脚本、执行 `activator(hostApi)`，并提供 **`ExtensionPoint`**、菜单/路由注册表与受控 **`getBridge()`**。发布物为预构建的 **`dist/`**（CJS/ESM），类型见根目录 **`index.d.ts`**。
+面向 **Vue 2.6+** 与 **Vue Router 3** 的 Web 插件运行时：浏览器中拉取**插件清单**、加载入口脚本、执行 `activator(hostApi)`，并提供 **`ExtensionPoint`**、动态路由注册与受控 **`getBridge()`**；侧栏菜单由宿主根据路由 **`meta`** 自行推导（`buildMenuDescriptorsFromRoutes`）。发布物为预构建的 **`dist/`**（CJS/ESM），类型见根目录 **`index.d.ts`**。
 
 **Peer：`vue` ^2.6.14 \<3，`vue-router` ^3.5 \<4**（依赖 `router.addRoute`）。**
 
@@ -33,7 +33,7 @@ installWebExtendPluginVue2(Vue, router, {
 }).catch(console.warn)
 ```
 
-**Vue CLI + 已有 axios `request`**（开箱：`/plugin` 壳路由 + Layout 由框架注册；清单可走 Java，开发态可自动回退 `public/web-plugins/plugins.manifest.json`）：
+**Vue CLI + 已有 axios `request`**（清单可走 Java，开发态可自动回退 `public/web-plugins/plugins.manifest.json`；**不再**默认注册 `/plugin` 壳，需显式 `ensurePluginHostRoute: true` 且配置 `pluginRoutesParentName` + `hostLayoutComponent`）：
 
 **更少样板（推荐）**：自动写入 `window.Vue`（IIFE 插件与 build-kit 约定）、合并 `hostContext`（`router` + 可选 `store`）、默认 `manifestListPath` 为 **`/frontend-plugins`**（与 `VUE_APP_BASE_API` 拼接；若后端为 `/api/frontend-plugins` 请在第 4 参数传 `manifestListPath: '/api/frontend-plugins'`）、`isDev` 与构建环境一致。按需关闭全局 Vue：`{ exposeGlobalVue: false }`。
 
@@ -49,15 +49,13 @@ installVueCliAxiosWebPlugins(
   {
     request,
     hostLayoutComponent: Layout,
-    store,
-    applyPluginMenuItems: ({ pluginId, items }) => {
-      /* 并入宿主侧栏 */
-    },
-    revokePluginMenuItems: (pluginId) => {
-      /* 撤销该插件菜单 */
-    }
+    store
   },
-  { manifestBase: process.env.VUE_APP_BASE_API }
+  {
+    manifestBase: process.env.VUE_APP_BASE_API,
+    pluginRoutesParentName: '__wepPluginHost',
+    ensurePluginHostRoute: true
+  }
 ).catch((e) => console.warn('[web-plugin] bootstrap failed', e))
 ```
 
@@ -83,11 +81,18 @@ import Layout from '@/layout'
 installWebExtendPluginVue2(
   Vue,
   router,
-  createVueCliAxiosInstallOptions({ request }, { hostLayoutComponent: Layout })
+  createVueCliAxiosInstallOptions(
+    { request },
+    {
+      hostLayoutComponent: Layout,
+      pluginRoutesParentName: '__wepPluginHost',
+      ensurePluginHostRoute: true
+    }
+  )
 ).catch(console.warn)
 ```
 
-默认插件父路由 **`name`** 为 **`__wepPluginHost`**，路径 **`/plugin`**；插件内 `registerRoutes` 使用相对 `path`（如 `plugin-b-sample`）即可，全路径为 `/plugin/...`。自定义：`pluginRoutesParentName`、`pluginMountPath`。
+若启用壳路由：`pluginRoutesParentName`（如 **`__wepPluginHost`**）+ `pluginMountPath`（默认 **`/plugin`**）+ `ensurePluginHostRoute: true`。未启用壳时，`registerRoutes` 的 `path` 为**绝对路径**或宿主在 `transformRoutes` 中自行加前缀。
 
 **静态清单模式**（无需 Java `frontend-plugins`，将聚合 JSON 放入宿主 `public` 等静态目录）：
 
@@ -144,11 +149,11 @@ bootstrapPlugins(router, (id, r, kit) => createHostApi(id, r, kit), runtime).cat
 | `bridgeAllowedPathPrefixes` | `hostApi.getBridge().request(path)` 允许的 path 前缀 |
 | `allowedScriptHosts` | 允许加载插件脚本的主机名白名单 |
 | `isDev` / `webPluginDevOrigin` 等 | 开发态隐式 dev 入口与 SSE，见类型定义 |
-| `hostLayoutComponent` | 传入后自动注册 `/plugin` + Layout 壳（`addRoute`），无需在宿主路由表手写 `/plugin` |
-| `pluginMountPath` / `pluginHostRouteMeta` / `ensurePluginHostRoute` | 壳路径（默认 `/plugin`）、meta、是否自动注册（默认 true） |
-| `pluginRoutesParentName` | 壳路由的 **name**，插件子项挂在其下；未传且传入 `hostLayoutComponent` 时默认为 **`__wepPluginHost`** |
+| `hostLayoutComponent` | 与 `ensurePluginHostRoute: true` 且配置了 `pluginRoutesParentName` 时用于自动注册壳路由的 Layout 组件 |
+| `pluginMountPath` / `pluginHostRouteMeta` / `ensurePluginHostRoute` | 壳路径（默认 `/plugin`）、壳 meta、**仅在为 true 时**自动注册壳（默认 **false**） |
+| `pluginRoutesParentName` | 命名父路由的 **name**；非空时 `registerRoutes` 子项通过 `addRoute(parentName, child)` 挂载 |
 | `adaptRouteDeclarations` / `transformRoutes` / `interceptRegisterRoutes` | 路由 PRD 适配与宿主扩展流水线 |
-| `applyPluginMenuItems` / `revokePluginMenuItems` | **菜单**：插件 `registerMenuItems` 仅触发回调，由宿主并入自己的侧栏/权限路由等数据结构；卸载时撤销 |
+| `buildMenuDescriptorsFromRoutes`（具名导出 / `WebExtendPluginVue2.host`） | 由插件提交的 `RouteConfig` 树与 **`meta.title` / `meta.menuTitle`** 等推导菜单数据，供宿主写入 Vuex 等 |
 | `hostContext` | **依赖注入（推荐）**：普通对象，引导时做**浅拷贝并浅冻结**后挂到 **`hostApi.hostContext`**，插件只读使用 `store` / `router` / 宿主开放 API 等，不污染 `HostApi` 顶层方法名 |
 | `onBeforePluginActivate` / `onAfterPluginActivate` / `onPluginActivateError` | **生命周期**：激活前（可 `throw` 跳过该插件）、成功后、抛错后；便于埋点、门禁、监控，各宿主同一套签名即可接入 |
 
@@ -156,9 +161,10 @@ bootstrapPlugins(router, (id, r, kit) => createHostApi(id, r, kit), runtime).cat
 
 ### 宿主接入约定（跨项目统一）
 
-1. **菜单**：实现 `applyPluginMenuItems` + `revokePluginMenuItems`，菜单字段→本地侧栏结构的映射留在宿主。  
+1. **菜单**：插件在 `registerRoutes` 的 **`meta`** 中写明 `title` / `order` / `icon` / `permission` / `hidden` 等；宿主在 `onAfterPluginActivate` 或统一收集阶段用 **`buildMenuDescriptorsFromRoutes(routes, pluginId)`** 生成侧栏数据（或由宿主在 `transformRoutes` 之后自行扫 `router.getRoutes()`）。**不再**使用 `registerMenuItems`。  
 2. **宿主能力**：通过 **`hostContext`** 注入（如 `{ store, router, getDict }`），插件内使用 **`hostApi.hostContext.store`**，避免 `Vue.prototype` 魔法与命名冲突。  
-3. **拦截激活**：在 **`onBeforePluginActivate`** 中做权限/租户校验，不通过则 **`throw`**；错误用 **`onPluginActivateError`** 上报，勿在 error 钩子里再抛异常。
+3. **拦截激活**：在 **`onBeforePluginActivate`** 中做权限/租户校验，不通过则 **`throw`**；错误用 **`onPluginActivateError`** 上报，勿在 error 钩子里再抛异常。  
+4. **卸载**：`disposeWebPlugin(pluginId)` 会 **`removeRoute`** 移除该插件登记的动态路由，并清理槽位、脚本与 teardown；侧栏需按 **`pluginId`** 或重建菜单树与路由对齐。
 
 ---
 
@@ -170,19 +176,30 @@ bootstrapPlugins(router, (id, r, kit) => createHostApi(id, r, kit), runtime).cat
 <ExtensionPoint point-id="app.toolbar.demo" />
 ```
 
-**侧栏菜单**（框架不维护菜单列表；`registries` 仅含扩展点 `slots`）：
+**侧栏菜单**（`registries` 仅含扩展点 `slots`；菜单与路由同源）：
 
 ```js
-// resolveRuntimeOptions / install options 中提供：
-applyPluginMenuItems: ({ pluginId, items }) => {
-  // 将 items 映射为宿主侧栏数据结构（如 Vuex、与后端路由同形的树等）
-},
-revokePluginMenuItems: (pluginId) => {
-  // 从宿主 state 移除该插件贡献的菜单项
-}
+import { buildMenuDescriptorsFromRoutes } from 'web-extend-plugin-vue2'
+
+// 插件 activator 内：
+hostApi.registerRoutes([
+  {
+    path: 'hello',
+    component: Hello,
+    meta: { title: '插件 Hello', order: 10, pluginId: 'com.example' }
+  }
+])
+
+// 宿主在 onAfterPluginActivate 或自行约定的收集点：
+const items = buildMenuDescriptorsFromRoutes(
+  [
+    /* 与插件注册前相同的 RouteConfig 快照，或由宿主在 transformRoutes 中缓存 */
+  ],
+  pluginId
+)
 ```
 
-插件侧仍为 `hostApi.registerMenuItems([{ path, title, order, ... }])`；是否显示、图标、层级样式全部由宿主决定。
+`disposeWebPlugin` 会移除对应动态路由；宿主从 state 中删除同一 `pluginId` 的菜单项即可。
 
 **宿主上下文（插件读宿主能力）**：
 
@@ -198,7 +215,7 @@ hostContext: {
 
 **路由扩展（宿主）**：在 `resolveRuntimeOptions` 里提供 `transformRoutes` 或 `adaptRouteDeclarations`，插件在 `activator` 第二个参数中取冻结的 **`pluginRecord`**（可含清单里的 `routeDeclarations`）。
 
-**卸载插件**：
+**卸载插件**（含 `router.removeRoute` 批量撤销该插件登记的顶层路由名）：
 
 ```js
 import { disposeWebPlugin } from 'web-extend-plugin-vue2'

package/dist/index.cjs

@@ -344,15 +344,9 @@ function resolveRuntimeOptions$1(user = {}) {
         return String(DEF.devFallbackStaticManifestUrl).trim();
     })();
     const hostLayoutComponent = user.hostLayoutComponent;
-    const pluginRoutesParentName = (() => {
-        if (user.pluginRoutesParentName !== undefined) {
-            return String(user.pluginRoutesParentName).trim();
-        }
-        if (hostLayoutComponent != null) {
-            return String(DEF.pluginRoutesParentName).trim();
-        }
-        return '';
-    })();
+    const pluginRoutesParentName = user.pluginRoutesParentName !== undefined && String(user.pluginRoutesParentName).trim() !== ''
+        ? String(user.pluginRoutesParentName).trim()
+        : '';
     const pluginMountRaw = user.pluginMountPath !== undefined && String(user.pluginMountPath).trim() !== ''
         ? String(user.pluginMountPath).trim()
         : String(resolveBundledEnv(EK.mountPath, '') || DEF.pluginMountPath).trim();
@@ -360,7 +354,7 @@ function resolveRuntimeOptions$1(user = {}) {
     const pluginHostRouteMeta = user.pluginHostRouteMeta !== undefined && user.pluginHostRouteMeta !== null
         ? user.pluginHostRouteMeta
         : undefined;
-    const ensurePluginHostRoute = user.ensurePluginHostRoute !== false;
+    const ensurePluginHostRoute = user.ensurePluginHostRoute === true;
     const devManifestFallback = (() => {
         if (manifestMode === 'static') {
             return false;
@@ -423,12 +417,6 @@ function resolveRuntimeOptions$1(user = {}) {
         ...(typeof user.adaptRouteDeclarations === 'function'
             ? { adaptRouteDeclarations: user.adaptRouteDeclarations }
             : {}),
-        ...(typeof user.applyPluginMenuItems === 'function'
-            ? { applyPluginMenuItems: user.applyPluginMenuItems }
-            : {}),
-        ...(typeof user.revokePluginMenuItems === 'function'
-            ? { revokePluginMenuItems: user.revokePluginMenuItems }
-            : {}),
         ...(user.hostContext !== undefined &&
             user.hostContext !== null &&
             typeof user.hostContext === 'object' &&
@@ -3220,21 +3208,18 @@ var semverExports = requireSemver();
 var semver = /*@__PURE__*/getDefaultExportFromCjs(semverExports);
 
 /**
- * `disposeWebPlugin` 使用的菜单撤销钩子：在 `bootstrapPlugins` 中用 `resolveRuntimeOptions` 结果注册。
+ * 引导时注入的 router 引用，供 disposeWebPlugin 按插件批量 removeRoute。
  */
-let revokePluginMenuItems;
-function setRevokePluginMenuItems(fn) {
-    revokePluginMenuItems = fn;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let bootstrapRouter;
+/** 由 bootstrapPlugins 在浏览器环境调用 */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function setPluginBootstrapRouter(router) {
+    bootstrapRouter = router;
 }
-function revokePluginMenusIfConfigured(pluginId) {
-    if (typeof revokePluginMenuItems === 'function') {
-        try {
-            revokePluginMenuItems(pluginId);
-        }
-        catch (e) {
-            console.warn('[wep] revokePluginMenuItems failed', pluginId, e);
-        }
-    }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getPluginBootstrapRouter() {
+    return bootstrapRouter;
 }
 
 /**
@@ -3491,7 +3476,8 @@ async function fetchStaticManifestViaHttp(ctx) {
 }
 
 /**
- * 开箱：在未手工配置时，注册 `/plugin` + 宿主 Layout 的命名父路由，供 `router.addRoute(parentName, child)` 挂载插件页。
+ * 当 `ensurePluginHostRoute === true` 且提供 `pluginRoutesParentName` + `hostLayoutComponent` 时，
+ * 注册 `pluginMountPath` + Layout 的命名父路由，供 `router.addRoute(parentName, child)` 挂载插件页。
  */
 function routeNameExists(router, name) {
     if (!name) {
@@ -3518,7 +3504,7 @@ function walkRouteNames(routes, name) {
     return false;
 }
 function ensurePluginHostRoute$1(router, opts) {
-    if (opts.ensurePluginHostRoute === false) {
+    if (opts.ensurePluginHostRoute !== true) {
         return;
     }
     if (!router || typeof router.addRoute !== 'function') {
@@ -3647,7 +3633,7 @@ createHostApiFactory, runtimeOptions) {
     }
     printRuntimeBannerOnce();
     const opts = resolveRuntimeOptions$1(runtimeOptions || {});
-    setRevokePluginMenuItems(typeof opts.revokePluginMenuItems === 'function' ? opts.revokePluginMenuItems : undefined);
+    setPluginBootstrapRouter(router);
     ensurePluginHostRoute$1(router, opts);
     const base = String(opts.manifestBase).replace(/\/$/, '');
     const isStatic = opts.manifestMode === 'static';
@@ -3724,12 +3710,6 @@ createHostApiFactory, runtimeOptions) {
             : {}),
         ...(typeof opts.adaptRouteDeclarations === 'function'
             ? { adaptRouteDeclarations: opts.adaptRouteDeclarations }
-            : {}),
-        ...(typeof opts.applyPluginMenuItems === 'function'
-            ? { applyPluginMenuItems: opts.applyPluginMenuItems }
-            : {}),
-        ...(typeof opts.revokePluginMenuItems === 'function'
-            ? { revokePluginMenuItems: opts.revokePluginMenuItems }
             : {})
     };
     if (!manifestResult.ok) {
@@ -4019,7 +3999,7 @@ var manifestComposer = /*#__PURE__*/Object.freeze({
 
 /**
  * 宿主侧响应式注册表：扩展点槽位（供布局与 `ExtensionPoint` 消费）。
- * 菜单数据由宿主在 `applyPluginMenuItems` 中自行并入其路由/菜单 state，框架不维护平行菜单列表。
+ * 菜单由宿主从路由 `meta` 推导（见 `buildMenuDescriptorsFromRoutes`），框架不维护平行菜单列表。
  */
 const registries = Vue__default.default.observable({
     slots: {},
@@ -4082,6 +4062,47 @@ function createRequestBridge(config = {}) {
     };
 }
 
+/**
+ * 记录各插件通过 registerRoutes 挂到 router 上的顶层 route name，便于 dispose 时 removeRoute。
+ */
+const pluginIdToRouteNames = new Map();
+function recordPluginTopRouteNames(pluginId, names) {
+    if (!pluginId || names.length === 0) {
+        return;
+    }
+    const cur = pluginIdToRouteNames.get(pluginId) || [];
+    pluginIdToRouteNames.set(pluginId, cur.concat(names));
+}
+/**
+ * 从 matcher 移除该插件登记过的顶层路由（含其子树）。
+ * 需 vue-router ≥3.5 的 removeRoute；否则静默跳过。
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function removeRegisteredRoutesForPlugin(router, pluginId) {
+    const names = pluginIdToRouteNames.get(pluginId);
+    if (!names || names.length === 0) {
+        return;
+    }
+    if (!router || typeof router.removeRoute !== 'function') {
+        console.warn('[wep] router.removeRoute 不可用，跳过动态路由卸载', pluginId);
+        pluginIdToRouteNames.delete(pluginId);
+        return;
+    }
+    for (let i = names.length - 1; i >= 0; i--) {
+        try {
+            router.removeRoute(names[i]);
+        }
+        catch (e) {
+            console.warn('[wep] removeRoute failed', names[i], e);
+        }
+    }
+    pluginIdToRouteNames.delete(pluginId);
+}
+/** 测试或宿主高级场景：查询已登记 name（勿依赖顺序语义） */
+function getRegisteredTopRouteNamesForPlugin(pluginId) {
+    return [...(pluginIdToRouteNames.get(pluginId) || [])];
+}
+
 /**
  * 构造插件 `activator(hostApi)` 使用的宿主 API：路由、菜单、扩展点、资源与受控请求桥。
  */
@@ -4137,6 +4158,7 @@ function createHostApi(pluginId, router, hostKitOptions = {}) {
         if (typeof router.addRoute !== 'function') {
             throw new Error('[wep] vue-router 3.5+ 必需：请使用 router.addRoute（不再支持 addRoutes）');
         }
+        recordPluginTopRouteNames(pluginId, wrapped.map((r) => String(r.name)));
         if (parentName) {
             for (const r of wrapped) {
                 router.addRoute(parentName, r);
@@ -4216,16 +4238,6 @@ function createHostApi(pluginId, router, hostKitOptions = {}) {
                 applyInternalRegister(configs);
             }
         },
-        registerMenuItems(items) {
-            const apply = hostKitOptions.applyPluginMenuItems;
-            if (typeof apply !== 'function') {
-                throw new Error('[wep] registerMenuItems 需要宿主在 resolveRuntimeOptions 中提供 applyPluginMenuItems，将菜单数据并入宿主侧栏/目录 state（框架不再维护 registries.menus）');
-            }
-            const list = Array.isArray(items) ? items : [];
-            const enriched = list.map((item) => ({ ...item, pluginId }));
-            enriched.sort((a, b) => (a.order != null ? Number(a.order) : 0) - (b.order != null ? Number(b.order) : 0));
-            apply({ pluginId, items: enriched });
-        },
         registerSlotComponents(pointId, components) {
             if (!pointId) {
                 return;
@@ -4269,15 +4281,15 @@ function createHostApi(pluginId, router, hostKitOptions = {}) {
 }
 
 /**
- * 卸载单个插件：执行 teardown、清理注册表与 activator、移除带 `data-plugin-asset` 的 DOM。
- * 注意：Vue Router 3 无公开 `removeRoute`，动态路由通常需整页刷新或宿主自行维护。
+ * 卸载单个插件：执行 teardown、按登记 name 批量 removeRoute、清理注册表与 activator、移除带 `data-plugin-asset` 的 DOM。
+ * 依赖 vue-router ≥3.5 的 removeRoute；引导时由 bootstrapPlugins 注入 router。
  */
 function disposeWebPlugin(pluginId) {
     if (!pluginId || typeof pluginId !== 'string') {
         return;
     }
     runPluginTeardowns(pluginId);
-    revokePluginMenusIfConfigured(pluginId);
+    removeRegisteredRoutesForPlugin(getPluginBootstrapRouter(), pluginId);
     const slots = registries.slots;
     for (const pointId of Object.keys(slots)) {
         const list = slots[pointId];
@@ -4305,6 +4317,75 @@ function disposeWebPlugin(pluginId) {
     }
 }
 
+/**
+ * 从路由配置（含 meta）推导侧栏/目录用菜单描述，与 registerRoutes 入参同源。
+ *
+ * 约定：
+ * - `meta.menu === false`：该节点及其子树不参与菜单
+ * - 节点出现条件：`meta.title` 或 `meta.menuTitle` 非空字符串，或存在非空的子菜单列表
+ * - `meta.order` 数字越小越靠前；缺省为 0
+ * - 可选：`meta.icon`、`meta.permission`、`meta.hidden`、`meta.external`
+ */
+function pickTitle(meta, route) {
+    if (typeof meta.menuTitle === 'string' && meta.menuTitle) {
+        return meta.menuTitle;
+    }
+    if (typeof meta.title === 'string' && meta.title) {
+        return meta.title;
+    }
+    if (route.name != null && String(route.name)) {
+        return String(route.name);
+    }
+    return String(route.path || '');
+}
+function sortDescriptors(items) {
+    items.sort((a, b) => a.order - b.order || a.path.localeCompare(b.path));
+    for (const x of items) {
+        if (x.children && x.children.length) {
+            sortDescriptors(x.children);
+        }
+    }
+}
+/**
+ * 从插件侧 RouteConfig 树构建菜单描述（不含 component，便于并入宿主菜单 state）。
+ */
+function buildMenuDescriptorsFromRoutes(routes, pluginId) {
+    const out = [];
+    function walk(route) {
+        const meta = (route.meta || {});
+        if (meta.menu === false) {
+            return null;
+        }
+        const chIn = Array.isArray(route.children) ? route.children : [];
+        const childMenus = chIn.map(walk).filter(Boolean);
+        const hasTitle = typeof meta.title === 'string' || typeof meta.menuTitle === 'string';
+        if (!hasTitle && childMenus.length === 0) {
+            return null;
+        }
+        const item = {
+            path: String(route.path || ''),
+            name: route.name,
+            title: pickTitle(meta, route),
+            order: meta.order != null ? Number(meta.order) : 0,
+            ...(pluginId ? { pluginId } : {}),
+            ...(meta.icon !== undefined ? { icon: meta.icon } : {}),
+            ...(meta.permission !== undefined ? { permission: meta.permission } : {}),
+            ...(meta.hidden === true ? { hidden: true } : {}),
+            ...(meta.external === true ? { external: true } : {}),
+            ...(childMenus.length ? { children: childMenus } : {})
+        };
+        return item;
+    }
+    for (const r of routes) {
+        const m = walk(r);
+        if (m) {
+            out.push(m);
+        }
+    }
+    sortDescriptors(out);
+    return out;
+}
+
 /**
  * 布局中的扩展点占位；插件通过 `hostApi.registerSlotComponents(pointId, ...)` 注入组件。
  * 样式由宿主全局 CSS 覆盖 `.extension-point` / `.plugin-point-error`。
@@ -4475,7 +4556,7 @@ function createVueCliAxiosInstallOptions(deps, extra = {}) {
 function createVueCliAxiosQuickInstallOptions(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 router, deps, extra = {}) {
-    const { request, hostLayoutComponent, store, hostContext: depHostContext, applyPluginMenuItems, revokePluginMenuItems } = deps;
+    const { request, hostLayoutComponent, store, hostContext: depHostContext } = deps;
     const { hostContext: extraHostContext, isDev: extraIsDev, manifestListPath: extraListPath, ...restExtra } = extra;
     const hostContext = {
         router,
@@ -4489,8 +4570,6 @@ router, deps, extra = {}) {
     return createVueCliAxiosInstallOptions({ request }, {
         hostLayoutComponent,
         hostContext,
-        applyPluginMenuItems,
-        revokePluginMenuItems,
         isDev: extraIsDev !== undefined ? Boolean(extraIsDev) : resolveBundledIsDev(),
         manifestListPath,
         ...restExtra
@@ -4511,7 +4590,8 @@ const presetVueCliAxios = Object.freeze({
  */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function installVueCliAxiosWebPlugins(Vue, router, deps, extra) {
-    const exposeGlobalVue = extra?.exposeGlobalVue !== false;
+    /** 避免输出 `?.`：Vue CLI 4 / Webpack 4 默认不转译 node_modules */
+    const exposeGlobalVue = extra == null || extra.exposeGlobalVue !== false;
     if (exposeGlobalVue && typeof window !== 'undefined') {
         window.Vue = Vue;
     }
@@ -4540,7 +4620,9 @@ const WebExtendPluginVue2 = Object.freeze({
         createHostApi,
         disposeWebPlugin,
         createRequestBridge,
-        registries
+        registries,
+        buildMenuDescriptorsFromRoutes,
+        getRegisteredTopRouteNamesForPlugin
     }),
     config: Object.freeze({
         defaultWebExtendPluginRuntime,
@@ -4568,6 +4650,7 @@ exports.HOST_PLUGIN_API_VERSION = HOST_PLUGIN_API_VERSION;
 exports.RUNTIME_CONSOLE_LABEL = RUNTIME_CONSOLE_LABEL;
 exports.WebExtendPluginVue2 = WebExtendPluginVue2;
 exports.bootstrapPlugins = bootstrapPlugins;
+exports.buildMenuDescriptorsFromRoutes = buildMenuDescriptorsFromRoutes;
 exports.composeManifestFetch = composeManifestFetch;
 exports.createHostApi = createHostApi;
 exports.createRequestBridge = createRequestBridge;
@@ -4580,6 +4663,7 @@ exports.defaultVueCliJavaManifestListPath = defaultVueCliJavaManifestListPath;
 exports.defaultWebExtendPluginRuntime = defaultWebExtendPluginRuntime;
 exports.disposeWebPlugin = disposeWebPlugin;
 exports.ensurePluginHostRoute = ensurePluginHostRoute;
+exports.getRegisteredTopRouteNamesForPlugin = getRegisteredTopRouteNamesForPlugin;
 exports.installVueCliAxiosWebPlugins = installVueCliAxiosWebPlugins;
 exports.installWebExtendPluginVue2 = installWebExtendPluginVue2;
 exports.manifestFetchCacheMiddleware = manifestFetchCacheMiddleware;