@fulgurjs/federation 5.2.5 → 5.3.1

package/dist/chunk-TSYLDY6H.js

@@ -0,0 +1,64 @@
+import {
+  FgError
+} from "./chunk-OF2JCXTZ.js";
+
+// 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 {
+  }
+}
+function getAppContext() {
+  requireRuntime();
+  return globalThis[APP_CONTEXT_STORAGE_KEY] ?? {};
+}
+function requireAppContext(...keys) {
+  const ctx = getAppContext();
+  const missing = keys.filter((k) => ctx[k] === void 0);
+  if (missing.length === 0) return ctx;
+  const got = Object.keys(ctx);
+  const err = new FgError(
+    ContextErrorCodes.CONTEXT_MISSING_KEY,
+    `\u73B0\u8C61\uFF1AAppContext \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5 ${missing.map((k) => `"${k}"`).join("\u3001")}\u3002
+\u5F53\u524D\u5B57\u6BB5\uFF1A${got.length ? got.map((k) => `"${k}"`).join("\u3001") : "\u7A7A\uFF08\u5BBF\u4E3B\u6865\u53EF\u80FD\u5C1A\u672A\u8C03\u7528 provideAppContext\uFF09"}\u3002
+\u9884\u671F\uFF1A\u5BBF\u4E3B\u6865\u5E94\u5728\u8FDC\u7A0B\u9875\u9762\u52A0\u8F7D\u524D\u63D0\u4F9B ${missing.map((k) => `"${k}"`).join("\u3001")}\u3002
+\u793A\u4F8B\uFF1Ahost/src/fulgurjs/host/bridge.ts \u2192 provideAppContext({ ${keys.join(", ")}, ... })
+  \u4FEE\u6CD5: \u68C0\u67E5\u5BBF\u4E3B\u5E94\u7528\u7684 fulgurjs \u6865\u662F\u5426\u5728 loadRemote \u9875\u9762\u524D\u5B8C\u6210 context provide\uFF08\u65F6\u5E8F\u5951\u7EA6 bridge \u2192 \u8FDC\u7A0B setup \u2192 \u9875\u9762\u6A21\u5757\uFF09`,
+    { missing, got }
+  );
+  throw err;
+}
+
+export {
+  ContextErrorCodes,
+  provideAppContext,
+  clearAppContext,
+  getAppContext,
+  requireAppContext
+};

package/dist/chunk-X4F2BHNM.js

@@ -0,0 +1,179 @@
+import {
+  acquireBridgeSession,
+  assertBridgeContract,
+  assertBridgeOptions,
+  assertControlledSessionKey,
+  bridgeLifecycleError,
+  provideAppContext,
+  releaseBridgeSession,
+  resolveBridgeContext,
+  withBridgeTimeout
+} from "./chunk-TOT3P7AK.js";
+
+// src/bridge-host-react.ts
+import {
+  createElement,
+  Fragment,
+  useEffect,
+  useRef,
+  useState
+} from "react";
+var ERROR_STYLE = {
+  padding: "16px",
+  border: "1px solid #fde2e2",
+  borderRadius: "4px",
+  background: "#fef0f0",
+  color: "#c45656",
+  fontSize: "13px",
+  lineHeight: "1.6",
+  boxSizing: "border-box"
+};
+var MESSAGE_STYLE = { margin: "0 0 8px", wordBreak: "break-all" };
+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"
+};
+function DefaultBridgeErrorView({ error, retry, blocked }) {
+  const err = error;
+  const code = err?.code ?? "UNKNOWN";
+  const message = err?.message ?? String(error ?? "unknown error");
+  return createElement("div", { style: ERROR_STYLE, "data-fulgurjs-error": code }, [
+    createElement("p", { key: "t", style: { margin: "0 0 4px", fontWeight: 600 } }, `\u6865\u63A5\u5E94\u7528\u52A0\u8F7D\u5931\u8D25\uFF08\u9519\u8BEF\u7801 ${code}\uFF09`),
+    createElement("p", { key: "m", style: MESSAGE_STYLE }, message),
+    createElement(
+      "p",
+      { key: "n", style: { margin: "0 0 10px" } },
+      blocked ? "\u8BE5\u5BB9\u5668\u5DF2\u5C01\u9501\uFF08\u540C\u9875\u65E0\u6CD5\u5B89\u5168\u91CD\u6302\uFF09\uFF0C\u53EA\u80FD\u6574\u9875\u5237\u65B0\u6062\u590D\u2014\u2014\u70B9\u51FB\u300C\u5237\u65B0\u9875\u9762\u91CD\u8BD5\u300D\u4F1A\u91CD\u65B0\u52A0\u8F7D\u9875\u9762\uFF08\u4FDD\u7559\u5F53\u524D\u5730\u5740\uFF09\uFF0C\u672A\u4FDD\u5B58\u7684\u9875\u9762\u72B6\u6001\u4F1A\u4E22\u5931\u3002" : "\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"
+    ),
+    blocked ? null : createElement("button", { key: "r", type: "button", style: BUTTON_STYLE, "data-fulgurjs-retry": "", onClick: retry }, "\u91CD\u8BD5\u52A0\u8F7D"),
+    createElement("button", {
+      key: "rl",
+      type: "button",
+      style: SECONDARY_BUTTON_STYLE,
+      "data-fulgurjs-reload": "",
+      onClick: () => window.location.reload()
+    }, "\u5237\u65B0\u9875\u9762\u91CD\u8BD5")
+  ]);
+}
+function renderBridgeErrorNode(errorOpt, error, retry, blocked) {
+  if (typeof errorOpt === "function") return errorOpt(error, retry);
+  if (errorOpt !== void 0) return errorOpt;
+  return createElement(DefaultBridgeErrorView, { error, retry, blocked });
+}
+function createReactBridgeAppWithLoader(loadRemote) {
+  return function createReactBridgeApp(spec, options = {}) {
+    assertBridgeOptions(`createReactBridgeApp("${spec}")`, options);
+    const displayName = "FulgurjsBridge_" + spec.replace(/[^A-Za-z0-9_-]/g, "_");
+    function BridgeHost(props) {
+      const [status, setStatus] = useState("idle");
+      const [error, setError] = useState(void 0);
+      const [attempt, setAttempt] = useState(0);
+      const containerRef = useRef(null);
+      const generationRef = useRef(0);
+      const contractRef = useRef(void 0);
+      const acquiredRef = useRef(void 0);
+      const blockedRef = useRef(false);
+      const latest = useRef(props);
+      latest.current = props;
+      useEffect(() => {
+        if (blockedRef.current) return;
+        const myGen = ++generationRef.current;
+        const el = containerRef.current;
+        const release = () => {
+          if (acquiredRef.current !== void 0) {
+            releaseBridgeSession(acquiredRef.current);
+            acquiredRef.current = void 0;
+          }
+        };
+        const run = async () => {
+          if (!el) return;
+          const sk = latest.current.sessionKey;
+          setStatus("pending");
+          setError(void 0);
+          if (sk === null) {
+            setStatus("idle");
+            return;
+          }
+          try {
+            assertControlledSessionKey(spec, sk);
+            const controlled = typeof sk === "string" ? sk : void 0;
+            if (controlled !== void 0 && controlled !== acquiredRef.current) {
+              release();
+              acquireBridgeSession(spec, controlled);
+              acquiredRef.current = 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 (generationRef.current !== myGen) return;
+            const contract = assertBridgeContract(spec, mod);
+            contractRef.current = contract;
+            await contract.mount(el, { ...latest.current.appProps ?? {} });
+            if (generationRef.current !== myGen) return;
+            setStatus("ready");
+          } catch (e) {
+            if (generationRef.current !== myGen) return;
+            setError(e);
+            setStatus("error");
+          }
+        };
+        void run();
+        return () => {
+          generationRef.current++;
+          release();
+          const c = contractRef.current;
+          contractRef.current = void 0;
+          if (c && el) {
+            try {
+              c.unmount(el);
+            } catch (e) {
+              const err = bridgeLifecycleError("unmount", spec, e instanceof Error ? e : String(e));
+              console.error("[fulgurjs] \u6865\u63A5\u5E94\u7528\u5378\u8F7D\u5931\u8D25\uFF1A", err);
+              blockedRef.current = true;
+              setError(err);
+              setStatus("error");
+            }
+          }
+        };
+      }, [props.sessionKey, attempt]);
+      const retry = () => setAttempt((a) => a + 1);
+      const children = [];
+      if (status === "pending" && options.fallback !== void 0) {
+        children.push(createElement(Fragment, { key: "loading" }, options.fallback));
+      }
+      if (status === "error") {
+        children.push(createElement(Fragment, { key: "error" }, renderBridgeErrorNode(options.error, error, retry, blockedRef.current)));
+      }
+      children.push(createElement("div", {
+        key: "bridge-root",
+        ref: containerRef,
+        "data-fulgurjs-bridge-root": spec,
+        "data-fulgurjs-bridge-status": status
+      }));
+      return createElement(Fragment, null, children);
+    }
+    ;
+    BridgeHost.displayName = displayName;
+    return BridgeHost;
+  };
+}
+
+export {
+  createReactBridgeAppWithLoader
+};

package/dist/context.js

@@ -1,67 +1,11 @@
-// 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 {
-  }
-}
-function getAppContext() {
-  requireRuntime();
-  return globalThis[APP_CONTEXT_STORAGE_KEY] ?? {};
-}
-function requireAppContext(...keys) {
-  const ctx = getAppContext();
-  const missing = keys.filter((k) => ctx[k] === void 0);
-  if (missing.length === 0) return ctx;
-  const got = Object.keys(ctx);
-  const err = new FgError(
-    ContextErrorCodes.CONTEXT_MISSING_KEY,
-    `\u73B0\u8C61\uFF1AAppContext \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5 ${missing.map((k) => `"${k}"`).join("\u3001")}\u3002
-\u5F53\u524D\u5B57\u6BB5\uFF1A${got.length ? got.map((k) => `"${k}"`).join("\u3001") : "\u7A7A\uFF08\u5BBF\u4E3B\u6865\u53EF\u80FD\u5C1A\u672A\u8C03\u7528 provideAppContext\uFF09"}\u3002
-\u9884\u671F\uFF1A\u5BBF\u4E3B\u6865\u5E94\u5728\u8FDC\u7A0B\u9875\u9762\u52A0\u8F7D\u524D\u63D0\u4F9B ${missing.map((k) => `"${k}"`).join("\u3001")}\u3002
-\u793A\u4F8B\uFF1Ahost/src/fulgurjs/host/bridge.ts \u2192 provideAppContext({ ${keys.join(", ")}, ... })
-  \u4FEE\u6CD5: \u68C0\u67E5\u5BBF\u4E3B\u5E94\u7528\u7684 fulgurjs \u6865\u662F\u5426\u5728 loadRemote \u9875\u9762\u524D\u5B8C\u6210 context provide\uFF08\u65F6\u5E8F\u5951\u7EA6 bridge \u2192 \u8FDC\u7A0B setup \u2192 \u9875\u9762\u6A21\u5757\uFF09`,
-    { missing, got }
-  );
-  throw err;
-}
+import {
+  ContextErrorCodes,
+  clearAppContext,
+  getAppContext,
+  provideAppContext,
+  requireAppContext
+} from "./chunk-TSYLDY6H.js";
+import "./chunk-OF2JCXTZ.js";
 export {
   ContextErrorCodes,
   clearAppContext,