oxlint-plugin-react-doctor 0.7.3-dev.82187a3 → 0.7.3-dev.f91ede7

package/dist/index.d.ts

@@ -4836,6 +4836,29 @@ declare const REACT_DOCTOR_RULES: readonly [{
     readonly recommendationFor?: (hasCapability: CapabilityQuery) => string | undefined;
     readonly create: (context: RuleContext) => RuleVisitors;
   };
+}, {
+  readonly key: "react-doctor/no-match-media-in-state-initializer";
+  readonly id: "no-match-media-in-state-initializer";
+  readonly source: "react-doctor";
+  readonly originallyExternal: false;
+  readonly rule: {
+    readonly framework: "global";
+    readonly category: "Bugs";
+    readonly requires: readonly Capability[];
+    readonly id: string;
+    readonly title?: string;
+    readonly severity: RuleSeverity;
+    readonly disabledWhen?: ReadonlyArray<Capability>;
+    readonly tags?: ReadonlyArray<string>;
+    readonly matchByOccurrence?: boolean;
+    readonly defaultEnabled?: boolean;
+    readonly lifecycle?: "retired";
+    readonly scan?: FileScan;
+    readonly committedFilesOnly?: boolean;
+    readonly recommendation?: string;
+    readonly recommendationFor?: (hasCapability: CapabilityQuery) => string | undefined;
+    readonly create: (context: RuleContext) => RuleVisitors;
+  };
 }, {
   readonly key: "react-doctor/no-mirror-prop-effect";
   readonly id: "no-mirror-prop-effect";
@@ -13964,6 +13987,29 @@ declare const RULES: readonly [{
     readonly recommendationFor?: (hasCapability: CapabilityQuery) => string | undefined;
     readonly create: (context: RuleContext) => RuleVisitors;
   };
+}, {
+  readonly key: "react-doctor/no-match-media-in-state-initializer";
+  readonly id: "no-match-media-in-state-initializer";
+  readonly source: "react-doctor";
+  readonly originallyExternal: false;
+  readonly rule: {
+    readonly framework: "global";
+    readonly category: "Bugs";
+    readonly requires: readonly Capability[];
+    readonly id: string;
+    readonly title?: string;
+    readonly severity: RuleSeverity;
+    readonly disabledWhen?: ReadonlyArray<Capability>;
+    readonly tags?: ReadonlyArray<string>;
+    readonly matchByOccurrence?: boolean;
+    readonly defaultEnabled?: boolean;
+    readonly lifecycle?: "retired";
+    readonly scan?: FileScan;
+    readonly committedFilesOnly?: boolean;
+    readonly recommendation?: string;
+    readonly recommendationFor?: (hasCapability: CapabilityQuery) => string | undefined;
+    readonly create: (context: RuleContext) => RuleVisitors;
+  };
 }, {
   readonly key: "react-doctor/no-mirror-prop-effect";
   readonly id: "no-mirror-prop-effect";

package/dist/index.js

@@ -31160,6 +31160,64 @@ const noManyBooleanProps = defineRule({
 	}
 });
 //#endregion
+//#region src/plugin/utils/is-global-match-media-call.ts
+const isGlobalMatchMediaCall = (node, scopes) => {
+	if (!isNodeOfType(node, "CallExpression")) return false;
+	const callee = stripParenExpression(node.callee);
+	if (isNodeOfType(callee, "Identifier")) return callee.name === "matchMedia" && scopes.isGlobalReference(callee);
+	if (!isNodeOfType(callee, "MemberExpression") || callee.computed || !isNodeOfType(callee.property, "Identifier") || callee.property.name !== "matchMedia") return false;
+	const receiver = stripParenExpression(callee.object);
+	return isNodeOfType(receiver, "Identifier") && (receiver.name === "window" || receiver.name === "globalThis") && scopes.isGlobalReference(receiver);
+};
+//#endregion
+//#region src/plugin/rules/performance/no-match-media-in-state-initializer.ts
+const REACT_USE_STATE_OPTIONS = {
+	allowGlobalReactNamespace: true,
+	allowUnboundBareCalls: false
+};
+const isReactUseStateCall = (node, context) => isReactApiCall(node, "useState", context.scopes, REACT_USE_STATE_OPTIONS);
+const findDirectMatchMediaCall = (root, context) => {
+	let matchMediaCall = null;
+	walkAst(root, (visitedNode) => {
+		if (matchMediaCall) return false;
+		if (isFunctionLike$1(visitedNode)) return false;
+		if (isGlobalMatchMediaCall(visitedNode, context.scopes)) {
+			matchMediaCall = visitedNode;
+			return false;
+		}
+	});
+	return matchMediaCall;
+};
+const findMatchMediaCallDuringInitialization = (initializer, context) => {
+	const rootInitializer = stripParenExpression(initializer);
+	if (!isFunctionLike$1(rootInitializer)) return findDirectMatchMediaCall(rootInitializer, context);
+	if (rootInitializer.async || rootInitializer.generator) return null;
+	return findDirectMatchMediaCall(rootInitializer.body, context);
+};
+const noMatchMediaInStateInitializer = defineRule({
+	id: "no-match-media-in-state-initializer",
+	title: "matchMedia in state initializer",
+	severity: "warn",
+	category: "Correctness",
+	disabledWhen: ["vite", "cra"],
+	recommendation: "Prefer CSS media queries for layout, or subscribe with `useSyncExternalStore` and provide a stable server snapshot.",
+	create: (context) => {
+		if (isTestlikeFilename(context.filename)) return {};
+		if (classifyReactNativeFileTarget(context) === "react-native") return {};
+		return { CallExpression(node) {
+			if (!isReactUseStateCall(node, context)) return;
+			const initializer = node.arguments?.[0];
+			if (!initializer || initializer.type === "SpreadElement") return;
+			const matchMediaCall = findMatchMediaCallDuringInitialization(initializer, context);
+			if (!matchMediaCall) return;
+			context.report({
+				node: matchMediaCall,
+				message: "`matchMedia()` in a useState initializer can cause an SSR crash or seed different server and hydration state. Prefer CSS media queries for layout, or use `useSyncExternalStore` with a stable server snapshot."
+			});
+		} };
+	}
+});
+//#endregion
 //#region src/plugin/rules/state-and-effects/no-mirror-prop-effect.ts
 const getPropRootName = (expression, propNames) => {
 	const rootName = getRootIdentifierName(expression, { followCallChains: true });
@@ -55255,6 +55313,18 @@ const reactDoctorRules = [
 			category: "Maintainability"
 		}
 	},
+	{
+		key: "react-doctor/no-match-media-in-state-initializer",
+		id: "no-match-media-in-state-initializer",
+		source: "react-doctor",
+		originallyExternal: false,
+		rule: {
+			...noMatchMediaInStateInitializer,
+			framework: "global",
+			category: "Bugs",
+			requires: [...new Set(["react", ...noMatchMediaInStateInitializer.requires ?? []])]
+		}
+	},
 	{
 		key: "react-doctor/no-mirror-prop-effect",
 		id: "no-mirror-prop-effect",
@@ -58123,6 +58193,7 @@ const CROSS_FILE_RULE_IDS = new Set([
 	"no-full-lodash-import",
 	"no-indeterminate-attribute",
 	"no-locale-format-in-render",
+	"no-match-media-in-state-initializer",
 	"no-mutating-reducer-state",
 	"prefer-dynamic-import",
 	"rendering-hydration-mismatch-time",
@@ -58259,6 +58330,7 @@ const CROSS_FILE_DEPENDENCY_COLLECTORS = new Map([
 	["no-full-lodash-import", collectNearestManifestDependencies],
 	["no-indeterminate-attribute", collectNearestManifestDependencies],
 	["no-locale-format-in-render", collectNearestManifestDependencies],
+	["no-match-media-in-state-initializer", collectNearestManifestDependencies],
 	["no-mutating-reducer-state", collectMutatingReducerDependencies],
 	["prefer-dynamic-import", collectNearestManifestDependencies],
 	["rendering-hydration-mismatch-time", collectNearestManifestDependencies],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxlint-plugin-react-doctor",
-  "version": "0.7.3-dev.82187a3",
+  "version": "0.7.3-dev.f91ede7",
   "description": "React Doctor rules for oxlint.",
   "keywords": [
     "accessibility",