jssm 5.162.13 → 5.162.16

package/jssm.es5.d.cts

@@ -15,12 +15,18 @@ type JssmColor = string;
  */
 type JssmPermittedOpt = 'required' | 'disallowed' | 'optional';
 /**
- *  The set of ASCII arrow tokens recognized by the FSL grammar.  Each arrow
- *  encodes a direction (one-way left/right, or two-way) and a "kind" for
+ *  Every arrow token recognized by the FSL grammar — all 42 spellings.  Each
+ *  arrow encodes a direction (one-way left/right, or two-way) and a "kind" for
  *  each direction (`-` legal, `=` main path, `~` forced-only).  See the
  *  Language Reference docs for the full semantic table.
+ *
+ *  Every arrow has an ASCII spelling and a unicode spelling, and each half of a
+ *  two-way arrow may be spelled independently, so the two-way arrows also have
+ *  mixed ASCII/unicode spellings (`←=>`, `<-⇒`, and so on).  All of them are
+ *  accepted, by the grammar and by {@link arrow_direction},
+ *  {@link arrow_left_kind}, and {@link arrow_right_kind}.
  */
-type JssmArrow = '->' | '<-' | '<->' | '<=->' | '<~->' | '=>' | '<=' | '<=>' | '<-=>' | '<~=>' | '~>' | '<~' | '<~>' | '<-~>' | '<=~>';
+type JssmArrow = '->' | '→' | '=>' | '⇒' | '~>' | '↛' | '<-' | '←' | '<=' | '⇐' | '<~' | '↚' | '<->' | '↔' | '<=>' | '⇔' | '<~>' | '↮' | '<-=>' | '←⇒' | '←=>' | '<-⇒' | '<-~>' | '←↛' | '←~>' | '<-↛' | '<=->' | '⇐→' | '⇐->' | '<=→' | '<=~>' | '⇐↛' | '⇐~>' | '<=↛' | '<~->' | '↚→' | '↚->' | '<~→' | '<~=>' | '↚⇒' | '↚=>' | '<~⇒';
 /**
  * A type teaching Typescript the various supported shapes for nodes, mostly inherited from GraphViz
  */
@@ -651,8 +657,22 @@ type JssmGenericConfig<StateType, DataType> = {
     state_hooks?: JssmStateHooks;
     rng_seed?: number | undefined;
     time_source?: () => number;
-    timeout_source?: (Function: any, number: any) => number;
-    clear_timeout_source?: (number: any) => void;
+    /**
+     *  Schedules `fn` to run after `delay_ms`, and returns a handle that will be
+     *  handed back to `clear_timeout_source` untouched.  Defaults to `setTimeout`.
+     *
+     *  The handle is typed `number` — the browser shape.  Node's `setTimeout`
+     *  returns a `Timeout` object instead, so a Node-shaped source casts it (as
+     *  jssm's own `DEFAULT_TIMEOUT_SOURCE` does); jssm never inspects the handle,
+     *  it only stores it and gives it back.
+     *
+     *  (Before 5.162.14 these read `(Function, number) => number`, in which
+     *  `Function` and `number` were *parameter names*, not types — so both
+     *  parameters were silently `any`.)
+     */
+    timeout_source?: (fn: () => void, delay_ms: number) => number;
+    /** Cancels a timer previously scheduled by `timeout_source`.  Defaults to `clearTimeout`. */
+    clear_timeout_source?: (handle: number) => void;
 };
 /**
  *  Internal compiler intermediate: one link in a chained transition
@@ -665,7 +685,15 @@ type JssmGenericConfig<StateType, DataType> = {
 type JssmCompileSe<StateType, mDT> = {
     to: StateType;
     se?: JssmCompileSe<StateType, mDT>;
-    kind: JssmArrow;
+    /**
+     *  The arrow token as the parser emitted it.  Deliberately `string` and not
+     *  {@link JssmArrow}: this internal intermediate flows through the whole
+     *  compiler, and threading a 42-member string-literal union through that much
+     *  control-flow analysis overflows `tsc`'s stack (it type-checks standalone
+     *  but dies under `npm run make`).  The value *is* a `JssmArrow` — the two
+     *  places that care re-assert it on the way into the arrow classifiers.
+     */
+    kind: string;
     l_action?: StateType;
     r_action?: StateType;
     l_probability: number;
@@ -940,10 +968,33 @@ type HookResult<mDT> = true | false | undefined | void | HookComplexResult<mDT>;
  *  the payload that will be committed if the transition is accepted —
  *  handlers may inspect or mutate the latter via a
  *  {@link HookComplexResult} return value.
+ *
+ *  The remaining fields describe the transition the hook is firing on.  They
+ *  are optional because a handler is not obliged to care about them, but the
+ *  transition path always supplies all of them; `action` is `undefined` when
+ *  the transition was not driven by an action.
  */
 type HookContext<mDT> = {
     data: mDT;
     next_data: mDT;
+    /** The state being left. */
+    from?: string;
+    /** The state being entered. */
+    to?: string;
+    /** The action that drove the transition, or `undefined` if none did. */
+    action?: string;
+    /** Whether this transition came from `force_transition` rather than `transition`. */
+    forced?: boolean;
+    /**
+     *  Which arrow kind the traversed edge carries — `legal`, `main`, or `forced`.
+     *
+     *  Populated **only when a transition-kind hook is installed** (a standard,
+     *  main, or forced transition hook, or their post- equivalents).  With no such
+     *  hook registered there is nothing to switch on, so jssm skips resolving the
+     *  edge's kind and this is `undefined`.  Install `hook_standard_transition`
+     *  (or a sibling) if a general handler needs to read it.
+     */
+    trans_type?: JssmArrowKind;
 };
 /**
  *  Context object passed to "everything" hooks ({@link EverythingHookHandler}
@@ -1717,7 +1768,7 @@ declare function make<StateType, mDT>(plan: string): JssmGenericConfig<StateType
  *  @throws {TypeError} If `options` is not a non-empty array of objects.
  *
  */
-declare const weighted_rand_select: (options: Array<any>, probability_property: string, rng: JssmRng) => any;
+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]`.

package/jssm.es6.d.ts

@@ -15,12 +15,18 @@ type JssmColor = string;
  */
 type JssmPermittedOpt = 'required' | 'disallowed' | 'optional';
 /**
- *  The set of ASCII arrow tokens recognized by the FSL grammar.  Each arrow
- *  encodes a direction (one-way left/right, or two-way) and a "kind" for
+ *  Every arrow token recognized by the FSL grammar — all 42 spellings.  Each
+ *  arrow encodes a direction (one-way left/right, or two-way) and a "kind" for
  *  each direction (`-` legal, `=` main path, `~` forced-only).  See the
  *  Language Reference docs for the full semantic table.
+ *
+ *  Every arrow has an ASCII spelling and a unicode spelling, and each half of a
+ *  two-way arrow may be spelled independently, so the two-way arrows also have
+ *  mixed ASCII/unicode spellings (`←=>`, `<-⇒`, and so on).  All of them are
+ *  accepted, by the grammar and by {@link arrow_direction},
+ *  {@link arrow_left_kind}, and {@link arrow_right_kind}.
  */
-type JssmArrow = '->' | '<-' | '<->' | '<=->' | '<~->' | '=>' | '<=' | '<=>' | '<-=>' | '<~=>' | '~>' | '<~' | '<~>' | '<-~>' | '<=~>';
+type JssmArrow = '->' | '→' | '=>' | '⇒' | '~>' | '↛' | '<-' | '←' | '<=' | '⇐' | '<~' | '↚' | '<->' | '↔' | '<=>' | '⇔' | '<~>' | '↮' | '<-=>' | '←⇒' | '←=>' | '<-⇒' | '<-~>' | '←↛' | '←~>' | '<-↛' | '<=->' | '⇐→' | '⇐->' | '<=→' | '<=~>' | '⇐↛' | '⇐~>' | '<=↛' | '<~->' | '↚→' | '↚->' | '<~→' | '<~=>' | '↚⇒' | '↚=>' | '<~⇒';
 /**
  * A type teaching Typescript the various supported shapes for nodes, mostly inherited from GraphViz
  */
@@ -651,8 +657,22 @@ type JssmGenericConfig<StateType, DataType> = {
     state_hooks?: JssmStateHooks;
     rng_seed?: number | undefined;
     time_source?: () => number;
-    timeout_source?: (Function: any, number: any) => number;
-    clear_timeout_source?: (number: any) => void;
+    /**
+     *  Schedules `fn` to run after `delay_ms`, and returns a handle that will be
+     *  handed back to `clear_timeout_source` untouched.  Defaults to `setTimeout`.
+     *
+     *  The handle is typed `number` — the browser shape.  Node's `setTimeout`
+     *  returns a `Timeout` object instead, so a Node-shaped source casts it (as
+     *  jssm's own `DEFAULT_TIMEOUT_SOURCE` does); jssm never inspects the handle,
+     *  it only stores it and gives it back.
+     *
+     *  (Before 5.162.14 these read `(Function, number) => number`, in which
+     *  `Function` and `number` were *parameter names*, not types — so both
+     *  parameters were silently `any`.)
+     */
+    timeout_source?: (fn: () => void, delay_ms: number) => number;
+    /** Cancels a timer previously scheduled by `timeout_source`.  Defaults to `clearTimeout`. */
+    clear_timeout_source?: (handle: number) => void;
 };
 /**
  *  Internal compiler intermediate: one link in a chained transition
@@ -665,7 +685,15 @@ type JssmGenericConfig<StateType, DataType> = {
 type JssmCompileSe<StateType, mDT> = {
     to: StateType;
     se?: JssmCompileSe<StateType, mDT>;
-    kind: JssmArrow;
+    /**
+     *  The arrow token as the parser emitted it.  Deliberately `string` and not
+     *  {@link JssmArrow}: this internal intermediate flows through the whole
+     *  compiler, and threading a 42-member string-literal union through that much
+     *  control-flow analysis overflows `tsc`'s stack (it type-checks standalone
+     *  but dies under `npm run make`).  The value *is* a `JssmArrow` — the two
+     *  places that care re-assert it on the way into the arrow classifiers.
+     */
+    kind: string;
     l_action?: StateType;
     r_action?: StateType;
     l_probability: number;
@@ -940,10 +968,33 @@ type HookResult<mDT> = true | false | undefined | void | HookComplexResult<mDT>;
  *  the payload that will be committed if the transition is accepted —
  *  handlers may inspect or mutate the latter via a
  *  {@link HookComplexResult} return value.
+ *
+ *  The remaining fields describe the transition the hook is firing on.  They
+ *  are optional because a handler is not obliged to care about them, but the
+ *  transition path always supplies all of them; `action` is `undefined` when
+ *  the transition was not driven by an action.
  */
 type HookContext<mDT> = {
     data: mDT;
     next_data: mDT;
+    /** The state being left. */
+    from?: string;
+    /** The state being entered. */
+    to?: string;
+    /** The action that drove the transition, or `undefined` if none did. */
+    action?: string;
+    /** Whether this transition came from `force_transition` rather than `transition`. */
+    forced?: boolean;
+    /**
+     *  Which arrow kind the traversed edge carries — `legal`, `main`, or `forced`.
+     *
+     *  Populated **only when a transition-kind hook is installed** (a standard,
+     *  main, or forced transition hook, or their post- equivalents).  With no such
+     *  hook registered there is nothing to switch on, so jssm skips resolving the
+     *  edge's kind and this is `undefined`.  Install `hook_standard_transition`
+     *  (or a sibling) if a general handler needs to read it.
+     */
+    trans_type?: JssmArrowKind;
 };
 /**
  *  Context object passed to "everything" hooks ({@link EverythingHookHandler}
@@ -1717,7 +1768,7 @@ declare function make<StateType, mDT>(plan: string): JssmGenericConfig<StateType
  *  @throws {TypeError} If `options` is not a non-empty array of objects.
  *
  */
-declare const weighted_rand_select: (options: Array<any>, probability_property: string, rng: JssmRng) => any;
+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]`.

package/jssm.fence.d.ts

@@ -155,13 +155,6 @@ type JssmColor = string;
  *  is meaningful (for example, the `actions` config key).
  */
 type JssmPermittedOpt = 'required' | 'disallowed' | 'optional';
-/**
- *  The set of ASCII arrow tokens recognized by the FSL grammar.  Each arrow
- *  encodes a direction (one-way left/right, or two-way) and a "kind" for
- *  each direction (`-` legal, `=` main path, `~` forced-only).  See the
- *  Language Reference docs for the full semantic table.
- */
-type JssmArrow = '->' | '<-' | '<->' | '<=->' | '<~->' | '=>' | '<=' | '<=>' | '<-=>' | '<~=>' | '~>' | '<~' | '<~>' | '<-~>' | '<=~>';
 /**
  * A type teaching Typescript the various supported shapes for nodes, mostly inherited from GraphViz
  */
@@ -761,8 +754,22 @@ type JssmGenericConfig<StateType, DataType> = {
     state_hooks?: JssmStateHooks;
     rng_seed?: number | undefined;
     time_source?: () => number;
-    timeout_source?: (Function: any, number: any) => number;
-    clear_timeout_source?: (number: any) => void;
+    /**
+     *  Schedules `fn` to run after `delay_ms`, and returns a handle that will be
+     *  handed back to `clear_timeout_source` untouched.  Defaults to `setTimeout`.
+     *
+     *  The handle is typed `number` — the browser shape.  Node's `setTimeout`
+     *  returns a `Timeout` object instead, so a Node-shaped source casts it (as
+     *  jssm's own `DEFAULT_TIMEOUT_SOURCE` does); jssm never inspects the handle,
+     *  it only stores it and gives it back.
+     *
+     *  (Before 5.162.14 these read `(Function, number) => number`, in which
+     *  `Function` and `number` were *parameter names*, not types — so both
+     *  parameters were silently `any`.)
+     */
+    timeout_source?: (fn: () => void, delay_ms: number) => number;
+    /** Cancels a timer previously scheduled by `timeout_source`.  Defaults to `clearTimeout`. */
+    clear_timeout_source?: (handle: number) => void;
 };
 /**
  *  Internal compiler intermediate: one link in a chained transition
@@ -775,7 +782,15 @@ type JssmGenericConfig<StateType, DataType> = {
 type JssmCompileSe<StateType, mDT> = {
     to: StateType;
     se?: JssmCompileSe<StateType, mDT>;
-    kind: JssmArrow;
+    /**
+     *  The arrow token as the parser emitted it.  Deliberately `string` and not
+     *  {@link JssmArrow}: this internal intermediate flows through the whole
+     *  compiler, and threading a 42-member string-literal union through that much
+     *  control-flow analysis overflows `tsc`'s stack (it type-checks standalone
+     *  but dies under `npm run make`).  The value *is* a `JssmArrow` — the two
+     *  places that care re-assert it on the way into the arrow classifiers.
+     */
+    kind: string;
     l_action?: StateType;
     r_action?: StateType;
     l_probability: number;
@@ -1021,10 +1036,33 @@ type HookResult<mDT> = true | false | undefined | void | HookComplexResult<mDT>;
  *  the payload that will be committed if the transition is accepted —
  *  handlers may inspect or mutate the latter via a
  *  {@link HookComplexResult} return value.
+ *
+ *  The remaining fields describe the transition the hook is firing on.  They
+ *  are optional because a handler is not obliged to care about them, but the
+ *  transition path always supplies all of them; `action` is `undefined` when
+ *  the transition was not driven by an action.
  */
 type HookContext<mDT> = {
     data: mDT;
     next_data: mDT;
+    /** The state being left. */
+    from?: string;
+    /** The state being entered. */
+    to?: string;
+    /** The action that drove the transition, or `undefined` if none did. */
+    action?: string;
+    /** Whether this transition came from `force_transition` rather than `transition`. */
+    forced?: boolean;
+    /**
+     *  Which arrow kind the traversed edge carries — `legal`, `main`, or `forced`.
+     *
+     *  Populated **only when a transition-kind hook is installed** (a standard,
+     *  main, or forced transition hook, or their post- equivalents).  With no such
+     *  hook registered there is nothing to switch on, so jssm skips resolving the
+     *  edge's kind and this is `undefined`.  Install `hook_standard_transition`
+     *  (or a sibling) if a general handler needs to read it.
+     */
+    trans_type?: JssmArrowKind;
 };
 /**
  *  Context object passed to "everything" hooks ({@link EverythingHookHandler}

package/jssm_viz.es5.d.cts

@@ -14,13 +14,6 @@ type JssmColor = string;
  *  is meaningful (for example, the `actions` config key).
  */
 type JssmPermittedOpt = 'required' | 'disallowed' | 'optional';
-/**
- *  The set of ASCII arrow tokens recognized by the FSL grammar.  Each arrow
- *  encodes a direction (one-way left/right, or two-way) and a "kind" for
- *  each direction (`-` legal, `=` main path, `~` forced-only).  See the
- *  Language Reference docs for the full semantic table.
- */
-type JssmArrow = '->' | '<-' | '<->' | '<=->' | '<~->' | '=>' | '<=' | '<=>' | '<-=>' | '<~=>' | '~>' | '<~' | '<~>' | '<-~>' | '<=~>';
 /**
  * A type teaching Typescript the various supported shapes for nodes, mostly inherited from GraphViz
  */
@@ -620,8 +613,22 @@ type JssmGenericConfig<StateType, DataType> = {
     state_hooks?: JssmStateHooks;
     rng_seed?: number | undefined;
     time_source?: () => number;
-    timeout_source?: (Function: any, number: any) => number;
-    clear_timeout_source?: (number: any) => void;
+    /**
+     *  Schedules `fn` to run after `delay_ms`, and returns a handle that will be
+     *  handed back to `clear_timeout_source` untouched.  Defaults to `setTimeout`.
+     *
+     *  The handle is typed `number` — the browser shape.  Node's `setTimeout`
+     *  returns a `Timeout` object instead, so a Node-shaped source casts it (as
+     *  jssm's own `DEFAULT_TIMEOUT_SOURCE` does); jssm never inspects the handle,
+     *  it only stores it and gives it back.
+     *
+     *  (Before 5.162.14 these read `(Function, number) => number`, in which
+     *  `Function` and `number` were *parameter names*, not types — so both
+     *  parameters were silently `any`.)
+     */
+    timeout_source?: (fn: () => void, delay_ms: number) => number;
+    /** Cancels a timer previously scheduled by `timeout_source`.  Defaults to `clearTimeout`. */
+    clear_timeout_source?: (handle: number) => void;
 };
 /**
  *  Internal compiler intermediate: one link in a chained transition
@@ -634,7 +641,15 @@ type JssmGenericConfig<StateType, DataType> = {
 type JssmCompileSe<StateType, mDT> = {
     to: StateType;
     se?: JssmCompileSe<StateType, mDT>;
-    kind: JssmArrow;
+    /**
+     *  The arrow token as the parser emitted it.  Deliberately `string` and not
+     *  {@link JssmArrow}: this internal intermediate flows through the whole
+     *  compiler, and threading a 42-member string-literal union through that much
+     *  control-flow analysis overflows `tsc`'s stack (it type-checks standalone
+     *  but dies under `npm run make`).  The value *is* a `JssmArrow` — the two
+     *  places that care re-assert it on the way into the arrow classifiers.
+     */
+    kind: string;
     l_action?: StateType;
     r_action?: StateType;
     l_probability: number;
@@ -880,10 +895,33 @@ type HookResult<mDT> = true | false | undefined | void | HookComplexResult<mDT>;
  *  the payload that will be committed if the transition is accepted —
  *  handlers may inspect or mutate the latter via a
  *  {@link HookComplexResult} return value.
+ *
+ *  The remaining fields describe the transition the hook is firing on.  They
+ *  are optional because a handler is not obliged to care about them, but the
+ *  transition path always supplies all of them; `action` is `undefined` when
+ *  the transition was not driven by an action.
  */
 type HookContext<mDT> = {
     data: mDT;
     next_data: mDT;
+    /** The state being left. */
+    from?: string;
+    /** The state being entered. */
+    to?: string;
+    /** The action that drove the transition, or `undefined` if none did. */
+    action?: string;
+    /** Whether this transition came from `force_transition` rather than `transition`. */
+    forced?: boolean;
+    /**
+     *  Which arrow kind the traversed edge carries — `legal`, `main`, or `forced`.
+     *
+     *  Populated **only when a transition-kind hook is installed** (a standard,
+     *  main, or forced transition hook, or their post- equivalents).  With no such
+     *  hook registered there is nothing to switch on, so jssm skips resolving the
+     *  edge's kind and this is `undefined`.  Install `hook_standard_transition`
+     *  (or a sibling) if a general handler needs to read it.
+     */
+    trans_type?: JssmArrowKind;
 };
 /**
  *  Context object passed to "everything" hooks ({@link EverythingHookHandler}

package/jssm_viz.es6.d.ts

@@ -14,13 +14,6 @@ type JssmColor = string;
  *  is meaningful (for example, the `actions` config key).
  */
 type JssmPermittedOpt = 'required' | 'disallowed' | 'optional';
-/**
- *  The set of ASCII arrow tokens recognized by the FSL grammar.  Each arrow
- *  encodes a direction (one-way left/right, or two-way) and a "kind" for
- *  each direction (`-` legal, `=` main path, `~` forced-only).  See the
- *  Language Reference docs for the full semantic table.
- */
-type JssmArrow = '->' | '<-' | '<->' | '<=->' | '<~->' | '=>' | '<=' | '<=>' | '<-=>' | '<~=>' | '~>' | '<~' | '<~>' | '<-~>' | '<=~>';
 /**
  * A type teaching Typescript the various supported shapes for nodes, mostly inherited from GraphViz
  */
@@ -620,8 +613,22 @@ type JssmGenericConfig<StateType, DataType> = {
     state_hooks?: JssmStateHooks;
     rng_seed?: number | undefined;
     time_source?: () => number;
-    timeout_source?: (Function: any, number: any) => number;
-    clear_timeout_source?: (number: any) => void;
+    /**
+     *  Schedules `fn` to run after `delay_ms`, and returns a handle that will be
+     *  handed back to `clear_timeout_source` untouched.  Defaults to `setTimeout`.
+     *
+     *  The handle is typed `number` — the browser shape.  Node's `setTimeout`
+     *  returns a `Timeout` object instead, so a Node-shaped source casts it (as
+     *  jssm's own `DEFAULT_TIMEOUT_SOURCE` does); jssm never inspects the handle,
+     *  it only stores it and gives it back.
+     *
+     *  (Before 5.162.14 these read `(Function, number) => number`, in which
+     *  `Function` and `number` were *parameter names*, not types — so both
+     *  parameters were silently `any`.)
+     */
+    timeout_source?: (fn: () => void, delay_ms: number) => number;
+    /** Cancels a timer previously scheduled by `timeout_source`.  Defaults to `clearTimeout`. */
+    clear_timeout_source?: (handle: number) => void;
 };
 /**
  *  Internal compiler intermediate: one link in a chained transition
@@ -634,7 +641,15 @@ type JssmGenericConfig<StateType, DataType> = {
 type JssmCompileSe<StateType, mDT> = {
     to: StateType;
     se?: JssmCompileSe<StateType, mDT>;
-    kind: JssmArrow;
+    /**
+     *  The arrow token as the parser emitted it.  Deliberately `string` and not
+     *  {@link JssmArrow}: this internal intermediate flows through the whole
+     *  compiler, and threading a 42-member string-literal union through that much
+     *  control-flow analysis overflows `tsc`'s stack (it type-checks standalone
+     *  but dies under `npm run make`).  The value *is* a `JssmArrow` — the two
+     *  places that care re-assert it on the way into the arrow classifiers.
+     */
+    kind: string;
     l_action?: StateType;
     r_action?: StateType;
     l_probability: number;
@@ -880,10 +895,33 @@ type HookResult<mDT> = true | false | undefined | void | HookComplexResult<mDT>;
  *  the payload that will be committed if the transition is accepted —
  *  handlers may inspect or mutate the latter via a
  *  {@link HookComplexResult} return value.
+ *
+ *  The remaining fields describe the transition the hook is firing on.  They
+ *  are optional because a handler is not obliged to care about them, but the
+ *  transition path always supplies all of them; `action` is `undefined` when
+ *  the transition was not driven by an action.
  */
 type HookContext<mDT> = {
     data: mDT;
     next_data: mDT;
+    /** The state being left. */
+    from?: string;
+    /** The state being entered. */
+    to?: string;
+    /** The action that drove the transition, or `undefined` if none did. */
+    action?: string;
+    /** Whether this transition came from `force_transition` rather than `transition`. */
+    forced?: boolean;
+    /**
+     *  Which arrow kind the traversed edge carries — `legal`, `main`, or `forced`.
+     *
+     *  Populated **only when a transition-kind hook is installed** (a standard,
+     *  main, or forced transition hook, or their post- equivalents).  With no such
+     *  hook registered there is nothing to switch on, so jssm skips resolving the
+     *  edge's kind and this is `undefined`.  Install `hook_standard_transition`
+     *  (or a sibling) if a general handler needs to read it.
+     */
+    trans_type?: JssmArrowKind;
 };
 /**
  *  Context object passed to "everything" hooks ({@link EverythingHookHandler}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jssm",
-  "version": "5.162.13",
+  "version": "5.162.16",
   "engines": {
     "node": ">=10.0.0"
   },
@@ -191,8 +191,9 @@
     "test": "npm run make && npm run vitest",
     "make_cli": "rollup -c rollup.config.cli.js",
     "typecheck_cli": "tsc --noEmit -p tsconfig.cli.json",
-    "min_cli": "terser dist/cli/fsl.cjs -o dist/cli/fsl.cjs --comments=/^#!/ && terser dist/cli/fsl-render.cjs -o dist/cli/fsl-render.cjs --comments=/^#!/ && terser dist/cli/lib.cjs -o dist/cli/lib.cjs && terser dist/cli/lib.mjs -o dist/cli/lib.mjs",
-    "clean": "rm -rf dist && rm -rf docs && cd coverage && rm -rf cloc && cd .. && rm -f src/ts/fsl_parser.ts && rm -f src/ts/version.ts && rm -f src/ts/tests/generated/*.docex.ts && rm -f *.d.ts && mkdir dist && cd dist && mkdir wc && mkdir cdn && cd .. && mkdir docs && cd coverage && mkdir cloc && cd .. && rm -f ./src/tools/jssm.es5.iife.nonmin.js",
+    "typecheck_tests": "tsc --noEmit -p tsconfig.test.json",
+    "min_cli": "terser dist/cli/fsl.cjs -o dist/cli/fsl.cjs --comments=/^#!/ && terser dist/cli/fsl-render.cjs -o dist/cli/fsl-render.cjs --comments=/^#!/ && terser dist/cli/fsl-export-system-prompt.cjs -o dist/cli/fsl-export-system-prompt.cjs --comments=/^#!/ && terser dist/cli/lib.cjs -o dist/cli/lib.cjs && terser dist/cli/lib.mjs -o dist/cli/lib.mjs",
+    "clean": "rm -rf dist && rm -rf docs && rm -f tsconfig.tsbuildinfo && cd coverage && rm -rf cloc && cd .. && rm -f src/ts/fsl_parser.ts && rm -f src/ts/version.ts && rm -f src/ts/tests/generated/*.docex.ts && rm -f *.d.ts && mkdir dist && cd dist && mkdir wc && mkdir cdn && cd .. && mkdir docs && cd coverage && mkdir cloc && cd .. && rm -f ./src/tools/jssm.es5.iife.nonmin.js",
     "peg": "rm -f src/ts/fsl_parser.js && pegjs src/ts/fsl_parser.peg && node src/buildjs/fixparser.cjs",
     "build:cem": "custom-elements-manifest analyze --config custom-elements-manifest.config.mjs",
     "make_core": "rollup -c rollup.config.core.js",