@rushstack/webpack-plugin-utilities 0.5.14 → 0.6.0

package/CHANGELOG.json

@@ -1,6 +1,23 @@
 {
   "name": "@rushstack/webpack-plugin-utilities",
   "entries": [
+    {
+      "version": "0.6.0",
+      "tag": "@rushstack/webpack-plugin-utilities_v0.6.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.5.14",
       "tag": "@rushstack/webpack-plugin-utilities_v0.5.14",

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log - @rushstack/webpack-plugin-utilities
 
-This log was last generated on Sat, 07 Feb 2026 01:13:26 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:04:53 GMT and should not be manually modified.
+
+## 0.6.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
 
 ## 0.5.14
 Sat, 07 Feb 2026 01:13:26 GMT

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.56.2"
+      "packageVersion": "7.56.3"
     }
   ]
 }

package/lib-esm/DetectWebpackVersion.js

@@ -0,0 +1,33 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * We do not have quality API detection between webpack major versions 1-3.
+ * We can detect the absence of hooks which was a version 3 feature.
+ *
+ * @public
+ */
+function isWebpack3OrEarlier(compiler) {
+    return !compiler.hooks;
+}
+/**
+ * Detects whether or not we are using webpack 4
+ *
+ * @public
+ */
+function isWebpack4(compiler) {
+    var _a;
+    const webpackVersion = (_a = compiler === null || compiler === void 0 ? void 0 : compiler.webpack) === null || _a === void 0 ? void 0 : _a.version;
+    return !webpackVersion;
+}
+/**
+ * Detects whether or not we are using webpack 5
+ *
+ * @public
+ */
+function isWebpack5(compiler) {
+    var _a;
+    const webpackVersion = (_a = compiler === null || compiler === void 0 ? void 0 : compiler.webpack) === null || _a === void 0 ? void 0 : _a.version;
+    return !!webpackVersion;
+}
+export { isWebpack3OrEarlier, isWebpack4, isWebpack5 };
+//# sourceMappingURL=DetectWebpackVersion.js.map

package/lib-esm/DetectWebpackVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectWebpackVersion.js","sourceRoot":"","sources":["../src/DetectWebpackVersion.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAW3D;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,QAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,QAA0B;;IAC5C,MAAM,cAAc,GAAuB,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,OAAO,0CAAE,OAAO,CAAC;IACtE,OAAO,CAAC,cAAc,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,QAA0B;;IAC5C,MAAM,cAAc,GAAuB,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,OAAO,0CAAE,OAAO,CAAC;IAEtE,OAAO,CAAC,CAAC,cAAc,CAAC;AAC1B,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * There is no `compiler.version` API available prior to webpack 5,\n * therefore we will have to make some inferences about which major version of webpack we are on.\n * Feature Request: https://github.com/webpack/webpack/issues/15679\n * @description\n */\n\nimport type * as Webpack from 'webpack';\n\n/**\n * We do not have quality API detection between webpack major versions 1-3.\n * We can detect the absence of hooks which was a version 3 feature.\n *\n * @public\n */\nfunction isWebpack3OrEarlier(compiler: Webpack.Compiler): boolean {\n  return !compiler.hooks;\n}\n\n/**\n * Detects whether or not we are using webpack 4\n *\n * @public\n */\nfunction isWebpack4(compiler: Webpack.Compiler): boolean {\n  const webpackVersion: string | undefined = compiler?.webpack?.version;\n  return !webpackVersion;\n}\n\n/**\n * Detects whether or not we are using webpack 5\n *\n * @public\n */\nfunction isWebpack5(compiler: Webpack.Compiler): boolean {\n  const webpackVersion: string | undefined = compiler?.webpack?.version;\n\n  return !!webpackVersion;\n}\n\nexport { isWebpack3OrEarlier, isWebpack4, isWebpack5 };\n"]}

package/lib-esm/Testing.js

@@ -0,0 +1,122 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import path from 'node:path';
+import { createFsFromVolume, Volume } from 'memfs';
+import webpackMerge from 'webpack-merge';
+/**
+ * @public
+ * This function generates a webpack compiler with default configuration and the output filesystem mapped to
+ * a memory filesystem. This is useful for testing webpack plugins/loaders where we do not need to write to disk (which can be costly).
+ * @param entry - The entry point for the webpack compiler
+ * @param additionalConfig - Any additional configuration that should be merged with the default configuration
+ * @param memFs - The memory filesystem to use for the output filesystem. Use this option if you want to _inspect_, analyze, or read the output
+ * files generated by the webpack compiler. If you do not need to do this, you can omit this parameter and the output files.
+ *
+ * @returns - A webpack compiler with the output filesystem mapped to a memory filesystem
+ *
+ * @example
+ * ```typescript
+ * import Testing from '@rushstack/webpack-plugin-utilities';
+ *
+ * describe('MyPlugin', () => {
+ *   it('should run', async () => {
+ *     const stats = await Testing.getTestingWebpackCompiler(
+ *       `./src/index.ts`,
+ *     );
+ *
+ *     expect(stats).toBeDefined();
+ *  });
+ * });
+ * ```
+ *
+ * @remarks
+ * If you want to be able to read, analyze, access the files written to the memory filesystem,
+ * you can pass in a memory filesystem instance to the `memFs` parameter.
+ *
+ * @example
+ * ```typescript
+ * import Testing from '@rushstack/webpack-plugin-utilities';
+ * import { createFsFromVolume, Volume, IFs } from 'memfs';
+ * import path from 'path';
+ *
+ * describe('MyPlugin', () => {
+ *  it('should run', async () => {
+ *    const virtualFileSystem: IFs = createFsFromVolume(new Volume());
+ *    const stats = await Testing.getTestingWebpackCompiler(
+ *      `./src/index.ts`,
+ *      {},
+ *      virtualFileSystem
+ *    );
+ *
+ *    expect(stats).toBeDefined();
+ *    expect(virtualFileSystem.existsSync(path.join(__dirname, 'dist', 'index.js'))).toBe(true);
+ *  });
+ * });
+ * ```
+ */
+export async function getTestingWebpackCompilerAsync(entry, additionalConfig = {}, memFs = createFsFromVolume(new Volume())) {
+    let webpackModule;
+    try {
+        webpackModule = (await import('webpack')).default;
+    }
+    catch (e) {
+        throw new Error('Unable to load module "webpack". The @rushstack/webpack-plugin-utilities package declares "webpack" as ' +
+            'an optional peer dependency, but a function was invoked on it that requires webpack. Make sure ' +
+            `the peer dependency on "webpack" is fulfilled. Inner error: ${e}`);
+    }
+    const compilerOptions = webpackMerge(_defaultWebpackConfig(entry), additionalConfig);
+    const compiler = webpackModule(compilerOptions);
+    // The memFs Volume satisfies the interface contract, but the types aren't happy due to strict null checks
+    const outputFileSystem = memFs;
+    outputFileSystem.join = path.join.bind(path);
+    compiler.outputFileSystem = outputFileSystem;
+    return new Promise((resolve, reject) => {
+        compiler.run((err, stats) => {
+            compiler.close(() => {
+                if (err) {
+                    return reject(err);
+                }
+                _processAndHandleStatsErrorsAndWarnings(stats, reject);
+                resolve(stats);
+            });
+        });
+    });
+}
+function _processAndHandleStatsErrorsAndWarnings(stats, reject) {
+    if ((stats === null || stats === void 0 ? void 0 : stats.hasErrors()) || (stats === null || stats === void 0 ? void 0 : stats.hasWarnings())) {
+        const serializedStats = [stats === null || stats === void 0 ? void 0 : stats.toJson('errors-warnings')];
+        const errors = [];
+        const warnings = [];
+        for (const compilationStats of serializedStats) {
+            if (compilationStats.warnings) {
+                for (const warning of compilationStats.warnings) {
+                    warnings.push(warning);
+                }
+            }
+            if (compilationStats.errors) {
+                for (const error of compilationStats.errors) {
+                    errors.push(error);
+                }
+            }
+            if (compilationStats.children) {
+                for (const child of compilationStats.children) {
+                    serializedStats.push(child);
+                }
+            }
+        }
+        reject([...errors, ...warnings]);
+    }
+}
+function _defaultWebpackConfig(entry = './src') {
+    return {
+        // We don't want to have eval source maps, nor minification
+        // so we set mode to 'none' to disable both. Default is 'production'
+        mode: 'none',
+        context: __dirname,
+        entry,
+        output: {
+            filename: 'test-bundle.js'
+        }
+    };
+}
+//# sourceMappingURL=Testing.js.map

package/lib-esm/Testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Testing.js","sourceRoot":"","sources":["../src/Testing.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport { createFsFromVolume, Volume, type IFs } from 'memfs';\nimport type {\n  StatsCompilation as WebpackStatsCompilation,\n  MultiStats,\n  Stats,\n  Configuration,\n  Compiler,\n  StatsError,\n  OutputFileSystem\n} from 'webpack';\nimport webpackMerge from 'webpack-merge';\n\n/**\n * @public\n * This function generates a webpack compiler with default configuration and the output filesystem mapped to\n * a memory filesystem. This is useful for testing webpack plugins/loaders where we do not need to write to disk (which can be costly).\n * @param entry - The entry point for the webpack compiler\n * @param additionalConfig - Any additional configuration that should be merged with the default configuration\n * @param memFs - The memory filesystem to use for the output filesystem. Use this option if you want to _inspect_, analyze, or read the output\n * files generated by the webpack compiler. If you do not need to do this, you can omit this parameter and the output files.\n *\n * @returns - A webpack compiler with the output filesystem mapped to a memory filesystem\n *\n * @example\n * ```typescript\n * import Testing from '@rushstack/webpack-plugin-utilities';\n *\n * describe('MyPlugin', () => {\n *   it('should run', async () => {\n *     const stats = await Testing.getTestingWebpackCompiler(\n *       `./src/index.ts`,\n *     );\n *\n *     expect(stats).toBeDefined();\n *  });\n * });\n * ```\n *\n * @remarks\n * If you want to be able to read, analyze, access the files written to the memory filesystem,\n * you can pass in a memory filesystem instance to the `memFs` parameter.\n *\n * @example\n * ```typescript\n * import Testing from '@rushstack/webpack-plugin-utilities';\n * import { createFsFromVolume, Volume, IFs } from 'memfs';\n * import path from 'path';\n *\n * describe('MyPlugin', () => {\n *  it('should run', async () => {\n *    const virtualFileSystem: IFs = createFsFromVolume(new Volume());\n *    const stats = await Testing.getTestingWebpackCompiler(\n *      `./src/index.ts`,\n *      {},\n *      virtualFileSystem\n *    );\n *\n *    expect(stats).toBeDefined();\n *    expect(virtualFileSystem.existsSync(path.join(__dirname, 'dist', 'index.js'))).toBe(true);\n *  });\n * });\n * ```\n */\nexport async function getTestingWebpackCompilerAsync(\n  entry: string,\n  additionalConfig: Configuration = {},\n  memFs: IFs = createFsFromVolume(new Volume())\n): Promise<(Stats | MultiStats) | undefined> {\n  let webpackModule: typeof import('webpack');\n  try {\n    webpackModule = (await import('webpack')).default;\n  } catch (e) {\n    throw new Error(\n      'Unable to load module \"webpack\". The @rushstack/webpack-plugin-utilities package declares \"webpack\" as ' +\n        'an optional peer dependency, but a function was invoked on it that requires webpack. Make sure ' +\n        `the peer dependency on \"webpack\" is fulfilled. Inner error: ${e}`\n    );\n  }\n\n  const compilerOptions: Configuration = webpackMerge(_defaultWebpackConfig(entry), additionalConfig);\n  const compiler: Compiler = webpackModule(compilerOptions);\n\n  // The memFs Volume satisfies the interface contract, but the types aren't happy due to strict null checks\n  const outputFileSystem: OutputFileSystem = memFs as unknown as OutputFileSystem;\n  outputFileSystem.join = path.join.bind(path);\n\n  compiler.outputFileSystem = outputFileSystem;\n\n  return new Promise((resolve, reject) => {\n    compiler.run((err, stats) => {\n      compiler.close(() => {\n        if (err) {\n          return reject(err);\n        }\n\n        _processAndHandleStatsErrorsAndWarnings(stats, reject);\n\n        resolve(stats);\n      });\n    });\n  });\n}\n\nfunction _processAndHandleStatsErrorsAndWarnings(\n  stats: Stats | MultiStats | undefined,\n  reject: (reason: unknown) => void\n): void {\n  if (stats?.hasErrors() || stats?.hasWarnings()) {\n    const serializedStats: WebpackStatsCompilation[] = [stats?.toJson('errors-warnings')];\n\n    const errors: StatsError[] = [];\n    const warnings: StatsError[] = [];\n\n    for (const compilationStats of serializedStats) {\n      if (compilationStats.warnings) {\n        for (const warning of compilationStats.warnings) {\n          warnings.push(warning);\n        }\n      }\n\n      if (compilationStats.errors) {\n        for (const error of compilationStats.errors) {\n          errors.push(error);\n        }\n      }\n\n      if (compilationStats.children) {\n        for (const child of compilationStats.children) {\n          serializedStats.push(child);\n        }\n      }\n    }\n\n    reject([...errors, ...warnings]);\n  }\n}\n\nfunction _defaultWebpackConfig(entry: string = './src'): Configuration {\n  return {\n    // We don't want to have eval source maps, nor minification\n    // so we set mode to 'none' to disable both. Default is 'production'\n    mode: 'none',\n    context: __dirname,\n    entry,\n    output: {\n      filename: 'test-bundle.js'\n    }\n  };\n}\n"]}

package/lib-esm/index.js

@@ -0,0 +1,11 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * Utility package which provides a set of tools for working in
+ * webpack plugins, loaders, and other integrations.
+ * @packageDocumentation
+ */
+import * as VersionDetection from './DetectWebpackVersion';
+import * as Testing from './Testing';
+export { VersionDetection, Testing };
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D;;;;GAIG;AAEH,OAAO,KAAK,gBAAgB,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * Utility package which provides a set of tools for working in\n * webpack plugins, loaders, and other integrations.\n * @packageDocumentation\n */\n\nimport * as VersionDetection from './DetectWebpackVersion';\nimport * as Testing from './Testing';\nexport { VersionDetection, Testing };\n"]}

package/package.json

@@ -1,9 +1,30 @@
 {
   "name": "@rushstack/webpack-plugin-utilities",
-  "version": "0.5.14",
+  "version": "0.6.0",
   "description": "This plugin sets the webpack public path at runtime.",
-  "main": "lib/index.js",
-  "typings": "dist/webpack-plugin-utilities.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/webpack-plugin-utilities.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/webpack-plugin-utilities.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -29,10 +50,11 @@
   "devDependencies": {
     "eslint": "~9.37.0",
     "@types/tapable": "1.0.6",
-    "webpack": "~5.105.0",
-    "@rushstack/heft": "1.1.14",
-    "local-node-rig": "1.0.0"
+    "webpack": "~5.105.2",
+    "local-node-rig": "1.0.0",
+    "@rushstack/heft": "1.2.0"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "heft build --clean",
     "_phase:build": "heft run --only build -- --clean"