eslint-plugin-typefest 1.0.1

package/dist/_internal/imported-type-aliases.js

@@ -0,0 +1,316 @@
+import { keyIn } from "ts-extras";
+import { getParentNode } from "./ast-node.js";
+import { isAnyLinkedStructureNodeMatching } from "./cycle-safe-linked-search.js";
+import { collectNamedImportLocalNamesByImportedNameFromSource, collectNamedImportSpecifierBindingsFromSource, collectNamespaceImportLocalNamesFromSourceModule, } from "./import-analysis.js";
+import { createImportAwareFixes } from "./import-aware-fixes.js";
+import { resolveImportInsertionDecisionForReportFix, } from "./import-fix-coordinator.js";
+import { createImportInsertionFix } from "./import-insertion.js";
+import { TYPE_FEST_MODULE_SOURCE } from "./module-source.js";
+import { setContainsValue } from "./set-membership.js";
+/** Utility wrapper used to preserve explicit readonly semantics in fixes. */
+const READONLY_UTILITY_TYPE_NAME = "Readonly";
+/**
+ * Container type references that semantically encode readonly wrappers.
+ */
+const READONLY_CONTAINER_TYPE_NAMES = new Set([
+    "ReadonlyArray",
+    "ReadonlyMap",
+    "ReadonlySet",
+]);
+/**
+ * Determine whether a node exposes an optional `typeParameters` property.
+ */
+const hasOptionalTypeParametersProperty = (node) => keyIn(node, "typeParameters");
+/**
+ * Collects imported canonical type alias names that should be replaced by
+ * preferred type-fest utility names.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param replacementsByImportedName - Mapping from imported symbol names to
+ *   preferred replacement names.
+ *
+ * @returns Map keyed by canonical imported alias name with replacement
+ *   metadata.
+ */
+export const collectImportedTypeAliasMatches = (sourceCode, replacementsByImportedName) => {
+    const aliasMatches = new Map();
+    for (const binding of collectNamedImportSpecifierBindingsFromSource({
+        sourceCode,
+    })) {
+        if (binding.localName !== binding.importedName) {
+            continue;
+        }
+        const replacementName = replacementsByImportedName[binding.importedName];
+        if (typeof replacementName !== "string" ||
+            replacementName.length === 0) {
+            continue;
+        }
+        const sourceValue = typeof binding.declaration.source.value === "string"
+            ? binding.declaration.source.value
+            : "";
+        aliasMatches.set(binding.importedName, {
+            importedName: binding.importedName,
+            replacementName,
+            sourceValue,
+        });
+    }
+    return aliasMatches;
+};
+/**
+ * Collect direct (non-renamed) named imports for a specific source module.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param expectedSourceValue - Module source string to match.
+ *
+ * @returns Set of imported identifier names.
+ */
+export const collectDirectNamedImportsFromSource = (sourceCode, expectedSourceValue) => {
+    const localNamesByImportedName = collectNamedImportLocalNamesByImportedNameFromSource({
+        sourceCode,
+        sourceModuleName: expectedSourceValue,
+    });
+    const namedImports = new Set();
+    for (const [importedName, localNames] of localNamesByImportedName) {
+        if (!setContainsValue(localNames, importedName)) {
+            continue;
+        }
+        namedImports.add(importedName);
+    }
+    return namedImports;
+};
+/**
+ * Collect local identifier names for a specific named import from a selected
+ * module source.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param expectedSourceValue - Module source string to match.
+ * @param expectedImportedName - Imported symbol name to match.
+ *
+ * @returns Set of local identifier names (including aliased locals).
+ */
+export const collectNamedImportLocalNamesFromSource = (sourceCode, expectedSourceValue, expectedImportedName) => new Set(collectNamedImportLocalNamesByImportedNameFromSource({
+    sourceCode,
+    sourceModuleName: expectedSourceValue,
+}).get(expectedImportedName));
+/**
+ * Collect local identifier names for namespace imports from a selected module
+ * source.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param expectedSourceValue - Module source string to match.
+ *
+ * @returns Set of namespace import local names.
+ */
+export const collectNamespaceImportLocalNamesFromSource = (sourceCode, expectedSourceValue) => collectNamespaceImportLocalNamesFromSourceModule(sourceCode, expectedSourceValue);
+/**
+ * Builds an import-insertion fix for missing named type replacements.
+ *
+ * @param options - Fixer context and replacement import metadata.
+ *
+ * @returns Import insertion fix when a safe insertion point is found; otherwise
+ *   `null`.
+ */
+const getInsertionFixForMissingNamedTypeImport = ({ fixer, node, replacementName, sourceModuleName, }) => {
+    const importDeclarationText = `import type { ${replacementName} } from "${sourceModuleName}";`;
+    return createImportInsertionFix({
+        fixer,
+        importDeclarationText,
+        moduleSpecifierHint: sourceModuleName,
+        referenceNode: node,
+    });
+};
+/**
+ * Checks whether an ancestor node declares a type parameter with a specific
+ * name.
+ *
+ * @param ancestor - Ancestor node to inspect.
+ * @param parameterName - Type parameter name to detect.
+ *
+ * @returns `true` when the ancestor declares a matching type parameter.
+ */
+const ancestorDefinesTypeParameterNamed = (ancestor, parameterName) => {
+    if (!hasOptionalTypeParametersProperty(ancestor)) {
+        return false;
+    }
+    const typeParameterDeclaration = ancestor.typeParameters;
+    if (!typeParameterDeclaration) {
+        return false;
+    }
+    return typeParameterDeclaration.params.some((parameter) => parameter.name.name === parameterName);
+};
+/**
+ * Determine whether a type parameter name is shadowed by any enclosing generic
+ * declaration.
+ *
+ * @param node - Node used as the starting point for ancestor traversal.
+ * @param parameterName - Type parameter name to detect.
+ *
+ * @returns `true` when an ancestor declares a matching type parameter.
+ */
+export function isTypeParameterNameShadowed(node, parameterName) {
+    return isAnyLinkedStructureNodeMatching({
+        getNextNode: (currentNode) => getParentNode(currentNode) ?? null,
+        isMatch: (currentNode) => ancestorDefinesTypeParameterNamed(currentNode, parameterName),
+        startNode: node,
+    });
+}
+/**
+ * Build a replacement fixer that optionally inserts a missing named type import
+ * before applying the replacement.
+ *
+ * @param options - Replacement strategy plus import/scope safety inputs.
+ *
+ * @returns Report fixer when replacement is scope-safe; otherwise `null`.
+ */
+const createTypeReplacementFix = ({ applyReplacement, availableReplacementNames, node, replacementName, reportFixIntent, sourceModuleName, }) => {
+    if (isTypeParameterNameShadowed(node, replacementName)) {
+        return null;
+    }
+    const requiresImportInsertion = !setContainsValue(availableReplacementNames, replacementName);
+    if (!requiresImportInsertion) {
+        return (fixer) => applyReplacement(fixer);
+    }
+    const importInsertionDecision = resolveImportInsertionDecisionForReportFix({
+        importBindingKind: "type",
+        importedName: replacementName,
+        referenceNode: node,
+        reportFixIntent,
+        sourceModuleName,
+    });
+    return (fixer) => createImportAwareFixes({
+        createImportFix: (importFixer) => getInsertionFixForMissingNamedTypeImport({
+            fixer: importFixer,
+            node,
+            replacementName,
+            sourceModuleName,
+        }),
+        createReplacementFix: applyReplacement,
+        fixer,
+        importInsertionDecision,
+        requiresImportInsertion,
+    });
+};
+/**
+ * Build a safe type-reference replacement fixer.
+ *
+ * @param node - Type reference node to potentially fix.
+ * @param replacementName - Replacement identifier text.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export const createSafeTypeReferenceReplacementFix = (node, replacementName, availableReplacementNames, sourceModuleName = TYPE_FEST_MODULE_SOURCE, reportFixIntent = "autofix") => {
+    if (node.typeName.type !== "Identifier") {
+        return null;
+    }
+    return createTypeReplacementFix({
+        applyReplacement: (fixer) => fixer.replaceText(node.typeName, replacementName),
+        availableReplacementNames,
+        node,
+        replacementName,
+        reportFixIntent,
+        sourceModuleName,
+    });
+};
+/**
+ * Build a safe whole-type-node replacement fixer with custom replacement text.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement symbol name used for import/scope safety
+ *   checks.
+ * @param replacementText - Final replacement text to emit.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export const createSafeTypeNodeTextReplacementFix = (node, replacementName, replacementText, availableReplacementNames, sourceModuleName = TYPE_FEST_MODULE_SOURCE, reportFixIntent = "autofix") => createTypeReplacementFix({
+    applyReplacement: (fixer) => fixer.replaceText(node, replacementText),
+    availableReplacementNames,
+    node,
+    replacementName,
+    reportFixIntent,
+    sourceModuleName,
+});
+/**
+ * Build a safe whole-type-node replacement fixer.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement identifier text.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export const createSafeTypeNodeReplacementFix = (node, replacementName, availableReplacementNames, sourceModuleName = TYPE_FEST_MODULE_SOURCE, reportFixIntent = "autofix") => createSafeTypeNodeTextReplacementFix(node, replacementName, replacementName, availableReplacementNames, sourceModuleName, reportFixIntent);
+/**
+ * Detects type nodes that explicitly encode readonly semantics.
+ *
+ * @param node - Type node to inspect.
+ *
+ * @returns `true` for `readonly` type operators and known readonly container
+ *   references.
+ */
+const isExplicitReadonlyTypeNode = (node) => {
+    if (node.type === "TSTypeOperator") {
+        return node.operator === "readonly";
+    }
+    if (node.type !== "TSTypeReference" ||
+        node.typeName.type !== "Identifier") {
+        return false;
+    }
+    return setContainsValue(READONLY_CONTAINER_TYPE_NAMES, node.typeName.name);
+};
+/**
+ * Checks whether replacement text is already wrapped with `Readonly<...>`.
+ */
+const isReadonlyUtilityWrappedText = (replacementText) => replacementText.trimStart().startsWith(`${READONLY_UTILITY_TYPE_NAME}<`);
+/**
+ * Wraps replacement text in `Readonly<...>`.
+ */
+const toReadonlyUtilityWrappedText = (replacementText) => `${READONLY_UTILITY_TYPE_NAME}<${replacementText}>`;
+/**
+ * Build a safe whole-type-node replacement fixer that preserves explicit
+ * readonly wrappers/operators from the original node.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement symbol name used for import/scope safety
+ *   checks.
+ * @param replacementText - Final replacement text before readonly-preservation
+ *   adjustment.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export const createSafeTypeNodeTextReplacementFixPreservingReadonly = (node, replacementName, replacementText, availableReplacementNames, sourceModuleName = TYPE_FEST_MODULE_SOURCE, reportFixIntent = "autofix") => {
+    const replacementTextWithReadonlyPreservation = isExplicitReadonlyTypeNode(node) &&
+        !isReadonlyUtilityWrappedText(replacementText)
+        ? toReadonlyUtilityWrappedText(replacementText)
+        : replacementText;
+    return createSafeTypeNodeTextReplacementFix(node, replacementName, replacementTextWithReadonlyPreservation, availableReplacementNames, sourceModuleName, reportFixIntent);
+};
+/**
+ * Build a safe whole-type-node replacement fixer that preserves explicit
+ * readonly wrappers/operators from the original node.
+ *
+ * @param node - Type node to potentially replace.
+ * @param replacementName - Replacement identifier text.
+ * @param availableReplacementNames - Available direct imported replacement
+ *   names.
+ * @param sourceModuleName - Module source used when validating/adding imports.
+ *
+ * @returns Fix function when replacement/import insertion is scope-safe;
+ *   otherwise `null`.
+ */
+export const createSafeTypeNodeReplacementFixPreservingReadonly = (node, replacementName, availableReplacementNames, sourceModuleName = TYPE_FEST_MODULE_SOURCE, reportFixIntent = "autofix") => createSafeTypeNodeTextReplacementFixPreservingReadonly(node, replacementName, replacementName, availableReplacementNames, sourceModuleName, reportFixIntent);
+//# sourceMappingURL=imported-type-aliases.js.map

package/dist/_internal/imported-type-aliases.js.map

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

package/dist/_internal/imported-value-symbols.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @packageDocumentation
+ * Utilities for collecting and safely resolving direct named value imports.
+ */
+import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
+import type { UnknownArray } from "type-fest";
+import { type AutofixImportInsertionStrategy } from "./import-aware-fixes.js";
+import { type ImportFixIntent } from "./import-fix-coordinator.js";
+/**
+ * Immutable mapping of imported symbol names to directly imported local
+ * aliases.
+ */
+export type ImportedValueAliasMap = ReadonlyMap<string, ReadonlySet<string>>;
+/**
+ * Parameters for creating a safe member-expression to function-call fixer.
+ */
+type MemberToFunctionCallFixParams = Readonly<{
+    context: Readonly<TSESLint.RuleContext<string, UnknownArray>>;
+    importedName: string;
+    imports: ImportedValueAliasMap;
+    memberNode: TSESTree.MemberExpression;
+    reportFixIntent?: ImportFixIntent;
+    sourceModuleName: string;
+}>;
+/**
+ * Parameters for creating a safe method-call to function-call fixer.
+ */
+type MethodToFunctionCallFixParams = Readonly<{
+    callNode: TSESTree.CallExpression;
+    context: Readonly<TSESLint.RuleContext<string, UnknownArray>>;
+    importedName: string;
+    imports: ImportedValueAliasMap;
+    reportFixIntent?: ImportFixIntent;
+    sourceModuleName: string;
+}>;
+/**
+ * Parameters for resolving a safe local alias for an imported value symbol.
+ */
+type SafeImportedValueNameParams = Readonly<{
+    context: Readonly<TSESLint.RuleContext<string, UnknownArray>>;
+    importedName: string;
+    imports: ImportedValueAliasMap;
+    referenceNode: TSESTree.Node;
+    sourceModuleName: string;
+}>;
+/**
+ * Parameters for creating a safe replacement fixer with custom replacement text
+ * derived from the resolved helper local name.
+ */
+type SafeValueNodeTextReplacementFixParams = Readonly<{
+    context: Readonly<TSESLint.RuleContext<string, UnknownArray>>;
+    importedName: string;
+    imports: ImportedValueAliasMap;
+    replacementTextFactory: (replacementName: string) => string;
+    reportFixIntent?: ImportFixIntent;
+    sourceModuleName: string;
+    targetNode: TSESTree.Node;
+}>;
+/**
+ * Parameters for creating a safe replacement fixer for a value reference.
+ */
+type SafeValueReplacementFixParams = Readonly<{
+    context: Readonly<TSESLint.RuleContext<string, UnknownArray>>;
+    importedName: string;
+    imports: ImportedValueAliasMap;
+    reportFixIntent?: ImportFixIntent;
+    sourceModuleName: string;
+    targetNode: TSESTree.Node;
+}>;
+/**
+ * Parameters for creating a safe function-call replacement fixer.
+ */
+type ValueArgumentFunctionCallFixParams = Readonly<{
+    argumentNode: TSESTree.Node;
+    autofixImportInsertionStrategy?: AutofixImportInsertionStrategy;
+    context: Readonly<TSESLint.RuleContext<string, UnknownArray>>;
+    importedName: string;
+    imports: ImportedValueAliasMap;
+    negated?: boolean;
+    reportFixIntent?: ImportFixIntent;
+    sourceModuleName: string;
+    targetNode: TSESTree.Node;
+}>;
+/**
+ * Collect direct named value imports from a specific module.
+ *
+ * @param sourceCode - Source code object for the current file.
+ * @param sourceModuleName - Module source string to match.
+ *
+ * @returns Readonly map of imported symbol names to local aliases.
+ */
+export declare const collectDirectNamedValueImportsFromSource: (sourceCode: Readonly<TSESLint.SourceCode>, sourceModuleName: string) => ImportedValueAliasMap;
+/**
+ * Resolve a safe local alias for a required imported value at one reference.
+ *
+ * @param options - Rule context, import alias map, and target reference
+ *   metadata.
+ *
+ * @returns Local alias when the current scope binds it to the expected module;
+ *   otherwise `null`.
+ */
+export declare const getSafeLocalNameForImportedValue: ({ context, importedName, imports, referenceNode, sourceModuleName, }: Readonly<SafeImportedValueNameParams>) => null | string;
+/**
+ * Serialize a call argument node to text, preserving sequence-expression
+ * semantics with parentheses when required.
+ *
+ * @param options - Argument node and source-code accessor.
+ *
+ * @returns Trimmed argument text suitable for function-call insertion, or
+ *   `null` when no text can be produced.
+ */
+export declare const getFunctionCallArgumentText: ({ argumentNode, sourceCode, }: Readonly<{
+    argumentNode: Readonly<TSESTree.Node>;
+    sourceCode: Readonly<TSESLint.SourceCode>;
+}>) => null | string;
+/**
+ * Create a fixer that safely replaces a target node with a resolved local
+ * import alias.
+ *
+ * @param options - Inputs used to resolve replacement/import insertion safety.
+ *
+ * @returns A report fixer when safe; otherwise `null`.
+ */
+export declare const createSafeValueReferenceReplacementFix: ({ context, importedName, imports, reportFixIntent, sourceModuleName, targetNode, }: Readonly<SafeValueReplacementFixParams>) => null | TSESLint.ReportFixFunction;
+/**
+ * Create a fixer that safely rewrites a target node using custom replacement
+ * text derived from a resolved helper local name.
+ *
+ * @param options - Inputs for safe helper-name resolution and replacement-text
+ *   generation.
+ *
+ * @returns A report fixer when safe; otherwise `null`.
+ */
+export declare const createSafeValueNodeTextReplacementFix: ({ context, importedName, imports, replacementTextFactory, reportFixIntent, sourceModuleName, targetNode, }: Readonly<SafeValueNodeTextReplacementFixParams>) => null | TSESLint.ReportFixFunction;
+/**
+ * Create a fixer that rewrites `receiver.method(args...)` to
+ * `importedFn(receiver, args...)`.
+ *
+ * @returns A report fixer when safe; otherwise `null`.
+ */
+export declare const createMethodToFunctionCallFix: ({ callNode, context, importedName, imports, reportFixIntent, sourceModuleName, }: Readonly<MethodToFunctionCallFixParams>) => null | TSESLint.ReportFixFunction;
+/**
+ * Create a fixer that rewrites `receiver[member]` to `importedFn(receiver)`.
+ *
+ * @returns A report fixer when safe; otherwise `null`.
+ */
+export declare const createMemberToFunctionCallFix: ({ context, importedName, imports, memberNode, reportFixIntent, sourceModuleName, }: Readonly<MemberToFunctionCallFixParams>) => null | TSESLint.ReportFixFunction;
+/**
+ * Create a fixer that rewrites a target node to an imported helper invocation.
+ *
+ * @param options - Target/argument nodes and import metadata for call
+ *
+ * @returns A report fixer when safe; otherwise `null`.
+ */
+export declare const createSafeValueArgumentFunctionCallFix: ({ argumentNode, autofixImportInsertionStrategy, context, importedName, imports, negated, reportFixIntent, sourceModuleName, targetNode, }: Readonly<ValueArgumentFunctionCallFixParams>) => null | TSESLint.ReportFixFunction;
+export {};
+//# sourceMappingURL=imported-value-symbols.d.ts.map

package/dist/_internal/imported-value-symbols.d.ts.map

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