webpack-federation-stats-plugin 1.1.1 → 1.1.2

package/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: DanielAmenou

package/README.md

@@ -1,114 +1,50 @@
 # webpack-federation-stats-plugin
 
-[![npm version](https://img.shields.io/npm/v/webpack-federation-stats-plugin)](https://www.npmjs.com/package/webpack-federation-stats-plugin)
-[![npm downloads](https://img.shields.io/npm/dt/webpack-federation-stats-plugin)](https://www.npmjs.com/package/webpack-federation-stats-plugin)
-[![npm monthly downloads](https://img.shields.io/npm/dm/webpack-federation-stats-plugin)](https://www.npmjs.com/package/webpack-federation-stats-plugin)
-[![license](https://img.shields.io/npm/l/webpack-federation-stats-plugin)](https://github.com/DanielAmenou/webpack-federation-stats-plugin/blob/main/LICENSE)
-
-A Webpack plugin that extracts [Module Federation](https://webpack.js.org/concepts/module-federation/) stats into a JSON file. It maps each exposed module to its required chunks, making it useful for tools like [loadable-components](https://loadable-components.com/) that need to know which chunks to load for a given federated module.
-
 ## Installation
 
-```bash
-npm install --save-dev webpack-federation-stats-plugin
-```
+`npm i --save-dev webpack-federation-stats-plugin`
 
-or
-
-```bash
-yarn add --dev webpack-federation-stats-plugin
-```
+`yarn add --dev webpack-federation-stats-plugin`
 
 ## Usage
 
 ```javascript
-const FederationStatsPlugin = require("webpack-federation-stats-plugin")
-
-module.exports = {
-  plugins: [new FederationStatsPlugin()],
-}
-```
-
-> **Note:** The plugin requires `ModuleFederationPlugin` to be configured in the same Webpack config. It will throw an error if it is not found.
-
-## Options
-
-| Option      | Type     | Default                   | Description                                      |
-| ----------- | -------- | ------------------------- | ------------------------------------------------ |
-| `fileName`  | `string` | `"federation-stats.json"` | The name of the output JSON file.                |
-| `publicUrl` | `string` | —                         | An optional public URL to include in the output. |
-
-### Example with options
-
-```javascript
-const FederationStatsPlugin = require("webpack-federation-stats-plugin")
+const FederationStatsPlugin = require("webpack-federation-stats-plugin");
 
 module.exports = {
   plugins: [
-    new FederationStatsPlugin({
-      fileName: "federation-stats.json",
-      publicUrl: "https://cdn.example.com/",
-    }),
+    new FederationStatsPlugin({filename: "federation-stats.json"}),
   ],
-}
+};
 ```
 
-## Output
-
-The plugin generates a JSON file that maps each exposed module to the chunk files it needs at runtime. This is the information a consuming application needs to know **which scripts to load** before importing a federated module.
-
-Given the following Module Federation config:
-
-```javascript
-const {ModuleFederationPlugin} = require("webpack").container
-const FederationStatsPlugin = require("webpack-federation-stats-plugin")
-
-module.exports = {
-  plugins: [
-    new ModuleFederationPlugin({
-      name: "shop",
-      exposes: {
-        "./ProductCard": "./src/components/ProductCard",
-        "./CartIcon": "./src/components/CartIcon",
-        "./useCart": "./src/hooks/useCart",
-      },
-    }),
-    new FederationStatsPlugin(),
-  ],
-}
-```
-
-The plugin will emit a `federation-stats.json` like this:
+### Example Output
 
 ```json
 {
-  "name": "shop",
+  "name": "AppName",
   "exposes": {
-    "ProductCard": ["vendors-node_modules_react-dom_index_js.js", "vendors-node_modules_styled-components_dist_index_js.js", "src_components_ProductCard_index_tsx.js"],
-    "CartIcon": ["vendors-node_modules_react-dom_index_js.js", "src_components_CartIcon_index_tsx.js"],
-    "useCart": ["src_hooks_useCart_ts.js"]
+    "module1": [
+      "vendors-node_modules_babel_runtime_helpers_esm_slicedToArray.js",
+      "vendors-node_modules_core-js.js",
+      "vendors-node_modules_prop-types_index_js.js",
+    ],
+    "module2": ["vendors-node_modules_core-js.js",],
+    "module3": [
+      "vendors-node_modules_babel.js",
+      "vendors-node_modules_core-js.js",
+    ]
   }
 }
-```
 
-Each key under `exposes` corresponds to an exposed module (without the `./` prefix), and its value is the list of chunk files that must be loaded for that module to work.
+```
 
-### With `publicUrl`
+## Support
 
-When a `publicUrl` is provided, it is included in the output so consumers can resolve the full URL for each chunk:
+If you find this project helpful, consider supporting the author:
 
-```json
-{
-  "name": "shop",
-  "publicUrl": "https://cdn.example.com/shop/",
-  "exposes": {
-    "ProductCard": ["vendors-node_modules_react-dom_index_js.js", "vendors-node_modules_styled-components_dist_index_js.js", "src_components_ProductCard_index_tsx.js"],
-    "CartIcon": ["vendors-node_modules_react-dom_index_js.js", "src_components_CartIcon_index_tsx.js"],
-    "useCart": ["src_hooks_useCart_ts.js"]
-  }
-}
-```
+- [GitHub Sponsors](https://github.com/sponsors/DanielAmenou)
 
 ## License
 
-[MIT](LICENSE)
+MIT

package/{FederationStatsPlugin.js → index.js}

@@ -3,18 +3,17 @@ const PLUGIN_NAME = "FederationStatsPlugin"
 const EXTENSION_REGEX = /\.[^/.]+$/
 
 class FederationStatsPlugin {
-  constructor(options = {}) {
-    this._options = {fileName: "federation-stats.json", ...options}
+  constructor(options = {fileName: "federation-stats.json"}) {
+    if (!options || !options.fileName) throw new Error("fileName option is required.")
+    this._options = options
   }
 
   apply(compiler) {
+    const logger = compiler.getInfrastructureLogger(PLUGIN_NAME)
     const federationPlugin = compiler.options.plugins && compiler.options.plugins.find((plugin) => plugin.constructor.name === "ModuleFederationPlugin")
 
     if (!federationPlugin) throw new Error("No ModuleFederationPlugin found.")
 
-    const appName = federationPlugin._options.name
-
-    // get exposed modules from the ModuleFederationPlugin
     const exposedFiles = new Map(Object.entries(federationPlugin._options.exposes || {}).map(([k, v]) => (typeof v === "object" ? [v.import, k] : [v, k])))
 
     compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
@@ -25,9 +24,7 @@ class FederationStatsPlugin {
         },
         async () => {
           const stats = compilation.getStats().toJson({})
-          // find mf modules
-          const mfModules = stats.modules.filter((module) => module.issuerName === "container entry" && exposedFiles.has(module.name.replace(EXTENSION_REGEX, "")))
-
+          const modules = stats.modules.filter((module) => module.issuerName === "container entry" && exposedFiles.has(module.name.replace(EXTENSION_REGEX, "")))
           const chunksReducer = (chunksArr, current) => {
             current.siblings.forEach((s) => {
               const chunk = stats.chunks.find((c) => c.id === s)
@@ -36,21 +33,17 @@ class FederationStatsPlugin {
             current.files.forEach((f) => chunksArr.push(f))
             return chunksArr
           }
-
-          const chunks = mfModules.map((module) => {
+          const chunks = modules.map((module) => {
             const exposedAs = exposedFiles.get(module.name.replace(EXTENSION_REGEX, ""))
-            const chunks = module.chunks
-              .map((chunkId) => stats.chunks.find((chunk) => chunk.id === chunkId))
-              .filter((chunk) => chunk.runtime.includes(appName))
-              .reduce(chunksReducer, [])
+            const chunks = module.chunks.map((chunkId) => stats.chunks.find((chunk) => chunk.id === chunkId)).reduce(chunksReducer, [])
             return {
               module: exposedAs,
               chunks: chunks,
-              id: module.id,
+              id: module.id
             }
           })
 
-          const exposes = chunks.reduce((result, current) => Object.assign(result, {[current.module.replace("./", "")]: current.chunks}), {})
+          const exposes = chunks.reduce((p, c) => Object.assign(p, {[c.module.replace("./", "")]: c.chunks}), {})
           const name = (federationPlugin._options.library && federationPlugin._options.library.name) || federationPlugin._options.name
 
           const statsResult = {
@@ -58,23 +51,18 @@ class FederationStatsPlugin {
             exposes,
           }
 
-          const publicUrl = this._options.publicUrl
-          if (publicUrl) {
-            statsResult.publicUrl = publicUrl
-          }
-
           const fileName = this._options.fileName
           const statsBuffer = Buffer.from(JSON.stringify(statsResult), "utf-8")
-          const mfStats = {
+          const statsSource = {
             source: () => statsBuffer,
             size: () => statsBuffer.length,
           }
 
           const asset = compilation.getAsset(fileName)
           if (asset) {
-            compilation.updateAsset(fileName, mfStats)
+            compilation.updateAsset(fileName, statsSource)
           } else {
-            compilation.emitAsset(fileName, mfStats)
+            compilation.emitAsset(fileName, statsSource)
           }
         }
       )

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "webpack-federation-stats-plugin",
-  "version": "1.1.1",
-  "types": "index.d.ts",
+  "version": "1.1.2",
   "description": "export module federation stats",
-  "main": "FederationStatsPlugin.js",
+  "main": "index.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "publish:beta": "npm version prerelease --preid=beta -m \"beta version - %s\" && npm publish --tag beta",
     "publish:patch": "npm version patch -m \"patch version - %s\" && npm publish",
     "publish:minor": "npm version minor -m \"minor version - %s\" && npm publish",
     "publish:major": "npm version major -m \"major version - %s\" && npm publish",
     "postpublish": "git push && git push --tags"
   },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/DanielAmenou"
+  },
   "homepage": "https://github.com/DanielAmenou/webpack-federation-stats-plugin#readme",
   "repository": {
     "type": "git",
@@ -20,12 +21,8 @@
   "keywords": [
     "webpack",
     "plugin",
-    "module federation",
-    "loadable-components"
+    "module federation"
   ],
   "author": "Daniel Amenou <amenou.daniel@gmail.com>",
-  "license": "MIT",
-  "engines": {
-    "node": ">=22"
-  }
+  "license": "MIT"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 DanielAmenou
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/index.d.ts

@@ -1,14 +0,0 @@
-interface FederationStatsPluginOptions {
-  /** The name of the output JSON file. Defaults to `"federation-stats.json"`. */
-  fileName?: string;
-  /** An optional public URL to include in the output. */
-  publicUrl?: string;
-}
-
-declare class FederationStatsPlugin {
-  constructor(options: FederationStatsPluginOptions);
-
-  apply(compiler: any): void;
-}
-
-export = FederationStatsPlugin;