KQ-840 · GUARD/RAIL
Guard Rail
A rail that shows how close a conversation stands to a boundary: a round marker and the fill behind it move on glide as each message raises the proximity, taking the warn tone past warnAt, and a value of 1 or more is a crossing — that last stretch runs on recoil so the marker hits the line, overshoots into it and bounces back to rest against it, while the line flashes and the reason unfolds beneath in a measured frame. It is a role="meter" with the distance in words, and an sr-only status announces near and crossed once each.
KQ-840 · GUARD/RAIL
Waiting for the first message.
In boundsHouse policy 4.2
No messages yet
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/guard-rail
Props
- proximity
- number
- default —
- How close the conversation stands to the line: 0 is far, 1 or more has crossed.
- boundary
- string
- default —
- The line's name, printed at the rail's end.
- reason
- string
- default —
- Why the line stopped the thread, shown when crossed.
- warnAt
- number
- default 0.7
- Fraction past which the rail turns warn.
- label
- string
- default —
- Names the rail for assistive technology.
| Prop | Type | Default | Description |
|---|---|---|---|
| proximity | number | — | How close the conversation stands to the line: 0 is far, 1 or more has crossed. |
| boundary | string | — | The line's name, printed at the rail's end. |
| reason | string | — | Why the line stopped the thread, shown when crossed. |
| warnAt | number | 0.7 | Fraction past which the rail turns warn. |
| label | string | — | Names the rail for assistive technology. |