@jpdutoit/squelchy 0.0.1

package/docs/MODULES.md

@@ -0,0 +1,1244 @@
+# @jpdutoit/squelchy — modules
+
+> Generated from module metadata by scripts/lib/build.ts — do not edit.
+
+**Actions** (tape stop, knock, …) are rising edges on gate inputs: `pulse(tapeStop.trigger, when)` fires one sample-accurately. **Timed changes** use the native AudioParams in `instance.params`; `set()` changes a value now.
+
+- [303](#303) — TB-303 Acid Filter
+- [PAN](#pan) — Auto-Panner
+- [CRUSH](#crush) — Bitcrusher
+- [CHORUS](#chorus) — Chorus Effect
+- [COMB](#comb) — Comb Filter
+- [COMP](#comp) — Dynamics Compressor
+- [X-FADE](#x-fade) — Crossfader
+- [DELAY](#delay) — Echo Effect
+- [DIM](#dim) — Dimension Expander
+- [DIST](#dist) — Distortion Effect
+- [DUCK](#duck) — Sidechain Ducker
+- [ENV-F](#env-f) — Envelope Follower
+- [ADSR](#adsr) — ADSR Envelope
+- [EQ3](#eq3) — 3-Band Equalizer
+- [EXCITE](#excite) — Harmonic Exciter
+- [FLANGER](#flanger) — Flanger Effect
+- [FORMANT](#formant) — Formant Filter
+- [SHIFT](#shift) — Frequency Shifter
+- [GATE](#gate) — Noise Gate
+- [GLIDE](#glide) — Glide / Portamento
+- [HAAS](#haas) — Haas Stereo Widener
+- [H-TREM](#h-trem) — Harmonic Tremolo
+- [LADDER](#ladder) — Moog-style Ladder Filter
+- [LFO](#lfo) — Low Frequency Oscillator
+- [LO-FI](#lo-fi) — Lo-Fi Processor
+- [M/S](#m-s) — Mid-Side Processor
+- [NOISE](#noise) — Noise Generator
+- [OCTAVE](#octave) — Analog Octaver
+- [PHASER](#phaser) — Phaser Effect
+- [PING](#ping) — Ping Pong Delay
+- [RESO](#reso) — Resonator
+- [REVERB](#reverb) — Reverb Effect
+- [RING](#ring) — Ring Modulator
+- [ROTARY](#rotary) — Rotary Speaker
+- [SAT](#sat) — Tape Saturator
+- [SHIMMER](#shimmer) — Shimmer Reverb
+- [LIMIT](#limit) — Soft Limiter
+- [SPRING](#spring) — Spring Tank Reverb
+- [SPREAD](#spread) — Stereo Spreader
+- [SUB OCT](#sub-oct) — Sub Octave Generator
+- [TAPE](#tape) — Tape Echo
+- [TAPE STOP](#tape-stop) — Tape Stop Effect
+- [TILT](#tilt) — Tilt EQ
+- [TREMOLO](#tremolo) — Tremolo Effect
+- [VCA](#vca) — Voltage Controlled Amplifier
+- [VCF](#vcf) — Voltage Controlled Filter
+- [VCO](#vco) — Voltage Controlled Oscillator
+- [WAH](#wah) — Auto-Wah
+- [FOLD](#fold) — Wavefolder
+
+## 303
+
+`import { AcidFilter } from '@jpdutoit/squelchy'`
+
+**TB-303 Acid Filter** — The iconic squelchy filter from the Roland TB-303. Features real triggered envelope that sweeps the cutoff for that classic acid house sound.
+
+Categories: Filters · Worklets: adsr-envelope, map-voct-to-freq
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for the iconic TB-303 acid filter sound. |
+| `out` | output | audio | **Audio Output** — Squelchy, resonant acid bass output. |
+| `trigger` | input | gate | **Trigger Input** — Trigger the envelope sweep for classic acid patterns. |
+| `modFreq` | modulation | modulation | **Cutoff V/Oct** — External modulation of cutoff in semitones (V/Oct). ±12 = one octave. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `note` | `67` | 15 – 135 notes | **Cutoff Note** — Base cutoff as a note (67 ≈ 400 Hz, 69 = 440 Hz) for the iconic squelchy acid sound. Drives the V/OCT worklet 1:1 — the panel knob shows the equivalent Hz. Automatable: `params.note` is a native AudioParam. |
+| `resonance` | `8` | 0 – 15 (sqrt) | **Resonance** — Resonance amount, 0–100% of travel. Creates the characteristic 303 "wow" at high settings. Like the hardware, there is no resonance CV input — the knob is the only control. |
+| `envMod` | `0.7` | 0 – 1 | **Envelope Mod** — How much the triggered envelope sweeps the filter cutoff. |
+| `accent` | `0.5` | 0 – 1 | **Accent** — Intensifies the envelope sweep for more aggressive acid sounds. |
+| `decay` | `0.2` | 0.05 – 1 s (log) | **Decay Time** — How quickly the filter envelope falls. Short = plucky, long = sustained. Automatable: `params.decay` is a native AudioParam. |
+
+## PAN
+
+`import { AutoPan } from '@jpdutoit/squelchy'`
+
+**Auto-Panner** — Stereo auto-panner using LFO-controlled panning. Creates movement and animation in the stereo field.
+
+Categories: Effects, Stereo
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to pan across the stereo field. |
+| `out` | output | audio | **Audio Output** — Stereo audio with automatic panning movement. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the pan LFO speed. |
+| `modDepth` | modulation | modulation | **Depth CV** — Modulate the pan sweep depth. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `2` | 0.1 – 10 Hz | **Rate** — Panning LFO speed, driven directly by the oscillator frequency. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.8` | 0 – 1 | **Depth** — How far the pan sweeps from left to right. 1 = full stereo sweep. modDepth sums into the same AudioParam. Automatable: `params.depth` is a native AudioParam. |
+| `shape` | `"sine"` | `sine` / `triangle` / `square` | **LFO Shape** — Waveform shape: sine for smooth, triangle for linear, square for hard left/right. |
+
+## CRUSH
+
+`import { Bitcrusher } from '@jpdutoit/squelchy'`
+
+**Bitcrusher** — Lo-fi digital destruction. Reduces bit depth and sample rate for crunchy, retro video game sounds. RATE controls sample-and-hold decimation.
+
+Categories: Distortion · Worklets: bitcrusher
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for lo-fi bit and sample rate reduction. |
+| `out` | output | audio | **Audio Output** — Crunchy, retro bit-crushed audio output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `bits` | `8` | 1 – 16 | **Bit Depth** — Number of bits for quantization. Lower = crunchier, more lo-fi. Automatable: `params.bits` is a native AudioParam. |
+| `rate` | `0.5` | 0.01 – 1 (log) | **Sample Rate** — Sample rate reduction factor. 1 = original, lower = more aliased and crunchy. Creates the classic "staircase" sample-and-hold effect. Automatable: `params.rate` is a native AudioParam. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between clean and crushed signal. Automatable: `params.mix` is a native AudioParam. |
+
+## CHORUS
+
+`import { Chorus } from '@jpdutoit/squelchy'`
+
+**Chorus Effect** — Stereo chorus: two delayed voices swept in antiphase by one LFO (left rises while right falls), over a centred dry signal — width and gentle detune from a mono source. Classic for pads, guitars, and synths.
+
+Categories: Time, Effects
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to thicken with chorus effect. |
+| `out` | output | audio | **Audio Output** — Stereo chorus output: dry centred, voices spread left/right. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the chorus sweep speed. |
+| `modMix` | modulation | modulation | **Mix CV** — Modulate the dry/wet balance. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `1.5` | 0.1 – 5 Hz | **Rate** — Chorus sweep LFO speed, driven directly by the oscillator frequency. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.5` | 0 – 1 | **Modulation Depth** — How much the delay time is modulated. More = wider detuning. Scaled onto the LFO gain, so it is set-only (no single AudioParam carries it 1:1). |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and chorused signal, driven by one ConstantSource (dry = 1 − mix·0.5, wet = mix — the antiphase voices already carry half the width at mix 1). Automatable: `params.mix` is a native AudioParam. |
+
+## COMB
+
+`import { CombFilter } from '@jpdutoit/squelchy'`
+
+**Comb Filter** — Karplus-Strong style comb filter using short delay with feedback. Creates metallic, resonant, and pitched tones from any input.
+
+Categories: Filters · Worklets: map-voct-to-period, comb-filter
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for comb filtering. |
+| `out` | output | audio | **Audio Output** — Metallic, resonant comb-filtered audio output. |
+| `voct` | input | pitch | **Pitch CV** — Pitch CV input — plays the comb chromatically from keyboard or sequencer CV. Set TUNING to CHROMATIC for scale-true tracking. |
+| `modFreq` | modulation | modulation | **Pitch FM** — Frequency modulation in semitones. ±12 = one octave. Connect an LFO or envelope for musical sweeps. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `offset` | `55` | -48 – 96 semitones | **Pitch Offset** — Semitones added to the V/OCT input (12 = one octave). Unpatched the input is silent, so this is the comb note itself: 55 ≈ 196 Hz, 69 = 440 Hz. Driven by an absolute pitch CV, set 0 to track it as-is. Automatable: `params.offset` is a native AudioParam. |
+| `feedback` | `0.7` | 0 – 0.95 | **Feedback** — Resonance amount. Higher values create more pronounced, ringing tones. Automatable: `params.feedback` is a native AudioParam. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and comb-filtered signal. Automatable: `params.mix` is a native AudioParam. |
+| `tuning` | `"chromatic"` | `chromatic` / `free` | **Tuning Mode** — CHROMATIC snaps the FREQ knob to semitones; FREE allows continuous tuning. |
+
+## COMP
+
+`import { Compressor } from '@jpdutoit/squelchy'`
+
+**Dynamics Compressor** — Reduces dynamic range by attenuating loud signals. Threshold sets where compression begins, ratio controls intensity.
+
+Categories: Dynamics
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to compress. |
+| `out` | output | audio | **Audio Output** — Compressed audio with makeup gain applied. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `threshold` | `-24` | -60 – 0 dB | **Threshold** — Level above which compression kicks in. Lower = more compression. Automatable: `params.threshold` is a native AudioParam. |
+| `ratio` | `4` | 1 – 20 (log) | **Ratio** — How much to reduce signal above threshold. 4:1 = every 4dB over becomes 1dB. Automatable: `params.ratio` is a native AudioParam. |
+| `attack` | `0.003` | 0.001 – 1 s (log) | **Attack** — How fast compression responds to loud signals. Automatable: `params.attack` is a native AudioParam. |
+| `release` | `0.25` | 0.01 – 1 s (log) | **Release** — How fast compression releases after signal drops. Automatable: `params.release` is a native AudioParam. |
+| `knee` | `10` | 0 – 40 dB | **Knee** — Width of the transition zone around the threshold. 0 = hard knee (abrupt), 40 = soft knee (gradual). Automatable: `params.knee` is a native AudioParam. |
+| `makeup` | `0` | 0 – 30 dB | **Makeup Gain** — Boosts the output level to compensate for gain reduction. Up to +30 dB. |
+
+## X-FADE
+
+`import { Crossfade } from '@jpdutoit/squelchy'`
+
+**Crossfader** — Blends between two input signals. Equal-power curve maintains consistent volume. Essential DJ tool and utility for mixing sources.
+
+Categories: Utility
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `a` | input | audio | **Input A** — First audio source for crossfading. |
+| `b` | input | audio | **Input B** — Second audio source for crossfading. |
+| `out` | output | audio | **Audio Output** — Blended mix of inputs A and B. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `blend` | `0.5` | 0 – 1 | **Crossfade Position** — Position between inputs. 0 = all A, 1 = all B. Automatable: `params.blend` is a native AudioParam. |
+| `curve` | `"equal-power"` | `linear` / `equal-power` | **Curve Type** — Linear or equal-power crossfade curve. |
+
+## DELAY
+
+`import { Delay } from '@jpdutoit/squelchy'`
+
+**Echo Effect** — Creates repeating echoes of the input signal. Adjust time, feedback for number of repeats, and mix for wet/dry balance.
+
+Categories: Time · Worklets: comb-filter
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to be delayed. |
+| `out` | output | audio | **Audio Output** — Delayed audio signal mixed with dry signal. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `time` | `0.3` | 0.01 – 1 s (log) | **Delay Time** — Time between original signal and echo. Sync to tempo for rhythmic effects. Automatable: `params.time` is a native AudioParam. |
+| `feedback` | `0.4` | 0 – 0.95 | **Feedback** — How much delayed signal feeds back. Higher = more repeats. Be careful of runaway feedback! Automatable: `params.feedback` is a native AudioParam. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original (dry) and delayed (wet) signal. Automatable: `params.mix` is a native AudioParam. |
+
+## DIM
+
+`import { Dimension } from '@jpdutoit/squelchy'`
+
+**Dimension Expander** — Roland Dimension-D inspired stereo widener. Adds subtle modulation to create spacious, wide stereo images. Classic 80s lush pad sound.
+
+Categories: Effects
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for stereo widening. |
+| `out` | output | audio | **Audio Output** — Spacious, wide stereo audio with subtle modulation. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the widening LFO speed. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `0.5` | 0.1 – 5 Hz | **Rate** — Widening LFO speed, driven directly by the oscillator frequency. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.3` | 0 – 1 | **Modulation Depth** — Amount of chorus-like modulation for that classic 80s wide sound. Scaled onto the LFO gains, so it is set-only (no single AudioParam carries it 1:1). |
+
+## DIST
+
+`import { Distortion } from '@jpdutoit/squelchy'`
+
+**Distortion Effect** — Three clipping circuits: soft (tanh overdrive), hard (true rail clipper — flattens to a square at high drive), fuzz (biased asymmetric saturator with even harmonics). Output is loudness-compensated so DRIVE and TYPE shape timbre, not volume; TONE tames the fizz.
+
+Categories: Distortion
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Clean audio signal to distort. |
+| `out` | output | audio | **Audio Output** — Distorted audio signal output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `distortionType` | `"soft"` | `soft` / `hard` / `fuzz` | **Clipping Curve** — Which clipping transfer curve the signal is pushed into. |
+| `drive` | `5` | 1 – 20 (log) | **Drive Amount** — How hard the signal is pushed into the clipping curve. The whole travel is usable: low = warm break-up, high = full clipping. |
+| `frequency` | `16000` | 500 – 16000 Hz (log) | **Tone** — Post-clip lowpass (500 Hz – 16 kHz). Turn down to tame the high-frequency fizz clipping creates — the Filter knob on a RAT. Automatable: `params.frequency` is a native AudioParam. |
+| `mix` | `0.8` | 0 – 1 | **Dry/Wet Mix** — Balance between clean and distorted signal. Low settings give parallel distortion. Automatable: `params.mix` is a native AudioParam. |
+
+## DUCK
+
+`import { Ducker } from '@jpdutoit/squelchy'`
+
+**Sidechain Ducker** — Ducks the input whenever the sidechain reaches the threshold, using a sample-accurate follower with separate attack and release. The detector saturates like a real sidechain circuit, so a hot kick does not wind it up — REL always sets how fast the signal breathes back. Classic pumping effect for EDM and mixing.
+
+Categories: Dynamics · Worklets: env-follower
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Main audio signal to be ducked. |
+| `sc` | input | audio | **Sidechain Input** — Control signal that triggers ducking. When this exceeds threshold, main input is attenuated. |
+| `out` | output | audio | **Audio Output** — Ducked audio output with sidechain-controlled dynamics. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `threshold` | `-24` | -60 – 0 dB | **Threshold** — Sidechain level that triggers ducking. Lower = more sensitive. |
+| `amount` | `0.7` | 0 – 1 | **Duck Amount** — How much to reduce the main signal when triggered. |
+| `attack` | `0.01` | 0.001 – 0.1 s (log) | **Attack** — How fast ducking kicks in after sidechain exceeds threshold. Automatable: `params.attack` is a native AudioParam. |
+| `release` | `0.2` | 0.001 – 1 s (log) | **Release** — How fast signal returns to normal after sidechain drops. Automatable: `params.release` is a native AudioParam. |
+
+## ENV-F
+
+`import { EnvelopeFollower } from '@jpdutoit/squelchy'`
+
+**Envelope Follower** — Extracts the amplitude envelope from audio using sample-accurate asymmetric smoothing. Separate attack and release times for precise dynamic tracking. Depth scales the CV output for modulating filters, VCAs, etc.
+
+Categories: Modulators, Utility · Worklets: env-follower
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to analyze for envelope. |
+| `env` | output | modulation | **Envelope CV** — Amplitude envelope CV, scaled by DEPTH. Connect to filter, VCA, or other modulation inputs. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `attack` | `0.01` | 0.001 – 0.5 s (log) | **Attack Time** — How quickly the envelope responds to rising levels. Shorter = snappier transient tracking. Automatable: `params.attack` is a native AudioParam. |
+| `release` | `0.1` | 0.001 – 2 s (log) | **Release Time** — How quickly the envelope responds to falling levels. Longer = smoother, more sustained envelope. Automatable: `params.release` is a native AudioParam. |
+| `sensitivity` | `0.5` | 0 – 1 | **Sensitivity** — Input gain before envelope detection. Higher = more responsive to quiet signals. |
+| `depth` | `48` | 0 – 96 semitones (sqrt) | **Output Depth** — Scales the CV output amplitude. For V/Oct filter targets, 12 semitones = one octave, so 48 ≈ four octaves. For VCA or other targets, use lower values (0.5–2). Automatable: `params.depth` is a native AudioParam. |
+
+## ADSR
+
+`import { Envelope } from '@jpdutoit/squelchy'`
+
+**ADSR Envelope** — Shapes how a sound evolves over time. Connect a gate signal to TRIG (from keyboard or sequencer) to trigger the Attack→Decay→Sustain→Release cycle.
+
+Categories: Modulators · Worklets: adsr-envelope
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to shape with the envelope. |
+| `out` | output | audio | **Audio Output** — Envelope-shaped audio output. |
+| `env` | output | modulation | **Envelope CV** — Scaled envelope output. Use DEPTH to control how much the envelope sweeps the target. |
+| `trigger` | input | gate | **Trigger Input** — Connect a gate signal (from keyboard or sequencer) to trigger the envelope cycle. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `attack` | `0.01` | 0.001 – 2 s (log) | **Attack** — Time for signal to rise from zero to full level when triggered. Automatable: `params.attack` is a native AudioParam. |
+| `decay` | `0.1` | 0.001 – 2 s (log) | **Decay** — Time to fall from peak to sustain level after attack completes. Automatable: `params.decay` is a native AudioParam. |
+| `sustain` | `0.7` | 0 – 1 | **Sustain** — Level held while the note is held. 0 = plucky, 1 = organ-like. Automatable: `params.sustain` is a native AudioParam. |
+| `release` | `0.3` | 0.001 – 3 s (log) | **Release** — Time to fade to silence after note is released. Automatable: `params.release` is a native AudioParam. |
+| `depth` | `48` | 0 – 96 semitones (sqrt) | **ENV Depth** — Scales the ENV output in semitones (12 = one octave), the unit every pitch and cutoff modulation input on this rack reads. Higher values produce a wider sweep on the modulation target. Automatable: `params.depth` is a native AudioParam. |
+
+## EQ3
+
+`import { ThreeBandEq } from '@jpdutoit/squelchy'`
+
+**3-Band Equalizer** — Shape your sound with bass, mid, and treble controls. Boost or cut frequencies by up to 12dB. Essential for mixing and tone shaping.
+
+Categories: Filters
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to be equalized. |
+| `out` | output | audio | **Audio Output** — Tone-shaped equalized audio output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `low` | `0` | -12 – 12 dB | **Bass** — Low shelf gain at 320 Hz. Boost for warmth, cut for clarity. Automatable: `params.low` is a native AudioParam. |
+| `mid` | `0` | -12 – 12 dB | **Midrange** — Peaking gain at the mid frequency. The presence and body range. Automatable: `params.mid` is a native AudioParam. |
+| `high` | `0` | -12 – 12 dB | **Treble** — High shelf gain at 3.2 kHz. Boost for brightness, cut for smoothness. Automatable: `params.high` is a native AudioParam. |
+| `midFreq` | `1000` | 200 – 5000 Hz (log) | **Mid Frequency** — Center frequency for the mid band EQ. Automatable: `params.midFreq` is a native AudioParam. |
+
+## EXCITE
+
+`import { Exciter } from '@jpdutoit/squelchy'`
+
+**Harmonic Exciter** — Adds high-frequency harmonics and "air" to dull signals. Generates subtle saturation in the treble range for presence and sparkle.
+
+Categories: Dynamics
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for harmonic enhancement. |
+| `out` | output | audio | **Audio Output** — Bright, exciting audio with added harmonics. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `drive` | `0.5` | 0 – 1 | **Drive** — Amount of harmonic saturation added to high frequencies. |
+| `frequency` | `4000` | 2000 – 8000 Hz (log) | **Frequency** — Cutoff frequency above which excitement is applied. |
+| `mix` | `0.5` | 0 – 1 | **Mix Amount** — How much excited signal is added to the original. Automatable: `params.mix` is a native AudioParam. |
+
+## FLANGER
+
+`import { Flanger } from '@jpdutoit/squelchy'`
+
+**Flanger Effect** — Creates jet-plane swooshing by mixing signal with a short modulated delay. The feedback control adds metallic resonance for dramatic sweeps.
+
+Categories: Time, Effects · Worklets: flanger
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for flanging effect. |
+| `out` | output | audio | **Audio Output** — Swooshing, jet-plane flanged audio output. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the flanger sweep speed. |
+| `modDepth` | modulation | modulation | **Depth CV** — Modulate the flanger modulation depth. |
+| `modFeedback` | modulation | modulation | **Feedback CV** — Modulate the resonance feedback amount. |
+| `modMix` | modulation | modulation | **Mix CV** — Modulate the dry/wet balance. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `0.5` | 0.1 – 5 Hz | **Rate** — Flanger sweep LFO speed, a real a-rate AudioParam on the worklet. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.7` | 0 – 1 | **Modulation Depth** — How much the delay time is modulated, a real AudioParam on the worklet. modDepth sums into the same AudioParam. Automatable: `params.depth` is a native AudioParam. |
+| `feedback` | `0.7` | 0 – 0.95 | **Feedback** — Resonance amount, a real AudioParam on the worklet. modFeedback sums into the same AudioParam. Automatable: `params.feedback` is a native AudioParam. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Crossfade between original and flanged signal, driven by one ConstantSource (linear law: dry = 1 − mix, wet = mix). Automatable: `params.mix` is a native AudioParam. |
+
+## FORMANT
+
+`import { Formant } from '@jpdutoit/squelchy'`
+
+**Formant Filter** — Vocal formant filter with smooth morphing between vowels A-E-I-O-U. Creates voice-like resonances. Morph smoothly between vowel sounds for talking synth effects.
+
+Categories: Filters · Worklets: formant-table
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for vowel/formant filtering. |
+| `out` | output | audio | **Audio Output** — Vocal-like formant filtered audio output. |
+| `modVowel` | modulation | modulation | **Vowel CV** — Control voltage to sweep through vowels A-E-I-O-U. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `morph` | `0` | 0 – 5 | **Vowel Morph** — Position along the A-E-I-O-U vowel formant chain. 0 = A, 5 wraps back to A; fractional values interpolate between neighbouring vowels. |
+| `resonance` | `6` | 1 – 20 (sqrt) | **Resonance** — Sharpness of the formant peaks, scaled per band. Higher values sound more pronounced and vocal. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between the original signal and the formant-filtered output. 0 = dry, 1 = fully wet. |
+
+## SHIFT
+
+`import { FrequencyShifter } from '@jpdutoit/squelchy'`
+
+**Frequency Shifter** — True Bode-style single-sideband shifting: a Hilbert-transform quadrature network splits the signal into an analytic pair, so every partial moves by a fixed number of Hz instead of a musical interval. Inharmonic, alien, bell-like — and unlike a ring modulator, only one sideband survives.
+
+Categories: Effects · Worklets: freq-shifter
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for frequency shifting. |
+| `out` | output | audio | **Audio Output** — Alien, bell-like frequency-shifted audio output. |
+| `modShift` | modulation | modulation | **Shift Amount** — Modulate the shift amount in Hz. An LFO here sweeps the sidebands for rotating, Leslie-like motion. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `shift` | `0` | -500 – 500 Hz | **Frequency Shift** — Amount to shift all frequencies in Hz. Positive = up, negative = down. Automatable: `params.shift` is a native AudioParam. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between original and frequency-shifted signal. Automatable: `params.mix` is a native AudioParam. |
+
+## GATE
+
+`import { Gate } from '@jpdutoit/squelchy'`
+
+**Noise Gate** — Silences signal below threshold using sample-accurate envelope detection with separate attack and release. Essential for cleaning up noise, tightening drums, and creating rhythmic gating effects.
+
+Categories: Dynamics · Worklets: env-follower
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to be gated. |
+| `out` | output | audio | **Audio Output** — Gated audio - silent when below threshold. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `threshold` | `-40` | -60 – 0 dB | **Threshold** — Level below which the gate closes and silences audio. |
+| `range` | `0.8` | 0 – 1 | **Range** — How much the signal is attenuated when gate is closed. 0=full mute, lower=gentler. |
+| `attack` | `0.005` | 0.001 – 0.05 s (log) | **Attack** — How fast the gate opens when signal exceeds threshold. Short = tight, long = gentle fade-in. Automatable: `params.attack` is a native AudioParam. |
+| `release` | `0.1` | 0.01 – 0.5 s (log) | **Release** — How fast the gate closes when signal falls below threshold. Automatable: `params.release` is a native AudioParam. |
+
+## GLIDE
+
+`import { Glide } from '@jpdutoit/squelchy'`
+
+**Glide / Portamento** — Slew limiter that smooths CV transitions. Connect a gate signal for legato-only glide: new notes after silence snap to pitch instantly, overlapping notes glide smoothly.
+
+Categories: Modulators, Utility · Worklets: glide
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | pitch | **Pitch CV In** — Pitch CV to smooth. Works on any CV, but tuned for semitone-space pitch. |
+| `gate` | input | gate | **Gate Input** — Gate signal for legato-only glide. New notes snap to pitch; held notes glide. Leave unconnected for always-on glide. |
+| `out` | output | pitch | **Pitch CV Out** — Smoothed pitch CV with portamento. Connect to any V/OCT input. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `time` | `0.1` | 0.01 – 10 s (log) | **Glide Time** — How long it takes to slide between pitches. Longer = more portamento. Automatable: `params.time` is a native AudioParam. |
+
+## HAAS
+
+`import { HaasWidener } from '@jpdutoit/squelchy'`
+
+**Haas Stereo Widener** — Uses micro-delays (1-35ms) to create stereo width from mono. The Haas effect tricks the ear into perceiving wider stereo image.
+
+Categories: Stereo
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Mono signal to widen using Haas effect. |
+| `out` | output | audio | **Stereo Output** — Stereo-widened audio using micro-delays. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `delay` | `15` | 1 – 35 ms | **Micro-Delay** — Delay time in milliseconds (1–35 ms). The Haas effect range. |
+| `side` | `"right"` | `left` / `right` | **Delayed Side** — Which channel receives the delay — left or right. |
+| `mix` | `1` | 0 – 1 | **Effect Level** — Amount of stereo widening effect. 0 = mono passthrough, 1 = fully delayed side. Automatable: `params.mix` is a native AudioParam. |
+
+## H-TREM
+
+`import { HarmonicTremolo } from '@jpdutoit/squelchy'`
+
+**Harmonic Tremolo** — Fender Brownface-style tremolo that splits signal by frequency. Highs and lows pulse opposite to each other for lush, watery modulation.
+
+Categories: Effects
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for harmonic tremolo. |
+| `out` | output | audio | **Audio Output** — Audio with frequency-split tremolo applied. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the tremolo LFO speed. |
+| `modCrossover` | modulation | modulation | **Crossover CV** — Modulate the low/high crossover frequency. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `4` | 1 – 10 Hz | **Rate** — Tremolo LFO speed, driven directly by the oscillator frequency. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.7` | 0 – 1 | **Modulation Depth** — Intensity of the volume modulation. Split across the low- and high-band LFO gains, so it is set-only (no single AudioParam carries it). |
+| `crossover` | `800` | 200 – 2000 Hz | **Crossover Frequency** — Frequency where signal splits into low and high bands. Only the lowpass moves; the high band is derived (input − LP) and follows. modCrossover sums into the same AudioParam. Automatable: `params.crossover` is a native AudioParam. |
+
+## LADDER
+
+`import { LadderFilter } from '@jpdutoit/squelchy'`
+
+**Moog-style Ladder Filter** — True 4-pole transistor-ladder lowpass (24 dB/octave): one saturating feedback loop around four one-pole stages, like the original circuit. At 100% RES it self-oscillates into a playable sine — patch a Pitch CV into V/OCT and play the filter as a voice. DRIVE saturates inside the ladder for that thick, compressed growl.
+
+Categories: Filters · Worklets: ladder-filter, map-voct-to-freq
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to filter through the transistor-ladder model. |
+| `out` | output | audio | **Audio Output** — Warm 24 dB/oct lowpass output. Passband thins slightly as resonance rises — authentic ladder behavior. |
+| `modFreq` | modulation | modulation | **Cutoff V/Oct** — Modulate cutoff in semitones (V/Oct). ±12 = one octave. At full resonance this plays the self-oscillation like an oscillator. |
+| `modRes` | modulation | modulation | **Resonance CV** — Resonance CV: +1 sweeps the full RES range (100% = self-oscillation), adds to the knob, clamped inside the filter. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `note` | `83` | 15 – 135 notes | **Cutoff Note** — Filter cutoff as a note (83 ≈ 1 kHz, 69 = 440 Hz). Drives the V/OCT worklet 1:1 — the panel knob shows the equivalent Hz. At full resonance this plays the self-oscillation like an oscillator. Automatable: `params.note` is a native AudioParam. |
+| `resonance` | `2.5` | 0 – 4 (sqrt) | **Resonance** — Feedback around the whole ladder. At 100% the filter self-oscillates into a sine you can play via the V/OCT input. |
+| `drive` | `0.3` | 0 – 1 | **Input Drive** — Saturation inside the ladder loop — thicker and more compressed as you push it, just like overdriving the original circuit. Automatable: `params.drive` is a native AudioParam. |
+
+## LFO
+
+`import { Lfo } from '@jpdutoit/squelchy'`
+
+**Low Frequency Oscillator** — Generates slow, sub-audio waveforms for modulation. Skew and shape morph continuously between sine, triangle, square and saw. Connect to filter cutoff for wobble, to pitch for vibrato, or to VCA for tremolo.
+
+Categories: Modulators · Worklets: waveshaper
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `out` | output | modulation | **Modulation Output** — Low frequency oscillation output. Connect to modulation inputs (purple ports) to animate parameters. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the LFO speed. |
+| `modAmount` | modulation | modulation | **Amount CV** — Modulate the LFO output depth. |
+| `modSkew` | modulation | modulation | **Skew Modulation** — Modulate waveshape symmetry. |
+| `modShape` | modulation | modulation | **Shape Modulation** — Modulate waveshape curvature. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `skew` | `0` | -1 – 1 | **Skew** — Waveform symmetry. 0 = symmetric; ±1 folds the cycle into a rising or falling ramp. Automatable: `params.skew` is a native AudioParam. |
+| `shape` | `1` | -1 – 1 | **Shape** — Waveform curvature. +1 = sine, 0 = triangle, −1 = exact square. With skew ±1 and shape 0 the output is a saw. Automatable: `params.shape` is a native AudioParam. |
+| `frequency` | `2` | -10 – 20 Hz | **Frequency** — Base oscillation rate, summed with the modRate input. 0 freezes the phase; negative values run the waveform backwards. Automatable: `params.frequency` is a native AudioParam. |
+| `amount` | `12` | 0 – 500 semitones (sqrt) | **Amount** — Output scale: out swings ±amount (semitones when patched to a V/Oct-style mod input). modAmount is summed onto it. Automatable: `params.amount` is a native AudioParam. |
+
+## LO-FI
+
+`import { LoFi } from '@jpdutoit/squelchy'`
+
+**Lo-Fi Processor** — Lo-fi processor with saturation, lowpass filtering, vinyl noise, and pitch wobble. Perfect for vintage, degraded textures.
+
+Categories: Distortion, Vintage
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for vintage degradation. |
+| `out` | output | audio | **Audio Output** — Warm, degraded lo-fi audio with vinyl character. |
+| `modCutoff` | modulation | modulation | **Cutoff CV** — Modulate the lowpass cutoff frequency. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `drive` | `0.3` | 0 – 1 | **Saturation** — Amount of warm tape-like saturation and compression. Rebuilds the waveshaper curve, so it is set-only (no single AudioParam carries it). |
+| `cutoff` | `4000` | 500 – 8000 Hz | **Cutoff** — Lowpass filter frequency. Lower = more muffled, vintage sound. Automatable: `params.cutoff` is a native AudioParam. |
+| `noise` | `0.2` | 0 – 1 | **Vinyl Noise** — Amount of background crackle and hiss for authentic vinyl character. Scaled onto the noise gain, so it is set-only (no single AudioParam carries it 1:1). |
+| `wobble` | `0.1` | 0 – 1 | **Wobble** — Pitch instability like a worn tape or warped record. Scaled onto the wobble-LFO gain, so it is set-only (no single AudioParam carries it 1:1). |
+
+## M/S
+
+`import { MidSide } from '@jpdutoit/squelchy'`
+
+**Mid-Side Processor** — Encodes stereo into mid (center) and side (edges) components. Adjust balance for mono compatibility or extreme widening. Essential mastering tool.
+
+Categories: Stereo
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Stereo Input** — Stereo audio signal for M/S processing. |
+| `out` | output | audio | **Stereo Output** — Processed stereo audio with adjusted M/S balance. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `midGain` | `1` | 0 – 2 | **Mid Gain** — Controls the center/mono content of the stereo image. Automatable: `params.midGain` is a native AudioParam. |
+| `sideGain` | `1` | 0 – 2 | **Side Gain** — Controls the stereo edges/differences between left and right. Automatable: `params.sideGain` is a native AudioParam. |
+
+## NOISE
+
+`import { Noise } from '@jpdutoit/squelchy'`
+
+**Noise Generator** — Produces random audio (white, pink, brown noise). Use for percussion, wind effects, or filter sweep textures.
+
+Categories: Sources
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `out` | output | audio | **Noise Output** — White, pink, or brown noise output. |
+| `modLevel` | modulation | modulation | **Level CV** — Modulate output level. Connect an envelope for amplitude shaping or an LFO for tremolo. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `noiseType` | `"white"` | `white` / `pink` / `brown` | **Noise Color** — White, pink, or brown noise spectrum. |
+| `gain` | `0.3` | 0 – 1 | **Noise Level** — Output amplitude of the noise generator. Automatable: `params.gain` is a native AudioParam. |
+
+## OCTAVE
+
+`import { Octaver } from '@jpdutoit/squelchy'`
+
+**Analog Octaver** — Classic analog-style octave effect. Zero-crossing flip-flop frequency division gives true -1 and -2 octave square waves (as in a Boss OC-2), while the +1 octave comes from full-wave rectification through a bandpass that tracks the detected fundamental. Monophonic, like the hardware.
+
+Categories: Effects · Worklets: freq-divider
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Monophonic audio signal for octave processing. |
+| `out` | output | audio | **Audio Output** — Dry signal blended with true divided sub-octaves and a tracked octave-up. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `octDown2` | `0.3` | 0 – 1 | **Two Octaves Down** — Level of the ÷4 divided square wave — two octaves below the input. Automatable: `params.octDown2` is a native AudioParam. |
+| `octDown1` | `0.5` | 0 – 1 | **One Octave Down** — Level of the ÷2 divided square wave — one octave below the input. Automatable: `params.octDown1` is a native AudioParam. |
+| `dry` | `0.7` | 0 – 1 | **Dry Level** — Level of the original unprocessed signal. Automatable: `params.dry` is a native AudioParam. |
+| `octUp` | `0` | 0 – 1 | **One Octave Up** — Level of the rectified octave-up voice, bandpassed around the tracked fundamental. Automatable: `params.octUp` is a native AudioParam. |
+
+## PHASER
+
+`import { Phaser } from '@jpdutoit/squelchy'`
+
+**Phaser Effect** — Creates swooshing, jet-like sweeps by splitting signal through allpass filters. Rate controls speed, depth the intensity, feedback adds resonance.
+
+Categories: Time, Effects
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for phase-shifting effect. |
+| `out` | output | audio | **Audio Output** — Swooshing, jet-like phased audio output. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the phaser sweep speed. |
+| `modFeedback` | modulation | modulation | **Feedback CV** — Modulate the resonance feedback amount. |
+| `modMix` | modulation | modulation | **Mix CV** — Modulate the dry/wet balance. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `0.5` | 0.1 – 10 Hz | **Rate** — Phaser sweep LFO speed, driven directly by the oscillator frequency. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.7` | 0 – 1 | **Modulation Depth** — Intensity of the phase shifting effect. Split proportionally across the four allpass stage gains, so it is set-only (no single AudioParam carries it). |
+| `feedback` | `0.6` | 0 – 0.9 | **Feedback** — Resonance amount. Higher values create more pronounced, whistling sweeps. modFeedback sums into the same AudioParam. Automatable: `params.feedback` is a native AudioParam. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and phased signal, driven by one ConstantSource (linear law: dry = 1 − mix, wet = mix). Automatable: `params.mix` is a native AudioParam. |
+
+## PING
+
+`import { PingPong } from '@jpdutoit/squelchy'`
+
+**Ping Pong Delay** — Stereo delay that bounces between left and right channels. Creates wide, rhythmic echoes. Spread controls how far apart the bounces are panned.
+
+Categories: Time · Worklets: ping-pong
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for ping-pong delay. |
+| `out` | output | audio | **Stereo Output** — Stereo delay with bouncing echoes. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `time` | `0.3` | 0.1 – 1 s (log) | **Delay Time** — Time between each stereo bounce. Automatable: `params.time` is a native AudioParam. |
+| `feedback` | `0.4` | 0 – 0.9 | **Feedback** — How much delayed signal feeds back for more repeats. Automatable: `params.feedback` is a native AudioParam. |
+| `spread` | `1` | 0 – 1 | **Stereo Spread** — Controls how far left/right the bounces are panned. 0% = mono center, 100% = full stereo. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and delayed signal. Automatable: `params.mix` is a native AudioParam. |
+
+## RESO
+
+`import { Resonator } from '@jpdutoit/squelchy'`
+
+**Resonator** — Modal resonator: five tuned second-order modes that ring when struck. The whole partial series tracks the root note and the V/OCT input exponentially; STRUCT sets the spacing, DAMP the decay time.
+
+Categories: Filters · Worklets: map-voct-to-freq
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to excite the resonator. |
+| `out` | output | audio | **Audio Output** — Resonant, pitched harmonics from the input. |
+| `voct` | input | pitch | **Root V/Oct** — Pitch CV from a keyboard or sequencer — every partial plays the incoming notes. |
+| `modFreq` | modulation | modulation | **Root Modulation** — Sweeps every partial in semitones, ±12 = one octave. Patch an LFO here for vowel-like wobbles. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `offset` | `57` | -48 – 108 semitones | **Root Pitch Offset** — Semitones added to the V/OCT input. Unpatched the input is silent, so this is the root note itself: 57 = A3 (220 Hz). Driven by a keyboard or sequencer, 0 tracks the incoming notes. Every partial follows. Automatable: `params.offset` is a native AudioParam. |
+| `structure` | `0` | 0 – 1 | **Structure** — Harmonic spacing of the resonator partials. Left = standard harmonic series, center = bell-like, right = metallic/inharmonic. |
+| `damping` | `0.5` | 0 – 1 | **Damping** — Decay time of the modes, exponential across the knob: at A3 the ring lasts ~10 s at 0, ~0.45 s at the centre and ~20 ms at 1 (T60 ≈ 2.2·Q/f, Q 1000 → 2). Upper partials fade faster than the root, as on a real string. Loudness holds across the range — less damping spreads the same strike over a longer ring instead of making it quieter. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and resonated signal. Automatable: `params.mix` is a native AudioParam. |
+
+## REVERB
+
+`import { Reverb } from '@jpdutoit/squelchy'`
+
+**Reverb Effect** — Algorithmic Schroeder/FDN reverb: four damped comb filters cross-mixed through a Hadamard matrix, with separate mid and side output taps — a stereo tail that stays exactly mono-compatible, and a stereo input keeps its image. Decay sets RT60 and updates smoothly — nothing is re-rendered when you turn a knob.
+
+Categories: Time · Worklets: fdn-reverb
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to add reverb to. |
+| `out` | output | audio | **Audio Output** — Reverberant audio signal mixed with dry signal. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `decay` | `2` | 0.1 – 8 s (log) | **Decay Time (RT60)** — How long the tail takes to fall 60 dB. Short = room, long = hall or cathedral. Automatable: `params.decay` is a native AudioParam. |
+| `mix` | `0.3` | 0 – 1 | **Dry/Wet Mix** — Equal-power balance between original (dry) and reverberant (wet) signal. Automatable: `params.mix` is a native AudioParam. |
+
+## RING
+
+`import { RingModulator } from '@jpdutoit/squelchy'`
+
+**Ring Modulator** — Multiplies input with an internal carrier oscillator, creating metallic, bell-like, and robotic tones. Classic Dalek voice effect!
+
+Categories: Effects · Worklets: map-voct-to-freq
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for ring modulation. |
+| `out` | output | audio | **Audio Output** — Metallic, bell-like ring-modulated audio output. |
+| `voct` | input | pitch | **Carrier Pitch CV** — Pitch CV from a keyboard or sequencer — the carrier plays the incoming notes. |
+| `modFreq` | modulation | modulation | **Carrier Modulation** — Sweeps the carrier in semitones, ±12 = one octave. Patch an LFO here for gliding sci-fi sidebands. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `offset` | `69` | -48 – 108 semitones | **Carrier Pitch Offset** — Semitones added to the V/OCT input. Unpatched the input is silent, so this is the carrier note itself: 69 = 440 Hz. Driven by a keyboard or sequencer, 0 tracks the incoming notes. Automatable: `params.offset` is a native AudioParam. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and ring-modulated signal. |
+
+## ROTARY
+
+`import { Rotary } from '@jpdutoit/squelchy'`
+
+**Rotary Speaker** — Two-rotor Leslie cabinet: 800 Hz crossover into a treble horn and bass drum, each with its own speed, inertia, Doppler and directivity, picked up by a stereo mic pair. Switching SLOW↔FAST ramps the rotors like the real thing — the horn in about a second, the drum over several.
+
+Categories: Effects, Vintage
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for Leslie cabinet simulation. |
+| `out` | output | audio | **Audio Output** — Stereo rotary output: Doppler and tremolo swirling between the two mics. |
+| `modMix` | modulation | modulation | **Mix CV** — Modulate the dry/wet balance. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `speed` | `"slow"` | `slow` / `fast` | **Speed Mode** — Toggle between slow "chorale" and fast "tremolo". The rotors ramp between speeds with inertia — horn in ~1 s, drum in ~4–5 s — so this is a mode switch, not a continuous rate. |
+| `slowRate` | `0.8` | 0.5 – 2 Hz | **Slow Rate** — Horn speed in chorale mode (the drum turns at 0.85× this). Applied via an inertia ramp, so it is set-only. |
+| `fastRate` | `6` | 4 – 8 Hz | **Fast Rate** — Horn speed in tremolo mode (the drum turns at 0.85× this). Applied via an inertia ramp, so it is set-only. |
+| `mix` | `0.7` | 0 – 1 | **Dry/Wet Mix** — Balance between original and rotary speaker signal, driven by one ConstantSource (linear law: dry = 1 − mix, wet = mix). Automatable: `params.mix` is a native AudioParam. |
+
+## SAT
+
+`import { Saturator } from '@jpdutoit/squelchy'`
+
+**Tape Saturator** — Adds warm analog-style harmonic saturation. Drive pushes into soft clipping, warmth adds low-end emphasis. Subtle grit to heavy crunch.
+
+Categories: Distortion
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for warm saturation. |
+| `out` | output | audio | **Audio Output** — Warm, harmonically-rich saturated audio output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `drive` | `0.5` | 0 – 1 | **Drive** — How hard to push into saturation. Adds harmonics and soft compression. |
+| `warmth` | `0.5` | 0 – 1 | **Warmth** — Low frequency emphasis for a thicker, analog-like tone. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between clean and saturated signal. Automatable: `params.mix` is a native AudioParam. |
+
+## SHIMMER
+
+`import { Shimmer } from '@jpdutoit/squelchy'`
+
+**Shimmer Reverb** — A real shimmer: a Schroeder/FDN reverb tank whose feedback path runs through a granular pitch shifter, so every pass through the tank is transposed again and the tail climbs as it decays. Fully stereo: the tank keeps a stereo input's image, and each channel has its own pitch shifter in the feedback loop so the rising tail stays wide. +12 = octave up, +7 = fifth.
+
+Categories: Time · Worklets: pitch-shifter, fdn-reverb
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for shimmer reverb processing. |
+| `out` | output | audio | **Audio Output** — Ethereal, pitch-shifted reverb output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `decay` | `3` | 0.5 – 10 s (log) | **Reverb Decay** — RT60 of the reverb tank in seconds. |
+| `pitch` | `12` | -12 – 24 semitones | **Pitch Shift** — Transposition applied by the granular pitch shifter on every trip round the feedback loop (12 = one octave). +12 = octave up, +7 = fifth up, -12 = octave down. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Equal-power balance between dry signal and shimmer output — independent of the regen amount. Automatable: `params.mix` is a native AudioParam. |
+| `shimmer` | `0.5` | 0 – 0.95 | **Shimmer Regen** — How much pitch-shifted signal is fed back into the tank. High = endless rising choir. Automatable: `params.shimmer` is a native AudioParam. |
+
+## LIMIT
+
+`import { SoftLimiter } from '@jpdutoit/squelchy'`
+
+**Soft Limiter** — Gentle brickwall limiting with soft knee. Prevents clipping while preserving dynamics. Use ceiling control to set maximum output level.
+
+Categories: Dynamics
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to be limited. |
+| `out` | output | audio | **Audio Output** — Limited audio with controlled peaks. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `drive` | `0.5` | 0 – 1 | **Input Drive** — Pushes signal into the limiter for more saturation and loudness. |
+| `knee` | `0.5` | 0 – 1 | **Soft Knee** — How gradually limiting kicks in. Higher = softer, more transparent. |
+| `ceiling` | `-0.5` | -12 – 0 dB | **Ceiling** — Maximum output level in dB. Prevents clipping above this level. |
+
+## SPRING
+
+`import { SpringReverb } from '@jpdutoit/squelchy'`
+
+**Spring Tank Reverb** — A modeled spring tank: dispersive spring lines turn transients into the classic descending "boing", the tail darkens with every pass, and KNOCK whacks the tank for the kicked-amp crash.
+
+Categories: Time, Vintage · Worklets: spring-reverb
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio driven into the spring tank. Hit it hard and the springs overload into a crash. |
+| `knock` | input | gate | **Knock Trigger** — Rising edge whacks the tank — a mechanical thump straight into the springs, like kicking the amp. Patch a clock for rhythmic dub crashes. |
+| `out` | output | audio | **Audio Output** — Dry/wet blend of the spring tank — dispersive boing, flutter echoes and all. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `mix` | `0.35` | 0 – 1 | **Dry/Wet Mix** — Equal-power blend of dry signal and spring output. Automatable: `params.mix` is a native AudioParam. |
+| `decay` | `1.5` | 0.3 – 4 s (log) | **Reverb Decay** — Stretch/sag of the spring's dispersion — higher values ring longer and smear more. Automatable: `params.decay` is a native AudioParam. |
+| `tone` | `0.6` | 0 – 1 | **Tone** — Brightness of the spring output: darkens the rattly top end as it falls. Automatable: `params.tone` is a native AudioParam. |
+| `drip` | `0.5` | 0 – 1 | **Drip** — Spring bounce character — how much the delayed tail drips and boings. Automatable: `params.drip` is a native AudioParam. |
+
+## SPREAD
+
+`import { StereoSpread } from '@jpdutoit/squelchy'`
+
+**Stereo Spreader** — Frequency-dependent stereo widening using the Haas effect. Highs above the crossover are split into two paths with micro-delay for real psychoacoustic width. Lows stay mono and centered.
+
+Categories: Stereo
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for stereo spreading. |
+| `out` | output | audio | **Audio Output** — Wide stereo audio with frequency-dependent Haas widening. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `spread` | `0.7` | 0 – 1 | **Spread Amount** — Controls the micro-delay time for Haas widening (0–5ms). More spread = wider perceived stereo image. |
+| `center` | `800` | 200 – 2000 Hz (log) | **Crossover Frequency** — Frequency above which Haas spreading is applied. Lows below this stay centered for mono compatibility. |
+
+## SUB OCT
+
+`import { Subharmonic } from '@jpdutoit/squelchy'`
+
+**Sub Octave Generator** — Generates square waves one and two octaves below the input using zero-crossing frequency division, like classic analog octave pedals.
+
+Categories: Sources · Worklets: freq-divider
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for sub-octave generation. |
+| `out` | output | audio | **Audio Output** — Audio with added sub-octave content. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `direct` | `1` | 0 – 1 | **Direct Level** — Level of the dry input signal passed through to the output. Automatable: `params.direct` is a native AudioParam. |
+| `octave1` | `0.5` | 0 – 1 | **Octave Down** — Level of the first sub-octave (one octave below input via ÷2 frequency division). Automatable: `params.octave1` is a native AudioParam. |
+| `octave2` | `0.3` | 0 – 1 | **Two Octaves Down** — Level of the second sub-octave (two octaves below input via ÷4 frequency division). Automatable: `params.octave2` is a native AudioParam. |
+
+## TAPE
+
+`import { TapeDelay } from '@jpdutoit/squelchy'`
+
+**Tape Echo** — Vintage-style delay with analog warmth. Repeats darken like real tape, wow and flutter add speed wobble, saturation adds harmonic richness, and the TIME knob bends pitch like a varispeed motor.
+
+Categories: Time, Vintage · Worklets: tape-delay
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for warm tape echo processing. |
+| `out` | output | audio | **Audio Output** — Lush tape delay with wow, flutter, per-repeat darkening, and saturation. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `time` | `0.375` | 0.05 – 1.5 s (log) | **Delay Time** — Echo time. Changes glide with a tape-style pitch bend instead of jumping. Automatable: `params.time` is a native AudioParam. |
+| `feedback` | `0.5` | 0 – 0.95 | **Feedback** — Repeat intensity. High values create dreamy, degrading echoes. Automatable: `params.feedback` is a native AudioParam. |
+| `mix` | `0.4` | 0 – 1 | **Dry/Wet Mix** — Balance between original and delayed signal. Automatable: `params.mix` is a native AudioParam. |
+| `flutter` | `0.3` | 0 – 1 | **Wow & Flutter** — Slow wow plus fast flutter — tape transport speed wobble, proportional to delay time. Automatable: `params.flutter` is a native AudioParam. |
+| `saturation` | `0.4` | 0 – 1 | **Saturation** — Tape saturation warmth and subtle compression, applied on every pass. Automatable: `params.saturation` is a native AudioParam. |
+
+## TAPE STOP
+
+`import { TapeStop } from '@jpdutoit/squelchy'`
+
+**Tape Stop Effect** — Classic DJ/producer tape-stop effect with real pitch-dropping slowdown via ring-buffer resampling. Trigger to toggle between stopped and playing.
+
+Categories: Time · Worklets: tape-stop
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to apply tape stop effect. |
+| `trigger` | input | gate | **Trigger Input** — Rising edge toggles between stop and start. Works with clock or audio-rate triggers. |
+| `out` | output | audio | **Audio Output** — Audio with tape stop/start effect applied. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `time` | `0.5` | 0.01 – 4 s (log) | **Stop/Start Time** — Duration of the tape deceleration or acceleration ramp. Automatable: `params.time` is a native AudioParam. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between original signal and tape-stopped signal. Automatable: `params.mix` is a native AudioParam. |
+
+## TILT
+
+`import { Tilt } from '@jpdutoit/squelchy'`
+
+**Tilt EQ** — Single-knob tone control that tilts the frequency balance around a pivot point. Positive = brighter, negative = darker. Simple but powerful.
+
+Categories: Filters
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for tilt EQ processing. |
+| `out` | output | audio | **Audio Output** — Frequency-tilted audio output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `tilt` | `0` | -12 – 12 dB | **Tilt Amount** — Positive tilts towards highs (brighter), negative towards lows (darker). Drives the low shelf (inverted) and high shelf gains. |
+| `frequency` | `1000` | 200 – 5000 Hz | **Pivot Frequency** — Center frequency around which the tilt occurs, shared by both the low and high shelf filters. |
+
+## TREMOLO
+
+`import { Tremolo } from '@jpdutoit/squelchy'`
+
+**Tremolo Effect** — Classic amplitude modulation found in vintage amps. Creates pulsing, rhythmic volume changes. Square wave shape gives choppy helicopter effect.
+
+Categories: Effects
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for amplitude modulation. |
+| `out` | output | audio | **Audio Output** — Pulsing, rhythmic tremolo audio output. |
+| `modRate` | modulation | modulation | **Rate CV** — Modulate the tremolo LFO speed. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `rate` | `5` | 0.5 – 20 Hz | **Rate** — Amplitude-modulation LFO speed, driven directly by the oscillator frequency. modRate sums into the same AudioParam. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.5` | 0 – 1 | **Modulation Depth** — How much the volume varies. 100% goes from silence to full volume. Split across a depth gain and a DC offset, so it is set-only (no single AudioParam carries it). |
+| `shape` | `"sine"` | `sine` / `triangle` / `square` | **LFO Shape** — Waveform shape: sine for smooth, triangle for linear, square for choppy. |
+
+## VCA
+
+`import { Vca } from '@jpdutoit/squelchy'`
+
+**Voltage Controlled Amplifier** — Controls signal level. GAIN sets the resting level, CV AMT scales (or inverts) the control voltage. Gain is clamped at zero, so deep CV closes the VCA instead of flipping phase.
+
+Categories: Dynamics · Worklets: vca
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to be amplified. |
+| `out` | output | audio | **Audio Output** — Amplified audio signal output. |
+| `modGain` | modulation | modulation | **Gain CV** — Modulate the level. Scaled by CV AMT and added to GAIN, then clamped to 0–2. Envelope for volume shaping, LFO for tremolo. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `gain` | `0.5` | 0 – 2 | **Resting level** — Sets the level when no CV is patched, and the offset the CV rides on. Leave at 0 for envelope-gated patches so the VCA fully closes. Automatable: `params.gain` is a native AudioParam. |
+| `cvAmount` | `1` | -1 – 1 | **CV attenuverter** — Scales the control voltage from the CV input. Negative values invert it, so the signal ducks instead of swelling. Automatable: `params.cvAmount` is a native AudioParam. |
+
+## VCF
+
+`import { Vcf } from '@jpdutoit/squelchy'`
+
+**Voltage Controlled Filter** — SEM-style multimode filter (12 dB/oct lowpass, highpass, bandpass, notch). Cutoff modulation is exponential (V/Oct) — ±12 = one octave. RES is true filter Q in every mode; like the SEM it stays clean and never self-oscillates — reach for LADDER when you want scream.
+
+Categories: Filters · Worklets: map-res, map-voct-to-freq
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal to be filtered. |
+| `out` | output | audio | **Audio Output** — Filtered audio signal output. |
+| `modFreq` | modulation | modulation | **Cutoff V/Oct** — Modulate cutoff in semitones (V/Oct). ±12 = one octave. Connect an LFO or envelope for musical sweeps. |
+| `modQ` | modulation | modulation | **Resonance CV** — Resonance CV: +1 sweeps the full RES range (Q 0.1–20), adds to the knob, clamped. Same true-Q behavior in every filter mode. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `filterType` | `"lowpass"` | `lowpass` / `highpass` / `bandpass` / `notch` | **Filter Type** — Selects lowpass, highpass, bandpass, or notch response. |
+| `note` | `83` | 15 – 135 notes | **Cutoff Note** — Filter cutoff as a note (83 ≈ 1 kHz, 69 = 440 Hz). Drives the V/OCT worklet 1:1 — the panel knob shows the equivalent Hz. Automatable: `params.note` is a native AudioParam. |
+| `resonance` | `1` | 0.1 – 20 (sqrt) | **Resonance (Q)** — True filter Q, identical in every mode: Q 0.707 is maximally flat, Q 8 peaks ~+18 dB in lowpass and narrows bandpass to f/8. |
+
+## VCO
+
+`import { Vco } from '@jpdutoit/squelchy'`
+
+**Voltage Controlled Oscillator** — Continuously morphable waveform generator. The X-Y pad controls waveshape: X = skew (symmetry), Y = shape (curvature). Covers sine, triangle, square, sawtooth, and everything in between.
+
+Categories: Sources · Worklets: map-voct-to-freq, waveshaper
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `voct` | input | pitch | **Pitch CV** — Pitch CV input — plays the oscillator chromatically from keyboard or sequencer CV. |
+| `out` | output | audio | **Audio Output** — Main audio signal output from the oscillator. |
+| `modSkew` | modulation | modulation | **Skew Modulation** — Modulate waveshape symmetry. At center = symmetric, fully right = sawtooth. |
+| `modShape` | modulation | modulation | **Shape Modulation** — Modulate waveshape curvature. Bottom = square, middle = triangle, top = sine. |
+| `modDetune` | modulation | modulation | **Detune Modulation** — Modulate fine pitch in semitones. Connect an LFO for vibrato (amount ~0.1–0.3). |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `skew` | `1` | -1 – 1 | **Waveshape Skew** — Symmetry of the waveform: −1 reversed sawtooth, 0 symmetric, +1 sawtooth. Automatable: `params.skew` is a native AudioParam. |
+| `shape` | `0` | -1 – 1 | **Waveshape Curvature** — Curvature of the waveform: −1 square, 0 triangle, +1 sine. Automatable: `params.shape` is a native AudioParam. |
+| `offset` | `69` | -48 – 108 semitones | **Pitch Offset** — Semitones added to the V/OCT input (12 = one octave). Unpatched the input is silent, so this is the note itself: 69 = A4. Driven by an absolute pitch CV (keyboard, sequencer), set 0 to play as-is or ±12 to shift an octave. Automatable: `params.offset` is a native AudioParam. |
+| `detune` | `0` | -1 – 1 semitones | **Detune** — Fine pitch offset in semitones; ±1 = ±100 cents. Use for detuning oscillators against each other. Automatable: `params.detune` is a native AudioParam. |
+| `gain` | `0.5` | 0 – 1 | **Output Level** — Amplitude of the oscillator output signal. Automatable: `params.gain` is a native AudioParam. |
+
+## WAH
+
+`import { Wah } from '@jpdutoit/squelchy'`
+
+**Auto-Wah** — Classic wah-wah filter: a resonant bandpass swept by an internal LFO, with exponential (V/Oct) frequency response. Like a real pedal it boosts at the resonant peak, so RES changes the vocal character rather than the volume. Patch an envelope follower into V/OCT for auto-wah.
+
+Categories: Filters, Effects · Worklets: map-voct-to-freq
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for wah effect processing. |
+| `out` | output | audio | **Audio Output** — Funky, vocal-like wah audio output. |
+| `modFreq` | modulation | modulation | **Frequency V/Oct** — Modulate center frequency in semitones (V/Oct). Connect an envelope follower for auto-wah. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `note` | `79` | 55 – 95 notes | **Center Note** — Wah center frequency as a note (79 ≈ 800 Hz, 69 = 440 Hz). Drives the V/OCT worklet 1:1 — the panel knob shows the equivalent Hz. Automatable: `params.note` is a native AudioParam. |
+| `resonance` | `8` | 1 – 20 (log) | **Resonance** — How pronounced and vocal the wah peak sounds. |
+| `rate` | `1` | 0.1 – 10 Hz (log) | **Auto-Wah Rate** — Speed of the automatic wah sweep in Hz. Automatable: `params.rate` is a native AudioParam. |
+| `depth` | `0.6` | 0 – 1 | **Modulation Depth** — How much the frequency sweeps. Full depth ≈ 3 octaves. |
+
+## FOLD
+
+`import { Wavefolder } from '@jpdutoit/squelchy'`
+
+**Wavefolder** — West Coast synthesis classic. Folds waveform peaks back on themselves, adding rich harmonics. Essential for complex timbres from simple waves.
+
+Categories: Distortion
+
+### Ports
+
+| Slug | Direction | Signal | Description |
+|---|---|---|---|
+| `in` | input | audio | **Audio Input** — Audio signal for waveshaping/folding. |
+| `out` | output | audio | **Audio Output** — Harmonically rich wavefolded audio output. |
+
+### Params
+
+| Param | Default | Range | Description |
+|---|---|---|---|
+| `folds` | `2` | 1 – 10 | **Fold Amount** — How many times the waveform folds back. More folds = richer harmonics. |
+| `symmetry` | `0` | -1 – 1 | **Symmetry** — Asymmetric folding creates even harmonics for different timbres. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between original and wavefolded signal. Automatable: `params.mix` is a native AudioParam. |
+