webpack 5.99.6 → 5.99.8

package/lib/hmr/LazyCompilationPlugin.js

@@ -353,6 +353,8 @@ class LazyCompilationDependencyFactory extends ModuleFactory {
  * @property {(RegExp | string | ((module: Module) => boolean))=} test additional filter for lazy compiled entrypoint modules
  */
 
+const PLUGIN_NAME = "LazyCompilationPlugin";
+
 class LazyCompilationPlugin {
 	/**
 	 * @param {Options} options options
@@ -372,28 +374,25 @@ class LazyCompilationPlugin {
 	apply(compiler) {
 		/** @type {BackendApi} */
 		let backend;
-		compiler.hooks.beforeCompile.tapAsync(
-			"LazyCompilationPlugin",
-			(params, callback) => {
-				if (backend !== undefined) return callback();
-				const promise = this.backend(compiler, (err, result) => {
-					if (err) return callback(err);
-					backend = /** @type {BackendApi} */ (result);
+		compiler.hooks.beforeCompile.tapAsync(PLUGIN_NAME, (params, callback) => {
+			if (backend !== undefined) return callback();
+			const promise = this.backend(compiler, (err, result) => {
+				if (err) return callback(err);
+				backend = /** @type {BackendApi} */ (result);
+				callback();
+			});
+			if (promise && promise.then) {
+				promise.then(b => {
+					backend = b;
 					callback();
-				});
-				if (promise && promise.then) {
-					promise.then(b => {
-						backend = b;
-						callback();
-					}, callback);
-				}
+				}, callback);
 			}
-		);
+		});
 		compiler.hooks.thisCompilation.tap(
-			"LazyCompilationPlugin",
+			PLUGIN_NAME,
 			(compilation, { normalModuleFactory }) => {
 				normalModuleFactory.hooks.module.tap(
-					"LazyCompilationPlugin",
+					PLUGIN_NAME,
 					(module, createData, resolveData) => {
 						if (
 							resolveData.dependencies.every(dep =>
@@ -454,7 +453,7 @@ class LazyCompilationPlugin {
 				);
 			}
 		);
-		compiler.hooks.shutdown.tapAsync("LazyCompilationPlugin", callback => {
+		compiler.hooks.shutdown.tapAsync(PLUGIN_NAME, callback => {
 			backend.dispose(callback);
 		});
 	}

package/lib/ids/ChunkModuleIdRangePlugin.js

@@ -21,6 +21,8 @@ const {
  * @property {number=} end end id
  */
 
+const PLUGIN_NAME = "ChunkModuleIdRangePlugin";
+
 class ChunkModuleIdRangePlugin {
 	/**
 	 * @param {ChunkModuleIdRangePluginOptions} options options object
@@ -36,9 +38,9 @@ class ChunkModuleIdRangePlugin {
 	 */
 	apply(compiler) {
 		const options = this.options;
-		compiler.hooks.compilation.tap("ChunkModuleIdRangePlugin", compilation => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
 			const moduleGraph = compilation.moduleGraph;
-			compilation.hooks.moduleIds.tap("ChunkModuleIdRangePlugin", modules => {
+			compilation.hooks.moduleIds.tap(PLUGIN_NAME, modules => {
 				const chunkGraph = compilation.chunkGraph;
 				const chunk = find(
 					compilation.chunks,
@@ -46,7 +48,7 @@ class ChunkModuleIdRangePlugin {
 				);
 				if (!chunk) {
 					throw new Error(
-						`ChunkModuleIdRangePlugin: Chunk with name '${options.name}"' was not found`
+						`${PLUGIN_NAME}: Chunk with name '${options.name}"' was not found`
 					);
 				}
 
@@ -63,9 +65,7 @@ class ChunkModuleIdRangePlugin {
 							cmpFn = compareModulesByPostOrderIndexOrIdentifier(moduleGraph);
 							break;
 						default:
-							throw new Error(
-								"ChunkModuleIdRangePlugin: unexpected value of order"
-							);
+							throw new Error(`${PLUGIN_NAME}: unexpected value of order`);
 					}
 					chunkModules = chunkGraph.getOrderedChunkModules(chunk, cmpFn);
 				} else {

package/lib/ids/DeterministicModuleIdsPlugin.js

@@ -27,6 +27,8 @@ const {
  * @property {boolean=} failOnConflict throw an error when id conflicts occur (instead of rehashing)
  */
 
+const PLUGIN_NAME = "DeterministicModuleIdsPlugin";
+
 class DeterministicModuleIdsPlugin {
 	/**
 	 * @param {DeterministicModuleIdsPluginOptions=} options options
@@ -41,56 +43,53 @@ class DeterministicModuleIdsPlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		compiler.hooks.compilation.tap(
-			"DeterministicModuleIdsPlugin",
-			compilation => {
-				compilation.hooks.moduleIds.tap("DeterministicModuleIdsPlugin", () => {
-					const chunkGraph = compilation.chunkGraph;
-					const context = this.options.context
-						? this.options.context
-						: compiler.context;
-					const maxLength = this.options.maxLength || 3;
-					const failOnConflict = this.options.failOnConflict || false;
-					const fixedLength = this.options.fixedLength || false;
-					const salt = this.options.salt || 0;
-					let conflicts = 0;
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
+			compilation.hooks.moduleIds.tap(PLUGIN_NAME, () => {
+				const chunkGraph = compilation.chunkGraph;
+				const context = this.options.context
+					? this.options.context
+					: compiler.context;
+				const maxLength = this.options.maxLength || 3;
+				const failOnConflict = this.options.failOnConflict || false;
+				const fixedLength = this.options.fixedLength || false;
+				const salt = this.options.salt || 0;
+				let conflicts = 0;
 
-					const [usedIds, modules] = getUsedModuleIdsAndModules(
-						compilation,
-						this.options.test
-					);
-					assignDeterministicIds(
-						modules,
-						module => getFullModuleName(module, context, compiler.root),
-						failOnConflict
-							? () => 0
-							: compareModulesByPreOrderIndexOrIdentifier(
-									compilation.moduleGraph
-								),
-						(module, id) => {
-							const size = usedIds.size;
-							usedIds.add(`${id}`);
-							if (size === usedIds.size) {
-								conflicts++;
-								return false;
-							}
-							chunkGraph.setModuleId(module, id);
-							return true;
-						},
-						[10 ** maxLength],
-						fixedLength ? 0 : 10,
-						usedIds.size,
-						salt
+				const [usedIds, modules] = getUsedModuleIdsAndModules(
+					compilation,
+					this.options.test
+				);
+				assignDeterministicIds(
+					modules,
+					module => getFullModuleName(module, context, compiler.root),
+					failOnConflict
+						? () => 0
+						: compareModulesByPreOrderIndexOrIdentifier(
+								compilation.moduleGraph
+							),
+					(module, id) => {
+						const size = usedIds.size;
+						usedIds.add(`${id}`);
+						if (size === usedIds.size) {
+							conflicts++;
+							return false;
+						}
+						chunkGraph.setModuleId(module, id);
+						return true;
+					},
+					[10 ** maxLength],
+					fixedLength ? 0 : 10,
+					usedIds.size,
+					salt
+				);
+				if (failOnConflict && conflicts)
+					throw new Error(
+						`Assigning deterministic module ids has lead to ${conflicts} conflict${
+							conflicts > 1 ? "s" : ""
+						}.\nIncrease the 'maxLength' to increase the id space and make conflicts less likely (recommended when there are many conflicts or application is expected to grow), or add an 'salt' number to try another hash starting value in the same id space (recommended when there is only a single conflict).`
 					);
-					if (failOnConflict && conflicts)
-						throw new Error(
-							`Assigning deterministic module ids has lead to ${conflicts} conflict${
-								conflicts > 1 ? "s" : ""
-							}.\nIncrease the 'maxLength' to increase the id space and make conflicts less likely (recommended when there are many conflicts or application is expected to grow), or add an 'salt' number to try another hash starting value in the same id space (recommended when there is only a single conflict).`
-						);
-				});
-			}
-		);
+			});
+		});
 	}
 }
 

package/lib/ids/HashedModuleIdsPlugin.js

@@ -28,6 +28,8 @@ const validate = createSchemaValidation(
 	}
 );
 
+const PLUGIN_NAME = "HashedModuleIdsPlugin";
+
 class HashedModuleIdsPlugin {
 	/**
 	 * @param {HashedModuleIdsPluginOptions=} options options object
@@ -52,8 +54,8 @@ class HashedModuleIdsPlugin {
 	 */
 	apply(compiler) {
 		const options = this.options;
-		compiler.hooks.compilation.tap("HashedModuleIdsPlugin", compilation => {
-			compilation.hooks.moduleIds.tap("HashedModuleIdsPlugin", () => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
+			compilation.hooks.moduleIds.tap(PLUGIN_NAME, () => {
 				const chunkGraph = compilation.chunkGraph;
 				const context = this.options.context
 					? this.options.context

package/lib/ids/NamedChunkIdsPlugin.js

@@ -25,6 +25,8 @@ const {
  * @property {string=} delimiter delimiter
  */
 
+const PLUGIN_NAME = "NamedChunkIdsPlugin";
+
 class NamedChunkIdsPlugin {
 	/**
 	 * @param {NamedChunkIdsPluginOptions=} options options
@@ -40,11 +42,11 @@ class NamedChunkIdsPlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		compiler.hooks.compilation.tap("NamedChunkIdsPlugin", compilation => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
 			const hashFunction =
 				/** @type {NonNullable<Output["hashFunction"]>} */
 				(compilation.outputOptions.hashFunction);
-			compilation.hooks.chunkIds.tap("NamedChunkIdsPlugin", chunks => {
+			compilation.hooks.chunkIds.tap(PLUGIN_NAME, chunks => {
 				const chunkGraph = compilation.chunkGraph;
 				const context = this.context ? this.context : compiler.context;
 				const delimiter = this.delimiter;

package/lib/ids/NamedModuleIdsPlugin.js

@@ -23,6 +23,8 @@ const {
  * @property {string=} context context
  */
 
+const PLUGIN_NAME = "NamedModuleIdsPlugin";
+
 class NamedModuleIdsPlugin {
 	/**
 	 * @param {NamedModuleIdsPluginOptions=} options options
@@ -38,11 +40,11 @@ class NamedModuleIdsPlugin {
 	 */
 	apply(compiler) {
 		const { root } = compiler;
-		compiler.hooks.compilation.tap("NamedModuleIdsPlugin", compilation => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
 			const hashFunction =
 				/** @type {NonNullable<Output["hashFunction"]>} */
 				(compilation.outputOptions.hashFunction);
-			compilation.hooks.moduleIds.tap("NamedModuleIdsPlugin", () => {
+			compilation.hooks.moduleIds.tap(PLUGIN_NAME, () => {
 				const chunkGraph = compilation.chunkGraph;
 				const context = this.options.context
 					? this.options.context

package/lib/ids/NaturalChunkIdsPlugin.js

@@ -12,6 +12,8 @@ const { assignAscendingChunkIds } = require("./IdHelpers");
 /** @typedef {import("../Compiler")} Compiler */
 /** @typedef {import("../Module")} Module */
 
+const PLUGIN_NAME = "NaturalChunkIdsPlugin";
+
 class NaturalChunkIdsPlugin {
 	/**
 	 * Apply the plugin
@@ -19,8 +21,8 @@ class NaturalChunkIdsPlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		compiler.hooks.compilation.tap("NaturalChunkIdsPlugin", compilation => {
-			compilation.hooks.chunkIds.tap("NaturalChunkIdsPlugin", chunks => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
+			compilation.hooks.chunkIds.tap(PLUGIN_NAME, chunks => {
 				const chunkGraph = compilation.chunkGraph;
 				const compareNatural = compareChunksNatural(chunkGraph);
 				const chunksInNaturalOrder = Array.from(chunks).sort(compareNatural);

package/lib/ids/NaturalModuleIdsPlugin.js

@@ -16,6 +16,8 @@ const {
 /** @typedef {import("../Compiler")} Compiler */
 /** @typedef {import("../Module")} Module */
 
+const PLUGIN_NAME = "NaturalModuleIdsPlugin";
+
 class NaturalModuleIdsPlugin {
 	/**
 	 * Apply the plugin
@@ -23,8 +25,8 @@ class NaturalModuleIdsPlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		compiler.hooks.compilation.tap("NaturalModuleIdsPlugin", compilation => {
-			compilation.hooks.moduleIds.tap("NaturalModuleIdsPlugin", modules => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
+			compilation.hooks.moduleIds.tap(PLUGIN_NAME, modules => {
 				const [usedIds, modulesInNaturalOrder] =
 					getUsedModuleIdsAndModules(compilation);
 				modulesInNaturalOrder.sort(

package/lib/ids/OccurrenceChunkIdsPlugin.js

@@ -23,6 +23,8 @@ const validate = createSchemaValidation(
 	}
 );
 
+const PLUGIN_NAME = "OccurrenceChunkIdsPlugin";
+
 class OccurrenceChunkIdsPlugin {
 	/**
 	 * @param {OccurrenceChunkIdsPluginOptions=} options options object
@@ -39,8 +41,8 @@ class OccurrenceChunkIdsPlugin {
 	 */
 	apply(compiler) {
 		const prioritiseInitial = this.options.prioritiseInitial;
-		compiler.hooks.compilation.tap("OccurrenceChunkIdsPlugin", compilation => {
-			compilation.hooks.chunkIds.tap("OccurrenceChunkIdsPlugin", chunks => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
+			compilation.hooks.chunkIds.tap(PLUGIN_NAME, chunks => {
 				const chunkGraph = compilation.chunkGraph;
 
 				/** @type {Map<Chunk, number>} */

package/lib/ids/OccurrenceModuleIdsPlugin.js

@@ -28,6 +28,8 @@ const validate = createSchemaValidation(
 	}
 );
 
+const PLUGIN_NAME = "OccurrenceModuleIdsPlugin";
+
 class OccurrenceModuleIdsPlugin {
 	/**
 	 * @param {OccurrenceModuleIdsPluginOptions=} options options object
@@ -44,10 +46,10 @@ class OccurrenceModuleIdsPlugin {
 	 */
 	apply(compiler) {
 		const prioritiseInitial = this.options.prioritiseInitial;
-		compiler.hooks.compilation.tap("OccurrenceModuleIdsPlugin", compilation => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
 			const moduleGraph = compilation.moduleGraph;
 
-			compilation.hooks.moduleIds.tap("OccurrenceModuleIdsPlugin", () => {
+			compilation.hooks.moduleIds.tap(PLUGIN_NAME, () => {
 				const chunkGraph = compilation.chunkGraph;
 
 				const [usedIds, modulesInOccurrenceOrder] =

package/lib/index.js

@@ -11,20 +11,30 @@ const memoize = require("./util/memoize");
 /** @typedef {import("../declarations/WebpackOptions").Entry} Entry */
 /** @typedef {import("../declarations/WebpackOptions").EntryNormalized} EntryNormalized */
 /** @typedef {import("../declarations/WebpackOptions").EntryObject} EntryObject */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItem} ExternalItem */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItemFunction} ExternalItemFunction */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionCallback} ExternalItemFunctionCallback */
 /** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionData} ExternalItemFunctionData */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionDataGetResolve} ExternalItemFunctionDataGetResolve */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionDataGetResolveCallbackResult} ExternalItemFunctionDataGetResolveCallbackResult */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionDataGetResolveResult} ExternalItemFunctionDataGetResolveResult */
+/** @typedef {import("../declarations/WebpackOptions").ExternalItemFunctionPromise} ExternalItemFunctionPromise */
 /** @typedef {import("../declarations/WebpackOptions").ExternalItemObjectKnown} ExternalItemObjectKnown */
 /** @typedef {import("../declarations/WebpackOptions").ExternalItemObjectUnknown} ExternalItemObjectUnknown */
 /** @typedef {import("../declarations/WebpackOptions").ExternalItemValue} ExternalItemValue */
 /** @typedef {import("../declarations/WebpackOptions").Externals} Externals */
 /** @typedef {import("../declarations/WebpackOptions").FileCacheOptions} FileCacheOptions */
+/** @typedef {import("../declarations/WebpackOptions").GeneratorOptionsByModuleTypeKnown} GeneratorOptionsByModuleTypeKnown */
 /** @typedef {import("../declarations/WebpackOptions").LibraryOptions} LibraryOptions */
 /** @typedef {import("../declarations/WebpackOptions").MemoryCacheOptions} MemoryCacheOptions */
 /** @typedef {import("../declarations/WebpackOptions").ModuleOptions} ModuleOptions */
+/** @typedef {import("../declarations/WebpackOptions").ParserOptionsByModuleTypeKnown} ParserOptionsByModuleTypeKnown */
 /** @typedef {import("../declarations/WebpackOptions").ResolveOptions} ResolveOptions */
 /** @typedef {import("../declarations/WebpackOptions").RuleSetCondition} RuleSetCondition */
 /** @typedef {import("../declarations/WebpackOptions").RuleSetConditionAbsolute} RuleSetConditionAbsolute */
 /** @typedef {import("../declarations/WebpackOptions").RuleSetRule} RuleSetRule */
 /** @typedef {import("../declarations/WebpackOptions").RuleSetUse} RuleSetUse */
+/** @typedef {import("../declarations/WebpackOptions").RuleSetUseFunction} RuleSetUseFunction */
 /** @typedef {import("../declarations/WebpackOptions").RuleSetUseItem} RuleSetUseItem */
 /** @typedef {import("../declarations/WebpackOptions").StatsOptions} StatsOptions */
 /** @typedef {import("../declarations/WebpackOptions").WebpackOptions} Configuration */
@@ -37,6 +47,7 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./Compilation").EntryOptions} EntryOptions */
 /** @typedef {import("./Compilation").PathData} PathData */
 /** @typedef {import("./Compiler").AssetEmittedInfo} AssetEmittedInfo */
+/** @typedef {import("./Entrypoint")} Entrypoint */
 /** @typedef {import("./MultiCompiler").MultiCompilerOptions} MultiCompilerOptions */
 /** @typedef {import("./MultiStats")} MultiStats */
 /** @typedef {import("./NormalModuleFactory").ResolveData} ResolveData */

package/lib/javascript/JavascriptModulesPlugin.js

@@ -52,6 +52,7 @@ const JavascriptParser = require("./JavascriptParser");
 /** @typedef {import("eslint-scope").Variable} Variable */
 /** @typedef {import("estree").Program} Program */
 /** @typedef {import("webpack-sources").Source} Source */
+/** @typedef {import("../../declarations/WebpackOptions").HashFunction} HashFunction */
 /** @typedef {import("../../declarations/WebpackOptions").Output} OutputOptions */
 /** @typedef {import("../Chunk")} Chunk */
 /** @typedef {import("../ChunkGraph")} ChunkGraph */
@@ -69,7 +70,6 @@ const JavascriptParser = require("./JavascriptParser");
 /** @typedef {import("../WebpackError")} WebpackError */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
 /** @typedef {import("../util/Hash")} Hash */
-/** @typedef {import("../util/createHash").Algorithm} Algorithm */
 
 /**
  * @param {Chunk} chunk a chunk
@@ -429,7 +429,7 @@ class JavascriptModulesPlugin {
 							hashFunction
 						}
 					} = compilation;
-					const hash = createHash(/** @type {Algorithm} */ (hashFunction));
+					const hash = createHash(/** @type {HashFunction} */ (hashFunction));
 					if (hashSalt) hash.update(hashSalt);
 					if (chunk.hasRuntime()) {
 						this.updateHashWithBootstrap(