@eslint-react/jsx 5.6.2 → 5.6.3-beta.0

package/dist/index.d.ts

@@ -472,82 +472,6 @@ declare function isFragmentElement(node: TSESTree.Node, jsxFragmentFactory?: str
  */
 declare function isHostElement(node: TSESTree.Node): node is TSESTree.JSXElement;
 //#endregion
-//#region src/jsx-detection-hint.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;
-//#endregion
-//#region src/is-jsx-like.d.ts
-/**
- * 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/jsx";
- *
- * 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/is-jsx-text.d.ts
-/**
- * Check whether a node is a JSX text node.
- *
- * Returns `true` for both `JSXText` nodes and `Literal` nodes that appear
- * as direct children of a JSX element (the parser may represent inline text
- * with either node type depending on context).
- *
- * @param node - The AST node to test.
- * @returns `true` when `node` is a `JSXText` or `Literal`.
- */
-declare function isJsxText(node: TSESTree.Node | null): node is TSESTree.JSXText | TSESTree.Literal;
-//#endregion
 //#region src/is-whitespace.d.ts
 /**
  * Check whether a JSX child node is **whitespace padding** that React would
@@ -592,65 +516,44 @@ declare function isWhitespace(node: TSESTree.JSXChild): boolean;
  */
 declare function isWhitespaceText(node: TSESTree.JSXChild): boolean;
 //#endregion
-//#region src/jsx-config.d.ts
-/**
- * TypeScript `jsx` compiler option values.
- *
- * Mirrors `ts.JsxEmit` so that consumers do not need a direct dependency on
- * the TypeScript compiler.
- */
-declare const JsxEmit: {
-  readonly None: 0;
-  readonly Preserve: 1;
-  readonly React: 2;
-  readonly ReactNative: 3;
-  readonly ReactJSX: 4;
-  readonly ReactJSXDev: 5;
-};
-/**
- * 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;
-}
+//#region src/jsx-detection-hint.d.ts
 /**
- * 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).
+ * BitFlags for configuring JSX detection behavior.
  *
- * @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.
+ * Used by {@link isJsxLike} to control which AST node kinds are
+ * considered "JSX-like". Combine flags with the `|` operator.
  *
- * The result is cached per `sourceCode` instance via a `WeakMap` so that
- * repeated calls from different rules analysing the same file are free.
+ * @example
+ * ```ts
+ * const hint = JsxDetectionHint.DoNotIncludeJsxWithBooleanValue
+ *   | JsxDetectionHint.DoNotIncludeJsxWithStringValue;
  *
- * @param context - The ESLint rule context.
- * @returns Partial `JsxConfig` containing only the values found in pragmas.
+ * isJsxLike(context, node, hint);
+ * ```
  */
-declare function getJsxConfigFromAnnotation(context: RuleContext): JsxConfig;
+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;
+};
 /**
- * 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.
+ * Default JSX detection configuration.
  *
- * @param context - The ESLint rule context.
- * @returns Fully‑populated, merged `JsxConfig`.
+ * 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 function getJsxConfig(context: RuleContext): Required<JsxConfig>;
+declare const DEFAULT_JSX_DETECTION_HINT: JsxDetectionHint;
 //#endregion
 //#region src/resolve-attribute-value.d.ts
 /**
@@ -680,4 +583,4 @@ declare function getJsxConfig(context: RuleContext): Required<JsxConfig>;
  */
 declare function resolveAttributeValue(context: RuleContext, attribute: TSESTreeJSXAttributeLike): JsxAttributeValue;
 //#endregion
-export { DEFAULT_JSX_DETECTION_HINT, ElementTest, JsxAttributeValue, JsxConfig, JsxDetectionHint, JsxEmit, findAttribute, findParentAttribute, getAttributeName, getAttributeStaticValue, getAttributeValue, getChildren, getElementFullType, getElementSelfType, getJsxConfig, getJsxConfigFromAnnotation, getJsxConfigFromCompilerOptions, hasAnyAttribute, hasAttribute, hasChildren, hasEveryAttribute, isElement, isFragmentElement, isHostElement, isJsxLike, isJsxText, isWhitespace, isWhitespaceText, resolveAttributeValue };
+export { DEFAULT_JSX_DETECTION_HINT, ElementTest, JsxAttributeValue, JsxDetectionHint, findAttribute, findParentAttribute, getAttributeName, getAttributeStaticValue, getAttributeValue, getChildren, getElementFullType, getElementSelfType, hasAnyAttribute, hasAttribute, hasChildren, hasEveryAttribute, isElement, isFragmentElement, isHostElement, isWhitespace, isWhitespaceText, resolveAttributeValue };

package/dist/index.js

@@ -1,9 +1,8 @@
-import { Check, Extract, Traverse } from "@eslint-react/ast";
+import { Extract, Traverse } from "@eslint-react/ast";
 import { resolve } from "@eslint-react/var";
 import { AST_NODE_TYPES } from "@typescript-eslint/types";
 import { getStaticValue } from "@typescript-eslint/utils/ast-utils";
 import { P, match } from "ts-pattern";
-import { RE_ANNOTATION_JSX, RE_ANNOTATION_JSX_FRAG, RE_ANNOTATION_JSX_IMPORT_SOURCE, RE_ANNOTATION_JSX_RUNTIME } from "@eslint-react/shared";
 
 //#region src/get-attribute-name.ts
 /**
@@ -615,121 +614,6 @@ function isHostElement(node) {
 	return node.type === AST_NODE_TYPES.JSXElement && node.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier && /^[a-z]/u.test(node.openingElement.name.name);
 }
 
-//#endregion
-//#region src/jsx-detection-hint.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;
-
-//#endregion
-//#region src/is-jsx-like.ts
-/**
-* 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/jsx";
-*
-* 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/is-jsx-text.ts
-/**
-* Check whether a node is a JSX text node.
-*
-* Returns `true` for both `JSXText` nodes and `Literal` nodes that appear
-* as direct children of a JSX element (the parser may represent inline text
-* with either node type depending on context).
-*
-* @param node - The AST node to test.
-* @returns `true` when `node` is a `JSXText` or `Literal`.
-*/
-function isJsxText(node) {
-	if (node == null) return false;
-	return node.type === AST_NODE_TYPES.JSXText || node.type === AST_NODE_TYPES.Literal;
-}
-
 //#endregion
 //#region src/is-whitespace.ts
 /**
@@ -782,103 +666,29 @@ function isWhitespaceText(node) {
 }
 
 //#endregion
-//#region src/jsx-config.ts
-/**
-* TypeScript `jsx` compiler option values.
-*
-* Mirrors `ts.JsxEmit` so that consumers do not need a direct dependency on
-* the TypeScript compiler.
-*/
-const JsxEmit = {
-	None: 0,
-	Preserve: 1,
-	React: 2,
-	ReactNative: 3,
-	ReactJSX: 4,
-	ReactJSXDev: 5
+//#region src/jsx-detection-hint.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
 };
 /**
-* 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 ?? 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" ? JsxEmit.React : 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.
+* Default JSX detection configuration.
 *
-* @param context - The ESLint rule context.
-* @returns Fully‑populated, merged `JsxConfig`.
+* 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.
 */
-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;
-}
+const DEFAULT_JSX_DETECTION_HINT = 0n | JsxDetectionHint.DoNotIncludeJsxWithNumberValue | JsxDetectionHint.DoNotIncludeJsxWithBigIntValue | JsxDetectionHint.DoNotIncludeJsxWithBooleanValue | JsxDetectionHint.DoNotIncludeJsxWithStringValue | JsxDetectionHint.DoNotIncludeJsxWithUndefinedValue;
 
 //#endregion
-export { DEFAULT_JSX_DETECTION_HINT, JsxDetectionHint, JsxEmit, findAttribute, findParentAttribute, getAttributeName, getAttributeStaticValue, getAttributeValue, getChildren, getElementFullType, getElementSelfType, getJsxConfig, getJsxConfigFromAnnotation, getJsxConfigFromCompilerOptions, hasAnyAttribute, hasAttribute, hasChildren, hasEveryAttribute, isElement, isFragmentElement, isHostElement, isJsxLike, isJsxText, isWhitespace, isWhitespaceText, resolveAttributeValue };
+export { DEFAULT_JSX_DETECTION_HINT, JsxDetectionHint, findAttribute, findParentAttribute, getAttributeName, getAttributeStaticValue, getAttributeValue, getChildren, getElementFullType, getElementSelfType, hasAnyAttribute, hasAttribute, hasChildren, hasEveryAttribute, isElement, isFragmentElement, isHostElement, isWhitespace, isWhitespaceText, resolveAttributeValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/jsx",
-  "version": "5.6.2",
+  "version": "5.6.3-beta.0",
   "description": "ESLint React's TSESTree JSX utility module for static analysis of JSX patterns.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -32,10 +32,10 @@
     "@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/var": "5.6.2",
-    "@eslint-react/eslint": "5.6.2",
-    "@eslint-react/shared": "5.6.2"
+    "@eslint-react/ast": "5.6.3-beta.0",
+    "@eslint-react/eslint": "5.6.3-beta.0",
+    "@eslint-react/var": "5.6.3-beta.0",
+    "@eslint-react/shared": "5.6.3-beta.0"
   },
   "devDependencies": {
     "eslint": "^10.2.1",