jssm 5.89.6 → 5.90.1

package/.gitattributes

@@ -0,0 +1,6 @@
+docs/* linguist-generated=true
+build/* linguist-generated=true
+dist/* linguist-generated=true
+src/ts/generated_code/* linguist-generated=true
+benchmark/* linguist-generated=true
+coverage/* linguist-generated=true

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-1100 merges; 187 releases; Changlogging the last 10 commits; Full changelog at [CHANGELOG.long.md](CHANGELOG.long.md)
+1104 merges; 187 releases; Changlogging the last 10 commits; Full changelog at [CHANGELOG.long.md](CHANGELOG.long.md)
 
 
 
@@ -22,15 +22,13 @@ Published tags:
 
  
 
-## [Untagged] - 10/25/2023 11:23:28 AM
+## [Untagged] - 10/25/2023 12:51:12 PM
 
-Commit [21be69d4b3e592534342a113d259f59bbea4e23b](https://github.com/StoneCypher/jssm/commit/21be69d4b3e592534342a113d259f59bbea4e23b)
+Commit [7ef88f2a668a45f1cd2e027072e933a813ac65c6](https://github.com/StoneCypher/jssm/commit/7ef88f2a668a45f1cd2e027072e933a813ac65c6)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-Merges [1401a08, a0fa6f3]
-
-  * Merge branch 'UpdateWorkflowNodeVersions'
+  * Suppress generated code and directories from reviews using .gitattributes, fixes StoneCypher/fsl#1242
 
 
 
@@ -39,13 +37,13 @@ Merges [1401a08, a0fa6f3]
 
 &nbsp;
 
-## [Untagged] - 10/25/2023 11:21:44 AM
+## [Untagged] - 10/25/2023 12:33:52 PM
 
-Commit [1401a08396ff0f47bf67f52f8895a513513b3c17](https://github.com/StoneCypher/jssm/commit/1401a08396ff0f47bf67f52f8895a513513b3c17)
+Commit [e88d784320e4d3bfbabfe9365578d32b869b6831](https://github.com/StoneCypher/jssm/commit/e88d784320e4d3bfbabfe9365578d32b869b6831)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * replace mulberry with splitmix32, fixes StoneCypher/fsl#1250
+  * Proper stochastics.  Seedable RNG.  Fixes StoneCypher/fsl#990, StoneCypher/fsl#991
 
 
 
@@ -54,15 +52,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__89__3" />
-
-## [5.89.3] - 10/25/2023 10:58:24 AM
+## [Untagged] - 10/25/2023 11:31:11 AM
 
-Commit [e1ef14c5268547a18010d378267f7196e186a08c](https://github.com/StoneCypher/jssm/commit/e1ef14c5268547a18010d378267f7196e186a08c)
+Commit [966c142a44db8c5f890b2cc4edadca9faee2d625](https://github.com/StoneCypher/jssm/commit/966c142a44db8c5f890b2cc4edadca9faee2d625)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * silence most build warnings
+Merges [9944585, bba1f0a]
+
+  * Merge branch 'main' into NewGraphicAssets
 
 
 
@@ -71,13 +69,13 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-## [Untagged] - 10/25/2023 10:48:13 AM
+## [Untagged] - 10/25/2023 11:29:11 AM
 
-Commit [a0fa6f3a6f58169ae45ed294c4fd7ae1d1f84a26](https://github.com/StoneCypher/jssm/commit/a0fa6f3a6f58169ae45ed294c4fd7ae1d1f84a26)
+Commit [bba1f0a273ca73ffe105eed27619fc6b31247568](https://github.com/StoneCypher/jssm/commit/bba1f0a273ca73ffe105eed27619fc6b31247568)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Newer node stuff
+  * update github action to cover more modern node versions to cover 20 and 21
 
 
 
@@ -86,31 +84,30 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-## [Untagged] - 10/25/2023 10:47:08 AM
+## [Untagged] - 10/25/2023 11:23:28 AM
 
-Commit [99445857bb32492c06ef0d766177260b3221bb70](https://github.com/StoneCypher/jssm/commit/99445857bb32492c06ef0d766177260b3221bb70)
+Commit [21be69d4b3e592534342a113d259f59bbea4e23b](https://github.com/StoneCypher/jssm/commit/21be69d4b3e592534342a113d259f59bbea4e23b)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Purty
+Merges [1401a08, a0fa6f3]
 
+  * Merge branch 'UpdateWorkflowNodeVersions'
 
 
 
-&nbsp;
 
 &nbsp;
 
-<a name="5__89__2" />
+&nbsp;
 
-## [5.89.2] - 6/6/2023 12:30:48 AM
+## [Untagged] - 10/25/2023 11:21:44 AM
 
-Commit [66725ae01f4692e7720a6b7a0add6cd71b77ce85](https://github.com/StoneCypher/jssm/commit/66725ae01f4692e7720a6b7a0add6cd71b77ce85)
+Commit [1401a08396ff0f47bf67f52f8895a513513b3c17](https://github.com/StoneCypher/jssm/commit/1401a08396ff0f47bf67f52f8895a513513b3c17)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Update package.json
-  * bumping version for readme error by alpine discord @toomanyusershavethisname as mentioned in prior patch
+  * replace mulberry with splitmix32, fixes StoneCypher/fsl#1250
 
 
 
@@ -119,17 +116,15 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-## [Untagged] - 6/6/2023 12:29:53 AM
+<a name="5__89__3" />
+
+## [5.89.3] - 10/25/2023 10:58:24 AM
 
-Commit [e04f055eec397f7c1679579caec8c4565dd993a4](https://github.com/StoneCypher/jssm/commit/e04f055eec397f7c1679579caec8c4565dd993a4)
+Commit [e1ef14c5268547a18010d378267f7196e186a08c](https://github.com/StoneCypher/jssm/commit/e1ef14c5268547a18010d378267f7196e186a08c)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Update README_base.md
-  * alpine linux discord @toomanyusershavethisname noticed an error in the readme.
-  * i'll have to manually trigger a second build to clear this because for some nightmare reason i'm doing this in the web editor on a tablet instead of just going upstairs and using the computer like an adult, and that means i can't do two files at once and so this build will bounce when the version number isn't yet bounced
-  * "but you could start a branch"
-  * yeah but i won't, is the thing
+  * silence most build warnings
 
 
 
@@ -138,18 +133,13 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__89__1" />
-
-## [5.89.1] - 5/13/2023 11:42:13 PM
+## [Untagged] - 10/25/2023 10:48:13 AM
 
-Commit [7fb4622f3b8651ea259f8a785210810bd0ae328a](https://github.com/StoneCypher/jssm/commit/7fb4622f3b8651ea259f8a785210810bd0ae328a)
+Commit [a0fa6f3a6f58169ae45ed294c4fd7ae1d1f84a26](https://github.com/StoneCypher/jssm/commit/a0fa6f3a6f58169ae45ed294c4fd7ae1d1f84a26)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-Merges [d04a575, 6337159]
-
-  * Merge pull request #556 from StoneCypher/FinalizeDenoSupport
-  * Standard deno support
+  * Newer node stuff
 
 
 
@@ -158,13 +148,13 @@ Merges [d04a575, 6337159]
 
 &nbsp;
 
-## [Untagged] - 5/13/2023 11:35:56 PM
+## [Untagged] - 10/25/2023 10:47:08 AM
 
-Commit [6337159890e2a5f96af18a926096d82876660903](https://github.com/StoneCypher/jssm/commit/6337159890e2a5f96af18a926096d82876660903)
+Commit [99445857bb32492c06ef0d766177260b3221bb70](https://github.com/StoneCypher/jssm/commit/99445857bb32492c06ef0d766177260b3221bb70)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-  * Standard deno support
+  * Purty
 
 
 
@@ -173,15 +163,13 @@ Author: `John Haugeland <stonecypher@gmail.com>`
 
 &nbsp;
 
-<a name="5__89__0" />
+<a name="5__89__2" />
 
-## [5.89.0] - 5/7/2023 12:34:42 PM
+## [5.89.2] - 6/6/2023 12:30:48 AM
 
-Commit [d04a57542edb377085437d38e31d13a65fccdce8](https://github.com/StoneCypher/jssm/commit/d04a57542edb377085437d38e31d13a65fccdce8)
+Commit [66725ae01f4692e7720a6b7a0add6cd71b77ce85](https://github.com/StoneCypher/jssm/commit/66725ae01f4692e7720a6b7a0add6cd71b77ce85)
 
 Author: `John Haugeland <stonecypher@gmail.com>`
 
-Merges [ef4285a, 2a87cf1]
-
-  * Merge pull request #555 from StoneCypher/ReattemptDenoSupport
-  * draft support for deno
+  * Update package.json
+  * bumping version for readme error by alpine discord @toomanyusershavethisname as mentioned in prior patch

package/README.md

@@ -18,10 +18,10 @@ Please edit the file it's derived from, instead: `./src/md/readme_base.md`
 
 
 
-* Generated for version 5.89.6 at 10/25/2023, 11:25:13 AM
+* Generated for version 5.90.1 at 10/25/2023, 12:53:01 PM
 
 -->
-# jssm 5.89.6
+# jssm 5.90.1
 
 Easy.  Small.  Fast.  TS, es6, es5.  Node, Browser.  100% coverage.  Property
 tests.  Fuzz tests.  Language tests for a dozen languages and emoji.  Easy to
@@ -29,7 +29,7 @@ share online.  Easy to embed.
 
 Readable, useful state machines as one-liner strings.
 
-***4,923 tests*** run 5,814 times.  4,914 specs with 100.0% coverage, 9 fuzz tests with 13.1% coverage.  With 2,834 lines, that's about 1.7 tests per line, or {{line_run_ratio}} generated tests per line.
+***4,937 tests*** run 5,828 times.  4,928 specs with 100.0% coverage, 9 fuzz tests with 13.0% coverage.  With 2,855 lines, that's about 1.7 tests per line, or {{line_run_ratio}} generated tests per line.
 
 ***Meet your new state machine library.***
 

package/dist/es6/jssm.d.ts

@@ -1,6 +1,6 @@
 declare type StateType = string;
 import { JssmGenericState, JssmGenericConfig, JssmStateConfig, JssmTransition, JssmTransitionList, // JssmTransitionRule,
-JssmMachineInternalState, JssmAllowsOverride, JssmStateDeclaration, JssmStateStyleKeyList, JssmLayout, JssmHistory, JssmSerialization, FslDirection, FslDirections, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult } from './jssm_types';
+JssmMachineInternalState, JssmAllowsOverride, JssmStateDeclaration, JssmStateStyleKeyList, JssmLayout, JssmHistory, JssmSerialization, FslDirection, FslDirections, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult, JssmRng } 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';
@@ -40,8 +40,10 @@ declare class Machine<mDT> {
     _fsl_version?: string;
     _raw_state_declaration?: Array<Object>;
     _state_declarations: Map<StateType, JssmStateDeclaration>;
-    _instance_name: string;
     _data?: mDT;
+    _instance_name: string;
+    _rng_seed: number;
+    _rng: JssmRng;
     _graph_layout: JssmLayout;
     _dot_preamble: string;
     _arrange_declaration: Array<Array<StateType>>;
@@ -99,7 +101,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, allows_override, config_allows_override }: JssmGenericConfig<StateType, 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, allows_override, config_allows_override, rng_seed }: JssmGenericConfig<StateType, mDT>);
     /********
      *
      *  Internal method for fabricating states.  Not meant for external use.
@@ -668,6 +670,8 @@ 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>;
+    get rng_seed(): number;
+    set rng_seed(to: number | undefined);
     edges_between(from: string, to: string): JssmTransition<StateType, mDT>[];
     /*********
      *

package/dist/es6/jssm.js

@@ -4,7 +4,7 @@ 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';
 import { theme_mapping, base_theme } from './jssm_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 { 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, gen_splitmix32 } from './jssm_util';
 import * as constants from './jssm_constants';
 const { shapes, gviz_shapes, named_colors } = constants;
 import { version, build_time } from './version'; // replaced from package.js in build
@@ -126,7 +126,7 @@ 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 }) {
+    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 }) {
         this._instance_name = instance_name;
         this._state = start_states[0];
         this._states = new Map();
@@ -212,6 +212,8 @@ class Machine {
         this._history_length = history || 0;
         this._history = new circular_buffer(this._history_length);
         this._state_labels = new Map();
+        this._rng_seed = rng_seed !== null && rng_seed !== void 0 ? rng_seed : new Date().getTime();
+        this._rng = gen_splitmix32(this._rng_seed);
         // consolidate the state declarations
         if (state_declaration) {
             state_declaration.map((state_decl) => {
@@ -1076,7 +1078,7 @@ class Machine {
         return wtf;
     }
     probabilistic_transition() {
-        const selected = weighted_rand_select(this.probable_exits_for(this.state()));
+        const selected = weighted_rand_select(this.probable_exits_for(this.state()), undefined, this._rng);
         return this.transition(selected.to);
     }
     probabilistic_walk(n) {
@@ -1419,6 +1421,17 @@ class Machine {
         this.set_hook({ kind: 'post exit', from, handler });
         return this;
     }
+    get rng_seed() {
+        return this._rng_seed;
+    }
+    set rng_seed(to) {
+        if (typeof to === 'undefined') {
+            this._rng_seed = new Date().getTime();
+        }
+        else {
+            this._rng_seed = to;
+        }
+    }
     // remove_hook(HookDesc: HookDescription) {
     //   throw new JssmError(this, 'TODO: Should remove hook here');
     // }

package/dist/es6/jssm_types.d.ts

@@ -219,6 +219,7 @@ declare type JssmGenericConfig<StateType, DataType> = {
     default_hooked_state_config?: JssmStateStyleKeyList;
     default_terminal_state_config?: JssmStateStyleKeyList;
     default_active_state_config?: JssmStateStyleKeyList;
+    rng_seed?: number | undefined;
 };
 declare type JssmCompileRule<StateType> = {
     agg_as: string;
@@ -359,4 +360,5 @@ declare type JssmErrorExtendedInfo = {
     requested_state?: StateType | undefined;
 };
 declare type JssmHistory<mDT> = circular_buffer<[StateType, mDT]>;
-export { JssmColor, JssmShape, JssmTransition, JssmTransitions, JssmTransitionList, JssmTransitionRule, JssmArrow, JssmArrowKind, JssmArrowDirection, JssmGenericConfig, JssmGenericState, JssmGenericMachine, JssmParseTree, JssmCompileSe, JssmCompileSeStart, JssmCompileRule, JssmPermitted, JssmPermittedOpt, JssmResult, JssmStateDeclaration, JssmStateDeclarationRule, JssmStateConfig, JssmStateStyleKey, JssmStateStyleKeyList, JssmBaseTheme, JssmTheme, JssmLayout, JssmHistory, JssmSerialization, JssmPropertyDefinition, JssmAllowsOverride, JssmParseFunctionType, JssmMachineInternalState, JssmErrorExtendedInfo, FslDirections, FslDirection, FslThemes, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult };
+declare type JssmRng = () => number;
+export { JssmColor, JssmShape, JssmTransition, JssmTransitions, JssmTransitionList, JssmTransitionRule, JssmArrow, JssmArrowKind, JssmArrowDirection, JssmGenericConfig, JssmGenericState, JssmGenericMachine, JssmParseTree, JssmCompileSe, JssmCompileSeStart, JssmCompileRule, JssmPermitted, JssmPermittedOpt, JssmResult, JssmStateDeclaration, JssmStateDeclarationRule, JssmStateConfig, JssmStateStyleKey, JssmStateStyleKeyList, JssmBaseTheme, JssmTheme, JssmLayout, JssmHistory, JssmSerialization, JssmPropertyDefinition, JssmAllowsOverride, JssmParseFunctionType, JssmMachineInternalState, JssmErrorExtendedInfo, FslDirections, FslDirection, FslThemes, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult, JssmRng };

package/dist/es6/jssm_util.js

@@ -11,7 +11,7 @@ function arr_uniq_p(el, i, source) {
 const array_box_if_string = n => typeof n === 'string' ? [n] : n;
 // this is explicitly about other peoples' data, so it has to be weakly typed
 /* eslint-disable flowtype/no-weak-types */
-const weighted_rand_select = (options, probability_property = 'probability') => {
+const weighted_rand_select = (options, probability_property = 'probability', rng) => {
     if (!Array.isArray(options)) {
         throw new TypeError('options must be a non-empty array of objects');
     }

package/dist/es6/version.js

@@ -1,2 +1,2 @@
-const version = "5.89.6", build_time = 1698258231844;
+const version = "5.90.1", build_time = 1698263492649;
 export { version, build_time };