eslint 9.20.1 → 9.21.0

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/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[];
 
         /**

package/messages/config-plugin-missing.js

@@ -0,0 +1,14 @@
+"use strict";
+
+module.exports = function(it) {
+    const { pluginName, ruleId } = it;
+
+    return `
+A configuration object specifies rule "${ruleId}", but could not find plugin "${pluginName}".
+
+Common causes of this problem include:
+
+1. The "${pluginName}" plugin is not defined in your configuration file.
+2. The "${pluginName}" plugin is not defined within the same configuration object in which the "${ruleId}" rule is applied.
+`.trimStart();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "9.20.1",
+  "version": "9.21.0",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "type": "commonjs",
@@ -101,14 +101,14 @@
   "dependencies": {
     "@eslint-community/eslint-utils": "^4.2.0",
     "@eslint-community/regexpp": "^4.12.1",
-    "@eslint/config-array": "^0.19.0",
-    "@eslint/core": "^0.11.0",
-    "@eslint/eslintrc": "^3.2.0",
-    "@eslint/js": "9.20.0",
-    "@eslint/plugin-kit": "^0.2.5",
+    "@eslint/config-array": "^0.19.2",
+    "@eslint/core": "^0.12.0",
+    "@eslint/eslintrc": "^3.3.0",
+    "@eslint/js": "9.21.0",
+    "@eslint/plugin-kit": "^0.2.7",
     "@humanfs/node": "^0.16.6",
     "@humanwhocodes/module-importer": "^1.0.1",
-    "@humanwhocodes/retry": "^0.4.1",
+    "@humanwhocodes/retry": "^0.4.2",
     "@types/estree": "^1.0.6",
     "@types/json-schema": "^7.0.15",
     "ajv": "^6.12.4",