webpack 5.99.4 → 5.99.6

package/lib/stats/DefaultStatsFactoryPlugin.js

@@ -27,12 +27,14 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("../Chunk")} Chunk */
 /** @typedef {import("../Chunk").ChunkId} ChunkId */
+/** @typedef {import("../Chunk").ChunkName} ChunkName */
 /** @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").ExcludeModulesType} ExcludeModulesType */
 /** @typedef {import("../Compilation").KnownNormalizedStatsOptions} KnownNormalizedStatsOptions */
 /** @typedef {import("../Compilation").NormalizedStatsOptions} NormalizedStatsOptions */
 /** @typedef {import("../Compiler")} Compiler */
@@ -62,7 +64,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
 /** @typedef {KnownStatsCompilation & Record<string, EXPECTED_ANY>} StatsCompilation */
 /**
  * @typedef {object} KnownStatsCompilation
- * @property {any=} env
+ * @property {Record<string, EXPECTED_ANY>=} env
  * @property {string=} name
  * @property {string=} hash
  * @property {string=} version
@@ -85,6 +87,8 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {number=} warningsCount
  * @property {StatsCompilation[]=} children
  * @property {Record<string, StatsLogging>=} logging
+ * @property {number=} filteredWarningDetailsCount
+ * @property {number=} filteredErrorDetailsCount
  */
 
 /** @typedef {KnownStatsLogging & Record<string, EXPECTED_ANY>} StatsLogging */
@@ -107,6 +111,9 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  */
 
 /** @typedef {KnownStatsAsset & Record<string, EXPECTED_ANY>} StatsAsset */
+/** @typedef {ChunkId} KnownStatsAssetChunk */
+/** @typedef {ChunkName} KnownStatsAssetChunkName */
+/** @typedef {string} KnownStatsAssetChunkIdHint */
 /**
  * @typedef {object} KnownStatsAsset
  * @property {string} type
@@ -117,12 +124,12 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean} comparedForEmit
  * @property {boolean} cached
  * @property {StatsAsset[]=} related
- * @property {(string|number)[]=} chunkNames
- * @property {(string|number)[]=} chunkIdHints
- * @property {(string|number)[]=} chunks
- * @property {(string|number)[]=} auxiliaryChunkNames
- * @property {(string|number)[]=} auxiliaryChunks
- * @property {(string|number)[]=} auxiliaryChunkIdHints
+ * @property {KnownStatsAssetChunk[]=} chunks
+ * @property {KnownStatsAssetChunkName[]=} chunkNames
+ * @property {KnownStatsAssetChunkIdHint[]=} chunkIdHints
+ * @property {KnownStatsAssetChunk[]=} auxiliaryChunks
+ * @property {KnownStatsAssetChunkName[]=} auxiliaryChunkNames
+ * @property {KnownStatsAssetChunkIdHint[]=} auxiliaryChunkIdHints
  * @property {number=} filteredRelated
  * @property {boolean=} isOverSizeLimit
  */
@@ -143,6 +150,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean=} isOverSizeLimit
  */
 
+/** @typedef {Module[]} ModuleIssuerPath */
 /** @typedef {KnownStatsModule & Record<string, EXPECTED_ANY>} StatsModule */
 /**
  * @typedef {object} KnownStatsModule
@@ -172,7 +180,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {boolean=} dependent
  * @property {(string | null)=} issuer
  * @property {(string | null)=} issuerName
- * @property {StatsModuleIssuer[]=} issuerPath
+ * @property {StatsModuleIssuer[] | null=} issuerPath
  * @property {boolean=} failed
  * @property {number=} errors
  * @property {number=} warnings
@@ -244,7 +252,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {string[]} files
  * @property {string[]} auxiliaryFiles
  * @property {string} hash
- * @property {Record<string, (string|number)[]>} childrenByOrder
+ * @property {Record<string, ChunkId[]>} childrenByOrder
  * @property {(string|number)=} id
  * @property {(string|number)[]=} siblings
  * @property {(string|number)[]=} parents
@@ -310,12 +318,15 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @typedef {Record<string, (object: O, data: T, context: StatsFactoryContext, options: NormalizedStatsOptions, factory: StatsFactory) => void>} ExtractorsByOption
  */
 
+/** @typedef {{ name: string, chunkGroup: ChunkGroup }} ChunkGroupInfoWithName */
+/** @typedef {{ origin: Module, module: Module }} ModuleTrace */
+
 /**
  * @typedef {object} SimpleExtractors
  * @property {ExtractorsByOption<Compilation, StatsCompilation>} compilation
  * @property {ExtractorsByOption<PreprocessedAsset, StatsAsset>} asset
  * @property {ExtractorsByOption<PreprocessedAsset, StatsAsset>} asset$visible
- * @property {ExtractorsByOption<{ name: string, chunkGroup: ChunkGroup }, StatsChunkGroup>} chunkGroup
+ * @property {ExtractorsByOption<ChunkGroupInfoWithName, StatsChunkGroup>} chunkGroup
  * @property {ExtractorsByOption<Module, StatsModule>} module
  * @property {ExtractorsByOption<Module, StatsModule>} module$visible
  * @property {ExtractorsByOption<Module, StatsModuleIssuer>} moduleIssuer
@@ -325,7 +336,7 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {ExtractorsByOption<OriginRecord, StatsChunkOrigin>} chunkOrigin
  * @property {ExtractorsByOption<WebpackError, StatsError>} error
  * @property {ExtractorsByOption<WebpackError, StatsError>} warning
- * @property {ExtractorsByOption<{ origin: Module, module: Module }, StatsModuleTraceItem>} moduleTraceItem
+ * @property {ExtractorsByOption<ModuleTrace, StatsModuleTraceItem>} moduleTraceItem
  * @property {ExtractorsByOption<Dependency, StatsModuleTraceDependency>} moduleTraceDependency
  */
 
@@ -441,6 +452,7 @@ const EXTRACT_ERROR = {
 			} = context;
 			/** @type {Set<Module>} */
 			const visitedModules = new Set();
+			/** @type {ModuleTrace[]} */
 			const moduleTrace = [];
 			let current = error.module;
 			while (current) {
@@ -796,6 +808,7 @@ const SIMPLE_EXTRACTORS = {
 			factory
 		) => {
 			const { type } = context;
+			/** @type {ChunkGroupInfoWithName[]} */
 			const array = Array.from(compilation.entrypoints, ([key, value]) => ({
 				name: key,
 				chunkGroup: value
@@ -915,12 +928,13 @@ const SIMPLE_EXTRACTORS = {
 					/** @type {KnownNormalizedStatsOptions["warningsFilter"]} */
 					(warningsFilter).length === 0
 				)
-					return cachedGetWarnings(c);
+					// Type is wrong, because we don't need the real value for counting
+					return /** @type {EXPECTED_ANY[]} */ (cachedGetWarnings(c));
 				return factory
 					.create(`${type}${childType}.warnings`, cachedGetWarnings(c), context)
 					.filter(
 						/**
-						 * @param {TODO} warning warning
+						 * @param {StatsError} warning warning
 						 * @returns {boolean} result
 						 */
 						warning => {
@@ -1169,7 +1183,6 @@ const SIMPLE_EXTRACTORS = {
 				cached: !built && !codeGenerated
 			};
 			Object.assign(object, statsModule);
-
 			if (built || codeGenerated || options.cachedModules) {
 				Object.assign(
 					object,
@@ -1183,7 +1196,7 @@ const SIMPLE_EXTRACTORS = {
 			const { type, rootModules } = context;
 			const compilation = /** @type {Compilation} */ (context.compilation);
 			const { moduleGraph } = compilation;
-			/** @type {Module[]} */
+			/** @type {ModuleIssuerPath} */
 			const path = [];
 			const issuer = moduleGraph.getIssuer(module);
 			let current = issuer;
@@ -1221,7 +1234,8 @@ const SIMPLE_EXTRACTORS = {
 				issuerName: issuer && issuer.readableIdentifier(requestShortener),
 				issuerPath:
 					issuer &&
-					factory.create(`${type.slice(0, -8)}.issuerPath`, path, context),
+					/** @type {StatsModuleIssuer[] | undefined} */
+					(factory.create(`${type.slice(0, -8)}.issuerPath`, path, context)),
 				failed: errorsCount > 0,
 				errors: errorsCount,
 				warnings: warningsCount
@@ -1506,6 +1520,7 @@ const SIMPLE_EXTRACTORS = {
 			} = context;
 			/** @type {Set<string>} */
 			const originsKeySet = new Set();
+			/** @type {OriginRecord[]} */
 			const origins = [];
 			for (const g of chunk.groupsIterable) {
 				origins.push(...g.origins);
@@ -1562,7 +1577,8 @@ const SIMPLE_EXTRACTORS = {
 				.map(c => c.dependency);
 			object.dependencies = factory.create(
 				`${type}.dependencies`,
-				Array.from(new Set(dependencies)),
+				/** @type {Dependency[]} */
+				(Array.from(new Set(dependencies))),
 				context
 			);
 		},
@@ -1612,9 +1628,7 @@ const FILTER_RESULTS = {
 	}
 };
 
-/**
- * @type {Record<string, (comparators: Comparator<Module>[], context: StatsFactoryContext) => void>}
- */
+/** @type {Record<string, (comparators: Comparator<Module>[], context: StatsFactoryContext) => void>} */
 const MODULES_SORTER = {
 	_: (comparators, { compilation: { moduleGraph } }) => {
 		comparators.push(
@@ -1625,7 +1639,7 @@ const MODULES_SORTER = {
 	}
 };
 
-/** @type {Record<string, Record<string, (comparators: Comparator<any>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>>} */
+/** @type {Record<string, Record<string, (comparators: Comparator<TODO>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>>} */
 const SORTERS = {
 	"compilation.chunks": {
 		_: comparators => {
@@ -1679,7 +1693,7 @@ const SORTERS = {
 
 /**
  * @template T
- * @typedef {T & { children: Children<T>[] | undefined, filteredChildren?: number }} Children
+ * @typedef {T & { children?: Children<T>[] | undefined, filteredChildren?: number }} Children
  */
 
 /**
@@ -2051,6 +2065,7 @@ const ASSETS_GROUPERS = {
 					const pathMatch =
 						groupAssetsByPath && GROUP_PATH_REGEXP.exec(asset.name);
 					const path = pathMatch ? pathMatch[1].split(/[/\\]/) : [];
+					/** @type {string[]} */
 					const keys = [];
 					if (groupAssetsByPath) {
 						keys.push(".");
@@ -2141,7 +2156,7 @@ const ASSETS_GROUPERS = {
 
 /** @typedef {Record<string, (groupConfigs: GroupConfig<KnownStatsModule, TODO>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>} ModulesGroupers */
 
-/** @type {(type: "module" | "chunk" | "root-of-chunk" | "nested") => ModulesGroupers} */
+/** @type {(type: ExcludeModulesType) => ModulesGroupers} */
 const MODULES_GROUPERS = type => ({
 	_: (groupConfigs, context, options) => {
 		/**
@@ -2386,7 +2401,7 @@ const sortByField = field => {
 	return sortFn;
 };
 
-/** @type {Record<string, (comparators: Comparator<TODO>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>} */
+/** @type {Record<string, (comparators: Comparator<Asset>[], context: StatsFactoryContext, options: NormalizedStatsOptions) => void>} */
 const ASSET_SORTERS = {
 	assetsSort: (comparators, context, { assetsSort }) => {
 		comparators.push(sortByField(assetsSort));