eslint-plugin-react-doctor 0.2.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aiden Bai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# eslint-plugin-react-doctor
+
+[![version](https://img.shields.io/npm/v/eslint-plugin-react-doctor?style=flat&colorA=000000&colorB=000000)](https://npmjs.com/package/eslint-plugin-react-doctor)
+[![downloads](https://img.shields.io/npm/dt/eslint-plugin-react-doctor.svg?style=flat&colorA=000000&colorB=000000)](https://npmjs.com/package/eslint-plugin-react-doctor)
+
+ESLint plugin for [React Doctor](https://react.doctor). Diagnoses React codebases for security, performance, correctness, accessibility, bundle-size, and architecture issues.
+
+This package owns the ESLint adapter for React Doctor's rule set. The underlying rules ship in [`oxlint-plugin-react-doctor`](https://npmjs.com/package/oxlint-plugin-react-doctor) (auto-installed as a transitive dependency). The full diagnostic CLI lives in [`react-doctor`](https://npmjs.com/package/react-doctor) and pulls in this same rule set; install whichever fits your workflow.
+
+## Install
+
+```bash
+npm install --save-dev eslint-plugin-react-doctor
+```
+
+```bash
+pnpm add -D eslint-plugin-react-doctor
+```
+
+```bash
+yarn add -D eslint-plugin-react-doctor
+```
+
+## Usage
+
+Flat config (ESLint v9+):
+
+```js
+import reactDoctor from "eslint-plugin-react-doctor";
+
+export default [
+  reactDoctor.configs.recommended,
+  reactDoctor.configs.next,
+  reactDoctor.configs["react-native"],
+  reactDoctor.configs["tanstack-start"],
+  reactDoctor.configs["tanstack-query"],
+];
+```
+
+Pick only the configs that match your stack. `recommended` is framework-agnostic; the others layer on framework-specific rules.
+
+## Available configs
+
+| Config           | What it adds                                                  |
+| ---------------- | ------------------------------------------------------------- |
+| `recommended`    | Framework-agnostic React rules. Safe baseline.                |
+| `next`           | Next.js specific rules (App Router, server components, etc.). |
+| `react-native`   | React Native specific rules.                                  |
+| `tanstack-start` | TanStack Start specific rules.                                |
+| `tanstack-query` | TanStack Query specific rules.                                |
+| `all`            | Every rule across every framework, at recommended severity.   |
+
+## Available rules
+
+The full rule list lives in [`oxlint-config.ts`](https://github.com/millionco/react-doctor/blob/main/packages/react-doctor/src/oxlint-config.ts). Rules are namespaced under `react-doctor/*`.
+
+To override a rule:
+
+```js
+import reactDoctor from "eslint-plugin-react-doctor";
+
+export default [
+  reactDoctor.configs.recommended,
+  {
+    rules: {
+      "react-doctor/no-fetch-in-effect": "error",
+      "react-doctor/no-derived-state-effect": "off",
+    },
+  },
+];
+```
+
+## Want the CLI too?
+
+This package only ships the ESLint plugin. To run React Doctor's full scan (with scoring, JSON reports, agent integration, etc.), use the main CLI:
+
+```bash
+npx -y react-doctor@latest .
+```
+
+See the [React Doctor README](https://github.com/millionco/react-doctor#readme) for the full feature set.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { EsTreeNode, OxlintRuleSeverity, RuleVisitors } from "oxlint-plugin-react-doctor";
+
+//#region src/index.d.ts
+interface EslintRuleContext {
+  report: (descriptor: {
+    node: EsTreeNode;
+    message: string;
+  }) => void;
+  getFilename?: () => string;
+}
+interface EslintRuleMeta {
+  type: "problem" | "suggestion" | "layout";
+  docs: {
+    description: string;
+    url: string;
+    recommended: boolean;
+  };
+  schema: unknown[];
+}
+interface EslintRule {
+  meta: EslintRuleMeta;
+  create: (context: EslintRuleContext) => RuleVisitors;
+}
+interface EslintFlatConfig {
+  name: string;
+  plugins: Record<string, EslintPlugin>;
+  rules: Record<string, OxlintRuleSeverity>;
+}
+interface EslintPlugin {
+  meta: {
+    name: string;
+    version: string;
+  };
+  rules: Record<string, EslintRule>;
+  configs: {
+    recommended: EslintFlatConfig;
+    next: EslintFlatConfig;
+    "react-native": EslintFlatConfig;
+    "tanstack-start": EslintFlatConfig;
+    "tanstack-query": EslintFlatConfig;
+    all: EslintFlatConfig;
+  };
+}
+declare const eslintPlugin: EslintPlugin;
+//#endregion
+export { eslintPlugin as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,50 @@
+import oxlintPlugin, { GLOBAL_REACT_DOCTOR_RULES, NEXTJS_RULES, REACT_NATIVE_RULES, TANSTACK_QUERY_RULES, TANSTACK_START_RULES } from "oxlint-plugin-react-doctor";
+//#region src/index.ts
+const PLUGIN_NAMESPACE = "react-doctor";
+const RULE_DOCS_BASE_URL = "https://react.doctor/rules";
+const recommendedRuleKeys = new Set(Object.keys(GLOBAL_REACT_DOCTOR_RULES));
+const wrapAsEslintRule = (ruleName, ruleImpl) => ({
+	meta: {
+		type: "problem",
+		docs: {
+			description: ruleName.replaceAll("-", " ").replace(/\b\w/g, (innerChar) => innerChar.toUpperCase()),
+			url: `${RULE_DOCS_BASE_URL}/${ruleName}`,
+			recommended: recommendedRuleKeys.has(`${PLUGIN_NAMESPACE}/${ruleName}`)
+		},
+		schema: []
+	},
+	create: (context) => ruleImpl.create(context)
+});
+const eslintShapedRules = Object.fromEntries(Object.entries(oxlintPlugin.rules).map(([ruleName, ruleImpl]) => [ruleName, wrapAsEslintRule(ruleName, ruleImpl)]));
+const buildFlatConfig = (configName, ruleSet) => ({
+	name: `react-doctor/${configName}`,
+	plugins: {},
+	rules: { ...ruleSet }
+});
+const ALL_RULES_AT_RECOMMENDED_SEVERITY = {
+	...GLOBAL_REACT_DOCTOR_RULES,
+	...NEXTJS_RULES,
+	...REACT_NATIVE_RULES,
+	...TANSTACK_START_RULES,
+	...TANSTACK_QUERY_RULES
+};
+const eslintPlugin = {
+	meta: {
+		name: PLUGIN_NAMESPACE,
+		version: "0.2.0-beta.2"
+	},
+	rules: eslintShapedRules,
+	configs: {
+		recommended: buildFlatConfig("recommended", GLOBAL_REACT_DOCTOR_RULES),
+		next: buildFlatConfig("next", NEXTJS_RULES),
+		"react-native": buildFlatConfig("react-native", REACT_NATIVE_RULES),
+		"tanstack-start": buildFlatConfig("tanstack-start", TANSTACK_START_RULES),
+		"tanstack-query": buildFlatConfig("tanstack-query", TANSTACK_QUERY_RULES),
+		all: buildFlatConfig("all", ALL_RULES_AT_RECOMMENDED_SEVERITY)
+	}
+};
+for (const flatConfig of Object.values(eslintPlugin.configs)) flatConfig.plugins[PLUGIN_NAMESPACE] = eslintPlugin;
+//#endregion
+export { eslintPlugin as default };
+
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "eslint-plugin-react-doctor",
+  "version": "0.2.0-beta.2",
+  "description": "ESLint plugin for React Doctor: diagnose React codebases for security, performance, correctness, accessibility, bundle-size, and architecture issues",
+  "keywords": [
+    "accessibility",
+    "eslint",
+    "eslint-plugin",
+    "eslintplugin",
+    "linter",
+    "nextjs",
+    "performance",
+    "react",
+    "react-compiler",
+    "react-native",
+    "security",
+    "tanstack",
+    "typescript"
+  ],
+  "homepage": "https://github.com/millionco/react-doctor#readme",
+  "bugs": {
+    "url": "https://github.com/millionco/react-doctor/issues"
+  },
+  "license": "MIT",
+  "author": "Aiden Bai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/millionco/react-doctor.git",
+    "directory": "packages/eslint-plugin-react-doctor"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "oxlint-plugin-react-doctor": "0.2.0-beta.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "dev": "vp pack --watch",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && NODE_ENV=production vp pack",
+    "typecheck": "tsc --noEmit",
+    "test": "vp test run"
+  }
+}