Sound design vocabulary

Eight canonical UI audio cues — focus, hover, press, success, error, notify, voice-wake, voice-end. Slice 1 ships Web Audio-synthesized previews; samples follow owner curation.

The eight cues

Each swatch plays the synthesized cue on demand. Default state, duration, and visual-twin pairing live in the spec; the click here is an explicit affordance and is NOT silenced by per-cue toggles.

focus Default OFF 60 ms

Focus

Pair: visible focus ring (policies/focus-management.kmd)

hover Default OFF 60 ms

Hover

Pair: hover state (existing)

press Default OFF 80 ms

Press

Pair: press state (existing)

success Default ON 180 ms

Success

Pair: success toast (errors/user-facing-messages.kmd § success)

error Default ON 180 ms

Error

Pair: error toast (mandatory)

notify Default OFF 220 ms

Notify

Pair: badge / toast

voice-wake Default ON 140 ms

Voice wake

Pair: mic indicator (voice/wake-word.kmd § Visual feedback)

voice-end Default ON 140 ms

Voice end

Pair: mic indicator hides

Settings

Master mute and global gain are persisted in localStorage under "koder.sound". SDK consumers honor the same key. OS-level mute (silent switch / DND) overrides everything.

Master mute Gain (0 – 1)

Contract

Every cue MUST have a visual twin (toast / focus ring / mic indicator / etc.). See sound/vocabulary.kmd § R5 — playing a cue without its visual twin fails audit.