waterfall
Use for ordered steps with a signed delta (y). Paint a running baseline; keep input order. series is ignored.
Do not use for independent category comparisons (bar) or non-negative stage drop-off (funnel).
x step · y signed delta · series ignored
Rules. Keep order. Each bar is labeled with the delta and the level after it. Optional role column marks total or subtotal. Duplicate step labels are allowed.
Example
chart
markvis: 2
type: waterfall
title: Concessions still cover Midtown rent after payroll
unit: USD k
x: step
y: delta
step,delta
Ticket sales,180
Concessions,64
Payroll,-90
Rent,-42
Utilities,-12| step | delta |
|---|---|
| Ticket sales | 180 |
| Concessions | 64 |
| Payroll | -90 |
| Rent | -42 |
| Utilities | -12 |
When the block is wrong
The rows stay, with one line that names the error.
chart
markvis: 2
type: waterfall
innerRadius: 0.4
title: Wrong-type extra field
x: step
y: delta
step,delta
Open,80
Cost,-20| step | delta |
|---|---|
| Open | 80 |
| Cost | -20 |
E_UNKNOWN_FIELD: undeclared fence field: innerRadius
Generated from packages/types/waterfall/ and the type's row in SPEC.md.