eslint 9.28.0 → 9.30.0

package/lib/rules/rest-spread-spacing.js

@@ -24,12 +24,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "rest-spread-spacing",
-						url: "https://eslint.style/rules/js/rest-spread-spacing",
+						url: "https://eslint.style/rules/rest-spread-spacing",
 					},
 				},
 			],

package/lib/rules/semi-spacing.js

@@ -26,12 +26,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "semi-spacing",
-						url: "https://eslint.style/rules/js/semi-spacing",
+						url: "https://eslint.style/rules/semi-spacing",
 					},
 				},
 			],

package/lib/rules/semi-style.js

@@ -96,12 +96,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "semi-style",
-						url: "https://eslint.style/rules/js/semi-style",
+						url: "https://eslint.style/rules/semi-style",
 					},
 				},
 			],

package/lib/rules/semi.js

@@ -30,12 +30,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "semi",
-						url: "https://eslint.style/rules/js/semi",
+						url: "https://eslint.style/rules/semi",
 					},
 				},
 			],

package/lib/rules/space-before-blocks.js

@@ -49,12 +49,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "space-before-blocks",
-						url: "https://eslint.style/rules/js/space-before-blocks",
+						url: "https://eslint.style/rules/space-before-blocks",
 					},
 				},
 			],

package/lib/rules/space-before-function-paren.js

@@ -29,12 +29,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "space-before-function-paren",
-						url: "https://eslint.style/rules/js/space-before-function-paren",
+						url: "https://eslint.style/rules/space-before-function-paren",
 					},
 				},
 			],

package/lib/rules/space-in-parens.js

@@ -25,12 +25,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "space-in-parens",
-						url: "https://eslint.style/rules/js/space-in-parens",
+						url: "https://eslint.style/rules/space-in-parens",
 					},
 				},
 			],

package/lib/rules/space-infix-ops.js

@@ -25,12 +25,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "space-infix-ops",
-						url: "https://eslint.style/rules/js/space-infix-ops",
+						url: "https://eslint.style/rules/space-infix-ops",
 					},
 				},
 			],

package/lib/rules/space-unary-ops.js

@@ -29,12 +29,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "space-unary-ops",
-						url: "https://eslint.style/rules/js/space-unary-ops",
+						url: "https://eslint.style/rules/space-unary-ops",
 					},
 				},
 			],

package/lib/rules/spaced-comment.js

@@ -154,12 +154,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "spaced-comment",
-						url: "https://eslint.style/rules/js/spaced-comment",
+						url: "https://eslint.style/rules/spaced-comment",
 					},
 				},
 			],

package/lib/rules/switch-colon-spacing.js

@@ -30,12 +30,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "switch-colon-spacing",
-						url: "https://eslint.style/rules/js/switch-colon-spacing",
+						url: "https://eslint.style/rules/switch-colon-spacing",
 					},
 				},
 			],

package/lib/rules/template-curly-spacing.js

@@ -30,12 +30,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "template-curly-spacing",
-						url: "https://eslint.style/rules/js/template-curly-spacing",
+						url: "https://eslint.style/rules/template-curly-spacing",
 					},
 				},
 			],

package/lib/rules/template-tag-spacing.js

@@ -24,12 +24,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "template-tag-spacing",
-						url: "https://eslint.style/rules/js/template-tag-spacing",
+						url: "https://eslint.style/rules/template-tag-spacing",
 					},
 				},
 			],

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

@@ -1193,6 +1193,35 @@ let needsPrecedingSemicolon;
 		"WithStatement",
 	]);
 
+	const TS_TYPE_NODE_TYPES = new Set([
+		"TSAsExpression",
+		"TSSatisfiesExpression",
+		"TSTypeAliasDeclaration",
+		"TSTypeAnnotation",
+	]);
+
+	/**
+	 * Determines whether a specified node is inside a TypeScript type context.
+	 * @param {ASTNode} node The node to check.
+	 * @returns {boolean} Whether the node is inside a TypeScript type context.
+	 */
+	function isInType(node) {
+		for (let currNode = node; ; ) {
+			const { parent } = currNode;
+			if (!parent) {
+				break;
+			}
+			if (
+				TS_TYPE_NODE_TYPES.has(parent.type) &&
+				currNode === parent.typeAnnotation
+			) {
+				return true;
+			}
+			currNode = parent;
+		}
+		return false;
+	}
+
 	needsPrecedingSemicolon = function (sourceCode, node) {
 		const prevToken = sourceCode.getTokenBefore(node);
 
@@ -1206,6 +1235,16 @@ let needsPrecedingSemicolon;
 
 		const prevNode = sourceCode.getNodeByRangeIndex(prevToken.range[0]);
 
+		if (
+			prevNode.type === "TSDeclareFunction" ||
+			prevNode.parent.type === "TSImportEqualsDeclaration" ||
+			prevNode.parent.parent?.type === "TSImportEqualsDeclaration" ||
+			TS_TYPE_NODE_TYPES.has(prevNode.type) ||
+			isInType(prevNode)
+		) {
+			return false;
+		}
+
 		if (isClosingParenToken(prevToken)) {
 			return !STATEMENTS.has(prevNode.type);
 		}
@@ -1222,6 +1261,12 @@ let needsPrecedingSemicolon;
 		}
 
 		if (IDENTIFIER_OR_KEYWORD.has(prevToken.type)) {
+			if (
+				prevNode.parent.type === "VariableDeclarator" &&
+				!prevNode.parent.init
+			) {
+				return false;
+			}
 			if (BREAK_OR_CONTINUE.has(prevNode.parent.type)) {
 				return false;
 			}

package/lib/rules/wrap-iife.js

@@ -51,12 +51,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "wrap-iife",
-						url: "https://eslint.style/rules/js/wrap-iife",
+						url: "https://eslint.style/rules/wrap-iife",
 					},
 				},
 			],

package/lib/rules/wrap-regex.js

@@ -24,12 +24,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "wrap-regex",
-						url: "https://eslint.style/rules/js/wrap-regex",
+						url: "https://eslint.style/rules/wrap-regex",
 					},
 				},
 			],

package/lib/rules/yield-star-spacing.js

@@ -24,12 +24,12 @@ module.exports = {
 						"ESLint Stylistic now maintains deprecated stylistic core rules.",
 					url: "https://eslint.style/guide/migration",
 					plugin: {
-						name: "@stylistic/eslint-plugin-js",
-						url: "https://eslint.style/packages/js",
+						name: "@stylistic/eslint-plugin",
+						url: "https://eslint.style",
 					},
 					rule: {
 						name: "yield-star-spacing",
-						url: "https://eslint.style/rules/js/yield-star-spacing",
+						url: "https://eslint.style/rules/yield-star-spacing",
 					},
 				},
 			],

package/lib/services/suppressions-service.js

@@ -112,6 +112,14 @@ class SuppressionsService {
 			}
 		}
 
+		for (const file of Object.keys(suppressions)) {
+			const absolutePath = path.resolve(this.cwd, file);
+
+			if (!fs.existsSync(absolutePath)) {
+				delete suppressions[file];
+			}
+		}
+
 		return this.save(suppressions);
 	}
 

package/lib/shared/flags.js

@@ -29,7 +29,7 @@ const activeFlags = new Map([
 	["test_only", "Used only for testing."],
 	["test_only_2", "Used only for testing."],
 	[
-		"unstable_config_lookup_from_file",
+		"v10_config_lookup_from_file",
 		"Look up `eslint.config.js` from the file being linted.",
 	],
 	[
@@ -73,6 +73,14 @@ const inactiveFlags = new Map([
 			replacedBy: null,
 		},
 	],
+	[
+		"unstable_config_lookup_from_file",
+		{
+			description:
+				"Look up `eslint.config.js` from the file being linted.",
+			replacedBy: "v10_config_lookup_from_file",
+		},
+	],
 ]);
 
 /**

package/lib/shared/naming.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Common helpers for naming of plugins, formatters and configs
+ */
+
+"use strict";
+
+const NAMESPACE_REGEX = /^@.*\//iu;
+
+/**
+ * Brings package name to correct format based on prefix
+ * @param {string} name The name of the package.
+ * @param {string} prefix Can be either "eslint-plugin", "eslint-config" or "eslint-formatter"
+ * @returns {string} Normalized name of the package
+ * @private
+ */
+function normalizePackageName(name, prefix) {
+	let normalizedName = name;
+
+	/**
+	 * On Windows, name can come in with Windows slashes instead of Unix slashes.
+	 * Normalize to Unix first to avoid errors later on.
+	 * https://github.com/eslint/eslint/issues/5644
+	 */
+	if (normalizedName.includes("\\")) {
+		normalizedName = normalizedName.replace(/\\/gu, "/");
+	}
+
+	if (normalizedName.charAt(0) === "@") {
+		/**
+		 * it's a scoped package
+		 * package name is the prefix, or just a username
+		 */
+		const scopedPackageShortcutRegex = new RegExp(
+				`^(@[^/]+)(?:/(?:${prefix})?)?$`,
+				"u",
+			),
+			scopedPackageNameRegex = new RegExp(`^${prefix}(-|$)`, "u");
+
+		if (scopedPackageShortcutRegex.test(normalizedName)) {
+			normalizedName = normalizedName.replace(
+				scopedPackageShortcutRegex,
+				`$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
+			 */
+			normalizedName = normalizedName.replace(
+				/^@([^/]+)\/(.*)$/u,
+				`@$1/${prefix}-$2`,
+			);
+		}
+	} else if (!normalizedName.startsWith(`${prefix}-`)) {
+		normalizedName = `${prefix}-${normalizedName}`;
+	}
+
+	return normalizedName;
+}
+
+/**
+ * Removes the prefix from a fullname.
+ * @param {string} fullname The term which may have the prefix.
+ * @param {string} prefix The prefix to remove.
+ * @returns {string} The term without prefix.
+ */
+function getShorthandName(fullname, prefix) {
+	if (fullname[0] === "@") {
+		let matchResult = new RegExp(`^(@[^/]+)/${prefix}$`, "u").exec(
+			fullname,
+		);
+
+		if (matchResult) {
+			return matchResult[1];
+		}
+
+		matchResult = new RegExp(`^(@[^/]+)/${prefix}-(.+)$`, "u").exec(
+			fullname,
+		);
+		if (matchResult) {
+			return `${matchResult[1]}/${matchResult[2]}`;
+		}
+	} else if (fullname.startsWith(`${prefix}-`)) {
+		return fullname.slice(prefix.length + 1);
+	}
+
+	return fullname;
+}
+
+/**
+ * Gets the scope (namespace) of a term.
+ * @param {string} term The term which may have the namespace.
+ * @returns {string} The namespace of the term if it has one.
+ */
+function getNamespaceFromTerm(term) {
+	const match = term.match(NAMESPACE_REGEX);
+
+	return match ? match[0] : "";
+}
+
+//------------------------------------------------------------------------------
+// Public Interface
+//------------------------------------------------------------------------------
+
+module.exports = {
+	normalizePackageName,
+	getShorthandName,
+	getNamespaceFromTerm,
+};

package/lib/shared/relative-module-resolver.js

@@ -0,0 +1,28 @@
+/**
+ * Utility for resolving a module relative to another module
+ * @author Teddy Katz
+ */
+
+"use strict";
+
+const Module = require("node:module");
+
+/*
+ * `Module.createRequire` is added in v12.2.0. It supports URL as well.
+ * We only support the case where the argument is a filepath, not a URL.
+ */
+const createRequire = Module.createRequire;
+
+/**
+ * Resolves a Node module relative to another module
+ * @param {string} moduleName The name of a Node module, or a path to a Node module.
+ * @param {string} relativeToPath An absolute path indicating the module that `moduleName` should be resolved relative to. This must be
+ * a file rather than a directory, but the file need not actually exist.
+ * @returns {string} The absolute path that would result from calling `require.resolve(moduleName)` in a file located at `relativeToPath`
+ * @throws {Error} When the module cannot be resolved.
+ */
+function resolve(moduleName, relativeToPath) {
+	return createRequire(relativeToPath).resolve(moduleName);
+}
+
+exports.resolve = resolve;

package/lib/shared/runtime-info.js

@@ -150,7 +150,7 @@ function environment() {
 	return [
 		"Environment Info:",
 		"",
-		`Node version: ${getBinVersion("node")}`,
+		`Node version: ${process.version}`,
 		`npm version: ${getBinVersion("npm")}`,
 		`Local ESLint version: ${getNpmPackageVersion("eslint", { global: false })}`,
 		`Global ESLint version: ${getNpmPackageVersion("eslint", { global: true })}`,

package/lib/types/index.d.ts

@@ -289,6 +289,8 @@ export class SourceCode
 		second: ESTree.Node | AST.Token,
 	): boolean;
 
+	isGlobalReference(node: ESTree.Identifier): boolean;
+
 	markVariableAsUsed(name: string, refNode?: ESTree.Node): boolean;
 
 	traverse(): Iterable<TraversalStep>;
@@ -1414,6 +1416,7 @@ export namespace Linter {
 		| 14
 		| 15
 		| 16
+		| 17
 		| 2015
 		| 2016
 		| 2017
@@ -1425,6 +1428,7 @@ export namespace Linter {
 		| 2023
 		| 2024
 		| 2025
+		| 2026
 		| "latest";
 
 	/**
@@ -1624,7 +1628,9 @@ export namespace Linter {
 		postprocess?:
 			| ((problemLists: LintMessage[][]) => LintMessage[])
 			| undefined;
-		filterCodeBlock?: boolean | undefined;
+		filterCodeBlock?:
+			| ((filename: string, text: string) => boolean)
+			| undefined;
 		disableFixes?: boolean | undefined;
 		allowInlineConfig?: boolean | undefined;
 		reportUnusedDisableDirectives?: boolean | undefined;
@@ -1770,6 +1776,13 @@ export namespace Linter {
 		 */
 		name?: string;
 
+		/**
+		 * Path to the directory where the configuration object should apply.
+		 * `files` and `ignores` patterns in the configuration object are
+		 * interpreted as relative to this path.
+		 */
+		basePath?: string;
+
 		/**
 		 * An array of glob patterns indicating the files that the configuration
 		 * object should apply to. If not specified, the configuration object applies
@@ -1829,7 +1842,7 @@ export namespace Linter {
 	}
 
 	/** @deprecated  Use `Config` instead of `FlatConfig` */
-	type FlatConfig = Config;
+	type FlatConfig<Rules extends RulesRecord = RulesRecord> = Config<Rules>;
 
 	type GlobalConf =
 		| boolean