webpack 5.106.1 → 5.107.0

package/lib/asset/AssetGenerator.js

@@ -17,6 +17,7 @@ const {
 	CSS_TYPE,
 	CSS_URL_TYPE,
 	CSS_URL_TYPES,
+	HTML_TYPE,
 	JAVASCRIPT_AND_CSS_URL_TYPES,
 	JAVASCRIPT_TYPE,
 	JAVASCRIPT_TYPES,
@@ -29,8 +30,9 @@ const createHash = require("../util/createHash");
 const { makePathsRelative } = require("../util/identifier");
 const memoize = require("../util/memoize");
 const nonNumericOnlyHash = require("../util/nonNumericOnlyHash");
+const { updateHashFromSource } = require("../util/source");
 
-const getMimeTypes = memoize(() => require("mime-types"));
+const getMimeTypes = memoize(() => require("../util/mimeTypes"));
 
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("../../declarations/WebpackOptions").AssetGeneratorDataUrlOptions} AssetGeneratorDataUrlOptions */
@@ -58,6 +60,7 @@ const getMimeTypes = memoize(() => require("mime-types"));
 /** @typedef {(source: string | Buffer, context: { filename: string, module: Module }) => string} DataUrlFunction */
 
 /**
+ * Merges maybe arrays.
  * @template T
  * @template U
  * @param {null | string | T[] | Set<T> | undefined} a a
@@ -75,6 +78,7 @@ const mergeMaybeArrays = (a, b) => {
 };
 
 /**
+ * Merges the provided values into a single result.
  * @param {AssetInfo} a a
  * @param {AssetInfo} b b
  * @returns {AssetInfo} object
@@ -115,6 +119,7 @@ const mergeAssetInfo = (a, b) => {
 };
 
 /**
+ * Merges related info.
  * @param {NonNullable<AssetInfo["related"]>} a a
  * @param {NonNullable<AssetInfo["related"]>} b b
  * @returns {NonNullable<AssetInfo["related"]>} object
@@ -131,6 +136,7 @@ const mergeRelatedInfo = (a, b) => {
 };
 
 /**
+ * Encodes the provided encoding.
  * @param {"base64" | false} encoding encoding
  * @param {Source} source source
  * @returns {string} encoded data
@@ -169,6 +175,7 @@ const encodeDataUri = (encoding, source) => {
 };
 
 /**
+ * Decodes data uri content.
  * @param {"base64" | false} encoding encoding
  * @param {string} content content
  * @returns {Buffer} decoded content
@@ -192,6 +199,7 @@ const DEFAULT_ENCODING = "base64";
 
 class AssetGenerator extends Generator {
 	/**
+	 * Creates an instance of AssetGenerator.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {AssetGeneratorOptions["dataUrl"]=} dataUrlOptions the options for the data url
 	 * @param {AssetModuleFilename=} filename override for output.assetModuleFilename
@@ -223,6 +231,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets source file name.
 	 * @param {NormalModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {string} source file name
@@ -237,6 +246,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets full content hash.
 	 * @param {NormalModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {[string, string]} return full hash and non-numeric full hash
@@ -251,7 +261,7 @@ class AssetGenerator extends Generator {
 		const source = module.originalSource();
 
 		if (source) {
-			hash.update(source.buffer());
+			updateHashFromSource(hash, source);
 		}
 
 		if (module.error) {
@@ -271,6 +281,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets filename with info.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {Pick<AssetResourceGeneratorOptions, "filename" | "outputPath">} generatorOptions generator options
 	 * @param {{ runtime: RuntimeSpec, runtimeTemplate: RuntimeTemplate, chunkGraph: ChunkGraph }} generateContext context for generate
@@ -322,6 +333,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets asset path with info.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {Pick<AssetResourceGeneratorOptions, "publicPath">} generatorOptions generator options
 	 * @param {GenerateContext} generateContext context for generate
@@ -388,7 +400,13 @@ class AssetGenerator extends Generator {
 				compilation.outputOptions.publicPath === "auto"
 					? CssUrlDependency.PUBLIC_PATH_AUTO
 					: compilation.getAssetPath(compilation.outputOptions.publicPath, {
-							hash: compilation.hash
+							hash:
+								compilation.hash ||
+								`${CssUrlDependency.PUBLIC_PATH_FULL_HASH}0__`,
+							hashWithLength: (length) =>
+								compilation.hash
+									? compilation.hash.slice(0, length)
+									: `${CssUrlDependency.PUBLIC_PATH_FULL_HASH}${length}__`
 						});
 
 			assetPath = path + filename;
@@ -401,6 +419,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the reason this module cannot be concatenated, when one exists.
 	 * @param {NormalModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
@@ -410,6 +429,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns mime type.
 	 * @param {NormalModule} module module
 	 * @returns {string} mime type
 	 */
@@ -420,7 +440,7 @@ class AssetGenerator extends Generator {
 			);
 		}
 
-		/** @type {string | boolean | undefined} */
+		/** @type {string | undefined} */
 		let mimeType =
 			/** @type {AssetGeneratorDataUrlOptions} */
 			(this.dataUrlOptions).mimetype;
@@ -462,6 +482,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Generates data uri.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @returns {string} DataURI
 	 */
@@ -522,6 +543,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Generates generated code for this runtime module.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
@@ -553,7 +575,7 @@ class AssetGenerator extends Generator {
 					: encodedSource;
 
 			if (data) {
-				data.set("url", { [type]: content, ...data.get("url") });
+				data.set("url", { ...data.get("url"), [type]: content });
 			}
 		} else {
 			const [fullContentHash, contentHash] = AssetGenerator.getFullContentHash(
@@ -592,7 +614,7 @@ class AssetGenerator extends Generator {
 				);
 
 			if (data && (type === JAVASCRIPT_TYPE || type === CSS_URL_TYPE)) {
-				data.set("url", { [type]: assetPath, ...data.get("url") });
+				data.set("url", { ...data.get("url"), [type]: assetPath });
 			}
 
 			if (data) {
@@ -643,6 +665,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
@@ -664,6 +687,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the source types available for this module.
 	 * @param {NormalModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
@@ -682,9 +706,12 @@ class AssetGenerator extends Generator {
 
 		if ((module.buildInfo && module.buildInfo.dataUrl) || this.emit === false) {
 			if (sourceTypes.size > 0) {
-				if (sourceTypes.has(JAVASCRIPT_TYPE) && sourceTypes.has(CSS_TYPE)) {
+				if (
+					sourceTypes.has(JAVASCRIPT_TYPE) &&
+					(sourceTypes.has(CSS_TYPE) || sourceTypes.has(HTML_TYPE))
+				) {
 					return JAVASCRIPT_AND_CSS_URL_TYPES;
-				} else if (sourceTypes.has(CSS_TYPE)) {
+				} else if (sourceTypes.has(CSS_TYPE) || sourceTypes.has(HTML_TYPE)) {
 					return CSS_URL_TYPES;
 				}
 				return JAVASCRIPT_TYPES;
@@ -694,9 +721,12 @@ class AssetGenerator extends Generator {
 		}
 
 		if (sourceTypes.size > 0) {
-			if (sourceTypes.has(JAVASCRIPT_TYPE) && sourceTypes.has(CSS_TYPE)) {
+			if (
+				sourceTypes.has(JAVASCRIPT_TYPE) &&
+				(sourceTypes.has(CSS_TYPE) || sourceTypes.has(HTML_TYPE))
+			) {
 				return ASSET_AND_JAVASCRIPT_AND_CSS_URL_TYPES;
-			} else if (sourceTypes.has(CSS_TYPE)) {
+			} else if (sourceTypes.has(CSS_TYPE) || sourceTypes.has(HTML_TYPE)) {
 				return ASSET_AND_CSS_URL_TYPES;
 			}
 			return ASSET_AND_JAVASCRIPT_TYPES;
@@ -706,6 +736,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {NormalModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module
@@ -742,6 +773,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash that will be modified
 	 * @param {UpdateHashContext} updateHashContext context for updating hash
 	 */

package/lib/asset/AssetModulesPlugin.js

@@ -29,11 +29,14 @@ const memoize = require("../util/memoize");
 /** @typedef {import("../NormalModule").NormalModuleCreateData} NormalModuleCreateData */
 
 /**
+ * Returns definition.
  * @param {string} name name of definitions
  * @returns {Schema} definition
  */
 const getSchema = (name) => {
-	const { definitions } = require("../../schemas/WebpackOptions.json");
+	const { definitions } =
+		/** @type {EXPECTED_ANY} */
+		(require("../../schemas/WebpackOptions.json"));
 
 	return {
 		definitions,
@@ -60,12 +63,14 @@ const type = ASSET_MODULE_TYPE;
 const PLUGIN_NAME = "AssetModulesPlugin";
 
 /**
+ * Represents the asset modules plugin runtime component.
  * @typedef {object} AssetModulesPluginOptions
  * @property {boolean=} sideEffectFree
  */
 
 class AssetModulesPlugin {
 	/**
+	 * Creates an instance of AssetModulesPlugin.
 	 * @param {AssetModulesPluginOptions} options options
 	 */
 	constructor(options) {
@@ -73,7 +78,7 @@ class AssetModulesPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/asset/AssetParser.js

@@ -19,6 +19,7 @@ const Parser = require("../Parser");
 
 class AssetParser extends Parser {
 	/**
+	 * Creates an instance of AssetParser.
 	 * @param {AssetParserOptions["dataUrlCondition"] | boolean} dataUrlCondition condition for inlining as DataUrl
 	 */
 	constructor(dataUrlCondition) {
@@ -28,6 +29,7 @@ class AssetParser extends Parser {
 	}
 
 	/**
+	 * Parses the provided source and updates the parser state.
 	 * @param {string | Buffer | PreparsedAst} source the source to parse
 	 * @param {ParserState} state the parser state
 	 * @returns {ParserState} the parser state

package/lib/asset/AssetSourceGenerator.js

@@ -12,6 +12,7 @@ const {
 	CSS_TYPE,
 	CSS_URL_TYPE,
 	CSS_URL_TYPES,
+	HTML_TYPE,
 	JAVASCRIPT_AND_CSS_URL_TYPES,
 	JAVASCRIPT_TYPE,
 	JAVASCRIPT_TYPES,
@@ -29,6 +30,7 @@ const RuntimeGlobals = require("../RuntimeGlobals");
 
 class AssetSourceGenerator extends Generator {
 	/**
+	 * Creates an instance of AssetSourceGenerator.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 */
 	constructor(moduleGraph) {
@@ -38,6 +40,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Generates generated code for this runtime module.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
@@ -96,6 +99,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
@@ -114,6 +118,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the reason this module cannot be concatenated, when one exists.
 	 * @param {NormalModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
@@ -123,6 +128,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the source types available for this module.
 	 * @param {NormalModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
@@ -140,9 +146,12 @@ class AssetSourceGenerator extends Generator {
 		}
 
 		if (sourceTypes.size > 0) {
-			if (sourceTypes.has(JAVASCRIPT_TYPE) && sourceTypes.has(CSS_TYPE)) {
+			if (
+				sourceTypes.has(JAVASCRIPT_TYPE) &&
+				(sourceTypes.has(CSS_TYPE) || sourceTypes.has(HTML_TYPE))
+			) {
 				return JAVASCRIPT_AND_CSS_URL_TYPES;
-			} else if (sourceTypes.has(CSS_TYPE)) {
+			} else if (sourceTypes.has(CSS_TYPE) || sourceTypes.has(HTML_TYPE)) {
 				return CSS_URL_TYPES;
 			}
 			return JAVASCRIPT_TYPES;
@@ -152,6 +161,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {NormalModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module

package/lib/asset/AssetSourceParser.js

@@ -14,6 +14,7 @@ const Parser = require("../Parser");
 
 class AssetSourceParser extends Parser {
 	/**
+	 * Parses the provided source and updates the parser state.
 	 * @param {string | Buffer | PreparsedAst} source the source to parse
 	 * @param {ParserState} state the parser state
 	 * @returns {ParserState} the parser state

package/lib/asset/RawDataUrlModule.js

@@ -36,6 +36,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class RawDataUrlModule extends Module {
 	/**
+	 * Creates an instance of RawDataUrlModule.
 	 * @param {string} url raw url
 	 * @param {string} identifier unique identifier
 	 * @param {string=} readableIdentifier readable identifier
@@ -53,6 +54,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns the source types this module can generate.
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
@@ -60,6 +62,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns the unique identifier used to reference this module.
 	 * @returns {string} a unique identifier of the module
 	 */
 	identifier() {
@@ -67,6 +70,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {string=} type the source type for which the size should be estimated
 	 * @returns {number} the estimated size of the module (must be non-zero)
 	 */
@@ -78,6 +82,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns a human-readable identifier for this module.
 	 * @param {RequestShortener} requestShortener the request shortener
 	 * @returns {string} a user readable identifier of the module
 	 */
@@ -88,6 +93,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Checks whether the module needs to be rebuilt for the current build state.
 	 * @param {NeedBuildContext} context context info
 	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
@@ -97,6 +103,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Builds the module using the provided compilation context.
 	 * @param {WebpackOptions} options webpack options
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
@@ -113,6 +120,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
@@ -138,6 +146,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash the hash used to track dependencies
 	 * @param {UpdateHashContext} context context
 	 * @returns {void}
@@ -148,6 +157,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -161,6 +171,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/async-modules/AsyncModuleHelpers.js

@@ -13,6 +13,7 @@ const HarmonyImportDependency = require("../dependencies/HarmonyImportDependency
 /** @typedef {Set<Module>} Modules */
 
 /**
+ * Gets outgoing async modules.
  * @param {ModuleGraph} moduleGraph module graph
  * @param {Module} module module
  * @returns {Modules} set of modules

package/lib/async-modules/AwaitDependenciesInitFragment.js

@@ -15,10 +15,12 @@ const Template = require("../Template");
 /** @typedef {Map<string, string>} Dependencies */
 
 /**
+ * Represents AwaitDependenciesInitFragment.
  * @extends {InitFragment<GenerateContext>}
  */
 class AwaitDependenciesInitFragment extends InitFragment {
 	/**
+	 * Creates an instance of AwaitDependenciesInitFragment.
 	 * @param {Dependencies} dependencies maps an import var to an async module that needs to be awaited
 	 */
 	constructor(dependencies) {
@@ -33,6 +35,7 @@ class AwaitDependenciesInitFragment extends InitFragment {
 	}
 
 	/**
+	 * Merges another await-dependencies fragment into this fragment.
 	 * @param {AwaitDependenciesInitFragment} other other AwaitDependenciesInitFragment
 	 * @returns {AwaitDependenciesInitFragment} AwaitDependenciesInitFragment
 	 */
@@ -45,6 +48,7 @@ class AwaitDependenciesInitFragment extends InitFragment {
 	}
 
 	/**
+	 * Returns the source code that will be included as initialization code.
 	 * @param {GenerateContext} context context
 	 * @returns {string | Source | undefined} the source code that will be included as initialization code
 	 */

package/lib/async-modules/InferAsyncModulesPlugin.js

@@ -14,7 +14,7 @@ const PLUGIN_NAME = "InferAsyncModulesPlugin";
 
 class InferAsyncModulesPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/buildChunkGraph.js

@@ -5,9 +5,8 @@
 
 "use strict";
 
-const AsyncDependencyToInitialChunkError = require("./AsyncDependencyToInitialChunkError");
-const { connectChunkGroupParentAndChild } = require("./GraphHelpers");
 const ModuleGraphConnection = require("./ModuleGraphConnection");
+const AsyncDependencyToInitialChunkError = require("./errors/AsyncDependencyToInitialChunkError");
 const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
 
 /** @typedef {import("./AsyncDependenciesBlock")} AsyncDependenciesBlock */
@@ -24,6 +23,7 @@ const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
 /**
+ * Defines the queue item type used by this module.
  * @typedef {object} QueueItem
  * @property {number} action
  * @property {DependenciesBlock} block
@@ -34,6 +34,7 @@ const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
  */
 
 /**
+ * Defines the chunk group info type used by this module.
  * @typedef {object} ChunkGroupInfo
  * @property {ChunkGroup} chunkGroup the chunk group
  * @property {RuntimeSpec} runtime the runtimes
@@ -55,6 +56,7 @@ const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
  */
 
 /**
+ * Defines the block chunk group connection type used by this module.
  * @typedef {object} BlockChunkGroupConnection
  * @property {ChunkGroupInfo} originChunkGroupInfo origin chunk group
  * @property {ChunkGroup} chunkGroup referenced chunk group
@@ -74,6 +76,7 @@ const ZERO_BIGINT = BigInt(0);
 const ONE_BIGINT = BigInt(1);
 
 /**
+ * Checks whether this object is ordinal set in mask.
  * @param {bigint} mask The mask to test
  * @param {number} ordinal The ordinal of the bit to test
  * @returns {boolean} If the ordinal-th bit is set in the mask
@@ -82,6 +85,7 @@ const isOrdinalSetInMask = (mask, ordinal) =>
 	BigInt.asUintN(1, mask >> BigInt(ordinal)) !== ZERO_BIGINT;
 
 /**
+ * Gets active state of connections.
  * @param {ModuleGraphConnection[]} connections list of connections
  * @param {RuntimeSpec} runtime for which runtime
  * @returns {ConnectionState} connection state
@@ -101,6 +105,7 @@ const getActiveStateOfConnections = (connections, runtime) => {
 };
 
 /**
+ * Extract block modules.
  * @param {Module} module module
  * @param {ModuleGraph} moduleGraph module graph
  * @param {RuntimeSpec} runtime runtime
@@ -237,6 +242,7 @@ const extractBlockModules = (module, moduleGraph, runtime, blockModulesMap) => {
 };
 
 /**
+ * Processes the provided logger.
  * @param {Logger} logger a logger
  * @param {Compilation} compilation the compilation
  * @param {InputEntrypointsAndModules} inputEntrypointsAndModules chunk groups which are processed with the modules
@@ -268,6 +274,7 @@ const visitModules = (
 	const ordinalByModule = new Map();
 
 	/**
+	 * Gets module ordinal.
 	 * @param {Module} module The module to look up
 	 * @returns {number} The ordinal of the module in masks
 	 */
@@ -289,6 +296,7 @@ const visitModules = (
 	}
 
 	/**
+	 * Gets block modules.
 	 * @param {DependenciesBlock} block block
 	 * @param {RuntimeSpec} runtime runtime
 	 * @returns {BlockModulesInFlattenTuples | undefined} block modules in flatten tuples
@@ -493,6 +501,7 @@ const visitModules = (
 
 	// For each async Block in graph
 	/**
+	 * Processes the provided b.
 	 * @param {AsyncDependenciesBlock} b iterating over each Async DepBlock
 	 * @returns {void}
 	 */
@@ -699,6 +708,7 @@ const visitModules = (
 	};
 
 	/**
+	 * Processes the provided block.
 	 * @param {DependenciesBlock} block the block
 	 * @returns {void}
 	 */
@@ -791,6 +801,7 @@ const visitModules = (
 	};
 
 	/**
+	 * Process entry block.
 	 * @param {DependenciesBlock} block the block
 	 * @returns {void}
 	 */
@@ -918,6 +929,7 @@ const visitModules = (
 	};
 
 	/**
+	 * Calculate resulting available modules.
 	 * @param {ChunkGroupInfo} chunkGroupInfo The info object for the chunk group
 	 * @returns {bigint} The mask of available modules after the chunk group
 	 */
@@ -1193,6 +1205,7 @@ const visitModules = (
 			let preOrderIndex = 0;
 			let postOrderIndex = 0;
 			/**
+			 * Processes the provided current.
 			 * @param {DependenciesBlock} current current
 			 * @param {BlocksWithNestedBlocks} visited visited dependencies blocks
 			 */
@@ -1240,6 +1253,7 @@ const visitModules = (
 };
 
 /**
+ * Connects chunk groups.
  * @param {Compilation} compilation the compilation
  * @param {BlocksWithNestedBlocks} blocksWithNestedBlocks flag for blocks that have nested blocks
  * @param {BlockConnections} blockConnections connection for blocks
@@ -1296,10 +1310,9 @@ const connectChunkGroups = (
 			chunkGraph.connectBlockAndChunkGroup(block, chunkGroup);
 
 			// 4. Connect chunk with parent
-			connectChunkGroupParentAndChild(
-				originChunkGroupInfo.chunkGroup,
-				chunkGroup
-			);
+			if (originChunkGroupInfo.chunkGroup.addChild(chunkGroup)) {
+				chunkGroup.addParent(originChunkGroupInfo.chunkGroup);
+			}
 		}
 	}
 };

package/lib/cache/AddBuildDependenciesPlugin.js

@@ -11,6 +11,7 @@ const PLUGIN_NAME = "AddBuildDependenciesPlugin";
 
 class AddBuildDependenciesPlugin {
 	/**
+	 * Creates an instance of AddBuildDependenciesPlugin.
 	 * @param {Iterable<string>} buildDependencies list of build dependencies
 	 */
 	constructor(buildDependencies) {
@@ -18,7 +19,7 @@ class AddBuildDependenciesPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/AddManagedPathsPlugin.js

@@ -9,6 +9,7 @@
 
 class AddManagedPathsPlugin {
 	/**
+	 * Creates an instance of AddManagedPathsPlugin.
 	 * @param {Iterable<string | RegExp>} managedPaths list of managed paths
 	 * @param {Iterable<string | RegExp>} immutablePaths list of immutable paths
 	 * @param {Iterable<string | RegExp>} unmanagedPaths list of unmanaged paths
@@ -20,7 +21,7 @@ class AddManagedPathsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/IdleFileCachePlugin.js

@@ -16,6 +16,7 @@ const PLUGIN_NAME = "IdleFileCachePlugin";
 
 class IdleFileCachePlugin {
 	/**
+	 * Creates an instance of IdleFileCachePlugin.
 	 * @param {PackFileCacheStrategy} strategy cache strategy
 	 * @param {number} idleTimeout timeout
 	 * @param {number} idleTimeoutForInitialStore initial timeout
@@ -34,7 +35,7 @@ class IdleFileCachePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */