@eslint-react/core 5.6.2 → 5.6.3-next.0

package/dist/index.d.ts

@@ -315,7 +315,7 @@ type FunctionSemanticNode = ClientFunctionSemanticNode | ServerFunctionSemanticN
  * @param node - The function node to analyze.
  * @returns The identifier node if found, `null` otherwise.
  */
-declare function getFunctionId(node: TSESTree.Expression | TSESTreeFunction): TSESTree.ArrayExpression | TSESTree.ArrayPattern | TSESTree.ArrowFunctionExpression | TSESTree.AssignmentExpression | TSESTree.AwaitExpression | TSESTree.PrivateInExpression | TSESTree.SymmetricBinaryExpression | TSESTree.CallExpression | TSESTree.ChainExpression | TSESTree.ClassExpression | TSESTree.ConditionalExpression | TSESTree.FunctionExpression | TSESTree.Identifier | TSESTree.ImportExpression | TSESTree.JSXElement | TSESTree.JSXFragment | TSESTree.BigIntLiteral | TSESTree.BooleanLiteral | TSESTree.NullLiteral | TSESTree.NumberLiteral | TSESTree.RegExpLiteral | TSESTree.StringLiteral | TSESTree.LogicalExpression | TSESTree.MemberExpressionComputedName | TSESTree.MemberExpressionNonComputedName | TSESTree.MetaProperty | TSESTree.NewExpression | TSESTree.ObjectExpression | TSESTree.ObjectPattern | TSESTree.PrivateIdentifier | TSESTree.SequenceExpression | TSESTree.Super | TSESTree.TaggedTemplateExpression | TSESTree.TemplateLiteral | TSESTree.ThisExpression | TSESTree.TSAsExpression | TSESTree.TSInstantiationExpression | TSESTree.TSNonNullExpression | TSESTree.TSSatisfiesExpression | TSESTree.TSTypeAssertion | TSESTree.UnaryExpressionBitwiseNot | TSESTree.UnaryExpressionDelete | TSESTree.UnaryExpressionMinus | TSESTree.UnaryExpressionNot | TSESTree.UnaryExpressionPlus | TSESTree.UnaryExpressionTypeof | TSESTree.UnaryExpressionVoid | TSESTree.UpdateExpression | TSESTree.YieldExpression | null;
+declare function getFunctionId(node: TSESTree.Expression | TSESTreeFunction): TSESTree.ArrayExpression | TSESTree.ArrayPattern | TSESTree.ArrowFunctionExpression | TSESTree.AssignmentExpression | TSESTree.AwaitExpression | TSESTree.PrivateInExpression | TSESTree.SymmetricBinaryExpression | TSESTree.CallExpression | TSESTree.ChainExpression | TSESTree.ClassExpression | TSESTree.ConditionalExpression | TSESTree.FunctionExpression | TSESTree.Identifier | TSESTree.ImportExpression | TSESTree.JSXElement | TSESTree.JSXFragment | TSESTree.BigIntLiteral | TSESTree.BooleanLiteral | TSESTree.NullLiteral | TSESTree.NumberLiteral | TSESTree.RegExpLiteral | TSESTree.StringLiteral | TSESTree.TemplateLiteral | TSESTree.LogicalExpression | TSESTree.MemberExpressionComputedName | TSESTree.MemberExpressionNonComputedName | TSESTree.MetaProperty | TSESTree.NewExpression | TSESTree.ObjectExpression | TSESTree.ObjectPattern | TSESTree.SequenceExpression | TSESTree.Super | TSESTree.TaggedTemplateExpression | TSESTree.ThisExpression | TSESTree.TSAsExpression | TSESTree.TSInstantiationExpression | TSESTree.TSNonNullExpression | TSESTree.TSSatisfiesExpression | TSESTree.TSTypeAssertion | TSESTree.UnaryExpressionBitwiseNot | TSESTree.UnaryExpressionDelete | TSESTree.UnaryExpressionMinus | TSESTree.UnaryExpressionNot | TSESTree.UnaryExpressionPlus | TSESTree.UnaryExpressionTypeof | TSESTree.UnaryExpressionVoid | TSESTree.UpdateExpression | TSESTree.YieldExpression | TSESTree.PrivateIdentifier | null;
 /**
  * Identifies the initialization path of a function node in the AST.
  *
@@ -614,6 +614,113 @@ declare namespace getHookCollector {
  */
 declare function getHookCollector(context: RuleContext): getHookCollector.ReturnType;
 //#endregion
+//#region src/jsx.d.ts
+/**
+ * BitFlags for configuring JSX detection behavior.
+ *
+ * Used by {@link isJsxLike} to control which AST node kinds are
+ * considered "JSX-like". Combine flags with the `|` operator.
+ *
+ * @example
+ * ```ts
+ * const hint = JsxDetectionHint.DoNotIncludeJsxWithBooleanValue
+ *   | JsxDetectionHint.DoNotIncludeJsxWithStringValue;
+ *
+ * isJsxLike(context, node, hint);
+ * ```
+ */
+type JsxDetectionHint = bigint;
+declare const JsxDetectionHint: {
+  readonly None: 0n;
+  readonly DoNotIncludeJsxWithNullValue: bigint;
+  readonly DoNotIncludeJsxWithNumberValue: bigint;
+  readonly DoNotIncludeJsxWithBigIntValue: bigint;
+  readonly DoNotIncludeJsxWithStringValue: bigint;
+  readonly DoNotIncludeJsxWithBooleanValue: bigint;
+  readonly DoNotIncludeJsxWithUndefinedValue: bigint;
+  readonly DoNotIncludeJsxWithEmptyArrayValue: bigint;
+  readonly DoNotIncludeJsxWithCreateElementValue: bigint;
+  readonly RequireAllArrayElementsToBeJsx: bigint;
+  readonly RequireBothSidesOfLogicalExpressionToBeJsx: bigint;
+  readonly RequireBothBranchesOfConditionalExpressionToBeJsx: bigint;
+};
+/**
+ * Default JSX detection configuration.
+ *
+ * Skips number, bigint, boolean, string, and undefined literals –
+ * the value types that are commonly returned alongside JSX in React
+ * components but are not themselves renderable elements.
+ */
+declare const DEFAULT_JSX_DETECTION_HINT: JsxDetectionHint;
+/**
+ * Determine whether a node represents JSX-like content based on heuristics.
+ *
+ * The detection behaviour is configurable through {@link JsxDetectionHint}
+ * bit-flags so that callers can opt individual value kinds in or out.
+ *
+ * @param context - The ESLint rule context (needed for variable resolution).
+ * @param node    - The AST node to analyse.
+ * @param hint    - Optional bit-flags to adjust detection behaviour.
+ *                  Defaults to {@link DEFAULT_JSX_DETECTION_HINT}.
+ * @returns Whether the node is considered JSX-like.
+ *
+ * @example
+ * ```ts
+ * import { isJsxLike } from "@eslint-react/core";
+ *
+ * if (isJsxLike(context, node)) {
+ *   // node looks like it evaluates to a React element
+ * }
+ * ```
+ */
+declare function isJsxLike(context: RuleContext, node: TSESTree.Node | null, hint?: JsxDetectionHint): boolean;
+//#endregion
+//#region src/jsx-config.d.ts
+/**
+ * Resolved JSX configuration derived from compiler options and / or pragma
+ * annotations found in the source file.
+ */
+interface JsxConfig {
+  jsx?: number;
+  jsxFactory?: string;
+  jsxFragmentFactory?: string;
+  jsxImportSource?: string;
+}
+/**
+ * Read JSX configuration from the TypeScript compiler options exposed by the
+ * parser services.
+ *
+ * Falls back to sensible React defaults when no compiler options are
+ * available (e.g. when the file is parsed without type information).
+ *
+ * @param context - The ESLint rule context.
+ * @returns Fully‑populated `JsxConfig` derived from compiler options.
+ */
+declare function getJsxConfigFromCompilerOptions(context: RuleContext): Required<JsxConfig>;
+/**
+ * Extract JSX configuration from `@jsx`, `@jsxFrag`, `@jsxRuntime` and
+ * `@jsxImportSource` pragma comments in the source file.
+ *
+ * The result is cached per `sourceCode` instance via a `WeakMap` so that
+ * repeated calls from different rules analysing the same file are free.
+ *
+ * @param context - The ESLint rule context.
+ * @returns Partial `JsxConfig` containing only the values found in pragmas.
+ */
+declare function getJsxConfigFromAnnotation(context: RuleContext): JsxConfig;
+/**
+ * Get the fully‑merged JSX configuration for the current file.
+ *
+ * Compiler options provide the base values; pragma annotations found in the
+ * source override them where present.  The result is cached per `sourceCode`.
+ *
+ * This is the main entry‑point most consumers should use.
+ *
+ * @param context - The ESLint rule context.
+ * @returns Fully‑populated, merged `JsxConfig`.
+ */
+declare function getJsxConfig(context: RuleContext): Required<JsxConfig>;
+//#endregion
 //#region src/type-is.d.ts
 declare function isBooleanLiteralType<TType extends ts.Type>(type: TType): type is TType & {
   intrinsicName: "false" | "true";
@@ -742,4 +849,4 @@ type TypeVariant = "any" | "bigint" | "boolean" | "enum" | "never" | "nullish" |
  */
 declare function getTypeVariants(types: ts.Type[]): Set<TypeVariant>;
 //#endregion
-export { ClassComponentSemanticNode, ClientFunctionSemanticNode, DEFAULT_COMPONENT_DETECTION_HINT, FunctionComponentDetectionHint, FunctionComponentFlag, FunctionComponentSemanticNode, FunctionDisplayNameAssignment, FunctionID, FunctionInitPath, FunctionKind, FunctionSemanticNode, HookSemanticNode, REACT_BUILTIN_HOOK_NAMES, SEL_FUNCTION_DISPLAY_NAME_ASSIGNMENT, SemanticFunc, SemanticNode, ServerFunctionSemanticNode, TypeVariant, getClassComponentCollector, getClassId, getFullyQualifiedNameEx, getFunctionComponentCollector, getFunctionComponentFlagFromInitPath, getFunctionComponentId, getFunctionDirectives, getFunctionId, getFunctionInitPath, getHookCollector, getTypeVariants, isAPI, isAPICall, isAPIFromReact, isAPIFromReactNative, isAnyType, isAssignmentToThisState, isBigIntType, isBooleanLiteralType, isBooleanType, isCaptureOwnerStack, isCaptureOwnerStackCall, isChildrenCount, isChildrenCountCall, isChildrenForEach, isChildrenForEachCall, isChildrenMap, isChildrenMapCall, isChildrenOnly, isChildrenOnlyCall, isChildrenToArray, isChildrenToArrayCall, isClassComponent, isClassComponentLoose, isCloneElement, isCloneElementCall, isComponentDidCatch, isComponentDidMount, isComponentDidUpdate, isComponentWillMount, isComponentWillReceiveProps, isComponentWillUnmount, isComponentWillUpdate, isCreateContext, isCreateContextCall, isCreateElement, isCreateElementCall, isCreateRef, isCreateRefCall, isEnumType, isFalseLiteralType, isFalsyBigIntType, isFalsyNumberType, isFalsyStringType, isForwardRef, isForwardRefCall, isFunctionComponentDefinition, isFunctionComponentName, isFunctionComponentNameLoose, isFunctionComponentWrapperCall, isFunctionComponentWrapperCallback, isFunctionEmpty, isFunctionHasCallInInitPath, isFunctionHasDirective, isFunctionWithLooseComponentName, isGetChildContext, isGetDefaultProps, isGetDerivedStateFromError, isGetDerivedStateFromProps, isGetInitialState, isGetSnapshotBeforeUpdate, isHookCall, isHookDefinition, isHookId, isHookName, isLazy, isLazyCall, isMemo, isMemoCall, isNeverType, isNullishType, isNumberType, isObjectType, isPureComponent, isRender, isRenderMethodCallback, isRenderMethodLike, isShouldComponentUpdate, isStringType, isThisSetStateCall, isTrueLiteralType, isTruthyBigIntType, isTruthyNumberType, isTruthyStringType, isUnknownType, isUnsafeComponentWillMount, isUnsafeComponentWillReceiveProps, isUnsafeComponentWillUpdate, isUse, isUseActionState, isUseActionStateCall, isUseCall, isUseCallback, isUseCallbackCall, isUseContext, isUseContextCall, isUseDebugValue, isUseDebugValueCall, isUseDeferredValue, isUseDeferredValueCall, isUseEffect, isUseEffectCall, isUseEffectCleanupCallback, isUseEffectLikeCall, isUseEffectSetupCallback, isUseFormStatus, isUseFormStatusCall, isUseId, isUseIdCall, isUseImperativeHandle, isUseImperativeHandleCall, isUseInsertionEffect, isUseInsertionEffectCall, isUseLayoutEffect, isUseLayoutEffectCall, isUseMemo, isUseMemoCall, isUseOptimistic, isUseOptimisticCall, isUseReducer, isUseReducerCall, isUseRef, isUseRefCall, isUseState, isUseStateCall, isUseStateLikeCall, isUseSyncExternalStore, isUseSyncExternalStoreCall, isUseTransition, isUseTransitionCall };
+export { ClassComponentSemanticNode, ClientFunctionSemanticNode, DEFAULT_COMPONENT_DETECTION_HINT, DEFAULT_JSX_DETECTION_HINT, FunctionComponentDetectionHint, FunctionComponentFlag, FunctionComponentSemanticNode, FunctionDisplayNameAssignment, FunctionID, FunctionInitPath, FunctionKind, FunctionSemanticNode, HookSemanticNode, JsxConfig, JsxDetectionHint, REACT_BUILTIN_HOOK_NAMES, SEL_FUNCTION_DISPLAY_NAME_ASSIGNMENT, SemanticFunc, SemanticNode, ServerFunctionSemanticNode, TypeVariant, getClassComponentCollector, getClassId, getFullyQualifiedNameEx, getFunctionComponentCollector, getFunctionComponentFlagFromInitPath, getFunctionComponentId, getFunctionDirectives, getFunctionId, getFunctionInitPath, getHookCollector, getJsxConfig, getJsxConfigFromAnnotation, getJsxConfigFromCompilerOptions, getTypeVariants, isAPI, isAPICall, isAPIFromReact, isAPIFromReactNative, isAnyType, isAssignmentToThisState, isBigIntType, isBooleanLiteralType, isBooleanType, isCaptureOwnerStack, isCaptureOwnerStackCall, isChildrenCount, isChildrenCountCall, isChildrenForEach, isChildrenForEachCall, isChildrenMap, isChildrenMapCall, isChildrenOnly, isChildrenOnlyCall, isChildrenToArray, isChildrenToArrayCall, isClassComponent, isClassComponentLoose, isCloneElement, isCloneElementCall, isComponentDidCatch, isComponentDidMount, isComponentDidUpdate, isComponentWillMount, isComponentWillReceiveProps, isComponentWillUnmount, isComponentWillUpdate, isCreateContext, isCreateContextCall, isCreateElement, isCreateElementCall, isCreateRef, isCreateRefCall, isEnumType, isFalseLiteralType, isFalsyBigIntType, isFalsyNumberType, isFalsyStringType, isForwardRef, isForwardRefCall, isFunctionComponentDefinition, isFunctionComponentName, isFunctionComponentNameLoose, isFunctionComponentWrapperCall, isFunctionComponentWrapperCallback, isFunctionEmpty, isFunctionHasCallInInitPath, isFunctionHasDirective, isFunctionWithLooseComponentName, isGetChildContext, isGetDefaultProps, isGetDerivedStateFromError, isGetDerivedStateFromProps, isGetInitialState, isGetSnapshotBeforeUpdate, isHookCall, isHookDefinition, isHookId, isHookName, isJsxLike, isLazy, isLazyCall, isMemo, isMemoCall, isNeverType, isNullishType, isNumberType, isObjectType, isPureComponent, isRender, isRenderMethodCallback, isRenderMethodLike, isShouldComponentUpdate, isStringType, isThisSetStateCall, isTrueLiteralType, isTruthyBigIntType, isTruthyNumberType, isTruthyStringType, isUnknownType, isUnsafeComponentWillMount, isUnsafeComponentWillReceiveProps, isUnsafeComponentWillUpdate, isUse, isUseActionState, isUseActionStateCall, isUseCall, isUseCallback, isUseCallbackCall, isUseContext, isUseContextCall, isUseDebugValue, isUseDebugValueCall, isUseDeferredValue, isUseDeferredValueCall, isUseEffect, isUseEffectCall, isUseEffectCleanupCallback, isUseEffectLikeCall, isUseEffectSetupCallback, isUseFormStatus, isUseFormStatusCall, isUseId, isUseIdCall, isUseImperativeHandle, isUseImperativeHandleCall, isUseInsertionEffect, isUseInsertionEffectCall, isUseLayoutEffect, isUseLayoutEffectCall, isUseMemo, isUseMemoCall, isUseOptimistic, isUseOptimisticCall, isUseReducer, isUseReducerCall, isUseRef, isUseRefCall, isUseState, isUseStateCall, isUseStateLikeCall, isUseSyncExternalStore, isUseSyncExternalStoreCall, isUseTransition, isUseTransitionCall };

package/dist/index.js

@@ -1,11 +1,11 @@
 import { Check, Extract, Traverse, is, isOneOf } from "@eslint-react/ast";
-import { resolveImportSource } from "@eslint-react/var";
+import { resolve, resolveImportSource } from "@eslint-react/var";
 import { AST_NODE_TYPES } from "@typescript-eslint/types";
 import { randomBytes } from "node:crypto";
-import { JsxDetectionHint, isJsxLike } from "@eslint-react/jsx";
-import { RE_COMPONENT_NAME, RE_COMPONENT_NAME_LOOSE } from "@eslint-react/shared";
-import { P, isMatching, match } from "ts-pattern";
+import { JsxDetectionHint as JsxDetectionHint$1 } from "@eslint-react/jsx";
+import { RE_ANNOTATION_JSX, RE_ANNOTATION_JSX_FRAG, RE_ANNOTATION_JSX_IMPORT_SOURCE, RE_ANNOTATION_JSX_RUNTIME, RE_COMPONENT_NAME, RE_COMPONENT_NAME_LOOSE } from "@eslint-react/shared";
 import ts from "typescript";
+import { P, isMatching, match } from "ts-pattern";
 
 //#region ../../.pkgs/eff/dist/index.js
 /**
@@ -648,7 +648,7 @@ function isFunctionWithLooseComponentName(context, fn, allowNone = false) {
 * Hints for component collector
 */
 const FunctionComponentDetectionHint = {
-	...JsxDetectionHint,
+	...JsxDetectionHint$1,
 	DoNotIncludeFunctionDefinedAsClassMethod: 1n << 11n,
 	DoNotIncludeFunctionDefinedAsClassProperty: 1n << 12n,
 	DoNotIncludeFunctionDefinedAsObjectMethod: 1n << 13n,
@@ -848,6 +848,101 @@ function isUseEffectCleanupCallback(node) {
 	return isUseEffectSetupCallback(enclosingFunction);
 }
 
+//#endregion
+//#region src/jsx.ts
+const JsxDetectionHint = {
+	None: 0n,
+	DoNotIncludeJsxWithNullValue: 1n << 0n,
+	DoNotIncludeJsxWithNumberValue: 1n << 1n,
+	DoNotIncludeJsxWithBigIntValue: 1n << 2n,
+	DoNotIncludeJsxWithStringValue: 1n << 3n,
+	DoNotIncludeJsxWithBooleanValue: 1n << 4n,
+	DoNotIncludeJsxWithUndefinedValue: 1n << 5n,
+	DoNotIncludeJsxWithEmptyArrayValue: 1n << 6n,
+	DoNotIncludeJsxWithCreateElementValue: 1n << 7n,
+	RequireAllArrayElementsToBeJsx: 1n << 8n,
+	RequireBothSidesOfLogicalExpressionToBeJsx: 1n << 9n,
+	RequireBothBranchesOfConditionalExpressionToBeJsx: 1n << 10n
+};
+/**
+* Default JSX detection configuration.
+*
+* Skips number, bigint, boolean, string, and undefined literals –
+* the value types that are commonly returned alongside JSX in React
+* components but are not themselves renderable elements.
+*/
+const DEFAULT_JSX_DETECTION_HINT = 0n | JsxDetectionHint.DoNotIncludeJsxWithNumberValue | JsxDetectionHint.DoNotIncludeJsxWithBigIntValue | JsxDetectionHint.DoNotIncludeJsxWithBooleanValue | JsxDetectionHint.DoNotIncludeJsxWithStringValue | JsxDetectionHint.DoNotIncludeJsxWithUndefinedValue;
+/**
+* Determine whether a node represents JSX-like content based on heuristics.
+*
+* The detection behaviour is configurable through {@link JsxDetectionHint}
+* bit-flags so that callers can opt individual value kinds in or out.
+*
+* @param context - The ESLint rule context (needed for variable resolution).
+* @param node    - The AST node to analyse.
+* @param hint    - Optional bit-flags to adjust detection behaviour.
+*                  Defaults to {@link DEFAULT_JSX_DETECTION_HINT}.
+* @returns Whether the node is considered JSX-like.
+*
+* @example
+* ```ts
+* import { isJsxLike } from "@eslint-react/core";
+*
+* if (isJsxLike(context, node)) {
+*   // node looks like it evaluates to a React element
+* }
+* ```
+*/
+function isJsxLike(context, node, hint = DEFAULT_JSX_DETECTION_HINT) {
+	if (node == null) return false;
+	if (Check.isJSX(node)) return true;
+	switch (node.type) {
+		case AST_NODE_TYPES.Literal:
+			switch (typeof node.value) {
+				case "boolean": return !(hint & JsxDetectionHint.DoNotIncludeJsxWithBooleanValue);
+				case "string": return !(hint & JsxDetectionHint.DoNotIncludeJsxWithStringValue);
+				case "number": return !(hint & JsxDetectionHint.DoNotIncludeJsxWithNumberValue);
+				case "bigint": return !(hint & JsxDetectionHint.DoNotIncludeJsxWithBigIntValue);
+			}
+			if (node.value == null) return !(hint & JsxDetectionHint.DoNotIncludeJsxWithNullValue);
+			return false;
+		case AST_NODE_TYPES.TemplateLiteral: return !(hint & JsxDetectionHint.DoNotIncludeJsxWithStringValue);
+		case AST_NODE_TYPES.ArrayExpression:
+			if (node.elements.length === 0) return !(hint & JsxDetectionHint.DoNotIncludeJsxWithEmptyArrayValue);
+			if (hint & JsxDetectionHint.RequireAllArrayElementsToBeJsx) return node.elements.every((n) => isJsxLike(context, n, hint));
+			return node.elements.some((n) => isJsxLike(context, n, hint));
+		case AST_NODE_TYPES.LogicalExpression:
+			if (hint & JsxDetectionHint.RequireBothSidesOfLogicalExpressionToBeJsx) return isJsxLike(context, node.left, hint) && isJsxLike(context, node.right, hint);
+			return isJsxLike(context, node.left, hint) || isJsxLike(context, node.right, hint);
+		case AST_NODE_TYPES.ConditionalExpression: {
+			const consequentIsJsx = Array.isArray(node.consequent) ? checkArray(context, node.consequent, hint) : isJsxLike(context, node.consequent, hint);
+			const alternateIsJsx = isJsxLike(context, node.alternate, hint);
+			if (hint & JsxDetectionHint.RequireBothBranchesOfConditionalExpressionToBeJsx) return consequentIsJsx && alternateIsJsx;
+			return consequentIsJsx || alternateIsJsx;
+		}
+		case AST_NODE_TYPES.SequenceExpression: return isJsxLike(context, node.expressions.at(-1) ?? null, hint);
+		case AST_NODE_TYPES.CallExpression: {
+			if (hint & JsxDetectionHint.DoNotIncludeJsxWithCreateElementValue) return false;
+			const callee = Extract.unwrap(node.callee);
+			switch (callee.type) {
+				case AST_NODE_TYPES.Identifier: return callee.name === "createElement";
+				case AST_NODE_TYPES.MemberExpression: return callee.property.type === AST_NODE_TYPES.Identifier && callee.property.name === "createElement";
+			}
+			return false;
+		}
+		case AST_NODE_TYPES.Identifier:
+			if (node.name === "undefined") return !(hint & JsxDetectionHint.DoNotIncludeJsxWithUndefinedValue);
+			if (Check.isJSXTagNameExpression(node)) return true;
+			return isJsxLike(context, resolve(context, node), hint);
+	}
+	return false;
+}
+function checkArray(context, elements, hint) {
+	if (elements.length === 0) return !(hint & JsxDetectionHint.DoNotIncludeJsxWithEmptyArrayValue);
+	if (hint & JsxDetectionHint.RequireAllArrayElementsToBeJsx) return elements.every((n) => isJsxLike(context, n, hint));
+	return elements.some((n) => isJsxLike(context, n, hint));
+}
+
 //#endregion
 //#region src/function-component-collector.ts
 /**
@@ -1005,6 +1100,91 @@ function getHookCollector(context) {
 	};
 }
 
+//#endregion
+//#region src/jsx-config.ts
+/**
+* Weak‑map cache keyed by `sourceCode` so that the (potentially expensive)
+* pragma‑scanning pass runs at most once per file.
+*/
+const annotationCache = /* @__PURE__ */ new WeakMap();
+/**
+* Weak‑map cache for the fully‑merged config (compiler options + annotation).
+*/
+const mergedCache = /* @__PURE__ */ new WeakMap();
+/**
+* Read JSX configuration from the TypeScript compiler options exposed by the
+* parser services.
+*
+* Falls back to sensible React defaults when no compiler options are
+* available (e.g. when the file is parsed without type information).
+*
+* @param context - The ESLint rule context.
+* @returns Fully‑populated `JsxConfig` derived from compiler options.
+*/
+function getJsxConfigFromCompilerOptions(context) {
+	const options = context.sourceCode.parserServices?.program?.getCompilerOptions() ?? {};
+	return {
+		jsx: options.jsx ?? ts.JsxEmit.ReactJSX,
+		jsxFactory: options.jsxFactory ?? "React.createElement",
+		jsxFragmentFactory: options.jsxFragmentFactory ?? "React.Fragment",
+		jsxImportSource: options.jsxImportSource ?? "react"
+	};
+}
+/**
+* Extract JSX configuration from `@jsx`, `@jsxFrag`, `@jsxRuntime` and
+* `@jsxImportSource` pragma comments in the source file.
+*
+* The result is cached per `sourceCode` instance via a `WeakMap` so that
+* repeated calls from different rules analysing the same file are free.
+*
+* @param context - The ESLint rule context.
+* @returns Partial `JsxConfig` containing only the values found in pragmas.
+*/
+function getJsxConfigFromAnnotation(context) {
+	const cached = annotationCache.get(context.sourceCode);
+	if (cached != null) return cached;
+	const options = {};
+	if (!context.sourceCode.text.includes("@jsx")) {
+		annotationCache.set(context.sourceCode, options);
+		return options;
+	}
+	let jsx, jsxFrag, jsxRuntime, jsxImportSource;
+	for (const comment of context.sourceCode.getAllComments().reverse()) {
+		const value = comment.value;
+		jsx ??= value.match(RE_ANNOTATION_JSX)?.[1];
+		jsxFrag ??= value.match(RE_ANNOTATION_JSX_FRAG)?.[1];
+		jsxRuntime ??= value.match(RE_ANNOTATION_JSX_RUNTIME)?.[1];
+		jsxImportSource ??= value.match(RE_ANNOTATION_JSX_IMPORT_SOURCE)?.[1];
+	}
+	if (jsx != null) options.jsxFactory = jsx;
+	if (jsxFrag != null) options.jsxFragmentFactory = jsxFrag;
+	if (jsxRuntime != null) options.jsx = jsxRuntime === "classic" ? ts.JsxEmit.React : ts.JsxEmit.ReactJSX;
+	if (jsxImportSource != null) options.jsxImportSource = jsxImportSource;
+	annotationCache.set(context.sourceCode, options);
+	return options;
+}
+/**
+* Get the fully‑merged JSX configuration for the current file.
+*
+* Compiler options provide the base values; pragma annotations found in the
+* source override them where present.  The result is cached per `sourceCode`.
+*
+* This is the main entry‑point most consumers should use.
+*
+* @param context - The ESLint rule context.
+* @returns Fully‑populated, merged `JsxConfig`.
+*/
+function getJsxConfig(context) {
+	const cached = mergedCache.get(context.sourceCode);
+	if (cached != null) return cached;
+	const merged = {
+		...getJsxConfigFromCompilerOptions(context),
+		...getJsxConfigFromAnnotation(context)
+	};
+	mergedCache.set(context.sourceCode, merged);
+	return merged;
+}
+
 //#endregion
 //#region src/type-is.ts
 function isFlagSet(allFlags, flag) {
@@ -1152,4 +1332,4 @@ function getTypeVariants(types) {
 }
 
 //#endregion
-export { DEFAULT_COMPONENT_DETECTION_HINT, FunctionComponentDetectionHint, FunctionComponentFlag, REACT_BUILTIN_HOOK_NAMES, SEL_FUNCTION_DISPLAY_NAME_ASSIGNMENT, getClassComponentCollector, getClassId, getFullyQualifiedNameEx, getFunctionComponentCollector, getFunctionComponentFlagFromInitPath, getFunctionComponentId, getFunctionDirectives, getFunctionId, getFunctionInitPath, getHookCollector, getTypeVariants, isAPI, isAPICall, isAPIFromReact, isAPIFromReactNative, isAnyType, isAssignmentToThisState, isBigIntType, isBooleanLiteralType, isBooleanType, isCaptureOwnerStack, isCaptureOwnerStackCall, isChildrenCount, isChildrenCountCall, isChildrenForEach, isChildrenForEachCall, isChildrenMap, isChildrenMapCall, isChildrenOnly, isChildrenOnlyCall, isChildrenToArray, isChildrenToArrayCall, isClassComponent, isClassComponentLoose, isCloneElement, isCloneElementCall, isComponentDidCatch, isComponentDidMount, isComponentDidUpdate, isComponentWillMount, isComponentWillReceiveProps, isComponentWillUnmount, isComponentWillUpdate, isCreateContext, isCreateContextCall, isCreateElement, isCreateElementCall, isCreateRef, isCreateRefCall, isEnumType, isFalseLiteralType, isFalsyBigIntType, isFalsyNumberType, isFalsyStringType, isForwardRef, isForwardRefCall, isFunctionComponentDefinition, isFunctionComponentName, isFunctionComponentNameLoose, isFunctionComponentWrapperCall, isFunctionComponentWrapperCallback, isFunctionEmpty, isFunctionHasCallInInitPath, isFunctionHasDirective, isFunctionWithLooseComponentName, isGetChildContext, isGetDefaultProps, isGetDerivedStateFromError, isGetDerivedStateFromProps, isGetInitialState, isGetSnapshotBeforeUpdate, isHookCall, isHookDefinition, isHookId, isHookName, isLazy, isLazyCall, isMemo, isMemoCall, isNeverType, isNullishType, isNumberType, isObjectType, isPureComponent, isRender, isRenderMethodCallback, isRenderMethodLike, isShouldComponentUpdate, isStringType, isThisSetStateCall, isTrueLiteralType, isTruthyBigIntType, isTruthyNumberType, isTruthyStringType, isUnknownType, isUnsafeComponentWillMount, isUnsafeComponentWillReceiveProps, isUnsafeComponentWillUpdate, isUse, isUseActionState, isUseActionStateCall, isUseCall, isUseCallback, isUseCallbackCall, isUseContext, isUseContextCall, isUseDebugValue, isUseDebugValueCall, isUseDeferredValue, isUseDeferredValueCall, isUseEffect, isUseEffectCall, isUseEffectCleanupCallback, isUseEffectLikeCall, isUseEffectSetupCallback, isUseFormStatus, isUseFormStatusCall, isUseId, isUseIdCall, isUseImperativeHandle, isUseImperativeHandleCall, isUseInsertionEffect, isUseInsertionEffectCall, isUseLayoutEffect, isUseLayoutEffectCall, isUseMemo, isUseMemoCall, isUseOptimistic, isUseOptimisticCall, isUseReducer, isUseReducerCall, isUseRef, isUseRefCall, isUseState, isUseStateCall, isUseStateLikeCall, isUseSyncExternalStore, isUseSyncExternalStoreCall, isUseTransition, isUseTransitionCall };
+export { DEFAULT_COMPONENT_DETECTION_HINT, DEFAULT_JSX_DETECTION_HINT, FunctionComponentDetectionHint, FunctionComponentFlag, JsxDetectionHint, REACT_BUILTIN_HOOK_NAMES, SEL_FUNCTION_DISPLAY_NAME_ASSIGNMENT, getClassComponentCollector, getClassId, getFullyQualifiedNameEx, getFunctionComponentCollector, getFunctionComponentFlagFromInitPath, getFunctionComponentId, getFunctionDirectives, getFunctionId, getFunctionInitPath, getHookCollector, getJsxConfig, getJsxConfigFromAnnotation, getJsxConfigFromCompilerOptions, getTypeVariants, isAPI, isAPICall, isAPIFromReact, isAPIFromReactNative, isAnyType, isAssignmentToThisState, isBigIntType, isBooleanLiteralType, isBooleanType, isCaptureOwnerStack, isCaptureOwnerStackCall, isChildrenCount, isChildrenCountCall, isChildrenForEach, isChildrenForEachCall, isChildrenMap, isChildrenMapCall, isChildrenOnly, isChildrenOnlyCall, isChildrenToArray, isChildrenToArrayCall, isClassComponent, isClassComponentLoose, isCloneElement, isCloneElementCall, isComponentDidCatch, isComponentDidMount, isComponentDidUpdate, isComponentWillMount, isComponentWillReceiveProps, isComponentWillUnmount, isComponentWillUpdate, isCreateContext, isCreateContextCall, isCreateElement, isCreateElementCall, isCreateRef, isCreateRefCall, isEnumType, isFalseLiteralType, isFalsyBigIntType, isFalsyNumberType, isFalsyStringType, isForwardRef, isForwardRefCall, isFunctionComponentDefinition, isFunctionComponentName, isFunctionComponentNameLoose, isFunctionComponentWrapperCall, isFunctionComponentWrapperCallback, isFunctionEmpty, isFunctionHasCallInInitPath, isFunctionHasDirective, isFunctionWithLooseComponentName, isGetChildContext, isGetDefaultProps, isGetDerivedStateFromError, isGetDerivedStateFromProps, isGetInitialState, isGetSnapshotBeforeUpdate, isHookCall, isHookDefinition, isHookId, isHookName, isJsxLike, isLazy, isLazyCall, isMemo, isMemoCall, isNeverType, isNullishType, isNumberType, isObjectType, isPureComponent, isRender, isRenderMethodCallback, isRenderMethodLike, isShouldComponentUpdate, isStringType, isThisSetStateCall, isTrueLiteralType, isTruthyBigIntType, isTruthyNumberType, isTruthyStringType, isUnknownType, isUnsafeComponentWillMount, isUnsafeComponentWillReceiveProps, isUnsafeComponentWillUpdate, isUse, isUseActionState, isUseActionStateCall, isUseCall, isUseCallback, isUseCallbackCall, isUseContext, isUseContextCall, isUseDebugValue, isUseDebugValueCall, isUseDeferredValue, isUseDeferredValueCall, isUseEffect, isUseEffectCall, isUseEffectCleanupCallback, isUseEffectLikeCall, isUseEffectSetupCallback, isUseFormStatus, isUseFormStatusCall, isUseId, isUseIdCall, isUseImperativeHandle, isUseImperativeHandleCall, isUseInsertionEffect, isUseInsertionEffectCall, isUseLayoutEffect, isUseLayoutEffectCall, isUseMemo, isUseMemoCall, isUseOptimistic, isUseOptimisticCall, isUseReducer, isUseReducerCall, isUseRef, isUseRefCall, isUseState, isUseStateCall, isUseStateLikeCall, isUseSyncExternalStore, isUseSyncExternalStoreCall, isUseTransition, isUseTransitionCall };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/core",
-  "version": "5.6.2",
+  "version": "5.6.3-next.0",
   "description": "ESLint React's ESLint utility module for static analysis of React core APIs and patterns.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -33,11 +33,11 @@
     "@typescript-eslint/types": "^8.59.1",
     "@typescript-eslint/utils": "^8.59.1",
     "ts-pattern": "^5.9.0",
-    "@eslint-react/ast": "5.6.2",
-    "@eslint-react/eslint": "5.6.2",
-    "@eslint-react/jsx": "5.6.2",
-    "@eslint-react/shared": "5.6.2",
-    "@eslint-react/var": "5.6.2"
+    "@eslint-react/ast": "5.6.3-next.0",
+    "@eslint-react/jsx": "5.6.3-next.0",
+    "@eslint-react/shared": "5.6.3-next.0",
+    "@eslint-react/var": "5.6.3-next.0",
+    "@eslint-react/eslint": "5.6.3-next.0"
   },
   "devDependencies": {
     "@typescript-eslint/parser": "^8.59.1",