@fulgurjs/federation 5.3.1 → 5.3.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 5.3.3
+
+- **修复：loadShare × pinLoadedShare 并发窗口的单例双实例风险（F9）**——`loadShare` 设置 `entry.loaded` 后等待 `entry.get()` 期间，CJS 垫片的 `pinLoadedShare` 可同步写入本地实例；getter 完成后原实现直接覆盖 `entry.value`，同步 CJS 消费者与异步消费者各持一份实例。现在实行条目实例 first-wins（协商结果让位于先写入的 pin/fallback 实例，loadShare 返回条目当前 value）、条目级 in-flight get（并发 loadShare 共享同一次加载，getter 恰好调用一次）、getter 拒绝后回滚 `entry.loaded`（修复前死条目残留「已加载」标记会永久抢占单例的已加载优先）——失败窗口内已有 pin 时收敛到 pin 实例。8 个确定性回归（可控 Promise 门）覆盖挂起中 pin / pin 先行 / 并发去重 / 拒绝重试与状态恢复 / resolveShare 组合 / 多版本边界；单元 558 → 566。`runtime.js` gzip 9204B ≤ 9216B。
+- **结论修正（Vite 8 与 dev 冷启动）**：Vite 8（rolldown）dev / 生产构建 / 生产页面挂载自本版起均有完整验收证据（双向桥接 11 步交互矩阵 176/176，5.3.2 时期的「生产页面 BLOCKED（上游）」已在独立验收轮定位为插件层四个缺陷并全部修复）。dev 冷启动依赖预构建窗口（DEV-010）如实声明为使用边界：首轮 30~60s 内首开可能出现瞬时 504/请求挂起并由 vite reload 自愈，自动化验收请先按文档预热。
+- 插件分组的 Vite 8 方案（原生 codeSplitting 保护组 + 共享提供/协商/垫片/运行时分层）与共享选择共用、CJS 垫片同步形态、宿主提供闭包不改写等修复随本版一并正式发布（前两轮候选 rc.1/rc.2 的完整门禁见验收报告 §9/§10）。
+
+## 5.3.2
+
+- **修正：回滚 5.3.1 中「宿主入口 init 注入改为 `import "virtual:fulgurjs-init"`」的实验性变更**——该变更本意是修复 vite 8 生产运行死锁（未成功，vite 8 运行期仍单列 rolldown 上游 BLOCKED），但在大型宿主（jeecg 系，vite 6）生产实测存在破坏地图渲染的风险面。5.3.2 恢复 5.3.0 的「init 代码内联入口模块」形态（原始注释「rollup 会摇树剥离独立模块的顶层调用」仍然成立），其余 5.3.1 修复（同步 CJS-NS 垫片 / BN09 容器封锁 / BN08 getContext 诊断 / publisher 守卫）全部保留。单元 540/540、e2e dev 43 + prod 28 复验通过。
+
 ## 5.3.1
 
 - **修复：Vite 8（rolldown）下 React 联邦生产构建 REQUIRE_TLA 失败**——React 生态的本体为 CJS（`react-dom/cjs/*` 内部 `require("react")`），插件的 CJS require 重定向此前把目标指向与共享协商门面同体的垫片（`await loadShare(...)` 顶层 await 形态）；rolldown 按 Node 语义在构建期拒绝「CJS require 含顶层 await 的模块」（vite 5-7 的 rollup 无此限制，属存量兼容缺口，5.2.5 无桥接工程在 vite8 下同样复现）。现在 CJS 垫片改为**同步形态**：运行时新增 `getLoadedShare` 同步查询（loadShare 成功后缓存实例值，已协商加载的实例优先命中，跨端单例语义与 TLA 版 loadShare 对齐），未就绪时直连本应用本体（与 provide/fallback 同一模块，构建期单份 → 实例恒同）。vite 5.1.8/6.4.3/7.3.6/8.3.1 × {vue,react}×{host,remote} 十六个真实工程构建全部通过；`runtime.js` gzip 8812B（门禁 ≤9216B）。**已知边界（如实声明）**：vite 8.3.1 的桥接/React 生产**页面运行**在本轮仍无法通过挂载验收（rolldown 对「TLA 协商门面 × 动态目标透传重定向 × async chunk 强制拆分」的组合行为导致入口求值死锁，插件层六种分组/时序变体均无法完全规避；dev 全功能正常），归因为 rolldown-vite 上游行为，详见验收报告。

package/README.en.md

@@ -48,11 +48,13 @@
 pnpm add -D @fulgurjs/federation
 ```
 
-- Vite ≥ 5.1 (tested through 8.x; Vite 8 uses the rolldown dep-optimizer path automatically)
+- Vite ≥ 5.1 (tested through 8.x)
 - Node ≥ 18
 - Vue ≥ 3.2.0 and/or React `>=18.0.0 <20` — all three are **optional peers**; install only the framework you use
 - Chrome 108+ (native top-level await)
 
+> Vite 8 (rolldown): as of 5.3.3, dev, production builds and production page mounting all pass full acceptance (bidirectional bridge 11-step interaction matrix, see the acceptance report). The first page open on a cold dev cache still falls inside the dependency pre-bundling window (DEV-010; it self-recovers via reload). Warm up before acceptance runs or manual judgement, as documented.
+
 `@fulgurjs/federation/runtime` and `@fulgurjs/federation/react` are **ESM-only** browser entries (no `require()`). The build-time main entry supports both ESM and CJS.
 
 ## 4. Project shape: two files per app

package/README.md

@@ -51,6 +51,8 @@ pnpm add -D @fulgurjs/federation
 
 要求：Vite ≥ 5.1（实测至 8.x）、Node ≥ 18、Vue 3 和/或 React 18–19（均为可选 peer——按所用框架安装）、浏览器 Chrome 108+（TLA 原生支持）。
 
+> Vite 8（rolldown）：5.3.3 起 dev 与生产构建、生产页面挂载均已通过完整验收（双向桥接 11 步交互矩阵，见验收报告）。dev 冷启动首开仍受依赖预构建窗口影响（DEV-010，首轮打开自动恢复），验收与人工判断请按文档先预热。
+
 ## 快速开始（React 应用）
 
 React 宿主与远程使用同一套「每应用两份文件」的配置形态，唯一区别是浏览器导入点：`@fulgurjs/federation/react`（同时提供通用运行时 API 与 React 适配 API，纯 React 项目不需要安装 Vue）。

package/dist/{chunk-MMXKQN2H.js → chunk-GWJKABE7.js}

@@ -8,7 +8,7 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-TOT3P7AK.js";
+} from "./chunk-WD2ON7SN.js";
 
 // src/bridge-host-vue.ts
 import { defineComponent, h, onBeforeUnmount, onMounted, ref, shallowRef, toRaw, watch } from "vue";

package/dist/{chunk-TOT3P7AK.js → chunk-WD2ON7SN.js}

@@ -252,6 +252,14 @@ function createRuntime() {
   const remotes = /* @__PURE__ */ new Map();
   const plugins = [];
   const reportedSingletonSkews = /* @__PURE__ */ new Set();
+  const resolvedShareSnapshots = /* @__PURE__ */ new Map();
+  const shareRequestKey = (name, opts) => JSON.stringify([
+    opts.shareScope || "default",
+    opts.shareKey || name,
+    opts.requiredVersion ?? null,
+    !!opts.singleton,
+    !!opts.strictVersion
+  ]);
   const loadedModules = /* @__PURE__ */ new Map();
   const remoteManifests = /* @__PURE__ */ new Map();
   const stylesheetLoads = /* @__PURE__ */ new WeakMap();
@@ -472,14 +480,16 @@ function createRuntime() {
   }
   function registerPlugins2(list) {
     plugins.push(...list);
+    resolvedShareSnapshots.clear();
     applyPlugins();
   }
-  async function loadShare2(name, opts = {}) {
+  function selectShareEntry(name, opts, readyOnly = false) {
     const scopeName = opts.shareScope || "default";
     const shareKey = opts.shareKey || name;
     const scope = getScope(scopeName);
     const byName = scope[shareKey] || {};
-    const versions = Object.keys(byName);
+    const versions = Object.keys(byName).filter((v) => !readyOnly || opts.singleton || byName[v].value !== void 0);
+    if (readyOnly && versions.length === 0) return void 0;
     const req = opts.requiredVersion;
     const satisfying = versions.filter(
       (v) => req === void 0 || req === false || satisfies(v, req)
@@ -512,49 +522,121 @@ function createRuntime() {
       pick = [...satisfying].sort(compareVersions).pop();
       if (!pick) {
         if (opts.strictVersion) {
-          const err2 = new FgError(
+          const err = new FgError(
             ErrorCodes.SHARE_STRICT_VERSION,
             `\u73B0\u8C61\uFF1A\u5171\u4EAB\u4F5C\u7528\u57DF "${scopeName}" \u4E2D\u627E\u4E0D\u5230\u7B26\u5408\u8981\u6C42\u7684 "${shareKey}"\u3002
 \u539F\u56E0\uFF1A\u8981\u6C42\u7248\u672C ${req}\uFF0C\u5F53\u524D\u53EF\u7528\u7248\u672C\u4E3A ${versions.join("\u3001") || "\u65E0"}\u3002
 \u4FEE\u6CD5\uFF1A\u7EDF\u4E00\u5BBF\u4E3B\u4E0E\u8FDC\u7A0B\u7684\u4F9D\u8D56\u7248\u672C\uFF0C\u6216\u4FEE\u6B63 shared.requiredVersion\u3002`
           );
-          emitError({ remote: shareKey, error: err2 });
-          throw err2;
+          emitError({ remote: shareKey, error: err });
+          throw err;
         }
-        if (opts.fallback) return opts.fallback();
-        const err = new FgError(
-          ErrorCodes.SHARE_NOT_AVAILABLE,
-          `\u73B0\u8C61\uFF1A\u65E0\u6CD5\u52A0\u8F7D\u5171\u4EAB\u4F9D\u8D56 "${shareKey}"\u3002
-\u539F\u56E0\uFF1A\u4F5C\u7528\u57DF "${scopeName}" \u4E2D\u6CA1\u6709\u7B26\u5408 ${req ?? "\u4EFB\u610F\u7248\u672C"} \u8981\u6C42\u7684\u7248\u672C\uFF0C\u4E14\u672A\u914D\u7F6E\u672C\u5730\u526F\u672C\u3002
-\u4FEE\u6CD5\uFF1A\u5728\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u6CE8\u518C\u8BE5\u4F9D\u8D56\uFF0C\u6216\u4E3A shared \u914D\u7F6E\u53EF\u7528\u7684\u672C\u5730\u526F\u672C\u3002`,
-          { shareKey, requiredVersion: req }
-        );
-        emitError({ remote: shareKey, error: err });
-        throw err;
+        return void 0;
+      }
+    }
+    return byName[pick];
+  }
+  function registerFallbackInstance(name, opts, instance) {
+    const localVersion = opts.localVersion;
+    if (!localVersion || instance === void 0) return;
+    const scopeName = opts.shareScope || "default";
+    const key = opts.shareKey || name;
+    const scope = getScope(scopeName);
+    const byName = Object.hasOwn(scope, key) ? scope[key] : void 0;
+    if (byName && Object.keys(byName).length > 0) {
+      try {
+        const pick = selectShareEntry(name, opts);
+        if (pick && pick.value === void 0 && pick.version === localVersion) {
+          pick.value = instance;
+          pick.loaded = true;
+        }
+      } catch {
       }
+      return;
+    }
+    registerShare2(scopeName, key, localVersion, () => Promise.resolve(instance), {
+      from: "fulgurjs:local-fallback",
+      loaded: true
+    });
+    const fresh = scope[key]?.[localVersion];
+    if (fresh) fresh.value = instance;
+  }
+  async function loadShare2(name, opts = {}) {
+    const scopeName = opts.shareScope || "default";
+    const shareKey = opts.shareKey || name;
+    const byName = getScope(scopeName)[shareKey] || {};
+    let entry = selectShareEntry(name, opts);
+    if (!entry) {
+      if (opts.fallback) {
+        const instance2 = await opts.fallback();
+        registerFallbackInstance(name, opts, instance2);
+        return instance2;
+      }
+      const err = new FgError(
+        ErrorCodes.SHARE_NOT_AVAILABLE,
+        `\u73B0\u8C61\uFF1A\u65E0\u6CD5\u52A0\u8F7D\u5171\u4EAB\u4F9D\u8D56 "${shareKey}"\u3002
+\u539F\u56E0\uFF1A\u4F5C\u7528\u57DF "${scopeName}" \u4E2D\u6CA1\u6709\u7B26\u5408 ${opts.requiredVersion ?? "\u4EFB\u610F\u7248\u672C"} \u8981\u6C42\u7684\u7248\u672C\uFF0C\u4E14\u672A\u914D\u7F6E\u672C\u5730\u526F\u672C\u3002
+\u4FEE\u6CD5\uFF1A\u5728\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u6CE8\u518C\u8BE5\u4F9D\u8D56\uFF0C\u6216\u4E3A shared \u914D\u7F6E\u53EF\u7528\u7684\u672C\u5730\u526F\u672C\u3002`,
+        { shareKey, requiredVersion: opts.requiredVersion }
+      );
+      emitError({ remote: shareKey, error: err });
+      throw err;
     }
-    let entry = byName[pick];
     if (hooks.resolveShare) {
       const picked = await hooks.resolveShare({
         shareKey,
         shareScope: scopeName,
-        requiredVersion: req,
+        requiredVersion: opts.requiredVersion,
         picked: entry,
         available: Object.values(byName)
       });
       if (picked) entry = picked;
     }
+    if (entry.value !== void 0) {
+      resolvedShareSnapshots.set(shareRequestKey(name, opts), entry);
+      return entry.value;
+    }
     entry.loaded = true;
-    const instance = await entry.get();
-    entry.value = instance;
-    return instance;
+    if (!entry.pendingGet) {
+      try {
+        entry.pendingGet = entry.get();
+      } catch (e) {
+        entry.pendingGet = Promise.reject(e);
+      }
+    }
+    const pending = entry.pendingGet;
+    let instance;
+    try {
+      instance = await pending;
+    } catch (e) {
+      if (entry.value !== void 0) {
+        resolvedShareSnapshots.set(shareRequestKey(name, opts), entry);
+        return entry.value;
+      }
+      entry.loaded = false;
+      throw e;
+    } finally {
+      if (entry.pendingGet === pending) entry.pendingGet = void 0;
+    }
+    if (entry.value === void 0) entry.value = instance;
+    resolvedShareSnapshots.set(shareRequestKey(name, opts), entry);
+    return entry.value;
   }
   function getLoadedShare2(name, opts = {}) {
-    const shareKey = opts.shareKey || name;
-    const byName = getScope(opts.shareScope || "default")[shareKey] || {};
-    const ready = Object.keys(byName).filter((v) => byName[v].value !== void 0);
-    if (ready.length === 0) return void 0;
-    return byName[ready.sort(compareVersions).pop()].value;
+    if (hooks.resolveShare) return resolvedShareSnapshots.get(shareRequestKey(name, opts))?.value;
+    return selectShareEntry(name, opts, true)?.value;
+  }
+  function pinLoadedShare2(name, opts, localVersion, instance) {
+    if (instance === void 0) return;
+    let entry;
+    try {
+      entry = selectShareEntry(name, opts);
+    } catch {
+      return;
+    }
+    if (!entry || entry.value !== void 0 || entry.version !== localVersion) return;
+    entry.value = instance;
+    entry.loaded = true;
   }
   function sanitizeUrl(u) {
     try {
@@ -986,6 +1068,7 @@ ${hints.join("\n")}`,
     registerPlugins: registerPlugins2,
     loadShare: loadShare2,
     getLoadedShare: getLoadedShare2,
+    pinLoadedShare: pinLoadedShare2,
     loadRemote: loadRemote2,
     getContainer: getContainer2,
     preloadRemote: preloadRemote2,
@@ -1007,6 +1090,7 @@ var registerRemote = runtime.registerRemote;
 var registerPlugins = runtime.registerPlugins;
 var loadShare = runtime.loadShare;
 var getLoadedShare = runtime.getLoadedShare;
+var pinLoadedShare = runtime.pinLoadedShare;
 var loadRemote = runtime.loadRemote;
 var getContainer = runtime.getContainer;
 var preloadRemote = runtime.preloadRemote;

package/dist/{chunk-X4F2BHNM.js → chunk-ZTRJLCOF.js}

@@ -8,7 +8,7 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-TOT3P7AK.js";
+} from "./chunk-WD2ON7SN.js";
 
 // src/bridge-host-react.ts
 import {