jssm 5.97.1 → 5.98.0

package/dist/jssm.es5.iife.nonmin.cjs

@@ -20654,7 +20654,7 @@ var jssm = (function (exports) {
         named_colors: named_colors$1
     });
 
-    const version = "5.97.1", build_time = 1707173654610;
+    const version = "5.98.0", build_time = 1711419354245;
 
     // whargarbl lots of these return arrays could/should be sets
     const { shapes, gviz_shapes, named_colors } = constants;
@@ -20773,11 +20773,10 @@ var jssm = (function (exports) {
     // TODO add a lotta docblock here
     class Machine {
         // whargarbl this badly needs to be broken up, monolith master
-        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 = undefined, arrange_declaration = [], arrange_start_declaration = [], arrange_end_declaration = [], theme = ['default'], flow = 'down', graph_layout = 'dot', 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, allows_override, config_allows_override, rng_seed, time_source, timeout_source, clear_timeout_source }) {
+        constructor({ start_states, end_states = [], initial_state, start_states_no_enforce, 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 = undefined, arrange_declaration = [], arrange_start_declaration = [], arrange_end_declaration = [], theme = ['default'], flow = 'down', graph_layout = 'dot', 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, allows_override, config_allows_override, rng_seed, time_source, timeout_source, clear_timeout_source }) {
             this._time_source = () => new Date().getTime();
             this._create_started = this._time_source();
             this._instance_name = instance_name;
-            this._state = start_states[0];
             this._states = new Map();
             this._state_declarations = new Map();
             this._edges = [];
@@ -20999,6 +20998,19 @@ var jssm = (function (exports) {
                     this._state_properties.set(sp.name, sp.default_value);
                 });
             }
+            // set initial state either from the specified or the start state list.  validate admission behavior.
+            if (initial_state) {
+                if (!(this._states.has(initial_state))) {
+                    throw new JssmError(this, `requested start state ${initial_state} does not exist`);
+                }
+                if ((!(start_states_no_enforce)) && (!(start_states.includes(initial_state)))) {
+                    throw new JssmError(this, `requested start state ${initial_state} is not in start state list; add {start_states_no_enforce:true} to constructor options if desired`);
+                }
+                this._state = initial_state;
+            }
+            else {
+                this._state = start_states[0];
+            }
             // done building, do checks
             // assert all props are valid
             this._state_properties.forEach((_value, key) => {

package/dist/jssm.es5.nonmin.cjs

@@ -20655,7 +20655,7 @@ var constants = /*#__PURE__*/Object.freeze({
     named_colors: named_colors$1
 });
 
-const version = "5.97.1", build_time = 1707173654610;
+const version = "5.98.0", build_time = 1711419354245;
 
 // whargarbl lots of these return arrays could/should be sets
 const { shapes, gviz_shapes, named_colors } = constants;
@@ -20774,11 +20774,10 @@ function state_style_condense(jssk) {
 // TODO add a lotta docblock here
 class Machine {
     // whargarbl this badly needs to be broken up, monolith master
-    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 = undefined, arrange_declaration = [], arrange_start_declaration = [], arrange_end_declaration = [], theme = ['default'], flow = 'down', graph_layout = 'dot', 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, allows_override, config_allows_override, rng_seed, time_source, timeout_source, clear_timeout_source }) {
+    constructor({ start_states, end_states = [], initial_state, start_states_no_enforce, 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 = undefined, arrange_declaration = [], arrange_start_declaration = [], arrange_end_declaration = [], theme = ['default'], flow = 'down', graph_layout = 'dot', 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, allows_override, config_allows_override, rng_seed, time_source, timeout_source, clear_timeout_source }) {
         this._time_source = () => new Date().getTime();
         this._create_started = this._time_source();
         this._instance_name = instance_name;
-        this._state = start_states[0];
         this._states = new Map();
         this._state_declarations = new Map();
         this._edges = [];
@@ -21000,6 +20999,19 @@ class Machine {
                 this._state_properties.set(sp.name, sp.default_value);
             });
         }
+        // set initial state either from the specified or the start state list.  validate admission behavior.
+        if (initial_state) {
+            if (!(this._states.has(initial_state))) {
+                throw new JssmError(this, `requested start state ${initial_state} does not exist`);
+            }
+            if ((!(start_states_no_enforce)) && (!(start_states.includes(initial_state)))) {
+                throw new JssmError(this, `requested start state ${initial_state} is not in start state list; add {start_states_no_enforce:true} to constructor options if desired`);
+            }
+            this._state = initial_state;
+        }
+        else {
+            this._state = start_states[0];
+        }
         // done building, do checks
         // assert all props are valid
         this._state_properties.forEach((_value, key) => {