https://github.com/egoist/rollup-plugin-esbuild
Use ESBuild with Rollup to transform ESNext and TypeScript code.
https://github.com/egoist/rollup-plugin-esbuild
esbuild esnext rollup typescript
Last synced: 11 days ago
JSON representation
Use ESBuild with Rollup to transform ESNext and TypeScript code.
- Host: GitHub
- URL: https://github.com/egoist/rollup-plugin-esbuild
- Owner: egoist
- License: mit
- Created: 2020-05-09T04:06:51.000Z (almost 5 years ago)
- Default Branch: dev
- Last Pushed: 2025-02-27T03:51:08.000Z (about 2 months ago)
- Last Synced: 2025-04-09T19:09:18.490Z (11 days ago)
- Topics: esbuild, esnext, rollup, typescript
- Language: TypeScript
- Homepage:
- Size: 853 KB
- Stars: 637
- Watchers: 8
- Forks: 40
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-star - rollup-plugin-esbuild
- awesome-list - rollup-plugin-esbuild
- awesome-esbuild - rollup-plugin-esbuild
- awesome - rollup-plugin-esbuild - A plugin using esbuild to speed up Rollup bundling. (Bundle Tool)
README
**💛 You can help the author become a full-time open-source maintainer by [sponsoring him on GitHub](https://github.com/sponsors/egoist).**
---
# rollup-plugin-esbuild
 
[esbuild](https://github.com/evanw/esbuild) is by far one of the fastest TS/ESNext to ES6 compilers and minifier, this plugin replaces `rollup-plugin-typescript2`, `@rollup/plugin-typescript` and `rollup-plugin-terser` for you.
## Install
```bash
yarn add esbuild rollup-plugin-esbuild --dev
```## Usage
In `rollup.config.js`:
```js
import esbuild from 'rollup-plugin-esbuild'export default {
plugins: [
esbuild({
// All options are optional
include: /\.[jt]sx?$/, // default, inferred from `loaders` option
exclude: /node_modules/, // default
sourceMap: true, // default
minify: process.env.NODE_ENV === 'production',
target: 'es2017', // default, or 'es20XX', 'esnext'
jsx: 'transform', // default, or 'preserve'
jsxFactory: 'React.createElement',
jsxFragment: 'React.Fragment',
// Like @rollup/plugin-replace
define: {
__VERSION__: '"x.y.z"',
},
tsconfig: 'tsconfig.json', // default
// Add extra loaders
loaders: {
// Add .json files support
// require @rollup/plugin-commonjs
'.json': 'json',
// Enable JSX in .js files too
'.js': 'jsx',
},
}),
],
}
```- `include` and `exclude` can be `String | RegExp | Array[...String|RegExp]`, when supplied it will override default values.
- It uses `jsx`, `jsxDev`, `jsxFactory`, `jsxFragmentFactory` and `target` options from your `tsconfig.json` as default values.### Declaration File
There are serveral ways to generate declaration file:
- Use `tsc` with `emitDeclarationOnly`, the slowest way but you get type checking, it doesn't bundle the `.d.ts` files.
- Use [`rollup-plugin-dts`](https://github.com/Swatinem/rollup-plugin-dts) which generates and bundle `.d.ts`, also does type checking.
- Use [`api-extractor`](https://api-extractor.com/) by Microsoft, looks quite complex to me so I didn't try it, PR welcome to update this section.### Use with Vue JSX
Use this with [rollup-plugin-vue-jsx](https://github.com/xxholly32/rollup-plugin-vue-jsx):
```js
import vueJsx from 'rollup-plugin-vue-jsx-compat'
import esbuild from 'rollup-plugin-esbuild'export default {
// ...
plugins: [
vueJsx(),
esbuild({
jsxFactory: 'vueJsxCompat',
}),
],
}
```### Standalone Minify Plugin
If you only want to use this plugin to minify your bundle:
```js
import { minify } from 'rollup-plugin-esbuild'export default {
plugins: [minify()],
}
```### Optimizing Deps
You can use this plugin to pre-bundle dependencies using esbuild and inline them in the Rollup-generated bundle:
```js
esbuild({
optimizeDeps: {
include: ['vue', 'vue-router'],
},
})
```This eliminates the need of `@rollup/plugin-node-modules` and `@rollup/plugin-commonjs`.
Note that this is an **experimental features**, breaking changes might happen across minor version bump.
TODO: Maybe we can scan Rollup input files to get a list of deps to optimize automatically.
## Sponsors
[](https://github.com/sponsors/egoist)
## License
MIT © [EGOIST (Kevin Titor)](https://github.com/sponsors/egoist)