eslint-plugin-runtime-cleanup 1.2.8

package/dist/_internal/value-rewrite-autofix-safety.d.ts

@@ -0,0 +1,29 @@
+import type { TSESTree } from "@typescript-eslint/utils";
+/**
+ * Check whether a parent node is a transparent expression wrapper for `child`.
+ */
+export declare const isTransparentExpressionWrapper: (parent: Readonly<TSESTree.Node>, child: Readonly<TSESTree.Node>) => boolean;
+/**
+ * Detect whether an expression is a chain/optional-call/optional-member shape.
+ */
+export declare const isOptionalChainExpression: (node: Readonly<TSESTree.Expression>) => boolean;
+/**
+ * Determine whether an expression occupies a direct return position.
+ */
+export declare const isDirectReturnLikeExpressionPosition: (node: Readonly<TSESTree.Expression>) => boolean;
+/**
+ * Guard array index-to-helper rewrites known to be type-sensitive.
+ */
+export declare const isArrayIndexReadAutofixSafe: (node: Readonly<TSESTree.MemberExpression>) => boolean;
+/**
+ * Determine whether an expression is safe to evaluate fewer times after a
+ * rewrite that collapses duplicate evaluations.
+ *
+ * @remarks
+ * Expressions such as member access or function calls can change runtime
+ * behavior when duplicated evaluation sites are rewritten to a single helper
+ * call. This helper intentionally accepts only stable, exception-free
+ * primitives and identifiers.
+ */
+export declare const isRepeatablyEvaluableExpression: (node: Readonly<TSESTree.Expression | TSESTree.PrivateIdentifier>) => node is TSESTree.Expression;
+//# sourceMappingURL=value-rewrite-autofix-safety.d.ts.map

package/dist/_internal/value-rewrite-autofix-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-rewrite-autofix-safety.d.ts","sourceRoot":"","sources":["../../src/_internal/value-rewrite-autofix-safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAUzD;;GAEG;AACH,eAAO,MAAM,8BAA8B,GACvC,QAAQ,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC/B,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAC/B,OAsBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAClC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,KACpC,OAGmB,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAC7C,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,KACpC,OA+BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,GACpC,MAAM,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAC1C,OAUF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,GACxC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,iBAAiB,CAAC,KACjE,IAAI,IAAI,QAAQ,CAAC,UAmCnB,CAAC"}

package/dist/_internal/value-rewrite-autofix-safety.js

@@ -0,0 +1,108 @@
+/**
+ * @packageDocumentation
+ * Shared safety checks for value-expression autofixes.
+ */
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { getParentNode } from "./ast-node.js";
+/**
+ * Check whether a parent node is a transparent expression wrapper for `child`.
+ */
+export const isTransparentExpressionWrapper = (parent, child) => {
+    if (parent.type === AST_NODE_TYPES.ChainExpression) {
+        return parent.expression === child;
+    }
+    if (parent.type === AST_NODE_TYPES.TSAsExpression) {
+        return parent.expression === child;
+    }
+    if (parent.type === AST_NODE_TYPES.TSNonNullExpression) {
+        return parent.expression === child;
+    }
+    if (parent.type === AST_NODE_TYPES.TSSatisfiesExpression) {
+        return parent.expression === child;
+    }
+    if (parent.type === AST_NODE_TYPES.TSTypeAssertion) {
+        return parent.expression === child;
+    }
+    return false;
+};
+/**
+ * Detect whether an expression is a chain/optional-call/optional-member shape.
+ */
+export const isOptionalChainExpression = (node) => node.type === AST_NODE_TYPES.ChainExpression ||
+    ((node.type === AST_NODE_TYPES.CallExpression || node.type === AST_NODE_TYPES.MemberExpression) &&
+        node.optional);
+/**
+ * Determine whether an expression occupies a direct return position.
+ */
+export const isDirectReturnLikeExpressionPosition = (node) => {
+    let currentNode = node;
+    while (true) {
+        const parentNode = getParentNode(currentNode);
+        if (parentNode === undefined) {
+            return false;
+        }
+        if (isTransparentExpressionWrapper(parentNode, currentNode)) {
+            currentNode = parentNode;
+            continue;
+        }
+        if (parentNode.type === AST_NODE_TYPES.ReturnStatement &&
+            parentNode.argument === currentNode) {
+            return true;
+        }
+        if (parentNode.type === AST_NODE_TYPES.ArrowFunctionExpression &&
+            parentNode.body === currentNode) {
+            return true;
+        }
+        return false;
+    }
+};
+/**
+ * Guard array index-to-helper rewrites known to be type-sensitive.
+ */
+export const isArrayIndexReadAutofixSafe = (node) => {
+    if (isOptionalChainExpression(node.object)) {
+        return false;
+    }
+    if (isDirectReturnLikeExpressionPosition(node)) {
+        return false;
+    }
+    return true;
+};
+/**
+ * Determine whether an expression is safe to evaluate fewer times after a
+ * rewrite that collapses duplicate evaluations.
+ *
+ * @remarks
+ * Expressions such as member access or function calls can change runtime
+ * behavior when duplicated evaluation sites are rewritten to a single helper
+ * call. This helper intentionally accepts only stable, exception-free
+ * primitives and identifiers.
+ */
+export const isRepeatablyEvaluableExpression = (node) => {
+    if (node.type === AST_NODE_TYPES.PrivateIdentifier) {
+        return false;
+    }
+    if (node.type === AST_NODE_TYPES.TSAsExpression ||
+        node.type === AST_NODE_TYPES.TSNonNullExpression ||
+        node.type === AST_NODE_TYPES.TSSatisfiesExpression ||
+        node.type === AST_NODE_TYPES.TSTypeAssertion) {
+        return isRepeatablyEvaluableExpression(node.expression);
+    }
+    if (node.type === AST_NODE_TYPES.ChainExpression) {
+        return isRepeatablyEvaluableExpression(node.expression);
+    }
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return true;
+    }
+    if (node.type === AST_NODE_TYPES.Literal) {
+        return true;
+    }
+    if (node.type === AST_NODE_TYPES.TemplateLiteral) {
+        return node.expressions.length === 0;
+    }
+    if (node.type === AST_NODE_TYPES.ThisExpression) {
+        return true;
+    }
+    return false;
+};
+//# sourceMappingURL=value-rewrite-autofix-safety.js.map

package/dist/_internal/value-rewrite-autofix-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-rewrite-autofix-safety.js","sourceRoot":"","sources":["../../src/_internal/value-rewrite-autofix-safety.ts"],"names":[],"mappings":"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"}