xstate 5.32.2 → 6.0.0-alpha.10

package/dist/StateMachine-d1d80308.esm.js

@@ -1,560 +0,0 @@
-import { S as STATE_DELIMITER, y as mapValues, t as toArray, z as formatTransitions, B as toTransitionConfigArray, C as formatTransition, N as NULL_EVENT, D as evaluateGuard, E as createInvokeId, F as getDelayedTransitions, G as formatInitialTransition, H as getCandidates, I as formatRouteTransitions, J as resolveStateValue, K as getAllStateNodes, p as getStateNodes, L as createMachineSnapshot, M as isInFinalState, d as macrostep, O as transitionNode, P as resolveActionsAndContext, e as createInitEvent, f as initialMicrostep, Q as toStatePath, R as isStateId, T as getStateNodeByPath, U as getPersistedSnapshot, V as resolveReferencedActor, c as createActor, $ as $$ACTOR_TYPE } from './raise-235108c6.esm.js';
-import { a as assign } from './assign-54b312bc.esm.js';
-
-const cache = new WeakMap();
-function memo(object, key, fn) {
-  let memoizedData = cache.get(object);
-  if (!memoizedData) {
-    memoizedData = {
-      [key]: fn()
-    };
-    cache.set(object, memoizedData);
-  } else if (!(key in memoizedData)) {
-    memoizedData[key] = fn();
-  }
-  return memoizedData[key];
-}
-
-const EMPTY_OBJECT = {};
-const toSerializableAction = action => {
-  if (typeof action === 'string') {
-    return {
-      type: action
-    };
-  }
-  if (typeof action === 'function') {
-    if ('resolve' in action) {
-      return {
-        type: action.type
-      };
-    }
-    return {
-      type: action.name
-    };
-  }
-  return action;
-};
-class StateNode {
-  constructor(/** The raw config used to create the machine. */
-  config, options) {
-    this.config = config;
-    /**
-     * The relative key of the state node, which represents its location in the
-     * overall state value.
-     */
-    this.key = void 0;
-    /** The unique ID of the state node. */
-    this.id = void 0;
-    /**
-     * The type of this state node:
-     *
-     * - `'atomic'` - no child state nodes
-     * - `'compound'` - nested child state nodes (XOR)
-     * - `'parallel'` - orthogonal nested child state nodes (AND)
-     * - `'history'` - history state node
-     * - `'final'` - final state node
-     */
-    this.type = void 0;
-    /** The string path from the root machine node to this node. */
-    this.path = void 0;
-    /** The child state nodes. */
-    this.states = void 0;
-    /**
-     * The type of history on this state node. Can be:
-     *
-     * - `'shallow'` - recalls only top-level historical state value
-     * - `'deep'` - recalls historical state value at all levels
-     */
-    this.history = void 0;
-    /** The action(s) to be executed upon entering the state node. */
-    this.entry = void 0;
-    /** The action(s) to be executed upon exiting the state node. */
-    this.exit = void 0;
-    /** The parent state node. */
-    this.parent = void 0;
-    /** The root machine node. */
-    this.machine = void 0;
-    /**
-     * The meta data associated with this state node, which will be returned in
-     * State instances.
-     */
-    this.meta = void 0;
-    /**
-     * The output data sent with the "xstate.done.state._id_" event if this is a
-     * final state node.
-     */
-    this.output = void 0;
-    /**
-     * The order this state node appears. Corresponds to the implicit document
-     * order.
-     */
-    this.order = -1;
-    this.description = void 0;
-    this.tags = [];
-    this.transitions = void 0;
-    this.always = void 0;
-    this.parent = options._parent;
-    this.key = options._key;
-    this.machine = options._machine;
-    this.path = this.parent ? this.parent.path.concat(this.key) : [];
-    this.id = this.config.id || [this.machine.id, ...this.path].join(STATE_DELIMITER);
-    this.type = this.config.type || (this.config.states && Object.keys(this.config.states).length ? 'compound' : this.config.history ? 'history' : 'atomic');
-    this.description = this.config.description;
-    this.order = this.machine.idMap.size;
-    this.machine.idMap.set(this.id, this);
-    this.states = this.config.states ? mapValues(this.config.states, (stateConfig, key) => {
-      const stateNode = new StateNode(stateConfig, {
-        _parent: this,
-        _key: key,
-        _machine: this.machine
-      });
-      return stateNode;
-    }) : EMPTY_OBJECT;
-    if (this.type === 'compound' && !this.config.initial) {
-      throw new Error(`No initial state specified for compound state node "#${this.id}". Try adding { initial: "${Object.keys(this.states)[0]}" } to the state config.`);
-    }
-
-    // History config
-    this.history = this.config.history === true ? 'shallow' : this.config.history || false;
-    this.entry = toArray(this.config.entry).slice();
-    this.exit = toArray(this.config.exit).slice();
-    this.meta = this.config.meta;
-    this.output = this.type === 'final' || !this.parent ? this.config.output : undefined;
-    this.tags = toArray(config.tags).slice();
-  }
-
-  /** @internal */
-  _initialize() {
-    this.transitions = formatTransitions(this);
-    if (this.config.always) {
-      this.always = toTransitionConfigArray(this.config.always).map(t => formatTransition(this, NULL_EVENT, t));
-    }
-    Object.keys(this.states).forEach(key => {
-      this.states[key]._initialize();
-    });
-  }
-
-  /** The well-structured state node definition. */
-  get definition() {
-    return {
-      id: this.id,
-      key: this.key,
-      version: this.machine.version,
-      type: this.type,
-      initial: this.initial ? {
-        target: this.initial.target,
-        source: this,
-        actions: this.initial.actions.map(toSerializableAction),
-        eventType: null,
-        reenter: false,
-        toJSON: () => ({
-          target: this.initial.target.map(t => `#${t.id}`),
-          source: `#${this.id}`,
-          actions: this.initial.actions.map(toSerializableAction),
-          eventType: null
-        })
-      } : undefined,
-      history: this.history,
-      states: mapValues(this.states, state => {
-        return state.definition;
-      }),
-      on: this.on,
-      transitions: [...this.transitions.values()].flat().map(t => ({
-        ...t,
-        actions: t.actions.map(toSerializableAction)
-      })),
-      entry: this.entry.map(toSerializableAction),
-      exit: this.exit.map(toSerializableAction),
-      meta: this.meta,
-      order: this.order || -1,
-      output: this.output,
-      invoke: this.invoke,
-      description: this.description,
-      tags: this.tags
-    };
-  }
-
-  /** @internal */
-  toJSON() {
-    return this.definition;
-  }
-
-  /** The logic invoked as actors by this state node. */
-  get invoke() {
-    return memo(this, 'invoke', () => toArray(this.config.invoke).map((invokeConfig, i) => {
-      const {
-        src,
-        systemId
-      } = invokeConfig;
-      const resolvedId = invokeConfig.id ?? createInvokeId(this.id, i);
-      const sourceName = typeof src === 'string' ? src : `xstate.invoke.${createInvokeId(this.id, i)}`;
-      return {
-        ...invokeConfig,
-        src: sourceName,
-        id: resolvedId,
-        systemId: systemId,
-        toJSON() {
-          const {
-            onDone,
-            onError,
-            ...invokeDefValues
-          } = invokeConfig;
-          return {
-            ...invokeDefValues,
-            type: 'xstate.invoke',
-            src: sourceName,
-            id: resolvedId
-          };
-        }
-      };
-    }));
-  }
-
-  /** The mapping of events to transitions. */
-  get on() {
-    return memo(this, 'on', () => {
-      const transitions = this.transitions;
-      return [...transitions].flatMap(([descriptor, t]) => t.map(t => [descriptor, t])).reduce((map, [descriptor, transition]) => {
-        map[descriptor] = map[descriptor] || [];
-        map[descriptor].push(transition);
-        return map;
-      }, {});
-    });
-  }
-  get after() {
-    return memo(this, 'delayedTransitions', () => getDelayedTransitions(this));
-  }
-  get initial() {
-    return memo(this, 'initial', () => formatInitialTransition(this, this.config.initial));
-  }
-
-  /** @internal */
-  next(snapshot, event) {
-    const eventType = event.type;
-    const actions = [];
-    let selectedTransition;
-    const candidates = memo(this, `candidates-${eventType}`, () => getCandidates(this, eventType));
-    for (const candidate of candidates) {
-      const {
-        guard
-      } = candidate;
-      const resolvedContext = snapshot.context;
-      let guardPassed = false;
-      try {
-        guardPassed = !guard || evaluateGuard(guard, resolvedContext, event, snapshot);
-      } catch (err) {
-        const guardType = typeof guard === 'string' ? guard : typeof guard === 'object' ? guard.type : undefined;
-        throw new Error(`Unable to evaluate guard ${guardType ? `'${guardType}' ` : ''}in transition for event '${eventType}' in state node '${this.id}':\n${err.message}`);
-      }
-      if (guardPassed) {
-        actions.push(...candidate.actions);
-        selectedTransition = candidate;
-        break;
-      }
-    }
-    return selectedTransition ? [selectedTransition] : undefined;
-  }
-
-  /** All the event types accepted by this state node and its descendants. */
-  get events() {
-    return memo(this, 'events', () => {
-      const {
-        states
-      } = this;
-      const events = new Set(this.ownEvents);
-      if (states) {
-        for (const stateId of Object.keys(states)) {
-          const state = states[stateId];
-          if (state.states) {
-            for (const event of state.events) {
-              events.add(`${event}`);
-            }
-          }
-        }
-      }
-      return Array.from(events);
-    });
-  }
-
-  /**
-   * All the events that have transitions directly from this state node.
-   *
-   * Excludes any inert events.
-   */
-  get ownEvents() {
-    const keys = Object.keys(Object.fromEntries(this.transitions));
-    const events = new Set(keys.filter(descriptor => {
-      return this.transitions.get(descriptor).some(transition => !(!transition.target && !transition.actions.length && !transition.reenter));
-    }));
-    return Array.from(events);
-  }
-}
-
-const STATE_IDENTIFIER = '#';
-class StateMachine {
-  constructor(/** The raw config used to create the machine. */
-  config, implementations) {
-    this.config = config;
-    /** The machine's own version. */
-    this.version = void 0;
-    this.schemas = void 0;
-    this.implementations = void 0;
-    /** Runtime options for machine execution. */
-    this.options = void 0;
-    /** @internal */
-    this.__xstatenode = true;
-    /** @internal */
-    this.idMap = new Map();
-    this.root = void 0;
-    this.id = void 0;
-    this.states = void 0;
-    this.events = void 0;
-    this.id = config.id || '(machine)';
-    this.implementations = {
-      actors: implementations?.actors ?? {},
-      actions: implementations?.actions ?? {},
-      delays: implementations?.delays ?? {},
-      guards: implementations?.guards ?? {}
-    };
-    this.version = this.config.version;
-    this.schemas = this.config.schemas;
-    this.options = {
-      maxIterations: Infinity,
-      ...this.config.options
-    };
-    this.transition = this.transition.bind(this);
-    this.getInitialSnapshot = this.getInitialSnapshot.bind(this);
-    this.getPersistedSnapshot = this.getPersistedSnapshot.bind(this);
-    this.restoreSnapshot = this.restoreSnapshot.bind(this);
-    this.start = this.start.bind(this);
-    this.root = new StateNode(config, {
-      _key: this.id,
-      _machine: this
-    });
-    this.root._initialize();
-    formatRouteTransitions(this.root);
-    this.states = this.root.states; // TODO: remove!
-    this.events = this.root.events;
-  }
-
-  /**
-   * Clones this state machine with the provided implementations.
-   *
-   * @param implementations Options (`actions`, `guards`, `actors`, `delays`) to
-   *   recursively merge with the existing options.
-   * @returns A new `StateMachine` instance with the provided implementations.
-   */
-  provide(implementations) {
-    const {
-      actions,
-      guards,
-      actors,
-      delays
-    } = this.implementations;
-    return new StateMachine(this.config, {
-      actions: {
-        ...actions,
-        ...implementations.actions
-      },
-      guards: {
-        ...guards,
-        ...implementations.guards
-      },
-      actors: {
-        ...actors,
-        ...implementations.actors
-      },
-      delays: {
-        ...delays,
-        ...implementations.delays
-      }
-    });
-  }
-  resolveState(config) {
-    const resolvedStateValue = resolveStateValue(this.root, config.value);
-    const nodeSet = getAllStateNodes(getStateNodes(this.root, resolvedStateValue));
-    return createMachineSnapshot({
-      _nodes: [...nodeSet],
-      context: config.context || {},
-      children: {},
-      status: isInFinalState(nodeSet, this.root) ? 'done' : config.status || 'active',
-      output: config.output,
-      error: config.error,
-      historyValue: config.historyValue
-    }, this);
-  }
-
-  /**
-   * Determines the next snapshot given the current `snapshot` and received
-   * `event`. Calculates a full macrostep from all microsteps.
-   *
-   * @param snapshot The current snapshot
-   * @param event The received event
-   */
-  transition(snapshot, event, actorScope) {
-    return macrostep(snapshot, event, actorScope, []).snapshot;
-  }
-
-  /**
-   * Determines the next state given the current `state` and `event`. Calculates
-   * a microstep.
-   *
-   * @param state The current state
-   * @param event The received event
-   */
-  microstep(snapshot, event, actorScope) {
-    return macrostep(snapshot, event, actorScope, []).microsteps.map(([s]) => s);
-  }
-  getTransitionData(snapshot, event) {
-    return transitionNode(this.root, snapshot.value, snapshot, event) || [];
-  }
-
-  /**
-   * The initial state _before_ evaluating any microsteps. This "pre-initial"
-   * state is provided to initial actions executed in the initial state.
-   *
-   * @internal
-   */
-  _getPreInitialState(actorScope, initEvent, internalQueue) {
-    const {
-      context
-    } = this.config;
-    const preInitial = createMachineSnapshot({
-      context: typeof context !== 'function' && context ? context : {},
-      _nodes: [this.root],
-      children: {},
-      status: 'active'
-    }, this);
-    if (typeof context === 'function') {
-      const assignment = ({
-        spawn,
-        event,
-        self
-      }) => context({
-        spawn,
-        input: event.input,
-        self
-      });
-      return resolveActionsAndContext(preInitial, initEvent, actorScope, [assign(assignment)], internalQueue, undefined);
-    }
-    return preInitial;
-  }
-
-  /**
-   * Returns the initial `State` instance, with reference to `self` as an
-   * `ActorRef`.
-   */
-  getInitialSnapshot(actorScope, input) {
-    const initEvent = createInitEvent(input); // TODO: fix;
-    const internalQueue = [];
-    const preInitialState = this._getPreInitialState(actorScope, initEvent, internalQueue);
-    const [nextState] = initialMicrostep(this.root, preInitialState, actorScope, initEvent, internalQueue);
-    const {
-      snapshot: macroState
-    } = macrostep(nextState, initEvent, actorScope, internalQueue);
-    return macroState;
-  }
-  start(snapshot) {
-    Object.values(snapshot.children).forEach(child => {
-      if (child.getSnapshot().status === 'active') {
-        child.start();
-      }
-    });
-  }
-  getStateNodeById(stateId) {
-    const fullPath = toStatePath(stateId);
-    const relativePath = fullPath.slice(1);
-    const resolvedStateId = isStateId(fullPath[0]) ? fullPath[0].slice(STATE_IDENTIFIER.length) : fullPath[0];
-    const stateNode = this.idMap.get(resolvedStateId);
-    if (!stateNode) {
-      throw new Error(`Child state node '#${resolvedStateId}' does not exist on machine '${this.id}'`);
-    }
-    return getStateNodeByPath(stateNode, relativePath);
-  }
-  get definition() {
-    return this.root.definition;
-  }
-  toJSON() {
-    return this.definition;
-  }
-  getPersistedSnapshot(snapshot, options) {
-    return getPersistedSnapshot(snapshot, options);
-  }
-  restoreSnapshot(snapshot, _actorScope) {
-    const children = {};
-    const snapshotChildren = snapshot.children;
-    Object.keys(snapshotChildren).forEach(actorId => {
-      const actorData = snapshotChildren[actorId];
-      const childState = actorData.snapshot;
-      const src = actorData.src;
-      const logic = typeof src === 'string' ? resolveReferencedActor(this, src) : src;
-      if (!logic) {
-        return;
-      }
-      const actorRef = createActor(logic, {
-        id: actorId,
-        parent: _actorScope.self,
-        syncSnapshot: actorData.syncSnapshot,
-        snapshot: childState,
-        src,
-        systemId: actorData.systemId
-      });
-      children[actorId] = actorRef;
-    });
-    function resolveHistoryReferencedState(root, referenced) {
-      if (referenced instanceof StateNode) {
-        return referenced;
-      }
-      try {
-        return root.machine.getStateNodeById(referenced.id);
-      } catch {
-      }
-    }
-    function reviveHistoryValue(root, historyValue) {
-      if (!historyValue || typeof historyValue !== 'object') {
-        return {};
-      }
-      const revived = {};
-      for (const key in historyValue) {
-        const arr = historyValue[key];
-        for (const item of arr) {
-          const resolved = resolveHistoryReferencedState(root, item);
-          if (!resolved) {
-            continue;
-          }
-          revived[key] ??= [];
-          revived[key].push(resolved);
-        }
-      }
-      return revived;
-    }
-    const revivedHistoryValue = reviveHistoryValue(this.root, snapshot.historyValue);
-    const restoredSnapshot = createMachineSnapshot({
-      ...snapshot,
-      children,
-      _nodes: Array.from(getAllStateNodes(getStateNodes(this.root, snapshot.value))),
-      historyValue: revivedHistoryValue
-    }, this);
-    const seen = new Set();
-    function reviveContext(contextPart, children) {
-      if (seen.has(contextPart)) {
-        return;
-      }
-      seen.add(contextPart);
-      for (const key in contextPart) {
-        const value = contextPart[key];
-        if (value && typeof value === 'object') {
-          if ('xstate$$type' in value && value.xstate$$type === $$ACTOR_TYPE) {
-            contextPart[key] = children[value.id];
-            continue;
-          }
-          reviveContext(value, children);
-        }
-      }
-    }
-    reviveContext(restoredSnapshot.context, children);
-    return restoredSnapshot;
-  }
-}
-
-export { StateMachine as S, StateNode as a };

package/dist/assign-43b1b558.development.esm.js

@@ -1,133 +0,0 @@
-import { _ as ProcessingStatus, V as resolveReferencedActor, c as createActor, a0 as cloneMachineSnapshot, W as executingCustomAction } from './raise-45f11c00.development.esm.js';
-
-function createSpawner(actorScope, {
-  machine,
-  context
-}, event, spawnedChildren) {
-  const spawn = (src, options) => {
-    if (typeof src === 'string') {
-      const logic = resolveReferencedActor(machine, src);
-      if (!logic) {
-        throw new Error(`Actor logic '${src}' not implemented in machine '${machine.id}'`);
-      }
-      const actorRef = createActor(logic, {
-        id: options?.id,
-        parent: actorScope.self,
-        syncSnapshot: options?.syncSnapshot,
-        input: typeof options?.input === 'function' ? options.input({
-          context,
-          event,
-          self: actorScope.self
-        }) : options?.input,
-        src,
-        systemId: options?.systemId
-      });
-      spawnedChildren[actorRef.id] = actorRef;
-      return actorRef;
-    } else {
-      const actorRef = createActor(src, {
-        id: options?.id,
-        parent: actorScope.self,
-        syncSnapshot: options?.syncSnapshot,
-        input: options?.input,
-        src,
-        systemId: options?.systemId
-      });
-      return actorRef;
-    }
-  };
-  return (src, options) => {
-    const actorRef = spawn(src, options); // TODO: fix types
-    spawnedChildren[actorRef.id] = actorRef;
-    actorScope.defer(() => {
-      if (actorRef._processingStatus === ProcessingStatus.Stopped) {
-        return;
-      }
-      actorRef.start();
-    });
-    return actorRef;
-  };
-}
-
-function resolveAssign(actorScope, snapshot, actionArgs, actionParams, {
-  assignment
-}) {
-  if (!snapshot.context) {
-    throw new Error('Cannot assign to undefined `context`. Ensure that `context` is defined in the machine config.');
-  }
-  const spawnedChildren = {};
-  const assignArgs = {
-    context: snapshot.context,
-    event: actionArgs.event,
-    spawn: createSpawner(actorScope, snapshot, actionArgs.event, spawnedChildren),
-    self: actorScope.self,
-    system: actorScope.system
-  };
-  let partialUpdate = {};
-  if (typeof assignment === 'function') {
-    partialUpdate = assignment(assignArgs, actionParams);
-  } else {
-    for (const key of Object.keys(assignment)) {
-      const propAssignment = assignment[key];
-      partialUpdate[key] = typeof propAssignment === 'function' ? propAssignment(assignArgs, actionParams) : propAssignment;
-    }
-  }
-  const updatedContext = Object.assign({}, snapshot.context, partialUpdate);
-  return [cloneMachineSnapshot(snapshot, {
-    context: updatedContext,
-    children: Object.keys(spawnedChildren).length ? {
-      ...snapshot.children,
-      ...spawnedChildren
-    } : snapshot.children
-  }), undefined, undefined];
-}
-/**
- * Updates the current context of the machine.
- *
- * @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()
- *         };
- *       })
- *     }
- *   }
- * });
- * ```
- *
- * @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 (executingCustomAction) {
-    console.warn('Custom actions should not call `assign()` directly, as it is not imperative. See https://stately.ai/docs/actions#built-in-actions for more details.');
-  }
-  function assign(_args, _params) {
-    {
-      throw new Error(`This isn't supposed to be called`);
-    }
-  }
-  assign.type = 'xstate.assign';
-  assign.assignment = assignment;
-  assign.resolve = resolveAssign;
-  return assign;
-}
-
-export { assign as a };