feat: add meta object to @eslint/js plugin (#19095)

packages/js/README.md

@@ -28,12 +28,14 @@ export default [
 
     // apply recommended rules to JS files
     {
+        name: "your-project/recommended-rules",
         files: ["**/*.js"],
         rules: js.configs.recommended.rules
     },
 
     // apply recommended rules to JS files with an override
     {
+        name: "your-project/recommended-rules-with-override",
         files: ["**/*.js"],
         rules: {
             ...js.configs.recommended.rules,
@@ -43,6 +45,7 @@ export default [
 
     // apply all rules to JS files
     {
+        name: "your-project/all-rules",
         files: ["**/*.js"],
         rules: {
             ...js.configs.all.rules,

packages/js/src/index.js

@@ -5,11 +5,17 @@
 
 "use strict";
 
+const { version } = require("../package.json");
+
 //------------------------------------------------------------------------------
 // Public Interface
 //------------------------------------------------------------------------------
 
 module.exports = {
+    meta: {
+        name: "@eslint/js",
+        version
+    },
     configs: {
         all: require("./configs/eslint-all"),
         recommended: require("./configs/eslint-recommended")

packages/js/tests/types/types.test.ts

@@ -25,9 +25,13 @@
  * SOFTWARE
  */
 
-import type { Linter } from "eslint";
+import type { ESLint, Linter } from "eslint";
 import js from "../../";
 
+js satisfies ESLint.Plugin;
+js.meta.name satisfies string;
+js.meta.version satisfies string;
+
 let config: Linter.Config[];
 
 config = [js.configs.recommended];

packages/js/types/index.d.ts

@@ -1,6 +1,10 @@
 import type { Linter } from "eslint";
 
 declare const js: {
+    readonly meta: {
+        readonly name: string;
+        readonly version: string;
+    },
     readonly configs: {
         readonly recommended: { readonly rules: Readonly<Linter.RulesRecord> };
         readonly all: { readonly rules: Readonly<Linter.RulesRecord> };