Registry / esbuild-plugin-decorator

esbuild-plugin-decorator

library0.4.0jsnpmunverified

An ESBuild plugin that enables TypeScript decorator support during bundling. Version 0.4.0 compiles decorators using SWC under the hood, preserving semantics while maintaining fast build speeds. It integrates as an esbuild plugin with no config changes beyond registration. Key differentiators: leverages SWC's stable decorator transform, supports both legacy and TC39 stage 3 decorators, and works alongside other ESBuild plugins. Updated irregularly.

npm install esbuild-plugin-decorator

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-DEC

esbuild-plugin-decorator

javascriptv0.4.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

esbuildPluginDecorator

✓ import esbuildPluginDecorator from 'esbuild-plugin-decorator'

✗ const { esbuildPluginDecorator } = require('esbuild-plugin-decorator')

Default export only. ESBuild plugins are often loaded via ESM default import.

default

✓ import decoratorPlugin from 'esbuild-plugin-decorator'

The package has a default export. Name your import anything you like.

EsbuildPluginDecoratorOptions

✓ import type { EsbuildPluginDecoratorOptions } from 'esbuild-plugin-decorator'

Type import for configuration options. Exported as a named type.

Shows how to register the decorator plugin with esbuild, specifying the tsconfig path and decorator version (legacy for TypeScript <5.0, tc39 for modern).

import esbuild from 'esbuild'; import esbuildPluginDecorator from 'esbuild-plugin-decorator'; await esbuild.build({ entryPoints: ['src/index.ts'], bundle: true, outfile: 'dist/bundle.js', plugins: [ esbuildPluginDecorator({ tsconfig: './tsconfig.json', decoratorVersion: 'legacy', // 'legacy' | 'tc39' }), ], });

Debug

Known issues

gotchaThe plugin requires @swc/core to be installed as a peer dependency. Missing it causes a runtime error when decorators are encountered.

fix

Install @swc/core alongside this plugin: npm install @swc/core

affects: >=0.0.0

gotchaThe plugin does not handle export default class with decorators correctly; the decorator may not be applied properly in some edge cases.

fix

Avoid using export default class with decorators; use named exports instead.

affects: 0.4.0

deprecatedThe decoratorVersion option defaults to 'legacy' which is deprecated in TypeScript 5.0+. Users should migrate to 'tc39' for future compatibility.

fix

Set decoratorVersion: 'tc39' in plugin options.

affects: >=0.4.0

gotchaIf your tsconfig.json has 'useDefineForClassFields' set to false, the plugin may produce incorrect output. It assumes true.

fix

Set useDefineForClassFields: true in tsconfig.json.

affects: >=0.4.0

Errors

Common errors & fixes

Error: Cannot find module '@swc/core'

Missing peer dependency @swc/core.

fix

Run: npm install @swc/core

Error: The decorator plugin only supports one decorator version per build

Passing multiple decoratorVersion values or conflicting config.

fix

Ensure decoratorVersion is a single string: 'legacy' or 'tc39'.

TypeError: esbuildPluginDecorator is not a function

Importing a named export instead of default.

fix

Use: import esbuildPluginDecorator from 'esbuild-plugin-decorator'

Upgrade

Version history

0.4.0latest on npm

Audit

Dependencies

@swc/corerequiredRuntime dependency for compiling TypeScript decorators

esbuildrequiredPeer dependency; esbuild-plugin-decorator is a plugin for ESBuild

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/linbudu599/nx-plugins ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-decorator ↗