unplugin-resolve-esm-ts-paths

Resolve import and export expressions using the TSConfig paths and baseUrl. This was made to be used on Node environments where you need to have relative imports and most transpile tools (even tsc itself) doesn't change imports.

Powered by get-tsconfig and es-module-lexer.

Features

• Resolve TSConfig paths to relative paths.
• Add index files for directory imports.
• Add file extensions.
• Extra: Ability to have glob imports. Import paths containing the glob: keyword will be parsed by the plugin and the default imports of every file matching the glob will be added to the file. The result will be a variable containing an array with all the default exports.

With this TSConfig and Options:

1{
2  "baseUrl": "src",
3  "paths": {
4    "@test/*": [
5      "test/*"
6    ],
7  },
8}

1{
2  ext: '.ts',
3  resolveGlob: true,
4  resolvedExt: '.js',
5}

In:

1import foo from './foo'
2import doubleQ from "./doubleQ"
3import { build } from 'esbuild'
4import item from '@test/file'
5import glob from 'glob:./*.js'

Out:

1import foo from './foo.js'
2import doubleQ from './doubleQ.js'
3import { build } from 'esbuild'
4import item from './src/test/file.js'
5import module0 from './randomModule.js'
6import module1 from './anotherRandomModule.js'
7import module2 from './yetAnotherRandomModule.js'
8const glob = [module0, module1, module2]

Options

• ext (default: .ts): Which file extension should the plugin match.
• resolvedExt (default: .js): Which extension should be added to the imports.
• resolveGlob (default: false): If glob expressions should be resolved.

Usage

1// vite.config.ts
2import unpluginResolveEsmTSPaths from 'unplugin-resolve-esm-ts-paths/vite'
3
4export default defineConfig({
5  plugins: [
6    unpluginResolveEsmTSPaths({ /* options */ }),
7  ],
8})

1// rollup.config.js
2import unpluginResolveEsmTSPaths from 'unplugin-resolve-esm-ts-paths/rollup'
3
4export default {
5  plugins: [
6    unpluginResolveEsmTSPaths({ /* options */ }),
7    // other plugins
8  ],
9}

1// webpack.config.js
2module.exports = {
3  /* ... */
4  plugins: [
5    require('unplugin-resolve-esm-ts-paths/webpack')({ /* options */ }),
6  ],
7}

1// esbuild.config.js
2import unpluginResolveEsmTSPaths from 'unplugin-resolve-esm-ts-paths/esbuild'
3
4build({
5  /* ... */
6  plugins: [
7    unpluginResolveEsmTSPaths({ /* options */ }),
8  ],
9})

Types

If you want to solve the ts(2307) issue for the glob imports, you can add this to one of your .d.ts type definitions:

1declare module 'glob:*' {
2  const modules: unknown[];
3  export default modules;
4}