eslint-plugin-typefest 1.0.1

package/dist/_internal/filter-callback.js

@@ -0,0 +1,100 @@
+import { getParentNode } from "./ast-node.js";
+import { setContainsValue } from "./set-membership.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 === "ArrowFunctionExpression" ||
+    node.type === "FunctionExpression";
+/**
+ * Narrows call expressions to direct `.filter(...)` calls.
+ */
+export const isFilterCallExpression = (expression) => !expression.optional &&
+    expression.callee.type === "MemberExpression" &&
+    !expression.callee.computed &&
+    !expression.callee.optional &&
+    expression.callee.property.type === "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 !== "ArrowFunctionExpression" &&
+            firstArgument.type !== "FunctionExpression")) {
+        return null;
+    }
+    return firstArgument;
+};
+/**
+ * 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 !== "ArrowFunctionExpression") {
+        return null;
+    }
+    if (callback.params.length !== 1) {
+        return null;
+    }
+    if (callback.body.type === "BlockStatement") {
+        return null;
+    }
+    const [parameter] = callback.params;
+    if (parameter?.type !== "Identifier") {
+        return null;
+    }
+    return {
+        callback: 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 (setContainsValue(visitedNodes, currentNode)) {
+            return false;
+        }
+        visitedNodes.add(currentNode);
+        if (isFunctionCallbackNode(currentNode)) {
+            const callbackParent = getParentNode(currentNode);
+            if (callbackParent?.type !== "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/global-identifier-member-call.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @packageDocumentation
+ * Helpers for matching static member calls that resolve to global bindings.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+import { type IdentifierMemberCallExpression } from "./member-call.js";
+/**
+ * Match `GlobalName.memberName(...)` calls where `GlobalName` resolves to the
+ * unshadowed global binding.
+ *
+ * @param options - Rule context and candidate call details.
+ *
+ * @returns Narrowed call expression when matched against the global binding;
+ *   otherwise `null`.
+ */
+export declare const getGlobalIdentifierMemberCall: <MessageIds extends string, Options extends Readonly<UnknownArray>>({ context, memberName, node, objectName, }: Readonly<{
+    context: Readonly<TSESLint.RuleContext<MessageIds, Options>>;
+    memberName: string;
+    node: Readonly<TSESTree.CallExpression>;
+    objectName: string;
+}>) => IdentifierMemberCallExpression | null;
+//# sourceMappingURL=global-identifier-member-call.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global-identifier-member-call.d.ts","sourceRoot":"","sources":["../../src/_internal/global-identifier-member-call.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAEH,KAAK,8BAA8B,EACtC,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GACtC,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,CAAC,YAAY,CAAC,EACxC,4CAKC,QAAQ,CAAC;IACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC,KAAG,8BAA8B,GAAG,IAkBrC,CAAC"}

package/dist/_internal/global-identifier-member-call.js

@@ -0,0 +1,25 @@
+import { getIdentifierMemberCall, } from "./member-call.js";
+import { isGlobalIdentifierNamed } from "./typed-rule.js";
+/**
+ * Match `GlobalName.memberName(...)` calls where `GlobalName` resolves to the
+ * unshadowed global binding.
+ *
+ * @param options - Rule context and candidate call details.
+ *
+ * @returns Narrowed call expression when matched against the global binding;
+ *   otherwise `null`.
+ */
+export const getGlobalIdentifierMemberCall = ({ context, memberName, node, objectName, }) => {
+    const memberCall = getIdentifierMemberCall({
+        memberName,
+        node,
+        objectName,
+    });
+    if (memberCall === null) {
+        return null;
+    }
+    return isGlobalIdentifierNamed(context, memberCall.callee.object, objectName)
+        ? memberCall
+        : null;
+};
+//# sourceMappingURL=global-identifier-member-call.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global-identifier-member-call.js","sourceRoot":"","sources":["../../src/_internal/global-identifier-member-call.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,uBAAuB,GAE1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAG3C,EACE,OAAO,EACP,UAAU,EACV,IAAI,EACJ,UAAU,GAMZ,EAAyC,EAAE;IACzC,MAAM,UAAU,GAAG,uBAAuB,CAAC;QACvC,UAAU;QACV,IAAI;QACJ,UAAU;KACb,CAAC,CAAC;IAEH,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,uBAAuB,CAC1B,OAAO,EACP,UAAU,CAAC,MAAM,CAAC,MAAM,EACxB,UAAU,CACb;QACG,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,IAAI,CAAC;AACf,CAAC,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * @packageDocumentation
+ * Shared reporting helper for ts-extras global static member-call replacement
+ * rules.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+import { type ImportedValueAliasMap } from "./imported-value-symbols.js";
+/** Direct named value imports collection type from shared import helper. */
+type DirectNamedValueImports = ImportedValueAliasMap;
+/** Typed rule context shape for global-member call rules. */
+type GlobalMemberRuleContext<MessageId extends string> = Readonly<TSESLint.RuleContext<MessageId, Readonly<UnknownArray>>>;
+/**
+ * Match `GlobalName.memberName(...)` calls that resolve to unshadowed globals
+ * and report a standardized ts-extras replacement.
+ */
+export declare const reportTsExtrasGlobalMemberCall: <MessageId extends string>({ canAutofix, context, importedName, imports, memberName, messageId, minimumArgumentCount, node, objectName, reportSuggestion, suggestionMessageId, }: Readonly<{
+    canAutofix?: (node: Readonly<TSESTree.CallExpression>) => boolean;
+    context: GlobalMemberRuleContext<MessageId>;
+    importedName: string;
+    imports: DirectNamedValueImports;
+    memberName: string;
+    messageId: MessageId;
+    minimumArgumentCount?: number;
+    node: Readonly<TSESTree.CallExpression>;
+    objectName: string;
+    reportSuggestion?: (input: Readonly<{
+        fix: TSESLint.ReportFixFunction;
+        messageId: MessageId;
+        node: Readonly<TSESTree.CallExpression>;
+        suggestionMessageId: MessageId;
+    }>) => void;
+    suggestionMessageId?: MessageId;
+}>) => void;
+export {};
+//# sourceMappingURL=global-member-call-rule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global-member-call-rule.d.ts","sourceRoot":"","sources":["../../src/_internal/global-member-call-rule.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAEH,KAAK,qBAAqB,EAC7B,MAAM,6BAA6B,CAAC;AAOrC,4EAA4E;AAC5E,KAAK,uBAAuB,GAAG,qBAAqB,CAAC;AAErD,6DAA6D;AAC7D,KAAK,uBAAuB,CAAC,SAAS,SAAS,MAAM,IAAI,QAAQ,CAC7D,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAC1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GAAI,SAAS,SAAS,MAAM,EAAE,uJAYtE,QAAQ,CAAC;IACR,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC;IAClE,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,uBAAuB,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,CACf,KAAK,EAAE,QAAQ,CAAC;QACZ,GAAG,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QAChC,SAAS,EAAE,SAAS,CAAC;QACrB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACxC,mBAAmB,EAAE,SAAS,CAAC;KAClC,CAAC,KACD,IAAI,CAAC;IACV,mBAAmB,CAAC,EAAE,SAAS,CAAC;CACnC,CAAC,KAAG,IAmDJ,CAAC"}

package/dist/_internal/global-member-call-rule.js

@@ -0,0 +1,52 @@
+import { getGlobalIdentifierMemberCall } from "./global-identifier-member-call.js";
+import { createSafeValueReferenceReplacementFix, } from "./imported-value-symbols.js";
+import { TS_EXTRAS_MODULE_SOURCE } from "./module-source.js";
+import { reportResolvedAutofixOrSuggestionOutcome, resolveAutofixOrSuggestionOutcome, } from "./rule-reporting.js";
+/**
+ * Match `GlobalName.memberName(...)` calls that resolve to unshadowed globals
+ * and report a standardized ts-extras replacement.
+ */
+export const reportTsExtrasGlobalMemberCall = ({ canAutofix, context, importedName, imports, memberName, messageId, minimumArgumentCount, node, objectName, reportSuggestion, suggestionMessageId, }) => {
+    const globalMemberCall = getGlobalIdentifierMemberCall({
+        context,
+        memberName,
+        node,
+        objectName,
+    });
+    if (globalMemberCall === null) {
+        return;
+    }
+    if (typeof minimumArgumentCount === "number" &&
+        node.arguments.length < minimumArgumentCount) {
+        return;
+    }
+    const shouldAutofix = canAutofix?.(node) ?? true;
+    const fix = createSafeValueReferenceReplacementFix({
+        context,
+        importedName,
+        imports,
+        sourceModuleName: TS_EXTRAS_MODULE_SOURCE,
+        targetNode: globalMemberCall.callee,
+    });
+    const outcome = resolveAutofixOrSuggestionOutcome({
+        canAutofix: shouldAutofix,
+        fix,
+    });
+    if (outcome.kind === "suggestion" && reportSuggestion !== undefined) {
+        reportSuggestion({
+            fix: outcome.fix,
+            messageId,
+            node,
+            suggestionMessageId: suggestionMessageId ?? messageId,
+        });
+        return;
+    }
+    reportResolvedAutofixOrSuggestionOutcome({
+        context,
+        messageId,
+        node,
+        outcome,
+        suggestionMessageId: suggestionMessageId ?? messageId,
+    });
+};
+//# sourceMappingURL=global-member-call-rule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global-member-call-rule.js","sourceRoot":"","sources":["../../src/_internal/global-member-call-rule.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EACH,sCAAsC,GAEzC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACH,wCAAwC,EACxC,iCAAiC,GACpC,MAAM,qBAAqB,CAAC;AAU7B;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAA2B,EACrE,UAAU,EACV,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GAoBrB,EAAQ,EAAE;IACR,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;QACnD,OAAO;QACP,UAAU;QACV,IAAI;QACJ,UAAU;KACb,CAAC,CAAC;IAEH,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO;IACX,CAAC;IAED,IACI,OAAO,oBAAoB,KAAK,QAAQ;QACxC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,oBAAoB,EAC9C,CAAC;QACC,OAAO;IACX,CAAC;IAED,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,sCAAsC,CAAC;QAC/C,OAAO;QACP,YAAY;QACZ,OAAO;QACP,gBAAgB,EAAE,uBAAuB;QACzC,UAAU,EAAE,gBAAgB,CAAC,MAAM;KACtC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,iCAAiC,CAAC;QAC9C,UAAU,EAAE,aAAa;QACzB,GAAG;KACN,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAClE,gBAAgB,CAAC;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS;YACT,IAAI;YACJ,mBAAmB,EAAE,mBAAmB,IAAI,SAAS;SACxD,CAAC,CAAC;QAEH,OAAO;IACX,CAAC;IAED,wCAAwC,CAAC;QACrC,OAAO;QACP,SAAS;QACT,IAAI;QACJ,OAAO;QACP,mBAAmB,EAAE,mBAAmB,IAAI,SAAS;KACxD,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/_internal/import-analysis.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @packageDocumentation
+ * Shared import-declaration analysis utilities for rule internals.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+/**
+ * Grouped mapping from imported symbol name to all local alias names.
+ */
+export type NamedImportLocalNamesByImportedName = ReadonlyMap<string, ReadonlySet<string>>;
+/**
+ * Flattened named-import binding metadata.
+ */
+export type NamedImportSpecifierBinding = Readonly<{
+    declaration: Readonly<TSESTree.ImportDeclaration>;
+    importedName: string;
+    localName: string;
+    specifier: Readonly<TSESTree.ImportSpecifier>;
+}>;
+/**
+ * Check whether an import declaration points at a specific source module.
+ */
+export declare const isImportDeclarationFromSource: (declaration: Readonly<TSESTree.ImportDeclaration>, sourceModuleName: string) => boolean;
+/**
+ * Collect named import-specifier bindings from one module source.
+ */
+export declare const collectNamedImportSpecifierBindingsFromSource: ({ allowTypeImportDeclaration, allowTypeImportSpecifier, sourceCode, sourceModuleName, }: Readonly<{
+    allowTypeImportDeclaration?: boolean;
+    allowTypeImportSpecifier?: boolean;
+    sourceCode: Readonly<TSESLint.SourceCode>;
+    sourceModuleName?: string;
+}>) => readonly NamedImportSpecifierBinding[];
+/**
+ * Collect named import local names grouped by imported symbol name.
+ */
+export declare const collectNamedImportLocalNamesByImportedNameFromSource: ({ allowTypeImportDeclaration, allowTypeImportSpecifier, sourceCode, sourceModuleName, }: Readonly<{
+    allowTypeImportDeclaration?: boolean;
+    allowTypeImportSpecifier?: boolean;
+    sourceCode: Readonly<TSESLint.SourceCode>;
+    sourceModuleName?: string;
+}>) => NamedImportLocalNamesByImportedName;
+/**
+ * Collect namespace-import local names from one module source.
+ */
+export declare const collectNamespaceImportLocalNamesFromSourceModule: (sourceCode: Readonly<TSESLint.SourceCode>, sourceModuleName: string) => ReadonlySet<string>;
+//# sourceMappingURL=import-analysis.d.ts.map

package/dist/_internal/import-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-analysis.d.ts","sourceRoot":"","sources":["../../src/_internal/import-analysis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAInE;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,WAAW,CACzD,MAAM,EACN,WAAW,CAAC,MAAM,CAAC,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAC/C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;CACjD,CAAC,CAAC;AAoHH;;GAEG;AACH,eAAO,MAAM,6BAA6B,GACtC,aAAa,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EACjD,kBAAkB,MAAM,KACzB,OAAwD,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,6CAA6C,GAAI,yFAK3D,QAAQ,CAAC;IACR,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,KAAG,SAAS,2BAA2B,EAiCxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oDAAoD,GAAI,yFAKlE,QAAQ,CAAC;IACR,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,KAAG,mCAgCJ,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gDAAgD,GACzD,YAAY,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzC,kBAAkB,MAAM,KACzB,WAAW,CAAC,MAAM,CAQpB,CAAC"}

package/dist/_internal/import-analysis.js

@@ -0,0 +1,113 @@
+import { isDefined } from "ts-extras";
+/**
+ * SourceCode-scoped cache for parsed import declarations.
+ */
+const sourceImportAnalysisCache = new WeakMap();
+/**
+ * Build and cache one import-analysis snapshot for the provided SourceCode.
+ */
+const getSourceImportAnalysis = (sourceCode) => {
+    const existingAnalysis = sourceImportAnalysisCache.get(sourceCode);
+    if (isDefined(existingAnalysis)) {
+        return existingAnalysis;
+    }
+    const namedImportSpecifierBindings = [];
+    const mutableNamespaceLocalNamesBySourceModule = new Map();
+    for (const statement of sourceCode.ast.body) {
+        if (statement.type !== "ImportDeclaration") {
+            continue;
+        }
+        const sourceModuleName = typeof statement.source.value === "string"
+            ? statement.source.value
+            : undefined;
+        for (const specifier of statement.specifiers) {
+            if (specifier.type === "ImportSpecifier" &&
+                specifier.imported.type === "Identifier" &&
+                specifier.local.type === "Identifier") {
+                namedImportSpecifierBindings.push(Object.freeze({
+                    declaration: statement,
+                    importedName: specifier.imported.name,
+                    localName: specifier.local.name,
+                    specifier,
+                }));
+                continue;
+            }
+            if (specifier.type === "ImportNamespaceSpecifier" &&
+                isDefined(sourceModuleName)) {
+                const existingLocalNames = mutableNamespaceLocalNamesBySourceModule.get(sourceModuleName);
+                if (!isDefined(existingLocalNames)) {
+                    mutableNamespaceLocalNamesBySourceModule.set(sourceModuleName, new Set([specifier.local.name]));
+                    continue;
+                }
+                existingLocalNames.add(specifier.local.name);
+            }
+        }
+    }
+    const namespaceImportLocalNamesBySourceModule = new Map();
+    for (const [sourceModuleName, localNames,] of mutableNamespaceLocalNamesBySourceModule) {
+        namespaceImportLocalNamesBySourceModule.set(sourceModuleName, Object.freeze(new Set(localNames)));
+    }
+    const analysis = Object.freeze({
+        namedImportSpecifierBindings: Object.freeze(namedImportSpecifierBindings),
+        namespaceImportLocalNamesBySourceModule,
+    });
+    sourceImportAnalysisCache.set(sourceCode, analysis);
+    return analysis;
+};
+/**
+ * Check whether an import declaration points at a specific source module.
+ */
+export const isImportDeclarationFromSource = (declaration, sourceModuleName) => declaration.source.value === sourceModuleName;
+/**
+ * Collect named import-specifier bindings from one module source.
+ */
+export const collectNamedImportSpecifierBindingsFromSource = ({ allowTypeImportDeclaration = true, allowTypeImportSpecifier = true, sourceCode, sourceModuleName, }) => {
+    const sourceImportAnalysis = getSourceImportAnalysis(sourceCode);
+    const bindings = [];
+    for (const binding of sourceImportAnalysis.namedImportSpecifierBindings) {
+        if (isDefined(sourceModuleName) &&
+            !isImportDeclarationFromSource(binding.declaration, sourceModuleName)) {
+            continue;
+        }
+        if (!allowTypeImportDeclaration &&
+            binding.declaration.importKind === "type") {
+            continue;
+        }
+        if (!allowTypeImportSpecifier &&
+            binding.specifier.importKind === "type") {
+            continue;
+        }
+        bindings.push(binding);
+    }
+    return bindings;
+};
+/**
+ * Collect named import local names grouped by imported symbol name.
+ */
+export const collectNamedImportLocalNamesByImportedNameFromSource = ({ allowTypeImportDeclaration = true, allowTypeImportSpecifier = true, sourceCode, sourceModuleName, }) => {
+    const localNamesByImportedName = new Map();
+    const bindingCollectionOptions = {
+        allowTypeImportDeclaration,
+        allowTypeImportSpecifier,
+        sourceCode,
+        ...(isDefined(sourceModuleName) ? { sourceModuleName } : {}),
+    };
+    for (const binding of collectNamedImportSpecifierBindingsFromSource(bindingCollectionOptions)) {
+        const existingLocalNames = localNamesByImportedName.get(binding.importedName);
+        if (!isDefined(existingLocalNames)) {
+            localNamesByImportedName.set(binding.importedName, new Set([binding.localName]));
+            continue;
+        }
+        existingLocalNames.add(binding.localName);
+    }
+    return localNamesByImportedName;
+};
+/**
+ * Collect namespace-import local names from one module source.
+ */
+export const collectNamespaceImportLocalNamesFromSourceModule = (sourceCode, sourceModuleName) => {
+    const sourceImportAnalysis = getSourceImportAnalysis(sourceCode);
+    const localNames = sourceImportAnalysis.namespaceImportLocalNamesBySourceModule.get(sourceModuleName);
+    return isDefined(localNames) ? new Set(localNames) : new Set();
+};
+//# sourceMappingURL=import-analysis.js.map

package/dist/_internal/import-analysis.js.map

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

package/dist/_internal/import-aware-fixes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @packageDocumentation
+ * Shared composition helpers for import-aware report fix callbacks.
+ */
+import type { TSESLint } from "@typescript-eslint/utils";
+import type { ImportFixIntent, ImportInsertionDecision } from "./import-fix-coordinator.js";
+/**
+ * Controls whether an autofix that must insert an import should also emit its
+ * replacement in the same report callback.
+ */
+export type AutofixImportInsertionStrategy = "combined" | "separate-pass";
+/**
+ * Build replacement/import fixer arrays according to an import-insertion
+ * coordination decision.
+ *
+ * @param options - Replacement and optional import-fix factories with the
+ *   import-insertion decision for this report callback.
+ *
+ * @returns Ordered fix array (`import`, then `replacement`) when applicable;
+ *   otherwise `null` when the fix must be suppressed.
+ */
+export declare const createImportAwareFixes: ({ autofixImportInsertionStrategy, createImportFix, createReplacementFix, fixer, importInsertionDecision, reportFixIntent, requiresImportInsertion, }: Readonly<{
+    autofixImportInsertionStrategy?: AutofixImportInsertionStrategy | undefined;
+    createImportFix: (fixer: Readonly<TSESLint.RuleFixer>) => null | TSESLint.RuleFix;
+    createReplacementFix: (fixer: Readonly<TSESLint.RuleFixer>) => TSESLint.RuleFix;
+    fixer: Readonly<TSESLint.RuleFixer>;
+    importInsertionDecision: ImportInsertionDecision;
+    reportFixIntent?: ImportFixIntent | undefined;
+    requiresImportInsertion: boolean;
+}>) => null | readonly TSESLint.RuleFix[];
+//# sourceMappingURL=import-aware-fixes.d.ts.map

package/dist/_internal/import-aware-fixes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-aware-fixes.d.ts","sourceRoot":"","sources":["../../src/_internal/import-aware-fixes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EACR,eAAe,EACf,uBAAuB,EAC1B,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,eAAe,CAAC;AAE1E;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GAAI,sJAQpC,QAAQ,CAAC;IACR,8BAA8B,CAAC,EAAE,8BAA8B,GAAG,SAAS,CAAC;IAC5E,eAAe,EAAE,CACb,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,KAClC,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,oBAAoB,EAAE,CAClB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,KAClC,QAAQ,CAAC,OAAO,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,uBAAuB,EAAE,OAAO,CAAC;CACpC,CAAC,KAAG,IAAI,GAAG,SAAS,QAAQ,CAAC,OAAO,EAkCpC,CAAC"}

package/dist/_internal/import-aware-fixes.js

@@ -0,0 +1,38 @@
+/**
+ * Build replacement/import fixer arrays according to an import-insertion
+ * coordination decision.
+ *
+ * @param options - Replacement and optional import-fix factories with the
+ *   import-insertion decision for this report callback.
+ *
+ * @returns Ordered fix array (`import`, then `replacement`) when applicable;
+ *   otherwise `null` when the fix must be suppressed.
+ */
+export const createImportAwareFixes = ({ autofixImportInsertionStrategy = "combined", createImportFix, createReplacementFix, fixer, importInsertionDecision, reportFixIntent = "autofix", requiresImportInsertion, }) => {
+    if (requiresImportInsertion &&
+        reportFixIntent === "autofix" &&
+        autofixImportInsertionStrategy === "separate-pass") {
+        if (!importInsertionDecision.shouldIncludeImportInsertionFix) {
+            return null;
+        }
+        const importFix = createImportFix(fixer);
+        if (importFix === null) {
+            return null;
+        }
+        return [importFix];
+    }
+    if (!requiresImportInsertion) {
+        return [createReplacementFix(fixer)];
+    }
+    if (!importInsertionDecision.shouldIncludeImportInsertionFix) {
+        return importInsertionDecision.allowReplacementWithoutImportInsertion
+            ? [createReplacementFix(fixer)]
+            : null;
+    }
+    const importFix = createImportFix(fixer);
+    if (importFix === null) {
+        return null;
+    }
+    return [importFix, createReplacementFix(fixer)];
+};
+//# sourceMappingURL=import-aware-fixes.js.map

package/dist/_internal/import-aware-fixes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-aware-fixes.js","sourceRoot":"","sources":["../../src/_internal/import-aware-fixes.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EACnC,8BAA8B,GAAG,UAAU,EAC3C,eAAe,EACf,oBAAoB,EACpB,KAAK,EACL,uBAAuB,EACvB,eAAe,GAAG,SAAS,EAC3B,uBAAuB,GAazB,EAAsC,EAAE;IACtC,IACI,uBAAuB;QACvB,eAAe,KAAK,SAAS;QAC7B,8BAA8B,KAAK,eAAe,EACpD,CAAC;QACC,IAAI,CAAC,uBAAuB,CAAC,+BAA+B,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC3B,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,uBAAuB,CAAC,+BAA+B,EAAE,CAAC;QAC3D,OAAO,uBAAuB,CAAC,sCAAsC;YACjE,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC"}

package/dist/_internal/import-fix-coordinator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @packageDocumentation
+ * Shared import-insertion coordination used by import-aware replacement fixers.
+ */
+import type { TSESTree } from "@typescript-eslint/utils";
+/** Classification for coordinated import insertion keys. */
+export type ImportBindingKind = "type" | "value";
+/**
+ * Delivery channel for a report fix callback.
+ *
+ * @remarks
+ * - `autofix`: fix supplied through `context.report({ fix })` and coordinated so
+ *   only one report emits a specific import insertion per file/lint pass.
+ * - `suggestion`: fix supplied through `context.report({ suggest })`; each
+ *   suggestion remains self-contained and therefore keeps import insertion.
+ */
+export type ImportFixIntent = "autofix" | "suggestion";
+/**
+ * Import-insertion planning decision for one report fix callback.
+ */
+export type ImportInsertionDecision = Readonly<{
+    allowReplacementWithoutImportInsertion: boolean;
+    shouldIncludeImportInsertionFix: boolean;
+}>;
+/**
+ * Input options used to resolve import-insertion coordination decisions.
+ */
+export type ImportInsertionDecisionOptions = Readonly<{
+    importBindingKind: ImportBindingKind;
+    importedName: string;
+    referenceNode: Readonly<TSESTree.Node>;
+    reportFixIntent: ImportFixIntent;
+    sourceModuleName: string;
+}>;
+/**
+ * Resolve import-insertion and replacement behavior for a report-fix callback.
+ *
+ * @remarks
+ * This decision is made during fixer construction (AST traversal) to keep
+ * behavior deterministic across repeated fix callback evaluation.
+ */
+export declare function resolveImportInsertionDecisionForReportFix({ importBindingKind, importedName, referenceNode, reportFixIntent, sourceModuleName, }: ImportInsertionDecisionOptions): ImportInsertionDecision;
+//# sourceMappingURL=import-fix-coordinator.d.ts.map

package/dist/_internal/import-fix-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-fix-coordinator.d.ts","sourceRoot":"","sources":["../../src/_internal/import-fix-coordinator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOzD,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC3C,sCAAsC,EAAE,OAAO,CAAC;IAChD,+BAA+B,EAAE,OAAO,CAAC;CAC5C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IAClD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAoEH;;;;;;GAMG;AACH,wBAAgB,0CAA0C,CAAC,EACvD,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,GACnB,EAAE,8BAA8B,GAAG,uBAAuB,CA8B1D"}

package/dist/_internal/import-fix-coordinator.js

@@ -0,0 +1,71 @@
+import { isDefined } from "ts-extras";
+import { getProgramNode } from "./ast-node.js";
+import { isImportInsertionFixesDisabledForNode } from "./plugin-settings.js";
+/** Program-scoped claimed import keys cache. */
+const claimedImportKeysByProgram = new WeakMap();
+/**
+ * Build a deterministic coordination key for one import binding.
+ */
+const createImportCoordinationKey = ({ importBindingKind, importedName, sourceModuleName, }) => `${importBindingKind}\u0000${sourceModuleName}\u0000${importedName}`;
+/**
+ * Claim a coordination key for one program and return whether this call made
+ * the first claim.
+ */
+const claimImportCoordinationKeyForProgram = ({ coordinationKey, programNode, }) => {
+    const existingClaims = claimedImportKeysByProgram.get(programNode);
+    if (existingClaims?.has(coordinationKey) === true) {
+        return false;
+    }
+    if (!isDefined(existingClaims)) {
+        claimedImportKeysByProgram.set(programNode, new Set([coordinationKey]));
+        return true;
+    }
+    existingClaims.add(coordinationKey);
+    return true;
+};
+/**
+ * Decision when import insertion should be emitted and replacement is allowed.
+ */
+const INCLUDE_IMPORT_INSERTION = {
+    allowReplacementWithoutImportInsertion: true,
+    shouldIncludeImportInsertionFix: true,
+};
+/**
+ * Decision when replacement depends on insertion and should be suppressed.
+ */
+const SKIP_IMPORT_INSERTION_BLOCK_REPLACEMENT = {
+    allowReplacementWithoutImportInsertion: false,
+    shouldIncludeImportInsertionFix: false,
+};
+/**
+ * Resolve import-insertion and replacement behavior for a report-fix callback.
+ *
+ * @remarks
+ * This decision is made during fixer construction (AST traversal) to keep
+ * behavior deterministic across repeated fix callback evaluation.
+ */
+export function resolveImportInsertionDecisionForReportFix({ importBindingKind, importedName, referenceNode, reportFixIntent, sourceModuleName, }) {
+    if (reportFixIntent === "suggestion") {
+        return INCLUDE_IMPORT_INSERTION;
+    }
+    if (isImportInsertionFixesDisabledForNode(referenceNode)) {
+        return SKIP_IMPORT_INSERTION_BLOCK_REPLACEMENT;
+    }
+    const programNode = getProgramNode(referenceNode);
+    if (!programNode) {
+        return INCLUDE_IMPORT_INSERTION;
+    }
+    const coordinationKey = createImportCoordinationKey({
+        importBindingKind,
+        importedName,
+        sourceModuleName,
+    });
+    if (!claimImportCoordinationKeyForProgram({
+        coordinationKey,
+        programNode,
+    })) {
+        return SKIP_IMPORT_INSERTION_BLOCK_REPLACEMENT;
+    }
+    return INCLUDE_IMPORT_INSERTION;
+}
+//# sourceMappingURL=import-fix-coordinator.js.map

package/dist/_internal/import-fix-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-fix-coordinator.js","sourceRoot":"","sources":["../../src/_internal/import-fix-coordinator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qCAAqC,EAAE,MAAM,sBAAsB,CAAC;AAsC7E,gDAAgD;AAChD,MAAM,0BAA0B,GAAG,IAAI,OAAO,EAG3C,CAAC;AAEJ;;GAEG;AACH,MAAM,2BAA2B,GAAG,CAAC,EACjC,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GAKlB,EAAU,EAAE,CACV,GAAG,iBAAiB,SAAS,gBAAgB,SAAS,YAAY,EAAE,CAAC;AAEzE;;;GAGG;AACH,MAAM,oCAAoC,GAAG,CAAC,EAC1C,eAAe,EACf,WAAW,GAIb,EAAW,EAAE;IACX,MAAM,cAAc,GAAG,0BAA0B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,cAAc,EAAE,GAAG,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7B,0BAA0B,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAExE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAEpC,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,wBAAwB,GAA4B;IACtD,sCAAsC,EAAE,IAAI;IAC5C,+BAA+B,EAAE,IAAI;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,uCAAuC,GAA4B;IACrE,sCAAsC,EAAE,KAAK;IAC7C,+BAA+B,EAAE,KAAK;CACzC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,0CAA0C,CAAC,EACvD,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,GACa;IAC7B,IAAI,eAAe,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,wBAAwB,CAAC;IACpC,CAAC;IAED,IAAI,qCAAqC,CAAC,aAAa,CAAC,EAAE,CAAC;QACvD,OAAO,uCAAuC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,wBAAwB,CAAC;IACpC,CAAC;IAED,MAAM,eAAe,GAAG,2BAA2B,CAAC;QAChD,iBAAiB;QACjB,YAAY;QACZ,gBAAgB;KACnB,CAAC,CAAC;IAEH,IACI,CAAC,oCAAoC,CAAC;QAClC,eAAe;QACf,WAAW;KACd,CAAC,EACJ,CAAC;QACC,OAAO,uCAAuC,CAAC;IACnD,CAAC;IAED,OAAO,wBAAwB,CAAC;AACpC,CAAC"}