Version Packages (alpha) #902

github-actions · 2019-12-28T09:51:08Z

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to next, this PR will be updated.

⚠️⚠️⚠️⚠️⚠️⚠️

next is currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, run changeset pre exit on next.

⚠️⚠️⚠️⚠️⚠️⚠️

Releases

xstate@5.0.0-alpha.0

Major Changes

#1045 7f3b84816 Thanks @davidkpiano! - - The third argument of machine.transition(state, event) has been removed. The context should always be given as part of the state.
- There is a new method: machine.microstep(state, event) which returns the resulting intermediate State object that represents a single microstep being taken when transitioning from state via the event. This is the State that does not take into account transient transitions nor raised events, and is useful for debugging.
- The state.events property has been removed from the State object, and is replaced internally by state._internalQueue, which represents raised events to be processed in a macrostep loop. The state._internalQueue property should be considered internal (not used in normal development).
- The state.historyValue property now more closely represents the original SCXML algorithm, and is a mapping of state node IDs to their historic descendent state nodes. This is used for resolving history states, and should be considered internal.
- The stateNode.isTransient property is removed from StateNode.
- The .initial property of a state node config object can now contain executable content (i.e., actions):
```
// ...
initial: {
  target: 'someTarget',
  actions: [/* initial actions */]
}
```
- Assign actions (via assign()) will now be executed "in order", rather than automatically prioritized. They will be evaluated after previously defined actions are evaluated, and actions that read from context will have those intermediate values applied, rather than the final resolved value of all assign() actions taken, which was the previous behavior.
This shouldn't change the behavior for most state machines. To maintain the previous behavior, ensure that assign() actions are defined before any other actions.

#1669 969a2f4fc Thanks @davidkpiano! - An error will be thrown if an initial state key is not specified for compound state nodes. For example:

const lightMachine = createMachine({
  id: 'light',
  initial: 'green',
  states: {
    green: {},
    yellow: {},
    red: {
      // Forgotten initial state:
      // initial: 'walk',
      states: {
        walk: {},
        wait: {}
      }
    }
  }
});

You will get the error:

No initial state specified for state node "#light.red". Try adding { initial: "walk" } to the state config.

#2294 c0a6dcafa Thanks @davidkpiano! - The machine's context is now restricted to an object. This was the most common usage, but now the typings prevent context from being anything but an object:

const machine = createMachine({
  // This will produce the TS error:
  // "Type 'string' is not assignable to type 'object | undefined'"
  context: 'some string'
});

If context is undefined, it will now default to an empty object {}:

const machine = createMachine({
  // No context
});

machine.initialState.context;
// => {}

#1260 172d6a7e1 Thanks @davidkpiano! - All generic types containing TContext and TEvent will now follow the same, consistent order:
1. TContext
2. TEvent
3. ... All other generic types, including TStateSchema,TTypestate`, etc.
```
-const service = interpret<SomeCtx, SomeSchema, SomeEvent>(someMachine);
+const service = interpret<SomeCtx, SomeEvent, SomeSchema>(someMachine);
```
#1808 31bc73e05 Thanks @davidkpiano! - Renamed machine.withConfig(...) to machine.provide(...).
#878 e09efc720 Thanks @Andarist! - Removed third parameter (context) from Machine's transition method. If you want to transition with a particular context value you should create appropriate State using State.from. So instead of this - machine.transition('green', 'TIMER', { elapsed: 100 }), you should do this - machine.transition(State.from('green', { elapsed: 100 }), 'TIMER').
#1203 145539c4c Thanks @davidkpiano! - - The execute option for an interpreted service has been removed. If you don't want to execute actions, it's recommended that you don't hardcode implementation details into the base machine that will be interpreted, and extend the machine's options.actions instead. By default, the interpreter will execute all actions according to SCXML semantics (immediately upon transition).
- Dev tools integration has been simplified, and Redux dev tools support is no longer the default. It can be included from xstate/devTools/redux:
```
import { interpret } from 'xstate';
import { createReduxDevTools } from 'xstate/devTools/redux';

const service = interpret(someMachine, {
  devTools: createReduxDevTools({
    // Redux Dev Tools options
  })
});
```
By default, dev tools are attached to the global window.__xstate__ object:
```
const service = interpret(someMachine, {
  devTools: true // attaches via window.__xstate__.register(service)
});
```
And creating your own custom dev tools adapter is a function that takes in the service:
```
const myCustomDevTools = service => {
  console.log('Got a service!');

  service.subscribe(state => {
    // ...
  });
};

const service = interpret(someMachine, {
  devTools: myCustomDevTools
});
```
- These handlers have been removed, as they are redundant and can all be accomplished with .onTransition(...) and/or .subscribe(...):
  - service.onEvent()
  - service.onSend()
  - service.onChange()
- The service.send(...) method no longer returns the next state. It is a void function (fire-and-forget).
- The service.sender(...) method has been removed as redundant. Use service.send(...) instead.
#953 3de36bb24 Thanks @davidkpiano! - Support for getters as a transition target (instead of referencing state nodes by ID or relative key) has been removed.

The Machine() and createMachine() factory functions no longer support passing in context as a third argument.

The context property in the machine configuration no longer accepts a function for determining context (which was introduced in 4.7). This might change as the API becomes finalized.

The activities property was removed from State objects, as activities are now part of invoke declarations.

The state nodes will not show the machine's version on them - the version property is only available on the root machine node.

The machine.withContext({...}) method now permits providing partial context, instead of the entire machine context.
#1443 9e10660ec Thanks @davidkpiano! - The in: ... property for transitions is removed and replaced with guards. It is recommended to use stateIn() and not(stateIn()) guard creators instead:
```
+ import { stateIn } from 'xstate/guards';

// ...
on: {
  SOME_EVENT: {
    target: 'somewhere',
-   in: '#someState'
+   cond: stateIn('#someState')
  }
}
// ...
```
#1456 8fcbddd51 Thanks @davidkpiano! - There is now support for higher-level guards, which are guards that can compose other guards:
- and([guard1, guard2, /* ... */]) returns true if all guards evaluate to truthy, otherwise false
- or([guard1, guard2, /* ... */]) returns true if any guard evaluates to truthy, otherwise false
- not(guard1) returns true if a single guard evaluates to false, otherwise true
```
import { and, or, not } from 'xstate/guards';

const someMachine = createMachine({
  // ...
  on: {
    EVENT: {
      target: 'somewhere',
      guard: and([
        'stringGuard',
        or([{ type: 'anotherGuard' }, not(() => false)])
      ])
    }
  }
});
```

#2824 515cdc9c1 Thanks @davidkpiano! - Actions and guards that follow eventless transitions will now receive the event that triggered the transition instead of a "null" event ({ type: '' }), which no longer exists:

// ...
states: {
  a: {
    on: {
      SOME_EVENT: 'b'
    }
  },
  b: {
    always: 'c'
  },
  c: {
    entry: [(_, event) => {
      // event.type is now "SOME_EVENT", not ""
    }]
  }
}
// ...

#1240 6043a1c28 Thanks @davidkpiano! - The in: '...' transition property can now be replaced with stateIn(...) and stateNotIn(...) guards, imported from xstate/guards:
```
import {
  createMachine,
+ stateIn
} from 'xstate/guards';

const machine = createMachine({
  // ...
  on: {
    SOME_EVENT: {
      target: 'anotherState',
-     in: '#someState',
+     cond: stateIn('#someState')
    }
  }
})
```
The stateIn(...) and stateNotIn(...) guards also can be used the same way as state.matches(...):
```
// ...
SOME_EVENT: {
  target: 'anotherState',
  cond: stateNotIn({ red: 'stop' })
}
```
An error will now be thrown if the assign(...) action is executed when the context is undefined. Previously, there was only a warning.

The SCXML event error.execution will be raised if assignment in an assign(...) action fails.

Error events raised by the machine will be thrown if there are no error listeners registered on a service via service.onError(...).
#2824 6a6b2b869 Thanks @davidkpiano! - Eventless transitions must now be specified in the always: { ... } object and not in the on: { ... } object:
```
someState: {
  on: {
    // Will no longer work
-   '': { target: 'anotherState' }
  },
+ always: { target: 'anotherState' }
}
```

#2484 0b49437b1 Thanks @davidkpiano! - Parameterized actions now require a params property:

// ...
entry: [
  {
    type: 'greet',
-   message: 'Hello'
+   params: { message: 'Hello' }
  }
]
// ...

#987 0e24ea6d6 Thanks @davidkpiano! - The internal property will no longer have effect for transitions on atomic (leaf-node) state nodes. In SCXML, internal only applies to complex (compound and parallel) state nodes:

Determines whether the source state is exited in transitions whose target state is a descendant of the source state. See 3.13 Selecting and Executing Transitions for details.
```
// ...
green: {
  on: {
    NOTHING: {
-     target: 'green',
-     internal: true,
      actions: doSomething
    }
  }
}
```
#987 04e89f90f Thanks @davidkpiano! - The history resolution algorithm has been refactored to closely match the SCXML algorithm, which changes the shape of state.historyValue to map history state node IDs to their most recently resolved target state nodes.

#2882 0096d9f7a Thanks @davidkpiano! - The state.history property has been removed. This does not affect the machine "history" mechanism.

Storing previous state should now be done explicitly:

let previousState;

const service = interpret(someMachine)
  .onTransition(state => {
    // previousState represents the last state here

    // ...

    // update the previous state at the end
    previousState = state;
  })
  .start();

#1456 8fcbddd51 Thanks @davidkpiano! - BREAKING: The cond property in transition config objects has been renamed to guard. This unifies terminology for guarded transitions and guard predicates (previously called "cond", or "conditional", predicates):
```
someState: {
  on: {
    EVENT: {
      target: 'anotherState',
-     cond: 'isValid'
+     guard: 'isValid'
    }
  }
}
```

#2060 b200e0e0b Thanks @davidkpiano! - The Machine() function has been removed. Use the createMachine() function instead.

-import { Machine } from 'xstate';
+import { createMachine } from 'xstate';

-const machine = Machine({
+const machine = createMachine({
  // ...
});

#3148 7a68cbb61 Thanks @davidkpiano! - spawn is no longer importable from xstate. Instead you get it in assign like this:
```
assign((ctx, ev, { spawn }) => {
  return {
    ...ctx,
    actorRef: spawn(promiseActor)
  };
});
```
In addition to that, you can now spawn actors defined in your implementations object, in the same way that you were already able to do that with invoke. To do that just reference the defined actor like this:
```
spawn('promiseActor');
```
#2869 9437c3de9 Thanks @davidkpiano! - The service.batch(events) method is no longer available.
#2191 0038c7b1e Thanks @davidkpiano! - The StateSchema type has been removed from all generic type signatures.
#3148 7a68cbb61 Thanks @davidkpiano! - EmittedFrom type helper has been renamed to SnapshotFrom.
#1163 390eaaa52 Thanks @davidkpiano! - Breaking: The state.children property is now a mapping of invoked actor IDs to their ActorRef instances.

Breaking: The way that you interface with invoked/spawned actors is now through ActorRef instances. An ActorRef is an opaque reference to an Actor, which should be never referenced directly.

Breaking: The origin of an SCXML.Event is no longer a string, but an ActorRef instance.

#3148 7a68cbb61 Thanks @davidkpiano! - The services option passed as the second argument to createMachine(config, options) is renamed to actors. Each value in actors should be a function that takes in context and event and returns a [behavior](TODO: link) for an actor. The provided behavior creators are:

fromMachine
fromPromise
fromCallback
fromObservable
fromEventObservable

import { createMachine } from 'xstate';
+import { fromPromise } from 'xstate/actors';

const machine = createMachine(
  {
    // ...
    invoke: {
      src: 'fetchFromAPI'
    }
  },
  {
-   services: {
+   actors: {
-     fetchFromAPI: (context, event) => {
+     fetchFromAPI: (context, event) => fromPromise(() => {
        // ... (return a promise)
      })
    }
  }
);

#878 e09efc720 Thanks @Andarist! - Support for compound string state values has been dropped from Machine's transition method. It's no longer allowed to call transition like this - machine.transition('a.b', 'NEXT'), instead it's required to use "state value" representation like this - machine.transition({ a: 'b' }, 'NEXT').
#898 025a2d6a2 Thanks @davidkpiano! - - Breaking: activities removed (can be invoked)

Since activities can be considered invoked services, they can be implemented as such. Activities are services that do not send any events back to the parent machine, nor do they receive any events, other than a "stop" signal when the parent changes to a state where the activity is no longer active. This is modeled the same way as a callback service is modeled.
#878 e09efc720 Thanks @Andarist! - Removed previously deprecated config properties: onEntry, onExit, parallel and forward.
#2876 c99bb43af Thanks @davidkpiano! - Typings for Typestate have been removed. The reason for this is that types for typestates needed to be manually specified, which is unsound because it is possible to specify impossible typestates; i.e., typings for a state's value and context that are impossible to achieve.
#2840 fc5ca7b7f Thanks @davidkpiano! - Invoked/spawned actors are no longer available on service.children - they can only be accessed from state.children.
#1811 5d16a7365 Thanks @davidkpiano! - Prefix wildcard event descriptors are now supported. These are event descriptors ending with ".*" which will match all events that start with the prefix (the partial event type before ".*"):
```
// ...
on: {
  'mouse.click': {/* ... */},
  // Matches events such as:
  // "pointer.move"
  // "pointer.move.out"
  // "pointer"
  'pointer.*': {/* ... */}
}
// ...
```
Note: wildcards are only valid as the entire event type ("*") or at the end of an event type, preceded by a period (".*"):
- ✅ "*"
- ✅ "event.*"
- ✅ "event.something.*"
- ❌ ~~"event.*.something"~~
- ❌ ~~"event*"~~
- ❌ ~~"event*.some*thing"~~
- ❌ ~~"*.something"~~
#1456 8fcbddd51 Thanks @davidkpiano! - The interface for guard objects has changed. Notably, all guard parameters should be placed in the params property of the guard object:

Example taken from Custom Guards:
```
-cond: {
+guard: {
- name: 'searchValid', // `name` property no longer used
  type: 'searchValid',
- minQueryLength: 3
+ params: {
+   minQueryLength: 3
+ }
}
```
#1054 53a594e9a Thanks @Andarist! - Machine#transition no longer handles invalid state values such as values containing non-existent state regions. If you rehydrate your machines and change machine's schema then you should migrate your data accordingly on your own.
#1002 31a0d890f Thanks @Andarist! - Removed support for service.send(type, payload). We are using send API at multiple places and this was the only one supporting this shape of parameters. Additionally, it had not strict TS types and using it was unsafe (type-wise).

Minor Changes

#3148 7a68cbb61 Thanks @davidkpiano! - onSnapshot is now available for invoke configs. You can specify a transition there to be taken when a snapshot of an invoked actor gets updated. It works similarly to onDone/onError.
#1041 b24e47b9e Thanks @Andarist! - Support for specifying states deep in the hierarchy has been added for the initial property. It's also now possible to specify multiple states as initial ones - so you can enter multiple descandants which have to be parallel to each other. Keep also in mind that you can only target descendant states with the initial property - it's not possible to target states from another regions.

Those are now possible:
```
{
  initial: '#some_id',
  initial: ['#some_id', '#another_id'],
  initial: { target: '#some_id' },
  initial: { target: ['#some_id', '#another_id'] },
}
```
#1028 0c6cfee9a Thanks @Andarist! - Added support for expressions to cancel action.
#898 c9cda27cb Thanks @davidkpiano! - Added interop observable symbols to ActorRef so that actor refs are compatible with libraries like RxJS.

@xstate/react@4.0.0-alpha.0

Major Changes

#3148 7a68cbb61 Thanks @davidkpiano! - Removed getSnapshot parameter from hooks. It is expected that the received actorRef has to have a getSnapshot method on it that can be used internally.

Patch Changes

Updated dependencies [7f3b84816, 969a2f4fc, c0a6dcafa, 7a68cbb61, 172d6a7e1, 31bc73e05, e09efc720, 145539c4c, 3de36bb24, 9e10660ec, 8fcbddd51, 515cdc9c1, 6043a1c28, 6a6b2b869, 0b49437b1, 0e24ea6d6, 04e89f90f, 0096d9f7a, 8fcbddd51, b200e0e0b, 7a68cbb61, 9437c3de9, 0038c7b1e, 7a68cbb61, b24e47b9e, 390eaaa52, 7a68cbb61, 0c6cfee9a, e09efc720, 025a2d6a2, e09efc720, c99bb43af, fc5ca7b7f, c9cda27cb, 5d16a7365, 8fcbddd51, 53a594e9a, 31a0d890f]:
- xstate@5.0.0-alpha.0

@xstate/vue@3.0.0-alpha.0

Major Changes

#3148 7a68cbb61 Thanks @davidkpiano! - Removed getSnapshot parameter from composables. It is expected that the received actorRef has to have a getSnapshot method on it that can be used internally.

Patch Changes

Updated dependencies [7f3b84816, 969a2f4fc, c0a6dcafa, 7a68cbb61, 172d6a7e1, 31bc73e05, e09efc720, 145539c4c, 3de36bb24, 9e10660ec, 8fcbddd51, 515cdc9c1, 6043a1c28, 6a6b2b869, 0b49437b1, 0e24ea6d6, 04e89f90f, 0096d9f7a, 8fcbddd51, b200e0e0b, 7a68cbb61, 9437c3de9, 0038c7b1e, 7a68cbb61, b24e47b9e, 390eaaa52, 7a68cbb61, 0c6cfee9a, e09efc720, 025a2d6a2, e09efc720, c99bb43af, fc5ca7b7f, c9cda27cb, 5d16a7365, 8fcbddd51, 53a594e9a, 31a0d890f]:
- xstate@5.0.0-alpha.0

codesandbox-ci · 2019-12-30T21:40:37Z

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit 9b28377:

Sandbox	Source
cranky-fermat-0ebzo	Configuration
wonderful-archimedes-o1idg	Configuration

codesandbox-ci · 2022-05-26T13:17:41Z

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit e95f0dc:

Sandbox	Source
XState Example Template	Configuration
XState React Template	Configuration

github-actions bot force-pushed the changeset-release/next branch 2 times, most recently from 25a01c3 to 93a0d8f Compare December 30, 2019 21:38

github-actions bot force-pushed the changeset-release/next branch 5 times, most recently from 2f36204 to 3a6a6b0 Compare January 6, 2020 04:54

github-actions bot force-pushed the changeset-release/next branch 2 times, most recently from 545a5a8 to 1f3bcce Compare January 19, 2020 20:54

github-actions bot force-pushed the changeset-release/next branch 6 times, most recently from 81244f9 to 752b6d5 Compare February 8, 2020 19:56

github-actions bot force-pushed the changeset-release/next branch 8 times, most recently from 6b42438 to f57f739 Compare February 17, 2020 13:54

github-actions bot force-pushed the changeset-release/next branch 6 times, most recently from f1f9f1a to 2d51976 Compare February 22, 2020 19:23

github-actions bot force-pushed the changeset-release/next branch 2 times, most recently from b985519 to 3ee090b Compare January 3, 2022 14:44

github-actions bot force-pushed the changeset-release/next branch 5 times, most recently from eba57c4 to 5ce7779 Compare January 16, 2022 00:20

github-actions bot force-pushed the changeset-release/next branch from 5ce7779 to 73632ae Compare January 26, 2022 01:12

github-actions bot force-pushed the changeset-release/next branch 3 times, most recently from 1042a44 to 6200a3a Compare March 7, 2022 15:45

github-actions bot force-pushed the changeset-release/next branch from 6200a3a to bacc92b Compare March 11, 2022 04:46

github-actions bot force-pushed the changeset-release/next branch 3 times, most recently from 9292cf9 to 4976ced Compare March 29, 2022 12:19

github-actions bot force-pushed the changeset-release/next branch from 4976ced to ff6795c Compare April 11, 2022 15:03

github-actions bot force-pushed the changeset-release/next branch from ff6795c to a47a3e9 Compare April 28, 2022 10:52

github-actions bot force-pushed the changeset-release/next branch from a47a3e9 to 52aa919 Compare May 26, 2022 10:11

Andarist force-pushed the next branch 2 times, most recently from 0c89c96 to 98a7202 Compare May 26, 2022 12:12

github-actions bot force-pushed the changeset-release/next branch 2 times, most recently from 9b93e3d to 960776b Compare May 26, 2022 13:10

github-actions bot changed the title ~~Version Packages (next)~~ Version Packages (alpha) May 26, 2022

github-actions bot force-pushed the changeset-release/next branch from 960776b to aa3e8f1 Compare May 26, 2022 13:14

Version Packages (alpha)

e95f0dc

github-actions bot force-pushed the changeset-release/next branch from aa3e8f1 to e95f0dc Compare May 26, 2022 13:17

Andarist merged commit d0a9015 into next May 26, 2022

Andarist deleted the changeset-release/next branch May 26, 2022 13:21

LekoArts mentioned this pull request Nov 1, 2023

chore(repo): Enter changesets Pre mode (for v5) clerk/javascript#1970

Merged

24 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Version Packages (alpha) #902

Version Packages (alpha) #902

github-actions bot commented Dec 28, 2019 •

edited

Loading

codesandbox-ci bot commented Dec 30, 2019 •

edited

Loading

codesandbox-ci bot commented May 26, 2022

Version Packages (alpha) #902

Version Packages (alpha) #902

Conversation

github-actions bot commented Dec 28, 2019 • edited Loading

Releases

xstate@5.0.0-alpha.0

Major Changes

Minor Changes

@xstate/react@4.0.0-alpha.0

Major Changes

Patch Changes

@xstate/vue@3.0.0-alpha.0

Major Changes

Patch Changes

codesandbox-ci bot commented Dec 30, 2019 • edited Loading

codesandbox-ci bot commented May 26, 2022

github-actions bot commented Dec 28, 2019 •

edited

Loading

codesandbox-ci bot commented Dec 30, 2019 •

edited

Loading