KQ-810 · SAMPLE/WHEEL

Sample Wheel

Evaluation samples as chips around a rim inside a square that clips its corners. The ring turns so the chosen sample sits at the front under a fixed notch: Prev, Next and the arrow keys turn it one detent on snap while every chip counter-rotates from the same angle so its label stays upright, and dragging anywhere on the ring turns it with the pointer, capture taken only after four pixels, release settling to the nearest detent on snap and choosing what landed at the front. Failed samples carry a danger tick outside their chip and a danger stroke; the hub reads the front sample with its score rolling on snap, and beneath it the title and score bars fill on glide.

KQ-810 · SAMPLE/WHEEL

Basinworks Scout · smoke run

Late parcel refund

Accuracy91
Tone86
Brevity87

Sample S-01 · 88 · pass · 3 of 12 failed

Install

One command — the source lands in your repo. Or copy it from the Code tab.

$ pnpm dlx shadcn@latest add @kinetiq/sample-wheel

Props

samples: WheelSample[]; default —; Clockwise from the front: { id, label, title, score, passed, scores }; scores is up to three { name, value } on 0–100.
value / defaultValue: string; default the first sample's id; Controlled or initial sample id.
onValueChange: (id: string) => void; default —; Fires from the step, key, chip press or drag release that changed the pick.
label: string; default —; Names the wheel for assistive technology.
className: string; default —; Layout overrides on the frame.

Prop	Type	Default	Description
samples	WheelSample[]	—	Clockwise from the front: { id, label, title, score, passed, scores }; scores is up to three { name, value } on 0–100.
value / defaultValue	string	the first sample's id	Controlled or initial sample id.
onValueChange	(id: string) => void	—	Fires from the step, key, chip press or drag release that changed the pick.
label	string	—	Names the wheel for assistive technology.
className	string	—	Layout overrides on the frame.