xstate 4.9.1 → 4.13.0

package/es/interpreter.js

@@ -1,12 +1,13 @@
 import { __values, __assign, __spread } from './_virtual/_tslib.js';
 import { IS_PRODUCTION } from './environment.js';
-import { warn, mapContext, isFunction, keys, toSCXMLEvent, isPromiseLike, isObservable, isMachine, reportUnhandledExceptionOnInvocation, symbolObservable, isArray, toEventObject, isString, uniqueId } from './utils.js';
+import { warn, mapContext, isFunction, keys, toSCXMLEvent, toInvokeSource, isPromiseLike, isObservable, isMachine, reportUnhandledExceptionOnInvocation, symbolObservable, isArray, toEventObject, isString, uniqueId } from './utils.js';
 import { ActionTypes, SpecialTargets } from './types.js';
 import { isInFinalState } from './stateUtils.js';
 import { errorPlatform, log, stop, start, cancel, send, update, error as error$1 } from './actionTypes.js';
 import { doneInvoke, initEvent, getActionFunction, error } from './actions.js';
 import { isState, State, bindActionToState } from './State.js';
-import { isActor } from './Actor.js';
+import { provide, consume } from './serviceScope.js';
+import { isActor, createDeferredActor } from './Actor.js';
 import { Scheduler } from './scheduler.js';
 import { registry } from './registry.js';
 import { registerService } from './devTools.js';
@@ -14,23 +15,6 @@ var DEFAULT_SPAWN_OPTIONS = {
   sync: false,
   autoForward: false
 };
-/**
- * Maintains a stack of the current service in scope.
- * This is used to provide the correct service to spawn().
- *
- * @private
- */
-
-var withServiceScope = /*#__PURE__*/function () {
-  var serviceStack = [];
-  return function (service, fn) {
-    service && serviceStack.push(service);
-    var result = fn(service || serviceStack[serviceStack.length - 1]);
-    service && serviceStack.pop();
-    return result;
-  };
-}();
-
 var InterpreterStatus;
 
 (function (InterpreterStatus) {
@@ -184,12 +168,12 @@ function () {
         return this._initialState;
       }
 
-      return withServiceScope(this, function () {
+      return provide(this, function () {
         _this._initialState = _this.machine.initialState;
         return _this._initialState;
       });
     },
-    enumerable: true,
+    enumerable: false,
     configurable: true
   });
   Object.defineProperty(Interpreter.prototype, "state", {
@@ -200,7 +184,7 @@ function () {
 
       return this._state;
     },
-    enumerable: true,
+    enumerable: false,
     configurable: true
   });
   /**
@@ -311,7 +295,7 @@ function () {
       var finalChildStateNode = state.configuration.find(function (sn) {
         return sn.type === 'final' && sn.parent === _this.machine;
       });
-      var doneData = finalChildStateNode && finalChildStateNode.data ? mapContext(finalChildStateNode.data, state.context, _event) : undefined;
+      var doneData = finalChildStateNode && finalChildStateNode.doneData ? mapContext(finalChildStateNode.doneData, state.context, _event) : undefined;
 
       try {
         for (var _l = __values(this.doneListeners), _m = _l.next(); !_m.done; _m = _l.next()) {
@@ -351,8 +335,8 @@ function () {
     return this;
   };
 
-  Interpreter.prototype.subscribe = function (nextListenerOrObserver, // @ts-ignore
-  errorListener, completeListener) {
+  Interpreter.prototype.subscribe = function (nextListenerOrObserver, _, // TODO: error listener
+  completeListener) {
     var _this = this;
 
     if (!nextListenerOrObserver) {
@@ -472,7 +456,7 @@ function () {
     registry.register(this.sessionId, this);
     this.initialized = true;
     this._status = InterpreterStatus.Running;
-    var resolvedState = initialState === undefined ? this.initialState : withServiceScope(this, function () {
+    var resolvedState = initialState === undefined ? this.initialState : provide(this, function () {
       return isState(initialState) ? _this.machine.resolveState(initialState) : _this.machine.resolveState(State.from(initialState, _this.machine.context));
     });
 
@@ -622,7 +606,7 @@ function () {
 
         _this.forward(_event);
 
-        nextState = withServiceScope(_this, function () {
+        nextState = provide(_this, function () {
           return _this.machine.transition(nextState, _event);
         });
         batchedActions.push.apply(batchedActions, __spread(nextState.actions.map(function (a) {
@@ -685,7 +669,7 @@ function () {
       throw _event.data.data;
     }
 
-    var nextState = withServiceScope(this, function () {
+    var nextState = provide(this, function () {
       return _this.machine.transition(_this.state, _event);
     });
     return nextState;
@@ -736,9 +720,13 @@ function () {
   };
 
   Interpreter.prototype.exec = function (action, state, actionFunctionMap) {
+    if (actionFunctionMap === void 0) {
+      actionFunctionMap = this.machine.options.actions;
+    }
+
     var context = state.context,
         _event = state._event;
-    var actionOrExec = getActionFunction(action.type, actionFunctionMap) || action.exec;
+    var actionOrExec = action.exec || getActionFunction(action.type, actionFunctionMap);
     var exec = isFunction(actionOrExec) ? actionOrExec : actionOrExec ? actionOrExec.exec : action.exec;
 
     if (exec) {
@@ -787,13 +775,14 @@ function () {
           // (such as in transient states)
           // don't bother starting the activity.
 
-          if (!this.state.activities[activity.type]) {
+          if (!this.state.activities[activity.id || activity.type]) {
             break;
           } // Invoked services
 
 
           if (activity.type === ActionTypes.Invoke) {
-            var serviceCreator = this.machine.options.services ? this.machine.options.services[activity.src] : undefined;
+            var invokeSource = toInvokeSource(activity.src);
+            var serviceCreator = this.machine.options.services ? this.machine.options.services[invokeSource.type] : undefined;
             var id = activity.id,
                 data = activity.data;
 
@@ -813,7 +802,11 @@ function () {
               return;
             }
 
-            var source = isFunction(serviceCreator) ? serviceCreator(context, _event.data) : serviceCreator;
+            var resolvedData = data ? mapContext(data, context, _event) : undefined;
+            var source = isFunction(serviceCreator) ? serviceCreator(context, _event.data, {
+              data: resolvedData,
+              src: invokeSource
+            }) : serviceCreator;
 
             if (isPromiseLike(source)) {
               this.state.children[id] = this.spawnPromise(Promise.resolve(source), id);
@@ -823,7 +816,7 @@ function () {
               this.state.children[id] = this.spawnObservable(source, id);
             } else if (isMachine(source)) {
               // TODO: try/catch here
-              this.state.children[id] = this.spawnMachine(data ? source.withContext(mapContext(data, context, _event)) : source, {
+              this.state.children[id] = this.spawnMachine(resolvedData ? source.withContext(resolvedData) : source, {
                 id: id,
                 autoForward: autoForward
               });
@@ -1239,36 +1232,12 @@ function () {
       logger: global.console.log.bind(console),
       devTools: false
     };
-  }(typeof window === 'undefined' ? global : window);
+  }(typeof self !== 'undefined' ? self : global);
 
   Interpreter.interpret = interpret;
   return Interpreter;
 }();
 
-var createNullActor = function (name) {
-  if (name === void 0) {
-    name = 'null';
-  }
-
-  return {
-    id: name,
-    send: function () {
-      return void 0;
-    },
-    subscribe: function () {
-      // tslint:disable-next-line:no-empty
-      return {
-        unsubscribe: function () {}
-      };
-    },
-    toJSON: function () {
-      return {
-        id: name
-      };
-    }
-  };
-};
-
 var resolveSpawnOptions = function (nameOrOptions) {
   if (isString(nameOrOptions)) {
     return __assign(__assign({}, DEFAULT_SPAWN_OPTIONS), {
@@ -1283,15 +1252,16 @@ var resolveSpawnOptions = function (nameOrOptions) {
 
 function spawn(entity, nameOrOptions) {
   var resolvedOptions = resolveSpawnOptions(nameOrOptions);
-  return withServiceScope(undefined, function (service) {
+  return consume(function (service) {
     if (!IS_PRODUCTION) {
-      warn(!!service, "Attempted to spawn an Actor (ID: \"" + (isMachine(entity) ? entity.id : 'undefined') + "\") outside of a service. This will have no effect.");
+      var isLazyEntity = isMachine(entity) || isFunction(entity);
+      warn(!!service || isLazyEntity, "Attempted to spawn an Actor (ID: \"" + (isMachine(entity) ? entity.id : 'undefined') + "\") outside of a service. This will have no effect.");
     }
 
     if (service) {
       return service.spawn(entity, resolvedOptions.name, resolvedOptions);
     } else {
-      return createNullActor(resolvedOptions.name);
+      return createDeferredActor(entity, resolvedOptions.name);
     }
   });
 }

package/es/invokeUtils.d.ts

@@ -0,0 +1,7 @@
+import { EventObject, InvokeConfig, InvokeDefinition, InvokeSourceDefinition } from './types';
+export declare function toInvokeSource(src: string | InvokeSourceDefinition): InvokeSourceDefinition;
+export declare function toInvokeDefinition<TContext, TEvent extends EventObject>(invokeConfig: InvokeConfig<TContext, TEvent> & {
+    src: string | InvokeSourceDefinition;
+    id: string;
+}): InvokeDefinition<TContext, TEvent>;
+//# sourceMappingURL=invokeUtils.d.ts.map

package/es/invokeUtils.js

@@ -0,0 +1,39 @@
+import { __assign, __rest } from './_virtual/_tslib.js';
+import { invoke } from './actionTypes.js';
+import './actions.js';
+
+function toInvokeSource(src) {
+  if (typeof src === 'string') {
+    var simpleSrc = {
+      type: src
+    };
+
+    simpleSrc.toString = function () {
+      return src;
+    }; // v4 compat - TODO: remove in v5
+
+
+    return simpleSrc;
+  }
+
+  return src;
+}
+
+function toInvokeDefinition(invokeConfig) {
+  return __assign(__assign({
+    type: invoke
+  }, invokeConfig), {
+    toJSON: function () {
+      var onDone = invokeConfig.onDone,
+          onError = invokeConfig.onError,
+          invokeDef = __rest(invokeConfig, ["onDone", "onError"]);
+
+      return __assign(__assign({}, invokeDef), {
+        type: invoke,
+        src: toInvokeSource(invokeConfig.src)
+      });
+    }
+  });
+}
+
+export { toInvokeDefinition, toInvokeSource };

package/es/serviceScope.d.ts

@@ -0,0 +1,10 @@
+import { Interpreter } from './interpreter';
+export declare const provide: <T, TService extends Interpreter<any, any, any, {
+    value: any;
+    context: any;
+}>>(service: TService | undefined, fn: (service: TService | undefined) => T) => T;
+export declare const consume: <T, TService extends Interpreter<any, any, any, {
+    value: any;
+    context: any;
+}>>(fn: (service: TService) => T) => T;
+//# sourceMappingURL=serviceScope.d.ts.map

package/es/serviceScope.js

@@ -0,0 +1,18 @@
+/**
+ * Maintains a stack of the current service in scope.
+ * This is used to provide the correct service to spawn().
+ */
+var serviceStack = [];
+
+var provide = function (service, fn) {
+  serviceStack.push(service);
+  var result = fn(service);
+  serviceStack.pop();
+  return result;
+};
+
+var consume = function (fn) {
+  return fn(serviceStack[serviceStack.length - 1]);
+};
+
+export { consume, provide };

package/es/stateUtils.d.ts

@@ -1,7 +1,7 @@
 import { EventObject, StateNode, StateValue } from '.';
 declare type Configuration<TC, TE extends EventObject> = Iterable<StateNode<TC, any, TE>>;
 declare type AdjList<TC, TE extends EventObject> = Map<StateNode<TC, any, TE>, Array<StateNode<TC, any, TE>>>;
-export declare const isLeafNode: (stateNode: StateNode<any, any, any, any>) => boolean;
+export declare const isLeafNode: (stateNode: StateNode<any, any, any>) => boolean;
 export declare function getChildren<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE>): Array<StateNode<TC, any, TE>>;
 export declare function getAllStateNodes<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE>): Array<StateNode<TC, any, TE>>;
 export declare function getConfiguration<TC, TE extends EventObject>(prevStateNodes: Iterable<StateNode<TC, any, TE>>, stateNodes: Iterable<StateNode<TC, any, TE>>): Iterable<StateNode<TC, any, TE>>;

package/es/types.d.ts

@@ -49,12 +49,12 @@ export interface AssignMeta<TContext, TEvent extends EventObject> {
     action: AssignAction<TContext, TEvent>;
     _event: SCXML.Event<TEvent>;
 }
-export declare type ActionFunction<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent, meta: ActionMeta<TContext, TEvent>) => any | void;
+export declare type ActionFunction<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent, meta: ActionMeta<TContext, TEvent>) => void;
 export interface ChooseConditon<TContext, TEvent extends EventObject> {
     cond?: Condition<TContext, TEvent>;
     actions: Actions<TContext, TEvent>;
 }
-export declare type Action<TContext, TEvent extends EventObject> = ActionType | ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent> | AssignAction<Required<TContext>, TEvent> | SendAction<TContext, AnyEventObject> | RaiseAction<AnyEventObject> | ChooseAction<TContext, TEvent>;
+export declare type Action<TContext, TEvent extends EventObject> = ActionType | ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent>;
 export declare type Actions<TContext, TEvent extends EventObject> = SingleOrArray<Action<TContext, TEvent>>;
 export declare type StateKey = string | State<any>;
 export interface StateValueMap {
@@ -67,11 +67,14 @@ export interface StateValueMap {
  * - For complex state nodes, this is an object, e.g., `{ success: "someChildState" }`.
  */
 export declare type StateValue = string | StateValueMap;
-export declare type ExtractStateValue<TS extends StateSchema<any>, TSS = TS['states']> = TSS extends undefined ? never : {
-    [K in keyof TSS]?: (TSS[K] extends {
-        states: any;
-    } ? keyof TSS[K]['states'] : never) | ExtractStateValue<TSS[K]>;
-};
+declare type KeysWithStates<TStates extends Record<string, StateSchema> | undefined> = TStates extends object ? {
+    [K in keyof TStates]-?: TStates[K] extends {
+        states: object;
+    } ? K : never;
+}[keyof TStates] : never;
+export declare type ExtractStateValue<TSchema extends Required<Pick<StateSchema<any>, 'states'>>> = keyof TSchema['states'] | (KeysWithStates<TSchema['states']> extends never ? never : {
+    [K in KeysWithStates<TSchema['states']>]?: ExtractStateValue<TSchema['states'][K]>;
+});
 export interface HistoryValue {
     states: Record<string, HistoryValue | undefined>;
     current: StateValue | undefined;
@@ -115,6 +118,10 @@ export interface ActivityDefinition<TContext, TEvent extends EventObject> extend
 export declare type Sender<TEvent extends EventObject> = (event: Event<TEvent>) => void;
 export declare type Receiver<TEvent extends EventObject> = (listener: (event: TEvent) => void) => void;
 export declare type InvokeCallback = (callback: Sender<any>, onReceive: Receiver<EventObject>) => any;
+export interface InvokeMeta {
+    data: any;
+    src: InvokeSourceDefinition;
+}
 /**
  * Returns either a Promises or a callback handler (for streams of events) given the
  * machine's current `context` and `event` that invoked the service.
@@ -128,12 +135,12 @@ export declare type InvokeCallback = (callback: Sender<any>, onReceive: Receiver
  * @param context The current machine `context`
  * @param event The event that invoked the service
  */
-export declare type InvokeCreator<TContext, TEvent = AnyEventObject, TFinalContext = any> = (context: TContext, event: TEvent) => PromiseLike<TFinalContext> | StateMachine<TFinalContext, any, any> | Subscribable<any> | InvokeCallback;
+export declare type InvokeCreator<TContext, TEvent = AnyEventObject, TFinalContext = any> = (context: TContext, event: TEvent, meta: InvokeMeta) => PromiseLike<TFinalContext> | StateMachine<TFinalContext, any, any> | Subscribable<any> | InvokeCallback;
 export interface InvokeDefinition<TContext, TEvent extends EventObject> extends ActivityDefinition<TContext, TEvent> {
     /**
      * The source of the machine to be invoked, or the machine itself.
      */
-    src: string;
+    src: string | InvokeSourceDefinition;
     /**
      * If `true`, events sent to the parent service will be forwarded to the invoked service.
      *
@@ -152,7 +159,7 @@ export interface InvokeDefinition<TContext, TEvent extends EventObject> extends
      *
      * Data should be mapped to match the child machine's context shape.
      */
-    data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
+    data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
 }
 export interface Delay {
     id: string;
@@ -186,18 +193,18 @@ declare type TransitionsConfigMap<TContext, TEvent extends EventObject> = {
 } & {
     '*'?: TransitionConfigOrTarget<TContext, TEvent>;
 };
-declare type TransitionsConfigArray<TContext, TEvent extends EventObject> = Array<{
-    [K in TEvent['type']]: TransitionConfig<TContext, TEvent extends {
-        type: K;
-    } ? TEvent : never> & {
-        event: K;
-    };
-}[TEvent['type']] | (TransitionConfig<TContext, TEvent> & {
+declare type TransitionsConfigArray<TContext, TEvent extends EventObject> = Array<(TEvent extends EventObject ? TransitionConfig<TContext, TEvent> & {
+    event: TEvent['type'];
+} : never) | (TransitionConfig<TContext, TEvent> & {
     event: '';
 }) | (TransitionConfig<TContext, TEvent> & {
     event: '*';
 })>;
 export declare type TransitionsConfig<TContext, TEvent extends EventObject> = TransitionsConfigMap<TContext, TEvent> | TransitionsConfigArray<TContext, TEvent>;
+export interface InvokeSourceDefinition {
+    [key: string]: any;
+    type: string;
+}
 export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
     /**
      * The unique identifier for the invoked machine. If not specified, this
@@ -207,7 +214,7 @@ export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
     /**
      * The source of the machine to be invoked, or the machine itself.
      */
-    src: string | StateMachine<any, any, any> | InvokeCreator<TContext, TEvent, any>;
+    src: string | InvokeSourceDefinition | StateMachine<any, any, any> | InvokeCreator<TContext, TEvent, any>;
     /**
      * If `true`, events sent to the parent service will be forwarded to the invoked service.
      *
@@ -226,7 +233,7 @@ export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
      *
      * Data should be mapped to match the child machine's context shape.
      */
-    data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
+    data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
     /**
      * The transition to take upon the invoked child machine reaching its final top-level state.
      */
@@ -235,7 +242,7 @@ export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
      * The transition to take upon the invoked child machine sending an error event.
      */
     onError?: string | SingleOrArray<TransitionConfig<TContext, DoneInvokeEvent<any>>>;
-} | StateMachine<any, any, any>;
+};
 export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEvent extends EventObject> {
     /**
      * The relative key of the state node, which represents its location in the overall state value.
@@ -279,7 +286,7 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
     /**
      * The services to invoke upon entering this state node. These services will be stopped upon exiting this state node.
      */
-    invoke?: SingleOrArray<InvokeConfig<TContext, TEvent>>;
+    invoke?: SingleOrArray<InvokeConfig<TContext, TEvent> | StateMachine<any, any, any>>;
     /**
      * The mapping of event types to their potential transition(s).
      */
@@ -315,6 +322,11 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
      * The delayed transitions are taken after the specified delay in an interpreter.
      */
     after?: DelayedTransitions<TContext, TEvent>;
+    /**
+     * An eventless transition that is always taken when this state node is active.
+     * Equivalent to a transition specified as an empty `''`' string in the `on` property.
+     */
+    always?: TransitionConfigOrTarget<TContext, TEvent>;
     /**
      * The activities to be started upon entering the state node,
      * and stopped upon exiting the state node.
@@ -337,7 +349,7 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
      * The data will be evaluated with the current `context` and placed on the `.data` property
      * of the event.
      */
-    data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
+    data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
     /**
      * The unique ID of the state node, which can be referenced as a transition target via the
      * `#id` syntax.
@@ -388,18 +400,18 @@ export interface FinalStateNodeConfig<TContext, TEvent extends EventObject> exte
      * The data to be sent with the "done.state.<id>" event. The data can be
      * static or dynamic (based on assigners).
      */
-    data?: Assigner<TContext, TEvent> | PropertyAssigner<TContext, TEvent> | any;
+    data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
 }
 export declare type SimpleOrStateNodeConfig<TContext, TStateSchema extends StateSchema, TEvent extends EventObject> = AtomicStateNodeConfig<TContext, TEvent> | StateNodeConfig<TContext, TStateSchema, TEvent>;
 export declare type ActionFunctionMap<TContext, TEvent extends EventObject> = Record<string, ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent>>;
 export declare type DelayFunctionMap<TContext, TEvent extends EventObject> = Record<string, DelayConfig<TContext, TEvent>>;
-export declare type ServiceConfig<TContext> = string | StateMachine<any, any, any> | InvokeCreator<TContext>;
+export declare type ServiceConfig<TContext, TEvent extends EventObject = AnyEventObject> = string | StateMachine<any, any, any> | InvokeCreator<TContext, TEvent>;
 export declare type DelayConfig<TContext, TEvent extends EventObject> = number | DelayExpr<TContext, TEvent>;
 export interface MachineOptions<TContext, TEvent extends EventObject> {
     guards: Record<string, ConditionPredicate<TContext, TEvent>>;
     actions: ActionFunctionMap<TContext, TEvent>;
     activities: Record<string, ActivityConfig<TContext, TEvent>>;
-    services: Record<string, ServiceConfig<TContext>>;
+    services: Record<string, ServiceConfig<TContext, TEvent>>;
     delays: DelayFunctionMap<TContext, TEvent>;
     /**
      * @private
@@ -434,7 +446,10 @@ export interface HistoryStateNode<TContext> extends StateNode<TContext> {
     history: 'shallow' | 'deep';
     target: StateValue | undefined;
 }
-export interface StateMachine<TContext, TStateSchema extends StateSchema, TEvent extends EventObject, TTypestate extends Typestate<TContext> = any> extends StateNode<TContext, TStateSchema, TEvent, TTypestate> {
+export interface StateMachine<TContext, TStateSchema extends StateSchema, TEvent extends EventObject, TTypestate extends Typestate<TContext> = {
+    value: any;
+    context: TContext;
+}> extends StateNode<TContext, TStateSchema, TEvent, TTypestate> {
     id: string;
     states: StateNode<TContext, TStateSchema, TEvent>['states'];
 }
@@ -541,22 +556,22 @@ export interface LogAction<TContext, TEvent extends EventObject> extends ActionO
 export interface LogActionObject<TContext, TEvent extends EventObject> extends LogAction<TContext, TEvent> {
     value: any;
 }
-export interface SendAction<TContext, TEvent extends EventObject> extends ActionObject<TContext, TEvent> {
+export interface SendAction<TContext, TEvent extends EventObject, TSentEvent extends EventObject> extends ActionObject<TContext, TEvent> {
     to: string | number | Actor | ExprWithMeta<TContext, TEvent, string | number | Actor> | undefined;
-    event: TEvent | SendExpr<TContext, TEvent>;
+    event: TSentEvent | SendExpr<TContext, TEvent, TSentEvent>;
     delay?: number | string | DelayExpr<TContext, TEvent>;
     id: string | number;
 }
-export interface SendActionObject<TContext, TEvent extends EventObject> extends SendAction<TContext, TEvent> {
+export interface SendActionObject<TContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject> extends SendAction<TContext, TEvent, TSentEvent> {
     to: string | number | Actor | undefined;
-    _event: SCXML.Event<TEvent>;
-    event: TEvent;
+    _event: SCXML.Event<TSentEvent>;
+    event: TSentEvent;
     delay?: number;
     id: string | number;
 }
 export declare type Expr<TContext, TEvent extends EventObject, T> = (context: TContext, event: TEvent) => T;
 export declare type ExprWithMeta<TContext, TEvent extends EventObject, T> = (context: TContext, event: TEvent, meta: SCXMLEventMeta<TEvent>) => T;
-export declare type SendExpr<TContext, TEvent extends EventObject> = ExprWithMeta<TContext, TEvent, TEvent>;
+export declare type SendExpr<TContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject> = ExprWithMeta<TContext, TEvent, TSentEvent>;
 export declare enum SpecialTargets {
     Parent = "#_parent",
     Internal = "#_internal"
@@ -573,10 +588,10 @@ export declare type Assigner<TContext, TEvent extends EventObject> = (context: T
 export declare type PropertyAssigner<TContext, TEvent extends EventObject> = {
     [K in keyof TContext]?: ((context: TContext, event: TEvent, meta: AssignMeta<TContext, TEvent>) => TContext[K]) | TContext[K];
 };
-export declare type Mapper<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent) => any;
-export declare type PropertyMapper<TContext, TEvent extends EventObject> = Partial<{
-    [key: string]: ((context: TContext, event: TEvent) => any) | any;
-}>;
+export declare type Mapper<TContext, TEvent extends EventObject, TParams extends {}> = (context: TContext, event: TEvent) => TParams;
+export declare type PropertyMapper<TContext, TEvent extends EventObject, TParams extends {}> = {
+    [K in keyof TParams]?: ((context: TContext, event: TEvent) => TParams[K]) | TParams[K];
+};
 export interface AnyAssignAction<TContext, TEvent extends EventObject> extends ActionObject<TContext, TEvent> {
     type: ActionTypes.Assign;
     assignment: any;
@@ -599,6 +614,13 @@ export interface TransitionDefinition<TContext, TEvent extends EventObject> exte
     actions: Array<ActionObject<TContext, TEvent>>;
     cond?: Guard<TContext, TEvent>;
     eventType: TEvent['type'] | NullEvent['type'] | '*';
+    toJSON: () => {
+        target: string[] | undefined;
+        source: string;
+        actions: Array<ActionObject<TContext, TEvent>>;
+        cond?: Guard<TContext, TEvent>;
+        eventType: TEvent['type'] | NullEvent['type'] | '*';
+    };
 }
 export declare type TransitionDefinitionMap<TContext, TEvent extends EventObject> = {
     [K in TEvent['type'] | NullEvent['type'] | '*']: Array<TransitionDefinition<TContext, K extends TEvent['type'] ? Extract<TEvent, {
@@ -788,7 +810,7 @@ export declare namespace SCXML {
     }
 }
 export interface Unsubscribable {
-    unsubscribe(): any | void;
+    unsubscribe(): void;
 }
 export interface Subscribable<T> {
     subscribe(next?: (value: T) => void, error?: (error: any) => void, complete?: () => void): Unsubscribable;

package/es/utils.d.ts

@@ -1,4 +1,4 @@
-import { Event, StateValue, ActionType, Action, EventObject, PropertyMapper, Mapper, EventType, HistoryValue, AssignAction, Condition, Subscribable, StateMachine, ConditionPredicate, SCXML, StateLike, EventData, TransitionConfig, TransitionConfigTarget, NullEvent, SingleOrArray, Guard } from './types';
+import { Event, StateValue, ActionType, Action, EventObject, PropertyMapper, Mapper, EventType, HistoryValue, AssignAction, Condition, Subscribable, StateMachine, ConditionPredicate, SCXML, StateLike, EventData, TransitionConfig, TransitionConfigTarget, NullEvent, SingleOrArray, Guard, InvokeSourceDefinition } from './types';
 import { StateNode } from './StateNode';
 import { State } from '.';
 import { Actor } from './Actor';
@@ -39,7 +39,7 @@ export declare function pathsToStateValue(paths: string[][]): StateValue;
 export declare function flatten<T>(array: Array<T | T[]>): T[];
 export declare function toArrayStrict<T>(value: T[] | T): T[];
 export declare function toArray<T>(value: T[] | T | undefined): T[];
-export declare function mapContext<TContext, TEvent extends EventObject>(mapper: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>): any;
+export declare function mapContext<TContext, TEvent extends EventObject>(mapper: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>, context: TContext, _event: SCXML.Event<TEvent>): any;
 export declare function isBuiltInEvent(eventType: EventType): boolean;
 export declare function isPromiseLike(value: any): value is PromiseLike<any>;
 export declare function partition<T, A extends T, B extends T>(items: T[], predicate: (item: T) => item is A): [A[], B[]];
@@ -52,7 +52,7 @@ export declare function isArray(value: any): value is any[];
 export declare function isFunction(value: any): value is Function;
 export declare function isString(value: any): value is string;
 export declare function toGuard<TContext, TEvent extends EventObject>(condition?: Condition<TContext, TEvent>, guardMap?: Record<string, ConditionPredicate<TContext, TEvent>>): Guard<TContext, TEvent> | undefined;
-export declare function isObservable<T>(value: Subscribable<T> | any): value is Subscribable<T>;
+export declare function isObservable<T>(value: any): value is Subscribable<T>;
 export declare const symbolObservable: string | symbol;
 export declare function isMachine(value: any): value is StateMachine<any, any, any>;
 export declare function isActor(value: any): value is Actor;
@@ -65,4 +65,5 @@ export declare function toTransitionConfigArray<TContext, TEvent extends EventOb
 export declare function normalizeTarget<TContext, TEvent extends EventObject>(target: SingleOrArray<string | StateNode<TContext, any, TEvent>> | undefined): Array<string | StateNode<TContext, any, TEvent>> | undefined;
 export declare function reportUnhandledExceptionOnInvocation(originalError: any, currentError: any, id: string): void;
 export declare function evaluateGuard<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent>, guard: Guard<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>, state: State<TContext, TEvent>): boolean;
+export declare function toInvokeSource(src: string | InvokeSourceDefinition): InvokeSourceDefinition;
 //# sourceMappingURL=utils.d.ts.map

package/es/utils.js

@@ -259,7 +259,7 @@ function mapContext(mapper, context, _event) {
   var result = {};
 
   try {
-    for (var _b = __values(keys(mapper)), _c = _b.next(); !_c.done; _c = _b.next()) {
+    for (var _b = __values(Object.keys(mapper)), _c = _b.next(); !_c.done; _c = _b.next()) {
       var key = _c.value;
       var subMapper = mapper[key];
 
@@ -530,7 +530,6 @@ function toSCXMLEvent(event, scxmlEvent) {
 function toTransitionConfigArray(event, configLike) {
   var transitions = toArrayStrict(configLike).map(function (transitionLike) {
     if (typeof transitionLike === 'undefined' || typeof transitionLike === 'string' || isMachine(transitionLike)) {
-      // @ts-ignore until Type instantiation is excessively deep and possibly infinite bug is fixed
       return {
         target: transitionLike,
         event: event
@@ -588,4 +587,14 @@ function evaluateGuard(machine, guard, context, _event, state) {
   return condFn(context, _event.data, guardMeta);
 }
 
-export { evaluateGuard, flatten, getEventType, isArray, isBuiltInEvent, isFunction, isMachine, isObservable, isPromiseLike, isStateLike, isString, keys, mapContext, mapFilterValues, mapValues, matchesState, nestedPath, normalizeTarget, partition, path, pathToStateValue, reportUnhandledExceptionOnInvocation, symbolObservable, toArray, toArrayStrict, toEventObject, toGuard, toSCXMLEvent, toStatePath, toStatePaths, toStateValue, toTransitionConfigArray, uniqueId, updateContext, updateHistoryStates, updateHistoryValue, warn };
+function toInvokeSource(src) {
+  if (typeof src === 'string') {
+    return {
+      type: src
+    };
+  }
+
+  return src;
+}
+
+export { evaluateGuard, flatten, getEventType, isArray, isBuiltInEvent, isFunction, isMachine, isObservable, isPromiseLike, isStateLike, isString, keys, mapContext, mapFilterValues, mapValues, matchesState, nestedPath, normalizeTarget, partition, path, pathToStateValue, reportUnhandledExceptionOnInvocation, symbolObservable, toArray, toArrayStrict, toEventObject, toGuard, toInvokeSource, toSCXMLEvent, toStatePath, toStatePaths, toStateValue, toTransitionConfigArray, uniqueId, updateContext, updateHistoryStates, updateHistoryValue, warn };

package/lib/Actor.d.ts

@@ -1,4 +1,4 @@
-import { EventObject, Subscribable, InvokeDefinition, AnyEventObject } from './types';
+import { EventObject, Subscribable, InvokeDefinition, AnyEventObject, StateMachine, Spawnable, SCXML } from './types';
 export interface Actor<TContext = any, TEvent extends EventObject = AnyEventObject> extends Subscribable<TContext> {
     id: string;
     send: (event: TEvent) => any;
@@ -8,14 +8,16 @@ export interface Actor<TContext = any, TEvent extends EventObject = AnyEventObje
     };
     meta?: InvokeDefinition<TContext, TEvent>;
     state?: any;
+    deferred?: boolean;
 }
 export declare function createNullActor(id: string): Actor;
 /**
- * Creates a null actor that is able to be invoked given the provided
+ * Creates a deferred actor that is able to be invoked given the provided
  * invocation information in its `.meta` value.
  *
  * @param invokeDefinition The meta information needed to invoke the actor.
  */
-export declare function createInvocableActor<TC, TE extends EventObject>(invokeDefinition: InvokeDefinition<TC, TE>): Actor;
+export declare function createInvocableActor<TC, TE extends EventObject>(invokeDefinition: InvokeDefinition<TC, TE>, machine: StateMachine<TC, any, TE>, context: TC, _event: SCXML.Event<TE>): Actor;
+export declare function createDeferredActor(entity: Spawnable, id: string, data?: any): Actor;
 export declare function isActor(item: any): item is Actor;
 //# sourceMappingURL=Actor.d.ts.map