KQ-798 · CHECKPOINT/RAIL
Checkpoint Rail
A rail of checkpoints above the steps of a run, where steps that carry a checkpoint label become evenly spaced stops and a head ring rides the track at the latest one. Pressing an earlier stop rewinds: the head slides back on glide and the fill retracts with it while every later step folds up, its height closing on glide as its text lifts on the exit ease in a cascade that runs from the bottom up, and the stops past the rewind fade while the rest re-space on glide. The stops are buttons in a roving tabindex — Left and Right step, Home and End jump, Enter and Space rewind — and the host truncates its steps from onRewind.
No steps yet.
Idle · press play
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/checkpoint-rail
Props
- steps
- RailStep[]
- default —
- The run so far, oldest first: id, text, an optional agent, and an optional checkpoint label that makes the step a stop on the rail.
- onRewind
- (stepId: string, discarded: number) => void
- default —
- Fires from a stop press or key with the checkpoint step's id and how many steps follow it; keep steps up to and including that id.
- label
- string
- default —
- Names the rail and the list for assistive technology.
| Prop | Type | Default | Description |
|---|---|---|---|
| steps | RailStep[] | — | The run so far, oldest first: id, text, an optional agent, and an optional checkpoint label that makes the step a stop on the rail. |
| onRewind | (stepId: string, discarded: number) => void | — | Fires from a stop press or key with the checkpoint step's id and how many steps follow it; keep steps up to and including that id. |
| label | string | — | Names the rail and the list for assistive technology. |