esbuild-plugin-tsc

An esbuild plugin which uses tsc to compile typescript files.

Why?

Esbuild natively supports typescript files - so if you are not using exotic typescript features this plugin is not meant for you!

I wanted to use typescripts emitDecoratorMetadata feature, which is not supported by esbuild. If you are only using typescript decorators in some files, this plugin allows you to convert only the files containing decorators and lets esbuild handle all other files. If for some reason you want to use typescripts compiler for all files you can simple set the force option.

Basic Usage

1. Install this plugin in your project:

   1npm install --save-dev esbuild-plugin-tsc typescript

2. Add this plugin to your esbuild build script:

   Javascript:

   1+const esbuildPluginTsc = require('esbuild-plugin-tsc');
   2 ...
   3 esbuild.build({
   4   ...
   5   plugins: [
   6+    esbuildPluginTsc(),
   7   ],
   8 })

   Typescript:

   1+import esbuildPluginTsc from 'esbuild-plugin-tsc';
   2 ...
   3 esbuild.build({
   4   ...
   5   plugins: [
   6+    esbuildPluginTsc(),
   7   ],
   8 })

Config

1esbuildPluginTsc({
2    // If empty, uses tsconfig.json
3    tsconfigPath?: string,
4    // If true, force compilation with tsc
5    force?: boolean,
6    // If true, force TypeScript to treat files without the `.mts` extension as ESM
7    forceEsm?: boolean,
8    // If true, enables tsx file support
9    tsx?: boolean
10})