webpack 5.106.1 → 5.107.0

package/lib/Compilation.js

@@ -21,42 +21,37 @@ const { MultiItemCache } = require("./CacheFacade");
 const Chunk = require("./Chunk");
 const ChunkGraph = require("./ChunkGraph");
 const ChunkGroup = require("./ChunkGroup");
-const ChunkRenderError = require("./ChunkRenderError");
 const ChunkTemplate = require("./ChunkTemplate");
-const CodeGenerationError = require("./CodeGenerationError");
 const CodeGenerationResults = require("./CodeGenerationResults");
 const Dependency = require("./Dependency");
 const DependencyTemplates = require("./DependencyTemplates");
 const Entrypoint = require("./Entrypoint");
 const ErrorHelpers = require("./ErrorHelpers");
 const FileSystemInfo = require("./FileSystemInfo");
-const {
-	connectChunkGroupAndChunk,
-	connectChunkGroupParentAndChild,
-	connectEntrypointAndDependOn
-} = require("./GraphHelpers");
-const {
-	makeWebpackError,
-	tryRunOrWebpackError
-} = require("./HookWebpackError");
 const MainTemplate = require("./MainTemplate");
 const Module = require("./Module");
-const ModuleDependencyError = require("./ModuleDependencyError");
-const ModuleDependencyWarning = require("./ModuleDependencyWarning");
 const ModuleGraph = require("./ModuleGraph");
-const ModuleHashingError = require("./ModuleHashingError");
-const ModuleNotFoundError = require("./ModuleNotFoundError");
 const ModuleProfile = require("./ModuleProfile");
-const ModuleRestoreError = require("./ModuleRestoreError");
-const ModuleStoreError = require("./ModuleStoreError");
 const ModuleTemplate = require("./ModuleTemplate");
 const { WEBPACK_MODULE_TYPE_RUNTIME } = require("./ModuleTypeConstants");
 const RuntimeGlobals = require("./RuntimeGlobals");
 const RuntimeTemplate = require("./RuntimeTemplate");
 const Stats = require("./Stats");
-const WebpackError = require("./WebpackError");
 const buildChunkGraph = require("./buildChunkGraph");
 const BuildCycleError = require("./errors/BuildCycleError");
+const ChunkRenderError = require("./errors/ChunkRenderError");
+const CodeGenerationError = require("./errors/CodeGenerationError");
+const {
+	makeWebpackError,
+	tryRunOrWebpackError
+} = require("./errors/HookWebpackError");
+const ModuleDependencyError = require("./errors/ModuleDependencyError");
+const ModuleDependencyWarning = require("./errors/ModuleDependencyWarning");
+const ModuleHashingError = require("./errors/ModuleHashingError");
+const ModuleNotFoundError = require("./errors/ModuleNotFoundError");
+const ModuleRestoreError = require("./errors/ModuleRestoreError");
+const ModuleStoreError = require("./errors/ModuleStoreError");
+const WebpackError = require("./errors/WebpackError");
 const { LogType, Logger } = require("./logging/Logger");
 const StatsFactory = require("./stats/StatsFactory");
 const StatsPrinter = require("./stats/StatsPrinter");
@@ -137,11 +132,13 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {import("./util/Hash")} Hash */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("tapable").AsArray<T>} AsArray<T>
  */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./util/deprecation").FakeHook<T>} FakeHook<T>
  */
@@ -149,12 +146,14 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
 
 /**
+ * Defines the callback callback.
  * @callback Callback
  * @param {(WebpackError | null)=} err
  * @returns {void}
  */
 
 /**
+ * Defines the module callback callback.
  * @callback ModuleCallback
  * @param {WebpackError | null=} err
  * @param {Module | null=} result
@@ -162,6 +161,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the module factory result callback callback.
  * @callback ModuleFactoryResultCallback
  * @param {WebpackError | null=} err
  * @param {ModuleFactoryResult | null=} result
@@ -169,6 +169,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the module or module factory result callback callback.
  * @callback ModuleOrModuleFactoryResultCallback
  * @param {WebpackError | null=} err
  * @param {Module | ModuleFactoryResult | null=} result
@@ -176,6 +177,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the execute module callback callback.
  * @callback ExecuteModuleCallback
  * @param {WebpackError | null=} err
  * @param {ExecuteModuleResult | null=} result
@@ -187,6 +189,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {Record<string, Source>} CompilationAssets */
 
 /**
+ * Defines the available modules chunk group mapping type used by this module.
  * @typedef {object} AvailableModulesChunkGroupMapping
  * @property {ChunkGroup} chunkGroup
  * @property {Set<Module>} availableModules
@@ -194,6 +197,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the dependencies block like type used by this module.
  * @typedef {object} DependenciesBlockLike
  * @property {Dependency[]} dependencies
  * @property {AsyncDependenciesBlock[]} blocks
@@ -202,6 +206,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {Set<Chunk>} Chunks */
 
 /**
+ * Defines the chunk path data type used by this module.
  * @typedef {object} ChunkPathData
  * @property {string | number} id
  * @property {string=} name
@@ -212,6 +217,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the chunk hash context type used by this module.
  * @typedef {object} ChunkHashContext
  * @property {CodeGenerationResults} codeGenerationResults results of code generation
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
@@ -220,12 +226,14 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the runtime requirements context type used by this module.
  * @typedef {object} RuntimeRequirementsContext
  * @property {ChunkGraph} chunkGraph the chunk graph
  * @property {CodeGenerationResults} codeGenerationResults the code generation results
  */
 
 /**
+ * Defines the execute module options type used by this module.
  * @typedef {object} ExecuteModuleOptions
  * @property {EntryOptions=} entryOptions
  */
@@ -235,6 +243,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {EXPECTED_ANY} ExecuteModuleExports */
 
 /**
+ * Defines the execute module result type used by this module.
  * @typedef {object} ExecuteModuleResult
  * @property {ExecuteModuleExports} exports
  * @property {boolean} cacheable
@@ -246,6 +255,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the execute module object type used by this module.
  * @typedef {object} ExecuteModuleObject
  * @property {string=} id module id
  * @property {ExecuteModuleExports} exports exports
@@ -254,6 +264,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the execute module argument type used by this module.
  * @typedef {object} ExecuteModuleArgument
  * @property {Module} module
  * @property {ExecuteModuleObject=} moduleObject
@@ -263,6 +274,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {((id: string) => ExecuteModuleExports) & { i?: ((options: ExecuteOptions) => void)[], c?: Record<string, ExecuteModuleObject> }} WebpackRequire */
 
 /**
+ * Defines the execute options type used by this module.
  * @typedef {object} ExecuteOptions
  * @property {string=} id module id
  * @property {ExecuteModuleObject} module module
@@ -272,6 +284,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {Map<string, { source: Source, info: AssetInfo | undefined }>} ExecuteModuleAssets */
 
 /**
+ * Defines the execute module context type used by this module.
  * @typedef {object} ExecuteModuleContext
  * @property {ExecuteModuleAssets} assets
  * @property {Chunk} chunk
@@ -280,6 +293,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the entry data type used by this module.
  * @typedef {object} EntryData
  * @property {Dependency[]} dependencies dependencies of the entrypoint that should be evaluated at startup
  * @property {Dependency[]} includeDependencies dependencies of the entrypoint that should be included but not evaluated
@@ -287,6 +301,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the log entry type used by this module.
  * @typedef {object} LogEntry
  * @property {keyof LogType} type
  * @property {EXPECTED_ANY[]=} args
@@ -295,6 +310,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
+ * Defines the known asset info type used by this module.
  * @typedef {object} KnownAssetInfo
  * @property {boolean=} immutable true, if the asset can be long term cached forever (contains a hash)
  * @property {boolean=} minimized whether the asset is minimized
@@ -316,6 +332,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {{ path: string, info: AssetInfo }} InterpolatedPathAndAssetInfo */
 
 /**
+ * Defines the asset type used by this module.
  * @typedef {object} Asset
  * @property {string} name the filename of the asset
  * @property {Source} source source of the asset
@@ -325,6 +342,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {(length: number) => string} HashWithLengthFunction */
 
 /**
+ * Defines the module path data type used by this module.
  * @typedef {object} ModulePathData
  * @property {string | number} id
  * @property {string} hash
@@ -334,6 +352,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {(id: string | number) => string | number} PrepareIdFunction */
 
 /**
+ * Defines the path data type used by this module.
  * @typedef {object} PathData
  * @property {ChunkGraph=} chunkGraph
  * @property {string=} hash
@@ -356,6 +375,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {"module" | "chunk" | "root-of-chunk" | "nested"} ExcludeModulesType */
 
 /**
+ * Defines the known normalized stats options type used by this module.
  * @typedef {object} KnownNormalizedStatsOptions
  * @property {string} context
  * @property {RequestShortener} requestShortener
@@ -400,6 +420,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {KnownNormalizedStatsOptions & Omit<StatsOptions, keyof KnownNormalizedStatsOptions> & Record<string, EXPECTED_ANY>} NormalizedStatsOptions */
 
 /**
+ * Defines the known create stats options context type used by this module.
  * @typedef {object} KnownCreateStatsOptionsContext
  * @property {boolean=} forToString
  */
@@ -422,6 +443,7 @@ const esmDependencyCategory = "esm";
 // TODO webpack 6: remove
 const deprecatedNormalModuleLoaderHook = util.deprecate(
 	/**
+	 * Handles the callback logic for this hook.
 	 * @param {Compilation} compilation compilation
 	 * @returns {NormalModuleCompilationHooks["loader"]} hooks
 	 */
@@ -433,6 +455,7 @@ const deprecatedNormalModuleLoaderHook = util.deprecate(
 
 // TODO webpack 6: remove
 /**
+ * Define removed module templates.
  * @param {ModuleTemplates | undefined} moduleTemplates module templates
  */
 const defineRemovedModuleTemplates = (moduleTemplates) => {
@@ -481,6 +504,7 @@ const byLocation = compareSelect((err) => err.loc, compareLocations);
 const compareErrors = concatComparators(byModule, byLocation, byMessage);
 
 /**
+ * Defines the known unsafe cache data type used by this module.
  * @typedef {object} KnownUnsafeCacheData
  * @property {FactoryMeta=} factoryMeta factory meta
  * @property {ResolveOptions=} resolveOptions resolve options
@@ -491,6 +515,7 @@ const compareErrors = concatComparators(byModule, byLocation, byMessage);
 /** @typedef {KnownUnsafeCacheData & Record<string, EXPECTED_ANY>} UnsafeCacheData */
 
 /**
+ * Defines the module with restore from unsafe cache type used by this module.
  * @typedef {Module & { restoreFromUnsafeCache?: (unsafeCacheData: UnsafeCacheData, moduleFactory: ModuleFactory, compilationParams: CompilationParams) => void }} ModuleWithRestoreFromUnsafeCache
  */
 
@@ -522,6 +547,7 @@ class Compilation {
 		/** @type {Set<string>} */
 		let savedAssets = new Set();
 		/**
+		 * Returns new assets.
 		 * @param {CompilationAssets} assets assets
 		 * @returns {CompilationAssets} new assets
 		 */
@@ -554,6 +580,7 @@ class Compilation {
 				/** @type {ProcessedAssets | undefined} */
 				const processedAssets = additionalAssetsFn ? new WeakSet() : undefined;
 				/**
+				 * Gets available assets.
 				 * @param {CompilationAssets} assets to be processed by additionalAssetsFn
 				 * @returns {CompilationAssets} available assets
 				 */
@@ -584,6 +611,7 @@ class Compilation {
 							...remainingTap,
 							type: "async",
 							/**
+							 * Processes the provided asset.
 							 * @param {CompilationAssets} assets assets
 							 * @param {(err?: Error | null, result?: void) => void} callback callback
 							 * @returns {void}
@@ -629,6 +657,7 @@ class Compilation {
 						return {
 							...remainingTap,
 							/**
+							 * Processes the provided asset.
 							 * @param {CompilationAssets} assets assets
 							 * @param {(err?: Error | null, result?: void) => void} callback callback
 							 * @returns {void}
@@ -637,6 +666,7 @@ class Compilation {
 								fn(
 									assets,
 									/**
+									 * Handles the callback logic for this hook.
 									 * @param {Error} err err
 									 * @returns {void}
 									 */
@@ -673,6 +703,7 @@ class Compilation {
 						return {
 							...remainingTap,
 							/**
+							 * Returns result.
 							 * @param {CompilationAssets} assets assets
 							 * @returns {Promise<CompilationAssets>} result
 							 */
@@ -700,6 +731,7 @@ class Compilation {
 		const afterProcessAssetsHook = new SyncHook(["assets"]);
 
 		/**
+		 * Creates a process assets hook.
 		 * @template T
 		 * @param {string} name name of the hook
 		 * @param {number} stage new stage
@@ -710,6 +742,7 @@ class Compilation {
 		const createProcessAssetsHook = (name, stage, getArgs, code) => {
 			if (!this._backCompat && code) return;
 			/**
+			 * Returns error message.
 			 * @param {string} reason reason
 			 * @returns {string} error message
 			 */
@@ -718,6 +751,7 @@ class Compilation {
 			) => `Can't automatically convert plugin using Compilation.hooks.${name} to Compilation.hooks.processAssets because ${reason}.
 BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a single Compilation.hooks.processAssets hook.`;
 			/**
+			 * Normalizes tap options for migrated process-assets hooks.
 			 * @param {string | (import("tapable").TapOptions & { name: string } & ProcessAssetsAdditionalOptions)} options hook options
 			 * @returns {import("tapable").TapOptions & { name: string } & ProcessAssetsAdditionalOptions} modified options
 			 */
@@ -1042,6 +1076,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			statsPrinter: new SyncHook(["statsPrinter", "options"]),
 
 			/**
+			 * Gets normal module loader.
 			 * @deprecated
 			 * @returns {SyncHook<[AnyLoaderContext, NormalModule]>} normal module loader hook
 			 */
@@ -1259,6 +1294,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		this.compilationDependencies = {
 			add: util.deprecate(
 				/**
+				 * Handles the add callback for this hook.
 				 * @param {string} item item
 				 * @returns {FileSystemDependencies} file dependencies
 				 */
@@ -1285,6 +1321,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Creates a stats options.
 	 * @param {string | boolean | StatsOptions | undefined} optionsOrPreset stats option value
 	 * @param {CreateStatsOptionsContext=} context context
 	 * @returns {NormalizedStatsOptions} normalized options
@@ -1318,6 +1355,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Creates a stats factory.
 	 * @param {NormalizedStatsOptions} options options
 	 * @returns {StatsFactory} the stats factory
 	 */
@@ -1328,6 +1366,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Creates a stats printer.
 	 * @param {NormalizedStatsOptions} options options
 	 * @returns {StatsPrinter} the stats printer
 	 */
@@ -1338,6 +1377,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Returns the cache facade instance.
 	 * @param {string} name cache name
 	 * @returns {CacheFacade} the cache facade instance
 	 */
@@ -1346,6 +1386,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Returns a logger with that name.
 	 * @param {string | (() => string)} name name of the logger, or function called once to get the logger name
 	 * @returns {Logger} a logger with that name
 	 */
@@ -1471,6 +1512,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided module to the compilation.
 	 * @param {Module} module module to be added that was created
 	 * @param {ModuleCallback} callback returns the module in the compilation,
 	 * it could be the passed one (if new), or an already existing in the compilation
@@ -1481,6 +1523,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided module to the compilation.
 	 * @param {Module} module module to be added that was created
 	 * @param {ModuleCallback} callback returns the module in the compilation,
 	 * it could be the passed one (if new), or an already existing in the compilation
@@ -1630,6 +1673,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Process module dependencies.
 	 * @param {Module} module to be processed for deps
 	 * @param {ModuleCallback} callback callback to be triggered
 	 * @returns {void}
@@ -1639,11 +1683,13 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Process module dependencies non recursive.
 	 * @param {Module} module to be processed for deps
 	 * @returns {void}
 	 */
 	processModuleDependenciesNonRecursive(module) {
 		/**
+		 * Process dependencies block.
 		 * @param {DependenciesBlock} block block
 		 */
 		const processDependenciesBlock = (block) => {
@@ -1662,6 +1708,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Process module dependencies.
 	 * @param {Module} module to be processed for deps
 	 * @param {ModuleCallback} callback callback to be triggered
 	 * @returns {void}
@@ -1697,6 +1744,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		let inProgressTransitive = 1;
 
 		/**
+		 * On dependencies sorted.
 		 * @param {WebpackError=} err error
 		 * @returns {void}
 		 */
@@ -1733,6 +1781,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		};
 
 		/**
+		 * On transitive tasks finished.
 		 * @param {WebpackError=} err error
 		 * @returns {void}
 		 */
@@ -1744,6 +1793,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		};
 
 		/**
+		 * Process dependency.
 		 * @param {Dependency} dep dependency
 		 * @param {number} index index in block
 		 * @returns {void}
@@ -1855,6 +1905,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		};
 
 		/**
+		 * Process dependency for resolving.
 		 * @param {Dependency} dep dependency
 		 * @returns {void}
 		 */
@@ -1973,6 +2024,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Handle new module from unsafe cache.
 	 * @private
 	 * @param {Module} originModule original module
 	 * @param {Dependency} dependency dependency
@@ -2005,6 +2057,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Handle existing module from unsafe cache.
 	 * @private
 	 * @param {Module} originModule original modules
 	 * @param {Dependency} dependency dependency
@@ -2017,6 +2070,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Processes the provided factorize module option.
 	 * @param {FactorizeModuleOptions} options options
 	 * @param {ModuleOrModuleFactoryResultCallback} callback callback
 	 * @returns {void}
@@ -2103,18 +2157,21 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Processes the provided module callback.
 	 * @overload
 	 * @param {FactorizeModuleOptions & { factoryResult?: false }} options options
 	 * @param {ModuleCallback} callback callback
 	 * @returns {void}
 	 */
 	/**
+	 * Processes the provided module factory result callback.
 	 * @overload
 	 * @param {FactorizeModuleOptions & { factoryResult: true }} options options
 	 * @param {ModuleFactoryResultCallback} callback callback
 	 * @returns {void}
 	 */
 	/**
+	 * Processes the provided |.
 	 * @param {FactorizeModuleOptions & { factoryResult?: false } | FactorizeModuleOptions & { factoryResult: true }} options options
 	 * @param {ModuleCallback | ModuleFactoryResultCallback} callback callback
 	 */
@@ -2127,6 +2184,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Defines the handle module creation options type used by this module.
 	 * @typedef {object} HandleModuleCreationOptions
 	 * @property {ModuleFactory} factory
 	 * @property {Dependency[]} dependencies
@@ -2139,6 +2197,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	 */
 
 	/**
+	 * Handle module creation.
 	 * @param {HandleModuleCreationOptions} options options object
 	 * @param {ModuleCallback} callback callback
 	 * @returns {void}
@@ -2283,6 +2342,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Handle module build and dependencies.
 	 * @private
 	 * @param {Module | null} originModule original module
 	 * @param {Module} module module
@@ -2375,6 +2435,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided string to the compilation.
 	 * @param {string} context context string path
 	 * @param {Dependency} dependency dependency used to create Module chain
 	 * @param {ModuleCallback} callback callback for when module chain is complete
@@ -2385,6 +2446,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided object to the compilation.
 	 * @param {object} options options
 	 * @param {string} options.context context string path
 	 * @param {Dependency} options.dependency dependency used to create Module chain
@@ -2439,6 +2501,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided string to the compilation.
 	 * @param {string} context context path for entry
 	 * @param {Dependency} entry entry dependency that should be followed
 	 * @param {string | EntryOptions} optionsOrName options or deprecated name of entry
@@ -2456,6 +2519,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided string to the compilation.
 	 * @param {string} context context path for entry
 	 * @param {Dependency} dependency dependency that should be followed
 	 * @param {EntryOptions} options options
@@ -2473,6 +2537,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Adds the provided string to the compilation.
 	 * @param {string} context context path for entry
 	 * @param {Dependency} entry entry dependency that should be followed
 	 * @param {"dependencies" | "includeDependencies"} target type of entry
@@ -2553,6 +2618,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Processes the provided module.
 	 * @param {Module} module module to be rebuilt
 	 * @param {ModuleCallback} callback callback when module finishes rebuilding
 	 * @returns {void}
@@ -2562,6 +2628,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Processes the provided module.
 	 * @param {Module} module module to be rebuilt
 	 * @param {ModuleCallback} callback callback when module finishes rebuilding
 	 * @returns {void}
@@ -2607,6 +2674,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Compute affected modules.
 	 * @private
 	 * @param {Set<Module>} modules modules
 	 */
@@ -2629,6 +2697,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		let statWithoutBuild = 0;
 
 		/**
+		 * Compute references.
 		 * @param {Module} module module
 		 * @returns {WeakReferences | undefined} references
 		 */
@@ -2646,6 +2715,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		};
 
 		/**
+		 * Compares references.
 		 * @param {Module} module the module
 		 * @param {WeakReferences | undefined} references references
 		 * @returns {boolean} true, when the references differ
@@ -2722,6 +2792,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		}
 
 		/**
+		 * Reduce affect type.
 		 * @param {Readonly<ModuleGraphConnection[]>} connections connections
 		 * @returns {symbol | boolean} result
 		 */
@@ -2804,6 +2875,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		let statChanged = 0;
 		let statNew = 0;
 		/**
+		 * Compute references.
 		 * @param {Module} module module
 		 * @returns {References} references
 		 */
@@ -2840,6 +2912,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			return { id, modules, blocks };
 		};
 		/**
+		 * Compares references.
 		 * @param {Module} module module
 		 * @param {object} references references
 		 * @param {string | number} references.id id
@@ -2907,6 +2980,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Processes the provided callback.
 	 * @param {Callback} callback callback
 	 */
 	finish(callback) {
@@ -2966,6 +3040,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			const logger = this.getLogger("webpack.Compilation.ModuleProfile");
 			// Avoid coverage problems due indirect changes
 			/**
+			 * Processes the provided value.
 			 * @param {number} value value
 			 * @param {string} msg message
 			 */
@@ -2984,6 +3059,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 				}
 			};
 			/**
+			 * Log normal summary.
 			 * @param {string} category a category
 			 * @param {(profile: ModuleProfile) => number} getDuration get duration callback
 			 * @param {(profile: ModuleProfile) => number} getParallelism get parallelism callback
@@ -3013,6 +3089,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 				);
 			};
 			/**
+			 * Log by loaders summary.
 			 * @param {string} category a category
 			 * @param {(profile: ModuleProfile) => number} getDuration get duration callback
 			 * @param {(profile: ModuleProfile) => number} getParallelism get parallelism callback
@@ -3132,7 +3209,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 				let hasProblems = this.reportDependencyErrorsAndWarnings(module, [
 					module
 				]);
-				const errors = module.getErrors();
+				const errors = /** @type {WebpackError[]} */ (module.getErrors());
 				if (errors !== undefined) {
 					for (const error of errors) {
 						if (!error.module) {
@@ -3142,7 +3219,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 						hasProblems = true;
 					}
 				}
-				const warnings = module.getWarnings();
+				const warnings = /** @type {WebpackError[]} */ (module.getWarnings());
 				if (warnings !== undefined) {
 					for (const warning of warnings) {
 						if (!warning.module) {
@@ -3177,11 +3254,13 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
+	 * Processes the provided callback.
 	 * @param {Callback} callback signals when the call finishes
 	 * @returns {void}
 	 */
 	seal(callback) {
 		/**
+		 * Processes the provided err.
 		 * @param {WebpackError=} err err
 		 * @returns {void}
 		 */
@@ -3228,7 +3307,10 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			this.namedChunkGroups.set(name, entrypoint);
 			this.entrypoints.set(name, entrypoint);
 			this.chunkGroups.push(entrypoint);
-			connectChunkGroupAndChunk(entrypoint, chunk);
+
+			if (entrypoint.pushChunk(chunk)) {
+				chunk.addGroup(entrypoint);
+			}
 
 			/** @type {Set<Module>} */
 			const entryModules = new Set();
@@ -3256,6 +3338,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			this.assignDepths(entryModules);
 
 			/**
+			 * Returns sorted deps.
 			 * @param {Dependency[]} deps deps
 			 * @returns {Module[]} sorted deps
 			 */
@@ -3318,8 +3401,12 @@ Remove the 'runtime' option from the entrypoint.`);
 						entry.setRuntimeChunk(entryChunk);
 						continue outer;
 					}
-					connectEntrypointAndDependOn(entry, dependency);
-					connectChunkGroupParentAndChild(dependency, entry);
+
+					entry.addDependOn(dependency);
+
+					if (dependency.addChild(entry)) {
+						entry.addParent(dependency);
+					}
 				}
 			} else if (runtime) {
 				const entry = /** @type {Entrypoint} */ (this.entrypoints.get(name));
@@ -3556,6 +3643,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Report dependency errors and warnings.
 	 * @param {Module} module module to report from
 	 * @param {DependenciesBlock[]} blocks blocks to report from
 	 * @returns {boolean} true, when it has warnings or errors
@@ -3592,6 +3680,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {Callback} callback callback
 	 */
 	codeGeneration(callback) {
@@ -3629,6 +3718,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Run code generation jobs.
 	 * @private
 	 * @param {CodeGenerationJobs} jobs code generation jobs
 	 * @param {Callback} callback callback
@@ -3738,6 +3828,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Code generation module.
 	 * @param {Module} module module
 	 * @param {RuntimeSpec} runtime runtime
 	 * @param {RuntimeSpec[]} runtimes runtimes
@@ -3830,6 +3921,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Process runtime requirements.
 	 * @param {object} options options
 	 * @param {ChunkGraph=} options.chunkGraph the chunk graph
 	 * @param {Iterable<Module>=} options.modules modules
@@ -3973,6 +4065,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 
 	// TODO webpack 6 make chunkGraph argument non-optional
 	/**
+	 * Adds runtime module.
 	 * @param {Chunk} chunk target chunk
 	 * @param {RuntimeModule} module runtime module
 	 * @param {ChunkGraph} chunkGraph the chunk graph
@@ -4065,7 +4158,9 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 		}
 		const chunk = this.addChunk(name);
 
-		connectChunkGroupAndChunk(chunkGroup, chunk);
+		if (chunkGroup.pushChunk(chunk)) {
+			chunk.addGroup(chunkGroup);
+		}
 
 		this.chunkGroups.push(chunkGroup);
 		if (name) {
@@ -4075,6 +4170,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Adds the provided async entrypoint to this chunk group.
 	 * @param {EntryOptions} options options for the entrypoint
 	 * @param {Module} module the module the references the chunk group
 	 * @param {DependencyLocation} loc the location from with the chunk group is referenced (inside of module)
@@ -4108,7 +4204,9 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 		}
 		this.chunkGroups.push(entrypoint);
 		this.asyncEntrypoints.push(entrypoint);
-		connectChunkGroupAndChunk(entrypoint, chunk);
+		if (entrypoint.pushChunk(chunk)) {
+			chunk.addGroup(entrypoint);
+		}
 		if (module) {
 			entrypoint.addOrigin(module, loc, request);
 		}
@@ -4140,6 +4238,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Processes the provided module.
 	 * @deprecated
 	 * @param {Module} module module to assign depth
 	 * @returns {void}
@@ -4154,6 +4253,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 		moduleGraph.setDepth(module, 0);
 
 		/**
+		 * Processes the provided module.
 		 * @param {Module} module module for processing
 		 * @returns {void}
 		 */
@@ -4176,7 +4276,8 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
-	 * @param {Module[] | Set<Module>} modules module to assign depth
+	 * Assigns depth values to the provided modules.
+	 * @param {Module[] | Set<Module>} modules modules to assign depth
 	 * @returns {void}
 	 */
 	assignDepths(modules) {
@@ -4210,6 +4311,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Gets dependency referenced exports.
 	 * @param {Dependency} dependency the dependency
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @returns {ReferencedExports} referenced exports
@@ -4227,6 +4329,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Removes reasons of dependency block.
 	 * @param {Module} module module relationship for removal
 	 * @param {DependenciesBlockLike} block dependencies block
 	 * @returns {void}
@@ -4257,6 +4360,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Patch chunks after reason removal.
 	 * @param {Module} module module to patch tie
 	 * @param {Chunk} chunk chunk to patch tie
 	 * @returns {void}
@@ -4275,12 +4379,14 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Removes chunk from dependencies.
 	 * @param {DependenciesBlock} block block tie for Chunk
 	 * @param {Chunk} chunk chunk to remove from dep
 	 * @returns {void}
 	 */
 	removeChunkFromDependencies(block, chunk) {
 		/**
+		 * Iterator dependency.
 		 * @param {Dependency} d dependency to (maybe) patch up
 		 */
 		const iteratorDependency = (d) => {
@@ -4314,6 +4420,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	assignRuntimeIds() {
 		const { chunkGraph } = this;
 		/**
+		 * Process entrypoint.
 		 * @param {Entrypoint} ep an entrypoint
 		 */
 		const processEntrypoint = (ep) => {
@@ -4416,6 +4523,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
+	 * Create module hash.
 	 * @private
 	 * @param {Module} module module
 	 * @param {ChunkGraph} chunkGraph the chunk graph
@@ -4630,6 +4738,7 @@ This prevents using hashes of each other and should be avoided.`);
 		const errors = [];
 
 		/**
+		 * Processes the provided chunk.
 		 * @param {Chunk} chunk chunk
 		 */
 		const processChunk = (chunk) => {
@@ -4762,6 +4871,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Processes the provided file.
 	 * @param {string} file file name
 	 * @param {Source} source asset source
 	 * @param {AssetInfo} assetInfo extra asset information
@@ -4793,6 +4903,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Processes the provided file.
 	 * @private
 	 * @param {string} file file name
 	 * @param {AssetInfo=} newInfo new asset information
@@ -4809,6 +4920,7 @@ This prevents using hashes of each other and should be avoided.`);
 		if (oldRelated) {
 			for (const key of Object.keys(oldRelated)) {
 				/**
+				 * Processes the provided name.
 				 * @param {string} name name
 				 */
 				const remove = (name) => {
@@ -4834,6 +4946,7 @@ This prevents using hashes of each other and should be avoided.`);
 		if (newRelated) {
 			for (const key of Object.keys(newRelated)) {
 				/**
+				 * Processes the provided name.
 				 * @param {string} name name
 				 */
 				const add = (name) => {
@@ -4860,6 +4973,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Updates asset using the provided file.
 	 * @param {string} file file name
 	 * @param {Source | ((source: Source) => Source)} newSourceOrFunction new asset source or function converting old to new
 	 * @param {(AssetInfo | ((assetInfo?: AssetInfo) => AssetInfo | undefined)) | undefined} assetInfoUpdateOrFunction new asset info or function converting old to new
@@ -4893,6 +5007,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Processes the provided file.
 	 * @param {string} file file name
 	 * @param {string} newFile the new name of file
 	 */
@@ -4963,6 +5078,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Processes the provided file.
 	 * @param {string} file file name
 	 */
 	deleteAsset(file) {
@@ -4976,6 +5092,7 @@ This prevents using hashes of each other and should be avoided.`);
 		if (related) {
 			for (const key of Object.keys(related)) {
 				/**
+				 * Checks used and delete.
 				 * @param {string} file file
 				 */
 				const checkUsedAndDelete = (file) => {
@@ -5017,6 +5134,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Returns the asset or undefined when not found.
 	 * @param {string} name the name of the asset
 	 * @returns {Readonly<Asset> | undefined} the asset or undefined when not found
 	 */
@@ -5062,6 +5180,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Gets render manifest.
 	 * @param {RenderManifestOptions} options options object
 	 * @returns {RenderManifestEntry[]} manifest entries
 	 */
@@ -5070,6 +5189,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Creates a chunk assets.
 	 * @param {Callback} callback signals when the call finishes
 	 * @returns {void}
 	 */
@@ -5128,6 +5248,7 @@ This prevents using hashes of each other and should be avoided.`);
 
 							let inTry = true;
 							/**
+							 * Error and callback.
 							 * @param {Error} err error
 							 * @returns {void}
 							 */
@@ -5235,6 +5356,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Returns interpolated path.
 	 * @param {TemplatePath} filename used to get asset path with hash
 	 * @param {PathData} data context data
 	 * @returns {string} interpolated path
@@ -5250,6 +5372,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Gets path with info.
 	 * @param {TemplatePath} filename used to get asset path with hash
 	 * @param {PathData} data context data
 	 * @returns {InterpolatedPathAndAssetInfo} interpolated path and asset info
@@ -5265,6 +5388,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Returns interpolated path.
 	 * @param {TemplatePath} filename used to get asset path with hash
 	 * @param {PathData} data context data
 	 * @returns {string} interpolated path
@@ -5278,6 +5402,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Gets asset path with info.
 	 * @param {TemplatePath} filename used to get asset path with hash
 	 * @param {PathData} data context data
 	 * @returns {InterpolatedPathAndAssetInfo} interpolated path and asset info
@@ -5323,6 +5448,7 @@ This prevents using hashes of each other and should be avoided.`);
 	}
 
 	/**
+	 * Processes the provided module.
 	 * @param {Module} module the module
 	 * @param {ExecuteModuleOptions} options options
 	 * @param {ExecuteModuleCallback} callback callback
@@ -5373,7 +5499,9 @@ This prevents using hashes of each other and should be avoided.`);
 					...options.entryOptions
 				});
 				chunkGraph.connectChunkAndEntryModule(chunk, module, entrypoint);
-				connectChunkGroupAndChunk(entrypoint, chunk);
+				if (entrypoint.pushChunk(chunk)) {
+					chunk.addGroup(entrypoint);
+				}
 				entrypoint.setRuntimeChunk(chunk);
 				entrypoint.setEntrypointChunk(chunk);
 
@@ -5407,6 +5535,7 @@ This prevents using hashes of each other and should be avoided.`);
 					this.outputOptions.hashFunction
 				);
 				/**
+				 * Processes the provided module.
 				 * @param {Module} module the module
 				 * @param {Callback} callback callback
 				 * @returns {void}
@@ -5617,6 +5746,7 @@ This prevents using hashes of each other and should be avoided.`);
 											context.__webpack_require__ = __webpack_require__;
 
 											/**
+											 * Webpack require module.
 											 * @param {ExecuteModuleArgument} moduleArgument the module argument
 											 * @param {string=} id id
 											 * @returns {ExecuteModuleExports} exports
@@ -5759,6 +5889,7 @@ This prevents using hashes of each other and should be avoided.`);
 }
 
 /**
+ * Defines the factorize module options type used by this module.
  * @typedef {object} FactorizeModuleOptions
  * @property {ModuleProfile=} currentProfile
  * @property {ModuleFactory} factory
@@ -5770,6 +5901,7 @@ This prevents using hashes of each other and should be avoided.`);
  */
 
 /**
+ * Processes the provided factorize module option.
  * @param {FactorizeModuleOptions} options options object
  * @param {ModuleCallback | ModuleFactoryResultCallback} callback callback
  * @returns {void}
@@ -5796,6 +5928,7 @@ Object.defineProperty(compilationPrototype, "cache", {
 	configurable: false,
 	get: util.deprecate(
 		/**
+		 * Returns the cache.
 		 * @this {Compilation} the compilation
 		 * @returns {Cache} the cache
 		 */
@@ -5807,6 +5940,7 @@ Object.defineProperty(compilationPrototype, "cache", {
 	),
 	set: util.deprecate(
 		/**
+		 * Handles the value callback for this hook.
 		 * @param {EXPECTED_ANY} _v value
 		 */
 		(_v) => {},