KQ-701 · CREDIT/DIAL
Credit Dial
A 240° dial banded from poor to excellent whose needle sweeps to the score on glide and settles without a wobble; the figure under the hub is derived from the same motion value, so it counts exactly as fast as the needle turns. While the needle moves the band label is withheld; when the spring settles the band fades in on the enter ease and, given a previous reading, a change chip arrives beside it on snap — the same physics up or down. It is a role="meter" that announces the settled reading once; nothing takes focus.
KQ-701 · CREDIT/DIAL
Basin score
Basin score sweeping to 612
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/credit-dial
Props
- score
- number
- default —
- The reading the needle sweeps to.
- previous
- number
- default —
- The last reading; given it, the change chip shows the move.
- min
- number
- default 0
- Floor of the scale.
- max
- number
- default 1000
- Ceiling of the scale.
- bands
- CreditBand[]
- default five bands, poor to excellent
- Ascending { label, from, tone } bands; each colours its own segment of the arc.
- sweepOnMount
- boolean
- default true
- Sweep up from the floor on first paint rather than starting at the score.
- onSettle
- (score: number) => void
- default —
- Fires when the needle has settled on a score.
- label
- string
- default Score
- Names the meter; printed above the dial.
| Prop | Type | Default | Description |
|---|---|---|---|
| score | number | — | The reading the needle sweeps to. |
| previous | number | — | The last reading; given it, the change chip shows the move. |
| min | number | 0 | Floor of the scale. |
| max | number | 1000 | Ceiling of the scale. |
| bands | CreditBand[] | five bands, poor to excellent | Ascending { label, from, tone } bands; each colours its own segment of the arc. |
| sweepOnMount | boolean | true | Sweep up from the floor on first paint rather than starting at the score. |
| onSettle | (score: number) => void | — | Fires when the needle has settled on a score. |
| label | string | Score | Names the meter; printed above the dial. |