xstate 6.0.0-alpha.51 → 6.0.0-alpha.52

package/dist/{createActor-a0610101.cjs.js → createActor-20277025.cjs.js}

@@ -983,6 +983,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [actor] = args;
         return {
+          type: '@xstate.spawn',
           kind: 'builtin',
           exec: execSpawnEffect,
           source: actor._parent,
@@ -997,6 +998,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, event, options] = args;
         return {
+          type: '@xstate.raise',
           kind: 'builtin',
           exec: execRaiseEffect,
           source: args[0].self,
@@ -1009,6 +1011,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, target, event, options] = args;
         return {
+          type: '@xstate.sendTo',
           kind: 'builtin',
           exec: execSendToEffect,
           source: args[0].self,
@@ -1022,6 +1025,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, id] = args;
         return {
+          type: '@xstate.cancel',
           kind: 'builtin',
           exec: execCancelEffect,
           source: args[0].self,
@@ -1032,6 +1036,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, actor] = args;
         return {
+          type: '@xstate.stop',
           kind: 'builtin',
           exec: execStopEffect,
           source: args[0].self,

package/dist/{createActor-67a1cda3.development.esm.js → createActor-41e3bbc3.development.esm.js}

@@ -989,6 +989,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [actor] = args;
         return {
+          type: '@xstate.spawn',
           kind: 'builtin',
           exec: execSpawnEffect,
           source: actor._parent,
@@ -1003,6 +1004,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, event, options] = args;
         return {
+          type: '@xstate.raise',
           kind: 'builtin',
           exec: execRaiseEffect,
           source: args[0].self,
@@ -1015,6 +1017,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, target, event, options] = args;
         return {
+          type: '@xstate.sendTo',
           kind: 'builtin',
           exec: execSendToEffect,
           source: args[0].self,
@@ -1028,6 +1031,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, id] = args;
         return {
+          type: '@xstate.cancel',
           kind: 'builtin',
           exec: execCancelEffect,
           source: args[0].self,
@@ -1038,6 +1042,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, actor] = args;
         return {
+          type: '@xstate.stop',
           kind: 'builtin',
           exec: execStopEffect,
           source: args[0].self,

package/dist/{createActor-ae612b26.development.cjs.js → createActor-4d94dd53.development.cjs.js}

@@ -991,6 +991,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [actor] = args;
         return {
+          type: '@xstate.spawn',
           kind: 'builtin',
           exec: execSpawnEffect,
           source: actor._parent,
@@ -1005,6 +1006,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, event, options] = args;
         return {
+          type: '@xstate.raise',
           kind: 'builtin',
           exec: execRaiseEffect,
           source: args[0].self,
@@ -1017,6 +1019,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, target, event, options] = args;
         return {
+          type: '@xstate.sendTo',
           kind: 'builtin',
           exec: execSendToEffect,
           source: args[0].self,
@@ -1030,6 +1033,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, id] = args;
         return {
+          type: '@xstate.cancel',
           kind: 'builtin',
           exec: execCancelEffect,
           source: args[0].self,
@@ -1040,6 +1044,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, actor] = args;
         return {
+          type: '@xstate.stop',
           kind: 'builtin',
           exec: execStopEffect,
           source: args[0].self,

package/dist/{createActor-5d4780c4.esm.js → createActor-6fa87eea.esm.js}

@@ -981,6 +981,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [actor] = args;
         return {
+          type: '@xstate.spawn',
           kind: 'builtin',
           exec: execSpawnEffect,
           source: actor._parent,
@@ -995,6 +996,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, event, options] = args;
         return {
+          type: '@xstate.raise',
           kind: 'builtin',
           exec: execRaiseEffect,
           source: args[0].self,
@@ -1007,6 +1009,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, target, event, options] = args;
         return {
+          type: '@xstate.sendTo',
           kind: 'builtin',
           exec: execSendToEffect,
           source: args[0].self,
@@ -1020,6 +1023,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, id] = args;
         return {
+          type: '@xstate.cancel',
           kind: 'builtin',
           exec: execCancelEffect,
           source: args[0].self,
@@ -1030,6 +1034,7 @@ function getBuiltInActionFields(action, args) {
       {
         const [, actor] = args;
         return {
+          type: '@xstate.stop',
           kind: 'builtin',
           exec: execStopEffect,
           source: args[0].self,

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

@@ -12,5 +12,6 @@ export declare function serializeSnapshot(snapshot: Snapshot<any>): SerializedSn
 export declare function createDefaultMachineOptions<TMachine extends AnyStateMachine>(machine: TMachine, options?: TraversalOptions<SnapshotFrom<TMachine>, EventFromLogic<TMachine>, InputFrom<TMachine>>): TraversalOptions<SnapshotFrom<TMachine>, EventFromLogic<TMachine>, InputFrom<TMachine>>;
 export declare function createDefaultLogicOptions(): TraversalOptions<any, any, any>;
 export declare function toDirectedGraph(stateMachine: AnyStateNode | AnyStateMachine): DirectedGraphNode;
+export declare function isMachineLogic(logic: unknown): logic is AnyStateMachine;
 export declare function resolveTraversalOptions<TLogic extends AnyActorLogic>(logic: TLogic, traversalOptions?: TraversalOptions<SnapshotFrom<TLogic>, EventFromLogic<TLogic>, InputFrom<TLogic>>, defaultOptions?: TraversalOptions<SnapshotFrom<TLogic>, EventFromLogic<TLogic>, InputFrom<TLogic>>): TraversalConfig<SnapshotFrom<TLogic>, EventFromLogic<TLogic>>;
 export declare function joinPaths<TSnapshot extends Snapshot<unknown>, TEvent extends EventObject>(headPath: StatePath<TSnapshot, TEvent>, tailPath: StatePath<TSnapshot, TEvent>): StatePath<TSnapshot, TEvent>;

package/dist/declarations/src/schema.types.d.ts

@@ -35,13 +35,15 @@ export interface TypeSchema<T> extends StandardSchemaV1<T, T> {
  *     context: types<{ count: number }>(),
  *     events: {
  *       inc: types<{ by: number }>(),
- *       reset: types<{}>()
+ *       reset: types<void>()
  *     }
  *   },
  *   context: { count: 0 }
  *   // ...
  * });
  * ```
+ *
+ * Use `types<void>()` for events without a payload.
  */
 export declare function types<T>(): TypeSchema<T>;
 /** Returns true if the value is a type-only schema created by {@link types}. */

package/dist/{effectDescriptor-143d3c39.development.cjs.js → effectDescriptor-6991ab90.development.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var createActor = require('./createActor-ae612b26.development.cjs.js');
+var createActor = require('./createActor-4d94dd53.development.cjs.js');
 
 function attachMicrostepActorRefs(microsteps, actorScope, inputSnapshot) {
   if (!microsteps.length) {

package/dist/{effectDescriptor-727e5012.esm.js → effectDescriptor-c56bd9d5.esm.js}

@@ -1,4 +1,4 @@
-import { a3 as createInertActorScope, a4 as setInertActorScopeSnapshot, F as finalizeTransitionResult, a6 as attachSnapshotActorRef, y as createInitEvent, av as hasAmbientInspector, a5 as beginSpawnAllocation, a7 as macrostep, ak as createSpawnEffect, al as initialMicrostep, i as isAtomicStateNode, aw as getProperAncestors, ax as isRemoteActorRef, ay as getActorIdPrefix } from './createActor-5d4780c4.esm.js';
+import { a3 as createInertActorScope, a4 as setInertActorScopeSnapshot, F as finalizeTransitionResult, a6 as attachSnapshotActorRef, y as createInitEvent, av as hasAmbientInspector, a5 as beginSpawnAllocation, a7 as macrostep, ak as createSpawnEffect, al as initialMicrostep, i as isAtomicStateNode, aw as getProperAncestors, ax as isRemoteActorRef, ay as getActorIdPrefix } from './createActor-6fa87eea.esm.js';
 
 function attachMicrostepActorRefs(microsteps, actorScope, inputSnapshot) {
   if (!microsteps.length) {

package/dist/{effectDescriptor-0399a5cc.development.esm.js → effectDescriptor-e64efd18.development.esm.js}

@@ -1,4 +1,4 @@
-import { a3 as createInertActorScope, a4 as setInertActorScopeSnapshot, F as finalizeTransitionResult, a6 as attachSnapshotActorRef, y as createInitEvent, av as hasAmbientInspector, a5 as beginSpawnAllocation, a7 as macrostep, ak as createSpawnEffect, al as initialMicrostep, i as isAtomicStateNode, aw as getProperAncestors, ax as isRemoteActorRef, ay as getActorIdPrefix } from './createActor-67a1cda3.development.esm.js';
+import { a3 as createInertActorScope, a4 as setInertActorScopeSnapshot, F as finalizeTransitionResult, a6 as attachSnapshotActorRef, y as createInitEvent, av as hasAmbientInspector, a5 as beginSpawnAllocation, a7 as macrostep, ak as createSpawnEffect, al as initialMicrostep, i as isAtomicStateNode, aw as getProperAncestors, ax as isRemoteActorRef, ay as getActorIdPrefix } from './createActor-41e3bbc3.development.esm.js';
 
 function attachMicrostepActorRefs(microsteps, actorScope, inputSnapshot) {
   if (!microsteps.length) {

package/dist/{effectDescriptor-f5237352.cjs.js → effectDescriptor-fa21710c.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var createActor = require('./createActor-a0610101.cjs.js');
+var createActor = require('./createActor-20277025.cjs.js');
 
 function attachMicrostepActorRefs(microsteps, actorScope, inputSnapshot) {
   if (!microsteps.length) {

package/dist/{schema.types-6c3a61af.development.esm.js → schema.types-1b4319f7.development.esm.js}

@@ -76,13 +76,15 @@ function createFSM(config) {
  *     context: types<{ count: number }>(),
  *     events: {
  *       inc: types<{ by: number }>(),
- *       reset: types<{}>()
+ *       reset: types<void>()
  *     }
  *   },
  *   context: { count: 0 }
  *   // ...
  * });
  * ```
+ *
+ * Use `types<void>()` for events without a payload.
  */
 function types() {
   return {

package/dist/{schema.types-7a48b14e.cjs.js → schema.types-20693e6b.cjs.js}

@@ -78,13 +78,15 @@ function createFSM(config) {
  *     context: types<{ count: number }>(),
  *     events: {
  *       inc: types<{ by: number }>(),
- *       reset: types<{}>()
+ *       reset: types<void>()
  *     }
  *   },
  *   context: { count: 0 }
  *   // ...
  * });
  * ```
+ *
+ * Use `types<void>()` for events without a payload.
  */
 function types() {
   return {

package/dist/{schema.types-9a23aaa8.esm.js → schema.types-7439a117.esm.js}

@@ -76,13 +76,15 @@ function createFSM(config) {
  *     context: types<{ count: number }>(),
  *     events: {
  *       inc: types<{ by: number }>(),
- *       reset: types<{}>()
+ *       reset: types<void>()
  *     }
  *   },
  *   context: { count: 0 }
  *   // ...
  * });
  * ```
+ *
+ * Use `types<void>()` for events without a payload.
  */
 function types() {
   return {

package/dist/{schema.types-e396f88c.development.cjs.js → schema.types-a2b10853.development.cjs.js}

@@ -78,13 +78,15 @@ function createFSM(config) {
  *     context: types<{ count: number }>(),
  *     events: {
  *       inc: types<{ by: number }>(),
- *       reset: types<{}>()
+ *       reset: types<void>()
  *     }
  *   },
  *   context: { count: 0 }
  *   // ...
  * });
  * ```
+ *
+ * Use `types<void>()` for events without a payload.
  */
 function types() {
   return {

package/dist/{StateMachine-c3c54551.cjs.js → types-5d934c5c.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var createActor = require('./createActor-a0610101.cjs.js');
+var createActor = require('./createActor-20277025.cjs.js');
 var validation = require('./validation-4561b43c.cjs.js');
 
 function createSpawner(actorScope, actors, spawnedChildren) {
@@ -1232,5 +1232,195 @@ class StateMachine {
   }
 }
 
+/**
+ * Creates a state machine (statechart) with the given configuration.
+ *
+ * The state machine represents the pure logic of a state machine actor.
+ *
+ * @example
+ *
+ * ```ts
+ * import { createMachine } from 'xstate';
+ *
+ * const lightMachine = createMachine({
+ *   id: 'light',
+ *   initial: 'green',
+ *   states: {
+ *     green: {
+ *       on: {
+ *         TIMER: { target: 'yellow' }
+ *       }
+ *     },
+ *     yellow: {
+ *       on: {
+ *         TIMER: { target: 'red' }
+ *       }
+ *     },
+ *     red: {
+ *       on: {
+ *         TIMER: { target: 'green' }
+ *       }
+ *     }
+ *   }
+ * });
+ *
+ * const lightActor = createActor(lightMachine);
+ * lightActor.start();
+ *
+ * lightActor.send({ type: 'TIMER' });
+ * ```
+ *
+ * @param config The state machine configuration.
+ * @param options DEPRECATED: use `setup({ ... })` or `machine.provide({ ... })`
+ *   to provide machine sources instead.
+ */
+// Overload 1: With schemas.context — context type inferred from schema
+
+// Overload 2: Without schemas.context — context type inferred from config.context
+
+// Implementation
+function createMachine(config) {
+  return new StateMachine(config);
+}
+function createStateConfig(config) {
+  return config;
+}
+
+// this is needed to make JSDoc `@link` work properly
+// oxlint-disable-next-line no-unused-vars
+
+/**
+ * @remarks
+ * `T | unknown` reduces to `unknown` and that can be problematic when it comes
+ * to contextual typing. It especially is a problem when the union has a
+ * function member, like here:
+ *
+ * ```ts
+ * declare function test(
+ *   cbOrVal: ((arg: number) => unknown) | unknown
+ * ): void;
+ * test((arg) => {}); // oops, implicit any
+ * ```
+ *
+ * This type can be used to avoid this problem. This union represents the same
+ * value space as `unknown`.
+ */
+
+// https://github.com/microsoft/TypeScript/issues/23182#issuecomment-379091887
+
+// @TODO: we can't use native `NoInfer` as we need those:
+// https://github.com/microsoft/TypeScript/pull/61092
+// https://github.com/microsoft/TypeScript/pull/61077
+// but even with those fixes native NoInfer still doesn't work - further issues have to be reproduced and fixed
+
+/** @deprecated Use the built-in `NoInfer` type instead */
+
+/** The full definition of an event, with a string `type`. */
+
+/**
+ * The string or object representing the state value relative to the parent
+ * state node.
+ *
+ * @remarks
+ * - For a child atomic state node, this is a string, e.g., `"pending"`.
+ * - For complex state nodes, this is an object, e.g., `{ success:
+ *   "someChildState" }`.
+ */
+
+// Accept any StateNode instance regardless of generic parameters
+// Using a union type to handle variance issues with machine.resolveState
+
+let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
+  SpecialTargets["Internal"] = "#_internal";
+  return SpecialTargets;
+}({});
+
+/** A deterministic delayed-delivery declaration owned by a logic snapshot. */
+
+/** The logical input delivered to a timer's source when its runtime delay ends. */
+
+/** A persisted snapshot tied to a versioned actor logic identity. */
+
+/**
+ * A persisted snapshot restorable into the given actor logic: any snapshot
+ * created by logic with the same machine `id` is accepted, regardless of
+ * version (version mismatches are handled at runtime, e.g. by `migrate`).
+ */
+
+/** @deprecated Use `AnyActor` instead. */
+
+// Based on RxJS types
+
+/**
+ * A consumer-facing actor handle.
+ *
+ * `ActorRef` describes the contract a consumer needs: which events can be sent
+ * to the actor, which snapshot it publishes for observation, and which emitted
+ * events can be listened to. It intentionally does not expose lifecycle control
+ * or runtime internals. A concrete `Actor` satisfies this interface, so APIs
+ * should accept `ActorRef` whenever they only need to send events, read
+ * snapshots, or listen to emitted events.
+ */
+
+/**
+ * Runtime-only actor capabilities.
+ *
+ * These members are needed by the interpreter, scheduler, inspection, and child
+ * management code. Public consumer APIs should prefer `ActorRef` unless they
+ * genuinely need lifecycle control such as starting, stopping, or accessing
+ * system-owned runtime state.
+ */
+
+/**
+ * A concrete actor instance type.
+ *
+ * `ActorInstance` combines the consumer `ActorRef` contract with runtime
+ * lifecycle capabilities. Values returned by `createActor(...)` and
+ * `spawn(...)` naturally satisfy narrower `ActorRef` contracts.
+ */
+
+/**
+ * The actor's own full self handle.
+ *
+ * Internals and action/guard sources receive this shape because `self` can
+ * participate in runtime-owned behavior while still being usable wherever an
+ * `ActorRef` is expected.
+ */
+
+// TODO: in v6, this should only accept AnyActorLogic, like ActorRefFromLogic
+
+/** The concrete actor instance type produced from actor logic. */
+
+/**
+ * Represents logic which can be used by an actor.
+ *
+ * @template TSnapshot - The type of the snapshot.
+ * @template TEvent - The type of the event object.
+ * @template TInput - The type of the input.
+ * @template TSystem - The type of the actor system.
+ */
+
+// Actors that don't have literal string IDs — these are the only ones
+// that should appear in the index signature fallback, since actors with
+// literal IDs are already covered by ToConcreteChildren.
+
+/** Maps state IDs to their input types based on the StateSchema. */
+
+/** @deprecated */
+
+/** The terminal result published when an actor completes or errors. */
+
+/** An executable effect that publishes an actor's terminal result. */
+
+/**
+ * An executable effect that reports an event rejected at the delivery boundary
+ * (a dead letter). The snapshot paired with this effect is unchanged.
+ */
+
+/** Mappers for subscribeTo - maps lifecycle events to machine events */
+
+exports.SpecialTargets = SpecialTargets;
 exports.StateMachine = StateMachine;
 exports.StateNode = StateNode;
+exports.createMachine = createMachine;
+exports.createStateConfig = createStateConfig;