Compile a machine's JSON intermediate representation to a config object. If you're using this (probably don't,) you're probably also using parse to get the IR, and the object constructor Machine.constructor to turn the config object into a workable machine.

import { parse, compile, Machine } from 'jssm';

const intermediate = parse('a -> b;');
// [ {key:'transition', from:'a', se:{kind:'->',to:'b'}} ]

const cfg = compile(intermediate);
// { start_states:['a'], transitions: [{ from:'a', to:'b', kind:'legal', forced_only:false, main_path:false }] }

const machine = new Machine(cfg);
// Machine { _instance_name: undefined, _state: 'a', ...
Copy

This method is mostly for plugin and intermediate tool authors, or people who need to work with the machine's intermediate representation.

Source-location-aware error reporting

compile() ignores loc and *_loc fields during machine construction — the resulting config is identical whether or not the tree was parsed with { locations: true }. However, when those fields are present, compile() attaches the offending node's source span to any semantic JssmError it throws, via the error's source_location field (type FslSourceLocation). This lets downstream tooling (e.g. a CodeMirror 6 linter) map the error to a precise editor range without any additional source-scanning.

import { parse, compile } from 'jssm';

try {
  compile(parse('fsl_version: 1.0.0;\nfsl_version: 2.0.0;\na -> b;',
                { locations: true }));
} catch (err) {
  // err.source_location.start.offset points at the second fsl_version line
  console.log(err.source_location);
}
Copy