@fulgurjs/federation 6.12.12 → 6.13.0

package/dist/vue-adapter.js

@@ -2,18 +2,21 @@ import {
   cleanCompName,
   createHostPagesCore,
   isComponentLoader,
+  moduleNameOf,
   noRenderableExportError,
   readSessionKey,
+  remoteNameOf,
+  reportRemoteObservation,
   resolvePageProviderEntries,
   shouldResetSessionCache
-} from "./chunk-MUATDGMR.js";
+} from "./chunk-2OHKAD6I.js";
 import "./chunk-TSXZ7TWA.js";
 import {
   ErrorCodes
-} from "./chunk-4YTQSOGQ.js";
+} from "./chunk-YHXQHZ3E.js";
 
 // src/vue-adapter.ts
-import { defineAsyncComponent, defineComponent, getCurrentInstance, h, ref, shallowRef, onActivated, onUnmounted, version as vueRuntimeVersion } from "vue";
+import { defineAsyncComponent, defineComponent, getCurrentInstance, h, onErrorCaptured, ref, shallowRef, onActivated, onUnmounted, version as vueRuntimeVersion } from "vue";
 function isVueRenderableComponent(inner) {
   if (!inner) return false;
   if (typeof inner === "function") return true;
@@ -102,7 +105,7 @@ var RemoteErrorPlaceholder = /* @__PURE__ */ defineComponent({
         h("p", { style: "margin:0 0 4px;font-weight:600" }, `\u8FDC\u7A0B\u7EC4\u4EF6\u52A0\u8F7D\u5931\u8D25\uFF08\u9519\u8BEF\u7801 ${code}\uFF09`),
         h("p", { style: "margin:0 0 8px;word-break:break-all" }, message),
         h("p", { style: "margin:0 0 8px" }, "\u4FEE\u6CD5\uFF1A\u2460 \u6838\u5BF9 spec \u7684\u300C\u8FDC\u7A0B\u540D/expose \u540D\u300D\u4E0E\u8FDC\u7A0B\u5E94\u7528 exposes \u662F\u5426\u4E00\u81F4\uFF08MFU-006/008/018\uFF09\uFF1B\u2461 \u6838\u5BF9 remotes \u5730\u5740\u7AEF\u53E3\u4E0E\u8FDC\u7A0B\u670D\u52A1\u53EF\u8FBE\u6027\u3001remoteEntry \u662F\u5426\u53EF\u8BBF\u95EE\uFF08MFU-001\uFF09\uFF1B\u2462 \u67E5\u770B window \u7684 fulgurjs:error \u4E8B\u4EF6\u4E0E console \u540C\u6E90\u9519\u8BEF\u5B9A\u4F4D\u6839\u56E0\u3002"),
-        h("p", { style: "margin:0 0 8px" }, "\u7F51\u7EDC\u53D6\u8BC1\uFF1ANetwork \u9762\u677F\u770B\u5931\u8D25\u7684\u5177\u4F53 chunk\u2014\u2014\u6709\u7EA2\u8272\u8BF7\u6C42\uFF08404/502\uFF09= \u8D44\u6E90\u7F3A\u5931\u6216\u4EE3\u7406\u9519\u8BEF\uFF1B\u96F6\u65B0\u8BF7\u6C42\u4E14\u76F4\u63A5\u62D2\u7EDD = \u6D4F\u89C8\u5668\u5DF2\u7F13\u5B58\u4E0A\u6B21 import \u5931\u8D25\uFF08\u540C URL \u4E0D\u518D\u53D1\u8BF7\u6C42\uFF09\uFF0C\u7528\u300C\u5237\u65B0\u9875\u9762\u91CD\u8BD5\u300D\u7A7F\u900F\uFF1B\u5916\u58F3\u6B63\u5E38\u800C\u5185\u90E8\u7A7A\u767D\u4E14\u65E0\u62A5\u9519 = \u4F18\u5148\u6838\u5BF9 shared.vue \u5B9E\u4F8B\u6536\u655B\uFF08MFU-019\uFF09\u3002"),
+        h("p", { style: "margin:0 0 8px" }, "\u4E0B\u4E00\u6B65\u53D6\u8BC1\uFF08\u6309\u4E8B\u5B9E\u533A\u5206\uFF0C\u4E0D\u9884\u5224\u7ED3\u8BBA\uFF09\uFF1A\u2460 \u672C\u9519\u8BEF\u4E0A\u65B9\u300C\u539F\u56E0\u300D\u4E0E fulgurjs:error \u4E8B\u4EF6\u7684 details.stage \u6807\u660E\u5931\u8D25\u9636\u6BB5\u2014\u2014container=\u5165\u53E3/\u7F51\u7EDC\uFF0Cexpose=\u6A21\u5757\u6C42\u503C/\u5BFC\u51FA\uFF0Csetup=\u8FDC\u7A0B\u521D\u59CB\u5316\uFF0Crender=\u8FDC\u7A0B\u7EC4\u4EF6\u5185\u90E8\u6E32\u67D3\uFF1B\u524D\u7F6E\u6821\u9A8C\u6216\u914D\u7F6E\u7C7B\u62D2\u7EDD\u4E0D\u53D1\u8D77\u7F51\u7EDC\u8BF7\u6C42\uFF0CNetwork \u9762\u677F\u96F6\u65B0\u8BF7\u6C42\u4E5F\u53EF\u80FD\u5B8C\u5168\u6B63\u5E38\u3002\u2461 Network \u9762\u677F\u786E\u6709\u7EA2\u8272\u8BF7\u6C42\u65F6\uFF0C\u8BFB\u8BE5\u8BF7\u6C42\u5B9E\u9645 status \u4E0E\u54CD\u5E94\u5185\u5BB9\uFF08404/502=\u8D44\u6E90\u7F3A\u5931\u6216\u4EE3\u7406\u9519\u8BEF\uFF1B200 \u4F46\u8FD4\u56DE HTML=\u5165\u53E3\u88AB SPA fallback \u8BEF\u56DE\u9000\uFF09\u3002\u2462 Network \u9762\u677F\u96F6\u65B0\u8BF7\u6C42\u4E14\u6D88\u606F\u542B import/Failed to fetch\uFF1A\u53EF\u80FD\u662F\u6D4F\u89C8\u5668\u7F13\u5B58\u4E86\u4E0A\u6B21\u540C URL \u7684 import \u5931\u8D25\uFF08module map \u5BF9\u5931\u8D25 URL \u4E0D\u518D\u53D1\u8BF7\u6C42\uFF09\uFF0C\u4E5F\u53EF\u80FD\u662F\u52A0\u8F7D\u524D\u7684\u672C\u5730\u6821\u9A8C\u62D2\u7EDD\u2014\u2014\u5148\u7528\u300C\u5237\u65B0\u9875\u9762\u91CD\u8BD5\u300D\u6574\u9875\u91CD\u8BD5\u518D\u5224\u65AD\u3002\u2463 \u5916\u58F3\u6B63\u5E38\u800C\u5185\u90E8\u7A7A\u767D\uFF1A\u53EF\u80FD\u539F\u56E0\u5305\u62EC\u8FDC\u7A0B\u7EC4\u4EF6\u6E32\u67D3\u9519\u8BEF\u88AB\u4E1A\u52A1 handler \u63A5\u7BA1\u3001\u5408\u6CD5\u7A7A\u6570\u636E\u6216\u4F9D\u8D56\u7F3A\u5931\uFF0C\u4E0D\u7B49\u4E8E\u5DF2\u786E\u8BA4 shared.vue \u5B9E\u4F8B\u5206\u88C2\uFF1B\u6838\u5BF9 window \u7684 fulgurjs:error\uFF08\u542B MFU-020/019\uFF09\u4E0E __FULGURJS_SCOPE__ \u540E\u518D\u5B9A\u4F4D\u3002"),
         h("p", { style: "margin:0 0 10px" }, "\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u5728\u5F53\u524D\u9875\u9762\u91CD\u5EFA\u52A0\u8F7D\uFF1B\u82E5\u6D4F\u89C8\u5668\u5DF2\u7F13\u5B58\u5931\u8D25\u7684\u6A21\u5757\uFF08\u5982\u8FDC\u7A0B\u9759\u6001\u5B50\u4F9D\u8D56\u66FE\u52A0\u8F7D\u5931\u8D25\uFF09\uFF0C\u8BF7\u7528\u300C\u5237\u65B0\u9875\u9762\u91CD\u8BD5\u300D\u2014\u2014\u5B83\u4F1A\u6574\u9875\u5237\u65B0\uFF08\u4FDD\u7559\u5F53\u524D\u5730\u5740\uFF09\uFF0C\u672A\u4FDD\u5B58\u7684\u9875\u9762\u72B6\u6001\u4F1A\u4E22\u5931\u3002"),
         h("div", { style: "margin:0" }, buttons)
       ]);
@@ -128,6 +131,7 @@ function createRecoverableErrorPlaceholder(loader, spec, userErrorComponent) {
           if (!isVueRenderableComponent(inner)) throw noRenderableExportError(spec, inner);
           recovered.value = inner;
         } catch (e) {
+          reportRemoteObservation({ remote: remoteNameOf(spec), error: e });
           retryError.value = e;
         } finally {
           retrying.value = false;
@@ -145,6 +149,35 @@ function createRecoverableErrorPlaceholder(loader, spec, userErrorComponent) {
     }
   });
 }
+function remoteRenderBoundary(spec, renderErrorComponent) {
+  const error = shallowRef(void 0);
+  const epoch = ref(0);
+  const retry = () => {
+    error.value = void 0;
+    epoch.value += 1;
+  };
+  const onErrorCaptured2 = (err, _instance, info) => {
+    const reported = Object.assign(
+      new Error(
+        `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u7EC4\u4EF6 "${spec}" \u7684\u5B50\u6811\u5185\u90E8\u629B\u51FA\u9519\u8BEF\uFF08\u6E32\u67D3\u9636\u6BB5\uFF1A${info || "\u672A\u77E5"}\uFF09\u3002
+\u6839\u56E0\uFF08\u5DF2\u8BC1\u5B9E\uFF09\uFF1A\u9519\u8BEF\u629B\u81EA\u8FDC\u7A0B\u7EC4\u4EF6\u81EA\u8EAB\u7684 setup/render/\u5D4C\u5957\u5F02\u6B65\u7EC4\u4EF6\uFF0C\u4E0E\u8054\u90A6\u7684\u6A21\u5757\u52A0\u8F7D\u65E0\u5173\uFF1B\u539F\u59CB\u5F02\u5E38\u4FDD\u7559\u5728\u672C\u9519\u8BEF\u7684 cause \u4E0E\u4E8B\u4EF6 detail \u4E2D\u3002
+\u4FEE\u6CD5\uFF1A\u67E5\u770B cause \u7684\u539F\u59CB\u8C03\u7528\u6808\u5B9A\u4F4D\u8FDC\u7A0B\u7EC4\u4EF6\u5185\u90E8\u4EE3\u7801\u3002\u9700\u8981\u5728\u672C\u7EC4\u4EF6\u4F4D\u7F6E\u76F4\u63A5\u5C55\u793A\u9519\u8BEF\u5E76\u63D0\u4F9B\u6062\u590D\u65F6\uFF0C\u4E3A remoteComponent/createHostPages \u4F20\u5165 renderErrorComponent\uFF08\u672C\u8FB9\u754C\u5C06\u63A5\u7BA1\u5C55\u793A\uFF0C\u9519\u8BEF\u4E0D\u518D\u5411\u5168\u5C40\u4F20\u64AD\uFF09\u3002`
+      ),
+      {
+        code: ErrorCodes.REMOTE_RENDER_ERROR,
+        details: { remote: remoteNameOf(spec), module: moduleNameOf(spec), phase: "render", renderInfo: info || void 0 },
+        cause: err
+      }
+    );
+    reportRemoteObservation({ remote: remoteNameOf(spec), error: reported });
+    if (renderErrorComponent) {
+      error.value = err;
+      return false;
+    }
+    return void 0;
+  };
+  return { onErrorCaptured: onErrorCaptured2, error, epoch, retry, view: renderErrorComponent };
+}
 function consumerRegistry(app, captured) {
   return app ? {
     component(name, comp) {
@@ -177,7 +210,7 @@ async function applyPageProviders(comp, captured) {
   const providers = await resolvePageProviders(captured.providers);
   return providers && providers.length > 0 ? withPageProviders(comp, providers) : comp;
 }
-function sessionComponent(inner, name, initialApp, initialSession, load, spec, loadingComponent, errorComponent) {
+function sessionComponent(inner, name, initialApp, initialSession, load, spec, loadingComponent, errorComponent, renderErrorComponent) {
   return defineComponent({
     name,
     inheritAttrs: false,
@@ -185,6 +218,8 @@ function sessionComponent(inner, name, initialApp, initialSession, load, spec, l
       const app = getCurrentInstance()?.appContext.app;
       const current = shallowRef();
       const failure = shallowRef();
+      const boundary = remoteRenderBoundary(spec, renderErrorComponent);
+      onErrorCaptured(boundary.onErrorCaptured);
       let session = initialSession;
       let generation = 0;
       let disposed = false;
@@ -196,6 +231,7 @@ function sessionComponent(inner, name, initialApp, initialSession, load, spec, l
         const request = ++generation;
         current.value = void 0;
         failure.value = void 0;
+        boundary.error.value = void 0;
         try {
           const result = await load(app);
           if (disposed || request !== generation) return;
@@ -208,7 +244,10 @@ function sessionComponent(inner, name, initialApp, initialSession, load, spec, l
           session = requestedSession;
           current.value = result;
         } catch (error) {
-          if (!disposed && request === generation) failure.value = error;
+          if (!disposed && request === generation) {
+            reportRemoteObservation({ remote: remoteNameOf(spec), error });
+            failure.value = error;
+          }
         } finally {
           pending = false;
         }
@@ -226,7 +265,13 @@ function sessionComponent(inner, name, initialApp, initialSession, load, spec, l
         generation++;
       });
       const ErrorView = createRecoverableErrorPlaceholder(() => load(app), spec, errorComponent);
-      return () => current.value ? h(current.value, { ...attrs, key: generation }, slots) : failure.value ? h(ErrorView, { ...attrs, error: failure.value }, slots) : loadingComponent ? h(loadingComponent) : null;
+      return () => {
+        if (boundary.view && boundary.error.value !== void 0) {
+          return h(boundary.view, { error: boundary.error.value, retry: boundary.retry });
+        }
+        const c = current.value;
+        return c ? h(c, { ...attrs, key: `${generation}-${boundary.epoch.value}` }, slots) : failure.value ? h(ErrorView, { ...attrs, error: failure.value }, slots) : loadingComponent ? h(loadingComponent) : null;
+      };
     }
   });
 }
@@ -239,9 +284,16 @@ function createRemoteComponent(loadRemote) {
         consumerApp: consumerRegistry(app, captured)
       }).then(async (m) => {
         const inner = m?.default ?? m;
-        if (!isVueRenderableComponent(inner)) throw noRenderableExportError(spec, inner);
+        if (!isVueRenderableComponent(inner)) {
+          const err = noRenderableExportError(spec, inner);
+          reportRemoteObservation({ remote: remoteNameOf(spec), error: err });
+          throw err;
+        }
         const identity = vueRuntimeIdentityError(spec);
-        if (identity) throw identity;
+        if (identity) {
+          reportRemoteObservation({ remote: remoteNameOf(spec), error: identity });
+          throw identity;
+        }
         return applyPageProviders(inner, captured);
       });
     };
@@ -251,7 +303,7 @@ function createRemoteComponent(loadRemote) {
       initialApp = app;
       const session = readSessionKey();
       const inner = await load(app);
-      return sessionComponent(inner, inner?.name, app, session, load, spec, opts.loadingComponent, opts.errorComponent);
+      return sessionComponent(inner, inner?.name, app, session, load, spec, opts.loadingComponent, opts.errorComponent, opts.renderErrorComponent);
     };
     return defineAsyncComponent({
       loader,
@@ -263,7 +315,7 @@ function createRemoteComponent(loadRemote) {
   };
 }
 function createHostPages(options, load) {
-  const { beforeLoad, loadingComponent, errorComponent, delay } = options;
+  const { beforeLoad, loadingComponent, errorComponent, renderErrorComponent, delay } = options;
   const core = createHostPagesCore(options);
   let cacheSession;
   const compCache = /* @__PURE__ */ new Map();
@@ -283,10 +335,15 @@ function createHostPages(options, load) {
         const mod = await load(spec, { consumerApp: consumerRegistry(app, captured) });
         let inner = mod?.default ?? mod;
         if (!isVueRenderableComponent(inner)) {
-          throw noRenderableExportError(spec, inner);
+          const err = noRenderableExportError(spec, inner);
+          reportRemoteObservation({ remote: remoteNameOf(spec), error: err });
+          throw err;
         }
         const identity = vueRuntimeIdentityError(spec);
-        if (identity) throw identity;
+        if (identity) {
+          reportRemoteObservation({ remote: remoteNameOf(spec), error: identity });
+          throw identity;
+        }
         if (keepAlivePage && inner && typeof inner === "object") {
           inner = Object.defineProperties({ ...inner }, { name: { value: name, configurable: true } });
         }
@@ -298,7 +355,7 @@ function createHostPages(options, load) {
         initialApp = app;
         const session = readSessionKey();
         const inner = await loadPage(app);
-        return sessionComponent(inner, keepAlivePage ? name : inner.name, app, session, loadPage, spec, loadingComponent, errorComponent);
+        return sessionComponent(inner, keepAlivePage ? name : inner.name, app, session, loadPage, spec, loadingComponent, errorComponent, renderErrorComponent);
       };
       const asyncComp = defineAsyncComponent({
         loader: pageLoader,

package/dist/vue.d.ts

@@ -519,6 +519,11 @@ declare function createRuntime(): {
         module: string;
     };
     clearSessionState: () => void;
+    /** 适配器边界的观测上报入口（P03）：与运行时内部 emitError 同一通路、hook 与全页去重 */
+    reportRemoteError: (info: {
+        remote: string;
+        error: unknown;
+    }) => void;
 };
 type FgRuntime = ReturnType<typeof createRuntime>;
 /** 插件版本（与 package.json 同步维护于 src/version.ts，测试拦截漂移；用于跨源副本一致性诊断） */
@@ -563,6 +568,14 @@ declare function unwrapDefault(ns: any): any;
 interface RemoteComponentOptions {
     loadingComponent?: Component;
     errorComponent?: Component;
+    /**
+     * 远程组件子树渲染错误占位（P01 可选接线）：提供后，本组件边界接管远程组件内部
+     * setup/render/嵌套异步组件的渲染错误——停止该错误向全局继续传播（本边界已消费），
+     * 渲染此组件（props：error 原始异常 + retry 重新挂载远程组件）。
+     * 未提供时仅观测上报（fulgurjs:error，错误码 MFU-020，原始异常保留在 cause），
+     * 不改变错误传播语义——业务 errorHandler / onErrorCaptured 行为与接入前完全一致。
+     */
+    renderErrorComponent?: Component;
     retries?: number;
     delay?: number;
     timeout?: number;
@@ -579,8 +592,10 @@ interface HostPagesOptions extends HostPagesCoreOptions {
     beforeLoad?: () => void | Promise<void>;
     /** 加载期占位组件（骨架屏） */
     loadingComponent?: Component;
-    /** 错误占位组件（缺省 = 内置错误占位：错误码+根因+修法+重试加载/刷新页面重试；自定义时完全接管） */
+    /** 错误占位（缺省 = 内置错误占位：错误码+根因+修法+重试加载/刷新页面重试；自定义时完全接管） */
     errorComponent?: Component;
+    /** 远程页面子树渲染错误占位（可选接管：提供后本边界消费渲染错误并展示 error/retry；缺省仅观测上报） */
+    renderErrorComponent?: Component;
     /** 骨架屏延迟 ms（默认 200，防闪） */
     delay?: number;
 }

package/docs/en/reference/errors.md

@@ -73,6 +73,7 @@
 | `MFU-014` | Runtime reports a recursive loadRemote of the same remote inside setup/onSession's synchronous segment | Loading a module of the same remote inside the initialization's synchronous segment — the call waits on itself, deadlocking | Do not load same-remote modules inside initialization; put cross-remote loads in the async segment |
 | `MFU-018` | remoteComponent / host-pages component consumption reports "the export is not a renderable component" (with the actual export shape) | The exposes target exports a plain module/constant/non-renderable object — a successful module load does not mean a usable component | Point exposes at an `export default` component (Vue: defineComponent / `<script setup>` / functional; React: function component or memo/forwardRef); to consume a plain module use `loadRemote` instead |
 | `MFU-019` | Vue component direct rendering reports "the renderer and the Vue instance converged in the share scope are not the same instance" (with renderer/shared instance versions) | Proven instance split: at least one side declared shared.vue, but the consumer's vue import did not converge onto the same instance (shared.vue not declared, dev prebundling bypassing the facade, or mismatched shareScope). With split instances inject/Pinia/getCurrentInstance break across instances — typically "shell renders, inner blank, no pageerror" | Both sides declare vue in `shared` (singleton recommended) with the same shareScope; in dev verify vue was not prebundled into a second copy; full sub apps that need an independent Vue runtime must use app bridging instead of remoteComponent direct rendering. Verify via `window.__FULGURJS_SCOPE__.default.vue` |
+| `MFU-020` | The remote component subtree threw internally (its own setup/render/nested async components, including cases the region goes blank after a business errorHandler takes over) | The error originates from the remote component's own code, unrelated to federation module loading. Reported observably via `fulgurjs:error`/`onRemoteError`: the original exception is preserved in `cause`, `details.phase='render'` plus Vue's render-stage info (e.g. setup function / render function / async component loader) | Inspect the original stack on `cause` to locate the failing remote component code. To display and recover in place, pass `renderErrorComponent` to `remoteComponent`/`createHostPages` (it receives `error`/`retry` props, owns the display so the error stops propagating globally, and retry remounts the remote component); by default only observation reporting happens and business errorHandler behavior is unchanged |
 | `MFU-015` | Runtime reports an illegal bridge contract (the `./bridge` default export lacks mount/unmount or they are not functions) | The module exposed as `./bridge` was not built with `defineBridgeApp` | Build the child app entry's default export with `defineBridgeApp(...)` (see [sub app bridge](../guide/app-bridge.md)) |
 | `MFU-016` | Runtime reports bridge preparation or lifecycle failure (`details.phase` distinguishes getContext/mount/unmount; the root cause carries the child app's original error) | getContext returned a Promise/non-object, mount threw before the first commit, or unmount cleanup threw | Troubleshoot the child app code by phase: getContext must return a synchronous snapshot object; on mount failure clean up the app/root before throwing; fix unmount's cleanup logic — a container whose unmount threw is persistently locked out; recover with a full page refresh |
 | `MFU-017` | Runtime reports bridge session parameters inconsistent with AppContext | The controlled `sessionKey` contradicts the global session (a getContext snapshot mismatch), an illegal value (empty string/number), or a page-level single-session conflict (generations mismatch across instances) | Unify the session across the page's controlled bridge instances; sessionKey takes only non-empty string/null/omitted; on generation switch follow "first null to unmount, clearAppContext, then write the new generation" |

package/docs/zh/reference/errors.md

@@ -72,6 +72,7 @@
 | `MFU-014` | 运行时报 setup/onSession 同步段内递归 loadRemote 同一远程 | 初始化同步段内加载同远程模块——该调用会等待自身形成死锁 | 初始化内不要加载同远程模块；跨远程加载放异步段 |
 | `MFU-018` | remoteComponent/宿主页面组件消费时报「导出的不是可渲染组件」（附实际导出形态） | 该 exposes 指向的文件导出了普通模块/常量/不可渲染对象——模块加载成功不等于组件可用 | exposes 指向 `export default` 组件（Vue：defineComponent/`<script setup>`/函数式；React：函数组件或 memo/forwardRef）；消费普通模块改用 `loadRemote` |
 | `MFU-019` | Vue 组件直渲染时报「渲染器与共享作用域收敛的 Vue 实例不一致」（附渲染链/共享实例双版本） | 已证实的实例分裂：至少一方声明 shared.vue，但消费方 vue 导入未收敛到同一实例（未声明 shared.vue、dev 预构建绕过门面、shareScope 不一致）。实例分裂时 inject/Pinia/getCurrentInstance 跨实例断链，常见「外壳在、内部空白且无 pageerror」 | 两侧 `shared` 均声明 vue（建议 singleton）且 shareScope 一致；dev 核对未把 vue 预构建成第二份；需独立 Vue 运行时的完整子应用改用应用桥接，不要 remoteComponent 直渲染。核实：`window.__FULGURJS_SCOPE__.default.vue` |
+| `MFU-020` | 远程组件子树内部抛错（其 setup/render/嵌套异步组件；含错误被业务 errorHandler 接管后区域空白的场景） | 错误抛自远程组件代码本身，与联邦模块加载无关。经 `fulgurjs:error`/`onRemoteError` 观测上报：原始异常保留在 `cause`，`details.phase='render'` 并附 Vue 渲染阶段串（如 setup function / render function / async component loader） | 查看 `cause` 的原始调用栈定位远程组件内部代码。需要在该组件位置直接展示并提供恢复时，为 `remoteComponent`/`createHostPages` 传 `renderErrorComponent`（收到 `error`/`retry` props，接管展示后错误不再向全局传播，retry 重新挂载远程组件）；默认仅观测上报，不改变业务 errorHandler 行为 |
 | `MFU-015` | 运行时报桥接契约非法（`./bridge` 默认导出缺 mount/unmount 或非函数） | expose `./bridge` 的模块没有用 `defineBridgeApp` 构造契约对象 | 子应用入口改用 `defineBridgeApp(...)` 默认导出（见[子应用桥接](../guide/app-bridge.md)） |
 | `MFU-016` | 运行时报桥接准备或生命周期失败（`details.phase` 区分 getContext/mount/unmount；根因含子应用原始错误） | getContext 返回 Promise/非对象、mount 首次提交前抛错、或 unmount 清理抛错 | 按 phase 排查子应用代码：getContext 返回同步快照对象；mount 失败先清理 app/root 再抛；unmount 修复清理逻辑——unmount 抛错的容器被持久封锁，整页刷新恢复 |
 | `MFU-017` | 运行时报桥接会话参数与 AppContext 不一致 | 受控 `sessionKey` 与全局会话矛盾（getContext 快照不一致）、非法值（空串/数字）、或页面级单会话冲突（多实例代次不一致） | 同页受控桥接实例统一会话；sessionKey 只用 非空字符串/null/省略 三态；换代按「先 null 卸载、clearAppContext、再写新代次」顺序 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "6.12.12",
+  "version": "6.13.0",
   "type": "module",
   "description": "Vite Module Federation for Vue and React: remote modules, shared dependencies and app bridges.",
   "license": "MIT",