webpack 5.106.1 → 5.106.2

package/lib/optimize/ModuleConcatenationPlugin.js

@@ -31,6 +31,7 @@ const ConcatenatedModule = require("./ConcatenatedModule");
 /** @typedef {Module | ((requestShortener: RequestShortener) => string)} Problem */
 
 /**
+ * Defines the statistics type used by this module.
  * @typedef {object} Statistics
  * @property {number} cached
  * @property {number} alreadyInConfig
@@ -45,6 +46,7 @@ const ConcatenatedModule = require("./ConcatenatedModule");
  */
 
 /**
+ * Format bailout reason.
  * @param {string} msg message
  * @returns {string} formatted message
  */
@@ -54,7 +56,7 @@ const PLUGIN_NAME = "ModuleConcatenationPlugin";
 
 class ModuleConcatenationPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -71,6 +73,7 @@ class ModuleConcatenationPlugin {
 			const bailoutReasonMap = new Map();
 
 			/**
+			 * Sets bailout reason.
 			 * @param {Module} module the module
 			 * @param {string | ((requestShortener: RequestShortener) => string)} reason the reason
 			 */
@@ -86,6 +89,7 @@ class ModuleConcatenationPlugin {
 			};
 
 			/**
+			 * Sets inner bailout reason.
 			 * @param {Module} module the module
 			 * @param {string | ((requestShortener: RequestShortener) => string)} reason the reason
 			 */
@@ -94,6 +98,7 @@ class ModuleConcatenationPlugin {
 			};
 
 			/**
+			 * Gets inner bailout reason.
 			 * @param {Module} module the module
 			 * @param {RequestShortener} requestShortener the request shortener
 			 * @returns {string | ((requestShortener: RequestShortener) => string) | undefined} the reason
@@ -105,6 +110,7 @@ class ModuleConcatenationPlugin {
 			};
 
 			/**
+			 * Format bailout warning.
 			 * @param {Module} module the module
 			 * @param {Problem} problem the problem
 			 * @returns {(requestShortener: RequestShortener) => string} the reason
@@ -521,6 +527,7 @@ class ModuleConcatenationPlugin {
 	}
 
 	/**
+	 * Returns the imported modules.
 	 * @param {Compilation} compilation the compilation
 	 * @param {Module} module the module to be added
 	 * @param {RuntimeSpec} runtime the runtime scope
@@ -562,6 +569,7 @@ class ModuleConcatenationPlugin {
 	}
 
 	/**
+	 * Returns the problematic module.
 	 * @param {Compilation} compilation webpack compilation
 	 * @param {ConcatConfiguration} config concat configuration (will be modified when added)
 	 * @param {Module} module the module to be added
@@ -613,6 +621,7 @@ class ModuleConcatenationPlugin {
 		].filter((chunk) => !chunkGraph.isModuleInChunk(module, chunk));
 		if (missingChunks.length > 0) {
 			/**
+			 * Returns problem description.
 			 * @param {RequestShortener} requestShortener request shortener
 			 * @returns {string} problem description
 			 */
@@ -656,6 +665,7 @@ class ModuleConcatenationPlugin {
 				);
 			if (activeNonModulesConnections.length > 0) {
 				/**
+				 * Returns problem description.
 				 * @param {RequestShortener} requestShortener request shortener
 				 * @returns {string} problem description
 				 */
@@ -722,6 +732,7 @@ class ModuleConcatenationPlugin {
 		});
 		if (otherChunkModules.length > 0) {
 			/**
+			 * Returns problem description.
 			 * @param {RequestShortener} requestShortener request shortener
 			 * @returns {string} problem description
 			 */
@@ -754,6 +765,7 @@ class ModuleConcatenationPlugin {
 		}
 		if (nonHarmonyConnections.size > 0) {
 			/**
+			 * Returns problem description.
 			 * @param {RequestShortener} requestShortener request shortener
 			 * @returns {string} problem description
 			 */
@@ -815,6 +827,7 @@ class ModuleConcatenationPlugin {
 			}
 			if (otherRuntimeConnections.length > 0) {
 				/**
+				 * Returns problem description.
 				 * @param {RequestShortener} requestShortener request shortener
 				 * @returns {string} problem description
 				 */
@@ -885,6 +898,7 @@ class ModuleConcatenationPlugin {
 
 class ConcatConfiguration {
 	/**
+	 * Creates an instance of ConcatConfiguration.
 	 * @param {Module} rootModule the root module
 	 * @param {RuntimeSpec} runtime the runtime
 	 */
@@ -901,6 +915,7 @@ class ConcatConfiguration {
 	}
 
 	/**
+	 * Processes the provided module.
 	 * @param {Module} module the module
 	 */
 	add(module) {
@@ -908,6 +923,7 @@ class ConcatConfiguration {
 	}
 
 	/**
+	 * Returns true, when the module is in the module set.
 	 * @param {Module} module the module
 	 * @returns {boolean} true, when the module is in the module set
 	 */
@@ -920,6 +936,7 @@ class ConcatConfiguration {
 	}
 
 	/**
+	 * Adds the provided module to the concat configuration.
 	 * @param {Module} module the module
 	 * @param {Problem} problem the problem
 	 */
@@ -928,6 +945,7 @@ class ConcatConfiguration {
 	}
 
 	/**
+	 * Gets warnings sorted.
 	 * @returns {Warnings} warnings
 	 */
 	getWarningsSorted() {
@@ -943,6 +961,7 @@ class ConcatConfiguration {
 	}
 
 	/**
+	 * Returns modules as set.
 	 * @returns {Set<Module>} modules as set
 	 */
 	getModules() {
@@ -954,6 +973,7 @@ class ConcatConfiguration {
 	}
 
 	/**
+	 * Processes the provided snapshot.
 	 * @param {number} snapshot snapshot
 	 */
 	rollback(snapshot) {

package/lib/optimize/RealContentHashPlugin.js

@@ -21,6 +21,7 @@ const createHash = require("../util/createHash");
 /** @typedef {typeof import("../util/Hash")} Hash */
 
 /**
+ * Defines the comparator type used by this module.
  * @template T
  * @typedef {import("../util/comparators").Comparator<T>} Comparator
  */
@@ -29,6 +30,7 @@ const createHash = require("../util/createHash");
 const EMPTY_SET = new Set();
 
 /**
+ * Adds the provided item or item to this object.
  * @template T
  * @param {T | T[]} itemOrItems item or items
  * @param {Set<T>} list list
@@ -44,6 +46,7 @@ const addToList = (itemOrItems, list) => {
 };
 
 /**
+ * Map and deduplicate buffers.
  * @template T
  * @param {T[]} input list
  * @param {(item: T) => Buffer} fn map function
@@ -76,6 +79,7 @@ const quoteMeta = (str) => str.replace(/[-[\]\\/{}()*+?.^$|]/g, "\\$&");
 const cachedSourceMap = new WeakMap();
 
 /**
+ * Returns cached source.
  * @param {Source} source source
  * @returns {CachedSource} cached source
  */
@@ -93,6 +97,7 @@ const toCachedSource = (source) => {
 /** @typedef {Set<string>} Hashes */
 
 /**
+ * Defines the asset info for real content hash type used by this module.
  * @typedef {object} AssetInfoForRealContentHash
  * @property {string} name
  * @property {AssetInfo} info
@@ -108,6 +113,7 @@ const toCachedSource = (source) => {
  */
 
 /**
+ * Defines the compilation hooks type used by this module.
  * @typedef {object} CompilationHooks
  * @property {SyncBailHook<[Buffer[], string], string | void>} updateHash
  */
@@ -116,6 +122,7 @@ const toCachedSource = (source) => {
 const compilationHooksMap = new WeakMap();
 
 /**
+ * Defines the real content hash plugin options type used by this module.
  * @typedef {object} RealContentHashPluginOptions
  * @property {HashFunction} hashFunction the hash function to use
  * @property {HashDigest} hashDigest the hash digest to use
@@ -125,6 +132,7 @@ const PLUGIN_NAME = "RealContentHashPlugin";
 
 class RealContentHashPlugin {
 	/**
+	 * Returns the attached hooks.
 	 * @param {Compilation} compilation the compilation
 	 * @returns {CompilationHooks} the attached hooks
 	 */
@@ -145,6 +153,7 @@ class RealContentHashPlugin {
 	}
 
 	/**
+	 * Creates an instance of RealContentHashPlugin.
 	 * @param {RealContentHashPluginOptions} options options
 	 */
 	constructor({ hashFunction, hashDigest }) {
@@ -155,7 +164,7 @@ class RealContentHashPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -247,6 +256,7 @@ class RealContentHashPlugin {
 						})
 					);
 					/**
+					 * Returns the referenced hashes.
 					 * @param {string} hash the hash
 					 * @returns {undefined | Hashes} the referenced hashes
 					 */
@@ -287,6 +297,7 @@ ${referencingAssets
 						return hashes;
 					};
 					/**
+					 * Returns the hash info.
 					 * @param {string} hash the hash
 					 * @returns {string} the hash info
 					 */
@@ -301,6 +312,7 @@ ${referencingAssets
 					const hashesInOrder = new Set();
 					for (const hash of hashToAssets.keys()) {
 						/**
+						 * Processes the provided hash.
 						 * @param {string} hash the hash
 						 * @param {Set<string>} stack stack of hashes
 						 */
@@ -329,6 +341,7 @@ ${referencingAssets
 					/** @type {Map<string, string>} */
 					const hashToNewHash = new Map();
 					/**
+					 * Returns etag.
 					 * @param {AssetInfoForRealContentHash} asset asset info
 					 * @returns {Etag} etag
 					 */
@@ -341,6 +354,7 @@ ${referencingAssets
 							).join("|")
 						);
 					/**
+					 * Compute new content.
 					 * @param {AssetInfoForRealContentHash} asset asset info
 					 * @returns {Promise<void>}
 					 */
@@ -370,6 +384,7 @@ ${referencingAssets
 						})());
 					};
 					/**
+					 * Compute new content without own.
 					 * @param {AssetInfoForRealContentHash} asset asset info
 					 * @returns {Promise<void>}
 					 */

package/lib/optimize/RemoveEmptyChunksPlugin.js

@@ -14,13 +14,14 @@ const PLUGIN_NAME = "RemoveEmptyChunksPlugin";
 
 class RemoveEmptyChunksPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
 	apply(compiler) {
 		compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
 			/**
+			 * Handles the hook callback for this code path.
 			 * @param {Iterable<Chunk>} chunks the chunks array
 			 * @returns {void}
 			 */

package/lib/optimize/RemoveParentModulesPlugin.js

@@ -63,12 +63,14 @@ const PLUGIN_NAME = "RemoveParentModulesPlugin";
 
 class RemoveParentModulesPlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler
 	 * @returns {void}
 	 */
 	apply(compiler) {
 		compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
 			/**
+			 * Handles the hook callback for this code path.
 			 * @param {Iterable<Chunk>} chunks the chunks
 			 * @param {ChunkGroup[]} chunkGroups the chunk groups
 			 */
@@ -86,7 +88,7 @@ class RemoveParentModulesPlugin {
 				const ordinalModules = [];
 
 				/**
-				 * Gets or creates a unique mask for a module
+				 * Gets or create module mask.
 				 * @param {Module} mod the module to get the mask for
 				 * @returns {bigint} the module mask to uniquely identify the module
 				 */

package/lib/optimize/RuntimeChunkPlugin.js

@@ -14,6 +14,7 @@ const PLUGIN_NAME = "RuntimeChunkPlugin";
 
 class RuntimeChunkPlugin {
 	/**
+	 * Creates an instance of RuntimeChunkPlugin.
 	 * @param {{ name?: RuntimeChunkFunction }=} options options
 	 */
 	constructor(options = {}) {
@@ -25,7 +26,7 @@ class RuntimeChunkPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/optimize/SideEffectsFlagPlugin.js

@@ -30,6 +30,7 @@ const formatLocation = require("../formatLocation");
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
 
 /**
+ * Defines the export in module type used by this module.
  * @typedef {object} ExportInModule
  * @property {Module} module the module
  * @property {string} exportName the name of the export
@@ -44,6 +45,7 @@ const formatLocation = require("../formatLocation");
 const globToRegexpCache = new WeakMap();
 
 /**
+ * Returns a regular expression.
  * @param {string} glob the pattern
  * @param {CacheItem} cache the glob to RegExp cache
  * @returns {RegExp} a regular expression
@@ -65,6 +67,7 @@ const PLUGIN_NAME = "SideEffectsFlagPlugin";
 
 class SideEffectsFlagPlugin {
 	/**
+	 * Creates an instance of SideEffectsFlagPlugin.
 	 * @param {boolean} analyseSource analyse source code for side effects
 	 */
 	constructor(analyseSource = true) {
@@ -73,7 +76,7 @@ class SideEffectsFlagPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -122,6 +125,7 @@ class SideEffectsFlagPlugin {
 				});
 				if (this._analyseSource) {
 					/**
+					 * Processes the provided parser.
 					 * @param {JavascriptParser} parser the parser
 					 * @returns {void}
 					 */
@@ -282,6 +286,7 @@ class SideEffectsFlagPlugin {
 						const optimizedModules = new Set();
 
 						/**
+						 * Optimize incoming connections.
 						 * @param {Module} module module
 						 */
 						const optimizeIncomingConnections = (module) => {
@@ -393,6 +398,7 @@ class SideEffectsFlagPlugin {
 	}
 
 	/**
+	 * Module has side effects.
 	 * @param {string} moduleName the module name
 	 * @param {SideEffectsFlagValue} flagValue the flag value
 	 * @param {CacheItem} cache cache for glob to regexp