feat: support Module Federation format

.gitignore

@@ -18,4 +18,6 @@ test-results
 !.vscode/settings.json
 !.vscode/extensions.json
 .idea/
-.nx/
+.nx/
+**/@mf-types
+**/@mf-types/**

examples/module-federation/mf-host/README.md

@@ -0,0 +1,31 @@
+# Rsbuild Project
+
+Module Federation Host Example
+
+## Setup
+
+Install the dependencies:
+
+```bash
+pnpm install
+```
+
+## Get Started
+
+Start the dev server:
+
+```bash
+pnpm dev
+```
+
+Build the app for production:
+
+```bash
+pnpm build
+```
+
+Preview the production build locally:
+
+```bash
+pnpm preview
+```

examples/module-federation/mf-host/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@example/mf-host",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "build": "rsbuild build",
+    "dev": "rsbuild dev",
+    "preview": "rsbuild preview"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@module-federation/rsbuild-plugin": "^0.0.2",
+    "@rsbuild/core": "~1.0.14",
+    "@rsbuild/plugin-react": "^1.0.4",
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.1",
+    "typescript": "^5.6.3"
+  }
+}

examples/module-federation/mf-host/rsbuild.config.ts

@@ -0,0 +1,24 @@
+import { pluginModuleFederation } from '@module-federation/rsbuild-plugin';
+import { defineConfig } from '@rsbuild/core';
+import { pluginReact } from '@rsbuild/plugin-react';
+
+export default defineConfig({
+  plugins: [
+    pluginReact(),
+    pluginModuleFederation({
+      name: 'rsbuild_host',
+      remotes: {
+        rslib: 'rslib@http://localhost:3001/mf/mf-manifest.json',
+      },
+      shared: {
+        react: {
+          singleton: true,
+        },
+        'react-dom': {
+          singleton: true,
+        },
+      },
+      shareStrategy: 'loaded-first',
+    }),
+  ],
+});

examples/module-federation/mf-host/src/App.css

@@ -0,0 +1,26 @@
+body {
+  margin: 0;
+  color: #fff;
+  font-family: Inter, Avenir, Helvetica, Arial, sans-serif;
+  background-image: linear-gradient(to bottom, #020917, #101725);
+}
+
+.content {
+  display: flex;
+  min-height: 100vh;
+  line-height: 1.1;
+  text-align: center;
+  flex-direction: column;
+  justify-content: center;
+}
+
+.content h1 {
+  font-size: 3.6rem;
+  font-weight: 700;
+}
+
+.content p {
+  font-size: 1.2rem;
+  font-weight: 400;
+  opacity: 0.5;
+}

examples/module-federation/mf-host/src/App.tsx

@@ -0,0 +1,14 @@
+import { Counter } from 'rslib';
+import './App.css';
+
+const App = () => {
+  return (
+    <div className="content">
+      <Counter />
+      <h1>Rsbuild with React</h1>
+      <p>Start building amazing things with Rsbuild.</p>
+    </div>
+  );
+};
+
+export default App;

examples/module-federation/mf-host/src/bootstrap.tsx

@@ -0,0 +1,13 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+const rootEl = document.getElementById('root');
+if (rootEl) {
+  const root = ReactDOM.createRoot(rootEl);
+  root.render(
+    <React.StrictMode>
+      <App />
+    </React.StrictMode>,
+  );
+}

examples/module-federation/mf-host/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="@rsbuild/core/types" />

examples/module-federation/mf-host/src/index.ts

@@ -0,0 +1 @@
+import('./bootstrap');

examples/module-federation/mf-host/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["DOM", "ES2020"],
+    "module": "ESNext",
+    "jsx": "react-jsx",
+    "noEmit": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler",
+    "useDefineForClassFields": true,
+    "allowImportingTsExtensions": true,
+    "paths": {
+      "*": ["./@mf-types/*"]
+    }
+  },
+  "include": ["src"]
+}

examples/module-federation/mf-react-component/README.md

@@ -0,0 +1,3 @@
+# @examples/mf-react-component
+
+This example demonstrates how to use Rslib to build a simple Module Federation React component.

examples/module-federation/mf-react-component/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@examples/mf-react-component",
+  "private": true,
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/cjs/index.d.ts"
+    }
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/cjs/index.d.ts",
+  "scripts": {
+    "build": "rslib build",
+    "serve": "pnpm build && http-server -p 3001 ./dist/ --cors"
+  },
+  "devDependencies": {
+    "@module-federation/enhanced": "^0.6.11",
+    "@module-federation/rsbuild-plugin": "^0.0.2",
+    "@rsbuild/plugin-react": "^1.0.4",
+    "@rslib/core": "workspace:*",
+    "@types/react": "^18.3.11",
+    "http-server": "^14.1.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "peerDependencies": {
+    "react": "*"
+  }
+}

examples/module-federation/mf-react-component/rslib.config.ts

@@ -0,0 +1,59 @@
+import { pluginModuleFederation } from '@module-federation/rsbuild-plugin';
+import { pluginReact } from '@rsbuild/plugin-react';
+import { defineConfig } from '@rslib/core';
+
+const shared = {
+  dts: {
+    bundle: false,
+  },
+};
+
+export default defineConfig({
+  lib: [
+    {
+      ...shared,
+      format: 'esm',
+      output: {
+        distPath: {
+          root: './dist/esm',
+        },
+      },
+    },
+    {
+      ...shared,
+      format: 'cjs',
+      output: {
+        distPath: {
+          root: './dist/cjs',
+        },
+      },
+    },
+    {
+      ...shared,
+      format: 'mf',
+      output: {
+        distPath: {
+          root: './dist/mf',
+        },
+        assetPrefix: 'http://localhost:3001/mf',
+      },
+      plugins: [
+        pluginModuleFederation({
+          name: 'rslib_provider',
+          exposes: {
+            '.': './src/index.tsx',
+          },
+          shared: {
+            react: {
+              singleton: true,
+            },
+            'react-dom': {
+              singleton: true,
+            },
+          },
+        }),
+      ],
+    },
+  ],
+  plugins: [pluginReact()],
+});

examples/module-federation/mf-react-component/src/CounterButton.tsx

@@ -0,0 +1,15 @@
+interface CounterButtonProps {
+  onClick: () => void;
+  label: string;
+  [key: string]: any;
+}
+
+export const CounterButton: React.FC<CounterButtonProps> = ({
+  onClick,
+  label,
+  ...props
+}) => (
+  <button type="button" onClick={onClick} {...props}>
+    {label}
+  </button>
+);

examples/module-federation/mf-react-component/src/index.tsx

@@ -0,0 +1,39 @@
+import { init, loadRemote } from '@module-federation/enhanced/runtime';
+import { Suspense, createElement, lazy } from 'react';
+import { CounterButton } from './CounterButton';
+import { useCounter } from './useCounter';
+
+init({
+  name: 'rslib_provider',
+  remotes: [
+    {
+      name: 'mf_remote',
+      entry: 'http://localhost:3002/mf-manifest.json',
+    },
+  ],
+});
+
+export const Counter: React.FC = () => {
+  const { count, increment, decrement } = useCounter();
+
+  return (
+    <div>
+      <Suspense fallback={<div>loading</div>}>
+        {createElement(
+          lazy(
+            () =>
+              loadRemote('mf_remote') as Promise<{
+                default: React.FC;
+              }>,
+          ),
+        )}
+      </Suspense>
+      <h2>
+        <span id="mf-e2e-lib-title">Counter From Rslib MF Format: </span>
+        <span id="mf-e2e-lib-content">{count}</span>
+      </h2>
+      <CounterButton id="mf-e2e-lib-decrease" onClick={decrement} label="-" />
+      <CounterButton id="mf-e2e-lib-increase" onClick={increment} label="+" />
+    </div>
+  );
+};

examples/module-federation/mf-react-component/src/useCounter.tsx

@@ -0,0 +1,10 @@
+import { useState } from 'react';
+
+export const useCounter = (initialValue = 0) => {
+  const [count, setCount] = useState(initialValue);
+
+  const increment = () => setCount((prev) => prev + 1);
+  const decrement = () => setCount((prev) => prev - 1);
+
+  return { count, increment, decrement };
+};

examples/module-federation/mf-react-component/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}

examples/module-federation/mf-remote/README.md

@@ -0,0 +1,31 @@
+# Rsbuild Project
+
+Module Federation Remote Example
+
+## Setup
+
+Install the dependencies:
+
+```bash
+pnpm install
+```
+
+## Get Started
+
+Start the dev server:
+
+```bash
+pnpm dev
+```
+
+Build the app for production:
+
+```bash
+pnpm build
+```
+
+Preview the production build locally:
+
+```bash
+pnpm preview
+```

examples/module-federation/mf-remote/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@example/mf-remote",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "build": "rsbuild build",
+    "dev": "rsbuild dev",
+    "preview": "rsbuild preview"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@module-federation/rsbuild-plugin": "^0.0.2",
+    "@rsbuild/core": "~1.0.14",
+    "@rsbuild/plugin-react": "^1.0.4",
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.1",
+    "typescript": "^5.6.3"
+  }
+}