xstate 5.19.3 → 5.19.4

package/dist/{raise-59f80ebb.esm.js → raise-3e01e82a.esm.js}

@@ -13,7 +13,7 @@ class Mailbox {
   }
   clear() {
     // we can't set _current to null because we might be currently processing
-    // and enqueue following clear shouldnt start processing the enqueued item immediately
+    // and enqueue following clear shouldn't start processing the enqueued item immediately
     if (this._current) {
       this._current.next = null;
       this._last = this._current;
@@ -419,6 +419,8 @@ function createSystem(rootActor, options) {
   return system;
 }
 
+// those are needed to make JSDoc `@link` work properly
+
 let executingCustomAction = false;
 const $$ACTOR_TYPE = 1;
 
@@ -2361,7 +2363,7 @@ function macrostep(snapshot, event, actorScope, internalQueue) {
     const transitions = selectTransitions(currentEvent, nextSnapshot);
     if (isErr && !transitions.length) {
       // TODO: we should likely only allow transitions selected by very explicit descriptors
-      // `*` shouldn't be matched, likely `xstate.error.*` shouldnt be either
+      // `*` shouldn't be matched, likely `xstate.error.*` shouldn't be either
       // similarly `xstate.error.actor.*` and `xstate.error.actor.todo.*` have to be considered too
       nextSnapshot = cloneMachineSnapshot(snapshot, {
         status: 'error',

package/dist/{raise-cbaedcda.cjs.js → raise-5872b9e8.cjs.js}

@@ -15,7 +15,7 @@ class Mailbox {
   }
   clear() {
     // we can't set _current to null because we might be currently processing
-    // and enqueue following clear shouldnt start processing the enqueued item immediately
+    // and enqueue following clear shouldn't start processing the enqueued item immediately
     if (this._current) {
       this._current.next = null;
       this._last = this._current;
@@ -421,6 +421,8 @@ function createSystem(rootActor, options) {
   return system;
 }
 
+// those are needed to make JSDoc `@link` work properly
+
 let executingCustomAction = false;
 const $$ACTOR_TYPE = 1;
 
@@ -2363,7 +2365,7 @@ function macrostep(snapshot, event, actorScope, internalQueue) {
     const transitions = selectTransitions(currentEvent, nextSnapshot);
     if (isErr && !transitions.length) {
       // TODO: we should likely only allow transitions selected by very explicit descriptors
-      // `*` shouldn't be matched, likely `xstate.error.*` shouldnt be either
+      // `*` shouldn't be matched, likely `xstate.error.*` shouldn't be either
       // similarly `xstate.error.actor.*` and `xstate.error.actor.todo.*` have to be considered too
       nextSnapshot = cloneMachineSnapshot(snapshot, {
         status: 'error',

package/dist/{raise-527db318.development.esm.js → raise-59549771.development.esm.js}

@@ -13,7 +13,7 @@ class Mailbox {
   }
   clear() {
     // we can't set _current to null because we might be currently processing
-    // and enqueue following clear shouldnt start processing the enqueued item immediately
+    // and enqueue following clear shouldn't start processing the enqueued item immediately
     if (this._current) {
       this._current.next = null;
       this._last = this._current;
@@ -422,6 +422,8 @@ function createSystem(rootActor, options) {
   return system;
 }
 
+// those are needed to make JSDoc `@link` work properly
+
 let executingCustomAction = false;
 const $$ACTOR_TYPE = 1;
 
@@ -2411,7 +2413,7 @@ function macrostep(snapshot, event, actorScope, internalQueue) {
     const transitions = selectTransitions(currentEvent, nextSnapshot);
     if (isErr && !transitions.length) {
       // TODO: we should likely only allow transitions selected by very explicit descriptors
-      // `*` shouldn't be matched, likely `xstate.error.*` shouldnt be either
+      // `*` shouldn't be matched, likely `xstate.error.*` shouldn't be either
       // similarly `xstate.error.actor.*` and `xstate.error.actor.todo.*` have to be considered too
       nextSnapshot = cloneMachineSnapshot(snapshot, {
         status: 'error',

package/dist/{raise-32fab6fb.development.cjs.js → raise-7a84f9f0.development.cjs.js}

@@ -15,7 +15,7 @@ class Mailbox {
   }
   clear() {
     // we can't set _current to null because we might be currently processing
-    // and enqueue following clear shouldnt start processing the enqueued item immediately
+    // and enqueue following clear shouldn't start processing the enqueued item immediately
     if (this._current) {
       this._current.next = null;
       this._last = this._current;
@@ -424,6 +424,8 @@ function createSystem(rootActor, options) {
   return system;
 }
 
+// those are needed to make JSDoc `@link` work properly
+
 exports.executingCustomAction = false;
 const $$ACTOR_TYPE = 1;
 
@@ -2413,7 +2415,7 @@ function macrostep(snapshot, event, actorScope, internalQueue) {
     const transitions = selectTransitions(currentEvent, nextSnapshot);
     if (isErr && !transitions.length) {
       // TODO: we should likely only allow transitions selected by very explicit descriptors
-      // `*` shouldn't be matched, likely `xstate.error.*` shouldnt be either
+      // `*` shouldn't be matched, likely `xstate.error.*` shouldn't be either
       // similarly `xstate.error.actor.*` and `xstate.error.actor.todo.*` have to be considered too
       nextSnapshot = cloneMachineSnapshot(snapshot, {
         status: 'error',

package/dist/xstate.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.cjs.js');
-var guards_dist_xstateGuards = require('./raise-cbaedcda.cjs.js');
-var log = require('./log-179b5431.cjs.js');
+var guards_dist_xstateGuards = require('./raise-5872b9e8.cjs.js');
+var log = require('./log-fa2e731a.cjs.js');
 require('../dev/dist/xstate-dev.cjs.js');
 
 /**
@@ -367,11 +367,10 @@ class StateMachine {
   }
 
   /**
-   * Clones this state machine with the provided implementations and merges the
-   * `context` (if provided).
+   * Clones this state machine with the provided implementations.
    *
-   * @param implementations Options (`actions`, `guards`, `actors`, `delays`,
-   *   `context`) to recursively merge with the existing options.
+   * @param implementations Options (`actions`, `guards`, `actors`, `delays`)
+   *   to recursively merge with the existing options.
    * @returns A new `StateMachine` instance with the provided implementations.
    */
   provide(implementations) {
@@ -536,37 +535,34 @@ class StateMachine {
       });
       children[actorId] = actorRef;
     });
-    function resolveStateNodeFromIdOrPath(idOrPath, root) {
+    function resolveHistoryReferencedState(root, referenced) {
+      if (referenced instanceof StateNode) {
+        return referenced;
+      }
       try {
-        return root.machine.getStateNodeById(idOrPath);
+        return root.machine.getStateNodeById(referenced.id);
       } catch {
-        try {
-          return guards_dist_xstateGuards.getStateNodeByPath(root, idOrPath.split('.'));
-        } catch {
-          return idOrPath;
-        }
       }
     }
-    function reviveHistoryValue(historyValue, root) {
-      if (!historyValue || typeof historyValue !== 'object') return {};
+    function reviveHistoryValue(root, historyValue) {
+      if (!historyValue || typeof historyValue !== 'object') {
+        return {};
+      }
       const revived = {};
       for (const key in historyValue) {
         const arr = historyValue[key];
-        revived[key] = arr.map(item => {
-          if (item instanceof StateNode) return item;
-          if (typeof item === 'object' && 'id' in item && typeof item.id === 'string') {
-            const resolved = resolveStateNodeFromIdOrPath(item.id, root);
-            if (resolved instanceof StateNode) return resolved;
+        for (const item of arr) {
+          const resolved = resolveHistoryReferencedState(root, item);
+          if (!resolved) {
+            continue;
           }
-          return undefined;
-        }).filter(item => item !== undefined);
-        if (revived[key].length === 0) {
-          delete revived[key];
+          revived[key] ??= [];
+          revived[key].push(resolved);
         }
       }
       return revived;
     }
-    const revivedHistoryValue = reviveHistoryValue(snapshot.historyValue, this.root);
+    const revivedHistoryValue = reviveHistoryValue(this.root, snapshot.historyValue);
     const restoredSnapshot = guards_dist_xstateGuards.createMachineSnapshot({
       ...snapshot,
       children,

package/dist/xstate.development.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.development.cjs.js');
-var guards_dist_xstateGuards = require('./raise-32fab6fb.development.cjs.js');
-var log = require('./log-210b28c2.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-7a84f9f0.development.cjs.js');
+var log = require('./log-fadc8808.development.cjs.js');
 require('../dev/dist/xstate-dev.development.cjs.js');
 
 /**
@@ -370,11 +370,10 @@ class StateMachine {
   }
 
   /**
-   * Clones this state machine with the provided implementations and merges the
-   * `context` (if provided).
+   * Clones this state machine with the provided implementations.
    *
-   * @param implementations Options (`actions`, `guards`, `actors`, `delays`,
-   *   `context`) to recursively merge with the existing options.
+   * @param implementations Options (`actions`, `guards`, `actors`, `delays`)
+   *   to recursively merge with the existing options.
    * @returns A new `StateMachine` instance with the provided implementations.
    */
   provide(implementations) {
@@ -539,40 +538,37 @@ class StateMachine {
       });
       children[actorId] = actorRef;
     });
-    function resolveStateNodeFromIdOrPath(idOrPath, root) {
+    function resolveHistoryReferencedState(root, referenced) {
+      if (referenced instanceof StateNode) {
+        return referenced;
+      }
       try {
-        return root.machine.getStateNodeById(idOrPath);
+        return root.machine.getStateNodeById(referenced.id);
       } catch {
-        try {
-          return guards_dist_xstateGuards.getStateNodeByPath(root, idOrPath.split('.'));
-        } catch {
-          {
-            console.warn(`Could not resolve StateNode for id/path: ${idOrPath}`);
-          }
-          return idOrPath;
+        {
+          console.warn(`Could not resolve StateNode for id: ${referenced.id}`);
         }
       }
     }
-    function reviveHistoryValue(historyValue, root) {
-      if (!historyValue || typeof historyValue !== 'object') return {};
+    function reviveHistoryValue(root, historyValue) {
+      if (!historyValue || typeof historyValue !== 'object') {
+        return {};
+      }
       const revived = {};
       for (const key in historyValue) {
         const arr = historyValue[key];
-        revived[key] = arr.map(item => {
-          if (item instanceof StateNode) return item;
-          if (typeof item === 'object' && 'id' in item && typeof item.id === 'string') {
-            const resolved = resolveStateNodeFromIdOrPath(item.id, root);
-            if (resolved instanceof StateNode) return resolved;
+        for (const item of arr) {
+          const resolved = resolveHistoryReferencedState(root, item);
+          if (!resolved) {
+            continue;
           }
-          return undefined;
-        }).filter(item => item !== undefined);
-        if (revived[key].length === 0) {
-          delete revived[key];
+          revived[key] ??= [];
+          revived[key].push(resolved);
         }
       }
       return revived;
     }
-    const revivedHistoryValue = reviveHistoryValue(snapshot.historyValue, this.root);
+    const revivedHistoryValue = reviveHistoryValue(this.root, snapshot.historyValue);
     const restoredSnapshot = guards_dist_xstateGuards.createMachineSnapshot({
       ...snapshot,
       children,

package/dist/xstate.development.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.development.esm.js';
-import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-527db318.development.esm.js';
-export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-527db318.development.esm.js';
-import { a as assign } from './log-b47a3833.development.esm.js';
-export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-b47a3833.development.esm.js';
+import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-59549771.development.esm.js';
+export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-59549771.development.esm.js';
+import { a as assign } from './log-5a7b5528.development.esm.js';
+export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-5a7b5528.development.esm.js';
 import '../dev/dist/xstate-dev.development.esm.js';
 
 /**
@@ -368,11 +368,10 @@ class StateMachine {
   }
 
   /**
-   * Clones this state machine with the provided implementations and merges the
-   * `context` (if provided).
+   * Clones this state machine with the provided implementations.
    *
-   * @param implementations Options (`actions`, `guards`, `actors`, `delays`,
-   *   `context`) to recursively merge with the existing options.
+   * @param implementations Options (`actions`, `guards`, `actors`, `delays`)
+   *   to recursively merge with the existing options.
    * @returns A new `StateMachine` instance with the provided implementations.
    */
   provide(implementations) {
@@ -537,40 +536,37 @@ class StateMachine {
       });
       children[actorId] = actorRef;
     });
-    function resolveStateNodeFromIdOrPath(idOrPath, root) {
+    function resolveHistoryReferencedState(root, referenced) {
+      if (referenced instanceof StateNode) {
+        return referenced;
+      }
       try {
-        return root.machine.getStateNodeById(idOrPath);
+        return root.machine.getStateNodeById(referenced.id);
       } catch {
-        try {
-          return getStateNodeByPath(root, idOrPath.split('.'));
-        } catch {
-          {
-            console.warn(`Could not resolve StateNode for id/path: ${idOrPath}`);
-          }
-          return idOrPath;
+        {
+          console.warn(`Could not resolve StateNode for id: ${referenced.id}`);
         }
       }
     }
-    function reviveHistoryValue(historyValue, root) {
-      if (!historyValue || typeof historyValue !== 'object') return {};
+    function reviveHistoryValue(root, historyValue) {
+      if (!historyValue || typeof historyValue !== 'object') {
+        return {};
+      }
       const revived = {};
       for (const key in historyValue) {
         const arr = historyValue[key];
-        revived[key] = arr.map(item => {
-          if (item instanceof StateNode) return item;
-          if (typeof item === 'object' && 'id' in item && typeof item.id === 'string') {
-            const resolved = resolveStateNodeFromIdOrPath(item.id, root);
-            if (resolved instanceof StateNode) return resolved;
+        for (const item of arr) {
+          const resolved = resolveHistoryReferencedState(root, item);
+          if (!resolved) {
+            continue;
           }
-          return undefined;
-        }).filter(item => item !== undefined);
-        if (revived[key].length === 0) {
-          delete revived[key];
+          revived[key] ??= [];
+          revived[key].push(resolved);
         }
       }
       return revived;
     }
-    const revivedHistoryValue = reviveHistoryValue(snapshot.historyValue, this.root);
+    const revivedHistoryValue = reviveHistoryValue(this.root, snapshot.historyValue);
     const restoredSnapshot = createMachineSnapshot({
       ...snapshot,
       children,

package/dist/xstate.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.esm.js';
-import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-59f80ebb.esm.js';
-export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-59f80ebb.esm.js';
-import { a as assign } from './log-12aa30c9.esm.js';
-export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-12aa30c9.esm.js';
+import { t as toArray, S as STATE_DELIMITER, m as mapValues, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as toStatePath, w as isStateId, x as getStateNodeByPath, y as getPersistedSnapshot, z as resolveReferencedActor, A as createActor, $ as $$ACTOR_TYPE } from './raise-3e01e82a.esm.js';
+export { B as Actor, I as __unsafe_getAllOwnEventDescriptors, D as and, M as cancel, A as createActor, j as getStateNodes, C as interpret, H as isMachineSnapshot, J as matchesState, E as not, F as or, K as pathToStateValue, O as raise, P as spawnChild, G as stateIn, Q as stop, R as stopChild, L as toObserver } from './raise-3e01e82a.esm.js';
+import { a as assign } from './log-655aa404.esm.js';
+export { S as SpecialTargets, a as assign, e as emit, b as enqueueActions, f as forwardTo, l as log, s as sendParent, c as sendTo } from './log-655aa404.esm.js';
 import '../dev/dist/xstate-dev.esm.js';
 
 /**
@@ -365,11 +365,10 @@ class StateMachine {
   }
 
   /**
-   * Clones this state machine with the provided implementations and merges the
-   * `context` (if provided).
+   * Clones this state machine with the provided implementations.
    *
-   * @param implementations Options (`actions`, `guards`, `actors`, `delays`,
-   *   `context`) to recursively merge with the existing options.
+   * @param implementations Options (`actions`, `guards`, `actors`, `delays`)
+   *   to recursively merge with the existing options.
    * @returns A new `StateMachine` instance with the provided implementations.
    */
   provide(implementations) {
@@ -534,37 +533,34 @@ class StateMachine {
       });
       children[actorId] = actorRef;
     });
-    function resolveStateNodeFromIdOrPath(idOrPath, root) {
+    function resolveHistoryReferencedState(root, referenced) {
+      if (referenced instanceof StateNode) {
+        return referenced;
+      }
       try {
-        return root.machine.getStateNodeById(idOrPath);
+        return root.machine.getStateNodeById(referenced.id);
       } catch {
-        try {
-          return getStateNodeByPath(root, idOrPath.split('.'));
-        } catch {
-          return idOrPath;
-        }
       }
     }
-    function reviveHistoryValue(historyValue, root) {
-      if (!historyValue || typeof historyValue !== 'object') return {};
+    function reviveHistoryValue(root, historyValue) {
+      if (!historyValue || typeof historyValue !== 'object') {
+        return {};
+      }
       const revived = {};
       for (const key in historyValue) {
         const arr = historyValue[key];
-        revived[key] = arr.map(item => {
-          if (item instanceof StateNode) return item;
-          if (typeof item === 'object' && 'id' in item && typeof item.id === 'string') {
-            const resolved = resolveStateNodeFromIdOrPath(item.id, root);
-            if (resolved instanceof StateNode) return resolved;
+        for (const item of arr) {
+          const resolved = resolveHistoryReferencedState(root, item);
+          if (!resolved) {
+            continue;
           }
-          return undefined;
-        }).filter(item => item !== undefined);
-        if (revived[key].length === 0) {
-          delete revived[key];
+          revived[key] ??= [];
+          revived[key].push(resolved);
         }
       }
       return revived;
     }
-    const revivedHistoryValue = reviveHistoryValue(snapshot.historyValue, this.root);
+    const revivedHistoryValue = reviveHistoryValue(this.root, snapshot.historyValue);
     const restoredSnapshot = createMachineSnapshot({
       ...snapshot,
       children,