eslint-plugin-runtime-cleanup 1.2.8

package/dist/_internal/filter-callback.js

@@ -0,0 +1,108 @@
+/**
+ * @packageDocumentation
+ * Utilities for detecting nodes that live inside `.filter(...)` callbacks.
+ */
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { getParentNode } from "./ast-node.js";
+/** Target method name used for callback-context detection. */
+const FILTER_METHOD_NAME = "filter";
+/**
+ * Narrows nodes to function-like callback expressions.
+ */
+const isFunctionCallbackNode = (node) => node.type === AST_NODE_TYPES.ArrowFunctionExpression ||
+    node.type === AST_NODE_TYPES.FunctionExpression;
+/**
+ * Narrows call expressions to direct `.filter(...)` calls.
+ */
+export const isFilterCallExpression = (expression) => !expression.optional &&
+    expression.callee.type === AST_NODE_TYPES.MemberExpression &&
+    !expression.callee.computed &&
+    !expression.callee.optional &&
+    expression.callee.property.type === AST_NODE_TYPES.Identifier &&
+    expression.callee.property.name === FILTER_METHOD_NAME;
+/**
+ * Extract the first callback argument from a direct `.filter(...)` call.
+ *
+ * @param expression - Candidate call expression to inspect.
+ *
+ * @returns Callback expression when the call is a supported `.filter(...)`
+ *   invocation and the first argument is an arrow/function expression;
+ *   otherwise `null`.
+ */
+export const getFilterCallbackFunctionArgument = (expression) => {
+    if (!isFilterCallExpression(expression)) {
+        return null;
+    }
+    const [firstArgument] = expression.arguments;
+    if (!firstArgument ||
+        (firstArgument.type !== AST_NODE_TYPES.ArrowFunctionExpression &&
+            firstArgument.type !== AST_NODE_TYPES.FunctionExpression)) {
+        return null;
+    }
+    return firstArgument;
+};
+const isSingleParameterExpressionArrowFunction = (callback) => {
+    if (callback.params.length !== 1) {
+        return false;
+    }
+    if (callback.body.type === AST_NODE_TYPES.BlockStatement) {
+        return false;
+    }
+    const firstParameter = callback.params.at(0);
+    return firstParameter?.type === AST_NODE_TYPES.Identifier;
+};
+/**
+ * Extract a strict callback shape from direct `.filter(...)` calls.
+ *
+ * @param expression - Candidate call expression to inspect.
+ *
+ * @returns Structured callback match when supported; otherwise `null`.
+ */
+export const getSingleParameterExpressionArrowFilterCallback = (expression) => {
+    const callback = getFilterCallbackFunctionArgument(expression);
+    if (callback?.type !== AST_NODE_TYPES.ArrowFunctionExpression) {
+        return null;
+    }
+    if (!isSingleParameterExpressionArrowFunction(callback)) {
+        return null;
+    }
+    const [parameter] = callback.params;
+    return {
+        callback,
+        parameter,
+    };
+};
+/**
+ * Checks whether a node appears inside a callback passed as the first argument
+ * to a direct `.filter(...)` call.
+ *
+ * @param node - Node to inspect.
+ *
+ * @returns `true` when the node is inside a `.filter(...)` callback; otherwise
+ *   `false`.
+ */
+export const isWithinFilterCallback = (node) => {
+    let currentNode = node;
+    const visitedNodes = new Set();
+    while (currentNode) {
+        if (visitedNodes.has(currentNode)) {
+            return false;
+        }
+        visitedNodes.add(currentNode);
+        if (isFunctionCallbackNode(currentNode)) {
+            const callbackParent = getParentNode(currentNode);
+            if (callbackParent?.type !== AST_NODE_TYPES.CallExpression) {
+                currentNode = getParentNode(currentNode);
+                continue;
+            }
+            const [firstArgument] = callbackParent.arguments;
+            if (firstArgument === currentNode &&
+                isFilterCallExpression(callbackParent)) {
+                return true;
+            }
+        }
+        currentNode = getParentNode(currentNode);
+    }
+    return false;
+};
+//# sourceMappingURL=filter-callback.js.map

package/dist/_internal/filter-callback.js.map

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

package/dist/_internal/floating-resource.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @packageDocumentation
+ * Shared AST helpers for rules that reject unowned cleanup handles.
+ */
+import { type TSESTree } from "@typescript-eslint/utils";
+/**
+ * Unwrap syntax that does not change whether a resource expression is owned.
+ */
+export declare const getTransparentWrappedExpression: (node: Readonly<TSESTree.Node>) => Readonly<TSESTree.Node> | undefined;
+/**
+ * Resolve a static property name from dot or string-literal member access.
+ */
+export declare const getStaticPropertyName: (node: Readonly<TSESTree.MemberExpression["property"]>, computed: boolean) => string | undefined;
+/**
+ * Resolve a simple static member path such as `globalThis.URL.createObjectURL`.
+ */
+export declare const collectStaticMemberPath: (node: Readonly<TSESTree.Expression>) => readonly string[] | undefined;
+/**
+ * Check whether a resource-producing expression is discarded as a standalone
+ * expression or explicitly voided.
+ */
+export declare const isDiscardedResourceExpression: (node: Readonly<TSESTree.Node>) => boolean;
+/**
+ * Check whether a resource handle is immediately used as a member receiver
+ * instead of being retained. Cleanup members are excluded so immediate cleanup
+ * calls such as `new AudioContext().close()` are not reported here.
+ */
+export declare const isImmediateUnownedMemberReceiver: (node: Readonly<TSESTree.Node>, cleanupMemberNames: ReadonlySet<string>) => boolean;
+//# sourceMappingURL=floating-resource.d.ts.map

package/dist/_internal/floating-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-resource.d.ts","sourceRoot":"","sources":["../../src/_internal/floating-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzE;;GAEG;AACH,eAAO,MAAM,+BAA+B,GACxC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAC9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,SA0B5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAC9B,MAAM,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,EACrD,UAAU,OAAO,KAClB,MAAM,GAAG,SAcX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAChC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,KACpC,SAAS,MAAM,EAAE,GAAG,SAetB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GACtC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAC9B,OAkCF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GACzC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,oBAAoB,WAAW,CAAC,MAAM,CAAC,KACxC,OAgCF,CAAC"}

package/dist/_internal/floating-resource.js

@@ -0,0 +1,114 @@
+/**
+ * @packageDocumentation
+ * Shared AST helpers for rules that reject unowned cleanup handles.
+ */
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { getParentNode } from "./ast-node.js";
+/**
+ * Unwrap syntax that does not change whether a resource expression is owned.
+ */
+export const getTransparentWrappedExpression = (node) => {
+    if (node.type === AST_NODE_TYPES.AwaitExpression) {
+        return node.argument;
+    }
+    if (node.type === AST_NODE_TYPES.ChainExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSAsExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSNonNullExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSSatisfiesExpression) {
+        return node.expression;
+    }
+    if (node.type === AST_NODE_TYPES.TSTypeAssertion) {
+        return node.expression;
+    }
+    return undefined;
+};
+/**
+ * Resolve a static property name from dot or string-literal member access.
+ */
+export const getStaticPropertyName = (node, computed) => {
+    if (!computed && node.type === AST_NODE_TYPES.Identifier) {
+        return node.name;
+    }
+    if (computed &&
+        node.type === AST_NODE_TYPES.Literal &&
+        typeof node.value === "string") {
+        return node.value;
+    }
+    return undefined;
+};
+/**
+ * Resolve a simple static member path such as `globalThis.URL.createObjectURL`.
+ */
+export const collectStaticMemberPath = (node) => {
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return [node.name];
+    }
+    if (node.type !== AST_NODE_TYPES.MemberExpression || node.optional) {
+        return undefined;
+    }
+    const objectPath = collectStaticMemberPath(node.object);
+    const propertyName = getStaticPropertyName(node.property, node.computed);
+    return objectPath === undefined || propertyName === undefined
+        ? undefined
+        : [...objectPath, propertyName];
+};
+/**
+ * Check whether a resource-producing expression is discarded as a standalone
+ * expression or explicitly voided.
+ */
+export const isDiscardedResourceExpression = (node) => {
+    let current = node;
+    let parent = getParentNode(current);
+    while (parent !== undefined) {
+        const wrappedExpression = getTransparentWrappedExpression(parent);
+        if (wrappedExpression === current) {
+            current = parent;
+            parent = getParentNode(current);
+            continue;
+        }
+        if (parent.type === AST_NODE_TYPES.ExpressionStatement &&
+            parent.expression === current) {
+            return true;
+        }
+        if (parent.type === AST_NODE_TYPES.UnaryExpression &&
+            parent.operator === "void" &&
+            parent.argument === current) {
+            const unaryParent = getParentNode(parent);
+            return unaryParent?.type === AST_NODE_TYPES.ExpressionStatement;
+        }
+        return false;
+    }
+    return false;
+};
+/**
+ * Check whether a resource handle is immediately used as a member receiver
+ * instead of being retained. Cleanup members are excluded so immediate cleanup
+ * calls such as `new AudioContext().close()` are not reported here.
+ */
+export const isImmediateUnownedMemberReceiver = (node, cleanupMemberNames) => {
+    let current = node;
+    let parent = getParentNode(current);
+    while (parent !== undefined) {
+        const wrappedExpression = getTransparentWrappedExpression(parent);
+        if (wrappedExpression === current) {
+            current = parent;
+            parent = getParentNode(current);
+            continue;
+        }
+        if (parent.type !== AST_NODE_TYPES.MemberExpression ||
+            parent.object !== current ||
+            parent.optional) {
+            return false;
+        }
+        const propertyName = getStaticPropertyName(parent.property, parent.computed);
+        return (propertyName === undefined || !cleanupMemberNames.has(propertyName));
+    }
+    return false;
+};
+//# sourceMappingURL=floating-resource.js.map

package/dist/_internal/floating-resource.js.map

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

package/dist/_internal/member-call.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @packageDocumentation
+ * Shared call-expression helpers for matching method calls safely.
+ */
+import { type TSESTree } from "@typescript-eslint/utils";
+/**
+ * Strongly-typed shape for non-computed member calls with identifier receiver
+ * and property (e.g. `Object.keys`).
+ */
+export type IdentifierMemberCallExpression = TSESTree.CallExpression & {
+    callee: TSESTree.MemberExpression & {
+        computed: false;
+        object: TSESTree.Identifier;
+        property: TSESTree.Identifier;
+    };
+};
+/**
+ * Strongly-typed shape for non-computed member calls with identifier property
+ * (e.g. `value.includes`).
+ */
+export type IdentifierPropertyMemberCallExpression = TSESTree.CallExpression & {
+    callee: TSESTree.MemberExpression & {
+        computed: false;
+        object: Exclude<TSESTree.MemberExpression["object"], TSESTree.Super>;
+        property: TSESTree.Identifier;
+    };
+};
+/**
+ * Match `ObjectName.methodName(...)` style calls.
+ *
+ * @param options - Candidate call expression and expected receiver/member
+ *   names.
+ *
+ * @returns Narrowed call expression when the shape matches; otherwise `null`.
+ */
+export declare const getIdentifierMemberCall: (options: Readonly<{
+    memberName: string;
+    node: Readonly<TSESTree.CallExpression>;
+    objectName: string;
+}>) => IdentifierMemberCallExpression | null;
+/**
+ * Match `<expression>.memberName(...)` style calls where the property is a
+ * non-computed identifier.
+ *
+ * @param options - Candidate call expression and expected member name.
+ *
+ * @returns Narrowed call expression when matched; otherwise `null`.
+ */
+export declare const getIdentifierPropertyMemberCall: (options: Readonly<{
+    memberName: string;
+    node: Readonly<TSESTree.CallExpression>;
+}>) => IdentifierPropertyMemberCallExpression | null;
+//# sourceMappingURL=member-call.d.ts.map

package/dist/_internal/member-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-call.d.ts","sourceRoot":"","sources":["../../src/_internal/member-call.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzE;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC,cAAc,GAAG;IACnE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,GAAG;QAChC,QAAQ,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC;QAC5B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;KACjC,CAAC;CACL,CAAC;AACF;;;GAGG;AACH,MAAM,MAAM,sCAAsC,GAAG,QAAQ,CAAC,cAAc,GAAG;IAC3E,MAAM,EAAE,QAAQ,CAAC,gBAAgB,GAAG;QAChC,QAAQ,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;KACjC,CAAC;CACL,CAAC;AAkDF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAChC,SAAS,QAAQ,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC,KACH,8BAA8B,GAAG,IAKnC,CAAC;AACF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GACxC,SAAS,QAAQ,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;CAC3C,CAAC,KACH,sCAAsC,GAAG,IAK3C,CAAC"}

package/dist/_internal/member-call.js

@@ -0,0 +1,61 @@
+/**
+ * @packageDocumentation
+ * Shared call-expression helpers for matching method calls safely.
+ */
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+const isIdentifierMemberCallExpression = (options) => {
+    const { memberName, node, objectName } = options;
+    if (node.optional) {
+        return false;
+    }
+    const { callee } = node;
+    return (callee.type === AST_NODE_TYPES.MemberExpression &&
+        !callee.computed &&
+        !callee.optional &&
+        callee.object.type === AST_NODE_TYPES.Identifier &&
+        callee.object.name === objectName &&
+        callee.property.type === AST_NODE_TYPES.Identifier &&
+        callee.property.name === memberName);
+};
+const isIdentifierPropertyMemberCallExpression = (options) => {
+    const { memberName, node } = options;
+    if (node.optional) {
+        return false;
+    }
+    const { callee } = node;
+    return (callee.type === AST_NODE_TYPES.MemberExpression &&
+        !callee.computed &&
+        !callee.optional &&
+        callee.object.type !== AST_NODE_TYPES.Super &&
+        callee.property.type === AST_NODE_TYPES.Identifier &&
+        callee.property.name === memberName);
+};
+/**
+ * Match `ObjectName.methodName(...)` style calls.
+ *
+ * @param options - Candidate call expression and expected receiver/member
+ *   names.
+ *
+ * @returns Narrowed call expression when the shape matches; otherwise `null`.
+ */
+export const getIdentifierMemberCall = (options) => {
+    if (!isIdentifierMemberCallExpression(options)) {
+        return null;
+    }
+    return options.node;
+};
+/**
+ * Match `<expression>.memberName(...)` style calls where the property is a
+ * non-computed identifier.
+ *
+ * @param options - Candidate call expression and expected member name.
+ *
+ * @returns Narrowed call expression when matched; otherwise `null`.
+ */
+export const getIdentifierPropertyMemberCall = (options) => {
+    if (!isIdentifierPropertyMemberCallExpression(options)) {
+        return null;
+    }
+    return options.node;
+};
+//# sourceMappingURL=member-call.js.map

package/dist/_internal/member-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-call.js","sourceRoot":"","sources":["../../src/_internal/member-call.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAC;AAuBzE,MAAM,gCAAgC,GAAG,CACrC,OAIE,EAKH,EAAE;IACD,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACjD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,OAAO,CACH,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;QAC/C,CAAC,MAAM,CAAC,QAAQ;QAChB,CAAC,MAAM,CAAC,QAAQ;QAChB,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QAChD,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;QACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QAClD,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CACtC,CAAC;AACN,CAAC,CAAC;AACF,MAAM,wCAAwC,GAAG,CAC7C,OAGE,EAIH,EAAE;IACD,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,OAAO,CACH,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;QAC/C,CAAC,MAAM,CAAC,QAAQ;QAChB,CAAC,MAAM,CAAC,QAAQ;QAChB,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,KAAK;QAC3C,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QAClD,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CACtC,CAAC;AACN,CAAC,CAAC;AACF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACnC,OAIE,EACmC,EAAE;IACvC,IAAI,CAAC,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC;AACxB,CAAC,CAAC;AACF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC3C,OAGE,EAC2C,EAAE;IAC/C,IAAI,CAAC,wCAAwC,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC;AACxB,CAAC,CAAC"}

package/dist/_internal/normalize-expression-text.d.ts

@@ -0,0 +1,21 @@
+import type { TSESTree } from "@typescript-eslint/utils";
+/**
+ * Compare two expressions for structural equivalence after unwrapping
+ * transparent TypeScript wrappers.
+ *
+ * @param left - Left-hand expression.
+ * @param right - Right-hand expression.
+ *
+ * @returns `true` when both expressions are structurally equivalent.
+ */
+export declare const areEquivalentExpressions: (left: Readonly<TSESTree.Expression>, right: Readonly<TSESTree.Expression>) => boolean;
+/**
+ * Compare two type nodes for structural equivalence.
+ *
+ * @param left - Left-hand type node.
+ * @param right - Right-hand type node.
+ *
+ * @returns `true` when both type nodes are structurally equivalent.
+ */
+export declare const areEquivalentTypeNodes: (left: Readonly<TSESTree.TypeNode>, right: Readonly<TSESTree.TypeNode>) => boolean;
+//# sourceMappingURL=normalize-expression-text.d.ts.map

package/dist/_internal/normalize-expression-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-expression-text.d.ts","sourceRoot":"","sources":["../../src/_internal/normalize-expression-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAgPzD;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACjC,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACnC,OAAO,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,KACrC,OAIE,CAAC;AAEN;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAC/B,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACjC,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KACnC,OAA+C,CAAC"}

package/dist/_internal/normalize-expression-text.js

@@ -0,0 +1,186 @@
+/**
+ * @packageDocumentation
+ * Structural normalization and equivalence checks for expressions and type
+ * nodes used by safe-fix heuristics.
+ */
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+/**
+ * ESTree metadata keys ignored during structural-equivalence checks.
+ */
+const ignoredPropertyKeys = new Set([
+    "end",
+    "loc",
+    "parent",
+    "range",
+    "start",
+]);
+/**
+ * Maximum recursive depth allowed during structural node-value comparisons.
+ *
+ * @remarks
+ * This guard avoids stack-overflow crashes on pathological, adversarially deep
+ * AST/type structures. Returning `false` in that case preserves lint-process
+ * stability by failing closed for autofix-equivalence checks.
+ */
+const MAX_NODE_VALUE_COMPARISON_DEPTH = 256;
+/**
+ * Check whether a value is object-like for structural comparisons.
+ */
+const isComparableRecord = (value) => typeof value === "object" && value !== null;
+/**
+ * Return stable comparable keys after stripping metadata properties.
+ */
+const getComparableKeys = (value) => Object.keys(value).filter((key) => !ignoredPropertyKeys.has(key));
+/**
+ * Read comparable keys with per-comparison caching to reduce repeated
+ * key-filter allocations during deep traversals.
+ *
+ * @param value - Object candidate being compared.
+ * @param comparableKeysByObject - Per-comparison key cache.
+ *
+ * @returns Comparable key list with ESTree metadata keys removed.
+ */
+const getCachedComparableKeys = (value, comparableKeysByObject) => {
+    const existingComparableKeys = comparableKeysByObject.get(value);
+    if (existingComparableKeys !== undefined) {
+        return existingComparableKeys;
+    }
+    const comparableKeys = getComparableKeys(value);
+    comparableKeysByObject.set(value, comparableKeys);
+    return comparableKeys;
+};
+/**
+ * Unwrap transparent TypeScript expression wrappers.
+ *
+ * @param expression - Expression to normalize.
+ *
+ * @returns The innermost wrapped expression.
+ */
+const unwrapTransparentExpression = (expression) => {
+    let currentExpression = expression;
+    const visitedExpressions = new Set();
+    while (true) {
+        if (visitedExpressions.has(currentExpression)) {
+            return currentExpression;
+        }
+        visitedExpressions.add(currentExpression);
+        if (currentExpression.type === AST_NODE_TYPES.TSAsExpression) {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        if (currentExpression.type === AST_NODE_TYPES.TSNonNullExpression) {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        if (currentExpression.type === AST_NODE_TYPES.TSSatisfiesExpression) {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        if (currentExpression.type === AST_NODE_TYPES.TSTypeAssertion) {
+            currentExpression = currentExpression.expression;
+            continue;
+        }
+        return currentExpression;
+    }
+};
+/**
+ * Records a compared object pair and reports whether that pair was already
+ * visited.
+ *
+ * @param left - Left-side object in the comparison pair.
+ * @param right - Right-side object in the comparison pair.
+ * @param seenPairs - Weakly-held pair-tracking cache for cycle-safe traversal.
+ *
+ * @returns `true` when this exact pair has already been processed.
+ */
+const markAndCheckSeenPair = (left, right, seenPairs) => {
+    const seenRightNodes = seenPairs.get(left);
+    if (seenRightNodes?.has(right) === true) {
+        return true;
+    }
+    if (seenRightNodes === undefined) {
+        seenPairs.set(left, new WeakSet([right]));
+    }
+    else {
+        seenRightNodes.add(right);
+    }
+    return false;
+};
+/**
+ * Deep structural comparison that is resilient to cycles and ESTree metadata
+ * fields.
+ *
+ * @param left - Left-side value.
+ * @param right - Right-side value.
+ * @param seenPairs - Pair cache used to break recursive cycles.
+ *
+ * @returns `true` when the values are structurally equivalent after metadata
+ *   normalization.
+ */
+const areEquivalentNodeValues = (left, right, seenPairs = new WeakMap(), comparableKeysByObject = new WeakMap(), depth = 0) => {
+    if (depth >= MAX_NODE_VALUE_COMPARISON_DEPTH) {
+        return false;
+    }
+    if (Object.is(left, right)) {
+        return true;
+    }
+    if (typeof left !== typeof right) {
+        return false;
+    }
+    if (left === null || right === null) {
+        return false;
+    }
+    if (Array.isArray(left) || Array.isArray(right)) {
+        if (!Array.isArray(left) || !Array.isArray(right)) {
+            return false;
+        }
+        if (markAndCheckSeenPair(left, right, seenPairs)) {
+            return true;
+        }
+        if (left.length !== right.length) {
+            return false;
+        }
+        return left.every((value, index) => areEquivalentNodeValues(value, right[index], seenPairs, comparableKeysByObject, depth + 1));
+    }
+    if (!isComparableRecord(left) || !isComparableRecord(right)) {
+        return false;
+    }
+    if (markAndCheckSeenPair(left, right, seenPairs)) {
+        return true;
+    }
+    const leftKeys = getCachedComparableKeys(left, comparableKeysByObject);
+    const rightKeys = getCachedComparableKeys(right, comparableKeysByObject);
+    const rightKeySet = new Set(rightKeys);
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    if (leftKeys.some((key) => !rightKeySet.has(key))) {
+        return false;
+    }
+    return leftKeys.every((key) => {
+        if (!Object.hasOwn(left, key) || !Object.hasOwn(right, key)) {
+            return false;
+        }
+        return areEquivalentNodeValues(left[key], right[key], seenPairs, comparableKeysByObject, depth + 1);
+    });
+};
+/**
+ * Compare two expressions for structural equivalence after unwrapping
+ * transparent TypeScript wrappers.
+ *
+ * @param left - Left-hand expression.
+ * @param right - Right-hand expression.
+ *
+ * @returns `true` when both expressions are structurally equivalent.
+ */
+export const areEquivalentExpressions = (left, right) => areEquivalentNodeValues(unwrapTransparentExpression(left), unwrapTransparentExpression(right));
+/**
+ * Compare two type nodes for structural equivalence.
+ *
+ * @param left - Left-hand type node.
+ * @param right - Right-hand type node.
+ *
+ * @returns `true` when both type nodes are structurally equivalent.
+ */
+export const areEquivalentTypeNodes = (left, right) => areEquivalentNodeValues(left, right);
+//# sourceMappingURL=normalize-expression-text.js.map

package/dist/_internal/normalize-expression-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-expression-text.js","sourceRoot":"","sources":["../../src/_internal/normalize-expression-text.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D;;GAEG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS;IACxC,KAAK;IACL,KAAK;IACL,QAAQ;IACR,OAAO;IACP,OAAO;CACV,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAE5C;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA6B,EAAE,CACrE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAAuB,EAAqB,EAAE,CACrE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,uBAAuB,GAAG,CAC5B,KAAuB,EACvB,sBAAoE,EACnD,EAAE;IACnB,MAAM,sBAAsB,GAAG,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC;IAClC,CAAC;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChD,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAElD,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAG,CAChC,UAAyC,EACZ,EAAE;IAC/B,IAAI,iBAAiB,GAAG,UAAU,CAAC;IACnC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEpE,OAAO,IAAI,EAAE,CAAC;QACV,IAAI,kBAAkB,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC5C,OAAO,iBAAiB,CAAC;QAC7B,CAAC;QAED,kBAAkB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAE1C,IAAI,iBAAiB,CAAC,IAAI,KAAK,cAAc,CAAC,cAAc,EAAE,CAAC;YAC3D,iBAAiB,GAAG,iBAAiB,CAAC,UAAU,CAAC;YACjD,SAAS;QACb,CAAC;QAED,IAAI,iBAAiB,CAAC,IAAI,KAAK,cAAc,CAAC,mBAAmB,EAAE,CAAC;YAChE,iBAAiB,GAAG,iBAAiB,CAAC,UAAU,CAAC;YACjD,SAAS;QACb,CAAC;QAED,IAAI,iBAAiB,CAAC,IAAI,KAAK,cAAc,CAAC,qBAAqB,EAAE,CAAC;YAClE,iBAAiB,GAAG,iBAAiB,CAAC,UAAU,CAAC;YACjD,SAAS;QACb,CAAC;QAED,IAAI,iBAAiB,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,EAAE,CAAC;YAC5D,iBAAiB,GAAG,iBAAiB,CAAC,UAAU,CAAC;YACjD,SAAS;QACb,CAAC;QAED,OAAO,iBAAiB,CAAC;IAC7B,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,oBAAoB,GAAG,CACzB,IAAY,EACZ,KAAa,EACb,SAA2C,EACpC,EAAE;IACT,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACJ,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,uBAAuB,GAAG,CAC5B,IAAa,EACb,KAAc,EACd,YAA8C,IAAI,OAAO,EAAE,EAC3D,yBAGI,IAAI,OAAO,EAAE,EACjB,KAAK,GAAG,CAAC,EACF,EAAE;IACT,IAAI,KAAK,IAAI,+BAA+B,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,OAAO,KAAK,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAC/B,uBAAuB,CACnB,KAAK,EACL,KAAK,CAAC,KAAK,CAAC,EACZ,SAAS,EACT,sBAAsB,EACtB,KAAK,GAAG,CAAC,CACZ,CACJ,CAAC;IACN,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvC,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAC1D,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,uBAAuB,CAC1B,IAAI,CAAC,GAAG,CAAC,EACT,KAAK,CAAC,GAAG,CAAC,EACV,SAAS,EACT,sBAAsB,EACtB,KAAK,GAAG,CAAC,CACZ,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACpC,IAAmC,EACnC,KAAoC,EAC7B,EAAE,CACT,uBAAuB,CACnB,2BAA2B,CAAC,IAAI,CAAC,EACjC,2BAA2B,CAAC,KAAK,CAAC,CACrC,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAClC,IAAiC,EACjC,KAAkC,EAC3B,EAAE,CAAC,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC"}

package/dist/_internal/nullish-comparison.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @packageDocumentation
+ * Shared helpers for parsing and flattening nullish comparison expressions.
+ */
+import type { TSESTree } from "@typescript-eslint/utils";
+/**
+ * Normalized representation of one binary comparison against null/undefined.
+ */
+type NullishComparison = Readonly<{
+    comparedExpression: TSESTree.Expression;
+    kind: NullishComparisonKind;
+    operator: NullishComparisonOperator;
+}>;
+/** Nullish literal kinds supported by comparison extraction. */
+type NullishComparisonKind = "null" | "undefined";
+/** Operators supported by nullish comparison extraction. */
+type NullishComparisonOperator = "!=" | "!==" | "==" | "===";
+/**
+ * Flatten a logical-expression tree for one specific operator.
+ *
+ * @param options - Expression and logical operator to flatten.
+ *
+ * @returns Left-to-right list of terms participating in that operator chain.
+ */
+export declare const flattenLogicalTerms: ({ expression, operator, }: Readonly<{
+    expression: Readonly<TSESTree.Expression>;
+    operator: "&&" | "||";
+}>) => readonly TSESTree.Expression[];
+/**
+ * Narrow a list of expressions to an exact two-term tuple.
+ */
+export declare const isExpressionPair: (terms: readonly Readonly<TSESTree.Expression>[]) => terms is readonly [TSESTree.Expression, TSESTree.Expression];
+/**
+ * Extract a normalized nullish comparison from an expression.
+ */
+export declare const getNullishComparison: ({ allowedOperators, allowTypeofComparedIdentifierForUndefined, comparedIdentifierName, expression, isGlobalUndefinedIdentifier, }: Readonly<{
+    allowedOperators?: readonly NullishComparisonOperator[];
+    allowTypeofComparedIdentifierForUndefined?: boolean;
+    comparedIdentifierName?: string;
+    expression: Readonly<TSESTree.Expression>;
+    isGlobalUndefinedIdentifier: (expression: Readonly<TSESTree.Expression>) => boolean;
+}>) => null | NullishComparison;
+export {};
+//# sourceMappingURL=nullish-comparison.d.ts.map