xstate 5.0.0-beta.45 → 5.0.0-beta.46

package/dist/xstate.development.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.development.cjs.js');
-var guards_dist_xstateGuards = require('./raise-b3fb3c65.development.cjs.js');
-var send = require('./send-d0bc7eed.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-a9e7e31c.development.cjs.js');
+var send = require('./send-5b256a89.development.cjs.js');
 require('../dev/dist/xstate-dev.development.cjs.js');
 
 class SimulatedClock {
@@ -90,85 +90,72 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  /**
-   * The relative key of the state node, which represents its location in the overall state value.
-   */
-
-  /**
-   * The unique ID of the state node.
-   */
-
-  /**
-   * 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
-   */
-
-  /**
-   * The string path from the root machine node to this node.
-   */
-
-  /**
-   * The child state nodes.
-   */
-
-  /**
-   * 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
-   */
-
-  /**
-   * The action(s) to be executed upon entering the state node.
-   */
-
-  /**
-   * The action(s) to be executed upon exiting the state node.
-   */
-
-  /**
-   * The parent state node.
-   */
-
-  /**
-   * The root machine node.
-   */
-
-  /**
-   * The meta data associated with this state node, which will be returned in State instances.
-   */
-
-  /**
-   * The output data sent with the "xstate.done.state._id_" event if this is a final state node.
-   */
-
-  /**
-   * The order this state node appears. Corresponds to the implicit document order.
-   */
-
   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 = [];
@@ -374,16 +361,15 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  /**
-   * The machine's own version.
-   */
-
   constructor(
   /**
    * The raw config used to create the machine.
    */
   config, implementations) {
     this.config = config;
+    /**
+     * The machine's own version.
+     */
     this.version = void 0;
     this.implementations = void 0;
     this.types = void 0;
@@ -393,15 +379,7 @@ class StateMachine {
     this.id = void 0;
     this.states = void 0;
     this.events = void 0;
-    this.__TContext = void 0;
-    this.__TEvent = void 0;
-    this.__TActor = void 0;
-    this.__TAction = void 0;
-    this.__TGuard = void 0;
-    this.__TDelay = void 0;
-    this.__TTag = void 0;
-    this.__TInput = void 0;
-    this.__TOutput = void 0;
+    /** @deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
     this.__TResolvedTypesMeta = void 0;
     this.id = config.id || '(machine)';
     this.implementations = {
@@ -486,7 +464,7 @@ class StateMachine {
    */
   transition(state, event, actorScope) {
     // TODO: handle error events in a better way
-    if (guards_dist_xstateGuards.isErrorActorEvent(event) && !state.getNextEvents().some(nextEvent => nextEvent === event.type)) {
+    if (guards_dist_xstateGuards.isErrorActorEvent(event) && !guards_dist_xstateGuards.getAllOwnEventDescriptors(state).some(nextEvent => nextEvent === event.type)) {
       return guards_dist_xstateGuards.cloneMachineSnapshot(state, {
         status: 'error',
         error: event.data
@@ -596,12 +574,11 @@ class StateMachine {
       if (!logic) {
         return;
       }
-      const actorState = logic.restoreState?.(childState, _actorScope);
       const actorRef = guards_dist_xstateGuards.createActor(logic, {
         id: actorId,
         parent: _actorScope?.self,
         syncSnapshot: actorData.syncSnapshot,
-        state: actorState,
+        state: childState,
         src,
         systemId: actorData.systemId
       });
@@ -632,8 +609,6 @@ class StateMachine {
     reviveContext(restoredSnapshot.context, children);
     return restoredSnapshot;
   }
-
-  /**@deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
 }
 
 const defaultWaitForOptions = {
@@ -714,6 +689,8 @@ function createMachine(config, implementations) {
   return new StateMachine(config, implementations);
 }
 
+// at the moment we allow extra actors - ones that are not specified by `children`
+// this could be reconsidered in the future
 function setup({
   actors,
   actions,
@@ -737,6 +714,7 @@ exports.fromObservable = actors_dist_xstateActors.fromObservable;
 exports.fromPromise = actors_dist_xstateActors.fromPromise;
 exports.fromTransition = actors_dist_xstateActors.fromTransition;
 exports.Actor = guards_dist_xstateGuards.Actor;
+exports.__unsafe_getAllOwnEventDescriptors = guards_dist_xstateGuards.getAllOwnEventDescriptors;
 exports.and = guards_dist_xstateGuards.and;
 exports.cancel = guards_dist_xstateGuards.cancel;
 exports.createActor = guards_dist_xstateGuards.createActor;

package/dist/xstate.development.cjs.mjs

@@ -4,6 +4,7 @@ export {
   SpecialTargets,
   StateMachine,
   StateNode,
+  __unsafe_getAllOwnEventDescriptors,
   and,
   assign,
   cancel,

package/dist/xstate.development.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.development.esm.js';
-import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as isErrorActorEvent, o as cloneMachineSnapshot, p as macrostep, q as transitionNode, s as resolveActionsAndContext, u as createInitEvent, v as microstep, w as getInitialStateNodes, x as isStateId, y as getStateNodeByPath, z as getPersistedState, A as resolveReferencedActor, B as createActor, $ as $$ACTOR_TYPE } from './raise-90139fbc.development.esm.js';
-export { C as Actor, I as and, M as cancel, B as createActor, j as getStateNodes, D as interpret, E as isMachineSnapshot, F as matchesState, J as not, K as or, G as pathToStateValue, O as raise, Q as spawn, L as stateIn, P as stop, H as toObserver } from './raise-90139fbc.development.esm.js';
-import { a as assign } from './send-24cc8018.development.esm.js';
-export { S as SpecialTargets, a as assign, c as choose, e as escalate, f as forwardTo, l as log, p as pure, s as sendParent, b as sendTo } from './send-24cc8018.development.esm.js';
+import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as isErrorActorEvent, o as getAllOwnEventDescriptors, p as cloneMachineSnapshot, q as macrostep, s as transitionNode, u as resolveActionsAndContext, v as createInitEvent, w as microstep, x as getInitialStateNodes, y as isStateId, z as getStateNodeByPath, A as getPersistedState, B as resolveReferencedActor, C as createActor, $ as $$ACTOR_TYPE } from './raise-fa23c2b9.development.esm.js';
+export { D as Actor, o as __unsafe_getAllOwnEventDescriptors, J as and, O as cancel, C as createActor, j as getStateNodes, E as interpret, F as isMachineSnapshot, G as matchesState, K as not, L as or, H as pathToStateValue, P as raise, R as spawn, M as stateIn, Q as stop, I as toObserver } from './raise-fa23c2b9.development.esm.js';
+import { a as assign } from './send-9acdf858.development.esm.js';
+export { S as SpecialTargets, a as assign, c as choose, e as escalate, f as forwardTo, l as log, p as pure, s as sendParent, b as sendTo } from './send-9acdf858.development.esm.js';
 import '../dev/dist/xstate-dev.development.esm.js';
 
 class SimulatedClock {
@@ -88,85 +88,72 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  /**
-   * The relative key of the state node, which represents its location in the overall state value.
-   */
-
-  /**
-   * The unique ID of the state node.
-   */
-
-  /**
-   * 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
-   */
-
-  /**
-   * The string path from the root machine node to this node.
-   */
-
-  /**
-   * The child state nodes.
-   */
-
-  /**
-   * 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
-   */
-
-  /**
-   * The action(s) to be executed upon entering the state node.
-   */
-
-  /**
-   * The action(s) to be executed upon exiting the state node.
-   */
-
-  /**
-   * The parent state node.
-   */
-
-  /**
-   * The root machine node.
-   */
-
-  /**
-   * The meta data associated with this state node, which will be returned in State instances.
-   */
-
-  /**
-   * The output data sent with the "xstate.done.state._id_" event if this is a final state node.
-   */
-
-  /**
-   * The order this state node appears. Corresponds to the implicit document order.
-   */
-
   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 = [];
@@ -372,16 +359,15 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  /**
-   * The machine's own version.
-   */
-
   constructor(
   /**
    * The raw config used to create the machine.
    */
   config, implementations) {
     this.config = config;
+    /**
+     * The machine's own version.
+     */
     this.version = void 0;
     this.implementations = void 0;
     this.types = void 0;
@@ -391,15 +377,7 @@ class StateMachine {
     this.id = void 0;
     this.states = void 0;
     this.events = void 0;
-    this.__TContext = void 0;
-    this.__TEvent = void 0;
-    this.__TActor = void 0;
-    this.__TAction = void 0;
-    this.__TGuard = void 0;
-    this.__TDelay = void 0;
-    this.__TTag = void 0;
-    this.__TInput = void 0;
-    this.__TOutput = void 0;
+    /** @deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
     this.__TResolvedTypesMeta = void 0;
     this.id = config.id || '(machine)';
     this.implementations = {
@@ -484,7 +462,7 @@ class StateMachine {
    */
   transition(state, event, actorScope) {
     // TODO: handle error events in a better way
-    if (isErrorActorEvent(event) && !state.getNextEvents().some(nextEvent => nextEvent === event.type)) {
+    if (isErrorActorEvent(event) && !getAllOwnEventDescriptors(state).some(nextEvent => nextEvent === event.type)) {
       return cloneMachineSnapshot(state, {
         status: 'error',
         error: event.data
@@ -594,12 +572,11 @@ class StateMachine {
       if (!logic) {
         return;
       }
-      const actorState = logic.restoreState?.(childState, _actorScope);
       const actorRef = createActor(logic, {
         id: actorId,
         parent: _actorScope?.self,
         syncSnapshot: actorData.syncSnapshot,
-        state: actorState,
+        state: childState,
         src,
         systemId: actorData.systemId
       });
@@ -630,8 +607,6 @@ class StateMachine {
     reviveContext(restoredSnapshot.context, children);
     return restoredSnapshot;
   }
-
-  /**@deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
 }
 
 const defaultWaitForOptions = {
@@ -712,6 +687,8 @@ function createMachine(config, implementations) {
   return new StateMachine(config, implementations);
 }
 
+// at the moment we allow extra actors - ones that are not specified by `children`
+// this could be reconsidered in the future
 function setup({
   actors,
   actions,

package/dist/xstate.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.esm.js';
-import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as isErrorActorEvent, o as cloneMachineSnapshot, p as macrostep, q as transitionNode, s as resolveActionsAndContext, u as createInitEvent, v as microstep, w as getInitialStateNodes, x as isStateId, y as getStateNodeByPath, z as getPersistedState, A as resolveReferencedActor, B as createActor, $ as $$ACTOR_TYPE } from './raise-2b5a4e4c.esm.js';
-export { C as Actor, I as and, M as cancel, B as createActor, j as getStateNodes, D as interpret, E as isMachineSnapshot, F as matchesState, J as not, K as or, G as pathToStateValue, O as raise, Q as spawn, L as stateIn, P as stop, H as toObserver } from './raise-2b5a4e4c.esm.js';
-import { a as assign } from './send-8e7e41e7.esm.js';
-export { S as SpecialTargets, a as assign, c as choose, e as escalate, f as forwardTo, l as log, p as pure, s as sendParent, b as sendTo } from './send-8e7e41e7.esm.js';
+import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as isErrorActorEvent, o as getAllOwnEventDescriptors, p as cloneMachineSnapshot, q as macrostep, s as transitionNode, u as resolveActionsAndContext, v as createInitEvent, w as microstep, x as getInitialStateNodes, y as isStateId, z as getStateNodeByPath, A as getPersistedState, B as resolveReferencedActor, C as createActor, $ as $$ACTOR_TYPE } from './raise-1682abb7.esm.js';
+export { D as Actor, o as __unsafe_getAllOwnEventDescriptors, J as and, O as cancel, C as createActor, j as getStateNodes, E as interpret, F as isMachineSnapshot, G as matchesState, K as not, L as or, H as pathToStateValue, P as raise, R as spawn, M as stateIn, Q as stop, I as toObserver } from './raise-1682abb7.esm.js';
+import { a as assign } from './send-a237e4e8.esm.js';
+export { S as SpecialTargets, a as assign, c as choose, e as escalate, f as forwardTo, l as log, p as pure, s as sendParent, b as sendTo } from './send-a237e4e8.esm.js';
 import '../dev/dist/xstate-dev.esm.js';
 
 class SimulatedClock {
@@ -88,85 +88,72 @@ const toSerializableAction = action => {
   return action;
 };
 class StateNode {
-  /**
-   * The relative key of the state node, which represents its location in the overall state value.
-   */
-
-  /**
-   * The unique ID of the state node.
-   */
-
-  /**
-   * 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
-   */
-
-  /**
-   * The string path from the root machine node to this node.
-   */
-
-  /**
-   * The child state nodes.
-   */
-
-  /**
-   * 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
-   */
-
-  /**
-   * The action(s) to be executed upon entering the state node.
-   */
-
-  /**
-   * The action(s) to be executed upon exiting the state node.
-   */
-
-  /**
-   * The parent state node.
-   */
-
-  /**
-   * The root machine node.
-   */
-
-  /**
-   * The meta data associated with this state node, which will be returned in State instances.
-   */
-
-  /**
-   * The output data sent with the "xstate.done.state._id_" event if this is a final state node.
-   */
-
-  /**
-   * The order this state node appears. Corresponds to the implicit document order.
-   */
-
   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 = [];
@@ -372,16 +359,15 @@ class StateNode {
 
 const STATE_IDENTIFIER = '#';
 class StateMachine {
-  /**
-   * The machine's own version.
-   */
-
   constructor(
   /**
    * The raw config used to create the machine.
    */
   config, implementations) {
     this.config = config;
+    /**
+     * The machine's own version.
+     */
     this.version = void 0;
     this.implementations = void 0;
     this.types = void 0;
@@ -391,15 +377,7 @@ class StateMachine {
     this.id = void 0;
     this.states = void 0;
     this.events = void 0;
-    this.__TContext = void 0;
-    this.__TEvent = void 0;
-    this.__TActor = void 0;
-    this.__TAction = void 0;
-    this.__TGuard = void 0;
-    this.__TDelay = void 0;
-    this.__TTag = void 0;
-    this.__TInput = void 0;
-    this.__TOutput = void 0;
+    /** @deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
     this.__TResolvedTypesMeta = void 0;
     this.id = config.id || '(machine)';
     this.implementations = {
@@ -481,7 +459,7 @@ class StateMachine {
    */
   transition(state, event, actorScope) {
     // TODO: handle error events in a better way
-    if (isErrorActorEvent(event) && !state.getNextEvents().some(nextEvent => nextEvent === event.type)) {
+    if (isErrorActorEvent(event) && !getAllOwnEventDescriptors(state).some(nextEvent => nextEvent === event.type)) {
       return cloneMachineSnapshot(state, {
         status: 'error',
         error: event.data
@@ -591,12 +569,11 @@ class StateMachine {
       if (!logic) {
         return;
       }
-      const actorState = logic.restoreState?.(childState, _actorScope);
       const actorRef = createActor(logic, {
         id: actorId,
         parent: _actorScope?.self,
         syncSnapshot: actorData.syncSnapshot,
-        state: actorState,
+        state: childState,
         src,
         systemId: actorData.systemId
       });
@@ -627,8 +604,6 @@ class StateMachine {
     reviveContext(restoredSnapshot.context, children);
     return restoredSnapshot;
   }
-
-  /**@deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
 }
 
 const defaultWaitForOptions = {
@@ -706,6 +681,8 @@ function createMachine(config, implementations) {
   return new StateMachine(config, implementations);
 }
 
+// at the moment we allow extra actors - ones that are not specified by `children`
+// this could be reconsidered in the future
 function setup({
   actors,
   actions,