jssm 5.97.0 → 5.98.0

package/dist/jssm.es6.nonmin.cjs

@@ -20651,7 +20651,7 @@ var constants = /*#__PURE__*/Object.freeze({
     named_colors: named_colors$1
 });
 
-const version = "5.97.0", build_time = 1707171988789;
+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;
@@ -20770,11 +20770,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 = [];
@@ -20996,6 +20995,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) => {

package/jssm.d.ts

@@ -110,7 +110,7 @@ declare class Machine<mDT> {
     _timeout_handle: number | undefined;
     _timeout_target: string | undefined;
     _timeout_target_time: number | undefined;
-    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, allows_override, config_allows_override, rng_seed, time_source, timeout_source, clear_timeout_source }: JssmGenericConfig<StateType, mDT>);
+    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, 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, allows_override, config_allows_override, rng_seed, time_source, timeout_source, clear_timeout_source }: JssmGenericConfig<StateType, mDT>);
     /********
      *
      *  Internal method for fabricating states.  Not meant for external use.

package/jssm_types.d.ts

@@ -198,6 +198,8 @@ declare type JssmGenericConfig<StateType, DataType> = {
     dot_preamble?: string;
     start_states: Array<StateType>;
     end_states?: Array<StateType>;
+    initial_state?: StateType;
+    start_states_no_enforce?: boolean;
     state_declaration?: Object[];
     property_definition?: JssmPropertyDefinition[];
     state_property?: JssmPropertyDefinition[];

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "jssm",
-  "version": "5.97.0",
+  "version": "5.98.0",
   "engines": {
     "node": ">=10.0.0"
   },
   "exports": {
     "require": "./dist/jssm.es5.cjs",
-    "import": "./dist/jssm.es6.js",
+    "import": "./dist/jssm.es6.mjs",
     "default": "./dist/jssm.es5.cjs",
-    "browser": "dist/jssm.es5.iife.js"
+    "browser": "dist/jssm.es5.iife.cjs"
   },
   "autoupdate": {
     "source": "git",
@@ -60,7 +60,7 @@
     "minify": "mv dist/es6/fsl_parser.js dist/es6/fsl_parser.nonmin.js && terser dist/es6/fsl_parser.nonmin.js > dist/es6/fsl_parser.js",
     "min_iife": "mv dist/jssm.es5.iife.js dist/jssm.es5.iife.nonmin.cjs && terser dist/jssm.es5.iife.nonmin.cjs > dist/jssm.es5.iife.cjs && cp dist/jssm.es5.iife.nonmin.cjs ./src/tools/",
     "min_cjs": "mv dist/jssm.es5.cjs.js dist/jssm.es5.nonmin.cjs && terser dist/jssm.es5.nonmin.cjs > dist/jssm.es5.cjs",
-    "min_es6": "mv dist/jssm.es6.cjs.js dist/jssm.es6.nonmin.cjs && terser dist/jssm.es6.nonmin.cjs > dist/jssm.es6.cjs",
+    "min_es6": "mv dist/jssm.es6.js dist/jssm.es6.nonmin.cjs && terser dist/jssm.es6.nonmin.cjs > dist/jssm.es6.mjs",
     "min_deno": "terser dist/deno/jssm.deno-esm.nonmin.js > dist/deno/jssm.js",
     "site": "cp src/site/* docs/ && cp -r src/assets docs/assets/",
     "docs": "typedoc src/ts/jssm.ts src/ts/jssm_types.ts src/ts/jssm_constants.ts src/ts/jssm_error.ts src/ts/jssm_util.ts src/ts/version.ts --options typedoc-options.cjs",

package/rollup.config.es6.js

@@ -13,7 +13,7 @@ const config = {
   input: 'dist/es6/jssm.js',
 
   output: {
-    file   : 'dist/jssm.es6.cjs.js',
+    file   : 'dist/jssm.es6.js',
     format : 'es',
     name   : 'jssm'
   },