@objectifthunes/whiteboard
FEEDBACK

ProgressBar & Meter

ProgressBar moves toward something that ends; Meter moves toward a wall, colouring itself as a quota fills.


PREVIEW
ProgressBar — moves toward something that ends
Uploading cover-final-v3.png12%
Rebuilding search index
Import complete100%
Meter — moves toward a wall
Seats used8
Seats8 of 10 seats
Adding a seat is prorated to your renewal.
Storage8.6 GB of 10 GB
Resets on 1 September.
Over the allowance112 of 100 builds
SOURCE
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."
/>
NOTES

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.