webpack 5.110.2 → 5.111.0

package/lib/MainTemplate.js

@@ -21,7 +21,11 @@ const getJsonpTemplatePlugin = memoize(() =>
 
 /** @import { Tap } from "tapable" */
 /** @import { Source } from "webpack-sources" */
-/** @import { Output as OutputOptions } from "../declarations/WebpackOptions" */
+/**
+ * @import {
+ * 	OutputNormalizedWithDefaults as OutputOptions
+ * } from "./config/defaults"
+ */
 /** @import ModuleTemplate from "./ModuleTemplate" */
 /** @import Chunk from "./Chunk" */
 /**

package/lib/Module.js

@@ -128,6 +128,7 @@ const makeSerializable = require("./util/makeSerializable");
  * @property {Set<string>} topLevelDeclarations top level declarations for javascript modules
  * @property {Set<string>} freeNames free identifier names in the rendered source for javascript modules
  * @property {InitFragment<EXPECTED_ANY>[]} chunkInitFragments chunk init fragments for javascript modules
+ * @property {string} externalReexport native external reexport source and attributes
  * @property {{ javascript?: string, ["asset-url"]?: string }} url url for asset modules
  * @property {string} filename a filename for asset modules
  * @property {AssetInfo} assetInfo an asset info for asset modules
@@ -186,23 +187,33 @@ const makeSerializable = require("./util/makeSerializable");
  * @property {Map<string, string>=} exportsBindingSourceByRuntime export definitions `ModuleLibraryPlugin` took over, re-emitted only where the module is wrapped
  */
 
+/**
+ * What a build recorded for stats and the performance hints to report, kept on the build info so a module restored from the cache still has it.
+ * @typedef {object} BuildDiagnostics
+ * @property {string[]=} optimizationBailouts what parser plugins reported as optimization bailouts, replayed into the module graph of every compilation that reuses the module
+ * @property {string=} sideEffectStatement the statement whose side effect keeps the module in the bundle, as `type at location`
+ * @property {number=} ineffectivePureAnnotations how many `#__PURE__` annotations sit where the parser does not read them
+ * @property {number=} topLevelThis how many times the module reads `this` at its top level
+ * @property {boolean=} usesEval true when the module calls `eval` directly
+ * @property {string[]=} notCacheableReasons reasons why the module is not cacheable (e.g. paths of loaders that marked it)
+ */
+
 /**
  * Defines the build info properties common to all module types.
  * Module type specific properties live in the `Known*BuildInfo` typedef of the dedicated module class.
  * @typedef {object} KnownBuildInfo
+ * @property {boolean=} specNamespaceObject the module hands out a spec Module Namespace Exotic Object
  * @property {boolean=} cacheable
- * @property {string[]=} notCacheableReasons reasons why the module is not cacheable (e.g. paths of loaders that marked it)
  * @property {boolean=} strict
  * @property {string=} moduleArgument
  * @property {string=} exportsArgument
  * @property {Record<string, Source>=} assets assets added by loaders or plugins
  * @property {Map<string, AssetInfo | undefined>=} assetsInfo
  * @property {Set<string>=} topLevelDeclarations top level declaration names
- * @property {boolean=} isCircular true when the module is part of a circular dependency chain
- * @property {boolean=} usesEval true when the module calls `eval` directly
- * @property {number=} ineffectivePureAnnotations how many `#__PURE__` annotations sit where the parser does not read them
- * @property {number=} topLevelThis how many times the module reads `this` at its top level
+ * @property {boolean=} isCircular true when the module is in a synchronous circular dependency chain
+ * @property {number=} circularKind CircularKind bit flags from CircularModulesPlugin; unset when the plugin did not run
  * @property {boolean=} usesTopLevelAwaitForOf module uses top-level `for await…of` or `await using`, which can't be lowered to a generator
+ * @property {BuildDiagnostics=} diagnostics what the build recorded for stats and the performance hints to report
  */
 
 /** @typedef {string | Set<string>} ValueCacheVersion */
@@ -1310,7 +1321,6 @@ class Module extends DependenciesBlock {
 		write(this.type);
 		write(this.layer);
 		write(this.context);
-		write(this.resolveOptions);
 		write(this.factoryMeta);
 		write(this.useSourceMap);
 		write(this.useSimpleSourceMap);
@@ -1340,7 +1350,6 @@ class Module extends DependenciesBlock {
 		this.type = read();
 		this.layer = read();
 		this.context = read();
-		this.resolveOptions = read();
 		this.factoryMeta = read();
 		this.useSourceMap = read();
 		this.useSimpleSourceMap = read();

package/lib/MultiCompiler.js

@@ -5,13 +5,13 @@
 
 "use strict";
 
-const asyncLib = require("neo-async");
 const { MultiHook, SyncHook } = require("tapable");
 
 const MultiStats = require("./MultiStats");
 const MultiWatching = require("./MultiWatching");
 const WebpackError = require("./errors/WebpackError");
 const ArrayQueue = require("./util/ArrayQueue");
+const asyncLib = require("./util/async");
 const memoize = require("./util/memoize");
 
 const getConcurrentCompilationError = memoize(() =>

package/lib/MultiWatching.js

@@ -5,7 +5,7 @@
 
 "use strict";
 
-const asyncLib = require("neo-async");
+const asyncLib = require("./util/async");
 
 /** @import MultiCompiler from "./MultiCompiler" */
 /** @import Watching from "./Watching" */

package/lib/NormalModule.js

@@ -8,9 +8,9 @@
 const querystring = require("querystring");
 const {
 	AsyncSeriesBailHook,
+	AsyncSeriesWaterfallHook,
 	HookMap,
-	SyncHook,
-	SyncWaterfallHook
+	SyncHook
 } = require("tapable");
 const {
 	CachedSource,
@@ -33,6 +33,7 @@ const {
 const LazySet = require("./util/LazySet");
 const { isSubset } = require("./util/SetHelpers");
 const { getScheme } = require("./util/URLAbsoluteSpecifier");
+const { getBuildDiagnostics } = require("./util/buildDiagnostics");
 const {
 	concatComparators,
 	keepOriginalOrder,
@@ -109,7 +110,6 @@ const getModuleBuildError = memoize(() => require("./errors/ModuleBuildError"));
  * 	BuildMeta,
  * 	CodeGenerationContext,
  * 	CodeGenerationResult,
- * 	CodeGenerationResultData,
  * 	ConcatenationBailoutReasonContext,
  * 	KnownBuildInfo,
  * 	LibIdentOptions,
@@ -119,7 +119,6 @@ const getModuleBuildError = memoize(() => require("./errors/ModuleBuildError"));
  * 	NeedBuildCallback,
  * 	BuildCallback,
  * 	RuntimeRequirements,
- * 	Sources,
  * 	SourceType,
  * 	SourceTypes
  * } from "./Module"
@@ -184,7 +183,9 @@ const recordSideEffectsBailout = (mod, moduleGraph, dep) => {
 		.getOptimizationBailout(mod)
 		.push(
 			() =>
-				`Dependency (${dep.type}) with side effects at ${formatLocation(dep.loc)}`
+				`Dependency (${dep.type}) with side effects at ${formatLocation(
+					dep.loc
+				)}`
 		);
 };
 
@@ -542,10 +543,12 @@ const createCompilationHooks = () => {
 		 */
 		beforeSnapshot: new SyncHook(["module"]),
 		/**
-		 * @type {SyncWaterfallHook<[Result, NormalModule]>}
+		 * Async since 5.111.0, so a tap can await work of its own — minifying an
+		 * asset, say, which before only a loader could do. `tap` keeps working.
+		 * @type {AsyncSeriesWaterfallHook<[Result, NormalModule]>}
 		 * @since 5.99.0
 		 */
-		processResult: new SyncWaterfallHook(["result", "module"]),
+		processResult: new AsyncSeriesWaterfallHook(["result", "module"]),
 		/**
 		 * @type {AsyncSeriesBailHook<[NormalModule, NeedBuildContext], boolean>}
 		 * @since 5.49.0
@@ -728,11 +731,6 @@ class NormalModule extends Module {
 		this._sideEffectsStateGraph = undefined;
 		/** @type {ConnectionState | undefined} */
 		this._sideEffectsStateValue = undefined;
-		/**
-		 * @private
-		 * @type {CodeGenerationResultData}
-		 */
-		this._codeGeneratorData = new Map();
 	}
 
 	/**
@@ -1052,7 +1050,9 @@ class NormalModule extends Module {
 								(parseJson(options));
 						} catch (err) {
 							throw new Error(
-								`Cannot parse string options: ${/** @type {Error} */ (err).message}`,
+								`Cannot parse string options: ${
+									/** @type {Error} */ (err).message
+								}`,
 								{ cause: err }
 							);
 						}
@@ -1305,11 +1305,33 @@ class NormalModule extends Module {
 				});
 				return callback(error);
 			}
-			const result = hooks.processResult.call(
+			hooks.processResult.callAsync(
 				/** @type {Result} */
 				(result_),
-				this
+				this,
+				(hookErr, hookResult) => {
+					if (hookErr) {
+						// Named, so a tap's failure is not read as a loader's.
+						return callback(
+							new (getModuleBuildError())(
+								hookErr instanceof Error
+									? hookErr
+									: new (getNonErrorEmittedError())(hookErr),
+								{ from: "processResult hook" }
+							)
+						);
+					}
+
+					finishResult(/** @type {Result} */ (hookResult));
+				}
 			);
+		};
+
+		/**
+		 * @param {Result} result the result the hook settled on
+		 * @returns {void}
+		 */
+		const finishResult = (result) => {
 			const source = result[0];
 			const sourceMap = result.length >= 1 ? result[1] : null;
 			const extraInfo = result.length >= 2 ? result[2] : null;
@@ -1441,7 +1463,9 @@ class NormalModule extends Module {
 												})
 										).catch((err) => {
 											throw new Error(
-												`Failed to parse source map. ${/** @type {Error} */ (err).message}`
+												`Failed to parse source map. ${
+													/** @type {Error} */ (err).message
+												}`
 											);
 										})
 								);
@@ -1501,7 +1525,8 @@ class NormalModule extends Module {
 				}
 				buildInfo.cacheable = buildInfo.cacheable && result.cacheable;
 				if (result.notCacheableReasons.length > 0) {
-					buildInfo.notCacheableReasons = result.notCacheableReasons;
+					getBuildDiagnostics(buildInfo).notCacheableReasons =
+						result.notCacheableReasons;
 				}
 				processResult(err, result.result);
 			}
@@ -1609,7 +1634,6 @@ class NormalModule extends Module {
 		};
 		this.buildInfo = {
 			cacheable: false,
-			notCacheableReasons: undefined,
 			parsed: true,
 			fileDependencies: undefined,
 			contextDependencies: undefined,
@@ -1627,6 +1651,8 @@ class NormalModule extends Module {
 			pureFunctions: undefined,
 			inlineExports: undefined,
 			moduleConcatenationBailout: undefined,
+			moduleConcatenationRootBailout: undefined,
+			diagnostics: undefined,
 			needCreateRequire: undefined,
 			usesTopLevelUsingDeclaration: undefined
 		};
@@ -1892,10 +1918,19 @@ class NormalModule extends Module {
 			runtimeRequirements.add(RuntimeGlobals.thisAsExports);
 		}
 
-		const getData = () => this._codeGeneratorData;
+		/** @type {CodeGenerationResult} */
+		const resultEntry = {
+			sources: new Map(),
+			runtimeRequirements,
+			data: undefined,
+			hash: undefined
+		};
+
+		const getData = () => {
+			if (resultEntry.data === undefined) resultEntry.data = new Map();
+			return resultEntry.data;
+		};
 
-		/** @type {Sources} */
-		const sources = new Map();
 		for (const type of sourceTypes || chunkGraph.getModuleSourceTypes(this)) {
 			// TODO webpack@6 make generateError required
 			const generator =
@@ -1930,17 +1965,10 @@ class NormalModule extends Module {
 					});
 
 			if (source) {
-				sources.set(type, new CachedSource(source));
+				resultEntry.sources.set(type, new CachedSource(source));
 			}
 		}
 
-		/** @type {CodeGenerationResult} */
-		const resultEntry = {
-			sources,
-			runtimeRequirements,
-			data: this._codeGeneratorData,
-			hash: undefined
-		};
 		return resultEntry;
 	}
 
@@ -2116,7 +2144,6 @@ class NormalModule extends Module {
 		write(this.error);
 		write(this._lastSuccessfulBuildMeta);
 		write(this._forceBuild);
-		write(this._codeGeneratorData);
 		write(this.hot);
 		super.serialize(context);
 	}
@@ -2143,7 +2170,7 @@ class NormalModule extends Module {
 			parserOptions: /** @type {EXPECTED_ANY} */ (null),
 			generator: /** @type {EXPECTED_ANY} */ (null),
 			generatorOptions: /** @type {EXPECTED_ANY} */ (null),
-			resolveOptions: /** @type {EXPECTED_ANY} */ (null),
+			resolveOptions: undefined,
 			extractSourceMap: /** @type {EXPECTED_ANY} */ (null)
 		});
 		obj.deserialize(context);
@@ -2160,7 +2187,6 @@ class NormalModule extends Module {
 		this.error = read();
 		this._lastSuccessfulBuildMeta = read();
 		this._forceBuild = read();
-		this._codeGeneratorData = read();
 		this.hot = read();
 		super.deserialize(context);
 	}

package/lib/NormalModuleFactory.js

@@ -5,7 +5,6 @@
 
 "use strict";
 
-const asyncLib = require("neo-async");
 const {
 	AsyncSeriesBailHook,
 	AsyncSeriesHook,
@@ -30,6 +29,7 @@ const RuleSetCompiler = require("./rules/RuleSetCompiler");
 const UseEffectRulePlugin = require("./rules/UseEffectRulePlugin");
 const LazySet = require("./util/LazySet");
 const { getScheme } = require("./util/URLAbsoluteSpecifier");
+const asyncLib = require("./util/async");
 const { cachedCleverMerge, cachedSetProperty } = require("./util/cleverMerge");
 const {
 	applyCaseCorrections,

package/lib/RuntimeGlobals.js

@@ -15,13 +15,6 @@ module.exports.amdDefine = "__webpack_require__.amdD";
  */
 module.exports.amdOptions = "__webpack_require__.amdO";
 
-/**
- * analyzable single-chunk `import()` that keeps `ensureChunk` timing and deduplication:
- * resolves immediately for an installed chunk, else runs the literal import and installs it
- * Signature: (chunkId, () => Promise) => Promise
- */
-module.exports.analyzableChunkImport = "__webpack_require__.ei";
-
 /**
  * Creates an async module. The body function must be a async function.
  * "module.exports" will be decorated with an AsyncModulePromise.
@@ -254,12 +247,28 @@ module.exports.hasCssModules = "has css modules";
  */
 module.exports.hasFetchPriority = "has fetch priority";
 
+/**
+ * a flag when a deferred startup callback carries a priority
+ */
+module.exports.hasChunkPriority = "has chunk priority";
+
 /**
  * the shorthand for Object.prototype.hasOwnProperty
  * using of it decreases the compiled bundle size
  */
 module.exports.hasOwnProperty = "__webpack_require__.o";
 
+/**
+ * a flag when a deferred namespace is built from a known export list
+ */
+module.exports.hasSealedDeferredNamespace = "has sealed deferred namespace";
+
+/**
+ * a flag when a deferred namespace is synthesized from the module's exports
+ */
+module.exports.hasSynthesizedDeferredNamespace =
+	"has synthesized deferred namespace";
+
 /**
  * function downloading the update manifest
  */
@@ -447,6 +456,11 @@ module.exports.setAnonymousDefaultName = "__webpack_require__.dn";
  */
 module.exports.shareScopeMap = "__webpack_require__.S";
 
+/**
+ * wrap an exports object in a spec Module Namespace Exotic Object
+ */
+module.exports.specNamespaceObject = "__webpack_require__.ns";
+
 /**
  * startup signal from runtime
  * This will be called when the runtime chunk has been loaded.

package/lib/RuntimeModule.js

@@ -136,22 +136,31 @@ class RuntimeModule extends Module {
 	updateHash(hash, context) {
 		hash.update(this.name);
 		hash.update(`${this.stage}`);
-		try {
-			const code =
-				this.fullHash || this.dependentHash
-					? // Do not use getGeneratedCode here, because i. e. compilation hash might be not
-						// ready at this point. We will cache it later instead.
-						this.generate()
-					: this.getGeneratedCode();
-			if (code !== null && code !== undefined) {
-				hash.update(code);
-			}
-		} catch (err) {
-			hash.update(/** @type {Error} */ (err).message);
+		// A failing `generate()` propagates: hashing its message instead pins the etag
+		// of the code generation cache to a constant, which then serves stale code.
+		const code =
+			this.fullHash || this.dependentHash
+				? // Do not use getGeneratedCode here, because i. e. compilation hash might be not
+					// ready at this point. We will cache it later instead.
+					this.generate()
+				: this.getGeneratedCode();
+		if (code !== null && code !== undefined) {
+			hash.update(code);
 		}
 		super.updateHash(hash, context);
 	}
 
+	/**
+	 * The `[handlerMap, key]` pairs this module installs onto a chunk handler map
+	 * such as `__webpack_require__.f`, or `null` where it cannot name them.
+	 * @returns {[string, string][] | null} installed chunk handlers (do not mutate)
+	 */
+	getInstalledChunkHandlers() {
+		// Answering `null` rather than "none" keeps a module that never heard of this
+		// out of a dispatch that would skip the handler it installs.
+		return null;
+	}
+
 	/**
 	 * Returns the source types this module can generate.
 	 * @returns {SourceTypes} types available (do not mutate)
@@ -244,6 +253,13 @@ class RuntimeModule extends Module {
 	}
 }
 
+/**
+ * The answer a runtime module gives when it installs no chunk handler at all
+ */
+RuntimeModule.NO_CHUNK_HANDLERS =
+	/** @type {[string, string][]} */
+	([]);
+
 /**
  * Runtime modules without any dependencies to other runtime modules
  */

package/lib/RuntimePlugin.js

@@ -81,6 +81,9 @@ const getGetWorkletBootstrapRuntimeModule = lazyModule(() =>
 const getGlobalRuntimeModule = lazyModule(() =>
 	require("./runtime/GlobalRuntimeModule")
 );
+const getSpecNamespaceObjectRuntimeModule = lazyModule(() =>
+	require("./runtime/SpecNamespaceObjectRuntimeModule")
+);
 const getHasOwnPropertyRuntimeModule = lazyModule(() =>
 	require("./runtime/HasOwnPropertyRuntimeModule")
 );
@@ -189,6 +192,9 @@ const TREE_DEPENDENCIES = {
 		RuntimeGlobals.makeNamespaceObject,
 		RuntimeGlobals.require
 	],
+	[RuntimeGlobals.deferredModuleAsyncTransitiveDependencies]: [
+		RuntimeGlobals.asyncModule
+	],
 	[RuntimeGlobals.makeOptimizedDeferredNamespaceObject]: [
 		RuntimeGlobals.require
 	],
@@ -211,6 +217,7 @@ const SIMPLE_TREE_RUNTIME_MODULES = [
 		getCreateFakeNamespaceObjectRuntimeModule
 	],
 	[RuntimeGlobals.hasOwnProperty, getHasOwnPropertyRuntimeModule],
+	[RuntimeGlobals.specNamespaceObject, getSpecNamespaceObjectRuntimeModule],
 	[
 		RuntimeGlobals.compatGetDefaultExport,
 		getCompatGetDefaultExportRuntimeModule
@@ -226,7 +233,6 @@ const SIMPLE_TREE_RUNTIME_MODULES = [
 	[RuntimeGlobals.shareScopeMap, getShareRuntimeModule],
 	[RuntimeGlobals.relativeUrl, getRelativeUrlRuntimeModule],
 	[RuntimeGlobals.worker, getWorkerRuntimeModule],
-	[RuntimeGlobals.onChunksLoaded, getOnChunksLoadedRuntimeModule],
 	[RuntimeGlobals.scriptNonce, getNonceRuntimeModule],
 	[RuntimeGlobals.toBinary, getToBinaryRuntimeModule]
 ];
@@ -313,6 +319,16 @@ class RuntimePlugin {
 						return true;
 					});
 			}
+			compilation.hooks.runtimeRequirementInTree
+				.for(RuntimeGlobals.onChunksLoaded)
+				.tap(PLUGIN_NAME, (chunk, runtimeRequirement) => {
+					compilation.addLazyRuntimeModule(
+						chunk,
+						getOnChunksLoadedRuntimeModule,
+						(Ctor) => new Ctor(runtimeRequirement)
+					);
+					return true;
+				});
 			compilation.hooks.runtimeRequirementInTree
 				.for(RuntimeGlobals.definePropertyGetters)
 				.tap(PLUGIN_NAME, (chunk, runtimeRequirement) => {
@@ -342,10 +358,20 @@ class RuntimePlugin {
 					const asyncModule = runtimeRequirement.has(
 						RuntimeGlobals.asyncModule
 					);
+					const sealed = runtimeRequirement.has(
+						RuntimeGlobals.hasSealedDeferredNamespace
+					);
+					// An unmarked build keeps both shapes, so a call site that
+					// predates the markers still gets the permissive runtime.
+					const synthesized =
+						!sealed ||
+						runtimeRequirement.has(
+							RuntimeGlobals.hasSynthesizedDeferredNamespace
+						);
 					compilation.addLazyRuntimeModule(
 						chunk,
 						getMakeDeferredNamespaceObjectRuntimeModule,
-						(Ctor) => new Ctor(asyncModule)
+						(Ctor) => new Ctor(asyncModule, sealed, synthesized)
 					);
 					return true;
 				});
@@ -399,7 +425,11 @@ class RuntimePlugin {
 					compilation.addLazyRuntimeModule(
 						chunk,
 						getAsyncModuleRuntimeModule,
-						(Ctor) => new Ctor(experiments.deferImport)
+						(Ctor) =>
+							new Ctor(
+								experiments.deferImport,
+								compilation.outputOptions.strictModuleErrorHandling
+							)
 					);
 					return true;
 				});