jssm 5.148.0 → 5.148.2

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.148.0 at 6/27/2026, 11:13:49 PM
+* Generated for version 5.148.2 at 6/28/2026, 1:26:54 AM
 
 -->
-# jssm 5.148.0
+# jssm 5.148.2
 
 [**Try the live editor**](https://stonecypher.github.io/jssm-viz-demo/graph_explorer.html) ·
 [Documentation](https://stonecypher.github.io/jssm/docs/) ·
@@ -312,7 +312,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.**  7,682 tests at 100.0% line coverage
+  library.**  7,683 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.
@@ -445,9 +445,9 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***7,682 tests***, run 82,328 times.
+***7,683 tests***, run 82,329 times.
 
-- 6,928 specs with 100.0% coverage
+- 6,929 specs with 100.0% coverage
 - 754 fuzz tests with 59.4% coverage
 - 8,790 TypeScript lines - 0.9 tests per line, 9.4 generated tests per line
 

package/custom-elements.json

@@ -8,7 +8,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-actions>` — interactive controls derived from a parent `<fsl-instance>`'s\nmachine. Renders a button for every currently-legal named **action** and, split\ninto three groups, every reachable transition target by edge kind: **main**\n(`=>`) first, plain **transitions** (`->`) next, and **forced** (`~>`) last.\nLegal targets fire with `transition`, forced-only ones with `force_transition`.\nRe-derives on the host's transition / rebuild events; only firable controls\nappear, and each group is omitted when empty, so a self-loop-only state shows\njust its actions and a terminal state shows `no actions available`. Standalone\n(no host ancestor) renders empty.",
+          "description": "`<fsl-actions>` — interactive controls derived from a parent `<fsl-instance>`'s\r\nmachine. Renders a button for every currently-legal named **action** and, split\r\ninto three groups, every reachable transition target by edge kind: **main**\r\n(`=>`) first, plain **transitions** (`->`) next, and **forced** (`~>`) last.\r\nLegal targets fire with `transition`, forced-only ones with `force_transition`.\r\nRe-derives on the host's transition / rebuild events; only firable controls\r\nappear, and each group is omitted when empty, so a self-loop-only state shows\r\njust its actions and a terminal state shows `no actions available`. Standalone\r\n(no host ancestor) renders empty.",
           "name": "FslActions",
           "cssParts": [
             {
@@ -353,11 +353,11 @@
               "description": "A JSON string (typically `JSON.stringify(value, null, 2)`)."
             }
           ],
-          "description": "Split a pretty-printed JSON string into classified tokens for syntax\nhighlighting. A quoted run is a `key` when the next non-space character is\n`:`, otherwise a `string`; `true`/`false` are `bool`, `null` is `null`,\nnumbers are `number`, and everything between (braces, commas, whitespace) is\n`plain`. Driven by the text, not a JSON parse, so it never throws."
+          "description": "Split a pretty-printed JSON string into classified tokens for syntax\r\nhighlighting. A quoted run is a `key` when the next non-space character is\r\n`:`, otherwise a `string`; `true`/`false` are `bool`, `null` is `null`,\r\nnumbers are `number`, and everything between (braces, commas, whitespace) is\r\n`plain`. Driven by the text, not a JSON parse, so it never throws."
         },
         {
           "kind": "class",
-          "description": "`<fsl-data-inspector>` — a syntax-highlighted view of a parent\n`<fsl-instance>`'s extended-state data. Re-reads `host.machine.data()` on the\nhost's transition / data-change / rebuild DOM events. The panel is bounded and\nscrolls internally (a self-contained vertical column). Renders `no data` when\nthe machine carries none; standalone (no host) renders empty.",
+          "description": "`<fsl-data-inspector>` — a syntax-highlighted view of a parent\r\n`<fsl-instance>`'s extended-state data. Re-reads `host.machine.data()` on the\r\nhost's transition / data-change / rebuild DOM events. The panel is bounded and\r\nscrolls internally (a self-contained vertical column). Renders `no data` when\r\nthe machine carries none; standalone (no host) renders empty.",
           "name": "FslDataInspector",
           "cssParts": [
             {
@@ -418,7 +418,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-editor>` — a CodeMirror-based FSL editor web component.\n\nBatteries-included: FSL highlighting (`jssm/cm6`), linting, a semantic\noverlay (color chips / state & enum marks), and context-aware completion —\neach toggleable via a `no-*` attribute. Light/dark via the reflected `theme`\nattribute (which also drives the `--fsl-*` token defaults). White-labeled\nthrough the shared appearance contract. Emits `change` on user edits.",
+          "description": "`<fsl-editor>` — a CodeMirror-based FSL editor web component.\r\n\r\nBatteries-included: FSL highlighting (`jssm/cm6`), linting, a semantic\r\noverlay (color chips / state & enum marks), and context-aware completion —\r\neach toggleable via a `no-*` attribute. Light/dark via the reflected `theme`\r\nattribute (which also drives the `--fsl-*` token defaults). White-labeled\r\nthrough the shared appearance contract. Emits `change` on user edits.",
           "name": "FslEditor",
           "cssParts": [
             {
@@ -767,7 +767,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-export>` — export buttons for a parent `<fsl-instance>`. Each produces a\nstring from the host's machine and fires `fsl-export` with `{ format,\ncontent }`; the embedder decides what to do with it (copy, download, show).\nFormats: Graphviz `dot` (via `machine_to_dot`), `json` (the machine's\n`serialize()`), and `fsl` (the source). Standalone is inert.",
+          "description": "`<fsl-export>` — export buttons for a parent `<fsl-instance>`. Each produces a\r\nstring from the host's machine and fires `fsl-export` with `{ format,\r\ncontent }`; the embedder decides what to do with it (copy, download, show).\r\nFormats: Graphviz `dot` (via `machine_to_dot`), `json` (the machine's\r\n`serialize()`), and `fsl` (the source). Standalone is inert.",
           "name": "FslExport",
           "cssParts": [
             {
@@ -837,7 +837,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-footer>` — a status bar for a parent `<fsl-instance>`.\n\nReflects the host's current state, legal-action count, and\nterminal/complete status by observing the host's reflected attributes\n(`current-state`, `legal-actions`, `terminal`, `complete`) — so it tracks\ntransitions *and* survives a live machine rebuild (#1387) without a machine\nsubscription. A default slot carries embedder status (line/column, parse\nstate, …). Standalone (no `<fsl-instance>` ancestor) it renders just the slot.",
+          "description": "`<fsl-footer>` — a status bar for a parent `<fsl-instance>`.\r\n\r\nReflects the host's current state, legal-action count, and\r\nterminal/complete status by observing the host's reflected attributes\r\n(`current-state`, `legal-actions`, `terminal`, `complete`) — so it tracks\r\ntransitions *and* survives a live machine rebuild (#1387) without a machine\r\nsubscription. A default slot carries embedder status (line/column, parse\r\nstate, …). Standalone (no `<fsl-instance>` ancestor) it renders just the slot.",
           "name": "FslFooter",
           "cssParts": [
             {
@@ -923,7 +923,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-help>` — a documentation drawer shell: a titled, scrollable panel with\na close button and a default slot for content (typically foldable\n`<details>` sections). Presentational and self-contained — it owns no machine\nbinding. The reflected `open` attribute drives visibility, so embedders can\nanimate it (e.g. a width transition on the host) purely from CSS.",
+          "description": "`<fsl-help>` — a documentation drawer shell: a titled, scrollable panel with\r\na close button and a default slot for content (typically foldable\r\n`<details>` sections). Presentational and self-contained — it owns no machine\r\nbinding. The reflected `open` attribute drives visibility, so embedders can\r\nanimate it (e.g. a width transition on the host) purely from CSS.",
           "name": "FslHelp",
           "cssParts": [
             {
@@ -1032,7 +1032,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-history>` — the visited-state timeline for a parent `<fsl-instance>`.\n\nListens to the host's `fsl-transition` DOM events (re-emitted once per\ntransition, #639) and records the host's reflected `current-state`, so it\ncaptures every transition and survives a live machine rebuild without a\nmachine subscription. Standalone (no host ancestor) renders empty.",
+          "description": "`<fsl-history>` — the visited-state timeline for a parent `<fsl-instance>`.\r\n\r\nListens to the host's `fsl-transition` DOM events (re-emitted once per\r\ntransition, #639) and records the host's reflected `current-state`, so it\r\ncaptures every transition and survives a live machine rebuild without a\r\nmachine subscription. Standalone (no host ancestor) renders empty.",
           "name": "FslHistory",
           "cssParts": [
             {
@@ -1085,7 +1085,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-hook-log>` — a running log of a parent `<fsl-instance>`'s machine\nevents, listening to the host's re-emitted `fsl-*` DOM events (#639). Keeps\nthe most recent MAX_ENTRIES. Standalone (no host ancestor) is empty.",
+          "description": "`<fsl-hook-log>` — a running log of a parent `<fsl-instance>`'s machine\r\nevents, listening to the host's re-emitted `fsl-*` DOM events (#639). Keeps\r\nthe most recent MAX_ENTRIES. Standalone (no host ancestor) is empty.",
           "name": "FslHookLog",
           "cssParts": [
             {
@@ -2546,7 +2546,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-simulation>` — a random-walk driver for a parent `<fsl-instance>`.\n\n`Step` fires one uniformly-random legal action; `Play` auto-steps every\nFslSimulation.interval ms and stops automatically when the machine\nreaches a terminal state (no legal actions). Standalone (no host ancestor)\nthe controls are disabled.",
+          "description": "`<fsl-simulation>` — a random-walk driver for a parent `<fsl-instance>`.\r\n\r\n`Step` fires one uniformly-random legal action; `Play` auto-steps every\r\nFslSimulation.interval ms and stops automatically when the machine\r\nreaches a terminal state (no legal actions). Standalone (no host ancestor)\r\nthe controls are disabled.",
           "name": "FslSimulation",
           "cssParts": [
             {
@@ -2673,7 +2673,7 @@
             "text": "ThemeRegistry"
           },
           "default": "{ Default: { light: { surface: '#ffffff', text: '#222222', accent: '#5b9dff', border: '#e5e5e5', muted: '#9aa0a6', 'json-key': '#5b3da8', 'json-string': '#2e7d32', 'json-number': '#b8860b', 'json-atom': '#c2185b', }, dark: { surface: '#1e1e22', text: '#d6d6d6', accent: '#82aaff', border: '#2a2a2e', muted: '#5a5f66', 'json-key': '#82aaff', 'json-string': '#c3e88d', 'json-number': '#f78c6c', 'json-atom': '#c792ea', }, }, Solarized: { light: { surface: '#fdf6e3', text: '#657b83', accent: '#268bd2', border: '#eee8d5', muted: '#93a1a1', 'json-key': '#6c71c4', 'json-string': '#859900', 'json-number': '#b58900', 'json-atom': '#d33682', }, dark: { surface: '#002b36', text: '#839496', accent: '#268bd2', border: '#073642', muted: '#586e75', 'json-key': '#6c71c4', 'json-string': '#859900', 'json-number': '#b58900', 'json-atom': '#d33682', }, }, }",
-          "description": "The built-in themes: `Default` (the suite's house palette) and `Solarized`\n(Ethan Schoonover's palette). Consumers can extend the host's `themes`\nregistry with their own; every entry shows up in the toolbar's theme list."
+          "description": "The built-in themes: `Default` (the suite's house palette) and `Solarized`\r\n(Ethan Schoonover's palette). Consumers can extend the host's `themes`\r\nregistry with their own; every entry shows up in the toolbar's theme list."
         },
         {
           "kind": "function",
@@ -2706,7 +2706,7 @@
               "description": "`light` or `dark`."
             }
           ],
-          "description": "Resolve a `(registry, theme name, variant)` triple to a concrete palette,\nfalling back to the built-in `Default` theme when the name is unknown."
+          "description": "Resolve a `(registry, theme name, variant)` triple to a concrete palette,\r\nfalling back to the built-in `Default` theme when the name is unknown."
         },
         {
           "kind": "function",
@@ -2732,7 +2732,7 @@
               "description": "Whether the OS prefers a dark color scheme."
             }
           ],
-          "description": "Resolve a theme mode to a concrete `light`/`dark`. `system` consults the OS\npreference; `light`/`dark` are returned as-is."
+          "description": "Resolve a theme mode to a concrete `light`/`dark`. `system` consults the OS\r\npreference; `light`/`dark` are returned as-is."
         },
         {
           "kind": "function",
@@ -2751,7 +2751,7 @@
               "description": "The resolved palette."
             }
           ],
-          "description": "Map a palette to its `--fsl-color-*` custom-property entries, ready to set on\nan element's style."
+          "description": "Map a palette to its `--fsl-color-*` custom-property entries, ready to set on\r\nan element's style."
         },
         {
           "kind": "function",
@@ -2817,7 +2817,7 @@
             "text": "CSSResult"
           },
           "default": "css` :host { --_fsl-surface: var(--fsl-color-surface, #ffffff); --_fsl-text: var(--fsl-color-text, #222222); --_fsl-accent: var(--fsl-color-accent, #5b9dff); --_fsl-border: var(--fsl-color-border, #e5e5e5); --_fsl-muted: var(--fsl-color-muted, #9aa0a6); --_fsl-font: var(--fsl-font, system-ui, -apple-system, \"Segoe UI\", sans-serif); --_fsl-font-mono: var(--fsl-font-mono, ui-monospace, Consolas, monospace); --_fsl-radius: var(--fsl-radius, 6px); --_fsl-space-1: var(--fsl-space-1, 4px); --_fsl-space-2: var(--fsl-space-2, 8px); --_fsl-space-3: var(--fsl-space-3, 12px); --_fsl-space-4: var(--fsl-space-4, 16px); } :host([theme=\"dark\"]) { --_fsl-surface: var(--fsl-color-surface, #1e1e22); --_fsl-text: var(--fsl-color-text, #d6d6d6); --_fsl-accent: var(--fsl-color-accent, #82aaff); --_fsl-border: var(--fsl-color-border, #2a2a2e); --_fsl-muted: var(--fsl-color-muted, #5a5f66); } `",
-          "description": "Shared FSL appearance contract — the `--fsl-*` design-token vocabulary.\n\nComponents include this in `static styles` and consume the **private**\n`--_fsl-*` vars, which resolve: embedder's public `--fsl-*` token →\n`[theme=\"dark\"]` default → built-in light fallback. White-label by setting\n`--fsl-*` on any ancestor (custom properties inherit through shadow DOM);\nflip the built-in default with the host's `theme=\"dark\"` attribute.\n\nCompanion conventions (declared per-component): expose structural elements as\n`::part(...)` (e.g. `part=\"toolbar\"`, `\"gutter\"`, `\"editor\"`) and forward\nchild parts with `exportparts`; chrome components carry brand slots\n(`<slot name=\"brand\">` / `\"logo\">`)."
+          "description": "Shared FSL appearance contract — the `--fsl-*` design-token vocabulary.\r\n\r\nComponents include this in `static styles` and consume the **private**\r\n`--_fsl-*` vars, which resolve: embedder's public `--fsl-*` token →\r\n`[theme=\"dark\"]` default → built-in light fallback. White-label by setting\r\n`--fsl-*` on any ancestor (custom properties inherit through shadow DOM);\r\nflip the built-in default with the host's `theme=\"dark\"` attribute.\r\n\r\nCompanion conventions (declared per-component): expose structural elements as\r\n`::part(...)` (e.g. `part=\"toolbar\"`, `\"gutter\"`, `\"editor\"`) and forward\r\nchild parts with `exportparts`; chrome components carry brand slots\r\n(`<slot name=\"brand\">` / `\"logo\">`)."
         }
       ],
       "exports": [
@@ -2837,7 +2837,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-toolbar>` — a control bar for a parent `<fsl-instance>`. A light/dark\ntheme toggle on the left; on the right, an icon toggle to show/hide each\npanel present in the host (renderer, code, history, …) plus a View menu of\nthe layout set (its button shows the current layout's icon). Standalone (no\nhost) the panel toggles disappear. A trailing slot carries extra buttons.",
+          "description": "`<fsl-toolbar>` — a control bar for a parent `<fsl-instance>`. A light/dark\r\ntheme toggle on the left; on the right, an icon toggle to show/hide each\r\npanel present in the host (renderer, code, history, …) plus a View menu of\r\nthe layout set (its button shows the current layout's icon). Standalone (no\r\nhost) the panel toggles disappear. A trailing slot carries extra buttons.",
           "name": "FslToolbar",
           "cssParts": [
             {
@@ -2878,7 +2878,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The last directory an export was saved to this session (its final path\nsegment). When non-empty, the Export menu offers a `to <name>` destination.\nThe embedder sets this after fulfilling a `pick` export."
+              "description": "The last directory an export was saved to this session (its final path\r\nsegment). When non-empty, the Export menu offers a `to <name>` destination.\r\nThe embedder sets this after fulfilling a `pick` export."
             },
             {
               "kind": "field",
@@ -2916,7 +2916,7 @@
                   }
                 }
               ],
-              "description": "Set the theme mode (System/Light/Dark). The host applies the palette + drives\nthe editor; the menu stays open so a theme can be picked in the same trip."
+              "description": "Set the theme mode (System/Light/Dark). The host applies the palette + drives\r\nthe editor; the menu stays open so a theme can be picked in the same trip."
             },
             {
               "kind": "method",
@@ -2935,7 +2935,7 @@
                   }
                 }
               ],
-              "description": "Select a named theme from the host's registry. The theme-name buttons only\nrender when a host exists, so `_host` is non-null here."
+              "description": "Select a named theme from the host's registry. The theme-name buttons only\r\nrender when a host exists, so `_host` is non-null here."
             },
             {
               "kind": "method",
@@ -2972,7 +2972,7 @@
                   }
                 }
               ],
-              "description": "Set the active export destination; the menu stays open so a format can be\nchosen next."
+              "description": "Set the active export destination; the menu stays open so a format can be\r\nchosen next."
             },
             {
               "kind": "method",
@@ -2991,7 +2991,7 @@
                   }
                 }
               ],
-              "description": "Emit `fsl-export` with the chosen format's content + the active destination.\nThe embedder performs the actual clipboard / file save."
+              "description": "Emit `fsl-export` with the chosen format's content + the active destination.\r\nThe embedder performs the actual clipboard / file save."
             },
             {
               "kind": "method",
@@ -3233,7 +3233,7 @@
               "description": "SVG markup from the viz pipeline (`machine_to_svg_string`, etc.)."
             }
           ],
-          "description": "Reorder a graphviz-rendered SVG's paint stack so action labels can't be\npainted over by edges. Graphviz interleaves nodes and edges and keeps each\nedge's label `<text>` inside the edge group, so a later edge can draw over an\nearlier edge's label. This lifts the layers into a clean back-to-front order:\n\n  background → edges → nodes → action (edge) labels\n\nEach edge's label text is hoisted out of its edge group to the very top.\nMarkup that isn't graphviz output (no `g.graph`) is returned untouched."
+          "description": "Reorder a graphviz-rendered SVG's paint stack so action labels can't be\r\npainted over by edges. Graphviz interleaves nodes and edges and keeps each\r\nedge's label `<text>` inside the edge group, so a later edge can draw over an\r\nearlier edge's label. This lifts the layers into a clean back-to-front order:\r\n\r\n  background → edges → nodes → action (edge) labels\r\n\r\nEach edge's label text is hoisted out of its edge group to the very top.\r\nMarkup that isn't graphviz output (no `g.graph`) is returned untouched."
         }
       ],
       "exports": [

package/dist/cdn/instance.js

@@ -22956,7 +22956,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.148.0";
+const version = "5.148.2";
 
 // whargarbl lots of these return arrays could/should be sets
 const { state_name_chars, state_name_first_chars, action_label_chars } = constants;

package/dist/cdn/viz.js

@@ -22981,7 +22981,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.148.0";
+const version = "5.148.2";
 
 // whargarbl lots of these return arrays could/should be sets
 const { state_name_chars, state_name_first_chars, action_label_chars } = constants;

package/dist/cli/fsl-export-system-prompt.cjs

@@ -108,7 +108,7 @@ function parseFslArgs(argv, spec) {
   return { positional, flags, helpText };
 }
 
-const getVersion = () => "5.148.0";
+const getVersion = () => "5.148.2";
 const SPEC = {
   flags: {
     help: { short: "h", boolean: true },
@@ -171,12 +171,12 @@ Idle 'cancel' -> Off;
 
 ### Explicit State Declarations and Attributes
 \`\`\`fsl
-state Red {
+state Red : {
   background-color : red;
   text-color       : white;
 };
 
-state Green {
+state Green : {
   background-color : green;
 };