NAME 
JSX - a faster, safer, easier JavaScript
INSTALLATION
The JSX compiler toolkit is released as a npm package, so you can install it with npm install -g jsx.
COMPILATION
There's jsx(1) command to compile JSX source code into JavaScript.
Type the following commands and see what happens:
# run Hello World in JSX
jsx --run example/hello.jsx
# compile it and output the generated code to stdout
jsx example/hello.jsx
# compile it with full optimizations
jsx --release --output hello.jsx.js example/hello.jsx
# compile it for node and execute it
jsx --executable node --output hello.jsx.js example/hello.jsx
./hello.jsx.js # displays "Hello, world!"
# run a test, calling _Test#test*()
jsx --test example/import.jsx # import.jsx has _Test
jsx --help shows how to to use the jsx command.
INTRODUCTION
Here is a fizzbuzz problem, which can be executed by jsx --run fizzbuzz.jsx, showing a basic syntax of JSX.
class _Main {
static function main(args :string[]) : void {
for (var i = 1; i <= 100; ++i) {
if (i % 15 == 0)
log "FizzBuzz";
else if (i % 3 == 0)
log "Fizz";
else if (i % 5 == 0)
log "Buzz";
else
log i;
}
}
}
See the documentation for details.
EXAMPLES
There are JSX source files in example/ and web/example/, and the the test directory t/.
DEVELOPMENT OF JSX COMPILER
If you are interested in development of the JSX compiler, you should set up your environment after cloning the repo. The SDK development requires LSB 4.1 (Perl 5.8.8 and some UNIX commands) as well as NodeJS 0.8.0 or later.
To setup JSX SDK, type the following command:
git clone --recursive git://github.com/jsx/JSX.git
cd JSX
make # to build bin/jsx
# edit JSX compiler source files
make test # to make sure it works
We recommend to install jsx(1) as a link of $JSX/bin/jsx to ~/bin/jsx.
ln -s "$PWD/bin/jsx" ~/bin
DEVELOPMENT WEB SERVER
There's a web interface, which provides a web compiler and web application examples.
Type the following commands to run the server:
make server # to run an HTTP daemon
open http://localhost:2012/
This server is also used to show results of JSX profiler.
See Using the Profiler for details.
TESTING
There are unit tests in t/ directory. Just type the following command to run the tests:
make test
These test cases are executed by prove(1) and dispatched by t/util/test-runner, and also requires phantomjs(1)
Note that if you make a pull request you have to make sure make test-all for complete tests.
NOTE: There are some TODO tests, which should be resolved in a future. make show-todo shows such TODOs.
WINDOWS SUPPORT
npm install -g jsx should work even on Windows.