@onecx/nx-migration-utils 6.0.0-rc.9 → 6.0.0

package/src/lib/utils/detect-method-calls-in-files.d.ts

@@ -1,13 +1,5 @@
 import { Tree } from '@nx/devkit';
 import { CallExpression } from 'typescript';
 type MatchingMethodCalls = Map<string, CallExpression[]>;
-/**
- * Detects method calls with a given name on a specified class in files within a specified directory or its subdirectories.
- * @param tree The file tree to search in.
- * @param rootDir The directory to start searching from.
- * @param methodName The name of the method to search for (e.g. 'myMethod').
- * @param className The name of the class to search for (e.g. 'MyClass').
- * @returns A map where the keys are file paths and the values are arrays of CallExpression nodes representing the detected method calls in the respective files.
- */
 export declare function detectMethodCallsInFiles(tree: Tree, rootDir: string, methodName: string, className: string): MatchingMethodCalls;
 export {};

package/src/lib/utils/detect-method-calls-in-files.js

@@ -4,13 +4,6 @@ exports.detectMethodCallsInFiles = detectMethodCallsInFiles;
 const devkit_1 = require("@nx/devkit");
 const tsquery_1 = require("@phenomnomnominal/tsquery");
 const typescript_1 = require("typescript");
-/**
- * Retrieves the names of all declarations that are of the specified type and contain a NewExpression (e.g., 'new MyClass()') with the specified class name.
- * @param contentAst The abstract syntax tree of the file to search in.
- * @param className The name of the class to search for (e.g. 'MyClass').
- * @param type The type of declaration to search for ('PropertyDeclaration' or 'VariableDeclaration').
- * @returns A string array of names of the declarations that match the criteria.
- */
 function getDeclarationNames(contentAst, className, type) {
     const declarations = (0, tsquery_1.query)(contentAst, `${type}:has(NewExpression > Identifier[name="${className}"])`);
     const memberNames = declarations.map((node) => {
@@ -21,12 +14,6 @@ function getDeclarationNames(contentAst, className, type) {
     });
     return memberNames;
 }
-/**
- * Retrieves the names of all properties and variables that are assigned a value from a NewExpression (e.g., 'new MyClass()') with the specified class name.
- * @param contentAst The abstract syntax tree of the file to search in.
- * @param className The name of the class to search for (e.g. 'MyClass').
- * @returns A string array of names of the assignments that match the criteria.
- */
 function getAssignmentNames(contentAst, className) {
     const assignments = (0, tsquery_1.query)(contentAst, `ExpressionStatement:has(BinaryExpression:has(EqualsToken):has(NewExpression > Identifier[name="${className}"]))`);
     const assignmentNames = assignments.map((node) => {
@@ -50,13 +37,6 @@ function getAssignmentNames(contentAst, className) {
     });
     return assignmentNames;
 }
-/**
- * Generates an array of computed queries to find method calls with a given method name on identifiers that are either variables or properties and type of the specified class.
- * @param contentAst The abstract syntax tree of the file to search in.
- * @param className The name of the class to search for (e.g. 'MyClass').
- * @param methodName The name of the method to search for (e.g. 'myMethod').
- * @returns A string array of computed queries to find method calls on identifiers.
- */
 function getIdentifierCallQueries(contentAst, className, methodName) {
     const variableNames = getDeclarationNames(contentAst, className, 'VariableDeclaration');
     const memberNames = getDeclarationNames(contentAst, className, 'PropertyDeclaration');
@@ -67,14 +47,6 @@ function getIdentifierCallQueries(contentAst, className, methodName) {
     const identifierCallPatterns = distinctIdentifiers.map((name) => `CallExpression:has(PropertyAccessExpression > Identifier[name="${name}"]):has(Identifier[name="${methodName}"])`);
     return identifierCallPatterns;
 }
-/**
- * Detects method calls with a given name on a specified class in files within a specified directory or its subdirectories.
- * @param tree The file tree to search in.
- * @param rootDir The directory to start searching from.
- * @param methodName The name of the method to search for (e.g. 'myMethod').
- * @param className The name of the class to search for (e.g. 'MyClass').
- * @returns A map where the keys are file paths and the values are arrays of CallExpression nodes representing the detected method calls in the respective files.
- */
 function detectMethodCallsInFiles(tree, rootDir, methodName, className) {
     const matchingFiles = new Map();
     // Look at each file inside of specified rootDir or any of its subdirectories that isn't gitignored

package/src/lib/utils/detect-method-calls-in-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect-method-calls-in-files.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/detect-method-calls-in-files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"detect-method-calls-in-files.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/detect-method-calls-in-files.ts"],"names":[],"mappings":"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"}

package/src/lib/utils/detect-method-calls-in-files.utils.d.ts

@@ -0,0 +1,20 @@
+import { Tree } from '@nx/devkit';
+import { CallExpression, SourceFile } from 'typescript';
+type MatchingMethodCalls = Map<string, CallExpression[]>;
+/**
+ * Retrieves the names of all parameters that are of type className and constructor-based injections (e.g., myClass: MyClass).
+ * @param contentAst The abstract syntax tree of the file to search in.
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @returns A string array of names of the parameters that match the criteria.
+ */
+export declare function getParameterNames(contentAst: SourceFile, className: string): string[];
+/**
+ * Detects method calls with a given name on a specified class in files within a specified directory or its subdirectories.
+ * @param tree The file tree to search in.
+ * @param rootDir The directory to start searching from.
+ * @param methodName The name of the method to search for (e.g. 'myMethod').
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @returns A map where the keys are file paths and the values are arrays of CallExpression nodes representing the detected method calls in the respective files.
+ */
+export declare function detectMethodCallsInFiles(tree: Tree, rootDir: string, methodName: string, className: string): MatchingMethodCalls;
+export {};

package/src/lib/utils/detect-method-calls-in-files.utils.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getParameterNames = getParameterNames;
+exports.detectMethodCallsInFiles = detectMethodCallsInFiles;
+const devkit_1 = require("@nx/devkit");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const typescript_1 = require("typescript");
+/**
+ * Retrieves the names of all declarations that are of the specified type and contain a NewExpression (e.g., 'new MyClass()') with the specified class name.
+ * @param contentAst The abstract syntax tree of the file to search in.
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @param type The type of declaration to search for ('PropertyDeclaration' or 'VariableDeclaration').
+ * @returns A string array of names of the declarations that match the criteria.
+ */
+function getDeclarationNames(contentAst, className, type) {
+    const declarations = (0, tsquery_1.query)(contentAst, `${type}:has(NewExpression > Identifier[name="${className}"])`);
+    const memberNames = declarations.map((node) => {
+        if ((type === 'VariableDeclaration' && (0, typescript_1.isVariableDeclaration)(node)) ||
+            (type === 'PropertyDeclaration' && (0, typescript_1.isPropertyDeclaration)(node))) {
+            return node.name.getText();
+        }
+        throw new Error(`Node is not a ${type}`);
+    });
+    return memberNames;
+}
+/**
+ * Retrieves the names of all properties and variables that are assigned a value from a NewExpression (e.g., 'new MyClass()') with the specified class name.
+ * @param contentAst The abstract syntax tree of the file to search in.
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @returns A string array of names of the assignments that match the criteria.
+ */
+function getAssignmentNames(contentAst, className) {
+    const assignments = (0, tsquery_1.query)(contentAst, `ExpressionStatement:has(BinaryExpression:has(EqualsToken):has(NewExpression > Identifier[name="${className}"]))`);
+    const assignmentNames = assignments.map((node) => {
+        if ((0, typescript_1.isExpressionStatement)(node)) {
+            const binaryExpression = node.expression;
+            if ((0, typescript_1.isBinaryExpression)(binaryExpression)) {
+                if (binaryExpression.operatorToken.kind == typescript_1.SyntaxKind.EqualsToken) {
+                    if ((0, typescript_1.isPropertyAccessExpression)(binaryExpression.left)) {
+                        return binaryExpression.left.name.escapedText.toString();
+                    }
+                    else if ((0, typescript_1.isIdentifier)(binaryExpression.left)) {
+                        return binaryExpression.left.escapedText.toString();
+                    }
+                    else {
+                        throw new Error('Node is not a PropertyAccessExpression or Identifier');
+                    }
+                }
+            }
+        }
+        throw new Error('Node is not an ExpressionStatement');
+    });
+    return assignmentNames;
+}
+/**
+ * Retrieves the names of all parameters that are of type className and constructor-based injections (e.g., myClass: MyClass).
+ * @param contentAst The abstract syntax tree of the file to search in.
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @returns A string array of names of the parameters that match the criteria.
+ */
+function getParameterNames(contentAst, className) {
+    const parameters = (0, tsquery_1.query)(contentAst, `Parameter:has(TypeReference:has(Identifier[name="${className}"]))`);
+    const parameterNames = parameters.map((node) => {
+        if ((0, typescript_1.isParameter)(node)) {
+            return node.name.getText();
+        }
+        throw new Error('Node is not a Parameter');
+    });
+    return parameterNames;
+}
+/**
+ * Retrieves the names of all injections that are injected via the inject CallExpression (e.g., myService = inject(MyService)).
+ * @param contentAst The abstract syntax tree of the file to search in.
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @returns A string array of names of the injections that match the criteria.
+ */
+function getInjectionNames(contentAst, className) {
+    const injections = (0, tsquery_1.query)(contentAst, `PropertyDeclaration:has(CallExpression:has(Identifier[name="inject"]) > Identifier[name="${className}"]), VariableDeclaration:has(CallExpression:has(Identifier[name="inject"]):has(Identifier[name="${className}"]))`);
+    const injectionNames = injections.map((node) => {
+        if ((0, typescript_1.isPropertyDeclaration)(node) || (0, typescript_1.isVariableDeclaration)(node)) {
+            return node.name.getText();
+        }
+        throw new Error('Node is not a PropertyDeclaration');
+    });
+    return injectionNames;
+}
+/**
+ * Generates an array of computed queries to find method calls with a given method name on identifiers that are either variables or properties and type of the specified class.
+ * @param contentAst The abstract syntax tree of the file to search in.
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @param methodName The name of the method to search for (e.g. 'myMethod').
+ * @returns A string array of computed queries to find method calls on identifiers.
+ */
+function getIdentifierCallQueries(contentAst, className, methodName) {
+    const variableNames = getDeclarationNames(contentAst, className, 'VariableDeclaration');
+    const memberNames = getDeclarationNames(contentAst, className, 'PropertyDeclaration');
+    const assignmentNames = getAssignmentNames(contentAst, className);
+    const parameterNames = getParameterNames(contentAst, className);
+    const injectionNames = getInjectionNames(contentAst, className);
+    const allIdentifiers = [...variableNames, ...memberNames, ...assignmentNames, ...parameterNames, ...injectionNames];
+    // Only check variables once, even if their value is set multiple times
+    const distinctIdentifiers = Array.from(new Set(allIdentifiers));
+    const identifierCallPatterns = distinctIdentifiers.map((name) => `CallExpression:has(PropertyAccessExpression > Identifier[name="${name}"]):has(Identifier[name="${methodName}"])`);
+    return identifierCallPatterns;
+}
+/**
+ * Detects method calls with a given name on a specified class in files within a specified directory or its subdirectories.
+ * @param tree The file tree to search in.
+ * @param rootDir The directory to start searching from.
+ * @param methodName The name of the method to search for (e.g. 'myMethod').
+ * @param className The name of the class to search for (e.g. 'MyClass').
+ * @returns A map where the keys are file paths and the values are arrays of CallExpression nodes representing the detected method calls in the respective files.
+ */
+function detectMethodCallsInFiles(tree, rootDir, methodName, className) {
+    const matchingFiles = new Map();
+    // Look at each file inside of specified rootDir or any of its subdirectories that isn't gitignored
+    (0, devkit_1.visitNotIgnoredFiles)(tree, rootDir, (file) => {
+        const content = tree.read(file, 'utf-8');
+        if (!content)
+            return;
+        const contentAst = (0, tsquery_1.ast)(content);
+        // Queries for method calls on identifiers (e.g. x.method() or this.x.method())
+        const identifierCallPatterns = getIdentifierCallQueries(contentAst, className, methodName);
+        // Query for inline method calls (e.g. new ClassName().method())
+        const inlineCallPattern = `CallExpression:has(NewExpression > Identifier[name="${className}"]):has(Identifier[name="${methodName}"])`;
+        const allPatterns = [...identifierCallPatterns, inlineCallPattern].join(', ');
+        // Search for all elements matching computed queries
+        let potentialMethodCalls = (0, tsquery_1.query)(contentAst, allPatterns);
+        // If no potential method calls are found, file can be ignored
+        if (potentialMethodCalls.length === 0)
+            return;
+        // Ensure that all detected method calls are indeed CallExpressions and filter out any other types
+        potentialMethodCalls = potentialMethodCalls.filter((node) => (0, typescript_1.isCallExpression)(node));
+        matchingFiles.set(file, potentialMethodCalls);
+    });
+    return matchingFiles;
+}
+//# sourceMappingURL=detect-method-calls-in-files.utils.js.map

package/src/lib/utils/detect-method-calls-in-files.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-method-calls-in-files.utils.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/detect-method-calls-in-files.utils.ts"],"names":[],"mappings":"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"}

package/src/lib/utils/detection/detect-variables-with-identifier.utils.d.ts

@@ -0,0 +1,9 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Detects variables that include the identifier.
+ * @param tree - the file tree to search in
+ * @param rootDir - the directory to start searching from
+ * @param identifierName - the name of the identifier to search for (e.g., 'MyClass')
+ * @returns {string[]} a list of variable names that include the identifier
+ */
+export declare function detectVariablesWithIdentifier(tree: Tree, rootDir: string, identifierName: string): string[];

package/src/lib/utils/detection/detect-variables-with-identifier.utils.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectVariablesWithIdentifier = detectVariablesWithIdentifier;
+const devkit_1 = require("@nx/devkit");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const patterns_utils_1 = require("../patterns.utils");
+/**
+ * Detects variables that include the identifier.
+ * @param tree - the file tree to search in
+ * @param rootDir - the directory to start searching from
+ * @param identifierName - the name of the identifier to search for (e.g., 'MyClass')
+ * @returns {string[]} a list of variable names that include the identifier
+ */
+function detectVariablesWithIdentifier(tree, rootDir, identifierName) {
+    const variableNames = new Set();
+    (0, devkit_1.visitNotIgnoredFiles)(tree, rootDir, (file) => {
+        const content = tree.read(file, 'utf-8');
+        if (!content)
+            return;
+        const contentAst = (0, tsquery_1.ast)(content);
+        // Query for import via a variable
+        const names = (0, tsquery_1.query)(contentAst, (0, patterns_utils_1.variableContainingIdentifierPattern)(identifierName)).map((node) => node.name.getText());
+        names.forEach((name) => variableNames.add(name));
+    });
+    return Array.from(variableNames);
+}
+//# sourceMappingURL=detect-variables-with-identifier.utils.js.map

package/src/lib/utils/detection/detect-variables-with-identifier.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-variables-with-identifier.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/detection/detect-variables-with-identifier.utils.ts"],"names":[],"mappings":";;AAYA,sEAiBC;AA7BD,uCAAuD;AACvD,uDAAsD;AAEtD,sDAAuE;AAEvE;;;;;;GAMG;AACH,SAAgB,6BAA6B,CAAC,IAAU,EAAE,OAAe,EAAE,cAAsB;IAC/F,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAA;IACvC,IAAA,6BAAoB,EAAC,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACxC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,MAAM,UAAU,GAAG,IAAA,aAAG,EAAC,OAAO,CAAC,CAAA;QAE/B,kCAAkC;QAClC,MAAM,KAAK,GAAG,IAAA,eAAK,EAAsB,UAAU,EAAE,IAAA,oDAAmC,EAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAC3G,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAC9B,CAAA;QAED,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;AAClC,CAAC"}

package/src/lib/utils/import-statements.utils.d.ts

@@ -0,0 +1,137 @@
+import { Tree } from '@nx/devkit';
+import { ImportDeclaration, ImportSpecifier, NamedImports, NodeArray, SourceFile } from 'typescript';
+interface ImportValueReplacement {
+    oldValue: string;
+    newValue: string;
+}
+interface ModuleImportReplacement {
+    oldModuleSpecifier: string;
+    newModuleSpecifier: string;
+    valueReplacements: ImportValueReplacement[];
+}
+interface ImportUpdateResult {
+    updatedImportDeclaration: ImportDeclaration | null;
+    remainingImportDeclaration: ImportDeclaration | null;
+}
+interface SplitImportSpecifiersResult {
+    matchedSpecifiers: ImportSpecifier[];
+    unmatchedSpecifiers: ImportSpecifier[];
+}
+/**
+ * Removes all import statements (ESM or CommonJS) for a given module from TypeScript files in a directory.
+ * @param tree - The Nx virtual file system tree.
+ * @param directoryPath - Path to the directory containing TypeScript files.
+ * @param moduleSpecifier - The module name whose import statements should be removed.
+ */
+export declare function removeImportsByModuleSpecifier(tree: Tree, directoryPath: string, moduleSpecifier: string): void;
+/**
+ * Replaces the module specifier in import statements with a new module name.
+ * @param tree - The Nx virtual file system tree.
+ * @param directoryPath - Path to the directory containing TypeScript files.
+ * @param oldModule - The current module name to be replaced.
+ * @param newModule - The new module name to use in import statements.
+ */
+export declare function replaceImportModuleSpecifier(tree: Tree, directoryPath: string, oldModule: string, newModule: string): void;
+/**
+ * Replaces specific named imports from a module with a new identifier
+ * @param tree - The Nx virtual file system tree.
+ * @param directoryOrFilePath - Path to a directory or a specific file.
+ * @param moduleSpecifier - The module from which imports are being replaced.
+ * @param oldImportValues - One or more named imports to replace.
+ * @param newImportValue - The new identifier to replace the old named imports with.
+ */
+export declare function replaceImportValues(tree: Tree, directoryOrFilePath: string, moduleSpecifier: string, oldImportValues: string | string[], newImportValue: string): void;
+/**
+ * Removes specific named imports from a module by replacing them with an empty string.
+ * @param tree - The Nx virtual file system tree.
+ * @param directoryPath - Path to the directory containing TypeScript files.
+ * @param moduleSpecifier - The module from which to remove imports.
+ * @param importValuesToRemove - One or more named imports to remove.
+ * @param filterQuery - Optional custom string query to filter files before applying changes.
+ * This can be used to limit the operation to files containing specific content (e.g., a class name or decorator).
+ */
+export declare function removeImportValuesFromModule(tree: Tree, directoryPath: string, moduleSpecifier: string, importValuesToRemove: string | string[], filterQuery?: string): void;
+/**
+ * Replaces both import values and module names in TypeScript files.
+ * @param tree - The Nx virtual file system tree.
+ * @param directoryPath - Directory to search for files.
+ * @param importReplacements - List of import module and value replacements.
+ * @param filterQuery - Optional query to filter files before applying changes.
+ */
+export declare function replaceImportValuesAndModule(tree: Tree, directoryPath: string, importReplacements: ModuleImportReplacement[], filterQuery?: string): void;
+/**
+ * Processes a file's AST to apply import replacements.
+ * @param fileContent - The content of the file to process.
+ * @param replacements - List of module and value replacements.
+ * @param filterQuery - Optional custom string query to filter files before applying changes.
+ * This can be used to limit the operation to files containing specific content (e.g., a class name or decorator).
+ * @returns The updated file content, or null if no changes were made.
+ */
+export declare function replaceImportsInFile(fileContent: string, replacements: ModuleImportReplacement[], filterQuery?: string): string | null;
+/**
+ * Applies import replacements to a TypeScript AST.
+ * @param contentAst - The AST of the source file.
+ * @param replacement - The module and value replacement configuration.
+ * @returns The updated AST, or null if no changes were made.
+ */
+export declare function applyImportReplacement(contentAst: SourceFile, replacement: ModuleImportReplacement): SourceFile | null;
+/**
+ * Updates an import declaration by replacing specific named imports and updating the module specifier.
+ * Only creates a new import if at least one named import is matched and replaced.
+ * Remove import statement if all named imports are removed.
+ * @param originalImport - The original import declaration node.
+ * @param importValueReplacements - List of named import replacements.
+ * @param newModuleName - The new module specifier.
+ * @returns The updated import declaration, or the original if no replacements were made.
+ */
+export declare function updateImportDeclaration(originalImport: ImportDeclaration, importValueReplacements: ImportValueReplacement[], newModuleName: string): ImportUpdateResult;
+/**
+ * Creates an updated import declaration with matched specifiers.
+ * When you want to move or rename specific named imports to a new module.
+ * @param matchedSpecifiers - The matched import specifiers.
+ * @param newModuleName - The new module specifier.
+ * @returns The updated import declaration, or null if no specifiers were matched.
+ *
+ */
+export declare function createUpdatedImport(matchedSpecifiers: ImportSpecifier[], newModuleName: string): ImportDeclaration | null;
+/**
+ * Creates a remaining import declaration with unmatched specifiers.
+ * If no unmatched specifiers remain, remove the entire import.
+ * To preserve the parts of the import that are not being changed.
+ * @param unmatchedSpecifiers - The unmatched import specifiers.
+ * @param originalCount - The original count of specifiers.
+ * @param newModuleName - The new module specifier.
+ * @param originalImport - The original import declaration.
+ * @returns The remaining import declaration, or null if no specifiers were unmatched.
+ *
+ */
+export declare function createRemainingImport(unmatchedSpecifiers: ImportSpecifier[], originalCount: number, newModuleName: string, originalImport: ImportDeclaration): ImportDeclaration | null;
+/**
+ * Constructs a new import declaration with the given specifiers and module name.
+ * @param specifiers - The updated import specifiers.
+ * @param moduleName - The new module specifier.
+ * @returns A new ImportDeclaration node.
+ */
+export declare function buildImportDeclaration(specifiers: ImportSpecifier[], moduleName: string): ImportDeclaration | null;
+/**
+ * Splits import specifiers into matched and unmatched based on replacements.
+ * Separate import specifiers that need to be replaced from those that don't.
+ * @param specifiers - The original import specifiers.
+ * @param replacements - List of replacements to apply.
+ * @returns An object containing matched and unmatched specifiers.
+ */
+export declare function splitSpecifiers(specifiers: NodeArray<ImportSpecifier>, replacements: ImportValueReplacement[]): SplitImportSpecifiersResult;
+/**
+ * Extracts named imports from an import declaration.
+ * @param importDeclaration - The import declaration node.
+ * @returns The NamedImports node, if present.
+ */
+export declare function getNamedImports(importDeclaration: ImportDeclaration): NamedImports | undefined;
+/**
+ * Finds the first import declaration for a given module name.
+ * @param sourceFile - The TypeScript source file AST.
+ * @param moduleName - The module name to search for.
+ * @returns The matching ImportDeclaration node, if found.
+ */
+export declare function findImportDeclaration(sourceFile: SourceFile, moduleName: string): ImportDeclaration | undefined;
+export {};