xstate 6.0.0-alpha.63 → 6.0.0-alpha.64

package/README.md

@@ -17,12 +17,29 @@ XState is a state management and orchestration solution for JavaScript and TypeS
 
 It uses event-driven programming, state machines, statecharts, and the actor model to handle complex logic in predictable, robust, and visual ways. XState provides a powerful and flexible way to manage application and workflow state by allowing developers to model logic as actors and state machines.
 
+<!-- experimental whole-system transitions from packages/core/src/systemTransition.ts -->
+
+For pure actor-system simulation, `initialSystemTransition`, `systemTransition`
+and `advanceSystemTime` return an immutable system snapshot and external effects
+as data. Branch or replay actors, messages and virtual timers without starting live
+actors. See [pure system transitions](../../docs/system-transitions.md).
+
 <!-- durable execution and checkpoint restoration from packages/core/src/durable/index.ts -->
 
 For durable hosts, the experimental `xstate/durable` entry point provides
 `createDurable`. Resume a checkpoint with `execution.restore(persistedSnapshot)`
 and execute the returned effects to restart active embedded children and pending
-timers without replaying entry actions. See [durable execution](../../docs/durable-execution.md).
+timers without replaying entry actions. Await `executeEffects()` before persisting
+to retain accepted timer deadlines. The host handles root error snapshots;
+`run()` rejects with the root error. See [durable execution](../../docs/durable-execution.md).
+
+<!-- typed inline invocation from packages/core/src/setup.ts -->
+
+Use `s.createInvoke({ src, input, onDone })` inline in `s.createMachine(...)` for an actor used in one state. It infers the actor's input and output and the enclosing state's narrowed context without registering that actor in `setup.actors`. See [typed inline invokes](../../docs/invoke.md#typed-inline-invokes).
+
+Pass an async function directly as `src`, with `schemas.input`, `schemas.output`, and `schemas.error` on the same invoke. Output also infers from the async return when its schema is omitted. Existing logic values use their own schemas.
+
+The helper requires input for actors whose input excludes `undefined`, and checks child IDs and source compatibility against `schemas.children` declared in the setup or machine.
 
 For flat finite state machines, `xstate/fsm` provides a tiny pure transition
 table with context and TypeScript support:

package/dist/{createActor-eba8226e.cjs.js → createActor-29adb8a4.cjs.js}

@@ -183,6 +183,20 @@ function reportUnhandledError(err) {
 
 const symbolObservable = (() => typeof Symbol === 'function' && Symbol.observable || '@@observable')();
 
+// Runtime metadata stays outside pure snapshots. Timer objects survive unrelated
+// transitions; a cancelled/replaced timer gets a new object and a new deadline.
+const starts = new WeakMap();
+
+/** @internal */
+function getTimerStart(timer) {
+  return starts.get(timer) ?? timer.startedAt;
+}
+
+/** @internal */
+function recordTimerStart(timer, startedAt) {
+  starts.set(timer, startedAt);
+}
+
 function assertSendToEvent(event) {
   if (typeof event === 'string') {
     throw new Error(`Only event objects may be used with sendTo`);
@@ -240,6 +254,9 @@ function resolveRegisteredActorSource(actors, logic) {
   return cache.get(logic);
 }
 
+/** Static scheduling metadata on actor definitions, never on live actors. @internal */
+const systemLogicMetadata = Symbol('xstate.systemLogicMetadata');
+
 const subscriptions = /* #__PURE__ */new WeakMap();
 
 /**
@@ -258,7 +275,7 @@ id) {
     error: undefined,
     input
   }, []];
-  return {
+  const logic = {
     id,
     start: (state, {
       self,
@@ -322,6 +339,12 @@ id) {
     getPersistedSnapshot: snapshot => snapshot,
     restoreSnapshot: snapshot => snapshot
   };
+  Object.defineProperty(logic, systemLogicMetadata, {
+    value: {
+      kind: id
+    }
+  });
+  return logic;
 }
 
 /**
@@ -4052,7 +4075,7 @@ function getPersistedSnapshot(snapshot, options) {
   // readings (a simulated clock, a monotonic counter) are meaningless in any
   // other process, and restoring them under the wall clock would fire every
   // pending delay instantly. Pure-transition snapshots have no local
-  // schedule and persist no timestamp.
+  // schedule; durable executions record an accepted start separately.
   const scheduledTimers = snapshotActor?.system?._clock?.now ? undefined : snapshotActor?.system?._snapshot?._scheduledTimers;
   for (const id in timers) {
     const timer = timers[id];
@@ -4083,10 +4106,10 @@ function getPersistedSnapshot(snapshot, options) {
     // deadline. Derived from dueAt, not the scheduling moment, so repeated
     // persist/restore cycles keep the same deadline. Without a live schedule
     // (a restored-but-never-started actor, a pure-transition snapshot) the
-    // timer's carried-in start — which only a wall-clock actor ever stamped —
-    // passes through, so re-persisting cannot push the deadline back.
+    // timer's accepted durable start or carried-in start passes through,
+    // so re-persisting cannot push the deadline back.
     const scheduled = scheduledTimers?.[`${snapshotActor.sessionId}.${id}`];
-    const startedAt = scheduled ? scheduled.dueAt - timer.delay : timer.startedAt;
+    const startedAt = scheduled ? scheduled.dueAt - timer.delay : getTimerStart(timer);
     timersJson[id] = {
       id: timer.id,
       delay: timer.delay,
@@ -6252,7 +6275,9 @@ exports.cloneMachineSnapshot = cloneMachineSnapshot;
 exports.createActor = createActor;
 exports.createCustomEffect = createCustomEffect;
 exports.createDeadLetterEffect = createDeadLetterEffect;
+exports.createDoneActorEvent = createDoneActorEvent;
 exports.createEmitEffect = createEmitEffect;
+exports.createErrorActorEvent = createErrorActorEvent;
 exports.createErrorPlatformEvent = createErrorPlatformEvent;
 exports.createInertActorScope = createInertActorScope;
 exports.createInitEvent = createInitEvent;
@@ -6287,6 +6312,7 @@ exports.getRootActorId = getRootActorId;
 exports.getSnapshotActorRef = getSnapshotActorRef;
 exports.getStateNodeByPath = getStateNodeByPath;
 exports.getStateNodes = getStateNodes;
+exports.getTimerStart = getTimerStart;
 exports.getTransitionResult = getTransitionResult;
 exports.hasAmbientInspector = hasAmbientInspector;
 exports.hasEffect = hasEffect;
@@ -6310,6 +6336,7 @@ exports.mergeActorIdCounters = mergeActorIdCounters;
 exports.parseDelayToMilliseconds = parseDelayToMilliseconds;
 exports.parseGeneratedActorId = parseGeneratedActorId;
 exports.pathToStateValue = pathToStateValue;
+exports.recordTimerStart = recordTimerStart;
 exports.reserveChildId = reserveChildId;
 exports.resolveActionsWithContext = resolveActionsWithContext;
 exports.resolveReferencedActor = resolveReferencedActor;
@@ -6320,6 +6347,7 @@ exports.setInertActorScopeSnapshot = setInertActorScopeSnapshot;
 exports.setSnapshotActorRef = setSnapshotActorRef;
 exports.stopActor = stopActor;
 exports.subscriptionLogic = subscriptionLogic;
+exports.systemLogicMetadata = systemLogicMetadata;
 exports.takeSpawnAllocationCounters = takeSpawnAllocationCounters;
 exports.terminateActor = terminateActor;
 exports.toArray = toArray;

package/dist/{createActor-f71670cf.development.cjs.js → createActor-521c8805.development.cjs.js}

@@ -183,6 +183,20 @@ function reportUnhandledError(err) {
 
 const symbolObservable = (() => typeof Symbol === 'function' && Symbol.observable || '@@observable')();
 
+// Runtime metadata stays outside pure snapshots. Timer objects survive unrelated
+// transitions; a cancelled/replaced timer gets a new object and a new deadline.
+const starts = new WeakMap();
+
+/** @internal */
+function getTimerStart(timer) {
+  return starts.get(timer) ?? timer.startedAt;
+}
+
+/** @internal */
+function recordTimerStart(timer, startedAt) {
+  starts.set(timer, startedAt);
+}
+
 function assertSendToEvent(event) {
   if (typeof event === 'string') {
     throw new Error(// eslint-disable-next-line @typescript-eslint/restrict-template-expressions
@@ -241,6 +255,9 @@ function resolveRegisteredActorSource(actors, logic) {
   return cache.get(logic);
 }
 
+/** Static scheduling metadata on actor definitions, never on live actors. @internal */
+const systemLogicMetadata = Symbol('xstate.systemLogicMetadata');
+
 const subscriptions = /* #__PURE__ */new WeakMap();
 
 /**
@@ -259,7 +276,7 @@ id) {
     error: undefined,
     input
   }, []];
-  return {
+  const logic = {
     id,
     start: (state, {
       self,
@@ -323,6 +340,12 @@ id) {
     getPersistedSnapshot: snapshot => snapshot,
     restoreSnapshot: snapshot => snapshot
   };
+  Object.defineProperty(logic, systemLogicMetadata, {
+    value: {
+      kind: id
+    }
+  });
+  return logic;
 }
 
 /**
@@ -4158,7 +4181,7 @@ function getPersistedSnapshot(snapshot, options) {
   // readings (a simulated clock, a monotonic counter) are meaningless in any
   // other process, and restoring them under the wall clock would fire every
   // pending delay instantly. Pure-transition snapshots have no local
-  // schedule and persist no timestamp.
+  // schedule; durable executions record an accepted start separately.
   const scheduledTimers = snapshotActor?.system?._clock?.now ? undefined : snapshotActor?.system?._snapshot?._scheduledTimers;
   for (const id in timers) {
     const timer = timers[id];
@@ -4189,10 +4212,10 @@ function getPersistedSnapshot(snapshot, options) {
     // deadline. Derived from dueAt, not the scheduling moment, so repeated
     // persist/restore cycles keep the same deadline. Without a live schedule
     // (a restored-but-never-started actor, a pure-transition snapshot) the
-    // timer's carried-in start — which only a wall-clock actor ever stamped —
-    // passes through, so re-persisting cannot push the deadline back.
+    // timer's accepted durable start or carried-in start passes through,
+    // so re-persisting cannot push the deadline back.
     const scheduled = scheduledTimers?.[`${snapshotActor.sessionId}.${id}`];
-    const startedAt = scheduled ? scheduled.dueAt - timer.delay : timer.startedAt;
+    const startedAt = scheduled ? scheduled.dueAt - timer.delay : getTimerStart(timer);
     timersJson[id] = {
       id: timer.id,
       delay: timer.delay,
@@ -6395,7 +6418,9 @@ exports.cloneMachineSnapshot = cloneMachineSnapshot;
 exports.createActor = createActor;
 exports.createCustomEffect = createCustomEffect;
 exports.createDeadLetterEffect = createDeadLetterEffect;
+exports.createDoneActorEvent = createDoneActorEvent;
 exports.createEmitEffect = createEmitEffect;
+exports.createErrorActorEvent = createErrorActorEvent;
 exports.createErrorPlatformEvent = createErrorPlatformEvent;
 exports.createInertActorScope = createInertActorScope;
 exports.createInitEvent = createInitEvent;
@@ -6430,6 +6455,7 @@ exports.getRootActorId = getRootActorId;
 exports.getSnapshotActorRef = getSnapshotActorRef;
 exports.getStateNodeByPath = getStateNodeByPath;
 exports.getStateNodes = getStateNodes;
+exports.getTimerStart = getTimerStart;
 exports.getTransitionResult = getTransitionResult;
 exports.hasAmbientInspector = hasAmbientInspector;
 exports.hasEffect = hasEffect;
@@ -6453,6 +6479,7 @@ exports.mergeActorIdCounters = mergeActorIdCounters;
 exports.parseDelayToMilliseconds = parseDelayToMilliseconds;
 exports.parseGeneratedActorId = parseGeneratedActorId;
 exports.pathToStateValue = pathToStateValue;
+exports.recordTimerStart = recordTimerStart;
 exports.reserveChildId = reserveChildId;
 exports.resolveActionsWithContext = resolveActionsWithContext;
 exports.resolveReferencedActor = resolveReferencedActor;
@@ -6463,6 +6490,7 @@ exports.setInertActorScopeSnapshot = setInertActorScopeSnapshot;
 exports.setSnapshotActorRef = setSnapshotActorRef;
 exports.stopActor = stopActor;
 exports.subscriptionLogic = subscriptionLogic;
+exports.systemLogicMetadata = systemLogicMetadata;
 exports.takeSpawnAllocationCounters = takeSpawnAllocationCounters;
 exports.terminateActor = terminateActor;
 exports.toArray = toArray;

package/dist/{createActor-523a98c7.esm.js → createActor-8493caa9.esm.js}

@@ -181,6 +181,20 @@ function reportUnhandledError(err) {
 
 const symbolObservable = (() => typeof Symbol === 'function' && Symbol.observable || '@@observable')();
 
+// Runtime metadata stays outside pure snapshots. Timer objects survive unrelated
+// transitions; a cancelled/replaced timer gets a new object and a new deadline.
+const starts = new WeakMap();
+
+/** @internal */
+function getTimerStart(timer) {
+  return starts.get(timer) ?? timer.startedAt;
+}
+
+/** @internal */
+function recordTimerStart(timer, startedAt) {
+  starts.set(timer, startedAt);
+}
+
 function assertSendToEvent(event) {
   if (typeof event === 'string') {
     throw new Error(`Only event objects may be used with sendTo`);
@@ -238,6 +252,9 @@ function resolveRegisteredActorSource(actors, logic) {
   return cache.get(logic);
 }
 
+/** Static scheduling metadata on actor definitions, never on live actors. @internal */
+const systemLogicMetadata = Symbol('xstate.systemLogicMetadata');
+
 const subscriptions = /* #__PURE__ */new WeakMap();
 
 /**
@@ -256,7 +273,7 @@ id) {
     error: undefined,
     input
   }, []];
-  return {
+  const logic = {
     id,
     start: (state, {
       self,
@@ -320,6 +337,12 @@ id) {
     getPersistedSnapshot: snapshot => snapshot,
     restoreSnapshot: snapshot => snapshot
   };
+  Object.defineProperty(logic, systemLogicMetadata, {
+    value: {
+      kind: id
+    }
+  });
+  return logic;
 }
 
 /**
@@ -4050,7 +4073,7 @@ function getPersistedSnapshot(snapshot, options) {
   // readings (a simulated clock, a monotonic counter) are meaningless in any
   // other process, and restoring them under the wall clock would fire every
   // pending delay instantly. Pure-transition snapshots have no local
-  // schedule and persist no timestamp.
+  // schedule; durable executions record an accepted start separately.
   const scheduledTimers = snapshotActor?.system?._clock?.now ? undefined : snapshotActor?.system?._snapshot?._scheduledTimers;
   for (const id in timers) {
     const timer = timers[id];
@@ -4081,10 +4104,10 @@ function getPersistedSnapshot(snapshot, options) {
     // deadline. Derived from dueAt, not the scheduling moment, so repeated
     // persist/restore cycles keep the same deadline. Without a live schedule
     // (a restored-but-never-started actor, a pure-transition snapshot) the
-    // timer's carried-in start — which only a wall-clock actor ever stamped —
-    // passes through, so re-persisting cannot push the deadline back.
+    // timer's accepted durable start or carried-in start passes through,
+    // so re-persisting cannot push the deadline back.
     const scheduled = scheduledTimers?.[`${snapshotActor.sessionId}.${id}`];
-    const startedAt = scheduled ? scheduled.dueAt - timer.delay : timer.startedAt;
+    const startedAt = scheduled ? scheduled.dueAt - timer.delay : getTimerStart(timer);
     timersJson[id] = {
       id: timer.id,
       delay: timer.delay,
@@ -6228,4 +6251,4 @@ function createActor(logic, ...[options]) {
   return new Actor(logic, options);
 }
 
-export { parseGeneratedActorId as $, attachSnapshotActorRef as A, macrostep as B, isInertActorScope as C, setSnapshotActorRef as D, cloneMachineSnapshot as E, transitionNode as F, getTransitionResult as G, hasEffect as H, createErrorPlatformEvent as I, withActorSelf as J, resolveActionsWithContext as K, takeSpawnAllocationCounters as L, mergeActorIdCounters as M, NULL_EVENT as N, createInitEvent as O, createSpawnEffect as P, initialMicrostep as Q, createStartEffect as R, STATE_DELIMITER as S, toStatePath as T, isStateId as U, getStateNodeByPath as V, getPersistedSnapshot as W, XSTATE_TIMER as X, createRemoteActorRef as Y, resolveReferencedActor as Z, createInvokeTimeoutEvent as _, allocateChildId as a, ACTOR_REF_TYPE as a0, createActor as a1, parseDelayToMilliseconds as a2, isAtomicStateNode as a3, ProcessingStatus as a4, isActorRefLike as a5, createListenerLogic as a6, createSubscriptionLogic as a7, listenerLogic as a8, subscriptionLogic as a9, getActorIdPrefix as aA, getAllOwnEvents as aB, matchesEvent as aC, encodeAddressSegment as aD, getRootActorId as aE, RUNTIME_OPERATIONS as aF, withSystemInspector as aG, createTimerEffect as aH, getSnapshotActorRef as aI, withExecutionIdentity as aJ, Actor as aa, isMachineSnapshot as ab, InfiniteTransitionError as ac, getAllOwnEventDescriptors as ad, matchesState as ae, checkStateIn as af, pathToStateValue as ag, toObserver as ah, executeEffects as ai, isBuiltInExecutableAction as aj, deliverEvent as ak, runStep as al, stopActor as am, terminateActor as an, XSTATE_STOP as ao, createCustomEffect as ap, XSTATE_LOGIC_EFFECT_START as aq, XSTATE_LOGIC_EFFECT_RESOLVE as ar, XSTATE_LOGIC_EFFECT_REJECT as as, finalizeTransitionResult as at, createEmitEffect as au, createSendToEffect as av, XSTATE_INIT as aw, hasAmbientInspector as ax, getProperAncestors as ay, isRemoteActorRef as az, assertChildIdFree as b, reserveChildId as c, mapValues as d, createInvokeId as e, getEventDescriptorKey as f, getDelayedTransitions as g, getCandidates as h, evaluateCandidate as i, formatTransition as j, toTransitionConfigArray as k, createInvokeTimeoutEventId as l, matchesEventDescriptor as m, matchesActorSession as n, formatRouteTransitions as o, resolveStateValue as p, getAllStateNodes as q, resolveRegisteredActorSource as r, getStateNodes as s, toArray as t, createMachineSnapshot as u, isInFinalState as v, createInertActorScope as w, setInertActorScopeSnapshot as x, createDeadLetterEffect as y, beginSpawnAllocation as z };
+export { parseGeneratedActorId as $, attachSnapshotActorRef as A, macrostep as B, isInertActorScope as C, setSnapshotActorRef as D, cloneMachineSnapshot as E, transitionNode as F, getTransitionResult as G, hasEffect as H, createErrorPlatformEvent as I, withActorSelf as J, resolveActionsWithContext as K, takeSpawnAllocationCounters as L, mergeActorIdCounters as M, NULL_EVENT as N, createInitEvent as O, createSpawnEffect as P, initialMicrostep as Q, createStartEffect as R, STATE_DELIMITER as S, toStatePath as T, isStateId as U, getStateNodeByPath as V, getPersistedSnapshot as W, XSTATE_TIMER as X, createRemoteActorRef as Y, resolveReferencedActor as Z, createInvokeTimeoutEvent as _, allocateChildId as a, ACTOR_REF_TYPE as a0, createActor as a1, parseDelayToMilliseconds as a2, isAtomicStateNode as a3, ProcessingStatus as a4, isActorRefLike as a5, encodeAddressSegment as a6, systemLogicMetadata as a7, getActorIdPrefix as a8, finalizeTransitionResult as a9, createSendToEffect as aA, XSTATE_INIT as aB, hasAmbientInspector as aC, getProperAncestors as aD, isRemoteActorRef as aE, getAllOwnEvents as aF, matchesEvent as aG, getRootActorId as aH, RUNTIME_OPERATIONS as aI, withSystemInspector as aJ, createTimerEffect as aK, getSnapshotActorRef as aL, withExecutionIdentity as aM, getTimerStart as aN, recordTimerStart as aO, createDoneActorEvent as aa, createErrorActorEvent as ab, isMachineSnapshot as ac, listenerLogic as ad, subscriptionLogic as ae, createListenerLogic as af, createSubscriptionLogic as ag, Actor as ah, InfiniteTransitionError as ai, getAllOwnEventDescriptors as aj, matchesState as ak, checkStateIn as al, pathToStateValue as am, toObserver as an, executeEffects as ao, isBuiltInExecutableAction as ap, deliverEvent as aq, runStep as ar, stopActor as as, terminateActor as at, XSTATE_STOP as au, createCustomEffect as av, XSTATE_LOGIC_EFFECT_START as aw, XSTATE_LOGIC_EFFECT_RESOLVE as ax, XSTATE_LOGIC_EFFECT_REJECT as ay, createEmitEffect as az, assertChildIdFree as b, reserveChildId as c, mapValues as d, createInvokeId as e, getEventDescriptorKey as f, getDelayedTransitions as g, getCandidates as h, evaluateCandidate as i, formatTransition as j, toTransitionConfigArray as k, createInvokeTimeoutEventId as l, matchesEventDescriptor as m, matchesActorSession as n, formatRouteTransitions as o, resolveStateValue as p, getAllStateNodes as q, resolveRegisteredActorSource as r, getStateNodes as s, toArray as t, createMachineSnapshot as u, isInFinalState as v, createInertActorScope as w, setInertActorScopeSnapshot as x, createDeadLetterEffect as y, beginSpawnAllocation as z };

package/dist/{createActor-48f753a9.development.esm.js → createActor-bd2527dc.development.esm.js}

@@ -181,6 +181,20 @@ function reportUnhandledError(err) {
 
 const symbolObservable = (() => typeof Symbol === 'function' && Symbol.observable || '@@observable')();
 
+// Runtime metadata stays outside pure snapshots. Timer objects survive unrelated
+// transitions; a cancelled/replaced timer gets a new object and a new deadline.
+const starts = new WeakMap();
+
+/** @internal */
+function getTimerStart(timer) {
+  return starts.get(timer) ?? timer.startedAt;
+}
+
+/** @internal */
+function recordTimerStart(timer, startedAt) {
+  starts.set(timer, startedAt);
+}
+
 function assertSendToEvent(event) {
   if (typeof event === 'string') {
     throw new Error(// eslint-disable-next-line @typescript-eslint/restrict-template-expressions
@@ -239,6 +253,9 @@ function resolveRegisteredActorSource(actors, logic) {
   return cache.get(logic);
 }
 
+/** Static scheduling metadata on actor definitions, never on live actors. @internal */
+const systemLogicMetadata = Symbol('xstate.systemLogicMetadata');
+
 const subscriptions = /* #__PURE__ */new WeakMap();
 
 /**
@@ -257,7 +274,7 @@ id) {
     error: undefined,
     input
   }, []];
-  return {
+  const logic = {
     id,
     start: (state, {
       self,
@@ -321,6 +338,12 @@ id) {
     getPersistedSnapshot: snapshot => snapshot,
     restoreSnapshot: snapshot => snapshot
   };
+  Object.defineProperty(logic, systemLogicMetadata, {
+    value: {
+      kind: id
+    }
+  });
+  return logic;
 }
 
 /**
@@ -4156,7 +4179,7 @@ function getPersistedSnapshot(snapshot, options) {
   // readings (a simulated clock, a monotonic counter) are meaningless in any
   // other process, and restoring them under the wall clock would fire every
   // pending delay instantly. Pure-transition snapshots have no local
-  // schedule and persist no timestamp.
+  // schedule; durable executions record an accepted start separately.
   const scheduledTimers = snapshotActor?.system?._clock?.now ? undefined : snapshotActor?.system?._snapshot?._scheduledTimers;
   for (const id in timers) {
     const timer = timers[id];
@@ -4187,10 +4210,10 @@ function getPersistedSnapshot(snapshot, options) {
     // deadline. Derived from dueAt, not the scheduling moment, so repeated
     // persist/restore cycles keep the same deadline. Without a live schedule
     // (a restored-but-never-started actor, a pure-transition snapshot) the
-    // timer's carried-in start — which only a wall-clock actor ever stamped —
-    // passes through, so re-persisting cannot push the deadline back.
+    // timer's accepted durable start or carried-in start passes through,
+    // so re-persisting cannot push the deadline back.
     const scheduled = scheduledTimers?.[`${snapshotActor.sessionId}.${id}`];
-    const startedAt = scheduled ? scheduled.dueAt - timer.delay : timer.startedAt;
+    const startedAt = scheduled ? scheduled.dueAt - timer.delay : getTimerStart(timer);
     timersJson[id] = {
       id: timer.id,
       delay: timer.delay,
@@ -6371,4 +6394,4 @@ function createActor(logic, ...[options]) {
   return new Actor(logic, options);
 }
 
-export { parseGeneratedActorId as $, attachSnapshotActorRef as A, macrostep as B, isInertActorScope as C, setSnapshotActorRef as D, cloneMachineSnapshot as E, transitionNode as F, getTransitionResult as G, hasEffect as H, createErrorPlatformEvent as I, withActorSelf as J, resolveActionsWithContext as K, takeSpawnAllocationCounters as L, mergeActorIdCounters as M, NULL_EVENT as N, createInitEvent as O, createSpawnEffect as P, initialMicrostep as Q, createStartEffect as R, STATE_DELIMITER as S, toStatePath as T, isStateId as U, getStateNodeByPath as V, getPersistedSnapshot as W, XSTATE_TIMER as X, createRemoteActorRef as Y, resolveReferencedActor as Z, createInvokeTimeoutEvent as _, allocateChildId as a, ACTOR_REF_TYPE as a0, createActor as a1, parseDelayToMilliseconds as a2, isAtomicStateNode as a3, ProcessingStatus as a4, isActorRefLike as a5, createListenerLogic as a6, createSubscriptionLogic as a7, listenerLogic as a8, subscriptionLogic as a9, getActorIdPrefix as aA, getAllOwnEvents as aB, matchesEvent as aC, encodeAddressSegment as aD, getRootActorId as aE, RUNTIME_OPERATIONS as aF, withSystemInspector as aG, createTimerEffect as aH, getSnapshotActorRef as aI, withExecutionIdentity as aJ, Actor as aa, isMachineSnapshot as ab, InfiniteTransitionError as ac, getAllOwnEventDescriptors as ad, matchesState as ae, checkStateIn as af, pathToStateValue as ag, toObserver as ah, executeEffects as ai, isBuiltInExecutableAction as aj, deliverEvent as ak, runStep as al, stopActor as am, terminateActor as an, XSTATE_STOP as ao, createCustomEffect as ap, XSTATE_LOGIC_EFFECT_START as aq, XSTATE_LOGIC_EFFECT_RESOLVE as ar, XSTATE_LOGIC_EFFECT_REJECT as as, finalizeTransitionResult as at, createEmitEffect as au, createSendToEffect as av, XSTATE_INIT as aw, hasAmbientInspector as ax, getProperAncestors as ay, isRemoteActorRef as az, assertChildIdFree as b, reserveChildId as c, mapValues as d, createInvokeId as e, getEventDescriptorKey as f, getDelayedTransitions as g, getCandidates as h, evaluateCandidate as i, formatTransition as j, toTransitionConfigArray as k, createInvokeTimeoutEventId as l, matchesEventDescriptor as m, matchesActorSession as n, formatRouteTransitions as o, resolveStateValue as p, getAllStateNodes as q, resolveRegisteredActorSource as r, getStateNodes as s, toArray as t, createMachineSnapshot as u, isInFinalState as v, createInertActorScope as w, setInertActorScopeSnapshot as x, createDeadLetterEffect as y, beginSpawnAllocation as z };
+export { parseGeneratedActorId as $, attachSnapshotActorRef as A, macrostep as B, isInertActorScope as C, setSnapshotActorRef as D, cloneMachineSnapshot as E, transitionNode as F, getTransitionResult as G, hasEffect as H, createErrorPlatformEvent as I, withActorSelf as J, resolveActionsWithContext as K, takeSpawnAllocationCounters as L, mergeActorIdCounters as M, NULL_EVENT as N, createInitEvent as O, createSpawnEffect as P, initialMicrostep as Q, createStartEffect as R, STATE_DELIMITER as S, toStatePath as T, isStateId as U, getStateNodeByPath as V, getPersistedSnapshot as W, XSTATE_TIMER as X, createRemoteActorRef as Y, resolveReferencedActor as Z, createInvokeTimeoutEvent as _, allocateChildId as a, ACTOR_REF_TYPE as a0, createActor as a1, parseDelayToMilliseconds as a2, isAtomicStateNode as a3, ProcessingStatus as a4, isActorRefLike as a5, encodeAddressSegment as a6, systemLogicMetadata as a7, getActorIdPrefix as a8, finalizeTransitionResult as a9, createSendToEffect as aA, XSTATE_INIT as aB, hasAmbientInspector as aC, getProperAncestors as aD, isRemoteActorRef as aE, getAllOwnEvents as aF, matchesEvent as aG, getRootActorId as aH, RUNTIME_OPERATIONS as aI, withSystemInspector as aJ, createTimerEffect as aK, getSnapshotActorRef as aL, withExecutionIdentity as aM, getTimerStart as aN, recordTimerStart as aO, createDoneActorEvent as aa, createErrorActorEvent as ab, isMachineSnapshot as ac, listenerLogic as ad, subscriptionLogic as ae, createListenerLogic as af, createSubscriptionLogic as ag, Actor as ah, InfiniteTransitionError as ai, getAllOwnEventDescriptors as aj, matchesState as ak, checkStateIn as al, pathToStateValue as am, toObserver as an, executeEffects as ao, isBuiltInExecutableAction as ap, deliverEvent as aq, runStep as ar, stopActor as as, terminateActor as at, XSTATE_STOP as au, createCustomEffect as av, XSTATE_LOGIC_EFFECT_START as aw, XSTATE_LOGIC_EFFECT_RESOLVE as ax, XSTATE_LOGIC_EFFECT_REJECT as ay, createEmitEffect as az, assertChildIdFree as b, reserveChildId as c, mapValues as d, createInvokeId as e, getEventDescriptorKey as f, getDelayedTransitions as g, getCandidates as h, evaluateCandidate as i, formatTransition as j, toTransitionConfigArray as k, createInvokeTimeoutEventId as l, matchesEventDescriptor as m, matchesActorSession as n, formatRouteTransitions as o, resolveStateValue as p, getAllStateNodes as q, resolveRegisteredActorSource as r, getStateNodes as s, toArray as t, createMachineSnapshot as u, isInFinalState as v, createInertActorScope as w, setInertActorScopeSnapshot as x, createDeadLetterEffect as y, beginSpawnAllocation as z };

package/dist/declarations/src/SimulatedClock.d.ts

@@ -7,10 +7,10 @@ export interface SimulatedClock extends Clock {
 }
 export declare class SimulatedClock implements SimulatedClock {
     private timeouts;
+    private readonly deadlines;
     private _now;
     private _id;
     private _flushing;
-    private _flushingInvalidated;
     now(): number;
     private getId;
     setTimeout(fn: (...args: any[]) => void, timeout: number): number;

package/dist/declarations/src/createMachine.d.ts

@@ -1,6 +1,6 @@
 import { StandardSchemaV1 } from "./schema.types.js";
 import { StateMachine } from "./StateMachine.js";
-import { AnyActorRef, EventObject, AnyEventObject, Cast, MachineContext, ProvidedActor, StateValueFromStateSchema, ToChildren, MetaObject, StateSchema, DoNotInfer, RoutableStateId, Compute } from "./types.js";
+import { AnyActorRef, AnyStateMachine, EventObject, AnyEventObject, Cast, MachineContext, ProvidedActor, StateValueFromStateSchema, ToChildren, MetaObject, StateSchema, DoNotInfer, RoutableStateId, Compute } from "./types.js";
 import { ChildCompletionEvents, Sources, DelayMapFromNames, InferChildren, InferMachineInput, InferOutput, SchemaOrConfigOutput, InferEvents, InferInternalEvents, Next_MachineConfig, Next_StateNodeConfig, ValidateDelayReferences, ValidateEventDescriptors, ValidateHistoryDefaults, ValidateStateTargets, ValidateTopLevelFinalOutputs, WidenLiterals, WithDefault } from "./types.v6.js";
 type MergeChildren<TChildren extends Record<string, AnyActorRef | undefined>, TActor extends ProvidedActor> = [keyof TChildren] extends [never] ? Compute<ToChildren<TActor>> : Compute<TChildren>;
 type MachineIdentity<TConfig> = {
@@ -60,7 +60,7 @@ export declare function createMachine<TContextSchema extends StandardSchemaV1, c
         context: TContextSchema;
         children?: TChildrenSchemaMap;
     };
-} & ValidateTopLevelFinalOutputs<TSS, InferOutput<TContextSchema, MachineContext>, InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>>): StateMachine<InferOutput<TContextSchema, MachineContext>, (InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>) | ([RoutableStateId<TSS>] extends [never] ? never : {
+} & ValidateTopLevelFinalOutputs<TSS, InferOutput<TContextSchema, MachineContext>, InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>>): [TSS] extends [never] ? AnyStateMachine : StateMachine<InferOutput<TContextSchema, MachineContext>, (InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>) | ([RoutableStateId<TSS>] extends [never] ? never : {
     type: 'xstate.route';
     to: RoutableStateId<TSS>;
 }), Cast<MergeChildren<InferChildren<TChildrenSchemaMap>, TActor>, Record<string, AnyActorRef | undefined>>, StateValueFromStateSchema<TSS>, TTag & string, InferMachineInput<TInputSchema>, SchemaOrConfigOutput<TOutputSchema, TSS>, WithDefault<InferEvents<TEmittedSchemaMap>, AnyEventObject>, InferOutput<TMetaSchema, MetaObject>, // TMeta
@@ -78,7 +78,7 @@ export declare function createMachine<TContext extends MachineContext = never, c
         input: InferOutput<TInputSchema, unknown>;
         self: any;
     }) => TContext);
-} & ValidateTopLevelFinalOutputs<TSS, WidenLiterals<TContext>, InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>>): StateMachine<WidenLiterals<TContext>, (InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>) | ([RoutableStateId<TSS>] extends [never] ? never : {
+} & ValidateTopLevelFinalOutputs<TSS, WidenLiterals<TContext>, InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>>): [TSS] extends [never] ? AnyStateMachine : StateMachine<WidenLiterals<TContext>, (InferEvents<TEventSchemaMap> | InferInternalEvents<TInternalEventSchemaMap>) | ([RoutableStateId<TSS>] extends [never] ? never : {
     type: 'xstate.route';
     to: RoutableStateId<TSS>;
 }), Cast<MergeChildren<InferChildren<TChildrenSchemaMap>, TActor>, Record<string, AnyActorRef | undefined>>, StateValueFromStateSchema<TSS>, TTag & string, InferMachineInput<TInputSchema>, SchemaOrConfigOutput<TOutputSchema, TSS>, WithDefault<InferEvents<TEmittedSchemaMap>, AnyEventObject>, InferOutput<TMetaSchema, MetaObject>, // TMeta

package/dist/declarations/src/durable/index.d.ts

@@ -57,6 +57,19 @@ export interface DurableEffect<TEffect> extends DurableEffectMetadata {
  * @experimental
  */
 export interface DurableExecutionAdapter<TLogic extends AnyActorLogic> extends Partial<ActorSystemRuntime> {
+    /**
+     * Absolute clock in milliseconds, defaulting to Date.now. Checkpoints and
+     * resumed executions must use the same time origin. Replay hosts should
+     * return the recorded scheduling time rather than the replay's wall clock.
+     */
+    now?(): number;
+    /**
+     * Accepts a timer synchronously, or fulfills its promise when registration
+     * accepts the timer and its delay begins. For a new timer, that acceptance
+     * time is read through now() and persisted. Retried/restored timers retain
+     * their original deadline; hosts must honor it during registration.
+     */
+    scheduleTimer?: ActorSystemRuntime['scheduleTimer'];
     /**
      * Enqueues an event addressed to this execution's root while the durable
      * loop is parked in `waitForEvent()`. Use this when the host only owns the

package/dist/declarations/src/index.d.ts

@@ -12,9 +12,10 @@ export type { ActorValidationBoundary, ActorValidationEventOrigin, ActorValidati
 /** @experimental Used by framework integrations for development hot reloading; not part of the stable API. */
 export { hotSwapActorLogic as _hotSwapActorLogic } from "./hotSwap.js";
 export { createSystem, setup } from "./setup.js";
-export type { ActiveStateContext, AnySetupConfig, RootContextMarker, StrictSetupStateSchemas, StrictSetupStateTargetsFlag, StrictSetupStateTargetsMarker, RelativeSetupStateSchemasMarker, CurrentSetupStateSchemaMarker, SetupStateParentTypeMarker, SetupStateSchemasWithParentType, RootSetupStateSchemasMarker, WithRootSetupStateSchemas, SetupConfig, SetupReturn, SetupReturnFromConfig, SetupSchemas, SystemActorMap, SystemConfig, SystemRuntime, SetupStateSchema, SetupStateSchemas, SetupStateType } from "./setup.js";
+export type { CreateAsyncInvokeConfig, CreateInvokeConfig, CreatedInvoke, ActiveStateContext, AnySetupConfig, RootContextMarker, StrictSetupStateSchemas, StrictSetupStateTargetsFlag, StrictSetupStateTargetsMarker, RelativeSetupStateSchemasMarker, CurrentSetupStateSchemaMarker, SetupStateParentTypeMarker, SetupStateSchemasWithParentType, RootSetupStateSchemasMarker, WithRootSetupStateSchemas, SetupConfig, SetupReturn, SetupReturnFromConfig, SetupSchemas, SystemActorMap, SystemConfig, SystemRuntime, SetupStateSchema, SetupStateSchemas, SetupStateType } from "./setup.js";
 export type { InspectionEvent, ActorInspectionEvent, TransitionInspectionEvent, ActionRecord, SentRecord } from "./inspection.js";
 export { SimulatedClock } from "./SimulatedClock.js";
+export { initialSystemTransition, systemTransition, advanceSystemTime, type SystemLogic, type SystemSnapshot, type SystemActorState, type SystemActorReference, type SystemMessage, type SystemTimer, type SystemExternalEffect, type SystemEffectResult, type InitialSystemTransitionOptions } from "./systemTransition.js";
 /** @experimental Used by `@xstate/scxml`; not part of the stable API. */
 export { parseDelayToMilliseconds as _parseDelayToMilliseconds } from "./delay.js";
 /** @experimental Used by `@xstate/scxml`; not part of the stable API. */