webpack-bundle-analyzer 5.1.1 → 5.2.0

package/README.md

@@ -45,7 +45,7 @@ This module will help you:
 4. Optimize it!
 
 And the best thing is it supports minified bundles! It parses them to get real size of bundled modules.
-And it also shows their gzipped or Brotli sizes!
+And it also shows their gzipped, Brotli, or Zstandard sizes!
 
 <h2 align="center">Options (for plugin)</h2>
 
@@ -62,7 +62,7 @@ new BundleAnalyzerPlugin(options?: object)
 |**`reportFilename`**|`{String}`|Default: `report.html`. Path to bundle report file that will be generated in `static` mode. It can be either an absolute path or a path relative to a bundle output directory (which is output.path in webpack config).|
 |**`reportTitle`**|`{String\|function}`|Default: function that returns pretty printed current date and time. Content of the HTML `title` element; or a function of the form `() => string` that provides the content.|
 |**`defaultSizes`**|One of: `stat`, `parsed`, `gzip`, `brotli`|Default: `parsed`. Module sizes to show in report by default. [Size definitions](#size-definitions) section describes what these values mean.|
-|**`compressionAlgorithm`**|One of: `gzip`, `brotli`|Default: `gzip`. Compression type used to calculate the compressed module sizes.|
+|**`compressionAlgorithm`**|One of: `gzip`, `brotli`, `zstd`|Default: `gzip`. Compression type used to calculate the compressed module sizes.|
 |**`openAnalyzer`**|`{Boolean}`|Default: `true`. Automatically open report in default browser.|
 |**`generateStatsFile`**|`{Boolean}`|Default: `false`. If `true`, webpack stats JSON file will be generated in bundle output directory|
 |**`statsFilename`**|`{String}`|Default: `stats.json`. Name of webpack stats JSON file that will be generated if `generateStatsFile` is `true`. It can be either an absolute path or a path relative to a bundle output directory (which is output.path in webpack config).|
@@ -122,9 +122,9 @@ Directory containing all generated bundles.
   -r, --report <file>             Path to bundle report file that will be generated in `static` mode. (default: report.html)
   -t, --title <title>             String to use in title element of html report. (default: pretty printed current date)
   -s, --default-sizes <type>      Module sizes to show in treemap by default.
-                                  Possible values: stat, parsed, gzip, brotli (default: parsed)
+                                  Possible values: stat, parsed, gzip, brotli, zstd (default: parsed)
   --compression-algorithm <type>  Compression algorithm that will be used to calculate the compressed module sizes.
-                                  Possible values: gzip, brotli (default: gzip)
+                                  Possible values: gzip, brotli, zstd (default: gzip)
   -O, --no-open                   Don't open report in default browser automatically.
   -e, --exclude <regexp>          Assets that should be excluded from the report.
                                   Can be specified multiple times.
@@ -158,6 +158,10 @@ This is the size of running the parsed bundles/modules through gzip compression.
 
 This is the size of running the parsed bundles/modules through Brotli compression.
 
+### `zstd`
+
+This is the size of running the parsed bundles/modules through Zstandard compression. (Node.js 22.15.0+ is required for this feature)
+
 <h2 align="center">Selecting Which Chunks to Display</h2>
 
 When opened, the report displays all of the Webpack chunks for your project. It's possible to filter to a more specific list of chunks by using the sidebar or the chunk context menu.

package/lib/analyzer.js

@@ -111,6 +111,7 @@ function getViewerData(bundleStats, bundleDir, opts) {
       asset.parsedSize = Buffer.byteLength(assetSources.src);
       if (compressionAlgorithm === 'gzip') asset.gzipSize = getCompressedSize('gzip', assetSources.src);
       if (compressionAlgorithm === 'brotli') asset.brotliSize = getCompressedSize('brotli', assetSources.src);
+      if (compressionAlgorithm === 'zstd') asset.zstdSize = getCompressedSize('zstd', assetSources.src);
     }
 
     // Picking modules from current bundle script
@@ -166,6 +167,7 @@ function getViewerData(bundleStats, bundleDir, opts) {
     parsedSize: asset.parsedSize,
     gzipSize: asset.gzipSize,
     brotliSize: asset.brotliSize,
+    zstdSize: asset.zstdSize,
     groups: Object.values(asset.tree.children).map(i => i.toChartData()),
     isInitialByEntrypoint: chunkToInitialByEntrypoint[filename] ?? {}
   }));

package/lib/bin/analyzer.js

@@ -13,8 +13,11 @@ const analyzer = require('../analyzer');
 const viewer = require('../viewer');
 const Logger = require('../Logger');
 const utils = require('../utils');
+const {
+  isZstdSupported
+} = require('../sizeUtils');
 const SIZES = new Set(['stat', 'parsed', 'gzip']);
-const COMPRESSION_ALGORITHMS = new Set(['gzip', 'brotli']);
+const COMPRESSION_ALGORITHMS = new Set(isZstdSupported ? ['gzip', 'brotli', 'zstd'] : ['gzip', 'brotli']);
 const program = commander.version(require('../../package.json').version).usage(`<bundleStatsFile> [bundleDir] [options]
 
   Arguments:

package/lib/sizeUtils.js

@@ -4,11 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getCompressedSize = getCompressedSize;
+exports.isZstdSupported = void 0;
 const zlib = require('zlib');
+const isZstdSupported = exports.isZstdSupported = 'createZstdCompress' in zlib;
 function getCompressedSize(compressionAlgorithm, input) {
   if (compressionAlgorithm === 'gzip') return zlib.gzipSync(input, {
     level: 9
   }).length;
   if (compressionAlgorithm === 'brotli') return zlib.brotliCompressSync(input).length;
+  if (compressionAlgorithm === 'zstd' && isZstdSupported) {
+    return zlib.zstdCompressSync(input).length;
+  }
   throw new Error(`Unsupported compression algorithm: ${compressionAlgorithm}.`);
 }

package/lib/tree/ConcatenatedModule.js

@@ -25,6 +25,9 @@ class ConcatenatedModule extends _Module.default {
   get brotliSize() {
     return this.getBrotliSize() ?? this.getEstimatedSize('brotliSize');
   }
+  get zstdSize() {
+    return this.getZstdSize() ?? this.getEstimatedSize('zstdSize');
+  }
   getEstimatedSize(sizeType) {
     const parentModuleSize = this.parent[sizeType];
     if (parentModuleSize !== undefined) {

package/lib/tree/ContentFolder.js

@@ -20,6 +20,9 @@ class ContentFolder extends _BaseFolder.default {
   get brotliSize() {
     return this.getSize('brotliSize');
   }
+  get zstdSize() {
+    return this.getSize('zstdSize');
+  }
   getSize(sizeType) {
     const ownerModuleSize = this.ownerModule[sizeType];
     if (ownerModuleSize !== undefined) {
@@ -32,6 +35,7 @@ class ContentFolder extends _BaseFolder.default {
       parsedSize: this.parsedSize,
       gzipSize: this.gzipSize,
       brotliSize: this.brotliSize,
+      zstdSize: this.zstdSize,
       inaccurateSizes: true
     };
   }

package/lib/tree/ContentModule.js

@@ -20,6 +20,9 @@ class ContentModule extends _Module.default {
   get brotliSize() {
     return this.getSize('brotliSize');
   }
+  get zstdSize() {
+    return this.getSize('zstdSize');
+  }
   getSize(sizeType) {
     const ownerModuleSize = this.ownerModule[sizeType];
     if (ownerModuleSize !== undefined) {

package/lib/tree/Folder.js

@@ -24,6 +24,9 @@ class Folder extends _BaseFolder.default {
   get brotliSize() {
     return this.opts.compressionAlgorithm === 'brotli' ? this.getCompressedSize('brotli') : undefined;
   }
+  get zstdSize() {
+    return this.opts.compressionAlgorithm === 'zstd' ? this.getCompressedSize('zstd') : undefined;
+  }
   getCompressedSize(compressionAlgorithm) {
     const key = `_${compressionAlgorithm}Size`;
     if (!Object.prototype.hasOwnProperty.call(this, key)) {
@@ -61,7 +64,8 @@ class Folder extends _BaseFolder.default {
       ...super.toChartData(),
       parsedSize: this.parsedSize,
       gzipSize: this.gzipSize,
-      brotliSize: this.brotliSize
+      brotliSize: this.brotliSize,
+      zstdSize: this.zstdSize
     };
   }
 }

package/lib/tree/Module.js

@@ -20,6 +20,7 @@ class Module extends _Node.default {
     this.data.parsedSrc = value;
     delete this._gzipSize;
     delete this._brotliSize;
+    delete this._zstdSize;
   }
   get size() {
     return this.data.size;
@@ -36,6 +37,9 @@ class Module extends _Node.default {
   get brotliSize() {
     return this.getBrotliSize();
   }
+  get zstdSize() {
+    return this.getZstdSize();
+  }
   getParsedSize() {
     return this.src ? this.src.length : undefined;
   }
@@ -45,6 +49,9 @@ class Module extends _Node.default {
   getBrotliSize() {
     return this.opts.compressionAlgorithm === 'brotli' ? this.getCompressedSize('brotli') : undefined;
   }
+  getZstdSize() {
+    return this.opts.compressionAlgorithm === 'zstd' ? this.getCompressedSize('zstd') : undefined;
+  }
   getCompressedSize(compressionAlgorithm) {
     const key = `_${compressionAlgorithm}Size`;
     if (!(key in this)) {
@@ -68,7 +75,8 @@ class Module extends _Node.default {
       statSize: this.size,
       parsedSize: this.parsedSize,
       gzipSize: this.gzipSize,
-      brotliSize: this.brotliSize
+      brotliSize: this.brotliSize,
+      zstdSize: this.zstdSize
     };
   }
 }

package/lib/viewer.js

@@ -25,7 +25,7 @@ function resolveTitle(reportTitle) {
   }
 }
 function resolveDefaultSizes(defaultSizes, compressionAlgorithm) {
-  if (['gzip', 'brotli'].includes(defaultSizes)) return compressionAlgorithm;
+  if (['gzip', 'brotli', 'zstd'].includes(defaultSizes)) return compressionAlgorithm;
   return defaultSizes;
 }
 module.exports = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webpack-bundle-analyzer",
-  "version": "5.1.1",
+  "version": "5.2.0",
   "description": "Webpack plugin and CLI utility that represents bundle content as convenient interactive zoomable treemap",
   "author": "Yury Grunin <grunin.ya@ya.ru>",
   "license": "MIT",
@@ -42,8 +42,8 @@
     "html-escaper": "^2.0.2",
     "opener": "^1.5.2",
     "picocolors": "^1.0.0",
-    "sirv": "^2.0.3",
-    "ws": "^7.3.1"
+    "sirv": "^3.0.2",
+    "ws": "^8.19.0"
   },
   "devDependencies": {
     "@babel/core": "7.26.9",