webpack 5.106.1 → 5.106.2

package/lib/css/walkCssTokens.js

@@ -6,6 +6,7 @@
 "use strict";
 
 /**
+ * Defines the css token callbacks type used by this module.
  * @typedef {object} CssTokenCallbacks
  * @property {((input: string, start: number, end: number) => number)=} comment
  * @property {((input: string, start: number, end: number) => number)=} whitespace
@@ -111,6 +112,7 @@ const consumeSpace = (input, pos, callbacks) => {
 // Replace any U+000D CARRIAGE RETURN (CR) code points, U+000C FORM FEED (FF) code points, or pairs of U+000D CARRIAGE RETURN (CR) followed by U+000A LINE FEED (LF) in input by a single U+000A LINE FEED (LF) code point.
 
 /**
+ * Checks whether newline true, if cc is a newline.
  * @param {number} cc char code
  * @returns {boolean} true, if cc is a newline
  */
@@ -118,6 +120,7 @@ const _isNewline = (cc) =>
 	cc === CC_LINE_FEED || cc === CC_CARRIAGE_RETURN || cc === CC_FORM_FEED;
 
 /**
+ * Consume extra newline.
  * @param {number} cc char code
  * @param {string} input input
  * @param {number} pos position
@@ -132,12 +135,14 @@ const consumeExtraNewline = (cc, input, pos) => {
 };
 
 /**
+ * Checks whether space true, if cc is a space (U+0009 CHARACTER TABULATION or U+0020 SPACE).
  * @param {number} cc char code
  * @returns {boolean} true, if cc is a space (U+0009 CHARACTER TABULATION or U+0020 SPACE)
  */
 const _isSpace = (cc) => cc === CC_TAB || cc === CC_SPACE;
 
 /**
+ * Checks whether white space true, if cc is a whitespace.
  * @param {number} cc char code
  * @returns {boolean} true, if cc is a whitespace
  */
@@ -207,6 +212,7 @@ const consumeComments = (input, pos, callbacks) => {
 };
 
 /**
+ * Checks whether hex digit true, if cc is a hex digit.
  * @param {number} cc char code
  * @returns {boolean} true, if cc is a hex digit
  */
@@ -216,6 +222,7 @@ const _isHexDigit = (cc) =>
 	(cc >= CC_LOWER_A && cc <= CC_LOWER_F);
 
 /**
+ * Consume an escaped code point.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position
@@ -339,6 +346,7 @@ const consumeAStringToken = (input, pos, callbacks) => {
 };
 
 /**
+ * Checks whether this object is non ascii code point.
  * @param {number} cc char code
  * @param {number} q char code
  * @returns {boolean} is non-ASCII code point
@@ -348,6 +356,7 @@ const isNonASCIICodePoint = (cc, q) =>
 	cc > 0x80;
 
 /**
+ * Checks whether this object is letter.
  * @param {number} cc char code
  * @returns {boolean} is letter
  */
@@ -356,6 +365,7 @@ const isLetter = (cc) =>
 	(cc >= CC_UPPER_A && cc <= CC_UPPER_Z);
 
 /**
+ * Is ident start code point.
  * @param {number} cc char code
  * @param {number} q char code
  * @returns {boolean} is identifier start code
@@ -364,6 +374,7 @@ const _isIdentStartCodePoint = (cc, q) =>
 	isLetter(cc) || isNonASCIICodePoint(cc, q) || cc === CC_LOW_LINE;
 
 /**
+ * Is ident code point.
  * @param {number} cc char code
  * @param {number} q char code
  * @returns {boolean} is identifier code
@@ -371,12 +382,14 @@ const _isIdentStartCodePoint = (cc, q) =>
 const _isIdentCodePoint = (cc, q) =>
 	_isIdentStartCodePoint(cc, q) || _isDigit(cc) || cc === CC_HYPHEN_MINUS;
 /**
+ * Checks whether digit is digit.
  * @param {number} cc char code
  * @returns {boolean} is digit
  */
 const _isDigit = (cc) => cc >= CC_0 && cc <= CC_9;
 
 /**
+ * If two code points are valid escape.
  * @param {string} input input
  * @param {number} pos position
  * @param {number=} f first code point
@@ -401,6 +414,7 @@ const _ifTwoCodePointsAreValidEscape = (input, pos, f, s) => {
 };
 
 /**
+ * If three code points would start an ident sequence.
  * @param {string} input input
  * @param {number} pos position
  * @param {number=} f first
@@ -453,6 +467,7 @@ const _ifThreeCodePointsWouldStartAnIdentSequence = (input, pos, f, s, t) => {
 };
 
 /**
+ * If three code points would start a number.
  * @param {string} input input
  * @param {number} pos position
  * @param {number=} f first
@@ -873,6 +888,7 @@ const _consumeAnIdentSequence = (input, pos) => {
 };
 
 /**
+ * Is non printable code point.
  * @param {number} cc char code
  * @returns {boolean} true, when cc is the non-printable code point, otherwise false
  */
@@ -883,6 +899,7 @@ const _isNonPrintableCodePoint = (cc) =>
 	cc === 0x7f;
 
 /**
+ * Consume the remnants of a bad url.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position
@@ -924,6 +941,7 @@ const consumeTheRemnantsOfABadUrl = (input, pos) => {
 };
 
 /**
+ * Consume a url token.
  * @param {string} input input
  * @param {number} pos position
  * @param {number} fnStart start
@@ -1285,6 +1303,7 @@ const consumeAToken = (input, pos, callbacks) => {
 };
 
 /**
+ * Returns pos.
  * @param {string} input input css
  * @param {number=} pos pos
  * @param {CssTokenCallbacks=} callbacks callbacks
@@ -1309,6 +1328,7 @@ module.exports = (input, pos = 0, callbacks = {}) => {
 };
 
 /**
+ * Returns pos.
  * @param {string} input input css
  * @param {number} pos pos
  * @param {CssTokenCallbacks} callbacks callbacks
@@ -1411,6 +1431,7 @@ const consumeUntil = (input, pos, callbacks, additional, options = {}) => {
 };
 
 /**
+ * Returns position after comments.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position after comments
@@ -1428,6 +1449,7 @@ const eatComments = (input, pos) => {
 };
 
 /**
+ * Returns position after whitespace.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position after whitespace
@@ -1441,6 +1463,7 @@ const eatWhitespace = (input, pos) => {
 };
 
 /**
+ * Eat whitespace and comments.
  * @param {string} input input
  * @param {number} pos position
  * @returns {[number, boolean]} position after whitespace and comments
@@ -1466,6 +1489,7 @@ const eatWhitespaceAndComments = (input, pos) => {
 };
 
 /**
+ * Returns position after whitespace.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position after whitespace
@@ -1486,6 +1510,7 @@ const eatWhiteLine = (input, pos) => {
 };
 
 /**
+ * Skip comments and eat ident sequence.
  * @param {string} input input
  * @param {number} pos position
  * @returns {[number, number] | undefined} positions of ident sequence
@@ -1511,6 +1536,7 @@ const skipCommentsAndEatIdentSequence = (input, pos) => {
 };
 
 /**
+ * Returns positions of ident sequence.
  * @param {string} input input
  * @param {number} pos position
  * @returns {[number, number] | undefined} positions of ident sequence
@@ -1531,6 +1557,7 @@ const eatString = (input, pos) => {
 };
 
 /**
+ * Eat image set strings.
  * @param {string} input input
  * @param {number} pos position
  * @param {CssTokenCallbacks} cbs callbacks
@@ -1601,6 +1628,7 @@ const eatImageSetStrings = (input, pos, cbs) => {
 };
 
 /**
+ * Returns positions of top level tokens.
  * @param {string} input input
  * @param {number} pos position
  * @param {CssTokenCallbacks} cbs callbacks
@@ -1744,6 +1772,7 @@ const eatImportTokens = (input, pos, cbs) => {
 };
 
 /**
+ * Eat ident sequence.
  * @param {string} input input
  * @param {number} pos position
  * @returns {[number, number] | undefined} positions of ident sequence
@@ -1769,6 +1798,7 @@ const eatIdentSequence = (input, pos) => {
 };
 
 /**
+ * Eat ident sequence or string.
  * @param {string} input input
  * @param {number} pos position
  * @returns {[number, number, boolean] | undefined} positions of ident sequence or string
@@ -1799,6 +1829,7 @@ const eatIdentSequenceOrString = (input, pos) => {
 };
 
 /**
+ * Returns function to eat characters.
  * @param {string} chars characters
  * @returns {(input: string, pos: number) => number} function to eat characters
  */

package/lib/debug/ProfilingPlugin.js

@@ -23,21 +23,25 @@ const { dirname, mkdirpSync } = require("../util/fs");
 /** @typedef {import("../util/fs").IntermediateFileSystem} IntermediateFileSystem */
 
 /**
+ * Defines the hook type used by this module.
  * @template T, R
  * @typedef {import("tapable").Hook<T, R>} Hook
  */
 
 /**
+ * Defines the fake hook type used by this module.
  * @template T
  * @typedef {import("../util/deprecation").FakeHook<T>} FakeHook
  */
 
 /**
+ * Defines the hook map type used by this module.
  * @template T
  * @typedef {import("tapable").HookMap<T>} HookMap
  */
 
 /**
+ * Defines the hook interceptor type used by this module.
  * @template T, R
  * @typedef {import("tapable").HookInterceptor<T, R>} HookInterceptor
  */
@@ -57,6 +61,7 @@ try {
 
 class Profiler {
 	/**
+	 * Creates an instance of Profiler.
 	 * @param {Inspector} inspector inspector
 	 */
 	constructor(inspector) {
@@ -97,6 +102,7 @@ class Profiler {
 	}
 
 	/**
+	 * Returns promise for the result.
 	 * @param {string} method method name
 	 * @param {EXPECTED_OBJECT=} params params
 	 * @returns {Promise<EXPECTED_ANY | void>} Promise for the result
@@ -127,6 +133,7 @@ class Profiler {
 	}
 
 	/**
+	 * Returns }>} profile result.
 	 * @returns {Promise<{ profile: { startTime: number, endTime: number } }>} profile result
 	 */
 	stopProfiling() {
@@ -161,6 +168,7 @@ class Profiler {
  */
 
 /**
+ * Creates a trace from the provided f.
  * @param {IntermediateFileSystem} fs filesystem used for output
  * @param {string} outputPath The location where to write the log.
  * @returns {Trace} The trace object
@@ -229,6 +237,7 @@ const PLUGIN_NAME = "ProfilingPlugin";
 
 class ProfilingPlugin {
 	/**
+	 * Creates an instance of ProfilingPlugin.
 	 * @param {ProfilingPluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -237,7 +246,7 @@ class ProfilingPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -376,6 +385,7 @@ class ProfilingPlugin {
 /** @typedef {Record<string, Hook<EXPECTED_ANY, EXPECTED_ANY> | FakeHook<EXPECTED_ANY> | HookMap<EXPECTED_ANY>>} Hooks */
 
 /**
+ * Intercept all hooks for.
  * @param {EXPECTED_OBJECT & { hooks?: Hooks }} instance instance
  * @param {Trace} tracer tracer
  * @param {string} logLabel log label
@@ -393,6 +403,7 @@ const interceptAllHooksFor = (instance, tracer, logLabel) => {
 };
 
 /**
+ * Intercept all parser hooks.
  * @param {NormalModuleFactory} moduleFactory normal module factory
  * @param {Trace} tracer tracer
  */
@@ -414,6 +425,7 @@ const interceptAllParserHooks = (moduleFactory, tracer) => {
 };
 
 /**
+ * Intercept all generator hooks.
  * @param {NormalModuleFactory} moduleFactory normal module factory
  * @param {Trace} tracer tracer
  */
@@ -435,6 +447,7 @@ const interceptAllGeneratorHooks = (moduleFactory, tracer) => {
 };
 
 /**
+ * Intercept all javascript modules plugin hooks.
  * @param {Compilation} compilation compilation
  * @param {Trace} tracer tracer
  */
@@ -452,6 +465,7 @@ const interceptAllJavascriptModulesPluginHooks = (compilation, tracer) => {
 };
 
 /**
+ * Intercept all css modules plugin hooks.
  * @param {Compilation} compilation compilation
  * @param {Trace} tracer tracer
  */
@@ -468,6 +482,7 @@ const interceptAllCssModulesPluginHooks = (compilation, tracer) => {
 /** @typedef {(...args: EXPECTED_ANY[]) => EXPECTED_ANY | Promise<(...args: EXPECTED_ANY[]) => EXPECTED_ANY>} PluginFunction */
 
 /**
+ * Creates interceptor for.
  * @template T
  * @param {string} instance instance
  * @param {Trace} tracer tracer
@@ -475,6 +490,7 @@ const interceptAllCssModulesPluginHooks = (compilation, tracer) => {
  */
 const makeInterceptorFor = (instance, tracer) => (hookName) => ({
 	/**
+	 * Returns modified full tap.
 	 * @param {FullTap} tapInfo tap info
 	 * @returns {FullTap} modified full tap
 	 */
@@ -494,6 +510,7 @@ const makeInterceptorFor = (instance, tracer) => (hookName) => ({
 });
 
 /**
+ * Creates new profiled tap fn.
  * @param {string} hookName Name of the hook to profile.
  * @param {Trace} tracer The trace object.
  * @param {object} options Options for the profiled fn.
@@ -538,6 +555,7 @@ const makeNewProfiledTapFn = (hookName, tracer, { name, type, fn }) => {
 				fn(
 					...args,
 					/**
+					 * Handles the cat callback for this hook.
 					 * @param {...EXPECTED_ANY[]} r result
 					 */
 					(...r) => {

package/lib/dependencies/AMDDefineDependency.js

@@ -108,6 +108,7 @@ const DEFINITIONS = {
 
 class AMDDefineDependency extends NullDependency {
 	/**
+	 * Creates an instance of AMDDefineDependency.
 	 * @param {Range} range range
 	 * @param {Range | null} arrayRange array range
 	 * @param {Range | null} functionRange function range
@@ -130,6 +131,7 @@ class AMDDefineDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -144,6 +146,7 @@ class AMDDefineDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -167,6 +170,7 @@ AMDDefineDependency.Template = class AMDDefineDependencyTemplate extends (
 	NullDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object
@@ -183,6 +187,7 @@ AMDDefineDependency.Template = class AMDDefineDependencyTemplate extends (
 	}
 
 	/**
+	 * Returns variable name.
 	 * @param {AMDDefineDependency} dependency dependency
 	 * @returns {string | false | null} variable name
 	 */
@@ -195,6 +200,7 @@ AMDDefineDependency.Template = class AMDDefineDependencyTemplate extends (
 	}
 
 	/**
+	 * Returns branch.
 	 * @param {AMDDefineDependency} dependency dependency
 	 * @returns {string} branch
 	 */
@@ -207,6 +213,7 @@ AMDDefineDependency.Template = class AMDDefineDependencyTemplate extends (
 	}
 
 	/**
+	 * Processes the provided dependency.
 	 * @param {AMDDefineDependency} dependency dependency
 	 * @param {ReplaceSource} source source
 	 * @param {string} definition definition

package/lib/dependencies/AMDDefineDependencyParserPlugin.js

@@ -35,6 +35,7 @@ const { addLocalModule, getLocalModule } = require("./LocalModulesHelpers");
 /** @typedef {import("./LocalModule")} LocalModule */
 
 /**
+ * Checks whether this object is bound function expression.
  * @param {Expression | SpreadElement} expr expression
  * @returns {expr is CallExpression} true if it's a bound function expression
  */
@@ -51,6 +52,7 @@ const isBoundFunctionExpression = (expr) => {
 /** @typedef {FunctionExpression | ArrowFunctionExpression} UnboundFunctionExpression */
 
 /**
+ * Checks whether this object is unbound function expression.
  * @param {Expression | SpreadElement} expr expression
  * @returns {expr is FunctionExpression | ArrowFunctionExpression} true when unbound function expression
  */
@@ -61,6 +63,7 @@ const isUnboundFunctionExpression = (expr) => {
 };
 
 /**
+ * Checks whether this object is callable.
  * @param {Expression | SpreadElement} expr expression
  * @returns {expr is FunctionExpression | ArrowFunctionExpression | CallExpression} true when callable
  */
@@ -76,6 +79,7 @@ const PLUGIN_NAME = "AMDDefineDependencyParserPlugin";
 
 class AMDDefineDependencyParserPlugin {
 	/**
+	 * Creates an instance of AMDDefineDependencyParserPlugin.
 	 * @param {JavascriptParserOptions} options parserOptions
 	 */
 	constructor(options) {
@@ -83,6 +87,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {JavascriptParser} parser the parser
 	 * @returns {void}
 	 */
@@ -93,6 +98,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -160,6 +166,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -226,6 +233,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -251,6 +259,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * Process call define.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @returns {boolean | undefined} result
@@ -464,6 +473,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * New define dependency.
 	 * @param {Range} range range
 	 * @param {Range | null} arrayRange array range
 	 * @param {Range | null} functionRange function range
@@ -488,6 +498,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * New require array dependency.
 	 * @param {(string | LocalModuleDependency | AMDRequireItemDependency)[]} depsArray deps array
 	 * @param {Range} range range
 	 * @returns {AMDRequireArrayDependency} AMDRequireArrayDependency
@@ -497,6 +508,7 @@ class AMDDefineDependencyParserPlugin {
 	}
 
 	/**
+	 * New require item dependency.
 	 * @param {string} request request
 	 * @param {Range=} range range
 	 * @returns {AMDRequireItemDependency} AMDRequireItemDependency

package/lib/dependencies/AMDPlugin.js

@@ -46,6 +46,7 @@ const PLUGIN_NAME = "AMDPlugin";
 
 class AMDPlugin {
 	/**
+	 * Creates an instance of AMDPlugin.
 	 * @param {AmdOptions} amdOptions the AMD options
 	 */
 	constructor(amdOptions) {
@@ -53,7 +54,7 @@ class AMDPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -133,6 +134,7 @@ class AMDPlugin {
 					});
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {Parser} parser parser parser
 				 * @param {JavascriptParserOptions} parserOptions parserOptions
 				 * @returns {void}
@@ -141,6 +143,7 @@ class AMDPlugin {
 					if (parserOptions.amd !== undefined && !parserOptions.amd) return;
 
 					/**
+					 * Processes the provided option expr.
 					 * @param {string} optionExpr option expression
 					 * @param {string} rootName root name
 					 * @param {GetMembers} getMembers callback

package/lib/dependencies/AMDRequireArrayDependency.js

@@ -20,6 +20,7 @@ const NullDependency = require("./NullDependency");
 
 class AMDRequireArrayDependency extends NullDependency {
 	/**
+	 * Creates an instance of AMDRequireArrayDependency.
 	 * @param {(string | LocalModuleDependency | AMDRequireItemDependency)[]} depsArray deps array
 	 * @param {Range} range range
 	 */
@@ -39,6 +40,7 @@ class AMDRequireArrayDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -51,6 +53,7 @@ class AMDRequireArrayDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -72,6 +75,7 @@ AMDRequireArrayDependency.Template = class AMDRequireArrayDependencyTemplate ext
 	DependencyTemplate
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object
@@ -84,6 +88,7 @@ AMDRequireArrayDependency.Template = class AMDRequireArrayDependencyTemplate ext
 	}
 
 	/**
+	 * Returns content.
 	 * @param {AMDRequireArrayDependency} dep the dependency for which the template should be applied
 	 * @param {DependencyTemplateContext} templateContext the context object
 	 * @returns {string} content
@@ -96,6 +101,7 @@ AMDRequireArrayDependency.Template = class AMDRequireArrayDependencyTemplate ext
 	}
 
 	/**
+	 * Content for dependency.
 	 * @param {string | LocalModuleDependency | AMDRequireItemDependency} dep the dependency for which the template should be applied
 	 * @param {DependencyTemplateContext} templateContext the context object
 	 * @returns {string} content

package/lib/dependencies/AMDRequireContextDependency.js

@@ -15,6 +15,7 @@ const ContextDependency = require("./ContextDependency");
 
 class AMDRequireContextDependency extends ContextDependency {
 	/**
+	 * Creates an instance of AMDRequireContextDependency.
 	 * @param {ContextDependencyOptions} options options
 	 * @param {Range} range range
 	 * @param {Range} valueRange value range
@@ -35,6 +36,7 @@ class AMDRequireContextDependency extends ContextDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -47,6 +49,7 @@ class AMDRequireContextDependency extends ContextDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/dependencies/AMDRequireDependenciesBlock.js

@@ -12,6 +12,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class AMDRequireDependenciesBlock extends AsyncDependenciesBlock {
 	/**
+	 * Creates an instance of AMDRequireDependenciesBlock.
 	 * @param {DependencyLocation} loc location info
 	 * @param {string=} request request
 	 */