✨ Adds renameImportDeclaration util

Author: danieldelcore

packages/utils/src/imports.ts

@@ -32,6 +32,18 @@ export function removeImportDeclaration(
   getImportDeclaration(j, source, sourcePath).remove();
 }
 
+export function renameImportDeclaration(
+  j: core.JSCodeshift,
+  source: Collection<any>,
+  sourcePath: string,
+  newSourcePath: string,
+) {
+  getImportDeclaration(j, source, sourcePath).forEach(
+    importDeclaration =>
+      (importDeclaration.node.source = j.stringLiteral(newSourcePath)),
+  );
+}
+
 export function getDefaultImportSpecifier(
   j: core.JSCodeshift,
   source: Collection<any>,

website/docs/api/codeshift-utils.mdx

@@ -85,6 +85,33 @@ removeImportDeclaration(j, source, 'react');
 -import React, { useEffect } from 'react';
 ```
 
+### `renameImportDeclaration(j, source, sourcePath, newSourcePath)`
+
+Renames an import declaration by source name
+
+**Returns**
+
+`void`
+
+**Example**
+
+```jsx
+// src/App.js
+import React from 'react';
+```
+
+```js
+import { renameImportDeclaration } from '@codeshift/utils';
+
+renameImportDeclaration(j, source, 'react', 'preact');
+```
+
+```diff
+// src/App.js
+-import React, { useEffect } from 'react';
++import React, { useEffect } from 'preact';
+```
+
 ### `getDefaultImportSpecifier(j, source, sourcePath)`
 
 Finds a default import specifier