@fulgurjs/federation 5.4.3 → 5.5.0

package/dist/bridge-host-react.js

@@ -1,7 +1,7 @@
 import {
   RoutingChannel,
   assertBridgeRoutingProtocol
-} from "./chunk-7CQOVLSI.js";
+} from "./chunk-YKIFZIBH.js";
 import {
   acquireBridgeSession,
   assertBridgeContract,
@@ -10,10 +10,10 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-RXXBTPAY.js";
+} from "./chunk-Q6V5O5Y6.js";
 import {
-  bridgeLifecycleError
-} from "./chunk-HZGQOW35.js";
+  bridgeHostError
+} from "./chunk-WRJG2YG6.js";
 import {
   provideAppContext
 } from "./chunk-TSYLDY6H.js";
@@ -154,7 +154,11 @@ function createReactBridgeAppWithLoader(loadRemote) {
               channelRef.current = new RoutingChannel(`bridge-react:${spec}:${myGen}`, routing.basePath, routing.navigation, spec);
               mountOptions = { signal: abortRef.current.signal, routing: channelRef.current };
             }
-            await contract.mount(el, { ...latest.current.appProps ?? {} }, mountOptions);
+            try {
+              await contract.mount(el, { ...latest.current.appProps ?? {} }, mountOptions);
+            } catch (mountError) {
+              throw bridgeHostError("mount", spec, mountError);
+            }
             if (generationRef.current !== myGen) return;
             setStatus("ready");
           } catch (e) {
@@ -174,7 +178,7 @@ function createReactBridgeAppWithLoader(loadRemote) {
             try {
               c.unmount(el);
             } catch (e) {
-              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(e));
+              const err = bridgeHostError("unmount", spec, e);
               console.error("[fulgurjs] \u6865\u63A5\u5E94\u7528\u5378\u8F7D\u5931\u8D25\uFF1A", err);
               blockedRef.current = true;
               setError(err);

package/dist/{bridge-host-vue-Dd1kkwDb.d.ts → bridge-host-vue-B3GHaQAC.d.ts}

@@ -1,5 +1,5 @@
 import { Component } from 'vue';
-import { A as AppContext } from './bridge-core-ejlY9ddN.js';
+import { A as AppContext } from './bridge-core-D37VanBl.js';
 
 /**
  * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。

package/dist/bridge-host-vue.cjs

@@ -119,6 +119,10 @@ function bridgeLifecycleError(phase, spec, cause, extra) {
     { cause }
   );
 }
+function bridgeHostError(phase, spec, cause) {
+  if (cause instanceof FgError) return cause;
+  return bridgeLifecycleError(phase, spec, cause instanceof Error ? cause : String(cause));
+}
 function bridgeSessionMismatchError(spec, controlled, actual, extra) {
   const actualText = actual === void 0 ? "undefined\uFF08\u9875\u9762\u5C1A\u65E0 AppContext\uFF09" : typeof actual === "string" ? `"${actual}"` : String(actual);
   return new FgError(
@@ -353,6 +357,7 @@ function assertBridgeRoutingProtocol(spec, contract) {
 var RoutingChannel = class {
   id;
   basePath;
+  /** 远程 spec（诊断错误定位真实远程用；随通道暴露给子应用路由接线） */
   spec;
   host;
   listeners = /* @__PURE__ */ new Set();
@@ -664,7 +669,7 @@ function createVueBridgeAppWithLoader(loadRemote) {
             try {
               c.unmount(el);
             } catch (e) {
-              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(e));
+              const err = bridgeHostError("unmount", spec, e);
               containerBlocked = true;
               console.error("[fulgurjs] \u6865\u63A5\u5E94\u7528\u5378\u8F7D\u5931\u8D25\uFF0C\u8BE5\u5BB9\u5668\u5DF2\u5C01\u9501\uFF08\u540C\u9875\u53EA\u80FD\u5237\u65B0\u6062\u590D\uFF09\uFF1A", err);
               error.value = err;
@@ -710,7 +715,11 @@ function createVueBridgeAppWithLoader(loadRemote) {
               mountOptions = { signal: genAbort.signal, routing: channel };
               void latestLoc;
             }
-            await contract.mount(el, { ...appPropsSource ?? {} }, mountOptions);
+            try {
+              await contract.mount(el, { ...appPropsSource ?? {} }, mountOptions);
+            } catch (e) {
+              throw bridgeHostError("mount", spec, e);
+            }
             if (myGeneration !== generation) return;
             status.value = "ready";
           } catch (e) {

package/dist/bridge-host-vue.js

@@ -1,7 +1,7 @@
 import {
   RoutingChannel,
   assertBridgeRoutingProtocol
-} from "./chunk-7CQOVLSI.js";
+} from "./chunk-YKIFZIBH.js";
 import {
   acquireBridgeSession,
   assertBridgeContract,
@@ -10,10 +10,10 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-RXXBTPAY.js";
+} from "./chunk-Q6V5O5Y6.js";
 import {
-  bridgeLifecycleError
-} from "./chunk-HZGQOW35.js";
+  bridgeHostError
+} from "./chunk-WRJG2YG6.js";
 import {
   provideAppContext
 } from "./chunk-TSYLDY6H.js";
@@ -138,7 +138,7 @@ function createVueBridgeAppWithLoader(loadRemote) {
             try {
               c.unmount(el);
             } catch (e) {
-              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(e));
+              const err = bridgeHostError("unmount", spec, e);
               containerBlocked = true;
               console.error("[fulgurjs] \u6865\u63A5\u5E94\u7528\u5378\u8F7D\u5931\u8D25\uFF0C\u8BE5\u5BB9\u5668\u5DF2\u5C01\u9501\uFF08\u540C\u9875\u53EA\u80FD\u5237\u65B0\u6062\u590D\uFF09\uFF1A", err);
               error.value = err;
@@ -184,7 +184,11 @@ function createVueBridgeAppWithLoader(loadRemote) {
               mountOptions = { signal: genAbort.signal, routing: channel };
               void latestLoc;
             }
-            await contract.mount(el, { ...appPropsSource ?? {} }, mountOptions);
+            try {
+              await contract.mount(el, { ...appPropsSource ?? {} }, mountOptions);
+            } catch (e) {
+              throw bridgeHostError("mount", spec, e);
+            }
             if (myGeneration !== generation) return;
             status.value = "ready";
           } catch (e) {

package/dist/bridge-react.d.ts

@@ -1,8 +1,8 @@
 import * as react from 'react';
-import { B as BridgeHostRouting } from './bridge-core-ejlY9ddN.js';
-export { A as AppContext, a as BridgeApp } from './bridge-core-ejlY9ddN.js';
-import { R as ReactBridgeAppOptions } from './bridge-host-react-Bua1TCVh.js';
-export { B as BridgeErrorFallback } from './bridge-host-react-Bua1TCVh.js';
+import { B as BridgeHostRouting } from './bridge-core-D37VanBl.js';
+export { A as AppContext, a as BridgeApp } from './bridge-core-D37VanBl.js';
+import { R as ReactBridgeAppOptions } from './bridge-host-react-CGymCzD2.js';
+export { B as BridgeErrorFallback } from './bridge-host-react-CGymCzD2.js';
 
 /** React 宿主桥接工厂：返回 `ComponentType<{ appProps: P; sessionKey?: string | null }>` */
 declare const createReactBridgeApp: <P = Record<string, unknown>>(spec: string, options?: ReactBridgeAppOptions) => react.ComponentType<{

package/dist/{bridge-router-core-BRZQYDPm.d.ts → bridge-router-core-DWFCVg9B.d.cts}

@@ -22,6 +22,12 @@ interface BridgeHostNavigation {
 }
 /** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
 interface BridgeChildRoute {
+    /**
+     * 远程 spec（宿主创建通道时标注，如 "remote-b/bridge"）；子应用路由接线
+     * （connectVueBridgeRouter/createReactBridgeRouter）的诊断错误用它定位真实远程，
+     * 缺省（纯 memory 小部件自建通道）回退 'child-router'。
+     */
+    readonly spec?: string;
     getLocation(): BridgeLocation;
     subscribe(listener: (location: BridgeLocation) => void): () => void;
     navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;

package/dist/{bridge-router-core-BRZQYDPm.d.cts → bridge-router-core-DWFCVg9B.d.ts}

@@ -22,6 +22,12 @@ interface BridgeHostNavigation {
 }
 /** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
 interface BridgeChildRoute {
+    /**
+     * 远程 spec（宿主创建通道时标注，如 "remote-b/bridge"）；子应用路由接线
+     * （connectVueBridgeRouter/createReactBridgeRouter）的诊断错误用它定位真实远程，
+     * 缺省（纯 memory 小部件自建通道）回退 'child-router'。
+     */
+    readonly spec?: string;
     getLocation(): BridgeLocation;
     subscribe(listener: (location: BridgeLocation) => void): () => void;
     navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;

package/dist/bridge-router-react.d.ts

@@ -25,6 +25,12 @@ interface BridgeHostNavigation {
 }
 /** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
 interface BridgeChildRoute {
+    /**
+     * 远程 spec（宿主创建通道时标注，如 "remote-b/bridge"）；子应用路由接线
+     * （connectVueBridgeRouter/createReactBridgeRouter）的诊断错误用它定位真实远程，
+     * 缺省（纯 memory 小部件自建通道）回退 'child-router'。
+     */
+    readonly spec?: string;
     getLocation(): BridgeLocation;
     subscribe(listener: (location: BridgeLocation) => void): () => void;
     navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;

package/dist/bridge-router-react.js

@@ -48,7 +48,17 @@ function sameLocation(a, b) {
 }
 
 // src/bridge-router-sync.ts
+function collapseConsecutiveReports(report) {
+  let last = "";
+  return (error) => {
+    const key = error instanceof Error ? `${error.name}|${error.message}` : String(error);
+    if (key === last) return;
+    last = key;
+    report(error);
+  };
+}
 function connectChildNavigation(routing, apply, onError) {
+  const spec = routing.spec ?? "child-router";
   let disposed = false;
   let generation = 0;
   let tail = Promise.resolve();
@@ -89,7 +99,7 @@ function connectChildNavigation(routing, apply, onError) {
               onError(restoreError);
             }
           }
-          throw routingSyncError("child-router", `\u5B50\u5E94\u7528\u8DEF\u7531\u51C6\u5907\u6216\u540C\u6B65\u5931\u8D25\uFF1A${cause instanceof Error ? cause.message : String(cause)}`, [], cause);
+          throw routingSyncError(spec, `\u5B50\u5E94\u7528\u8DEF\u7531\u51C6\u5907\u6216\u540C\u6B65\u5931\u8D25\uFF1A${cause instanceof Error ? cause.message : String(cause)}`, [], cause);
         } finally {
           pending = void 0;
         }
@@ -203,7 +213,7 @@ function createReactBridgeRouter(routing, routes, options = {}) {
   const sync = connectChildNavigation(routing, async (loc) => {
     const cur = router.state.location;
     if (!sameLocation(cur, loc)) await navigate(loc.pathname + loc.search + loc.hash, { replace: true });
-  }, (error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error));
+  }, collapseConsecutiveReports((error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error)));
   router.navigate = ((to, options2) => {
     if (typeof to === "number") {
       if (!disposed) routing.go(to);
@@ -215,7 +225,7 @@ function createReactBridgeRouter(routing, routes, options = {}) {
       return { pathname: l.pathname, search: l.search, hash: l.hash };
     }, options2?.replace ? "replace" : "push").then(() => {
     });
-    void task.catch((error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error));
+    void task.catch(collapseConsecutiveReports((error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error)));
     return task;
   });
   let unwatch = () => {

package/dist/bridge-router-vue.d.ts

@@ -24,6 +24,12 @@ interface BridgeHostNavigation {
 }
 /** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
 interface BridgeChildRoute {
+    /**
+     * 远程 spec（宿主创建通道时标注，如 "remote-b/bridge"）；子应用路由接线
+     * （connectVueBridgeRouter/createReactBridgeRouter）的诊断错误用它定位真实远程，
+     * 缺省（纯 memory 小部件自建通道）回退 'child-router'。
+     */
+    readonly spec?: string;
     getLocation(): BridgeLocation;
     subscribe(listener: (location: BridgeLocation) => void): () => void;
     navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;
@@ -36,7 +42,7 @@ interface BridgeHostRouting {
     navigation: BridgeHostNavigation;
 }
 
-/** Vue Router 4 的宿主导航端口与子应用 memory router 接线（按需入口）。 */
+/** Vue Router 4/5 的宿主导航端口与子应用 memory router 接线（按需入口）。 */
 
 interface VueBridgeNavigationOptions {
     /** 保留配置兼容；Vue Router fullPath 已剥离 history base，不再二次剥离。 */

package/dist/bridge-router-vue.js

@@ -1,3 +1,6 @@
+// src/bridge-router-vue.ts
+import { isNavigationFailure, NavigationFailureType } from "vue-router";
+
 // src/runtime/errors.ts
 var FgError = class extends Error {
   code;
@@ -44,7 +47,17 @@ function sameLocation(a, b) {
 }
 
 // src/bridge-router-sync.ts
+function collapseConsecutiveReports(report) {
+  let last = "";
+  return (error) => {
+    const key = error instanceof Error ? `${error.name}|${error.message}` : String(error);
+    if (key === last) return;
+    last = key;
+    report(error);
+  };
+}
 function connectChildNavigation(routing, apply, onError) {
+  const spec = routing.spec ?? "child-router";
   let disposed = false;
   let generation = 0;
   let tail = Promise.resolve();
@@ -85,7 +98,7 @@ function connectChildNavigation(routing, apply, onError) {
               onError(restoreError);
             }
           }
-          throw routingSyncError("child-router", `\u5B50\u5E94\u7528\u8DEF\u7531\u51C6\u5907\u6216\u540C\u6B65\u5931\u8D25\uFF1A${cause instanceof Error ? cause.message : String(cause)}`, [], cause);
+          throw routingSyncError(spec, `\u5B50\u5E94\u7528\u8DEF\u7531\u51C6\u5907\u6216\u540C\u6B65\u5931\u8D25\uFF1A${cause instanceof Error ? cause.message : String(cause)}`, [], cause);
         } finally {
           pending = void 0;
         }
@@ -134,6 +147,7 @@ function createVueBridgeNavigation(router, _options = {}) {
   };
 }
 function connectVueBridgeRouter(routing, router, options = {}) {
+  const spec = routing.spec ?? "vue-router";
   const push = router.push;
   const replace = router.replace;
   const go = router.go;
@@ -145,10 +159,13 @@ function connectVueBridgeRouter(routing, router, options = {}) {
     const path = loc.pathname + loc.search + loc.hash;
     if (router.currentRoute.value.fullPath !== path) {
       const failure = await replace.call(router, path);
-      if (failure && router.currentRoute.value.fullPath !== path) throw routingSyncError("vue-router", "\u5B50\u5E94\u7528\u5B88\u536B\u62D2\u7EDD\u5E94\u7528\u5BBF\u4E3B\u786E\u8BA4\u7684\u4F4D\u7F6E\uFF1B\u8BF7\u5728\u5BBF\u4E3B\u4FA7\u8BBE\u7F6E\u53D6\u6D88\u5B88\u536B\u3002", []);
+      if (failure && router.currentRoute.value.fullPath !== path) {
+        if (isNavigationFailure(failure, NavigationFailureType.cancelled)) return;
+        throw routingSyncError(spec, `\u5B50\u5E94\u7528\u5B88\u536B\u62D2\u7EDD\u5E94\u7528\u5BBF\u4E3B\u786E\u8BA4\u7684\u4F4D\u7F6E\uFF08\u76EE\u6807 ${path}\uFF09\uFF1B\u8BF7\u5728\u5BBF\u4E3B\u4FA7\u8BBE\u7F6E\u53D6\u6D88\u5B88\u536B\u3002`, []);
+      }
     }
   };
-  const sync = connectChildNavigation(routing, (loc) => ready.then(() => apply(loc)), report);
+  const sync = connectChildNavigation(routing, (loc) => ready.then(() => apply(loc)), collapseConsecutiveReports(report));
   const init = routing.getLocation();
   const ready = push.call(router, init.pathname + init.search + init.hash).then(async (failure) => {
     if (disposed) return;
@@ -156,14 +173,14 @@ function connectVueBridgeRouter(routing, router, options = {}) {
       await apply(routing.getLocation());
       return;
     }
-    if (failure) throw routingSyncError("vue-router", "\u5B50\u5E94\u7528\u521D\u59CB\u8DEF\u7531\u88AB\u5B88\u536B\u53D6\u6D88\u3002", []);
+    if (failure) throw routingSyncError(spec, "\u5B50\u5E94\u7528\u521D\u59CB\u8DEF\u7531\u88AB\u5B88\u536B\u53D6\u6D88\u3002", []);
     const target = locationFromPath(router.currentRoute.value.fullPath);
     if (router.currentRoute.value.fullPath !== init.pathname + init.search + init.hash) {
       await routing.navigate(target, "replace");
       await apply(routing.getLocation());
     }
   }).catch((cause) => {
-    throw routingSyncError("vue-router", `\u521D\u59CB\u8DEF\u7531\u51C6\u5907\u5931\u8D25\uFF1A${cause instanceof Error ? cause.message : String(cause)}`, [], cause);
+    throw routingSyncError(spec, `\u521D\u59CB\u8DEF\u7531\u51C6\u5907\u5931\u8D25\uFF1A${cause instanceof Error ? cause.message : String(cause)}`, [], cause);
   });
   const intercept = (native, action) => (to) => {
     const task = (async () => {

package/dist/bridge-vue.d.ts

@@ -1,6 +1,6 @@
 import * as vue from 'vue';
-import { V as VueBridgeAppOptions } from './bridge-host-vue-Dd1kkwDb.js';
-export { A as AppContext, a as BridgeApp } from './bridge-core-ejlY9ddN.js';
+import { V as VueBridgeAppOptions } from './bridge-host-vue-B3GHaQAC.js';
+export { A as AppContext, a as BridgeApp } from './bridge-core-D37VanBl.js';
 
 /** Vue 宿主桥接工厂：返回 `{ appProps: P; sessionKey?: string | null }` 形态的包装组件 */
 declare const createVueBridgeApp: <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => vue.Component;

package/dist/bridge.d.ts

@@ -1,10 +1,10 @@
 import * as react from 'react';
-import { B as BridgeHostRouting } from './bridge-core-ejlY9ddN.js';
-export { A as AppContext, a as BridgeApp } from './bridge-core-ejlY9ddN.js';
-import { R as ReactBridgeAppOptions } from './bridge-host-react-Bua1TCVh.js';
-export { B as BridgeErrorFallback } from './bridge-host-react-Bua1TCVh.js';
+import { B as BridgeHostRouting } from './bridge-core-D37VanBl.js';
+export { A as AppContext, a as BridgeApp } from './bridge-core-D37VanBl.js';
+import { R as ReactBridgeAppOptions } from './bridge-host-react-CGymCzD2.js';
+export { B as BridgeErrorFallback } from './bridge-host-react-CGymCzD2.js';
 import * as vue from 'vue';
-import { V as VueBridgeAppOptions } from './bridge-host-vue-Dd1kkwDb.js';
+import { V as VueBridgeAppOptions } from './bridge-host-vue-B3GHaQAC.js';
 
 /** Vue 宿主桥接工厂：返回 `{ appProps: P; sessionKey?: string | null }` 形态的包装组件 */
 declare const createVueBridgeApp: <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => vue.Component;

package/dist/{chunk-UFWZPE36.js → chunk-CI54BRPO.js}

@@ -653,6 +653,7 @@ function createRuntime() {
     });
   }
   const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+  const nameMismatchWarned = /* @__PURE__ */ new Set();
   function validateContainerInterface(container, remote) {
     if (!container || typeof container.get !== "function") {
       throw new Error(
@@ -662,7 +663,11 @@ function createRuntime() {
     if (container.name && remote.name && container.name !== remote.name) {
       const msg = `\u8FDC\u7A0B\u5165\u53E3\u81EA\u62A5\u540D\u79F0 "${container.name}" \u4E0E\u5BBF\u4E3B\u914D\u7F6E\u540D\u79F0 "${remote.name}" \u4E0D\u4E00\u81F4\u3002\u8BF7\u7EDF\u4E00\u4E24\u4FA7 federation({ name }) \u4E0E remotes \u7684\u540D\u79F0\u3002`;
       if (remote.promise) {
-        console.warn(`[fulgurjs] ${msg} \u5F53\u524D\u662F\u52A8\u6001 Promise \u8FDC\u7A0B\uFF0C\u7EE7\u7EED\u52A0\u8F7D\u3002`);
+        const key = `${remote.name}\u2194${container.name}`;
+        if (!nameMismatchWarned.has(key)) {
+          nameMismatchWarned.add(key);
+          console.warn(`[fulgurjs] ${msg} \u5F53\u524D\u662F\u52A8\u6001 Promise \u8FDC\u7A0B\uFF0C\u7EE7\u7EED\u52A0\u8F7D\u3002`);
+        }
       } else {
         throw Object.assign(new Error(msg), { code: ErrorCodes.REMOTE_NAME_MISMATCH });
       }
@@ -1171,6 +1176,10 @@ function bridgeLifecycleError(phase, spec, cause, extra) {
     { cause }
   );
 }
+function bridgeHostError(phase, spec, cause) {
+  if (cause instanceof FgError) return cause;
+  return bridgeLifecycleError(phase, spec, cause instanceof Error ? cause : String(cause));
+}
 function bridgeSessionMismatchError(spec, controlled, actual, extra) {
   const actualText = actual === void 0 ? "undefined\uFF08\u9875\u9762\u5C1A\u65E0 AppContext\uFF09" : typeof actual === "string" ? `"${actual}"` : String(actual);
   return new FgError(
@@ -1405,6 +1414,7 @@ function assertBridgeRoutingProtocol(spec, contract) {
 var RoutingChannel = class {
   id;
   basePath;
+  /** 远程 spec（诊断错误定位真实远程用；随通道暴露给子应用路由接线） */
   spec;
   host;
   listeners = /* @__PURE__ */ new Set();
@@ -1601,7 +1611,7 @@ var RoutingChannel = class {
 export {
   loadRemote,
   provideAppContext,
-  bridgeLifecycleError,
+  bridgeHostError,
   assertBridgeContract,
   acquireBridgeSession,
   releaseBridgeSession,

package/dist/{chunk-43UX3UZE.js → chunk-E3VEP6LN.js}

@@ -5,12 +5,12 @@ import {
   assertBridgeOptions,
   assertBridgeRoutingProtocol,
   assertControlledSessionKey,
-  bridgeLifecycleError,
+  bridgeHostError,
   provideAppContext,
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-UFWZPE36.js";
+} from "./chunk-CI54BRPO.js";
 
 // src/bridge-host-vue.ts
 import { defineComponent, h, onActivated, onBeforeUnmount, onDeactivated, onMounted, ref, shallowRef, toRaw, watch } from "vue";
@@ -131,7 +131,7 @@ function createVueBridgeAppWithLoader(loadRemote) {
             try {
               c.unmount(el);
             } catch (e) {
-              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(e));
+              const err = bridgeHostError("unmount", spec, e);
               containerBlocked = true;
               console.error("[fulgurjs] \u6865\u63A5\u5E94\u7528\u5378\u8F7D\u5931\u8D25\uFF0C\u8BE5\u5BB9\u5668\u5DF2\u5C01\u9501\uFF08\u540C\u9875\u53EA\u80FD\u5237\u65B0\u6062\u590D\uFF09\uFF1A", err);
               error.value = err;
@@ -177,7 +177,11 @@ function createVueBridgeAppWithLoader(loadRemote) {
               mountOptions = { signal: genAbort.signal, routing: channel };
               void latestLoc;
             }
-            await contract.mount(el, { ...appPropsSource ?? {} }, mountOptions);
+            try {
+              await contract.mount(el, { ...appPropsSource ?? {} }, mountOptions);
+            } catch (e) {
+              throw bridgeHostError("mount", spec, e);
+            }
             if (myGeneration !== generation) return;
             status.value = "ready";
           } catch (e) {

package/dist/{chunk-RXXBTPAY.js → chunk-Q6V5O5Y6.js}

@@ -3,7 +3,7 @@ import {
   bridgeSessionMismatchError,
   invalidBridgeContractError,
   invalidSessionKeyError
-} from "./chunk-HZGQOW35.js";
+} from "./chunk-WRJG2YG6.js";
 import {
   clearAppContext
 } from "./chunk-TSYLDY6H.js";

package/dist/{chunk-KT3YARK5.js → chunk-TU6DMGDA.js}

@@ -5,12 +5,12 @@ import {
   assertBridgeOptions,
   assertBridgeRoutingProtocol,
   assertControlledSessionKey,
-  bridgeLifecycleError,
+  bridgeHostError,
   provideAppContext,
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-UFWZPE36.js";
+} from "./chunk-CI54BRPO.js";
 
 // src/bridge-host-react.ts
 import {
@@ -147,7 +147,11 @@ function createReactBridgeAppWithLoader(loadRemote) {
               channelRef.current = new RoutingChannel(`bridge-react:${spec}:${myGen}`, routing.basePath, routing.navigation, spec);
               mountOptions = { signal: abortRef.current.signal, routing: channelRef.current };
             }
-            await contract.mount(el, { ...latest.current.appProps ?? {} }, mountOptions);
+            try {
+              await contract.mount(el, { ...latest.current.appProps ?? {} }, mountOptions);
+            } catch (mountError) {
+              throw bridgeHostError("mount", spec, mountError);
+            }
             if (generationRef.current !== myGen) return;
             setStatus("ready");
           } catch (e) {
@@ -167,7 +171,7 @@ function createReactBridgeAppWithLoader(loadRemote) {
             try {
               c.unmount(el);
             } catch (e) {
-              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(e));
+              const err = bridgeHostError("unmount", spec, e);
               console.error("[fulgurjs] \u6865\u63A5\u5E94\u7528\u5378\u8F7D\u5931\u8D25\uFF1A", err);
               blockedRef.current = true;
               setError(err);

package/dist/{chunk-HZGQOW35.js → chunk-WRJG2YG6.js}

@@ -51,6 +51,10 @@ function bridgeLifecycleError(phase, spec, cause, extra) {
     { cause }
   );
 }
+function bridgeHostError(phase, spec, cause) {
+  if (cause instanceof FgError) return cause;
+  return bridgeLifecycleError(phase, spec, cause instanceof Error ? cause : String(cause));
+}
 function bridgeSessionMismatchError(spec, controlled, actual, extra) {
   const actualText = actual === void 0 ? "undefined\uFF08\u9875\u9762\u5C1A\u65E0 AppContext\uFF09" : typeof actual === "string" ? `"${actual}"` : String(actual);
   return new FgError(
@@ -116,6 +120,7 @@ export {
   BridgeErrorCodes,
   invalidBridgeContractError,
   bridgeLifecycleError,
+  bridgeHostError,
   bridgeSessionMismatchError,
   invalidSessionKeyError,
   routingConfigError,

package/dist/{chunk-7CQOVLSI.js → chunk-YKIFZIBH.js}

@@ -3,7 +3,7 @@ import {
   routingNavigationError,
   routingProtocolError,
   routingSyncError
-} from "./chunk-HZGQOW35.js";
+} from "./chunk-WRJG2YG6.js";
 
 // src/bridge-router-core.ts
 var MAX_REDIRECT_PER_REQUEST = 5;
@@ -75,6 +75,7 @@ function assertBridgeRoutingProtocol(spec, contract) {
 var RoutingChannel = class {
   id;
   basePath;
+  /** 远程 spec（诊断错误定位真实远程用；随通道暴露给子应用路由接线） */
   spec;
   host;
   listeners = /* @__PURE__ */ new Set();