@jpdutoit/squelchy 0.0.1 → 0.0.2

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
@@ -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,8 +926,8 @@ 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. `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. |
 
@@ -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. |