xstate 4.26.1 → 4.28.1

package/es/interpreter.js

@@ -1,6 +1,6 @@
-import { __values, __assign, __spreadArray, __read } from './_virtual/_tslib.js';
+import { __values, __spreadArray, __read, __assign } from './_virtual/_tslib.js';
 import { IS_PRODUCTION } from './environment.js';
-import { warn, mapContext, isFunction, keys, toSCXMLEvent, toInvokeSource, isMachine, isPromiseLike, isObservable, isBehavior, reportUnhandledExceptionOnInvocation, symbolObservable, isArray, toEventObject, isString, isActor, uniqueId, toObserver } from './utils.js';
+import { warn, mapContext, isFunction, keys, toSCXMLEvent, toInvokeSource, isMachine, isPromiseLike, isObservable, isBehavior, reportUnhandledExceptionOnInvocation, interopSymbols, symbolObservable, isArray, toEventObject, isString, isActor, toObserver, 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';
@@ -558,7 +558,9 @@ function () {
       return this;
     }
 
-    this.state.configuration.forEach(function (stateNode) {
+    __spreadArray([], __read(this.state.configuration), false).sort(function (a, b) {
+      return b.order - a.order;
+    }).forEach(function (stateNode) {
       var e_11, _a;
 
       try {
@@ -580,6 +582,7 @@ function () {
       }
     }); // Stop all children
 
+
     this.children.forEach(function (child) {
       if (isFunction(child.stop)) {
         child.stop();
@@ -801,6 +804,10 @@ function () {
 
       case start:
         {
+          if (this.status !== InterpreterStatus.Running) {
+            return;
+          }
+
           var activity = action.activity; // If the activity will be stopped right after it's started
           // (such as in transient states)
           // don't bother starting the activity.
@@ -1032,7 +1039,8 @@ function () {
         }
       }
     });
-    var actor = {
+
+    var actor = __assign({
       id: id,
       send: function () {
         return void 0;
@@ -1076,7 +1084,8 @@ function () {
       getSnapshot: function () {
         return resolvedData;
       }
-    };
+    }, interopSymbols);
+
     this.children.set(id, actor);
     return actor;
   };
@@ -1120,7 +1129,7 @@ function () {
       return this.spawnPromise(callbackStop, id);
     }
 
-    var actor = {
+    var actor = __assign({
       id: id,
       send: function (event) {
         return receivers.forEach(function (receiver) {
@@ -1150,7 +1159,8 @@ function () {
       getSnapshot: function () {
         return emitted;
       }
-    };
+    }, interopSymbols);
+
     this.children.set(id, actor);
     return actor;
   };
@@ -1178,7 +1188,8 @@ function () {
         origin: id
       }));
     });
-    var actor = {
+
+    var actor = __assign({
       id: id,
       send: function () {
         return void 0;
@@ -1197,7 +1208,8 @@ function () {
           id: id
         };
       }
-    };
+    }, interopSymbols);
+
     this.children.set(id, actor);
     return actor;
   };
@@ -1225,7 +1237,7 @@ function () {
   };
 
   Interpreter.prototype.spawnEffect = function (id, dispose) {
-    this.children.set(id, {
+    this.children.set(id, __assign({
       id: id,
       send: function () {
         return void 0;
@@ -1246,7 +1258,7 @@ function () {
           id: id
         };
       }
-    });
+    }, interopSymbols));
   };
 
   Interpreter.prototype.attachDev = function () {

package/es/stateUtils.d.ts

@@ -4,7 +4,7 @@ declare type AdjList<TC, TE extends EventObject> = Map<StateNode<TC, any, TE>, A
 export declare const isLeafNode: (stateNode: StateNode<any, 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, any>): Array<StateNode<TC, any, TE, any>>;
-export declare function getConfiguration<TC, TE extends EventObject>(prevStateNodes: Iterable<StateNode<TC, any, TE, any>>, stateNodes: Iterable<StateNode<TC, any, TE, any>>): Iterable<StateNode<TC, any, TE, any>>;
+export declare function getConfiguration<TC, TE extends EventObject>(prevStateNodes: Iterable<StateNode<TC, any, TE, any>>, stateNodes: Iterable<StateNode<TC, any, TE, any>>): Set<StateNode<TC, any, TE, any>>;
 export declare function getAdjList<TC, TE extends EventObject>(configuration: Configuration<TC, TE>): AdjList<TC, TE>;
 export declare function getValue<TC, TE extends EventObject>(rootNode: StateNode<TC, any, TE, any>, configuration: Configuration<TC, TE>): StateValue;
 export declare function has<T>(iterable: Iterable<T>, item: T): boolean;

package/es/types.d.ts

@@ -4,6 +4,7 @@ import { Interpreter, Clock } from './interpreter';
 import { IsNever, Model, Prop } from './model.types';
 declare type AnyFunction = (...args: any[]) => any;
 declare type ReturnTypeOrValue<T> = T extends AnyFunction ? ReturnType<T> : T;
+export declare type Cast<A, B> = A extends B ? A : B;
 export declare type EventType = string;
 export declare type ActionType = string;
 export declare type MetaObject = Record<string, any>;
@@ -34,7 +35,7 @@ export interface ActionObject<TContext, TEvent extends EventObject> extends Base
     /**
      * The implementation for executing the action.
      */
-    exec?: ActionFunction<TContext, TEvent>;
+    exec?: ActionFunction<TContext, TEvent> | undefined;
 }
 export declare type DefaultContext = Record<string, any> | undefined;
 export declare type EventData = Record<string, any> & {
@@ -106,7 +107,7 @@ export interface TransitionConfig<TContext, TEvent extends EventObject> {
     actions?: Actions<TContext, TEvent>;
     in?: StateValue;
     internal?: boolean;
-    target?: TransitionTarget<TContext, TEvent>;
+    target?: TransitionTarget<TContext, TEvent> | undefined;
     meta?: Record<string, any>;
     description?: string;
 }
@@ -345,7 +346,7 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
      *
      * This is equivalent to defining a `[done(id)]` transition on this state node's `on` property.
      */
-    onDone?: string | SingleOrArray<TransitionConfig<TContext, DoneEventObject>>;
+    onDone?: string | SingleOrArray<TransitionConfig<TContext, DoneEventObject>> | undefined;
     /**
      * The mapping (or array) of delays (in milliseconds) to their potential transition(s).
      * The delayed transitions are taken after the specified delay in an interpreter.
@@ -915,18 +916,21 @@ export interface Observer<T> {
 export interface Subscription {
     unsubscribe(): void;
 }
+export interface InteropObservable<T> {
+    [Symbol.observable]: () => Subscribable<T>;
+}
 export interface Subscribable<T> {
     subscribe(next: (value: T) => void, error?: (error: any) => void, complete?: () => void): Subscription;
     subscribe(observer: Observer<T>): Subscription;
 }
-export declare type Spawnable = StateMachine<any, any, any> | PromiseLike<any> | InvokeCallback | Subscribable<any> | Behavior<any>;
+export declare type Spawnable = StateMachine<any, any, any> | PromiseLike<any> | InvokeCallback | InteropObservable<any> | Subscribable<any> | Behavior<any>;
 export declare type ExtractEvent<TEvent extends EventObject, TEventType extends TEvent['type']> = TEvent extends {
     type: TEventType;
 } ? TEvent : never;
 export interface BaseActorRef<TEvent extends EventObject> {
     send: (event: TEvent) => void;
 }
-export interface ActorRef<TEvent extends EventObject, TEmitted = any> extends Subscribable<TEmitted> {
+export interface ActorRef<TEvent extends EventObject, TEmitted = any> extends Subscribable<TEmitted>, InteropObservable<TEmitted> {
     send: Sender<TEvent>;
     id: string;
     getSnapshot: () => TEmitted | undefined;
@@ -958,7 +962,7 @@ export interface Behavior<TEvent extends EventObject, TEmitted = any> {
     start?: (actorCtx: ActorContext<TEvent, TEmitted>) => TEmitted;
 }
 export declare type EmittedFrom<T> = ReturnTypeOrValue<T> extends infer R ? R extends ActorRef<infer _, infer TEmitted> ? TEmitted : R extends Behavior<infer _, infer TEmitted> ? TEmitted : R extends ActorContext<infer _, infer TEmitted> ? TEmitted : never : never;
-declare type ResolveEventType<T> = ReturnTypeOrValue<T> extends infer R ? R extends StateMachine<infer _, infer __, infer TEvent, infer ____> ? TEvent : R extends Model<infer _, infer TEvent, infer ___, infer ____> ? TEvent : R extends State<infer _, infer TEvent, infer ___, infer ____> ? TEvent : R extends Interpreter<infer _, infer __, infer TEvent, infer ____> ? TEvent : never : never;
+declare type ResolveEventType<T> = ReturnTypeOrValue<T> extends infer R ? R extends StateMachine<infer _, infer __, infer TEvent, infer ____> ? TEvent : R extends Model<infer _, infer TEvent, infer ___, infer ____> ? TEvent : R extends State<infer _, infer TEvent, infer ___, infer ____> ? TEvent : R extends Interpreter<infer _, infer __, infer TEvent, infer ____> ? TEvent : R extends ActorRef<infer TEvent, infer _> ? TEvent : never : never;
 export declare type EventFrom<T, K extends Prop<TEvent, 'type'> = never, TEvent = ResolveEventType<T>> = IsNever<K> extends true ? TEvent : Extract<TEvent, {
     type: K;
 }>;

package/es/utils.d.ts

@@ -52,7 +52,11 @@ 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: any): value is Subscribable<T>;
-export declare const symbolObservable: any;
+export declare const symbolObservable: string | typeof Symbol.observable;
+export declare const interopSymbols: {
+    [x: string]: () => any;
+    [Symbol.observable]: () => any;
+};
 export declare function isMachine(value: any): value is StateMachine<any, any, any>;
 export declare function isActor(value: any): value is Actor;
 export declare const uniqueId: () => string;
@@ -66,4 +70,5 @@ export declare function reportUnhandledExceptionOnInvocation(originalError: any,
 export declare function evaluateGuard<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent, any>, guard: Guard<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>, state: State<TContext, TEvent>): boolean;
 export declare function toInvokeSource(src: string | InvokeSourceDefinition): InvokeSourceDefinition;
 export declare function toObserver<T>(nextHandler: Observer<T> | ((value: T) => void), errorHandler?: (error: any) => void, completionHandler?: () => void): Observer<T>;
+export declare function createInvokeId(stateNodeId: string, index: number): string;
 //# sourceMappingURL=utils.d.ts.map

package/es/utils.js

@@ -2,6 +2,7 @@ import { __spreadArray, __read, __values, __assign } from './_virtual/_tslib.js'
 import { DEFAULT_GUARD_TYPE, TARGETLESS_KEY, STATE_DELIMITER } from './constants.js';
 import { IS_PRODUCTION } from './environment.js';
 
+var _a;
 function keys(value) {
   return Object.keys(value);
 }
@@ -460,6 +461,9 @@ function isObservable(value) {
 var symbolObservable = /*#__PURE__*/function () {
   return typeof Symbol === 'function' && Symbol.observable || '@@observable';
 }();
+var interopSymbols = (_a = {}, _a[symbolObservable] = function () {
+  return this;
+}, _a);
 function isMachine(value) {
   try {
     return '__xstatenode' in value;
@@ -580,5 +584,8 @@ function toObserver(nextHandler, errorHandler, completionHandler) {
     complete: completionHandler || noop
   };
 }
+function createInvokeId(stateNodeId, index) {
+  return "".concat(stateNodeId, ":invocation[").concat(index, "]");
+}
 
-export { evaluateGuard, flatten, getEventType, isActor, isArray, isBehavior, isBuiltInEvent, isFunction, isMachine, isObservable, isPromiseLike, isStateLike, isString, keys, mapContext, mapFilterValues, mapValues, matchesState, nestedPath, normalizeTarget, partition, path, pathToStateValue, reportUnhandledExceptionOnInvocation, symbolObservable, toArray, toArrayStrict, toEventObject, toGuard, toInvokeSource, toObserver, toSCXMLEvent, toStatePath, toStatePaths, toStateValue, toTransitionConfigArray, uniqueId, updateContext, updateHistoryStates, updateHistoryValue, warn };
+export { createInvokeId, evaluateGuard, flatten, getEventType, interopSymbols, isActor, isArray, isBehavior, isBuiltInEvent, isFunction, isMachine, isObservable, isPromiseLike, isStateLike, isString, keys, mapContext, mapFilterValues, mapValues, matchesState, nestedPath, normalizeTarget, partition, path, pathToStateValue, reportUnhandledExceptionOnInvocation, symbolObservable, toArray, toArrayStrict, toEventObject, toGuard, toInvokeSource, toObserver, toSCXMLEvent, toStatePath, toStatePaths, toStateValue, toTransitionConfigArray, uniqueId, updateContext, updateHistoryStates, updateHistoryValue, warn };

package/lib/Actor.js

@@ -7,7 +7,7 @@ var utils = require('./utils.js');
 var serviceScope = require('./serviceScope.js');
 
 function createNullActor(id) {
-  return {
+  return _tslib.__assign({
     id: id,
     send: function () {
       return void 0;
@@ -27,7 +27,7 @@ function createNullActor(id) {
         id: id
       };
     }
-  };
+  }, utils.interopSymbols);
 }
 /**
  * Creates a deferred actor that is able to be invoked given the provided
@@ -76,7 +76,7 @@ function isSpawnedActor(item) {
   return isActor(item) && 'id' in item;
 }
 function toActorRef(actorRefLike) {
-  return _tslib.__assign({
+  return _tslib.__assign(_tslib.__assign({
     subscribe: function () {
       return {
         unsubscribe: function () {
@@ -88,7 +88,7 @@ function toActorRef(actorRefLike) {
     getSnapshot: function () {
       return undefined;
     }
-  }, actorRefLike);
+  }, utils.interopSymbols), actorRefLike);
 }
 
 exports.createDeferredActor = createDeferredActor;

package/lib/State.d.ts

@@ -107,7 +107,10 @@ export declare class State<TContext, TEvent extends EventObject = EventObject, T
      */
     hasTag(tag: string): boolean;
     /**
-     * Determines whether sending the `event` will cause a transition.
+     * Determines whether sending the `event` will cause a non-forbidden transition
+     * to be selected, even if the transitions have no actions nor
+     * change the state value.
+     *
      * @param event The event to test
      * @returns Whether the event will cause a transition
      */

package/lib/State.js

@@ -249,7 +249,10 @@ function () {
     return this.tags.has(tag);
   };
   /**
-   * Determines whether sending the `event` will cause a transition.
+   * Determines whether sending the `event` will cause a non-forbidden transition
+   * to be selected, even if the transitions have no actions nor
+   * change the state value.
+   *
    * @param event The event to test
    * @returns Whether the event will cause a transition
    */
@@ -262,7 +265,11 @@ function () {
       utils.warn(!!this.machine, "state.can(...) used outside of a machine-created State object; this will always return false.");
     }
 
-    return !!((_a = this.machine) === null || _a === void 0 ? void 0 : _a.transition(this, event).changed);
+    var transitionData = (_a = this.machine) === null || _a === void 0 ? void 0 : _a.getTransitionData(this, event);
+    return !!(transitionData === null || transitionData === void 0 ? void 0 : transitionData.transitions.length) && // Check that at least one transition is not forbidden
+    transitionData.transitions.some(function (t) {
+      return t.target !== undefined || t.actions.length;
+    });
   };
 
   return State;

package/lib/StateNode.d.ts

@@ -1,4 +1,4 @@
-import { Event, StateValue, MachineOptions, EventObject, HistoryValue, StateNodeDefinition, TransitionDefinition, DelayedTransitionDefinition, ActivityDefinition, StateNodeConfig, StateSchema, StateNodesConfig, InvokeDefinition, ActionObject, Mapper, PropertyMapper, SCXML, Typestate, TransitionDefinitionMap, MachineSchema } from './types';
+import { Event, StateValue, StateTransition, MachineOptions, EventObject, HistoryValue, StateNodeDefinition, TransitionDefinition, DelayedTransitionDefinition, ActivityDefinition, StateNodeConfig, StateSchema, StateNodesConfig, InvokeDefinition, ActionObject, Mapper, PropertyMapper, SCXML, Typestate, TransitionDefinitionMap, MachineSchema } from './types';
 import { State } from './State';
 declare class StateNode<TContext = any, TStateSchema extends StateSchema = any, TEvent extends EventObject = EventObject, TTypestate extends Typestate<TContext> = {
     value: any;
@@ -182,6 +182,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
     private transitionCompoundNode;
     private transitionParallelNode;
     private _transition;
+    getTransitionData(state: State<TContext, TEvent, any, any>, event: Event<TEvent> | SCXML.Event<TEvent>): StateTransition<TContext, TEvent> | undefined;
     private next;
     private nodesFromChild;
     /**

package/lib/StateNode.js

@@ -159,29 +159,30 @@ function () {
       var _a, _b;
 
       if (utils.isMachine(invokeConfig)) {
-        _this.machine.options.services = _tslib.__assign((_a = {}, _a[invokeConfig.id] = invokeConfig, _a), _this.machine.options.services);
+        var invokeId = utils.createInvokeId(_this.id, i);
+        _this.machine.options.services = _tslib.__assign((_a = {}, _a[invokeId] = invokeConfig, _a), _this.machine.options.services);
         return invokeUtils.toInvokeDefinition({
-          src: invokeConfig.id,
-          id: invokeConfig.id
+          src: invokeId,
+          id: invokeId
         });
       } else if (utils.isString(invokeConfig.src)) {
+        var invokeId = invokeConfig.id || utils.createInvokeId(_this.id, i);
         return invokeUtils.toInvokeDefinition(_tslib.__assign(_tslib.__assign({}, invokeConfig), {
-          id: invokeConfig.id || invokeConfig.src,
+          id: invokeId,
           src: invokeConfig.src
         }));
       } else if (utils.isMachine(invokeConfig.src) || utils.isFunction(invokeConfig.src)) {
-        var invokeSrc = "".concat(_this.id, ":invocation[").concat(i, "]"); // TODO: util function
-
-        _this.machine.options.services = _tslib.__assign((_b = {}, _b[invokeSrc] = invokeConfig.src, _b), _this.machine.options.services);
+        var invokeId = invokeConfig.id || utils.createInvokeId(_this.id, i);
+        _this.machine.options.services = _tslib.__assign((_b = {}, _b[invokeId] = invokeConfig.src, _b), _this.machine.options.services);
         return invokeUtils.toInvokeDefinition(_tslib.__assign(_tslib.__assign({
-          id: invokeSrc
+          id: invokeId
         }, invokeConfig), {
-          src: invokeSrc
+          src: invokeId
         }));
       } else {
         var invokeSource = invokeConfig.src;
         return invokeUtils.toInvokeDefinition(_tslib.__assign(_tslib.__assign({
-          id: invokeSource.type
+          id: utils.createInvokeId(_this.id, i)
         }, invokeConfig), {
           src: invokeSource
         }));
@@ -413,15 +414,11 @@ function () {
     }
 
     var subStateKeys = utils.keys(stateValue);
-    var subStateNodes = subStateKeys.map(function (subStateKey) {
-      return _this.getStateNode(subStateKey);
-    });
-    subStateNodes.push(this);
-    return subStateNodes.concat(subStateKeys.reduce(function (allSubStateNodes, subStateKey) {
-      var subStateNode = _this.getStateNode(subStateKey).getStateNodes(stateValue[subStateKey]);
-
-      return allSubStateNodes.concat(subStateNode);
-    }, []));
+    var subStateNodes = [this];
+    subStateNodes.push.apply(subStateNodes, _tslib.__spreadArray([], _tslib.__read(utils.flatten(subStateKeys.map(function (subStateKey) {
+      return _this.getStateNode(subStateKey).getStateNodes(stateValue[subStateKey]);
+    }))), false));
+    return subStateNodes;
   };
   /**
    * Returns `true` if this state node explicitly handles the given event.
@@ -560,6 +557,10 @@ function () {
     return this.transitionParallelNode(stateValue, state, _event);
   };
 
+  StateNode.prototype.getTransitionData = function (state, event) {
+    return this._transition(state.value, state, utils.toSCXMLEvent(event));
+  };
+
   StateNode.prototype.next = function (state, _event) {
     var e_3, _a;
 
@@ -728,12 +729,6 @@ function () {
       }
     }
 
-    if (!transition.source) {
-      transition.exitSet = []; // Ensure that root StateNode (machine) is entered
-
-      transition.entrySet.push(this);
-    }
-
     var doneEvents = utils.flatten(transition.entrySet.map(function (sn) {
       var events = [];
 
@@ -832,7 +827,7 @@ function () {
     var prevConfig = stateUtils.getConfiguration([], this.getStateNodes(currentState.value));
     var resolvedConfig = stateTransition.configuration.length ? stateUtils.getConfiguration(prevConfig, stateTransition.configuration) : prevConfig;
     stateTransition.configuration = _tslib.__spreadArray([], _tslib.__read(resolvedConfig), false);
-    return this.resolveTransition(stateTransition, currentState, _event);
+    return this.resolveTransition(stateTransition, currentState, currentState.context, _event);
   };
 
   StateNode.prototype.resolveRaisedTransition = function (state, _event, originalEvent) {
@@ -850,7 +845,7 @@ function () {
     return state;
   };
 
-  StateNode.prototype.resolveTransition = function (stateTransition, currentState, _event, context) {
+  StateNode.prototype.resolveTransition = function (stateTransition, currentState, context, _event) {
     var e_6, _a;
 
     var _this = this;
@@ -859,10 +854,6 @@ function () {
       _event = actions.initEvent;
     }
 
-    if (context === void 0) {
-      context = this.machine.context;
-    }
-
     var configuration = stateTransition.configuration; // Transition will "apply" if:
     // - this is the initial state (there is no current state)
     // - OR there are transitions
@@ -870,8 +861,7 @@ function () {
     var willTransition = !currentState || stateTransition.transitions.length > 0;
     var resolvedStateValue = willTransition ? stateUtils.getValue(this.machine, configuration) : undefined;
     var historyValue = currentState ? currentState.historyValue ? currentState.historyValue : stateTransition.source ? this.machine.historyValue(currentState.value) : undefined : undefined;
-    var currentContext = currentState ? currentState.context : context;
-    var actions$1 = this.getActions(stateTransition, currentContext, _event, currentState);
+    var actions$1 = this.getActions(stateTransition, context, _event, currentState);
     var activities = currentState ? _tslib.__assign({}, currentState.activities) : {};
 
     try {
@@ -896,7 +886,7 @@ function () {
       }
     }
 
-    var _b = _tslib.__read(actions.resolveActions(this, currentState, currentContext, _event, actions$1, this.machine.config.preserveActionOrder), 2),
+    var _b = _tslib.__read(actions.resolveActions(this, currentState, context, _event, actions$1, this.machine.config.preserveActionOrder), 2),
         resolvedActions = _b[0],
         updatedContext = _b[1];
 
@@ -915,7 +905,7 @@ function () {
       acc[action.activity.id] = Actor.createInvocableActor(action.activity, _this.machine, updatedContext, _event);
       return acc;
     }, currentState ? _tslib.__assign({}, currentState.children) : {});
-    var resolvedConfiguration = resolvedStateValue ? stateTransition.configuration : currentState ? currentState.configuration : [];
+    var resolvedConfiguration = willTransition ? stateTransition.configuration : currentState ? currentState.configuration : [];
     var isDone = stateUtils.isInFinalState(resolvedConfiguration, this);
     var nextState = new State.State({
       value: resolvedStateValue || currentState.value,
@@ -935,7 +925,7 @@ function () {
       tags: currentState === null || currentState === void 0 ? void 0 : currentState.tags,
       machine: this
     });
-    var didUpdateContext = currentContext !== updatedContext;
+    var didUpdateContext = context !== updatedContext;
     nextState.changed = _event.name === actionTypes.update || didUpdateContext; // Dispose of penultimate histories to prevent memory leaks
 
     var history = nextState.history;
@@ -1163,7 +1153,7 @@ function () {
       transitions: [],
       source: undefined,
       actions: []
-    }, undefined, undefined, context);
+    }, undefined, context !== null && context !== void 0 ? context : this.machine.context, undefined);
   };
 
   Object.defineProperty(StateNode.prototype, "initialState", {

package/lib/actions.d.ts

@@ -1,8 +1,8 @@
-import { Action, Event, EventObject, SingleOrArray, SendAction, SendActionOptions, CancelAction, ActionObject, ActionType, Assigner, PropertyAssigner, AssignAction, ActionFunction, ActionFunctionMap, ActivityActionObject, ActionTypes, ActivityDefinition, RaiseAction, RaiseActionObject, DoneEvent, ErrorPlatformEvent, DoneEventObject, SendExpr, SendActionObject, PureAction, LogExpr, LogAction, LogActionObject, DelayFunctionMap, SCXML, ExprWithMeta, ChooseCondition, ChooseAction, AnyEventObject, Expr } from './types';
+import { Action, Event, EventObject, SingleOrArray, SendAction, SendActionOptions, CancelAction, ActionObject, ActionType, Assigner, PropertyAssigner, AssignAction, ActionFunction, ActionFunctionMap, ActivityActionObject, ActionTypes, ActivityDefinition, RaiseAction, RaiseActionObject, DoneEvent, ErrorPlatformEvent, DoneEventObject, SendExpr, SendActionObject, PureAction, LogExpr, LogAction, LogActionObject, DelayFunctionMap, SCXML, ExprWithMeta, ChooseCondition, ChooseAction, AnyEventObject, Expr, Cast } from './types';
 import * as actionTypes from './actionTypes';
 import { State } from './State';
 import { StateNode } from './StateNode';
-import { StopAction, StopActionObject } from '.';
+import { ActorRef, EventFrom, StopAction, StopActionObject } from '.';
 export { actionTypes };
 export declare const initEvent: SCXML.Event<{
     type: ActionTypes;
@@ -38,6 +38,22 @@ export declare function resolveSend<TContext, TEvent extends EventObject, TSentE
  * @param options Options to pass into the send event.
  */
 export declare function sendParent<TContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: Event<TSentEvent> | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, TSentEvent>;
+declare type InferEvent<E extends EventObject> = {
+    [T in E['type']]: {
+        type: T;
+    } & Extract<E, {
+        type: T;
+    }>;
+}[E['type']];
+/**
+ * Sends an event to an actor.
+ *
+ * @param actor The `ActorRef` to send the event to.
+ * @param event The event to send, or an expression that evaluates to the event to send
+ * @param options Send action options
+ * @returns An XState send action object
+ */
+export declare function sendTo<TContext, TEvent extends EventObject, TActor extends ActorRef<EventObject>>(actor: (ctx: TContext) => TActor, event: EventFrom<TActor> | SendExpr<TContext, TEvent, InferEvent<Cast<EventFrom<TActor>, EventObject>>>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, any>;
 /**
  * Sends an update event to this machine's parent.
  */

package/lib/actions.js

@@ -156,6 +156,20 @@ function sendParent(event, options) {
     to: types.SpecialTargets.Parent
   }));
 }
+/**
+ * Sends an event to an actor.
+ *
+ * @param actor The `ActorRef` to send the event to.
+ * @param event The event to send, or an expression that evaluates to the event to send
+ * @param options Send action options
+ * @returns An XState send action object
+ */
+
+function sendTo(actor, event, options) {
+  return send(event, _tslib.__assign(_tslib.__assign({}, options), {
+    to: actor
+  }));
+}
 /**
  * Sends an update event to this machine's parent.
  */
@@ -524,6 +538,7 @@ exports.resolveStop = resolveStop;
 exports.respond = respond;
 exports.send = send;
 exports.sendParent = sendParent;
+exports.sendTo = sendTo;
 exports.sendUpdate = sendUpdate;
 exports.start = start;
 exports.stop = stop;

package/lib/index.d.ts

@@ -4,7 +4,7 @@ import { StateNode } from './StateNode';
 import { State } from './State';
 import { Machine, createMachine } from './Machine';
 import { Actor } from './Actor';
-import { raise, send, sendParent, sendUpdate, log, start, stop, assign, after, done, respond, doneInvoke, forwardTo, escalate, choose, pure } from './actions';
+import { raise, send, sendParent, sendTo, sendUpdate, log, start, stop, assign, after, done, respond, doneInvoke, forwardTo, escalate, choose, pure } from './actions';
 import { interpret, Interpreter, spawn, InterpreterStatus } from './interpreter';
 import { matchState } from './match';
 import { createSchema } from './schema';
@@ -12,6 +12,7 @@ declare const actions: {
     raise: typeof raise;
     send: typeof send;
     sendParent: typeof sendParent;
+    sendTo: typeof sendTo;
     sendUpdate: typeof sendUpdate;
     log: typeof log;
     cancel: (sendId: string | number) => import("./types").CancelAction;
@@ -28,4 +29,9 @@ declare const actions: {
 };
 export { Actor, Machine, StateNode, State, matchesState, mapState, actions, assign, send, sendParent, sendUpdate, forwardTo, interpret, Interpreter, InterpreterStatus, matchState, spawn, doneInvoke, createMachine, createSchema };
 export * from './types';
+declare global {
+    interface SymbolConstructor {
+        readonly observable: symbol;
+    }
+}
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -17,6 +17,7 @@ var actions = {
   raise: actions$1.raise,
   send: actions$1.send,
   sendParent: actions$1.sendParent,
+  sendTo: actions$1.sendTo,
   sendUpdate: actions$1.sendUpdate,
   log: actions$1.log,
   cancel: actions$1.cancel,

package/lib/interpreter.d.ts

@@ -21,11 +21,6 @@ export declare enum InterpreterStatus {
     Running = 1,
     Stopped = 2
 }
-declare global {
-    interface SymbolConstructor {
-        readonly observable: symbol;
-    }
-}
 export declare class Interpreter<TContext, TStateSchema extends StateSchema = any, TEvent extends EventObject = EventObject, TTypestate extends Typestate<TContext> = {
     value: any;
     context: TContext;