eslint 10.0.2 → 10.1.0

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,9 +356,9 @@ 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://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>
+<p><a href="https://syntax.fm"><img src="https://github.com/syntaxfm.png" alt="Syntax" height="32"></a> <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.
 <p><a href="https://netlify.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/netlify-icon.svg" alt="Netlify" height="32"></a> <a href="https://algolia.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/algolia-icon.svg" alt="Algolia" height="32"></a> <a href="https://1password.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/1password-icon.svg" alt="1Password" height="32"></a></p>

package/lib/cli.js

@@ -395,7 +395,8 @@ const cli = {
 
 		if (!useStdin) {
 			const suppressionsFileLocation = getCacheFile(
-				options.suppressionsLocation || "eslint-suppressions.json",
+				options.suppressionsLocation ||
+					SuppressionsService.DEFAULT_SUPPRESSIONS_FILENAME,
 				process.cwd(),
 				{
 					prefix: "suppressions_",

package/lib/eslint/eslint-helpers.js

@@ -19,9 +19,11 @@ const minimatch = require("minimatch");
 const globParent = require("glob-parent");
 const { Linter } = require("../linter");
 const { getShorthandName } = require("../shared/naming");
+const { calculateStatsPerFile } = require("../shared/message-counts");
 const LintResultCache = require("../cli-engine/lint-result-cache");
 const { ConfigLoader } = require("../config/config-loader");
 const createDebug = require("debug");
+const { SuppressionsService } = require("../services/suppressions-service.js");
 
 //-----------------------------------------------------------------------------
 // Fixup references
@@ -719,42 +721,6 @@ function createIgnoreResult(filePath, baseDir, configStatus) {
 	};
 }
 
-/**
- * It will calculate the error and warning count for collection of messages per file
- * @param {LintMessage[]} messages Collection of messages
- * @returns {Object} Contains the stats
- * @private
- */
-function calculateStatsPerFile(messages) {
-	const stat = {
-		errorCount: 0,
-		fatalErrorCount: 0,
-		warningCount: 0,
-		fixableErrorCount: 0,
-		fixableWarningCount: 0,
-	};
-
-	for (let i = 0; i < messages.length; i++) {
-		const message = messages[i];
-
-		if (message.fatal || message.severity === 2) {
-			stat.errorCount++;
-			if (message.fatal) {
-				stat.fatalErrorCount++;
-			}
-			if (message.fix) {
-				stat.fixableErrorCount++;
-			}
-		} else {
-			stat.warningCount++;
-			if (message.fix) {
-				stat.fixableWarningCount++;
-			}
-		}
-	}
-	return stat;
-}
-
 //-----------------------------------------------------------------------------
 // Options-related Helpers
 //-----------------------------------------------------------------------------
@@ -821,6 +787,8 @@ function processOptions({
 	warnIgnored = true,
 	passOnNoPatterns = false,
 	ruleFilter = () => true,
+	applySuppressions = false,
+	suppressionsLocation = SuppressionsService.DEFAULT_SUPPRESSIONS_FILENAME,
 	...unknownOptions
 }) {
 	const errors = [];
@@ -975,6 +943,12 @@ function processOptions({
 	if (typeof ruleFilter !== "function") {
 		errors.push("'ruleFilter' must be a function.");
 	}
+	if (typeof applySuppressions !== "boolean") {
+		errors.push("'applySuppressions' must be a boolean.");
+	}
+	if (!isNonEmptyString(suppressionsLocation)) {
+		errors.push("'suppressionsLocation' must be a non-empty string.");
+	}
 	if (errors.length > 0) {
 		throw new ESLintInvalidOptionsError(errors);
 	}
@@ -1002,6 +976,8 @@ function processOptions({
 		passOnNoPatterns,
 		warnIgnored,
 		ruleFilter,
+		applySuppressions,
+		suppressionsLocation,
 	};
 }
 
@@ -1444,7 +1420,6 @@ module.exports = {
 
 	createIgnoreResult,
 	isErrorMessage,
-	calculateStatsPerFile,
 	getPlaceholderPath,
 
 	processOptions,

package/lib/eslint/eslint.js

@@ -46,6 +46,7 @@ const {
 const { Retrier } = require("@humanwhocodes/retry");
 const { ConfigLoader } = require("../config/config-loader");
 const { WarningService } = require("../services/warning-service");
+const { SuppressionsService } = require("../services/suppressions-service");
 const { Config } = require("../config/config.js");
 const {
 	getShorthandName,
@@ -68,38 +69,11 @@ const { resolve } = require("../shared/relative-module-resolver.js");
 
 /** @typedef {import("../types").Linter.Config} Config */
 /** @typedef {import("../types").ESLint.DeprecatedRuleUse} DeprecatedRuleInfo */
+/** @typedef {import("../types").ESLint.Options} ESLintOptions */
 /** @typedef {import("../types").ESLint.LintResult} LintResult */
 /** @typedef {import("../types").ESLint.Plugin} Plugin */
 /** @typedef {import("../types").ESLint.ResultsMeta} ResultsMeta */
 
-/**
- * The options with which to configure the ESLint instance.
- * @typedef {Object} ESLintOptions
- * @property {boolean} [allowInlineConfig] Enable or disable inline configuration comments.
- * @property {Config|Array<Config>} [baseConfig] Base config, extended by all configs used with this instance
- * @property {boolean} [cache] Enable result caching.
- * @property {string} [cacheLocation] The cache file to use instead of .eslintcache.
- * @property {"metadata" | "content"} [cacheStrategy] The strategy used to detect changed files.
- * @property {number | "auto" | "off"} [concurrency] Maximum number of linting threads, "auto" to choose automatically, "off" for no multithreading.
- * @property {string} [cwd] The value to use for the current working directory.
- * @property {boolean} [errorOnUnmatchedPattern] If `false` then `ESLint#lintFiles()` doesn't throw even if no target files found. Defaults to `true`.
- * @property {boolean|Function} [fix] Execute in autofix mode. If a function, should return a boolean.
- * @property {string[]} [fixTypes] Array of rule types to apply fixes for.
- * @property {string[]} [flags] Array of feature flags to enable.
- * @property {boolean} [globInputPaths] Set to false to skip glob resolution of input file paths to lint (default: true). If false, each input file paths is assumed to be a non-glob path to an existing file.
- * @property {boolean} [ignore] False disables all ignore patterns except for the default ones.
- * @property {string[]} [ignorePatterns] Ignore file patterns to use in addition to config ignores. These patterns are relative to `cwd`.
- * @property {Config|Array<Config>} [overrideConfig] Override config, overrides all configs used with this instance
- * @property {boolean|string} [overrideConfigFile] Searches for default config file when falsy;
- *      doesn't do any config file lookup when `true`; considered to be a config filename
- *      when a string.
- * @property {boolean} [passOnNoPatterns=false] When set to true, missing patterns cause
- *      the linting operation to short circuit and not report any failures.
- * @property {Record<string,Plugin>} [plugins] An array of plugin implementations.
- * @property {boolean} [stats] True enables added statistics on lint results.
- * @property {boolean} [warnIgnored] Show warnings when the file list includes ignored files
- */
-
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -237,7 +211,7 @@ function compareResultsByFilePath(a, b) {
  *
  * This function is used primarily by the `--inspect-config` option. For now,
  * we will maintain the existing behavior, which is to search up from the cwd.
- * @param {ESLintOptions} options The ESLint instance options.
+ * @param {{ configFile: string | undefined; cwd: string; }} options Config file location options.
  * @returns {Promise<{configFilePath:string|undefined;basePath:string}>} Location information for
  *      the config file.
  */
@@ -739,6 +713,20 @@ class ESLint {
 			processedOptions,
 			cacheFilePath,
 		);
+
+		let suppressionsService = null;
+		if (processedOptions.applySuppressions) {
+			const suppressionsFilePath = getCacheFile(
+				processedOptions.suppressionsLocation,
+				processedOptions.cwd,
+				{ prefix: "suppressions_" },
+			);
+			suppressionsService = new SuppressionsService({
+				filePath: suppressionsFilePath,
+				cwd: processedOptions.cwd,
+			});
+		}
+
 		const defaultConfigs = createDefaultConfigs(options.plugins);
 
 		this.#configLoader = createConfigLoader(
@@ -759,6 +747,7 @@ class ESLint {
 			configs: null,
 			configLoader: this.#configLoader,
 			warningService,
+			suppressionsService,
 		});
 
 		// Check for the .eslintignore file, and warn if it's present.
@@ -953,6 +942,7 @@ class ESLint {
 			lintResultCache,
 			options: eslintOptions,
 			warningService,
+			suppressionsService,
 		} = privateMembers.get(this);
 
 		/*
@@ -1065,9 +1055,19 @@ class ESLint {
 			lintResultCache.reconcile();
 		}
 
-		const finalResults = results.filter(result => !!result);
+		const unsuppressedResults = results.filter(result => !!result);
+
+		if (!eslintOptions.applySuppressions) {
+			return processLintReport(this, unsuppressedResults);
+		}
+
+		const { results: suppressedResults } =
+			suppressionsService.applySuppressions(
+				unsuppressedResults,
+				await suppressionsService.load(),
+			);
 
-		return processLintReport(this, finalResults);
+		return processLintReport(this, suppressedResults);
 	}
 
 	/**
@@ -1118,7 +1118,11 @@ class ESLint {
 
 		// Now we can get down to linting
 
-		const { linter, options: eslintOptions } = privateMembers.get(this);
+		const {
+			linter,
+			options: eslintOptions,
+			suppressionsService,
+		} = privateMembers.get(this);
 		const {
 			allowInlineConfig,
 			cwd,
@@ -1176,7 +1180,16 @@ class ESLint {
 
 		debug("Linting complete in %t", hrtimeBigint() - startTime);
 
-		return processLintReport(this, results);
+		if (!filePath || !eslintOptions.applySuppressions) {
+			return processLintReport(this, results);
+		}
+
+		const { results: suppressedResults } =
+			suppressionsService.applySuppressions(
+				results,
+				await suppressionsService.load(),
+			);
+		return processLintReport(this, suppressedResults);
 	}
 
 	/**

package/lib/languages/js/source-code/token-store/utils.js

@@ -19,7 +19,6 @@ function search(tokens, location) {
 	for (
 		let minIndex = 0, maxIndex = tokens.length - 1;
 		minIndex <= maxIndex;
-
 	) {
 		/*
 		 * Calculate the index in the middle between minIndex and maxIndex.

package/lib/rules/capitalized-comments.js

@@ -176,9 +176,9 @@ module.exports = {
 
 			return Boolean(
 				previousToken &&
-					nextToken &&
-					comment.loc.start.line === previousToken.loc.end.line &&
-					comment.loc.end.line === nextToken.loc.start.line,
+				nextToken &&
+				comment.loc.start.line === previousToken.loc.end.line &&
+				comment.loc.end.line === nextToken.loc.start.line,
 			);
 		}
 
@@ -194,7 +194,7 @@ module.exports = {
 
 			return Boolean(
 				previousTokenOrComment &&
-					["Block", "Line"].includes(previousTokenOrComment.type),
+				["Block", "Line"].includes(previousTokenOrComment.type),
 			);
 		}
 

package/lib/rules/no-extend-native.js

@@ -87,11 +87,11 @@ module.exports = {
 		function isPrototypePropertyAccessed(identifierNode) {
 			return Boolean(
 				identifierNode &&
-					identifierNode.parent &&
-					identifierNode.parent.type === "MemberExpression" &&
-					identifierNode.parent.object === identifierNode &&
-					astUtils.getStaticPropertyName(identifierNode.parent) ===
-						"prototype",
+				identifierNode.parent &&
+				identifierNode.parent.type === "MemberExpression" &&
+				identifierNode.parent.object === identifierNode &&
+				astUtils.getStaticPropertyName(identifierNode.parent) ===
+					"prototype",
 			);
 		}
 

package/lib/rules/no-this-before-super.js

@@ -181,9 +181,7 @@ module.exports = {
 						isConstructor: true,
 						hasExtends: Boolean(
 							classNode.superClass &&
-								!astUtils.isNullOrUndefined(
-									classNode.superClass,
-								),
+							!astUtils.isNullOrUndefined(classNode.superClass),
 						),
 						codePath,
 						currentSegments: new Set(),

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

@@ -152,11 +152,11 @@ function updateModifiedFlag(conditions, modifiers) {
 				condition.isInLoop(modifier) ||
 				Boolean(
 					(funcNode = getEncloseFunctionDeclaration(modifier)) &&
-						(funcVar = astUtils.getVariableByName(
-							modifier.from.upper,
-							funcNode.id.name,
-						)) &&
-						funcVar.references.some(condition.isInLoop),
+					(funcVar = astUtils.getVariableByName(
+						modifier.from.upper,
+						funcNode.id.name,
+					)) &&
+					funcVar.references.some(condition.isInLoop),
 				);
 
 			condition.modified = inLoop;

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

@@ -199,6 +199,28 @@ function hasNameDisallowedForLetDeclarations(variable) {
 	return variable.name === "let";
 }
 
+/**
+ * Checks whether a given variable has any references before its declaration.
+ * This is important because var allows hoisting, but let/const do not.
+ * @param {Variable} variable The variable to check.
+ * @returns {boolean} `true` if the variable is referenced before its declaration.
+ */
+function hasReferenceBeforeDeclaration(variable) {
+	const declarationStart = variable.defs[0].node.range[0];
+
+	return variable.references.some(reference => {
+		const referenceStart = reference.identifier.range[0];
+
+		/*
+		 * Check if the reference occurs before the declaration.
+		 * We don't need to check scopes because all references to this variable
+		 * are already in variable.references (which only includes references
+		 * that resolve to this specific variable binding).
+		 */
+		return !reference.init && referenceStart < declarationStart;
+	});
+}
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -252,6 +274,7 @@ module.exports = {
 		 * - A variable is used from a closure within a loop.
 		 * - A variable might be used before it is assigned within a loop.
 		 * - A variable might be used in TDZ.
+		 * - A variable is referenced before its declaration.
 		 * - A variable is declared in statement position (e.g. a single-line `IfStatement`)
 		 * - A variable has name that is disallowed for `let` declarations.
 		 *
@@ -296,6 +319,10 @@ module.exports = {
 		function canFix(node) {
 			const variables = sourceCode.getDeclaredVariables(node);
 			const scopeNode = getScopeNode(node);
+			const parentStatementList = new Set([
+				...astUtils.STATEMENT_LIST_PARENTS,
+				"TSModuleBlock",
+			]);
 
 			if (
 				node.parent.type === "SwitchCase" ||
@@ -303,7 +330,8 @@ module.exports = {
 				variables.some(isGlobal) ||
 				variables.some(isRedeclared) ||
 				variables.some(isUsedFromOutsideOf(scopeNode)) ||
-				variables.some(hasNameDisallowedForLetDeclarations)
+				variables.some(hasNameDisallowedForLetDeclarations) ||
+				variables.some(hasReferenceBeforeDeclaration)
 			) {
 				return false;
 			}
@@ -323,7 +351,7 @@ module.exports = {
 					node.parent.type === "ForStatement" &&
 					node.parent.init === node
 				) &&
-				!astUtils.STATEMENT_LIST_PARENTS.has(node.parent.type)
+				!parentStatementList.has(node.parent.type)
 			) {
 				// If the declaration is not in a block, e.g. `if (foo) var bar = 1;`, then it can't be fixed.
 				return false;

package/lib/rules/padding-line-between-statements.js

@@ -158,11 +158,11 @@ function getActualLastToken(sourceCode, node) {
 	const nextToken = sourceCode.getTokenAfter(semiToken);
 	const isSemicolonLessStyle = Boolean(
 		prevToken &&
-			nextToken &&
-			prevToken.range[0] >= node.range[0] &&
-			astUtils.isSemicolonToken(semiToken) &&
-			semiToken.loc.start.line !== prevToken.loc.end.line &&
-			semiToken.loc.end.line === nextToken.loc.start.line,
+		nextToken &&
+		prevToken.range[0] >= node.range[0] &&
+		astUtils.isSemicolonToken(semiToken) &&
+		semiToken.loc.start.line !== prevToken.loc.end.line &&
+		semiToken.loc.end.line === nextToken.loc.start.line,
 	);
 
 	return isSemicolonLessStyle ? prevToken : semiToken;

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

@@ -410,9 +410,9 @@ function equalLiteralValue(left, right) {
 	if (left.regex || right.regex) {
 		return Boolean(
 			left.regex &&
-				right.regex &&
-				left.regex.pattern === right.regex.pattern &&
-				left.regex.flags === right.regex.flags,
+			right.regex &&
+			left.regex.pattern === right.regex.pattern &&
+			left.regex.flags === right.regex.flags,
 		);
 	}
 
@@ -1053,9 +1053,9 @@ function isReferenceToGlobalVariable(scope, node) {
 
 	return Boolean(
 		reference &&
-			reference.resolved &&
-			reference.resolved.scope.type === "global" &&
-			reference.resolved.defs.length === 0,
+		reference.resolved &&
+		reference.resolved.scope.type === "global" &&
+		reference.resolved.defs.length === 0,
 	);
 }
 

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/services/suppressions-service.js

@@ -11,7 +11,7 @@
 
 const fs = require("node:fs");
 const path = require("node:path");
-const { calculateStatsPerFile } = require("../eslint/eslint-helpers");
+const { calculateStatsPerFile } = require("../shared/message-counts");
 const stringify = require("json-stable-stringify-without-jsonify");
 
 //------------------------------------------------------------------------------
@@ -31,6 +31,8 @@ const stringify = require("json-stable-stringify-without-jsonify");
  * Manages the suppressed violations.
  */
 class SuppressionsService {
+	static DEFAULT_SUPPRESSIONS_FILENAME = "eslint-suppressions.json";
+
 	filePath = "";
 	cwd = "";
 

package/lib/shared/message-counts.js

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Helpers for counting errors and warnings in lint messages.
+ * @author Nicholas C. Zakas
+ * @author Blake Sager
+ */
+
+"use strict";
+
+/**
+ * It will calculate the error and warning count for collection of messages per file
+ * @param {LintMessage[]} messages Collection of messages
+ * @returns {Object} Contains the stats
+ */
+function calculateStatsPerFile(messages) {
+	const stat = {
+		errorCount: 0,
+		fatalErrorCount: 0,
+		warningCount: 0,
+		fixableErrorCount: 0,
+		fixableWarningCount: 0,
+	};
+
+	for (let i = 0; i < messages.length; i++) {
+		const message = messages[i];
+
+		if (message.fatal || message.severity === 2) {
+			stat.errorCount++;
+			if (message.fatal) {
+				stat.fatalErrorCount++;
+			}
+			if (message.fix) {
+				stat.fixableErrorCount++;
+			}
+		} else {
+			stat.warningCount++;
+			if (message.fix) {
+				stat.fixableWarningCount++;
+			}
+		}
+	}
+	return stat;
+}
+
+module.exports = {
+	calculateStatsPerFile,
+};

package/lib/types/index.d.ts

@@ -237,15 +237,12 @@ export namespace Scope {
 
 // #region SourceCode
 
-export class SourceCode
-	implements
-		TextSourceCode<{
-			LangOptions: Linter.LanguageOptions;
-			RootNode: AST.Program;
-			SyntaxElementWithLoc: AST.Token | ESTree.Node;
-			ConfigNode: ESTree.Comment;
-		}>
-{
+export class SourceCode implements TextSourceCode<{
+	LangOptions: Linter.LanguageOptions;
+	RootNode: AST.Program;
+	SyntaxElementWithLoc: AST.Token | ESTree.Node;
+	ConfigNode: ESTree.Comment;
+}> {
 	text: string;
 	ast: AST.Program;
 	lines: string[];
@@ -649,32 +646,30 @@ export type JSSyntaxElement = {
 };
 
 export namespace Rule {
-	interface RuleModule
-		extends RuleDefinition<{
-			LangOptions: Linter.LanguageOptions;
-			Code: SourceCode;
-			RuleOptions: any[];
-			Visitor: RuleListener;
-			Node: JSSyntaxElement;
-			MessageIds: string;
-			ExtRuleDocs: {};
-		}> {
+	interface RuleModule extends RuleDefinition<{
+		LangOptions: Linter.LanguageOptions;
+		Code: SourceCode;
+		RuleOptions: any[];
+		Visitor: RuleListener;
+		Node: JSSyntaxElement;
+		MessageIds: string;
+		ExtRuleDocs: {};
+	}> {
 		create(context: RuleContext): RuleListener;
 	}
 
 	type NodeTypes = ESTree.Node["type"];
 
-	interface NodeListener
-		extends CustomRuleVisitorWithExit<
-			{
-				[Node in Rule.Node as Node["type"]]?:
-					| ((node: Node) => void)
-					| undefined;
-			} & {
-				// A `Program` visitor's node type has no `parent` property.
-				Program?: ((node: AST.Program) => void) | undefined;
-			}
-		> {}
+	interface NodeListener extends CustomRuleVisitorWithExit<
+		{
+			[Node in Rule.Node as Node["type"]]?:
+				| ((node: Node) => void)
+				| undefined;
+		} & {
+			// A `Program` visitor's node type has no `parent` property.
+			Program?: ((node: AST.Program) => void) | undefined;
+		}
+	> {}
 
 	interface NodeParentExtension {
 		parent: Node;
@@ -748,14 +743,13 @@ export namespace Rule {
 
 	type RuleMetaData = RulesMeta;
 
-	interface RuleContext
-		extends CoreRuleContext<{
-			LangOptions: Linter.LanguageOptions;
-			Code: SourceCode;
-			RuleOptions: any[];
-			Node: JSSyntaxElement;
-			MessageIds: string;
-		}> {}
+	interface RuleContext extends CoreRuleContext<{
+		LangOptions: Linter.LanguageOptions;
+		Code: SourceCode;
+		RuleOptions: any[];
+		Node: JSSyntaxElement;
+		MessageIds: string;
+	}> {}
 
 	type ReportFixer = CoreRuleFixer;
 
@@ -1195,41 +1189,98 @@ export namespace ESLint {
 
 	type CacheStrategy = "content" | "metadata";
 
+	/** The options with which to configure the ESLint instance. */
 	interface Options {
 		// File enumeration
+
+		/** The value to use for the current working directory. */
 		cwd?: string | undefined;
+
+		/** If `false` then `ESLint#lintFiles()` doesn't throw even if no target files found. Defaults to `true`. */
 		errorOnUnmatchedPattern?: boolean | undefined;
+
+		/**
+		 * Set to false to skip glob resolution of input file paths to lint (default: true).
+		 * If false, each input file path is assumed to be a non-glob path to an existing file.
+		 */
 		globInputPaths?: boolean | undefined;
+
+		/** False disables all ignore patterns except for the default ones. */
 		ignore?: boolean | undefined;
+
+		/** Ignore file patterns to use in addition to config ignores. These patterns are relative to `cwd`. */
 		ignorePatterns?: string[] | null | undefined;
+
+		/** When set to true, missing patterns cause the linting operation to short circuit and not report any failures. */
 		passOnNoPatterns?: boolean | undefined;
+
+		/** Show warnings when the file list includes ignored files. */
 		warnIgnored?: boolean | undefined;
 
 		// Linting
+
+		/** Enable or disable inline configuration comments. */
 		allowInlineConfig?: boolean | undefined;
+
+		/** Base config, extended by all configs used with this instance. */
 		baseConfig?: Linter.Config | Linter.Config[] | null | undefined;
+
+		/** Override config, overrides all configs used with this instance. */
 		overrideConfig?: Linter.Config | Linter.Config[] | null | undefined;
+
+		/**
+		 * Searches for default config file when falsy; doesn't do any config file lookup when `true`; considered to be a config filename when a string.
+		 */
 		overrideConfigFile?: string | true | null | undefined;
+
+		/** An array of plugin implementations. */
 		plugins?: Record<string, Plugin> | null | undefined;
+
+		/**
+		 * Default is `() => true`. A predicate function that filters rules to be run.
+		 * This function is called with an object containing `ruleId` and `severity`, and returns `true` if the rule should be run.
+		 */
 		ruleFilter?:
 			| ((arg: {
 					ruleId: string;
 					severity: Exclude<Linter.Severity, 0>;
 			  }) => boolean)
 			| undefined;
+
+		/** True enables added statistics on lint results. */
 		stats?: boolean | undefined;
 
 		// Autofix
+
+		/** Execute in autofix mode. If a function, should return a boolean. */
 		fix?: boolean | ((message: Linter.LintMessage) => boolean) | undefined;
+
+		/** Array of rule types to apply fixes for. */
 		fixTypes?: FixType[] | null | undefined;
 
 		// Cache-related
+
+		/** Enable result caching. */
 		cache?: boolean | undefined;
+
+		/** The cache file to use instead of .eslintcache. */
 		cacheLocation?: string | undefined;
+
+		/** The strategy used to detect changed files. */
 		cacheStrategy?: CacheStrategy | undefined;
 
+		/** If true, apply suppressions automatically. Defaults to false. */
+		applySuppressions?: boolean | undefined;
+
+		/** Path to suppressions file. Relative to cwd. Defaults to eslint-suppressions.json in cwd. */
+		suppressionsLocation?: string | undefined;
+
 		// Other Options
+
+		/** Maximum number of linting threads, "auto" to choose automatically, "off" for no multithreading. */
 		concurrency?: number | "auto" | "off" | undefined;
+
+		/** Array of feature flags to enable. */
 		flags?: string[] | undefined;
 	}
 
@@ -1428,17 +1479,16 @@ export class RuleTester {
 }
 
 export namespace RuleTester {
-	interface ValidTestCase
-		extends Omit<
-			Linter.Config,
-			| "name"
-			| "basePath"
-			| "files"
-			| "ignores"
-			| "linterOptions"
-			| "plugins"
-			| "rules"
-		> {
+	interface ValidTestCase extends Omit<
+		Linter.Config,
+		| "name"
+		| "basePath"
+		| "files"
+		| "ignores"
+		| "linterOptions"
+		| "plugins"
+		| "rules"
+	> {
 		name?: string;
 		code: string;
 		options?: any[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "10.0.2",
+  "version": "10.1.0",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "type": "commonjs",
@@ -53,12 +53,14 @@
     "build:webpack": "node Makefile.js webpack",
     "build:readme": "node tools/update-readme.js",
     "build:rules-index": "node Makefile.js generateRuleIndexPage",
-    "lint": "trunk check --no-fix --ignore=docs/**/*.js -a --filter=eslint && trunk check --no-fix --ignore=docs/**/*.js",
-    "lint:docs:js": "trunk check --no-fix --ignore=** --ignore=!docs/**/*.js -a --filter=eslint && trunk check --no-fix --ignore=** --ignore=!docs/**/*.js",
+    "fmt": "prettier --write .",
+    "fmt:check": "prettier --check .",
+    "lint": "node Makefile.js lint",
+    "lint:docs:js": "node Makefile.js lintDocsJS",
     "lint:docs:rule-examples": "node Makefile.js checkRuleExamples",
     "lint:unused": "knip",
-    "lint:fix": "trunk check -y --ignore=docs/**/*.js -a --filter=eslint && trunk check -y --ignore=docs/**/*.js",
-    "lint:fix:docs:js": "trunk check -y --ignore=** --ignore=!docs/**/*.js -a --filter=eslint && trunk check -y --ignore=** --ignore=!docs/**/*.js",
+    "lint:fix": "node Makefile.js lint -- fix",
+    "lint:fix:docs:js": "node Makefile.js lintDocsJS -- fix",
     "lint:rule-types": "node tools/update-rule-type-headers.js --check",
     "lint:types": "attw --pack",
     "release:generate:alpha": "node Makefile.js generatePrerelease -- alpha",
@@ -80,7 +82,15 @@
     "pre-commit": "lint-staged"
   },
   "lint-staged": {
-    "*": "trunk check --fix",
+    "*.{js,json,jsonc,json5,yml,yaml}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "docs/src/**/*.md": [
+      "markdownlint-cli2 --fix",
+      "prettier --write"
+    ],
+    "!({{*.,**/*.}{js,json,jsonc,json5,yml,yaml},docs/src/**/*.md})": "prettier --write --ignore-unknown",
     "lib/rules/*.js": [
       "node tools/update-eslint-all.js",
       "node tools/update-eslint-recommended.js",
@@ -91,7 +101,8 @@
       "node tools/check-rule-examples.js",
       "node tools/fetch-docs-links.js",
       "git add docs/src/_data/further_reading_links.json"
-    ]
+    ],
+    "docs/**/*.svg": "npx -y svgo -r --multipass"
   },
   "files": [
     "LICENSE",
@@ -108,10 +119,10 @@
   "dependencies": {
     "@eslint-community/eslint-utils": "^4.8.0",
     "@eslint-community/regexpp": "^4.12.2",
-    "@eslint/config-array": "^0.23.2",
-    "@eslint/config-helpers": "^0.5.2",
-    "@eslint/core": "^1.1.0",
-    "@eslint/plugin-kit": "^0.6.0",
+    "@eslint/config-array": "^0.23.3",
+    "@eslint/config-helpers": "^0.5.3",
+    "@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",
@@ -120,9 +131,9 @@
     "cross-spawn": "^7.0.6",
     "debug": "^4.3.2",
     "escape-string-regexp": "^4.0.0",
-    "eslint-scope": "^9.1.1",
+    "eslint-scope": "^9.1.2",
     "eslint-visitor-keys": "^5.0.1",
-    "espree": "^11.1.1",
+    "espree": "^11.2.0",
     "esquery": "^1.7.0",
     "esutils": "^2.0.2",
     "fast-deep-equal": "^3.1.3",
@@ -133,7 +144,7 @@
     "imurmurhash": "^0.1.4",
     "is-glob": "^4.0.0",
     "json-stable-stringify-without-jsonify": "^1.0.1",
-    "minimatch": "^10.2.1",
+    "minimatch": "^10.2.4",
     "natural-compare": "^1.4.0",
     "optionator": "^0.9.3"
   },
@@ -142,14 +153,13 @@
     "@babel/core": "^7.4.3",
     "@babel/preset-env": "^7.4.3",
     "@cypress/webpack-preprocessor": "^6.0.2",
-    "@eslint/json": "^0.14.0",
-    "@eslint/eslintrc": "^3.3.4",
-    "@trunkio/launcher": "^1.3.4",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/json": "^1.2.0",
     "@types/esquery": "^1.5.4",
     "@types/node": "^22.13.14",
     "@typescript-eslint/parser": "^8.56.0",
     "babel-loader": "^8.0.5",
-    "c8": "^7.12.0",
+    "c8": "^11.0.0",
     "chai": "^4.0.1",
     "cheerio": "^0.22.0",
     "common-tags": "^1.8.0",
@@ -175,6 +185,7 @@
     "lint-staged": "^11.0.0",
     "markdown-it": "^12.2.0",
     "markdown-it-container": "^3.0.0",
+    "markdownlint-cli2": "^0.21.0",
     "marked": "^4.0.8",
     "metascraper": "^5.25.7",
     "metascraper-description": "^5.25.7",
@@ -185,7 +196,7 @@
     "mocha": "^11.7.1",
     "node-polyfill-webpack-plugin": "^1.0.3",
     "npm-license": "^0.3.3",
-    "prettier": "3.5.3",
+    "prettier": "3.8.1",
     "progress": "^2.0.3",
     "proxyquire": "^2.0.1",
     "recast": "^0.23.0",