Getting Started (JavaScript Runtime)

To install Calcium runtime for JavaScript via npm, you can run the following command:

npm install calcium-js

Running Calcium JSON code with the JavaScript runtime is straightforward. You can create a Runtime instance with the JSON code and call the run method to execute it. For example:

import { Runtime } from "calcium-js"

const code = [
  [1, [], "expr", ["call", ["prop", ["var", "console"], "log"], ["Hello, World."]]],
  [1, [], "end"]
]
const runtime = new Runtime(code, {
//  canAccessWindow: true, // in browser environment to use console.log
  enableGlobal: true, // in Node.js environment to use console.log
})
runtime.run()

says "Hello, World." as output.

Converter

The convert function can convert JavaScript code into Calcium commands.

import { convert } from "calcium-js/tool"

const commands = convert(`
  console.log("Hello, World.")
`)

console.log(commands)

This will output the following commands:

[
[1, [], "expr", ["call", ["prop", ["var", "console"], "log"], ["Hello, World."]]],
[1, [], "end"]
]

Since Calcium does not support all JavaScript features, some code may not be converted correctly.

Applications

Coming soon...