@geoql/eslint-plugin-nuxt-doctor 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vinayak Kulkarni
+
+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,53 @@
+# @geoql/eslint-plugin-nuxt-doctor
+
+ESLint **flat-config** plugin that flags Nuxt 4 anti-patterns, AI-slop, hydration
+traps, and server-route mistakes — the same detection logic that powers
+[`@geoql/oxlint-plugin-nuxt-doctor`](../oxlint-plugin-nuxt-doctor), exposed for
+teams whose lint pipeline is ESLint rather than oxlint.
+
+## Install
+
+```sh
+pnpm add -D @geoql/eslint-plugin-nuxt-doctor @geoql/eslint-plugin-vue-doctor eslint
+```
+
+## Usage (flat config)
+
+```js
+// eslint.config.js
+import nuxtDoctor from '@geoql/eslint-plugin-nuxt-doctor';
+import vueDoctor from '@geoql/eslint-plugin-vue-doctor';
+
+export default [
+  ...nuxtDoctor.configs.recommended,
+  ...vueDoctor.configs.recommended,
+];
+```
+
+The Nuxt recommended preset **does not** automatically include the Vue rules;
+spread both. (Pushing the Vue rules in by default would create a circular
+dependency between the two plugin packages — Nuxt extends Vue, not the other way
+around.)
+
+### Presets
+
+- `configs.recommended` — every Nuxt rule flagged `recommended` in the shared
+  registry, wired at its registry severity (`error`/`warn`).
+- `configs.all` — every script rule the plugin ships, all at `error`.
+
+## Scope — script rules only (deliberate)
+
+This plugin wires **every ESTree/JavaScript-AST rule core** from
+`@geoql/doctor-rule-core` (the same cores the oxlint plugin uses). Each ESLint
+rule is a thin adapter: it imports the shared core and forwards the core's
+visitor and message into ESLint's `create` / `context.report` API. There is **no
+duplicated detection logic** — a rule's behavior is identical across oxlint and
+ESLint because both consume the same core.
+
+**Template-AST rules are intentionally not included.** Those rules remain
+available through `@geoql/oxlint-plugin-nuxt-doctor` and the `@geoql/nuxt-doctor`
+CLI.
+
+## License
+
+MIT © [Vinayak Kulkarni](https://vinayakkulkarni.dev)

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { CoreRule, NUXT_AUTO_IMPORTED, NUXT_RULES, Severity, Severity as Severity$1 } from "@geoql/doctor-rule-core";
+import { toESLintRule } from "@geoql/eslint-plugin-vue-doctor";
+
+//#region src/plugin.d.ts
+type ESLintSeverity = 'error' | 'warn';
+interface NuxtDoctorRuleModule {
+  readonly id: string;
+  readonly severity: Severity$1;
+  readonly recommended: boolean;
+  readonly category: string;
+}
+interface NuxtDoctorConfig {
+  readonly files: ReadonlyArray<string>;
+  readonly plugins: {
+    readonly 'nuxt-doctor': NuxtDoctorPlugin;
+  };
+  readonly rules: Readonly<Record<string, ESLintSeverity>>;
+}
+interface NuxtDoctorPlugin {
+  readonly meta: {
+    readonly name: 'nuxt-doctor';
+    readonly version: string;
+  };
+  readonly rules: Readonly<Record<string, ReturnType<typeof toESLintRule>>>;
+  readonly ruleMeta: Readonly<Record<string, NuxtDoctorRuleModule>>;
+  readonly configs: {
+    readonly recommended: ReadonlyArray<NuxtDoctorConfig>;
+    readonly all: ReadonlyArray<NuxtDoctorConfig>;
+  };
+}
+declare const finalPlugin: NuxtDoctorPlugin;
+//#endregion
+export { type CoreRule, NUXT_AUTO_IMPORTED, NUXT_RULES, type NuxtDoctorConfig, type NuxtDoctorPlugin, type NuxtDoctorRuleModule, type Severity, finalPlugin as default, finalPlugin as plugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,66 @@
+import { NUXT_AUTO_IMPORTED, NUXT_RULES, NUXT_RULES as NUXT_RULES$1 } from "@geoql/doctor-rule-core";
+import { toESLintRule } from "@geoql/eslint-plugin-vue-doctor";
+//#region src/plugin.ts
+const SEVERITY_TO_ESLINT = {
+	error: "error",
+	warn: "warn",
+	info: "warn"
+};
+function toRecord(rules) {
+	const out = {};
+	for (const core of rules) out[core.id] = toESLintRule(core);
+	return out;
+}
+function toMetaRecord(rules) {
+	const out = {};
+	for (const core of rules) out[core.id] = {
+		id: core.id,
+		severity: core.severity,
+		recommended: core.recommended,
+		category: core.category
+	};
+	return out;
+}
+const NUXT_DOCTOR_VERSION = "1.0.0";
+const rules = toRecord(NUXT_RULES$1);
+const ruleMeta = toMetaRecord(NUXT_RULES$1);
+function buildConfigs(self) {
+	const recommendedConfig = {
+		files: ["**/*.{js,jsx,ts,tsx,vue}"],
+		plugins: { "nuxt-doctor": self },
+		rules: Object.fromEntries(NUXT_RULES$1.filter((r) => r.recommended).map((r) => [`nuxt-doctor/${r.id}`, SEVERITY_TO_ESLINT[r.severity]]))
+	};
+	const allConfig = {
+		files: ["**/*.{js,jsx,ts,tsx,vue}"],
+		plugins: { "nuxt-doctor": self },
+		rules: Object.fromEntries(NUXT_RULES$1.map((r) => [`nuxt-doctor/${r.id}`, SEVERITY_TO_ESLINT[r.severity]]))
+	};
+	return {
+		recommended: [recommendedConfig],
+		all: [allConfig]
+	};
+}
+const finalPlugin = {
+	meta: {
+		name: "nuxt-doctor",
+		version: NUXT_DOCTOR_VERSION
+	},
+	rules,
+	ruleMeta,
+	configs: buildConfigs({
+		meta: {
+			name: "nuxt-doctor",
+			version: NUXT_DOCTOR_VERSION
+		},
+		rules,
+		ruleMeta,
+		configs: {
+			recommended: [],
+			all: []
+		}
+	})
+};
+//#endregion
+export { NUXT_AUTO_IMPORTED, NUXT_RULES, finalPlugin as default, finalPlugin as plugin };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["NUXT_RULES"],"sources":["../src/plugin.ts"],"sourcesContent":["import {\n  type CoreRule,\n  type Severity,\n  NUXT_RULES,\n} from '@geoql/doctor-rule-core';\nimport { toESLintRule } from '@geoql/eslint-plugin-vue-doctor';\n\ntype ESLintSeverity = 'error' | 'warn';\n\nexport interface NuxtDoctorRuleModule {\n  readonly id: string;\n  readonly severity: Severity;\n  readonly recommended: boolean;\n  readonly category: string;\n}\n\nexport interface NuxtDoctorConfig {\n  readonly files: ReadonlyArray<string>;\n  readonly plugins: { readonly 'nuxt-doctor': NuxtDoctorPlugin };\n  readonly rules: Readonly<Record<string, ESLintSeverity>>;\n}\n\nexport interface NuxtDoctorPlugin {\n  readonly meta: { readonly name: 'nuxt-doctor'; readonly version: string };\n  readonly rules: Readonly<Record<string, ReturnType<typeof toESLintRule>>>;\n  readonly ruleMeta: Readonly<Record<string, NuxtDoctorRuleModule>>;\n  readonly configs: {\n    readonly recommended: ReadonlyArray<NuxtDoctorConfig>;\n    readonly all: ReadonlyArray<NuxtDoctorConfig>;\n  };\n}\n\nconst SEVERITY_TO_ESLINT: Readonly<Record<Severity, ESLintSeverity>> = {\n  error: 'error',\n  warn: 'warn',\n  info: 'warn',\n};\n\nfunction toRecord(\n  rules: readonly CoreRule[],\n): Record<string, ReturnType<typeof toESLintRule>> {\n  const out: Record<string, ReturnType<typeof toESLintRule>> = {};\n  for (const core of rules) {\n    out[core.id] = toESLintRule(core);\n  }\n  return out;\n}\n\nfunction toMetaRecord(\n  rules: readonly CoreRule[],\n): Record<string, NuxtDoctorRuleModule> {\n  const out: Record<string, NuxtDoctorRuleModule> = {};\n  for (const core of rules) {\n    out[core.id] = {\n      id: core.id,\n      severity: core.severity,\n      recommended: core.recommended,\n      category: core.category,\n    };\n  }\n  return out;\n}\n\nconst NUXT_DOCTOR_VERSION = '1.0.0';\n\nconst rules = toRecord(NUXT_RULES);\nconst ruleMeta = toMetaRecord(NUXT_RULES);\n\nfunction buildConfigs(self: NuxtDoctorPlugin): NuxtDoctorPlugin['configs'] {\n  const recommendedConfig: NuxtDoctorConfig = {\n    files: ['**/*.{js,jsx,ts,tsx,vue}'],\n    plugins: { 'nuxt-doctor': self },\n    rules: Object.fromEntries(\n      NUXT_RULES.filter((r) => r.recommended).map((r) => [\n        `nuxt-doctor/${r.id}`,\n        SEVERITY_TO_ESLINT[r.severity],\n      ]),\n    ),\n  };\n  const allConfig: NuxtDoctorConfig = {\n    files: ['**/*.{js,jsx,ts,tsx,vue}'],\n    plugins: { 'nuxt-doctor': self },\n    rules: Object.fromEntries(\n      NUXT_RULES.map((r) => [\n        `nuxt-doctor/${r.id}`,\n        SEVERITY_TO_ESLINT[r.severity],\n      ]),\n    ),\n  };\n  return {\n    recommended: [recommendedConfig],\n    all: [allConfig],\n  };\n}\n\nconst plugin: NuxtDoctorPlugin = {\n  meta: { name: 'nuxt-doctor', version: NUXT_DOCTOR_VERSION },\n  rules,\n  ruleMeta,\n  configs: { recommended: [], all: [] },\n};\n\nconst finalPlugin: NuxtDoctorPlugin = {\n  meta: { name: 'nuxt-doctor', version: NUXT_DOCTOR_VERSION },\n  rules,\n  ruleMeta,\n  configs: buildConfigs(plugin),\n};\n\nexport default finalPlugin;\nexport { finalPlugin as plugin };\n"],"mappings":";;;AAgCA,MAAM,qBAAiE;CACrE,OAAO;CACP,MAAM;CACN,MAAM;AACR;AAEA,SAAS,SACP,OACiD;CACjD,MAAM,MAAuD,CAAC;CAC9D,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,MAAM,aAAa,IAAI;CAElC,OAAO;AACT;AAEA,SAAS,aACP,OACsC;CACtC,MAAM,MAA4C,CAAC;CACnD,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,MAAM;EACb,IAAI,KAAK;EACT,UAAU,KAAK;EACf,aAAa,KAAK;EAClB,UAAU,KAAK;CACjB;CAEF,OAAO;AACT;AAEA,MAAM,sBAAsB;AAE5B,MAAM,QAAQ,SAASA,YAAU;AACjC,MAAM,WAAW,aAAaA,YAAU;AAExC,SAAS,aAAa,MAAqD;CACzE,MAAM,oBAAsC;EAC1C,OAAO,CAAC,0BAA0B;EAClC,SAAS,EAAE,eAAe,KAAK;EAC/B,OAAO,OAAO,YACZA,aAAW,QAAQ,MAAM,EAAE,WAAW,EAAE,KAAK,MAAM,CACjD,eAAe,EAAE,MACjB,mBAAmB,EAAE,SACvB,CAAC,CACH;CACF;CACA,MAAM,YAA8B;EAClC,OAAO,CAAC,0BAA0B;EAClC,SAAS,EAAE,eAAe,KAAK;EAC/B,OAAO,OAAO,YACZA,aAAW,KAAK,MAAM,CACpB,eAAe,EAAE,MACjB,mBAAmB,EAAE,SACvB,CAAC,CACH;CACF;CACA,OAAO;EACL,aAAa,CAAC,iBAAiB;EAC/B,KAAK,CAAC,SAAS;CACjB;AACF;AASA,MAAM,cAAgC;CACpC,MAAM;EAAE,MAAM;EAAe,SAAS;CAAoB;CAC1D;CACA;CACA,SAAS,aAAa;EAVtB,MAAM;GAAE,MAAM;GAAe,SAAS;EAAoB;EAC1D;EACA;EACA,SAAS;GAAE,aAAa,CAAC;GAAG,KAAK,CAAC;EAAE;CAOT,CAAC;AAC9B"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@geoql/eslint-plugin-nuxt-doctor",
+  "version": "1.0.0",
+  "private": false,
+  "description": "ESLint flat-config plugin for Nuxt 4 anti-patterns and AI-slop detection. Shares the same rule cores as @geoql/oxlint-plugin-nuxt-doctor and the eslint-plugin-vue-doctor rules. TypeScript, ESM.",
+  "keywords": [
+    "ai-slop",
+    "eslint",
+    "eslint-plugin",
+    "geoql",
+    "lint",
+    "nuxt",
+    "nuxt4"
+  ],
+  "homepage": "https://github.com/geoql/doctor#readme",
+  "bugs": {
+    "url": "https://github.com/geoql/doctor/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Vinayak Kulkarni",
+    "email": "inbox.vinayak@gmail.com",
+    "url": "https://vinayakkulkarni.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/geoql/doctor.git",
+    "directory": "packages/eslint-plugin-nuxt-doctor"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@geoql/eslint-plugin-vue-doctor": "^1.0.0",
+    "@geoql/doctor-rule-core": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "@typescript-eslint/parser": "^8.61.1",
+    "eslint": "^10.5.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9",
+    "@geoql/doctor-core": "1.1.1"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "lint": "vp lint src",
+    "lint:fix": "vp lint src --fix",
+    "format": "vp fmt",
+    "format:check": "vp fmt --check",
+    "build": "vp pack",
+    "test": "vitest run"
+  }
+}