docs: rewrite README for v3 with StateChart as primary API

Showcase the full range of statechart capabilities: compound states,
parallel regions, history pseudo-states, eventless transitions, guards,
error handling, and async support — all using the new StateChart class.

Author: fgmacedo