xstate 5.0.0-beta.40 → 5.0.0-beta.42

package/dist/{raise-37f9f3b8.development.esm.js → raise-51ae36e5.development.esm.js}

@@ -1,4 +1,4 @@
-import { r as resolveReferencedActor, d as createActor, f as ActorStatus, j as createErrorActorEvent, k as toStateValue, l as STATE_IDENTIFIER, n as normalizeTarget, t as toArray, N as NULL_EVENT, a as toTransitionConfigArray, S as STATE_DELIMITER, o as toStatePath, q as createDoneStateEvent, s as resolveOutput, W as WILDCARD, X as XSTATE_STOP, u as XSTATE_INIT, v as createAfterEvent, w as flatten, e as matchesState, $ as $$ACTOR_TYPE } from './interpreter-410d7ca9.development.esm.js';
+import { r as resolveReferencedActor, d as createActor, P as ProcessingStatus, h as createErrorActorEvent, j as STATE_IDENTIFIER, n as normalizeTarget, t as toArray, N as NULL_EVENT, a as toTransitionConfigArray, S as STATE_DELIMITER, k as toStatePath, l as createDoneStateEvent, o as resolveOutput, W as WILDCARD, X as XSTATE_STOP, q as XSTATE_INIT, s as createAfterEvent, u as flatten, f as matchesState, $ as $$ACTOR_TYPE } from './interpreter-f2620ea7.development.esm.js';
 
 const cache = new WeakMap();
 function memo(object, key, fn) {
@@ -61,7 +61,7 @@ function resolveSpawn(actorScope, state, actionArgs, _actionParams, {
     const configuredInput = input || referenced.input;
     actorRef = createActor(referenced.src, {
       id: resolvedId,
-      src: typeof src === 'string' ? src : undefined,
+      src,
       parent: actorScope?.self,
       systemId,
       input: typeof configuredInput === 'function' ? configuredInput({
@@ -87,7 +87,7 @@ function resolveSpawn(actorScope, state, actionArgs, _actionParams, {
   if (!actorRef) {
     console.warn(`Actor type '${src}' not found in machine '${actorScope.id}'.`);
   }
-  return [cloneState(state, {
+  return [cloneMachineSnapshot(state, {
     children: {
       ...state.children,
       [resolvedId]: actorRef
@@ -105,7 +105,7 @@ function executeSpawn(actorScope, {
     return;
   }
   actorScope.defer(() => {
-    if (actorRef.status === ActorStatus.Stopped) {
+    if (actorRef._processingStatus === ProcessingStatus.Stopped) {
       return;
     }
     try {
@@ -150,7 +150,7 @@ function resolveStop(_, state, args, actionParams, {
     };
     delete children[resolvedActorRef.id];
   }
-  return [cloneState(state, {
+  return [cloneMachineSnapshot(state, {
     children
   }), resolvedActorRef];
 }
@@ -166,7 +166,7 @@ function executeStop(actorScope, actorRef) {
 
   // this allows us to prevent an actor from being started if it gets stopped within the same macrostep
   // this can happen, for example, when the invoking state is being exited immediately by an always transition
-  if (actorRef.status !== ActorStatus.Running) {
+  if (actorRef._processingStatus !== ProcessingStatus.Running) {
     actorScope.stopChild(actorRef);
     return;
   }
@@ -683,10 +683,9 @@ function getStateNodeByPath(stateNode, statePath) {
 /**
  * Returns the state nodes represented by the current state value.
  *
- * @param state The state value or State instance
+ * @param stateValue The state value or State instance
  */
-function getStateNodes(stateNode, state) {
-  const stateValue = state instanceof State ? state.value : toStateValue(state);
+function getStateNodes(stateNode, stateValue) {
   if (typeof stateValue === 'string') {
     return [stateNode, stateNode.states[stateValue]];
   }
@@ -907,7 +906,7 @@ function microstep(transitions, currentState, actorScope, event, isInitial, inte
     if (historyValue === currentState.historyValue && areConfigurationsEqual(currentState.configuration, mutConfiguration)) {
       return nextState;
     }
-    return cloneState(nextState, {
+    return cloneMachineSnapshot(nextState, {
       configuration: nextConfiguration,
       historyValue
     });
@@ -971,9 +970,9 @@ function enterStates(currentState, event, actorScope, filteredTransitions, mutCo
       if (ancestorMarker) {
         continue;
       }
-      nextState = cloneState(nextState, {
+      nextState = cloneMachineSnapshot(nextState, {
         status: 'done',
-        output: getMachineOutput(nextState, event, actorScope, currentState.configuration[0].machine.root, rootCompletionNode)
+        output: getMachineOutput(nextState, event, actorScope, nextState.machine.root, rootCompletionNode)
       });
     }
   }
@@ -1127,7 +1126,7 @@ function resolveActionsAndContextWorker(currentState, event, actorScope, actions
       event
     }) : action.params : undefined;
     if (!('resolve' in resolvedAction)) {
-      if (actorScope?.self.status === ActorStatus.Running) {
+      if (actorScope?.self._processingStatus === ProcessingStatus.Running) {
         resolvedAction(actionArgs, actionParams);
       } else {
         actorScope?.defer(() => {
@@ -1145,7 +1144,7 @@ function resolveActionsAndContextWorker(currentState, event, actorScope, actions
       retries?.push([builtinAction, params]);
     }
     if ('execute' in builtinAction) {
-      if (actorScope?.self.status === ActorStatus.Running) {
+      if (actorScope?.self._processingStatus === ProcessingStatus.Running) {
         builtinAction.execute(actorScope, params);
       } else {
         actorScope?.defer(builtinAction.execute.bind(null, actorScope, params));
@@ -1177,7 +1176,7 @@ function macrostep(state, event, actorScope, internalQueue = []) {
 
   // Handle stop event
   if (event.type === XSTATE_STOP) {
-    nextState = cloneState(stopChildren(nextState, event, actorScope), {
+    nextState = cloneMachineSnapshot(stopChildren(nextState, event, actorScope), {
       status: 'stopped'
     });
     states.push(nextState);
@@ -1255,194 +1254,96 @@ function resolveStateValue(rootNode, stateValue) {
   const configuration = getConfiguration(getStateNodes(rootNode, stateValue));
   return getStateValue(rootNode, [...configuration]);
 }
-function getInitialConfiguration(rootNode) {
-  const configuration = [];
-  const initialTransition = rootNode.initial;
-  const statesToEnter = new Set();
-  const statesForDefaultEntry = new Set([rootNode]);
-  computeEntrySet([initialTransition], {}, statesForDefaultEntry, statesToEnter);
-  for (const stateNodeToEnter of [...statesToEnter].sort((a, b) => a.order - b.order)) {
-    configuration.push(stateNodeToEnter);
-  }
-  return configuration;
-}
-
-class State {
-  /**
-   * Indicates whether the state is a final state.
-   */
-
-  /**
-   * The output data of the top-level finite state.
-   */
-
-  /**
-   * The enabled state nodes representative of the state value.
-   */
-
-  /**
-   * An object mapping actor names to spawned/invoked actors.
-   */
-
-  /**
-   * Creates a new State instance for the given `stateValue` and `context`.
-   * @param stateValue
-   * @param context
-   */
-  static from(stateValue, context = {}, machine) {
-    if (stateValue instanceof State) {
-      if (stateValue.context !== context) {
-        return new State({
-          value: stateValue.value,
-          context,
-          meta: {},
-          configuration: [],
-          // TODO: fix,
-          children: {},
-          status: 'active'
-        }, machine);
-      }
-      return stateValue;
-    }
-    const configuration = getConfiguration(getStateNodes(machine.root, stateValue));
-    return new State({
-      value: stateValue,
-      context,
-      meta: undefined,
-      configuration: Array.from(configuration),
-      children: {},
-      status: 'active'
-    }, machine);
-  }
-
-  /**
-   * Creates a new `State` instance that represents the current state of a running machine.
-   *
-   * @param config
-   */
-  constructor(config, machine) {
-    this.machine = machine;
-    this.tags = void 0;
-    this.value = void 0;
-    this.status = void 0;
-    this.error = void 0;
-    this.context = void 0;
-    this.historyValue = {};
-    this.configuration = void 0;
-    this.children = void 0;
-    this.context = config.context;
-    this.historyValue = config.historyValue || {};
-    this.matches = this.matches.bind(this);
-    this.toStrings = this.toStrings.bind(this);
-    this.configuration = config.configuration ?? Array.from(getConfiguration(getStateNodes(machine.root, config.value)));
-    this.children = config.children;
-    this.value = getStateValue(machine.root, this.configuration);
-    this.tags = new Set(flatten(this.configuration.map(sn => sn.tags)));
-    this.status = config.status;
-    this.output = config.output;
-    this.error = config.error;
-  }
-
-  /**
-   * Returns an array of all the string leaf state node paths.
-   * @param stateValue
-   * @param delimiter The character(s) that separate each subpath in the string state node path.
-   */
-  toStrings(stateValue = this.value) {
-    if (typeof stateValue === 'string') {
-      return [stateValue];
-    }
-    const valueKeys = Object.keys(stateValue);
-    return valueKeys.concat(...valueKeys.map(key => this.toStrings(stateValue[key]).map(s => key + STATE_DELIMITER + s)));
-  }
-  toJSON() {
-    const {
-      configuration,
-      tags,
-      machine,
-      ...jsonValues
-    } = this;
-    return {
-      ...jsonValues,
-      tags: Array.from(tags),
-      meta: this.meta
-    };
-  }
-
-  /**
-   * Whether the current state value is a subset of the given parent state value.
-   * @param parentStateValue
-   */
-  matches(parentStateValue) {
-    return matchesState(parentStateValue, this.value);
-  }
-
-  /**
-   * Whether the current state configuration has a state node with the specified `tag`.
-   * @param tag
-   */
-  hasTag(tag) {
-    return this.tags.has(tag);
-  }
 
-  /**
-   * Determines whether sending the `event` will cause a non-forbidden transition
-   * to be selected, even if the transitions have no actions nor
-   * change the state value.
-   *
-   * @param event The event to test
-   * @returns Whether the event will cause a transition
-   */
-  can(event) {
-    if (!this.machine) {
-      console.warn(`state.can(...) used outside of a machine-created State object; this will always return false.`);
-    }
-    const transitionData = this.machine.getTransitionData(this, event);
-    return !!transitionData?.length &&
-    // Check that at least one transition is not forbidden
-    transitionData.some(t => t.target !== undefined || t.actions.length);
-  }
-
-  /**
-   * The next events that will cause a transition from the current state.
-   */
-  get nextEvents() {
-    return memo(this, 'nextEvents', () => {
-      return [...new Set(flatten([...this.configuration.map(sn => sn.ownEvents)]))];
-    });
-  }
-  get meta() {
-    return this.configuration.reduce((acc, stateNode) => {
-      if (stateNode.meta !== undefined) {
-        acc[stateNode.id] = stateNode.meta;
+function createMachineSnapshot(config, machine) {
+  return {
+    status: config.status,
+    output: config.output,
+    error: config.error,
+    machine,
+    context: config.context,
+    configuration: config.configuration,
+    value: getStateValue(machine.root, config.configuration),
+    tags: new Set(flatten(config.configuration.map(sn => sn.tags))),
+    children: config.children,
+    historyValue: config.historyValue || {},
+    matches(parentStateValue) {
+      return matchesState(parentStateValue, this.value);
+    },
+    hasTag(tag) {
+      return this.tags.has(tag);
+    },
+    can(event) {
+      if (!this.machine) {
+        console.warn(`state.can(...) used outside of a machine-created State object; this will always return false.`);
       }
-      return acc;
-    }, {});
-  }
+      const transitionData = this.machine.getTransitionData(this, event);
+      return !!transitionData?.length &&
+      // Check that at least one transition is not forbidden
+      transitionData.some(t => t.target !== undefined || t.actions.length);
+    },
+    get nextEvents() {
+      return memo(this, 'nextEvents', () => {
+        return [...new Set(flatten([...this.configuration.map(sn => sn.ownEvents)]))];
+      });
+    },
+    get meta() {
+      return this.configuration.reduce((acc, stateNode) => {
+        if (stateNode.meta !== undefined) {
+          acc[stateNode.id] = stateNode.meta;
+        }
+        return acc;
+      }, {});
+    },
+    toJSON() {
+      const {
+        configuration,
+        tags,
+        machine,
+        nextEvents,
+        toJSON,
+        can,
+        hasTag,
+        matches,
+        ...jsonValues
+      } = this;
+      return {
+        ...jsonValues,
+        tags: Array.from(tags)
+      };
+    }
+  };
 }
-function cloneState(state, config = {}) {
-  return new State({
+function cloneMachineSnapshot(state, config = {}) {
+  return createMachineSnapshot(
+  // TODO: it's wasteful that this spread triggers getters
+  {
     ...state,
     ...config
   }, state.machine);
 }
-function getPersistedState(state) {
+function getPersistedState(state, options) {
   const {
     configuration,
     tags,
     machine,
     children,
     context,
+    can,
+    hasTag,
+    matches,
+    toJSON,
+    nextEvents,
     ...jsonValues
   } = state;
   const childrenJson = {};
   for (const id in children) {
     const child = children[id];
-    if (typeof child.src !== 'string') {
+    if (typeof child.src !== 'string' && (!options || !('__unsafeAllowInlineActors' in options))) {
       throw new Error('An inline child actor cannot be persisted.');
     }
     childrenJson[id] = {
-      state: child.getPersistedState(),
+      state: child.getPersistedState(options),
       src: child.src,
       systemId: child._systemId
     };
@@ -1536,4 +1437,4 @@ function raise(eventOrExpr, options) {
   return raise;
 }
 
-export { raise as A, stop as B, spawn as C, State as S, formatTransition as a, formatInitialTransition as b, getCandidates as c, getConfiguration as d, evaluateGuard as e, formatTransitions as f, getDelayedTransitions as g, getStateNodes as h, isInFinalState as i, cloneState as j, macrostep as k, getInitialConfiguration as l, memo as m, resolveActionsAndContext as n, microstep as o, getInitialStateNodes as p, isStateId as q, resolveStateValue as r, getStateNodeByPath as s, transitionNode as t, getPersistedState as u, and as v, not as w, or as x, stateIn as y, cancel as z };
+export { raise as A, stop as B, spawn as C, formatTransition as a, formatInitialTransition as b, getCandidates as c, getConfiguration as d, evaluateGuard as e, formatTransitions as f, getDelayedTransitions as g, getStateNodes as h, createMachineSnapshot as i, isInFinalState as j, cloneMachineSnapshot as k, macrostep as l, memo as m, resolveActionsAndContext as n, microstep as o, getInitialStateNodes as p, isStateId as q, resolveStateValue as r, getStateNodeByPath as s, transitionNode as t, getPersistedState as u, and as v, not as w, or as x, stateIn as y, cancel as z };