@fulgurjs/federation 5.2.5 → 5.3.0

package/dist/chunk-UJFCPQGN.js

@@ -0,0 +1,1210 @@
+// src/semver.ts
+var VERSION_RE = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-((?:[0-9A-Za-z-]+)(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/;
+function parseVersion(input) {
+  const m = VERSION_RE.exec(String(input).trim());
+  if (!m) return null;
+  return {
+    major: Number(m[1]),
+    minor: Number(m[2] ?? 0),
+    patch: Number(m[3] ?? 0),
+    pre: m[4] ? m[4].split(".") : []
+  };
+}
+function preCompare(a, b) {
+  if (a.length === 0 && b.length === 0) return 0;
+  if (a.length === 0) return 1;
+  if (b.length === 0) return -1;
+  const len = Math.max(a.length, b.length);
+  for (let i = 0; i < len; i++) {
+    const x = a[i];
+    const y = b[i];
+    if (x === void 0) return -1;
+    if (y === void 0) return 1;
+    const xn = /^\d+$/.test(x);
+    const yn = /^\d+$/.test(y);
+    if (xn && yn) {
+      const d = Number(x) - Number(y);
+      if (d !== 0) return d;
+    } else if (xn !== yn) {
+      return xn ? -1 : 1;
+    } else if (x !== y) {
+      return x < y ? -1 : 1;
+    }
+  }
+  return 0;
+}
+function compareVersions(a, b) {
+  const va = parseVersion(a);
+  const vb = parseVersion(b);
+  if (!va || !vb) return a < b ? -1 : a > b ? 1 : 0;
+  if (va.major !== vb.major) return va.major - vb.major;
+  if (va.minor !== vb.minor) return va.minor - vb.minor;
+  if (va.patch !== vb.patch) return va.patch - vb.patch;
+  return preCompare(va.pre, vb.pre);
+}
+var ANY_RANGE = /^[a-z]+[+:-]/i;
+function satisfies(version, range) {
+  if (range === false || range == null || range === "") return true;
+  const rangeStr = String(range).trim();
+  if (!rangeStr || rangeStr === "*" || rangeStr === "latest" || ANY_RANGE.test(rangeStr)) return true;
+  return rangeStr.split("||").some((part) => satisfiesSet(version, part.trim()));
+}
+function satisfiesSet(version, set) {
+  if (!set || set === "*") return !parseVersion(version)?.pre.length;
+  const hyphen = set.split(/\s+-\s+/);
+  if (hyphen.length === 2) {
+    const lo = hyphen[0].trim();
+    const hi = hyphen[1].trim();
+    if (!satisfies(version, `>=${lo}`)) return false;
+    if (!satisfies(version, `<=${hi}`)) return false;
+    return true;
+  }
+  const v = parseVersion(version);
+  if (!v) return false;
+  const comps = parseComparators(set);
+  if (comps === null) return true;
+  for (const c of comps) {
+    if (!testComparator(v, version, c)) return false;
+  }
+  if (v.pre.length > 0 && !comps.some((c) => c.ver.pre.length > 0)) {
+    const tupleMatch = comps.some(
+      (c) => c.ver.major === v.major && c.ver.minor === v.minor && c.ver.patch === v.patch
+    );
+    if (!tupleMatch) return false;
+  }
+  return true;
+}
+function parseComparators(set) {
+  const comps = [];
+  const tokens = set.trim().split(/\s+/).filter(Boolean);
+  if (tokens.length === 0) return null;
+  for (const token of tokens) {
+    const m = /^(>=|<=|>|<|=|\^|~)?(.*)$/.exec(token);
+    if (!m) return null;
+    const op = m[1];
+    const raw = m[2];
+    const c = buildComparator(op, raw);
+    if (c === null) return null;
+    comps.push(...c);
+  }
+  return comps;
+}
+function buildComparator(op, raw) {
+  const parsed = parseLoose(raw);
+  if (!parsed) return null;
+  const { ver, partial } = parsed;
+  switch (op) {
+    case "^": {
+      const upper = caretUpper(ver);
+      if (!upper) return null;
+      return [{ op: ">=", ver }, { op: "<", ver: upper }];
+    }
+    case "~": {
+      const upper = partial >= 2 ? { major: ver.major, minor: ver.minor + 1, patch: 0, pre: [] } : { major: ver.major + 1, minor: 0, patch: 0, pre: [] };
+      return [{ op: ">=", ver }, { op: "<", ver: upper }];
+    }
+    case ">=":
+      return [{ op: ">=", ver }];
+    case ">":
+      if (partial === 1) return [{ op: ">=", ver: { major: ver.major + 1, minor: 0, patch: 0, pre: [] } }];
+      if (partial === 2)
+        return [{ op: ">=", ver: { major: ver.major, minor: ver.minor + 1, patch: 0, pre: [] } }];
+      return [{ op: ">", ver }];
+    case "<":
+      if (partial === 1) return [{ op: "<", ver: { major: ver.major, minor: 0, patch: 0, pre: [] } }];
+      if (partial === 2)
+        return [{ op: "<", ver: { major: ver.major, minor: ver.minor, patch: 0, pre: [] } }];
+      return [{ op: "<", ver }];
+    case "<=":
+      return [{ op: "<=", ver }];
+    case "=":
+    case void 0:
+      if (partial === 1)
+        return [
+          { op: ">=", ver },
+          { op: "<", ver: { major: ver.major + 1, minor: 0, patch: 0, pre: [] } }
+        ];
+      if (partial === 2)
+        return [
+          { op: ">=", ver },
+          { op: "<", ver: { major: ver.major, minor: ver.minor + 1, patch: 0, pre: [] } }
+        ];
+      return [{ op: "=", ver }];
+    default:
+      return null;
+  }
+}
+function caretUpper(ver) {
+  if (ver.major > 0) return { major: ver.major + 1, minor: 0, patch: 0, pre: [] };
+  if (ver.minor > 0) return { major: 0, minor: ver.minor + 1, patch: 0, pre: [] };
+  return { major: 0, minor: 0, patch: ver.patch + 1, pre: [] };
+}
+function parseLoose(raw) {
+  const cleaned = raw.replace(/^v/, "").trim();
+  if (!cleaned || cleaned === "*" || cleaned === "x" || cleaned === "X") {
+    return { ver: { major: 0, minor: 0, patch: 0, pre: [] }, partial: 0 };
+  }
+  const parts = cleaned.split(".");
+  const nums = [];
+  let partial = 0;
+  for (const p of parts.slice(0, 3)) {
+    if (/^\d+$/.test(p)) {
+      nums.push(Number(p));
+      partial++;
+    } else if (p === "x" || p === "X" || p === "*") {
+      break;
+    } else {
+      break;
+    }
+  }
+  const rest = cleaned.split("-");
+  const pre = rest.length > 1 ? rest.slice(1).join("-").split("+")[0].split(".") : [];
+  if (partial === 0 && pre.length === 0) return { ver: { major: 0, minor: 0, patch: 0, pre: [] }, partial: 0 };
+  return {
+    ver: { major: nums[0] ?? 0, minor: nums[1] ?? 0, patch: nums[2] ?? 0, pre },
+    partial
+  };
+}
+function cmpToBool(cmp, op) {
+  switch (op) {
+    case ">=":
+      return cmp >= 0;
+    case ">":
+      return cmp > 0;
+    case "<":
+      return cmp < 0;
+    case "<=":
+      return cmp <= 0;
+    case "=":
+      return cmp === 0;
+  }
+}
+function testComparator(v, versionStr, c) {
+  const full = `${v.major}.${v.minor}.${v.patch}` + (v.pre.length ? `-${v.pre.join(".")}` : "");
+  if (c.upper) {
+    const cmpLo = compareVersions(full, `${c.ver.major}.${c.ver.minor}.${c.ver.patch}` + (c.ver.pre.length ? `-${c.ver.pre.join(".")}` : ""));
+    if (!(cmpLo >= 0)) return false;
+    const cmpHi = compareVersions(full, `${c.upper.major}.${c.upper.minor}.${c.upper.patch}`);
+    if (!(cmpHi < 0)) return false;
+    return true;
+  }
+  const cmp = compareVersions(full, `${c.ver.major}.${c.ver.minor}.${c.ver.patch}` + (c.ver.pre.length ? `-${c.ver.pre.join(".")}` : ""));
+  const baseOk = cmpToBool(cmp, c.op);
+  if (c.ver.pre.length > 0 && v.pre.length === 0 && (c.op === ">" || c.op === "<")) {
+    return false;
+  }
+  return baseOk;
+}
+
+// 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;
+  }
+};
+var ErrorCodes = {
+  /** 远程容器加载失败（网络/超时/重试耗尽/熔断） */
+  REMOTE_LOAD_FAILED: "MFU-001",
+  /** remoteEntry 自报名与 remotes 配置的名称不匹配 */
+  REMOTE_NAME_MISMATCH: "MFU-002",
+  /** strictVersion 开启且共享版本不满足 */
+  SHARE_STRICT_VERSION: "MFU-003",
+  /** 共享模块缺失且无本地 fallback（import: false） */
+  SHARE_NOT_AVAILABLE: "MFU-004",
+  /** 同一容器用不同 share scope 重复 init */
+  CONTAINER_REINIT_CONFLICT: "MFU-005",
+  /** 请求的模块未被该远程 exposes */
+  MODULE_NOT_EXPOSED: "MFU-006",
+  /** 预加载失败 */
+  PRELOAD_FAILED: "MFU-007",
+  /** 未知远程 */
+  REMOTE_UNKNOWN: "MFU-008",
+  /** 加载到的模块没有任何导出（常见：exposes 指向了不导出内容的文件） */
+  EMPTY_EXPORTS: "MFU-009",
+  /** singleton 共享协商版本与消费方 requiredVersion 不一致（使用作用域版本，仅告警） */
+  SINGLETON_SKEW: "MFU-010",
+  /** setup 生命周期入口导出形态非法（默认导出不是函数，或具名 onSession 不是函数） */
+  SETUP_INVALID_EXPORT: "MFU-011",
+  /** setup/onSession 执行抛错（该次 loadRemote 拒绝；仅清失败阶段缓存，允许重试） */
+  SETUP_RUN_FAILED: "MFU-012",
+  /** 远程声明了 onSession 但宿主 AppContext 未提供 sessionKey（登录代次） */
+  SETUP_SESSION_KEY_MISSING: "MFU-013",
+  /** setup/onSession 执行的同步段内递归 loadRemote 同一远程 */
+  SETUP_RECURSION: "MFU-014"
+};
+
+// src/runtime/index.ts
+var SETUP_META_KEY = "__fulgurjsSetup";
+var APP_CONTEXT_GLOBAL_KEY = "__FULGURJS_APP_CONFIG__";
+var DEFAULT_TIMEOUT = 15e3;
+var DEFAULT_RETRIES = 2;
+var BREAKER_THRESHOLD = 5;
+var BREAKER_RESET_MS = 3e4;
+var BACKOFF_MAX_MS = 4e3;
+var BACKOFF_JITTER = 0.2;
+function createRuntime() {
+  const shareScopeMap2 = /* @__PURE__ */ Object.create(null);
+  const remotes = /* @__PURE__ */ new Map();
+  const plugins = [];
+  const reportedSingletonSkews = /* @__PURE__ */ new Set();
+  const loadedModules = /* @__PURE__ */ new Map();
+  const remoteManifests = /* @__PURE__ */ new Map();
+  const stylesheetLoads = /* @__PURE__ */ new WeakMap();
+  const containerInitScopes = /* @__PURE__ */ new WeakMap();
+  const hooks = {};
+  const applyPlugins = () => {
+    for (const p of plugins) {
+      try {
+        p.init?.(hooks);
+      } catch (err) {
+        console.warn("[fulgurjs] \u8FD0\u884C\u65F6\u6269\u5C55\u521D\u59CB\u5316\u5931\u8D25\uFF0C\u8BE5\u6269\u5C55\u5C06\u4E0D\u53EF\u7528\uFF1A", p.name, err);
+      }
+    }
+  };
+  const lifecycleStates = /* @__PURE__ */ new Map();
+  let lifecycleSyncRemote;
+  const lifecycleOf = (name) => {
+    let st = lifecycleStates.get(name);
+    if (!st) lifecycleStates.set(name, st = {});
+    return st;
+  };
+  const currentAppContext = () => globalThis[APP_CONTEXT_GLOBAL_KEY] ?? {};
+  async function invokeLifecycleFn(remoteName, fn, ctx, phase) {
+    const wrap = (err) => {
+      if (err instanceof FgError) return err;
+      return new FgError(
+        ErrorCodes.SETUP_RUN_FAILED,
+        `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${remoteName}" \u7684 ${phase} \u521D\u59CB\u5316\u5931\u8D25\u3002
+\u539F\u56E0\uFF1A${String(err?.message ?? err)}
+\u4FEE\u6CD5\uFF1A\u68C0\u67E5\u5E76\u4FEE\u590D\u8BE5 ${phase} \u51FD\u6570\u540E\u91CD\u65B0\u52A0\u8F7D\uFF1B\u5931\u8D25\u7F13\u5B58\u5DF2\u6E05\u9664\uFF0C\u53EF\u4EE5\u76F4\u63A5\u91CD\u8BD5\u3002`,
+        { remote: remoteName, phase },
+        { cause: err }
+      );
+    };
+    lifecycleSyncRemote = remoteName;
+    let result;
+    try {
+      result = fn(ctx);
+    } catch (err) {
+      throw wrap(err);
+    } finally {
+      lifecycleSyncRemote = void 0;
+    }
+    try {
+      await result;
+    } catch (err) {
+      throw wrap(err);
+    }
+  }
+  async function runSetupPhase(remote, container, setupKey, st) {
+    remote.debug.setup = "pending";
+    try {
+      if (remote.manifestUrl) {
+        try {
+          await preloadRemote2(`${remote.name}/${setupKey}`);
+        } catch {
+        }
+      }
+      const mod = await container.get(setupKey);
+      const setupFn = mod?.default;
+      if (typeof setupFn !== "function") {
+        throw new FgError(
+          ErrorCodes.SETUP_INVALID_EXPORT,
+          `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${remote.name}" \u7684 setup \u6A21\u5757 "${setupKey}" \u65E0\u6CD5\u521D\u59CB\u5316\u3002
+\u539F\u56E0\uFF1A\u9ED8\u8BA4\u5BFC\u51FA\u7C7B\u578B\u4E3A ${mod == null ? String(mod) : typeof setupFn}\uFF0C\u5E94\u4E3A\u51FD\u6570\u3002
+\u4FEE\u6CD5\uFF1A\u5728 setup \u6307\u5411\u7684\u6587\u4EF6\u4E2D\u9ED8\u8BA4\u5BFC\u51FA\u51FD\u6570\uFF0C\u4F8B\u5982 export default async function setup(context) { ... }\uFF1B\u5177\u540D onSession \u53EF\u9009\u3002`,
+          { remote: remote.name, module: setupKey }
+        );
+      }
+      if (mod.onSession !== void 0 && typeof mod.onSession !== "function") {
+        throw new FgError(
+          ErrorCodes.SETUP_INVALID_EXPORT,
+          `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${remote.name}" \u7684 setup \u6A21\u5757 "${setupKey}" \u65E0\u6CD5\u521D\u59CB\u5316\u3002
+\u539F\u56E0\uFF1AonSession \u5BFC\u51FA\u7C7B\u578B\u4E3A ${typeof mod.onSession}\uFF0C\u5E94\u4E3A\u51FD\u6570\u3002
+\u4FEE\u6CD5\uFF1A\u5C06 onSession \u6539\u4E3A\u5177\u540D\u5BFC\u51FA\u7684\u51FD\u6570\uFF0C\u6216\u5220\u9664\u8BE5\u5BFC\u51FA\u3002`,
+          { remote: remote.name, module: setupKey }
+        );
+      }
+      st.setupExports = mod;
+      await invokeLifecycleFn(
+        remote.name,
+        setupFn,
+        { appContext: currentAppContext(), signal: (st.controller ??= new AbortController()).signal },
+        "setup"
+      );
+      remote.debug.setup = "ready";
+    } catch (err) {
+      remote.debug.setup = "failed";
+      st.setupExports = void 0;
+      throw err;
+    }
+  }
+  async function ensureSessionPhase(remote, st, onSession) {
+    const appContext = currentAppContext();
+    const sessionKey = appContext?.sessionKey;
+    if (typeof sessionKey !== "string" || sessionKey === "") {
+      throw new FgError(
+        ErrorCodes.SETUP_SESSION_KEY_MISSING,
+        `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u5E94\u7528 "${remote.name}" \u58F0\u660E\u4E86 onSession\uFF0C\u4F46\u5BBF\u4E3B\u5C1A\u672A\u63D0\u4F9B\u6709\u6548\u7684 AppContext.sessionKey\u3002
+\u539F\u56E0\uFF1A\u5F53\u524D\u503C\u4E3A ${sessionKey === void 0 ? "\u7F3A\u5931" : JSON.stringify(sessionKey)}\u3002
+\u4FEE\u6CD5\uFF1A\u5BBF\u4E3B\u6BCF\u6B21\u767B\u5F55\u6216\u91CD\u767B\u65F6\u751F\u6210\u65B0\u7684\u975E\u654F\u611F\u767B\u5F55\u4EE3\u6B21 ID\uFF0C\u5E76\u5728\u52A0\u8F7D\u8FDC\u7A0B\u9875\u9762\u524D\u8C03\u7528 provideAppContext({ ..., sessionKey: '\u767B\u5F55\u4EE3\u6B21 ID' })\uFF1B\u4E0D\u8981\u4F7F\u7528 token \u539F\u6587\u3002`,
+        { remote: remote.name }
+      );
+    }
+    if (st.sessionPromise && st.sessionKey === sessionKey) return st.sessionPromise;
+    st.controller?.abort();
+    const controller = new AbortController();
+    st.controller = controller;
+    st.sessionKey = sessionKey;
+    const prev = st.sessionPromise ? st.sessionPromise.catch(() => {
+    }) : Promise.resolve();
+    const run = (async () => {
+      await prev;
+      if (controller.signal.aborted) return;
+      await invokeLifecycleFn(remote.name, onSession, { appContext, sessionKey, signal: controller.signal }, "onSession");
+    })();
+    st.sessionPromise = run;
+    run.catch(() => {
+      if (st.sessionKey === sessionKey) {
+        st.sessionKey = void 0;
+        st.sessionPromise = void 0;
+      }
+    });
+    return run;
+  }
+  async function ensureLifecycle(remote, container) {
+    const setupKey = container?.[SETUP_META_KEY];
+    if (typeof setupKey !== "string" || setupKey === "") return;
+    const st = lifecycleOf(remote.name);
+    if (!st.setupPromise) {
+      st.setupPromise = runSetupPhase(remote, container, setupKey, st).catch((err) => {
+        st.setupPromise = void 0;
+        throw err;
+      });
+    }
+    await st.setupPromise;
+    const onSession = st.setupExports?.onSession;
+    if (typeof onSession === "function") {
+      await ensureSessionPhase(remote, st, onSession);
+    }
+  }
+  function clearSessionState2() {
+    for (const st of lifecycleStates.values()) {
+      try {
+        st.controller?.abort();
+      } catch {
+      }
+      st.sessionKey = void 0;
+      st.sessionPromise = void 0;
+    }
+  }
+  const getScope = (name) => shareScopeMap2[name] ??= /* @__PURE__ */ Object.create(null);
+  function emitError(info) {
+    try {
+      hooks.onRemoteError?.(info);
+    } catch {
+    }
+    if (typeof window !== "undefined") {
+      window.dispatchEvent(new CustomEvent("fulgurjs:error", { detail: info }));
+    }
+  }
+  function initSharing2(scopeName = "default") {
+    getScope(scopeName);
+    return shareScopeMap2;
+  }
+  function registerShare2(scopeName, name, version, get, opts = {}) {
+    const scope = getScope(scopeName || "default");
+    const own = Object.hasOwn(scope, name) ? scope[name] : void 0;
+    let byName = own && typeof own === "object" ? own : void 0;
+    if (!byName) {
+      byName = /* @__PURE__ */ Object.create(null);
+      scope[name] = byName;
+    }
+    if (Object.hasOwn(byName, version) && byName[version]) {
+      return;
+    }
+    byName[version] = { version, get, from: opts.from ?? "unknown", eager: !!opts.eager, loaded: !!opts.loaded };
+  }
+  function assertRemoteParams(r) {
+    const check = (v, name, int10) => {
+      if (v === void 0) return;
+      const ok = typeof v === "number" && (int10 ? Number.isInteger(v) && v >= 0 && v <= 10 : Number.isFinite(v) && v > 0);
+      if (!ok) {
+        throw new Error(
+          `[fulgurjs] \u8FDC\u7A0B\u5E94\u7528 "${r.name}" \u7684 ${name} \u914D\u7F6E\u65E0\u6548\uFF1A\u5F53\u524D\u4E3A ${String(v)}\uFF0C\u5E94\u4E3A${int10 ? " 0 \u5230 10 \u7684\u6574\u6570" : "\u5927\u4E8E 0 \u7684\u6709\u9650\u6570\u5B57"}\u3002\u8BF7\u4FEE\u6B63 registerRemote \u914D\u7F6E\u3002`
+        );
+      }
+    };
+    check(r.timeout, "timeout");
+    check(r.retries, "retries", true);
+    if (r.breaker) {
+      check(r.breaker.threshold, "breaker.threshold");
+      check(r.breaker.resetMs, "breaker.resetMs");
+    }
+  }
+  function registerRemotes2(list) {
+    for (const r of list) {
+      assertRemoteParams(r);
+      const prev = remotes.get(r.name);
+      remotes.set(r.name, {
+        timeout: DEFAULT_TIMEOUT,
+        retries: DEFAULT_RETRIES,
+        ...prev,
+        ...r,
+        // 熔断参数随最新配置刷新；计数状态（fails/openUntil）跨注册保留——半开窗口不被重置
+        breakerThreshold: r.breaker?.threshold ?? prev?.breakerThreshold ?? BREAKER_THRESHOLD,
+        breakerResetMs: r.breaker?.resetMs ?? prev?.breakerResetMs ?? BREAKER_RESET_MS,
+        state: prev?.state ?? "idle",
+        breakerState: prev?.breakerState ?? { fails: 0, openUntil: 0 },
+        entryInflight: prev?.entryInflight ?? /* @__PURE__ */ new Map(),
+        entryFailCounts: prev?.entryFailCounts ?? /* @__PURE__ */ new Map(),
+        debug: prev?.debug ?? { entry: r.entry, status: "idle", setup: "none" }
+      });
+    }
+  }
+  function registerRemote2(remote) {
+    registerRemotes2([remote]);
+  }
+  function registerPlugins2(list) {
+    plugins.push(...list);
+    applyPlugins();
+  }
+  async function loadShare2(name, opts = {}) {
+    const scopeName = opts.shareScope || "default";
+    const shareKey = opts.shareKey || name;
+    const scope = getScope(scopeName);
+    const byName = scope[shareKey] || {};
+    const versions = Object.keys(byName);
+    const req = opts.requiredVersion;
+    const satisfying = versions.filter(
+      (v) => req === void 0 || req === false || satisfies(v, req)
+    );
+    let pick;
+    if (opts.singleton && versions.length > 0) {
+      const loadedVersions = versions.filter((v) => byName[v].loaded);
+      pick = [...loadedVersions.length ? loadedVersions : versions].sort(compareVersions).pop();
+      if (!satisfying.includes(pick)) {
+        const entry0 = byName[pick];
+        const msg = `\u73B0\u8C61\uFF1A\u5171\u4EAB\u5355\u4F8B "${shareKey}" \u7684\u5B9E\u9645\u7248\u672C\u4E0D\u6EE1\u8DB3\u5F53\u524D\u5E94\u7528\u8981\u6C42\u3002
+\u539F\u56E0\uFF1A\u5E94\u7528\u8981\u6C42 ${req ?? "\u4EFB\u610F\u7248\u672C"}\uFF0C\u4F5C\u7528\u57DF\u4E2D\u6709 ${versions.join("\u3001")}\uFF1B\u4E3A\u4FDD\u8BC1\u5168\u9875\u53EA\u4F7F\u7528\u4E00\u4E2A\u5B9E\u4F8B\uFF0C\u6700\u7EC8\u590D\u7528 ${entry0.from} \u63D0\u4F9B\u7684 ${pick}\u3002
+\u5F71\u54CD\uFF1A\u53EF\u80FD\u51FA\u73B0\u72B6\u6001\u4E0D\u4E00\u81F4\u6216\u8FD0\u884C\u9519\u8BEF\uFF0C\u5177\u4F53\u53D6\u51B3\u4E8E\u4E24\u7AEF API \u662F\u5426\u517C\u5BB9\u3002
+\u4FEE\u6CD5\uFF1A\u7EDF\u4E00\u5BBF\u4E3B\u4E0E\u8FDC\u7A0B\u7684\u4F9D\u8D56\u7248\u672C\uFF0C\u6216\u6838\u5BF9\u540E\u8C03\u6574 shared.requiredVersion\uFF1B\u82E5\u5FC5\u987B\u62D2\u7EDD\u4E0D\u517C\u5BB9\u7248\u672C\uFF0C\u8BF7\u542F\u7528 strictVersion\u3002`;
+        if (opts.strictVersion) {
+          const err = new FgError(ErrorCodes.SHARE_STRICT_VERSION, msg, {
+            shareKey,
+            requiredVersion: req
+          });
+          emitError({ remote: entry0.from, error: err });
+          throw err;
+        }
+        const warningKey = `${scopeName}|${shareKey}|${req ?? "*"}|${pick}|${versions.join(",")}`;
+        if (!reportedSingletonSkews.has(warningKey)) {
+          reportedSingletonSkews.add(warningKey);
+          console.warn(`[fulgurjs:MFU-010] ${msg}`);
+        }
+      }
+    } else {
+      pick = [...satisfying].sort(compareVersions).pop();
+      if (!pick) {
+        if (opts.strictVersion) {
+          const err2 = 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;
+        }
+        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;
+      }
+    }
+    let entry = byName[pick];
+    if (hooks.resolveShare) {
+      const picked = await hooks.resolveShare({
+        shareKey,
+        shareScope: scopeName,
+        requiredVersion: req,
+        picked: entry,
+        available: Object.values(byName)
+      });
+      if (picked) entry = picked;
+    }
+    entry.loaded = true;
+    return entry.get();
+  }
+  function sanitizeUrl(u) {
+    try {
+      const x = new URL(u, typeof location < "u" ? location.href : "http://f.invalid");
+      return x.protocol + "//" + x.host + x.pathname;
+    } catch {
+      return String(u).replace(/[?#].*$/, "");
+    }
+  }
+  function withTimeout(p, ms, label) {
+    return new Promise((resolve, reject) => {
+      const t = setTimeout(() => reject(new Error(`\u7B49\u5F85\u8D85\u8FC7 ${ms} \u6BEB\u79D2\uFF1A${label}`)), ms);
+      p.then(
+        (v) => {
+          clearTimeout(t);
+          resolve(v);
+        },
+        (e) => {
+          clearTimeout(t);
+          reject(e);
+        }
+      );
+    });
+  }
+  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+  function validateContainerInterface(container, remote) {
+    if (!container || typeof container.get !== "function") {
+      throw new Error(
+        `\u8FDC\u7A0B\u5E94\u7528 "${remote.name}" \u7684 remoteEntry \u672A\u5BFC\u51FA\u5BB9\u5668\u63A5\u53E3\u3002\u8BF7\u786E\u8BA4\u5165\u53E3\u5BFC\u51FA\u4E86 get()\uFF0C\u5E76\u68C0\u67E5\u8BE5\u5730\u5740\u662F\u5426\u8FD4\u56DE\u6B63\u786E\u7684\u8054\u90A6\u5165\u53E3 JS\u3002`
+      );
+    }
+    if (container.name && remote.name && container.name !== remote.name) {
+      const msg = `\u8FDC\u7A0B\u5165\u53E3\u81EA\u62A5\u540D\u79F0 "${container.name}" \u4E0E\u5BBF\u4E3B\u914D\u7F6E\u540D\u79F0 "${remote.name}" \u4E0D\u4E00\u81F4\u3002\u8BF7\u7EDF\u4E00\u4E24\u4FA7 federation({ name }) \u4E0E remotes \u7684\u540D\u79F0\u3002`;
+      if (remote.promise) {
+        console.warn(`[fulgurjs] ${msg} \u5F53\u524D\u662F\u52A8\u6001 Promise \u8FDC\u7A0B\uFF0C\u7EE7\u7EED\u52A0\u8F7D\u3002`);
+      } else {
+        throw Object.assign(new Error(msg), { code: ErrorCodes.REMOTE_NAME_MISMATCH });
+      }
+    }
+  }
+  async function importEntry(url, remote) {
+    const fails = remote.entryFailCounts.get(url) ?? 0;
+    const attemptUrl = fails > 0 ? `${url}${url.includes("?") ? "&" : "?"}fulgurjs_retry=${fails}` : url;
+    const cached = remote.entryInflight.get(url);
+    const inflight = cached ?? import(
+      /* @vite-ignore */
+      attemptUrl
+    );
+    if (!cached) {
+      remote.entryInflight.set(url, inflight);
+      inflight.catch(() => {
+        remote.entryInflight.delete(url);
+        remote.entryFailCounts.set(url, (remote.entryFailCounts.get(url) ?? 0) + 1);
+      });
+    }
+    return withTimeout(inflight, remote.timeout ?? DEFAULT_TIMEOUT, `\u52A0\u8F7D\u8FDC\u7A0B\u5165\u53E3 ${sanitizeUrl(url)}`);
+  }
+  async function acquireContainer(remote, overrides) {
+    const scopeKey = remote.shareScope || "default";
+    if (remote.container) {
+      const prevScope = containerInitScopes.get(remote.container);
+      if (prevScope && prevScope !== scopeKey) {
+        throw new FgError(
+          ErrorCodes.CONTAINER_REINIT_CONFLICT,
+          `\u8FDC\u7A0B\u5BB9\u5668 "${remote.name}" \u5DF2\u4F7F\u7528\u5171\u4EAB\u4F5C\u7528\u57DF "${prevScope}" \u521D\u59CB\u5316\uFF0C\u4E0D\u80FD\u518D\u4EE5 "${scopeKey}" \u521D\u59CB\u5316\u3002\u8BF7\u7EDF\u4E00 shareScope \u914D\u7F6E\u3002`
+        );
+      }
+      return remote.container;
+    }
+    if (remote.containerPromise) return remote.containerPromise;
+    const b = remote.breakerState;
+    if (b.openUntil > Date.now()) {
+      const err = new FgError(
+        ErrorCodes.REMOTE_LOAD_FAILED,
+        `\u8FDC\u7A0B\u5E94\u7528 "${remote.name}" \u8FDE\u7EED\u52A0\u8F7D\u5931\u8D25\uFF0C\u7194\u65AD\u5668\u5DF2\u5F00\u542F\uFF1B\u5C06\u5728 ${new Date(b.openUntil).toISOString()} \u540E\u5141\u8BB8\u91CD\u8BD5\u3002\u8BF7\u5148\u68C0\u67E5\u8FDC\u7A0B\u5165\u53E3\u670D\u52A1\u548C\u7F51\u7EDC\u3002`,
+        { remote: remote.name }
+      );
+      emitError({ remote: remote.name, error: err });
+      throw err;
+    }
+    remote.state = "loading";
+    remote.debug.status = "loading";
+    const containerPromise = (async () => {
+      const loaders = [];
+      if (remote.promise) {
+        loaders.push(async () => {
+          const resolved = await withTimeout(
+            remote.promise(),
+            remote.timeout ?? DEFAULT_TIMEOUT,
+            `\u89E3\u6790\u52A8\u6001\u8FDC\u7A0B\u5E94\u7528 "${remote.name}"`
+          );
+          const container2 = typeof resolved === "string" ? await importEntry(resolved, remote) : resolved;
+          validateContainerInterface(container2, remote);
+          return container2;
+        });
+      } else {
+        for (const url of [remote.entry, ...remote.fallback ?? []]) {
+          loaders.push(async () => {
+            const container2 = await importEntry(url, remote);
+            validateContainerInterface(container2, remote);
+            return container2;
+          });
+        }
+      }
+      let container;
+      let lastErr;
+      let succeeded = false;
+      const maxRetries = overrides?.retries ?? remote.retries ?? DEFAULT_RETRIES;
+      for (const loader of loaders) {
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+          const start = performance.now();
+          try {
+            container = await loader();
+            remote.lastLoadMs = Math.round(performance.now() - start);
+            remote.debug.lastLoadMs = remote.lastLoadMs;
+            succeeded = true;
+            break;
+          } catch (err) {
+            lastErr = err;
+            if (err?.code) throw err;
+            if (attempt < maxRetries) {
+              await sleep(Math.min(BACKOFF_MAX_MS, 200 * 2 ** attempt) * (1 - BACKOFF_JITTER * (1 - 2 * Math.random())));
+            }
+          }
+        }
+        if (succeeded) break;
+      }
+      if (!succeeded || !container) {
+        const shown = sanitizeUrl(remote.entry);
+        const hints = [];
+        if (/^https?:\/\//.test(remote.entry) && typeof location !== "undefined") {
+          hints.push(`1. \u5728\u6D4F\u89C8\u5668\u6253\u5F00 ${shown}\uFF0C\u786E\u8BA4\u8FDC\u7A0B\u5F00\u53D1\u670D\u52A1\u5DF2\u542F\u52A8\uFF0C\u5E76\u8FD4\u56DE JS \u800C\u975E HTML\u3002`);
+          hints.push(`2. \u6838\u5BF9 federation({ remotes }) \u4E2D\u7684\u5730\u5740\uFF1B\u5F00\u53D1\u548C\u751F\u4EA7\u5730\u5740\u53EF\u4EE5\u4E0D\u540C\u3002`);
+          hints.push(`3. \u82E5\u8DE8\u57DF\uFF0C\u68C0\u67E5\u8FDC\u7A0B\u5F00\u53D1\u670D\u52A1\u7684 server.cors \u914D\u7F6E\u3002`);
+        } else {
+          hints.push(`1. \u5728\u6D4F\u89C8\u5668\u6253\u5F00 ${shown}\uFF0C\u786E\u8BA4\u8FDC\u7A0B\u5E94\u7528\u5DF2\u90E8\u7F72\uFF0C\u4E14\u5165\u53E3\u8FD4\u56DE JS\u3002`);
+          hints.push(`2. \u68C0\u67E5 Nginx/CDN \u7684\u5165\u53E3\u8DEF\u5F84\u6620\u5C04\uFF1B\u8BE5\u5730\u5740\u4E0D\u80FD\u56DE\u9000\u5230 index.html\u3002`);
+        }
+        throw new FgError(
+          ErrorCodes.REMOTE_LOAD_FAILED,
+          `\u73B0\u8C61\uFF1A\u65E0\u6CD5\u4ECE ${shown} \u52A0\u8F7D\u8FDC\u7A0B\u5E94\u7528 "${remote.name}"\u3002
+\u539F\u56E0\uFF1A${String(lastErr?.message ?? lastErr)}
+\u4FEE\u6CD5\uFF1A
+${hints.join("\n")}`,
+          { remote: remote.name }
+        );
+      }
+      validateContainerInterface(container, remote);
+      const prevScope = containerInitScopes.get(container);
+      if (prevScope && prevScope !== scopeKey) {
+        throw new FgError(
+          ErrorCodes.CONTAINER_REINIT_CONFLICT,
+          `\u8FDC\u7A0B\u5BB9\u5668 "${remote.name}" \u5DF2\u4F7F\u7528\u5171\u4EAB\u4F5C\u7528\u57DF "${prevScope}" \u521D\u59CB\u5316\uFF0C\u4E0D\u80FD\u518D\u4EE5 "${scopeKey}" \u521D\u59CB\u5316\u3002\u8BF7\u7EDF\u4E00 shareScope \u914D\u7F6E\u3002`
+        );
+      }
+      if (typeof container.init === "function") {
+        await container.init(shareScopeMap2);
+      }
+      containerInitScopes.set(container, scopeKey);
+      remote.container = container;
+      remote.state = "loaded";
+      remote.debug.status = "loaded";
+      b.fails = 0;
+      return container;
+    })();
+    remote.containerPromise = containerPromise;
+    try {
+      return await containerPromise;
+    } catch (err) {
+      remote.containerPromise = void 0;
+      remote.state = "failed";
+      remote.debug.status = "failed";
+      remote.debug.error = String(err?.message ?? err);
+      b.fails += 1;
+      if (b.fails >= remote.breakerThreshold) {
+        b.openUntil = Date.now() + remote.breakerResetMs;
+        b.fails = 0;
+      }
+      if (err instanceof FgError) {
+        emitError({ remote: remote.name, error: err });
+        throw err;
+      }
+      if (err?.code) {
+        emitError({ remote: remote.name, error: err });
+        throw err;
+      }
+      const wrapped = new FgError(ErrorCodes.REMOTE_LOAD_FAILED, `\u8FDC\u7A0B\u5E94\u7528 "${remote.name}" \u52A0\u8F7D\u5931\u8D25\u3002\u5E95\u5C42\u539F\u56E0\uFF1A${String(err?.message ?? err)}\u3002\u8BF7\u68C0\u67E5\u8FDC\u7A0B\u5165\u53E3\u3001\u7F51\u7EDC\u53CA\u5171\u4EAB\u4F9D\u8D56\u3002`, {
+        remote: remote.name
+      });
+      emitError({ remote: remote.name, error: wrapped });
+      throw wrapped;
+    }
+  }
+  function parseSpec2(spec) {
+    const idx = spec.indexOf("/");
+    if (idx === -1) return { remote: spec, module: "" };
+    return { remote: spec.slice(0, idx), module: normalizeModuleName(spec.slice(idx + 1)) };
+  }
+  function normalizeModuleName(m) {
+    if (!m) return "";
+    return m.startsWith(".") ? m : `./${m}`;
+  }
+  async function loadRemote2(spec, opts) {
+    const { remote: name, module } = parseSpec2(spec);
+    if (module && lifecycleSyncRemote === name) {
+      throw new FgError(
+        ErrorCodes.SETUP_RECURSION,
+        `\u73B0\u8C61\uFF1A\u52A0\u8F7D "${spec}" \u65F6\uFF0C\u8FDC\u7A0B\u5E94\u7528 "${name}" \u7684 setup/onSession \u53C8\u540C\u6B65\u52A0\u8F7D\u4E86\u81EA\u8EAB\u6A21\u5757\uFF0C\u5F62\u6210\u5FAA\u73AF\u7B49\u5F85\u3002
+\u539F\u56E0\uFF1A\u521D\u59CB\u5316\u5C1A\u672A\u5B8C\u6210\uFF0C\u4E0D\u80FD\u7B49\u5F85\u81EA\u8EAB\u7684\u521D\u59CB\u5316\u7ED3\u679C\u3002
+\u4FEE\u6CD5\uFF1A\u4E0D\u8981\u5728 setup/onSession \u4E2D\u52A0\u8F7D\u540C\u4E00\u8FDC\u7A0B\u7684\u6A21\u5757\uFF1B\u8BF7\u5728\u9875\u9762\u7EC4\u4EF6\u4E2D\u52A0\u8F7D\uFF0C\u6216\u901A\u8FC7 context \u89E3\u8026\u3002`,
+        { remote: name }
+      );
+    }
+    try {
+      hooks.beforeLoadRemote?.({ remote: name, module });
+    } catch (hookErr) {
+      console.warn("[fulgurjs] beforeLoadRemote \u89C2\u6D4B\u94A9\u5B50\u6267\u884C\u5931\u8D25\uFF1B\u6A21\u5757\u52A0\u8F7D\u5C06\u7EE7\u7EED\u3002\u8BF7\u68C0\u67E5\u8BE5\u94A9\u5B50\uFF1A", hookErr);
+    }
+    const remote = remotes.get(name);
+    if (!remote) {
+      throw new FgError(
+        ErrorCodes.REMOTE_UNKNOWN,
+        `\u672A\u77E5\u8FDC\u7A0B\u5E94\u7528 "${name}"\u3002\u8BF7\u5728 federation({ remotes }) \u4E2D\u914D\u7F6E\uFF0C\u6216\u5728\u52A0\u8F7D\u524D\u8C03\u7528 registerRemote()\u3002`,
+        { remote: name }
+      );
+    }
+    let container;
+    try {
+      const stylesReady = module && remote.manifestUrl ? preloadRemote2(spec) : Promise.resolve();
+      [container] = await Promise.all([acquireContainer(remote, { retries: opts?.retries }), stylesReady]);
+    } catch (err) {
+      if (opts?.fallbackModule) {
+        console.error(`[fulgurjs] \u8FDC\u7A0B\u6A21\u5757 "${spec}" \u52A0\u8F7D\u5931\u8D25\uFF0C\u6B63\u5728\u4F7F\u7528\u663E\u5F0F\u914D\u7F6E\u7684 fallbackModule\uFF1B\u539F\u59CB\u9519\u8BEF\uFF1A`, err);
+        emitError({ remote: name, error: err });
+        return await opts.fallbackModule();
+      }
+      throw err;
+    }
+    if (!module) return container;
+    await ensureLifecycle(remote, container);
+    const cacheKey = `${name}@${remote.shareScope || "default"}#${module}`;
+    if (!loadedModules.has(cacheKey)) {
+      loadedModules.set(
+        cacheKey,
+        container.get(module).catch((err) => {
+          loadedModules.delete(cacheKey);
+          if (err instanceof FgError || err?.code) throw err;
+          throw new FgError(
+            ErrorCodes.REMOTE_LOAD_FAILED,
+            `\u65E0\u6CD5\u4ECE\u8FDC\u7A0B\u5E94\u7528 "${name}" \u52A0\u8F7D\u6A21\u5757 "${module}"\u3002\u5E95\u5C42\u539F\u56E0\uFF1A${String(err?.message ?? err)}\u3002\u8BF7\u6838\u5BF9 exposes \u952E\u548C\u8FDC\u7A0B\u6784\u5EFA\u4EA7\u7269\u3002`,
+            { remote: name, module }
+          );
+        })
+      );
+    }
+    let ns;
+    try {
+      ns = await loadedModules.get(cacheKey);
+    } catch (err) {
+      if (opts?.fallbackModule) {
+        console.error(`[fulgurjs] \u8FDC\u7A0B\u6A21\u5757 "${spec}" \u52A0\u8F7D\u5931\u8D25\uFF0C\u6B63\u5728\u4F7F\u7528\u663E\u5F0F\u914D\u7F6E\u7684 fallbackModule\uFF1B\u539F\u59CB\u9519\u8BEF\uFF1A`, err);
+        emitError({ remote: name, error: err });
+        return await opts.fallbackModule();
+      }
+      throw err;
+    }
+    try {
+      hooks.afterLoadRemote?.({ remote: name, module, module_ns: ns });
+    } catch (hookErr) {
+      console.warn("[fulgurjs] afterLoadRemote \u89C2\u6D4B\u94A9\u5B50\u6267\u884C\u5931\u8D25\uFF1B\u5DF2\u52A0\u8F7D\u6A21\u5757\u4ECD\u53EF\u4F7F\u7528\u3002\u8BF7\u68C0\u67E5\u8BE5\u94A9\u5B50\uFF1A", hookErr);
+    }
+    if (ns && typeof ns === "object" && Object.keys(ns).length === 0) {
+      const err = new FgError(
+        ErrorCodes.EMPTY_EXPORTS,
+        `\u8FDC\u7A0B\u5E94\u7528 "${name}" \u7684\u6A21\u5757 "${module}" \u6CA1\u6709\u4EFB\u4F55\u5BFC\u51FA\u3002\u8BF7\u68C0\u67E5 exposes \u6307\u5411\u7684\u6587\u4EF6\u53CA\u5176 export \u58F0\u660E\u3002`,
+        { remote: name, module }
+      );
+      emitError({ remote: name, error: err });
+      console.error(err.message);
+    }
+    return ns;
+  }
+  function getContainer2(name) {
+    const remote = remotes.get(name);
+    if (!remote) {
+      throw new FgError(ErrorCodes.REMOTE_UNKNOWN, `\u672A\u77E5\u8FDC\u7A0B\u5E94\u7528 "${name}"\u3002\u8BF7\u5148\u6CE8\u518C\u8BE5\u8FDC\u7A0B\u5E94\u7528\u3002`, { remote: name });
+    }
+    return acquireContainer(remote);
+  }
+  async function preloadRemote2(spec, opts = {}) {
+    const { remote: name, module } = parseSpec2(spec);
+    const remote = remotes.get(name);
+    if (!remote) {
+      throw new FgError(ErrorCodes.REMOTE_UNKNOWN, `\u672A\u77E5\u8FDC\u7A0B\u5E94\u7528 "${name}"\u3002\u8BF7\u5148\u6CE8\u518C\u8BE5\u8FDC\u7A0B\u5E94\u7528\u3002`, { remote: name });
+    }
+    const mode = opts.mode ?? "preload";
+    const waitForStylesheet = (link, href) => {
+      if (link.sheet) return Promise.resolve();
+      const pending = stylesheetLoads.get(link);
+      if (pending) return pending;
+      const loaded = new Promise((resolve) => {
+        const finish = () => {
+          link.removeEventListener("load", finish);
+          link.removeEventListener("error", failed);
+          resolve();
+        };
+        const failed = () => {
+          emitError({
+            remote: name,
+            error: new FgError(ErrorCodes.PRELOAD_FAILED, `\u8FDC\u7A0B\u5E94\u7528 "${name}" \u7684\u6837\u5F0F\u8D44\u6E90\u52A0\u8F7D\u5931\u8D25\uFF1A${href}\u3002\u8BF7\u68C0\u67E5\u6587\u4EF6\u662F\u5426\u5B58\u5728\u4EE5\u53CA\u8DE8\u57DF\u548C\u7F13\u5B58\u914D\u7F6E\u3002`, {
+              remote: name
+            })
+          });
+          finish();
+        };
+        link.addEventListener("load", finish, { once: true });
+        link.addEventListener("error", failed, { once: true });
+        if (link.sheet) finish();
+      });
+      stylesheetLoads.set(link, loaded);
+      return loaded;
+    };
+    const inject = (href, as) => {
+      if (typeof document === "undefined") return Promise.resolve();
+      const existing = document.querySelector(`link[href="${href}"]`);
+      if (existing) {
+        return as === "style" && mode === "preload" ? stylesheetLoads.get(existing) ?? Promise.resolve() : Promise.resolve();
+      }
+      const link = document.createElement("link");
+      link.rel = as === "style" ? "stylesheet" : "modulepreload";
+      link.href = href;
+      if (mode === "prefetch") {
+        ;
+        link.fetchPriority = "low";
+      }
+      const loaded = as === "style" ? waitForStylesheet(link, href) : Promise.resolve();
+      document.head.appendChild(link);
+      return as === "style" && mode === "preload" ? loaded : Promise.resolve();
+    };
+    const resolveAssetUrl = (asset) => {
+      const pageUrl = typeof document !== "undefined" ? document.baseURI : void 0;
+      const base = new URL(remote.entry, pageUrl || "http://fulgurjs.invalid/");
+      if (!base.pathname.endsWith("/") && !base.pathname.split("/").pop().includes(".")) {
+        base.pathname += "/";
+      }
+      return new URL(asset, base).href;
+    };
+    try {
+      if (remote.manifestUrl) {
+        let manifestPromise = remoteManifests.get(remote.manifestUrl);
+        if (!manifestPromise) {
+          manifestPromise = fetch(remote.manifestUrl, {
+            cache: "no-cache",
+            signal: AbortSignal.timeout(8e3)
+          }).then((res) => res.ok ? res.json() : void 0);
+          remoteManifests.set(remote.manifestUrl, manifestPromise);
+          manifestPromise.then(
+            (manifest2) => {
+              if (!manifest2) remoteManifests.delete(remote.manifestUrl);
+            },
+            () => remoteManifests.delete(remote.manifestUrl)
+          );
+        }
+        const manifest = await manifestPromise;
+        if (manifest) {
+          const sv = manifest.schemaVersion;
+          if (typeof sv === "number" && (!Number.isInteger(sv) || sv > 1)) {
+            emitError({
+              remote: name,
+              error: new FgError(ErrorCodes.PRELOAD_FAILED, `\u8FDC\u7A0B\u5E94\u7528 "${name}" \u7684 manifest \u534F\u8BAE\u7248\u672C\u4E3A ${String(sv)}\uFF0C\u5F53\u524D\u4EC5\u652F\u6301\u7248\u672C 1\u3002\u8BF7\u7EDF\u4E00\u5BBF\u4E3B\u548C\u8FDC\u7A0B\u7684\u63D2\u4EF6\u7248\u672C\u3002`, {
+                remote: name
+              })
+            });
+            await inject(remote.entry, "modulepreload");
+            return;
+          }
+          await inject(remote.entry, "modulepreload");
+          const exposes = manifest.exposes;
+          const entries = Array.isArray(exposes) ? exposes.filter((item) => item && typeof item === "object").map((item) => [String(item.name ?? ""), item]) : exposes && typeof exposes === "object" ? Object.entries(exposes) : [];
+          const selected = module ? entries.filter(([key, item]) => normalizeModuleName(String(item?.name ?? key)) === module) : entries;
+          const cssLoads = [];
+          for (const [, item] of selected) {
+            if (typeof item?.file === "string") {
+              await inject(resolveAssetUrl(item.file), "modulepreload");
+            }
+            if (Array.isArray(item?.css)) {
+              for (const css of item.css) {
+                if (typeof css !== "string") continue;
+                const loading = inject(resolveAssetUrl(css), "style");
+                if (mode === "preload") cssLoads.push(loading);
+              }
+            }
+          }
+          await Promise.all(cssLoads);
+          return;
+        }
+      }
+      await inject(remote.entry, "modulepreload");
+    } catch (err) {
+      emitError({
+        remote: name,
+        error: new FgError(ErrorCodes.PRELOAD_FAILED, `\u8FDC\u7A0B\u5E94\u7528 "${name}" \u9884\u52A0\u8F7D\u5931\u8D25\u3002\u5E95\u5C42\u539F\u56E0\uFF1A${String(err?.message ?? err)}\u3002\u8BF7\u68C0\u67E5 manifest \u548C\u8D44\u6E90\u5730\u5740\u3002`, {
+          remote: name
+        })
+      });
+    }
+  }
+  const attachDebug = () => {
+    if (typeof window === "undefined") return;
+    window.__FULGURJS_SCOPE__ = shareScopeMap2;
+    window.__FULGURJS_INFO__ = {
+      get remotes() {
+        const out = {};
+        for (const [k, v] of remotes) {
+          out[k] = { ...v.debug, entry: v.entry };
+        }
+        return out;
+      },
+      errors: []
+    };
+  };
+  attachDebug();
+  return {
+    shareScopeMap: shareScopeMap2,
+    initSharing: initSharing2,
+    registerShare: registerShare2,
+    registerRemotes: registerRemotes2,
+    registerRemote: registerRemote2,
+    registerPlugins: registerPlugins2,
+    loadShare: loadShare2,
+    loadRemote: loadRemote2,
+    getContainer: getContainer2,
+    preloadRemote: preloadRemote2,
+    parseSpec: parseSpec2,
+    clearSessionState: clearSessionState2
+  };
+}
+var g = globalThis;
+var runtime = g.__FULGURJS_RUNTIME__ ?? createRuntime();
+g.__FULGURJS_RUNTIME__ = runtime;
+try {
+  Object.freeze(runtime);
+} catch {
+}
+var initSharing = runtime.initSharing;
+var registerShare = runtime.registerShare;
+var registerRemotes = runtime.registerRemotes;
+var registerRemote = runtime.registerRemote;
+var registerPlugins = runtime.registerPlugins;
+var loadShare = runtime.loadShare;
+var loadRemote = runtime.loadRemote;
+var getContainer = runtime.getContainer;
+var preloadRemote = runtime.preloadRemote;
+var parseSpec = runtime.parseSpec;
+var clearSessionState = runtime.clearSessionState;
+var shareScopeMap = runtime.shareScopeMap;
+
+// 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 g2 = globalThis;
+  g2[APP_CONTEXT_STORAGE_KEY] = { ...g2[APP_CONTEXT_STORAGE_KEY] ?? {}, ...config };
+}
+function clearAppContext() {
+  const g2 = globalThis;
+  delete g2[APP_CONTEXT_STORAGE_KEY];
+  try {
+    g2.__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\u2014\u2014\u4E0D\u8981\u76F4\u63A5\u5728\u540C\u4E00 el \u4E0A\u542F\u52A8\u65B0\u5B9E\u4F8B\uFF1B\n        \u2462 \u5237\u65B0\u9875\u9762\u53EF\u5F7B\u5E95\u6E05\u7406\uFF0C\u6B8B\u7559\u8D44\u6E90\u8BF7\u5982\u5B9E\u6392\u67E5\uFF08\u4E8B\u4EF6\u8BA2\u9605/\u5B9A\u65F6\u5668/\u5168\u5C40\u526F\u4F5C\u7528\uFF09\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,
+        `getContext \u8FD4\u56DE\u4E86${typeof snapshot.then === "function" ? " Promise/thenable" : "\u975E\u5BF9\u8C61\u503C\uFF08" + typeof snapshot + "\uFF09"}\uFF1B\u5B83\u5FC5\u987B\u662F\u540C\u6B65\u8FD4\u56DE\u5FEB\u7167\u5BF9\u8C61\u7684\u7EAF getter\u3002`
+      );
+    }
+    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 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);
+      }
+    );
+  });
+}
+
+export {
+  loadRemote,
+  provideAppContext,
+  bridgeLifecycleError,
+  assertBridgeContract,
+  acquireBridgeSession,
+  releaseBridgeSession,
+  resolveBridgeContext,
+  assertControlledSessionKey,
+  assertBridgeOptions,
+  withBridgeTimeout
+};