@module-federation/bridge-react 0.0.0-next-20250414091720 → 0.0.0-next-20250415111630

package/CHANGELOG.md

@@ -1,13 +1,17 @@
 # @module-federation/bridge-react
 
-## 0.0.0-next-20250414091720
+## 0.0.0-next-20250415111630
+
+### Minor Changes
+
+- d802e00: feat(react-bridge): Add native support for React 19 in bridge-react with enhanced createRoot options
 
 ### Patch Changes
 
-- Updated dependencies [bed7b8f]
+- d0a11ff: feat(bridge-react): support react v19 in react compat file.
 - Updated dependencies [f4fb242]
-  - @module-federation/sdk@0.0.0-next-20250414091720
-  - @module-federation/bridge-shared@0.0.0-next-20250414091720
+  - @module-federation/sdk@0.0.0-next-20250415111630
+  - @module-federation/bridge-shared@0.0.0-next-20250415111630
 
 ## 0.11.4
 

package/dist/bridge-base-BQcdOEoU.cjs

@@ -0,0 +1,119 @@
+"use strict";
+const React = require("react");
+const reactErrorBoundary_esm = require("./react-error-boundary.esm-D8nxmvmv.cjs");
+const context = require("./context-C79iMWYD.cjs");
+const plugin = require("./plugin.cjs.js");
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const React__namespace = /* @__PURE__ */ _interopNamespaceDefault(React);
+function createBaseBridgeComponent({
+  createRoot,
+  defaultRootOptions,
+  ...bridgeInfo
+}) {
+  return () => {
+    const rootMap = /* @__PURE__ */ new Map();
+    const instance = plugin.federationRuntime.instance;
+    context.LoggerInstance.debug(
+      `createBridgeComponent instance from props >>>`,
+      instance
+    );
+    const RawComponent = (info) => {
+      const { appInfo, propsInfo, ...restProps } = info;
+      const { moduleName, memoryRoute, basename = "/" } = appInfo;
+      return /* @__PURE__ */ React__namespace.createElement(context.RouterContext.Provider, { value: { moduleName, basename, memoryRoute } }, /* @__PURE__ */ React__namespace.createElement(
+        bridgeInfo.rootComponent,
+        {
+          ...propsInfo,
+          basename,
+          ...restProps
+        }
+      ));
+    };
+    return {
+      async render(info) {
+        var _a, _b, _c, _d, _e, _f;
+        context.LoggerInstance.debug(`createBridgeComponent render Info`, info);
+        const {
+          moduleName,
+          dom,
+          basename,
+          memoryRoute,
+          fallback,
+          rootOptions,
+          ...propsInfo
+        } = info;
+        const mergedRootOptions = {
+          ...defaultRootOptions,
+          ...rootOptions
+        };
+        const beforeBridgeRenderRes = ((_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.beforeBridgeRender) == null ? void 0 : _c.emit(info)) || {};
+        const rootComponentWithErrorBoundary = /* @__PURE__ */ React__namespace.createElement(
+          reactErrorBoundary_esm.ErrorBoundary,
+          {
+            FallbackComponent: fallback
+          },
+          /* @__PURE__ */ React__namespace.createElement(
+            RawComponent,
+            {
+              appInfo: {
+                moduleName,
+                basename,
+                memoryRoute
+              },
+              propsInfo: {
+                ...propsInfo,
+                ...beforeBridgeRenderRes == null ? void 0 : beforeBridgeRenderRes.extraProps
+              }
+            }
+          )
+        );
+        if (bridgeInfo.render) {
+          await Promise.resolve(
+            bridgeInfo.render(rootComponentWithErrorBoundary, dom)
+          ).then((root) => rootMap.set(dom, root));
+        } else {
+          let root = rootMap.get(dom);
+          if (!root && createRoot) {
+            root = createRoot(dom, mergedRootOptions);
+            rootMap.set(dom, root);
+          }
+          if (root && "render" in root) {
+            root.render(rootComponentWithErrorBoundary);
+          }
+        }
+        ((_f = (_e = (_d = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _d.lifecycle) == null ? void 0 : _e.afterBridgeRender) == null ? void 0 : _f.emit(info)) || {};
+      },
+      destroy(info) {
+        var _a, _b, _c;
+        const { dom } = info;
+        context.LoggerInstance.debug(`createBridgeComponent destroy Info`, info);
+        const root = rootMap.get(dom);
+        if (root) {
+          if ("unmount" in root) {
+            root.unmount();
+          } else {
+            console.warn("Root does not have unmount method");
+          }
+          rootMap.delete(dom);
+        }
+        (_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.afterBridgeDestroy) == null ? void 0 : _c.emit(info);
+      }
+    };
+  };
+}
+exports.createBaseBridgeComponent = createBaseBridgeComponent;

package/dist/bridge-base-BbzPi965.js

@@ -0,0 +1,103 @@
+import * as React from "react";
+import { E as ErrorBoundary } from "./react-error-boundary.esm-CMdlkNPP.js";
+import { L as LoggerInstance, R as RouterContext } from "./context-Dbqf0szX.js";
+import { federationRuntime } from "./plugin.es.js";
+function createBaseBridgeComponent({
+  createRoot,
+  defaultRootOptions,
+  ...bridgeInfo
+}) {
+  return () => {
+    const rootMap = /* @__PURE__ */ new Map();
+    const instance = federationRuntime.instance;
+    LoggerInstance.debug(
+      `createBridgeComponent instance from props >>>`,
+      instance
+    );
+    const RawComponent = (info) => {
+      const { appInfo, propsInfo, ...restProps } = info;
+      const { moduleName, memoryRoute, basename = "/" } = appInfo;
+      return /* @__PURE__ */ React.createElement(RouterContext.Provider, { value: { moduleName, basename, memoryRoute } }, /* @__PURE__ */ React.createElement(
+        bridgeInfo.rootComponent,
+        {
+          ...propsInfo,
+          basename,
+          ...restProps
+        }
+      ));
+    };
+    return {
+      async render(info) {
+        var _a, _b, _c, _d, _e, _f;
+        LoggerInstance.debug(`createBridgeComponent render Info`, info);
+        const {
+          moduleName,
+          dom,
+          basename,
+          memoryRoute,
+          fallback,
+          rootOptions,
+          ...propsInfo
+        } = info;
+        const mergedRootOptions = {
+          ...defaultRootOptions,
+          ...rootOptions
+        };
+        const beforeBridgeRenderRes = ((_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.beforeBridgeRender) == null ? void 0 : _c.emit(info)) || {};
+        const rootComponentWithErrorBoundary = /* @__PURE__ */ React.createElement(
+          ErrorBoundary,
+          {
+            FallbackComponent: fallback
+          },
+          /* @__PURE__ */ React.createElement(
+            RawComponent,
+            {
+              appInfo: {
+                moduleName,
+                basename,
+                memoryRoute
+              },
+              propsInfo: {
+                ...propsInfo,
+                ...beforeBridgeRenderRes == null ? void 0 : beforeBridgeRenderRes.extraProps
+              }
+            }
+          )
+        );
+        if (bridgeInfo.render) {
+          await Promise.resolve(
+            bridgeInfo.render(rootComponentWithErrorBoundary, dom)
+          ).then((root) => rootMap.set(dom, root));
+        } else {
+          let root = rootMap.get(dom);
+          if (!root && createRoot) {
+            root = createRoot(dom, mergedRootOptions);
+            rootMap.set(dom, root);
+          }
+          if (root && "render" in root) {
+            root.render(rootComponentWithErrorBoundary);
+          }
+        }
+        ((_f = (_e = (_d = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _d.lifecycle) == null ? void 0 : _e.afterBridgeRender) == null ? void 0 : _f.emit(info)) || {};
+      },
+      destroy(info) {
+        var _a, _b, _c;
+        const { dom } = info;
+        LoggerInstance.debug(`createBridgeComponent destroy Info`, info);
+        const root = rootMap.get(dom);
+        if (root) {
+          if ("unmount" in root) {
+            root.unmount();
+          } else {
+            console.warn("Root does not have unmount method");
+          }
+          rootMap.delete(dom);
+        }
+        (_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.afterBridgeDestroy) == null ? void 0 : _c.emit(info);
+      }
+    };
+  };
+}
+export {
+  createBaseBridgeComponent as c
+};

package/dist/index.cjs.js

@@ -1,7 +1,7 @@
 "use strict";
-var _a;
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const React = require("react");
+const reactErrorBoundary_esm = require("./react-error-boundary.esm-D8nxmvmv.cjs");
 const context = require("./context-C79iMWYD.cjs");
 const ReactRouterDOM = require("react-router-dom");
 const plugin = require("./plugin.cjs.js");
@@ -24,101 +24,6 @@ function _interopNamespaceDefault(e2) {
 }
 const React__namespace = /* @__PURE__ */ _interopNamespaceDefault(React);
 const ReactRouterDOM__namespace = /* @__PURE__ */ _interopNamespaceDefault(ReactRouterDOM);
-const ErrorBoundaryContext = React.createContext(null);
-const initialState = {
-  didCatch: false,
-  error: null
-};
-class ErrorBoundary extends React.Component {
-  constructor(props) {
-    super(props);
-    this.resetErrorBoundary = this.resetErrorBoundary.bind(this);
-    this.state = initialState;
-  }
-  static getDerivedStateFromError(error) {
-    return {
-      didCatch: true,
-      error
-    };
-  }
-  resetErrorBoundary() {
-    const {
-      error
-    } = this.state;
-    if (error !== null) {
-      var _this$props$onReset, _this$props;
-      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-        args[_key] = arguments[_key];
-      }
-      (_this$props$onReset = (_this$props = this.props).onReset) === null || _this$props$onReset === void 0 ? void 0 : _this$props$onReset.call(_this$props, {
-        args,
-        reason: "imperative-api"
-      });
-      this.setState(initialState);
-    }
-  }
-  componentDidCatch(error, info) {
-    var _this$props$onError, _this$props2;
-    (_this$props$onError = (_this$props2 = this.props).onError) === null || _this$props$onError === void 0 ? void 0 : _this$props$onError.call(_this$props2, error, info);
-  }
-  componentDidUpdate(prevProps, prevState) {
-    const {
-      didCatch
-    } = this.state;
-    const {
-      resetKeys
-    } = this.props;
-    if (didCatch && prevState.error !== null && hasArrayChanged(prevProps.resetKeys, resetKeys)) {
-      var _this$props$onReset2, _this$props3;
-      (_this$props$onReset2 = (_this$props3 = this.props).onReset) === null || _this$props$onReset2 === void 0 ? void 0 : _this$props$onReset2.call(_this$props3, {
-        next: resetKeys,
-        prev: prevProps.resetKeys,
-        reason: "keys"
-      });
-      this.setState(initialState);
-    }
-  }
-  render() {
-    const {
-      children,
-      fallbackRender,
-      FallbackComponent,
-      fallback
-    } = this.props;
-    const {
-      didCatch,
-      error
-    } = this.state;
-    let childToRender = children;
-    if (didCatch) {
-      const props = {
-        error,
-        resetErrorBoundary: this.resetErrorBoundary
-      };
-      if (typeof fallbackRender === "function") {
-        childToRender = fallbackRender(props);
-      } else if (FallbackComponent) {
-        childToRender = React.createElement(FallbackComponent, props);
-      } else if (fallback !== void 0) {
-        childToRender = fallback;
-      } else {
-        throw error;
-      }
-    }
-    return React.createElement(ErrorBoundaryContext.Provider, {
-      value: {
-        didCatch,
-        error,
-        resetErrorBoundary: this.resetErrorBoundary
-      }
-    }, childToRender);
-  }
-}
-function hasArrayChanged() {
-  let a = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : [];
-  let b = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : [];
-  return a.length !== b.length || a.some((item, index) => !Object.is(item, b[index]));
-}
 function e() {
   const t = new PopStateEvent("popstate", { state: window.history.state });
   window.dispatchEvent(t);
@@ -146,8 +51,8 @@ const RemoteAppWrapper = React.forwardRef(function(props, ref) {
     providerInfoRef.current = providerReturn;
     setInitialized(true);
     return () => {
-      var _a2, _b, _c, _d, _e, _f, _g, _h;
-      if ((_a2 = providerInfoRef.current) == null ? void 0 : _a2.destroy) {
+      var _a, _b, _c, _d, _e, _f, _g, _h;
+      if ((_a = providerInfoRef.current) == null ? void 0 : _a.destroy) {
         context.LoggerInstance.debug(
           `createRemoteComponent LazyComponent destroy >>>`,
           { moduleName, basename, dom: renderDom.current }
@@ -176,7 +81,7 @@ const RemoteAppWrapper = React.forwardRef(function(props, ref) {
     };
   }, [moduleName]);
   React.useEffect(() => {
-    var _a2, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f;
     if (!initialized || !providerInfoRef.current) return;
     let renderProps = {
       moduleName,
@@ -187,7 +92,7 @@ const RemoteAppWrapper = React.forwardRef(function(props, ref) {
       ...resProps
     };
     renderDom.current = rootRef.current;
-    const beforeBridgeRenderRes = ((_c = (_b = (_a2 = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a2.lifecycle) == null ? void 0 : _b.beforeBridgeRender) == null ? void 0 : _c.emit(renderProps)) || {};
+    const beforeBridgeRenderRes = ((_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.beforeBridgeRender) == null ? void 0 : _c.emit(renderProps)) || {};
     renderProps = { ...renderProps, ...beforeBridgeRenderRes.extraProps };
     providerInfoRef.current.render(renderProps);
     (_f = (_e = (_d = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _d.lifecycle) == null ? void 0 : _e.afterBridgeRender) == null ? void 0 : _f.emit(renderProps);
@@ -197,7 +102,7 @@ const RemoteAppWrapper = React.forwardRef(function(props, ref) {
 });
 function withRouterData(WrappedComponent) {
   const Component = React.forwardRef(function(props, ref) {
-    var _a2;
+    var _a;
     if (props == null ? void 0 : props.basename) {
       return /* @__PURE__ */ React.createElement(WrappedComponent, { ...props, basename: props.basename, ref });
     }
@@ -230,7 +135,7 @@ function withRouterData(WrappedComponent) {
         const match = useRouteMatch == null ? void 0 : useRouteMatch();
         if (useHistory) {
           const history = useHistory == null ? void 0 : useHistory();
-          basename = (_a2 = history == null ? void 0 : history.createHref) == null ? void 0 : _a2.call(history, { pathname: "/" });
+          basename = (_a = history == null ? void 0 : history.createHref) == null ? void 0 : _a.call(history, { pathname: "/" });
         }
         if (match) {
           basename = context.pathJoin(basename, (match == null ? void 0 : match.path) || "/");
@@ -318,13 +223,27 @@ function createLazyRemoteComponent(info) {
 function createRemoteComponent(info) {
   const LazyComponent = createLazyRemoteComponent(info);
   return React.forwardRef((props, ref) => {
-    return /* @__PURE__ */ React.createElement(ErrorBoundary, { FallbackComponent: info.fallback }, /* @__PURE__ */ React.createElement(React.Suspense, { fallback: info.loading }, /* @__PURE__ */ React.createElement(LazyComponent, { ...props, ref })));
+    return /* @__PURE__ */ React.createElement(
+      reactErrorBoundary_esm.ErrorBoundary,
+      {
+        FallbackComponent: info.fallback
+      },
+      /* @__PURE__ */ React.createElement(React.Suspense, { fallback: info.loading }, /* @__PURE__ */ React.createElement(LazyComponent, { ...props, ref }))
+    );
   });
 }
-const isReact18 = (_a = ReactDOM.version) == null ? void 0 : _a.startsWith("18");
-function createRoot(container, options) {
+function defaultCreateRoot(container, options) {
+  const reactVersion = ReactDOM.version || "";
+  const isReact18 = reactVersion.startsWith("18");
   if (isReact18) {
-    return ReactDOM.createRoot(container, options);
+    try {
+      return ReactDOM.createRoot(container, options);
+    } catch (e2) {
+      console.warn(
+        "Failed to use React 18 createRoot API, falling back to legacy API",
+        e2
+      );
+    }
   }
   return {
     render(children) {
@@ -336,7 +255,8 @@ function createRoot(container, options) {
   };
 }
 function createBridgeComponent({
-  createRoot: createRoot$1 = createRoot,
+  createRoot = defaultCreateRoot,
+  defaultRootOptions,
   ...bridgeInfo
 }) {
   return () => {
@@ -360,7 +280,7 @@ function createBridgeComponent({
     };
     return {
       async render(info) {
-        var _a2, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f;
         context.LoggerInstance.debug(`createBridgeComponent render Info`, info);
         const {
           moduleName,
@@ -368,38 +288,46 @@ function createBridgeComponent({
           basename,
           memoryRoute,
           fallback,
+          rootOptions,
           ...propsInfo
         } = info;
-        const beforeBridgeRenderRes = ((_c = (_b = (_a2 = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a2.lifecycle) == null ? void 0 : _b.beforeBridgeRender) == null ? void 0 : _c.emit(info)) || {};
-        const rootComponentWithErrorBoundary = /* @__PURE__ */ React__namespace.createElement(ErrorBoundary, { FallbackComponent: fallback }, /* @__PURE__ */ React__namespace.createElement(
-          RawComponent,
+        const mergedRootOptions = {
+          ...defaultRootOptions,
+          ...rootOptions
+        };
+        const beforeBridgeRenderRes = ((_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.beforeBridgeRender) == null ? void 0 : _c.emit(info)) || {};
+        const rootComponentWithErrorBoundary = /* @__PURE__ */ React__namespace.createElement(
+          reactErrorBoundary_esm.ErrorBoundary,
           {
-            appInfo: {
-              moduleName,
-              basename,
-              memoryRoute
-            },
-            propsInfo: { ...propsInfo, ...beforeBridgeRenderRes == null ? void 0 : beforeBridgeRenderRes.extraProps }
-          }
-        ));
-        if (bridgeInfo.render) {
-          await Promise.resolve(
-            bridgeInfo.render(rootComponentWithErrorBoundary, dom)
-          ).then((root) => rootMap.set(dom, root));
-        } else {
-          let root = rootMap.get(dom);
-          if (!root) {
-            root = createRoot$1(dom);
-            rootMap.set(dom, root);
-          }
-          if ("render" in root) {
-            root.render(rootComponentWithErrorBoundary);
-          }
+            FallbackComponent: fallback
+          },
+          /* @__PURE__ */ React__namespace.createElement(
+            RawComponent,
+            {
+              appInfo: {
+                moduleName,
+                basename,
+                memoryRoute
+              },
+              propsInfo: {
+                ...propsInfo,
+                ...beforeBridgeRenderRes == null ? void 0 : beforeBridgeRenderRes.extraProps
+              }
+            }
+          )
+        );
+        let root = rootMap.get(dom);
+        if (!root) {
+          root = createRoot(dom, mergedRootOptions);
+          rootMap.set(dom, root);
+        }
+        if ("render" in root) {
+          root.render(rootComponentWithErrorBoundary);
         }
         ((_f = (_e = (_d = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _d.lifecycle) == null ? void 0 : _e.afterBridgeRender) == null ? void 0 : _f.emit(info)) || {};
       },
       destroy(info) {
-        var _a2, _b, _c;
+        var _a, _b, _c;
         const { dom } = info;
         context.LoggerInstance.debug(`createBridgeComponent destroy Info`, info);
         const root = rootMap.get(dom);
@@ -407,11 +335,11 @@ function createBridgeComponent({
           if ("unmount" in root) {
             root.unmount();
           } else {
-            ReactDOM.unmountComponentAtNode(root);
+            ReactDOM.unmountComponentAtNode(dom);
           }
           rootMap.delete(dom);
         }
-        (_c = (_b = (_a2 = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a2.lifecycle) == null ? void 0 : _b.afterBridgeDestroy) == null ? void 0 : _c.emit(info);
+        (_c = (_b = (_a = instance == null ? void 0 : instance.bridgeHook) == null ? void 0 : _a.lifecycle) == null ? void 0 : _b.afterBridgeDestroy) == null ? void 0 : _c.emit(info);
       }
     };
   };

package/dist/index.d.ts

@@ -1,7 +1,11 @@
 import { default as default_2 } from 'react';
 import * as React_2 from 'react';
 
-export declare function createBridgeComponent<T>({ createRoot, ...bridgeInfo }: ProviderFnParams<T>): () => {
+/**
+ * Creates a bridge component factory that automatically detects and uses
+ * the appropriate React version (16/17, 18, or 19)
+ */
+export declare function createBridgeComponent<T>({ createRoot, defaultRootOptions, ...bridgeInfo }: ProviderFnParams<T>): () => {
     render(info: RenderParams): Promise<void>;
     destroy(info: DestroyParams): void;
 };
@@ -34,6 +38,16 @@ declare interface ProviderFnParams<T> {
     rootComponent: React_2.ComponentType<T>;
     render?: (App: React_2.ReactElement, id?: HTMLElement | string) => RootType | Promise<RootType>;
     createRoot?: (container: Element | DocumentFragment, options?: CreateRootOptions) => Root;
+    /**
+     * Default options to pass to createRoot for React 18 and 19
+     * These options will be used when creating a root unless overridden by rootOptions in render params
+     * @example
+     * {
+     *   identifierPrefix: 'app-',
+     *   onRecoverableError: (err) => console.error(err)
+     * }
+     */
+    defaultRootOptions?: CreateRootOptions;
 }
 
 /**
@@ -97,6 +111,15 @@ export declare interface RenderParams {
         initialState?: Record<string, unknown>;
     };
     dom: HTMLElement;
+    /**
+     * Options to pass to createRoot for React 18 and 19
+     * @example
+     * {
+     *   identifierPrefix: 'app-',
+     *   onRecoverableError: (err) => console.error(err)
+     * }
+     */
+    rootOptions?: CreateRootOptions;
     [key: string]: unknown;
 }