xstate 5.0.0-beta.36 → 5.0.0-beta.38

package/dist/{send-778692de.cjs.js → send-34160163.cjs.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-c51b81a3.cjs.js');
-var interpreter = require('./interpreter-69605bf0.cjs.js');
+var guards_dist_xstateGuards = require('./raise-7faa9b3b.cjs.js');
+var interpreter = require('./interpreter-b6f22ee2.cjs.js');
 
 function createSpawner(actorContext, {
   machine,
@@ -12,7 +12,7 @@ function createSpawner(actorContext, {
       systemId
     } = options;
     if (typeof src === 'string') {
-      const referenced = interpreter.resolveReferencedActor(machine.implementations.actors[src]);
+      const referenced = interpreter.resolveReferencedActor(machine, src);
       if (!referenced) {
         throw new Error(`Actor logic '${src}' not implemented in machine '${machine.id}'`);
       }
@@ -41,9 +41,7 @@ function createSpawner(actorContext, {
               });
             }
           },
-          error: () => {
-            /* TODO */
-          }
+          error: () => {}
         });
       }
       return actorRef;
@@ -67,9 +65,7 @@ function createSpawner(actorContext, {
               });
             }
           },
-          error: () => {
-            /* TODO */
-          }
+          error: () => {}
         });
       }
       return actorRef;
@@ -93,7 +89,7 @@ function createSpawner(actorContext, {
   };
 }
 
-function resolveAssign(actorContext, state, actionArgs, {
+function resolveAssign(actorContext, state, actionArgs, actionParams, {
   assignment
 }) {
   if (!state.context) {
@@ -103,18 +99,17 @@ function resolveAssign(actorContext, state, actionArgs, {
   const assignArgs = {
     context: state.context,
     event: actionArgs.event,
-    action: actionArgs.action,
     spawn: createSpawner(actorContext, state, actionArgs.event, spawnedChildren),
     self: actorContext?.self,
     system: actorContext?.system
   };
   let partialUpdate = {};
   if (typeof assignment === 'function') {
-    partialUpdate = assignment(assignArgs);
+    partialUpdate = assignment(assignArgs, actionParams);
   } else {
     for (const key of Object.keys(assignment)) {
       const propAssignment = assignment[key];
-      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs) : propAssignment;
+      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs, actionParams) : propAssignment;
     }
   }
   const updatedContext = Object.assign({}, state.context, partialUpdate);
@@ -132,7 +127,7 @@ function resolveAssign(actorContext, state, actionArgs, {
  * @param assignment An object that represents the partial context to update.
  */
 function assign(assignment) {
-  function assign(_) {
+  function assign(args, params) {
   }
   assign.type = 'xstate.assign';
   assign.assignment = assignment;
@@ -140,7 +135,7 @@ function assign(assignment) {
   return assign;
 }
 
-function resolveChoose(_, state, actionArgs, {
+function resolveChoose(_, state, actionArgs, _actionParams, {
   branches
 }) {
   const matchedActions = branches.find(condition => {
@@ -149,7 +144,7 @@ function resolveChoose(_, state, actionArgs, {
   return [state, undefined, interpreter.toArray(matchedActions)];
 }
 function choose(branches) {
-  function choose(_) {
+  function choose(args, params) {
   }
   choose.type = 'xstate.choose';
   choose.branches = branches;
@@ -157,12 +152,12 @@ function choose(branches) {
   return choose;
 }
 
-function resolveLog(_, state, actionArgs, {
+function resolveLog(_, state, actionArgs, actionParams, {
   value,
   label
 }) {
   return [state, {
-    value: typeof value === 'function' ? value(actionArgs) : value,
+    value: typeof value === 'function' ? value(actionArgs, actionParams) : value,
     label
   }];
 }
@@ -193,7 +188,7 @@ function log(value = ({
   context,
   event
 }), label) {
-  function log(_) {
+  function log(args, params) {
   }
   log.type = 'xstate.log';
   log.value = value;
@@ -203,7 +198,7 @@ function log(value = ({
   return log;
 }
 
-function resolvePure(_, state, args, {
+function resolvePure(_, state, args, _actionParams, {
   get
 }) {
   return [state, undefined, interpreter.toArray(get({
@@ -212,7 +207,7 @@ function resolvePure(_, state, args, {
   }))];
 }
 function pure(getActions) {
-  function pure(_) {
+  function pure(args, params) {
   }
   pure.type = 'xstate.pure';
   pure.get = getActions;
@@ -221,6 +216,9 @@ function pure(getActions) {
 }
 
 /**
+ *
+ * @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:
  *
@@ -241,7 +239,10 @@ function pure(getActions) {
 /**
  * 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" }`.
  */
 
@@ -255,7 +256,7 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
-function resolveSendTo(actorContext, state, args, {
+function resolveSendTo(actorContext, state, args, actionParams, {
   to,
   event: eventOrExpr,
   id,
@@ -265,15 +266,15 @@ function resolveSendTo(actorContext, state, args, {
   if (typeof eventOrExpr === 'string') {
     throw new Error(`Only event objects may be used with sendTo; use sendTo({ type: "${eventOrExpr}" }) instead`);
   }
-  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args) : eventOrExpr;
+  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args, actionParams) : eventOrExpr;
   let resolvedDelay;
   if (typeof delay === 'string') {
     const configDelay = delaysMap && delaysMap[delay];
-    resolvedDelay = typeof configDelay === 'function' ? configDelay(args) : configDelay;
+    resolvedDelay = typeof configDelay === 'function' ? configDelay(args, actionParams) : configDelay;
   } else {
-    resolvedDelay = typeof delay === 'function' ? delay(args) : delay;
+    resolvedDelay = typeof delay === 'function' ? delay(args, actionParams) : delay;
   }
-  const resolvedTarget = typeof to === 'function' ? to(args) : to;
+  const resolvedTarget = typeof to === 'function' ? to(args, actionParams) : to;
   let targetActorRef;
   if (typeof resolvedTarget === 'string') {
     if (resolvedTarget === SpecialTargets.Parent) {
@@ -310,6 +311,9 @@ function executeSendTo(actorContext, params) {
     actorContext.self.delaySend(params);
     return;
   }
+
+  // this forms an outgoing events queue
+  // thanks to that the recipient actors are able to read the *updated* snapshot value of the sender
   actorContext.defer(() => {
     const {
       to,
@@ -328,7 +332,7 @@ function executeSendTo(actorContext, params) {
  *  - `delay` - The number of milliseconds to delay the sending of the event.
  */
 function sendTo(to, eventOrExpr, options) {
-  function sendTo(_) {
+  function sendTo(args, params) {
   }
   sendTo.type = 'xstate.sendTo';
   sendTo.to = to;

package/dist/{send-0a7aa74e.esm.js → send-4b616da9.esm.js}

@@ -1,5 +1,5 @@
-import { j as cloneState, e as evaluateGuard } from './raise-ffe1014a.esm.js';
-import { f as ActorStatus, j as createErrorActorEvent, r as resolveReferencedActor, d as createActor, t as toArray, x as XSTATE_ERROR } from './interpreter-de5217bc.esm.js';
+import { j as cloneState, e as evaluateGuard } from './raise-c989c7fb.esm.js';
+import { f as ActorStatus, j as createErrorActorEvent, r as resolveReferencedActor, d as createActor, t as toArray, x as XSTATE_ERROR } from './interpreter-c80ce92e.esm.js';
 
 function createSpawner(actorContext, {
   machine,
@@ -10,7 +10,7 @@ function createSpawner(actorContext, {
       systemId
     } = options;
     if (typeof src === 'string') {
-      const referenced = resolveReferencedActor(machine.implementations.actors[src]);
+      const referenced = resolveReferencedActor(machine, src);
       if (!referenced) {
         throw new Error(`Actor logic '${src}' not implemented in machine '${machine.id}'`);
       }
@@ -39,9 +39,7 @@ function createSpawner(actorContext, {
               });
             }
           },
-          error: () => {
-            /* TODO */
-          }
+          error: () => {}
         });
       }
       return actorRef;
@@ -65,9 +63,7 @@ function createSpawner(actorContext, {
               });
             }
           },
-          error: () => {
-            /* TODO */
-          }
+          error: () => {}
         });
       }
       return actorRef;
@@ -91,7 +87,7 @@ function createSpawner(actorContext, {
   };
 }
 
-function resolveAssign(actorContext, state, actionArgs, {
+function resolveAssign(actorContext, state, actionArgs, actionParams, {
   assignment
 }) {
   if (!state.context) {
@@ -101,18 +97,17 @@ function resolveAssign(actorContext, state, actionArgs, {
   const assignArgs = {
     context: state.context,
     event: actionArgs.event,
-    action: actionArgs.action,
     spawn: createSpawner(actorContext, state, actionArgs.event, spawnedChildren),
     self: actorContext?.self,
     system: actorContext?.system
   };
   let partialUpdate = {};
   if (typeof assignment === 'function') {
-    partialUpdate = assignment(assignArgs);
+    partialUpdate = assignment(assignArgs, actionParams);
   } else {
     for (const key of Object.keys(assignment)) {
       const propAssignment = assignment[key];
-      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs) : propAssignment;
+      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs, actionParams) : propAssignment;
     }
   }
   const updatedContext = Object.assign({}, state.context, partialUpdate);
@@ -130,7 +125,7 @@ function resolveAssign(actorContext, state, actionArgs, {
  * @param assignment An object that represents the partial context to update.
  */
 function assign(assignment) {
-  function assign(_) {
+  function assign(args, params) {
   }
   assign.type = 'xstate.assign';
   assign.assignment = assignment;
@@ -138,7 +133,7 @@ function assign(assignment) {
   return assign;
 }
 
-function resolveChoose(_, state, actionArgs, {
+function resolveChoose(_, state, actionArgs, _actionParams, {
   branches
 }) {
   const matchedActions = branches.find(condition => {
@@ -147,7 +142,7 @@ function resolveChoose(_, state, actionArgs, {
   return [state, undefined, toArray(matchedActions)];
 }
 function choose(branches) {
-  function choose(_) {
+  function choose(args, params) {
   }
   choose.type = 'xstate.choose';
   choose.branches = branches;
@@ -155,12 +150,12 @@ function choose(branches) {
   return choose;
 }
 
-function resolveLog(_, state, actionArgs, {
+function resolveLog(_, state, actionArgs, actionParams, {
   value,
   label
 }) {
   return [state, {
-    value: typeof value === 'function' ? value(actionArgs) : value,
+    value: typeof value === 'function' ? value(actionArgs, actionParams) : value,
     label
   }];
 }
@@ -191,7 +186,7 @@ function log(value = ({
   context,
   event
 }), label) {
-  function log(_) {
+  function log(args, params) {
   }
   log.type = 'xstate.log';
   log.value = value;
@@ -201,7 +196,7 @@ function log(value = ({
   return log;
 }
 
-function resolvePure(_, state, args, {
+function resolvePure(_, state, args, _actionParams, {
   get
 }) {
   return [state, undefined, toArray(get({
@@ -210,7 +205,7 @@ function resolvePure(_, state, args, {
   }))];
 }
 function pure(getActions) {
-  function pure(_) {
+  function pure(args, params) {
   }
   pure.type = 'xstate.pure';
   pure.get = getActions;
@@ -219,6 +214,9 @@ function pure(getActions) {
 }
 
 /**
+ *
+ * @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:
  *
@@ -239,7 +237,10 @@ function pure(getActions) {
 /**
  * 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" }`.
  */
 
@@ -253,7 +254,7 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
-function resolveSendTo(actorContext, state, args, {
+function resolveSendTo(actorContext, state, args, actionParams, {
   to,
   event: eventOrExpr,
   id,
@@ -263,15 +264,15 @@ function resolveSendTo(actorContext, state, args, {
   if (typeof eventOrExpr === 'string') {
     throw new Error(`Only event objects may be used with sendTo; use sendTo({ type: "${eventOrExpr}" }) instead`);
   }
-  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args) : eventOrExpr;
+  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args, actionParams) : eventOrExpr;
   let resolvedDelay;
   if (typeof delay === 'string') {
     const configDelay = delaysMap && delaysMap[delay];
-    resolvedDelay = typeof configDelay === 'function' ? configDelay(args) : configDelay;
+    resolvedDelay = typeof configDelay === 'function' ? configDelay(args, actionParams) : configDelay;
   } else {
-    resolvedDelay = typeof delay === 'function' ? delay(args) : delay;
+    resolvedDelay = typeof delay === 'function' ? delay(args, actionParams) : delay;
   }
-  const resolvedTarget = typeof to === 'function' ? to(args) : to;
+  const resolvedTarget = typeof to === 'function' ? to(args, actionParams) : to;
   let targetActorRef;
   if (typeof resolvedTarget === 'string') {
     if (resolvedTarget === SpecialTargets.Parent) {
@@ -308,6 +309,9 @@ function executeSendTo(actorContext, params) {
     actorContext.self.delaySend(params);
     return;
   }
+
+  // this forms an outgoing events queue
+  // thanks to that the recipient actors are able to read the *updated* snapshot value of the sender
   actorContext.defer(() => {
     const {
       to,
@@ -326,7 +330,7 @@ function executeSendTo(actorContext, params) {
  *  - `delay` - The number of milliseconds to delay the sending of the event.
  */
 function sendTo(to, eventOrExpr, options) {
-  function sendTo(_) {
+  function sendTo(args, params) {
   }
   sendTo.type = 'xstate.sendTo';
   sendTo.to = to;

package/dist/{send-25e70bd4.development.cjs.js → send-58725522.development.cjs.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var guards_dist_xstateGuards = require('./raise-106ea558.development.cjs.js');
-var interpreter = require('./interpreter-d3567419.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-b69a3d16.development.cjs.js');
+var interpreter = require('./interpreter-ed3f81f7.development.cjs.js');
 
 function createSpawner(actorContext, {
   machine,
@@ -12,7 +12,7 @@ function createSpawner(actorContext, {
       systemId
     } = options;
     if (typeof src === 'string') {
-      const referenced = interpreter.resolveReferencedActor(machine.implementations.actors[src]);
+      const referenced = interpreter.resolveReferencedActor(machine, src);
       if (!referenced) {
         throw new Error(`Actor logic '${src}' not implemented in machine '${machine.id}'`);
       }
@@ -41,9 +41,7 @@ function createSpawner(actorContext, {
               });
             }
           },
-          error: () => {
-            /* TODO */
-          }
+          error: () => {}
         });
       }
       return actorRef;
@@ -67,9 +65,7 @@ function createSpawner(actorContext, {
               });
             }
           },
-          error: () => {
-            /* TODO */
-          }
+          error: () => {}
         });
       }
       return actorRef;
@@ -93,7 +89,7 @@ function createSpawner(actorContext, {
   };
 }
 
-function resolveAssign(actorContext, state, actionArgs, {
+function resolveAssign(actorContext, state, actionArgs, actionParams, {
   assignment
 }) {
   if (!state.context) {
@@ -103,18 +99,17 @@ function resolveAssign(actorContext, state, actionArgs, {
   const assignArgs = {
     context: state.context,
     event: actionArgs.event,
-    action: actionArgs.action,
     spawn: createSpawner(actorContext, state, actionArgs.event, spawnedChildren),
     self: actorContext?.self,
     system: actorContext?.system
   };
   let partialUpdate = {};
   if (typeof assignment === 'function') {
-    partialUpdate = assignment(assignArgs);
+    partialUpdate = assignment(assignArgs, actionParams);
   } else {
     for (const key of Object.keys(assignment)) {
       const propAssignment = assignment[key];
-      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs) : propAssignment;
+      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs, actionParams) : propAssignment;
     }
   }
   const updatedContext = Object.assign({}, state.context, partialUpdate);
@@ -132,7 +127,7 @@ function resolveAssign(actorContext, state, actionArgs, {
  * @param assignment An object that represents the partial context to update.
  */
 function assign(assignment) {
-  function assign(_) {
+  function assign(args, params) {
     {
       throw new Error(`This isn't supposed to be called`);
     }
@@ -143,7 +138,7 @@ function assign(assignment) {
   return assign;
 }
 
-function resolveChoose(_, state, actionArgs, {
+function resolveChoose(_, state, actionArgs, _actionParams, {
   branches
 }) {
   const matchedActions = branches.find(condition => {
@@ -152,7 +147,7 @@ function resolveChoose(_, state, actionArgs, {
   return [state, undefined, interpreter.toArray(matchedActions)];
 }
 function choose(branches) {
-  function choose(_) {
+  function choose(args, params) {
     {
       throw new Error(`This isn't supposed to be called`);
     }
@@ -163,12 +158,12 @@ function choose(branches) {
   return choose;
 }
 
-function resolveLog(_, state, actionArgs, {
+function resolveLog(_, state, actionArgs, actionParams, {
   value,
   label
 }) {
   return [state, {
-    value: typeof value === 'function' ? value(actionArgs) : value,
+    value: typeof value === 'function' ? value(actionArgs, actionParams) : value,
     label
   }];
 }
@@ -199,7 +194,7 @@ function log(value = ({
   context,
   event
 }), label) {
-  function log(_) {
+  function log(args, params) {
     {
       throw new Error(`This isn't supposed to be called`);
     }
@@ -212,7 +207,7 @@ function log(value = ({
   return log;
 }
 
-function resolvePure(_, state, args, {
+function resolvePure(_, state, args, _actionParams, {
   get
 }) {
   return [state, undefined, interpreter.toArray(get({
@@ -221,7 +216,7 @@ function resolvePure(_, state, args, {
   }))];
 }
 function pure(getActions) {
-  function pure(_) {
+  function pure(args, params) {
     {
       throw new Error(`This isn't supposed to be called`);
     }
@@ -233,6 +228,9 @@ function pure(getActions) {
 }
 
 /**
+ *
+ * @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:
  *
@@ -253,7 +251,10 @@ function pure(getActions) {
 /**
  * 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" }`.
  */
 
@@ -267,7 +268,7 @@ let SpecialTargets = /*#__PURE__*/function (SpecialTargets) {
   return SpecialTargets;
 }({});
 
-function resolveSendTo(actorContext, state, args, {
+function resolveSendTo(actorContext, state, args, actionParams, {
   to,
   event: eventOrExpr,
   id,
@@ -277,15 +278,15 @@ function resolveSendTo(actorContext, state, args, {
   if (typeof eventOrExpr === 'string') {
     throw new Error(`Only event objects may be used with sendTo; use sendTo({ type: "${eventOrExpr}" }) instead`);
   }
-  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args) : eventOrExpr;
+  const resolvedEvent = typeof eventOrExpr === 'function' ? eventOrExpr(args, actionParams) : eventOrExpr;
   let resolvedDelay;
   if (typeof delay === 'string') {
     const configDelay = delaysMap && delaysMap[delay];
-    resolvedDelay = typeof configDelay === 'function' ? configDelay(args) : configDelay;
+    resolvedDelay = typeof configDelay === 'function' ? configDelay(args, actionParams) : configDelay;
   } else {
-    resolvedDelay = typeof delay === 'function' ? delay(args) : delay;
+    resolvedDelay = typeof delay === 'function' ? delay(args, actionParams) : delay;
   }
-  const resolvedTarget = typeof to === 'function' ? to(args) : to;
+  const resolvedTarget = typeof to === 'function' ? to(args, actionParams) : to;
   let targetActorRef;
   if (typeof resolvedTarget === 'string') {
     if (resolvedTarget === SpecialTargets.Parent) {
@@ -322,6 +323,9 @@ function executeSendTo(actorContext, params) {
     actorContext.self.delaySend(params);
     return;
   }
+
+  // this forms an outgoing events queue
+  // thanks to that the recipient actors are able to read the *updated* snapshot value of the sender
   actorContext.defer(() => {
     const {
       to,
@@ -340,7 +344,7 @@ function executeSendTo(actorContext, params) {
  *  - `delay` - The number of milliseconds to delay the sending of the event.
  */
 function sendTo(to, eventOrExpr, options) {
-  function sendTo(_) {
+  function sendTo(args, params) {
     {
       throw new Error(`This isn't supposed to be called`);
     }