Raynosmercury-jsxify
Browserify transform for JSX (superset of JavaScript used in React library):
/**
* @jsx h
*/
var h = require("mercury").h
function hello(name) {
return <div>Hello, {name}!</div>
}
mercury.app(
document.getElementById('hello'),
mercury.value('world'),
hello
)
Save the snippet above as main.js and then produce a bundle with the following
command:
% browserify -t mercury-jsxify main.js
mercury-jsxify transform activates for files with either .jsx extension or /**
@jsx React.DOM */ pragma as a first line for any .js file.
If you want to mercury-jsxify modules with other extensions, pass an -x /
--extension option:
% browserify -t coffeeify -t [ mercury-jsxify --extension coffee ] main.coffee
If you don't want to specify extension, just pass --everything option:
% browserify -t coffeeify -t [ mercury-jsxify --everything ] main.coffee
ES6 transformation
mercury-jsxify transform also can compile a limited set of es6 syntax constructs
into es5. Supported features are arrow functions, rest params, templates, object
short notation and classes. You can activate this via --es6 or --harmony
boolean option:
% browserify -t [ mercury-jsxify --es6 ] main.js
You can also configure it in package.json
{
"name": "my-package",
"browserify": {
"transform": [
["mercury-jsxify", {"es6": true}]
]
}
}
Using 3rd-party jstransform visitors
mercury-jsxify uses jstransform to transform JavaScript code. It allows code transformations to be pluggable and, what's more important, composable. For example JSX and es6 are implemented as separate code transformations and still can be composed together.
mercury-jsxify provides --visitors option to specify additional jstransform visitos
which could perform additional transformations.
It should point to a module which exports visitorList attribute with a list of
transformation functions to be applied:
% browserify -t [ mercury-jsxify --visitors es6-module-jstransform/visitors ] main.js
Example above uses es6-module-jstransform to compile es6 module syntax
(import and export declarations) into CommonJS module constructs.