Supported Transforms

The codemod phase uses jscodeshift to parse your code into an AST and transform all import and export paths. The following statement types are handled.

ES module imports

import { MyComponent } from "./components/MyComponent";
// → import { MyComponent } from "./components/my-component";

ES module exports

export { handler } from "./api/RequestHandler";
// → export { handler } from "./api/request-handler";

Export all

export * from "./utils/DateHelpers";
// → export * from "./utils/date-helpers";

Dynamic imports

const module = await import("./pages/UserProfile");
// → const module = await import("./pages/user-profile");

CommonJS require

const utils = require("./lib/StringUtils");
// → const utils = require("./lib/string-utils");

URL constructor

const url = new URL("./assets/MyFont.woff2", import.meta.url);
// → const url = new URL("./assets/my-font.woff2", import.meta.url);

TypeScript import types

type Config = import("./config/AppConfig").Config;
// → type Config = import("./config/app-config").Config;

Next.js dynamic imports

const Component = dynamic(() => import("./components/MyWidget"));
// → const Component = dynamic(() => import("./components/my-widget"));

WARNING

jscodeshift has difficulty detecting call expressions that are deeply nested. Some patterns like dynamic(() => import(...)) inside more complex wrappers may not be detected. See Known Limitations.