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

package/dist/lsp.js

@@ -32883,44 +32883,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__\//;
@@ -32961,6 +32923,58 @@ const IGNORED_DIRECTORIES = new Set([
 	"storybook-static"
 ]);
 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 FETCH_TIMEOUT_MS = 1e4;
 const GITHUB_VIEWER_PERMISSION_TIMEOUT_MS = 2e3;
@@ -33102,6 +33116,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;
@@ -33427,10 +33479,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"
 };
@@ -33454,11 +33506,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",
@@ -33470,12 +33528,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) => {
@@ -33510,6 +33584,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);
 };
@@ -33518,7 +33594,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;
@@ -33651,6 +33727,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);
@@ -33694,9 +33780,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;
@@ -33705,6 +33800,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);
@@ -33726,7 +33822,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();
@@ -33876,6 +33972,12 @@ const TAILWIND_ZOD_SECTIONS = [
 	"devDependencies",
 	"peerDependencies"
 ];
+const DEPENDENCY_SPEC_SECTIONS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
 const EMPTY_DEPENDENCY_INFO = {
 	reactVersion: null,
 	tailwindVersion: null,
@@ -33885,7 +33987,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;
 	}
@@ -33917,13 +34019,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,
@@ -33957,24 +34062,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");
@@ -34172,11 +34268,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({
@@ -34187,7 +34356,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);
@@ -34206,6 +34375,59 @@ const shouldReplaceSupportedDependencyFact = (currentFact, nextFact, latestSuppo
 	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");
@@ -34221,6 +34443,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 = {
@@ -34239,10 +34478,10 @@ const evaluateManifestFacts = (facts, packageJson, directory, rootDirectory, roo
 			}),
 			sourceDirectory: directory
 		};
-		if (shouldReplaceSupportedDependencyFact(facts.mobx, nextMobxFact, 6)) facts.mobx = nextMobxFact;
+		if (shouldReplaceMobxFact(facts.mobx, nextMobxFact)) facts.mobx = nextMobxFact;
 	}
-	facts.hasMobxReact = facts.hasMobxReact || getDependencySpec(packageJson, MOBX_REACT_PACKAGE_NAME) !== null;
-	facts.hasMobxReactLite = facts.hasMobxReactLite || getDependencySpec(packageJson, MOBX_REACT_LITE_PACKAGE_NAME) !== null;
+	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");
@@ -34266,6 +34505,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);
@@ -34287,6 +34572,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 = {
@@ -34302,6 +34589,11 @@ const collectWorkspaceFacts = (rootDirectory, rootPackageJson, { collectReactGro
 			version: null,
 			sourceDirectory: null
 		},
+		reactRouter: {
+			version: null,
+			sourceDirectory: null,
+			packageName: null
+		},
 		shopifyFlashList: {
 			version: null,
 			sourceDirectory: null
@@ -34312,26 +34604,40 @@ const collectWorkspaceFacts = (rootDirectory, rootPackageJson, { collectReactGro
 			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);
@@ -34367,7 +34673,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);
@@ -34563,7 +34869,9 @@ const discoverProjectWithoutPackageJson = (directory) => {
 		mobxVersion: null,
 		mobxMajorVersion: null,
 		hasMobxReact: false,
+		mobxReactVersion: null,
 		hasMobxReactLite: false,
+		mobxReactLiteVersion: null,
 		hasMobxStateTree: false,
 		hasMobxReactObserver: false,
 		zustandVersion: null,
@@ -34578,12 +34886,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,
@@ -34702,8 +35021,27 @@ const discoverProject = (directory) => {
 		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,
@@ -34714,9 +35052,11 @@ const discoverProject = (directory) => {
 		zodVersion,
 		zodMajorVersion: zodVersion === null ? null : getLowestDependencyMajor(zodVersion),
 		mobxVersion,
-		mobxMajorVersion: mobxVersion === null ? null : getLowestDependencyMajor(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,
@@ -34725,18 +35065,29 @@ const discoverProject = (directory) => {
 		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),
@@ -37931,10 +38282,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();
@@ -37947,39 +38298,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) addMajorLadder(capabilities, "mobx", project.mobxMajorVersion, 4, 6);
+	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) addMajorLadder(capabilities, "zustand", project.zustandMajorVersion, 1, 5);
+	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;
 };
@@ -37991,7 +38389,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;
 	}
@@ -38002,20 +38400,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,
@@ -40001,8 +40408,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);
@@ -40017,9 +40425,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
@@ -40028,7 +40441,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);
 	}
@@ -40245,6 +40658,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 = createRequire(import.meta.url);
 const childNodeVersionByBinaryPath = /* @__PURE__ */ new Map();
 const resolveChildNodeVersion = (nodeBinaryPath) => {
@@ -40268,6 +40694,13 @@ const TOOLCHAIN_PACKAGE_SPECIFIERS = [
 	"oxlint-plugin-react-doctor/package.json",
 	"eslint-plugin-react-hooks/package.json"
 ];
+const resolvePluginFingerprint = () => {
+	try {
+		return fingerprintFileContents(bundledRequire.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) try {
@@ -40277,6 +40710,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);
@@ -41752,7 +42186,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();
@@ -41766,13 +42200,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,
@@ -42161,6 +42597,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) => {
@@ -43009,7 +43447,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;
@@ -43100,6 +43540,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) => {
@@ -45602,5 +46044,5 @@ const startLanguageServer = () => {
 };
 //#endregion
 export { startLanguageServer };
-!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]="f2369b82-a22a-50e5-b71b-2ceb30eaee9f")}catch(e){}}();
-//# debugId=f2369b82-a22a-50e5-b71b-2ceb30eaee9f
+!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]="f391589f-4666-5b19-95b9-028be54a868d")}catch(e){}}();
+//# debugId=f391589f-4666-5b19-95b9-028be54a868d