xstate 4.36.0 → 4.37.0

package/es/actions.d.ts

@@ -74,7 +74,7 @@ export declare function respond<TContext, TEvent extends EventObject, TSentEvent
  *  - `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, TEvent extends EventObject>(expr?: string | LogExpr<TContext, TEvent>, label?: string): LogAction<TContext, TEvent>;
+export declare function log<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(expr?: string | LogExpr<TContext, TExpressionEvent>, label?: string): LogAction<TContext, TExpressionEvent, TEvent>;
 export declare const resolveLog: <TContext, TEvent extends EventObject>(action: LogAction<TContext, TEvent, TEvent>, ctx: TContext, _event: SCXML.Event<TEvent>) => LogActionObject<TContext, TEvent>;
 /**
  * Cancels an in-flight `send(...)` action. A canceled sent action will not
@@ -83,7 +83,7 @@ export declare const resolveLog: <TContext, TEvent extends EventObject>(action:
  *
  * @param sendId The `id` of the `send(...)` action to cancel.
  */
-export declare const cancel: <TContext, TEvent extends EventObject>(sendId: string | number) => CancelAction<TContext, TEvent, TEvent>;
+export declare const cancel: <TContext, TExpressionEvent extends EventObject, TEvent extends EventObject>(sendId: string | number) => CancelAction<TContext, TExpressionEvent, TEvent>;
 /**
  * Starts an activity.
  *
@@ -95,9 +95,9 @@ export declare function start<TContext, TEvent extends EventObject>(activity: st
  *
  * @param actorRef The activity to stop.
  */
-export declare function stop<TContext, TEvent extends EventObject>(actorRef: string | Expr<TContext, TEvent, string | {
+export declare function stop<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(actorRef: string | Expr<TContext, TExpressionEvent, string | {
     id: string;
-}>): StopAction<TContext, TEvent>;
+}>): StopAction<TContext, TExpressionEvent, TEvent>;
 export declare function resolveStop<TContext, TEvent extends EventObject>(action: StopAction<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>): StopActionObject;
 /**
  * Updates the current context of the machine.
@@ -133,7 +133,7 @@ export declare function done(id: string, data?: any): DoneEventObject;
  */
 export declare function doneInvoke(id: string, data?: any): DoneEvent;
 export declare function error(id: string, data?: any): ErrorPlatformEvent & string;
-export declare function pure<TContext, TEvent extends EventObject>(getActions: (context: TContext, event: TEvent) => SingleOrArray<BaseActionObject | BaseActionObject['type'] | ActionObject<TContext, TEvent>> | undefined): PureAction<TContext, TEvent>;
+export declare function pure<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(getActions: (context: TContext, event: TExpressionEvent) => SingleOrArray<BaseActionObject | BaseActionObject['type'] | ActionObject<TContext, TExpressionEvent, TEvent>> | undefined): PureAction<TContext, TExpressionEvent, TEvent>;
 /**
  * Forwards (sends) an event to a specified service.
  *
@@ -149,7 +149,7 @@ export declare function forwardTo<TContext, TEvent extends EventObject>(target:
  * @param options Options to pass into the send action creator.
  */
 export declare function escalate<TContext, TEvent extends EventObject, TErrorData = any>(errorData: TErrorData | ExprWithMeta<TContext, TEvent, TErrorData>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, AnyEventObject>;
-export declare function choose<TContext, TEvent extends EventObject>(conds: Array<ChooseCondition<TContext, TEvent>>): ChooseAction<TContext, TEvent>;
+export declare function choose<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(conds: Array<ChooseCondition<TContext, TExpressionEvent, TEvent>>): ChooseAction<TContext, TExpressionEvent, TEvent>;
 export declare function resolveActions<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent, any, any, any>, currentState: State<TContext, TEvent, any, any, any> | undefined, currentContext: TContext, _event: SCXML.Event<TEvent>, actionBlocks: Array<{
     type: string;
     actions: Array<ActionObject<TContext, TEvent>>;

package/es/types.d.ts

@@ -78,9 +78,9 @@ export interface AssignMeta<TContext, TEvent extends EventObject> {
 export declare type ActionFunction<TContext, TExpressionEvent extends EventObject, TAction extends BaseActionObject = BaseActionObject, TEvent extends EventObject = TExpressionEvent> = {
     bivarianceHack(context: TContext, event: TExpressionEvent, meta: ActionMeta<TContext, TEvent, TAction>): void;
 }['bivarianceHack'];
-export interface ChooseCondition<TContext, TEvent extends EventObject> {
-    cond?: Condition<TContext, TEvent>;
-    actions: Actions<TContext, TEvent>;
+export interface ChooseCondition<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent> {
+    cond?: Condition<TContext, TExpressionEvent>;
+    actions: Actions<TContext, TExpressionEvent, TEvent>;
 }
 export declare type Action<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent> = ActionType | BaseActionObject | ActionObject<TContext, TExpressionEvent, TEvent> | ActionFunction<TContext, TExpressionEvent, BaseActionObject, TEvent>;
 /**
@@ -1049,5 +1049,6 @@ declare type Matches<TypegenEnabledArg, TypegenDisabledArg> = {
 };
 export declare type StateValueFrom<TMachine extends AnyStateMachine> = StateFrom<TMachine>['matches'] extends Matches<infer TypegenEnabledArg, infer TypegenDisabledArg> ? TMachine['__TResolvedTypesMeta'] extends TypegenEnabled ? TypegenEnabledArg : TypegenDisabledArg : never;
 export declare type PredictableActionArgumentsExec = (action: ActionObject<unknown, EventObject>, context: unknown, _event: SCXML.Event<EventObject>) => void;
+export declare type TagsFrom<TMachine extends AnyStateMachine> = Parameters<StateFrom<TMachine>['hasTag']>[0];
 export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/actions.d.ts

@@ -74,7 +74,7 @@ export declare function respond<TContext, TEvent extends EventObject, TSentEvent
  *  - `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, TEvent extends EventObject>(expr?: string | LogExpr<TContext, TEvent>, label?: string): LogAction<TContext, TEvent>;
+export declare function log<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(expr?: string | LogExpr<TContext, TExpressionEvent>, label?: string): LogAction<TContext, TExpressionEvent, TEvent>;
 export declare const resolveLog: <TContext, TEvent extends EventObject>(action: LogAction<TContext, TEvent, TEvent>, ctx: TContext, _event: SCXML.Event<TEvent>) => LogActionObject<TContext, TEvent>;
 /**
  * Cancels an in-flight `send(...)` action. A canceled sent action will not
@@ -83,7 +83,7 @@ export declare const resolveLog: <TContext, TEvent extends EventObject>(action:
  *
  * @param sendId The `id` of the `send(...)` action to cancel.
  */
-export declare const cancel: <TContext, TEvent extends EventObject>(sendId: string | number) => CancelAction<TContext, TEvent, TEvent>;
+export declare const cancel: <TContext, TExpressionEvent extends EventObject, TEvent extends EventObject>(sendId: string | number) => CancelAction<TContext, TExpressionEvent, TEvent>;
 /**
  * Starts an activity.
  *
@@ -95,9 +95,9 @@ export declare function start<TContext, TEvent extends EventObject>(activity: st
  *
  * @param actorRef The activity to stop.
  */
-export declare function stop<TContext, TEvent extends EventObject>(actorRef: string | Expr<TContext, TEvent, string | {
+export declare function stop<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(actorRef: string | Expr<TContext, TExpressionEvent, string | {
     id: string;
-}>): StopAction<TContext, TEvent>;
+}>): StopAction<TContext, TExpressionEvent, TEvent>;
 export declare function resolveStop<TContext, TEvent extends EventObject>(action: StopAction<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>): StopActionObject;
 /**
  * Updates the current context of the machine.
@@ -133,7 +133,7 @@ export declare function done(id: string, data?: any): DoneEventObject;
  */
 export declare function doneInvoke(id: string, data?: any): DoneEvent;
 export declare function error(id: string, data?: any): ErrorPlatformEvent & string;
-export declare function pure<TContext, TEvent extends EventObject>(getActions: (context: TContext, event: TEvent) => SingleOrArray<BaseActionObject | BaseActionObject['type'] | ActionObject<TContext, TEvent>> | undefined): PureAction<TContext, TEvent>;
+export declare function pure<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(getActions: (context: TContext, event: TExpressionEvent) => SingleOrArray<BaseActionObject | BaseActionObject['type'] | ActionObject<TContext, TExpressionEvent, TEvent>> | undefined): PureAction<TContext, TExpressionEvent, TEvent>;
 /**
  * Forwards (sends) an event to a specified service.
  *
@@ -149,7 +149,7 @@ export declare function forwardTo<TContext, TEvent extends EventObject>(target:
  * @param options Options to pass into the send action creator.
  */
 export declare function escalate<TContext, TEvent extends EventObject, TErrorData = any>(errorData: TErrorData | ExprWithMeta<TContext, TEvent, TErrorData>, options?: SendActionOptions<TContext, TEvent>): SendAction<TContext, TEvent, AnyEventObject>;
-export declare function choose<TContext, TEvent extends EventObject>(conds: Array<ChooseCondition<TContext, TEvent>>): ChooseAction<TContext, TEvent>;
+export declare function choose<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent>(conds: Array<ChooseCondition<TContext, TExpressionEvent, TEvent>>): ChooseAction<TContext, TExpressionEvent, TEvent>;
 export declare function resolveActions<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent, any, any, any>, currentState: State<TContext, TEvent, any, any, any> | undefined, currentContext: TContext, _event: SCXML.Event<TEvent>, actionBlocks: Array<{
     type: string;
     actions: Array<ActionObject<TContext, TEvent>>;

package/lib/types.d.ts

@@ -78,9 +78,9 @@ export interface AssignMeta<TContext, TEvent extends EventObject> {
 export declare type ActionFunction<TContext, TExpressionEvent extends EventObject, TAction extends BaseActionObject = BaseActionObject, TEvent extends EventObject = TExpressionEvent> = {
     bivarianceHack(context: TContext, event: TExpressionEvent, meta: ActionMeta<TContext, TEvent, TAction>): void;
 }['bivarianceHack'];
-export interface ChooseCondition<TContext, TEvent extends EventObject> {
-    cond?: Condition<TContext, TEvent>;
-    actions: Actions<TContext, TEvent>;
+export interface ChooseCondition<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent> {
+    cond?: Condition<TContext, TExpressionEvent>;
+    actions: Actions<TContext, TExpressionEvent, TEvent>;
 }
 export declare type Action<TContext, TExpressionEvent extends EventObject, TEvent extends EventObject = TExpressionEvent> = ActionType | BaseActionObject | ActionObject<TContext, TExpressionEvent, TEvent> | ActionFunction<TContext, TExpressionEvent, BaseActionObject, TEvent>;
 /**
@@ -1049,5 +1049,6 @@ declare type Matches<TypegenEnabledArg, TypegenDisabledArg> = {
 };
 export declare type StateValueFrom<TMachine extends AnyStateMachine> = StateFrom<TMachine>['matches'] extends Matches<infer TypegenEnabledArg, infer TypegenDisabledArg> ? TMachine['__TResolvedTypesMeta'] extends TypegenEnabled ? TypegenEnabledArg : TypegenDisabledArg : never;
 export declare type PredictableActionArgumentsExec = (action: ActionObject<unknown, EventObject>, context: unknown, _event: SCXML.Event<EventObject>) => void;
+export declare type TagsFrom<TMachine extends AnyStateMachine> = Parameters<StateFrom<TMachine>['hasTag']>[0];
 export {};
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xstate",
-  "version": "4.36.0",
+  "version": "4.37.0",
   "description": "Finite State Machines and Statecharts for the Modern Web.",
   "main": "lib/index.js",
   "module": "es/index.js",