feat(bridge-plugin): support disable default alias setting in bridge (#3130)

Co-authored-by: squadronai[bot] <170149692+squadronai[bot]@users.noreply.github.com>

Author: danpeen

.changeset/mean-squids-repair.md

@@ -0,0 +1,7 @@
+---
+'@module-federation/enhanced': patch
+'@module-federation/rspack': patch
+'@module-federation/sdk': patch
+---
+
+feat: support disable default alias setting in bridge

apps/router-demo/router-host-2000/rsbuild.config.ts

@@ -33,6 +33,9 @@ export default defineConfig({
         path.join(__dirname, './src/runtime-plugin/shared-strategy.ts'),
         // path.join(__dirname, './src/runtime-plugin/retry.ts'),
       ],
+      // bridge: {
+      //   disableAlias: true,
+      // },
     }),
   ],
 });

packages/enhanced/src/wrapper/ModuleFederationPlugin.ts

@@ -49,7 +49,10 @@ export default class ModuleFederationPlugin implements WebpackPluginInstance {
       '@module-federation/bridge-react',
     );
     // Check whether react exists
-    if (fs.existsSync(reactPath)) {
+    if (
+      fs.existsSync(reactPath) &&
+      (!this._options?.bridge || !this._options.bridge.disableAlias)
+    ) {
       new ReactBridgePlugin({
         moduleFederationOptions: this._options,
       }).apply(compiler);

packages/rspack/src/ModuleFederationPlugin.ts

@@ -127,7 +127,10 @@ export class ModuleFederationPlugin implements RspackPluginInstance {
     );
 
     // Check whether react exists
-    if (fs.existsSync(reactPath)) {
+    if (
+      fs.existsSync(reactPath) &&
+      (!options?.bridge || !options.bridge.disableAlias)
+    ) {
       new ReactBridgePlugin({
         moduleFederationOptions: this._options,
       }).apply(compiler);

packages/sdk/src/types/plugins/ModuleFederationPlugin.ts

@@ -237,6 +237,14 @@ export interface ModuleFederationPluginOptions {
   experiments?: {
     federationRuntime?: false | 'hoisted';
   };
+  bridge?: {
+    /**
+     * Disables the default alias setting in the bridge.
+     * When true, users must manually handle basename through root component props.
+     * @default false
+     */
+    disableAlias?: boolean;
+  };
 }
 /**
  * Modules that should be exposed by this container. Property names are used as public paths.