jssm 5.162.6 → 5.162.8

package/dist/cm6/fsl_language.js

@@ -77,13 +77,13 @@ const ENUM_KEYWORDS = new Set([
 ]);
 /** Custom token-type string emitted for deprecated keywords; mapped in `tokenTable`. */
 const DEPRECATED_TOKEN = 'fslDeprecatedKeyword';
-const ARROWS = /^(?:<-=>|<-~>|<=->|<=~>|<~->|<~=>|<->|<=>|<~>|->|<-|=>|<=|~>|<~|↔|←|→|⇔|⇐|⇒|↮|↚|↛)/;
+const ARROWS = /^(?:<-=>|<-~>|<=->|<=~>|<~->|<~=>|<->|<=>|<~>|->|<-|=>|<=|~>|<~|[↔←→⇔⇐⇒↮↚↛])/;
 const COMPARATORS = /^(?:>=|<=|>|<)/;
 // Mirrors the grammar's AtomFirstLetter / AtomLetter rules (fsl_parser.peg:263-267).
 // The high-unicode tail is the range U+0080..U+FFFF (escaped below). The
 // original sketch anchored the range at the comma, wrongly swallowing { } ; : |.
-const ATOM_START = /[0-9a-zA-Z._!$^*?,\u0080-\uFFFF]/;
-const ATOM_BODY = /[0-9a-zA-Z.+_^()*&$#@!?,\u0080-\uFFFF]/;
+const ATOM_START = /[\w.!$^*?,\u{80}-\u{FFFF}]/u;
+const ATOM_BODY = /[\w.+^()*&$#@!?,\u{80}-\u{FFFF}]/u;
 /**
  * The StreamLanguage tokenizer for FSL. Classifies each token into a standard
  * CodeMirror highlight name, or {@link DEPRECATED_TOKEN} (mapped through
@@ -129,7 +129,7 @@ const fslStreamParser = {
         if (stream.match(/^\d+(?:\.\d+)*/)) {
             return 'number';
         }
-        if (stream.match(/^&[A-Za-z_]\w*/)) {
+        if (stream.match(/^&[A-Z_]\w*/i)) {
             return 'variableName.special';
         }
         // Invariant: the loop guards `!eol` and `eatSpace()` returned false above,
@@ -139,13 +139,11 @@ const fslStreamParser = {
             let tok = '';
             let next = stream.peek();
             while (next !== undefined) {
-                if (ATOM_BODY.test(next)) {
-                    tok += stream.next();
-                }
-                else if (next === '-' && ATOM_BODY.test(stream.string.slice(stream.pos + 1, stream.pos + 2))) {
-                    // An interior hyphen (between word chars) joins a compound key like
-                    // `background-color`; a trailing one (before `>` of `->`, or at EOL)
-                    // does not. `slice` yields '' past the end, so no nullish branch.
+                // An interior hyphen (between word chars) joins a compound key like
+                // `background-color`; a trailing one (before `>` of `->`, or at EOL)
+                // does not. `slice` yields '' past the end, so no nullish branch.
+                const interior_hyphen = next === '-' && ATOM_BODY.test(stream.string.slice(stream.pos + 1, stream.pos + 2));
+                if (ATOM_BODY.test(next) || interior_hyphen) {
                     tok += stream.next();
                 }
                 else {
@@ -167,7 +165,7 @@ const fslStreamParser = {
             }
             return 'variableName';
         }
-        if (stream.match(/^[\[\]{}()]/)) {
+        if (stream.match(/^[[\]{}()]/)) {
             return 'bracket';
         }
         if (stream.match(/^[;:,|]/)) {
@@ -198,9 +196,7 @@ const fslHighlightStyle = HighlightStyle.define([
 ]);
 /**
  * CodeMirror 6 `LanguageSupport` for FSL. Drop into an editor's `extensions`.
- *
  * @returns A `LanguageSupport` extension for FSL highlighting.
- *
  * @example
  *   import { EditorView, basicSetup } from 'codemirror';
  *   import { fsl } from 'jssm/cm6';

package/dist/deno/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.6 at 7/10/2026, 9:42:29 AM
+* Generated for version 5.162.8 at 7/11/2026, 2:09:30 PM
 
 -->
-# jssm 5.162.6
+# jssm 5.162.8
 
 [**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,071 tests at 100.0% line coverage
+  library.**  8,093 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.
@@ -466,11 +466,11 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***8,071 tests***, run 83,509 times.
+***8,093 tests***, run 83,531 times.
 
-- 7,309 specs with 100.0% coverage
-- 762 fuzz tests with 48.1% coverage
-- 10,748 TypeScript lines - 0.8 tests per line, 7.8 generated tests per line
+- 7,331 specs with 100.0% coverage
+- 762 fuzz tests with 47.8% coverage
+- 10,882 TypeScript lines - 0.7 tests per line, 7.7 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/deno/fence.d.ts

@@ -4,7 +4,6 @@
  *  highlighting, animated walk GIFs, and a whole-document Markdown
  *  transformer — plus the reusable primitives behind them (GIF89a encoder,
  *  walk planner, SVG patching).
- *
  *  @see render_fence_html
  *  @see transform_markdown
  */

package/dist/deno/fsl_fence_highlight.d.ts

@@ -22,10 +22,8 @@ export interface HighlightRun {
  *
  *  This is the parity guarantee: there is no third tokenizer, so static
  *  output can never disagree with the editor.
- *
  *  @param source  FSL source text to classify.
  *  @returns       Flat, gap-free, order-preserving runs; `runs.map(r => r.text).join('')` is `source`.
- *
  *  @example
  *  highlight_fsl_runs('Red -> Green;').find(r => r.state === 'Red');
  *  // { text: 'Red', classes: 'fsl-tok-variableName fsl-sem-state', state: 'Red' }
@@ -37,12 +35,10 @@ export declare function highlight_fsl_runs(source: string): HighlightRun[];
  *  `data-state`; when `inline_colors` (default true) and the state appears in
  *  `state_colors`, an inline `style="color:…"` ties the code block's state
  *  names to the diagram's node colors with zero host CSS.
- *
  *  @param source  FSL source text to render.
  *  @param opts.state_colors    Maps a state name to its diagram fill color (e.g. from `extract_state_fills`).
  *  @param opts.inline_colors   Whether to emit inline `style="color:…"` for matched states. Defaults to `true`.
  *  @returns       HTML markup for the highlighted source; unclassed runs are emitted as escaped text with no wrapping span.
- *
  *  @example
  *  highlight_fsl_html('Red -> Green;', { state_colors: new Map([['Red', '#a00']]) });
  *  // '…<span class="… fsl-sem-state" data-state="Red" style="color:#a00">Red</span>…'

package/dist/deno/fsl_fence_render.d.ts

@@ -9,12 +9,10 @@ export interface FenceRenderOptions {
  *  editor-parity code highlighting whose state names carry the diagram's own
  *  node colors.  Invalid FSL renders a visible error box — this function
  *  never throws for bad machine source.
- *
  *  @param source - The FSL machine source (fence body).
  *  @param info - The fence info string (e.g. `'fsl image code width=300'`).
  *  @param opts.inline_colors - Whether code spans carry inline diagram colors (default true).
  *  @returns The rendered `<div class="fsl-fence">…</div>` markup.
- *
  *  @example
  *  await render_fence_html('Red => Green => Red;', 'fsl');
  *  // '<div class="fsl-fence" …><svg…/svg><pre class="fsl-code">…</pre></div>'
@@ -26,11 +24,9 @@ export declare function render_fence_html(source: string, info: string, opts?: F
  *  Each fence is isolated — a broken machine becomes its own error box and
  *  the rest of the document still renders.  Backtick fences of length ≥3
  *  are recognized; tilde fences are out of scope (v1, spec §9).
- *
  *  @param markdown - The full Markdown document source.
  *  @param opts.inline_colors - Whether code spans carry inline diagram colors (default true).
  *  @returns The document with every `fsl`/`jssm` fence replaced by rendered HTML.
- *
  *  @example
  *  await transform_markdown('# Doc\n\n```fsl\na -> b;\n```\n');
  *  // '# Doc\n\n<div class="fsl-fence">…</div>\n'
@@ -55,7 +51,6 @@ export interface GifRenderOptions {
  *  every-edge tour.  Graphviz lays the machine out ONCE; each frame patches
  *  one state's fill in the SVG string and rasterizes — identical geometry
  *  across frames, no layout jitter.
- *
  *  @param source - The FSL machine source.
  *  @param opts.delay_cs - Per-frame delay in centiseconds (default 70).
  *  @param opts.loop - Netscape loop count, 0 = forever (default 0).
@@ -63,14 +58,11 @@ export interface GifRenderOptions {
  *  @param opts.scale - Raster zoom percentage, 100 = 3× natural size (default 100).
  *  @param opts.highlight_fill - Fill painted on the walked state (default '#ff9930').
  *  @returns The encoded GIF89a bytes.
- *
  *  @throws {JssmError} on invalid FSL (programmatic callers want exceptions;
  *  the HTML renderers catch and box instead).
- *
  *  @example
  *  const gif = await render_fence_gif('Red => Green => Yellow => Red;');
  *  // Uint8Array starting "GIF89a", three frames, looping forever
- *
  *  @see plan_walk
  *  @see encode_gif
  */

package/dist/deno/fsl_gif.d.ts

@@ -14,16 +14,13 @@ export interface Quantized {
  *  `max_colors` or fewer distinct colors they are preserved exactly;
  *  otherwise a median-cut partition supplies the palette and each pixel maps
  *  to its box's weighted-average color.
- *
  *  @param rgba - Straight RGBA bytes; length must be a multiple of 4.
  *  @param max_colors - Palette ceiling, 2..256.
- *
  *  @throws {JssmError} when `rgba.length` is not a multiple of 4.
  *  @throws {JssmError} when `max_colors` is outside 2..256 — above 256 the
  *  palette index no longer fits the `Uint8Array` indices this module packs
  *  into GIF codes (silent index corruption instead of a clear failure);
  *  below 2 there is no palette to quantize into.
- *
  *  @example
  *  const q = quantize(new Uint8Array([255,0,0,255, 0,255,0,255]));
  *  q.palette_count;  // 2
@@ -34,10 +31,8 @@ export declare function quantize(rgba: Uint8Array, max_colors?: number): Quantiz
  *  from `min_code_size + 1` up to the format's 12-bit ceiling, resets the
  *  dictionary when full, terminates with EOI, and packs codes LSB-first.
  *  Returns raw compressed bytes; the caller wraps them in GIF data sub-blocks.
- *
  *  @param indices - Palette indices, each `< 2^min_code_size`.
  *  @param min_code_size - Bits needed for the palette (2..8 for GIF).
- *
  *  @example
  *  lzw_encode(new Uint8Array([0, 0, 1]), 2);  // Uint8Array of packed codes
  */
@@ -62,14 +57,11 @@ export interface GifOptions {
  *  palette, so every frame is pixel-exact while the union stays within 256
  *  distinct colors.  Frames must share dimensions.  No transparency,
  *  full-frame disposal — simple and correct first.
- *
  *  @param frames - At least one frame; all with identical width/height and
  *  `rgba.length === 4 · width · height`.
- *
  *  @throws {JssmError} on zero frames, a zero-width or zero-height frame,
  *  mismatched dimensions, or an rgba buffer whose length contradicts its
  *  stated dimensions.
- *
  *  @example
  *  const red = { rgba: new Uint8Array([255,0,0,255]), width: 1, height: 1 };
  *  const gif = encode_gif([red], { delay_cs: 50 });

package/dist/deno/fsl_markdown_fence.d.ts

@@ -3,7 +3,6 @@
  *  turns a fenced-code-block info string into a {@link FenceDescriptor}.  Hosts
  *  (a VS Code preview plugin, a static-site generator, …) each interpret the
  *  descriptor according to their capabilities.
- *
  *  @see notes/superpowers/specs/2026-06-23-fsl-markdown-fence-convention-design.md
  */
 /** A single renderable part of a fence block (stacks in listed order, first on top). */
@@ -31,10 +30,8 @@ export interface FenceDescriptor {
  *  Canonical fence language for an info string, or `null` if the block is not
  *  an FSL fence.  Reads only the first whitespace-delimited token,
  *  case-insensitively.
- *
  *  @param info The full fence info string (everything after the opening fence).
  *  @returns `'fsl'` or `'jssm'` for our fences; `null` otherwise.
- *
  *  @example fsl_fence_lang('fsl image code') // => 'fsl'
  *  @example fsl_fence_lang('JSSM')           // => 'jssm'
  *  @example fsl_fence_lang('mermaid')        // => null
@@ -46,10 +43,8 @@ export declare function fsl_fence_lang(info: string): 'fsl' | 'jssm' | null;
  *  classified as parts, image formats, the `ide` macro, or `width`/`height`
  *  options.  Unrecognized or conflicting tokens are dropped and recorded in
  *  `notes` rather than throwing, so a host can render forward-compatibly.
- *
  *  @param info The full fence info string, e.g. `'fsl image code width=300'`.
  *  @returns The validated descriptor; `notes` lists anything ignored or overridden.
- *
  *  @example parse_fence_info('fsl').parts // => ['image', 'code']
  *  @example parse_fence_info('fsl code image').parts // => ['code', 'image']
  */

package/dist/deno/fsl_svg_patch.d.ts

@@ -2,12 +2,9 @@
  *  Read each state's current fill color out of a graphviz-rendered machine
  *  SVG, keyed by state name.  States whose shape carries no `fill` attribute
  *  are omitted.
- *
  *  @param svg - SVG markup from the jssm viz pipeline (`fsl_to_svg_string`).
- *
  *  @example
  *  extract_state_fills(await fsl_to_svg_string('A -> B;'));  // Map { 'A' => '#…', 'B' => '#…' }
- *
  *  @see patch_state_fill
  */
 export declare function extract_state_fills(svg: string): Map<string, string>;
@@ -15,14 +12,11 @@ export declare function extract_state_fills(svg: string): Map<string, string>;
  *  Return a copy of the SVG with the named state's first shape fill replaced.
  *  The unmatched-state case returns the input unchanged (walk truncation and
  *  render races surface as a missing highlight, never a throw).
- *
  *  @param svg - SVG markup from the jssm viz pipeline.
  *  @param state - State name as written in FSL (unescaped).
  *  @param fill - Any SVG paint value, e.g. `'#ff9930'`.
- *
  *  @example
  *  patch_state_fill(svg, 'Red', '#ff9930');  // Red's node now renders orange
- *
  *  @see extract_state_fills
  */
 export declare function patch_state_fill(svg: string, state: string, fill: string): string;

package/dist/deno/fsl_walk.d.ts

@@ -12,10 +12,8 @@ import type { Machine } from './jssm.js';
  *
  *  This is presentation, not simulation — a tour's consecutive entries need
  *  not be legal transitions, and no machine state is mutated.
- *
  *  @example
  *  plan_walk(sm`Red => Green => Yellow => Red;`);  // ['Red', 'Green', 'Yellow']
- *
  *  @see encode_gif
  */
 export declare function plan_walk(machine: Machine<unknown>): string[];