bsb-native

BuckleScript

A JavaScript backend for OCaml focused on smooth integration and clean generated code.

Documentation

Please see the documentation site.

Contributing

See CONTRIBUTING.md.

Acknowledgments

• Thanks to the OCaml team, obviously, without such a beautiful yet practical language, this backend would not exist
• Thanks to ninja-build, BuckleScript also comes with a blazing fast build tool on top of it, ninja is a truly well engineered scalable build tool
• Thanks to Bloomberg and Facebook. This project began at Bloomberg and was published in 2016; without the support of Bloomberg, it would not have happened. This project's funded by Facebook since July/2017

Licensing

See COPYING and COPYING.LESSER

The ocaml directory contains the official OCaml compiler (version 4.02.3). Refer to its copyright and license notices for information about its licensing.

The vendor/ninja.tar.gz contains the vendored ninja. Refer to its copyright and license notices for information about its licensing.

BuckleScript builds on parts of js_of_ocaml:

• jscomp/core/js_dump.ml (pretty printer)

BuckleScript builds on parts of OCaml:

• jscomp/core/lam_pass_exits.ml
• jscomp/core/lam_pass_lets_dce.ml

These modules were adapted from ocaml/bytecomp/simplif.ml for JavaScript specific optimization purposes.

• jscomp/main/js_main.ml

jscomp/main/js_main.ml is adapted from ocaml/driver/main.ml. It is the main entry point of the underlying compiler.

• jscomp/stdlib-406

jscomp/stdlib-* is copied from ocaml/stdlib. It is compiled to JavaScript and included with BuckleScript.

• jscomp/test

jscomp/test is based on ocaml/testsuite.

BuckleScript unit test builds on parts of OUnit

• jscomp/ounit is adapted from ounit, the unit test utilities are only used for dev purpose, they are not required for distribution

Changelog

5.0.0

Features

• #3418 sync up with refmt 681c491ba760cdf3b49f92297c3dab1703682808
• #3395, #3417 better gentype support (gentype.import)
• #3412,#3416 Warning against usage of string_of_float
• #3414, #3415, #2893 allow usage of a |. M.(f a b)
• #3403 first class bs.variadic support
• #3402 in watch mode, clear the screen upon rebuilding
• #3397 add ignored-dirs support in bsconfig.json
• #3377, #3376 add Linux prebuilt support for official release
• #3372 add Belt.Array.getIndexBy
• #3357, add -bs-cmi-only flag support to bsc so that no js emitted
• #3356, #3354 add gentypeconfig support in bsconfig.json
• #3352 fix minor mistake in Js.Dict.values doc
• #3329 Allow namespace in bsconfig.json to be customized
• #3334 Add Belt.Array.getBy
• #3204, #3208 add bs.deriving {light} support to allow short names Fixes
• #3413, #2893 deprecate Js.Array.join
• #3407, #3408 rebuild when ppx binary changes
• #3406, #3399 fix the interaction between external and relative paths
• #3393 deprecate Node.Fs.Watch.on in favor of Node.Fs.Watch.on_
• #3315 depercate Js.Re.test, Js.Re.exec in favor of Js.Re.test*, Js.Re.exec*
• #3386, #3387 fix a codegen in with bs.raw
• #3386 make it more forgiving when interact with Js functions with arity 0
• #3381 remove golang as a dev dependency

• #3388 (breaking) Fix Js.Re.(splitbyReAtMost, splitByRe) binding

• #3332 remove -bs-gen-tds from docs in favor of gentype