@fulgurjs/federation 5.4.3 → 5.5.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 5.5.0
+
+- **修复：Vite 8（rolldown）大型应用生产构建失败（V8-ASYNC-FIX）**——插件 TLA 协商门面使消费方模块的 chunk 内惰性初始化包装异步化后，与用户代码既有循环依赖相遇（JeecgBoot 实测：electron 工具模块 ⇄ 路由模块），rolldown 1.1.5 为循环另一侧生成的包装漏标 `async`（`e((()=>{await …}))` / `__esmMin((() => { await …` 两种形态），产物出现「await 位于非 async 函数」——esbuild 转译期报 `"await" can only be used inside an "async" function`，浏览器侧为 `SyntaxError: Unexpected reserved word`（5.4.x 时代曾被迫切 Vite 6 构建规避）。修复：插件在 `renderChunk`（order: pre，抢在 vite:esbuild-transpile 校验前）做检测与补标——esbuild 语法校验确证破损才修复，按 rolldown 包装签名补 `async`（即 rolldown 本应生成的代码，运行时助手对 Promise 包装本有支持），必要时 AST 定位兜底；修复后复验必须通过。正常产物零改动零解析成本；rollup（Vite 5/6/7）零触发。回归 `tests/async-mark-repair.test.ts`；Jeecg A/B（1920/1924 chunks）Vite 8.1.4 生产构建产物全部语法合法。**语义说明**：补标后的包装与 rolldown 在循环场景的既有输出一致（调用方同步调用返回 Promise 不等待，与 rolldown 自身对异步循环的处理相同），不改变任何调用点。
+- **修复：桥接诊断三项（MFU-033 降噪 / spec 失真 / cause 双重包装）**
+  - MFU-033 双诊断：宿主守卫（React `useBlocker`）回滚期的连续广播竞态曾产生重复的「子应用守卫拒绝应用宿主确认的位置」误导诊断。现在 `cancelled` 类失败（子应用自己的新导航取代广播应用，子应用自洽）按正常取消处理不再报 MFU-033；真实失步（`aborted` 等）仍报且诊断文本携带目标位置；连续完全相同的错误折叠为首条（不同失败事件永不合并）。
+  - 桥接错误 spec 真实化：`defineBridgeApp`（Vue/React 子应用适配器）不再以占位 spec `'bridge'` 预包装 MFU-016——mount/unmount 的原始错误原样抛出，由宿主适配器在生命周期边界**单点包装**（`bridgeHostError`：真实 spec + phase + 原始 cause，只包装一次；已是插件诊断的错误原样保留）。子应用路由接线（`connectVueBridgeRouter` 等）的同步失败诊断 spec 也从硬编码 `'vue-router'`/`'child-router'` 改为通道携带的真实远程名（`RoutingChannel.spec` 公开，`BridgeChildRoute.spec?`）。
+- **支持：Vue Router 5（peer `>=4.1.0 <6`）**——审查插件消费面（`Router`/`currentRoute.fullPath`/`push/replace/go`/`beforeResolve/beforeEach/afterEach`/`isNavigationFailure`/`NavigationFailureType`，枚举值 4/8/16 两版一致）后正式支持；vue-router 5.1.0 下路由/桥接全套单测 87/87 通过，JeecgBoot（vue-router ^5.1.0）dev+生产全链浏览器验收通过。
+- 修复：Promise 远程名称不一致告警在重试/恢复链路重复刷屏——同一（配置名↔自报名）对只告警一次。
+- 质量门禁：单测 615 → 623（async 补标 6 + MFU-033 降噪 2）；e2e dev 43/43、prod 28/28 全绿；两套类型（tsconfig + 最新 TS 口径）0 错误；gzip / 错误码 48 三方一致门禁通过。
+
+## 5.4.3
+
+- 修复：移除 5.4.2 误带入 `transformIndexHtml` 的一条无条件调试输出（`console.error` 探针在发布前漏删，污染使用方终端）。运行时与 5.4.2 一致，5.4.2 使用方请直接升级。
+
+## 5.4.2
+
+- 修复：多远程宿主 react-refresh preamble 错源（MFU-001 "can't detect preamble"）——Vue 宿主同时挂 Vue 子应用与 React 子应用时，发布脚本静态 import「首个 http dev 远程」的 `/@react-refresh`（错源 MIME 失败 → 标志未设）。修复：标志同步先设 + 动态 import 容错 + shim 自举兜底（`src/index.ts`、`src/virtual.ts` genReactRefreshShim）。
+- 修复：`BridgeHostRouting` 类型未从 `/bridge/router/vue`、`/bridge/router/react` 导出（README §8.3 与发布包 d.ts 不符）。
+- 新增导出面守卫用例（`tests/exports.test.ts`）。
+
 ## 5.4.1
 
 - 修复 URL 同步两端适配器将 replace 误报为 push、子应用 go/back/forward 未委托宿主历史，以及连续导航被丢弃的问题。

package/dist/bridge-app-react.cjs

@@ -34,54 +34,6 @@ __export(bridge_app_react_exports, {
 });
 module.exports = __toCommonJS(bridge_app_react_exports);
 var import_react = require("react");
-
-// src/runtime/errors.ts
-var FgError = class extends Error {
-  code;
-  details;
-  constructor(code, message, details, options) {
-    super(`[fulgurjs:${code}] ${message}`, options);
-    this.name = "FgError";
-    this.code = code;
-    this.details = details;
-  }
-};
-
-// src/bridge-errors.ts
-var BridgeErrorCodes = {
-  /** 桥接契约非法（./bridge 默认导出缺 mount/unmount 或不是函数） */
-  BRIDGE_INVALID_CONTRACT: "MFU-015",
-  /** 桥接准备或生命周期失败（details.phase = getContext | mount | unmount） */
-  BRIDGE_LIFECYCLE_FAILED: "MFU-016",
-  /** 桥接会话参数与 AppContext 不一致（受控 sessionKey 与全局会话矛盾） */
-  BRIDGE_SESSION_MISMATCH: "MFU-017",
-  /** 路由同步配置/前缀冲突（basePath 非法、同页前缀冲突或重叠） */
-  ROUTING_CONFIG_INVALID: "MFU-030",
-  /** 路由协议缺失/通道失效（子应用未声明 routing 协议，或已销毁通道被再次使用） */
-  ROUTING_PROTOCOL_MISSING: "MFU-031",
-  /** 非法导航（目标越界前缀、非法 go 参数、失效实例的请求） */
-  ROUTING_NAVIGATION_INVALID: "MFU-032",
-  /** 路由准备/同步失败（重定向循环、子应用路由准备失败且已阻止错误页面显示） */
-  ROUTING_SYNC_FAILED: "MFU-033"
-};
-function bridgeLifecycleError(phase, spec, cause, extra) {
-  const raw = cause instanceof Error ? cause.message : String(cause ?? "unknown");
-  const fixes = {
-    getContext: "\u4FEE\u6CD5: \u2460 getContext \u5FC5\u987B\u662F\u540C\u6B65\u3001\u65E0\u526F\u4F5C\u7528\u7684 getter\uFF08\u4E0D\u5F97\u8FD4\u56DE Promise/thenable\uFF09\uFF1B\n        \u2461 \u8FD4\u56DE\u503C\u987B\u662F\u5305\u542B\u672C\u6B21\u4F1A\u8BDD\u5FEB\u7167\u7684\u5BF9\u8C61\uFF08\u53D7\u63A7 sessionKey \u65F6\u987B\u542B\u76F8\u540C sessionKey\uFF09\uFF1B\n        \u2462 \u5F02\u6B65\u83B7\u53D6\u7528\u6237\u8D44\u6599\u8BF7\u5728\u5BBF\u4E3B\u5B8C\u6210\u540E\u518D\u8BA9\u6865\u63A5\u7EC4\u4EF6\u8FDB\u5165\u53EF\u6302\u8F7D\u72B6\u6001\u3002",
-    mount: "\u4FEE\u6CD5: \u2460 \u67E5\u770B\u6839\u56E0\u4E2D\u5B50\u5E94\u7528 mount \u7684\u539F\u59CB\u9519\u8BEF\uFF08\u5DE5\u5382\u629B\u9519\u6216\u9996\u6B21\u6E32\u67D3\u5931\u8D25\uFF09\uFF1B\n        \u2461 \u540C\u4E00\u5BB9\u5668\u672A\u5378\u8F7D\u524D\u91CD\u590D mount \u662F\u5951\u7EA6\u8FDD\u4F8B\u2014\u2014\u5148 unmount \u518D mount\uFF1B\n        \u2462 \u4FEE\u590D\u540E\u70B9\u51FB\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u5728\u540C\u9875\u91CD\u5EFA\u6302\u8F7D\u3002",
-    unmount: "\u4FEE\u6CD5: \u2460 \u6839\u56E0\u6765\u81EA\u5B50\u5E94\u7528 unmount \u5B9E\u73B0\uFF08app.unmount/root.unmount \u629B\u9519\uFF09\uFF1B\n        \u2461 \u8BE5\u5BB9\u5668\u6E05\u7406\u72B6\u6001\u4E0D\u786E\u5B9A\uFF0C\u63D2\u4EF6\u5DF2\u6301\u4E45\u5C01\u9501\u8BE5\u5BB9\u5668\u2014\u2014\u540C\u9875\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u4E0E\n        \u6362\u4F1A\u8BDD\u90FD\u4E0D\u4F1A\u5728\u6B64\u5BB9\u5668\u91CD\u65B0\u6302\u8F7D\uFF1B\n        \u2462 \u53EA\u80FD\u6574\u9875\u5237\u65B0\u6062\u590D\uFF08\u300C\u5237\u65B0\u9875\u9762\u91CD\u8BD5\u300D\uFF09\uFF1B\u6B8B\u7559\u8D44\u6E90\uFF08\u4E8B\u4EF6\u8BA2\u9605/\u5B9A\u65F6\u5668/\u5168\u5C40\u526F\u4F5C\u7528\uFF09\u8BF7\u5982\u5B9E\u6392\u67E5\u3002"
-  };
-  return new FgError(
-    BridgeErrorCodes.BRIDGE_LIFECYCLE_FAILED,
-    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684 ${phase} \u9636\u6BB5\u5931\u8D25\u3002
-  \u6839\u56E0: ${raw}
-` + fixes[phase],
-    { phase, spec, cause: String(raw), ...extra },
-    { cause }
-  );
-}
-
-// src/bridge-app-react.ts
 var entriesByEl = /* @__PURE__ */ new WeakMap();
 var FirstCommitGate = class extends import_react.Component {
   state = { error: null };
@@ -108,9 +60,7 @@ function defineBridgeApp(factory, options = {}) {
     ...options.routing ? { routing: { protocol: 1 } } : {},
     mount(el, props, mountOptions) {
       if (entriesByEl.has(el)) {
-        throw bridgeLifecycleError("mount", "bridge", "\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002", {
-          reason: "container-occupied"
-        });
+        throw new Error("\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002\u540C\u4E00\u5BB9\u5668\u672A\u5378\u8F7D\u524D\u91CD\u590D mount \u662F\u5951\u7EA6\u8FDD\u4F8B\u2014\u2014\u5148 unmount \u518D mount\u3002");
       }
       const snapshot = { ...props ?? {} };
       const ctx = { signal: mountOptions?.signal, routing: mountOptions?.routing };
@@ -118,13 +68,11 @@ function defineBridgeApp(factory, options = {}) {
       try {
         element = factory(snapshot, ctx);
       } catch (e) {
-        throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+        throw e instanceof Error ? e : new Error(String(e));
       }
       if (element === null || typeof element !== "object") {
-        throw bridgeLifecycleError(
-          "mount",
-          "bridge",
-          `defineBridgeApp \u5DE5\u5382\u8FD4\u56DE\u503C\u4E0D\u662F ReactElement\uFF08\u5F53\u524D ${element === null ? "null" : typeof element}\uFF09\u3002`
+        throw new Error(
+          `defineBridgeApp \u5DE5\u5382\u8FD4\u56DE\u503C\u4E0D\u662F ReactElement\uFF08\u5F53\u524D ${element === null ? "null" : typeof element}\uFF09\u3002\u5DE5\u5382\u5FC5\u987B\u8FD4\u56DE ReactElement\uFF08JSX/ createElement \u7684\u8FD4\u56DE\u503C\uFF09\u3002`
         );
       }
       const entry = { status: "pending" };
@@ -141,7 +89,7 @@ function defineBridgeApp(factory, options = {}) {
           const onError = (e) => {
             if (settled) return;
             settled = true;
-            reject(bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e)));
+            reject(e instanceof Error ? e : new Error(String(e)));
           };
           const onCommit = () => {
             if (settled) return;
@@ -184,7 +132,7 @@ function defineBridgeApp(factory, options = {}) {
       try {
         entry.root.unmount();
       } catch (e) {
-        throw bridgeLifecycleError("unmount", "bridge", e instanceof Error ? e : String(e));
+        throw e instanceof Error ? e : new Error(String(e));
       }
     }
   };

package/dist/bridge-app-react.d.cts

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
 import { BridgeApp } from './bridge-core.cjs';
-import { B as BridgeChildRoute } from './bridge-router-core-BRZQYDPm.cjs';
+import { B as BridgeChildRoute } from './bridge-router-core-DWFCVg9B.cjs';
 import './context.cjs';
 
 /**

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

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
 import { BridgeApp } from './bridge-core.js';
-import { B as BridgeChildRoute } from './bridge-router-core-BRZQYDPm.js';
+import { B as BridgeChildRoute } from './bridge-router-core-DWFCVg9B.js';
 import './context.js';
 
 /**

package/dist/bridge-app-react.js

@@ -1,8 +1,3 @@
-import {
-  bridgeLifecycleError
-} from "./chunk-HZGQOW35.js";
-import "./chunk-OF2JCXTZ.js";
-
 // src/bridge-app-react.ts
 import { Component, createElement, useEffect } from "react";
 var entriesByEl = /* @__PURE__ */ new WeakMap();
@@ -31,9 +26,7 @@ function defineBridgeApp(factory, options = {}) {
     ...options.routing ? { routing: { protocol: 1 } } : {},
     mount(el, props, mountOptions) {
       if (entriesByEl.has(el)) {
-        throw bridgeLifecycleError("mount", "bridge", "\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002", {
-          reason: "container-occupied"
-        });
+        throw new Error("\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002\u540C\u4E00\u5BB9\u5668\u672A\u5378\u8F7D\u524D\u91CD\u590D mount \u662F\u5951\u7EA6\u8FDD\u4F8B\u2014\u2014\u5148 unmount \u518D mount\u3002");
       }
       const snapshot = { ...props ?? {} };
       const ctx = { signal: mountOptions?.signal, routing: mountOptions?.routing };
@@ -41,13 +34,11 @@ function defineBridgeApp(factory, options = {}) {
       try {
         element = factory(snapshot, ctx);
       } catch (e) {
-        throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+        throw e instanceof Error ? e : new Error(String(e));
       }
       if (element === null || typeof element !== "object") {
-        throw bridgeLifecycleError(
-          "mount",
-          "bridge",
-          `defineBridgeApp \u5DE5\u5382\u8FD4\u56DE\u503C\u4E0D\u662F ReactElement\uFF08\u5F53\u524D ${element === null ? "null" : typeof element}\uFF09\u3002`
+        throw new Error(
+          `defineBridgeApp \u5DE5\u5382\u8FD4\u56DE\u503C\u4E0D\u662F ReactElement\uFF08\u5F53\u524D ${element === null ? "null" : typeof element}\uFF09\u3002\u5DE5\u5382\u5FC5\u987B\u8FD4\u56DE ReactElement\uFF08JSX/ createElement \u7684\u8FD4\u56DE\u503C\uFF09\u3002`
         );
       }
       const entry = { status: "pending" };
@@ -64,7 +55,7 @@ function defineBridgeApp(factory, options = {}) {
           const onError = (e) => {
             if (settled) return;
             settled = true;
-            reject(bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e)));
+            reject(e instanceof Error ? e : new Error(String(e)));
           };
           const onCommit = () => {
             if (settled) return;
@@ -107,7 +98,7 @@ function defineBridgeApp(factory, options = {}) {
       try {
         entry.root.unmount();
       } catch (e) {
-        throw bridgeLifecycleError("unmount", "bridge", e instanceof Error ? e : String(e));
+        throw e instanceof Error ? e : new Error(String(e));
       }
     }
   };

package/dist/bridge-app-vue.cjs

@@ -23,54 +23,6 @@ __export(bridge_app_vue_exports, {
   defineBridgeApp: () => defineBridgeApp
 });
 module.exports = __toCommonJS(bridge_app_vue_exports);
-
-// src/runtime/errors.ts
-var FgError = class extends Error {
-  code;
-  details;
-  constructor(code, message, details, options) {
-    super(`[fulgurjs:${code}] ${message}`, options);
-    this.name = "FgError";
-    this.code = code;
-    this.details = details;
-  }
-};
-
-// src/bridge-errors.ts
-var BridgeErrorCodes = {
-  /** 桥接契约非法（./bridge 默认导出缺 mount/unmount 或不是函数） */
-  BRIDGE_INVALID_CONTRACT: "MFU-015",
-  /** 桥接准备或生命周期失败（details.phase = getContext | mount | unmount） */
-  BRIDGE_LIFECYCLE_FAILED: "MFU-016",
-  /** 桥接会话参数与 AppContext 不一致（受控 sessionKey 与全局会话矛盾） */
-  BRIDGE_SESSION_MISMATCH: "MFU-017",
-  /** 路由同步配置/前缀冲突（basePath 非法、同页前缀冲突或重叠） */
-  ROUTING_CONFIG_INVALID: "MFU-030",
-  /** 路由协议缺失/通道失效（子应用未声明 routing 协议，或已销毁通道被再次使用） */
-  ROUTING_PROTOCOL_MISSING: "MFU-031",
-  /** 非法导航（目标越界前缀、非法 go 参数、失效实例的请求） */
-  ROUTING_NAVIGATION_INVALID: "MFU-032",
-  /** 路由准备/同步失败（重定向循环、子应用路由准备失败且已阻止错误页面显示） */
-  ROUTING_SYNC_FAILED: "MFU-033"
-};
-function bridgeLifecycleError(phase, spec, cause, extra) {
-  const raw = cause instanceof Error ? cause.message : String(cause ?? "unknown");
-  const fixes = {
-    getContext: "\u4FEE\u6CD5: \u2460 getContext \u5FC5\u987B\u662F\u540C\u6B65\u3001\u65E0\u526F\u4F5C\u7528\u7684 getter\uFF08\u4E0D\u5F97\u8FD4\u56DE Promise/thenable\uFF09\uFF1B\n        \u2461 \u8FD4\u56DE\u503C\u987B\u662F\u5305\u542B\u672C\u6B21\u4F1A\u8BDD\u5FEB\u7167\u7684\u5BF9\u8C61\uFF08\u53D7\u63A7 sessionKey \u65F6\u987B\u542B\u76F8\u540C sessionKey\uFF09\uFF1B\n        \u2462 \u5F02\u6B65\u83B7\u53D6\u7528\u6237\u8D44\u6599\u8BF7\u5728\u5BBF\u4E3B\u5B8C\u6210\u540E\u518D\u8BA9\u6865\u63A5\u7EC4\u4EF6\u8FDB\u5165\u53EF\u6302\u8F7D\u72B6\u6001\u3002",
-    mount: "\u4FEE\u6CD5: \u2460 \u67E5\u770B\u6839\u56E0\u4E2D\u5B50\u5E94\u7528 mount \u7684\u539F\u59CB\u9519\u8BEF\uFF08\u5DE5\u5382\u629B\u9519\u6216\u9996\u6B21\u6E32\u67D3\u5931\u8D25\uFF09\uFF1B\n        \u2461 \u540C\u4E00\u5BB9\u5668\u672A\u5378\u8F7D\u524D\u91CD\u590D mount \u662F\u5951\u7EA6\u8FDD\u4F8B\u2014\u2014\u5148 unmount \u518D mount\uFF1B\n        \u2462 \u4FEE\u590D\u540E\u70B9\u51FB\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u5728\u540C\u9875\u91CD\u5EFA\u6302\u8F7D\u3002",
-    unmount: "\u4FEE\u6CD5: \u2460 \u6839\u56E0\u6765\u81EA\u5B50\u5E94\u7528 unmount \u5B9E\u73B0\uFF08app.unmount/root.unmount \u629B\u9519\uFF09\uFF1B\n        \u2461 \u8BE5\u5BB9\u5668\u6E05\u7406\u72B6\u6001\u4E0D\u786E\u5B9A\uFF0C\u63D2\u4EF6\u5DF2\u6301\u4E45\u5C01\u9501\u8BE5\u5BB9\u5668\u2014\u2014\u540C\u9875\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u4E0E\n        \u6362\u4F1A\u8BDD\u90FD\u4E0D\u4F1A\u5728\u6B64\u5BB9\u5668\u91CD\u65B0\u6302\u8F7D\uFF1B\n        \u2462 \u53EA\u80FD\u6574\u9875\u5237\u65B0\u6062\u590D\uFF08\u300C\u5237\u65B0\u9875\u9762\u91CD\u8BD5\u300D\uFF09\uFF1B\u6B8B\u7559\u8D44\u6E90\uFF08\u4E8B\u4EF6\u8BA2\u9605/\u5B9A\u65F6\u5668/\u5168\u5C40\u526F\u4F5C\u7528\uFF09\u8BF7\u5982\u5B9E\u6392\u67E5\u3002"
-  };
-  return new FgError(
-    BridgeErrorCodes.BRIDGE_LIFECYCLE_FAILED,
-    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684 ${phase} \u9636\u6BB5\u5931\u8D25\u3002
-  \u6839\u56E0: ${raw}
-` + fixes[phase],
-    { phase, spec, cause: String(raw), ...extra },
-    { cause }
-  );
-}
-
-// src/bridge-app-vue.ts
 var appsByEl = /* @__PURE__ */ new WeakMap();
 var PENDING_MARKER = { __fulgurjsPending: true };
 function entriesAborted(el) {
@@ -90,7 +42,7 @@ function defineBridgeApp(factory, options = {}) {
         app.unmount();
       } catch {
       }
-      throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+      throw e;
     }
     appsByEl.set(el, app);
     void mountOptions;
@@ -102,9 +54,7 @@ function defineBridgeApp(factory, options = {}) {
     // 则结果丢弃不落挂（迟到初始化不得复活，BN06 同源语义）。
     mount(el, props, mountOptions) {
       if (appsByEl.has(el)) {
-        throw bridgeLifecycleError("mount", "bridge", "\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002", {
-          reason: "container-occupied"
-        });
+        throw new Error("\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002\u540C\u4E00\u5BB9\u5668\u672A\u5378\u8F7D\u524D\u91CD\u590D mount \u662F\u5951\u7EA6\u8FDD\u4F8B\u2014\u2014\u5148 unmount \u518D mount\u3002");
       }
       const snapshot = { ...props ?? {} };
       const ctx = { signal: mountOptions?.signal, routing: mountOptions?.routing };
@@ -122,7 +72,7 @@ function defineBridgeApp(factory, options = {}) {
             (e) => {
               if (entriesAborted(el)) return;
               appsByEl.delete(el);
-              throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+              throw e;
             }
           );
         }
@@ -134,7 +84,7 @@ function defineBridgeApp(factory, options = {}) {
           } catch {
           }
         }
-        throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+        throw e;
       }
       attach(el, app, mountOptions);
     },
@@ -146,7 +96,7 @@ function defineBridgeApp(factory, options = {}) {
       try {
         app.unmount();
       } catch (e) {
-        throw bridgeLifecycleError("unmount", "bridge", e instanceof Error ? e : String(e));
+        throw e instanceof Error ? e : new Error(String(e));
       }
     }
   };

package/dist/bridge-app-vue.d.cts

@@ -1,6 +1,6 @@
 import { App } from 'vue';
 import { BridgeApp } from './bridge-core.cjs';
-import { B as BridgeChildRoute } from './bridge-router-core-BRZQYDPm.cjs';
+import { B as BridgeChildRoute } from './bridge-router-core-DWFCVg9B.cjs';
 import './context.cjs';
 
 /**
@@ -11,10 +11,11 @@ import './context.cjs';
  *
  * 契约语义（§3.2）：
  * - 契约实例按容器 el 分键（WeakMap）：同一契约多处挂载互不干扰；
- * - 同一容器未卸载再次 mount → MFU-016（phase: mount，容器已被占用）且不覆盖原实例；
+ * - 同一容器未卸载再次 mount → 拒绝（容器占用，原始错误原样抛出）且不覆盖原实例；
  * - Vue 的 app.mount 同步完成首次渲染，mount 成功即返回 void（首次根提交语义由 Vue 保证）；
  * - mount 抛错时清理已创建的 app（best-effort unmount），不留半挂状态；
- * - unmount 未知容器为 no-op；unmount 抛错包装为 MFU-016（phase: unmount）由宿主捕获。
+ * - unmount 未知容器为 no-op；mount/unmount 的原始错误**原样抛出**——MFU-016 包装
+ *   （真实 spec + phase + cause）由宿主适配器在生命周期边界统一完成（见 bridgeHostError）。
  *
  * 本文件零 React：/runtime 导入图隔离由 tests/runtime-entry-graph.test.ts 守护。
  */

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

@@ -1,6 +1,6 @@
 import { App } from 'vue';
 import { BridgeApp } from './bridge-core.js';
-import { B as BridgeChildRoute } from './bridge-router-core-BRZQYDPm.js';
+import { B as BridgeChildRoute } from './bridge-router-core-DWFCVg9B.js';
 import './context.js';
 
 /**
@@ -11,10 +11,11 @@ import './context.js';
  *
  * 契约语义（§3.2）：
  * - 契约实例按容器 el 分键（WeakMap）：同一契约多处挂载互不干扰；
- * - 同一容器未卸载再次 mount → MFU-016（phase: mount，容器已被占用）且不覆盖原实例；
+ * - 同一容器未卸载再次 mount → 拒绝（容器占用，原始错误原样抛出）且不覆盖原实例；
  * - Vue 的 app.mount 同步完成首次渲染，mount 成功即返回 void（首次根提交语义由 Vue 保证）；
  * - mount 抛错时清理已创建的 app（best-effort unmount），不留半挂状态；
- * - unmount 未知容器为 no-op；unmount 抛错包装为 MFU-016（phase: unmount）由宿主捕获。
+ * - unmount 未知容器为 no-op；mount/unmount 的原始错误**原样抛出**——MFU-016 包装
+ *   （真实 spec + phase + cause）由宿主适配器在生命周期边界统一完成（见 bridgeHostError）。
  *
  * 本文件零 React：/runtime 导入图隔离由 tests/runtime-entry-graph.test.ts 守护。
  */

package/dist/bridge-app-vue.js

@@ -1,8 +1,3 @@
-import {
-  bridgeLifecycleError
-} from "./chunk-HZGQOW35.js";
-import "./chunk-OF2JCXTZ.js";
-
 // src/bridge-app-vue.ts
 var appsByEl = /* @__PURE__ */ new WeakMap();
 var PENDING_MARKER = { __fulgurjsPending: true };
@@ -23,7 +18,7 @@ function defineBridgeApp(factory, options = {}) {
         app.unmount();
       } catch {
       }
-      throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+      throw e;
     }
     appsByEl.set(el, app);
     void mountOptions;
@@ -35,9 +30,7 @@ function defineBridgeApp(factory, options = {}) {
     // 则结果丢弃不落挂（迟到初始化不得复活，BN06 同源语义）。
     mount(el, props, mountOptions) {
       if (appsByEl.has(el)) {
-        throw bridgeLifecycleError("mount", "bridge", "\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002", {
-          reason: "container-occupied"
-        });
+        throw new Error("\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002\u540C\u4E00\u5BB9\u5668\u672A\u5378\u8F7D\u524D\u91CD\u590D mount \u662F\u5951\u7EA6\u8FDD\u4F8B\u2014\u2014\u5148 unmount \u518D mount\u3002");
       }
       const snapshot = { ...props ?? {} };
       const ctx = { signal: mountOptions?.signal, routing: mountOptions?.routing };
@@ -55,7 +48,7 @@ function defineBridgeApp(factory, options = {}) {
             (e) => {
               if (entriesAborted(el)) return;
               appsByEl.delete(el);
-              throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+              throw e;
             }
           );
         }
@@ -67,7 +60,7 @@ function defineBridgeApp(factory, options = {}) {
           } catch {
           }
         }
-        throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+        throw e;
       }
       attach(el, app, mountOptions);
     },
@@ -79,7 +72,7 @@ function defineBridgeApp(factory, options = {}) {
       try {
         app.unmount();
       } catch (e) {
-        throw bridgeLifecycleError("unmount", "bridge", e instanceof Error ? e : String(e));
+        throw e instanceof Error ? e : new Error(String(e));
       }
     }
   };

package/dist/{bridge-core-ejlY9ddN.d.ts → bridge-core-D37VanBl.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-core.d.cts

@@ -1,5 +1,5 @@
 import { AppContext } from './context.cjs';
-import { a as BridgeMountOptions, b as BridgeRoutingProtocol } from './bridge-router-core-BRZQYDPm.cjs';
+import { a as BridgeMountOptions, b as BridgeRoutingProtocol } from './bridge-router-core-DWFCVg9B.cjs';
 
 /** 子应用桥接契约（远程 ./bridge 模块的默认导出；任务书 §3.2） */
 interface BridgeApp {

package/dist/bridge-core.d.ts

@@ -1,5 +1,5 @@
 import { AppContext } from './context.js';
-import { a as BridgeMountOptions, b as BridgeRoutingProtocol } from './bridge-router-core-BRZQYDPm.js';
+import { a as BridgeMountOptions, b as BridgeRoutingProtocol } from './bridge-router-core-DWFCVg9B.js';
 
 /** 子应用桥接契约（远程 ./bridge 模块的默认导出；任务书 §3.2） */
 interface BridgeApp {

package/dist/bridge-core.js

@@ -6,8 +6,8 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-RXXBTPAY.js";
-import "./chunk-HZGQOW35.js";
+} from "./chunk-Q6V5O5Y6.js";
+import "./chunk-WRJG2YG6.js";
 import "./chunk-TSYLDY6H.js";
 import "./chunk-OF2JCXTZ.js";
 export {

package/dist/bridge-errors.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var bridge_errors_exports = {};
 __export(bridge_errors_exports, {
   BridgeErrorCodes: () => BridgeErrorCodes,
+  bridgeHostError: () => bridgeHostError,
   bridgeLifecycleError: () => bridgeLifecycleError,
   bridgeSessionMismatchError: () => bridgeSessionMismatchError,
   invalidBridgeContractError: () => invalidBridgeContractError,
@@ -93,6 +94,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(
@@ -156,6 +161,7 @@ function routingSyncError(spec, reason, chain, cause) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BridgeErrorCodes,
+  bridgeHostError,
   bridgeLifecycleError,
   bridgeSessionMismatchError,
   invalidBridgeContractError,

package/dist/bridge-errors.d.cts

@@ -36,6 +36,14 @@ type BridgePhase = 'getContext' | 'mount' | 'unmount';
 declare function invalidBridgeContractError(spec: string, mod: unknown): FgError;
 /** MFU-016：桥接准备（getContext）或生命周期（mount/unmount）失败；cause 保留原始错误 */
 declare function bridgeLifecycleError(phase: BridgePhase, spec: string, cause: unknown, extra?: Record<string, unknown>): FgError;
+/**
+ * 宿主适配器的 MFU-016 单点包装（5.5.0 起）：
+ * 子应用适配器（defineBridgeApp）原样抛出 mount/unmount 的原始错误——此前子侧预包装
+ * spec 只能是占位 'bridge'，宿主再包一次造成「spec 失真 + cause 双重包装」的误导诊断。
+ * 宿主在生命周期边界统一包装：真实 spec + phase + 原始 cause 只包装一次；
+ * 已是本插件诊断（FgError）的错误原样保留，不重复包装。
+ */
+declare function bridgeHostError(phase: BridgePhase, spec: string, cause: unknown): FgError;
 /** MFU-017：受控 sessionKey 与当前 AppContext / 活跃桥接会话不一致 */
 declare function bridgeSessionMismatchError(spec: string, controlled: string, actual: unknown, extra?: Record<string, unknown>): FgError;
 /** MFU-017：受控 sessionKey 值本身非法（空字符串/数字等，非 undefined/null/非空字符串） */
@@ -49,4 +57,4 @@ declare function routingNavigationError(spec: string, reason: string): FgError;
 /** MFU-033：路由准备/同步失败（重定向循环等；不伪装成功也不静默回退 memory） */
 declare function routingSyncError(spec: string, reason: string, chain: string[], cause?: unknown): FgError;
 
-export { BridgeErrorCodes, type BridgePhase, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError, routingConfigError, routingNavigationError, routingProtocolError, routingSyncError };
+export { BridgeErrorCodes, type BridgePhase, bridgeHostError, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError, routingConfigError, routingNavigationError, routingProtocolError, routingSyncError };

package/dist/bridge-errors.d.ts

@@ -36,6 +36,14 @@ type BridgePhase = 'getContext' | 'mount' | 'unmount';
 declare function invalidBridgeContractError(spec: string, mod: unknown): FgError;
 /** MFU-016：桥接准备（getContext）或生命周期（mount/unmount）失败；cause 保留原始错误 */
 declare function bridgeLifecycleError(phase: BridgePhase, spec: string, cause: unknown, extra?: Record<string, unknown>): FgError;
+/**
+ * 宿主适配器的 MFU-016 单点包装（5.5.0 起）：
+ * 子应用适配器（defineBridgeApp）原样抛出 mount/unmount 的原始错误——此前子侧预包装
+ * spec 只能是占位 'bridge'，宿主再包一次造成「spec 失真 + cause 双重包装」的误导诊断。
+ * 宿主在生命周期边界统一包装：真实 spec + phase + 原始 cause 只包装一次；
+ * 已是本插件诊断（FgError）的错误原样保留，不重复包装。
+ */
+declare function bridgeHostError(phase: BridgePhase, spec: string, cause: unknown): FgError;
 /** MFU-017：受控 sessionKey 与当前 AppContext / 活跃桥接会话不一致 */
 declare function bridgeSessionMismatchError(spec: string, controlled: string, actual: unknown, extra?: Record<string, unknown>): FgError;
 /** MFU-017：受控 sessionKey 值本身非法（空字符串/数字等，非 undefined/null/非空字符串） */
@@ -49,4 +57,4 @@ declare function routingNavigationError(spec: string, reason: string): FgError;
 /** MFU-033：路由准备/同步失败（重定向循环等；不伪装成功也不静默回退 memory） */
 declare function routingSyncError(spec: string, reason: string, chain: string[], cause?: unknown): FgError;
 
-export { BridgeErrorCodes, type BridgePhase, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError, routingConfigError, routingNavigationError, routingProtocolError, routingSyncError };
+export { BridgeErrorCodes, type BridgePhase, bridgeHostError, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError, routingConfigError, routingNavigationError, routingProtocolError, routingSyncError };

package/dist/bridge-errors.js

@@ -1,5 +1,6 @@
 import {
   BridgeErrorCodes,
+  bridgeHostError,
   bridgeLifecycleError,
   bridgeSessionMismatchError,
   invalidBridgeContractError,
@@ -8,10 +9,11 @@ import {
   routingNavigationError,
   routingProtocolError,
   routingSyncError
-} from "./chunk-HZGQOW35.js";
+} from "./chunk-WRJG2YG6.js";
 import "./chunk-OF2JCXTZ.js";
 export {
   BridgeErrorCodes,
+  bridgeHostError,
   bridgeLifecycleError,
   bridgeSessionMismatchError,
   invalidBridgeContractError,

package/dist/{bridge-host-react-Bua1TCVh.d.ts → bridge-host-react-CGymCzD2.d.ts}

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

package/dist/bridge-host-react.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();
@@ -674,7 +679,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) {
@@ -694,7 +703,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-react.d.cts

@@ -1,6 +1,6 @@
 import { ReactNode, ComponentType } from 'react';
 import { AppContext } from './context.cjs';
-import { c as BridgeHostRouting } from './bridge-router-core-BRZQYDPm.cjs';
+import { c as BridgeHostRouting } from './bridge-router-core-DWFCVg9B.cjs';
 
 /**
  * React 宿主桥接工厂（/bridge、/bridge/react 导出 createReactBridgeApp；任务书 §3.4）。

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

@@ -1,6 +1,6 @@
 import { ReactNode, ComponentType } from 'react';
 import { AppContext } from './context.js';
-import { c as BridgeHostRouting } from './bridge-router-core-BRZQYDPm.js';
+import { c as BridgeHostRouting } from './bridge-router-core-DWFCVg9B.js';
 
 /**
  * React 宿主桥接工厂（/bridge、/bridge/react 导出 createReactBridgeApp；任务书 §3.4）。