web-extend-plugin-vue2 0.3.4 → 0.3.5

package/README.md

@@ -5,7 +5,7 @@ Vue 2 host runtime for web plugin bootstrap, route registration, host API inject
 ## Install
 
 ```bash
-npm i web-extend-plugin-vue2
+npm i web-extend-plugin-vue2@0.3.5
 ```
 
 Peer dependencies:
@@ -13,6 +13,10 @@ Peer dependencies:
 - `vue >= 2.6.0 < 3`
 - `vue-router >= 3.5.0 < 4`
 
+Published package:
+
+- `web-extend-plugin-vue2@0.3.5`
+
 ## Public API
 
 The package now exposes named exports only.
@@ -33,6 +37,9 @@ Utilities:
 
 - `createRequestBridge`
 - `createVueCliAxiosInstallOptions`
+- `registerHostComponents`
+- `registerVueGlobalComponents`
+- `registerHostModules`
 - `composeManifestFetch`
 - `manifestFetchCacheMiddleware`
 - `wrapManifestFetchWithCache`
@@ -90,6 +97,37 @@ installWebExtendPluginVue2(
 ).catch(console.warn)
 ```
 
+## Host exposes
+
+Preferred host integration uses concrete component/module exposes instead of relying on `hostCapabilities`.
+
+```js
+import {
+  installWebExtendPluginVue2,
+  createVueCliAxiosInstallOptions,
+  registerHostComponents,
+  registerVueGlobalComponents,
+  registerHostModules
+} from 'web-extend-plugin-vue2'
+
+registerVueGlobalComponents(Vue, {
+  include: (name) => /^El[A-Z]/.test(name),
+  mapName: (name) => name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase()
+})
+
+registerHostComponents({
+  'app.pagination': Pagination,
+  'app.dict-tag': DictTag
+})
+
+registerHostModules({
+  request,
+  download
+})
+```
+
+Plugins should depend on stable expose names such as `el-button`, `app.pagination`, or `request`.
+
 ## Important runtime options
 
 - `manifestBase`: API prefix, default `/fp-api`
@@ -105,6 +143,7 @@ installWebExtendPluginVue2(
 - `pluginRoutesParentName`: explicit parent route name for child plugin routes
 - `ensurePluginHostRoute`: when `true`, auto-registers the shell route
 - `hostContext`: readonly host dependencies injected into `hostApi.hostContext`
+- `hostCapabilities`: optional legacy metadata; prefer `registerHostComponents` and `registerHostModules`
 
 ## Notes
 

package/dist/index.cjs

@@ -81,7 +81,7 @@ function getEnvObject() {
             return raw.__WEP_ENV__;
         }
     }
-    catch {
+    catch (_a) {
         /* ignore */
     }
     return null;
@@ -117,7 +117,7 @@ function readProcessEnv(key) {
             }
         }
     }
-    catch {
+    catch (_a) {
         /* ignore */
     }
     return undefined;
@@ -143,7 +143,7 @@ function resolveBundledIsDev() {
             return true;
         }
     }
-    catch {
+    catch (_a) {
         /* ignore */
     }
     try {
@@ -151,7 +151,7 @@ function resolveBundledIsDev() {
             return true;
         }
     }
-    catch {
+    catch (_b) {
         /* ignore */
     }
     return false;
@@ -226,7 +226,7 @@ function isScriptHostAllowed(url, hostSet) {
         const h = normalizeHost(u.hostname);
         return hostSet.has(h);
     }
-    catch {
+    catch (_a) {
         return false;
     }
 }
@@ -3438,7 +3438,7 @@ function parseWebPluginDevMapExplicit(opts) {
         const map = JSON.parse(String(raw));
         return map && typeof map === 'object' ? map : null;
     }
-    catch {
+    catch (_a) {
         console.warn('[wep] invalid webPluginDevMapJson / VITE_WEB_PLUGIN_DEV_MAP');
         return null;
     }
@@ -3490,7 +3490,7 @@ async function buildImplicitWebPluginDevMap(opts, hostSet) {
             return {};
         }
     }
-    catch {
+    catch (_a) {
         return {};
     }
     const pathPart = opts.webPluginDevEntryPath;
@@ -3514,7 +3514,7 @@ function closeAllPluginDevEventSources() {
         try {
             es.close();
         }
-        catch {
+        catch (_a) {
             /* ignore */
         }
     }
@@ -3532,7 +3532,7 @@ function isDevOriginAllowedForSse(origin, hostSet) {
         const u = new URL(origin);
         return hostSet.has(normalizeHost(u.hostname));
     }
-    catch {
+    catch (_a) {
         return false;
     }
 }
@@ -3576,7 +3576,7 @@ function startPluginDevSseForMap(devMap, isDev, hostSet, ssePath) {
         try {
             origins.add(new URL(t, window.location.href).origin);
         }
-        catch {
+        catch (_a) {
             /* skip */
         }
     }
@@ -3771,6 +3771,25 @@ function cloneMetaMap(registry) {
     }
     return out;
 }
+function resolveVueGlobalComponentSource(VueRuntime) {
+    if (!VueRuntime || typeof VueRuntime !== 'object' || Array.isArray(VueRuntime)) {
+        return undefined;
+    }
+    const maybeOptions = VueRuntime.options;
+    if (!maybeOptions || typeof maybeOptions !== 'object' || Array.isArray(maybeOptions)) {
+        return undefined;
+    }
+    const maybeComponents = maybeOptions.components;
+    return maybeComponents && typeof maybeComponents === 'object' && !Array.isArray(maybeComponents)
+        ? maybeComponents
+        : undefined;
+}
+function resolveHostComponentMeta(metaInput, name, component) {
+    const raw = typeof metaInput === 'function' ? metaInput(name, component) : metaInput;
+    return raw && typeof raw === 'object' && !Array.isArray(raw)
+        ? normalizeExposeMeta(raw)
+        : {};
+}
 function registerHostComponents(input) {
     const entries = normalizeNamedEntries(input, normalizeHostComponentEntry);
     for (const { name, entry } of entries) {
@@ -3791,22 +3810,60 @@ function registerHostModules(input) {
     }
     return getAllHostModuleMeta();
 }
+function registerVueGlobalComponents(VueRuntime, options = {}) {
+    const source = options.source && typeof options.source === 'object' && !Array.isArray(options.source)
+        ? options.source
+        : resolveVueGlobalComponentSource(VueRuntime);
+    if (!source) {
+        return getAllHostComponentMeta();
+    }
+    const registry = {};
+    for (const [rawName, component] of Object.entries(source)) {
+        const sourceName = String(rawName).trim();
+        if (!sourceName || component == null) {
+            continue;
+        }
+        if (typeof options.include === 'function' && !options.include(sourceName, component)) {
+            continue;
+        }
+        const mappedName = typeof options.mapName === 'function' ? options.mapName(sourceName, component) : sourceName;
+        const exposeName = typeof mappedName === 'string' ? mappedName.trim() : '';
+        if (!exposeName) {
+            continue;
+        }
+        registry[exposeName] = {
+            component,
+            ...resolveHostComponentMeta(options.meta, sourceName, component)
+        };
+    }
+    return registerHostComponents(registry);
+}
 function getHostComponent(name) {
     const key = typeof name === 'string' ? name.trim() : '';
-    return key ? hostComponentsRegistry[key]?.value : undefined;
+    if (!key) {
+        return undefined;
+    }
+    const record = hostComponentsRegistry[key];
+    return record ? record.value : undefined;
 }
 function getHostModule(name) {
     const key = typeof name === 'string' ? name.trim() : '';
-    return key ? hostModulesRegistry[key]?.value : undefined;
+    if (!key) {
+        return undefined;
+    }
+    const record = hostModulesRegistry[key];
+    return record ? record.value : undefined;
 }
 function getHostComponentMeta(name) {
     const key = typeof name === 'string' ? name.trim() : '';
-    const meta = key ? hostComponentsRegistry[key]?.meta : undefined;
+    const record = key ? hostComponentsRegistry[key] : undefined;
+    const meta = record ? record.meta : undefined;
     return meta ? { ...meta } : undefined;
 }
 function getHostModuleMeta(name) {
     const key = typeof name === 'string' ? name.trim() : '';
-    const meta = key ? hostModulesRegistry[key]?.meta : undefined;
+    const record = key ? hostModulesRegistry[key] : undefined;
+    const meta = record ? record.meta : undefined;
     return meta ? { ...meta } : undefined;
 }
 function getAllHostComponentMeta() {
@@ -3910,7 +3967,7 @@ function resolveStaticManifestUrlForFetch(url, origin) {
         const pathPart = u.startsWith('/') ? u : `/${u}`;
         return new URL(pathPart, o).href;
     }
-    catch {
+    catch (_a) {
         return u;
     }
 }
@@ -4296,13 +4353,13 @@ function manifestFetchCacheMiddleware$1(options = {}) {
                 return structuredClone(r);
             }
         }
-        catch {
+        catch (_a) {
             /* ignore */
         }
         try {
             return JSON.parse(JSON.stringify(r));
         }
-        catch {
+        catch (_b) {
             return { ...r, data: r.data };
         }
     }
@@ -4340,7 +4397,7 @@ function manifestFetchCacheMiddleware$1(options = {}) {
             }
             return res;
         }
-        catch {
+        catch (_a) {
             return null;
         }
     }
@@ -4348,7 +4405,7 @@ function manifestFetchCacheMiddleware$1(options = {}) {
         try {
             store.setItem(key, JSON.stringify({ expiresAt, result }));
         }
-        catch {
+        catch (_a) {
             /* Quota / 不可序列化 */
         }
     }
@@ -4441,7 +4498,7 @@ function normalizeBridgePath(input) {
         try {
             return decodeURIComponent(normalized);
         }
-        catch {
+        catch (_a) {
             return normalized;
         }
     })();
@@ -4955,6 +5012,7 @@ exports.manifestFetchCacheMiddleware = manifestFetchCacheMiddleware;
 exports.peerMinimumVersions = peerMinimumVersions;
 exports.registerHostComponents = registerHostComponents;
 exports.registerHostModules = registerHostModules;
+exports.registerVueGlobalComponents = registerVueGlobalComponents;
 exports.registries = registries;
 exports.resolveRuntimeOptions = resolveRuntimeOptions;
 exports.routeSynthNamePrefix = routeSynthNamePrefix;