Diagrams
LifecycleFigure
A state machine: what something can be, and what moves it between states.
Ships from@misoto22/design/diagrams
When to reach for it
Examples
default
A job run
6 elements and 3 relationships. The only figure that spends colour, on the two outcomes.
- Queued (start) — accepted
- Running (active) — tool calls
- Review (decision) — quality gate
- Completed (success) — final answer
- Blocked (waiting) — missing input
- Failed (failure) — timed out
- Review → Blocked: needs input
- Blocked → Failed: expired — after 24h
- Blocked → Running: answered
Notes
A state machine: what something can BE, and what moves it.
The one figure here that spends colour, and it spends exactly the two tokens this system reserves for state: --success on a terminal success, --danger on a terminal failure. Nothing else in the package is allowed those two, and a lifecycle diagram is the case they were reserved for — the whole point of the picture is which end a run came out of.
The other six kinds are carried by shape, so a greyscale print loses the two outcomes' hue and keeps every other distinction: a start is a filled cap, a decision is a diamond, a wait is a dashed frame, an external is a plate with a cut corner.
A RECOVERABLE FAILURE IS A FAILURE WITH A WAY BACK. type: "failure" says how a state is drawn; a transition OUT of it is what says whether the run is over. A retryable error and a terminal one look identical until you follow the arrows, which is correct — the difference between them is a real edge in the machine, not an adjective on a box.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| specrequired | LifecycleSpec | — |
Also accepts everything in FigureChrome. Those are forwarded to the underlying element and are not listed row by row.
Accessibility
- success and failure are the only coloured marks in the package’s diagrams, and each is also a distinct plate shape — colour is never the only carrier.
- The main rail is drawn between consecutive states in the first lane even when the specification does not list those transitions, because they are the diagram’s spine rather than its exceptions.