- renamed State.on to State.onStream
- improved some docs
- improved class docs
- add a future transition