@eslint-react/jsx 1.24.0-next.14 → 1.24.0-next.15

package/dist/index.d.mts

@@ -15,11 +15,11 @@ declare function findParentAttribute(node: TSESTree.Node, test?: (node: TSESTree
 /**
  * Get the JSX attribute node with the given name
  * @param name The name of the attribute
- * @param initialScope The initial scope to use for variable resolution
  * @param attributes The attributes to search
+ * @param initialScope The initial scope to use for variable resolution
  * @returns The JSX attribute node or undefined
  */
-declare function getAttribute(name: string, initialScope: Scope, attributes: (TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute)[]): TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute | _;
+declare function getAttribute(name: string, attributes: (TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute)[], initialScope?: Scope): TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute | _;
 
 /**
  * Get the stringified name of a JSX attribute
@@ -46,23 +46,9 @@ declare function getAttributeValue(node: TSESTree$1.JSXAttribute | TSESTree$1.JS
  */
 declare function getElementName(node: TSESTree.JSXElement | TSESTree.JSXFragment): string;
 
-declare function hasAttribute(name: string, initialScope: Scope, attributes: TSESTree.JSXOpeningElement["attributes"]): boolean;
-declare function hasAnyAttribute(names: string[], initialScope: Scope, attributes: TSESTree.JSXOpeningElement["attributes"]): boolean;
-declare function hasEveryAttribute(names: string[], initialScope: Scope, attributes: TSESTree.JSXOpeningElement["attributes"]): boolean;
-
-declare function isKeyedElement(node: TSESTree.Node, initialScope: Scope): boolean;
-/**
- * Check if a node is a `JSXFragment` of `Built-in Component` type
- * @param node The AST node to check
- * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
- */
-declare function isBuiltInElement(node: TSESTree.Node): boolean;
-/**
- * Check if a node is a `JSXElement` of `User-Defined Component` type
- * @param node The AST node to check
- * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
- */
-declare function isUserDefinedElement(node: TSESTree.Node): boolean;
+declare function hasAttribute(name: string, attributes: TSESTree.JSXOpeningElement["attributes"], initialScope?: Scope): boolean;
+declare function hasAnyAttribute(names: string[], attributes: TSESTree.JSXOpeningElement["attributes"], initialScope?: Scope): boolean;
+declare function hasEveryAttribute(names: string[], attributes: TSESTree.JSXOpeningElement["attributes"], initialScope?: Scope): boolean;
 
 declare const JSXValueHint: {
     readonly None: 0n;
@@ -91,6 +77,32 @@ declare function isJSXValue(node: TSESTree$1.Node | _ | null, jsxCtx: {
     getScope: (node: TSESTree$1.Node) => Scope;
 }, hint?: bigint): boolean;
 
+/**
+ * Check if a node is a Fragment element
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `Fragment` type
+ */
+declare function isFragmentElement(node: TSESTree.Node): boolean;
+/**
+ * Check if a node has a `key` prop
+ * @param node The AST node to check
+ * @param initialScope The initial scope to start searching for the `key` attribute
+ * @returns `true` if the node is a `JSXElement` of `Keyed Component` type
+ */
+declare function isKeyedElement(node: TSESTree.Node, initialScope?: Scope): boolean;
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */
+declare function isBuiltInElement(node: TSESTree.Node): boolean;
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */
+declare function isUserDefinedElement(node: TSESTree.Node): boolean;
+
 /**
  * Check if a node is a Literal or JSXText
  * @param node The AST node to check
@@ -123,4 +135,4 @@ declare function isPaddingSpaces(node: TSESTree.Node): boolean;
  */
 declare function toString(node: TSESTree$1.JSXIdentifier | TSESTree$1.JSXMemberExpression | TSESTree$1.JSXNamespacedName | TSESTree$1.JSXOpeningElement | TSESTree$1.JSXClosingElement | TSESTree$1.JSXOpeningFragment | TSESTree$1.JSXClosingFragment | TSESTree$1.JSXText): string;
 
-export { DEFAULT_JSX_VALUE_HINT, JSXValueHint, findParentAttribute, getAttribute, getAttributeName, getAttributeValue, getElementName, hasAnyAttribute, hasAttribute, hasEveryAttribute, isBuiltInElement, isJSXValue, isKeyedElement, isLineBreak, isLiteral, isPaddingSpaces, isUserDefinedElement, isWhiteSpace, toString };
+export { DEFAULT_JSX_VALUE_HINT, JSXValueHint, findParentAttribute, getAttribute, getAttributeName, getAttributeValue, getElementName, hasAnyAttribute, hasAttribute, hasEveryAttribute, isBuiltInElement, isFragmentElement, isJSXValue, isKeyedElement, isLineBreak, isLiteral, isPaddingSpaces, isUserDefinedElement, isWhiteSpace, toString };

package/dist/index.d.ts

@@ -15,11 +15,11 @@ declare function findParentAttribute(node: TSESTree.Node, test?: (node: TSESTree
 /**
  * Get the JSX attribute node with the given name
  * @param name The name of the attribute
- * @param initialScope The initial scope to use for variable resolution
  * @param attributes The attributes to search
+ * @param initialScope The initial scope to use for variable resolution
  * @returns The JSX attribute node or undefined
  */
-declare function getAttribute(name: string, initialScope: Scope, attributes: (TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute)[]): TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute | _;
+declare function getAttribute(name: string, attributes: (TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute)[], initialScope?: Scope): TSESTree$1.JSXAttribute | TSESTree$1.JSXSpreadAttribute | _;
 
 /**
  * Get the stringified name of a JSX attribute
@@ -46,23 +46,9 @@ declare function getAttributeValue(node: TSESTree$1.JSXAttribute | TSESTree$1.JS
  */
 declare function getElementName(node: TSESTree.JSXElement | TSESTree.JSXFragment): string;
 
-declare function hasAttribute(name: string, initialScope: Scope, attributes: TSESTree.JSXOpeningElement["attributes"]): boolean;
-declare function hasAnyAttribute(names: string[], initialScope: Scope, attributes: TSESTree.JSXOpeningElement["attributes"]): boolean;
-declare function hasEveryAttribute(names: string[], initialScope: Scope, attributes: TSESTree.JSXOpeningElement["attributes"]): boolean;
-
-declare function isKeyedElement(node: TSESTree.Node, initialScope: Scope): boolean;
-/**
- * Check if a node is a `JSXFragment` of `Built-in Component` type
- * @param node The AST node to check
- * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
- */
-declare function isBuiltInElement(node: TSESTree.Node): boolean;
-/**
- * Check if a node is a `JSXElement` of `User-Defined Component` type
- * @param node The AST node to check
- * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
- */
-declare function isUserDefinedElement(node: TSESTree.Node): boolean;
+declare function hasAttribute(name: string, attributes: TSESTree.JSXOpeningElement["attributes"], initialScope?: Scope): boolean;
+declare function hasAnyAttribute(names: string[], attributes: TSESTree.JSXOpeningElement["attributes"], initialScope?: Scope): boolean;
+declare function hasEveryAttribute(names: string[], attributes: TSESTree.JSXOpeningElement["attributes"], initialScope?: Scope): boolean;
 
 declare const JSXValueHint: {
     readonly None: 0n;
@@ -91,6 +77,32 @@ declare function isJSXValue(node: TSESTree$1.Node | _ | null, jsxCtx: {
     getScope: (node: TSESTree$1.Node) => Scope;
 }, hint?: bigint): boolean;
 
+/**
+ * Check if a node is a Fragment element
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `Fragment` type
+ */
+declare function isFragmentElement(node: TSESTree.Node): boolean;
+/**
+ * Check if a node has a `key` prop
+ * @param node The AST node to check
+ * @param initialScope The initial scope to start searching for the `key` attribute
+ * @returns `true` if the node is a `JSXElement` of `Keyed Component` type
+ */
+declare function isKeyedElement(node: TSESTree.Node, initialScope?: Scope): boolean;
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */
+declare function isBuiltInElement(node: TSESTree.Node): boolean;
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */
+declare function isUserDefinedElement(node: TSESTree.Node): boolean;
+
 /**
  * Check if a node is a Literal or JSXText
  * @param node The AST node to check
@@ -123,4 +135,4 @@ declare function isPaddingSpaces(node: TSESTree.Node): boolean;
  */
 declare function toString(node: TSESTree$1.JSXIdentifier | TSESTree$1.JSXMemberExpression | TSESTree$1.JSXNamespacedName | TSESTree$1.JSXOpeningElement | TSESTree$1.JSXClosingElement | TSESTree$1.JSXOpeningFragment | TSESTree$1.JSXClosingFragment | TSESTree$1.JSXText): string;
 
-export { DEFAULT_JSX_VALUE_HINT, JSXValueHint, findParentAttribute, getAttribute, getAttributeName, getAttributeValue, getElementName, hasAnyAttribute, hasAttribute, hasEveryAttribute, isBuiltInElement, isJSXValue, isKeyedElement, isLineBreak, isLiteral, isPaddingSpaces, isUserDefinedElement, isWhiteSpace, toString };
+export { DEFAULT_JSX_VALUE_HINT, JSXValueHint, findParentAttribute, getAttribute, getAttributeName, getAttributeValue, getElementName, hasAnyAttribute, hasAttribute, hasEveryAttribute, isBuiltInElement, isFragmentElement, isJSXValue, isKeyedElement, isLineBreak, isLiteral, isPaddingSpaces, isUserDefinedElement, isWhiteSpace, toString };

package/dist/index.js

@@ -61,11 +61,12 @@ function getAttributeName(node) {
 }
 
 // src/get-attribute.ts
-function getAttribute(name, initialScope, attributes) {
+function getAttribute(name, attributes, initialScope) {
   return attributes.findLast((attr) => {
     if (attr.type === types.AST_NODE_TYPES.JSXAttribute) {
       return getAttributeName(attr) === name;
     }
+    if (initialScope == null) return false;
     switch (attr.argument.type) {
       case types.AST_NODE_TYPES.Identifier: {
         const variable = VAR__namespace.findVariable(attr.argument.name, initialScope);
@@ -128,23 +129,14 @@ function getElementName(node) {
 }
 
 // src/has-attribute.ts
-function hasAttribute(name, initialScope, attributes) {
-  return getAttribute(name, initialScope, attributes) != null;
+function hasAttribute(name, attributes, initialScope) {
+  return getAttribute(name, attributes, initialScope) != null;
 }
-function hasAnyAttribute(names, initialScope, attributes) {
-  return names.some((n) => hasAttribute(n, initialScope, attributes));
+function hasAnyAttribute(names, attributes, initialScope) {
+  return names.some((n) => hasAttribute(n, attributes, initialScope));
 }
-function hasEveryAttribute(names, initialScope, attributes) {
-  return names.every((n) => hasAttribute(n, initialScope, attributes));
-}
-function isKeyedElement(node, initialScope) {
-  return node.type === types.AST_NODE_TYPES.JSXElement && hasAttribute("key", initialScope, node.openingElement.attributes);
-}
-function isBuiltInElement(node) {
-  return node.type === types.AST_NODE_TYPES.JSXElement && node.openingElement.name.type === types.AST_NODE_TYPES.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
-}
-function isUserDefinedElement(node) {
-  return node.type === types.AST_NODE_TYPES.JSXElement && node.openingElement.name.type === types.AST_NODE_TYPES.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+function hasEveryAttribute(names, attributes, initialScope) {
+  return names.every((n) => hasAttribute(n, attributes, initialScope));
 }
 var JSXValueHint = {
   None: 0n,
@@ -251,6 +243,19 @@ function isJSXValue(node, jsxCtx, hint = DEFAULT_JSX_VALUE_HINT) {
   }
   return false;
 }
+function isFragmentElement(node) {
+  if (node.type !== types.AST_NODE_TYPES.JSXElement) return false;
+  return getElementName(node).split(".").at(-1) === "Fragment";
+}
+function isKeyedElement(node, initialScope) {
+  return node.type === types.AST_NODE_TYPES.JSXElement && hasAttribute("key", node.openingElement.attributes, initialScope);
+}
+function isBuiltInElement(node) {
+  return node.type === types.AST_NODE_TYPES.JSXElement && node.openingElement.name.type === types.AST_NODE_TYPES.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
+}
+function isUserDefinedElement(node) {
+  return node.type === types.AST_NODE_TYPES.JSXElement && node.openingElement.name.type === types.AST_NODE_TYPES.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+}
 var isLiteral = AST3__namespace.isOneOf([types.AST_NODE_TYPES.Literal, types.AST_NODE_TYPES.JSXText]);
 function isWhiteSpace(node) {
   return typeof node.value === "string" && node.value.trim() === "";
@@ -273,6 +278,7 @@ exports.hasAnyAttribute = hasAnyAttribute;
 exports.hasAttribute = hasAttribute;
 exports.hasEveryAttribute = hasEveryAttribute;
 exports.isBuiltInElement = isBuiltInElement;
+exports.isFragmentElement = isFragmentElement;
 exports.isJSXValue = isJSXValue;
 exports.isKeyedElement = isKeyedElement;
 exports.isLineBreak = isLineBreak;

package/dist/index.mjs

@@ -38,11 +38,12 @@ function getAttributeName(node) {
 }
 
 // src/get-attribute.ts
-function getAttribute(name, initialScope, attributes) {
+function getAttribute(name, attributes, initialScope) {
   return attributes.findLast((attr) => {
     if (attr.type === AST_NODE_TYPES.JSXAttribute) {
       return getAttributeName(attr) === name;
     }
+    if (initialScope == null) return false;
     switch (attr.argument.type) {
       case AST_NODE_TYPES.Identifier: {
         const variable = VAR.findVariable(attr.argument.name, initialScope);
@@ -105,23 +106,14 @@ function getElementName(node) {
 }
 
 // src/has-attribute.ts
-function hasAttribute(name, initialScope, attributes) {
-  return getAttribute(name, initialScope, attributes) != null;
+function hasAttribute(name, attributes, initialScope) {
+  return getAttribute(name, attributes, initialScope) != null;
 }
-function hasAnyAttribute(names, initialScope, attributes) {
-  return names.some((n) => hasAttribute(n, initialScope, attributes));
+function hasAnyAttribute(names, attributes, initialScope) {
+  return names.some((n) => hasAttribute(n, attributes, initialScope));
 }
-function hasEveryAttribute(names, initialScope, attributes) {
-  return names.every((n) => hasAttribute(n, initialScope, attributes));
-}
-function isKeyedElement(node, initialScope) {
-  return node.type === AST_NODE_TYPES.JSXElement && hasAttribute("key", initialScope, node.openingElement.attributes);
-}
-function isBuiltInElement(node) {
-  return node.type === AST_NODE_TYPES.JSXElement && node.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
-}
-function isUserDefinedElement(node) {
-  return node.type === AST_NODE_TYPES.JSXElement && node.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+function hasEveryAttribute(names, attributes, initialScope) {
+  return names.every((n) => hasAttribute(n, attributes, initialScope));
 }
 var JSXValueHint = {
   None: 0n,
@@ -228,6 +220,19 @@ function isJSXValue(node, jsxCtx, hint = DEFAULT_JSX_VALUE_HINT) {
   }
   return false;
 }
+function isFragmentElement(node) {
+  if (node.type !== AST_NODE_TYPES.JSXElement) return false;
+  return getElementName(node).split(".").at(-1) === "Fragment";
+}
+function isKeyedElement(node, initialScope) {
+  return node.type === AST_NODE_TYPES.JSXElement && hasAttribute("key", node.openingElement.attributes, initialScope);
+}
+function isBuiltInElement(node) {
+  return node.type === AST_NODE_TYPES.JSXElement && node.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
+}
+function isUserDefinedElement(node) {
+  return node.type === AST_NODE_TYPES.JSXElement && node.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+}
 var isLiteral = AST3.isOneOf([AST_NODE_TYPES.Literal, AST_NODE_TYPES.JSXText]);
 function isWhiteSpace(node) {
   return typeof node.value === "string" && node.value.trim() === "";
@@ -239,4 +244,4 @@ function isPaddingSpaces(node) {
   return isLiteral(node) && isWhiteSpace(node) && node.raw.includes("\n");
 }
 
-export { DEFAULT_JSX_VALUE_HINT, JSXValueHint, findParentAttribute, getAttribute, getAttributeName, getAttributeValue, getElementName, hasAnyAttribute, hasAttribute, hasEveryAttribute, isBuiltInElement, isJSXValue, isKeyedElement, isLineBreak, isLiteral, isPaddingSpaces, isUserDefinedElement, isWhiteSpace, toString };
+export { DEFAULT_JSX_VALUE_HINT, JSXValueHint, findParentAttribute, getAttribute, getAttributeName, getAttributeValue, getElementName, hasAnyAttribute, hasAttribute, hasEveryAttribute, isBuiltInElement, isFragmentElement, isJSXValue, isKeyedElement, isLineBreak, isLiteral, isPaddingSpaces, isUserDefinedElement, isWhiteSpace, toString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/jsx",
-  "version": "1.24.0-next.14",
+  "version": "1.24.0-next.15",
   "description": "ESLint React's TSESTree AST utility module for static analysis of JSX.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -37,9 +37,9 @@
     "@typescript-eslint/types": "^8.20.0",
     "@typescript-eslint/utils": "^8.20.0",
     "ts-pattern": "^5.6.0",
-    "@eslint-react/eff": "1.24.0-next.14",
-    "@eslint-react/var": "1.24.0-next.14",
-    "@eslint-react/ast": "1.24.0-next.14"
+    "@eslint-react/ast": "1.24.0-next.15",
+    "@eslint-react/var": "1.24.0-next.15",
+    "@eslint-react/eff": "1.24.0-next.15"
   },
   "devDependencies": {
     "tsup": "^8.3.5",