xstate 5.18.1 → 5.19.0

package/dist/xstate.development.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.development.cjs.js');
-var guards_dist_xstateGuards = require('./raise-830a98f7.development.cjs.js');
-var log = require('./log-d26be77d.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-4acdb210.development.cjs.js');
+var log = require('./log-17337367.development.cjs.js');
 require('../dev/dist/xstate-dev.development.cjs.js');
 
 /**
@@ -72,7 +72,7 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  constructor( /** The raw config used to create the machine. */
+  constructor(/** The raw config used to create the machine. */
   config, options) {
     this.config = config;
     /**
@@ -224,10 +224,10 @@ class StateNode {
         systemId
       } = invokeConfig;
       const resolvedId = invokeConfig.id ?? guards_dist_xstateGuards.createInvokeId(this.id, i);
-      const resolvedSrc = typeof src === 'string' ? src : `xstate.invoke.${guards_dist_xstateGuards.createInvokeId(this.id, i)}`;
+      const sourceName = typeof src === 'string' ? src : `xstate.invoke.${guards_dist_xstateGuards.createInvokeId(this.id, i)}`;
       return {
         ...invokeConfig,
-        src: resolvedSrc,
+        src: sourceName,
         id: resolvedId,
         systemId: systemId,
         toJSON() {
@@ -239,7 +239,7 @@ class StateNode {
           return {
             ...invokeDefValues,
             type: 'xstate.invoke',
-            src: resolvedSrc,
+            src: sourceName,
             id: resolvedId
           };
         }
@@ -328,7 +328,7 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  constructor( /** The raw config used to create the machine. */
+  constructor(/** The raw config used to create the machine. */
   config, implementations) {
     this.config = config;
     /** The machine's own version. */
@@ -425,7 +425,7 @@ class StateMachine {
    * @param event The received event
    */
   transition(snapshot, event, actorScope) {
-    return guards_dist_xstateGuards.macrostep(snapshot, event, actorScope).snapshot;
+    return guards_dist_xstateGuards.macrostep(snapshot, event, actorScope, []).snapshot;
   }
 
   /**
@@ -436,7 +436,7 @@ class StateMachine {
    * @param event The received event
    */
   microstep(snapshot, event, actorScope) {
-    return guards_dist_xstateGuards.macrostep(snapshot, event, actorScope).microstates;
+    return guards_dist_xstateGuards.macrostep(snapshot, event, actorScope, []).microstates;
   }
   getTransitionData(snapshot, event) {
     return guards_dist_xstateGuards.transitionNode(this.root, snapshot.value, snapshot, event) || [];
@@ -466,7 +466,7 @@ class StateMachine {
         input: event.input,
         self
       });
-      return guards_dist_xstateGuards.resolveActionsAndContext(preInitial, initEvent, actorScope, [log.assign(assignment)], internalQueue);
+      return guards_dist_xstateGuards.resolveActionsAndContext(preInitial, initEvent, actorScope, [log.assign(assignment)], internalQueue, undefined);
     }
     return preInitial;
   }
@@ -544,13 +544,13 @@ class StateMachine {
       children,
       _nodes: Array.from(guards_dist_xstateGuards.getAllStateNodes(guards_dist_xstateGuards.getStateNodes(this.root, snapshot.value)))
     }, this);
-    let seen = new Set();
+    const seen = new Set();
     function reviveContext(contextPart, children) {
       if (seen.has(contextPart)) {
         return;
       }
       seen.add(contextPart);
-      for (let key in contextPart) {
+      for (const key in contextPart) {
         const value = contextPart[key];
         if (value && typeof value === 'object') {
           if ('xstate$$type' in value && value.xstate$$type === guards_dist_xstateGuards.$$ACTOR_TYPE) {
@@ -566,9 +566,6 @@ class StateMachine {
   }
 }
 
-// this is not 100% accurate since we can't make parallel regions required in the result
-// `TTestValue` doesn't encode this information anyhow for us to be able to do that
-// this is fine for most practical use cases anyway though
 /**
  * Creates a state machine (statechart) with the given configuration.
  *
@@ -626,10 +623,13 @@ function createInertActorScope(actorLogic) {
     sessionId: '',
     stopChild: () => {},
     system: self.system,
-    emit: () => {}
+    emit: () => {},
+    actionExecutor: () => {}
   };
   return inertActorScope;
 }
+
+/** @deprecated Use `initialTransition(…)` instead. */
 function getInitialSnapshot(actorLogic, ...[input]) {
   const actorScope = createInertActorScope(actorLogic);
   return actorLogic.getInitialSnapshot(actorScope, input);
@@ -642,6 +642,7 @@ function getInitialSnapshot(actorLogic, ...[input]) {
  * If the `snapshot` is `undefined`, the initial snapshot of the `actorLogic` is
  * used.
  *
+ * @deprecated Use `transition(…)` instead.
  * @example
  *
  * ```ts
@@ -675,6 +676,7 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
+
 function setup({
   schemas,
   actors,
@@ -695,6 +697,9 @@ function setup({
   };
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 class SimulatedClock {
   constructor() {
     this.timeouts = new Map();
@@ -795,6 +800,39 @@ function toPromise(actor) {
   });
 }
 
+/**
+ * Given actor `logic`, a `snapshot`, and an `event`, returns a tuple of the
+ * `nextSnapshot` and `actions` to execute.
+ *
+ * This is a pure function that does not execute `actions`.
+ */
+function transition(logic, snapshot, event) {
+  const executableActions = [];
+  const actorScope = createInertActorScope(logic);
+  actorScope.actionExecutor = action => {
+    executableActions.push(action);
+  };
+  const nextSnapshot = logic.transition(snapshot, event, actorScope);
+  return [nextSnapshot, executableActions];
+}
+
+/**
+ * Given actor `logic` and optional `input`, returns a tuple of the
+ * `nextSnapshot` and `actions` to execute from the initial transition (no
+ * previous state).
+ *
+ * This is a pure function that does not execute `actions`.
+ */
+function initialTransition(logic, ...[input]) {
+  const executableActions = [];
+  const actorScope = createInertActorScope(logic);
+  actorScope.actionExecutor = action => {
+    executableActions.push(action);
+  };
+  const nextSnapshot = logic.getInitialSnapshot(actorScope, input);
+  return [nextSnapshot, executableActions];
+}
+
 const defaultWaitForOptions = {
   timeout: Infinity // much more than 10 seconds
 };
@@ -830,6 +868,7 @@ function waitFor(actorRef, predicate, options) {
       signal
     } = resolvedOptions;
     if (signal?.aborted) {
+      // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
       rej(signal.reason);
       return;
     }
@@ -861,6 +900,7 @@ function waitFor(actorRef, predicate, options) {
      * `abort` event
      */
     let abortListener;
+    // eslint-disable-next-line prefer-const
     let sub; // avoid TDZ when disposing synchronously
 
     // See if the current snapshot already matches the predicate
@@ -874,6 +914,7 @@ function waitFor(actorRef, predicate, options) {
       abortListener = () => {
         dispose();
         // XState does not "own" the signal, so we should reject with its reason (if any)
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         rej(signal.reason);
       };
       signal.addEventListener('abort', abortListener);
@@ -882,6 +923,7 @@ function waitFor(actorRef, predicate, options) {
       next: checkEmitted,
       error: err => {
         dispose();
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         rej(err);
       },
       complete: () => {
@@ -934,6 +976,8 @@ exports.assertEvent = assertEvent;
 exports.createMachine = createMachine;
 exports.getInitialSnapshot = getInitialSnapshot;
 exports.getNextSnapshot = getNextSnapshot;
+exports.initialTransition = initialTransition;
 exports.setup = setup;
 exports.toPromise = toPromise;
+exports.transition = transition;
 exports.waitFor = waitFor;

package/dist/xstate.development.cjs.mjs

@@ -23,6 +23,7 @@ export {
   getInitialSnapshot,
   getNextSnapshot,
   getStateNodes,
+  initialTransition,
   interpret,
   isMachineSnapshot,
   log,
@@ -40,5 +41,6 @@ export {
   stopChild,
   toObserver,
   toPromise,
+  transition,
   waitFor
 } from "./xstate.development.cjs.js";

package/dist/xstate.development.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.development.esm.js';
-import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-206d3d29.development.esm.js';
-export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-206d3d29.development.esm.js';
-import { a as assign } from './log-c92a07bc.development.esm.js';
-export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-c92a07bc.development.esm.js';
+import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-1db27a82.development.esm.js';
+export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-1db27a82.development.esm.js';
+import { a as assign } from './log-ef30c65f.development.esm.js';
+export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-ef30c65f.development.esm.js';
 import '../dev/dist/xstate-dev.development.esm.js';
 
 /**
@@ -70,7 +70,7 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  constructor( /** The raw config used to create the machine. */
+  constructor(/** The raw config used to create the machine. */
   config, options) {
     this.config = config;
     /**
@@ -222,10 +222,10 @@ class StateNode {
         systemId
       } = invokeConfig;
       const resolvedId = invokeConfig.id ?? createInvokeId(this.id, i);
-      const resolvedSrc = typeof src === 'string' ? src : `xstate.invoke.${createInvokeId(this.id, i)}`;
+      const sourceName = typeof src === 'string' ? src : `xstate.invoke.${createInvokeId(this.id, i)}`;
       return {
         ...invokeConfig,
-        src: resolvedSrc,
+        src: sourceName,
         id: resolvedId,
         systemId: systemId,
         toJSON() {
@@ -237,7 +237,7 @@ class StateNode {
           return {
             ...invokeDefValues,
             type: 'xstate.invoke',
-            src: resolvedSrc,
+            src: sourceName,
             id: resolvedId
           };
         }
@@ -326,7 +326,7 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  constructor( /** The raw config used to create the machine. */
+  constructor(/** The raw config used to create the machine. */
   config, implementations) {
     this.config = config;
     /** The machine's own version. */
@@ -423,7 +423,7 @@ class StateMachine {
    * @param event The received event
    */
   transition(snapshot, event, actorScope) {
-    return macrostep(snapshot, event, actorScope).snapshot;
+    return macrostep(snapshot, event, actorScope, []).snapshot;
   }
 
   /**
@@ -434,7 +434,7 @@ class StateMachine {
    * @param event The received event
    */
   microstep(snapshot, event, actorScope) {
-    return macrostep(snapshot, event, actorScope).microstates;
+    return macrostep(snapshot, event, actorScope, []).microstates;
   }
   getTransitionData(snapshot, event) {
     return transitionNode(this.root, snapshot.value, snapshot, event) || [];
@@ -464,7 +464,7 @@ class StateMachine {
         input: event.input,
         self
       });
-      return resolveActionsAndContext(preInitial, initEvent, actorScope, [assign(assignment)], internalQueue);
+      return resolveActionsAndContext(preInitial, initEvent, actorScope, [assign(assignment)], internalQueue, undefined);
     }
     return preInitial;
   }
@@ -542,13 +542,13 @@ class StateMachine {
       children,
       _nodes: Array.from(getAllStateNodes(getStateNodes(this.root, snapshot.value)))
     }, this);
-    let seen = new Set();
+    const seen = new Set();
     function reviveContext(contextPart, children) {
       if (seen.has(contextPart)) {
         return;
       }
       seen.add(contextPart);
-      for (let key in contextPart) {
+      for (const key in contextPart) {
         const value = contextPart[key];
         if (value && typeof value === 'object') {
           if ('xstate$$type' in value && value.xstate$$type === $$ACTOR_TYPE) {
@@ -564,9 +564,6 @@ class StateMachine {
   }
 }
 
-// this is not 100% accurate since we can't make parallel regions required in the result
-// `TTestValue` doesn't encode this information anyhow for us to be able to do that
-// this is fine for most practical use cases anyway though
 /**
  * Creates a state machine (statechart) with the given configuration.
  *
@@ -624,10 +621,13 @@ function createInertActorScope(actorLogic) {
     sessionId: '',
     stopChild: () => {},
     system: self.system,
-    emit: () => {}
+    emit: () => {},
+    actionExecutor: () => {}
   };
   return inertActorScope;
 }
+
+/** @deprecated Use `initialTransition(…)` instead. */
 function getInitialSnapshot(actorLogic, ...[input]) {
   const actorScope = createInertActorScope(actorLogic);
   return actorLogic.getInitialSnapshot(actorScope, input);
@@ -640,6 +640,7 @@ function getInitialSnapshot(actorLogic, ...[input]) {
  * If the `snapshot` is `undefined`, the initial snapshot of the `actorLogic` is
  * used.
  *
+ * @deprecated Use `transition(…)` instead.
  * @example
  *
  * ```ts
@@ -673,6 +674,7 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
+
 function setup({
   schemas,
   actors,
@@ -693,6 +695,9 @@ function setup({
   };
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 class SimulatedClock {
   constructor() {
     this.timeouts = new Map();
@@ -793,6 +798,39 @@ function toPromise(actor) {
   });
 }
 
+/**
+ * Given actor `logic`, a `snapshot`, and an `event`, returns a tuple of the
+ * `nextSnapshot` and `actions` to execute.
+ *
+ * This is a pure function that does not execute `actions`.
+ */
+function transition(logic, snapshot, event) {
+  const executableActions = [];
+  const actorScope = createInertActorScope(logic);
+  actorScope.actionExecutor = action => {
+    executableActions.push(action);
+  };
+  const nextSnapshot = logic.transition(snapshot, event, actorScope);
+  return [nextSnapshot, executableActions];
+}
+
+/**
+ * Given actor `logic` and optional `input`, returns a tuple of the
+ * `nextSnapshot` and `actions` to execute from the initial transition (no
+ * previous state).
+ *
+ * This is a pure function that does not execute `actions`.
+ */
+function initialTransition(logic, ...[input]) {
+  const executableActions = [];
+  const actorScope = createInertActorScope(logic);
+  actorScope.actionExecutor = action => {
+    executableActions.push(action);
+  };
+  const nextSnapshot = logic.getInitialSnapshot(actorScope, input);
+  return [nextSnapshot, executableActions];
+}
+
 const defaultWaitForOptions = {
   timeout: Infinity // much more than 10 seconds
 };
@@ -828,6 +866,7 @@ function waitFor(actorRef, predicate, options) {
       signal
     } = resolvedOptions;
     if (signal?.aborted) {
+      // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
       rej(signal.reason);
       return;
     }
@@ -859,6 +898,7 @@ function waitFor(actorRef, predicate, options) {
      * `abort` event
      */
     let abortListener;
+    // eslint-disable-next-line prefer-const
     let sub; // avoid TDZ when disposing synchronously
 
     // See if the current snapshot already matches the predicate
@@ -872,6 +912,7 @@ function waitFor(actorRef, predicate, options) {
       abortListener = () => {
         dispose();
         // XState does not "own" the signal, so we should reject with its reason (if any)
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         rej(signal.reason);
       };
       signal.addEventListener('abort', abortListener);
@@ -880,6 +921,7 @@ function waitFor(actorRef, predicate, options) {
       next: checkEmitted,
       error: err => {
         dispose();
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         rej(err);
       },
       complete: () => {
@@ -893,4 +935,4 @@ function waitFor(actorRef, predicate, options) {
   });
 }
 
-export { SimulatedClock, StateMachine, StateNode, assertEvent, createMachine, getInitialSnapshot, getNextSnapshot, setup, toPromise, waitFor };
+export { SimulatedClock, StateMachine, StateNode, assertEvent, createMachine, getInitialSnapshot, getNextSnapshot, initialTransition, setup, toPromise, transition, waitFor };

package/dist/xstate.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.esm.js';
-import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-c0e3c984.esm.js';
-export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-c0e3c984.esm.js';
-import { a as assign } from './log-a2c94240.esm.js';
-export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-a2c94240.esm.js';
+import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-c17ec2bc.esm.js';
+export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-c17ec2bc.esm.js';
+import { a as assign } from './log-2a773d37.esm.js';
+export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-2a773d37.esm.js';
 import '../dev/dist/xstate-dev.esm.js';
 
 /**
@@ -70,7 +70,7 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  constructor( /** The raw config used to create the machine. */
+  constructor(/** The raw config used to create the machine. */
   config, options) {
     this.config = config;
     /**
@@ -222,10 +222,10 @@ class StateNode {
         systemId
       } = invokeConfig;
       const resolvedId = invokeConfig.id ?? createInvokeId(this.id, i);
-      const resolvedSrc = typeof src === 'string' ? src : `xstate.invoke.${createInvokeId(this.id, i)}`;
+      const sourceName = typeof src === 'string' ? src : `xstate.invoke.${createInvokeId(this.id, i)}`;
       return {
         ...invokeConfig,
-        src: resolvedSrc,
+        src: sourceName,
         id: resolvedId,
         systemId: systemId,
         toJSON() {
@@ -237,7 +237,7 @@ class StateNode {
           return {
             ...invokeDefValues,
             type: 'xstate.invoke',
-            src: resolvedSrc,
+            src: sourceName,
             id: resolvedId
           };
         }
@@ -326,7 +326,7 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  constructor( /** The raw config used to create the machine. */
+  constructor(/** The raw config used to create the machine. */
   config, implementations) {
     this.config = config;
     /** The machine's own version. */
@@ -420,7 +420,7 @@ class StateMachine {
    * @param event The received event
    */
   transition(snapshot, event, actorScope) {
-    return macrostep(snapshot, event, actorScope).snapshot;
+    return macrostep(snapshot, event, actorScope, []).snapshot;
   }
 
   /**
@@ -431,7 +431,7 @@ class StateMachine {
    * @param event The received event
    */
   microstep(snapshot, event, actorScope) {
-    return macrostep(snapshot, event, actorScope).microstates;
+    return macrostep(snapshot, event, actorScope, []).microstates;
   }
   getTransitionData(snapshot, event) {
     return transitionNode(this.root, snapshot.value, snapshot, event) || [];
@@ -461,7 +461,7 @@ class StateMachine {
         input: event.input,
         self
       });
-      return resolveActionsAndContext(preInitial, initEvent, actorScope, [assign(assignment)], internalQueue);
+      return resolveActionsAndContext(preInitial, initEvent, actorScope, [assign(assignment)], internalQueue, undefined);
     }
     return preInitial;
   }
@@ -539,13 +539,13 @@ class StateMachine {
       children,
       _nodes: Array.from(getAllStateNodes(getStateNodes(this.root, snapshot.value)))
     }, this);
-    let seen = new Set();
+    const seen = new Set();
     function reviveContext(contextPart, children) {
       if (seen.has(contextPart)) {
         return;
       }
       seen.add(contextPart);
-      for (let key in contextPart) {
+      for (const key in contextPart) {
         const value = contextPart[key];
         if (value && typeof value === 'object') {
           if ('xstate$$type' in value && value.xstate$$type === $$ACTOR_TYPE) {
@@ -561,9 +561,6 @@ class StateMachine {
   }
 }
 
-// this is not 100% accurate since we can't make parallel regions required in the result
-// `TTestValue` doesn't encode this information anyhow for us to be able to do that
-// this is fine for most practical use cases anyway though
 /**
  * Creates a state machine (statechart) with the given configuration.
  *
@@ -621,10 +618,13 @@ function createInertActorScope(actorLogic) {
     sessionId: '',
     stopChild: () => {},
     system: self.system,
-    emit: () => {}
+    emit: () => {},
+    actionExecutor: () => {}
   };
   return inertActorScope;
 }
+
+/** @deprecated Use `initialTransition(…)` instead. */
 function getInitialSnapshot(actorLogic, ...[input]) {
   const actorScope = createInertActorScope(actorLogic);
   return actorLogic.getInitialSnapshot(actorScope, input);
@@ -637,6 +637,7 @@ function getInitialSnapshot(actorLogic, ...[input]) {
  * If the `snapshot` is `undefined`, the initial snapshot of the `actorLogic` is
  * used.
  *
+ * @deprecated Use `transition(…)` instead.
  * @example
  *
  * ```ts
@@ -670,6 +671,7 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
+
 function setup({
   schemas,
   actors,
@@ -690,6 +692,9 @@ function setup({
   };
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 class SimulatedClock {
   constructor() {
     this.timeouts = new Map();
@@ -790,6 +795,39 @@ function toPromise(actor) {
   });
 }
 
+/**
+ * Given actor `logic`, a `snapshot`, and an `event`, returns a tuple of the
+ * `nextSnapshot` and `actions` to execute.
+ *
+ * This is a pure function that does not execute `actions`.
+ */
+function transition(logic, snapshot, event) {
+  const executableActions = [];
+  const actorScope = createInertActorScope(logic);
+  actorScope.actionExecutor = action => {
+    executableActions.push(action);
+  };
+  const nextSnapshot = logic.transition(snapshot, event, actorScope);
+  return [nextSnapshot, executableActions];
+}
+
+/**
+ * Given actor `logic` and optional `input`, returns a tuple of the
+ * `nextSnapshot` and `actions` to execute from the initial transition (no
+ * previous state).
+ *
+ * This is a pure function that does not execute `actions`.
+ */
+function initialTransition(logic, ...[input]) {
+  const executableActions = [];
+  const actorScope = createInertActorScope(logic);
+  actorScope.actionExecutor = action => {
+    executableActions.push(action);
+  };
+  const nextSnapshot = logic.getInitialSnapshot(actorScope, input);
+  return [nextSnapshot, executableActions];
+}
+
 const defaultWaitForOptions = {
   timeout: Infinity // much more than 10 seconds
 };
@@ -825,6 +863,7 @@ function waitFor(actorRef, predicate, options) {
       signal
     } = resolvedOptions;
     if (signal?.aborted) {
+      // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
       rej(signal.reason);
       return;
     }
@@ -853,6 +892,7 @@ function waitFor(actorRef, predicate, options) {
      * `abort` event
      */
     let abortListener;
+    // eslint-disable-next-line prefer-const
     let sub; // avoid TDZ when disposing synchronously
 
     // See if the current snapshot already matches the predicate
@@ -866,6 +906,7 @@ function waitFor(actorRef, predicate, options) {
       abortListener = () => {
         dispose();
         // XState does not "own" the signal, so we should reject with its reason (if any)
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         rej(signal.reason);
       };
       signal.addEventListener('abort', abortListener);
@@ -874,6 +915,7 @@ function waitFor(actorRef, predicate, options) {
       next: checkEmitted,
       error: err => {
         dispose();
+        // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
         rej(err);
       },
       complete: () => {
@@ -887,4 +929,4 @@ function waitFor(actorRef, predicate, options) {
   });
 }
 
-export { SimulatedClock, StateMachine, StateNode, assertEvent, createMachine, getInitialSnapshot, getNextSnapshot, setup, toPromise, waitFor };
+export { SimulatedClock, StateMachine, StateNode, assertEvent, createMachine, getInitialSnapshot, getNextSnapshot, initialTransition, setup, toPromise, transition, waitFor };