webpack 5.106.1 → 5.107.0

package/lib/css/walkCssTokens.js

@@ -5,7 +5,10 @@
 
 "use strict";
 
+const { makeCacheable } = require("../util/identifier");
+
 /**
+ * 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 +114,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 +122,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 +137,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
  */
@@ -156,6 +163,143 @@ const isIdentStartCodePoint = (cc) =>
 	cc === CC_LOW_LINE ||
 	cc >= 0x80;
 
+const REGEX_SINGLE_ESCAPE = /[ -,./:-@[\]^`{-~]/;
+const REGEX_EXCESSIVE_SPACES = /(^|\\+)?(\\[A-F0-9]{1,6}) (?![a-fA-F0-9 ])/g;
+const REGEX_CTRL_WHITESPACE = /[\t\n\f\r\v]/;
+const REGEX_LEADING_HYPHEN_DIGIT = /^-[-\d]/;
+const REGEX_DIGIT = /\d/;
+const CONTAINS_ESCAPE = /\\/;
+
+/**
+ * Returns escaped identifier.
+ * @param {string} str string
+ * @returns {string} escaped identifier
+ */
+const _escapeIdentifier = (str) => {
+	let output = "";
+	let counter = 0;
+
+	while (counter < str.length) {
+		const character = str.charAt(counter++);
+
+		/** @type {string} */
+		let value;
+
+		if (REGEX_CTRL_WHITESPACE.test(character)) {
+			const codePoint = character.charCodeAt(0);
+
+			value = `\\${codePoint.toString(16).toUpperCase()} `;
+		} else if (character === "\\" || REGEX_SINGLE_ESCAPE.test(character)) {
+			value = `\\${character}`;
+		} else {
+			value = character;
+		}
+
+		output += value;
+	}
+
+	const firstChar = str.charAt(0);
+
+	if (REGEX_LEADING_HYPHEN_DIGIT.test(output)) {
+		output = `\\-${output.slice(1)}`;
+	} else if (REGEX_DIGIT.test(firstChar)) {
+		output = `\\3${firstChar} ${output.slice(1)}`;
+	}
+
+	// Remove spaces after `\HEX` escapes that are not followed by a hex digit,
+	// since they’re redundant. Note that this is only possible if the escape
+	// sequence isn’t preceded by an odd number of backslashes.
+	output = output.replace(REGEX_EXCESSIVE_SPACES, ($0, $1, $2) => {
+		if ($1 && $1.length % 2) {
+			// It’s not safe to remove the space, so don’t.
+			return $0;
+		}
+
+		// Strip the space.
+		return ($1 || "") + $2;
+	});
+
+	return output;
+};
+
+/**
+ * Returns hex.
+ * @param {string} str string
+ * @returns {[string, number] | undefined} hex
+ */
+const gobbleHex = (str) => {
+	const lower = str.toLowerCase();
+	let hex = "";
+	let spaceTerminated = false;
+
+	for (let i = 0; i < 6 && lower[i] !== undefined; i++) {
+		const code = lower.charCodeAt(i);
+		// check to see if we are dealing with a valid hex char [a-f|0-9]
+		const valid = (code >= 97 && code <= 102) || (code >= 48 && code <= 57);
+		// https://drafts.csswg.org/css-syntax/#consume-escaped-code-point
+		spaceTerminated = code === 32;
+		if (!valid) break;
+		hex += lower[i];
+	}
+
+	if (hex.length === 0) return undefined;
+
+	const codePoint = Number.parseInt(hex, 16);
+	const isSurrogate = codePoint >= 0xd800 && codePoint <= 0xdfff;
+
+	// Add special case for
+	// "If this number is zero, or is for a surrogate, or is greater than the maximum allowed code point"
+	// https://drafts.csswg.org/css-syntax/#maximum-allowed-code-point
+	if (isSurrogate || codePoint === 0x0000 || codePoint > 0x10ffff) {
+		return ["�", hex.length + (spaceTerminated ? 1 : 0)];
+	}
+
+	return [
+		String.fromCodePoint(codePoint),
+		hex.length + (spaceTerminated ? 1 : 0)
+	];
+};
+
+/**
+ * Unescape identifier.
+ * @param {string} str string
+ * @returns {string} unescaped string
+ */
+const _unescapeIdentifier = (str) => {
+	const needToProcess = CONTAINS_ESCAPE.test(str);
+	if (!needToProcess) return str;
+	let ret = "";
+	for (let i = 0; i < str.length; i++) {
+		if (str[i] === "\\") {
+			const gobbled = gobbleHex(str.slice(i + 1, i + 7));
+			if (gobbled !== undefined) {
+				ret += gobbled[0];
+				i += gobbled[1];
+				continue;
+			}
+			// Retain a pair of \\ if double escaped `\\\\`
+			// https://github.com/postcss/postcss-selector-parser/commit/268c9a7656fb53f543dc620aa5b73a30ec3ff20e
+			if (str[i + 1] === "\\") {
+				ret += "\\";
+				i += 1;
+				continue;
+			}
+			// if \\ is at the end of the string retain it
+			// https://github.com/postcss/postcss-selector-parser/commit/01a6b346e3612ce1ab20219acc26abdc259ccefb
+			if (str.length === i + 1) {
+				ret += str[i];
+			}
+			continue;
+		}
+		ret += str[i];
+	}
+
+	return ret;
+};
+
+const escapeIdentifier = makeCacheable(_escapeIdentifier);
+const unescapeIdentifier = makeCacheable(_unescapeIdentifier);
+
 /** @type {CharHandler} */
 const consumeDelimToken = (input, pos, callbacks) => {
 	// Return a <delim-token> with its value set to the current input code point.
@@ -207,6 +351,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 +361,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 +485,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 +495,7 @@ const isNonASCIICodePoint = (cc, q) =>
 	cc > 0x80;
 
 /**
+ * Checks whether this object is letter.
  * @param {number} cc char code
  * @returns {boolean} is letter
  */
@@ -356,6 +504,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 +513,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 +521,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 +553,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 +606,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 +1027,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 +1038,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 +1080,7 @@ const consumeTheRemnantsOfABadUrl = (input, pos) => {
 };
 
 /**
+ * Consume a url token.
  * @param {string} input input
  * @param {number} pos position
  * @param {number} fnStart start
@@ -1285,6 +1442,7 @@ const consumeAToken = (input, pos, callbacks) => {
 };
 
 /**
+ * Returns pos.
  * @param {string} input input css
  * @param {number=} pos pos
  * @param {CssTokenCallbacks=} callbacks callbacks
@@ -1309,6 +1467,7 @@ module.exports = (input, pos = 0, callbacks = {}) => {
 };
 
 /**
+ * Returns pos.
  * @param {string} input input css
  * @param {number} pos pos
  * @param {CssTokenCallbacks} callbacks callbacks
@@ -1411,6 +1570,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 +1588,7 @@ const eatComments = (input, pos) => {
 };
 
 /**
+ * Returns position after whitespace.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position after whitespace
@@ -1441,6 +1602,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 +1628,7 @@ const eatWhitespaceAndComments = (input, pos) => {
 };
 
 /**
+ * Returns position after whitespace.
  * @param {string} input input
  * @param {number} pos position
  * @returns {number} position after whitespace
@@ -1486,6 +1649,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 +1675,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 +1696,7 @@ const eatString = (input, pos) => {
 };
 
 /**
+ * Eat image set strings.
  * @param {string} input input
  * @param {number} pos position
  * @param {CssTokenCallbacks} cbs callbacks
@@ -1601,14 +1767,15 @@ const eatImageSetStrings = (input, pos, cbs) => {
 };
 
 /**
+ * Returns positions of top level tokens.
  * @param {string} input input
  * @param {number} pos position
  * @param {CssTokenCallbacks} cbs callbacks
- * @returns {[[number, number, number, number] | undefined, [number, number] | undefined, [number, number] | undefined, [number, number] | undefined]} positions of top level tokens
+ * @returns {[[number, number, number, number, boolean?] | undefined, [number, number] | undefined, [number, number] | undefined, [number, number] | undefined]} positions of top level tokens — the URL tuple's optional 5th element is `true` when the URL was given as an identifier (CSS Modules `@value` reference)
  */
 const eatImportTokens = (input, pos, cbs) => {
 	const result =
-		/** @type {[[number, number, number, number] | undefined, [number, number] | undefined, [number, number] | undefined, [number, number] | undefined]} */
+		/** @type {[[number, number, number, number, boolean?] | undefined, [number, number] | undefined, [number, number] | undefined, [number, number] | undefined]} */
 		(Array.from({ length: 4 }));
 
 	/** @type {0 | 1 | 2 | undefined} */
@@ -1712,6 +1879,11 @@ const eatImportTokens = (input, pos, cbs) => {
 				if (name === "layer") {
 					result[1] = [start, end];
 					scope = undefined;
+				} else if (result[0] === undefined) {
+					// Capture as URL identifier (e.g. `@import myValue;` where
+					// `myValue` is a CSS Modules `@value` definition).
+					result[0] = [start, end, start, end, true];
+					scope = undefined;
 				}
 			}
 
@@ -1744,6 +1916,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 +1942,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 +1973,7 @@ const eatIdentSequenceOrString = (input, pos) => {
 };
 
 /**
+ * Returns function to eat characters.
  * @param {string} chars characters
  * @returns {(input: string, pos: number) => number} function to eat characters
  */
@@ -1837,7 +2012,9 @@ module.exports.eatUntil = eatUntil;
 module.exports.eatWhiteLine = eatWhiteLine;
 module.exports.eatWhitespace = eatWhitespace;
 module.exports.eatWhitespaceAndComments = eatWhitespaceAndComments;
+module.exports.escapeIdentifier = escapeIdentifier;
 module.exports.isIdentStartCodePoint = isIdentStartCodePoint;
 module.exports.isWhiteSpace = _isWhiteSpace;
 module.exports.skipCommentsAndEatIdentSequence =
 	skipCommentsAndEatIdentSequence;
+module.exports.unescapeIdentifier = unescapeIdentifier;

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