web-extend-plugin-vue2 0.3.5 → 0.3.7

package/dist/index.mjs

@@ -225,21 +225,35 @@ function isScriptHostAllowed(url, hostSet) {
     }
 }
 
-/**
- * 合并用户、环境与默认配置得到运行时选项。
- */
 const DEF = defaultWebExtendPluginRuntime;
 const EK = webExtendPluginEnvKeys;
+function asRecord$1(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function normalizeHostBridge(userVal) {
+    const raw = asRecord$1(userVal);
+    if (!raw) {
+        return undefined;
+    }
+    const normalized = {};
+    if (raw.modules && typeof raw.modules === 'object' && !Array.isArray(raw.modules)) {
+        normalized.modules = { ...raw.modules };
+    }
+    if (raw.components && typeof raw.components === 'object' && !Array.isArray(raw.components)) {
+        normalized.components = { ...raw.components };
+    }
+    return normalized.modules || normalized.components ? normalized : undefined;
+}
 function resolveManifestCredentials(userVal, envKey, fallback) {
     if (userVal !== undefined) {
-        const s = String(userVal);
-        if (s === 'include' || s === 'omit' || s === 'same-origin') {
-            return s;
+        const normalized = String(userVal);
+        if (normalized === 'include' || normalized === 'omit' || normalized === 'same-origin') {
+            return normalized;
         }
     }
-    const e = resolveBundledEnv(envKey, '');
-    if (e === 'include' || e === 'omit' || e === 'same-origin') {
-        return e;
+    const envValue = resolveBundledEnv(envKey, '');
+    if (envValue === 'include' || envValue === 'omit' || envValue === 'same-origin') {
+        return envValue;
     }
     return fallback;
 }
@@ -248,167 +262,184 @@ function resolvePositiveInt(userVal, envKey, fallback) {
         return Math.floor(userVal);
     }
     const raw = resolveBundledEnv(envKey, '');
-    const n = raw ? parseInt(raw, 10) : NaN;
-    if (Number.isFinite(n) && n > 0) {
-        return n;
+    const parsed = raw ? parseInt(raw, 10) : NaN;
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function normalizeStringList$1(value) {
+    if (Array.isArray(value)) {
+        return value.map(String).map((item) => item.trim()).filter(Boolean);
     }
-    return fallback;
+    if (typeof value === 'string' && value.trim()) {
+        return value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+function resolveAllowedScriptHosts(value) {
+    const raw = normalizeStringList$1(value);
+    return raw.length > 0 ? raw.map(normalizeHost).filter(Boolean) : [];
+}
+function resolvePathPrefixes(value) {
+    const raw = normalizeStringList$1(value);
+    return raw.length > 0 ? raw.map((item) => ensureLeadingPath(item)).filter(Boolean) : [];
+}
+function resolveBoolean(value) {
+    if (value === true || value === false) {
+        return value;
+    }
+    return undefined;
+}
+function resolveManifestInput(user) {
+    return asRecord$1(user.manifest) || {};
+}
+function resolveHostInput(user) {
+    return asRecord$1(user.host) || {};
+}
+function resolveDevInput(user) {
+    return asRecord$1(user.dev) || {};
+}
+function resolveHooksInput(user) {
+    return asRecord$1(user.hooks) || {};
+}
+function resolveDevPluginIds(dev) {
+    const explicit = normalizeStringList$1(dev.pluginIds);
+    if (explicit.length > 0) {
+        return explicit;
+    }
+    const fromEnv = normalizeStringList$1(resolveBundledEnv(EK.webPluginDevIds, ''));
+    if (fromEnv.length > 0) {
+        return fromEnv;
+    }
+    const implicit = normalizeStringList$1(resolveBundledEnv(EK.implicitDevIds, ''));
+    return implicit.length > 0 ? implicit : [...DEF.defaultImplicitDevPluginIds];
+}
+function resolveDevManifestFallback(dev, manifestMode, isDev) {
+    if (manifestMode === 'static') {
+        return false;
+    }
+    const direct = resolveBoolean(dev.manifestFallback && dev.manifestFallback.enabled);
+    if (direct !== undefined) {
+        return direct;
+    }
+    const envFlag = resolveBundledEnv(EK.devManifestFallback, '');
+    if (envFlag === '0' || envFlag === 'false') {
+        return false;
+    }
+    if (envFlag === '1' || envFlag === 'true') {
+        return true;
+    }
+    return isDev;
 }
-/** 合并用户、环境变量与 `defaultWebExtendPluginRuntime`，得到完整运行时选项（宿主可只传需要覆盖的字段）。 */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function resolveRuntimeOptions$1(user = {}) {
-    const manifestBaseRaw = user.manifestBase !== undefined && user.manifestBase !== ''
-        ? String(user.manifestBase)
+    const manifest = resolveManifestInput(user);
+    const host = resolveHostInput(user);
+    const hostRoute = asRecord$1(host.route) || {};
+    const dev = resolveDevInput(user);
+    const devFallback = asRecord$1(dev.manifestFallback) || {};
+    const hooks = resolveHooksInput(user);
+    const normalizedHostBridge = normalizeHostBridge(host.bridge);
+    const manifestBaseRaw = manifest.baseUrl !== undefined && String(manifest.baseUrl).trim() !== ''
+        ? String(manifest.baseUrl)
         : resolveBundledEnv(EK.manifestBase, DEF.manifestBase) || DEF.manifestBase;
-    const manifestListPath = ensureLeadingPath(user.manifestListPath !== undefined && user.manifestListPath !== ''
-        ? user.manifestListPath
+    const manifestListPath = ensureLeadingPath(manifest.listPath !== undefined && String(manifest.listPath).trim() !== ''
+        ? manifest.listPath
         : 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 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];
-        })();
-    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 allowedScriptHosts = (() => {
+        const explicit = resolveAllowedScriptHosts(host.scriptHosts);
+        if (explicit.length > 0) {
+            return explicit;
         }
-        const e = resolveBundledEnv(EK.devFallbackManifestUrl, '');
-        if (e) {
-            return e.trim();
+        const fromEnv = resolveAllowedScriptHosts(resolveBundledEnv(EK.allowedScriptHosts, ''));
+        return fromEnv.length > 0 ? fromEnv : [...DEF.allowedScriptHosts];
+    })();
+    const bridgeAllowedPathPrefixes = (() => {
+        const explicit = resolvePathPrefixes(host.requestPathPrefixes);
+        if (explicit.length > 0) {
+            return explicit;
+        }
+        const fromEnv = resolvePathPrefixes(resolveBundledEnv(EK.bridgePrefixes, ''));
+        return fromEnv.length > 0 ? fromEnv : [...DEF.bridgeAllowedPathPrefixes];
+    })();
+    const manifestMode = resolveManifestModeFromInputs(manifest.source);
+    const staticManifestUrl = resolveStaticManifestUrlFromInputs(manifest.staticUrl);
+    const isDev = resolveBoolean(dev.enabled) !== undefined ? Boolean(dev.enabled) : resolveBundledIsDev();
+    const devFallbackStaticManifestUrl = (() => {
+        if (devFallback.staticUrl !== undefined && String(devFallback.staticUrl).trim() !== '') {
+            return String(devFallback.staticUrl).trim();
         }
-        return String(DEF.devFallbackStaticManifestUrl).trim();
+        const envValue = resolveBundledEnv(EK.devFallbackManifestUrl, '');
+        return envValue ? envValue.trim() : String(DEF.devFallbackStaticManifestUrl).trim();
     })();
-    const hostLayoutComponent = user.hostLayoutComponent;
-    const pluginRoutesParentName = user.pluginRoutesParentName !== undefined && String(user.pluginRoutesParentName).trim() !== ''
-        ? String(user.pluginRoutesParentName).trim()
+    const pluginRoutesParentName = hostRoute.parentName !== undefined && String(hostRoute.parentName).trim() !== ''
+        ? String(hostRoute.parentName).trim()
         : '';
-    const pluginMountRaw = user.pluginMountPath !== undefined && String(user.pluginMountPath).trim() !== ''
-        ? String(user.pluginMountPath).trim()
+    const pluginMountRaw = hostRoute.mountPath !== undefined && String(hostRoute.mountPath).trim() !== ''
+        ? String(hostRoute.mountPath).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;
+    const pluginHostRouteMeta = asRecord$1(hostRoute.meta);
+    const ensurePluginHostRoute = resolveBoolean(hostRoute.enabled) === true;
+    const webPluginDevMapJson = (() => {
+        if (dev.pluginMap && typeof dev.pluginMap === 'object' && !Array.isArray(dev.pluginMap)) {
+            return JSON.stringify(dev.pluginMap);
         }
-        return !!isDevResolved;
+        return dev.pluginMap !== undefined ? String(dev.pluginMap || '') : resolveBundledEnv(EK.webPluginDevMap, '');
     })();
     return {
         manifestBase: manifestBaseRaw.replace(/\/$/, '') || DEF.manifestBase.replace(/\/$/, ''),
         manifestListPath,
         manifestMode,
         staticManifestUrl,
-        devManifestFallback,
+        devManifestFallback: resolveDevManifestFallback(dev, manifestMode, isDev),
         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
+        manifestFetchCredentials: resolveManifestCredentials(manifest.credentials, EK.manifestCredentials, DEF.manifestFetchCredentials),
+        isDev,
+        webPluginDevOrigin: dev.origin !== undefined ? String(dev.origin || '').trim() : resolveBundledEnv(EK.webPluginDevOrigin, ''),
+        webPluginDevIds: resolveDevPluginIds(dev),
+        webPluginDevMapJson,
+        webPluginDevEntryPath: ensureLeadingPath(dev.entryPath !== undefined && String(dev.entryPath).trim() !== ''
+            ? String(dev.entryPath)
             : resolveBundledEnv(EK.devEntry, DEF.webPluginDevEntryPath)),
-        devPingPath: ensureLeadingPath(user.devPingPath !== undefined && user.devPingPath !== ''
-            ? user.devPingPath
+        devPingPath: ensureLeadingPath(dev.pingPath !== undefined && String(dev.pingPath).trim() !== ''
+            ? String(dev.pingPath)
             : resolveBundledEnv(EK.devPing, DEF.devPingPath)),
-        devReloadSsePath: ensureLeadingPath(user.devReloadSsePath !== undefined && user.devReloadSsePath !== ''
-            ? user.devReloadSsePath
+        devReloadSsePath: ensureLeadingPath(dev.reloadSsePath !== undefined && String(dev.reloadSsePath).trim() !== ''
+            ? String(dev.reloadSsePath)
             : resolveBundledEnv(EK.devSse, DEF.devReloadSsePath)),
-        devPingTimeoutMs: resolvePositiveInt(user.devPingTimeoutMs, EK.devPingTimeout, DEF.devPingTimeoutMs),
-        defaultImplicitDevPluginIds,
+        devPingTimeoutMs: resolvePositiveInt(dev.pingTimeoutMs, EK.devPingTimeout, DEF.devPingTimeoutMs),
+        defaultImplicitDevPluginIds: [...DEF.defaultImplicitDevPluginIds],
         allowedScriptHosts,
         bridgeAllowedPathPrefixes,
-        bootstrapSummary: user.bootstrapSummary,
-        hostLayoutComponent,
+        bootstrapSummary: resolveBoolean(dev.bootstrapSummary),
+        hostLayoutComponent: hostRoute.layout,
         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 }
+        ...(typeof manifest.fetch === 'function' ? { fetchManifest: manifest.fetch } : {}),
+        ...(typeof hooks.transformRoutes === 'function' ? { transformRoutes: hooks.transformRoutes } : {}),
+        ...(typeof hooks.interceptRegisterRoutes === 'function'
+            ? { interceptRegisterRoutes: hooks.interceptRegisterRoutes }
             : {}),
-        ...(typeof user.onPluginRoutesContributed === 'function'
-            ? { onPluginRoutesContributed: user.onPluginRoutesContributed }
+        ...(typeof hooks.adaptRouteDeclarations === 'function'
+            ? { adaptRouteDeclarations: hooks.adaptRouteDeclarations }
             : {}),
-        ...(user.hostContext !== undefined &&
-            user.hostContext !== null &&
-            typeof user.hostContext === 'object' &&
-            !Array.isArray(user.hostContext)
-            ? { hostContext: user.hostContext }
+        ...(typeof hooks.onRoutesContributed === 'function'
+            ? { onPluginRoutesContributed: hooks.onRoutesContributed }
             : {}),
-        ...(user.hostCapabilities !== undefined &&
-            user.hostCapabilities !== null &&
-            typeof user.hostCapabilities === 'object' &&
-            !Array.isArray(user.hostCapabilities)
-            ? { hostCapabilities: user.hostCapabilities }
+        ...(asRecord$1(host.context) ? { hostContext: asRecord$1(host.context) } : {}),
+        ...(asRecord$1(host.capabilities) ? { hostCapabilities: asRecord$1(host.capabilities) } : {}),
+        ...(normalizedHostBridge ? { hostBridge: normalizedHostBridge } : {}),
+        ...(typeof hooks.beforeActivate === 'function'
+            ? { onBeforePluginActivate: hooks.beforeActivate }
             : {}),
-        ...(typeof user.onBeforePluginActivate === 'function'
-            ? { onBeforePluginActivate: user.onBeforePluginActivate }
+        ...(typeof hooks.afterActivate === 'function'
+            ? { onAfterPluginActivate: hooks.afterActivate }
             : {}),
-        ...(typeof user.onAfterPluginActivate === 'function'
-            ? { onAfterPluginActivate: user.onAfterPluginActivate }
-            : {}),
-        ...(typeof user.onPluginActivateError === 'function'
-            ? { onPluginActivateError: user.onPluginActivateError }
+        ...(typeof hooks.onActivateError === 'function'
+            ? { onPluginActivateError: hooks.onActivateError }
             : {})
     };
 }
@@ -3418,18 +3449,31 @@ function disposeWebPlugin(pluginId) {
 }
 
 /**
- * 开发模式插件 URL 映射（显式 JSON + 隐式 dev 探测）。
+ * 开发模式插件 URL 映射。
  */
+function normalizeStringValue(value) {
+    return value == null ? '' : String(value).trim();
+}
+function normalizeStringList(value, fallback = []) {
+    const raw = normalizeStringValue(value);
+    if (!raw) {
+        return [...fallback];
+    }
+    return raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
 function parseWebPluginDevMapExplicit(opts) {
     if (!opts.isDev) {
         return null;
     }
-    const raw = opts.webPluginDevMapJson;
-    if (raw === undefined || raw === null || String(raw).trim() === '') {
+    const raw = normalizeStringValue(opts.webPluginDevMapJson);
+    if (!raw) {
         return null;
     }
     try {
-        const map = JSON.parse(String(raw));
+        const map = JSON.parse(raw);
         return map && typeof map === 'object' ? map : null;
     }
     catch (_a) {
@@ -3446,22 +3490,11 @@ 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)) {
+    const origin = normalizeStringValue(opts.webPluginDevOrigin);
+    if (!origin || !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];
+    const ids = normalizeStringList(opts.webPluginDevIds, opts.defaultImplicitDevPluginIds);
     if (ids.length === 0) {
         return {};
     }
@@ -3470,31 +3503,28 @@ async function buildImplicitWebPluginDevMap(opts, hostSet) {
     try {
         const ctrl = new AbortController();
         const timer = setTimeout(() => ctrl.abort(), opts.devPingTimeoutMs);
-        const r = await fetch(pingUrl, {
+        const response = await fetch(pingUrl, {
             mode: 'cors',
             cache: 'no-store',
             signal: ctrl.signal
         });
         clearTimeout(timer);
-        if (!r.ok) {
+        if (!response.ok) {
             return {};
         }
-        const body = (await r.text()).trim();
-        if (body !== 'ok') {
+        if ((await response.text()).trim() !== 'ok') {
             return {};
         }
     }
     catch (_a) {
         return {};
     }
-    const pathPart = opts.webPluginDevEntryPath;
+    const entryUrl = `${base}${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(', '));
+        map[id] = entryUrl;
     }
+    console.info('[wep] plugin dev server', base, '-> implicit entries', opts.webPluginDevEntryPath, ids.join(', '));
     return map;
 }
 
@@ -3628,15 +3658,14 @@ async function fetchStaticManifestViaHttp(ctx) {
 }
 
 /**
- * 当 `ensurePluginHostRoute === true` 且提供 `pluginRoutesParentName` + `hostLayoutComponent` 时，
- * 注册 `pluginMountPath` + Layout 的命名父路由，供 `router.addRoute(parentName, child)` 挂载插件页。
+ * 在需要时补注册插件宿主父路由。
  */
 function routeNameExists(router, name) {
     if (!name) {
         return false;
     }
     if (typeof router.getRoutes === 'function') {
-        return router.getRoutes().some((r) => r.name === name);
+        return router.getRoutes().some((route) => route.name === name);
     }
     return walkRouteNames(router.options && router.options.routes, name);
 }
@@ -3644,50 +3673,49 @@ function walkRouteNames(routes, name) {
     if (!Array.isArray(routes)) {
         return false;
     }
-    for (const r of routes) {
-        if (r && typeof r === 'object' && r.name === name) {
+    for (const route of routes) {
+        if (route && typeof route === 'object' && route.name === name) {
             return true;
         }
-        const ch = r && typeof r === 'object' ? r.children : null;
-        if (walkRouteNames(ch, name)) {
+        const children = route && typeof route === 'object' ? route.children : undefined;
+        if (walkRouteNames(children, name)) {
             return true;
         }
     }
     return false;
 }
-function ensurePluginHostRoute$1(router, opts) {
-    if (opts.ensurePluginHostRoute !== true) {
-        return;
-    }
-    if (!router || typeof router.addRoute !== 'function') {
+function normalizeMountPath(value) {
+    const mountDefault = defaultWebExtendPluginRuntime.pluginMountPath;
+    const raw = String(value || mountDefault).trim().replace(/\/$/, '') || mountDefault;
+    return raw.startsWith('/') ? raw : `/${raw}`;
+}
+function resolveRouteMeta(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? { ...value }
+        : { requiresConfig: true, hidden: true };
+}
+function ensurePluginHostRoute$1(router, options) {
+    const opts = options && typeof options === 'object' && ('manifestBase' in options || 'ensurePluginHostRoute' in options)
+        ? options
+        : resolveRuntimeOptions$1(options);
+    if (opts.ensurePluginHostRoute !== true || !router || typeof router.addRoute !== 'function') {
         return;
     }
     const parentName = String(opts.pluginRoutesParentName || '').trim();
-    if (!parentName) {
-        return;
-    }
-    if (routeNameExists(router, parentName)) {
+    if (!parentName || routeNameExists(router, parentName)) {
         return;
     }
     const Layout = opts.hostLayoutComponent;
     if (!Layout) {
-        console.warn('[wep] 缺少 hostLayoutComponent，未自动注册插件壳路由；请传入宿主 Layout，或在路由表中自行配置与 pluginRoutesParentName 一致的父路由');
+        console.warn('[wep] missing hostLayoutComponent; plugin host route was not auto-registered');
         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,
+        path: normalizeMountPath(opts.pluginMountPath),
         name: parentName,
         component: Layout,
         redirect: 'noredirect',
-        meta,
+        meta: resolveRouteMeta(opts.pluginHostRouteMeta),
         children: []
     });
 }
@@ -4069,6 +4097,65 @@ function sortByPriority(plugins) {
     })
         .map((decorated) => decorated.entry);
 }
+function logBootstrapSummary(enabled, payload) {
+    if (enabled) {
+        console.info('[wep] bootstrap_summary', payload);
+    }
+}
+function getManifestBody(result) {
+    return result.ok && result.data && typeof result.data === 'object' ? result.data : null;
+}
+function getManifestPluginCount(result) {
+    const body = getManifestBody(result);
+    return body && Array.isArray(body.plugins) ? body.plugins.length : 0;
+}
+async function fetchManifestSafely(fetchManifest, manifestCtx) {
+    try {
+        if (typeof fetchManifest === 'function') {
+            return await fetchManifest(manifestCtx);
+        }
+        return await defaultFetchWebPluginManifest$1(manifestCtx);
+    }
+    catch (error) {
+        return { ok: false, error, data: null };
+    }
+}
+function buildHostKit(opts) {
+    const frozenHostContext = freezeShallowHostContext(opts.hostContext !== undefined ? opts.hostContext : undefined, opts.hostCapabilities && typeof opts.hostCapabilities === 'object' ? opts.hostCapabilities : undefined);
+    return {
+        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 }
+            : {}),
+        ...(typeof opts.onPluginRoutesContributed === 'function'
+            ? { onPluginRoutesContributed: opts.onPluginRoutesContributed }
+            : {})
+    };
+}
+function resolveManifestRequest(opts) {
+    const isStatic = opts.manifestMode === 'static';
+    if (isStatic) {
+        const raw = String(opts.staticManifestUrl || '').trim();
+        if (!raw) {
+            return null;
+        }
+        return {
+            isStatic,
+            manifestUrl: resolveStaticManifestUrlForFetch(raw, window.location.origin)
+        };
+    }
+    const base = String(opts.manifestBase).replace(/\/$/, '');
+    return {
+        isStatic,
+        manifestUrl: `${base}${opts.manifestListPath}`
+    };
+}
 async function bootstrapPlugins$1(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 router, 
@@ -4080,26 +4167,17 @@ createHostApiFactory, runtimeOptions) {
     }
     printRuntimeBannerOnce();
     clearActivatedPluginIds();
-    const opts = resolveRuntimeOptions$1(runtimeOptions || {});
+    const opts = resolveRuntimeOptions$1(runtimeOptions);
+    const showBootstrapSummary = shouldShowBootstrapSummary(opts);
     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 manifestRequest = resolveManifestRequest(opts);
+    if (!manifestRequest) {
+        console.warn('[wep] manifestMode=static requires non-empty staticManifestUrl (or env VITE_WEB_PLUGIN_STATIC_MANIFEST_URL)');
+        logBootstrapSummary(showBootstrapSummary, { ok: false, reason: 'static_manifest_url_missing' });
+        return;
     }
+    const { isStatic, manifestUrl } = manifestRequest;
     const hostSet = buildAllowedScriptHostsSet(opts.allowedScriptHosts);
     const explicit = parseWebPluginDevMapExplicit(opts);
     const manifestCtx = {
@@ -4107,27 +4185,15 @@ createHostApiFactory, runtimeOptions) {
         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 };
-            }
-        })(),
+        fetchManifestSafely(typeof opts.fetchManifest === 'function'
+            ? opts.fetchManifest
+            : undefined, manifestCtx),
         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 needFallback = !primaryResult.ok || getManifestPluginCount(primaryResult) === 0;
         const fallbackRaw = String(opts.devFallbackStaticManifestUrl || '').trim();
         if (needFallback && fallbackRaw) {
             const fallbackUrl = resolveStaticManifestUrlForFetch(fallbackRaw, window.location.origin);
@@ -4136,8 +4202,7 @@ createHostApiFactory, runtimeOptions) {
                 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;
+            const flen = getManifestPluginCount(fr);
             if (fr.ok && flen > 0) {
                 manifestResult = fr;
                 manifestUrlUsed = fallbackUrl;
@@ -4147,22 +4212,7 @@ createHostApiFactory, runtimeOptions) {
     }
     const devMap = mergeDevMaps(implicit, explicit);
     startPluginDevSseForMap(devMap, opts.isDev, hostSet, opts.devReloadSsePath);
-    const frozenHostContext = freezeShallowHostContext(opts.hostContext !== undefined ? opts.hostContext : undefined, opts.hostCapabilities && typeof opts.hostCapabilities === 'object' ? opts.hostCapabilities : 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 }
-            : {}),
-        ...(typeof opts.onPluginRoutesContributed === 'function'
-            ? { onPluginRoutesContributed: opts.onPluginRoutesContributed }
-            : {})
-    };
+    const hostKit = buildHostKit(opts);
     if (!manifestResult.ok) {
         if (manifestResult.error) {
             console.warn('[wep] fetch manifest failed', manifestResult.error);
@@ -4171,16 +4221,12 @@ createHostApiFactory, runtimeOptions) {
             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' });
-        }
+        logBootstrapSummary(showBootstrapSummary, { ok: false, reason: 'manifest_fetch' });
         return;
     }
-    const data = manifestResult.data;
+    const data = getManifestBody(manifestResult);
     if (!data) {
-        if (shouldShowBootstrapSummary(opts)) {
-            console.info('[wep] bootstrap_summary', { ok: false, reason: 'manifest_empty_body' });
-        }
+        logBootstrapSummary(showBootstrapSummary, { ok: false, reason: 'manifest_empty_body' });
         return;
     }
     const apiVer = data.hostPluginApiVersion;
@@ -4193,12 +4239,10 @@ createHostApiFactory, runtimeOptions) {
                 host: HOST_PLUGIN_API_VERSION,
                 manifest: apiVer
             });
-            if (shouldShowBootstrapSummary(opts)) {
-                console.info('[wep] bootstrap_summary', {
-                    ok: false,
-                    reason: 'manifest_host_api_version_mismatch'
-                });
-            }
+            logBootstrapSummary(showBootstrapSummary, {
+                ok: false,
+                reason: 'manifest_host_api_version_mismatch'
+            });
             return;
         }
     }
@@ -4298,9 +4342,7 @@ createHostApiFactory, runtimeOptions) {
             }
         }
     }
-    if (shouldShowBootstrapSummary(opts)) {
-        console.info('[wep] bootstrap_summary', { ok: true, ...summary });
-    }
+    logBootstrapSummary(showBootstrapSummary, { ok: true, ...summary });
 }
 
 /**
@@ -4578,10 +4620,39 @@ function clearContributedRoutesForPlugin(pluginId) {
 }
 
 /**
- * 构造插件 `activator(hostApi)` 使用的宿主 API：路由、扩展点、资源与受控请求桥。
+ * 构造插件 `activator(hostApi)` 使用的宿主 API。
  */
 let slotItemKeySeq = 0;
 let routeSynthSeq = 0;
+function getBridgePrefixes(hostKitOptions) {
+    return Array.isArray(hostKitOptions.bridgeAllowedPathPrefixes) &&
+        hostKitOptions.bridgeAllowedPathPrefixes.length > 0
+        ? hostKitOptions.bridgeAllowedPathPrefixes
+        : defaultWebExtendPluginRuntime.bridgeAllowedPathPrefixes;
+}
+function resolveHostRuntime(hostKitOptions) {
+    const hostContext = hostKitOptions.hostContext != null && typeof hostKitOptions.hostContext === 'object'
+        ? hostKitOptions.hostContext
+        : Object.freeze({});
+    const hostVue = hostContext.Vue;
+    return {
+        hostContext,
+        VueRuntime: hostVue || Vue
+    };
+}
+function normalizeParentRouteName(hostKitOptions) {
+    return typeof hostKitOptions.pluginRoutesParentName === 'string'
+        ? hostKitOptions.pluginRoutesParentName.trim()
+        : '';
+}
+function normalizeUrls(urls) {
+    return Array.isArray(urls)
+        ? urls
+            .filter((url) => typeof url === 'string')
+            .map((url) => url.trim())
+            .filter(Boolean)
+        : [];
+}
 function decorateRouteTreeWithPluginMeta(pluginId, route) {
     const meta = route.meta && typeof route.meta === 'object' && !Array.isArray(route.meta)
         ? route.meta
@@ -4607,97 +4678,81 @@ function decorateRouteTreeWithPluginMeta(pluginId, route) {
 function analyzeRouteInputTree(nodes) {
     let hasDecl = false;
     let hasCfg = false;
-    function walk(r) {
-        if (!r || typeof r !== 'object') {
+    function walk(node) {
+        if (!node || typeof node !== 'object') {
             return;
         }
-        const o = r;
-        const cfg = o.component != null || o.components != null;
-        const decl = typeof o.componentRef === 'string';
-        if (cfg) {
+        const record = node;
+        const hasRouteConfig = record.component != null || record.components != null;
+        const hasRouteDecl = typeof record.componentRef === 'string';
+        if (hasRouteConfig) {
             hasCfg = true;
         }
-        else if (decl) {
+        else if (hasRouteDecl) {
             hasDecl = true;
         }
-        const ch = o.children;
-        if (Array.isArray(ch)) {
-            for (const c of ch) {
-                walk(c);
+        if (Array.isArray(record.children)) {
+            for (const child of record.children) {
+                walk(child);
             }
         }
     }
-    for (const n of nodes) {
-        walk(n);
+    for (const node of nodes) {
+        walk(node);
     }
     return { hasDecl, hasCfg };
 }
-/**
- * 单插件在宿主侧的 API 句柄。工厂请传 `(id, router, kit) => createHostApi(id, r, kit)` 以便 bridge 白名单等到位。
- */
+function rollbackRegisteredTopRoutes(
 // 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()
-        : '';
-    function rollbackRegisteredTopRoutes(routes) {
-        for (let i = routes.length - 1; i >= 0; i--) {
-            const route = routes[i];
-            if (typeof route.dispose === 'function') {
-                try {
-                    route.dispose();
-                    continue;
-                }
-                catch (e) {
-                    console.warn('[wep] rollback route disposer failed', route.name, e);
-                }
+router, routes) {
+    for (let i = routes.length - 1; i >= 0; i--) {
+        const route = routes[i];
+        if (typeof route.dispose === 'function') {
+            try {
+                route.dispose();
+                continue;
             }
-            if (typeof router.removeRoute === 'function') {
-                try {
-                    router.removeRoute(route.name);
-                }
-                catch (e) {
-                    console.warn('[wep] rollback removeRoute failed', route.name, e);
-                }
+            catch (e) {
+                console.warn('[wep] rollback route disposer failed', route.name, e);
+            }
+        }
+        if (typeof router.removeRoute === 'function') {
+            try {
+                router.removeRoute(route.name);
+            }
+            catch (e) {
+                console.warn('[wep] rollback removeRoute failed', route.name, e);
             }
         }
     }
-    function applyInternalRegister(rawRouteConfigs) {
-        const wrapped = rawRouteConfigs.map((r) => ({
-            ...decorateRouteTreeWithPluginMeta(pluginId, r),
-            name: r.name || `${routeSynthNamePrefix}${pluginId}_${routeSynthSeq++}`
-        }));
+}
+function decorateTopRoutes(pluginId, rawRouteConfigs) {
+    return rawRouteConfigs.map((route) => ({
+        ...decorateRouteTreeWithPluginMeta(pluginId, route),
+        name: route.name || `${routeSynthNamePrefix}${pluginId}_${routeSynthSeq++}`
+    }));
+}
+function createRouteRegistrar({ pluginId, router, parentName, hostKitOptions }) {
+    function addTopRoute(route) {
+        const dispose = parentName ? router.addRoute(parentName, route) : router.addRoute(route);
+        return {
+            name: String(route.name),
+            dispose: typeof dispose === 'function' ? dispose : undefined
+        };
+    }
+    return function applyInternalRegister(rawRouteConfigs) {
         if (typeof router.addRoute !== 'function') {
-            throw new Error('[wep] vue-router 3.5+ 必需：请使用 router.addRoute（不再支持 addRoutes）');
+            throw new Error('[wep] vue-router 3.5+ required: please use router.addRoute');
         }
+        const wrapped = decorateTopRoutes(pluginId, rawRouteConfigs);
         const registeredTopRoutes = [];
         try {
-            if (parentName) {
-                for (const r of wrapped) {
-                    const dispose = router.addRoute(parentName, r);
-                    registeredTopRoutes.push({
-                        name: String(r.name),
-                        dispose: typeof dispose === 'function' ? dispose : undefined
-                    });
-                }
-            }
-            else {
-                for (const r of wrapped) {
-                    const dispose = router.addRoute(r);
-                    registeredTopRoutes.push({
-                        name: String(r.name),
-                        dispose: typeof dispose === 'function' ? dispose : undefined
-                    });
-                }
+            for (const route of wrapped) {
+                registeredTopRoutes.push(addTopRoute(route));
             }
         }
         catch (e) {
-            rollbackRegisteredTopRoutes(registeredTopRoutes);
+            rollbackRegisteredTopRoutes(router, registeredTopRoutes);
             throw e;
         }
         recordPluginTopRoutes(pluginId, registeredTopRoutes);
@@ -4710,69 +4765,80 @@ function createHostApi(pluginId, router, hostKitOptions = {}) {
                 contributedRoutes
             });
         }
-    }
-    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);
+    };
+}
+function injectStylesheet(pluginId, href) {
+    const link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.href = href;
+    link.setAttribute('data-plugin-asset', pluginId);
+    document.head.appendChild(link);
+}
+function injectScript(pluginId, src) {
+    return new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.async = true;
+        script.src = src;
+        script.setAttribute('data-plugin-asset', pluginId);
+        script.onload = () => resolve();
+        script.onerror = () => reject(new Error('script failed: ' + src));
+        document.head.appendChild(script);
+    });
+}
+function resolveRouteConfigs(pluginId, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+router, hostKitOptions, routes) {
+    const { hasDecl, hasCfg } = analyzeRouteInputTree(routes);
+    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: routes
         });
     }
-    const hostContext = hostKitOptions.hostContext != null && typeof hostKitOptions.hostContext === 'object'
-        ? hostKitOptions.hostContext
-        : Object.freeze({});
-    const hostVue = hostContext && hostContext.Vue;
-    const VueRuntime = hostVue || Vue;
+    else {
+        configs = routes;
+    }
+    return typeof hostKitOptions.transformRoutes === 'function'
+        ? hostKitOptions.transformRoutes({
+            pluginId,
+            router,
+            routes: configs
+        })
+        : configs;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function createHostApi(pluginId, router, hostKitOptions = {}) {
+    const bridge = createRequestBridge({ allowedPathPrefixes: getBridgePrefixes(hostKitOptions) });
+    const parentName = normalizeParentRouteName(hostKitOptions);
+    const applyInternalRegister = createRouteRegistrar({
+        pluginId,
+        router,
+        parentName,
+        hostKitOptions
+    });
+    const { hostContext, VueRuntime } = resolveHostRuntime(hostKitOptions);
     ensureRegistriesReactive(VueRuntime);
     registerPluginTeardown(pluginId, () => {
         clearContributedRoutesForPlugin(pluginId);
     });
     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
-                });
-            }
+            const configs = resolveRouteConfigs(pluginId, router, hostKitOptions, list);
             if (typeof hostKitOptions.interceptRegisterRoutes === 'function') {
                 hostKitOptions.interceptRegisterRoutes({
                     pluginId,
@@ -4793,11 +4859,11 @@ function createHostApi(pluginId, router, hostKitOptions = {}) {
                 VueRuntime.set(registries.slots, pointId, []);
             }
             const list = registries.slots[pointId];
-            for (const c of components) {
+            for (const componentEntry of components) {
                 list.push({
                     pluginId,
-                    component: c.component,
-                    priority: c.priority != null ? c.priority : 0,
+                    component: componentEntry.component,
+                    priority: componentEntry.priority != null ? componentEntry.priority : 0,
                     key: `${pluginId}-${pointId}-${++slotItemKeySeq}`
                 });
             }
@@ -4805,14 +4871,12 @@ function createHostApi(pluginId, router, hostKitOptions = {}) {
             registries.slotRevision++;
         },
         registerStylesheetUrls(urls) {
-            for (const u of urls || []) {
-                if (typeof u === 'string' && u) {
-                    injectStylesheet(u);
-                }
+            for (const url of normalizeUrls(urls)) {
+                injectStylesheet(pluginId, url);
             }
         },
         registerScriptUrls(urls) {
-            const chain = (urls || []).filter((u) => typeof u === 'string' && u).reduce((p, u) => p.then(() => injectScript(u)), Promise.resolve());
+            const chain = normalizeUrls(urls).reduce((promise, url) => promise.then(() => injectScript(pluginId, url)), Promise.resolve());
             chain.catch((e) => console.warn('[wep] registerScriptUrls', pluginId, e));
         },
         registerSanitizedHtmlSnippet() {
@@ -4885,14 +4949,54 @@ function createExtensionPointComponent(VueLike = Vue) {
 }
 var ExtensionPoint = createExtensionPointComponent();
 
+function isRecord(input) {
+    return !!input && typeof input === 'object' && !Array.isArray(input);
+}
+function normalizeComponent(entry) {
+    if (isRecord(entry) && 'component' in entry) {
+        return entry.component;
+    }
+    return entry;
+}
+function toComponentAlias(name) {
+    return name
+        .trim()
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+function installHostBridge(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+VueRuntime, options = {}) {
+    if (!VueRuntime || typeof VueRuntime.component !== 'function' || !VueRuntime.prototype) {
+        throw new Error('[wep] installHostBridge requires a Vue 2 runtime constructor');
+    }
+    const modules = options.modules && isRecord(options.modules) ? Object.freeze({ ...options.modules }) : Object.freeze({});
+    VueRuntime.prototype.$host = modules;
+    const componentEntries = options.components && isRecord(options.components) ? Object.entries(options.components) : [];
+    for (const [rawName, rawEntry] of componentEntries) {
+        const alias = toComponentAlias(String(rawName));
+        const component = normalizeComponent(rawEntry);
+        if (!alias || component == null) {
+            continue;
+        }
+        VueRuntime.component(alias, component);
+    }
+    return modules;
+}
+
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function installWebExtendPluginVue2(Vue, router, options) {
+    const runtime = resolveRuntimeOptions$1(options);
     if (Vue) {
         ensureRegistriesReactive(Vue);
         Vue.component('ExtensionPoint', createExtensionPointComponent(Vue));
+        if (runtime.hostBridge && typeof runtime.hostBridge === 'object') {
+            installHostBridge(Vue, runtime.hostBridge);
+        }
     }
-    const runtime = resolveRuntimeOptions$1(options || {});
-    return bootstrapPlugins$1(router, (id, r, kit) => createHostApi(id, r, kit || {}), runtime);
+    return bootstrapPlugins$1(router, createHostApi, runtime);
 }
 
 function resolveManifestPathUnderApiBase(manifestUrl, apiBase) {
@@ -4918,17 +5022,22 @@ function bridgePrefixesFromVueCliEnv() {
     const raw = [base ? `${base}/` : '', '/api/', '/dev-api/'].filter(Boolean);
     return [...new Set(raw)];
 }
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
 function createVueCliAxiosInstallOptions(deps, extra = {}) {
     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 manifest = asRecord(extra.manifest) || {};
+    const host = asRecord(extra.host) || {};
+    const mergedHost = { ...host };
     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 userBase = manifest.baseUrl !== undefined && String(manifest.baseUrl).trim() !== ''
+        ? String(manifest.baseUrl).replace(/\/$/, '')
         : '';
     const stripBase = userBase || envBase;
     const fetchManifestApi = async (ctx) => {
@@ -4939,11 +5048,7 @@ function createVueCliAxiosInstallOptions(deps, extra = {}) {
             });
             const data = unwrapNestedManifestBody(body);
             if (!data || typeof data !== 'object') {
-                return {
-                    ok: false,
-                    error: new Error('[wep] invalid manifest response'),
-                    data: null
-                };
+                return { ok: false, error: new Error('[wep] invalid manifest response'), data: null };
             }
             return { ok: true, data };
         }
@@ -4951,32 +5056,37 @@ function createVueCliAxiosInstallOptions(deps, extra = {}) {
             return { ok: false, error, data: null };
         }
     };
-    const manifestMode = resolveManifestModeFromInputs(extraManifestMode);
-    const staticManifestUrl = resolveStaticManifestUrlFromInputs(extraStaticManifestUrl);
-    const fetchManifest = typeof userFetchManifest === 'function'
-        ? userFetchManifest
-        : manifestMode === 'static'
+    const manifestSource = resolveManifestModeFromInputs(manifest.source);
+    const staticUrl = resolveStaticManifestUrlFromInputs(manifest.staticUrl);
+    const fetchManifest = typeof manifest.fetch === 'function'
+        ? manifest.fetch
+        : manifestSource === 'static'
             ? fetchStaticManifestViaHttp
             : fetchManifestApi;
-    const options = {
-        manifestBase: stripBase || undefined,
-        bridgeAllowedPathPrefixes: bridgePrefixesFromVueCliEnv(),
-        manifestMode,
-        staticManifestUrl,
-        ...restExtra,
-        fetchManifest
-    };
     const listPath = typeof process !== 'undefined' &&
         process.env &&
-        process.env[webExtendPluginEnvKeys.manifestPathAlt];
-    if (listPath && options.manifestListPath === undefined && extra.manifestListPath === undefined) {
-        options.manifestListPath = String(process.env[webExtendPluginEnvKeys.manifestPathAlt]);
+        process.env[webExtendPluginEnvKeys.manifestPathAlt]
+        ? String(process.env[webExtendPluginEnvKeys.manifestPathAlt])
+        : undefined;
+    if (mergedHost.requestPathPrefixes === undefined) {
+        mergedHost.requestPathPrefixes = bridgePrefixesFromVueCliEnv();
     }
-    return options;
+    return {
+        ...extra,
+        manifest: {
+            ...manifest,
+            baseUrl: stripBase || undefined,
+            listPath: manifest.listPath !== undefined ? manifest.listPath : listPath,
+            source: manifestSource,
+            staticUrl,
+            fetch: fetchManifest
+        },
+        host: mergedHost
+    };
 }
 
 const { bootstrapPlugins, defaultFetchWebPluginManifest, resolveRuntimeOptions, ensurePluginHostRoute, getActivatedPluginIds } = pluginRuntime;
 const { composeManifestFetch, manifestFetchCacheMiddleware, wrapManifestFetchWithCache } = manifestComposer;
 
-export { ExtensionPoint, HOST_PLUGIN_API_VERSION, RUNTIME_CONSOLE_LABEL, bootstrapPlugins, composeManifestFetch, createHostApi, createRequestBridge, createVueCliAxiosInstallOptions, defaultFetchWebPluginManifest, defaultManifestFetchCache, defaultManifestMode, defaultWebExtendPluginRuntime, disposeWebPlugin, ensurePluginHostRoute, getActivatedPluginIds, getAllHostComponentMeta, getAllHostModuleMeta, getContributedRoutesForPlugin, getHostComponent, getHostComponentMeta, getHostModule, getHostModuleMeta, getRegisteredTopRouteNamesForPlugin, installWebExtendPluginVue2, manifestFetchCacheMiddleware, peerMinimumVersions, registerHostComponents, registerHostModules, registerVueGlobalComponents, registries, resolveRuntimeOptions, routeSynthNamePrefix, setWebExtendPluginEnv, webExtendPluginEnvKeys, wrapManifestFetchWithCache };
+export { ExtensionPoint, HOST_PLUGIN_API_VERSION, RUNTIME_CONSOLE_LABEL, bootstrapPlugins, composeManifestFetch, createHostApi, createRequestBridge, createVueCliAxiosInstallOptions, defaultFetchWebPluginManifest, defaultManifestFetchCache, defaultManifestMode, defaultWebExtendPluginRuntime, disposeWebPlugin, ensurePluginHostRoute, getActivatedPluginIds, getAllHostComponentMeta, getAllHostModuleMeta, getContributedRoutesForPlugin, getHostComponent, getHostComponentMeta, getHostModule, getHostModuleMeta, getRegisteredTopRouteNamesForPlugin, installHostBridge, installWebExtendPluginVue2, manifestFetchCacheMiddleware, peerMinimumVersions, registerHostComponents, registerHostModules, registerVueGlobalComponents, registries, resolveRuntimeOptions, routeSynthNamePrefix, setWebExtendPluginEnv, webExtendPluginEnvKeys, wrapManifestFetchWithCache };
 //# sourceMappingURL=index.mjs.map