Tooltip

G10

The explanation layer — one line of words on a 400ms delay. The Kbd chip carries the key; this carries the words. title= is lint-banned in its favor.

Posture

Hover or focus — 400ms, one line of words

npx candlelight-ds add tooltip

Use when: An icon-only control needs a name, or a control needs one line of context.
Don't use when: The content is interactive (Menu/Overlay) or essential to completing the task (put it in the UI).
States: closedopen (400ms delay)disabled passthrough
Keyboard: Focusshows after delay; Esc hides
Acceptance: Mandatory on every icon-only button (with aria-label).
One line of explanation, never the key itself.