xstate 4.19.2 → 4.20.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # xstate
 
+## 4.20.0
+
+### Minor Changes
+
+- [`28059b9f`](https://github.com/davidkpiano/xstate/commit/28059b9f09926d683d80b7d816f5b703c0667a9f) [#2197](https://github.com/davidkpiano/xstate/pull/2197) Thanks [@davidkpiano](https://github.com/davidkpiano)! - All spawned and invoked actors now have a `.getSnapshot()` method, which allows you to retrieve the latest value emitted from that actor. That value may be `undefined` if no value has been emitted yet.
+
+  ```js
+  const machine = createMachine({
+    context: {
+      promiseRef: null
+    },
+    initial: 'pending',
+    states: {
+      pending: {
+        entry: assign({
+          promiseRef: () => spawn(fetch(/* ... */), 'some-promise')
+        })
+      }
+    }
+  });
+
+  const service = interpret(machine)
+    .onTransition(state => {
+      // Read promise value synchronously
+      const resolvedValue = state.context.promiseRef?.getSnapshot();
+      // => undefined (if promise not resolved yet)
+      // => { ... } (resolved data)
+    })
+    .start();
+
+  // ...
+  ```
+
+### Patch Changes
+
+- [`4ef03465`](https://github.com/davidkpiano/xstate/commit/4ef03465869e27dc878ec600661c9253d90f74f0) [#2240](https://github.com/davidkpiano/xstate/pull/2240) Thanks [@VanTanev](https://github.com/VanTanev)! - Preserve StateMachine type when .withConfig() and .withContext() modifiers are used on a machine.
+
 ## 4.19.2
 
 ### Patch Changes

package/es/StateNode.d.ts

@@ -136,7 +136,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param context Custom context (will override predefined context, not recursive)
      */
-    withContext(context: TContext): StateNode<TContext, TStateSchema, TEvent>;
+    withContext(context: TContext): StateNode<TContext, TStateSchema, TEvent, TTypestate>;
     /**
      * The well-structured state node definition.
      */

package/es/types.d.ts

@@ -490,6 +490,8 @@ export interface StateMachine<TContext, TStateSchema extends StateSchema, TEvent
 }> extends StateNode<TContext, TStateSchema, TEvent, TTypestate> {
     id: string;
     states: StateNode<TContext, TStateSchema, TEvent>['states'];
+    withConfig(options: Partial<MachineOptions<TContext, TEvent>>, context?: TContext): StateMachine<TContext, TStateSchema, TEvent, TTypestate>;
+    withContext(context: TContext): StateMachine<TContext, TStateSchema, TEvent, TTypestate>;
 }
 export declare type StateFrom<TMachine extends StateMachine<any, any, any>> = ReturnType<TMachine['transition']>;
 export interface ActionMap<TContext, TEvent extends EventObject> {
@@ -890,6 +892,9 @@ export interface SpawnedActorRef<TEvent extends EventObject, TEmitted = any> ext
     toJSON?: () => any;
 }
 export declare type ActorRefFrom<T extends StateMachine<any, any, any> | Promise<any>> = T extends StateMachine<infer TContext, any, infer TEvent, infer TTypestate> ? SpawnedActorRef<TEvent, State<TContext, TEvent, any, TTypestate>> & {
+    /**
+     * @deprecated
+     */
     state: State<TContext, TEvent, any, TTypestate>;
 } : T extends Promise<infer U> ? SpawnedActorRef<never, U> : never;
 export declare type AnyInterpreter = Interpreter<any, any, any, any>;

package/lib/StateNode.d.ts

@@ -136,7 +136,7 @@ declare class StateNode<TContext = any, TStateSchema extends StateSchema = any,
      *
      * @param context Custom context (will override predefined context, not recursive)
      */
-    withContext(context: TContext): StateNode<TContext, TStateSchema, TEvent>;
+    withContext(context: TContext): StateNode<TContext, TStateSchema, TEvent, TTypestate>;
     /**
      * The well-structured state node definition.
      */

package/lib/types.d.ts

@@ -490,6 +490,8 @@ export interface StateMachine<TContext, TStateSchema extends StateSchema, TEvent
 }> extends StateNode<TContext, TStateSchema, TEvent, TTypestate> {
     id: string;
     states: StateNode<TContext, TStateSchema, TEvent>['states'];
+    withConfig(options: Partial<MachineOptions<TContext, TEvent>>, context?: TContext): StateMachine<TContext, TStateSchema, TEvent, TTypestate>;
+    withContext(context: TContext): StateMachine<TContext, TStateSchema, TEvent, TTypestate>;
 }
 export declare type StateFrom<TMachine extends StateMachine<any, any, any>> = ReturnType<TMachine['transition']>;
 export interface ActionMap<TContext, TEvent extends EventObject> {
@@ -890,6 +892,9 @@ export interface SpawnedActorRef<TEvent extends EventObject, TEmitted = any> ext
     toJSON?: () => any;
 }
 export declare type ActorRefFrom<T extends StateMachine<any, any, any> | Promise<any>> = T extends StateMachine<infer TContext, any, infer TEvent, infer TTypestate> ? SpawnedActorRef<TEvent, State<TContext, TEvent, any, TTypestate>> & {
+    /**
+     * @deprecated
+     */
     state: State<TContext, TEvent, any, TTypestate>;
 } : T extends Promise<infer U> ? SpawnedActorRef<never, U> : never;
 export declare type AnyInterpreter = Interpreter<any, any, any, any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xstate",
-  "version": "4.19.2",
+  "version": "4.20.0",
   "description": "Finite State Machines and Statecharts for the Modern Web.",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -66,7 +66,7 @@
     "rxjs": "^6.5.1",
     "ts-jest": "^26.5.6",
     "tslib": "^2.2.0",
-    "typescript": "^4.2.4",
+    "typescript": "^4.3.2",
     "xml-js": "^1.6.11"
   }
 }