eslint-plugin-typefest 1.0.1

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

@@ -0,0 +1,33 @@
+/**
+ * @packageDocumentation
+ * Shared safety checks for value-expression autofixes.
+ */
+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;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzD;;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,103 @@
+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 === "ChainExpression") {
+        return parent.expression === child;
+    }
+    if (parent.type === "TSAsExpression") {
+        return parent.expression === child;
+    }
+    if (parent.type === "TSNonNullExpression") {
+        return parent.expression === child;
+    }
+    if (parent.type === "TSSatisfiesExpression") {
+        return parent.expression === child;
+    }
+    if (parent.type === "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 === "ChainExpression" ||
+    ((node.type === "CallExpression" || node.type === "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 === "ReturnStatement" &&
+            parentNode.argument === currentNode) {
+            return true;
+        }
+        if (parentNode.type === "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 === "PrivateIdentifier") {
+        return false;
+    }
+    if (node.type === "TSAsExpression" ||
+        node.type === "TSNonNullExpression" ||
+        node.type === "TSSatisfiesExpression" ||
+        node.type === "TSTypeAssertion") {
+        return isRepeatablyEvaluableExpression(node.expression);
+    }
+    if (node.type === "ChainExpression") {
+        return isRepeatablyEvaluableExpression(node.expression);
+    }
+    if (node.type === "Identifier") {
+        return true;
+    }
+    if (node.type === "Literal") {
+        return true;
+    }
+    if (node.type === "TemplateLiteral") {
+        return node.expressions.length === 0;
+    }
+    if (node.type === "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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"}