@eslint-react/ast 3.0.0-next.63 → 3.0.0-next.65

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { unit } from "@eslint-react/eff";
 import { AST_NODE_TYPES, TSESTree } from "@typescript-eslint/types";
 import { TSESTree as TSESTree$1 } from "@typescript-eslint/utils";
 
@@ -73,9 +72,9 @@ type TSESTreeDirectiveLike = TSESTree$1.ExpressionStatement & {
 /**
  * Get the class identifier of a class node
  * @param node The class node to get the identifier from
- * @returns The class identifier or unit if not found
+ * @returns The class identifier or null if not found
  */
-declare function getClassId(node: TSESTreeClass): TSESTree.BindingName | unit;
+declare function getClassId(node: TSESTreeClass): TSESTree.BindingName | null;
 //#endregion
 //#region src/directive-is.d.ts
 /**
@@ -191,7 +190,7 @@ declare function isDirectiveInFunction(node: TSESTreeFunction, name: string): bo
  * where JS gives anonymous function expressions names. We roughly detect the
  * same AST nodes with some exceptions to better fit our use case.
  */
-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 | undefined;
+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;
 /**
  * Type representing the return type of getFunctionId
  */
@@ -208,9 +207,9 @@ type FunctionInitPath = readonly [TSESTree.FunctionDeclaration] | readonly [TSES
  * Determine what kind of component declaration pattern the function belongs to.
  *
  * @param node The function node to analyze
- * @returns The function initialization path or unit if not identifiable
+ * @returns The function initialization path or null if not identifiable
  */
-declare function getFunctionInitPath(node: TSESTreeFunction): unit | FunctionInitPath;
+declare function getFunctionInitPath(node: TSESTreeFunction): null | FunctionInitPath;
 /**
  * Check if a specific function call exists in the function initialization path.
  * Useful for detecting HOCs like React.memo, React.forwardRef, etc.
@@ -242,7 +241,7 @@ declare function isFunctionImmediatelyInvoked(node: TSESTreeFunction): boolean;
  * @param name The name to check
  * @returns True if the node is an identifier, false otherwise
  */
-declare function isIdentifier(node: TSESTree.Node | null | unit, name?: string): node is TSESTree.Identifier;
+declare function isIdentifier(node: TSESTree.Node | null, name?: string): node is TSESTree.Identifier;
 //#endregion
 //#region src/identifier-name.d.ts
 /**
@@ -444,16 +443,16 @@ declare const SEL_DISPLAY_NAME_ASSIGNMENT_EXPRESSION: string;
  * Find the parent node that satisfies the test function
  * @param node The AST node
  * @param test The test function
- * @returns The parent node that satisfies the test function or `_` if not found
+ * @returns The parent node that satisfies the test function or `null` if not found
  */
-declare function findParentNode<A extends TSESTree.Node>(node: TSESTree.Node | unit, test: (n: TSESTree.Node) => n is A): A | unit;
+declare function findParentNode<A extends TSESTree.Node>(node: TSESTree.Node | null, test: (n: TSESTree.Node) => n is A): A | null;
 /**
- * Find the parent node that satisfies the test function or `_` if not found
+ * Find the parent node that satisfies the test function or `null` if not found
  * @param node The AST node
  * @param test The test function
  * @returns The parent node that satisfies the test function
  */
-declare function findParentNode(node: TSESTree.Node | unit, test: (node: TSESTree.Node) => boolean): TSESTree.Node | unit;
+declare function findParentNode(node: TSESTree.Node | null, test: (node: TSESTree.Node) => boolean): TSESTree.Node | null;
 //#endregion
 //#region src/node-unwrap.d.ts
 /**
@@ -470,7 +469,7 @@ declare function getUnderlyingExpression(node: TSESTree.Node): Exclude<TSESTree.
  * @param node The AST node
  * @returns True if the node is a member expression that accesses `process.env.NODE_ENV`, false otherwise
  */
-declare function isProcessEnvNodeEnv(node: TSESTree.Node | null | unit): node is TSESTree.MemberExpression;
+declare function isProcessEnvNodeEnv(node: TSESTree.Node | null): node is TSESTree.MemberExpression;
 /**
  * Check if the given node is a binary expression that compares `process.env.NODE_ENV` with a string literal.
  * @param node The AST node
@@ -478,7 +477,7 @@ declare function isProcessEnvNodeEnv(node: TSESTree.Node | null | unit): node is
  * @param value The string literal value to compare against
  * @returns True if the node is a binary expression that compares `process.env.NODE_ENV` with the specified value, false otherwise
  */
-declare function isProcessEnvNodeEnvCompare(node: TSESTree.Node | null | unit, operator: "===" | "!==", value: "development" | "production"): node is TSESTree.BinaryExpression;
+declare function isProcessEnvNodeEnvCompare(node: TSESTree.Node | null, operator: "===" | "!==", value: "development" | "production"): node is TSESTree.BinaryExpression;
 //#endregion
 //#region src/pattern-vitest-mock.d.ts
 /**
@@ -487,31 +486,31 @@ declare function isProcessEnvNodeEnvCompare(node: TSESTree.Node | null | unit, o
  * @returns `true` if the node is a `vi.mock`, otherwise `false`.
  * @internal
  */
-declare function isViMock(node: TSESTree.Node | null | unit): node is TSESTree.MemberExpression;
+declare function isViMock(node: TSESTree.Node | null): node is TSESTree.MemberExpression;
 /**
  * Check if the given node is a `vi.mock` callback.
  * @param node The node to check
  * @returns `true` if the node is a `vi.mock` callback, otherwise `false`.
  * @internal
  */
-declare function isViMockCallback(node: TSESTree.Node | null | unit): boolean;
+declare function isViMockCallback(node: TSESTree.Node | null): boolean;
 //#endregion
 //#region src/property-name.d.ts
 /**
  * Get the name of a property from a node
  * Handles identifiers, private identifiers, literals, and template literals
  * @param node The node to get the property name from
- * @returns The property name or unit if not determinable
+ * @returns The property name or null if not determinable
  */
-declare function getPropertyName(node: TSESTree.Node): string | unit;
+declare function getPropertyName(node: TSESTree.Node): string | null;
 //#endregion
 //#region src/property-traverse.d.ts
 /**
  * Recursively traverses an object expression's properties to find a property with the specified name
  * @param properties The properties of the object expression to traverse
  * @param name The name of the property to find
- * @returns The matching property node, or undefined if not found
+ * @returns The matching property node, or null if not found
  */
-declare function findProperty(properties: TSESTree.ObjectLiteralElement[], name: string): TSESTree.Property | unit;
+declare function findProperty(properties: TSESTree.ObjectLiteralElement[], name: string): TSESTree.Property | null;
 //#endregion
 export { DirectiveKind, DisplayNameAssignmentExpression, FunctionID, FunctionInitPath, ImplicitReturnArrowFunctionExpression, ObjectDestructuringVariableDeclarator, SEL_DISPLAY_NAME_ASSIGNMENT_EXPRESSION, SEL_IMPLICIT_RETURN_ARROW_FUNCTION_EXPRESSION, SEL_OBJECT_DESTRUCTURING_VARIABLE_DECLARATOR, TSESTreeArrayTupleType, TSESTreeClass, TSESTreeDestructuringPattern, TSESTreeDirective, TSESTreeDirectiveLike, TSESTreeFunction, TSESTreeFunctionType, TSESTreeJSX, TSESTreeJSXAttributeLike, TSESTreeLoop, TSESTreeMethodOrProperty, TSESTreeProperty, TSESTreeTypeAssertionExpression, TSESTreeTypeDeclaration, TSESTreeTypeExpression, findParentNode, findProperty, getClassId, getFileDirectives, getFullyQualifiedName, getFunctionDirectives, getFunctionId, getFunctionInitPath, getHumanReadableKind, getNestedCallExpressions, getNestedExpressionsOfType, getNestedIdentifiers, getNestedNewExpressions, getNestedReturnStatements, getPropertyName, getRootIdentifier, getUnderlyingExpression, hasCallInFunctionInitPath, is, isClass, isConditional, isControlFlow, isDirective, isDirectiveInFile, isDirectiveInFunction, isDirectiveKind, isDirectiveLike, isDirectiveName, isFunction, isFunctionEmpty, isFunctionImmediatelyInvoked, isFunctionType, isIdentifier, isIdentifierName, isJSX, isJSXElement, isJSXFragment, isJSXTagNameExpression, isLineBreak, isLiteral, isLoop, isMethodOrProperty, isMultiLine, isNodeEqual, isOneOf, isProcessEnvNodeEnv, isProcessEnvNodeEnvCompare, isProperty, isThisExpressionLoose, isTypeAssertionExpression, isTypeExpression, isViMock, isViMockCallback };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { dual, or, unit } from "@eslint-react/eff";
 import { AST_NODE_TYPES, TSESTree } from "@typescript-eslint/types";
+import { dual, or } from "@eslint-react/eff";
 import { ASTUtils } from "@typescript-eslint/utils";
 import { simpleTraverse } from "@typescript-eslint/typescript-estree";
 import { delimiterCase, replace, toLowerCase } from "string-ts";
@@ -8,12 +8,12 @@ import { delimiterCase, replace, toLowerCase } from "string-ts";
 /**
 * Get the class identifier of a class node
 * @param node The class node to get the identifier from
-* @returns The class identifier or unit if not found
+* @returns The class identifier or null if not found
 */
 function getClassId(node) {
 	if (node.id != null) return node.id;
 	if (node.parent.type === AST_NODE_TYPES.VariableDeclarator) return node.parent.id;
-	return unit;
+	return null;
 }
 
 //#endregion
@@ -255,13 +255,13 @@ function isThisExpressionLoose(node) {
 //#endregion
 //#region src/node-traverse.ts
 function findParentNode(node, test) {
-	if (node == null) return unit;
+	if (node == null) return null;
 	let parent = node.parent;
 	while (parent != null && parent.type !== AST_NODE_TYPES.Program) {
 		if (test(parent)) return parent;
 		parent = parent.parent;
 	}
-	return unit;
+	return null;
 }
 
 //#endregion
@@ -518,7 +518,7 @@ function getFunctionId(node) {
 		case node.parent.type === AST_NODE_TYPES.ConditionalExpression: return getFunctionId(node.parent);
 		case isTypeAssertionExpression(node.parent): return getFunctionId(node.parent);
 	}
-	return unit;
+	return null;
 }
 
 //#endregion
@@ -528,7 +528,7 @@ function getFunctionId(node) {
 * Determine what kind of component declaration pattern the function belongs to.
 *
 * @param node The function node to analyze
-* @returns The function initialization path or unit if not identifiable
+* @returns The function initialization path or null if not identifiable
 */
 function getFunctionInitPath(node) {
 	if (node.type === AST_NODE_TYPES.FunctionDeclaration) return [node];
@@ -572,7 +572,7 @@ function getFunctionInitPath(node) {
 			node
 		];
 	}
-	return unit;
+	return null;
 }
 /**
 * Check if a specific function call exists in the function initialization path.
@@ -806,14 +806,14 @@ function isViMockCallback(node) {
 * Get the name of a property from a node
 * Handles identifiers, private identifiers, literals, and template literals
 * @param node The node to get the property name from
-* @returns The property name or unit if not determinable
+* @returns The property name or null if not determinable
 */
 function getPropertyName(node) {
 	if (isTypeExpression(node)) return getPropertyName(getUnderlyingExpression(node));
 	if (node.type === AST_NODE_TYPES.Identifier || node.type === AST_NODE_TYPES.PrivateIdentifier) return node.name;
 	if (node.type === AST_NODE_TYPES.Literal) return String(node.value);
-	if (node.type === AST_NODE_TYPES.TemplateLiteral && node.expressions.length === 0) return node.quasis[0]?.value.raw;
-	return unit;
+	if (node.type === AST_NODE_TYPES.TemplateLiteral && node.expressions.length === 0) return node.quasis[0]?.value.raw ?? null;
+	return null;
 }
 
 //#endregion
@@ -822,7 +822,7 @@ function getPropertyName(node) {
 * Recursively traverses an object expression's properties to find a property with the specified name
 * @param properties The properties of the object expression to traverse
 * @param name The name of the property to find
-* @returns The matching property node, or undefined if not found
+* @returns The matching property node, or null if not found
 */
 function findProperty(properties, name) {
 	for (const prop of properties) {
@@ -832,7 +832,7 @@ function findProperty(properties, name) {
 			if (found != null) return found;
 		}
 	}
-	return unit;
+	return null;
 }
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/ast",
-  "version": "3.0.0-next.63",
+  "version": "3.0.0-next.65",
   "description": "ESLint React's TSESTree AST utility module.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -34,7 +34,7 @@
     "@typescript-eslint/typescript-estree": "canary",
     "@typescript-eslint/utils": "canary",
     "string-ts": "^2.3.1",
-    "@eslint-react/eff": "3.0.0-next.63"
+    "@eslint-react/eff": "3.0.0-next.65"
   },
   "devDependencies": {
     "tsdown": "^0.21.0-beta.2",