Package Exports

esbuild-plugin-d-ts-path-alias
esbuild-plugin-d-ts-path-alias/dist/cjs/index.js
esbuild-plugin-d-ts-path-alias/dist/esm/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (esbuild-plugin-d-ts-path-alias) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

esbuild-plugin-d-ts-path-alias

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

Installation
Problem
Config
Usage

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.

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):

outputPath in plugin config
declarationDir in tsconfig.json
outDir in tsconfig.json
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,
    }),
  ],
});