webpack 5.112.0 → 5.112.1

package/lib/runtime/GetChunkFilenameRuntimeModule.js

@@ -97,11 +97,7 @@ class GetChunkFilenameRuntimeModule extends RuntimeModule {
 		 * @returns {string} re-encoded hash
 		 */
 		const reEncode = (value, digest, length) => {
-			const hash = reEncodeDigest(
-				value,
-				/** @type {string} */ (sourceDigest),
-				digest
-			);
+			const hash = reEncodeDigest(value, sourceDigest, digest);
 			return length ? hash.slice(0, length) : hash;
 		};
 

package/lib/runtime/RuntimeGlobals.js

@@ -328,6 +328,12 @@ module.exports.instantiateWasm = "__webpack_require__.v";
  */
 module.exports.interceptModuleExecution = "__webpack_require__.i";
 
+/**
+ * the setters a module library registers for the bindings it exports from hot modules,
+ * keyed by module id and local name; an updated module writes through them.
+ */
+module.exports.liveExportSetters = "__webpack_require__.lE";
+
 /**
  * function to load a script tag.
  * Arguments: (url: string, done: (event) => void), key?: string | number, chunkId?: string | number) => void

package/lib/runtime/RuntimePlugin.js

@@ -143,6 +143,7 @@ const GLOBALS_ON_REQUIRE = [
 	RuntimeGlobals.definePropertyGetters,
 	RuntimeGlobals.ensureChunk,
 	RuntimeGlobals.entryModuleId,
+	RuntimeGlobals.cssInjectStyle,
 	RuntimeGlobals.getCssServerStyles,
 	RuntimeGlobals.getFullHash,
 	RuntimeGlobals.global,
@@ -181,6 +182,7 @@ const MODULE_DEPENDENCIES = {
 };
 
 const TREE_DEPENDENCIES = {
+	[RuntimeGlobals.asyncModuleExportSymbol]: [RuntimeGlobals.asyncModule],
 	[RuntimeGlobals.definePropertyGetters]: [RuntimeGlobals.hasOwnProperty],
 	[RuntimeGlobals.compatGetDefaultExport]: [
 		RuntimeGlobals.definePropertyGetters

package/lib/schemes/HttpUriPlugin.js

@@ -1204,8 +1204,7 @@ class HttpUriPlugin {
 									resolveContent(url, null, (err, result) => {
 										if (err) return callback(err);
 										storeResult(
-											/** @type {Lockfile} */
-											(lockfile),
+											lockfile,
 											url,
 											/** @type {ResolveContentResult} */
 											(result),

package/lib/schemes/VirtualUrlPlugin.js

@@ -58,7 +58,7 @@ const PLUGIN_NAME = "VirtualUrlPlugin";
 /**
  * @inline
  * @tsType import('./VirtualUrlPlugin').SourceFn
- * @typedef {(loaderContext: LoaderContext<EXPECTED_ANY>) => Promise<string | Buffer> | string | Buffer} SourceFn
+ * @typedef {(loaderContext: LoaderContext<LoaderOptions>) => Promise<string | Buffer> | string | Buffer} SourceFn
  */
 /**
  * @inline
@@ -67,6 +67,8 @@ const PLUGIN_NAME = "VirtualUrlPlugin";
  */
 /** @typedef {{ [key: string]: VirtualModuleContent }} VirtualModules */
 
+/** @import { LoaderOptions } from "../loaders/LoaderRunner" */
+
 /**
  * Defines the loader context type used by this module.
  * @template T

package/lib/serialization/AggregateErrorSerializer.js

@@ -8,7 +8,7 @@
 /** @typedef {import("./ObjectMiddleware").ObjectDeserializerContext<ComplexSerializableType[]>} ObjectDeserializerContext */
 /** @typedef {import("./ObjectMiddleware").ObjectSerializerContext<ComplexSerializableType[]>} ObjectSerializerContext */
 
-/** @typedef {Error & { cause?: unknown, errors: ComplexSerializableType[] }} AggregateError */
+/** @typedef {Error & { cause?: ComplexSerializableType, errors: ComplexSerializableType[] }} AggregateError */
 
 class AggregateErrorSerializer {
 	/**
@@ -20,7 +20,7 @@ class AggregateErrorSerializer {
 		context.write(obj.errors);
 		context.write(obj.message);
 		context.write(obj.stack);
-		context.write(/** @type {ComplexSerializableType} */ (obj.cause));
+		context.write(obj.cause);
 	}
 
 	/**
@@ -37,7 +37,7 @@ class AggregateErrorSerializer {
 		err.stack = /** @type {string | undefined} */ (context.read());
 		err.cause = context.read();
 
-		return err;
+		return /** @type {AggregateError} */ (err);
 	}
 }
 

package/lib/serialization/BinaryMiddleware.js

@@ -484,7 +484,10 @@ class BinaryMiddleware extends SerializerMiddleware {
 				sectionStart = i + 1;
 				const operation =
 					/** @type {MEASURE_START_OPERATION_TYPE | MEASURE_END_OPERATION_TYPE} */
-					(/** @type {unknown} */ (thing));
+					(
+						/** @type {typeof thing | MEASURE_START_OPERATION_TYPE | MEASURE_END_OPERATION_TYPE} */
+						(thing)
+					);
 				if (operation === MEASURE_START_OPERATION) {
 					measureStack.push(writtenBytes);
 				} else if (operation === MEASURE_END_OPERATION) {

package/lib/serialization/ErrorObjectSerializer.js

@@ -8,7 +8,7 @@
 /** @typedef {import("./ObjectMiddleware").ObjectDeserializerContext<ComplexSerializableType[]>} ObjectDeserializerContext */
 /** @typedef {import("./ObjectMiddleware").ObjectSerializerContext<ComplexSerializableType[]>} ObjectSerializerContext */
 
-/** @typedef {Error & { cause?: unknown }} ErrorWithCause */
+/** @typedef {Error & { cause?: ComplexSerializableType }} ErrorWithCause */
 
 class ErrorObjectSerializer {
 	/**
@@ -27,10 +27,7 @@ class ErrorObjectSerializer {
 	serialize(obj, context) {
 		context.write(obj.message);
 		context.write(obj.stack);
-		context.write(
-			/** @type {ComplexSerializableType} */
-			(/** @type {ErrorWithCause} */ (obj).cause)
-		);
+		context.write(/** @type {ErrorWithCause} */ (obj).cause);
 	}
 
 	/**

package/lib/serialization/ObjectMiddleware.js

@@ -49,7 +49,7 @@ const SetObjectSerializer = require("./SetObjectSerializer");
  * } from "./types"
  */
 
-/** @typedef {new (...params: EXPECTED_ANY[]) => EXPECTED_ANY} Constructor */
+/** @typedef {abstract new (...params: never[]) => EXPECTED_OBJECT} Constructor */
 
 /**
  * Defines the object serializer snapshot type used by this module.
@@ -65,35 +65,36 @@ const SetObjectSerializer = require("./SetObjectSerializer");
 /** @typedef {EXPECTED_OBJECT | string} ReferenceableItem */
 
 /**
- * First tuple element; element type for an open array; `EXPECTED_ANY` once exhausted.
- * @template {readonly EXPECTED_ANY[]} T
- * @typedef {T extends readonly [infer H, ...infer _Rest] ? H : T extends readonly [] ? EXPECTED_ANY : T extends readonly (infer E)[] ? E : never} Head
+ * First tuple element; element type for an open array; `never` once exhausted,
+ * so a read or write past the declared tuple fails to type-check.
+ * @template T
+ * @typedef {T extends readonly [infer H, ...infer _Rest] ? H : T extends readonly [] ? never : T extends readonly (infer E)[] ? E : never} Head
  */
 
 /**
  * Tuple without its first element; unchanged when `T` is an open array.
- * @template {readonly EXPECTED_ANY[]} T
+ * @template T
  * @typedef {T extends readonly [infer _First, ...infer R] ? R : T} Tail
  */
 
 /**
  * Defines the object serializer context type used by this module.
  * `T` is the tuple of values written in order; each `write` consumes the head.
- * @template {readonly EXPECTED_ANY[]} [T=readonly EXPECTED_ANY[]]
+ * @template [T=readonly EXPECTED_ANY[]]
  * @typedef {object} ObjectSerializerContext
  * @property {(value: Head<T>) => ObjectSerializerContext<Tail<T>>} write
  * @property {(value: ReferenceableItem) => void} setCircularReference
  * @property {() => ObjectSerializerSnapshot} snapshot
  * @property {(snapshot: ObjectSerializerSnapshot) => void} rollback
  * @property {((item: ComplexSerializableType) => void)=} writeLazy
- * @property {((item: ComplexSerializableType, obj: LazyOptions | undefined) => import("./SerializerMiddleware").LazyFunction<EXPECTED_ANY, EXPECTED_ANY, LazyTarget, LazyOptions>)=} writeSeparate
+ * @property {((item: ComplexSerializableType, obj: LazyOptions | undefined) => import("./SerializerMiddleware").LazyFunction<EXPECTED_ANY, PrimitiveSerializableType[], LazyTarget, LazyOptions>)=} writeSeparate
  */
 
 /**
  * Defines the object deserializer context type used by this module.
  * `T` is the tuple of values read in order: `read` returns the head, and `rest`
  * re-types the same context to `Tail<T>` so successive reads stay positional.
- * @template {readonly EXPECTED_ANY[]} [T=readonly EXPECTED_ANY[]]
+ * @template [T=readonly EXPECTED_ANY[]]
  * @typedef {object} ObjectDeserializerContext
  * @property {() => Head<T>} read
  * @property {ObjectDeserializerContext<Tail<T>>} rest
@@ -102,9 +103,9 @@ const SetObjectSerializer = require("./SetObjectSerializer");
 
 /**
  * Defines the object serializer type used by this module.
- * @typedef {object} ObjectSerializer
- * @property {(value: EXPECTED_ANY, context: ObjectSerializerContext<EXPECTED_ANY>) => void} serialize
- * @property {(context: ObjectDeserializerContext<EXPECTED_ANY>) => EXPECTED_ANY} deserialize
+ * Methods, so a serializer may narrow `value` to the class it is registered for.
+ * @template {EXPECTED_OBJECT} [T=EXPECTED_OBJECT]
+ * @typedef {{ serialize(value: T, context: ObjectSerializerContext): void, deserialize(context: ObjectDeserializerContext): EXPECTED_OBJECT }} ObjectSerializer
  */
 
 /**
@@ -255,10 +256,11 @@ class ObjectMiddleware extends SerializerMiddleware {
 
 	/**
 	 * Processes the provided constructor.
-	 * @param {Constructor} Constructor the constructor
+	 * @template {Constructor} C
+	 * @param {C} Constructor the constructor
 	 * @param {string} request the request which will be required when deserializing
 	 * @param {string | null} name the name to make multiple serializer unique when sharing a request
-	 * @param {ObjectSerializer} serializer the serializer
+	 * @param {ObjectSerializer<InstanceType<C>>} serializer the serializer
 	 * @returns {void}
 	 */
 	static register(Constructor, request, name, serializer) {
@@ -811,7 +813,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 				bufferDedupeMap =
 				objectTypeLookup =
 				ctx =
-					/** @type {EXPECTED_ANY} */
+					/** @type {never} */
 					(undefined);
 		}
 	}
@@ -1011,7 +1013,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 				data =
 				objectTypeLookup =
 				ctx =
-					/** @type {EXPECTED_ANY} */
+					/** @type {never} */
 					(undefined);
 		}
 	}

package/lib/serialization/PlainObjectSerializer.js

@@ -5,7 +5,7 @@
 "use strict";
 /** @import { ObjectDeserializerContext, ObjectSerializerContext } from "./ObjectMiddleware" */
 
-/** @typedef {ObjectSerializerContext<EXPECTED_ANY>["write"]} CacheAssoc */
+/** @typedef {(value: never) => EXPECTED_OBJECT} CacheAssoc */
 
 /**
  * Defines the shared type used by this module.
@@ -114,14 +114,10 @@ class PlainObjectSerializer {
 		const obj = /** @type {T} */ ({});
 		if (Array.isArray(keys)) {
 			for (const key of keys) {
-				obj[/** @type {keyof T} */ (key)] = /** @type {T[keyof T]} */ (
-					context.read()
-				);
+				obj[key] = /** @type {T[keyof T]} */ (context.read());
 			}
 		} else if (keys !== null) {
-			obj[/** @type {keyof T} */ (keys)] = /** @type {T[keyof T]} */ (
-				context.read()
-			);
+			obj[keys] = /** @type {T[keyof T]} */ (context.read());
 		}
 		return obj;
 	}

package/lib/serialization/Serializer.js

@@ -6,10 +6,14 @@
 
 /**
  * Defines the serializer middleware type used by this module.
- * @template T, K, C
+ * @template [T=ComplexSerializableType]
+ * @template [K=ComplexSerializableType]
+ * @template [C=EXPECTED_OBJECT]
  * @typedef {import("./SerializerMiddleware")<T, K, C>} SerializerMiddleware
  */
 
+/** @import { ComplexSerializableType } from "./types" */
+
 /**
  * Represents Serializer.
  * @template DeserializedValue
@@ -19,7 +23,7 @@
 class Serializer {
 	/**
 	 * Creates an instance of Serializer.
-	 * @param {SerializerMiddleware<EXPECTED_ANY, EXPECTED_ANY, EXPECTED_ANY>[]} middlewares serializer middlewares
+	 * @param {SerializerMiddleware[]} middlewares serializer middlewares
 	 * @param {Context=} context context
 	 */
 	constructor(middlewares, context) {
@@ -38,15 +42,18 @@ class Serializer {
 	 */
 	serialize(obj, context) {
 		const ctx = { ...context, ...this.context };
-		let current = obj;
+		let current =
+			/** @type {ComplexSerializableType | Promise<ComplexSerializableType>} */
+			(obj);
 		for (const middleware of this.serializeMiddlewares) {
 			if (
 				current &&
-				typeof (/** @type {Promise<DeserializedValue>} */ (current).then) ===
-					"function"
+				typeof (
+					/** @type {Promise<ComplexSerializableType>} */ (current).then
+				) === "function"
 			) {
 				current =
-					/** @type {Promise<DeserializedValue>} */
+					/** @type {Promise<ComplexSerializableType>} */
 					(current).then((data) => data && middleware.serialize(data, ctx));
 			} else if (current) {
 				try {
@@ -70,14 +77,17 @@ class Serializer {
 	 */
 	deserialize(value, context) {
 		const ctx = { ...context, ...this.context };
-		let current = value;
+		let current =
+			/** @type {ComplexSerializableType | Promise<ComplexSerializableType>} */
+			(value);
 		for (const middleware of this.deserializeMiddlewares) {
 			current =
 				current &&
-				typeof (/** @type {Promise<SerializedValue>} */ (current).then) ===
-					"function"
-					? /** @type {Promise<SerializedValue>} */ (current).then((data) =>
-							middleware.deserialize(data, ctx)
+				typeof (
+					/** @type {Promise<ComplexSerializableType>} */ (current).then
+				) === "function"
+					? /** @type {Promise<ComplexSerializableType>} */ (current).then(
+							(data) => middleware.deserialize(data, ctx)
 						)
 					: middleware.deserialize(current, ctx);
 		}

package/lib/serialization/SerializerMiddleware.js

@@ -9,7 +9,9 @@ const memoize = require("../util/memoize");
 const LAZY_TARGET = Symbol("lazy serialization target");
 const LAZY_SERIALIZED_VALUE = Symbol("lazy serialization data");
 
-/** @typedef {SerializerMiddleware<EXPECTED_ANY, EXPECTED_ANY, Record<string, EXPECTED_ANY>>} LazyTarget */
+/** @import { ComplexSerializableType } from "./types" */
+
+/** @typedef {SerializerMiddleware} LazyTarget */
 /** @typedef {{ name?: string, size?: number }} LazyOptions */
 
 /**
@@ -23,9 +25,9 @@ const LAZY_SERIALIZED_VALUE = Symbol("lazy serialization data");
 
 /**
  * Represents SerializerMiddleware.
- * @template DeserializedType
- * @template SerializedType
- * @template Context
+ * @template [DeserializedType=ComplexSerializableType]
+ * @template [SerializedType=ComplexSerializableType]
+ * @template [Context=EXPECTED_OBJECT]
  */
 class SerializerMiddleware {
 	/* istanbul ignore next */
@@ -117,8 +119,8 @@ class SerializerMiddleware {
 	 * @template TLazyOutputValue
 	 * @template {LazyTarget} TLazyTarget
 	 * @template {LazyOptions} TLazyOptions
-	 * @param {LazyFunction<TLazyInputValue, TLazyOutputValue, TLazyTarget, TLazyOptions> | EXPECTED_ANY} fn lazy function
-	 * @returns {TLazyOutputValue | undefined} serialized value
+	 * @param {LazyFunction<TLazyInputValue, TLazyOutputValue, TLazyTarget, TLazyOptions>} fn lazy function
+	 * @returns {TLazyOutputValue | LazyFunction<TLazyOutputValue, TLazyInputValue, TLazyTarget, TLazyOptions> | undefined} serialized value
 	 */
 	static getLazySerializedValue(fn) {
 		if (typeof fn !== "function") return;

package/lib/stats/DefaultStatsFactoryPlugin.js

@@ -39,7 +39,6 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * 	Asset,
  * 	AssetInfo,
  * 	ExcludeModulesType,
- * 	KnownNormalizedStatsOptions,
  * 	NormalizedStatsOptions
  * } from "../Compilation"
  */
@@ -74,11 +73,19 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @typedef {import("./smartGrouping").GroupConfig<I, G>} GroupConfig
  */
 
-/** @typedef {KnownStatsCompilation & Record<string, EXPECTED_ANY>} StatsCompilation */
+/**
+ * A value stats JSON holds; `undefined` stands for a field left out and `Buffer` for a binary module source.
+ * @typedef {string | number | boolean | null | undefined | Buffer | StatsJsonArray | { [key: string]: StatsJsonValue }} StatsJsonValue
+ */
+
+// A separate alias: JSDoc rejects `StatsJsonValue[]` inside its own definition.
+/** @typedef {StatsJsonValue[]} StatsJsonArray */
+
+/** @typedef {KnownStatsCompilation & Record<string, StatsJsonValue>} StatsCompilation */
 /**
  * Defines the known stats compilation type used by this module.
  * @typedef {object} KnownStatsCompilation
- * @property {EXPECTED_ANY=} env
+ * @property {StatsJsonValue=} env
  * @property {string=} name
  * @property {string=} hash
  * @property {string=} version
@@ -107,7 +114,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {number=} filteredErrorDetailsCount
  */
 
-/** @typedef {KnownStatsLogging & Record<string, EXPECTED_ANY>} StatsLogging */
+/** @typedef {KnownStatsLogging & Record<string, StatsJsonValue>} StatsLogging */
 /**
  * Defines the known stats logging type used by this module.
  * @typedef {object} KnownStatsLogging
@@ -116,7 +123,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean} debug
  */
 
-/** @typedef {KnownStatsLoggingEntry & Record<string, EXPECTED_ANY>} StatsLoggingEntry */
+/** @typedef {KnownStatsLoggingEntry & Record<string, StatsJsonValue>} StatsLoggingEntry */
 /**
  * Defines the known stats logging entry type used by this module.
  * @typedef {object} KnownStatsLoggingEntry
@@ -128,7 +135,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {number=} time
  */
 
-/** @typedef {KnownStatsAsset & Record<string, EXPECTED_ANY>} StatsAsset */
+/** @typedef {KnownStatsAsset & Record<string, StatsJsonValue>} StatsAsset */
 /** @typedef {string[]} ChunkIdHints */
 /**
  * Defines the known stats asset type used by this module.
@@ -151,7 +158,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean=} isOverSizeLimit
  */
 
-/** @typedef {KnownStatsChunkGroup & Record<string, EXPECTED_ANY>} StatsChunkGroup */
+/** @typedef {KnownStatsChunkGroup & Record<string, StatsJsonValue>} StatsChunkGroup */
 /**
  * Defines the known stats chunk group type used by this module.
  * @typedef {object} KnownStatsChunkGroup
@@ -169,7 +176,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  */
 
 /** @typedef {Module[]} ModuleIssuerPath */
-/** @typedef {KnownStatsModule & Record<string, EXPECTED_ANY>} StatsModule */
+/** @typedef {KnownStatsModule & Record<string, StatsJsonValue>} StatsModule */
 /**
  * Defines the known stats module type used by this module.
  * @typedef {object} KnownStatsModule
@@ -215,7 +222,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ReturnType<Source["source"]>=} source
  */
 
-/** @typedef {KnownStatsProfile & Record<string, EXPECTED_ANY>} StatsProfile */
+/** @typedef {KnownStatsProfile & Record<string, StatsJsonValue>} StatsProfile */
 /**
  * Defines the known stats profile type used by this module.
  * @typedef {object} KnownStatsProfile
@@ -231,7 +238,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {number} dependencies
  */
 
-/** @typedef {KnownStatsModuleIssuer & Record<string, EXPECTED_ANY>} StatsModuleIssuer */
+/** @typedef {KnownStatsModuleIssuer & Record<string, StatsJsonValue>} StatsModuleIssuer */
 /**
  * Defines the known stats module issuer type used by this module.
  * @typedef {object} KnownStatsModuleIssuer
@@ -241,7 +248,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {StatsProfile} profile
  */
 
-/** @typedef {KnownStatsModuleReason & Record<string, EXPECTED_ANY>} StatsModuleReason */
+/** @typedef {KnownStatsModuleReason & Record<string, StatsJsonValue>} StatsModuleReason */
 /**
  * Defines the known stats module reason type used by this module.
  * @typedef {object} KnownStatsModuleReason
@@ -259,7 +266,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ModuleId | null=} resolvedModuleId
  */
 
-/** @typedef {KnownStatsChunk & Record<string, EXPECTED_ANY>} StatsChunk */
+/** @typedef {KnownStatsChunk & Record<string, StatsJsonValue>} StatsChunk */
 /**
  * Defines the known stats chunk type used by this module.
  * @typedef {object} KnownStatsChunk
@@ -286,7 +293,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {StatsChunkOrigin[]=} origins
  */
 
-/** @typedef {KnownStatsChunkOrigin & Record<string, EXPECTED_ANY>} StatsChunkOrigin */
+/** @typedef {KnownStatsChunkOrigin & Record<string, StatsJsonValue>} StatsChunkOrigin */
 /**
  * Defines the known stats chunk origin type used by this module.
  * @typedef {object} KnownStatsChunkOrigin
@@ -298,7 +305,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ModuleId=} moduleId
  */
 
-/** @typedef {KnownStatsModuleTraceItem & Record<string, EXPECTED_ANY>} StatsModuleTraceItem */
+/** @typedef {KnownStatsModuleTraceItem & Record<string, StatsJsonValue>} StatsModuleTraceItem */
 /**
  * Defines the known stats module trace item type used by this module.
  * @typedef {object} KnownStatsModuleTraceItem
@@ -311,14 +318,14 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ModuleId=} moduleId
  */
 
-/** @typedef {KnownStatsModuleTraceDependency & Record<string, EXPECTED_ANY>} StatsModuleTraceDependency */
+/** @typedef {KnownStatsModuleTraceDependency & Record<string, StatsJsonValue>} StatsModuleTraceDependency */
 /**
  * Defines the known stats module trace dependency type used by this module.
  * @typedef {object} KnownStatsModuleTraceDependency
  * @property {string=} loc
  */
 
-/** @typedef {KnownStatsError & Record<string, EXPECTED_ANY>} StatsError */
+/** @typedef {KnownStatsError & Record<string, StatsJsonValue>} StatsError */
 /**
  * Defines the known stats error type used by this module.
  * @typedef {object} KnownStatsError
@@ -870,10 +877,7 @@ const SIMPLE_EXTRACTORS = {
 				compilationFileToChunks,
 				compilationAuxiliaryFileToChunks
 			});
-			const limited = spaceLimited(
-				groupedAssets,
-				/** @type {number} */ (options.assetsSpace)
-			);
+			const limited = spaceLimited(groupedAssets, options.assetsSpace);
 			object.assets = limited.children;
 			object.filteredAssets = limited.filteredChildren;
 		},
@@ -1022,10 +1026,7 @@ const SIMPLE_EXTRACTORS = {
 		) => {
 			const { type, cachedGetWarnings } = context;
 			object.warningsCount = countWithChildren(compilation, (c, childType) => {
-				if (
-					/** @type {KnownNormalizedStatsOptions["warningsFilter"]} */
-					(warningsFilter).length === 0
-				) {
+				if (warningsFilter.length === 0) {
 					return cachedGetWarnings(c);
 				}
 				return factory
@@ -1132,8 +1133,7 @@ const SIMPLE_EXTRACTORS = {
 				context
 			);
 			object.filteredRelated = asset.related
-				? asset.related.length -
-					/** @type {StatsAsset[]} */ (object.related).length
+				? asset.related.length - object.related.length
 				: undefined;
 		},
 		ids: (
@@ -1293,7 +1293,7 @@ const SIMPLE_EXTRACTORS = {
 	module: {
 		_: (object, module, context, options, factory) => {
 			const { type } = context;
-			const compilation = /** @type {Compilation} */ (context.compilation);
+			const compilation = context.compilation;
 			const built = compilation.builtModules.has(module);
 			const codeGenerated = compilation.codeGeneratedModules.has(module);
 			const buildTimeExecuted =
@@ -1324,7 +1324,7 @@ const SIMPLE_EXTRACTORS = {
 	module$visible: {
 		_: (object, module, context, { requestShortener }, factory) => {
 			const { type, rootModules } = context;
-			const compilation = /** @type {Compilation} */ (context.compilation);
+			const compilation = context.compilation;
 			const { moduleGraph } = compilation;
 			/** @type {ModuleIssuerPath} */
 			const path = [];
@@ -1514,7 +1514,7 @@ const SIMPLE_EXTRACTORS = {
 	moduleIssuer: {
 		_: (object, module, context, { requestShortener }, factory) => {
 			const { type } = context;
-			const compilation = /** @type {Compilation} */ (context.compilation);
+			const compilation = context.compilation;
 			const { moduleGraph } = compilation;
 			const profile = moduleGraph.getProfile(module);
 			// assign fields directly to avoid an intermediate object + copy per issuer
@@ -2617,7 +2617,7 @@ const sortOrderRegular = (field) => {
  */
 const noSort = (a, b) => 0;
 
-/** @type {Map<string, (a: EXPECTED_ANY, b: EXPECTED_ANY) => 0 | 1 | -1>} */
+/** @type {Map<string, Comparator<{ [field: string]: string | number }>>} */
 const sortByFieldCache = new Map();
 
 /**
@@ -2632,7 +2632,7 @@ const sortByField = (field) => {
 	// memoize per field: the comparator (and its selector) is pure, so building it
 	// once keeps compareSelect's cache warm instead of allocating a new entry per sort
 	let sortFn = sortByFieldCache.get(field);
-	if (sortFn !== undefined) return sortFn;
+	if (sortFn !== undefined) return /** @type {Comparator<T>} */ (sortFn);
 
 	const fieldKey = normalizeFieldKey(field);
 
@@ -2645,7 +2645,7 @@ const sortByField = (field) => {
 	}
 
 	sortByFieldCache.set(field, sortFn);
-	return sortFn;
+	return /** @type {Comparator<T>} */ (sortFn);
 };
 
 /**
@@ -2815,7 +2815,7 @@ class DefaultStatsFactoryPlugin {
 				(stats, options) => {
 					iterateConfig(SIMPLE_EXTRACTORS, options, (hookFor, fn) => {
 						stats.hooks.extract
-							.for(hookFor)
+							.for(/** @type {string} */ (hookFor))
 							.tap(PLUGIN_NAME, (obj, data, ctx) =>
 								fn(obj, data, ctx, options, stats)
 							);
@@ -2843,14 +2843,14 @@ class DefaultStatsFactoryPlugin {
 					});
 					iterateConfig(RESULT_SORTERS, options, (hookFor, fn) => {
 						stats.hooks.sortResults
-							.for(hookFor)
+							.for(/** @type {string} */ (hookFor))
 							.tap(PLUGIN_NAME, (comparators, ctx) =>
 								fn(comparators, ctx, options)
 							);
 					});
 					iterateConfig(RESULT_GROUPERS, options, (hookFor, fn) => {
 						stats.hooks.groupResults
-							.for(hookFor)
+							.for(/** @type {string} */ (hookFor))
 							.tap(PLUGIN_NAME, (groupConfigs, ctx) =>
 								fn(groupConfigs, ctx, options)
 							);

package/lib/stats/DefaultStatsPresetPlugin.js

@@ -318,7 +318,7 @@ const normalizeFilter = (item) => {
 		const regExp = new RegExp(
 			`[\\\\/]${item.replace(/[-[\]{}()*+?.\\^$|]/g, "\\$&")}([\\\\/]|$|!|\\?)`
 		);
-		return (ident) => regExp.test(/** @type {T} */ (ident));
+		return (ident) => regExp.test(ident);
 	}
 	if (item && typeof item === "object" && typeof item.test === "function") {
 		return (ident) => item.test(ident);
@@ -418,11 +418,7 @@ class DefaultStatsPresetPlugin {
 			compilation.hooks.statsNormalize.tap(PLUGIN_NAME, (options, context) => {
 				for (const key of Object.keys(DEFAULTS)) {
 					if (options[key] === undefined) {
-						options[key] = DEFAULTS[/** @type {DefaultsKeys} */ (key)](
-							options,
-							context,
-							compilation
-						);
+						options[key] = DEFAULTS[key](options, context, compilation);
 					}
 				}
 				for (const key of Object.keys(NORMALIZER)) {