webpack 5.106.0 → 5.106.2

package/lib/DllModule.js

@@ -40,6 +40,7 @@ const RUNTIME_REQUIREMENTS = new Set([
 
 class DllModule extends Module {
 	/**
+	 * Creates an instance of DllModule.
 	 * @param {string} context context path
 	 * @param {Dependency[]} dependencies dependencies
 	 * @param {string} name name
@@ -54,6 +55,7 @@ class DllModule extends Module {
 	}
 
 	/**
+	 * Returns the source types this module can generate.
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
@@ -61,6 +63,7 @@ class DllModule extends Module {
 	}
 
 	/**
+	 * Returns the unique identifier used to reference this module.
 	 * @returns {string} a unique identifier of the module
 	 */
 	identifier() {
@@ -68,6 +71,7 @@ class DllModule 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
 	 */
@@ -76,6 +80,7 @@ class DllModule 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
@@ -90,6 +95,7 @@ class DllModule extends Module {
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
@@ -107,6 +113,7 @@ class DllModule 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}
@@ -116,6 +123,7 @@ class DllModule 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)
 	 */
@@ -124,6 +132,7 @@ class DllModule 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}
@@ -134,6 +143,7 @@ class DllModule extends Module {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -142,6 +152,7 @@ class DllModule extends Module {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/DllModuleFactory.js

@@ -19,6 +19,7 @@ class DllModuleFactory extends ModuleFactory {
 	}
 
 	/**
+	 * Processes the provided data.
 	 * @param {ModuleFactoryCreateData} data data object
 	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}

package/lib/DllPlugin.js

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

package/lib/DllReferencePlugin.js

@@ -5,12 +5,12 @@
 
 "use strict";
 
-const parseJson = require("json-parse-even-better-errors");
 const DelegatedModuleFactoryPlugin = require("./DelegatedModuleFactoryPlugin");
 const ExternalModuleFactoryPlugin = require("./ExternalModuleFactoryPlugin");
 const WebpackError = require("./WebpackError");
 const DelegatedSourceDependency = require("./dependencies/DelegatedSourceDependency");
-const makePathsRelative = require("./util/identifier").makePathsRelative;
+const { makePathsRelative } = require("./util/identifier");
+const parseJson = require("./util/parseJson");
 
 /** @typedef {import("../declarations/WebpackOptions").Externals} Externals */
 /** @typedef {import("../declarations/plugins/DllReferencePlugin").DllReferencePluginOptions} DllReferencePluginOptions */
@@ -26,6 +26,7 @@ const PLUGIN_NAME = "DllReferencePlugin";
 
 class DllReferencePlugin {
 	/**
+	 * Creates an instance of DllReferencePlugin.
 	 * @param {DllReferencePluginOptions} options options object
 	 */
 	constructor(options) {
@@ -33,7 +34,7 @@ class DllReferencePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -79,9 +80,12 @@ class DllReferencePlugin {
 						// Catch errors parsing the manifest so that blank
 						// or malformed manifest files don't kill the process.
 						try {
-							data.data = parseJson(
-								/** @type {Buffer} */ (result).toString("utf8")
-							);
+							data.data =
+								/** @type {DllReferencePluginOptionsManifest} */
+								(
+									/** @type {unknown} */
+									(parseJson(/** @type {Buffer} */ (result).toString("utf8")))
+								);
 						} catch (parseErr) {
 							// Store the error in the params so that it can
 							// be added as a compilation error later on.
@@ -177,6 +181,7 @@ class DllReferencePlugin {
 
 class DllManifestError extends WebpackError {
 	/**
+	 * Creates an instance of DllManifestError.
 	 * @param {string} filename filename of the manifest
 	 * @param {string} message error message
 	 */

package/lib/DotenvPlugin.js

@@ -214,6 +214,7 @@ const envToDefinitions = (env) => {
 
 class DotenvPlugin {
 	/**
+	 * Creates an instance of DotenvPlugin.
 	 * @param {DotenvPluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -222,6 +223,7 @@ class DotenvPlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -355,6 +357,7 @@ class DotenvPlugin {
 	}
 
 	/**
+	 * Loads the provided compiler.
 	 * @private
 	 * @param {Compiler} compiler compiler
 	 * @param {ItemCacheFacade} itemCache item cache facade

package/lib/DynamicEntryPlugin.js

@@ -21,6 +21,7 @@ const PLUGIN_NAME = "DynamicEntryPlugin";
 
 class DynamicEntryPlugin {
 	/**
+	 * Creates an instance of DynamicEntryPlugin.
 	 * @param {string} context the context path
 	 * @param {EntryDynamic} entry the entry value
 	 */
@@ -32,7 +33,7 @@ class DynamicEntryPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -65,6 +66,7 @@ class DynamicEntryPlugin {
 							promises.push(
 								new Promise(
 									/**
+									 * Handles the callback logic for this hook.
 									 * @param {(value?: undefined) => void} resolve resolve
 									 * @param {(reason?: Error) => void} reject reject
 									 */

package/lib/EntryOptionPlugin.js

@@ -14,6 +14,7 @@ const PLUGIN_NAME = "EntryOptionPlugin";
 
 class EntryOptionPlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance one is tapping into
 	 * @returns {void}
 	 */
@@ -25,6 +26,7 @@ class EntryOptionPlugin {
 	}
 
 	/**
+	 * Apply entry option.
 	 * @param {Compiler} compiler the compiler
 	 * @param {string} context context directory
 	 * @param {Entry} entry request
@@ -56,6 +58,7 @@ class EntryOptionPlugin {
 	}
 
 	/**
+	 * Entry description to options.
 	 * @param {Compiler} compiler the compiler
 	 * @param {string} name entry name
 	 * @param {EntryDescription} desc entry description

package/lib/EntryPlugin.js

@@ -26,7 +26,7 @@ class EntryPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -52,6 +52,7 @@ class EntryPlugin {
 	}
 
 	/**
+	 * Creates a dependency.
 	 * @param {string} entry entry request
 	 * @param {EntryOptions | string} options entry options (passing string is deprecated)
 	 * @returns {EntryDependency} the dependency

package/lib/Entrypoint.js

@@ -44,6 +44,8 @@ class Entrypoint extends ChunkGroup {
 	}
 
 	/**
+	 * Indicates whether this chunk group is loaded as part of the initial page
+	 * load instead of being created lazily.
 	 * @returns {boolean} true, when this chunk group will be loaded on initial page load
 	 */
 	isInitial() {
@@ -90,6 +92,8 @@ class Entrypoint extends ChunkGroup {
 	}
 
 	/**
+	 * Replaces one member chunk with another while preserving the group's
+	 * ordering and avoiding duplicates.
 	 * @param {Chunk} oldChunk chunk to be replaced
 	 * @param {Chunk} newChunk New chunk that will be replaced with
 	 * @returns {boolean | undefined} returns true if the replacement was successful

package/lib/EnvironmentPlugin.js

@@ -15,6 +15,7 @@ const PLUGIN_NAME = "EnvironmentPlugin";
 
 class EnvironmentPlugin {
 	/**
+	 * Creates an instance of EnvironmentPlugin.
 	 * @param {(string | string[] | Record<string, EXPECTED_ANY>)[]} keys keys
 	 */
 	constructor(...keys) {
@@ -34,7 +35,7 @@ class EnvironmentPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/ErrorHelpers.js

@@ -10,6 +10,7 @@ const loaderFlag = "LOADER_EXECUTION";
 const webpackOptionsFlag = "WEBPACK_OPTIONS";
 
 /**
+ * Returns stack trace without the specified flag included.
  * @param {string} stack stack trace
  * @param {string} flag flag to cut off
  * @returns {string} stack trace without the specified flag included
@@ -25,18 +26,21 @@ const cutOffByFlag = (stack, flag) => {
 };
 
 /**
+ * Cut off loader execution.
  * @param {string} stack stack trace
  * @returns {string} stack trace without the loader execution flag included
  */
 const cutOffLoaderExecution = (stack) => cutOffByFlag(stack, loaderFlag);
 
 /**
+ * Cut off webpack options.
  * @param {string} stack stack trace
  * @returns {string} stack trace without the webpack options flag included
  */
 const cutOffWebpackOptions = (stack) => cutOffByFlag(stack, webpackOptionsFlag);
 
 /**
+ * Cut off multiline message.
  * @param {string} stack stack trace
  * @param {string} message error message
  * @returns {string} stack trace without the message included
@@ -56,6 +60,7 @@ const cutOffMultilineMessage = (stack, message) => {
 };
 
 /**
+ * Returns stack trace without the message included.
  * @param {string} stack stack trace
  * @param {string} message error message
  * @returns {string} stack trace without the message included
@@ -70,6 +75,7 @@ const cutOffMessage = (stack, message) => {
 };
 
 /**
+ * Returns stack trace without the loader execution flag and message included.
  * @param {string} stack stack trace
  * @param {string} message error message
  * @returns {string} stack trace without the loader execution flag and message included
@@ -81,6 +87,7 @@ const cleanUp = (stack, message) => {
 };
 
 /**
+ * Clean up webpack options.
  * @param {string} stack stack trace
  * @param {string} message error message
  * @returns {string} stack trace without the webpack options flag and message included

package/lib/EvalDevToolModulePlugin.js

@@ -30,6 +30,7 @@ const devtoolWarning = new RawSource(`/*
 `);
 
 /**
+ * Defines the eval dev tool module plugin options type used by this module.
  * @typedef {object} EvalDevToolModulePluginOptions
  * @property {DevtoolNamespace=} namespace namespace
  * @property {string=} sourceUrlComment source url comment
@@ -40,6 +41,7 @@ const PLUGIN_NAME = "EvalDevToolModulePlugin";
 
 class EvalDevToolModulePlugin {
 	/**
+	 * Creates an instance of EvalDevToolModulePlugin.
 	 * @param {EvalDevToolModulePluginOptions=} options options
 	 */
 	constructor(options = {}) {
@@ -54,7 +56,7 @@ class EvalDevToolModulePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/EvalSourceMapDevToolPlugin.js

@@ -42,6 +42,7 @@ const PLUGIN_NAME = "EvalSourceMapDevToolPlugin";
 
 class EvalSourceMapDevToolPlugin {
 	/**
+	 * Creates an instance of EvalSourceMapDevToolPlugin.
 	 * @param {SourceMapDevToolPluginOptions | string=} inputOptions Options object
 	 */
 	constructor(inputOptions = {}) {
@@ -70,7 +71,7 @@ class EvalSourceMapDevToolPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -92,6 +93,7 @@ class EvalSourceMapDevToolPlugin {
 					}
 
 					/**
+					 * Returns result.
 					 * @param {Source} r result
 					 * @returns {Source} result
 					 */