Experimental ClojureScript to ES6 module compiler.
npm install cherry-cljsExperimental ClojureScript to ES6 module compiler.
Reducing friction between ClojureScript and JS tooling.
> :warning: This project is an experiment and not recommended to be used in
> production. It currently has many bugs and will undergo many breaking changes.
Also check out Squint which
is a CLJS _syntax_ to JS compiler.
Although it's early days and far from complete, you're welcome to try out cherry and submit issues.
`` shell`
$ mkdir cherry-test && cd cherry-test
$ npm init -y
$ npm install cherry-cljs@latest
Create a .cljs file, e.g. example.cljs:
` clojure
(ns example
(:require ["fs" :as fs]
["url" :refer [fileURLToPath]]))
(prn (fs/existsSync (fileURLToPath js/import.meta.url)))
(defn foo [{:keys [a b c]}]
(+ a b c))
(js/console.log (foo {:a 1 :b 2 :c 3}))
`
Then compile and run (run does both):
`
$ npx cherry run example.cljs
true
6
Run npx cherry --help to see all command line options.
A few examples of currenly working projects compiled by cherry:
- Cherry ClojureScript template on livecodes.io
- playground
- wordle
- react
- vite
- cherry-action-example
See the examples directory for more.
Goals of cherry:
- Compile .cljs files on the fly into ES6-compatible .mjs files."cherry-cljs"
- Compiler will be available on NPM and can be used from JS tooling, but isn't
part of the compiled output unless explicitly used.
- Compiled JS files are fairly readable and have source map support for
debugging
- Compiled JS files are linked to one shared NPM module whichcljs.core.js
contains , cljs.string, etc. such that libraries written in[^:js {:keys [a b]} #js {:a 1 :b 2}]
cherry can be compiled and hosted on NPM, while all sharing the same
standard library and data structures. See this
tweet on how that
looks.
- Output linked to older versions of cherry will work with newer
versions of cherry: i.e. 'binary' compatibility.
- Light-weight and fast: heavy lifting such as optimizations are expected to be
done by JS tooling
- No dependency on Google Closure: this project will use it for bootstrapping
itself (by using the CLJS compiler), but users of this project won't use it for compilation
- Macro support
- REPL support
- Async/await support. See this tweet for a demo.
- Native support for JS object destructuring:
- Native support for JSX via reader tag. See example.
Cherry may introduce new constructs such as js-await which won't be compatible
with current CLJS. Also it might not support all features that CLJS offers. As
such, using existing libraries from the CLJS ecosystem or compiling Cherry CLJS
code with the CLJS compiler may become challenging. However, some results of
this experiment may end up as improvements in the CLJS compiler if they turn out
to be of value.
See slides of a presentation given at Dutch Clojure Days 2022 about cherry and squint.
Depending on interest both from people working on this and the broader
community, the above goals may or may not be pursued. If you are interested in
maturing cherry, please submit
issues for bug reports or share
your thoughts on Github
Discussions.
Cherry started out as a fork of
Scriptjure. Currently it's being
reworked to meet the above goals.
See embed.md.
` shell`
$ git clone git@github.com:squint-cljs/cherry.git
$ cd cherry
$ bb dev
See squint docs.
See squint docs.
License
=======
Cherry is licensed under the EPL, the same as Clojure core and Scriptjure. See epl-v10.html in the root directory for more information.