Create professional demos and 3D mockups in seconds, directly in your browser
type BaseLayer = {
offset?: number;
attack: number;
decay: number;
peak: number;
};
export type ToneLayer = BaseLayer & {
kind: "tone";
waveform: OscillatorType;
frequency: number;
detune?: number;
glideTo?: number;
glideTime?: number;
};
export type NoiseLayer = BaseLayer & {
kind: "noise";
filterType: BiquadFilterType;
filterFrequency: number;
filterQ?: number;
};
export type SoundLayer = ToneLayer | NoiseLayer;
export type Shimmer = {
delay: number;
feedback: number;
wet: number;
lowpass: number;
};
export type SoundRecipe = {
masterGain: number;
layers: SoundLayer[];
shimmer?: Shimmer;
};
export const RECIPES = {
/** A soft two-note ascending bell, like an iOS/macOS confirmation tink. */
chime: {
masterGain: 0.5,
layers: [
{ kind: "tone", waveform: "sine", frequency: 1046.5, attack: 0.006, decay: 0.22, peak: 0.09 },
{ kind: "tone", waveform: "sine", frequency: 1568, offset: 0.09, attack: 0.006, decay: 0.26, peak: 0.08 },
],
shimmer: { delay: 0.12, feedback: 0.25, wet: 0.18, lowpass: 4000 },
},
/** A quick ascending twinkle of four notes — bright and playful. */
sparkle: {
masterGain: 0.5,
layers: [
{ kind: "tone", waveform: "sine", frequency: 1760, offset: 0, attack: 0.003, decay: 0.09, peak: 0.045 },
{ kind: "tone", waveform: "sine", frequency: 2217, offset: 0.045, attack: 0.003, decay: 0.09, peak: 0.04 },
{ kind: "tone", waveform: "sine", frequency: 2637, offset: 0.09, attack: 0.003, decay: 0.1, peak: 0.038 },
{ kind: "tone", waveform: "sine", frequency: 3520, offset: 0.135, attack: 0.003, decay: 0.12, peak: 0.032 },
],
shimmer: { delay: 0.07, feedback: 0.35, wet: 0.22, lowpass: 6000 },
},
/** A single note gliding smoothly downward, like a drop of water. */
droplet: {
masterGain: 0.55,
layers: [
{ kind: "tone", waveform: "sine", frequency: 1200, glideTo: 550, glideTime: 0.14, attack: 0.004, decay: 0.2, peak: 0.075 },
],
shimmer: { delay: 0.09, feedback: 0.2, wet: 0.15, lowpass: 3000 },
},
/** A warm, slow-swelling pad from two gently detuned sines. */
bloom: {
masterGain: 0.5,
layers: [
{ kind: "tone", waveform: "sine", frequency: 528, attack: 0.06, decay: 0.32, peak: 0.06 },
{ kind: "tone", waveform: "sine", frequency: 528, detune: 12, attack: 0.06, decay: 0.34, peak: 0.05 },
],
shimmer: { delay: 0.15, feedback: 0.2, wet: 0.12, lowpass: 2500 },
},
/** A soft hush with a falling tone — for tooltips and low-priority previews. */
whisper: {
masterGain: 0.48,
layers: [
{ kind: "noise", filterType: "lowpass", filterFrequency: 1600, filterQ: 0.7, attack: 0.025, decay: 0.13, peak: 0.04 },
{ kind: "tone", waveform: "sine", frequency: 880, glideTo: 660, glideTime: 0.14, offset: 0.01, attack: 0.012, decay: 0.14, peak: 0.025 },
],
},
/** A focused, bandpass-filtered tick with a bright sine ping on top — crisp and instant. */
tick: {
masterGain: 0.4,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 5400, filterQ: 1.8, attack: 0.001, decay: 0.018, peak: 0.14 },
{ kind: "tone", waveform: "sine", frequency: 2600, attack: 0.001, decay: 0.012, peak: 0.018 },
],
},
/** A dull, muted knock — the "down" half of a press/release pair, like a key bottoming out. */
press: {
masterGain: 0.4,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 1700, filterQ: 1.4, attack: 0.001, decay: 0.02, peak: 0.13 },
],
},
/** A brighter, springier tick — the "up" half of a press/release pair, like a key returning. */
release: {
masterGain: 0.4,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 4600, filterQ: 1.8, attack: 0.001, decay: 0.016, peak: 0.12 },
{ kind: "tone", waveform: "sine", frequency: 3200, offset: 0.006, attack: 0.001, decay: 0.05, peak: 0.02 },
],
},
/** A two-part click-clack, like a mechanical switch flipping between states. */
toggle: {
masterGain: 0.4,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 2200, filterQ: 1.6, attack: 0.001, decay: 0.016, peak: 0.12 },
{ kind: "noise", filterType: "bandpass", filterFrequency: 3800, filterQ: 1.6, offset: 0.024, attack: 0.001, decay: 0.02, peak: 0.1 },
],
},
/** A short, warm three-note ascending confirmation — "done", not a fanfare. */
success: {
masterGain: 0.5,
layers: [
{ kind: "tone", waveform: "sine", frequency: 880, attack: 0.004, decay: 0.09, peak: 0.06 },
{ kind: "tone", waveform: "sine", frequency: 1108.73, offset: 0.06, attack: 0.004, decay: 0.1, peak: 0.06 },
{ kind: "tone", waveform: "sine", frequency: 1318.51, offset: 0.12, attack: 0.004, decay: 0.18, peak: 0.07 },
],
shimmer: { delay: 0.1, feedback: 0.22, wet: 0.16, lowpass: 4500 },
},
/** A muted knock followed by two descending tones — a calm, recoverable refusal. */
error: {
masterGain: 0.42,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 850, filterQ: 1.1, attack: 0.001, decay: 0.035, peak: 0.13 },
{ kind: "tone", waveform: "triangle", frequency: 440, offset: 0.025, attack: 0.004, decay: 0.09, peak: 0.045 },
{ kind: "tone", waveform: "triangle", frequency: 349.23, offset: 0.1, attack: 0.004, decay: 0.14, peak: 0.04 },
],
},
/** A papery filtered flick with a tiny glass tick — for pages, galleries, and carousels. */
page: {
masterGain: 0.38,
layers: [
{ kind: "noise", filterType: "lowpass", filterFrequency: 1800, filterQ: 0.7, attack: 0.006, decay: 0.08, peak: 0.11 },
{ kind: "noise", filterType: "bandpass", filterFrequency: 4200, filterQ: 1.2, offset: 0.04, attack: 0.004, decay: 0.065, peak: 0.08 },
{ kind: "tone", waveform: "sine", frequency: 2400, offset: 0.075, attack: 0.002, decay: 0.045, peak: 0.02 },
],
},
/** A brief unresolved lift — signals that user-initiated work has started. */
loading: {
masterGain: 0.42,
layers: [
{ kind: "noise", filterType: "lowpass", filterFrequency: 1400, filterQ: 0.6, attack: 0.035, decay: 0.14, peak: 0.035 },
{ kind: "tone", waveform: "sine", frequency: 420, glideTo: 630, glideTime: 0.18, attack: 0.025, decay: 0.18, peak: 0.05 },
],
shimmer: { delay: 0.11, feedback: 0.18, wet: 0.12, lowpass: 2800 },
},
/** A quick lock-on sweep resolving to a clear tone — the system is ready. */
ready: {
masterGain: 0.48,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 3600, filterQ: 1.8, attack: 0.001, decay: 0.02, peak: 0.11 },
{ kind: "tone", waveform: "triangle", frequency: 330, glideTo: 660, glideTime: 0.12, offset: 0.012, attack: 0.004, decay: 0.16, peak: 0.055 },
{ kind: "tone", waveform: "sine", frequency: 990, offset: 0.13, attack: 0.004, decay: 0.22, peak: 0.06 },
],
shimmer: { delay: 0.1, feedback: 0.16, wet: 0.1, lowpass: 4200 },
},
/** A compact synthetic chirp — crisp feedback for primary buttons and controls. */
pulse: {
masterGain: 0.42,
layers: [
{ kind: "noise", filterType: "bandpass", filterFrequency: 2600, filterQ: 2.4, attack: 0.001, decay: 0.022, peak: 0.08 },
{ kind: "tone", waveform: "triangle", frequency: 620, glideTo: 1240, glideTime: 0.07, attack: 0.002, decay: 0.085, peak: 0.055 },
],
},
/** A fast three-step locator signal — playful feedback for menus and secondary buttons. */
scan: {
masterGain: 0.4,
layers: [
{ kind: "tone", waveform: "sine", frequency: 740, attack: 0.002, decay: 0.055, peak: 0.05 },
{ kind: "tone", waveform: "sine", frequency: 1110, offset: 0.045, attack: 0.002, decay: 0.055, peak: 0.045 },
{ kind: "tone", waveform: "sine", frequency: 1665, offset: 0.09, attack: 0.002, decay: 0.07, peak: 0.04 },
],
shimmer: { delay: 0.065, feedback: 0.16, wet: 0.1, lowpass: 4200 },
},
/** A rising harmonic portal with a soft tail — for client-side page arrivals. */
arrival: {
masterGain: 0.44,
layers: [
{ kind: "noise", filterType: "lowpass", filterFrequency: 900, filterQ: 0.8, attack: 0.05, decay: 0.24, peak: 0.035 },
{ kind: "tone", waveform: "sine", frequency: 220, glideTo: 440, glideTime: 0.32, attack: 0.04, decay: 0.34, peak: 0.055 },
{ kind: "tone", waveform: "sine", frequency: 659.25, offset: 0.12, attack: 0.045, decay: 0.32, peak: 0.04 },
{ kind: "tone", waveform: "sine", frequency: 987.77, offset: 0.19, attack: 0.045, decay: 0.34, peak: 0.032 },
],
shimmer: { delay: 0.16, feedback: 0.28, wet: 0.18, lowpass: 3200 },
},
} as const satisfies Record<string, SoundRecipe>;
export type SoundName = keyof typeof RECIPES;
export function isSoundName(value: unknown): value is SoundName {
return typeof value === "string" && Object.prototype.hasOwnProperty.call(RECIPES, value);
}
/** All available sound names, derived from the recipe palette. */
export const sounds = Object.keys(RECIPES) as readonly SoundName[];