jssm 5.162.7 → 5.162.8

package/dist/deno/jssm_viz.d.ts

@@ -1,5 +1,4 @@
 import * as jssm from './jssm.js';
-import { version, build_time } from './version.js';
 import type { JssmGroupMemberRef, JssmTransitionConfig, JssmGraphConfig } from './jssm_types.js';
 /**
  *  How {@link machine_to_dot} renders FSL state groups (`&group : [ … ];`).
@@ -31,11 +30,9 @@ type RenderGroups = 'cluster' | 'chips' | 'off';
  *  configure({ DOMParser: new JSDOM().window.DOMParser });
  *  const el = await fsl_to_svg_element('a -> b;');
  *  ```
- *
  *  @param opts Configuration overrides.
  *  @param opts.DOMParser Constructor compatible with the WHATWG `DOMParser`
  *  interface.  Used as a fallback when `globalThis.DOMParser` is undefined.
- *
  *  @throws {JssmError} if `DOMParser` is provided and is not a constructor.
  */
 declare function configure(opts: {
@@ -44,7 +41,6 @@ declare function configure(opts: {
 /**
  *  Look up a color from the default viz palette by key, returning empty
  *  string if the key is unknown (so it disappears in feature concatenation).
- *
  *  @internal
  */
 declare function vc(col: string): string;
@@ -58,10 +54,8 @@ declare function vc(col: string): string;
  *  doublequote('a"b');  // 'a\\"b'
  *  doublequote('safe'); // 'safe'
  *  ```
- *
  *  @param txt Any string that will be placed inside `"…"` in a DOT attribute.
  *  @returns The string with every `"` replaced by `\"`.
- *
  *  @internal
  */
 declare function doublequote(txt: string): string;
@@ -76,10 +70,8 @@ declare function doublequote(txt: string): string;
  *  undoublequote('a\\"b');  // 'a"b'
  *  undoublequote('safe');   // 'safe'
  *  ```
- *
  *  @param txt A DOT-escaped attribute string (as produced by `doublequote`).
  *  @returns The string with every `\"` collapsed back to `"`.
- *
  *  @internal
  */
 declare function undoublequote(txt: string): string;
@@ -102,11 +94,9 @@ declare function undoublequote(txt: string): string;
  *  slug_for('!!!');          // ''
  *  slug_for('  Foo  Bar  '); // 'foo-bar'
  *  ```
- *
  *  @param state The state name to slugify.
  *  @returns The lowercase hyphen-separated slug, or empty string if none of
  *  the characters were retainable.
- *
  *  @internal
  */
 declare function slug_for(state: string): string;
@@ -135,10 +125,8 @@ declare function slug_for(state: string): string;
  *  slug_states(['!!!', '???']);
  *  // Map { '!!!' => 'node-1', '???' => 'node-2' }
  *  ```
- *
  *  @param states States in declaration order.
  *  @returns A `Map` from each state name to its unique slug.
- *
  *  @internal
  */
 declare function slug_states(states: string[]): Map<string, string>;
@@ -159,7 +147,6 @@ declare function slug_states(states: string[]): Map<string, string>;
  *  node_of('Red Light', new Map([['Red Light', 'red-light']]));
  *  // '"red-light"'
  *  ```
- *
  *  @internal
  */
 declare function node_of(state: string, state_index: string[] | Map<string, number> | Map<string, string>): string;
@@ -169,13 +156,11 @@ declare function node_of(state: string, state_index: string[] | Map<string, numb
  *  a 9-character `#`-prefixed string.
  *
  *  Graphviz dot does not support alpha; this is a lossy projection.
- *
  *  @internal
  */
 declare function color8to6(color8: string): string;
 /**
  *  Variant of {@link color8to6} that passes `undefined` through.
- *
  *  @internal
  */
 declare function u_color8to6(color8?: string): string | undefined;
@@ -184,7 +169,6 @@ declare function u_color8to6(color8?: string): string | undefined;
  *  so theme-supplied shapes are honoured along with per-state declarations.
  *  Returns `undefined` if neither a theme nor a state declaration supplies a
  *  shape.
- *
  *  @internal
  */
 declare function shape_for_state<T>(u_jssm: jssm.Machine<T>, state: string): string | undefined;
@@ -193,7 +177,6 @@ declare function shape_for_state<T>(u_jssm: jssm.Machine<T>, state: string): str
  *  so theme-supplied images are honoured along with per-state declarations.
  *  Returns `undefined` if neither a theme nor a state declaration supplies an
  *  image.
- *
  *  @internal
  */
 declare function image_for_state<T>(u_jssm: jssm.Machine<T>, state: string): string | undefined;
@@ -202,13 +185,12 @@ declare function image_for_state<T>(u_jssm: jssm.Machine<T>, state: string): str
  *  style via {@link jssm.Machine.style_for}, then delegating to
  *  {@link compose_style_string}.  Theme-supplied `corners` and `lineStyle`
  *  are honoured along with per-state declarations.
- *
  *  @internal
  */
 declare function style_for_state<T>(u_jssm: jssm.Machine<T>, state: string): string;
 /**
  *  Map a single `transition: {}` config item (`{ key, value }`) to a Graphviz
- *  *edge*-scope attribute `name="value"` pair, or `undefined` when the key has
+ *  edge*-scope attribute `name="value"` pair, or `undefined` when the key has
  *  no edge-meaningful projection.  Mirrors the per-node mapping in
  *  {@link state_node_line}, but targets the attribute names Graphviz uses on
  *  edges:
@@ -221,7 +203,6 @@ declare function style_for_state<T>(u_jssm: jssm.Machine<T>, state: string): str
  *  Node-only keys (`background-color`, `shape`, `corners`, `image`, `url`,
  *  `state-label`, `border-color`) have no edge meaning and yield `undefined`,
  *  so they are dropped from the `edge [ … ]` default statement.
- *
  *  @internal
  */
 declare function edge_attr_for(key: string, value: string): string | undefined;
@@ -238,13 +219,12 @@ declare function edge_attr_for(key: string, value: string): string | undefined;
  *  edge_defaults_body([{ key: 'color', value: '#0000ffff' }]);
  *  // 'color="#0000ffff"'
  *  ```
- *
  *  @internal
  */
 declare function edge_defaults_body(config: JssmTransitionConfig | undefined): string;
 /**
  *  Map a single `graph: {}` config item (`{ key, value }`) to a Graphviz
- *  *graph*-scope attribute `name="value"` pair, or `undefined` when the key is
+ *  graph*-scope attribute `name="value"` pair, or `undefined` when the key is
  *  either not graph-meaningful or already handled by another machine path
  *  (`graph_layout` → SVG engine, `flow` → `rankdir`, `theme` → style cascade,
  *  `dot_preamble` → preamble).  `background-color` is handled separately — it
@@ -253,7 +233,6 @@ declare function edge_defaults_body(config: JssmTransitionConfig | undefined): s
  *
  *  - `color`      → graph `color` (cluster/graph border).
  *  - `text-color` → graph `fontcolor`.
- *
  *  @internal
  */
 declare function graph_attr_for(key: string, value: string): string | undefined;
@@ -268,7 +247,6 @@ declare function graph_attr_for(key: string, value: string): string | undefined;
  *  This is the single reconciliation point for the graph background: the value
  *  it returns flows into {@link dot_template}'s one `bgcolor="…"` slot, so the
  *  `graph: {}` value wins over the legacy alias and is never emitted twice.
- *
  *  @internal
  */
 declare function graph_bg_color_from_config(config: JssmGraphConfig | undefined, fallback: string): string;
@@ -278,7 +256,6 @@ declare function graph_bg_color_from_config(config: JssmGraphConfig | undefined,
  *  one Graphviz graph attribute statement per key (e.g. `color="…";`).  Returns
  *  the empty string when nothing applies, so machines without graph-scope color
  *  attributes are byte-identical to before.
- *
  *  @internal
  */
 declare function graph_attrs_body(config: JssmGraphConfig | undefined): string;
@@ -301,7 +278,6 @@ declare function graph_attrs_body(config: JssmGraphConfig | undefined): string;
  *  or only terminal — a long-standing bug.  The fix is to check the two
  *  underlying predicates directly so the three named buckets reflect
  *  three meaningfully distinct conditions.
- *
  *  @internal
  */
 type StateKind = 'final' | 'complete' | 'terminal' | 'base';
@@ -320,12 +296,10 @@ type StateKind = 'final' | 'complete' | 'terminal' | 'base';
  *  cluster_id_for('Active Players', 0);  // 'cluster_active_players_0'
  *  cluster_id_for('!!!', 3);             // 'cluster_g3'
  *  ```
- *
  *  @param group The FSL group name.
  *  @param index The group's stable declaration-order index (0-based); included
  *  in the emitted id to prevent slug collisions.
  *  @returns A valid Graphviz subgraph identifier starting with `cluster_`.
- *
  *  @internal
  */
 declare function cluster_id_for(group: string, index: number): string;
@@ -340,7 +314,6 @@ declare function cluster_id_for(group: string, index: number): string;
  *  label_with_chips('Foo', []);              // 'Foo'
  *  label_with_chips('Foo', ['a', 'b']);      // 'Foo [a] [b]'
  *  ```
- *
  *  @internal
  */
 declare function label_with_chips(label: string, chips: string[]): string;
@@ -357,7 +330,6 @@ declare function label_with_chips(label: string, chips: string[]): string;
  *  // for `&inner:[a]; &outer:[&inner b];`
  *  // group_parent_map(reg, ['inner','outer']) === Map { 'inner' => 'outer' }
  *  ```
- *
  *  @internal
  */
 declare function group_parent_map(registry: Map<string, JssmGroupMemberRef[]>, order: string[]): Map<string, string>;
@@ -366,7 +338,6 @@ declare function group_parent_map(registry: Map<string, JssmGroupMemberRef[]>, o
  *  ancestor set *including the group itself*.  Used both to nest clusters and
  *  to decide which of a state's memberships its primary cluster already
  *  represents (so the rest become chips).
- *
  *  @internal
  */
 declare function group_ancestry(group: string, parents: Map<string, string>): Set<string>;
@@ -376,7 +347,6 @@ declare function group_ancestry(group: string, parents: Map<string, string>): Se
  *  declaration order — the same precedence the config cascade uses, so a
  *  state's cluster placement agrees with the group whose style won.  Returns
  *  `undefined` for a state in no group.
- *
  *  @internal
  */
 declare function primary_group_for<T>(u_jssm: jssm.Machine<T>, state: string, order: string[]): string | undefined;
@@ -386,11 +356,9 @@ declare function primary_group_for<T>(u_jssm: jssm.Machine<T>, state: string, or
  *  ungrouped state) plus the *chip* groups — memberships the primary cluster's
  *  ancestry does not already represent, i.e. genuine overlap that nesting
  *  cannot show.
- *
  *  @returns `{ placement, chips }` where `placement` maps state → primary
  *  group, and `chips` maps state → the overflow group names (declaration
  *  order).
- *
  *  @internal
  */
 declare function plan_cluster_groups<T>(u_jssm: jssm.Machine<T>, l_states: string[], order: string[], parents: Map<string, string>): {
@@ -413,10 +381,8 @@ declare function plan_cluster_groups<T>(u_jssm: jssm.Machine<T>, l_states: strin
  *  // for `&inner:[a]; &outer:[&inner b]; a -> b;` the result contains
  *  //   subgraph cluster_outer { label="outer"; … subgraph cluster_inner { … } }
  *  ```
- *
  *  @returns `{ clusters, ungrouped_nodes }` — the cluster DOT block and the
  *  node statements for states in no group.
- *
  *  @internal
  */
 declare function groups_to_subgraph_string<T>(u_jssm: jssm.Machine<T>, l_states: string[], state_index: Map<string, string>, state_kinds: Map<string, StateKind>, hide_state_labels: boolean): {
@@ -433,7 +399,6 @@ declare function groups_to_subgraph_string<T>(u_jssm: jssm.Machine<T>, l_states:
  *  // for `&inner:[a]; &outer:[&inner b]; a -> b;`
  *  // chips_for_all_groups(m, ['a','b']) === Map { 'a' => ['inner','outer'], 'b' => ['outer'] }
  *  ```
- *
  *  @internal
  */
 declare function chips_for_all_groups<T>(u_jssm: jssm.Machine<T>, l_states: string[]): Map<string, string[]>;
@@ -473,7 +438,6 @@ type VizRenderOpts = {
  *
  *  A machine that declares no groups produces the same flat node list in every
  *  mode, so `'cluster'`/`'chips'` are no-ops there.
- *
  *  @internal
  */
 declare function node_block_for<T>(u_jssm: jssm.Machine<T>, l_states: string[], state_index: Map<string, string>, state_kinds: Map<string, StateKind>, hide_labels: boolean, mode: RenderGroups): string;
@@ -484,7 +448,6 @@ declare function node_block_for<T>(u_jssm: jssm.Machine<T>, l_states: string[],
  *  {@link plan_cluster_groups} (with identical inputs) for `'cluster'` — so a
  *  reconstructed label can never disagree with the one graphviz was handed.
  *  `'off'`, and any machine that declares no groups, yields an empty map.
- *
  *  @internal
  */
 declare function chips_for_render_mode<T>(u_jssm: jssm.Machine<T>, l_states: string[], mode: RenderGroups): Map<string, string[]>;
@@ -503,7 +466,6 @@ declare function chips_for_render_mode<T>(u_jssm: jssm.Machine<T>, l_states: str
  *  alike.  It is built by running the node builder's own
  *  `label_with_chips(doublequote(display_text), chips)` and inverting the one
  *  escaping step, so it follows any change to the label format for free.
- *
  *  @param u_jssm The machine being rendered.
  *  @param opts Render flags; only `render_groups` affects the label text
  *  (default `'cluster'`, matching `fsl_to_svg_string`).
@@ -517,7 +479,6 @@ declare function chips_for_render_mode<T>(u_jssm: jssm.Machine<T>, l_states: str
  *  state_svg_label_texts(sm`&g1 : [a b]; &g2 : [a]; a -> b;`).get('a');  // 'a [g1]'
  *  state_svg_label_texts(sm`a -> b;`).get('a');                          // 'a'
  *  ```
- *
  *  @see extract_state_fills
  */
 declare function state_svg_label_texts<T>(u_jssm: jssm.Machine<T>, opts?: VizRenderOpts): Map<string, string>;
@@ -549,7 +510,6 @@ declare function state_svg_label_texts<T>(u_jssm: jssm.Machine<T>, opts?: VizRen
  *  // or as label chips, with no cluster boxes
  *  const chipped = machine_to_dot(sm`&g : [a b]; a -> b;`, { render_groups: 'chips' });
  *  ```
- *
  *  @param u_jssm The machine to render.
  *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A complete graphviz dot source string.
@@ -568,7 +528,6 @@ declare function machine_to_dot<T>(u_jssm: jssm.Machine<T>, opts?: VizRenderOpts
  *  const dot_with_footer = fsl_to_dot('a -> b;', { footer: 'label="caption";' });
  *  // 'digraph G { ... label="caption"; }'
  *  ```
- *
  *  @param fsl The FSL source.
  *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A complete graphviz dot source string.
@@ -583,7 +542,6 @@ declare function fsl_to_dot(fsl: string, opts?: VizRenderOpts): string;
  *  const svg = await dot_to_svg('digraph G { a -> b }');
  *  const svg_neato = await dot_to_svg('digraph G { a -> b }', { engine: 'neato' });
  *  ```
- *
  *  @param dot Graphviz dot source.
  *  @param options Optional renderer overrides.
  *  @param options.engine Graphviz layout engine to use (e.g. `'dot'`,
@@ -601,7 +559,6 @@ declare function dot_to_svg(dot: string, options?: {
  *  const svg = await fsl_to_svg_string('a -> b;');
  *  const svg_neato = await fsl_to_svg_string('a -> b;', { engine: 'neato' });
  *  ```
- *
  *  @param fsl The FSL source.
  *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A promise resolving to an SVG XML string.
@@ -609,7 +566,6 @@ declare function dot_to_svg(dot: string, options?: {
 declare function fsl_to_svg_string(fsl: string, opts?: VizRenderOpts): Promise<string>;
 /**
  *  Render a {@link jssm.Machine} to SVG.
- *
  *  @param u_jssm The machine to render.
  *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A promise resolving to an SVG XML string.
@@ -617,7 +573,6 @@ declare function fsl_to_svg_string(fsl: string, opts?: VizRenderOpts): Promise<s
 declare function machine_to_svg_string<T>(u_jssm: jssm.Machine<T>, opts?: VizRenderOpts): Promise<string>;
 /**
  *  Render an FSL string directly to a parsed `SVGSVGElement`.
- *
  *  @param fsl The FSL source.
  *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A promise resolving to a parsed `SVGSVGElement`.
@@ -626,7 +581,6 @@ declare function machine_to_svg_string<T>(u_jssm: jssm.Machine<T>, opts?: VizRen
 declare function fsl_to_svg_element(fsl: string, opts?: VizRenderOpts): Promise<SVGSVGElement>;
 /**
  *  Render a {@link jssm.Machine} to a parsed `SVGSVGElement`.
- *
  *  @param u_jssm The machine to render.
  *  @param opts Optional render flags.  See {@link VizRenderOpts}.
  *  @returns A promise resolving to a parsed `SVGSVGElement`.
@@ -636,13 +590,12 @@ declare function machine_to_svg_element<T>(u_jssm: jssm.Machine<T>, opts?: VizRe
 /**
  *  Compatibility wrapper for {@link machine_to_dot}, retained from
  *  jssm-viz.  Will be removed in the next major.
- *
  *  @deprecated Use {@link machine_to_dot} instead.
  */
 declare function dot<T>(machine: jssm.Machine<T>): string;
-export { configure, dot, dot_to_svg, fsl_to_dot, fsl_to_svg_string, fsl_to_svg_element, machine_to_dot, machine_to_svg_string, machine_to_svg_element, state_svg_label_texts, version, build_time };
+export { configure, dot, dot_to_svg, fsl_to_dot, fsl_to_svg_string, fsl_to_svg_element, machine_to_dot, machine_to_svg_string, machine_to_svg_element, state_svg_label_texts, };
 export type { VizRenderOpts, RenderGroups };
-/** @internal — test-only access to private helpers. */
+/** @internal */
 export declare const _test: {
     doublequote: typeof doublequote;
     color8to6: typeof color8to6;
@@ -671,3 +624,4 @@ export declare const _test: {
     graph_attrs_body: typeof graph_attrs_body;
     graph_bg_color_from_config: typeof graph_bg_color_from_config;
 };
+export { version, build_time } from './version.js';

package/dist/es6/cm6/fsl_language.d.ts

@@ -68,9 +68,7 @@ export declare const fslLanguage: StreamLanguage<FslStreamState>;
 export declare const fslHighlightStyle: HighlightStyle;
 /**
  * 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';