@rushstack/heft-webpack5-plugin 0.5.50 → 0.6.0-dev.0

package/lib/WebpackConfigurationLoader.d.ts

@@ -1,7 +1,19 @@
-import type { IBuildStageProperties, ScopedLogger } from '@rushstack/heft';
-import { IWebpackConfiguration } from './shared';
+import type * as TWebpack from 'webpack';
+import type { IScopedLogger, IHeftTaskSession, HeftConfiguration } from '@rushstack/heft';
+import type { IWebpackPluginOptions } from './Webpack5Plugin';
+import type { IWebpackConfiguration } from './shared';
+interface ILoadWebpackConfigurationOptions extends IWebpackPluginOptions {
+    taskSession: IHeftTaskSession;
+    heftConfiguration: HeftConfiguration;
+    loadWebpackAsyncFn: () => Promise<typeof TWebpack>;
+}
 export declare class WebpackConfigurationLoader {
-    static tryLoadWebpackConfigAsync(logger: ScopedLogger, buildFolder: string, buildProperties: IBuildStageProperties): Promise<IWebpackConfiguration | undefined>;
-    private static _tryLoadWebpackConfiguration;
+    private readonly _logger;
+    private readonly _production;
+    private readonly _serveMode;
+    constructor(logger: IScopedLogger, production: boolean, serveMode: boolean);
+    tryLoadWebpackConfigurationAsync(options: ILoadWebpackConfigurationOptions): Promise<IWebpackConfiguration | undefined>;
+    private _tryLoadWebpackConfigurationInnerAsync;
 }
+export {};
 //# sourceMappingURL=WebpackConfigurationLoader.d.ts.map

package/lib/WebpackConfigurationLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebpackConfigurationLoader.d.ts","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAqBjD,qBAAa,0BAA0B;WACjB,yBAAyB,CAC3C,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,qBAAqB,GACrC,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IA4C7C,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAe5C"}
+{"version":3,"file":"WebpackConfigurationLoader.d.ts","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,QAAQ,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAsC,MAAM,UAAU,CAAC;AAW1F,UAAU,gCAAiC,SAAQ,qBAAqB;IACtE,WAAW,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC;CACpD;AAKD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAElB,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO;IAMpE,gCAAgC,CAC3C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;YAwD/B,sCAAsC;CAmBrD"}

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 './Webpack5Plugin';\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 './Webpack5Plugin';
+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 Webpack5Plugin_1 = require("./Webpack5Plugin");
+Object.defineProperty(exports, "PluginName", { enumerable: true, get: function () { return Webpack5Plugin_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 './Webpack5Plugin';\n\nexport type {\n  IWebpackConfigurationWithDevServer,\n  IWebpackConfiguration,\n  IWebpackConfigurationFnEnvironment,\n  IWebpackPluginAccessor,\n  IWebpackPluginAccessorHooks\n} from './shared';\n"]}

package/lib/schemas/heft-webpack5-plugin.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "title": "Webpack 5 Plugin Configuration",
+  "description": "Defines options for Webpack 5 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,36 +1,86 @@
+import type * as TWebpack from 'webpack';
 import type { Configuration as WebpackDevServerConfiguration } from 'webpack-dev-server';
-import type * as webpack from 'webpack';
-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.MultiStats, never, never>;
 }
 /**
  * @public
  */
-export interface IWebpackBuildStageProperties extends IBuildStageProperties {
-    webpackStats?: webpack.Stats | webpack.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,EAAE,aAAa,IAAI,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AACxC,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,UAAU,CAAC;CACnD"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,QAAQ,MAAM,SAAS,CAAC;AACzC,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,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;CAC7F;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 { Configuration as WebpackDevServerConfiguration } from 'webpack-dev-server';\nimport type * as webpack from 'webpack';\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.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';\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.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/heft-webpack5-plugin",
-  "version": "0.5.50",
+  "version": "0.6.0-dev.0",
   "description": "Heft plugin for Webpack 5",
   "repository": {
     "type": "git",
@@ -12,24 +12,27 @@
   "types": "dist/heft-webpack5-plugin.d.ts",
   "license": "MIT",
   "peerDependencies": {
-    "@rushstack/heft": "^0.47.10",
+    "@rushstack/heft": "^0.48.0-dev.0",
     "webpack": "~5.68.0"
   },
   "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": "0.47.10",
-    "@rushstack/heft-node-rig": "1.10.12",
+    "@rushstack/heft": "0.48.0-dev.0",
+    "@rushstack/heft-node-rig": "1.11.0-dev.0",
     "@types/node": "12.20.24",
     "webpack": "~5.68.0"
   },
   "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,14 +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;
-    private _normalizeError;
-}
-//# 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":"AAcA,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;YA2CpE,gBAAgB;IAiK9B,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,eAAe;CAqBxB"}