web-extend-plugin-vue2 0.2.3 → 0.3.0

package/dist/index.cjs

@@ -6,379 +6,480 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var Vue__default = /*#__PURE__*/_interopDefault(Vue);
 
-/**
- * `resolveRuntimeOptions` 的默认值来源；宿主可只覆盖部分字段。
- */
-const defaultWebExtendPluginRuntime = {
-  manifestBase: '/fp-api',
-  manifestListPath: '/api/frontend-plugins',
-  manifestFetchCredentials: 'include',
-  devPingPath: '/__web_plugin_dev_ping',
-  devReloadSsePath: '/__web_plugin_reload_stream',
-  webPluginDevEntryPath: '/src/plugin-entry.js',
-  devPingTimeoutMs: 500,
-  defaultImplicitDevPluginIds: [],
-  allowedScriptHosts: ['localhost', '127.0.0.1', '::1'],
-  bridgeAllowedPathPrefixes: ['/api/']
+/**
+ * 对外配置单一入口：`resolveRuntimeOptions` / 文档 / 其它模块的默认值与环境键名均由此引用。
+ * 宿主通过 `resolveRuntimeOptions(partial)` 覆盖的对象形状见 `defaultWebExtendPluginRuntime`。
+ */
+/** 与 `package.json` 的 peer 下限一致；`npm run test:peer-min` / CI matrix 须与此保持同步 */
+const peerMinimumVersions = {
+    vue: '2.6.14',
+    vueRouter: '3.5.4'
+};
+// ---------------------------------------------------------------------------
+// 协议与品牌（发布契约；与清单 `hostPluginApiVersion` 对齐 semver 主版本，一般不随宿主覆盖）
+// ---------------------------------------------------------------------------
+const HOST_PLUGIN_API_VERSION = '1.0.0';
+/** 控制台日志与首次引导横幅使用的短名称 */
+const RUNTIME_CONSOLE_LABEL = 'web-extend-plugin-vue2';
+// ---------------------------------------------------------------------------
+// 与 `build-env` / `resolveBundledEnv` 配套的键名（单一事实来源，便于检索与文档）
+// ---------------------------------------------------------------------------
+const webExtendPluginEnvKeys = {
+    manifestBase: 'VITE_FRONTEND_PLUGIN_BASE',
+    manifestListPath: 'VITE_WEB_PLUGIN_MANIFEST_PATH',
+    implicitDevIds: 'VITE_WEB_PLUGIN_IMPLICIT_DEV_IDS',
+    allowedScriptHosts: 'VITE_WEB_PLUGIN_ALLOWED_SCRIPT_HOSTS',
+    bridgePrefixes: 'VITE_WEB_PLUGIN_BRIDGE_PREFIXES',
+    devFallbackManifestUrl: 'VITE_WEB_PLUGIN_DEV_FALLBACK_MANIFEST_URL',
+    manifestMode: 'VITE_WEB_PLUGIN_MANIFEST_MODE',
+    staticManifestUrl: 'VITE_WEB_PLUGIN_STATIC_MANIFEST_URL',
+    mountPath: 'VITE_WEB_PLUGIN_MOUNT_PATH',
+    devEntry: 'VITE_WEB_PLUGIN_DEV_ENTRY',
+    devPing: 'VITE_WEB_PLUGIN_DEV_PING_PATH',
+    devSse: 'VITE_WEB_PLUGIN_DEV_SSE_PATH',
+    devPingTimeout: 'VITE_WEB_PLUGIN_DEV_PING_TIMEOUT_MS',
+    manifestCredentials: 'VITE_WEB_PLUGIN_MANIFEST_CREDENTIALS',
+    devManifestFallback: 'VITE_WEB_PLUGIN_DEV_MANIFEST_FALLBACK',
+    webPluginDevOrigin: 'VITE_WEB_PLUGIN_DEV_ORIGIN',
+    webPluginDevIds: 'VITE_WEB_PLUGIN_DEV_IDS',
+    webPluginDevMap: 'VITE_WEB_PLUGIN_DEV_MAP',
+    pluginsBootstrapSummary: 'VITE_PLUGINS_BOOTSTRAP_SUMMARY',
+    /** 清单路径备选：部分宿主单独使用 */
+    manifestPathAlt: 'VUE_APP_WEB_PLUGIN_MANIFEST_PATH'
+};
+// ---------------------------------------------------------------------------
+// `manifestMode` 未配置且环境未指定时的默认值
+// ---------------------------------------------------------------------------
+const defaultManifestMode = 'api';
+// ---------------------------------------------------------------------------
+// `manifest-fetch-composer` 中间件默认（中间件 options 可逐项覆盖）
+// ---------------------------------------------------------------------------
+const defaultManifestFetchCache = {
+    storageKeyPrefix: 'wep.manifestFetch.v1',
+    maxEntries: 50
+};
+// ---------------------------------------------------------------------------
+// 路由合成名前缀（`createHostApi` 为无 name 的路由生成 `__wep_${pluginId}_${seq}`）
+// ---------------------------------------------------------------------------
+const routeSynthNamePrefix = '__wep_';
+// ---------------------------------------------------------------------------
+// 宿主可通过 `resolveRuntimeOptions` 覆盖的运行时默认值（与 README / index.d.ts 描述一致）
+// ---------------------------------------------------------------------------
+const defaultWebExtendPluginRuntime = {
+    manifestBase: '/fp-api',
+    manifestListPath: '/api/frontend-plugins',
+    manifestFetchCredentials: 'include',
+    devPingPath: '/__web_plugin_dev_ping',
+    devReloadSsePath: '/__web_plugin_reload_stream',
+    webPluginDevEntryPath: '/src/plugin-entry.js',
+    devPingTimeoutMs: 500,
+    defaultImplicitDevPluginIds: [],
+    allowedScriptHosts: ['localhost', '127.0.0.1', '::1'],
+    bridgeAllowedPathPrefixes: ['/api/'],
+    /** 与 `hostLayoutComponent` 同时使用时默认父路由 name */
+    pluginRoutesParentName: '__wepPluginHost',
+    /** 插件壳路径（与菜单、ensurePluginHostRoute 一致） */
+    pluginMountPath: '/plugin',
+    /** `manifestMode=api` 且开发环境下，API 失败或 plugins 为空时尝试的静态 JSON（可放于 `public/web-plugins/`） */
+    devFallbackStaticManifestUrl: '/web-plugins/plugins.manifest.json'
 };
 
 /**
  * 与具体打包器解耦的运行时环境读取：优先显式注入，其次 `globalThis.__WEP_ENV__`，再读 `process.env`。
  * Vite 宿主建议在入口调用 `setWebExtendPluginEnv(import.meta.env)`。
  */
-
-/** @type {Record<string, unknown> | null} */
 let _injected = null;
-
 /**
  * 注入与 `import.meta.env` 同形态的对象（键如 `VITE_*`、`DEV`）。
- * @param {Record<string, unknown> | null | undefined} env
  */
 function setWebExtendPluginEnv(env) {
-  _injected = env && typeof env === 'object' ? env : null;
+    _injected = env && typeof env === 'object' ? env : null;
 }
-
-/**
- * @returns {Record<string, unknown> | null}
- */
 function getEnvObject() {
-  if (_injected) {
-    return _injected
-  }
-  try {
-    const g = typeof globalThis !== 'undefined' ? globalThis : undefined;
-    if (g && g.__WEP_ENV__ && typeof g.__WEP_ENV__ === 'object') {
-      return g.__WEP_ENV__
-    }
-  } catch (_) {
-    /* ignore */
-  }
-  return null
+    if (_injected) {
+        return _injected;
+    }
+    try {
+        const g = typeof globalThis !== 'undefined' ? globalThis : undefined;
+        const raw = g;
+        if (raw && raw.__WEP_ENV__ && typeof raw.__WEP_ENV__ === 'object') {
+            return raw.__WEP_ENV__;
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return null;
 }
-
 /**
  * 读取注入环境中的字符串配置（`VITE_*` / `PLUGIN_*` 等价键由调用方传入）。
- * @param {string} key
- * @returns {string|undefined}
  */
 function readInjectedEnvKey(key) {
-  const o = getEnvObject();
-  if (!o || !(key in o)) {
-    return undefined
-  }
-  const v = o[key];
-  if (v === undefined || v === '') {
-    return undefined
-  }
-  return String(v)
+    const o = getEnvObject();
+    if (!o || !(key in o)) {
+        return undefined;
+    }
+    const v = o[key];
+    if (v === undefined || v === '') {
+        return undefined;
+    }
+    return String(v);
 }
-
-/** @returns {boolean} */
 function readInjectedEnvDev() {
-  const o = getEnvObject();
-  return !!(o && o.DEV === true)
+    const o = getEnvObject();
+    return !!(o && o.DEV === true);
 }
 
 /**
  * 从注入环境与 `process.env` 解析 `VITE_*` / `PLUGIN_*` 键。
  */
-
-/**
- * @param {string} key
- * @returns {string|undefined}
- */
 function readProcessEnv(key) {
-  try {
-    if (typeof process !== 'undefined' && process.env && key in process.env) {
-      const v = process.env[key];
-      if (v !== undefined && v !== '') {
-        return String(v)
-      }
-    }
-  } catch (_) {
-    /* ignore */
-  }
-  return undefined
+    try {
+        if (typeof process !== 'undefined' && process.env && key in process.env) {
+            const v = process.env[key];
+            if (v !== undefined && v !== '') {
+                return String(v);
+            }
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return undefined;
 }
-
-/**
- * @param {string} viteStyleKey
- * @returns {string|null}
- */
 function viteKeyToPluginAlternate(viteStyleKey) {
-  if (typeof viteStyleKey !== 'string' || !viteStyleKey.startsWith('VITE_')) {
-    return null
-  }
-  return `PLUGIN_${viteStyleKey.slice(5)}`
+    if (typeof viteStyleKey !== 'string' || !viteStyleKey.startsWith('VITE_')) {
+        return null;
+    }
+    return `PLUGIN_${viteStyleKey.slice(5)}`;
 }
-
-/**
- * @param {string} key
- * @param {string} [fallback='']
- */
 function resolveBundledEnv(key, fallback = '') {
-  const alt = viteKeyToPluginAlternate(key);
-  const inj = readInjectedEnvKey(key);
-  const fromInjected =
-    inj === undefined || inj === null ? (alt ? readInjectedEnvKey(alt) : undefined) : inj;
-  const proc = readProcessEnv(key);
-  const fromProcess =
-    proc === undefined || proc === null ? (alt ? readProcessEnv(alt) : undefined) : proc;
-  const first = fromInjected === undefined || fromInjected === null ? fromProcess : fromInjected;
-  return first === undefined || first === null ? fallback : first
+    const alt = viteKeyToPluginAlternate(key);
+    const inj = readInjectedEnvKey(key);
+    const fromInjected = inj === undefined || inj === null ? (alt ? readInjectedEnvKey(alt) : undefined) : inj;
+    const proc = readProcessEnv(key);
+    const fromProcess = proc === undefined || proc === null ? (alt ? readProcessEnv(alt) : undefined) : proc;
+    const first = fromInjected === undefined || fromInjected === null ? fromProcess : fromInjected;
+    return first === undefined || first === null ? fallback : first;
 }
-
-/** @returns {boolean} */
 function resolveBundledIsDev() {
-  try {
-    if (readInjectedEnvDev()) {
-      return true
-    }
-  } catch (_) {
-    /* ignore */
-  }
-  try {
-    if (typeof process !== 'undefined' && process.env && process.env.NODE_ENV === 'development') {
-      return true
-    }
-  } catch (_) {
-    /* ignore */
-  }
-  return false
+    try {
+        if (readInjectedEnvDev()) {
+            return true;
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    try {
+        if (typeof process !== 'undefined' && process.env && process.env.NODE_ENV === 'development') {
+            return true;
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return false;
 }
 
 /**
- * 路径与脚本主机名校验工具。
- * @module runtime/path-host-utils
+ * 清单模式与静态清单 URL 配置解析（显式 options + VITE_* / PLUGIN_* 环境）。
  */
+const EK$1 = webExtendPluginEnvKeys;
+function resolveManifestModeFromInputs(userMode) {
+    if (userMode !== undefined && userMode !== null && String(userMode).trim() !== '') {
+        const s = String(userMode).trim().toLowerCase();
+        if (s === 'static' || s === 'api') {
+            return s;
+        }
+    }
+    const e = resolveBundledEnv(EK$1.manifestMode, '');
+    if (e) {
+        const s = String(e).trim().toLowerCase();
+        if (s === 'static' || s === 'api') {
+            return s;
+        }
+    }
+    return defaultManifestMode;
+}
+function resolveStaticManifestUrlFromInputs(userUrl) {
+    if (userUrl !== undefined && userUrl !== null) {
+        const s = String(userUrl).trim();
+        if (s !== '') {
+            return s;
+        }
+    }
+    return String(resolveBundledEnv(EK$1.staticManifestUrl, '') || '').trim();
+}
 
 /**
- * @param {string} p
+ * 路径与脚本主机名校验工具。
  */
 function ensureLeadingPath(p) {
-  const t = String(p || '').trim();
-  if (!t) {
-    return '/'
-  }
-  return t.startsWith('/') ? t : `/${t}`
+    const t = String(p || '').trim();
+    if (!t) {
+        return '/';
+    }
+    return t.startsWith('/') ? t : `/${t}`;
 }
-
-/**
- * @param {string} hostname
- */
 function normalizeHost(hostname) {
-  if (!hostname) {
-    return ''
-  }
-  const h = hostname.toLowerCase();
-  if (h.startsWith('[') && h.endsWith(']')) {
-    return h.slice(1, -1)
-  }
-  return h
+    if (!hostname) {
+        return '';
+    }
+    const h = hostname.toLowerCase();
+    if (h.startsWith('[') && h.endsWith(']')) {
+        return h.slice(1, -1);
+    }
+    return h;
 }
-
-/**
- * @param {string[]} hostnames
- * @returns {Set<string>}
- */
 function buildAllowedScriptHostsSet(hostnames) {
-  const s = new Set();
-  for (const h of hostnames) {
-    const n = normalizeHost(h);
-    if (n) {
-      s.add(n);
-    }
-  }
-  return s
+    const s = new Set();
+    for (const h of hostnames) {
+        const n = normalizeHost(h);
+        if (n) {
+            s.add(n);
+        }
+    }
+    return s;
 }
-
-/**
- * @param {string} url
- * @param {Set<string>} hostSet
- */
 function isScriptHostAllowed(url, hostSet) {
-  if (typeof window === 'undefined') {
-    return false
-  }
-  try {
-    const u = new URL(url, window.location.origin);
-    const h = normalizeHost(u.hostname);
-    return hostSet.has(h)
-  } catch {
-    return false
-  }
+    if (typeof window === 'undefined') {
+        return false;
+    }
+    try {
+        const u = new URL(url, window.location.origin);
+        const h = normalizeHost(u.hostname);
+        return hostSet.has(h);
+    }
+    catch {
+        return false;
+    }
 }
 
 /**
  * 合并用户、环境与默认配置得到运行时选项。
- * @module runtime/resolve-runtime-options
  */
-
-
 const DEF = defaultWebExtendPluginRuntime;
-
-/**
- * @param {string|undefined} userVal
- * @param {string} envKey
- * @param {RequestCredentials} fallback
- */
+const EK = webExtendPluginEnvKeys;
 function resolveManifestCredentials(userVal, envKey, fallback) {
-  if (userVal !== undefined && userVal !== '') {
-    const s = String(userVal);
-    if (s === 'include' || s === 'omit' || s === 'same-origin') {
-      return s
-    }
-  }
-  const e = resolveBundledEnv(envKey, '');
-  if (e === 'include' || e === 'omit' || e === 'same-origin') {
-    return e
-  }
-  return fallback
+    if (userVal !== undefined) {
+        const s = String(userVal);
+        if (s === 'include' || s === 'omit' || s === 'same-origin') {
+            return s;
+        }
+    }
+    const e = resolveBundledEnv(envKey, '');
+    if (e === 'include' || e === 'omit' || e === 'same-origin') {
+        return e;
+    }
+    return fallback;
 }
-
-/**
- * @param {number|undefined} userVal
- * @param {string} envKey
- * @param {number} fallback
- */
 function resolvePositiveInt(userVal, envKey, fallback) {
-  if (typeof userVal === 'number' && Number.isFinite(userVal) && userVal > 0) {
-    return Math.floor(userVal)
-  }
-  const raw = resolveBundledEnv(envKey, '');
-  const n = raw ? parseInt(raw, 10) : NaN;
-  if (Number.isFinite(n) && n > 0) {
-    return n
-  }
-  return fallback
+    if (typeof userVal === 'number' && Number.isFinite(userVal) && userVal > 0) {
+        return Math.floor(userVal);
+    }
+    const raw = resolveBundledEnv(envKey, '');
+    const n = raw ? parseInt(raw, 10) : NaN;
+    if (Number.isFinite(n) && n > 0) {
+        return n;
+    }
+    return fallback;
 }
-
-/**
- * 合并用户、环境变量与 `defaultWebExtendPluginRuntime`，得到完整运行时选项（宿主可只传需要覆盖的字段）。
- * @param {WebExtendPluginRuntimeOptions} [user]
- * @returns {object}
- */
+/** 合并用户、环境变量与 `defaultWebExtendPluginRuntime`，得到完整运行时选项（宿主可只传需要覆盖的字段）。 */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function resolveRuntimeOptions$1(user = {}) {
-  const manifestBaseRaw =
-    user.manifestBase !== undefined && user.manifestBase !== ''
-      ? String(user.manifestBase)
-      : resolveBundledEnv('VITE_FRONTEND_PLUGIN_BASE', DEF.manifestBase) || DEF.manifestBase;
-
-  const manifestListPath = ensureLeadingPath(
-    user.manifestListPath !== undefined && user.manifestListPath !== ''
-      ? user.manifestListPath
-      : resolveBundledEnv('VITE_WEB_PLUGIN_MANIFEST_PATH', DEF.manifestListPath)
-  );
-
-  const defaultImplicitDevPluginIds = Array.isArray(user.defaultImplicitDevPluginIds)
-    ? user.defaultImplicitDevPluginIds.map(String).filter(Boolean)
-    : (() => {
-        const e = resolveBundledEnv('VITE_WEB_PLUGIN_IMPLICIT_DEV_IDS', '');
-        if (e) {
-          return e
-            .split(',')
-            .map((s) => s.trim())
-            .filter(Boolean)
-        }
-        return [...DEF.defaultImplicitDevPluginIds]
-      })();
-
-  const allowedScriptHosts =
-    Array.isArray(user.allowedScriptHosts) && user.allowedScriptHosts.length > 0
-      ? user.allowedScriptHosts.map((h) => normalizeHost(String(h))).filter(Boolean)
-      : (() => {
-          const e = resolveBundledEnv('VITE_WEB_PLUGIN_ALLOWED_SCRIPT_HOSTS', '');
-          if (e) {
-            return e
-              .split(',')
-              .map((s) => normalizeHost(s.trim()))
-              .filter(Boolean)
-          }
-          return [...DEF.allowedScriptHosts]
+    const manifestBaseRaw = user.manifestBase !== undefined && user.manifestBase !== ''
+        ? String(user.manifestBase)
+        : resolveBundledEnv(EK.manifestBase, DEF.manifestBase) || DEF.manifestBase;
+    const manifestListPath = ensureLeadingPath(user.manifestListPath !== undefined && user.manifestListPath !== ''
+        ? user.manifestListPath
+        : resolveBundledEnv(EK.manifestListPath, DEF.manifestListPath));
+    const defaultImplicitDevPluginIds = Array.isArray(user.defaultImplicitDevPluginIds)
+        ? user.defaultImplicitDevPluginIds.map(String).filter(Boolean)
+        : (() => {
+            const e = resolveBundledEnv(EK.implicitDevIds, '');
+            if (e) {
+                return e
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+            }
+            return [...DEF.defaultImplicitDevPluginIds];
         })();
-
-  const bridgeAllowedPathPrefixes =
-    Array.isArray(user.bridgeAllowedPathPrefixes) && user.bridgeAllowedPathPrefixes.length > 0
-      ? user.bridgeAllowedPathPrefixes.map((p) => ensureLeadingPath(p)).filter(Boolean)
-      : (() => {
-          const e = resolveBundledEnv('VITE_WEB_PLUGIN_BRIDGE_PREFIXES', '');
-          if (e) {
-            return e
-              .split(',')
-              .map((s) => ensureLeadingPath(s.trim()))
-              .filter(Boolean)
-          }
-          return [...DEF.bridgeAllowedPathPrefixes]
+    const allowedScriptHosts = Array.isArray(user.allowedScriptHosts) && user.allowedScriptHosts.length > 0
+        ? user.allowedScriptHosts.map((h) => normalizeHost(String(h))).filter(Boolean)
+        : (() => {
+            const e = resolveBundledEnv(EK.allowedScriptHosts, '');
+            if (e) {
+                return e
+                    .split(',')
+                    .map((s) => normalizeHost(s.trim()))
+                    .filter(Boolean);
+            }
+            return [...DEF.allowedScriptHosts];
         })();
-
-  return {
-    manifestBase: manifestBaseRaw.replace(/\/$/, '') || DEF.manifestBase.replace(/\/$/, ''),
-    manifestListPath,
-    manifestFetchCredentials: resolveManifestCredentials(
-      user.manifestFetchCredentials,
-      'VITE_WEB_PLUGIN_MANIFEST_CREDENTIALS',
-      DEF.manifestFetchCredentials
-    ),
-    isDev: user.isDev !== undefined ? user.isDev : resolveBundledIsDev(),
-    webPluginDevOrigin:
-      user.webPluginDevOrigin !== undefined ? user.webPluginDevOrigin : resolveBundledEnv('VITE_WEB_PLUGIN_DEV_ORIGIN', ''),
-    webPluginDevIds:
-      user.webPluginDevIds !== undefined ? user.webPluginDevIds : resolveBundledEnv('VITE_WEB_PLUGIN_DEV_IDS', ''),
-    webPluginDevMapJson:
-      user.webPluginDevMapJson !== undefined
-        ? user.webPluginDevMapJson
-        : resolveBundledEnv('VITE_WEB_PLUGIN_DEV_MAP', ''),
-    webPluginDevEntryPath: ensureLeadingPath(
-      user.webPluginDevEntryPath !== undefined && user.webPluginDevEntryPath !== ''
-        ? user.webPluginDevEntryPath
-        : resolveBundledEnv('VITE_WEB_PLUGIN_DEV_ENTRY', DEF.webPluginDevEntryPath)
-    ),
-    devPingPath: ensureLeadingPath(
-      user.devPingPath !== undefined && user.devPingPath !== ''
-        ? user.devPingPath
-        : resolveBundledEnv('VITE_WEB_PLUGIN_DEV_PING_PATH', DEF.devPingPath)
-    ),
-    devReloadSsePath: ensureLeadingPath(
-      user.devReloadSsePath !== undefined && user.devReloadSsePath !== ''
-        ? user.devReloadSsePath
-        : resolveBundledEnv('VITE_WEB_PLUGIN_DEV_SSE_PATH', DEF.devReloadSsePath)
-    ),
-    devPingTimeoutMs: resolvePositiveInt(user.devPingTimeoutMs, 'VITE_WEB_PLUGIN_DEV_PING_TIMEOUT_MS', DEF.devPingTimeoutMs),
-    defaultImplicitDevPluginIds,
-    allowedScriptHosts,
-    bridgeAllowedPathPrefixes,
-    bootstrapSummary: user.bootstrapSummary,
-    pluginRoutesParentName:
-      user.pluginRoutesParentName !== undefined && String(user.pluginRoutesParentName).trim() !== ''
+    const bridgeAllowedPathPrefixes = Array.isArray(user.bridgeAllowedPathPrefixes) && user.bridgeAllowedPathPrefixes.length > 0
+        ? user.bridgeAllowedPathPrefixes.map((p) => ensureLeadingPath(p)).filter(Boolean)
+        : (() => {
+            const e = resolveBundledEnv(EK.bridgePrefixes, '');
+            if (e) {
+                return e
+                    .split(',')
+                    .map((s) => ensureLeadingPath(s.trim()))
+                    .filter(Boolean);
+            }
+            return [...DEF.bridgeAllowedPathPrefixes];
+        })();
+    const manifestMode = resolveManifestModeFromInputs(user.manifestMode);
+    const staticManifestUrl = resolveStaticManifestUrlFromInputs(user.staticManifestUrl);
+    const isDevResolved = user.isDev !== undefined ? user.isDev : resolveBundledIsDev();
+    const devFallbackStaticManifestUrl = (() => {
+        if (user.devFallbackStaticManifestUrl !== undefined && String(user.devFallbackStaticManifestUrl).trim() !== '') {
+            return String(user.devFallbackStaticManifestUrl).trim();
+        }
+        const e = resolveBundledEnv(EK.devFallbackManifestUrl, '');
+        if (e) {
+            return e.trim();
+        }
+        return String(DEF.devFallbackStaticManifestUrl).trim();
+    })();
+    const hostLayoutComponent = user.hostLayoutComponent;
+    const pluginRoutesParentName = user.pluginRoutesParentName !== undefined && String(user.pluginRoutesParentName).trim() !== ''
         ? String(user.pluginRoutesParentName).trim()
-        : '',
-    ...(typeof user.fetchManifest === 'function' ? { fetchManifest: user.fetchManifest } : {}),
-    ...(typeof user.transformRoutes === 'function' ? { transformRoutes: user.transformRoutes } : {}),
-    ...(typeof user.interceptRegisterRoutes === 'function'
-      ? { interceptRegisterRoutes: user.interceptRegisterRoutes }
-      : {}),
-    ...(typeof user.adaptRouteDeclarations === 'function'
-      ? { adaptRouteDeclarations: user.adaptRouteDeclarations }
-      : {})
-  }
+        : '';
+    const pluginMountRaw = user.pluginMountPath !== undefined && String(user.pluginMountPath).trim() !== ''
+        ? String(user.pluginMountPath).trim()
+        : String(resolveBundledEnv(EK.mountPath, '') || DEF.pluginMountPath).trim();
+    const pluginMountPath = ensureLeadingPath(pluginMountRaw || DEF.pluginMountPath);
+    const pluginHostRouteMeta = user.pluginHostRouteMeta !== undefined && user.pluginHostRouteMeta !== null
+        ? user.pluginHostRouteMeta
+        : undefined;
+    const ensurePluginHostRoute = user.ensurePluginHostRoute === true;
+    const devManifestFallback = (() => {
+        if (manifestMode === 'static') {
+            return false;
+        }
+        if (user.devManifestFallback === false) {
+            return false;
+        }
+        if (user.devManifestFallback === true) {
+            return true;
+        }
+        const envFlag = resolveBundledEnv(EK.devManifestFallback, '');
+        if (envFlag === '0' || envFlag === 'false') {
+            return false;
+        }
+        if (envFlag === '1' || envFlag === 'true') {
+            return true;
+        }
+        return !!isDevResolved;
+    })();
+    return {
+        manifestBase: manifestBaseRaw.replace(/\/$/, '') || DEF.manifestBase.replace(/\/$/, ''),
+        manifestListPath,
+        manifestMode,
+        staticManifestUrl,
+        devManifestFallback,
+        devFallbackStaticManifestUrl,
+        manifestFetchCredentials: resolveManifestCredentials(user.manifestFetchCredentials, EK.manifestCredentials, DEF.manifestFetchCredentials),
+        isDev: isDevResolved,
+        webPluginDevOrigin: user.webPluginDevOrigin !== undefined
+            ? user.webPluginDevOrigin
+            : resolveBundledEnv(EK.webPluginDevOrigin, ''),
+        webPluginDevIds: user.webPluginDevIds !== undefined ? user.webPluginDevIds : resolveBundledEnv(EK.webPluginDevIds, ''),
+        webPluginDevMapJson: user.webPluginDevMapJson !== undefined
+            ? user.webPluginDevMapJson
+            : resolveBundledEnv(EK.webPluginDevMap, ''),
+        webPluginDevEntryPath: ensureLeadingPath(user.webPluginDevEntryPath !== undefined && user.webPluginDevEntryPath !== ''
+            ? user.webPluginDevEntryPath
+            : resolveBundledEnv(EK.devEntry, DEF.webPluginDevEntryPath)),
+        devPingPath: ensureLeadingPath(user.devPingPath !== undefined && user.devPingPath !== ''
+            ? user.devPingPath
+            : resolveBundledEnv(EK.devPing, DEF.devPingPath)),
+        devReloadSsePath: ensureLeadingPath(user.devReloadSsePath !== undefined && user.devReloadSsePath !== ''
+            ? user.devReloadSsePath
+            : resolveBundledEnv(EK.devSse, DEF.devReloadSsePath)),
+        devPingTimeoutMs: resolvePositiveInt(user.devPingTimeoutMs, EK.devPingTimeout, DEF.devPingTimeoutMs),
+        defaultImplicitDevPluginIds,
+        allowedScriptHosts,
+        bridgeAllowedPathPrefixes,
+        bootstrapSummary: user.bootstrapSummary,
+        hostLayoutComponent,
+        pluginMountPath,
+        pluginHostRouteMeta,
+        ensurePluginHostRoute,
+        pluginRoutesParentName,
+        ...(typeof user.fetchManifest === 'function' ? { fetchManifest: user.fetchManifest } : {}),
+        ...(typeof user.transformRoutes === 'function' ? { transformRoutes: user.transformRoutes } : {}),
+        ...(typeof user.interceptRegisterRoutes === 'function'
+            ? { interceptRegisterRoutes: user.interceptRegisterRoutes }
+            : {}),
+        ...(typeof user.adaptRouteDeclarations === 'function'
+            ? { adaptRouteDeclarations: user.adaptRouteDeclarations }
+            : {}),
+        ...(user.hostContext !== undefined &&
+            user.hostContext !== null &&
+            typeof user.hostContext === 'object' &&
+            !Array.isArray(user.hostContext)
+            ? { hostContext: user.hostContext }
+            : {}),
+        ...(typeof user.onBeforePluginActivate === 'function'
+            ? { onBeforePluginActivate: user.onBeforePluginActivate }
+            : {}),
+        ...(typeof user.onAfterPluginActivate === 'function'
+            ? { onAfterPluginActivate: user.onAfterPluginActivate }
+            : {}),
+        ...(typeof user.onPluginActivateError === 'function'
+            ? { onPluginActivateError: user.onPluginActivateError }
+            : {})
+    };
 }
 
 /**
- * 未配置 `fetchManifest` 时使用的清单 `fetch` 实现。
- * @param {{ manifestUrl: string, credentials: RequestCredentials }} ctx
+ * 将裸 `{ plugins }` 与 `{ code, data: { plugins } }` 式响应解包为清单对象。
  */
+function unwrapNestedManifestBody(body) {
+    if (!body || typeof body !== 'object') {
+        return null;
+    }
+    const o = body;
+    if (Array.isArray(o.plugins)) {
+        return o;
+    }
+    const d = o.data;
+    if (d && typeof d === 'object') {
+        const inner = d;
+        if (Array.isArray(inner.plugins)) {
+            return inner;
+        }
+        if ('plugins' in inner) {
+            return inner;
+        }
+    }
+    return d !== undefined && d !== null && typeof d === 'object' ? d : o;
+}
+
 async function defaultFetchWebPluginManifest$1(ctx) {
-  const { manifestUrl, credentials } = ctx;
-  try {
-    const res = await fetch(manifestUrl, { credentials });
-    if (!res.ok) {
-      return { ok: false, status: res.status, data: null }
-    }
-    const data = await res.json();
-    return { ok: true, data }
-  } catch (e) {
-    return { ok: false, error: e, data: null }
-  }
+    const { manifestUrl, credentials } = ctx;
+    try {
+        const res = await fetch(manifestUrl, { credentials });
+        if (!res.ok) {
+            return { ok: false, status: res.status, data: null };
+        }
+        const body = await res.json();
+        const data = unwrapNestedManifestBody(body);
+        if (!data || typeof data !== 'object') {
+            return {
+                ok: false,
+                error: new Error('[wep] invalid manifest response body'),
+                data: null
+            };
+        }
+        return { ok: true, data };
+    }
+    catch (e) {
+        return { ok: false, error: e, data: null };
+    }
 }
 
 function getDefaultExportFromCjs (x) {
@@ -3106,1336 +3207,1442 @@ function requireSemver () {
 var semverExports = requireSemver();
 var semver = /*@__PURE__*/getDefaultExportFromCjs(semverExports);
 
-/** 与清单服务 `hostPluginApiVersion` 对齐，用于 `semver` 校验。 */
-const HOST_PLUGIN_API_VERSION = '1.0.0';
-
-/** 控制台日志与横幅使用的短名称。 */
-const RUNTIME_CONSOLE_LABEL = 'web-extend-plugin-vue2';
-
 /**
- * 开发模式插件 URL 映射（显式 JSON + 隐式 dev 探测）。
- * @module runtime/dev-map
+ * 引导时注入的 router 引用，供 disposeWebPlugin 按插件批量 removeRoute。
  */
+// 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;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getPluginBootstrapRouter() {
+    return bootstrapRouter;
+}
 
 /**
- * @param {{ isDev: boolean, webPluginDevMapJson?: string|null }} opts
+ * 开发模式插件 URL 映射（显式 JSON + 隐式 dev 探测）。
  */
 function parseWebPluginDevMapExplicit(opts) {
-  if (!opts.isDev) {
-    return null
-  }
-  const raw = opts.webPluginDevMapJson;
-  if (raw === undefined || raw === null || String(raw).trim() === '') {
-    return null
-  }
-  try {
-    const map = JSON.parse(String(raw));
-    return map && typeof map === 'object' ? map : null
-  } catch {
-    console.warn('[wep] invalid webPluginDevMapJson / VITE_WEB_PLUGIN_DEV_MAP');
-    return null
-  }
+    if (!opts.isDev) {
+        return null;
+    }
+    const raw = opts.webPluginDevMapJson;
+    if (raw === undefined || raw === null || String(raw).trim() === '') {
+        return null;
+    }
+    try {
+        const map = JSON.parse(String(raw));
+        return map && typeof map === 'object' ? map : null;
+    }
+    catch {
+        console.warn('[wep] invalid webPluginDevMapJson / VITE_WEB_PLUGIN_DEV_MAP');
+        return null;
+    }
 }
-
-/**
- * @param {Record<string, string>} implicit
- * @param {Record<string, string>|null} explicit
- */
 function mergeDevMaps(implicit, explicit) {
-  const i = implicit && typeof implicit === 'object' ? implicit : {};
-  const e = explicit && typeof explicit === 'object' ? explicit : {};
-  return { ...i, ...e }
+    const i = implicit && typeof implicit === 'object' ? implicit : {};
+    const e = explicit && typeof explicit === 'object' ? explicit : {};
+    return { ...i, ...e };
 }
-
-/**
- * @param {object} opts
- * @param {boolean} opts.isDev
- * @param {string|undefined|null} opts.webPluginDevOrigin
- * @param {string|undefined|null} opts.webPluginDevIds
- * @param {string[]} opts.defaultImplicitDevPluginIds
- * @param {string} opts.devPingPath
- * @param {number} opts.devPingTimeoutMs
- * @param {string} opts.webPluginDevEntryPath
- * @param {Set<string>} hostSet
- */
 async function buildImplicitWebPluginDevMap(opts, hostSet) {
-  if (!opts.isDev) {
-    return {}
-  }
-  const origin =
-    opts.webPluginDevOrigin === undefined || opts.webPluginDevOrigin === null
-      ? ''
-      : String(opts.webPluginDevOrigin).trim();
-  if (!origin) {
-    return {}
-  }
-  if (!isScriptHostAllowed(`${origin}/`, hostSet)) {
-    return {}
-  }
-
-  const idsRaw = opts.webPluginDevIds;
-  const ids =
-    idsRaw !== undefined && idsRaw !== null && String(idsRaw).trim() !== ''
-      ? String(idsRaw)
-          .split(',')
-          .map((s) => s.trim())
-          .filter(Boolean)
-      : [...opts.defaultImplicitDevPluginIds];
-
-  if (ids.length === 0) {
-    return {}
-  }
-
-  const base = origin.replace(/\/$/, '');
-  const pingUrl = `${base}${opts.devPingPath}`;
-  try {
-    const ctrl = new AbortController();
-    const timer = setTimeout(() => ctrl.abort(), opts.devPingTimeoutMs);
-    const r = await fetch(pingUrl, {
-      mode: 'cors',
-      cache: 'no-store',
-      signal: ctrl.signal
-    });
-    clearTimeout(timer);
-    if (!r.ok) {
-      return {}
-    }
-    const body = (await r.text()).trim();
-    if (body !== 'ok') {
-      return {}
-    }
-  } catch {
-    return {}
-  }
-
-  const pathPart = opts.webPluginDevEntryPath;
-  const map = {};
-  for (const id of ids) {
-    map[id] = `${base}${pathPart}`;
-  }
-  if (ids.length) {
-    console.info('[wep] plugin dev server', base, '→ implicit entries', pathPart, ids.join(', '));
-  }
-  return map
+    if (!opts.isDev) {
+        return {};
+    }
+    const origin = opts.webPluginDevOrigin === undefined || opts.webPluginDevOrigin === null
+        ? ''
+        : String(opts.webPluginDevOrigin).trim();
+    if (!origin) {
+        return {};
+    }
+    if (!isScriptHostAllowed(`${origin}/`, hostSet)) {
+        return {};
+    }
+    const idsRaw = opts.webPluginDevIds;
+    const ids = idsRaw !== undefined && idsRaw !== null && String(idsRaw).trim() !== ''
+        ? String(idsRaw)
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : [...opts.defaultImplicitDevPluginIds];
+    if (ids.length === 0) {
+        return {};
+    }
+    const base = origin.replace(/\/$/, '');
+    const pingUrl = `${base}${opts.devPingPath}`;
+    try {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), opts.devPingTimeoutMs);
+        const r = await fetch(pingUrl, {
+            mode: 'cors',
+            cache: 'no-store',
+            signal: ctrl.signal
+        });
+        clearTimeout(timer);
+        if (!r.ok) {
+            return {};
+        }
+        const body = (await r.text()).trim();
+        if (body !== 'ok') {
+            return {};
+        }
+    }
+    catch {
+        return {};
+    }
+    const pathPart = opts.webPluginDevEntryPath;
+    const map = {};
+    for (const id of ids) {
+        map[id] = `${base}${pathPart}`;
+    }
+    if (ids.length) {
+        console.info('[wep] plugin dev server', base, '→ implicit entries', pathPart, ids.join(', '));
+    }
+    return map;
 }
 
 /**
  * 开发模式下插件热更新 SSE（按 dev 映射中的 origin 连接）。
- * @module runtime/dev-reload-sse
  */
-
-/** @type {Map<string, EventSource>} */
 const pluginDevEventSources = new Map();
-
 let pluginDevBeforeUnloadRegistered = false;
-
 function closeAllPluginDevEventSources() {
-  for (const es of pluginDevEventSources.values()) {
-    try {
-      es.close();
-    } catch (_) {}
-  }
-  pluginDevEventSources.clear();
+    for (const es of pluginDevEventSources.values()) {
+        try {
+            es.close();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    pluginDevEventSources.clear();
 }
-
 function ensurePluginDevBeforeUnload() {
-  if (pluginDevBeforeUnloadRegistered || typeof window === 'undefined') {
-    return
-  }
-  pluginDevBeforeUnloadRegistered = true;
-  window.addEventListener('beforeunload', closeAllPluginDevEventSources);
+    if (pluginDevBeforeUnloadRegistered || typeof window === 'undefined') {
+        return;
+    }
+    pluginDevBeforeUnloadRegistered = true;
+    window.addEventListener('beforeunload', closeAllPluginDevEventSources);
 }
-
-/**
- * @param {string} origin
- * @param {Set<string>} hostSet
- */
 function isDevOriginAllowedForSse(origin, hostSet) {
-  try {
-    const u = new URL(origin);
-    return hostSet.has(normalizeHost(u.hostname))
-  } catch {
-    return false
-  }
+    try {
+        const u = new URL(origin);
+        return hostSet.has(normalizeHost(u.hostname));
+    }
+    catch {
+        return false;
+    }
 }
-
-/**
- * @param {string} origin
- * @param {boolean} isDev
- * @param {Set<string>} hostSet
- * @param {string} ssePath
- */
 function startPluginDevReloadSse(origin, isDev, hostSet, ssePath) {
-  if (!isDev || pluginDevEventSources.has(origin)) {
-    return
-  }
-  if (!isDevOriginAllowedForSse(origin, hostSet)) {
-    return
-  }
-  ensurePluginDevBeforeUnload();
-  const base = origin.replace(/\/$/, '');
-  const url = `${base}${ssePath}`;
-  try {
-    const es = new EventSource(url);
-    pluginDevEventSources.set(origin, es);
-    es.addEventListener('reload', () => {
-      window.location.reload();
-    });
-    es.onopen = () => {
-      console.info('[wep] dev reload SSE', url);
-    };
-  } catch (e) {
-    console.warn('[wep] EventSource failed', url, e);
-  }
+    if (!isDev || pluginDevEventSources.has(origin)) {
+        return;
+    }
+    if (!isDevOriginAllowedForSse(origin, hostSet)) {
+        return;
+    }
+    ensurePluginDevBeforeUnload();
+    const base = origin.replace(/\/$/, '');
+    const url = `${base}${ssePath}`;
+    try {
+        const es = new EventSource(url);
+        pluginDevEventSources.set(origin, es);
+        es.addEventListener('reload', () => {
+            window.location.reload();
+        });
+        es.onopen = () => {
+            console.info('[wep] dev reload SSE', url);
+        };
+    }
+    catch (e) {
+        console.warn('[wep] EventSource failed', url, e);
+    }
 }
-
-/**
- * @param {Record<string, string>|null|undefined} devMap
- * @param {boolean} isDev
- * @param {Set<string>} hostSet
- * @param {string} ssePath
- */
 function startPluginDevSseForMap(devMap, isDev, hostSet, ssePath) {
-  if (!isDev || !devMap || typeof window === 'undefined') {
-    return
-  }
-  const origins = new Set();
-  for (const entry of Object.values(devMap)) {
-    if (typeof entry !== 'string') {
-      continue
-    }
-    const t = entry.trim();
-    if (!t) {
-      continue
+    if (!isDev || !devMap || typeof window === 'undefined') {
+        return;
+    }
+    const origins = new Set();
+    for (const entry of Object.values(devMap)) {
+        if (typeof entry !== 'string') {
+            continue;
+        }
+        const t = entry.trim();
+        if (!t) {
+            continue;
+        }
+        try {
+            origins.add(new URL(t, window.location.href).origin);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    for (const o of origins) {
+        startPluginDevReloadSse(o, isDev, hostSet, ssePath);
     }
-    try {
-      origins.add(new URL(t, window.location.href).origin);
-    } catch {
-      /* skip */
-    }
-  }
-  for (const o of origins) {
-    startPluginDevReloadSse(o, isDev, hostSet, ssePath);
-  }
 }
 
 /**
  * 动态加载脚本（去重与并发合并）。
- * @module runtime/load-script
  */
-
 const loadScriptMemo = new Map();
-
-/**
- * @param {string} src
- * @returns {Promise<void>}
- */
 function loadScript(src) {
-  if (typeof document === 'undefined') {
-    return Promise.reject(new Error('loadScript: no document'))
-  }
-  if (loadScriptMemo.has(src)) {
-    return loadScriptMemo.get(src)
-  }
-  const p = new Promise((resolve, reject) => {
-    const scripts = document.getElementsByTagName('script');
-    for (let i = 0; i < scripts.length; i++) {
-      const el = scripts[i];
-      if (el.src === src) {
-        if (el.getAttribute('data-wep-loaded') === 'true') {
-          resolve();
-          return
+    if (typeof document === 'undefined') {
+        return Promise.reject(new Error('loadScript: no document'));
+    }
+    if (loadScriptMemo.has(src)) {
+        return loadScriptMemo.get(src);
+    }
+    const p = new Promise((resolve, reject) => {
+        const scripts = document.getElementsByTagName('script');
+        for (let i = 0; i < scripts.length; i++) {
+            const el = scripts[i];
+            if (el.src === src) {
+                if (el.getAttribute('data-wep-loaded') === 'true') {
+                    resolve();
+                    return;
+                }
+                el.addEventListener('load', () => {
+                    el.setAttribute('data-wep-loaded', 'true');
+                    resolve();
+                }, { once: true });
+                el.addEventListener('error', () => reject(new Error('loadScript failed: ' + src)), { once: true });
+                return;
+            }
         }
-        el.addEventListener(
-          'load',
-          () => {
-            el.setAttribute('data-wep-loaded', 'true');
+        const s = document.createElement('script');
+        s.async = true;
+        s.src = src;
+        s.onload = () => {
+            s.setAttribute('data-wep-loaded', 'true');
             resolve();
-          },
-          { once: true }
-        );
-        el.addEventListener('error', () => reject(new Error('loadScript failed: ' + src)), { once: true });
-        return
-      }
-    }
-    const s = document.createElement('script');
-    s.async = true;
-    s.src = src;
-    s.onload = () => {
-      s.setAttribute('data-wep-loaded', 'true');
-      resolve();
-    };
-    s.onerror = () => reject(new Error('loadScript failed: ' + src));
-    document.head.appendChild(s);
-  });
-  loadScriptMemo.set(src, p);
-  p.catch(() => loadScriptMemo.delete(src));
-  return p
+        };
+        s.onerror = () => reject(new Error('loadScript failed: ' + src));
+        document.head.appendChild(s);
+    });
+    loadScriptMemo.set(src, p);
+    p.catch(() => loadScriptMemo.delete(src));
+    return p;
 }
 
 let _printed = false;
-
 /** 在首次引导插件时打印一行运行时标识（非大块 ASCII art）。 */
 function printRuntimeBannerOnce() {
-  if (_printed) {
-    return
-  }
-  _printed = true;
-  if (typeof console !== 'undefined' && typeof console.info === 'function') {
-    console.info(`[wep] ${RUNTIME_CONSOLE_LABEL} · host API ${HOST_PLUGIN_API_VERSION}`);
-  }
+    if (_printed) {
+        return;
+    }
+    _printed = true;
+    if (typeof console !== 'undefined' && typeof console.info === 'function') {
+        console.info(`[wep] ${RUNTIME_CONSOLE_LABEL} · host API ${HOST_PLUGIN_API_VERSION}`);
+    }
 }
 
 /**
- * 拉取插件清单、加载入口脚本并调用各插件 `activator`。
+ * 浏览器 fetch 静态 JSON 清单（与 defaultFetchWebPluginManifest 相同解包规则）。
  */
+async function fetchStaticManifestViaHttp(ctx) {
+    const { manifestUrl, credentials } = ctx;
+    try {
+        const creds = credentials === 'omit' ? 'omit' : 'same-origin';
+        const res = await fetch(manifestUrl, {
+            method: 'GET',
+            credentials: creds,
+            cache: 'no-store'
+        });
+        if (!res.ok) {
+            return {
+                ok: false,
+                status: res.status,
+                error: new Error('[wep] static manifest HTTP ' + res.status),
+                data: null
+            };
+        }
+        const body = await res.json();
+        const data = unwrapNestedManifestBody(body);
+        if (!data || typeof data !== 'object') {
+            return {
+                ok: false,
+                error: new Error('[wep] invalid static manifest JSON'),
+                data: null
+            };
+        }
+        return { ok: true, data };
+    }
+    catch (e) {
+        return { ok: false, error: e, data: null };
+    }
+}
 
 /**
- * @param {import('./resolve-runtime-options.js').WebExtendPluginRuntimeOptions|object} opts
+ * 当 `ensurePluginHostRoute === true` 且提供 `pluginRoutesParentName` + `hostLayoutComponent` 时，
+ * 注册 `pluginMountPath` + Layout 的命名父路由，供 `router.addRoute(parentName, child)` 挂载插件页。
  */
-function shouldShowBootstrapSummary(opts) {
-  if (opts.bootstrapSummary === true) {
-    return true
-  }
-  if (opts.bootstrapSummary === false) {
-    return false
-  }
-  const env = resolveBundledEnv('VITE_PLUGINS_BOOTSTRAP_SUMMARY', '');
-  if (env === '0' || env === 'false') {
-    return false
-  }
-  if (env === '1' || env === 'true') {
-    return true
-  }
-  return resolveBundledIsDev()
+function routeNameExists(router, name) {
+    if (!name) {
+        return false;
+    }
+    if (typeof router.getRoutes === 'function') {
+        return router.getRoutes().some((r) => r.name === name);
+    }
+    return walkRouteNames(router.options && router.options.routes, name);
+}
+function walkRouteNames(routes, name) {
+    if (!Array.isArray(routes)) {
+        return false;
+    }
+    for (const r of routes) {
+        if (r && typeof r === 'object' && r.name === name) {
+            return true;
+        }
+        const ch = r && typeof r === 'object' ? r.children : null;
+        if (walkRouteNames(ch, name)) {
+            return true;
+        }
+    }
+    return false;
+}
+function ensurePluginHostRoute$1(router, opts) {
+    if (opts.ensurePluginHostRoute !== true) {
+        return;
+    }
+    if (!router || typeof router.addRoute !== 'function') {
+        return;
+    }
+    const parentName = String(opts.pluginRoutesParentName || '').trim();
+    if (!parentName) {
+        return;
+    }
+    if (routeNameExists(router, parentName)) {
+        return;
+    }
+    const Layout = opts.hostLayoutComponent;
+    if (!Layout) {
+        console.warn('[wep] 缺少 hostLayoutComponent，未自动注册插件壳路由；请传入宿主 Layout，或在路由表中自行配置与 pluginRoutesParentName 一致的父路由');
+        return;
+    }
+    const mountDefault = defaultWebExtendPluginRuntime.pluginMountPath;
+    let pathRaw = String(opts.pluginMountPath || mountDefault).trim().replace(/\/$/, '') || mountDefault;
+    if (!pathRaw.startsWith('/')) {
+        pathRaw = `/${pathRaw}`;
+    }
+    const meta = opts.pluginHostRouteMeta && typeof opts.pluginHostRouteMeta === 'object'
+        ? { ...opts.pluginHostRouteMeta }
+        : { requiresConfig: true, hidden: true };
+    router.addRoute({
+        path: pathRaw,
+        name: parentName,
+        component: Layout,
+        redirect: 'noredirect',
+        meta,
+        children: []
+    });
 }
 
 /**
- * @param {{ id: string }} p
- * @param {string} [entryUrl]
- * @param {Record<string, string>|null|undefined} devMap
- * @param {Set<string>} hostSet
+ * 宿主通过 `resolveRuntimeOptions({ hostContext })` 注入的只读上下文，
+ * 经浅拷贝 + 浅冻结后挂到 `hostApi.hostContext`，供插件访问 store/i18n 等而不污染 HostApi 顶层命名。
  */
-async function loadPluginEntry(p, entryUrl, devMap, hostSet) {
-  const devEntry = devMap && typeof devMap[p.id] === 'string' ? devMap[p.id].trim() : '';
-  if (devEntry) {
-    if (!isScriptHostAllowed(devEntry, hostSet)) {
-      console.warn('[wep] dev entry URL not allowed', p.id, devEntry);
-      return
+function freezeShallowHostContext(input) {
+    if (input == null || typeof input !== 'object' || Array.isArray(input)) {
+        return Object.freeze({});
+    }
+    return Object.freeze({ ...input });
+}
+
+/**
+ * 将静态清单配置路径解析为用于 fetch 的绝对 URL（浏览器）。
+ */
+function resolveStaticManifestUrlForFetch(url, origin) {
+    const u = String(url || '').trim();
+    if (!u) {
+        return '';
+    }
+    if (/^https?:\/\//i.test(u)) {
+        return u;
+    }
+    const o = String(origin || '').trim();
+    if (!o) {
+        return u.startsWith('/') ? u : `/${u}`;
     }
     try {
-      await import(
-        /* webpackIgnore: true */
-        /* @vite-ignore */
-        devEntry
-      );
-    } catch (e) {
-      console.warn('[wep] dev import failed, trying manifest entryUrl', p.id, e);
-      if (entryUrl && isScriptHostAllowed(entryUrl, hostSet)) {
-        await loadScript(entryUrl);
-      }
-      return
-    }
-    return
-  }
-  if (!entryUrl || !isScriptHostAllowed(entryUrl, hostSet)) {
-    console.warn('[wep] skip (entryUrl not allowed)', p.id, entryUrl);
-    return
-  }
-  await loadScript(entryUrl);
+        const pathPart = u.startsWith('/') ? u : `/${u}`;
+        return new URL(pathPart, o).href;
+    }
+    catch {
+        return u;
+    }
 }
 
 /**
- * @param {import('vue-router').default} router
- * @param {(pluginId: string, router: import('vue-router').default, hostKit?: object) => object} createHostApiFactory
- * @param {import('./resolve-runtime-options.js').WebExtendPluginRuntimeOptions} [runtimeOptions]
+ * 拉取插件清单、加载入口脚本并调用各插件 `activator`。
  */
-async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions) {
-  if (typeof window === 'undefined') {
-    console.warn('[wep] bootstrapPlugins skipped (no window)');
-    return
-  }
-  printRuntimeBannerOnce();
-  const opts = resolveRuntimeOptions$1(runtimeOptions || {});
-  const base = String(opts.manifestBase).replace(/\/$/, '');
-  const manifestUrl = `${base}${opts.manifestListPath}`;
-  const hostSet = buildAllowedScriptHostsSet(opts.allowedScriptHosts);
-  const explicit = parseWebPluginDevMapExplicit(opts);
-
-  const manifestCtx = {
-    manifestUrl,
-    credentials: opts.manifestFetchCredentials
-  };
-  const [manifestResult, implicit] = await Promise.all([
-    (async () => {
-      try {
-        if (typeof opts.fetchManifest === 'function') {
-          return await opts.fetchManifest(manifestCtx)
+function shouldShowBootstrapSummary(opts) {
+    if (opts.bootstrapSummary === true) {
+        return true;
+    }
+    if (opts.bootstrapSummary === false) {
+        return false;
+    }
+    const env = resolveBundledEnv(webExtendPluginEnvKeys.pluginsBootstrapSummary, '');
+    if (env === '0' || env === 'false') {
+        return false;
+    }
+    if (env === '1' || env === 'true') {
+        return true;
+    }
+    return resolveBundledIsDev();
+}
+async function loadPluginEntry(p, entryUrl, devMap, hostSet) {
+    const devEntry = devMap && typeof devMap[p.id] === 'string' ? devMap[p.id].trim() : '';
+    if (devEntry) {
+        if (!isScriptHostAllowed(devEntry, hostSet)) {
+            console.warn('[wep] dev entry URL not allowed', p.id, devEntry);
+            return;
+        }
+        try {
+            await import(
+            /* webpackIgnore: true */
+            /* @vite-ignore */
+            devEntry);
+        }
+        catch (e) {
+            console.warn('[wep] dev import failed, trying manifest entryUrl', p.id, e);
+            if (entryUrl && isScriptHostAllowed(entryUrl, hostSet)) {
+                await loadScript(entryUrl);
+            }
+            return;
         }
-        return await defaultFetchWebPluginManifest$1(manifestCtx)
-      } catch (e) {
-        return { ok: false, error: e, data: null }
-      }
-    })(),
-    buildImplicitWebPluginDevMap(opts, hostSet)
-  ]);
-
-  const devMap = mergeDevMaps(implicit, explicit);
-  startPluginDevSseForMap(devMap, opts.isDev, hostSet, opts.devReloadSsePath);
-
-  const hostKit = {
-    bridgeAllowedPathPrefixes: opts.bridgeAllowedPathPrefixes,
-    ...(opts.pluginRoutesParentName
-      ? { pluginRoutesParentName: opts.pluginRoutesParentName }
-      : {}),
-    ...(typeof opts.transformRoutes === 'function' ? { transformRoutes: opts.transformRoutes } : {}),
-    ...(typeof opts.interceptRegisterRoutes === 'function'
-      ? { interceptRegisterRoutes: opts.interceptRegisterRoutes }
-      : {}),
-    ...(typeof opts.adaptRouteDeclarations === 'function'
-      ? { adaptRouteDeclarations: opts.adaptRouteDeclarations }
-      : {})
-  };
-
-  if (!manifestResult.ok) {
-    if (manifestResult.error) {
-      console.warn('[wep] fetch manifest failed', manifestResult.error);
-    } else {
-      console.warn('[wep] manifest HTTP', manifestResult.status, manifestUrl);
+        return;
     }
-    if (shouldShowBootstrapSummary(opts)) {
-      console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_fetch' });
+    if (!entryUrl || !isScriptHostAllowed(entryUrl, hostSet)) {
+        console.warn('[wep] skip (entryUrl not allowed)', p.id, entryUrl);
+        return;
+    }
+    await loadScript(entryUrl);
+}
+async function bootstrapPlugins$1(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+router, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+createHostApiFactory, runtimeOptions) {
+    if (typeof window === 'undefined') {
+        console.warn('[wep] bootstrapPlugins skipped (no window)');
+        return;
+    }
+    printRuntimeBannerOnce();
+    const opts = resolveRuntimeOptions$1(runtimeOptions || {});
+    setPluginBootstrapRouter(router);
+    ensurePluginHostRoute$1(router, opts);
+    const base = String(opts.manifestBase).replace(/\/$/, '');
+    const isStatic = opts.manifestMode === 'static';
+    let manifestUrl;
+    if (isStatic) {
+        const raw = String(opts.staticManifestUrl || '').trim();
+        if (!raw) {
+            console.warn('[wep] manifestMode=static requires non-empty staticManifestUrl (or env VITE_WEB_PLUGIN_STATIC_MANIFEST_URL)');
+            if (shouldShowBootstrapSummary(opts)) {
+                console.info('[wep] bootstrap_summary', { ok: false, reason: 'static_manifest_url_missing' });
+            }
+            return;
+        }
+        manifestUrl = resolveStaticManifestUrlForFetch(raw, window.location.origin);
+    }
+    else {
+        manifestUrl = `${base}${opts.manifestListPath}`;
+    }
+    const hostSet = buildAllowedScriptHostsSet(opts.allowedScriptHosts);
+    const explicit = parseWebPluginDevMapExplicit(opts);
+    const manifestCtx = {
+        manifestUrl,
+        credentials: opts.manifestFetchCredentials
+    };
+    const [primaryResult, implicit] = await Promise.all([
+        (async () => {
+            try {
+                if (typeof opts.fetchManifest === 'function') {
+                    return await opts.fetchManifest(manifestCtx);
+                }
+                return await defaultFetchWebPluginManifest$1(manifestCtx);
+            }
+            catch (e) {
+                return { ok: false, error: e, data: null };
+            }
+        })(),
+        buildImplicitWebPluginDevMap(opts, hostSet)
+    ]);
+    let manifestResult = primaryResult;
+    let manifestUrlUsed = manifestUrl;
+    if (!isStatic && opts.devManifestFallback && opts.isDev) {
+        const dataObj = primaryResult.ok && primaryResult.data && typeof primaryResult.data === 'object'
+            ? primaryResult.data
+            : null;
+        const plen = dataObj && Array.isArray(dataObj.plugins) ? dataObj.plugins.length : 0;
+        const needFallback = !primaryResult.ok || plen === 0;
+        const fallbackRaw = String(opts.devFallbackStaticManifestUrl || '').trim();
+        if (needFallback && fallbackRaw) {
+            const fallbackUrl = resolveStaticManifestUrlForFetch(fallbackRaw, window.location.origin);
+            const fallbackCtx = {
+                manifestUrl: fallbackUrl,
+                credentials: opts.manifestFetchCredentials
+            };
+            const fr = await fetchStaticManifestViaHttp(fallbackCtx);
+            const fdata = fr.ok && fr.data && typeof fr.data === 'object' ? fr.data : null;
+            const flen = fdata && Array.isArray(fdata.plugins) ? fdata.plugins.length : 0;
+            if (fr.ok && flen > 0) {
+                manifestResult = fr;
+                manifestUrlUsed = fallbackUrl;
+                console.info('[wep] dev manifest fallback', { url: fallbackUrl, plugins: flen });
+            }
+        }
+    }
+    const devMap = mergeDevMaps(implicit, explicit);
+    startPluginDevSseForMap(devMap, opts.isDev, hostSet, opts.devReloadSsePath);
+    const frozenHostContext = freezeShallowHostContext(opts.hostContext !== undefined ? opts.hostContext : undefined);
+    const hostKit = {
+        hostContext: frozenHostContext,
+        bridgeAllowedPathPrefixes: opts.bridgeAllowedPathPrefixes,
+        ...(opts.pluginRoutesParentName ? { pluginRoutesParentName: opts.pluginRoutesParentName } : {}),
+        ...(typeof opts.transformRoutes === 'function' ? { transformRoutes: opts.transformRoutes } : {}),
+        ...(typeof opts.interceptRegisterRoutes === 'function'
+            ? { interceptRegisterRoutes: opts.interceptRegisterRoutes }
+            : {}),
+        ...(typeof opts.adaptRouteDeclarations === 'function'
+            ? { adaptRouteDeclarations: opts.adaptRouteDeclarations }
+            : {})
+    };
+    if (!manifestResult.ok) {
+        if (manifestResult.error) {
+            console.warn('[wep] fetch manifest failed', manifestResult.error);
+        }
+        else {
+            const label = isStatic ? 'static manifest' : 'manifest HTTP';
+            console.warn(`[wep] ${label}`, manifestResult.status, manifestUrlUsed);
+        }
+        if (shouldShowBootstrapSummary(opts)) {
+            console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_fetch' });
+        }
+        return;
+    }
+    const data = manifestResult.data;
+    if (!data) {
+        if (shouldShowBootstrapSummary(opts)) {
+            console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_empty_body' });
+        }
+        return;
+    }
+    const apiVer = data.hostPluginApiVersion;
+    if (apiVer) {
+        const coerced = semver.coerce(apiVer);
+        const maj = coerced ? coerced.major : 0;
+        const range = `^${maj}.0.0`;
+        if (!semver.satisfies(HOST_PLUGIN_API_VERSION, range, { includePrerelease: true })) {
+            console.warn('[wep] host API version mismatch', {
+                host: HOST_PLUGIN_API_VERSION,
+                manifest: apiVer
+            });
+        }
+    }
+    window.__PLUGIN_ACTIVATORS__ = window.__PLUGIN_ACTIVATORS__ || {};
+    const plugins = data.plugins || [];
+    if (plugins.length === 0) {
+        const hint = isStatic ? 'check static JSON file and plugins[]' : 'check backend and URL';
+        console.info('[wep] empty plugin manifest — ' + hint, manifestUrlUsed);
+    }
+    const summary = {
+        manifestCount: plugins.length,
+        activated: 0,
+        skipEngines: 0,
+        skipLoad: 0,
+        skipNoActivator: 0,
+        activateFail: 0
+    };
+    for (const p of plugins) {
+        const range = p.engines && p.engines.host;
+        if (range && !semver.satisfies(HOST_PLUGIN_API_VERSION, range, { includePrerelease: true })) {
+            console.warn('[wep] skip plugin (engines.host)', p.id, range);
+            summary.skipEngines++;
+            continue;
+        }
+        const entryUrl = p.entryUrl;
+        try {
+            await loadPluginEntry(p, entryUrl, devMap, hostSet);
+        }
+        catch (e) {
+            console.warn('[wep] script load failed', p.id, e);
+            summary.skipLoad++;
+            continue;
+        }
+        const activator = window.__PLUGIN_ACTIVATORS__[p.id];
+        if (typeof activator !== 'function') {
+            console.warn('[wep] no activator for', p.id);
+            summary.skipNoActivator++;
+            continue;
+        }
+        const pluginRecord = Object.freeze({ ...p });
+        try {
+            if (typeof opts.onBeforePluginActivate === 'function') {
+                await Promise.resolve(opts.onBeforePluginActivate({
+                    pluginId: p.id,
+                    router,
+                    pluginRecord
+                }));
+            }
+        }
+        catch (e) {
+            console.warn('[wep] activate skipped (onBeforePluginActivate)', p.id, e);
+            summary.activateFail++;
+            continue;
+        }
+        const hostApi = createHostApiFactory(p.id, router, hostKit);
+        try {
+            await Promise.resolve(activator(hostApi, { pluginRecord }));
+            summary.activated++;
+            if (typeof opts.onAfterPluginActivate === 'function') {
+                await Promise.resolve(opts.onAfterPluginActivate({
+                    pluginId: p.id,
+                    router,
+                    pluginRecord,
+                    hostApi
+                }));
+            }
+        }
+        catch (e) {
+            console.error('[wep] activate failed', p.id, e);
+            summary.activateFail++;
+            if (typeof opts.onPluginActivateError === 'function') {
+                try {
+                    await Promise.resolve(opts.onPluginActivateError({
+                        pluginId: p.id,
+                        error: e,
+                        pluginRecord,
+                        hostApi
+                    }));
+                }
+                catch (hookErr) {
+                    console.warn('[wep] onPluginActivateError hook failed', p.id, hookErr);
+                }
+            }
+        }
     }
-    return
-  }
-  /** @type {{ hostPluginApiVersion?: string, plugins?: object[] }} */
-  const data = manifestResult.data;
-  if (!data) {
     if (shouldShowBootstrapSummary(opts)) {
-      console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_empty_body' });
-    }
-    return
-  }
-
-  const apiVer = data.hostPluginApiVersion;
-  if (apiVer) {
-    const coerced = semver.coerce(apiVer);
-    const maj = coerced ? coerced.major : 0;
-    const range = `^${maj}.0.0`;
-    if (!semver.satisfies(HOST_PLUGIN_API_VERSION, range, { includePrerelease: true })) {
-      console.warn('[wep] host API version mismatch', {
-        host: HOST_PLUGIN_API_VERSION,
-        manifest: apiVer
-      });
-    }
-  }
-
-  window.__PLUGIN_ACTIVATORS__ = window.__PLUGIN_ACTIVATORS__ || {};
-
-  const plugins = data.plugins || [];
-  if (plugins.length === 0) {
-    console.info('[wep] empty plugin manifest — check backend and URL', manifestUrl);
-  }
-
-  const summary = {
-    manifestCount: plugins.length,
-    activated: 0,
-    skipEngines: 0,
-    skipLoad: 0,
-    skipNoActivator: 0,
-    activateFail: 0
-  };
-
-  for (const p of plugins) {
-    const range = p.engines && p.engines.host;
-    if (range && !semver.satisfies(HOST_PLUGIN_API_VERSION, range, { includePrerelease: true })) {
-      console.warn('[wep] skip plugin (engines.host)', p.id, range);
-      summary.skipEngines++;
-      continue
-    }
-    const entryUrl = p.entryUrl;
-    try {
-      await loadPluginEntry(p, entryUrl, devMap, hostSet);
-    } catch (e) {
-      console.warn('[wep] script load failed', p.id, e);
-      summary.skipLoad++;
-      continue
-    }
-    const activator = window.__PLUGIN_ACTIVATORS__[p.id];
-    if (typeof activator !== 'function') {
-      console.warn('[wep] no activator for', p.id);
-      summary.skipNoActivator++;
-      continue
-    }
-    const hostApi = createHostApiFactory(p.id, router, hostKit);
-    try {
-      const pluginRecord = Object.freeze({ ...p });
-      activator(hostApi, { pluginRecord });
-      summary.activated++;
-    } catch (e) {
-      console.error('[wep] activate failed', p.id, e);
-      summary.activateFail++;
-    }
-  }
-
-  if (shouldShowBootstrapSummary(opts)) {
-    console.info('[wep] bootstrap_summary', { ok: true, ...summary });
-  }
+        console.info('[wep] bootstrap_summary', { ok: true, ...summary });
+    }
 }
 
 /**
- * 运行时引导相关 API 的聚合导出（实现位于 `./runtime/`）。
+ * 运行时引导相关 API 的聚合导出。
  */
 
 var pluginRuntime = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  bootstrapPlugins: bootstrapPlugins$1,
-  defaultFetchWebPluginManifest: defaultFetchWebPluginManifest$1,
-  resolveRuntimeOptions: resolveRuntimeOptions$1
+    __proto__: null,
+    bootstrapPlugins: bootstrapPlugins$1,
+    defaultFetchWebPluginManifest: defaultFetchWebPluginManifest$1,
+    ensurePluginHostRoute: ensurePluginHostRoute$1,
+    resolveRuntimeOptions: resolveRuntimeOptions$1
 });
 
 /**
  * 清单拉取函数的组合工具：缓存、埋点等以**中间件**形式扩展，不侵入 `bootstrapPlugins` 核心逻辑，
  * 可组合的 `fetchManifest` 包装；入参/出参与 `resolveRuntimeOptions({ fetchManifest })` 一致。
- *
- * @module runtime/manifest-fetch-composer
- */
-
-/**
- * @typedef {object} FetchWebPluginManifestContext
- * @property {string} manifestUrl
- * @property {RequestCredentials} credentials
- */
-
-/**
- * @typedef {object} FetchWebPluginManifestResult
- * @property {boolean} ok
- * @property {number} [status]
- * @property {{ hostPluginApiVersion?: string, plugins?: object[] }|null} [data]
- * @property {unknown} [error]
- */
-
-/**
- * @callback FetchWebPluginManifestFn
- * @param {FetchWebPluginManifestContext} ctx
- * @returns {Promise<FetchWebPluginManifestResult>}
- */
-
-/**
- * 将内层 `fetchManifest` 包装为带缓存的版本。等价于
- * `composeManifestFetch(inner, manifestFetchCacheMiddleware(options))`。
- *
- * @param {FetchWebPluginManifestFn} inner 内层实现（如预设生成的 `fetchManifest` 或 `defaultFetchWebPluginManifest`）
- * @param {ManifestFetchCacheOptions} [options]
- * @returns {FetchWebPluginManifestFn}
  */
 function wrapManifestFetchWithCache$1(inner, options = {}) {
-  return composeManifestFetch$1(inner, manifestFetchCacheMiddleware$1(options))
+    return composeManifestFetch$1(inner, manifestFetchCacheMiddleware$1(options));
 }
-
-/**
- * @typedef {object} ManifestFetchCacheOptions
- * @property {number} [ttlMs] 缓存时长（毫秒）。`<= 0` 或未传时**不缓存**（直接透传 `inner`）。
- * @property {'memory'|'session'|'local'} [storage='memory'] `session`/`local` 依赖 `JSON.stringify`，仅适合可序列化的 `data`。
- * @property {string} [storageKeyPrefix='wep.manifestFetch.v1'] Web Storage 键前缀（仅 storage 非 memory 时生效）。
- * @property {(ctx: FetchWebPluginManifestContext) => string} [cacheKey] 默认 `manifestUrl + '\0' + credentials`。
- * @property {(result: FetchWebPluginManifestResult) => boolean} [shouldCache] 默认：`ok === true` 且 `data` 非空。
- * @property {number} [maxEntries=50] 仅 `memory`：超过条数时淘汰最久未读条目。
- * @property {() => number} [now] 测试注入时间戳。
- */
-
-/**
- * 清单拉取**中间件工厂**：`next` 为内层 `fetchManifest`。
- *
- * @param {ManifestFetchCacheOptions} options
- * @returns {(next: FetchWebPluginManifestFn) => FetchWebPluginManifestFn}
- */
 function manifestFetchCacheMiddleware$1(options = {}) {
-  const ttlMs = typeof options.ttlMs === 'number' && Number.isFinite(options.ttlMs) ? options.ttlMs : 0;
-  if (ttlMs <= 0) {
-    return (next) => next
-  }
-
-  const storage = options.storage || 'memory';
-  const prefix = options.storageKeyPrefix || 'wep.manifestFetch.v1';
-  const maxEntries = typeof options.maxEntries === 'number' && options.maxEntries > 0 ? options.maxEntries : 50;
-  const getNow = typeof options.now === 'function' ? options.now : () => Date.now();
-  const cacheKeyFn =
-    typeof options.cacheKey === 'function'
-      ? options.cacheKey
-      : (ctx) => `${String(ctx.manifestUrl)}\0${String(ctx.credentials)}`;
-
-  const shouldCache =
-    typeof options.shouldCache === 'function'
-      ? options.shouldCache
-      : (r) => !!(r && r.ok === true && r.data != null);
-
-  /** @type {Map<string, { expiresAt: number, result: FetchWebPluginManifestResult, lastRead: number }>} */
-  const memory = new Map();
-
-  function cloneResult(r) {
-    try {
-      if (typeof structuredClone === 'function') {
-        return structuredClone(r)
-      }
-    } catch (_) {}
-    try {
-      return JSON.parse(JSON.stringify(r))
-    } catch (_) {
-      return { ...r, data: r.data }
+    const ttlMs = typeof options.ttlMs === 'number' && Number.isFinite(options.ttlMs) ? options.ttlMs : 0;
+    if (ttlMs <= 0) {
+        return (next) => next;
     }
-  }
-
-  function touchMemory(key) {
-    const e = memory.get(key);
-    if (e) {
-      e.lastRead = getNow();
+    const storage = options.storage || 'memory';
+    const prefix = options.storageKeyPrefix || defaultManifestFetchCache.storageKeyPrefix;
+    const maxEntries = typeof options.maxEntries === 'number' && options.maxEntries > 0
+        ? options.maxEntries
+        : defaultManifestFetchCache.maxEntries;
+    const getNow = typeof options.now === 'function' ? options.now : () => Date.now();
+    const cacheKeyFn = typeof options.cacheKey === 'function'
+        ? options.cacheKey
+        : (ctx) => `${String(ctx.manifestUrl)}\0${String(ctx.credentials)}`;
+    const shouldCache = typeof options.shouldCache === 'function'
+        ? options.shouldCache
+        : (r) => !!(r && r.ok === true && r.data != null);
+    const memory = new Map();
+    function cloneResult(r) {
+        try {
+            if (typeof structuredClone === 'function') {
+                return structuredClone(r);
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            return JSON.parse(JSON.stringify(r));
+        }
+        catch {
+            return { ...r, data: r.data };
+        }
     }
-  }
-
-  function pruneMemory() {
-    if (memory.size <= maxEntries) {
-      return
+    function touchMemory(key) {
+        const e = memory.get(key);
+        if (e) {
+            e.lastRead = getNow();
+        }
     }
-    const entries = [...memory.entries()].sort((a, b) => a[1].lastRead - b[1].lastRead);
-    const drop = memory.size - maxEntries;
-    for (let i = 0; i < drop; i++) {
-      memory.delete(entries[i][0]);
+    function pruneMemory() {
+        if (memory.size <= maxEntries) {
+            return;
+        }
+        const entries = [...memory.entries()].sort((a, b) => a[1].lastRead - b[1].lastRead);
+        const drop = memory.size - maxEntries;
+        for (let i = 0; i < drop; i++) {
+            memory.delete(entries[i][0]);
+        }
     }
-  }
-
-  function readWebStorage(store, key) {
-    try {
-      const raw = store.getItem(key);
-      if (!raw) {
-        return null
-      }
-      const o = JSON.parse(raw);
-      if (!o || typeof o !== 'object') {
-        return null
-      }
-      const exp = o.expiresAt;
-      const res = o.result;
-      if (typeof exp !== 'number' || getNow() > exp) {
-        store.removeItem(key);
-        return null
-      }
-      return /** @type {FetchWebPluginManifestResult} */ (res)
-    } catch (_) {
-      return null
-    }
-  }
-
-  function writeWebStorage(store, key, result, expiresAt) {
-    try {
-      store.setItem(key, JSON.stringify({ expiresAt, result }));
-    } catch (_) {
-      /* Quota / 不可序列化 */
-    }
-  }
-
-  return (next) => {
-    return async (ctx) => {
-      const key = cacheKeyFn(ctx);
-      const now = getNow();
-
-      if (storage === 'memory') {
-        const hit = memory.get(key);
-        if (hit && hit.expiresAt > now) {
-          touchMemory(key);
-          return cloneResult(hit.result)
+    function readWebStorage(store, key) {
+        try {
+            const raw = store.getItem(key);
+            if (!raw) {
+                return null;
+            }
+            const o = JSON.parse(raw);
+            if (!o || typeof o !== 'object') {
+                return null;
+            }
+            const exp = o.expiresAt;
+            const res = o.result;
+            if (typeof exp !== 'number' || getNow() > exp) {
+                store.removeItem(key);
+                return null;
+            }
+            return res;
         }
-      } else if (storage === 'session' && typeof sessionStorage !== 'undefined') {
-        const sk = `${prefix}:${key}`;
-        const hit = readWebStorage(sessionStorage, sk);
-        if (hit) {
-          return cloneResult(hit)
+        catch {
+            return null;
         }
-      } else if (storage === 'local' && typeof localStorage !== 'undefined') {
-        const sk = `${prefix}:${key}`;
-        const hit = readWebStorage(localStorage, sk);
-        if (hit) {
-          return cloneResult(hit)
+    }
+    function writeWebStorage(store, key, result, expiresAt) {
+        try {
+            store.setItem(key, JSON.stringify({ expiresAt, result }));
+        }
+        catch {
+            /* Quota / 不可序列化 */
         }
-      }
-
-      const result = await next(ctx);
-
-      if (!shouldCache(result)) {
-        return result
-      }
-
-      const expiresAt = now + ttlMs;
-      const frozen = cloneResult(result);
-
-      if (storage === 'memory') {
-        memory.set(key, { expiresAt, result: frozen, lastRead: now });
-        pruneMemory();
-      } else if (storage === 'session' && typeof sessionStorage !== 'undefined') {
-        writeWebStorage(sessionStorage, `${prefix}:${key}`, frozen, expiresAt);
-      } else if (storage === 'local' && typeof localStorage !== 'undefined') {
-        writeWebStorage(localStorage, `${prefix}:${key}`, frozen, expiresAt);
-      }
-
-      return result
     }
-  }
+    return (next) => {
+        return async (ctx) => {
+            const key = cacheKeyFn(ctx);
+            const now = getNow();
+            if (storage === 'memory') {
+                const hit = memory.get(key);
+                if (hit && hit.expiresAt > now) {
+                    touchMemory(key);
+                    return cloneResult(hit.result);
+                }
+            }
+            else if (storage === 'session' && typeof sessionStorage !== 'undefined') {
+                const sk = `${prefix}:${key}`;
+                const hit = readWebStorage(sessionStorage, sk);
+                if (hit) {
+                    return cloneResult(hit);
+                }
+            }
+            else if (storage === 'local' && typeof localStorage !== 'undefined') {
+                const sk = `${prefix}:${key}`;
+                const hit = readWebStorage(localStorage, sk);
+                if (hit) {
+                    return cloneResult(hit);
+                }
+            }
+            const result = await next(ctx);
+            if (!shouldCache(result)) {
+                return result;
+            }
+            const expiresAt = now + ttlMs;
+            const frozen = cloneResult(result);
+            if (storage === 'memory') {
+                memory.set(key, { expiresAt, result: frozen, lastRead: now });
+                pruneMemory();
+            }
+            else if (storage === 'session' && typeof sessionStorage !== 'undefined') {
+                writeWebStorage(sessionStorage, `${prefix}:${key}`, frozen, expiresAt);
+            }
+            else if (storage === 'local' && typeof localStorage !== 'undefined') {
+                writeWebStorage(localStorage, `${prefix}:${key}`, frozen, expiresAt);
+            }
+            return result;
+        };
+    };
 }
-
-/**
- * 自右向左组合中间件（与 Koa/Redux 习惯一致：`compose(f,g,h)(inner)` = f(g(h(inner))))。
- *
- * @param {FetchWebPluginManifestFn} inner 最内层拉取实现
- * @param {...function(FetchWebPluginManifestFn): FetchWebPluginManifestFn} middlewares 每个元素签名 `(next) => async (ctx) => result`
- * @returns {FetchWebPluginManifestFn}
- */
 function composeManifestFetch$1(inner, ...middlewares) {
-  if (typeof inner !== 'function') {
-    throw new Error('[web-extend-plugin-vue2] composeManifestFetch 需要 inner 为函数')
-  }
-  let f = inner;
-  for (let i = middlewares.length - 1; i >= 0; i--) {
-    const mw = middlewares[i];
-    if (typeof mw !== 'function') {
-      throw new Error('[web-extend-plugin-vue2] composeManifestFetch 中间件须为函数')
-    }
-    f = mw(f);
-  }
-  return f
+    if (typeof inner !== 'function') {
+        throw new Error('[web-extend-plugin-vue2] composeManifestFetch 需要 inner 为函数');
+    }
+    let f = inner;
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+        const mw = middlewares[i];
+        if (typeof mw !== 'function') {
+            throw new Error('[web-extend-plugin-vue2] composeManifestFetch 中间件须为函数');
+        }
+        f = mw(f);
+    }
+    return f;
 }
 
 var manifestComposer = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  composeManifestFetch: composeManifestFetch$1,
-  manifestFetchCacheMiddleware: manifestFetchCacheMiddleware$1,
-  wrapManifestFetchWithCache: wrapManifestFetchWithCache$1
+    __proto__: null,
+    composeManifestFetch: composeManifestFetch$1,
+    manifestFetchCacheMiddleware: manifestFetchCacheMiddleware$1,
+    wrapManifestFetchWithCache: wrapManifestFetchWithCache$1
 });
 
 /**
- * 插件访问后端的受控通道：`fetch` 仅允许落在配置的路径前缀下（默认 `/api/`），默认 `credentials: 'same-origin'`。
- */
-
-/**
- * @param {{ allowedPathPrefixes?: string[] }} [config]
- */
-function createRequestBridge(config = {}) {
-  const raw =
-    Array.isArray(config.allowedPathPrefixes) && config.allowedPathPrefixes.length > 0
-      ? config.allowedPathPrefixes
-      : defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes;
-  const allowedPathPrefixes = raw.map((p) => ensureLeadingPath(p));
-
-  return {
-    /**
-     * @param {string} path 必须以 `/` 开头，且匹配某一白名单前缀
-     * @param {RequestInit} [init]
-     */
-    async request(path, init = {}) {
-      if (typeof path !== 'string' || !path.startsWith('/')) {
-        throw new Error('[wep:bridge] path must start with /')
-      }
-      const allowed = allowedPathPrefixes.some((p) => path.startsWith(p));
-      if (!allowed) {
-        throw new Error('[wep:bridge] path not allowed: ' + path)
-      }
-      return fetch(path, {
-        credentials: 'same-origin',
-        ...init
-      })
-    }
-  }
-}
-
-/**
- * 宿主侧响应式注册表：插件菜单与扩展点槽位（供布局与 `ExtensionPoint` 消费）。
- */
-
-/**
- * @type {{
- *   menus: object[],
- *   slots: Record<string, Array<{ pluginId: string, component: import('vue').Component, priority: number, key: string }>>
- * }}
+ * 宿主侧响应式注册表：扩展点槽位（供布局与 `ExtensionPoint` 消费）。
+ * 菜单由宿主从路由 `meta` 推导（见 `buildMenuDescriptorsFromRoutes`），框架不维护平行菜单列表。
  */
 const registries = Vue__default.default.observable({
-  menus: [],
-  slots: {},
-  /** 槽位变更计数；缓解 Vue2 对动态 `Vue.set(slots, key)` 的依赖收集不完整。 */
-  slotRevision: 0
+    slots: {},
+    slotRevision: 0
 });
 
 /**
  * 按插件 id 收集 `onTeardown` 回调，供 `disposeWebPlugin` 统一执行。
  */
-
-/** @type {Map<string, Array<() => void>>} */
 const _byPlugin = new Map();
+function registerPluginTeardown(pluginId, fn) {
+    if (typeof fn !== 'function') {
+        return;
+    }
+    let list = _byPlugin.get(pluginId);
+    if (!list) {
+        list = [];
+        _byPlugin.set(pluginId, list);
+    }
+    list.push(fn);
+}
+function runPluginTeardowns(pluginId) {
+    const list = _byPlugin.get(pluginId);
+    if (!list) {
+        return;
+    }
+    _byPlugin.delete(pluginId);
+    for (const fn of list) {
+        try {
+            fn();
+        }
+        catch (e) {
+            console.warn('[wep] teardown failed', pluginId, e);
+        }
+    }
+}
 
 /**
- * @param {string} pluginId
- * @param {() => void} fn
+ * 插件访问后端的受控通道：`fetch` 仅允许落在配置的路径前缀下（默认 `/api/`），默认 `credentials: 'same-origin'`。
  */
-function registerPluginTeardown(pluginId, fn) {
-  if (typeof fn !== 'function') {
-    return
-  }
-  let list = _byPlugin.get(pluginId);
-  if (!list) {
-    list = [];
-    _byPlugin.set(pluginId, list);
-  }
-  list.push(fn);
+function createRequestBridge(config = {}) {
+    const raw = Array.isArray(config.allowedPathPrefixes) && config.allowedPathPrefixes.length > 0
+        ? config.allowedPathPrefixes
+        : defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes;
+    const allowedPathPrefixes = raw.map((p) => ensureLeadingPath(p));
+    return {
+        async request(path, init = {}) {
+            if (typeof path !== 'string' || !path.startsWith('/')) {
+                throw new Error('[wep:bridge] path must start with /');
+            }
+            const allowed = allowedPathPrefixes.some((p) => path.startsWith(p));
+            if (!allowed) {
+                throw new Error('[wep:bridge] path not allowed: ' + path);
+            }
+            return fetch(path, {
+                credentials: 'same-origin',
+                ...init
+            });
+        }
+    };
 }
 
 /**
- * @param {string} pluginId
+ * 记录各插件通过 registerRoutes 挂到 router 上的顶层 route name，便于 dispose 时 removeRoute。
  */
-function runPluginTeardowns(pluginId) {
-  const list = _byPlugin.get(pluginId);
-  if (!list) {
-    return
-  }
-  _byPlugin.delete(pluginId);
-  for (const fn of list) {
-    try {
-      fn();
-    } catch (e) {
-      console.warn('[wep] teardown failed', pluginId, e);
+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：路由、菜单、扩展点、资源与受控请求桥。
  */
-
 let slotItemKeySeq = 0;
 let routeSynthSeq = 0;
-
-/**
- * @param {unknown[]} nodes
- */
 function analyzeRouteInputTree(nodes) {
-  let hasDecl = false;
-  let hasCfg = false;
-  /** @param {unknown} r */
-  function walk(r) {
-    if (!r || typeof r !== 'object') {
-      return
-    }
-    const o = /** @type {Record<string, unknown>} */ (r);
-    const cfg = o.component != null || o.components != null;
-    const decl = typeof o.componentRef === 'string';
-    if (cfg) {
-      hasCfg = true;
-    } else if (decl) {
-      hasDecl = true;
-    }
-    const ch = o.children;
-    if (Array.isArray(ch)) {
-      for (const c of ch) {
-        walk(c);
-      }
-    }
-  }
-  for (const n of nodes) {
-    walk(n);
-  }
-  return { hasDecl, hasCfg }
+    let hasDecl = false;
+    let hasCfg = false;
+    function walk(r) {
+        if (!r || typeof r !== 'object') {
+            return;
+        }
+        const o = r;
+        const cfg = o.component != null || o.components != null;
+        const decl = typeof o.componentRef === 'string';
+        if (cfg) {
+            hasCfg = true;
+        }
+        else if (decl) {
+            hasDecl = true;
+        }
+        const ch = o.children;
+        if (Array.isArray(ch)) {
+            for (const c of ch) {
+                walk(c);
+            }
+        }
+    }
+    for (const n of nodes) {
+        walk(n);
+    }
+    return { hasDecl, hasCfg };
 }
-
 /**
  * 单插件在宿主侧的 API 句柄。工厂请传 `(id, router, kit) => createHostApi(id, r, kit)` 以便 bridge 白名单等到位。
- *
- * @param {string} pluginId
- * @param {import('vue-router').default} router
- * @param {Record<string, unknown>} [hostKitOptions] 与 `resolveRuntimeOptions` 中路由/bridge 等字段一致
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function createHostApi(pluginId, router, hostKitOptions = {}) {
-  const bridgePrefixes =
-    Array.isArray(hostKitOptions.bridgeAllowedPathPrefixes) &&
-    hostKitOptions.bridgeAllowedPathPrefixes.length > 0
-      ? hostKitOptions.bridgeAllowedPathPrefixes
-      : defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes;
-  const bridge = createRequestBridge({ allowedPathPrefixes: bridgePrefixes });
-
-  const parentName =
-    typeof hostKitOptions.pluginRoutesParentName === 'string'
-      ? hostKitOptions.pluginRoutesParentName.trim()
-      : '';
-
-  /** @param {import('vue-router').RouteConfig[]} rawRouteConfigs */
-  function applyInternalRegister(rawRouteConfigs) {
-    const wrapped = rawRouteConfigs.map((r) => ({
-      ...r,
-      name: r.name || `__wep_${pluginId}_${routeSynthSeq++}`,
-      meta: { ...(r.meta || {}), pluginId }
-    }));
-    if (typeof router.addRoute === 'function') {
-      if (parentName) {
-        for (const r of wrapped) {
-          router.addRoute(parentName, r);
+    const bridgePrefixes = Array.isArray(hostKitOptions.bridgeAllowedPathPrefixes) &&
+        hostKitOptions.bridgeAllowedPathPrefixes.length > 0
+        ? hostKitOptions.bridgeAllowedPathPrefixes
+        : defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes;
+    const bridge = createRequestBridge({ allowedPathPrefixes: bridgePrefixes });
+    const parentName = typeof hostKitOptions.pluginRoutesParentName === 'string'
+        ? hostKitOptions.pluginRoutesParentName.trim()
+        : '';
+    function applyInternalRegister(rawRouteConfigs) {
+        const wrapped = rawRouteConfigs.map((r) => ({
+            ...r,
+            name: r.name || `${routeSynthNamePrefix}${pluginId}_${routeSynthSeq++}`,
+            meta: { ...(r.meta || {}), pluginId }
+        }));
+        if (typeof router.addRoute !== 'function') {
+            throw new Error('[wep] vue-router 3.5+ 必需：请使用 router.addRoute（不再支持 addRoutes）');
         }
-      } else {
-        for (const r of wrapped) {
-          router.addRoute(r);
+        recordPluginTopRouteNames(pluginId, wrapped.map((r) => String(r.name)));
+        if (parentName) {
+            for (const r of wrapped) {
+                router.addRoute(parentName, r);
+            }
         }
-      }
-    } else {
-      if (parentName) {
-        console.warn(
-          '[wep] pluginRoutesParentName requires vue-router 3.5+ addRoute; falling back to top-level addRoutes'
-        );
-      }
-      router.addRoutes(wrapped);
-    }
-  }
-
-  function injectStylesheet(href) {
-    const link = document.createElement('link');
-    link.rel = 'stylesheet';
-    link.href = href;
-    link.setAttribute('data-plugin-asset', pluginId);
-    document.head.appendChild(link);
-  }
-
-  /** @param {string} src */
-  function injectScript(src) {
-    return new Promise((resolve, reject) => {
-      const s = document.createElement('script');
-      s.async = true;
-      s.src = src;
-      s.setAttribute('data-plugin-asset', pluginId);
-      s.onload = () => resolve();
-      s.onerror = () => reject(new Error('script failed: ' + src));
-      document.head.appendChild(s);
-    })
-  }
-
-  return {
-    hostPluginApiVersion: HOST_PLUGIN_API_VERSION,
-
-    registerRoutes(routes) {
-      const list = Array.isArray(routes) ? routes : [];
-      if (list.length === 0) {
-        return
-      }
-      const { hasDecl, hasCfg } = analyzeRouteInputTree(list);
-      if (hasDecl && hasCfg) {
-        throw new Error(
-          '[wep] registerRoutes: cannot mix RouteDeclaration (componentRef) with RouteConfig (component)'
-        )
-      }
-      let /** @type {import('vue-router').RouteConfig[]} */ configs;
-      if (hasDecl) {
-        const adapt = hostKitOptions.adaptRouteDeclarations;
-        if (typeof adapt !== 'function') {
-          throw new Error(
-            '[wep] registerRoutes: RouteDeclaration (componentRef) requires adaptRouteDeclarations on the host'
-          )
+        else {
+            for (const r of wrapped) {
+                router.addRoute(r);
+            }
         }
-        configs = adapt({
-          pluginId,
-          router,
-          declarations: /** @type {unknown[]} */ (list)
-        });
-      } else {
-        configs = /** @type {import('vue-router').RouteConfig[]} */ (/** @type {unknown} */ (list));
-      }
-
-      if (typeof hostKitOptions.transformRoutes === 'function') {
-        configs = hostKitOptions.transformRoutes({
-          pluginId,
-          router,
-          routes: configs
-        });
-      }
-
-      if (typeof hostKitOptions.interceptRegisterRoutes === 'function') {
-        hostKitOptions.interceptRegisterRoutes({
-          pluginId,
-          router,
-          routes: configs,
-          applyInternalRegister
-        });
-      } else {
-        applyInternalRegister(configs);
-      }
-    },
-
-    registerMenuItems(items) {
-      for (const item of items) {
-        registries.menus.push({ ...item, pluginId });
-      }
-      registries.menus.sort(
-        (a, b) => (a.order != null ? a.order : 0) - (b.order != null ? b.order : 0)
-      );
-    },
-
-    registerSlotComponents(pointId, components) {
-      if (!pointId) {
-        return
-      }
-      if (!registries.slots[pointId]) {
-        Vue__default.default.set(registries.slots, pointId, []);
-      }
-      const list = registries.slots[pointId];
-      for (const c of components) {
-        list.push({
-          pluginId,
-          component: c.component,
-          priority: c.priority != null ? c.priority : 0,
-          key: `${pluginId}-${pointId}-${++slotItemKeySeq}`
+    }
+    function injectStylesheet(href) {
+        const link = document.createElement('link');
+        link.rel = 'stylesheet';
+        link.href = href;
+        link.setAttribute('data-plugin-asset', pluginId);
+        document.head.appendChild(link);
+    }
+    function injectScript(src) {
+        return new Promise((resolve, reject) => {
+            const s = document.createElement('script');
+            s.async = true;
+            s.src = src;
+            s.setAttribute('data-plugin-asset', pluginId);
+            s.onload = () => resolve();
+            s.onerror = () => reject(new Error('script failed: ' + src));
+            document.head.appendChild(s);
         });
-      }
-      list.sort((a, b) => b.priority - a.priority);
-      registries.slotRevision++;
-    },
-
-    registerStylesheetUrls(urls) {
-      for (const u of urls || []) {
-        if (typeof u === 'string' && u) {
-          injectStylesheet(u);
+    }
+    const hostContext = hostKitOptions.hostContext != null && typeof hostKitOptions.hostContext === 'object'
+        ? hostKitOptions.hostContext
+        : Object.freeze({});
+    return {
+        hostPluginApiVersion: HOST_PLUGIN_API_VERSION,
+        /** 宿主注入的只读依赖（store、router、开放能力等），见 `resolveRuntimeOptions.hostContext` */
+        hostContext,
+        registerRoutes(routes) {
+            const list = Array.isArray(routes) ? routes : [];
+            if (list.length === 0) {
+                return;
+            }
+            const { hasDecl, hasCfg } = analyzeRouteInputTree(list);
+            if (hasDecl && hasCfg) {
+                throw new Error('[wep] registerRoutes: cannot mix RouteDeclaration (componentRef) with RouteConfig (component)');
+            }
+            let configs;
+            if (hasDecl) {
+                const adapt = hostKitOptions.adaptRouteDeclarations;
+                if (typeof adapt !== 'function') {
+                    throw new Error('[wep] registerRoutes: RouteDeclaration (componentRef) requires adaptRouteDeclarations on the host');
+                }
+                configs = adapt({
+                    pluginId,
+                    router,
+                    declarations: list
+                });
+            }
+            else {
+                configs = list;
+            }
+            if (typeof hostKitOptions.transformRoutes === 'function') {
+                configs = hostKitOptions.transformRoutes({
+                    pluginId,
+                    router,
+                    routes: configs
+                });
+            }
+            if (typeof hostKitOptions.interceptRegisterRoutes === 'function') {
+                hostKitOptions.interceptRegisterRoutes({
+                    pluginId,
+                    router,
+                    routes: configs,
+                    applyInternalRegister
+                });
+            }
+            else {
+                applyInternalRegister(configs);
+            }
+        },
+        registerSlotComponents(pointId, components) {
+            if (!pointId) {
+                return;
+            }
+            if (!registries.slots[pointId]) {
+                Vue__default.default.set(registries.slots, pointId, []);
+            }
+            const list = registries.slots[pointId];
+            for (const c of components) {
+                list.push({
+                    pluginId,
+                    component: c.component,
+                    priority: c.priority != null ? c.priority : 0,
+                    key: `${pluginId}-${pointId}-${++slotItemKeySeq}`
+                });
+            }
+            list.sort((a, b) => b.priority - a.priority);
+            registries.slotRevision++;
+        },
+        registerStylesheetUrls(urls) {
+            for (const u of urls || []) {
+                if (typeof u === 'string' && u) {
+                    injectStylesheet(u);
+                }
+            }
+        },
+        registerScriptUrls(urls) {
+            const chain = (urls || []).filter((u) => typeof u === 'string' && u).reduce((p, u) => p.then(() => injectScript(u)), Promise.resolve());
+            chain.catch((e) => console.warn('[wep] registerScriptUrls', pluginId, e));
+        },
+        registerSanitizedHtmlSnippet() {
+            throw new Error('registerSanitizedHtmlSnippet is not enabled');
+        },
+        getBridge: () => bridge,
+        onTeardown(_pluginId, fn) {
+            if (typeof fn === 'function') {
+                registerPluginTeardown(pluginId, fn);
+            }
         }
-      }
-    },
-
-    registerScriptUrls(urls) {
-      const chain = (urls || []).filter((u) => typeof u === 'string' && u).reduce(
-        (p, u) => p.then(() => injectScript(u)),
-        Promise.resolve()
-      );
-      chain.catch((e) => console.warn('[wep] registerScriptUrls', pluginId, e));
-    },
-
-    registerSanitizedHtmlSnippet() {
-      throw new Error('registerSanitizedHtmlSnippet is not enabled')
-    },
-
-    getBridge: () => bridge,
+    };
+}
 
-    onTeardown(_pluginId, fn) {
-      if (typeof fn === 'function') {
-        registerPluginTeardown(pluginId, fn);
-      }
+/**
+ * 卸载单个插件：执行 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);
+    removeRegisteredRoutesForPlugin(getPluginBootstrapRouter(), pluginId);
+    const slots = registries.slots;
+    for (const pointId of Object.keys(slots)) {
+        const list = slots[pointId];
+        if (!Array.isArray(list)) {
+            continue;
+        }
+        const next = list.filter((x) => x.pluginId !== pluginId);
+        if (next.length === 0) {
+            Vue__default.default.delete(slots, pointId);
+        }
+        else if (next.length !== list.length) {
+            Vue__default.default.set(slots, pointId, next);
+        }
+    }
+    registries.slotRevision++;
+    if (typeof window !== 'undefined' && window.__PLUGIN_ACTIVATORS__) {
+        delete window.__PLUGIN_ACTIVATORS__[pluginId];
+    }
+    if (typeof document !== 'undefined') {
+        document.querySelectorAll('[data-plugin-asset]').forEach((el) => {
+            if (el.getAttribute('data-plugin-asset') === pluginId) {
+                el.remove();
+            }
+        });
     }
-  }
 }
 
 /**
- * 卸载单个插件：执行 teardown、清理注册表与 activator、移除带 `data-plugin-asset` 的 DOM。
- * 注意：Vue Router 3 无公开 `removeRoute`，动态路由通常需整页刷新或宿主自行维护。
+ * 从路由配置（含 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);
+        }
+    }
+}
 /**
- * @param {string} pluginId 与 manifest `id` 一致
+ * 从插件侧 RouteConfig 树构建菜单描述（不含 component，便于并入宿主菜单 state）。
  */
-function disposeWebPlugin(pluginId) {
-  if (!pluginId || typeof pluginId !== 'string') {
-    return
-  }
-
-  runPluginTeardowns(pluginId);
-
-  for (let i = registries.menus.length - 1; i >= 0; i--) {
-    if (registries.menus[i].pluginId === pluginId) {
-      registries.menus.splice(i, 1);
-    }
-  }
-
-  const slots = registries.slots;
-  for (const pointId of Object.keys(slots)) {
-    const list = slots[pointId];
-    if (!Array.isArray(list)) {
-      continue
-    }
-    const next = list.filter((x) => x.pluginId !== pluginId);
-    if (next.length === 0) {
-      Vue__default.default.delete(slots, pointId);
-    } else if (next.length !== list.length) {
-      Vue__default.default.set(slots, pointId, next);
-    }
-  }
-  registries.slotRevision++;
-
-  if (typeof window !== 'undefined' && window.__PLUGIN_ACTIVATORS__) {
-    delete window.__PLUGIN_ACTIVATORS__[pluginId];
-  }
-
-  if (typeof document !== 'undefined') {
-    document.querySelectorAll('[data-plugin-asset]').forEach((el) => {
-      if (el.getAttribute('data-plugin-asset') === pluginId) {
-        el.remove();
-      }
-    });
-  }
+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`。
  */
-
-const SlotErrorBoundary = {
-  name: 'SlotErrorBoundary',
-  props: { label: String },
-  data() {
-    return { error: null }
-  },
-  errorCaptured(err) {
-    this.error = err && err.message ? err.message : String(err);
-    console.error('[wep:ExtensionPoint]', this.label, err);
-    return false
-  },
-  render(h) {
-    if (this.error) {
-      return h(
-        'div',
-        { class: 'plugin-point-error', style: { color: '#c00', fontSize: '12px' } },
-        `[插件 ${this.label}] 渲染失败`
-      )
-    }
-    const d = this.$slots.default;
-    return d && d[0] ? d[0] : h('span')
-  }
-};
-
-var ExtensionPoint = {
-  name: 'ExtensionPoint',
-  components: { SlotErrorBoundary },
-  props: {
-    pointId: { type: String, required: true },
-    slotProps: { type: Object, default: () => ({}) }
-  },
-  computed: {
-    items() {
-      void registries.slotRevision;
-      return registries.slots[this.pointId] || []
+const SlotErrorBoundary = Vue__default.default.extend({
+    name: 'SlotErrorBoundary',
+    props: { label: String },
+    data() {
+        return { error: null };
+    },
+    errorCaptured(err) {
+        this.error = err instanceof Error && err.message ? err.message : String(err);
+        console.error('[wep:ExtensionPoint]', this.label, err);
+        return false;
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    render(h) {
+        if (this.error) {
+            return h('div', { class: 'plugin-point-error' }, `[插件 ${this.label}] 渲染失败`);
+        }
+        const d = this.$slots.default;
+        return d && d[0] ? d[0] : h('span');
+    }
+});
+var ExtensionPoint = Vue__default.default.extend({
+    name: 'ExtensionPoint',
+    components: { SlotErrorBoundary },
+    props: {
+        pointId: { type: String, required: true },
+        slotProps: { type: Object, default: () => ({}) }
+    },
+    computed: {
+        items() {
+            void registries.slotRevision;
+            return registries.slots[this.pointId] || [];
+        },
+        forwardProps() {
+            return this.slotProps || {};
+        }
     },
-    forwardProps() {
-      return this.slotProps || {}
-    }
-  },
-  render(h) {
-    return h(
-      'div',
-      {
-        class: 'extension-point',
-        style: { minHeight: '8px' },
-        attrs: { 'data-point-id': this.pointId }
-      },
-      this.items.map((item) =>
-        h(
-          SlotErrorBoundary,
-          {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    render(h) {
+        return h('div', {
+            class: 'extension-point',
+            attrs: { 'data-point-id': this.pointId }
+        }, this.items.map((item) => h(SlotErrorBoundary, {
             key: item.key,
             props: { label: item.pluginId }
-          },
-          [h(item.component, { props: this.forwardProps })]
-        )
-      )
-    )
-  }
-};
+        }, [h(item.component, { props: this.forwardProps })])));
+    }
+});
 
 /**
  * 注册全局 `ExtensionPoint` 并异步拉取清单、激活插件。
  */
-
 /**
- * @param {*} Vue
- * @param {*} router
- * @param {Record<string, unknown>} [options] 传给 `resolveRuntimeOptions`；可含 `env` 以读取 `VITE_*`
+ * @param Vue Vue 构造函数
+ * @param router vue-router 实例
+ * @param options 传给 `resolveRuntimeOptions`；可含 `env` 以读取 `VITE_*`
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function installWebExtendPluginVue2(Vue, router, options) {
-  const opts = options || {};
-  const { env: injectedEnv, ...runtimeUser } = opts;
-  if (injectedEnv && typeof injectedEnv === 'object') {
-    setWebExtendPluginEnv(injectedEnv);
-  }
-  if (Vue && ExtensionPoint) {
-    Vue.component('ExtensionPoint', ExtensionPoint);
-  }
-  const runtime = resolveRuntimeOptions$1(runtimeUser);
-  return bootstrapPlugins$1(router, (id, r, kit) => createHostApi(id, r, kit), runtime)
+    const opts = options || {};
+    const { env: injectedEnv, ...runtimeUser } = opts;
+    if (injectedEnv && typeof injectedEnv === 'object') {
+        setWebExtendPluginEnv(injectedEnv);
+    }
+    if (Vue && ExtensionPoint) {
+        Vue.component('ExtensionPoint', ExtensionPoint);
+    }
+    const runtime = resolveRuntimeOptions$1(runtimeUser);
+    return bootstrapPlugins$1(router, (id, r, kit) => createHostApi(id, r, kit || {}), runtime);
 }
 
 /**
  * Vue CLI + 统一 axios（如 RuoYi `utils/request`）场景的 `install` 预设。
  */
-
-/**
- * @typedef {object} VueCliAxiosPresetDeps
- * @property {(config: { url: string, method?: string }) => Promise<unknown>} request
- */
-
-/**
- * 将完整 manifest URL 转为相对 `apiBase` 的请求 path，供 axios `baseURL` 拼接。
- * @param {string} manifestUrl
- * @param {string} [apiBase]
- */
 function resolveManifestPathUnderApiBase(manifestUrl, apiBase) {
-  const base = String(
-    apiBase !== undefined
-      ? apiBase
-      : (typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API) || ''
-  ).replace(/\/$/, '');
-  if (typeof window === 'undefined') {
-    return '/api/frontend-plugins'
-  }
-  const u = new URL(manifestUrl, window.location.origin);
-  let path = u.pathname + u.search;
-  if (base && path.startsWith(base)) {
-    path = path.slice(base.length) || '/';
-  }
-  return path
+    const base = String(apiBase !== undefined
+        ? apiBase
+        : typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API
+            ? String(process.env.VUE_APP_BASE_API)
+            : '').replace(/\/$/, '');
+    if (typeof window === 'undefined') {
+        return '/api/frontend-plugins';
+    }
+    const u = new URL(manifestUrl, window.location.origin);
+    let path = u.pathname + u.search;
+    if (base && path.startsWith(base)) {
+        path = path.slice(base.length) || '/';
+    }
+    return path;
 }
-
 /**
- * 将裸 `{ plugins }` 与 `{ code, data: { plugins } }` 式响应解包为清单对象。
- * @param {unknown} body
- * @returns {object|null}
+ * 常见 Java 清单路径：与 `VUE_APP_BASE_API` 拼接为 `${base}/frontend-plugins`。
+ * 若后端使用 `/api/frontend-plugins` 段，请在 extra 中显式传入 `manifestListPath`。
  */
-function unwrapNestedManifestBody(body) {
-  if (!body || typeof body !== 'object') {
-    return null
-  }
-  const o = /** @type {Record<string, unknown>} */ (body);
-  if (Array.isArray(o.plugins)) {
-    return o
-  }
-  const d = o.data;
-  if (d && typeof d === 'object') {
-    const inner = /** @type {Record<string, unknown>} */ (d);
-    if (Array.isArray(inner.plugins)) {
-      return inner
-    }
-    if ('plugins' in inner) {
-      return inner
-    }
-  }
-  return d !== undefined && d !== null && typeof d === 'object' ? /** @type {object} */ (d) : o
-}
-
+const defaultVueCliJavaManifestListPath = '/frontend-plugins';
 function bridgePrefixesFromVueCliEnv() {
-  const base = (
-    typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API
-      ? String(process.env.VUE_APP_BASE_API)
-      : ''
-  ).replace(/\/$/, '');
-  const raw = [base ? `${base}/` : '', '/api/', '/dev-api/'].filter(Boolean);
-  return [...new Set(raw)]
+    const base = (typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API
+        ? String(process.env.VUE_APP_BASE_API)
+        : '').replace(/\/$/, '');
+    const raw = [base ? `${base}/` : '', '/api/', '/dev-api/'].filter(Boolean);
+    return [...new Set(raw)];
 }
-
-/**
- * @param {VueCliAxiosPresetDeps} deps
- * @param {Record<string, unknown>} [extra]
- */
 function createVueCliAxiosInstallOptions(deps, extra = {}) {
-  const { request } = deps;
-  if (typeof request !== 'function') {
-    throw new Error('[wep] createVueCliAxiosInstallOptions requires deps.request')
-  }
-  const envBase = (
-    typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API
-      ? String(process.env.VUE_APP_BASE_API)
-      : ''
-  ).replace(/\/$/, '');
-  const userBase =
-    extra.manifestBase !== undefined && String(extra.manifestBase).trim() !== ''
-      ? String(extra.manifestBase).replace(/\/$/, '')
-      : '';
-  const stripBase = userBase || envBase;
-
-  const fetchManifest = async (ctx) => {
-    try {
-      const url = resolveManifestPathUnderApiBase(ctx.manifestUrl, stripBase);
-      const body = await request({
-        url,
-        method: 'get'
-      });
-      const data = unwrapNestedManifestBody(body);
-      if (!data || typeof data !== 'object') {
-        return {
-          ok: false,
-          error: new Error('[wep] invalid manifest response'),
-          data: null
+    const { request } = deps;
+    if (typeof request !== 'function') {
+        throw new Error('[wep] createVueCliAxiosInstallOptions requires deps.request');
+    }
+    const { fetchManifest: userFetchManifest, manifestMode: extraManifestMode, staticManifestUrl: extraStaticManifestUrl, ...restExtra } = extra;
+    const envBase = (typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API
+        ? String(process.env.VUE_APP_BASE_API)
+        : '').replace(/\/$/, '');
+    const userBase = extra.manifestBase !== undefined && String(extra.manifestBase).trim() !== ''
+        ? String(extra.manifestBase).replace(/\/$/, '')
+        : '';
+    const stripBase = userBase || envBase;
+    const manifestMode = resolveManifestModeFromInputs(extraManifestMode);
+    const staticManifestUrl = resolveStaticManifestUrlFromInputs(extraStaticManifestUrl);
+    const fetchManifestApi = async (ctx) => {
+        try {
+            const url = resolveManifestPathUnderApiBase(ctx.manifestUrl, stripBase);
+            const body = await request({
+                url,
+                method: 'get'
+            });
+            const data = unwrapNestedManifestBody(body);
+            if (!data || typeof data !== 'object') {
+                return {
+                    ok: false,
+                    error: new Error('[wep] invalid manifest response'),
+                    data: null
+                };
+            }
+            return { ok: true, data };
         }
-      }
-      return { ok: true, data }
-    } catch (e) {
-      return { ok: false, error: e, data: null }
-    }
-  };
-
-  const opts = {
-    manifestBase: stripBase || undefined,
-    bridgeAllowedPathPrefixes: bridgePrefixesFromVueCliEnv(),
-    fetchManifest,
-    ...extra
-  };
-
-  const listPath =
-    typeof process !== 'undefined' && process.env && process.env.VUE_APP_WEB_PLUGIN_MANIFEST_PATH;
-  if (listPath && opts.manifestListPath === undefined && extra.manifestListPath === undefined) {
-    opts.manifestListPath = String(listPath);
-  }
-
-  return opts
+        catch (e) {
+            return { ok: false, error: e, data: null };
+        }
+    };
+    const fetchManifestStatic = (ctx) => fetchStaticManifestViaHttp(ctx);
+    const fetchManifest = typeof userFetchManifest === 'function'
+        ? userFetchManifest
+        : manifestMode === 'static'
+            ? fetchManifestStatic
+            : fetchManifestApi;
+    const opts = {
+        manifestBase: stripBase || undefined,
+        bridgeAllowedPathPrefixes: bridgePrefixesFromVueCliEnv(),
+        manifestMode,
+        staticManifestUrl,
+        ...restExtra,
+        fetchManifest
+    };
+    const listPath = typeof process !== 'undefined' &&
+        process.env &&
+        process.env[webExtendPluginEnvKeys.manifestPathAlt];
+    if (listPath && opts.manifestListPath === undefined && extra.manifestListPath === undefined) {
+        opts.manifestListPath = String(process.env[webExtendPluginEnvKeys.manifestPathAlt]);
+    }
+    return opts;
+}
+/**
+ * 少样板接入：`hostContext` 自动含 `router`（及可选 `store`）、`isDev` 与常见 `manifestListPath` 默认值。
+ * 更多运行时字段仍可通过 `extra` 覆盖。
+ */
+function createVueCliAxiosQuickInstallOptions(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+router, deps, extra = {}) {
+    const { request, hostLayoutComponent, store, hostContext: depHostContext } = deps;
+    const { hostContext: extraHostContext, isDev: extraIsDev, manifestListPath: extraListPath, ...restExtra } = extra;
+    const hostContext = {
+        router,
+        ...(store !== undefined ? { store } : {}),
+        ...(depHostContext && typeof depHostContext === 'object' ? depHostContext : {}),
+        ...(extraHostContext && typeof extraHostContext === 'object' ? extraHostContext : {})
+    };
+    const manifestListPath = extraListPath !== undefined && String(extraListPath).trim() !== ''
+        ? String(extraListPath)
+        : defaultVueCliJavaManifestListPath;
+    return createVueCliAxiosInstallOptions({ request }, {
+        hostLayoutComponent,
+        hostContext,
+        isDev: extraIsDev !== undefined ? Boolean(extraIsDev) : resolveBundledIsDev(),
+        manifestListPath,
+        ...restExtra
+    });
 }
-
 const presetVueCliAxios = Object.freeze({
-  id: 'vue-cli-axios',
-  description: 'Vue CLI + unified axios request; manifest uses host request()',
-  createInstallOptions: createVueCliAxiosInstallOptions,
-  manifestPathForApiBase: resolveManifestPathUnderApiBase,
-  unwrapManifestBody: unwrapNestedManifestBody
+    id: 'vue-cli-axios',
+    description: 'Vue CLI + axios request for API manifest; optional manifestMode=static uses fetch',
+    createInstallOptions: createVueCliAxiosInstallOptions,
+    createQuickInstallOptions: createVueCliAxiosQuickInstallOptions,
+    defaultJavaManifestListPath: defaultVueCliJavaManifestListPath,
+    manifestPathForApiBase: resolveManifestPathUnderApiBase,
+    unwrapManifestBody: unwrapNestedManifestBody
 });
 
 /**
- * 包对外稳定导出与 `WebExtendPluginVue2` 命名空间。
+ * Vue CLI + axios 场景的一键安装：合并 hostContext、默认清单路径与 IIFE 全局 Vue。
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function installVueCliAxiosWebPlugins(Vue, router, deps, extra) {
+    /** 避免输出 `?.`：Vue CLI 4 / Webpack 4 默认不转译 node_modules */
+    const exposeGlobalVue = extra == null || extra.exposeGlobalVue !== false;
+    if (exposeGlobalVue && typeof window !== 'undefined') {
+        window.Vue = Vue;
+    }
+    const { exposeGlobalVue: _skip, ...restExtra } = extra || {};
+    const opts = createVueCliAxiosQuickInstallOptions(router, deps, restExtra);
+    return installWebExtendPluginVue2(Vue, router, opts);
+}
 
-const {
-  bootstrapPlugins,
-  defaultFetchWebPluginManifest,
-  resolveRuntimeOptions
-} = pluginRuntime;
-
-const {
-  composeManifestFetch,
-  manifestFetchCacheMiddleware,
-  wrapManifestFetchWithCache
-} = manifestComposer;
-
+/**
+ * 包对外稳定导出与 `WebExtendPluginVue2` 命名空间。
+ */
+const { bootstrapPlugins, defaultFetchWebPluginManifest, resolveRuntimeOptions, ensurePluginHostRoute } = pluginRuntime;
+const { composeManifestFetch, manifestFetchCacheMiddleware, wrapManifestFetchWithCache } = manifestComposer;
 const WebExtendPluginVue2 = Object.freeze({
-  install: installWebExtendPluginVue2,
-  runtime: Object.freeze({
-    bootstrapPlugins: bootstrapPlugins$1,
-    resolveRuntimeOptions: resolveRuntimeOptions$1,
-    defaultFetchWebPluginManifest: defaultFetchWebPluginManifest$1,
-    composeManifestFetch: composeManifestFetch$1,
-    manifestFetchCacheMiddleware: manifestFetchCacheMiddleware$1,
-    wrapManifestFetchWithCache: wrapManifestFetchWithCache$1
-  }),
-  host: Object.freeze({
-    createHostApi,
-    disposeWebPlugin,
-    createRequestBridge,
-    registries
-  }),
-  config: Object.freeze({
-    defaultWebExtendPluginRuntime,
-    setWebExtendPluginEnv
-  }),
-  constants: Object.freeze({
-    HOST_PLUGIN_API_VERSION,
-    RUNTIME_CONSOLE_LABEL
-  }),
-  components: Object.freeze({
-    ExtensionPoint
-  }),
-  presets: Object.freeze({
-    vueCliAxios: presetVueCliAxios
-  })
+    install: installWebExtendPluginVue2,
+    runtime: Object.freeze({
+        bootstrapPlugins: bootstrapPlugins$1,
+        resolveRuntimeOptions: resolveRuntimeOptions$1,
+        ensurePluginHostRoute: ensurePluginHostRoute$1,
+        defaultFetchWebPluginManifest: defaultFetchWebPluginManifest$1,
+        composeManifestFetch: composeManifestFetch$1,
+        manifestFetchCacheMiddleware: manifestFetchCacheMiddleware$1,
+        wrapManifestFetchWithCache: wrapManifestFetchWithCache$1
+    }),
+    host: Object.freeze({
+        createHostApi,
+        disposeWebPlugin,
+        createRequestBridge,
+        registries,
+        buildMenuDescriptorsFromRoutes,
+        getRegisteredTopRouteNamesForPlugin
+    }),
+    config: Object.freeze({
+        defaultWebExtendPluginRuntime,
+        setWebExtendPluginEnv,
+        webExtendPluginEnvKeys,
+        defaultManifestFetchCache,
+        defaultManifestMode,
+        routeSynthNamePrefix,
+        peerMinimumVersions
+    }),
+    constants: Object.freeze({
+        HOST_PLUGIN_API_VERSION,
+        RUNTIME_CONSOLE_LABEL
+    }),
+    components: Object.freeze({
+        ExtensionPoint
+    }),
+    presets: Object.freeze({
+        vueCliAxios: presetVueCliAxios
+    })
 });
 
 exports.ExtensionPoint = ExtensionPoint;
@@ -4443,20 +4650,31 @@ 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;
 exports.createVueCliAxiosInstallOptions = createVueCliAxiosInstallOptions;
+exports.createVueCliAxiosQuickInstallOptions = createVueCliAxiosQuickInstallOptions;
 exports.defaultFetchWebPluginManifest = defaultFetchWebPluginManifest;
+exports.defaultManifestFetchCache = defaultManifestFetchCache;
+exports.defaultManifestMode = defaultManifestMode;
+exports.defaultVueCliJavaManifestListPath = defaultVueCliJavaManifestListPath;
 exports.defaultWebExtendPluginRuntime = defaultWebExtendPluginRuntime;
 exports.disposeWebPlugin = disposeWebPlugin;
+exports.ensurePluginHostRoute = ensurePluginHostRoute;
+exports.getRegisteredTopRouteNamesForPlugin = getRegisteredTopRouteNamesForPlugin;
+exports.installVueCliAxiosWebPlugins = installVueCliAxiosWebPlugins;
 exports.installWebExtendPluginVue2 = installWebExtendPluginVue2;
 exports.manifestFetchCacheMiddleware = manifestFetchCacheMiddleware;
+exports.peerMinimumVersions = peerMinimumVersions;
 exports.presetVueCliAxios = presetVueCliAxios;
 exports.registries = registries;
 exports.resolveManifestPathUnderApiBase = resolveManifestPathUnderApiBase;
 exports.resolveRuntimeOptions = resolveRuntimeOptions;
+exports.routeSynthNamePrefix = routeSynthNamePrefix;
 exports.setWebExtendPluginEnv = setWebExtendPluginEnv;
 exports.unwrapNestedManifestBody = unwrapNestedManifestBody;
+exports.webExtendPluginEnvKeys = webExtendPluginEnvKeys;
 exports.wrapManifestFetchWithCache = wrapManifestFetchWithCache;
 //# sourceMappingURL=index.cjs.map