clamp(v: number, lo: number, hi: number) → number

Scalars

lerp(a: number, b: number, t: number) → number

rng(seed: number) → void

Deterministic uniform noise in [-1, 1]. Seeded so a rebuild of the whole library is byte-identical, which is what makes a clip diffable.

buf(seconds: number, sr: number?) → Buf

Buffers

seconds(buf: Buf, sr: number?) → number

mixInto(dst: Buf, src: Buf, gain: number, offsetSeconds: number?, sr: number?) → void

Add `src` into `dst` at `offsetSeconds`, scaled by `gain`. Samples that fall past the end of `dst` are dropped rather than growing it.

gain(buf: Buf, g: number) → void

peak(buf: Buf) → number

rms(buf: Buf) → number

normalize(buf: Buf, target: number) → void

Scale so the loudest sample sits at `target`. A silent buffer is left alone rather than being multiplied by infinity.

fadeIn(buf: Buf, seconds: number, sr: number?) → void

fadeOut(buf: Buf, seconds: number, sr: number?) → void

dcBlock(buf: Buf) → void

Remove any DC offset a filter chain introduced. A clip with DC in it clicks the instant playback starts.

lowpass(buf: Buf, cutoff: number, sr: number?) → void

Filters — one-pole and state-variable, all in place

highpass(buf: Buf, cutoff: number, sr: number?) → void

bandpass(buf: Buf, centre: number, q: number, sr: number?) → void

Resonant state-variable bandpass. `q` above ~4 starts to sing, which is exactly what a struck plate wants.

sweepLowpass(buf: Buf, fromHz: number, toHz: number, sr: number?) → void

A cutoff that travels over the length of the buffer — the single most useful gesture for a whoosh, a quench or a sweep.

saturate(buf: Buf, drive: number) → void

Soft clip. `drive` above 1 pushes the material into the odd harmonics that make metal read as metal rather than as a sine.

reverb(buf: Buf, opts: { decay: number?, mix: number?, size: number?, damp: number? }?, sr: number?) → void

In-place reverb. `decay` 0..1 is the comb feedback, `mix` 0..1 the wet amount, `size` scales every delay line (1.0 = a stone hall).

seamless(buf: Buf, crossfadeSeconds: number, sr: number?) → Buf

Loops — the only way to get a bed that does not click Fold the tail of `buf` back over its head with an equal-power crossfade and return a shorter buffer whose last sample joins its first seamlessly. This is how the basin bed loops: no loop markers, no dependence on a codec keeping the first millisecond.

metal(opts: MetalOpts) → Buf

bell(opts: MetalOpts) → Buf

A bell: `metal` with founder's ratios and a long tail.

noise(opts: NoiseOpts) → Buf

Filtered noise with an envelope — steam, cloth, gravel, a sword through air. The sweep is what separates a whoosh from a hiss.

tone(opts: ToneOpts) → Buf

A single pitched voice with an optional glide. Weight (a sub drop), a UI blip and the body under an impact are all this.

toStereo(mono: Buf, spreadSeconds: number, sr: number?) → Buf

Rendered-to-order stereo widening: returns an interleaved 2-channel buffer from a mono one, with the sides delayed against each other. Used only for the music-adjacent material; every positional sound stays mono so the engine's spatialiser owns the panning.