jssm 5.98.8 → 5.99.0

package/dist/jssm.es6.nonmin.cjs

@@ -18962,6 +18962,9 @@ function find_repeated(arr) {
         return [];
     }
 }
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
 
 var reductions = {
   "abkhazian" : "ab",
@@ -20663,7 +20666,7 @@ var constants = /*#__PURE__*/Object.freeze({
     named_colors: named_colors$1
 });
 
-const version = "5.98.7", build_time = 1720294433127;
+const version = "5.99.0", build_time = 1720314479976;
 
 // whargarbl lots of these return arrays could/should be sets
 const { shapes, gviz_shapes, named_colors } = constants;
@@ -20818,6 +20821,7 @@ class Machine {
         this._has_named_hooks = false;
         this._has_entry_hooks = false;
         this._has_exit_hooks = false;
+        this._has_after_hooks = false;
         this._has_global_action_hooks = false;
         this._has_transition_hooks = true;
         // no need for a boolean for single hooks, just test for undefinedness
@@ -20826,6 +20830,7 @@ class Machine {
         this._named_hooks = new Map();
         this._entry_hooks = new Map();
         this._exit_hooks = new Map();
+        this._after_hooks = new Map();
         this._global_action_hooks = new Map();
         this._any_action_hook = undefined;
         this._standard_transition_hook = undefined;
@@ -21981,6 +21986,11 @@ class Machine {
                 this._has_hooks = true;
                 this._has_exit_hooks = true;
                 break;
+            case 'after':
+                this._after_hooks.set(HookDesc.from, HookDesc.handler);
+                this._has_hooks = true;
+                this._has_after_hooks = true;
+                break;
             case 'post hook':
                 this._post_hooks.set(hook_name(HookDesc.from, HookDesc.to), HookDesc.handler);
                 this._has_post_hooks = true;
@@ -22073,6 +22083,10 @@ class Machine {
         this.set_hook({ kind: 'exit', from, handler });
         return this;
     }
+    hook_after(from, handler) {
+        this.set_hook({ kind: 'after', from, handler });
+        return this;
+    }
     post_hook(from, to, handler) {
         this.set_hook({ kind: 'post hook', from, to, handler });
         return this;
@@ -22214,19 +22228,33 @@ class Machine {
                 }
                 let data_changed = false;
                 if (wasAction) {
-                    // 1. any action hook
+                    // 1a. any action hook
                     const outcome = abstract_hook_step(this._any_action_hook, hook_args);
                     if (outcome.pass === false) {
                         return false;
                     }
                     update_fields(outcome);
-                    // 2. global specific action hook
+                    // 1b. global specific action hook
                     const outcome2 = abstract_hook_step(this._global_action_hooks.get(newStateOrAction), hook_args);
                     if (outcome2.pass === false) {
                         return false;
                     }
                     update_fields(outcome2);
                 }
+                // 2. after hook
+                if (this._has_after_hooks) {
+                    const ah = this._after_hooks.get(newStateOrAction);
+                    const outcome = abstract_hook_step(ah, hook_args);
+                    // there's no such thing as after not passing, so, omit the result pass check
+                    /* istanbul can't trace this through the timer */
+                    /* istanbul ignore next */
+                    if (ah !== undefined) {
+                        /* istanbul can't trace this through the timer */
+                        /* istanbul ignore next */
+                        ah({ data: outcome.data, next_data: outcome.next_data });
+                    }
+                    update_fields(outcome);
+                }
                 // 3. any transition hook
                 if (this._any_transition_hook !== undefined) {
                     const outcome = abstract_hook_step(this._any_transition_hook, hook_args);
@@ -22956,6 +22984,12 @@ class Machine {
         /* istanbul ignore next */
         () => {
             this.clear_state_timeout();
+            if (this._has_after_hooks) {
+                const ah = this._after_hooks.get(this.state());
+                if (ah !== undefined) {
+                    ah({ data: this._data, next_data: this._data });
+                }
+            }
             this.go(next_state);
         }, after_time);
         this._timeout_target = next_state;
@@ -23107,4 +23141,4 @@ function deserialize(machine_string, ser) {
     return machine;
 }
 
-export { FslDirections, Machine, abstract_hook_step, arrow_direction, arrow_left_kind, arrow_right_kind, build_time, compile, constants, deserialize, find_repeated, from, gviz_shapes, histograph, is_hook_complex_result, is_hook_rejection, make, named_colors, wrap_parse as parse, seq, shapes, sm, state_style_condense, transfer_state_properties, unique, version, weighted_histo_key, weighted_rand_select, weighted_sample_select };
+export { FslDirections, Machine, abstract_hook_step, arrow_direction, arrow_left_kind, arrow_right_kind, build_time, compile, constants, deserialize, find_repeated, from, gviz_shapes, histograph, is_hook_complex_result, is_hook_rejection, make, named_colors, wrap_parse as parse, seq, shapes, sleep, sm, state_style_condense, transfer_state_properties, unique, version, weighted_histo_key, weighted_rand_select, weighted_sample_select };

package/jssm.d.ts

@@ -3,7 +3,7 @@ import { JssmGenericState, JssmGenericConfig, JssmStateConfig, JssmTransition, J
 JssmMachineInternalState, JssmAllowsOverride, JssmStateDeclaration, JssmStateStyleKeyList, JssmLayout, JssmHistory, JssmSerialization, FslDirection, FslDirections, FslTheme, HookDescription, HookHandler, HookContext, HookResult, HookComplexResult, JssmRng } from './jssm_types';
 import { arrow_direction, arrow_left_kind, arrow_right_kind } from './jssm_arrow';
 import { compile, make, wrap_parse } from './jssm_compiler';
-import { seq, unique, find_repeated, weighted_rand_select, weighted_sample_select, histograph, weighted_histo_key } from './jssm_util';
+import { seq, unique, find_repeated, weighted_rand_select, weighted_sample_select, histograph, weighted_histo_key, sleep } from './jssm_util';
 import * as constants from './jssm_constants';
 declare const shapes: string[], gviz_shapes: string[], named_colors: string[];
 import { version, build_time } from './version';
@@ -56,6 +56,7 @@ declare class Machine<mDT> {
     _has_named_hooks: boolean;
     _has_entry_hooks: boolean;
     _has_exit_hooks: boolean;
+    _has_after_hooks: boolean;
     _has_global_action_hooks: boolean;
     _has_transition_hooks: boolean;
     _has_forced_transitions: boolean;
@@ -63,6 +64,7 @@ declare class Machine<mDT> {
     _named_hooks: Map<string, HookHandler<mDT>>;
     _entry_hooks: Map<string, HookHandler<mDT>>;
     _exit_hooks: Map<string, HookHandler<mDT>>;
+    _after_hooks: Map<string, HookHandler<mDT>>;
     _global_action_hooks: Map<string, HookHandler<mDT>>;
     _any_action_hook: HookHandler<mDT> | undefined;
     _standard_transition_hook: HookHandler<mDT> | undefined;
@@ -669,6 +671,7 @@ declare class Machine<mDT> {
     hook_any_transition(handler: HookHandler<mDT>): Machine<mDT>;
     hook_entry(to: string, handler: HookHandler<mDT>): Machine<mDT>;
     hook_exit(from: string, handler: HookHandler<mDT>): Machine<mDT>;
+    hook_after(from: string, handler: HookHandler<mDT>): Machine<mDT>;
     post_hook(from: string, to: string, handler: HookHandler<mDT>): Machine<mDT>;
     post_hook_action(from: string, to: string, action: string, handler: HookHandler<mDT>): Machine<mDT>;
     post_hook_global_action(action: string, handler: HookHandler<mDT>): Machine<mDT>;
@@ -1135,4 +1138,4 @@ declare function is_hook_complex_result<mDT>(hr: unknown): hr is HookComplexResu
 declare function is_hook_rejection<mDT>(hr: HookResult<mDT>): boolean;
 declare function abstract_hook_step<mDT>(maybe_hook: HookHandler<mDT> | undefined, hook_args: HookContext<mDT>): HookComplexResult<mDT>;
 declare function deserialize<mDT>(machine_string: string, ser: JssmSerialization<mDT>): Machine<mDT>;
-export { version, build_time, transfer_state_properties, Machine, deserialize, 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, constants, shapes, gviz_shapes, named_colors, is_hook_rejection, is_hook_complex_result, abstract_hook_step, state_style_condense, FslDirections };
+export { version, build_time, transfer_state_properties, Machine, deserialize, 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, sleep, constants, shapes, gviz_shapes, named_colors, is_hook_rejection, is_hook_complex_result, abstract_hook_step, state_style_condense, FslDirections };

package/jssm_types.d.ts

@@ -303,6 +303,11 @@ declare type ExitHook<mDT> = {
     from: string;
     handler: HookHandler<mDT>;
 };
+declare type AfterHook<mDT> = {
+    kind: 'after';
+    from: string;
+    handler: HookHandler<mDT>;
+};
 declare type PostBasicHookDescription<mDT> = {
     kind: 'post hook';
     from: string;
@@ -351,7 +356,7 @@ declare type PostExitHook<mDT> = {
     from: string;
     handler: PostHookHandler<mDT>;
 };
-declare type HookDescription<mDT> = BasicHookDescription<mDT> | HookDescriptionWithAction<mDT> | GlobalActionHook<mDT> | AnyActionHook<mDT> | StandardTransitionHook<mDT> | MainTransitionHook<mDT> | ForcedTransitionHook<mDT> | AnyTransitionHook<mDT> | EntryHook<mDT> | ExitHook<mDT> | PostBasicHookDescription<mDT> | PostHookDescriptionWithAction<mDT> | PostGlobalActionHook<mDT> | PostAnyActionHook<mDT> | PostStandardTransitionHook<mDT> | PostMainTransitionHook<mDT> | PostForcedTransitionHook<mDT> | PostAnyTransitionHook<mDT> | PostEntryHook<mDT> | PostExitHook<mDT>;
+declare type HookDescription<mDT> = BasicHookDescription<mDT> | HookDescriptionWithAction<mDT> | GlobalActionHook<mDT> | AnyActionHook<mDT> | StandardTransitionHook<mDT> | MainTransitionHook<mDT> | ForcedTransitionHook<mDT> | AnyTransitionHook<mDT> | EntryHook<mDT> | ExitHook<mDT> | AfterHook<mDT> | PostBasicHookDescription<mDT> | PostHookDescriptionWithAction<mDT> | PostGlobalActionHook<mDT> | PostAnyActionHook<mDT> | PostStandardTransitionHook<mDT> | PostMainTransitionHook<mDT> | PostForcedTransitionHook<mDT> | PostAnyTransitionHook<mDT> | PostEntryHook<mDT> | PostExitHook<mDT>;
 declare type HookComplexResult<mDT> = {
     pass: boolean;
     state?: StateType;

package/jssm_util.d.ts

@@ -102,4 +102,5 @@ declare const unique: <T>(arr?: T[]) => T[];
  *
  */
 declare function find_repeated<T>(arr: T[]): [T, number][];
-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, hook_name, named_hook_name, gen_splitmix32 };
+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, hook_name, named_hook_name, gen_splitmix32, sleep };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jssm",
-  "version": "5.98.8",
+  "version": "5.99.0",
   "engines": {
     "node": ">=10.0.0"
   },