xstate 4.9.1 → 4.13.0

package/lib/Actor.js

@@ -1,5 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isActor = exports.createDeferredActor = exports.createInvocableActor = exports.createNullActor = void 0;
+var utils_1 = require("./utils");
+var serviceScope = require("./serviceScope");
 function createNullActor(id) {
     return {
         id: id,
@@ -14,17 +17,35 @@ function createNullActor(id) {
 }
 exports.createNullActor = createNullActor;
 /**
- * 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.
  */
-function createInvocableActor(invokeDefinition) {
-    var tempActor = createNullActor(invokeDefinition.id);
+function createInvocableActor(invokeDefinition, machine, context, _event) {
+    var _a;
+    var invokeSrc = utils_1.toInvokeSource(invokeDefinition.src);
+    var serviceCreator = (_a = machine === null || machine === void 0 ? void 0 : machine.options.services) === null || _a === void 0 ? void 0 : _a[invokeSrc.type];
+    var resolvedData = invokeDefinition.data
+        ? utils_1.mapContext(invokeDefinition.data, context, _event)
+        : undefined;
+    var tempActor = serviceCreator
+        ? createDeferredActor(serviceCreator, invokeDefinition.id, resolvedData)
+        : createNullActor(invokeDefinition.id);
     tempActor.meta = invokeDefinition;
     return tempActor;
 }
 exports.createInvocableActor = createInvocableActor;
+function createDeferredActor(entity, id, data) {
+    var tempActor = createNullActor(id);
+    tempActor.deferred = true;
+    if (utils_1.isMachine(entity)) {
+        // "mute" the existing service scope so potential spawned actors within the `.initialState` stay deferred here
+        tempActor.state = serviceScope.provide(undefined, function () { return (data ? entity.withContext(data) : entity).initialState; });
+    }
+    return tempActor;
+}
+exports.createDeferredActor = createDeferredActor;
 function isActor(item) {
     try {
         return typeof item.send === 'function';

package/lib/Machine.d.ts

@@ -1,5 +1,8 @@
 import { StateMachine, MachineOptions, DefaultContext, MachineConfig, StateSchema, EventObject, AnyEventObject, Typestate } from './types';
 export declare function Machine<TContext = any, TEvent extends EventObject = AnyEventObject>(config: MachineConfig<TContext, any, TEvent>, options?: Partial<MachineOptions<TContext, TEvent>>, initialContext?: TContext): StateMachine<TContext, any, TEvent>;
 export declare function Machine<TContext = DefaultContext, TStateSchema extends StateSchema = any, TEvent extends EventObject = AnyEventObject>(config: MachineConfig<TContext, TStateSchema, TEvent>, options?: Partial<MachineOptions<TContext, TEvent>>, initialContext?: TContext): StateMachine<TContext, TStateSchema, TEvent>;
-export declare function createMachine<TContext, TEvent extends EventObject = AnyEventObject, TTypestate extends Typestate<TContext> = any>(config: MachineConfig<TContext, any, TEvent>, options?: Partial<MachineOptions<TContext, TEvent>>): StateMachine<TContext, any, TEvent, TTypestate>;
+export declare function createMachine<TContext, TEvent extends EventObject = AnyEventObject, TTypestate extends Typestate<TContext> = {
+    value: any;
+    context: TContext;
+}>(config: MachineConfig<TContext, any, TEvent>, options?: Partial<MachineOptions<TContext, TEvent>>): StateMachine<TContext, any, TEvent, TTypestate>;
 //# sourceMappingURL=Machine.d.ts.map

package/lib/Machine.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMachine = exports.Machine = void 0;
 var StateNode_1 = require("./StateNode");
 function Machine(config, options, initialContext) {
     if (initialContext === void 0) { initialContext = config.context; }

package/lib/SimulatedClock.js

@@ -20,6 +20,7 @@ var __spread = (this && this.__spread) || function () {
     return ar;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimulatedClock = void 0;
 var SimulatedClock = /** @class */ (function () {
     function SimulatedClock() {
         this.timeouts = new Map();

package/lib/State.d.ts

@@ -2,13 +2,19 @@ import { StateValue, ActivityMap, EventObject, HistoryValue, ActionObject, Event
 import { StateNode } from './StateNode';
 import { Actor } from './Actor';
 export declare function stateValuesEqual(a: StateValue | undefined, b: StateValue | undefined): boolean;
-export declare function isState<TContext, TEvent extends EventObject>(state: object | string): state is State<TContext, TEvent>;
+export declare function isState<TContext, TEvent extends EventObject, TStateSchema extends StateSchema<TContext> = any, TTypestate extends Typestate<TContext> = {
+    value: any;
+    context: TContext;
+}>(state: object | string): state is State<TContext, TEvent, TStateSchema, TTypestate>;
 export declare function bindActionToState<TC, TE extends EventObject>(action: ActionObject<TC, TE>, state: State<TC, TE>): ActionObject<TC, TE>;
-export declare class State<TContext, TEvent extends EventObject = EventObject, TStateSchema extends StateSchema<TContext> = any, TTypestate extends Typestate<TContext> = any> {
+export declare class State<TContext, TEvent extends EventObject = EventObject, TStateSchema extends StateSchema<TContext> = any, TTypestate extends Typestate<TContext> = {
+    value: any;
+    context: TContext;
+}> {
     value: StateValue;
     context: TContext;
     historyValue?: HistoryValue | undefined;
-    history?: State<TContext, TEvent, TStateSchema>;
+    history?: State<TContext, TEvent, TStateSchema, TTypestate>;
     actions: Array<ActionObject<TContext, TEvent>>;
     activities: ActivityMap;
     meta: any;
@@ -86,8 +92,10 @@ export declare class State<TContext, TEvent extends EventObject = EventObject, T
      * Whether the current state value is a subset of the given parent state value.
      * @param parentStateValue
      */
-    matches<TSV extends TTypestate['value']>(parentStateValue: TSV): this is TTypestate extends {
+    matches<TSV extends TTypestate['value']>(parentStateValue: TSV): this is State<(TTypestate extends {
+        value: TSV;
+    } ? TTypestate : never)['context'], TEvent, TStateSchema, TTypestate> & {
         value: TSV;
-    } ? State<TTypestate['context'], TEvent, TStateSchema, TTypestate> : never;
+    };
 }
 //# sourceMappingURL=State.d.ts.map

package/lib/State.js

@@ -42,6 +42,7 @@ var __spread = (this && this.__spread) || function () {
     return ar;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.State = exports.bindActionToState = exports.isState = exports.stateValuesEqual = void 0;
 var constants_1 = require("./constants");
 var utils_1 = require("./utils");
 var stateUtils_1 = require("./stateUtils");

package/lib/StateNode.d.ts

@@ -1,6 +1,9 @@
 import { Event, StateValue, StateValueMap, MachineOptions, EventObject, HistoryValue, StateNodeDefinition, TransitionDefinition, DelayedTransitionDefinition, ActivityDefinition, StateNodeConfig, StateSchema, StateNodesConfig, InvokeDefinition, ActionObject, Mapper, PropertyMapper, SCXML, Typestate, TransitionDefinitionMap } from './types';
 import { State } from './State';
-declare class StateNode<TContext = any, TStateSchema extends StateSchema = any, TEvent extends EventObject = EventObject, TTypestate extends Typestate<TContext> = any> {
+declare class StateNode<TContext = any, TStateSchema extends StateSchema = any, TEvent extends EventObject = EventObject, TTypestate extends Typestate<TContext> = {
+    value: any;
+    context: TContext;
+}> {
     /**
      * The raw config used to create the machine.
      */
@@ -92,7 +95,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
     /**
      * The data sent with the "done.state._id_" event if this is a final state node.
      */
-    data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
+    doneData?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
     /**
      * The string delimiter for serializing the path to a string. The default is "."
      */
@@ -156,7 +159,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param state The state value or State instance
      */
-    getStateNodes(state: StateValue | State<TContext, TEvent>): Array<StateNode<TContext, any, TEvent>>;
+    getStateNodes(state: StateValue | State<TContext, TEvent, any, TTypestate>): Array<StateNode<TContext, any, TEvent>>;
     /**
      * Returns `true` if this state node explicitly handles the given event.
      *
@@ -170,7 +173,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param state The state to resolve
      */
-    resolveState(state: State<TContext, TEvent>): State<TContext, TEvent>;
+    resolveState(state: State<TContext, TEvent>): State<TContext, TEvent, TStateSchema, TTypestate>;
     private transitionLeafNode;
     private transitionCompoundNode;
     private transitionParallelNode;
@@ -190,7 +193,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      * @param event The event that was sent at the current state
      * @param context The current context (extended state) of the current state
      */
-    transition(state: string | StateValueMap | State<TContext, TEvent, any, any> | undefined, event: Event<TEvent> | SCXML.Event<TEvent>, context?: TContext): State<TContext, TEvent, TStateSchema, TTypestate>;
+    transition(state: string | StateValueMap | State<TContext, TEvent, any, TTypestate> | undefined, event: Event<TEvent> | SCXML.Event<TEvent>, context?: TContext): State<TContext, TEvent, TStateSchema, TTypestate>;
     private resolveRaisedTransition;
     private resolveTransition;
     /**

package/lib/StateNode.js

@@ -53,6 +53,7 @@ var __values = (this && this.__values) || function(o) {
     throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateNode = void 0;
 var utils_1 = require("./utils");
 var types_1 = require("./types");
 var utils_2 = require("./utils");
@@ -63,6 +64,7 @@ var environment_1 = require("./environment");
 var constants_1 = require("./constants");
 var stateUtils_1 = require("./stateUtils");
 var Actor_1 = require("./Actor");
+var invokeUtils_1 = require("./invokeUtils");
 var NULL_EVENT = '';
 var STATE_IDENTIFIER = '#';
 var WILDCARD = '*';
@@ -179,21 +181,23 @@ var StateNode = /** @class */ (function () {
         // History config
         this.history =
             this.config.history === true ? 'shallow' : this.config.history || false;
-        this._transient = !this.config.on
-            ? false
-            : Array.isArray(this.config.on)
-                ? this.config.on.some(function (_a) {
-                    var event = _a.event;
-                    return event === NULL_EVENT;
-                })
-                : NULL_EVENT in this.config.on;
+        this._transient =
+            !!this.config.always ||
+                (!this.config.on
+                    ? false
+                    : Array.isArray(this.config.on)
+                        ? this.config.on.some(function (_a) {
+                            var event = _a.event;
+                            return event === NULL_EVENT;
+                        })
+                        : NULL_EVENT in this.config.on);
         this.strict = !!this.config.strict;
         // TODO: deprecate (entry)
         this.onEntry = utils_1.toArray(this.config.entry || this.config.onEntry).map(function (action) { return actions_1.toActionObject(action); });
         // TODO: deprecate (exit)
         this.onExit = utils_1.toArray(this.config.exit || this.config.onExit).map(function (action) { return actions_1.toActionObject(action); });
         this.meta = this.config.meta;
-        this.data =
+        this.doneData =
             this.type === 'final'
                 ? this.config.data
                 : undefined;
@@ -201,25 +205,33 @@ var StateNode = /** @class */ (function () {
             var _a, _b;
             if (utils_1.isMachine(invokeConfig)) {
                 _this.machine.options.services = __assign((_a = {}, _a[invokeConfig.id] = invokeConfig, _a), _this.machine.options.services);
-                return {
-                    type: actionTypes.invoke,
+                return invokeUtils_1.toInvokeDefinition({
                     src: invokeConfig.id,
                     id: invokeConfig.id
-                };
+                });
+            }
+            else if (utils_1.isString(invokeConfig.src)) {
+                return invokeUtils_1.toInvokeDefinition(__assign(__assign({}, invokeConfig), { id: invokeConfig.id || invokeConfig.src, src: invokeConfig.src }));
             }
-            else if (typeof invokeConfig.src !== 'string') {
+            else if (utils_1.isMachine(invokeConfig.src) || utils_1.isFunction(invokeConfig.src)) {
                 var invokeSrc = _this.id + ":invocation[" + i + "]"; // TODO: util function
                 _this.machine.options.services = __assign((_b = {}, _b[invokeSrc] = invokeConfig.src, _b), _this.machine.options.services);
-                return __assign(__assign({ type: actionTypes.invoke, id: invokeSrc }, invokeConfig), { src: invokeSrc });
+                return invokeUtils_1.toInvokeDefinition(__assign(__assign({ id: invokeSrc }, invokeConfig), { src: invokeSrc }));
             }
             else {
-                return __assign(__assign({}, invokeConfig), { type: actionTypes.invoke, id: invokeConfig.id || invokeConfig.src, src: invokeConfig.src });
+                var invokeSource = invokeConfig.src;
+                return invokeUtils_1.toInvokeDefinition(__assign(__assign({ id: invokeSource.type }, invokeConfig), { src: invokeSource }));
             }
         });
         this.activities = utils_1.toArray(this.config.activities)
             .concat(this.invoke)
             .map(function (activity) { return actions_1.toActivityDefinition(activity); });
         this.transition = this.transition.bind(this);
+        // TODO: this is the real fix for initialization once
+        // state node getters are deprecated
+        // if (!this.parent) {
+        //   this._init();
+        // }
     }
     StateNode.prototype._init = function () {
         if (this.__cache.transitions) {
@@ -273,11 +285,11 @@ var StateNode = /** @class */ (function () {
                 activities: this.activities || [],
                 meta: this.meta,
                 order: this.order || -1,
-                data: this.data,
+                data: this.doneData,
                 invoke: this.invoke
             };
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     StateNode.prototype.toJSON = function () {
@@ -298,7 +310,7 @@ var StateNode = /** @class */ (function () {
                 return map;
             }, {}));
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(StateNode.prototype, "after", {
@@ -307,7 +319,7 @@ var StateNode = /** @class */ (function () {
                 ((this.__cache.delayedTransitions = this.getDelayedTransitions()),
                     this.__cache.delayedTransitions));
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(StateNode.prototype, "transitions", {
@@ -319,7 +331,7 @@ var StateNode = /** @class */ (function () {
                 ((this.__cache.transitions = this.formatTransitions()),
                     this.__cache.transitions));
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     StateNode.prototype.getCandidates = function (eventName) {
@@ -645,14 +657,16 @@ var StateNode = /** @class */ (function () {
             if (!parent.parent) {
                 return events;
             }
-            events.push(actions_1.done(sn.id, sn.data), // TODO: deprecate - final states should not emit done events for their own state.
-            actions_1.done(parent.id, sn.data ? utils_1.mapContext(sn.data, currentContext, _event) : undefined));
+            events.push(actions_1.done(sn.id, sn.doneData), // TODO: deprecate - final states should not emit done events for their own state.
+            actions_1.done(parent.id, sn.doneData
+                ? utils_1.mapContext(sn.doneData, currentContext, _event)
+                : undefined));
             var grandparent = parent.parent;
             if (grandparent.type === 'parallel') {
                 if (stateUtils_1.getChildren(grandparent).every(function (parentNode) {
                     return stateUtils_1.isInFinalState(transition.configuration, parentNode);
                 })) {
-                    events.push(actions_1.done(grandparent.id, grandparent.data));
+                    events.push(actions_1.done(grandparent.id));
                 }
             }
             return events;
@@ -678,7 +692,8 @@ var StateNode = /** @class */ (function () {
      * @param context The current context (extended state) of the current state
      */
     StateNode.prototype.transition = function (state, event, context) {
-        if (state === void 0) { state = this.initialState; }
+        if (state === void 0) { state = this
+            .initialState; }
         var _event = utils_1.toSCXMLEvent(event);
         var currentState;
         if (state instanceof State_1.State) {
@@ -722,6 +737,7 @@ var StateNode = /** @class */ (function () {
         var currentActions = state.actions;
         state = this.transition(state, _event);
         // Save original event to state
+        // TODO: this should be the raised event! Delete in V5 (breaking)
         state._event = originalEvent;
         state.event = originalEvent.data;
         (_a = state.actions).unshift.apply(_a, __spread(currentActions));
@@ -729,6 +745,7 @@ var StateNode = /** @class */ (function () {
     };
     StateNode.prototype.resolveTransition = function (stateTransition, currentState, _event, context) {
         var e_6, _a;
+        var _this = this;
         if (_event === void 0) { _event = actions_1.initEvent; }
         if (context === void 0) { context = this.machine.context; }
         var configuration = stateTransition.configuration;
@@ -753,10 +770,10 @@ var StateNode = /** @class */ (function () {
             for (var actions_2 = __values(actions), actions_2_1 = actions_2.next(); !actions_2_1.done; actions_2_1 = actions_2.next()) {
                 var action = actions_2_1.value;
                 if (action.type === actionTypes.start) {
-                    activities[action.activity.type] = action;
+                    activities[action.activity.id || action.activity.type] = action;
                 }
                 else if (action.type === actionTypes.stop) {
-                    activities[action.activity.type] = false;
+                    activities[action.activity.id || action.activity.type] = false;
                 }
             }
         }
@@ -780,7 +797,7 @@ var StateNode = /** @class */ (function () {
                     actionTypes.invoke);
         });
         var children = invokeActions.reduce(function (acc, action) {
-            acc[action.activity.id] = Actor_1.createInvocableActor(action.activity);
+            acc[action.activity.id] = Actor_1.createInvocableActor(action.activity, _this.machine, updatedContext, _event);
             return acc;
         }, currentState
             ? __assign({}, currentState.children) : {});
@@ -842,7 +859,9 @@ var StateNode = /** @class */ (function () {
         var maybeNextState = nextState;
         if (!isDone) {
             var isTransient = this._transient ||
-                configuration.some(function (stateNode) { return stateNode._transient; });
+                configuration.some(function (stateNode) {
+                    return stateNode._transient;
+                });
             if (isTransient) {
                 maybeNextState = this.resolveRaisedTransition(maybeNextState, {
                     type: actionTypes.nullEvent
@@ -999,7 +1018,7 @@ var StateNode = /** @class */ (function () {
             this.__cache.initialStateValue = initialStateValue;
             return this.__cache.initialStateValue;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     StateNode.prototype.getInitialState = function (stateValue, context) {
@@ -1019,14 +1038,14 @@ var StateNode = /** @class */ (function () {
          * entering the initial state.
          */
         get: function () {
-            this._init();
+            this._init(); // TODO: this should be in the constructor (see note in constructor)
             var initialStateValue = this.initialStateValue;
             if (!initialStateValue) {
                 throw new Error("Cannot retrieve initial state from simple state '" + this.id + "'.");
             }
             return this.getInitialState(initialStateValue);
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(StateNode.prototype, "target", {
@@ -1051,7 +1070,7 @@ var StateNode = /** @class */ (function () {
             }
             return target;
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     /**
@@ -1087,7 +1106,7 @@ var StateNode = /** @class */ (function () {
                 return _this.getFromRelativePath(initialPath);
             }));
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     /**
@@ -1171,7 +1190,7 @@ var StateNode = /** @class */ (function () {
             }));
             return [this.id].concat(childStateIds);
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(StateNode.prototype, "events", {
@@ -1217,7 +1236,7 @@ var StateNode = /** @class */ (function () {
             }
             return (this.__cache.events = Array.from(events));
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     Object.defineProperty(StateNode.prototype, "ownEvents", {
@@ -1236,7 +1255,7 @@ var StateNode = /** @class */ (function () {
                 .map(function (transition) { return transition.eventType; }));
             return Array.from(events);
         },
-        enumerable: true,
+        enumerable: false,
         configurable: true
     });
     StateNode.prototype.resolveTarget = function (_target) {
@@ -1280,12 +1299,9 @@ var StateNode = /** @class */ (function () {
                 : true;
         var guards = this.machine.options.guards;
         var target = this.resolveTarget(normalizedTarget);
-        var transition = __assign(__assign({}, transitionConfig), { actions: actions_1.toActionObjects(utils_1.toArray(transitionConfig.actions)), cond: utils_1.toGuard(transitionConfig.cond, guards), target: target, source: this, internal: internal, eventType: transitionConfig.event });
-        Object.defineProperty(transition, 'toJSON', {
-            value: function () { return (__assign(__assign({}, transition), { target: transition.target
+        var transition = __assign(__assign({}, transitionConfig), { actions: actions_1.toActionObjects(utils_1.toArray(transitionConfig.actions)), cond: utils_1.toGuard(transitionConfig.cond, guards), target: target, source: this, internal: internal, eventType: transitionConfig.event, toJSON: function () { return (__assign(__assign({}, transition), { target: transition.target
                     ? transition.target.map(function (t) { return "#" + t.id; })
-                    : undefined, source: "#{this.id}" })); }
-        });
+                    : undefined, source: "#" + _this.id })); } });
         return transition;
     };
     StateNode.prototype.formatTransitions = function () {
@@ -1299,20 +1315,30 @@ var StateNode = /** @class */ (function () {
             onConfig = this.config.on;
         }
         else {
-            var _b = this.config.on, _c = WILDCARD, _d = _b[_c], wildcardConfigs = _d === void 0 ? [] : _d, strictOnConfigs_1 = __rest(_b, [typeof _c === "symbol" ? _c : _c + ""]);
-            onConfig = utils_1.flatten(utils_1.keys(strictOnConfigs_1)
+            var _b = this.config.on, _c = WILDCARD, _d = _b[_c], wildcardConfigs = _d === void 0 ? [] : _d, strictTransitionConfigs_1 = __rest(_b, [typeof _c === "symbol" ? _c : _c + ""]);
+            onConfig = utils_1.flatten(utils_1.keys(strictTransitionConfigs_1)
                 .map(function (key) {
-                var arrayified = utils_1.toTransitionConfigArray(key, strictOnConfigs_1[key]);
+                if (!environment_1.IS_PRODUCTION && key === NULL_EVENT) {
+                    utils_1.warn(false, "Empty string transition configs (e.g., `{ on: { '': ... }}`) for transient transitions are deprecated. Specify the transition in the `{ always: ... }` property instead. " +
+                        ("Please check the `on` configuration for \"#" + _this.id + "\"."));
+                }
+                var transitionConfigArray = utils_1.toTransitionConfigArray(key, strictTransitionConfigs_1[key]);
                 if (!environment_1.IS_PRODUCTION) {
-                    validateArrayifiedTransitions(_this, key, arrayified);
+                    validateArrayifiedTransitions(_this, key, transitionConfigArray);
                 }
-                return arrayified;
+                return transitionConfigArray;
             })
                 .concat(utils_1.toTransitionConfigArray(WILDCARD, wildcardConfigs)));
         }
+        var eventlessConfig = this.config.always
+            ? utils_1.toTransitionConfigArray('', this.config.always)
+            : [];
         var doneConfig = this.config.onDone
             ? utils_1.toTransitionConfigArray(String(actions_1.done(this.id)), this.config.onDone)
             : [];
+        if (!environment_1.IS_PRODUCTION) {
+            utils_1.warn(!(this.config.onDone && !this.parent), "Root nodes cannot have an \".onDone\" transition. Please check the config of \"" + this.id + "\".");
+        }
         var invokeConfig = utils_1.flatten(this.invoke.map(function (invokeDef) {
             var settleTransitions = [];
             if (invokeDef.onDone) {
@@ -1324,7 +1350,7 @@ var StateNode = /** @class */ (function () {
             return settleTransitions;
         }));
         var delayedTransitions = this.after;
-        var formattedTransitions = utils_1.flatten(__spread(doneConfig, invokeConfig, onConfig).map(function (transitionConfig) {
+        var formattedTransitions = utils_1.flatten(__spread(doneConfig, invokeConfig, onConfig, eventlessConfig).map(function (transitionConfig) {
             return utils_1.toArray(transitionConfig).map(function (transition) {
                 return _this.formatTransition(transition);
             });

package/lib/actionTypes.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.pure = exports.choose = exports.update = exports.error = exports.errorPlatform = exports.errorExecution = exports.invoke = exports.init = exports.log = exports.doneState = exports.after = exports.assign = exports.nullEvent = exports.cancel = exports.send = exports.raise = exports.stop = exports.start = void 0;
 var types_1 = require("./types");
 // xstate-specific action types
 exports.start = types_1.ActionTypes.Start;

package/lib/actions.d.ts

@@ -1,4 +1,4 @@
-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, ChooseConditon, ChooseAction } 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, ChooseConditon, ChooseAction, AnyEventObject } from './types';
 import * as actionTypes from './actionTypes';
 import { State } from './State';
 import { StateNode } from './StateNode';
@@ -8,7 +8,7 @@ export declare const initEvent: SCXML.Event<{
 }>;
 export declare function getActionFunction<TContext, TEvent extends EventObject>(actionType: ActionType, actionFunctionMap?: ActionFunctionMap<TContext, TEvent>): ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent> | undefined;
 export declare function toActionObject<TContext, TEvent extends EventObject>(action: Action<TContext, TEvent>, actionFunctionMap?: ActionFunctionMap<TContext, TEvent>): ActionObject<TContext, TEvent>;
-export declare const toActionObjects: <TContext, TEvent extends EventObject>(action?: string | RaiseAction<import("./types").AnyEventObject> | ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent> | AssignAction<Required<TContext>, TEvent> | SendAction<TContext, import("./types").AnyEventObject> | ChooseAction<TContext, TEvent> | Action<TContext, TEvent>[] | undefined, actionFunctionMap?: Record<string, ActionFunction<TContext, TEvent> | ActionObject<TContext, TEvent>> | undefined) => ActionObject<TContext, TEvent>[];
+export declare const toActionObjects: <TContext, TEvent extends EventObject>(action?: string | ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent> | Action<TContext, TEvent>[] | undefined, actionFunctionMap?: Record<string, ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent>> | undefined) => ActionObject<TContext, TEvent>[];
 export declare function toActivityDefinition<TContext, TEvent extends EventObject>(action: string | ActivityDefinition<TContext, TEvent>): ActivityDefinition<TContext, TEvent>;
 /**
  * Raises an event. This places the event in the internal event queue, so that
@@ -16,7 +16,7 @@ export declare function toActivityDefinition<TContext, TEvent extends EventObjec
  *
  * @param eventType The event to raise.
  */
-export declare function raise<TContext, TEvent extends EventObject>(event: Event<TEvent>): RaiseAction<TEvent> | SendAction<TContext, TEvent>;
+export declare function raise<TContext, TEvent extends EventObject>(event: Event<TEvent>): RaiseAction<TEvent> | SendAction<TContext, AnyEventObject, TEvent>;
 export declare function resolveRaise<TEvent extends EventObject>(action: RaiseAction<TEvent>): RaiseActionObject<TEvent>;
 /**
  * Sends an event. This returns an action that will be read by an interpreter to
@@ -28,26 +28,28 @@ export declare function resolveRaise<TEvent extends EventObject>(action: RaiseAc
  *  - `delay` - The number of milliseconds to delay the sending of the event.
  *  - `to` - The target of this event (by default, the machine the event was sent from).
  */
-export declare function send<TContext, TEvent extends EventObject>(event: Event<TEvent> | SendExpr<TContext, TEvent>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent>;
-export declare function resolveSend<TContext, TEvent extends EventObject>(action: SendAction<TContext, TEvent>, ctx: TContext, _event: SCXML.Event<TEvent>, delaysMap?: DelayFunctionMap<TContext, TEvent>): SendActionObject<TContext, TEvent>;
+export declare function send<TContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: Event<TSentEvent> | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, TSentEvent>;
+export declare function resolveSend<TContext, TEvent extends EventObject, TSentEvent extends EventObject>(action: SendAction<TContext, TEvent, TSentEvent>, ctx: TContext, _event: SCXML.Event<TEvent>, delaysMap?: DelayFunctionMap<TContext, TEvent>): SendActionObject<TContext, TEvent, TSentEvent>;
 /**
  * Sends an event to this machine's parent.
  *
  * @param event The event to send to the parent machine.
  * @param options Options to pass into the send event.
  */
-export declare function sendParent<TContext, TEvent extends EventObject>(event: Event<any> | SendExpr<TContext, TEvent>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent>;
+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>;
 /**
  * Sends an update event to this machine's parent.
  */
-export declare function sendUpdate<TContext, TEvent extends EventObject>(): SendAction<TContext, TEvent>;
+export declare function sendUpdate<TContext, TEvent extends EventObject>(): SendAction<TContext, TEvent, {
+    type: ActionTypes.Update;
+}>;
 /**
  * Sends an event back to the sender of the original event.
  *
  * @param event The event to send back to the sender
  * @param options Options to pass into the send event
  */
-export declare function respond<TContext, TEvent extends EventObject>(event: Event<TEvent> | SendExpr<TContext, TEvent>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent>;
+export declare function respond<TContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: Event<TEvent> | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, AnyEventObject>;
 /**
  *
  * @param expr The expression function to evaluate which will be logged.
@@ -119,7 +121,7 @@ export declare function pure<TContext, TEvent extends EventObject>(getActions: (
  * @param target The target service to forward the event to.
  * @param options Options to pass into the send action creator.
  */
-export declare function forwardTo<TContext, TEvent extends EventObject>(target: Required<SendActionOptions<TContext, TEvent>>['to'], options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent>;
+export declare function forwardTo<TContext, TEvent extends EventObject>(target: Required<SendActionOptions<TContext, TEvent>>['to'], options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, AnyEventObject>;
 /**
  * Escalates an error by sending it as an event to this machine's parent.
  *
@@ -127,7 +129,7 @@ export declare function forwardTo<TContext, TEvent extends EventObject>(target:
  * takes in the `context`, `event`, and `meta`, and returns the error data to send.
  * @param options Options to pass into the send action creator.
  */
-export declare function escalate<TContext, TEvent extends EventObject, TErrorData = any>(errorData: TErrorData | ExprWithMeta<TContext, TEvent, TErrorData>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent>;
+export declare function escalate<TContext, TEvent extends EventObject, TErrorData = any>(errorData: TErrorData | ExprWithMeta<TContext, TEvent, TErrorData>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, AnyEventObject>;
 export declare function choose<TContext, TEvent extends EventObject>(conds: Array<ChooseConditon<TContext, TEvent>>): ChooseAction<TContext, TEvent>;
 export declare function resolveActions<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent>, currentState: State<TContext, TEvent> | undefined, currentContext: TContext, _event: SCXML.Event<TEvent>, actions: Array<ActionObject<TContext, TEvent>>): [Array<ActionObject<TContext, TEvent>>, TContext];
 //# sourceMappingURL=actions.d.ts.map