jssm 5.156.0 → 5.157.0

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.156.0 at 6/28/2026, 9:25:43 PM
+* Generated for version 5.157.0 at 7/2/2026, 1:06:52 AM
 
 -->
-# jssm 5.156.0
+# jssm 5.157.0
 
 [**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,822 tests at 100.0% line coverage
+  library.**  7,862 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,822 tests***, run 82,864 times.
+***7,862 tests***, run 82,904 times.
 
-- 7,064 specs with 100.0% coverage
-- 758 fuzz tests with 54.1% coverage
-- 9,761 TypeScript lines - 0.8 tests per line, 8.5 generated tests per line
+- 7,104 specs with 100.0% coverage
+- 758 fuzz tests with 53.4% coverage
+- 9,871 TypeScript lines - 0.8 tests per line, 8.4 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/fsl_markdown_fence.d.ts

@@ -0,0 +1,56 @@
+/**
+ *  The FSL Markdown fence convention parser — pure, host-agnostic logic that
+ *  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). */
+export declare type FencePart = 'image' | 'code' | 'dot' | 'editor' | 'actions' | 'info-panel' | 'toolbar' | 'title' | 'footer';
+/** An image output format for the `image` part. */
+export declare type FenceImageFormat = 'svg' | 'png' | 'jpeg' | 'gif';
+/** The unit of a {@link FenceDimension} (`%` is represented as `'percent'`). */
+export declare type FenceDimensionUnit = 'px' | 'percent';
+/** A parsed `width=`/`height=` value with its unit. */
+export interface FenceDimension {
+    value: number;
+    unit: FenceDimensionUnit;
+}
+/** The fully-parsed, validated description of one FSL Markdown fence block. */
+export interface FenceDescriptor {
+    parts: FencePart[];
+    ide: boolean;
+    format: FenceImageFormat;
+    width: FenceDimension | null;
+    height: FenceDimension | null;
+    interactive: boolean;
+    notes: string[];
+}
+/**
+ *  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
+ */
+export declare function fsl_fence_lang(info: string): 'fsl' | 'jssm' | null;
+/**
+ *  Parse a fence info string into a {@link FenceDescriptor}.  The first token is
+ *  the (already-validated) language and is ignored; remaining tokens are
+ *  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']
+ */
+export declare function parse_fence_info(info: string): FenceDescriptor;

package/dist/deno/jssm.d.ts

@@ -2846,3 +2846,5 @@ declare function compareVersions(v1: string, v2: string): number;
  */
 declare function deserialize<mDT>(machine_string: string, ser: JssmSerialization<mDT>): Machine<mDT>;
 export { version, build_time, transfer_state_properties, Machine, deserialize, compareVersions, make, wrap_parse as parse, compile, sm, from, arrow_direction, arrow_left_kind, arrow_right_kind, seq, unique, find_repeated, weighted_rand_select, histograph, weighted_sample_select, weighted_histo_key, gen_splitmix32, sleep, constants, shapes, gviz_shapes, named_colors, state_name_chars, state_name_first_chars, action_label_chars, is_hook_rejection, is_hook_complex_result, abstract_hook_step, abstract_everything_hook_step, state_style_condense, FslDirections };
+export { fsl_fence_lang, parse_fence_info } from './fsl_markdown_fence';
+export type { FencePart, FenceImageFormat, FenceDimensionUnit, FenceDimension, FenceDescriptor } from './fsl_markdown_fence';