jssm 5.119.0 → 5.120.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.119.0 at 5/13/2026, 4:03:07 PM
+* Generated for version 5.120.2 at 5/16/2026, 5:12:50 PM
 
 -->
-# jssm 5.119.0
+# jssm 5.120.2
 
 [**Try the live editor**](https://stonecypher.github.io/jssm-viz-demo/graph_explorer.html) ·
 [Documentation](https://stonecypher.github.io/jssm/docs/) ·
@@ -120,6 +120,65 @@ usage patterns.
 
 
 
+<br/>
+
+## Command-line interface
+
+`jssm` ships a CLI for rendering FSL machines to images and other formats.
+
+### Installation
+
+```sh
+npm install -g jssm
+```
+
+This installs three binaries: `fsl` (the dispatcher), `jssm` (alias for `fsl`), and `fsl-render` (the render plugin).
+
+### Render
+
+Render a single machine to SVG (default):
+
+```sh
+fsl render machine.fsl
+# → machine.svg next to input
+```
+
+Specify a format:
+
+```sh
+fsl render machine.fsl --target=png --width=800
+fsl render machine.fsl --target=dot --stdout > machine.dot
+```
+
+Render multiple machines:
+
+```sh
+fsl render *.fsl --target=svg --out-dir=./diagrams
+```
+
+Pipe FSL via stdin:
+
+```sh
+cat machine.fsl | fsl render --target=dot | dot -Tpng > out.png
+```
+
+### Plugin architecture
+
+Every `fsl-<name>` executable on PATH is dispatched when you run `fsl <name>`. Third-party plugins follow the same contract as first-party `fsl-render`. See `notes/superpowers/specs/2026-05-12-fsl-cli-design.md` for the contract.
+
+### Library API
+
+The same render functions are available programmatically:
+
+```js
+import { render, renderSet } from 'jssm/cli';
+
+const result = await render(fslText, { target: 'svg' });
+if (result.kind === 'text') console.log(result.content);
+```
+
+
+
 <br/>
 
 ## Web Components
@@ -222,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.**  5,809 tests at 100.0% line coverage
+  library.**  5,990 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.
@@ -355,11 +414,11 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***5,809 tests***, run 56,596 times.
+***5,990 tests***, run 56,777 times.
 
-- 5,296 specs with 100.0% coverage
-- 513 fuzz tests with 59.2% coverage
-- 3,593 TypeScript lines - 1.6 tests per line, 15.8 generated tests per line
+- 5,477 specs with 100.0% coverage
+- 513 fuzz tests with 20.2% coverage
+- 4,280 TypeScript lines - 1.4 tests per line, 13.3 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

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