xstate 5.0.0-beta.45 → 5.0.0-beta.47

package/dist/{raise-2b5a4e4c.esm.js → raise-91ec8b4f.esm.js}

@@ -316,6 +316,9 @@ function resolveReferencedActor(machine, src) {
   }
   return machine.implementations.actors[src];
 }
+function getAllOwnEventDescriptors(snapshot) {
+  return [...new Set(flatten([...snapshot._nodes.map(sn => sn.ownEvents)]))];
+}
 
 const $$ACTOR_TYPE = 1;
 // those values are currently used by @xstate/react directly so it's important to keep the assigned values in sync
@@ -342,32 +345,6 @@ const defaultOptions = {
  * An Actor is a running process that can receive events, send events and change its behavior based on the events it receives, which can cause effects outside of the actor. When you run a state machine, it becomes an actor.
  */
 class Actor {
-  /**
-   * The current internal state of the actor.
-   */
-
-  /**
-   * The clock that is responsible for setting and clearing timeouts, such as delayed events and transitions.
-   */
-
-  /**
-   * The unique identifier for this actor relative to its parent.
-   */
-
-  /** @internal */
-
-  // Actor Ref
-
-  // TODO: add typings for system
-
-  /**
-   * The globally unique process ID for this invocation.
-   */
-
-  /**
-   * The system to which this actor belongs.
-   */
-
   /**
    * Creates a new actor instance for the given logic with the provided options, if any.
    *
@@ -376,24 +353,43 @@ class Actor {
    */
   constructor(logic, options) {
     this.logic = logic;
+    /**
+     * The current internal state of the actor.
+     */
     this._state = void 0;
+    /**
+     * The clock that is responsible for setting and clearing timeouts, such as delayed events and transitions.
+     */
     this.clock = void 0;
     this.options = void 0;
+    /**
+     * The unique identifier for this actor relative to its parent.
+     */
     this.id = void 0;
     this.mailbox = new Mailbox(this._process.bind(this));
     this.delayedEventsMap = {};
     this.observers = new Set();
     this.logger = void 0;
+    /** @internal */
     this._processingStatus = ProcessingStatus.NotStarted;
+    // Actor Ref
     this._parent = void 0;
     this._syncSnapshot = void 0;
     this.ref = void 0;
+    // TODO: add typings for system
     this._actorScope = void 0;
     this._systemId = void 0;
+    /**
+     * The globally unique process ID for this invocation.
+     */
     this.sessionId = void 0;
+    /**
+     * The system to which this actor belongs.
+     */
     this.system = void 0;
     this._doneEvent = void 0;
     this.src = void 0;
+    // array of functions to defer
     this._deferred = [];
     const resolvedOptions = {
       ...defaultOptions,
@@ -458,9 +454,6 @@ class Actor {
   _initState(persistedState) {
     this._state = persistedState ? this.logic.restoreState ? this.logic.restoreState(persistedState, this._actorScope) : persistedState : this.logic.getInitialState(this._actorScope, this.options?.input);
   }
-
-  // array of functions to defer
-
   update(snapshot, event) {
     // Update state
     this._state = snapshot;
@@ -946,23 +939,23 @@ function executeSpawn(actorScope, {
     }
   });
 }
-function spawn(...[src, {
+function spawnChild(...[src, {
   id,
   systemId,
   input,
   syncSnapshot = false
 } = {}]) {
-  function spawn(args, params) {
+  function spawnChild(args, params) {
   }
-  spawn.type = 'xstate.spawn';
-  spawn.id = id;
-  spawn.systemId = systemId;
-  spawn.src = src;
-  spawn.input = input;
-  spawn.syncSnapshot = syncSnapshot;
-  spawn.resolve = resolveSpawn;
-  spawn.execute = executeSpawn;
-  return spawn;
+  spawnChild.type = 'xstate.spawnChild';
+  spawnChild.id = id;
+  spawnChild.systemId = systemId;
+  spawnChild.src = src;
+  spawnChild.input = input;
+  spawnChild.syncSnapshot = syncSnapshot;
+  spawnChild.resolve = resolveSpawn;
+  spawnChild.execute = executeSpawn;
+  return spawnChild;
 }
 
 function resolveStop(_, state, args, actionParams, {
@@ -1006,20 +999,27 @@ function executeStop(actorScope, actorRef) {
   });
 }
 /**
- * Stops an actor.
+ * Stops a child actor.
  *
  * @param actorRef The actor to stop.
  */
-function stop(actorRef) {
+function stopChild(actorRef) {
   function stop(args, params) {
   }
-  stop.type = 'xstate.stop';
+  stop.type = 'xstate.stopChild';
   stop.actorRef = actorRef;
   stop.resolve = resolveStop;
   stop.execute = executeStop;
   return stop;
 }
 
+/**
+ * Stops a child actor.
+ *
+ * @deprecated Use `stopChild(...)` instead
+ */
+const stop = stopChild;
+
 function checkStateIn(state, _, {
   stateValue
 }) {
@@ -1748,7 +1748,7 @@ function enterStates(currentState, event, actorScope, filteredTransitions, mutSt
     // Add entry actions
     actions.push(...stateNodeToEnter.entry);
     for (const invokeDef of stateNodeToEnter.invoke) {
-      actions.push(spawn(invokeDef.src, {
+      actions.push(spawnChild(invokeDef.src, {
         ...invokeDef,
         syncSnapshot: !!invokeDef.onSnapshot
       }));
@@ -1899,7 +1899,7 @@ function exitStates(currentState, event, actorScope, transitions, mutStateNodeSe
     }
   }
   for (const s of statesToExit) {
-    nextState = resolveActionsAndContext(nextState, event, actorScope, [...s.exit, ...s.invoke.map(def => stop(def.id))], internalQueue);
+    nextState = resolveActionsAndContext(nextState, event, actorScope, [...s.exit, ...s.invoke.map(def => stopChild(def.id))], internalQueue);
     mutStateNodeSet.delete(s);
   }
   return [nextState, changedHistory || historyValue];
@@ -2022,7 +2022,7 @@ function macrostep(state, event, actorScope, internalQueue = []) {
   };
 }
 function stopChildren(nextState, event, actorScope) {
-  return resolveActionsAndContext(nextState, event, actorScope, Object.values(nextState.children).map(child => stop(child)), []);
+  return resolveActionsAndContext(nextState, event, actorScope, Object.values(nextState.children).map(child => stopChild(child)), []);
 }
 function selectTransitions(event, nextState) {
   return nextState.machine.getTransitionData(nextState, event);
@@ -2076,7 +2076,6 @@ const machineSnapshotToJSON = function toJSON() {
     _nodes: nodes,
     tags,
     machine,
-    getNextEvents,
     getMeta,
     toJSON,
     can,
@@ -2089,9 +2088,6 @@ const machineSnapshotToJSON = function toJSON() {
     tags: Array.from(tags)
   };
 };
-const machineSnapshotGetNextEvents = function getNextEvents() {
-  return [...new Set(flatten([...this._nodes.map(sn => sn.ownEvents)]))];
-};
 const machineSnapshotGetMeta = function getMeta() {
   return this._nodes.reduce((acc, stateNode) => {
     if (stateNode.meta !== undefined) {
@@ -2116,7 +2112,6 @@ function createMachineSnapshot(config, machine) {
     matches: machineSnapshotMatches,
     hasTag: machineSnapshotHasTag,
     can: machineSnapshotCan,
-    getNextEvents: machineSnapshotGetNextEvents,
     getMeta: machineSnapshotGetMeta,
     toJSON: machineSnapshotToJSON
   };
@@ -2137,7 +2132,6 @@ function getPersistedState(state, options) {
     can,
     hasTag,
     matches,
-    getNextEvents,
     getMeta,
     toJSON,
     ...jsonValues
@@ -2238,4 +2232,4 @@ function raise(eventOrExpr, options) {
   return raise;
 }
 
-export { $$ACTOR_TYPE as $, resolveReferencedActor as A, createActor as B, Actor as C, interpret as D, isMachineSnapshot as E, matchesState as F, pathToStateValue as G, toObserver as H, and as I, not as J, or as K, stateIn as L, cancel as M, NULL_EVENT as N, raise as O, stop as P, spawn as Q, ProcessingStatus as R, STATE_DELIMITER as S, createErrorActorEvent as T, XSTATE_ERROR as U, XSTATE_STOP as X, toTransitionConfigArray as a, formatTransition as b, createInvokeId as c, formatInitialTransition as d, evaluateGuard as e, formatTransitions as f, getDelayedTransitions as g, getCandidates as h, getAllStateNodes as i, getStateNodes as j, createMachineSnapshot as k, isInFinalState as l, mapValues as m, isErrorActorEvent as n, cloneMachineSnapshot as o, macrostep as p, transitionNode as q, resolveStateValue as r, resolveActionsAndContext as s, toArray as t, createInitEvent as u, microstep as v, getInitialStateNodes as w, isStateId as x, getStateNodeByPath as y, getPersistedState as z };
+export { $$ACTOR_TYPE as $, getPersistedState as A, resolveReferencedActor as B, createActor as C, Actor as D, interpret as E, isMachineSnapshot as F, matchesState as G, pathToStateValue as H, toObserver as I, and as J, not as K, or as L, stateIn as M, NULL_EVENT as N, cancel as O, raise as P, stop as Q, stopChild as R, STATE_DELIMITER as S, spawnChild as T, ProcessingStatus as U, createErrorActorEvent as V, XSTATE_ERROR as W, XSTATE_STOP as X, toTransitionConfigArray as a, formatTransition as b, createInvokeId as c, formatInitialTransition as d, evaluateGuard as e, formatTransitions as f, getDelayedTransitions as g, getCandidates as h, getAllStateNodes as i, getStateNodes as j, createMachineSnapshot as k, isInFinalState as l, mapValues as m, isErrorActorEvent as n, getAllOwnEventDescriptors as o, cloneMachineSnapshot as p, macrostep as q, resolveStateValue as r, transitionNode as s, toArray as t, resolveActionsAndContext as u, createInitEvent as v, microstep as w, getInitialStateNodes as x, isStateId as y, getStateNodeByPath as z };

package/dist/{send-c124176f.cjs.js → send-401f5c30.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-fabffc3d.cjs.js');
+var guards_dist_xstateGuards = require('./raise-7af24c22.cjs.js');
 
 function createSpawner(actorScope, {
   machine,
@@ -229,6 +229,27 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
+/**
+ * @deprecated Use `AnyActor` instead.
+ */
+
+// Based on RxJS types
+
+/**
+ * @deprecated Use `Actor<T>` instead.
+ */
+
+// only meant to be used internally for debugging purposes
+
+/**
+ * Represents logic which can be used by an actor.
+ *
+ * @template TSnapshot - The type of the snapshot.
+ * @template TEvent - The type of the event object.
+ * @template TInput - The type of the input.
+ * @template TSystem - The type of the actor system.
+ */
+
 function resolveSendTo(actorScope, state, args, actionParams, {
   to,
   event: eventOrExpr,

package/dist/{send-24cc8018.development.esm.js → send-7489590c.development.esm.js}

@@ -1,4 +1,4 @@
-import { R as ProcessingStatus, T as createErrorActorEvent, A as resolveReferencedActor, B as createActor, o as cloneMachineSnapshot, e as evaluateGuard, t as toArray, U as XSTATE_ERROR } from './raise-90139fbc.development.esm.js';
+import { U as ProcessingStatus, V as createErrorActorEvent, B as resolveReferencedActor, C as createActor, p as cloneMachineSnapshot, e as evaluateGuard, t as toArray, W as XSTATE_ERROR } from './raise-156f5f68.development.esm.js';
 
 function createSpawner(actorScope, {
   machine,
@@ -239,6 +239,27 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
+/**
+ * @deprecated Use `AnyActor` instead.
+ */
+
+// Based on RxJS types
+
+/**
+ * @deprecated Use `Actor<T>` instead.
+ */
+
+// only meant to be used internally for debugging purposes
+
+/**
+ * Represents logic which can be used by an actor.
+ *
+ * @template TSnapshot - The type of the snapshot.
+ * @template TEvent - The type of the event object.
+ * @template TInput - The type of the input.
+ * @template TSystem - The type of the actor system.
+ */
+
 function resolveSendTo(actorScope, state, args, actionParams, {
   to,
   event: eventOrExpr,

package/dist/{send-d0bc7eed.development.cjs.js → send-bc0d3e22.development.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-b3fb3c65.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-7dc97582.development.cjs.js');
 
 function createSpawner(actorScope, {
   machine,
@@ -241,6 +241,27 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
+/**
+ * @deprecated Use `AnyActor` instead.
+ */
+
+// Based on RxJS types
+
+/**
+ * @deprecated Use `Actor<T>` instead.
+ */
+
+// only meant to be used internally for debugging purposes
+
+/**
+ * Represents logic which can be used by an actor.
+ *
+ * @template TSnapshot - The type of the snapshot.
+ * @template TEvent - The type of the event object.
+ * @template TInput - The type of the input.
+ * @template TSystem - The type of the actor system.
+ */
+
 function resolveSendTo(actorScope, state, args, actionParams, {
   to,
   event: eventOrExpr,

package/dist/{send-8e7e41e7.esm.js → send-ed326064.esm.js}

@@ -1,4 +1,4 @@
-import { R as ProcessingStatus, T as createErrorActorEvent, A as resolveReferencedActor, B as createActor, o as cloneMachineSnapshot, e as evaluateGuard, t as toArray, U as XSTATE_ERROR } from './raise-2b5a4e4c.esm.js';
+import { U as ProcessingStatus, V as createErrorActorEvent, B as resolveReferencedActor, C as createActor, p as cloneMachineSnapshot, e as evaluateGuard, t as toArray, W as XSTATE_ERROR } from './raise-91ec8b4f.esm.js';
 
 function createSpawner(actorScope, {
   machine,
@@ -227,6 +227,27 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
+/**
+ * @deprecated Use `AnyActor` instead.
+ */
+
+// Based on RxJS types
+
+/**
+ * @deprecated Use `Actor<T>` instead.
+ */
+
+// only meant to be used internally for debugging purposes
+
+/**
+ * Represents logic which can be used by an actor.
+ *
+ * @template TSnapshot - The type of the snapshot.
+ * @template TEvent - The type of the event object.
+ * @template TInput - The type of the input.
+ * @template TSystem - The type of the actor system.
+ */
+
 function resolveSendTo(actorScope, state, args, actionParams, {
   to,
   event: eventOrExpr,

package/dist/xstate.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.cjs.js');
-var guards_dist_xstateGuards = require('./raise-fabffc3d.cjs.js');
-var send = require('./send-c124176f.cjs.js');
+var guards_dist_xstateGuards = require('./raise-7af24c22.cjs.js');
+var send = require('./send-401f5c30.cjs.js');
 require('../dev/dist/xstate-dev.cjs.js');
 
 class SimulatedClock {
@@ -90,85 +90,72 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  /**
-   * The relative key of the state node, which represents its location in the overall state value.
-   */
-
-  /**
-   * The unique ID of the state node.
-   */
-
-  /**
-   * The type of this state node:
-   *
-   *  - `'atomic'` - no child state nodes
-   *  - `'compound'` - nested child state nodes (XOR)
-   *  - `'parallel'` - orthogonal nested child state nodes (AND)
-   *  - `'history'` - history state node
-   *  - `'final'` - final state node
-   */
-
-  /**
-   * The string path from the root machine node to this node.
-   */
-
-  /**
-   * The child state nodes.
-   */
-
-  /**
-   * The type of history on this state node. Can be:
-   *
-   *  - `'shallow'` - recalls only top-level historical state value
-   *  - `'deep'` - recalls historical state value at all levels
-   */
-
-  /**
-   * The action(s) to be executed upon entering the state node.
-   */
-
-  /**
-   * The action(s) to be executed upon exiting the state node.
-   */
-
-  /**
-   * The parent state node.
-   */
-
-  /**
-   * The root machine node.
-   */
-
-  /**
-   * The meta data associated with this state node, which will be returned in State instances.
-   */
-
-  /**
-   * The output data sent with the "xstate.done.state._id_" event if this is a final state node.
-   */
-
-  /**
-   * The order this state node appears. Corresponds to the implicit document order.
-   */
-
   constructor(
   /**
    * The raw config used to create the machine.
    */
   config, options) {
     this.config = config;
+    /**
+     * The relative key of the state node, which represents its location in the overall state value.
+     */
     this.key = void 0;
+    /**
+     * The unique ID of the state node.
+     */
     this.id = void 0;
+    /**
+     * The type of this state node:
+     *
+     *  - `'atomic'` - no child state nodes
+     *  - `'compound'` - nested child state nodes (XOR)
+     *  - `'parallel'` - orthogonal nested child state nodes (AND)
+     *  - `'history'` - history state node
+     *  - `'final'` - final state node
+     */
     this.type = void 0;
+    /**
+     * The string path from the root machine node to this node.
+     */
     this.path = void 0;
+    /**
+     * The child state nodes.
+     */
     this.states = void 0;
+    /**
+     * The type of history on this state node. Can be:
+     *
+     *  - `'shallow'` - recalls only top-level historical state value
+     *  - `'deep'` - recalls historical state value at all levels
+     */
     this.history = void 0;
+    /**
+     * The action(s) to be executed upon entering the state node.
+     */
     this.entry = void 0;
+    /**
+     * The action(s) to be executed upon exiting the state node.
+     */
     this.exit = void 0;
+    /**
+     * The parent state node.
+     */
     this.parent = void 0;
+    /**
+     * The root machine node.
+     */
     this.machine = void 0;
+    /**
+     * The meta data associated with this state node, which will be returned in State instances.
+     */
     this.meta = void 0;
+    /**
+     * The output data sent with the "xstate.done.state._id_" event if this is a final state node.
+     */
     this.output = void 0;
+    /**
+     * The order this state node appears. Corresponds to the implicit document order.
+     */
     this.order = -1;
     this.description = void 0;
     this.tags = [];
@@ -374,16 +361,15 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  /**
-   * The machine's own version.
-   */
-
   constructor(
   /**
    * The raw config used to create the machine.
    */
   config, implementations) {
     this.config = config;
+    /**
+     * The machine's own version.
+     */
     this.version = void 0;
     this.implementations = void 0;
     this.types = void 0;
@@ -393,15 +379,7 @@ class StateMachine {
     this.id = void 0;
     this.states = void 0;
     this.events = void 0;
-    this.__TContext = void 0;
-    this.__TEvent = void 0;
-    this.__TActor = void 0;
-    this.__TAction = void 0;
-    this.__TGuard = void 0;
-    this.__TDelay = void 0;
-    this.__TTag = void 0;
-    this.__TInput = void 0;
-    this.__TOutput = void 0;
+    /** @deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
     this.__TResolvedTypesMeta = void 0;
     this.id = config.id || '(machine)';
     this.implementations = {
@@ -483,7 +461,7 @@ class StateMachine {
    */
   transition(state, event, actorScope) {
     // TODO: handle error events in a better way
-    if (guards_dist_xstateGuards.isErrorActorEvent(event) && !state.getNextEvents().some(nextEvent => nextEvent === event.type)) {
+    if (guards_dist_xstateGuards.isErrorActorEvent(event) && !guards_dist_xstateGuards.getAllOwnEventDescriptors(state).some(nextEvent => nextEvent === event.type)) {
       return guards_dist_xstateGuards.cloneMachineSnapshot(state, {
         status: 'error',
         error: event.data
@@ -593,12 +571,11 @@ class StateMachine {
       if (!logic) {
         return;
       }
-      const actorState = logic.restoreState?.(childState, _actorScope);
       const actorRef = guards_dist_xstateGuards.createActor(logic, {
         id: actorId,
         parent: _actorScope?.self,
         syncSnapshot: actorData.syncSnapshot,
-        state: actorState,
+        state: childState,
         src,
         systemId: actorData.systemId
       });
@@ -629,8 +606,6 @@ class StateMachine {
     reviveContext(restoredSnapshot.context, children);
     return restoredSnapshot;
   }
-
-  /**@deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
 }
 
 const defaultWaitForOptions = {
@@ -708,6 +683,8 @@ function createMachine(config, implementations) {
   return new StateMachine(config, implementations);
 }
 
+// at the moment we allow extra actors - ones that are not specified by `children`
+// this could be reconsidered in the future
 function setup({
   actors,
   actions,
@@ -731,6 +708,7 @@ exports.fromObservable = actors_dist_xstateActors.fromObservable;
 exports.fromPromise = actors_dist_xstateActors.fromPromise;
 exports.fromTransition = actors_dist_xstateActors.fromTransition;
 exports.Actor = guards_dist_xstateGuards.Actor;
+exports.__unsafe_getAllOwnEventDescriptors = guards_dist_xstateGuards.getAllOwnEventDescriptors;
 exports.and = guards_dist_xstateGuards.and;
 exports.cancel = guards_dist_xstateGuards.cancel;
 exports.createActor = guards_dist_xstateGuards.createActor;
@@ -742,9 +720,10 @@ exports.not = guards_dist_xstateGuards.not;
 exports.or = guards_dist_xstateGuards.or;
 exports.pathToStateValue = guards_dist_xstateGuards.pathToStateValue;
 exports.raise = guards_dist_xstateGuards.raise;
-exports.spawn = guards_dist_xstateGuards.spawn;
+exports.spawnChild = guards_dist_xstateGuards.spawnChild;
 exports.stateIn = guards_dist_xstateGuards.stateIn;
 exports.stop = guards_dist_xstateGuards.stop;
+exports.stopChild = guards_dist_xstateGuards.stopChild;
 exports.toObserver = guards_dist_xstateGuards.toObserver;
 exports.SpecialTargets = send.SpecialTargets;
 exports.assign = send.assign;

package/dist/xstate.cjs.mjs

@@ -4,6 +4,7 @@ export {
   SpecialTargets,
   StateMachine,
   StateNode,
+  __unsafe_getAllOwnEventDescriptors,
   and,
   assign,
   cancel,
@@ -31,9 +32,10 @@ export {
   sendParent,
   sendTo,
   setup,
-  spawn,
+  spawnChild,
   stateIn,
   stop,
+  stopChild,
   toObserver,
   waitFor
 } from "./xstate.cjs.js";