eslint-plugin-runtime-cleanup 1.2.8

package/dist/rules/no-floating-audio-contexts.js.map

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

package/dist/rules/no-floating-broadcast-channels.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @packageDocumentation
+ * Require BroadcastChannel handles to be retained so they can be closed.
+ */
+import { type TSESLint } from "@typescript-eslint/utils";
+/** Rule implementation for `runtime-cleanup/no-floating-broadcast-channels`. */
+declare const noFloatingBroadcastChannels: TSESLint.RuleModule<"floatingBroadcastChannel", readonly []>;
+export default noFloatingBroadcastChannels;
+//# sourceMappingURL=no-floating-broadcast-channels.d.ts.map

package/dist/rules/no-floating-broadcast-channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-broadcast-channels.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-broadcast-channels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAsLlC,gFAAgF;AAChF,QAAA,MAAM,2BAA2B,EAAE,QAAQ,CAAC,UAAU,CAClD,0BAA0B,EAC1B,SAAS,EAAE,CA2Cb,CAAC;AAEH,eAAe,2BAA2B,CAAC"}

package/dist/rules/no-floating-broadcast-channels.js

@@ -0,0 +1,151 @@
+/**
+ * @packageDocumentation
+ * Require BroadcastChannel handles to be retained so they can be closed.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { getParentNode } from "../_internal/ast-node.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { getVariableInScopeChain } from "../_internal/scope-variable.js";
+import { createTypedRule, } from "../_internal/typed-rule.js";
+const broadcastChannelConstructorName = "BroadcastChannel";
+const globalReceiverNames = [
+    "globalThis",
+    "self",
+    "window",
+];
+const globalReceiverNameSet = new Set(globalReceiverNames);
+const isGlobalReceiverName = (name) => globalReceiverNameSet.has(name);
+const getTransparentWrappedExpression = (node) => {
+    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;
+};
+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;
+};
+const isShadowedBroadcastChannelIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const isDirectBroadcastChannelConstructor = (context, callee) => callee.type === AST_NODE_TYPES.Identifier &&
+    callee.name === broadcastChannelConstructorName &&
+    !isShadowedBroadcastChannelIdentifier(context, callee);
+const isMemberBroadcastChannelConstructor = (callee) => callee.type === AST_NODE_TYPES.MemberExpression &&
+    !callee.optional &&
+    callee.object.type === AST_NODE_TYPES.Identifier &&
+    isGlobalReceiverName(callee.object.name) &&
+    getStaticPropertyName(callee.property, callee.computed) ===
+        broadcastChannelConstructorName;
+const isBroadcastChannelConstructor = (context, callee) => isDirectBroadcastChannelConstructor(context, callee) ||
+    isMemberBroadcastChannelConstructor(callee);
+const isDiscardedBroadcastChannel = (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;
+};
+const isImmediateBroadcastChannelMethodReceiver = (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.MemberExpression ||
+            parent.object !== current ||
+            parent.optional) {
+            return false;
+        }
+        if (getStaticPropertyName(parent.property, parent.computed) === "close") {
+            return false;
+        }
+        const callExpression = getParentNode(parent);
+        return (callExpression?.type === AST_NODE_TYPES.CallExpression &&
+            callExpression.callee === parent);
+    }
+    return false;
+};
+/** Rule implementation for `runtime-cleanup/no-floating-broadcast-channels`. */
+const noFloatingBroadcastChannels = createTypedRule({
+    create(context) {
+        return {
+            NewExpression(node) {
+                if (!isBroadcastChannelConstructor(context, node.callee) ||
+                    (!isDiscardedBroadcastChannel(node) &&
+                        !isImmediateBroadcastChannelMethodReceiver(node))) {
+                    return;
+                }
+                context.report({
+                    messageId: "floatingBroadcastChannel",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require BroadcastChannel handles to be retained so they can be closed.",
+            recommended: true,
+            requiresTypeChecking: false,
+            runtimeCleanupConfigs: [
+                "runtime-cleanup.configs.recommended",
+                "runtime-cleanup.configs.recommended-type-checked",
+                "runtime-cleanup.configs.strict",
+                "runtime-cleanup.configs.all",
+            ],
+            url: createRuleDocsUrl("no-floating-broadcast-channels"),
+        },
+        messages: {
+            floatingBroadcastChannel: "Store or return the BroadcastChannel handle so close() can release the channel during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-broadcast-channels",
+});
+export default noFloatingBroadcastChannels;
+//# sourceMappingURL=no-floating-broadcast-channels.js.map

package/dist/rules/no-floating-broadcast-channels.js.map

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

package/dist/rules/no-floating-child-processes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @packageDocumentation
+ * Require child process handles to be retained so they can be killed during cleanup.
+ */
+import { type TSESLint } from "@typescript-eslint/utils";
+/** Rule implementation for `runtime-cleanup/no-floating-child-processes`. */
+declare const noFloatingChildProcesses: TSESLint.RuleModule<"floatingChildProcess", readonly []>;
+export default noFloatingChildProcesses;
+//# sourceMappingURL=no-floating-child-processes.d.ts.map

package/dist/rules/no-floating-child-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-child-processes.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-child-processes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAsWlC,6EAA6E;AAC7E,QAAA,MAAM,wBAAwB,EAAE,QAAQ,CAAC,UAAU,CAC/C,sBAAsB,EACtB,SAAS,EAAE,CAiDb,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/rules/no-floating-child-processes.js

@@ -0,0 +1,259 @@
+/**
+ * @packageDocumentation
+ * Require child process handles to be retained so they can be killed during cleanup.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { getParentNode } from "../_internal/ast-node.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { getVariableInScopeChain } from "../_internal/scope-variable.js";
+import { createTypedRule, } from "../_internal/typed-rule.js";
+const childProcessFactoryNames = [
+    "exec",
+    "execFile",
+    "fork",
+    "spawn",
+];
+const childProcessModuleNames = [
+    "child_process",
+    "node:child_process",
+];
+const immediateCleanupMethodNames = [
+    "disconnect",
+    "kill",
+];
+const childProcessFactoryNameSet = new Set(childProcessFactoryNames);
+const childProcessModuleNameSet = new Set(childProcessModuleNames);
+const immediateCleanupMethodNameSet = new Set(immediateCleanupMethodNames);
+const isChildProcessFactoryName = (name) => childProcessFactoryNameSet.has(name);
+const isImmediateCleanupMethodName = (name) => immediateCleanupMethodNameSet.has(name);
+const getTransparentWrappedExpression = (node) => {
+    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;
+};
+const getStaticPropertyName = (node) => {
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return node.name;
+    }
+    if (node.type === AST_NODE_TYPES.Literal &&
+        typeof node.value === "string") {
+        return node.value;
+    }
+    return undefined;
+};
+const getImportSourceValue = (node) => {
+    const parent = getParentNode(node);
+    if (parent?.type === AST_NODE_TYPES.ImportDeclaration &&
+        typeof parent.source.value === "string") {
+        return parent.source.value;
+    }
+    return undefined;
+};
+const getRequireSourceValue = (expression) => {
+    if (expression?.type !== AST_NODE_TYPES.CallExpression ||
+        expression.callee.type !== AST_NODE_TYPES.Identifier ||
+        expression.callee.name !== "require") {
+        return undefined;
+    }
+    const [source] = expression.arguments;
+    return source?.type === AST_NODE_TYPES.Literal &&
+        typeof source.value === "string"
+        ? source.value
+        : undefined;
+};
+const getDefinitionModuleSource = (node) => {
+    if (node.type === AST_NODE_TYPES.ImportDefaultSpecifier ||
+        node.type === AST_NODE_TYPES.ImportNamespaceSpecifier ||
+        node.type === AST_NODE_TYPES.ImportSpecifier) {
+        return getImportSourceValue(node);
+    }
+    if (node.type === AST_NODE_TYPES.VariableDeclarator) {
+        return getRequireSourceValue(node.init);
+    }
+    return undefined;
+};
+const getImportedSpecifierName = (node) => getStaticPropertyName(node.imported);
+const getObjectPatternPropertyNameForIdentifier = (objectPattern, identifierName) => {
+    for (const property of objectPattern.properties) {
+        if (property.type !== AST_NODE_TYPES.Property ||
+            property.value.type !== AST_NODE_TYPES.Identifier ||
+            property.value.name !== identifierName) {
+            continue;
+        }
+        return getStaticPropertyName(property.key);
+    }
+    return undefined;
+};
+const isChildProcessModuleSource = (source) => source !== undefined && childProcessModuleNameSet.has(source);
+const getDefinitionForIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable?.defs[0];
+};
+const isChildProcessModuleBinding = (context, identifier) => {
+    const definition = getDefinitionForIdentifier(context, identifier);
+    if (definition === undefined) {
+        return false;
+    }
+    return isChildProcessModuleSource(getDefinitionModuleSource(definition.node));
+};
+const getNamedChildProcessFactoryBindingName = (context, identifier) => {
+    const definition = getDefinitionForIdentifier(context, identifier);
+    if (definition === undefined) {
+        return undefined;
+    }
+    const source = getDefinitionModuleSource(definition.node);
+    if (!isChildProcessModuleSource(source)) {
+        return undefined;
+    }
+    if (definition.node.type === AST_NODE_TYPES.ImportSpecifier) {
+        const importedName = getImportedSpecifierName(definition.node);
+        return importedName !== undefined &&
+            isChildProcessFactoryName(importedName)
+            ? importedName
+            : undefined;
+    }
+    if (definition.node.type === AST_NODE_TYPES.VariableDeclarator &&
+        definition.node.id.type === AST_NODE_TYPES.ObjectPattern) {
+        const propertyName = getObjectPatternPropertyNameForIdentifier(definition.node.id, identifier.name);
+        return propertyName !== undefined &&
+            isChildProcessFactoryName(propertyName)
+            ? propertyName
+            : undefined;
+    }
+    return undefined;
+};
+const getRequireMemberFactoryName = (callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression ||
+        callee.computed ||
+        callee.optional ||
+        callee.property.type !== AST_NODE_TYPES.Identifier ||
+        !isChildProcessFactoryName(callee.property.name) ||
+        callee.object.type !== AST_NODE_TYPES.CallExpression ||
+        !isChildProcessModuleSource(getRequireSourceValue(callee.object))) {
+        return undefined;
+    }
+    return callee.property.name;
+};
+const getModuleMemberFactoryName = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression ||
+        callee.computed ||
+        callee.optional ||
+        callee.object.type !== AST_NODE_TYPES.Identifier ||
+        callee.property.type !== AST_NODE_TYPES.Identifier ||
+        !isChildProcessFactoryName(callee.property.name) ||
+        !isChildProcessModuleBinding(context, callee.object)) {
+        return undefined;
+    }
+    return callee.property.name;
+};
+const getChildProcessFactoryName = (context, callee) => {
+    if (callee.type === AST_NODE_TYPES.Identifier) {
+        return getNamedChildProcessFactoryBindingName(context, callee);
+    }
+    return (getModuleMemberFactoryName(context, callee) ??
+        getRequireMemberFactoryName(callee));
+};
+const isDiscardedChildProcessHandle = (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;
+};
+const isImmediateChildProcessMethodReceiver = (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.MemberExpression ||
+            parent.object !== current ||
+            parent.computed ||
+            parent.property.type !== AST_NODE_TYPES.Identifier ||
+            isImmediateCleanupMethodName(parent.property.name)) {
+            return false;
+        }
+        const callExpression = getParentNode(parent);
+        return (callExpression?.type === AST_NODE_TYPES.CallExpression &&
+            callExpression.callee === parent);
+    }
+    return false;
+};
+/** Rule implementation for `runtime-cleanup/no-floating-child-processes`. */
+const noFloatingChildProcesses = createTypedRule({
+    create(context) {
+        return {
+            CallExpression(node) {
+                const factoryName = getChildProcessFactoryName(context, node.callee);
+                if (factoryName === undefined ||
+                    (!isDiscardedChildProcessHandle(node) &&
+                        !isImmediateChildProcessMethodReceiver(node))) {
+                    return;
+                }
+                context.report({
+                    data: { factoryName },
+                    messageId: "floatingChildProcess",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require child process handles to be retained so they can be killed during cleanup.",
+            recommended: true,
+            requiresTypeChecking: false,
+            runtimeCleanupConfigs: [
+                "runtime-cleanup.configs.recommended",
+                "runtime-cleanup.configs.recommended-type-checked",
+                "runtime-cleanup.configs.strict",
+                "runtime-cleanup.configs.all",
+            ],
+            url: createRuleDocsUrl("no-floating-child-processes"),
+        },
+        messages: {
+            floatingChildProcess: "Store or return the child process handle from {{factoryName}} so it can be killed during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-child-processes",
+});
+export default noFloatingChildProcesses;
+//# sourceMappingURL=no-floating-child-processes.js.map

package/dist/rules/no-floating-child-processes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-child-processes.js","sourceRoot":"","sources":["../../src/rules/no-floating-child-processes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACH,cAAc,GAGjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EACH,eAAe,GAElB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,wBAAwB,GAAG;IAC7B,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;CACD,CAAC;AACX,MAAM,uBAAuB,GAAG;IAC5B,eAAe;IACf,oBAAoB;CACd,CAAC;AACX,MAAM,2BAA2B,GAAG;IAChC,YAAY;IACZ,MAAM;CACA,CAAC;AAIX,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAC3D,wBAAwB,CAC3B,CAAC;AACF,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAC1D,uBAAuB,CAC1B,CAAC;AACF,MAAM,6BAA6B,GAAwB,IAAI,GAAG,CAC9D,2BAA2B,CAC9B,CAAC;AAEF,MAAM,yBAAyB,GAAG,CAC9B,IAAY,EACmB,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAE3E,MAAM,4BAA4B,GAAG,CAAC,IAAY,EAAW,EAAE,CAC3D,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAE5C,MAAM,+BAA+B,GAAG,CACpC,IAA6B,EACM,EAAE;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,cAAc,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,mBAAmB,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,qBAAqB,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC1B,IAAqC,EACnB,EAAE;IACpB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,IACI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO;QACpC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAChC,CAAC;QACC,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CACzB,IAA6B,EACX,EAAE;IACpB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEnC,IACI,MAAM,EAAE,IAAI,KAAK,cAAc,CAAC,iBAAiB;QACjD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,EACzC,CAAC;QACC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC1B,UAAgD,EAC9B,EAAE;IACpB,IACI,UAAU,EAAE,IAAI,KAAK,cAAc,CAAC,cAAc;QAClD,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QACpD,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,EACtC,CAAC;QACC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC;IAEtC,OAAO,MAAM,EAAE,IAAI,KAAK,cAAc,CAAC,OAAO;QAC1C,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAChC,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,CAC9B,IAA6B,EACX,EAAE;IACpB,IACI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,sBAAsB;QACnD,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,wBAAwB;QACrD,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,EAC9C,CAAC;QACC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,kBAAkB,EAAE,CAAC;QAClD,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC7B,IAAwC,EACtB,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAE9D,MAAM,yCAAyC,GAAG,CAC9C,aAA+C,EAC/C,cAAsB,EACJ,EAAE;IACpB,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,UAAU,EAAE,CAAC;QAC9C,IACI,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,QAAQ;YACzC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;YACjD,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,EACxC,CAAC;YACC,SAAS;QACb,CAAC;QAED,OAAO,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,MAA0B,EAAW,EAAE,CACvE,MAAM,KAAK,SAAS,IAAI,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,0BAA0B,GAAG,CAC/B,OAAyB,EACzB,UAAyC,EAC3C,EAAE;IACA,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjE,OAAO,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAChC,OAAyB,EACzB,UAAyC,EAClC,EAAE;IACT,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEnE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,0BAA0B,CAC7B,yBAAyB,CAAC,UAAU,CAAC,IAAI,CAAC,CAC7C,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,sCAAsC,GAAG,CAC3C,OAAyB,EACzB,UAAyC,EACN,EAAE;IACrC,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEnE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAE1D,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,wBAAwB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE/D,OAAO,YAAY,KAAK,SAAS;YAC7B,yBAAyB,CAAC,YAAY,CAAC;YACvC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,SAAS,CAAC;IACpB,CAAC;IAED,IACI,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,kBAAkB;QAC1D,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa,EAC1D,CAAC;QACC,MAAM,YAAY,GAAG,yCAAyC,CAC1D,UAAU,CAAC,IAAI,CAAC,EAAE,EAClB,UAAU,CAAC,IAAI,CAClB,CAAC;QAEF,OAAO,YAAY,KAAK,SAAS;YAC7B,yBAAyB,CAAC,YAAY,CAAC;YACvC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,SAAS,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAChC,MAAmD,EAChB,EAAE;IACrC,IACI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;QAC/C,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QAClD,CAAC,yBAAyB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,cAAc;QACpD,CAAC,0BAA0B,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EACnE,CAAC;QACC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAC/B,OAAyB,EACzB,MAAmD,EAChB,EAAE;IACrC,IACI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;QAC/C,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QAChD,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;QAClD,CAAC,yBAAyB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChD,CAAC,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EACtD,CAAC;QACC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAC/B,OAAyB,EACzB,MAAmD,EAChB,EAAE;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO,sCAAsC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,CACH,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC;QAC3C,2BAA2B,CAAC,MAAM,CAAC,CACtC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAClC,IAAuC,EAChC,EAAE;IACT,IAAI,OAAO,GAA4B,IAAI,CAAC;IAC5C,IAAI,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,iBAAiB,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,iBAAiB,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,GAAG,MAAM,CAAC;YACjB,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAChC,SAAS;QACb,CAAC;QAED,IACI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,mBAAmB;YAClD,MAAM,CAAC,UAAU,KAAK,OAAO,EAC/B,CAAC;YACC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IACI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe;YAC9C,MAAM,CAAC,QAAQ,KAAK,MAAM;YAC1B,MAAM,CAAC,QAAQ,KAAK,OAAO,EAC7B,CAAC;YACC,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YAE1C,OAAO,WAAW,EAAE,IAAI,KAAK,cAAc,CAAC,mBAAmB,CAAC;QACpE,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,qCAAqC,GAAG,CAC1C,IAAuC,EAChC,EAAE;IACT,IAAI,OAAO,GAA4B,IAAI,CAAC;IAC5C,IAAI,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,iBAAiB,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,iBAAiB,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,GAAG,MAAM,CAAC;YACjB,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAChC,SAAS;QACb,CAAC;QAED,IACI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;YAC/C,MAAM,CAAC,MAAM,KAAK,OAAO;YACzB,MAAM,CAAC,QAAQ;YACf,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU;YAClD,4BAA4B,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EACpD,CAAC;YACC,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAE7C,OAAO,CACH,cAAc,EAAE,IAAI,KAAK,cAAc,CAAC,cAAc;YACtD,cAAc,CAAC,MAAM,KAAK,MAAM,CACnC,CAAC;IACN,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,wBAAwB,GAG1B,eAAe,CAAC;IAChB,MAAM,CAAC,OAAO;QACV,OAAO;YACH,cAAc,CAAC,IAAuC;gBAClD,MAAM,WAAW,GAAG,0BAA0B,CAC1C,OAAO,EACP,IAAI,CAAC,MAAM,CACd,CAAC;gBAEF,IACI,WAAW,KAAK,SAAS;oBACzB,CAAC,CAAC,6BAA6B,CAAC,IAAI,CAAC;wBACjC,CAAC,qCAAqC,CAAC,IAAI,CAAC,CAAC,EACnD,CAAC;oBACC,OAAO;gBACX,CAAC;gBAED,OAAO,CAAC,MAAM,CAAC;oBACX,IAAI,EAAE,EAAE,WAAW,EAAE;oBACrB,SAAS,EAAE,sBAAsB;oBACjC,IAAI;iBACP,CAAC,CAAC;YACP,CAAC;SACJ,CAAC;IACN,CAAC;IACD,cAAc,EAAE,EAAE;IAClB,IAAI,EAAE;QACF,IAAI,EAAE;YACF,WAAW,EACP,oFAAoF;YACxF,WAAW,EAAE,IAAI;YACjB,oBAAoB,EAAE,KAAK;YAC3B,qBAAqB,EAAE;gBACnB,qCAAqC;gBACrC,kDAAkD;gBAClD,gCAAgC;gBAChC,6BAA6B;aAChC;YACD,GAAG,EAAE,iBAAiB,CAAC,6BAA6B,CAAC;SACxD;QACD,QAAQ,EAAE;YACN,oBAAoB,EAChB,mGAAmG;SAC1G;QACD,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,6BAA6B;CACtC,CAAC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/rules/no-floating-disposable-stacks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @packageDocumentation
+ * Require DisposableStack handles to be retained so registered disposers run.
+ */
+import { type TSESLint } from "@typescript-eslint/utils";
+/** Rule implementation for `runtime-cleanup/no-floating-disposable-stacks`. */
+declare const noFloatingDisposableStacks: TSESLint.RuleModule<"floatingDisposableStack", readonly []>;
+export default noFloatingDisposableStacks;
+//# sourceMappingURL=no-floating-disposable-stacks.d.ts.map

package/dist/rules/no-floating-disposable-stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-disposable-stacks.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-disposable-stacks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAmOlC,+EAA+E;AAC/E,QAAA,MAAM,0BAA0B,EAAE,QAAQ,CAAC,UAAU,CACjD,yBAAyB,EACzB,SAAS,EAAE,CAiDb,CAAC;AAEH,eAAe,0BAA0B,CAAC"}

package/dist/rules/no-floating-disposable-stacks.js

@@ -0,0 +1,177 @@
+/**
+ * @packageDocumentation
+ * Require DisposableStack handles to be retained so registered disposers run.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { getParentNode } from "../_internal/ast-node.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { getVariableInScopeChain } from "../_internal/scope-variable.js";
+import { createTypedRule, } from "../_internal/typed-rule.js";
+const disposableStackConstructorNames = [
+    "AsyncDisposableStack",
+    "DisposableStack",
+];
+const cleanupMethodNames = [
+    "dispose",
+    "disposeAsync",
+];
+const globalReceiverNames = [
+    "globalThis",
+    "self",
+    "window",
+];
+const disposableStackConstructorNameSet = new Set(disposableStackConstructorNames);
+const cleanupMethodNameSet = new Set(cleanupMethodNames);
+const globalReceiverNameSet = new Set(globalReceiverNames);
+const isDisposableStackConstructorName = (name) => disposableStackConstructorNameSet.has(name);
+const isCleanupMethodName = (name) => cleanupMethodNameSet.has(name);
+const isGlobalReceiverName = (name) => globalReceiverNameSet.has(name);
+const getTransparentWrappedExpression = (node) => {
+    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;
+};
+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;
+};
+const isShadowedDisposableStackIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const getDirectDisposableStackConstructorName = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.Identifier ||
+        !isDisposableStackConstructorName(callee.name) ||
+        isShadowedDisposableStackIdentifier(context, callee)) {
+        return undefined;
+    }
+    return callee.name;
+};
+const getMemberDisposableStackConstructorName = (callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression ||
+        callee.optional ||
+        callee.object.type !== AST_NODE_TYPES.Identifier ||
+        !isGlobalReceiverName(callee.object.name)) {
+        return undefined;
+    }
+    const constructorName = getStaticPropertyName(callee.property, callee.computed);
+    return constructorName !== undefined &&
+        isDisposableStackConstructorName(constructorName)
+        ? constructorName
+        : undefined;
+};
+const getDisposableStackConstructorName = (context, callee) => getDirectDisposableStackConstructorName(context, callee) ??
+    getMemberDisposableStackConstructorName(callee);
+const isDiscardedDisposableStack = (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;
+};
+const isImmediateDisposableStackMethodReceiver = (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.MemberExpression ||
+            parent.object !== current ||
+            parent.optional) {
+            return false;
+        }
+        const methodName = getStaticPropertyName(parent.property, parent.computed);
+        if (methodName === undefined || isCleanupMethodName(methodName)) {
+            return false;
+        }
+        const callExpression = getParentNode(parent);
+        return (callExpression?.type === AST_NODE_TYPES.CallExpression &&
+            callExpression.callee === parent);
+    }
+    return false;
+};
+/** Rule implementation for `runtime-cleanup/no-floating-disposable-stacks`. */
+const noFloatingDisposableStacks = createTypedRule({
+    create(context) {
+        return {
+            NewExpression(node) {
+                const constructorName = getDisposableStackConstructorName(context, node.callee);
+                if (constructorName === undefined ||
+                    (!isDiscardedDisposableStack(node) &&
+                        !isImmediateDisposableStackMethodReceiver(node))) {
+                    return;
+                }
+                context.report({
+                    data: { constructorName },
+                    messageId: "floatingDisposableStack",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require DisposableStack handles to be retained so registered disposers run.",
+            recommended: true,
+            requiresTypeChecking: false,
+            runtimeCleanupConfigs: [
+                "runtime-cleanup.configs.recommended",
+                "runtime-cleanup.configs.recommended-type-checked",
+                "runtime-cleanup.configs.strict",
+                "runtime-cleanup.configs.all",
+            ],
+            url: createRuleDocsUrl("no-floating-disposable-stacks"),
+        },
+        messages: {
+            floatingDisposableStack: "Store, return, or use the {{constructorName}} handle so registered disposers run during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-disposable-stacks",
+});
+export default noFloatingDisposableStacks;
+//# sourceMappingURL=no-floating-disposable-stacks.js.map