oxlint-plugin-react-doctor 0.4.0 → 0.4.1-dev.d17dc87

package/dist/index.js

@@ -1,8 +1,8 @@
 import * as path from "node:path";
-import { analyze } from "eslint-scope";
-import * as eslintVisitorKeys from "eslint-visitor-keys";
 import * as fs from "node:fs";
 import { parseSync } from "oxc-parser";
+import { analyze } from "eslint-scope";
+import * as eslintVisitorKeys from "eslint-visitor-keys";
 //#region src/plugin/utils/is-testlike-filename.ts
 const NON_PRODUCTION_PATH_SEGMENTS = [
 	"/test/",
@@ -829,6 +829,9 @@ const isNextjsMetadataImageRouteFilename = (rawFilename) => {
 	return /^(opengraph-image|twitter-image|icon|apple-icon)\d*\.(jsx?|tsx?)$/.test(path.basename(rawFilename));
 };
 //#endregion
+//#region src/plugin/utils/normalize-filename.ts
+const normalizeFilename$1 = (filename) => filename.replaceAll("\\", "/");
+//#endregion
 //#region src/plugin/utils/is-hidden-from-screen-reader.ts
 const isHiddenFromScreenReader = (openingElement, settings) => {
 	if (getElementType(openingElement, settings).toLowerCase() === "input") {
@@ -1000,7 +1003,7 @@ const altText = defineRule({
 	recommendation: "Give every meaningful image an `alt`, `aria-label`, or `aria-labelledby`.",
 	category: "Accessibility",
 	create: (context) => {
-		if (isNextjsMetadataImageRouteFilename(context.filename)) return {};
+		if (isNextjsMetadataImageRouteFilename(normalizeFilename$1(context.filename ?? ""))) return {};
 		const settings = resolveSettings$53(context.settings);
 		const checkImg = !settings.elements || settings.elements.includes("img");
 		const checkObject = !settings.elements || settings.elements.includes("object");
@@ -1102,7 +1105,7 @@ const anchorAmbiguousText = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/anchor-has-content.ts
-const MESSAGE$50 = "Blind users can't follow this link because screen readers announce nothing, so add visible text, `aria-label`, or `aria-labelledby`.";
+const MESSAGE$51 = "Blind users can't follow this link because screen readers announce nothing, so add visible text, `aria-label`, or `aria-labelledby`.";
 const anchorHasContent = defineRule({
 	id: "anchor-has-content",
 	title: "Anchor has no content",
@@ -1118,7 +1121,7 @@ const anchorHasContent = defineRule({
 		for (const attribute of ["title", "aria-label"]) if (hasJsxPropIgnoreCase(opening.attributes, attribute)) return;
 		context.report({
 			node: opening.name,
-			message: MESSAGE$50
+			message: MESSAGE$51
 		});
 	} })
 });
@@ -1512,7 +1515,7 @@ const parseJsxValue = (value) => {
 };
 //#endregion
 //#region src/plugin/rules/a11y/aria-activedescendant-has-tabindex.ts
-const MESSAGE$49 = "Keyboard users can't focus this element with `aria-activedescendant` because it isn't tabbable, so add `tabIndex={0}`.";
+const MESSAGE$50 = "Keyboard users can't focus this element with `aria-activedescendant` because it isn't tabbable, so add `tabIndex={0}`.";
 const ariaActivedescendantHasTabindex = defineRule({
 	id: "aria-activedescendant-has-tabindex",
 	title: "aria-activedescendant missing tabindex",
@@ -1530,14 +1533,14 @@ const ariaActivedescendantHasTabindex = defineRule({
 			if (tabIndexValue === null || tabIndexValue >= -1) return;
 			context.report({
 				node: node.name,
-				message: MESSAGE$49
+				message: MESSAGE$50
 			});
 			return;
 		}
 		if (isInteractiveElement(tag, node)) return;
 		context.report({
 			node: node.name,
-			message: MESSAGE$49
+			message: MESSAGE$50
 		});
 	} })
 });
@@ -3073,9 +3076,6 @@ const asyncDeferAwait = defineRule({
 	}
 });
 //#endregion
-//#region src/plugin/utils/normalize-filename.ts
-const normalizeFilename$1 = (filename) => filename.replaceAll("\\", "/");
-//#endregion
 //#region src/plugin/utils/get-callee-identifier-trail.ts
 const getCalleeIdentifierTrail = (call) => {
 	let entry = call;
@@ -3551,7 +3551,7 @@ const isPureEventBlockerHandler = (attribute) => {
 //#endregion
 //#region src/plugin/rules/a11y/click-events-have-key-events.ts
 const PRESENTATION_ROLES$1 = new Set(["presentation", "none"]);
-const MESSAGE$48 = "Keyboard users can't trigger this click handler because there's no keyboard one, so add `onKeyUp`, `onKeyDown`, or `onKeyPress`.";
+const MESSAGE$49 = "Keyboard users can't trigger this click handler because there's no keyboard one, so add `onKeyUp`, `onKeyDown`, or `onKeyPress`.";
 const KEY_HANDLERS = [
 	"onKeyUp",
 	"onKeyDown",
@@ -3583,7 +3583,7 @@ const clickEventsHaveKeyEvents = defineRule({
 			if (KEY_HANDLERS.some((handler) => hasJsxPropIgnoreCase(node.attributes, handler))) return;
 			context.report({
 				node: node.name,
-				message: MESSAGE$48
+				message: MESSAGE$49
 			});
 		} };
 	}
@@ -3696,7 +3696,7 @@ const stripParenExpression = (node) => {
 };
 //#endregion
 //#region src/plugin/rules/a11y/control-has-associated-label.ts
-const MESSAGE$47 = "Blind users can't tell what this control does because screen readers find no label, so add visible text, `aria-label`, or `aria-labelledby`.";
+const MESSAGE$48 = "Blind users can't tell what this control does because screen readers find no label, so add visible text, `aria-label`, or `aria-labelledby`.";
 const DEFAULT_IGNORE_ELEMENTS = ["link", "canvas"];
 const DEFAULT_LABELLING_PROPS = [
 	"alt",
@@ -3857,7 +3857,7 @@ const controlHasAssociatedLabel = defineRule({
 			for (const child of node.children) if (checkChildForLabel(child, 1, checkContext)) return;
 			context.report({
 				node: opening,
-				message: MESSAGE$47
+				message: MESSAGE$48
 			});
 		} };
 	}
@@ -4193,7 +4193,7 @@ const isEs6Component = (node) => {
 };
 //#endregion
 //#region src/plugin/rules/react-builtins/display-name.ts
-const MESSAGE$46 = "This component shows up as Anonymous in React DevTools because it has no `displayName`.";
+const MESSAGE$47 = "This component shows up as Anonymous in React DevTools because it has no `displayName`.";
 const DEFAULT_ADDITIONAL_HOCS = [
 	"observer",
 	"lazy",
@@ -4396,7 +4396,7 @@ const displayName = defineRule({
 		const reportAt = (node) => {
 			context.report({
 				node,
-				message: MESSAGE$46
+				message: MESSAGE$47
 			});
 		};
 		return {
@@ -6507,7 +6507,7 @@ const forbidElements = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/forward-ref-uses-ref.ts
-const MESSAGE$45 = "The parent can't reach this component's node because the `forwardRef` wrapper ignores `ref`.";
+const MESSAGE$46 = "The parent can't reach this component's node because the `forwardRef` wrapper ignores `ref`.";
 const forwardRefUsesRef = defineRule({
 	id: "forward-ref-uses-ref",
 	title: "forwardRef without ref parameter",
@@ -6527,13 +6527,13 @@ const forwardRefUsesRef = defineRule({
 		if (isNodeOfType(onlyParam, "RestElement")) return;
 		context.report({
 			node: inner,
-			message: MESSAGE$45
+			message: MESSAGE$46
 		});
 	} })
 });
 //#endregion
 //#region src/plugin/rules/a11y/heading-has-content.ts
-const MESSAGE$44 = "Blind users can't use this heading to navigate because screen readers skip it empty, so add text, `aria-label`, or `aria-labelledby`.";
+const MESSAGE$45 = "Blind users can't use this heading to navigate because screen readers skip it empty, so add text, `aria-label`, or `aria-labelledby`.";
 const DEFAULT_HEADING_TAGS = [
 	"h1",
 	"h2",
@@ -6566,7 +6566,7 @@ const headingHasContent = defineRule({
 			if (isHiddenFromScreenReader(node, context.settings)) return;
 			context.report({
 				node,
-				message: MESSAGE$44
+				message: MESSAGE$45
 			});
 		} };
 	}
@@ -6704,7 +6704,7 @@ const hooksNoNanInDeps = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/html-has-lang.ts
-const MESSAGE$43 = "Screen readers may mispronounce this page because it doesn't declare a language, so add a `lang` attribute like `en`.";
+const MESSAGE$44 = "Screen readers may mispronounce this page because it doesn't declare a language, so add a `lang` attribute like `en`.";
 const resolveSettings$39 = (settings) => {
 	const reactDoctor = settings?.["react-doctor"];
 	return { htmlTags: (typeof reactDoctor === "object" && reactDoctor !== null ? reactDoctor.htmlHasLang ?? {} : {}).htmlTags ?? ["html"] };
@@ -6752,7 +6752,7 @@ const htmlHasLang = defineRule({
 			if (!lang) {
 				context.report({
 					node: node.name,
-					message: MESSAGE$43
+					message: MESSAGE$44
 				});
 				return;
 			}
@@ -6760,13 +6760,13 @@ const htmlHasLang = defineRule({
 			if (verdict === "missing" || verdict === "empty") {
 				context.report({
 					node: lang,
-					message: MESSAGE$43
+					message: MESSAGE$44
 				});
 				return;
 			}
 			if (hasSpread && !lang) context.report({
 				node: node.name,
-				message: MESSAGE$43
+				message: MESSAGE$44
 			});
 		} };
 	}
@@ -6980,7 +6980,7 @@ const htmlNoNestedInteractive = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/iframe-has-title.ts
-const MESSAGE$42 = "Blind users can't tell what this `<iframe>` holds because screen readers have no title to read, so add a `title` describing its content.";
+const MESSAGE$43 = "Blind users can't tell what this `<iframe>` holds because screen readers have no title to read, so add a `title` describing its content.";
 const evaluateTitleValue = (value) => {
 	if (!value) return "missing";
 	if (isNodeOfType(value, "Literal")) {
@@ -7020,14 +7020,14 @@ const iframeHasTitle = defineRule({
 		if (!titleAttr) {
 			if (hasSpread || tag === "iframe") context.report({
 				node: node.name,
-				message: MESSAGE$42
+				message: MESSAGE$43
 			});
 			return;
 		}
 		const verdict = evaluateTitleValue(titleAttr.value);
 		if (verdict === "missing" || verdict === "empty") context.report({
 			node: titleAttr,
-			message: MESSAGE$42
+			message: MESSAGE$43
 		});
 	} })
 });
@@ -7131,7 +7131,7 @@ const iframeMissingSandbox = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/img-redundant-alt.ts
-const MESSAGE$41 = "Screen reader users hear \"image\" or \"photo\" twice because they already announce it, so describe what the image shows instead.";
+const MESSAGE$42 = "Screen reader users hear \"image\" or \"photo\" twice because they already announce it, so describe what the image shows instead.";
 const DEFAULT_COMPONENTS = ["img"];
 const DEFAULT_REDUNDANT_WORDS = [
 	"image",
@@ -7194,7 +7194,7 @@ const imgRedundantAlt = defineRule({
 			if (!altAttribute) return;
 			if (altValueRedundant(altAttribute, settings.words)) context.report({
 				node: altAttribute,
-				message: MESSAGE$41
+				message: MESSAGE$42
 			});
 		} };
 	}
@@ -9595,7 +9595,7 @@ const jsxMaxDepth = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-comment-textnodes.ts
-const MESSAGE$40 = "Your users see this comment as text on the page because `//` & `/*` aren't hidden in JSX.";
+const MESSAGE$41 = "Your users see this comment as text on the page because `//` & `/*` aren't hidden in JSX.";
 const LITERAL_TEXT_TAGS = new Set([
 	"code",
 	"pre",
@@ -9631,7 +9631,7 @@ const jsxNoCommentTextnodes = defineRule({
 		if (isInsideLiteralTextTag(node)) return;
 		context.report({
 			node,
-			message: MESSAGE$40
+			message: MESSAGE$41
 		});
 	} })
 });
@@ -9662,7 +9662,7 @@ const isInsideFunctionScope = (node) => {
 };
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-constructed-context-values.ts
-const MESSAGE$39 = "Every reader of this context redraws on each render because you build its `value` inline.";
+const MESSAGE$40 = "Every reader of this context redraws on each render because you build its `value` inline.";
 const CONTEXT_MODULES$1 = [
 	"react",
 	"use-context-selector",
@@ -9760,7 +9760,7 @@ const jsxNoConstructedContextValues = defineRule({
 					if (!isConstructedValue(innerExpression)) continue;
 					context.report({
 						node: attribute,
-						message: MESSAGE$39
+						message: MESSAGE$40
 					});
 				}
 			}
@@ -9846,7 +9846,7 @@ const isJsxAttributeOnIntrinsicHtmlElement = (attribute) => {
 };
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-jsx-as-prop.ts
-const MESSAGE$38 = "This child redraws every render because the prop gets brand new JSX each time.";
+const MESSAGE$39 = "This child redraws every render because the prop gets brand new JSX each time.";
 const KNOWN_SLOT_PROP_NAMES = new Set([
 	"icon",
 	"Icon",
@@ -10115,7 +10115,7 @@ const jsxNoJsxAsProp = defineRule({
 				if (!isJsxProducingExpression(expressionNode) && !followsRenderLocalJsxBinding(expressionNode, node)) return;
 				context.report({
 					node,
-					message: MESSAGE$38
+					message: MESSAGE$39
 				});
 			}
 		};
@@ -10403,7 +10403,7 @@ const DATA_ARRAY_PROP_SUFFIXES = [
 ];
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-new-array-as-prop.ts
-const MESSAGE$37 = "This child redraws every render because the prop gets a brand new array each time.";
+const MESSAGE$38 = "This child redraws every render because the prop gets a brand new array each time.";
 const isDataArrayPropName = (propName) => {
 	if (DATA_ARRAY_PROP_NAMES.has(propName)) return true;
 	for (const suffix of DATA_ARRAY_PROP_SUFFIXES) if (propName.length > suffix.length && propName.endsWith(suffix)) return true;
@@ -10487,7 +10487,7 @@ const jsxNoNewArrayAsProp = defineRule({
 				if (!isArrayProducingExpression(expressionNode) && !followsRenderLocalArrayBinding(expressionNode, node)) return;
 				context.report({
 					node,
-					message: MESSAGE$37
+					message: MESSAGE$38
 				});
 			}
 		};
@@ -10745,7 +10745,7 @@ const SAFE_RECEIVER_NAMES = new Set([
 ]);
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-new-function-as-prop.ts
-const MESSAGE$36 = "This child redraws every render because the prop gets a brand new function each time.";
+const MESSAGE$37 = "This child redraws every render because the prop gets a brand new function each time.";
 const isAccessorPredicateName = (propName) => {
 	for (const prefix of ACCESSOR_PREDICATE_PREFIXES) {
 		if (propName.length <= prefix.length) continue;
@@ -10951,7 +10951,7 @@ const jsxNoNewFunctionAsProp = defineRule({
 				if (!isFunctionProducingExpression(expressionNode) && !followsRenderLocalFunctionBinding(expressionNode, node)) return;
 				context.report({
 					node,
-					message: MESSAGE$36
+					message: MESSAGE$37
 				});
 			}
 		};
@@ -11171,7 +11171,7 @@ const CONFIG_OBJECT_PROP_SUFFIXES = [
 ];
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-new-object-as-prop.ts
-const MESSAGE$35 = "This child redraws every render because the prop gets a brand new object each time.";
+const MESSAGE$36 = "This child redraws every render because the prop gets a brand new object each time.";
 const isConfigObjectPropName = (propName) => {
 	if (CONFIG_OBJECT_PROP_NAMES.has(propName)) return true;
 	for (const suffix of CONFIG_OBJECT_PROP_SUFFIXES) if (propName.length > suffix.length && propName.endsWith(suffix)) return true;
@@ -11259,7 +11259,7 @@ const jsxNoNewObjectAsProp = defineRule({
 				if (!isObjectProducingExpression(expressionNode) && !followsRenderLocalObjectBinding(expressionNode, node)) return;
 				context.report({
 					node,
-					message: MESSAGE$35
+					message: MESSAGE$36
 				});
 			}
 		};
@@ -11267,7 +11267,7 @@ const jsxNoNewObjectAsProp = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-no-script-url.ts
-const MESSAGE$34 = "A `javascript:` URL is an XSS hole that runs injected input as code.";
+const MESSAGE$35 = "A `javascript:` URL is an XSS hole that runs injected input as code.";
 const JAVASCRIPT_URL_PATTERN = /j[\r\n\t]*a[\r\n\t]*v[\r\n\t]*a[\r\n\t]*s[\r\n\t]*c[\r\n\t]*r[\r\n\t]*i[\r\n\t]*p[\r\n\t]*t[\r\n\t]*:/i;
 const resolveSettings$29 = (settings) => {
 	const reactDoctor = settings?.["react-doctor"];
@@ -11308,7 +11308,7 @@ const jsxNoScriptUrl = defineRule({
 				if (!value || !isNodeOfType(value, "Literal") || typeof value.value !== "string") continue;
 				if (JAVASCRIPT_URL_PATTERN.test(value.value)) context.report({
 					node: attribute,
-					message: MESSAGE$34
+					message: MESSAGE$35
 				});
 			}
 		} };
@@ -11904,7 +11904,7 @@ const jsxPropsNoSpreadMulti = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/jsx-props-no-spreading.ts
-const MESSAGE$33 = "You can't tell what props reach this element when you spread them.";
+const MESSAGE$34 = "You can't tell what props reach this element when you spread them.";
 const resolveSettings$25 = (settings) => {
 	const reactDoctor = settings?.["react-doctor"];
 	const ruleSettings = typeof reactDoctor === "object" && reactDoctor !== null ? reactDoctor.jsxPropsNoSpreading ?? {} : {};
@@ -11945,7 +11945,7 @@ const jsxPropsNoSpreading = defineRule({
 				}
 				context.report({
 					node: attribute,
-					message: MESSAGE$33
+					message: MESSAGE$34
 				});
 			}
 		} };
@@ -12101,7 +12101,7 @@ const labelHasAssociatedControl = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/lang.ts
-const MESSAGE$32 = "Screen readers can't pick the right voice because this `lang` isn't a real language code, so use a valid one like `en` or `en-US`.";
+const MESSAGE$33 = "Screen readers can't pick the right voice because this `lang` isn't a real language code, so use a valid one like `en` or `en-US`.";
 const COMMON_LANGUAGE_PRIMARY_TAGS = new Set([
 	"aa",
 	"ab",
@@ -12313,7 +12313,7 @@ const lang = defineRule({
 			if (expression.type === "Identifier" && expression.name === "undefined" || expression.type === "Literal" && expression.value === null) {
 				context.report({
 					node: langAttr,
-					message: MESSAGE$32
+					message: MESSAGE$33
 				});
 				return;
 			}
@@ -12322,13 +12322,13 @@ const lang = defineRule({
 		if (value === null) return;
 		if (!isValidLangTag(value)) context.report({
 			node: langAttr,
-			message: MESSAGE$32
+			message: MESSAGE$33
 		});
 	} })
 });
 //#endregion
 //#region src/plugin/rules/a11y/media-has-caption.ts
-const MESSAGE$31 = "Deaf & hard-of-hearing users miss this media without captions, so add a `<track kind=\"captions\">` inside the `<audio>` or `<video>`.";
+const MESSAGE$32 = "Deaf & hard-of-hearing users miss this media without captions, so add a `<track kind=\"captions\">` inside the `<audio>` or `<video>`.";
 const DEFAULT_AUDIO = ["audio"];
 const DEFAULT_VIDEO = ["video"];
 const DEFAULT_TRACK = ["track"];
@@ -12369,7 +12369,7 @@ const mediaHasCaption = defineRule({
 			if (!parent || !isNodeOfType(parent, "JSXElement")) {
 				context.report({
 					node: node.name,
-					message: MESSAGE$31
+					message: MESSAGE$32
 				});
 				return;
 			}
@@ -12386,7 +12386,7 @@ const mediaHasCaption = defineRule({
 				return kindValue.value.toLowerCase() === "captions";
 			})) context.report({
 				node: node.name,
-				message: MESSAGE$31
+				message: MESSAGE$32
 			});
 		} };
 	}
@@ -12511,6 +12511,103 @@ const nextjsAsyncClientComponent = defineRule({
 	}
 });
 //#endregion
+//#region src/plugin/constants/nextjs.ts
+const PAGE_FILE_PATTERN = /\/page\.(tsx?|jsx?)$/;
+const PAGE_OR_LAYOUT_FILE_PATTERN = /\/(page|layout)\.(tsx?|jsx?)$/;
+const INTERNAL_PAGE_PATH_PATTERN = /\/(?:(?:\((?:dashboard|admin|settings|account|internal|manage|console|portal|auth|onboarding|app|ee|protected)\))|(?:dashboard|admin|settings|account|internal|manage|console|portal))\//i;
+const OG_ROUTE_PATTERN = /\/og\b/i;
+const PAGES_DIRECTORY_PATTERN = /\/pages\//;
+const NEXTJS_NAVIGATION_FUNCTIONS = new Set([
+	"redirect",
+	"permanentRedirect",
+	"notFound",
+	"forbidden",
+	"unauthorized"
+]);
+const GOOGLE_FONTS_PATTERN = /fonts\.googleapis\.com/;
+const POLYFILL_SCRIPT_PATTERN = /polyfill\.io|polyfill\.min\.js|cdn\.polyfill/;
+const APP_DIRECTORY_PATTERN = /\/app\//;
+const ROUTE_HANDLER_FILE_PATTERN = /\/route\.(tsx?|jsx?)$/;
+const CRON_ROUTE_PATTERN = /\/(?:cron|jobs\/cron)(?:\/|$)/i;
+const MUTATING_ROUTE_SEGMENTS = new Set([
+	"logout",
+	"log-out",
+	"signout",
+	"sign-out",
+	"unsubscribe",
+	"delete",
+	"remove",
+	"revoke",
+	"cancel",
+	"deactivate"
+]);
+const ERROR_BOUNDARY_FILE_PATTERN = /\/(error|global-error)\.(tsx?|jsx?)$/;
+const GLOBAL_ERROR_FILE_PATTERN = /\/global-error\.(tsx?|jsx?)$/;
+const ROUTE_HANDLER_HTTP_METHODS = new Set([
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"OPTIONS",
+	"HEAD"
+]);
+const GOOGLE_ANALYTICS_SCRIPT_PATTERN = /google-analytics\.com|googletagmanager\.com\/gtag/;
+const OG_IMAGE_FILE_PATTERN = /\/(opengraph-image|twitter-image)\d*\.(tsx?|jsx?)$/;
+//#endregion
+//#region src/plugin/rules/nextjs/nextjs-error-boundary-missing-use-client.ts
+const nextjsErrorBoundaryMissingUseClient = defineRule({
+	id: "nextjs-error-boundary-missing-use-client",
+	title: "Error boundary missing 'use client'",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "error",
+	recommendation: "Add `'use client'` at the top of this file. Error boundaries must be Client Components to catch and render fallback UI",
+	create: (context) => ({ Program(programNode) {
+		const filename = normalizeFilename$1(context.filename ?? "");
+		if (!APP_DIRECTORY_PATTERN.test(filename)) return;
+		if (!ERROR_BOUNDARY_FILE_PATTERN.test(filename)) return;
+		if (hasDirective(programNode, "use client")) return;
+		context.report({
+			node: programNode,
+			message: "This error boundary silently does nothing without 'use client'. Next.js requires error.tsx to be a Client Component."
+		});
+	} })
+});
+//#endregion
+//#region src/plugin/utils/file-contains-jsx-elements.ts
+const fileContainsJsxElements = (programNode, tagNames) => {
+	const targetTagNames = new Set(tagNames);
+	const foundTagNames = /* @__PURE__ */ new Set();
+	walkAst(programNode, (child) => {
+		if (foundTagNames.size === targetTagNames.size) return false;
+		if (isNodeOfType(child, "JSXOpeningElement") && isNodeOfType(child.name, "JSXIdentifier") && targetTagNames.has(child.name.name)) foundTagNames.add(child.name.name);
+	});
+	return foundTagNames;
+};
+//#endregion
+//#region src/plugin/rules/nextjs/nextjs-global-error-missing-html-body.ts
+const REQUIRED_HTML_TAGS = ["html", "body"];
+const nextjsGlobalErrorMissingHtmlBody = defineRule({
+	id: "nextjs-global-error-missing-html-body",
+	title: "global-error.tsx missing <html>/<body>",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "error",
+	recommendation: "Wrap your error UI in `<html><body>...</body></html>`. The root layout is unmounted when global-error renders",
+	create: (context) => ({ Program(programNode) {
+		const filename = normalizeFilename$1(context.filename ?? "");
+		if (!APP_DIRECTORY_PATTERN.test(filename)) return;
+		if (!GLOBAL_ERROR_FILE_PATTERN.test(filename)) return;
+		const foundTags = fileContainsJsxElements(programNode, REQUIRED_HTML_TAGS);
+		const missingTags = REQUIRED_HTML_TAGS.filter((tagName) => !foundTags.has(tagName)).map((tagName) => `<${tagName}>`);
+		if (missingTags.length > 0) context.report({
+			node: programNode,
+			message: `global-error.tsx is missing ${missingTags.join(" and ")}. The root layout unmounts on error, so this page renders broken HTML.`
+		});
+	} })
+});
+//#endregion
 //#region src/plugin/utils/has-jsx-attribute.ts
 const hasJsxAttribute = (attributes, attributeName) => Boolean(findJsxAttribute(attributes, attributeName));
 //#endregion
@@ -12554,37 +12651,6 @@ const nextjsInlineScriptMissingId = defineRule({
 	} })
 });
 //#endregion
-//#region src/plugin/constants/nextjs.ts
-const PAGE_FILE_PATTERN = /\/page\.(tsx?|jsx?)$/;
-const PAGE_OR_LAYOUT_FILE_PATTERN = /\/(page|layout)\.(tsx?|jsx?)$/;
-const INTERNAL_PAGE_PATH_PATTERN = /\/(?:(?:\((?:dashboard|admin|settings|account|internal|manage|console|portal|auth|onboarding|app|ee|protected)\))|(?:dashboard|admin|settings|account|internal|manage|console|portal))\//i;
-const OG_ROUTE_PATTERN = /\/og\b/i;
-const PAGES_DIRECTORY_PATTERN = /\/pages\//;
-const NEXTJS_NAVIGATION_FUNCTIONS = new Set([
-	"redirect",
-	"permanentRedirect",
-	"notFound",
-	"forbidden",
-	"unauthorized"
-]);
-const GOOGLE_FONTS_PATTERN = /fonts\.googleapis\.com/;
-const POLYFILL_SCRIPT_PATTERN = /polyfill\.io|polyfill\.min\.js|cdn\.polyfill/;
-const APP_DIRECTORY_PATTERN = /\/app\//;
-const ROUTE_HANDLER_FILE_PATTERN = /\/route\.(tsx?|jsx?)$/;
-const CRON_ROUTE_PATTERN = /\/(?:cron|jobs\/cron)(?:\/|$)/i;
-const MUTATING_ROUTE_SEGMENTS = new Set([
-	"logout",
-	"log-out",
-	"signout",
-	"sign-out",
-	"unsubscribe",
-	"delete",
-	"remove",
-	"revoke",
-	"cancel",
-	"deactivate"
-]);
-//#endregion
 //#region src/plugin/rules/nextjs/nextjs-missing-metadata.ts
 const nextjsMissingMetadata = defineRule({
 	id: "nextjs-missing-metadata",
@@ -12734,6 +12800,89 @@ const nextjsNoCssLink = defineRule({
 	} })
 });
 //#endregion
+//#region src/plugin/rules/nextjs/nextjs-no-default-export-in-route-handler.ts
+const programHasNamedHttpMethodExport = (programNode) => {
+	for (const statement of programNode.body ?? []) {
+		if (!isNodeOfType(statement, "ExportNamedDeclaration")) continue;
+		const declaration = statement.declaration;
+		if (isNodeOfType(declaration, "FunctionDeclaration") && declaration.id?.name && ROUTE_HANDLER_HTTP_METHODS.has(declaration.id.name)) return true;
+		if (isNodeOfType(declaration, "VariableDeclaration")) {
+			for (const declarator of declaration.declarations ?? []) if (isNodeOfType(declarator.id, "Identifier") && ROUTE_HANDLER_HTTP_METHODS.has(declarator.id.name)) return true;
+		}
+		for (const specifier of statement.specifiers ?? []) if (isNodeOfType(specifier, "ExportSpecifier") && isNodeOfType(specifier.exported, "Identifier") && ROUTE_HANDLER_HTTP_METHODS.has(specifier.exported.name)) return true;
+	}
+	return false;
+};
+const nextjsNoDefaultExportInRouteHandler = defineRule({
+	id: "nextjs-no-default-export-in-route-handler",
+	title: "Default export in route handler",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "error",
+	recommendation: "Replace `export default` with named HTTP method exports: `export async function GET(request) { … }`",
+	create: (context) => {
+		let isAppRouteHandler = false;
+		let programNode = null;
+		return {
+			Program(node) {
+				const filename = normalizeFilename$1(context.filename ?? "");
+				isAppRouteHandler = APP_DIRECTORY_PATTERN.test(filename) && ROUTE_HANDLER_FILE_PATTERN.test(filename);
+				programNode = node;
+			},
+			ExportDefaultDeclaration(node) {
+				if (!isAppRouteHandler || !programNode) return;
+				if (programHasNamedHttpMethodExport(programNode)) return;
+				context.report({
+					node,
+					message: "Default exports in route.ts are silently ignored. Next.js only recognizes named HTTP method exports (GET, POST, etc.)."
+				});
+			},
+			ExportNamedDeclaration(node) {
+				if (!isAppRouteHandler || !programNode) return;
+				if (!(node.specifiers ?? []).some((specifier) => isNodeOfType(specifier, "ExportSpecifier") && isNodeOfType(specifier.exported, "Identifier") && specifier.exported.name === "default")) return;
+				if (programHasNamedHttpMethodExport(programNode)) return;
+				context.report({
+					node,
+					message: "Default exports in route.ts are silently ignored. Next.js only recognizes named HTTP method exports (GET, POST, etc.)."
+				});
+			}
+		};
+	}
+});
+//#endregion
+//#region src/plugin/rules/nextjs/nextjs-no-edge-og-runtime.ts
+const nextjsNoEdgeOgRuntime = defineRule({
+	id: "nextjs-no-edge-og-runtime",
+	title: "Edge runtime in OG image route",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "warn",
+	recommendation: "Remove `export const runtime = 'edge'` from OG image files. The default Node.js runtime supports more fonts and APIs",
+	create: (context) => {
+		let isOgImageFile = false;
+		return {
+			Program() {
+				const filename = normalizeFilename$1(context.filename ?? "");
+				isOgImageFile = OG_IMAGE_FILE_PATTERN.test(filename);
+			},
+			ExportNamedDeclaration(node) {
+				if (!isOgImageFile) return;
+				const declaration = node.declaration;
+				if (!isNodeOfType(declaration, "VariableDeclaration")) return;
+				for (const declarator of declaration.declarations ?? []) {
+					if (!isNodeOfType(declarator, "VariableDeclarator")) continue;
+					if (!isNodeOfType(declarator.id, "Identifier")) continue;
+					if (declarator.id.name !== "runtime") continue;
+					if ((isNodeOfType(declarator.init, "Literal") ? declarator.init.value : null) === "edge") context.report({
+						node,
+						message: "Edge runtime limits OG image generation. Node.js runtime supports more fonts, filesystem access, and larger response sizes."
+					});
+				}
+			}
+		};
+	}
+});
+//#endregion
 //#region src/plugin/rules/nextjs/nextjs-no-font-link.ts
 const nextjsNoFontLink = defineRule({
 	id: "nextjs-no-font-link",
@@ -12754,6 +12903,27 @@ const nextjsNoFontLink = defineRule({
 	} })
 });
 //#endregion
+//#region src/plugin/rules/nextjs/nextjs-no-google-analytics-script.ts
+const nextjsNoGoogleAnalyticsScript = defineRule({
+	id: "nextjs-no-google-analytics-script",
+	title: "Manual Google Analytics script",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "warn",
+	recommendation: "Use `import { GoogleAnalytics } from '@next/third-parties/google'` for automatic optimization & smaller bundles",
+	create: (context) => ({ JSXOpeningElement(node) {
+		if (!isNodeOfType(node.name, "JSXIdentifier")) return;
+		if (node.name.name !== "script" && node.name.name !== "Script") return;
+		const srcAttribute = findJsxAttribute(node.attributes ?? [], "src");
+		if (!srcAttribute?.value) return;
+		const srcValue = isNodeOfType(srcAttribute.value, "Literal") ? srcAttribute.value.value : null;
+		if (typeof srcValue === "string" && GOOGLE_ANALYTICS_SCRIPT_PATTERN.test(srcValue)) context.report({
+			node,
+			message: "Manual Google Analytics script blocks rendering. Use @next/third-parties for optimal loading strategy."
+		});
+	} })
+});
+//#endregion
 //#region src/plugin/rules/nextjs/nextjs-no-head-import.ts
 const nextjsNoHeadImport = defineRule({
 	id: "nextjs-no-head-import",
@@ -12784,8 +12954,9 @@ const nextjsNoImgElement = defineRule({
 	create: (context) => {
 		const filename = normalizeFilename$1(context.filename ?? "");
 		const isOgRoute = OG_ROUTE_PATTERN.test(filename);
+		const isMetadataImageRoute = isNextjsMetadataImageRouteFilename(filename);
 		return { JSXOpeningElement(node) {
-			if (isOgRoute) return;
+			if (isOgRoute || isMetadataImageRoute) return;
 			if (isNodeOfType(node.name, "JSXIdentifier") && node.name.name === "img") context.report({
 				node,
 				message: "Plain <img> ships unoptimized, oversized images to your users."
@@ -12865,6 +13036,32 @@ const nextjsNoRedirectInTryCatch = defineRule({
 	}
 });
 //#endregion
+//#region src/plugin/rules/nextjs/nextjs-no-script-in-head.ts
+const nextjsNoScriptInHead = defineRule({
+	id: "nextjs-no-script-in-head",
+	title: "next/script inside next/head",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "error",
+	recommendation: "Move `<Script>` outside of `<Head>`. next/script manages its own placement and ignores head context",
+	create: (context) => {
+		let insideHeadDepth = 0;
+		return {
+			JSXOpeningElement(node) {
+				if (!isNodeOfType(node.name, "JSXIdentifier")) return;
+				if (node.name.name === "Head" && !node.selfClosing) insideHeadDepth++;
+				if (node.name.name === "Script" && insideHeadDepth > 0) context.report({
+					node,
+					message: "next/script inside next/head is silently ignored. Move <Script> outside <Head> so it actually loads."
+				});
+			},
+			JSXClosingElement(node) {
+				if (isNodeOfType(node.name, "JSXIdentifier") && node.name.name === "Head") insideHeadDepth = Math.max(0, insideHeadDepth - 1);
+			}
+		};
+	}
+});
+//#endregion
 //#region src/plugin/utils/is-cookies-call.ts
 const isCookiesCall = (node) => isNodeOfType(node, "CallExpression") && isNodeOfType(node.callee, "Identifier") && node.callee.name === "cookies";
 //#endregion
@@ -13170,23 +13367,796 @@ const nextjsNoSideEffectInGetHandler = defineRule({
 	}
 });
 //#endregion
-//#region src/plugin/rules/nextjs/nextjs-no-use-search-params-without-suspense.ts
-const fileMentionsSuspense = (programNode) => {
-	let didSee = false;
+//#region src/plugin/utils/find-exported-function-body.ts
+const isFunctionLike = (node) => {
+	if (!node) return false;
+	return isNodeOfType(node, "FunctionDeclaration") || isNodeOfType(node, "FunctionExpression") || isNodeOfType(node, "ArrowFunctionExpression");
+};
+const findExportedFunctionBody = (programRoot, exportedName) => {
+	if (!isNodeOfType(programRoot, "Program")) return null;
+	const localBindings = /* @__PURE__ */ new Map();
+	const namedExports = /* @__PURE__ */ new Map();
+	let defaultExport = null;
+	let defaultExportIdentifierName = null;
+	const recordVariableDeclaration = (declaration) => {
+		for (const declarator of declaration.declarations ?? []) {
+			if (!isNodeOfType(declarator, "VariableDeclarator")) continue;
+			if (!isNodeOfType(declarator.id, "Identifier")) continue;
+			const initializer = declarator.init ? stripParenExpression(declarator.init) : null;
+			if (initializer && isFunctionLike(initializer)) localBindings.set(declarator.id.name, initializer);
+		}
+	};
+	for (const statement of programRoot.body ?? []) {
+		if (isNodeOfType(statement, "VariableDeclaration")) {
+			recordVariableDeclaration(statement);
+			continue;
+		}
+		if (isNodeOfType(statement, "FunctionDeclaration") && statement.id) {
+			localBindings.set(statement.id.name, statement);
+			continue;
+		}
+		if (isNodeOfType(statement, "ExportNamedDeclaration")) {
+			const declaration = statement.declaration;
+			if (declaration && isNodeOfType(declaration, "VariableDeclaration")) {
+				recordVariableDeclaration(declaration);
+				for (const declarator of declaration.declarations ?? []) {
+					if (!isNodeOfType(declarator, "VariableDeclarator")) continue;
+					if (!isNodeOfType(declarator.id, "Identifier")) continue;
+					namedExports.set(declarator.id.name, declarator.id.name);
+				}
+			} else if (declaration && isNodeOfType(declaration, "FunctionDeclaration") && declaration.id) {
+				localBindings.set(declaration.id.name, declaration);
+				namedExports.set(declaration.id.name, declaration.id.name);
+			}
+			for (const specifier of statement.specifiers ?? []) {
+				if (!isNodeOfType(specifier, "ExportSpecifier")) continue;
+				const local = specifier.local;
+				const exported = specifier.exported;
+				if (!isNodeOfType(local, "Identifier")) continue;
+				const exportedNameSpec = isNodeOfType(exported, "Identifier") ? exported.name : isNodeOfType(exported, "Literal") && typeof exported.value === "string" ? exported.value : null;
+				if (!exportedNameSpec) continue;
+				namedExports.set(exportedNameSpec, local.name);
+			}
+			continue;
+		}
+		if (isNodeOfType(statement, "ExportDefaultDeclaration")) {
+			const declaration = statement.declaration;
+			if (!declaration) continue;
+			if (isNodeOfType(declaration, "FunctionDeclaration") && declaration.id) {
+				localBindings.set(declaration.id.name, declaration);
+				defaultExport = declaration;
+				continue;
+			}
+			if (isFunctionLike(declaration)) {
+				defaultExport = declaration;
+				continue;
+			}
+			if (isNodeOfType(declaration, "Identifier")) {
+				defaultExportIdentifierName = declaration.name;
+				continue;
+			}
+		}
+	}
+	if (exportedName === "default") {
+		if (defaultExport) return defaultExport;
+		if (defaultExportIdentifierName) {
+			const binding = localBindings.get(defaultExportIdentifierName);
+			if (binding) return binding;
+		}
+	}
+	const localName = namedExports.get(exportedName);
+	if (!localName) return null;
+	return localBindings.get(localName) ?? null;
+};
+const resolveImportedExportName = (importSpecifier) => {
+	if (isNodeOfType(importSpecifier, "ImportSpecifier")) {
+		const imported = importSpecifier.imported;
+		if (isNodeOfType(imported, "Identifier")) return imported.name;
+		if (isNodeOfType(imported, "Literal") && typeof imported.value === "string") return imported.value;
+		return null;
+	}
+	if (isNodeOfType(importSpecifier, "ImportDefaultSpecifier")) return "default";
+	return null;
+};
+const findReExportSourcesForName = (programRoot, exportedName) => {
+	if (!isNodeOfType(programRoot, "Program")) return [];
+	const exportAllSources = [];
+	for (const statement of programRoot.body ?? []) {
+		if (isNodeOfType(statement, "ExportNamedDeclaration") && statement.source) {
+			const sourceValue = statement.source.value;
+			if (typeof sourceValue !== "string") continue;
+			for (const specifier of statement.specifiers ?? []) {
+				if (!isNodeOfType(specifier, "ExportSpecifier")) continue;
+				const exported = specifier.exported;
+				if ((isNodeOfType(exported, "Identifier") ? exported.name : isNodeOfType(exported, "Literal") && typeof exported.value === "string" ? exported.value : null) === exportedName) return [sourceValue];
+			}
+		}
+		if (isNodeOfType(statement, "ExportAllDeclaration") && statement.source) {
+			const sourceValue = statement.source.value;
+			if (typeof sourceValue === "string") exportAllSources.push(sourceValue);
+		}
+	}
+	return exportAllSources;
+};
+//#endregion
+//#region src/plugin/utils/attach-parent-references.ts
+const attachParentReferences = (root) => {
+	const visit = (node, parent) => {
+		const writableNode = node;
+		writableNode.parent = parent;
+		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 (isAstNode(item)) visit(item, node);
+			} else if (isAstNode(child)) visit(child, node);
+		}
+	};
+	visit(root, null);
+};
+//#endregion
+//#region src/plugin/utils/parse-source-file.ts
+const FILENAME_TO_LANG = {
+	".ts": "ts",
+	".tsx": "tsx",
+	".js": "js",
+	".jsx": "jsx",
+	".mjs": "js",
+	".cjs": "js",
+	".mts": "ts",
+	".cts": "ts"
+};
+const resolveLang = (filename) => {
+	return FILENAME_TO_LANG[path.extname(filename).toLowerCase()] ?? "tsx";
+};
+const parseCache = /* @__PURE__ */ new Map();
+const parseSourceFile = (absoluteFilePath) => {
+	let fileStat;
+	try {
+		fileStat = fs.statSync(absoluteFilePath);
+	} catch {
+		return null;
+	}
+	if (!fileStat.isFile()) return null;
+	if (fileStat.size > 2e6) return null;
+	const cached = parseCache.get(absoluteFilePath);
+	if (cached && cached.mtimeMs === fileStat.mtimeMs && cached.size === fileStat.size) return cached.program;
+	if (absoluteFilePath.endsWith(".d.ts") || absoluteFilePath.endsWith(".d.mts") || absoluteFilePath.endsWith(".d.cts")) {
+		parseCache.set(absoluteFilePath, {
+			mtimeMs: fileStat.mtimeMs,
+			size: fileStat.size,
+			program: null
+		});
+		return null;
+	}
+	let sourceText;
+	try {
+		sourceText = fs.readFileSync(absoluteFilePath, "utf8");
+	} catch {
+		parseCache.set(absoluteFilePath, {
+			mtimeMs: fileStat.mtimeMs,
+			size: fileStat.size,
+			program: null
+		});
+		return null;
+	}
+	let parsedProgram = null;
+	try {
+		const result = parseSync(absoluteFilePath, sourceText, {
+			astType: "ts",
+			lang: resolveLang(absoluteFilePath)
+		});
+		if (!result.errors.some((parseError) => parseError.severity === "Error")) {
+			parsedProgram = result.program;
+			attachParentReferences(parsedProgram);
+		}
+	} catch {
+		parsedProgram = null;
+	}
+	parseCache.set(absoluteFilePath, {
+		mtimeMs: fileStat.mtimeMs,
+		size: fileStat.size,
+		program: parsedProgram
+	});
+	return parsedProgram;
+};
+//#endregion
+//#region src/plugin/utils/parse-export-specifiers.ts
+const getSpecifierName = (rawName) => rawName.replace(/^type\s+/, "").trim();
+const parseExportSpecifiers = (specifiersText, declarationIsTypeOnly) => specifiersText.split(",").map((specifierText) => specifierText.trim()).filter(Boolean).map((specifierText) => {
+	const isTypeOnly = declarationIsTypeOnly || specifierText.startsWith("type ");
+	const [rawLocalName, rawExportedName] = specifierText.split(/\s+as\s+/);
+	const localName = getSpecifierName(rawLocalName ?? "");
+	return {
+		localName,
+		exportedName: getSpecifierName(rawExportedName ?? localName),
+		isTypeOnly
+	};
+});
+//#endregion
+//#region src/plugin/utils/strip-js-comments.ts
+const BLOCK_COMMENT_PATTERN = /\/\*[\s\S]*?\*\//g;
+const LINE_COMMENT_PATTERN = /^\s*\/\/.*$/gm;
+const stripJsComments = (sourceText) => sourceText.replace(BLOCK_COMMENT_PATTERN, "").replace(LINE_COMMENT_PATTERN, "");
+//#endregion
+//#region src/plugin/utils/does-module-export-name.ts
+const DEFAULT_EXPORT_DECLARATION_PATTERN = /^\s*export\s+default\b/m;
+const NAMED_EXPORT_DECLARATION_PATTERN = /^\s*export\s+(?:declare\s+)?(?:(?:async\s+)?function|(?:abstract\s+)?class|const|let|var|enum|interface|type)\s+([\w$]+)/gm;
+const LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN$1 = /^\s*export\s+(?:type\s+)?\{([\s\S]*?)\}(?:\s+from\s+["'][^"']+["'])?\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
+const doesSourceTextExportName = (sourceText, exportedName) => {
+	const strippedSource = stripJsComments(sourceText);
+	if (exportedName === "default" && DEFAULT_EXPORT_DECLARATION_PATTERN.test(strippedSource)) return true;
+	for (const match of strippedSource.matchAll(NAMED_EXPORT_DECLARATION_PATTERN)) if (match[1] === exportedName) return true;
+	for (const match of strippedSource.matchAll(LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN$1)) if (parseExportSpecifiers(match[1] ?? "", false).map((specifier) => specifier.exportedName).includes(exportedName)) return true;
+	return false;
+};
+const doesModuleExportName = (filePath, exportedName) => {
+	try {
+		return doesSourceTextExportName(fs.readFileSync(filePath, "utf8"), exportedName);
+	} catch {
+		return false;
+	}
+};
+//#endregion
+//#region src/plugin/utils/is-barrel-index-module.ts
+const INDEX_MODULE_FILE_PATTERN = /^index\.(?:[cm]?[jt]sx?|mjs)$/;
+const BINDING_IMPORT_DECLARATION_PATTERN = /^\s*import\s+(type\s+)?(?!["'])([^;]*?)\s+from\s+["']([^"']+)["']\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
+const BARREL_REEXPORT_DECLARATION_PATTERN = /^\s*export\s+(type\s+)?(?:\*(?:\s+as\s+([\w$]+))?|\{([\s\S]*?)\})\s+from\s+["']([^"']+)["']\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
+const LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN = /^\s*export\s+(type\s+)?\{([\s\S]*?)\}\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
+const barrelIndexModuleInfoCache = /* @__PURE__ */ new Map();
+const isIndexModuleFilePath = (filePath) => INDEX_MODULE_FILE_PATTERN.test(path.basename(filePath));
+const createNonBarrelInfo = () => ({
+	isBarrel: false,
+	exportsByName: /* @__PURE__ */ new Map(),
+	starExportSources: []
+});
+const addImportedBinding = (importedBindings, binding) => {
+	importedBindings.set(binding.localName, {
+		...binding,
+		didExport: false
+	});
+};
+const collectNamedImportBindings = (namedSpecifiersText, source, declarationIsTypeOnly, importedBindings) => {
+	for (const specifier of parseExportSpecifiers(namedSpecifiersText, declarationIsTypeOnly)) addImportedBinding(importedBindings, {
+		localName: specifier.exportedName,
+		importedName: specifier.localName,
+		source,
+		isTypeOnly: specifier.isTypeOnly
+	});
+};
+const collectImportBindings = (importClause, source, declarationIsTypeOnly, importedBindings) => {
+	const trimmedImportClause = importClause.trim();
+	const namespaceMatch = trimmedImportClause.match(/(?:^|,\s*)\*\s+as\s+([\w$]+)/);
+	if (namespaceMatch?.[1]) addImportedBinding(importedBindings, {
+		localName: namespaceMatch[1],
+		importedName: "*",
+		source,
+		isTypeOnly: declarationIsTypeOnly
+	});
+	const namedImportMatch = trimmedImportClause.match(/\{([\s\S]*?)\}/);
+	if (namedImportMatch?.[1]) collectNamedImportBindings(namedImportMatch[1], source, declarationIsTypeOnly, importedBindings);
+	const defaultImportName = trimmedImportClause.split(",")[0]?.trim();
+	if (defaultImportName && !defaultImportName.startsWith("{") && !defaultImportName.startsWith("*")) addImportedBinding(importedBindings, {
+		localName: defaultImportName,
+		importedName: "default",
+		source,
+		isTypeOnly: declarationIsTypeOnly
+	});
+};
+const replaceKnownDeclarations = (sourceText, importedBindings, exportsByName, starExportSources) => {
+	let withoutKnownDeclarations = sourceText.replace(BINDING_IMPORT_DECLARATION_PATTERN, (_match, typeKeyword, importClause, source) => {
+		collectImportBindings(importClause, source, Boolean(typeKeyword), importedBindings);
+		return "";
+	});
+	withoutKnownDeclarations = withoutKnownDeclarations.replace(BARREL_REEXPORT_DECLARATION_PATTERN, (_match, typeKeyword, namespaceExportName, specifiersText, source) => {
+		const isTypeOnly = Boolean(typeKeyword);
+		if (namespaceExportName) {
+			exportsByName.set(namespaceExportName, {
+				exportedName: namespaceExportName,
+				importedName: "*",
+				source,
+				isTypeOnly
+			});
+			return "";
+		}
+		if (specifiersText) {
+			for (const specifier of parseExportSpecifiers(specifiersText, isTypeOnly)) exportsByName.set(specifier.exportedName, {
+				exportedName: specifier.exportedName,
+				importedName: specifier.localName,
+				source,
+				isTypeOnly: specifier.isTypeOnly
+			});
+			return "";
+		}
+		starExportSources.push(source);
+		return "";
+	});
+	withoutKnownDeclarations = withoutKnownDeclarations.replace(LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN, (_match, typeKeyword, specifiersText) => {
+		for (const specifier of parseExportSpecifiers(specifiersText, Boolean(typeKeyword))) {
+			const importedBinding = importedBindings.get(specifier.localName);
+			if (!importedBinding) return _match;
+			importedBinding.didExport = true;
+			exportsByName.set(specifier.exportedName, {
+				exportedName: specifier.exportedName,
+				importedName: importedBinding.importedName,
+				source: importedBinding.source,
+				isTypeOnly: specifier.isTypeOnly || importedBinding.isTypeOnly
+			});
+		}
+		return "";
+	});
+	return withoutKnownDeclarations;
+};
+const hasUnexportedRuntimeImport = (importedBindings) => {
+	for (const binding of importedBindings.values()) if (!binding.isTypeOnly && !binding.didExport) return true;
+	return false;
+};
+const classifyBarrelModule = (sourceText) => {
+	const strippedSource = stripJsComments(sourceText).trim();
+	if (!strippedSource) return createNonBarrelInfo();
+	const importedBindings = /* @__PURE__ */ new Map();
+	const exportsByName = /* @__PURE__ */ new Map();
+	const starExportSources = [];
+	if (replaceKnownDeclarations(strippedSource, importedBindings, exportsByName, starExportSources).trim() || hasUnexportedRuntimeImport(importedBindings)) return createNonBarrelInfo();
+	return {
+		isBarrel: exportsByName.size > 0 || starExportSources.length > 0,
+		exportsByName,
+		starExportSources
+	};
+};
+const getBarrelIndexModuleInfo = (filePath) => {
+	if (!isIndexModuleFilePath(filePath)) return createNonBarrelInfo();
+	const cachedResult = barrelIndexModuleInfoCache.get(filePath);
+	if (cachedResult !== void 0) return cachedResult;
+	let moduleInfo = createNonBarrelInfo();
+	try {
+		moduleInfo = classifyBarrelModule(fs.readFileSync(filePath, "utf8"));
+	} catch {
+		moduleInfo = createNonBarrelInfo();
+	}
+	barrelIndexModuleInfoCache.set(filePath, moduleInfo);
+	return moduleInfo;
+};
+const isBarrelIndexModule = (filePath) => getBarrelIndexModuleInfo(filePath).isBarrel;
+//#endregion
+//#region src/plugin/utils/resolve-relative-import-path.ts
+const MODULE_FILE_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".mjs",
+	".cjs",
+	".mts",
+	".cts"
+];
+const PACKAGE_EXPORT_CONDITIONS = [
+	"import",
+	"default",
+	"module",
+	"browser",
+	"require"
+];
+const PACKAGE_ENTRY_FIELDS = [
+	"module",
+	"main",
+	"browser"
+];
+const getExistingFilePath = (filePath) => {
+	try {
+		return fs.statSync(filePath).isFile() ? filePath : null;
+	} catch {
+		return null;
+	}
+};
+const getExistingDirectoryPath = (directoryPath) => {
+	try {
+		return fs.statSync(directoryPath).isDirectory() ? directoryPath : null;
+	} catch {
+		return null;
+	}
+};
+const getModuleFilePathCandidates = (modulePath) => {
+	const extension = path.extname(modulePath);
+	if (!extension) return MODULE_FILE_EXTENSIONS.map((moduleExtension) => `${modulePath}${moduleExtension}`);
+	const modulePathWithoutExtension = modulePath.slice(0, -extension.length);
+	if (extension === ".js") return [
+		modulePath,
+		`${modulePathWithoutExtension}.ts`,
+		`${modulePathWithoutExtension}.tsx`,
+		`${modulePathWithoutExtension}.jsx`
+	];
+	if (extension === ".jsx") return [modulePath, `${modulePathWithoutExtension}.tsx`];
+	if (extension === ".mjs") return [modulePath, `${modulePathWithoutExtension}.mts`];
+	if (extension === ".cjs") return [modulePath, `${modulePathWithoutExtension}.cts`];
+	return [modulePath];
+};
+const isObjectRecord$1 = (value) => typeof value === "object" && value !== null;
+const getConditionalExportEntry = (exportEntry) => {
+	if (typeof exportEntry === "string") return exportEntry;
+	if (Array.isArray(exportEntry)) {
+		for (const fallbackEntry of exportEntry) {
+			const resolvedFallbackEntry = getConditionalExportEntry(fallbackEntry);
+			if (resolvedFallbackEntry) return resolvedFallbackEntry;
+		}
+		return null;
+	}
+	if (!isObjectRecord$1(exportEntry)) return null;
+	for (const condition of PACKAGE_EXPORT_CONDITIONS) {
+		const nestedEntry = getConditionalExportEntry(exportEntry[condition]);
+		if (nestedEntry) return nestedEntry;
+	}
+	return null;
+};
+const getPackageExportEntry = (packageJson) => {
+	const exportsField = packageJson.exports;
+	if (!exportsField) return null;
+	const directExportEntry = getConditionalExportEntry(exportsField);
+	if (directExportEntry) return directExportEntry;
+	if (!isObjectRecord$1(exportsField)) return null;
+	return getConditionalExportEntry(exportsField["."]);
+};
+const resolveModulePathWithIndexFallback = (modulePath) => {
+	const filePath = resolveModuleFilePath(modulePath);
+	if (filePath) return filePath;
+	return resolveModuleFilePath(path.join(modulePath, "index"));
+};
+const resolvePackageDirectoryEntry = (directoryPath) => {
+	const existingDirectoryPath = getExistingDirectoryPath(directoryPath);
+	if (!existingDirectoryPath) return null;
+	const packageJsonPath = path.join(existingDirectoryPath, "package.json");
+	try {
+		const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+		const packageEntry = getPackageExportEntry(packageJson) ?? PACKAGE_ENTRY_FIELDS.map((fieldName) => packageJson[fieldName]).find((value) => typeof value === "string");
+		if (!packageEntry) return null;
+		return resolveModulePathWithIndexFallback(path.resolve(existingDirectoryPath, packageEntry));
+	} catch {
+		return null;
+	}
+};
+const resolveModuleFilePath = (modulePath) => {
+	const exactFilePath = getExistingFilePath(modulePath);
+	if (exactFilePath) return exactFilePath;
+	for (const candidateFilePath of getModuleFilePathCandidates(modulePath)) {
+		const filePath = getExistingFilePath(candidateFilePath);
+		if (filePath) return filePath;
+	}
+	return null;
+};
+const resolveModuleFileFromAbsolutePath = (importPath) => {
+	const directFilePath = resolveModuleFilePath(importPath);
+	if (directFilePath) return directFilePath;
+	const packageEntryFilePath = resolvePackageDirectoryEntry(importPath);
+	if (packageEntryFilePath) return packageEntryFilePath;
+	return resolveModuleFilePath(path.join(importPath, "index"));
+};
+const resolveRelativeImportPath = (filename, source) => resolveModuleFileFromAbsolutePath(path.resolve(path.dirname(filename), source));
+//#endregion
+//#region src/plugin/utils/resolve-barrel-export-file-path.ts
+const getUniqueFilePath = (filePaths) => {
+	const uniqueFilePaths = new Set(filePaths);
+	if (uniqueFilePaths.size !== 1) return null;
+	const [filePath] = uniqueFilePaths;
+	return filePath ?? null;
+};
+const resolveStarExportFilePath = (barrelFilePath, exportedName, source, visitedFilePaths) => {
+	const resolvedTargetPath = resolveRelativeImportPath(barrelFilePath, source);
+	if (!resolvedTargetPath) return null;
+	const nestedTargetPath = resolveBarrelExportFilePath(resolvedTargetPath, exportedName, new Set(visitedFilePaths));
+	if (nestedTargetPath) return nestedTargetPath;
+	return doesModuleExportName(resolvedTargetPath, exportedName) ? resolvedTargetPath : null;
+};
+const resolveBarrelExportFilePath = (barrelFilePath, exportedName, visitedFilePaths = /* @__PURE__ */ new Set()) => {
+	if (visitedFilePaths.has(barrelFilePath)) return null;
+	visitedFilePaths.add(barrelFilePath);
+	const moduleInfo = getBarrelIndexModuleInfo(barrelFilePath);
+	if (!moduleInfo.isBarrel) return null;
+	const target = moduleInfo.exportsByName.get(exportedName);
+	if (target) {
+		const resolvedTargetPath = resolveRelativeImportPath(barrelFilePath, target.source);
+		if (!resolvedTargetPath) return null;
+		return resolveBarrelExportFilePath(resolvedTargetPath, target.importedName, visitedFilePaths) ?? resolvedTargetPath;
+	}
+	if (exportedName === "default") return null;
+	return getUniqueFilePath(moduleInfo.starExportSources.map((source) => resolveStarExportFilePath(barrelFilePath, exportedName, source, visitedFilePaths)).filter((filePath) => Boolean(filePath)));
+};
+//#endregion
+//#region src/plugin/utils/resolve-tsconfig-alias.ts
+const TSCONFIG_FILE_NAMES = ["tsconfig.json", "jsconfig.json"];
+const isObjectRecord = (value) => typeof value === "object" && value !== null;
+const stripJsonComments = (text) => {
+	let output = "";
+	let inString = false;
+	let inLineComment = false;
+	let inBlockComment = false;
+	for (let index = 0; index < text.length; index++) {
+		const character = text[index];
+		const nextCharacter = text[index + 1];
+		if (inLineComment) {
+			if (character === "\n") {
+				inLineComment = false;
+				output += character;
+			}
+			continue;
+		}
+		if (inBlockComment) {
+			if (character === "*" && nextCharacter === "/") {
+				inBlockComment = false;
+				index++;
+			}
+			continue;
+		}
+		if (inString) {
+			output += character;
+			if (character === "\\") {
+				output += nextCharacter ?? "";
+				index++;
+			} else if (character === "\"") inString = false;
+			continue;
+		}
+		if (character === "\"") {
+			inString = true;
+			output += character;
+			continue;
+		}
+		if (character === "/" && nextCharacter === "/") {
+			inLineComment = true;
+			index++;
+			continue;
+		}
+		if (character === "/" && nextCharacter === "*") {
+			inBlockComment = true;
+			index++;
+			continue;
+		}
+		output += character;
+	}
+	return output.replace(/,(\s*[}\]])/g, "$1");
+};
+const parseTsconfigFile = (configFilePath) => {
+	let sourceText;
+	try {
+		sourceText = fs.readFileSync(configFilePath, "utf8");
+	} catch {
+		return null;
+	}
+	try {
+		const parsed = JSON.parse(stripJsonComments(sourceText));
+		return isObjectRecord(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
+};
+const resolveExtendsPath = (extendsValue, fromConfigDirectory) => {
+	const withExtension = extendsValue.endsWith(".json") ? extendsValue : `${extendsValue}.json`;
+	if (extendsValue.startsWith("./") || extendsValue.startsWith("../")) return path.resolve(fromConfigDirectory, withExtension);
+	return path.join(fromConfigDirectory, "node_modules", withExtension);
+};
+const parsePathsField = (pathsField) => {
+	const paths = /* @__PURE__ */ new Map();
+	if (!isObjectRecord(pathsField)) return paths;
+	for (const [pattern, targets] of Object.entries(pathsField)) {
+		if (!Array.isArray(targets)) continue;
+		const stringTargets = targets.filter((target) => typeof target === "string");
+		if (stringTargets.length > 0) paths.set(pattern, stringTargets);
+	}
+	return paths;
+};
+const readResolvedTsconfig = (configFilePath, extendsDepth) => {
+	const parsed = parseTsconfigFile(configFilePath);
+	if (!parsed) return null;
+	const configDirectory = path.dirname(configFilePath);
+	const compilerOptions = isObjectRecord(parsed.compilerOptions) ? parsed.compilerOptions : {};
+	const baseUrlValue = typeof compilerOptions.baseUrl === "string" ? compilerOptions.baseUrl : null;
+	const hasExplicitBaseUrl = baseUrlValue !== null;
+	const baseAbsolutePath = baseUrlValue !== null ? path.resolve(configDirectory, baseUrlValue) : configDirectory;
+	if (isObjectRecord(compilerOptions.paths)) return {
+		baseAbsolutePath,
+		hasExplicitBaseUrl,
+		paths: parsePathsField(compilerOptions.paths)
+	};
+	if (typeof parsed.extends === "string" && extendsDepth < 8) {
+		const parentPath = resolveExtendsPath(parsed.extends, configDirectory);
+		const inherited = parentPath ? readResolvedTsconfig(parentPath, extendsDepth + 1) : null;
+		if (inherited) return inherited;
+	}
+	return hasExplicitBaseUrl ? {
+		baseAbsolutePath,
+		hasExplicitBaseUrl,
+		paths: /* @__PURE__ */ new Map()
+	} : null;
+};
+const configByFilePath = /* @__PURE__ */ new Map();
+const loadTsconfigCached = (configFilePath) => {
+	let fileStat;
+	try {
+		fileStat = fs.statSync(configFilePath);
+	} catch {
+		return null;
+	}
+	const cached = configByFilePath.get(configFilePath);
+	if (cached && cached.mtimeMs === fileStat.mtimeMs) return cached.config;
+	const config = readResolvedTsconfig(configFilePath, 0);
+	configByFilePath.set(configFilePath, {
+		mtimeMs: fileStat.mtimeMs,
+		config
+	});
+	return config;
+};
+const findNearestTsconfig = (fromDirectory) => {
+	let currentDirectory = fromDirectory;
+	for (let level = 0; level < 30; level++) {
+		for (const fileName of TSCONFIG_FILE_NAMES) {
+			const candidate = loadTsconfigCached(path.join(currentDirectory, fileName));
+			if (candidate) return candidate;
+		}
+		const parentDirectory = path.dirname(currentDirectory);
+		if (parentDirectory === currentDirectory) break;
+		currentDirectory = parentDirectory;
+	}
+	return null;
+};
+const matchPathPattern = (source, pattern) => {
+	const starIndex = pattern.indexOf("*");
+	if (starIndex === -1) return source === pattern ? "" : null;
+	const prefix = pattern.slice(0, starIndex);
+	const suffix = pattern.slice(starIndex + 1);
+	if (source.length >= prefix.length + suffix.length && source.startsWith(prefix) && source.endsWith(suffix)) return source.slice(prefix.length, source.length - suffix.length);
+	return null;
+};
+const resolveTsconfigAliasPath = (fromFilename, source) => {
+	const config = findNearestTsconfig(path.dirname(fromFilename));
+	if (!config) return null;
+	let bestPattern = null;
+	let bestCapture = "";
+	let bestPrefixLength = -1;
+	for (const pattern of config.paths.keys()) {
+		const capture = matchPathPattern(source, pattern);
+		if (capture === null) continue;
+		const starIndex = pattern.indexOf("*");
+		const prefixLength = starIndex === -1 ? pattern.length : starIndex;
+		if (prefixLength > bestPrefixLength) {
+			bestPattern = pattern;
+			bestCapture = capture;
+			bestPrefixLength = prefixLength;
+		}
+	}
+	if (bestPattern) for (const target of config.paths.get(bestPattern) ?? []) {
+		const substituted = target.replaceAll("*", bestCapture);
+		const resolved = resolveModuleFileFromAbsolutePath(path.resolve(config.baseAbsolutePath, substituted));
+		if (resolved) return resolved;
+	}
+	if (config.hasExplicitBaseUrl) return resolveModuleFileFromAbsolutePath(path.resolve(config.baseAbsolutePath, source));
+	return null;
+};
+//#endregion
+//#region src/plugin/utils/resolve-module-path.ts
+const resolveModulePath = (fromFilename, source) => resolveRelativeImportPath(fromFilename, source) ?? resolveTsconfigAliasPath(fromFilename, source);
+//#endregion
+//#region src/plugin/utils/resolve-cross-file-function-export.ts
+const resolveFunctionExportInFile = (filePath, exportedName, visitedFilePaths) => {
+	if (visitedFilePaths.size >= 4) return null;
+	if (visitedFilePaths.has(filePath)) return null;
+	visitedFilePaths.add(filePath);
+	const actualFilePath = resolveBarrelExportFilePath(filePath, exportedName) ?? filePath;
+	const programRoot = parseSourceFile(actualFilePath);
+	if (!programRoot) return null;
+	const exported = findExportedFunctionBody(programRoot, exportedName);
+	if (exported) return exported;
+	for (const reExportSource of findReExportSourcesForName(programRoot, exportedName)) {
+		const nextFilePath = resolveModulePath(actualFilePath, reExportSource);
+		if (!nextFilePath) continue;
+		const resolved = resolveFunctionExportInFile(nextFilePath, exportedName, visitedFilePaths);
+		if (resolved) return resolved;
+	}
+	return null;
+};
+const resolveCrossFileFunctionExport = (fromFilename, source, exportedName) => {
+	const resolvedFilePath = resolveModulePath(fromFilename, source);
+	if (!resolvedFilePath) return null;
+	return resolveFunctionExportInFile(resolvedFilePath, exportedName, /* @__PURE__ */ new Set());
+};
+//#endregion
+//#region src/plugin/utils/ast-mentions-suspense.ts
+const isSuspenseJsxOpeningName = (name) => {
+	if (isNodeOfType(name, "JSXIdentifier")) return name.name === "Suspense";
+	return isNodeOfType(name, "JSXMemberExpression") && isNodeOfType(name.property, "JSXIdentifier") && name.property.name === "Suspense";
+};
+const astMentionsSuspense = (programNode) => {
+	let didDetect = false;
 	walkAst(programNode, (child) => {
-		if (didSee) return false;
-		if (isNodeOfType(child, "JSXOpeningElement") && isNodeOfType(child.name, "JSXIdentifier") && child.name.name === "Suspense") {
-			didSee = true;
+		if (didDetect) return false;
+		if (isNodeOfType(child, "JSXOpeningElement") && isSuspenseJsxOpeningName(child.name)) {
+			didDetect = true;
 			return false;
 		}
 		if (isNodeOfType(child, "ImportDeclaration") && child.source?.value === "react") {
 			if ((child.specifiers ?? []).some((specifier) => isNodeOfType(specifier, "ImportSpecifier") && getImportedName$1(specifier) === "Suspense")) {
-				didSee = true;
+				didDetect = true;
 				return false;
 			}
 		}
 	});
-	return didSee;
+	return didDetect;
+};
+//#endregion
+//#region src/plugin/utils/find-ancestor-suspense-layout.ts
+const LAYOUT_FILE_NAMES = [
+	"layout.tsx",
+	"layout.jsx",
+	"layout.ts",
+	"layout.js"
+];
+const hasAncestorSuspenseLayout = (pageFilename) => {
+	const normalizedPage = pageFilename.replaceAll("\\", "/");
+	let currentDirectory = path.dirname(normalizedPage);
+	for (let level = 0; level < 30; level++) {
+		for (const layoutFileName of LAYOUT_FILE_NAMES) {
+			const layoutPath = path.join(currentDirectory, layoutFileName);
+			if (layoutPath.replaceAll("\\", "/") === normalizedPage) continue;
+			const programRoot = parseSourceFile(layoutPath);
+			if (programRoot && astMentionsSuspense(programRoot)) return true;
+		}
+		if (path.basename(currentDirectory) === "app") break;
+		const parentDirectory = path.dirname(currentDirectory);
+		if (parentDirectory === currentDirectory) break;
+		currentDirectory = parentDirectory;
+	}
+	return false;
+};
+//#endregion
+//#region src/plugin/rules/nextjs/nextjs-no-use-search-params-without-suspense.ts
+const astContainsUseSearchParams = (root) => {
+	let didFind = false;
+	walkAst(root, (child) => {
+		if (didFind) return false;
+		if (isHookCall$1(child, "useSearchParams")) {
+			didFind = true;
+			return false;
+		}
+	});
+	return didFind;
+};
+const isSuspenseJsxName = (name, suspenseLocalNames) => {
+	if (isNodeOfType(name, "JSXIdentifier")) return name.name === "Suspense" || suspenseLocalNames.has(name.name);
+	return isNodeOfType(name, "JSXMemberExpression") && isNodeOfType(name.property, "JSXIdentifier") && name.property.name === "Suspense";
+};
+const isInsideSuspenseBoundary = (node, suspenseLocalNames) => {
+	let ancestor = node.parent;
+	while (ancestor) {
+		if (isNodeOfType(ancestor, "JSXElement") && isSuspenseJsxName(ancestor.openingElement?.name, suspenseLocalNames)) return true;
+		ancestor = ancestor.parent ?? null;
+	}
+	return false;
+};
+const collectSuspenseLocalNames = (programNode) => {
+	const names = /* @__PURE__ */ new Set();
+	for (const statement of programNode.body ?? []) {
+		if (!isNodeOfType(statement, "ImportDeclaration")) continue;
+		if (statement.source?.value !== "react") continue;
+		for (const specifier of statement.specifiers ?? []) if (isNodeOfType(specifier, "ImportSpecifier") && getImportedName$1(specifier) === "Suspense" && specifier.local?.name) names.add(specifier.local.name);
+	}
+	return names;
+};
+const collectImportedComponents = (programNode) => {
+	const entries = /* @__PURE__ */ new Map();
+	for (const statement of programNode.body ?? []) {
+		if (!isNodeOfType(statement, "ImportDeclaration")) continue;
+		if (typeof statement.source?.value !== "string") continue;
+		const source = statement.source.value;
+		for (const specifier of statement.specifiers ?? []) {
+			const localName = specifier.local?.name;
+			if (!localName) continue;
+			const exportedName = resolveImportedExportName(specifier);
+			if (!exportedName) continue;
+			entries.set(localName, {
+				source,
+				exportedName
+			});
+		}
+	}
+	return entries;
 };
 const nextjsNoUseSearchParamsWithoutSuspense = defineRule({
 	id: "nextjs-no-use-search-params-without-suspense",
@@ -13196,25 +14166,68 @@ const nextjsNoUseSearchParamsWithoutSuspense = defineRule({
 	severity: "warn",
 	recommendation: "Wrap the component using useSearchParams: `<Suspense fallback={<Skeleton />}><SearchComponent /></Suspense>`",
 	create: (context) => {
+		let isPageOrLayoutFile = false;
+		let hasAncestorLayoutSuspense = false;
 		let hasSuspenseInFile = false;
+		let importedComponents = /* @__PURE__ */ new Map();
+		let suspenseLocalNames = /* @__PURE__ */ new Set();
 		return {
 			Program(programNode) {
-				hasSuspenseInFile = fileMentionsSuspense(programNode);
+				const filename = normalizeFilename$1(context.filename ?? "");
+				isPageOrLayoutFile = PAGE_OR_LAYOUT_FILE_PATTERN.test(filename);
+				if (!isPageOrLayoutFile) return;
+				hasAncestorLayoutSuspense = hasAncestorSuspenseLayout(context.filename ?? "");
+				if (hasAncestorLayoutSuspense) return;
+				hasSuspenseInFile = astMentionsSuspense(programNode);
+				importedComponents = collectImportedComponents(programNode);
+				suspenseLocalNames = collectSuspenseLocalNames(programNode);
 			},
 			CallExpression(node) {
-				if (hasSuspenseInFile) return;
+				if (!isPageOrLayoutFile || hasAncestorLayoutSuspense || hasSuspenseInFile) return;
 				if (!isHookCall$1(node, "useSearchParams")) return;
 				context.report({
 					node,
 					message: "useSearchParams() without a <Suspense> boundary forces the whole page into client-side rendering."
 				});
+			},
+			JSXOpeningElement(node) {
+				if (!isPageOrLayoutFile || hasAncestorLayoutSuspense) return;
+				if (!isNodeOfType(node.name, "JSXIdentifier")) return;
+				const importEntry = importedComponents.get(node.name.name);
+				if (!importEntry) return;
+				const jsxElement = node.parent;
+				if (!jsxElement) return;
+				if (isInsideSuspenseBoundary(jsxElement, suspenseLocalNames)) return;
+				const componentBody = resolveCrossFileFunctionExport(context.filename ?? "", importEntry.source, importEntry.exportedName);
+				if (!componentBody || !astContainsUseSearchParams(componentBody)) return;
+				context.report({
+					node,
+					message: `<${node.name.name}> uses useSearchParams() but is not wrapped in a <Suspense> boundary.`
+				});
 			}
 		};
 	}
 });
 //#endregion
+//#region src/plugin/rules/nextjs/nextjs-no-vercel-og-import.ts
+const nextjsNoVercelOgImport = defineRule({
+	id: "nextjs-no-vercel-og-import",
+	title: "@vercel/og import instead of next/og",
+	tags: ["test-noise"],
+	requires: ["nextjs"],
+	severity: "warn",
+	recommendation: "Use `import { ImageResponse } from \"next/og\"`. The `@vercel/og` package is built into Next.js and should not be imported directly",
+	create: (context) => ({ ImportDeclaration(node) {
+		if (node.source?.value !== "@vercel/og") return;
+		context.report({
+			node,
+			message: "@vercel/og is bundled into Next.js. Import from \"next/og\" instead to avoid duplicate code and version mismatch."
+		});
+	} })
+});
+//#endregion
 //#region src/plugin/rules/a11y/no-access-key.ts
-const MESSAGE$30 = "Screen reader users can lose their shortcuts because `accessKey` clashes with them, so remove it.";
+const MESSAGE$31 = "Screen reader users can lose their shortcuts because `accessKey` clashes with them, so remove it.";
 const isUndefinedIdentifier = (expression) => isNodeOfType(expression, "Identifier") && expression.name === "undefined";
 const noAccessKey = defineRule({
 	id: "no-access-key",
@@ -13231,7 +14244,7 @@ const noAccessKey = defineRule({
 		if (isNodeOfType(attributeValue, "Literal") && typeof attributeValue.value === "string") {
 			context.report({
 				node: accessKey,
-				message: MESSAGE$30
+				message: MESSAGE$31
 			});
 			return;
 		}
@@ -13241,7 +14254,7 @@ const noAccessKey = defineRule({
 			if (isUndefinedIdentifier(expression)) return;
 			context.report({
 				node: accessKey,
-				message: MESSAGE$30
+				message: MESSAGE$31
 			});
 		}
 	} })
@@ -13724,7 +14737,7 @@ const noAdjustStateOnPropChange = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/no-aria-hidden-on-focusable.ts
-const MESSAGE$29 = "Screen reader users tab to this focusable element but hear nothing because `aria-hidden` skips it, so remove `aria-hidden` or stop it being focusable.";
+const MESSAGE$30 = "Screen reader users tab to this focusable element but hear nothing because `aria-hidden` skips it, so remove `aria-hidden` or stop it being focusable.";
 const noAriaHiddenOnFocusable = defineRule({
 	id: "no-aria-hidden-on-focusable",
 	title: "aria-hidden on focusable element",
@@ -13751,7 +14764,7 @@ const noAriaHiddenOnFocusable = defineRule({
 		const isImplicitlyFocusable = isInteractiveElement(tag, node);
 		if (isExplicitlyFocusable || isImplicitlyFocusable) context.report({
 			node: ariaHidden,
-			message: MESSAGE$29
+			message: MESSAGE$30
 		});
 	} })
 });
@@ -14119,7 +15132,7 @@ const noArrayIndexAsKey = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/no-array-index-key.ts
-const MESSAGE$28 = "Your users can see & submit the wrong data when this list reorders.";
+const MESSAGE$29 = "Your users can see & submit the wrong data when this list reorders.";
 const SECOND_INDEX_METHODS = new Set([
 	"every",
 	"filter",
@@ -14323,7 +15336,7 @@ const noArrayIndexKey = defineRule({
 			}
 			context.report({
 				node: keyAttribute,
-				message: MESSAGE$28
+				message: MESSAGE$29
 			});
 		},
 		CallExpression(node) {
@@ -14343,7 +15356,7 @@ const noArrayIndexKey = defineRule({
 				if (propName !== "key") continue;
 				if (expressionUsesIndex(property.value, indexBinding.name)) context.report({
 					node: property,
-					message: MESSAGE$28
+					message: MESSAGE$29
 				});
 			}
 		}
@@ -14351,7 +15364,7 @@ const noArrayIndexKey = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/a11y/no-autofocus.ts
-const MESSAGE$27 = "Screen reader & keyboard users get disoriented because `autoFocus` jumps focus on load, so remove it and let people choose where to focus.";
+const MESSAGE$28 = "Screen reader & keyboard users get disoriented because `autoFocus` jumps focus on load, so remove it and let people choose where to focus.";
 const resolveSettings$21 = (settings) => {
 	const reactDoctor = settings?.["react-doctor"];
 	return { ignoreNonDOM: (typeof reactDoctor === "object" && reactDoctor !== null ? reactDoctor.noAutofocus ?? {} : {}).ignoreNonDOM ?? true };
@@ -14407,7 +15420,7 @@ const noAutofocus = defineRule({
 			}
 			context.report({
 				node: autoFocusAttribute,
-				message: MESSAGE$27
+				message: MESSAGE$28
 			});
 		} };
 	}
@@ -14421,306 +15434,6 @@ const createRelativeImportSource = (filename, targetFilePath) => {
 	return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
 };
 //#endregion
-//#region src/plugin/utils/parse-export-specifiers.ts
-const getSpecifierName = (rawName) => rawName.replace(/^type\s+/, "").trim();
-const parseExportSpecifiers = (specifiersText, declarationIsTypeOnly) => specifiersText.split(",").map((specifierText) => specifierText.trim()).filter(Boolean).map((specifierText) => {
-	const isTypeOnly = declarationIsTypeOnly || specifierText.startsWith("type ");
-	const [rawLocalName, rawExportedName] = specifierText.split(/\s+as\s+/);
-	const localName = getSpecifierName(rawLocalName ?? "");
-	return {
-		localName,
-		exportedName: getSpecifierName(rawExportedName ?? localName),
-		isTypeOnly
-	};
-});
-//#endregion
-//#region src/plugin/utils/strip-js-comments.ts
-const BLOCK_COMMENT_PATTERN = /\/\*[\s\S]*?\*\//g;
-const LINE_COMMENT_PATTERN = /^\s*\/\/.*$/gm;
-const stripJsComments = (sourceText) => sourceText.replace(BLOCK_COMMENT_PATTERN, "").replace(LINE_COMMENT_PATTERN, "");
-//#endregion
-//#region src/plugin/utils/is-barrel-index-module.ts
-const INDEX_MODULE_FILE_PATTERN = /^index\.(?:[cm]?[jt]sx?|mjs)$/;
-const BINDING_IMPORT_DECLARATION_PATTERN = /^\s*import\s+(type\s+)?(?!["'])([^;]*?)\s+from\s+["']([^"']+)["']\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
-const BARREL_REEXPORT_DECLARATION_PATTERN = /^\s*export\s+(type\s+)?(?:\*(?:\s+as\s+([\w$]+))?|\{([\s\S]*?)\})\s+from\s+["']([^"']+)["']\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
-const LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN$1 = /^\s*export\s+(type\s+)?\{([\s\S]*?)\}\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
-const barrelIndexModuleInfoCache = /* @__PURE__ */ new Map();
-const isIndexModuleFilePath = (filePath) => INDEX_MODULE_FILE_PATTERN.test(path.basename(filePath));
-const createNonBarrelInfo = () => ({
-	isBarrel: false,
-	exportsByName: /* @__PURE__ */ new Map(),
-	starExportSources: []
-});
-const addImportedBinding = (importedBindings, binding) => {
-	importedBindings.set(binding.localName, {
-		...binding,
-		didExport: false
-	});
-};
-const collectNamedImportBindings = (namedSpecifiersText, source, declarationIsTypeOnly, importedBindings) => {
-	for (const specifier of parseExportSpecifiers(namedSpecifiersText, declarationIsTypeOnly)) addImportedBinding(importedBindings, {
-		localName: specifier.exportedName,
-		importedName: specifier.localName,
-		source,
-		isTypeOnly: specifier.isTypeOnly
-	});
-};
-const collectImportBindings = (importClause, source, declarationIsTypeOnly, importedBindings) => {
-	const trimmedImportClause = importClause.trim();
-	const namespaceMatch = trimmedImportClause.match(/(?:^|,\s*)\*\s+as\s+([\w$]+)/);
-	if (namespaceMatch?.[1]) addImportedBinding(importedBindings, {
-		localName: namespaceMatch[1],
-		importedName: "*",
-		source,
-		isTypeOnly: declarationIsTypeOnly
-	});
-	const namedImportMatch = trimmedImportClause.match(/\{([\s\S]*?)\}/);
-	if (namedImportMatch?.[1]) collectNamedImportBindings(namedImportMatch[1], source, declarationIsTypeOnly, importedBindings);
-	const defaultImportName = trimmedImportClause.split(",")[0]?.trim();
-	if (defaultImportName && !defaultImportName.startsWith("{") && !defaultImportName.startsWith("*")) addImportedBinding(importedBindings, {
-		localName: defaultImportName,
-		importedName: "default",
-		source,
-		isTypeOnly: declarationIsTypeOnly
-	});
-};
-const replaceKnownDeclarations = (sourceText, importedBindings, exportsByName, starExportSources) => {
-	let withoutKnownDeclarations = sourceText.replace(BINDING_IMPORT_DECLARATION_PATTERN, (_match, typeKeyword, importClause, source) => {
-		collectImportBindings(importClause, source, Boolean(typeKeyword), importedBindings);
-		return "";
-	});
-	withoutKnownDeclarations = withoutKnownDeclarations.replace(BARREL_REEXPORT_DECLARATION_PATTERN, (_match, typeKeyword, namespaceExportName, specifiersText, source) => {
-		const isTypeOnly = Boolean(typeKeyword);
-		if (namespaceExportName) {
-			exportsByName.set(namespaceExportName, {
-				exportedName: namespaceExportName,
-				importedName: "*",
-				source,
-				isTypeOnly
-			});
-			return "";
-		}
-		if (specifiersText) {
-			for (const specifier of parseExportSpecifiers(specifiersText, isTypeOnly)) exportsByName.set(specifier.exportedName, {
-				exportedName: specifier.exportedName,
-				importedName: specifier.localName,
-				source,
-				isTypeOnly: specifier.isTypeOnly
-			});
-			return "";
-		}
-		starExportSources.push(source);
-		return "";
-	});
-	withoutKnownDeclarations = withoutKnownDeclarations.replace(LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN$1, (_match, typeKeyword, specifiersText) => {
-		for (const specifier of parseExportSpecifiers(specifiersText, Boolean(typeKeyword))) {
-			const importedBinding = importedBindings.get(specifier.localName);
-			if (!importedBinding) return _match;
-			importedBinding.didExport = true;
-			exportsByName.set(specifier.exportedName, {
-				exportedName: specifier.exportedName,
-				importedName: importedBinding.importedName,
-				source: importedBinding.source,
-				isTypeOnly: specifier.isTypeOnly || importedBinding.isTypeOnly
-			});
-		}
-		return "";
-	});
-	return withoutKnownDeclarations;
-};
-const hasUnexportedRuntimeImport = (importedBindings) => {
-	for (const binding of importedBindings.values()) if (!binding.isTypeOnly && !binding.didExport) return true;
-	return false;
-};
-const classifyBarrelModule = (sourceText) => {
-	const strippedSource = stripJsComments(sourceText).trim();
-	if (!strippedSource) return createNonBarrelInfo();
-	const importedBindings = /* @__PURE__ */ new Map();
-	const exportsByName = /* @__PURE__ */ new Map();
-	const starExportSources = [];
-	if (replaceKnownDeclarations(strippedSource, importedBindings, exportsByName, starExportSources).trim() || hasUnexportedRuntimeImport(importedBindings)) return createNonBarrelInfo();
-	return {
-		isBarrel: exportsByName.size > 0 || starExportSources.length > 0,
-		exportsByName,
-		starExportSources
-	};
-};
-const getBarrelIndexModuleInfo = (filePath) => {
-	if (!isIndexModuleFilePath(filePath)) return createNonBarrelInfo();
-	const cachedResult = barrelIndexModuleInfoCache.get(filePath);
-	if (cachedResult !== void 0) return cachedResult;
-	let moduleInfo = createNonBarrelInfo();
-	try {
-		moduleInfo = classifyBarrelModule(fs.readFileSync(filePath, "utf8"));
-	} catch {
-		moduleInfo = createNonBarrelInfo();
-	}
-	barrelIndexModuleInfoCache.set(filePath, moduleInfo);
-	return moduleInfo;
-};
-const isBarrelIndexModule = (filePath) => getBarrelIndexModuleInfo(filePath).isBarrel;
-//#endregion
-//#region src/plugin/utils/does-module-export-name.ts
-const DEFAULT_EXPORT_DECLARATION_PATTERN = /^\s*export\s+default\b/m;
-const NAMED_EXPORT_DECLARATION_PATTERN = /^\s*export\s+(?:declare\s+)?(?:(?:async\s+)?function|(?:abstract\s+)?class|const|let|var|enum|interface|type)\s+([\w$]+)/gm;
-const LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN = /^\s*export\s+(?:type\s+)?\{([\s\S]*?)\}(?:\s+from\s+["'][^"']+["'])?\s*;?\s*(?:(?:\/\/[^\n]*)?\s*)/gm;
-const doesSourceTextExportName = (sourceText, exportedName) => {
-	const strippedSource = stripJsComments(sourceText);
-	if (exportedName === "default" && DEFAULT_EXPORT_DECLARATION_PATTERN.test(strippedSource)) return true;
-	for (const match of strippedSource.matchAll(NAMED_EXPORT_DECLARATION_PATTERN)) if (match[1] === exportedName) return true;
-	for (const match of strippedSource.matchAll(LOCAL_EXPORT_SPECIFIER_DECLARATION_PATTERN)) if (parseExportSpecifiers(match[1] ?? "", false).map((specifier) => specifier.exportedName).includes(exportedName)) return true;
-	return false;
-};
-const doesModuleExportName = (filePath, exportedName) => {
-	try {
-		return doesSourceTextExportName(fs.readFileSync(filePath, "utf8"), exportedName);
-	} catch {
-		return false;
-	}
-};
-//#endregion
-//#region src/plugin/utils/resolve-relative-import-path.ts
-const MODULE_FILE_EXTENSIONS = [
-	".ts",
-	".tsx",
-	".js",
-	".jsx",
-	".mjs",
-	".cjs",
-	".mts",
-	".cts"
-];
-const PACKAGE_EXPORT_CONDITIONS = [
-	"import",
-	"default",
-	"module",
-	"browser",
-	"require"
-];
-const PACKAGE_ENTRY_FIELDS = [
-	"module",
-	"main",
-	"browser"
-];
-const getExistingFilePath = (filePath) => {
-	try {
-		return fs.statSync(filePath).isFile() ? filePath : null;
-	} catch {
-		return null;
-	}
-};
-const getExistingDirectoryPath = (directoryPath) => {
-	try {
-		return fs.statSync(directoryPath).isDirectory() ? directoryPath : null;
-	} catch {
-		return null;
-	}
-};
-const getModuleFilePathCandidates = (modulePath) => {
-	const extension = path.extname(modulePath);
-	if (!extension) return MODULE_FILE_EXTENSIONS.map((moduleExtension) => `${modulePath}${moduleExtension}`);
-	const modulePathWithoutExtension = modulePath.slice(0, -extension.length);
-	if (extension === ".js") return [
-		modulePath,
-		`${modulePathWithoutExtension}.ts`,
-		`${modulePathWithoutExtension}.tsx`,
-		`${modulePathWithoutExtension}.jsx`
-	];
-	if (extension === ".jsx") return [modulePath, `${modulePathWithoutExtension}.tsx`];
-	if (extension === ".mjs") return [modulePath, `${modulePathWithoutExtension}.mts`];
-	if (extension === ".cjs") return [modulePath, `${modulePathWithoutExtension}.cts`];
-	return [modulePath];
-};
-const isObjectRecord = (value) => typeof value === "object" && value !== null;
-const getConditionalExportEntry = (exportEntry) => {
-	if (typeof exportEntry === "string") return exportEntry;
-	if (Array.isArray(exportEntry)) {
-		for (const fallbackEntry of exportEntry) {
-			const resolvedFallbackEntry = getConditionalExportEntry(fallbackEntry);
-			if (resolvedFallbackEntry) return resolvedFallbackEntry;
-		}
-		return null;
-	}
-	if (!isObjectRecord(exportEntry)) return null;
-	for (const condition of PACKAGE_EXPORT_CONDITIONS) {
-		const nestedEntry = getConditionalExportEntry(exportEntry[condition]);
-		if (nestedEntry) return nestedEntry;
-	}
-	return null;
-};
-const getPackageExportEntry = (packageJson) => {
-	const exportsField = packageJson.exports;
-	if (!exportsField) return null;
-	const directExportEntry = getConditionalExportEntry(exportsField);
-	if (directExportEntry) return directExportEntry;
-	if (!isObjectRecord(exportsField)) return null;
-	return getConditionalExportEntry(exportsField["."]);
-};
-const resolveModulePathWithIndexFallback = (modulePath) => {
-	const filePath = resolveModuleFilePath(modulePath);
-	if (filePath) return filePath;
-	return resolveModuleFilePath(path.join(modulePath, "index"));
-};
-const resolvePackageDirectoryEntry = (directoryPath) => {
-	const existingDirectoryPath = getExistingDirectoryPath(directoryPath);
-	if (!existingDirectoryPath) return null;
-	const packageJsonPath = path.join(existingDirectoryPath, "package.json");
-	try {
-		const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
-		const packageEntry = getPackageExportEntry(packageJson) ?? PACKAGE_ENTRY_FIELDS.map((fieldName) => packageJson[fieldName]).find((value) => typeof value === "string");
-		if (!packageEntry) return null;
-		return resolveModulePathWithIndexFallback(path.resolve(existingDirectoryPath, packageEntry));
-	} catch {
-		return null;
-	}
-};
-const resolveModuleFilePath = (modulePath) => {
-	const exactFilePath = getExistingFilePath(modulePath);
-	if (exactFilePath) return exactFilePath;
-	for (const candidateFilePath of getModuleFilePathCandidates(modulePath)) {
-		const filePath = getExistingFilePath(candidateFilePath);
-		if (filePath) return filePath;
-	}
-	return null;
-};
-const resolveRelativeImportPath = (filename, source) => {
-	const importPath = path.resolve(path.dirname(filename), source);
-	const directFilePath = resolveModuleFilePath(importPath);
-	if (directFilePath) return directFilePath;
-	const packageEntryFilePath = resolvePackageDirectoryEntry(importPath);
-	if (packageEntryFilePath) return packageEntryFilePath;
-	return resolveModuleFilePath(path.join(importPath, "index"));
-};
-//#endregion
-//#region src/plugin/utils/resolve-barrel-export-file-path.ts
-const getUniqueFilePath = (filePaths) => {
-	const uniqueFilePaths = new Set(filePaths);
-	if (uniqueFilePaths.size !== 1) return null;
-	const [filePath] = uniqueFilePaths;
-	return filePath ?? null;
-};
-const resolveStarExportFilePath = (barrelFilePath, exportedName, source, visitedFilePaths) => {
-	const resolvedTargetPath = resolveRelativeImportPath(barrelFilePath, source);
-	if (!resolvedTargetPath) return null;
-	const nestedTargetPath = resolveBarrelExportFilePath(resolvedTargetPath, exportedName, new Set(visitedFilePaths));
-	if (nestedTargetPath) return nestedTargetPath;
-	return doesModuleExportName(resolvedTargetPath, exportedName) ? resolvedTargetPath : null;
-};
-const resolveBarrelExportFilePath = (barrelFilePath, exportedName, visitedFilePaths = /* @__PURE__ */ new Set()) => {
-	if (visitedFilePaths.has(barrelFilePath)) return null;
-	visitedFilePaths.add(barrelFilePath);
-	const moduleInfo = getBarrelIndexModuleInfo(barrelFilePath);
-	if (!moduleInfo.isBarrel) return null;
-	const target = moduleInfo.exportsByName.get(exportedName);
-	if (target) {
-		const resolvedTargetPath = resolveRelativeImportPath(barrelFilePath, target.source);
-		if (!resolvedTargetPath) return null;
-		return resolveBarrelExportFilePath(resolvedTargetPath, target.importedName, visitedFilePaths) ?? resolvedTargetPath;
-	}
-	if (exportedName === "default") return null;
-	return getUniqueFilePath(moduleInfo.starExportSources.map((source) => resolveStarExportFilePath(barrelFilePath, exportedName, source, visitedFilePaths)).filter((filePath) => Boolean(filePath)));
-};
-//#endregion
 //#region src/plugin/rules/bundle-size/no-barrel-import.ts
 const getLiteralName = (node) => {
 	if (node.type === "Identifier" && typeof node.name === "string") return node.name;
@@ -14932,7 +15645,7 @@ const noChainStateUpdates = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/no-children-prop.ts
-const MESSAGE$26 = "Your component can render the wrong children when you pass them through a `children` prop.";
+const MESSAGE$27 = "Your component can render the wrong children when you pass them through a `children` prop.";
 const noChildrenProp = defineRule({
 	id: "no-children-prop",
 	title: "Children passed as a prop",
@@ -14944,7 +15657,7 @@ const noChildrenProp = defineRule({
 			if (node.name.name !== "children") return;
 			context.report({
 				node: node.name,
-				message: MESSAGE$26
+				message: MESSAGE$27
 			});
 		},
 		CallExpression(node) {
@@ -14957,7 +15670,7 @@ const noChildrenProp = defineRule({
 				const propertyKey = property.key;
 				if (isNodeOfType(propertyKey, "Identifier") && propertyKey.name === "children" || isNodeOfType(propertyKey, "Literal") && propertyKey.value === "children") context.report({
 					node: propertyKey,
-					message: MESSAGE$26
+					message: MESSAGE$27
 				});
 			}
 		}
@@ -14965,7 +15678,7 @@ const noChildrenProp = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/no-clone-element.ts
-const MESSAGE$25 = "`React.cloneElement` breaks easily when the cloned element's props change.";
+const MESSAGE$26 = "`React.cloneElement` breaks easily when the cloned element's props change.";
 const noCloneElement = defineRule({
 	id: "no-clone-element",
 	title: "Use of cloneElement",
@@ -14978,7 +15691,7 @@ const noCloneElement = defineRule({
 		if (isNodeOfType(callee, "Identifier") && callee.name === "cloneElement") {
 			if (isImportedFromModule(node, "cloneElement", "react")) context.report({
 				node: callee,
-				message: MESSAGE$25
+				message: MESSAGE$26
 			});
 			return;
 		}
@@ -14991,7 +15704,7 @@ const noCloneElement = defineRule({
 			if (!isImportedFromModule(node, callee.object.name, "react")) return;
 			context.report({
 				node: callee,
-				message: MESSAGE$25
+				message: MESSAGE$26
 			});
 		}
 	} })
@@ -15040,7 +15753,7 @@ const enclosingComponentOrHookName = (node) => {
 };
 //#endregion
 //#region src/plugin/rules/state-and-effects/no-create-context-in-render.ts
-const MESSAGE$24 = "createContext() builds a new context every render, so every consumer gets cut off & resets.";
+const MESSAGE$25 = "createContext() builds a new context every render, so every consumer gets cut off & resets.";
 const CONTEXT_MODULES = [
 	"react",
 	"use-context-selector",
@@ -15076,7 +15789,7 @@ const noCreateContextInRender = defineRule({
 		if (!componentOrHookName) return;
 		context.report({
 			node,
-			message: `${MESSAGE$24} (called inside "${componentOrHookName}")`
+			message: `${MESSAGE$25} (called inside "${componentOrHookName}")`
 		});
 	} })
 });
@@ -15216,7 +15929,7 @@ const noCreateStoreInRender = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/no-danger.ts
-const MESSAGE$23 = "`dangerouslySetInnerHTML` is an XSS hole that runs attacker-controlled HTML in your users' browsers.";
+const MESSAGE$24 = "`dangerouslySetInnerHTML` is an XSS hole that runs attacker-controlled HTML in your users' browsers.";
 const noDanger = defineRule({
 	id: "no-danger",
 	title: "Use of dangerouslySetInnerHTML",
@@ -15229,7 +15942,7 @@ const noDanger = defineRule({
 			if (!propAttribute) return;
 			context.report({
 				node: propAttribute.name,
-				message: MESSAGE$23
+				message: MESSAGE$24
 			});
 		},
 		CallExpression(node) {
@@ -15241,7 +15954,7 @@ const noDanger = defineRule({
 				const propertyKey = property.key;
 				if (isNodeOfType(propertyKey, "Identifier") && propertyKey.name === "dangerouslySetInnerHTML" || isNodeOfType(propertyKey, "Literal") && propertyKey.value === "dangerouslySetInnerHTML") context.report({
 					node: propertyKey,
-					message: MESSAGE$23
+					message: MESSAGE$24
 				});
 			}
 		}
@@ -15249,7 +15962,7 @@ const noDanger = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/react-builtins/no-danger-with-children.ts
-const MESSAGE$22 = "React throws an error when you set both children & `dangerouslySetInnerHTML`.";
+const MESSAGE$23 = "React throws an error when you set both children & `dangerouslySetInnerHTML`.";
 const isLineBreak = (child) => {
 	if (!isNodeOfType(child, "JSXText")) return false;
 	return child.value.trim().length === 0 && child.value.includes("\n");
@@ -15319,7 +16032,7 @@ const noDangerWithChildren = defineRule({
 			if (!hasChildrenProp && !hasNestedChildren) return;
 			if (hasJsxPropIgnoreCase(opening.attributes, "dangerouslySetInnerHTML") || spreadPropsShape.hasDangerously) context.report({
 				node: opening,
-				message: MESSAGE$22
+				message: MESSAGE$23
 			});
 		},
 		CallExpression(node) {
@@ -15331,7 +16044,7 @@ const noDangerWithChildren = defineRule({
 			if (!propsShape.hasDangerously) return;
 			if (node.arguments.length >= 3 || propsShape.hasChildren) context.report({
 				node,
-				message: MESSAGE$22
+				message: MESSAGE$23
 			});
 		}
 	})
@@ -15909,7 +16622,7 @@ const isSetStateCallInLifecycle = (setStateCall, lifecycleNames, options = {}) =
 //#endregion
 //#region src/plugin/rules/react-builtins/no-did-mount-set-state.ts
 const LIFECYCLE_NAMES$2 = new Set(["componentDidMount"]);
-const MESSAGE$21 = "Your users see an extra render right after mount when you call `setState` in `componentDidMount`.";
+const MESSAGE$22 = "Your users see an extra render right after mount when you call `setState` in `componentDidMount`.";
 const resolveSettings$20 = (settings) => {
 	const reactDoctor = settings?.["react-doctor"];
 	return { mode: (typeof reactDoctor === "object" && reactDoctor !== null ? reactDoctor.noDidMountSetState ?? {} : {}).mode ?? "allowed" };
@@ -15928,7 +16641,7 @@ const noDidMountSetState = defineRule({
 			if (!isSetStateCallInLifecycle(node, LIFECYCLE_NAMES$2, { disallowInNestedFunctions: mode === "disallow-in-func" })) return;
 			context.report({
 				node: node.callee,
-				message: MESSAGE$21
+				message: MESSAGE$22
 			});
 		} };
 	}
@@ -15936,7 +16649,7 @@ const noDidMountSetState = defineRule({
 //#endregion
 //#region src/plugin/rules/react-builtins/no-did-update-set-state.ts
 const LIFECYCLE_NAMES$1 = new Set(["componentDidUpdate"]);
-const MESSAGE$20 = "This can loop forever & freeze the component.";
+const MESSAGE$21 = "This can loop forever & freeze the component.";
 const resolveSettings$19 = (settings) => {
 	const reactDoctor = settings?.["react-doctor"];
 	return { mode: (typeof reactDoctor === "object" && reactDoctor !== null ? reactDoctor.noDidUpdateSetState ?? {} : {}).mode ?? "allowed" };
@@ -15955,7 +16668,7 @@ const noDidUpdateSetState = defineRule({
 			if (!isSetStateCallInLifecycle(node, LIFECYCLE_NAMES$1, { disallowInNestedFunctions: mode === "disallow-in-func" })) return;
 			context.report({
 				node: node.callee,
-				message: MESSAGE$20
+				message: MESSAGE$21
 			});
 		} };
 	}
@@ -15978,7 +16691,7 @@ const isStateMemberExpression = (node) => {
 };
 //#endregion
 //#region src/plugin/rules/react-builtins/no-direct-mutation-state.ts
-const MESSAGE$19 = "Your users see stale data because mutating `this.state` by hand never redraws & gets overwritten.";
+const MESSAGE$20 = "Your users see stale data because mutating `this.state` by hand never redraws & gets overwritten.";
 const shouldIgnoreMutation = (node) => {
 	let isConstructor = false;
 	let isInsideCallExpression = false;
@@ -16000,7 +16713,7 @@ const reportIfStateMutation = (context, reportNode, target) => {
 	if (shouldIgnoreMutation(reportNode)) return;
 	context.report({
 		node: reportNode,
-		message: MESSAGE$19
+		message: MESSAGE$20
 	});
 };
 const noDirectMutationState = defineRule({
@@ -17588,7 +18301,7 @@ const ALLOWED_NAMESPACES = new Set([
 	"ReactDOM",
 	"ReactDom"
 ]);
-const MESSAGE$18 = "`findDOMNode` crashes your app in React 19 because it was removed.";
+const MESSAGE$19 = "`findDOMNode` crashes your app in React 19 because it was removed.";
 const noFindDomNode = defineRule({
 	id: "no-find-dom-node",
 	title: "Use of findDOMNode",
@@ -17599,7 +18312,7 @@ const noFindDomNode = defineRule({
 		if (isNodeOfType(callee, "Identifier") && callee.name === "findDOMNode") {
 			context.report({
 				node: callee,
-				message: MESSAGE$18
+				message: MESSAGE$19
 			});
 			return;
 		}
@@ -17610,7 +18323,7 @@ const noFindDomNode = defineRule({
 			if (callee.property.name !== "findDOMNode") return;
 			context.report({
 				node: callee.property,
-				message: MESSAGE$18
+				message: MESSAGE$19
 			});
 		}
 	} })
@@ -18139,6 +18852,51 @@ const noIsMounted = defineRule({
 	} })
 });
 //#endregion
+//#region src/plugin/rules/correctness/no-jsx-element-type.ts
+const MESSAGE$18 = "`JSX.Element` is too narrow: it excludes `null`, strings, numbers, and fragments that components commonly return. Use `React.ReactNode` instead.";
+const isJsxElementTypeReference = (node) => {
+	if (!isNodeOfType(node, "TSTypeReference")) return false;
+	const typeName = node.typeName;
+	if (!isNodeOfType(typeName, "TSQualifiedName")) return false;
+	return isNodeOfType(typeName.left, "Identifier") && typeName.left.name === "JSX" && isNodeOfType(typeName.right, "Identifier") && typeName.right.name === "Element";
+};
+const extractReturnTypeAnnotation = (returnType) => {
+	if (!returnType) return null;
+	if (!isNodeOfType(returnType, "TSTypeAnnotation")) return null;
+	return returnType.typeAnnotation ?? null;
+};
+const checkReturnType = (context, returnType) => {
+	const typeAnnotation = extractReturnTypeAnnotation(returnType);
+	if (!typeAnnotation) return;
+	if (isJsxElementTypeReference(typeAnnotation)) context.report({
+		node: typeAnnotation,
+		message: MESSAGE$18
+	});
+};
+const noJsxElementType = defineRule({
+	id: "no-jsx-element-type",
+	title: "No JSX.Element",
+	severity: "error",
+	recommendation: "Replace `JSX.Element` with `React.ReactNode`. `JSX.Element` is too narrow: it excludes `null`, strings, numbers, and fragments that components commonly return.",
+	create: (context) => ({
+		FunctionDeclaration(node) {
+			checkReturnType(context, node.returnType);
+		},
+		ArrowFunctionExpression(node) {
+			checkReturnType(context, node.returnType);
+		},
+		FunctionExpression(node) {
+			checkReturnType(context, node.returnType);
+		},
+		TSDeclareFunction(node) {
+			checkReturnType(context, node.returnType);
+		},
+		TSMethodSignature(node) {
+			checkReturnType(context, node.returnType);
+		}
+	})
+});
+//#endregion
 //#region src/plugin/rules/design/no-justified-text.ts
 const noJustifiedText = defineRule({
 	id: "no-justified-text",
@@ -18410,11 +19168,14 @@ const noLongTransitionDuration = defineRule({
 	} })
 });
 //#endregion
+//#region src/plugin/utils/is-boolean-prefixed-prop-name.ts
+const BOOLEAN_PROP_PREFIX_PATTERN = /^(?:is|has|should|can|show|hide|enable|disable|with)[A-Z]/;
+const isBooleanPrefixedPropName = (propName) => BOOLEAN_PROP_PREFIX_PATTERN.test(propName);
+//#endregion
 //#region src/plugin/utils/is-component-declaration.ts
 const isComponentDeclaration = (node) => isNodeOfType(node, "FunctionDeclaration") && node.id !== null && Boolean(node.id?.name) && isUppercaseName(node.id.name);
 //#endregion
 //#region src/plugin/rules/architecture/no-many-boolean-props.ts
-const BOOLEAN_PROP_PREFIX_PATTERN = /^(?:is|has|should|can|show|hide|enable|disable|with)[A-Z]/;
 const collectBooleanLikePropsFromBody = (componentBody, propsParamName) => {
 	const found = /* @__PURE__ */ new Set();
 	if (!componentBody) return found;
@@ -18424,7 +19185,7 @@ const collectBooleanLikePropsFromBody = (componentBody, propsParamName) => {
 		if (!isNodeOfType(child.object, "Identifier")) return;
 		if (child.object.name !== propsParamName) return;
 		if (!isNodeOfType(child.property, "Identifier")) return;
-		if (!BOOLEAN_PROP_PREFIX_PATTERN.test(child.property.name)) return;
+		if (!isBooleanPrefixedPropName(child.property.name)) return;
 		found.add(child.property.name);
 	});
 	return found;
@@ -18450,7 +19211,7 @@ const noManyBooleanProps = defineRule({
 					if (!isNodeOfType(property, "Property")) continue;
 					const keyName = isNodeOfType(property.key, "Identifier") ? property.key.name : null;
 					if (!keyName) continue;
-					if (BOOLEAN_PROP_PREFIX_PATTERN.test(keyName)) booleanLikePropNames.push(keyName);
+					if (isBooleanPrefixedPropName(keyName)) booleanLikePropNames.push(keyName);
 				}
 				reportIfMany(booleanLikePropNames, componentName, reportNode);
 				return;
@@ -19020,224 +19781,7 @@ const isLodashMutatorCall = (callExpression) => {
 	return false;
 };
 //#endregion
-//#region src/plugin/utils/find-exported-function-body.ts
-const isFunctionLike = (node) => {
-	if (!node) return false;
-	return isNodeOfType(node, "FunctionDeclaration") || isNodeOfType(node, "FunctionExpression") || isNodeOfType(node, "ArrowFunctionExpression");
-};
-const findExportedFunctionBody = (programRoot, exportedName) => {
-	if (!isNodeOfType(programRoot, "Program")) return null;
-	const localBindings = /* @__PURE__ */ new Map();
-	const namedExports = /* @__PURE__ */ new Map();
-	let defaultExport = null;
-	let defaultExportIdentifierName = null;
-	const recordVariableDeclaration = (declaration) => {
-		for (const declarator of declaration.declarations ?? []) {
-			if (!isNodeOfType(declarator, "VariableDeclarator")) continue;
-			if (!isNodeOfType(declarator.id, "Identifier")) continue;
-			const initializer = declarator.init ? stripParenExpression(declarator.init) : null;
-			if (initializer && isFunctionLike(initializer)) localBindings.set(declarator.id.name, initializer);
-		}
-	};
-	for (const statement of programRoot.body ?? []) {
-		if (isNodeOfType(statement, "VariableDeclaration")) {
-			recordVariableDeclaration(statement);
-			continue;
-		}
-		if (isNodeOfType(statement, "FunctionDeclaration") && statement.id) {
-			localBindings.set(statement.id.name, statement);
-			continue;
-		}
-		if (isNodeOfType(statement, "ExportNamedDeclaration")) {
-			const declaration = statement.declaration;
-			if (declaration && isNodeOfType(declaration, "VariableDeclaration")) {
-				recordVariableDeclaration(declaration);
-				for (const declarator of declaration.declarations ?? []) {
-					if (!isNodeOfType(declarator, "VariableDeclarator")) continue;
-					if (!isNodeOfType(declarator.id, "Identifier")) continue;
-					namedExports.set(declarator.id.name, declarator.id.name);
-				}
-			} else if (declaration && isNodeOfType(declaration, "FunctionDeclaration") && declaration.id) {
-				localBindings.set(declaration.id.name, declaration);
-				namedExports.set(declaration.id.name, declaration.id.name);
-			}
-			for (const specifier of statement.specifiers ?? []) {
-				if (!isNodeOfType(specifier, "ExportSpecifier")) continue;
-				const local = specifier.local;
-				const exported = specifier.exported;
-				if (!isNodeOfType(local, "Identifier")) continue;
-				const exportedNameSpec = isNodeOfType(exported, "Identifier") ? exported.name : isNodeOfType(exported, "Literal") && typeof exported.value === "string" ? exported.value : null;
-				if (!exportedNameSpec) continue;
-				namedExports.set(exportedNameSpec, local.name);
-			}
-			continue;
-		}
-		if (isNodeOfType(statement, "ExportDefaultDeclaration")) {
-			const declaration = statement.declaration;
-			if (!declaration) continue;
-			if (isNodeOfType(declaration, "FunctionDeclaration") && declaration.id) {
-				localBindings.set(declaration.id.name, declaration);
-				defaultExport = declaration;
-				continue;
-			}
-			if (isFunctionLike(declaration)) {
-				defaultExport = declaration;
-				continue;
-			}
-			if (isNodeOfType(declaration, "Identifier")) {
-				defaultExportIdentifierName = declaration.name;
-				continue;
-			}
-		}
-	}
-	if (exportedName === "default") {
-		if (defaultExport) return defaultExport;
-		if (defaultExportIdentifierName) {
-			const binding = localBindings.get(defaultExportIdentifierName);
-			if (binding) return binding;
-		}
-	}
-	const localName = namedExports.get(exportedName);
-	if (!localName) return null;
-	return localBindings.get(localName) ?? null;
-};
-const resolveImportedExportName = (importSpecifier) => {
-	if (isNodeOfType(importSpecifier, "ImportSpecifier")) {
-		const imported = importSpecifier.imported;
-		if (isNodeOfType(imported, "Identifier")) return imported.name;
-		if (isNodeOfType(imported, "Literal") && typeof imported.value === "string") return imported.value;
-		return null;
-	}
-	if (isNodeOfType(importSpecifier, "ImportDefaultSpecifier")) return "default";
-	return null;
-};
-const findReExportSourcesForName = (programRoot, exportedName) => {
-	if (!isNodeOfType(programRoot, "Program")) return [];
-	const exportAllSources = [];
-	for (const statement of programRoot.body ?? []) {
-		if (isNodeOfType(statement, "ExportNamedDeclaration") && statement.source) {
-			const sourceValue = statement.source.value;
-			if (typeof sourceValue !== "string") continue;
-			for (const specifier of statement.specifiers ?? []) {
-				if (!isNodeOfType(specifier, "ExportSpecifier")) continue;
-				const exported = specifier.exported;
-				if ((isNodeOfType(exported, "Identifier") ? exported.name : isNodeOfType(exported, "Literal") && typeof exported.value === "string" ? exported.value : null) === exportedName) return [sourceValue];
-			}
-		}
-		if (isNodeOfType(statement, "ExportAllDeclaration") && statement.source) {
-			const sourceValue = statement.source.value;
-			if (typeof sourceValue === "string") exportAllSources.push(sourceValue);
-		}
-	}
-	return exportAllSources;
-};
-//#endregion
-//#region src/plugin/utils/attach-parent-references.ts
-const attachParentReferences = (root) => {
-	const visit = (node, parent) => {
-		const writableNode = node;
-		writableNode.parent = parent;
-		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 (isAstNode(item)) visit(item, node);
-			} else if (isAstNode(child)) visit(child, node);
-		}
-	};
-	visit(root, null);
-};
-//#endregion
-//#region src/plugin/utils/parse-source-file.ts
-const FILENAME_TO_LANG = {
-	".ts": "ts",
-	".tsx": "tsx",
-	".js": "js",
-	".jsx": "jsx",
-	".mjs": "js",
-	".cjs": "js",
-	".mts": "ts",
-	".cts": "ts"
-};
-const resolveLang = (filename) => {
-	return FILENAME_TO_LANG[path.extname(filename).toLowerCase()] ?? "tsx";
-};
-const parseCache = /* @__PURE__ */ new Map();
-const parseSourceFile = (absoluteFilePath) => {
-	let fileStat;
-	try {
-		fileStat = fs.statSync(absoluteFilePath);
-	} catch {
-		return null;
-	}
-	if (!fileStat.isFile()) return null;
-	if (fileStat.size > 2e6) return null;
-	const cached = parseCache.get(absoluteFilePath);
-	if (cached && cached.mtimeMs === fileStat.mtimeMs && cached.size === fileStat.size) return cached.program;
-	if (absoluteFilePath.endsWith(".d.ts") || absoluteFilePath.endsWith(".d.mts") || absoluteFilePath.endsWith(".d.cts")) {
-		parseCache.set(absoluteFilePath, {
-			mtimeMs: fileStat.mtimeMs,
-			size: fileStat.size,
-			program: null
-		});
-		return null;
-	}
-	let sourceText;
-	try {
-		sourceText = fs.readFileSync(absoluteFilePath, "utf8");
-	} catch {
-		parseCache.set(absoluteFilePath, {
-			mtimeMs: fileStat.mtimeMs,
-			size: fileStat.size,
-			program: null
-		});
-		return null;
-	}
-	let parsedProgram = null;
-	try {
-		const result = parseSync(absoluteFilePath, sourceText, {
-			astType: "ts",
-			lang: resolveLang(absoluteFilePath)
-		});
-		if (!result.errors.some((parseError) => parseError.severity === "Error")) {
-			parsedProgram = result.program;
-			attachParentReferences(parsedProgram);
-		}
-	} catch {
-		parsedProgram = null;
-	}
-	parseCache.set(absoluteFilePath, {
-		mtimeMs: fileStat.mtimeMs,
-		size: fileStat.size,
-		program: parsedProgram
-	});
-	return parsedProgram;
-};
-//#endregion
 //#region src/plugin/rules/state-and-effects/utils/resolve-reducer-function.ts
-const resolveFunctionExportInFile = (filePath, exportedName, visitedFilePaths) => {
-	if (visitedFilePaths.size >= 4) return null;
-	if (visitedFilePaths.has(filePath)) return null;
-	visitedFilePaths.add(filePath);
-	const actualFilePath = resolveBarrelExportFilePath(filePath, exportedName) ?? filePath;
-	const programRoot = parseSourceFile(actualFilePath);
-	if (!programRoot) return null;
-	const exported = findExportedFunctionBody(programRoot, exportedName);
-	if (exported) return exported;
-	for (const reExportSource of findReExportSourcesForName(programRoot, exportedName)) {
-		const nextFilePath = resolveRelativeImportPath(actualFilePath, reExportSource);
-		if (!nextFilePath) continue;
-		const resolved = resolveFunctionExportInFile(nextFilePath, exportedName, visitedFilePaths);
-		if (resolved) return resolved;
-	}
-	return null;
-};
-const resolveCrossFileFunctionExport = (fromFilename, source, exportedName) => {
-	const resolvedFilePath = resolveRelativeImportPath(fromFilename, source);
-	if (!resolvedFilePath) return null;
-	return resolveFunctionExportInFile(resolvedFilePath, exportedName, /* @__PURE__ */ new Set());
-};
 const resolveReducerFunction = (node, currentFilename) => {
 	if (!node) return null;
 	const unwrappedNode = stripParenExpression(node);
@@ -19259,7 +19803,6 @@ const resolveReducerFunction = (node, currentFilename) => {
 		if (!importDeclaration || !isNodeOfType(importDeclaration, "ImportDeclaration")) return null;
 		const sourceValue = importDeclaration.source?.value;
 		if (typeof sourceValue !== "string") return null;
-		if (!sourceValue.startsWith(".") && !sourceValue.startsWith("/")) return null;
 		const exportedName = resolveImportedExportName(initializer);
 		if (!exportedName) return null;
 		const crossFileFunction = resolveCrossFileFunctionExport(currentFilename, sourceValue, exportedName);
@@ -23259,6 +23802,7 @@ const noUnknownProperty = defineRule({
 	create: (context) => {
 		const { ignore = [], requireDataLowercase = false } = resolveSettings$10(context.settings);
 		const ignoreSet = new Set(ignore);
+		if (isNextjsMetadataImageRouteFilename(context.filename)) ignoreSet.add("tw");
 		let fileIsNonReactJsx = false;
 		return {
 			Program(node) {
@@ -23953,6 +24497,8 @@ const ENTRY_POINT_BASENAMES = new Set([
 	"global-error.jsx",
 	"route.tsx",
 	"route.jsx",
+	"_layout.tsx",
+	"_layout.jsx",
 	"_app.tsx",
 	"_app.jsx",
 	"_document.tsx",
@@ -24661,6 +25207,128 @@ const preferEs6Class = defineRule({
 	}
 });
 //#endregion
+//#region src/plugin/utils/is-jsx-element-or-fragment.ts
+/**
+* Type-guard for the two single-node JSX output forms: `JSXElement`
+* (`<Foo />`) and `JSXFragment` (`<>…</>`). Canonical home for the
+* `isNodeOfType(x, "JSXElement") || isNodeOfType(x, "JSXFragment")` check
+* that many rules otherwise inline. Does NOT unwrap parens / TS wrappers —
+* callers that need the semantic expression should `stripParenExpression`
+* first.
+*/
+const isJsxElementOrFragment = (node) => Boolean(node && (isNodeOfType(node, "JSXElement") || isNodeOfType(node, "JSXFragment")));
+//#endregion
+//#region src/plugin/rules/architecture/prefer-explicit-variants.ts
+const resolveBooleanPropTestName = (testNode, booleanPropBindings) => {
+	let identifierNode = stripParenExpression(testNode);
+	if (isNodeOfType(identifierNode, "UnaryExpression") && identifierNode.operator === "!") identifierNode = stripParenExpression(identifierNode.argument);
+	if (!isNodeOfType(identifierNode, "Identifier")) return null;
+	return booleanPropBindings.has(identifierNode.name) ? identifierNode.name : null;
+};
+const CROSS_CUTTING_STATE_BOOLEAN_NAMES = new Set([
+	"isLoading",
+	"isPending",
+	"isFetching",
+	"isRefetching",
+	"isSubmitting",
+	"isError",
+	"isSuccess",
+	"isEmpty",
+	"isReady",
+	"isDirty",
+	"isValid",
+	"isInvalid",
+	"isOpen",
+	"isClosed",
+	"isVisible",
+	"isHidden",
+	"isActive",
+	"isInactive",
+	"isExpanded",
+	"isCollapsed",
+	"isSelected",
+	"isChecked",
+	"isDisabled",
+	"isEnabled",
+	"isFocused",
+	"isHovered",
+	"isDragging",
+	"isFullscreen",
+	"isMobile",
+	"isDesktop",
+	"isTablet",
+	"isOnline",
+	"isOffline",
+	"isLoggedIn",
+	"isAuthenticated",
+	"isAuthorized",
+	"isDark",
+	"isLight"
+]);
+const collectBooleanPropBindings = (param) => {
+	const bindings = /* @__PURE__ */ new Set();
+	if (!param || !isNodeOfType(param, "ObjectPattern")) return bindings;
+	for (const property of param.properties ?? []) {
+		if (!isNodeOfType(property, "Property")) continue;
+		if (property.computed) continue;
+		if (!isNodeOfType(property.key, "Identifier")) continue;
+		if (!isBooleanPrefixedPropName(property.key.name)) continue;
+		if (CROSS_CUTTING_STATE_BOOLEAN_NAMES.has(property.key.name)) continue;
+		const propertyValue = property.value;
+		if (isNodeOfType(propertyValue, "Identifier")) bindings.add(propertyValue.name);
+		else if (isNodeOfType(propertyValue, "AssignmentPattern") && isNodeOfType(propertyValue.left, "Identifier")) bindings.add(propertyValue.left.name);
+	}
+	return bindings;
+};
+const collectVariantBranchProps = (body, booleanPropBindings) => {
+	const variantBranchProps = /* @__PURE__ */ new Set();
+	if (!body) return variantBranchProps;
+	walkAst(body, (current) => {
+		if (isNodeOfType(current, "FunctionDeclaration") || isInlineFunctionExpression(current)) return false;
+		if (!isNodeOfType(current, "ConditionalExpression")) return;
+		const propName = resolveBooleanPropTestName(current.test, booleanPropBindings);
+		if (!propName) return;
+		const consequent = stripParenExpression(current.consequent);
+		const alternate = stripParenExpression(current.alternate);
+		if (!isJsxElementOrFragment(consequent) || !isJsxElementOrFragment(alternate)) return;
+		variantBranchProps.add(propName);
+	});
+	return variantBranchProps;
+};
+const preferExplicitVariants = defineRule({
+	id: "prefer-explicit-variants",
+	title: "Prefer explicit variant components",
+	severity: "warn",
+	tags: ["test-noise", "react-jsx-only"],
+	recommendation: "Replace boolean props that switch whole subtrees with explicit variant components, like `<ThreadComposer />` and `<EditMessageComposer />`, so each variant renders one clear path.",
+	create: (context) => {
+		const checkComponent = (param, body, componentName, reportNode) => {
+			const booleanPropBindings = collectBooleanPropBindings(param);
+			if (booleanPropBindings.size < 2) return;
+			const variantBranchProps = collectVariantBranchProps(body, booleanPropBindings);
+			if (variantBranchProps.size < 2) return;
+			const propList = [...variantBranchProps].slice(0, 3).join(", ");
+			const overflow = variantBranchProps.size > 3 ? "…" : "";
+			context.report({
+				node: reportNode,
+				message: `Component "${componentName}" picks which component to render from ${variantBranchProps.size} boolean props (${propList}${overflow}), which multiplies untestable variants. Split it into explicit variant components so each renders one clear path.`
+			});
+		};
+		return {
+			FunctionDeclaration(node) {
+				if (!isComponentDeclaration(node) || !node.id) return;
+				checkComponent(node.params?.[0], node.body, node.id.name, node.id);
+			},
+			VariableDeclarator(node) {
+				if (!isComponentAssignment(node)) return;
+				if (!isNodeOfType(node.id, "Identifier")) return;
+				if (!isInlineFunctionExpression(node.init)) return;
+				checkComponent(node.init.params?.[0], node.init.body, node.id.name, node.id);
+			}
+		};
+	}
+});
+//#endregion
 //#region src/plugin/rules/react-builtins/prefer-function-component.ts
 const MESSAGE$7 = "This class component is harder to maintain than a function component.";
 const resolveSettings$4 = (settings) => {
@@ -25375,6 +26043,26 @@ const preferUseReducer = defineRule({
 	}
 });
 //#endregion
+//#region src/plugin/rules/tanstack-query/query-destructure-result.ts
+const queryDestructureResult = defineRule({
+	id: "query-destructure-result",
+	title: "Destructure TanStack Query result",
+	tags: ["test-noise"],
+	requires: ["tanstack-query"],
+	severity: "error",
+	recommendation: "Destructure only the fields you need, like `const { data, isLoading } = useQuery(...)`. Assigning the whole object bypasses TanStack Query's tracked-property optimization and subscribes to every field.",
+	create: (context) => ({ VariableDeclarator(node) {
+		if (!isNodeOfType(node.id, "Identifier")) return;
+		if (!node.init || !isNodeOfType(node.init, "CallExpression")) return;
+		const calleeName = isNodeOfType(node.init.callee, "Identifier") ? node.init.callee.name : null;
+		if (!calleeName || !TANSTACK_QUERY_HOOKS.has(calleeName)) return;
+		context.report({
+			node: node.id,
+			message: `Destructure ${calleeName}() results instead of assigning the whole query object, so TanStack Query only subscribes to the fields you use.`
+		});
+	} })
+});
+//#endregion
 //#region src/plugin/rules/tanstack-query/query-mutation-missing-invalidation.ts
 const queryMutationMissingInvalidation = defineRule({
 	id: "query-mutation-missing-invalidation",
@@ -32884,6 +33572,7 @@ const serverFetchWithoutRevalidate = defineRule({
 	id: "server-fetch-without-revalidate",
 	title: "Fetch without revalidate",
 	severity: "warn",
+	disabledBy: ["nextjs:15"],
 	recommendation: "Pass `{ next: { revalidate: <seconds> } }` (or `cache: \"no-store\"`) so old data doesn't stick around.",
 	create: (context) => {
 		let isServerSideFile = false;
@@ -32917,15 +33606,6 @@ const serverFetchWithoutRevalidate = defineRule({
 });
 //#endregion
 //#region src/plugin/rules/server/server-hoist-static-io.ts
-const ROUTE_HANDLER_HTTP_METHODS = new Set([
-	"GET",
-	"POST",
-	"PUT",
-	"PATCH",
-	"DELETE",
-	"OPTIONS",
-	"HEAD"
-]);
 const STATIC_IO_FUNCTIONS = new Set([
 	"readFileSync",
 	"readFile",
@@ -35440,6 +36120,28 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/nextjs-error-boundary-missing-use-client",
+		id: "nextjs-error-boundary-missing-use-client",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsErrorBoundaryMissingUseClient,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
+	{
+		key: "react-doctor/nextjs-global-error-missing-html-body",
+		id: "nextjs-global-error-missing-html-body",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsGlobalErrorMissingHtmlBody,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/nextjs-image-missing-sizes",
 		id: "nextjs-image-missing-sizes",
@@ -35517,6 +36219,28 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/nextjs-no-default-export-in-route-handler",
+		id: "nextjs-no-default-export-in-route-handler",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsNoDefaultExportInRouteHandler,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
+	{
+		key: "react-doctor/nextjs-no-edge-og-runtime",
+		id: "nextjs-no-edge-og-runtime",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsNoEdgeOgRuntime,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/nextjs-no-font-link",
 		id: "nextjs-no-font-link",
@@ -35528,6 +36252,17 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/nextjs-no-google-analytics-script",
+		id: "nextjs-no-google-analytics-script",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsNoGoogleAnalyticsScript,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/nextjs-no-head-import",
 		id: "nextjs-no-head-import",
@@ -35583,6 +36318,17 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/nextjs-no-script-in-head",
+		id: "nextjs-no-script-in-head",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsNoScriptInHead,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/nextjs-no-side-effect-in-get-handler",
 		id: "nextjs-no-side-effect-in-get-handler",
@@ -35605,6 +36351,17 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/nextjs-no-vercel-og-import",
+		id: "nextjs-no-vercel-og-import",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...nextjsNoVercelOgImport,
+			framework: "nextjs",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/no-access-key",
 		id: "no-access-key",
@@ -36155,6 +36912,17 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/no-jsx-element-type",
+		id: "no-jsx-element-type",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...noJsxElementType,
+			framework: "global",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/no-justified-text",
 		id: "no-justified-text",
@@ -36881,6 +37649,17 @@ const reactDoctorRules = [
 			category: "Maintainability"
 		}
 	},
+	{
+		key: "react-doctor/prefer-explicit-variants",
+		id: "prefer-explicit-variants",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...preferExplicitVariants,
+			framework: "global",
+			category: "Maintainability"
+		}
+	},
 	{
 		key: "react-doctor/prefer-function-component",
 		id: "prefer-function-component",
@@ -36980,6 +37759,17 @@ const reactDoctorRules = [
 			category: "Bugs"
 		}
 	},
+	{
+		key: "react-doctor/query-destructure-result",
+		id: "query-destructure-result",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...queryDestructureResult,
+			framework: "tanstack-query",
+			category: "Bugs"
+		}
+	},
 	{
 		key: "react-doctor/query-mutation-missing-invalidation",
 		id: "query-mutation-missing-invalidation",