react-doctor 0.1.5 → 0.2.0-beta.0

package/dist/rules-ebKa330H.d.ts

@@ -0,0 +1,28 @@
+import { a as RuleContext, i as RuleVisitors } from "./index-CFzh1cBi.js";
+
+//#region src/core/rules/lint/utils/rule-example.d.ts
+interface RuleExample {
+  before: string;
+  after: string;
+}
+//#endregion
+//#region src/core/rules/lint/utils/rule.d.ts
+interface Rule {
+  recommendation: string;
+  examples?: RuleExample[];
+  create: (context: RuleContext) => RuleVisitors;
+}
+//#endregion
+//#region src/core/rules/lint/utils/rule-plugin.d.ts
+interface RulePlugin {
+  meta: {
+    name: string;
+  };
+  rules: Record<string, Rule>;
+}
+//#endregion
+//#region src/core/rules/lint/rules.d.ts
+declare const reactDoctorOxlintPlugin: RulePlugin;
+//#endregion
+export { RuleExample as i, RulePlugin as n, Rule as r, reactDoctorOxlintPlugin as t };
+//# sourceMappingURL=rules-ebKa330H.d.ts.map

package/dist/score-CzbtoFAu.js

@@ -0,0 +1,69 @@
+//#region src/constants.ts
+const REACT_DOCTOR_CONFIG_FILENAME = "react-doctor.config.json";
+const PACKAGE_JSON_FILENAME = "package.json";
+const PACKAGE_JSON_CONFIG_KEY = "reactDoctor";
+const WARNING_RULE_PENALTY = .5;
+const SCORE_API_URL = "https://www.react.doctor/api/score";
+const FETCH_TIMEOUT_MS = 1e4;
+const MILLISECONDS_PER_SECOND = 1e3;
+//#endregion
+//#region src/core/score.ts
+const getScoreLabel = (score) => {
+	if (score >= 75) return "Great";
+	if (score >= 50) return "Needs work";
+	return "Critical";
+};
+const rulePenalty = (severity, count) => {
+	return (severity === "error" ? 1 : WARNING_RULE_PENALTY) * Math.min(1 + Math.log2(count), 4);
+};
+const calculateScoreBreakdown = (diagnostics, options = {}) => {
+	const perfectScore = options.perfectScore ?? 100;
+	const perCategoryCap = options.perCategoryCap ?? 35;
+	if (diagnostics.length === 0) return {
+		score: perfectScore,
+		totalRawPenalty: 0,
+		totalCappedPenalty: 0,
+		perCategory: []
+	};
+	const ruleCounts = /* @__PURE__ */ new Map();
+	const ruleSeverities = /* @__PURE__ */ new Map();
+	const ruleCategories = /* @__PURE__ */ new Map();
+	for (const diagnostic of diagnostics) {
+		const ruleKey = `${diagnostic.plugin}/${diagnostic.rule}`;
+		ruleCounts.set(ruleKey, (ruleCounts.get(ruleKey) ?? 0) + 1);
+		if (diagnostic.severity === "error" || !ruleSeverities.has(ruleKey)) ruleSeverities.set(ruleKey, diagnostic.severity);
+		if (!ruleCategories.has(ruleKey)) ruleCategories.set(ruleKey, diagnostic.category);
+	}
+	const categoryAggregates = /* @__PURE__ */ new Map();
+	for (const [ruleKey, count] of ruleCounts) {
+		const severity = ruleSeverities.get(ruleKey) ?? "warning";
+		const category = ruleCategories.get(ruleKey) ?? "uncategorized";
+		const penalty = rulePenalty(severity, count);
+		const existing = categoryAggregates.get(category) ?? {
+			rawPenalty: 0,
+			ruleKeys: 0
+		};
+		existing.rawPenalty += penalty;
+		existing.ruleKeys += 1;
+		categoryAggregates.set(category, existing);
+	}
+	const perCategory = [...categoryAggregates.entries()].map(([category, aggregate]) => ({
+		category,
+		rawPenalty: aggregate.rawPenalty,
+		cappedPenalty: Math.min(aggregate.rawPenalty, perCategoryCap),
+		ruleKeys: aggregate.ruleKeys
+	})).toSorted((first, second) => second.cappedPenalty - first.cappedPenalty);
+	const totalRawPenalty = perCategory.reduce((total, entry) => total + entry.rawPenalty, 0);
+	const totalCappedPenalty = perCategory.reduce((total, entry) => total + entry.cappedPenalty, 0);
+	return {
+		score: Math.max(0, Math.min(perfectScore, Math.round(perfectScore - totalCappedPenalty))),
+		totalRawPenalty,
+		totalCappedPenalty,
+		perCategory
+	};
+};
+const calculateScore = (diagnostics, options = {}) => calculateScoreBreakdown(diagnostics, options).score;
+//#endregion
+export { FETCH_TIMEOUT_MS as a, PACKAGE_JSON_FILENAME as c, rulePenalty as i, REACT_DOCTOR_CONFIG_FILENAME as l, calculateScoreBreakdown as n, MILLISECONDS_PER_SECOND as o, getScoreLabel as r, PACKAGE_JSON_CONFIG_KEY as s, calculateScore as t, SCORE_API_URL as u };
+
+//# sourceMappingURL=score-CzbtoFAu.js.map

package/dist/score.d.ts

@@ -0,0 +1,35 @@
+//#region src/core/score.d.ts
+/**
+ * Log-scaled per rule, capped per category. One issue still costs; 1000
+ * issues don't zero a big repo. Categories cap so a single noisy area
+ * (oxlint, codebase) can't single-handedly tank the score.
+ */
+interface ScoreDiagnostic {
+  plugin: string;
+  rule: string;
+  category: string;
+  severity: "error" | "warning";
+}
+interface CalculateScoreOptions {
+  perfectScore?: number;
+  perCategoryCap?: number;
+}
+interface ScoreCategoryBreakdown {
+  category: string;
+  rawPenalty: number;
+  cappedPenalty: number;
+  ruleKeys: number;
+}
+interface ScoreBreakdown {
+  score: number;
+  totalRawPenalty: number;
+  totalCappedPenalty: number;
+  perCategory: ScoreCategoryBreakdown[];
+}
+declare const getScoreLabel: (score: number) => string;
+declare const rulePenalty: (severity: "error" | "warning", count: number) => number;
+declare const calculateScoreBreakdown: (diagnostics: ScoreDiagnostic[], options?: CalculateScoreOptions) => ScoreBreakdown;
+declare const calculateScore: (diagnostics: ScoreDiagnostic[], options?: CalculateScoreOptions) => number;
+//#endregion
+export { CalculateScoreOptions, ScoreBreakdown, ScoreCategoryBreakdown, ScoreDiagnostic, calculateScore, calculateScoreBreakdown, getScoreLabel, rulePenalty };
+//# sourceMappingURL=score.d.ts.map

package/dist/score.js

@@ -0,0 +1,2 @@
+import { i as rulePenalty, n as calculateScoreBreakdown, r as getScoreLabel, t as calculateScore } from "./score-CzbtoFAu.js";
+export { calculateScore, calculateScoreBreakdown, getScoreLabel, rulePenalty };

package/dist/sdk.d.ts

@@ -0,0 +1,90 @@
+import { CalculateScoreOptions, ScoreBreakdown, ScoreCategoryBreakdown, ScoreDiagnostic, calculateScore, calculateScoreBreakdown, getScoreLabel } from "./score.js";
+import { A as ReactProjectFramework, C as ReactDoctorIssue, D as ReactDoctorResult, E as ReactDoctorJsonReportSummary, M as SourceLocation, O as ReactDoctorRuleSelection, S as ReactDoctorIgnoreOverride, T as ReactDoctorJsonReport, _ as LoadedReactDoctorConfig, a as RuleContext, b as ReactDoctorFailOnLevel, c as ReactDoctorRuleRegistry, d as ReactDoctorRule, f as ReactDoctorRuleContext, g as InspectReactProjectOptions, h as ReactDoctorRuleResult, i as RuleVisitors, j as ReactProjectInfo, k as ReactDoctorScore, l as RuleRegistryOptions, m as ReactDoctorRuleMetadata, n as createRuleRegistry, o as EsTreeNode, p as ReactDoctorRuleExample, r as ruleRegistry, s as reactProjectStructureRule, t as coreRules, u as defineRule, v as ReactDoctorCheckResult, w as ReactDoctorIssueSource, x as ReactDoctorIgnoreConfig, y as ReactDoctorConfig } from "./index-CFzh1cBi.js";
+import { _ as ReactDoctorRunnerUnavailableError, a as ReactDoctorCheckSkippedError, b as isReactDoctorError, c as ReactDoctorError, d as ReactDoctorInvalidConfigError, f as ReactDoctorNoReactDependencyError, g as ReactDoctorReportError, h as ReactDoctorProjectNotFoundError, i as ReactDoctorCheckFailedError, l as ReactDoctorErrorInfo, m as ReactDoctorProjectError, n as ReactDoctorCancelledError, o as ReactDoctorConfigError, p as ReactDoctorPackageJsonNotFoundError, r as ReactDoctorCheckError, s as ReactDoctorConfigNotFoundError, t as ReactDoctorAmbiguousProjectError, u as ReactDoctorErrorOptions, v as ReactDoctorTimeoutError, x as toReactDoctorErrorInfo, y as ReactDoctorUnsupportedRuntimeError } from "./errors-ZdckckLr.js";
+import { C as shouldEnableReactDoctorOxlintRule, S as reactPeerRangeMinMajor, _ as ReactDoctorOxlintProjectInfo, a as BUILTIN_REACT_OXLINT_RULES, b as buildReactDoctorOxlintCapabilities, c as NEXTJS_OXLINT_RULES, d as REACT_DOCTOR_CUSTOM_OXLINT_RULES, f as REACT_NATIVE_OXLINT_RULES, g as ReactDoctorOxlintJsPluginEntry, h as ReactDoctorOxlintGeneratedConfig, i as BUILTIN_OXLINT_RULES, l as OxlintRuleSeverityMap, m as ReactDoctorOxlintFramework, n as ALL_REACT_DOCTOR_OXLINT_RULE_KEYS, o as CURATED_OXLINT_RULES, p as ReactDoctorOxlintConfigOptions, r as BUILTIN_A11Y_OXLINT_RULES, s as GLOBAL_REACT_DOCTOR_OXLINT_RULES, t as reactDoctorEslintPlugin, u as REACT_COMPILER_OXLINT_RULES, v as TANSTACK_QUERY_OXLINT_RULES, x as createReactDoctorOxlintConfig, y as TANSTACK_START_OXLINT_RULES } from "./eslint-plugin-BIjw2MeW.js";
+import { i as RuleExample, n as RulePlugin, r as Rule, t as reactDoctorOxlintPlugin } from "./rules-ebKa330H.js";
+import { DiagnoseOptions, DiagnoseResult, Diagnostic, ProjectInfo, ScoreResult, clearCaches, diagnose } from "./compat.js";
+
+//#region src/core/rules/codebase/dead-code.d.ts
+declare const DEAD_CODE_RULE_ID = "react-doctor/codebase/dead-code";
+//#endregion
+//#region src/core/rules/codebase/dependencies.d.ts
+declare const DEPENDENCIES_RULE_ID = "react-doctor/codebase/dependencies";
+//#endregion
+//#region src/core/rules/codebase/react-architecture.d.ts
+declare const REACT_ARCHITECTURE_RULE_ID = "react-doctor/codebase/react-architecture";
+//#endregion
+//#region src/core/rules/lint/utils/parsed-rgb.d.ts
+interface ParsedRgb {
+  red: number;
+  green: number;
+  blue: number;
+}
+//#endregion
+//#region src/core/rules/lint/metadata.d.ts
+interface OxlintRuleMetadata extends ReactDoctorRuleMetadata {
+  oxlintRuleName: string;
+  oxlintRuleKey: string;
+}
+declare const REACT_DOCTOR_OXLINT_PLUGIN_NAMESPACE = "react-doctor";
+declare const REACT_DOCTOR_OXLINT_RULE_ID_PREFIX = "oxlint/react-doctor/";
+declare const reactDoctorOxlintRuleMetadata: OxlintRuleMetadata[];
+//#endregion
+//#region src/core/config.d.ts
+declare const clearReactDoctorConfigCache: () => void;
+declare const loadReactDoctorConfig: (startDirectory: string) => Promise<LoadedReactDoctorConfig | null>;
+declare const resolveConfigRootDirectory: (loadedConfig: LoadedReactDoctorConfig | null, fallbackDirectory: string) => Promise<string>;
+//#endregion
+//#region src/core/reports.d.ts
+declare const calculateReactDoctorScore: (issues: ReactDoctorIssue[]) => ReactDoctorScore;
+declare const summarizeReactDoctorResult: (result: ReactDoctorResult) => ReactDoctorJsonReportSummary;
+declare const buildReactDoctorJsonReport: (result: ReactDoctorResult) => ReactDoctorJsonReport;
+//#endregion
+//#region src/core/project.d.ts
+declare const parseReactMajorVersion: (version: string | null) => number | null;
+declare const toOxlintProjectInfo: (project: ReactProjectInfo) => ReactDoctorOxlintProjectInfo;
+declare const discoverReactProject: (rootDirectory: string) => Promise<ReactProjectInfo>;
+//#endregion
+//#region src/core/diagnostics.d.ts
+interface FilterReactDoctorIssuesOptions {
+  jsxImportSource?: string;
+}
+declare const filterReactDoctorIssues: (issues: ReactDoctorIssue[], config: ReactDoctorConfig, rootDirectory: string, readSourceLines?: (filePath: string) => string[] | undefined, options?: FilterReactDoctorIssuesOptions) => ReactDoctorIssue[];
+//#endregion
+//#region src/core/runners/check-ids.d.ts
+declare const OXLINT_CHECK_ID = "react-doctor/oxlint";
+//#endregion
+//#region src/core/runners/oxlint.d.ts
+interface RunOxlintOptions {
+  rootDirectory: string;
+  includePaths?: string[];
+  excludePatterns?: string[];
+  project: ReactDoctorOxlintProjectInfo;
+  customRulesOnly?: boolean;
+  includeEcosystemRules?: boolean;
+  adoptExistingLintConfig?: boolean;
+  ignoredTags?: ReadonlySet<string>;
+  signal?: AbortSignal;
+}
+declare const runOxlint: (options: RunOxlintOptions) => Promise<ReactDoctorIssue[]>;
+//#endregion
+//#region src/sdk/create-react-doctor.d.ts
+interface CreateReactDoctorOptions {
+  rootDirectory?: string;
+  includePaths?: string[];
+  excludePatterns?: string[];
+  rules?: InspectReactProjectOptions["rules"];
+  lint?: boolean;
+  deadCode?: boolean;
+  customRulesOnly?: boolean;
+  respectInlineDisables?: boolean;
+  offline?: boolean;
+}
+interface ReactDoctor {
+  inspect: (options?: InspectReactProjectOptions) => Promise<ReactDoctorResult>;
+}
+declare const createReactDoctor: (options?: CreateReactDoctorOptions) => ReactDoctor;
+declare const inspectReactProject: (options?: InspectReactProjectOptions) => Promise<ReactDoctorResult>;
+//#endregion
+export { ALL_REACT_DOCTOR_OXLINT_RULE_KEYS, BUILTIN_A11Y_OXLINT_RULES, BUILTIN_OXLINT_RULES, BUILTIN_REACT_OXLINT_RULES, CURATED_OXLINT_RULES, type CalculateScoreOptions, type CreateReactDoctorOptions, DEAD_CODE_RULE_ID, DEPENDENCIES_RULE_ID, type DiagnoseOptions, type DiagnoseResult, type Diagnostic, GLOBAL_REACT_DOCTOR_OXLINT_RULES, type InspectReactProjectOptions, NEXTJS_OXLINT_RULES, OXLINT_CHECK_ID, type EsTreeNode as OxlintEsTreeNode, type ParsedRgb as OxlintParsedRgb, type Rule as OxlintRule, type RuleContext as OxlintRuleContext, type RuleExample as OxlintRuleExample, type OxlintRuleMetadata, type RulePlugin as OxlintRulePlugin, type OxlintRuleSeverityMap, type RuleVisitors as OxlintRuleVisitors, type ProjectInfo, REACT_ARCHITECTURE_RULE_ID, REACT_COMPILER_OXLINT_RULES, REACT_DOCTOR_CUSTOM_OXLINT_RULES, REACT_DOCTOR_OXLINT_PLUGIN_NAMESPACE, REACT_DOCTOR_OXLINT_RULE_ID_PREFIX, REACT_NATIVE_OXLINT_RULES, type ReactDoctor, ReactDoctorAmbiguousProjectError, ReactDoctorCancelledError, ReactDoctorCheckError, ReactDoctorCheckFailedError, type ReactDoctorCheckResult, ReactDoctorCheckSkippedError, type ReactDoctorConfig, ReactDoctorConfigError, ReactDoctorConfigNotFoundError, ReactDoctorError, type ReactDoctorErrorInfo, type ReactDoctorErrorOptions, type ReactDoctorFailOnLevel, type ReactDoctorIgnoreConfig, type ReactDoctorIgnoreOverride, ReactDoctorInvalidConfigError, type ReactDoctorIssue, type ReactDoctorIssueSource, type ReactDoctorJsonReport, type ReactDoctorJsonReportSummary, ReactDoctorNoReactDependencyError, type ReactDoctorOxlintConfigOptions, type ReactDoctorOxlintFramework, type ReactDoctorOxlintGeneratedConfig, type ReactDoctorOxlintJsPluginEntry, type ReactDoctorOxlintProjectInfo, ReactDoctorPackageJsonNotFoundError, ReactDoctorProjectError, ReactDoctorProjectNotFoundError, ReactDoctorReportError, type ReactDoctorResult, type ReactDoctorRule, type ReactDoctorRuleContext, type ReactDoctorRuleExample, type ReactDoctorRuleMetadata, type ReactDoctorRuleRegistry, type ReactDoctorRuleResult, type ReactDoctorRuleSelection, ReactDoctorRunnerUnavailableError, type ReactDoctorScore, ReactDoctorTimeoutError, ReactDoctorUnsupportedRuntimeError, type ReactProjectFramework, type ReactProjectInfo, type RuleRegistryOptions, type RunOxlintOptions, type ScoreBreakdown, type ScoreCategoryBreakdown, type ScoreDiagnostic, type ScoreResult, type SourceLocation, TANSTACK_QUERY_OXLINT_RULES, TANSTACK_START_OXLINT_RULES, buildReactDoctorJsonReport, buildReactDoctorOxlintCapabilities, calculateReactDoctorScore, calculateScore, calculateScoreBreakdown, clearCaches, clearReactDoctorConfigCache, coreRules, createReactDoctor, createReactDoctorOxlintConfig, createRuleRegistry, defineRule, diagnose, discoverReactProject, filterReactDoctorIssues, getScoreLabel, inspectReactProject, isReactDoctorError, loadReactDoctorConfig, parseReactMajorVersion, reactDoctorEslintPlugin, reactDoctorOxlintPlugin, reactDoctorOxlintRuleMetadata, reactPeerRangeMinMajor, reactProjectStructureRule, resolveConfigRootDirectory, ruleRegistry, runOxlint, shouldEnableReactDoctorOxlintRule, summarizeReactDoctorResult, toOxlintProjectInfo, toReactDoctorErrorInfo };
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.js

@@ -0,0 +1,17 @@
+import { n as calculateScoreBreakdown, r as getScoreLabel, t as calculateScore } from "./score-CzbtoFAu.js";
+import { A as ReactDoctorProjectError, C as ReactDoctorCheckSkippedError, D as ReactDoctorInvalidConfigError, E as ReactDoctorError, F as ReactDoctorUnsupportedRuntimeError, I as isReactDoctorError, L as toReactDoctorErrorInfo, M as ReactDoctorReportError, N as ReactDoctorRunnerUnavailableError, O as ReactDoctorNoReactDependencyError, P as ReactDoctorTimeoutError, S as ReactDoctorCheckFailedError, T as ReactDoctorConfigNotFoundError, a as DEPENDENCIES_RULE_ID, b as ReactDoctorCancelledError, c as reactProjectStructureRule, i as REACT_ARCHITECTURE_RULE_ID, j as ReactDoctorProjectNotFoundError, k as ReactDoctorPackageJsonNotFoundError, l as reactDoctorOxlintPlugin, m as defineRule, n as createRuleRegistry, o as DEAD_CODE_RULE_ID, r as ruleRegistry, t as coreRules, w as ReactDoctorConfigError, x as ReactDoctorCheckError, y as ReactDoctorAmbiguousProjectError } from "./rules-BfZ4Ujfv.js";
+import { a as filterReactDoctorIssues, c as toOxlintProjectInfo, d as summarizeReactDoctorResult, f as OXLINT_CHECK_ID, h as resolveConfigRootDirectory, i as runOxlint, l as buildReactDoctorJsonReport, m as loadReactDoctorConfig, n as diagnose, o as discoverReactProject, p as clearReactDoctorConfigCache, r as inspectReactProjectCore, s as parseReactMajorVersion, t as clearCaches, u as calculateReactDoctorScore } from "./compat-CM6aj69a.js";
+import { _ as createReactDoctorOxlintConfig, a as BUILTIN_A11Y_OXLINT_RULES, b as shouldEnableReactDoctorOxlintRule, c as CURATED_OXLINT_RULES, d as REACT_COMPILER_OXLINT_RULES, f as REACT_DOCTOR_CUSTOM_OXLINT_RULES, g as buildReactDoctorOxlintCapabilities, h as TANSTACK_START_OXLINT_RULES, i as ALL_REACT_DOCTOR_OXLINT_RULE_KEYS, l as GLOBAL_REACT_DOCTOR_OXLINT_RULES, m as TANSTACK_QUERY_OXLINT_RULES, n as REACT_DOCTOR_OXLINT_RULE_ID_PREFIX, o as BUILTIN_OXLINT_RULES, p as REACT_NATIVE_OXLINT_RULES, r as reactDoctorOxlintRuleMetadata, s as BUILTIN_REACT_OXLINT_RULES, t as REACT_DOCTOR_OXLINT_PLUGIN_NAMESPACE, u as NEXTJS_OXLINT_RULES, y as reactPeerRangeMinMajor } from "./metadata-se470mRG.js";
+import reactDoctorEslintPlugin from "./eslint-plugin.js";
+//#region src/sdk/create-react-doctor.ts
+const mergeInspectOptions = (defaults, options) => ({
+	...defaults,
+	...options,
+	rootDirectory: options.rootDirectory ?? defaults.rootDirectory
+});
+const createReactDoctor = (options = {}) => ({ inspect: (runOptions = {}) => inspectReactProjectCore(mergeInspectOptions(options, runOptions)) });
+const inspectReactProject = (options = {}) => createReactDoctor(options).inspect();
+//#endregion
+export { ALL_REACT_DOCTOR_OXLINT_RULE_KEYS, BUILTIN_A11Y_OXLINT_RULES, BUILTIN_OXLINT_RULES, BUILTIN_REACT_OXLINT_RULES, CURATED_OXLINT_RULES, DEAD_CODE_RULE_ID, DEPENDENCIES_RULE_ID, GLOBAL_REACT_DOCTOR_OXLINT_RULES, NEXTJS_OXLINT_RULES, OXLINT_CHECK_ID, REACT_ARCHITECTURE_RULE_ID, REACT_COMPILER_OXLINT_RULES, REACT_DOCTOR_CUSTOM_OXLINT_RULES, REACT_DOCTOR_OXLINT_PLUGIN_NAMESPACE, REACT_DOCTOR_OXLINT_RULE_ID_PREFIX, REACT_NATIVE_OXLINT_RULES, ReactDoctorAmbiguousProjectError, ReactDoctorCancelledError, ReactDoctorCheckError, ReactDoctorCheckFailedError, ReactDoctorCheckSkippedError, ReactDoctorConfigError, ReactDoctorConfigNotFoundError, ReactDoctorError, ReactDoctorInvalidConfigError, ReactDoctorNoReactDependencyError, ReactDoctorPackageJsonNotFoundError, ReactDoctorProjectError, ReactDoctorProjectNotFoundError, ReactDoctorReportError, ReactDoctorRunnerUnavailableError, ReactDoctorTimeoutError, ReactDoctorUnsupportedRuntimeError, TANSTACK_QUERY_OXLINT_RULES, TANSTACK_START_OXLINT_RULES, buildReactDoctorJsonReport, buildReactDoctorOxlintCapabilities, calculateReactDoctorScore, calculateScore, calculateScoreBreakdown, clearCaches, clearReactDoctorConfigCache, coreRules, createReactDoctor, createReactDoctorOxlintConfig, createRuleRegistry, defineRule, diagnose, discoverReactProject, filterReactDoctorIssues, getScoreLabel, inspectReactProject, isReactDoctorError, loadReactDoctorConfig, parseReactMajorVersion, reactDoctorEslintPlugin, reactDoctorOxlintPlugin, reactDoctorOxlintRuleMetadata, reactPeerRangeMinMajor, reactProjectStructureRule, resolveConfigRootDirectory, ruleRegistry, runOxlint, shouldEnableReactDoctorOxlintRule, summarizeReactDoctorResult, toOxlintProjectInfo, toReactDoctorErrorInfo };
+
+//# sourceMappingURL=sdk.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-doctor",
-  "version": "0.1.5",
+  "version": "0.2.0-beta.0",
   "description": "Diagnose and fix React codebases for security, performance, correctness, accessibility, bundle-size, and architecture issues",
   "keywords": [
     "accessibility",
@@ -41,56 +41,51 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/cli.d.ts",
-      "default": "./dist/cli.js"
+      "types": "./dist/sdk.d.ts",
+      "default": "./dist/sdk.js"
     },
     "./api": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "types": "./dist/compat.d.ts",
+      "default": "./dist/compat.js"
     },
-    "./oxlint-plugin": {
-      "types": "./dist/react-doctor-plugin.d.ts",
-      "default": "./dist/react-doctor-plugin.js"
+    "./score": {
+      "types": "./dist/score.d.ts",
+      "default": "./dist/score.js"
     },
     "./eslint-plugin": {
       "types": "./dist/eslint-plugin.d.ts",
       "default": "./dist/eslint-plugin.js"
+    },
+    "./oxlint-plugin": {
+      "types": "./dist/oxlint-plugin.d.ts",
+      "default": "./dist/oxlint-plugin.js"
     }
   },
   "dependencies": {
     "agent-install": "0.0.5",
     "commander": "^14.0.3",
-    "knip": "^6.10.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
     "ora": "^9.4.0",
+    "oxc-parser": "^0.130.0",
+    "oxc-resolver": "^11.19.1",
     "oxlint": "^1.63.0",
     "picocolors": "^1.1.1",
-    "prompts": "^2.4.2",
-    "typescript": ">=5.0.4 <7"
+    "prompts": "^2.4.2"
   },
   "devDependencies": {
+    "@oxc-project/types": "^0.130.0",
+    "@types/node": "^25.6.0",
     "@types/prompts": "^2.4.9",
-    "eslint-plugin-react-hooks": "^7.1.1",
-    "eslint-plugin-react-you-might-not-need-an-effect": "^0.10.1"
-  },
-  "peerDependencies": {
-    "eslint-plugin-react-hooks": "^6 || ^7",
-    "eslint-plugin-react-you-might-not-need-an-effect": "^0.10"
-  },
-  "peerDependenciesMeta": {
-    "eslint-plugin-react-hooks": {
-      "optional": true
-    },
-    "eslint-plugin-react-you-might-not-need-an-effect": {
-      "optional": true
-    }
+    "vite-plus": "^0.1.15"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.12.0"
   },
   "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"
+    "test": "vp test run",
+    "test:regression": "node --experimental-strip-types --no-warnings scripts/run-regression.ts"
   }
 }

package/dist/index.d.ts

@@ -1,272 +0,0 @@
-//#region src/types.d.ts
-type FailOnLevel = "error" | "warning" | "none";
-type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "unknown";
-interface ProjectInfo {
-  rootDirectory: string;
-  projectName: string;
-  reactVersion: string | null;
-  framework: Framework;
-  hasTypeScript: boolean;
-  hasReactCompiler: boolean;
-  hasTanStackQuery: boolean;
-  sourceFileCount: number;
-}
-interface Diagnostic {
-  filePath: string;
-  plugin: string;
-  rule: string;
-  severity: "error" | "warning";
-  message: string;
-  help: string;
-  url?: string;
-  line: number;
-  column: number;
-  category: string;
-  suppressionHint?: string;
-}
-interface ScoreResult {
-  score: number;
-  label: string;
-}
-interface DiagnoseOptions {
-  lint?: boolean;
-  deadCode?: boolean;
-  verbose?: boolean;
-  includePaths?: string[];
-  /**
-   * Per-call override for `ReactDoctorConfig.respectInlineDisables`.
-   * See that field's docs for the full contract.
-   */
-  respectInlineDisables?: boolean;
-}
-interface DiagnoseResult {
-  diagnostics: Diagnostic[];
-  score: ScoreResult | null;
-  project: ProjectInfo;
-  elapsedMilliseconds: number;
-}
-interface ScanResult {
-  diagnostics: Diagnostic[];
-  score: ScoreResult | null;
-  skippedChecks: string[];
-  project: ProjectInfo;
-  elapsedMilliseconds: number;
-}
-interface DiffInfo {
-  currentBranch: string;
-  baseBranch: string;
-  changedFiles: string[];
-  isCurrentChanges?: boolean;
-}
-interface ReactDoctorIgnoreOverride {
-  files: string[];
-  rules?: string[];
-}
-interface ReactDoctorIgnoreConfig {
-  rules?: string[];
-  files?: string[];
-  overrides?: ReactDoctorIgnoreOverride[];
-}
-interface ReactDoctorConfig {
-  ignore?: ReactDoctorIgnoreConfig;
-  lint?: boolean;
-  deadCode?: boolean;
-  verbose?: boolean;
-  diff?: boolean | string;
-  failOn?: FailOnLevel;
-  customRulesOnly?: boolean;
-  share?: boolean;
-  /**
-   * Redirect react-doctor at a different project directory than the one
-   * it was invoked against. Resolved relative to the location of the
-   * config file that declared this field (NOT relative to the CWD), so
-   * the redirect is stable no matter where the CLI / `diagnose()` is
-   * run from. Absolute paths are used as-is.
-   *
-   * Typical use: a monorepo root holds the only `react-doctor.config.json`
-   * (so editor tooling and child commands all find it), but the React
-   * app lives in `apps/web`. Setting `"rootDir": "apps/web"` makes
-   * every invocation that loads this config scan that subproject
-   * without anyone needing to `cd` first or pass an explicit path.
-   *
-   * Ignored if the resolved path does not exist or is not a directory
-   * (a warning is emitted and react-doctor falls back to the originally
-   * requested directory).
-   */
-  rootDir?: string;
-  textComponents?: string[];
-  /**
-   * Names of components that safely route string-only children through a
-   * React Native `<Text>` internally (e.g. `heroui-native`'s `Button`,
-   * which stringifies its children and renders them through a
-   * `ButtonLabel` → `Text`). For listed components, `rn-no-raw-text`
-   * is suppressed ONLY when the wrapper's children are entirely
-   * stringifiable (no nested JSX elements). A wrapper with mixed
-   * children — e.g. `<Button>Save<Icon /></Button>` — still reports,
-   * because the wrapper can't safely route raw text alongside a
-   * sibling JSX element.
-   *
-   * Use this instead of `textComponents` when the component is not
-   * itself a text element but is known to wrap its string children
-   * in one. `textComponents` is the broader escape hatch and
-   * suppresses regardless of sibling content.
-   */
-  rawTextWrapperComponents?: string[];
-  /**
-   * Whether to respect inline `// eslint-disable*`, `// oxlint-disable*`,
-   * and `// react-doctor-disable*` comments in source files. Default: `true`.
-   *
-   * File-level ignores (`.gitignore`, `.eslintignore`, `.oxlintignore`,
-   * `.prettierignore`, `.gitattributes` `linguist-vendored` /
-   * `linguist-generated`) are ALWAYS honored regardless of this option
-   * — they typically point at vendored or generated code that
-   * genuinely shouldn't be linted at all.
-   *
-   * Set to `false` for "audit mode": every inline suppression is
-   * neutralized so react-doctor reports every diagnostic regardless
-   * of historical hide-comments.
-   */
-  respectInlineDisables?: boolean;
-  /**
-   * Whether to merge the user's existing JSON oxlint / eslint config
-   * (`.oxlintrc.json` or `.eslintrc.json`) into the generated scan via
-   * oxlint's `extends` field, so diagnostics from those rules count
-   * toward the react-doctor score. Default: `true`.
-   *
-   * Detection runs at the scanned directory and walks up to the
-   * nearest project boundary (`.git` directory or monorepo root).
-   * The first match wins, with `.oxlintrc.json` preferred over
-   * `.eslintrc.json`.
-   *
-   * Only JSON-format configs are supported because oxlint's `extends`
-   * cannot evaluate JS/TS configs. Flat configs (`eslint.config.js`),
-   * legacy JS configs (`.eslintrc.js`), and TypeScript oxlint configs
-   * (`oxlint.config.ts`) are silently skipped.
-   *
-   * Category-level enables in the user's config (`"categories": { ... }`)
-   * are NOT honored — react-doctor explicitly disables every oxlint
-   * category to keep the scan scoped to its curated rule surface, and
-   * local config wins over `extends`. Use rule-level severities to
-   * fold rules into the score.
-   *
-   * Set to `false` to scan only react-doctor's curated rule set.
-   */
-  adoptExistingLintConfig?: boolean;
-}
-type JsonReportMode = "full" | "diff" | "staged";
-interface JsonReportDiffInfo {
-  baseBranch: string;
-  currentBranch: string;
-  changedFileCount: number;
-  isCurrentChanges: boolean;
-}
-interface JsonReportProjectEntry {
-  directory: string;
-  project: ProjectInfo;
-  diagnostics: Diagnostic[];
-  score: ScoreResult | null;
-  skippedChecks: string[];
-  elapsedMilliseconds: number;
-}
-interface JsonReportSummary {
-  errorCount: number;
-  warningCount: number;
-  affectedFileCount: number;
-  totalDiagnosticCount: number;
-  score: number | null;
-  scoreLabel: string | null;
-}
-interface JsonReportError {
-  message: string;
-  name: string;
-  chain: string[];
-}
-interface JsonReport {
-  schemaVersion: 1;
-  version: string;
-  ok: boolean;
-  directory: string;
-  mode: JsonReportMode;
-  diff: JsonReportDiffInfo | null;
-  projects: JsonReportProjectEntry[];
-  /**
-   * Flattened across `projects[].diagnostics` for convenience. Equivalent to
-   * `projects.flatMap((project) => project.diagnostics)`.
-   */
-  diagnostics: Diagnostic[];
-  summary: JsonReportSummary;
-  elapsedMilliseconds: number;
-  error: JsonReportError | null;
-}
-//#endregion
-//#region src/utils/build-json-report.d.ts
-interface BuildJsonReportInput {
-  version: string;
-  directory: string;
-  mode: JsonReportMode;
-  diff: DiffInfo | null;
-  scans: Array<{
-    directory: string;
-    result: ScanResult;
-  }>;
-  totalElapsedMilliseconds: number;
-}
-declare const buildJsonReport: (input: BuildJsonReportInput) => JsonReport;
-//#endregion
-//#region src/utils/build-json-report-error.d.ts
-interface BuildJsonReportErrorInput {
-  version: string;
-  directory: string;
-  error: unknown;
-  elapsedMilliseconds: number;
-  mode?: JsonReportMode;
-}
-declare const buildJsonReportError: (input: BuildJsonReportErrorInput) => JsonReport;
-//#endregion
-//#region src/utils/get-diff-files.d.ts
-declare const getDiffInfo: (directory: string, explicitBaseBranch?: string) => DiffInfo | null;
-declare const filterSourceFiles: (filePaths: string[]) => string[];
-//#endregion
-//#region src/utils/summarize-diagnostics.d.ts
-declare const summarizeDiagnostics: (diagnostics: Diagnostic[], worstScore?: number | null, worstScoreLabel?: string | null) => JsonReportSummary;
-//#endregion
-//#region src/errors.d.ts
-declare class ReactDoctorError extends Error {
-  readonly name: string;
-  constructor(message: string, options?: ErrorOptions);
-}
-declare class ProjectNotFoundError extends ReactDoctorError {
-  readonly name = "ProjectNotFoundError";
-  readonly directory: string;
-  constructor(directory: string, options?: ErrorOptions);
-}
-declare class NoReactDependencyError extends ReactDoctorError {
-  readonly name = "NoReactDependencyError";
-  readonly directory: string;
-  constructor(directory: string, options?: ErrorOptions);
-}
-declare class PackageJsonNotFoundError extends ReactDoctorError {
-  readonly name = "PackageJsonNotFoundError";
-  readonly directory: string;
-  constructor(directory: string, options?: ErrorOptions);
-}
-declare class AmbiguousProjectError extends ReactDoctorError {
-  readonly name = "AmbiguousProjectError";
-  readonly directory: string;
-  readonly candidates: readonly string[];
-  constructor(directory: string, candidates: readonly string[], options?: ErrorOptions);
-}
-declare const isReactDoctorError: (value: unknown) => value is ReactDoctorError;
-//#endregion
-//#region src/index.d.ts
-declare const clearCaches: () => void;
-interface ToJsonReportOptions {
-  version: string;
-  directory?: string;
-  mode?: JsonReportMode;
-}
-declare const toJsonReport: (result: DiagnoseResult, options: ToJsonReportOptions) => JsonReport;
-declare const diagnose: (directory: string, options?: DiagnoseOptions) => Promise<DiagnoseResult>;
-//#endregion
-export { AmbiguousProjectError, type DiagnoseOptions, type DiagnoseResult, type Diagnostic, type DiffInfo, type JsonReport, type JsonReportDiffInfo, type JsonReportError, type JsonReportMode, type JsonReportProjectEntry, type JsonReportSummary, NoReactDependencyError, PackageJsonNotFoundError, type ProjectInfo, ProjectNotFoundError, type ReactDoctorConfig, ReactDoctorError, type ScoreResult, buildJsonReport, buildJsonReportError, clearCaches, diagnose, filterSourceFiles, getDiffInfo, isReactDoctorError, summarizeDiagnostics, toJsonReport };
-//# sourceMappingURL=index.d.ts.map