babel-preset-bonita

1.0.2 verified Sat Apr 25 auth: no javascript

Babel preset for Bonita plugins, providing a curated set of Babel plugins for use with Bonita projects. Version 1.0.2 is stable, but version 2.0.0 has been released with potential breaking changes. This preset simplifies Babel configuration for Bonita plugin development, but usage outside of Bonita projects is not recommended. Compare to other presets like @babel/preset-env which are more general-purpose.

Common errors

error Module build failed: Error: Cannot find module 'babel-preset-bonita' ↓

cause Missing package installation

fix

npm install --save-dev babel-preset-bonita

error Error: Plugin/Preset files are not allowed to export objects, only functions. ↓

cause Mismatched Babel version (Babel 7 expects function, not object)

fix

Use preset function or upgrade package

Warnings

deprecated Version 2.0.0 may break compatibility with Babel 6 ↓

fix Use Babel 7 or stick with 1.x for Babel 6

gotcha Preset is designed for Bonita plugins; may not work with generic Babel projects ↓

fix Only use in Bonita plugin development

Install

npm install babel-preset-bonita

yarn add babel-preset-bonita

pnpm add babel-preset-bonita

Imports

Babel preset default
wrong
```
module.exports = { presets: [require('babel-preset-bonita')] }
```
correct
```
module.exports = { presets: ['bonita'] }
```
Typically used in .babelrc or babel.config.js by name string, not required()

Babel preset function

wrong

module.exports = { presets: ['babel-preset-bonita'] }

correct

module.exports = { presets: [[require('babel-preset-bonita'), { options }]] }

When using options in Node API, use full require path

Babel plugin from preset

wrong

import { plugin } from 'babel-preset-bonita'

correct

import plugin from 'babel-preset-bonita/lib/plugin'

Internal plugins are not exported; the preset exports a function

Quickstart

Configure Babel with the Bonita preset via .babelrc, CLI, or Node API.

// .babelrc
{
  "presets": ["bonita"]
}

// Then transform a file via CLI
// $ babel script.js --presets bonita

// Or via Node API
const babel = require('@babel/core');
babel.transformSync('code', {
  presets: ['bonita']
});