SegmentedControl

2–4 visible exclusive options. More than 4 or an unknown count belongs in a Select/Combobox.

npx candlelight-ds add segmented-control

Use when

Switching between a few exclusive views or modes.

Don't use when

More than 4 options, unknown counts, or navigation.

States

selected (fill-active)unselected (hover ramp)with counts

Keyboard

• click/tabswitches; selection is immediate (optimistic)

Acceptance

• The selected segment sits on fill-active; the rest ride the hover ramp.

Raw twin: /components/segmented-control.md·Registry item: /r/segmented-control.json