@jpdutoit/squelchy 0.0.1 → 0.0.3

package/docs/MODULES.md

@@ -1,6 +1,6 @@
 # @jpdutoit/squelchy — modules
 
-> Generated from module metadata by scripts/lib/build.ts — do not edit.
+> Generated from module metadata by scripts/lib/build.ts — do not edit. The same reference as JSON for `jq`: `docs/modules.json`; recipes: `docs/GUIDE.md`.
 
 **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.
 
@@ -76,9 +76,9 @@ Categories: Filters · Worklets: adsr-envelope, map-voct-to-freq
 | 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. |
+| `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. `set()` only. |
+| `envMod` | `0.7` | 0 – 1 | **Envelope Mod** — How much the triggered envelope sweeps the filter cutoff. `set()` only. |
+| `accent` | `0.5` | 0 – 1 | **Accent** — Intensifies the envelope sweep for more aggressive acid sounds. `set()` only. |
 | `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
@@ -104,7 +104,7 @@ Categories: Effects, Stereo
 |---|---|---|---|
 | `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. |
+| `shape` | `"sine"` | `sine` / `triangle` / `square` | **LFO Shape** — Waveform shape: sine for smooth, triangle for linear, square for hard left/right. `set()` only. |
 
 ## CRUSH
 
@@ -151,7 +151,7 @@ Categories: Time, Effects
 | 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). |
+| `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). `set()` only. |
 | `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
@@ -178,7 +178,7 @@ Categories: Filters · Worklets: map-voct-to-period, comb-filter
 | `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. |
+| `tuning` | `"chromatic"` | `chromatic` / `free` | **Tuning Mode** — CHROMATIC snaps the FREQ knob to semitones; FREE allows continuous tuning. `set()` only. |
 
 ## COMP
 
@@ -204,7 +204,7 @@ Categories: Dynamics
 | `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. |
+| `makeup` | `0` | 0 – 30 dB | **Makeup Gain** — Boosts the output level to compensate for gain reduction. Up to +30 dB. `set()` only. |
 
 ## X-FADE
 
@@ -227,7 +227,7 @@ Categories: Utility
 | 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. |
+| `curve` | `"equal-power"` | `linear` / `equal-power` | **Curve Type** — Linear or equal-power crossfade curve. `set()` only. |
 
 ## DELAY
 
@@ -273,7 +273,7 @@ Categories: Effects
 | 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). |
+| `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). `set()` only. |
 
 ## DIST
 
@@ -294,8 +294,8 @@ Categories: Distortion
 
 | 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. |
+| `distortionType` | `"soft"` | `soft` / `hard` / `fuzz` | **Clipping Curve** — Which clipping transfer curve the signal is pushed into. `set()` only. |
+| `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. `set()` only. |
 | `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. |
 
@@ -319,8 +319,8 @@ Categories: Dynamics · Worklets: env-follower
 
 | 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. |
+| `threshold` | `-24` | -60 – 0 dB | **Threshold** — Sidechain level that triggers ducking. Lower = more sensitive. `set()` only. |
+| `amount` | `0.7` | 0 – 1 | **Duck Amount** — How much to reduce the main signal when triggered. `set()` only. |
 | `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. |
 
@@ -345,7 +345,7 @@ Categories: Modulators, Utility · Worklets: env-follower
 |---|---|---|---|
 | `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. |
+| `sensitivity` | `0.5` | 0 – 1 | **Sensitivity** — Input gain before envelope detection. Higher = more responsive to quiet signals. `set()` only. |
 | `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
@@ -369,10 +369,10 @@ Categories: Modulators · Worklets: adsr-envelope
 
 | 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. |
+| `attack` | `0.01` | 0.001 – 2 s (log) | **Attack** — Time for the level to rise from zero to full, in a straight line. Automatable: `params.attack` is a native AudioParam. |
+| `decay` | `0.46` | 0.001 – 10 s (log) | **Decay** — Time to fall from the peak to the sustain level, on an exponential curve like an analog envelope. The time for the gap to sustain to shrink by 60 dB. 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. Moving it while a note is held glides at the decay speed. Automatable: `params.sustain` is a native AudioParam. |
+| `release` | `2.1` | 0.001 – 20 s (log) | **Release** — Time to fade to silence (60 dB down) after the note is released, on an exponential curve like an analog envelope. 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
@@ -418,8 +418,8 @@ Categories: Dynamics
 
 | 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. |
+| `drive` | `0.5` | 0 – 1 | **Drive** — Amount of harmonic saturation added to high frequencies. `set()` only. |
+| `frequency` | `4000` | 2000 – 8000 Hz (log) | **Frequency** — Cutoff frequency above which excitement is applied. `set()` only. |
 | `mix` | `0.5` | 0 – 1 | **Mix Amount** — How much excited signal is added to the original. Automatable: `params.mix` is a native AudioParam. |
 
 ## FLANGER
@@ -470,9 +470,9 @@ Categories: Filters · Worklets: formant-table
 
 | 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. |
+| `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. `set()` only. |
+| `resonance` | `6` | 1 – 20 (sqrt) | **Resonance** — Sharpness of the formant peaks, scaled per band. Higher values sound more pronounced and vocal. `set()` only. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between the original signal and the formant-filtered output. 0 = dry, 1 = fully wet. `set()` only. |
 
 ## SHIFT
 
@@ -516,8 +516,8 @@ Categories: Dynamics · Worklets: env-follower
 
 | 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. |
+| `threshold` | `-40` | -60 – 0 dB | **Threshold** — Level below which the gate closes and silences audio. `set()` only. |
+| `range` | `0.8` | 0 – 1 | **Range** — How much the signal is attenuated when gate is closed. 0=full mute, lower=gentler. `set()` only. |
 | `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. |
 
@@ -562,8 +562,8 @@ Categories: Stereo
 
 | 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. |
+| `delay` | `15` | 1 – 35 ms | **Micro-Delay** — Delay time in milliseconds (1–35 ms). The Haas effect range. `set()` only. |
+| `side` | `"right"` | `left` / `right` | **Delayed Side** — Which channel receives the delay — left or right. `set()` only. |
 | `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
@@ -588,7 +588,7 @@ Categories: Effects
 | 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). |
+| `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). `set()` only. |
 | `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
@@ -613,7 +613,7 @@ Categories: Filters · Worklets: ladder-filter, map-voct-to-freq
 | 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. |
+| `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. `set()` only. |
 | `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
@@ -663,10 +663,10 @@ Categories: Distortion, Vintage
 
 | 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). |
+| `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). `set()` only. |
 | `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). |
+| `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). `set()` only. |
+| `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). `set()` only. |
 
 ## M/S
 
@@ -709,7 +709,7 @@ Categories: Sources
 
 | Param | Default | Range | Description |
 |---|---|---|---|
-| `noiseType` | `"white"` | `white` / `pink` / `brown` | **Noise Color** — White, pink, or brown noise spectrum. |
+| `noiseType` | `"white"` | `white` / `pink` / `brown` | **Noise Color** — White, pink, or brown noise spectrum. `set()` only. |
 | `gain` | `0.3` | 0 – 1 | **Noise Level** — Output amplitude of the noise generator. Automatable: `params.gain` is a native AudioParam. |
 
 ## OCTAVE
@@ -759,7 +759,7 @@ Categories: Time, Effects
 | 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). |
+| `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). `set()` only. |
 | `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. |
 
@@ -784,7 +784,7 @@ Categories: Time · Worklets: ping-pong
 |---|---|---|---|
 | `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. |
+| `spread` | `1` | 0 – 1 | **Stereo Spread** — Controls how far left/right the bounces are panned. 0% = mono center, 100% = full stereo. `set()` only. |
 | `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and delayed signal. Automatable: `params.mix` is a native AudioParam. |
 
 ## RESO
@@ -809,8 +809,8 @@ Categories: Filters · Worklets: map-voct-to-freq
 | 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. |
+| `structure` | `0` | 0 – 1 | **Structure** — Harmonic spacing of the resonator partials. Left = standard harmonic series, center = bell-like, right = metallic/inharmonic. `set()` only. |
+| `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. `set()` only. |
 | `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and resonated signal. Automatable: `params.mix` is a native AudioParam. |
 
 ## REVERB
@@ -857,7 +857,7 @@ Categories: Effects · Worklets: map-voct-to-freq
 | 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. |
+| `mix` | `0.5` | 0 – 1 | **Dry/Wet Mix** — Balance between original and ring-modulated signal. `set()` only. |
 
 ## ROTARY
 
@@ -879,9 +879,9 @@ Categories: Effects, Vintage
 
 | 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. |
+| `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. `set()` only. |
+| `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. `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. `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
@@ -903,8 +903,8 @@ Categories: Distortion
 
 | 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. |
+| `drive` | `0.5` | 0 – 1 | **Drive** — How hard to push into saturation. Adds harmonics and soft compression. `set()` only. |
+| `warmth` | `0.5` | 0 – 1 | **Warmth** — Low frequency emphasis for a thicker, analog-like tone. `set()` only. |
 | `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between clean and saturated signal. Automatable: `params.mix` is a native AudioParam. |
 
 ## SHIMMER
@@ -926,10 +926,10 @@ Categories: Time · Worklets: pitch-shifter, fdn-reverb
 
 | 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. |
+| `decay` | `3` | 0.5 – 10 s (log) | **Reverb Decay** — RT60 of the reverb tank in seconds — the time to fall 60 dB, measured at 500 Hz. Treble dies faster, like a real hall. `set()` only. |
+| `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. `set()` only. |
 | `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. |
+| `shimmer` | `0.5` | 0 – 0.95 | **Shimmer Regen** — Gain once round the pitch-shifted feedback loop, measured at 500 Hz: 0.5 = each new octave 6 dB quieter than the last, 0.95 = an almost endless rising choir. Means the same at every DECAY setting. Automatable: `params.shimmer` is a native AudioParam. |
 
 ## LIMIT
 
@@ -950,9 +950,9 @@ Categories: Dynamics
 
 | 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. |
+| `drive` | `0.5` | 0 – 1 | **Input Drive** — Pushes signal into the limiter for more saturation and loudness. `set()` only. |
+| `knee` | `0.5` | 0 – 1 | **Soft Knee** — How gradually limiting kicks in. Higher = softer, more transparent. `set()` only. |
+| `ceiling` | `-0.5` | -12 – 0 dB | **Ceiling** — Maximum output level in dB. Prevents clipping above this level. `set()` only. |
 
 ## SPRING
 
@@ -998,8 +998,8 @@ Categories: Stereo
 
 | 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. |
+| `spread` | `0.7` | 0 – 1 | **Spread Amount** — Controls the micro-delay time for Haas widening (0–5ms). More spread = wider perceived stereo image. `set()` only. |
+| `center` | `800` | 200 – 2000 Hz (log) | **Crossover Frequency** — Frequency above which Haas spreading is applied. Lows below this stay centered for mono compatibility. `set()` only. |
 
 ## SUB OCT
 
@@ -1091,8 +1091,8 @@ Categories: Filters
 
 | 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. |
+| `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. `set()` only. |
+| `frequency` | `1000` | 200 – 5000 Hz | **Pivot Frequency** — Center frequency around which the tilt occurs, shared by both the low and high shelf filters. `set()` only. |
 
 ## TREMOLO
 
@@ -1115,8 +1115,8 @@ Categories: Effects
 | 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. |
+| `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). `set()` only. |
+| `shape` | `"sine"` | `sine` / `triangle` / `square` | **LFO Shape** — Waveform shape: sine for smooth, triangle for linear, square for choppy. `set()` only. |
 
 ## VCA
 
@@ -1162,9 +1162,9 @@ Categories: Filters · Worklets: map-res, map-voct-to-freq
 
 | Param | Default | Range | Description |
 |---|---|---|---|
-| `filterType` | `"lowpass"` | `lowpass` / `highpass` / `bandpass` / `notch` | **Filter Type** — Selects lowpass, highpass, bandpass, or notch response. |
+| `filterType` | `"lowpass"` | `lowpass` / `highpass` / `bandpass` / `notch` | **Filter Type** — Selects lowpass, highpass, bandpass, or notch response. `set()` only. |
 | `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. |
+| `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. `set()` only. |
 
 ## VCO
 
@@ -1215,9 +1215,9 @@ Categories: Filters, Effects · Worklets: map-voct-to-freq
 | 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. |
+| `resonance` | `8` | 1 – 20 (log) | **Resonance** — How pronounced and vocal the wah peak sounds. `set()` only. |
 | `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. |
+| `depth` | `0.6` | 0 – 1 | **Modulation Depth** — How much the frequency sweeps. Full depth ≈ 3 octaves. `set()` only. |
 
 ## FOLD
 
@@ -1238,7 +1238,7 @@ Categories: Distortion
 
 | 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. |
+| `folds` | `2` | 1 – 10 | **Fold Amount** — How many times the waveform folds back. More folds = richer harmonics. `set()` only. |
+| `symmetry` | `0` | -1 – 1 | **Symmetry** — Asymmetric folding creates even harmonics for different timbres. `set()` only. |
 | `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between original and wavefolded signal. Automatable: `params.mix` is a native AudioParam. |