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

package/README.md

@@ -1,11 +1,12 @@
 # @rushstack/heft-webpack4-plugin
 
-This is a Heft plugin for using Webpack 4 during the "bundle" stage.
+This is a Heft plugin for using Webpack 4.
 
 ## Links
 
 - [CHANGELOG.md](
   https://github.com/microsoft/rushstack/blob/main/heft-plugins/heft-webpack4-plugin/CHANGELOG.md) - Find
   out what's new in the latest version
+- [@rushstack/heft](https://www.npmjs.com/package/@rushstack/heft) - Heft is a config-driven toolchain that invokes popular tools such as TypeScript, ESLint, Jest, Webpack, and API Extractor.
 
 Heft is part of the [Rush Stack](https://rushstack.io/) family of projects.

package/dist/heft-webpack4-plugin.d.ts

@@ -1,49 +1,100 @@
+import type { AsyncParallelHook } from 'tapable';
+import type { AsyncSeriesBailHook } from 'tapable';
+import type { AsyncSeriesHook } from 'tapable';
 import type { Configuration } from 'webpack-dev-server';
-import type { IBuildStageProperties } from '@rushstack/heft';
-import type { IBundleSubstageProperties } from '@rushstack/heft';
-import type { IHeftPlugin } from '@rushstack/heft';
-import type * as webpack from 'webpack';
+import type { HeftConfiguration } from '@rushstack/heft';
+import type { IHeftTaskSession } from '@rushstack/heft';
+import type * as TWebpack from 'webpack';
 
 /**
  * @public
  */
-declare const _default: IHeftPlugin<void>;
-export default _default;
+export declare type IWebpackConfiguration = IWebpackConfigurationWithDevServer | IWebpackConfigurationWithDevServer[];
 
 /**
+ * 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 declare interface IWebpackBuildStageProperties extends IBuildStageProperties {
-    webpackStats?: webpack.Stats | webpack.compilation.MultiStats;
+export declare 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 declare interface IWebpackConfigurationWithDevServer extends TWebpack.Configuration {
+    devServer?: Configuration;
 }
 
 /**
  * @public
  */
-export declare interface IWebpackBundleSubstageProperties extends IBundleSubstageProperties {
+export declare interface IWebpackPluginAccessor {
     /**
-     * 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.
-     *
-     * @remarks
-     * Tapable event handlers can return `null` instead of `undefined` to suppress
-     * other handlers from creating a configuration object.
+     * Hooks that are called at various points in the Webpack plugin lifecycle.
      */
-    webpackConfiguration?: webpack.Configuration | webpack.Configuration[] | null;
+    hooks: IWebpackPluginAccessorHooks;
 }
 
 /**
  * @public
  */
-export declare type IWebpackConfiguration = IWebpackConfigurationWithDevServer | IWebpackConfigurationWithDevServer[] | undefined;
+export declare interface IWebpackPluginAccessorHooks {
+    /**
+     * 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 `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.
+     */
+    readonly onEmitStats: AsyncParallelHook<TWebpack.Stats | TWebpack.compilation.MultiStats, never, never>;
+}
 
 /**
  * @public
  */
-export declare interface IWebpackConfigurationWithDevServer extends webpack.Configuration {
-    devServer?: Configuration;
-}
+export declare const PluginName: 'Webpack4Plugin';
 
 export { }

package/heft-plugin.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/heft/heft-plugin.schema.json",
+
+  "taskPlugins": [
+    {
+      "pluginName": "Webpack4Plugin",
+      "entryPoint": "./lib/Webpack4Plugin",
+      "optionsSchema": "./lib/schemas/heft-webpack4-plugin.schema.json",
+
+      "parameterScope": "webpack4",
+      "parameters": [
+        {
+          "longName": "--serve",
+          "parameterKind": "flag",
+          "description": "Start a local web server for testing purposes using webpack-dev-server.  This parameter is only available when running in watch mode."
+        }
+      ]
+    }
+  ]
+}

package/lib/Webpack4Plugin.d.ts

@@ -0,0 +1,32 @@
+import type { HeftConfiguration, IHeftTaskSession, IHeftTaskPlugin } from '@rushstack/heft';
+import type { IWebpackPluginAccessor } from './shared';
+export interface IWebpackPluginOptions {
+    devConfigurationPath: string | undefined;
+    configurationPath: string | undefined;
+}
+/**
+ * @public
+ */
+export declare const PLUGIN_NAME: 'Webpack4Plugin';
+/**
+ * @internal
+ */
+export default class Webpack4Plugin implements IHeftTaskPlugin<IWebpackPluginOptions> {
+    private _serve;
+    private _webpack;
+    private _webpackCompiler;
+    private _webpackConfiguration;
+    private _webpackWatchers;
+    private _webpackCompilationDonePromise;
+    private _webpackCompilationDonePromiseResolveFn;
+    readonly accessor: IWebpackPluginAccessor;
+    apply(taskSession: IHeftTaskSession, heftConfiguration: HeftConfiguration, options: IWebpackPluginOptions): void;
+    private _getWebpackConfigurationAsync;
+    private _loadWebpackAsync;
+    private _getWebpackCompilerAsync;
+    private _runWebpackAsync;
+    private _runWebpackWatchAsync;
+    private _validateEnvironmentVariable;
+    private _emitErrors;
+}
+//# sourceMappingURL=Webpack4Plugin.d.ts.map

package/lib/Webpack4Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webpack4Plugin.d.ts","sourceRoot":"","sources":["../src/Webpack4Plugin.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEhB,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAGV,sBAAsB,EACvB,MAAM,UAAU,CAAC;AA8BlB,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAmC,CAAC;AAQ9D;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,eAAe,CAAC,qBAAqB,CAAC;IACnF,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,gBAAgB,CAAuD;IAC/E,OAAO,CAAC,qBAAqB,CAA2E;IACxG,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,8BAA8B,CAA4B;IAClE,OAAO,CAAC,uCAAuC,CAA2B;IAE1E,SAAgB,QAAQ,EAAE,sBAAsB,CAO9C;IAEK,KAAK,CACV,WAAW,EAAE,gBAAgB,EAC7B,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,qBAAqB,GAC7B,IAAI;YA4CO,6BAA6B;YAoD7B,iBAAiB;YAQjB,wBAAwB;YAgBxB,gBAAgB;YA6ChB,qBAAqB;IA6KnC,OAAO,CAAC,4BAA4B;IAYpC,OAAO,CAAC,WAAW;CAapB"}

package/lib/Webpack4Plugin.js

@@ -0,0 +1,329 @@
+"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.PLUGIN_NAME = void 0;
+const tapable_1 = require("tapable");
+const debug_certificate_manager_1 = require("@rushstack/debug-certificate-manager");
+const node_core_library_1 = require("@rushstack/node-core-library");
+const WebpackConfigurationLoader_1 = require("./WebpackConfigurationLoader");
+/**
+ * @public
+ */
+exports.PLUGIN_NAME = 'Webpack4Plugin';
+const SERVE_PARAMETER_LONG_NAME = '--serve';
+const WEBPACK_PACKAGE_NAME = 'webpack';
+const WEBPACK_DEV_SERVER_PACKAGE_NAME = 'webpack-dev-server';
+const WEBPACK_DEV_SERVER_ENV_VAR_NAME = 'WEBPACK_DEV_SERVER';
+const WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME = 'webpack-dev-middleware';
+const UNINITIALIZED = 'UNINITIALIZED';
+/**
+ * @internal
+ */
+class Webpack4Plugin {
+    constructor() {
+        this._serve = false;
+        this._webpackConfiguration = UNINITIALIZED;
+        this.accessor = {
+            hooks: {
+                onLoadConfiguration: new tapable_1.AsyncSeriesBailHook(),
+                onConfigure: new tapable_1.AsyncSeriesHook(['webpackConfiguration']),
+                onAfterConfigure: new tapable_1.AsyncParallelHook(['webpackConfiguration']),
+                onEmitStats: new tapable_1.AsyncParallelHook(['webpackStats'])
+            }
+        };
+    }
+    apply(taskSession, heftConfiguration, options) {
+        this._serve = taskSession.parameters.getFlagParameter(SERVE_PARAMETER_LONG_NAME).value;
+        if (!taskSession.parameters.watch && this._serve) {
+            throw new Error(`The ${JSON.stringify(SERVE_PARAMETER_LONG_NAME)} parameter is only available when running in watch mode.`);
+        }
+        taskSession.hooks.clean.tapPromise(exports.PLUGIN_NAME, async (cleanOptions) => {
+            var _a;
+            // Obtain the finalized webpack configuration
+            const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);
+            if (webpackConfiguration) {
+                const webpackConfigurationArray = Array.isArray(webpackConfiguration)
+                    ? webpackConfiguration
+                    : [webpackConfiguration];
+                // Add each output path to the clean list
+                // NOTE: Webpack plugins that write assets to paths that start with '../' or outside of the
+                // `output.path` will need to be manually added to the phase-level cleanup list in heft.json.
+                for (const config of webpackConfigurationArray) {
+                    if ((_a = config.output) === null || _a === void 0 ? void 0 : _a.path) {
+                        cleanOptions.addDeleteOperations({ sourcePath: config.output.path });
+                    }
+                }
+            }
+        });
+        taskSession.hooks.run.tapPromise(exports.PLUGIN_NAME, async (runOptions) => {
+            await this._runWebpackAsync(taskSession, heftConfiguration, options);
+        });
+        taskSession.hooks.runIncremental.tapPromise(exports.PLUGIN_NAME, async (runOptions) => {
+            await this._runWebpackWatchAsync(taskSession, heftConfiguration, options);
+        });
+    }
+    async _getWebpackConfigurationAsync(taskSession, heftConfiguration, options) {
+        if (this._webpackConfiguration === UNINITIALIZED) {
+            // Obtain the webpack configuration by calling into the hook. If undefined
+            // is returned, load the default Webpack configuration.
+            taskSession.logger.terminal.writeVerboseLine('Attempting to load Webpack configuration via external plugins');
+            let webpackConfiguration = await this.accessor.hooks.onLoadConfiguration.promise();
+            if (webpackConfiguration === undefined) {
+                taskSession.logger.terminal.writeVerboseLine('Attempt to load the default Webpack configuration');
+                const configurationLoader = new WebpackConfigurationLoader_1.WebpackConfigurationLoader(taskSession.logger, taskSession.parameters.production, taskSession.parameters.watch && this._serve);
+                webpackConfiguration = await configurationLoader.tryLoadWebpackConfigurationAsync(Object.assign(Object.assign({}, options), { taskSession,
+                    heftConfiguration, loadWebpackAsyncFn: this._loadWebpackAsync.bind(this) }));
+            }
+            if (webpackConfiguration === false) {
+                taskSession.logger.terminal.writeLine('Webpack disabled by external plugin');
+                this._webpackConfiguration = undefined;
+            }
+            else if (webpackConfiguration === undefined ||
+                (Array.isArray(webpackConfiguration) && webpackConfiguration.length === 0)) {
+                taskSession.logger.terminal.writeLine('No Webpack configuration found');
+                this._webpackConfiguration = undefined;
+            }
+            else {
+                if (this.accessor.hooks.onConfigure.isUsed()) {
+                    // Allow for plugins to customise the configuration
+                    await this.accessor.hooks.onConfigure.promise(webpackConfiguration);
+                }
+                if (this.accessor.hooks.onAfterConfigure.isUsed()) {
+                    // Provide the finalized configuration
+                    await this.accessor.hooks.onAfterConfigure.promise(webpackConfiguration);
+                }
+                this._webpackConfiguration = webpackConfiguration;
+            }
+        }
+        return this._webpackConfiguration;
+    }
+    async _loadWebpackAsync() {
+        if (!this._webpack) {
+            // Allow this to fail if webpack is not installed
+            this._webpack = await Promise.resolve().then(() => __importStar(require(WEBPACK_PACKAGE_NAME)));
+        }
+        return this._webpack;
+    }
+    async _getWebpackCompilerAsync(taskSession, webpackConfiguration) {
+        if (!this._webpackCompiler) {
+            const webpack = await this._loadWebpackAsync();
+            taskSession.logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);
+            this._webpackCompiler = Array.isArray(webpackConfiguration)
+                ? webpack.default(webpackConfiguration) /* (webpack.Compilation[]) => MultiCompiler */
+                : webpack.default(webpackConfiguration); /* (webpack.Compilation) => Compiler */
+        }
+        return this._webpackCompiler;
+    }
+    async _runWebpackAsync(taskSession, heftConfiguration, options) {
+        this._validateEnvironmentVariable(taskSession);
+        if (taskSession.parameters.watch || this._serve) {
+            // Should never happen, but just in case
+            throw new node_core_library_1.InternalError('Cannot run Webpack in compilation mode when watch mode is enabled');
+        }
+        // Load the config and compiler, and return if there is no config found
+        const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);
+        if (!webpackConfiguration) {
+            return;
+        }
+        const compiler = await this._getWebpackCompilerAsync(taskSession, webpackConfiguration);
+        taskSession.logger.terminal.writeLine('Running Webpack compilation');
+        // Run the webpack compiler
+        let stats;
+        try {
+            stats = await node_core_library_1.LegacyAdapters.convertCallbackToPromise(compiler.run.bind(compiler));
+        }
+        catch (e) {
+            taskSession.logger.emitError(e);
+        }
+        // Emit the errors from the stats object, if present
+        if (stats) {
+            this._emitErrors(taskSession.logger, stats);
+            if (this.accessor.hooks.onEmitStats.isUsed()) {
+                await this.accessor.hooks.onEmitStats.promise(stats);
+            }
+        }
+    }
+    async _runWebpackWatchAsync(taskSession, heftConfiguration, options) {
+        var _a;
+        // Save a handle to the original promise, since the this-scoped promise will be replaced whenever
+        // the compilation completes.
+        let webpackCompilationDonePromise = this._webpackCompilationDonePromise;
+        if (!this._webpackWatchers) {
+            this._validateEnvironmentVariable(taskSession);
+            if (!taskSession.parameters.watch) {
+                // Should never happen, but just in case
+                throw new node_core_library_1.InternalError('Cannot run Webpack in watch mode when compilation mode is enabled');
+            }
+            // Load the config and compiler, and return if there is no config found
+            const webpackConfiguration = await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);
+            if (!webpackConfiguration) {
+                return;
+            }
+            // Get the compiler which will be used for both serve and watch mode
+            const compiler = await this._getWebpackCompilerAsync(taskSession, webpackConfiguration);
+            // Set up the hook to detect when the watcher completes the watcher compilation. We will also log out
+            // errors from the compilation if present from the output stats object.
+            this._webpackCompilationDonePromise = new Promise((resolve) => {
+                this._webpackCompilationDonePromiseResolveFn = resolve;
+            });
+            webpackCompilationDonePromise = this._webpackCompilationDonePromise;
+            compiler.hooks.done.tap(exports.PLUGIN_NAME, (stats) => {
+                this._webpackCompilationDonePromiseResolveFn();
+                this._webpackCompilationDonePromise = new Promise((resolve) => {
+                    this._webpackCompilationDonePromiseResolveFn = resolve;
+                });
+                if (stats) {
+                    this._emitErrors(taskSession.logger, stats);
+                }
+            });
+            // TWebpack.Compiler and TWebpack.MultiCompiler in Webpack 4 do not allow you to access the running
+            // watcher, so we need to patch the method to set the watcher on the parent object.
+            const originalWatch = compiler.watch.bind(compiler);
+            compiler.watch = (watchOptions, handler) => {
+                const watcher = originalWatch(watchOptions, handler);
+                compiler.watching = watcher;
+                return watcher;
+            };
+            // Determine how we will run the compiler. When serving, we will run the compiler
+            // via the webpack-dev-server. Otherwise, we will run the compiler directly.
+            if (this._serve) {
+                const defaultDevServerOptions = {
+                    host: 'localhost',
+                    devMiddleware: {
+                        publicPath: '/',
+                        stats: {
+                            cached: false,
+                            cachedAssets: false,
+                            colors: heftConfiguration.terminalProvider.supportsColor
+                        }
+                    },
+                    client: {
+                        logging: 'info'
+                    },
+                    port: 8080,
+                    onListening: (server) => {
+                        var _a;
+                        const addressInfo = (_a = server.server) === null || _a === void 0 ? void 0 : _a.address();
+                        if (addressInfo) {
+                            const address = typeof addressInfo === 'string' ? addressInfo : `${addressInfo.address}:${addressInfo.port}`;
+                            taskSession.logger.terminal.writeLine(`Started Webpack Dev Server at https://${address}`);
+                        }
+                    }
+                };
+                // Obtain the devServerOptions from the webpack configuration, and combine with the default options
+                let devServerOptions;
+                if (Array.isArray(webpackConfiguration)) {
+                    const filteredDevServerOptions = webpackConfiguration
+                        .map((configuration) => configuration.devServer)
+                        .filter((devServer) => !!devServer);
+                    if (filteredDevServerOptions.length > 1) {
+                        taskSession.logger.emitWarning(new Error(`Detected multiple webpack devServer configurations, using the first one.`));
+                    }
+                    devServerOptions = Object.assign(Object.assign({}, defaultDevServerOptions), filteredDevServerOptions[0]);
+                }
+                else {
+                    devServerOptions = Object.assign(Object.assign({}, defaultDevServerOptions), webpackConfiguration.devServer);
+                }
+                // Add the certificate and key to the devServerOptions if these fields don't already have values
+                if (!devServerOptions.server) {
+                    const certificateManager = new debug_certificate_manager_1.CertificateManager();
+                    const certificate = await certificateManager.ensureCertificateAsync(true, taskSession.logger.terminal);
+                    devServerOptions = Object.assign(Object.assign({}, devServerOptions), { server: {
+                            type: 'https',
+                            options: {
+                                key: certificate.pemKey,
+                                cert: certificate.pemCertificate
+                            }
+                        } });
+                }
+                // Since the webpack-dev-server does not return infrastructure errors via a callback like
+                // compiler.watch(...), we will need to intercept them and log them ourselves.
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                compiler.hooks.infrastructureLog.tap(exports.PLUGIN_NAME, (name, type, args) => {
+                    if (name === WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME && type === 'error') {
+                        const error = args[0];
+                        if (error) {
+                            taskSession.logger.emitError(error);
+                        }
+                    }
+                    return true;
+                });
+                // The webpack-dev-server package has a design flaw, where merely loading its package will set the
+                // WEBPACK_DEV_SERVER environment variable -- even if no APIs are accessed. This environment variable
+                // causes incorrect behavior if Heft is not running in serve mode. Thus, we need to be careful to call
+                // require() only if Heft is in serve mode.
+                taskSession.logger.terminal.writeLine('Starting webpack-dev-server');
+                const WebpackDevServer = (await Promise.resolve().then(() => __importStar(require(WEBPACK_DEV_SERVER_PACKAGE_NAME))))
+                    .default;
+                const webpackDevServer = new WebpackDevServer(devServerOptions, compiler);
+                await webpackDevServer.start();
+            }
+            else {
+                // Create the watcher. Compilation will start immediately after invoking watch().
+                taskSession.logger.terminal.writeLine('Starting Webpack watcher');
+                compiler.watch({}, (error) => {
+                    if (error) {
+                        taskSession.logger.emitError(error);
+                    }
+                });
+            }
+            // Store the watchers to be used for suspend/resume
+            this._webpackWatchers = ((_a = compiler.compilers) !== null && _a !== void 0 ? _a : [compiler]).map((compiler) => compiler.watching);
+        }
+        // Resume the compilation, wait for the compilation to complete, then suspend the watchers until the
+        // next iteration. Even if there are no changes, the promise should resolve since resuming from a
+        // suspended state invalidates the state of the watcher.
+        taskSession.logger.terminal.writeLine('Running incremental Webpack compilation');
+        for (const watcher of this._webpackWatchers) {
+            watcher.resume();
+        }
+        await webpackCompilationDonePromise;
+        for (const watcher of this._webpackWatchers) {
+            watcher.suspend();
+        }
+    }
+    _validateEnvironmentVariable(taskSession) {
+        if (!this._serve && process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {
+            taskSession.logger.emitWarning(new Error(`The "${WEBPACK_DEV_SERVER_ENV_VAR_NAME}" environment variable is set, ` +
+                'which will cause problems when webpack is not running in serve mode. ' +
+                `(Did a dependency inadvertently load the "${WEBPACK_DEV_SERVER_PACKAGE_NAME}" package?)`));
+        }
+    }
+    _emitErrors(logger, stats) {
+        if (stats.hasErrors() || stats.hasWarnings()) {
+            const serializedStats = stats.toJson('errors-warnings');
+            for (const warning of serializedStats.warnings) {
+                logger.emitWarning(warning instanceof Error ? warning : new Error(warning));
+            }
+            for (const error of serializedStats.errors) {
+                logger.emitError(error instanceof Error ? error : new Error(error));
+            }
+        }
+    }
+}
+exports.default = Webpack4Plugin;
+//# sourceMappingURL=Webpack4Plugin.js.map

package/lib/Webpack4Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webpack4Plugin.js","sourceRoot":"","sources":["../src/Webpack4Plugin.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { AddressInfo } from 'net';\nimport type * as TWebpack from 'webpack';\nimport type TWebpackDevServer from 'webpack-dev-server';\nimport { AsyncParallelHook, AsyncSeriesBailHook, AsyncSeriesHook, type SyncBailHook } from 'tapable';\nimport { CertificateManager, type ICertificate } from '@rushstack/debug-certificate-manager';\nimport { InternalError, LegacyAdapters } from '@rushstack/node-core-library';\nimport type {\n  HeftConfiguration,\n  IHeftTaskSession,\n  IHeftTaskCleanHookOptions,\n  IHeftTaskPlugin,\n  IHeftTaskRunHookOptions,\n  IScopedLogger,\n  IHeftTaskRunIncrementalHookOptions\n} from '@rushstack/heft';\n\nimport type {\n  IWebpackConfiguration,\n  IWebpackConfigurationWithDevServer,\n  IWebpackPluginAccessor\n} from './shared';\nimport { WebpackConfigurationLoader } from './WebpackConfigurationLoader';\n\ntype ExtendedWatching = TWebpack.Watching & {\n  resume: () => void;\n  suspend: () => void;\n};\n\ntype ExtendedMultiWatching = TWebpack.MultiWatching & {\n  resume: () => void;\n  suspend: () => void;\n};\n\ntype ExtendedCompiler = TWebpack.Compiler & {\n  hooks: TWebpack.Compiler['hooks'] & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    infrastructureLog: SyncBailHook<string, string, any[]>;\n  };\n  watching: ExtendedWatching;\n};\n\ntype ExtendedMultiCompiler = TWebpack.MultiCompiler & {\n  compilers: ExtendedCompiler[];\n  hooks: TWebpack.MultiCompiler['hooks'] & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    infrastructureLog: SyncBailHook<string, string, any[]>;\n  };\n  watching: ExtendedMultiWatching;\n};\n\nexport interface IWebpackPluginOptions {\n  devConfigurationPath: string | undefined;\n  configurationPath: string | undefined;\n}\n\n/**\n * @public\n */\nexport const PLUGIN_NAME: 'Webpack4Plugin' = 'Webpack4Plugin';\nconst SERVE_PARAMETER_LONG_NAME: '--serve' = '--serve';\nconst WEBPACK_PACKAGE_NAME: 'webpack' = 'webpack';\nconst WEBPACK_DEV_SERVER_PACKAGE_NAME: 'webpack-dev-server' = 'webpack-dev-server';\nconst WEBPACK_DEV_SERVER_ENV_VAR_NAME: 'WEBPACK_DEV_SERVER' = 'WEBPACK_DEV_SERVER';\nconst WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME: 'webpack-dev-middleware' = 'webpack-dev-middleware';\nconst UNINITIALIZED: 'UNINITIALIZED' = 'UNINITIALIZED';\n\n/**\n * @internal\n */\nexport default class Webpack4Plugin implements IHeftTaskPlugin<IWebpackPluginOptions> {\n  private _serve: boolean = false;\n  private _webpack: typeof TWebpack | undefined;\n  private _webpackCompiler: ExtendedCompiler | ExtendedMultiCompiler | undefined;\n  private _webpackConfiguration: IWebpackConfiguration | undefined | typeof UNINITIALIZED = UNINITIALIZED;\n  private _webpackWatchers: ExtendedWatching[] | undefined;\n  private _webpackCompilationDonePromise: Promise<void> | undefined;\n  private _webpackCompilationDonePromiseResolveFn: (() => void) | undefined;\n\n  public readonly accessor: IWebpackPluginAccessor = {\n    hooks: {\n      onLoadConfiguration: new AsyncSeriesBailHook(),\n      onConfigure: new AsyncSeriesHook(['webpackConfiguration']),\n      onAfterConfigure: new AsyncParallelHook(['webpackConfiguration']),\n      onEmitStats: new AsyncParallelHook(['webpackStats'])\n    }\n  };\n\n  public apply(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): void {\n    this._serve = taskSession.parameters.getFlagParameter(SERVE_PARAMETER_LONG_NAME).value;\n    if (!taskSession.parameters.watch && this._serve) {\n      throw new Error(\n        `The ${JSON.stringify(\n          SERVE_PARAMETER_LONG_NAME\n        )} parameter is only available when running in watch mode.`\n      );\n    }\n\n    taskSession.hooks.clean.tapPromise(PLUGIN_NAME, async (cleanOptions: IHeftTaskCleanHookOptions) => {\n      // Obtain the finalized webpack configuration\n      const webpackConfiguration: IWebpackConfiguration | undefined =\n        await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);\n      if (webpackConfiguration) {\n        const webpackConfigurationArray: IWebpackConfigurationWithDevServer[] = Array.isArray(\n          webpackConfiguration\n        )\n          ? webpackConfiguration\n          : [webpackConfiguration];\n\n        // Add each output path to the clean list\n        // NOTE: Webpack plugins that write assets to paths that start with '../' or outside of the\n        // `output.path` will need to be manually added to the phase-level cleanup list in heft.json.\n        for (const config of webpackConfigurationArray) {\n          if (config.output?.path) {\n            cleanOptions.addDeleteOperations({ sourcePath: config.output.path });\n          }\n        }\n      }\n    });\n\n    taskSession.hooks.run.tapPromise(PLUGIN_NAME, async (runOptions: IHeftTaskRunHookOptions) => {\n      await this._runWebpackAsync(taskSession, heftConfiguration, options);\n    });\n\n    taskSession.hooks.runIncremental.tapPromise(\n      PLUGIN_NAME,\n      async (runOptions: IHeftTaskRunIncrementalHookOptions) => {\n        await this._runWebpackWatchAsync(taskSession, heftConfiguration, options);\n      }\n    );\n  }\n\n  private async _getWebpackConfigurationAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<IWebpackConfiguration | undefined> {\n    if (this._webpackConfiguration === UNINITIALIZED) {\n      // Obtain the webpack configuration by calling into the hook. If undefined\n      // is returned, load the default Webpack configuration.\n      taskSession.logger.terminal.writeVerboseLine(\n        'Attempting to load Webpack configuration via external plugins'\n      );\n      let webpackConfiguration: IWebpackConfiguration | false | undefined =\n        await this.accessor.hooks.onLoadConfiguration.promise();\n      if (webpackConfiguration === undefined) {\n        taskSession.logger.terminal.writeVerboseLine('Attempt to load the default Webpack configuration');\n        const configurationLoader: WebpackConfigurationLoader = new WebpackConfigurationLoader(\n          taskSession.logger,\n          taskSession.parameters.production,\n          taskSession.parameters.watch && this._serve\n        );\n        webpackConfiguration = await configurationLoader.tryLoadWebpackConfigurationAsync({\n          ...options,\n          taskSession,\n          heftConfiguration,\n          loadWebpackAsyncFn: this._loadWebpackAsync.bind(this)\n        });\n      }\n\n      if (webpackConfiguration === false) {\n        taskSession.logger.terminal.writeLine('Webpack disabled by external plugin');\n        this._webpackConfiguration = undefined;\n      } else if (\n        webpackConfiguration === undefined ||\n        (Array.isArray(webpackConfiguration) && webpackConfiguration.length === 0)\n      ) {\n        taskSession.logger.terminal.writeLine('No Webpack configuration found');\n        this._webpackConfiguration = undefined;\n      } else {\n        if (this.accessor.hooks.onConfigure.isUsed()) {\n          // Allow for plugins to customise the configuration\n          await this.accessor.hooks.onConfigure.promise(webpackConfiguration);\n        }\n        if (this.accessor.hooks.onAfterConfigure.isUsed()) {\n          // Provide the finalized configuration\n          await this.accessor.hooks.onAfterConfigure.promise(webpackConfiguration);\n        }\n        this._webpackConfiguration = webpackConfiguration;\n      }\n    }\n    return this._webpackConfiguration;\n  }\n\n  private async _loadWebpackAsync(): Promise<typeof TWebpack> {\n    if (!this._webpack) {\n      // Allow this to fail if webpack is not installed\n      this._webpack = await import(WEBPACK_PACKAGE_NAME);\n    }\n    return this._webpack!;\n  }\n\n  private async _getWebpackCompilerAsync(\n    taskSession: IHeftTaskSession,\n    webpackConfiguration: IWebpackConfiguration\n  ): Promise<ExtendedCompiler | ExtendedMultiCompiler> {\n    if (!this._webpackCompiler) {\n      const webpack: typeof TWebpack = await this._loadWebpackAsync();\n      taskSession.logger.terminal.writeLine(`Using Webpack version ${webpack.version}`);\n      this._webpackCompiler = Array.isArray(webpackConfiguration)\n        ? (webpack.default(\n            webpackConfiguration\n          ) as ExtendedMultiCompiler) /* (webpack.Compilation[]) => MultiCompiler */\n        : (webpack.default(webpackConfiguration) as ExtendedCompiler); /* (webpack.Compilation) => Compiler */\n    }\n    return this._webpackCompiler;\n  }\n\n  private async _runWebpackAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<void> {\n    this._validateEnvironmentVariable(taskSession);\n    if (taskSession.parameters.watch || this._serve) {\n      // Should never happen, but just in case\n      throw new InternalError('Cannot run Webpack in compilation mode when watch mode is enabled');\n    }\n\n    // Load the config and compiler, and return if there is no config found\n    const webpackConfiguration: IWebpackConfiguration | undefined = await this._getWebpackConfigurationAsync(\n      taskSession,\n      heftConfiguration,\n      options\n    );\n    if (!webpackConfiguration) {\n      return;\n    }\n    const compiler: ExtendedCompiler | ExtendedMultiCompiler = await this._getWebpackCompilerAsync(\n      taskSession,\n      webpackConfiguration\n    );\n    taskSession.logger.terminal.writeLine('Running Webpack compilation');\n\n    // Run the webpack compiler\n    let stats: TWebpack.Stats | TWebpack.MultiStats | undefined;\n    try {\n      stats = await LegacyAdapters.convertCallbackToPromise(\n        (compiler as TWebpack.Compiler).run.bind(compiler)\n      );\n    } catch (e) {\n      taskSession.logger.emitError(e as Error);\n    }\n\n    // Emit the errors from the stats object, if present\n    if (stats) {\n      this._emitErrors(taskSession.logger, stats);\n      if (this.accessor.hooks.onEmitStats.isUsed()) {\n        await this.accessor.hooks.onEmitStats.promise(stats);\n      }\n    }\n  }\n\n  private async _runWebpackWatchAsync(\n    taskSession: IHeftTaskSession,\n    heftConfiguration: HeftConfiguration,\n    options: IWebpackPluginOptions\n  ): Promise<void> {\n    // Save a handle to the original promise, since the this-scoped promise will be replaced whenever\n    // the compilation completes.\n    let webpackCompilationDonePromise: Promise<void> | undefined = this._webpackCompilationDonePromise;\n\n    if (!this._webpackWatchers) {\n      this._validateEnvironmentVariable(taskSession);\n      if (!taskSession.parameters.watch) {\n        // Should never happen, but just in case\n        throw new InternalError('Cannot run Webpack in watch mode when compilation mode is enabled');\n      }\n\n      // Load the config and compiler, and return if there is no config found\n      const webpackConfiguration: IWebpackConfiguration | undefined =\n        await this._getWebpackConfigurationAsync(taskSession, heftConfiguration, options);\n      if (!webpackConfiguration) {\n        return;\n      }\n\n      // Get the compiler which will be used for both serve and watch mode\n      const compiler: ExtendedCompiler | ExtendedMultiCompiler = await this._getWebpackCompilerAsync(\n        taskSession,\n        webpackConfiguration\n      );\n\n      // Set up the hook to detect when the watcher completes the watcher compilation. We will also log out\n      // errors from the compilation if present from the output stats object.\n      this._webpackCompilationDonePromise = new Promise((resolve: () => void) => {\n        this._webpackCompilationDonePromiseResolveFn = resolve;\n      });\n      webpackCompilationDonePromise = this._webpackCompilationDonePromise;\n      compiler.hooks.done.tap(PLUGIN_NAME, (stats?: TWebpack.Stats | TWebpack.MultiStats) => {\n        this._webpackCompilationDonePromiseResolveFn!();\n        this._webpackCompilationDonePromise = new Promise((resolve: () => void) => {\n          this._webpackCompilationDonePromiseResolveFn = resolve;\n        });\n        if (stats) {\n          this._emitErrors(taskSession.logger, stats);\n        }\n      });\n\n      // TWebpack.Compiler and TWebpack.MultiCompiler in Webpack 4 do not allow you to access the running\n      // watcher, so we need to patch the method to set the watcher on the parent object.\n      const originalWatch: TWebpack.Compiler['watch'] | TWebpack.MultiCompiler['watch'] =\n        compiler.watch.bind(compiler);\n      compiler.watch = (\n        watchOptions: TWebpack.ICompiler.WatchOptions,\n        handler: TWebpack.ICompiler.Handler & TWebpack.ICompiler.MultiHandler\n      ) => {\n        const watcher: ExtendedWatching | ExtendedMultiWatching = originalWatch(watchOptions, handler) as\n          | ExtendedWatching\n          | ExtendedMultiWatching;\n        compiler.watching = watcher;\n        return watcher;\n      };\n\n      // Determine how we will run the compiler. When serving, we will run the compiler\n      // via the webpack-dev-server. Otherwise, we will run the compiler directly.\n      if (this._serve) {\n        const defaultDevServerOptions: TWebpackDevServer.Configuration = {\n          host: 'localhost',\n          devMiddleware: {\n            publicPath: '/',\n            stats: {\n              cached: false,\n              cachedAssets: false,\n              colors: heftConfiguration.terminalProvider.supportsColor\n            }\n          },\n          client: {\n            logging: 'info'\n          },\n          port: 8080,\n          onListening: (server: TWebpackDevServer) => {\n            const addressInfo: AddressInfo | string | undefined = server.server?.address() as AddressInfo;\n            if (addressInfo) {\n              const address: string =\n                typeof addressInfo === 'string' ? addressInfo : `${addressInfo.address}:${addressInfo.port}`;\n              taskSession.logger.terminal.writeLine(`Started Webpack Dev Server at https://${address}`);\n            }\n          }\n        };\n\n        // Obtain the devServerOptions from the webpack configuration, and combine with the default options\n        let devServerOptions: TWebpackDevServer.Configuration;\n        if (Array.isArray(webpackConfiguration)) {\n          const filteredDevServerOptions: TWebpackDevServer.Configuration[] = webpackConfiguration\n            .map((configuration) => configuration.devServer)\n            .filter((devServer): devServer is TWebpackDevServer.Configuration => !!devServer);\n          if (filteredDevServerOptions.length > 1) {\n            taskSession.logger.emitWarning(\n              new Error(`Detected multiple webpack devServer configurations, using the first one.`)\n            );\n          }\n          devServerOptions = { ...defaultDevServerOptions, ...filteredDevServerOptions[0] };\n        } else {\n          devServerOptions = { ...defaultDevServerOptions, ...webpackConfiguration.devServer };\n        }\n\n        // Add the certificate and key to the devServerOptions if these fields don't already have values\n        if (!devServerOptions.server) {\n          const certificateManager: CertificateManager = new CertificateManager();\n          const certificate: ICertificate = await certificateManager.ensureCertificateAsync(\n            true,\n            taskSession.logger.terminal\n          );\n          devServerOptions = {\n            ...devServerOptions,\n            server: {\n              type: 'https',\n              options: {\n                key: certificate.pemKey,\n                cert: certificate.pemCertificate\n              }\n            }\n          };\n        }\n\n        // Since the webpack-dev-server does not return infrastructure errors via a callback like\n        // compiler.watch(...), we will need to intercept them and log them ourselves.\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        compiler.hooks.infrastructureLog.tap(PLUGIN_NAME, (name: string, type: string, args: any[]) => {\n          if (name === WEBPACK_DEV_MIDDLEWARE_PACKAGE_NAME && type === 'error') {\n            const error: Error | undefined = args[0];\n            if (error) {\n              taskSession.logger.emitError(error);\n            }\n          }\n          return true;\n        });\n\n        // The webpack-dev-server package has a design flaw, where merely loading its package will set the\n        // WEBPACK_DEV_SERVER environment variable -- even if no APIs are accessed. This environment variable\n        // causes incorrect behavior if Heft is not running in serve mode. Thus, we need to be careful to call\n        // require() only if Heft is in serve mode.\n        taskSession.logger.terminal.writeLine('Starting webpack-dev-server');\n        const WebpackDevServer: typeof TWebpackDevServer = (await import(WEBPACK_DEV_SERVER_PACKAGE_NAME))\n          .default;\n        const webpackDevServer: TWebpackDevServer = new WebpackDevServer(devServerOptions, compiler);\n        await webpackDevServer.start();\n      } else {\n        // Create the watcher. Compilation will start immediately after invoking watch().\n        taskSession.logger.terminal.writeLine('Starting Webpack watcher');\n        compiler.watch({}, (error?: Error | null) => {\n          if (error) {\n            taskSession.logger.emitError(error);\n          }\n        });\n      }\n\n      // Store the watchers to be used for suspend/resume\n      this._webpackWatchers = (\n        (compiler as ExtendedMultiCompiler).compilers ?? [compiler as ExtendedCompiler]\n      ).map((compiler: ExtendedCompiler) => compiler.watching);\n    }\n\n    // Resume the compilation, wait for the compilation to complete, then suspend the watchers until the\n    // next iteration. Even if there are no changes, the promise should resolve since resuming from a\n    // suspended state invalidates the state of the watcher.\n    taskSession.logger.terminal.writeLine('Running incremental Webpack compilation');\n    for (const watcher of this._webpackWatchers) {\n      watcher.resume();\n    }\n    await webpackCompilationDonePromise;\n    for (const watcher of this._webpackWatchers) {\n      watcher.suspend();\n    }\n  }\n\n  private _validateEnvironmentVariable(taskSession: IHeftTaskSession): void {\n    if (!this._serve && process.env[WEBPACK_DEV_SERVER_ENV_VAR_NAME]) {\n      taskSession.logger.emitWarning(\n        new Error(\n          `The \"${WEBPACK_DEV_SERVER_ENV_VAR_NAME}\" environment variable is set, ` +\n            'which will cause problems when webpack is not running in serve mode. ' +\n            `(Did a dependency inadvertently load the \"${WEBPACK_DEV_SERVER_PACKAGE_NAME}\" package?)`\n        )\n      );\n    }\n  }\n\n  private _emitErrors(logger: IScopedLogger, stats: TWebpack.Stats | TWebpack.compilation.MultiStats): void {\n    if (stats.hasErrors() || stats.hasWarnings()) {\n      const serializedStats: TWebpack.Stats.ToJsonOutput = stats.toJson('errors-warnings');\n\n      for (const warning of serializedStats.warnings as (string | Error)[]) {\n        logger.emitWarning(warning instanceof Error ? warning : new Error(warning));\n      }\n\n      for (const error of serializedStats.errors as (string | Error)[]) {\n        logger.emitError(error instanceof Error ? error : new Error(error));\n      }\n    }\n  }\n}\n"]}

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 './Webpack4Plugin';
+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"}