webpack 5.106.1 → 5.106.2

package/lib/javascript/JavascriptParser.js

@@ -94,6 +94,7 @@ const BasicEvaluatedExpression = require("./BasicEvaluatedExpression");
 /** @typedef {import("estree").MaybeNamedFunctionDeclaration} MaybeNamedFunctionDeclaration */
 /** @typedef {import("estree").MaybeNamedClassDeclaration} MaybeNamedClassDeclaration */
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("tapable").AsArray<T>} AsArray<T>
  */
@@ -104,6 +105,7 @@ const BasicEvaluatedExpression = require("./BasicEvaluatedExpression");
 /** @typedef {import("../dependencies/HarmonyExportImportedSpecifierDependency").HarmonyStarExportsList} HarmonyStarExportsList */
 
 /**
+ * Defines the known javascript parser state type used by this module.
  * @typedef {object} KnownJavascriptParserState
  * @property {Set<string>=} harmonyNamedExports
  * @property {HarmonyStarExportsList=} harmonyStarExports
@@ -139,6 +141,7 @@ const LEGACY_ASSERT_ATTRIBUTES = Symbol("assert");
 const importAssertions = (Parser) =>
 	class extends Parser {
 		/**
+		 * Parses with clause.
 		 * @this {InstanceType<AcornParser>}
 		 * @returns {ImportAttribute[]} import attributes
 		 */
@@ -204,6 +207,7 @@ let parser = AcornParser.extend(importAssertions);
 /** @typedef {Record<string, string> & { _isLegacyAssert?: boolean }} ImportAttributes */
 
 /**
+ * Gets import attributes.
  * @param {ImportDeclaration | ExportNamedDeclaration | ExportAllDeclaration | ImportExpression} node node with assertions
  * @returns {ImportAttributes | undefined} import attributes
  */
@@ -287,6 +291,7 @@ const VariableInfoFlags = Object.freeze({
 
 class VariableInfo {
 	/**
+	 * Creates an instance of VariableInfo.
 	 * @param {ScopeInfo} declaredScope scope in which the variable is declared
 	 * @param {string | undefined} name which name the variable use, defined name or free name or tagged name
 	 * @param {VariableInfoFlagsType} flags how the variable is created
@@ -300,6 +305,7 @@ class VariableInfo {
 	}
 
 	/**
+	 * Checks whether this variable info is free.
 	 * @returns {boolean} the variable is free or not
 	 */
 	isFree() {
@@ -307,6 +313,7 @@ class VariableInfo {
 	}
 
 	/**
+	 * Checks whether this variable info is tagged.
 	 * @returns {boolean} the variable is tagged by tagVariable or not
 	 */
 	isTagged() {
@@ -318,10 +325,12 @@ class VariableInfo {
 /** @typedef {Literal | string | null | undefined} ImportSource */
 
 /**
+ * Defines the internal parse options type used by this module.
  * @typedef {Omit<ParseOptions, "sourceType" | "ecmaVersion"> & { sourceType: "module" | "script" | "auto" }} InternalParseOptions
  */
 
 /**
+ * Defines the parse options type used by this module.
  * @typedef {object} ParseOptions
  * @property {"module" | "script"} sourceType
  * @property {EcmaVersion} ecmaVersion
@@ -334,6 +343,7 @@ class VariableInfo {
  */
 
 /**
+ * Defines the parse result type used by this module.
  * @typedef {object} ParseResult
  * @property {Program} ast
  * @property {Comment[]} comments
@@ -341,6 +351,7 @@ class VariableInfo {
  */
 
 /**
+ * Defines the parse function type used by this module.
  * @typedef {(code: string, options: ParseOptions) => ParseResult} ParseFunction
  */
 
@@ -357,6 +368,7 @@ class VariableInfo {
 /** @typedef {KnownTagData | Record<string, EXPECTED_ANY>} TagData */
 
 /**
+ * Defines the tag info type used by this module.
  * @typedef {object} TagInfo
  * @property {Tag} tag
  * @property {TagData=} data
@@ -372,6 +384,7 @@ const SCOPE_INFO_TERMINATED_RETURN = 1;
 const SCOPE_INFO_TERMINATED_THROW = 2;
 
 /**
+ * Defines the scope info type used by this module.
  * @typedef {object} ScopeInfo
  * @property {StackedMap<string, VariableInfo | ScopeInfo>} definitions
  * @property {boolean | "arrow"} topLevelScope
@@ -386,6 +399,7 @@ const SCOPE_INFO_TERMINATED_THROW = 2;
 /** @typedef {[number, number]} Range */
 
 /**
+ * Defines the destructuring assignment property type used by this module.
  * @typedef {object} DestructuringAssignmentProperty
  * @property {string} id
  * @property {Range} range
@@ -479,6 +493,7 @@ const CLASS_NAME = "JavascriptParser";
 
 class JavascriptParser extends Parser {
 	/**
+	 * Creates an instance of JavascriptParser.
 	 * @param {"module" | "script" | "auto"=} sourceType default source type
 	 * @param {{ parse?: ParseFunction }=} options parser options
 	 */
@@ -956,6 +971,7 @@ class JavascriptParser extends Parser {
 				(a === true && b === false) || (a === false && b === true);
 
 			/**
+			 * Handle template string compare.
 			 * @param {BasicEvaluatedExpression} left left
 			 * @param {BasicEvaluatedExpression} right right
 			 * @param {BasicEvaluatedExpression} res res
@@ -964,6 +980,7 @@ class JavascriptParser extends Parser {
 			 */
 			const handleTemplateStringCompare = (left, right, res, eql) => {
 				/**
+				 * Returns value.
 				 * @param {BasicEvaluatedExpression[]} parts parts
 				 * @returns {string} value
 				 */
@@ -977,6 +994,7 @@ class JavascriptParser extends Parser {
 					return value;
 				};
 				/**
+				 * Returns value.
 				 * @param {BasicEvaluatedExpression[]} parts parts
 				 * @returns {string} value
 				 */
@@ -1460,6 +1478,7 @@ class JavascriptParser extends Parser {
 			}
 		});
 		/**
+		 * Tap evaluate with variable info.
 		 * @param {"Identifier" | "ThisExpression" | "MemberExpression"} exprType expression type name
 		 * @param {(node: Expression | SpreadElement) => GetInfoResult | undefined} getInfo get info
 		 * @returns {void}
@@ -1687,6 +1706,7 @@ class JavascriptParser extends Parser {
 		}
 
 		/**
+		 * Gets simplified template result.
 		 * @param {"cooked" | "raw"} kind kind of values to get
 		 * @param {TemplateLiteral} templateLiteralExpr TemplateLiteral expr
 		 * @returns {{ quasis: BasicEvaluatedExpression[], parts: BasicEvaluatedExpression[] }} Simplified template
@@ -1962,6 +1982,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Destructuring assignment properties for.
 	 * @param {Expression} node node
 	 * @returns {DestructuringAssignmentProperties | undefined} destructured identifiers
 	 */
@@ -1971,6 +1992,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Gets rename identifier.
 	 * @param {Expression | SpreadElement} expr expression
 	 * @returns {string | VariableInfo | undefined} identifier
 	 */
@@ -1982,6 +2004,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided classy.
 	 * @param {ClassExpression | ClassDeclaration | MaybeNamedClassDeclaration} classy a class node
 	 * @returns {void}
 	 */
@@ -2166,6 +2189,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Block pre walk statement.
 	 * @param {Statement | ModuleDeclaration | MaybeNamedClassDeclaration | MaybeNamedFunctionDeclaration} statement statement
 	 */
 	blockPreWalkStatement(statement) {
@@ -2199,6 +2223,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided statement.
 	 * @param {Statement | ModuleDeclaration | MaybeNamedFunctionDeclaration | MaybeNamedClassDeclaration} statement statement
 	 */
 	walkStatement(statement) {
@@ -2287,6 +2312,7 @@ class JavascriptParser extends Parser {
 
 	// Real Statements
 	/**
+	 * Pre walk block statement.
 	 * @param {BlockStatement} statement block statement
 	 */
 	preWalkBlockStatement(statement) {
@@ -2294,6 +2320,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk block statement.
 	 * @param {BlockStatement | StaticBlock} statement block statement
 	 */
 	walkBlockStatement(statement) {
@@ -2307,6 +2334,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk expression statement.
 	 * @param {ExpressionStatement} statement expression statement
 	 */
 	walkExpressionStatement(statement) {
@@ -2314,6 +2342,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk if statement.
 	 * @param {IfStatement} statement if statement
 	 */
 	preWalkIfStatement(statement) {
@@ -2324,6 +2353,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided statement.
 	 * @param {IfStatement} statement if statement
 	 */
 	walkIfStatement(statement) {
@@ -2361,6 +2391,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk labeled statement.
 	 * @param {LabeledStatement} statement with statement
 	 */
 	preWalkLabeledStatement(statement) {
@@ -2368,6 +2399,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk labeled statement.
 	 * @param {LabeledStatement} statement with statement
 	 */
 	walkLabeledStatement(statement) {
@@ -2382,6 +2414,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk with statement.
 	 * @param {WithStatement} statement with statement
 	 */
 	preWalkWithStatement(statement) {
@@ -2389,6 +2422,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk with statement.
 	 * @param {WithStatement} statement with statement
 	 */
 	walkWithStatement(statement) {
@@ -2399,6 +2433,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk switch statement.
 	 * @param {SwitchStatement} statement switch statement
 	 */
 	preWalkSwitchStatement(statement) {
@@ -2406,6 +2441,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk switch statement.
 	 * @param {SwitchStatement} statement switch statement
 	 */
 	walkSwitchStatement(statement) {
@@ -2414,6 +2450,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk terminating statement.
 	 * @param {ReturnStatement | ThrowStatement} statement return or throw statement
 	 */
 	walkTerminatingStatement(statement) {
@@ -2429,6 +2466,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk return statement.
 	 * @param {ReturnStatement} statement return statement
 	 */
 	walkReturnStatement(statement) {
@@ -2436,6 +2474,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk throw statement.
 	 * @param {ThrowStatement} statement return statement
 	 */
 	walkThrowStatement(statement) {
@@ -2443,6 +2482,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk try statement.
 	 * @param {TryStatement} statement try statement
 	 */
 	preWalkTryStatement(statement) {
@@ -2452,6 +2492,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk try statement.
 	 * @param {TryStatement} statement try statement
 	 */
 	walkTryStatement(statement) {
@@ -2489,6 +2530,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk while statement.
 	 * @param {WhileStatement} statement while statement
 	 */
 	preWalkWhileStatement(statement) {
@@ -2496,6 +2538,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk while statement.
 	 * @param {WhileStatement} statement while statement
 	 */
 	walkWhileStatement(statement) {
@@ -2506,6 +2549,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk do while statement.
 	 * @param {DoWhileStatement} statement do while statement
 	 */
 	preWalkDoWhileStatement(statement) {
@@ -2513,6 +2557,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk do while statement.
 	 * @param {DoWhileStatement} statement do while statement
 	 */
 	walkDoWhileStatement(statement) {
@@ -2523,6 +2568,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk for statement.
 	 * @param {ForStatement} statement for statement
 	 */
 	preWalkForStatement(statement) {
@@ -2533,6 +2579,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk for statement.
 	 * @param {ForStatement} statement for statement
 	 */
 	walkForStatement(statement) {
@@ -2568,6 +2615,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk for in statement.
 	 * @param {ForInStatement} statement for statement
 	 */
 	preWalkForInStatement(statement) {
@@ -2578,6 +2626,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk for in statement.
 	 * @param {ForInStatement} statement for statement
 	 */
 	walkForInStatement(statement) {
@@ -2606,6 +2655,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk for of statement.
 	 * @param {ForOfStatement} statement statement
 	 */
 	preWalkForOfStatement(statement) {
@@ -2619,6 +2669,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk for of statement.
 	 * @param {ForOfStatement} statement for statement
 	 */
 	walkForOfStatement(statement) {
@@ -2647,6 +2698,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk function declaration.
 	 * @param {FunctionDeclaration | MaybeNamedFunctionDeclaration} statement function declaration
 	 */
 	preWalkFunctionDeclaration(statement) {
@@ -2656,6 +2708,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk function declaration.
 	 * @param {FunctionDeclaration | MaybeNamedFunctionDeclaration} statement function declaration
 	 */
 	walkFunctionDeclaration(statement) {
@@ -2678,6 +2731,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Block pre walk expression statement.
 	 * @param {ExpressionStatement} statement expression statement
 	 */
 	blockPreWalkExpressionStatement(statement) {
@@ -2689,6 +2743,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk assignment expression.
 	 * @param {AssignmentExpression} expression assignment expression
 	 */
 	preWalkAssignmentExpression(expression) {
@@ -2696,6 +2751,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Enter destructuring assignment.
 	 * @param {Pattern} pattern pattern
 	 * @param {Expression} expression assignment expression
 	 * @returns {Expression | undefined} destructuring expression
@@ -2737,6 +2793,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Module pre walk import declaration.
 	 * @param {ImportDeclaration} statement statement
 	 */
 	modulePreWalkImportDeclaration(statement) {
@@ -2782,6 +2839,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided declaration.
 	 * @param {Declaration} declaration declaration
 	 * @param {OnIdent} onIdent on ident callback
 	 */
@@ -2807,6 +2865,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Module pre walk export named declaration.
 	 * @param {ExportNamedDeclaration} statement statement
 	 */
 	modulePreWalkExportNamedDeclaration(statement) {
@@ -2847,6 +2906,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Block pre walk export named declaration.
 	 * @param {ExportNamedDeclaration} statement statement
 	 */
 	blockPreWalkExportNamedDeclaration(statement) {
@@ -2898,6 +2958,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk export named declaration.
 	 * @param {ExportNamedDeclaration} statement the statement
 	 */
 	walkExportNamedDeclaration(statement) {
@@ -2907,6 +2968,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Block pre walk export default declaration.
 	 * @param {ExportDefaultDeclaration} statement statement
 	 */
 	blockPreWalkExportDefaultDeclaration(statement) {
@@ -2942,6 +3004,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk export default declaration.
 	 * @param {ExportDefaultDeclaration} statement statement
 	 */
 	walkExportDefaultDeclaration(statement) {
@@ -2976,6 +3039,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Module pre walk export all declaration.
 	 * @param {ExportAllDeclaration} statement statement
 	 */
 	modulePreWalkExportAllDeclaration(statement) {
@@ -2991,6 +3055,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk variable declaration.
 	 * @param {VariableDeclaration} statement variable declaration
 	 */
 	preWalkVariableDeclaration(statement) {
@@ -2999,6 +3064,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Block pre walk variable declaration.
 	 * @param {VariableDeclaration} statement variable declaration
 	 */
 	blockPreWalkVariableDeclaration(statement) {
@@ -3014,6 +3080,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk variable declaration.
 	 * @param {VariableDeclaration} statement variable declaration
 	 * @param {HookMap<SyncBailHook<[Identifier], boolean | void>>} hookMap map of hooks
 	 */
@@ -3040,6 +3107,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk object pattern.
 	 * @param {ObjectPattern} objectPattern object pattern
 	 * @returns {DestructuringAssignmentProperties | undefined} set of names or undefined if not all keys are identifiers
 	 */
@@ -3104,6 +3172,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk array pattern.
 	 * @param {ArrayPattern} arrayPattern array pattern
 	 * @returns {Set<DestructuringAssignmentProperty> | undefined} set of names or undefined if not all keys are identifiers
 	 */
@@ -3134,6 +3203,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk variable declarator.
 	 * @param {VariableDeclarator} declarator variable declarator
 	 */
 	preWalkVariableDeclarator(declarator) {
@@ -3143,6 +3213,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk variable declaration.
 	 * @param {VariableDeclaration} statement variable declaration
 	 */
 	walkVariableDeclaration(statement) {
@@ -3179,6 +3250,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Block pre walk class declaration.
 	 * @param {ClassDeclaration | MaybeNamedClassDeclaration} statement class declaration
 	 */
 	blockPreWalkClassDeclaration(statement) {
@@ -3188,6 +3260,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk class declaration.
 	 * @param {ClassDeclaration | MaybeNamedClassDeclaration} statement class declaration
 	 */
 	walkClassDeclaration(statement) {
@@ -3195,6 +3268,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk switch cases.
 	 * @param {SwitchCase[]} switchCases switch statement
 	 */
 	preWalkSwitchCases(switchCases) {
@@ -3205,6 +3279,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided switch case.
 	 * @param {SwitchCase[]} switchCases switch statement
 	 */
 	walkSwitchCases(switchCases) {
@@ -3245,6 +3320,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Pre walk catch clause.
 	 * @param {CatchClause} catchClause catch clause
 	 */
 	preWalkCatchClause(catchClause) {
@@ -3252,6 +3328,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided catch clause.
 	 * @param {CatchClause} catchClause catch clause
 	 */
 	walkCatchClause(catchClause) {
@@ -3271,6 +3348,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided pattern.
 	 * @param {Pattern} pattern pattern
 	 */
 	walkPattern(pattern) {
@@ -3294,6 +3372,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk assignment pattern.
 	 * @param {AssignmentPattern} pattern assignment pattern
 	 */
 	walkAssignmentPattern(pattern) {
@@ -3302,6 +3381,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk object pattern.
 	 * @param {ObjectPattern} pattern pattern
 	 */
 	walkObjectPattern(pattern) {
@@ -3318,6 +3398,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk array pattern.
 	 * @param {ArrayPattern} pattern array pattern
 	 */
 	walkArrayPattern(pattern) {
@@ -3328,6 +3409,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided pattern.
 	 * @param {RestElement} pattern rest element
 	 */
 	walkRestElement(pattern) {
@@ -3335,6 +3417,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided expression.
 	 * @param {(Expression | SpreadElement | null)[]} expressions expressions
 	 */
 	walkExpressions(expressions) {
@@ -3346,6 +3429,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided expression.
 	 * @param {Expression | SpreadElement | PrivateIdentifier | Super} expression expression
 	 */
 	walkExpression(expression) {
@@ -3429,6 +3513,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk await expression.
 	 * @param {AwaitExpression} expression await expression
 	 */
 	walkAwaitExpression(expression) {
@@ -3439,6 +3524,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk array expression.
 	 * @param {ArrayExpression} expression array expression
 	 */
 	walkArrayExpression(expression) {
@@ -3448,6 +3534,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk spread element.
 	 * @param {SpreadElement} expression spread element
 	 */
 	walkSpreadElement(expression) {
@@ -3457,6 +3544,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk object expression.
 	 * @param {ObjectExpression} expression object expression
 	 */
 	walkObjectExpression(expression) {
@@ -3471,6 +3559,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided prop.
 	 * @param {Property | SpreadElement} prop property or spread element
 	 */
 	walkProperty(prop) {
@@ -3494,6 +3583,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk function expression.
 	 * @param {FunctionExpression} expression arrow function expression
 	 */
 	walkFunctionExpression(expression) {
@@ -3523,6 +3613,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk arrow function expression.
 	 * @param {ArrowFunctionExpression} expression arrow function expression
 	 */
 	walkArrowFunctionExpression(expression) {
@@ -3546,6 +3637,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk sequence expression.
 	 * @param {SequenceExpression} expression the sequence
 	 */
 	walkSequenceExpression(expression) {
@@ -3584,6 +3676,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk update expression.
 	 * @param {UpdateExpression} expression the update expression
 	 */
 	walkUpdateExpression(expression) {
@@ -3591,6 +3684,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk unary expression.
 	 * @param {UnaryExpression} expression the unary expression
 	 */
 	walkUnaryExpression(expression) {
@@ -3614,6 +3708,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk left right expression.
 	 * @param {LogicalExpression | BinaryExpression} expression the expression
 	 */
 	walkLeftRightExpression(expression) {
@@ -3622,6 +3717,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk binary expression.
 	 * @param {BinaryExpression} expression the binary expression
 	 */
 	walkBinaryExpression(expression) {
@@ -3631,6 +3727,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk logical expression.
 	 * @param {LogicalExpression} expression the logical expression
 	 */
 	walkLogicalExpression(expression) {
@@ -3643,6 +3740,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk assignment expression.
 	 * @param {AssignmentExpression} expression assignment expression
 	 */
 	walkAssignmentExpression(expression) {
@@ -3718,6 +3816,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk conditional expression.
 	 * @param {ConditionalExpression} expression conditional expression
 	 */
 	walkConditionalExpression(expression) {
@@ -3745,6 +3844,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk new expression.
 	 * @param {NewExpression} expression new expression
 	 */
 	walkNewExpression(expression) {
@@ -3761,6 +3861,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk yield expression.
 	 * @param {YieldExpression} expression yield expression
 	 */
 	walkYieldExpression(expression) {
@@ -3770,6 +3871,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk template literal.
 	 * @param {TemplateLiteral} expression template literal
 	 */
 	walkTemplateLiteral(expression) {
@@ -3779,6 +3881,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk tagged template expression.
 	 * @param {TaggedTemplateExpression} expression tagged template expression
 	 */
 	walkTaggedTemplateExpression(expression) {
@@ -3793,6 +3896,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk class expression.
 	 * @param {ClassExpression} expression the class expression
 	 */
 	walkClassExpression(expression) {
@@ -3800,6 +3904,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk chain expression.
 	 * @param {ChainExpression} expression expression
 	 */
 	walkChainExpression(expression) {
@@ -3815,6 +3920,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided function expression.
 	 * @private
 	 * @param {FunctionExpression | ArrowFunctionExpression} functionExpression function expression
 	 * @param {(Expression | SpreadElement)[]} options options
@@ -3822,6 +3928,7 @@ class JavascriptParser extends Parser {
 	 */
 	_walkIIFE(functionExpression, options, currentThis) {
 		/**
+		 * Returns var info.
 		 * @param {Expression | SpreadElement} argOrThis arg or this
 		 * @returns {string | VariableInfo | undefined} var info
 		 */
@@ -3890,6 +3997,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk import expression.
 	 * @param {ImportExpression} expression import expression
 	 */
 	walkImportExpression(expression) {
@@ -3900,10 +4008,12 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk call expression.
 	 * @param {CallExpression} expression expression
 	 */
 	walkCallExpression(expression) {
 		/**
+		 * Checks whether this javascript parser is simple function.
 		 * @param {FunctionExpression | ArrowFunctionExpression} fn function
 		 * @returns {boolean} true when simple function
 		 */
@@ -4019,6 +4129,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk member expression.
 	 * @param {MemberExpression} expression member expression
 	 */
 	walkMemberExpression(expression) {
@@ -4085,6 +4196,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk member expression with expression name.
 	 * @template R
 	 * @param {MemberExpression} expression member expression
 	 * @param {string} name name
@@ -4128,6 +4240,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk this expression.
 	 * @param {ThisExpression} expression this expression
 	 */
 	walkThisExpression(expression) {
@@ -4135,6 +4248,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided expression.
 	 * @param {Identifier} expression identifier
 	 */
 	walkIdentifier(expression) {
@@ -4142,6 +4256,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Walk meta property.
 	 * @param {MetaProperty} metaProperty meta property
 	 */
 	walkMetaProperty(metaProperty) {
@@ -4149,6 +4264,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Call hooks for expression.
 	 * @template T
 	 * @template R
 	 * @param {HookMap<SyncBailHook<T, R>>} hookMap hooks the should be called
@@ -4167,6 +4283,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Call hooks for expression with fallback.
 	 * @template T
 	 * @template R
 	 * @param {HookMap<SyncBailHook<T, R>>} hookMap hooks the should be called
@@ -4201,6 +4318,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Call hooks for name.
 	 * @template T
 	 * @template R
 	 * @param {HookMap<SyncBailHook<T, R>>} hookMap hooks the should be called
@@ -4219,6 +4337,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Call hooks for info.
 	 * @template T
 	 * @template R
 	 * @param {HookMap<SyncBailHook<T, R>>} hookMap hooks that should be called
@@ -4237,6 +4356,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Call hooks for info with fallback.
 	 * @template T
 	 * @template R
 	 * @param {HookMap<SyncBailHook<T, R>>} hookMap hooks the should be called
@@ -4288,6 +4408,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Call hooks for name with fallback.
 	 * @template T
 	 * @template R
 	 * @param {HookMap<SyncBailHook<T, R>>} hookMap hooks the should be called
@@ -4308,6 +4429,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided param.
 	 * @deprecated
 	 * @param {(string | Pattern | Property)[]} params scope params
 	 * @param {() => void} fn inner function
@@ -4338,6 +4460,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided has thi.
 	 * @param {boolean} hasThis true, when this is defined
 	 * @param {Identifier[]} params scope params
 	 * @param {() => void} fn inner function
@@ -4370,6 +4493,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided has thi.
 	 * @param {boolean} hasThis true, when this is defined
 	 * @param {(Pattern | string)[]} params scope params
 	 * @param {() => void} fn inner function
@@ -4402,6 +4526,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided fn.
 	 * @param {() => void} fn inner function
 	 * @param {boolean} inExecutedPath executed state
 	 * @returns {void}
@@ -4431,6 +4556,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided statement.
 	 * @param {(Directive | Statement | ModuleDeclaration)[]} statements statements
 	 */
 	detectMode(statements) {
@@ -4457,6 +4583,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided pattern.
 	 * @param {(string | Pattern | Property)[]} patterns patterns
 	 * @param {OnIdentString} onIdent on ident callback
 	 */
@@ -4471,6 +4598,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided pattern.
 	 * @param {Pattern | Property} pattern pattern
 	 * @param {OnIdent} onIdent on ident callback
 	 */
@@ -4505,6 +4633,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided pattern.
 	 * @param {Identifier} pattern identifier pattern
 	 * @param {OnIdent} onIdent callback
 	 */
@@ -4515,6 +4644,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Enter object pattern.
 	 * @param {ObjectPattern} pattern object pattern
 	 * @param {OnIdent} onIdent callback
 	 */
@@ -4530,6 +4660,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Enter array pattern.
 	 * @param {ArrayPattern} pattern object pattern
 	 * @param {OnIdent} onIdent callback
 	 */
@@ -4548,6 +4679,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Enter rest element.
 	 * @param {RestElement} pattern object pattern
 	 * @param {OnIdent} onIdent callback
 	 */
@@ -4556,6 +4688,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Enter assignment pattern.
 	 * @param {AssignmentPattern} pattern object pattern
 	 * @param {OnIdent} onIdent callback
 	 */
@@ -4564,6 +4697,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Evaluate expression.
 	 * @param {Expression | SpreadElement | PrivateIdentifier | Super} expression expression node
 	 * @returns {BasicEvaluatedExpression} evaluation result
 	 */
@@ -4588,6 +4722,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Returns parsed string.
 	 * @param {Expression} expression expression
 	 * @returns {string} parsed string
 	 */
@@ -4612,6 +4747,7 @@ class JavascriptParser extends Parser {
 	/** @typedef {{ range?: Range, value: string, code: boolean, conditional: false | CalculatedStringResult[] }} CalculatedStringResult */
 
 	/**
+	 * Parses calculated string.
 	 * @param {Expression} expression expression
 	 * @returns {CalculatedStringResult} result
 	 */
@@ -4701,6 +4837,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Parses the provided source and updates the parser state.
 	 * @param {string | Buffer | PreparsedAst} source the source to parse
 	 * @param {ParserState} state the parser state
 	 * @returns {ParserState} the parser state
@@ -4789,6 +4926,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Returns evaluation result.
 	 * @param {string} source source code
 	 * @returns {BasicEvaluatedExpression} evaluation result
 	 */
@@ -4805,6 +4943,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Checks whether this javascript parser is pure.
 	 * @param {Expression | Declaration | PrivateIdentifier | MaybeNamedFunctionDeclaration | MaybeNamedClassDeclaration | null | undefined} expr an expression
 	 * @param {number} commentsStartPos source position from which annotation comments are checked
 	 * @returns {boolean} true, when the expression is pure
@@ -4938,12 +5077,14 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Returns comments in the range.
 	 * @param {Range} range range
 	 * @returns {Comment[]} comments in the range
 	 */
 	getComments(range) {
 		const [rangeStart, rangeEnd] = range;
 		/**
+		 * Returns compared.
 		 * @param {Comment} comment comment
 		 * @param {number} needle needle
 		 * @returns {number} compared
@@ -4966,6 +5107,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Checks whether this javascript parser is asi position.
 	 * @param {number} pos source code position
 	 * @returns {boolean} true when a semicolon has been inserted before this position, false if not
 	 */
@@ -4996,6 +5138,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Updates asi position using the provided po.
 	 * @param {number} pos source code position
 	 * @returns {void}
 	 */
@@ -5004,6 +5147,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Unset asi position.
 	 * @param {number} pos source code position
 	 * @returns {void}
 	 */
@@ -5012,6 +5156,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Checks whether this javascript parser is statement level expression.
 	 * @param {Expression} expr expression
 	 * @returns {boolean} true, when the expression is a statement level expression
 	 */
@@ -5030,6 +5175,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Returns tag data.
 	 * @param {string} name name
 	 * @param {Tag} tag tag info
 	 * @returns {TagData | undefined} tag data
@@ -5046,6 +5192,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided name.
 	 * @param {string} name name
 	 * @param {Tag} tag tag info
 	 * @param {TagData=} data data
@@ -5083,6 +5230,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided name.
 	 * @param {string} name variable name
 	 */
 	defineVariable(name) {
@@ -5098,6 +5246,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Processes the provided name.
 	 * @param {string} name variable name
 	 */
 	undefineVariable(name) {
@@ -5105,6 +5254,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Checks whether this javascript parser is variable defined.
 	 * @param {string} name variable name
 	 * @returns {boolean} true, when variable is defined
 	 */
@@ -5118,6 +5268,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Gets variable info.
 	 * @param {string} name variable name
 	 * @returns {ExportedVariableInfo} info for this variable
 	 */
@@ -5130,6 +5281,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Updates variable using the provided name.
 	 * @param {string} name variable name
 	 * @param {ExportedVariableInfo} variableInfo new info for this variable
 	 * @returns {void}
@@ -5155,6 +5307,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Evaluated variable.
 	 * @param {TagInfo} tagInfo tag info
 	 * @returns {VariableInfo} variable info
 	 */
@@ -5168,6 +5321,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Parses comment options.
 	 * @param {Range} range range of the comment
 	 * @returns {{ options: Record<string, EXPECTED_ANY> | null, errors: (Error & { comment: Comment })[] | null }} result
 	 */
@@ -5211,6 +5365,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Extract member expression chain.
 	 * @param {Expression | Super} expression a member expression
 	 * @returns {{ members: Members, object: Expression | Super, membersOptionals: MembersOptionals, memberRanges: MemberRanges }} member names (reverse order) and remaining object
 	 */
@@ -5246,6 +5401,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Gets free info from variable.
 	 * @param {string} varName variable name
 	 * @returns {{ name: string, info: VariableInfo | string } | undefined} name of the free variable and variable info for that
 	 */
@@ -5265,6 +5421,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Gets name info from variable.
 	 * @param {string} varName variable name
 	 * @returns {{ name: string, info: VariableInfo | string } | undefined} name of the free variable and variable info for that
 	 */
@@ -5287,6 +5444,7 @@ class JavascriptParser extends Parser {
 	/** @typedef {{ type: "expression", rootInfo: string | VariableInfo, name: string, getMembers: () => Members, getMembersOptionals: () => MembersOptionals, getMemberRanges: () => MemberRanges }} ExpressionExpressionInfo */
 
 	/**
+	 * Gets member expression info.
 	 * @param {Expression | Super} expression a member expression
 	 * @param {number} allowedTypes which types should be returned, presented in bit mask
 	 * @returns {CallExpressionInfo | ExpressionExpressionInfo | undefined} expression info
@@ -5344,6 +5502,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Gets name for expression.
 	 * @param {Expression} expression an expression
 	 * @returns {{ name: string, rootInfo: ExportedVariableInfo, getMembers: () => Members } | undefined} name info
 	 */
@@ -5355,6 +5514,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Get module parse function.
 	 * @param {Compilation} compilation compilation
 	 * @param {Module} module module
 	 * @returns {ParseFunction | undefined} parser
@@ -5375,6 +5535,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Returns parse result.
 	 * @param {string} code source code
 	 * @param {InternalParseOptions} options parsing options
 	 * @param {ParseFunction=} customParse custom function to parse
@@ -5390,6 +5551,7 @@ class JavascriptParser extends Parser {
 			sourceType: type === "auto" ? "module" : type
 		};
 		/**
+		 * Returns parse result.
 		 * @param {string} code source code
 		 * @param {ParseOptions} options parsing options
 		 * @returns {ParseResult} parse result
@@ -5458,6 +5620,7 @@ class JavascriptParser extends Parser {
 	}
 
 	/**
+	 * Returns parser.
 	 * @param {((BaseParser: typeof AcornParser) => typeof AcornParser)[]} plugins parser plugin
 	 * @returns {typeof JavascriptParser} parser
 	 */