@eslint-react/ast 5.24.10 → 5.25.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AST_NODE_TYPES, TSESTree } from "@typescript-eslint/types";
-//#region src/types.d.ts
+//#region src/tree.d.ts
 /** Union of function-like node types. */
 type TSESTreeFunction = TSESTree.ArrowFunctionExpression | TSESTree.FunctionDeclaration | TSESTree.FunctionExpression;
 /** Union of class-like node types. */
@@ -19,6 +19,8 @@ type TSESTreeDirective = TSESTree.ExpressionStatement & {
 };
 /** Union of TypeScript type expression node types. */
 type TSESTreeTypeExpression = TSESTree.TSAsExpression | TSESTree.TSTypeAssertion | TSESTree.TSNonNullExpression | TSESTree.TSSatisfiesExpression | TSESTree.TSInstantiationExpression;
+/** Node type `T` with TypeScript type expressions excluded — the static result shape of `Extract.unwrap`. */
+type TSESTreeUnwrapped<T extends TSESTree.Node> = Exclude<T, TSESTreeTypeExpression | TSESTree.ChainExpression>;
 declare namespace check_d_exports {
   export { is, isCallExpression, isClass, isConditional, isDirective, isExpression, isFunction, isIdentifier, isJSX, isJSXElement, isJSXElementOrFragment, isJSXExpressionContainer, isJSXFragment, isJSXSpreadAttribute, isJSXTagNameExpression, isMemberExpression, isObjectExpression, isOneOf, isProperty, isPropertyOrMethod, isReturnStatement, isTypeAssertionExpression, isTypeExpression };
 }
@@ -102,9 +104,10 @@ declare namespace extract_d_exports {
 /**
  * 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.
+ * @returns The innermost non-type-expression node — a reference into the original tree, never a copy.
  */
-declare function unwrap(node: TSESTree.Node): Exclude<TSESTree.Node, TSESTreeTypeExpression>;
+declare function unwrap(node: TSESTreeTypeExpression | TSESTree.ChainExpression): TSESTreeUnwrapped<TSESTree.Expression>;
+declare function unwrap<T extends TSESTree.Node>(node: T): TSESTreeUnwrapped<T>;
 /**
  * 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.
@@ -149,7 +152,7 @@ declare function getPropertyName(property: TSESTree.Property, effort?: "min" | "
  */
 declare function getFullyQualifiedName(node: TSESTree.Node, getText: (node: TSESTree.Node) => string): string;
 declare namespace traverse_d_exports {
-  export { findEnclosingTryBlock, findParent };
+  export { findEnclosingTryBlock, findParent, hasEnclosingTryBlock, hasParent };
 }
 type Predicate<T extends TSESTree.Node> = (node: TSESTree.Node) => node is T;
 type NodePredicate = (node: TSESTree.Node) => boolean;
@@ -162,11 +165,26 @@ type NodePredicate = (node: TSESTree.Node) => boolean;
  */
 declare function findParent<T extends TSESTree.Node>(node: TSESTree.Node | null, test: Predicate<T>, stop?: NodePredicate): T | null;
 declare function findParent(node: TSESTree.Node | null, test: NodePredicate, stop?: NodePredicate): TSESTree.Node | null;
+/**
+ * Check whether `node` has an 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 `true` when a matching ancestor exists.
+ */
+declare function hasParent<T extends TSESTree.Node>(node: TSESTree.Node | null, test: Predicate<T>, stop?: NodePredicate): boolean;
+declare function hasParent(node: TSESTree.Node | null, test: NodePredicate, stop?: NodePredicate): boolean;
 /**
  * Find the nearest `TryStatement` whose `try` block (not `catch`/`finally`) encloses the given node.
  * @param node The node to check.
  * @returns The enclosing `TryStatement`, or `null` when none is found.
  */
 declare function findEnclosingTryBlock(node: TSESTree.Node): TSESTree.TryStatement | null;
+/**
+ * Check whether the given node is enclosed by the `try` block (not `catch`/`finally`) of a `TryStatement`.
+ * @param node The node to check.
+ * @returns `true` when an enclosing `try` block exists.
+ */
+declare function hasEnclosingTryBlock(node: TSESTree.Node): boolean;
 //#endregion
-export { check_d_exports as Check, compare_d_exports as Compare, extract_d_exports as Extract, type TSESTreeClass, type TSESTreeDirective, type TSESTreeFunction, type TSESTreeJSX, type TSESTreeJSXAttributeLike, type TSESTreeJSXElementLike, type TSESTreeMethodOrPropertyDefinition, type TSESTreeTypeExpression, traverse_d_exports as Traverse };
+export { check_d_exports as Check, compare_d_exports as Compare, extract_d_exports as Extract, type TSESTreeClass, type TSESTreeDirective, type TSESTreeFunction, type TSESTreeJSX, type TSESTreeJSXAttributeLike, type TSESTreeJSXElementLike, type TSESTreeMethodOrPropertyDefinition, type TSESTreeTypeExpression, type TSESTreeUnwrapped, traverse_d_exports as Traverse };

package/dist/index.js

@@ -371,7 +371,9 @@ const isEqual = dual(2, (a, b) => {
 //#region src/traverse.ts
 var traverse_exports = /* @__PURE__ */ __exportAll({
 	findEnclosingTryBlock: () => findEnclosingTryBlock,
-	findParent: () => findParent
+	findParent: () => findParent,
+	hasEnclosingTryBlock: () => hasEnclosingTryBlock,
+	hasParent: () => hasParent
 });
 function findParent(node, test, stop) {
 	if (node == null) return null;
@@ -384,11 +386,17 @@ function findParent(node, test, stop) {
 	}
 	return null;
 }
+function hasParent(node, test, stop) {
+	return findParent(node, test, stop) != null;
+}
 function findEnclosingTryBlock(node) {
 	const parent = node.parent;
 	if (parent == null || parent.type === AST_NODE_TYPES.Program) return null;
 	if (parent.type === AST_NODE_TYPES.TryStatement && node === parent.block) return parent;
 	return findEnclosingTryBlock(parent);
 }
+function hasEnclosingTryBlock(node) {
+	return findEnclosingTryBlock(node) != null;
+}
 //#endregion
 export { check_exports as Check, compare_exports as Compare, extract_exports as Extract, traverse_exports as Traverse };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/ast",
-  "version": "5.24.10",
+  "version": "5.25.0",
   "description": "ESLint React's TSESTree AST utility module.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -38,7 +38,7 @@
     "@local/eff": "0.0.0",
     "@local/testkit": "0.0.0",
     "eslint": "^10.12.0",
-    "tsdown": "^0.23.0",
+    "tsdown": "^0.23.1",
     "typescript": "6.0.3",
     "vitest": "^5.0.3"
   },