webpack 5.104.1 → 5.105.4

package/lib/optimize/ModuleConcatenationPlugin.js

@@ -28,6 +28,8 @@ const ConcatenatedModule = require("./ConcatenatedModule");
 /** @typedef {import("../RequestShortener")} RequestShortener */
 /** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
 
+/** @typedef {Module | ((requestShortener: RequestShortener) => string)} Problem */
+
 /**
  * @typedef {object} Statistics
  * @property {number} cached
@@ -104,7 +106,7 @@ class ModuleConcatenationPlugin {
 
 			/**
 			 * @param {Module} module the module
-			 * @param {Module | ((requestShortener: RequestShortener) => string)} problem the problem
+			 * @param {Problem} problem the problem
 			 * @returns {(requestShortener: RequestShortener) => string} the reason
 			 */
 			const formatBailoutWarning = (module, problem) => (requestShortener) => {
@@ -143,7 +145,9 @@ class ModuleConcatenationPlugin {
 						"webpack.ModuleConcatenationPlugin"
 					);
 					const { chunkGraph, moduleGraph } = compilation;
+					/** @type {Module[]} */
 					const relevantModules = [];
+					/** @type {Set<Module>} */
 					const possibleInners = new Set();
 					const context = {
 						chunkGraph,
@@ -265,7 +269,9 @@ class ModuleConcatenationPlugin {
 					let statsEmptyConfigurations = 0;
 
 					logger.time("find modules to concatenate");
+					/** @type {ConcatConfiguration[]} */
 					const concatConfigurations = [];
+					/** @type {Set<Module>} */
 					const usedAsInner = new Set();
 					for (const currentRoot of relevantModules) {
 						// when used by another configuration as inner:
@@ -273,6 +279,7 @@ class ModuleConcatenationPlugin {
 						// TODO reconsider that when it's only used in a different runtime
 						if (usedAsInner.has(currentRoot)) continue;
 
+						/** @type {RuntimeSpec} */
 						let chunkRuntime;
 						for (const r of chunkGraph.getModuleRuntimes(currentRoot)) {
 							chunkRuntime = mergeRuntimeOwned(chunkRuntime, r);
@@ -295,6 +302,7 @@ class ModuleConcatenationPlugin {
 						);
 
 						// cache failures to add modules
+						/** @type {Map<Module, Problem>} */
 						const failureCache = new Map();
 
 						// potential optional import candidates
@@ -311,6 +319,7 @@ class ModuleConcatenationPlugin {
 						}
 
 						for (const imp of candidates) {
+							/** @type {Set<Module>} */
 							const impCandidates = new Set();
 							const problem = this._tryToAdd(
 								compilation,
@@ -373,6 +382,7 @@ class ModuleConcatenationPlugin {
 					logger.time("sort concat configurations");
 					concatConfigurations.sort((a, b) => b.modules.size - a.modules.size);
 					logger.timeEnd("sort concat configurations");
+					/** @type {Set<Module>} */
 					const usedModules = new Set();
 
 					logger.time("create concatenated modules");
@@ -456,7 +466,10 @@ class ModuleConcatenationPlugin {
 												chunk,
 												m
 											);
-											if (sourceTypes.size === 1) {
+											if (
+												sourceTypes.size === 1 &&
+												sourceTypes.has(JAVASCRIPT_TYPE)
+											) {
 												chunkGraph.disconnectChunkAndModule(chunk, m);
 											} else {
 												const newSourceTypes = new Set(sourceTypes);
@@ -515,6 +528,7 @@ class ModuleConcatenationPlugin {
 	 */
 	_getImports(compilation, module, runtime) {
 		const moduleGraph = compilation.moduleGraph;
+		/** @type {Set<Module>} */
 		const set = new Set();
 		for (const dep of module.dependencies) {
 			// Get reference info only for harmony Dependencies
@@ -555,11 +569,11 @@ class ModuleConcatenationPlugin {
 	 * @param {RuntimeSpec} activeRuntime the runtime scope of the root module
 	 * @param {Set<Module>} possibleModules modules that are candidates
 	 * @param {Set<Module>} candidates list of potential candidates (will be added to)
-	 * @param {Map<Module, Module | ((requestShortener: RequestShortener) => string)>} failureCache cache for problematic modules to be more performant
+	 * @param {Map<Module, Problem>} failureCache cache for problematic modules to be more performant
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {boolean} avoidMutateOnFailure avoid mutating the config when adding fails
 	 * @param {Statistics} statistics gathering metrics
-	 * @returns {null | Module | ((requestShortener: RequestShortener) => string)} the problematic module
+	 * @returns {null | Problem} the problematic module
 	 */
 	_tryToAdd(
 		compilation,
@@ -646,6 +660,7 @@ class ModuleConcatenationPlugin {
 				 * @returns {string} problem description
 				 */
 				const problem = (requestShortener) => {
+					/** @type {Set<string>} */
 					const importingExplanations = new Set(
 						activeNonModulesConnections
 							.map((c) => c.explanation)
@@ -674,6 +689,7 @@ class ModuleConcatenationPlugin {
 				if (chunkGraph.getNumberOfModuleChunks(originModule) === 0) continue;
 
 				// We don't care for connections from other runtimes
+				/** @type {RuntimeSpec} */
 				let originRuntime;
 				for (const r of chunkGraph.getModuleRuntimes(originModule)) {
 					originRuntime = mergeRuntimeOwned(originRuntime, r);
@@ -822,6 +838,7 @@ class ModuleConcatenationPlugin {
 			}
 		}
 
+		/** @type {undefined | number} */
 		let backup;
 		if (avoidMutateOnFailure) {
 			backup = config.snapshot();
@@ -864,7 +881,6 @@ class ModuleConcatenationPlugin {
 	}
 }
 
-/** @typedef {Module | ((requestShortener: RequestShortener) => string)} Problem */
 /** @typedef {Map<Module, Problem>} Warnings */
 
 class ConcatConfiguration {
@@ -873,7 +889,9 @@ class ConcatConfiguration {
 	 * @param {RuntimeSpec} runtime the runtime
 	 */
 	constructor(rootModule, runtime) {
+		/** @type {Module} */
 		this.rootModule = rootModule;
+		/** @type {RuntimeSpec} */
 		this.runtime = runtime;
 		/** @type {Set<Module>} */
 		this.modules = new Set();

package/lib/optimize/RealContentHashPlugin.js

@@ -20,6 +20,12 @@ const createHash = require("../util/createHash");
 /** @typedef {import("../Compiler")} Compiler */
 /** @typedef {typeof import("../util/Hash")} Hash */
 
+/**
+ * @template T
+ * @typedef {import("../util/comparators").Comparator<T>} Comparator
+ */
+
+/** @type {Hashes} */
 const EMPTY_SET = new Set();
 
 /**
@@ -47,6 +53,7 @@ const mapAndDeduplicateBuffers = (input, fn) => {
 	// Buffer.equals compares size first so this should be efficient enough
 	// If it becomes a performance problem we can use a map and group by size
 	// instead of looping over all assets.
+	/** @type {Buffer[]} */
 	const result = [];
 	outer: for (const value of input) {
 		const buf = fn(value);
@@ -65,6 +72,7 @@ const mapAndDeduplicateBuffers = (input, fn) => {
  */
 const quoteMeta = (str) => str.replace(/[-[\]\\/{}()*+?.^$|]/g, "\\$&");
 
+/** @type {WeakMap<Source, CachedSource>} */
 const cachedSourceMap = new WeakMap();
 
 /**
@@ -82,8 +90,6 @@ const toCachedSource = (source) => {
 	return newSource;
 };
 
-/** @typedef {Set<string>} OwnHashes */
-/** @typedef {Set<string>} ReferencedHashes */
 /** @typedef {Set<string>} Hashes */
 
 /**
@@ -94,10 +100,10 @@ const toCachedSource = (source) => {
  * @property {RawSource | undefined} newSource
  * @property {RawSource | undefined} newSourceWithoutOwn
  * @property {string} content
- * @property {OwnHashes | undefined} ownHashes
+ * @property {Hashes | undefined} ownHashes
  * @property {Promise<void> | undefined} contentComputePromise
  * @property {Promise<void> | undefined} contentComputeWithoutOwnPromise
- * @property {ReferencedHashes | undefined} referencedHashes
+ * @property {Hashes | undefined} referencedHashes
  * @property {Hashes} hashes
  */
 
@@ -142,7 +148,9 @@ class RealContentHashPlugin {
 	 * @param {RealContentHashPluginOptions} options options
 	 */
 	constructor({ hashFunction, hashDigest }) {
+		/** @type {HashFunction} */
 		this._hashFunction = hashFunction;
+		/** @type {HashDigest} */
 		this._hashDigest = hashDigest;
 	}
 
@@ -220,7 +228,9 @@ class RealContentHashPlugin {
 							);
 							[asset.referencedHashes, asset.ownHashes] =
 								await cacheAnalyse.providePromise(name, etag, () => {
+									/** @type {Hashes} */
 									const referencedHashes = new Set();
+									/** @type {Hashes} */
 									const ownHashes = new Set();
 									const inContent = content.match(hashRegExp);
 									if (inContent) {
@@ -238,15 +248,13 @@ class RealContentHashPlugin {
 					);
 					/**
 					 * @param {string} hash the hash
-					 * @returns {undefined | ReferencedHashes} the referenced hashes
+					 * @returns {undefined | Hashes} the referenced hashes
 					 */
 					const getDependencies = (hash) => {
 						const assets = hashToAssets.get(hash);
 						if (!assets) {
 							const referencingAssets = assetsWithInfo.filter((asset) =>
-								/** @type {ReferencedHashes} */ (asset.referencedHashes).has(
-									hash
-								)
+								/** @type {Hashes} */ (asset.referencedHashes).has(hash)
 							);
 							const err = new WebpackError(`RealContentHashPlugin
 Some kind of unexpected caching problem occurred.
@@ -264,16 +272,15 @@ ${referencingAssets
 							compilation.errors.push(err);
 							return;
 						}
+						/** @type {Hashes} */
 						const hashes = new Set();
 						for (const { referencedHashes, ownHashes } of assets) {
-							if (!(/** @type {OwnHashes} */ (ownHashes).has(hash))) {
-								for (const hash of /** @type {OwnHashes} */ (ownHashes)) {
+							if (!(/** @type {Hashes} */ (ownHashes).has(hash))) {
+								for (const hash of /** @type {Hashes} */ (ownHashes)) {
 									hashes.add(hash);
 								}
 							}
-							for (const hash of /** @type {ReferencedHashes} */ (
-								referencedHashes
-							)) {
+							for (const hash of /** @type {Hashes} */ (referencedHashes)) {
 								hashes.add(hash);
 							}
 						}
@@ -290,7 +297,7 @@ ${referencingAssets
 							(a) => a.name
 						)})`;
 					};
-					/** @type {Set<string>} */
+					/** @type {Hashes} */
 					const hashesInOrder = new Set();
 					for (const hash of hashToAssets.keys()) {
 						/**
@@ -329,7 +336,7 @@ ${referencingAssets
 						cacheGenerate.mergeEtags(
 							cacheGenerate.getLazyHashedEtag(asset.source),
 							Array.from(
-								/** @type {ReferencedHashes} */ (asset.referencedHashes),
+								/** @type {Hashes} */ (asset.referencedHashes),
 								(hash) => hashToNewHash.get(hash)
 							).join("|")
 						);
@@ -341,10 +348,10 @@ ${referencingAssets
 						if (asset.contentComputePromise) return asset.contentComputePromise;
 						return (asset.contentComputePromise = (async () => {
 							if (
-								/** @type {OwnHashes} */ (asset.ownHashes).size > 0 ||
-								[
-									.../** @type {ReferencedHashes} */ (asset.referencedHashes)
-								].some((hash) => hashToNewHash.get(hash) !== hash)
+								/** @type {Hashes} */ (asset.ownHashes).size > 0 ||
+								[.../** @type {Hashes} */ (asset.referencedHashes)].some(
+									(hash) => hashToNewHash.get(hash) !== hash
+								)
 							) {
 								const identifier = asset.name;
 								const etag = getEtag(asset);
@@ -372,10 +379,10 @@ ${referencingAssets
 						}
 						return (asset.contentComputeWithoutOwnPromise = (async () => {
 							if (
-								/** @type {OwnHashes} */ (asset.ownHashes).size > 0 ||
-								[
-									.../** @type {ReferencedHashes} */ (asset.referencedHashes)
-								].some((hash) => hashToNewHash.get(hash) !== hash)
+								/** @type {Hashes} */ (asset.ownHashes).size > 0 ||
+								[.../** @type {Hashes} */ (asset.referencedHashes)].some(
+									(hash) => hashToNewHash.get(hash) !== hash
+								)
 							) {
 								const identifier = `${asset.name}|without-own`;
 								const etag = getEtag(asset);
@@ -387,7 +394,7 @@ ${referencingAssets
 											hashRegExp,
 											(hash) => {
 												if (
-													/** @type {OwnHashes} */
+													/** @type {Hashes} */
 													(asset.ownHashes).has(hash)
 												) {
 													return "";
@@ -401,6 +408,7 @@ ${referencingAssets
 							}
 						})());
 					};
+					/** @type {Comparator<AssetInfoForRealContentHash>} */
 					const comparator = compareSelect((a) => a.name, compareStrings);
 					for (const oldHash of hashesInOrder) {
 						const assets =
@@ -409,13 +417,13 @@ ${referencingAssets
 						assets.sort(comparator);
 						await Promise.all(
 							assets.map((asset) =>
-								/** @type {OwnHashes} */ (asset.ownHashes).has(oldHash)
+								/** @type {Hashes} */ (asset.ownHashes).has(oldHash)
 									? computeNewContentWithoutOwn(asset)
 									: computeNewContent(asset)
 							)
 						);
 						const assetsContent = mapAndDeduplicateBuffers(assets, (asset) => {
-							if (/** @type {OwnHashes} */ (asset.ownHashes).has(oldHash)) {
+							if (/** @type {Hashes} */ (asset.ownHashes).has(oldHash)) {
 								return asset.newSourceWithoutOwn
 									? asset.newSourceWithoutOwn.buffer()
 									: asset.source.buffer();
@@ -447,7 +455,9 @@ ${referencingAssets
 							);
 
 							const infoUpdate = {};
-							const hash = /** @type {string} */ (asset.info.contenthash);
+							const hash =
+								/** @type {Exclude<AssetInfo["contenthash"], undefined>} */
+								(asset.info.contenthash);
 							infoUpdate.contenthash = Array.isArray(hash)
 								? hash.map(
 										(hash) => /** @type {string} */ (hashToNewHash.get(hash))

package/lib/optimize/RemoveParentModulesPlugin.js

@@ -33,7 +33,7 @@ const THIRTY_TWO_BIGINT = BigInt(32);
  * Parses the module mask and returns the modules represented by it
  * @param {bigint} mask the module mask
  * @param {Module[]} ordinalModules the modules in the order they were added to the mask (LSB is index 0)
- * @returns {Generator<Module>} the modules represented by the mask
+ * @returns {Generator<Module, undefined, undefined>} the modules represented by the mask
  */
 function* getModulesFromMask(mask, ordinalModules) {
 	let offset = 31;
@@ -74,10 +74,13 @@ class RemoveParentModulesPlugin {
 			 */
 			const handler = (chunks, chunkGroups) => {
 				const chunkGraph = compilation.chunkGraph;
+				/** @type {Set<ChunkGroup>} */
 				const queue = new Set();
+				/** @type {WeakMap<ChunkGroup, bigint | undefined>} */
 				const availableModulesMap = new WeakMap();
 
 				let nextModuleMask = ONE_BIGINT;
+				/** @type {WeakMap<Module, bigint>} */
 				const maskByModule = new WeakMap();
 				/** @type {Module[]} */
 				const ordinalModules = [];
@@ -99,6 +102,7 @@ class RemoveParentModulesPlugin {
 				};
 
 				// Initialize masks by chunk and by chunk group for quicker comparisons
+				/** @type {WeakMap<Chunk, bigint>} */
 				const chunkMasks = new WeakMap();
 				for (const chunk of chunks) {
 					let mask = ZERO_BIGINT;
@@ -109,6 +113,7 @@ class RemoveParentModulesPlugin {
 					chunkMasks.set(chunk, mask);
 				}
 
+				/** @type {WeakMap<ChunkGroup, bigint>} */
 				const chunkGroupMasks = new WeakMap();
 				for (const chunkGroup of chunkGroups) {
 					let mask = ZERO_BIGINT;
@@ -143,7 +148,8 @@ class RemoveParentModulesPlugin {
 						const availableModulesInParent = availableModulesMap.get(parent);
 						if (availableModulesInParent !== undefined) {
 							const parentMask =
-								availableModulesInParent | chunkGroupMasks.get(parent);
+								availableModulesInParent |
+								/** @type {bigint} */ (chunkGroupMasks.get(parent));
 							// If we know the available modules in parent: process these
 							if (availableModulesMask === undefined) {
 								// if we have not own info yet: create new entry
@@ -181,7 +187,10 @@ class RemoveParentModulesPlugin {
 					);
 					if (availableModulesSets.includes(undefined)) continue; // No info about this chunk group
 
-					const availableModulesMask = intersectMasks(availableModulesSets);
+					const availableModulesMask = intersectMasks(
+						/** @type {bigint[]} */
+						(availableModulesSets)
+					);
 					const toRemoveMask = chunkMask & availableModulesMask;
 					if (toRemoveMask !== ZERO_BIGINT) {
 						for (const module of getModulesFromMask(

package/lib/optimize/RuntimeChunkPlugin.js

@@ -16,9 +16,9 @@ class RuntimeChunkPlugin {
 	/**
 	 * @param {{ name?: RuntimeChunkFunction }=} options options
 	 */
-	constructor(options) {
+	constructor(options = {}) {
+		/** @type {{ name: string | RuntimeChunkFunction }} */
 		this.options = {
-			/** @type {RuntimeChunkFunction} */
 			name: (entrypoint) => `runtime~${entrypoint.name}`,
 			...options
 		};
@@ -38,9 +38,7 @@ class RuntimeChunkPlugin {
 					(compilation.entries.get(entryName));
 				if (data.options.runtime === undefined && !data.options.dependOn) {
 					// Determine runtime chunk name
-					let name =
-						/** @type {string | RuntimeChunkFunction} */
-						(this.options.name);
+					let name = this.options.name;
 					if (typeof name === "function") {
 						name = name({ name: entryName });
 					}

package/lib/optimize/SideEffectsFlagPlugin.js

@@ -68,6 +68,7 @@ class SideEffectsFlagPlugin {
 	 * @param {boolean} analyseSource analyse source code for side effects
 	 */
 	constructor(analyseSource = true) {
+		/** @type {boolean} */
 		this._analyseSource = analyseSource;
 	}
 
@@ -277,6 +278,7 @@ class SideEffectsFlagPlugin {
 
 						logger.time("update dependencies");
 
+						/** @type {Set<Module>} */
 						const optimizedModules = new Set();
 
 						/**
@@ -291,6 +293,7 @@ class SideEffectsFlagPlugin {
 									module
 								)) {
 									const dep = connection.dependency;
+									/** @type {boolean} */
 									let isReexport;
 									if (
 										(isReexport =

package/lib/optimize/SplitChunksPlugin.js

@@ -22,7 +22,6 @@ const memoize = require("../util/memoize");
 const MinMaxSizeWarning = require("./MinMaxSizeWarning");
 
 /** @typedef {import("../../declarations/WebpackOptions").OptimizationSplitChunksCacheGroup} OptimizationSplitChunksCacheGroup */
-/** @typedef {import("../../declarations/WebpackOptions").OptimizationSplitChunksGetCacheGroups} OptimizationSplitChunksGetCacheGroups */
 /** @typedef {import("../../declarations/WebpackOptions").OptimizationSplitChunksOptions} OptimizationSplitChunksOptions */
 /** @typedef {import("../../declarations/WebpackOptions").OptimizationSplitChunksSizes} OptimizationSplitChunksSizes */
 /** @typedef {import("../config/defaults").OutputNormalizedWithDefaults} OutputOptions */
@@ -36,6 +35,7 @@ const MinMaxSizeWarning = require("./MinMaxSizeWarning");
 /** @typedef {import("../TemplatedPathPlugin").TemplatePath} TemplatePath */
 /** @typedef {import("../util/deterministicGrouping").GroupedItems<Module>} DeterministicGroupingGroupedItemsForModule */
 /** @typedef {import("../util/deterministicGrouping").Options<Module>} DeterministicGroupingOptionsForModule */
+/** @typedef {import("../util/deterministicGrouping").Sizes} Sizes */
 
 /**
  * @callback ChunkFilterFn
@@ -123,6 +123,8 @@ const MinMaxSizeWarning = require("./MinMaxSizeWarning");
  * @property {ChunkGraph} chunkGraph
  */
 
+/** @typedef {(module: Module) => OptimizationSplitChunksCacheGroup | OptimizationSplitChunksCacheGroup[] | void} RawGetCacheGroups */
+
 /**
  * @callback GetCacheGroups
  * @param {Module} module
@@ -220,9 +222,10 @@ const getRequests = (chunk) => {
  * @returns {T} result
  */
 const mapObject = (obj, fn) => {
+	/** @type {T} */
 	const newObj = Object.create(null);
 	for (const key of Object.keys(obj)) {
-		newObj[key] = fn(
+		newObj[/** @type {keyof T} */ (key)] = fn(
 			obj[/** @type {keyof T} */ (key)],
 			/** @type {keyof T} */
 			(key)
@@ -454,7 +457,7 @@ const normalizeChunksFilter = (chunks) => {
 };
 
 /**
- * @param {undefined | GetCacheGroups | Record<string, false | string | RegExp | OptimizationSplitChunksGetCacheGroups | OptimizationSplitChunksCacheGroup>} cacheGroups the cache group options
+ * @param {undefined | GetCacheGroups | Record<string, false | string | RegExp | RawGetCacheGroups | OptimizationSplitChunksCacheGroup>} cacheGroups the cache group options
  * @param {DefaultSizeTypes} defaultSizeTypes the default size types
  * @returns {GetCacheGroups} a function to get the cache groups
  */
@@ -478,6 +481,7 @@ const normalizeCacheGroups = (cacheGroups, defaultSizeTypes) => {
 					}
 				});
 			} else if (typeof option === "function") {
+				/** @type {WeakMap<OptimizationSplitChunksCacheGroup, CacheGroupSource>} */
 				const cache = new WeakMap();
 				handlers.push((module, context, results) => {
 					const result = option(module);
@@ -530,6 +534,8 @@ const normalizeCacheGroups = (cacheGroups, defaultSizeTypes) => {
 	return () => null;
 };
 
+/** @typedef {(module: Module, context: CacheGroupsContext) => boolean} CheckTestFn */
+
 /**
  * @param {OptimizationSplitChunksCacheGroup["test"]} test test option
  * @param {Module} module the module
@@ -553,6 +559,8 @@ const checkTest = (test, module, context) => {
 	return false;
 };
 
+/** @typedef {(type: string) => boolean} CheckModuleTypeFn */
+
 /**
  * @param {OptimizationSplitChunksCacheGroup["type"]} test type option
  * @param {Module} module the module
@@ -574,6 +582,8 @@ const checkModuleType = (test, module) => {
 	return false;
 };
 
+/** @typedef {(layer: string | null) => boolean} CheckModuleLayerFn */
+
 /**
  * @param {OptimizationSplitChunksCacheGroup["layer"]} test type option
  * @param {Module} module the module
@@ -868,7 +878,7 @@ module.exports = class SplitChunksPlugin {
 						index <<= ONE;
 					}
 					/**
-					 * @param {Iterable<Chunk>} chunks list of chunks
+					 * @param {Iterable<Chunk, undefined, undefined>} chunks list of chunks
 					 * @returns {bigint | Chunk} key of the chunks
 					 */
 					const getKey = (chunks) => {
@@ -921,6 +931,7 @@ module.exports = class SplitChunksPlugin {
 					 */
 					const groupChunksByExports = (module) => {
 						const exportsInfo = moduleGraph.getExportsInfo(module);
+						/** @type {Map<string, Chunk[]>} */
 						const groupedByUsedExports = new Map();
 						for (const chunk of chunkGraph.getModuleChunksIterable(module)) {
 							const key = exportsInfo.getUsageKey(chunk.runtime);
@@ -1082,7 +1093,8 @@ module.exports = class SplitChunksPlugin {
 					 * @property {bigint | Chunk} key a key of the list
 					 */
 
-					/** @type {WeakMap<ChunkSet | Chunk, WeakMap<ChunkFilterFn, SelectedChunksResult>>} */
+					/** @typedef {WeakMap<ChunkFilterFn, SelectedChunksResult>} ChunkMap */
+					/** @type {WeakMap<ChunkSet | Chunk, ChunkMap>} */
 					const selectedChunksCacheByChunksSet = new WeakMap();
 
 					/**
@@ -1095,6 +1107,7 @@ module.exports = class SplitChunksPlugin {
 					const getSelectedChunks = (chunks, chunkFilter) => {
 						let entry = selectedChunksCacheByChunksSet.get(chunks);
 						if (entry === undefined) {
+							/** @type {ChunkMap} */
 							entry = new WeakMap();
 							selectedChunksCacheByChunksSet.set(chunks, entry);
 						}
@@ -1392,7 +1405,9 @@ module.exports = class SplitChunksPlugin {
 
 					while (chunksInfoMap.size > 0) {
 						// Find best matching entry
+						/** @type {undefined | string} */
 						let bestEntryKey;
+						/** @type {undefined | ChunksInfoItem} */
 						let bestEntry;
 						for (const pair of chunksInfoMap) {
 							const key = pair[0];
@@ -1471,6 +1486,7 @@ module.exports = class SplitChunksPlugin {
 							item.cacheGroup._conditionalEnforce &&
 							checkMinSize(item.sizes, item.cacheGroup.enforceSizeThreshold);
 
+						/** @type {Set<Chunk>} */
 						const usedChunks = new Set(item.chunks);
 
 						// Check if maxRequests condition can be fulfilled
@@ -1533,6 +1549,7 @@ module.exports = class SplitChunksPlugin {
 							usedChunks.size === 1
 						) {
 							const [chunk] = usedChunks;
+							/** @type {SplitChunksSizes} */
 							const chunkSizes = Object.create(null);
 							for (const module of chunkGraph.getChunkModulesIterable(chunk)) {
 								if (!item.modules.has(module)) {
@@ -1763,6 +1780,7 @@ module.exports = class SplitChunksPlugin {
 								return key;
 							},
 							getSize(module) {
+								/** @type {Sizes} */
 								const size = Object.create(null);
 								for (const key of module.getSourceTypes()) {
 									size[key] = module.size(key);

package/lib/performance/AssetsOverSizeLimitWarning.js

@@ -10,7 +10,7 @@ const WebpackError = require("../WebpackError");
 
 /** @typedef {import("./SizeLimitsPlugin").AssetDetails} AssetDetails */
 
-module.exports = class AssetsOverSizeLimitWarning extends WebpackError {
+class AssetsOverSizeLimitWarning extends WebpackError {
 	/**
 	 * @param {AssetDetails[]} assetsOverSizeLimit the assets
 	 * @param {number} assetLimit the size limit
@@ -26,7 +26,12 @@ module.exports = class AssetsOverSizeLimitWarning extends WebpackError {
 This can impact web performance.
 Assets: ${assetLists}`);
 
+		/** @type {string} */
 		this.name = "AssetsOverSizeLimitWarning";
+		/** @type {AssetDetails[]} */
 		this.assets = assetsOverSizeLimit;
 	}
-};
+}
+
+/** @type {typeof AssetsOverSizeLimitWarning} */
+module.exports = AssetsOverSizeLimitWarning;

package/lib/performance/EntrypointsOverSizeLimitWarning.js

@@ -10,7 +10,7 @@ const WebpackError = require("../WebpackError");
 
 /** @typedef {import("./SizeLimitsPlugin").EntrypointDetails} EntrypointDetails */
 
-module.exports = class EntrypointsOverSizeLimitWarning extends WebpackError {
+class EntrypointsOverSizeLimitWarning extends WebpackError {
 	/**
 	 * @param {EntrypointDetails[]} entrypoints the entrypoints
 	 * @param {number} entrypointLimit the size limit
@@ -29,7 +29,12 @@ module.exports = class EntrypointsOverSizeLimitWarning extends WebpackError {
 		)}). This can impact web performance.
 Entrypoints:${entrypointList}\n`);
 
+		/** @type {string} */
 		this.name = "EntrypointsOverSizeLimitWarning";
+		/** @type {EntrypointDetails[]} */
 		this.entrypoints = entrypoints;
 	}
-};
+}
+
+/** @type {typeof EntrypointsOverSizeLimitWarning} */
+module.exports = EntrypointsOverSizeLimitWarning;

package/lib/performance/NoAsyncChunksWarning.js

@@ -15,6 +15,7 @@ module.exports = class NoAsyncChunksWarning extends WebpackError {
 				"For more info visit https://webpack.js.org/guides/code-splitting/"
 		);
 
+		/** @type {string} */
 		this.name = "NoAsyncChunksWarning";
 	}
 };

package/lib/performance/SizeLimitsPlugin.js

@@ -34,12 +34,9 @@ const NoAsyncChunksWarning = require("./NoAsyncChunksWarning");
 /** @type {WeakSet<Entrypoint | ChunkGroup | Source>} */
 const isOverSizeLimitSet = new WeakSet();
 
-/**
- * @param {Asset["name"]} name the name
- * @param {Asset["source"]} source the source
- * @param {Asset["info"]} info the info
- * @returns {boolean} result
- */
+/** @typedef {(name: Asset["name"], source: Asset["source"], assetInfo: Asset["info"]) => boolean} AssetFilter */
+
+/** @type {AssetFilter} */
 const excludeSourceMap = (name, source, info) => !info.development;
 
 const PLUGIN_NAME = "SizeLimitsPlugin";
@@ -49,9 +46,13 @@ module.exports = class SizeLimitsPlugin {
 	 * @param {PerformanceOptions} options the plugin options
 	 */
 	constructor(options) {
+		/** @type {PerformanceOptions["hints"]} */
 		this.hints = options.hints;
+		/** @type {number | undefined} */
 		this.maxAssetSize = options.maxAssetSize;
+		/** @type {number | undefined} */
 		this.maxEntrypointSize = options.maxEntrypointSize;
+		/** @type {AssetFilter | undefined} */
 		this.assetFilter = options.assetFilter;
 	}