Registry / devops / esbuild-plugin-ts

esbuild-plugin-ts

JSON →
library0.1.1-rev-1.0jsnpmunverified

esbuild-plugin-ts is an esbuild plugin that integrates TypeScript's exotic features, such as type checking, decorator metadata emission, and path alias resolution. Current version is 0.1.1-rev-1.0, released as in-development and not feature complete. It leverages the TypeScript compiler (tsc) under the hood to address esbuild's limitations in handling TypeScript while remaining fast via worker threads. Key differentiators: focuses on bridging gaps for advanced TypeScript features like decorators and path aliases, unlike simpler plugins that only provide basic transpilation.

npm install esbuild-plugin-ts
INSTALL
IMPORT
SIG · ESBUILD-PLUGIN-TS
E
esbuild-plugin-ts
devopsjavascriptv0.1.1-rev-1.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

esbuildPluginTs
import esbuildPluginTs from 'esbuild-plugin-ts'
const esbuildPluginTs = require('esbuild-plugin-ts').default
Default export; CommonJS users should use require('esbuild-plugin-ts').default or set esModuleInterop.
EsbuildPluginTsOptions
import type { EsbuildPluginTsOptions } from 'esbuild-plugin-ts'
import { EsbuildPluginTsOptions } from 'esbuild-plugin-ts'
Type import only; do not use value import as it will cause runtime error
plugin
import esbuildPluginTs from 'esbuild-plugin-ts'; esbuildPluginTs()
esbuildPluginTs.plugin()
The default export is a function that returns the plugin object, not an object with a plugin property.

Basic usage of esbuild-plugin-ts to bundle a TypeScript entry point with type checking and advanced transforms.

import { build } from 'esbuild'; import esbuildPluginTs from 'esbuild-plugin-ts'; build({ entryPoints: ['src/index.ts'], bundle: true, outfile: 'dist/out.js', plugins: [esbuildPluginTs()] }).catch(() => process.exit(1));
Debug
Known issues
breakingesbuildPluginTs() may throw if no tsconfig.json is found.
fix
Ensure a tsconfig.json exists in the project root, or pass options with a custom tsconfig path.
affects: >=0.1.0
deprecatedThe plugin is in-development and not feature complete; features listed as '[ ]' are not yet implemented.
fix
Check the README for feature status; do not rely on unimplemented features like path alias resolution or decorator metadata.
affects: >=0.0.0
gotchaTypeScript worker thread may cause port conflicts if multiple builds run concurrently.
fix
Avoid running multiple builds simultaneously, or serialize builds.
affects: >=0.1.0
gotchaType errors from tsc are not propagated as esbuild errors; build may succeed even with type errors.
fix
Manually check tsc output or use a separate type checking step.
affects: >=0.1.0
Errors
Common errors & fixes
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'esbuild-plugin-ts' imported from ...
Package not installed or not in node_modules.
fix
Run `npm install esbuild-plugin-ts` or `yarn add esbuild-plugin-ts`.
TypeError: esbuildPluginTs is not a function
Importing wrong export (e.g., using destructured import instead of default).
fix
Use `import esbuildPluginTs from 'esbuild-plugin-ts'` and call as `esbuildPluginTs()`.
Error: [esbuild-plguin-ts] Unable to locate tsconfig.json. Ensure you have a tsconfig.json in the project root or provide the path via options.
No tsconfig.json found.
fix
Create a tsconfig.json file or pass `{ tsconfig: 'path/to/tsconfig.json' }` in the options.
Upgrade
Version history
0.1.1-rev-1.0latest on npm
Audit
Dependencies
esbuildrequiredpeer dependency: plugin is designed to be used as an esbuild plugin
typescriptrequireduses TypeScript compiler for type checking and emit features
Agent activity
2 hits · last 30 days
node
2
Resources
esbuild-plugin-ts — npm install esbuild-plugin-ts · libregistry