@rushstack/heft-webpack5-plugin 0.6.12 → 0.7.0-rc.6

package/lib/WebpackConfigurationLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebpackConfigurationLoader.js","sourceRoot":"","sources":["../src/WebpackConfigurationLoader.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 * as path from 'path';\nimport { type FolderItem, 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\ninterface IWebpackConfigFileNames {\n  dev: string | undefined;\n  prod: string | undefined;\n}\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    const webpackConfigFiles: IWebpackConfigFileNames | undefined = await findWebpackConfigAsync(buildFolder);\n    const webpackDevConfigFilename: string | undefined = webpackConfigFiles.dev;\n    const webpackConfigFilename: string | undefined = webpackConfigFiles.prod;\n\n    let webpackConfigJs: IWebpackConfigJs | undefined;\n\n    try {\n      if (buildProperties.serveMode && webpackDevConfigFilename) {\n        logger.terminal.writeVerboseLine(\n          `Attempting to load webpack configuration from \"${webpackDevConfigFilename}\".`\n        );\n        webpackConfigJs = WebpackConfigurationLoader._tryLoadWebpackConfiguration(\n          buildFolder,\n          webpackDevConfigFilename\n        );\n      }\n\n      if (!webpackConfigJs && webpackConfigFilename) {\n        logger.terminal.writeVerboseLine(\n          `Attempting to load webpack configuration from \"${webpackConfigFilename}\".`\n        );\n        webpackConfigJs = WebpackConfigurationLoader._tryLoadWebpackConfiguration(\n          buildFolder,\n          webpackConfigFilename\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\nasync function findWebpackConfigAsync(buildFolder: string): Promise<IWebpackConfigFileNames> {\n  try {\n    const folderItems: FolderItem[] = await FileSystem.readFolderItemsAsync(buildFolder);\n    const dev: string[] = [];\n    const prod: string[] = [];\n\n    for (const folderItem of folderItems) {\n      if (folderItem.isFile()) {\n        if (folderItem.name.match(/^webpack.dev.config\\.(cjs|js|mjs)$/)) {\n          dev.push(folderItem.name);\n        } else if (folderItem.name.match(/^webpack.config\\.(cjs|js|mjs)$/)) {\n          prod.push(folderItem.name);\n        }\n      }\n    }\n\n    if (dev.length > 1) {\n      throw new Error(`Error: Found more than one dev webpack configuration file.`);\n    } else if (prod.length > 1) {\n      throw new Error(`Error: Found more than one non-dev webpack configuration file.`);\n    }\n\n    return {\n      dev: dev[0],\n      prod: prod[0]\n    };\n  } catch (e) {\n    throw new Error(`Error finding webpack configuration: ${e}`);\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,yBAAa,iBAAiB,uCAAC,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, IWebpackPluginAccessorParameters } 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,EAC3B,gCAAgC,EACjC,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  IWebpackPluginAccessorParameters\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,99 @@
+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 type IWebpackConfiguration = IWebpackConfigurationWithDevServer | IWebpackConfigurationWithDevServer[] | undefined;
+export 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.
+     */
+    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.
      */
-    webpackConfiguration?: webpack.Configuration | webpack.Configuration[] | null;
+    readonly onEmitStats: AsyncParallelHook<TWebpack.Stats | TWebpack.MultiStats, never, never>;
 }
 /**
  * @public
  */
-export interface IWebpackBuildStageProperties extends IBuildStageProperties {
-    webpackStats?: webpack.Stats | webpack.MultiStats;
+export interface IWebpackPluginAccessorParameters {
+    /**
+     * Whether or not serve mode was enabled by passing the `--serve` flag.
+     */
+    readonly isServeMode: boolean;
+}
+/**
+ * @public
+ */
+export interface IWebpackPluginAccessor {
+    /**
+     * Hooks that are called at various points in the Webpack plugin lifecycle.
+     */
+    readonly hooks: IWebpackPluginAccessorHooks;
+    /**
+     * Parameters that are provided by the Webpack plugin.
+     */
+    readonly parameters: IWebpackPluginAccessorParameters;
 }
 //# 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,MAAM,MAAM,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,MAAM,MAAM,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,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC;CACvD"}

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 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/heft-webpack5-plugin",
-  "version": "0.6.12",
+  "version": "0.7.0-rc.6",
   "description": "Heft plugin for Webpack 5",
   "repository": {
     "type": "git",
@@ -12,24 +12,29 @@
   "types": "dist/heft-webpack5-plugin.d.ts",
   "license": "MIT",
   "peerDependencies": {
-    "@rushstack/heft": "^0.50.7",
+    "@rushstack/heft": "^0.50.6",
     "webpack": "~5.80.0"
   },
   "dependencies": {
+    "@types/tapable": "1.0.6",
+    "tapable": "1.1.3",
+    "watchpack": "2.4.0",
     "webpack-dev-server": "~4.9.3",
-    "@rushstack/node-core-library": "3.59.2"
+    "@rushstack/debug-certificate-manager": "1.2.27",
+    "@rushstack/node-core-library": "3.59.1"
   },
   "devDependencies": {
     "@types/node": "14.18.36",
+    "@types/watchpack": "2.4.0",
     "webpack": "~5.80.0",
-    "@rushstack/heft": "0.50.7",
-    "@rushstack/heft-node-rig": "1.13.1",
-    "@rushstack/eslint-config": "3.3.0"
+    "@rushstack/eslint-config": "3.3.0",
+    "@rushstack/heft": "0.51.0-rc.6",
+    "@rushstack/heft-node-rig": "1.14.0-rc.6"
   },
   "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;IAoK9B,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,eAAe;CAqBxB"}

package/lib/WebpackPlugin.js

@@ -1,266 +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.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebpackPlugin = void 0;
-const nodePath = __importStar(require("path"));
-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, heftConfiguration, bundle.properties, build.properties, heftConfiguration.terminalProvider.supportsColor);
-                });
-            });
-        });
-    }
-    async _runWebpackAsync(heftSession, heftConfiguration, 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 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',
-                    webSocketURL: {
-                        port: 8080
-                    }
-                },
-                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.setupMiddlewares;
-            options.setupMiddlewares = (middlewares, devServer) => {
-                compiler.hooks.done.tap('heft-webpack-plugin', () => {
-                    if (firstCompilationDoneCallback) {
-                        firstCompilationDoneCallback();
-                        firstCompilationDoneCallback = undefined;
-                    }
-                });
-                if (originalBeforeCallback) {
-                    return originalBeforeCallback(middlewares, devServer);
-                }
-                return middlewares;
-            };
-            // 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(options, compiler);
-            await new Promise((resolve, reject) => {
-                firstCompilationDoneCallback = resolve;
-                // Wrap in promise.resolve due to small issue in the type declaration, return type should be
-                // webpackDevServer.start(): Promise<void>;
-                Promise.resolve(webpackDevServer.start()).catch(reject);
-            });
-        }
-        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));
-                    await node_core_library_1.LegacyAdapters.convertCallbackToPromise(compiler.close.bind(compiler));
-                }
-                catch (e) {
-                    logger.emitError(e);
-                }
-            }
-            if (stats) {
-                // eslint-disable-next-line require-atomic-updates
-                buildProperties.webpackStats = stats;
-                this._emitErrors(logger, heftConfiguration.buildFolder, stats);
-            }
-        }
-    }
-    _emitErrors(logger, buildFolder, stats) {
-        if (stats.hasErrors() || stats.hasWarnings()) {
-            const serializedStats = [stats.toJson('errors-warnings')];
-            const errors = [];
-            const warnings = [];
-            for (const compilationStats of serializedStats) {
-                if (compilationStats.warnings) {
-                    for (const warning of compilationStats.warnings) {
-                        warnings.push(this._normalizeError(buildFolder, warning));
-                    }
-                }
-                if (compilationStats.errors) {
-                    for (const error of compilationStats.errors) {
-                        errors.push(this._normalizeError(buildFolder, error));
-                    }
-                }
-                if (compilationStats.children) {
-                    for (const child of compilationStats.children) {
-                        serializedStats.push(child);
-                    }
-                }
-            }
-            for (const warning of warnings) {
-                logger.emitWarning(warning);
-            }
-            for (const error of errors) {
-                logger.emitError(error);
-            }
-        }
-    }
-    _normalizeError(buildFolder, error) {
-        if (error instanceof Error) {
-            return error;
-        }
-        else {
-            let moduleName = error.moduleName;
-            if (!moduleName && error.moduleIdentifier) {
-                moduleName = node_core_library_1.Path.convertToSlashes(nodePath.relative(buildFolder, error.moduleIdentifier));
-            }
-            let formattedError;
-            if (error.loc && moduleName) {
-                formattedError = `${moduleName}:${error.loc} - ${error.message}`;
-            }
-            else if (moduleName) {
-                formattedError = `${moduleName} - ${error.message}`;
-            }
-            else {
-                formattedError = error.message;
-            }
-            return new Error(formattedError);
-        }
-    }
-}
-exports.WebpackPlugin = WebpackPlugin;
-//# sourceMappingURL=WebpackPlugin.js.map

package/lib/WebpackPlugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebpackPlugin.js","sourceRoot":"","sources":["../src/WebpackPlugin.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 * as nodePath from 'path';\nimport type {\n  Compiler as WebpackCompiler,\n  MultiCompiler as WebpackMultiCompiler,\n  Stats as WebpackStats,\n  MultiStats as WebpackMultiStats,\n  StatsCompilation as WebpackStatsCompilation,\n  StatsError as WebpackStatsError\n} from 'webpack';\nimport type TWebpackDevServer from 'webpack-dev-server';\nimport { LegacyAdapters, Path, Import, IPackageJson, PackageJsonLookup } from '@rushstack/node-core-library';\nimport type {\n  HeftConfiguration,\n  HeftSession,\n  IBuildStageContext,\n  IBuildStageProperties,\n  IBundleSubstage,\n  IHeftPlugin,\n  ScopedLogger\n} from '@rushstack/heft';\nimport type {\n  IWebpackConfiguration,\n  IWebpackBundleSubstageProperties,\n  IWebpackBuildStageProperties\n} from './shared';\nimport { WebpackConfigurationLoader } from './WebpackConfigurationLoader';\n\nconst webpack: typeof import('webpack') = Import.lazy('webpack', require);\n\nconst PLUGIN_NAME: string = 'WebpackPlugin';\nconst WEBPACK_DEV_SERVER_PACKAGE_NAME: string = 'webpack-dev-server';\nconst WEBPACK_DEV_SERVER_ENV_VAR_NAME: string = 'WEBPACK_DEV_SERVER';\n\ninterface IWebpackVersions {\n  webpackVersion: string;\n  webpackDevServerVersion: string;\n}\n\n/**\n * @internal\n */\nexport class WebpackPlugin implements IHeftPlugin {\n  public readonly pluginName: string = PLUGIN_NAME;\n\n  private static _webpackVersions: IWebpackVersions | undefined;\n  private static _getWebpackVersions(): IWebpackVersions {\n    if (!WebpackPlugin._webpackVersions) {\n      const webpackDevServerPackageJsonPath: string = Import.resolveModule({\n        modulePath: 'webpack-dev-server/package.json',\n        baseFolderPath: __dirname\n      });\n      const webpackDevServerPackageJson: IPackageJson = PackageJsonLookup.instance.loadPackageJson(\n        webpackDevServerPackageJsonPath\n      );\n      WebpackPlugin._webpackVersions = {\n        webpackVersion: webpack.version!,\n        webpackDevServerVersion: webpackDevServerPackageJson.version\n      };\n    }\n\n    return WebpackPlugin._webpackVersions;\n  }\n\n  public apply(heftSession: HeftSession, heftConfiguration: HeftConfiguration): void {\n    heftSession.hooks.build.tap(PLUGIN_NAME, (build: IBuildStageContext) => {\n      build.hooks.bundle.tap(PLUGIN_NAME, (bundle: IBundleSubstage) => {\n        bundle.hooks.configureWebpack.tap(\n          { name: PLUGIN_NAME, stage: Number.MIN_SAFE_INTEGER },\n          (webpackConfiguration: unknown) => {\n            const webpackVersions: IWebpackVersions = WebpackPlugin._getWebpackVersions();\n            bundle.properties.webpackVersion = webpack.version;\n            bundle.properties.webpackDevServerVersion = webpackVersions.webpackDevServerVersion;\n\n            return webpackConfiguration;\n          }\n        );\n\n        bundle.hooks.configureWebpack.tapPromise(PLUGIN_NAME, async (existingConfiguration: unknown) => {\n          const logger: ScopedLogger = heftSession.requestScopedLogger('configure-webpack');\n          if (existingConfiguration) {\n            logger.terminal.writeVerboseLine(\n              'Skipping loading webpack config file because the webpack config has already been set.'\n            );\n            return existingConfiguration;\n          } else {\n            return await WebpackConfigurationLoader.tryLoadWebpackConfigAsync(\n              logger,\n              heftConfiguration.buildFolder,\n              build.properties\n            );\n          }\n        });\n\n        bundle.hooks.run.tapPromise(PLUGIN_NAME, async () => {\n          await this._runWebpackAsync(\n            heftSession,\n            heftConfiguration,\n            bundle.properties as IWebpackBundleSubstageProperties,\n            build.properties,\n            heftConfiguration.terminalProvider.supportsColor\n          );\n        });\n      });\n    });\n  }\n\n  private async _runWebpackAsync(\n    heftSession: HeftSession,\n    heftConfiguration: HeftConfiguration,\n    bundleSubstageProperties: IWebpackBundleSubstageProperties,\n    buildProperties: IBuildStageProperties,\n    supportsColor: boolean\n  ): Promise<void> {\n    const webpackConfiguration: IWebpackConfiguration | undefined | null =\n      bundleSubstageProperties.webpackConfiguration;\n    if (!webpackConfiguration) {\n      return;\n    }\n\n    const logger: ScopedLogger = heftSession.requestScopedLogger('webpack');\n    const webpackVersions: IWebpackVersions = WebpackPlugin._getWebpackVersions();\n    if (bundleSubstageProperties.webpackVersion !== webpackVersions.webpackVersion) {\n      logger.emitError(\n        new Error(\n          `The Webpack plugin expected to be configured with Webpack version ${webpackVersions.webpackVersion}, ` +\n            `but the configuration specifies version ${bundleSubstageProperties.webpackVersion}. ` +\n            'Are multiple versions of the Webpack plugin present?'\n        )\n      );\n    }\n\n    if (bundleSubstageProperties.webpackDevServerVersion !== webpackVersions.webpackDevServerVersion) {\n      logger.emitError(\n        new Error(\n          `The Webpack plugin expected to be configured with webpack-dev-server version ${webpackVersions.webpackDevServerVersion}, ` +\n            `but the configuration specifies version ${bundleSubstageProperties.webpackDevServerVersion}. ` +\n            'Are multiple versions of the Webpack plugin present?'\n        )\n      );\n    }\n\n    logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);\n\n    let compiler: WebpackCompiler | WebpackMultiCompiler;\n    if (Array.isArray(webpackConfiguration)) {\n      if (webpackConfiguration.length === 0) {\n        logger.terminal.writeLine('The webpack configuration is an empty array - nothing to do.');\n        return;\n      } else {\n        compiler = webpack(webpackConfiguration); /* (webpack.Compilation[]) => MultiCompiler */\n      }\n    } else {\n      compiler = webpack(webpackConfiguration); /* (webpack.Compilation) => Compiler */\n    }\n\n    if (buildProperties.serveMode) {\n      const defaultDevServerOptions: TWebpackDevServer.Configuration = {\n        host: 'localhost',\n        devMiddleware: {\n          publicPath: '/',\n          stats: {\n            cached: false,\n            cachedAssets: false,\n            colors: supportsColor\n          }\n        },\n        client: {\n          logging: 'info',\n          webSocketURL: {\n            port: 8080\n          }\n        },\n        port: 8080\n      };\n\n      let options: TWebpackDevServer.Configuration;\n      if (Array.isArray(webpackConfiguration)) {\n        const devServerOptions: TWebpackDevServer.Configuration[] = webpackConfiguration\n          .map((configuration) => configuration.devServer)\n          .filter((devServer): devServer is TWebpackDevServer.Configuration => !!devServer);\n        if (devServerOptions.length > 1) {\n          logger.emitWarning(\n            new Error(`Detected multiple webpack devServer configurations, using the first one.`)\n          );\n        }\n\n        if (devServerOptions.length > 0) {\n          options = { ...defaultDevServerOptions, ...devServerOptions[0] };\n        } else {\n          options = defaultDevServerOptions;\n        }\n      } else {\n        options = { ...defaultDevServerOptions, ...webpackConfiguration.devServer };\n      }\n\n      // Register a plugin to callback after webpack is done with the first compilation\n      // so we can move on to post-build\n      let firstCompilationDoneCallback: (() => void) | undefined;\n      const originalBeforeCallback: typeof options.setupMiddlewares | undefined = options.setupMiddlewares;\n      options.setupMiddlewares = (middlewares, devServer) => {\n        compiler.hooks.done.tap('heft-webpack-plugin', () => {\n          if (firstCompilationDoneCallback) {\n            firstCompilationDoneCallback();\n            firstCompilationDoneCallback = undefined;\n          }\n        });\n\n        if (originalBeforeCallback) {\n          return originalBeforeCallback(middlewares, devServer);\n        }\n        return middlewares;\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 require()\n      // only if Heft is in serve mode.\n      const WebpackDevServer: typeof TWebpackDevServer = require(WEBPACK_DEV_SERVER_PACKAGE_NAME);\n      // TODO: the WebpackDevServer accepts a third parameter for a logger. We should make\n      // use of that to make logging cleaner\n      const webpackDevServer: TWebpackDevServer = new WebpackDevServer(options, compiler);\n\n      await new Promise<void>((resolve: () => void, reject: (error: Error) => void) => {\n        firstCompilationDoneCallback = resolve;\n\n        // Wrap in promise.resolve due to small issue in the type declaration, return type should be\n        // webpackDevServer.start(): Promise<void>;\n        Promise.resolve(webpackDevServer.start()).catch(reject);\n      });\n    } else {\n      if (process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {\n        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      let stats: WebpackStats | WebpackMultiStats | undefined;\n      if (buildProperties.watchMode) {\n        try {\n          stats = await LegacyAdapters.convertCallbackToPromise(\n            (compiler as WebpackCompiler).watch.bind(compiler),\n            {}\n          );\n        } catch (e) {\n          logger.emitError(e as Error);\n        }\n      } else {\n        try {\n          stats = await LegacyAdapters.convertCallbackToPromise(\n            (compiler as WebpackCompiler).run.bind(compiler)\n          );\n          await LegacyAdapters.convertCallbackToPromise(compiler.close.bind(compiler));\n        } catch (e) {\n          logger.emitError(e as Error);\n        }\n      }\n\n      if (stats) {\n        // eslint-disable-next-line require-atomic-updates\n        (buildProperties as IWebpackBuildStageProperties).webpackStats = stats;\n\n        this._emitErrors(logger, heftConfiguration.buildFolder, stats);\n      }\n    }\n  }\n\n  private _emitErrors(\n    logger: ScopedLogger,\n    buildFolder: string,\n    stats: WebpackStats | WebpackMultiStats\n  ): void {\n    if (stats.hasErrors() || stats.hasWarnings()) {\n      const serializedStats: WebpackStatsCompilation[] = [stats.toJson('errors-warnings')];\n\n      const errors: Error[] = [];\n      const warnings: Error[] = [];\n\n      for (const compilationStats of serializedStats) {\n        if (compilationStats.warnings) {\n          for (const warning of compilationStats.warnings) {\n            warnings.push(this._normalizeError(buildFolder, warning));\n          }\n        }\n\n        if (compilationStats.errors) {\n          for (const error of compilationStats.errors) {\n            errors.push(this._normalizeError(buildFolder, error));\n          }\n        }\n\n        if (compilationStats.children) {\n          for (const child of compilationStats.children) {\n            serializedStats.push(child);\n          }\n        }\n      }\n\n      for (const warning of warnings) {\n        logger.emitWarning(warning);\n      }\n\n      for (const error of errors) {\n        logger.emitError(error);\n      }\n    }\n  }\n\n  private _normalizeError(buildFolder: string, error: WebpackStatsError): Error {\n    if (error instanceof Error) {\n      return error;\n    } else {\n      let moduleName: string | undefined = error.moduleName;\n      if (!moduleName && error.moduleIdentifier) {\n        moduleName = Path.convertToSlashes(nodePath.relative(buildFolder, error.moduleIdentifier));\n      }\n\n      let formattedError: string;\n      if (error.loc && moduleName) {\n        formattedError = `${moduleName}:${error.loc} - ${error.message}`;\n      } else if (moduleName) {\n        formattedError = `${moduleName} - ${error.message}`;\n      } else {\n        formattedError = error.message;\n      }\n\n      return new Error(formattedError);\n    }\n  }\n}\n"]}