xstate 6.0.0-alpha.62 → 6.0.0-alpha.64

package/README.md

@@ -17,6 +17,30 @@ 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. 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-8dfa9b5c.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;
 }
 
 /**
@@ -1121,6 +1144,8 @@ function getBuiltInActionFields(action, args) {
       return undefined;
   }
 }
+
+/** @internal Creates an actor-start effect, including for restored children. */
 function createStartEffect(actor) {
   const args = [actor];
   return {
@@ -1134,6 +1159,41 @@ function createStartEffect(actor) {
     id: actor.id
   };
 }
+
+/** @internal Recreates a pending logical timer without re-entering its state. */
+function createTimerEffect(actorScope, timer, delay) {
+  const source = actorScope.self;
+  const options = {
+    id: timer.id,
+    delay
+  };
+  if (timer.type === '@xstate.raise') {
+    return {
+      kind: 'builtin',
+      type: timer.type,
+      source,
+      event: timer.event,
+      id: timer.id,
+      delay,
+      params: undefined,
+      args: [actorScope, timer.event, options],
+      exec: execRaiseEffect
+    };
+  }
+  const target = timer.target === 'self' ? source : timer.target;
+  return {
+    kind: 'builtin',
+    type: timer.type,
+    source,
+    target,
+    event: timer.event,
+    id: timer.id,
+    delay,
+    params: undefined,
+    args: [actorScope, target, timer.event, options],
+    exec: execSendToEffect
+  };
+}
 function createSpawnEffect(actor) {
   const args = [actor];
   return {
@@ -4015,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];
@@ -4046,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,
@@ -6215,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;
@@ -6227,7 +6289,9 @@ exports.createMachineSnapshot = createMachineSnapshot;
 exports.createRemoteActorRef = createRemoteActorRef;
 exports.createSendToEffect = createSendToEffect;
 exports.createSpawnEffect = createSpawnEffect;
+exports.createStartEffect = createStartEffect;
 exports.createSubscriptionLogic = createSubscriptionLogic;
+exports.createTimerEffect = createTimerEffect;
 exports.deliverEvent = deliverEvent;
 exports.encodeAddressSegment = encodeAddressSegment;
 exports.evaluateCandidate = evaluateCandidate;
@@ -6248,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;
@@ -6271,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;
@@ -6281,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-6d6bfee1.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;
 }
 
 /**
@@ -1131,6 +1154,8 @@ function getBuiltInActionFields(action, args) {
       return undefined;
   }
 }
+
+/** @internal Creates an actor-start effect, including for restored children. */
 function createStartEffect(actor) {
   const args = [actor];
   return {
@@ -1144,6 +1169,41 @@ function createStartEffect(actor) {
     id: actor.id
   };
 }
+
+/** @internal Recreates a pending logical timer without re-entering its state. */
+function createTimerEffect(actorScope, timer, delay) {
+  const source = actorScope.self;
+  const options = {
+    id: timer.id,
+    delay
+  };
+  if (timer.type === '@xstate.raise') {
+    return {
+      kind: 'builtin',
+      type: timer.type,
+      source,
+      event: timer.event,
+      id: timer.id,
+      delay,
+      params: undefined,
+      args: [actorScope, timer.event, options],
+      exec: execRaiseEffect
+    };
+  }
+  const target = timer.target === 'self' ? source : timer.target;
+  return {
+    kind: 'builtin',
+    type: timer.type,
+    source,
+    target,
+    event: timer.event,
+    id: timer.id,
+    delay,
+    params: undefined,
+    args: [actorScope, target, timer.event, options],
+    exec: execSendToEffect
+  };
+}
 function createSpawnEffect(actor) {
   const args = [actor];
   return {
@@ -4121,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];
@@ -4152,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,
@@ -6358,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;
@@ -6370,7 +6432,9 @@ exports.createMachineSnapshot = createMachineSnapshot;
 exports.createRemoteActorRef = createRemoteActorRef;
 exports.createSendToEffect = createSendToEffect;
 exports.createSpawnEffect = createSpawnEffect;
+exports.createStartEffect = createStartEffect;
 exports.createSubscriptionLogic = createSubscriptionLogic;
+exports.createTimerEffect = createTimerEffect;
 exports.deliverEvent = deliverEvent;
 exports.encodeAddressSegment = encodeAddressSegment;
 exports.evaluateCandidate = evaluateCandidate;
@@ -6391,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;
@@ -6414,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;
@@ -6424,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-f9b188f2.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;
 }
 
 /**
@@ -1119,6 +1142,8 @@ function getBuiltInActionFields(action, args) {
       return undefined;
   }
 }
+
+/** @internal Creates an actor-start effect, including for restored children. */
 function createStartEffect(actor) {
   const args = [actor];
   return {
@@ -1132,6 +1157,41 @@ function createStartEffect(actor) {
     id: actor.id
   };
 }
+
+/** @internal Recreates a pending logical timer without re-entering its state. */
+function createTimerEffect(actorScope, timer, delay) {
+  const source = actorScope.self;
+  const options = {
+    id: timer.id,
+    delay
+  };
+  if (timer.type === '@xstate.raise') {
+    return {
+      kind: 'builtin',
+      type: timer.type,
+      source,
+      event: timer.event,
+      id: timer.id,
+      delay,
+      params: undefined,
+      args: [actorScope, timer.event, options],
+      exec: execRaiseEffect
+    };
+  }
+  const target = timer.target === 'self' ? source : timer.target;
+  return {
+    kind: 'builtin',
+    type: timer.type,
+    source,
+    target,
+    event: timer.event,
+    id: timer.id,
+    delay,
+    params: undefined,
+    args: [actorScope, target, timer.event, options],
+    exec: execSendToEffect
+  };
+}
 function createSpawnEffect(actor) {
   const args = [actor];
   return {
@@ -4013,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];
@@ -4044,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,
@@ -6191,4 +6251,4 @@ function createActor(logic, ...[options]) {
   return new Actor(logic, options);
 }
 
-export { ACTOR_REF_TYPE 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, toStatePath as R, STATE_DELIMITER as S, isStateId as T, getStateNodeByPath as U, getPersistedSnapshot as V, createRemoteActorRef as W, XSTATE_TIMER as X, resolveReferencedActor as Y, createInvokeTimeoutEvent as Z, parseGeneratedActorId as _, allocateChildId as a, createActor as a0, parseDelayToMilliseconds as a1, isAtomicStateNode as a2, ProcessingStatus as a3, isActorRefLike as a4, createListenerLogic as a5, createSubscriptionLogic as a6, listenerLogic as a7, subscriptionLogic as a8, Actor as a9, getAllOwnEvents as aA, matchesEvent as aB, encodeAddressSegment as aC, getRootActorId as aD, RUNTIME_OPERATIONS as aE, withSystemInspector as aF, getSnapshotActorRef as aG, withExecutionIdentity as aH, isMachineSnapshot as aa, InfiniteTransitionError as ab, getAllOwnEventDescriptors as ac, matchesState as ad, checkStateIn as ae, pathToStateValue as af, toObserver as ag, executeEffects as ah, isBuiltInExecutableAction as ai, deliverEvent as aj, runStep as ak, stopActor as al, terminateActor as am, XSTATE_STOP as an, createCustomEffect as ao, XSTATE_LOGIC_EFFECT_START as ap, XSTATE_LOGIC_EFFECT_RESOLVE as aq, XSTATE_LOGIC_EFFECT_REJECT as ar, finalizeTransitionResult as as, createEmitEffect as at, createSendToEffect as au, XSTATE_INIT as av, hasAmbientInspector as aw, getProperAncestors as ax, isRemoteActorRef as ay, getActorIdPrefix 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-55f62c08.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;
 }
 
 /**
@@ -1129,6 +1152,8 @@ function getBuiltInActionFields(action, args) {
       return undefined;
   }
 }
+
+/** @internal Creates an actor-start effect, including for restored children. */
 function createStartEffect(actor) {
   const args = [actor];
   return {
@@ -1142,6 +1167,41 @@ function createStartEffect(actor) {
     id: actor.id
   };
 }
+
+/** @internal Recreates a pending logical timer without re-entering its state. */
+function createTimerEffect(actorScope, timer, delay) {
+  const source = actorScope.self;
+  const options = {
+    id: timer.id,
+    delay
+  };
+  if (timer.type === '@xstate.raise') {
+    return {
+      kind: 'builtin',
+      type: timer.type,
+      source,
+      event: timer.event,
+      id: timer.id,
+      delay,
+      params: undefined,
+      args: [actorScope, timer.event, options],
+      exec: execRaiseEffect
+    };
+  }
+  const target = timer.target === 'self' ? source : timer.target;
+  return {
+    kind: 'builtin',
+    type: timer.type,
+    source,
+    target,
+    event: timer.event,
+    id: timer.id,
+    delay,
+    params: undefined,
+    args: [actorScope, target, timer.event, options],
+    exec: execSendToEffect
+  };
+}
 function createSpawnEffect(actor) {
   const args = [actor];
   return {
@@ -4119,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];
@@ -4150,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,
@@ -6334,4 +6394,4 @@ function createActor(logic, ...[options]) {
   return new Actor(logic, options);
 }
 
-export { ACTOR_REF_TYPE 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, toStatePath as R, STATE_DELIMITER as S, isStateId as T, getStateNodeByPath as U, getPersistedSnapshot as V, createRemoteActorRef as W, XSTATE_TIMER as X, resolveReferencedActor as Y, createInvokeTimeoutEvent as Z, parseGeneratedActorId as _, allocateChildId as a, createActor as a0, parseDelayToMilliseconds as a1, isAtomicStateNode as a2, ProcessingStatus as a3, isActorRefLike as a4, createListenerLogic as a5, createSubscriptionLogic as a6, listenerLogic as a7, subscriptionLogic as a8, Actor as a9, getAllOwnEvents as aA, matchesEvent as aB, encodeAddressSegment as aC, getRootActorId as aD, RUNTIME_OPERATIONS as aE, withSystemInspector as aF, getSnapshotActorRef as aG, withExecutionIdentity as aH, isMachineSnapshot as aa, InfiniteTransitionError as ab, getAllOwnEventDescriptors as ac, matchesState as ad, checkStateIn as ae, pathToStateValue as af, toObserver as ag, executeEffects as ah, isBuiltInExecutableAction as ai, deliverEvent as aj, runStep as ak, stopActor as al, terminateActor as am, XSTATE_STOP as an, createCustomEffect as ao, XSTATE_LOGIC_EFFECT_START as ap, XSTATE_LOGIC_EFFECT_RESOLVE as aq, XSTATE_LOGIC_EFFECT_REJECT as ar, finalizeTransitionResult as as, createEmitEffect as at, createSendToEffect as au, XSTATE_INIT as av, hasAmbientInspector as aw, getProperAncestors as ax, isRemoteActorRef as ay, getActorIdPrefix 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/StateMachine.d.ts

@@ -140,7 +140,7 @@ export declare class StateMachine<TContext extends MachineContext, TEvent extend
      */
     getInitialSnapshot(actorScope?: ActorScope<MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, TEvent, AnyActorSystem, TEmitted>, input?: TInput): MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>;
     initialTransition(input: TInput | undefined, actorScope?: ActorScope<MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, TEvent, AnyActorSystem, TEmitted>): ActorLogicTransitionResult<MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, ExecutableActionObjectFromLogic<this>>;
-    start(snapshot?: MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>): void;
+    start(snapshot?: MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, actorScope?: ActorScope<MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, TEvent, AnyActorSystem, TEmitted>): void;
     getStateNodeById(stateId: string): StateNode<TContext, TEvent, TMeta, TTransitionMeta>;
     getPersistedSnapshot(snapshot: MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, options?: unknown): Snapshot<unknown>;
     restoreSnapshot(snapshot: Snapshot<unknown>, actorScope?: ActorScope<MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>, TEvent, AnyActorSystem, TEmitted>): MachineSnapshot<TContext, TEvent, TChildren, TStateValue, TTag, TOutput, TMeta, TConfig>;