Skip to content

esbuild plugin for compiling typescript declarations along with path aliases transformation.

Notifications You must be signed in to change notification settings

ArtemKlyuev/esbuild-plugin-d-ts-path-alias

Repository files navigation

esbuild-plugin-d-ts-path-alias GitHub package.json version Tests Commitizen friendly

esbuild plugin for compiling typescript declarations along with path aliases transformation.

⚠️ version >=3.0.0 of this package require esbuild ^0.17.0, typescript >=5 and nodejs >=16.10

Table of contents

Installation

# Using npm
npm install esbuild-plugin-d-ts-path-alias --save-dev
# Using yarn
yarn add esbuild-plugin-d-ts-path-alias -D

Problem

When you write code and use path aliases, paths are not transformed when you compile declaration files.

// source file index.ts

import { foo } from '@utils/foo';
import type { Foo } from '@utils/foo';
// compiled declaration file index.d.ts

import type { Foo } from '@utils/foo';

This plugin will help you solve this problem when you compile declaration files the paths are converted to relative.

Config

The plugin can optionally accept a config.

tsconfigPath

Custom path to tsconfig.json. If specified, it will be used as the highest priority path to tsconfig.

Type Required Default
string no

outputPath

Custom path to output declaration files. If specified, it will be used as the highest priority path to compiled files, specifying this argument ignores declarationDir and outDir in tsconfig.json.

Type Required Default
string no

debug

Should plugin output debug logs to console.

Type Required Default
boolean no false

Usage

You can manipulate the location of the output files by setting one of the following settings (in order of priority):

  1. outputPath in plugin config
  2. declarationDir in tsconfig.json
  3. outDir in tsconfig.json
  4. if none of these options are specified, then the outdir or outfile property from the esbuild config will be used

Default usage

import { build } from 'esbuild';
import { dTSPathAliasPlugin } from 'esbuild-plugin-d-ts-path-alias';

build({
  bundle: true,
  target: 'es2019',
  format: 'esm',
  entryPoints: ['./src/index.ts'],
  outfile: './build/out.js',
  plugins: [dTSPathAliasPlugin()],
});

With config

import { build } from 'esbuild';
import { dTSPathAliasPlugin } from 'esbuild-plugin-d-ts-path-alias';

build({
  bundle: true,
  target: 'es2019',
  format: 'esm',
  entryPoints: ['./src/index.ts'],
  outfile: './build/out.js',
  plugins: [
    dTSPathAliasPlugin({
      tsconfigPath: './config/tsconfig.declaration.json',
      outputPath: './build/declaration',
      debug: true,
    }),
  ],
});