eslint 9.39.1 → 10.0.0-alpha.1

package/lib/types/index.d.ts

@@ -72,7 +72,6 @@ import type {
 	SuggestedEdit,
 	ViolationReport,
 } from "@eslint/core";
-import { LegacyESLint } from "./use-at-your-own-risk.js";
 
 //------------------------------------------------------------------------------
 // Helpers
@@ -134,6 +133,8 @@ export namespace Scope {
 		acquire(node: ESTree.Node, inner?: boolean): Scope | null;
 
 		getDeclaredVariables(node: ESTree.Node): Variable[];
+
+		addGlobals(names: string[]): void;
 	}
 
 	interface Scope {
@@ -280,17 +281,8 @@ export class SourceCode
 
 	getDeclaredVariables(node: ESTree.Node): Scope.Variable[];
 
-	/** @deprecated */
-	getJSDocComment(node: ESTree.Node): ESTree.Comment | null;
-
 	getNodeByRangeIndex(index: number): ESTree.Node | null;
 
-	/** @deprecated Use `isSpaceBetween()` instead. */
-	isSpaceBetweenTokens(
-		first: ESTree.Node | AST.Token,
-		second: ESTree.Node | AST.Token,
-	): boolean;
-
 	getLocFromIndex(index: number): ESTree.Position;
 
 	getIndexFromLoc(location: ESTree.Position): number;
@@ -323,18 +315,6 @@ export class SourceCode
 
 	getTokensAfter: SourceCode.UnaryCursorWithCountOptions;
 
-	/** @deprecated Use `getTokenBefore()` instead. */
-	getTokenOrCommentBefore(
-		node: ESTree.Node | AST.Token | ESTree.Comment,
-		skip?: number | undefined,
-	): AST.Token | ESTree.Comment | null;
-
-	/** @deprecated Use `getTokenAfter()` instead. */
-	getTokenOrCommentAfter(
-		node: ESTree.Node | AST.Token | ESTree.Comment,
-		skip?: number | undefined,
-	): AST.Token | ESTree.Comment | null;
-
 	getFirstTokenBetween: SourceCode.BinaryCursorWithSkipOptions;
 
 	getFirstTokensBetween: SourceCode.BinaryCursorWithCountOptions;
@@ -785,7 +765,7 @@ export namespace Rule {
 	type ReportFixer = CoreRuleFixer;
 
 	/** @deprecated Use `ReportDescriptorOptions` instead. */
-	type ReportDescriptorOptionsBase = ViolationReportBase;
+	type ReportDescriptorOptionsBase = Omit<ViolationReportBase, "suggest">;
 
 	type SuggestionReportOptions = SuggestedEditBase;
 	type SuggestionDescriptorMessage = SuggestionMessage;
@@ -794,9 +774,9 @@ export namespace Rule {
 	// redundant with ReportDescriptorOptionsBase but kept for clarity
 	type ReportDescriptorOptions = ViolationReportBase;
 
-	type ReportDescriptor = ViolationReport<ESTree.Node>;
+	type ReportDescriptor = ViolationReport<JSSyntaxElement>;
 	type ReportDescriptorMessage = ViolationMessage;
-	type ReportDescriptorLocation = ViolationLocation<ESTree.Node>;
+	type ReportDescriptorLocation = ViolationLocation<JSSyntaxElement>;
 
 	type RuleFixer = RuleTextEditor<ESTree.Node | AST.Token>;
 	type Fix = RuleTextEdit;
@@ -823,10 +803,7 @@ export class Linter {
 
 	version: string;
 
-	constructor(options?: {
-		cwd?: string | undefined;
-		configType?: "flat" | "eslintrc";
-	});
+	constructor(options?: { cwd?: string | undefined; configType?: "flat" });
 
 	verify(
 		code: SourceCode | string,
@@ -852,14 +829,6 @@ export class Linter {
 
 	getSourceCode(): SourceCode;
 
-	defineRule(name: string, rule: Rule.RuleModule): void;
-
-	defineRules(rules: { [name: string]: Rule.RuleModule }): void;
-
-	getRules(): Map<string, Rule.RuleModule>;
-
-	defineParser(name: string, parser: Linter.Parser): void;
-
 	getTimes(): Linter.Stats["times"];
 
 	getFixPassCount(): Linter.Stats["fixPasses"];
@@ -1233,39 +1202,6 @@ export namespace ESLint {
 		flags?: string[] | undefined;
 	}
 
-	interface LegacyOptions {
-		// File enumeration
-		cwd?: string | undefined;
-		errorOnUnmatchedPattern?: boolean | undefined;
-		extensions?: string[] | undefined;
-		globInputPaths?: boolean | undefined;
-		ignore?: boolean | undefined;
-		ignorePath?: string | undefined;
-
-		// Linting
-		allowInlineConfig?: boolean | undefined;
-		baseConfig?: Linter.LegacyConfig | undefined;
-		overrideConfig?: Linter.LegacyConfig | undefined;
-		overrideConfigFile?: string | undefined;
-		plugins?: Record<string, Plugin> | undefined;
-		reportUnusedDisableDirectives?: Linter.StringSeverity | undefined;
-		resolvePluginsRelativeTo?: string | undefined;
-		rulePaths?: string[] | undefined;
-		useEslintrc?: boolean | undefined;
-
-		// Autofix
-		fix?: boolean | ((message: Linter.LintMessage) => boolean) | undefined;
-		fixTypes?: FixType[] | null | undefined;
-
-		// Cache-related
-		cache?: boolean | undefined;
-		cacheLocation?: string | undefined;
-		cacheStrategy?: CacheStrategy | undefined;
-
-		// Other Options
-		flags?: string[] | undefined;
-	}
-
 	/** A linting result. */
 	interface LintResult {
 		/** The path to the file that was linted. */
@@ -1396,15 +1332,9 @@ export namespace ESLint {
 
 // #endregion
 
-export function loadESLint(options: {
-	useFlatConfig: true;
-}): Promise<typeof ESLint>;
-export function loadESLint(options: {
-	useFlatConfig: false;
-}): Promise<typeof LegacyESLint>;
 export function loadESLint(options?: {
 	useFlatConfig?: boolean | undefined;
-}): Promise<typeof ESLint | typeof LegacyESLint>;
+}): Promise<typeof ESLint>;
 
 // #region RuleTester
 
@@ -1457,10 +1387,6 @@ export namespace RuleTester {
 	interface TestCaseError {
 		message?: string | RegExp;
 		messageId?: string;
-		/**
-		 * @deprecated `type` is deprecated and will be removed in the next major version.
-		 */
-		type?: string | undefined;
 		data?: any;
 		line?: number | undefined;
 		column?: number | undefined;

package/lib/types/rules.d.ts

@@ -3783,7 +3783,7 @@ export interface ESLintRules extends Linter.RulesRecord {
 		[
 			Partial<{
 				/**
-				 * @default false
+				 * @default true
 				 */
 				reportGlobalThis: boolean;
 			}>,
@@ -3914,6 +3914,9 @@ export interface ESLintRules extends Linter.RulesRecord {
 	/**
 	 * Rule to disallow `let` or `var` variables that are read but never assigned.
 	 *
+	 * @remarks
+	 * Recommended by ESLint, the rule was enabled in `eslint:recommended`.
+	 *
 	 * @since 9.27.0
 	 * @see https://eslint.org/docs/latest/rules/no-unassigned-vars
 	 */
@@ -4279,6 +4282,9 @@ export interface ESLintRules extends Linter.RulesRecord {
 	/**
 	 * Rule to disallow variable assignments when the value is not used.
 	 *
+	 * @remarks
+	 * Recommended by ESLint, the rule was enabled in `eslint:recommended`.
+	 *
 	 * @since 9.0.0-alpha.1
 	 * @see https://eslint.org/docs/latest/rules/no-useless-assignment
 	 */
@@ -4944,6 +4950,9 @@ export interface ESLintRules extends Linter.RulesRecord {
 	/**
 	 * Rule to disallow losing originally caught error when re-throwing custom errors.
 	 *
+	 * @remarks
+	 * Recommended by ESLint, the rule was enabled in `eslint:recommended`.
+	 *
 	 * @since 9.35.0
 	 * @see https://eslint.org/docs/latest/rules/preserve-caught-error
 	 */
@@ -5026,7 +5035,7 @@ export interface ESLintRules extends Linter.RulesRecord {
 	>;
 
 	/**
-	 * Rule to enforce the consistent use of the radix argument when using `parseInt()`.
+	 * Rule to enforce the use of the radix argument when using `parseInt()`.
 	 *
 	 * @since 0.0.7
 	 * @see https://eslint.org/docs/latest/rules/radix

package/lib/types/use-at-your-own-risk.d.ts

@@ -25,63 +25,10 @@
  * SOFTWARE
  */
 
-import { ESLint, Rule } from "./index.js";
+import { Rule } from "./index.js";
 
 /** @deprecated */
 export const builtinRules: Map<string, Rule.RuleModule>;
 
-/** @deprecated */
-export class FileEnumerator {
-	constructor(params?: {
-		cwd?: string;
-		configArrayFactory?: any;
-		extensions?: any;
-		globInputPaths?: boolean;
-		errorOnUnmatchedPattern?: boolean;
-		ignore?: boolean;
-	});
-	isTargetPath(filePath: string, providedConfig?: any): boolean;
-	iterateFiles(
-		patternOrPatterns: string | string[],
-	): IterableIterator<{ config: any; filePath: string; ignored: boolean }>;
-}
-
-export { /** @deprecated */ ESLint as FlatESLint };
-
-/** @deprecated */
-export class LegacyESLint {
-	static configType: "eslintrc";
-
-	static readonly version: string;
-
-	static outputFixes(results: ESLint.LintResult[]): Promise<void>;
-
-	static getErrorResults(results: ESLint.LintResult[]): ESLint.LintResult[];
-
-	constructor(options?: ESLint.LegacyOptions);
-
-	lintFiles(patterns: string | string[]): Promise<ESLint.LintResult[]>;
-
-	lintText(
-		code: string,
-		options?: {
-			filePath?: string | undefined;
-			warnIgnored?: boolean | undefined;
-		},
-	): Promise<ESLint.LintResult[]>;
-
-	getRulesMetaForResults(
-		results: ESLint.LintResult[],
-	): ESLint.LintResultData["rulesMeta"];
-
-	hasFlag(flag: string): false;
-
-	calculateConfigForFile(filePath: string): Promise<any>;
-
-	isPathIgnored(filePath: string): Promise<boolean>;
-
-	loadFormatter(nameOrPath?: string): Promise<ESLint.Formatter>;
-}
-
 /** @deprecated */
 export function shouldUseFlatConfig(): Promise<boolean>;

package/lib/unsupported-api.js

@@ -11,9 +11,7 @@
 // Requirements
 //-----------------------------------------------------------------------------
 
-const { FileEnumerator } = require("./cli-engine/file-enumerator");
-const { ESLint: FlatESLint, shouldUseFlatConfig } = require("./eslint/eslint");
-const { LegacyESLint } = require("./eslint/legacy-eslint");
+const { shouldUseFlatConfig } = require("./eslint/eslint");
 const builtinRules = require("./rules");
 
 //-----------------------------------------------------------------------------
@@ -22,8 +20,7 @@ const builtinRules = require("./rules");
 
 module.exports = {
 	builtinRules,
-	FlatESLint,
+	FlatESLint: null,
+	LegacyESLint: null,
 	shouldUseFlatConfig,
-	FileEnumerator,
-	LegacyESLint,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "9.39.1",
+  "version": "10.0.0-alpha.1",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "type": "commonjs",
@@ -108,12 +108,10 @@
   "dependencies": {
     "@eslint-community/eslint-utils": "^4.8.0",
     "@eslint-community/regexpp": "^4.12.1",
-    "@eslint/config-array": "^0.21.1",
-    "@eslint/config-helpers": "^0.4.2",
-    "@eslint/core": "^0.17.0",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "9.39.1",
-    "@eslint/plugin-kit": "^0.4.1",
+    "@eslint/config-array": "^0.23.0",
+    "@eslint/config-helpers": "^0.5.0",
+    "@eslint/core": "^1.0.0",
+    "@eslint/plugin-kit": "^0.5.0",
     "@humanfs/node": "^0.16.6",
     "@humanwhocodes/module-importer": "^1.0.1",
     "@humanwhocodes/retry": "^0.4.2",
@@ -123,9 +121,9 @@
     "cross-spawn": "^7.0.6",
     "debug": "^4.3.2",
     "escape-string-regexp": "^4.0.0",
-    "eslint-scope": "^8.4.0",
-    "eslint-visitor-keys": "^4.2.1",
-    "espree": "^10.4.0",
+    "eslint-scope": "^9.0.0",
+    "eslint-visitor-keys": "^5.0.0",
+    "espree": "^11.0.0",
     "esquery": "^1.5.0",
     "esutils": "^2.0.2",
     "fast-deep-equal": "^3.1.3",
@@ -136,8 +134,7 @@
     "imurmurhash": "^0.1.4",
     "is-glob": "^4.0.0",
     "json-stable-stringify-without-jsonify": "^1.0.1",
-    "lodash.merge": "^4.6.2",
-    "minimatch": "^3.1.2",
+    "minimatch": "^10.1.1",
     "natural-compare": "^1.4.0",
     "optionator": "^0.9.3"
   },
@@ -146,11 +143,12 @@
     "@babel/core": "^7.4.3",
     "@babel/preset-env": "^7.4.3",
     "@cypress/webpack-preprocessor": "^6.0.2",
-    "@eslint/json": "^0.13.2",
+    "@eslint/json": "^0.14.0",
+    "@eslint/eslintrc": "^3.3.1",
     "@trunkio/launcher": "^1.3.4",
     "@types/esquery": "^1.5.4",
     "@types/node": "^22.13.14",
-    "@typescript-eslint/parser": "^8.4.0",
+    "@typescript-eslint/parser": "file:tools/typescript-eslint-parser",
     "babel-loader": "^8.0.5",
     "c8": "^7.12.0",
     "chai": "^4.0.1",
@@ -165,18 +163,15 @@
     "eslint-plugin-expect-type": "^0.6.0",
     "eslint-plugin-yml": "^1.14.0",
     "eslint-release": "^3.3.0",
-    "eslint-rule-composer": "^0.3.0",
+    "eslint-rule-extender": "^0.0.1",
     "eslump": "^3.0.0",
     "esprima": "^4.0.1",
-    "fast-glob": "^3.2.11",
     "fs-teardown": "^0.1.3",
     "glob": "^10.0.0",
     "globals": "^16.2.0",
     "got": "^11.8.3",
     "gray-matter": "^4.0.3",
     "jiti": "^2.6.1",
-    "jiti-v2.0": "npm:jiti@2.0.x",
-    "jiti-v2.1": "npm:jiti@2.1.x",
     "knip": "^5.60.2",
     "lint-staged": "^11.0.0",
     "markdown-it": "^12.2.0",
@@ -191,7 +186,7 @@
     "mocha": "^11.7.1",
     "node-polyfill-webpack-plugin": "^1.0.3",
     "npm-license": "^0.3.3",
-    "pirates": "^4.0.5",
+    "prettier": "3.5.3",
     "progress": "^2.0.3",
     "proxyquire": "^2.0.1",
     "recast": "^0.23.0",
@@ -221,6 +216,6 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+    "node": "^20.19.0 || ^22.13.0 || >=24"
   }
 }

package/conf/default-cli-options.js

@@ -1,32 +0,0 @@
-/**
- * @fileoverview Default CLIEngineOptions.
- * @author Ian VanSchooten
- */
-
-"use strict";
-
-module.exports = {
-	configFile: null,
-	baseConfig: false,
-	rulePaths: [],
-	useEslintrc: true,
-	envs: [],
-	globals: [],
-	extensions: null,
-	ignore: true,
-	ignorePath: void 0,
-	cache: false,
-
-	/*
-	 * in order to honor the cacheFile option if specified
-	 * this option should not have a default value otherwise
-	 * it will always be used
-	 */
-	cacheLocation: "",
-	cacheFile: ".eslintcache",
-	cacheStrategy: "metadata",
-	fix: false,
-	allowInlineConfig: true,
-	reportUnusedDisableDirectives: void 0,
-	globInputPaths: true,
-};