xstate 5.33.0 → 5.33.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -40,7 +40,7 @@ interface MachineSnapshotBase<TContext extends MachineContext, TEvent extends Ev
40
40
  context: TContext;
41
41
  historyValue: Readonly<HistoryValue<TContext, TEvent>>;
42
42
  /** The enabled state nodes representative of the state value. */
43
- _nodes: Array<StateNode<TContext, TEvent>>;
43
+ _nodes: Array<StateNode<TContext, TEvent, any, any>>;
44
44
  /** An object mapping actor names to spawned/invoked actors. */
45
45
  children: TChildren;
46
46
  /**
@@ -1,5 +1,5 @@
1
- import { EventObject, StateNode, TransitionDefinition, Snapshot, MachineContext, ActorLogic, MachineSnapshot } from "../index.js";
2
- export type AnyStateNode = StateNode<any, any>;
1
+ import { AnyStateNode, EventObject, AnyTransitionDefinition, Snapshot, MachineContext, ActorLogic, MachineSnapshot } from "../index.js";
2
+ export type { AnyStateNode };
3
3
  type JSONSerializable<T extends object, U> = T & {
4
4
  toJSON: () => U;
5
5
  };
@@ -13,7 +13,7 @@ export type DirectedGraphEdge = JSONSerializable<{
13
13
  source: AnyStateNode;
14
14
  target: AnyStateNode;
15
15
  label: DirectedGraphLabel;
16
- transition: TransitionDefinition<any, any>;
16
+ transition: AnyTransitionDefinition;
17
17
  }, {
18
18
  source: string;
19
19
  target: string;
@@ -21,7 +21,7 @@ export type DirectedGraphEdge = JSONSerializable<{
21
21
  }>;
22
22
  export type DirectedGraphNode = JSONSerializable<{
23
23
  id: string;
24
- stateNode: StateNode;
24
+ stateNode: AnyStateNode;
25
25
  children: DirectedGraphNode[];
26
26
  /** The edges representing all transitions from this `stateNode`. */
27
27
  edges: DirectedGraphEdge[];
@@ -157,4 +157,3 @@ export interface AdjacencyValue<TState, TEvent> {
157
157
  export interface AdjacencyMap<TState, TEvent> {
158
158
  [key: SerializedSnapshot]: AdjacencyValue<TState, TEvent>;
159
159
  }
160
- export {};
@@ -1,19 +1,19 @@
1
1
  import { MachineSnapshot } from "./State.js";
2
2
  import type { StateNode } from "./StateNode.js";
3
3
  import { ActionArgs, AnyEventObject, AnyMachineSnapshot, AnyStateNode, AnyTransitionDefinition, DelayedTransitionDefinition, EventObject, ExecutableActionObject, InitialTransitionConfig, InitialTransitionDefinition, MachineContext, StateValue, TransitionDefinition, TODO, UnknownAction, ParameterizedObject, AnyTransitionConfig, AnyActorScope, MetaObject } from "./types.js";
4
- type StateNodeIterable<TContext extends MachineContext, TE extends EventObject> = Iterable<StateNode<TContext, TE>>;
4
+ type StateNodeIterable<TContext extends MachineContext, TE extends EventObject> = Iterable<StateNode<TContext, TE, any, any>>;
5
5
  type AnyStateNodeIterable = StateNodeIterable<any, any>;
6
- export declare function isAtomicStateNode(stateNode: StateNode<any, any>): boolean;
6
+ export declare function isAtomicStateNode(stateNode: AnyStateNode): boolean;
7
7
  export declare function getProperAncestors(stateNode: AnyStateNode, toStateNode: AnyStateNode | undefined): Array<typeof stateNode>;
8
8
  export declare function getAllStateNodes(stateNodes: Iterable<AnyStateNode>): Set<AnyStateNode>;
9
9
  export declare function getStateValue(rootNode: AnyStateNode, stateNodes: AnyStateNodeIterable): StateValue;
10
10
  export declare function isInFinalState(stateNodeSet: Set<AnyStateNode>, stateNode: AnyStateNode): boolean;
11
11
  export declare const isStateId: (str: string) => boolean;
12
- export declare function getCandidates<TEvent extends EventObject>(stateNode: StateNode<any, TEvent>, receivedEventType: TEvent['type']): Array<TransitionDefinition<any, TEvent>>;
12
+ export declare function getCandidates<TEvent extends EventObject>(stateNode: StateNode<any, TEvent, any, any>, receivedEventType: TEvent['type']): Array<TransitionDefinition<any, TEvent, any>>;
13
13
  /** All delayed transitions from the config. */
14
- export declare function getDelayedTransitions(stateNode: AnyStateNode): Array<DelayedTransitionDefinition<MachineContext, EventObject>>;
14
+ export declare function getDelayedTransitions(stateNode: AnyStateNode): Array<DelayedTransitionDefinition<MachineContext, EventObject, any>>;
15
15
  export declare function formatTransition(stateNode: AnyStateNode, descriptor: string, transitionConfig: AnyTransitionConfig): AnyTransitionDefinition;
16
- export declare function formatTransitions<TContext extends MachineContext, TEvent extends EventObject>(stateNode: AnyStateNode): Map<string, TransitionDefinition<TContext, TEvent>[]>;
16
+ export declare function formatTransitions<TContext extends MachineContext, TEvent extends EventObject>(stateNode: AnyStateNode): Map<string, TransitionDefinition<TContext, TEvent, any>[]>;
17
17
  /**
18
18
  * Collects route transitions from all descendants with explicit IDs. Called
19
19
  * once on the root node to avoid O(N²) repeated traversals.
@@ -32,7 +32,7 @@ export declare function getStateNodeByPath(stateNode: AnyStateNode, statePath: s
32
32
  * @param stateValue The state value or State instance
33
33
  */
34
34
  export declare function getStateNodes(stateNode: AnyStateNode, stateValue: StateValue): Array<AnyStateNode>;
35
- export declare function transitionNode<TContext extends MachineContext, TEvent extends EventObject>(stateNode: AnyStateNode, stateValue: StateValue, snapshot: MachineSnapshot<TContext, TEvent, any, any, any, any, any, any>, event: TEvent): Array<TransitionDefinition<TContext, TEvent>> | undefined;
35
+ export declare function transitionNode<TContext extends MachineContext, TEvent extends EventObject>(stateNode: AnyStateNode, stateValue: StateValue, snapshot: MachineSnapshot<TContext, TEvent, any, any, any, any, any, any>, event: TEvent): Array<TransitionDefinition<TContext, TEvent, any>> | undefined;
36
36
  type Microstep = readonly [AnyMachineSnapshot, ExecutableActionObject[]];
37
37
  export declare function initialMicrostep(root: AnyStateNode, preInitialState: AnyMachineSnapshot, actorScope: AnyActorScope, initEvent: AnyEventObject, internalQueue: AnyEventObject[]): Microstep;
38
38
  export interface BuiltinAction {
@@ -374,8 +374,8 @@ export interface StateNodeDefinition<TContext extends MachineContext, TEvent ext
374
374
  }
375
375
  export interface StateMachineDefinition<TContext extends MachineContext, TEvent extends EventObject, TStateMeta extends MetaObject = MetaObject, TTransitionMeta extends MetaObject = TStateMeta> extends StateNodeDefinition<TContext, TEvent, TStateMeta, TTransitionMeta> {
376
376
  }
377
- export type AnyStateNode = StateNode<any, any>;
378
- export type AnyStateNodeDefinition = StateNodeDefinition<any, any>;
377
+ export type AnyStateNode = StateNode<any, any, any, any>;
378
+ export type AnyStateNodeDefinition = StateNodeDefinition<any, any, any, any>;
379
379
  export type AnyMachineSnapshot = MachineSnapshot<any, any, any, any, any, any, any, any>;
380
380
  /** @deprecated Use `AnyMachineSnapshot` instead */
381
381
  export type AnyState = AnyMachineSnapshot;
@@ -523,17 +523,19 @@ export interface MachineTypes<TContext extends MachineContext, TEvent extends Ev
523
523
  meta?: TStateMeta;
524
524
  transitionMeta?: TTransitionMeta;
525
525
  }
526
- export interface HistoryStateNode<TContext extends MachineContext> extends StateNode<TContext> {
526
+ export interface HistoryStateNode<TContext extends MachineContext> extends StateNode<TContext, EventObject, any, any> {
527
527
  history: 'shallow' | 'deep';
528
528
  target: string | undefined;
529
529
  }
530
- export type HistoryValue<TContext extends MachineContext, TEvent extends EventObject> = Record<string, Array<StateNode<TContext, TEvent>>>;
530
+ /** Maps history state IDs to recalled nodes, preserving TContext and TEvent with arbitrary metadata. */
531
+ export type HistoryValue<TContext extends MachineContext, TEvent extends EventObject> = Record<string, Array<StateNode<TContext, TEvent, any, any>>>;
531
532
  export type PersistedHistoryValue = Record<string, Array<{
532
533
  id: string;
533
534
  }>>;
534
535
  export type AnyHistoryValue = HistoryValue<any, any>;
535
536
  export type StateFrom<T extends AnyStateMachine | ((...args: any[]) => AnyStateMachine)> = T extends AnyStateMachine ? ReturnType<T['transition']> : T extends (...args: any[]) => AnyStateMachine ? ReturnType<ReturnType<T>['transition']> : never;
536
- export type Transitions<TContext extends MachineContext, TEvent extends EventObject> = Array<TransitionDefinition<TContext, TEvent>>;
537
+ /** Transitions with known context and event types and arbitrary metadata. */
538
+ export type Transitions<TContext extends MachineContext, TEvent extends EventObject> = Array<TransitionDefinition<TContext, TEvent, any>>;
537
539
  export interface DoneActorEvent<TOutput = unknown, TId extends string = string> extends EventObject {
538
540
  type: `xstate.done.actor.${TId}`;
539
541
  output: TOutput;
@@ -10,7 +10,7 @@ export declare function toArray<T>(value: readonly T[] | T | undefined): readonl
10
10
  export declare function resolveOutput<TContext extends MachineContext, TExpressionEvent extends EventObject>(mapper: Mapper<TContext, TExpressionEvent, unknown, EventObject> | NonReducibleUnknown, context: TContext, event: TExpressionEvent, self: AnyActorRef): unknown;
11
11
  export declare function isErrorActorEvent(event: AnyEventObject): event is ErrorActorEvent;
12
12
  export declare function toTransitionConfigArray(configLike: SingleOrArray<AnyTransitionConfig | TransitionConfigTarget>): Array<AnyTransitionConfig>;
13
- export declare function normalizeTarget<TContext extends MachineContext, TEvent extends EventObject>(target: SingleOrArray<string | StateNode<TContext, TEvent>> | undefined): ReadonlyArray<string | StateNode<TContext, TEvent>> | undefined;
13
+ export declare function normalizeTarget<TContext extends MachineContext, TEvent extends EventObject>(target: SingleOrArray<string | StateNode<TContext, TEvent, any, any>> | undefined): ReadonlyArray<string | StateNode<TContext, TEvent, any, any>> | undefined;
14
14
  export declare function toObserver<T>(nextHandler?: Observer<T> | ((value: T) => void), errorHandler?: (error: any) => void, completionHandler?: () => void): Observer<T>;
15
15
  export declare function createInvokeId(stateNodeId: string, index: number): string;
16
16
  export declare function resolveReferencedActor(machine: AnyStateMachine, src: string): any;
@@ -131,6 +131,10 @@ eventOrExpr) {
131
131
  * ```
132
132
  */
133
133
 
134
+ /** Maps history state IDs to recalled nodes, preserving TContext and TEvent with arbitrary metadata. */
135
+
136
+ /** Transitions with known context and event types and arbitrary metadata. */
137
+
134
138
  let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
135
139
  SpecialTargets["Parent"] = "#_parent";
136
140
  SpecialTargets["Internal"] = "#_internal";
@@ -125,6 +125,10 @@ eventOrExpr) {
125
125
  * ```
126
126
  */
127
127
 
128
+ /** Maps history state IDs to recalled nodes, preserving TContext and TEvent with arbitrary metadata. */
129
+
130
+ /** Transitions with known context and event types and arbitrary metadata. */
131
+
128
132
  let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
129
133
  SpecialTargets["Parent"] = "#_parent";
130
134
  SpecialTargets["Internal"] = "#_internal";
@@ -129,6 +129,10 @@ eventOrExpr) {
129
129
  * ```
130
130
  */
131
131
 
132
+ /** Maps history state IDs to recalled nodes, preserving TContext and TEvent with arbitrary metadata. */
133
+
134
+ /** Transitions with known context and event types and arbitrary metadata. */
135
+
132
136
  let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
133
137
  SpecialTargets["Parent"] = "#_parent";
134
138
  SpecialTargets["Internal"] = "#_internal";
@@ -123,6 +123,10 @@ eventOrExpr) {
123
123
  * ```
124
124
  */
125
125
 
126
+ /** Maps history state IDs to recalled nodes, preserving TContext and TEvent with arbitrary metadata. */
127
+
128
+ /** Transitions with known context and event types and arbitrary metadata. */
129
+
126
130
  let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
127
131
  SpecialTargets["Parent"] = "#_parent";
128
132
  SpecialTargets["Internal"] = "#_internal";
@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
5
  var assign = require('./assign-b8c7b733.cjs.js');
6
6
  var dist_xstateGuards = require('./raise-ad56cf14.cjs.js');
7
- var log = require('./log-aca8da4c.cjs.js');
7
+ var log = require('./log-45b0e07b.cjs.js');
8
8
  require('./xstate-dev.cjs.js');
9
9
 
10
10
 
@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
4
4
 
5
5
  var assign = require('./assign-22c2f2aa.development.cjs.js');
6
6
  var dist_xstateGuards = require('./raise-6dbf7d60.development.cjs.js');
7
- var log = require('./log-dc444aec.development.cjs.js');
7
+ var log = require('./log-01babe9f.development.cjs.js');
8
8
  require('./xstate-dev.development.cjs.js');
9
9
 
10
10
 
@@ -1,4 +1,4 @@
1
1
  export { a as assign } from './assign-08205f93.development.esm.js';
2
2
  export { b as cancel, r as raise, d as spawnChild, y as stop, s as stopChild } from './raise-4d6182c1.development.esm.js';
3
- export { a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-ccf9f9e1.development.esm.js';
3
+ export { a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-c3c57652.development.esm.js';
4
4
  import './xstate-dev.development.esm.js';
@@ -1,4 +1,4 @@
1
1
  export { a as assign } from './assign-b4b1f28f.esm.js';
2
2
  export { b as cancel, r as raise, d as spawnChild, y as stop, s as stopChild } from './raise-97446fd4.esm.js';
3
- export { a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-64b4a2b9.esm.js';
3
+ export { a as emit, e as enqueueActions, f as forwardTo, l as log, b as sendParent, s as sendTo } from './log-ddf17a4a.esm.js';
4
4
  import './xstate-dev.esm.js';