eslint 9.23.0 → 9.24.0

package/README.md

@@ -321,7 +321,7 @@ 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> <a href="https://www.airbnb.com/"><img src="https://images.opencollective.com/airbnb/d327d66/logo.png" alt="Airbnb" 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://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" 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> <a href="https://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" height="96"></a></p><h3>Silver Sponsors</h3>
 <p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/e6d15e1/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/5c4fa84/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://www.crosswordsolver.org/anagram-solver/"><img src="https://images.opencollective.com/anagram-solver/2666271/logo.png" alt="Anagram Solver" 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://nolebase.ayaka.io"><img src="https://avatars.githubusercontent.com/u/11081491" alt="Neko" height="32"></a> <a href="https://nx.dev"><img src="https://avatars.githubusercontent.com/u/23692104" alt="Nx" height="32"></a> <a href="https://opensource.mercedes-benz.com/"><img src="https://avatars.githubusercontent.com/u/34240465" alt="Mercedes-Benz Group" 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="LambdaTest" height="32"></a></p>
 <h3>Technology Sponsors</h3>

package/lib/cli-engine/cli-engine.js

@@ -65,8 +65,8 @@ const validFixTypes = new Set(["directive", "problem", "suggestion", "layout"]);
 /** @typedef {import("../shared/types").ParserOptions} ParserOptions */
 /** @typedef {import("../shared/types").Plugin} Plugin */
 /** @typedef {import("../shared/types").RuleConf} RuleConf */
-/** @typedef {import("../shared/types").Rule} Rule */
-/** @typedef {import("../shared/types").FormatterFunction} FormatterFunction */
+/** @typedef {import("../types").Rule.RuleModule} Rule */
+/** @typedef {import("../types").ESLint.FormatterFunction} FormatterFunction */
 /** @typedef {ReturnType<CascadingConfigArrayFactory.getConfigArrayForFile>} ConfigArray */
 /** @typedef {ReturnType<ConfigArray.extractConfig>} ExtractedConfig */
 

package/lib/cli.js

@@ -32,6 +32,8 @@ const {
 	Legacy: { naming },
 } = require("@eslint/eslintrc");
 const { ModuleImporter } = require("@humanwhocodes/module-importer");
+const { getCacheFile } = require("./eslint/eslint-helpers");
+const { SuppressionsService } = require("./services/suppressions-service");
 const debug = require("debug")("eslint:cli");
 
 //------------------------------------------------------------------------------
@@ -584,6 +586,39 @@ const cli = {
 			}
 		}
 
+		if (options.suppressAll && options.suppressRule) {
+			log.error(
+				"The --suppress-all option and the --suppress-rule option cannot be used together.",
+			);
+			return 2;
+		}
+
+		if (options.suppressAll && options.pruneSuppressions) {
+			log.error(
+				"The --suppress-all option and the --prune-suppressions option cannot be used together.",
+			);
+			return 2;
+		}
+
+		if (options.suppressRule && options.pruneSuppressions) {
+			log.error(
+				"The --suppress-rule option and the --prune-suppressions option cannot be used together.",
+			);
+			return 2;
+		}
+
+		if (
+			useStdin &&
+			(options.suppressAll ||
+				options.suppressRule ||
+				options.pruneSuppressions)
+		) {
+			log.error(
+				"The --suppress-all, --suppress-rule, and --prune-suppressions options cannot be used with piped-in code.",
+			);
+			return 2;
+		}
+
 		const ActiveESLint = usingFlatConfig ? ESLint : LegacyESLint;
 		const eslintOptions = await translateOptions(
 			options,
@@ -608,6 +643,58 @@ const cli = {
 			await ActiveESLint.outputFixes(results);
 		}
 
+		let unusedSuppressions = {};
+
+		if (!useStdin) {
+			const suppressionsFileLocation = getCacheFile(
+				options.suppressionsLocation || "eslint-suppressions.json",
+				process.cwd(),
+				{
+					prefix: "suppressions_",
+				},
+			);
+
+			if (
+				options.suppressionsLocation &&
+				!fs.existsSync(suppressionsFileLocation) &&
+				!options.suppressAll &&
+				!options.suppressRule
+			) {
+				log.error(
+					"The suppressions file does not exist. Please run the command with `--suppress-all` or `--suppress-rule` to create it.",
+				);
+				return 2;
+			}
+
+			if (
+				options.suppressAll ||
+				options.suppressRule ||
+				options.pruneSuppressions ||
+				fs.existsSync(suppressionsFileLocation)
+			) {
+				const suppressions = new SuppressionsService({
+					filePath: suppressionsFileLocation,
+					cwd: process.cwd(),
+				});
+
+				if (options.suppressAll || options.suppressRule) {
+					await suppressions.suppress(results, options.suppressRule);
+				}
+
+				if (options.pruneSuppressions) {
+					await suppressions.prune(results);
+				}
+
+				const suppressionResults = suppressions.applySuppressions(
+					results,
+					await suppressions.load(),
+				);
+
+				results = suppressionResults.results;
+				unusedSuppressions = suppressionResults.unused;
+			}
+		}
+
 		let resultsToPrint = results;
 
 		if (options.quiet) {
@@ -648,7 +735,17 @@ const cli = {
 				);
 			}
 
-			if (shouldExitForFatalErrors) {
+			const unusedSuppressionsCount =
+				Object.keys(unusedSuppressions).length;
+
+			if (unusedSuppressionsCount > 0) {
+				log.error(
+					"There are suppressions left that do not occur anymore. Consider re-running the command with `--prune-suppressions`.",
+				);
+				debug(JSON.stringify(unusedSuppressions, null, 2));
+			}
+
+			if (shouldExitForFatalErrors || unusedSuppressionsCount > 0) {
 				return 2;
 			}
 

package/lib/config/config-loader.js

@@ -21,8 +21,10 @@ const { FlatConfigArray } = require("./flat-config-array");
 //-----------------------------------------------------------------------------
 
 /**
- * @typedef {import("../shared/types").FlatConfigObject} FlatConfigObject
- * @typedef {import("../shared/types").FlatConfigArray} FlatConfigArray
+ * @import { ConfigData, ConfigData as FlatConfigObject } from "../shared/types.js";
+ */
+
+/**
  * @typedef {Object} ConfigLoaderOptions
  * @property {string|false|undefined} configFile The path to the config file to use.
  * @property {string} cwd The current working directory.
@@ -30,7 +32,8 @@ const { FlatConfigArray } = require("./flat-config-array");
  * @property {FlatConfigArray} [baseConfig] The base config to use.
  * @property {Array<FlatConfigObject>} [defaultConfigs] The default configs to use.
  * @property {Array<string>} [ignorePatterns] The ignore patterns to use.
- * @property {FlatConfigObject|Array<FlatConfigObject>} overrideConfig The override config to use.
+ * @property {FlatConfigObject|Array<FlatConfigObject>} [overrideConfig] The override config to use.
+ * @property {boolean} [hasUnstableNativeNodeJsTSConfigFlag] The flag to indicate whether the `unstable_native_nodejs_ts_config` flag is enabled.
  */
 
 //------------------------------------------------------------------------------
@@ -108,12 +111,87 @@ function isRunningInDeno() {
 	return !!globalThis.Deno;
 }
 
+/**
+ * Checks if native TypeScript support is
+ * enabled in the current Node.js process.
+ *
+ * This function determines if the
+ * {@linkcode NodeJS.ProcessFeatures.typescript | typescript}
+ * feature is present in the
+ * {@linkcode process.features} object
+ * and if its value is either "strip" or "transform".
+ * @returns {boolean} `true` if native TypeScript support is enabled, otherwise `false`.
+ * @since 9.24.0
+ */
+function isNativeTypeScriptSupportEnabled() {
+	return (
+		// eslint-disable-next-line n/no-unsupported-features/node-builtins -- it's still an experimental feature.
+		["strip", "transform"].includes(process.features.typescript)
+	);
+}
+
+/**
+ * Load the TypeScript configuration file.
+ * @param {string} filePath The absolute file path to load.
+ * @param {URL} fileURL The file URL to load.
+ * @param {number} mtime The last modified timestamp of the file.
+ * @returns {Promise<any>} The configuration loaded from the file.
+ * @since 9.24.0
+ */
+async function loadTypeScriptConfigFileWithJiti(filePath, fileURL, mtime) {
+	// eslint-disable-next-line no-use-before-define -- `ConfigLoader.loadJiti` can be overwritten for testing
+	const { createJiti } = await ConfigLoader.loadJiti().catch(() => {
+		throw new Error(
+			"The 'jiti' library is required for loading TypeScript configuration files. Make sure to install it.",
+		);
+	});
+
+	// `createJiti` was added in jiti v2.
+	if (typeof createJiti !== "function") {
+		throw new Error(
+			"You are using an outdated version of the 'jiti' library. Please update to the latest version of 'jiti' to ensure compatibility and access to the latest features.",
+		);
+	}
+
+	/*
+	 * Disabling `moduleCache` allows us to reload a
+	 * config file when the last modified timestamp changes.
+	 */
+
+	const jiti = createJiti(__filename, {
+		moduleCache: false,
+		interopDefault: false,
+	});
+	const config = await jiti.import(fileURL.href);
+
+	importedConfigFileModificationTime.set(filePath, mtime);
+
+	return config?.default ?? config;
+}
+
+/**
+ * Dynamically imports a module from the given file path.
+ * @param {string} filePath The absolute file path of the module to import.
+ * @param {URL} fileURL The file URL to load.
+ * @param {number} mtime The last modified timestamp of the file.
+ * @returns {Promise<any>} - A {@linkcode Promise | promise} that resolves to the imported ESLint config.
+ * @since 9.24.0
+ */
+async function dynamicImportConfig(filePath, fileURL, mtime) {
+	const module = await import(fileURL.href);
+
+	importedConfigFileModificationTime.set(filePath, mtime);
+
+	return module.default;
+}
+
 /**
  * Load the config array from the given filename.
  * @param {string} filePath The filename to load from.
+ * @param {boolean} hasUnstableNativeNodeJsTSConfigFlag The flag to indicate whether the `unstable_native_nodejs_ts_config` flag is enabled.
  * @returns {Promise<any>} The config loaded from the config file.
  */
-async function loadConfigFile(filePath) {
+async function loadConfigFile(filePath, hasUnstableNativeNodeJsTSConfigFlag) {
 	debug(`Loading config from ${filePath}`);
 
 	const fileURL = pathToFileURL(filePath);
@@ -161,44 +239,36 @@ async function loadConfigFile(filePath) {
 	 *
 	 * When Node.js supports native TypeScript imports, we can remove this check.
 	 */
-	if (isTS && !isDeno && !isBun) {
-		// eslint-disable-next-line no-use-before-define -- `ConfigLoader.loadJiti` can be overwritten for testing
-		const { createJiti } = await ConfigLoader.loadJiti().catch(() => {
-			throw new Error(
-				"The 'jiti' library is required for loading TypeScript configuration files. Make sure to install it.",
-			);
-		});
 
-		// `createJiti` was added in jiti v2.
-		if (typeof createJiti !== "function") {
+	if (isTS) {
+		if (hasUnstableNativeNodeJsTSConfigFlag) {
+			if (isNativeTypeScriptSupportEnabled()) {
+				return await dynamicImportConfig(filePath, fileURL, mtime);
+			}
+
+			if (!("typescript" in process.features)) {
+				throw new Error(
+					"The unstable_native_nodejs_ts_config flag is not supported in older versions of Node.js.",
+				);
+			}
+
 			throw new Error(
-				"You are using an outdated version of the 'jiti' library. Please update to the latest version of 'jiti' to ensure compatibility and access to the latest features.",
+				"The unstable_native_nodejs_ts_config flag is enabled, but native TypeScript support is not enabled in the current Node.js process. You need to either enable native TypeScript support by passing --experimental-strip-types or remove the unstable_native_nodejs_ts_config flag.",
 			);
 		}
 
-		/*
-		 * Disabling `moduleCache` allows us to reload a
-		 * config file when the last modified timestamp changes.
-		 */
-
-		const jiti = createJiti(__filename, {
-			moduleCache: false,
-			interopDefault: false,
-		});
-		const config = await jiti.import(fileURL.href);
-
-		importedConfigFileModificationTime.set(filePath, mtime);
-
-		return config?.default ?? config;
+		if (!isDeno && !isBun) {
+			return await loadTypeScriptConfigFileWithJiti(
+				filePath,
+				fileURL,
+				mtime,
+			);
+		}
 	}
 
 	// fallback to normal runtime behavior
 
-	const config = (await import(fileURL)).default;
-
-	importedConfigFileModificationTime.set(filePath, mtime);
-
-	return config;
+	return await dynamicImportConfig(filePath, fileURL, mtime);
 }
 
 //-----------------------------------------------------------------------------
@@ -495,6 +565,7 @@ class ConfigLoader {
 			ignoreEnabled,
 			ignorePatterns,
 			overrideConfig,
+			hasUnstableNativeNodeJsTSConfigFlag = false,
 			defaultConfigs = [],
 		} = options;
 
@@ -510,7 +581,10 @@ class ConfigLoader {
 		// load config file
 		if (configFilePath) {
 			debug(`Loading config file ${configFilePath}`);
-			const fileConfig = await loadConfigFile(configFilePath);
+			const fileConfig = await loadConfigFile(
+				configFilePath,
+				hasUnstableNativeNodeJsTSConfigFlag,
+			);
 
 			/*
 			 * It's possible that a config file could be empty or else

package/lib/config/flat-config-helpers.js

@@ -9,7 +9,10 @@
 // Typedefs
 //------------------------------------------------------------------------------
 
-/** @typedef {import("../shared/types").Rule} Rule */
+/**
+ * @import { RuleDefinition } from "@eslint/core";
+ * @import { Linter } from "eslint";
+ */
 
 //------------------------------------------------------------------------------
 // Private Members
@@ -59,8 +62,8 @@ function parseRuleId(ruleId) {
 /**
  * Retrieves a rule instance from a given config based on the ruleId.
  * @param {string} ruleId The rule ID to look for.
- * @param {FlatConfig} config The config to search.
- * @returns {import("../shared/types").Rule|undefined} The rule if found
+ * @param {Linter.Config} config The config to search.
+ * @returns {RuleDefinition|undefined} The rule if found
  *      or undefined if not.
  */
 function getRuleFromConfig(ruleId, config) {
@@ -71,7 +74,7 @@ function getRuleFromConfig(ruleId, config) {
 
 /**
  * Gets a complete options schema for a rule.
- * @param {Rule} rule A rule object
+ * @param {RuleDefinition} rule A rule object
  * @throws {TypeError} If `meta.schema` is specified but is not an array, object or `false`.
  * @returns {Object|null} JSON Schema for the rule's options. `null` if `meta.schema` is `false`.
  */

package/lib/eslint/eslint-helpers.js

@@ -28,6 +28,12 @@ const MINIMATCH_OPTIONS = { dot: true };
 // Types
 //-----------------------------------------------------------------------------
 
+/**
+ * @import { ESLintOptions } from "./eslint.js";
+ * @import { LintMessage, LintResult } from "../shared/types.js";
+ * @import { ConfigLoader, LegacyConfigLoader } from "../config/config-loader.js";
+ */
+
 /**
  * @typedef {Object} GlobSearch
  * @property {Array<string>} patterns The normalized patterns to use for a search.
@@ -115,7 +121,7 @@ function isNonEmptyString(value) {
  */
 function isArrayOfNonEmptyString(value) {
 	return (
-		Array.isArray(value) && value.length && value.every(isNonEmptyString)
+		Array.isArray(value) && !!value.length && value.every(isNonEmptyString)
 	);
 }
 
@@ -351,7 +357,7 @@ async function globSearch({
  *      as the user inputted them. Used for errors.
  * @param {Array<string>} options.unmatchedPatterns A non-empty array of absolute path glob patterns
  *      that were unmatched in the original search.
- * @returns {void} Always throws an error.
+ * @returns {Promise<never>} Always throws an error.
  * @throws {NoFilesFoundError} If the first unmatched pattern
  *      doesn't match any files even when there are no ignores.
  * @throws {AllFilesIgnoredError} If the first unmatched pattern
@@ -454,7 +460,7 @@ async function globMultiSearch({
 		}
 	}
 
-	// second loop for `fulfulled` results
+	// second loop for `fulfilled` results
 	return results.flatMap(result => result.value);
 }
 
@@ -664,6 +670,42 @@ 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
 //-----------------------------------------------------------------------------
@@ -915,9 +957,11 @@ function processOptions({
  * if cacheFile points to a file or looks like a file then in will just use that file
  * @param {string} cacheFile The name of file to be used to store the cache
  * @param {string} cwd Current working directory
+ * @param {Object} options The options
+ * @param {string} [options.prefix] The prefix to use for the cache file
  * @returns {string} the resolved path to the cache file
  */
-function getCacheFile(cacheFile, cwd) {
+function getCacheFile(cacheFile, cwd, { prefix = ".cache_" } = {}) {
 	/*
 	 * make sure the path separators are normalized for the environment/os
 	 * keeping the trailing path separator if present
@@ -932,7 +976,7 @@ function getCacheFile(cacheFile, cwd) {
 	 * @returns {string} the resolved path to the cacheFile
 	 */
 	function getCacheFileForDirectory() {
-		return path.join(resolvedCacheFile, `.cache_${hash(cwd)}`);
+		return path.join(resolvedCacheFile, `${prefix}${hash(cwd)}`);
 	}
 
 	let fileStats;
@@ -988,6 +1032,7 @@ module.exports = {
 
 	createIgnoreResult,
 	isErrorMessage,
+	calculateStatsPerFile,
 
 	processOptions,
 

package/lib/eslint/eslint.js

@@ -33,6 +33,7 @@ const {
 
 	createIgnoreResult,
 	isErrorMessage,
+	calculateStatsPerFile,
 
 	processOptions,
 } = require("./eslint-helpers");
@@ -51,19 +52,15 @@ const { ConfigLoader, LegacyConfigLoader } = require("../config/config-loader");
 //------------------------------------------------------------------------------
 
 // For VSCode IntelliSense
-/** @typedef {import("../cli-engine/cli-engine").ConfigArray} ConfigArray */
-/** @typedef {import("../shared/types").ConfigData} ConfigData */
-/** @typedef {import("../shared/types").DeprecatedRuleInfo} DeprecatedRuleInfo */
-/** @typedef {import("../shared/types").LintMessage} LintMessage */
-/** @typedef {import("../shared/types").LintResult} LintResult */
-/** @typedef {import("../shared/types").ParserOptions} ParserOptions */
-/** @typedef {import("../shared/types").Plugin} Plugin */
-/** @typedef {import("../shared/types").ResultsMeta} ResultsMeta */
-/** @typedef {import("../shared/types").RuleConf} RuleConf */
-/** @typedef {import("../shared/types").Rule} Rule */
+/**
+ * @import { ConfigArray } from "../cli-engine/cli-engine.js";
+ * @import { CLIEngineLintReport } from "./legacy-eslint.js";
+ * @import { FlatConfigArray } from "../config/flat-config-array.js";
+ * @import { RuleDefinition } from "@eslint/core";
+ * @import { ConfigData, DeprecatedRuleInfo, LintMessage, LintResult, Plugin, ResultsMeta } from "../shared/types.js";
+ */
+
 /** @typedef {ReturnType<ConfigArray.extractConfig>} ExtractedConfig */
-/** @typedef {import('../cli-engine/cli-engine').CLIEngine} CLIEngine */
-/** @typedef {import('./legacy-eslint').CLIEngineLintReport} CLIEngineLintReport */
 
 /**
  * The options with which to configure the ESLint instance.
@@ -110,45 +107,9 @@ const removedFormatters = new Set([
 	"visualstudio",
 ]);
 
-/**
- * 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;
-}
-
 /**
  * Create rulesMeta object.
- * @param {Map<string,Rule>} rules a map of rules from which to generate the object.
+ * @param {Map<string,RuleDefinition>} rules a map of rules from which to generate the object.
  * @returns {Object} metadata for all enabled rules.
  */
 function createRulesMeta(rules) {
@@ -173,7 +134,7 @@ const usedDeprecatedRulesCache = new WeakMap();
 
 /**
  * Create used deprecated rule list.
- * @param {CLIEngine} eslint The CLIEngine instance.
+ * @param {ESLint} eslint The ESLint instance.
  * @param {string} maybeFilePath The absolute path to a lint target file or `"<text>"`.
  * @returns {DeprecatedRuleInfo[]} The used deprecated rule list.
  */
@@ -226,7 +187,7 @@ function getOrFindUsedDeprecatedRules(eslint, maybeFilePath) {
 /**
  * Processes the linting results generated by a CLIEngine linting report to
  * match the ESLint class's API.
- * @param {CLIEngine} eslint The CLIEngine instance.
+ * @param {ESLint} eslint The ESLint instance.
  * @param {CLIEngineLintReport} report The CLIEngine linting report to process.
  * @returns {LintResult[]} The processed linting results.
  */
@@ -382,7 +343,7 @@ function verifyText({
 /**
  * Checks whether a message's rule type should be fixed.
  * @param {LintMessage} message The message to check.
- * @param {FlatConfig} config The config for the file that generated the message.
+ * @param {FlatConfigArray} config The config for the file that generated the message.
  * @param {string[]} fixTypes An array of fix types to check.
  * @returns {boolean} Whether the message should be fixed.
  */
@@ -410,7 +371,7 @@ function createExtraneousResultsError() {
  * Creates a fixer function based on the provided fix, fixTypesSet, and config.
  * @param {Function|boolean} fix The original fix option.
  * @param {Set<string>} fixTypesSet A set of fix types to filter messages for fixing.
- * @param {FlatConfig} config The config for the file that generated the message.
+ * @param {FlatConfigArray} config The config for the file that generated the message.
  * @returns {Function|boolean} The fixer function or the original fix value.
  */
 function getFixerForFixTypes(fix, fixTypesSet, config) {
@@ -475,6 +436,9 @@ class ESLint {
 			ignoreEnabled: processedOptions.ignore,
 			ignorePatterns: processedOptions.ignorePatterns,
 			defaultConfigs,
+			hasUnstableNativeNodeJsTSConfigFlag: linter.hasFlag(
+				"unstable_native_nodejs_ts_config",
+			),
 		};
 
 		this.#configLoader = linter.hasFlag("unstable_config_lookup_from_file")

package/lib/eslint/legacy-eslint.js

@@ -35,7 +35,7 @@ const { version } = require("../../package.json");
 /** @typedef {import("../shared/types").LintMessage} LintMessage */
 /** @typedef {import("../shared/types").SuppressedLintMessage} SuppressedLintMessage */
 /** @typedef {import("../shared/types").Plugin} Plugin */
-/** @typedef {import("../shared/types").Rule} Rule */
+/** @typedef {import("../types").Rule.RuleModule} Rule */
 /** @typedef {import("../shared/types").LintResult} LintResult */
 /** @typedef {import("../shared/types").ResultsMeta} ResultsMeta */
 

package/lib/linter/code-path-analysis/code-path-state.js

@@ -335,7 +335,7 @@ class ForLoopContext extends LoopContextBase {
 		this.updateSegments = null;
 
 		/**
-		 * The end of the update expresion. This may change during the lifetime
+		 * The end of the update expression. This may change during the lifetime
 		 * of the instance as we traverse the loop because some loops don't have
 		 * an update expression.
 		 * @type {Array<CodePathSegment>|null}

package/lib/linter/linter.js

@@ -81,7 +81,7 @@ const STEP_KIND_CALL = 2;
 /** @typedef {import("../shared/types").ParserOptions} ParserOptions */
 /** @typedef {import("../shared/types").LanguageOptions} LanguageOptions */
 /** @typedef {import("../shared/types").Processor} Processor */
-/** @typedef {import("../shared/types").Rule} Rule */
+/** @typedef {import("../types").Rule.RuleModule} Rule */
 /** @typedef {import("../shared/types").Times} Times */
 /** @typedef {import("@eslint/core").Language} Language */
 /** @typedef {import("@eslint/core").RuleSeverity} RuleSeverity */

package/lib/linter/rules.js

@@ -16,7 +16,7 @@ const builtInRules = require("../rules");
 // Typedefs
 //------------------------------------------------------------------------------
 
-/** @typedef {import("../shared/types").Rule} Rule */
+/** @typedef {import("../types").Rule.RuleModule} Rule */
 
 //------------------------------------------------------------------------------
 // Public Interface