React Version Picker
The question is never "which revision is newest" — it is "do I need to re-read it". That is answered by the changes, so the changes are the interface.
KLV-7000 Datasheet
3 revisions · current is Rev C
Initial advance-information release.
Initial release — no prior changes recorded.
Installation
Props
| Prop | Type | Description |
|---|---|---|
| documentTitle | string | Document name |
| versions | DocVersion[] | { revision, released, current?, summary?, changes?, href? } |
| defaultRevision | string | Revision selected on mount |
Counting what you missed
Selecting an older revision does more than switch a download link: the component walks every revision between the one you are viewing and the current one, totals the changes, and counts how many are marked breaking. The banner then says something actionable — "2 revisions behind, 6 changes since, including 2 that may affect an existing design" — instead of a generic "a newer version is available".
DocChange.breaking is the flag that matters. In hardware documentation a "breaking" change is not an API break; it is a number that can invalidate a design already in progress, like the ML-KEM latency correction or the ball reassignment in the demo. Those deserve a different visual weight from a clarified paragraph, and they get one.
Note that current is an explicit flag rather than "the first entry". Occasionally the newest published revision is not the recommended one — a withdrawn release, or an errata pending — and hard-coding "newest = current" makes that impossible to express.
New components every week
Get the week's new Kelvin UI components and templates in one short email. No spam, unsubscribe anytime.