xstate 6.0.0-alpha.64 → 6.0.0-alpha.66

package/README.md

@@ -33,6 +33,13 @@ timers without replaying entry actions. Await `executeEffects()` before persisti
 to retain accepted timer deadlines. The host handles root error snapshots;
 `run()` rejects with the root error. See [durable execution](../../docs/durable-execution.md).
 
+<!-- state context refinements from packages/core/src/setup.ts and packages/core/src/State.ts -->
+
+For [typestates](../../docs/typestates.md), declare state-level `schemas.context`
+in `setup({ states })`. State functions receive narrowed context, transitions
+check the target context requirements, and `snapshot.matches(...)` narrows
+context when reading snapshots.
+
 <!-- typed inline invocation from packages/core/src/setup.ts -->
 
 Use `s.createInvoke({ src, input, onDone })` inline in `s.createMachine(...)` for an actor used in one state. It infers the actor's input and output and the enclosing state's narrowed context without registering that actor in `setup.actors`. See [typed inline invokes](../../docs/invoke.md#typed-inline-invokes).
@@ -41,6 +48,14 @@ Pass an async function directly as `src`, with `schemas.input`, `schemas.output`
 
 The helper requires input for actors whose input excludes `undefined`, and checks child IDs and source compatibility against `schemas.children` declared in the setup or machine.
 
+<!-- graph traversal events from packages/core/src/graph/index.ts -->
+
+`getAllOwnEvents(snapshot)` from `xstate/graph` includes invoke completions, errors, and delayed events. Compose it with custom traversal payloads: supplied `events` replace the defaults. See [model-based testing](../../docs/model-based-testing.md).
+
+<!-- JSON loading and runtime validation from packages/core/src/createMachineFromConfig.ts -->
+
+Revive JSON definitions with `createMachineFromConfig(json, { schemas, validator, ...sources })` to restore runtime validation. The loader validates config keys and references. See [serialization](../../docs/serialization.md).
+
 For flat finite state machines, `xstate/fsm` provides a tiny pure transition
 table with context and TypeScript support:
 
@@ -635,3 +650,15 @@ For these reasons, it is impractical for our team to be bound by decisions taken
 ### Packages
 
 Most of the packages in the XState family declare a peer dependency on XState itself. We’ll be cautious about maintaining compatibility with already-released packages when releasing a new version of XState, **but** each release of packages depending on XState will always adjust the declared peer dependency range to include the latest version of XState. For example, you should always be able to update `xstate` without `@xstate/react`. But when you update `@xstate/react`, we highly recommend updating `xstate` too.
+
+<!-- public input validation contract from src/StateMachine.ts -->
+Validate external input with `machine.eventSchema` before `actor.send()`.
+It validates complete public events, excludes internal/runtime events, and allows
+explicitly configured routes. Payload checks require runtime schemas;
+`types<T>()` supplies types only. See [public input validation](../../docs/internal-events.md#validating-public-input).
+
+<!-- entry effects and terminal transition behavior from packages/core/src/stateUtils.ts and transitionActions.ts -->
+
+Use the `enq` argument in transition, entry and exit functions to queue effects. Return context or child patches from those functions; the return value of an enqueued effect is ignored, with a development warning. See [actions](../../docs/actions.md).
+
+For actors that are done, stopped or failed, pure transitions return the same snapshot and no effects, and `snapshot.can(...)` returns `false`. See [snapshots](../../docs/snapshots.md) and [states](../../docs/states.md).