refactor: ship manifest (#4130)

Author: 2heal1

.changeset/mean-bulldogs-glow.md

@@ -0,0 +1,10 @@
+---
+'@module-federation/rsbuild-plugin': patch
+'@module-federation/enhanced': patch
+'@module-federation/manifest': patch
+'@module-federation/modern-js': patch
+'@module-federation/rspack': patch
+'@module-federation/sdk': patch
+---
+
+refactor(manifest): collect assets from build hook

apps/website-new/docs/en/configure/manifest.mdx

@@ -3,7 +3,10 @@
 - Type: `boolean | PluginManifestOptions`
 - Default value: `undefined`
 
-Used to control whether to generate a manifest and the corresponding generation configuration.
+Controls whether the plugin generates manifest artifacts and how they are produced. When enabled, the plugin emits `mf-manifest.json` and `mf-stats.json` (names can be customized via `fileName`) on every build so that other tools can consume them directly through `processAssets` or from the final build output.
+
+- `mf-stats.json`: captures the full build statistics, including the assets for exposes/shared/remotes, `metaData` (plugin version, build info, `remoteEntry`, etc.), and any additional asset analysis. Ideal for debugging or merging stats across environments.
+- `mf-manifest.json`: a runtime-oriented manifest distilled from the stats. It keeps the stable structure that Module Federation consumers read when loading remote modules. The exposes/shared/remotes entries describe what is actually available to consumers.
 
 The `PluginManifestOptions` types are as follows:
 
@@ -29,6 +32,8 @@ manifest filePath
 
 manifest fileName
 
+If `fileName` is provided, the companion stats file automatically receives a `-stats` suffix (for example, `fileName: 'mf.json'` produces both `mf.json` and `mf-stats.json`). Generated files are written under `filePath` when that option is set.
+
 ## disableAssetsAnalyze
 
 :::warning

apps/website-new/docs/en/guide/troubleshooting/other.mdx

@@ -120,3 +120,14 @@ export default function MFLinkPlugin(): ModuleFederationRuntimePlugin {
   };
 }
 ```
+
+
+## Multiple assets emit different content to the same filename mf-manifest.json
+
+### Reason
+
+In Rspack `1.6.0-beta.0`, we ported the manifest implementation to Rust. Upgrading Rspack without upgrading the MF-related packages will cause this error.
+
+### Solution
+
+Upgrade the `@module-federation` scoped npm package to version 0.21.0 or later.

apps/website-new/docs/zh/configure/manifest.mdx

@@ -3,7 +3,10 @@
 - 类型：`boolean | PluginManifestOptions`
 - 默认值：`undefined`
 
-用于控制是否生成 manifest ，以及对应的生成配置。
+用于控制是否生成 manifest ，以及对应的生成配置。启用后插件会在每次构建中同时产出 `mf-manifest.json` 与 `mf-stats.json`（名称可通过 `fileName` 自定义），并写入到构建产物中，供其他工具在 `processAssets` 钩子或构建结果中直接读取。
+
+- `mf-stats.json`：包含完整的构建统计信息，如 exposes/shared/remotes 的资源列表、`metaData`（插件版本、构建信息、`remoteEntry` 等）以及额外的资产分析结果，适合用于后续合并或诊断。
+- `mf-manifest.json`：在 stats 基础上提炼出的运行时清单，结构稳定，供 Module Federation 消费端在加载远程模块时读取。文件中的 exposes/shared/remotes 对应线上对外暴露的能力。
 
 `PluginManifestOptions` 类型如下：
 
@@ -29,6 +32,8 @@ manifest 存放路径
 
 manifest 文件名称
 
+如果设置了 `fileName`，对应的 stats 文件名会自动附加 `-stats` 后缀（例如 `fileName: 'mf.json'` 时会同时生成 `mf.json` 与 `mf-stats.json`）。所有文件都会写入 `filePath`（若配置）指定的子目录。
+
 ## disableAssetsAnalyze
 
 :::warning

apps/website-new/docs/zh/guide/troubleshooting/other.mdx

@@ -94,3 +94,13 @@ export default function MFLinkPlugin(): ModuleFederationRuntimePlugin {
   };
 }
 ```
+
+## Multiple assets emit different content to the same filename mf-manifest.json
+
+### 原因
+
+在 Rspack `1.6.0-beta.0` 中，我们将 manifest 实现移植到了 Rust 侧，如果升级了 Rspack  而没有升级 MF 相关的 package 则会造成此错误。
+
+### 解决方案
+
+升级 `@module-federation` scope 下的 npm 包至 `0.21.0` 及以上版本。

packages/enhanced/src/lib/container/ModuleFederationPlugin.ts

@@ -234,10 +234,6 @@ class ModuleFederationPlugin implements WebpackPluginInstance {
       this._statsPlugin.apply(compiler);
     }
   }
-
-  get statsResourceInfo() {
-    return this._statsPlugin?.resourceInfo;
-  }
 }
 
 export default ModuleFederationPlugin;

packages/enhanced/src/wrapper/ModuleFederationPlugin.ts

@@ -111,8 +111,4 @@ export default class ModuleFederationPlugin implements WebpackPluginInstance {
       }).apply(compiler);
     }
   }
-
-  get statsResourceInfo(): Partial<ResourceInfo> | undefined {
-    return this._mfPlugin?.statsResourceInfo;
-  }
 }

packages/enhanced/test/configCases/container/manifest-disable-assets-analyze/index.js

@@ -0,0 +1,42 @@
+const fs = __non_webpack_require__('fs');
+const path = __non_webpack_require__('path');
+
+const statsPath = path.join(__dirname, 'mf-stats.json');
+const manifestPath = path.join(__dirname, 'mf-manifest.json');
+
+const stats = JSON.parse(fs.readFileSync(statsPath, 'utf-8'));
+const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+
+it('should still emit the remote entry', () => {
+  const remoteEntryFile = stats.metaData.remoteEntry.name;
+  const remoteEntryPath = path.join(__dirname, remoteEntryFile);
+  expect(fs.existsSync(remoteEntryPath)).toBe(true);
+});
+
+it('should omit asset details from stats when disableAssetsAnalyze is true', () => {
+  expect(stats.shared).toHaveLength(1);
+  expect(stats.shared[0].assets.js.sync).toEqual([]);
+  expect(stats.shared[0].assets.js.async).toEqual([]);
+  expect(stats.exposes).toHaveLength(1);
+  expect(stats.exposes[0].assets.js.sync).toEqual([]);
+  expect(stats.exposes[0].assets.js.async).toEqual([]);
+});
+
+it('should omit asset details from manifest when disableAssetsAnalyze is true', () => {
+  expect(manifest.shared).toHaveLength(1);
+  expect(manifest.shared[0].assets.js.sync).toEqual([]);
+  expect(manifest.shared[0].assets.js.async).toEqual([]);
+  expect(manifest.exposes).toHaveLength(1);
+  expect(manifest.exposes[0].assets.js.sync).toEqual([]);
+  expect(manifest.exposes[0].assets.js.async).toEqual([]);
+});
+
+it('should mark remote usage locations as UNKNOWN', () => {
+  expect(stats.remotes).toEqual(
+    expect.arrayContaining([
+      expect.objectContaining({
+        usedIn: ['UNKNOWN'],
+      }),
+    ]),
+  );
+});

packages/enhanced/test/configCases/container/manifest-disable-assets-analyze/lazy-module.js

@@ -0,0 +1 @@
+export const lazy = true;

packages/enhanced/test/configCases/container/manifest-disable-assets-analyze/module.js

@@ -0,0 +1,11 @@
+import react from 'react';
+import remote from 'remote';
+
+global.react = react;
+global.remote = remote;
+
+import('./lazy-module').then((r) => {
+  console.log('lazy module: ', r);
+});
+
+export const ok = true;