eslint 9.21.0 → 9.23.0

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

@@ -25,7 +25,6 @@
  * SOFTWARE
  */
 
-
 import { ESLint, Rule } from "./index.js";
 
 /** @deprecated */
@@ -33,52 +32,55 @@ 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 }>;
+	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 configType: "eslintrc";
 
-    static readonly version: string;
+	static readonly version: string;
 
-    static outputFixes(results: ESLint.LintResult[]): Promise<void>;
+	static outputFixes(results: ESLint.LintResult[]): Promise<void>;
 
-    static getErrorResults(results: ESLint.LintResult[]): ESLint.LintResult[];
+	static getErrorResults(results: ESLint.LintResult[]): ESLint.LintResult[];
 
-    constructor(options?: ESLint.LegacyOptions);
+	constructor(options?: ESLint.LegacyOptions);
 
-    lintFiles(patterns: string | string[]): Promise<ESLint.LintResult[]>;
+	lintFiles(patterns: string | string[]): Promise<ESLint.LintResult[]>;
 
-    lintText(
-        code: string,
-        options?: { filePath?: string | undefined; warnIgnored?: boolean | undefined },
-    ): Promise<ESLint.LintResult[]>;
+	lintText(
+		code: string,
+		options?: {
+			filePath?: string | undefined;
+			warnIgnored?: boolean | undefined;
+		},
+	): Promise<ESLint.LintResult[]>;
 
-    getRulesMetaForResults(results: ESLint.LintResult[]): ESLint.LintResultData["rulesMeta"];
+	getRulesMetaForResults(
+		results: ESLint.LintResult[],
+	): ESLint.LintResultData["rulesMeta"];
 
-    hasFlag(flag: string): false;
+	hasFlag(flag: string): false;
 
-    calculateConfigForFile(filePath: string): Promise<any>;
+	calculateConfigForFile(filePath: string): Promise<any>;
 
-    isPathIgnored(filePath: string): Promise<boolean>;
+	isPathIgnored(filePath: string): Promise<boolean>;
 
-    loadFormatter(nameOrPath?: string): Promise<ESLint.Formatter>;
+	loadFormatter(nameOrPath?: string): Promise<ESLint.Formatter>;
 }
 
 /** @deprecated */

package/lib/unsupported-api.js

@@ -21,9 +21,9 @@ const builtinRules = require("./rules");
 //-----------------------------------------------------------------------------
 
 module.exports = {
-    builtinRules,
-    FlatESLint,
-    shouldUseFlatConfig,
-    FileEnumerator,
-    LegacyESLint
+	builtinRules,
+	FlatESLint,
+	shouldUseFlatConfig,
+	FileEnumerator,
+	LegacyESLint,
 };

package/messages/all-files-ignored.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pattern } = it;
+module.exports = function (it) {
+	const { pattern } = it;
 
-    return `
+	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.

package/messages/all-matched-files-ignored.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pattern } = it;
+module.exports = function (it) {
+	const { pattern } = it;
 
-    return `
+	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.

package/messages/config-file-missing.js

@@ -1,7 +1,7 @@
 "use strict";
 
-module.exports = function() {
-    return `
+module.exports = function () {
+	return `
 ESLint couldn't find an eslint.config.(js|mjs|cjs) file.
 
 From ESLint v9.0.0, the default configuration file is now eslint.config.js.

package/messages/config-plugin-missing.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pluginName, ruleId } = it;
+module.exports = function (it) {
+	const { pluginName, ruleId } = it;
 
-    return `
+	return `
 A configuration object specifies rule "${ruleId}", but could not find plugin "${pluginName}".
 
 Common causes of this problem include:

package/messages/config-serialize-function.js

@@ -1,10 +1,10 @@
 "use strict";
 
-module.exports = function({ key, objectKey }) {
-
-    // special case for parsers
-    const isParser = objectKey === "parser" && (key === "parse" || key === "parseForESLint");
-    const parserMessage = `
+module.exports = function ({ key, objectKey }) {
+	// special case for parsers
+	const isParser =
+		objectKey === "parser" && (key === "parse" || key === "parseForESLint");
+	const parserMessage = `
     This typically happens when you're using a custom parser that does not
 provide a "meta" property, which is how ESLint determines the serialized
 representation. Please open an issue with the maintainer of the custom parser
@@ -13,13 +13,15 @@ and share this link:
 https://eslint.org/docs/latest/extend/custom-parsers#meta-data-in-custom-parsers
 `.trim();
 
-    return `
+	return `
 The requested operation requires ESLint to serialize configuration data,
 but the configuration key "${objectKey}.${key}" contains a function value,
 which cannot be serialized.
 
 ${
-    isParser ? parserMessage : "Please double-check your configuration for errors."
+	isParser
+		? parserMessage
+		: "Please double-check your configuration for errors."
 }
 
 If you still have problems, please stop by https://eslint.org/chat/help to chat

package/messages/eslintrc-incompat.js

@@ -3,8 +3,7 @@
 /* eslint consistent-return: 0 -- no default case */
 
 const messages = {
-
-    env: `
+	env: `
 A config object is using the "env" key, which is not supported in flat config system.
 
 Flat config uses "languageOptions.globals" to define global variables for your files.
@@ -16,7 +15,7 @@ If you're not using "env" directly (it may be coming from a plugin), please see
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    extends: `
+	extends: `
 A config object is using the "extends" key, which is not supported in flat config system.
 
 Instead of "extends", you can include config objects that you'd like to extend from directly in the flat config array.
@@ -28,7 +27,7 @@ If you're not using "extends" directly (it may be coming from a plugin), please
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    globals: `
+	globals: `
 A config object is using the "globals" key, which is not supported in flat config system.
 
 Flat config uses "languageOptions.globals" to define global variables for your files.
@@ -40,7 +39,7 @@ If you're not using "globals" directly (it may be coming from a plugin), please
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    ignorePatterns: `
+	ignorePatterns: `
 A config object is using the "ignorePatterns" key, which is not supported in flat config system.
 
 Flat config uses "ignores" to specify files to ignore.
@@ -52,7 +51,7 @@ If you're not using "ignorePatterns" directly (it may be coming from a plugin),
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    noInlineConfig: `
+	noInlineConfig: `
 A config object is using the "noInlineConfig" key, which is not supported in flat config system.
 
 Flat config uses "linterOptions.noInlineConfig" to specify files to ignore.
@@ -61,7 +60,7 @@ Please see the following page for information on how to convert your config obje
 https://eslint.org/docs/latest/use/configure/migration-guide#linter-options
 `,
 
-    overrides: `
+	overrides: `
 A config object is using the "overrides" key, which is not supported in flat config system.
 
 Flat config is an array that acts like the eslintrc "overrides" array.
@@ -73,7 +72,7 @@ If you're not using "overrides" directly (it may be coming from a plugin), pleas
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    parser: `
+	parser: `
 A config object is using the "parser" key, which is not supported in flat config system.
 
 Flat config uses "languageOptions.parser" to override the default parser.
@@ -85,7 +84,7 @@ If you're not using "parser" directly (it may be coming from a plugin), please s
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    parserOptions: `
+	parserOptions: `
 A config object is using the "parserOptions" key, which is not supported in flat config system.
 
 Flat config uses "languageOptions.parserOptions" to specify parser options.
@@ -97,7 +96,7 @@ If you're not using "parserOptions" directly (it may be coming from a plugin), p
 https://eslint.org/docs/latest/use/configure/migration-guide#using-eslintrc-configs-in-flat-config
 `,
 
-    reportUnusedDisableDirectives: `
+	reportUnusedDisableDirectives: `
 A config object is using the "reportUnusedDisableDirectives" key, which is not supported in flat config system.
 
 Flat config uses "linterOptions.reportUnusedDisableDirectives" to specify files to ignore.
@@ -106,14 +105,13 @@ Please see the following page for information on how to convert your config obje
 https://eslint.org/docs/latest/use/configure/migration-guide#linter-options
 `,
 
-    root: `
+	root: `
 A config object is using the "root" key, which is not supported in flat config system.
 
 Flat configs always act as if they are the root config file, so this key can be safely removed.
-`
+`,
 };
 
-module.exports = function({ key }) {
-
-    return messages[key].trim();
+module.exports = function ({ key }) {
+	return messages[key].trim();
 };

package/messages/eslintrc-plugins.js

@@ -1,10 +1,9 @@
 "use strict";
 
-module.exports = function({ plugins }) {
+module.exports = function ({ plugins }) {
+	const isArrayOfStrings = typeof plugins[0] === "string";
 
-    const isArrayOfStrings = typeof plugins[0] === "string";
-
-    return `
+	return `
 A config object has a "plugins" key defined as an array${isArrayOfStrings ? " of strings" : ""}. It looks something like this:
 
     {

package/messages/extend-config-missing.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { configName, importerName } = it;
+module.exports = function (it) {
+	const { configName, importerName } = it;
 
-    return `
+	return `
 ESLint couldn't find the config "${configName}" to extend from. Please check that the name of the config is correct.
 
 The config "${configName}" was referenced from the config file in "${importerName}".

package/messages/failed-to-read-json.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { path, message } = it;
+module.exports = function (it) {
+	const { path, message } = it;
 
-    return `
+	return `
 Failed to read JSON file at ${path}:
 
 ${message}

package/messages/file-not-found.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pattern, globDisabled } = it;
+module.exports = function (it) {
+	const { pattern, globDisabled } = it;
 
-    return `
+	return `
 No files matching the pattern "${pattern}"${globDisabled ? " (with disabling globs)" : ""} were found.
 Please check for typing mistakes in the pattern.
 `.trimStart();

package/messages/invalid-rule-options.js

@@ -2,8 +2,8 @@
 
 const { stringifyValueForError } = require("./shared");
 
-module.exports = function({ ruleId, value }) {
-    return `
+module.exports = function ({ ruleId, value }) {
+	return `
 Configuration for rule "${ruleId}" is invalid. Each rule must have a severity ("off", 0, "warn", 1, "error", or 2) and may be followed by additional options for the rule.
 
 You passed '${stringifyValueForError(value, 4)}', which doesn't contain a valid severity.

package/messages/invalid-rule-severity.js

@@ -2,8 +2,8 @@
 
 const { stringifyValueForError } = require("./shared");
 
-module.exports = function({ ruleId, value }) {
-    return `
+module.exports = function ({ ruleId, value }) {
+	return `
 Configuration for rule "${ruleId}" is invalid. Expected severity of "off", 0, "warn", 1, "error", or 2.
 
 You passed '${stringifyValueForError(value, 4)}'.

package/messages/no-config-found.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { directoryPath } = it;
+module.exports = function (it) {
+	const { directoryPath } = it;
 
-    return `
+	return `
 ESLint couldn't find a configuration file. To set up a configuration file for this project, please run:
 
     npm init @eslint/config@latest

package/messages/plugin-conflict.js

@@ -1,22 +1,22 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pluginId, plugins } = it;
+module.exports = function (it) {
+	const { pluginId, plugins } = it;
 
-    let result = `ESLint couldn't determine the plugin "${pluginId}" uniquely.
+	let result = `ESLint couldn't determine the plugin "${pluginId}" uniquely.
 `;
 
-    for (const { filePath, importerName } of plugins) {
-        result += `
+	for (const { filePath, importerName } of plugins) {
+		result += `
 - ${filePath} (loaded in "${importerName}")`;
-    }
+	}
 
-    result += `
+	result += `
 
 Please remove the "plugins" setting from either config or remove either plugin installation.
 
 If you still can't figure out the problem, please see https://eslint.org/docs/latest/use/troubleshooting.
 `;
 
-    return result;
+	return result;
 };

package/messages/plugin-invalid.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { configName, importerName } = it;
+module.exports = function (it) {
+	const { configName, importerName } = it;
 
-    return `
+	return `
 "${configName}" is invalid syntax for a config specifier.
 
 * If your intention is to extend from a configuration exported from the plugin, add the configuration name after a slash: e.g. "${configName}/myConfig".

package/messages/plugin-missing.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pluginName, resolvePluginsRelativeTo, importerName } = it;
+module.exports = function (it) {
+	const { pluginName, resolvePluginsRelativeTo, importerName } = it;
 
-    return `
+	return `
 ESLint couldn't find the plugin "${pluginName}".
 
 (The package "${pluginName}" was not found when loaded as a Node module from the directory "${resolvePluginsRelativeTo}".)

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

@@ -1,7 +1,7 @@
 "use strict";
 
-module.exports = function() {
-    return `
+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();

package/messages/shared.js

@@ -12,7 +12,12 @@
  * @returns {string} The value, stringified.
  */
 function stringifyValueForError(value, indentation) {
-    return value ? JSON.stringify(value, null, 4).replace(/\n/gu, `\n${" ".repeat(indentation)}`) : `${value}`;
+	return value
+		? JSON.stringify(value, null, 4).replace(
+				/\n/gu,
+				`\n${" ".repeat(indentation)}`,
+			)
+		: `${value}`;
 }
 
 module.exports = { stringifyValueForError };

package/messages/whitespace-found.js

@@ -1,9 +1,9 @@
 "use strict";
 
-module.exports = function(it) {
-    const { pluginName } = it;
+module.exports = function (it) {
+	const { pluginName } = it;
 
-    return `
+	return `
 ESLint couldn't find the plugin "${pluginName}". because there is whitespace in the name. Please check your configuration and remove all whitespace from the plugin name.
 
 If you still can't figure out the problem, please stop by https://eslint.org/chat/help to chat with the team.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "9.21.0",
+  "version": "9.23.0",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "type": "commonjs",
@@ -14,13 +14,17 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/api.js"
     },
+    "./config": {
+      "types": "./lib/types/config-api.d.ts",
+      "default": "./lib/config-api.js"
+    },
     "./package.json": "./package.json",
     "./use-at-your-own-risk": {
       "types": "./lib/types/use-at-your-own-risk.d.ts",
       "default": "./lib/unsupported-api.js"
     },
     "./rules": {
-      "types": "./lib/types/rules/index.d.ts"
+      "types": "./lib/types/rules.d.ts"
     },
     "./universal": {
       "types": "./lib/types/universal.d.ts",
@@ -33,10 +37,13 @@
         "./lib/types/use-at-your-own-risk.d.ts"
       ],
       "rules": [
-        "./lib/types/rules/index.d.ts"
+        "./lib/types/rules.d.ts"
       ],
       "universal": [
         "./lib/types/universal.d.ts"
+      ],
+      "config": [
+        "./lib/types/config-api.d.ts"
       ]
     }
   },
@@ -61,7 +68,7 @@
     "release:generate:rc": "node Makefile.js generatePrerelease -- rc",
     "release:publish": "node Makefile.js publishRelease",
     "test": "node Makefile.js test",
-    "test:browser": "node Makefile.js wdio",
+    "test:browser": "node Makefile.js cypress",
     "test:cli": "mocha",
     "test:fuzz": "node Makefile.js fuzz",
     "test:performance": "node Makefile.js perf",
@@ -72,19 +79,17 @@
     "pre-commit": "lint-staged"
   },
   "lint-staged": {
-    "*.js": "trunk check --fix --filter=eslint",
-    "*.md": "trunk check --fix --filter=markdownlint",
+    "*": "trunk check --fix",
     "lib/rules/*.js": [
       "node tools/update-eslint-all.js",
       "node tools/update-rule-type-headers.js",
-      "git add packages/js/src/configs/eslint-all.js \"lib/types/rules/*.ts\""
+      "git add packages/js/src/configs/eslint-all.js lib/types/rules.d.ts"
     ],
     "docs/src/rules/*.md": [
       "node tools/check-rule-examples.js",
       "node tools/fetch-docs-links.js",
       "git add docs/src/_data/further_reading_links.json"
-    ],
-    "docs/**/*.svg": "trunk check --fix --filter=svgo"
+    ]
   },
   "files": [
     "LICENSE",
@@ -102,9 +107,10 @@
     "@eslint-community/eslint-utils": "^4.2.0",
     "@eslint-community/regexpp": "^4.12.1",
     "@eslint/config-array": "^0.19.2",
+    "@eslint/config-helpers": "^0.2.0",
     "@eslint/core": "^0.12.0",
-    "@eslint/eslintrc": "^3.3.0",
-    "@eslint/js": "9.21.0",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "9.23.0",
     "@eslint/plugin-kit": "^0.2.7",
     "@humanfs/node": "^0.16.6",
     "@humanwhocodes/module-importer": "^1.0.1",
@@ -116,7 +122,7 @@
     "cross-spawn": "^7.0.6",
     "debug": "^4.3.2",
     "escape-string-regexp": "^4.0.0",
-    "eslint-scope": "^8.2.0",
+    "eslint-scope": "^8.3.0",
     "eslint-visitor-keys": "^4.2.0",
     "espree": "^10.3.0",
     "esquery": "^1.5.0",
@@ -138,20 +144,18 @@
     "@arethetypeswrong/cli": "^0.17.0",
     "@babel/core": "^7.4.3",
     "@babel/preset-env": "^7.4.3",
-    "@eslint/json": "^0.10.0",
+    "@cypress/webpack-preprocessor": "^6.0.2",
+    "@eslint/json": "^0.11.0",
     "@trunkio/launcher": "^1.3.0",
     "@types/node": "^20.11.5",
     "@typescript-eslint/parser": "^8.4.0",
-    "@wdio/browser-runner": "^9.2.4",
-    "@wdio/cli": "^9.2.4",
-    "@wdio/concise-reporter": "^9.2.2",
-    "@wdio/mocha-framework": "^9.2.2",
     "babel-loader": "^8.0.5",
     "c8": "^7.12.0",
     "chai": "^4.0.1",
     "cheerio": "^0.22.0",
     "common-tags": "^1.8.0",
     "core-js": "^3.1.3",
+    "cypress": "^14.1.0",
     "ejs": "^3.0.2",
     "eslint": "file:.",
     "eslint-config-eslint": "file:packages/eslint-config-eslint",
@@ -189,12 +193,10 @@
     "proxyquire": "^2.0.1",
     "recast": "^0.23.0",
     "regenerator-runtime": "^0.14.0",
-    "rollup-plugin-node-polyfills": "^0.2.1",
     "semver": "^7.5.3",
-    "shelljs": "^0.8.5",
+    "shelljs": "^0.9.0",
     "sinon": "^11.0.0",
     "typescript": "^5.3.3",
-    "vite-plugin-commonjs": "^0.10.0",
     "webpack": "^5.23.0",
     "webpack-cli": "^4.5.0",
     "yorkie": "^2.0.0"