oxlint-plugin-react-doctor 0.7.2-dev.aa519e5 → 0.7.2-dev.cb8f726

package/dist/index.js

@@ -595,6 +595,19 @@ const TRIVIAL_INITIALIZER_NAMES = new Set([
 	"parseInt",
 	"parseFloat"
 ]);
+const TRIVIAL_CONSTRUCTOR_NAMES = new Set([
+	"Date",
+	"Map",
+	"Set",
+	"WeakMap",
+	"WeakSet",
+	"WeakRef",
+	"RegExp",
+	"Error",
+	"URL",
+	"URLSearchParams",
+	"AbortController"
+]);
 const TRIVIAL_DERIVATION_CALLEE_NAMES = new Set([
 	"Boolean",
 	"String",
@@ -2235,6 +2248,38 @@ const anchorHasContent = defineRule({
 	}
 });
 //#endregion
+//#region src/plugin/utils/get-jsx-prop-static-string-values.ts
+const MAX_CONST_RESOLUTION_HOPS = 4;
+const resolveStaticStringValues = (rawExpression, scopes, remainingHops) => {
+	const expression = stripParenExpression(rawExpression);
+	if (isNodeOfType(expression, "Literal")) return typeof expression.value === "string" ? [expression.value] : null;
+	if (isNodeOfType(expression, "TemplateLiteral")) {
+		const staticValue = getStaticTemplateLiteralValue(expression);
+		return staticValue === null ? null : [staticValue];
+	}
+	if (isNodeOfType(expression, "ConditionalExpression")) {
+		const consequentValues = resolveStaticStringValues(expression.consequent, scopes, remainingHops);
+		if (consequentValues === null) return null;
+		const alternateValues = resolveStaticStringValues(expression.alternate, scopes, remainingHops);
+		if (alternateValues === null) return null;
+		return [...consequentValues, ...alternateValues];
+	}
+	if (isNodeOfType(expression, "Identifier")) {
+		if (remainingHops === 0) return null;
+		const symbol = scopes.referenceFor(expression)?.resolvedSymbol;
+		if (!symbol || symbol.kind !== "const" || !symbol.initializer) return null;
+		return resolveStaticStringValues(symbol.initializer, scopes, remainingHops - 1);
+	}
+	return null;
+};
+const getJsxPropStaticStringValues = (attribute, scopes) => {
+	const value = attribute.value;
+	if (!value) return null;
+	if (isNodeOfType(value, "Literal")) return typeof value.value === "string" ? [value.value] : null;
+	if (isNodeOfType(value, "JSXExpressionContainer")) return resolveStaticStringValues(value.expression, scopes, MAX_CONST_RESOLUTION_HOPS);
+	return null;
+};
+//#endregion
 //#region src/plugin/rules/a11y/anchor-is-valid.ts
 const MESSAGE_MISSING_HREF = "Keyboard users can't reach this link because it has no `href`, so add a real `href` (or use `<button>` for actions).";
 const MESSAGE_INCORRECT_HREF = "Keyboard users can't reach this link because its `href` goes nowhere (`#`, `javascript:`, or empty), so point it at a real destination.";
@@ -2264,28 +2309,11 @@ const isInvalidHref = (value, validHrefs) => {
 	if (validHrefs.has(value)) return false;
 	return value === "" || value === "#" || value === "javascript:void(0)";
 };
-const getStaticHrefValue = (value) => {
-	if (isNodeOfType(value, "Literal")) return typeof value.value === "string" ? value.value : null;
-	if (isNodeOfType(value, "JSXExpressionContainer")) {
-		const expression = value.expression;
-		if (isNodeOfType(expression, "Literal") && typeof expression.value === "string") return expression.value;
-		if (isNodeOfType(expression, "TemplateLiteral")) return getStaticTemplateLiteralValue(expression);
-	}
-	return null;
-};
-const checkValueIsEmptyOrInvalid = (value, validHrefs) => {
-	if (isNodeOfType(value, "Literal")) return typeof value.value === "string" ? isInvalidHref(value.value, validHrefs) : false;
+const isNullishOrFragmentHref = (value) => {
 	if (isNodeOfType(value, "JSXExpressionContainer")) {
 		const expression = value.expression;
 		if (isNodeOfType(expression, "Identifier") && expression.name === "undefined") return true;
-		if (isNodeOfType(expression, "Literal")) {
-			if (expression.value === null) return true;
-			if (typeof expression.value === "string") return isInvalidHref(expression.value, validHrefs);
-		}
-		if (isNodeOfType(expression, "TemplateLiteral")) {
-			const staticValue = getStaticTemplateLiteralValue(expression);
-			return staticValue === null ? false : isInvalidHref(staticValue, validHrefs);
-		}
+		if (isNodeOfType(expression, "Literal") && expression.value === null) return true;
 	}
 	if (isNodeOfType(value, "JSXFragment")) return true;
 	return false;
@@ -2318,9 +2346,10 @@ const anchorIsValid = defineRule({
 					});
 					return;
 				}
-				if (checkValueIsEmptyOrInvalid(hrefAttribute.value, settings.validHrefs)) {
+				const hrefCandidates = getJsxPropStaticStringValues(hrefAttribute, context.scopes);
+				if (hrefCandidates !== null ? hrefCandidates.length > 0 && hrefCandidates.every((candidate) => isInvalidHref(candidate, settings.validHrefs)) : isNullishOrFragmentHref(hrefAttribute.value)) {
 					const hasOnClick = Boolean(hasJsxPropIgnoreCase(node.attributes, "onClick"));
-					if (!hasOnClick && getStaticHrefValue(hrefAttribute.value) === "#") return;
+					if (!hasOnClick && hrefCandidates?.every((candidate) => candidate === "#")) return;
 					context.report({
 						node: node.name,
 						message: hasOnClick ? MESSAGE_CANT_BE_ANCHOR : MESSAGE_INCORRECT_HREF
@@ -3376,6 +3405,25 @@ const ariaRole = defineRule({
 			if (!roleAttribute) return;
 			const elementType = getElementType(node, context.settings);
 			if (settings.ignoreNonDOM && !HTML_TAGS.has(elementType)) return;
+			const reportFirstInvalidCandidate = (candidates) => {
+				for (const candidate of candidates) {
+					if (candidate.trim().length === 0) {
+						context.report({
+							node: roleAttribute,
+							message: buildBaseMessage("")
+						});
+						return;
+					}
+					const tokens = candidate.split(/\s+/).filter((token) => token.length > 0);
+					for (const token of tokens) if (!VALID_ARIA_ROLES.has(token) && !settings.allowedInvalidRoles.includes(token)) {
+						context.report({
+							node: roleAttribute,
+							message: buildBaseMessage(` \`${token}\` is not one.`)
+						});
+						return;
+					}
+				}
+			};
 			const value = roleAttribute.value;
 			if (!value) {
 				context.report({
@@ -3392,22 +3440,7 @@ const ariaRole = defineRule({
 					});
 					return;
 				}
-				const stringValue = value.value;
-				if (stringValue.trim().length === 0) {
-					context.report({
-						node: roleAttribute,
-						message: buildBaseMessage("")
-					});
-					return;
-				}
-				const tokens = stringValue.split(/\s+/).filter((token) => token.length > 0);
-				for (const token of tokens) if (!VALID_ARIA_ROLES.has(token) && !settings.allowedInvalidRoles.includes(token)) {
-					context.report({
-						node: roleAttribute,
-						message: buildBaseMessage(` \`${token}\` is not one.`)
-					});
-					return;
-				}
+				reportFirstInvalidCandidate([value.value]);
 				return;
 			}
 			if (isNodeOfType(value, "JSXExpressionContainer")) {
@@ -3428,6 +3461,11 @@ const ariaRole = defineRule({
 					});
 					return;
 				}
+				const resolvedCandidates = getJsxPropStaticStringValues(roleAttribute, context.scopes);
+				if (resolvedCandidates !== null) {
+					reportFirstInvalidCandidate(resolvedCandidates);
+					return;
+				}
 				return;
 			}
 			context.report({
@@ -9616,7 +9654,7 @@ If the missing value is recreated every render, move it inside the hook or stabi
 });
 //#endregion
 //#region src/plugin/rules/react-native/expo-no-non-inlined-env.ts
-const EMPTY_VISITORS$5 = {};
+const EMPTY_VISITORS$6 = {};
 const NODE_OR_BUILD_FILE = /(\.config\.[cm]?[jt]sx?$)|((^|\/)(scripts|tools|tooling|cli|bin)\/)|(\+(api|html)\.[cm]?[jt]sx?$)|(\.server\.[cm]?[jt]sx?$)|(\.(test|spec)\.[cm]?[jt]sx?$)|((^|\/)__tests__\/)|(\.e2e\.[cm]?[jt]sx?$)/;
 const isNonExpoPublicLiteralKey = (key) => isNodeOfType(key, "Literal") && typeof key.value === "string" && !key.value.startsWith("EXPO_PUBLIC_");
 const isProcessEnv = (node) => isNodeOfType(node, "MemberExpression") && !node.computed && isNodeOfType(node.object, "Identifier") && node.object.name === "process" && isNodeOfType(node.property, "Identifier") && node.property.name === "env";
@@ -9628,7 +9666,7 @@ const expoNoNonInlinedEnv = defineRule({
 	recommendation: "Read env vars with static dotted access (`process.env.EXPO_PUBLIC_NAME`). Computed access and destructuring aren't inlined by babel-preset-expo and resolve to `undefined` at runtime.",
 	create: (context) => {
 		const filename = normalizeFilename(context.filename ?? "");
-		if (filename && NODE_OR_BUILD_FILE.test(filename)) return EMPTY_VISITORS$5;
+		if (filename && NODE_OR_BUILD_FILE.test(filename)) return EMPTY_VISITORS$6;
 		return {
 			MemberExpression(node) {
 				if (!node.computed) return;
@@ -11046,8 +11084,8 @@ const interactiveSupportsFocus = defineRule({
 			if (node.attributes.length === 0) return;
 			if (hasJsxSpreadAttribute$1(node.attributes)) return;
 			const roleAttribute = hasJsxPropIgnoreCase(node.attributes, "role");
-			const role = roleAttribute ? getJsxPropStringValue(roleAttribute) : null;
-			if (!role) return;
+			const roleCandidates = roleAttribute ? getJsxPropStaticStringValues(roleAttribute, context.scopes) : null;
+			if (roleCandidates === null || roleCandidates.length === 0) return;
 			let hasInteractiveHandler = false;
 			for (const attribute of node.attributes) {
 				if (!isNodeOfType(attribute, "JSXAttribute")) continue;
@@ -11061,11 +11099,16 @@ const interactiveSupportsFocus = defineRule({
 			const elementType = getElementType(node, context.settings);
 			if (!HTML_TAGS.has(elementType)) return;
 			if (isDisabledElement(node) || isHiddenFromScreenReader(node, context.settings) || isPresentationRole(node)) return;
-			if (COMPOSITE_CONTAINER_ROLES.has(role)) return;
-			if (COMPOSITE_ITEM_ROLES.has(role) && Boolean(hasJsxPropIgnoreCase(node.attributes, "id"))) return;
 			const hasTabIndex = Boolean(hasJsxPropIgnoreCase(node.attributes, "tabIndex"));
-			if (!isInteractiveRole(role) || isInteractiveElement(elementType, node) || isNonInteractiveRole(role) || isNonInteractiveElement(elementType, node) || hasTabIndex) return;
-			const message = tabbableSet.has(role) ? buildTabbableMessage(role) : buildFocusableMessage(role);
+			const hasId = Boolean(hasJsxPropIgnoreCase(node.attributes, "id"));
+			for (const role of roleCandidates) {
+				if (COMPOSITE_CONTAINER_ROLES.has(role)) return;
+				if (COMPOSITE_ITEM_ROLES.has(role) && hasId) return;
+				if (!isInteractiveRole(role) || isInteractiveElement(elementType, node) || isNonInteractiveRole(role) || isNonInteractiveElement(elementType, node) || hasTabIndex) return;
+			}
+			const isEveryCandidateTabbable = roleCandidates.every((role) => tabbableSet.has(role));
+			const roleDisplay = roleCandidates.join("' / '");
+			const message = isEveryCandidateTabbable ? buildTabbableMessage(roleDisplay) : buildFocusableMessage(roleDisplay);
 			context.report({
 				node,
 				message
@@ -13508,7 +13551,7 @@ const jsTosortedImmutable = defineRule({
 	title: "Spread copy before sort()",
 	tags: ["test-noise"],
 	severity: "warn",
-	disabledBy: ["react-native", "pre-es2023"],
+	disabledWhen: ["react-native", "pre-es2023"],
 	recommendation: "Use `array.toSorted()` (ES2023) instead of `[...array].sort()` so you sort without copying the array first",
 	create: (context) => ({ CallExpression(node) {
 		if (!isMemberProperty(node.callee, "sort")) return;
@@ -14755,7 +14798,7 @@ const jsxNoConstructedContextValues = defineRule({
 	title: "Unstable context provider value",
 	tags: ["react-jsx-only"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Wrap the context value in `useMemo` or move it outside the component so consumers do not redraw every render.",
 	category: "Performance",
 	create: (context) => {
@@ -15123,7 +15166,7 @@ const jsxNoJsxAsProp = defineRule({
 	title: "JSX element passed as a prop",
 	tags: ["react-jsx-only"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Move the JSX outside the component or wrap it in `useMemo` so memoized children do not redraw every render.",
 	category: "Performance",
 	create: (context) => {
@@ -15511,7 +15554,7 @@ const jsxNoNewArrayAsProp = defineRule({
 	title: "New array passed as a prop",
 	tags: ["react-jsx-only"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Wrap the array in `useMemo` or move it outside the component so memoized children do not redraw every render.",
 	category: "Performance",
 	create: (context) => {
@@ -15975,7 +16018,7 @@ const jsxNoNewFunctionAsProp = defineRule({
 	title: "New function passed as a prop",
 	tags: ["react-jsx-only"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Wrap the callback in `useCallback` or move it outside the component so memoized children do not redraw every render.",
 	category: "Performance",
 	create: (context) => {
@@ -16282,7 +16325,7 @@ const jsxNoNewObjectAsProp = defineRule({
 	title: "New object passed as a prop",
 	tags: ["react-jsx-only"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Wrap the object in `useMemo` or move it outside the component so memoized children do not redraw every render.",
 	category: "Performance",
 	create: (context) => {
@@ -18106,6 +18149,7 @@ const getReactDoctorStringArraySetting = (settings, settingName) => {
 	if (!Array.isArray(settingValue)) return [];
 	return settingValue.filter((entry) => typeof entry === "string" && entry.length > 0);
 };
+const hasCapability = (settings, capability) => getReactDoctorStringArraySetting(settings, "capabilities").includes(capability);
 //#endregion
 //#region src/plugin/utils/is-in-project-directory.ts
 const isInProjectDirectory = (context, directoryPath) => {
@@ -18560,6 +18604,7 @@ const describeClientSideNavigation = (node) => {
 	}
 	return null;
 };
+const STATIC_EXPORT_RECOMMENDATION = "Avoid redirects inside useEffect — they flash the wrong page first. Use an event handler (e.g. onClick), or call redirect() from next/navigation during render (it prerenders a client-side redirect under output: \"export\"). Middleware and getServerSideProps redirects aren't available in a static export.";
 const nextjsNoClientSideRedirect = defineRule({
 	id: "nextjs-no-client-side-redirect",
 	title: "Client-side redirect for navigation",
@@ -18567,6 +18612,7 @@ const nextjsNoClientSideRedirect = defineRule({
 	requires: ["nextjs"],
 	severity: "warn",
 	recommendation: "Avoid redirects inside useEffect. Use an event handler, middleware, or server-side redirect (App Router: redirect() from next/navigation; Pages Router: getServerSideProps redirect)",
+	recommendationFor: (hasCapability) => hasCapability("nextjs:static-export") ? STATIC_EXPORT_RECOMMENDATION : void 0,
 	create: (context) => {
 		return { CallExpression(node) {
 			if (!isHookCall$2(node, EFFECT_HOOK_NAMES$1)) return;
@@ -22474,6 +22520,10 @@ const declaresAnyDependency = (manifest) => DEPENDENCY_SECTION_NAMES.some((secti
 	const section = manifest[sectionName];
 	return typeof section === "object" && section !== null && Object.keys(section).length > 0;
 });
+const declaresDependency = (manifest, dependencyName) => {
+	for (const declaredName of iterateDependencyNames(manifest)) if (declaredName === dependencyName) return true;
+	return false;
+};
 const cachedPlatformByManifest = /* @__PURE__ */ new WeakMap();
 const classifyPackagePlatform = (filename) => {
 	const manifest = readNearestPackageManifest(filename);
@@ -22490,9 +22540,7 @@ const classifyPackagePlatform = (filename) => {
 	return result;
 };
 //#endregion
-//#region src/plugin/utils/is-react-native-file.ts
-const WEB_FILE_EXTENSION_PATTERN = /\.web\.[cm]?[jt]sx?$/;
-const NATIVE_FILE_EXTENSION_PATTERN = /\.(?:ios|android|native)\.[cm]?[jt]sx?$/;
+//#region src/plugin/utils/is-package-nested-below-project-root.ts
 const cachedRealDirectoryByDirectory = /* @__PURE__ */ new Map();
 const resolveRealDirectory = (directory) => {
 	const cached = cachedRealDirectoryByDirectory.get(directory);
@@ -22513,6 +22561,10 @@ const isPackageNestedBelowProjectRoot = (packageDirectory, rootDirectory) => {
 	const rootPrefix = normalizedRootDirectory.endsWith("/") ? normalizedRootDirectory : `${normalizedRootDirectory}/`;
 	return realPackageDirectory.startsWith(rootPrefix);
 };
+//#endregion
+//#region src/plugin/utils/is-react-native-file.ts
+const WEB_FILE_EXTENSION_PATTERN = /\.web\.[cm]?[jt]sx?$/;
+const NATIVE_FILE_EXTENSION_PATTERN = /\.(?:ios|android|native)\.[cm]?[jt]sx?$/;
 const classifyReactNativeFileTarget = (context) => {
 	const rawFilename = context.filename;
 	if (!rawFilename) return "unknown";
@@ -22929,7 +22981,6 @@ const countStatementSequenceSetStateCalls = (statements, context) => {
 	let fallThroughCount = 0;
 	let maxTerminatingPathCount = 0;
 	for (const statement of statements) {
-		if (isFunctionLike$1(statement)) continue;
 		const guardBranch = isGuardWithTerminatingBranch(statement);
 		if (guardBranch) {
 			maxTerminatingPathCount = Math.max(maxTerminatingPathCount, fallThroughCount + countMaxPathSetStateCalls(guardBranch, context));
@@ -22965,14 +23016,23 @@ const isWholesaleDelegationCall = (callNode, effectCallback) => {
 	if (!isNodeOfType(parent, "ExpressionStatement")) return false;
 	return parent.parent === effectCallback.body;
 };
+const countFunctionBodySetStateCalls = (functionNode, context) => {
+	if (isAsyncFunctionLike(functionNode)) return 0;
+	const body = functionNode.body;
+	if (!body) return 0;
+	return countMaxPathSetStateCalls(body, context);
+};
 const countMaxPathSetStateCalls = (node, context) => {
 	if (!node || typeof node !== "object") return 0;
-	if (isAsyncFunctionLike(node)) return 0;
+	if (isFunctionLike$1(node)) return 0;
 	if (isNodeOfType(node, "BlockStatement") || isNodeOfType(node, "Program")) return countStatementSequenceSetStateCalls(node.body ?? [], context);
 	if (isNodeOfType(node, "IfStatement") || isNodeOfType(node, "ConditionalExpression")) {
 		const consequent = node.consequent;
 		const alternate = node.alternate;
-		return countMaxPathSetStateCalls(consequent, context) + (alternate ? countMaxPathSetStateCalls(alternate, context) : 0);
+		const testCount = countMaxPathSetStateCalls(node.test, context);
+		const thenCount = countMaxPathSetStateCalls(consequent, context);
+		const elseCount = alternate ? countMaxPathSetStateCalls(alternate, context) : 0;
+		return testCount + Math.max(thenCount, elseCount);
 	}
 	if (isNodeOfType(node, "SwitchStatement")) {
 		let maxRunSetters = 0;
@@ -23002,28 +23062,31 @@ const countMaxPathSetStateCalls = (node, context) => {
 	}
 	if (isNodeOfType(node, "CallExpression") && isSetterCall(node) && isNodeOfType(node.callee, "Identifier") && isUseStateSetterInScope(node, node.callee.name)) {
 		let nestedSettersInArgs = 0;
-		for (const argument of node.arguments ?? []) nestedSettersInArgs += countMaxPathSetStateCalls(argument, context);
+		for (const argument of node.arguments ?? []) nestedSettersInArgs += isFunctionLike$1(argument) ? countFunctionBodySetStateCalls(argument, context) : countMaxPathSetStateCalls(argument, context);
 		return 1 + nestedSettersInArgs;
 	}
 	if (isNodeOfType(node, "CallExpression") && isNodeOfType(node.callee, "Identifier")) {
 		const helperFunction = context.helpersByName.get(node.callee.name);
 		if (helperFunction && !context.activeHelpers.has(helperFunction) && isWholesaleDelegationCall(node, context.effectCallback)) {
 			context.activeHelpers.add(helperFunction);
-			let helperCount = countMaxPathSetStateCalls(helperFunction, context);
+			let helperCount = countFunctionBodySetStateCalls(helperFunction, context);
 			context.activeHelpers.delete(helperFunction);
 			for (const argument of node.arguments ?? []) helperCount += countMaxPathSetStateCalls(argument, context);
 			return helperCount;
 		}
 	}
-	const shouldWalkChild = (child) => !isFunctionLike$1(child) || runsOnEffectDispatch(child);
+	const countChild = (child) => {
+		if (isFunctionLike$1(child)) return runsOnEffectDispatch(child) ? countFunctionBodySetStateCalls(child, context) : 0;
+		return countMaxPathSetStateCalls(child, context);
+	};
 	let total = 0;
 	const nodeRecord = node;
 	for (const key of Object.keys(nodeRecord)) {
 		if (key === "parent") continue;
 		const child = nodeRecord[key];
 		if (Array.isArray(child)) {
-			for (const item of child) if (item && typeof item === "object" && "type" in item && shouldWalkChild(item)) total += countMaxPathSetStateCalls(item, context);
-		} else if (child && typeof child === "object" && "type" in child && shouldWalkChild(child)) total += countMaxPathSetStateCalls(child, context);
+			for (const item of child) if (item && typeof item === "object" && "type" in item) total += countChild(item);
+		} else if (child && typeof child === "object" && "type" in child) total += countChild(child);
 	}
 	return total;
 };
@@ -23072,7 +23135,7 @@ const noCascadingSetState = defineRule({
 		const callback = getEffectCallback(node);
 		if (!callback) return;
 		if (isDevOnlyGuardedEffect(callback)) return;
-		const setStateCallCount = countMaxPathSetStateCalls(callback, {
+		const setStateCallCount = countFunctionBodySetStateCalls(callback, {
 			helpersByName: collectLocalHelperFunctions(findProgramRoot(node) ?? callback),
 			activeHelpers: /* @__PURE__ */ new Set(),
 			effectCallback: callback
@@ -26290,7 +26353,11 @@ const noEffectEventInDeps = defineRule({
 			const initializer = declaratorNode.init;
 			if (!initializer || !isNodeOfType(initializer, "CallExpression")) return;
 			if (!isHookCall$2(initializer, "useEffectEvent")) return;
-			if (isNodeOfType(initializer.callee, "Identifier") && isImportedFromNonReactModule(declaratorNode, initializer.callee.name)) return;
+			if (isNodeOfType(initializer.callee, "Identifier")) {
+				if (isImportedFromNonReactModule(declaratorNode, initializer.callee.name)) return;
+				const calleeSymbol = context.scopes.referenceFor(initializer.callee)?.resolvedSymbol;
+				if (calleeSymbol && calleeSymbol.kind !== "import") return;
+			}
 			componentBindings.addBindingToCurrentFrame(declaratorNode.id.name);
 		} });
 		return {
@@ -28928,7 +28995,7 @@ const noJsonParseStringifyClone = defineRule({
 	id: "no-json-parse-stringify-clone",
 	title: "JSON parse/stringify deep clone",
 	severity: "warn",
-	disabledBy: ["react-native"],
+	disabledWhen: ["react-native"],
 	recommendation: "Replace `JSON.parse(JSON.stringify(value))` with `structuredClone(value)`. It is faster and preserves Dates, Maps, Sets, and cyclic references.",
 	create: (context) => ({ CallExpression(node) {
 		if (!isJsonMethodCall(node, "parse")) return;
@@ -31752,12 +31819,8 @@ const noPolymorphicChildren = defineRule({
 //#endregion
 //#region src/plugin/rules/correctness/no-prevent-default.ts
 const PREVENT_DEFAULT_ELEMENTS = new Map([["form", ["onSubmit"]], ["a", ["onClick"]]]);
-const SERVER_CAPABLE_FRAMEWORKS = new Set([
-	"nextjs",
-	"tanstack-start",
-	"remix"
-]);
 const FORM_MESSAGE_SERVER_CAPABLE = "Your users can't submit this <form> without JavaScript because onSubmit calls preventDefault(), so use a server action like `<form action={serverAction}>` to make it work either way.";
+const FORM_MESSAGE_GENERIC = "Your users can't submit this <form> because onSubmit calls preventDefault().";
 const ANCHOR_MESSAGE = "Your users click this <a> & nothing navigates because onClick calls preventDefault(), so use a <button> or a routing component instead.";
 const collectPreventDefaultCalls = (node) => {
 	const preventDefaultCalls = [];
@@ -31894,15 +31957,18 @@ const noPreventDefault = defineRule({
 	recommendation: "Use `<form action>` where your framework supports it (it works without JS), or use a `<button>` instead of an `<a>` with preventDefault.",
 	create: (context) => {
 		const framework = getReactDoctorStringSetting(context.settings, "framework");
-		const isServerCapableFramework = framework !== void 0 && SERVER_CAPABLE_FRAMEWORKS.has(framework);
+		const isClientOnlyFramework = hasCapability(context.settings, "client-only");
+		const isServerActionsFramework = hasCapability(context.settings, "server-actions");
+		const formMessage = isServerActionsFramework ? FORM_MESSAGE_SERVER_CAPABLE : FORM_MESSAGE_GENERIC;
 		return { JSXOpeningElement(node) {
 			const elementName = isNodeOfType(node.name, "JSXIdentifier") ? node.name.name : null;
 			if (!elementName) return;
 			const targetEventProps = PREVENT_DEFAULT_ELEMENTS.get(elementName);
 			if (!targetEventProps) return;
 			if (elementName === "form") {
-				if (!isServerCapableFramework) return;
-				if (framework === "nextjs") {
+				if (isClientOnlyFramework) return;
+				if (framework === void 0 || framework === "unknown") return;
+				if (framework === "nextjs" && isServerActionsFramework) {
 					const programRoot = findProgramRoot(node);
 					if (!programRoot || !hasDirective(programRoot, "use client")) return;
 				}
@@ -31926,7 +31992,7 @@ const noPreventDefault = defineRule({
 				}
 				context.report({
 					node,
-					message: elementName === "form" ? FORM_MESSAGE_SERVER_CAPABLE : ANCHOR_MESSAGE
+					message: elementName === "form" ? formMessage : ANCHOR_MESSAGE
 				});
 				return;
 			}
@@ -33196,11 +33262,41 @@ const isIdentifierLikeKeyNameValue = (literalValue) => {
 	if (wordSegments.length < 2) return false;
 	return wordSegments.every((segment) => /^[a-z]+$/.test(segment));
 };
+const FRAMEWORK_ENV_ADVICE = [
+	[
+		"nextjs",
+		"Next.js",
+		"NEXT_PUBLIC_*"
+	],
+	[
+		"vite",
+		"Vite",
+		"VITE_*"
+	],
+	[
+		"tanstack-start",
+		"TanStack Start",
+		"VITE_*"
+	],
+	[
+		"cra",
+		"Create React App",
+		"REACT_APP_*"
+	],
+	[
+		"gatsby",
+		"Gatsby",
+		"GATSBY_*"
+	]
+];
 const noSecretsInClientCode = defineRule({
 	id: "no-secrets-in-client-code",
 	title: "Secret in client code",
 	severity: "warn",
 	recommendation: "Move secrets to server-only code. Anything in client env variables gets shipped to the browser, so it can't hold secrets.",
+	recommendationFor: (hasCapability) => {
+		for (const [frameworkToken, frameworkName, publicEnvPrefix] of FRAMEWORK_ENV_ADVICE) if (hasCapability(frameworkToken)) return `Move secrets to server-only code. In ${frameworkName}, only \`${publicEnvPrefix}\` env vars are exposed to the browser, and they must not contain secrets`;
+	},
 	create: (context) => {
 		const filename = normalizeFilename(context.filename ?? "");
 		const framework = getReactDoctorStringSetting(context.settings, "framework");
@@ -33238,7 +33334,7 @@ const noSecretsInClientCode = defineRule({
 				const isServerOnlyScope = isInsideServerOnlyScope(node);
 				const trailingSuffix = getIdentifierTrailingWord(variableName);
 				const isUiConstant = SECRET_FALSE_POSITIVE_SUFFIXES.has(trailingSuffix);
-				if (shouldUseVariableNameHeuristic && !isServerOnlyScope && SECRET_VARIABLE_PATTERN.test(variableName) && !isUiConstant && !isPublicUrlValue(literalValue) && !isPlaceholderValueForVariableHeuristic && !isSelfReferentialSentinelValue(variableName, literalValue) && !isIdentifierLikeKeyNameValue(literalValue) && literalValue.length > 24) {
+				if (shouldUseVariableNameHeuristic && !isServerOnlyScope && SECRET_VARIABLE_PATTERN.test(variableName) && !isUiConstant && !isPublicUrlValue(literalValue) && !isPlaceholderValueForVariableHeuristic && !isSelfReferentialSentinelValue(variableName, literalValue) && !isIdentifierLikeKeyNameValue(literalValue) && !isSelfReferentialSentinelValue(variableName, literalValue) && !isIdentifierLikeKeyNameValue(literalValue) && literalValue.length > 24) {
 					context.report({
 						node,
 						message: `Hardcoding "${variableName}" in client code is a security vulnerability: the secret ships to the browser where anyone can read it.`
@@ -36543,8 +36639,7 @@ const NAMED_EXPORT_MESSAGE = "This file exports non-components, so Fast Refresh
 const ANONYMOUS_MESSAGE = "This component is unnamed, so Fast Refresh can't track it and falls back to a full reload.";
 const EXPORT_ALL_MESSAGE = "`export *` hides what's exported, so Fast Refresh can't safely preserve component state.";
 const REACT_CONTEXT_MESSAGE = "This file exports a context with components, so Fast Refresh can't safely preserve component state.";
-const LOCAL_COMPONENT_MESSAGE = "This component is not exported, so Fast Refresh skips it and local edits can full-reload.";
-const NO_EXPORT_MESSAGE = "This file exports nothing, so Fast Refresh can't track the component and local edits can full-reload.";
+const NAMESPACE_OBJECT_MESSAGE = "This export bundles components inside an object, so Fast Refresh can't track them and falls back to a full reload.";
 const DEFAULT_REACT_HOCS = [
 	"memo",
 	"forwardRef",
@@ -36615,6 +36710,20 @@ const isReactComponentInitializer = (expression, state) => {
 	if (isNodeOfType(stripped, "CallExpression") && isHocCallee(stripped.callee, state) && stripped.arguments.length > 0) return true;
 	return false;
 };
+const objectExpressionBundlesComponents = (objectExpression, state) => {
+	for (const property of objectExpression.properties ?? []) {
+		if (!isNodeOfType(property, "Property")) continue;
+		const value = skipTsExpression(property.value);
+		if (isNodeOfType(value, "Identifier")) {
+			if (state.localComponentNames.has(value.name)) return true;
+			continue;
+		}
+		if (!(!property.computed && isNodeOfType(property.key, "Identifier") && isReactComponentName(property.key.name))) continue;
+		if (isNodeOfType(value, "ArrowFunctionExpression") || isNodeOfType(value, "FunctionExpression")) return true;
+		if (isNodeOfType(value, "CallExpression") && isHocCallee(value.callee, state) && value.arguments.length > 0) return true;
+	}
+	return false;
+};
 const classifyExport = (name, reportNode, isFunction, initializer, state) => {
 	if (initializer) {
 		const expression = skipTsExpression(initializer);
@@ -36645,6 +36754,10 @@ const classifyExport = (name, reportNode, isFunction, initializer, state) => {
 				reportNode
 			};
 		}
+		if (isNodeOfType(stripped, "ObjectExpression") && objectExpressionBundlesComponents(stripped, state)) return {
+			kind: "namespace-object",
+			reportNode
+		};
 		if (NOT_REACT_COMPONENT_EXPRESSION_TYPES.has(stripped.type)) return {
 			kind: "non-component",
 			reportNode
@@ -36661,7 +36774,7 @@ const collectRelevantNodes = (programRoot) => {
 	walkAst(programRoot, (child) => {
 		const childType = child.type;
 		if (childType === "ExportAllDeclaration" || childType === "ExportDefaultDeclaration" || childType === "ExportNamedDeclaration") exportNodes.push(child);
-		else if (childType === "FunctionDeclaration" || childType === "VariableDeclarator") componentCandidates.push(child);
+		else if (childType === "FunctionDeclaration" || childType === "VariableDeclarator" || childType === "ClassDeclaration") componentCandidates.push(child);
 	});
 	return {
 		exportNodes,
@@ -36706,18 +36819,31 @@ const onlyExportComponents = defineRule({
 	category: "Architecture",
 	create: (context) => {
 		const settings = resolveSettings$6(context.settings);
-		const state = {
-			customHocs: new Set([...DEFAULT_REACT_HOCS, ...settings.customHOCs]),
-			allowExportNames: new Set(settings.allowExportNames),
-			allowConstantExport: settings.allowConstantExport
-		};
 		return { Program(node) {
 			if (!isFileNameAllowed(normalizeFilename(context.filename ?? ""), settings.checkJS)) return;
 			const { exportNodes, componentCandidates } = collectRelevantNodes(node);
+			const localComponentNames = /* @__PURE__ */ new Set();
+			const state = {
+				customHocs: new Set([...DEFAULT_REACT_HOCS, ...settings.customHOCs]),
+				allowExportNames: new Set(settings.allowExportNames),
+				allowConstantExport: settings.allowConstantExport,
+				localComponentNames
+			};
+			for (const child of componentCandidates) {
+				if (isNodeOfType(child, "FunctionDeclaration") && child.id) {
+					if (isReactComponentName(child.id.name) && !isInsideFunctionScope(child)) localComponentNames.add(child.id.name);
+				}
+				if (isNodeOfType(child, "ClassDeclaration") && child.id) {
+					if (isReactComponentName(child.id.name) && isEs6Component(child) && !isInsideFunctionScope(child)) localComponentNames.add(child.id.name);
+				}
+				if (isNodeOfType(child, "VariableDeclarator") && isNodeOfType(child.id, "Identifier")) {
+					const initializer = child.init;
+					if (isReactComponentName(child.id.name) && (canBeReactFunctionComponent(initializer, state) || (initializer ? isEs6Component(skipTsExpression(initializer)) : false)) && !isInsideFunctionScope(child)) localComponentNames.add(child.id.name);
+				}
+			}
 			const exports = [];
 			let hasReactExport = false;
 			let hasAnyExports = false;
-			const localComponents = [];
 			const isExportedNodeIds = /* @__PURE__ */ new WeakSet();
 			for (const child of exportNodes) {
 				if (isNodeOfType(child, "ExportAllDeclaration")) {
@@ -36788,7 +36914,14 @@ const onlyExportComponents = defineRule({
 						});
 						continue;
 					}
-					if (isNodeOfType(stripped, "ArrowFunctionExpression") || isNodeOfType(stripped, "ObjectExpression") || isNodeOfType(stripped, "Literal")) {
+					if (isNodeOfType(stripped, "ObjectExpression")) {
+						context.report({
+							node: stripped,
+							message: objectExpressionBundlesComponents(stripped, state) ? NAMESPACE_OBJECT_MESSAGE : ANONYMOUS_MESSAGE
+						});
+						continue;
+					}
+					if (isNodeOfType(stripped, "ArrowFunctionExpression") || isNodeOfType(stripped, "Literal")) {
 						context.report({
 							node: stripped,
 							message: ANONYMOUS_MESSAGE
@@ -36841,32 +36974,23 @@ const onlyExportComponents = defineRule({
 						let entry;
 						if (exportedName === "default" && localName) entry = classifyExport(localName, reportNode, false, null, state);
 						else if (exportedName) entry = classifyExport(exportedName, reportNode, false, null, state);
-						else entry = {
-							kind: "non-component",
-							reportNode
-						};
+						else {
+							entry = {
+								kind: "non-component",
+								reportNode
+							};
+							if (localName && isReactComponentName(localName)) exports.push({ kind: "react-component" });
+						}
 						if (isReExportFromSource && entry.kind !== "react-component") continue;
 						exports.push(entry);
 					}
 				}
 			}
 			for (const entry of exports) if (entry.kind === "react-component") hasReactExport = true;
-			const isInsideExport = (node) => {
-				let walker = node.parent;
-				while (walker) {
-					if (isNodeOfType(walker, "ExportNamedDeclaration") || isNodeOfType(walker, "ExportDefaultDeclaration") || isNodeOfType(walker, "ExportAllDeclaration")) return true;
-					walker = walker.parent ?? null;
-				}
-				return false;
-			};
-			for (const child of componentCandidates) {
-				if (isNodeOfType(child, "FunctionDeclaration") && child.id) {
-					if (isReactComponentName(child.id.name) && !isInsideExport(child) && !isInsideFunctionScope(child)) localComponents.push(child.id);
-				}
-				if (isNodeOfType(child, "VariableDeclarator") && isNodeOfType(child.id, "Identifier")) {
-					if (isReactComponentName(child.id.name) && canBeReactFunctionComponent(child.init, state) && !isInsideExport(child) && !isInsideFunctionScope(child)) localComponents.push(child.id);
-				}
-			}
+			for (const entry of exports) if (entry.kind === "namespace-object") context.report({
+				node: entry.reportNode,
+				message: NAMESPACE_OBJECT_MESSAGE
+			});
 			if (hasAnyExports && hasReactExport) for (const entry of exports) {
 				if (entry.kind === "non-component") context.report({
 					node: entry.reportNode,
@@ -36877,14 +37001,6 @@ const onlyExportComponents = defineRule({
 					message: REACT_CONTEXT_MESSAGE
 				});
 			}
-			else if (hasAnyExports && !hasReactExport && localComponents.length > 0) for (const local of localComponents) context.report({
-				node: local,
-				message: LOCAL_COMPONENT_MESSAGE
-			});
-			else if (!hasAnyExports && localComponents.length > 0) for (const local of localComponents) context.report({
-				node: local,
-				message: NO_EXPORT_MESSAGE
-			});
 		} };
 	}
 });
@@ -37682,8 +37798,8 @@ const preferHtmlDialog = defineRule({
 				if (!HTML_TAGS.has(tagName)) return;
 				const roleAttribute = findJsxAttribute(node.attributes, "role");
 				if (roleAttribute) {
-					const roleValue = getJsxPropStringValue(roleAttribute);
-					if (roleValue !== null && ROLE_DIALOG_VALUES.has(roleValue)) {
+					const roleCandidates = getJsxPropStaticStringValues(roleAttribute, context.scopes);
+					if (roleCandidates !== null && roleCandidates.length > 0 && roleCandidates.every((candidate) => ROLE_DIALOG_VALUES.has(candidate))) {
 						if (focusTrapSignals && isElementFocusTrapped(node, focusTrapSignals)) return;
 						const ariaModalAttribute = findJsxAttribute(node.attributes, "aria-modal");
 						const isModal = ariaModalAttribute ? isAriaModalTrue(ariaModalAttribute) : false;
@@ -37962,7 +38078,7 @@ const preferModuleScopeStaticValue = defineRule({
 	tags: ["test-noise"],
 	severity: "warn",
 	category: "Architecture",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Move the value above the component, at the top of the file. It doesn't use local state, so rebuilding it each update is wasted and makes it look new every time.",
 	create: (context) => ({ VariableDeclarator(node) {
 		if (!isNodeOfType(node.id, "Identifier")) return;
@@ -38032,7 +38148,7 @@ const preferStableEmptyFallback = defineRule({
 	tags: ["react-jsx-only", "test-noise"],
 	severity: "warn",
 	category: "Performance",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Make a `const EMPTY = []` (or `{}`) at module scope and use it as the `||` / `??` fallback, so the value stays the same each render.",
 	create: (context) => {
 		let memoRegistry = null;
@@ -39361,7 +39477,7 @@ const reduxUseselectorInlineDerivation = defineRule({
 	title: "useSelector derives data inline",
 	severity: "warn",
 	category: "Performance",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Select the raw slice and memoize derivation so Redux actions do not rebuild a collection and redraw this component.",
 	create: (context) => {
 		let aliases = /* @__PURE__ */ new Set();
@@ -39421,7 +39537,7 @@ const reduxUseselectorReturnsNewCollection = defineRule({
 	title: "useSelector returns a new collection",
 	severity: "warn",
 	category: "Performance",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Return a stable selected value, split selectors, or pass `shallowEqual` so every Redux action does not redraw this component.",
 	create: (context) => {
 		let aliases = /* @__PURE__ */ new Set();
@@ -39721,7 +39837,7 @@ const renderingHydrationMismatchTime = defineRule({
 	title: "Time or random value in JSX",
 	severity: "warn",
 	category: "Correctness",
-	disabledBy: ["vite", "cra"],
+	disabledWhen: ["vite", "cra"],
 	recommendation: "Move time or random values into useEffect+useState so they only run in the browser, or add suppressHydrationWarning to the parent if it's intentional",
 	create: (context) => {
 		const isTestlikeFile = isTestlikeFilename(context.filename);
@@ -40672,6 +40788,7 @@ const rerenderLazyRefInit = defineRule({
 		const memberPropertyName = isNodeOfType(callee, "MemberExpression") && (isNodeOfType(callee.property, "Identifier") || isNodeOfType(callee.property, "PrivateIdentifier")) ? callee.property.name : null;
 		const calleeName = isNodeOfType(callee, "Identifier") ? callee.name : memberPropertyName ?? "fn";
 		if (TRIVIAL_INITIALIZER_NAMES.has(calleeName)) return;
+		if (isNewCall && TRIVIAL_CONSTRUCTOR_NAMES.has(calleeName)) return;
 		if (isPlainCall && isReactHookName(calleeName)) return;
 		const callShape = isNewCall ? `new ${calleeName}()` : `${calleeName}()`;
 		context.report({
@@ -40704,18 +40821,6 @@ const TRIVIAL_DATE_GETTER_NAMES = new Set([
 	"getUTCMilliseconds",
 	"valueOf"
 ]);
-const TRIVIAL_CONSTRUCTOR_NAMES = new Set([
-	"Date",
-	"Map",
-	"Set",
-	"WeakMap",
-	"WeakSet",
-	"RegExp",
-	"Error",
-	"URL",
-	"URLSearchParams",
-	"AbortController"
-]);
 const EAGER_CALL_RESOLUTION_DEPTH_LIMIT = 4;
 const findEagerInitializerCall = (expression, depth = 0) => {
 	if (depth > EAGER_CALL_RESOLUTION_DEPTH_LIMIT) return null;
@@ -41459,7 +41564,7 @@ const rnBottomSheetPreferNative = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-native/rn-detox-missing-await.ts
-const EMPTY_VISITORS$4 = {};
+const EMPTY_VISITORS$5 = {};
 const DETOX_TEST_FILE = /(\.e2e\.[cm]?[jt]sx?$)|((^|\/)e2e\/)/;
 const DETOX_ELEMENT_ACTIONS = new Set([
 	"tap",
@@ -41519,7 +41624,7 @@ const rnDetoxMissingAwait = defineRule({
 	recommendation: "Prepend `await` to Detox actions, `waitFor(...)` chains, and `expect(element(...))` assertions. They return promises tied to Detox's synchronization, so a missing await runs steps out of order.",
 	create: (context) => {
 		const filename = normalizeFilename(context.filename ?? "");
-		if (!filename || !DETOX_TEST_FILE.test(filename)) return EMPTY_VISITORS$4;
+		if (!filename || !DETOX_TEST_FILE.test(filename)) return EMPTY_VISITORS$5;
 		return { ExpressionStatement(node) {
 			const expression = node.expression;
 			if (!isNodeOfType(expression, "CallExpression")) return;
@@ -41688,7 +41793,7 @@ const rnListCallbackPerRow = defineRule({
 	tags: ["test-noise"],
 	requires: ["react-native"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Move the handler out with useCallback at list scope and pass the row id as a prop. Then memo() rows skip redrawing when their data has not changed.",
 	create: (context) => {
 		const inspect = (node) => {
@@ -42316,7 +42421,7 @@ const rnNoInlineFlatlistRenderitem = defineRule({
 	tags: ["test-noise"],
 	requires: ["react-native"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Move renderItem to a named function or wrap it in useCallback so it is not rebuilt every time the screen redraws.",
 	create: (context) => ({ JSXAttribute(node) {
 		if (!isNodeOfType(node.name, "JSXIdentifier") || node.name.name !== "renderItem") return;
@@ -42341,7 +42446,7 @@ const rnNoInlineObjectInListItem = defineRule({
 	tags: ["test-noise"],
 	requires: ["react-native"],
 	severity: "warn",
-	disabledBy: ["react-compiler"],
+	disabledWhen: ["react-compiler"],
 	recommendation: "Move style and object props out of renderItem (StyleSheet.create, useMemo at list scope, or pass primitives) so memo() rows stop redrawing when their data has not changed.",
 	create: (context) => {
 		const renderPropStack = [];
@@ -42494,7 +42599,7 @@ const isLegacyArchReactNativeFile = (filename) => {
 };
 //#endregion
 //#region src/plugin/rules/react-native/rn-no-legacy-shadow-styles.ts
-const EMPTY_VISITORS$3 = {};
+const EMPTY_VISITORS$4 = {};
 const reportLegacyShadowProperties = (objectExpression, context) => {
 	const legacyShadowPropertyNames = [];
 	for (const property of objectExpression.properties ?? []) {
@@ -42517,7 +42622,7 @@ const rnNoLegacyShadowStyles = defineRule({
 	severity: "warn",
 	recommendation: "Use `boxShadow` for shadows that work on both platforms on the new architecture, instead of platform-specific shadow properties.",
 	create: (context) => {
-		if (context.filename && isLegacyArchReactNativeFile(normalizeFilename(context.filename))) return EMPTY_VISITORS$3;
+		if (context.filename && isLegacyArchReactNativeFile(normalizeFilename(context.filename))) return EMPTY_VISITORS$4;
 		return {
 			JSXAttribute(node) {
 				if (!isNodeOfType(node.name, "JSXIdentifier")) return;
@@ -43438,7 +43543,7 @@ const isExpoManagedFileActive = (context) => {
 };
 //#endregion
 //#region src/plugin/rules/react-native/rn-prefer-expo-image.ts
-const EMPTY_VISITORS$2 = {};
+const EMPTY_VISITORS$3 = {};
 const BUNDLED_ASSET_SOURCE_PATTERN = /\.(?:png|jpe?g|gif|webp|bmp)$/i;
 const MEMBER_PATH_FAN_OUT_LIMIT = 32;
 const isRequireOfBundledAsset = (node) => isNodeOfType(node, "CallExpression") && isNodeOfType(node.callee, "Identifier") && node.callee.name === "require" && node.arguments?.length === 1 && isNodeOfType(node.arguments[0], "Literal") && typeof node.arguments[0].value === "string" && BUNDLED_ASSET_SOURCE_PATTERN.test(node.arguments[0].value);
@@ -43472,7 +43577,7 @@ const rnPreferExpoImage = defineRule({
 	severity: "warn",
 	recommendation: "Use `<Image>` from `expo-image` instead of `react-native`. Same props, plus caching, placeholders, and crossfades for faster image loading.",
 	create: (context) => {
-		if (!isExpoManagedFileActive(context)) return EMPTY_VISITORS$2;
+		if (!isExpoManagedFileActive(context)) return EMPTY_VISITORS$3;
 		const flaggedImports = [];
 		const assetBindingNames = /* @__PURE__ */ new Set();
 		const moduleObjectLiterals = /* @__PURE__ */ new Map();
@@ -43959,7 +44064,7 @@ const rnScrollviewFlexInContentContainer = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-native/rn-style-prefer-box-shadow.ts
-const EMPTY_VISITORS$1 = {};
+const EMPTY_VISITORS$2 = {};
 const IOS_SHADOW_KEYS = new Set([
 	"shadowColor",
 	"shadowOffset",
@@ -44045,7 +44150,7 @@ const rnStylePreferBoxShadow = defineRule({
 	severity: "warn",
 	recommendation: "These shadow keys only work on one platform. On RN v7+, use the CSS `boxShadow` string instead, like `boxShadow: \"0 2px 8px rgba(0,0,0,0.1)\"`, which works on both.",
 	create: (context) => {
-		if (context.filename && isLegacyArchReactNativeFile(normalizeFilename(context.filename))) return EMPTY_VISITORS$1;
+		if (context.filename && isLegacyArchReactNativeFile(normalizeFilename(context.filename))) return EMPTY_VISITORS$2;
 		return {
 			JSXAttribute(node) {
 				if (!isNodeOfType(node.name, "JSXIdentifier")) return;
@@ -44142,9 +44247,9 @@ const roleHasRequiredAriaProps = defineRule({
 		if (!HTML_TAGS.has(elementType)) return;
 		const roleAttribute = hasJsxPropIgnoreCase(node.attributes, "role");
 		if (!roleAttribute) return;
-		const roleValue = getJsxPropStringValue(roleAttribute);
-		if (roleValue === null) return;
-		const roles = roleValue.split(/\s+/).filter((token) => token.length > 0);
+		const roleCandidates = getJsxPropStaticStringValues(roleAttribute, context.scopes);
+		if (roleCandidates === null) return;
+		const roles = new Set(roleCandidates.flatMap((candidate) => candidate.split(/\s+/).filter((token) => token.length > 0)));
 		for (const role of roles) {
 			const required = ROLE_REQUIRED_PROPS.get(role);
 			if (!required) continue;
@@ -47261,7 +47366,9 @@ const ROLE_SUPPORTS_ARIA_PROPS = {
 };
 //#endregion
 //#region src/plugin/rules/a11y/role-supports-aria-props.ts
-const buildMessageDefault = (role, propName) => `Screen reader users get no help from \`${propName}\` because role \`${role}\` ignores it, so remove it or change the role.`;
+const buildMessageDefault = (roles, propName) => {
+	return `Screen reader users get no help from \`${propName}\` because role ${roles.map((role) => `\`${role}\``).join(" / ")} ignores it, so remove it or change the role.`;
+};
 const buildMessageImplicit = (role, propName, elementType) => `Screen reader users get no help from \`${propName}\` because \`${elementType}\` has role \`${role}\`, which ignores it, so remove \`${propName}\` or change the element.`;
 const roleSupportsAriaProps = defineRule({
 	id: "role-supports-aria-props",
@@ -47289,17 +47396,21 @@ const roleSupportsAriaProps = defineRule({
 		if (!ariaAttributes) return;
 		const elementType = getElementType(node, context.settings);
 		const roleAttribute = hasJsxPropIgnoreCase(node.attributes, "role");
-		const role = roleAttribute ? getJsxPropStringValue(roleAttribute) : getImplicitRole(node, elementType);
-		if (!role) return;
-		if (!VALID_ARIA_ROLES.has(role)) return;
+		const roleCandidates = roleAttribute ? getJsxPropStaticStringValues(roleAttribute, context.scopes) : [getImplicitRole(node, elementType)].filter((role) => role !== null);
+		if (roleCandidates === null || roleCandidates.length === 0) return;
+		const supportedSets = [];
+		for (const role of roleCandidates) {
+			if (!VALID_ARIA_ROLES.has(role)) return;
+			const supported = ROLE_SUPPORTS_ARIA_PROPS[role];
+			if (!supported) return;
+			supportedSets.push(supported);
+		}
 		const isImplicit = !roleAttribute;
-		const supported = ROLE_SUPPORTS_ARIA_PROPS[role];
-		if (!supported) return;
 		for (const { attribute, propName } of ariaAttributes) {
-			if (supported.has(propName)) continue;
+			if (supportedSets.some((supported) => supported.has(propName))) continue;
 			context.report({
 				node: attribute,
-				message: isImplicit ? buildMessageImplicit(role, propName, elementType) : buildMessageDefault(role, propName)
+				message: isImplicit ? buildMessageImplicit(roleCandidates[0], propName, elementType) : buildMessageDefault(roleCandidates, propName)
 			});
 		}
 	} })
@@ -47651,11 +47762,15 @@ const isUseEffectEventSymbol = (symbol) => {
 	if (!initializer || !isNodeOfType(initializer, "CallExpression")) return false;
 	return getHookNameFromCallee(initializer.callee) === "useEffectEvent";
 };
-const isNonReactEffectEventCallee = (callee, contextNode) => isNodeOfType(callee, "Identifier") && isImportedFromNonReactModule(contextNode, callee.name);
-const isNonReactEffectEventSymbol = (symbol, contextNode) => {
+const resolvesToLocalNonImportBinding = (identifier, scopes) => {
+	const symbol = scopes.referenceFor(identifier)?.resolvedSymbol;
+	return Boolean(symbol && symbol.kind !== "import");
+};
+const isNonReactEffectEventCallee = (callee, contextNode, scopes) => isNodeOfType(callee, "Identifier") && (isImportedFromNonReactModule(contextNode, callee.name) || resolvesToLocalNonImportBinding(callee, scopes));
+const isNonReactEffectEventSymbol = (symbol, contextNode, scopes) => {
 	const initializer = symbol.initializer;
 	if (!initializer || !isNodeOfType(initializer, "CallExpression")) return false;
-	return isNonReactEffectEventCallee(initializer.callee, contextNode);
+	return isNonReactEffectEventCallee(initializer.callee, contextNode, scopes);
 };
 const findEnclosingComponentOrHookFunction = (node) => {
 	let current = node.parent;
@@ -47734,7 +47849,7 @@ const rulesOfHooks = defineRule({
 				const hookContext = isHookCall$1(node, context.scopes, settings);
 				if (!hookContext) return;
 				const { hookName } = hookContext;
-				if (hookName === "useEffectEvent" && !isUseEffectEventInitializer(node) && !isNonReactEffectEventCallee(node.callee, node)) {
+				if (hookName === "useEffectEvent" && !isUseEffectEventInitializer(node) && !isNonReactEffectEventCallee(node.callee, node, context.scopes)) {
 					context.report({
 						node: node.callee,
 						message: buildEffectEventPassedDownMessage()
@@ -47847,7 +47962,7 @@ const rulesOfHooks = defineRule({
 			Identifier(node) {
 				const symbol = context.scopes.referenceFor(node)?.resolvedSymbol;
 				if (!symbol || !isUseEffectEventSymbol(symbol)) return;
-				if (isNonReactEffectEventSymbol(symbol, node)) return;
+				if (isNonReactEffectEventSymbol(symbol, node, context.scopes)) return;
 				if (!isSameComponentOrHookScope(symbol, node)) return;
 				if (isInsideAllowedEffectEventCallback(node, additionalEffectHooksRegex)) return;
 				context.report({
@@ -48452,7 +48567,7 @@ const serverFetchWithoutRevalidate = defineRule({
 	id: "server-fetch-without-revalidate",
 	title: "Fetch without revalidate",
 	severity: "warn",
-	disabledBy: ["nextjs:15"],
+	disabledWhen: ["nextjs:15", "nextjs:static-export"],
 	recommendation: "Pass `{ next: { revalidate: <seconds> } }` (or `cache: \"no-store\"`) so old data doesn't stick around.",
 	create: (context) => {
 		let isServerSideFile = false;
@@ -55419,6 +55534,34 @@ const reactDoctorRules = [
 ];
 const ruleRegistry = Object.fromEntries(reactDoctorRules.map((rule) => [rule.id, rule.rule]));
 //#endregion
+//#region src/plugin/utils/is-next-file.ts
+const isNextFileActive = (context) => {
+	const rawFilename = context.filename;
+	if (!rawFilename) return true;
+	const filename = normalizeFilename(rawFilename);
+	const manifest = readNearestPackageManifest(filename);
+	if (!manifest) return true;
+	if (declaresDependency(manifest, "next")) return true;
+	if (!declaresAnyDependency(manifest)) return true;
+	const packageDirectory = findNearestPackageDirectory(filename);
+	const rootDirectory = getReactDoctorStringSetting(context.settings, "rootDirectory");
+	if (packageDirectory !== null && isPackageNestedBelowProjectRoot(packageDirectory, rootDirectory)) return false;
+	return true;
+};
+//#endregion
+//#region src/plugin/utils/wrap-nextjs-rule.ts
+const EMPTY_VISITORS$1 = {};
+const wrapNextjsRule = (rule) => {
+	const innerCreate = rule.create.bind(rule);
+	return {
+		...rule,
+		create: (context) => {
+			if (!isNextFileActive(context)) return EMPTY_VISITORS$1;
+			return innerCreate(context);
+		}
+	};
+};
+//#endregion
 //#region src/plugin/utils/wrap-react-native-rule.ts
 const EMPTY_VISITORS = {};
 const wrapReactNativeRule = (rule) => {
@@ -55888,9 +56031,14 @@ const wrapWithSemanticContext = (rule) => ({
 });
 //#endregion
 //#region src/plugin/react-doctor-plugin.ts
+const applyFrameworkGate = (rule) => {
+	if (rule.framework === "react-native") return wrapReactNativeRule(rule);
+	if (rule.framework === "nextjs") return wrapNextjsRule(rule);
+	return rule;
+};
 const applyFrameworkRuleWrappers = (registry) => {
 	const wrapped = {};
-	for (const [ruleId, rule] of Object.entries(registry)) wrapped[ruleId] = wrapWithSemanticContext(rule.framework === "react-native" ? wrapReactNativeRule(rule) : rule);
+	for (const [ruleId, rule] of Object.entries(registry)) wrapped[ruleId] = wrapWithSemanticContext(applyFrameworkGate(rule));
 	return wrapped;
 };
 const plugin = {
@@ -56227,9 +56375,23 @@ const classifySecurityScanFile = (relativePath) => {
 };
 const shouldReadSecurityScanContent = (relativePath, isGeneratedBundle) => isGeneratedBundle || isProbablyTextFile(relativePath) || isConfigOrCiPath(relativePath) || isRepositorySecretFilePath(relativePath);
 //#endregion
+//#region src/plugin/utils/capability.ts
+const FRAMEWORK_TOKENS = [
+	"nextjs",
+	"vite",
+	"cra",
+	"remix",
+	"gatsby",
+	"expo",
+	"react-native",
+	"tanstack-start",
+	"preact",
+	"unknown"
+];
+//#endregion
 //#region src/index.ts
 var src_default = plugin;
 //#endregion
-export { ALL_REACT_DOCTOR_RULES, ALL_REACT_DOCTOR_RULE_KEYS, CROSS_FILE_DEPENDENCY_COLLECTORS, CROSS_FILE_RULE_IDS, EXTERNAL_RULES, FRAMEWORK_SPECIFIC_RULE_KEYS, MOTION_LIBRARY_PACKAGES, NEXTJS_RULES, PREACT_RULES, REACT_COMPILER_RULES, REACT_DOCTOR_RULES, REACT_NATIVE_DEPENDENCY_NAMES, REACT_NATIVE_DEPENDENCY_PREFIXES, REACT_NATIVE_RULES, RECOMMENDED_RULES, RULES, TANSTACK_QUERY_RULES, TANSTACK_START_RULES, UNBOUNDED_CROSS_FILE_RULE_IDS, classifySecurityScanFile, collectCrossFileDependencyProbes, src_default as default, isReactNativeDependencyName, resetManifestCaches, shouldReadSecurityScanContent };
+export { ALL_REACT_DOCTOR_RULES, ALL_REACT_DOCTOR_RULE_KEYS, CROSS_FILE_DEPENDENCY_COLLECTORS, CROSS_FILE_RULE_IDS, EXTERNAL_RULES, FRAMEWORK_SPECIFIC_RULE_KEYS, FRAMEWORK_TOKENS, MOTION_LIBRARY_PACKAGES, NEXTJS_RULES, PREACT_RULES, REACT_COMPILER_RULES, REACT_DOCTOR_RULES, REACT_NATIVE_DEPENDENCY_NAMES, REACT_NATIVE_DEPENDENCY_PREFIXES, REACT_NATIVE_RULES, RECOMMENDED_RULES, RULES, TANSTACK_QUERY_RULES, TANSTACK_START_RULES, UNBOUNDED_CROSS_FILE_RULE_IDS, classifySecurityScanFile, collectCrossFileDependencyProbes, src_default as default, isReactNativeDependencyName, resetManifestCaches, shouldReadSecurityScanContent };
 
 //# sourceMappingURL=index.js.map