jssm 5.162.7 → 5.162.8

package/dist/deno/jssm_compiler.d.ts

@@ -130,7 +130,7 @@ declare function makeTransition<StateType, mDT>(this_se: JssmCompileSe<StateType
  *                 tracking on every AST node.
  *
  */
-declare function wrap_parse(input: string, options?: Object): any;
+declare function wrap_parse(input: string, options?: object): any;
 /*********
  *
  *  Builds the ordered {@link JssmGroupRegistry} from every `named_list` node

package/dist/deno/jssm_constants.d.ts

@@ -52,7 +52,6 @@ declare const named_colors: string[];
  *  Includes ASCII digits/letters and the symbols
  *  `.`, `+`, `_`, `^`, `(`, `)`, `*`, `&`, `$`, `#`, `@`, `!`, `?`, `,`,
  *  plus the high-Unicode range `U+0080`–`U+FFFF`.
- *
  *  @example
  *  import { state_name_chars } from 'jssm';
  *  state_name_chars.some(r => 'A' >= r.from && 'A' <= r.to);  // => true
@@ -68,7 +67,6 @@ declare const state_name_chars: ReadonlyArray<{
  *  Notably narrower than {@link state_name_chars}: omits `+`, `(`, `)`, `&`,
  *  `#`, `@`.  Includes ASCII digits/letters, `.`, `_`, `!`, `$`, `^`, `*`,
  *  `?`, `,`, and the high-Unicode range `U+0080`–`U+FFFF`.
- *
  *  @example
  *  import { state_name_first_chars } from 'jssm';
  *  state_name_first_chars.some(r => '+' >= r.from && '+' <= r.to);  // => false
@@ -84,7 +82,6 @@ declare const state_name_first_chars: ReadonlyArray<{
  *  excluded since it terminates the label.
  *
  *  Three ranges: `U+0020`–`U+0026`, `U+0028`–`U+005B`, `U+005D`–`U+FFFF`.
- *
  *  @example
  *  import { action_label_chars } from 'jssm';
  *  action_label_chars.some(r => ' ' >= r.from && ' ' <= r.to);   // => true

package/dist/deno/jssm_intern.d.ts

@@ -6,7 +6,6 @@
  * (integer hashing) instead of repeated string-keyed lookups.  Internal
  * machinery only — deliberately not re-exported from the `jssm` public
  * surface, so the public API is unchanged.
- *
  * @internal
  */
 /**
@@ -15,7 +14,6 @@
  * no removal, matching machine semantics (states and actions are fixed
  * after construction; late interning only happens for never-matching
  * lookups such as hook registrations naming unknown states).
- *
  * @example
  *   const i = new Interner();
  *   i.intern('red');     // 0
@@ -23,7 +21,6 @@
  *   i.intern('red');     // 0  (idempotent)
  *   i.id_of('green');    // 1
  *   i.name_of(0);        // 'red'
- *
  * @see pair_key
  */
 declare class Interner {
@@ -33,10 +30,8 @@ declare class Interner {
     /**
      * Return the id for `name`, assigning the next dense id if the name has
      * not been seen before.
-     *
      * @param name - The string to intern.
      * @returns The (possibly newly assigned) integer id.
-     *
      * @example
      *   interner.intern('red');  // 0 on first call, 0 on every later call
      */
@@ -45,18 +40,14 @@ declare class Interner {
      * Return the id for `name` without interning, or `undefined` when the
      * name has never been interned.  This is the hot-path probe for
      * user-supplied names.
-     *
      * @param name - The string to look up.
-     *
      * @example
      *   interner.id_of('mauve');  // undefined — never interned
      */
     id_of(name: string): number | undefined;
     /**
      * Return the name for `id`, or `undefined` for an id never assigned.
-     *
      * @param id - The integer id to invert.
-     *
      * @example
      *   interner.name_of(0);  // 'red'
      */
@@ -78,15 +69,12 @@ declare class Interner {
  * injective over the naturals, and a negative input can collide with a real
  * stored key (e.g. szudzik(-1, 2) === szudzik(1, 1) === 3), which would make
  * lookups from an unknown state falsely succeed.
- *
  * @param a - First non-negative integer (or NaN as a deliberate miss).
  * @param b - Second non-negative integer (or NaN as a deliberate miss).
  * @returns A number unique to the ordered pair `(a, b)` over the naturals.
- *
  * @example
  *   pair_key(2, 5);  // 27
  *   pair_key(5, 2);  // 32 — order-sensitive
- *
  * @see Interner
  */
 declare function pair_key(a: number, b: number): number;
@@ -99,14 +87,11 @@ declare function pair_key(a: number, b: number): number;
  *
  * Behavior is only defined for keys `pair_key` actually emits; a NaN key (the
  * unknown-name sentinel) yields `[NaN, NaN]`, never a spurious real pair.
- *
  * @param z - A key produced by `pair_key`.
  * @returns The ordered pair `[a, b]` such that `pair_key(a, b) === z`.
- *
  * @example
  *   un_pair_key(27);  // [2, 5]
  *   un_pair_key(32);  // [5, 2] — order preserved
- *
  * @see pair_key
  */
 declare function un_pair_key(z: number): [number, number];

package/dist/deno/jssm_theme.d.ts

@@ -1,5 +1,4 @@
 import { FslTheme, JssmBaseTheme } from './jssm_types.js';
-import { base_theme } from './themes/jssm_base_stylesheet.js';
 /*******
  *
  *  Registry mapping theme names to their stylesheet definitions.  Each entry
@@ -12,4 +11,5 @@ import { base_theme } from './themes/jssm_base_stylesheet.js';
  *
  */
 declare const theme_mapping: Map<FslTheme, JssmBaseTheme>;
-export { theme_mapping, base_theme };
+export { theme_mapping, };
+export { base_theme } from './themes/jssm_base_stylesheet.js';

package/dist/deno/jssm_types.d.ts

@@ -91,7 +91,6 @@ type JssmAllowIslands = true | false | 'with_start';
  *  - `{ height }` — height-only form (`default_size: height 600;`)
  *
  *  This is a *hint*, not a hard constraint.  Renderers may ignore it.
- *
  *  @see Machine.default_size
  */
 type JssmDefaultSize = {
@@ -126,8 +125,7 @@ type FslTheme = typeof FslThemes[number];
  *  and consumed by {@link jssm!deserialize}.  Carries the current state, the
  *  associated machine data, the recent history (subject to the configured
  *  capacity), and metadata to detect version-skew on rehydration.
- *
- *  @typeParam DataType - The type of the user-supplied data payload (`mDT`).
+ *  @template DataType - The type of the user-supplied data payload (`mDT`).
  */
 type JssmSerialization<DataType> = {
     jssm_version: string;
@@ -150,7 +148,6 @@ type JssmSerialization<DataType> = {
  *  parse('&busy : [a b]; &busy -> idle;')[1].from;
  *  // { key: 'group_ref', name: 'busy' }
  *  ```
- *
  *  @see JssmGroupMemberRef
  *  @see JssmGroupRegistry
  */
@@ -173,7 +170,6 @@ type JssmGroupRef = {
  *  // [ { kind: 'group', name: 'inner', mode: 'nest' },
  *  //   { kind: 'state', name: 'x' } ]
  *  ```
- *
  *  @see JssmGroupRef
  *  @see JssmGroupRegistry
  */
@@ -200,7 +196,6 @@ type JssmGroupMemberRef = {
  *  // registry.get('outer') === [ { kind:'group', name:'inner', mode:'nest' },
  *  //                             { kind:'state', name:'c' } ]
  *  ```
- *
  *  @see JssmGroupMemberRef
  */
 type JssmGroupRegistry = Map<string, JssmGroupMemberRef[]>;
@@ -219,7 +214,6 @@ type JssmGroupRegistry = Map<string, JssmGroupMemberRef[]>;
  *  // { key:'hook_decl', event:'enter',
  *  //   subject:{ key:'group_ref', name:'busy' }, action:'log' }
  *  ```
- *
  *  @see JssmGroupRef
  *  @see JssmGroupHooks
  */
@@ -235,7 +229,6 @@ type JssmHookDeclaration = {
  *  Each is optional so a subject may declare only one direction; the compiler
  *  merges an `enter` and an `exit` declaration for the same subject into one
  *  of these.
- *
  *  @see JssmHookDeclaration
  */
 type JssmBoundaryHooks = {
@@ -246,7 +239,6 @@ type JssmBoundaryHooks = {
  *  Maps each group name that has at least one boundary hook to its merged
  *  {@link JssmBoundaryHooks}.  Carried on {@link JssmGenericConfig} for the
  *  runtime to consume; depth-aware firing is a later task.
- *
  *  @see JssmHookDeclaration
  */
 type JssmGroupHooks = Map<string, JssmBoundaryHooks>;
@@ -254,7 +246,6 @@ type JssmGroupHooks = Map<string, JssmBoundaryHooks>;
  *  Maps each plain state name that has at least one boundary hook to its
  *  merged {@link JssmBoundaryHooks}.  The state-subject analogue of
  *  {@link JssmGroupHooks}.
- *
  *  @see JssmHookDeclaration
  */
 type JssmStateHooks = Map<string, JssmBoundaryHooks>;
@@ -286,9 +277,8 @@ type JssmTransitionPermitterMaybeArray<DataType> = JssmTransitionPermitter<DataT
  *  per-edge `name`, an action label, a guard `check`, a transition
  *  `probability` for stochastic models, and an `after_time` for timed
  *  transitions.
- *
- *  @typeParam StateType - The state-name type (usually `string`).
- *  @typeParam DataType  - The machine's data payload type (`mDT`).
+ *  @template StateType - The state-name type (usually `string`).
+ *  @template DataType  - The machine's data payload type (`mDT`).
  */
 type JssmTransition<StateType, DataType> = {
     from: StateType;
@@ -505,7 +495,6 @@ type JssmGraphDefaultEdgeColor = {
  *  reuses the per-state style items (so `color: red;` works inside a
  *  `transition:` block exactly as inside a `state:` block) plus the
  *  edge-scoped {@link JssmGraphDefaultEdgeColor} default.
- *
  *  @see JssmTransitionConfig
  */
 type JssmTransitionStyleKey = JssmStateStyleKey | JssmGraphDefaultEdgeColor;
@@ -520,7 +509,6 @@ type JssmTransitionStyleKey = JssmStateStyleKey | JssmGraphDefaultEdgeColor;
  *  const cfg = compile(parse('a -> b; transition: { color: red; };'));
  *  // cfg.default_transition_config === [ { key: 'color', value: '#ff0000ff' } ]
  *  ```
- *
  *  @see JssmGraphConfig
  */
 type JssmTransitionConfig = JssmTransitionStyleKey[];
@@ -531,7 +519,7 @@ type JssmTransitionConfig = JssmTransitionStyleKey[];
  *  default) into the consolidated `graph: {}` config.  Each carries the
  *  legacy parse key so downstream consumers can disambiguate.
  */
-type JssmGraphAliasKey = {
+type JssmGraphAliasKey = JssmGraphDefaultEdgeColor | {
     key: 'graph_layout';
     value: JssmLayout;
 } | {
@@ -546,13 +534,12 @@ type JssmGraphAliasKey = {
 } | {
     key: 'flow';
     value: FslDirection;
-} | JssmGraphDefaultEdgeColor;
+};
 /**
  *  A single item inside a `graph: {}` default-config block.  For v1 this
  *  reuses the per-state style items plus the graph-scope alias items
  *  ({@link JssmGraphAliasKey}) folded in from the deprecated top-level
  *  graph keywords.
- *
  *  @see JssmGraphConfig
  */
 type JssmGraphStyleKey = JssmStateStyleKey | JssmGraphAliasKey;
@@ -569,7 +556,6 @@ type JssmGraphStyleKey = JssmStateStyleKey | JssmGraphAliasKey;
  *  // `background-color` item, so:
  *  // cfg.default_graph_config includes { key: 'background-color', value: '#ffffffff' }
  *  ```
- *
  *  @see JssmTransitionConfig
  */
 type JssmGraphConfig = JssmGraphStyleKey[];
@@ -618,9 +604,8 @@ type JssmTheme = Partial<JssmBaseTheme>;
  *
  *  Most users never construct one of these directly — the `sm` tagged
  *  template literal and {@link from} produce one from FSL source.
- *
- *  @typeParam StateType - The state-name type (usually `string`).
- *  @typeParam DataType  - The user-supplied data payload type (`mDT`).
+ *  @template StateType - The state-name type (usually `string`).
+ *  @template DataType  - The user-supplied data payload type (`mDT`).
  */
 /**
  *  Editor/panel defaults an FSL machine declares in an `editor: {}` block
@@ -680,7 +665,6 @@ type JssmGenericConfig<StateType, DataType> = {
      *
      *  Defaults to `100`.  Raise it for legitimate pipelines that genuinely nest
      *  more than 100 transitions via boundary hooks.
-     *
      *  @see Machine._boundary_depth_limit
      *  @see Machine._fire_boundary_actions
      */
@@ -700,7 +684,7 @@ type JssmGenericConfig<StateType, DataType> = {
     failed_outputs?: Array<StateType>;
     initial_state?: StateType;
     start_states_no_enforce?: boolean;
-    state_declaration?: Object[];
+    state_declaration?: object[];
     property_definition?: JssmPropertyDefinition[];
     state_property?: JssmPropertyDefinition[];
     arrange_declaration?: Array<Array<StateType>>;
@@ -762,7 +746,6 @@ type JssmGenericConfig<StateType, DataType> = {
  *  Internal compiler intermediate: a single aggregated rule produced while
  *  folding a parse tree into a machine configuration.  Not intended for
  *  end-user code.
- *
  *  @internal
  */
 type JssmCompileRule<StateType> = {
@@ -775,7 +758,6 @@ type JssmCompileRule<StateType> = {
  *  arrow with optional per-direction action labels, probabilities, and
  *  after-times.  The recursive `se` field allows the parser to chain
  *  arrows of the form `A -> B -> C`.  Not intended for end-user code.
- *
  *  @internal
  */
 type JssmCompileSe<StateType, mDT> = {
@@ -799,7 +781,6 @@ type JssmCompileSe<StateType, mDT> = {
  *  for non-transition rules (state declarations, property definitions,
  *  machine metadata) via its `key`/`value`/`name`/`state` fields.  Not
  *  intended for end-user code.
- *
  *  @internal
  */
 type JssmCompileSeStart<StateType, DataType> = {
@@ -820,7 +801,6 @@ type JssmCompileSeStart<StateType, DataType> = {
  *  The output shape of the FSL parser: a flat array of
  *  {@link JssmCompileSeStart} entries, one per top-level rule in the
  *  source.  Consumed by the compiler to build a machine configuration.
- *
  *  @internal
  */
 type JssmParseTree<StateType, mDT> = Array<JssmCompileSeStart<StateType, mDT>>;
@@ -1140,7 +1120,6 @@ type JssmRng = () => number;
  *  All event names that {@link jssm!Machine.on} accepts.  These are observation
  *  events fired by the machine in addition to (not in place of) the hook
  *  system.  Hooks intercept; events observe.
- *
  *  @see Machine.on
  */
 type JssmEventName = 'transition' | 'rejection' | 'action' | 'entry' | 'exit' | 'terminal' | 'complete' | 'error' | 'data-change' | 'override' | 'timeout' | 'hook-registration' | 'hook-removal';
@@ -1234,7 +1213,7 @@ type JssmErrorEventDetail = {
     error: unknown;
     source_event: JssmEventName;
     source_detail: unknown;
-    handler: Function;
+    handler: JssmEventHandler<unknown, JssmEventName>;
 };
 /**
  *  Detail payload fired with a `data-change` event.  Fires whenever the
@@ -1329,15 +1308,15 @@ type JssmEventFilterMap<mDT> = {
 /**
  *  Per-event filter object (as passed to {@link jssm!Machine.on}).  Use
  *  `JssmEventDetailMap<mDT>[Ev]` to find the matching detail type.
- *  @typeParam mDT The type of the machine data member.
- *  @typeParam Ev  The event name.
+ *  @template mDT The type of the machine data member.
+ *  @template Ev  The event name.
  */
 type JssmEventFilter<mDT, Ev extends JssmEventName> = JssmEventFilterMap<mDT>[Ev];
 /**
  *  Per-event handler signature.  Receives a detail object typed by event
  *  name, so `e.action` (etc.) only exist where they're meaningful.
- *  @typeParam mDT The type of the machine data member.
- *  @typeParam Ev  The event name.
+ *  @template mDT The type of the machine data member.
+ *  @template Ev  The event name.
  */
 type JssmEventHandler<mDT, Ev extends JssmEventName> = (detail: JssmEventDetailMap<mDT>[Ev]) => void;
 /**

package/dist/deno/jssm_util.d.ts

@@ -1,3 +1,4 @@
+import { JssmRng } from './jssm_types.js';
 /*******
  *
  *  Predicate for validating an array for uniqueness.  Returns `true` when
@@ -62,7 +63,7 @@ declare const array_box_if_string: (n: any) => any;
  *  @throws {TypeError} If `options` is not a non-empty array of objects.
  *
  */
-declare const weighted_rand_select: Function;
+declare const weighted_rand_select: (options: Array<any>, probability_property: string, rng: JssmRng) => any;
 /*******
  *
  *  Returns, for a non-negative integer argument `n`, the series `[0 .. n]`.
@@ -76,6 +77,19 @@ declare const weighted_rand_select: Function;
  *
  */
 declare function seq(n: number): number[];
+/*******
+ *
+ *  Comparator reproducing `Array.prototype.sort`'s default ordering (compare
+ *  as strings), so histogram key order stays byte-identical to the historic
+ *  comparator-free sort — that ordering is observable to every iterating
+ *  caller.
+ *
+ *  ```typescript
+ *  [10, 9, 1].sort(default_lexicographic);  // [1, 10, 9], as with plain .sort()
+ *  ```
+ *
+ */
+declare const default_lexicographic: (a: any, b: any) => number;
 /*******
  *
  *  Returns the histograph of an array as a `Map`.  Makes no attempt to cope
@@ -88,7 +102,7 @@ declare function seq(n: number): number[];
  *  ```
  *
  */
-declare const histograph: Function;
+declare const histograph: (ar: any[]) => Map<any, number>;
 /*******
  *
  *  Draws `n` weighted random samples from an array of objects.  Each draw is
@@ -112,7 +126,7 @@ declare const histograph: Function;
  *  @returns An array of `n` independently selected items.
  *
  */
-declare const weighted_sample_select: Function;
+declare const weighted_sample_select: (n: number, options: Array<any>, probability_property: string, rng?: JssmRng) => Array<any>;
 /*******
  *
  *  Draws `n` weighted random samples, extracts a named key from each, and
@@ -140,7 +154,7 @@ declare const weighted_sample_select: Function;
  *  @returns A `Map` from extracted key values to their occurrence counts.
  *
  */
-declare const weighted_histo_key: Function;
+declare const weighted_histo_key: (n: number, opts: Array<any>, prob_prop: string, extract: string, rng?: JssmRng) => Map<any, number>;
 /*******
  *
  *  Internal method generating composite keys for the hook lookup map by
@@ -168,7 +182,7 @@ declare function name_bind_prop_and_state(prop: string, state: string): string;
  *  Replaces the Mulberry generator, which was found to have problems
  *
  */
-declare function gen_splitmix32(a?: number | undefined): () => number;
+declare function gen_splitmix32(a?: number): () => number;
 /*******
  *
  *  Reduces an array to its unique contents.  Compares with `===` and makes no
@@ -220,4 +234,4 @@ declare function find_repeated<T>(arr: T[]): [T, number][];
  *
  */
 declare function sleep(ms: number): Promise<unknown>;
-export { seq, unique, find_repeated, arr_uniq_p, histograph, weighted_histo_key, weighted_rand_select, weighted_sample_select, array_box_if_string, name_bind_prop_and_state, gen_splitmix32, sleep };
+export { seq, unique, find_repeated, arr_uniq_p, default_lexicographic, histograph, weighted_histo_key, weighted_rand_select, weighted_sample_select, array_box_if_string, name_bind_prop_and_state, gen_splitmix32, sleep };