eslint 9.20.1 → 9.22.0

package/README.md

@@ -72,7 +72,9 @@ This ensures that pnpm installs dependencies in a way that is more compatible wi
 You can configure rules in your `eslint.config.js` files as in this example:
 
 ```js
-export default [
+import { defineConfig } from "eslint/config";
+
+export default defineConfig([
     {
         files: ["**/*.js", "**/*.cjs", "**/*.mjs"],
         rules: {
@@ -80,7 +82,7 @@ export default [
             "no-constant-binary-expression": "error"
         }
     }
-];
+]);
 ```
 
 The names `"prefer-const"` and `"no-constant-binary-expression"` are the names of [rules](https://eslint.org/docs/rules) in ESLint. The first value is the error level of the rule and can be one of these values:
@@ -318,9 +320,9 @@ 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></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://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" alt="American Express" 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></p>
+<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://vite.dev/"><img src="https://images.opencollective.com/vite/e6d15e1/logo.png" alt="Vite" height="64"></a> <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://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>
 Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.
 <p><a href="https://netlify.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/netlify-icon.svg" alt="Netlify" height="32"></a> <a href="https://algolia.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/algolia-icon.svg" alt="Algolia" height="32"></a> <a href="https://1password.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/1password-icon.svg" alt="1Password" height="32"></a></p>

package/conf/rule-type-list.json

@@ -6,24 +6,88 @@
     },
     "deprecated": [],
     "removed": [
-        { "removed": "generator-star", "replacedBy": ["generator-star-spacing"] },
-        { "removed": "global-strict", "replacedBy": ["strict"] },
-        { "removed": "no-arrow-condition", "replacedBy": ["no-confusing-arrow", "no-constant-condition"] },
-        { "removed": "no-comma-dangle", "replacedBy": ["comma-dangle"] },
-        { "removed": "no-empty-class", "replacedBy": ["no-empty-character-class"] },
-        { "removed": "no-empty-label", "replacedBy": ["no-labels"] },
-        { "removed": "no-extra-strict", "replacedBy": ["strict"] },
-        { "removed": "no-reserved-keys", "replacedBy": ["quote-props"] },
-        { "removed": "no-space-before-semi", "replacedBy": ["semi-spacing"] },
-        { "removed": "no-wrap-func", "replacedBy": ["no-extra-parens"] },
-        { "removed": "space-after-function-name", "replacedBy": ["space-before-function-paren"] },
-        { "removed": "space-after-keywords", "replacedBy": ["keyword-spacing"] },
-        { "removed": "space-before-function-parentheses", "replacedBy": ["space-before-function-paren"] },
-        { "removed": "space-before-keywords", "replacedBy": ["keyword-spacing"] },
-        { "removed": "space-in-brackets", "replacedBy": ["object-curly-spacing", "array-bracket-spacing"] },
-        { "removed": "space-return-throw-case", "replacedBy": ["keyword-spacing"] },
-        { "removed": "space-unary-word-ops", "replacedBy": ["space-unary-ops"] },
-        { "removed": "spaced-line-comment", "replacedBy": ["spaced-comment"] },
+        {
+            "removed": "generator-star",
+            "replacedBy": [{ "rule": { "name": "generator-star-spacing" } }]
+        },
+        {
+            "removed": "global-strict",
+            "replacedBy": [{ "rule": { "name": "strict" } }]
+        },
+        {
+            "removed": "no-arrow-condition",
+            "replacedBy": [
+                { "rule": { "name": "no-confusing-arrow" } },
+                { "rule": { "name": "no-constant-condition" } }
+            ]
+        },
+        {
+            "removed": "no-comma-dangle",
+            "replacedBy": [{ "rule": { "name": "comma-dangle" } }]
+        },
+        {
+            "removed": "no-empty-class",
+            "replacedBy": [{ "rule": { "name": "no-empty-character-class" } }]
+        },
+        {
+            "removed": "no-empty-label",
+            "replacedBy": [{ "rule": { "name": "no-labels" } }]
+        },
+        {
+            "removed": "no-extra-strict",
+            "replacedBy": [{ "rule": { "name": "strict" } }]
+        },
+        {
+            "removed": "no-reserved-keys",
+            "replacedBy": [{ "rule": { "name": "quote-props" } }]
+        },
+        {
+            "removed": "no-space-before-semi",
+            "replacedBy": [{ "rule": { "name": "semi-spacing" } }]
+        },
+        {
+            "removed": "no-wrap-func",
+            "replacedBy": [{ "rule": { "name": "no-extra-parens" } }]
+        },
+        {
+            "removed": "space-after-function-name",
+            "replacedBy": [
+                { "rule": { "name": "space-before-function-paren" } }
+            ]
+        },
+        {
+            "removed": "space-after-keywords",
+            "replacedBy": [{ "rule": { "name": "keyword-spacing" } }]
+        },
+        {
+            "removed": "space-before-function-parentheses",
+            "replacedBy": [
+                { "rule": { "name": "space-before-function-paren" } }
+            ]
+        },
+        {
+            "removed": "space-before-keywords",
+            "replacedBy": [{ "rule": { "name": "keyword-spacing" } }]
+        },
+        {
+            "removed": "space-in-brackets",
+            "replacedBy": [
+                { "rule": { "name": "object-curly-spacing" } },
+                { "rule": { "name": "array-bracket-spacing" } }
+            ]
+        },
+        {
+            "removed": "space-return-throw-case",
+            "replacedBy": [{ "rule": { "name": "keyword-spacing" } }]
+        },
+        {
+            "removed": "space-unary-word-ops",
+            "replacedBy": [{ "rule": { "name": "space-unary-ops" } }]
+        },
+        {
+            "removed": "spaced-line-comment",
+            "replacedBy": [{ "rule": { "name": "spaced-comment" } }]
+        },
         { "removed": "valid-jsdoc", "replacedBy": [] },
         { "removed": "require-jsdoc", "replacedBy": [] }
     ]

package/lib/cli.js

@@ -192,6 +192,12 @@ async function translateOptions({
             overrideConfig[0].plugins = await loadPlugins(importer, plugin);
         }
 
+        if (ext) {
+            overrideConfig.push({
+                files: ext.map(extension => `**/*${extension.startsWith(".") ? "" : "."}${extension}`)
+            });
+        }
+
     } else {
         overrideConfigFile = config;
 
@@ -489,6 +495,23 @@ const cli = {
             return 2;
         }
 
+        if (usingFlatConfig && options.ext) {
+
+            // Passing `--ext ""` results in `options.ext` being an empty array.
+            if (options.ext.length === 0) {
+                log.error("The --ext option value cannot be empty.");
+                return 2;
+            }
+
+            // Passing `--ext ,ts` results in an empty string at index 0. Passing `--ext ts,,tsx` results in an empty string at index 1.
+            const emptyStringIndex = options.ext.indexOf("");
+
+            if (emptyStringIndex >= 0) {
+                log.error(`The --ext option arguments cannot be empty strings. Found an empty string at index ${emptyStringIndex}.`);
+                return 2;
+            }
+        }
+
         const ActiveESLint = usingFlatConfig ? ESLint : LegacyESLint;
         const eslintOptions = await translateOptions(options, usingFlatConfig ? "flat" : "eslintrc");
         const engine = new ActiveESLint(eslintOptions);

package/lib/config/rule-validator.js

@@ -36,7 +36,10 @@ function throwRuleNotFoundError({ pluginName, ruleName }, config) {
     const ruleId = pluginName === "@" ? ruleName : `${pluginName}/${ruleName}`;
 
     const errorMessageHeader = `Key "rules": Key "${ruleId}"`;
-    let errorMessage = `${errorMessageHeader}: Could not find plugin "${pluginName}".`;
+
+    let errorMessage = `${errorMessageHeader}: Could not find plugin "${pluginName}" in configuration.`;
+
+    const missingPluginErrorMessage = errorMessage;
 
     // if the plugin exists then we need to check if the rule exists
     if (config.plugins && config.plugins[pluginName]) {
@@ -63,7 +66,14 @@ function throwRuleNotFoundError({ pluginName, ruleName }, config) {
         // falls through to throw error
     }
 
-    throw new TypeError(errorMessage);
+    const error = new TypeError(errorMessage);
+
+    if (errorMessage === missingPluginErrorMessage) {
+        error.messageTemplate = "config-plugin-missing";
+        error.messageData = { pluginName, ruleId };
+    }
+
+    throw error;
 }
 
 /**

package/lib/config-api.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview exports for config helpers
+ * @author Nicholas C. Zakas
+ */
+
+"use strict";
+const { defineConfig, globalIgnores } = require("@eslint/config-helpers");
+
+module.exports = {
+    defineConfig,
+    globalIgnores
+};

package/lib/eslint/eslint.js

@@ -203,7 +203,13 @@ function getOrFindUsedDeprecatedRules(eslint, maybeFilePath) {
                 const meta = rule && rule.meta;
 
                 if (meta && meta.deprecated) {
-                    retv.push({ ruleId, replacedBy: meta.replacedBy || [] });
+                    const usesNewFormat = typeof meta.deprecated === "object";
+
+                    retv.push({
+                        ruleId,
+                        replacedBy: usesNewFormat ? meta.deprecated.replacedBy?.map(replacement => `${replacement.plugin?.name !== void 0 ? `${naming.getShorthandName(replacement.plugin.name, "eslint-plugin")}/` : ""}${replacement.rule?.name ?? ""}`) ?? [] : meta.replacedBy || [],
+                        info: usesNewFormat ? meta.deprecated : void 0
+                    });
                 }
             }
         }

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

@@ -58,20 +58,24 @@ const CODE_PATH_EVENTS = [
  * @private
  */
 function validate(ast) {
+    if (!ast) {
+        throw new TypeError(`Unexpected empty AST. (${ast})`);
+    }
+
     if (!ast.tokens) {
-        throw new Error("AST is missing the tokens array.");
+        throw new TypeError("AST is missing the tokens array.");
     }
 
     if (!ast.comments) {
-        throw new Error("AST is missing the comments array.");
+        throw new TypeError("AST is missing the comments array.");
     }
 
     if (!ast.loc) {
-        throw new Error("AST is missing location information.");
+        throw new TypeError("AST is missing location information.");
     }
 
     if (!ast.range) {
-        throw new Error("AST is missing range information");
+        throw new TypeError("AST is missing range information");
     }
 }
 
@@ -204,16 +208,16 @@ function isSpaceBetween(sourceCode, first, second, checkInsideOfJSXText) {
         if (
             currentToken.range[1] !== nextToken.range[0] ||
 
-                /*
-                 * For backward compatibility, check spaces in JSXText.
-                 * https://github.com/eslint/eslint/issues/12614
-                 */
-                (
-                    checkInsideOfJSXText &&
-                    nextToken !== finalToken &&
-                    nextToken.type === "JSXText" &&
-                    /\s/u.test(nextToken.value)
-                )
+            /*
+             * For backward compatibility, check spaces in JSXText.
+             * https://github.com/eslint/eslint/issues/12614
+             */
+            (
+                checkInsideOfJSXText &&
+                nextToken !== finalToken &&
+                nextToken.type === "JSXText" &&
+                /\s/u.test(nextToken.value)
+            )
         ) {
             return true;
         }

package/lib/options.js

@@ -123,6 +123,12 @@ module.exports = function(usingFlatConfig) {
             type: "[String]",
             description: "Specify JavaScript file extensions"
         };
+    } else {
+        extFlag = {
+            option: "ext",
+            type: "[String]",
+            description: "Specify additional file extensions to lint"
+        };
     }
 
     let resolvePluginsFlag;

package/lib/rules/array-bracket-newline.js

@@ -15,8 +15,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "array-bracket-newline",
+                        url: "https://eslint.style/rules/js/array-bracket-newline"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/array-bracket-spacing.js

@@ -14,8 +14,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "array-bracket-spacing",
+                        url: "https://eslint.style/rules/js/array-bracket-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/array-element-newline.js

@@ -15,8 +15,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "array-element-newline",
+                        url: "https://eslint.style/rules/js/array-element-newline"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/arrow-parens.js

@@ -31,8 +31,26 @@ function hasBlockBody(node) {
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "arrow-parens",
+                        url: "https://eslint.style/rules/js/arrow-parens"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/arrow-spacing.js

@@ -18,8 +18,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "arrow-spacing",
+                        url: "https://eslint.style/rules/js/arrow-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/block-spacing.js

@@ -15,8 +15,26 @@ const util = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "block-spacing",
+                        url: "https://eslint.style/rules/js/block-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/brace-style.js

@@ -15,8 +15,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "brace-style",
+                        url: "https://eslint.style/rules/js/brace-style"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/callback-return.js

@@ -12,9 +12,25 @@
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-
-        replacedBy: [],
+        deprecated: {
+            message: "Node.js rules were moved out of ESLint core.",
+            url: "https://eslint.org/docs/latest/use/migrating-to-7.0.0#deprecate-node-rules",
+            deprecatedSince: "7.0.0",
+            availableUntil: null,
+            replacedBy: [
+                {
+                    message: "eslint-plugin-n now maintains deprecated Node.js-related rules.",
+                    plugin: {
+                        name: "eslint-plugin-n",
+                        url: "https://github.com/eslint-community/eslint-plugin-n"
+                    },
+                    rule: {
+                        name: "callback-return",
+                        url: "https://github.com/eslint-community/eslint-plugin-n/tree/master/docs/rules/callback-return.md"
+                    }
+                }
+            ]
+        },
 
         type: "suggestion",
 

package/lib/rules/comma-dangle.js

@@ -74,8 +74,26 @@ function normalizeOptions(optionValue, ecmaVersion) {
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "comma-dangle",
+                        url: "https://eslint.style/rules/js/comma-dangle"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/comma-spacing.js

@@ -14,8 +14,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "comma-spacing",
+                        url: "https://eslint.style/rules/js/comma-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/comma-style.js

@@ -15,8 +15,26 @@ const astUtils = require("./utils/ast-utils");
 /** @type {import('../shared/types').Rule} */
 module.exports = {
     meta: {
-        deprecated: true,
-        replacedBy: [],
+        deprecated: {
+            message: "Formatting rules are being moved out of ESLint core.",
+            url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
+            deprecatedSince: "8.53.0",
+            availableUntil: "10.0.0",
+            replacedBy: [
+                {
+                    message: "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"
+                    },
+                    rule: {
+                        name: "comma-style",
+                        url: "https://eslint.style/rules/js/comma-style"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {