xstate 5.27.0 → 5.28.0

package/actors/dist/xstate-actors.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var guards_dist_xstateGuards = require('../../dist/raise-3a84be1f.cjs.js');
+var guards_dist_xstateGuards = require('../../dist/raise-f23ccfcb.cjs.js');
 require('../../dev/dist/xstate-dev.cjs.js');
 
 /**

package/actors/dist/xstate-actors.development.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var guards_dist_xstateGuards = require('../../dist/raise-ecea0c53.development.cjs.js');
+var guards_dist_xstateGuards = require('../../dist/raise-4c2b495e.development.cjs.js');
 require('../../dev/dist/xstate-dev.development.cjs.js');
 
 /**

package/actors/dist/xstate-actors.development.esm.js

@@ -1,4 +1,4 @@
-import { X as XSTATE_STOP, c as createActor } from '../../dist/raise-a7794093.development.esm.js';
+import { X as XSTATE_STOP, c as createActor } from '../../dist/raise-cb04d847.development.esm.js';
 import '../../dev/dist/xstate-dev.development.esm.js';
 
 /**

package/actors/dist/xstate-actors.esm.js

@@ -1,4 +1,4 @@
-import { X as XSTATE_STOP, c as createActor } from '../../dist/raise-e5d81555.esm.js';
+import { X as XSTATE_STOP, c as createActor } from '../../dist/raise-34c45204.esm.js';
 import '../../dev/dist/xstate-dev.esm.js';
 
 /**

package/dist/{StateMachine-93271b59.development.esm.js → StateMachine-65637d4d.development.esm.js}

@@ -1,5 +1,5 @@
-import { S as STATE_DELIMITER, y as mapValues, t as toArray, z as formatTransitions, B as toTransitionConfigArray, C as formatTransition, N as NULL_EVENT, D as evaluateGuard, E as createInvokeId, F as getDelayedTransitions, G as formatInitialTransition, H as getCandidates, I as resolveStateValue, J as getAllStateNodes, p as getStateNodes, K as createMachineSnapshot, L as isInFinalState, d as macrostep, M as transitionNode, O as resolveActionsAndContext, e as createInitEvent, i as initialMicrostep, P as toStatePath, Q as isStateId, R as getStateNodeByPath, T as getPersistedSnapshot, U as resolveReferencedActor, c as createActor, $ as $$ACTOR_TYPE } from './raise-a7794093.development.esm.js';
-import { a as assign } from './assign-d5291869.development.esm.js';
+import { S as STATE_DELIMITER, y as mapValues, t as toArray, z as formatTransitions, B as toTransitionConfigArray, C as formatTransition, N as NULL_EVENT, D as evaluateGuard, E as createInvokeId, F as getDelayedTransitions, G as formatInitialTransition, H as getCandidates, I as formatRouteTransitions, J as resolveStateValue, K as getAllStateNodes, p as getStateNodes, L as createMachineSnapshot, M as isInFinalState, d as macrostep, O as transitionNode, P as resolveActionsAndContext, e as createInitEvent, i as initialMicrostep, Q as toStatePath, R as isStateId, T as getStateNodeByPath, U as getPersistedSnapshot, V as resolveReferencedActor, c as createActor, $ as $$ACTOR_TYPE } from './raise-cb04d847.development.esm.js';
+import { a as assign } from './assign-2343d091.development.esm.js';
 
 const cache = new WeakMap();
 function memo(object, key, fn) {
@@ -326,6 +326,7 @@ class StateMachine {
       _machine: this
     });
     this.root._initialize();
+    formatRouteTransitions(this.root);
     this.states = this.root.states; // TODO: remove!
     this.events = this.root.events;
     if (!('output' in this.root) && Object.values(this.states).some(state => state.type === 'final' && 'output' in state)) {

package/dist/{StateMachine-a4db5a91.esm.js → StateMachine-9ef88566.esm.js}

@@ -1,5 +1,5 @@
-import { S as STATE_DELIMITER, y as mapValues, t as toArray, z as formatTransitions, B as toTransitionConfigArray, C as formatTransition, N as NULL_EVENT, D as evaluateGuard, E as createInvokeId, F as getDelayedTransitions, G as formatInitialTransition, H as getCandidates, I as resolveStateValue, J as getAllStateNodes, p as getStateNodes, K as createMachineSnapshot, L as isInFinalState, d as macrostep, M as transitionNode, O as resolveActionsAndContext, e as createInitEvent, i as initialMicrostep, P as toStatePath, Q as isStateId, R as getStateNodeByPath, T as getPersistedSnapshot, U as resolveReferencedActor, c as createActor, $ as $$ACTOR_TYPE } from './raise-e5d81555.esm.js';
-import { a as assign } from './assign-227b928a.esm.js';
+import { S as STATE_DELIMITER, y as mapValues, t as toArray, z as formatTransitions, B as toTransitionConfigArray, C as formatTransition, N as NULL_EVENT, D as evaluateGuard, E as createInvokeId, F as getDelayedTransitions, G as formatInitialTransition, H as getCandidates, I as formatRouteTransitions, J as resolveStateValue, K as getAllStateNodes, p as getStateNodes, L as createMachineSnapshot, M as isInFinalState, d as macrostep, O as transitionNode, P as resolveActionsAndContext, e as createInitEvent, i as initialMicrostep, Q as toStatePath, R as isStateId, T as getStateNodeByPath, U as getPersistedSnapshot, V as resolveReferencedActor, c as createActor, $ as $$ACTOR_TYPE } from './raise-34c45204.esm.js';
+import { a as assign } from './assign-5f7ff891.esm.js';
 
 const cache = new WeakMap();
 function memo(object, key, fn) {
@@ -326,6 +326,7 @@ class StateMachine {
       _machine: this
     });
     this.root._initialize();
+    formatRouteTransitions(this.root);
     this.states = this.root.states; // TODO: remove!
     this.events = this.root.events;
   }

package/dist/{StateMachine-e93afc18.cjs.js → StateMachine-a2656b8a.cjs.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-3a84be1f.cjs.js');
-var assign = require('./assign-e36553db.cjs.js');
+var guards_dist_xstateGuards = require('./raise-f23ccfcb.cjs.js');
+var assign = require('./assign-6b5249c3.cjs.js');
 
 const cache = new WeakMap();
 function memo(object, key, fn) {
@@ -328,6 +328,7 @@ class StateMachine {
       _machine: this
     });
     this.root._initialize();
+    guards_dist_xstateGuards.formatRouteTransitions(this.root);
     this.states = this.root.states; // TODO: remove!
     this.events = this.root.events;
   }

package/dist/{StateMachine-c3376229.development.cjs.js → StateMachine-b5c57433.development.cjs.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-ecea0c53.development.cjs.js');
-var assign = require('./assign-8ef0e332.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-4c2b495e.development.cjs.js');
+var assign = require('./assign-ec9d7c67.development.cjs.js');
 
 const cache = new WeakMap();
 function memo(object, key, fn) {
@@ -328,6 +328,7 @@ class StateMachine {
       _machine: this
     });
     this.root._initialize();
+    guards_dist_xstateGuards.formatRouteTransitions(this.root);
     this.states = this.root.states; // TODO: remove!
     this.events = this.root.events;
     if (!('output' in this.root) && Object.values(this.states).some(state => state.type === 'final' && 'output' in state)) {

package/dist/{assign-d5291869.development.esm.js → assign-2343d091.development.esm.js}

@@ -1,4 +1,4 @@
-import { Z as ProcessingStatus, U as resolveReferencedActor, c as createActor, _ as cloneMachineSnapshot, V as executingCustomAction } from './raise-a7794093.development.esm.js';
+import { _ as ProcessingStatus, V as resolveReferencedActor, c as createActor, a0 as cloneMachineSnapshot, W as executingCustomAction } from './raise-cb04d847.development.esm.js';
 
 function createSpawner(actorScope, {
   machine,

package/dist/{assign-227b928a.esm.js → assign-5f7ff891.esm.js}

@@ -1,4 +1,4 @@
-import { Y as ProcessingStatus, U as resolveReferencedActor, c as createActor, Z as cloneMachineSnapshot } from './raise-e5d81555.esm.js';
+import { Z as ProcessingStatus, V as resolveReferencedActor, c as createActor, _ as cloneMachineSnapshot } from './raise-34c45204.esm.js';
 
 function createSpawner(actorScope, {
   machine,

package/dist/{assign-e36553db.cjs.js → assign-6b5249c3.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-3a84be1f.cjs.js');
+var guards_dist_xstateGuards = require('./raise-f23ccfcb.cjs.js');
 
 function createSpawner(actorScope, {
   machine,

package/dist/{assign-8ef0e332.development.cjs.js → assign-ec9d7c67.development.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-ecea0c53.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-4c2b495e.development.cjs.js');
 
 function createSpawner(actorScope, {
   machine,

package/dist/declarations/src/actions/spawnChild.d.ts

@@ -4,7 +4,7 @@ export interface SpawnAction<TContext extends MachineContext, TExpressionEvent e
     (args: ActionArgs<TContext, TExpressionEvent, TEvent>, params: TParams): void;
     _out_TActor?: TActor;
 }
-interface SpawnActionOptions<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject, TActor extends ProvidedActor> {
+export interface SpawnActionOptions<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject, TActor extends ProvidedActor> {
     id?: ResolvableActorId<TContext, TExpressionEvent, TEvent, TActor['id']>;
     systemId?: string;
     input?: Mapper<TContext, TEvent, InputFrom<TActor['logic']>, TEvent> | InputFrom<TActor['logic']>;

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

@@ -5,5 +5,5 @@ export { enqueueActions, type EnqueueActionsAction } from "./actions/enqueueActi
 export { log, type LogAction } from "./actions/log.js";
 export { raise, type RaiseAction } from "./actions/raise.js";
 export { forwardTo, sendParent, sendTo, type SendToAction } from "./actions/send.js";
-export { spawnChild, type SpawnAction } from "./actions/spawnChild.js";
+export { spawnChild, type SpawnAction, type SpawnActionOptions } from "./actions/spawnChild.js";
 export { stop, stopChild, type StopAction } from "./actions/stopChild.js";

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

@@ -5,8 +5,9 @@ export { Actor, createActor, interpret, type Interpreter, type RequiredActorOpti
 export { createMachine } from "./createMachine.js";
 export { getInitialSnapshot, getNextSnapshot } from "./getNextSnapshot.js";
 export { and, not, or, stateIn } from "./guards.js";
+export type { GuardPredicate, GuardArgs } from "./guards.js";
 export type { InspectedActionEvent, InspectedActorEvent, InspectedEventEvent, InspectedMicrostepEvent, InspectedSnapshotEvent, InspectionEvent } from "./inspection.js";
-export { setup } from "./setup.js";
+export { setup, type SetupReturn } from "./setup.js";
 export { SimulatedClock } from "./SimulatedClock.js";
 export { type Spawner } from "./spawn.js";
 export { isMachineSnapshot, type MachineSnapshot } from "./State.js";

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

@@ -9,7 +9,7 @@ import { sendTo } from "./actions/send.js";
 import { spawnChild } from "./actions/spawnChild.js";
 import { stopChild } from "./actions/stopChild.js";
 import { GuardPredicate } from "./guards.js";
-import { ActionFunction, AnyActorRef, AnyEventObject, Cast, DelayConfig, EventObject, Invert, IsNever, MachineConfig, MachineContext, MetaObject, NonReducibleUnknown, ParameterizedObject, SetupTypes, StateNodeConfig, StateSchema, ToChildren, ToStateValue, UnknownActorLogic, Values } from "./types.js";
+import { ActionFunction, AnyActorRef, AnyEventObject, Cast, DelayConfig, EventObject, Invert, IsNever, MachineConfig, MachineContext, MetaObject, NonReducibleUnknown, ParameterizedObject, RoutableStateId, SetupTypes, StateNodeConfig, StateSchema, ToChildren, ToStateValue, UnknownActorLogic, Values } from "./types.js";
 type ToParameterizedObject<TParameterizedMap extends Record<string, ParameterizedObject['params'] | undefined>> = Values<{
     [K in keyof TParameterizedMap as K & string]: {
         type: K & string;
@@ -29,7 +29,7 @@ type ToStateSchema<TSchema extends StateSchema> = {
     } : TSchema[K];
 };
 type RequiredSetupKeys<TChildrenMap> = IsNever<keyof TChildrenMap> extends true ? never : 'actors';
-type SetupReturn<TContext extends MachineContext, TEvent extends AnyEventObject, TActors extends Record<string, UnknownActorLogic>, TChildrenMap extends Record<string, string>, TActions extends Record<string, ParameterizedObject['params'] | undefined>, TGuards extends Record<string, ParameterizedObject['params'] | undefined>, TDelay extends string, TTag extends string, TInput, TOutput extends NonReducibleUnknown, TEmitted extends EventObject, TMeta extends MetaObject> = {
+export type SetupReturn<TContext extends MachineContext, TEvent extends AnyEventObject, TActors extends Record<string, UnknownActorLogic>, TChildrenMap extends Record<string, string>, TActions extends Record<string, ParameterizedObject['params'] | undefined>, TGuards extends Record<string, ParameterizedObject['params'] | undefined>, TDelay extends string, TTag extends string, TInput, TOutput extends NonReducibleUnknown, TEmitted extends EventObject, TMeta extends MetaObject> = {
     extend: <TExtendActions extends Record<string, ParameterizedObject['params'] | undefined> = {}, TExtendGuards extends Record<string, ParameterizedObject['params'] | undefined> = {}, TExtendDelays extends string = never>({ actions, guards, delays }: {
         actions?: {
             [K in keyof TExtendActions]: ActionFunction<TContext, TEvent, TEvent, TExtendActions[K], ToProvidedActor<TChildrenMap, TActors>, ToParameterizedObject<TActions & TExtendActions>, ToParameterizedObject<TGuards & TExtendGuards>, TDelay | TExtendDelays, TEmitted>;
@@ -96,7 +96,10 @@ type SetupReturn<TContext extends MachineContext, TEvent extends AnyEventObject,
      * ```
      */
     createAction: (action: ActionFunction<TContext, TEvent, TEvent, unknown, ToProvidedActor<TChildrenMap, TActors>, ToParameterizedObject<TActions>, ToParameterizedObject<TGuards>, TDelay, TEmitted>) => typeof action;
-    createMachine: <const TConfig extends MachineConfig<TContext, TEvent, ToProvidedActor<TChildrenMap, TActors>, ToParameterizedObject<TActions>, ToParameterizedObject<TGuards>, TDelay, TTag, TInput, TOutput, TEmitted, TMeta>>(config: TConfig) => StateMachine<TContext, TEvent, Cast<ToChildren<ToProvidedActor<TChildrenMap, TActors>>, Record<string, AnyActorRef | undefined>>, ToProvidedActor<TChildrenMap, TActors>, ToParameterizedObject<TActions>, ToParameterizedObject<TGuards>, TDelay, ToStateValue<TConfig>, TTag, TInput, TOutput, TEmitted, TMeta, ToStateSchema<TConfig>>;
+    createMachine: <const TConfig extends MachineConfig<TContext, TEvent, ToProvidedActor<TChildrenMap, TActors>, ToParameterizedObject<TActions>, ToParameterizedObject<TGuards>, TDelay, TTag, TInput, TOutput, TEmitted, TMeta>>(config: TConfig) => StateMachine<TContext, TEvent | ([RoutableStateId<TConfig>] extends [never] ? never : {
+        type: 'xstate.route';
+        to: RoutableStateId<TConfig>;
+    }), Cast<ToChildren<ToProvidedActor<TChildrenMap, TActors>>, Record<string, AnyActorRef | undefined>>, ToProvidedActor<TChildrenMap, TActors>, ToParameterizedObject<TActions>, ToParameterizedObject<TGuards>, TDelay, ToStateValue<TConfig>, TTag, TInput, TOutput, TEmitted, TMeta, ToStateSchema<TConfig>>;
     assign: typeof assign<TContext, TEvent, undefined, TEvent, ToProvidedActor<TChildrenMap, TActors>>;
     sendTo: <TTargetActor extends AnyActorRef>(...args: Parameters<typeof sendTo<TContext, TEvent, undefined, TTargetActor, TEvent, TDelay, TDelay>>) => ReturnType<typeof sendTo<TContext, TEvent, undefined, TTargetActor, TEvent, TDelay, TDelay>>;
     raise: typeof raise<TContext, TEvent, TEvent, undefined, TDelay, TDelay>;

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

@@ -14,6 +14,11 @@ export declare function getCandidates<TEvent extends EventObject>(stateNode: Sta
 export declare function getDelayedTransitions(stateNode: AnyStateNode): Array<DelayedTransitionDefinition<MachineContext, EventObject>>;
 export declare function formatTransition(stateNode: AnyStateNode, descriptor: string, transitionConfig: AnyTransitionConfig): AnyTransitionDefinition;
 export declare function formatTransitions<TContext extends MachineContext, TEvent extends EventObject>(stateNode: AnyStateNode): Map<string, TransitionDefinition<TContext, TEvent>[]>;
+/**
+ * Collects route transitions from all descendants with explicit IDs. Called
+ * once on the root node to avoid O(N²) repeated traversals.
+ */
+export declare function formatRouteTransitions(rootStateNode: AnyStateNode): void;
 export declare function formatInitialTransition<TContext extends MachineContext, TEvent extends EventObject>(stateNode: AnyStateNode, _target: string | undefined | InitialTransitionConfig<TContext, TEvent, TODO, TODO, TODO, TODO>): InitialTransitionDefinition<TContext, TEvent>;
 /**
  * Returns the relative state node from the given `statePath`, or throws.

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

@@ -341,6 +341,13 @@ export interface StateNodeConfig<TContext extends MachineContext, TEvent extends
     description?: string;
     /** A default target for a history state */
     target?: string | undefined;
+    route?: RouteTransitionConfig<TContext, TEvent, TEvent, TActor, TAction, TGuard, TDelay, TEmitted>;
+}
+export interface RouteTransitionConfig<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject, TActor extends ProvidedActor, TAction extends ParameterizedObject, TGuard extends ParameterizedObject, TDelay extends string, TEmitted extends EventObject> {
+    guard?: Guard<TContext, TExpressionEvent, undefined, TGuard>;
+    actions?: Actions<TContext, TExpressionEvent, TEvent, undefined, TActor, TAction, TGuard, TDelay, TEmitted>;
+    meta?: Record<string, any>;
+    description?: string;
 }
 export type AnyStateNodeConfig = StateNodeConfig<any, any, any, any, any, any, any, any, any, // emitted
 any>;
@@ -907,6 +914,7 @@ export type ToChildren<TActor extends ProvidedActor> = string extends TActor['sr
 }[undefined extends TActor['id'] ? 'include' : string extends TActor['id'] ? 'include' : 'exclude']>;
 export type StateSchema = {
     id?: string;
+    route?: unknown;
     states?: Record<string, StateSchema>;
     type?: unknown;
     invoke?: unknown;
@@ -926,6 +934,12 @@ export type StateId<TSchema extends StateSchema, TKey extends string = '(machine
 } ? TSchema['id'] : TParentKey extends null ? TKey : `${TParentKey}.${TKey}`) | (TSchema['states'] extends Record<string, any> ? Values<{
     [K in keyof TSchema['states'] & string]: StateId<TSchema['states'][K], K, TParentKey extends string ? `${TParentKey}.${TKey}` : TSchema['id'] extends string ? TSchema['id'] : TKey>;
 }> : never);
+export type RoutableStateId<TSchema extends StateSchema> = (TSchema extends {
+    route: any;
+    id: string;
+} ? `#${TSchema['id']}` : never) | (TSchema['states'] extends Record<string, any> ? Values<{
+    [K in keyof TSchema['states'] & string]: RoutableStateId<TSchema['states'][K]>;
+}> : never);
 export interface StateMachineTypes {
     context: MachineContext;
     events: EventObject;

package/dist/{log-fa76d888.esm.js → log-1324d455.esm.js}

@@ -1,5 +1,5 @@
-import { V as XSTATE_ERROR, W as createErrorActorEvent, D as evaluateGuard, a as cancel, r as raise, b as spawnChild, s as stopChild } from './raise-e5d81555.esm.js';
-import { a as assign } from './assign-227b928a.esm.js';
+import { W as XSTATE_ERROR, Y as createErrorActorEvent, D as evaluateGuard, a as cancel, r as raise, b as spawnChild, s as stopChild } from './raise-34c45204.esm.js';
+import { a as assign } from './assign-5f7ff891.esm.js';
 
 function resolveEmit(_, snapshot, args, actionParams, {
   event: eventOrExpr

package/dist/{log-7dbbb7c2.development.esm.js → log-39288d72.development.esm.js}

@@ -1,5 +1,5 @@
-import { V as executingCustomAction, W as XSTATE_ERROR, Y as createErrorActorEvent, D as evaluateGuard, a as cancel, r as raise, b as spawnChild, s as stopChild } from './raise-a7794093.development.esm.js';
-import { a as assign } from './assign-d5291869.development.esm.js';
+import { W as executingCustomAction, Y as XSTATE_ERROR, Z as createErrorActorEvent, D as evaluateGuard, a as cancel, r as raise, b as spawnChild, s as stopChild } from './raise-cb04d847.development.esm.js';
+import { a as assign } from './assign-2343d091.development.esm.js';
 
 function resolveEmit(_, snapshot, args, actionParams, {
   event: eventOrExpr

package/dist/{log-72d5ee02.development.cjs.js → log-96e4ebaa.development.cjs.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-ecea0c53.development.cjs.js');
-var assign = require('./assign-8ef0e332.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-4c2b495e.development.cjs.js');
+var assign = require('./assign-ec9d7c67.development.cjs.js');
 
 function resolveEmit(_, snapshot, args, actionParams, {
   event: eventOrExpr

package/dist/{log-e54c2eff.cjs.js → log-b8ad8428.cjs.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-3a84be1f.cjs.js');
-var assign = require('./assign-e36553db.cjs.js');
+var guards_dist_xstateGuards = require('./raise-f23ccfcb.cjs.js');
+var assign = require('./assign-6b5249c3.cjs.js');
 
 function resolveEmit(_, snapshot, args, actionParams, {
   event: eventOrExpr

package/dist/{raise-e5d81555.esm.js → raise-34c45204.esm.js}

@@ -1742,6 +1742,47 @@ function formatTransitions(stateNode) {
   }
   return transitions;
 }
+
+/**
+ * Collects route transitions from all descendants with explicit IDs. Called
+ * once on the root node to avoid O(N²) repeated traversals.
+ */
+function formatRouteTransitions(rootStateNode) {
+  const routeTransitions = [];
+  const collectRoutes = states => {
+    Object.values(states).forEach(sn => {
+      if (sn.config.route && sn.config.id) {
+        const routeId = sn.config.id;
+        const userGuard = sn.config.route.guard;
+        const routeGuard = (args, params) => {
+          if (args.event.to !== `#${routeId}`) {
+            return false;
+          }
+          if (!userGuard) {
+            return true;
+          }
+          if (typeof userGuard === 'function') {
+            return userGuard(args, params);
+          }
+          return true;
+        };
+        const transition = {
+          ...sn.config.route,
+          guard: routeGuard,
+          target: `#${routeId}`
+        };
+        routeTransitions.push(formatTransition(rootStateNode, 'xstate.route', transition));
+      }
+      if (sn.states) {
+        collectRoutes(sn.states);
+      }
+    });
+  };
+  collectRoutes(rootStateNode.states);
+  if (routeTransitions.length > 0) {
+    rootStateNode.transitions.set('xstate.route', routeTransitions);
+  }
+}
 function formatInitialTransition(stateNode, _target) {
   const resolvedTarget = typeof _target === 'string' ? stateNode.states[_target] : _target ? stateNode.states[_target.target] : undefined;
   if (!resolvedTarget && _target) {
@@ -2703,4 +2744,4 @@ function raise(eventOrExpr, options) {
   return raise;
 }
 
-export { $$ACTOR_TYPE as $, Actor as A, toTransitionConfigArray as B, formatTransition as C, evaluateGuard as D, createInvokeId as E, getDelayedTransitions as F, formatInitialTransition as G, getCandidates as H, resolveStateValue as I, getAllStateNodes as J, createMachineSnapshot as K, isInFinalState as L, transitionNode as M, NULL_EVENT as N, resolveActionsAndContext as O, toStatePath as P, isStateId as Q, getStateNodeByPath as R, STATE_DELIMITER as S, getPersistedSnapshot as T, resolveReferencedActor as U, XSTATE_ERROR as V, createErrorActorEvent as W, XSTATE_STOP as X, ProcessingStatus as Y, cloneMachineSnapshot as Z, cancel as a, spawnChild as b, createActor as c, macrostep as d, createInitEvent as e, isAtomicStateNode as f, getProperAncestors as g, interpret as h, initialMicrostep as i, and as j, stateIn as k, isMachineSnapshot as l, matchesEventDescriptor as m, not as n, or as o, getStateNodes as p, getAllOwnEventDescriptors as q, raise as r, stopChild as s, toArray as t, matchesState as u, pathToStateValue as v, toObserver as w, stop as x, mapValues as y, formatTransitions as z };
+export { $$ACTOR_TYPE as $, Actor as A, toTransitionConfigArray as B, formatTransition as C, evaluateGuard as D, createInvokeId as E, getDelayedTransitions as F, formatInitialTransition as G, getCandidates as H, formatRouteTransitions as I, resolveStateValue as J, getAllStateNodes as K, createMachineSnapshot as L, isInFinalState as M, NULL_EVENT as N, transitionNode as O, resolveActionsAndContext as P, toStatePath as Q, isStateId as R, STATE_DELIMITER as S, getStateNodeByPath as T, getPersistedSnapshot as U, resolveReferencedActor as V, XSTATE_ERROR as W, XSTATE_STOP as X, createErrorActorEvent as Y, ProcessingStatus as Z, cloneMachineSnapshot as _, cancel as a, spawnChild as b, createActor as c, macrostep as d, createInitEvent as e, isAtomicStateNode as f, getProperAncestors as g, interpret as h, initialMicrostep as i, and as j, stateIn as k, isMachineSnapshot as l, matchesEventDescriptor as m, not as n, or as o, getStateNodes as p, getAllOwnEventDescriptors as q, raise as r, stopChild as s, toArray as t, matchesState as u, pathToStateValue as v, toObserver as w, stop as x, mapValues as y, formatTransitions as z };

package/dist/{raise-ecea0c53.development.cjs.js → raise-4c2b495e.development.cjs.js}

@@ -1791,6 +1791,47 @@ function formatTransitions(stateNode) {
   }
   return transitions;
 }
+
+/**
+ * Collects route transitions from all descendants with explicit IDs. Called
+ * once on the root node to avoid O(N²) repeated traversals.
+ */
+function formatRouteTransitions(rootStateNode) {
+  const routeTransitions = [];
+  const collectRoutes = states => {
+    Object.values(states).forEach(sn => {
+      if (sn.config.route && sn.config.id) {
+        const routeId = sn.config.id;
+        const userGuard = sn.config.route.guard;
+        const routeGuard = (args, params) => {
+          if (args.event.to !== `#${routeId}`) {
+            return false;
+          }
+          if (!userGuard) {
+            return true;
+          }
+          if (typeof userGuard === 'function') {
+            return userGuard(args, params);
+          }
+          return true;
+        };
+        const transition = {
+          ...sn.config.route,
+          guard: routeGuard,
+          target: `#${routeId}`
+        };
+        routeTransitions.push(formatTransition(rootStateNode, 'xstate.route', transition));
+      }
+      if (sn.states) {
+        collectRoutes(sn.states);
+      }
+    });
+  };
+  collectRoutes(rootStateNode.states);
+  if (routeTransitions.length > 0) {
+    rootStateNode.transitions.set('xstate.route', routeTransitions);
+  }
+}
 function formatInitialTransition(stateNode, _target) {
   const resolvedTarget = typeof _target === 'string' ? stateNode.states[_target] : _target ? stateNode.states[_target.target] : undefined;
   if (!resolvedTarget && _target) {
@@ -2784,6 +2825,7 @@ exports.createInvokeId = createInvokeId;
 exports.createMachineSnapshot = createMachineSnapshot;
 exports.evaluateGuard = evaluateGuard;
 exports.formatInitialTransition = formatInitialTransition;
+exports.formatRouteTransitions = formatRouteTransitions;
 exports.formatTransition = formatTransition;
 exports.formatTransitions = formatTransitions;
 exports.getAllOwnEventDescriptors = getAllOwnEventDescriptors;

package/dist/{raise-a7794093.development.esm.js → raise-cb04d847.development.esm.js}

@@ -1789,6 +1789,47 @@ function formatTransitions(stateNode) {
   }
   return transitions;
 }
+
+/**
+ * Collects route transitions from all descendants with explicit IDs. Called
+ * once on the root node to avoid O(N²) repeated traversals.
+ */
+function formatRouteTransitions(rootStateNode) {
+  const routeTransitions = [];
+  const collectRoutes = states => {
+    Object.values(states).forEach(sn => {
+      if (sn.config.route && sn.config.id) {
+        const routeId = sn.config.id;
+        const userGuard = sn.config.route.guard;
+        const routeGuard = (args, params) => {
+          if (args.event.to !== `#${routeId}`) {
+            return false;
+          }
+          if (!userGuard) {
+            return true;
+          }
+          if (typeof userGuard === 'function') {
+            return userGuard(args, params);
+          }
+          return true;
+        };
+        const transition = {
+          ...sn.config.route,
+          guard: routeGuard,
+          target: `#${routeId}`
+        };
+        routeTransitions.push(formatTransition(rootStateNode, 'xstate.route', transition));
+      }
+      if (sn.states) {
+        collectRoutes(sn.states);
+      }
+    });
+  };
+  collectRoutes(rootStateNode.states);
+  if (routeTransitions.length > 0) {
+    rootStateNode.transitions.set('xstate.route', routeTransitions);
+  }
+}
 function formatInitialTransition(stateNode, _target) {
   const resolvedTarget = typeof _target === 'string' ? stateNode.states[_target] : _target ? stateNode.states[_target.target] : undefined;
   if (!resolvedTarget && _target) {
@@ -2765,4 +2806,4 @@ function raise(eventOrExpr, options) {
   return raise;
 }
 
-export { $$ACTOR_TYPE as $, Actor as A, toTransitionConfigArray as B, formatTransition as C, evaluateGuard as D, createInvokeId as E, getDelayedTransitions as F, formatInitialTransition as G, getCandidates as H, resolveStateValue as I, getAllStateNodes as J, createMachineSnapshot as K, isInFinalState as L, transitionNode as M, NULL_EVENT as N, resolveActionsAndContext as O, toStatePath as P, isStateId as Q, getStateNodeByPath as R, STATE_DELIMITER as S, getPersistedSnapshot as T, resolveReferencedActor as U, executingCustomAction as V, XSTATE_ERROR as W, XSTATE_STOP as X, createErrorActorEvent as Y, ProcessingStatus as Z, cloneMachineSnapshot as _, cancel as a, spawnChild as b, createActor as c, macrostep as d, createInitEvent as e, isAtomicStateNode as f, getProperAncestors as g, interpret as h, initialMicrostep as i, and as j, stateIn as k, isMachineSnapshot as l, matchesEventDescriptor as m, not as n, or as o, getStateNodes as p, getAllOwnEventDescriptors as q, raise as r, stopChild as s, toArray as t, matchesState as u, pathToStateValue as v, toObserver as w, stop as x, mapValues as y, formatTransitions as z };
+export { $$ACTOR_TYPE as $, Actor as A, toTransitionConfigArray as B, formatTransition as C, evaluateGuard as D, createInvokeId as E, getDelayedTransitions as F, formatInitialTransition as G, getCandidates as H, formatRouteTransitions as I, resolveStateValue as J, getAllStateNodes as K, createMachineSnapshot as L, isInFinalState as M, NULL_EVENT as N, transitionNode as O, resolveActionsAndContext as P, toStatePath as Q, isStateId as R, STATE_DELIMITER as S, getStateNodeByPath as T, getPersistedSnapshot as U, resolveReferencedActor as V, executingCustomAction as W, XSTATE_STOP as X, XSTATE_ERROR as Y, createErrorActorEvent as Z, ProcessingStatus as _, cancel as a, cloneMachineSnapshot as a0, spawnChild as b, createActor as c, macrostep as d, createInitEvent as e, isAtomicStateNode as f, getProperAncestors as g, interpret as h, initialMicrostep as i, and as j, stateIn as k, isMachineSnapshot as l, matchesEventDescriptor as m, not as n, or as o, getStateNodes as p, getAllOwnEventDescriptors as q, raise as r, stopChild as s, toArray as t, matchesState as u, pathToStateValue as v, toObserver as w, stop as x, mapValues as y, formatTransitions as z };

package/dist/{raise-3a84be1f.cjs.js → raise-f23ccfcb.cjs.js}

@@ -1744,6 +1744,47 @@ function formatTransitions(stateNode) {
   }
   return transitions;
 }
+
+/**
+ * Collects route transitions from all descendants with explicit IDs. Called
+ * once on the root node to avoid O(N²) repeated traversals.
+ */
+function formatRouteTransitions(rootStateNode) {
+  const routeTransitions = [];
+  const collectRoutes = states => {
+    Object.values(states).forEach(sn => {
+      if (sn.config.route && sn.config.id) {
+        const routeId = sn.config.id;
+        const userGuard = sn.config.route.guard;
+        const routeGuard = (args, params) => {
+          if (args.event.to !== `#${routeId}`) {
+            return false;
+          }
+          if (!userGuard) {
+            return true;
+          }
+          if (typeof userGuard === 'function') {
+            return userGuard(args, params);
+          }
+          return true;
+        };
+        const transition = {
+          ...sn.config.route,
+          guard: routeGuard,
+          target: `#${routeId}`
+        };
+        routeTransitions.push(formatTransition(rootStateNode, 'xstate.route', transition));
+      }
+      if (sn.states) {
+        collectRoutes(sn.states);
+      }
+    });
+  };
+  collectRoutes(rootStateNode.states);
+  if (routeTransitions.length > 0) {
+    rootStateNode.transitions.set('xstate.route', routeTransitions);
+  }
+}
 function formatInitialTransition(stateNode, _target) {
   const resolvedTarget = typeof _target === 'string' ? stateNode.states[_target] : _target ? stateNode.states[_target.target] : undefined;
   if (!resolvedTarget && _target) {
@@ -2722,6 +2763,7 @@ exports.createInvokeId = createInvokeId;
 exports.createMachineSnapshot = createMachineSnapshot;
 exports.evaluateGuard = evaluateGuard;
 exports.formatInitialTransition = formatInitialTransition;
+exports.formatRouteTransitions = formatRouteTransitions;
 exports.formatTransition = formatTransition;
 exports.formatTransitions = formatTransitions;
 exports.getAllOwnEventDescriptors = getAllOwnEventDescriptors;

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-3a84be1f.cjs.js');
-var StateMachine = require('./StateMachine-e93afc18.cjs.js');
-var assign = require('./assign-e36553db.cjs.js');
-var log = require('./log-e54c2eff.cjs.js');
+var guards_dist_xstateGuards = require('./raise-f23ccfcb.cjs.js');
+var StateMachine = require('./StateMachine-a2656b8a.cjs.js');
+var assign = require('./assign-6b5249c3.cjs.js');
+var log = require('./log-b8ad8428.cjs.js');
 require('../dev/dist/xstate-dev.cjs.js');
 
 /**

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-ecea0c53.development.cjs.js');
-var StateMachine = require('./StateMachine-c3376229.development.cjs.js');
-var assign = require('./assign-8ef0e332.development.cjs.js');
-var log = require('./log-72d5ee02.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-4c2b495e.development.cjs.js');
+var StateMachine = require('./StateMachine-b5c57433.development.cjs.js');
+var assign = require('./assign-ec9d7c67.development.cjs.js');
+var log = require('./log-96e4ebaa.development.cjs.js');
 require('../dev/dist/xstate-dev.development.cjs.js');
 
 /**

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 { m as matchesEventDescriptor, t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild, d as macrostep, e as createInitEvent, i as initialMicrostep, f as isAtomicStateNode, g as getProperAncestors } from './raise-a7794093.development.esm.js';
-export { A as Actor, q as __unsafe_getAllOwnEventDescriptors, j as and, a as cancel, c as createActor, p as getStateNodes, h as interpret, l as isMachineSnapshot, u as matchesState, n as not, o as or, v as pathToStateValue, r as raise, b as spawnChild, k as stateIn, x as stop, s as stopChild, w as toObserver } from './raise-a7794093.development.esm.js';
-import { S as StateMachine } from './StateMachine-93271b59.development.esm.js';
-export { S as StateMachine, a as StateNode } from './StateMachine-93271b59.development.esm.js';
-import { a as assign } from './assign-d5291869.development.esm.js';
-export { a as assign } from './assign-d5291869.development.esm.js';
-import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-7dbbb7c2.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-7dbbb7c2.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, d as macrostep, e as createInitEvent, i as initialMicrostep, f as isAtomicStateNode, g as getProperAncestors } from './raise-cb04d847.development.esm.js';
+export { A as Actor, q as __unsafe_getAllOwnEventDescriptors, j as and, a as cancel, c as createActor, p as getStateNodes, h as interpret, l as isMachineSnapshot, u as matchesState, n as not, o as or, v as pathToStateValue, r as raise, b as spawnChild, k as stateIn, x as stop, s as stopChild, w as toObserver } from './raise-cb04d847.development.esm.js';
+import { S as StateMachine } from './StateMachine-65637d4d.development.esm.js';
+export { S as StateMachine, a as StateNode } from './StateMachine-65637d4d.development.esm.js';
+import { a as assign } from './assign-2343d091.development.esm.js';
+export { a as assign } from './assign-2343d091.development.esm.js';
+import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-39288d72.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-39288d72.development.esm.js';
 import '../dev/dist/xstate-dev.development.esm.js';
 
 /**

package/dist/xstate.esm.js

@@ -1,12 +1,12 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.esm.js';
-import { m as matchesEventDescriptor, t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild, d as macrostep, e as createInitEvent, i as initialMicrostep, f as isAtomicStateNode, g as getProperAncestors } from './raise-e5d81555.esm.js';
-export { A as Actor, q as __unsafe_getAllOwnEventDescriptors, j as and, a as cancel, c as createActor, p as getStateNodes, h as interpret, l as isMachineSnapshot, u as matchesState, n as not, o as or, v as pathToStateValue, r as raise, b as spawnChild, k as stateIn, x as stop, s as stopChild, w as toObserver } from './raise-e5d81555.esm.js';
-import { S as StateMachine } from './StateMachine-a4db5a91.esm.js';
-export { S as StateMachine, a as StateNode } from './StateMachine-a4db5a91.esm.js';
-import { a as assign } from './assign-227b928a.esm.js';
-export { a as assign } from './assign-227b928a.esm.js';
-import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-fa76d888.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-fa76d888.esm.js';
+import { m as matchesEventDescriptor, t as toArray, c as createActor, r as raise, a as cancel, s as stopChild, b as spawnChild, d as macrostep, e as createInitEvent, i as initialMicrostep, f as isAtomicStateNode, g as getProperAncestors } from './raise-34c45204.esm.js';
+export { A as Actor, q as __unsafe_getAllOwnEventDescriptors, j as and, a as cancel, c as createActor, p as getStateNodes, h as interpret, l as isMachineSnapshot, u as matchesState, n as not, o as or, v as pathToStateValue, r as raise, b as spawnChild, k as stateIn, x as stop, s as stopChild, w as toObserver } from './raise-34c45204.esm.js';
+import { S as StateMachine } from './StateMachine-9ef88566.esm.js';
+export { S as StateMachine, a as StateNode } from './StateMachine-9ef88566.esm.js';
+import { a as assign } from './assign-5f7ff891.esm.js';
+export { a as assign } from './assign-5f7ff891.esm.js';
+import { s as sendTo, l as log, e as enqueueActions, a as emit } from './log-1324d455.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-1324d455.esm.js';
 import '../dev/dist/xstate-dev.esm.js';
 
 /**