State diagrams

@startuml
[*] --> Idle
Idle --> Working : start
Working --> Idle : done
Working --> Failed : error
Failed --> Idle : reset
Failed --> [*] : give up
@enduml

Pseudo-states

• [*] initial and final states (context-dependent).
• <<choice>>, <<fork>>, <<join>> for branching pseudo-states.
• [H] shallow history, [H*] deep history.

Composite states

state Working {
  [*] --> Loading
  Loading --> Ready
  Ready --> [*]
}

Transitions with guards / actions

Idle --> Working : start [hasWork] / log

The text after : is parsed as a transition label; the colon-and-everything-after pattern is consistent with other families.

Mermaid stateDiagram adaptation

If you prefer Mermaid syntax:

stateDiagram-v2
  [*] --> Idle
  Idle --> Working : start
  Working --> Idle : done

puml --dialect mermaid adapts this into the same shared state model.

Browse

State examples are organized in docs/examples/state/ and surface in the gallery.