@eslint-react/ast - npm Package Compare versions

Comparing version 5.17.3 to 5.18.0

dist/index.d.ts

 import { AST_NODE_TYPES, TSESTree } from "@typescript-eslint/types";
 //#region src/types.d.ts
+/** Union of function-like node types. */
 type TSESTreeFunction = TSESTree.ArrowFunctionExpression | TSESTree.FunctionDeclaration | TSESTree.FunctionExpression;
+/** Union of class-like node types. */
 type TSESTreeClass = TSESTree.ClassDeclaration | TSESTree.ClassExpression;
+/** Union of method and property definition node types. */
 type TSESTreeMethodOrPropertyDefinition = TSESTree.PropertyDefinition | TSESTree.MethodDefinition;
+/** Union of all JSX-related node types. */
 type TSESTreeJSX = TSESTree.JSXAttribute | TSESTree.JSXClosingElement | TSESTree.JSXClosingFragment | TSESTree.JSXElement | TSESTree.JSXEmptyExpression | TSESTree.JSXExpressionContainer | TSESTree.JSXFragment | TSESTree.JSXIdentifier | TSESTree.JSXMemberExpression | TSESTree.JSXNamespacedName | TSESTree.JSXOpeningElement | TSESTree.JSXOpeningFragment | TSESTree.JSXSpreadAttribute | TSESTree.JSXSpreadChild | TSESTree.JSXText;
+/** Union of JSX element-like node types (element or fragment). */
 type TSESTreeJSXElementLike = TSESTree.JSXElement | TSESTree.JSXFragment;
+/** Union of JSX attribute-like node types (attribute or spread attribute). */
 type TSESTreeJSXAttributeLike = TSESTree.JSXAttribute | TSESTree.JSXSpreadAttribute;
+/** An expression statement that is a directive (ex: `"use strict"`). */
 type TSESTreeDirective = TSESTree.ExpressionStatement & {
@@ -13,2 +20,3 @@ directive: string;
 };
+/** Union of TypeScript type expression node types. */
 type TSESTreeTypeExpression = TSESTree.TSAsExpression | TSESTree.TSTypeAssertion | TSESTree.TSNonNullExpression | TSESTree.TSSatisfiesExpression | TSESTree.TSInstantiationExpression;
@@ -18,26 +26,52 @@ declare namespace check_d_exports {
 }
+/** Check if a node is of the given type. */
 declare const is: <NodeType extends AST_NODE_TYPES>(nodeType: NodeType) => (node: TSESTree.Node | null | undefined) => node is Extract<TSESTree.Node, {
   type: NodeType;
 }>;
+/** Check if a node is one of the given types. */
 declare const isOneOf: <NodeTypes extends readonly AST_NODE_TYPES[]>(nodeTypes: NodeTypes) => (node: TSESTree.Node | null | undefined) => node is Extract<TSESTree.Node, {
   type: NodeTypes[number];
 }>;
+/**
+ * Check if a node is a directive statement (ex: `"use client"`), optionally matching a specific directive name.
+ * @param node The node to check.
+ * @param name The directive name to match. When omitted, any directive matches.
+ * @returns `true` if the node is a matching directive statement.
+ */
 declare function isDirective(node: TSESTree.Node, name?: string): node is TSESTreeDirective;
+/**
+ * Check if a node is an identifier, optionally matching a specific name.
+ * @param node The node to check.
+ * @param name The identifier name to match. When omitted, any identifier matches.
+ * @returns `true` if the node is a matching identifier.
+ */
 declare function isIdentifier(node: TSESTree.Node, name?: string): node is TSESTree.Identifier;
+/** Check if a node is a class declaration or class expression. */
 declare const isClass: (node: TSESTree.Node | null | undefined) => node is TSESTree.ClassDeclarationWithName | TSESTree.ClassDeclarationWithOptionalName | TSESTree.ClassExpression;
+/** Check if a node is a function declaration, function expression, or arrow function expression. */
 declare const isFunction: (node: TSESTree.Node | null | undefined) => node is TSESTree.ArrowFunctionExpressionWithBlockBody | TSESTree.ArrowFunctionExpressionWithExpressionBody | TSESTree.FunctionDeclarationWithName | TSESTree.FunctionDeclarationWithOptionalName | TSESTree.FunctionExpression;
+/** Check if a node is a property-like node (property definition, index signature, parameter property, or property signature). */
 declare const isProperty: (node: TSESTree.Node | null | undefined) => node is TSESTree.PropertyDefinitionComputedName | TSESTree.PropertyDefinitionNonComputedName | TSESTree.TSIndexSignature | TSESTree.TSParameterProperty | TSESTree.TSPropertySignatureComputedName | TSESTree.TSPropertySignatureNonComputedName;
+/** Check if a node is a property or method definition. */
 declare const isPropertyOrMethod: (node: TSESTree.Node | null | undefined) => node is TSESTree.MethodDefinitionComputedName | TSESTree.MethodDefinitionNonComputedName | TSESTree.PropertyDefinitionComputedName | TSESTree.PropertyDefinitionNonComputedName;
+/** Check if a node is a JSX element. */
 declare const isJSXElement: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXElement;
+/** Check if a node is a JSX fragment. */
 declare const isJSXFragment: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXFragment;
+/** Check if a node is a JSX element or JSX fragment. */
 declare const isJSXElementOrFragment: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXElement | TSESTree.JSXFragment;
+/** Check if a node can appear as a JSX tag name. */
 declare const isJSXTagNameExpression: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXIdentifier | TSESTree.JSXMemberExpression | TSESTree.JSXNamespacedName;
+/** Check if a node is any JSX-related node. */
 declare const isJSX: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXAttribute | TSESTree.JSXClosingElement | TSESTree.JSXClosingFragment | TSESTree.JSXElement | TSESTree.JSXEmptyExpression | TSESTree.JSXExpressionContainer | TSESTree.JSXFragment | TSESTree.JSXIdentifier | TSESTree.JSXMemberExpression | TSESTree.JSXNamespacedName | TSESTree.JSXOpeningElement | TSESTree.JSXOpeningFragment | TSESTree.JSXSpreadAttribute | TSESTree.JSXSpreadChild | TSESTree.JSXText;
+/** Check if a node is a TypeScript type expression (assertion, non-null, satisfies, or instantiation). */
 declare const isTypeExpression: (node: TSESTree.Node | null | undefined) => node is TSESTree.TSAsExpression | TSESTree.TSInstantiationExpression | TSESTree.TSNonNullExpression | TSESTree.TSSatisfiesExpression | TSESTree.TSTypeAssertion;
+/** Check if a node is a TypeScript type assertion-like expression (as, assertion, non-null, or satisfies). */
 declare const isTypeAssertionExpression: (node: TSESTree.Node | null | undefined) => node is TSESTree.TSAsExpression | TSESTree.TSNonNullExpression | TSESTree.TSSatisfiesExpression | TSESTree.TSTypeAssertion;
+/** Check if a node is an expression node. */
 declare const isExpression: (node: TSESTree.Node | null | undefined) => node is TSESTree.ArrayExpression | TSESTree.ArrayPattern | TSESTree.ArrowFunctionExpressionWithBlockBody | TSESTree.ArrowFunctionExpressionWithExpressionBody | 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.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.YieldNoStarExpression | TSESTree.YieldStarExpression;
 /**
- * Check if a node is a conditional expression or control flow statement
- * @param node The node to check
- * @returns True if the node is conditional
+ * Check if a node is a conditional expression or a control flow statement.
+ * @param node The node to check.
+ * @returns `true` if the node is conditional.
  */
@@ -49,6 +83,6 @@ declare const isConditional: (node: TSESTree.Node | null | undefined) => node is TSESTree.ConditionalExpression | TSESTree.DoWhileStatement | TSESTree.ForInStatement | TSESTree.ForOfStatement | TSESTree.ForStatement | TSESTree.IfStatement | TSESTree.LogicalExpression | TSESTree.SwitchStatement | TSESTree.WhileStatement;
 /**
- * Check if two nodes are equal.
- * @param a node to compare.
- * @param b node to compare.
- * @returns `true` if node equal.
+ * Check if two nodes are structurally equal.
+ * @param a The first node to compare.
+ * @param b The second node to compare.
+ * @returns `true` if the nodes are equal.
  * @see https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/util/isNodeEqual.ts
@@ -63,7 +97,41 @@ */
 }
+/**
+ * Recursively unwrap TypeScript type expressions and chain expressions to get the underlying expression.
+ * @param node The node to unwrap.
+ * @returns The innermost non-type-expression node.
+ */
 declare function unwrap(node: TSESTree.Node): Exclude<TSESTree.Node, TSESTreeTypeExpression>;
+/**
+ * Find a property by name in a list of object literal properties, recursing into spread object expressions.
+ * @param properties The object literal properties to search.
+ * @param name The property name to look for.
+ * @returns The matching `Property` node, or `null` when not found.
+ */
 declare function findProperty(properties: TSESTree.ObjectLiteralElement[], name: string): TSESTree.Property | null;
+/**
+ * Get the name of the callee of a call expression.
+ * @param node The call expression to inspect.
+ * @returns The callee name (ex: `"useState"`), or `null` when it cannot be statically determined.
+ */
 declare function getCalleeName(node: TSESTree.CallExpression): string | null;
+/**
+ * Get the static name of an object property's key.
+ * @param property The property to inspect.
+ * @param effort `"min"` only matches plain identifiers; `"max"` also resolves string literals and simple template literals.
+ * @returns The property name, or `null` when it cannot be statically determined.
+ */
 declare function getPropertyName(property: TSESTree.Property, effort?: "min" | "max"): string | null;
+/**
+ * Get the fully qualified name of a node (ex: `React.useState`), falling back to source text when needed.
+ * @param node The node to inspect.
+ * @param getText A function returning the source text of a node.
+ * @returns The fully qualified name.
+ */
 declare function getFullyQualifiedName(node: TSESTree.Node, getText: (node: TSESTree.Node) => string): string;
+/**
+ * Get the identifier at a given position in a member expression chain (ex: position `0` in `a.b.c` is `a`).
+ * @param node The expression to walk.
+ * @param position The position of the identifier to return.
+ * @returns The identifier at the given position, or `null` when there is none.
+ */
 declare function getIdentifierAt(node: TSESTree.Expression | TSESTree.PrivateIdentifier, position: number): TSESTree.Identifier | null;
@@ -75,2 +143,9 @@ declare namespace traverse_d_exports {
 type NodePredicate = (node: TSESTree.Node) => boolean;
+/**
+ * Walk up the AST from `node` to find the nearest ancestor matching a predicate.
+ * @param node The starting node for the upward search.
+ * @param test The predicate a candidate ancestor must satisfy.
+ * @param stop An optional predicate that aborts the search when it returns `true`.
+ * @returns The first matching ancestor, or `null` when none is found.
+ */
 declare function findParent<T extends TSESTree.Node>(node: TSESTree.Node | null, test: Predicate<T>, stop?: NodePredicate): T | null;
@@ -77,0 +152,0 @@ declare function findParent(node: TSESTree.Node | null, test: NodePredicate, stop?: NodePredicate): TSESTree.Node | null;

dist/index.js

@@ -25,11 +25,27 @@ import { t as __exportAll } from "./rolldown-runtime-w6R9maHv.js";
 });
+/** Check if a node is of the given type. */
 const is = ASTUtils.isNodeOfType;
+/** Check if a node is one of the given types. */
 const isOneOf = ASTUtils.isNodeOfTypes;
+/**
+* Check if a node is a directive statement (ex: `"use client"`), optionally matching a specific directive name.
+* @param node The node to check.
+* @param name The directive name to match. When omitted, any directive matches.
+* @returns `true` if the node is a matching directive statement.
+*/
 function isDirective(node, name) {
 	return node.type === AST_NODE_TYPES.ExpressionStatement && (name == null || node.directive === name);
 }
+/**
+* Check if a node is an identifier, optionally matching a specific name.
+* @param node The node to check.
+* @param name The identifier name to match. When omitted, any identifier matches.
+* @returns `true` if the node is a matching identifier.
+*/
 function isIdentifier(node, name) {
 	return node.type === AST_NODE_TYPES.Identifier && (name == null || node.name === name);
 }
+/** Check if a node is a class declaration or class expression. */
 const isClass = isOneOf([AST_NODE_TYPES.ClassDeclaration, AST_NODE_TYPES.ClassExpression]);
+/** Check if a node is a function declaration, function expression, or arrow function expression. */
 const isFunction = isOneOf([
@@ -40,2 +56,3 @@ AST_NODE_TYPES.ArrowFunctionExpression,
 ]);
+/** Check if a node is a property-like node (property definition, index signature, parameter property, or property signature). */
 const isProperty = isOneOf([
@@ -47,6 +64,11 @@ AST_NODE_TYPES.PropertyDefinition,
 ]);
+/** Check if a node is a property or method definition. */
 const isPropertyOrMethod = isOneOf([AST_NODE_TYPES.PropertyDefinition, AST_NODE_TYPES.MethodDefinition]);
+/** Check if a node is a JSX element. */
 const isJSXElement = is(AST_NODE_TYPES.JSXElement);
+/** Check if a node is a JSX fragment. */
 const isJSXFragment = is(AST_NODE_TYPES.JSXFragment);
+/** Check if a node is a JSX element or JSX fragment. */
 const isJSXElementOrFragment = isOneOf([AST_NODE_TYPES.JSXElement, AST_NODE_TYPES.JSXFragment]);
+/** Check if a node can appear as a JSX tag name. */
 const isJSXTagNameExpression = isOneOf([
@@ -57,2 +79,3 @@ AST_NODE_TYPES.JSXIdentifier,
 ]);
+/** Check if a node is any JSX-related node. */
 const isJSX = isOneOf([
@@ -75,2 +98,3 @@ AST_NODE_TYPES.JSXAttribute,
 ]);
+/** Check if a node is a TypeScript type expression (assertion, non-null, satisfies, or instantiation). */
 const isTypeExpression = isOneOf([
@@ -83,2 +107,3 @@ AST_NODE_TYPES.TSAsExpression,
 ]);
+/** Check if a node is a TypeScript type assertion-like expression (as, assertion, non-null, or satisfies). */
 const isTypeAssertionExpression = isOneOf([
@@ -90,2 +115,3 @@ AST_NODE_TYPES.TSAsExpression,
 ]);
+/** Check if a node is an expression node. */
 const isExpression = isOneOf([
@@ -129,5 +155,5 @@ AST_NODE_TYPES.ArrayExpression,
 /**
-* Check if a node is a conditional expression or control flow statement
-* @param node The node to check
-* @returns True if the node is conditional
+* Check if a node is a conditional expression or a control flow statement.
+* @param node The node to check.
+* @returns `true` if the node is conditional.
 */
@@ -630,2 +656,7 @@ const isConditional = isOneOf([
 });
+/**
+* Recursively unwrap TypeScript type expressions and chain expressions to get the underlying expression.
+* @param node The node to unwrap.
+* @returns The innermost non-type-expression node.
+*/
 function unwrap(node) {
@@ -635,2 +666,8 @@ if (isTypeExpression(node) || node.type === AST_NODE_TYPES.ChainExpression) return unwrap(node.expression);
 }
+/**
+* Find a property by name in a list of object literal properties, recursing into spread object expressions.
+* @param properties The object literal properties to search.
+* @param name The property name to look for.
+* @returns The matching `Property` node, or `null` when not found.
+*/
 function findProperty(properties, name) {
@@ -646,2 +683,7 @@ for (const property of properties) {
 }
+/**
+* Get the name of the callee of a call expression.
+* @param node The call expression to inspect.
+* @returns The callee name (ex: `"useState"`), or `null` when it cannot be statically determined.
+*/
 function getCalleeName(node) {
@@ -653,2 +695,8 @@ const callee = unwrap(node.callee);
 }
+/**
+* Get the static name of an object property's key.
+* @param property The property to inspect.
+* @param effort `"min"` only matches plain identifiers; `"max"` also resolves string literals and simple template literals.
+* @returns The property name, or `null` when it cannot be statically determined.
+*/
 function getPropertyName(property, effort = "min") {
@@ -662,2 +710,8 @@ const key = unwrap(property.key);
 }
+/**
+* Get the fully qualified name of a node (ex: `React.useState`), falling back to source text when needed.
+* @param node The node to inspect.
+* @param getText A function returning the source text of a node.
+* @returns The fully qualified name.
+*/
 function getFullyQualifiedName(node, getText) {
@@ -679,2 +733,8 @@ const expr = unwrap(node);
 }
+/**
+* Get the identifier at a given position in a member expression chain (ex: position `0` in `a.b.c` is `a`).
+* @param node The expression to walk.
+* @param position The position of the identifier to return.
+* @returns The identifier at the given position, or `null` when there is none.
+*/
 function getIdentifierAt(node, position) {
@@ -696,6 +756,6 @@ const identifiers = [];
 /**
-* Check if two nodes are equal.
-* @param a node to compare.
-* @param b node to compare.
-* @returns `true` if node equal.
+* Check if two nodes are structurally equal.
+* @param a The first node to compare.
+* @param b The second node to compare.
+* @returns `true` if the nodes are equal.
 * @see https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/src/util/isNodeEqual.ts
@@ -702,0 +762,0 @@ */

package.json

 {
   "name": "@eslint-react/ast",
-  "version": "5.17.3",
+  "version": "5.18.0",
   "description": "ESLint React's TSESTree AST utility module.",
@@ -32,15 +32,15 @@ "homepage": "https://github.com/Rel1cx/eslint-react",
   "dependencies": {
-    "@typescript-eslint/types": "^8.64.0",
-    "@typescript-eslint/typescript-estree": "^8.64.0",
-    "@typescript-eslint/utils": "^8.64.0",
+    "@typescript-eslint/types": "^8.65.0",
+    "@typescript-eslint/typescript-estree": "^8.65.0",
+    "@typescript-eslint/utils": "^8.65.0",
     "string-ts": "^2.3.1"
   },
   "devDependencies": {
-    "@typescript-eslint/parser": "^8.64.0",
+    "@typescript-eslint/parser": "^8.65.0",
     "eslint": "^10.7.0",
-    "tsdown": "^0.22.9",
+    "tsdown": "^0.22.13",
     "typescript": "6.0.3",
     "vitest": "^4.1.10",
+    "@local/eff": "0.0.0",
     "@local/configs": "0.0.0",
-    "@local/eff": "0.0.0",
     "@local/testkit": "0.0.0"
@@ -47,0 +47,0 @@ },

No alert changes

Improved metrics

Total package byte prevSize

42211

20.02%

Lines of code

980

15.98%

Dependency changes

• Updated

  @typescript-eslint/types@^8.65.0

• Updated

  @typescript-eslint/typescript-estree@^8.65.0

• Updated

  @typescript-eslint/utils@^8.65.0