webpack 5.104.1 → 5.105.4

package/lib/Module.js

@@ -80,6 +80,8 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {KnownSourceType | string} SourceType */
 /** @typedef {ReadonlySet<SourceType>} SourceTypes */
 
+/** @typedef {ReadonlySet<typeof JAVASCRIPT_TYPE | string>} BasicSourceTypes */
+
 // TODO webpack 6: compilation will be required in CodeGenerationContext
 /**
  * @typedef {object} CodeGenerationContext
@@ -104,15 +106,42 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {Set<string>} RuntimeRequirements */
 /** @typedef {ReadonlySet<string>} ReadOnlyRuntimeRequirements */
 
-/** @typedef {Map<"topLevelDeclarations", Set<string>> & Map<"chunkInitFragments", InitFragment<EXPECTED_ANY>[]>} KnownCodeGenerationResultDataForJavascriptModules */
-/** @typedef {Map<"url", { ["css-url"]: string }>} KnownCodeGenerationResultDataForCssModules */
-/** @typedef {Map<"filename", string> & Map<"assetInfo", AssetInfo> & Map<"fullContentHash", string>} KnownCodeGenerationResultDataForAssetModules */
-/** @typedef {Map<"share-init", [{ shareScope: string, initStage: number, init: string }]>} KnownCodeGenerationResultForSharing */
-/** @typedef {KnownCodeGenerationResultDataForJavascriptModules & KnownCodeGenerationResultDataForCssModules & KnownCodeGenerationResultDataForAssetModules & KnownCodeGenerationResultForSharing & Map<string, EXPECTED_ANY>} CodeGenerationResultData */
+/**
+ * @typedef {object} AllCodeGenerationSchemas
+ * @property {Set<string>} topLevelDeclarations top level declarations for javascript modules
+ * @property {InitFragment<EXPECTED_ANY>[]} chunkInitFragments chunk init fragments for javascript modules
+ * @property {{ javascript?: string, ["css-url"]?: string }} url url for css and javascript modules
+ * @property {string} filename a filename for asset modules
+ * @property {AssetInfo} assetInfo an asset info for asset modules
+ * @property {string} fullContentHash a full content hash for asset modules
+ * @property {[{ shareScope: string, initStage: number, init: string }]} share-init share-init for modules federation
+ */
+
+/* eslint-disable jsdoc/type-formatting */
+/**
+ * @template {string} K
+ * @typedef {K extends keyof AllCodeGenerationSchemas ? AllCodeGenerationSchemas[K] : EXPECTED_ANY} CodeGenValue
+ */
+/* eslint-enable jsdoc/type-formatting */
+
+/* eslint-disable jsdoc/require-template */
+/**
+ * @typedef {object} CodeGenMapOverloads
+ * @property {<K extends string>(key: K) => CodeGenValue<K> | undefined} get
+ * @property {<K extends string>(key: K, value: CodeGenValue<K>) => CodeGenerationResultData} set
+ * @property {<K extends string>(key: K) => boolean} has
+ * @property {<K extends string>(key: K) => boolean} delete
+ */
+
+/**
+ * @typedef {Omit<Map<string, EXPECTED_ANY>, "get" | "set" | "has" | "delete"> & CodeGenMapOverloads} CodeGenerationResultData
+ */
+
+/** @typedef {Map<SourceType, Source>} Sources */
 
 /**
  * @typedef {object} CodeGenerationResult
- * @property {Map<SourceType, Source>} sources the resulting sources for all source types
+ * @property {Sources} sources the resulting sources for all source types
  * @property {CodeGenerationResultData=} data the resulting data for all source types
  * @property {ReadOnlyRuntimeRequirements | null} runtimeRequirements the runtime requirements
  * @property {string=} hash a hash of the code generation result (will be automatically calculated from sources and runtimeRequirements if not provided)
@@ -135,8 +164,8 @@ const makeSerializable = require("./util/makeSerializable");
  * @property {boolean=} sideEffectFree
  * @property {boolean=} isCSSModule
  * @property {Record<string, string>=} jsIncompatibleExports
- * @property {Map<RuntimeSpec, Record<string, string>>=} exportsFinalNameByRuntime
- * @property {Map<RuntimeSpec, string>=} exportsSourceByRuntime
+ * @property {Map<string, Record<string, string>>=} exportsFinalNameByRuntime
+ * @property {Map<string, string>=} exportsSourceByRuntime
  */
 
 /**
@@ -939,6 +968,19 @@ class Module extends DependenciesBlock {
 		return JAVASCRIPT_TYPES;
 	}
 
+	/**
+	 * Basic source types are high-level categories like javascript, css, webassembly, etc.
+	 * We only have built-in knowledge about the javascript basic type here; other basic types may be
+	 * added or changed over time by generators and do not need to be handled or detected here.
+	 *
+	 * Some modules, e.g. RemoteModule, may return non-basic source types like "remote" and "share-init"
+	 * from getSourceTypes(), but their generated output is still JavaScript, i.e. their basic type is JS.
+	 * @returns {BasicSourceTypes} types available (do not mutate)
+	 */
+	getSourceBasicTypes() {
+		return this.getSourceTypes();
+	}
+
 	/**
 	 * @abstract
 	 * @deprecated Use codeGeneration() instead
@@ -1026,6 +1068,7 @@ class Module extends DependenciesBlock {
 	 */
 	codeGeneration(context) {
 		// Best override this method
+		/** @type {Sources} */
 		const sources = new Map();
 		for (const type of this.getSourceTypes()) {
 			if (type !== UNKNOWN_TYPE) {

package/lib/ModuleBuildError.js

@@ -17,10 +17,11 @@ const makeSerializable = require("./util/makeSerializable");
 class ModuleBuildError extends WebpackError {
 	/**
 	 * @param {string | ErrorWithHideStack} err error thrown
-	 * @param {{from?: string | null}} info additional info
+	 * @param {{ from?: string | null }} info additional info
 	 */
 	constructor(err, { from = null } = {}) {
 		let message = "Module build failed";
+		/** @type {undefined | string} */
 		let details;
 
 		message += from ? ` (from ${from}):\n` : ": ";
@@ -48,6 +49,7 @@ class ModuleBuildError extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleBuildError";
 		this.details = details;
 		this.error = err;

package/lib/ModuleDependencyError.js

@@ -21,6 +21,7 @@ class ModuleDependencyError extends WebpackError {
 	constructor(module, err, loc) {
 		super(err.message);
 
+		/** @type {string} */
 		this.name = "ModuleDependencyError";
 		this.details =
 			err && !err.hideStack

package/lib/ModuleDependencyWarning.js

@@ -21,6 +21,7 @@ class ModuleDependencyWarning extends WebpackError {
 	constructor(module, err, loc) {
 		super(err ? err.message : "");
 
+		/** @type {string} */
 		this.name = "ModuleDependencyWarning";
 		this.details =
 			err && !err.hideStack

package/lib/ModuleError.js

@@ -15,7 +15,7 @@ const makeSerializable = require("./util/makeSerializable");
 class ModuleError extends WebpackError {
 	/**
 	 * @param {Error} err error thrown
-	 * @param {{from?: string | null}} info additional info
+	 * @param {{ from?: string | null }} info additional info
 	 */
 	constructor(err, { from = null } = {}) {
 		let message = "Module Error";
@@ -30,8 +30,11 @@ class ModuleError extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleError";
+		/** @type {Error} */
 		this.error = err;
+		/** @type {string | undefined} */
 		this.details =
 			err && typeof err === "object" && err.stack
 				? cleanUp(err.stack, this.message)

package/lib/ModuleFilenameHelpers.js

@@ -15,7 +15,8 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./Module")} Module */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 
-/** @typedef {string | RegExp | ((str: string) => boolean) | (string | RegExp | ((str: string) => boolean))[]} Matcher */
+/** @typedef {(str: string) => boolean} MatcherFn */
+/** @typedef {string | RegExp | MatcherFn | (string | RegExp | MatcherFn)[]} Matcher */
 /** @typedef {{ test?: Matcher, include?: Matcher, exclude?: Matcher }} MatchObject */
 
 const ModuleFilenameHelpers = module.exports;
@@ -115,7 +116,7 @@ const lazyObject = (obj) => {
 	return newObj;
 };
 
-const SQUARE_BRACKET_TAG_REGEXP = /\[\\*([\w-]+)\\*\]/gi;
+const SQUARE_BRACKET_TAG_REGEXP = /\[\\*([\w-]+)\\*\]/g;
 /**
  * @typedef {object} ModuleFilenameTemplateContext
  * @property {string} identifier the identifier of the module
@@ -157,6 +158,7 @@ ModuleFilenameHelpers.createFilename = (
 
 	/** @type {ReturnStringCallback} */
 	let absoluteResourcePath;
+	/** @type {ReturnStringCallback} */
 	let hash;
 	/** @type {ReturnStringCallback} */
 	let identifier;

package/lib/ModuleGraph.js

@@ -33,6 +33,7 @@ const { sortWithSourceOrder } = require("./util/comparators");
  * @returns {string}
  */
 
+/** @type {Iterable<ModuleGraphConnection>} */
 const EMPTY_SET = new Set();
 
 /**
@@ -42,6 +43,7 @@ const EMPTY_SET = new Set();
  * @returns {ReadonlyMap<T, ReadonlyArray<ModuleGraphConnection>>} mapped by key
  */
 const getConnectionsByKey = (set, getKey) => {
+	/** @type {Map<T, ModuleGraphConnection[]>} */
 	const map = new Map();
 	/** @type {T | 0} */
 	let lastKey = 0;
@@ -528,6 +530,7 @@ class ModuleGraph {
 					mgm._unassignedConnections &&
 					mgm._unassignedConnections.length !== 0
 				) {
+					/** @type {undefined | ModuleGraphConnection} */
 					let foundConnection;
 					for (const connection of mgm._unassignedConnections) {
 						this._dependencyMap.set(

package/lib/ModuleGraphConnection.js

@@ -57,7 +57,7 @@ class ModuleGraphConnection {
 	 * @param {Module} module the referenced module
 	 * @param {string=} explanation some extra detail
 	 * @param {boolean=} weak the reference is weak
-	 * @param {false | null | GetConditionFn | undefined} condition condition for the connection
+	 * @param {false | null | GetConditionFn=} condition condition for the connection
 	 */
 	constructor(
 		originModule,
@@ -67,14 +67,23 @@ class ModuleGraphConnection {
 		weak = false,
 		condition = undefined
 	) {
+		/** @type {Module | null} */
 		this.originModule = originModule;
+		/** @type {Module | null} */
 		this.resolvedOriginModule = originModule;
+		/** @type {Dependency | null} */
 		this.dependency = dependency;
+		/** @type {Module} */
 		this.resolvedModule = module;
+		/** @type {Module} */
 		this.module = module;
+		/** @type {boolean | undefined} */
 		this.weak = weak;
+		/** @type {boolean} */
 		this.conditional = Boolean(condition);
+		/** @type {boolean} */
 		this._active = condition !== false;
+		/** @type {false | null | GetConditionFn | undefined} */
 		this.condition = condition || undefined;
 		/** @type {Set<string> | undefined} */
 		this.explanations = undefined;
@@ -175,15 +184,6 @@ class ModuleGraphConnection {
 		this.conditional = false;
 		this._active = value;
 	}
-
-	// TODO webpack 5 remove
-	get active() {
-		throw new Error("Use getActiveState instead");
-	}
-
-	set active(value) {
-		throw new Error("Use setActive instead");
-	}
 }
 
 /** @typedef {typeof TRANSITIVE_ONLY} TRANSITIVE_ONLY */

package/lib/ModuleHashingError.js

@@ -18,6 +18,7 @@ class ModuleHashingError extends WebpackError {
 	constructor(module, error) {
 		super();
 
+		/** @type {string} */
 		this.name = "ModuleHashingError";
 		this.error = error;
 		this.message = error.message;
@@ -26,4 +27,5 @@ class ModuleHashingError extends WebpackError {
 	}
 }
 
+/** @type {typeof ModuleHashingError} */
 module.exports = ModuleHashingError;

package/lib/ModuleInfoHeaderPlugin.js

@@ -63,6 +63,7 @@ const printExportsInfoToSource = (
 	let alreadyPrintedExports = 0;
 
 	// determine exports to print
+	/** @type {ExportInfo[]} */
 	const printedExports = [];
 	for (const exportInfo of exportsInfo.orderedExports) {
 		if (!alreadyPrinted.has(exportInfo)) {
@@ -145,7 +146,8 @@ const printExportsInfoToSource = (
 	}
 };
 
-/** @type {WeakMap<RequestShortener, WeakMap<Module, { header: RawSource | undefined, full: WeakMap<Source, CachedSource> }>>} */
+/** @typedef {{ header: RawSource | undefined, full: WeakMap<Source, CachedSource> }} CacheEntry */
+/** @type {WeakMap<RequestShortener, WeakMap<Module, CacheEntry>>} */
 const caches = new WeakMap();
 
 const PLUGIN_NAME = "ModuleInfoHeaderPlugin";
@@ -155,6 +157,7 @@ class ModuleInfoHeaderPlugin {
 	 * @param {boolean=} verbose add more information like exports, runtime requirements and bailouts
 	 */
 	constructor(verbose = true) {
+		/** @type {boolean} */
 		this._verbose = verbose;
 	}
 
@@ -175,6 +178,7 @@ class ModuleInfoHeaderPlugin {
 					{ chunk, chunkGraph, moduleGraph, runtimeTemplate }
 				) => {
 					const { requestShortener } = runtimeTemplate;
+					/** @type {undefined | CacheEntry} */
 					let cacheEntry;
 					let cache = caches.get(requestShortener);
 					if (cache === undefined) {
@@ -256,6 +260,7 @@ class ModuleInfoHeaderPlugin {
 				PLUGIN_NAME,
 				(moduleSource, module, { runtimeTemplate }) => {
 					const { requestShortener } = runtimeTemplate;
+					/** @type {undefined | CacheEntry} */
 					let cacheEntry;
 					let cache = caches.get(requestShortener);
 					if (cache === undefined) {

package/lib/ModuleNotFoundError.js

@@ -78,6 +78,7 @@ class ModuleNotFoundError extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleNotFoundError";
 		this.details = err.details;
 		this.module = module;

package/lib/ModuleParseError.js

@@ -8,6 +8,7 @@
 const WebpackError = require("./WebpackError");
 const makeSerializable = require("./util/makeSerializable");
 
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("./Dependency").SourcePosition} SourcePosition */
 /** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
@@ -23,6 +24,7 @@ class ModuleParseError extends WebpackError {
 	 */
 	constructor(source, err, loaders, type) {
 		let message = `Module parse failed: ${err && err.message}`;
+		/** @type {undefined | DependencyLocation} */
 		let loc;
 
 		if (
@@ -40,7 +42,8 @@ class ModuleParseError extends WebpackError {
 				"\nFor files that transpile to WebAssembly, make sure to set the module type in the 'module.rules' section of the config (e. g. 'type: \"webassembly/async\"').";
 		} else if (!loaders) {
 			message +=
-				"\nYou may need an appropriate loader to handle this file type.";
+				"\nYou may need an appropriate loader to handle this file type. " +
+				"See https://webpack.js.org/concepts/loaders";
 		} else if (loaders.length >= 1) {
 			message += `\nFile was processed with these loaders:${loaders
 				.map((loader) => `\n * ${loader}`)
@@ -88,6 +91,7 @@ class ModuleParseError extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleParseError";
 		this.loc = loc;
 		this.error = err;

package/lib/ModuleProfile.js

@@ -34,7 +34,7 @@ class ModuleProfile {
 		this.storing = 0;
 		this.storingParallelismFactor = 0;
 
-		/** @type {{ start: number, end: number }[] | undefined } */
+		/** @type {{ start: number, end: number }[] | undefined} */
 		this.additionalFactoryTimes = undefined;
 		this.additionalFactories = 0;
 		this.additionalFactoriesParallelismFactor = 0;

package/lib/ModuleRestoreError.js

@@ -33,6 +33,7 @@ class ModuleRestoreError extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleRestoreError";
 		/** @type {string | undefined} */
 		this.details = details;
@@ -41,4 +42,5 @@ class ModuleRestoreError extends WebpackError {
 	}
 }
 
+/** @type {typeof ModuleRestoreError} */
 module.exports = ModuleRestoreError;

package/lib/ModuleSourceTypeConstants.js

@@ -61,17 +61,7 @@ const CONSUME_SHARED_GENERATOR_TYPE = "consume-shared";
 const UNKNOWN_TYPE = "unknown";
 
 /**
- * @typedef {JAVASCRIPT_TYPE |
- * RUNTIME_TYPE |
- * WEBASSEMBLY_TYPE |
- * ASSET_TYPE |
- * CSS_TYPE |
- * CSS_IMPORT_TYPE |
- * CSS_URL_TYPE |
- * SHARED_INIT_TYPE |
- * REMOTE_GENERATOR_TYPE |
- * CONSUME_SHARED_GENERATOR_TYPE |
- * UNKNOWN_TYPE} AllTypes
+ * @typedef {JAVASCRIPT_TYPE | RUNTIME_TYPE | WEBASSEMBLY_TYPE | ASSET_TYPE | CSS_TYPE | CSS_IMPORT_TYPE | CSS_URL_TYPE | SHARED_INIT_TYPE | REMOTE_GENERATOR_TYPE | CONSUME_SHARED_GENERATOR_TYPE | UNKNOWN_TYPE} AllTypes
  */
 
 /**

package/lib/ModuleStoreError.js

@@ -33,6 +33,7 @@ class ModuleStoreError extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleStoreError";
 		this.details = /** @type {string | undefined} */ (details);
 		this.module = module;
@@ -40,4 +41,5 @@ class ModuleStoreError extends WebpackError {
 	}
 }
 
+/** @type {typeof ModuleStoreError} */
 module.exports = ModuleStoreError;

package/lib/ModuleWarning.js

@@ -15,7 +15,7 @@ const makeSerializable = require("./util/makeSerializable");
 class ModuleWarning extends WebpackError {
 	/**
 	 * @param {Error} warning error thrown
-	 * @param {{from?: string | null}} info additional info
+	 * @param {{ from?: string | null }} info additional info
 	 */
 	constructor(warning, { from = null } = {}) {
 		let message = "Module Warning";
@@ -30,6 +30,7 @@ class ModuleWarning extends WebpackError {
 
 		super(message);
 
+		/** @type {string} */
 		this.name = "ModuleWarning";
 		this.warning = warning;
 		this.details =
@@ -63,4 +64,5 @@ class ModuleWarning extends WebpackError {
 
 makeSerializable(ModuleWarning, "webpack/lib/ModuleWarning");
 
+/** @type {typeof ModuleWarning} */
 module.exports = ModuleWarning;

package/lib/MultiCompiler.js

@@ -137,10 +137,11 @@ module.exports = class MultiCompiler {
 				compilation.warnings.push(warning);
 			});
 		};
+		/** @type {Set<string>} */
 		const cacheNames = new Set();
 		for (const compiler of this.compilers) {
 			if (compiler.options.cache && "name" in compiler.options.cache) {
-				const name = compiler.options.cache.name;
+				const name = /** @type {string} */ (compiler.options.cache.name);
 				if (cacheNames.has(name)) {
 					addWarning(
 						compiler,
@@ -255,7 +256,7 @@ module.exports = class MultiCompiler {
 	 * @returns {boolean} true if the dependencies are valid
 	 */
 	validateDependencies(callback) {
-		/** @type {Set<{source: Compiler, target: Compiler}>} */
+		/** @type {Set<{ source: Compiler, target: Compiler }>} */
 		const edges = new Set();
 		/** @type {string[]} */
 		const missing = [];
@@ -272,8 +273,8 @@ module.exports = class MultiCompiler {
 			return false;
 		};
 		/**
-		 * @param {{source: Compiler, target: Compiler}} e1 edge 1
-		 * @param {{source: Compiler, target: Compiler}} e2 edge 2
+		 * @param {{ source: Compiler, target: Compiler }} e1 edge 1
+		 * @param {{ source: Compiler, target: Compiler }} e2 edge 2
 		 * @returns {number} result
 		 */
 		const sortEdges = (e1, e2) =>
@@ -339,6 +340,7 @@ module.exports = class MultiCompiler {
 	 * @returns {void}
 	 */
 	runWithDependencies(compilers, fn, callback) {
+		/** @type {Set<string>} */
 		const fulfilledNames = new Set();
 		let remainingCompilers = compilers;
 		/**
@@ -350,6 +352,7 @@ module.exports = class MultiCompiler {
 		 * @returns {Compiler[]} compilers
 		 */
 		const getReadyCompilers = () => {
+			/** @type {Compiler[]} */
 			const readyCompilers = [];
 			const list = remainingCompilers;
 			remainingCompilers = [];
@@ -376,12 +379,12 @@ module.exports = class MultiCompiler {
 				(compiler, callback) => {
 					fn(compiler, (err) => {
 						if (err) return callback(err);
-						fulfilledNames.add(compiler.name);
+						fulfilledNames.add(/** @type {string} */ (compiler.name));
 						runCompilers(callback);
 					});
 				},
 				(err, results) => {
-					callback(err, results);
+					callback(/** @type {Error | null} */ (err), results);
 				}
 			);
 		};
@@ -567,6 +570,7 @@ module.exports = class MultiCompiler {
 				running === 0 &&
 				nodes.every((node) => node.state === "done")
 			) {
+				/** @type {Stats[]} */
 				const stats = [];
 				for (const node of nodes) {
 					const result = node.result;
@@ -667,7 +671,7 @@ module.exports = class MultiCompiler {
 				compiler.close(callback);
 			},
 			(error) => {
-				callback(error);
+				callback(/** @type {Error | null} */ (error));
 			}
 		);
 	}

package/lib/MultiStats.js

@@ -8,6 +8,7 @@
 const identifierUtils = require("./util/identifier");
 
 /** @typedef {import("../declarations/WebpackOptions").StatsOptions} StatsOptions */
+/** @typedef {import("../declarations/WebpackOptions").StatsValue} StatsValue */
 /** @typedef {import("./Compilation").CreateStatsOptionsContext} CreateStatsOptionsContext */
 /** @typedef {import("./Compilation").NormalizedStatsOptions} NormalizedStatsOptions */
 /** @typedef {import("./Stats")} Stats */
@@ -25,8 +26,7 @@ const indent = (str, prefix) => {
 	return prefix + rem;
 };
 
-/** @typedef {undefined | string | boolean | StatsOptions} ChildrenStatsOptions */
-/** @typedef {Omit<StatsOptions, "children"> & { children?: ChildrenStatsOptions | ChildrenStatsOptions[] }} MultiStatsOptions */
+/** @typedef {StatsOptions} MultiStatsOptions */
 /** @typedef {{ version: boolean, hash: boolean, errorsCount: boolean, warningsCount: boolean, errors: boolean, warnings: boolean, children: NormalizedStatsOptions[] }} ChildOptions */
 
 class MultiStats {
@@ -56,7 +56,7 @@ class MultiStats {
 	}
 
 	/**
-	 * @param {undefined | string | boolean | MultiStatsOptions} options stats options
+	 * @param {undefined | StatsValue} options stats options
 	 * @param {CreateStatsOptionsContext} context context
 	 * @returns {ChildOptions} context context
 	 */
@@ -109,7 +109,7 @@ class MultiStats {
 	}
 
 	/**
-	 * @param {(string | boolean | MultiStatsOptions)=} options stats options
+	 * @param {StatsValue=} options stats options
 	 * @returns {StatsCompilation} json output
 	 */
 	toJson(options) {
@@ -184,7 +184,7 @@ class MultiStats {
 	}
 
 	/**
-	 * @param {(string | boolean | MultiStatsOptions)=} options stats options
+	 * @param {StatsValue=} options stats options
 	 * @returns {string} string output
 	 */
 	toString(options) {

package/lib/MultiWatching.js

@@ -31,7 +31,7 @@ class MultiWatching {
 				this.watchings,
 				(watching, callback) => watching.invalidate(callback),
 				(err) => {
-					callback(err);
+					callback(/** @type {Error | null} */ (err));
 				}
 			);
 		} else {
@@ -67,7 +67,7 @@ class MultiWatching {
 				this.compiler.hooks.watchClose.call();
 				if (typeof callback === "function") {
 					this.compiler.running = false;
-					callback(err);
+					callback(/** @type {Error | null} */ (err));
 				}
 			}
 		);

package/lib/NoModeWarning.js

@@ -11,6 +11,7 @@ module.exports = class NoModeWarning extends WebpackError {
 	constructor() {
 		super();
 
+		/** @type {string} */
 		this.name = "NoModeWarning";
 		this.message =
 			"configuration\n" +

package/lib/NodeStuffInWebError.js

@@ -24,6 +24,7 @@ class NodeStuffInWebError extends WebpackError {
 ${description}`
 		);
 
+		/** @type {string} */
 		this.name = "NodeStuffInWebError";
 		this.loc = loc;
 	}