eslint 9.20.1 → 9.22.0

package/lib/rules/quotes.js

@@ -78,8 +78,26 @@ const AVOID_ESCAPE = "avoid-escape";
 /** @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: "quotes",
+                        url: "https://eslint.style/rules/js/quotes"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

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

@@ -13,8 +13,26 @@
 /** @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: "rest-spread-spacing",
+                        url: "https://eslint.style/rules/js/rest-spread-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/semi-spacing.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: "semi-spacing",
+                        url: "https://eslint.style/rules/js/semi-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/semi-style.js

@@ -71,8 +71,26 @@ function isLastChild(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: "semi-style",
+                        url: "https://eslint.style/rules/js/semi-style"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/semi.js

@@ -19,8 +19,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: "semi",
+                        url: "https://eslint.style/rules/js/semi"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

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

@@ -38,8 +38,26 @@ function isFunctionBody(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: "space-before-blocks",
+                        url: "https://eslint.style/rules/js/space-before-blocks"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/space-before-function-paren.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: "space-before-function-paren",
+                        url: "https://eslint.style/rules/js/space-before-function-paren"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/space-in-parens.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: "space-in-parens",
+                        url: "https://eslint.style/rules/js/space-in-parens"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

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

@@ -14,8 +14,26 @@ const { isEqToken } = 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: "space-infix-ops",
+                        url: "https://eslint.style/rules/js/space-infix-ops"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/space-unary-ops.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: "space-unary-ops",
+                        url: "https://eslint.style/rules/js/space-unary-ops"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/spaced-comment.js

@@ -150,8 +150,26 @@ function createNeverStylePattern(markers) {
 /** @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: "spaced-comment",
+                        url: "https://eslint.style/rules/js/spaced-comment"
+                    }
+                }
+            ]
+        },
         type: "suggestion",
 
         docs: {

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

@@ -19,8 +19,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: "switch-colon-spacing",
+                        url: "https://eslint.style/rules/js/switch-colon-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

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

@@ -19,8 +19,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: "template-curly-spacing",
+                        url: "https://eslint.style/rules/js/template-curly-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

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

@@ -13,8 +13,26 @@
 /** @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: "template-tag-spacing",
+                        url: "https://eslint.style/rules/js/template-tag-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/wrap-iife.js

@@ -41,8 +41,26 @@ function isCalleeOfNewExpression(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: "wrap-iife",
+                        url: "https://eslint.style/rules/js/wrap-iife"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/rules/wrap-regex.js

@@ -13,8 +13,26 @@
 /** @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: "wrap-regex",
+                        url: "https://eslint.style/rules/js/wrap-regex"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

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

@@ -13,8 +13,26 @@
 /** @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: "yield-star-spacing",
+                        url: "https://eslint.style/rules/js/yield-star-spacing"
+                    }
+                }
+            ]
+        },
         type: "layout",
 
         docs: {

package/lib/shared/types.js

@@ -145,9 +145,26 @@ module.exports = {};
  * @property {string} url The URL of the rule documentation.
  */
 
+/**
+ * @typedef {Object} DeprecatedInfo
+ * @property {string} [message] General message presented to the user
+ * @property {string} [url] URL to more information about this deprecation in general
+ * @property {ReplacedByInfo[]} [replacedBy] Potential replacements for the rule
+ * @property {string} [deprecatedSince] Version since the rule is deprecated
+ * @property {?string} [availableUntil] Version until it is available or null if indefinite
+ */
+
+/**
+ * @typedef {Object} ReplacedByInfo
+ * @property {string} [message] General message presented to the user
+ * @property {string} [url] URL to more information about this replacement in general
+ * @property {{ name?: string, url?: string }} [plugin] Use "eslint" for a core rule. Omit if the rule is in the same plugin.
+ * @property {{ name?: string, url?: string }} [rule] Name and information of the replacement rule
+ */
+
 /**
  * @typedef {Object} RuleMeta
- * @property {boolean} [deprecated] If `true` then the rule has been deprecated.
+ * @property {boolean|DeprecatedInfo} [deprecated] If `true` then the rule has been deprecated.
  * @property {Array} [defaultOptions] Default options for the rule.
  * @property {RuleMetaDocs} docs The document information of the rule.
  * @property {"code"|"whitespace"} [fixable] The autofix type.
@@ -177,6 +194,7 @@ module.exports = {};
  * @typedef {Object} DeprecatedRuleInfo
  * @property {string} ruleId The rule ID.
  * @property {string[]} replacedBy The rule IDs that replace this deprecated rule.
+ * @property {DeprecatedInfo} [info] The raw deprecated info provided by rule. Unset if `deprecated` is a boolean.
  */
 
 /**

package/lib/types/config-api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview typings for "eslint/config" module
+ * @author Nicholas C. Zakas
+ */
+
+import { defineConfig, globalIgnores } from "@eslint/config-helpers";
+
+export { defineConfig, globalIgnores };

package/lib/types/index.d.ts

@@ -35,7 +35,8 @@ import type {
     LanguageOptions as GenericLanguageOptions,
     RuleDefinition,
     RuleContext as CoreRuleContext,
-    RuleContextTypeOptions
+    RuleContextTypeOptions,
+    DeprecatedInfo
 } from "@eslint/core";
 import { JSONSchema4 } from "json-schema";
 import { LegacyESLint } from "./use-at-your-own-risk.js";
@@ -780,9 +781,12 @@ export namespace Rule {
         /** Any default options to be recursively merged on top of any user-provided options. */
         defaultOptions?: unknown[];
 
-        /** Indicates whether the rule has been deprecated. Omit if not deprecated. */
-        deprecated?: boolean | undefined;
-        /** The name of the rule(s) this rule was replaced by, if it was deprecated. */
+        /** Indicates whether the rule has been deprecated or provides additional metadata about the deprecation. Omit if not deprecated. */
+        deprecated?: boolean | DeprecatedInfo | undefined;
+        /**
+         * @deprecated Use deprecated.replacedBy instead.
+         * The name of the rule(s) this rule was replaced by, if it was deprecated.
+         */
         replacedBy?: readonly string[];
 
         /**