TypeScript type-checking plugin for esbuild
npm install @jgoz/esbuild-plugin-typecheckAn esbuild plugin for TypeScript type checking and side-channel compilation.
- Runs asynchronously in a worker thread
- Supports project references and build mode
- Reports errors to @jgoz/esbuild-plugin-livereload
``console`
$ npm i @jgoz/esbuild-plugin-typecheck
Add it to your esbuild plugins:
`js
const esbuild = require('esbuild');
const { typecheckPlugin } = require('@jgoz/esbuild-plugin-typecheck');
await esbuild.build({
// ...
plugins: [typecheckPlugin()],
});
`
#### function typecheckPlugin(options?: TypecheckPluginOptions): Plugin
Plugin options:
| Name | Type | Default | Description |
| ---- | ---- | ------- | ----------- |
| build | boolean \| BuildOptions | - | Run the compiler in build mode, equivalent to running tsc --build. Normally, this will be inferred if tsconfig.json sets "composite": true but it can be overridden by this option."readonly" \| "write-output"
This option also accepts an object, which implicitly turns build mode on. The object accepts build-mode-specific options that will be passed to the TypeScript compiler API. |
| buildMode | | "readonly" | Changes the behavior of build mode with respect to program output (JavaScript, type definitions, sourcemaps, and .tsbuildinfo files).readonly (default) — output files will be written to an in-memory file system and discared after esbuild exitswrite-output — output files will be written to disk as though you had invoked tsc --build
There are tradeoffs between the two modes. In mode, the initial typecheck may be slower, especially if the output/.tsbuildinfo files do not match the source files. However, subsequent incremental typechecks may be slightly faster since no I/O is involved. This mode is also the least surprising because typechecking implies a different intent than compilation, but TypeScript's build mode needs to produce output in order to remain fast for incremental compilation.write-output
In mode, the output files will always be in sync with the input files, so the initial compilation may be slightly faster. However, subsequent incremental typechecks might be slightly slower due to I/O overhead. This mode would be appropriate to enable as an alternative to invoking tsc --build manually, e.g., in the case where the TypeScript output itself may be used outside of esbuild. |CompilerOptions
| compilerOptions | | {} | TypeScript compiler option overrides that will be merged into the options in "tsconfig.json". |string
| configFile | | - | Path to "tsconfig.json". If not specified, this will use ESBuild's "tsconfig" option, finally falling back to TypeScript's config file resolution algorithm. |Logger
| logger | | - | Logger to use instead of the default. |boolean
| omitStartLog | | false | Omit "Typecheck started" messages. |boolean` | - | Enable typescript's watch mode |
| watch |