eslint 10.0.0 → 10.0.3

package/README.md

@@ -43,7 +43,13 @@ ESLint is a tool for identifying and reporting on patterns found in ECMAScript/J
 
 ## Installation and Usage
 
-Prerequisites: [Node.js](https://nodejs.org/) (`^20.19.0`, `^22.13.0`, or `>=24`) built with SSL support. (If you are using an official Node.js distribution, SSL is always built in.)
+### Prerequisites
+
+To use ESLint, you must have [Node.js](https://nodejs.org/) (`^20.19.0`, `^22.13.0`, or `>=24`) installed and built with SSL support. (If you are using an official Node.js distribution, SSL is always built in.)
+
+If you use ESLint's TypeScript type definitions, TypeScript 5.3 or later is required.
+
+### npm Installation
 
 You can install and configure ESLint using this command:
 
@@ -350,8 +356,8 @@ to get your logo on our READMEs and [website](https://eslint.org/sponsors).
 
 <h3>Platinum Sponsors</h3>
 <p><a href="https://automattic.com"><img src="https://images.opencollective.com/automattic/d0ef3e1/logo.png" alt="Automattic" height="128"></a></p><h3>Gold Sponsors</h3>
-<p><a href="https://qlty.sh/"><img src="https://images.opencollective.com/qltysh/33d157d/logo.png" alt="Qlty Software" height="96"></a> <a href="https://shopify.engineering/"><img src="https://avatars.githubusercontent.com/u/8085" alt="Shopify" height="96"></a></p><h3>Silver Sponsors</h3>
-<p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/d472863/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/2d6c3b6/logo.png" alt="Liftoff" height="64"></a> <a href="https://americanexpress.io"><img src="https://avatars.githubusercontent.com/u/3853301" alt="American Express" height="64"></a> <a href="https://stackblitz.com"><img src="https://avatars.githubusercontent.com/u/28635252" alt="StackBlitz" height="64"></a></p><h3>Bronze Sponsors</h3>
+<p><a href="https://qlty.sh/"><img src="https://images.opencollective.com/qltysh/33d157d/logo.png" alt="Qlty Software" height="96"></a></p><h3>Silver Sponsors</h3>
+<p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/d472863/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/2d6c3b6/logo.png" alt="Liftoff" height="64"></a> <a href="https://stackblitz.com"><img src="https://avatars.githubusercontent.com/u/28635252" alt="StackBlitz" height="64"></a></p><h3>Bronze Sponsors</h3>
 <p><a href="https://cybozu.co.jp/"><img src="https://images.opencollective.com/cybozu/933e46d/logo.png" alt="Cybozu" height="32"></a> <a href="https://opensource.sap.com"><img src="https://avatars.githubusercontent.com/u/2531208" alt="SAP" height="32"></a> <a href="https://www.crawljobs.com/"><img src="https://images.opencollective.com/crawljobs-poland/fa43a17/logo.png" alt="CrawlJobs" height="32"></a> <a href="https://depot.dev"><img src="https://images.opencollective.com/depot/39125a1/logo.png" alt="Depot" height="32"></a> <a href="https://www.n-ix.com/"><img src="https://images.opencollective.com/n-ix-ltd/575a7a5/logo.png" alt="N-iX Ltd" height="32"></a> <a href="https://icons8.com/"><img src="https://images.opencollective.com/icons8/7fa1641/logo.png" alt="Icons8" height="32"></a> <a href="https://discord.com"><img src="https://images.opencollective.com/discordapp/f9645d9/logo.png" alt="Discord" height="32"></a> <a href="https://www.gitbook.com"><img src="https://avatars.githubusercontent.com/u/7111340" alt="GitBook" height="32"></a> <a href="https://herocoders.com"><img src="https://avatars.githubusercontent.com/u/37549774" alt="HeroCoders" height="32"></a> <a href="https://www.lambdatest.com"><img src="https://avatars.githubusercontent.com/u/171592363" alt="TestMu AI Open Source Office (Formerly LambdaTest)" height="32"></a></p>
 <h3>Technology Sponsors</h3>
 Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.

package/lib/cli.js

@@ -499,7 +499,7 @@ const cli = {
 
 				if (unusedSuppressionsCount > 0) {
 					log.error(
-						"There are suppressions left that do not occur anymore. Consider re-running the command with `--prune-suppressions`.",
+						"There are suppressions left that do not occur anymore. To resolve this, re-run the command with `--prune-suppressions` to remove unused suppressions. To ignore unused suppressions, use `--pass-on-unpruned-suppressions`.",
 					);
 					debug(JSON.stringify(unusedSuppressions, null, 2));
 

package/lib/rules/block-scoped-var.js

@@ -4,6 +4,13 @@
  */
 "use strict";
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Definition} Definition */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -51,8 +58,8 @@ module.exports = {
 
 		/**
 		 * Reports a given reference.
-		 * @param {eslint-scope.Reference} reference A reference to report.
-		 * @param {eslint-scope.Definition} definition A definition for which to report reference.
+		 * @param {Reference} reference A reference to report.
+		 * @param {Definition} definition A definition for which to report reference.
 		 * @returns {void}
 		 */
 		function report(reference, definition) {

package/lib/rules/func-names.js

@@ -11,9 +11,19 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Variable} Variable */
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
 /**
  * Checks whether or not a given variable is a function name.
- * @param {eslint-scope.Variable} variable A variable to check.
+ * @param {Variable} variable A variable to check.
  * @returns {boolean} `true` if the variable is a function name.
  */
 function isFunctionName(variable) {

package/lib/rules/no-console.js

@@ -11,6 +11,12 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -62,7 +68,7 @@ module.exports = {
 
 		/**
 		 * Checks whether the given reference is 'console' or not.
-		 * @param {eslint-scope.Reference} reference The reference to check.
+		 * @param {Reference} reference The reference to check.
 		 * @returns {boolean} `true` if the reference is 'console'.
 		 */
 		function isConsole(reference) {
@@ -86,7 +92,7 @@ module.exports = {
 		/**
 		 * Checks whether the given reference is a member access which is not
 		 * allowed by options or not.
-		 * @param {eslint-scope.Reference} reference The reference to check.
+		 * @param {Reference} reference The reference to check.
 		 * @returns {boolean} `true` if the reference is a member access which
 		 *      is not allowed by options.
 		 */
@@ -163,7 +169,7 @@ module.exports = {
 
 		/**
 		 * Reports the given reference as a violation.
-		 * @param {eslint-scope.Reference} reference The reference to report.
+		 * @param {Reference} reference The reference to report.
 		 * @returns {void}
 		 */
 		function report(reference) {

package/lib/rules/no-dupe-args.js

@@ -11,6 +11,12 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Definition} Definition */
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -43,7 +49,7 @@ module.exports = {
 
 		/**
 		 * Checks whether or not a given definition is a parameter's.
-		 * @param {eslint-scope.DefEntry} def A definition to check.
+		 * @param {Definition} def A definition to check.
 		 * @returns {boolean} `true` if the definition is a parameter's.
 		 */
 		function isParameter(def) {

package/lib/rules/no-else-return.js

@@ -12,6 +12,12 @@
 const astUtils = require("./utils/ast-utils");
 const FixTracker = require("./utils/fix-tracker");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -66,7 +72,7 @@ module.exports = {
 		 * This is not a generic function. In particular, it is assumed that the scope is a function scope or
 		 * a function's inner scope, and that the names can be valid identifiers in the given scope.
 		 * @param {string[]} names Array of variable names.
-		 * @param {eslint-scope.Scope} scope Function scope or a function's inner scope.
+		 * @param {Scope} scope Function scope or a function's inner scope.
 		 * @returns {boolean} True if all names can be safely declared, false otherwise.
 		 */
 		function isSafeToDeclare(names, scope) {
@@ -158,7 +164,7 @@ module.exports = {
 		/**
 		 * Checks whether the removal of `else` and its braces is safe from variable name collisions.
 		 * @param {Node} node The 'else' node.
-		 * @param {eslint-scope.Scope} scope The scope in which the node and the whole 'if' statement is.
+		 * @param {Scope} scope The scope in which the node and the whole 'if' statement is.
 		 * @returns {boolean} True if it is safe, false otherwise.
 		 */
 		function isSafeFromNameCollisions(node, scope) {

package/lib/rules/no-eval.js

@@ -11,6 +11,12 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -138,7 +144,7 @@ module.exports = {
 
 		/**
 		 * Reports accesses of `eval` via the global object.
-		 * @param {eslint-scope.Scope} globalScope The global scope.
+		 * @param {Scope} globalScope The global scope.
 		 * @returns {void}
 		 */
 		function reportAccessingEvalViaGlobalObject(globalScope) {
@@ -171,7 +177,7 @@ module.exports = {
 
 		/**
 		 * Reports all accesses of `eval` (excludes direct calls to eval).
-		 * @param {eslint-scope.Scope} globalScope The global scope.
+		 * @param {Scope} globalScope The global scope.
 		 * @returns {void}
 		 */
 		function reportAccessingEval(globalScope) {

package/lib/rules/no-loop-func.js

@@ -5,6 +5,12 @@
 
 "use strict";
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -138,7 +144,7 @@ module.exports = {
 		 * Checks whether a given reference which refers to an upper scope's variable is
 		 * safe or not.
 		 * @param {ASTNode} loopNode A containing loop node.
-		 * @param {eslint-scope.Reference} reference A reference to check.
+		 * @param {Reference} reference A reference to check.
 		 * @returns {boolean} `true` if the reference is safe or not.
 		 */
 		function isSafe(loopNode, reference) {
@@ -184,7 +190,7 @@ module.exports = {
 			 * It's safe if the reference matches one of the following condition.
 			 * - is readonly.
 			 * - doesn't exist inside a local function and after the border.
-			 * @param {eslint-scope.Reference} upperRef A reference to check.
+			 * @param {Reference} upperRef A reference to check.
 			 * @returns {boolean} `true` if the reference is safe.
 			 */
 			function isSafeReference(upperRef) {

package/lib/rules/no-shadow.js

@@ -11,6 +11,12 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Variable} Variable */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -452,7 +458,7 @@ module.exports = {
 
 		/**
 		 * Get declared line and column of a variable.
-		 * @param {eslint-scope.Variable} variable The variable to get.
+		 * @param {Variable} variable The variable to get.
 		 * @returns {Object} The declared line and column of the variable.
 		 */
 		function getDeclaredLocation(variable) {

package/lib/rules/no-undefined.js

@@ -4,6 +4,12 @@
  */
 "use strict";
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -45,7 +51,7 @@ module.exports = {
 		/**
 		 * Checks the given scope for references to `undefined` and reports
 		 * all references found.
-		 * @param {eslint-scope.Scope} scope The scope to check.
+		 * @param {Scope} scope The scope to check.
 		 * @returns {void}
 		 */
 		function checkScope(scope) {

package/lib/rules/no-unmodified-loop-condition.js

@@ -12,6 +12,13 @@
 const Traverser = require("../shared/traverser"),
 	astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Variable} Variable */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -25,7 +32,7 @@ const DYNAMIC_PATTERN = /^(?:Call|Member|New|TaggedTemplate|Yield)Expression$/u;
 
 /**
  * @typedef {Object} LoopConditionInfo
- * @property {eslint-scope.Reference} reference - The reference.
+ * @property {Reference} reference - The reference.
  * @property {ASTNode} group - BinaryExpression or ConditionalExpression nodes
  *      that the reference is belonging to.
  * @property {Function} isInLoop - The predicate which checks a given reference
@@ -36,7 +43,7 @@ const DYNAMIC_PATTERN = /^(?:Call|Member|New|TaggedTemplate|Yield)Expression$/u;
 
 /**
  * Checks whether or not a given reference is a write reference.
- * @param {eslint-scope.Reference} reference A reference to check.
+ * @param {Reference} reference A reference to check.
  * @returns {boolean} `true` if the reference is a write reference.
  */
 function isWriteReference(reference) {
@@ -73,7 +80,7 @@ function isUnmodifiedAndNotBelongToGroup(condition) {
 /**
  * Checks whether or not a given reference is inside of a given node.
  * @param {ASTNode} node A node to check.
- * @param {eslint-scope.Reference} reference A reference to check.
+ * @param {Reference} reference A reference to check.
  * @returns {boolean} `true` if the reference is inside of the node.
  */
 function isInRange(node, reference) {
@@ -86,7 +93,7 @@ function isInRange(node, reference) {
 /**
  * Checks whether or not a given reference is inside of a loop node's condition.
  * @param {ASTNode} node A node to check.
- * @param {eslint-scope.Reference} reference A reference to check.
+ * @param {Reference} reference A reference to check.
  * @returns {boolean} `true` if the reference is inside of the loop node's
  *      condition.
  */
@@ -104,7 +111,7 @@ const isInLoop = {
 /**
  * Gets the function which encloses a given reference.
  * This supports only FunctionDeclaration.
- * @param {eslint-scope.Reference} reference A reference to get.
+ * @param {Reference} reference A reference to get.
  * @returns {ASTNode|null} The function node or null.
  */
 function getEncloseFunctionDeclaration(reference) {
@@ -124,7 +131,7 @@ function getEncloseFunctionDeclaration(reference) {
 /**
  * Updates the "modified" flags of given loop conditions with given modifiers.
  * @param {LoopConditionInfo[]} conditions The loop conditions to be updated.
- * @param {eslint-scope.Reference[]} modifiers The references to update.
+ * @param {Reference[]} modifiers The references to update.
  * @returns {void}
  */
 function updateModifiedFlag(conditions, modifiers) {
@@ -258,7 +265,7 @@ module.exports = {
 
 		/**
 		 * Creates the loop condition information from a given reference.
-		 * @param {eslint-scope.Reference} reference A reference to create.
+		 * @param {Reference} reference A reference to create.
 		 * @returns {LoopConditionInfo|null} Created loop condition info, or null.
 		 */
 		function toLoopCondition(reference) {
@@ -309,7 +316,7 @@ module.exports = {
 		/**
 		 * Finds unmodified references which are inside of a loop condition.
 		 * Then reports the references which are outside of groups.
-		 * @param {eslint-scope.Variable} variable A variable to report.
+		 * @param {Variable} variable A variable to report.
 		 * @returns {void}
 		 */
 		function checkReferences(variable) {

package/lib/rules/no-unused-vars.js

@@ -11,6 +11,13 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Variable} Variable */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Typedefs
 //------------------------------------------------------------------------------
@@ -524,7 +531,7 @@ module.exports = {
 		 * - The reference is inside of a loop.
 		 * - The reference is inside of a function scope which is different from
 		 *   the declaration.
-		 * @param {eslint-scope.Reference} ref A reference to check.
+		 * @param {Reference} ref A reference to check.
 		 * @param {ASTNode} prevRhsNode The previous RHS node.
 		 * @returns {ASTNode|null} The RHS node or null.
 		 * @private
@@ -631,7 +638,7 @@ module.exports = {
 
 		/**
 		 * Checks whether a given reference is a read to update itself or not.
-		 * @param {eslint-scope.Reference} ref A reference to check.
+		 * @param {Reference} ref A reference to check.
 		 * @param {ASTNode} rhsNode The RHS node of the previous assignment.
 		 * @returns {boolean} The reference is a read to update itself.
 		 * @private
@@ -732,7 +739,7 @@ module.exports = {
 
 		/**
 		 * Checks whether the given variable is after the last used parameter.
-		 * @param {eslint-scope.Variable} variable The variable to check.
+		 * @param {Variable} variable The variable to check.
 		 * @returns {boolean} `true` if the variable is defined after the last
 		 * used parameter.
 		 */

package/lib/rules/no-use-before-define.js

@@ -5,6 +5,13 @@
 
 "use strict";
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -68,7 +75,7 @@ function isInClassStaticInitializerRange(node, location) {
 /**
  * Checks whether a given scope is the scope of a class static initializer.
  * Static initializers are static blocks and initializers of static fields.
- * @param {eslint-scope.Scope} scope A scope to check.
+ * @param {Scope} scope A scope to check.
  * @returns {boolean} `true` if the scope is a class static initializer scope.
  */
 function isClassStaticInitializerScope(scope) {
@@ -119,7 +126,7 @@ function isClassStaticInitializerScope(scope) {
  *           x; // returns `false`
  *       }
  *   }
- * @param {eslint-scope.Reference} reference A reference to check.
+ * @param {Reference} reference A reference to check.
  * @returns {boolean} `true` if the reference is from a separate execution context.
  */
 function isFromSeparateExecutionContext(reference) {
@@ -333,7 +340,7 @@ module.exports = {
 		 * - referring to a variable that is defined, but not in the given source code
 		 *   (e.g., global environment variable or `arguments` in functions).
 		 * - allowed by options.
-		 * @param {eslint-scope.Reference} reference The reference
+		 * @param {Reference} reference The reference
 		 * @returns {boolean} `true` if the reference should be checked
 		 */
 		function shouldCheck(reference) {
@@ -412,7 +419,7 @@ module.exports = {
 
 		/**
 		 * Finds and validates all references in a given scope and its child scopes.
-		 * @param {eslint-scope.Scope} scope The scope object.
+		 * @param {Scope} scope The scope object.
 		 * @returns {void}
 		 */
 		function checkReferencesInScope(scope) {

package/lib/rules/no-useless-assignment.js

@@ -138,7 +138,7 @@ module.exports = {
 
 		messages: {
 			unnecessaryAssignment:
-				"This assigned value is not used in subsequent statements.",
+				"The value assigned to '{{name}}' is not used in subsequent statements.",
 		},
 	},
 
@@ -486,6 +486,7 @@ module.exports = {
 				context.report({
 					node: targetAssignment.identifier,
 					messageId: "unnecessaryAssignment",
+					data: { name: targetAssignment.identifier.name },
 				});
 			}
 

package/lib/rules/no-var.js

@@ -11,13 +11,21 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+/** @typedef {import("eslint-scope").Variable} Variable */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
 
 /**
  * Check whether a given variable is a global variable or not.
- * @param {eslint-scope.Variable} variable The variable to check.
+ * @param {Variable} variable The variable to check.
  * @returns {boolean} `true` if the variable is a global variable.
  */
 function isGlobal(variable) {
@@ -27,8 +35,8 @@ function isGlobal(variable) {
 /**
  * Finds the nearest function scope or global scope walking up the scope
  * hierarchy.
- * @param {eslint-scope.Scope} scope The scope to traverse.
- * @returns {eslint-scope.Scope} a function scope or global scope containing the given
+ * @param {Scope} scope The scope to traverse.
+ * @returns {Scope} a function scope or global scope containing the given
  *      scope.
  */
 function getEnclosingFunctionScope(scope) {
@@ -43,7 +51,7 @@ function getEnclosingFunctionScope(scope) {
 /**
  * Checks whether the given variable has any references from a more specific
  * function expression (i.e. a closure).
- * @param {eslint-scope.Variable} variable A variable to check.
+ * @param {Variable} variable A variable to check.
  * @returns {boolean} `true` if the variable is used from a closure.
  */
 function isReferencedInClosure(variable) {
@@ -107,7 +115,7 @@ function getScopeNode(node) {
 
 /**
  * Checks whether a given variable is redeclared or not.
- * @param {eslint-scope.Variable} variable A variable to check.
+ * @param {Variable} variable A variable to check.
  * @returns {boolean} `true` if the variable is redeclared.
  */
 function isRedeclared(variable) {
@@ -123,7 +131,7 @@ function isRedeclared(variable) {
 function isUsedFromOutsideOf(scopeNode) {
 	/**
 	 * Checks whether a given reference is inside of the specified scope or not.
-	 * @param {eslint-scope.Reference} reference A reference to check.
+	 * @param {Reference} reference A reference to check.
 	 * @returns {boolean} `true` if the reference is inside of the specified
 	 *      scope.
 	 */
@@ -184,7 +192,7 @@ function hasReferenceInTDZ(node) {
 /**
  * Checks whether a given variable has name that is allowed for 'var' declarations,
  * but disallowed for `let` declarations.
- * @param {eslint-scope.Variable} variable The variable to check.
+ * @param {Variable} variable The variable to check.
  * @returns {boolean} `true` if the variable has a disallowed name.
  */
 function hasNameDisallowedForLetDeclarations(variable) {

package/lib/rules/prefer-arrow-callback.js

@@ -7,13 +7,20 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+/** @typedef {import("eslint-scope").Variable} Variable */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
 
 /**
  * Checks whether or not a given variable is a function name.
- * @param {eslint-scope.Variable} variable A variable to check.
+ * @param {Variable} variable A variable to check.
  * @returns {boolean} `true` if the variable is a function name.
  */
 function isFunctionName(variable) {
@@ -33,8 +40,8 @@ function checkMetaProperty(node, metaName, propertyName) {
 
 /**
  * Gets the variable object of `arguments` which is defined implicitly.
- * @param {eslint-scope.Scope} scope A scope to get.
- * @returns {eslint-scope.Variable} The found variable object.
+ * @param {Scope} scope A scope to get.
+ * @returns {Variable} The found variable object.
  */
 function getVariableOfArguments(scope) {
 	const variables = scope.variables;

package/lib/rules/prefer-const.js

@@ -12,6 +12,14 @@
 const FixTracker = require("./utils/fix-tracker");
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+/** @typedef {import("eslint-scope").Variable} Variable */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -56,7 +64,7 @@ function canBecomeVariableDeclaration(identifier) {
  * Checks if an property or element is from outer scope or function parameters
  * in destructing pattern.
  * @param {string} name A variable name to be checked.
- * @param {eslint-scope.Scope} initScope A scope to start find.
+ * @param {Scope} initScope A scope to start find.
  * @returns {boolean} Indicates if the variable is from outer scope or function parameters.
  */
 function isOuterVariableInDestructing(name, initScope) {
@@ -82,7 +90,7 @@ function isOuterVariableInDestructing(name, initScope) {
  * belongs to.
  * This is used to detect a mix of reassigned and never reassigned in a
  * destructuring.
- * @param {eslint-scope.Reference} reference A reference to get.
+ * @param {Reference} reference A reference to get.
  * @returns {ASTNode|null} A VariableDeclarator/AssignmentExpression node or
  *      null.
  */
@@ -168,7 +176,7 @@ function hasMemberExpressionAssignment(node) {
  *   `/*exported foo` directive comment makes such variables. This rule does not
  *   warn such variables because this rule cannot distinguish whether the
  *   exported variables are reassigned or not.
- * @param {eslint-scope.Variable} variable A variable to get.
+ * @param {Variable} variable A variable to get.
  * @param {boolean} ignoreReadBeforeAssign
  *      The value of `ignoreReadBeforeAssign` option.
  * @returns {ASTNode|null}
@@ -268,7 +276,7 @@ function getIdentifierIfShouldBeConst(variable, ignoreReadBeforeAssign) {
  * reference of given variables belongs to.
  * This is used to detect a mix of reassigned and never reassigned in a
  * destructuring.
- * @param {eslint-scope.Variable[]} variables Variables to group by destructuring.
+ * @param {Variable[]} variables Variables to group by destructuring.
  * @param {boolean} ignoreReadBeforeAssign
  *      The value of `ignoreReadBeforeAssign` option.
  * @returns {Map<ASTNode, ASTNode[]>} Grouped identifier nodes.
@@ -389,7 +397,7 @@ module.exports = {
 		 * nullable. In simple declaration or assignment cases, the length of
 		 * the array is 1. In destructuring cases, the length of the array can
 		 * be 2 or more.
-		 * @param {(eslint-scope.Reference|null)[]} nodes
+		 * @param {(Reference|null)[]} nodes
 		 *      References which are grouped by destructuring to report.
 		 * @returns {void}
 		 */

package/lib/rules/prefer-rest-params.js

@@ -5,14 +5,22 @@
 
 "use strict";
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+/** @typedef {import("eslint-scope").Variable} Variable */
+/** @typedef {import("eslint-scope").Reference} Reference */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
 
 /**
  * Gets the variable object of `arguments` which is defined implicitly.
- * @param {eslint-scope.Scope} scope A scope to get.
- * @returns {eslint-scope.Variable} The found variable object.
+ * @param {Scope} scope A scope to get.
+ * @returns {Variable} The found variable object.
  */
 function getVariableOfArguments(scope) {
 	const variables = scope.variables;
@@ -40,7 +48,7 @@ function getVariableOfArguments(scope) {
  * - arguments[i]      .... true    // computed member access
  * - arguments[0]      .... true    // computed member access
  * - arguments.length  .... false   // normal member access
- * @param {eslint-scope.Reference} reference The reference to check.
+ * @param {Reference} reference The reference to check.
  * @returns {boolean} `true` if the reference is not normal member access.
  */
 function isNotNormalMemberAccess(reference) {
@@ -81,7 +89,7 @@ module.exports = {
 
 		/**
 		 * Reports a given reference.
-		 * @param {eslint-scope.Reference} reference A reference to report.
+		 * @param {Reference} reference A reference to report.
 		 * @returns {void}
 		 */
 		function report(reference) {

package/lib/rules/radix.js

@@ -11,6 +11,12 @@
 
 const astUtils = require("./utils/ast-utils");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Variable} Variable */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -21,7 +27,7 @@ const validRadixValues = new Set(
 
 /**
  * Checks whether a given variable is shadowed or not.
- * @param {eslint-scope.Variable} variable A variable to check.
+ * @param {Variable} variable A variable to check.
  * @returns {boolean} `true` if the variable is shadowed.
  */
 function isShadowed(variable) {

package/lib/rules/utils/ast-utils.js

@@ -22,6 +22,13 @@ const {
 const globals = require("../../../conf/globals");
 const { LATEST_ECMA_VERSION } = require("../../../conf/ecma-version");
 
+//------------------------------------------------------------------------------
+// Types
+//------------------------------------------------------------------------------
+
+/** @typedef {import("eslint-scope").Scope} Scope */
+/** @typedef {import("eslint-scope").Variable} Variable */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -1581,9 +1588,9 @@ module.exports = {
 
 	/**
 	 * Finds the variable by a given name in a given scope and its upper scopes.
-	 * @param {eslint-scope.Scope} initScope A scope to start find.
+	 * @param {Scope} initScope A scope to start find.
 	 * @param {string} name A variable name to find.
-	 * @returns {eslint-scope.Variable|null} A found variable or `null`.
+	 * @returns {Variable|null} A found variable or `null`.
 	 */
 	getVariableByName(initScope, name) {
 		let scope = initScope;
@@ -1610,7 +1617,7 @@ module.exports = {
 	 * - The given node is not `StaticBlock`.
 	 * - The function name does not start with uppercase. It's a convention to capitalize the names
 	 *   of constructor functions. This check is not performed if `capIsConstructor` is set to `false`.
-	 * - The function does not have a JSDoc comment that has a @this tag.
+	 * - The function does not have a JSDoc comment that has a `@this` tag.
 	 *
 	 * Next, this checks the location of the node.
 	 * If the location is below, this judges `this` is valid.

package/lib/rules/utils/unicode/is-combining-character.js

@@ -6,8 +6,8 @@
 /**
  * Check whether a given character is a combining mark or not.
  * @param {number} codePoint The character code to check.
- * @returns {boolean} `true` if the character belongs to the category, any of `Mc`, `Me`, and `Mn`.
+ * @returns {boolean} `true` if the character has the General Category of Combining Mark (M), consisting of `Mc`, `Me`, and `Mn`.
  */
 module.exports = function isCombiningCharacter(codePoint) {
-	return /^[\p{Mc}\p{Me}\p{Mn}]$/u.test(String.fromCodePoint(codePoint));
+	return /^\p{M}$/u.test(String.fromCodePoint(codePoint));
 };

package/lib/shared/naming.js

@@ -42,7 +42,7 @@ function normalizePackageName(name, prefix) {
 				`$1/${prefix}`,
 			);
 		} else if (!scopedPackageNameRegex.test(normalizedName.split("/")[1])) {
-			/**
+			/*
 			 * for scoped packages, insert the prefix after the first / unless
 			 * the path is already @scope/eslint or @scope/eslint-xxx-yyy
 			 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "10.0.0",
+  "version": "10.0.3",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "type": "commonjs",
@@ -108,21 +108,21 @@
   "dependencies": {
     "@eslint-community/eslint-utils": "^4.8.0",
     "@eslint-community/regexpp": "^4.12.2",
-    "@eslint/config-array": "^0.23.0",
+    "@eslint/config-array": "^0.23.3",
     "@eslint/config-helpers": "^0.5.2",
-    "@eslint/core": "^1.1.0",
-    "@eslint/plugin-kit": "^0.6.0",
+    "@eslint/core": "^1.1.1",
+    "@eslint/plugin-kit": "^0.6.1",
     "@humanfs/node": "^0.16.6",
     "@humanwhocodes/module-importer": "^1.0.1",
     "@humanwhocodes/retry": "^0.4.2",
     "@types/estree": "^1.0.6",
-    "ajv": "^6.12.4",
+    "ajv": "^6.14.0",
     "cross-spawn": "^7.0.6",
     "debug": "^4.3.2",
     "escape-string-regexp": "^4.0.0",
-    "eslint-scope": "^9.1.0",
-    "eslint-visitor-keys": "^5.0.0",
-    "espree": "^11.1.0",
+    "eslint-scope": "^9.1.2",
+    "eslint-visitor-keys": "^5.0.1",
+    "espree": "^11.1.1",
     "esquery": "^1.7.0",
     "esutils": "^2.0.2",
     "fast-deep-equal": "^3.1.3",
@@ -133,7 +133,7 @@
     "imurmurhash": "^0.1.4",
     "is-glob": "^4.0.0",
     "json-stable-stringify-without-jsonify": "^1.0.1",
-    "minimatch": "^10.1.1",
+    "minimatch": "^10.2.4",
     "natural-compare": "^1.4.0",
     "optionator": "^0.9.3"
   },
@@ -143,11 +143,11 @@
     "@babel/preset-env": "^7.4.3",
     "@cypress/webpack-preprocessor": "^6.0.2",
     "@eslint/json": "^0.14.0",
-    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/eslintrc": "^3.3.5",
     "@trunkio/launcher": "^1.3.4",
     "@types/esquery": "^1.5.4",
     "@types/node": "^22.13.14",
-    "@typescript-eslint/parser": "^8.54.0",
+    "@typescript-eslint/parser": "^8.56.0",
     "babel-loader": "^8.0.5",
     "c8": "^7.12.0",
     "chai": "^4.0.1",

package/messages/all-files-ignored.js

@@ -1,16 +0,0 @@
-"use strict";
-
-module.exports = function (it) {
-	const { pattern } = it;
-
-	return `
-You are linting "${pattern}", but all of the files matching the glob pattern "${pattern}" are ignored.
-
-If you don't want to lint these files, remove the pattern "${pattern}" from the list of arguments passed to ESLint.
-
-If you do want to lint these files, try the following solutions:
-
-* Check your .eslintignore file, or the eslintIgnore property in package.json, to ensure that the files are not configured to be ignored.
-* Explicitly list the files from this glob that you'd like to lint on the command-line, rather than providing a glob as an argument.
-`.trimStart();
-};

package/messages/print-config-with-directory-path.js

@@ -1,8 +0,0 @@
-"use strict";
-
-module.exports = function () {
-	return `
-The '--print-config' CLI option requires a path to a source code file rather than a directory.
-See also: https://eslint.org/docs/latest/use/command-line-interface#--print-config
-`.trimStart();
-};