Cogwheel - simple JavaScript state machines
Simple finite state machines that can be used for state/process management.
Principles
Cogwheel is build around the following principles around state machines, and the library should be used as such:
- State transitions are synchronous & fire & forget by design;
- State transisions should not have side-effects, except for debugging purposes (e.g. console-log);
- The context should be serializable;
- All state & context mutations should be owned by the machine and its actions. This means as much (business) logic as possible should be included in the machine and its actions.
Getting started
Guards
Actions
Hierarchical machines
Front-end framework implementation
State machine examples
Migration v3.x.x > v4.x.x
- Remove all
import { send, assign } from 'cogwheel';; - Replace input parameters of all actions
const exampleAction({ state, event, assign, send }) {}