xstate 5.24.0 → 5.25.1

package/dist/{raise-f777a9e8.development.cjs.js → raise-ed7c6f3d.development.cjs.js}

@@ -288,6 +288,50 @@ function getAllOwnEventDescriptors(snapshot) {
   return [...new Set([...snapshot._nodes.flatMap(sn => sn.ownEvents)])];
 }
 
+/**
+ * Checks if an event type matches an event descriptor, supporting wildcards.
+ * Event descriptors can be:
+ *
+ * - Exact matches: "event.type"
+ * - Wildcard: "*"
+ * - Partial matches: "event.*"
+ *
+ * @param eventType - The actual event type string
+ * @param descriptor - The event descriptor to match against
+ * @returns True if the event type matches the descriptor
+ */
+function matchesEventDescriptor(eventType, descriptor) {
+  if (descriptor === eventType) {
+    return true;
+  }
+  if (descriptor === WILDCARD) {
+    return true;
+  }
+  if (!descriptor.endsWith('.*')) {
+    return false;
+  }
+  if (/.*\*.+/.test(descriptor)) {
+    console.warn(`Wildcards can only be the last token of an event descriptor (e.g., "event.*") or the entire event descriptor ("*"). Check the "${descriptor}" event.`);
+  }
+  const partialEventTokens = descriptor.split('.');
+  const eventTokens = eventType.split('.');
+  for (let tokenIndex = 0; tokenIndex < partialEventTokens.length; tokenIndex++) {
+    const partialEventToken = partialEventTokens[tokenIndex];
+    const eventToken = eventTokens[tokenIndex];
+    if (partialEventToken === '*') {
+      const isLastToken = tokenIndex === partialEventTokens.length - 1;
+      if (!isLastToken) {
+        console.warn(`Infix wildcards in transition events are not allowed. Check the "${descriptor}" transition.`);
+      }
+      return isLastToken;
+    }
+    if (partialEventToken !== eventToken) {
+      return false;
+    }
+  }
+  return true;
+}
+
 function createScheduledEventId(actorRef, id) {
   return `${actorRef.sessionId}.${id}`;
 }
@@ -926,12 +970,14 @@ class Actor {
       }
     }
     this.observers.clear();
+    this.eventListeners.clear();
   }
   _reportError(err) {
     if (!this.observers.size) {
       if (!this._parent) {
         reportUnhandledError(err);
       }
+      this.eventListeners.clear();
       return;
     }
     let reportError = false;
@@ -945,6 +991,7 @@ class Actor {
       }
     }
     this.observers.clear();
+    this.eventListeners.clear();
     if (reportError) {
       reportUnhandledError(err);
     }
@@ -1273,6 +1320,16 @@ function resolveStop(_, snapshot, args, actionParams, {
     children
   }), resolvedActorRef, undefined];
 }
+function unregisterRecursively(actorScope, actorRef) {
+  // unregister children first (depth-first)
+  const snapshot = actorRef.getSnapshot();
+  if (snapshot && 'children' in snapshot) {
+    for (const child of Object.values(snapshot.children)) {
+      unregisterRecursively(actorScope, child);
+    }
+  }
+  actorScope.system._unregister(actorRef);
+}
 function executeStop(actorScope, actorRef) {
   if (!actorRef) {
     return;
@@ -1281,7 +1338,8 @@ function executeStop(actorScope, actorRef) {
   // we need to eagerly unregister it here so a new actor with the same systemId can be registered immediately
   // since we defer actual stopping of the actor but we don't defer actor creations (and we can't do that)
   // this could throw on `systemId` collision, for example, when dealing with reentering transitions
-  actorScope.system._unregister(actorRef);
+  // we also need to recursively unregister all nested children's systemIds
+  unregisterRecursively(actorScope, actorRef);
 
   // this allows us to prevent an actor from being started if it gets stopped within the same macrostep
   // this can happen, for example, when the invoking state is being exited immediately by an always transition
@@ -1624,36 +1682,7 @@ function isInFinalState(stateNodeSet, stateNode) {
 }
 const isStateId = str => str[0] === STATE_IDENTIFIER;
 function getCandidates(stateNode, receivedEventType) {
-  const candidates = stateNode.transitions.get(receivedEventType) || [...stateNode.transitions.keys()].filter(eventDescriptor => {
-    // check if transition is a wildcard transition,
-    // which matches any non-transient events
-    if (eventDescriptor === WILDCARD) {
-      return true;
-    }
-    if (!eventDescriptor.endsWith('.*')) {
-      return false;
-    }
-    if (/.*\*.+/.test(eventDescriptor)) {
-      console.warn(`Wildcards can only be the last token of an event descriptor (e.g., "event.*") or the entire event descriptor ("*"). Check the "${eventDescriptor}" event.`);
-    }
-    const partialEventTokens = eventDescriptor.split('.');
-    const eventTokens = receivedEventType.split('.');
-    for (let tokenIndex = 0; tokenIndex < partialEventTokens.length; tokenIndex++) {
-      const partialEventToken = partialEventTokens[tokenIndex];
-      const eventToken = eventTokens[tokenIndex];
-      if (partialEventToken === '*') {
-        const isLastToken = tokenIndex === partialEventTokens.length - 1;
-        if (!isLastToken) {
-          console.warn(`Infix wildcards in transition events are not allowed. Check the "${eventDescriptor}" transition.`);
-        }
-        return isLastToken;
-      }
-      if (partialEventToken !== eventToken) {
-        return false;
-      }
-    }
-    return true;
-  }).sort((a, b) => b.length - a.length).flatMap(key => stateNode.transitions.get(key));
+  const candidates = stateNode.transitions.get(receivedEventType) || [...stateNode.transitions.keys()].filter(eventDescriptor => matchesEventDescriptor(receivedEventType, eventDescriptor)).sort((a, b) => b.length - a.length).flatMap(key => stateNode.transitions.get(key));
   return candidates;
 }
 
@@ -2747,6 +2776,7 @@ exports.isMachineSnapshot = isMachineSnapshot;
 exports.isStateId = isStateId;
 exports.macrostep = macrostep;
 exports.mapValues = mapValues;
+exports.matchesEventDescriptor = matchesEventDescriptor;
 exports.matchesState = matchesState;
 exports.microstep = microstep;
 exports.not = not;

package/dist/{raise-9ad1c5c6.esm.js → raise-f5c7cb5b.esm.js}

@@ -283,6 +283,44 @@ function getAllOwnEventDescriptors(snapshot) {
   return [...new Set([...snapshot._nodes.flatMap(sn => sn.ownEvents)])];
 }
 
+/**
+ * Checks if an event type matches an event descriptor, supporting wildcards.
+ * Event descriptors can be:
+ *
+ * - Exact matches: "event.type"
+ * - Wildcard: "*"
+ * - Partial matches: "event.*"
+ *
+ * @param eventType - The actual event type string
+ * @param descriptor - The event descriptor to match against
+ * @returns True if the event type matches the descriptor
+ */
+function matchesEventDescriptor(eventType, descriptor) {
+  if (descriptor === eventType) {
+    return true;
+  }
+  if (descriptor === WILDCARD) {
+    return true;
+  }
+  if (!descriptor.endsWith('.*')) {
+    return false;
+  }
+  const partialEventTokens = descriptor.split('.');
+  const eventTokens = eventType.split('.');
+  for (let tokenIndex = 0; tokenIndex < partialEventTokens.length; tokenIndex++) {
+    const partialEventToken = partialEventTokens[tokenIndex];
+    const eventToken = eventTokens[tokenIndex];
+    if (partialEventToken === '*') {
+      const isLastToken = tokenIndex === partialEventTokens.length - 1;
+      return isLastToken;
+    }
+    if (partialEventToken !== eventToken) {
+      return false;
+    }
+  }
+  return true;
+}
+
 function createScheduledEventId(actorRef, id) {
   return `${actorRef.sessionId}.${id}`;
 }
@@ -921,12 +959,14 @@ class Actor {
       }
     }
     this.observers.clear();
+    this.eventListeners.clear();
   }
   _reportError(err) {
     if (!this.observers.size) {
       if (!this._parent) {
         reportUnhandledError(err);
       }
+      this.eventListeners.clear();
       return;
     }
     let reportError = false;
@@ -940,6 +980,7 @@ class Actor {
       }
     }
     this.observers.clear();
+    this.eventListeners.clear();
     if (reportError) {
       reportUnhandledError(err);
     }
@@ -1246,6 +1287,16 @@ function resolveStop(_, snapshot, args, actionParams, {
     children
   }), resolvedActorRef, undefined];
 }
+function unregisterRecursively(actorScope, actorRef) {
+  // unregister children first (depth-first)
+  const snapshot = actorRef.getSnapshot();
+  if (snapshot && 'children' in snapshot) {
+    for (const child of Object.values(snapshot.children)) {
+      unregisterRecursively(actorScope, child);
+    }
+  }
+  actorScope.system._unregister(actorRef);
+}
 function executeStop(actorScope, actorRef) {
   if (!actorRef) {
     return;
@@ -1254,7 +1305,8 @@ function executeStop(actorScope, actorRef) {
   // we need to eagerly unregister it here so a new actor with the same systemId can be registered immediately
   // since we defer actual stopping of the actor but we don't defer actor creations (and we can't do that)
   // this could throw on `systemId` collision, for example, when dealing with reentering transitions
-  actorScope.system._unregister(actorRef);
+  // we also need to recursively unregister all nested children's systemIds
+  unregisterRecursively(actorScope, actorRef);
 
   // this allows us to prevent an actor from being started if it gets stopped within the same macrostep
   // this can happen, for example, when the invoking state is being exited immediately by an always transition
@@ -1586,30 +1638,7 @@ function isInFinalState(stateNodeSet, stateNode) {
 }
 const isStateId = str => str[0] === STATE_IDENTIFIER;
 function getCandidates(stateNode, receivedEventType) {
-  const candidates = stateNode.transitions.get(receivedEventType) || [...stateNode.transitions.keys()].filter(eventDescriptor => {
-    // check if transition is a wildcard transition,
-    // which matches any non-transient events
-    if (eventDescriptor === WILDCARD) {
-      return true;
-    }
-    if (!eventDescriptor.endsWith('.*')) {
-      return false;
-    }
-    const partialEventTokens = eventDescriptor.split('.');
-    const eventTokens = receivedEventType.split('.');
-    for (let tokenIndex = 0; tokenIndex < partialEventTokens.length; tokenIndex++) {
-      const partialEventToken = partialEventTokens[tokenIndex];
-      const eventToken = eventTokens[tokenIndex];
-      if (partialEventToken === '*') {
-        const isLastToken = tokenIndex === partialEventTokens.length - 1;
-        return isLastToken;
-      }
-      if (partialEventToken !== eventToken) {
-        return false;
-      }
-    }
-    return true;
-  }).sort((a, b) => b.length - a.length).flatMap(key => stateNode.transitions.get(key));
+  const candidates = stateNode.transitions.get(receivedEventType) || [...stateNode.transitions.keys()].filter(eventDescriptor => matchesEventDescriptor(receivedEventType, eventDescriptor)).sort((a, b) => b.length - a.length).flatMap(key => stateNode.transitions.get(key));
   return candidates;
 }
 
@@ -2650,4 +2679,4 @@ function raise(eventOrExpr, options) {
   return raise;
 }
 
-export { $$ACTOR_TYPE as $, Actor as A, getCandidates as B, resolveStateValue as C, getAllStateNodes as D, createMachineSnapshot as E, isInFinalState as F, macrostep as G, transitionNode as H, resolveActionsAndContext as I, createInitEvent as J, microstep as K, getInitialStateNodes as L, toStatePath as M, NULL_EVENT as N, isStateId as O, getStateNodeByPath as P, getPersistedSnapshot as Q, resolveReferencedActor as R, STATE_DELIMITER as S, XSTATE_ERROR as T, createErrorActorEvent as U, ProcessingStatus as V, cloneMachineSnapshot as W, XSTATE_STOP as X, cancel as a, spawnChild as b, createActor as c, and as d, stateIn as e, isMachineSnapshot as f, getStateNodes as g, getAllOwnEventDescriptors as h, interpret as i, toObserver as j, stop as k, mapValues as l, matchesState as m, not as n, or as o, pathToStateValue as p, formatTransitions as q, raise as r, stopChild as s, toArray as t, toTransitionConfigArray as u, formatTransition as v, evaluateGuard as w, createInvokeId as x, getDelayedTransitions as y, formatInitialTransition as z };
+export { $$ACTOR_TYPE as $, Actor as A, formatInitialTransition as B, getCandidates as C, resolveStateValue as D, getAllStateNodes as E, createMachineSnapshot as F, isInFinalState as G, macrostep as H, transitionNode as I, resolveActionsAndContext as J, createInitEvent as K, microstep as L, getInitialStateNodes as M, NULL_EVENT as N, toStatePath as O, isStateId as P, getStateNodeByPath as Q, getPersistedSnapshot as R, STATE_DELIMITER as S, resolveReferencedActor as T, XSTATE_ERROR as U, createErrorActorEvent as V, ProcessingStatus as W, XSTATE_STOP as X, cloneMachineSnapshot as Y, cancel as a, spawnChild as b, createActor as c, and as d, stateIn as e, isMachineSnapshot as f, getStateNodes as g, getAllOwnEventDescriptors as h, interpret as i, matchesState as j, toObserver as k, stop as l, matchesEventDescriptor as m, not as n, or as o, pathToStateValue as p, mapValues as q, raise as r, stopChild as s, toArray as t, formatTransitions as u, toTransitionConfigArray as v, formatTransition as w, evaluateGuard as x, createInvokeId as y, getDelayedTransitions as z };

package/dist/xstate.cjs.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.cjs.js');
-var guards_dist_xstateGuards = require('./raise-da5b247f.cjs.js');
-var StateMachine = require('./StateMachine-30081029.cjs.js');
-var assign = require('./assign-dea9f7c8.cjs.js');
-var log = require('./log-ec8d4df4.cjs.js');
+var guards_dist_xstateGuards = require('./raise-577e4163.cjs.js');
+var StateMachine = require('./StateMachine-fee05db8.cjs.js');
+var assign = require('./assign-592716a8.cjs.js');
+var log = require('./log-9c9f917d.cjs.js');
 require('../dev/dist/xstate-dev.cjs.js');
 
 /**
@@ -34,8 +34,9 @@ require('../dev/dist/xstate-dev.cjs.js');
  */
 function assertEvent(event, type) {
   const types = guards_dist_xstateGuards.toArray(type);
-  if (!types.includes(event.type)) {
-    const typesText = types.length === 1 ? `type "${types[0]}"` : `one of types "${types.join('", "')}"`;
+  const matches = types.some(descriptor => guards_dist_xstateGuards.matchesEventDescriptor(event.type, descriptor));
+  if (!matches) {
+    const typesText = types.length === 1 ? `type matching "${types[0]}"` : `one of types matching "${types.join('", "')}"`;
     throw new Error(`Expected event ${JSON.stringify(event)} to have ${typesText}`);
   }
 }
@@ -151,6 +152,9 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
 
+// used to keep only StateSchema relevant keys
+// this helps with type serialization as it makes the inferred type much shorter when dealing with huge configs
+
 function setup({
   schemas,
   actors,

package/dist/xstate.development.cjs.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.development.cjs.js');
-var guards_dist_xstateGuards = require('./raise-f777a9e8.development.cjs.js');
-var StateMachine = require('./StateMachine-4f3286fa.development.cjs.js');
-var assign = require('./assign-9e730107.development.cjs.js');
-var log = require('./log-cbac1abc.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-ed7c6f3d.development.cjs.js');
+var StateMachine = require('./StateMachine-6d24a98f.development.cjs.js');
+var assign = require('./assign-577bb842.development.cjs.js');
+var log = require('./log-3827c227.development.cjs.js');
 require('../dev/dist/xstate-dev.development.cjs.js');
 
 /**
@@ -34,8 +34,9 @@ require('../dev/dist/xstate-dev.development.cjs.js');
  */
 function assertEvent(event, type) {
   const types = guards_dist_xstateGuards.toArray(type);
-  if (!types.includes(event.type)) {
-    const typesText = types.length === 1 ? `type "${types[0]}"` : `one of types "${types.join('", "')}"`;
+  const matches = types.some(descriptor => guards_dist_xstateGuards.matchesEventDescriptor(event.type, descriptor));
+  if (!matches) {
+    const typesText = types.length === 1 ? `type matching "${types[0]}"` : `one of types matching "${types.join('", "')}"`;
     throw new Error(`Expected event ${JSON.stringify(event)} to have ${typesText}`);
   }
 }
@@ -151,6 +152,9 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
 
+// used to keep only StateSchema relevant keys
+// this helps with type serialization as it makes the inferred type much shorter when dealing with huge configs
+
 function setup({
   schemas,
   actors,

package/dist/xstate.development.esm.js

@@ -1,12 +1,12 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.development.esm.js';
-import { t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild } from './raise-c096f887.development.esm.js';
-export { A as Actor, h as __unsafe_getAllOwnEventDescriptors, d as and, a as cancel, c as createActor, g as getStateNodes, i as interpret, f as isMachineSnapshot, m as matchesState, n as not, o as or, p as pathToStateValue, r as raise, b as spawnChild, e as stateIn, k as stop, s as stopChild, j as toObserver } from './raise-c096f887.development.esm.js';
-import { S as StateMachine } from './StateMachine-d6caf9f3.development.esm.js';
-export { S as StateMachine, a as StateNode } from './StateMachine-d6caf9f3.development.esm.js';
-import { a as assign } from './assign-445527dc.development.esm.js';
-export { a as assign } from './assign-445527dc.development.esm.js';
-import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-2aa3642a.development.esm.js';
-export { S as SpecialTargets, a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-2aa3642a.development.esm.js';
+import { m as matchesEventDescriptor, t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild } from './raise-13a60c49.development.esm.js';
+export { A as Actor, h as __unsafe_getAllOwnEventDescriptors, d as and, a as cancel, c as createActor, g as getStateNodes, i as interpret, f as isMachineSnapshot, j as matchesState, n as not, o as or, p as pathToStateValue, r as raise, b as spawnChild, e as stateIn, l as stop, s as stopChild, k as toObserver } from './raise-13a60c49.development.esm.js';
+import { S as StateMachine } from './StateMachine-d0e98d09.development.esm.js';
+export { S as StateMachine, a as StateNode } from './StateMachine-d0e98d09.development.esm.js';
+import { a as assign } from './assign-541a432d.development.esm.js';
+export { a as assign } from './assign-541a432d.development.esm.js';
+import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-b8ca474e.development.esm.js';
+export { S as SpecialTargets, a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-b8ca474e.development.esm.js';
 import '../dev/dist/xstate-dev.development.esm.js';
 
 /**
@@ -34,8 +34,9 @@ import '../dev/dist/xstate-dev.development.esm.js';
  */
 function assertEvent(event, type) {
   const types = toArray(type);
-  if (!types.includes(event.type)) {
-    const typesText = types.length === 1 ? `type "${types[0]}"` : `one of types "${types.join('", "')}"`;
+  const matches = types.some(descriptor => matchesEventDescriptor(event.type, descriptor));
+  if (!matches) {
+    const typesText = types.length === 1 ? `type matching "${types[0]}"` : `one of types matching "${types.join('", "')}"`;
     throw new Error(`Expected event ${JSON.stringify(event)} to have ${typesText}`);
   }
 }
@@ -151,6 +152,9 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
 
+// used to keep only StateSchema relevant keys
+// this helps with type serialization as it makes the inferred type much shorter when dealing with huge configs
+
 function setup({
   schemas,
   actors,

package/dist/xstate.esm.js

@@ -1,12 +1,12 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.esm.js';
-import { t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild } from './raise-9ad1c5c6.esm.js';
-export { A as Actor, h as __unsafe_getAllOwnEventDescriptors, d as and, a as cancel, c as createActor, g as getStateNodes, i as interpret, f as isMachineSnapshot, m as matchesState, n as not, o as or, p as pathToStateValue, r as raise, b as spawnChild, e as stateIn, k as stop, s as stopChild, j as toObserver } from './raise-9ad1c5c6.esm.js';
-import { S as StateMachine } from './StateMachine-37bc3882.esm.js';
-export { S as StateMachine, a as StateNode } from './StateMachine-37bc3882.esm.js';
-import { a as assign } from './assign-ab9cc19e.esm.js';
-export { a as assign } from './assign-ab9cc19e.esm.js';
-import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-7cbae384.esm.js';
-export { S as SpecialTargets, a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-7cbae384.esm.js';
+import { m as matchesEventDescriptor, t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild } from './raise-f5c7cb5b.esm.js';
+export { A as Actor, h as __unsafe_getAllOwnEventDescriptors, d as and, a as cancel, c as createActor, g as getStateNodes, i as interpret, f as isMachineSnapshot, j as matchesState, n as not, o as or, p as pathToStateValue, r as raise, b as spawnChild, e as stateIn, l as stop, s as stopChild, k as toObserver } from './raise-f5c7cb5b.esm.js';
+import { S as StateMachine } from './StateMachine-6c48f805.esm.js';
+export { S as StateMachine, a as StateNode } from './StateMachine-6c48f805.esm.js';
+import { a as assign } from './assign-37a2fc1e.esm.js';
+export { a as assign } from './assign-37a2fc1e.esm.js';
+import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-ce14fc9a.esm.js';
+export { S as SpecialTargets, a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-ce14fc9a.esm.js';
 import '../dev/dist/xstate-dev.esm.js';
 
 /**
@@ -34,8 +34,9 @@ import '../dev/dist/xstate-dev.esm.js';
  */
 function assertEvent(event, type) {
   const types = toArray(type);
-  if (!types.includes(event.type)) {
-    const typesText = types.length === 1 ? `type "${types[0]}"` : `one of types "${types.join('", "')}"`;
+  const matches = types.some(descriptor => matchesEventDescriptor(event.type, descriptor));
+  if (!matches) {
+    const typesText = types.length === 1 ? `type matching "${types[0]}"` : `one of types matching "${types.join('", "')}"`;
     throw new Error(`Expected event ${JSON.stringify(event)} to have ${typesText}`);
   }
 }
@@ -151,6 +152,9 @@ function getNextSnapshot(actorLogic, snapshot, event) {
 // at the moment we allow extra actors - ones that are not specified by `children`
 // this could be reconsidered in the future
 
+// used to keep only StateSchema relevant keys
+// this helps with type serialization as it makes the inferred type much shorter when dealing with huge configs
+
 function setup({
   schemas,
   actors,