xstate 5.0.0-alpha.0 → 5.0.0-alpha.2

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

@@ -1,127 +1,127 @@
-import type { Event, EventObject, StateNodeDefinition, TransitionDefinition, DelayedTransitionDefinition, StateNodeConfig, StateNodesConfig, InvokeDefinition, Mapper, PropertyMapper, SCXML, TransitionDefinitionMap, InitialTransitionDefinition, MachineContext, BaseActionObject } from './types';
-import type { State } from './State';
-import type { StateMachine } from './StateMachine';
-interface StateNodeOptions<TContext extends MachineContext, TEvent extends EventObject> {
-    _key: string;
-    _parent?: StateNode<TContext, TEvent>;
-    _machine: StateMachine<TContext, TEvent, any, any, any>;
-}
-export declare class StateNode<TContext extends MachineContext = MachineContext, TEvent extends EventObject = EventObject> {
-    /**
-     * The raw config used to create the machine.
-     */
-    config: StateNodeConfig<TContext, TEvent>;
-    /**
-     * The relative key of the state node, which represents its location in the overall state value.
-     */
-    key: string;
-    /**
-     * The unique ID of the state node.
-     */
-    id: string;
-    /**
-     * The type of this state node:
-     *
-     *  - `'atomic'` - no child state nodes
-     *  - `'compound'` - nested child state nodes (XOR)
-     *  - `'parallel'` - orthogonal nested child state nodes (AND)
-     *  - `'history'` - history state node
-     *  - `'final'` - final state node
-     */
-    type: 'atomic' | 'compound' | 'parallel' | 'final' | 'history';
-    /**
-     * The string path from the root machine node to this node.
-     */
-    path: string[];
-    /**
-     * The child state nodes.
-     */
-    states: StateNodesConfig<TContext, TEvent>;
-    /**
-     * The type of history on this state node. Can be:
-     *
-     *  - `'shallow'` - recalls only top-level historical state value
-     *  - `'deep'` - recalls historical state value at all levels
-     */
-    history: false | 'shallow' | 'deep';
-    /**
-     * The action(s) to be executed upon entering the state node.
-     */
-    entry: BaseActionObject[];
-    /**
-     * The action(s) to be executed upon exiting the state node.
-     */
-    exit: BaseActionObject[];
-    /**
-     * The parent state node.
-     */
-    parent?: StateNode<TContext, TEvent>;
-    /**
-     * The root machine node.
-     */
-    machine: StateMachine<TContext, TEvent, any, any>;
-    /**
-     * The meta data associated with this state node, which will be returned in State instances.
-     */
-    meta?: any;
-    /**
-     * The data sent with the "done.state._id_" event if this is a final state node.
-     */
-    doneData?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
-    /**
-     * The order this state node appears. Corresponds to the implicit SCXML document order.
-     */
-    order: number;
-    description?: string;
-    tags: string[];
-    transitions: Array<TransitionDefinition<TContext, TEvent>>;
-    always?: Array<TransitionDefinition<TContext, TEvent>>;
-    constructor(
-    /**
-     * The raw config used to create the machine.
-     */
-    config: StateNodeConfig<TContext, TEvent>, options: StateNodeOptions<TContext, TEvent>);
-    _initialize(): void;
-    /**
-     * The well-structured state node definition.
-     */
-    get definition(): StateNodeDefinition<TContext, TEvent>;
-    toJSON(): StateNodeDefinition<TContext, TEvent>;
-    /**
-     * The behaviors invoked as actors by this state node.
-     */
-    get invoke(): Array<InvokeDefinition<TContext, TEvent>>;
-    /**
-     * The mapping of events to transitions.
-     */
-    get on(): TransitionDefinitionMap<TContext, TEvent>;
-    get after(): Array<DelayedTransitionDefinition<TContext, TEvent>>;
-    get initial(): InitialTransitionDefinition<TContext, TEvent>;
-    /**
-     * Returns `true` if this state node explicitly handles the given event.
-     *
-     * @param event The event in question
-     */
-    handles(event: Event<TEvent>): boolean;
-    next(state: State<TContext, TEvent>, _event: SCXML.Event<TEvent>): TransitionDefinition<TContext, TEvent>[] | undefined;
-    /**
-     * The target state value of the history state node, if it exists. This represents the
-     * default state value to transition to if no history value exists yet.
-     */
-    get target(): string | undefined;
-    /**
-     * All the state node IDs of this state node and its descendant state nodes.
-     */
-    get stateIds(): string[];
-    /**
-     * All the event types accepted by this state node and its descendants.
-     */
-    get events(): Array<TEvent['type']>;
-    /**
-     * All the events that have transitions directly from this state node.
-     *
-     * Excludes any inert events.
-     */
-    get ownEvents(): Array<TEvent['type']>;
-}
-export {};
+import type { EventObject, StateNodeDefinition, TransitionDefinition, DelayedTransitionDefinition, StateNodeConfig, StateNodesConfig, InvokeDefinition, Mapper, PropertyMapper, SCXML, TransitionDefinitionMap, InitialTransitionDefinition, MachineContext, BaseActionObject } from './types.js';
+import type { State } from './State.js';
+import type { StateMachine } from './StateMachine.js';
+interface StateNodeOptions<TContext extends MachineContext, TEvent extends EventObject> {
+    _key: string;
+    _parent?: StateNode<TContext, TEvent>;
+    _machine: StateMachine<TContext, TEvent, any, any, any>;
+}
+export declare class StateNode<TContext extends MachineContext = MachineContext, TEvent extends EventObject = EventObject> {
+    /**
+     * The raw config used to create the machine.
+     */
+    config: StateNodeConfig<TContext, TEvent>;
+    /**
+     * The relative key of the state node, which represents its location in the overall state value.
+     */
+    key: string;
+    /**
+     * The unique ID of the state node.
+     */
+    id: string;
+    /**
+     * The type of this state node:
+     *
+     *  - `'atomic'` - no child state nodes
+     *  - `'compound'` - nested child state nodes (XOR)
+     *  - `'parallel'` - orthogonal nested child state nodes (AND)
+     *  - `'history'` - history state node
+     *  - `'final'` - final state node
+     */
+    type: 'atomic' | 'compound' | 'parallel' | 'final' | 'history';
+    /**
+     * The string path from the root machine node to this node.
+     */
+    path: string[];
+    /**
+     * The child state nodes.
+     */
+    states: StateNodesConfig<TContext, TEvent>;
+    /**
+     * The type of history on this state node. Can be:
+     *
+     *  - `'shallow'` - recalls only top-level historical state value
+     *  - `'deep'` - recalls historical state value at all levels
+     */
+    history: false | 'shallow' | 'deep';
+    /**
+     * The action(s) to be executed upon entering the state node.
+     */
+    entry: BaseActionObject[];
+    /**
+     * The action(s) to be executed upon exiting the state node.
+     */
+    exit: BaseActionObject[];
+    /**
+     * The parent state node.
+     */
+    parent?: StateNode<TContext, TEvent>;
+    /**
+     * The root machine node.
+     */
+    machine: StateMachine<TContext, TEvent, any, any>;
+    /**
+     * The meta data associated with this state node, which will be returned in State instances.
+     */
+    meta?: any;
+    /**
+     * The data sent with the "done.state._id_" event if this is a final state node.
+     */
+    doneData?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
+    /**
+     * The order this state node appears. Corresponds to the implicit SCXML document order.
+     */
+    order: number;
+    description?: string;
+    tags: string[];
+    transitions: Array<TransitionDefinition<TContext, TEvent>>;
+    always?: Array<TransitionDefinition<TContext, TEvent>>;
+    constructor(
+    /**
+     * The raw config used to create the machine.
+     */
+    config: StateNodeConfig<TContext, TEvent>, options: StateNodeOptions<TContext, TEvent>);
+    _initialize(): void;
+    /**
+     * The well-structured state node definition.
+     */
+    get definition(): StateNodeDefinition<TContext, TEvent>;
+    toJSON(): StateNodeDefinition<TContext, TEvent>;
+    /**
+     * The behaviors invoked as actors by this state node.
+     */
+    get invoke(): Array<InvokeDefinition<TContext, TEvent>>;
+    /**
+     * The mapping of events to transitions.
+     */
+    get on(): TransitionDefinitionMap<TContext, TEvent>;
+    get after(): Array<DelayedTransitionDefinition<TContext, TEvent>>;
+    get initial(): InitialTransitionDefinition<TContext, TEvent>;
+    /**
+     * Returns `true` if this state node explicitly handles the given event.
+     *
+     * @param event The event in question
+     */
+    handles(event: TEvent): boolean;
+    next(state: State<TContext, TEvent>, _event: SCXML.Event<TEvent>): TransitionDefinition<TContext, TEvent>[] | undefined;
+    /**
+     * The target state value of the history state node, if it exists. This represents the
+     * default state value to transition to if no history value exists yet.
+     */
+    get target(): string | undefined;
+    /**
+     * All the state node IDs of this state node and its descendant state nodes.
+     */
+    get stateIds(): string[];
+    /**
+     * All the event types accepted by this state node and its descendants.
+     */
+    get events(): Array<TEvent['type']>;
+    /**
+     * All the events that have transitions directly from this state node.
+     *
+     * Excludes any inert events.
+     */
+    get ownEvents(): Array<TEvent['type']>;
+}
+export {};

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

@@ -1,17 +1,16 @@
-import { ActionTypes } from './types';
-export declare const stop = ActionTypes.Stop;
-export declare const raise = ActionTypes.Raise;
-export declare const send = ActionTypes.Send;
-export declare const cancel = ActionTypes.Cancel;
-export declare const assign = ActionTypes.Assign;
-export declare const after = ActionTypes.After;
-export declare const doneState = ActionTypes.DoneState;
-export declare const log = ActionTypes.Log;
-export declare const init = ActionTypes.Init;
-export declare const invoke = ActionTypes.Invoke;
-export declare const errorExecution = ActionTypes.ErrorExecution;
-export declare const errorPlatform = ActionTypes.ErrorPlatform;
-export declare const error = ActionTypes.ErrorCustom;
-export declare const update = ActionTypes.Update;
-export declare const choose = ActionTypes.Choose;
-export declare const pure = ActionTypes.Pure;
+import { ActionTypes } from './types.js';
+export declare const stop = ActionTypes.Stop;
+export declare const raise = ActionTypes.Raise;
+export declare const send = ActionTypes.Send;
+export declare const cancel = ActionTypes.Cancel;
+export declare const assign = ActionTypes.Assign;
+export declare const after = ActionTypes.After;
+export declare const doneState = ActionTypes.DoneState;
+export declare const log = ActionTypes.Log;
+export declare const init = ActionTypes.Init;
+export declare const invoke = ActionTypes.Invoke;
+export declare const errorExecution = ActionTypes.ErrorExecution;
+export declare const errorPlatform = ActionTypes.ErrorPlatform;
+export declare const error = ActionTypes.ErrorCustom;
+export declare const choose = ActionTypes.Choose;
+export declare const pure = ActionTypes.Pure;

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

@@ -1,7 +1,7 @@
-import type { EventObject, Assigner, PropertyAssigner, MachineContext, DynamicAssignAction } from '../types';
-/**
- * Updates the current context of the machine.
- *
- * @param assignment An object that represents the partial context to update.
- */
-export declare function assign<TContext extends MachineContext, TEvent extends EventObject = EventObject, TAssignment extends Assigner<TContext, TEvent> | PropertyAssigner<TContext, TEvent> = Assigner<TContext, TEvent> | PropertyAssigner<TContext, TEvent>>(assignment: TAssignment): DynamicAssignAction<TContext, TEvent>;
+import type { EventObject, Assigner, PropertyAssigner, MachineContext, DynamicAssignAction, LowInfer } from '../types.js';
+/**
+ * Updates the current context of the machine.
+ *
+ * @param assignment An object that represents the partial context to update.
+ */
+export declare function assign<TContext extends MachineContext, TExpressionEvent extends EventObject = EventObject, TEvent extends EventObject = TExpressionEvent>(assignment: Assigner<LowInfer<TContext>, TExpressionEvent, TEvent> | PropertyAssigner<LowInfer<TContext>, TExpressionEvent, TEvent>): DynamicAssignAction<TContext, TExpressionEvent, TEvent>;

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

@@ -1,10 +1,10 @@
-import { EventObject, ExprWithMeta, MachineContext } from '../types';
-import { BaseDynamicActionObject, CancelActionObject, DynamicCancelActionObject } from '..';
-/**
- * Cancels an in-flight `send(...)` action. A canceled sent action will not
- * be executed, nor will its event be sent, unless it has already been sent
- * (e.g., if `cancel(...)` is called after the `send(...)` action's `delay`).
- *
- * @param sendId The `id` of the `send(...)` action to cancel.
- */
-export declare function cancel<TContext extends MachineContext, TEvent extends EventObject>(sendId: string | ExprWithMeta<TContext, TEvent, string>): BaseDynamicActionObject<TContext, TEvent, CancelActionObject, DynamicCancelActionObject<TContext, TEvent>['params']>;
+import { EventObject, ExprWithMeta, MachineContext } from '../types.js';
+import { BaseDynamicActionObject, CancelActionObject, DynamicCancelActionObject } from '../index.js';
+/**
+ * Cancels an in-flight `send(...)` action. A canceled sent action will not
+ * be executed, nor will its event be sent, unless it has already been sent
+ * (e.g., if `cancel(...)` is called after the `send(...)` action's `delay`).
+ *
+ * @param sendId The `id` of the `send(...)` action to cancel.
+ */
+export declare function cancel<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject>(sendId: string | ExprWithMeta<TContext, TExpressionEvent, string>): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, CancelActionObject, DynamicCancelActionObject<TContext, TExpressionEvent>['params']>;

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

@@ -1,3 +1,3 @@
-import { EventObject, ChooseCondition, MachineContext } from '../types';
-import { BaseDynamicActionObject, ChooseAction, ResolvedChooseAction } from '..';
-export declare function choose<TContext extends MachineContext, TEvent extends EventObject>(guards: Array<ChooseCondition<TContext, TEvent>>): BaseDynamicActionObject<TContext, TEvent, ResolvedChooseAction, ChooseAction<TContext, TEvent>['params']>;
+import { EventObject, ChooseCondition, MachineContext } from '../types.js';
+import { BaseDynamicActionObject, ChooseAction, ResolvedChooseAction } from '../index.js';
+export declare function choose<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject>(guards: Array<ChooseCondition<TContext, TExpressionEvent>>): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, ResolvedChooseAction, ChooseAction<TContext, TExpressionEvent>['params']>;

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

@@ -1,3 +1,3 @@
-import { EventObject, InvokeDefinition, MachineContext } from '../types';
-import { BaseDynamicActionObject, DynamicInvokeActionObject, InvokeActionObject } from '..';
-export declare function invoke<TContext extends MachineContext, TEvent extends EventObject>(invokeDef: InvokeDefinition<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, InvokeActionObject, DynamicInvokeActionObject<TContext, TEvent>['params']>;
+import { EventObject, InvokeDefinition, MachineContext } from '../types.js';
+import { BaseDynamicActionObject, DynamicInvokeActionObject, InvokeActionObject } from '../index.js';
+export declare function invoke<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject>(invokeDef: InvokeDefinition<TContext, TEvent>): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, InvokeActionObject, DynamicInvokeActionObject<TContext, TEvent>['params']>;

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

@@ -1,11 +1,11 @@
-import { EventObject, LogExpr, MachineContext, LogActionObject } from '../types';
-import { BaseDynamicActionObject, DynamicLogAction } from '..';
-/**
- *
- * @param expr The expression function to evaluate which will be logged.
- *  Takes in 2 arguments:
- *  - `ctx` - the current state context
- *  - `event` - the event that caused this action to be executed.
- * @param label The label to give to the logged expression.
- */
-export declare function log<TContext extends MachineContext, TEvent extends EventObject>(expr?: string | LogExpr<TContext, TEvent>, label?: string): BaseDynamicActionObject<TContext, TEvent, LogActionObject, DynamicLogAction<TContext, TEvent>['params']>;
+import { EventObject, LogExpr, MachineContext, LogActionObject } from '../types.js';
+import { BaseDynamicActionObject, DynamicLogAction } from '../index.js';
+/**
+ *
+ * @param expr The expression function to evaluate which will be logged.
+ *  Takes in 2 arguments:
+ *  - `ctx` - the current state context
+ *  - `event` - the event that caused this action to be executed.
+ * @param label The label to give to the logged expression.
+ */
+export declare function log<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(expr?: string | LogExpr<TContext, TExpressionEvent>, label?: string): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, LogActionObject, DynamicLogAction<TContext, TExpressionEvent, TEvent>['params']>;

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

@@ -1,3 +1,3 @@
-import { EventObject, SingleOrArray, MachineContext } from '../types';
-import { BaseActionObject, BaseDynamicActionObject, DynamicPureActionObject, PureActionObject } from '..';
-export declare function pure<TContext extends MachineContext, TEvent extends EventObject>(getActions: (context: TContext, event: TEvent) => SingleOrArray<BaseActionObject> | undefined): BaseDynamicActionObject<TContext, TEvent, PureActionObject, DynamicPureActionObject<TContext, TEvent>['params']>;
+import { EventObject, SingleOrArray, MachineContext } from '../types.js';
+import { BaseActionObject, BaseDynamicActionObject, DynamicPureActionObject, PureActionObject } from '..';
+export declare function pure<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(getActions: (context: TContext, event: TExpressionEvent) => SingleOrArray<BaseActionObject | string> | undefined): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, PureActionObject, DynamicPureActionObject<TContext, TExpressionEvent>['params']>;

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

@@ -1,9 +1,8 @@
-import { Event, EventObject, RaiseActionObject } from '../types';
-import { BaseDynamicActionObject } from '..';
-/**
- * Raises an event. This places the event in the internal event queue, so that
- * the event is immediately consumed by the machine in the current step.
- *
- * @param eventType The event to raise.
- */
-export declare function raise<TEvent extends EventObject>(event: Event<TEvent>): BaseDynamicActionObject<any, TEvent, RaiseActionObject<TEvent>, RaiseActionObject<TEvent>['params']>;
+import { EventObject, MachineContext, RaiseActionObject, BaseDynamicActionObject, RaiseActionOptions, SendExpr, RaiseActionParams, NoInfer } from '../types.js';
+/**
+ * Raises an event. This places the event in the internal event queue, so that
+ * the event is immediately consumed by the machine in the current step.
+ *
+ * @param eventType The event to raise.
+ */
+export declare function raise<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(eventOrExpr: NoInfer<TEvent> | SendExpr<TContext, TExpressionEvent, NoInfer<TEvent>>, options?: RaiseActionOptions<TContext, TExpressionEvent>): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, RaiseActionObject<TContext, TExpressionEvent, TEvent>, RaiseActionParams<TContext, TExpressionEvent, TEvent>>;

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

@@ -1,55 +1,53 @@
-import { Event, EventObject, SendActionParams, SendExpr, AnyEventObject, MachineContext } from '../types';
-import { AnyActorRef, BaseDynamicActionObject, Cast, EventFrom, ExprWithMeta, InferEvent, SendActionObject, SendActionOptions } from '..';
-/**
- * Sends an event. This returns an action that will be read by an interpreter to
- * send the event in the next step, after the current step is finished executing.
- *
- * @param event The event to send.
- * @param options Options to pass into the send event:
- *  - `id` - The unique send event identifier (used with `cancel()`).
- *  - `delay` - The number of milliseconds to delay the sending of the event.
- *  - `to` - The target of this event (by default, the machine the event was sent from).
- */
-export declare function send<TContext extends MachineContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: Event<TSentEvent> | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent>>;
-/**
- * Sends an update event to this machine's parent.
- */
-export declare function sendUpdate<TContext extends MachineContext, TEvent extends EventObject>(): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
-/**
- * Sends an event to this machine's parent.
- *
- * @param event The event to send to the parent machine.
- * @param options Options to pass into the send event.
- */
-export declare function sendParent<TContext extends MachineContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: Event<TSentEvent> | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
-/**
- * Sends an event back to the sender of the original event.
- *
- * @param event The event to send back to the sender
- * @param options Options to pass into the send event
- */
-export declare function respond<TContext extends MachineContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: Event<TEvent> | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
-/**
- * Forwards (sends) an event to a specified service.
- *
- * @param target The target service to forward the event to.
- * @param options Options to pass into the send action creator.
- */
-export declare function forwardTo<TContext extends MachineContext, TEvent extends EventObject>(target: Required<SendActionParams<TContext, TEvent>>['to'], options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
-/**
- * Escalates an error by sending it as an event to this machine's parent.
- *
- * @param errorData The error data to send, or the expression function that
- * takes in the `context`, `event`, and `meta`, and returns the error data to send.
- * @param options Options to pass into the send action creator.
- */
-export declare function escalate<TContext extends MachineContext, TEvent extends EventObject, TErrorData = any>(errorData: TErrorData | ExprWithMeta<TContext, TEvent, TErrorData>, options?: SendActionParams<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
-/**
- * Sends an event to an actor.
- *
- * @param actor The `ActorRef` to send the event to.
- * @param event The event to send, or an expression that evaluates to the event to send
- * @param options Send action options
- * @returns An XState send action object
- */
-export declare function sendTo<TContext extends MachineContext, TEvent extends EventObject, TActor extends AnyActorRef>(actor: (ctx: TContext) => TActor, event: EventFrom<TActor> | SendExpr<TContext, TEvent, InferEvent<Cast<EventFrom<TActor>, EventObject>>>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
+import { EventObject, SendActionParams, SendExpr, AnyEventObject, MachineContext } from '../types.js';
+import { AnyActorRef, BaseDynamicActionObject, Cast, EventFrom, ExprWithMeta, InferEvent, SendActionObject, SendActionOptions } from '../index.js';
+/**
+ * Sends an event. This returns an action that will be read by an interpreter to
+ * send the event in the next step, after the current step is finished executing.
+ *
+ * @deprecated Use the `sendTo(...)` action creator instead.
+ *
+ * @param eventOrExpr The event to send.
+ * @param options Options to pass into the send event:
+ *  - `id` - The unique send event identifier (used with `cancel()`).
+ *  - `delay` - The number of milliseconds to delay the sending of the event.
+ *  - `to` - The target of this event (by default, the machine the event was sent from).
+ */
+export declare function send<TContext extends MachineContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(eventOrExpr: TSentEvent | SendExpr<TContext, TEvent, AnyEventObject>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent>>;
+/**
+ * Sends an event to this machine's parent.
+ *
+ * @param event The event to send to the parent machine.
+ * @param options Options to pass into the send event.
+ */
+export declare function sendParent<TContext extends MachineContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: TSentEvent | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
+/**
+ * Sends an event back to the sender of the original event.
+ *
+ * @param event The event to send back to the sender
+ * @param options Options to pass into the send event
+ */
+export declare function respond<TContext extends MachineContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject>(event: TEvent | SendExpr<TContext, TEvent, TSentEvent>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
+/**
+ * Forwards (sends) an event to a specified service.
+ *
+ * @param target The target service to forward the event to.
+ * @param options Options to pass into the send action creator.
+ */
+export declare function forwardTo<TContext extends MachineContext, TEvent extends EventObject>(target: Required<SendActionParams<TContext, TEvent>>['to'], options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
+/**
+ * Escalates an error by sending it as an event to this machine's parent.
+ *
+ * @param errorData The error data to send, or the expression function that
+ * takes in the `context`, `event`, and `meta`, and returns the error data to send.
+ * @param options Options to pass into the send action creator.
+ */
+export declare function escalate<TContext extends MachineContext, TEvent extends EventObject, TErrorData = any>(errorData: TErrorData | ExprWithMeta<TContext, TEvent, TErrorData>, options?: SendActionParams<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;
+/**
+ * Sends an event to an actor.
+ *
+ * @param actor The `ActorRef` to send the event to.
+ * @param event The event to send, or an expression that evaluates to the event to send
+ * @param options Send action options
+ * @returns An XState send action object
+ */
+export declare function sendTo<TContext extends MachineContext, TEvent extends EventObject, TActor extends AnyActorRef>(actor: TActor | string | ExprWithMeta<TContext, TEvent, TActor | string>, event: EventFrom<TActor> | SendExpr<TContext, TEvent, InferEvent<Cast<EventFrom<TActor>, EventObject>>>, options?: SendActionOptions<TContext, TEvent>): BaseDynamicActionObject<TContext, TEvent, TEvent, SendActionObject<AnyEventObject>, SendActionParams<TContext, TEvent, EventObject>>;

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

@@ -1,8 +1,7 @@
-import { EventObject, ActorRef, Expr, MachineContext } from '../types';
-import { BaseDynamicActionObject, DynamicStopActionObject, StopActionObject } from '..';
-/**
- * Stops an actor.
- *
- * @param actorRef The actor to stop.
- */
-export declare function stop<TContext extends MachineContext, TEvent extends EventObject>(actorRef: string | Expr<TContext, TEvent, ActorRef<any>>): BaseDynamicActionObject<TContext, TEvent, StopActionObject, DynamicStopActionObject<TContext, TEvent>['params']>;
+import { ActorRef, BaseDynamicActionObject, DynamicStopActionObject, EventObject, Expr, MachineContext, StopActionObject } from '../types.js';
+/**
+ * Stops an actor.
+ *
+ * @param actorRef The actor to stop.
+ */
+export declare function stop<TContext extends MachineContext, TExpressionEvent extends EventObject, TEvent extends EventObject>(actorRef: string | ActorRef<any> | Expr<TContext, TExpressionEvent, ActorRef<any> | string>): BaseDynamicActionObject<TContext, TExpressionEvent, TEvent, StopActionObject, DynamicStopActionObject<TContext, TExpressionEvent>['params']>;