webpack 5.90.2 → 5.90.3

package/lib/Compilation.js

@@ -1087,7 +1087,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
-	 * @param {StatsOptions | string | undefined} optionsOrPreset stats option value
+	 * @param {string | boolean | StatsOptions | undefined} optionsOrPreset stats option value
 	 * @param {CreateStatsOptionsContext} context context
 	 * @returns {NormalizedStatsOptions} normalized options
 	 */

package/lib/ContextModule.js

@@ -38,6 +38,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("./Module").LibIdentOptions} LibIdentOptions */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
+/** @typedef {import("./Module").SourceTypes} SourceTypes */
 /** @typedef {import("./ModuleGraph")} ModuleGraph */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */
@@ -144,7 +145,7 @@ class ContextModule extends Module {
 	}
 
 	/**
-	 * @returns {Set<string>} types available (do not mutate)
+	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
 		return TYPES;

package/lib/CssModule.js

@@ -151,9 +151,6 @@ class CssModule extends NormalModule {
 		return obj;
 	}
 
-	/**
-	 * @param {ObjectDeserializerContext} context context
-	 */
 	deserialize(context) {
 		const { read } = context;
 		this.cssLayer = read();

package/lib/DelegatedModule.js

@@ -25,6 +25,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./Module").LibIdentOptions} LibIdentOptions */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("./Module").SourceContext} SourceContext */
+/** @typedef {import("./Module").SourceTypes} SourceTypes */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
@@ -66,7 +67,7 @@ class DelegatedModule extends Module {
 	}
 
 	/**
-	 * @returns {Set<string>} types available (do not mutate)
+	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
 		return TYPES;

package/lib/DllModule.js

@@ -22,6 +22,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("./Module").SourceContext} SourceContext */
+/** @typedef {import("./Module").SourceTypes} SourceTypes */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
@@ -52,7 +53,7 @@ class DllModule extends Module {
 	}
 
 	/**
-	 * @returns {Set<string>} types available (do not mutate)
+	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
 		return TYPES;

package/lib/ExternalModule.js

@@ -34,6 +34,7 @@ const { register } = require("./util/serialization");
 /** @typedef {import("./Module").ConcatenationBailoutReasonContext} ConcatenationBailoutReasonContext */
 /** @typedef {import("./Module").LibIdentOptions} LibIdentOptions */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
+/** @typedef {import("./Module").SourceTypes} SourceTypes */
 /** @typedef {import("./NormalModuleFactory")} NormalModuleFactory */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */
@@ -415,7 +416,7 @@ class ExternalModule extends Module {
 	}
 
 	/**
-	 * @returns {Set<string>} types available (do not mutate)
+	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
 		return this.externalType === "css-import" ? CSS_TYPES : TYPES;

package/lib/Module.js

@@ -21,12 +21,14 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./ChunkGroup")} ChunkGroup */
 /** @typedef {import("./CodeGenerationResults")} CodeGenerationResults */
 /** @typedef {import("./Compilation")} Compilation */
+/** @typedef {import("./Compilation").AssetInfo} AssetInfo */
 /** @typedef {import("./ConcatenationScope")} ConcatenationScope */
 /** @typedef {import("./Dependency")} Dependency */
 /** @typedef {import("./Dependency").UpdateHashContext} UpdateHashContext */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
 /** @typedef {import("./ExportsInfo").UsageStateType} UsageStateType */
 /** @typedef {import("./FileSystemInfo")} FileSystemInfo */
+/** @typedef {import("./FileSystemInfo").Snapshot} Snapshot */
 /** @typedef {import("./ModuleGraphConnection").ConnectionState} ConnectionState */
 /** @typedef {import("./ModuleTypeConstants").ModuleTypes} ModuleTypes */
 /** @typedef {import("./NormalModuleFactory")} NormalModuleFactory */
@@ -100,6 +102,21 @@ const makeSerializable = require("./util/makeSerializable");
  * @property {boolean=} sideEffectFree
  */
 
+/**
+ * @typedef {Object} KnownBuildInfo
+ * @property {boolean=} cacheable
+ * @property {boolean=} parsed
+ * @property {LazySet<string>=} fileDependencies
+ * @property {LazySet<string>=} contextDependencies
+ * @property {LazySet<string>=} missingDependencies
+ * @property {LazySet<string>=} buildDependencies
+ * @property {(Map<string, string | Set<string>>)=} valueDependencies
+ * @property {TODO=} hash
+ * @property {Record<string, Source>=} assets
+ * @property {Map<string, AssetInfo | undefined>=} assetsInfo
+ * @property {(Snapshot | null)=} snapshot
+ */
+
 /**
  * @typedef {Object} NeedBuildContext
  * @property {Compilation} compilation
@@ -108,13 +125,17 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /** @typedef {KnownBuildMeta & Record<string, any>} BuildMeta */
-/** @typedef {Record<string, any>} BuildInfo */
+/** @typedef {KnownBuildInfo & Record<string, any>} BuildInfo */
 
 /**
  * @typedef {Object} FactoryMeta
  * @property {boolean=} sideEffectFree
  */
 
+/** @typedef {Set<string>} SourceTypes */
+
+/** @typedef {{ factoryMeta: FactoryMeta | undefined, resolveOptions: ResolveOptions | undefined }} UnsafeCacheData */
+
 const EMPTY_RESOLVE_OPTIONS = {};
 
 let debugId = 1000;
@@ -812,7 +833,7 @@ class Module extends DependenciesBlock {
 
 	/**
 	 * @abstract
-	 * @returns {Set<string>} types available (do not mutate)
+	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
 		// Better override this method to return the correct types
@@ -956,7 +977,7 @@ class Module extends DependenciesBlock {
 	/**
 	 * Module should be unsafe cached. Get data that's needed for that.
 	 * This data will be passed to restoreFromUnsafeCache later.
-	 * @returns {object} cached data
+	 * @returns {UnsafeCacheData} cached data
 	 */
 	getUnsafeCacheData() {
 		return {

package/lib/MultiCompiler.js

@@ -19,6 +19,7 @@ const ArrayQueue = require("./util/ArrayQueue");
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./Stats")} Stats */
 /** @typedef {import("./Watching")} Watching */
+/** @typedef {import("./logging/Logger").Logger} Logger */
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
 /** @typedef {import("./util/fs").IntermediateFileSystem} IntermediateFileSystem */
 /** @typedef {import("./util/fs").OutputFileSystem} OutputFileSystem */
@@ -80,7 +81,7 @@ module.exports = class MultiCompiler {
 		this.dependencies = new WeakMap();
 		this.running = false;
 
-		/** @type {Stats[]} */
+		/** @type {(Stats | null)[]} */
 		const compilerStats = this.compilers.map(() => null);
 		let doneCompilers = 0;
 		for (let index = 0; index < this.compilers.length; index++) {
@@ -94,7 +95,9 @@ module.exports = class MultiCompiler {
 				}
 				compilerStats[compilerIndex] = stats;
 				if (doneCompilers === this.compilers.length) {
-					this.hooks.done.call(new MultiStats(compilerStats));
+					this.hooks.done.call(
+						new MultiStats(/** @type {Stats[]} */ (compilerStats))
+					);
 				}
 			});
 			compiler.hooks.invalid.tap("MultiCompiler", () => {
@@ -180,6 +183,10 @@ module.exports = class MultiCompiler {
 		}
 	}
 
+	/**
+	 * @param {string | (function(): string)} name name of the logger, or function called once to get the logger name
+	 * @returns {Logger} a logger with that name
+	 */
 	getInfrastructureLogger(name) {
 		return this.compilers[0].getInfrastructureLogger(name);
 	}
@@ -202,6 +209,10 @@ module.exports = class MultiCompiler {
 		const edges = new Set();
 		/** @type {string[]} */
 		const missing = [];
+		/**
+		 * @param {Compiler} compiler compiler
+		 * @returns {boolean} target was found
+		 */
 		const targetFound = compiler => {
 			for (const edge of edges) {
 				if (edge.target === compiler) {
@@ -274,6 +285,10 @@ module.exports = class MultiCompiler {
 	runWithDependencies(compilers, fn, callback) {
 		const fulfilledNames = new Set();
 		let remainingCompilers = compilers;
+		/**
+		 * @param {string} d dependency
+		 * @returns {boolean} when dependency was fulfilled
+		 */
 		const isDependencyFulfilled = d => fulfilledNames.has(d);
 		const getReadyCompilers = () => {
 			let readyCompilers = [];
@@ -291,6 +306,10 @@ module.exports = class MultiCompiler {
 			}
 			return readyCompilers;
 		};
+		/**
+		 * @param {Callback<MultiStats>} callback callback
+		 * @returns {void}
+		 */
 		const runCompilers = callback => {
 			if (remainingCompilers.length === 0) return callback();
 			asyncLib.map(
@@ -302,7 +321,7 @@ module.exports = class MultiCompiler {
 						runCompilers(callback);
 					});
 				},
-				callback
+				/** @type {Callback<TODO>} */ (callback)
 			);
 		};
 		runCompilers(callback);
@@ -316,7 +335,7 @@ module.exports = class MultiCompiler {
 	 * @returns {SetupResult[]} result of setup
 	 */
 	_runGraph(setup, run, callback) {
-		/** @typedef {{ compiler: Compiler, setupResult: SetupResult, result: Stats, state: "pending" | "blocked" | "queued" | "starting" | "running" | "running-outdated" | "done", children: Node[], parents: Node[] }} Node */
+		/** @typedef {{ compiler: Compiler, setupResult: undefined | SetupResult, result: undefined | Stats, state: "pending" | "blocked" | "queued" | "starting" | "running" | "running-outdated" | "done", children: Node[], parents: Node[] }} Node */
 
 		// State transitions for nodes:
 		// -> blocked (initial)
@@ -341,12 +360,14 @@ module.exports = class MultiCompiler {
 		}));
 		/** @type {Map<string, Node>} */
 		const compilerToNode = new Map();
-		for (const node of nodes) compilerToNode.set(node.compiler.name, node);
+		for (const node of nodes) {
+			compilerToNode.set(/** @type {string} */ (node.compiler.name), node);
+		}
 		for (const node of nodes) {
 			const dependencies = this.dependencies.get(node.compiler);
 			if (!dependencies) continue;
 			for (const dep of dependencies) {
-				const parent = compilerToNode.get(dep);
+				const parent = /** @type {Node} */ (compilerToNode.get(dep));
 				node.parents.push(parent);
 				parent.children.push(node);
 			}
@@ -361,10 +382,10 @@ module.exports = class MultiCompiler {
 		}
 		let errored = false;
 		let running = 0;
-		const parallelism = this._options.parallelism;
+		const parallelism = /** @type {number} */ (this._options.parallelism);
 		/**
 		 * @param {Node} node node
-		 * @param {Error=} err error
+		 * @param {(Error | null)=} err error
 		 * @param {Stats=} stats result
 		 * @returns {void}
 		 */
@@ -440,6 +461,7 @@ module.exports = class MultiCompiler {
 			}
 		};
 
+		/** @type {SetupResult[]} */
 		const setupResults = [];
 		nodes.forEach((node, i) => {
 			setupResults.push(
@@ -461,7 +483,7 @@ module.exports = class MultiCompiler {
 		};
 		const processQueueWorker = () => {
 			while (running < parallelism && queue.length > 0 && !errored) {
-				const node = queue.dequeue();
+				const node = /** @type {Node} */ (queue.dequeue());
 				if (
 					node.state === "queued" ||
 					(node.state === "blocked" &&
@@ -469,7 +491,11 @@ module.exports = class MultiCompiler {
 				) {
 					running++;
 					node.state = "starting";
-					run(node.compiler, node.setupResult, nodeDone.bind(null, node));
+					run(
+						node.compiler,
+						/** @type {SetupResult} */ (node.setupResult),
+						nodeDone.bind(null, node)
+					);
 					node.state = "running";
 				}
 			}