@rushstack/heft-webpack4-plugin 0.5.16 → 0.6.0-dev.0

package/lib/WebpackConfigurationLoader.js

@@ -28,30 +28,46 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebpackConfigurationLoader = void 0;
 const path = __importStar(require("path"));
 const node_core_library_1 = require("@rushstack/node-core-library");
-const WEBPACK_CONFIG_FILENAME = 'webpack.config.js';
-const WEBPACK_DEV_CONFIG_FILENAME = 'webpack.dev.config.js';
+const DEFAULT_WEBPACK_CONFIG_PATH = './webpack.config.js';
+const DEFAULT_WEBPACK_DEV_CONFIG_PATH = './webpack.dev.config.js';
 class WebpackConfigurationLoader {
-    static async tryLoadWebpackConfigAsync(logger, buildFolder, buildProperties) {
+    constructor(logger, production, serveMode) {
+        this._logger = logger;
+        this._production = production;
+        this._serveMode = serveMode;
+    }
+    async tryLoadWebpackConfigurationAsync(options) {
         // 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, configurationPath, devConfigurationPath, loadWebpackAsyncFn } = options;
         let webpackConfigJs;
         try {
-            if (buildProperties.serveMode) {
-                logger.terminal.writeVerboseLine(`Attempting to load webpack configuration from "${WEBPACK_DEV_CONFIG_FILENAME}".`);
-                webpackConfigJs = WebpackConfigurationLoader._tryLoadWebpackConfiguration(buildFolder, WEBPACK_DEV_CONFIG_FILENAME);
+            const buildFolderPath = heftConfiguration.buildFolderPath;
+            if (this._serveMode) {
+                const devConfigPath = path.resolve(buildFolderPath, devConfigurationPath || DEFAULT_WEBPACK_DEV_CONFIG_PATH);
+                this._logger.terminal.writeVerboseLine(`Attempting to load webpack configuration from "${devConfigPath}".`);
+                webpackConfigJs = await this._tryLoadWebpackConfigurationInnerAsync(devConfigPath);
             }
             if (!webpackConfigJs) {
-                logger.terminal.writeVerboseLine(`Attempting to load webpack configuration from "${WEBPACK_CONFIG_FILENAME}".`);
-                webpackConfigJs = WebpackConfigurationLoader._tryLoadWebpackConfiguration(buildFolder, WEBPACK_CONFIG_FILENAME);
+                const configPath = path.resolve(buildFolderPath, configurationPath || DEFAULT_WEBPACK_CONFIG_PATH);
+                this._logger.terminal.writeVerboseLine(`Attempting to load webpack configuration from "${configPath}".`);
+                webpackConfigJs = await this._tryLoadWebpackConfigurationInnerAsync(configPath);
             }
         }
         catch (error) {
-            logger.emitError(error);
+            this._logger.emitError(error);
         }
         if (webpackConfigJs) {
             const webpackConfig = webpackConfigJs.default || webpackConfigJs;
             if (typeof webpackConfig === 'function') {
-                return webpackConfig({ prod: buildProperties.production, production: buildProperties.production });
+                // Defer loading of webpack until we know for sure that we will need it
+                return webpackConfig({
+                    prod: this._production,
+                    production: this._production,
+                    taskSession,
+                    heftConfiguration,
+                    webpack: await loadWebpackAsyncFn()
+                });
             }
             else {
                 return webpackConfig;
@@ -61,14 +77,19 @@ class WebpackConfigurationLoader {
             return undefined;
         }
     }
-    static _tryLoadWebpackConfiguration(buildFolder, configurationFilename) {
-        const fullWebpackConfigPath = path.join(buildFolder, configurationFilename);
-        if (node_core_library_1.FileSystem.exists(fullWebpackConfigPath)) {
+    async _tryLoadWebpackConfigurationInnerAsync(configurationPath) {
+        const configExists = await node_core_library_1.FileSystem.existsAsync(configurationPath);
+        if (configExists) {
             try {
-                return require(fullWebpackConfigPath);
+                return await Promise.resolve().then(() => __importStar(require(configurationPath)));
             }
             catch (e) {
-                throw new Error(`Error loading webpack configuration at "${fullWebpackConfigPath}": ${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 {

package/lib/WebpackConfigurationLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebpackConfigurationLoader.js","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAC7B,oEAA0D;AAsB1D,MAAM,uBAAuB,GAAW,mBAAmB,CAAC;AAC5D,MAAM,2BAA2B,GAAW,uBAAuB,CAAC;AAEpE,MAAa,0BAA0B;IAC9B,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAC3C,MAAoB,EACpB,WAAmB,EACnB,eAAsC;QAEtC,4FAA4F;QAC5F,kGAAkG;QAElG,IAAI,eAA6C,CAAC;QAElD,IAAI;YACF,IAAI,eAAe,CAAC,SAAS,EAAE;gBAC7B,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAC9B,kDAAkD,2BAA2B,IAAI,CAClF,CAAC;gBACF,eAAe,GAAG,0BAA0B,CAAC,4BAA4B,CACvE,WAAW,EACX,2BAA2B,CAC5B,CAAC;aACH;YAED,IAAI,CAAC,eAAe,EAAE;gBACpB,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAC9B,kDAAkD,uBAAuB,IAAI,CAC9E,CAAC;gBACF,eAAe,GAAG,0BAA0B,CAAC,4BAA4B,CACvE,WAAW,EACX,uBAAuB,CACxB,CAAC;aACH;SACF;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,CAAC,SAAS,CAAC,KAAc,CAAC,CAAC;SAClC;QAED,IAAI,eAAe,EAAE;YACnB,MAAM,aAAa,GAChB,eAAuD,CAAC,OAAO,IAAI,eAAe,CAAC;YAEtF,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE;gBACvC,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC;aACpG;iBAAM;gBACL,OAAO,aAAa,CAAC;aACtB;SACF;aAAM;YACL,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;IAEO,MAAM,CAAC,4BAA4B,CACzC,WAAmB,EACnB,qBAA6B;QAE7B,MAAM,qBAAqB,GAAW,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;QACpF,IAAI,8BAAU,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE;YAC5C,IAAI;gBACF,OAAO,OAAO,CAAC,qBAAqB,CAAC,CAAC;aACvC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,IAAI,KAAK,CAAC,2CAA2C,qBAAqB,MAAM,CAAC,EAAE,CAAC,CAAC;aAC5F;SACF;aAAM;YACL,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;CACF;AAhED,gEAgEC","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 'path';\nimport { FileSystem } from '@rushstack/node-core-library';\nimport type * as webpack from 'webpack';\nimport type { IBuildStageProperties, ScopedLogger } from '@rushstack/heft';\n\nimport { IWebpackConfiguration } from './shared';\n\n/**\n * See https://webpack.js.org/api/cli/#environment-options\n */\ninterface IWebpackConfigFunctionEnv {\n  prod: boolean;\n  production: boolean;\n}\ntype IWebpackConfigJsExport =\n  | webpack.Configuration\n  | webpack.Configuration[]\n  | Promise<webpack.Configuration>\n  | Promise<webpack.Configuration[]>\n  | ((env: IWebpackConfigFunctionEnv) => webpack.Configuration | webpack.Configuration[])\n  | ((env: IWebpackConfigFunctionEnv) => Promise<webpack.Configuration | webpack.Configuration[]>);\ntype IWebpackConfigJs = IWebpackConfigJsExport | { default: IWebpackConfigJsExport };\n\nconst WEBPACK_CONFIG_FILENAME: string = 'webpack.config.js';\nconst WEBPACK_DEV_CONFIG_FILENAME: string = 'webpack.dev.config.js';\n\nexport class WebpackConfigurationLoader {\n  public static async tryLoadWebpackConfigAsync(\n    logger: ScopedLogger,\n    buildFolder: string,\n    buildProperties: IBuildStageProperties\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    let webpackConfigJs: IWebpackConfigJs | undefined;\n\n    try {\n      if (buildProperties.serveMode) {\n        logger.terminal.writeVerboseLine(\n          `Attempting to load webpack configuration from \"${WEBPACK_DEV_CONFIG_FILENAME}\".`\n        );\n        webpackConfigJs = WebpackConfigurationLoader._tryLoadWebpackConfiguration(\n          buildFolder,\n          WEBPACK_DEV_CONFIG_FILENAME\n        );\n      }\n\n      if (!webpackConfigJs) {\n        logger.terminal.writeVerboseLine(\n          `Attempting to load webpack configuration from \"${WEBPACK_CONFIG_FILENAME}\".`\n        );\n        webpackConfigJs = WebpackConfigurationLoader._tryLoadWebpackConfiguration(\n          buildFolder,\n          WEBPACK_CONFIG_FILENAME\n        );\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        return webpackConfig({ prod: buildProperties.production, production: buildProperties.production });\n      } else {\n        return webpackConfig;\n      }\n    } else {\n      return undefined;\n    }\n  }\n\n  private static _tryLoadWebpackConfiguration(\n    buildFolder: string,\n    configurationFilename: string\n  ): IWebpackConfigJs | undefined {\n    const fullWebpackConfigPath: string = path.join(buildFolder, configurationFilename);\n    if (FileSystem.exists(fullWebpackConfigPath)) {\n      try {\n        return require(fullWebpackConfigPath);\n      } catch (e) {\n        throw new Error(`Error loading webpack configuration at \"${fullWebpackConfigPath}\": ${e}`);\n      }\n    } else {\n      return undefined;\n    }\n  }\n}\n"]}
+{"version":3,"file":"WebpackConfigurationLoader.js","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,2CAA6B;AAE7B,oEAA0D;AAqB1D,MAAM,2BAA2B,GAA0B,qBAAqB,CAAC;AACjF,MAAM,+BAA+B,GAA8B,yBAAyB,CAAC;AAE7F,MAAa,0BAA0B;IAKrC,YAAmB,MAAqB,EAAE,UAAmB,EAAE,SAAkB;QAC/E,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,gCAAgC,CAC3C,OAAyC;QAEzC,4FAA4F;QAC5F,kGAAkG;QAElG,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,GACnG,OAAO,CAAC;QACV,IAAI,eAA6C,CAAC;QAElD,IAAI;YACF,MAAM,eAAe,GAAW,iBAAiB,CAAC,eAAe,CAAC;YAClE,IAAI,IAAI,CAAC,UAAU,EAAE;gBACnB,MAAM,aAAa,GAAW,IAAI,CAAC,OAAO,CACxC,eAAe,EACf,oBAAoB,IAAI,+BAA+B,CACxD,CAAC;gBACF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CACpC,kDAAkD,aAAa,IAAI,CACpE,CAAC;gBACF,eAAe,GAAG,MAAM,IAAI,CAAC,sCAAsC,CAAC,aAAa,CAAC,CAAC;aACpF;YAED,IAAI,CAAC,eAAe,EAAE;gBACpB,MAAM,UAAU,GAAW,IAAI,CAAC,OAAO,CACrC,eAAe,EACf,iBAAiB,IAAI,2BAA2B,CACjD,CAAC;gBACF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CACpC,kDAAkD,UAAU,IAAI,CACjE,CAAC;gBACF,eAAe,GAAG,MAAM,IAAI,CAAC,sCAAsC,CAAC,UAAU,CAAC,CAAC;aACjF;SACF;QAAC,OAAO,KAAK,EAAE;YACd,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAc,CAAC,CAAC;SACxC;QAED,IAAI,eAAe,EAAE;YACnB,MAAM,aAAa,GAChB,eAAuD,CAAC,OAAO,IAAI,eAAe,CAAC;YAEtF,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE;gBACvC,uEAAuE;gBACvE,OAAO,aAAa,CAAC;oBACnB,IAAI,EAAE,IAAI,CAAC,WAAW;oBACtB,UAAU,EAAE,IAAI,CAAC,WAAW;oBAC5B,WAAW;oBACX,iBAAiB;oBACjB,OAAO,EAAE,MAAM,kBAAkB,EAAE;iBACpC,CAAC,CAAC;aACJ;iBAAM;gBACL,OAAO,aAAa,CAAC;aACtB;SACF;aAAM;YACL,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;IAEO,KAAK,CAAC,sCAAsC,CAClD,iBAAyB;QAEzB,MAAM,YAAY,GAAY,MAAM,8BAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAC9E,IAAI,YAAY,EAAE;YAChB,IAAI;gBACF,OAAO,wDAAa,iBAAiB,GAAC,CAAC;aACxC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,KAAK,GAA0B,CAA0B,CAAC;gBAChE,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE;oBACzC,4CAA4C;oBAC5C,OAAO,SAAS,CAAC;iBAClB;gBACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,iBAAiB,MAAM,CAAC,EAAE,CAAC,CAAC;aACxF;SACF;aAAM;YACL,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;CACF;AAxFD,gEAwFC","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 'path';\nimport type * as TWebpack from 'webpack';\nimport { FileSystem } from '@rushstack/node-core-library';\nimport type { IScopedLogger, IHeftTaskSession, HeftConfiguration } from '@rushstack/heft';\n\nimport type { IWebpackPluginOptions } from './Webpack4Plugin';\nimport type { IWebpackConfiguration, IWebpackConfigurationFnEnvironment } 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\ninterface ILoadWebpackConfigurationOptions extends IWebpackPluginOptions {\n  taskSession: IHeftTaskSession;\n  heftConfiguration: HeftConfiguration;\n  loadWebpackAsyncFn: () => Promise<typeof TWebpack>;\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\nexport class WebpackConfigurationLoader {\n  private readonly _logger: IScopedLogger;\n  private readonly _production: boolean;\n  private readonly _serveMode: boolean;\n\n  public constructor(logger: IScopedLogger, production: boolean, serveMode: boolean) {\n    this._logger = logger;\n    this._production = production;\n    this._serveMode = serveMode;\n  }\n\n  public async tryLoadWebpackConfigurationAsync(\n    options: ILoadWebpackConfigurationOptions\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, configurationPath, devConfigurationPath, loadWebpackAsyncFn } =\n      options;\n    let webpackConfigJs: IWebpackConfigJs | undefined;\n\n    try {\n      const buildFolderPath: string = heftConfiguration.buildFolderPath;\n      if (this._serveMode) {\n        const devConfigPath: string = path.resolve(\n          buildFolderPath,\n          devConfigurationPath || DEFAULT_WEBPACK_DEV_CONFIG_PATH\n        );\n        this._logger.terminal.writeVerboseLine(\n          `Attempting to load webpack configuration from \"${devConfigPath}\".`\n        );\n        webpackConfigJs = await this._tryLoadWebpackConfigurationInnerAsync(devConfigPath);\n      }\n\n      if (!webpackConfigJs) {\n        const configPath: string = path.resolve(\n          buildFolderPath,\n          configurationPath || DEFAULT_WEBPACK_CONFIG_PATH\n        );\n        this._logger.terminal.writeVerboseLine(\n          `Attempting to load webpack configuration from \"${configPath}\".`\n        );\n        webpackConfigJs = await this._tryLoadWebpackConfigurationInnerAsync(configPath);\n      }\n    } catch (error) {\n      this._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: this._production,\n          production: this._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  private async _tryLoadWebpackConfigurationInnerAsync(\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}\n"]}

package/lib/index.d.ts

@@ -1,8 +1,3 @@
-import type { IHeftPlugin } from '@rushstack/heft';
-export { IWebpackConfigurationWithDevServer, IWebpackConfiguration, IWebpackBuildStageProperties, IWebpackBundleSubstageProperties } from './shared';
-/**
- * @public
- */
-declare const _default: IHeftPlugin<void>;
-export default _default;
+export { PLUGIN_NAME as PluginName } from './Webpack4Plugin';
+export type { IWebpackConfigurationWithDevServer, IWebpackConfiguration, IWebpackConfigurationFnEnvironment, IWebpackPluginAccessor, IWebpackPluginAccessorHooks } from './shared';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,EACjC,MAAM,UAAU,CAAC;AAElB;;GAEG;;AACH,wBAAkD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7D,YAAY,EACV,kCAAkC,EAClC,qBAAqB,EACrB,kCAAkC,EAClC,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,UAAU,CAAC"}

package/lib/index.js

@@ -2,9 +2,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
-const WebpackPlugin_1 = require("./WebpackPlugin");
-/**
- * @public
- */
-exports.default = new WebpackPlugin_1.WebpackPlugin();
+exports.PluginName = void 0;
+var Webpack4Plugin_1 = require("./Webpack4Plugin");
+Object.defineProperty(exports, "PluginName", { enumerable: true, get: function () { return Webpack4Plugin_1.PLUGIN_NAME; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAI3D,mDAAgD;AAShD;;GAEG;AACH,kBAAe,IAAI,6BAAa,EAAiB,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 { IHeftPlugin } from '@rushstack/heft';\n\nimport { WebpackPlugin } from './WebpackPlugin';\n\nexport {\n  IWebpackConfigurationWithDevServer,\n  IWebpackConfiguration,\n  IWebpackBuildStageProperties,\n  IWebpackBundleSubstageProperties\n} from './shared';\n\n/**\n * @public\n */\nexport default new WebpackPlugin() as IHeftPlugin;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,mDAA6D;AAApD,4GAAA,WAAW,OAAc","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 } from './Webpack4Plugin';\n\nexport type {\n  IWebpackConfigurationWithDevServer,\n  IWebpackConfiguration,\n  IWebpackConfigurationFnEnvironment,\n  IWebpackPluginAccessor,\n  IWebpackPluginAccessorHooks\n} from './shared';\n"]}

package/lib/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/shared.d.ts

@@ -1,44 +1,94 @@
-import type * as webpack from 'webpack';
+import type * as TWebpack from 'webpack';
 declare module 'webpack' {
-    type MultiStats = webpack.compilation.MultiStats;
+    type MultiStats = TWebpack.compilation.MultiStats;
     type StatsOptions = unknown;
-    type StatsCompilation = webpack.compilation.Compilation;
+    type StatsCompilation = TWebpack.compilation.Compilation;
     interface Compiler {
         watching?: unknown;
     }
 }
 import type { Configuration as WebpackDevServerConfiguration } from 'webpack-dev-server';
-import type { IBuildStageProperties, IBundleSubstageProperties } from '@rushstack/heft';
+import type { AsyncParallelHook, AsyncSeriesBailHook, AsyncSeriesHook } from 'tapable';
+import type { IHeftTaskSession, HeftConfiguration } from '@rushstack/heft';
 /**
+ * The environment passed into the Webpack configuration function. Loosely based
+ * on the default Webpack environment options, specified here:
+ * https://webpack.js.org/api/cli/#environment-options
+ *
  * @public
  */
-export interface IWebpackConfigurationWithDevServer extends webpack.Configuration {
+export interface IWebpackConfigurationFnEnvironment {
+    /**
+     * Whether or not the run is in production mode. Synonym of
+     * IWebpackConfigurationFnEnvironment.production.
+     */
+    prod: boolean;
+    /**
+     * Whether or not the run is in production mode. Synonym of
+     * IWebpackConfigurationFnEnvironment.prod.
+     */
+    production: boolean;
+    /**
+     * The task session provided to the plugin.
+     */
+    taskSession: IHeftTaskSession;
+    /**
+     * The Heft configuration provided to the plugin.
+     */
+    heftConfiguration: HeftConfiguration;
+    /**
+     * The resolved Webpack package.
+     */
+    webpack: typeof TWebpack;
+}
+/**
+ * @public
+ */
+export interface IWebpackConfigurationWithDevServer extends TWebpack.Configuration {
     devServer?: WebpackDevServerConfiguration;
 }
 /**
  * @public
  */
-export declare type IWebpackConfiguration = IWebpackConfigurationWithDevServer | IWebpackConfigurationWithDevServer[] | undefined;
+export declare type IWebpackConfiguration = IWebpackConfigurationWithDevServer | IWebpackConfigurationWithDevServer[];
 /**
  * @public
  */
-export interface IWebpackBundleSubstageProperties extends IBundleSubstageProperties {
+export interface IWebpackPluginAccessorHooks {
     /**
-     * The configuration used by the Webpack plugin. This must be populated
-     * for Webpack to run. If webpackConfigFilePath is specified,
-     * this will be populated automatically with the exports of the
-     * config file referenced in that property.
+     * A hook that allows for loading custom configurations used by the Webpack
+     * plugin. If a webpack configuration is provided, this will be populated automatically
+     * with the exports of the config file. If a webpack configuration is not provided,
+     * one will be loaded by the Webpack plugin.
      *
      * @remarks
-     * Tapable event handlers can return `null` instead of `undefined` to suppress
-     * other handlers from creating a configuration object.
+     * Tapable event handlers can return `false` instead of `undefined` to suppress
+     * other handlers from creating a configuration object, and prevent webpack from running.
      */
-    webpackConfiguration?: webpack.Configuration | webpack.Configuration[] | null;
+    readonly onLoadConfiguration: AsyncSeriesBailHook<never, never, never, IWebpackConfiguration | false>;
+    /**
+     * A hook that allows for modification of the loaded configuration used by the Webpack
+     * plugin. If no configuration was loaded, this hook will not be called.
+     */
+    readonly onConfigure: AsyncSeriesHook<IWebpackConfiguration, never, never>;
+    /**
+     * A hook that provides the finalized configuration that will be used by Webpack.
+     * If no configuration was loaded, this hook will not be called.
+     */
+    readonly onAfterConfigure: AsyncParallelHook<IWebpackConfiguration, never, never>;
+    /**
+     * A hook that provides the stats output from Webpack. If no configuration is loaded,
+     * this hook will not be called.
+     */
+    readonly onEmitStats: AsyncParallelHook<TWebpack.Stats | TWebpack.compilation.MultiStats, never, never>;
 }
 /**
  * @public
  */
-export interface IWebpackBuildStageProperties extends IBuildStageProperties {
-    webpackStats?: webpack.Stats | webpack.compilation.MultiStats;
+export interface IWebpackPluginAccessor {
+    /**
+     * Hooks that are called at various points in the Webpack plugin lifecycle.
+     */
+    hooks: IWebpackPluginAccessorHooks;
 }
 //# sourceMappingURL=shared.d.ts.map

package/lib/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AAExC,OAAO,QAAQ,SAAS,CAAC;IACvB,KAAY,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;IACxD,KAAY,YAAY,GAAG,OAAO,CAAC;IACnC,KAAY,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC;IAG/D,UAAiB,QAAQ;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;CACF;AACD,OAAO,KAAK,EAAE,aAAa,IAAI,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,kCAAmC,SAAQ,OAAO,CAAC,aAAa;IAC/E,SAAS,CAAC,EAAE,6BAA6B,CAAC;CAC3C;AAED;;GAEG;AACH,oBAAY,qBAAqB,GAC7B,kCAAkC,GAClC,kCAAkC,EAAE,GACpC,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,gCAAiC,SAAQ,yBAAyB;IACjF;;;;;;;;;OASG;IAGH,oBAAoB,CAAC,EAAE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;CAC/D"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,QAAQ,MAAM,SAAS,CAAC;AAEzC,OAAO,QAAQ,SAAS,CAAC;IACvB,KAAY,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC;IACzD,KAAY,YAAY,GAAG,OAAO,CAAC;IACnC,KAAY,gBAAgB,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC;IAGhE,UAAiB,QAAQ;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;CACF;AACD,OAAO,KAAK,EAAE,aAAa,IAAI,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAGpB;;OAEG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAC9B;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,CAAC;IACrC;;OAEG;IACH,OAAO,EAAE,OAAO,QAAQ,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kCAAmC,SAAQ,QAAQ,CAAC,aAAa;IAChF,SAAS,CAAC,EAAE,6BAA6B,CAAC;CAC3C;AAED;;GAEG;AACH,oBAAY,qBAAqB,GAAG,kCAAkC,GAAG,kCAAkC,EAAE,CAAC;AAE9G;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,GAAG,KAAK,CAAC,CAAC;IACtG;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3E;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAClF;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;CACzG;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,2BAA2B,CAAC;CACpC"}

package/lib/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","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 * as webpack from 'webpack';\n// Compensate for webpack-dev-server referencing constructs from webpack 5\ndeclare module 'webpack' {\n  export type MultiStats = webpack.compilation.MultiStats;\n  export type StatsOptions = unknown;\n  export type StatsCompilation = webpack.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 { IBuildStageProperties, IBundleSubstageProperties } from '@rushstack/heft';\n\n/**\n * @public\n */\nexport interface IWebpackConfigurationWithDevServer extends webpack.Configuration {\n  devServer?: WebpackDevServerConfiguration;\n}\n\n/**\n * @public\n */\nexport type IWebpackConfiguration =\n  | IWebpackConfigurationWithDevServer\n  | IWebpackConfigurationWithDevServer[]\n  | undefined;\n\n/**\n * @public\n */\nexport interface IWebpackBundleSubstageProperties extends IBundleSubstageProperties {\n  /**\n   * The configuration used by the Webpack plugin. This must be populated\n   * for Webpack to run. If webpackConfigFilePath is specified,\n   * this will be populated automatically with the exports of the\n   * config file referenced in that property.\n   *\n   * @remarks\n   * Tapable event handlers can return `null` instead of `undefined` to suppress\n   * other handlers from creating a configuration object.\n   */\n  // We are inheriting this problem from Tapable's API\n  // eslint-disable-next-line @rushstack/no-new-null\n  webpackConfiguration?: webpack.Configuration | webpack.Configuration[] | null;\n}\n\n/**\n * @public\n */\nexport interface IWebpackBuildStageProperties extends IBuildStageProperties {\n  webpackStats?: webpack.Stats | webpack.compilation.MultiStats;\n}\n"]}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","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 * 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';\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 webpack configuration is provided, this will be populated automatically\n   * with the exports of the config file. If a webpack configuration is not provided,\n   * one will be loaded by the Webpack plugin.\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 IWebpackPluginAccessor {\n  /**\n   * Hooks that are called at various points in the Webpack plugin lifecycle.\n   */\n  hooks: IWebpackPluginAccessorHooks;\n}\n"]}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/heft-webpack4-plugin",
-  "version": "0.5.16",
+  "version": "0.6.0-dev.0",
   "description": "Heft plugin for Webpack 4",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   },
   "homepage": "https://rushstack.io/pages/heft/overview/",
   "main": "lib/index.js",
-  "types": "dist/heft-webpack4-plugin.d.ts",
+  "types": "lib/index.d.ts",
   "license": "MIT",
   "peerDependenciesMeta": {
     "@types/webpack": {
@@ -17,18 +17,21 @@
     }
   },
   "peerDependencies": {
-    "@rushstack/heft": "^0.47.10",
+    "@rushstack/heft": "^0.48.0-dev.0",
     "@types/webpack": "^4",
     "webpack": "~4.44.2"
   },
   "dependencies": {
+    "@rushstack/debug-certificate-manager": "1.1.76",
     "@rushstack/node-core-library": "3.52.0",
+    "@types/tapable": "1.0.6",
+    "tapable": "1.1.3",
     "webpack-dev-server": "~4.9.3"
   },
   "devDependencies": {
     "@rushstack/eslint-config": "3.0.1",
-    "@rushstack/heft-node-rig": "1.10.12",
-    "@rushstack/heft": "0.47.10",
+    "@rushstack/heft-node-rig": "1.11.0-dev.0",
+    "@rushstack/heft": "0.48.0-dev.0",
     "@types/node": "12.20.24",
     "@types/webpack": "4.41.32",
     "webpack": "~4.44.2"
@@ -36,7 +39,7 @@
   "scripts": {
     "build": "heft build --clean",
     "start": "heft test --clean --watch",
-    "_phase:build": "heft build --clean",
-    "_phase:test": "heft test --no-build"
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "heft run --only test -- --clean"
   }
 }

package/lib/WebpackPlugin.d.ts

@@ -1,13 +0,0 @@
-import type { HeftConfiguration, HeftSession, IHeftPlugin } from '@rushstack/heft';
-/**
- * @internal
- */
-export declare class WebpackPlugin implements IHeftPlugin {
-    readonly pluginName: string;
-    private static _webpackVersions;
-    private static _getWebpackVersions;
-    apply(heftSession: HeftSession, heftConfiguration: HeftConfiguration): void;
-    private _runWebpackAsync;
-    private _emitErrors;
-}
-//# sourceMappingURL=WebpackPlugin.d.ts.map

package/lib/WebpackPlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebpackPlugin.d.ts","sourceRoot":"","sources":["../src/WebpackPlugin.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EAIX,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAmBzB;;GAEG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,SAAgB,UAAU,EAAE,MAAM,CAAe;IAEjD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA+B;IAC9D,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAkB3B,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,IAAI;YA0CpE,gBAAgB;IAgK9B,OAAO,CAAC,WAAW;CAapB"}

package/lib/WebpackPlugin.js

@@ -1,198 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebpackPlugin = void 0;
-const node_core_library_1 = require("@rushstack/node-core-library");
-const WebpackConfigurationLoader_1 = require("./WebpackConfigurationLoader");
-const webpack = node_core_library_1.Import.lazy('webpack', require);
-const PLUGIN_NAME = 'WebpackPlugin';
-const WEBPACK_DEV_SERVER_PACKAGE_NAME = 'webpack-dev-server';
-const WEBPACK_DEV_SERVER_ENV_VAR_NAME = 'WEBPACK_DEV_SERVER';
-/**
- * @internal
- */
-class WebpackPlugin {
-    constructor() {
-        this.pluginName = PLUGIN_NAME;
-    }
-    static _getWebpackVersions() {
-        if (!WebpackPlugin._webpackVersions) {
-            const webpackDevServerPackageJsonPath = node_core_library_1.Import.resolveModule({
-                modulePath: 'webpack-dev-server/package.json',
-                baseFolderPath: __dirname
-            });
-            const webpackDevServerPackageJson = node_core_library_1.PackageJsonLookup.instance.loadPackageJson(webpackDevServerPackageJsonPath);
-            WebpackPlugin._webpackVersions = {
-                webpackVersion: webpack.version,
-                webpackDevServerVersion: webpackDevServerPackageJson.version
-            };
-        }
-        return WebpackPlugin._webpackVersions;
-    }
-    apply(heftSession, heftConfiguration) {
-        heftSession.hooks.build.tap(PLUGIN_NAME, (build) => {
-            build.hooks.bundle.tap(PLUGIN_NAME, (bundle) => {
-                bundle.hooks.configureWebpack.tap({ name: PLUGIN_NAME, stage: Number.MIN_SAFE_INTEGER }, (webpackConfiguration) => {
-                    const webpackVersions = WebpackPlugin._getWebpackVersions();
-                    bundle.properties.webpackVersion = webpack.version;
-                    bundle.properties.webpackDevServerVersion = webpackVersions.webpackDevServerVersion;
-                    return webpackConfiguration;
-                });
-                bundle.hooks.configureWebpack.tapPromise(PLUGIN_NAME, async (existingConfiguration) => {
-                    const logger = heftSession.requestScopedLogger('configure-webpack');
-                    if (existingConfiguration) {
-                        logger.terminal.writeVerboseLine('Skipping loading webpack config file because the webpack config has already been set.');
-                        return existingConfiguration;
-                    }
-                    else {
-                        return await WebpackConfigurationLoader_1.WebpackConfigurationLoader.tryLoadWebpackConfigAsync(logger, heftConfiguration.buildFolder, build.properties);
-                    }
-                });
-                bundle.hooks.run.tapPromise(PLUGIN_NAME, async () => {
-                    await this._runWebpackAsync(heftSession, bundle.properties, build.properties, heftConfiguration.terminalProvider.supportsColor);
-                });
-            });
-        });
-    }
-    async _runWebpackAsync(heftSession, bundleSubstageProperties, buildProperties, supportsColor) {
-        const webpackConfiguration = bundleSubstageProperties.webpackConfiguration;
-        if (!webpackConfiguration) {
-            return;
-        }
-        const logger = heftSession.requestScopedLogger('webpack');
-        const webpackVersions = WebpackPlugin._getWebpackVersions();
-        if (bundleSubstageProperties.webpackVersion !== webpackVersions.webpackVersion) {
-            logger.emitError(new Error(`The Webpack plugin expected to be configured with Webpack version ${webpackVersions.webpackVersion}, ` +
-                `but the configuration specifies version ${bundleSubstageProperties.webpackVersion}. ` +
-                'Are multiple versions of the Webpack plugin present?'));
-        }
-        if (bundleSubstageProperties.webpackDevServerVersion !== webpackVersions.webpackDevServerVersion) {
-            logger.emitError(new Error(`The Webpack plugin expected to be configured with webpack-dev-server version ${webpackVersions.webpackDevServerVersion}, ` +
-                `but the configuration specifies version ${bundleSubstageProperties.webpackDevServerVersion}. ` +
-                'Are multiple versions of the Webpack plugin present?'));
-        }
-        logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);
-        let compiler;
-        if (Array.isArray(webpackConfiguration)) {
-            if (webpackConfiguration.length === 0) {
-                logger.terminal.writeLine('The webpack configuration received is an empty array - nothing to do.');
-                return;
-            }
-            else {
-                compiler = webpack(webpackConfiguration); /* (webpack.Compilation[]) => MultiCompiler */
-            }
-        }
-        else {
-            compiler = webpack(webpackConfiguration); /* (webpack.Compilation) => Compiler */
-        }
-        if (buildProperties.serveMode) {
-            const defaultDevServerOptions = {
-                host: 'localhost',
-                devMiddleware: {
-                    publicPath: '/',
-                    stats: {
-                        cached: false,
-                        cachedAssets: false,
-                        colors: supportsColor
-                    }
-                },
-                client: {
-                    logging: 'info'
-                },
-                port: 8080
-            };
-            let options;
-            if (Array.isArray(webpackConfiguration)) {
-                const devServerOptions = webpackConfiguration
-                    .map((configuration) => configuration.devServer)
-                    .filter((devServer) => !!devServer);
-                if (devServerOptions.length > 1) {
-                    logger.emitWarning(new Error(`Detected multiple webpack devServer configurations, using the first one.`));
-                }
-                if (devServerOptions.length > 0) {
-                    options = Object.assign(Object.assign({}, defaultDevServerOptions), devServerOptions[0]);
-                }
-                else {
-                    options = defaultDevServerOptions;
-                }
-            }
-            else {
-                options = Object.assign(Object.assign({}, defaultDevServerOptions), webpackConfiguration.devServer);
-            }
-            // Register a plugin to callback after webpack is done with the first compilation
-            // so we can move on to post-build
-            let firstCompilationDoneCallback;
-            const originalBeforeCallback = options.onBeforeSetupMiddleware;
-            options.onBeforeSetupMiddleware = (server) => {
-                compiler.hooks.done.tap('heft-webpack-plugin', () => {
-                    if (firstCompilationDoneCallback) {
-                        firstCompilationDoneCallback();
-                        firstCompilationDoneCallback = undefined;
-                    }
-                });
-                if (originalBeforeCallback) {
-                    return originalBeforeCallback(server);
-                }
-            };
-            // 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.
-            const WebpackDevServer = require(WEBPACK_DEV_SERVER_PACKAGE_NAME);
-            // TODO: the WebpackDevServer accepts a third parameter for a logger. We should make
-            // use of that to make logging cleaner
-            const webpackDevServer = new WebpackDevServer(compiler, options);
-            await new Promise((resolve, reject) => {
-                firstCompilationDoneCallback = resolve;
-                webpackDevServer.listen(options.port, options.host, (error) => {
-                    if (error) {
-                        reject(error);
-                    }
-                });
-            });
-        }
-        else {
-            if (process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {
-                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?)`));
-            }
-            let stats;
-            if (buildProperties.watchMode) {
-                try {
-                    stats = await node_core_library_1.LegacyAdapters.convertCallbackToPromise(compiler.watch.bind(compiler), {});
-                }
-                catch (e) {
-                    logger.emitError(e);
-                }
-            }
-            else {
-                try {
-                    stats = await node_core_library_1.LegacyAdapters.convertCallbackToPromise(compiler.run.bind(compiler));
-                }
-                catch (e) {
-                    logger.emitError(e);
-                }
-            }
-            if (stats) {
-                // eslint-disable-next-line require-atomic-updates
-                buildProperties.webpackStats = stats;
-                this._emitErrors(logger, stats);
-            }
-        }
-    }
-    _emitErrors(logger, stats) {
-        if (stats.hasErrors() || stats.hasWarnings()) {
-            const serializedStats = stats.toJson('errors-warnings');
-            for (const warning of serializedStats.warnings) {
-                logger.emitWarning(warning instanceof Error ? warning : new Error(warning));
-            }
-            for (const error of serializedStats.errors) {
-                logger.emitError(error instanceof Error ? error : new Error(error));
-            }
-        }
-    }
-}
-exports.WebpackPlugin = WebpackPlugin;
-//# sourceMappingURL=WebpackPlugin.js.map