eslint 9.10.0 → 9.11.1

package/README.md

@@ -297,9 +297,9 @@ The following companies, organizations, and individuals support ESLint's ongoing
 <!--sponsorsstart-->
 <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://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" height="96"></a> <a href="https://opensource.siemens.com"><img src="https://avatars.githubusercontent.com/u/624020?v=4" alt="Siemens" height="96"></a></p><h3>Silver Sponsors</h3>
+<p><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://www.jetbrains.com/"><img src="https://images.opencollective.com/jetbrains/fe76f99/logo.png" alt="JetBrains" 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://americanexpress.io"><img src="https://avatars.githubusercontent.com/u/3853301?v=4" alt="American Express" height="64"></a> <a href="https://www.workleap.com"><img src="https://avatars.githubusercontent.com/u/53535748?u=d1e55d7661d724bf2281c1bfd33cb8f99fe2465f&v=4" alt="Workleap" height="64"></a></p><h3>Bronze Sponsors</h3>
-<p><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.ignitionapp.com"><img src="https://avatars.githubusercontent.com/u/5753491?v=4" alt="Ignition" height="32"></a> <a href="https://nx.dev"><img src="https://avatars.githubusercontent.com/u/23692104?v=4" alt="Nx" height="32"></a> <a href="https://herocoders.com"><img src="https://avatars.githubusercontent.com/u/37549774?v=4" alt="HeroCoders" height="32"></a> <a href="https://usenextbase.com"><img src="https://avatars.githubusercontent.com/u/145838380?v=4" alt="Nextbase Starter Kit" height="32"></a></p>
+<p><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://nx.dev"><img src="https://avatars.githubusercontent.com/u/23692104?v=4" alt="Nx" height="32"></a> <a href="https://herocoders.com"><img src="https://avatars.githubusercontent.com/u/37549774?v=4" alt="HeroCoders" height="32"></a> <a href="https://usenextbase.com"><img src="https://avatars.githubusercontent.com/u/145838380?v=4" alt="Nextbase Starter Kit" height="32"></a></p>
 <!--sponsorsend-->
 
 <!--techsponsorsstart-->

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

@@ -65,13 +65,9 @@ function parseRuleId(ruleId) {
  *      or undefined if not.
  */
 function getRuleFromConfig(ruleId, config) {
-
     const { pluginName, ruleName } = parseRuleId(ruleId);
 
-    const plugin = config.plugins && config.plugins[pluginName];
-    const rule = plugin && plugin.rules && plugin.rules[ruleName];
-
-    return rule;
+    return config.plugins?.[pluginName]?.rules?.[ruleName];
 }
 
 /**

package/lib/languages/js/source-code/source-code.js

@@ -20,7 +20,7 @@ const
 
     CodePathAnalyzer = require("../../../linter/code-path-analysis/code-path-analyzer"),
     createEmitter = require("../../../linter/safe-emitter"),
-    { ConfigCommentParser, VisitNodeStep, CallMethodStep } = require("@eslint/plugin-kit"),
+    { ConfigCommentParser, VisitNodeStep, CallMethodStep, Directive } = require("@eslint/plugin-kit"),
 
     eslintScope = require("eslint-scope");
 
@@ -316,57 +316,6 @@ function markExportedVariables(globalScope, variables) {
 
 }
 
-/**
- * A class to represent a directive comment.
- * @implements {IDirective}
- */
-class Directive {
-
-    /**
-     * The type of directive.
-     * @type {"disable"|"enable"|"disable-next-line"|"disable-line"}
-     * @readonly
-     */
-    type;
-
-    /**
-     * The node representing the directive.
-     * @type {ASTNode|Comment}
-     * @readonly
-     */
-    node;
-
-    /**
-     * Everything after the "eslint-disable" portion of the directive,
-     * but before the "--" that indicates the justification.
-     * @type {string}
-     * @readonly
-     */
-    value;
-
-    /**
-     * The justification for the directive.
-     * @type {string}
-     * @readonly
-     */
-    justification;
-
-    /**
-     * Creates a new instance.
-     * @param {Object} options The options for the directive.
-     * @param {"disable"|"enable"|"disable-next-line"|"disable-line"} options.type The type of directive.
-     * @param {ASTNode|Comment} options.node The node representing the directive.
-     * @param {string} options.value The value of the directive.
-     * @param {string} options.justification The justification for the directive.
-     */
-    constructor({ type, node, value, justification }) {
-        this.type = type;
-        this.node = node;
-        this.value = value;
-        this.justification = justification;
-    }
-}
-
 //------------------------------------------------------------------------------
 // Public Interface
 //------------------------------------------------------------------------------

package/lib/linter/linter.js

@@ -54,6 +54,7 @@ const { LATEST_ECMA_VERSION } = require("../../conf/ecma-version");
 const { VFile } = require("./vfile");
 const { ParserService } = require("../services/parser-service");
 const { FileContext } = require("./file-context");
+const { ProcessorService } = require("../services/processor-service");
 const STEP_KIND_VISIT = 1;
 const STEP_KIND_CALL = 2;
 
@@ -1292,27 +1293,18 @@ class Linter {
     }
 
     /**
-     * Same as linter.verify, except without support for processors.
-     * @param {string|SourceCode} textOrSourceCode The text to parse or a SourceCode object.
+     * Lint using eslintrc and without processors.
+     * @param {VFile} file The file to lint.
      * @param {ConfigData} providedConfig An ESLintConfig instance to configure everything.
      * @param {VerifyOptions} [providedOptions] The optional filename of the file being checked.
      * @throws {Error} If during rule execution.
      * @returns {(LintMessage|SuppressedLintMessage)[]} The results as an array of messages or an empty array if no messages.
      */
-    _verifyWithoutProcessors(textOrSourceCode, providedConfig, providedOptions) {
+    #eslintrcVerifyWithoutProcessors(file, providedConfig, providedOptions) {
+
         const slots = internalSlotsMap.get(this);
         const config = providedConfig || {};
         const options = normalizeVerifyOptions(providedOptions, config);
-        let text;
-
-        // evaluate arguments
-        if (typeof textOrSourceCode === "string") {
-            slots.lastSourceCode = null;
-            text = textOrSourceCode;
-        } else {
-            slots.lastSourceCode = textOrSourceCode;
-            text = textOrSourceCode.text;
-        }
 
         // Resolve parser.
         let parserName = DEFAULT_PARSER_NAME;
@@ -1339,7 +1331,7 @@ class Linter {
 
         // search and apply "eslint-env *".
         const envInFile = options.allowInlineConfig && !options.warnInlineConfig
-            ? findEslintEnv(text)
+            ? findEslintEnv(file.body)
             : {};
         const resolvedEnvConfig = Object.assign({ builtin: true }, config.env, envInFile);
         const enabledEnvs = Object.keys(resolvedEnvConfig)
@@ -1355,9 +1347,6 @@ class Linter {
             parser,
             parserOptions
         });
-        const file = new VFile(options.filename, text, {
-            physicalPath: providedOptions.physicalFilename
-        });
 
         if (!slots.lastSourceCode) {
             let t;
@@ -1468,6 +1457,36 @@ class Linter {
                 .sort((problemA, problemB) => problemA.line - problemB.line || problemA.column - problemB.column),
             reportUnusedDisableDirectives: options.reportUnusedDisableDirectives
         });
+
+    }
+
+    /**
+     * Same as linter.verify, except without support for processors.
+     * @param {string|SourceCode} textOrSourceCode The text to parse or a SourceCode object.
+     * @param {ConfigData} providedConfig An ESLintConfig instance to configure everything.
+     * @param {VerifyOptions} [providedOptions] The optional filename of the file being checked.
+     * @throws {Error} If during rule execution.
+     * @returns {(LintMessage|SuppressedLintMessage)[]} The results as an array of messages or an empty array if no messages.
+     */
+    _verifyWithoutProcessors(textOrSourceCode, providedConfig, providedOptions) {
+        const slots = internalSlotsMap.get(this);
+        const filename = normalizeFilename(providedOptions.filename || "<input>");
+        let text;
+
+        // evaluate arguments
+        if (typeof textOrSourceCode === "string") {
+            slots.lastSourceCode = null;
+            text = textOrSourceCode;
+        } else {
+            slots.lastSourceCode = textOrSourceCode;
+            text = textOrSourceCode.text;
+        }
+
+        const file = new VFile(filename, text, {
+            physicalPath: providedOptions.physicalFilename
+        });
+
+        return this.#eslintrcVerifyWithoutProcessors(file, providedConfig, providedOptions);
     }
 
     /**
@@ -1537,102 +1556,91 @@ class Linter {
      * @returns {(LintMessage|SuppressedLintMessage)[]} The found problems.
      */
     _verifyWithFlatConfigArrayAndProcessor(textOrSourceCode, config, options, configForRecursive) {
+        const slots = internalSlotsMap.get(this);
         const filename = options.filename || "<input>";
         const filenameToExpose = normalizeFilename(filename);
         const physicalFilename = options.physicalFilename || filenameToExpose;
         const text = ensureText(textOrSourceCode);
+        const file = new VFile(filenameToExpose, text, {
+            physicalPath: physicalFilename
+        });
+
         const preprocess = options.preprocess || (rawText => [rawText]);
         const postprocess = options.postprocess || (messagesList => messagesList.flat());
+
+        const processorService = new ProcessorService();
+        const preprocessResult = processorService.preprocessSync(file, {
+            processor: {
+                preprocess,
+                postprocess
+            }
+        });
+
+        if (!preprocessResult.ok) {
+            return preprocessResult.errors;
+        }
+
         const filterCodeBlock =
             options.filterCodeBlock ||
             (blockFilename => blockFilename.endsWith(".js"));
         const originalExtname = path.extname(filename);
+        const { files } = preprocessResult;
 
-        let blocks;
-
-        try {
-            blocks = preprocess(text, filenameToExpose);
-        } catch (ex) {
-
-            // If the message includes a leading line number, strip it:
-            const message = `Preprocessing error: ${ex.message.replace(/^line \d+:/iu, "").trim()}`;
-
-            debug("%s\n%s", message, ex.stack);
-
-            return [
-                {
-                    ruleId: null,
-                    fatal: true,
-                    severity: 2,
-                    message,
-                    line: ex.lineNumber,
-                    column: ex.column,
-                    nodeType: null
-                }
-            ];
-        }
-
-        const messageLists = blocks.map((block, i) => {
-            debug("A code block was found: %o", block.filename || "(unnamed)");
+        const messageLists = files.map(block => {
+            debug("A code block was found: %o", block.path || "(unnamed)");
 
             // Keep the legacy behavior.
             if (typeof block === "string") {
                 return this._verifyWithFlatConfigArrayAndWithoutProcessors(block, config, options);
             }
 
-            const blockText = block.text;
-            const blockName = path.join(filename, `${i}_${block.filename}`);
-
             // Skip this block if filtered.
-            if (!filterCodeBlock(blockName, blockText)) {
+            if (!filterCodeBlock(block.path, block.body)) {
                 debug("This code block was skipped.");
                 return [];
             }
 
             // Resolve configuration again if the file content or extension was changed.
-            if (configForRecursive && (text !== blockText || path.extname(blockName) !== originalExtname)) {
+            if (configForRecursive && (text !== block.rawBody || path.extname(block.path) !== originalExtname)) {
                 debug("Resolving configuration again because the file content or extension was changed.");
                 return this._verifyWithFlatConfigArray(
-                    blockText,
+                    block.rawBody,
                     configForRecursive,
-                    { ...options, filename: blockName, physicalFilename }
+                    { ...options, filename: block.path, physicalFilename: block.physicalPath }
                 );
             }
 
+            slots.lastSourceCode = null;
+
             // Does lint.
-            return this._verifyWithFlatConfigArrayAndWithoutProcessors(
-                blockText,
+            return this.#flatVerifyWithoutProcessors(
+                block,
                 config,
-                { ...options, filename: blockName, physicalFilename }
+                { ...options, filename: block.path, physicalFilename: block.physicalPath }
             );
         });
 
-        return postprocess(messageLists, filenameToExpose);
+        return processorService.postprocessSync(file, messageLists, {
+            processor: {
+                preprocess,
+                postprocess
+            }
+        });
     }
 
     /**
-     * Same as linter.verify, except without support for processors.
-     * @param {string|SourceCode} textOrSourceCode The text to parse or a SourceCode object.
+     * Verify using flat config and without any processors.
+     * @param {VFile} file The file to lint.
      * @param {FlatConfig} providedConfig An ESLintConfig instance to configure everything.
      * @param {VerifyOptions} [providedOptions] The optional filename of the file being checked.
      * @throws {Error} If during rule execution.
      * @returns {(LintMessage|SuppressedLintMessage)[]} The results as an array of messages or an empty array if no messages.
      */
-    _verifyWithFlatConfigArrayAndWithoutProcessors(textOrSourceCode, providedConfig, providedOptions) {
+    #flatVerifyWithoutProcessors(file, providedConfig, providedOptions) {
+
         const slots = internalSlotsMap.get(this);
         const config = providedConfig || {};
         const options = normalizeVerifyOptions(providedOptions, config);
-        let text;
-
-        // evaluate arguments
-        if (typeof textOrSourceCode === "string") {
-            slots.lastSourceCode = null;
-            text = textOrSourceCode;
-        } else {
-            slots.lastSourceCode = textOrSourceCode;
-            text = textOrSourceCode.text;
-        }
-
         const languageOptions = config.languageOptions;
 
         languageOptions.ecmaVersion = normalizeEcmaVersionForLanguageOptions(
@@ -1663,9 +1671,6 @@ class Linter {
         }
 
         const settings = config.settings || {};
-        const file = new VFile(options.filename, text, {
-            physicalPath: providedOptions.physicalFilename
-        });
 
         if (!slots.lastSourceCode) {
             let t;
@@ -1957,6 +1962,37 @@ class Linter {
             ruleFilter: options.ruleFilter,
             configuredRules
         });
+
+
+    }
+
+    /**
+     * Same as linter.verify, except without support for processors.
+     * @param {string|SourceCode} textOrSourceCode The text to parse or a SourceCode object.
+     * @param {FlatConfig} providedConfig An ESLintConfig instance to configure everything.
+     * @param {VerifyOptions} [providedOptions] The optional filename of the file being checked.
+     * @throws {Error} If during rule execution.
+     * @returns {(LintMessage|SuppressedLintMessage)[]} The results as an array of messages or an empty array if no messages.
+     */
+    _verifyWithFlatConfigArrayAndWithoutProcessors(textOrSourceCode, providedConfig, providedOptions) {
+        const slots = internalSlotsMap.get(this);
+        const filename = normalizeFilename(providedOptions.filename || "<input>");
+        let text;
+
+        // evaluate arguments
+        if (typeof textOrSourceCode === "string") {
+            slots.lastSourceCode = null;
+            text = textOrSourceCode;
+        } else {
+            slots.lastSourceCode = textOrSourceCode;
+            text = textOrSourceCode.text;
+        }
+
+        const file = new VFile(filename, text, {
+            physicalPath: providedOptions.physicalFilename
+        });
+
+        return this.#flatVerifyWithoutProcessors(file, providedConfig, providedOptions);
     }
 
     /**
@@ -2057,77 +2093,78 @@ class Linter {
      * @returns {(LintMessage|SuppressedLintMessage)[]} The found problems.
      */
     _verifyWithProcessor(textOrSourceCode, config, options, configForRecursive) {
+        const slots = internalSlotsMap.get(this);
         const filename = options.filename || "<input>";
         const filenameToExpose = normalizeFilename(filename);
         const physicalFilename = options.physicalFilename || filenameToExpose;
         const text = ensureText(textOrSourceCode);
+        const file = new VFile(filenameToExpose, text, {
+            physicalPath: physicalFilename
+        });
+
         const preprocess = options.preprocess || (rawText => [rawText]);
         const postprocess = options.postprocess || (messagesList => messagesList.flat());
-        const filterCodeBlock =
-            options.filterCodeBlock ||
-            (blockFilename => blockFilename.endsWith(".js"));
-        const originalExtname = path.extname(filename);
-
-        let blocks;
 
-        try {
-            blocks = preprocess(text, filenameToExpose);
-        } catch (ex) {
+        const processorService = new ProcessorService();
+        const preprocessResult = processorService.preprocessSync(file, {
+            processor: {
+                preprocess,
+                postprocess
+            }
+        });
 
-            // If the message includes a leading line number, strip it:
-            const message = `Preprocessing error: ${ex.message.replace(/^line \d+:/iu, "").trim()}`;
+        if (!preprocessResult.ok) {
+            return preprocessResult.errors;
+        }
 
-            debug("%s\n%s", message, ex.stack);
+        const filterCodeBlock =
+            options.filterCodeBlock ||
+            (blockFilePath => blockFilePath.endsWith(".js"));
+        const originalExtname = path.extname(filename);
 
-            return [
-                {
-                    ruleId: null,
-                    fatal: true,
-                    severity: 2,
-                    message,
-                    line: ex.lineNumber,
-                    column: ex.column,
-                    nodeType: null
-                }
-            ];
-        }
+        const { files } = preprocessResult;
 
-        const messageLists = blocks.map((block, i) => {
-            debug("A code block was found: %o", block.filename || "(unnamed)");
+        const messageLists = files.map(block => {
+            debug("A code block was found: %o", block.path ?? "(unnamed)");
 
             // Keep the legacy behavior.
             if (typeof block === "string") {
                 return this._verifyWithoutProcessors(block, config, options);
             }
 
-            const blockText = block.text;
-            const blockName = path.join(filename, `${i}_${block.filename}`);
-
             // Skip this block if filtered.
-            if (!filterCodeBlock(blockName, blockText)) {
+            if (!filterCodeBlock(block.path, block.body)) {
                 debug("This code block was skipped.");
                 return [];
             }
 
             // Resolve configuration again if the file content or extension was changed.
-            if (configForRecursive && (text !== blockText || path.extname(blockName) !== originalExtname)) {
+            if (configForRecursive && (text !== block.rawBody || path.extname(block.path) !== originalExtname)) {
                 debug("Resolving configuration again because the file content or extension was changed.");
                 return this._verifyWithConfigArray(
-                    blockText,
+                    block.rawBody,
                     configForRecursive,
-                    { ...options, filename: blockName, physicalFilename }
+                    { ...options, filename: block.path, physicalFilename: block.physicalPath }
                 );
             }
 
+            slots.lastSourceCode = null;
+
             // Does lint.
-            return this._verifyWithoutProcessors(
-                blockText,
+            return this.#eslintrcVerifyWithoutProcessors(
+                block,
                 config,
-                { ...options, filename: blockName, physicalFilename }
+                { ...options, filename: block.path, physicalFilename: block.physicalPath }
             );
         });
 
-        return postprocess(messageLists, filenameToExpose);
+        return processorService.postprocessSync(file, messageLists, {
+            processor: {
+                preprocess,
+                postprocess
+            }
+        });
+
     }
 
     /**

package/lib/linter/vfile.js

@@ -85,6 +85,13 @@ class VFile {
      */
     body;
 
+    /**
+     * The raw body of the file, including a BOM if present.
+     * @type {string|Uint8Array}
+     * @readonly
+     */
+    rawBody;
+
     /**
      * Indicates whether the file has a byte order mark (BOM).
      * @type {boolean}
@@ -104,8 +111,8 @@ class VFile {
         this.physicalPath = physicalPath ?? path;
         this.bom = hasUnicodeBOM(body);
         this.body = stripUnicodeBOM(body);
+        this.rawBody = body;
     }
-
 }
 
 module.exports = { VFile };

package/lib/rules/id-length.js

@@ -11,6 +11,7 @@
 //------------------------------------------------------------------------------
 
 const { getGraphemeCount } = require("../shared/string-utils");
+const { getModuleExportName } = require("./utils/ast-utils");
 
 //------------------------------------------------------------------------------
 // Rule Definition
@@ -116,6 +117,12 @@ module.exports = {
                 }
                 return properties && !parent.computed && parent.key.name === node.name;
             },
+            ImportSpecifier(parent, node) {
+                return (
+                    parent.local === node &&
+                    getModuleExportName(parent.imported) !== getModuleExportName(parent.local)
+                );
+            },
             ImportDefaultSpecifier: true,
             ImportNamespaceSpecifier: true,
             RestElement: true,

package/lib/rules/no-useless-constructor.js

@@ -4,6 +4,8 @@
  */
 "use strict";
 
+const astUtils = require("./utils/ast-utils");
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -143,10 +145,13 @@ module.exports = {
             url: "https://eslint.org/docs/latest/rules/no-useless-constructor"
         },
 
+        hasSuggestions: true,
+
         schema: [],
 
         messages: {
-            noUselessConstructor: "Useless constructor."
+            noUselessConstructor: "Useless constructor.",
+            removeConstructor: "Remove the constructor."
         }
     },
 
@@ -177,7 +182,18 @@ module.exports = {
             if (superClass ? isRedundantSuperCall(body, ctorParams) : (body.length === 0)) {
                 context.report({
                     node,
-                    messageId: "noUselessConstructor"
+                    messageId: "noUselessConstructor",
+                    suggest: [
+                        {
+                            messageId: "removeConstructor",
+                            *fix(fixer) {
+                                const nextToken = context.sourceCode.getTokenAfter(node);
+                                const addSemiColon = nextToken.type === "Punctuator" && nextToken.value === "[" && astUtils.needsPrecedingSemicolon(context.sourceCode, node);
+
+                                yield fixer.replaceText(node, addSemiColon ? ";" : "");
+                            }
+                        }
+                    ]
                 });
             }
         }

package/lib/services/processor-service.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview ESLint Processor Service
+ * @author Nicholas C. Zakas
+ */
+/* eslint class-methods-use-this: off -- Anticipate future constructor arguments. */
+
+"use strict";
+
+//-----------------------------------------------------------------------------
+// Requirements
+//-----------------------------------------------------------------------------
+
+const path = require("node:path");
+const { VFile } = require("../linter/vfile.js");
+
+//-----------------------------------------------------------------------------
+// Types
+//-----------------------------------------------------------------------------
+
+/** @typedef {import("../shared/types.js").LintMessage} LintMessage */
+/** @typedef {import("../linter/vfile.js").VFile} VFile */
+/** @typedef {import("@eslint/core").Language} Language */
+/** @typedef {import("@eslint/core").LanguageOptions} LanguageOptions */
+/** @typedef {import("eslint").Linter.Processor} Processor */
+
+//-----------------------------------------------------------------------------
+// Exports
+//-----------------------------------------------------------------------------
+
+/**
+ * The service that applies processors to files.
+ */
+class ProcessorService {
+
+    /**
+     * Preprocesses the given file synchronously.
+     * @param {VFile} file The file to preprocess.
+     * @param {{processor:Processor}} config The configuration to use.
+     * @returns {{ok:boolean, files?: Array<VFile>, errors?: Array<LintMessage>}} An array of preprocessed files or errors.
+     * @throws {Error} If the preprocessor returns a promise.
+     */
+    preprocessSync(file, config) {
+
+        const { processor } = config;
+        let blocks;
+
+        try {
+            blocks = processor.preprocess(file.rawBody, file.path);
+        } catch (ex) {
+
+            // If the message includes a leading line number, strip it:
+            const message = `Preprocessing error: ${ex.message.replace(/^line \d+:/iu, "").trim()}`;
+
+            return {
+                ok: false,
+                errors: [
+                    {
+                        ruleId: null,
+                        fatal: true,
+                        severity: 2,
+                        message,
+                        line: ex.lineNumber,
+                        column: ex.column,
+                        nodeType: null
+                    }
+                ]
+            };
+        }
+
+        if (typeof blocks.then === "function") {
+            throw new Error("Unsupported: Preprocessor returned a promise.");
+        }
+
+        return {
+            ok: true,
+            files: blocks.map((block, i) => {
+
+                // Legacy behavior: return the block as a string
+                if (typeof block === "string") {
+                    return block;
+                }
+
+                const filePath = path.join(file.path, `${i}_${block.filename}`);
+
+                return new VFile(filePath, block.text, {
+                    physicalPath: file.physicalPath
+                });
+            })
+        };
+
+    }
+
+    /**
+     * Postprocesses the given messages synchronously.
+     * @param {VFile} file The file to postprocess.
+     * @param {LintMessage[][]} messages The messages to postprocess.
+     * @param {{processor:Processor}} config The configuration to use.
+     * @returns {LintMessage[]} The postprocessed messages.
+     */
+    postprocessSync(file, messages, config) {
+
+        const { processor } = config;
+
+        return processor.postprocess(messages, file.path);
+    }
+
+}
+
+module.exports = { ProcessorService };

package/lib/shared/types.js

@@ -245,6 +245,6 @@ module.exports = {};
  * A formatter function.
  * @callback FormatterFunction
  * @param {LintResult[]} results The list of linting results.
- * @param {{cwd: string, maxWarningsExceeded?: MaxWarningsExceeded, rulesMeta: Record<string, RuleMeta>}} [context] A context object.
+ * @param {{cwd: string, maxWarningsExceeded?: MaxWarningsExceeded, rulesMeta: Record<string, RuleMeta>}} context A context object.
  * @returns {string | Promise<string>} Formatted text.
  */

package/lib/types/index.d.ts

@@ -26,6 +26,7 @@
  */
 
 import * as ESTree from "estree";
+import { Language } from "@eslint/core";
 import { JSONSchema4 } from "json-schema";
 import { LegacyESLint } from "./use-at-your-own-risk.js";
 
@@ -1265,6 +1266,13 @@ export namespace Linter {
          */
         ignores?: string[];
 
+        /**
+         * The name of the language used for linting. This is used to determine the
+         * parser and other language-specific settings.
+         * @since 9.7.0
+         */
+        language?: string;
+
         /**
          * An object containing settings related to how JavaScript is configured for
          * linting.
@@ -1411,7 +1419,7 @@ export class ESLint {
 
     isPathIgnored(filePath: string): Promise<boolean>;
 
-    loadFormatter(nameOrPath?: string): Promise<ESLint.Formatter>;
+    loadFormatter(nameOrPath?: string): Promise<ESLint.LoadedFormatter>;
 }
 
 export namespace ESLint {
@@ -1441,6 +1449,7 @@ export namespace ESLint {
     interface Plugin extends ObjectMetaProperties {
         configs?: Record<string, Linter.LegacyConfig | Linter.Config | Linter.Config[]> | undefined;
         environments?: Record<string, Environment> | undefined;
+        languages?: Record<string, Language> | undefined;
         processors?: Record<string, Linter.Processor> | undefined;
         rules?: Record<string, Rule.RuleModule> | undefined;
     }
@@ -1555,14 +1564,38 @@ export namespace ESLint {
         replacedBy: string[];
     }
 
-    interface Formatter {
-        format(results: LintResult[], data?: LintResultData): string | Promise<string>;
+    interface ResultsMeta {
+        maxWarningsExceeded?: MaxWarningsExceeded | undefined;
     }
 
+    /** The type of an object resolved by {@link ESLint.loadFormatter}. */
+    interface LoadedFormatter {
+
+        /**
+         * Used to call the underlying formatter.
+         * @param results An array of lint results to format.
+         * @param resultsMeta An object with an optional `maxWarningsExceeded` property that will be
+         * passed to the underlying formatter function along with other properties set by ESLint.
+         * This argument can be omitted if `maxWarningsExceeded` is not needed.
+         * @return The formatter output.
+         */
+        format(results: LintResult[], resultsMeta?: ResultsMeta): string | Promise<string>;
+    }
+
+    // The documented type name is `LoadedFormatter`, but `Formatter` has been historically more used.
+    type Formatter = LoadedFormatter;
+
+    /**
+     * The expected signature of a custom formatter.
+     * @param results An array of lint results to format.
+     * @param context Additional information for the formatter.
+     * @return The formatter output.
+     */
+    type FormatterFunction =
+    (results: LintResult[], context: LintResultData) => string | Promise<string>;
+
     // Docs reference the types by those name
     type EditInfo = Rule.Fix;
-    type LoadedFormatter = Formatter;
-    type ResultsMeta = LintResultData;
 }
 
 // #endregion

package/lib/types/rules/best-practices.d.ts

@@ -324,6 +324,8 @@ export interface BestPractices extends Linter.RulesRecord {
                     | "getters"
                     | "setters"
                     | "constructors"
+                    | "asyncFunctions"
+                    | "asyncMethods"
                 >;
             }>,
         ]
@@ -472,7 +474,7 @@ export interface BestPractices extends Linter.RulesRecord {
                 /**
                  * @default []
                  */
-                allow: Array<"~" | "!!" | "+" | "*">;
+                allow: Array<"~" | "!!" | "+" | "- -" | "-" | "*">;
             }>,
         ]
     >;
@@ -683,16 +685,22 @@ export interface BestPractices extends Linter.RulesRecord {
      */
     "no-param-reassign": Linter.RuleEntry<
         [
-            Partial<{
-                /**
-                 * @default false
-                 */
-                props: boolean;
-                /**
-                 * @default []
-                 */
-                ignorePropertyModificationsFor: string[];
-            }>,
+            | {
+                  props?: false;
+              }
+            | ({
+                  props: true;
+              } & Partial<{
+                  /**
+                   * @default []
+                   */
+                  ignorePropertyModificationsFor: string[];
+                  /**
+                   * @since 6.6.0
+                   * @default []
+                   */
+                  ignorePropertyModificationsForRegex: string[];
+              }>),
         ]
     >;
 
@@ -795,7 +803,17 @@ export interface BestPractices extends Linter.RulesRecord {
      * @since 0.5.1
      * @see https://eslint.org/docs/rules/no-sequences
      */
-    "no-sequences": Linter.RuleEntry<[]>;
+    "no-sequences": Linter.RuleEntry<
+        [
+            Partial<{
+                /**
+                 * @since 7.23.0
+                 * @default true
+                 */
+                allowInParentheses: boolean;
+            }>,
+        ]
+    >;
 
     /**
      * Rule to disallow throwing literals as exceptions.
@@ -834,6 +852,11 @@ export interface BestPractices extends Linter.RulesRecord {
                  * @default false
                  */
                 allowTaggedTemplates: boolean;
+                /**
+                 * @since 7.20.0
+                 * @default false
+                 */
+                enforceForJSX: boolean;
             }>,
         ]
     >;
@@ -966,7 +989,7 @@ export interface BestPractices extends Linter.RulesRecord {
     /**
      * Disallow use of `Object.prototype.hasOwnProperty.call()` and prefer use of `Object.hasOwn()`.
      *
-     * @since 3.5.0
+     * @since 8.5.0
      * @see https://eslint.org/docs/rules/prefer-object-has-own
      */
     "prefer-object-has-own": Linter.RuleEntry<[]>;

package/lib/types/rules/ecmascript-6.d.ts

@@ -231,6 +231,52 @@ export interface ECMAScript6 extends Linter.RulesRecord {
      */
     "no-new-symbol": Linter.RuleEntry<[]>;
 
+    /**
+     * Rule to disallow specified names in exports.
+     *
+     * @since 7.0.0-alpha.0
+     * @see https://eslint.org/docs/rules/no-restricted-exports
+     */
+    "no-restricted-exports": Linter.RuleEntry<
+        [
+            Partial<{
+                /**
+                 * @default []
+                 */
+                restrictedNamedExports: string[];
+                /**
+                 * @since 9.3.0
+                 */
+                restrictedNamedExportsPattern: string;
+                /**
+                 * @since 8.33.0
+                 */
+                restrictDefaultExports: Partial<{
+                    /**
+                     * @default false
+                     */
+                    direct: boolean;
+                    /**
+                     * @default false
+                     */
+                    named: boolean;
+                    /**
+                     * @default false
+                     */
+                    defaultFrom: boolean;
+                    /**
+                     * @default false
+                     */
+                    namedFrom: boolean;
+                    /**
+                     * @default false
+                     */
+                    namespaceFrom: boolean;
+                }>;
+            }>,
+        ]
+    >;
+
     /**
      * Rule to disallow specified modules when loaded by `import`.
      *
@@ -340,6 +386,10 @@ export interface ECMAScript6 extends Linter.RulesRecord {
                      * @default false
                      */
                     ignoreConstructors: boolean;
+                    /**
+                     * @since 8.22.0
+                     */
+                    methodsIgnorePattern: string;
                     /**
                      * @default false
                      */

package/lib/types/rules/possible-errors.d.ts

@@ -251,7 +251,30 @@ export interface PossibleErrors extends Linter.RulesRecord {
      * @since 0.4.0
      * @see https://eslint.org/docs/rules/no-extra-boolean-cast
      */
-    "no-extra-boolean-cast": Linter.RuleEntry<[]>;
+    "no-extra-boolean-cast": Linter.RuleEntry<
+        [
+            | Partial<{
+                  /**
+                   * @since 9.3.0
+                   * @default false
+                   */
+                  enforceForInnerExpressions: boolean;
+                  /**
+                   * @deprecated
+                   */
+                  enforceForLogicalOperands: never;
+              }>
+            | Partial<{
+                  /**
+                   * @deprecated
+                   * @since 7.0.0-alpha.2
+                   * @default false
+                   */
+                  enforceForLogicalOperands: boolean;
+                  enforceForInnerExpressions: never;
+              }>,
+        ]
+    >;
 
     /**
      * Rule to disallow unnecessary parentheses.
@@ -391,7 +414,17 @@ export interface PossibleErrors extends Linter.RulesRecord {
      * @since 5.3.0
      * @see https://eslint.org/docs/rules/no-misleading-character-class
      */
-    "no-misleading-character-class": Linter.RuleEntry<[]>;
+    "no-misleading-character-class": Linter.RuleEntry<
+        [
+            Partial<{
+                /**
+                 * @since 9.3.0
+                 * @default false
+                 */
+                allowEscape: boolean;
+            }>,
+        ]
+    >;
 
     /**
      * Rule to disallow calling global object properties as functions.
@@ -519,7 +552,17 @@ export interface PossibleErrors extends Linter.RulesRecord {
      * @since 3.3.0
      * @see https://eslint.org/docs/rules/no-unsafe-negation
      */
-    "no-unsafe-negation": Linter.RuleEntry<[]>;
+    "no-unsafe-negation": Linter.RuleEntry<
+        [
+            Partial<{
+                /**
+                 * @since 6.6.0
+                 * @default false
+                 */
+                enforceForOrderingRelations: boolean;
+            }>,
+        ]
+    >;
 
     /**
      * Disallow use of optional chaining in contexts where the `undefined` value is not allowed.
@@ -550,7 +593,17 @@ export interface PossibleErrors extends Linter.RulesRecord {
      * @since 5.3.0
      * @see https://eslint.org/docs/rules/require-atomic-updates
      */
-    "require-atomic-updates": Linter.RuleEntry<[]>;
+    "require-atomic-updates": Linter.RuleEntry<
+        [
+            Partial<{
+                /**
+                 * @since 8.3.0
+                 * @default false
+                 */
+                allowProperties: boolean;
+            }>,
+        ]
+    >;
 
     /**
      * Rule to require calls to `isNaN()` when checking for `NaN`.

package/lib/types/rules/stylistic-issues.d.ts

@@ -165,6 +165,16 @@ export interface StylisticIssues extends Linter.RulesRecord {
                  * @default false
                  */
                 ignoreDestructuring: boolean;
+                /**
+                 * @since 6.7.0
+                 * @default false
+                 */
+                ignoreImports: boolean;
+                /**
+                 * @since 7.4.0
+                 * @default false
+                 */
+                ignoreGlobals: boolean;
                 /**
                  * @remarks
                  * Also accept for regular expression patterns
@@ -1375,10 +1385,35 @@ export interface StylisticIssues extends Linter.RulesRecord {
                  * @default false
                  */
                 allowAfterSuper: boolean;
+                /**
+                 * @since 6.7.0
+                 * @default false
+                 */
+                allowAfterThisConstructor: boolean;
                 /**
                  * @default false
                  */
                 enforceInMethodNames: boolean;
+                /**
+                 * @since 8.15.0
+                 * @default false
+                 */
+                enforceInClassFields: boolean;
+                /**
+                 * @since 8.31.0
+                 * @default true
+                 */
+                allowInArrayDestructuring: boolean;
+                /**
+                 * @since 8.31.0
+                 * @default true
+                 */
+                allowInObjectDestructuring: boolean;
+                /**
+                 * @since 7.7.0
+                 * @default true
+                 */
+                allowFunctionParams: boolean;
             }>,
         ]
     >;

package/lib/types/rules/variables.d.ts

@@ -100,6 +100,11 @@ export interface Variables extends Linter.RulesRecord {
                  */
                 hoist: "functions" | "all" | "never";
                 allow: string[];
+                /**
+                 * @since 8.10.0
+                 * @default false
+                 */
+                ignoreOnInitialization: boolean;
             }>,
         ]
     >;

package/lib/types/universal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview typings for "eslint/universal" module
+ * @author 唯然<weiran.zsd@outlook.com>
+ */
+
+export { Linter } from "./index";

package/lib/universal.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview exports for browsers
+ * @author 唯然<weiran.zsd@outlook.com>
+ */
+
+"use strict";
+
+const { Linter } = require("./linter/linter");
+
+module.exports = { Linter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "9.10.0",
+  "version": "9.11.1",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "bin": {
@@ -20,6 +20,10 @@
     },
     "./rules": {
       "types": "./lib/types/rules/index.d.ts"
+    },
+    "./universal": {
+      "types": "./lib/types/universal.d.ts",
+      "default": "./lib/universal.js"
     }
   },
   "scripts": {
@@ -36,7 +40,8 @@
     "lint:fix:docs:js": "trunk check -y --ignore=** --ignore=!docs/**/*.js -a --flter=eslint && trunk check -y --ignore=** --ignore=!docs/**/*.js",
     "release:generate:alpha": "node Makefile.js generatePrerelease -- alpha",
     "release:generate:beta": "node Makefile.js generatePrerelease -- beta",
-    "release:generate:latest": "node Makefile.js generateRelease",
+    "release:generate:latest": "node Makefile.js generateRelease -- latest",
+    "release:generate:maintenance": "node Makefile.js generateRelease -- maintenance",
     "release:generate:rc": "node Makefile.js generatePrerelease -- rc",
     "release:publish": "node Makefile.js publishRelease",
     "test": "node Makefile.js test",
@@ -80,12 +85,15 @@
     "@eslint-community/eslint-utils": "^4.2.0",
     "@eslint-community/regexpp": "^4.11.0",
     "@eslint/config-array": "^0.18.0",
+    "@eslint/core": "^0.6.0",
     "@eslint/eslintrc": "^3.1.0",
-    "@eslint/js": "9.10.0",
-    "@eslint/plugin-kit": "^0.1.0",
+    "@eslint/js": "9.11.1",
+    "@eslint/plugin-kit": "^0.2.0",
     "@humanwhocodes/module-importer": "^1.0.1",
     "@humanwhocodes/retry": "^0.3.0",
     "@nodelib/fs.walk": "^1.2.8",
+    "@types/estree": "^1.0.6",
+    "@types/json-schema": "^7.0.15",
     "ajv": "^6.12.4",
     "chalk": "^4.0.0",
     "cross-spawn": "^7.0.2",
@@ -115,12 +123,10 @@
   "devDependencies": {
     "@babel/core": "^7.4.3",
     "@babel/preset-env": "^7.4.3",
-    "@eslint/core": "^0.5.0",
     "@eslint/json": "^0.4.0",
     "@trunkio/launcher": "^1.3.0",
-    "@types/estree": "^1.0.5",
-    "@types/json-schema": "^7.0.15",
     "@types/node": "^20.11.5",
+    "@typescript-eslint/parser": "^8.4.0",
     "@wdio/browser-runner": "^9.0.5",
     "@wdio/cli": "^9.0.5",
     "@wdio/concise-reporter": "^9.0.4",
@@ -135,8 +141,9 @@
     "eslint": "file:.",
     "eslint-config-eslint": "file:packages/eslint-config-eslint",
     "eslint-plugin-eslint-plugin": "^6.0.0",
+    "eslint-plugin-expect-type": "^0.4.0",
     "eslint-plugin-yml": "^1.14.0",
-    "eslint-release": "^3.2.2",
+    "eslint-release": "^3.3.0",
     "eslint-rule-composer": "^0.3.0",
     "eslump": "^3.0.0",
     "esprima": "^4.0.1",