electrum-compiler

electrum-compiler

This is a run-time compiler for Electrum-enabled React components, based on Babel and relying on babel-standalone.

The Compiler class

Transform JavaScript to ES2015

let input = 'const greet = x => `Hello ${x}.`;';
let compiler = new Compiler ();
let source = compiler.transform (input);
// ES2015 compatible source

Build Electrum-enabled React component

let input = 'class extends React.Component { render() { return <div>Hi.</div>; } }';
let compiler = new Compiler ();
let output = compiler.build ('Foo', input);
// Component in output.component

If the source code needs to reference external symbols (for instance other components), they must be registered before calling build():

let input = `
class extends React.Component {
  render() {
    return <Button>{text}</Button>;
  }
}`;

let compiler = new Compiler ();

compiler.register (Button);
compiler.register ('text', 'Hello')

let output = compiler.build ('Foo', input);
// Component in output.component

The output of build() is an object with following properties:

• name → name of the component.
• code → source code used to produce the component.
• component → the component.
• error → the error (if there was an error).

Properties code and component are only present if the call to build() was successful. Otherwise, the error message is stored in error.

Note that the position in the error message will be offset by one line, as build() prepends some code to the given input source.