@geoql/eslint-plugin-vue-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,79 @@
+# @geoql/eslint-plugin-vue-doctor
+
+ESLint **flat-config** plugin that flags Vue 3 anti-patterns, AI-slop, reactivity
+leaks, composition mistakes, and security issues — the same detection logic that
+powers [`@geoql/oxlint-plugin-vue-doctor`](../oxlint-plugin-vue-doctor), exposed
+for teams whose lint pipeline is ESLint rather than oxlint.
+
+## Install
+
+```sh
+pnpm add -D @geoql/eslint-plugin-vue-doctor eslint
+```
+
+## Usage (flat config)
+
+```js
+// eslint.config.js
+import vueDoctor from '@geoql/eslint-plugin-vue-doctor';
+
+export default [vueDoctor.configs.recommended];
+```
+
+Or wire individual rules:
+
+```js
+import vueDoctor from '@geoql/eslint-plugin-vue-doctor';
+
+export default [
+  {
+    plugins: { 'vue-doctor': vueDoctor },
+    rules: {
+      'vue-doctor/security/no-eval-like': 'error',
+    },
+  },
+];
+```
+
+### Presets
+
+- `configs.recommended` — every 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`.
+
+### Capabilities (`settings`)
+
+Some rules only fire when the project has a matching capability. Provide them via
+the `vue-doctor` settings namespace:
+
+```js
+export default [
+  {
+    plugins: { 'vue-doctor': vueDoctor },
+    settings: { 'vue-doctor': { capabilities: ['auto-imports:vue'] } },
+    rules: { 'vue-doctor/no-imports-from-vue-when-auto-imported': 'warn' },
+  },
+];
+```
+
+## Scope — script rules only (deliberate)
+
+This plugin wires **every ESTree/JavaScript-AST rule core** from
+`@geoql/doctor-rule-core` (the same cores oxlint 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.** Rules such as
+`v-for-has-key` operate on the `@vue/compiler-sfc` template AST, which has a
+completely different node shape from ESLint's JavaScript AST. Surfacing them in
+ESLint would require a `vue-eslint-parser` `defineTemplateBodyVisitor` bridge over
+a different AST — a separate, non-mechanical adapter. Those template rules remain
+available through `@geoql/oxlint-plugin-vue-doctor` and the `@geoql/vue-doctor`
+CLI. This plugin ships a complete, correct adapter for the script-rule surface
+rather than a half-built template bridge.
+
+## License
+
+MIT © [Vinayak Kulkarni](https://vinayakkulkarni.dev)

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { CoreRule, CoreRule as CoreRule$1, Severity, Severity as Severity$1, VUE_AUTO_IMPORTED, VUE_RULES } from "@geoql/doctor-rule-core";
+import { Rule } from "eslint";
+
+//#region src/to-eslint-rule.d.ts
+type ESLintSeverity$1 = 'error' | 'warn';
+interface ESLintRule extends Rule.RuleModule<ESLintSeverity$1> {
+  readonly id: string;
+}
+declare function toESLintRule(core: CoreRule$1): ESLintRule;
+declare function deriveCapabilities(settings: Record<string, unknown> | undefined, namespace?: string): Set<string>;
+//#endregion
+//#region src/plugin.d.ts
+type ESLintSeverity = 'error' | 'warn';
+interface VueDoctorRuleModule {
+  readonly id: string;
+  readonly severity: Severity$1;
+  readonly recommended: boolean;
+  readonly category: string;
+}
+interface VueDoctorConfig {
+  readonly files: ReadonlyArray<string>;
+  readonly plugins: {
+    readonly 'vue-doctor': VueDoctorPlugin;
+  };
+  readonly rules: Readonly<Record<string, ESLintSeverity>>;
+  readonly settings?: {
+    readonly 'vue-doctor': {
+      readonly capabilities: string[];
+    };
+  };
+}
+interface VueDoctorPlugin {
+  readonly meta: {
+    readonly name: 'vue-doctor';
+    readonly version: string;
+  };
+  readonly rules: Readonly<Record<string, ReturnType<typeof toESLintRule>>>;
+  readonly ruleMeta: Readonly<Record<string, VueDoctorRuleModule>>;
+  readonly configs: {
+    readonly recommended: ReadonlyArray<VueDoctorConfig>;
+    readonly all: ReadonlyArray<VueDoctorConfig>;
+  };
+}
+declare const finalPlugin: VueDoctorPlugin;
+//#endregion
+export { type CoreRule, type ESLintRule, type Severity, VUE_AUTO_IMPORTED, VUE_RULES, type VueDoctorPlugin, type VueDoctorRuleModule, finalPlugin as default, finalPlugin as plugin, deriveCapabilities, toESLintRule };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,128 @@
+import { VUE_AUTO_IMPORTED, VUE_RULES, VUE_RULES as VUE_RULES$1 } from "@geoql/doctor-rule-core";
+//#region src/to-eslint-rule.ts
+function toESLintRule(core) {
+	const meta = {
+		type: "problem",
+		schema: [],
+		messages: { default: "" }
+	};
+	if (core.meta?.fixable) meta.fixable = "code";
+	return {
+		id: core.id,
+		meta,
+		create(context) {
+			const settings = context.settings;
+			const coreContext = {
+				report(descriptor) {
+					const node = descriptor.node;
+					if (!descriptor.fix) {
+						context.report({
+							node,
+							message: descriptor.message
+						});
+						return;
+					}
+					context.report({
+						node,
+						message: descriptor.message,
+						fix(fixer) {
+							const replacement = descriptor.fix({ replaceText: (n, text) => {
+								return {
+									range: [n.range?.[0] ?? 0, n.range?.[1] ?? 0],
+									text,
+									node: n
+								};
+							} });
+							return fixer.replaceTextRange(replacement.range, replacement.text);
+						}
+					});
+				},
+				getFilename: () => context.filename,
+				settings,
+				capabilities: deriveCapabilities(settings)
+			};
+			const coreVisitors = core.create(coreContext);
+			const eslintVisitors = {};
+			for (const key of Object.keys(coreVisitors)) {
+				const fn = coreVisitors[key];
+				if (typeof fn !== "function") continue;
+				eslintVisitors[key] = fn;
+			}
+			return eslintVisitors;
+		}
+	};
+}
+function deriveCapabilities(settings, namespace = "vue-doctor") {
+	if (!settings) return /* @__PURE__ */ new Set();
+	const inner = settings[namespace];
+	if (!inner) return /* @__PURE__ */ new Set();
+	const value = inner["capabilities"];
+	if (!Array.isArray(value)) return /* @__PURE__ */ new Set();
+	return new Set(value.filter((v) => typeof v === "string"));
+}
+//#endregion
+//#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 VUE_DOCTOR_VERSION = "1.0.0";
+const rules = toRecord(VUE_RULES$1);
+const ruleMeta = toMetaRecord(VUE_RULES$1);
+function buildConfigs(self) {
+	const recommendedConfig = {
+		files: ["**/*.{js,jsx,ts,tsx,vue}"],
+		plugins: { "vue-doctor": self },
+		rules: Object.fromEntries(VUE_RULES$1.filter((r) => r.recommended).map((r) => [`vue-doctor/${r.id}`, SEVERITY_TO_ESLINT[r.severity]])),
+		settings: { "vue-doctor": { capabilities: [] } }
+	};
+	const allConfig = {
+		files: ["**/*.{js,jsx,ts,tsx,vue}"],
+		plugins: { "vue-doctor": self },
+		rules: Object.fromEntries(VUE_RULES$1.map((r) => [`vue-doctor/${r.id}`, SEVERITY_TO_ESLINT[r.severity]]))
+	};
+	return {
+		recommended: [recommendedConfig],
+		all: [allConfig]
+	};
+}
+const finalPlugin = {
+	meta: {
+		name: "vue-doctor",
+		version: VUE_DOCTOR_VERSION
+	},
+	rules,
+	ruleMeta,
+	configs: buildConfigs({
+		meta: {
+			name: "vue-doctor",
+			version: VUE_DOCTOR_VERSION
+		},
+		rules,
+		ruleMeta,
+		configs: {
+			recommended: [],
+			all: []
+		}
+	})
+};
+//#endregion
+export { VUE_AUTO_IMPORTED, VUE_RULES, finalPlugin as default, finalPlugin as plugin, deriveCapabilities, toESLintRule };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["VUE_RULES"],"sources":["../src/to-eslint-rule.ts","../src/plugin.ts"],"sourcesContent":["import type { Rule } from 'eslint';\nimport type { CoreRule, RuleContext, AstNode } from '@geoql/doctor-rule-core';\n\ntype ESLintSeverity = 'error' | 'warn';\n\nexport interface ESLintRule extends Rule.RuleModule<ESLintSeverity> {\n  readonly id: string;\n}\n\nexport function toESLintRule(core: CoreRule): ESLintRule {\n  const meta: Rule.RuleMetaData<ESLintSeverity> = {\n    type: 'problem',\n    schema: [],\n    messages: { default: '' },\n  };\n  if (core.meta?.fixable) {\n    meta.fixable = 'code';\n  }\n\n  return {\n    id: core.id,\n    meta,\n    create(context) {\n      const settings = context.settings as Record<string, unknown> | undefined;\n      const coreContext: RuleContext = {\n        report(descriptor) {\n          const node = descriptor.node as unknown as Parameters<\n            typeof context.report\n          >[0]['node'];\n          if (!descriptor.fix) {\n            context.report({ node, message: descriptor.message });\n            return;\n          }\n          context.report({\n            node,\n            message: descriptor.message,\n            fix(fixer) {\n              const replacement = descriptor.fix!({\n                replaceText: (n: AstNode, text: string) => {\n                  const rangeStart =\n                    (n as unknown as { range?: [number, number] }).range?.[0] ??\n                    0;\n                  const rangeEnd =\n                    (n as unknown as { range?: [number, number] }).range?.[1] ??\n                    0;\n                  return { range: [rangeStart, rangeEnd], text, node: n };\n                },\n              });\n              return fixer.replaceTextRange(\n                replacement.range,\n                replacement.text,\n              );\n            },\n          });\n        },\n        getFilename: () => context.filename,\n        settings,\n        capabilities: deriveCapabilities(settings),\n      };\n      const coreVisitors = core.create(coreContext);\n      const eslintVisitors: Record<string, (node: unknown) => void> = {};\n      for (const key of Object.keys(coreVisitors)) {\n        const fn = coreVisitors[key];\n        if (typeof fn !== 'function') continue;\n        eslintVisitors[key] = fn as (node: unknown) => void;\n      }\n      return eslintVisitors as unknown as ReturnType<typeof core.create>;\n    },\n  };\n}\n\nexport function deriveCapabilities(\n  settings: Record<string, unknown> | undefined,\n  namespace: string = 'vue-doctor',\n): Set<string> {\n  if (!settings) return new Set();\n  const inner = settings[namespace] as Record<string, unknown> | undefined;\n  if (!inner) return new Set();\n  const value = inner['capabilities'];\n  if (!Array.isArray(value)) return new Set();\n  return new Set(value.filter((v): v is string => typeof v === 'string'));\n}\n","import {\n  type CoreRule,\n  type Severity,\n  VUE_RULES,\n} from '@geoql/doctor-rule-core';\nimport { toESLintRule } from './to-eslint-rule.js';\n\ntype ESLintSeverity = 'error' | 'warn';\n\nexport interface VueDoctorRuleModule {\n  readonly id: string;\n  readonly severity: Severity;\n  readonly recommended: boolean;\n  readonly category: string;\n}\n\nexport interface VueDoctorConfig {\n  readonly files: ReadonlyArray<string>;\n  readonly plugins: { readonly 'vue-doctor': VueDoctorPlugin };\n  readonly rules: Readonly<Record<string, ESLintSeverity>>;\n  readonly settings?: {\n    readonly 'vue-doctor': { readonly capabilities: string[] };\n  };\n}\n\nexport interface VueDoctorPlugin {\n  readonly meta: { readonly name: 'vue-doctor'; readonly version: string };\n  readonly rules: Readonly<Record<string, ReturnType<typeof toESLintRule>>>;\n  readonly ruleMeta: Readonly<Record<string, VueDoctorRuleModule>>;\n  readonly configs: {\n    readonly recommended: ReadonlyArray<VueDoctorConfig>;\n    readonly all: ReadonlyArray<VueDoctorConfig>;\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, VueDoctorRuleModule> {\n  const out: Record<string, VueDoctorRuleModule> = {};\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 VUE_DOCTOR_VERSION = '1.0.0';\n\nconst rules = toRecord(VUE_RULES);\nconst ruleMeta = toMetaRecord(VUE_RULES);\n\nfunction buildConfigs(self: VueDoctorPlugin): VueDoctorPlugin['configs'] {\n  const recommendedConfig: VueDoctorConfig = {\n    files: ['**/*.{js,jsx,ts,tsx,vue}'],\n    plugins: { 'vue-doctor': self },\n    rules: Object.fromEntries(\n      VUE_RULES.filter((r) => r.recommended).map((r) => [\n        `vue-doctor/${r.id}`,\n        SEVERITY_TO_ESLINT[r.severity],\n      ]),\n    ),\n    settings: { 'vue-doctor': { capabilities: [] } },\n  };\n  const allConfig: VueDoctorConfig = {\n    files: ['**/*.{js,jsx,ts,tsx,vue}'],\n    plugins: { 'vue-doctor': self },\n    rules: Object.fromEntries(\n      VUE_RULES.map((r) => [\n        `vue-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: VueDoctorPlugin = {\n  meta: { name: 'vue-doctor', version: VUE_DOCTOR_VERSION },\n  rules,\n  ruleMeta,\n  configs: { recommended: [], all: [] },\n};\n\nconst finalPlugin: VueDoctorPlugin = {\n  meta: { name: 'vue-doctor', version: VUE_DOCTOR_VERSION },\n  rules,\n  ruleMeta,\n  configs: buildConfigs(plugin),\n};\n\nexport default finalPlugin;\nexport { finalPlugin as plugin };\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@geoql/eslint-plugin-vue-doctor",
+  "version": "1.0.0",
+  "private": false,
+  "description": "ESLint flat-config plugin for Vue 3 anti-patterns and AI-slop detection. Shares the same rule cores as @geoql/oxlint-plugin-vue-doctor. TypeScript, ESM.",
+  "keywords": [
+    "ai-slop",
+    "eslint",
+    "eslint-plugin",
+    "geoql",
+    "lint",
+    "vue",
+    "vue3"
+  ],
+  "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-vue-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/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"
+  }
+}