xstate 5.14.0 → 5.16.0

package/dist/{log-505687fd.development.cjs.js → log-31321d85.development.cjs.js}

@@ -1,10 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-0cd7e521.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-bad6a97b.development.cjs.js');
 
-// it's likely-ish that `(TActor & { src: TSrc })['logic']` would be faster
-// but it's only possible to do it since https://github.com/microsoft/TypeScript/pull/53098 (TS 5.1)
-// and we strive to support TS 5.0 whenever possible
 function createSpawner(actorScope, {
   machine,
   context
@@ -93,34 +90,36 @@ function resolveAssign(actorScope, snapshot, actionArgs, actionParams, {
 /**
  * Updates the current context of the machine.
  *
- * @param assignment An object that represents the partial context to update, or a
- * function that returns an object that represents the partial context to update.
- *
  * @example
-  ```ts
-  import { createMachine, assign } from 'xstate';
-
-  const countMachine = createMachine({
-    context: {
-      count: 0,
-      message: ''
-    },
-    on: {
-      inc: {
-        actions: assign({
-          count: ({ context }) => context.count + 1
-        })
-      },
-      updateMessage: {
-        actions: assign(({ context, event }) => {
-          return {
-            message: event.message.trim()
-          }
-        })
-      }
-    }
-  });
-  ```
+ *
+ * ```ts
+ * import { createMachine, assign } from 'xstate';
+ *
+ * const countMachine = createMachine({
+ *   context: {
+ *     count: 0,
+ *     message: ''
+ *   },
+ *   on: {
+ *     inc: {
+ *       actions: assign({
+ *         count: ({ context }) => context.count + 1
+ *       })
+ *     },
+ *     updateMessage: {
+ *       actions: assign(({ context, event }) => {
+ *         return {
+ *           message: event.message.trim()
+ *         };
+ *       })
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * @param assignment An object that represents the partial context to update, or
+ *   a function that returns an object that represents the partial context to
+ *   update.
  */
 function assign(assignment) {
   if (guards_dist_xstateGuards.executingCustomAction) {
@@ -154,43 +153,42 @@ function executeEmit(actorScope, {
   actorScope.defer(() => actorScope.emit(event));
 }
 /**
- * Emits an event to event handlers registered on the actor via `actor.on(event, handler)`.
+ * Emits an event to event handlers registered on the actor via `actor.on(event,
+ * handler)`.
  *
  * @example
-  ```ts
-  import { emit } from 'xstate';
-
-  const machine = createMachine({
-    // ...
-    on: {
-      something: {
-        actions: emit({
-          type: 'emitted',
-          some: 'data'
-        })
-      }
-    }
-    // ...
-  });
-
-  const actor = createActor(machine).start();
-
-  actor.on('emitted', (event) => {
-    console.log(event);
-  });
-
-  actor.send({ type: 'something' });
-  // logs:
-  // {
-  //   type: 'emitted',
-  //   some: 'data'
-  // }
-  ```
- */
-function emit(
-/**
- * The event to emit, or an expression that returns an event to emit.
+ *
+ * ```ts
+ * import { emit } from 'xstate';
+ *
+ * const machine = createMachine({
+ *   // ...
+ *   on: {
+ *     something: {
+ *       actions: emit({
+ *         type: 'emitted',
+ *         some: 'data'
+ *       })
+ *     }
+ *   }
+ *   // ...
+ * });
+ *
+ * const actor = createActor(machine).start();
+ *
+ * actor.on('emitted', (event) => {
+ *   console.log(event);
+ * });
+ *
+ * actor.send({ type: 'something' });
+ * // logs:
+ * // {
+ * //   type: 'emitted',
+ * //   some: 'data'
+ * // }
+ * ```
  */
+function emit( /** The event to emit, or an expression that returns an event to emit. */
 eventOrExpr) {
   if (guards_dist_xstateGuards.executingCustomAction) {
     console.warn('Custom actions should not call `emit()` directly, as it is not imperative. See https://stately.ai/docs/actions#built-in-actions for more details.');
@@ -208,62 +206,52 @@ eventOrExpr) {
 }
 
 /**
- *
  * @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:
+ * `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
+ * 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`.
+ * 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: Replace with native `NoInfer` when TS issue gets fixed:
 // https://github.com/microsoft/TypeScript/pull/57673
+/** @deprecated Use the built-in `NoInfer` type instead */
+/** The full definition of an event, with a string `type`. */
 /**
- * @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.
+ * 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" }`.
+ * - For complex state nodes, this is an object, e.g., `{ success:
+ *   "someChildState" }`.
  */
 // TODO: remove once TS fixes this type-widening issue
-/** @deprecated use `AnyMachineSnapshot` instead */
+/** @deprecated Use `AnyMachineSnapshot` instead */
 // TODO: possibly refactor this somehow, use even a simpler type, and maybe even make `machine.options` private or something
-/**
- * @hidden
- */
+/** @ignore */
 let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   SpecialTargets["Parent"] = "#_parent";
   SpecialTargets["Internal"] = "#_internal";
   return SpecialTargets;
 }({});
 
-/**
- * @deprecated Use `AnyActor` instead.
- */
+/** @deprecated Use `AnyActor` instead. */
 
 // Based on RxJS types
 
-/**
- * @deprecated Use `Actor<T>` instead.
- */
-
-// only meant to be used internally for debugging purposes
+/** @deprecated Use `Actor<T>` instead. */
 
 /**
  * Represents logic which can be used by an actor.
@@ -274,6 +262,8 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
  * @template TSystem - The type of the actor system.
  */
 
+/** @deprecated */
+
 function resolveSendTo(actorScope, snapshot, args, actionParams, {
   to,
   event: eventOrExpr,
@@ -348,10 +338,12 @@ function executeSendTo(actorScope, params) {
  * Sends an event to an actor.
  *
  * @param actor The `ActorRef` to send the event to.
- * @param event The event to send, or an expression that evaluates to the event to send
+ * @param event The event to send, or an expression that evaluates to the event
+ *   to send
  * @param options Send action options
- *  - `id` - The unique send event identifier (used with `cancel()`).
- *  - `delay` - The number of milliseconds to delay the sending of the event.
+ *
+ *   - `id` - The unique send event identifier (used with `cancel()`).
+ *   - `delay` - The number of milliseconds to delay the sending of the event.
  */
 function sendTo(to, eventOrExpr, options) {
   if (guards_dist_xstateGuards.executingCustomAction) {
@@ -427,6 +419,9 @@ function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
     // then it fails to typecheck that because `...args` use `string` in place of `TDelay
     actions.push(sendTo(...args));
   };
+  enqueue.sendParent = (...args) => {
+    actions.push(sendParent(...args));
+  };
   enqueue.spawnChild = (...args) => {
     actions.push(guards_dist_xstateGuards.spawnChild(...args));
   };
@@ -447,24 +442,26 @@ function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
   return [snapshot, undefined, actions];
 }
 /**
- * Creates an action object that will execute actions that are queued by the `enqueue(action)` function.
+ * Creates an action object that will execute actions that are queued by the
+ * `enqueue(action)` function.
  *
  * @example
-  ```ts
-  import { createMachine, enqueueActions } from 'xstate';
-
-  const machine = createMachine({
-    entry: enqueueActions(({ enqueue, check }) => {
-      enqueue.assign({ count: 0 });
-
-      if (check('someGuard')) {
-        enqueue.assign({ count: 1 });
-      }
-
-      enqueue('someAction');
-    })
-  })
-  ```
+ *
+ * ```ts
+ * import { createMachine, enqueueActions } from 'xstate';
+ *
+ * const machine = createMachine({
+ *   entry: enqueueActions(({ enqueue, check }) => {
+ *     enqueue.assign({ count: 0 });
+ *
+ *     if (check('someGuard')) {
+ *       enqueue.assign({ count: 1 });
+ *     }
+ *
+ *     enqueue('someAction');
+ *   })
+ * });
+ * ```
  */
 function enqueueActions(collect) {
   function enqueueActions(args, params) {
@@ -500,11 +497,12 @@ function executeLog({
   }
 }
 /**
+ * @param expr The expression function to evaluate which will be logged. Takes
+ *   in 2 arguments:
+ *
+ *   - `ctx` - the current state context
+ *   - `event` - the event that caused this action to be executed.
  *
- * @param expr The expression function to evaluate which will be logged.
- *  Takes in 2 arguments:
- *  - `ctx` - the current state context
- *  - `event` - the event that caused this action to be executed.
  * @param label The label to give to the logged expression.
  */
 function log(value = ({

package/dist/{log-b87cb6bd.esm.js → log-8320f5e6.esm.js}

@@ -1,8 +1,5 @@
-import { T as ProcessingStatus, z as resolveReferencedActor, A as createActor, U as cloneMachineSnapshot, V as XSTATE_ERROR, W as createErrorActorEvent, e as evaluateGuard, M as cancel, O as raise, P as spawnChild, R as stopChild } from './raise-4e39e875.esm.js';
+import { T as ProcessingStatus, z as resolveReferencedActor, A as createActor, U as cloneMachineSnapshot, V as XSTATE_ERROR, W as createErrorActorEvent, e as evaluateGuard, M as cancel, O as raise, P as spawnChild, R as stopChild } from './raise-2cfe6b8f.esm.js';
 
-// it's likely-ish that `(TActor & { src: TSrc })['logic']` would be faster
-// but it's only possible to do it since https://github.com/microsoft/TypeScript/pull/53098 (TS 5.1)
-// and we strive to support TS 5.0 whenever possible
 function createSpawner(actorScope, {
   machine,
   context
@@ -91,34 +88,36 @@ function resolveAssign(actorScope, snapshot, actionArgs, actionParams, {
 /**
  * Updates the current context of the machine.
  *
- * @param assignment An object that represents the partial context to update, or a
- * function that returns an object that represents the partial context to update.
- *
  * @example
-  ```ts
-  import { createMachine, assign } from 'xstate';
-
-  const countMachine = createMachine({
-    context: {
-      count: 0,
-      message: ''
-    },
-    on: {
-      inc: {
-        actions: assign({
-          count: ({ context }) => context.count + 1
-        })
-      },
-      updateMessage: {
-        actions: assign(({ context, event }) => {
-          return {
-            message: event.message.trim()
-          }
-        })
-      }
-    }
-  });
-  ```
+ *
+ * ```ts
+ * import { createMachine, assign } from 'xstate';
+ *
+ * const countMachine = createMachine({
+ *   context: {
+ *     count: 0,
+ *     message: ''
+ *   },
+ *   on: {
+ *     inc: {
+ *       actions: assign({
+ *         count: ({ context }) => context.count + 1
+ *       })
+ *     },
+ *     updateMessage: {
+ *       actions: assign(({ context, event }) => {
+ *         return {
+ *           message: event.message.trim()
+ *         };
+ *       })
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * @param assignment An object that represents the partial context to update, or
+ *   a function that returns an object that represents the partial context to
+ *   update.
  */
 function assign(assignment) {
   function assign(args, params) {
@@ -143,43 +142,42 @@ function executeEmit(actorScope, {
   actorScope.defer(() => actorScope.emit(event));
 }
 /**
- * Emits an event to event handlers registered on the actor via `actor.on(event, handler)`.
+ * Emits an event to event handlers registered on the actor via `actor.on(event,
+ * handler)`.
  *
  * @example
-  ```ts
-  import { emit } from 'xstate';
-
-  const machine = createMachine({
-    // ...
-    on: {
-      something: {
-        actions: emit({
-          type: 'emitted',
-          some: 'data'
-        })
-      }
-    }
-    // ...
-  });
-
-  const actor = createActor(machine).start();
-
-  actor.on('emitted', (event) => {
-    console.log(event);
-  });
-
-  actor.send({ type: 'something' });
-  // logs:
-  // {
-  //   type: 'emitted',
-  //   some: 'data'
-  // }
-  ```
- */
-function emit(
-/**
- * The event to emit, or an expression that returns an event to emit.
+ *
+ * ```ts
+ * import { emit } from 'xstate';
+ *
+ * const machine = createMachine({
+ *   // ...
+ *   on: {
+ *     something: {
+ *       actions: emit({
+ *         type: 'emitted',
+ *         some: 'data'
+ *       })
+ *     }
+ *   }
+ *   // ...
+ * });
+ *
+ * const actor = createActor(machine).start();
+ *
+ * actor.on('emitted', (event) => {
+ *   console.log(event);
+ * });
+ *
+ * actor.send({ type: 'something' });
+ * // logs:
+ * // {
+ * //   type: 'emitted',
+ * //   some: 'data'
+ * // }
+ * ```
  */
+function emit( /** The event to emit, or an expression that returns an event to emit. */
 eventOrExpr) {
   function emit(args, params) {
   }
@@ -191,62 +189,52 @@ eventOrExpr) {
 }
 
 /**
- *
  * @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:
+ * `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
+ * 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`.
+ * 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: Replace with native `NoInfer` when TS issue gets fixed:
 // https://github.com/microsoft/TypeScript/pull/57673
+/** @deprecated Use the built-in `NoInfer` type instead */
+/** The full definition of an event, with a string `type`. */
 /**
- * @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.
+ * 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" }`.
+ * - For complex state nodes, this is an object, e.g., `{ success:
+ *   "someChildState" }`.
  */
 // TODO: remove once TS fixes this type-widening issue
-/** @deprecated use `AnyMachineSnapshot` instead */
+/** @deprecated Use `AnyMachineSnapshot` instead */
 // TODO: possibly refactor this somehow, use even a simpler type, and maybe even make `machine.options` private or something
-/**
- * @hidden
- */
+/** @ignore */
 let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   SpecialTargets["Parent"] = "#_parent";
   SpecialTargets["Internal"] = "#_internal";
   return SpecialTargets;
 }({});
 
-/**
- * @deprecated Use `AnyActor` instead.
- */
+/** @deprecated Use `AnyActor` instead. */
 
 // Based on RxJS types
 
-/**
- * @deprecated Use `Actor<T>` instead.
- */
-
-// only meant to be used internally for debugging purposes
+/** @deprecated Use `Actor<T>` instead. */
 
 /**
  * Represents logic which can be used by an actor.
@@ -257,6 +245,8 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
  * @template TSystem - The type of the actor system.
  */
 
+/** @deprecated */
+
 function resolveSendTo(actorScope, snapshot, args, actionParams, {
   to,
   event: eventOrExpr,
@@ -331,10 +321,12 @@ function executeSendTo(actorScope, params) {
  * Sends an event to an actor.
  *
  * @param actor The `ActorRef` to send the event to.
- * @param event The event to send, or an expression that evaluates to the event to send
+ * @param event The event to send, or an expression that evaluates to the event
+ *   to send
  * @param options Send action options
- *  - `id` - The unique send event identifier (used with `cancel()`).
- *  - `delay` - The number of milliseconds to delay the sending of the event.
+ *
+ *   - `id` - The unique send event identifier (used with `cancel()`).
+ *   - `delay` - The number of milliseconds to delay the sending of the event.
  */
 function sendTo(to, eventOrExpr, options) {
   function sendTo(args, params) {
@@ -394,6 +386,9 @@ function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
     // then it fails to typecheck that because `...args` use `string` in place of `TDelay
     actions.push(sendTo(...args));
   };
+  enqueue.sendParent = (...args) => {
+    actions.push(sendParent(...args));
+  };
   enqueue.spawnChild = (...args) => {
     actions.push(spawnChild(...args));
   };
@@ -414,24 +409,26 @@ function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
   return [snapshot, undefined, actions];
 }
 /**
- * Creates an action object that will execute actions that are queued by the `enqueue(action)` function.
+ * Creates an action object that will execute actions that are queued by the
+ * `enqueue(action)` function.
  *
  * @example
-  ```ts
-  import { createMachine, enqueueActions } from 'xstate';
-
-  const machine = createMachine({
-    entry: enqueueActions(({ enqueue, check }) => {
-      enqueue.assign({ count: 0 });
-
-      if (check('someGuard')) {
-        enqueue.assign({ count: 1 });
-      }
-
-      enqueue('someAction');
-    })
-  })
-  ```
+ *
+ * ```ts
+ * import { createMachine, enqueueActions } from 'xstate';
+ *
+ * const machine = createMachine({
+ *   entry: enqueueActions(({ enqueue, check }) => {
+ *     enqueue.assign({ count: 0 });
+ *
+ *     if (check('someGuard')) {
+ *       enqueue.assign({ count: 1 });
+ *     }
+ *
+ *     enqueue('someAction');
+ *   })
+ * });
+ * ```
  */
 function enqueueActions(collect) {
   function enqueueActions(args, params) {
@@ -464,11 +461,12 @@ function executeLog({
   }
 }
 /**
+ * @param expr The expression function to evaluate which will be logged. Takes
+ *   in 2 arguments:
+ *
+ *   - `ctx` - the current state context
+ *   - `event` - the event that caused this action to be executed.
  *
- * @param expr The expression function to evaluate which will be logged.
- *  Takes in 2 arguments:
- *  - `ctx` - the current state context
- *  - `event` - the event that caused this action to be executed.
  * @param label The label to give to the logged expression.
  */
 function log(value = ({