From 2efd56e33155096dd4454f9fe68e6b5f43bdc1e1 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sat, 22 Nov 2025 18:10:28 -0500
Subject: [PATCH 01/17] add synonym

---
 packages/core/controls.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 9a2be7f4..8297746d 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1840,7 +1840,7 @@ export const { octave } = registerControl('octave');
  *   s("~ sd ~ sd").delay(.5).delaytime(.125).orbit(2)
  * )
  */
-export const { orbit } = registerControl('orbit');
+export const { orbit } = registerControl('orbit', 'o');
 // TODO: what is this? not found in tidal doc Answer: gain is limited to maximum of 2. This allows you to go over that
 export const { overgain } = registerControl('overgain');
 // TODO: what is this? not found in tidal doc. Similar to above, but limited to 1

From 30e672a0271bf3233859230ef96cfe8b9cecc1cd Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sat, 22 Nov 2025 22:49:23 -0500
Subject: [PATCH 02/17] wip

---
 packages/superdough/helpers.mjs    | 27 ++++++++++++++++++++++-----
 packages/superdough/superdough.mjs |  2 +-
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 8e45f7bc..7bca637f 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -191,8 +191,10 @@ export function applyParameterModulators(audioContext, param, start, end, envelo
   const lfo = getParamLfo(audioContext, param, start, end, lfoValues);
   return { lfo, disconnect: () => lfo?.disconnect() };
 }
-
-export function createFilter(context, start, end, params, cps) {
+function biloparExponential(x, k) {
+  return Math.sign(x) * 2 ** (Math.abs(x) * k);
+}
+export function createFilter(context, start, end, params, cps, cycle) {
   let {
     frequency,
     anchor,
@@ -231,6 +233,7 @@ export function createFilter(context, start, end, params, cps) {
     const offset = envAbs * anchor;
     let min = clamp(2 ** -offset * frequency, 0, 20000);
     let max = clamp(2 ** (envAbs - offset) * frequency, 0, 20000);
+
     if (env < 0) [min, max] = [max, min];
     getParamADSR(frequencyParam, attack, decay, sustain, release, min, max, start, end, 'exponential');
   }
@@ -238,8 +241,22 @@ export function createFilter(context, start, end, params, cps) {
   if (sync != null) {
     rate = cps * sync;
   }
-  const lfoValues = { depth, dcoffset, skew, shape, frequency: rate, min: 10, max: 20000 };
-  getParamLfo(context, frequencyParam, start, end, lfoValues);
+  const hasLFO = [depth, skew, shape, rate].some((v) => v !== undefined);
+  if (hasLFO) {
+    depth = depth ?? 1
+
+    const mag = Math.abs(depth);
+    const sign = Math.sign(depth);
+
+    const shaped = 2 ** (mag * (1 - dcoffset));
+    const dp = clamp((sign * shaped * frequency) - frequency, -20000, 20000);
+    console.info(dp)
+    const time = cycle / cps;
+    // let d = 2 ** -dcoffset
+    const lfoValues = { depth: dp, dcoffset, skew, shape, frequency: rate, min: 10, max: 20000, time };
+    getParamLfo(context, frequencyParam, start, end, lfoValues);
+  }
+
   return filter;
 }
 
@@ -386,7 +403,7 @@ export function applyFM(param, value, begin) {
     duration,
   } = value;
   let modulator;
-  let stop = () => {};
+  let stop = () => { };
 
   if (fmModulationIndex) {
     const ac = getAudioContext();
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 650f9c2c..4e1a145c 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -559,7 +559,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     };
     const lpParams = pickAndRename(value, lpMap);
     lpParams.type = 'lowpass';
-    let lp = () => createFilter(ac, t, end, lpParams, cps);
+    let lp = () => createFilter(ac, t, end, lpParams, cps, cycle);
     chain.push(lp());
     if (ftype === '24db') {
       chain.push(lp());

From 7bbb653963ace62fdf7f5aba33600da576927d02 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sat, 22 Nov 2025 23:42:20 -0500
Subject: [PATCH 03/17] fixed

---
 packages/core/controls.mjs      |  7 +++++++
 packages/superdough/helpers.mjs | 28 +++++++++++++---------------
 2 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 9a2be7f4..29916997 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1294,6 +1294,8 @@ export const { fanchor } = registerControl('fanchor');
  *
  * @name lprate
  * @param {number | Pattern} rate rate in hertz
+ * @example
+ * note("<c c c# c c c4>*16").s("sawtooth").lpf(600).lprate("<4 8 2 1>")
  */
 export const { lprate } = registerControl('lprate');
 
@@ -1302,6 +1304,8 @@ export const { lprate } = registerControl('lprate');
  *
  * @name lpsync
  * @param {number | Pattern} rate rate in cycles
+ * @example
+ * note("<c c c# c c c4>*16").s("sawtooth").lpf(600).lpsync("<4 8 2 1>")
  */
 export const { lpsync } = registerControl('lpsync');
 
@@ -1310,7 +1314,10 @@ export const { lpsync } = registerControl('lpsync');
  *
  * @name lpdepth
  * @param {number | Pattern} depth depth of modulation
+ * @example
+ * note("<c c c# c c c4>*16").s("sawtooth").lpf(600).lpdepth("<1 .5 1.8 0>")
  */
+
 export const { lpdepth } = registerControl('lpdepth');
 
 /**
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 7bca637f..65f5cc36 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -191,9 +191,6 @@ export function applyParameterModulators(audioContext, param, start, end, envelo
   const lfo = getParamLfo(audioContext, param, start, end, lfoValues);
   return { lfo, disconnect: () => lfo?.disconnect() };
 }
-function biloparExponential(x, k) {
-  return Math.sign(x) * 2 ** (Math.abs(x) * k);
-}
 export function createFilter(context, start, end, params, cps, cycle) {
   let {
     frequency,
@@ -233,7 +230,6 @@ export function createFilter(context, start, end, params, cps, cycle) {
     const offset = envAbs * anchor;
     let min = clamp(2 ** -offset * frequency, 0, 20000);
     let max = clamp(2 ** (envAbs - offset) * frequency, 0, 20000);
-
     if (env < 0) [min, max] = [max, min];
     getParamADSR(frequencyParam, attack, decay, sustain, release, min, max, start, end, 'exponential');
   }
@@ -243,17 +239,19 @@ export function createFilter(context, start, end, params, cps, cycle) {
   }
   const hasLFO = [depth, skew, shape, rate].some((v) => v !== undefined);
   if (hasLFO) {
-    depth = depth ?? 1
-
-    const mag = Math.abs(depth);
-    const sign = Math.sign(depth);
-
-    const shaped = 2 ** (mag * (1 - dcoffset));
-    const dp = clamp((sign * shaped * frequency) - frequency, -20000, 20000);
-    console.info(dp)
+    depth = depth ?? 1;
     const time = cycle / cps;
-    // let d = 2 ** -dcoffset
-    const lfoValues = { depth: dp, dcoffset, skew, shape, frequency: rate, min: 10, max: 20000, time };
+    const lfoValues = {
+      depth: (depth ?? 1) * frequency,
+      dcoffset,
+      skew,
+      shape,
+      frequency: rate ?? cps,
+      min: -frequency + 30,
+      max: 20000 - frequency,
+      time,
+      curve: 1,
+    };
     getParamLfo(context, frequencyParam, start, end, lfoValues);
   }
 
@@ -403,7 +401,7 @@ export function applyFM(param, value, begin) {
     duration,
   } = value;
   let modulator;
-  let stop = () => { };
+  let stop = () => {};
 
   if (fmModulationIndex) {
     const ac = getAudioContext();

From bde17594ceae18ed4a483715932b124638b62d72 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 00:33:52 -0500
Subject: [PATCH 04/17] test

---
 test/__snapshots__/examples.test.mjs.snap | 207 ++++++++++++++++++++++
 1 file changed, 207 insertions(+)

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 31e4bddd..4345eedb 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -5969,6 +5969,75 @@ exports[`runs examples > example "lpdecay" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "lpdepth" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 1/16 → 1/8 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 1/8 → 3/16 | note:c# s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 3/16 → 1/4 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 1/4 → 5/16 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 5/16 → 3/8 | note:c4 s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 3/8 → 7/16 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 7/16 → 1/2 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 1/2 → 9/16 | note:c# s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 9/16 → 5/8 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 5/8 → 11/16 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 11/16 → 3/4 | note:c4 s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 3/4 → 13/16 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 13/16 → 7/8 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 7/8 → 15/16 | note:c# s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 15/16 → 1/1 | note:c s:sawtooth cutoff:600 lpdepth:1 ]",
+  "[ 1/1 → 17/16 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 17/16 → 9/8 | note:c4 s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 9/8 → 19/16 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 19/16 → 5/4 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 5/4 → 21/16 | note:c# s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 21/16 → 11/8 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 11/8 → 23/16 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 23/16 → 3/2 | note:c4 s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 3/2 → 25/16 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 25/16 → 13/8 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 13/8 → 27/16 | note:c# s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 27/16 → 7/4 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 7/4 → 29/16 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 29/16 → 15/8 | note:c4 s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 15/8 → 31/16 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 31/16 → 2/1 | note:c s:sawtooth cutoff:600 lpdepth:0.5 ]",
+  "[ 2/1 → 33/16 | note:c# s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 33/16 → 17/8 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 17/8 → 35/16 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 35/16 → 9/4 | note:c4 s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 9/4 → 37/16 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 37/16 → 19/8 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 19/8 → 39/16 | note:c# s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 39/16 → 5/2 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 5/2 → 41/16 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 41/16 → 21/8 | note:c4 s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 21/8 → 43/16 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 43/16 → 11/4 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 11/4 → 45/16 | note:c# s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 45/16 → 23/8 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 23/8 → 47/16 | note:c s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 47/16 → 3/1 | note:c4 s:sawtooth cutoff:600 lpdepth:1.8 ]",
+  "[ 3/1 → 49/16 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 49/16 → 25/8 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 25/8 → 51/16 | note:c# s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 51/16 → 13/4 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 13/4 → 53/16 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 53/16 → 27/8 | note:c4 s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 27/8 → 55/16 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 55/16 → 7/2 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 7/2 → 57/16 | note:c# s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 57/16 → 29/8 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 29/8 → 59/16 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 59/16 → 15/4 | note:c4 s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 15/4 → 61/16 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 61/16 → 31/8 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 31/8 → 63/16 | note:c# s:sawtooth cutoff:600 lpdepth:0 ]",
+  "[ 63/16 → 4/1 | note:c s:sawtooth cutoff:600 lpdepth:0 ]",
+]
+`;
+
 exports[`runs examples > example "lpenv" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c2 s:sawtooth cutoff:300 lpattack:0.5 lpenv:4 ]",
@@ -6157,6 +6226,75 @@ exports[`runs examples > example "lpq" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "lprate" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 1/16 → 1/8 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 1/8 → 3/16 | note:c# s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 3/16 → 1/4 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 1/4 → 5/16 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 5/16 → 3/8 | note:c4 s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 3/8 → 7/16 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 7/16 → 1/2 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 1/2 → 9/16 | note:c# s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 9/16 → 5/8 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 5/8 → 11/16 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 11/16 → 3/4 | note:c4 s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 3/4 → 13/16 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 13/16 → 7/8 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 7/8 → 15/16 | note:c# s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 15/16 → 1/1 | note:c s:sawtooth cutoff:600 lprate:4 ]",
+  "[ 1/1 → 17/16 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 17/16 → 9/8 | note:c4 s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 9/8 → 19/16 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 19/16 → 5/4 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 5/4 → 21/16 | note:c# s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 21/16 → 11/8 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 11/8 → 23/16 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 23/16 → 3/2 | note:c4 s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 3/2 → 25/16 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 25/16 → 13/8 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 13/8 → 27/16 | note:c# s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 27/16 → 7/4 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 7/4 → 29/16 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 29/16 → 15/8 | note:c4 s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 15/8 → 31/16 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 31/16 → 2/1 | note:c s:sawtooth cutoff:600 lprate:8 ]",
+  "[ 2/1 → 33/16 | note:c# s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 33/16 → 17/8 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 17/8 → 35/16 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 35/16 → 9/4 | note:c4 s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 9/4 → 37/16 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 37/16 → 19/8 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 19/8 → 39/16 | note:c# s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 39/16 → 5/2 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 5/2 → 41/16 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 41/16 → 21/8 | note:c4 s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 21/8 → 43/16 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 43/16 → 11/4 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 11/4 → 45/16 | note:c# s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 45/16 → 23/8 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 23/8 → 47/16 | note:c s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 47/16 → 3/1 | note:c4 s:sawtooth cutoff:600 lprate:2 ]",
+  "[ 3/1 → 49/16 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 49/16 → 25/8 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 25/8 → 51/16 | note:c# s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 51/16 → 13/4 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 13/4 → 53/16 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 53/16 → 27/8 | note:c4 s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 27/8 → 55/16 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 55/16 → 7/2 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 7/2 → 57/16 | note:c# s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 57/16 → 29/8 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 29/8 → 59/16 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 59/16 → 15/4 | note:c4 s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 15/4 → 61/16 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 61/16 → 31/8 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 31/8 → 63/16 | note:c# s:sawtooth cutoff:600 lprate:1 ]",
+  "[ 63/16 → 4/1 | note:c s:sawtooth cutoff:600 lprate:1 ]",
+]
+`;
+
 exports[`runs examples > example "lprelease" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c2 s:sawtooth clip:0.5 cutoff:300 lpenv:4 lprelease:0.5 release:0.5 ]",
@@ -6199,6 +6337,75 @@ exports[`runs examples > example "lpsustain" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "lpsync" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 1/16 → 1/8 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 1/8 → 3/16 | note:c# s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 3/16 → 1/4 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 1/4 → 5/16 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 5/16 → 3/8 | note:c4 s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 3/8 → 7/16 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 7/16 → 1/2 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 1/2 → 9/16 | note:c# s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 9/16 → 5/8 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 5/8 → 11/16 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 11/16 → 3/4 | note:c4 s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 3/4 → 13/16 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 13/16 → 7/8 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 7/8 → 15/16 | note:c# s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 15/16 → 1/1 | note:c s:sawtooth cutoff:600 lpsync:4 ]",
+  "[ 1/1 → 17/16 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 17/16 → 9/8 | note:c4 s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 9/8 → 19/16 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 19/16 → 5/4 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 5/4 → 21/16 | note:c# s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 21/16 → 11/8 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 11/8 → 23/16 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 23/16 → 3/2 | note:c4 s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 3/2 → 25/16 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 25/16 → 13/8 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 13/8 → 27/16 | note:c# s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 27/16 → 7/4 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 7/4 → 29/16 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 29/16 → 15/8 | note:c4 s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 15/8 → 31/16 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 31/16 → 2/1 | note:c s:sawtooth cutoff:600 lpsync:8 ]",
+  "[ 2/1 → 33/16 | note:c# s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 33/16 → 17/8 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 17/8 → 35/16 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 35/16 → 9/4 | note:c4 s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 9/4 → 37/16 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 37/16 → 19/8 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 19/8 → 39/16 | note:c# s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 39/16 → 5/2 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 5/2 → 41/16 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 41/16 → 21/8 | note:c4 s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 21/8 → 43/16 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 43/16 → 11/4 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 11/4 → 45/16 | note:c# s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 45/16 → 23/8 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 23/8 → 47/16 | note:c s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 47/16 → 3/1 | note:c4 s:sawtooth cutoff:600 lpsync:2 ]",
+  "[ 3/1 → 49/16 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 49/16 → 25/8 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 25/8 → 51/16 | note:c# s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 51/16 → 13/4 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 13/4 → 53/16 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 53/16 → 27/8 | note:c4 s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 27/8 → 55/16 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 55/16 → 7/2 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 7/2 → 57/16 | note:c# s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 57/16 → 29/8 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 29/8 → 59/16 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 59/16 → 15/4 | note:c4 s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 15/4 → 61/16 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 61/16 → 31/8 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 31/8 → 63/16 | note:c# s:sawtooth cutoff:600 lpsync:1 ]",
+  "[ 63/16 → 4/1 | note:c s:sawtooth cutoff:600 lpsync:1 ]",
+]
+`;
+
 exports[`runs examples > example "lrate" example index 0 1`] = `
 [
   "[ 0/1 → 1/1 | n:0 s:supersquare leslie:1 lrate:1 ]",

From cf12e3e1d8892de00d20a5c6f4e1a5a164cbc3f5 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 12:21:55 -0600
Subject: [PATCH 05/17] Hook up the octave control

---
 packages/superdough/helpers.mjs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index de64df0e..59608698 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -517,7 +517,7 @@ export const getDistortion = (distort, postgain, algorithm) => {
 };
 
 export const getFrequencyFromValue = (value, defaultNote = 36) => {
-  let { note, freq } = value;
+  let { note, freq, octave = 0 } = value;
   note = note || defaultNote;
   if (typeof note === 'string') {
     note = noteToMidi(note); // e.g. c3 => 48
@@ -526,7 +526,7 @@ export const getFrequencyFromValue = (value, defaultNote = 36) => {
   if (!freq && typeof note === 'number') {
     freq = midiToFreq(note); // + 48);
   }
-
+  freq *= Math.pow(2, octave);
   return Number(freq);
 };
 

From 6c0d550b6b3629312eb8e65719781c28effab943 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 12:25:40 -0600
Subject: [PATCH 06/17] Fix example

---
 packages/core/controls.mjs                |  3 +--
 test/__snapshots__/examples.test.mjs.snap | 24 +++++++++++------------
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 9a2be7f4..5c5883e9 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1822,8 +1822,7 @@ export const { nudge } = registerControl('nudge');
  * @name octave
  * @param {number | Pattern} octave octave number
  * @example
- * n("0,4,7").s('supersquare').octave("<3 4 5 6>").osc()
- * @superDirtOnly
+ * n("0,4,7").scale("F:minor").s('supersaw').octave("<0 1 2 3>")
  */
 export const { octave } = registerControl('octave');
 
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 31e4bddd..4d4da8b2 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -6888,18 +6888,18 @@ exports[`runs examples > example "nrpv" example index 0 1`] = `
 
 exports[`runs examples > example "octave" example index 0 1`] = `
 [
-  "[ 0/1 → 1/1 | n:0 s:supersquare octave:3 ]",
-  "[ 0/1 → 1/1 | n:4 s:supersquare octave:3 ]",
-  "[ 0/1 → 1/1 | n:7 s:supersquare octave:3 ]",
-  "[ 1/1 → 2/1 | n:0 s:supersquare octave:4 ]",
-  "[ 1/1 → 2/1 | n:4 s:supersquare octave:4 ]",
-  "[ 1/1 → 2/1 | n:7 s:supersquare octave:4 ]",
-  "[ 2/1 → 3/1 | n:0 s:supersquare octave:5 ]",
-  "[ 2/1 → 3/1 | n:4 s:supersquare octave:5 ]",
-  "[ 2/1 → 3/1 | n:7 s:supersquare octave:5 ]",
-  "[ 3/1 → 4/1 | n:0 s:supersquare octave:6 ]",
-  "[ 3/1 → 4/1 | n:4 s:supersquare octave:6 ]",
-  "[ 3/1 → 4/1 | n:7 s:supersquare octave:6 ]",
+  "[ 0/1 → 1/1 | note:F3 s:supersaw octave:0 ]",
+  "[ 0/1 → 1/1 | note:C4 s:supersaw octave:0 ]",
+  "[ 0/1 → 1/1 | note:F4 s:supersaw octave:0 ]",
+  "[ 1/1 → 2/1 | note:F3 s:supersaw octave:1 ]",
+  "[ 1/1 → 2/1 | note:C4 s:supersaw octave:1 ]",
+  "[ 1/1 → 2/1 | note:F4 s:supersaw octave:1 ]",
+  "[ 2/1 → 3/1 | note:F3 s:supersaw octave:2 ]",
+  "[ 2/1 → 3/1 | note:C4 s:supersaw octave:2 ]",
+  "[ 2/1 → 3/1 | note:F4 s:supersaw octave:2 ]",
+  "[ 3/1 → 4/1 | note:F3 s:supersaw octave:3 ]",
+  "[ 3/1 → 4/1 | note:C4 s:supersaw octave:3 ]",
+  "[ 3/1 → 4/1 | note:F4 s:supersaw octave:3 ]",
 ]
 `;
 

From 3b2df0b72510a1a217242fd6281e6a06270e18a5 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 19:05:57 -0500
Subject: [PATCH 07/17] synonym:

---
 packages/core/controls.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 8297746d..809a45ab 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1833,6 +1833,7 @@ export const { octave } = registerControl('octave');
  * An `orbit` is a global parameter context for patterns. Patterns with the same orbit will share the same global effects.
  *
  * @name orbit
+ * @synonyms o
  * @param {number | Pattern} number
  * @example
  * stack(

From e86850b6d83a16f7a0d7e5a64648d62b0035d18f Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Mon, 24 Nov 2025 11:19:49 -0500
Subject: [PATCH 08/17] frequency mod

---
 packages/core/controls.mjs         | 40 +++++++++++++++++++++++++++++-
 packages/superdough/helpers.mjs    |  7 ++++--
 packages/superdough/superdough.mjs |  7 ++++--
 3 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 2ff2089d..a9d7cc26 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1319,6 +1319,18 @@ export const { lpsync } = registerControl('lpsync');
  */
 
 export const { lpdepth } = registerControl('lpdepth');
+/**
+ * Depth of the LFO for the lowpass filter, in HZ
+ *
+ * @name lpdepthfrequency
+ * @synonyms
+ * lpdethfreq
+ * @param {number | Pattern} depth depth of modulation
+ * @example
+ * note("<c c c# c c c4>*16").s("sawtooth").lpf(600).lpdepthfrequency("<200 500 100 0>")
+ */
+
+export const { lpdepthfrequency } = registerControl('lpdepthfrequency', 'lpdepthfreq');
 
 /**
  * Shape of the LFO for the lowpass filter
@@ -1368,6 +1380,19 @@ export const { bpsync } = registerControl('bpsync');
  */
 export const { bpdepth } = registerControl('bpdepth');
 
+/**
+ * Depth of the LFO for the bandpass filter, in HZ
+ *
+ * @name bpdepthfrequency
+ * @synonyms
+ * bpdethfreq
+ * @param {number | Pattern} depth depth of modulation
+ * @example
+ * note("<c c c# c c c4>*16").s("sawtooth").lpf(600).bpdepthfrequency("<200 500 100 0>")
+ */
+
+export const { bpdepthfrequency } = registerControl('bpdepthfrequency', 'bpdepthfreq');
+
 /**
  * Shape of the LFO for the bandpass filter
  *
@@ -1414,7 +1439,20 @@ export const { hpsync } = registerControl('hpsync');
  * @name hpdepth
  * @param {number | Pattern} depth depth of modulation
  */
-export const { hpdepth } = registerControl('hpdepth');
+export const { hpdepth, hpdepthfreq } = registerControl('hpdepth');
+
+/**
+ * Depth of the LFO for the hipass filter, in hz
+ *
+ * @name hpdepthfrequency
+ * @synonyms
+ * hpdethfreq
+ * @param {number | Pattern} depth depth of modulation
+ * @example
+ * note("<c c c# c c c4>*16").s("sawtooth").lpf(600).hpdepthfrequency("<200 500 100 0>")
+ */
+
+export const { hpdepthfrequency } = registerControl('hpdepthfrequency', 'hpdepthfreq');
 
 /**
  * Shape of the LFO for the highpass filter
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 11427dc5..ad11f595 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -201,12 +201,14 @@ export function createFilter(context, start, end, params, cps, cycle) {
     q = 1,
     drive = 0.69,
     depth,
+    depthfrequency,
     dcoffset = -0.5,
     skew,
     shape,
     rate,
     sync,
   } = params;
+
   let frequencyParam, filter;
   if (model === 'ladder') {
     filter = getWorklet(context, 'ladder-processor', { frequency, q, drive });
@@ -237,12 +239,13 @@ export function createFilter(context, start, end, params, cps, cycle) {
   if (sync != null) {
     rate = cps * sync;
   }
-  const hasLFO = [depth, skew, shape, rate].some((v) => v !== undefined);
+  const hasLFO = [depth, depthfrequency, skew, shape, rate].some((v) => v !== undefined);
   if (hasLFO) {
     depth = depth ?? 1;
     const time = cycle / cps;
+    const modDepth = depthfrequency ?? (depth ?? 1) * frequency;
     const lfoValues = {
-      depth: (depth ?? 1) * frequency,
+      depth: modDepth,
       dcoffset,
       skew,
       shape,
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 4e1a145c..e3177c7d 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -553,6 +553,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
       rate: 'lprate',
       sync: 'lpsync',
       depth: 'lpdepth',
+      depthfrequency: 'lpdepthfrequency',
       shape: 'lpshape',
       dcoffset: 'lpdc',
       skew: 'lpskew',
@@ -581,13 +582,14 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
       rate: 'hprate',
       sync: 'hpsync',
       depth: 'hpdepth',
+      depthfrequency: 'hpdepthfrequency',
       shape: 'hpshape',
       dcoffset: 'hpdc',
       skew: 'hpskew',
     };
     const hpParams = pickAndRename(value, hpMap);
     hpParams.type = 'highpass';
-    let hp = () => createFilter(ac, t, end, hpParams, cps);
+    let hp = () => createFilter(ac, t, end, hpParams, cps, cycle);
     chain.push(hp());
     if (ftype === '24db') {
       chain.push(hp());
@@ -609,13 +611,14 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
       rate: 'bprate',
       sync: 'bpsync',
       depth: 'bpdepth',
+      depthfrequency: 'bpdepthfrequency',
       shape: 'bpshape',
       dcoffset: 'bpdc',
       skew: 'bpskew',
     };
     const bpParams = pickAndRename(value, bpMap);
     bpParams.type = 'bandpass';
-    let bp = () => createFilter(ac, t, end, bpParams, cps);
+    let bp = () => createFilter(ac, t, end, bpParams, cps, cycle);
     chain.push(bp());
     if (ftype === '24db') {
       chain.push(bp());

From a3947d1ccf9d056cdc3c573b44432d7b3e05cfdc Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Mon, 24 Nov 2025 16:33:20 +0000
Subject: [PATCH 09/17] [perf] fix `connect-leak` from audioworklet=>param in
 lfo/tremolo

---
 packages/superdough/superdough.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 650f9c2c..a549ff68 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -665,6 +665,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
       curve: 1.5,
     });
     lfo.connect(amGain.gain);
+    audioNodes.push(lfo);
     chain.push(amGain);
   }
 

From 7ee6b933cc032c698eef1ac2bfd5f83eafc4a3ef Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Mon, 24 Nov 2025 11:33:21 -0500
Subject: [PATCH 10/17] add tests

---
 test/__snapshots__/examples.test.mjs.snap | 207 ++++++++++++++++++++++
 1 file changed, 207 insertions(+)

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 4345eedb..8cbee39d 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -1391,6 +1391,75 @@ exports[`runs examples > example "bpdecay" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "bpdepthfrequency" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 1/16 → 1/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 1/8 → 3/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 3/16 → 1/4 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 1/4 → 5/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 5/16 → 3/8 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 3/8 → 7/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 7/16 → 1/2 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 1/2 → 9/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 9/16 → 5/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 5/8 → 11/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 11/16 → 3/4 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 3/4 → 13/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 13/16 → 7/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 7/8 → 15/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 15/16 → 1/1 | note:c s:sawtooth cutoff:600 bpdepthfrequency:200 ]",
+  "[ 1/1 → 17/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 17/16 → 9/8 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 9/8 → 19/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 19/16 → 5/4 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 5/4 → 21/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 21/16 → 11/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 11/8 → 23/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 23/16 → 3/2 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 3/2 → 25/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 25/16 → 13/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 13/8 → 27/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 27/16 → 7/4 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 7/4 → 29/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 29/16 → 15/8 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 15/8 → 31/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 31/16 → 2/1 | note:c s:sawtooth cutoff:600 bpdepthfrequency:500 ]",
+  "[ 2/1 → 33/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 33/16 → 17/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 17/8 → 35/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 35/16 → 9/4 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 9/4 → 37/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 37/16 → 19/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 19/8 → 39/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 39/16 → 5/2 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 5/2 → 41/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 41/16 → 21/8 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 21/8 → 43/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 43/16 → 11/4 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 11/4 → 45/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 45/16 → 23/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 23/8 → 47/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 47/16 → 3/1 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:100 ]",
+  "[ 3/1 → 49/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 49/16 → 25/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 25/8 → 51/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 51/16 → 13/4 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 13/4 → 53/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 53/16 → 27/8 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 27/8 → 55/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 55/16 → 7/2 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 7/2 → 57/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 57/16 → 29/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 29/8 → 59/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 59/16 → 15/4 | note:c4 s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 15/4 → 61/16 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 61/16 → 31/8 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 31/8 → 63/16 | note:c# s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+  "[ 63/16 → 4/1 | note:c s:sawtooth cutoff:600 bpdepthfrequency:0 ]",
+]
+`;
+
 exports[`runs examples > example "bpenv" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c2 s:sawtooth bandf:500 bpattack:0.5 bpenv:4 ]",
@@ -4786,6 +4855,75 @@ exports[`runs examples > example "hpdecay" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "hpdepthfrequency" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 1/16 → 1/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 1/8 → 3/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 3/16 → 1/4 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 1/4 → 5/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 5/16 → 3/8 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 3/8 → 7/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 7/16 → 1/2 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 1/2 → 9/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 9/16 → 5/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 5/8 → 11/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 11/16 → 3/4 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 3/4 → 13/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 13/16 → 7/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 7/8 → 15/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 15/16 → 1/1 | note:c s:sawtooth cutoff:600 hpdepthfrequency:200 ]",
+  "[ 1/1 → 17/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 17/16 → 9/8 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 9/8 → 19/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 19/16 → 5/4 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 5/4 → 21/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 21/16 → 11/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 11/8 → 23/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 23/16 → 3/2 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 3/2 → 25/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 25/16 → 13/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 13/8 → 27/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 27/16 → 7/4 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 7/4 → 29/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 29/16 → 15/8 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 15/8 → 31/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 31/16 → 2/1 | note:c s:sawtooth cutoff:600 hpdepthfrequency:500 ]",
+  "[ 2/1 → 33/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 33/16 → 17/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 17/8 → 35/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 35/16 → 9/4 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 9/4 → 37/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 37/16 → 19/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 19/8 → 39/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 39/16 → 5/2 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 5/2 → 41/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 41/16 → 21/8 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 21/8 → 43/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 43/16 → 11/4 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 11/4 → 45/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 45/16 → 23/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 23/8 → 47/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 47/16 → 3/1 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:100 ]",
+  "[ 3/1 → 49/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 49/16 → 25/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 25/8 → 51/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 51/16 → 13/4 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 13/4 → 53/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 53/16 → 27/8 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 27/8 → 55/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 55/16 → 7/2 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 7/2 → 57/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 57/16 → 29/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 29/8 → 59/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 59/16 → 15/4 | note:c4 s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 15/4 → 61/16 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 61/16 → 31/8 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 31/8 → 63/16 | note:c# s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+  "[ 63/16 → 4/1 | note:c s:sawtooth cutoff:600 hpdepthfrequency:0 ]",
+]
+`;
+
 exports[`runs examples > example "hpenv" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c2 s:sawtooth hcutoff:500 hpattack:0.5 hpenv:4 ]",
@@ -6038,6 +6176,75 @@ exports[`runs examples > example "lpdepth" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "lpdepthfrequency" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 1/16 → 1/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 1/8 → 3/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 3/16 → 1/4 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 1/4 → 5/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 5/16 → 3/8 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 3/8 → 7/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 7/16 → 1/2 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 1/2 → 9/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 9/16 → 5/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 5/8 → 11/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 11/16 → 3/4 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 3/4 → 13/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 13/16 → 7/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 7/8 → 15/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 15/16 → 1/1 | note:c s:sawtooth cutoff:600 lpdepthfrequency:200 ]",
+  "[ 1/1 → 17/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 17/16 → 9/8 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 9/8 → 19/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 19/16 → 5/4 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 5/4 → 21/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 21/16 → 11/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 11/8 → 23/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 23/16 → 3/2 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 3/2 → 25/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 25/16 → 13/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 13/8 → 27/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 27/16 → 7/4 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 7/4 → 29/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 29/16 → 15/8 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 15/8 → 31/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 31/16 → 2/1 | note:c s:sawtooth cutoff:600 lpdepthfrequency:500 ]",
+  "[ 2/1 → 33/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 33/16 → 17/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 17/8 → 35/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 35/16 → 9/4 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 9/4 → 37/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 37/16 → 19/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 19/8 → 39/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 39/16 → 5/2 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 5/2 → 41/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 41/16 → 21/8 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 21/8 → 43/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 43/16 → 11/4 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 11/4 → 45/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 45/16 → 23/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 23/8 → 47/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 47/16 → 3/1 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:100 ]",
+  "[ 3/1 → 49/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 49/16 → 25/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 25/8 → 51/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 51/16 → 13/4 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 13/4 → 53/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 53/16 → 27/8 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 27/8 → 55/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 55/16 → 7/2 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 7/2 → 57/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 57/16 → 29/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 29/8 → 59/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 59/16 → 15/4 | note:c4 s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 15/4 → 61/16 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 61/16 → 31/8 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 31/8 → 63/16 | note:c# s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+  "[ 63/16 → 4/1 | note:c s:sawtooth cutoff:600 lpdepthfrequency:0 ]",
+]
+`;
+
 exports[`runs examples > example "lpenv" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c2 s:sawtooth cutoff:300 lpattack:0.5 lpenv:4 ]",

From f0d49e0e2220a1caacdcee89017c8b54b76c134e Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Mon, 24 Nov 2025 16:33:20 +0000
Subject: [PATCH 11/17] [perf] fix `connect-leak` from audioworklet=>param in
 lfo/tremolo

---
 packages/superdough/superdough.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 650f9c2c..a549ff68 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -665,6 +665,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
       curve: 1.5,
     });
     lfo.connect(amGain.gain);
+    audioNodes.push(lfo);
     chain.push(amGain);
   }
 

From 8b427bc1dda437521c47173abc149b16ac8ebf8b Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 25 Nov 2025 13:17:57 -0600
Subject: [PATCH 12/17] Add oct synonym

---
 packages/core/controls.mjs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 44dc91cd..21a6d962 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1865,11 +1865,12 @@ export const { nudge } = registerControl('nudge');
  * Sets the default octave of a synth.
  *
  * @name octave
+ * @synonyms oct
  * @param {number | Pattern} octave octave number
  * @example
  * n("0,4,7").scale("F:minor").s('supersaw').octave("<0 1 2 3>")
  */
-export const { octave } = registerControl('octave');
+export const { octave, oct } = registerControl('octave', 'oct');
 
 // ['ophatdecay'],
 // TODO: example

From af90baea33a103f3f3812220894533000d502109 Mon Sep 17 00:00:00 2001
From: W-A-James <warren.james.dev@gmail.com>
Date: Sun, 26 Oct 2025 14:28:36 -0500
Subject: [PATCH 13/17] Fix trampling of port env variable

---
 packages/sampler/sample-server.mjs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/sampler/sample-server.mjs b/packages/sampler/sample-server.mjs
index 31b83f5a..891ae61f 100644
--- a/packages/sampler/sample-server.mjs
+++ b/packages/sampler/sample-server.mjs
@@ -9,6 +9,8 @@ import readline from 'readline';
 import os from 'os';
 
 const LOG = !!process.env.LOG || false;
+// eslint-disable-next-line
+const PORT = process.env.PORT || 5432;
 const VALID_AUDIO_EXTENSIONS = ['wav', 'mp3', 'ogg'];
 
 const isAudioFile = (f) => {
@@ -54,7 +56,7 @@ async function getBanks(directory, flat = false) {
     banks[bank].push(subDir);
     return subDir;
   });
-  banks._base = `http://localhost:5432`;
+  banks._base = `http://localhost:${PORT}`;
   return { banks, files };
 }
 
@@ -134,8 +136,6 @@ const server = http.createServer(async (req, res) => {
   readStream.pipe(res);
 });
 
-// eslint-disable-next-line
-const PORT = process.env.PORT || 5432;
 const IP_ADDRESS = '0.0.0.0';
 let IP;
 const networkInterfaces = os.networkInterfaces();

From 9fdba6374ce07dc3d210e992ff024de5ecce64bb Mon Sep 17 00:00:00 2001
From: W-A-James <warren.james.dev@gmail.com>
Date: Fri, 31 Oct 2025 15:45:27 -0500
Subject: [PATCH 14/17] remove extraneous eslint ignore directive

---
 packages/sampler/sample-server.mjs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/sampler/sample-server.mjs b/packages/sampler/sample-server.mjs
index 891ae61f..dfba1394 100644
--- a/packages/sampler/sample-server.mjs
+++ b/packages/sampler/sample-server.mjs
@@ -9,7 +9,6 @@ import readline from 'readline';
 import os from 'os';
 
 const LOG = !!process.env.LOG || false;
-// eslint-disable-next-line
 const PORT = process.env.PORT || 5432;
 const VALID_AUDIO_EXTENSIONS = ['wav', 'mp3', 'ogg'];
 

From d70b758065a0a5f8d500b3a09527e80c6397de6b Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Thu, 20 Nov 2025 12:46:29 -0600
Subject: [PATCH 15/17] Remove base url from sample server and properly handle
 url schemes

---
 packages/sampler/sample-server.mjs |  1 -
 packages/superdough/sampler.mjs    |  4 ++--
 packages/superdough/util.mjs       | 10 ++++++++++
 packages/superdough/wavetable.mjs  |  7 ++++---
 4 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/packages/sampler/sample-server.mjs b/packages/sampler/sample-server.mjs
index dfba1394..1d5a8e7a 100644
--- a/packages/sampler/sample-server.mjs
+++ b/packages/sampler/sample-server.mjs
@@ -55,7 +55,6 @@ async function getBanks(directory, flat = false) {
     banks[bank].push(subDir);
     return subDir;
   });
-  banks._base = `http://localhost:${PORT}`;
   return { banks, files };
 }
 
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index 84bac358..aaa1a8e4 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -1,4 +1,4 @@
-import { getCommonSampleInfo } from './util.mjs';
+import { getBaseURL, getCommonSampleInfo } from './util.mjs';
 import { registerSound, registerWaveTable } from './index.mjs';
 import { getAudioContext } from './audioContext.mjs';
 import { getADSRValues, getParamADSR, getPitchEnvelope, getVibratoOscillator } from './helpers.mjs';
@@ -211,7 +211,7 @@ export async function fetchSampleMap(url) {
     // not a browser
     return;
   }
-  const base = url.split('/').slice(0, -1).join('/');
+  const base = getBaseURL(url);
   if (typeof fetch === 'undefined') {
     // skip fetch when in node / testing
     return;
diff --git a/packages/superdough/util.mjs b/packages/superdough/util.mjs
index 44ec79f7..0c066011 100644
--- a/packages/superdough/util.mjs
+++ b/packages/superdough/util.mjs
@@ -113,4 +113,14 @@ export function getCommonSampleInfo(hapValue, bank) {
 /** Selects entries from `source` and renames them via `map` */
 export const pickAndRename = (source, map) => {
   return Object.fromEntries(Object.entries(map).map(([newKey, oldKey]) => [newKey, source[oldKey]]));
+}
+
+export const getBaseURL = (url) => {
+  try {
+    // For real URLs
+    return new URL('.', new URL(url)).href.replace(/\/$/, ''); // removes trailing slash
+  } catch {
+    // For pseudo URLS
+    return url.split('/').slice(0, -1).join('/');
+  }
 };
diff --git a/packages/superdough/wavetable.mjs b/packages/superdough/wavetable.mjs
index 01d4eb83..83b7b497 100644
--- a/packages/superdough/wavetable.mjs
+++ b/packages/superdough/wavetable.mjs
@@ -1,5 +1,5 @@
 import { getAudioContext, registerSound } from './index.mjs';
-import { getCommonSampleInfo } from './util.mjs';
+import { getBaseURL, getCommonSampleInfo } from './util.mjs';
 import {
   applyFM,
   applyParameterModulators,
@@ -134,7 +134,7 @@ function githubPath(base, subpath = '') {
   return `https://raw.githubusercontent.com/${path}/${subpath}`;
 }
 
-const _processTables = (json, baseUrl, frameLen, options = {}) => {
+const _processTables = (json, baseUrl, frameLen) => {
   baseUrl = json._base || baseUrl;
   return Object.entries(json).forEach(([key, tables]) => {
     if (key === '_base') return false;
@@ -190,6 +190,7 @@ export const tables = async (url, frameLen, json, options = {}) => {
   if (url.startsWith('local:')) {
     url = `http://localhost:5432`;
   }
+  const base = getBaseURL(url);
   if (typeof fetch !== 'function') {
     // not a browser
     return;
@@ -200,7 +201,7 @@ export const tables = async (url, frameLen, json, options = {}) => {
   }
   return fetch(url)
     .then((res) => res.json())
-    .then((json) => _processTables(json, url, frameLen, options))
+    .then((json) => _processTables(json, base, frameLen, options))
     .catch((error) => {
       console.error(error);
       throw new Error(`error loading "${url}"`);

From a5c7fcc136f5702d83d5c613fafea9b14476d7d4 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 25 Nov 2025 11:26:59 -0600
Subject: [PATCH 16/17] Add back options code (will resolve in another PR)

---
 packages/superdough/wavetable.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/superdough/wavetable.mjs b/packages/superdough/wavetable.mjs
index 83b7b497..3659edcd 100644
--- a/packages/superdough/wavetable.mjs
+++ b/packages/superdough/wavetable.mjs
@@ -134,7 +134,7 @@ function githubPath(base, subpath = '') {
   return `https://raw.githubusercontent.com/${path}/${subpath}`;
 }
 
-const _processTables = (json, baseUrl, frameLen) => {
+const _processTables = (json, baseUrl, frameLen, options = {}) => {
   baseUrl = json._base || baseUrl;
   return Object.entries(json).forEach(([key, tables]) => {
     if (key === '_base') return false;

From a126bc9b86d22674d40eddc98bd5e37bb234e917 Mon Sep 17 00:00:00 2001
From: W-A-James <warren.james.dev@gmail.com>
Date: Tue, 25 Nov 2025 22:20:55 -0500
Subject: [PATCH 17/17] Fix lint

---
 packages/superdough/util.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/superdough/util.mjs b/packages/superdough/util.mjs
index 0c066011..48830541 100644
--- a/packages/superdough/util.mjs
+++ b/packages/superdough/util.mjs
@@ -113,7 +113,7 @@ export function getCommonSampleInfo(hapValue, bank) {
 /** Selects entries from `source` and renames them via `map` */
 export const pickAndRename = (source, map) => {
   return Object.fromEntries(Object.entries(map).map(([newKey, oldKey]) => [newKey, source[oldKey]]));
-}
+};
 
 export const getBaseURL = (url) => {
   try {