webpack 5.97.1 → 5.99.0

package/lib/stats/DefaultStatsFactoryPlugin.js

@@ -27,14 +27,15 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("../Chunk")} Chunk */
 /** @typedef {import("../Chunk").ChunkId} ChunkId */
+/** @typedef {import("../ChunkGraph").ModuleId} ModuleId */
 /** @typedef {import("../ChunkGroup")} ChunkGroup */
 /** @typedef {import("../ChunkGroup").OriginRecord} OriginRecord */
 /** @typedef {import("../Compilation")} Compilation */
 /** @typedef {import("../Compilation").Asset} Asset */
 /** @typedef {import("../Compilation").AssetInfo} AssetInfo */
+/** @typedef {import("../Compilation").KnownNormalizedStatsOptions} KnownNormalizedStatsOptions */
 /** @typedef {import("../Compilation").NormalizedStatsOptions} NormalizedStatsOptions */
 /** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("../ChunkGraph").ModuleId} ModuleId */
 /** @typedef {import("../Dependency")} Dependency */
 /** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("../Module")} Module */
@@ -42,20 +43,23 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {import("../ModuleGraphConnection")} ModuleGraphConnection */
 /** @typedef {import("../ModuleProfile")} ModuleProfile */
 /** @typedef {import("../RequestShortener")} RequestShortener */
-/** @typedef {import("../WebpackError")} WebpackError */
 /** @typedef {import("../TemplatedPathPlugin").TemplatePath} TemplatePath */
+/** @typedef {import("../WebpackError")} WebpackError */
+/** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
+/** @typedef {import("./StatsFactory")} StatsFactory */
+/** @typedef {import("./StatsFactory").StatsFactoryContext} StatsFactoryContext */
+
 /**
  * @template T
  * @typedef {import("../util/comparators").Comparator<T>} Comparator<T>
  */
-/** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
+
 /**
  * @template T, R
  * @typedef {import("../util/smartGrouping").GroupConfig<T, R>} GroupConfig
  */
-/** @typedef {import("./StatsFactory")} StatsFactory */
-/** @typedef {import("./StatsFactory").StatsFactoryContext} StatsFactoryContext */
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsCompilation} StatsCompilation */
+
+/** @typedef {KnownStatsCompilation & Record<string, EXPECTED_ANY>} StatsCompilation */
 /**
  * @typedef {object} KnownStatsCompilation
  * @property {any=} env
@@ -83,7 +87,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {Record<string, StatsLogging>=} logging
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsLogging} StatsLogging */
+/** @typedef {KnownStatsLogging & Record<string, EXPECTED_ANY>} StatsLogging */
 /**
  * @typedef {object} KnownStatsLogging
  * @property {StatsLoggingEntry[]} entries
@@ -91,18 +95,18 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean} debug
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsLoggingEntry} StatsLoggingEntry */
+/** @typedef {KnownStatsLoggingEntry & Record<string, EXPECTED_ANY>} StatsLoggingEntry */
 /**
  * @typedef {object} KnownStatsLoggingEntry
  * @property {string} type
  * @property {string=} message
  * @property {string[]=} trace
  * @property {StatsLoggingEntry[]=} children
- * @property {any[]=} args
+ * @property {EXPECTED_ANY[]=} args
  * @property {number=} time
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsAsset} StatsAsset */
+/** @typedef {KnownStatsAsset & Record<string, EXPECTED_ANY>} StatsAsset */
 /**
  * @typedef {object} KnownStatsAsset
  * @property {string} type
@@ -123,7 +127,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean=} isOverSizeLimit
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsChunkGroup} StatsChunkGroup */
+/** @typedef {KnownStatsChunkGroup & Record<string, EXPECTED_ANY>} StatsChunkGroup */
 /**
  * @typedef {object} KnownStatsChunkGroup
  * @property {(string | null)=} name
@@ -139,7 +143,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean=} isOverSizeLimit
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsModule} StatsModule */
+/** @typedef {KnownStatsModule & Record<string, EXPECTED_ANY>} StatsModule */
 /**
  * @typedef {object} KnownStatsModule
  * @property {string=} type
@@ -183,7 +187,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ReturnType<Source["source"]>=} source
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsProfile} StatsProfile */
+/** @typedef {KnownStatsProfile & Record<string, EXPECTED_ANY>} StatsProfile */
 /**
  * @typedef {object} KnownStatsProfile
  * @property {number} total
@@ -198,7 +202,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {number} dependencies
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsModuleIssuer} StatsModuleIssuer */
+/** @typedef {KnownStatsModuleIssuer & Record<string, EXPECTED_ANY>} StatsModuleIssuer */
 /**
  * @typedef {object} KnownStatsModuleIssuer
  * @property {string} identifier
@@ -207,7 +211,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {StatsProfile} profile
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsModuleReason} StatsModuleReason */
+/** @typedef {KnownStatsModuleReason & Record<string, EXPECTED_ANY>} StatsModuleReason */
 /**
  * @typedef {object} KnownStatsModuleReason
  * @property {string | null} moduleIdentifier
@@ -224,7 +228,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {(string | number | null)=} resolvedModuleId
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsChunk} StatsChunk */
+/** @typedef {KnownStatsChunk & Record<string, EXPECTED_ANY>} StatsChunk */
 /**
  * @typedef {object} KnownStatsChunk
  * @property {boolean} rendered
@@ -250,7 +254,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {StatsChunkOrigin[]=} origins
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsChunkOrigin} StatsChunkOrigin */
+/** @typedef {KnownStatsChunkOrigin & Record<string, EXPECTED_ANY>} StatsChunkOrigin */
 /**
  * @typedef {object} KnownStatsChunkOrigin
  * @property {string} module
@@ -261,7 +265,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {(string | number)=} moduleId
  */
 
-/** @typedef { Record<string, EXPECTED_ANY> & KnownStatsModuleTraceItem} StatsModuleTraceItem */
+/** @typedef {KnownStatsModuleTraceItem & Record<string, EXPECTED_ANY>} StatsModuleTraceItem */
 /**
  * @typedef {object} KnownStatsModuleTraceItem
  * @property {string=} originIdentifier
@@ -273,13 +277,13 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {(string|number)=} moduleId
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsModuleTraceDependency} StatsModuleTraceDependency */
+/** @typedef {KnownStatsModuleTraceDependency & Record<string, EXPECTED_ANY>} StatsModuleTraceDependency */
 /**
  * @typedef {object} KnownStatsModuleTraceDependency
  * @property {string=} loc
  */
 
-/** @typedef {Record<string, EXPECTED_ANY> & KnownStatsError} StatsError */
+/** @typedef {KnownStatsError & Record<string, EXPECTED_ANY>} StatsError */
 /**
  * @typedef {object} KnownStatsError
  * @property {string} message
@@ -293,8 +297,9 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ChunkId=} chunkId
  * @property {string|number=} moduleId
  * @property {StatsModuleTraceItem[]=} moduleTrace
- * @property {any=} details
+ * @property {string=} details
  * @property {string=} stack
+ * @property {string=} compilerPath
  */
 
 /** @typedef {Asset & { type: string, related: PreprocessedAsset[] | undefined }} PreprocessedAsset */
@@ -328,7 +333,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @template T
  * @template I
  * @param {Iterable<T>} items items to select from
- * @param {function(T): Iterable<I>} selector selector function to select values from item
+ * @param {(item: T) => Iterable<I>} selector selector function to select values from item
  * @returns {I[]} array of values
  */
 const uniqueArray = (items, selector) => {
@@ -346,7 +351,7 @@ const uniqueArray = (items, selector) => {
  * @template T
  * @template I
  * @param {Iterable<T>} items items to select from
- * @param {function(T): Iterable<I>} selector selector function to select values from item
+ * @param {(item: T) => Iterable<I>} selector selector function to select values from item
  * @param {Comparator<I>} comparator comparator function
  * @returns {I[]} array of values
  */
@@ -374,8 +379,9 @@ const mapObject = (obj, fn) => {
 };
 
 /**
+ * @template T
  * @param {Compilation} compilation the compilation
- * @param {function(Compilation, string): any[]} getItems get items
+ * @param {(compilation: Compilation, name: string) => T[]} getItems get items
  * @returns {number} total number
  */
 const countWithChildren = (compilation, getItems) => {
@@ -396,7 +402,9 @@ const EXTRACT_ERROR = {
 			object.message = error;
 		} else {
 			if (error.chunk) {
-				object.chunkName = error.chunk.name;
+				object.chunkName =
+					/** @type {string | undefined} */
+					(error.chunk.name);
 				object.chunkEntry = error.chunk.hasRuntime();
 				object.chunkInitial = error.chunk.canBeInitial();
 			}
@@ -904,7 +912,7 @@ const SIMPLE_EXTRACTORS = {
 			object.warningsCount = countWithChildren(compilation, (c, childType) => {
 				if (
 					!warningsFilter &&
-					/** @type {((warning: StatsError, textValue: string) => boolean)[]} */
+					/** @type {KnownNormalizedStatsOptions["warningsFilter"]} */
 					(warningsFilter).length === 0
 				)
 					return cachedGetWarnings(c);
@@ -1574,7 +1582,7 @@ const SIMPLE_EXTRACTORS = {
 	}
 };
 
-/** @type {Record<string, Record<string, (thing: any, context: StatsFactoryContext, options: NormalizedStatsOptions) => boolean | undefined>>} */
+/** @type {Record<string, Record<string, (thing: ModuleGraphConnection, context: StatsFactoryContext, options: NormalizedStatsOptions, idx: number, i: number) => boolean | undefined>>} */
 const FILTER = {
 	"module.reasons": {
 		"!orphanModules": (reason, { compilation: { chunkGraph } }) => {
@@ -1588,7 +1596,7 @@ const FILTER = {
 	}
 };
 
-/** @type {Record<string, Record<string, (thing: KnownStatsError, context: StatsFactoryContext, options: NormalizedStatsOptions) => boolean | undefined>>} */
+/** @type {Record<string, Record<string, (thing: KnownStatsError, context: StatsFactoryContext, options: NormalizedStatsOptions, idx: number, i: number) => boolean | undefined>>} */
 const FILTER_RESULTS = {
 	"compilation.warnings": {
 		warningsFilter: util.deprecate(
@@ -1604,39 +1612,20 @@ const FILTER_RESULTS = {
 	}
 };
 
-/** @type {Record<string, (comparators: Function[], context: StatsFactoryContext) => void>} */
+/**
+ * @type {Record<string, (comparators: Comparator<Module>[], context: StatsFactoryContext) => void>}
+ */
 const MODULES_SORTER = {
 	_: (comparators, { compilation: { moduleGraph } }) => {
 		comparators.push(
-			compareSelect(
-				/**
-				 * @param {Module} m module
-				 * @returns {number | null} depth
-				 */
-				m => moduleGraph.getDepth(m),
-				compareNumbers
-			),
-			compareSelect(
-				/**
-				 * @param {Module} m module
-				 * @returns {number | null} index
-				 */
-				m => moduleGraph.getPreOrderIndex(m),
-				compareNumbers
-			),
-			compareSelect(
-				/**
-				 * @param {Module} m module
-				 * @returns {string} identifier
-				 */
-				m => m.identifier(),
-				compareIds
-			)
+			compareSelect(m => moduleGraph.getDepth(m), compareNumbers),
+			compareSelect(m => moduleGraph.getPreOrderIndex(m), compareNumbers),
+			compareSelect(m => m.identifier(), compareIds)
 		);
 	}
 };
 
-/** @type {Record<string, Record<string, (comparators: Function[], context: StatsFactoryContext) => void>>} */
+/** @type {Record<string, Record<string, (comparators: Comparator<any>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>>} */
 const SORTERS = {
 	"compilation.chunks": {
 		_: comparators => {
@@ -1852,7 +1841,7 @@ const spaceLimited = (
 						// So it should always end up being smaller
 						const headerSize = group.filteredChildren ? 2 : 1;
 						const limited = spaceLimited(
-							/** @type {Children<T>} */ (group.children),
+							/** @type {Children<T>[]} */ (group.children),
 							maxGroupSize -
 								// we should use ceil to always feet in max
 								Math.ceil(oversize / groups.length) -
@@ -1924,7 +1913,9 @@ const errorsSpaceLimit = (errors, max) => {
 				const error = errors[i++];
 				result.push({
 					...error,
-					details: error.details.split("\n").slice(0, -overLimit).join("\n"),
+					details:
+						/** @type {string} */
+						(error.details).split("\n").slice(0, -overLimit).join("\n"),
 					filteredDetails: overLimit
 				});
 				filtered = errors.length - i;
@@ -2150,7 +2141,7 @@ const ASSETS_GROUPERS = {
 
 /** @typedef {Record<string, (groupConfigs: GroupConfig<KnownStatsModule, TODO>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>} ModulesGroupers */
 
-/** @type {function("module" | "chunk" | "root-of-chunk" | "nested"): ModulesGroupers} */
+/** @type {(type: "module" | "chunk" | "root-of-chunk" | "nested") => ModulesGroupers} */
 const MODULES_GROUPERS = type => ({
 	_: (groupConfigs, context, options) => {
 		/**
@@ -2312,7 +2303,7 @@ const MODULES_GROUPERS = type => ({
 	}
 });
 
-/** @typedef {Record<string, (groupConfigs: import("../util/smartGrouping").GroupConfig<KnownStatsModuleReason, TODO>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>} ModuleReasonsGroupers */
+/** @typedef {Record<string, (groupConfigs: GroupConfig<KnownStatsModuleReason, TODO>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>} ModuleReasonsGroupers */
 
 /** @type {ModuleReasonsGroupers} */
 const MODULE_REASONS_GROUPERS = {
@@ -2366,15 +2357,15 @@ const sortOrderRegular = field => {
 
 /**
  * @template T
- * @param {string} field field name
- * @returns {function(T, T): 0 | 1 | -1} comparators
+ * @param {string | false} field field name
+ * @returns {(a: T, b: T) => 0 | 1 | -1} comparators
  */
 const sortByField = field => {
 	if (!field) {
 		/**
-		 * @param {any} a first
-		 * @param {any} b second
-		 * @returns {-1|0|1} zero
+		 * @param {T} a first
+		 * @param {T} b second
+		 * @returns {-1 | 0 | 1} zero
 		 */
 		const noSort = (a, b) => 0;
 		return noSort;
@@ -2432,9 +2423,10 @@ const RESULT_SORTERS = {
 };
 
 /**
- * @param {Record<string, Record<string, Function>>} config the config see above
+ * @template T
+ * @param {Record<string, Record<string, T>>} config the config see above
  * @param {NormalizedStatsOptions} options stats options
- * @param {function(string, Function): void} fn handler function called for every active line in config
+ * @param {(hookFor: string, fn: T) => void} fn handler function called for every active line in config
  * @returns {void}
  */
 const iterateConfig = (config, options, fn) => {
@@ -2523,13 +2515,18 @@ class DefaultStatsFactoryPlugin {
 				 * @param {NormalizedStatsOptions} options stats options
 				 */
 				(stats, options) => {
-					iterateConfig(SIMPLE_EXTRACTORS, options, (hookFor, fn) => {
-						stats.hooks.extract
-							.for(hookFor)
-							.tap("DefaultStatsFactoryPlugin", (obj, data, ctx) =>
-								fn(obj, data, ctx, options, stats)
-							);
-					});
+					iterateConfig(
+						/** @type {TODO} */
+						(SIMPLE_EXTRACTORS),
+						options,
+						(hookFor, fn) => {
+							stats.hooks.extract
+								.for(hookFor)
+								.tap("DefaultStatsFactoryPlugin", (obj, data, ctx) =>
+									fn(obj, data, ctx, options, stats)
+								);
+						}
+					);
 					iterateConfig(FILTER, options, (hookFor, fn) => {
 						stats.hooks.filter
 							.for(hookFor)
@@ -2558,13 +2555,18 @@ class DefaultStatsFactoryPlugin {
 								fn(comparators, ctx, options)
 							);
 					});
-					iterateConfig(RESULT_GROUPERS, options, (hookFor, fn) => {
-						stats.hooks.groupResults
-							.for(hookFor)
-							.tap("DefaultStatsFactoryPlugin", (groupConfigs, ctx) =>
-								fn(groupConfigs, ctx, options)
-							);
-					});
+					iterateConfig(
+						/** @type {TODO} */
+						(RESULT_GROUPERS),
+						options,
+						(hookFor, fn) => {
+							stats.hooks.groupResults
+								.for(hookFor)
+								.tap("DefaultStatsFactoryPlugin", (groupConfigs, ctx) =>
+									fn(groupConfigs, ctx, options)
+								);
+						}
+					);
 					for (const key of Object.keys(ITEM_NAMES)) {
 						const itemName = ITEM_NAMES[key];
 						stats.hooks.getItemName

package/lib/stats/DefaultStatsPresetPlugin.js

@@ -8,26 +8,30 @@
 const RequestShortener = require("../RequestShortener");
 
 /** @typedef {import("../../declarations/WebpackOptions").StatsOptions} StatsOptions */
+/** @typedef {import("../../declarations/WebpackOptions").StatsValue} StatsValue */
 /** @typedef {import("../Compilation")} Compilation */
 /** @typedef {import("../Compilation").CreateStatsOptionsContext} CreateStatsOptionsContext */
+/** @typedef {import("../Compilation").KnownNormalizedStatsOptions} KnownNormalizedStatsOptions */
+/** @typedef {import("../Compilation").NormalizedStatsOptions} NormalizedStatsOptions */
 /** @typedef {import("../Compiler")} Compiler */
 /** @typedef {import("./DefaultStatsFactoryPlugin").StatsError} StatsError */
 
 /**
- * @param {StatsOptions} options options
+ * @param {Partial<NormalizedStatsOptions>} options options
  * @param {StatsOptions} defaults default options
  */
 const applyDefaults = (options, defaults) => {
 	for (const _k of Object.keys(defaults)) {
 		const key = /** @type {keyof StatsOptions} */ (_k);
 		if (typeof options[key] === "undefined") {
-			/** @type {TODO} */
-			(options)[key] = defaults[key];
+			options[/** @type {keyof NormalizedStatsOptions} */ (key)] =
+				defaults[key];
 		}
 	}
 };
 
-/** @typedef {Record<string, StatsOptions>} NamedPresets */
+/** @typedef {{ [Key in Exclude<StatsValue, boolean | object | "normal">]: StatsOptions }} NamedPresets */
+
 /** @type {NamedPresets} */
 const NAMED_PRESETS = {
 	verbose: {
@@ -136,31 +140,31 @@ const NAMED_PRESETS = {
 };
 
 /**
- * @param {StatsOptions} all stats option
+ * @param {Partial<NormalizedStatsOptions>} all stats option
  * @returns {boolean} true when enabled, otherwise false
  */
 const NORMAL_ON = ({ all }) => all !== false;
 /**
- * @param {StatsOptions} all stats option
+ * @param {Partial<NormalizedStatsOptions>} all stats option
  * @returns {boolean} true when enabled, otherwise false
  */
 const NORMAL_OFF = ({ all }) => all === true;
 /**
- * @param {StatsOptions} all stats option
+ * @param {Partial<NormalizedStatsOptions>} all stats option
  * @param {CreateStatsOptionsContext} forToString stats options context
  * @returns {boolean} true when enabled, otherwise false
  */
 const ON_FOR_TO_STRING = ({ all }, { forToString }) =>
 	forToString ? all !== false : all === true;
 /**
- * @param {StatsOptions} all stats option
+ * @param {Partial<NormalizedStatsOptions>} all stats option
  * @param {CreateStatsOptionsContext} forToString stats options context
  * @returns {boolean} true when enabled, otherwise false
  */
 const OFF_FOR_TO_STRING = ({ all }, { forToString }) =>
 	forToString ? all === true : all !== false;
 /**
- * @param {StatsOptions} all stats option
+ * @param {Partial<NormalizedStatsOptions>} all stats option
  * @param {CreateStatsOptionsContext} forToString stats options context
  * @returns {boolean | "auto"} true when enabled, otherwise false
  */
@@ -171,9 +175,10 @@ const AUTO_FOR_TO_STRING = ({ all }, { forToString }) => {
 	return true;
 };
 
-/** @typedef {Record<string, (options: StatsOptions, context: CreateStatsOptionsContext, compilation: Compilation) => StatsOptions[keyof StatsOptions] | RequestShortener>} Defaults */
+/** @typedef {keyof NormalizedStatsOptions} DefaultsKeys */
+/** @typedef {{ [Key in DefaultsKeys]: (options: Partial<NormalizedStatsOptions>, context: CreateStatsOptionsContext, compilation: Compilation) => NormalizedStatsOptions[Key] | RequestShortener }} Defaults */
 
-/** @type {Defaults} */
+/** @type {Partial<Defaults>} */
 const DEFAULTS = {
 	context: (options, context, compilation) => compilation.compiler.context,
 	requestShortener: (options, context, compilation) =>
@@ -274,32 +279,37 @@ const DEFAULTS = {
 };
 
 /**
- * @param {string | ({ test: function(string): boolean }) | (function(string): boolean) | boolean} item item to normalize
- * @returns {(function(string): boolean) | undefined} normalize fn
+ * @template {string} T
+ * @param {string | ({ test: (value: T) => boolean }) | ((value: T, ...args: EXPECTED_ANY[]) => boolean) | boolean} item item to normalize
+ * @returns {(value: T, ...args: EXPECTED_ANY[]) => boolean} normalize fn
  */
 const normalizeFilter = item => {
 	if (typeof item === "string") {
 		const regExp = new RegExp(
 			`[\\\\/]${item.replace(/[-[\]{}()*+?.\\^$|]/g, "\\$&")}([\\\\/]|$|!|\\?)`
 		);
-		return ident => regExp.test(ident);
+		return ident => regExp.test(/** @type {T} */ (ident));
 	}
 	if (item && typeof item === "object" && typeof item.test === "function") {
 		return ident => item.test(ident);
 	}
-	if (typeof item === "function") {
-		return item;
-	}
 	if (typeof item === "boolean") {
 		return () => item;
 	}
+
+	return /** @type {(value: T, ...args: EXPECTED_ANY[]) => boolean} */ (item);
 };
 
-/** @type {Record<string, function(any): any[]>} */
+/** @typedef {keyof (KnownNormalizedStatsOptions | StatsOptions)} NormalizerKeys */
+/** @typedef {{ [Key in NormalizerKeys]: (value: StatsOptions[Key]) => KnownNormalizedStatsOptions[Key] }} Normalizers */
+
+/** @type {Partial<Normalizers>} */
 const NORMALIZER = {
 	excludeModules: value => {
 		if (!Array.isArray(value)) {
-			value = value ? [value] : [];
+			value = value
+				? /** @type {KnownNormalizedStatsOptions["excludeModules"]} */ ([value])
+				: [];
 		}
 		return value.map(normalizeFilter);
 	},
@@ -342,11 +352,13 @@ const NORMALIZER = {
 	},
 	logging: value => {
 		if (value === true) value = "log";
-		return value;
+		return /** @type {KnownNormalizedStatsOptions["logging"]} */ (value);
 	},
 	loggingDebug: value => {
 		if (!Array.isArray(value)) {
-			value = value ? [value] : [];
+			value = value
+				? /** @type {KnownNormalizedStatsOptions["loggingDebug"]} */ ([value])
+				: [];
 		}
 		return value.map(normalizeFilter);
 	}
@@ -373,10 +385,18 @@ class DefaultStatsPresetPlugin {
 				(options, context) => {
 					for (const key of Object.keys(DEFAULTS)) {
 						if (options[key] === undefined)
-							options[key] = DEFAULTS[key](options, context, compilation);
+							options[key] =
+								/** @type {Defaults[DefaultsKeys]} */
+								(DEFAULTS[/** @type {DefaultsKeys} */ (key)])(
+									options,
+									context,
+									compilation
+								);
 					}
 					for (const key of Object.keys(NORMALIZER)) {
-						options[key] = NORMALIZER[key](options[key]);
+						options[key] =
+							/** @type {TODO} */
+							(NORMALIZER[/** @type {NormalizerKeys} */ (key)])(options[key]);
 					}
 				}
 			);