jssm 5.150.1 → 5.151.1

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.150.1 at 6/28/2026, 10:20:13 AM
+* Generated for version 5.151.1 at 6/28/2026, 1:33:22 PM
 
 -->
-# jssm 5.150.1
+# jssm 5.151.1
 
 [**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,720 tests at 100.0% line coverage
+  library.**  7,737 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,11 +445,11 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***7,720 tests***, run 82,366 times.
+***7,737 tests***, run 82,383 times.
 
-- 6,966 specs with 100.0% coverage
-- 754 fuzz tests with 57.0% coverage
-- 9,100 TypeScript lines - 0.8 tests per line, 9.1 generated tests per line
+- 6,983 specs with 100.0% coverage
+- 754 fuzz tests with 56.0% coverage
+- 9,228 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

@@ -434,6 +434,54 @@
           ],
           "description": "Parse a fenced-code info string like `fsl {teaches: x, run: true}`."
         },
+        {
+          "kind": "variable",
+          "name": "FSL_KEYWORDS",
+          "default": "new Set([ 'state', 'start_state', 'end_state', 'active_state', 'terminal_state', 'hooked_state', 'transition', 'graph', 'on', 'enter', 'exit', 'do', 'arrange', 'arrange-start', 'arrange-end', 'machine_name', 'machine_author', 'machine_license', 'machine_version', 'machine_comment', 'fsl_version', 'flow', 'graph_layout', 'allow_islands', 'allows_override', 'required', 'true', 'false', 'null', 'undefined', ])",
+          "description": "Structural / attribute keywords highlighted in fsl code fences."
+        },
+        {
+          "kind": "variable",
+          "name": "FSL_COLOR_KEYS",
+          "default": "new Set([ 'color', 'text-color', 'background-color', 'border-color', 'edge-color', ])",
+          "description": "Attribute keys whose value is a color, mirroring the editor's `COLOR_KEYS`\n(language_service). The value token following one of these (plus its `:`) is\ntagged `color` and rendered with a swatch, matching the editor overlay."
+        },
+        {
+          "kind": "function",
+          "name": "tokenizeFsl",
+          "return": {
+            "type": {
+              "text": "FslToken[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "src",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Tokenize FSL source into `{cls, text}` runs for syntax highlighting. A pure,\nregex-driven scanner — never parses, so it cannot throw on malformed input.\n`cls` is null for uncategorized text (punctuation, identifiers, whitespace).\n\nBeyond the lexical classes it tracks one bit of structural context: an\nidentifier immediately before a `:` is retro-tagged `key` (an attribute key,\nunless it is already a `keyword`), and the value token after a color key's\ncolon — or any hex literal — is tagged `color`. The context never spans a\n`;`, so a value can't leak past its statement."
+        },
+        {
+          "kind": "function",
+          "name": "highlightFsl",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "src",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Highlight FSL source to an HTML string of `<span class=\"fsl-tok-…\">` runs.\nA `color` token is preceded by an inline `<span class=\"fsl-swatch\">` whose\nbackground is the literal color text (a CSS-valid named color or hex), giving\nthe docs the same swatch the editor overlay shows. Color text is a hex or\nidentifier run, so it is a safe `background:` value."
+        },
         {
           "kind": "function",
           "name": "renderMarkdown",
@@ -462,6 +510,38 @@
             "module": "src/ts/wc/fsl_docs_markdown.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "FSL_KEYWORDS",
+          "declaration": {
+            "name": "FSL_KEYWORDS",
+            "module": "src/ts/wc/fsl_docs_markdown.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FSL_COLOR_KEYS",
+          "declaration": {
+            "name": "FSL_COLOR_KEYS",
+            "module": "src/ts/wc/fsl_docs_markdown.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "tokenizeFsl",
+          "declaration": {
+            "name": "tokenizeFsl",
+            "module": "src/ts/wc/fsl_docs_markdown.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "highlightFsl",
+          "declaration": {
+            "name": "highlightFsl",
+            "module": "src/ts/wc/fsl_docs_markdown.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "renderMarkdown",
@@ -478,7 +558,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<fsl-docs>` — the language-docs content engine: drill-in nav over the bundled\r\ncurriculum (Getting Started / About State Machines / Tutorials / Example\r\nMachines / Index / Search), a markdown page renderer, and \"load into editor\"\r\nfor tagged FSL examples. Content-only; slot it into `<fsl-help>`.",
+          "description": "`<fsl-docs>` — the language-docs content engine: drill-in nav over the bundled\ncurriculum (Getting Started / About State Machines / Tutorials / Example\nMachines / Index / Search), a markdown page renderer, and \"load into editor\"\nfor tagged FSL examples. Content-only; slot it into `<fsl-help>`.",
           "name": "FslDocs",
           "members": [
             {
@@ -3245,7 +3325,7 @@
           "name": "permalink_for",
           "return": {
             "type": {
-              "text": "string"
+              "text": ""
             }
           },
           "parameters": [
@@ -3256,7 +3336,25 @@
               }
             }
           ],
-          "description": "A shareable URL for the given FSL: the current page URL with the source\r\nencoded in the hash (`#fsl=...`). A page that reads the hash on load can\r\nrestore the machine. Browser-only (uses `location`), like the rest of the\r\ntoolbar."
+          "description": "A shareable URL for the given FSL: the current page URL with the source\r\ncompressed into the hash as `#m=<scheme><payload>`. The payload is URL-safe\r\nbase64, so no characters need percent-escaping; `<scheme>` is a single digit\r\n— `1` when DEFLATE made the source smaller, `0` for the raw bytes when it did\r\nnot — so a short machine's link is never longer than its uncompressed form.\r\nDecode with fsl_from_permalink. Browser-only (uses `location` and the\r\nplatform compression streams), like the rest of the toolbar."
+        },
+        {
+          "kind": "function",
+          "name": "fsl_from_permalink",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "url",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Recover the FSL source from a permalink produced by permalink_for:\r\nread the `#m=<scheme><payload>` fragment, decode the URL-safe base64, and\r\ninflate when `<scheme>` is `1`. Accepts a full URL or a bare fragment, with\r\nor without the leading `#`."
         },
         {
           "kind": "function",
@@ -3543,6 +3641,14 @@
             "module": "src/ts/wc/fsl_toolbar_wc.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "fsl_from_permalink",
+          "declaration": {
+            "name": "fsl_from_permalink",
+            "module": "src/ts/wc/fsl_toolbar_wc.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "embed_snippet_for",

package/dist/cdn/instance.js

@@ -23371,7 +23371,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.150.1";
+const version = "5.151.1";
 
 // 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

@@ -23396,7 +23396,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.150.1";
+const version = "5.151.1";
 
 // 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.150.1";
+const getVersion = () => "5.151.1";
 const SPEC = {
   flags: {
     help: { short: "h", boolean: true },