xstate 5.8.2 → 5.9.1

package/dist/{log-12b88b7e.cjs.js → log-28ea35fe.development.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-af6a698b.cjs.js');
+var guards_dist_xstateGuards = require('./raise-933cd731.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)
@@ -124,6 +124,9 @@ function resolveAssign(actorScope, snapshot, actionArgs, actionParams, {
  */
 function assign(assignment) {
   function assign(args, params) {
+    {
+      throw new Error(`This isn't supposed to be called`);
+    }
   }
   assign.type = 'xstate.assign';
   assign.assignment = assignment;
@@ -131,6 +134,73 @@ function assign(assignment) {
   return assign;
 }
 
+function resolveEmit(_, snapshot, args, actionParams, {
+  event: eventOrExpr
+}) {
+  if (typeof eventOrExpr === 'string') {
+    throw new Error(`Only event objects may be used with emit; use emit({ type: "${eventOrExpr}" }) instead`);
+  }
+  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args, actionParams) : eventOrExpr;
+  return [snapshot, {
+    event: resolvedEvent
+  }];
+}
+function executeEmit(actorScope, {
+  event
+}) {
+  actorScope.defer(() => actorScope.emit(event));
+}
+/**
+ * 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.
+ */
+eventOrExpr) {
+  function emit(args, params) {
+    {
+      throw new Error(`This isn't supposed to be called`);
+    }
+  }
+  emit.type = 'xstate.emit';
+  emit.event = eventOrExpr;
+  emit.resolve = resolveEmit;
+  emit.execute = executeEmit;
+  return emit;
+}
+
 /**
  *
  * @remarks
@@ -278,6 +348,9 @@ function executeSendTo(actorScope, params) {
  */
 function sendTo(to, eventOrExpr, options) {
   function sendTo(args, params) {
+    {
+      throw new Error(`This isn't supposed to be called`);
+    }
   }
   sendTo.type = 'xsnapshot.sendTo';
   sendTo.to = to;
@@ -306,12 +379,22 @@ function sendParent(event, options) {
  * @param options Options to pass into the send action creator.
  */
 function forwardTo(target, options) {
+  if ((!target || typeof target === 'function')) {
+    const originalTarget = target;
+    target = (...args) => {
+      const resolvedTarget = typeof originalTarget === 'function' ? originalTarget(...args) : originalTarget;
+      if (!resolvedTarget) {
+        throw new Error(`Attempted to forward event to undefined actor. This risks an infinite loop in the sender.`);
+      }
+      return resolvedTarget;
+    };
+  }
   return sendTo(target, ({
     event
   }) => event, options);
 }
 
-function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
+function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
   collect
 }) {
   const actions = [];
@@ -340,6 +423,9 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
   enqueue.stopChild = (...args) => {
     actions.push(guards_dist_xstateGuards.stopChild(...args));
   };
+  enqueue.emit = (...args) => {
+    actions.push(emit(...args));
+  };
   collect({
     context: args.context,
     event: args.event,
@@ -347,7 +433,7 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
     check: guard => guards_dist_xstateGuards.evaluateGuard(guard, snapshot.context, args.event, snapshot),
     self: actorScope.self,
     system: actorScope.system
-  });
+  }, actionParams);
   return [snapshot, undefined, actions];
 }
 /**
@@ -372,6 +458,9 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
  */
 function enqueueActions(collect) {
   function enqueueActions(args, params) {
+    {
+      throw new Error(`This isn't supposed to be called`);
+    }
   }
   enqueueActions.type = 'xstate.enqueueActions';
   enqueueActions.collect = collect;
@@ -416,6 +505,9 @@ function log(value = ({
   event
 }), label) {
   function log(args, params) {
+    {
+      throw new Error(`This isn't supposed to be called`);
+    }
   }
   log.type = 'xstate.log';
   log.value = value;
@@ -427,6 +519,7 @@ function log(value = ({
 
 exports.SpecialTargets = SpecialTargets;
 exports.assign = assign;
+exports.emit = emit;
 exports.enqueueActions = enqueueActions;
 exports.forwardTo = forwardTo;
 exports.log = log;

package/dist/{log-e73cded6.development.cjs.js → log-a312ebfc.cjs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-7132462e.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-182bb5c9.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)
@@ -124,9 +124,6 @@ function resolveAssign(actorScope, snapshot, actionArgs, actionParams, {
  */
 function assign(assignment) {
   function assign(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   assign.type = 'xstate.assign';
   assign.assignment = assignment;
@@ -134,6 +131,67 @@ function assign(assignment) {
   return assign;
 }
 
+function resolveEmit(_, snapshot, args, actionParams, {
+  event: eventOrExpr
+}) {
+  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args, actionParams) : eventOrExpr;
+  return [snapshot, {
+    event: resolvedEvent
+  }];
+}
+function executeEmit(actorScope, {
+  event
+}) {
+  actorScope.defer(() => actorScope.emit(event));
+}
+/**
+ * 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.
+ */
+eventOrExpr) {
+  function emit(args, params) {
+  }
+  emit.type = 'xstate.emit';
+  emit.event = eventOrExpr;
+  emit.resolve = resolveEmit;
+  emit.execute = executeEmit;
+  return emit;
+}
+
 /**
  *
  * @remarks
@@ -281,9 +339,6 @@ function executeSendTo(actorScope, params) {
  */
 function sendTo(to, eventOrExpr, options) {
   function sendTo(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   sendTo.type = 'xsnapshot.sendTo';
   sendTo.to = to;
@@ -312,22 +367,12 @@ function sendParent(event, options) {
  * @param options Options to pass into the send action creator.
  */
 function forwardTo(target, options) {
-  if ((!target || typeof target === 'function')) {
-    const originalTarget = target;
-    target = (...args) => {
-      const resolvedTarget = typeof originalTarget === 'function' ? originalTarget(...args) : originalTarget;
-      if (!resolvedTarget) {
-        throw new Error(`Attempted to forward event to undefined actor. This risks an infinite loop in the sender.`);
-      }
-      return resolvedTarget;
-    };
-  }
   return sendTo(target, ({
     event
   }) => event, options);
 }
 
-function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
+function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
   collect
 }) {
   const actions = [];
@@ -356,6 +401,9 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
   enqueue.stopChild = (...args) => {
     actions.push(guards_dist_xstateGuards.stopChild(...args));
   };
+  enqueue.emit = (...args) => {
+    actions.push(emit(...args));
+  };
   collect({
     context: args.context,
     event: args.event,
@@ -363,7 +411,7 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
     check: guard => guards_dist_xstateGuards.evaluateGuard(guard, snapshot.context, args.event, snapshot),
     self: actorScope.self,
     system: actorScope.system
-  });
+  }, actionParams);
   return [snapshot, undefined, actions];
 }
 /**
@@ -388,9 +436,6 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
  */
 function enqueueActions(collect) {
   function enqueueActions(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   enqueueActions.type = 'xstate.enqueueActions';
   enqueueActions.collect = collect;
@@ -435,9 +480,6 @@ function log(value = ({
   event
 }), label) {
   function log(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   log.type = 'xstate.log';
   log.value = value;
@@ -449,6 +491,7 @@ function log(value = ({
 
 exports.SpecialTargets = SpecialTargets;
 exports.assign = assign;
+exports.emit = emit;
 exports.enqueueActions = enqueueActions;
 exports.forwardTo = forwardTo;
 exports.log = log;

package/dist/{log-abca6761.development.esm.js → log-c48e8ab0.esm.js}

@@ -1,4 +1,4 @@
-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-3f85f1d9.development.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-411df926.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)
@@ -122,9 +122,6 @@ function resolveAssign(actorScope, snapshot, actionArgs, actionParams, {
  */
 function assign(assignment) {
   function assign(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   assign.type = 'xstate.assign';
   assign.assignment = assignment;
@@ -132,6 +129,67 @@ function assign(assignment) {
   return assign;
 }
 
+function resolveEmit(_, snapshot, args, actionParams, {
+  event: eventOrExpr
+}) {
+  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args, actionParams) : eventOrExpr;
+  return [snapshot, {
+    event: resolvedEvent
+  }];
+}
+function executeEmit(actorScope, {
+  event
+}) {
+  actorScope.defer(() => actorScope.emit(event));
+}
+/**
+ * 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.
+ */
+eventOrExpr) {
+  function emit(args, params) {
+  }
+  emit.type = 'xstate.emit';
+  emit.event = eventOrExpr;
+  emit.resolve = resolveEmit;
+  emit.execute = executeEmit;
+  return emit;
+}
+
 /**
  *
  * @remarks
@@ -279,9 +337,6 @@ function executeSendTo(actorScope, params) {
  */
 function sendTo(to, eventOrExpr, options) {
   function sendTo(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   sendTo.type = 'xsnapshot.sendTo';
   sendTo.to = to;
@@ -310,22 +365,12 @@ function sendParent(event, options) {
  * @param options Options to pass into the send action creator.
  */
 function forwardTo(target, options) {
-  if ((!target || typeof target === 'function')) {
-    const originalTarget = target;
-    target = (...args) => {
-      const resolvedTarget = typeof originalTarget === 'function' ? originalTarget(...args) : originalTarget;
-      if (!resolvedTarget) {
-        throw new Error(`Attempted to forward event to undefined actor. This risks an infinite loop in the sender.`);
-      }
-      return resolvedTarget;
-    };
-  }
   return sendTo(target, ({
     event
   }) => event, options);
 }
 
-function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
+function resolveEnqueueActions(actorScope, snapshot, args, actionParams, {
   collect
 }) {
   const actions = [];
@@ -354,6 +399,9 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
   enqueue.stopChild = (...args) => {
     actions.push(stopChild(...args));
   };
+  enqueue.emit = (...args) => {
+    actions.push(emit(...args));
+  };
   collect({
     context: args.context,
     event: args.event,
@@ -361,7 +409,7 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
     check: guard => evaluateGuard(guard, snapshot.context, args.event, snapshot),
     self: actorScope.self,
     system: actorScope.system
-  });
+  }, actionParams);
   return [snapshot, undefined, actions];
 }
 /**
@@ -386,9 +434,6 @@ function resolveEnqueueActions(actorScope, snapshot, args, _actionParams, {
  */
 function enqueueActions(collect) {
   function enqueueActions(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   enqueueActions.type = 'xstate.enqueueActions';
   enqueueActions.collect = collect;
@@ -433,9 +478,6 @@ function log(value = ({
   event
 }), label) {
   function log(args, params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
   }
   log.type = 'xstate.log';
   log.value = value;
@@ -445,4 +487,4 @@ function log(value = ({
   return log;
 }
 
-export { SpecialTargets as S, assign as a, sendTo as b, enqueueActions as e, forwardTo as f, log as l, sendParent as s };
+export { SpecialTargets as S, assign as a, enqueueActions as b, sendTo as c, emit as e, forwardTo as f, log as l, sendParent as s };

package/dist/{raise-af6a698b.cjs.js → raise-182bb5c9.cjs.js}

@@ -453,6 +453,7 @@ class Actor {
     this.id = void 0;
     this.mailbox = new Mailbox(this._process.bind(this));
     this.observers = new Set();
+    this.eventListeners = new Map();
     this.logger = void 0;
     /** @internal */
     this._processingStatus = ProcessingStatus.NotStarted;
@@ -519,6 +520,15 @@ class Actor {
           throw new Error(`Cannot stop child actor ${child.id} of ${this.id} because it is not a child`);
         }
         child._stop();
+      },
+      emit: emittedEvent => {
+        const listeners = this.eventListeners.get(emittedEvent.type);
+        if (!listeners) {
+          return;
+        }
+        for (const handler of Array.from(listeners)) {
+          handler(emittedEvent);
+        }
       }
     };
 
@@ -702,6 +712,20 @@ class Actor {
       }
     };
   }
+  on(type, handler) {
+    let listeners = this.eventListeners.get(type);
+    if (!listeners) {
+      listeners = new Set();
+      this.eventListeners.set(type, listeners);
+    }
+    const wrappedHandler = handler.bind(undefined);
+    listeners.add(wrappedHandler);
+    return {
+      unsubscribe: () => {
+        listeners.delete(wrappedHandler);
+      }
+    };
+  }
 
   /**
    * Starts the Actor from the initial state

package/dist/{raise-a7ab421f.esm.js → raise-411df926.esm.js}

@@ -451,6 +451,7 @@ class Actor {
     this.id = void 0;
     this.mailbox = new Mailbox(this._process.bind(this));
     this.observers = new Set();
+    this.eventListeners = new Map();
     this.logger = void 0;
     /** @internal */
     this._processingStatus = ProcessingStatus.NotStarted;
@@ -517,6 +518,15 @@ class Actor {
           throw new Error(`Cannot stop child actor ${child.id} of ${this.id} because it is not a child`);
         }
         child._stop();
+      },
+      emit: emittedEvent => {
+        const listeners = this.eventListeners.get(emittedEvent.type);
+        if (!listeners) {
+          return;
+        }
+        for (const handler of Array.from(listeners)) {
+          handler(emittedEvent);
+        }
       }
     };
 
@@ -700,6 +710,20 @@ class Actor {
       }
     };
   }
+  on(type, handler) {
+    let listeners = this.eventListeners.get(type);
+    if (!listeners) {
+      listeners = new Set();
+      this.eventListeners.set(type, listeners);
+    }
+    const wrappedHandler = handler.bind(undefined);
+    listeners.add(wrappedHandler);
+    return {
+      unsubscribe: () => {
+        listeners.delete(wrappedHandler);
+      }
+    };
+  }
 
   /**
    * Starts the Actor from the initial state

package/dist/{raise-3f85f1d9.development.esm.js → raise-80cc66b2.development.esm.js}

@@ -454,6 +454,7 @@ class Actor {
     this.id = void 0;
     this.mailbox = new Mailbox(this._process.bind(this));
     this.observers = new Set();
+    this.eventListeners = new Map();
     this.logger = void 0;
     /** @internal */
     this._processingStatus = ProcessingStatus.NotStarted;
@@ -520,6 +521,15 @@ class Actor {
           throw new Error(`Cannot stop child actor ${child.id} of ${this.id} because it is not a child`);
         }
         child._stop();
+      },
+      emit: emittedEvent => {
+        const listeners = this.eventListeners.get(emittedEvent.type);
+        if (!listeners) {
+          return;
+        }
+        for (const handler of Array.from(listeners)) {
+          handler(emittedEvent);
+        }
       }
     };
 
@@ -703,6 +713,20 @@ class Actor {
       }
     };
   }
+  on(type, handler) {
+    let listeners = this.eventListeners.get(type);
+    if (!listeners) {
+      listeners = new Set();
+      this.eventListeners.set(type, listeners);
+    }
+    const wrappedHandler = handler.bind(undefined);
+    listeners.add(wrappedHandler);
+    return {
+      unsubscribe: () => {
+        listeners.delete(wrappedHandler);
+      }
+    };
+  }
 
   /**
    * Starts the Actor from the initial state

package/dist/{raise-7132462e.development.cjs.js → raise-933cd731.development.cjs.js}

@@ -456,6 +456,7 @@ class Actor {
     this.id = void 0;
     this.mailbox = new Mailbox(this._process.bind(this));
     this.observers = new Set();
+    this.eventListeners = new Map();
     this.logger = void 0;
     /** @internal */
     this._processingStatus = ProcessingStatus.NotStarted;
@@ -522,6 +523,15 @@ class Actor {
           throw new Error(`Cannot stop child actor ${child.id} of ${this.id} because it is not a child`);
         }
         child._stop();
+      },
+      emit: emittedEvent => {
+        const listeners = this.eventListeners.get(emittedEvent.type);
+        if (!listeners) {
+          return;
+        }
+        for (const handler of Array.from(listeners)) {
+          handler(emittedEvent);
+        }
       }
     };
 
@@ -705,6 +715,20 @@ class Actor {
       }
     };
   }
+  on(type, handler) {
+    let listeners = this.eventListeners.get(type);
+    if (!listeners) {
+      listeners = new Set();
+      this.eventListeners.set(type, listeners);
+    }
+    const wrappedHandler = handler.bind(undefined);
+    listeners.add(wrappedHandler);
+    return {
+      unsubscribe: () => {
+        listeners.delete(wrappedHandler);
+      }
+    };
+  }
 
   /**
    * Starts the Actor from the initial state

package/dist/xstate.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.cjs.js');
-var guards_dist_xstateGuards = require('./raise-af6a698b.cjs.js');
-var log = require('./log-12b88b7e.cjs.js');
+var guards_dist_xstateGuards = require('./raise-182bb5c9.cjs.js');
+var log = require('./log-a312ebfc.cjs.js');
 require('../dev/dist/xstate-dev.cjs.js');
 
 class SimulatedClock {
@@ -756,7 +756,8 @@ function createInertActorScope(actorLogic) {
     logger: () => {},
     sessionId: '',
     stopChild: () => {},
-    system: self.system
+    system: self.system,
+    emit: () => {}
   };
   return inertActorScope;
 }
@@ -911,6 +912,7 @@ exports.stopChild = guards_dist_xstateGuards.stopChild;
 exports.toObserver = guards_dist_xstateGuards.toObserver;
 exports.SpecialTargets = log.SpecialTargets;
 exports.assign = log.assign;
+exports.emit = log.emit;
 exports.enqueueActions = log.enqueueActions;
 exports.forwardTo = log.forwardTo;
 exports.log = log.log;

package/dist/xstate.cjs.mjs

@@ -12,6 +12,7 @@ export {
   createActor,
   createEmptyActor,
   createMachine,
+  emit,
   enqueueActions,
   forwardTo,
   fromCallback,