Sound
The synthesised UI vocabulary (tick, confirm, complete, gentle error) with Web Audio, no audio files. One global switch, off by default and remembered per viewer, that never sounds before a user gesture even when remembered on. Paired haptics on the same rules.
quiet warm playful
npx @susegad/cli add sound
The synthesised UI vocabulary, the global switch and paired haptics. See
docs/decisions/0015-sound-consent-and-av-packages.md for the two kinds of
sound and their two kinds of consent, and SKILL.md §5/§6 once it covers
sound, for how to use the switch on a page.
import { soundOn, setSoundOn, onSoundChange, play, haptic } from './index.js';
// inside a user-gesture handler, e.g. a switch control's change event
button.addEventListener('click', () => setSoundOn(!soundOn()));
// anywhere, any time: a no-op unless the switch is on and a gesture has happened
play('confirm', { register: 'warm' });
haptic('confirm');
switch.jsowns the on/off state (localStorage['sg-sound'], every access wrapped in try/catch), the one sharedAudioContext, and the rule that nothing plays before the first gesture on the page.patches.jsis pure data: which of the four words (tick, confirm, complete, error) each register plays, and how loud. Runs and is tested in Node.player.jsis the thin, side-effecting half: it turns a patch into oscillators and gain envelopes on a context that already exists.haptics.jspairs anavigator.vibratepattern to each word, pure data.scapes/holds the soundscapes (Paus rain, Rampon koel), which a scene imports on its own; they are not part of this package's bundle.
Budget: 14 KB of behaviour source for the whole package (switch, patches, player, haptics), same figure as a component's behaviour allowance (0009) since this is the layer every sound-making piece in the library sits on.
Bake and reflow
A scene that moves with the sound does not need an FFT every frame. Read the
spectrum once, keep it as a small table, and let every frame be arithmetic.
bake/ (the sound-bake item) does this: bakeBuffer(buffer) or
bakeFrames(bins) bakes once, drive(cache, ms) gives a 0 to 1 intensity at any
moment, and reduced motion gets one steady value (the median moment) instead of a pulse.
import { bakeBuffer, drive } from './bake/bake.core.js';
const chapter = bakeBuffer(audioBuffer); // once; nothing plays
const glow = drive(chapter, ms, { reducedMotion }); // each frame; 0..1
Consent is unchanged (decision 0015): baking never creates, resumes or starts
audio and never reads the switch. It reads a buffer or an analyser the page
already has. See bake/bake.docs.md.