@depup/webpack 5.106.0-depup.0 → 5.109.0-depup.0

package/lib/stats/DefaultStatsFactoryPlugin.js

@@ -6,9 +6,9 @@
 "use strict";
 
 const util = require("util");
+const { version: WEBPACK_VERSION } = require("../../package.json");
 const { WEBPACK_MODULE_TYPE_RUNTIME } = require("../ModuleTypeConstants");
 const ModuleDependency = require("../dependencies/ModuleDependency");
-const formatLocation = require("../formatLocation");
 const { LogType } = require("../logging/Logger");
 const AggressiveSplittingPlugin = require("../optimize/AggressiveSplittingPlugin");
 const SizeLimitsPlugin = require("../performance/SizeLimitsPlugin");
@@ -22,6 +22,7 @@ const {
 	compareSelect,
 	concatComparators
 } = require("../util/comparators");
+const formatLocation = require("../util/formatLocation");
 const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {import("webpack-sources").Source} Source */
@@ -48,23 +49,26 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {import("../Module").BuildInfo} BuildInfo */
 /** @typedef {import("../ModuleGraphConnection")} ModuleGraphConnection */
 /** @typedef {import("../ModuleProfile")} ModuleProfile */
-/** @typedef {import("../WebpackError")} WebpackError */
+/** @typedef {import("../errors/WebpackError")} WebpackError */
 /** @typedef {import("../serialization/AggregateErrorSerializer").AggregateError} AggregateError */
 /** @typedef {import("../serialization/ErrorObjectSerializer").ErrorWithCause} ErrorWithCause */
 /** @typedef {import("../ExportsInfo").ExportInfoName} ExportInfoName */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("../util/comparators").Comparator<T>} Comparator<T>
  */
 
 /**
+ * Defines the group config type used by this module.
  * @template I, G
  * @typedef {import("../util/smartGrouping").GroupConfig<I, G>} GroupConfig
  */
 
 /** @typedef {KnownStatsCompilation & Record<string, EXPECTED_ANY>} StatsCompilation */
 /**
+ * Defines the known stats compilation type used by this module.
  * @typedef {object} KnownStatsCompilation
  * @property {EXPECTED_ANY=} env
  * @property {string=} name
@@ -95,6 +99,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsLogging & Record<string, EXPECTED_ANY>} StatsLogging */
 /**
+ * Defines the known stats logging type used by this module.
  * @typedef {object} KnownStatsLogging
  * @property {StatsLoggingEntry[]} entries
  * @property {number} filteredEntries
@@ -103,6 +108,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsLoggingEntry & Record<string, EXPECTED_ANY>} StatsLoggingEntry */
 /**
+ * Defines the known stats logging entry type used by this module.
  * @typedef {object} KnownStatsLoggingEntry
  * @property {string} type
  * @property {string=} message
@@ -115,6 +121,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {KnownStatsAsset & Record<string, EXPECTED_ANY>} StatsAsset */
 /** @typedef {string[]} ChunkIdHints */
 /**
+ * Defines the known stats asset type used by this module.
  * @typedef {object} KnownStatsAsset
  * @property {string} type
  * @property {string} name
@@ -136,6 +143,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsChunkGroup & Record<string, EXPECTED_ANY>} StatsChunkGroup */
 /**
+ * Defines the known stats chunk group type used by this module.
  * @typedef {object} KnownStatsChunkGroup
  * @property {ChunkName=} name
  * @property {ChunkId[]=} chunks
@@ -153,6 +161,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {Module[]} ModuleIssuerPath */
 /** @typedef {KnownStatsModule & Record<string, EXPECTED_ANY>} StatsModule */
 /**
+ * Defines the known stats module type used by this module.
  * @typedef {object} KnownStatsModule
  * @property {string=} type
  * @property {string=} moduleType
@@ -167,6 +176,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {number=} size
  * @property {Record<string, number>=} sizes
  * @property {boolean=} cacheable
+ * @property {string[]=} notCacheableReasons
  * @property {boolean=} built
  * @property {boolean=} codeGenerated
  * @property {boolean=} buildTimeExecuted
@@ -197,6 +207,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsProfile & Record<string, EXPECTED_ANY>} StatsProfile */
 /**
+ * Defines the known stats profile type used by this module.
  * @typedef {object} KnownStatsProfile
  * @property {number} total
  * @property {number} resolving
@@ -212,6 +223,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsModuleIssuer & Record<string, EXPECTED_ANY>} StatsModuleIssuer */
 /**
+ * Defines the known stats module issuer type used by this module.
  * @typedef {object} KnownStatsModuleIssuer
  * @property {string} identifier
  * @property {string} name
@@ -221,6 +233,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsModuleReason & Record<string, EXPECTED_ANY>} StatsModuleReason */
 /**
+ * Defines the known stats module reason type used by this module.
  * @typedef {object} KnownStatsModuleReason
  * @property {string | null} moduleIdentifier
  * @property {string | null} module
@@ -238,6 +251,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsChunk & Record<string, EXPECTED_ANY>} StatsChunk */
 /**
+ * Defines the known stats chunk type used by this module.
  * @typedef {object} KnownStatsChunk
  * @property {boolean} rendered
  * @property {boolean} initial
@@ -264,6 +278,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsChunkOrigin & Record<string, EXPECTED_ANY>} StatsChunkOrigin */
 /**
+ * Defines the known stats chunk origin type used by this module.
  * @typedef {object} KnownStatsChunkOrigin
  * @property {string} module
  * @property {string} moduleIdentifier
@@ -275,6 +290,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsModuleTraceItem & Record<string, EXPECTED_ANY>} StatsModuleTraceItem */
 /**
+ * Defines the known stats module trace item type used by this module.
  * @typedef {object} KnownStatsModuleTraceItem
  * @property {string=} originIdentifier
  * @property {string=} originName
@@ -287,12 +303,14 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 
 /** @typedef {KnownStatsModuleTraceDependency & Record<string, EXPECTED_ANY>} 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 */
 /**
+ * Defines the known stats error type used by this module.
  * @typedef {object} KnownStatsError
  * @property {string} message
  * @property {string=} chunkName
@@ -315,6 +333,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {Asset & { type: string, related: PreprocessedAsset[] | undefined }} PreprocessedAsset */
 
 /**
+ * Defines the extractors by option type used by this module.
  * @template T
  * @template O
  * @typedef {Record<string, (object: O, data: T, context: StatsFactoryContext, options: NormalizedStatsOptions, factory: StatsFactory) => void>} ExtractorsByOption
@@ -324,6 +343,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {{ origin: Module, module: Module }} ModuleTrace */
 
 /**
+ * Defines the simple extractors type used by this module.
  * @typedef {object} SimpleExtractors
  * @property {ExtractorsByOption<Compilation, StatsCompilation>} compilation
  * @property {ExtractorsByOption<PreprocessedAsset, StatsAsset>} asset
@@ -344,6 +364,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  */
 
 /**
+ * Returns array of values.
  * @template T
  * @template I
  * @param {Iterable<T>} items items to select from
@@ -362,6 +383,7 @@ const uniqueArray = (items, selector) => {
 };
 
 /**
+ * Unique ordered array.
  * @template T
  * @template I
  * @param {Iterable<T>} items items to select from
@@ -373,12 +395,14 @@ const uniqueOrderedArray = (items, selector, comparator) =>
 	uniqueArray(items, selector).sort(comparator);
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @template R
  * @typedef {{ [P in keyof T]: R }} MappedValues<T, R>
  */
 
 /**
+ * Returns mapped object.
  * @template {object} T
  * @template {object} R
  * @param {T} obj object to be mapped
@@ -395,9 +419,9 @@ const mapObject = (obj, fn) => {
 };
 
 /**
- * @template T
+ * Count with children.
  * @param {Compilation} compilation the compilation
- * @param {(compilation: Compilation, name: string) => T[]} getItems get items
+ * @param {(compilation: Compilation, name: string) => { length: number }} getItems get items
  * @returns {number} total number
  */
 const countWithChildren = (compilation, getItems) => {
@@ -730,7 +754,7 @@ const SIMPLE_EXTRACTORS = {
 			object.hash = compilation.hash;
 		},
 		version: (object) => {
-			object.version = require("../../package.json").version;
+			object.version = WEBPACK_VERSION;
 		},
 		env: (object, compilation, context, { _env }) => {
 			object.env = _env;
@@ -987,17 +1011,16 @@ const SIMPLE_EXTRACTORS = {
 			const { type, cachedGetWarnings } = context;
 			object.warningsCount = countWithChildren(compilation, (c, childType) => {
 				if (
-					!warningsFilter &&
 					/** @type {KnownNormalizedStatsOptions["warningsFilter"]} */
 					(warningsFilter).length === 0
 				) {
-					// Type is wrong, because we don't need the real value for counting
-					return /** @type {EXPECTED_ANY[]} */ (cachedGetWarnings(c));
+					return cachedGetWarnings(c);
 				}
 				return factory
 					.create(`${type}${childType}.warnings`, cachedGetWarnings(c), context)
 					.filter(
 						/**
+						 * Handles the warnings count callback for this hook.
 						 * @param {StatsError} warning warning
 						 * @returns {boolean} result
 						 */
@@ -1122,6 +1145,7 @@ const SIMPLE_EXTRACTORS = {
 				chunkGroupChildren &&
 				chunkGroup.getChildrenByOrders(moduleGraph, chunkGraph);
 			/**
+			 * Returns } Asset object.
 			 * @param {string} name Name
 			 * @returns {{ name: string, size: number }} Asset object
 			 */
@@ -1221,6 +1245,25 @@ const SIMPLE_EXTRACTORS = {
 		},
 		performance: (object, { chunkGroup }) => {
 			object.isOverSizeLimit = SizeLimitsPlugin.isOverSizeLimit(chunkGroup);
+		},
+		chunkGroupResourceHints: (
+			object,
+			{ name, chunkGroup },
+			{ compilation }
+		) => {
+			// SSR frameworks consume this to inject the initial-chunk +
+			// URL-asset `<link>` tags into their server-rendered HTML without
+			// having to walk the chunk graph themselves. Only entrypoints
+			// carry hints; split-chunk / async chunk groups are skipped.
+			if (!compilation.entrypoints.get(name)) return;
+
+			const ResourceHintPlugin = require("../prefetch/ResourceHintPlugin");
+
+			const hints =
+				ResourceHintPlugin.getCompilationResolver(
+					compilation
+				).getEntrypointHints(name);
+			if (hints.length > 0) object.resourceHints = hints;
 		}
 	},
 	module: {
@@ -1277,6 +1320,9 @@ const SIMPLE_EXTRACTORS = {
 			const warnings = module.getWarnings();
 			const warningsCount =
 				warnings !== undefined ? countIterable(warnings) : 0;
+			const { cacheable, notCacheableReasons } = /** @type {BuildInfo} */ (
+				module.buildInfo
+			);
 			/** @type {KnownStatsModule} */
 			const statsModule = {
 				identifier: module.identifier(),
@@ -1290,7 +1336,13 @@ const SIMPLE_EXTRACTORS = {
 				postOrderIndex: /** @type {number} */ (
 					moduleGraph.getPostOrderIndex(module)
 				),
-				cacheable: /** @type {BuildInfo} */ (module.buildInfo).cacheable,
+				cacheable,
+				notCacheableReasons:
+					notCacheableReasons &&
+					notCacheableReasons.map(
+						(request) =>
+							/** @type {string} */ (requestShortener.shorten(request))
+					),
 				optional: module.isOptional(moduleGraph),
 				orphan:
 					!type.endsWith("module.modules[].module$visible") &&
@@ -1743,6 +1795,7 @@ const SORTERS = {
 					concatComparators(
 						compareSelect(
 							/**
+							 * Handles the  callback for this hook.
 							 * @param {Dependency} x dependency
 							 * @returns {DependencyLocation} location
 							 */
@@ -1771,11 +1824,13 @@ const SORTERS = {
 };
 
 /**
+ * Defines the children type used by this module.
  * @template T
  * @typedef {T & { children?: Children<T>[] | undefined, filteredChildren?: number }} Children
  */
 
 /**
+ * Returns item size.
  * @template T
  * @param {Children<T>} item item
  * @returns {number} item size
@@ -1791,6 +1846,7 @@ const getItemSize = (item) =>
 			: 1 + getTotalSize(item.children);
 
 /**
+ * Returns total size.
  * @template T
  * @param {Children<T>[]} children children
  * @returns {number} total size
@@ -1804,6 +1860,7 @@ const getTotalSize = (children) => {
 };
 
 /**
+ * Returns total items.
  * @template T
  * @param {Children<T>[]} children children
  * @returns {number} total items
@@ -1822,6 +1879,7 @@ const getTotalItems = (children) => {
 };
 
 /**
+ * Returns collapsed children.
  * @template T
  * @param {Children<T>[]} children children
  * @returns {Children<T>[]} collapsed children
@@ -1847,6 +1905,7 @@ const collapse = (children) => {
 };
 
 /**
+ * Returns result.
  * @template T
  * @param {Children<T>[]} itemsAndGroups item and groups
  * @param {number} max max
@@ -1976,6 +2035,7 @@ const spaceLimited = (
 };
 
 /**
+ * Errors space limit.
  * @param {StatsError[]} errors errors
  * @param {number} max max
  * @returns {[StatsError[], number]} error space limit
@@ -2019,7 +2079,7 @@ const errorsSpaceLimit = (errors, max) => {
 				for (; i < errors.length; i++) {
 					const error = errors[i];
 					if (typeof error === "string" || !error.details) result.push(error);
-					result.push({ ...error, details: "" });
+					else result.push({ ...error, details: "" });
 				}
 				break;
 			} else if (fullLength === max) {
@@ -2028,7 +2088,7 @@ const errorsSpaceLimit = (errors, max) => {
 				for (; i < errors.length; i++) {
 					const error = errors[i];
 					if (typeof error === "string" || !error.details) result.push(error);
-					result.push({ ...error, details: "" });
+					else result.push({ ...error, details: "" });
 				}
 				break;
 			}
@@ -2039,6 +2099,7 @@ const errorsSpaceLimit = (errors, max) => {
 };
 
 /**
+ * Returns } asset size.
  * @template {{ size: number }} T
  * @param {T[]} children children
  * @param {T[]} assets assets
@@ -2055,6 +2116,7 @@ const assetGroup = (children, assets) => {
 /** @typedef {{ size: number, sizes: Record<string, number> }} ModuleGroupBySizeResult */
 
 /**
+ * Returns size and sizes.
  * @template {ModuleGroupBySizeResult} T
  * @param {Children<T>[]} children children
  * @param {KnownStatsModule[]} modules modules
@@ -2077,6 +2139,7 @@ const moduleGroup = (children, modules) => {
 };
 
 /**
+ * Returns } reason group.
  * @template {{ active: boolean }} T
  * @param {Children<T>[]} children children
  * @param {KnownStatsModuleReason[]} reasons reasons
@@ -2098,6 +2161,7 @@ const GROUP_PATH_REGEXP = /(.+)[/\\][^/\\]+?(?:\?|(?: \+ \d+ modules?)?$)/;
 /** @typedef {{ type: string }} BaseGroup */
 
 /**
+ * Defines the base group with children type used by this module.
  * @template T
  * @typedef {BaseGroup & { children: T[], size: number }} BaseGroupWithChildren
  */
@@ -2105,6 +2169,7 @@ const GROUP_PATH_REGEXP = /(.+)[/\\][^/\\]+?(?:\?|(?: \+ \d+ modules?)?$)/;
 /** @typedef {(name: string, asset: StatsAsset) => boolean} AssetFilterItemFn */
 
 /**
+ * Describes the assets groupers shape.
  * @typedef {{
  * _: (groupConfigs: GroupConfig<KnownStatsAsset, BaseGroup & { filteredChildren: number, size: number } | BaseGroupWithChildren<KnownStatsAsset>>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void,
  * groupAssetsByInfo: (groupConfigs: GroupConfig<KnownStatsAsset, BaseGroupWithChildren<KnownStatsAsset>>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void,
@@ -2117,6 +2182,7 @@ const GROUP_PATH_REGEXP = /(.+)[/\\][^/\\]+?(?:\?|(?: \+ \d+ modules?)?$)/;
 const ASSETS_GROUPERS = {
 	_: (groupConfigs, context, options) => {
 		/**
+		 * Processes the provided name.
 		 * @param {keyof KnownStatsAsset} name name
 		 * @param {boolean=} exclude need exclude?
 		 */
@@ -2196,6 +2262,7 @@ const ASSETS_GROUPERS = {
 	},
 	groupAssetsByInfo: (groupConfigs, _context, _options) => {
 		/**
+		 * Group by asset info flag.
 		 * @param {string} name name
 		 */
 		const groupByAssetInfoFlag = (name) => {
@@ -2218,6 +2285,7 @@ const ASSETS_GROUPERS = {
 	},
 	groupAssetsByChunk: (groupConfigs, _context, _options) => {
 		/**
+		 * Processes the provided name.
 		 * @param {keyof KnownStatsAsset} name name
 		 */
 		const groupByNames = (name) => {
@@ -2257,6 +2325,7 @@ const ASSETS_GROUPERS = {
 };
 
 /**
+ * Describes the modules groupers shape.
  * @typedef {{
  * _: (groupConfigs: GroupConfig<KnownStatsModule, BaseGroup & { filteredChildren?: number, children?: KnownStatsModule[], size: number, sizes: Record<string, number> }>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void,
  * excludeModules: (groupConfigs: GroupConfig<KnownStatsModule, BaseGroup & { filteredChildren: number, size: number, sizes: Record<string, number> }>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void,
@@ -2271,6 +2340,7 @@ const ASSETS_GROUPERS = {
 const MODULES_GROUPERS = (type) => ({
 	_: (groupConfigs, context, options) => {
 		/**
+		 * Processes the provided name.
 		 * @param {keyof KnownStatsModule} name name
 		 * @param {string} type type
 		 * @param {boolean=} exclude need exclude?
@@ -2452,6 +2522,7 @@ const MODULES_GROUPERS = (type) => ({
 });
 
 /**
+ * Defines the module reasons groupers type used by this module.
  * @typedef {{ groupReasonsByOrigin: (groupConfigs: GroupConfig<KnownStatsModuleReason, BaseGroup & { module: string, children: KnownStatsModuleReason[], active: boolean }>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void }} ModuleReasonsGroupers
  */
 
@@ -2493,6 +2564,7 @@ const RESULT_GROUPERS = {
 
 // remove a prefixed "!" that can be specified to reverse sort order
 /**
+ * Normalizes field key.
  * @param {string} field a field name
  * @returns {field} normalized field
  */
@@ -2505,6 +2577,7 @@ const normalizeFieldKey = (field) => {
 
 // if a field is prefixed by a "!" reverse sort order
 /**
+ * Sorts order regular.
  * @param {string} field a field name
  * @returns {boolean} result
  */
@@ -2516,6 +2589,7 @@ const sortOrderRegular = (field) => {
 };
 
 /**
+ * Returns comparators.
  * @template T
  * @param {string | false} field field name
  * @returns {(a: T, b: T) => 0 | 1 | -1} comparators
@@ -2523,6 +2597,7 @@ const sortOrderRegular = (field) => {
 const sortByField = (field) => {
 	if (!field) {
 		/**
+		 * Returns zero.
 		 * @param {T} a first
 		 * @param {T} b second
 		 * @returns {-1 | 0 | 1} zero
@@ -2547,6 +2622,7 @@ const sortByField = (field) => {
 };
 
 /**
+ * Describes the asset sorters shape.
  * @typedef {{
  * assetsSort: (comparators: Comparator<Asset>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void,
  * _: (comparators: Comparator<Asset>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void,
@@ -2599,11 +2675,13 @@ const RESULT_SORTERS = {
 };
 
 /**
+ * Defines the extract function type used by this module.
  * @template T
  * @typedef {T extends Record<string, Record<string, infer F>> ? F : never} ExtractFunction
  */
 
 /**
+ * Processes the provided config.
  * @template {Record<string, Record<string, EXPECTED_ANY>>} T
  * @param {T} config the config see above
  * @param {NormalizedStatsOptions} options stats options
@@ -2658,11 +2736,13 @@ const ITEM_NAMES = {
 };
 
 /**
+ * Defines the named object type used by this module.
  * @template T
  * @typedef {{ name: T }} NamedObject
  */
 
 /**
+ * Merges the provided values into a single result.
  * @template {{ name: string }} T
  * @param {T[]} items items to be merged
  * @returns {NamedObject<T>} an object
@@ -2688,7 +2768,7 @@ const PLUGIN_NAME = "DefaultStatsFactoryPlugin";
 
 class DefaultStatsFactoryPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -2697,6 +2777,7 @@ class DefaultStatsFactoryPlugin {
 			compilation.hooks.statsFactory.tap(
 				PLUGIN_NAME,
 				/**
+				 * Handles the callback logic for this hook.
 				 * @param {StatsFactory} stats stats factory
 				 * @param {NormalizedStatsOptions} options stats options
 				 */
@@ -2758,6 +2839,7 @@ class DefaultStatsFactoryPlugin {
 								.tap(
 									PLUGIN_NAME,
 									/**
+									 * Handles the callback logic for this hook.
 									 * @param {Compilation} comp compilation
 									 * @param {StatsFactoryContext} options options
 									 * @returns {StatsFactory | undefined} stats factory

package/lib/stats/DefaultStatsPresetPlugin.js

@@ -17,6 +17,7 @@ const RequestShortener = require("../RequestShortener");
 /** @typedef {import("./DefaultStatsFactoryPlugin").StatsError} StatsError */
 
 /**
+ * Processes the provided normalized stats option.
  * @param {Partial<NormalizedStatsOptions>} options options
  * @param {StatsOptions} defaults default options
  */
@@ -30,7 +31,7 @@ const applyDefaults = (options, defaults) => {
 	}
 };
 
-/** @typedef {{ [Key in Exclude<StatsValue, boolean | EXPECTED_OBJECT | "normal">]: StatsOptions }} NamedPresets */
+/** @typedef {{ [Key in Exclude<StatsValue, boolean | StatsOptions | "normal">]: StatsOptions }} NamedPresets */
 
 /** @type {NamedPresets} */
 const NAMED_PRESETS = {
@@ -40,6 +41,7 @@ const NAMED_PRESETS = {
 		relatedAssets: true,
 		entrypoints: true,
 		chunkGroups: true,
+		chunkGroupResourceHints: true,
 		ids: true,
 		modules: false,
 		chunks: true,
@@ -144,16 +146,19 @@ const NAMED_PRESETS = {
 };
 
 /**
+ * Returns true when enabled, otherwise false.
  * @param {Partial<NormalizedStatsOptions>} all stats options
  * @returns {boolean} true when enabled, otherwise false
  */
 const NORMAL_ON = ({ all }) => all !== false;
 /**
+ * Returns true when enabled, otherwise false.
  * @param {Partial<NormalizedStatsOptions>} all stats options
  * @returns {boolean} true when enabled, otherwise false
  */
 const NORMAL_OFF = ({ all }) => all === true;
 /**
+ * Returns true when enabled, otherwise false.
  * @param {Partial<NormalizedStatsOptions>} all stats options
  * @param {CreateStatsOptionsContext} forToString stats options context
  * @returns {boolean} true when enabled, otherwise false
@@ -161,6 +166,7 @@ const NORMAL_OFF = ({ all }) => all === true;
 const ON_FOR_TO_STRING = ({ all }, { forToString }) =>
 	forToString ? all !== false : all === true;
 /**
+ * Returns true when enabled, otherwise false.
  * @param {Partial<NormalizedStatsOptions>} all stats options
  * @param {CreateStatsOptionsContext} forToString stats options context
  * @returns {boolean} true when enabled, otherwise false
@@ -168,6 +174,7 @@ const ON_FOR_TO_STRING = ({ all }, { forToString }) =>
 const OFF_FOR_TO_STRING = ({ all }, { forToString }) =>
 	forToString ? all === true : all !== false;
 /**
+ * Auto for to string.
  * @param {Partial<NormalizedStatsOptions>} all stats options
  * @param {CreateStatsOptionsContext} forToString stats options context
  * @returns {boolean | "auto"} true when enabled, otherwise false
@@ -204,6 +211,7 @@ const DEFAULTS = {
 	chunkGroups: OFF_FOR_TO_STRING,
 	chunkGroupAuxiliary: OFF_FOR_TO_STRING,
 	chunkGroupChildren: OFF_FOR_TO_STRING,
+	chunkGroupResourceHints: OFF_FOR_TO_STRING,
 	chunkGroupMaxAssets: (o, { forToString }) => (forToString ? 5 : Infinity),
 	chunks: OFF_FOR_TO_STRING,
 	chunkRelations: OFF_FOR_TO_STRING,
@@ -285,11 +293,13 @@ const DEFAULTS = {
 };
 
 /**
+ * Defines the normalize function type used by this module.
  * @template T
  * @typedef {(value: T, ...args: EXPECTED_ANY[]) => boolean} NormalizeFunction
  */
 
 /**
+ * Returns normalize fn.
  * @template {string} T
  * @param {string | ({ test: (value: T) => boolean }) | NormalizeFunction<T> | boolean} item item to normalize
  * @returns {NormalizeFunction<T>} normalize fn
@@ -315,6 +325,7 @@ const normalizeFilter = (item) => {
 /** @typedef {{ [Key in NormalizerKeys]?: (value: StatsOptions[Key]) => KnownNormalizedStatsOptions[Key] }} Normalizers */
 
 /**
+ * Defines the warning filter fn callback.
  * @callback WarningFilterFn
  * @param {StatsError} warning warning
  * @param {string} warningString warning string
@@ -343,6 +354,7 @@ const NORMALIZER = {
 		}
 		return value.map(
 			/**
+			 * Handles the warnings filter callback for this hook.
 			 * @param {StatsOptions["warningsFilter"]} filter a warning filter
 			 * @returns {WarningFilterFn} result
 			 */
@@ -380,7 +392,7 @@ const PLUGIN_NAME = "DefaultStatsPresetPlugin";
 
 class DefaultStatsPresetPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */