GitHub - ArtemKlyuev/esbuild-plugin-d-ts-path-alias: esbuild plugin for compiling typescript declarations along with path aliases transformation. (original) (raw)

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, }), ], });