@eslint-react/kit 4.0.1-beta.1 → 4.0.2-beta.0

package/README.md

@@ -10,6 +10,8 @@ ESLint React's toolkit for building custom React lint rules right inside your `e
   - [`eslintReactKit` (default export)](#eslintreactkit-default-export)
   - [`RuleDefinition`](#ruledefinition)
   - [`Builder`](#builder)
+    - [`getConfig`](#getconfig)
+    - [`getPlugin`](#getplugin)
   - [`merge`](#merge)
   - [`Kit` — the toolkit object](#kit--the-toolkit-object)
     - [`kit.collect`](#kitcollect) — Semantic collectors
@@ -22,6 +24,7 @@ ESLint React's toolkit for building custom React lint rules right inside your `e
   - [Component: Destructure component props](#component-destructure-component-props)
   - [Hooks: Warn on custom hooks that don't call other hooks](#hooks-warn-on-custom-hooks-that-dont-call-other-hooks)
   - [Multiple Collectors: No component/hook factories](#multiple-collectors-no-componenthook-factories)
+  - [Advanced Config: Using `getPlugin` for custom plugin namespace](#advanced-config-using-getplugin-for-custom-plugin-namespace)
 - [More Examples](#more-examples)
 
 ## Installation
@@ -120,7 +123,8 @@ function forbidElements({ forbidden }: ForbidElementsOptions): RuleDefinition {
 ```ts
 interface Builder {
   use<F extends (...args: any[]) => RuleDefinition>(factory: F, ...args: Parameters<F>): Builder;
-  getConfig(): Linter.Config;
+  getConfig(args?: { files?: string[] }): Linter.Config;
+  getPlugin(): ESLint.Plugin;
 }
 ```
 
@@ -130,6 +134,11 @@ A chainable builder for registering custom rules.
 | ----------- | -------------------------------------------------------------------------------------------------------------------------- |
 | `use`       | Registers a rule factory. The rule name is `kebabCase(factory.name)`. Options type is inferred from the factory signature. |
 | `getConfig` | Returns a `Linter.Config` with all registered rules enabled at `"error"` severity.                                         |
+| `getPlugin` | Returns an `ESLint.Plugin` containing the registered rules and plugin metadata.                                            |
+
+#### `getConfig`
+
+Returns a flat `Linter.Config` object with all registered rules set to `"error"`. This is a convenience wrapper that calls `getPlugin()` internally and adds the plugin plus rule entries to the config.
 
 ```ts
 eslintReactKit()
@@ -138,6 +147,34 @@ eslintReactKit()
   .getConfig();
 ```
 
+#### `getPlugin`
+
+Returns an `ESLint.Plugin` object containing the registered rules and plugin metadata (`name` and `version`). Use this when you need finer-grained control over how the plugin is integrated into your ESLint configuration — for example, when you want to choose the plugin namespace, set per-rule severities, or compose the plugin with other configs manually.
+
+```ts
+const kit = eslintReactKit()
+  .use(noForwardRef)
+  .use(forbidElements, { forbidden: new Map() });
+
+// Retrieve the raw plugin object
+const plugin = kit.getPlugin();
+// => { meta: { name: "@eslint-react/kit", version: "..." }, rules: { "no-forward-ref": ..., "forbid-elements": ... } }
+
+// Use it in a custom flat config with your own namespace and severity
+export default [
+  {
+    files: ["**/*.{ts,tsx}"],
+    plugins: {
+      "react-custom-rules": plugin,
+    },
+    rules: {
+      "react-custom-rules/no-forward-ref": "error",
+      "react-custom-rules/forbid-elements": "warn",
+    },
+  },
+];
+```
+
 ### `merge`
 
 ```ts
@@ -486,6 +523,60 @@ eslintReactKit()
   .getConfig();
 ```
 
-## More Examples
+### Advanced Config: Using `getPlugin` for custom plugin namespace
+
+Use `getPlugin()` when you want full control over the plugin namespace and rule severities instead of the all-in-one `getConfig()`.
+
+```ts
+import eslintReactKit from "@eslint-react/kit";
+import type { RuleDefinition } from "@eslint-react/kit";
+
+function noForwardRef(): RuleDefinition {
+  return (context, { is }) => ({
+    CallExpression(node) {
+      if (is.forwardRefCall(node)) {
+        context.report({ node, message: "forwardRef is deprecated in React 19." });
+      }
+    },
+  });
+}
+
+function requireReact19(): RuleDefinition {
+  return (context, { settings }) => ({
+    Program(program) {
+      if (!settings.version.startsWith("19.")) {
+        context.report({
+          node: program,
+          message: `This project requires React 19, but detected version ${settings.version}.`,
+        });
+      }
+    },
+  });
+}
+
+const kit = eslintReactKit()
+  .use(noForwardRef)
+  .use(requireReact19);
+
+// Instead of kit.getConfig(), use kit.getPlugin() for full control:
+const plugin = kit.getPlugin();
+
+export default [
+  {
+    files: ["**/*.{ts,tsx}"],
+    plugins: {
+      // Choose your own namespace
+      "react-custom": plugin,
+    },
+    rules: {
+      // Set individual severities
+      "react-custom/no-forward-ref": "error",
+      "react-custom/require-react-19": "error",
+    },
+  },
+];
+```
+
+<!--## More Examples
 
-Please check the [Rule Recipes](https://beta.eslint-react.xyz/docs/configuration/configure-custom-rules#rule-recipes) in the documentation site.
+Please check the [Rule Recipes](https://beta.eslint-react.xyz/docs/configuration/configure-custom-rules#rule-recipes) in the documentation site.-->

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { ESLintReactSettingsNormalized, RuleFix, RuleFixer, RuleListener, define
 import { TSESTreeFunction } from "@eslint-react/ast";
 import { TSESTree } from "@typescript-eslint/utils";
 import { RuleContext } from "@typescript-eslint/utils/ts-eslint";
-import { Linter } from "eslint";
+import { ESLint, Linter } from "eslint";
 
 //#region src/index.d.ts
 interface Collector<T> {
@@ -104,6 +104,7 @@ interface Builder {
   getConfig(args?: {
     files?: string[];
   }): Linter.Config;
+  getPlugin(): ESLint.Plugin;
   use<F extends (...args: any[]) => RuleDefinition>(factory: F, ...args: Parameters<F>): Builder;
 }
 declare function eslintReactKit(): Builder;

package/dist/index.js

@@ -4,7 +4,7 @@ import { kebabCase } from "string-ts";
 
 //#region package.json
 var name = "@eslint-react/kit";
-var version = "4.0.1-beta.1";
+var version = "4.0.2-beta.0";
 
 //#endregion
 //#region src/index.ts
@@ -104,27 +104,30 @@ function makeRuleToolkit(context) {
 }
 function eslintReactKit() {
 	const idGen = new IdGenerator();
-	const plugin = {
-		meta: {
-			name,
-			version
-		},
-		rules: {}
-	};
+	const rules = {};
 	const builder = {
 		getConfig({ files = ["**/*.ts", "**/*.tsx"] } = {}) {
 			return {
 				files,
-				plugins: { [name]: plugin },
-				rules: Object.keys(plugin.rules).reduce((acc, name$1) => {
+				plugins: { [name]: builder.getPlugin() },
+				rules: Object.keys(rules).reduce((acc, name$1) => {
 					acc[`${name}/${name$1}`] = "error";
 					return acc;
 				}, {})
 			};
 		},
+		getPlugin() {
+			return {
+				meta: {
+					name,
+					version
+				},
+				rules
+			};
+		},
 		use(make, ...args) {
 			const name = kebabCase(make.name === "" ? idGen.next() : make.name);
-			Reflect.set(plugin.rules, name, {
+			Reflect.set(rules, name, {
 				meta: {
 					fixable: "code",
 					hasSuggestions: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/kit",
-  "version": "4.0.1-beta.1",
+  "version": "4.0.2-beta.0",
   "description": "ESLint React's utility module for building custom rules.",
   "keywords": [
     "react",
@@ -38,9 +38,9 @@
   "dependencies": {
     "@typescript-eslint/utils": "^8.57.2",
     "string-ts": "^2.3.1",
-    "@eslint-react/ast": "4.0.1-beta.1",
-    "@eslint-react/core": "4.0.1-beta.1",
-    "@eslint-react/shared": "4.0.1-beta.1"
+    "@eslint-react/ast": "4.0.2-beta.0",
+    "@eslint-react/core": "4.0.2-beta.0",
+    "@eslint-react/shared": "4.0.2-beta.0"
   },
   "devDependencies": {
     "eslint": "^10.1.0",