jssm 5.58.0 → 5.59.1

package/dist/es6/jssm.d.ts

@@ -46,6 +46,7 @@ declare class Machine<mDT> {
     _named_hooks: Map<string, Function>;
     _entry_hooks: Map<string, Function>;
     _exit_hooks: Map<string, Function>;
+    _global_action_hooks: Map<string, Function>;
     _any_action_hook: HookHandler | undefined;
     _any_transition_hook: HookHandler | undefined;
     constructor({ start_states, complete, transitions, machine_author, machine_comment, machine_contributor, machine_definition, machine_language, machine_license, machine_name, machine_version, state_declaration, fsl_version, dot_preamble, arrange_declaration, arrange_start_declaration, arrange_end_declaration, theme, flow, graph_layout }: JssmGenericConfig<mDT>);
@@ -100,6 +101,8 @@ declare class Machine<mDT> {
     set_hook(HookDesc: HookDescription): void;
     hook(from: string, to: string, handler: HookHandler): Machine<mDT>;
     hook_action(from: string, to: string, action: string, handler: HookHandler): Machine<mDT>;
+    hook_global_action(action: string, handler: HookHandler): Machine<mDT>;
+    hook_any_action(handler: HookHandler): Machine<mDT>;
     hook_any_transition(handler: HookHandler): Machine<mDT>;
     hook_entry(to: string, handler: HookHandler): Machine<mDT>;
     hook_exit(from: string, handler: HookHandler): Machine<mDT>;

package/dist/es6/jssm.js

@@ -355,6 +355,7 @@ class Machine {
         this._named_hooks = new Map();
         this._entry_hooks = new Map();
         this._exit_hooks = new Map();
+        this._global_action_hooks = new Map();
         this._any_action_hook = undefined;
         this._any_transition_hook = undefined;
         if (state_declaration) {
@@ -719,6 +720,10 @@ class Machine {
                 this._named_hooks.set(named_hook_name(HookDesc.from, HookDesc.to, HookDesc.action), HookDesc.handler);
                 this._has_hooks = true;
                 break;
+            case 'global action':
+                this._global_action_hooks.set(HookDesc.action, HookDesc.handler);
+                this._has_hooks = true;
+                break;
             case 'any action':
                 this._any_action_hook = HookDesc.handler;
                 this._has_hooks = true;
@@ -750,6 +755,16 @@ class Machine {
         this.set_hook({ kind: 'named', from, to, action, handler });
         return this;
     }
+    hook_global_action(action, handler) {
+        // TODO: should this throw if setting the hook fails, or ignore it and continue?
+        this.set_hook({ kind: 'global action', action, handler });
+        return this;
+    }
+    hook_any_action(handler) {
+        // TODO: should this throw if setting the hook fails, or ignore it and continue?
+        this.set_hook({ kind: 'any action', handler });
+        return this;
+    }
     hook_any_transition(handler) {
         // TODO: should this throw if setting the hook fails, or ignore it and continue?
         this.set_hook({ kind: 'any transition', handler });
@@ -793,16 +808,21 @@ class Machine {
         // todo major incomplete whargarbl comeback
         if (valid) {
             if (this._has_hooks) {
-                // 1. any action hook
                 if (wasAction) {
+                    // 1. any action hook
                     if (this._any_action_hook !== undefined) {
                         if (this._any_action_hook() === false) {
                             return false;
                         }
                     }
+                    // 2. global specific action hook
+                    const maybe_ga_hook = this._global_action_hooks.get(newStateOrAction);
+                    if (maybe_ga_hook !== undefined) {
+                        if (maybe_ga_hook({ action: newStateOrAction, forced: wasForced }) === false) {
+                            return false;
+                        }
+                    }
                 }
-                // 2. global specific action hook
-                // not yet implemented
                 // 3. any transition hook
                 if (this._any_transition_hook !== undefined) {
                     if (this._any_transition_hook() === false) {

package/dist/es6/jssm_types.d.ts

@@ -166,6 +166,11 @@ declare type AnyTransitionHook = {
     kind: 'any transition';
     handler: HookHandler;
 };
+declare type GlobalActionHook = {
+    kind: 'global action';
+    action: string;
+    handler: HookHandler;
+};
 declare type AnyActionHook = {
     kind: 'any action';
     handler: HookHandler;
@@ -180,5 +185,5 @@ declare type ExitHook = {
     from: string;
     handler: HookHandler;
 };
-declare type HookDescription = BasicHookDescription | HookDescriptionWithAction | AnyActionHook | AnyTransitionHook | EntryHook | ExitHook;
+declare type HookDescription = BasicHookDescription | HookDescriptionWithAction | GlobalActionHook | AnyActionHook | AnyTransitionHook | EntryHook | ExitHook;
 export { JssmColor, JssmTransition, JssmTransitions, JssmTransitionList, JssmTransitionRule, JssmArrow, JssmArrowKind, JssmArrowDirection, JssmGenericConfig, JssmGenericState, JssmGenericMachine, JssmParseTree, JssmCompileSe, JssmCompileSeStart, JssmCompileRule, JssmPermitted, JssmPermittedOpt, JssmResult, JssmStateDeclaration, JssmStateDeclarationRule, JssmLayout, JssmParseFunctionType, JssmMachineInternalState, FslDirection, FslTheme, HookDescription, HookHandler };

package/dist/es6/version.js

@@ -1,2 +1,2 @@
-const version = "5.58.0";
+const version = "5.59.1";
 export { version };