xstate 6.0.0-alpha.21 → 6.0.0-alpha.23

package/dist/xstate.cjs.js

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_xstateActors = require('./index-e694228c.cjs.js');
-var StateMachine = require('./StateMachine-1b155670.cjs.js');
+var dist_xstateActors = require('./index-434fac23.cjs.js');
+var StateMachine = require('./StateMachine-aad57180.cjs.js');
 
 /**
  * Asserts that the given event object is of the specified type or types. Throws
@@ -137,6 +137,8 @@ function createSnapshot(value, context, input, machine, stateInput) {
     context,
     input,
     children: {},
+    timers: {},
+    _nextTimerId: 0,
     _stateInput: stateInput,
     machine
   };
@@ -150,6 +152,8 @@ function cloneSnapshot(snapshot, value, context, stateInput) {
     context,
     input: snapshot.input,
     children: snapshot.children,
+    timers: snapshot.timers,
+    _nextTimerId: snapshot._nextTimerId,
     _stateInput: stateInput,
     machine: snapshot.machine
   };
@@ -163,6 +167,8 @@ function stopSnapshot(snapshot) {
     context: snapshot.context,
     input: undefined,
     children: snapshot.children,
+    timers: snapshot.timers,
+    _nextTimerId: snapshot._nextTimerId,
     _stateInput: snapshot._stateInput,
     machine: snapshot.machine
   };
@@ -186,10 +192,14 @@ function resolveSimpleEnqueuedActions(rawActions) {
       return undefined;
     }
     executableActions.push({
+      kind: 'action',
       type: action.action.name || '(anonymous)',
       params: undefined,
       args: action.args,
-      exec: action.args.length ? action.action.bind(null, ...action.args) : action.action
+      action: action.action,
+      exec() {
+        return this.action?.(...this.args);
+      }
     });
   }
   return executableActions;
@@ -296,7 +306,32 @@ function createFSM(config) {
       return [snapshot, []];
     }
     if (event.type === dist_xstateActors.XSTATE_STOP) {
-      return [stopSnapshot(snapshot), emptyExecutableActions];
+      const actions = [];
+      const enqueue = dist_xstateActors.createTransitionEnqueue(actorScope, actions, []);
+      for (const id of Object.keys(snapshot.timers)) {
+        enqueue.cancel(id);
+      }
+      const [withoutTimers, cancelEffects] = dist_xstateActors.resolveActionsWithContext(snapshot, event, actorScope, actions);
+      return [stopSnapshot(withoutTimers), cancelEffects];
+    }
+    if (event.type === dist_xstateActors.XSTATE_TIMER) {
+      const timer = snapshot.timers[event.id];
+      if (!timer) {
+        return [snapshot, emptyExecutableActions];
+      }
+      const timers = {
+        ...snapshot.timers
+      };
+      delete timers[timer.id];
+      const nextSnapshot = {
+        ...snapshot,
+        timers
+      };
+      if (timer.type === '@xstate.raise') {
+        return transitionCore(nextSnapshot, timer.event, actorScope);
+      }
+      const target = timer.target === 'self' ? actorScope.self : timer.target;
+      return [nextSnapshot, [dist_xstateActors.createSendToEffect(actorScope, target, timer.event)]];
     }
     const stateConfig = config.states[snapshot.value];
     const directTransition = stateConfig?.on?.[event.type];
@@ -392,7 +427,7 @@ function createFSM(config) {
   };
   const transition = (...args) => {
     const [nextSnapshot, effects] = transitionCore(...args);
-    return [nextSnapshot, [...effects, ...dist_xstateActors.deriveDeferredStarts(effects)]];
+    return dist_xstateActors.finalizeTransitionResult(args[2], args[0], [nextSnapshot, [...effects, ...dist_xstateActors.deriveDeferredStarts(effects)]]);
   };
   const logic = {
     id: config.id,
@@ -413,7 +448,7 @@ function createFSM(config) {
         nextSnapshot = raisedSnapshot;
         actions.push(...raisedActions);
       }
-      return [nextSnapshot, [...actions, ...dist_xstateActors.deriveDeferredStarts(actions)]];
+      return dist_xstateActors.finalizeTransitionResult(actorScope, undefined, [nextSnapshot, [...actions, ...dist_xstateActors.deriveDeferredStarts(actions)]]);
     },
     getInitialSnapshot: (actorScope, input) => logic.initialTransition(input, actorScope)[0],
     getPersistedSnapshot: ({
@@ -2182,71 +2217,6 @@ function mergeSetupConfigs(base, extension) {
   };
 }
 
-/** @internal */
-function createInertActorScope(actorLogic) {
-  const self = dist_xstateActors.createActor(actorLogic, {
-    _inert: true
-  });
-  const inertActorScope = {
-    self: self,
-    defer: () => {},
-    id: '',
-    logger: () => {},
-    sessionId: '',
-    stopChild: () => {},
-    system: self.system,
-    emit: () => {},
-    actionExecutor: () => {}
-  };
-  return inertActorScope;
-}
-
-/** @deprecated Use `initialTransition(…)` instead. */
-function getInitialSnapshot(actorLogic, ...[input]) {
-  const actorScope = createInertActorScope(actorLogic);
-  return actorLogic.initialTransition(input, actorScope)[0];
-}
-
-/**
- * Determines the next snapshot for the given `actorLogic` based on the given
- * `snapshot` and `event`.
- *
- * If the `snapshot` is `undefined`, the initial snapshot of the `actorLogic` is
- * used.
- *
- * @deprecated Use `transition(…)` instead.
- * @example
- *
- * ```ts
- * import { getNextSnapshot } from 'xstate';
- * import { trafficLightMachine } from './trafficLightMachine.ts';
- *
- * const nextSnapshot = getNextSnapshot(
- *   trafficLightMachine, // actor logic
- *   undefined, // snapshot (or initial state if undefined)
- *   { type: 'TIMER' }
- * ); // event object
- *
- * console.log(nextSnapshot.value);
- * // => 'yellow'
- *
- * const nextSnapshot2 = getNextSnapshot(
- *   trafficLightMachine, // actor logic
- *   nextSnapshot, // snapshot
- *   { type: 'TIMER' }
- * ); // event object
- *
- * console.log(nextSnapshot2.value);
- * // =>'red'
- * ```
- */
-function getNextSnapshot(actorLogic, snapshot, event) {
-  const inertActorScope = createInertActorScope(actorLogic);
-  inertActorScope.self._snapshot = snapshot;
-  const transitionResult = actorLogic.transition(snapshot, event, inertActorScope);
-  return Array.isArray(transitionResult) ? transitionResult[0] : transitionResult;
-}
-
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
@@ -2403,24 +2373,9 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
-/**
- * A pending effect (delayed event/transition that has not fired yet) captured
- * in a persisted snapshot — a serialized built-in action descriptor plus its
- * runtime progress, with enough information to restore it under any strategy.
- */
+/** A deterministic delayed-delivery declaration owned by a logic snapshot. */
 
-/**
- * How pending effects (timers) from a persisted snapshot are restored on
- * `actor.start()`:
- *
- * - `'resume'` (default) — the clock was "frozen" while persisted: a 5-minute
- *   timer persisted with 1 minute elapsed fires after 4 more minutes.
- * - `'restart'` — timers start over with their full delay.
- * - `'absolute'` — timers honor the original wall-clock expiry (`startedAt +
- *   delay`); already-expired timers fire immediately.
- * - A custom function receiving the pending effect and returning the remaining
- *   delay in ms.
- */
+/** The logical input delivered to a timer's source when its runtime delay ends. */
 
 /** @deprecated Use `AnyActor` instead. */
 
@@ -2466,8 +2421,6 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
 
 /** The concrete actor instance type produced from actor logic. */
 
-// TODO: in v6, this should only accept AnyActorLogic, like ActorRefFromLogic
-
 /**
  * Represents logic which can be used by an actor.
  *
@@ -2485,8 +2438,27 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
 
 /** @deprecated */
 
+/** The terminal result published when an actor completes or errors. */
+
+/** An executable effect that publishes an actor's terminal result. */
+
 /** Mappers for subscribeTo - maps lifecycle events to machine events */
 
+function attachMicrostepActorRefs(microsteps, actorScope, inputSnapshot) {
+  if (!microsteps.length) {
+    return microsteps;
+  }
+  const result = microsteps.slice();
+  const finalSnapshot = result.at(-1)[0];
+  StateMachine.setInertActorScopeSnapshot(actorScope, finalSnapshot, false);
+  for (const [snapshot] of result) {
+    if (snapshot !== inputSnapshot) {
+      StateMachine.attachSnapshotActorRef(snapshot.machine, actorScope, snapshot);
+    }
+  }
+  return result;
+}
+
 /**
  * Given actor `logic`, a `snapshot`, and an `event`, returns a tuple of the
  * `nextSnapshot` and `actions` to execute.
@@ -2494,9 +2466,12 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
  * This is a pure function that does not execute `actions`.
  */
 function transition(logic, snapshot, event) {
-  const actorScope = createInertActorScope(logic);
-  const [nextSnapshot, effects] = logic.transition(snapshot, event, actorScope);
-  return [nextSnapshot, effects];
+  const actorScope = StateMachine.createInertActorScope(logic, snapshot);
+  StateMachine.setInertActorScopeSnapshot(actorScope, snapshot, false);
+  const [nextSnapshot, effects] = dist_xstateActors.finalizeTransitionResult(actorScope, snapshot, logic.transition(snapshot, event, actorScope));
+  StateMachine.setInertActorScopeSnapshot(actorScope, nextSnapshot, false);
+  const returnedSnapshot = nextSnapshot === snapshot ? nextSnapshot : StateMachine.attachSnapshotActorRef(logic, actorScope, nextSnapshot);
+  return [returnedSnapshot, effects];
 }
 
 /**
@@ -2507,9 +2482,11 @@ function transition(logic, snapshot, event) {
  * This is a pure function that does not execute `actions`.
  */
 function initialTransition(logic, ...[input]) {
-  const actorScope = createInertActorScope(logic);
-  const [nextSnapshot, executableActions] = logic.initialTransition(input, actorScope);
-  return [nextSnapshot, executableActions];
+  const actorScope = StateMachine.createInertActorScope(logic);
+  const [nextSnapshot, executableActions] = dist_xstateActors.finalizeTransitionResult(actorScope, undefined, logic.initialTransition(input, actorScope));
+  StateMachine.setInertActorScopeSnapshot(actorScope, nextSnapshot, false);
+  const returnedSnapshot = StateMachine.attachSnapshotActorRef(logic, actorScope, nextSnapshot);
+  return [returnedSnapshot, executableActions];
 }
 
 /**
@@ -2519,11 +2496,11 @@ function initialTransition(logic, ...[input]) {
  * This is a pure function that does not execute `actions`.
  */
 function getMicrosteps(machine, snapshot, event) {
-  const actorScope = createInertActorScope(machine);
+  const actorScope = StateMachine.createInertActorScope(machine, snapshot);
   const {
     microsteps
   } = dist_xstateActors.macrostep(snapshot, event, actorScope, []);
-  return microsteps;
+  return attachMicrostepActorRefs(microsteps, actorScope, snapshot);
 }
 
 /**
@@ -2534,15 +2511,16 @@ function getMicrosteps(machine, snapshot, event) {
  * This is a pure function that does not execute `actions`.
  */
 function getInitialMicrosteps(machine, ...[input]) {
-  const actorScope = createInertActorScope(machine);
+  const actorScope = StateMachine.createInertActorScope(machine);
   const initEvent = dist_xstateActors.createInitEvent(input);
   const internalQueue = [];
   const preInitialSnapshot = machine._getPreInitialState(actorScope, initEvent);
+  const contextSpawnEffects = Object.values(preInitialSnapshot.children).filter(Boolean).map(actor => dist_xstateActors.createSpawnEffect(actor));
   const first = dist_xstateActors.initialMicrostep(machine.root, preInitialSnapshot, actorScope, initEvent, internalQueue);
   const {
     microsteps
-  } = dist_xstateActors.macrostep(first[0], initEvent, actorScope, internalQueue);
-  return [first, ...microsteps];
+  } = dist_xstateActors.macrostep(first[0], initEvent, actorScope, internalQueue, [[first[0], [...contextSpawnEffects, ...first[1]]]]);
+  return attachMicrostepActorRefs(microsteps, actorScope);
 }
 
 /**
@@ -2715,6 +2693,7 @@ exports.createListenerLogic = dist_xstateActors.createListenerLogic;
 exports.createLogic = dist_xstateActors.createLogic;
 exports.createObservableLogic = dist_xstateActors.createObservableLogic;
 exports.createSubscriptionLogic = dist_xstateActors.createSubscriptionLogic;
+exports.executeEffects = dist_xstateActors.executeEffects;
 exports.getStateNodes = dist_xstateActors.getStateNodes;
 exports.isBuiltInExecutableAction = dist_xstateActors.isBuiltInExecutableAction;
 exports.isMachineSnapshot = dist_xstateActors.isMachineSnapshot;
@@ -2725,6 +2704,8 @@ exports.subscriptionLogic = dist_xstateActors.subscriptionLogic;
 exports.toObserver = dist_xstateActors.toObserver;
 exports.StateMachine = StateMachine.StateMachine;
 exports.StateNode = StateMachine.StateNode;
+exports.getInitialSnapshot = StateMachine.getInitialSnapshot;
+exports.getNextSnapshot = StateMachine.getNextSnapshot;
 exports.SimulatedClock = SimulatedClock;
 exports.SpecialTargets = SpecialTargets;
 exports.assertEvent = assertEvent;
@@ -2734,9 +2715,7 @@ exports.createMachineFromConfig = createMachineFromConfig;
 exports.createStateConfig = createStateConfig;
 exports.createSystem = createSystem;
 exports.getInitialMicrosteps = getInitialMicrosteps;
-exports.getInitialSnapshot = getInitialSnapshot;
 exports.getMicrosteps = getMicrosteps;
-exports.getNextSnapshot = getNextSnapshot;
 exports.getNextTransitions = getNextTransitions;
 exports.initialTransition = initialTransition;
 exports.isTypeSchema = isTypeSchema;

package/dist/xstate.cjs.mjs

@@ -22,6 +22,7 @@ export {
   createStateConfig,
   createSubscriptionLogic,
   createSystem,
+  executeEffects,
   getInitialMicrosteps,
   getInitialSnapshot,
   getMicrosteps,

package/dist/xstate.development.cjs.js

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_xstateActors = require('./index-ec7c7a2d.development.cjs.js');
-var StateMachine = require('./StateMachine-550ff7f2.development.cjs.js');
+var dist_xstateActors = require('./index-41c0375c.development.cjs.js');
+var StateMachine = require('./StateMachine-53114dce.development.cjs.js');
 
 /**
  * Asserts that the given event object is of the specified type or types. Throws
@@ -137,6 +137,8 @@ function createSnapshot(value, context, input, machine, stateInput) {
     context,
     input,
     children: {},
+    timers: {},
+    _nextTimerId: 0,
     _stateInput: stateInput,
     machine
   };
@@ -150,6 +152,8 @@ function cloneSnapshot(snapshot, value, context, stateInput) {
     context,
     input: snapshot.input,
     children: snapshot.children,
+    timers: snapshot.timers,
+    _nextTimerId: snapshot._nextTimerId,
     _stateInput: stateInput,
     machine: snapshot.machine
   };
@@ -163,6 +167,8 @@ function stopSnapshot(snapshot) {
     context: snapshot.context,
     input: undefined,
     children: snapshot.children,
+    timers: snapshot.timers,
+    _nextTimerId: snapshot._nextTimerId,
     _stateInput: snapshot._stateInput,
     machine: snapshot.machine
   };
@@ -186,10 +192,14 @@ function resolveSimpleEnqueuedActions(rawActions) {
       return undefined;
     }
     executableActions.push({
+      kind: 'action',
       type: action.action.name || '(anonymous)',
       params: undefined,
       args: action.args,
-      exec: action.args.length ? action.action.bind(null, ...action.args) : action.action
+      action: action.action,
+      exec() {
+        return this.action?.(...this.args);
+      }
     });
   }
   return executableActions;
@@ -296,7 +306,32 @@ function createFSM(config) {
       return [snapshot, []];
     }
     if (event.type === dist_xstateActors.XSTATE_STOP) {
-      return [stopSnapshot(snapshot), emptyExecutableActions];
+      const actions = [];
+      const enqueue = dist_xstateActors.createTransitionEnqueue(actorScope, actions, []);
+      for (const id of Object.keys(snapshot.timers)) {
+        enqueue.cancel(id);
+      }
+      const [withoutTimers, cancelEffects] = dist_xstateActors.resolveActionsWithContext(snapshot, event, actorScope, actions);
+      return [stopSnapshot(withoutTimers), cancelEffects];
+    }
+    if (event.type === dist_xstateActors.XSTATE_TIMER) {
+      const timer = snapshot.timers[event.id];
+      if (!timer) {
+        return [snapshot, emptyExecutableActions];
+      }
+      const timers = {
+        ...snapshot.timers
+      };
+      delete timers[timer.id];
+      const nextSnapshot = {
+        ...snapshot,
+        timers
+      };
+      if (timer.type === '@xstate.raise') {
+        return transitionCore(nextSnapshot, timer.event, actorScope);
+      }
+      const target = timer.target === 'self' ? actorScope.self : timer.target;
+      return [nextSnapshot, [dist_xstateActors.createSendToEffect(actorScope, target, timer.event)]];
     }
     const stateConfig = config.states[snapshot.value];
     const directTransition = stateConfig?.on?.[event.type];
@@ -392,7 +427,7 @@ function createFSM(config) {
   };
   const transition = (...args) => {
     const [nextSnapshot, effects] = transitionCore(...args);
-    return [nextSnapshot, [...effects, ...dist_xstateActors.deriveDeferredStarts(effects)]];
+    return dist_xstateActors.finalizeTransitionResult(args[2], args[0], [nextSnapshot, [...effects, ...dist_xstateActors.deriveDeferredStarts(effects)]]);
   };
   const logic = {
     id: config.id,
@@ -413,7 +448,7 @@ function createFSM(config) {
         nextSnapshot = raisedSnapshot;
         actions.push(...raisedActions);
       }
-      return [nextSnapshot, [...actions, ...dist_xstateActors.deriveDeferredStarts(actions)]];
+      return dist_xstateActors.finalizeTransitionResult(actorScope, undefined, [nextSnapshot, [...actions, ...dist_xstateActors.deriveDeferredStarts(actions)]]);
     },
     getInitialSnapshot: (actorScope, input) => logic.initialTransition(input, actorScope)[0],
     getPersistedSnapshot: ({
@@ -2182,71 +2217,6 @@ function mergeSetupConfigs(base, extension) {
   };
 }
 
-/** @internal */
-function createInertActorScope(actorLogic) {
-  const self = dist_xstateActors.createActor(actorLogic, {
-    _inert: true
-  });
-  const inertActorScope = {
-    self: self,
-    defer: () => {},
-    id: '',
-    logger: () => {},
-    sessionId: '',
-    stopChild: () => {},
-    system: self.system,
-    emit: () => {},
-    actionExecutor: () => {}
-  };
-  return inertActorScope;
-}
-
-/** @deprecated Use `initialTransition(…)` instead. */
-function getInitialSnapshot(actorLogic, ...[input]) {
-  const actorScope = createInertActorScope(actorLogic);
-  return actorLogic.initialTransition(input, actorScope)[0];
-}
-
-/**
- * Determines the next snapshot for the given `actorLogic` based on the given
- * `snapshot` and `event`.
- *
- * If the `snapshot` is `undefined`, the initial snapshot of the `actorLogic` is
- * used.
- *
- * @deprecated Use `transition(…)` instead.
- * @example
- *
- * ```ts
- * import { getNextSnapshot } from 'xstate';
- * import { trafficLightMachine } from './trafficLightMachine.ts';
- *
- * const nextSnapshot = getNextSnapshot(
- *   trafficLightMachine, // actor logic
- *   undefined, // snapshot (or initial state if undefined)
- *   { type: 'TIMER' }
- * ); // event object
- *
- * console.log(nextSnapshot.value);
- * // => 'yellow'
- *
- * const nextSnapshot2 = getNextSnapshot(
- *   trafficLightMachine, // actor logic
- *   nextSnapshot, // snapshot
- *   { type: 'TIMER' }
- * ); // event object
- *
- * console.log(nextSnapshot2.value);
- * // =>'red'
- * ```
- */
-function getNextSnapshot(actorLogic, snapshot, event) {
-  const inertActorScope = createInertActorScope(actorLogic);
-  inertActorScope.self._snapshot = snapshot;
-  const transitionResult = actorLogic.transition(snapshot, event, inertActorScope);
-  return Array.isArray(transitionResult) ? transitionResult[0] : transitionResult;
-}
-
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
@@ -2403,24 +2373,9 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
-/**
- * A pending effect (delayed event/transition that has not fired yet) captured
- * in a persisted snapshot — a serialized built-in action descriptor plus its
- * runtime progress, with enough information to restore it under any strategy.
- */
+/** A deterministic delayed-delivery declaration owned by a logic snapshot. */
 
-/**
- * How pending effects (timers) from a persisted snapshot are restored on
- * `actor.start()`:
- *
- * - `'resume'` (default) — the clock was "frozen" while persisted: a 5-minute
- *   timer persisted with 1 minute elapsed fires after 4 more minutes.
- * - `'restart'` — timers start over with their full delay.
- * - `'absolute'` — timers honor the original wall-clock expiry (`startedAt +
- *   delay`); already-expired timers fire immediately.
- * - A custom function receiving the pending effect and returning the remaining
- *   delay in ms.
- */
+/** The logical input delivered to a timer's source when its runtime delay ends. */
 
 /** @deprecated Use `AnyActor` instead. */
 
@@ -2466,8 +2421,6 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
 
 /** The concrete actor instance type produced from actor logic. */
 
-// TODO: in v6, this should only accept AnyActorLogic, like ActorRefFromLogic
-
 /**
  * Represents logic which can be used by an actor.
  *
@@ -2485,8 +2438,27 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
 
 /** @deprecated */
 
+/** The terminal result published when an actor completes or errors. */
+
+/** An executable effect that publishes an actor's terminal result. */
+
 /** Mappers for subscribeTo - maps lifecycle events to machine events */
 
+function attachMicrostepActorRefs(microsteps, actorScope, inputSnapshot) {
+  if (!microsteps.length) {
+    return microsteps;
+  }
+  const result = microsteps.slice();
+  const finalSnapshot = result.at(-1)[0];
+  StateMachine.setInertActorScopeSnapshot(actorScope, finalSnapshot, false);
+  for (const [snapshot] of result) {
+    if (snapshot !== inputSnapshot) {
+      StateMachine.attachSnapshotActorRef(snapshot.machine, actorScope, snapshot);
+    }
+  }
+  return result;
+}
+
 /**
  * Given actor `logic`, a `snapshot`, and an `event`, returns a tuple of the
  * `nextSnapshot` and `actions` to execute.
@@ -2494,9 +2466,12 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
  * This is a pure function that does not execute `actions`.
  */
 function transition(logic, snapshot, event) {
-  const actorScope = createInertActorScope(logic);
-  const [nextSnapshot, effects] = logic.transition(snapshot, event, actorScope);
-  return [nextSnapshot, effects];
+  const actorScope = StateMachine.createInertActorScope(logic, snapshot);
+  StateMachine.setInertActorScopeSnapshot(actorScope, snapshot, false);
+  const [nextSnapshot, effects] = dist_xstateActors.finalizeTransitionResult(actorScope, snapshot, logic.transition(snapshot, event, actorScope));
+  StateMachine.setInertActorScopeSnapshot(actorScope, nextSnapshot, false);
+  const returnedSnapshot = nextSnapshot === snapshot ? nextSnapshot : StateMachine.attachSnapshotActorRef(logic, actorScope, nextSnapshot);
+  return [returnedSnapshot, effects];
 }
 
 /**
@@ -2507,9 +2482,11 @@ function transition(logic, snapshot, event) {
  * This is a pure function that does not execute `actions`.
  */
 function initialTransition(logic, ...[input]) {
-  const actorScope = createInertActorScope(logic);
-  const [nextSnapshot, executableActions] = logic.initialTransition(input, actorScope);
-  return [nextSnapshot, executableActions];
+  const actorScope = StateMachine.createInertActorScope(logic);
+  const [nextSnapshot, executableActions] = dist_xstateActors.finalizeTransitionResult(actorScope, undefined, logic.initialTransition(input, actorScope));
+  StateMachine.setInertActorScopeSnapshot(actorScope, nextSnapshot, false);
+  const returnedSnapshot = StateMachine.attachSnapshotActorRef(logic, actorScope, nextSnapshot);
+  return [returnedSnapshot, executableActions];
 }
 
 /**
@@ -2519,11 +2496,11 @@ function initialTransition(logic, ...[input]) {
  * This is a pure function that does not execute `actions`.
  */
 function getMicrosteps(machine, snapshot, event) {
-  const actorScope = createInertActorScope(machine);
+  const actorScope = StateMachine.createInertActorScope(machine, snapshot);
   const {
     microsteps
   } = dist_xstateActors.macrostep(snapshot, event, actorScope, []);
-  return microsteps;
+  return attachMicrostepActorRefs(microsteps, actorScope, snapshot);
 }
 
 /**
@@ -2534,15 +2511,16 @@ function getMicrosteps(machine, snapshot, event) {
  * This is a pure function that does not execute `actions`.
  */
 function getInitialMicrosteps(machine, ...[input]) {
-  const actorScope = createInertActorScope(machine);
+  const actorScope = StateMachine.createInertActorScope(machine);
   const initEvent = dist_xstateActors.createInitEvent(input);
   const internalQueue = [];
   const preInitialSnapshot = machine._getPreInitialState(actorScope, initEvent);
+  const contextSpawnEffects = Object.values(preInitialSnapshot.children).filter(Boolean).map(actor => dist_xstateActors.createSpawnEffect(actor));
   const first = dist_xstateActors.initialMicrostep(machine.root, preInitialSnapshot, actorScope, initEvent, internalQueue);
   const {
     microsteps
-  } = dist_xstateActors.macrostep(first[0], initEvent, actorScope, internalQueue);
-  return [first, ...microsteps];
+  } = dist_xstateActors.macrostep(first[0], initEvent, actorScope, internalQueue, [[first[0], [...contextSpawnEffects, ...first[1]]]]);
+  return attachMicrostepActorRefs(microsteps, actorScope);
 }
 
 /**
@@ -2718,6 +2696,7 @@ exports.createListenerLogic = dist_xstateActors.createListenerLogic;
 exports.createLogic = dist_xstateActors.createLogic;
 exports.createObservableLogic = dist_xstateActors.createObservableLogic;
 exports.createSubscriptionLogic = dist_xstateActors.createSubscriptionLogic;
+exports.executeEffects = dist_xstateActors.executeEffects;
 exports.getStateNodes = dist_xstateActors.getStateNodes;
 exports.isBuiltInExecutableAction = dist_xstateActors.isBuiltInExecutableAction;
 exports.isMachineSnapshot = dist_xstateActors.isMachineSnapshot;
@@ -2728,6 +2707,8 @@ exports.subscriptionLogic = dist_xstateActors.subscriptionLogic;
 exports.toObserver = dist_xstateActors.toObserver;
 exports.StateMachine = StateMachine.StateMachine;
 exports.StateNode = StateMachine.StateNode;
+exports.getInitialSnapshot = StateMachine.getInitialSnapshot;
+exports.getNextSnapshot = StateMachine.getNextSnapshot;
 exports.SimulatedClock = SimulatedClock;
 exports.SpecialTargets = SpecialTargets;
 exports.assertEvent = assertEvent;
@@ -2737,9 +2718,7 @@ exports.createMachineFromConfig = createMachineFromConfig;
 exports.createStateConfig = createStateConfig;
 exports.createSystem = createSystem;
 exports.getInitialMicrosteps = getInitialMicrosteps;
-exports.getInitialSnapshot = getInitialSnapshot;
 exports.getMicrosteps = getMicrosteps;
-exports.getNextSnapshot = getNextSnapshot;
 exports.getNextTransitions = getNextTransitions;
 exports.initialTransition = initialTransition;
 exports.isTypeSchema = isTypeSchema;

package/dist/xstate.development.cjs.mjs

@@ -22,6 +22,7 @@ export {
   createStateConfig,
   createSubscriptionLogic,
   createSystem,
+  executeEffects,
   getInitialMicrosteps,
   getInitialSnapshot,
   getMicrosteps,