webpack 5.106.1 → 5.106.2

package/lib/esm/ModuleChunkLoadingRuntimeModule.js

@@ -25,6 +25,7 @@ const { getUndoPath } = require("../util/identifier");
 /** @typedef {import("../Module").ReadOnlyRuntimeRequirements} ReadOnlyRuntimeRequirements */
 
 /**
+ * Defines the jsonp compilation plugin hooks type used by this module.
  * @typedef {object} JsonpCompilationPluginHooks
  * @property {SyncWaterfallHook<[string, Chunk]>} linkPreload
  * @property {SyncWaterfallHook<[string, Chunk]>} linkPrefetch
@@ -35,6 +36,7 @@ const compilationHooksMap = new WeakMap();
 
 class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	/**
+	 * Returns hooks.
 	 * @param {Compilation} compilation the compilation
 	 * @returns {JsonpCompilationPluginHooks} hooks
 	 */
@@ -56,6 +58,7 @@ class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Creates an instance of ModuleChunkLoadingRuntimeModule.
 	 * @param {ReadOnlyRuntimeRequirements} runtimeRequirements runtime requirements
 	 */
 	constructor(runtimeRequirements) {
@@ -65,6 +68,7 @@ class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Returns generated code.
 	 * @private
 	 * @param {Chunk} chunk chunk
 	 * @param {string} rootOutputDir root output directory
@@ -85,6 +89,7 @@ class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/formatLocation.js

@@ -9,6 +9,7 @@
 /** @typedef {import("./Dependency").SourcePosition} SourcePosition */
 
 /**
+ * Returns formatted position.
  * @param {SourcePosition} pos position
  * @returns {string} formatted position
  */
@@ -24,6 +25,7 @@ const formatPosition = (pos) => {
 };
 
 /**
+ * Returns formatted location.
  * @param {DependencyLocation} loc location
  * @returns {string} formatted location
  */

package/lib/hmr/HotModuleReplacementRuntimeModule.js

@@ -15,6 +15,7 @@ class HotModuleReplacementRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/hmr/JavascriptHotModuleReplacementHelper.js

@@ -10,6 +10,7 @@ const RuntimeGlobals = require("../RuntimeGlobals");
 const Template = require("../Template");
 
 /**
+ * Generates javascript hmr.
  * @param {string} type unique identifier used for HMR runtime properties
  * @returns {string} HMR runtime code
  */

package/lib/hmr/LazyCompilationPlugin.js

@@ -46,6 +46,7 @@ const { registerNotSerializable } = require("../util/serialization");
 /** @typedef {{ client: string, data: string, active: boolean }} ModuleResult */
 
 /**
+ * Defines the backend api type used by this module.
  * @typedef {object} BackendApi
  * @property {(callback: (err?: (Error | null)) => void) => void} dispose
  * @property {(module: Module) => ModuleResult} module
@@ -59,6 +60,7 @@ const HMR_DEPENDENCY_TYPES = new Set([
 ]);
 
 /**
+ * Checks true, if the module should be selected.
  * @param {Options["test"]} test test option
  * @param {Module} module the module
  * @returns {boolean | null | string} true, if the module should be selected
@@ -81,6 +83,7 @@ const checkTest = (test, module) => {
 
 class LazyCompilationDependency extends Dependency {
 	/**
+	 * Creates an instance of LazyCompilationDependency.
 	 * @param {LazyCompilationProxyModule} proxyModule proxy module
 	 */
 	constructor(proxyModule) {
@@ -97,6 +100,7 @@ class LazyCompilationDependency extends Dependency {
 	}
 
 	/**
+	 * Returns an identifier to merge equal requests.
 	 * @returns {string | null} an identifier to merge equal requests
 	 */
 	getResourceIdentifier() {
@@ -108,6 +112,7 @@ registerNotSerializable(LazyCompilationDependency);
 
 class LazyCompilationProxyModule extends Module {
 	/**
+	 * Creates an instance of LazyCompilationProxyModule.
 	 * @param {string} context context
 	 * @param {Module} originalModule an original module
 	 * @param {string} request request
@@ -129,6 +134,7 @@ class LazyCompilationProxyModule extends Module {
 	}
 
 	/**
+	 * Returns the unique identifier used to reference this module.
 	 * @returns {string} a unique identifier of the module
 	 */
 	identifier() {
@@ -136,6 +142,7 @@ class LazyCompilationProxyModule 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
 	 */
@@ -163,6 +170,7 @@ class LazyCompilationProxyModule extends Module {
 	}
 
 	/**
+	 * Gets the library identifier.
 	 * @param {LibIdentOptions} options options
 	 * @returns {LibIdent | null} an identifier for library inclusion
 	 */
@@ -173,6 +181,7 @@ class LazyCompilationProxyModule 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}
@@ -182,6 +191,7 @@ class LazyCompilationProxyModule 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
@@ -208,6 +218,7 @@ class LazyCompilationProxyModule extends Module {
 	}
 
 	/**
+	 * Returns the source types this module can generate.
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
@@ -215,6 +226,7 @@ class LazyCompilationProxyModule 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)
 	 */
@@ -223,6 +235,7 @@ class LazyCompilationProxyModule extends Module {
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
@@ -304,6 +317,7 @@ class LazyCompilationProxyModule 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}
@@ -323,6 +337,7 @@ class LazyCompilationDependencyFactory extends ModuleFactory {
 	}
 
 	/**
+	 * Processes the provided data.
 	 * @param {ModuleFactoryCreateData} data data object
 	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}
@@ -338,6 +353,7 @@ class LazyCompilationDependencyFactory extends ModuleFactory {
 }
 
 /**
+ * Defines the backend handler callback.
  * @callback BackendHandler
  * @param {Compiler} compiler compiler
  * @param {(err: Error | null, backendApi?: BackendApi) => void} callback callback
@@ -345,6 +361,7 @@ class LazyCompilationDependencyFactory extends ModuleFactory {
  */
 
 /**
+ * Defines the promise backend handler callback.
  * @callback PromiseBackendHandler
  * @param {Compiler} compiler compiler
  * @returns {Promise<BackendApi>} backend
@@ -355,6 +372,7 @@ class LazyCompilationDependencyFactory extends ModuleFactory {
 /** @typedef {(module: Module) => boolean} TestFn */
 
 /**
+ * Defines the options type used by this module.
  * @typedef {object} Options options
  * @property {BackEnd} backend the backend
  * @property {boolean=} entries
@@ -366,6 +384,7 @@ const PLUGIN_NAME = "LazyCompilationPlugin";
 
 class LazyCompilationPlugin {
 	/**
+	 * Creates an instance of LazyCompilationPlugin.
 	 * @param {Options} options options
 	 */
 	constructor({ backend, entries, imports, test }) {
@@ -376,7 +395,7 @@ class LazyCompilationPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/hmr/lazyCompilationBackend.js

@@ -19,6 +19,7 @@
 /** @typedef {() => Server} CreateServerFunction */
 
 /**
+ * Returns backend.
  * @param {Omit<LazyCompilationDefaultBackendOptions, "client"> & { client: NonNullable<LazyCompilationDefaultBackendOptions["client"]> }} options additional options for the backend
  * @returns {BackendHandler} backend
  */
@@ -118,6 +119,7 @@ module.exports = (options) => (compiler, callback) => {
 	server.on(
 		"listening",
 		/**
+		 * Handles the callback logic for this hook.
 		 * @param {Error} err error
 		 * @returns {void}
 		 */

package/lib/ids/ChunkModuleIdRangePlugin.js

@@ -16,6 +16,7 @@ const {
 /** @typedef {import("../ChunkGraph").ModuleComparator} ModuleComparator */
 
 /**
+ * Defines the chunk module id range plugin options type used by this module.
  * @typedef {object} ChunkModuleIdRangePluginOptions
  * @property {string} name the chunk name
  * @property {("index" | "index2" | "preOrderIndex" | "postOrderIndex")=} order order
@@ -27,6 +28,7 @@ const PLUGIN_NAME = "ChunkModuleIdRangePlugin";
 
 class ChunkModuleIdRangePlugin {
 	/**
+	 * Creates an instance of ChunkModuleIdRangePlugin.
 	 * @param {ChunkModuleIdRangePluginOptions} options options object
 	 */
 	constructor(options) {
@@ -35,7 +37,7 @@ class ChunkModuleIdRangePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/DeterministicChunkIdsPlugin.js

@@ -15,6 +15,7 @@ const {
 /** @typedef {import("../Compiler")} Compiler */
 
 /**
+ * Defines the deterministic chunk ids plugin options type used by this module.
  * @typedef {object} DeterministicChunkIdsPluginOptions
  * @property {string=} context context for ids
  * @property {number=} maxLength maximum length of ids
@@ -24,6 +25,7 @@ const PLUGIN_NAME = "DeterministicChunkIdsPlugin";
 
 class DeterministicChunkIdsPlugin {
 	/**
+	 * Creates an instance of DeterministicChunkIdsPlugin.
 	 * @param {DeterministicChunkIdsPluginOptions=} options options
 	 */
 	constructor(options = {}) {
@@ -32,7 +34,7 @@ class DeterministicChunkIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/DeterministicModuleIdsPlugin.js

@@ -18,6 +18,7 @@ const {
 /** @typedef {import("../Module")} Module */
 
 /**
+ * Defines the deterministic module ids plugin options type used by this module.
  * @typedef {object} DeterministicModuleIdsPluginOptions
  * @property {string=} context context relative to which module identifiers are computed
  * @property {((module: Module) => boolean)=} test selector function for modules
@@ -31,6 +32,7 @@ const PLUGIN_NAME = "DeterministicModuleIdsPlugin";
 
 class DeterministicModuleIdsPlugin {
 	/**
+	 * Creates an instance of DeterministicModuleIdsPlugin.
 	 * @param {DeterministicModuleIdsPluginOptions=} options options
 	 */
 	constructor(options = {}) {
@@ -39,7 +41,7 @@ class DeterministicModuleIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/HashedModuleIdsPlugin.js

@@ -22,6 +22,7 @@ const PLUGIN_NAME = "HashedModuleIdsPlugin";
 
 class HashedModuleIdsPlugin {
 	/**
+	 * Creates an instance of HashedModuleIdsPlugin.
 	 * @param {HashedModuleIdsPluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -30,7 +31,7 @@ class HashedModuleIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/IdHelpers.js

@@ -18,6 +18,7 @@ const numberHash = require("../util/numberHash");
 /** @typedef {import("../Module").BuildMeta} BuildMeta */
 
 /**
+ * Returns hash.
  * @param {string} str string to hash
  * @param {number} len max length of the hash
  * @param {HashFunction} hashFunction hash function to use
@@ -31,6 +32,7 @@ const getHash = (str, len, hashFunction) => {
 };
 
 /**
+ * Returns string prefixed by an underscore if it is a number.
  * @param {string} str the string
  * @returns {string} string prefixed by an underscore if it is a number
  */
@@ -52,6 +54,7 @@ const avoidNumber = (str) => {
 };
 
 /**
+ * Returns id representation.
  * @param {string} request the request
  * @returns {string} id representation
  */
@@ -59,6 +62,7 @@ const requestToId = (request) =>
 	request.replace(/^(\.\.?\/)+/, "").replace(/(^[.-]|[^a-z0-9_-])+/gi, "_");
 
 /**
+ * Shorten long string.
  * @param {string} string the string
  * @param {string} delimiter separator for string and hash
  * @param {HashFunction} hashFunction hash function to use
@@ -74,6 +78,7 @@ const shortenLongString = (string, delimiter, hashFunction) => {
 };
 
 /**
+ * Gets short module name.
  * @param {Module} module the module
  * @param {string} context context directory
  * @param {AssociatedObjectForCache=} associatedObjectForCache an object to which the cache will be attached
@@ -92,6 +97,7 @@ const getShortModuleName = (module, context, associatedObjectForCache) => {
 };
 
 /**
+ * Gets long module name.
  * @param {string} shortName the short name
  * @param {Module} module the module
  * @param {string} context context directory
@@ -111,6 +117,7 @@ const getLongModuleName = (
 };
 
 /**
+ * Gets full module name.
  * @param {Module} module the module
  * @param {string} context context directory
  * @param {AssociatedObjectForCache=} associatedObjectForCache an object to which the cache will be attached
@@ -120,6 +127,7 @@ const getFullModuleName = (module, context, associatedObjectForCache) =>
 	makePathsRelative(context, module.identifier(), associatedObjectForCache);
 
 /**
+ * Gets short chunk name.
  * @param {Chunk} chunk the chunk
  * @param {ChunkGraph} chunkGraph the chunk graph
  * @param {string} context context directory
@@ -148,6 +156,7 @@ const getShortChunkName = (
 };
 
 /**
+ * Gets long chunk name.
  * @param {Chunk} chunk the chunk
  * @param {ChunkGraph} chunkGraph the chunk graph
  * @param {string} context context directory
@@ -185,6 +194,7 @@ const getLongChunkName = (
 };
 
 /**
+ * Gets full chunk name.
  * @param {Chunk} chunk the chunk
  * @param {ChunkGraph} chunkGraph the chunk graph
  * @param {string} context context directory
@@ -206,6 +216,7 @@ const getFullChunkName = (
 };
 
 /**
+ * Adds to map of items.
  * @template K
  * @template V
  * @param {Map<K, V[]>} map a map from key to values
@@ -225,6 +236,7 @@ const addToMapOfItems = (map, key, value) => {
 /** @typedef {Set<string>} UsedModuleIds */
 
 /**
+ * Gets used module ids and modules.
  * @param {Compilation} compilation the compilation
  * @param {((module: Module) => boolean)=} filter filter modules
  * @returns {[UsedModuleIds, Module[]]} used module ids as strings and modules without id matching the filter
@@ -263,6 +275,7 @@ const getUsedModuleIdsAndModules = (compilation, filter) => {
 /** @typedef {Set<string>} UsedChunkIds */
 
 /**
+ * Gets used chunk ids.
  * @param {Compilation} compilation the compilation
  * @returns {UsedChunkIds} used chunk ids as strings
  */
@@ -286,6 +299,7 @@ const getUsedChunkIds = (compilation) => {
 };
 
 /**
+ * Returns list of items without a name.
  * @template T
  * @param {Iterable<T>} items list of items to be named
  * @param {(item: T) => string} getShortName get a short name for an item
@@ -304,6 +318,7 @@ const assignNames = (
 	assignName
 ) => {
 	/**
+	 * Defines the map to item type used by this module.
 	 * @template T
 	 * @typedef {Map<string, T[]>} MapToItem
 	 */
@@ -358,6 +373,7 @@ const assignNames = (
 };
 
 /**
+ * Assign deterministic ids.
  * @template T
  * @param {T[]} items list of items to be named
  * @param {(item: T) => string} getName get a name for an item
@@ -412,6 +428,7 @@ const assignDeterministicIds = (
 };
 
 /**
+ * Assign ascending module ids.
  * @param {UsedModuleIds} usedIds used ids
  * @param {Iterable<Module>} modules the modules
  * @param {Compilation} compilation the compilation
@@ -425,6 +442,7 @@ const assignAscendingModuleIds = (usedIds, modules, compilation) => {
 	let assignId;
 	if (usedIds.size > 0) {
 		/**
+		 * Processes the provided module.
 		 * @param {Module} module the module
 		 */
 		assignId = (module) => {
@@ -435,6 +453,7 @@ const assignAscendingModuleIds = (usedIds, modules, compilation) => {
 		};
 	} else {
 		/**
+		 * Processes the provided module.
 		 * @param {Module} module the module
 		 */
 		assignId = (module) => {
@@ -449,6 +468,7 @@ const assignAscendingModuleIds = (usedIds, modules, compilation) => {
 };
 
 /**
+ * Assign ascending chunk ids.
  * @param {Iterable<Chunk>} chunks the chunks
  * @param {Compilation} compilation the compilation
  * @returns {void}

package/lib/ids/NamedChunkIdsPlugin.js

@@ -17,6 +17,7 @@ const {
 /** @typedef {import("../Compiler")} Compiler */
 
 /**
+ * Defines the named chunk ids plugin options type used by this module.
  * @typedef {object} NamedChunkIdsPluginOptions
  * @property {string=} context context
  * @property {string=} delimiter delimiter
@@ -26,6 +27,7 @@ const PLUGIN_NAME = "NamedChunkIdsPlugin";
 
 class NamedChunkIdsPlugin {
 	/**
+	 * Creates an instance of NamedChunkIdsPlugin.
 	 * @param {NamedChunkIdsPluginOptions=} options options
 	 */
 	constructor(options = {}) {
@@ -34,7 +36,7 @@ class NamedChunkIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/NamedModuleIdsPlugin.js

@@ -17,6 +17,7 @@ const {
 /** @typedef {import("../Compiler")} Compiler */
 
 /**
+ * Defines the named module ids plugin options type used by this module.
  * @typedef {object} NamedModuleIdsPluginOptions
  * @property {string=} context context
  */
@@ -25,6 +26,7 @@ const PLUGIN_NAME = "NamedModuleIdsPlugin";
 
 class NamedModuleIdsPlugin {
 	/**
+	 * Creates an instance of NamedModuleIdsPlugin.
 	 * @param {NamedModuleIdsPluginOptions=} options options
 	 */
 	constructor(options = {}) {
@@ -33,7 +35,7 @@ class NamedModuleIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/NaturalChunkIdsPlugin.js

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

package/lib/ids/NaturalModuleIdsPlugin.js

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

package/lib/ids/OccurrenceChunkIdsPlugin.js

@@ -16,6 +16,7 @@ const PLUGIN_NAME = "OccurrenceChunkIdsPlugin";
 
 class OccurrenceChunkIdsPlugin {
 	/**
+	 * Creates an instance of OccurrenceChunkIdsPlugin.
 	 * @param {OccurrenceChunkIdsPluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -24,7 +25,7 @@ class OccurrenceChunkIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ids/OccurrenceModuleIdsPlugin.js

@@ -21,6 +21,7 @@ const PLUGIN_NAME = "OccurrenceModuleIdsPlugin";
 
 class OccurrenceModuleIdsPlugin {
 	/**
+	 * Creates an instance of OccurrenceModuleIdsPlugin.
 	 * @param {OccurrenceModuleIdsPluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -29,7 +30,7 @@ class OccurrenceModuleIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -79,6 +80,7 @@ class OccurrenceModuleIdsPlugin {
 				}
 
 				/**
+				 * Count occurs in entry.
 				 * @param {Module} module module
 				 * @returns {number} count of occurs
 				 */
@@ -96,6 +98,7 @@ class OccurrenceModuleIdsPlugin {
 				};
 
 				/**
+				 * Returns count of occurs.
 				 * @param {Module} module module
 				 * @returns {number} count of occurs
 				 */

package/lib/ids/SyncModuleIdsPlugin.js

@@ -18,6 +18,7 @@ const { getUsedModuleIdsAndModules } = require("./IdHelpers");
 const plugin = "SyncModuleIdsPlugin";
 
 /**
+ * Represents the sync module ids plugin runtime component.
  * @typedef {object} SyncModuleIdsPluginOptions
  * @property {string} path path to file
  * @property {string=} context context for module names
@@ -27,6 +28,7 @@ const plugin = "SyncModuleIdsPlugin";
 
 class SyncModuleIdsPlugin {
 	/**
+	 * Creates an instance of SyncModuleIdsPlugin.
 	 * @param {SyncModuleIdsPluginOptions} options options
 	 */
 	constructor(options) {
@@ -35,7 +37,7 @@ class SyncModuleIdsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/index.js

@@ -85,6 +85,7 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./util/fs").OutputFileSystem} OutputFileSystem */
 
 /**
+ * Returns function.
  * @template {EXPECTED_FUNCTION} T
  * @param {() => T} factory factory function
  * @returns {T} function
@@ -93,6 +94,7 @@ const lazyFunction = (factory) => {
 	const fac = memoize(factory);
 	const f = /** @type {unknown} */ (
 		/**
+		 * Handles the callback logic for this hook.
 		 * @param {...EXPECTED_ANY} args args
 		 * @returns {T} result
 		 */
@@ -102,6 +104,7 @@ const lazyFunction = (factory) => {
 };
 
 /**
+ * Merges the provided values into a single result.
  * @template A
  * @template B
  * @param {A} obj input a
@@ -142,6 +145,7 @@ module.exports = mergeExports(fn, {
 		return require("./webpack");
 	},
 	/**
+	 * Returns validate fn.
 	 * @returns {(configuration: Configuration | MultiConfiguration) => void} validate fn
 	 */
 	get validate() {
@@ -151,6 +155,7 @@ module.exports = mergeExports(fn, {
 
 		const getRealValidate = memoize(
 			/**
+			 * Handles the callback logic for this hook.
 			 * @returns {(configuration: Configuration | MultiConfiguration) => void} validate fn
 			 */
 			() => {

package/lib/javascript/ArrayPushCallbackChunkFormatPlugin.js

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