xstate 4.15.3 → 4.16.2

package/lib/StateNode.d.ts

@@ -81,11 +81,11 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
     /**
      * The parent state node.
      */
-    parent?: StateNode<TContext, any, TEvent>;
+    parent?: StateNode<TContext, any, TEvent, any>;
     /**
      * The root machine node.
      */
-    machine: StateNode<TContext, any, TEvent>;
+    machine: StateNode<TContext, any, TEvent, TTypestate>;
     /**
      * The meta data associated with this state node, which will be returned in State instances.
      */
@@ -159,7 +159,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param state The state value or State instance
      */
-    getStateNodes(state: StateValue | State<TContext, TEvent, any, TTypestate>): Array<StateNode<TContext, any, TEvent>>;
+    getStateNodes(state: StateValue | State<TContext, TEvent, any, TTypestate>): Array<StateNode<TContext, any, TEvent, any>>;
     /**
      * Returns `true` if this state node explicitly handles the given event.
      *
@@ -173,7 +173,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param state The state to resolve
      */
-    resolveState(state: State<TContext, TEvent>): State<TContext, TEvent, TStateSchema, TTypestate>;
+    resolveState(state: State<TContext, TEvent, any, any>): State<TContext, TEvent, TStateSchema, TTypestate>;
     private transitionLeafNode;
     private transitionCompoundNode;
     private transitionParallelNode;
@@ -205,13 +205,13 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param stateId The state ID. The prefix "#" is removed.
      */
-    getStateNodeById(stateId: string): StateNode<TContext, any, TEvent>;
+    getStateNodeById(stateId: string): StateNode<TContext, any, TEvent, any>;
     /**
      * Returns the relative state node from the given `statePath`, or throws.
      *
      * @param statePath The string or string array relative path to the state node.
      */
-    getStateNodeByPath(statePath: string | string[]): StateNode<TContext, any, TEvent>;
+    getStateNodeByPath(statePath: string | string[]): StateNode<TContext, any, TEvent, any>;
     /**
      * Resolves a partial state value with its full representation in this machine.
      *
@@ -239,14 +239,14 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      * @param resolve Whether state nodes should resolve to initial child state nodes
      */
     getRelativeStateNodes(relativeStateId: StateNode<TContext, any, TEvent>, historyValue?: HistoryValue, resolve?: boolean): Array<StateNode<TContext, any, TEvent>>;
-    get initialStateNodes(): Array<StateNode<TContext, any, TEvent>>;
+    get initialStateNodes(): Array<StateNode<TContext, any, TEvent, any>>;
     /**
      * Retrieves state nodes from a relative path to this state node.
      *
      * @param relativePath The relative path from this state node
      * @param historyValue
      */
-    getFromRelativePath(relativePath: string[]): Array<StateNode<TContext, any, TEvent>>;
+    getFromRelativePath(relativePath: string[]): Array<StateNode<TContext, any, TEvent, any>>;
     private historyValue;
     /**
      * Resolves to the historical value(s) of the parent state node,

package/lib/StateNode.js

@@ -429,7 +429,7 @@ var StateNode = /** @class */ (function () {
      */
     StateNode.prototype.resolveState = function (state) {
         var configuration = Array.from(stateUtils_1.getConfiguration([], this.getStateNodes(state.value)));
-        return new State_1.State(__assign(__assign({}, state), { value: this.resolve(state.value), configuration: configuration }));
+        return new State_1.State(__assign(__assign({}, state), { value: this.resolve(state.value), configuration: configuration, done: stateUtils_1.isInFinalState(configuration, this) }));
     };
     StateNode.prototype.transitionLeafNode = function (stateValue, state, _event) {
         var stateNode = this.getStateNode(stateValue);

package/lib/actions.d.ts

@@ -135,5 +135,5 @@ export declare function forwardTo<TContext, TEvent extends EventObject>(target:
  */
 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<ChooseConditon<TContext, TEvent>>): ChooseAction<TContext, TEvent>;
-export declare function resolveActions<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent>, currentState: State<TContext, TEvent> | undefined, currentContext: TContext, _event: SCXML.Event<TEvent>, actions: Array<ActionObject<TContext, TEvent>>): [Array<ActionObject<TContext, TEvent>>, TContext];
+export declare function resolveActions<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent, any>, currentState: State<TContext, TEvent> | undefined, currentContext: TContext, _event: SCXML.Event<TEvent>, actions: Array<ActionObject<TContext, TEvent>>): [Array<ActionObject<TContext, TEvent>>, TContext];
 //# sourceMappingURL=actions.d.ts.map

package/lib/devTools.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { Interpreter } from '.';
-declare type AnyInterpreter = Interpreter<any, any, any>;
+import { AnyInterpreter } from './types';
 declare type ServiceListener = (service: AnyInterpreter) => void;
 export interface XStateDevInterface {
     register: (service: Interpreter<any>) => void;
@@ -10,7 +10,7 @@ export interface XStateDevInterface {
     };
     services: Set<Interpreter<any>>;
 }
-export declare function getGlobal(): (Window & typeof globalThis) | NodeJS.Global | undefined;
+export declare function getGlobal(): (Window & typeof globalThis) | (NodeJS.Global & typeof globalThis) | undefined;
 export declare function registerService(service: AnyInterpreter): void;
 export {};
 //# sourceMappingURL=devTools.d.ts.map

package/lib/interpreter.js

@@ -486,6 +486,10 @@ var Interpreter = /** @class */ (function () {
             }
             finally { if (e_9) throw e_9.error; }
         }
+        if (!this.initialized) {
+            // Interpreter already stopped; do nothing
+            return this;
+        }
         this.state.configuration.forEach(function (stateNode) {
             var e_11, _a;
             try {

package/lib/model.d.ts

@@ -0,0 +1,8 @@
+import type { AssignAction, Assigner, PropertyAssigner, ExtractEvent, EventObject } from './types';
+export interface ContextModel<TContext, TEvent extends EventObject> {
+    initialContext: TContext;
+    assign: <TEventType extends TEvent['type'] = TEvent['type']>(assigner: Assigner<TContext, ExtractEvent<TEvent, TEventType>> | PropertyAssigner<TContext, ExtractEvent<TEvent, TEventType>>, eventType?: TEventType) => AssignAction<TContext, ExtractEvent<TEvent, TEventType>>;
+    reset: () => AssignAction<TContext, any>;
+}
+export declare function createModel<TContext, TEvent extends EventObject>(initialContext: TContext): ContextModel<TContext, TEvent>;
+//# sourceMappingURL=model.d.ts.map

package/lib/model.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModel = void 0;
+var actions_1 = require("./actions");
+function createModel(initialContext) {
+    var model = {
+        initialContext: initialContext,
+        assign: actions_1.assign,
+        reset: function () { return actions_1.assign(initialContext); }
+    };
+    return model;
+}
+exports.createModel = createModel;

package/lib/serviceScope.d.ts

@@ -1,10 +1,4 @@
-import { Interpreter } from './interpreter';
-export declare const provide: <T, TService extends Interpreter<any, any, any, {
-    value: any;
-    context: any;
-}>>(service: TService | undefined, fn: (service: TService | undefined) => T) => T;
-export declare const consume: <T, TService extends Interpreter<any, any, any, {
-    value: any;
-    context: any;
-}>>(fn: (service: TService) => T) => T;
+import { AnyInterpreter } from './types';
+export declare const provide: <T, TService extends AnyInterpreter>(service: TService | undefined, fn: (service: TService | undefined) => T) => T;
+export declare const consume: <T, TService extends AnyInterpreter>(fn: (service: TService) => T) => T;
 //# sourceMappingURL=serviceScope.d.ts.map

package/lib/stateUtils.d.ts

@@ -1,14 +1,14 @@
 import { EventObject, StateNode, StateValue } from '.';
 declare type Configuration<TC, TE extends EventObject> = Iterable<StateNode<TC, any, TE>>;
 declare type AdjList<TC, TE extends EventObject> = Map<StateNode<TC, any, TE>, Array<StateNode<TC, any, TE>>>;
-export declare const isLeafNode: (stateNode: StateNode<any, any, any>) => boolean;
+export declare const isLeafNode: (stateNode: StateNode<any, any, any, any>) => boolean;
 export declare function getChildren<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE>): Array<StateNode<TC, any, TE>>;
-export declare function getAllStateNodes<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE>): Array<StateNode<TC, any, TE>>;
-export declare function getConfiguration<TC, TE extends EventObject>(prevStateNodes: Iterable<StateNode<TC, any, TE>>, stateNodes: Iterable<StateNode<TC, any, TE>>): Iterable<StateNode<TC, any, TE>>;
+export declare function getAllStateNodes<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE, any>): Array<StateNode<TC, any, TE, any>>;
+export declare function getConfiguration<TC, TE extends EventObject>(prevStateNodes: Iterable<StateNode<TC, any, TE, any>>, stateNodes: Iterable<StateNode<TC, any, TE, any>>): Iterable<StateNode<TC, any, TE, any>>;
 export declare function getAdjList<TC, TE extends EventObject>(configuration: Configuration<TC, TE>): AdjList<TC, TE>;
-export declare function getValue<TC, TE extends EventObject>(rootNode: StateNode<TC, any, TE>, configuration: Configuration<TC, TE>): StateValue;
+export declare function getValue<TC, TE extends EventObject>(rootNode: StateNode<TC, any, TE, any>, configuration: Configuration<TC, TE>): StateValue;
 export declare function has<T>(iterable: Iterable<T>, item: T): boolean;
 export declare function nextEvents<TC, TE extends EventObject>(configuration: Array<StateNode<TC, any, TE>>): Array<TE['type']>;
-export declare function isInFinalState<TC, TE extends EventObject>(configuration: Array<StateNode<TC, any, TE>>, stateNode: StateNode<TC, any, TE>): boolean;
+export declare function isInFinalState<TC, TE extends EventObject>(configuration: Array<StateNode<TC, any, TE, any>>, stateNode: StateNode<TC, any, TE, any>): boolean;
 export {};
 //# sourceMappingURL=stateUtils.d.ts.map

package/lib/types.d.ts

@@ -201,7 +201,7 @@ export declare type StatesDefinition<TContext, TStateSchema extends StateSchema,
 };
 export declare type TransitionConfigTarget<TContext, TEvent extends EventObject> = string | undefined | StateNode<TContext, any, TEvent>;
 export declare type TransitionConfigOrTarget<TContext, TEvent extends EventObject> = SingleOrArray<TransitionConfigTarget<TContext, TEvent> | TransitionConfig<TContext, TEvent>>;
-declare type TransitionsConfigMap<TContext, TEvent extends EventObject> = {
+export declare type TransitionsConfigMap<TContext, TEvent extends EventObject> = {
     [K in TEvent['type']]?: TransitionConfigOrTarget<TContext, TEvent extends {
         type: K;
     } ? TEvent : never>;
@@ -433,7 +433,7 @@ export interface MachineOptions<TContext, TEvent extends EventObject> {
     /**
      * @private
      */
-    _parent?: StateNode<TContext, any, TEvent>;
+    _parent?: StateNode<TContext, any, TEvent, any>;
     /**
      * @private
      */
@@ -489,13 +489,13 @@ export interface ActivityMap {
 }
 export interface StateTransition<TContext, TEvent extends EventObject> {
     transitions: Array<TransitionDefinition<TContext, TEvent>>;
-    configuration: Array<StateNode<TContext, any, TEvent>>;
-    entrySet: Array<StateNode<TContext, any, TEvent>>;
-    exitSet: Array<StateNode<TContext, any, TEvent>>;
+    configuration: Array<StateNode<TContext, any, TEvent, any>>;
+    entrySet: Array<StateNode<TContext, any, TEvent, any>>;
+    exitSet: Array<StateNode<TContext, any, TEvent, any>>;
     /**
      * The source state that preceded the transition.
      */
-    source: State<TContext> | undefined;
+    source: State<TContext, any, any, any> | undefined;
     actions: Array<ActionObject<TContext, TEvent>>;
 }
 export interface TransitionData<TContext, TEvent extends EventObject> {
@@ -616,8 +616,9 @@ export interface CancelAction extends ActionObject<any, any> {
     sendId: string | number;
 }
 export declare type Assigner<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent, meta: AssignMeta<TContext, TEvent>) => Partial<TContext>;
+export declare type PartialAssigner<TContext, TEvent extends EventObject, TKey extends keyof TContext> = (context: TContext, event: TEvent, meta: AssignMeta<TContext, TEvent>) => TContext[TKey];
 export declare type PropertyAssigner<TContext, TEvent extends EventObject> = {
-    [K in keyof TContext]?: ((context: TContext, event: TEvent, meta: AssignMeta<TContext, TEvent>) => TContext[K]) | TContext[K];
+    [K in keyof TContext]?: PartialAssigner<TContext, TEvent, K> | TContext[K];
 };
 export declare type Mapper<TContext, TEvent extends EventObject, TParams extends {}> = (context: TContext, event: TEvent) => TParams;
 export declare type PropertyMapper<TContext, TEvent extends EventObject, TParams extends {}> = {
@@ -715,7 +716,7 @@ export interface SCXMLEventMeta<TEvent extends EventObject> {
     _event: SCXML.Event<TEvent>;
 }
 export interface StateMeta<TContext, TEvent extends EventObject> {
-    state: State<TContext, TEvent>;
+    state: State<TContext, TEvent, any, any>;
     _event: SCXML.Event<TEvent>;
 }
 export interface Typestate<TContext> {
@@ -758,7 +759,7 @@ export interface InterpreterOptions {
     execute: boolean;
     clock: Clock;
     logger: (...args: any[]) => void;
-    parent?: Interpreter<any, any, any>;
+    parent?: AnyInterpreter;
     /**
      * If `true`, defers processing of sent events until the service
      * is initialized (`.start()`). Otherwise, an error will be thrown
@@ -854,6 +855,9 @@ export interface Subscribable<T> {
     subscribe(next: (value: T) => void, error?: (error: any) => void, complete?: () => void): Subscription;
 }
 export declare type Spawnable = StateMachine<any, any, any> | Promise<any> | InvokeCallback | Subscribable<any>;
+export declare type ExtractEvent<TEvent extends EventObject, TEventType extends TEvent['type']> = TEvent extends {
+    type: TEventType;
+} ? TEvent : never;
 export interface ActorRef<TEvent extends EventObject, TEmitted = any> extends Subscribable<TEmitted> {
     send: Sender<TEvent>;
 }
@@ -865,5 +869,6 @@ export interface SpawnedActorRef<TEvent extends EventObject, TEmitted = any> ext
 export declare type ActorRefFrom<T extends StateMachine<any, any, any>> = T extends StateMachine<infer TContext, any, infer TEvent, infer TTypestate> ? SpawnedActorRef<TEvent, State<TContext, TEvent, any, TTypestate>> & {
     state: State<TContext, TEvent, any, TTypestate>;
 } : never;
+export declare type AnyInterpreter = Interpreter<any, any, any, any>;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/utils.d.ts

@@ -10,12 +10,10 @@ export declare function toStatePath(stateId: string | string[], delimiter: strin
 export declare function isStateLike(state: any): state is StateLike<any>;
 export declare function toStateValue(stateValue: StateLike<any> | StateValue | string[], delimiter: string): StateValue;
 export declare function pathToStateValue(statePath: string[]): StateValue;
-export declare function mapValues<T, P>(collection: {
+export declare function mapValues<T, P, O extends {
     [key: string]: T;
-}, iteratee: (item: T, key: string, collection: {
-    [key: string]: T;
-}, i: number) => P): {
-    [key: string]: P;
+}>(collection: O, iteratee: (item: O[keyof O], key: keyof O, collection: O, i: number) => P): {
+    [key in keyof O]: P;
 };
 export declare function mapFilterValues<T, P>(collection: {
     [key: string]: T;
@@ -53,7 +51,7 @@ export declare function isFunction(value: any): value is Function;
 export declare function isString(value: any): value is string;
 export declare function toGuard<TContext, TEvent extends EventObject>(condition?: Condition<TContext, TEvent>, guardMap?: Record<string, ConditionPredicate<TContext, TEvent>>): Guard<TContext, TEvent> | undefined;
 export declare function isObservable<T>(value: any): value is Subscribable<T>;
-export declare const symbolObservable: string | symbol;
+export declare const symbolObservable: any;
 export declare function isMachine(value: any): value is StateMachine<any, any, any>;
 export declare function isActor(value: any): value is Actor;
 export declare const uniqueId: () => string;
@@ -64,7 +62,7 @@ export declare function toTransitionConfigArray<TContext, TEvent extends EventOb
 }>;
 export declare function normalizeTarget<TContext, TEvent extends EventObject>(target: SingleOrArray<string | StateNode<TContext, any, TEvent>> | undefined): Array<string | StateNode<TContext, any, TEvent>> | undefined;
 export declare function reportUnhandledExceptionOnInvocation(originalError: any, currentError: any, id: string): void;
-export declare function evaluateGuard<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent>, guard: Guard<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>, state: State<TContext, TEvent>): boolean;
+export declare function evaluateGuard<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent, any>, guard: Guard<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>, state: State<TContext, TEvent>): boolean;
 export declare function toInvokeSource(src: string | InvokeSourceDefinition): InvokeSourceDefinition;
 export declare function toObserver<T>(nextHandler: Observer<T> | ((value: T) => void), errorHandler?: (error: any) => void, completionHandler?: () => void): Observer<T>;
 //# sourceMappingURL=utils.d.ts.map

package/lib/utils.js

@@ -507,7 +507,8 @@ function isObservable(value) {
 }
 exports.isObservable = isObservable;
 exports.symbolObservable = (function () {
-    return (typeof Symbol === 'function' && Symbol.observable) || '@@observable';
+    return (typeof Symbol === 'function' && Symbol.observable) ||
+        '@@observable';
 })();
 function isMachine(value) {
     try {

package/package.json

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