webpack 5.98.0 → 5.99.0

package/lib/Compiler.js

@@ -42,7 +42,6 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {import("./Chunk")} Chunk */
 /** @typedef {import("./Compilation").References} References */
 /** @typedef {import("./Dependency")} Dependency */
-/** @typedef {import("./FileSystemInfo").FileSystemInfoEntry} FileSystemInfoEntry */
 /** @typedef {import("./Module")} Module */
 /** @typedef {import("./Module").BuildInfo} BuildInfo */
 /** @typedef {import("./config/target").PlatformTargetProperties} PlatformTargetProperties */
@@ -51,14 +50,9 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
 /** @typedef {import("./util/fs").IntermediateFileSystem} IntermediateFileSystem */
 /** @typedef {import("./util/fs").OutputFileSystem} OutputFileSystem */
+/** @typedef {import("./util/fs").TimeInfoEntries} TimeInfoEntries */
 /** @typedef {import("./util/fs").WatchFileSystem} WatchFileSystem */
 
-/**
- * @template {any[]} T
- * @template V
- * @typedef {import("./util/WeakTupleMap")<T, V>} WeakTupleMap
- */
-
 /**
  * @typedef {object} CompilationParams
  * @property {NormalModuleFactory} normalModuleFactory
@@ -96,9 +90,10 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /** @typedef {{ sizeOnlySource: SizeOnlySource | undefined, writtenTo: Map<string, number> }} CacheEntry */
-/** @typedef {{ path: string, source: Source, size: number | undefined, waiting: ({ cacheEntry: any, file: string }[] | undefined) }} SimilarEntry */
 
-/** @typedef {{ buildInfo: BuildInfo, references: References | undefined, memCache: WeakTupleMap<any, any> }} ModuleMemCachesItem */
+/** @typedef {{ path: string, source: Source, size: number | undefined, waiting: ({ cacheEntry: CacheEntry, file: string }[] | undefined) }} SimilarEntry */
+
+/** @typedef {{ buildInfo: BuildInfo, references: References | undefined, memCache: import("./util/WeakTupleMap")<Module[], string> }} ModuleMemCachesItem */
 
 /**
  * @param {string[]} array an array
@@ -112,13 +107,13 @@ const isSorted = array => {
 };
 
 /**
- * @param {{[key: string]: any}} obj an object
- * @param {string[]} keys the keys of the object
- * @returns {{[key: string]: any}} the object with properties sorted by property name
+ * @template {object} T
+ * @param {T} obj an object
+ * @param {(keyof T)[]} keys the keys of the object
+ * @returns {T} the object with properties sorted by property name
  */
 const sortObject = (obj, keys) => {
-	/** @type {{[key: string]: any}} */
-	const o = {};
+	const o = /** @type {T} */ ({});
 	for (const k of keys.sort()) {
 		o[k] = obj[k];
 	}
@@ -203,7 +198,7 @@ class Compiler {
 			/** @type {AsyncSeriesHook<[]>} */
 			shutdown: new AsyncSeriesHook([]),
 
-			/** @type {SyncBailHook<[string, string, any[] | undefined], true | void>} */
+			/** @type {SyncBailHook<[string, string, EXPECTED_ANY[] | undefined], true | void>} */
 			infrastructureLog: new SyncBailHook(["origin", "type", "args"]),
 
 			// TODO the following hooks are weirdly located here
@@ -259,9 +254,9 @@ class Compiler {
 		this.modifiedFiles = undefined;
 		/** @type {ReadonlySet<string> | undefined} */
 		this.removedFiles = undefined;
-		/** @type {ReadonlyMap<string, FileSystemInfoEntry | "ignore" | null> | undefined} */
+		/** @type {TimeInfoEntries | undefined} */
 		this.fileTimestamps = undefined;
-		/** @type {ReadonlyMap<string, FileSystemInfoEntry | "ignore" | null> | undefined} */
+		/** @type {TimeInfoEntries | undefined} */
 		this.contextTimestamps = undefined;
 		/** @type {number | undefined} */
 		this.fsStartTime = undefined;
@@ -341,7 +336,7 @@ class Compiler {
 	}
 
 	/**
-	 * @param {string | (function(): string)} name name of the logger, or function called once to get the logger name
+	 * @param {string | (() => string)} name name of the logger, or function called once to get the logger name
 	 * @returns {Logger} a logger with that name
 	 */
 	getInfrastructureLogger(name) {

package/lib/ConditionalInitFragment.js

@@ -78,7 +78,7 @@ class ConditionalInitFragment extends InitFragment {
 
 	/**
 	 * @param {GenerateContext} context context
-	 * @returns {string|Source=} the source code that will be included at the end of the module
+	 * @returns {string | Source=} the source code that will be included at the end of the module
 	 */
 	getEndContent(context) {
 		if (this.runtimeCondition === false || !this.endContent) return "";

package/lib/ConstPlugin.js

@@ -22,6 +22,7 @@ const { parseResource } = require("./util/identifier");
 /** @typedef {import("estree").SourceLocation} SourceLocation */
 /** @typedef {import("estree").Statement} Statement */
 /** @typedef {import("estree").Super} Super */
+/** @typedef {import("estree").VariableDeclaration} VariableDeclaration */
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./javascript/BasicEvaluatedExpression")} BasicEvaluatedExpression */
 /** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
@@ -68,7 +69,7 @@ const collectDeclaration = (declarations, pattern) => {
  */
 const getHoistedDeclarations = (branch, includeFunctionDeclarations) => {
 	const declarations = new Set();
-	/** @type {Array<TODO | null | undefined>} */
+	/** @type {Array<Statement | null | undefined>} */
 	const stack = [branch];
 	while (stack.length > 0) {
 		const node = stack.pop();
@@ -87,12 +88,12 @@ const getHoistedDeclarations = (branch, includeFunctionDeclarations) => {
 				stack.push(node.alternate);
 				break;
 			case "ForStatement":
-				stack.push(node.init);
+				stack.push(/** @type {VariableDeclaration} */ (node.init));
 				stack.push(node.body);
 				break;
 			case "ForInStatement":
 			case "ForOfStatement":
-				stack.push(node.left);
+				stack.push(/** @type {VariableDeclaration} */ (node.left));
 				stack.push(node.body);
 				break;
 			case "DoWhileStatement":
@@ -158,6 +159,7 @@ class ConstPlugin {
 				 * @param {JavascriptParser} parser the parser
 				 */
 				const handler = parser => {
+					parser.hooks.terminate.tap(PLUGIN_NAME, statement => true);
 					parser.hooks.statementIf.tap(PLUGIN_NAME, statement => {
 						if (parser.scope.isAsmJs) return;
 						const param = parser.evaluateExpression(statement.test);

package/lib/ContextModule.js

@@ -39,11 +39,13 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./Dependency")} Dependency */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
 /** @typedef {import("./Generator").SourceTypes} SourceTypes */
+/** @typedef {import("./Module").BuildCallback} BuildCallback */
 /** @typedef {import("./Module").BuildInfo} BuildInfo */
 /** @typedef {import("./Module").BuildMeta} BuildMeta */
 /** @typedef {import("./Module").CodeGenerationContext} CodeGenerationContext */
 /** @typedef {import("./Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("./Module").LibIdentOptions} LibIdentOptions */
+/** @typedef {import("./Module").NeedBuildCallback} NeedBuildCallback */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("./ModuleGraph")} ModuleGraph */
 /** @typedef {import("./RequestShortener")} RequestShortener */
@@ -399,7 +401,7 @@ class ContextModule extends Module {
 
 	/**
 	 * @param {NeedBuildContext} context context info
-	 * @param {function((WebpackError | null)=, boolean=): void} callback callback function, returns true, if the module needs a rebuild
+	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
 	 */
 	needBuild({ fileSystemInfo }, callback) {
@@ -422,7 +424,7 @@ class ContextModule extends Module {
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
 	 * @param {InputFileSystem} fs the file system
-	 * @param {function(WebpackError=): void} callback callback function
+	 * @param {BuildCallback} callback callback function
 	 * @returns {void}
 	 */
 	build(options, compilation, resolver, fs, callback) {

package/lib/ContextModuleFactory.js

@@ -19,7 +19,7 @@ const { join } = require("./util/fs");
 /** @typedef {import("./ContextModule").ResolveDependenciesCallback} ResolveDependenciesCallback */
 /** @typedef {import("./Module")} Module */
 /** @typedef {import("./ModuleFactory").ModuleFactoryCreateData} ModuleFactoryCreateData */
-/** @typedef {import("./ModuleFactory").ModuleFactoryResult} ModuleFactoryResult */
+/** @typedef {import("./ModuleFactory").ModuleFactoryCallback} ModuleFactoryCallback */
 /** @typedef {import("./ResolverFactory")} ResolverFactory */
 /** @typedef {import("./dependencies/ContextDependency")} ContextDependency */
 /** @typedef {import("enhanced-resolve").ResolveRequest} ResolveRequest */
@@ -86,7 +86,7 @@ module.exports = class ContextModuleFactory extends ModuleFactory {
 
 	/**
 	 * @param {ModuleFactoryCreateData} data data object
-	 * @param {function((Error | null)=, ModuleFactoryResult=): void} callback callback
+	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}
 	 */
 	create(data, callback) {
@@ -335,7 +335,7 @@ module.exports = class ContextModuleFactory extends ModuleFactory {
 		/**
 		 * @param {string} ctx context
 		 * @param {string} directory directory
-		 * @param {function(string, string, function(): void): void} addSubDirectory addSubDirectoryFn
+		 * @param {(context: string, subResource: string, callback: () => void) => void} addSubDirectory addSubDirectoryFn
 		 * @param {ResolveDependenciesCallback} callback callback
 		 */
 		const addDirectory = (ctx, directory, addSubDirectory, callback) => {

package/lib/ContextReplacementPlugin.js

@@ -9,13 +9,16 @@ const ContextElementDependency = require("./dependencies/ContextElementDependenc
 const { join } = require("./util/fs");
 
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./ContextModule").ContextModuleOptions} ContextModuleOptions */
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
 
+/** @typedef {Record<string, string>} NewContentCreateContextMap */
+
 class ContextReplacementPlugin {
 	/**
 	 * @param {RegExp} resourceRegExp A regular expression that determines which files will be selected
-	 * @param {TODO=} newContentResource A new resource to replace the match
-	 * @param {TODO=} newContentRecursive If true, all subdirectories are searched for matches
+	 * @param {(string | ((context: TODO) => void) | RegExp | boolean)=} newContentResource A new resource to replace the match
+	 * @param {(boolean | NewContentCreateContextMap | RegExp)=} newContentRecursive If true, all subdirectories are searched for matches
 	 * @param {RegExp=} newContentRegExp A regular expression that determines which files will be selected
 	 */
 	constructor(
@@ -26,35 +29,56 @@ class ContextReplacementPlugin {
 	) {
 		this.resourceRegExp = resourceRegExp;
 
+		// new webpack.ContextReplacementPlugin(/selector/, (context) => { /* Logic */ });
 		if (typeof newContentResource === "function") {
 			this.newContentCallback = newContentResource;
-		} else if (
+		}
+		// new ContextReplacementPlugin(/selector/, './folder', { './request': './request' });
+		else if (
 			typeof newContentResource === "string" &&
 			typeof newContentRecursive === "object"
 		) {
 			this.newContentResource = newContentResource;
+			/**
+			 * @param {InputFileSystem} fs input file system
+			 * @param {(err: null | Error, newContentRecursive: NewContentCreateContextMap) => void} callback callback
+			 */
 			this.newContentCreateContextMap = (fs, callback) => {
-				callback(null, newContentRecursive);
+				callback(
+					null,
+					/** @type {NewContentCreateContextMap} */ (newContentRecursive)
+				);
 			};
-		} else if (
+		}
+		// new ContextReplacementPlugin(/selector/, './folder', (context) => { /* Logic */ });
+		else if (
 			typeof newContentResource === "string" &&
 			typeof newContentRecursive === "function"
 		) {
 			this.newContentResource = newContentResource;
 			this.newContentCreateContextMap = newContentRecursive;
 		} else {
+			// new webpack.ContextReplacementPlugin(/selector/, false, /reg-exp/);
 			if (typeof newContentResource !== "string") {
-				newContentRegExp = newContentRecursive;
-				newContentRecursive = newContentResource;
+				newContentRegExp = /** @type {RegExp} */ (newContentRecursive);
+				newContentRecursive = /** @type {boolean} */ (newContentResource);
 				newContentResource = undefined;
 			}
+			// new webpack.ContextReplacementPlugin(/selector/, /de|fr|hu/);
 			if (typeof newContentRecursive !== "boolean") {
-				newContentRegExp = newContentRecursive;
+				newContentRegExp = /** @type {RegExp} */ (newContentRecursive);
 				newContentRecursive = undefined;
 			}
-			this.newContentResource = newContentResource;
-			this.newContentRecursive = newContentRecursive;
-			this.newContentRegExp = newContentRegExp;
+			// new webpack.ContextReplacementPlugin(/selector/, './folder', false, /selector/);
+			this.newContentResource =
+				/** @type {string | undefined} */
+				(newContentResource);
+			this.newContentRecursive =
+				/** @type {boolean | undefined} */
+				(newContentRecursive);
+			this.newContentRegExp =
+				/** @type {RegExp | undefined} */
+				(newContentRegExp);
 		}
 	}
 
@@ -150,8 +174,12 @@ class ContextReplacementPlugin {
 	}
 }
 
-const createResolveDependenciesFromContextMap = createContextMap => {
-	const resolveDependenciesFromContextMap = (fs, options, callback) => {
+/**
+ * @param {(fs: InputFileSystem, callback: (err: null | Error, map: NewContentCreateContextMap) => void) => void} createContextMap create context map function
+ * @returns {(fs: InputFileSystem, options: ContextModuleOptions, callback: (err: null | Error, dependencies?: ContextElementDependency[]) => void) => void} resolve resolve dependencies from context map function
+ */
+const createResolveDependenciesFromContextMap =
+	createContextMap => (fs, options, callback) => {
 		createContextMap(fs, (err, map) => {
 			if (err) return callback(err);
 			const dependencies = Object.keys(map).map(
@@ -159,14 +187,13 @@ const createResolveDependenciesFromContextMap = createContextMap => {
 					new ContextElementDependency(
 						map[key] + options.resourceQuery + options.resourceFragment,
 						key,
-						options.category,
+						options.typePrefix,
+						/** @type {string} */ (options.category),
 						options.referencedExports
 					)
 			);
 			callback(null, dependencies);
 		});
 	};
-	return resolveDependenciesFromContextMap;
-};
 
 module.exports = ContextReplacementPlugin;

package/lib/DefinePlugin.js

@@ -33,8 +33,8 @@ const createHash = require("./util/createHash");
 /** @typedef {import("./logging/Logger").Logger} Logger */
 /** @typedef {import("./util/createHash").Algorithm} Algorithm */
 
-/** @typedef {null|undefined|RegExp|Function|string|number|boolean|bigint|undefined} CodeValuePrimitive */
-/** @typedef {RecursiveArrayOrRecord<CodeValuePrimitive|RuntimeValue>} CodeValue */
+/** @typedef {null | undefined | RegExp | EXPECTED_FUNCTION | string | number | boolean | bigint | undefined} CodeValuePrimitive */
+/** @typedef {RecursiveArrayOrRecord<CodeValuePrimitive | RuntimeValue>} CodeValue */
 
 /**
  * @typedef {object} RuntimeValueOptions
@@ -42,11 +42,11 @@ const createHash = require("./util/createHash");
  * @property {string[]=} contextDependencies
  * @property {string[]=} missingDependencies
  * @property {string[]=} buildDependencies
- * @property {string|function(): string=} version
+ * @property {string| (() => string)=} version
  */
 
 /** @typedef {string | Set<string>} ValueCacheVersion */
-/** @typedef {function({ module: NormalModule, key: string, readonly version: ValueCacheVersion }): CodeValuePrimitive} GeneratorFn */
+/** @typedef {(value: { module: NormalModule, key: string, readonly version: ValueCacheVersion }) => CodeValuePrimitive} GeneratorFn */
 
 class RuntimeValue {
 	/**
@@ -137,7 +137,7 @@ function getObjKeys(properties) {
 /** @typedef {boolean | undefined | null} AsiSafe */
 
 /**
- * @param {any[]|{[k: string]: any}} obj obj
+ * @param {EXPECTED_ANY[] | {[k: string]: EXPECTED_ANY}} obj obj
  * @param {JavascriptParser} parser Parser
  * @param {ValueCacheVersions} valueCacheVersions valueCacheVersions
  * @param {string} key the defined key
@@ -160,21 +160,19 @@ const stringifyObj = (
 	let code;
 	const arr = Array.isArray(obj);
 	if (arr) {
-		code = `[${
-			/** @type {any[]} */ (obj)
-				.map(code =>
-					toCode(
-						code,
-						parser,
-						valueCacheVersions,
-						key,
-						runtimeTemplate,
-						logger,
-						null
-					)
+		code = `[${obj
+			.map(code =>
+				toCode(
+					code,
+					parser,
+					valueCacheVersions,
+					key,
+					runtimeTemplate,
+					logger,
+					null
 				)
-				.join(",")
-		}]`;
+			)
+			.join(",")}]`;
 	} else {
 		let keys = Object.keys(obj);
 		if (objKeys) {
@@ -182,7 +180,7 @@ const stringifyObj = (
 		}
 		code = `{${keys
 			.map(key => {
-				const code = /** @type {{[k: string]: any}} */ (obj)[key];
+				const code = obj[key];
 				return `${JSON.stringify(key)}:${toCode(
 					code,
 					parser,
@@ -310,7 +308,10 @@ const toCacheVersion = code => {
 	if (typeof code === "object") {
 		const items = Object.keys(code).map(key => ({
 			key,
-			value: toCacheVersion(/** @type {Record<string, any>} */ (code)[key])
+			value: toCacheVersion(
+				/** @type {Record<string, EXPECTED_ANY>} */
+				(code)[key]
+			)
 		}));
 		if (items.some(({ value }) => value === undefined)) return;
 		return `{${items.map(({ key, value }) => `${key}: ${value}`).join(", ")}}`;
@@ -408,10 +409,10 @@ class DefinePlugin {
 					};
 
 					/**
-					 * @template {Function} T
+					 * @template T
 					 * @param {string} key key
-					 * @param {T} fn fn
-					 * @returns {function(TODO): TODO} result
+					 * @param {(expression: Expression) => T} fn fn
+					 * @returns {(expression: Expression) => T} result
 					 */
 					const withValueDependency =
 						(key, fn) =>

package/lib/DelegatedModule.js

@@ -22,9 +22,11 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
 /** @typedef {import("./Generator").SourceTypes} SourceTypes */
 /** @typedef {import("./LibManifestPlugin").ManifestModuleData} ManifestModuleData */
+/** @typedef {import("./Module").BuildCallback} BuildCallback */
 /** @typedef {import("./Module").CodeGenerationContext} CodeGenerationContext */
 /** @typedef {import("./Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("./Module").LibIdentOptions} LibIdentOptions */
+/** @typedef {import("./Module").NeedBuildCallback} NeedBuildCallback */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("./Module").SourceContext} SourceContext */
 /** @typedef {import("./RequestShortener")} RequestShortener */
@@ -106,7 +108,7 @@ class DelegatedModule extends Module {
 
 	/**
 	 * @param {NeedBuildContext} context context info
-	 * @param {function((WebpackError | null)=, boolean=): void} callback callback function, returns true, if the module needs a rebuild
+	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
 	 */
 	needBuild(context, callback) {
@@ -118,7 +120,7 @@ class DelegatedModule extends Module {
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
 	 * @param {InputFileSystem} fs the file system
-	 * @param {function(WebpackError=): void} callback callback function
+	 * @param {BuildCallback} callback callback function
 	 * @returns {void}
 	 */
 	build(options, compilation, resolver, fs, callback) {

package/lib/DelegatedModuleFactoryPlugin.js

@@ -13,6 +13,7 @@ const DelegatedModule = require("./DelegatedModule");
 /** @typedef {import("./DelegatedModule").SourceRequest} SourceRequest */
 /** @typedef {import("./DelegatedModule").Type} Type */
 /** @typedef {import("./NormalModuleFactory")} NormalModuleFactory */
+/** @typedef {import("./util/identifier").AssociatedObjectForCache} AssociatedObjectForCache */
 
 /**
  * @typedef {object} Options
@@ -22,7 +23,7 @@ const DelegatedModule = require("./DelegatedModule");
  * @property {DllReferencePluginOptions["type"]} type type
  * @property {DllReferencePluginOptions["extensions"]} extensions extensions
  * @property {DllReferencePluginOptions["scope"]} scope scope
- * @property {object=} associatedObjectForCache object for caching
+ * @property {AssociatedObjectForCache=} associatedObjectForCache object for caching
  */
 
 class DelegatedModuleFactoryPlugin {

package/lib/Dependency.js

@@ -81,7 +81,7 @@ const memoize = require("./util/memoize");
  * @property {boolean=} canMangle when false, referenced export can not be mangled, defaults to true
  */
 
-/** @typedef {function(ModuleGraphConnection, RuntimeSpec): ConnectionState} GetConditionFn */
+/** @typedef {(moduleGraphConnection: ModuleGraphConnection, runtime: RuntimeSpec) => ConnectionState} GetConditionFn */
 
 const TRANSITIVE = Symbol("transitive");
 
@@ -132,19 +132,23 @@ class Dependency {
 	get loc() {
 		if (this._loc !== undefined) return this._loc;
 		/** @type {SyntheticDependencyLocation & RealDependencyLocation} */
-		const loc = {};
+		const loc = {
+			start: { line: 0, column: 0 },
+			end: { line: 0, column: 0 },
+			name: "",
+			index: -1
+		};
 		if (this._locSL > 0) {
 			loc.start = { line: this._locSL, column: this._locSC };
 		}
 		if (this._locEL > 0) {
 			loc.end = { line: this._locEL, column: this._locEC };
 		}
-		if (this._locN !== undefined) {
-			loc.name = this._locN;
-		}
-		if (this._locI !== undefined) {
-			loc.index = this._locI;
-		}
+
+		loc.name = this._locN;
+
+		loc.index = this._locI;
+
 		return (this._loc = loc);
 	}
 
@@ -328,12 +332,11 @@ Dependency.NO_EXPORTS_REFERENCED = [];
 /** @type {string[][]} */
 Dependency.EXPORTS_OBJECT_REFERENCED = [[]];
 
-// eslint-disable-next-line no-warning-comments
-// @ts-ignore https://github.com/microsoft/TypeScript/issues/42919
+// TODO remove in webpack 6
 Object.defineProperty(Dependency.prototype, "module", {
 	/**
 	 * @deprecated
-	 * @returns {never} throws
+	 * @returns {EXPECTED_ANY} throws
 	 */
 	get() {
 		throw new Error(
@@ -352,9 +355,12 @@ Object.defineProperty(Dependency.prototype, "module", {
 	}
 });
 
-// eslint-disable-next-line no-warning-comments
-// @ts-ignore https://github.com/microsoft/TypeScript/issues/42919
+// TODO remove in webpack 6
 Object.defineProperty(Dependency.prototype, "disconnect", {
+	/**
+	 * @deprecated
+	 * @returns {EXPECTED_ANY} throws
+	 */
 	get() {
 		throw new Error(
 			"disconnect was removed from Dependency (Dependency no longer carries graph specific information)"

package/lib/DependencyTemplates.js

@@ -5,20 +5,21 @@
 
 "use strict";
 
+const { DEFAULTS } = require("./config/defaults");
 const createHash = require("./util/createHash");
 
 /** @typedef {import("./Dependency")} Dependency */
 /** @typedef {import("./DependencyTemplate")} DependencyTemplate */
 /** @typedef {typeof import("./util/Hash")} Hash */
 
-/** @typedef {new (...args: any[]) => Dependency} DependencyConstructor */
+/** @typedef {new (...args: EXPECTED_ANY[]) => Dependency} DependencyConstructor */
 
 class DependencyTemplates {
 	/**
 	 * @param {string | Hash} hashFunction the hash function to use
 	 */
-	constructor(hashFunction = "md4") {
-		/** @type {Map<Function, DependencyTemplate>} */
+	constructor(hashFunction = DEFAULTS.HASH_FUNCTION) {
+		/** @type {Map<DependencyConstructor, DependencyTemplate>} */
 		this._map = new Map();
 		/** @type {string} */
 		this._hash = "31d6cfe0d16ae931b73c59d7e0c089c0";

package/lib/DllModule.js

@@ -20,8 +20,10 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./Dependency").UpdateHashContext} UpdateHashContext */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
 /** @typedef {import("./Generator").SourceTypes} SourceTypes */
+/** @typedef {import("./Module").BuildCallback} BuildCallback */
 /** @typedef {import("./Module").CodeGenerationContext} CodeGenerationContext */
 /** @typedef {import("./Module").CodeGenerationResult} CodeGenerationResult */
+/** @typedef {import("./Module").NeedBuildCallback} NeedBuildCallback */
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("./Module").SourceContext} SourceContext */
 /** @typedef {import("./RequestShortener")} RequestShortener */
@@ -80,7 +82,7 @@ class DllModule extends Module {
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
 	 * @param {InputFileSystem} fs the file system
-	 * @param {function(WebpackError=): void} callback callback function
+	 * @param {BuildCallback} callback callback function
 	 * @returns {void}
 	 */
 	build(options, compilation, resolver, fs, callback) {
@@ -107,7 +109,7 @@ class DllModule extends Module {
 
 	/**
 	 * @param {NeedBuildContext} context context info
-	 * @param {function((WebpackError | null)=, boolean=): void} callback callback function, returns true, if the module needs a rebuild
+	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
 	 */
 	needBuild(context, callback) {

package/lib/DllModuleFactory.js

@@ -8,8 +8,8 @@
 const DllModule = require("./DllModule");
 const ModuleFactory = require("./ModuleFactory");
 
+/** @typedef {import("./ModuleFactory").ModuleFactoryCallback} ModuleFactoryCallback */
 /** @typedef {import("./ModuleFactory").ModuleFactoryCreateData} ModuleFactoryCreateData */
-/** @typedef {import("./ModuleFactory").ModuleFactoryResult} ModuleFactoryResult */
 /** @typedef {import("./dependencies/DllEntryDependency")} DllEntryDependency */
 
 class DllModuleFactory extends ModuleFactory {
@@ -20,7 +20,7 @@ class DllModuleFactory extends ModuleFactory {
 
 	/**
 	 * @param {ModuleFactoryCreateData} data data object
-	 * @param {function((Error | null)=, ModuleFactoryResult=): void} callback callback
+	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}
 	 */
 	create(data, callback) {

package/lib/DllReferencePlugin.js

@@ -18,6 +18,7 @@ const makePathsRelative = require("./util/identifier").makePathsRelative;
 /** @typedef {import("../declarations/plugins/DllReferencePlugin").DllReferencePluginOptionsContent} DllReferencePluginOptionsContent */
 /** @typedef {import("../declarations/plugins/DllReferencePlugin").DllReferencePluginOptionsManifest} DllReferencePluginOptionsManifest */
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Compiler").CompilationParams} CompilationParams */
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
 
 const validate = createSchemaValidation(
@@ -38,7 +39,7 @@ class DllReferencePlugin {
 	constructor(options) {
 		validate(options);
 		this.options = options;
-		/** @type {WeakMap<object, CompilationDataItem>} */
+		/** @type {WeakMap<CompilationParams, CompilationDataItem>} */
 		this._compilationData = new WeakMap();
 	}
 

package/lib/DynamicEntryPlugin.js

@@ -58,7 +58,7 @@ class DynamicEntryPlugin {
 							promises.push(
 								new Promise(
 									/**
-									 * @param {(value?: any) => void} resolve resolve
+									 * @param {(value?: undefined) => void} resolve resolve
 									 * @param {(reason?: Error) => void} reject reject
 									 */
 									(resolve, reject) => {

package/lib/EnvironmentPlugin.js

@@ -13,7 +13,7 @@ const WebpackError = require("./WebpackError");
 
 class EnvironmentPlugin {
 	/**
-	 * @param {(string | string[] | Record<string, any>)[]} keys keys
+	 * @param {(string | string[] | Record<string, EXPECTED_ANY>)[]} keys keys
 	 */
 	constructor(...keys) {
 		if (keys.length === 1 && Array.isArray(keys[0])) {
@@ -22,7 +22,9 @@ class EnvironmentPlugin {
 			this.defaultValues = {};
 		} else if (keys.length === 1 && keys[0] && typeof keys[0] === "object") {
 			this.keys = Object.keys(keys[0]);
-			this.defaultValues = /** @type {Record<string, any>} */ (keys[0]);
+			this.defaultValues =
+				/** @type {Record<string, EXPECTED_ANY>} */
+				(keys[0]);
 		} else {
 			this.keys = /** @type {string[]} */ (keys);
 			this.defaultValues = {};