@rushstack/heft-webpack4-plugin 1.1.14 → 1.2.1

package/CHANGELOG.json

@@ -1,6 +1,64 @@
 {
   "name": "@rushstack/heft-webpack4-plugin",
   "entries": [
+    {
+      "version": "1.2.1",
+      "tag": "@rushstack/heft-webpack4-plugin_v1.2.1",
+      "date": "Fri, 20 Feb 2026 00:15:04 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Add `\"node\"` condition before `\"import\"` in the `\"exports\"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `\"import\"`. Fixes https://github.com/microsoft/rushstack/issues/5644."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/debug-certificate-manager\" to `1.7.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" from `^1.2.0` to `1.2.1`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "1.2.0",
+      "tag": "@rushstack/heft-webpack4-plugin_v1.2.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/debug-certificate-manager\" to `1.7.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" from `^1.1.14` to `1.2.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "1.1.14",
       "tag": "@rushstack/heft-webpack4-plugin_v1.1.14",

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Change Log - @rushstack/heft-webpack4-plugin
 
-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 Fri, 20 Feb 2026 00:15:04 GMT and should not be manually modified.
+
+## 1.2.1
+Fri, 20 Feb 2026 00:15:04 GMT
+
+### Patches
+
+- Add `"node"` condition before `"import"` in the `"exports"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `"import"`. Fixes https://github.com/microsoft/rushstack/issues/5644.
+
+## 1.2.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`.
 
 ## 1.1.14
 Sat, 07 Feb 2026 01:13:26 GMT

package/heft-plugin.json

@@ -4,8 +4,8 @@
   "taskPlugins": [
     {
       "pluginName": "webpack4-plugin",
-      "entryPoint": "./lib/Webpack4Plugin",
-      "optionsSchema": "./lib/schemas/heft-webpack4-plugin.schema.json",
+      "entryPoint": "./lib-commonjs/Webpack4Plugin",
+      "optionsSchema": "./lib-commonjs/schemas/heft-webpack4-plugin.schema.json",
 
       "parameterScope": "webpack4",
       "parameters": [

package/{lib → lib-dts}/tsdoc-metadata.json

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

package/lib-esm/DeferredWatchFileSystem.js

@@ -0,0 +1,120 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import Watchpack from 'watchpack';
+function* contains(source, collection) {
+    for (const item of source) {
+        if (collection.has(item)) {
+            yield item;
+        }
+    }
+}
+export class DeferredWatchFileSystem {
+    constructor(inputFileSystem, onChange) {
+        this.inputFileSystem = inputFileSystem;
+        this.watcherOptions = {
+            aggregateTimeout: 0
+        };
+        this.watcher = new Watchpack(this.watcherOptions);
+        this._onChange = onChange;
+    }
+    flush() {
+        var _a, _b;
+        const state = this._state;
+        if (!state) {
+            return false;
+        }
+        const { files, dirs, missing, changes, removals, callback } = state;
+        const { changes: aggregatedChanges, removals: aggregatedRemovals } = this.watcher.getAggregated();
+        // Webpack 4 treats changes as a superset of removals
+        for (const removal of aggregatedRemovals) {
+            changes.add(removal);
+            removals.add(removal);
+        }
+        for (const change of aggregatedChanges) {
+            removals.delete(change);
+            changes.add(change);
+        }
+        if (changes.size > 0) {
+            (_b = (_a = this.inputFileSystem).purge) === null || _b === void 0 ? void 0 : _b.call(_a, Array.from(changes));
+            const filteredRemovals = new Set(contains(removals, files));
+            const changedFiles = Array.from(contains(changes, files)).sort();
+            const changedDirs = Array.from(contains(changes, dirs)).sort();
+            const changedMissing = Array.from(contains(changes, missing)).sort();
+            const times = new Map(Object.entries(this.watcher.getTimes()));
+            callback(undefined, changedFiles, changedDirs, changedMissing, times, times, filteredRemovals);
+            changes.clear();
+            removals.clear();
+            return true;
+        }
+        return false;
+    }
+    watch(files, directories, missing, startTime, options, callback, callbackUndelayed) {
+        const oldWatcher = this.watcher;
+        const watcher = (this.watcher = new Watchpack(options));
+        const changes = new Set();
+        const removals = new Set();
+        this._state = {
+            files: new Set(files),
+            dirs: new Set(directories),
+            missing: new Set(missing),
+            changes,
+            removals,
+            callback
+        };
+        watcher.once('aggregated', (newChanges, newRemovals) => {
+            watcher.pause();
+            for (const change of newChanges) {
+                changes.add(change);
+            }
+            for (const removal of newRemovals) {
+                changes.add(removal);
+                removals.add(removal);
+            }
+            this._onChange();
+        });
+        watcher.watch({
+            files,
+            directories,
+            missing,
+            startTime
+        });
+        if (oldWatcher) {
+            oldWatcher.close();
+        }
+        return {
+            close: () => {
+                if (this.watcher) {
+                    this.watcher.close();
+                    this.watcher = undefined;
+                }
+            },
+            pause: () => {
+                if (this.watcher) {
+                    this.watcher.pause();
+                }
+            },
+            getFileTimestamps: () => {
+                var _a;
+                const timestamps = (_a = this.watcher) === null || _a === void 0 ? void 0 : _a.getTimes();
+                return timestamps ? new Map(Object.entries(timestamps)) : new Map();
+            },
+            getContextTimestamps: () => {
+                var _a;
+                const timestamps = (_a = this.watcher) === null || _a === void 0 ? void 0 : _a.getTimes();
+                return timestamps ? new Map(Object.entries(timestamps)) : new Map();
+            }
+        };
+    }
+}
+export class OverrideNodeWatchFSPlugin {
+    constructor(onChange) {
+        this.fileSystems = new Set();
+        this._onChange = onChange;
+    }
+    apply(compiler) {
+        const watchFileSystem = new DeferredWatchFileSystem(compiler.inputFileSystem, this._onChange);
+        this.fileSystems.add(watchFileSystem);
+        compiler.watchFileSystem = watchFileSystem;
+    }
+}
+//# sourceMappingURL=DeferredWatchFileSystem.js.map

package/lib-esm/DeferredWatchFileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredWatchFileSystem.js","sourceRoot":"","sources":["../src/DeferredWatchFileSystem.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 Watchpack, { type WatchOptions } from 'watchpack';\nimport type { Compiler, Plugin } from 'webpack';\n\nexport interface IPurgeable {\n  purge?: (changes: string[]) => void;\n}\n\nexport interface IWatchCallback {\n  (\n    err: Error | undefined,\n    files: string[],\n    dirs: string[],\n    missing: string[],\n    fileTimes: Map<string, number>,\n    dirTimes: Map<string, number>,\n    removals: Set<string>\n  ): void;\n}\n\nexport interface IWatchUndelayedCallback {\n  (path: string, mtime: number): void;\n}\n\nexport interface IWatch {\n  close(): void;\n  pause(): void;\n  getFileTimestamps(): Map<string, number>;\n  getContextTimestamps(): Map<string, number>;\n}\n\nfunction* contains<T>(source: Iterable<T>, collection: ReadonlySet<T>): IterableIterator<T> {\n  for (const item of source) {\n    if (collection.has(item)) {\n      yield item;\n    }\n  }\n}\n\ninterface IWatchState {\n  files: Set<string>;\n  dirs: Set<string>;\n  missing: Set<string>;\n\n  changes: Set<string>;\n  removals: Set<string>;\n\n  callback: IWatchCallback;\n}\n\nexport interface IWatchFileSystem {\n  watch(\n    files: string[],\n    directories: string[],\n    missing: string[],\n    startTime: number,\n    options: WatchOptions,\n    callback: IWatchCallback,\n    callbackUndelayed: IWatchUndelayedCallback\n  ): IWatch;\n}\n\nexport class DeferredWatchFileSystem implements IWatchFileSystem {\n  public readonly inputFileSystem: IPurgeable;\n  public readonly watcherOptions: WatchOptions;\n  public watcher: Watchpack | undefined;\n\n  private readonly _onChange: () => void;\n  private _state: IWatchState | undefined;\n\n  public constructor(inputFileSystem: IPurgeable, onChange: () => void) {\n    this.inputFileSystem = inputFileSystem;\n    this.watcherOptions = {\n      aggregateTimeout: 0\n    };\n    this.watcher = new Watchpack(this.watcherOptions);\n    this._onChange = onChange;\n  }\n\n  public flush(): boolean {\n    const state: IWatchState | undefined = this._state;\n\n    if (!state) {\n      return false;\n    }\n\n    const { files, dirs, missing, changes, removals, callback } = state;\n\n    const { changes: aggregatedChanges, removals: aggregatedRemovals } = this.watcher!.getAggregated();\n\n    // Webpack 4 treats changes as a superset of removals\n    for (const removal of aggregatedRemovals) {\n      changes.add(removal);\n      removals.add(removal);\n    }\n    for (const change of aggregatedChanges) {\n      removals.delete(change);\n      changes.add(change);\n    }\n\n    if (changes.size > 0) {\n      this.inputFileSystem.purge?.(Array.from(changes));\n\n      const filteredRemovals: Set<string> = new Set(contains(removals, files));\n      const changedFiles: string[] = Array.from(contains(changes, files)).sort();\n      const changedDirs: string[] = Array.from(contains(changes, dirs)).sort();\n      const changedMissing: string[] = Array.from(contains(changes, missing)).sort();\n\n      const times: Map<string, number> = new Map(Object.entries(this.watcher!.getTimes()));\n\n      callback(undefined, changedFiles, changedDirs, changedMissing, times, times, filteredRemovals);\n\n      changes.clear();\n      removals.clear();\n\n      return true;\n    }\n\n    return false;\n  }\n\n  public watch(\n    files: string[],\n    directories: string[],\n    missing: string[],\n    startTime: number,\n    options: WatchOptions,\n    callback: IWatchCallback,\n    callbackUndelayed: IWatchUndelayedCallback\n  ): IWatch {\n    const oldWatcher: Watchpack | undefined = this.watcher;\n    const watcher: Watchpack = (this.watcher = new Watchpack(options));\n\n    const changes: Set<string> = new Set();\n    const removals: Set<string> = new Set();\n\n    this._state = {\n      files: new Set(files),\n      dirs: new Set(directories),\n      missing: new Set(missing),\n\n      changes,\n      removals,\n\n      callback\n    };\n\n    watcher.once('aggregated', (newChanges: Set<string>, newRemovals: Set<string>) => {\n      watcher.pause();\n\n      for (const change of newChanges) {\n        changes.add(change);\n      }\n      for (const removal of newRemovals) {\n        changes.add(removal);\n        removals.add(removal);\n      }\n\n      this._onChange();\n    });\n\n    watcher.watch({\n      files,\n      directories,\n      missing,\n      startTime\n    });\n\n    if (oldWatcher) {\n      oldWatcher.close();\n    }\n\n    return {\n      close: () => {\n        if (this.watcher) {\n          this.watcher.close();\n          this.watcher = undefined;\n        }\n      },\n      pause: () => {\n        if (this.watcher) {\n          this.watcher.pause();\n        }\n      },\n      getFileTimestamps: () => {\n        const timestamps: Record<string, number> | undefined = this.watcher?.getTimes();\n        return timestamps ? new Map(Object.entries(timestamps)) : new Map();\n      },\n      getContextTimestamps: () => {\n        const timestamps: Record<string, number> | undefined = this.watcher?.getTimes();\n        return timestamps ? new Map(Object.entries(timestamps)) : new Map();\n      }\n    };\n  }\n}\n\nexport class OverrideNodeWatchFSPlugin implements Plugin {\n  public readonly fileSystems: Set<DeferredWatchFileSystem> = new Set();\n  private readonly _onChange: () => void;\n\n  public constructor(onChange: () => void) {\n    this._onChange = onChange;\n  }\n\n  public apply(compiler: Compiler): void {\n    const watchFileSystem: DeferredWatchFileSystem = new DeferredWatchFileSystem(\n      compiler.inputFileSystem,\n      this._onChange\n    );\n    this.fileSystems.add(watchFileSystem);\n    (compiler as { watchFileSystem?: IWatchFileSystem }).watchFileSystem = watchFileSystem;\n  }\n}\n"]}

package/lib-esm/Webpack4Plugin.js

@@ -0,0 +1,326 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { AsyncParallelHook, AsyncSeriesBailHook, AsyncSeriesHook } from 'tapable';
+import { CertificateManager } from '@rushstack/debug-certificate-manager';
+import { InternalError, LegacyAdapters } from '@rushstack/node-core-library';
+import { PLUGIN_NAME } from './shared';
+import { tryLoadWebpackConfigurationAsync } from './WebpackConfigurationLoader';
+import { OverrideNodeWatchFSPlugin } from './DeferredWatchFileSystem';
+const SERVE_PARAMETER_LONG_NAME = '--serve';
+const WEBPACK_PACKAGE_NAME = 'webpack';
+const WEBPACK_DEV_SERVER_PACKAGE_NAME = 'webpack-dev-server';
+const WEBPACK_DEV_SERVER_ENV_VAR_NAME = 'WEBPACK_DEV_SERVER';
+const WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME = 'webpack-dev-middleware';
+/**
+ * @internal
+ */
+export default class Webpack4Plugin {
+    constructor() {
+        this._isServeMode = false;
+        this._webpackConfiguration = false;
+        this._warnings = [];
+        this._errors = [];
+    }
+    get accessor() {
+        if (!this._accessor) {
+            this._accessor = {
+                hooks: _createAccessorHooks(),
+                parameters: {
+                    isServeMode: this._isServeMode
+                }
+            };
+        }
+        return this._accessor;
+    }
+    apply(taskSession, heftConfiguration, options = {}) {
+        this._isServeMode = taskSession.parameters.getFlagParameter(SERVE_PARAMETER_LONG_NAME).value;
+        if (!taskSession.parameters.watch && this._isServeMode) {
+            throw new Error(`The ${JSON.stringify(SERVE_PARAMETER_LONG_NAME)} parameter is only available when running in watch mode.`);
+        }
+        taskSession.hooks.run.tapPromise(PLUGIN_NAME, async (runOptions) => {
+            await this._runWebpackAsync(taskSession, heftConfiguration, options);
+        });
+        taskSession.hooks.runIncremental.tapPromise(PLUGIN_NAME, async (runOptions) => {
+            await this._runWebpackWatchAsync(taskSession, heftConfiguration, options, runOptions.requestRun);
+        });
+    }
+    async _getWebpackConfigurationAsync(taskSession, heftConfiguration, options, requestRun) {
+        if (this._webpackConfiguration === false) {
+            const webpackConfiguration = await tryLoadWebpackConfigurationAsync({
+                taskSession,
+                heftConfiguration,
+                hooks: this.accessor.hooks,
+                serveMode: this._isServeMode,
+                loadWebpackAsyncFn: this._loadWebpackAsync.bind(this)
+            }, options);
+            if (webpackConfiguration && requestRun) {
+                const overrideWatchFSPlugin = new OverrideNodeWatchFSPlugin(requestRun);
+                this._watchFileSystems = overrideWatchFSPlugin.fileSystems;
+                for (const config of Array.isArray(webpackConfiguration)
+                    ? webpackConfiguration
+                    : [webpackConfiguration]) {
+                    if (!config.plugins) {
+                        config.plugins = [overrideWatchFSPlugin];
+                    }
+                    else {
+                        config.plugins.unshift(overrideWatchFSPlugin);
+                    }
+                }
+            }
+            this._webpackConfiguration = webpackConfiguration;
+        }
+        return this._webpackConfiguration;
+    }
+    async _loadWebpackAsync() {
+        if (!this._webpack) {
+            // Allow this to fail if webpack is not installed
+            this._webpack = await import(WEBPACK_PACKAGE_NAME);
+        }
+        return this._webpack;
+    }
+    async _getWebpackCompilerAsync(taskSession, webpackConfiguration) {
+        if (!this._webpackCompiler) {
+            const webpack = await this._loadWebpackAsync();
+            taskSession.logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);
+            this._webpackCompiler = Array.isArray(webpackConfiguration)
+                ? webpack.default(webpackConfiguration) /* (webpack.Compilation[]) => MultiCompiler */
+                : webpack.default(webpackConfiguration); /* (webpack.Compilation) => Compiler */
+        }
+        return this._webpackCompiler;
+    }
+    async _runWebpackAsync(taskSession, heftConfiguration, options) {
+        this._validateEnvironmentVariable(taskSession);
+        if (taskSession.parameters.watch || this._isServeMode) {
+            // Should never happen, but just in case
+            throw new InternalError('Cannot run Webpack in compilation mode when watch mode is enabled');
+        }
+        // Load the config and compiler, and return if there is no config found
+        const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);
+        if (!webpackConfiguration) {
+            return;
+        }
+        const compiler = await this._getWebpackCompilerAsync(taskSession, webpackConfiguration);
+        taskSession.logger.terminal.writeLine('Running Webpack compilation');
+        // Run the webpack compiler
+        let stats;
+        try {
+            stats = await LegacyAdapters.convertCallbackToPromise(compiler.run.bind(compiler));
+        }
+        catch (e) {
+            taskSession.logger.emitError(e);
+        }
+        // Emit the errors from the stats object, if present
+        if (stats) {
+            this._recordErrors(stats);
+            if (this.accessor.hooks.onEmitStats.isUsed()) {
+                await this.accessor.hooks.onEmitStats.promise(stats);
+            }
+            this._emitErrors(taskSession.logger);
+        }
+    }
+    async _runWebpackWatchAsync(taskSession, heftConfiguration, options, requestRun) {
+        var _a;
+        // Save a handle to the original promise, since the this-scoped promise will be replaced whenever
+        // the compilation completes.
+        let webpackCompilationDonePromise = this._webpackCompilationDonePromise;
+        let isInitial = false;
+        if (!this._webpackCompiler) {
+            isInitial = true;
+            this._validateEnvironmentVariable(taskSession);
+            if (!taskSession.parameters.watch) {
+                // Should never happen, but just in case
+                throw new InternalError('Cannot run Webpack in watch mode when compilation mode is enabled');
+            }
+            // Load the config and compiler, and return if there is no config found
+            const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options, requestRun);
+            if (!webpackConfiguration) {
+                return;
+            }
+            // Get the compiler which will be used for both serve and watch mode
+            const compiler = await this._getWebpackCompilerAsync(taskSession, webpackConfiguration);
+            // Set up the hook to detect when the watcher completes the watcher compilation. We will also log out
+            // errors from the compilation if present from the output stats object.
+            this._webpackCompilationDonePromise = new Promise((resolve) => {
+                this._webpackCompilationDonePromiseResolveFn = resolve;
+            });
+            webpackCompilationDonePromise = this._webpackCompilationDonePromise;
+            compiler.hooks.done.tap(PLUGIN_NAME, (stats) => {
+                this._webpackCompilationDonePromiseResolveFn();
+                this._webpackCompilationDonePromise = new Promise((resolve) => {
+                    this._webpackCompilationDonePromiseResolveFn = resolve;
+                });
+                if (stats) {
+                    this._recordErrors(stats);
+                }
+            });
+            // Determine how we will run the compiler. When serving, we will run the compiler
+            // via the webpack-dev-server. Otherwise, we will run the compiler directly.
+            if (this._isServeMode) {
+                const defaultDevServerOptions = {
+                    host: 'localhost',
+                    devMiddleware: {
+                        publicPath: '/',
+                        stats: {
+                            cached: false,
+                            cachedAssets: false,
+                            colors: heftConfiguration.terminalProvider.supportsColor
+                        }
+                    },
+                    client: {
+                        logging: 'info',
+                        webSocketURL: {
+                            port: 8080
+                        }
+                    },
+                    port: 8080,
+                    onListening: (server) => {
+                        var _a;
+                        const addressInfo = (_a = server.server) === null || _a === void 0 ? void 0 : _a.address();
+                        if (addressInfo) {
+                            const address = typeof addressInfo === 'string' ? addressInfo : `${addressInfo.address}:${addressInfo.port}`;
+                            taskSession.logger.terminal.writeLine(`Started Webpack Dev Server at https://${address}`);
+                        }
+                    }
+                };
+                // Obtain the devServerOptions from the webpack configuration, and combine with the default options
+                let devServerOptions;
+                if (Array.isArray(webpackConfiguration)) {
+                    const filteredDevServerOptions = webpackConfiguration
+                        .map((configuration) => configuration.devServer)
+                        .filter((devServer) => !!devServer);
+                    if (filteredDevServerOptions.length > 1) {
+                        taskSession.logger.emitWarning(new Error(`Detected multiple webpack devServer configurations, using the first one.`));
+                    }
+                    devServerOptions = { ...defaultDevServerOptions, ...filteredDevServerOptions[0] };
+                }
+                else {
+                    devServerOptions = { ...defaultDevServerOptions, ...webpackConfiguration.devServer };
+                }
+                // Add the certificate and key to the devServerOptions if these fields don't already have values
+                if (!devServerOptions.server) {
+                    const certificateManager = new CertificateManager();
+                    const certificate = await certificateManager.ensureCertificateAsync(true, taskSession.logger.terminal);
+                    // Update the web socket URL to use the hostname provided by the certificate
+                    const clientConfiguration = devServerOptions.client;
+                    const hostname = (_a = certificate.subjectAltNames) === null || _a === void 0 ? void 0 : _a[0];
+                    if (hostname && typeof clientConfiguration === 'object') {
+                        const { webSocketURL } = clientConfiguration;
+                        if (typeof webSocketURL === 'object') {
+                            clientConfiguration.webSocketURL = {
+                                ...webSocketURL,
+                                hostname
+                            };
+                        }
+                    }
+                    devServerOptions = {
+                        ...devServerOptions,
+                        server: {
+                            type: 'https',
+                            options: {
+                                minVersion: 'TLSv1.3',
+                                key: certificate.pemKey,
+                                cert: certificate.pemCertificate,
+                                ca: certificate.pemCaCertificate
+                            }
+                        }
+                    };
+                }
+                // Since the webpack-dev-server does not return infrastructure errors via a callback like
+                // compiler.watch(...), we will need to intercept them and log them ourselves.
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                compiler.hooks.infrastructureLog.tap(PLUGIN_NAME, (name, type, args) => {
+                    if (name === WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME && type === 'error') {
+                        const error = args[0];
+                        if (error) {
+                            taskSession.logger.emitError(error);
+                        }
+                    }
+                    return true;
+                });
+                // The webpack-dev-server package has a design flaw, where merely loading its package will set the
+                // WEBPACK_DEV_SERVER environment variable -- even if no APIs are accessed. This environment variable
+                // causes incorrect behavior if Heft is not running in serve mode. Thus, we need to be careful to call
+                // require() only if Heft is in serve mode.
+                taskSession.logger.terminal.writeLine('Starting webpack-dev-server');
+                const WebpackDevServer = (await import(WEBPACK_DEV_SERVER_PACKAGE_NAME))
+                    .default;
+                const webpackDevServer = new WebpackDevServer(devServerOptions, compiler);
+                await webpackDevServer.start();
+            }
+            else {
+                // Create the watcher. Compilation will start immediately after invoking watch().
+                taskSession.logger.terminal.writeLine('Starting Webpack watcher');
+                compiler.watch({}, (error) => {
+                    if (error) {
+                        taskSession.logger.emitError(error);
+                    }
+                });
+            }
+        }
+        let hasChanges = true;
+        if (!isInitial && this._watchFileSystems) {
+            hasChanges = false;
+            for (const watchFileSystem of this._watchFileSystems) {
+                hasChanges = watchFileSystem.flush() || hasChanges;
+            }
+        }
+        // Resume the compilation, wait for the compilation to complete, then suspend the watchers until the
+        // next iteration. Even if there are no changes, the promise should resolve since resuming from a
+        // suspended state invalidates the state of the watcher.
+        if (hasChanges) {
+            taskSession.logger.terminal.writeLine('Running incremental Webpack compilation');
+            await webpackCompilationDonePromise;
+        }
+        else {
+            taskSession.logger.terminal.writeLine('Webpack has not detected changes. Listing previous diagnostics.');
+        }
+        this._emitErrors(taskSession.logger);
+    }
+    _validateEnvironmentVariable(taskSession) {
+        if (!this._isServeMode && process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {
+            taskSession.logger.emitWarning(new Error(`The "${WEBPACK_DEV_SERVER_ENV_VAR_NAME}" environment variable is set, ` +
+                'which will cause problems when webpack is not running in serve mode. ' +
+                `(Did a dependency inadvertently load the "${WEBPACK_DEV_SERVER_PACKAGE_NAME}" package?)`));
+        }
+    }
+    _emitErrors(logger) {
+        for (const warning of this._warnings) {
+            logger.emitWarning(warning);
+        }
+        for (const error of this._errors) {
+            logger.emitError(error);
+        }
+    }
+    _recordErrors(stats) {
+        this._errors.length = 0;
+        this._warnings.length = 0;
+        if (stats.hasErrors() || stats.hasWarnings()) {
+            const serializedStats = [stats.toJson('errors-warnings')];
+            for (const compilationStats of serializedStats) {
+                for (const warning of compilationStats.warnings) {
+                    this._warnings.push(warning instanceof Error ? warning : new Error(warning));
+                }
+                for (const error of compilationStats.errors) {
+                    this._errors.push(error instanceof Error ? error : new Error(error));
+                }
+                if (compilationStats.children) {
+                    for (const child of compilationStats.children) {
+                        serializedStats.push(child);
+                    }
+                }
+            }
+        }
+    }
+}
+/**
+ * @internal
+ */
+export function _createAccessorHooks() {
+    return {
+        onLoadConfiguration: new AsyncSeriesBailHook(),
+        onConfigure: new AsyncSeriesHook(['webpackConfiguration']),
+        onAfterConfigure: new AsyncParallelHook(['webpackConfiguration']),
+        onEmitStats: new AsyncParallelHook(['webpackStats'])
+    };
+}
+//# sourceMappingURL=Webpack4Plugin.js.map

package/lib-esm/Webpack4Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webpack4Plugin.js","sourceRoot":"","sources":["../src/Webpack4Plugin.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 type { AddressInfo } from 'node:net';\n\nimport type * as TWebpack from 'webpack';\nimport type TWebpackDevServer from 'webpack-dev-server';\nimport { AsyncParallelHook, AsyncSeriesBailHook, AsyncSeriesHook, type SyncBailHook } from 'tapable';\n\nimport { CertificateManager, type ICertificate } from '@rushstack/debug-certificate-manager';\nimport { InternalError, LegacyAdapters } from '@rushstack/node-core-library';\nimport type {\n  HeftConfiguration,\n  IHeftTaskSession,\n  IHeftTaskPlugin,\n  IHeftTaskRunHookOptions,\n  IScopedLogger,\n  IHeftTaskRunIncrementalHookOptions\n} from '@rushstack/heft';\n\nimport {\n  PLUGIN_NAME,\n  type IWebpackConfiguration,\n  type IWebpackPluginAccessor,\n  type IWebpackPluginAccessorHooks\n} from './shared';\nimport { tryLoadWebpackConfigurationAsync } from './WebpackConfigurationLoader';\nimport {\n  type DeferredWatchFileSystem,\n  type IWatchFileSystem,\n  OverrideNodeWatchFSPlugin\n} from './DeferredWatchFileSystem';\n\ntype ExtendedWatching = TWebpack.Watching & {\n  resume: () => void;\n  suspend: () => void;\n};\n\ntype ExtendedMultiWatching = TWebpack.MultiWatching & {\n  resume: () => void;\n  suspend: () => void;\n};\n\ntype ExtendedCompiler = TWebpack.Compiler & {\n  hooks: TWebpack.Compiler['hooks'] & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    infrastructureLog: SyncBailHook<string, string, any[]>;\n  };\n  watching: ExtendedWatching;\n  watchFileSystem: IWatchFileSystem;\n};\n\ntype ExtendedMultiCompiler = TWebpack.MultiCompiler & {\n  compilers: ExtendedCompiler[];\n  hooks: TWebpack.MultiCompiler['hooks'] & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    infrastructureLog: SyncBailHook<string, string, any[]>;\n  };\n  watching: ExtendedMultiWatching;\n};\n\nexport interface IWebpackPluginOptions {\n  devConfigurationPath?: string | undefined;\n  configurationPath?: string | undefined;\n}\n\nconst SERVE_PARAMETER_LONG_NAME: '--serve' = '--serve';\nconst WEBPACK_PACKAGE_NAME: 'webpack' = 'webpack';\nconst WEBPACK_DEV_SERVER_PACKAGE_NAME: 'webpack-dev-server' = 'webpack-dev-server';\nconst WEBPACK_DEV_SERVER_ENV_VAR_NAME: 'WEBPACK_DEV_SERVER' = 'WEBPACK_DEV_SERVER';\nconst WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME: 'webpack-dev-middleware' = 'webpack-dev-middleware';\n\n/**\n * @internal\n */\nexport default class Webpack4Plugin implements IHeftTaskPlugin<IWebpackPluginOptions> {\n  private _accessor: IWebpackPluginAccessor | undefined;\n  private _isServeMode: boolean = false;\n  private _webpack: typeof TWebpack | undefined;\n  private _webpackCompiler: ExtendedCompiler | ExtendedMultiCompiler | undefined;\n  private _webpackConfiguration: IWebpackConfiguration | undefined | false = false;\n  private _webpackCompilationDonePromise: Promise<void> | undefined;\n  private _webpackCompilationDonePromiseResolveFn: (() => void) | undefined;\n  private _watchFileSystems: Set<DeferredWatchFileSystem> | undefined;\n\n  private _warnings: Error[] = [];\n  private _errors: Error[] = [];\n\n  public get accessor(): IWebpackPluginAccessor {\n    if (!this._accessor) {\n      this._accessor = {\n        hooks: _createAccessorHooks(),\n        parameters: {\n          isServeMode: this._isServeMode\n        }\n      };\n    }\n    return this._accessor;\n  }\n\n  public apply(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions = {}\n  ): void {\n    this._isServeMode = taskSession.parameters.getFlagParameter(SERVE_PARAMETER_LONG_NAME).value;\n    if (!taskSession.parameters.watch && this._isServeMode) {\n      throw new Error(\n        `The ${JSON.stringify(\n          SERVE_PARAMETER_LONG_NAME\n        )} parameter is only available when running in watch mode.`\n      );\n    }\n\n    taskSession.hooks.run.tapPromise(PLUGIN_NAME, async (runOptions: IHeftTaskRunHookOptions) => {\n      await this._runWebpackAsync(taskSession, heftConfiguration, options);\n    });\n\n    taskSession.hooks.runIncremental.tapPromise(\n      PLUGIN_NAME,\n      async (runOptions: IHeftTaskRunIncrementalHookOptions) => {\n        await this._runWebpackWatchAsync(taskSession, heftConfiguration, options, runOptions.requestRun);\n      }\n    );\n  }\n\n  private async _getWebpackConfigurationAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions,\n    requestRun?: () => void\n  ): Promise<IWebpackConfiguration | undefined> {\n    if (this._webpackConfiguration === false) {\n      const webpackConfiguration: IWebpackConfiguration | undefined = await tryLoadWebpackConfigurationAsync(\n        {\n          taskSession,\n          heftConfiguration,\n          hooks: this.accessor.hooks,\n          serveMode: this._isServeMode,\n          loadWebpackAsyncFn: this._loadWebpackAsync.bind(this)\n        },\n        options\n      );\n\n      if (webpackConfiguration && requestRun) {\n        const overrideWatchFSPlugin: OverrideNodeWatchFSPlugin = new OverrideNodeWatchFSPlugin(requestRun);\n        this._watchFileSystems = overrideWatchFSPlugin.fileSystems;\n        for (const config of Array.isArray(webpackConfiguration)\n          ? webpackConfiguration\n          : [webpackConfiguration]) {\n          if (!config.plugins) {\n            config.plugins = [overrideWatchFSPlugin];\n          } else {\n            config.plugins.unshift(overrideWatchFSPlugin);\n          }\n        }\n      }\n\n      this._webpackConfiguration = webpackConfiguration;\n    }\n\n    return this._webpackConfiguration;\n  }\n\n  private async _loadWebpackAsync(): Promise<typeof TWebpack> {\n    if (!this._webpack) {\n      // Allow this to fail if webpack is not installed\n      this._webpack = await import(WEBPACK_PACKAGE_NAME);\n    }\n    return this._webpack!;\n  }\n\n  private async _getWebpackCompilerAsync(\n    taskSession: IHeftTaskSession,\n    webpackConfiguration: IWebpackConfiguration\n  ): Promise<ExtendedCompiler | ExtendedMultiCompiler> {\n    if (!this._webpackCompiler) {\n      const webpack: typeof TWebpack = await this._loadWebpackAsync();\n      taskSession.logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);\n      this._webpackCompiler = Array.isArray(webpackConfiguration)\n        ? (webpack.default(\n            webpackConfiguration\n          ) as ExtendedMultiCompiler) /* (webpack.Compilation[]) => MultiCompiler */\n        : (webpack.default(webpackConfiguration) as ExtendedCompiler); /* (webpack.Compilation) => Compiler */\n    }\n    return this._webpackCompiler;\n  }\n\n  private async _runWebpackAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<void> {\n    this._validateEnvironmentVariable(taskSession);\n    if (taskSession.parameters.watch || this._isServeMode) {\n      // Should never happen, but just in case\n      throw new InternalError('Cannot run Webpack in compilation mode when watch mode is enabled');\n    }\n\n    // Load the config and compiler, and return if there is no config found\n    const webpackConfiguration: IWebpackConfiguration | undefined = await this._getWebpackConfigurationAsync(\n      taskSession,\n      heftConfiguration,\n      options\n    );\n    if (!webpackConfiguration) {\n      return;\n    }\n    const compiler: ExtendedCompiler | ExtendedMultiCompiler = await this._getWebpackCompilerAsync(\n      taskSession,\n      webpackConfiguration\n    );\n    taskSession.logger.terminal.writeLine('Running Webpack compilation');\n\n    // Run the webpack compiler\n    let stats: TWebpack.Stats | TWebpack.MultiStats | undefined;\n    try {\n      stats = await LegacyAdapters.convertCallbackToPromise(\n        (compiler as TWebpack.Compiler).run.bind(compiler)\n      );\n    } catch (e) {\n      taskSession.logger.emitError(e as Error);\n    }\n\n    // Emit the errors from the stats object, if present\n    if (stats) {\n      this._recordErrors(stats);\n      if (this.accessor.hooks.onEmitStats.isUsed()) {\n        await this.accessor.hooks.onEmitStats.promise(stats);\n      }\n      this._emitErrors(taskSession.logger);\n    }\n  }\n\n  private async _runWebpackWatchAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions,\n    requestRun: () => void\n  ): Promise<void> {\n    // Save a handle to the original promise, since the this-scoped promise will be replaced whenever\n    // the compilation completes.\n    let webpackCompilationDonePromise: Promise<void> | undefined = this._webpackCompilationDonePromise;\n\n    let isInitial: boolean = false;\n\n    if (!this._webpackCompiler) {\n      isInitial = true;\n      this._validateEnvironmentVariable(taskSession);\n      if (!taskSession.parameters.watch) {\n        // Should never happen, but just in case\n        throw new InternalError('Cannot run Webpack in watch mode when compilation mode is enabled');\n      }\n\n      // Load the config and compiler, and return if there is no config found\n      const webpackConfiguration: IWebpackConfiguration | undefined =\n        await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options, requestRun);\n      if (!webpackConfiguration) {\n        return;\n      }\n\n      // Get the compiler which will be used for both serve and watch mode\n      const compiler: ExtendedCompiler | ExtendedMultiCompiler = await this._getWebpackCompilerAsync(\n        taskSession,\n        webpackConfiguration\n      );\n\n      // Set up the hook to detect when the watcher completes the watcher compilation. We will also log out\n      // errors from the compilation if present from the output stats object.\n      this._webpackCompilationDonePromise = new Promise((resolve: () => void) => {\n        this._webpackCompilationDonePromiseResolveFn = resolve;\n      });\n      webpackCompilationDonePromise = this._webpackCompilationDonePromise;\n      compiler.hooks.done.tap(PLUGIN_NAME, (stats?: TWebpack.Stats | TWebpack.MultiStats) => {\n        this._webpackCompilationDonePromiseResolveFn!();\n        this._webpackCompilationDonePromise = new Promise((resolve: () => void) => {\n          this._webpackCompilationDonePromiseResolveFn = resolve;\n        });\n        if (stats) {\n          this._recordErrors(stats);\n        }\n      });\n\n      // Determine how we will run the compiler. When serving, we will run the compiler\n      // via the webpack-dev-server. Otherwise, we will run the compiler directly.\n      if (this._isServeMode) {\n        const defaultDevServerOptions: TWebpackDevServer.Configuration = {\n          host: 'localhost',\n          devMiddleware: {\n            publicPath: '/',\n            stats: {\n              cached: false,\n              cachedAssets: false,\n              colors: heftConfiguration.terminalProvider.supportsColor\n            }\n          },\n          client: {\n            logging: 'info',\n            webSocketURL: {\n              port: 8080\n            }\n          },\n          port: 8080,\n          onListening: (server: TWebpackDevServer) => {\n            const addressInfo: AddressInfo | string | undefined = server.server?.address() as AddressInfo;\n            if (addressInfo) {\n              const address: string =\n                typeof addressInfo === 'string' ? addressInfo : `${addressInfo.address}:${addressInfo.port}`;\n              taskSession.logger.terminal.writeLine(`Started Webpack Dev Server at https://${address}`);\n            }\n          }\n        };\n\n        // Obtain the devServerOptions from the webpack configuration, and combine with the default options\n        let devServerOptions: TWebpackDevServer.Configuration;\n        if (Array.isArray(webpackConfiguration)) {\n          const filteredDevServerOptions: TWebpackDevServer.Configuration[] = webpackConfiguration\n            .map((configuration) => configuration.devServer)\n            .filter((devServer): devServer is TWebpackDevServer.Configuration => !!devServer);\n          if (filteredDevServerOptions.length > 1) {\n            taskSession.logger.emitWarning(\n              new Error(`Detected multiple webpack devServer configurations, using the first one.`)\n            );\n          }\n          devServerOptions = { ...defaultDevServerOptions, ...filteredDevServerOptions[0] };\n        } else {\n          devServerOptions = { ...defaultDevServerOptions, ...webpackConfiguration.devServer };\n        }\n\n        // Add the certificate and key to the devServerOptions if these fields don't already have values\n        if (!devServerOptions.server) {\n          const certificateManager: CertificateManager = new CertificateManager();\n          const certificate: ICertificate = await certificateManager.ensureCertificateAsync(\n            true,\n            taskSession.logger.terminal\n          );\n\n          // Update the web socket URL to use the hostname provided by the certificate\n          const clientConfiguration: TWebpackDevServer.Configuration['client'] = devServerOptions.client;\n          const hostname: string | undefined = certificate.subjectAltNames?.[0];\n          if (hostname && typeof clientConfiguration === 'object') {\n            const { webSocketURL } = clientConfiguration;\n            if (typeof webSocketURL === 'object') {\n              clientConfiguration.webSocketURL = {\n                ...webSocketURL,\n                hostname\n              };\n            }\n          }\n\n          devServerOptions = {\n            ...devServerOptions,\n            server: {\n              type: 'https',\n              options: {\n                minVersion: 'TLSv1.3',\n                key: certificate.pemKey,\n                cert: certificate.pemCertificate,\n                ca: certificate.pemCaCertificate\n              }\n            }\n          };\n        }\n\n        // Since the webpack-dev-server does not return infrastructure errors via a callback like\n        // compiler.watch(...), we will need to intercept them and log them ourselves.\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        compiler.hooks.infrastructureLog.tap(PLUGIN_NAME, (name: string, type: string, args: any[]) => {\n          if (name === WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME && type === 'error') {\n            const error: Error | undefined = args[0];\n            if (error) {\n              taskSession.logger.emitError(error);\n            }\n          }\n          return true;\n        });\n\n        // The webpack-dev-server package has a design flaw, where merely loading its package will set the\n        // WEBPACK_DEV_SERVER environment variable -- even if no APIs are accessed. This environment variable\n        // causes incorrect behavior if Heft is not running in serve mode. Thus, we need to be careful to call\n        // require() only if Heft is in serve mode.\n        taskSession.logger.terminal.writeLine('Starting webpack-dev-server');\n        const WebpackDevServer: typeof TWebpackDevServer = (await import(WEBPACK_DEV_SERVER_PACKAGE_NAME))\n          .default;\n        const webpackDevServer: TWebpackDevServer = new WebpackDevServer(devServerOptions, compiler);\n        await webpackDevServer.start();\n      } else {\n        // Create the watcher. Compilation will start immediately after invoking watch().\n        taskSession.logger.terminal.writeLine('Starting Webpack watcher');\n        compiler.watch({}, (error?: Error | null) => {\n          if (error) {\n            taskSession.logger.emitError(error);\n          }\n        });\n      }\n    }\n\n    let hasChanges: boolean = true;\n    if (!isInitial && this._watchFileSystems) {\n      hasChanges = false;\n      for (const watchFileSystem of this._watchFileSystems) {\n        hasChanges = watchFileSystem.flush() || hasChanges;\n      }\n    }\n\n    // Resume the compilation, wait for the compilation to complete, then suspend the watchers until the\n    // next iteration. Even if there are no changes, the promise should resolve since resuming from a\n    // suspended state invalidates the state of the watcher.\n    if (hasChanges) {\n      taskSession.logger.terminal.writeLine('Running incremental Webpack compilation');\n      await webpackCompilationDonePromise;\n    } else {\n      taskSession.logger.terminal.writeLine(\n        'Webpack has not detected changes. Listing previous diagnostics.'\n      );\n    }\n\n    this._emitErrors(taskSession.logger);\n  }\n\n  private _validateEnvironmentVariable(taskSession: IHeftTaskSession): void {\n    if (!this._isServeMode && process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {\n      taskSession.logger.emitWarning(\n        new Error(\n          `The \"${WEBPACK_DEV_SERVER_ENV_VAR_NAME}\" environment variable is set, ` +\n            'which will cause problems when webpack is not running in serve mode. ' +\n            `(Did a dependency inadvertently load the \"${WEBPACK_DEV_SERVER_PACKAGE_NAME}\" package?)`\n        )\n      );\n    }\n  }\n\n  private _emitErrors(logger: IScopedLogger): void {\n    for (const warning of this._warnings) {\n      logger.emitWarning(warning);\n    }\n    for (const error of this._errors) {\n      logger.emitError(error);\n    }\n  }\n\n  private _recordErrors(stats: TWebpack.Stats | TWebpack.compilation.MultiStats): void {\n    this._errors.length = 0;\n    this._warnings.length = 0;\n\n    if (stats.hasErrors() || stats.hasWarnings()) {\n      const serializedStats: TWebpack.Stats.ToJsonOutput[] = [stats.toJson('errors-warnings')];\n\n      for (const compilationStats of serializedStats) {\n        for (const warning of compilationStats.warnings as (string | Error)[]) {\n          this._warnings.push(warning instanceof Error ? warning : new Error(warning));\n        }\n\n        for (const error of compilationStats.errors as (string | Error)[]) {\n          this._errors.push(error instanceof Error ? error : new Error(error));\n        }\n\n        if (compilationStats.children) {\n          for (const child of compilationStats.children) {\n            serializedStats.push(child);\n          }\n        }\n      }\n    }\n  }\n}\n\n/**\n * @internal\n */\nexport function _createAccessorHooks(): IWebpackPluginAccessorHooks {\n  return {\n    onLoadConfiguration: new AsyncSeriesBailHook(),\n    onConfigure: new AsyncSeriesHook(['webpackConfiguration']),\n    onAfterConfigure: new AsyncParallelHook(['webpackConfiguration']),\n    onEmitStats: new AsyncParallelHook(['webpackStats'])\n  };\n}\n"]}

package/lib-esm/WebpackConfigurationLoader.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 * as path from 'node:path';
+import { FileSystem } from '@rushstack/node-core-library';
+import { PLUGIN_NAME, STAGE_LOAD_LOCAL_CONFIG } from './shared';
+const DEFAULT_WEBPACK_CONFIG_PATH = './webpack.config.js';
+const DEFAULT_WEBPACK_DEV_CONFIG_PATH = './webpack.dev.config.js';
+/**
+ * @internal
+ */
+export async function tryLoadWebpackConfigurationAsync(options, pluginOptions) {
+    const { taskSession, hooks, _tryLoadConfigFileAsync = tryLoadWebpackConfigurationFileAsync } = options;
+    const { logger } = taskSession;
+    const { terminal } = logger;
+    // Apply default behavior. Due to the state of `this._webpackConfiguration`, this code
+    // will execute exactly once.
+    hooks.onLoadConfiguration.tapPromise({
+        name: PLUGIN_NAME,
+        stage: STAGE_LOAD_LOCAL_CONFIG
+    }, async () => {
+        terminal.writeVerboseLine(`Attempting to load Webpack configuration from local file`);
+        const webpackConfiguration = await _tryLoadConfigFileAsync(options, pluginOptions);
+        if (webpackConfiguration) {
+            terminal.writeVerboseLine(`Loaded Webpack configuration from local file.`);
+        }
+        return webpackConfiguration;
+    });
+    // Obtain the webpack configuration by calling into the hook.
+    // The local configuration is loaded at STAGE_LOAD_LOCAL_CONFIG
+    terminal.writeVerboseLine('Attempting to load Webpack configuration');
+    let webpackConfiguration = await hooks.onLoadConfiguration.promise();
+    if (webpackConfiguration === false) {
+        terminal.writeLine('Webpack disabled by external plugin');
+        webpackConfiguration = undefined;
+    }
+    else if (webpackConfiguration === undefined ||
+        (Array.isArray(webpackConfiguration) && webpackConfiguration.length === 0)) {
+        terminal.writeLine('No Webpack configuration found');
+        webpackConfiguration = undefined;
+    }
+    else {
+        if (hooks.onConfigure.isUsed()) {
+            // Allow for plugins to customise the configuration
+            await hooks.onConfigure.promise(webpackConfiguration);
+        }
+        if (hooks.onAfterConfigure.isUsed()) {
+            // Provide the finalized configuration
+            await hooks.onAfterConfigure.promise(webpackConfiguration);
+        }
+    }
+    return webpackConfiguration;
+}
+/**
+ * @internal
+ */
+export async function tryLoadWebpackConfigurationFileAsync(options, pluginOptions) {
+    // TODO: Eventually replace this custom logic with a call to this utility in in webpack-cli:
+    // https://github.com/webpack/webpack-cli/blob/next/packages/webpack-cli/lib/groups/ConfigGroup.js
+    const { taskSession, heftConfiguration, loadWebpackAsyncFn, serveMode } = options;
+    const { logger, parameters: { production } } = taskSession;
+    const { terminal } = logger;
+    const { configurationPath, devConfigurationPath } = pluginOptions;
+    let webpackConfigJs;
+    try {
+        const buildFolderPath = heftConfiguration.buildFolderPath;
+        if (serveMode) {
+            const devConfigPath = path.resolve(buildFolderPath, devConfigurationPath || DEFAULT_WEBPACK_DEV_CONFIG_PATH);
+            terminal.writeVerboseLine(`Attempting to load webpack configuration from "${devConfigPath}".`);
+            webpackConfigJs = await _tryLoadWebpackConfigurationFileInnerAsync(devConfigPath);
+        }
+        if (!webpackConfigJs) {
+            const configPath = path.resolve(buildFolderPath, configurationPath || DEFAULT_WEBPACK_CONFIG_PATH);
+            terminal.writeVerboseLine(`Attempting to load webpack configuration from "${configPath}".`);
+            webpackConfigJs = await _tryLoadWebpackConfigurationFileInnerAsync(configPath);
+        }
+    }
+    catch (error) {
+        logger.emitError(error);
+    }
+    if (webpackConfigJs) {
+        const webpackConfig = webpackConfigJs.default || webpackConfigJs;
+        if (typeof webpackConfig === 'function') {
+            // Defer loading of webpack until we know for sure that we will need it
+            return webpackConfig({
+                prod: production,
+                production,
+                taskSession,
+                heftConfiguration,
+                webpack: await loadWebpackAsyncFn()
+            });
+        }
+        else {
+            return webpackConfig;
+        }
+    }
+    else {
+        return undefined;
+    }
+}
+/**
+ * @internal
+ */
+export async function _tryLoadWebpackConfigurationFileInnerAsync(configurationPath) {
+    const configExists = await FileSystem.existsAsync(configurationPath);
+    if (configExists) {
+        try {
+            return await import(configurationPath);
+        }
+        catch (e) {
+            const error = e;
+            if (error.code === 'ERR_MODULE_NOT_FOUND') {
+                // No configuration found, return undefined.
+                return undefined;
+            }
+            throw new Error(`Error loading webpack configuration at "${configurationPath}": ${e}`);
+        }
+    }
+    else {
+        return undefined;
+    }
+}
+//# sourceMappingURL=WebpackConfigurationLoader.js.map

package/lib-esm/WebpackConfigurationLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebpackConfigurationLoader.js","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D,OAAO,EACL,WAAW,EACX,uBAAuB,EAIxB,MAAM,UAAU,CAAC;AAwBlB,MAAM,2BAA2B,GAA0B,qBAAqB,CAAC;AACjF,MAAM,+BAA+B,GAA8B,yBAAyB,CAAC;AAE7F;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,OAAyC,EACzC,aAAoC;IAEpC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,uBAAuB,GAAG,oCAAoC,EAAE,GAAG,OAAO,CAAC;IACvG,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IAC/B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE5B,sFAAsF;IACtF,6BAA6B;IAC7B,KAAK,CAAC,mBAAmB,CAAC,UAAU,CAClC;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,uBAAuB;KAC/B,EACD,KAAK,IAAI,EAAE;QACT,QAAQ,CAAC,gBAAgB,CAAC,0DAA0D,CAAC,CAAC;QACtF,MAAM,oBAAoB,GAAsC,MAAM,uBAAuB,CAC3F,OAAO,EACP,aAAa,CACd,CAAC;QAEF,IAAI,oBAAoB,EAAE,CAAC;YACzB,QAAQ,CAAC,gBAAgB,CAAC,+CAA+C,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO,oBAAoB,CAAC;IAC9B,CAAC,CACF,CAAC;IAEF,6DAA6D;IAC7D,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,CAAC,0CAA0C,CAAC,CAAC;IACtE,IAAI,oBAAoB,GACtB,MAAM,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;IAE5C,IAAI,oBAAoB,KAAK,KAAK,EAAE,CAAC;QACnC,QAAQ,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC1D,oBAAoB,GAAG,SAAS,CAAC;IACnC,CAAC;SAAM,IACL,oBAAoB,KAAK,SAAS;QAClC,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,CAAC,EAC1E,CAAC;QACD,QAAQ,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACrD,oBAAoB,GAAG,SAAS,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/B,mDAAmD;YACnD,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,sCAAsC;YACtC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,OAAyC,EACzC,aAAoC;IAEpC,4FAA4F;IAC5F,kGAAkG;IAElG,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAClF,MAAM,EACJ,MAAM,EACN,UAAU,EAAE,EAAE,UAAU,EAAE,EAC3B,GAAG,WAAW,CAAC;IAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC5B,MAAM,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,GAAG,aAAa,CAAC;IAClE,IAAI,eAA6C,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,eAAe,GAAW,iBAAiB,CAAC,eAAe,CAAC;QAClE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,aAAa,GAAW,IAAI,CAAC,OAAO,CACxC,eAAe,EACf,oBAAoB,IAAI,+BAA+B,CACxD,CAAC;YACF,QAAQ,CAAC,gBAAgB,CAAC,kDAAkD,aAAa,IAAI,CAAC,CAAC;YAC/F,eAAe,GAAG,MAAM,0CAA0C,CAAC,aAAa,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,UAAU,GAAW,IAAI,CAAC,OAAO,CACrC,eAAe,EACf,iBAAiB,IAAI,2BAA2B,CACjD,CAAC;YACF,QAAQ,CAAC,gBAAgB,CAAC,kDAAkD,UAAU,IAAI,CAAC,CAAC;YAC5F,eAAe,GAAG,MAAM,0CAA0C,CAAC,UAAU,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,SAAS,CAAC,KAAc,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,aAAa,GAChB,eAAuD,CAAC,OAAO,IAAI,eAAe,CAAC;QAEtF,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACxC,uEAAuE;YACvE,OAAO,aAAa,CAAC;gBACnB,IAAI,EAAE,UAAU;gBAChB,UAAU;gBACV,WAAW;gBACX,iBAAiB;gBACjB,OAAO,EAAE,MAAM,kBAAkB,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0CAA0C,CAC9D,iBAAyB;IAEzB,MAAM,YAAY,GAAY,MAAM,UAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAC9E,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,KAAK,GAA0B,CAA0B,CAAC;YAChE,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC1C,4CAA4C;gBAC5C,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,iBAAiB,MAAM,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,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\nimport * as path from 'node:path';\n\nimport type * as TWebpack from 'webpack';\n\nimport { FileSystem } from '@rushstack/node-core-library';\nimport type { IHeftTaskSession, HeftConfiguration } from '@rushstack/heft';\n\nimport type { IWebpackPluginOptions } from './Webpack4Plugin';\nimport {\n  PLUGIN_NAME,\n  STAGE_LOAD_LOCAL_CONFIG,\n  type IWebpackConfiguration,\n  type IWebpackConfigurationFnEnvironment,\n  type IWebpackPluginAccessorHooks\n} from './shared';\n\ntype IWebpackConfigJsExport =\n  | TWebpack.Configuration\n  | TWebpack.Configuration[]\n  | Promise<TWebpack.Configuration>\n  | Promise<TWebpack.Configuration[]>\n  | ((env: IWebpackConfigurationFnEnvironment) => TWebpack.Configuration | TWebpack.Configuration[])\n  | ((env: IWebpackConfigurationFnEnvironment) => Promise<TWebpack.Configuration | TWebpack.Configuration[]>);\ntype IWebpackConfigJs = IWebpackConfigJsExport | { default: IWebpackConfigJsExport };\n\n/**\n * @internal\n */\nexport interface ILoadWebpackConfigurationOptions {\n  taskSession: IHeftTaskSession;\n  heftConfiguration: HeftConfiguration;\n  serveMode: boolean;\n  loadWebpackAsyncFn: () => Promise<typeof TWebpack>;\n  hooks: Pick<IWebpackPluginAccessorHooks, 'onLoadConfiguration' | 'onConfigure' | 'onAfterConfigure'>;\n\n  _tryLoadConfigFileAsync?: typeof tryLoadWebpackConfigurationFileAsync;\n}\n\nconst DEFAULT_WEBPACK_CONFIG_PATH: './webpack.config.js' = './webpack.config.js';\nconst DEFAULT_WEBPACK_DEV_CONFIG_PATH: './webpack.dev.config.js' = './webpack.dev.config.js';\n\n/**\n * @internal\n */\nexport async function tryLoadWebpackConfigurationAsync(\n  options: ILoadWebpackConfigurationOptions,\n  pluginOptions: IWebpackPluginOptions\n): Promise<IWebpackConfiguration | undefined> {\n  const { taskSession, hooks, _tryLoadConfigFileAsync = tryLoadWebpackConfigurationFileAsync } = options;\n  const { logger } = taskSession;\n  const { terminal } = logger;\n\n  // Apply default behavior. Due to the state of `this._webpackConfiguration`, this code\n  // will execute exactly once.\n  hooks.onLoadConfiguration.tapPromise(\n    {\n      name: PLUGIN_NAME,\n      stage: STAGE_LOAD_LOCAL_CONFIG\n    },\n    async () => {\n      terminal.writeVerboseLine(`Attempting to load Webpack configuration from local file`);\n      const webpackConfiguration: IWebpackConfiguration | undefined = await _tryLoadConfigFileAsync(\n        options,\n        pluginOptions\n      );\n\n      if (webpackConfiguration) {\n        terminal.writeVerboseLine(`Loaded Webpack configuration from local file.`);\n      }\n\n      return webpackConfiguration;\n    }\n  );\n\n  // Obtain the webpack configuration by calling into the hook.\n  // The local configuration is loaded at STAGE_LOAD_LOCAL_CONFIG\n  terminal.writeVerboseLine('Attempting to load Webpack configuration');\n  let webpackConfiguration: IWebpackConfiguration | false | undefined =\n    await hooks.onLoadConfiguration.promise();\n\n  if (webpackConfiguration === false) {\n    terminal.writeLine('Webpack disabled by external plugin');\n    webpackConfiguration = undefined;\n  } else if (\n    webpackConfiguration === undefined ||\n    (Array.isArray(webpackConfiguration) && webpackConfiguration.length === 0)\n  ) {\n    terminal.writeLine('No Webpack configuration found');\n    webpackConfiguration = undefined;\n  } else {\n    if (hooks.onConfigure.isUsed()) {\n      // Allow for plugins to customise the configuration\n      await hooks.onConfigure.promise(webpackConfiguration);\n    }\n    if (hooks.onAfterConfigure.isUsed()) {\n      // Provide the finalized configuration\n      await hooks.onAfterConfigure.promise(webpackConfiguration);\n    }\n  }\n  return webpackConfiguration;\n}\n\n/**\n * @internal\n */\nexport async function tryLoadWebpackConfigurationFileAsync(\n  options: ILoadWebpackConfigurationOptions,\n  pluginOptions: IWebpackPluginOptions\n): Promise<IWebpackConfiguration | undefined> {\n  // TODO: Eventually replace this custom logic with a call to this utility in in webpack-cli:\n  // https://github.com/webpack/webpack-cli/blob/next/packages/webpack-cli/lib/groups/ConfigGroup.js\n\n  const { taskSession, heftConfiguration, loadWebpackAsyncFn, serveMode } = options;\n  const {\n    logger,\n    parameters: { production }\n  } = taskSession;\n  const { terminal } = logger;\n  const { configurationPath, devConfigurationPath } = pluginOptions;\n  let webpackConfigJs: IWebpackConfigJs | undefined;\n\n  try {\n    const buildFolderPath: string = heftConfiguration.buildFolderPath;\n    if (serveMode) {\n      const devConfigPath: string = path.resolve(\n        buildFolderPath,\n        devConfigurationPath || DEFAULT_WEBPACK_DEV_CONFIG_PATH\n      );\n      terminal.writeVerboseLine(`Attempting to load webpack configuration from \"${devConfigPath}\".`);\n      webpackConfigJs = await _tryLoadWebpackConfigurationFileInnerAsync(devConfigPath);\n    }\n\n    if (!webpackConfigJs) {\n      const configPath: string = path.resolve(\n        buildFolderPath,\n        configurationPath || DEFAULT_WEBPACK_CONFIG_PATH\n      );\n      terminal.writeVerboseLine(`Attempting to load webpack configuration from \"${configPath}\".`);\n      webpackConfigJs = await _tryLoadWebpackConfigurationFileInnerAsync(configPath);\n    }\n  } catch (error) {\n    logger.emitError(error as Error);\n  }\n\n  if (webpackConfigJs) {\n    const webpackConfig: IWebpackConfigJsExport =\n      (webpackConfigJs as { default: IWebpackConfigJsExport }).default || webpackConfigJs;\n\n    if (typeof webpackConfig === 'function') {\n      // Defer loading of webpack until we know for sure that we will need it\n      return webpackConfig({\n        prod: production,\n        production,\n        taskSession,\n        heftConfiguration,\n        webpack: await loadWebpackAsyncFn()\n      });\n    } else {\n      return webpackConfig;\n    }\n  } else {\n    return undefined;\n  }\n}\n\n/**\n * @internal\n */\nexport async function _tryLoadWebpackConfigurationFileInnerAsync(\n  configurationPath: string\n): Promise<IWebpackConfigJs | undefined> {\n  const configExists: boolean = await FileSystem.existsAsync(configurationPath);\n  if (configExists) {\n    try {\n      return await import(configurationPath);\n    } catch (e) {\n      const error: NodeJS.ErrnoException = e as NodeJS.ErrnoException;\n      if (error.code === 'ERR_MODULE_NOT_FOUND') {\n        // No configuration found, return undefined.\n        return undefined;\n      }\n      throw new Error(`Error loading webpack configuration at \"${configurationPath}\": ${e}`);\n    }\n  } else {\n    return undefined;\n  }\n}\n"]}

package/lib-esm/WebpackConfigurationLoader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebpackConfigurationLoader.test.js","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.test.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAChG,OAAO,EAAkB,4BAA4B,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE7F,OAAO,KAAK,0BAA0B,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAA8B,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAS/E,QAAQ,CAAC,0BAA0B,CAAC,gCAAgC,CAAC,IAAI,EAAE,GAAG,EAAE;IAC9E,SAAS,aAAa,CAAC,UAAmB,EAAE,SAAkB;QAC5D,MAAM,gBAAgB,GAAiC,IAAI,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAC/F,MAAM,QAAQ,GAAc,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAkB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,eAAe,GAAW,SAAS,CAAC;QAE1C,MAAM,UAAU,GAA6B;YAC3C,UAAU;SACX,CAAC;QAEF,MAAM,WAAW,GAAqB;YACpC,MAAM;YACN,UAAU,EAAE,UAAwC;YACpD,yCAAyC;YACzC,KAAK,EAAE,SAAU;YACjB,iBAAiB,EAAE,SAAU;YAC7B,2BAA2B,EAAE,SAAU;YACvC,QAAQ,EAAE,SAAS;YACnB,cAAc,EAAE,GAAG,SAAS,OAAO;SACpC,CAAC;QAEF,MAAM,iBAAiB,GAA+B;YACpD,eAAe;SAChB,CAAC;QAEF,OAAO;YACL,WAAW;YACX,iBAAiB,EAAE,iBAAiD;YACpE,KAAK,EAAE,oBAAoB,EAAE;YAC7B,kBAAkB,EAAE,IAAI,CAAC,EAAE,EAAE;YAC7B,SAAS;YAET,iBAAiB,EAAE,gBAAgB;YACnC,uBAAuB,EAAE,IAAI,CAAC,EAAE,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,OAAO,GAAyC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAElF,MAAM,mBAAmB,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,WAAW,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QAE9C,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAE7D,mBAAmB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAE3C,MAAM,MAAM,GACV,MAAM,0BAA0B,CAAC,gCAAgC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,OAAO,GAAyC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAElF,MAAM,WAAW,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QAE9C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAE7D,OAAO,CAAC,uBAAuB,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAE5E,MAAM,MAAM,GACV,MAAM,0BAA0B,CAAC,gCAAgC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;QAC7B,MAAM,OAAO,GAAyC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAElF,MAAM,mBAAmB,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,WAAW,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QAE9C,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CACnC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,CAAC,EAAE,EACpD,mBAAmB,CACpB,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAE7D,OAAO,CAAC,uBAAuB,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAE5E,MAAM,UAAU,GAA0B,EAAE,CAAC;QAC7C,mBAAmB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAEhD,MAAM,MAAM,GACV,MAAM,0BAA0B,CAAC,gCAAgC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEhC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAElD,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAyC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAElF,MAAM,WAAW,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAc,IAAI,CAAC,EAAE,EAAE,CAAC;QAE9C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAE7D,MAAM,UAAU,GAA0B,EAAE,CAAC;QAE7C,OAAO,CAAC,uBAAuB,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAE7E,MAAM,MAAM,GACV,MAAM,0BAA0B,CAAC,gCAAgC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,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\nimport type { HeftConfiguration, IHeftParameters, IHeftTaskSession, IScopedLogger } from '@rushstack/heft';\nimport { MockScopedLogger } from '@rushstack/heft/lib/pluginFramework/logging/MockScopedLogger';\nimport { type ITerminal, StringBufferTerminalProvider, Terminal } from '@rushstack/terminal';\n\nimport * as WebpackConfigurationLoader from './WebpackConfigurationLoader';\nimport { _createAccessorHooks } from './Webpack4Plugin';\nimport { type IWebpackConfiguration, STAGE_LOAD_LOCAL_CONFIG } from './shared';\n\ninterface IMockLoadWebpackConfigurationOptions\n  extends WebpackConfigurationLoader.ILoadWebpackConfigurationOptions {\n  loadWebpackAsyncFn: jest.Mock;\n  _terminalProvider: StringBufferTerminalProvider;\n  _tryLoadConfigFileAsync: jest.Mock;\n}\n\ndescribe(WebpackConfigurationLoader.tryLoadWebpackConfigurationAsync.name, () => {\n  function createOptions(production: boolean, serveMode: boolean): IMockLoadWebpackConfigurationOptions {\n    const terminalProvider: StringBufferTerminalProvider = new StringBufferTerminalProvider(false);\n    const terminal: ITerminal = new Terminal(terminalProvider);\n    const logger: IScopedLogger = new MockScopedLogger(terminal);\n    const buildFolderPath: string = __dirname;\n\n    const parameters: Partial<IHeftParameters> = {\n      production\n    };\n\n    const taskSession: IHeftTaskSession = {\n      logger,\n      parameters: parameters as unknown as IHeftParameters,\n      // Other values unused during these tests\n      hooks: undefined!,\n      parsedCommandLine: undefined!,\n      requestAccessToPluginByName: undefined!,\n      taskName: 'webpack',\n      tempFolderPath: `${__dirname}/temp`\n    };\n\n    const heftConfiguration: Partial<HeftConfiguration> = {\n      buildFolderPath\n    };\n\n    return {\n      taskSession,\n      heftConfiguration: heftConfiguration as unknown as HeftConfiguration,\n      hooks: _createAccessorHooks(),\n      loadWebpackAsyncFn: jest.fn(),\n      serveMode,\n\n      _terminalProvider: terminalProvider,\n      _tryLoadConfigFileAsync: jest.fn()\n    };\n  }\n\n  it(`onLoadConfiguration can return false`, async () => {\n    const options: IMockLoadWebpackConfigurationOptions = createOptions(false, false);\n\n    const onLoadConfiguration: jest.Mock = jest.fn();\n    const onConfigure: jest.Mock = jest.fn();\n    const onAfterConfigure: jest.Mock = jest.fn();\n\n    options.hooks.onLoadConfiguration.tap('test', onLoadConfiguration);\n    options.hooks.onConfigure.tap('test', onConfigure);\n    options.hooks.onAfterConfigure.tap('test', onAfterConfigure);\n\n    onLoadConfiguration.mockReturnValue(false);\n\n    const config: IWebpackConfiguration | undefined =\n      await WebpackConfigurationLoader.tryLoadWebpackConfigurationAsync(options, {});\n    expect(config).toBeUndefined();\n    expect(onLoadConfiguration).toHaveBeenCalledTimes(1);\n    expect(options._tryLoadConfigFileAsync).toHaveBeenCalledTimes(0);\n    expect(onConfigure).toHaveBeenCalledTimes(0);\n    expect(onAfterConfigure).toHaveBeenCalledTimes(0);\n  });\n\n  it(`calls tryLoadWebpackConfigurationFileAsync`, async () => {\n    const options: IMockLoadWebpackConfigurationOptions = createOptions(false, false);\n\n    const onConfigure: jest.Mock = jest.fn();\n    const onAfterConfigure: jest.Mock = jest.fn();\n\n    options.hooks.onConfigure.tap('test', onConfigure);\n    options.hooks.onAfterConfigure.tap('test', onAfterConfigure);\n\n    options._tryLoadConfigFileAsync.mockReturnValue(Promise.resolve(undefined));\n\n    const config: IWebpackConfiguration | undefined =\n      await WebpackConfigurationLoader.tryLoadWebpackConfigurationAsync(options, {});\n    expect(config).toBeUndefined();\n    expect(options._tryLoadConfigFileAsync).toHaveBeenCalledTimes(1);\n    expect(onConfigure).toHaveBeenCalledTimes(0);\n    expect(onAfterConfigure).toHaveBeenCalledTimes(0);\n  });\n\n  it(`can fall back`, async () => {\n    const options: IMockLoadWebpackConfigurationOptions = createOptions(false, false);\n\n    const onLoadConfiguration: jest.Mock = jest.fn();\n    const onConfigure: jest.Mock = jest.fn();\n    const onAfterConfigure: jest.Mock = jest.fn();\n\n    options.hooks.onLoadConfiguration.tap(\n      { name: 'test', stage: STAGE_LOAD_LOCAL_CONFIG + 1 },\n      onLoadConfiguration\n    );\n    options.hooks.onConfigure.tap('test', onConfigure);\n    options.hooks.onAfterConfigure.tap('test', onAfterConfigure);\n\n    options._tryLoadConfigFileAsync.mockReturnValue(Promise.resolve(undefined));\n\n    const mockConfig: IWebpackConfiguration = {};\n    onLoadConfiguration.mockReturnValue(mockConfig);\n\n    const config: IWebpackConfiguration | undefined =\n      await WebpackConfigurationLoader.tryLoadWebpackConfigurationAsync(options, {});\n    expect(config).toBe(mockConfig);\n\n    expect(options._tryLoadConfigFileAsync).toHaveBeenCalledTimes(1);\n    expect(onLoadConfiguration).toHaveBeenCalledTimes(1);\n    expect(onConfigure).toHaveBeenCalledTimes(1);\n    expect(onAfterConfigure).toHaveBeenCalledTimes(1);\n\n    expect(onConfigure).toHaveBeenCalledWith(mockConfig);\n    expect(onAfterConfigure).toHaveBeenCalledWith(mockConfig);\n  });\n\n  it(`respects hook order`, async () => {\n    const options: IMockLoadWebpackConfigurationOptions = createOptions(false, false);\n\n    const onConfigure: jest.Mock = jest.fn();\n    const onAfterConfigure: jest.Mock = jest.fn();\n\n    options.hooks.onConfigure.tap('test', onConfigure);\n    options.hooks.onAfterConfigure.tap('test', onAfterConfigure);\n\n    const mockConfig: IWebpackConfiguration = {};\n\n    options._tryLoadConfigFileAsync.mockReturnValue(Promise.resolve(mockConfig));\n\n    const config: IWebpackConfiguration | undefined =\n      await WebpackConfigurationLoader.tryLoadWebpackConfigurationAsync(options, {});\n    expect(config).toBe(mockConfig);\n    expect(options._tryLoadConfigFileAsync).toHaveBeenCalledTimes(1);\n    expect(onConfigure).toHaveBeenCalledTimes(1);\n    expect(onConfigure).toHaveBeenCalledWith(mockConfig);\n    expect(onAfterConfigure).toHaveBeenCalledTimes(1);\n    expect(onAfterConfigure).toHaveBeenCalledWith(mockConfig);\n  });\n});\n"]}

package/lib-esm/index.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export { PLUGIN_NAME as PluginName, STAGE_LOAD_LOCAL_CONFIG } from './shared';
+//# 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,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,uBAAuB,EAAE,MAAM,UAAU,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\nexport { PLUGIN_NAME as PluginName, STAGE_LOAD_LOCAL_CONFIG } from './shared';\n\nexport type {\n  IWebpackConfigurationWithDevServer,\n  IWebpackConfiguration,\n  IWebpackConfigurationFnEnvironment,\n  IWebpackPluginAccessor,\n  IWebpackPluginAccessorHooks,\n  IWebpackPluginAccessorParameters\n} from './shared';\n"]}

package/lib-esm/schemas/heft-webpack4-plugin.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "title": "Webpack 4 Plugin Configuration",
+  "description": "Defines options for Webpack 4 plugin execution.",
+  "type": "object",
+
+  "additionalProperties": false,
+
+  "properties": {
+    "$schema": {
+      "description": "Part of the JSON Schema standard, this optional keyword declares the URL of the schema that the file conforms to. Editors may download the schema and use it to perform syntax highlighting.",
+      "type": "string"
+    },
+
+    "devConfigurationPath": {
+      "description": "Specifies a relative path to the Webpack dev configuration, which is used in \"serve\" mode. The default value is \"./webpack.dev.config.js\".",
+      "type": "string"
+    },
+
+    "configurationPath": {
+      "description": "Specifies a relative path to the Webpack configuration. The default value is \"./webpack.config.js\".",
+      "type": "string"
+    }
+  }
+}

package/lib-esm/shared.js

@@ -0,0 +1,13 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * The stage in the `onLoadConfiguration` hook at which the config will be loaded from the local
+ * webpack config file.
+ * @public
+ */
+export const STAGE_LOAD_LOCAL_CONFIG = 1000;
+/**
+ * @public
+ */
+export const PLUGIN_NAME = 'webpack4-plugin';
+//# sourceMappingURL=shared.js.map

package/lib-esm/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AA0H3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAS,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB,iBAAiB,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// eslint-disable-next-line import/order\nimport type * as TWebpack from 'webpack';\n// Compensate for webpack-dev-server referencing constructs from webpack 5\ndeclare module 'webpack' {\n  export type MultiStats = TWebpack.compilation.MultiStats;\n  export type StatsOptions = unknown;\n  export type StatsCompilation = TWebpack.compilation.Compilation;\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  export interface Compiler {\n    watching?: unknown;\n  }\n}\nimport type { Configuration as WebpackDevServerConfiguration } from 'webpack-dev-server';\nimport type { AsyncParallelHook, AsyncSeriesBailHook, AsyncSeriesHook } from 'tapable';\n\nimport type { IHeftTaskSession, HeftConfiguration } from '@rushstack/heft';\n\n/**\n * The environment passed into the Webpack configuration function. Loosely based\n * on the default Webpack environment options, specified here:\n * https://webpack.js.org/api/cli/#environment-options\n *\n * @public\n */\nexport interface IWebpackConfigurationFnEnvironment {\n  /**\n   * Whether or not the run is in production mode. Synonym of\n   * IWebpackConfigurationFnEnvironment.production.\n   */\n  prod: boolean;\n  /**\n   * Whether or not the run is in production mode. Synonym of\n   * IWebpackConfigurationFnEnvironment.prod.\n   */\n  production: boolean;\n\n  // Non-standard environment options\n  /**\n   * The task session provided to the plugin.\n   */\n  taskSession: IHeftTaskSession;\n  /**\n   * The Heft configuration provided to the plugin.\n   */\n  heftConfiguration: HeftConfiguration;\n  /**\n   * The resolved Webpack package.\n   */\n  webpack: typeof TWebpack;\n}\n\n/**\n * @public\n */\nexport interface IWebpackConfigurationWithDevServer extends TWebpack.Configuration {\n  devServer?: WebpackDevServerConfiguration;\n}\n\n/**\n * @public\n */\nexport type IWebpackConfiguration = IWebpackConfigurationWithDevServer | IWebpackConfigurationWithDevServer[];\n\n/**\n * @public\n */\nexport interface IWebpackPluginAccessorHooks {\n  /**\n   * A hook that allows for loading custom configurations used by the Webpack\n   * plugin. If a tap returns a value other than `undefined` before stage {@link STAGE_LOAD_LOCAL_CONFIG},\n   * it will suppress loading from the webpack config file. To provide a fallback behavior in the\n   * absence of a local config file, tap this hook with a `stage` value greater than {@link STAGE_LOAD_LOCAL_CONFIG}.\n   *\n   * @remarks\n   * Tapable event handlers can return `false` instead of `undefined` to suppress\n   * other handlers from creating a configuration object, and prevent webpack from running.\n   */\n  readonly onLoadConfiguration: AsyncSeriesBailHook<never, never, never, IWebpackConfiguration | false>;\n  /**\n   * A hook that allows for modification of the loaded configuration used by the Webpack\n   * plugin. If no configuration was loaded, this hook will not be called.\n   */\n  readonly onConfigure: AsyncSeriesHook<IWebpackConfiguration, never, never>;\n  /**\n   * A hook that provides the finalized configuration that will be used by Webpack.\n   * If no configuration was loaded, this hook will not be called.\n   */\n  readonly onAfterConfigure: AsyncParallelHook<IWebpackConfiguration, never, never>;\n  /**\n   * A hook that provides the stats output from Webpack. If no configuration is loaded,\n   * this hook will not be called.\n   */\n  readonly onEmitStats: AsyncParallelHook<TWebpack.Stats | TWebpack.compilation.MultiStats, never, never>;\n}\n\n/**\n * @public\n */\nexport interface IWebpackPluginAccessorParameters {\n  /**\n   * Whether or not serve mode was enabled by passing the `--serve` flag.\n   */\n  readonly isServeMode: boolean;\n}\n\n/**\n * @public\n */\nexport interface IWebpackPluginAccessor {\n  /**\n   * Hooks that are called at various points in the Webpack plugin lifecycle.\n   */\n  readonly hooks: IWebpackPluginAccessorHooks;\n  /**\n   * Parameters that are provided by the Webpack plugin.\n   */\n  readonly parameters: IWebpackPluginAccessorParameters;\n}\n\n/**\n * The stage in the `onLoadConfiguration` hook at which the config will be loaded from the local\n * webpack config file.\n * @public\n */\nexport const STAGE_LOAD_LOCAL_CONFIG: 1000 = 1000;\n\n/**\n * @public\n */\nexport const PLUGIN_NAME: 'webpack4-plugin' = 'webpack4-plugin';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/heft-webpack4-plugin",
-  "version": "1.1.14",
+  "version": "1.2.1",
   "description": "Heft plugin for Webpack 4",
   "repository": {
     "type": "git",
@@ -8,8 +8,33 @@
     "directory": "heft-plugins/heft-webpack4-plugin"
   },
   "homepage": "https://rushstack.io/pages/heft/overview/",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./lib-dts/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib-dts/index.d.ts",
+      "node": "./lib-commonjs/index.js",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*.schema.json": "./lib-commonjs/*.schema.json",
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "node": "./lib-commonjs/*.js",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./heft-plugin.json": "./heft-plugin.json",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "peerDependenciesMeta": {
     "@types/webpack": {
@@ -17,7 +42,7 @@
     }
   },
   "peerDependencies": {
-    "@rushstack/heft": "^1.1.14",
+    "@rushstack/heft": "^1.2.1",
     "@types/webpack": "^4",
     "webpack": "~4.47.0"
   },
@@ -26,18 +51,19 @@
     "tapable": "1.1.3",
     "watchpack": "2.4.0",
     "webpack-dev-server": "~4.9.3",
-    "@rushstack/node-core-library": "5.19.1",
-    "@rushstack/debug-certificate-manager": "1.6.14"
+    "@rushstack/debug-certificate-manager": "1.7.1",
+    "@rushstack/node-core-library": "5.20.1"
   },
   "devDependencies": {
     "@types/watchpack": "2.4.0",
     "@types/webpack": "4.41.32",
     "eslint": "~9.37.0",
     "webpack": "~4.47.0",
-    "local-node-rig": "1.0.0",
-    "@rushstack/terminal": "0.21.0",
-    "@rushstack/heft": "1.1.14"
+    "@rushstack/heft": "1.2.1",
+    "@rushstack/terminal": "0.22.1",
+    "local-node-rig": "1.0.0"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "heft build --clean",
     "start": "heft test --clean --watch",