jssm 5.122.4 → 5.124.0

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.122.4 at 5/18/2026, 3:52:18 PM
+* Generated for version 5.124.0 at 5/19/2026, 9:06:59 AM
 
 -->
-# jssm 5.122.4
+# jssm 5.124.0
 
 [**Try the live editor**](https://stonecypher.github.io/jssm-viz-demo/graph_explorer.html) ·
 [Documentation](https://stonecypher.github.io/jssm/docs/) ·
@@ -281,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.**  6,053 tests at 100.0% line coverage
+  library.**  6,064 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.
@@ -414,11 +414,11 @@ If your contribution is missing here, please open an issue.
 
 <br/>
 
-***6,053 tests***, run 56,840 times.
+***6,064 tests***, run 56,851 times.
 
-- 5,540 specs with 100.0% coverage
+- 5,551 specs with 100.0% coverage
 - 513 fuzz tests with 4.5% coverage
-- 4,359 TypeScript lines - 1.4 tests per line, 13.0 generated tests per line
+- 4,331 TypeScript lines - 1.4 tests per line, 13.1 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

@@ -21041,7 +21041,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.122.4";
+const version = "5.124.0";
 
 // whargarbl lots of these return arrays could/should be sets
 const { state_name_chars, state_name_first_chars, action_label_chars } = constants;
@@ -24504,15 +24504,21 @@ function default_fillcolor_for(kind) {
  *  honoured uniformly.  A single `style_for` call per state — downstream
  *  helpers operate on the cached result rather than re-querying.
  *
+ *  When `hide_state_labels` is true, the `label=` attribute is omitted from
+ *  every state's node line; Graphviz then renders the node box without any
+ *  text inside.  Useful for diagrams where the state shape carries meaning
+ *  on its own (e.g. a tutorial graphic, an icon-only diagram, or a
+ *  presentation slide).
+ *
  *  @internal
  */
-function states_to_nodes_string(u_jssm, l_states, state_index, state_kinds) {
+function states_to_nodes_string(u_jssm, l_states, state_index, state_kinds, hide_state_labels = false) {
     return l_states.map((s) => {
         var _a;
         const style = u_jssm.style_for(s);
         const fillcolor = style.backgroundColor || default_fillcolor_for((_a = state_kinds.get(s)) !== null && _a !== void 0 ? _a : 'base');
         const features = [
-            ['label', u_jssm.display_text(s)],
+            ['label', hide_state_labels ? '' : u_jssm.display_text(s)],
             ['shape', style.shape || ''],
             ['color', style.borderColor || ''],
             ['style', compose_style_string(style)],
@@ -24686,21 +24692,23 @@ function arranges_for(u_jssm, state_index) {
  *  const dot = machine_to_dot(sm`a -> b;`);
  *  // 'digraph G { ... }'
  *
+ *  // suppress state-name labels (boxes only, no text inside)
+ *  const dot2 = machine_to_dot(sm`a -> b;`, { hide_state_labels: true });
+ *
  *  const dot_with_footer = machine_to_dot(sm`a -> b;`, { footer: 'labelloc="b"; label="caption";' });
  *  // 'digraph G { ... labelloc="b"; label="caption"; }'
  *  ```
  *
  *  @param u_jssm The machine to render.
- *  @param opts Optional rendering options.
- *  @param opts.footer Optional verbatim dot source inserted just before the closing `}`.
+ *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A complete graphviz dot source string.
  */
-function machine_to_dot(u_jssm, opts) {
+function machine_to_dot(u_jssm, opts = {}) {
     var _a;
     const l_states = u_jssm.states();
     const state_index = new Map(l_states.map((s, i) => [s, i]));
     const state_kinds = classify_states(u_jssm, l_states);
-    const nodes = states_to_nodes_string(u_jssm, l_states, state_index, state_kinds);
+    const nodes = states_to_nodes_string(u_jssm, l_states, state_index, state_kinds, opts.hide_state_labels === true);
     const edges = states_to_edges_string(u_jssm, l_states, state_index, state_kinds);
     const arranges = arranges_for(u_jssm, state_index);
     const rank_dir = flow_direction_to_rankdir(u_jssm.flow() || 'down');
@@ -24715,16 +24723,18 @@ function machine_to_dot(u_jssm, opts) {
  *  import { fsl_to_dot } from 'jssm/viz';
  *  const dot = fsl_to_dot('a -> b;');
  *
+ *  // suppress state-name labels
+ *  const dot2 = fsl_to_dot('a -> b;', { hide_state_labels: true });
+ *
  *  const dot_with_footer = fsl_to_dot('a -> b;', { footer: 'label="caption";' });
  *  // 'digraph G { ... label="caption"; }'
  *  ```
  *
  *  @param fsl The FSL source.
- *  @param opts Optional rendering options.
- *  @param opts.footer Optional verbatim dot source inserted just before the closing `}`.
+ *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A complete graphviz dot source string.
  */
-function fsl_to_dot(fsl, opts) {
+function fsl_to_dot(fsl, opts = {}) {
     return machine_to_dot(sm `${fsl}`, opts);
 }
 /**
@@ -24757,13 +24767,10 @@ async function dot_to_svg(dot, options) {
  *  ```
  *
  *  @param fsl The FSL source.
- *  @param opts Optional rendering options.
- *  @param opts.footer Optional verbatim dot source inserted just before the closing `}` of the intermediate dot source.
- *  @param opts.engine Graphviz layout engine to use (e.g. `'dot'`, `'neato'`, `'circo'`).
- *  Unrecognized engine names cause `@viz-js/viz` to throw at render time.
+ *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A promise resolving to an SVG XML string.
  */
-async function fsl_to_svg_string(fsl, opts) {
+async function fsl_to_svg_string(fsl, opts = {}) {
     return dot_to_svg(fsl_to_dot(fsl, opts), opts);
 }