Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shrynx/rollup-plugin-bucklescript
rollup plugin for using bucklescript
https://github.com/shrynx/rollup-plugin-bucklescript
bucklescript reason reasonml rollup-plugin
Last synced: 25 days ago
JSON representation
rollup plugin for using bucklescript
- Host: GitHub
- URL: https://github.com/shrynx/rollup-plugin-bucklescript
- Owner: shrynx
- License: mit
- Archived: true
- Created: 2017-11-01T05:26:50.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-02T16:08:23.000Z (over 6 years ago)
- Last Synced: 2024-10-11T19:24:23.144Z (2 months ago)
- Topics: bucklescript, reason, reasonml, rollup-plugin
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/rollup-plugin-bucklescript
- Size: 49.8 KB
- Stars: 23
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - bucklescript - Compile ReasonML / OCaml. (Plugins / Transpilation)
README
# rollup-plugin-bucklescript
[](https://badge.fury.io/js/rollup-plugin-bucklescript)
> [bucklescript](https://github.com/BuckleScript/bucklescript) compiler plugin for [rollup.js](https://rollupjs.org/)
works with both [ReasonML](https://reasonml.github.io/) and [OCaml](http://ocaml.org/)
## Usage
### Installation
First install `bs-platform` in your project
```shell
npm i -D bs-platform
```
create a `bsconfig.json` for Bucklescript in the root directory of your project
and remember to specify `"package-specs"` as `["es6"]`, so that rollup can consume it.
```javascript
{
"name": "hello",
"sources": ["src"],
"bs-dependencies": ["reason-react"],
"reason": {
"react-jsx": 2
},
"package-specs": ["es6"],
"refmt": 3
}
```
Finally, install `rollup-plugin-bucklescript`
```shell
npm i -D rollup-plugin-bucklescript
```
and add it to your rollup config.
```javascript
import bucklescript from 'rollup-plugin-bucklescript'
export default {
input: 'src/main.re',
output: {
file: 'dist/main.js',
format: 'cjs',
},
plugins: [
bucklescript()
],
}
```
### Options
All the settings are taken from `bsconfig.json`, but few options can be overridden.
### `include` and `exclude`
each a minimatch pattern, or array of minimatch patterns, which determines which files are complied by Bucklescript.
By default all `.re` and `.ml` are included and all `.rei` and `.mli` are excluded.
### `module`
To specify bucklescript output type for rollup to consume.
**Note: Please check the [Caveats](#caveats) section**
```javascript
...
plugins: [
bucklescript({
module: 'es6'
})
]
```
### `inSource`
To use bs-loader with [bsb's in-souce builds](https://bucklescript.github.io/bucklescript/Manual.html#_in_source_build_support_since_1_9_0),
add the `inSource` option to your loader config:
```javascript
...
plugins: [
bucklescript({
inSource: false
})
]
```
### `cwd`
This option specifies what directory to run `bsb` from.
```javascript
...
plugins: [
bucklescript({
cwd: 'path/to/dir'
})
]
```
### `showWarnings`
Controls whether `bsb` compile warnings are shown. Defaults to `true`.
```javascript
...
plugins: [
bucklescript({
showWarnings: true
})
]
```
### `includeStandardLibrary`
**Note: This is an advance feature and may not work as intended**
Bucklescript comes with OCaml standard library complied to javascript.
Choose whether to bundle functions from standard library.
Defaults to `true`.
## Examples
Check the [examples folder](https://github.com/shrynx/rollup-plugin-bucklescript/tree/master/examples) in the github repo.
## Caveats
Please use `es6` for `module` option as rollup works only with es modules.
But this breaks integration with with react,
thought it can be easily solved by following the helpful error message provided by rollup.
or check the [react example](https://github.com/shrynx/rollup-plugin-bucklescript/tree/master/examples/react) folder.
## Acknowledgement
- [bs-loader](https://github.com/reasonml-community/bs-loader) - A webpack plugin for bucklescript,
for providing `bsb-js` and `read-bsconfig`.
- Reason team at facebook and all the project contributors for making ReasonML
- [@bobzhang](https://github.com/bobzhang) and all contributors of bucklescript.
## License
MIT