react-doctor 0.8.1-dev.f4aa821 → 0.8.1-dev.f5f13b8

package/dist/cli.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1b59ca76-9135-54e6-9391-ce7fec27b699")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="87efffda-8fc4-5b52-80e1-7ec503c85206")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
@@ -36022,44 +36022,6 @@ var AmbiguousProjectError = class extends Error {
 	}
 };
 const isProjectDiscoveryError = (value) => value instanceof ProjectNotFoundError || value instanceof NoReactDependencyError || value instanceof PackageJsonNotFoundError || value instanceof NotADirectoryError || value instanceof AmbiguousProjectError;
-const isErrnoException = (error) => error instanceof Error && "code" in error;
-const IGNORABLE_READDIR_ERROR_CODES = new Set([
-	"EACCES",
-	"EPERM",
-	"ENOENT",
-	"ENOTDIR",
-	"EINVAL",
-	"ELOOP",
-	"ENAMETOOLONG"
-]);
-const isIgnorableReaddirError = (error) => isErrnoException(error) && typeof error.code === "string" && IGNORABLE_READDIR_ERROR_CODES.has(error.code);
-const readDirectoryEntries = (directoryPath) => {
-	try {
-		return NFS.readdirSync(directoryPath, { withFileTypes: true });
-	} catch (error) {
-		if (isIgnorableReaddirError(error)) return [];
-		throw error;
-	}
-};
-const isFile = (filePath) => {
-	try {
-		return NFS.statSync(filePath).isFile();
-	} catch {
-		return false;
-	}
-};
-const isDirectory = (directoryPath) => {
-	try {
-		return NFS.statSync(directoryPath).isDirectory();
-	} catch {
-		return false;
-	}
-};
-const isPlainObject = (value) => {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
-	const prototype = Object.getPrototypeOf(value);
-	return prototype === null || prototype === Object.prototype;
-};
 const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?|mts|mjs)$/;
 const GENERATED_BUNDLE_FILE_PATTERN = /\.(iife|umd|global|min)\.m?js$/i;
 const GENERATED_SOURCE_DIRECTORY_PATTERN = /(?:^|\/)__generated__\//;
@@ -36101,6 +36063,58 @@ const IGNORED_DIRECTORIES = new Set([
 ]);
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
 const MILLISECONDS_PER_SECOND = 1e3;
+const REACT_ROUTER_CAPABILITY_THRESHOLDS = [
+	{
+		capability: "react-router:6.4",
+		major: 6,
+		minor: 4
+	},
+	{
+		capability: "react-router:6.7",
+		major: 6,
+		minor: 7
+	},
+	{
+		capability: "react-router:6.9",
+		major: 6,
+		minor: 9
+	},
+	{
+		capability: "react-router:6.19",
+		major: 6,
+		minor: 19
+	},
+	{
+		capability: "react-router:7",
+		major: 7,
+		minor: 0
+	},
+	{
+		capability: "react-router:7.8",
+		major: 7,
+		minor: 8
+	},
+	{
+		capability: "react-router:7.9",
+		major: 7,
+		minor: 9
+	},
+	{
+		capability: "react-router:7.10",
+		major: 7,
+		minor: 10
+	},
+	{
+		capability: "react-router:7.15",
+		major: 7,
+		minor: 15
+	},
+	{
+		capability: "react-router:8",
+		major: 8,
+		minor: 0
+	}
+];
 const SCORE_API_URL = "https://www.react.doctor/api/score";
 const ENTERPRISE_CONTACT_URL = "https://react.doctor/enterprise";
 const SHARE_BASE_URL = "https://react.doctor/share";
@@ -36252,6 +36266,44 @@ const SUPPLY_CHAIN_OVERLAP_TIMEOUT_MS = 9e4;
 const SUPPLY_CHAIN_CACHE_TTL_MS = 864e5;
 const SUPPLY_CHAIN_CACHE_SUBDIR = "supply-chain";
 const SUPPLY_CHAIN_IGNORED_PACKAGES = new Set(["next"]);
+const isErrnoException = (error) => error instanceof Error && "code" in error;
+const IGNORABLE_READDIR_ERROR_CODES = new Set([
+	"EACCES",
+	"EPERM",
+	"ENOENT",
+	"ENOTDIR",
+	"EINVAL",
+	"ELOOP",
+	"ENAMETOOLONG"
+]);
+const isIgnorableReaddirError = (error) => isErrnoException(error) && typeof error.code === "string" && IGNORABLE_READDIR_ERROR_CODES.has(error.code);
+const readDirectoryEntries = (directoryPath) => {
+	try {
+		return NFS.readdirSync(directoryPath, { withFileTypes: true });
+	} catch (error) {
+		if (isIgnorableReaddirError(error)) return [];
+		throw error;
+	}
+};
+const isFile = (filePath) => {
+	try {
+		return NFS.statSync(filePath).isFile();
+	} catch {
+		return false;
+	}
+};
+const isDirectory = (directoryPath) => {
+	try {
+		return NFS.statSync(directoryPath).isDirectory();
+	} catch {
+		return false;
+	}
+};
+const isPlainObject = (value) => {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === null || prototype === Object.prototype;
+};
 const lastSourceMappingUrl = (fileContent) => {
 	const lastReference = [...fileContent.matchAll(/\/\/# sourceMappingURL=(\S+)/g)].at(-1);
 	return lastReference ? lastReference[1] : null;
@@ -36571,10 +36623,10 @@ const FALLBACK_TSCONFIG_FILENAMES = ["tsconfig.app.json", "tsconfig.build.json"]
 const FRAMEWORK_PACKAGES = {
 	next: "nextjs",
 	"@tanstack/react-start": "tanstack-start",
-	vite: "vite",
-	"react-scripts": "cra",
 	"@remix-run/react": "remix",
 	gatsby: "gatsby",
+	vite: "vite",
+	"react-scripts": "cra",
 	expo: "expo",
 	"react-native": "react-native"
 };
@@ -36598,11 +36650,17 @@ const NEXT_CONFIG_FILENAMES = [
 ];
 const BABEL_CONFIG_FILENAMES = [
 	".babelrc",
+	".babelrc.js",
 	".babelrc.json",
+	".babelrc.cjs",
+	".babelrc.mjs",
+	".babelrc.cts",
 	"babel.config.js",
 	"babel.config.json",
 	"babel.config.cjs",
-	"babel.config.mjs"
+	"babel.config.mjs",
+	"babel.config.ts",
+	"babel.config.cts"
 ];
 const VITE_CONFIG_FILENAMES = [
 	"vite.config.js",
@@ -36614,12 +36672,28 @@ const VITE_CONFIG_FILENAMES = [
 	"vitest.config.ts",
 	"vitest.config.js"
 ];
+const RSBUILD_CONFIG_FILENAMES = [
+	"rsbuild.config.ts",
+	"rsbuild.config.js",
+	"rsbuild.config.mts",
+	"rsbuild.config.mjs",
+	"rsbuild.config.cts",
+	"rsbuild.config.cjs"
+];
+const RSPACK_CONFIG_FILENAMES = [
+	"rspack.config.ts",
+	"rspack.config.js",
+	"rspack.config.mts",
+	"rspack.config.mjs",
+	"rspack.config.cts",
+	"rspack.config.cjs"
+];
 const EXPO_APP_CONFIG_FILENAMES = [
 	"app.json",
 	"app.config.js",
 	"app.config.ts"
 ];
-const REACT_COMPILER_PACKAGE_REFERENCE_PATTERN = /babel-plugin-react-compiler|react-compiler-runtime|["']react-compiler["']/;
+const REACT_COMPILER_PACKAGE_REFERENCE_PATTERN = /babel-plugin-react-compiler|react-compiler-runtime|reactCompilerPreset\s*\(|["']react-compiler["']/;
 const REACT_COMPILER_ENABLED_FLAG_PATTERN = /["']?reactCompiler["']?\s*:\s*(?:true\b|\{)/;
 const STATIC_EXPORT_OUTPUT_PATTERN = /(?:^|[^.\w])["']?output["']?\s*:\s*["']export["']/m;
 const hasCompilerPackage = (packageJson, compilerPackages) => {
@@ -36654,6 +36728,8 @@ const detectReactCompiler = (directory, packageJson) => {
 	if (hasCompilerInConfigFiles(directory, NEXT_CONFIG_FILENAMES)) return true;
 	if (hasCompilerInConfigFiles(directory, BABEL_CONFIG_FILENAMES)) return true;
 	if (hasCompilerInConfigFiles(directory, VITE_CONFIG_FILENAMES)) return true;
+	if (hasCompilerInConfigFiles(directory, RSBUILD_CONFIG_FILENAMES)) return true;
+	if (hasCompilerInConfigFiles(directory, RSPACK_CONFIG_FILENAMES)) return true;
 	if (hasCompilerInConfigFiles(directory, EXPO_APP_CONFIG_FILENAMES)) return true;
 	return hasCompilerPackageInAncestors(directory, REACT_COMPILER_TRANSFORM_PACKAGES);
 };
@@ -36662,7 +36738,7 @@ const detectNextjsStaticExport = (directory) => NEXT_CONFIG_FILENAMES.some((file
 	const filePath = Path.join(directory, filename);
 	return isFile(filePath) && STATIC_EXPORT_OUTPUT_PATTERN.test(NFS.readFileSync(filePath, "utf-8"));
 });
-const UNRESOLVABLE_PROTOCOL_VERSION = /^(?:file|git|github|https?|link|patch|portal|workspace|npm):/i;
+const UNRESOLVABLE_PROTOCOL_VERSION = /^(?:catalog|file|git|github|https?|link|patch|portal|workspace|npm):/i;
 const DIST_TAG_VERSION = /^[a-z][a-z0-9._-]*$/i;
 const WILDCARD_VERSION = /^[*xX](?:\.[*xX])*$/;
 const NPM_ALIAS_VERSION = /^npm:(?:@[^/]+\/[^@]+|[^@]+)@(.+)$/i;
@@ -36795,6 +36871,16 @@ const getLowestDependencyMajor = (version) => {
 	}
 	return lowestMajor;
 };
+const getDependencyMajorWithinSupportedRange = (version, latestSupportedMajor) => {
+	const normalizedVersion = normalizeDependencyVersion(version);
+	if (normalizedVersion === null) return null;
+	const validRange = import_semver.validRange(normalizedVersion);
+	if (validRange === null) return null;
+	const minimumVersion = import_semver.minVersion(validRange);
+	if (minimumVersion === null || minimumVersion.major > latestSupportedMajor) return null;
+	if (import_semver.intersects(validRange, `>=${latestSupportedMajor + 1}.0.0`)) return null;
+	return minimumVersion.major;
+};
 const isConcreteDependencyVersion = (version) => {
 	const normalizedVersion = normalizeDependencyVersion(version);
 	return normalizedVersion !== null && /\d/.test(normalizedVersion);
@@ -36838,9 +36924,18 @@ const parseReactMajorMinor = (reactVersion) => {
 	};
 };
 const parseLowerBoundVersion = (versionSpec) => import_semver.validRange(versionSpec) !== null ? import_semver.minVersion(versionSpec) : import_semver.coerce(versionSpec);
-const parseTailwindMajorMinor = (tailwindVersion) => {
-	if (typeof tailwindVersion !== "string") return null;
-	const trimmed = tailwindVersion.trim();
+const parseThreeRelease = (threeVersion) => {
+	if (typeof threeVersion !== "string") return null;
+	const normalizedVersion = normalizeDependencyVersion(threeVersion);
+	if (normalizedVersion === null) return null;
+	const lowerBound = parseLowerBoundVersion(normalizedVersion);
+	if (lowerBound === null) return null;
+	if (lowerBound.major > 0) return Number.MAX_SAFE_INTEGER;
+	return lowerBound.minor > 0 ? lowerBound.minor : null;
+};
+const parseDependencyMajorMinor = (dependencyVersion) => {
+	if (typeof dependencyVersion !== "string") return null;
+	const trimmed = dependencyVersion.trim();
 	if (trimmed.length === 0) return null;
 	const lowerBound = parseLowerBoundVersion(trimmed);
 	if (lowerBound === null || lowerBound.major <= 0) return null;
@@ -36849,6 +36944,7 @@ const parseTailwindMajorMinor = (tailwindVersion) => {
 		minor: lowerBound.minor
 	};
 };
+const parseTailwindMajorMinor = (tailwindVersion) => parseDependencyMajorMinor(tailwindVersion);
 const hasUpperBoundOnlyPeerRange = (range) => {
 	if (typeof range !== "string") return false;
 	const normalizedRange = normalizeDependencyVersion(range);
@@ -36870,7 +36966,7 @@ const resolveEffectiveReactMajor = (reactVersion, packageJson) => {
 	if (peerFloor === null) return hasUpperBoundOnlyPeerRange(peerReactRange) ? null : installedReactMajor;
 	return installedReactMajor !== null ? Math.min(installedReactMajor, peerFloor) : peerFloor;
 };
-const isCatalogReference = (version) => version.startsWith("catalog:");
+const isCatalogReference = (version) => typeof version === "string" && version.startsWith("catalog:");
 const extractCatalogName = (version) => {
 	if (!isCatalogReference(version)) return null;
 	const name = version.slice(8).trim();
@@ -37020,6 +37116,12 @@ const TAILWIND_ZOD_SECTIONS = [
 	"devDependencies",
 	"peerDependencies"
 ];
+const DEPENDENCY_SPEC_SECTIONS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
 const EMPTY_DEPENDENCY_INFO = {
 	reactVersion: null,
 	tailwindVersion: null,
@@ -37029,7 +37131,7 @@ const EMPTY_DEPENDENCY_INFO = {
 const pickConcreteVersion = (packageJson, packageName, sections) => {
 	for (const section of sections) {
 		const version = packageJson[section]?.[packageName];
-		if (version === void 0) continue;
+		if (typeof version !== "string") continue;
 		if (isCatalogReference(version)) return null;
 		if (isConcreteDependencyVersion(version)) return version;
 	}
@@ -37061,13 +37163,16 @@ const extractDependencyInfo = (packageJson) => {
 	};
 };
 const getDependencySpec = (packageJson, packageName) => {
-	const spec = packageJson.dependencies?.[packageName] ?? packageJson.devDependencies?.[packageName] ?? packageJson.peerDependencies?.[packageName] ?? packageJson.optionalDependencies?.[packageName];
-	return typeof spec === "string" ? spec : null;
+	for (const section of DEPENDENCY_SPEC_SECTIONS) {
+		const spec = packageJson[section]?.[packageName];
+		if (typeof spec === "string") return spec;
+	}
+	return null;
 };
 const getDependencyDeclaration = ({ packageJson, packageName, sections }) => {
 	for (const section of sections) {
 		const version = packageJson[section]?.[packageName];
-		if (version === void 0) continue;
+		if (typeof version !== "string") continue;
 		return {
 			catalogReference: extractCatalogName(version) ?? null,
 			hasDeclaration: true,
@@ -37101,24 +37206,15 @@ const getPreactVersion = (packageJson) => {
 		...packageJson.devDependencies
 	}.preact ?? null;
 };
-const TANSTACK_QUERY_PACKAGES = new Set([
-	"@tanstack/react-query",
-	"@tanstack/query-core",
-	"react-query"
-]);
-const hasTanStackQuery = (packageJson) => {
-	const allDependencies = {
-		...packageJson.peerDependencies,
-		...packageJson.dependencies,
-		...packageJson.devDependencies
-	};
-	return Object.keys(allDependencies).some((packageName) => TANSTACK_QUERY_PACKAGES.has(packageName));
-};
-const resolveCatalogBackedDependencyVersion = ({ rootDirectory, rootPackageJson, packageName, version }) => {
+const resolveCatalogBackedDependencyVersion = ({ rootDirectory, rootPackageJson, packageName, sourceDirectory = rootDirectory, sourcePackageJson = rootPackageJson, version }) => {
 	if (version === null || !isCatalogReference(version)) return version;
 	const catalogName = extractCatalogName(version);
-	const resolvedLocalVersion = resolveCatalogVersion(rootPackageJson, packageName, rootDirectory, catalogName);
-	if (resolvedLocalVersion) return resolvedLocalVersion;
+	const resolvedSourceVersion = resolveCatalogVersion(sourcePackageJson, packageName, sourceDirectory, catalogName);
+	if (resolvedSourceVersion) return resolvedSourceVersion;
+	if (sourceDirectory !== rootDirectory || sourcePackageJson !== rootPackageJson) {
+		const resolvedRootVersion = resolveCatalogVersion(rootPackageJson, packageName, rootDirectory, catalogName);
+		if (resolvedRootVersion) return resolvedRootVersion;
+	}
 	const monorepoRoot = findMonorepoRoot(rootDirectory);
 	if (!monorepoRoot) return version;
 	const monorepoPackageJsonPath = Path.join(monorepoRoot, "package.json");
@@ -37316,7 +37412,84 @@ const listWorkspacePackages = (rootDirectory) => {
 	}
 	return packages;
 };
+const PREFERRED_DEPENDENCY_SECTIONS = [
+	"dependencies",
+	"peerDependencies",
+	"devDependencies"
+];
+const getPreferredDependencyVersion = ({ packageJson, packageNames }) => {
+	for (const packageName of packageNames) {
+		const declaration = getDependencyDeclaration({
+			packageJson,
+			packageName,
+			sections: PREFERRED_DEPENDENCY_SECTIONS
+		});
+		if (declaration.version !== null) return declaration.version;
+	}
+	return null;
+};
+const TANSTACK_REACT_QUERY_PACKAGES = ["@tanstack/react-query", "react-query"];
+const getTanStackQueryVersion = (packageJson) => {
+	return getPreferredDependencyVersion({
+		packageJson,
+		packageNames: TANSTACK_REACT_QUERY_PACKAGES
+	});
+};
+const STYLED_COMPONENTS_PACKAGES = ["styled-components"];
+const getStyledComponentsVersion = (packageJson) => {
+	return getPreferredDependencyVersion({
+		packageJson,
+		packageNames: STYLED_COMPONENTS_PACKAGES
+	});
+};
+const I18N_PACKAGES = [
+	"i18next",
+	"react-i18next",
+	"next-i18next",
+	"react-intl",
+	"next-intl",
+	"use-intl",
+	"@formatjs/intl",
+	"@lingui/core",
+	"@lingui/react",
+	"typesafe-i18n",
+	"@tolgee/react",
+	"react-intl-universal"
+];
+const hasI18nDependency = (packageJson) => {
+	const allDependencies = {
+		...packageJson.peerDependencies,
+		...packageJson.dependencies,
+		...packageJson.devDependencies,
+		...packageJson.optionalDependencies
+	};
+	return I18N_PACKAGES.some((packageName) => allDependencies[packageName] !== void 0);
+};
 const REANIMATED_DEPENDENCY_NAME = "react-native-reanimated";
+const MOBX_REACT_PACKAGE_NAME = "mobx-react";
+const MOBX_REACT_LITE_PACKAGE_NAME = "mobx-react-lite";
+const MOBX_STATE_TREE_PACKAGE_NAME = "mobx-state-tree";
+const MOBX_REACT_OBSERVER_PACKAGE_NAME = "mobx-react-observer";
+const REACT_THREE_FIBER_DEPENDENCY_NAMES = ["@react-three/fiber", "react-three-fiber"];
+const REACT_THREE_FIBER_SECTIONS = [
+	"dependencies",
+	"peerDependencies",
+	"optionalDependencies",
+	"devDependencies"
+];
+const THREE_DEPENDENCY_SECTIONS = [
+	"dependencies",
+	"peerDependencies",
+	"optionalDependencies",
+	"devDependencies"
+];
+const REACT_THREE_FIBER_ECOSYSTEM_DEPENDENCY_NAMES = [...REACT_THREE_FIBER_DEPENDENCY_NAMES, "@react-three/drei"];
+const THREE_DEPENDENCY_NAMES = [...REACT_THREE_FIBER_ECOSYSTEM_DEPENDENCY_NAMES, "three"];
+const REACT_ROUTER_DEPENDENCY_NAMES = [
+	"@react-router/dev",
+	"react-router-dom",
+	"react-router"
+];
 const SHOPIFY_FLASH_LIST_PACKAGE_NAME = "@shopify/flash-list";
 const resolveWorkspaceDependencyVersion = ({ concreteVersion, packageName, rootDirectory, rootPackageJson, sections, workspaceDirectory, workspacePackageJson }) => {
 	const dependencyDeclaration = getDependencyDeclaration({
@@ -37327,7 +37500,7 @@ const resolveWorkspaceDependencyVersion = ({ concreteVersion, packageName, rootD
 	if (!dependencyDeclaration.hasDeclaration) return null;
 	return concreteVersion ?? resolveCatalogVersion(workspacePackageJson, packageName, workspaceDirectory, dependencyDeclaration.catalogReference) ?? resolveCatalogVersion(rootPackageJson, packageName, rootDirectory, dependencyDeclaration.catalogReference);
 };
-const shouldReplaceReactVersion = (currentVersion, nextVersion) => {
+const shouldReplaceWithLowerMajor = (currentVersion, nextVersion) => {
 	if (!currentVersion) return true;
 	const currentMajor = parseReactMajor(currentVersion);
 	const nextMajor = parseReactMajor(nextVersion);
@@ -37335,6 +37508,70 @@ const shouldReplaceReactVersion = (currentVersion, nextVersion) => {
 	if (nextMajor === null) return false;
 	return nextMajor < currentMajor;
 };
+const shouldReplaceSupportedDependencyFact = (currentFact, nextFact, latestSupportedMajor) => {
+	if (currentFact.version === null) return true;
+	if (nextFact.version === null) return false;
+	const currentMajor = getLowestDependencyMajor(currentFact.version);
+	const nextMajor = getLowestDependencyMajor(nextFact.version);
+	if (currentMajor === null) return false;
+	if (nextMajor === null) return true;
+	if (currentMajor > latestSupportedMajor) return false;
+	if (nextMajor > latestSupportedMajor) return true;
+	return nextMajor < currentMajor;
+};
+const shouldReplaceStyledComponentsVersion = (currentVersion, nextVersion) => {
+	if (!currentVersion) return true;
+	const currentMajor = getLowestDependencyMajor(currentVersion);
+	const nextMajor = getLowestDependencyMajor(nextVersion);
+	if (currentMajor === null) return nextMajor !== null && nextMajor < 6;
+	if (nextMajor === null) return currentMajor >= 6;
+	return nextMajor < currentMajor;
+};
+const selectOldestDependencyVersion = (currentVersion, nextVersion) => {
+	if (currentVersion === null || nextVersion === null) return null;
+	const current = parseDependencyMajorMinor(currentVersion);
+	const next = parseDependencyMajorMinor(nextVersion);
+	if (current === null) return currentVersion;
+	if (next === null) return nextVersion;
+	if (next.major !== current.major) return next.major < current.major ? nextVersion : currentVersion;
+	return next.minor < current.minor ? nextVersion : currentVersion;
+};
+const shouldReplaceMobxFact = (currentFact, nextFact) => {
+	if (currentFact.sourceDirectory === null) return true;
+	if (currentFact.version === null) return false;
+	if (nextFact.version === null) return true;
+	const currentMajor = getDependencyMajorWithinSupportedRange(currentFact.version, 6);
+	const nextMajor = getDependencyMajorWithinSupportedRange(nextFact.version, 6);
+	if (currentMajor === null) return false;
+	if (nextMajor === null) return true;
+	return selectOldestDependencyVersion(currentFact.version, nextFact.version) === nextFact.version;
+};
+const collectBindingVersion = (facts, packageJson, directory, packageName) => {
+	const version = getDependencySpec(packageJson, packageName);
+	if (version === null) return;
+	const resolvedVersion = resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName,
+		version
+	});
+	if (packageName === MOBX_REACT_PACKAGE_NAME) {
+		facts.mobxReactVersion = facts.hasMobxReact ? selectOldestDependencyVersion(facts.mobxReactVersion, resolvedVersion) : resolvedVersion;
+		facts.hasMobxReact = true;
+		return;
+	}
+	facts.mobxReactLiteVersion = facts.hasMobxReactLite ? selectOldestDependencyVersion(facts.mobxReactLiteVersion, resolvedVersion) : resolvedVersion;
+	facts.hasMobxReactLite = true;
+};
+const shouldReplaceReactRouterVersion = (currentVersion, nextVersion) => {
+	if (currentVersion === null) return true;
+	const current = parseReactMajorMinor(currentVersion);
+	const next = parseReactMajorMinor(nextVersion);
+	if (current === null) return next !== null;
+	if (next === null) return false;
+	if (next.major !== current.major) return next.major < current.major;
+	return next.minor < current.minor;
+};
 const evaluateManifestFacts = (facts, packageJson, directory, rootDirectory, rootPackageJson) => {
 	if (facts.expo.version === null) {
 		const spec = getDependencySpec(packageJson, "expo");
@@ -37350,6 +37587,23 @@ const evaluateManifestFacts = (facts, packageJson, directory, rootDirectory, roo
 			sourceDirectory: directory
 		};
 	}
+	for (const packageName of REACT_ROUTER_DEPENDENCY_NAMES) {
+		const resolvedSpec = resolveCatalogBackedDependencyVersion({
+			rootDirectory,
+			rootPackageJson,
+			sourceDirectory: directory,
+			sourcePackageJson: packageJson,
+			packageName,
+			version: getDependencySpec(packageJson, packageName)
+		});
+		if (resolvedSpec === null || !shouldReplaceReactRouterVersion(facts.reactRouter.version, resolvedSpec)) continue;
+		facts.reactRouter = {
+			version: resolvedSpec,
+			sourceDirectory: directory,
+			packageName
+		};
+	}
+	facts.hasReactRouterFramework = facts.hasReactRouterFramework || getDependencySpec(packageJson, "@react-router/dev") !== null;
 	if (facts.shopifyFlashList.version === null) {
 		const spec = getDependencySpec(packageJson, SHOPIFY_FLASH_LIST_PACKAGE_NAME);
 		if (spec !== null) facts.shopifyFlashList = {
@@ -37357,6 +37611,36 @@ const evaluateManifestFacts = (facts, packageJson, directory, rootDirectory, roo
 			sourceDirectory: directory
 		};
 	}
+	const mobxSpec = getDependencySpec(packageJson, "mobx");
+	if (mobxSpec !== null) {
+		const nextMobxFact = {
+			version: resolveCatalogBackedDependencyVersion({
+				rootDirectory: directory,
+				rootPackageJson: packageJson,
+				packageName: "mobx",
+				version: mobxSpec
+			}),
+			sourceDirectory: directory
+		};
+		if (shouldReplaceMobxFact(facts.mobx, nextMobxFact)) facts.mobx = nextMobxFact;
+	}
+	collectBindingVersion(facts, packageJson, directory, MOBX_REACT_PACKAGE_NAME);
+	collectBindingVersion(facts, packageJson, directory, MOBX_REACT_LITE_PACKAGE_NAME);
+	facts.hasMobxStateTree = facts.hasMobxStateTree || getDependencySpec(packageJson, MOBX_STATE_TREE_PACKAGE_NAME) !== null;
+	facts.hasMobxReactObserver = facts.hasMobxReactObserver || getDependencySpec(packageJson, MOBX_REACT_OBSERVER_PACKAGE_NAME) !== null;
+	const zustandSpec = getDependencySpec(packageJson, "zustand");
+	if (zustandSpec !== null) {
+		const nextZustandFact = {
+			version: resolveCatalogBackedDependencyVersion({
+				rootDirectory: directory,
+				rootPackageJson: packageJson,
+				packageName: "zustand",
+				version: zustandSpec
+			}),
+			sourceDirectory: directory
+		};
+		if (shouldReplaceSupportedDependencyFact(facts.zustand, nextZustandFact, 5)) facts.zustand = nextZustandFact;
+	}
 	if (facts.reanimatedVersion === null) {
 		const spec = getDependencySpec(packageJson, REANIMATED_DEPENDENCY_NAME);
 		if (spec !== null) facts.reanimatedVersion = spec;
@@ -37365,6 +37649,52 @@ const evaluateManifestFacts = (facts, packageJson, directory, rootDirectory, roo
 		const spec = getDependencySpec(packageJson, "valtio");
 		if (spec !== null) facts.valtioVersion = spec;
 	}
+	facts.tanstackQueryVersion ??= getTanStackQueryVersion(packageJson);
+	const styledComponentsVersion = resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName: "styled-components",
+		version: getStyledComponentsVersion(packageJson)
+	});
+	if (styledComponentsVersion && shouldReplaceStyledComponentsVersion(facts.styledComponentsVersion, styledComponentsVersion)) facts.styledComponentsVersion = styledComponentsVersion;
+	facts.hasI18nLibrary = facts.hasI18nLibrary || hasI18nDependency(packageJson);
+	for (const packageName of REACT_THREE_FIBER_DEPENDENCY_NAMES) {
+		const version = resolveCatalogBackedDependencyVersion({
+			rootDirectory,
+			rootPackageJson,
+			sourceDirectory: directory,
+			sourcePackageJson: packageJson,
+			packageName,
+			version: getDependencyDeclaration({
+				packageName,
+				packageJson,
+				sections: REACT_THREE_FIBER_SECTIONS
+			}).version
+		});
+		if (version === null) continue;
+		if (shouldReplaceWithLowerMajor(facts.reactThreeFiber.version, version)) facts.reactThreeFiber = {
+			packageName,
+			version,
+			sourceDirectory: directory
+		};
+	}
+	const threeVersion = resolveCatalogBackedDependencyVersion({
+		rootDirectory,
+		rootPackageJson,
+		sourceDirectory: directory,
+		sourcePackageJson: packageJson,
+		packageName: "three",
+		version: getDependencyDeclaration({
+			packageName: "three",
+			packageJson,
+			sections: THREE_DEPENDENCY_SECTIONS
+		}).version
+	});
+	if (threeVersion !== null) {
+		const currentRelease = parseThreeRelease(facts.threeVersion);
+		const nextRelease = parseThreeRelease(threeVersion);
+		if (facts.threeVersion === null || nextRelease !== null && (currentRelease === null || nextRelease < currentRelease)) facts.threeVersion = threeVersion;
+	}
 	facts.hasReactNativeAwarePackage = facts.hasReactNativeAwarePackage || isPackageJsonReactNativeAware(packageJson);
 	facts.hasReanimatedAwarePackage = facts.hasReanimatedAwarePackage || isPackageJsonReanimatedAware(packageJson);
 	facts.hasSsrDependency = facts.hasSsrDependency || isPackageJsonSsrAware(packageJson);
@@ -37386,6 +37716,8 @@ const evaluateManifestFacts = (facts, packageJson, directory, rootDirectory, roo
 			if (currentRemotionMajorVersion === null || remotionMajorVersion < currentRemotionMajorVersion) facts.remotionVersion = resolvedRemotionVersion;
 		}
 	}
+	facts.hasThree = facts.hasThree || THREE_DEPENDENCY_NAMES.some((dependencyName) => getDependencySpec(packageJson, dependencyName) !== null);
+	facts.hasReactThreeFiber = facts.hasReactThreeFiber || REACT_THREE_FIBER_ECOSYSTEM_DEPENDENCY_NAMES.some((dependencyName) => getDependencySpec(packageJson, dependencyName) !== null);
 };
 const collectWorkspaceFacts = (rootDirectory, rootPackageJson, { collectReactGroup }) => {
 	const facts = {
@@ -37401,24 +37733,55 @@ const collectWorkspaceFacts = (rootDirectory, rootPackageJson, { collectReactGro
 			version: null,
 			sourceDirectory: null
 		},
+		reactRouter: {
+			version: null,
+			sourceDirectory: null,
+			packageName: null
+		},
 		shopifyFlashList: {
 			version: null,
 			sourceDirectory: null
 		},
 		valtioVersion: null,
+		mobx: {
+			version: null,
+			sourceDirectory: null
+		},
+		hasMobxReact: false,
+		mobxReactVersion: null,
+		hasMobxReactLite: false,
+		mobxReactLiteVersion: null,
+		hasMobxStateTree: false,
+		hasMobxReactObserver: false,
+		zustand: {
+			version: null,
+			sourceDirectory: null
+		},
+		tanstackQueryVersion: null,
+		styledComponentsVersion: null,
+		hasI18nLibrary: false,
 		hasReactNativeAwarePackage: false,
 		hasReanimatedAwarePackage: false,
 		hasSsrDependency: false,
 		hasRemotionDependency: false,
 		hasUnknownRemotionVersion: false,
 		remotionVersion: null,
+		hasThree: false,
+		threeVersion: null,
+		hasReactThreeFiber: false,
+		reactThreeFiber: {
+			packageName: null,
+			version: null,
+			sourceDirectory: null
+		},
+		hasReactRouterFramework: false,
 		reanimatedVersion: null
 	};
 	evaluateManifestFacts(facts, rootPackageJson, rootDirectory, rootDirectory, rootPackageJson);
 	let isReactGroupSettled = !collectReactGroup;
 	const visitedDirectories = /* @__PURE__ */ new Set();
 	for (const pattern of getWorkspacePatterns(rootDirectory, rootPackageJson)) {
-		const directories = [...resolveWorkspaceDirectories(rootDirectory, pattern)].sort();
+		const directories = resolveWorkspaceDirectories(rootDirectory, pattern).toSorted();
 		for (const workspaceDirectory of directories) {
 			if (visitedDirectories.has(workspaceDirectory)) continue;
 			visitedDirectories.add(workspaceDirectory);
@@ -37454,7 +37817,7 @@ const collectWorkspaceFacts = (rootDirectory, rootPackageJson, { collectReactGro
 				workspaceDirectory,
 				workspacePackageJson
 			});
-			if (reactVersion && shouldReplaceReactVersion(facts.reactVersion, reactVersion)) facts.reactVersion = reactVersion;
+			if (reactVersion && shouldReplaceWithLowerMajor(facts.reactVersion, reactVersion)) facts.reactVersion = reactVersion;
 			if (tailwindVersion && !facts.tailwindVersion) facts.tailwindVersion = tailwindVersion;
 			if (zodVersion && !facts.zodVersion) facts.zodVersion = zodVersion;
 			const settledReactMajor = parseReactMajor(facts.reactVersion);
@@ -37644,6 +38007,16 @@ const discoverProjectWithoutPackageJson = (directory) => {
 		tailwindVersion: null,
 		zodVersion: null,
 		zodMajorVersion: null,
+		mobxVersion: null,
+		mobxMajorVersion: null,
+		hasMobxReact: false,
+		mobxReactVersion: null,
+		hasMobxReactLite: false,
+		mobxReactLiteVersion: null,
+		hasMobxStateTree: false,
+		hasMobxReactObserver: false,
+		zustandVersion: null,
+		zustandMajorVersion: null,
 		framework: "unknown",
 		hasTypeScript: hasOwnTsConfig,
 		hasReactCompiler: false,
@@ -37654,12 +38027,23 @@ const discoverProjectWithoutPackageJson = (directory) => {
 		hasRemotion: false,
 		remotionVersion: null,
 		remotionMajorVersion: null,
+		hasI18nLibrary: false,
+		tanstackQueryVersion: null,
+		styledComponentsVersion: null,
+		hasThree: false,
+		threeVersion: null,
+		threeRelease: null,
+		hasReactThreeFiber: false,
+		reactThreeFiberVersion: null,
+		reactThreeFiberMajorVersion: null,
 		hasSsrDependency: false,
 		preactVersion: null,
 		preactMajorVersion: null,
 		hasReactNativeWorkspace: false,
 		nextjsVersion: null,
 		nextjsMajorVersion: null,
+		reactRouterVersion: null,
+		hasReactRouterFramework: false,
 		expoVersion: null,
 		shopifyFlashListVersion: null,
 		shopifyFlashListMajorVersion: null,
@@ -37752,6 +38136,12 @@ const discoverProject = (directory) => {
 		packageName: SHOPIFY_FLASH_LIST_PACKAGE_NAME,
 		version: workspaceFacts.shopifyFlashList.version
 	}) : null;
+	const zustandVersion = resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName: "zustand",
+		version: workspaceFacts.zustand.version
+	});
 	const hasReanimated = hasReactNativeWorkspace && workspaceFacts.hasReanimatedAwarePackage;
 	const reanimatedVersion = hasReanimated ? workspaceFacts.reanimatedVersion : null;
 	const nextjsVersion = framework === "nextjs" ? resolveCatalogBackedDependencyVersion({
@@ -37766,8 +38156,33 @@ const discoverProject = (directory) => {
 		packageName: "valtio",
 		version: workspaceFacts.valtioVersion
 	});
+	const mobxVersion = resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName: "mobx",
+		version: workspaceFacts.mobx.version
+	});
+	const reactRouterVersion = workspaceFacts.reactRouter.packageName === null ? null : resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName: workspaceFacts.reactRouter.packageName,
+		version: workspaceFacts.reactRouter.version
+	});
 	const preactVersion = getPreactVersion(packageJson);
 	const remotionVersion = workspaceFacts.remotionVersion;
+	const tanstackQueryVersion = getTanStackQueryVersion(packageJson) ?? workspaceFacts.tanstackQueryVersion;
+	const reactThreeFiberVersion = workspaceFacts.reactThreeFiber.packageName ? resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName: workspaceFacts.reactThreeFiber.packageName,
+		version: workspaceFacts.reactThreeFiber.version
+	}) : null;
+	const threeVersion = resolveCatalogBackedDependencyVersion({
+		rootDirectory: directory,
+		rootPackageJson: packageJson,
+		packageName: "three",
+		version: workspaceFacts.threeVersion
+	});
 	const isPreES2023Target = hasTypeScript && detectPreES2023Target(directory);
 	const projectInfo = {
 		rootDirectory: directory,
@@ -37777,22 +38192,43 @@ const discoverProject = (directory) => {
 		tailwindVersion,
 		zodVersion,
 		zodMajorVersion: zodVersion === null ? null : getLowestDependencyMajor(zodVersion),
+		mobxVersion,
+		mobxMajorVersion: mobxVersion === null ? null : getDependencyMajorWithinSupportedRange(mobxVersion, 6),
+		hasMobxReact: workspaceFacts.hasMobxReact,
+		mobxReactVersion: workspaceFacts.mobxReactVersion,
+		hasMobxReactLite: workspaceFacts.hasMobxReactLite,
+		mobxReactLiteVersion: workspaceFacts.mobxReactLiteVersion,
+		hasMobxStateTree: workspaceFacts.hasMobxStateTree,
+		hasMobxReactObserver: workspaceFacts.hasMobxReactObserver,
+		zustandVersion,
+		zustandMajorVersion: zustandVersion === null ? null : getLowestDependencyMajor(zustandVersion),
 		framework,
 		hasTypeScript,
 		hasReactCompiler: detectReactCompiler(directory, packageJson),
 		hasReactCompilerLintPlugin: detectReactCompilerLintPlugin(directory, packageJson),
-		hasTanStackQuery: hasTanStackQuery(packageJson),
+		hasTanStackQuery: tanstackQueryVersion !== null,
+		hasI18nLibrary: workspaceFacts.hasI18nLibrary,
+		tanstackQueryVersion,
+		styledComponentsVersion: workspaceFacts.styledComponentsVersion,
 		valtioVersion,
 		valtioMajorVersion: valtioVersion === null ? null : getLowestDependencyMajor(valtioVersion),
 		hasRemotion: workspaceFacts.hasRemotionDependency,
 		remotionVersion,
 		remotionMajorVersion: remotionVersion === null ? null : getLowestDependencyMajor(remotionVersion),
+		hasThree: workspaceFacts.hasThree,
+		threeVersion,
+		threeRelease: parseThreeRelease(threeVersion),
+		hasReactThreeFiber: workspaceFacts.hasReactThreeFiber,
+		reactThreeFiberVersion,
+		reactThreeFiberMajorVersion: reactThreeFiberVersion === null ? null : getLowestDependencyMajor(reactThreeFiberVersion),
 		hasSsrDependency: workspaceFacts.hasSsrDependency,
 		preactVersion,
 		preactMajorVersion: parseReactMajor(preactVersion),
 		hasReactNativeWorkspace,
 		nextjsVersion,
 		nextjsMajorVersion: nextjsVersion === null ? null : getLowestDependencyMajor(nextjsVersion),
+		reactRouterVersion,
+		hasReactRouterFramework: workspaceFacts.hasReactRouterFramework,
 		expoVersion,
 		shopifyFlashListVersion,
 		shopifyFlashListMajorVersion: shopifyFlashListVersion === null ? null : getLowestDependencyMajor(shopifyFlashListVersion),
@@ -41096,10 +41532,10 @@ const SSR_FRAMEWORKS = new Set([
 	"gatsby",
 	"tanstack-start"
 ]);
-const addMajorLadder = (capabilities, name, major, earliest, latest) => {
-	if (major === null) return;
-	const cappedMajor = Math.min(major, latest);
-	for (let candidate = earliest; candidate <= cappedMajor; candidate += 1) capabilities.add(`${name}:${candidate}`);
+const addVersionCapabilityLadder = (capabilities, name, detectedVersion, earliest, latest) => {
+	if (detectedVersion === null) return;
+	const cappedVersion = Math.min(detectedVersion, latest);
+	for (let candidate = earliest; candidate <= cappedVersion; candidate += 1) capabilities.add(`${name}:${candidate}`);
 };
 const buildCapabilities = (project) => {
 	const capabilities = /* @__PURE__ */ new Set();
@@ -41112,30 +41548,86 @@ const buildCapabilities = (project) => {
 	if (CLIENT_ONLY_FRAMEWORKS.has(project.framework)) capabilities.add("client-only");
 	if (project.isStaticExport) capabilities.add("nextjs:static-export");
 	if (project.nextjsMajorVersion !== null && project.nextjsMajorVersion >= 15) capabilities.add("nextjs:15");
-	addMajorLadder(capabilities, "react", project.reactMajorVersion, 17, 30);
+	if (project.nextjsMajorVersion !== null && project.nextjsMajorVersion >= 16) capabilities.add("nextjs:16");
+	const reactRouterVersion = project.reactRouterVersion ?? null;
+	if (reactRouterVersion !== null) {
+		capabilities.add("react-router");
+		if (project.hasReactRouterFramework === true) capabilities.add("react-router-framework");
+		const detectedVersion = parseReactMajorMinor(reactRouterVersion);
+		if (detectedVersion !== null) {
+			for (const threshold of REACT_ROUTER_CAPABILITY_THRESHOLDS) if (isMajorMinorAtLeast(detectedVersion, threshold)) capabilities.add(threshold.capability);
+		}
+	}
+	addVersionCapabilityLadder(capabilities, "react", project.reactMajorVersion, 17, 30);
 	if (project.reactMajorVersion !== null && project.reactMajorVersion >= 19 && isMajorMinorAtLeast(parseReactMajorMinor(project.reactVersion), {
 		major: 19,
 		minor: 2
 	})) capabilities.add("react:19.2");
-	if (project.tailwindVersion !== null) capabilities.add("tailwind");
-	if (project.tailwindVersion !== null && isMajorMinorAtLeast(parseTailwindMajorMinor(project.tailwindVersion), {
-		major: 3,
-		minor: 4
-	})) capabilities.add("tailwind:3.4");
+	if (project.tailwindVersion !== null) {
+		capabilities.add("tailwind");
+		const tailwindVersion = parseTailwindMajorMinor(project.tailwindVersion);
+		if (isMajorMinorAtLeast(tailwindVersion, {
+			major: 3,
+			minor: 4
+		})) capabilities.add("tailwind:3.4");
+		if (tailwindVersion !== null && isMajorMinorAtLeast(tailwindVersion, {
+			major: 4,
+			minor: 0
+		})) capabilities.add("tailwind:4");
+	}
 	if (project.zodVersion !== null) capabilities.add("zod");
 	if (project.zodMajorVersion !== null && project.zodMajorVersion >= 4) capabilities.add("zod:4");
+	if (project.mobxVersion !== void 0 && project.mobxVersion !== null || project.hasMobxReact === true || project.hasMobxReactLite === true || project.hasMobxStateTree === true || project.hasMobxReactObserver === true) capabilities.add("mobx");
+	if (project.hasMobxReact === true) capabilities.add("mobx-react");
+	if (project.hasMobxReactLite === true) capabilities.add("mobx-react-lite");
+	if (project.hasMobxReact === true || project.hasMobxReactLite === true) capabilities.add("mobx-react-binding");
+	const mobxReactVersion = parseDependencyMajorMinor(project.mobxReactVersion);
+	const mobxReactLiteVersion = parseDependencyMajorMinor(project.mobxReactLiteVersion);
+	const hasMobxReactObserverMemoGuard = mobxReactVersion !== null && isMajorMinorAtLeast(mobxReactVersion, {
+		major: 7,
+		minor: 3
+	});
+	const hasMobxReactLiteObserverMemoGuard = mobxReactLiteVersion !== null && isMajorMinorAtLeast(mobxReactLiteVersion, {
+		major: 3,
+		minor: 3
+	});
+	if (hasMobxReactObserverMemoGuard) capabilities.add("mobx-react-observer-memo-guard");
+	if (hasMobxReactLiteObserverMemoGuard) capabilities.add("mobx-react-lite-observer-memo-guard");
+	if (hasMobxReactObserverMemoGuard || hasMobxReactLiteObserverMemoGuard) capabilities.add("mobx-react-binding-observer-memo-guard");
+	if (project.hasMobxStateTree === true) capabilities.add("mobx-state-tree");
+	if (project.hasMobxReactObserver === true) capabilities.add("mobx-react-observer");
+	if (project.mobxMajorVersion !== void 0 && project.mobxMajorVersion !== null && project.mobxMajorVersion >= 4 && project.mobxMajorVersion <= 6) addVersionCapabilityLadder(capabilities, "mobx", project.mobxMajorVersion, 4, 6);
+	const mobxVersion = parseDependencyMajorMinor(project.mobxVersion);
+	if (project.mobxMajorVersion === 6 && mobxVersion !== null && isMajorMinorAtLeast(mobxVersion, {
+		major: 6,
+		minor: 10
+	})) capabilities.add("mobx:6.10");
+	if (project.zustandVersion !== void 0 && project.zustandVersion !== null) capabilities.add("zustand");
+	if (project.zustandMajorVersion !== void 0 && project.zustandMajorVersion !== null && project.zustandMajorVersion >= 1 && project.zustandMajorVersion <= 5) addVersionCapabilityLadder(capabilities, "zustand", project.zustandMajorVersion, 1, 5);
 	if (project.isPreES2023Target) capabilities.add("pre-es2023");
 	if (project.hasReactCompiler) capabilities.add("react-compiler");
-	if (project.hasTanStackQuery) capabilities.add("tanstack-query");
+	if (Boolean(project.hasTanStackQuery) || Boolean(project.tanstackQueryVersion)) capabilities.add("tanstack-query");
+	if (project.styledComponentsVersion) {
+		capabilities.add("styled-components");
+		const styledComponentsMajor = getLowestDependencyMajor(project.styledComponentsVersion);
+		if (styledComponentsMajor !== null && styledComponentsMajor >= 6) capabilities.add("styled-components:6");
+	}
+	if (project.hasI18nLibrary) capabilities.add("i18n");
 	if (project.valtioVersion !== null) capabilities.add("valtio");
-	addMajorLadder(capabilities, "valtio", project.valtioMajorVersion, 1, 10);
+	addVersionCapabilityLadder(capabilities, "valtio", project.valtioMajorVersion, 1, 10);
 	if (project.hasRemotion) {
 		capabilities.add("remotion");
-		addMajorLadder(capabilities, "remotion", project.remotionMajorVersion ?? null, 4, 30);
+		addVersionCapabilityLadder(capabilities, "remotion", project.remotionMajorVersion ?? null, 4, 30);
+	}
+	if (project.hasThree || project.hasReactThreeFiber) capabilities.add("three");
+	addVersionCapabilityLadder(capabilities, "three", project.threeRelease ?? null, 145, 250);
+	if (project.hasReactThreeFiber) {
+		capabilities.add("r3f");
+		addVersionCapabilityLadder(capabilities, "r3f", project.reactThreeFiberMajorVersion ?? null, 3, 10);
 	}
 	if (project.hasTypeScript) capabilities.add("typescript");
 	if (project.preactVersion !== null) capabilities.add("preact");
-	addMajorLadder(capabilities, "preact", project.preactMajorVersion, 10, 20);
+	addVersionCapabilityLadder(capabilities, "preact", project.preactMajorVersion, 10, 20);
 	if (project.preactVersion !== null && project.reactVersion === null) capabilities.add("pure-preact");
 	return capabilities;
 };
@@ -41147,7 +41639,7 @@ const getCapabilities = (project) => {
 	capabilitiesByProject.set(project, capabilities);
 	return capabilities;
 };
-const shouldEnableRule = (requires, tags, capabilities, ignoredTags, disabledWhen) => {
+const shouldEnableRule = (requires, tags, capabilities, ignoredTags, disabledWhen, includedTags) => {
 	if (requires) {
 		for (const capability of requires) if (!capabilities.has(capability)) return false;
 	}
@@ -41158,20 +41650,29 @@ const shouldEnableRule = (requires, tags, capabilities, ignoredTags, disabledWhe
 	if (tags) {
 		for (const tag of tags) if (ignoredTags.has(tag)) return false;
 	}
+	if (includedTags && includedTags.size > 0) {
+		if (!tags?.some((tag) => includedTags.has(tag))) return false;
+	}
 	return true;
 };
+const shouldEnableRuleByDefaultStatus = (options) => options.defaultEnabled !== false || options.hasExplicitOverride === true || options.includeTagDefaults && options.hasIncludedTags;
 const yieldToEventLoop = () => new Promise((resolve) => {
 	setImmediate(resolve);
 });
 const createSecurityScanSession = (rootDirectory, options) => {
 	const capabilities = options.project ? getCapabilities(options.project) : /* @__PURE__ */ new Set();
 	const ignoredTags = options.ignoredTags ?? /* @__PURE__ */ new Set();
+	const includedTags = options.includedTags ?? /* @__PURE__ */ new Set();
 	const enabledScanRules = REACT_DOCTOR_RULES.flatMap((entry) => {
 		const rule = entry.rule;
 		const scan = rule.scan;
 		if (typeof scan !== "function") return [];
-		if (rule.defaultEnabled === false) return [];
-		if (!shouldEnableRule(rule.requires, rule.tags, capabilities, ignoredTags, rule.disabledWhen)) return [];
+		if (!shouldEnableRuleByDefaultStatus({
+			defaultEnabled: rule.defaultEnabled,
+			includeTagDefaults: options.includeTagDefaults === true,
+			hasIncludedTags: includedTags.size > 0
+		})) return [];
+		if (!shouldEnableRule(rule.requires, rule.tags, capabilities, ignoredTags, rule.disabledWhen, includedTags)) return [];
 		return [{
 			entry,
 			scan,
@@ -43173,8 +43674,9 @@ const buildUserPluginRules = (userPlugin, severityControls) => {
 	}
 	return enabled;
 };
-const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, extendsPaths = [], ignoredTags = /* @__PURE__ */ new Set(), serverAuthFunctionNames, severityControls, userPlugins = [], disableReactHooksJsPlugin = false, ruleSelection, sidecarRuleIdFilter }) => {
-	const reactHooksJsPlugin = disableReactHooksJsPlugin || ruleSelection === "sidecar" ? null : resolveReactHooksJsPlugin(project.hasReactCompiler || project.hasReactCompilerLintPlugin === true, customRulesOnly);
+const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, extendsPaths = [], ignoredTags = /* @__PURE__ */ new Set(), includedTags = /* @__PURE__ */ new Set(), includeTagDefaults = false, serverAuthFunctionNames, severityControls, userPlugins = [], disableReactHooksJsPlugin = false, ruleSelection, sidecarRuleIdFilter }) => {
+	const hasIncludedTags = includedTags.size > 0;
+	const reactHooksJsPlugin = disableReactHooksJsPlugin || ruleSelection === "sidecar" || hasIncludedTags ? null : resolveReactHooksJsPlugin(project.hasReactCompiler || project.hasReactCompilerLintPlugin === true, customRulesOnly);
 	const reactCompilerRules = reactHooksJsPlugin ? applyRuleSeverityControls(filterRulesToAvailable(REACT_COMPILER_RULES, "react-hooks-js", reactHooksJsPlugin.availableRuleNames), severityControls) : {};
 	const jsPlugins = [];
 	if (reactHooksJsPlugin) jsPlugins.push(reactHooksJsPlugin.entry);
@@ -43189,9 +43691,14 @@ const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, exte
 		if (rule.scan !== void 0) continue;
 		if (customRulesOnly && registryEntry.originallyExternal) continue;
 		if (rule.framework !== "global" && !rule.requires) continue;
-		if (!shouldEnableRule(rule.requires, rule.tags, capabilities, ignoredTags, rule.disabledWhen)) continue;
+		if (!shouldEnableRule(rule.requires, rule.tags, capabilities, ignoredTags, rule.disabledWhen, includedTags)) continue;
 		const explicitRuleOverride = resolveRuleSeverityOverride({ ruleKey: registryEntry.key }, severityControls);
-		if (rule.defaultEnabled === false && explicitRuleOverride === void 0) continue;
+		if (!shouldEnableRuleByDefaultStatus({
+			defaultEnabled: rule.defaultEnabled,
+			includeTagDefaults,
+			hasIncludedTags,
+			hasExplicitOverride: explicitRuleOverride !== void 0
+		})) continue;
 		const severity = resolveRuleSeverityOverride({
 			ruleKey: registryEntry.key,
 			category: rule.category
@@ -43200,7 +43707,7 @@ const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, exte
 		enabledReactDoctorRules[registryEntry.key] = severity;
 	}
 	const userPluginRules = {};
-	if (ruleSelection !== "sidecar") for (const userPlugin of userPlugins) {
+	if (ruleSelection !== "sidecar" && !hasIncludedTags) for (const userPlugin of userPlugins) {
 		Object.assign(userPluginRules, buildUserPluginRules(userPlugin, severityControls));
 		jsPlugins.push(userPlugin.entry);
 	}
@@ -43417,6 +43924,19 @@ const createSidecarLintCache = (cacheDirectory, rulesetHash) => {
 		}
 	};
 };
+const fingerprintCacheByFilePath = /* @__PURE__ */ new Map();
+const fingerprintFileContents = (filePath, fingerprintLength) => {
+	const fileStats = NFS.statSync(filePath, { bigint: true });
+	const cachedFingerprint = fingerprintCacheByFilePath.get(filePath);
+	if (cachedFingerprint?.modifiedTimeNanoseconds === fileStats.mtimeNs && cachedFingerprint.sizeBytes === fileStats.size) return cachedFingerprint.fingerprint;
+	const fingerprint = crypto.createHash("sha256").update(NFS.readFileSync(filePath)).digest("hex").slice(0, fingerprintLength);
+	fingerprintCacheByFilePath.set(filePath, {
+		fingerprint,
+		modifiedTimeNanoseconds: fileStats.mtimeNs,
+		sizeBytes: fileStats.size
+	});
+	return fingerprint;
+};
 const bundledRequire$3 = createRequire(import.meta.url);
 const childNodeVersionByBinaryPath = /* @__PURE__ */ new Map();
 const resolveChildNodeVersion = (nodeBinaryPath) => {
@@ -43440,6 +43960,13 @@ const TOOLCHAIN_PACKAGE_SPECIFIERS$1 = [
 	"oxlint-plugin-react-doctor/package.json",
 	"eslint-plugin-react-hooks/package.json"
 ];
+const resolvePluginFingerprint = () => {
+	try {
+		return fingerprintFileContents(bundledRequire$3.resolve("oxlint-plugin-react-doctor"), 16);
+	} catch {
+		return "unresolved";
+	}
+};
 const resolveOxlintToolchainVersions = (nodeBinaryPath = process.execPath) => {
 	const versions = [`node=${resolveChildNodeVersion(nodeBinaryPath)}`];
 	for (const specifier of TOOLCHAIN_PACKAGE_SPECIFIERS$1) try {
@@ -43449,6 +43976,7 @@ const resolveOxlintToolchainVersions = (nodeBinaryPath = process.execPath) => {
 	} catch {
 		versions.push(`${specifier}=missing`);
 	}
+	versions.push(`oxlint-plugin-react-doctor#fingerprint=${resolvePluginFingerprint()}`);
 	return versions;
 };
 const esmRequire = createRequire(import.meta.url);
@@ -44924,7 +45452,7 @@ const reactHooksJsPluginDropNote = (error) => {
 *   6. always restore disable directives + clean up the temp dir
 */
 const runOxlint = async (options) => {
-	const { rootDirectory, project, includePaths, nodeBinaryPath = process.execPath, customRulesOnly = false, respectInlineDisables = true, adoptExistingLintConfig = true, ignoredTags = /* @__PURE__ */ new Set(), userConfig, configSourceDirectory = rootDirectory, onPartialFailure, onFileCoverage, perFileLintCacheEnabled = false, sidecarLintCacheEnabled = false, onCacheStats, onSidecarStats, spawnTimeoutMs, outputMaxBytes, lintBatchOrdering = "cost" } = options;
+	const { rootDirectory, project, includePaths, nodeBinaryPath = process.execPath, customRulesOnly = false, respectInlineDisables = true, adoptExistingLintConfig = true, ignoredTags = /* @__PURE__ */ new Set(), includedTags = /* @__PURE__ */ new Set(), includeTagDefaults = false, userConfig, configSourceDirectory = rootDirectory, onPartialFailure, onFileCoverage, perFileLintCacheEnabled = false, sidecarLintCacheEnabled = false, onCacheStats, onSidecarStats, spawnTimeoutMs, outputMaxBytes, lintBatchOrdering = "cost" } = options;
 	const serverAuthFunctionNames = Array.isArray(userConfig?.serverAuthFunctionNames) ? userConfig.serverAuthFunctionNames.filter((entry) => typeof entry === "string" && entry.length > 0) : void 0;
 	const severityControls = buildRuleSeverityControls(userConfig);
 	validateRuleRegistration();
@@ -44938,13 +45466,15 @@ const runOxlint = async (options) => {
 	}
 	const pluginPath = resolvePluginPath();
 	const extendsPaths = (adoptExistingLintConfig && !customRulesOnly ? detectUserLintConfigPaths(rootDirectory) : []).filter(canOxlintExtendConfig);
-	const userPlugins = resolveUserPlugins(userConfig?.plugins, configSourceDirectory);
+	const userPlugins = includedTags.size > 0 ? [] : resolveUserPlugins(userConfig?.plugins, configSourceDirectory);
 	const buildConfig = (overrides) => createOxlintConfig({
 		pluginPath,
 		project,
 		customRulesOnly,
 		extendsPaths: overrides.extendsPaths,
 		ignoredTags,
+		includedTags,
+		includeTagDefaults,
 		serverAuthFunctionNames,
 		severityControls,
 		userPlugins,
@@ -45333,6 +45863,8 @@ var Linter = class Linter extends Service()("react-doctor/Linter") {
 				respectInlineDisables: input.respectInlineDisables,
 				adoptExistingLintConfig: input.adoptExistingLintConfig,
 				ignoredTags: input.ignoredTags,
+				includedTags: input.includedTags,
+				includeTagDefaults: input.includeTagDefaults,
 				userConfig: input.userConfig ?? null,
 				configSourceDirectory: input.configSourceDirectory,
 				onPartialFailure: (reason) => {
@@ -46181,7 +46713,9 @@ const runInspect = (input, hooks = {}) => gen(function* () {
 	const securityScanFailedRef = yield* make$13(false);
 	const securityScanFiber = yield* forkChild(runCollect(applyPerElementPipeline(isDiffMode ? empty$4 : unwrap(tryPromise(() => checkSecurityScanCooperative(scanDirectory, {
 		project,
-		ignoredTags: input.ignoredTags
+		ignoredTags: input.ignoredTags,
+		includedTags: input.includedTags,
+		includeTagDefaults: input.includeTagDefaults
 	})).pipe(map$3((diagnostics) => fromIterable$1(diagnostics)), catch_$1(() => set(securityScanFailedRef, true).pipe(as(empty$4))))))).pipe(withSpan("SecurityScan.run")));
 	const shouldRunSupplyChain = !isDiffMode || (input.supplyChainManifestChanged ?? false);
 	const supplyChainOverlapTimeout = yield* SupplyChainOverlapTimeoutMs;
@@ -46272,6 +46806,8 @@ const runInspect = (input, hooks = {}) => gen(function* () {
 		respectInlineDisables: input.respectInlineDisables,
 		adoptExistingLintConfig: input.adoptExistingLintConfig,
 		ignoredTags: input.ignoredTags,
+		includedTags: input.includedTags,
+		includeTagDefaults: input.includeTagDefaults,
 		userConfig: resolvedConfig.config ?? void 0,
 		configSourceDirectory: resolvedConfig.configSourceDirectory ?? void 0,
 		onFileProgress: (scannedFileCount, totalFileCount) => {
@@ -47416,7 +47952,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.8.1-dev.f4aa821";
+const VERSION = "0.8.1-dev.f5f13b8";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -47503,7 +48039,11 @@ const getRunId = () => {
 };
 //#endregion
 //#region src/cli/utils/build-run-context.ts
-const ROOT_SUBCOMMANDS = new Set(["install", "setup"]);
+const ROOT_SUBCOMMANDS = new Set([
+	"design",
+	"install",
+	"setup"
+]);
 const detectInvokedVia = () => {
 	const userAgent = process.env.npm_config_user_agent;
 	if (!userAgent) return "unknown";
@@ -47587,7 +48127,9 @@ const buildSentryProjectContext = (projectInfo) => ({
 		reactMajorVersion: projectInfo.reactMajorVersion,
 		hasTypeScript: projectInfo.hasTypeScript,
 		hasReactCompiler: projectInfo.hasReactCompiler,
-		hasTanStackQuery: projectInfo.hasTanStackQuery,
+		tanstackQueryVersion: projectInfo.tanstackQueryVersion,
+		mobxVersion: projectInfo.mobxVersion,
+		styledComponentsVersion: projectInfo.styledComponentsVersion,
 		tailwindVersion: projectInfo.tailwindVersion,
 		zodVersion: projectInfo.zodVersion,
 		preactVersion: projectInfo.preactVersion,
@@ -47768,13 +48310,13 @@ const isDevVersion = (version) => version === "0.0.0" || version.includes("-");
 * uploads source-map artifacts under, so stack frames symbolicate. Honors the
 * standard `SENTRY_RELEASE` override.
 */
-const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.8.1-dev.f4aa821`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.8.1-dev.f5f13b8`;
 /**
 * Deployment environment shown in Sentry's environment filter. Defaults to
 * `production` for tagged releases and `development` for dev/unbuilt versions,
 * overridable via the standard `SENTRY_ENVIRONMENT` env var.
 */
-const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.8.1-dev.f4aa821") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.8.1-dev.f5f13b8") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -60100,6 +60642,8 @@ const buildScanResultCacheKey = (input) => {
 			warnings: input.options.warnings,
 			adoptExistingLintConfig: input.options.adoptExistingLintConfig,
 			ignoredTags: [...input.options.ignoredTags].sort(),
+			includedTags: [...input.options.includedTags].sort(),
+			includeTagDefaults: input.options.includeTagDefaults,
 			concurrency: input.options.concurrency,
 			lintBatchOrdering: resolveLintBatchOrdering(),
 			baselineRef: input.options.baseline?.ref,
@@ -60926,8 +61470,8 @@ const createDiagnosticEvidenceReader = (rootDirectory, options = {}) => {
 //#endregion
 //#region src/cli/utils/build-no-score-message.ts
 const ENTERPRISE_CONTACT_HINT = `Want something custom to your company? Contact us at ${ENTERPRISE_CONTACT_URL}.`;
-const buildNoScoreMessage = (isScoreDisabled) => {
-	return `${isScoreDisabled ? "Score disabled by --no-score." : "Score unavailable (could not reach the score API)."} ${ENTERPRISE_CONTACT_HINT}`;
+const buildNoScoreMessage = (isScoreDisabled, disabledMessage) => {
+	return `${isScoreDisabled ? disabledMessage ?? "Score disabled by --no-score." : "Score unavailable (could not reach the score API)."} ${ENTERPRISE_CONTACT_HINT}`;
 };
 //#endregion
 //#region src/cli/utils/render-agent-guidance.ts
@@ -62052,40 +62596,47 @@ const buildChangedLineMatcher = (directory, changedLineRanges) => {
 		return diagnosticIntersectsLineRanges(diagnostic, ranges);
 	};
 };
-const buildIgnoredTags = (userConfig) => {
+const buildIgnoredTags = (userConfig, includedTags) => {
 	const tags = /* @__PURE__ */ new Set();
 	if (userConfig?.ignore?.tags) for (const tag of userConfig.ignore.tags) tags.add(tag);
+	for (const tag of includedTags) tags.delete(tag);
 	return tags;
 };
-const mergeInspectOptions = (inputOptions, userConfig) => ({
-	lint: inputOptions.lint ?? userConfig?.lint ?? true,
-	deadCode: inputOptions.deadCode ?? userConfig?.deadCode ?? true,
-	supplyChain: inputOptions.supplyChain ?? userConfig?.supplyChain?.enabled ?? true,
-	verbose: inputOptions.verbose ?? userConfig?.verbose ?? false,
-	outputDirectory: inputOptions.outputDirectory || null,
-	scoreOnly: inputOptions.scoreOnly ?? false,
-	noScore: inputOptions.noScore ?? userConfig?.noScore ?? false,
-	isCi: inputOptions.isCi ?? false,
-	isCiOrCodingAgentEnvironment: isCiOrCodingAgentEnvironment(),
-	isNonInteractiveEnvironment: isNonInteractiveEnvironment(),
-	silent: inputOptions.silent ?? false,
-	includePaths: inputOptions.includePaths ?? [],
-	customRulesOnly: userConfig?.customRulesOnly ?? false,
-	share: userConfig?.share ?? true,
-	respectInlineDisables: inputOptions.respectInlineDisables ?? userConfig?.respectInlineDisables ?? true,
-	warnings: inputOptions.warnings ?? userConfig?.warnings ?? true,
-	categoryFilters: new Set(resolveCliCategories(inputOptions.categoryFilters) ?? []),
-	adoptExistingLintConfig: userConfig?.adoptExistingLintConfig ?? true,
-	ignoredTags: buildIgnoredTags(userConfig),
-	outputSurface: inputOptions.outputSurface ?? "cli",
-	suppressRendering: inputOptions.suppressRendering ?? false,
-	concurrentScan: inputOptions.concurrentScan ?? false,
-	concurrency: inputOptions.concurrency,
-	maxDurationMs: inputOptions.maxDurationMs ?? null,
-	baseline: inputOptions.baseline ?? null,
-	changedLineRanges: inputOptions.changedLineRanges ?? null,
-	supplyChainManifestChanged: inputOptions.supplyChainManifestChanged ?? false
-});
+const mergeInspectOptions = (inputOptions, userConfig) => {
+	const includedTags = inputOptions.includedTags ?? /* @__PURE__ */ new Set();
+	return {
+		lint: inputOptions.lint ?? userConfig?.lint ?? true,
+		deadCode: inputOptions.deadCode ?? userConfig?.deadCode ?? true,
+		supplyChain: inputOptions.supplyChain ?? userConfig?.supplyChain?.enabled ?? true,
+		verbose: inputOptions.verbose ?? userConfig?.verbose ?? false,
+		outputDirectory: inputOptions.outputDirectory || null,
+		scoreOnly: inputOptions.scoreOnly ?? false,
+		noScore: inputOptions.noScore ?? userConfig?.noScore ?? false,
+		isCi: inputOptions.isCi ?? false,
+		isCiOrCodingAgentEnvironment: isCiOrCodingAgentEnvironment(),
+		isNonInteractiveEnvironment: isNonInteractiveEnvironment(),
+		silent: inputOptions.silent ?? false,
+		includePaths: inputOptions.includePaths ?? [],
+		customRulesOnly: includedTags.size > 0 ? false : userConfig?.customRulesOnly ?? false,
+		share: userConfig?.share ?? true,
+		respectInlineDisables: inputOptions.respectInlineDisables ?? userConfig?.respectInlineDisables ?? true,
+		warnings: inputOptions.warnings ?? userConfig?.warnings ?? true,
+		categoryFilters: new Set(resolveCliCategories(inputOptions.categoryFilters) ?? []),
+		adoptExistingLintConfig: includedTags.size > 0 ? false : userConfig?.adoptExistingLintConfig ?? true,
+		ignoredTags: buildIgnoredTags(userConfig, includedTags),
+		includedTags,
+		includeTagDefaults: inputOptions.includeTagDefaults ?? false,
+		scoreDisabledMessage: inputOptions.scoreDisabledMessage,
+		outputSurface: inputOptions.outputSurface ?? "cli",
+		suppressRendering: inputOptions.suppressRendering ?? false,
+		concurrentScan: inputOptions.concurrentScan ?? false,
+		concurrency: inputOptions.concurrency,
+		maxDurationMs: inputOptions.maxDurationMs ?? null,
+		baseline: inputOptions.baseline ?? null,
+		changedLineRanges: inputOptions.changedLineRanges ?? null,
+		supplyChainManifestChanged: inputOptions.supplyChainManifestChanged ?? false
+	};
+};
 const deriveScope = (options) => {
 	if (options.baseline) return "changed";
 	if (options.changedLineRanges !== null) return "lines";
@@ -62216,6 +62767,8 @@ const runBaselineComparison = async (params) => {
 			warnings: params.options.warnings,
 			adoptExistingLintConfig: params.options.adoptExistingLintConfig,
 			ignoredTags: params.options.ignoredTags,
+			includedTags: params.options.includedTags,
+			includeTagDefaults: params.options.includeTagDefaults,
 			nodeBinaryPath: params.resolvedNodeBinaryPath ?? void 0,
 			runDeadCode: false,
 			isCi: params.options.isCi,
@@ -62309,6 +62862,8 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 		warnings: options.warnings,
 		adoptExistingLintConfig: options.adoptExistingLintConfig,
 		ignoredTags: options.ignoredTags,
+		includedTags: options.includedTags,
+		includeTagDefaults: options.includeTagDefaults,
 		nodeBinaryPath: resolvedNodeBinaryPath ?? void 0,
 		runDeadCode: options.deadCode,
 		isCi: options.isCi,
@@ -62497,7 +63052,7 @@ const finalizeAndRender = (input) => gen(function* () {
 		securityScanFailed
 	});
 	const hasSkippedChecks = skippedChecks.length > 0;
-	const noScoreMessage = buildNoScoreMessage(options.noScore);
+	const noScoreMessage = buildNoScoreMessage(options.noScore, options.scoreDisabledMessage);
 	const buildResult = () => ({
 		diagnostics: [...diagnostics],
 		score,
@@ -64602,21 +65157,25 @@ const resolveParallelFlag = (parallel) => parallel === false ? 1 : void 0;
 */
 const resolveCliInspectOptions = (flags, userConfig) => {
 	const wantsWarningGate = pickBlockingLevel(flags, userConfig) === "warning";
+	const isDesignScan = flags.design === true;
 	return {
 		lint: flags.lint,
-		deadCode: flags.deadCode,
-		supplyChain: flags.supplyChain,
+		deadCode: isDesignScan ? false : flags.deadCode,
+		supplyChain: isDesignScan ? false : flags.supplyChain,
 		verbose: flags.verbose,
 		outputDirectory: flags.outputDir,
 		respectInlineDisables: flags.respectInlineDisables === false ? false : void 0,
 		warnings: wantsWarningGate ? true : flags.warnings,
 		scoreOnly: flags.score === true,
-		noScore: flags.score === false || flags.telemetry === false ? true : void 0,
+		noScore: isDesignScan || flags.score === false || flags.telemetry === false ? true : void 0,
 		isCi: isCiEnvironment(),
 		silent: Boolean(flags.json),
 		concurrency: resolveParallelFlag(flags.parallel),
 		maxDurationMs: resolveMaxDurationFlag(flags.maxDuration),
-		categoryFilters: resolveCliCategories(flags.category)
+		categoryFilters: resolveCliCategories(flags.category),
+		includedTags: isDesignScan ? new Set(["design"]) : void 0,
+		includeTagDefaults: isDesignScan ? true : void 0,
+		scoreDisabledMessage: isDesignScan ? "Design scans do not affect the React health score." : void 0
 	};
 };
 //#endregion
@@ -65034,7 +65593,7 @@ const maybeMigrateLegacyConfig = async (requestedDirectory, { isQuiet, isStaged
 	if (!(!isQuiet && !isStaged && process.stdout.isTTY === true && !isCiOrCodingAgentEnvironment())) return;
 	await runProjectMigrations(requestedDirectory);
 };
-const inspectAction = async (directory, flags) => {
+const inspectAction = async (directory, flags, invocationCommand = "inspect") => {
 	const isScoreOnly = Boolean(flags.score);
 	const isJsonMode = Boolean(flags.json);
 	const isQuiet = isScoreOnly || isJsonMode;
@@ -65048,7 +65607,7 @@ const inspectAction = async (directory, flags) => {
 		});
 		if (flags.jsonOut) recordCount(METRIC.jsonOutUsed, 1);
 	}
-	recordCount(METRIC.cliInvoked, 1, { command: "inspect" });
+	recordCount(METRIC.cliInvoked, 1, { command: invocationCommand });
 	try {
 		validateModeFlags(flags);
 		if (flags.staged) setJsonReportMode("staged");
@@ -65360,6 +65919,13 @@ const inspectAction = async (directory, flags) => {
 	}
 };
 //#endregion
+//#region src/cli/commands/design.ts
+const designAction = async (directory, flags) => inspectAction(directory, {
+	...flags,
+	design: true,
+	lint: flags.lint ?? true
+}, "design");
+//#endregion
 //#region src/cli/commands/install.ts
 const installAction = async (options, command) => {
 	recordCount(METRIC.cliInvoked, 1, { command: "install" });
@@ -66196,6 +66762,7 @@ const INSTALL_FLAG_SPEC = {
 	shortOptionsWithRequiredValues: new Set(["-c"])
 };
 const COMMAND_FLAG_SPECS = new Map([
+	["design", ROOT_FLAG_SPEC],
 	["install", INSTALL_FLAG_SPEC],
 	["setup", INSTALL_FLAG_SPEC],
 	["version", {
@@ -66352,6 +66919,7 @@ ${formatExampleLines([
 	["react-doctor --scope changed --base main", "scan only new issues vs. main"],
 	["react-doctor --project modules/a,modules/b", "score each module separately (names or paths)"],
 	["react-doctor --staged", "scan staged files (pre-commit hook)"],
+	["react-doctor design", "run the focused UI design audit"],
 	["react-doctor --category Security", "show only one diagnostic category"],
 	["react-doctor --blocking warning", "fail CI on warnings too (default: error)"],
 	["react-doctor --json > report.json", "write a machine-readable report"],
@@ -66385,6 +66953,20 @@ ${highlighter.dim("Managing CI:")}
 ${highlighter.dim("Learn more:")}
   ${highlighter.info(CANONICAL_GITHUB_URL)}
 `;
+const renderDesignHelpEpilog = () => `
+${highlighter.dim("Examples:")}
+${formatExampleLines([
+	["react-doctor design", "audit UI design in the current project"],
+	["react-doctor design ./apps/web", "audit one application"],
+	["react-doctor design --verbose", "show every design finding"],
+	["react-doctor design --json", "write a design-only JSON report"]
+])}
+
+${highlighter.dim("Scope:")}
+  Runs only rules tagged ${highlighter.info("design")}, including focused rules that stay opt-in during a general health scan.
+  Dead-code, supply-chain, external lint-config, custom-plugin, and health-score passes are skipped.
+  Standard scan flags such as ${highlighter.info("--scope")}, ${highlighter.info("--project")}, ${highlighter.info("--verbose")}, and ${highlighter.info("--json")} still work.
+`;
 const renderCiHelpEpilog = () => `
 ${highlighter.dim("Examples:")}
 ${formatExampleLines([
@@ -66406,6 +66988,7 @@ ${highlighter.dim("Learn more:")}
 const collectCategoryOption = (value, previousValues) => [...previousValues ?? [], value];
 const program = new Command().name("react-doctor").description("Diagnose React codebase health").version(VERSION, "-v, --version", "display the version number").argument("[directory]", "project directory to scan", ".").option("--lint", "enable linting").option("--no-lint", "skip linting").option("--dead-code", "enable dead-code analysis (default)").option("--no-dead-code", "skip dead-code analysis (unused files / exports / dependencies, circular imports)").option("--supply-chain", "enable the dependency supply-chain scan (default)").option("--no-supply-chain", "skip the dependency supply-chain scan (Socket.dev dependency health checks)").option("--verbose", "show every rule and per-file details (default shows top 3 rules)").option("--debug", "force a Sentry trace and print its id at the end (paste it into a bug report)").option("--output-dir <dir>", "directory for the full diagnostics dump (default: a temp folder)").option("--score", "output only the score").option("--json", "output a single structured JSON report (suppresses other output)").option("--json-compact", "with --json, emit compact JSON (no indentation)").option("--json-out <path>", "with --json, write the report to a file instead of stdout").option("-y, --yes", "skip prompts, scan all workspace projects").option("--no-parallel", "lint serially with one worker (default: parallel across CPU cores; set the worker count with REACT_DOCTOR_PARALLEL)").option("--project <name>", "select projects: workspace names or directory paths (comma-separated for multiple); overrides the `projects` config field").option("--scope <value>", "how much supported JS/TS source to scan/report: full (default), files, changed (only new issues vs base), or lines (issues whose source spans touch changed lines)").option("--base <ref>", "base git ref for files/changed/lines scope (auto-detected when omitted)").option("--include-untracked", "with --scope files/changed/lines, also scan ordinary untracked files (respects .gitignore)").addOption(new Option("--diff [base]", "[deprecated] alias for --scope changed (pass `false` to force a full scan)").hideHelp()).addOption(new Option("--changed-files-from <file>", "scan source files listed in a newline-delimited changed-files file").hideHelp()).option("--no-score", "skip the score API, the share URL, and crash reporting").addOption(new Option("--category <category>", "only show diagnostics in a category (repeatable; e.g. Security)").argParser(collectCategoryOption)).option("--no-telemetry", "alias for --no-score (skip the score API, share URL, and crash reporting)").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--max-duration <seconds>", "scan time budget for the whole run, shared across workspace projects: past it, remaining lint batches and dead-code are skipped and partial results are reported (skipped files are listed in the JSON report)").option("--blocking <level>", "severity that fails CI: error (default), warning, or none (advisory)").addOption(new Option("--fail-on <level>", "[deprecated] alias for --blocking <level>").hideHelp()).option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").option("--warnings", "show warning-severity diagnostics (default)").option("--no-warnings", "hide warning-severity diagnostics (errors only)").option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").addHelpText("after", renderRootHelpEpilog);
 program.action(inspectAction);
+program.command("design [directory]").description("Run only the focused UI design diagnostics").addHelpText("after", renderDesignHelpEpilog).action((directory, _options, command) => designAction(directory ?? ".", command.optsWithGlobals()));
 program.command("why <location>").description("Explain why a rule fired (or why a suppression didn't apply) at a file:line").option("--project <name>", "select projects: workspace names or directory paths (comma-separated for multiple)").option("-c, --cwd <cwd>", "working directory", process.cwd()).option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").action((location, options) => whyAction(location, options));
 program.command("install").alias("setup").description("Install the react-doctor skill into your coding agents and optional git hook").option("-y, --yes", "skip prompts, install for all detected agents").option("--dry-run", "show what would be installed without writing files").option("--agent-hooks", "install native non-blocking agent hooks for Claude Code and Cursor").option("-c, --cwd <cwd>", "working directory", process.cwd()).option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").addHelpText("after", renderInstallHelpEpilog).action(installAction);
 const providerOption = ["--provider <name>", "ci provider: github-actions or gitlab-ci (auto-detected by default)"];
@@ -66454,4 +67037,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=1b59ca76-9135-54e6-9391-ce7fec27b699
+//# debugId=87efffda-8fc4-5b52-80e1-7ec503c85206