react-doctor 0.2.9 → 0.2.11

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./rolldown-runtime-uZX_iqCz.js";
-import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-BliQX9s8.js";
+import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-pbFEieEc.js";
 import { createRequire } from "node:module";
 import { execFileSync, execSync } from "node:child_process";
 import path, { join } from "node:path";
@@ -6320,11 +6320,11 @@ const colorizeByScore = (text, score) => {
 	return highlighter.error(text);
 };
 //#endregion
+//#region src/cli/utils/constants.ts
+const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
+const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
+//#endregion
 //#region src/cli/utils/render-score-header.ts
-const SCORE_BAR_ANIMATION_FRAME_COUNT = 40;
-const SCORE_BAR_ANIMATION_FRAME_DELAY_MS = 50;
-const PERFECT_SCORE_RAINBOW_FRAME_COUNT = 16;
-const PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS = 50;
 const RAINBOW_HUE_SHIFT_PER_FRAME = 9;
 const RAINBOW_GRADIENT_WIDTH = 80;
 const RAINBOW_OKLCH_LIGHTNESS = .638;
@@ -6433,8 +6433,8 @@ const buildInitialScoreHeaderLine = ({ isPerfectScore, shouldAnimate, lineIndex,
 };
 const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectName) => Effect.gen(function* () {
 	const isPerfectScore = score === 100;
-	for (let frame = 0; frame <= SCORE_BAR_ANIMATION_FRAME_COUNT; frame += 1) {
-		const progress = easeOutCubic(frame / SCORE_BAR_ANIMATION_FRAME_COUNT);
+	for (let frame = 0; frame <= 40; frame += 1) {
+		const progress = easeOutCubic(frame / 40);
 		const animatedScore = Math.round(score * progress);
 		if (isPerfectScore) {
 			yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[4A"}\r${buildRainbowScoreHeaderFrame({
@@ -6444,16 +6444,16 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 				frame,
 				projectName
 			})}`);
-			if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+			if (frame < 40) yield* sleep(50);
 			continue;
 		}
 		const animatedScoreLine = buildScoreLine(animatedScore, score, label, projectName);
 		const animatedBarLine = buildScoreBar(animatedScore, score);
 		yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[2A"}\r${buildScoreHeaderLine(scoreFaceLine, animatedScoreLine)}\n\r${buildScoreHeaderLine(barFaceLine, animatedBarLine)}\n`);
-		if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+		if (frame < 40) yield* sleep(50);
 	}
 	if (!isPerfectScore) return;
-	for (let frame = 0; frame < PERFECT_SCORE_RAINBOW_FRAME_COUNT; frame += 1) {
+	for (let frame = 0; frame < 16; frame += 1) {
 		yield* writeScoreHeaderLine(`\x1b[4A\r${buildRainbowScoreHeaderFrame({
 			score,
 			displayScore: score,
@@ -6461,9 +6461,9 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 			frame,
 			projectName
 		})}`);
-		yield* sleep(PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS);
+		yield* sleep(50);
 	}
-	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, PERFECT_SCORE_RAINBOW_FRAME_COUNT, projectName)}\x1b[2A`);
+	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, 16, projectName)}\x1b[2A`);
 });
 const printScoreHeader = (scoreResult, projectName) => Effect.gen(function* () {
 	const isPerfectScore = scoreResult.score === 100;
@@ -6666,7 +6666,7 @@ const resolveOxlintNodeEffect = (isLintEnabled, isQuiet) => Effect.gen(function*
 const resolveOxlintNode = (isLintEnabled, isQuiet) => Effect.runPromise(resolveOxlintNodeEffect(isLintEnabled, isQuiet).pipe(Effect.provide(NodeResolver.layerNode)));
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.2.9";
+const VERSION = "0.2.11";
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
@@ -6854,10 +6854,6 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 	return buildResult();
 });
 //#endregion
-//#region src/cli/utils/constants.ts
-const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
-const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
-//#endregion
 //#region src/cli/utils/get-staged-files.ts
 const stagedFilesLayer = StagedFiles.layerNode.pipe(Layer.provide(Git.layerNode));
 const getStagedSourceFiles = async (directory) => {
@@ -7416,7 +7412,7 @@ const disableSetupPrompt = (projectRoot, storeOptions = {}) => {
 	return true;
 };
 const shouldPromptInstallSetup = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7426,13 +7422,13 @@ const shouldPromptInstallSetup = (options) => {
 	return !hasDoctorScript(options.projectRoot);
 };
 const resolveInstallSetupProjectRoot = (options) => {
-	if (options.completedScanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
+	if (options.scanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
 	const packageDirectories = /* @__PURE__ */ new Set();
-	for (const scanDirectory of options.completedScanDirectories) {
+	for (const scanDirectory of options.scanDirectories) {
 		const packageDirectory = findNearestPackageDirectory(scanDirectory, options.scanRoot) ?? findNearestPackageDirectory(scanDirectory) ?? scanDirectory;
 		packageDirectories.add(packageDirectory);
 	}
-	if (packageDirectories.size !== 1) return null;
+	if (packageDirectories.size !== 1) return findNearestPackageDirectory(options.scanRoot, options.scanRoot);
 	return [...packageDirectories][0] ?? null;
 };
 const defaultWait = (milliseconds) => new Promise((resolve) => {
@@ -7467,7 +7463,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-BliQX9s8.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-pbFEieEc.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7483,7 +7479,7 @@ const promptInstallSetup = async (options) => {
 			writeLine("You can always run `npx react-doctor@latest install` to set it up later.");
 			return;
 		}
-		const install = options.install ?? (await Promise.resolve().then(() => install_skill_exports)).runInstallSkill;
+		const install = options.install ?? (await Promise.resolve().then(() => install_react_doctor_exports)).runInstallReactDoctor;
 		const previousExitCode = process.exitCode;
 		let setupExitCode;
 		try {
@@ -7502,7 +7498,7 @@ const promptInstallSetup = async (options) => {
 	}
 };
 const shouldShowAgentInstallHint = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7567,7 +7563,7 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isQui
 	const { scanScope } = await prompts({
 		type: "select",
 		name: "scanScope",
-		message: "Select",
+		message: "Choose what to scan",
 		choices: [{
 			title: "Full codebase",
 			value: "full"
@@ -7709,7 +7705,7 @@ const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 	}
 	if (packages.length === 0) return [rootDirectory];
 	if (packages.length === 1) {
-		cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages[0].name}`);
+		cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages[0].name}`);
 		return [packages[0].directory];
 	}
 	if (projectFlag) return resolveProjectFlag(projectFlag, packages);
@@ -7733,13 +7729,13 @@ const resolveProjectFlag = (projectFlag, workspacePackages) => {
 	return resolvedDirectories;
 };
 const printDiscoveredProjects = (packages) => {
-	cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
+	cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
 };
 const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	const { selectedDirectories } = await prompts({
 		type: "multiselect",
 		name: "selectedDirectories",
-		message: "Select projects to scan",
+		message: "Select projects",
 		choices: workspacePackages.map((workspacePackage) => ({
 			title: workspacePackage.name,
 			description: path.relative(rootDirectory, workspacePackage.directory),
@@ -7996,13 +7992,13 @@ const inspectAction = async (directory, flags) => {
 		});
 		const setupProjectRoot = resolveInstallSetupProjectRoot({
 			scanRoot: resolvedDirectory,
-			completedScanDirectories: completedScans.map((scan) => scan.directory)
+			scanDirectories: projectDirectories
 		});
 		if (setupProjectRoot !== null) {
-			const hasScoredScan = completedScans.some((scan) => scan.result.score !== null);
+			const hasCompletedScan = completedScans.length > 0;
 			await promptInstallSetup({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				issueCount: filterDiagnosticsForSurface(allDiagnostics, scanOptions.outputSurface ?? "cli", userConfig).length,
 				isJsonMode,
 				isScoreOnly,
@@ -8011,7 +8007,7 @@ const inspectAction = async (directory, flags) => {
 			});
 			if (shouldShowAgentInstallHint({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				isJsonMode,
 				isScoreOnly,
 				isStaged: Boolean(flags.staged)
@@ -8643,8 +8639,12 @@ const installReactDoctorGitHook = (options) => {
 	return installDirectGitHook(options);
 };
 //#endregion
-//#region src/cli/utils/install-skill.ts
-var install_skill_exports = /* @__PURE__ */ __exportAll({ runInstallSkill: () => runInstallSkill });
+//#region src/cli/utils/install-react-doctor.ts
+var install_react_doctor_exports = /* @__PURE__ */ __exportAll({ runInstallReactDoctor: () => runInstallReactDoctor });
+const SETUP_OPTION_GIT_HOOK = "git-hook";
+const SETUP_OPTION_AGENT_HOOKS = "agent-hooks";
+const SETUP_OPTION_WORKFLOW = "workflow";
+const SETUP_OPTION_SKIP = "skip";
 const CONFIG_ONLY_GIT_HOOK_KINDS = new Set([
 	"ghooks",
 	"git-hooks-js",
@@ -8825,7 +8825,30 @@ const getSkillSourceDirectory = () => {
 	const distDirectory = path.dirname(fileURLToPath(import.meta.url));
 	return path.join(distDirectory, "skills", SKILL_NAME);
 };
-const runInstallSkill = async (options = {}) => {
+const canInstallNativeAgentHooks = (agents) => agents.some((agent) => agent === "claude-code" || agent === "cursor");
+const buildWorkflowContent = () => [
+	"name: React Doctor",
+	"",
+	"on:",
+	"  pull_request:",
+	"    branches: [main]",
+	"",
+	"permissions:",
+	"  contents: read",
+	"  pull-requests: write",
+	"",
+	"jobs:",
+	"  react-doctor:",
+	"    runs-on: ubuntu-latest",
+	"    steps:",
+	"      - uses: actions/checkout@v4",
+	"      - uses: millionco/react-doctor@main",
+	"        with:",
+	"          github-token: ${{ secrets.GITHUB_TOKEN }}",
+	"          diff: main",
+	""
+].join("\n");
+const runInstallReactDoctor = async (options = {}) => {
 	const requestedProjectRoot = options.projectRoot ?? process.cwd();
 	const projectRoot = findNearestPackageDirectory(requestedProjectRoot) ?? requestedProjectRoot;
 	const sourceDir = options.sourceDir ?? getSkillSourceDirectory();
@@ -8846,7 +8869,8 @@ const runInstallSkill = async (options = {}) => {
 	const gitHookTarget = options.gitHookPath === void 0 ? detectGitHookTarget(projectRoot) : options.gitHookPath === null ? null : buildManualGitHookTarget(options.gitHookPath, projectRoot);
 	const gitHookPath = gitHookTarget?.hookPath;
 	const promptOptions = options.onPromptCancel === void 0 ? {} : { onCancel: options.onPromptCancel };
-	const selectedAgents = skipPrompts ? detectedAgents : (await prompts({
+	const prompt = options.prompt ?? prompts;
+	const selectedAgents = skipPrompts ? detectedAgents : (await prompt({
 		type: "multiselect",
 		name: "agents",
 		message: `Install the ${highlighter.info(`/react-doctor`)} skill for:`,
@@ -8859,13 +8883,48 @@ const runInstallSkill = async (options = {}) => {
 		min: 1
 	}, promptOptions)).agents ?? [];
 	if (selectedAgents.length === 0) return;
-	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !skipPrompts && Boolean((await prompts({
-		type: "confirm",
-		name: "installGitHook",
-		message: "Check for issues before each commit?",
-		initial: true
-	}, promptOptions)).installGitHook));
-	const shouldInstallAgentHooks = Boolean(options.agentHooks);
+	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
+	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
+	const hasExistingWorkflows = existsSync(workflowsDirectory);
+	const canInstallWorkflow = !existsSync(workflowTargetPath);
+	const setupActionChoices = [
+		...gitHookPath === null || gitHookPath === void 0 ? [] : [{
+			title: "Pre-commit hook",
+			description: "Check staged changes before each commit",
+			value: SETUP_OPTION_GIT_HOOK,
+			selected: true
+		}],
+		...canInstallNativeAgentHooks(selectedAgents) ? [{
+			title: "Agent hooks",
+			description: "Ask Claude Code or Cursor to scan after code edits",
+			value: SETUP_OPTION_AGENT_HOOKS,
+			selected: Boolean(options.agentHooks)
+		}] : [],
+		...canInstallWorkflow ? [{
+			title: "GitHub Actions workflow",
+			description: "Scan pull requests in CI",
+			value: SETUP_OPTION_WORKFLOW,
+			selected: hasExistingWorkflows
+		}] : []
+	];
+	const setupChoices = setupActionChoices.length === 0 ? [] : [{
+		title: "Skip optional setup",
+		description: "Install only the agent skill and package setup",
+		value: SETUP_OPTION_SKIP,
+		selected: false
+	}, ...setupActionChoices];
+	const selectedSetupOptions = skipPrompts || setupChoices.length === 0 ? [] : (await prompt({
+		type: "multiselect",
+		name: "setupOptions",
+		message: "Select additional React Doctor setup:",
+		choices: setupChoices,
+		instructions: false
+	}, promptOptions)).setupOptions ?? [];
+	const selectedSetupActions = selectedSetupOptions.filter((setupOption) => setupOption !== SETUP_OPTION_SKIP);
+	const didSkipOptionalSetup = selectedSetupActions.length === 0 && selectedSetupOptions.includes(SETUP_OPTION_SKIP);
+	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_GIT_HOOK));
+	const shouldInstallAgentHooks = Boolean(options.agentHooks) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_AGENT_HOOKS);
+	const shouldInstallWorkflow = !skipPrompts && !didSkipOptionalSetup && canInstallWorkflow && selectedSetupActions.includes(SETUP_OPTION_WORKFLOW);
 	if (options.dryRun) {
 		cliLogger.log(`Dry run — would install ${SKILL_NAME} skill for:`);
 		for (const agent of selectedAgents) cliLogger.dim(`  - ${getSkillAgentConfig(agent).displayName}`);
@@ -8874,6 +8933,7 @@ const runInstallSkill = async (options = {}) => {
 		cliLogger.dim("  Dev dependency: react-doctor");
 		if (shouldInstallGitHook) cliLogger.dim(`  Git hook: ${gitHookPath}`);
 		if (shouldInstallAgentHooks) cliLogger.dim("  Agent hooks: Claude Code / Cursor when selected");
+		if (shouldInstallWorkflow) cliLogger.dim(`  GitHub Actions workflow: ${path.relative(projectRoot, workflowTargetPath)}`);
 		return;
 	}
 	const installSpinner = spinner(`Installing ${SKILL_NAME} skill...`).start();
@@ -8921,47 +8981,15 @@ const runInstallSkill = async (options = {}) => {
 			throw error;
 		}
 	}
-	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
-	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
-	if (!existsSync(workflowTargetPath) && !skipPrompts) {
-		const hasExistingWorkflows = existsSync(workflowsDirectory);
-		const { shouldInstallWorkflow } = await prompts({
-			type: "confirm",
-			name: "shouldInstallWorkflow",
-			message: "Add a GitHub Actions workflow to scan PRs?",
-			initial: hasExistingWorkflows
-		}, promptOptions);
-		if (shouldInstallWorkflow) {
-			if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
-			const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
-			try {
-				writeFileSync(workflowTargetPath, [
-					"name: React Doctor",
-					"",
-					"on:",
-					"  pull_request:",
-					"    branches: [main]",
-					"",
-					"permissions:",
-					"  contents: read",
-					"  pull-requests: write",
-					"",
-					"jobs:",
-					"  react-doctor:",
-					"    runs-on: ubuntu-latest",
-					"    steps:",
-					"      - uses: actions/checkout@v4",
-					"      - uses: millionco/react-doctor@main",
-					"        with:",
-					"          github-token: ${{ secrets.GITHUB_TOKEN }}",
-					"          diff: main",
-					""
-				].join("\n"));
-				workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
-			} catch (error) {
-				workflowSpinner.fail("Failed to add GitHub Actions workflow.");
-				throw error;
-			}
+	if (shouldInstallWorkflow) {
+		if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
+		const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
+		try {
+			writeFileSync(workflowTargetPath, buildWorkflowContent());
+			workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
+		} catch (error) {
+			workflowSpinner.fail("Failed to add GitHub Actions workflow.");
+			throw error;
 		}
 	}
 };
@@ -8971,7 +8999,7 @@ const installAction = async (options, command) => {
 	Effect.runSync(printBrandedHeader);
 	try {
 		const parentOptions = command?.parent?.opts?.();
-		await runInstallSkill({
+		await runInstallReactDoctor({
 			yes: options.yes ?? parentOptions?.yes,
 			dryRun: options.dryRun,
 			agentHooks: options.agentHooks,

package/dist/index.d.ts

@@ -232,7 +232,9 @@ interface ReactDoctorConfig {
    * `categories` field, but keyed by React Doctor's display
    * categories (`"Server"`, `"React Native"`, `"Architecture"`,
    * `"Bundle Size"`, `"State & Effects"`, `"Security"`,
-   * `"Accessibility"`, `"Performance"`, `"Correctness"`, …).
+   * `"Accessibility"`, `"Performance"`, `"Correctness"`,
+   * `"Next.js"`, `"Preact"`, `"TanStack Query"`,
+   * `"TanStack Start"`, …).
    *
    * ```json
    * { "categories": { "React Native": "warn", "Server": "off" } }
@@ -296,7 +298,7 @@ interface Diagnostic {
 }
 //#endregion
 //#region src/types/project-info.d.ts
-type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "unknown";
+type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "preact" | "unknown";
 interface ProjectInfo {
   rootDirectory: string;
   projectName: string;
@@ -307,6 +309,16 @@ interface ProjectInfo {
   hasTypeScript: boolean;
   hasReactCompiler: boolean;
   hasTanStackQuery: boolean;
+  /**
+   * `true` when `preact` is declared anywhere in the project's
+   * dependency manifest. Drives the `preact` capability in
+   * `buildCapabilities`, which gates every `preact-*` rule. Modeled
+   * on `hasTanStackQuery` rather than the `framework` field because
+   * the dominant Preact setup today is Preact-on-Vite — those
+   * projects classify as `framework: "vite"` for build-tool reasons
+   * but still need Preact-specific rules to fire.
+   */
+  hasPreact: boolean;
   /**
    * `true` when the project (or any of its workspace packages) declares
    * React Native or Expo as a dependency. Enables the `react-native`
@@ -321,6 +333,13 @@ interface ProjectInfo {
    * — no `rn-*` rules load for the project at all.
    */
   hasReactNativeWorkspace: boolean;
+  /**
+   * `true` when the project (or any of its workspace packages) declares
+   * `react-native-reanimated`. Lets diagnostics surface reanimated's
+   * Compiler-compatible `.get()` / `.set()` accessors only where they
+   * apply, instead of on every React Native project.
+   */
+  hasReanimated: boolean;
   sourceFileCount: number;
 }
 //#endregion