TransportButton

G2G7

A persistent surface control: icon · micro-label · printed key · pressed tone. Density-aware — compacts to a 32px icon under data-density="bench". Held keys sit physically sunken.

Posture

Resting · held (sunken) · danger · disabled

Bench density — the label moves into the tooltip

npx candlelight-ds add transport-button

Use when: Always-visible surface-level controls — console zones, transport rows.
Don't use when: One-off form/header actions (Button) or one-shots (Pad).
States: restingpressed/held (sunken)danger pressed (the stop family)disabled (dark, honest)bench density (icon only)
Acceptance: hotkey is optional — never print a key that doesn't work (G2).
Only the stop family wears danger.
A held toggle sits sunken (edge-sunken), not tinted.

Raw twin: /components/transport-button.md·Registry item: /r/transport-button.json