web-extend-plugin-vue2 0.2.2 → 0.2.3

package/dist/index.cjs

@@ -7,107 +7,62 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var Vue__default = /*#__PURE__*/_interopDefault(Vue);
 
 /**
- * 宿主可覆盖的默认运行时配置（路径、白名单、超时等）。
- * 使用方式：`resolveRuntimeOptions({ ...defaultWebExtendPluginRuntime, manifestListPath: '/api/my-plugins' })`
- * 或只传需要改动的字段：`resolveRuntimeOptions({ manifestListPath: '/api/my-plugins' })`。
- *
- * @module default-runtime-config
+ * `resolveRuntimeOptions` 的默认值来源；宿主可只覆盖部分字段。
  */
-
-/**
- * @typedef {typeof defaultWebExtendPluginRuntime} WebExtendPluginDefaultRuntime
- */
-
 const defaultWebExtendPluginRuntime = {
-  /** 清单 HTTP 服务前缀（与后端 context-path 对齐），不含尾部 `/` */
   manifestBase: '/fp-api',
-
-  /**
-   * 拉取插件清单的 **路径段**（以 `/` 开头），拼在 `manifestBase` 之后。
-   * 完整 URL：`{manifestBase}{manifestListPath}` → 默认 `/fp-api/api/frontend-plugins`
-   */
   manifestListPath: '/api/frontend-plugins',
-
-  /** 清单 `fetch` 的 `credentials`，需 Cookie 会话时用 `include` */
   manifestFetchCredentials: 'include',
-
-  /** 插件 dev 服务存活探测路径（拼在 `webPluginDevOrigin` 后） */
   devPingPath: '/__web_plugin_dev_ping',
-
-  /** 插件 dev 热更新 SSE 路径（拼在插件 dev 的 origin 后） */
   devReloadSsePath: '/__web_plugin_reload_stream',
-
-  /** 隐式 dev 映射里，每个 id 对应的入口路径（相对插件 dev origin） */
   webPluginDevEntryPath: '/src/plugin-entry.js',
-
-  /** `fetch(devPingUrl)` 超时毫秒数 */
   devPingTimeoutMs: 500,
-
-  /**
-   * **隐式 dev 映射**（可选）：开发模式下若 `webPluginDevOrigin` 上 ping 成功，运行时会为若干插件 id 自动生成
-   * `{ id → origin + webPluginDevEntryPath }`，从而用 dev 服务入口替代清单里的 dist，便于热更新联调。
-   *
-   * 插件 id 来源优先级：`webPluginDevIds`（或 `VITE_WEB_PLUGIN_DEV_IDS`）→ 本字段。**默认 `[]`**，
-   * 避免把仓库示例 id 写进通用宿主；联调时在 `.env` 里设 `VITE_WEB_PLUGIN_DEV_IDS=com.xxx,com.yyy`，
-   * 或 `resolveRuntimeOptions({ defaultImplicitDevPluginIds: ['com.xxx'] })` 即可。
-   */
   defaultImplicitDevPluginIds: [],
-
-  /**
-   * 允许通过 `<script>` / 动态 `import()` 加载的插件脚本所在主机名（小写），防误配公网 URL。
-   */
   allowedScriptHosts: ['localhost', '127.0.0.1', '::1'],
-
-  /**
-   * `hostApi.getBridge().request(path)` 允许的 path 前缀；须以 `/` 开头。
-   * 需与后端实际 API 前缀一致。
-   */
   bridgeAllowedPathPrefixes: ['/api/']
 };
 
 /**
- * 不依赖 `import.meta`，兼容 Webpack 4/5、Vue CLI、Vite、Rspack 等宿主。
- * - Webpack / Vue CLI：依赖构建时注入的 `process.env`（如 `VUE_APP_*`、`DefinePlugin` 注入的 `VITE_*`）。
- * - Vite：在入口调用 `setWebExtendPluginEnv(import.meta.env)`，或 `installWebExtendPluginVue2(..., { env: import.meta.env })`。
- * - 也可在入口前设置 `globalThis.__WEP_ENV__ = import.meta.env`（与 setWebExtendPluginEnv 二选一即可）。
- *
- * @module bundled-env
+ * 与具体打包器解耦的运行时环境读取：优先显式注入，其次 `globalThis.__WEP_ENV__`，再读 `process.env`。
+ * Vite 宿主建议在入口调用 `setWebExtendPluginEnv(import.meta.env)`。
  */
 
 /** @type {Record<string, unknown> | null} */
-let _explicitEnv = null;
+let _injected = null;
 
 /**
- * 显式注入与 `import.meta.env` 同形态的对象（推荐 Vite 宿主在入口调用一次）。
+ * 注入与 `import.meta.env` 同形态的对象（键如 `VITE_*`、`DEV`）。
  * @param {Record<string, unknown> | null | undefined} env
  */
 function setWebExtendPluginEnv(env) {
-  _explicitEnv = env && typeof env === 'object' ? env : null;
+  _injected = env && typeof env === 'object' ? env : null;
 }
 
 /**
  * @returns {Record<string, unknown> | null}
  */
-function getInjectedEnvObject() {
-  if (_explicitEnv) {
-    return _explicitEnv
+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 (_) {}
+  } catch (_) {
+    /* ignore */
+  }
   return null
 }
 
 /**
- * 从注入环境读取字符串配置键（`VITE_*` / `PLUGIN_*` 等）。
+ * 读取注入环境中的字符串配置（`VITE_*` / `PLUGIN_*` 等价键由调用方传入）。
  * @param {string} key
  * @returns {string|undefined}
  */
 function readInjectedEnvKey(key) {
-  const o = getInjectedEnvObject();
+  const o = getEnvObject();
   if (!o || !(key in o)) {
     return undefined
   }
@@ -118,17 +73,14 @@ function readInjectedEnvKey(key) {
   return String(v)
 }
 
-/**
- * @returns {boolean}
- */
+/** @returns {boolean} */
 function readInjectedEnvDev() {
-  const o = getInjectedEnvObject();
+  const o = getEnvObject();
   return !!(o && o.DEV === true)
 }
 
 /**
- * 从注入环境与 `process.env` 解析 VITE_/PLUGIN_ 键。
- * @module runtime/env-resolve
+ * 从注入环境与 `process.env` 解析 `VITE_*` / `PLUGIN_*` 键。
  */
 
 /**
@@ -143,7 +95,9 @@ function readProcessEnv(key) {
         return String(v)
       }
     }
-  } catch (_) {}
+  } catch (_) {
+    /* ignore */
+  }
   return undefined
 }
 
@@ -174,20 +128,22 @@ function resolveBundledEnv(key, fallback = '') {
   return first === undefined || first === null ? fallback : first
 }
 
-/**
- * @returns {boolean}
- */
+/** @returns {boolean} */
 function resolveBundledIsDev() {
   try {
     if (readInjectedEnvDev()) {
       return true
     }
-  } catch (_) {}
+  } catch (_) {
+    /* ignore */
+  }
   try {
     if (typeof process !== 'undefined' && process.env && process.env.NODE_ENV === 'development') {
       return true
     }
-  } catch (_) {}
+  } catch (_) {
+    /* ignore */
+  }
   return false
 }
 
@@ -392,39 +348,24 @@ function resolveRuntimeOptions$1(user = {}) {
     allowedScriptHosts,
     bridgeAllowedPathPrefixes,
     bootstrapSummary: user.bootstrapSummary,
-    ...(typeof user.fetchManifest === 'function' ? { fetchManifest: user.fetchManifest } : {})
+    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 }
+      : {})
   }
 }
 
 /**
- * 默认清单 HTTP 拉取（未配置 `fetchManifest` 时）。
- * @module runtime/default-fetch-manifest
- */
-
-/**
- * @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` 时）。
- * @param {FetchWebPluginManifestContext} ctx
- * @returns {Promise<FetchWebPluginManifestResult>}
+ * 未配置 `fetchManifest` 时使用的清单 `fetch` 实现。
+ * @param {{ manifestUrl: string, credentials: RequestCredentials }} ctx
  */
 async function defaultFetchWebPluginManifest$1(ctx) {
   const { manifestUrl, credentials } = ctx;
@@ -3165,11 +3106,11 @@ function requireSemver () {
 var semverExports = requireSemver();
 var semver = /*@__PURE__*/getDefaultExportFromCjs(semverExports);
 
-/**
- * 与 `plugin-web-starter`（WebPluginsResponse）返回的 `hostPluginApiVersion` 保持一致，用于契约校验。
- * @type {string}
- */
-const HOST_PLUGIN_API_VERSION = '1.0.0';
+/** 与清单服务 `hostPluginApiVersion` 对齐，用于 `semver` 校验。 */
+const HOST_PLUGIN_API_VERSION = '1.0.0';
+
+/** 控制台日志与横幅使用的短名称。 */
+const RUNTIME_CONSOLE_LABEL = 'web-extend-plugin-vue2';
 
 /**
  * 开发模式插件 URL 映射（显式 JSON + 隐式 dev 探测）。
@@ -3191,7 +3132,7 @@ function parseWebPluginDevMapExplicit(opts) {
     const map = JSON.parse(String(raw));
     return map && typeof map === 'object' ? map : null
   } catch {
-    console.warn('[plugins] webPluginDevMapJson / VITE_WEB_PLUGIN_DEV_MAP is not valid JSON');
+    console.warn('[wep] invalid webPluginDevMapJson / VITE_WEB_PLUGIN_DEV_MAP');
     return null
   }
 }
@@ -3273,14 +3214,7 @@ async function buildImplicitWebPluginDevMap(opts, hostSet) {
     map[id] = `${base}${pathPart}`;
   }
   if (ids.length) {
-    console.info(
-      '[plugins] 已检测到插件 dev 服务（',
-      base,
-      '），下列 id 将加载隐式 dev 入口（',
-      pathPart,
-      '）而非清单 dist：',
-      ids.join(', ')
-    );
+    console.info('[wep] plugin dev server', base, '→ implicit entries', pathPart, ids.join(', '));
   }
   return map
 }
@@ -3348,10 +3282,10 @@ function startPluginDevReloadSse(origin, isDev, hostSet, ssePath) {
       window.location.reload();
     });
     es.onopen = () => {
-      console.info('[plugins] plugin dev reload SSE:', url);
+      console.info('[wep] dev reload SSE', url);
     };
   } catch (e) {
-    console.warn('[plugins] EventSource failed', url, e);
+    console.warn('[wep] EventSource failed', url, e);
   }
 }
 
@@ -3439,9 +3373,21 @@ function loadScript(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}`);
+  }
+}
+
 /**
- * 拉取清单、合并 dev 映射、加载入口并执行 activator。
- * @module runtime/bootstrap-plugins
+ * 拉取插件清单、加载入口脚本并调用各插件 `activator`。
  */
 
 /**
@@ -3474,7 +3420,7 @@ 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('[plugins] dev entry URL not allowed', p.id, devEntry);
+      console.warn('[wep] dev entry URL not allowed', p.id, devEntry);
       return
     }
     try {
@@ -3484,7 +3430,7 @@ async function loadPluginEntry(p, entryUrl, devMap, hostSet) {
         devEntry
       );
     } catch (e) {
-      console.warn('[plugins] dev module import failed, try manifest entryUrl', p.id, e);
+      console.warn('[wep] dev import failed, trying manifest entryUrl', p.id, e);
       if (entryUrl && isScriptHostAllowed(entryUrl, hostSet)) {
         await loadScript(entryUrl);
       }
@@ -3493,7 +3439,7 @@ async function loadPluginEntry(p, entryUrl, devMap, hostSet) {
     return
   }
   if (!entryUrl || !isScriptHostAllowed(entryUrl, hostSet)) {
-    console.warn('[plugins] skip (entryUrl not allowed)', p.id, entryUrl);
+    console.warn('[wep] skip (entryUrl not allowed)', p.id, entryUrl);
     return
   }
   await loadScript(entryUrl);
@@ -3501,14 +3447,15 @@ async function loadPluginEntry(p, entryUrl, devMap, hostSet) {
 
 /**
  * @param {import('vue-router').default} router
- * @param {(pluginId: string, router: import('vue-router').default, hostKit?: { bridgeAllowedPathPrefixes: string[] }) => object} createHostApiFactory
+ * @param {(pluginId: string, router: import('vue-router').default, hostKit?: object) => object} createHostApiFactory
  * @param {import('./resolve-runtime-options.js').WebExtendPluginRuntimeOptions} [runtimeOptions]
  */
 async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions) {
   if (typeof window === 'undefined') {
-    console.warn('[plugins] bootstrapPlugins skipped: requires browser (window)');
+    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}`;
@@ -3536,16 +3483,28 @@ async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions)
   const devMap = mergeDevMaps(implicit, explicit);
   startPluginDevSseForMap(devMap, opts.isDev, hostSet, opts.devReloadSsePath);
 
-  const hostKit = { bridgeAllowedPathPrefixes: opts.bridgeAllowedPathPrefixes };
+  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('[plugins] fetch manifest failed', manifestResult.error);
+      console.warn('[wep] fetch manifest failed', manifestResult.error);
     } else {
-      console.warn('[plugins] manifest HTTP', manifestResult.status, manifestUrl);
+      console.warn('[wep] manifest HTTP', manifestResult.status, manifestUrl);
     }
     if (shouldShowBootstrapSummary(opts)) {
-      console.info('[plugins] bootstrap_summary', { ok: false, reason: 'manifest_fetch' });
+      console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_fetch' });
     }
     return
   }
@@ -3553,7 +3512,7 @@ async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions)
   const data = manifestResult.data;
   if (!data) {
     if (shouldShowBootstrapSummary(opts)) {
-      console.info('[plugins] bootstrap_summary', { ok: false, reason: 'manifest_empty_body' });
+      console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_empty_body' });
     }
     return
   }
@@ -3564,12 +3523,10 @@ async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions)
     const maj = coerced ? coerced.major : 0;
     const range = `^${maj}.0.0`;
     if (!semver.satisfies(HOST_PLUGIN_API_VERSION, range, { includePrerelease: true })) {
-      console.warn(
-        '[plugins] host API version mismatch: host implements',
-        HOST_PLUGIN_API_VERSION,
-        'server declares',
-        apiVer
-      );
+      console.warn('[wep] host API version mismatch', {
+        host: HOST_PLUGIN_API_VERSION,
+        manifest: apiVer
+      });
     }
   }
 
@@ -3577,11 +3534,7 @@ async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions)
 
   const plugins = data.plugins || [];
   if (plugins.length === 0) {
-    console.info(
-      '[plugins] 清单为空。请检查：① 后端清单服务（plugin-web-starter）是否已接入；② web-plugin.web-plugins-dir 是否指向含各插件子目录及 manifest.json 的路径；③ 浏览器直接访问',
-      manifestUrl,
-      '是否返回 plugins 条目。'
-    );
+    console.info('[wep] empty plugin manifest — check backend and URL', manifestUrl);
   }
 
   const summary = {
@@ -3596,7 +3549,7 @@ async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions)
   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('[plugins] skip (engines.host)', p.id, range);
+      console.warn('[wep] skip plugin (engines.host)', p.id, range);
       summary.skipEngines++;
       continue
     }
@@ -3604,39 +3557,34 @@ async function bootstrapPlugins$1(router, createHostApiFactory, runtimeOptions)
     try {
       await loadPluginEntry(p, entryUrl, devMap, hostSet);
     } catch (e) {
-      console.warn('[plugins] script load failed', p.id, 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('[plugins] no activator for', p.id);
+      console.warn('[wep] no activator for', p.id);
       summary.skipNoActivator++;
       continue
     }
     const hostApi = createHostApiFactory(p.id, router, hostKit);
     try {
-      activator(hostApi);
+      const pluginRecord = Object.freeze({ ...p });
+      activator(hostApi, { pluginRecord });
       summary.activated++;
     } catch (e) {
-      console.error('[plugins] activate failed', p.id, e);
+      console.error('[wep] activate failed', p.id, e);
       summary.activateFail++;
     }
   }
 
   if (shouldShowBootstrapSummary(opts)) {
-    console.info('[plugins] bootstrap_summary', { ok: true, ...summary });
+    console.info('[wep] bootstrap_summary', { ok: true, ...summary });
   }
 }
 
 /**
- * 宿主侧插件引导：拉取清单、dev 映射、加载入口脚本、调用 activator。
- * 实现已拆至 `src/runtime/` 下各模块；本文件保留模块说明与对外类型约定，并 re-export 稳定 API。
- *
- * **Webpack 宿主**：用 `DefinePlugin` 注入 `process.env.VITE_*` 或 **`PLUGIN_*`**（等价键），或 `resolveRuntimeOptions` 显式传参。
- * **Vite 宿主**：入口调用 `setWebExtendPluginEnv(import.meta.env)`，或 `installWebExtendPluginVue2(..., { env: import.meta.env })`。
- *
- * @module PluginRuntime
+ * 运行时引导相关 API 的聚合导出（实现位于 `./runtime/`）。
  */
 
 var pluginRuntime = /*#__PURE__*/Object.freeze({
@@ -3648,7 +3596,7 @@ var pluginRuntime = /*#__PURE__*/Object.freeze({
 
 /**
  * 清单拉取函数的组合工具：缓存、埋点等以**中间件**形式扩展，不侵入 `bootstrapPlugins` 核心逻辑，
- * 符合第三方依赖「可组合、可替换」约定。契约与 `PluginRuntime` 中 `fetchManifest` 一致。
+ * 可组合的 `fetchManifest` 包装；入参/出参与 `resolveRuntimeOptions({ fetchManifest })` 一致。
  *
  * @module runtime/manifest-fetch-composer
  */
@@ -3863,356 +3811,367 @@ var manifestComposer = /*#__PURE__*/Object.freeze({
   wrapManifestFetchWithCache: wrapManifestFetchWithCache$1
 });
 
-/**
- * 插件通过宿主访问后端的受控通道：仅允许配置的前缀路径，默认 `/api/`；强制默认 `same-origin` 携带 Cookie。
- * 前缀列表由 `createRequestBridge({ allowedPathPrefixes })` 传入，与 `defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes` 对齐。
- *
- * @module bridge
- */
-
-/**
- * @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 {
-    /**
-     * 发起受控 `fetch`。
-     * @param {string} path 必须以 `/` 开头，且匹配某一 `allowedPathPrefixes` 前缀
-     * @param {RequestInit} [init] 会与默认 `{ credentials: 'same-origin' }` 合并（后者可被覆盖）
-     */
-    async request(path, init = {}) {
-      if (typeof path !== 'string' || !path.startsWith('/')) {
-        throw new Error('[bridge] path must be a string starting with /')
-      }
-      const allowed = allowedPathPrefixes.some((p) => path.startsWith(p));
-      if (!allowed) {
-        throw new Error('[bridge] path not allowed: ' + path)
-      }
-      return fetch(path, {
-        credentials: 'same-origin',
-        ...init
-      })
-    }
-  }
+/**
+ * 插件访问后端的受控通道：`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` 订阅。
- *
- * @module registries
- */
-
-/**
- * @type {{
- *   menus: object[],
- *   slots: Record<string, Array<{ pluginId: string, component: import('vue').Component, priority: number, key: string }>>
- * }}
- */
-const registries = Vue__default.default.observable({
-  menus: [],
-  /** 扩展点 id → 已注册组件列表（内容区 / 工具栏等共用模型） */
-  slots: {},
-  /**
-   * 每次变更 slots 时递增，供 ExtensionPoint 计算属性显式依赖。
-   * Vue 2 对「先访问不存在的 slots[key]、后 Vue.set 补 key」的依赖收集不可靠，会导致扩展点不刷新。
-   */
-  slotRevision: 0
+/**
+ * 宿主侧响应式注册表：插件菜单与扩展点槽位（供布局与 `ExtensionPoint` 消费）。
+ */
+
+/**
+ * @type {{
+ *   menus: object[],
+ *   slots: Record<string, Array<{ pluginId: string, component: import('vue').Component, priority: number, key: string }>>
+ * }}
+ */
+const registries = Vue__default.default.observable({
+  menus: [],
+  slots: {},
+  /** 槽位变更计数；缓解 Vue2 对动态 `Vue.set(slots, key)` 的依赖收集不完整。 */
+  slotRevision: 0
 });
 
-/**
- * 按 `pluginId` 收集 `onTeardown` 回调，供 `disposeWebPlugin` 统一执行。
- *
- * @module teardown-registry
- */
-
-/** @type {Map<string, Function[]>} */
-const byPlugin = new Map();
-
-/**
- * 登记插件卸载时要执行的同步回调（建议只做解绑、清定时器等轻量逻辑）。
- * @param {string} pluginId
- * @param {() => void} fn
- */
-function registerPluginTeardown(pluginId, fn) {
-  if (typeof fn !== 'function') {
-    return
-  }
-  let arr = byPlugin.get(pluginId);
-  if (!arr) {
-    arr = [];
-    byPlugin.set(pluginId, arr);
-  }
-  arr.push(fn);
-}
-
-/**
- * 执行并清空该插件已登记的全部 teardown；调用后 Map 中不再保留该 id。
- * @param {string} pluginId
- */
-function runPluginTeardowns(pluginId) {
-  const arr = byPlugin.get(pluginId);
-  if (!arr) {
-    return
-  }
-  byPlugin.delete(pluginId);
-  for (const fn of arr) {
-    try {
-      fn();
-    } catch (e) {
-      console.warn('[plugins] teardown failed', pluginId, e);
-    }
-  }
+/**
+ * 按插件 id 收集 `onTeardown` 回调，供 `disposeWebPlugin` 统一执行。
+ */
+
+/** @type {Map<string, Array<() => void>>} */
+const _byPlugin = new Map();
+
+/**
+ * @param {string} pluginId
+ * @param {() => void} fn
+ */
+function registerPluginTeardown(pluginId, fn) {
+  if (typeof fn !== 'function') {
+    return
+  }
+  let list = _byPlugin.get(pluginId);
+  if (!list) {
+    list = [];
+    _byPlugin.set(pluginId, list);
+  }
+  list.push(fn);
 }
 
-/**
- * 构造供插件 activator 调用的宿主 API（路由、菜单、扩展点、资源注入等）。
- * 与打包工具无关；Webpack 宿主需已配置 `vue-loader` 以编译本包内的 `.vue` 依赖。
- *
- * @module createHostApi
- */
-
-/** 扩展点列表项 key 递增，避免用 Date.now() 导致列表重排时误卸载组件 */
-let slotItemKeySeq = 0;
-/** 无 name 的动态路由合成名递增，避免多次 registerRoutes 重名 */
-let routeSynthSeq = 0;
-
-/**
- * @typedef {object} RegisterSlotEntry
- * @property {import('vue').Component} component
- * @property {number} [priority]
- */
-
-/**
- * @typedef {object} HostApi
- * @property {string} hostPluginApiVersion 宿主实现的协议版本
- * @property {(routes: import('vue-router').RouteConfig[]) => void} registerRoutes 注册路由；无 `name` 时自动生成稳定合成名；优先 `router.addRoute`
- * @property {(items: object[]) => void} registerMenuItems 注册菜单并按 `order` 排序
- * @property {(pointId: string, components: RegisterSlotEntry[]) => void} registerSlotComponents 向扩展点挂载组件
- * @property {(urls?: string[]) => void} registerStylesheetUrls 注入 `link[rel=stylesheet]`，带 `data-plugin-asset`
- * @property {(urls?: string[]) => void} registerScriptUrls 顺序注入外链脚本
- * @property {() => void} registerSanitizedHtmlSnippet MVP 未实现，调用即抛错
- * @property {() => ReturnType<typeof createRequestBridge>} getBridge 受控 `fetch` 代理
- * @property {(pluginId: string, fn: () => void) => void} onTeardown 注册卸载回调；由 `disposeWebPlugin(pluginId)` 触发
- */
-
-/**
- * @typedef {object} HostKitOptions
- * @property {string[]} [bridgeAllowedPathPrefixes] 覆盖 `getBridge().request` 允许的 URL 前缀；默认见 `defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes`
- */
-
-/**
- * 创建单个插件在宿主侧的 API 句柄，传入插件 `activator(hostApi)`。
- *
- * `bootstrapPlugins` 始终以 `(pluginId, router, hostKitOptions)` 调用工厂；请使用 `(id, r, kit) => createHostApi(id, r, kit)` 传入 `bridgeAllowedPathPrefixes`。
- * 单参工厂 `(id) => createHostApi(id, router)` 仍可用（忽略后两个实参），此时 bridge 仅用包内默认前缀。
- *
- * @param {string} pluginId 与 manifest.id 一致
- * @param {import('vue-router').default} router 宿主 Vue Router 实例（vue-router@3）
- * @param {HostKitOptions} [hostKitOptions]
- * @returns {HostApi}
- */
-function createHostApi(pluginId, router, hostKitOptions = {}) {
-  const bridgePrefixes =
-    Array.isArray(hostKitOptions.bridgeAllowedPathPrefixes) &&
-    hostKitOptions.bridgeAllowedPathPrefixes.length > 0
-      ? hostKitOptions.bridgeAllowedPathPrefixes
-      : defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes;
-  const bridge = createRequestBridge({ allowedPathPrefixes: bridgePrefixes });
-
-  /**
-   * 注入样式表；`disposeWebPlugin` 会按 `data-plugin-asset` 移除对应节点。
-   * @param {string} href
-   */
-  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
-   * @returns {Promise<void>}
-   */
-  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,
-
-    /**
-     * 动态注册路由。Vue Router 3.5+ 推荐 `addRoute`；若不存在则回退已弃用的 `addRoutes`。
-     * @param {import('vue-router').RouteConfig[]} routes
-     */
-    registerRoutes(routes) {
-      const wrapped = routes.map((r) => ({
-        ...r,
-        name: r.name || `__wep_${pluginId}_${routeSynthSeq++}`,
-        meta: { ...(r.meta || {}), pluginId }
-      }));
-      if (typeof router.addRoute === 'function') {
-        for (const r of wrapped) {
-          router.addRoute(r);
-        }
-      } else {
-        router.addRoutes(wrapped);
-      }
-    },
-
-    /**
-     * 写入全局菜单注册表（响应式）；按 `order` 升序排列。
-     * @param {object[]} items
-     */
-    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)
-      );
-    },
-
-    /**
-     * 向指定扩展点 id 注册 Vue 组件；`ExtensionPoint` 按 `priority` 降序渲染。
-     * @param {string} pointId
-     * @param {RegisterSlotEntry[]} components
-     */
-    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++;
-    },
-
-    /**
-     * @param {string[]|undefined} urls
-     */
-    registerStylesheetUrls(urls) {
-      for (const u of urls || []) {
-        if (typeof u === 'string' && u) {
-          injectStylesheet(u);
-        }
-      }
-    },
-
-    /**
-     * 串行加载多个脚本，失败仅告警不中断宿主。
-     * @param {string[]|undefined} urls
-     */
-    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('[plugins] registerScriptUrls', pluginId, e));
-    },
-
-    registerSanitizedHtmlSnippet() {
-      throw new Error('registerSanitizedHtmlSnippet is not enabled in MVP')
-    },
-
-    getBridge: () => bridge,
-
-    /**
-     * 插件卸载前清理逻辑；第一个参数为预留与协议对齐，实际以创建 API 时的 `pluginId` 为准。
-     * @param {string} _pluginId 预留，与 manifest.id 一致时可传入
-     * @param {() => void} fn
-     */
-    onTeardown(_pluginId, fn) {
-      if (typeof fn === 'function') {
-        registerPluginTeardown(pluginId, fn);
-      }
-    }
-  }
+/**
+ * @param {string} pluginId
+ */
+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);
+    }
+  }
 }
 
-/**
- * 单插件卸载：与 `bootstrapPlugins` / `createHostApi` 对称，清理注册表与 DOM 副作用。
- *
- * @module dispose-plugin
- */
-
-/**
- * 卸载指定 id 的插件：依次执行 teardown、移除菜单与扩展点条目、删除 activator、移除带 `data-plugin-asset` 的节点。
- *
- * **路由**：Vue Router 3 无公开 `removeRoute`，此处不改动 matcher；动态路由需整页刷新或自行维护路由表。
- *
- * @param {string} pluginId 与 manifest.id 一致
- */
-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();
-      }
-    });
-  }
+/**
+ * 构造插件 `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 }
 }
 
 /**
- * 在宿主布局中声明扩展点；插件通过 `hostApi.registerSlotComponents(pointId, ...)` 注入组件。
- * 使用纯 render 函数，便于 Rollup 发布 dist，宿主无需再转译 .vue。
+ * 单插件在宿主侧的 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 等字段一致
+ */
+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);
+        }
+      } else {
+        for (const r of wrapped) {
+          router.addRoute(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'
+          )
+        }
+        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}`
+        });
+      }
+      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);
+      }
+    }
+  }
+}
+
+/**
+ * 卸载单个插件：执行 teardown、清理注册表与 activator、移除带 `data-plugin-asset` 的 DOM。
+ * 注意：Vue Router 3 无公开 `removeRoute`，动态路由通常需整页刷新或宿主自行维护。
+ */
+
+/**
+ * @param {string} pluginId 与 manifest `id` 一致
+ */
+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();
+      }
+    });
+  }
+}
+
+/**
+ * 布局中的扩展点占位；插件通过 `hostApi.registerSlotComponents(pointId, ...)` 注入组件。
  */
 
 const SlotErrorBoundary = {
@@ -4223,7 +4182,7 @@ const SlotErrorBoundary = {
   },
   errorCaptured(err) {
     this.error = err && err.message ? err.message : String(err);
-    console.error('[ExtensionPoint] render error in', this.label, err);
+    console.error('[wep:ExtensionPoint]', this.label, err);
     return false
   },
   render(h) {
@@ -4278,17 +4237,13 @@ var ExtensionPoint = {
 };
 
 /**
- * 一键接入：注册 `ExtensionPoint` 并执行 `bootstrapPlugins`。
- * @module install
+ * 注册全局 `ExtensionPoint` 并异步拉取清单、激活插件。
  */
 
 /**
- * 注册全局组件 `ExtensionPoint` 并异步引导插件清单。
- *
  * @param {*} Vue
- * @param {*} router  vue-router 实例
- * @param {Record<string, unknown>} [options] 传给 `resolveRuntimeOptions` 的字段；可含 `env`（Vite 传入 `import.meta.env`）以读取 `VITE_*`。
- * @returns {Promise<void>}
+ * @param {*} router
+ * @param {Record<string, unknown>} [options] 传给 `resolveRuntimeOptions`；可含 `env` 以读取 `VITE_*`
  */
 function installWebExtendPluginVue2(Vue, router, options) {
   const opts = options || {};
@@ -4304,23 +4259,20 @@ function installWebExtendPluginVue2(Vue, router, options) {
 }
 
 /**
- * 预设：Vue CLI + 统一 axios（如若依 `utils/request`）。
- * 对外以 {@link presetVueCliAxios} 聚合；亦保留具名函数便于 tree-shaking。
- *
- * @module presets/vue-cli-axios
+ * Vue CLI + 统一 axios（如 RuoYi `utils/request`）场景的 `install` 预设。
  */
 
 /**
- * @typedef {object} VueCliAxiosInstallPresetDeps
- * @property {(config: { url: string, method?: string, [key: string]: unknown }) => Promise<unknown>} request 宿主 axios 封装（已含 baseURL、Token 等）
+ * @typedef {object} VueCliAxiosPresetDeps
+ * @property {(config: { url: string, method?: string }) => Promise<unknown>} request
  */
 
 /**
- * 将 `manifestBase + manifestListPath` 转为相对 `VUE_APP_BASE_API` 的路径（供 axios baseURL 拼接）。
+ * 将完整 manifest URL 转为相对 `apiBase` 的请求 path，供 axios `baseURL` 拼接。
  * @param {string} manifestUrl
  * @param {string} [apiBase]
  */
-function manifestPathForVueCliApiBase(manifestUrl, apiBase) {
+function resolveManifestPathUnderApiBase(manifestUrl, apiBase) {
   const base = String(
     apiBase !== undefined
       ? apiBase
@@ -4338,11 +4290,11 @@ function manifestPathForVueCliApiBase(manifestUrl, apiBase) {
 }
 
 /**
- * 兼容裸清单 JSON 与常见 `{ code, data: { plugins } }` 包装。
+ * 将裸 `{ plugins }` 与 `{ code, data: { plugins } }` 式响应解包为清单对象。
  * @param {unknown} body
  * @returns {object|null}
  */
-function unwrapTableStyleManifestBody(body) {
+function unwrapNestedManifestBody(body) {
   if (!body || typeof body !== 'object') {
     return null
   }
@@ -4374,15 +4326,13 @@ function bridgePrefixesFromVueCliEnv() {
 }
 
 /**
- * 生成可直接传给 `installWebExtendPluginVue2` 的 options（含 fetchManifest、manifestBase、bridge 前缀）。
- * @param {VueCliAxiosInstallPresetDeps} deps
- * @param {Record<string, unknown>} [extra] 合并覆盖，如 `manifestListPath`、`env` 等
- * @returns {Record<string, unknown>}
+ * @param {VueCliAxiosPresetDeps} deps
+ * @param {Record<string, unknown>} [extra]
  */
 function createVueCliAxiosInstallOptions(deps, extra = {}) {
   const { request } = deps;
   if (typeof request !== 'function') {
-    throw new Error('[web-extend-plugin-vue2] createVueCliAxiosInstallOptions({ request }) 需要宿主 request 函数')
+    throw new Error('[wep] createVueCliAxiosInstallOptions requires deps.request')
   }
   const envBase = (
     typeof process !== 'undefined' && process.env && process.env.VUE_APP_BASE_API
@@ -4397,16 +4347,16 @@ function createVueCliAxiosInstallOptions(deps, extra = {}) {
 
   const fetchManifest = async (ctx) => {
     try {
-      const url = manifestPathForVueCliApiBase(ctx.manifestUrl, stripBase);
+      const url = resolveManifestPathUnderApiBase(ctx.manifestUrl, stripBase);
       const body = await request({
         url,
         method: 'get'
       });
-      const data = unwrapTableStyleManifestBody(body);
+      const data = unwrapNestedManifestBody(body);
       if (!data || typeof data !== 'object') {
         return {
           ok: false,
-          error: new Error('[web-plugin] 清单响应格式无效'),
+          error: new Error('[wep] invalid manifest response'),
           data: null
         }
       }
@@ -4432,28 +4382,18 @@ function createVueCliAxiosInstallOptions(deps, extra = {}) {
   return opts
 }
 
-/**
- * Vue CLI + axios 预设的**对外聚合入口**（与具名导出函数等价，便于按需查阅与扩展多预设）。
- * @type {Readonly<{ id: string, description: string, createInstallOptions: typeof createVueCliAxiosInstallOptions, manifestPathForApiBase: typeof manifestPathForVueCliApiBase, unwrapManifestBody: typeof unwrapTableStyleManifestBody }>}
- */
 const presetVueCliAxios = Object.freeze({
   id: 'vue-cli-axios',
-  description: 'Vue CLI + 统一 axios 实例（如若依 utils/request），清单走宿主 request',
+  description: 'Vue CLI + unified axios request; manifest uses host request()',
   createInstallOptions: createVueCliAxiosInstallOptions,
-  manifestPathForApiBase: manifestPathForVueCliApiBase,
-  unwrapManifestBody: unwrapTableStyleManifestBody
+  manifestPathForApiBase: resolveManifestPathUnderApiBase,
+  unwrapManifestBody: unwrapNestedManifestBody
 });
 
 /**
- * 稳定对外 API：具名导出 + {@link WebExtendPluginVue2} 聚合对象。
- * 语义化版本内保持本文件导出的符号与聚合结构兼容。
- *
- * `PluginRuntime` 与 `manifest-fetch-composer` 通过 namespace 绑定到 `WebExtendPluginVue2.runtime`，避免具名导出与聚合对象重复列举。
- *
- * @module public
+ * 包对外稳定导出与 `WebExtendPluginVue2` 命名空间。
  */
 
-
 const {
   bootstrapPlugins,
   defaultFetchWebPluginManifest,
@@ -4466,18 +4406,6 @@ const {
   wrapManifestFetchWithCache
 } = manifestComposer;
 
-/**
- * 根命名空间：宿主可通过 `WebExtendPluginVue2.presets.vueCliAxios` 等路径发现能力，避免仅依赖散落的具名导出。
- * @type {Readonly<{
- *   install: typeof installWebExtendPluginVue2,
- *   runtime: Readonly<{ bootstrapPlugins: typeof pluginRuntime.bootstrapPlugins, resolveRuntimeOptions: typeof pluginRuntime.resolveRuntimeOptions, defaultFetchWebPluginManifest: typeof pluginRuntime.defaultFetchWebPluginManifest, composeManifestFetch: typeof manifestComposer.composeManifestFetch, manifestFetchCacheMiddleware: typeof manifestComposer.manifestFetchCacheMiddleware, wrapManifestFetchWithCache: typeof manifestComposer.wrapManifestFetchWithCache }>,
- *   host: Readonly<{ createHostApi: typeof createHostApi, disposeWebPlugin: typeof disposeWebPlugin, createRequestBridge: typeof createRequestBridge, registries: typeof registries }>,
- *   config: Readonly<{ defaultWebExtendPluginRuntime: typeof defaultWebExtendPluginRuntime, setWebExtendPluginEnv: typeof setWebExtendPluginEnv }>,
- *   constants: Readonly<{ HOST_PLUGIN_API_VERSION: typeof HOST_PLUGIN_API_VERSION }>,
- *   components: Readonly<{ ExtensionPoint: typeof ExtensionPoint }>,
- *   presets: Readonly<{ vueCliAxios: typeof presetVueCliAxios }>
- * }>}
- */
 const WebExtendPluginVue2 = Object.freeze({
   install: installWebExtendPluginVue2,
   runtime: Object.freeze({
@@ -4499,7 +4427,8 @@ const WebExtendPluginVue2 = Object.freeze({
     setWebExtendPluginEnv
   }),
   constants: Object.freeze({
-    HOST_PLUGIN_API_VERSION
+    HOST_PLUGIN_API_VERSION,
+    RUNTIME_CONSOLE_LABEL
   }),
   components: Object.freeze({
     ExtensionPoint
@@ -4511,6 +4440,7 @@ const WebExtendPluginVue2 = Object.freeze({
 
 exports.ExtensionPoint = ExtensionPoint;
 exports.HOST_PLUGIN_API_VERSION = HOST_PLUGIN_API_VERSION;
+exports.RUNTIME_CONSOLE_LABEL = RUNTIME_CONSOLE_LABEL;
 exports.WebExtendPluginVue2 = WebExtendPluginVue2;
 exports.bootstrapPlugins = bootstrapPlugins;
 exports.composeManifestFetch = composeManifestFetch;
@@ -4522,11 +4452,11 @@ exports.defaultWebExtendPluginRuntime = defaultWebExtendPluginRuntime;
 exports.disposeWebPlugin = disposeWebPlugin;
 exports.installWebExtendPluginVue2 = installWebExtendPluginVue2;
 exports.manifestFetchCacheMiddleware = manifestFetchCacheMiddleware;
-exports.manifestPathForVueCliApiBase = manifestPathForVueCliApiBase;
 exports.presetVueCliAxios = presetVueCliAxios;
 exports.registries = registries;
+exports.resolveManifestPathUnderApiBase = resolveManifestPathUnderApiBase;
 exports.resolveRuntimeOptions = resolveRuntimeOptions;
 exports.setWebExtendPluginEnv = setWebExtendPluginEnv;
-exports.unwrapTableStyleManifestBody = unwrapTableStyleManifestBody;
+exports.unwrapNestedManifestBody = unwrapNestedManifestBody;
 exports.wrapManifestFetchWithCache = wrapManifestFetchWithCache;
 //# sourceMappingURL=index.cjs.map