eslint-plugin-runtime-cleanup 1.2.8

package/dist/rules/no-floating-media-streams.js

@@ -0,0 +1,175 @@
+/**
+ * @packageDocumentation
+ * Require captured MediaStream handles to be retained so their tracks can be stopped.
+ */
+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 mediaCaptureFunctionNames = [
+    "getDisplayMedia",
+    "getUserMedia",
+];
+const globalNavigatorReceiverNames = ["globalThis", "window"];
+const mediaCaptureFunctionNameSet = new Set(mediaCaptureFunctionNames);
+const globalNavigatorReceiverNameSet = new Set(globalNavigatorReceiverNames);
+const isMediaCaptureFunctionName = (name) => mediaCaptureFunctionNameSet.has(name);
+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;
+};
+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 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];
+};
+const isShadowedNavigatorIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const getRootIdentifier = (node) => {
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return node;
+    }
+    return node.type === AST_NODE_TYPES.MemberExpression
+        ? getRootIdentifier(node.object)
+        : undefined;
+};
+const isNavigatorPathShadowed = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression) {
+        return false;
+    }
+    const rootIdentifier = getRootIdentifier(callee.object);
+    return (rootIdentifier?.name === "navigator" &&
+        isShadowedNavigatorIdentifier(context, rootIdentifier));
+};
+const getMediaCaptureNameFromPath = (path) => {
+    const captureName = path.at(-1);
+    if (captureName === undefined || !isMediaCaptureFunctionName(captureName)) {
+        return undefined;
+    }
+    if (path.length === 3 &&
+        path[0] === "navigator" &&
+        path[1] === "mediaDevices") {
+        return captureName;
+    }
+    if (path.length === 4 &&
+        globalNavigatorReceiverNameSet.has(path[0] ?? "") &&
+        path[1] === "navigator" &&
+        path[2] === "mediaDevices") {
+        return captureName;
+    }
+    return undefined;
+};
+const getMediaCaptureFunctionName = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression ||
+        isNavigatorPathShadowed(context, callee)) {
+        return undefined;
+    }
+    const path = collectStaticMemberPath(callee);
+    return path === undefined ? undefined : getMediaCaptureNameFromPath(path);
+};
+const isDiscardedMediaStreamRequest = (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;
+};
+/** Rule implementation for `runtime-cleanup/no-floating-media-streams`. */
+const noFloatingMediaStreams = createTypedRule({
+    create(context) {
+        return {
+            CallExpression(node) {
+                const captureName = getMediaCaptureFunctionName(context, node.callee);
+                if (captureName === undefined ||
+                    !isDiscardedMediaStreamRequest(node)) {
+                    return;
+                }
+                context.report({
+                    data: { captureName },
+                    messageId: "floatingMediaStream",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require captured MediaStream handles to be retained so their tracks can be stopped.",
+            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-media-streams"),
+        },
+        messages: {
+            floatingMediaStream: "Store or return the MediaStream from {{captureName}} so its tracks can be stopped during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-media-streams",
+});
+export default noFloatingMediaStreams;
+//# sourceMappingURL=no-floating-media-streams.js.map

package/dist/rules/no-floating-media-streams.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-message-channels.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-message-channels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAyLlC,8EAA8E;AAC9E,QAAA,MAAM,yBAAyB,EAAE,QAAQ,CAAC,UAAU,CAChD,wBAAwB,EACxB,SAAS,EAAE,CA2Cb,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

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

@@ -0,0 +1,150 @@
+/**
+ * @packageDocumentation
+ * Require MessageChannel ports 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 messageChannelConstructorName = "MessageChannel";
+const messagePortPropertyNames = ["port1", "port2"];
+const globalReceiverNames = [
+    "globalThis",
+    "self",
+    "window",
+];
+const globalReceiverNameSet = new Set(globalReceiverNames);
+const messagePortPropertyNameSet = new Set(messagePortPropertyNames);
+const isGlobalReceiverName = (name) => globalReceiverNameSet.has(name);
+const isMessagePortPropertyName = (name) => messagePortPropertyNameSet.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 isShadowedMessageChannelIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const isDirectMessageChannelConstructor = (context, callee) => callee.type === AST_NODE_TYPES.Identifier &&
+    callee.name === messageChannelConstructorName &&
+    !isShadowedMessageChannelIdentifier(context, callee);
+const isMemberMessageChannelConstructor = (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) ===
+        messageChannelConstructorName;
+const isMessageChannelConstructor = (context, callee) => isDirectMessageChannelConstructor(context, callee) ||
+    isMemberMessageChannelConstructor(callee);
+const isDiscardedMessageChannel = (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 isImmediateMessagePortAccess = (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 propertyName = getStaticPropertyName(parent.property, parent.computed);
+        return (propertyName !== undefined && isMessagePortPropertyName(propertyName));
+    }
+    return false;
+};
+/** Rule implementation for `runtime-cleanup/no-floating-message-channels`. */
+const noFloatingMessageChannels = createTypedRule({
+    create(context) {
+        return {
+            NewExpression(node) {
+                if (!isMessageChannelConstructor(context, node.callee) ||
+                    (!isDiscardedMessageChannel(node) &&
+                        !isImmediateMessagePortAccess(node))) {
+                    return;
+                }
+                context.report({
+                    messageId: "floatingMessageChannel",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require MessageChannel ports 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-message-channels"),
+        },
+        messages: {
+            floatingMessageChannel: "Store or return the MessageChannel handle or both MessagePort handles so the ports can be closed during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-message-channels",
+});
+export default noFloatingMessageChannels;
+//# sourceMappingURL=no-floating-message-channels.js.map

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

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

package/dist/rules/no-floating-network-connections.d.ts

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

package/dist/rules/no-floating-network-connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-network-connections.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-network-connections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAwNlC,iFAAiF;AACjF,QAAA,MAAM,4BAA4B,EAAE,QAAQ,CAAC,UAAU,CACnD,2BAA2B,EAC3B,SAAS,EAAE,CAiDb,CAAC;AAEH,eAAe,4BAA4B,CAAC"}

package/dist/rules/no-floating-network-connections.js

@@ -0,0 +1,170 @@
+/**
+ * @packageDocumentation
+ * Require browser network connection 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 networkConnectionConstructorNames = [
+    "EventSource",
+    "WebSocket",
+];
+const globalReceiverNames = [
+    "globalThis",
+    "self",
+    "window",
+];
+const networkConnectionConstructorNameSet = new Set(networkConnectionConstructorNames);
+const globalReceiverNameSet = new Set(globalReceiverNames);
+const isNetworkConnectionConstructorName = (name) => networkConnectionConstructorNameSet.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 isShadowedNetworkConnectionIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const getDirectNetworkConnectionConstructorName = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.Identifier ||
+        !isNetworkConnectionConstructorName(callee.name) ||
+        isShadowedNetworkConnectionIdentifier(context, callee)) {
+        return undefined;
+    }
+    return callee.name;
+};
+const getMemberNetworkConnectionConstructorName = (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 &&
+        isNetworkConnectionConstructorName(constructorName)
+        ? constructorName
+        : undefined;
+};
+const getNetworkConnectionConstructorName = (context, callee) => getDirectNetworkConnectionConstructorName(context, callee) ??
+    getMemberNetworkConnectionConstructorName(callee);
+const isDiscardedNetworkConnection = (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 isImmediateNetworkConnectionMethodReceiver = (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-network-connections`. */
+const noFloatingNetworkConnections = createTypedRule({
+    create(context) {
+        return {
+            NewExpression(node) {
+                const connectionName = getNetworkConnectionConstructorName(context, node.callee);
+                if (connectionName === undefined ||
+                    (!isDiscardedNetworkConnection(node) &&
+                        !isImmediateNetworkConnectionMethodReceiver(node))) {
+                    return;
+                }
+                context.report({
+                    data: { connectionName },
+                    messageId: "floatingNetworkConnection",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require browser network connection 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-network-connections"),
+        },
+        messages: {
+            floatingNetworkConnection: "Store or return the {{connectionName}} handle so close() can release the connection during cleanup.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-network-connections",
+});
+export default noFloatingNetworkConnections;
+//# sourceMappingURL=no-floating-network-connections.js.map

package/dist/rules/no-floating-network-connections.js.map

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

package/dist/rules/no-floating-object-urls.d.ts

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

package/dist/rules/no-floating-object-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-floating-object-urls.d.ts","sourceRoot":"","sources":["../../src/rules/no-floating-object-urls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEH,KAAK,QAAQ,EAEhB,MAAM,0BAA0B,CAAC;AAyElC,yEAAyE;AACzE,QAAA,MAAM,oBAAoB,EAAE,QAAQ,CAAC,UAAU,CAC3C,mBAAmB,EACnB,SAAS,EAAE,CA0Cb,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/rules/no-floating-object-urls.js

@@ -0,0 +1,83 @@
+/**
+ * @packageDocumentation
+ * Require object URLs to be retained so they can be revoked.
+ */
+import { AST_NODE_TYPES, } from "@typescript-eslint/utils";
+import { collectStaticMemberPath, isDiscardedResourceExpression, } from "../_internal/floating-resource.js";
+import { createRuleDocsUrl } from "../_internal/rule-docs-url.js";
+import { getVariableInScopeChain } from "../_internal/scope-variable.js";
+import { createTypedRule, } from "../_internal/typed-rule.js";
+const globalUrlReceiverNames = ["globalThis", "self", "window"];
+const globalUrlReceiverNameSet = new Set(globalUrlReceiverNames);
+const getRootIdentifier = (node) => {
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return node;
+    }
+    return node.type === AST_NODE_TYPES.MemberExpression
+        ? getRootIdentifier(node.object)
+        : undefined;
+};
+const isShadowedIdentifier = (context, identifier) => {
+    const scope = context.sourceCode.getScope(identifier);
+    const variable = getVariableInScopeChain(scope, identifier.name);
+    return variable !== null && variable.defs.length > 0;
+};
+const isDirectUrlPath = (path) => path.length === 2 &&
+    path[0] === "URL" &&
+    path[1] === "createObjectURL";
+const isGlobalUrlPath = (path) => path.length === 3 &&
+    globalUrlReceiverNameSet.has(path[0] ?? "") &&
+    path[1] === "URL" &&
+    path[2] === "createObjectURL";
+const isObjectUrlCreateCall = (context, callee) => {
+    if (callee.type !== AST_NODE_TYPES.MemberExpression || callee.optional) {
+        return false;
+    }
+    const path = collectStaticMemberPath(callee);
+    if (path === undefined || (!isDirectUrlPath(path) && !isGlobalUrlPath(path))) {
+        return false;
+    }
+    const rootIdentifier = getRootIdentifier(callee.object);
+    return (rootIdentifier?.name !== "URL" ||
+        !isShadowedIdentifier(context, rootIdentifier));
+};
+/** Rule implementation for `runtime-cleanup/no-floating-object-urls`. */
+const noFloatingObjectUrls = createTypedRule({
+    create(context) {
+        return {
+            CallExpression(node) {
+                if (!isObjectUrlCreateCall(context, node.callee) ||
+                    !isDiscardedResourceExpression(node)) {
+                    return;
+                }
+                context.report({
+                    messageId: "floatingObjectUrl",
+                    node,
+                });
+            },
+        };
+    },
+    defaultOptions: [],
+    meta: {
+        docs: {
+            description: "require object URLs to be retained so they can be revoked.",
+            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-object-urls"),
+        },
+        messages: {
+            floatingObjectUrl: "Store or return the object URL so URL.revokeObjectURL() can release the Blob or File when cleanup runs.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    name: "no-floating-object-urls",
+});
+export default noFloatingObjectUrls;
+//# sourceMappingURL=no-floating-object-urls.js.map

package/dist/rules/no-floating-object-urls.js.map

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