jssm 5.162.11 → 5.162.13

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.162.11 at 7/12/2026, 8:54:54 AM
+* Generated for version 5.162.13 at 7/12/2026, 12:27:54 PM
 
 -->
-# jssm 5.162.11
+# jssm 5.162.13
 
 [**Try the live editor**](https://stonecypher.github.io/jssm-viz-demo/graph_explorer.html) ·
 [Documentation](https://stonecypher.github.io/jssm/docs/) ·
@@ -333,7 +333,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.**  8,623 tests at 100.0% line coverage
+  library.**  8,681 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.
@@ -350,6 +350,7 @@ That decision shows up everywhere downstream:
 - [Tutorial: a four-state traffic light](https://github.com/StoneCypher/jssm/blob/main/src/doc_md/Tutorial_TrafficLight.md) - short walkthrough that introduces the three arrow types
 - [Tutorial: building an ATM state machine](https://github.com/StoneCypher/jssm/blob/main/src/doc_md/Tutorial_ATM.md) - longer walkthrough that builds a real-world machine in nine incremental steps
 - [Language reference](https://github.com/StoneCypher/jssm/blob/main/src/doc_md/LanguageReference.md) - DSL reference for people already comfortable with state machines
+- [Styling nodes and graphs](https://github.com/StoneCypher/jssm/blob/main/src/doc_md/Styling.md) - the built-in named color themes and how to select them from FSL source, code, Markdown fences, the CLI, and web components
 - [Catalog of example machines](https://github.com/StoneCypher/jssm/blob/main/src/doc_md/ExampleMachines.md) - comparison table of worked examples (light switch, traffic light, intersection, vending machine, more)
 - [Generated API reference](https://stonecypher.github.io/jssm/docs/) - full surface, generated from the TypeScript source
 
@@ -467,11 +468,11 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***8,623 tests***, run 97,921 times.
+***8,681 tests***, run 98,078 times.
 
-- 7,721 specs with 100.0% coverage
-- 902 fuzz tests with 56.6% coverage
-- 10,907 TypeScript lines - 0.8 tests per line, 9.0 generated tests per line
+- 7,778 specs with 100.0% coverage
+- 903 fuzz tests with 56.3% coverage
+- 11,033 TypeScript lines - 0.8 tests per line, 8.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/custom-elements.json

@@ -3425,7 +3425,7 @@
         },
         {
           "kind": "class",
-          "description": "Binds an `<fsl-instance>` to a segment of the URL fragment: restores from it\r\non connect and writes back (debounced, via `history.replaceState`) whenever\r\nthe machine is rebuilt. Inert when the host has no key (permalink_key_for\r\nreturns `null`), so an `fsl-instance` without an `id`/`uhash` never touches\r\n`location`.\r\n\r\nEcho guard: `_last` holds the segment most recently read or written, so a\r\nrestore→rebuild→write cycle and a self-induced `hashchange` are both no-ops.",
+          "description": "Binds an `<fsl-instance>` to a segment of the URL fragment: restores from it\r\non connect and writes back (debounced, via `history.replaceState`) whenever\r\nthe machine is rebuilt. Inert when the host has no key (permalink_key_for\r\nreturns `null`), so an `fsl-instance` without an `id`/`uhash` never touches\r\n`location`.\r\n\r\nEcho guard: `_observed` holds this connection's current URL segment, including\r\nexplicit absence, so unrelated hash changes and restore→rebuild→write cycles\r\nare no-ops. Async operations share a revision: every observed segment change\r\nor source write invalidates all older work, and disconnecting invalidates all\r\nwork. This gives cross-direction latest-operation-wins semantics without\r\nallowing unrelated hash changes to cancel valid writes.",
           "name": "FslPermalinkSync",
           "members": [
             {
@@ -3449,12 +3449,12 @@
             },
             {
               "kind": "field",
-              "name": "_last",
+              "name": "_observed",
               "type": {
-                "text": "string | null"
+                "text": "ObservedSegment"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "UNOBSERVED_SEGMENT"
             },
             {
               "kind": "field",
@@ -3464,6 +3464,24 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_connected",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_revision",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
             {
               "kind": "field",
               "name": "_onRebuilt",
@@ -3483,7 +3501,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Observe the keyed URL segment and attach synchronization listeners."
             },
             {
               "kind": "method",
@@ -3492,7 +3511,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Invalidate work, forget observations, detach listeners, and cancel timers."
             },
             {
               "kind": "method",
@@ -3503,7 +3523,7 @@
                   "text": "Promise<void>"
                 }
               },
-              "description": "Read our segment and, if new, push it into the host (overriding declared source)."
+              "description": "Observe this instance's newest segment and push it into the host. A changed\r\nobservation supersedes older restores and writes; an unchanged observation\r\nleaves them valid. Declared source is overridden only when this decode is\r\nstill the latest operation and the actual fragment is unchanged after\r\nawaiting it, even when a corresponding hashchange handler is still queued."
             },
             {
               "kind": "method",
@@ -3513,7 +3533,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Debounce the newest rebuild and immediately supersede older restores or writes."
             },
             {
               "kind": "method",
@@ -3524,7 +3545,15 @@
                   "text": "Promise<void>"
                 }
               },
-              "description": "Encode the current source and merge it into the fragment, history-silently."
+              "parameters": [
+                {
+                  "name": "revision",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Encode the scheduled source and merge it into the fragment only when no\r\nnewer source write, observed segment change, or disconnect superseded it.\r\nThe actual fragment must also match the observation captured before the\r\nawait, covering URL changes whose hashchange handler is still queued. A\r\nsuccessful write becomes the current observation, preventing echo work."
             }
           ]
         }
@@ -4460,6 +4489,11 @@
               "description": "Minimum height of the rendered SVG container.",
               "name": "--jssm-viz-min-height",
               "default": "100px"
+            },
+            {
+              "description": "Maximum height of the control; the rendered SVG stays bounded (aspect preserved, letterboxed) within it. Equivalent to setting `max-height` on the host from outside, without shadow surgery.",
+              "name": "--jssm-viz-max-height",
+              "default": "none"
             }
           ],
           "members": [
@@ -4581,7 +4615,7 @@
                   "description": "Highlight styling; see {@link HighlightOptions}. Defaults\r\n   *                to crimson with off-trace fading enabled.\r\n   * "
                 }
               ],
-              "description": "Programmatically highlights one execution trace (a path of state names)\r\nthrough the rendered graph, optionally fading everything off the path.\r\n\r\nMatches nodes by their Graphviz `<title>` (the state name) and edges by\r\nthe `from->to` title Graphviz emits, applying inline style overrides so\r\nthe highlight composes over — and is reversible against — the default\r\nrendering (see clearHighlights, which this calls first). No-ops\r\nwhen detached, before the first render, or given an empty trace.\r\n\r\n```typescript\r\n// Highlight a -> b -> c in green, without dimming the rest:\r\nviz.highlightTrace(['a', 'b', 'c'], { color: '#2e7d32', fadeOthers: false });\r\n```"
+              "description": "Programmatically highlights one execution trace (a path of state names)\r\nthrough the rendered graph, optionally fading everything off the path.\r\n\r\nMatches nodes by their Graphviz `<title>` and edges by the `from->to`\r\ntitle Graphviz emits, applying inline style overrides so the highlight\r\ncomposes over — and is reversible against — the default rendering (see\r\nclearHighlights, which this calls first). No-ops when detached,\r\nbefore the first render, or given an empty trace.\r\n\r\nBecause dot generation slugs state names into node identifiers (fsl#1935\r\n— `'Wrong Pin'` renders with `<title>wrong-pin</title>`), each trace name\r\nis matched in **both** its raw form and its slugged form, using the same\r\n`slug_for` the dot generator uses. Display names (`'Red'`, `'Wrong Pin'`,\r\n`'Röd'`) and already-slug-form names (`'red'`, `'wrong-pin'`) therefore\r\nboth work. Names whose slug is empty (e.g. `'!!!'`, which renders under\r\nan indexed `node-N` title) are only matchable by passing that literal\r\n`node-N` title.\r\n\r\n```typescript\r\n// Highlight a -> b -> c in green, without dimming the rest:\r\nviz.highlightTrace(['a', 'b', 'c'], { color: '#2e7d32', fadeOthers: false });\r\n\r\n// Display-form names match their slugged titles:\r\nviz.highlightTrace(['Wrong Pin', 'Alarm']);   // titles wrong-pin, alarm\r\n```"
             }
           ],
           "events": [
@@ -4941,6 +4975,14 @@
             "name": "FslStochastic",
             "module": "./fsl_stochastic_wc.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "FslInfoPanel",
+          "declaration": {
+            "name": "FslInfoPanel",
+            "module": "./fsl_info_panel_wc.js"
+          }
         }
       ]
     }