@jpdutoit/squelchy 0.0.5 → 0.0.6

package/docs/MODULES.md

@@ -87,7 +87,7 @@ Categories: Filters · Worklets: adsr-envelope, map-voct-to-freq
 
 **Auto-Panner** — Stereo auto-panner using LFO-controlled panning. Creates movement and animation in the stereo field.
 
-Categories: Effects, Stereo
+Categories: Effects, Stereo · Worklets: waveshaper
 
 ### Ports
 
@@ -120,12 +120,15 @@ Categories: Distortion · Worklets: bitcrusher
 |---|---|---|---|
 | `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. |
+| `modBits` | modulation | modulation | **Bit Depth CV** — Added to the BITS knob, in bits (+1 = one more bit). Sweeps smoothly between depths; the result stays within 1–16. |
+| `modRate` | modulation | modulation | **Sample Rate CV** — Added to the RATE knob (+0.1 = 10% of the original rate). The result stays within 1–100%. |
+| `modMix` | modulation | modulation | **Mix CV** — Added to the MIX knob (+0.1 = 10% wetter). |
 
 ### 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. |
+| `bits` | `8` | 1 – 16 | **Bit Depth** — Number of bits for quantization. Lower = crunchier, more lo-fi. 1 bit = two levels: a hard full-scale square at the input's pitch. 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. |
 
@@ -151,7 +154,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). `set()` only. |
+| `depth` | `0.5` | 0 – 1 | **Modulation Depth** — How far each delay line swings around its 5.66 ms centre: ±4 ms at 1. About 0.46 matches a Juno-60's Chorus I/II swing; 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
@@ -184,27 +187,29 @@ Categories: Filters · Worklets: map-voct-to-period, comb-filter
 
 `import { Compressor } from '@jpdutoit/squelchy'`
 
-**Dynamics Compressor** — Reduces dynamic range by attenuating loud signals. Threshold sets where compression begins, ratio controls intensity.
+**Dynamics Compressor** — Feed-forward peak compressor with zero latency: turns loud signals down by RATIO above THRS, with attack and release that mean exactly what they say. Stereo signals get one linked gain, so the image never moves. A KEY input (side-chain) lets another signal do the squeezing.
 
-Categories: Dynamics
+Categories: Dynamics · Worklets: compressor
 
 ### Ports
 
 | Slug | Direction | Signal | Description |
 |---|---|---|---|
 | `in` | input | audio | **Audio Input** — Audio signal to compress. |
+| `key` | input | audio | **Key (Side-chain) Input** — What the compressor listens to when KEY is set to EXT, e.g. a kick drum to duck a bass. Ignored on INT. |
 | `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. |
+| `threshold` | `-24` | -60 – 0 dB | **Threshold** — Peak level (dBFS) above which compression kicks in. Lower = more compression. With a soft KNEE it eases in from half the knee width below. 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. `set()` only. |
+| `attack` | `0.003` | 0.0001 – 1 s (log) | **Attack** — How fast compression grabs a loud signal: the gain reduction gets 63% of the way in this time (nearly all of it in 3×), however hard you hit it. Automatable: `params.attack` is a native AudioParam. |
+| `release` | `0.25` | 0.01 – 1 s (log) | **Release** — How fast compression lets go once the signal drops: the gain reduction falls 63% of the way back in this time (nearly all of it in 3×). Automatable: `params.release` is a native AudioParam. |
+| `knee` | `10` | 0 – 40 dB | **Knee** — Width of the transition zone centred on 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. Automatable: `params.makeup` is a native AudioParam. |
+| `keySource` | `"internal"` | `internal` / `external` | **Key Source** — What the compressor listens to. INT: the signal it is compressing. EXT: whatever is patched into KEY (side-chain), e.g. a kick that ducks a bass or pad. The gain still lands on IN. `set()` only. |
 
 ## X-FADE
 
@@ -256,7 +261,7 @@ Categories: Time · Worklets: comb-filter
 
 `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.
+**Dimension Expander** — Roland Dimension D-style stereo widener: the dry signal plus two short antiphase-modulated delay lines, each cross-fed inverted into the opposite channel. Wide and moving in stereo, clean and unwarbled in mono.
 
 Categories: Effects
 
@@ -272,8 +277,9 @@ Categories: Effects
 
 | Param | Default | Range | Description |
 |---|---|---|---|
+| `width` | `1.5` | 0 – 2 | **Stereo Width** — Adjusts stereo image. 0=mono, 1=normal, 2=extra wide. Split across a four-gain matrix, so it is set-only (no single AudioParam carries it). `set()` only. |
 | `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). `set()` only. |
+| `depth` | `0.3` | 0 – 1 | **Modulation Depth** — How far the two BBD-style delay lines sweep (full = 1.65–5.35 ms, in antiphase). The dry signal stays in both channels, so this adds movement and width, not vibrato. Scaled onto the LFO gains, so it is set-only (no single AudioParam carries it 1:1). `set()` only. |
 
 ## DIST
 
@@ -281,7 +287,7 @@ Categories: Effects
 
 **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
+Categories: Distortion · Worklets: shaper
 
 ### Ports
 
@@ -405,7 +411,7 @@ Categories: Filters
 
 **Harmonic Exciter** — Adds high-frequency harmonics and "air" to dull signals. Generates subtle saturation in the treble range for presence and sparkle.
 
-Categories: Dynamics
+Categories: Dynamics · Worklets: shaper
 
 ### Ports
 
@@ -471,7 +477,7 @@ 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. `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. |
+| `resonance` | `6` | 1 – 20 (sqrt) | **Resonance** — Sharpness of the formant peaks. 6 = the bandwidths of a real voice (F1 ≈ 50–80 Hz wide); every band is 6/RES times that, so 1 is soft and blurred, 20 rings like a talk box. Loudness holds across the range. Automatable: `params.resonance` is a native AudioParam. |
 | `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
@@ -503,23 +509,25 @@ Categories: Effects · Worklets: freq-shifter
 
 **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
+Categories: Dynamics · Worklets: gate
 
 ### Ports
 
 | Slug | Direction | Signal | Description |
 |---|---|---|---|
 | `in` | input | audio | **Audio Input** — Audio signal to be gated. |
+| `key` | input | audio | **Key Input** — What opens the gate when KEY is set to EXT, e.g. a clock, a gate or a hi-hat. Ignored on INT. |
 | `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. `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. |
+| `threshold` | `-40` | -60 – 0 dB | **Threshold** — Level below which the gate closes and silences audio. Automatable: `params.threshold` is a native AudioParam. |
+| `range` | `0.8` | 0 – 1 | **Range** — How much the signal is attenuated when gate is closed. 0=full mute, lower=gentler. Automatable: `params.range` is a native AudioParam. |
 | `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. |
+| `keySource` | `"internal"` | `internal` / `external` | **Key Source** — What opens the gate. INT: the signal being gated. EXT: whatever is patched into KEY, e.g. a clock or hi-hat that chops a pad into rhythm. `set()` only. |
 
 ## GLIDE
 
@@ -589,7 +597,7 @@ Categories: Effects
 |---|---|---|---|
 | `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). `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. |
+| `crossover` | `800` | 200 – 2000 Hz | **Crossover Frequency** — Frequency where signal splits into low and high bands (−6 dB point of a Linkwitz-Riley 2nd-order pair: both bands 12 dB/oct, summing flat). One audio-rate value drives both filters, so modCrossover moves the split, not just one side. Automatable: `params.crossover` is a native AudioParam. |
 
 ## LADDER
 
@@ -647,9 +655,9 @@ Categories: Modulators · Worklets: waveshaper
 
 `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.
+**Lo-Fi Processor** — Vintage degradation: asymmetric tape-style saturation (quiet signals keep their level), a lowpass, vinyl hiss and crackle that never loops, and slow wow. Perfect for worn, dusty textures.
 
-Categories: Distortion, Vintage
+Categories: Distortion, Vintage · Worklets: shaper, vinyl-noise
 
 ### Ports
 
@@ -663,10 +671,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). `set()` only. |
+| `drive` | `0.3` | 0 – 1 | **Saturation** — How hard the signal hits an asymmetric tape-style curve (−18 dB clean … +24 dB heavy). Quiet signals keep their level; loud peaks round off with warm even harmonics. Set-only (it reshapes the curve). `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). `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. |
+| `noise` | `0.2` | 0 – 1 | **Vinyl Noise** — Level of the vinyl surface noise: steady hiss (about −44 dBFS at full) plus random dust ticks and pops. Never repeats. Automatable: `params.noise` is a native AudioParam. |
+| `wobble` | `0.1` | 0 – 1 | **Wobble** — Wow like a worn tape or warped record: a slow 0.73 Hz pitch drift, about ±16 cents at full. Adds WOB × 2 ms of average delay; none at 0. Automatable: `params.wobble` is a native AudioParam. |
 
 ## M/S
 
@@ -689,6 +697,7 @@ Categories: Stereo
 |---|---|---|---|
 | `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. |
+| `width` | `1` | 0 – 2 | **Stereo Width** — Overall stereo width multiplier applied after side gain. 0=mono, 1=normal, 2=wide. Automatable: `params.width` is a native AudioParam. |
 
 ## NOISE
 
@@ -791,7 +800,7 @@ Categories: Time · Worklets: ping-pong
 
 `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.
+**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. A strike starts every mode at the same level and the higher ones fade first; the same hit is equally loud on every note, at every STRUCT and DAMP setting.
 
 Categories: Filters · Worklets: map-voct-to-freq
 
@@ -809,15 +818,15 @@ 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. `set()` only. |
+| `structure` | `0` | 0 – 1 | **Structure** — Harmonic spacing of the resonator partials. Left = standard harmonic series, center = bell-like, right = metallic/inharmonic. Loudness holds across the knob. `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. |
+| `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between the input and the ringing modes. Fully wet by default, like a hardware resonator: at 1 you hear only the modes; turn it down to keep the original transient under the ring. 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.
+**Reverb Effect** — Algorithmic FDN reverb: sixteen damped delay lines cross-mixed through a slowly rotating matrix, so long tails stay smooth and never hum at fixed bass pitches. Left and right have their own lines and taps, so a stereo input keeps its image and a mono one gets a wide, decorrelated tail. Decay sets RT60 and updates smoothly, and nothing is re-rendered when you turn a knob.
 
 Categories: Time · Worklets: fdn-reverb
 
@@ -888,9 +897,9 @@ Categories: Effects, Vintage
 
 `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.
+**Tape Saturator** — Tape-style saturation aligned like a tape machine: quiet signals pass at the same level, loud peaks round off into warm odd harmonics and soft compression. DRIVE moves the knee (tone, not volume), WARMTH adds low-end weight. Subtle glue to heavy crunch.
 
-Categories: Distortion
+Categories: Distortion · Worklets: shaper
 
 ### Ports
 
@@ -903,8 +912,8 @@ Categories: Distortion
 
 | Param | Default | Range | Description |
 |---|---|---|---|
-| `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. |
+| `drive` | `0.5` | 0 – 1 | **Drive** — How hard the signal hits the tape curve, from −12 dB (clean) to +24 dB (heavy). The output is trimmed back by the same amount, like a tape machine aligned to its operating level: quiet signals pass at unity, loud peaks round off into harmonics and soft compression. DRIVE changes the tone, not the volume. Set-only (it reshapes the curve). `set()` only. |
+| `warmth` | `0.5` | 0 – 1 | **Warmth** — Low-shelf boost below 300 Hz, up to +6 dB, after the saturation. A tone control for low-end weight, not more distortion. `set()` only. |
 | `mix` | `1` | 0 – 1 | **Dry/Wet Mix** — Balance between clean and saturated signal. Automatable: `params.mix` is a native AudioParam. |
 
 ## SHIMMER
@@ -935,9 +944,9 @@ Categories: Time · Worklets: pitch-shifter, fdn-reverb
 
 `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.
+**Soft Limiter** — Static soft-clip limiter: a smooth curve rounds peaks off toward the ceiling, so the output never exceeds it. No attack or release; it shapes the waveform instantly instead of riding the gain, so pushing it hard adds saturation. Use the ceiling control to set the maximum output level.
 
-Categories: Dynamics
+Categories: Dynamics · Worklets: shaper
 
 ### Ports
 
@@ -999,6 +1008,7 @@ 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. `set()` only. |
+| `width` | `1` | 0 – 2 | **Dry/Wet** — Balance between mono (0%) and widened (200%) high frequencies. Automatable: `params.width` is a native AudioParam. |
 | `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
@@ -1217,7 +1227,7 @@ Categories: Filters, Effects · Worklets: map-voct-to-freq
 | `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. `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. `set()` only. |
+| `depth` | `0.6` | 0 – 1 | **Modulation Depth** — How much the frequency sweeps. Full depth = 3 octaves top to bottom (±1.5 octaves around the center). `set()` only. |
 
 ## FOLD
 
@@ -1225,7 +1235,7 @@ Categories: Filters, Effects · Worklets: map-voct-to-freq
 
 **Wavefolder** — West Coast synthesis classic. Folds waveform peaks back on themselves, adding rich harmonics. Essential for complex timbres from simple waves.
 
-Categories: Distortion
+Categories: Distortion · Worklets: shaper
 
 ### Ports