jssm 5.132.0 → 5.133.0

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.132.0 at 5/27/2026, 8:28:16 PM
+* Generated for version 5.133.0 at 5/27/2026, 9:02:28 PM
 
 -->
-# jssm 5.132.0
+# jssm 5.133.0
 
 [**Try the live editor**](https://stonecypher.github.io/jssm-viz-demo/graph_explorer.html) ·
 [Documentation](https://stonecypher.github.io/jssm/docs/) ·
@@ -281,7 +281,7 @@ That decision shows up everywhere downstream:
   or run `npm run benny` against your own machine.
 
 - **More thoroughly tested than any other JavaScript state-machine
-  library.**  6,155 tests at 100.0% line coverage
+  library.**  6,157 tests at 100.0% line coverage
   ([report](https://coveralls.io/github/StoneCypher/jssm)), plus
   fuzz testing via `fast-check`, with parser test data across ten natural
   languages and Emoji.
@@ -414,11 +414,11 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***6,155 tests***, run 56,942 times.
+***6,157 tests***, run 56,944 times.
 
-- 5,642 specs with 100.0% coverage
-- 513 fuzz tests with 4.4% coverage
-- 4,380 TypeScript lines - 1.4 tests per line, 13.0 generated tests per line
+- 5,644 specs with 100.0% coverage
+- 513 fuzz tests with 4.3% coverage
+- 4,415 TypeScript lines - 1.4 tests per line, 12.9 generated tests per line
 
 [![Actions Status](https://github.com/StoneCypher/jssm/workflows/Node%20CI/badge.svg)](https://github.com/StoneCypher/jssm/actions)
 [![NPM version](https://img.shields.io/npm/v/jssm.svg)](https://www.npmjs.com/package/jssm)

package/dist/cdn/viz.js

@@ -19585,41 +19585,6 @@ function name_bind_prop_and_state(prop, state) {
     }
     return JSON.stringify([prop, state]);
 }
-/*******
- *
- *  Internal method generating composite keys for transition hooks by
- *  JSON-serializing a `[from, to]` state pair.  Used to look up hooks
- *  registered on a specific edge.  Not meant for external use.
- *
- *  ```typescript
- *  hook_name('Red', 'Green');  // '["Red","Green"]'
- *  ```
- *
- *  @param from - The source state name.
- *  @param to   - The target state name.
- *
- *  @returns A deterministic JSON string key for the `[from, to]` pair.
- *
- */
-const hook_name = (from, to) => JSON.stringify([from, to]);
-/*******
- *
- *  Internal method generating composite keys for named-action hooks by
- *  JSON-serializing a `[from, to, action]` triple.  Used to look up hooks
- *  registered on a specific action-labeled edge.  Not meant for external use.
- *
- *  ```typescript
- *  named_hook_name('Red', 'Green', 'next');  // '["Red","Green","next"]'
- *  ```
- *
- *  @param from   - The source state name.
- *  @param to     - The target state name.
- *  @param action - The action label on the edge.
- *
- *  @returns A deterministic JSON string key for the `[from, to, action]` triple.
- *
- */
-const named_hook_name = (from, to, action) => JSON.stringify([from, to, action]);
 /*******
  *
  *  Creates a SplitMix32 random generator.  Used by the randomness test suite.
@@ -21387,7 +21352,7 @@ var constants = /*#__PURE__*/Object.freeze({
  *  Useful for runtime diagnostics and for embedding in serialized machine
  *  snapshots so that deserializers can detect version-skew.
  */
-const version = "5.132.0";
+const version = "5.133.0";
 
 // whargarbl lots of these return arrays could/should be sets
 const { state_name_chars, state_name_first_chars, action_label_chars } = constants;
@@ -23014,16 +22979,35 @@ class Machine {
      */
     set_hook(HookDesc) {
         switch (HookDesc.kind) {
-            case 'hook':
-                this._hooks.set(hook_name(HookDesc.from, HookDesc.to), HookDesc.handler);
+            case 'hook': {
+                // Nested by `from` then `to`; avoids JSON.stringify on every transition (#642).
+                let inner = this._hooks.get(HookDesc.from);
+                if (inner === undefined) {
+                    inner = new Map();
+                    this._hooks.set(HookDesc.from, inner);
+                }
+                inner.set(HookDesc.to, HookDesc.handler);
                 this._has_hooks = true;
                 this._has_basic_hooks = true;
                 break;
-            case 'named':
-                this._named_hooks.set(named_hook_name(HookDesc.from, HookDesc.to, HookDesc.action), HookDesc.handler);
+            }
+            case 'named': {
+                // Nested by `from` then `to` then `action`; same rationale as 'hook' (#642).
+                let inner = this._named_hooks.get(HookDesc.from);
+                if (inner === undefined) {
+                    inner = new Map();
+                    this._named_hooks.set(HookDesc.from, inner);
+                }
+                let inner2 = inner.get(HookDesc.to);
+                if (inner2 === undefined) {
+                    inner2 = new Map();
+                    inner.set(HookDesc.to, inner2);
+                }
+                inner2.set(HookDesc.action, HookDesc.handler);
                 this._has_hooks = true;
                 this._has_named_hooks = true;
                 break;
+            }
             case 'global action':
                 this._global_action_hooks.set(HookDesc.action, HookDesc.handler);
                 this._has_hooks = true;
@@ -23067,16 +23051,35 @@ class Machine {
                 this._has_hooks = true;
                 this._has_after_hooks = true;
                 break;
-            case 'post hook':
-                this._post_hooks.set(hook_name(HookDesc.from, HookDesc.to), HookDesc.handler);
+            case 'post hook': {
+                // Nested by `from` then `to`; same rationale as 'hook' (#642).
+                let inner = this._post_hooks.get(HookDesc.from);
+                if (inner === undefined) {
+                    inner = new Map();
+                    this._post_hooks.set(HookDesc.from, inner);
+                }
+                inner.set(HookDesc.to, HookDesc.handler);
                 this._has_post_hooks = true;
                 this._has_post_basic_hooks = true;
                 break;
-            case 'post named':
-                this._post_named_hooks.set(named_hook_name(HookDesc.from, HookDesc.to, HookDesc.action), HookDesc.handler);
+            }
+            case 'post named': {
+                // Nested by `from` then `to` then `action`; same rationale as 'hook' (#642).
+                let inner = this._post_named_hooks.get(HookDesc.from);
+                if (inner === undefined) {
+                    inner = new Map();
+                    this._post_named_hooks.set(HookDesc.from, inner);
+                }
+                let inner2 = inner.get(HookDesc.to);
+                if (inner2 === undefined) {
+                    inner2 = new Map();
+                    inner.set(HookDesc.to, inner2);
+                }
+                inner2.set(HookDesc.action, HookDesc.handler);
                 this._has_post_hooks = true;
                 this._has_post_named_hooks = true;
                 break;
+            }
             case 'post global action':
                 this._post_global_action_hooks.set(HookDesc.action, HookDesc.handler);
                 this._has_post_hooks = true;
@@ -23625,7 +23628,12 @@ class Machine {
                 // 5. named transition / action hook
                 if (this._has_named_hooks) {
                     if (wasAction) {
-                        const nhn = named_hook_name(this._state, newState, newStateOrAction), outcome = abstract_hook_step(this._named_hooks.get(nhn), hook_args);
+                        // Nested lookup: from -> to -> action.  Each step is a small Map keyed by
+                        // an already-interned state/action name; no per-call string allocation.
+                        const byTo = this._named_hooks.get(this._state);
+                        const byAct = byTo === undefined ? undefined : byTo.get(newState);
+                        const nh = byAct === undefined ? undefined : byAct.get(newStateOrAction);
+                        const outcome = abstract_hook_step(nh, hook_args);
                         if (outcome.pass === false) {
                             return false;
                         }
@@ -23634,7 +23642,10 @@ class Machine {
                 }
                 // 6. regular hook
                 if (this._has_basic_hooks) {
-                    const hn = hook_name(this._state, newState), outcome = abstract_hook_step(this._hooks.get(hn), hook_args);
+                    // Nested lookup: from -> to.  See note on _hooks declaration (#642).
+                    const byTo = this._hooks.get(this._state);
+                    const h = byTo === undefined ? undefined : byTo.get(newState);
+                    const outcome = abstract_hook_step(h, hook_args);
                     if (outcome.pass === false) {
                         return false;
                     }
@@ -23745,7 +23756,10 @@ class Machine {
             // 5. named transition / action hook
             if (this._has_post_named_hooks) {
                 if (wasAction) {
-                    const nhn = named_hook_name(hook_args.from, hook_args.to, hook_args.action), pnh = this._post_named_hooks.get(nhn);
+                    // Nested lookup: from -> to -> action.  See note on _post_named_hooks (#642).
+                    const byTo = this._post_named_hooks.get(hook_args.from);
+                    const byAct = byTo === undefined ? undefined : byTo.get(hook_args.to);
+                    const pnh = byAct === undefined ? undefined : byAct.get(hook_args.action);
                     if (pnh !== undefined) {
                         pnh(hook_args);
                     }
@@ -23753,7 +23767,9 @@ class Machine {
             }
             // 6. regular hook
             if (this._has_post_basic_hooks) {
-                const hook = this._post_hooks.get(hook_name(hook_args.from, hook_args.to));
+                // Nested lookup: from -> to.  See note on _post_hooks (#642).
+                const byTo = this._post_hooks.get(hook_args.from);
+                const hook = byTo === undefined ? undefined : byTo.get(hook_args.to);
                 if (hook !== undefined) {
                     hook(hook_args);
                 }