jssm 5.85.8 → 5.85.9

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-1055 merges; 167 releases; Changlogging the last 10 commits; Full changelog at [CHANGELOG.long.md](CHANGELOG.long.md)
+1056 merges; 167 releases; Changlogging the last 10 commits; Full changelog at [CHANGELOG.long.md](CHANGELOG.long.md)
 
 
 
@@ -18,6 +18,22 @@ Published tags:
 
 
 
+ 
+
+ 
+
+## [Untagged] - 9/12/2022 8:18:05 PM
+
+Commit [013999a77ce43ceed5eb982754ffe480fdddf159](https://github.com/StoneCypher/jssm/commit/013999a77ce43ceed5eb982754ffe480fdddf159)
+
+Author: `John Haugeland <stonecypher@gmail.com>`
+
+  * Pull arrows out into modules
+  * Fixes StoneCypher/fsl#1206
+
+
+
+
 &nbsp;
 
 &nbsp;
@@ -159,24 +175,4 @@ Commit [6475296d979dab3d227828b80319d60c4f6ab2f5](https://github.com/StoneCypher
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Reintroduce display text, lost in a bad merge
-
-
-
-
-&nbsp;
-
-&nbsp;
-
-<a name="5__85__2" />
-
-## [5.85.2] - 9/12/2022 10:03:27 AM
-
-Commit [98b7b14217ea7e83550e4ed15b6b6be80799e246](https://github.com/StoneCypher/jssm/commit/98b7b14217ea7e83550e4ed15b6b6be80799e246)
-
-Author: `John Haugeland <stonecypher@gmail.com>`
-
-Merges [461a287, 0f3025a]
-
-  * Merge pull request #539 from StoneCypher/TrimTweet
-  * Shorten the tweet notice
+  * Reintroduce display text, lost in a bad merge

package/README.md

@@ -18,7 +18,7 @@ Please edit the file it's derived from, instead: `./src/md/readme_base.md`
 
 
 
-* Generated for version 5.85.8 at 9/12/2022, 8:16:52 PM
+* Generated for version 5.85.9 at 9/12/2022, 9:03:57 PM
 
 -->
 # jssm
@@ -29,7 +29,7 @@ share online.  Easy to embed.
 
 Readable, useful state machines as one-liner strings.
 
-***4,864 tests*** run 5,755 times.  4,855 specs with 100.0% coverage, 9 fuzz tests with 13.2% coverage.  With 2,725 lines, that's about 1.8 tests per line, or 2.1 generated tests per line.
+***4,866 tests*** run 5,757 times.  4,857 specs with 100.0% coverage, 9 fuzz tests with 13.6% coverage.  With 2,754 lines, that's about 1.8 tests per line, or 2.1 generated tests per line.
 
 ***Meet your new state machine library.***
 

package/dist/es6/jssm.d.ts

@@ -1,133 +1,12 @@
 declare type StateType = string;
 import { JssmGenericState, JssmGenericConfig, JssmStateConfig, JssmTransition, JssmTransitionList, // JssmTransitionRule,
-JssmMachineInternalState, JssmParseTree, JssmStateDeclaration, JssmStateStyleKeyList, JssmLayout, JssmHistory, JssmSerialization, FslDirection, FslDirections, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult } from './jssm_types';
+JssmMachineInternalState, JssmStateDeclaration, JssmStateStyleKeyList, JssmLayout, JssmHistory, JssmSerialization, FslDirection, FslDirections, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult } from './jssm_types';
 import { arrow_direction, arrow_left_kind, arrow_right_kind } from './jssm_arrow';
+import { compile, make, wrap_parse } from './jssm_compiler';
 import { seq, unique, find_repeated, weighted_rand_select, weighted_sample_select, histograph, weighted_histo_key } from './jssm_util';
 import * as constants from './jssm_constants';
 declare const shapes: string[], gviz_shapes: string[], named_colors: string[];
 import { version, build_time } from './version';
-/*********
- *
- *  This method wraps the parser call that comes from the peg grammar,
- *  {@link parse}.  Generally neither this nor that should be used directly
- *  unless you mean to develop plugins or extensions for the machine.
- *
- *  Parses the intermediate representation of a compiled string down to a
- *  machine configuration object.  If you're using this (probably don't,) you're
- *  probably also using {@link compile} and {@link Machine.constructor}.
- *
- *  ```typescript
- *  import { parse, compile, Machine } from 'jssm';
- *
- *  const intermediate = wrap_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', ...
- *  ```
- *
- *  This method is mostly for plugin and intermediate tool authors, or people
- *  who need to work with the machine's intermediate representation.
- *
- *  # Hey!
- *
- *  Most people looking at this want either the `sm` operator or method `from`,
- *  which perform all the steps in the chain.  The library's author mostly uses
- *  operator `sm`, and mostly falls back to `.from` when needing to parse
- *  strings dynamically instead of from template literals.
- *
- *  Operator {@link sm}:
- *
- *  ```typescript
- *  import { sm } from 'jssm';
- *
- *  const lswitch = sm`on <=> off;`;
- *  ```
- *
- *  Method {@link from}:
- *
- *  ```typescript
- *  import * as jssm from 'jssm';
- *
- *  const toggle = jssm.from('up <=> down;');
- *  ```
- *
- *  `wrap_parse` itself is an internal convenience method for alting out an
- *  object as the options call.  Not generally meant for external use.
- *
- *  @param input The FSL code to be evaluated
- *
- *  @param options Things to control about the instance
- *
- */
-declare function wrap_parse(input: string, options?: Object): any;
-/*********
- *
- *  Compile a machine's JSON intermediate representation to a config object.  If
- *  you're using this (probably don't,) you're probably also using
- *  {@link parse} to get the IR, and the object constructor
- *  {@link Machine.construct} to turn the config object into a workable machine.
- *
- *  ```typescript
- *  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', ...
- *  ```
- *
- *  This method is mostly for plugin and intermediate tool authors, or people
- *  who need to work with the machine's intermediate representation.
- *
- *  # Hey!
- *
- *  Most people looking at this want either the `sm` operator or method `from`,
- *  which perform all the steps in the chain.  The library's author mostly uses
- *  operator `sm`, and mostly falls back to `.from` when needing to parse
- *  strings dynamically instead of from template literals.
- *
- *  Operator {@link sm}:
- *
- *  ```typescript
- *  import { sm } from 'jssm';
- *
- *  const lswitch = sm`on <=> off;`;
- *  ```
- *
- *  Method {@link from}:
- *
- *  ```typescript
- *  import * as jssm from 'jssm';
- *
- *  const toggle = jssm.from('up <=> down;');
- *  ```
- *
- *  @typeparam mDT The type of the machine data member; usually omitted
- *
- *  @param tree The parse tree to be boiled down into a machine config
- *
- */
-declare function compile<mDT>(tree: JssmParseTree): JssmGenericConfig<mDT>;
-/*********
- *
- *  An internal convenience wrapper for parsing then compiling a machine string.
- *  Not generally meant for external use.  Please see {@link compile} or
- *  {@link sm}.
- *
- *  @typeparam mDT The type of the machine data member; usually omitted
- *
- *  @param plan The FSL code to be evaluated and built into a machine config
- *
- */
-declare function make<mDT>(plan: string): JssmGenericConfig<mDT>;
 /*********
  *
  *  An internal method meant to take a series of declarations and fold them into
@@ -142,7 +21,7 @@ declare function state_style_condense(jssk: JssmStateStyleKeyList): JssmStateCon
 declare class Machine<mDT> {
     _state: StateType;
     _states: Map<StateType, JssmGenericState>;
-    _edges: Array<JssmTransition<mDT>>;
+    _edges: Array<JssmTransition<StateType, mDT>>;
     _edge_map: Map<StateType, Map<StateType, number>>;
     _named_transitions: Map<StateType, number>;
     _actions: Map<StateType, Map<StateType, number>>;
@@ -217,7 +96,7 @@ declare class Machine<mDT> {
     _start_state_style: JssmStateConfig;
     _end_state_style: JssmStateConfig;
     _state_labels: Map<string, string>;
-    constructor({ start_states, end_states, complete, transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, property_definition, state_property, fsl_version, dot_preamble, arrange_declaration, arrange_start_declaration, arrange_end_declaration, theme, flow, graph_layout, instance_name, history, data, default_state_config, default_active_state_config, default_hooked_state_config, default_terminal_state_config, default_start_state_config, default_end_state_config }: JssmGenericConfig<mDT>);
+    constructor({ start_states, end_states, complete, transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, property_definition, state_property, fsl_version, dot_preamble, arrange_declaration, arrange_start_declaration, arrange_end_declaration, theme, flow, graph_layout, instance_name, history, data, default_state_config, default_active_state_config, default_hooked_state_config, default_terminal_state_config, default_start_state_config, default_end_state_config }: JssmGenericConfig<StateType, mDT>);
     /********
      *
      *  Internal method for fabricating states.  Not meant for external use.
@@ -598,7 +477,7 @@ declare class Machine<mDT> {
      *  @typeparam mDT The type of the machine data member; usually omitted
      *
      */
-    list_edges(): Array<JssmTransition<mDT>>;
+    list_edges(): Array<JssmTransition<StateType, mDT>>;
     list_named_transitions(): Map<StateType, number>;
     list_actions(): Array<StateType>;
     get uses_actions(): boolean;
@@ -607,7 +486,7 @@ declare class Machine<mDT> {
     set themes(to: FslTheme | FslTheme[]);
     flow(): FslDirection;
     get_transition_by_state_names(from: StateType, to: StateType): number;
-    lookup_transition_for(from: StateType, to: StateType): JssmTransition<mDT>;
+    lookup_transition_for(from: StateType, to: StateType): JssmTransition<StateType, mDT>;
     /********
      *
      *  List all transitions attached to the current state, sorted by entrance and
@@ -669,7 +548,7 @@ declare class Machine<mDT> {
      *
      */
     list_exits(whichState?: StateType): Array<StateType>;
-    probable_exits_for(whichState: StateType): Array<JssmTransition<mDT>>;
+    probable_exits_for(whichState: StateType): Array<JssmTransition<StateType, mDT>>;
     probabilistic_transition(): boolean;
     probabilistic_walk(n: number): Array<StateType>;
     probabilistic_histo_walk(n: number): Map<StateType, number>;
@@ -762,7 +641,7 @@ declare class Machine<mDT> {
     post_hook_any_transition(handler: HookHandler<mDT>): Machine<mDT>;
     post_hook_entry(to: string, handler: HookHandler<mDT>): Machine<mDT>;
     post_hook_exit(from: string, handler: HookHandler<mDT>): Machine<mDT>;
-    edges_between(from: string, to: string): JssmTransition<mDT>[];
+    edges_between(from: string, to: string): JssmTransition<StateType, mDT>[];
     transition_impl(newStateOrAction: StateType, newData: mDT | undefined, wasForced: boolean, wasAction: boolean): boolean;
     /*********
      *
@@ -1130,7 +1009,7 @@ declare class Machine<mDT> {
      */
     force_transition(newState: StateType, newData?: mDT): boolean;
     current_action_for(action: StateType): number;
-    current_action_edge_for(action: StateType): JssmTransition<mDT>;
+    current_action_edge_for(action: StateType): JssmTransition<StateType, mDT>;
     valid_action(action: StateType, _newData?: mDT): boolean;
     valid_transition(newState: StateType, _newData?: mDT): boolean;
     valid_force_transition(newState: StateType, _newData?: mDT): boolean;
@@ -1183,7 +1062,7 @@ declare function sm<mDT>(template_strings: TemplateStringsArray, ...remainder: a
  *  @param ExtraConstructorFields Extra non-code configuration to pass at creation time
  *
  */
-declare function from<mDT>(MachineAsString: string, ExtraConstructorFields?: Partial<JssmGenericConfig<mDT>> | undefined): Machine<mDT>;
+declare function from<mDT>(MachineAsString: string, ExtraConstructorFields?: Partial<JssmGenericConfig<StateType, mDT>> | undefined): Machine<mDT>;
 declare function is_hook_complex_result<mDT>(hr: unknown): hr is HookComplexResult<mDT>;
 declare function is_hook_rejection<mDT>(hr: HookResult<mDT>): boolean;
 declare function abstract_hook_step<mDT>(maybe_hook: HookHandler<mDT> | undefined, hook_args: HookContext<mDT>): HookComplexResult<mDT>;

package/dist/es6/jssm.js

@@ -1,8 +1,11 @@
 // whargarbl lots of these return arrays could/should be sets
-import { reduce as reduce_to_639 } from 'reduce-to-639-1';
 import { circular_buffer } from 'circular_buffer_js';
 import { FslDirections } from './jssm_types';
 import { arrow_direction, arrow_left_kind, arrow_right_kind } from './jssm_arrow';
+import { compile, make, wrap_parse } from './jssm_compiler';
+// compile_rule_handler,
+// compile_rule_transition_step,
+// compile_rule_handle_transition,
 import { base_theme } from './themes/jssm_base_stylesheet';
 import { default_theme } from './themes/jssm_theme_default';
 import { modern_theme } from './themes/jssm_theme_modern';
@@ -18,362 +21,8 @@ theme_mapping.set('bold', bold_theme);
 import { seq, unique, find_repeated, weighted_rand_select, weighted_sample_select, histograph, weighted_histo_key, array_box_if_string, name_bind_prop_and_state, hook_name, named_hook_name } from './jssm_util';
 import * as constants from './jssm_constants';
 const { shapes, gviz_shapes, named_colors } = constants;
-import { parse } from './fsl_parser';
 import { version, build_time } from './version'; // replaced from package.js in build
 import { JssmError } from './jssm_error';
-/*********
- *
- *  Internal method meant to perform factory assembly of an edge.  Not meant for
- *  external use.
- *
- *  @internal
- *
- *  @typeparam mDT The type of the machine data member; usually omitted
- *
- */
-// TODO add at-param to docblock
-function makeTransition(this_se, from, to, isRight, _wasList, _wasIndex) {
-    const kind = isRight
-        ? arrow_right_kind(this_se.kind)
-        : arrow_left_kind(this_se.kind), edge = {
-        from,
-        to,
-        kind,
-        forced_only: kind === 'forced',
-        main_path: kind === 'main'
-    };
-    //  if ((wasList  !== undefined) && (wasIndex === undefined)) { throw new JssmError(undefined, `Must have an index if transition was in a list"); }
-    //  if ((wasIndex !== undefined) && (wasList  === undefined)) { throw new JssmError(undefined, `Must be in a list if transition has an index");   }
-    /*
-      if (typeof edge.to === 'object') {
-  
-        if (edge.to.key === 'cycle') {
-          if (wasList === undefined) { throw new JssmError(undefined, "Must have a waslist if a to is type cycle"); }
-          const nextIndex = wrapBy(wasIndex, edge.to.value, wasList.length);
-          edge.to = wasList[nextIndex];
-        }
-  
-      }
-    */
-    const action = isRight ? 'r_action' : 'l_action', probability = isRight ? 'r_probability' : 'l_probability';
-    if (this_se[action]) {
-        edge.action = this_se[action];
-    }
-    if (this_se[probability]) {
-        edge.probability = this_se[probability];
-    }
-    return edge;
-}
-/*********
- *
- *  This method wraps the parser call that comes from the peg grammar,
- *  {@link parse}.  Generally neither this nor that should be used directly
- *  unless you mean to develop plugins or extensions for the machine.
- *
- *  Parses the intermediate representation of a compiled string down to a
- *  machine configuration object.  If you're using this (probably don't,) you're
- *  probably also using {@link compile} and {@link Machine.constructor}.
- *
- *  ```typescript
- *  import { parse, compile, Machine } from 'jssm';
- *
- *  const intermediate = wrap_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', ...
- *  ```
- *
- *  This method is mostly for plugin and intermediate tool authors, or people
- *  who need to work with the machine's intermediate representation.
- *
- *  # Hey!
- *
- *  Most people looking at this want either the `sm` operator or method `from`,
- *  which perform all the steps in the chain.  The library's author mostly uses
- *  operator `sm`, and mostly falls back to `.from` when needing to parse
- *  strings dynamically instead of from template literals.
- *
- *  Operator {@link sm}:
- *
- *  ```typescript
- *  import { sm } from 'jssm';
- *
- *  const lswitch = sm`on <=> off;`;
- *  ```
- *
- *  Method {@link from}:
- *
- *  ```typescript
- *  import * as jssm from 'jssm';
- *
- *  const toggle = jssm.from('up <=> down;');
- *  ```
- *
- *  `wrap_parse` itself is an internal convenience method for alting out an
- *  object as the options call.  Not generally meant for external use.
- *
- *  @param input The FSL code to be evaluated
- *
- *  @param options Things to control about the instance
- *
- */
-function wrap_parse(input, options) {
-    return parse(input, options || {});
-}
-/*********
- *
- *  Internal method performing one step in compiling rules for transitions.  Not
- *  generally meant for external use.
- *
- *  @internal
- *
- *  @typeparam mDT The type of the machine data member; usually omitted
- *
- */
-function compile_rule_transition_step(acc, from, to, this_se, next_se) {
-    const edges = [];
-    const uFrom = (Array.isArray(from) ? from : [from]), uTo = (Array.isArray(to) ? to : [to]);
-    uFrom.map((f) => {
-        uTo.map((t) => {
-            const right = makeTransition(this_se, f, t, true);
-            if (right.kind !== 'none') {
-                edges.push(right);
-            }
-            const left = makeTransition(this_se, t, f, false);
-            if (left.kind !== 'none') {
-                edges.push(left);
-            }
-        });
-    });
-    const new_acc = acc.concat(edges);
-    if (next_se) {
-        return compile_rule_transition_step(new_acc, to, next_se.to, next_se, next_se.se);
-    }
-    else {
-        return new_acc;
-    }
-}
-/*********
- *
- *  Internal method performing one step in compiling rules for transitions.  Not
- *  generally meant for external use.
- *
- *  @internal
- *
- */
-function compile_rule_handle_transition(rule) {
-    return compile_rule_transition_step([], rule.from, rule.se.to, rule.se, rule.se.se);
-}
-/*********
- *
- *  Internal method performing one step in compiling rules for transitions.  Not
- *  generally meant for external use.
- *
- *  @internal
- *
- */
-function compile_rule_handler(rule) {
-    if (rule.key === 'transition') {
-        return { agg_as: 'transition', val: compile_rule_handle_transition(rule) };
-    }
-    if (rule.key === 'machine_language') {
-        return { agg_as: 'machine_language', val: reduce_to_639(rule.value) };
-    }
-    // manually rehandled to make `undefined` as a property safe
-    if (rule.key === 'property_definition') {
-        const ret = { agg_as: 'property_definition', val: { name: rule.name } };
-        if (rule.hasOwnProperty('default_value')) {
-            ret.val.default_value = rule.default_value;
-        }
-        if (rule.hasOwnProperty('required')) {
-            ret.val.required = rule.required;
-        }
-        return ret;
-    }
-    // state properties are in here
-    if (rule.key === 'state_declaration') {
-        if (!rule.name) {
-            throw new JssmError(undefined, 'State declarations must have a name');
-        }
-        return { agg_as: 'state_declaration', val: { state: rule.name, declarations: rule.value } };
-    }
-    if (['arrange_declaration', 'arrange_start_declaration',
-        'arrange_end_declaration'].includes(rule.key)) {
-        return { agg_as: rule.key, val: [rule.value] };
-    }
-    // things that can only exist once and are just a value under their own name
-    const tautologies = [
-        'graph_layout', 'start_states', 'end_states', 'machine_name', 'machine_version',
-        'machine_comment', 'machine_author', 'machine_contributor', 'machine_definition',
-        'machine_reference', 'machine_license', 'fsl_version', 'state_config', 'theme',
-        'flow', 'dot_preamble', 'default_state_config', 'default_start_state_config',
-        'default_end_state_config', 'default_hooked_state_config',
-        'default_active_state_config', 'default_terminal_state_config'
-    ];
-    if (tautologies.includes(rule.key)) {
-        return { agg_as: rule.key, val: rule.value };
-    }
-    throw new JssmError(undefined, `compile_rule_handler: Unknown rule: ${JSON.stringify(rule)}`);
-}
-/*********
- *
- *  Compile a machine's JSON intermediate representation to a config object.  If
- *  you're using this (probably don't,) you're probably also using
- *  {@link parse} to get the IR, and the object constructor
- *  {@link Machine.construct} to turn the config object into a workable machine.
- *
- *  ```typescript
- *  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', ...
- *  ```
- *
- *  This method is mostly for plugin and intermediate tool authors, or people
- *  who need to work with the machine's intermediate representation.
- *
- *  # Hey!
- *
- *  Most people looking at this want either the `sm` operator or method `from`,
- *  which perform all the steps in the chain.  The library's author mostly uses
- *  operator `sm`, and mostly falls back to `.from` when needing to parse
- *  strings dynamically instead of from template literals.
- *
- *  Operator {@link sm}:
- *
- *  ```typescript
- *  import { sm } from 'jssm';
- *
- *  const lswitch = sm`on <=> off;`;
- *  ```
- *
- *  Method {@link from}:
- *
- *  ```typescript
- *  import * as jssm from 'jssm';
- *
- *  const toggle = jssm.from('up <=> down;');
- *  ```
- *
- *  @typeparam mDT The type of the machine data member; usually omitted
- *
- *  @param tree The parse tree to be boiled down into a machine config
- *
- */
-function compile(tree) {
-    const results = {
-        graph_layout: [],
-        transition: [],
-        start_states: [],
-        end_states: [],
-        state_config: [],
-        state_declaration: [],
-        fsl_version: [],
-        machine_author: [],
-        machine_comment: [],
-        machine_contributor: [],
-        machine_definition: [],
-        machine_language: [],
-        machine_license: [],
-        machine_name: [],
-        machine_reference: [],
-        property_definition: [],
-        state_property: {},
-        theme: [],
-        flow: [],
-        dot_preamble: [],
-        arrange_declaration: [],
-        arrange_start_declaration: [],
-        arrange_end_declaration: [],
-        machine_version: [],
-        default_state_config: [],
-        default_active_state_config: [],
-        default_hooked_state_config: [],
-        default_terminal_state_config: [],
-        default_start_state_config: [],
-        default_end_state_config: [],
-    };
-    tree.map((tr) => {
-        const rule = compile_rule_handler(tr), agg_as = rule.agg_as, val = rule.val; // TODO FIXME no any
-        results[agg_as] = results[agg_as].concat(val);
-    });
-    const property_keys = results['property_definition'].map(pd => pd.name), repeat_props = find_repeated(property_keys);
-    if (repeat_props.length) {
-        throw new JssmError(undefined, `Cannot repeat property definitions.  Saw ${JSON.stringify(repeat_props)}`);
-    }
-    const assembled_transitions = [].concat(...results['transition']);
-    const result_cfg = {
-        start_states: results.start_states.length ? results.start_states : [assembled_transitions[0].from],
-        end_states: results.end_states,
-        transitions: assembled_transitions,
-        state_property: [],
-    };
-    const oneOnlyKeys = [
-        'graph_layout', 'machine_name', 'machine_version', 'machine_comment',
-        'fsl_version', 'machine_license', 'machine_definition', 'machine_language',
-        'flow', 'dot_preamble'
-    ];
-    oneOnlyKeys.map((oneOnlyKey) => {
-        if (results[oneOnlyKey].length > 1) {
-            throw new JssmError(undefined, `May only have one ${oneOnlyKey} statement maximum: ${JSON.stringify(results[oneOnlyKey])}`);
-        }
-        else {
-            if (results[oneOnlyKey].length) {
-                result_cfg[oneOnlyKey] = results[oneOnlyKey][0];
-            }
-        }
-    });
-    ['arrange_declaration', 'arrange_start_declaration', 'arrange_end_declaration',
-        'machine_author', 'machine_contributor', 'machine_reference', 'theme',
-        'state_declaration', 'property_definition', 'default_state_config',
-        'default_start_state_config', 'default_end_state_config',
-        'default_hooked_state_config', 'default_terminal_state_config',
-        'default_active_state_config'].map((multiKey) => {
-        if (results[multiKey].length) {
-            result_cfg[multiKey] = results[multiKey];
-        }
-    });
-    // re-walk state declarations, already wrapped up, to get state properties,
-    // which go out in a different datastructure
-    results.state_declaration.forEach(sd => {
-        sd.declarations.forEach(decl => {
-            if (decl.key === 'state_property') {
-                const label = name_bind_prop_and_state(decl.name, sd.state);
-                if (result_cfg.state_property.findIndex(c => c.name === label) !== -1) {
-                    throw new JssmError(undefined, `A state may only bind a property once (${sd.state} re-binds ${decl.name})`);
-                }
-                else {
-                    result_cfg.state_property.push({ name: label, default_value: decl.value });
-                }
-            }
-        });
-    });
-    return result_cfg;
-}
-/*********
- *
- *  An internal convenience wrapper for parsing then compiling a machine string.
- *  Not generally meant for external use.  Please see {@link compile} or
- *  {@link sm}.
- *
- *  @typeparam mDT The type of the machine data member; usually omitted
- *
- *  @param plan The FSL code to be evaluated and built into a machine config
- *
- */
-function make(plan) {
-    return compile(wrap_parse(plan));
-}
 /*********
  *
  *  An internal method meant to take a series of declarations and fold them into