@fulgurjs/federation 5.2.5 → 5.3.1

package/dist/bridge-host-vue-BAxDKqGH.d.ts

@@ -0,0 +1,32 @@
+import { Component } from 'vue';
+import { A as AppContext } from './bridge-core-6uLJiMVa.js';
+
+/**
+ * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
+ *
+ * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
+ * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
+ * - DOM 所有权（§4.5）：只创建并保持稳定的空挂载 el（多根 fragment 的固定子节点）；
+ *   pending/error 占位是它的兄弟节点，宿主重渲染不 patch 子应用 root 内部；
+ * - 会话代次（§4.3）：受控 sessionKey 驱动 挂载/换会话/登出；同会话重渲染不重挂；
+ * - 错误诊断：契约非法 MFU-015、生命周期失败 MFU-016（phase 区分）、会话矛盾 MFU-017；
+ *   默认占位含「重试加载 / 刷新页面重试」两条恢复操作（§4.4）。
+ *
+ * appProps 是挂载时浅拷贝快照（顶层替换不追踪、不重渲染子应用，重挂由 :key 重建）；
+ * sessionKey 是桥接控制参数，不混入业务 props。
+ */
+
+interface VueBridgeAppOptions {
+    /** 加载 pending 占位组件（默认无占位节点） */
+    loadingComponent?: Component;
+    /** 加载/挂载失败占位（完全接管，契约不变：只接收 error prop；默认内置中文诊断 + 两条恢复操作） */
+    errorComponent?: Component;
+    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
+    retries?: number;
+    /** 本次桥接加载等待上限 ms；不取消已发出的共享请求，迟到结果一律丢弃 */
+    timeout?: number;
+    /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
+    getContext?: () => Partial<AppContext> & Record<string, unknown>;
+}
+
+export type { VueBridgeAppOptions as V };

package/dist/bridge-host-vue.cjs

@@ -0,0 +1,437 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/bridge-host-vue.ts
+var bridge_host_vue_exports = {};
+__export(bridge_host_vue_exports, {
+  createVueBridgeAppWithLoader: () => createVueBridgeAppWithLoader
+});
+module.exports = __toCommonJS(bridge_host_vue_exports);
+var import_vue = require("vue");
+
+// 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/context.ts
+var ContextErrorCodes = {
+  /** context 必需字段缺失（三段式，修法指向宿主桥） */
+  CONTEXT_MISSING_KEY: "CC-001",
+  /** 运行时单例不可用（独立直开远程页，修法=经宿主联邦加载） */
+  CONTEXT_NO_RUNTIME: "CC-002"
+};
+var APP_CONTEXT_STORAGE_KEY = "__FULGURJS_APP_CONFIG__";
+function requireRuntime() {
+  const rt = globalThis.__FULGURJS_RUNTIME__;
+  if (!rt || typeof rt.loadRemote !== "function") {
+    throw new FgError(
+      ContextErrorCodes.CONTEXT_NO_RUNTIME,
+      "\u73B0\u8C61\uFF1A\u5F53\u524D\u9875\u9762\u627E\u4E0D\u5230 fulgurjs \u8FD0\u884C\u65F6\u5355\u4F8B\uFF08globalThis.__FULGURJS_RUNTIME__ \u672A\u5B9A\u4E49\uFF09\u3002\n  \u6839\u56E0: \u5F53\u524D\u9875\u9762\u6CA1\u6709\u7ECF\u5BBF\u4E3B\u7684\u8054\u90A6\u8FD0\u884C\u65F6\u52A0\u8F7D\uFF08\u72EC\u7ACB\u76F4\u5F00\u8FDC\u7A0B\u9875\uFF0C\u6216\u5BBF\u4E3B\u6865\u665A\u4E8E\u672C\u8C03\u7528\u6267\u884C\uFF09\u3002\n  \u4FEE\u6CD5: \u2460 \u4ECE\u5BBF\u4E3B\u5E94\u7528\u7684\u8054\u90A6\u8DEF\u7531\u6253\u5F00\u672C\u9875\u9762\uFF08\u5BBF\u4E3B\u6865\u4F1A\u5148\u52A0\u8F7D\u8FD0\u884C\u65F6\u5E76\u63D0\u4F9B context\uFF09\uFF1B\n        \u2461 \u82E5\u4F60\u662F\u5BBF\u4E3B\u6865\u4F5C\u8005\uFF1A\u628A provideAppContext \u653E\u5728\u6865\u521D\u59CB\u5316\u5C3E\u90E8\uFF08\u65F6\u5E8F\u5951\u7EA6 bridge \u2192 \u8FDC\u7A0B setup \u2192 \u9875\u9762\u6A21\u5757\uFF09\u3002",
+      { runtime: false }
+    );
+  }
+  return rt;
+}
+function provideAppContext(config) {
+  requireRuntime();
+  const g = globalThis;
+  g[APP_CONTEXT_STORAGE_KEY] = { ...g[APP_CONTEXT_STORAGE_KEY] ?? {}, ...config };
+}
+function clearAppContext() {
+  const g = globalThis;
+  delete g[APP_CONTEXT_STORAGE_KEY];
+  try {
+    g.__FULGURJS_RUNTIME__?.clearSessionState?.();
+  } catch {
+  }
+}
+
+// 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"
+};
+function invalidBridgeContractError(spec, mod) {
+  const actual = mod === null ? "null" : typeof mod;
+  const missing = [];
+  if (typeof mod?.mount !== "function") missing.push("mount");
+  if (typeof mod?.unmount !== "function") missing.push("unmount");
+  return new FgError(
+    BridgeErrorCodes.BRIDGE_INVALID_CONTRACT,
+    `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u6A21\u5757 "${spec}" \u7684\u9ED8\u8BA4\u5BFC\u51FA\u4E0D\u662F\u5408\u6CD5\u7684\u6865\u63A5\u5951\u7EA6\uFF08BridgeApp\uFF09\u3002
+  \u6839\u56E0: \u5BFC\u51FA\u503C\u4E3A ${actual}` + (missing.length ? `\uFF0C\u7F3A\u5C11\u51FD\u6570\u7C7B\u578B\u7684 ${missing.map((m) => `"${m}"`).join(" / ")} \u5BFC\u51FA\u3002` : "\u3002") + `
+  \u4FEE\u6CD5: \u8FDC\u7A0B\u4FA7\u7528 defineBridgeApp(...) \u521B\u5EFA\u5951\u7EA6\u5E76\u4F5C\u4E3A\u6A21\u5757\u9ED8\u8BA4\u5BFC\u51FA\u2014\u2014
+        Vue \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/runtime'\uFF1B
+        React \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/react'\u3002
+        \u5951\u7EA6\u5FC5\u987B\u5305\u542B mount(el, props?) \u4E0E unmount(el) \u4E24\u4E2A\u51FD\u6570\u3002`,
+    { spec, missing, actual }
+  );
+}
+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 }
+  );
+}
+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(
+    BridgeErrorCodes.BRIDGE_SESSION_MISMATCH,
+    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684\u53D7\u63A7 sessionKey\uFF08"${controlled}"\uFF09\u4E0E\u5F53\u524D\u4F1A\u8BDD\u4E0D\u4E00\u81F4\uFF08\u5F53\u524D ${actualText}\uFF09\u3002
+  \u6839\u56E0: AppContext \u662F\u9875\u9762\u7EA7\u5355\u4F8B\uFF0C\u540C\u9875\u6240\u6709\u6865\u63A5\u5B9E\u4F8B\u5FC5\u987B\u4F7F\u7528\u540C\u4E00\u767B\u5F55\u4EE3\u6B21\uFF1B
+        getContext \u5FEB\u7167\u7684 sessionKey\uFF08\u6216\u73B0\u6709 AppContext \u7684 sessionKey\uFF09\u4E0E\u53D7\u63A7\u503C\u4E0D\u540C\u3002
+  \u4FEE\u6CD5: \u2460 \u6362\u8D26\u53F7\u65F6\u5148\u8BA9\u53D7\u63A7 prop \u7F6E null \u5E76\u7B49\u5F85\u5378\u8F7D\uFF0C\u518D clearAppContext() \u6E05\u65E7\u8D26\u53F7\u3001
+        \u51C6\u5907\u65B0\u8D26\u53F7\u5B8C\u6574\u5FEB\u7167\u540E\u66F4\u65B0\u53D7\u63A7 prop\uFF1B
+        \u2461 \u65E0 getContext \u65F6\uFF0C\u5148\u7531\u5BBF\u4E3B\u6865 provideAppContext({...\u65B0\u4F1A\u8BDD, sessionKey}) \u518D\u6302\u8F7D\uFF1B
+        \u2462 \u540C\u9875\u4E0D\u8981\u540C\u65F6\u6302\u8F7D\u4E0D\u540C\u8D26\u53F7\u7684\u6865\u63A5\u5B9E\u4F8B\uFF08\u9875\u9762\u7EA7\u5355\u4F1A\u8BDD\u7EA6\u675F\uFF09\u3002`,
+    { spec, controlled, actual: String(actual), ...extra }
+  );
+}
+function invalidSessionKeyError(spec, value) {
+  return new FgError(
+    BridgeErrorCodes.BRIDGE_SESSION_MISMATCH,
+    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u6536\u5230\u975E\u6CD5\u7684\u53D7\u63A7 sessionKey\uFF1A${typeof value === "string" ? '\u7A7A\u5B57\u7B26\u4E32 ""' : `${typeof value}\uFF08${String(value)}\uFF09`}\u3002
+  \u6839\u56E0: sessionKey \u53EA\u63A5\u53D7 undefined\uFF08\u4E0D\u542F\u7528\u53D7\u63A7\u4F1A\u8BDD\uFF09\u3001null\uFF08\u767B\u51FA\u6001\uFF09\u6216\u975E\u7A7A\u5B57\u7B26\u4E32\uFF08\u767B\u5F55\u4EE3\u6B21 ID\uFF09\u3002
+  \u4FEE\u6CD5: \u767B\u51FA\u4F20 null \u800C\u4E0D\u662F\u7A7A\u5B57\u7B26\u4E32\uFF1B\u767B\u5F55\u4EE3\u6B21\u7528\u975E\u7A7A\u5B57\u7B26\u4E32\uFF1B\u4E0D\u8981\u4F20\u6570\u5B57/\u5E03\u5C14\u7B49\u5176\u4ED6\u7C7B\u578B\u3002`,
+    { spec, value: String(value) }
+  );
+}
+
+// src/bridge-core.ts
+function assertBridgeContract(spec, mod) {
+  const contract = mod?.default ?? mod;
+  if (contract === null || typeof contract !== "object" || typeof contract.mount !== "function" || typeof contract.unmount !== "function") {
+    throw invalidBridgeContractError(spec, mod);
+  }
+  return contract;
+}
+var activeBridgeSessions = /* @__PURE__ */ new Map();
+function acquireBridgeSession(spec, sessionKey) {
+  for (const [active] of activeBridgeSessions) {
+    if (active !== sessionKey && (activeBridgeSessions.get(active) ?? 0) > 0) {
+      throw bridgeSessionMismatchError(spec, sessionKey, active, { reason: "active-instance" });
+    }
+  }
+  activeBridgeSessions.set(sessionKey, (activeBridgeSessions.get(sessionKey) ?? 0) + 1);
+}
+function releaseBridgeSession(sessionKey) {
+  const n = activeBridgeSessions.get(sessionKey) ?? 0;
+  if (n <= 1) activeBridgeSessions.delete(sessionKey);
+  else activeBridgeSessions.set(sessionKey, n - 1);
+}
+function resolveBridgeContext(spec, controlled, getContext) {
+  if (getContext) {
+    let snapshot;
+    try {
+      snapshot = getContext();
+    } catch (e) {
+      throw bridgeLifecycleError("getContext", spec, e);
+    }
+    if (snapshot === null || typeof snapshot !== "object" || typeof snapshot.then === "function") {
+      throw bridgeLifecycleError("getContext", spec, describeContextValue(snapshot));
+    }
+    if (controlled !== void 0 && snapshot.sessionKey !== controlled) {
+      throw bridgeSessionMismatchError(spec, controlled, snapshot.sessionKey, { reason: "getter-snapshot" });
+    }
+    const current = currentSessionKey();
+    if (snapshot.sessionKey !== void 0 && snapshot.sessionKey !== current) {
+      clearAppContext();
+    }
+    return { provide: snapshot };
+  }
+  if (controlled !== void 0) {
+    const current = currentSessionKey();
+    if (current !== controlled) {
+      throw bridgeSessionMismatchError(spec, controlled, current, { reason: "app-context" });
+    }
+  }
+  return {};
+}
+function currentSessionKey() {
+  const sk = (globalThis.__FULGURJS_APP_CONFIG__ ?? {}).sessionKey;
+  return typeof sk === "string" && sk !== "" ? sk : void 0;
+}
+function describeContextValue(snapshot) {
+  if (snapshot === null) {
+    return "getContext \u8FD4\u56DE\u4E86 null\u3002\u5B83\u5FC5\u987B\u662F\u540C\u6B65\u8FD4\u56DE\u5FEB\u7167\u5BF9\u8C61\u7684\u7EAF getter\uFF1A\u8FD4\u56DE\u503C\u5E94\u4E3A\u5305\u542B\u672C\u6B21\u4F1A\u8BDD\u5FEB\u7167\u7684\u5BF9\u8C61\uFF08\u53D7\u63A7 sessionKey \u65F6\u987B\u542B\u76F8\u540C sessionKey\uFF09\uFF0C\u4E0D\u80FD\u8FD4\u56DE null\u3002";
+  }
+  if (snapshot === void 0) {
+    return "getContext \u8FD4\u56DE\u4E86 undefined\u3002\u5B83\u5FC5\u987B\u662F\u540C\u6B65\u8FD4\u56DE\u5FEB\u7167\u5BF9\u8C61\u7684\u7EAF getter\uFF1A\u8FD4\u56DE\u503C\u5E94\u4E3A\u5305\u542B\u672C\u6B21\u4F1A\u8BDD\u5FEB\u7167\u7684\u5BF9\u8C61\uFF0C\u8BF7\u68C0\u67E5 getter \u662F\u5426\u6F0F\u5199 return \u6216\u8FD4\u56DE\u4E86\u672A\u521D\u59CB\u5316\u7684\u53D8\u91CF\u3002";
+  }
+  if (typeof snapshot.then === "function") {
+    return "getContext \u8FD4\u56DE\u4E86 Promise/thenable\u3002\u5B83\u5FC5\u987B\u662F\u540C\u6B65 getter\uFF0C\u4E0D\u5F97\u8FD4\u56DE Promise\uFF1A\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";
+  }
+  return `getContext \u8FD4\u56DE\u4E86\u975E\u5BF9\u8C61\u503C\uFF08${typeof snapshot}\uFF1A"${String(snapshot)}"\uFF09\u3002\u5B83\u5FC5\u987B\u662F\u540C\u6B65\u8FD4\u56DE\u5FEB\u7167\u5BF9\u8C61\u7684\u7EAF getter\uFF0C\u8FD4\u56DE\u503C\u5E94\u4E3A\u5BF9\u8C61\u800C\u4E0D\u662F\u539F\u59CB\u503C\u3002`;
+}
+function assertControlledSessionKey(spec, value) {
+  if (value === void 0 || value === null) return;
+  if (typeof value === "string" && value !== "") return;
+  throw invalidSessionKeyError(spec, value);
+}
+function assertBridgeOptions(source, opts) {
+  if (opts.retries !== void 0 && (typeof opts.retries !== "number" || !Number.isInteger(opts.retries) || opts.retries < 0 || opts.retries > 10)) {
+    throw new Error(
+      `[fulgurjs] ${source} \u7684 retries \u914D\u7F6E\u65E0\u6548\uFF1A\u5F53\u524D\u4E3A ${String(opts.retries)}\uFF0C\u5E94\u4E3A 0 \u5230 10 \u7684\u6574\u6570\u3002\u8BF7\u4FEE\u6B63\u9009\u9879\u3002`
+    );
+  }
+  if (opts.timeout !== void 0 && (typeof opts.timeout !== "number" || !Number.isFinite(opts.timeout) || opts.timeout <= 0)) {
+    throw new Error(
+      `[fulgurjs] ${source} \u7684 timeout \u914D\u7F6E\u65E0\u6548\uFF1A\u5F53\u524D\u4E3A ${String(opts.timeout)}\uFF0C\u5E94\u4E3A\u5927\u4E8E 0 \u7684\u6709\u9650\u6BEB\u79D2\u6570\u3002\u8BF7\u4FEE\u6B63\u9009\u9879\u3002`
+    );
+  }
+}
+function withBridgeTimeout(p, ms, spec) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      reject(new Error(
+        `[fulgurjs] \u6865\u63A5\u5E94\u7528 "${spec}" \u52A0\u8F7D\u7B49\u5F85\u8D85\u8FC7 ${ms} \u6BEB\u79D2\uFF08\u9002\u914D\u5C42 timeout\uFF09\u3002\u8BE5\u8D85\u65F6\u53EA\u7ED3\u675F\u672C\u6B21\u7B49\u5F85\uFF0C\u4E0D\u53D6\u6D88\u5DF2\u53D1\u51FA\u7684\u5171\u4EAB\u8BF7\u6C42\uFF1B\u53EF\u70B9\u51FB\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u5EFA\u7ACB\u65B0\u7684\u5C1D\u8BD5\u3002`
+      ));
+    }, ms);
+    p.then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(timer);
+        reject(e);
+      }
+    );
+  });
+}
+
+// src/bridge-host-vue.ts
+var ERROR_STYLE = {
+  padding: "16px",
+  border: "1px solid #fde2e2",
+  borderRadius: "4px",
+  background: "#fef0f0",
+  color: "#c45656",
+  fontSize: "13px",
+  lineHeight: "1.6"
+};
+var BUTTON_STYLE = {
+  padding: "4px 14px",
+  marginRight: "8px",
+  border: "1px solid #c45656",
+  borderRadius: "4px",
+  background: "#c45656",
+  color: "#fff",
+  fontSize: "13px",
+  cursor: "pointer"
+};
+var SECONDARY_BUTTON_STYLE = {
+  padding: "4px 14px",
+  border: "1px solid #c45656",
+  borderRadius: "4px",
+  background: "#fff",
+  color: "#c45656",
+  fontSize: "13px",
+  cursor: "pointer"
+};
+var BridgeErrorPlaceholder = (0, import_vue.defineComponent)({
+  name: "FulgurjsBridgeError",
+  props: {
+    error: { type: Object, default: void 0 },
+    retry: { type: Function, required: false, default: void 0 }
+  },
+  setup(props) {
+    const reloadPage = () => {
+      window.location.reload();
+    };
+    return () => {
+      const err = props.error;
+      const code = err?.code ?? "UNKNOWN";
+      const message = err?.message ?? String(props.error ?? "unknown error");
+      return (0, import_vue.h)("div", { style: ERROR_STYLE, "data-fulgurjs-error": code }, [
+        (0, import_vue.h)("p", { style: "margin:0 0 4px;font-weight:600" }, `\u6865\u63A5\u5E94\u7528\u52A0\u8F7D\u5931\u8D25\uFF08\u9519\u8BEF\u7801 ${code}\uFF09`),
+        (0, import_vue.h)("p", { style: "margin:0 0 8px;word-break:break-all" }, message),
+        (0, import_vue.h)("p", { style: "margin:0 0 10px" }, "\u300C\u91CD\u8BD5\u52A0\u8F7D\u300D\u5728\u5F53\u524D\u9875\u9762\u91CD\u5EFA\u6302\u8F7D\uFF1B\u82E5\u6D4F\u89C8\u5668\u5DF2\u7F13\u5B58\u5931\u8D25\u7684\u6A21\u5757\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"),
+        (0, import_vue.h)("div", { style: "margin:0" }, [
+          props.retry ? (0, import_vue.h)("button", {
+            key: "retry",
+            style: BUTTON_STYLE,
+            type: "button",
+            "data-fulgurjs-retry": "",
+            onClick: () => props.retry?.()
+          }, "\u91CD\u8BD5\u52A0\u8F7D") : null,
+          (0, import_vue.h)("button", {
+            key: "reload",
+            style: SECONDARY_BUTTON_STYLE,
+            type: "button",
+            "data-fulgurjs-reload": "",
+            onClick: reloadPage
+          }, "\u5237\u65B0\u9875\u9762\u91CD\u8BD5")
+        ])
+      ]);
+    };
+  }
+});
+function createVueBridgeAppWithLoader(loadRemote) {
+  return function createVueBridgeApp(spec, options = {}) {
+    assertBridgeOptions(`createVueBridgeApp("${spec}")`, options);
+    const componentName = "FulgurjsBridge_" + spec.replace(/[^A-Za-z0-9_-]/g, "_");
+    return (0, import_vue.defineComponent)({
+      name: componentName,
+      // 多根组件：宿主传入的 class/style 等不自动继承（v1 不提供样式透传，外观由宿主外层元素控制）
+      inheritAttrs: false,
+      props: {
+        appProps: { type: Object, required: false, default: void 0 },
+        // 桥接控制参数：undefined（不启用受控会话）/ null（登出态）/ 非空字符串（登录代次）
+        sessionKey: { type: null, required: false, default: void 0 }
+      },
+      setup(props) {
+        const status = (0, import_vue.ref)("idle");
+        const error = (0, import_vue.shallowRef)(void 0);
+        const container = (0, import_vue.ref)(null);
+        let generation = 0;
+        let contract;
+        let containerBlocked = false;
+        let acquiredSession;
+        const releaseAcquired = () => {
+          if (acquiredSession !== void 0) {
+            releaseBridgeSession(acquiredSession);
+            acquiredSession = void 0;
+          }
+        };
+        const invalidate = () => {
+          if (containerBlocked) return false;
+          generation++;
+          const el = container.value;
+          releaseAcquired();
+          if (contract && el) {
+            const c = contract;
+            contract = void 0;
+            try {
+              c.unmount(el);
+            } catch (e) {
+              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(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;
+              status.value = "error";
+              return false;
+            }
+          }
+          return true;
+        };
+        const run = async (myGeneration) => {
+          const el = container.value;
+          if (!el) return;
+          const sk = props.sessionKey;
+          status.value = "pending";
+          error.value = void 0;
+          if (sk === null) {
+            status.value = "idle";
+            return;
+          }
+          try {
+            assertControlledSessionKey(spec, sk);
+            const controlled = typeof sk === "string" ? sk : void 0;
+            if (controlled !== void 0 && controlled !== acquiredSession) {
+              releaseAcquired();
+              acquireBridgeSession(spec, controlled);
+              acquiredSession = controlled;
+            }
+            const resolution = resolveBridgeContext(spec, controlled, options.getContext);
+            if (resolution.provide) provideAppContext(resolution.provide);
+            const load = loadRemote(spec, { retries: options.retries });
+            const mod = options.timeout !== void 0 ? await withBridgeTimeout(load, options.timeout, spec) : await load;
+            if (myGeneration !== generation) return;
+            contract = assertBridgeContract(spec, mod);
+            const appPropsSource = props.appProps ? (0, import_vue.toRaw)(props.appProps) : void 0;
+            await contract.mount(el, { ...appPropsSource ?? {} });
+            if (myGeneration !== generation) return;
+            status.value = "ready";
+          } catch (e) {
+            if (myGeneration !== generation) return;
+            error.value = e;
+            status.value = "error";
+          }
+        };
+        const start = () => {
+          const ok = invalidate();
+          if (!ok) return;
+          const myGeneration = generation;
+          void run(myGeneration);
+        };
+        const retry = () => {
+          start();
+        };
+        (0, import_vue.onMounted)(() => {
+          const myGeneration = generation;
+          void run(myGeneration);
+        });
+        (0, import_vue.watch)(() => props.sessionKey, () => {
+          start();
+        });
+        (0, import_vue.onBeforeUnmount)(() => {
+          invalidate();
+        });
+        return () => {
+          const children = [];
+          if (status.value === "pending" && options.loadingComponent) {
+            children.push((0, import_vue.h)(options.loadingComponent, { key: "loading" }));
+          }
+          if (status.value === "error") {
+            const err = error.value;
+            if (options.errorComponent) {
+              children.push((0, import_vue.h)(options.errorComponent, { key: "error", error: err }));
+            } else {
+              children.push((0, import_vue.h)(BridgeErrorPlaceholder, { key: "error", error: err, retry: containerBlocked ? void 0 : retry }));
+            }
+          }
+          children.push((0, import_vue.h)("div", {
+            key: "bridge-root",
+            ref: container,
+            "data-fulgurjs-bridge-root": spec,
+            "data-fulgurjs-bridge-status": status.value
+          }));
+          return children;
+        };
+      }
+    });
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createVueBridgeAppWithLoader
+});

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

@@ -0,0 +1,39 @@
+import { Component } from 'vue';
+import { AppContext } from './context.cjs';
+
+/**
+ * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
+ *
+ * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
+ * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
+ * - DOM 所有权（§4.5）：只创建并保持稳定的空挂载 el（多根 fragment 的固定子节点）；
+ *   pending/error 占位是它的兄弟节点，宿主重渲染不 patch 子应用 root 内部；
+ * - 会话代次（§4.3）：受控 sessionKey 驱动 挂载/换会话/登出；同会话重渲染不重挂；
+ * - 错误诊断：契约非法 MFU-015、生命周期失败 MFU-016（phase 区分）、会话矛盾 MFU-017；
+ *   默认占位含「重试加载 / 刷新页面重试」两条恢复操作（§4.4）。
+ *
+ * appProps 是挂载时浅拷贝快照（顶层替换不追踪、不重渲染子应用，重挂由 :key 重建）；
+ * sessionKey 是桥接控制参数，不混入业务 props。
+ */
+
+type LoadRemoteFn = (spec: string, opts?: {
+    retries?: number;
+}) => Promise<any>;
+interface VueBridgeAppOptions {
+    /** 加载 pending 占位组件（默认无占位节点） */
+    loadingComponent?: Component;
+    /** 加载/挂载失败占位（完全接管，契约不变：只接收 error prop；默认内置中文诊断 + 两条恢复操作） */
+    errorComponent?: Component;
+    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
+    retries?: number;
+    /** 本次桥接加载等待上限 ms；不取消已发出的共享请求，迟到结果一律丢弃 */
+    timeout?: number;
+    /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
+    getContext?: () => Partial<AppContext> & Record<string, unknown>;
+}
+/**
+ * 构建 Vue 宿主桥接工厂（dist 壳与 dev 门面绑定各自运行时的 loadRemote 后导出）。
+ */
+declare function createVueBridgeAppWithLoader(loadRemote: LoadRemoteFn): <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => Component;
+
+export { type VueBridgeAppOptions, createVueBridgeAppWithLoader };

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

@@ -0,0 +1,39 @@
+import { Component } from 'vue';
+import { AppContext } from './context.js';
+
+/**
+ * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
+ *
+ * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
+ * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
+ * - DOM 所有权（§4.5）：只创建并保持稳定的空挂载 el（多根 fragment 的固定子节点）；
+ *   pending/error 占位是它的兄弟节点，宿主重渲染不 patch 子应用 root 内部；
+ * - 会话代次（§4.3）：受控 sessionKey 驱动 挂载/换会话/登出；同会话重渲染不重挂；
+ * - 错误诊断：契约非法 MFU-015、生命周期失败 MFU-016（phase 区分）、会话矛盾 MFU-017；
+ *   默认占位含「重试加载 / 刷新页面重试」两条恢复操作（§4.4）。
+ *
+ * appProps 是挂载时浅拷贝快照（顶层替换不追踪、不重渲染子应用，重挂由 :key 重建）；
+ * sessionKey 是桥接控制参数，不混入业务 props。
+ */
+
+type LoadRemoteFn = (spec: string, opts?: {
+    retries?: number;
+}) => Promise<any>;
+interface VueBridgeAppOptions {
+    /** 加载 pending 占位组件（默认无占位节点） */
+    loadingComponent?: Component;
+    /** 加载/挂载失败占位（完全接管，契约不变：只接收 error prop；默认内置中文诊断 + 两条恢复操作） */
+    errorComponent?: Component;
+    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
+    retries?: number;
+    /** 本次桥接加载等待上限 ms；不取消已发出的共享请求，迟到结果一律丢弃 */
+    timeout?: number;
+    /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
+    getContext?: () => Partial<AppContext> & Record<string, unknown>;
+}
+/**
+ * 构建 Vue 宿主桥接工厂（dist 壳与 dev 门面绑定各自运行时的 loadRemote 后导出）。
+ */
+declare function createVueBridgeAppWithLoader(loadRemote: LoadRemoteFn): <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => Component;
+
+export { type VueBridgeAppOptions, createVueBridgeAppWithLoader };