ProgressBar & Meter
ProgressBar moves toward something that ends; Meter moves toward a wall, colouring itself as a quota fills.
import { ProgressBar, Meter } from '@objectifthunes/whiteboard'
<ProgressBar label="Uploading cover.png" value={pct} showValue />
<ProgressBar label="Rebuilding index" /> {/* no value: indeterminate sweep */}
<ProgressBar value={64} size="sm" aria-label="Row progress" />
<Meter
label="Seats"
value={used}
max={10}
format={(v, m) => `${v} of ${m} seats`}
footnote="Adding a seat is prorated to your renewal."
/>The two look similar and mean different things. Progress moves toward something good and ends; usage moves toward a wall. That is why Meter colours itself as it fills — warning at 75%, danger at 90% by default — and ProgressBar does not.
Omit valuefor the indeterminate sweep. Use it honestly: it means "in progress, duration unknown". A fake bar that crawls to 90% and waits is worse than a spinner.
Going over max shows a full danger bar rather than clipping silently, because overage is exactly the moment the user needs to see it. Drag the slider past 10, or look at the builds meter.
format owns the readout, so units and rounding stay yours — formatFileSize from FileDrop pairs well for storage quotas. Move the slider to watch the tone change.