jssm 5.71.0 → 5.72.1

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-916 merges; 114 releases; Changlogging the last 10 commits; Full changelog at [CHANGELOG.long.md](CHANGELOG.long.md)
+919 merges; 114 releases; Changlogging the last 10 commits; Full changelog at [CHANGELOG.long.md](CHANGELOG.long.md)
 
 
 
@@ -22,15 +22,13 @@ Published tags:
 
  
 
-<a name="5__70__36" />
-
-## [5.70.36] - 6/21/2022 6:53:36 PM
+## [Untagged] - 6/24/2022 4:08:35 PM
 
-Commit [093db23b719161e35e477cc0fe7d9f1132bc28b8](https://github.com/StoneCypher/jssm/commit/093db23b719161e35e477cc0fe7d9f1132bc28b8)
+Commit [a1c43e9f65f2fd8e856a2544f7c3056b4c06d9d3](https://github.com/StoneCypher/jssm/commit/a1c43e9f65f2fd8e856a2544f7c3056b4c06d9d3)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Another trivial build - this one to cause chain publishment
+  * First steps towards being a Moore machine - initial data in constructor fixes StoneCypher/fsl#923 , can read in hooks fixes StoneCypher/fsl#924
 
 
 
@@ -39,15 +37,13 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__35" />
-
-## [5.70.35] - 6/19/2022 10:56:41 AM
+## [Untagged] - 6/23/2022 6:34:38 PM
 
-Commit [13ee9eb71ca9ab868699e535abf6ba30c8ad5829](https://github.com/StoneCypher/jssm/commit/13ee9eb71ca9ab868699e535abf6ba30c8ad5829)
+Commit [1dc7c24bfb651eec57fddc902f78db796f71a6c5](https://github.com/StoneCypher/jssm/commit/1dc7c24bfb651eec57fddc902f78db796f71a6c5)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * new trigger with replaced token - this time with a bump
+  * Small documentation tweaks.  First attempt to lodge on deno.land
 
 
 
@@ -56,13 +52,13 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-## [Untagged] - 6/19/2022 10:37:04 AM
+## [Untagged] - 6/23/2022 1:41:18 PM
 
-Commit [b3e69d9745b92d845bedcfbc08f342997137af3d](https://github.com/StoneCypher/jssm/commit/b3e69d9745b92d845bedcfbc08f342997137af3d)
+Commit [67c3240798d31933413aab27db7ea9fbb5de3b2a](https://github.com/StoneCypher/jssm/commit/67c3240798d31933413aab27db7ea9fbb5de3b2a)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * new trigger with replaced token
+  * Normalize arguments to hooks, fixes StoneCypher/fsl#895; more docs
 
 
 
@@ -71,15 +67,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__34" />
+<a name="5__70__36" />
 
-## [5.70.34] - 6/18/2022 9:40:31 PM
+## [5.70.36] - 6/21/2022 6:53:36 PM
 
-Commit [a0f295f060c7f08a8b10b2208dd1c95dc7f3c97a](https://github.com/StoneCypher/jssm/commit/a0f295f060c7f08a8b10b2208dd1c95dc7f3c97a)
+Commit [093db23b719161e35e477cc0fe7d9f1132bc28b8](https://github.com/StoneCypher/jssm/commit/093db23b719161e35e477cc0fe7d9f1132bc28b8)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * another trigger commit with mild doc extension
+  * Another trivial build - this one to cause chain publishment
 
 
 
@@ -88,15 +84,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__33" />
+<a name="5__70__35" />
 
-## [5.70.33] - 6/18/2022 8:57:42 PM
+## [5.70.35] - 6/19/2022 10:56:41 AM
 
-Commit [ca254f455f2c19f21e77834e993c310e05272822](https://github.com/StoneCypher/jssm/commit/ca254f455f2c19f21e77834e993c310e05272822)
+Commit [13ee9eb71ca9ab868699e535abf6ba30c8ad5829](https://github.com/StoneCypher/jssm/commit/13ee9eb71ca9ab868699e535abf6ba30c8ad5829)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * holy another facile build for triggering, batman
+  * new trigger with replaced token - this time with a bump
 
 
 
@@ -105,15 +101,13 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__32" />
-
-## [5.70.32] - 6/18/2022 8:48:07 PM
+## [Untagged] - 6/19/2022 10:37:04 AM
 
-Commit [8115e8b62d8ac1cff3c7eb07afabced097f1be42](https://github.com/StoneCypher/jssm/commit/8115e8b62d8ac1cff3c7eb07afabced097f1be42)
+Commit [b3e69d9745b92d845bedcfbc08f342997137af3d](https://github.com/StoneCypher/jssm/commit/b3e69d9745b92d845bedcfbc08f342997137af3d)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * yet another small commit as a trigger, this time to get the extended diff
+  * new trigger with replaced token
 
 
 
@@ -122,15 +116,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__31" />
+<a name="5__70__34" />
 
-## [5.70.31] - 6/18/2022 8:00:06 PM
+## [5.70.34] - 6/18/2022 9:40:31 PM
 
-Commit [de3d8a105aa85045a9f19ed46b4b3c5e5fb1e235](https://github.com/StoneCypher/jssm/commit/de3d8a105aa85045a9f19ed46b4b3c5e5fb1e235)
+Commit [a0f295f060c7f08a8b10b2208dd1c95dc7f3c97a](https://github.com/StoneCypher/jssm/commit/a0f295f060c7f08a8b10b2208dd1c95dc7f3c97a)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * another small commit as a trigger, this time to get the diff
+  * another trigger commit with mild doc extension
 
 
 
@@ -139,15 +133,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__30" />
+<a name="5__70__33" />
 
-## [5.70.30] - 6/18/2022 10:54:02 AM
+## [5.70.33] - 6/18/2022 8:57:42 PM
 
-Commit [3211f94bb943a63ae07f202eb168916d73f94f90](https://github.com/StoneCypher/jssm/commit/3211f94bb943a63ae07f202eb168916d73f94f90)
+Commit [ca254f455f2c19f21e77834e993c310e05272822](https://github.com/StoneCypher/jssm/commit/ca254f455f2c19f21e77834e993c310e05272822)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * missing closing div tag was breaking examples page
+  * holy another facile build for triggering, batman
 
 
 
@@ -156,15 +150,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__29" />
+<a name="5__70__32" />
 
-## [5.70.29] - 6/18/2022 8:40:30 AM
+## [5.70.32] - 6/18/2022 8:48:07 PM
 
-Commit [7373cfa90383dc2adbe0649be86cb89bef1c0518](https://github.com/StoneCypher/jssm/commit/7373cfa90383dc2adbe0649be86cb89bef1c0518)
+Commit [8115e8b62d8ac1cff3c7eb07afabced097f1be42](https://github.com/StoneCypher/jssm/commit/8115e8b62d8ac1cff3c7eb07afabced097f1be42)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * One more build to trigger remote.
+  * yet another small commit as a trigger, this time to get the extended diff
 
 
 
@@ -173,12 +167,12 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__70__28" />
+<a name="5__70__31" />
 
-## [5.70.28] - 6/18/2022 8:21:21 AM
+## [5.70.31] - 6/18/2022 8:00:06 PM
 
-Commit [9a95a6b865b1d517859c45f0b525bbebed6af5e3](https://github.com/StoneCypher/jssm/commit/9a95a6b865b1d517859c45f0b525bbebed6af5e3)
+Commit [de3d8a105aa85045a9f19ed46b4b3c5e5fb1e235](https://github.com/StoneCypher/jssm/commit/de3d8a105aa85045a9f19ed46b4b3c5e5fb1e235)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Believed to be final triggering build
+  * another small commit as a trigger, this time to get the diff

package/dist/es6/jssm.d.ts

@@ -208,6 +208,7 @@ declare class Machine<mDT> {
     _raw_state_declaration?: Array<Object>;
     _state_declarations: Map<StateType, JssmStateDeclaration>;
     _instance_name: string;
+    _data?: mDT;
     _graph_layout: JssmLayout;
     _dot_preamble: string;
     _arrange_declaration: Array<Array<StateType>>;
@@ -232,7 +233,7 @@ declare class Machine<mDT> {
     _main_transition_hook: HookHandler | undefined;
     _forced_transition_hook: HookHandler | undefined;
     _any_transition_hook: HookHandler | undefined;
-    constructor({ start_states, complete, transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, fsl_version, dot_preamble, arrange_declaration, arrange_start_declaration, arrange_end_declaration, theme, flow, graph_layout, instance_name }: JssmGenericConfig<mDT>);
+    constructor({ start_states, complete, transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, fsl_version, dot_preamble, arrange_declaration, arrange_start_declaration, arrange_end_declaration, theme, flow, graph_layout, instance_name, data }: JssmGenericConfig<mDT>);
     /********
      *
      *  Internal method for fabricating states.  Not meant for external use.
@@ -259,6 +260,21 @@ declare class Machine<mDT> {
      *
      */
     state(): StateType;
+    /*********
+     *
+     *  Get the current data of a machine.
+     *
+     *  ```typescript
+     *  import * as jssm from 'jssm';
+     *
+     *  const switch = jssm.from('on <=> off;', {data: 1});
+     *  console.log( switch.data() );              // 1
+     *  ```
+     *
+     *  @typeparam mDT The type of the machine data member; usually omitted
+     *
+     */
+    data(): mDT;
     /********
      *
      *  Check whether a given state is final (either has no exits or is marked

package/dist/es6/jssm.js

@@ -534,7 +534,7 @@ function transfer_state_properties(state_decl) {
 // TODO add a lotta docblock here
 class Machine {
     // whargarbl this badly needs to be broken up, monolith master
-    constructor({ start_states, complete = [], transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, fsl_version, dot_preamble = undefined, arrange_declaration = [], arrange_start_declaration = [], arrange_end_declaration = [], theme = 'default', flow = 'down', graph_layout = 'dot', instance_name }) {
+    constructor({ start_states, complete = [], transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, fsl_version, dot_preamble = undefined, arrange_declaration = [], arrange_start_declaration = [], arrange_end_declaration = [], theme = 'default', flow = 'down', graph_layout = 'dot', instance_name, data }) {
         this._instance_name = instance_name;
         this._state = start_states[0];
         this._states = new Map();
@@ -581,6 +581,7 @@ class Machine {
         this._forced_transition_hook = undefined;
         this._any_transition_hook = undefined;
         this._standard_transition_hook = undefined;
+        this._data = data;
         if (state_declaration) {
             state_declaration.map((state_decl) => {
                 if (this._state_declarations.has(state_decl.state)) { // no repeats
@@ -718,6 +719,30 @@ class Machine {
         return true; // todo whargarbl
       }
     */
+    /*********
+     *
+     *  Get the current data of a machine.
+     *
+     *  ```typescript
+     *  import * as jssm from 'jssm';
+     *
+     *  const switch = jssm.from('on <=> off;', {data: 1});
+     *  console.log( switch.data() );              // 1
+     *  ```
+     *
+     *  @typeparam mDT The type of the machine data member; usually omitted
+     *
+     */
+    data() {
+        return this._data;
+    }
+    /* whargarbl todo major
+       when we reimplement this, reintroduce this change to the is_final call
+  
+      is_changing(): boolean {
+        return true; // todo whargarbl
+      }
+    */
     /********
      *
      *  Check whether a given state is final (either has no exits or is marked
@@ -1229,52 +1254,42 @@ class Machine {
         }
     }
     hook(from, to, handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'hook', from, to, handler });
         return this;
     }
     hook_action(from, to, action, handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'named', from, to, action, handler });
         return this;
     }
     hook_global_action(action, handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'global action', action, handler });
         return this;
     }
     hook_any_action(handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'any action', handler });
         return this;
     }
     hook_standard_transition(handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'standard transition', handler });
         return this;
     }
     hook_main_transition(handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'main transition', handler });
         return this;
     }
     hook_forced_transition(handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'forced transition', handler });
         return this;
     }
     hook_any_transition(handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'any transition', handler });
         return this;
     }
     hook_entry(to, handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'entry', to, handler });
         return this;
     }
     hook_exit(from, handler) {
-        // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'exit', from, handler });
         return this;
     }
@@ -1317,7 +1332,7 @@ class Machine {
         // todo major incomplete whargarbl comeback
         if (valid) {
             if (this._has_hooks) {
-                const hook_args = { action: fromAction, from: this._state, to: newState, forced: wasForced };
+                const hook_args = { data: this._data, action: fromAction, from: this._state, to: newState, forced: wasForced };
                 if (wasAction) {
                     // 1. any action hook
                     if (this._any_action_hook !== undefined) {

package/dist/es6/version.js

@@ -1,2 +1,2 @@
-const version = "5.71.0";
+const version = "5.72.1";
 export { version };