From 7f103e77e3a28ba325b2c94a12e795b17b6077c7 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Mon, 28 Jul 2025 04:05:21 +0200
Subject: [PATCH 001/110] prefix "S" for solo

---
 packages/core/repl.mjs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 47231af4d..47489054e 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -138,9 +138,9 @@ export function repl({
         // allows muting a pattern x with x_ or _x
         return silence;
       }
-      if (id === '$') {
+      if (id.includes('$')) {
         // allows adding anonymous patterns with $:
-        id = `$${anonymousIndex}`;
+        id = `${id}${anonymousIndex}`;
         anonymousIndex++;
       }
       pPatterns[id] = this;
@@ -201,6 +201,13 @@ export function repl({
       let { pattern, meta } = await _evaluate(code, transpiler, transpilerOptions);
       if (Object.keys(pPatterns).length) {
         let patterns = Object.values(pPatterns);
+
+        // if there are solo patterns, only use those
+        const soloPatterns = Object.entries(pPatterns).filter(([key]) => key.length > 1 && key.startsWith('S'));
+        if (soloPatterns.length) {
+          patterns = Object.values(Object.fromEntries(soloPatterns));
+        }
+
         if (eachTransform) {
           // Explicit lambda so only element (not index and array) are passed
           patterns = patterns.map((x) => eachTransform(x));

From c9381a11f9ba182ac4ae8e5aab3584883003125c Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 3 Oct 2025 17:21:05 -0500
Subject: [PATCH 002/110] Working version

---
 packages/core/controls.mjs      | 144 +++++++++++++++++++++++++++++---
 packages/superdough/helpers.mjs | 124 +++++++++++++++++----------
 2 files changed, 213 insertions(+), 55 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 7e3c2a8e2..a2136367d 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -72,6 +72,27 @@ export function registerControl(names, ...aliases) {
   return bag;
 }
 
+export function registerMultiControl(names, maxControls, ...aliases) {
+  names = Array.isArray(names) ? names : [names];
+  let bag = {};
+  for (let i = 1; i <= maxControls; i++) {
+    let theseAliases = [...aliases];
+    let theseNames = [...names];
+    if (i === 1) {
+      // adds e.g. fm1 as an alias for fm
+      const aliases1 = theseAliases.map((a) => `${a}1`);
+      const names1 = theseNames.map((n) => `${n}1`);
+      theseAliases = theseAliases.concat(aliases1).concat(names1);
+    } else {
+      theseAliases = theseAliases.map((a) => `${a}${i}`);
+      theseNames = theseNames.map((n) => `${n}${i}`);
+    }
+    const subBag = registerControl(theseNames, ...theseAliases);
+    bag = { ...bag, ...subBag };
+  }
+  return bag;
+}
+
 /**
  * Select a sound / sample by name. When using mininotation, you can also optionally supply 'n' and 'gain' parameters
  * separated by ':'.
@@ -444,21 +465,22 @@ export const { attack, att } = registerControl('attack', 'att');
  * ._scope()
  *
  */
-export const { fmh } = registerControl(['fmh', 'fmi'], 'fmh');
+export const { fmh, fmh1, fmh2, fmh3, fmh4, fmh5, fmh6, fmh7, fmh8 } = registerMultiControl(['fmh', 'fmi'], 8, 'fmh');
 /**
  * Sets the Frequency Modulation of the synth.
  * Controls the modulation index, which defines the brightness of the sound.
  *
- * @name fm
+ * @name fmi
  * @param {number | Pattern} brightness modulation index
- * @synonyms fmi
+ * @synonyms fm
  * @example
  * note("c e g b g e")
  * .fm("<0 1 2 8 32>")
  * ._scope()
  *
  */
-export const { fmi, fm } = registerControl(['fmi', 'fmh'], 'fm');
+export const { fmi, fmi1, fmi2, fmi3, fmi4, fmi5, fmi6, fmi7, fmi8, fm, fm1, fm2, fm3, fm4, fm5, fm6, fm7, fm8 } =
+  registerMultiControl(['fmi', 'fmh'], 8, 'fm');
 // fm envelope
 /**
  * Ramp type of fm envelope. Exp might be a bit broken..
@@ -474,11 +496,15 @@ export const { fmi, fm } = registerControl(['fmi', 'fmh'], 'fm');
  * ._scope()
  *
  */
-export const { fmenv } = registerControl('fmenv');
+export const { fmenv, fmenv1, fmenv2, fmenv3, fmenv4, fmenv5, fmenv6, fmenv7, fmenv8 } = registerMultiControl(
+  'fmenv',
+  8,
+);
 /**
  * Attack time for the FM envelope: time it takes to reach maximum modulation
  *
  * @name fmattack
+ * @synonyms fmatt
  * @param {number | Pattern} time attack time
  * @example
  * note("c e g b g e")
@@ -487,7 +513,26 @@ export const { fmenv } = registerControl('fmenv');
  * ._scope()
  *
  */
-export const { fmattack } = registerControl('fmattack');
+export const {
+  fmattack,
+  fmattack1,
+  fmattack2,
+  fmattack3,
+  fmattack4,
+  fmattack5,
+  fmattack6,
+  fmattack7,
+  fmattack8,
+  fmatt,
+  fmatt1,
+  fmatt2,
+  fmatt3,
+  fmatt4,
+  fmatt5,
+  fmatt6,
+  fmatt7,
+  fmatt8,
+} = registerMultiControl('fmattack', 8, 'fmatt');
 
 /**
  * Waveform of the fm modulator
@@ -500,12 +545,16 @@ export const { fmattack } = registerControl('fmattack');
  * n("0 1 2 3".fast(4)).chord("<Dm Am F G>").voicing().s("sawtooth").fmwave("brown").fm(.6)
  *
  */
-export const { fmwave } = registerControl('fmwave');
+export const { fmwave, fmwave1, fmwave2, fmwave3, fmwave4, fmwave5, fmwave6, fmwave7, fmwave8 } = registerMultiControl(
+  'fmwave',
+  8,
+);
 
 /**
  * Decay time for the FM envelope: seconds until the sustain level is reached after the attack phase.
  *
  * @name fmdecay
+ * @synonyms fmdec
  * @param {number | Pattern} time decay time
  * @example
  * note("c e g b g e")
@@ -515,11 +564,31 @@ export const { fmwave } = registerControl('fmwave');
  * ._scope()
  *
  */
-export const { fmdecay } = registerControl('fmdecay');
+export const {
+  fmdecay,
+  fmdecay1,
+  fmdecay2,
+  fmdecay3,
+  fmdecay4,
+  fmdecay5,
+  fmdecay6,
+  fmdecay7,
+  fmdecay8,
+  fmdec,
+  fmdec1,
+  fmdec2,
+  fmdec3,
+  fmdec4,
+  fmdec5,
+  fmdec6,
+  fmdec7,
+  fmdec8,
+} = registerMultiControl('fmdecay', 8, 'fmdec');
 /**
  * Sustain level for the FM envelope: how much modulation is applied after the decay phase
  *
  * @name fmsustain
+ * @synonyms fmsus
  * @param {number | Pattern} level sustain level
  * @example
  * note("c e g b g e")
@@ -529,10 +598,61 @@ export const { fmdecay } = registerControl('fmdecay');
  * ._scope()
  *
  */
-export const { fmsustain } = registerControl('fmsustain');
-// these are not really useful... skipping for now
-export const { fmrelease } = registerControl('fmrelease');
-export const { fmvelocity } = registerControl('fmvelocity');
+export const {
+  fmsustain,
+  fmsustain1,
+  fmsustain2,
+  fmsustain3,
+  fmsustain4,
+  fmsustain5,
+  fmsustain6,
+  fmsustain7,
+  fmsustain8,
+  fmsus,
+  fmsus1,
+  fmsus2,
+  fmsus3,
+  fmsus4,
+  fmsus5,
+  fmsus6,
+  fmsus7,
+  fmsus8,
+} = registerMultiControl('fmsustain', 8, 'fmsus');
+/**
+ * Release time for the FM envelope: how much modulation is applied after the note is released
+ *
+ * @name fmrelease
+ * @synonyms fmrel
+ * @param {number | Pattern} time release time
+ *
+ */
+export const {
+  fmrelease,
+  fmrelease1,
+  fmrelease2,
+  fmrelease3,
+  fmrelease4,
+  fmrelease5,
+  fmrelease6,
+  fmrelease7,
+  fmrelease8,
+  fmrel,
+  fmrel1,
+  fmrel2,
+  fmrel3,
+  fmrel4,
+  fmrel5,
+  fmrel6,
+  fmrel7,
+  fmrel8,
+} = registerMultiControl('fmrelease', 8, 'fmrel');
+
+// FM Matrix
+for (let i = 0; i <= 8; i++) {
+  for (let j = 0; j <= 8; j++) {
+    registerControl(`fm${i}${j}`);
+  }
+}
 
 /**
  * Select the sound bank to use. To be used together with `s`. The bank name (+ "_") will be prepended to the value of `s`.
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 47bca330d..361733f10 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -325,7 +325,7 @@ const mod = (freq, range = 1, type = 'sine') => {
   osc.start();
   const g = new GainNode(ctx, { gain: range });
   osc.connect(g); // -range, range
-  return { node: g, stop: (t) => osc.stop(t) };
+  return { fm: osc, scaled: g, stop: (t) => osc.stop(t) };
 };
 const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
@@ -334,48 +334,86 @@ const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') =>
   return mod(modfreq, modgain, wave);
 };
 export function applyFM(param, value, begin) {
-  const {
-    fmh: fmHarmonicity = 1,
-    fmi: fmModulationIndex,
-    fmenv: fmEnvelopeType = 'exp',
-    fmattack: fmAttack,
-    fmdecay: fmDecay,
-    fmsustain: fmSustain,
-    fmrelease: fmRelease,
-    fmvelocity: fmVelocity,
-    fmwave: fmWaveform = 'sine',
-    duration,
-  } = value;
-  let modulator;
-  let stop = () => {};
-
-  if (fmModulationIndex) {
-    const ac = getAudioContext();
-    const envGain = ac.createGain();
-    const fmmod = fm(param, fmHarmonicity, fmModulationIndex, fmWaveform);
-
-    modulator = fmmod.node;
-    stop = fmmod.stop;
-    if (![fmAttack, fmDecay, fmSustain, fmRelease, fmVelocity].some((v) => v !== undefined)) {
-      // no envelope by default
-      modulator.connect(param);
-    } else {
-      const [attack, decay, sustain, release] = getADSRValues([fmAttack, fmDecay, fmSustain, fmRelease]);
-      const holdEnd = begin + duration;
-      getParamADSR(
-        envGain.gain,
-        attack,
-        decay,
-        sustain,
-        release,
-        0,
-        1,
-        begin,
-        holdEnd,
-        fmEnvelopeType === 'exp' ? 'exponential' : 'linear',
-      );
-      modulator.connect(envGain);
-      envGain.connect(param);
+  const ac = getAudioContext();
+  let target = param;
+  let stop = (t) => {};
+  const targets = [param];
+  const modulators = [];
+  for (let i = 0; i < 8; i++) {
+    const iS = `${i === 0 ? '' : i}`;
+    let modulator;
+    const fmModulationIndex = value[`fmi${iS}`];
+    if (fmModulationIndex) {
+      const fmmod = fm(target, value[`fmh${iS}`] ?? 1, fmModulationIndex, value[`fmwave${iS}`] ?? 'sine');
+      modulator = fmmod.scaled;
+      const currStop = stop;
+      stop = (t) => {
+        currStop(t);
+        fmmod.stop(t);
+      };
+      const adsr = ['attack', 'decay', 'sustain', 'release'].map((s) => value[`fm${s}${iS}`]);
+      if (!adsr.some((v) => v !== undefined)) {
+        // no envelope by default
+        modulator.connect(target);
+        modulators.push(modulator);
+      } else {
+        const envGain = ac.createGain();
+        const [attack, decay, sustain, release] = getADSRValues(adsr);
+        const holdEnd = begin + value.duration;
+        const fmEnvelopeType = value[`fmenv${iS}`] ?? 'exp';
+        getParamADSR(
+          envGain.gain,
+          attack,
+          decay,
+          sustain,
+          release,
+          0,
+          1,
+          begin,
+          holdEnd,
+          fmEnvelopeType === 'exp' ? 'exponential' : 'linear',
+        );
+        modulator.connect(envGain);
+        envGain.connect(target);
+        modulators.push(envGain);
+      }
+      targets.push(fmmod.fm?.frequency);
+      if (targets[i]) {
+        // Cannot connect to noises, for example
+        target = targets[i];
+      }
+    }
+  }
+  // Matrix
+  for (let i = 1; i <= 8; i++) {
+    for (let j = 0; j <= 8; j++) {
+      let control;
+      if (i === j + 1) {
+        // Standard fm3 -> fm2 -> fm1 -> param usage
+        control = `fm${i}`;
+      } else {
+        control = `fm${i}${j}`;
+      }
+      const amt = value[control];
+      if (!amt) continue;
+      const source = modulators[i - 1];
+      const target = targets[j];
+      if (!source) {
+        const iS = `${i === 1 ? '' : i}`;
+        logger(
+          `[superdough] failed to connect FM from source ${i} (due to control ${control}): source ${i} does not exist. Please use control fm${iS} to set it up`,
+          'warning',
+        );
+        continue;
+      }
+      if (!target) {
+        logger(
+          `[superdough] failed to connect FM to target ${j} (due to control ${control}): target ${j} does not exist. Please use control fm${j} to set it up`,
+          'warning',
+        );
+        continue;
+      }
+      source.connect(target);
     }
   }
   return { stop };

From 7cf9db4872fe8d2bde619da87f197a4b1df64a70 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 3 Oct 2025 18:20:41 -0500
Subject: [PATCH 003/110] Big matrix refactor

---
 packages/core/controls.mjs      |   2 +-
 packages/superdough/helpers.mjs | 124 ++++++++++++++------------------
 2 files changed, 55 insertions(+), 71 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index a2136367d..3f8847d99 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -650,7 +650,7 @@ export const {
 // FM Matrix
 for (let i = 0; i <= 8; i++) {
   for (let j = 0; j <= 8; j++) {
-    registerControl(`fm${i}${j}`);
+    registerControl(`fmi${i}${j}`, `fm${i}${j}`);
   }
 }
 
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 361733f10..89ae7da6d 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -309,7 +309,7 @@ export function webAudioTimeout(audioContext, onComplete, startTime, stopTime) {
   constantNode.stop(stopTime);
   return constantNode;
 }
-const mod = (freq, range = 1, type = 'sine') => {
+const mod = (freq, type = 'sine') => {
   const ctx = getAudioContext();
   let osc;
   if (noises.includes(type)) {
@@ -321,99 +321,83 @@ const mod = (freq, range = 1, type = 'sine') => {
     osc.type = type;
     osc.frequency.value = freq;
   }
-
   osc.start();
-  const g = new GainNode(ctx, { gain: range });
-  osc.connect(g); // -range, range
-  return { fm: osc, scaled: g, stop: (t) => osc.stop(t) };
+  return { osc, stop: (t) => osc.stop(t), freq };
 };
+
 const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
   const modfreq = carrfreq * harmonicityRatio;
-  const modgain = modfreq * modulationIndex;
-  return mod(modfreq, modgain, wave);
+  return mod(modfreq, wave)
 };
+
 export function applyFM(param, value, begin) {
   const ac = getAudioContext();
-  let target = param;
   let stop = (t) => {};
-  const targets = [param];
-  const modulators = [];
-  for (let i = 0; i < 8; i++) {
-    const iS = `${i === 0 ? '' : i}`;
-    let modulator;
-    const fmModulationIndex = value[`fmi${iS}`];
-    if (fmModulationIndex) {
-      const fmmod = fm(target, value[`fmh${iS}`] ?? 1, fmModulationIndex, value[`fmwave${iS}`] ?? 'sine');
-      modulator = fmmod.scaled;
-      const currStop = stop;
-      stop = (t) => {
-        currStop(t);
-        fmmod.stop(t);
-      };
-      const adsr = ['attack', 'decay', 'sustain', 'release'].map((s) => value[`fm${s}${iS}`]);
-      if (!adsr.some((v) => v !== undefined)) {
-        // no envelope by default
-        modulator.connect(target);
-        modulators.push(modulator);
-      } else {
-        const envGain = ac.createGain();
-        const [attack, decay, sustain, release] = getADSRValues(adsr);
-        const holdEnd = begin + value.duration;
-        const fmEnvelopeType = value[`fmenv${iS}`] ?? 'exp';
-        getParamADSR(
-          envGain.gain,
-          attack,
-          decay,
-          sustain,
-          release,
-          0,
-          1,
-          begin,
-          holdEnd,
-          fmEnvelopeType === 'exp' ? 'exponential' : 'linear',
-        );
-        modulator.connect(envGain);
-        envGain.connect(target);
-        modulators.push(envGain);
-      }
-      targets.push(fmmod.fm?.frequency);
-      if (targets[i]) {
-        // Cannot connect to noises, for example
-        target = targets[i];
-      }
-    }
-  }
+  const fms = {};
   // Matrix
   for (let i = 1; i <= 8; i++) {
     for (let j = 0; j <= 8; j++) {
       let control;
       if (i === j + 1) {
         // Standard fm3 -> fm2 -> fm1 -> param usage
-        control = `fm${i}`;
+        const iS = i === 1 ? '' : i;
+        control = `fmi${iS}`;
       } else {
-        control = `fm${i}${j}`;
+        control = `fmi${i}${j}`;
       }
       const amt = value[control];
       if (!amt) continue;
-      const source = modulators[i - 1];
-      const target = targets[j];
-      if (!source) {
-        const iS = `${i === 1 ? '' : i}`;
+      let io = [];
+      for (let [isMod, idx] of [[true, i], [false, j]]) {
+        debugger;
+        if (idx === 0) {
+          io.push(param);
+          continue;
+        }
+        if (!fms[idx]) {
+          const idxS = idx === 1 ? '' : idx;
+          const { osc, freq } = fm(param, value[`fmh${idxS}`] ?? 1, value[`fmwave${idxS}`] ?? 'sine');
+          const currStop = stop;
+          stop = (t) => {
+            currStop(t);
+            osc.stop(t);
+          };
+          const adsr = ['attack', 'decay', 'sustain', 'release'].map((s) => value[`fm${s}${idxS}`]);
+          if (!adsr.some((v) => v !== undefined)) {
+            fms[idx] = { input: osc.frequency, output: osc, freq};
+          } else {
+            const envGain = ac.createGain();
+            const [attack, decay, sustain, release] = getADSRValues(adsr);
+            const holdEnd = begin + value.duration;
+            const fmEnvelopeType = value[`fmenv${idxS}`] ?? 'exp';
+            getParamADSR(
+              envGain.gain,
+              attack,
+              decay,
+              sustain,
+              release,
+              0,
+              1,
+              begin,
+              holdEnd,
+              fmEnvelopeType === 'exp' ? 'exponential' : 'linear',
+            );
+            fms[idx] = { input: osc.frequency, output: osc.connect(envGain), freq};
+          }
+        }
+        const { input, output, freq } = fms[idx];
+        const g = gainNode(amt * freq);
+        io.push(isMod ? output.connect(g) : input);
+      }
+      if (!io[1]) {
         logger(
-          `[superdough] failed to connect FM from source ${i} (due to control ${control}): source ${i} does not exist. Please use control fm${iS} to set it up`,
+          `[superdough] control ${control} failed to connect FM ${i} to target ${j} due to missing frequency parameter (likely because fm${j} is noise)`,
           'warning',
         );
         continue;
       }
-      if (!target) {
-        logger(
-          `[superdough] failed to connect FM to target ${j} (due to control ${control}): target ${j} does not exist. Please use control fm${j} to set it up`,
-          'warning',
-        );
-        continue;
-      }
-      source.connect(target);
+      io[0].connect(io[1]);
     }
   }
   return { stop };

From bd73d96847889f78b4a3cc9e98d4df0eeeb5244f Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 3 Oct 2025 18:49:49 -0500
Subject: [PATCH 004/110] Cleanup

---
 packages/superdough/helpers.mjs           | 15 +++---
 test/__snapshots__/examples.test.mjs.snap | 58 +++++++++++------------
 2 files changed, 38 insertions(+), 35 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 89ae7da6d..de8daaf5d 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -1,6 +1,7 @@
+import { logger } from './logger.mjs';
+import { getNoiseBuffer } from './noise.mjs';
 import { getAudioContext } from './superdough.mjs';
 import { clamp, nanFallback, midiToFreq, noteToMidi } from './util.mjs';
-import { getNoiseBuffer } from './noise.mjs';
 
 export const noises = ['pink', 'white', 'brown', 'crackle'];
 
@@ -328,7 +329,7 @@ const mod = (freq, type = 'sine') => {
 const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
   const modfreq = carrfreq * harmonicityRatio;
-  return mod(modfreq, wave)
+  return mod(modfreq, wave);
 };
 
 export function applyFM(param, value, begin) {
@@ -349,8 +350,10 @@ export function applyFM(param, value, begin) {
       const amt = value[control];
       if (!amt) continue;
       let io = [];
-      for (let [isMod, idx] of [[true, i], [false, j]]) {
-        debugger;
+      for (let [isMod, idx] of [
+        [true, i],
+        [false, j],
+      ]) {
         if (idx === 0) {
           io.push(param);
           continue;
@@ -365,7 +368,7 @@ export function applyFM(param, value, begin) {
           };
           const adsr = ['attack', 'decay', 'sustain', 'release'].map((s) => value[`fm${s}${idxS}`]);
           if (!adsr.some((v) => v !== undefined)) {
-            fms[idx] = { input: osc.frequency, output: osc, freq};
+            fms[idx] = { input: osc.frequency, output: osc, freq };
           } else {
             const envGain = ac.createGain();
             const [attack, decay, sustain, release] = getADSRValues(adsr);
@@ -383,7 +386,7 @@ export function applyFM(param, value, begin) {
               holdEnd,
               fmEnvelopeType === 'exp' ? 'exponential' : 'linear',
             );
-            fms[idx] = { input: osc.frequency, output: osc.connect(envGain), freq};
+            fms[idx] = { input: osc.frequency, output: osc.connect(envGain), freq };
           }
         }
         const { input, output, freq } = fms[idx];
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 73278947d..be8b371ab 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3880,35 +3880,6 @@ exports[`runs examples > example "floor" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "fm" example index 0 1`] = `
-[
-  "[ 0/1 → 1/6 | note:c fmi:0 ]",
-  "[ 1/6 → 1/3 | note:e fmi:0 ]",
-  "[ 1/3 → 1/2 | note:g fmi:0 ]",
-  "[ 1/2 → 2/3 | note:b fmi:0 ]",
-  "[ 2/3 → 5/6 | note:g fmi:0 ]",
-  "[ 5/6 → 1/1 | note:e fmi:0 ]",
-  "[ 1/1 → 7/6 | note:c fmi:1 ]",
-  "[ 7/6 → 4/3 | note:e fmi:1 ]",
-  "[ 4/3 → 3/2 | note:g fmi:1 ]",
-  "[ 3/2 → 5/3 | note:b fmi:1 ]",
-  "[ 5/3 → 11/6 | note:g fmi:1 ]",
-  "[ 11/6 → 2/1 | note:e fmi:1 ]",
-  "[ 2/1 → 13/6 | note:c fmi:2 ]",
-  "[ 13/6 → 7/3 | note:e fmi:2 ]",
-  "[ 7/3 → 5/2 | note:g fmi:2 ]",
-  "[ 5/2 → 8/3 | note:b fmi:2 ]",
-  "[ 8/3 → 17/6 | note:g fmi:2 ]",
-  "[ 17/6 → 3/1 | note:e fmi:2 ]",
-  "[ 3/1 → 19/6 | note:c fmi:8 ]",
-  "[ 19/6 → 10/3 | note:e fmi:8 ]",
-  "[ 10/3 → 7/2 | note:g fmi:8 ]",
-  "[ 7/2 → 11/3 | note:b fmi:8 ]",
-  "[ 11/3 → 23/6 | note:g fmi:8 ]",
-  "[ 23/6 → 4/1 | note:e fmi:8 ]",
-]
-`;
-
 exports[`runs examples > example "fmattack" example index 0 1`] = `
 [
   "[ 0/1 → 1/6 | note:c fmi:4 fmattack:0 ]",
@@ -4025,6 +3996,35 @@ exports[`runs examples > example "fmh" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "fmi" example index 0 1`] = `
+[
+  "[ 0/1 → 1/6 | note:c fmi:0 ]",
+  "[ 1/6 → 1/3 | note:e fmi:0 ]",
+  "[ 1/3 → 1/2 | note:g fmi:0 ]",
+  "[ 1/2 → 2/3 | note:b fmi:0 ]",
+  "[ 2/3 → 5/6 | note:g fmi:0 ]",
+  "[ 5/6 → 1/1 | note:e fmi:0 ]",
+  "[ 1/1 → 7/6 | note:c fmi:1 ]",
+  "[ 7/6 → 4/3 | note:e fmi:1 ]",
+  "[ 4/3 → 3/2 | note:g fmi:1 ]",
+  "[ 3/2 → 5/3 | note:b fmi:1 ]",
+  "[ 5/3 → 11/6 | note:g fmi:1 ]",
+  "[ 11/6 → 2/1 | note:e fmi:1 ]",
+  "[ 2/1 → 13/6 | note:c fmi:2 ]",
+  "[ 13/6 → 7/3 | note:e fmi:2 ]",
+  "[ 7/3 → 5/2 | note:g fmi:2 ]",
+  "[ 5/2 → 8/3 | note:b fmi:2 ]",
+  "[ 8/3 → 17/6 | note:g fmi:2 ]",
+  "[ 17/6 → 3/1 | note:e fmi:2 ]",
+  "[ 3/1 → 19/6 | note:c fmi:8 ]",
+  "[ 19/6 → 10/3 | note:e fmi:8 ]",
+  "[ 10/3 → 7/2 | note:g fmi:8 ]",
+  "[ 7/2 → 11/3 | note:b fmi:8 ]",
+  "[ 11/3 → 23/6 | note:g fmi:8 ]",
+  "[ 23/6 → 4/1 | note:e fmi:8 ]",
+]
+`;
+
 exports[`runs examples > example "fmsustain" example index 0 1`] = `
 [
   "[ 0/1 → 1/6 | note:c fmi:4 fmdecay:0.1 fmsustain:1 ]",

From cc4452ce58a3d2a3fd12fe37166d7d2047222d58 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sat, 4 Oct 2025 20:33:25 -0500
Subject: [PATCH 005/110] Working version of partials and phases

---
 packages/core/controls.mjs               |  1 +
 packages/core/signal.mjs                 | 38 ++++++++++++++++-
 packages/core/test/pattern.test.mjs      |  4 +-
 packages/superdough/synth.mjs            | 52 +++++++++++++++++-------
 website/src/components/Header/Search.css |  4 +-
 website/src/pages/learn/samples.mdx      |  2 +-
 6 files changed, 79 insertions(+), 22 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 7e3c2a8e2..c8005927d 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2040,6 +2040,7 @@ export const { real } = registerControl('real');
 export const { imag } = registerControl('imag');
 export const { enhance } = registerControl('enhance');
 export const { partials } = registerControl('partials');
+export const { phases } = registerControl('phases');
 export const { comb } = registerControl('comb');
 export const { smear } = registerControl('smear');
 export const { scram } = registerControl('scram');
diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 6bd6fde67..b4dc825fc 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -228,7 +228,7 @@ const timeToRands = (t, n) => timeToRandsPrime(timeToIntSeed(t), n);
 export const run = (n) => saw.range(0, n).round().segment(n);
 
 /**
- * Creates a pattern from a binary number.
+ * Creates a binary pattern from a number.
  *
  * @name binary
  * @param {number} n - input number to convert to binary
@@ -242,7 +242,7 @@ export const binary = (n) => {
 };
 
 /**
- * Creates a pattern from a binary number, padded to n bits long.
+ * Creates a binary pattern from a number, padded to n bits long.
  *
  * @name binaryN
  * @param {number} n - input number to convert to binary
@@ -258,6 +258,40 @@ export const binaryN = (n, nBits = 16) => {
   return reify(n).segment(nBits).brshift(bitPos).band(pure(1));
 };
 
+/**
+ * Creates a binary list pattern from a number.
+ *
+ * @name binaryL
+ * @param {number} n - input number to convert to binary
+ */
+export const binaryL = (n) => {
+  const nBits = reify(n).log2(0).floor().add(1);
+  return binaryNL(n, nBits);
+};
+
+/**
+ * Creates a binary list pattern from a number, padded to n bits long.
+ *
+ * @name binaryNL
+ * @param {number} n - input number to convert to binary
+ * @param {number} nBits - pattern length, defaults to 16
+ */
+export const binaryNL = (n, nBits = 16) => {
+  return reify(n)
+    .withValue((v) => (bits) => {
+      const bList = [];
+      for (let i = bits - 1; i >= 0; i--) {
+        bList.push((v >> i) & 1);
+      }
+      return bList;
+    })
+    .appLeft(reify(nBits));
+};
+
+export const randL = (n) => {
+  return signal((t) => (nVal) => timeToRands(t, nVal).map(Math.abs)).appLeft(reify(n));
+};
+
 export const randrun = (n) => {
   return signal((t) => {
     // Without adding 0.5, the first cycle is always 0,1,2,3,...
diff --git a/packages/core/test/pattern.test.mjs b/packages/core/test/pattern.test.mjs
index 1df5c8776..625f40756 100644
--- a/packages/core/test/pattern.test.mjs
+++ b/packages/core/test/pattern.test.mjs
@@ -796,7 +796,7 @@ describe('Pattern', () => {
     });
   });
   describe('apply', () => {
-    it('Can apply a function', () => {
+    (it('Can apply a function', () => {
       expect(sequence('a', 'b').apply(fast(2)).firstCycle()).toStrictEqual(sequence('a', 'b').fast(2).firstCycle());
     }),
       it('Can apply a pattern of functions', () => {
@@ -804,7 +804,7 @@ describe('Pattern', () => {
         expect(sequence('a', 'b').apply(fast(2), fast(3)).firstCycle()).toStrictEqual(
           sequence('a', 'b').fast(2, 3).firstCycle(),
         );
-      });
+      }));
   });
   describe('layer', () => {
     it('Can layer up multiple functions', () => {
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 5dc5dc08a..71c4a15dc 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -14,9 +14,10 @@ import {
   noises,
   webAudioTimeout,
 } from './helpers.mjs';
+import { logger } from './logger.mjs';
 import { getNoiseMix, getNoiseOscillator } from './noise.mjs';
 
-const waveforms = ['triangle', 'square', 'sawtooth', 'sine'];
+const waveforms = ['triangle', 'square', 'sawtooth', 'sine', 'user'];
 const waveformAliases = [
   ['tri', 'triangle'],
   ['sqr', 'square'],
@@ -413,9 +414,13 @@ export function registerSynthSounds() {
   waveformAliases.forEach(([alias, actual]) => soundMap.set({ ...soundMap.get(), [alias]: soundMap.get()[actual] }));
 }
 
-export function waveformN(partials, type) {
-  const real = new Float32Array(partials + 1);
-  const imag = new Float32Array(partials + 1);
+const PI2 = 2 * Math.PI;
+export function waveformN(partials, phases, type) {
+  const isList = typeof partials === 'object';
+  partials = isList ? partials : new Float32Array(partials).fill(1);
+  const len = partials.length;
+  const real = new Float32Array(len + 1);
+  const imag = new Float32Array(len + 1);
   const ac = getAudioContext();
   const osc = ac.createOscillator();
 
@@ -423,20 +428,29 @@ export function waveformN(partials, type) {
     sawtooth: (n) => [0, -1 / n],
     square: (n) => [0, n % 2 === 0 ? 0 : 1 / n],
     triangle: (n) => [n % 2 === 0 ? 0 : 1 / (n * n), 0],
+    user: (_n) => [0, 1],
   };
 
   if (!terms[type]) {
     throw new Error(`unknown wave type ${type}`);
   }
 
-  real[0] = 0; // dc offset
-  imag[0] = 0;
-  let n = 1;
-  while (n <= partials) {
-    const [r, i] = terms[type](n);
-    real[n] = r;
-    imag[n] = i;
-    n++;
+  for (let n = 0; n < len; n++) {
+    const mag = partials[n];
+    const [r, i] = terms[type](n + 1); // we skip n === 0 as this is dc offset
+    const phase = phases?.[n] ?? 0;
+    // Scale by `partials`
+    let R = r * mag;
+    let I = i * mag;
+    // Apply rotation by the phase
+    if (phase !== 0) {
+      const c = Math.cos(PI2 * phase);
+      const s = Math.sin(PI2 * phase);
+      R = c * R - s * I;
+      I = s * R + c * I;
+    }
+    real[n + 1] = R;
+    imag[n + 1] = I;
   }
 
   const wave = ac.createPeriodicWave(real, imag);
@@ -446,16 +460,24 @@ export function waveformN(partials, type) {
 
 // expects one of waveforms as s
 export function getOscillator(s, t, value) {
-  let { n: partials, duration, noise = 0 } = value;
+  const { duration, noise = 0 } = value;
+  const partials = value.partials ?? value.n;
   let o;
+  if (s === 'user' && !partials) {
+    logger(
+      `[superdough] Synth 'user' was selected, but partials not specified. Defaulting to triangle. Use pat.partials to setup custom waveform`,
+    );
+    s = 'triangle';
+  }
+  s = s === 'user' && !partials ? 'triangle' : s;
   // If no partials are given, use stock waveforms
-  if (!partials || s === 'sine') {
+  if (!partials || !partials?.length || s === 'sine') {
     o = getAudioContext().createOscillator();
     o.type = s || 'triangle';
   }
   // generate custom waveform if partials are given
   else {
-    o = waveformN(partials, s);
+    o = waveformN(partials, value.phases, s);
   }
   // set frequency
   o.frequency.value = getFrequencyFromValue(value);
diff --git a/website/src/components/Header/Search.css b/website/src/components/Header/Search.css
index 456ef9f6b..b14146cbd 100644
--- a/website/src/components/Header/Search.css
+++ b/website/src/components/Header/Search.css
@@ -18,8 +18,8 @@
   --docsearch-modal-background: var(--background);
   --docsearch-muted-color: color-mix(in srgb, var(--foreground), #fff 30%);
   --docsearch-key-gradient: var(--foreground);
-  --docsearch-key-shadow: inset 0 -2px 0 0 var(--gutterForeground), inset 0 0 1px 1px var(--foreground),
-    0 1px 2px 1px var(--gutterBackground);
+  --docsearch-key-shadow:
+    inset 0 -2px 0 0 var(--gutterForeground), inset 0 0 1px 1px var(--foreground), 0 1px 2px 1px var(--gutterBackground);
 }
 .dark {
   --docsearch-muted-color: color-mix(in srgb, var(--foreground), #000 30%);
diff --git a/website/src/pages/learn/samples.mdx b/website/src/pages/learn/samples.mdx
index eb79cccf7..201d57dfa 100644
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@@ -381,7 +381,7 @@ Sampler effects are functions that can be used to change the behaviour of sample
 
 ### scrub
 
-<JsDoc client:idle name="Pattern.scrub" h={0} />{' '}
+<JsDoc client:idle name="Pattern.scrub" h={0} />
 
 ### speed
 

From 0fe7edc15756919b73564ba84f54695d9f2fcb67 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 15 Oct 2025 14:53:07 -0500
Subject: [PATCH 006/110] Some examples

---
 packages/core/controls.mjs                |  30 ++-
 packages/core/signal.mjs                  |  11 ++
 test/__snapshots__/examples.test.mjs.snap | 212 ++++++++++++++++++++++
 3 files changed, 251 insertions(+), 2 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 30b3c14f3..327f8df51 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2072,8 +2072,6 @@ export const { tsdelay } = registerControl('tsdelay');
 export const { real } = registerControl('real');
 export const { imag } = registerControl('imag');
 export const { enhance } = registerControl('enhance');
-export const { partials } = registerControl('partials');
-export const { phases } = registerControl('phases');
 export const { comb } = registerControl('comb');
 export const { smear } = registerControl('smear');
 export const { scram } = registerControl('scram');
@@ -2375,3 +2373,31 @@ export const scrub = register(
   },
   false,
 );
+
+/**
+ * Scale the magnitude of the harmonics of one of the core synths ('sine', 'tri', 'saw', ..)
+ *
+ * Can also be used to create a new synth via `s('user').partials(...)`
+ *
+ * @name partials
+ * @param {number[] | Pattern} partials List of magnitudes for partials. 0th entry is the first harmonic (i.e. DC offset is skipped)
+ * @example
+ * s("user").seg(16).n(irand(8)).scale("A:major")
+ *   .partials([1, 0, 1, 0, 0, 1])
+ * @example
+ * s("saw").seg(8).n(irand(12)).scale("G#:minor")
+ *   .partials(binaryL(256))
+ */
+export const { partials } = registerControl('partials');
+
+/**
+ * Rotates the harmonics of one of the core synths ('sine', 'tri', 'saw', 'user', ..) by a list of phases
+ *
+ * @name phases
+ * @param {number[] | Pattern} phases List of phases for partials. 0th entry is the first phase (i.e. DC offset is skipped)
+ * @example
+ * s("saw").seg(8).n(irand(12)).scale("G#:minor")
+ *   .partials(binaryL(256))
+ *   .phases(randL(20))
+ */
+export const { phases } = registerControl('phases');
diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index b4dc825fc..604d1c805 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -263,6 +263,8 @@ export const binaryN = (n, nBits = 16) => {
  *
  * @name binaryL
  * @param {number} n - input number to convert to binary
+ * s("saw").seg(8)
+ *   .partials(binaryL(irand(4096).add(1)))
  */
 export const binaryL = (n) => {
   const nBits = reify(n).log2(0).floor().add(1);
@@ -288,6 +290,15 @@ export const binaryNL = (n, nBits = 16) => {
     .appLeft(reify(nBits));
 };
 
+/**
+ * Creates a list of random numbers of the given length
+ *
+ * @name randL
+ * @param {number} n Number of random numbers to sample
+ * @example
+ * s("saw").seg(16).n(irand(12)).scale("F1:minor")
+ *   .partials(randL(8))
+ */
 export const randL = (n) => {
   return signal((t) => (nVal) => timeToRands(t, nVal).map(Math.abs)).appLeft(reify(n));
 };
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 937d42797..17c25cc5b 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -7078,6 +7078,112 @@ exports[`runs examples > example "panchor" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "partials" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 1/16 → 1/8 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 1/8 → 3/16 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 3/16 → 1/4 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 1/4 → 5/16 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 5/16 → 3/8 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 3/8 → 7/16 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 7/16 → 1/2 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 1/2 → 9/16 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 9/16 → 5/8 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 5/8 → 11/16 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 11/16 → 3/4 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 3/4 → 13/16 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 13/16 → 7/8 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 7/8 → 15/16 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 15/16 → 1/1 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 1/1 → 17/16 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 17/16 → 9/8 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 9/8 → 19/16 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 19/16 → 5/4 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 5/4 → 21/16 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 21/16 → 11/8 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 11/8 → 23/16 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 23/16 → 3/2 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 3/2 → 25/16 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 25/16 → 13/8 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 13/8 → 27/16 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 27/16 → 7/4 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 7/4 → 29/16 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 29/16 → 15/8 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 15/8 → 31/16 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 31/16 → 2/1 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 2/1 → 33/16 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 33/16 → 17/8 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 17/8 → 35/16 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 35/16 → 9/4 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 9/4 → 37/16 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 37/16 → 19/8 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 19/8 → 39/16 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 39/16 → 5/2 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 5/2 → 41/16 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 41/16 → 21/8 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 21/8 → 43/16 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 43/16 → 11/4 | s:user note:E4 partials:[1 0 1 0 0 1] ]",
+  "[ 11/4 → 45/16 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 45/16 → 23/8 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 23/8 → 47/16 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 47/16 → 3/1 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 3/1 → 49/16 | s:user note:B3 partials:[1 0 1 0 0 1] ]",
+  "[ 49/16 → 25/8 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 25/8 → 51/16 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 51/16 → 13/4 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 13/4 → 53/16 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 53/16 → 27/8 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+  "[ 27/8 → 55/16 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 55/16 → 7/2 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 7/2 → 57/16 | s:user note:D4 partials:[1 0 1 0 0 1] ]",
+  "[ 57/16 → 29/8 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 29/8 → 59/16 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 59/16 → 15/4 | s:user note:A4 partials:[1 0 1 0 0 1] ]",
+  "[ 15/4 → 61/16 | s:user note:G#4 partials:[1 0 1 0 0 1] ]",
+  "[ 61/16 → 31/8 | s:user note:A3 partials:[1 0 1 0 0 1] ]",
+  "[ 31/8 → 63/16 | s:user note:F#4 partials:[1 0 1 0 0 1] ]",
+  "[ 63/16 → 4/1 | s:user note:C#4 partials:[1 0 1 0 0 1] ]",
+]
+`;
+
+exports[`runs examples > example "partials" example index 1 1`] = `
+[
+  "[ 0/1 → 1/8 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 1/8 → 1/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 1/4 → 3/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 3/8 → 1/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 1/2 → 5/8 | s:saw note:C#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 5/8 → 3/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 3/4 → 7/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 7/8 → 1/1 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 1/1 → 9/8 | s:saw note:F#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 9/8 → 5/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 5/4 → 11/8 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 11/8 → 3/2 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 3/2 → 13/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 13/8 → 7/4 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 7/4 → 15/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 15/8 → 2/1 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 2/1 → 17/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 17/8 → 9/4 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 9/4 → 19/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 19/8 → 5/2 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 5/2 → 21/8 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 21/8 → 11/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 11/4 → 23/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 23/8 → 3/1 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 3/1 → 25/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 25/8 → 13/4 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 13/4 → 27/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 27/8 → 7/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 7/2 → 29/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 29/8 → 15/4 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 15/4 → 31/8 | s:saw note:B4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 31/8 → 4/1 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+]
+`;
+
 exports[`runs examples > example "pattack" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | note:c pattack:0 ]",
@@ -7331,6 +7437,43 @@ exports[`runs examples > example "phasersweep" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "phases" example index 0 1`] = `
+[
+  "[ 0/1 → 1/8 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0] ]",
+  "[ 1/8 → 1/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6852155700325966 0.17723728902637959 0.8521428182721138 0.5022399611771107 0.9780306946486235 0.3186125475913286 0.1851645242422819 0.8495976086705923 0.9832699615508318 0.8203876558691263 0.7365445382893085 0.6727468091994524 0.4794053863734007 0.35482912696897984 0.5666771996766329 0.4527092967182398 0.5699347071349621 0.7358296867460012 0.5444891396909952 0.11270620673894882] ]",
+  "[ 1/4 → 3/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.36975969187915325 0.18273563869297504 0.012781793251633644 0.5423613861203194 0.12467948533594608 0.7188410349190235 0.856887087225914 0.8818203993141651 0.8917219173163176 0.110306391492486 0.07148400321602821 0.8493648078292608 0.9100127145648003 0.4820226952433586 0.037094997242093086 0.9857278112322092 0.23439379036426544 0.46701666340231895 0.15832693874835968 0.6921216659247875] ]",
+  "[ 3/8 → 1/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.40139251574873924 0.15799915604293346 0.9604704882949591 0.03873417526483536 0.4157217647880316 0.27756719291210175 0.8800551909953356 0.5692523363977671 0.11026228219270706 0.7190891150385141 0.404962956905365 0.50828124769032 0.9681975357234478 0.34809120930731297 0.9345223866403103 0.9851128943264484 0.11768617853522301 0.538263589143753 0.6650313660502434 0.02540053054690361] ]",
+  "[ 1/2 → 5/8 | s:saw note:C#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.2604806162416935 0.3654713351279497 0.9900747090578079 0.22572625242173672 0.9328999016433954 0.5273839123547077 0.7047769222408533 0.7311522178351879 0.42673745937645435 0.7099553178995848 0.5597201306372881 0.8968746215105057 0.15695763938128948 0.3792166206985712 0.4147114269435406 0.38739512488245964 0.7585489805787802 0.3875726908445358 0.867314238101244 0.1866922564804554] ]",
+  "[ 5/8 → 3/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.1356358677148819 0.5403102282434702 0.07321739941835403 0.9646544624119997 0.7707359045743942 0.46888123638927937 0.9489036612212658 0.366748945787549 0.5029341224581003 0.7194344792515039 0.282692551612854 0.7303404528647661 0.7155798356980085 0.637981578707695 0.39654020965099335 0.008769871667027473 0.5857728160917759 0.3513293471187353 0.43080931156873703 0.518209295347333] ]",
+  "[ 3/4 → 7/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.19582648016512394 0.0024610888212919235 0.08272589556872845 0.09592138417065144 0.9678201265633106 0.3249557167291641 0.9463537875562906 0.20766610652208328 0.19126702845096588 0.4482936095446348 0.23314787074923515 0.07724925130605698 0.8329483829438686 0.39804019033908844 0.2529231123626232 0.889951054006815 0.716364661231637 0.3905949704349041 0.990752438083291 0.275751456618309] ]",
+  "[ 7/8 → 1/1 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.3976310808211565 0.13476407527923584 0.963376859202981 0.6579397786408663 0.5203975513577461 0.865439185872674 0.5583905670791864 0.2736878804862499 0.17021040990948677 0.3456706069409847 0.5848060417920351 0.9889458417892456 0.9307208992540836 0.7148868907243013 0.7419579364359379 0.8103639334440231 0.3331365995109081 0.19130694679915905 0.03261224366724491 0.808204049244523] ]",
+  "[ 1/1 → 9/8 | s:saw note:F#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.5195421651005745 0.9349692352116108 0.1718774326145649 0.9601866770535707 0.2802200373262167 0.8732441551983356 0.01810968853533268 0.42737805284559727 0.26281314715743065 0.7521175239235163 0.568607984110713 0.5046361442655325 0.03172125294804573 0.3706745784729719 0.9402780849486589 0.3995086643844843 0.35769628174602985 0.023460431024432182 0.043030962347984314 0.6526827793568373] ]",
+  "[ 9/8 → 5/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6724895145744085 0.21410975232720375 0.5229047331959009 0.20957534946501255 0.7402758821845055 0.2681974694132805 0.4059371296316385 0.9422509074211121 0.6584139950573444 0.26589646376669407 0.16059227287769318 0.17166719026863575 0.6234225388616323 0.020276052877306938 0.4836352560669184 0.8991366866976023 0.1860280428081751 0.06238717399537563 0.4383583478629589 0.4902789145708084] ]",
+  "[ 5/4 → 11/8 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.7287282031029463 0.9341024849563837 0.5098182689398527 0.5608645845204592 0.6812942810356617 0.5015129633247852 0.4602120481431484 0.927369873970747 0.19313151575624943 0.5240397155284882 0.444337897002697 0.19362097792327404 0.7068767864257097 0.920799495652318 0.2648108974099159 0.9700228478759527 0.20331068895757198 0.38390261493623257 0.0038731005042791367 0.9156702514737844] ]",
+  "[ 11/8 → 3/2 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.18280375190079212 0.40527783520519733 0.30504362285137177 0.7622128054499626 0.842598931863904 0.053796686232089996 0.5124214049428701 0.9178454764187336 0.09979427233338356 0.8280061967670918 0.5572535842657089 0.0622002687305212 0.9205668028444052 0.7738517206162214 0.04644870012998581 0.2117986585944891 0.26436166651546955 0.26421429589390755 0.4649084359407425 0.10490566119551659] ]",
+  "[ 3/2 → 13/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6084080748260021 0.4424846563488245 0.755185678601265 0.04328125901520252 0.04244415462017059 0.3994515985250473 0.787989066913724 0.3180440980941057 0.30072982981801033 0.24217353947460651 0.7830625418573618 0.7733921892940998 0.7720277719199657 0.4402343425899744 0.21046430803835392 0.38635879568755627 0.5671729445457458 0.9510521050542593 0.010756833478808403 0.5728995501995087] ]",
+  "[ 13/8 → 7/4 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.49675471149384975 0.2965749856084585 0.09848833456635475 0.19172007404267788 0.22677889838814735 0.9841996673494577 0.11156083643436432 0.6079028844833374 0.9412728808820248 0.9376902114599943 0.3611182738095522 0.5901201106607914 0.26860327646136284 0.9782364591956139 0.18694544956088066 0.004641396924853325 0.42020696587860584 0.06209231913089752 0.4790260009467602 0.21088780276477337] ]",
+  "[ 7/4 → 15/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.20473789609968662 0.7480021081864834 0.30757393687963486 0.5827204789966345 0.22094514779746532 0.6370698790997267 0.16573002003133297 0.0638319905847311 0.12625465169548988 0.4565841108560562 0.46095744147896767 0.646710304543376 0.045173922553658485 0.4833248760551214 0.1326297614723444 0.5275116711854935 0.9871038906276226 0.424171743914485 0.761672617867589 0.08582597225904465] ]",
+  "[ 15/8 → 2/1 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.5945571791380644 0.3962489552795887 0.563431927934289 0.4742323160171509 0.4185752831399441 0.9703940469771624 0.5282467231154442 0.6896266285330057 0.6941124945878983 0.2423656489700079 0.225077323615551 0.5445358455181122 0.014737963676452637 0.2848400343209505 0.14955217391252518 0.9782383926212788 0.6327074971050024 0.23327310755848885 0.4324392694979906 0.4326172359287739] ]",
+  "[ 2/1 → 17/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9595271199941635 0.5427457969635725 0.45864437520504 0.8057199101895094 0.18388565629720688 0.17221237532794476 0.8838487900793552 0.4976818822324276 0.7543560564517975 0.34416236728429794 0.8638174068182707 0.5697487238794565 0.005243342369794846 0.6361143626272678 0.6039986703544855 0.38708674535155296 0.5463927835226059 0.5717255529016256 0.15141930803656578 0.22688637301325798] ]",
+  "[ 17/8 → 9/4 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9033902939409018 0.22919894196093082 0.8388008493930101 0.9108077362179756 0.32246968522667885 0.16122018359601498 0.31932324543595314 0.18524732999503613 0.19110161997377872 0.5346284378319979 0.38531880639493465 0.7401201985776424 0.07450124807655811 0.18417961709201336 0.5768439751118422 0.7161206863820553 0.5836263168603182 0.9591280855238438 0.7728104889392853 0.0006709620356559753] ]",
+  "[ 9/4 → 19/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.34548251144587994 0.30419893004000187 0.10205957666039467 0.9906709585338831 0.3156223688274622 0.3745057098567486 0.7668170686811209 0.9379972033202648 0.689277408644557 0.8690325897186995 0.36728161945939064 0.9668608456850052 0.7341883443295956 0.32575040124356747 0.8095720671117306 0.3182998225092888 0.38158727809786797 0.5534052699804306 0.5973556581884623 0.752589326351881] ]",
+  "[ 19/8 → 5/2 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.8365066405385733 0.5369812995195389 0.2263860274106264 0.21759207546710968 0.2172116208821535 0.09454222768545151 0.8075542915612459 0.9017798062413931 0.46291174553334713 0.01372767798602581 0.3509599883109331 0.4871185813099146 0.3525365497916937 0.6883120182901621 0.19577431678771973 0.287217665463686 0.025726469233632088 0.11798650585114956 0.8464976660907269 0.981348654255271] ]",
+  "[ 5/2 → 21/8 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.45861607417464256 0.6807645913213491 0.07009582966566086 0.1450389064848423 0.2579921595752239 0.612881500273943 0.5503941811621189 0.7027011960744858 0.681745121255517 0.24246043153107166 0.2981361001729965 0.02195165678858757 0.10680225491523743 0.9413154497742653 0.6108828671276569 0.9479686040431261 0.17599895782768726 0.6629563421010971 0.5875700414180756 0.05703482776880264] ]",
+  "[ 21/8 → 11/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.16019348427653313 0.47758268006145954 0.9749126061797142 0.8025561925023794 0.3600110989063978 0.324309878051281 0.5655391272157431 0.13364790193736553 0.3045873437076807 0.3814875278621912 0.14350778982043266 0.6017840709537268 0.11792952008545399 0.7185723781585693 0.6789924055337906 0.43416675738990307 0.9378792773932219 0.48162082210183144 0.37555896304547787 0.4686833508312702] ]",
+  "[ 11/4 → 23/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6332327704876661 0.7342763151973486 0.16935866326093674 0.4754706546664238 0.528122790157795 0.21934260986745358 0.7476693484932184 0.2995396424084902 0.46688378043472767 0.9741295631974936 0.9878341723233461 0.9837898630648851 0.15651432052254677 0.2896903567016125 0.7395600061863661 0.3490046579390764 0.014511989429593086 0.6857758145779371 0.7405510656535625 0.4224672969430685] ]",
+  "[ 23/8 → 3/1 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.01625417172908783 0.28409438766539097 0.3075305689126253 0.40343056432902813 0.5556836389005184 0.6926821582019329 0.5635769125074148 0.017873913049697876 0.5601800158619881 0.28681862354278564 0.8022358678281307 0.13467839546501637 0.02351163513958454 0.1987263821065426 0.4515750799328089 0.0009761657565832138 0.11555273085832596 0.25053937546908855 0.29571316950023174 0.15751986764371395] ]",
+  "[ 3/1 → 25/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.21728911064565182 0.7605195846408606 0.11240843310952187 0.4372697602957487 0.15630115941166878 0.1653979979455471 0.5303416550159454 0.07218753732740879 0.47459222190082073 0.04051801189780235 0.8742353077977896 0.9356274232268333 0.6662059463560581 0.4364917427301407 0.4163493011146784 0.9820694588124752 0.09098831936717033 0.41974459774792194 0.05833998881280422 0.2601191997528076] ]",
+  "[ 25/8 → 13/4 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.34324387833476067 0.14098095521330833 0.012934491038322449 0.827436288818717 0.5283997394144535 0.8942463714629412 0.4924008697271347 0.9298017006367445 0.18076439201831818 0.5243716649711132 0.015810951590538025 0.7476964127272367 0.6734520178288221 0.3267945274710655 0.9760967157781124 0.9397075213491917 0.7225867230445147 0.938586825504899 0.9692913070321083 0.5398030783981085] ]",
+  "[ 13/4 → 27/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9923650715500116 0.7797339502722025 0.1992435697466135 0.9005183521658182 0.718992218375206 0.23745290748775005 0.28872333094477654 0.35448253713548183 0.6209003105759621 0.3761858306825161 0.019171399995684624 0.7563913837075233 0.1559751983731985 0.4236980527639389 0.08094430714845657 0.4560011047869921 0.5958948992192745 0.37061405926942825 0.18633292242884636 0.346891064196825] ]",
+  "[ 27/8 → 7/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.40869180113077164 0.4018078800290823 0.34696186147630215 0.9572948440909386 0.400035472586751 0.3531211093068123 0.7240961641073227 0.8125612027943134 0.3587487991899252 0.1545814611017704 0.8934940584003925 0.9094721674919128 0.2336172368377447 0.17333386465907097 0.227950319647789 0.12384821102023125 0.5896956156939268 0.3293947223573923 0.619540523737669 0.8746719229966402] ]",
+  "[ 7/2 → 29/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.40994881466031075 0.6455810181796551 0.35704658553004265 0.2732649203389883 0.31587288342416286 0.23243548162281513 0.22569947130978107 0.17241661623120308 0.7624858524650335 0.02111036144196987 0.6966175157576799 0.32112877257168293 0.2512516509741545 0.08602019399404526 0.16260642930865288 0.2627844326198101 0.1954369619488716 0.16302869468927383 0.4046020060777664 0.0904023926705122] ]",
+  "[ 29/8 → 15/4 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9391485787928104 0.3380728308111429 0.7723016366362572 0.998674126341939 0.7193406894803047 0.6963680125772953 0.9260678570717573 0.7829763628542423 0.42278125509619713 0.913721015676856 0.38873230293393135 0.7281809840351343 0.952108234167099 0.649707704782486 0.9456792045384645 0.4331315904855728 0.63712502643466 0.9180345926433802 0.7379776351153851 0.7914005517959595] ]",
+  "[ 15/4 → 31/8 | s:saw note:B4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.8121673222631216 0.25548945367336273 0.5759696904569864 0.6668333616107702 0.9233786761760712 0.11143362522125244 0.9734930321574211 0.369325939565897 0.6248745918273926 0.719582824036479 0.24051696807146072 0.20336504466831684 0.6860735435038805 0.10649923048913479 0.8736641593277454 0.042930178344249725 0.09769343212246895 0.7966452036052942 0.5882443580776453 0.8942952174693346] ]",
+  "[ 31/8 → 4/1 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.7361665386706591 0.7657648548483849 0.21474426984786987 0.8228576295077801 0.5647660344839096 0.08148551359772682 0.9714624118059874 0.13992334716022015 0.9609981551766396 0.6844500284641981 0.23610286228358746 0.5974335502833128 0.20678778178989887 0.5261937081813812 0.7417268306016922 0.9810918122529984 0.8138748407363892 0.9389897901564837 0.7420910261571407 0.48839940316975117] ]",
+]
+`;
+
 exports[`runs examples > example "pianoroll" example index 0 1`] = `
 [
   "[ 0/1 → 1/8 | note:c2 s:sawtooth lpenv:4 cutoff:300 ]",
@@ -8052,6 +8195,75 @@ exports[`runs examples > example "rand" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "randL" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | s:saw note:F1 partials:[0 0 0 0 0 0 0 0] ]",
+  "[ 1/16 → 1/8 | s:saw note:Bb2 partials:[0.8426077850162983 0.0886186733841896 0.9342893119901419 0.06848422810435295 0.6248505394905806 0.5372848063707352 0.8283301629126072 0.7969411127269268] ]",
+  "[ 1/8 → 3/16 | s:saw note:G2 partials:[0.6852155700325966 0.17723728902637959 0.8521428182721138 0.5022399611771107 0.9780306946486235 0.3186125475913286 0.1851645242422819 0.8495976086705923] ]",
+  "[ 3/16 → 1/4 | s:saw note:Ab1 partials:[0.20066574029624462 0.17195586115121841 0.2159541044384241 0.17005567252635956 0.6841662060469389 0.07906394638121128 0.004815371707081795 0.027107616886496544] ]",
+  "[ 1/4 → 5/16 | s:saw note:C2 partials:[0.36975969187915325 0.18273563869297504 0.012781793251633644 0.5423613861203194 0.12467948533594608 0.7188410349190235 0.856887087225914 0.8818203993141651] ]",
+  "[ 5/16 → 3/8 | s:saw note:Eb2 partials:[0.5675661638379097 0.15932588279247284 0.31376867927610874 0.32359412126243114 0.3281281068921089 0.011714376509189606 0.4433113746345043 0.68459103256464] ]",
+  "[ 3/8 → 7/16 | s:saw note:C2 partials:[0.40139251574873924 0.15799915604293346 0.9604704882949591 0.03873417526483536 0.4157217647880316 0.27756719291210175 0.8800551909953356 0.5692523363977671] ]",
+  "[ 7/16 → 1/2 | s:saw note:Bb1 partials:[0.3015887886285782 0.22311350144445896 0.47645803540945053 0.001545613631606102 0.53841289319098 0.330710094422102 0.2747743520885706 0.9471044968813658] ]",
+  "[ 1/2 → 9/16 | s:saw note:Bb1 partials:[0.2604806162416935 0.3654713351279497 0.9900747090578079 0.22572625242173672 0.9328999016433954 0.5273839123547077 0.7047769222408533 0.7311522178351879] ]",
+  "[ 9/16 → 5/8 | s:saw note:G1 partials:[0.16399178467690945 0.9559339117258787 0.21830322034657001 0.4903192054480314 0.2504696864634752 0.7302105724811554 0.6580934692174196 0.9855979979038239] ]",
+  "[ 5/8 → 11/16 | s:saw note:G1 partials:[0.1356358677148819 0.5403102282434702 0.07321739941835403 0.9646544624119997 0.7707359045743942 0.46888123638927937 0.9489036612212658 0.366748945787549] ]",
+  "[ 11/16 → 3/4 | s:saw note:C2 partials:[0.408811716362834 0.9613851886242628 0.7683626655489206 0.5862949229776859 0.9568102769553661 0.7154356613755226 0.6283384170383215 0.2193678840994835] ]",
+  "[ 3/4 → 13/16 | s:saw note:Ab1 partials:[0.19582648016512394 0.0024610888212919235 0.08272589556872845 0.09592138417065144 0.9678201265633106 0.3249557167291641 0.9463537875562906 0.20766610652208328] ]",
+  "[ 13/16 → 7/8 | s:saw note:Ab2 partials:[0.7516226731240749 0.15610851533710957 0.9039078876376152 0.8602268267422915 0.928601048886776 0.4479671400040388 0.5080656576901674 0.562442347407341] ]",
+  "[ 7/8 → 15/16 | s:saw note:C2 partials:[0.3976310808211565 0.13476407527923584 0.963376859202981 0.6579397786408663 0.5203975513577461 0.865439185872674 0.5583905670791864 0.2736878804862499] ]",
+  "[ 15/16 → 1/1 | s:saw note:G2 partials:[0.7029578909277916 0.6351367030292749 0.26143294386565685 0.6411824338138103 0.5676082745194435 0.4803342465311289 0.5140306428074837 0.9477859679609537] ]",
+  "[ 1/1 → 17/16 | s:saw note:Eb2 partials:[0.5195421651005745 0.9349692352116108 0.1718774326145649 0.9601866770535707 0.2802200373262167 0.8732441551983356 0.01810968853533268 0.42737805284559727] ]",
+  "[ 17/16 → 9/8 | s:saw note:Eb2 partials:[0.5486328881233931 0.7088070474565029 0.07877279818058014 0.9422610364854336 0.7696988433599472 0.8289324026554823 0.5925844628363848 0.3920764606446028] ]",
+  "[ 9/8 → 19/16 | s:saw note:G2 partials:[0.6724895145744085 0.21410975232720375 0.5229047331959009 0.20957534946501255 0.7402758821845055 0.2681974694132805 0.4059371296316385 0.9422509074211121] ]",
+  "[ 19/16 → 5/4 | s:saw note:F1 partials:[0.08174665085971355 0.2762963864952326 0.5428560189902782 0.29452037811279297 0.17946280725300312 0.366960596293211 0.26327736489474773 0.5002023074775934] ]",
+  "[ 5/4 → 21/16 | s:saw note:G2 partials:[0.7287282031029463 0.9341024849563837 0.5098182689398527 0.5608645845204592 0.6812942810356617 0.5015129633247852 0.4602120481431484 0.927369873970747] ]",
+  "[ 21/16 → 11/8 | s:saw note:F1 partials:[0.08104278706014156 0.5200720727443695 0.5363391060382128 0.9824271816760302 0.10652091167867184 0.23473932035267353 0.7656102329492569 0.4850195776671171] ]",
+  "[ 11/8 → 23/16 | s:saw note:Ab1 partials:[0.18280375190079212 0.40527783520519733 0.30504362285137177 0.7622128054499626 0.842598931863904 0.053796686232089996 0.5124214049428701 0.9178454764187336] ]",
+  "[ 23/16 → 3/2 | s:saw note:Eb2 partials:[0.5081270858645439 0.1421387754380703 0.8852288406342268 0.9066353775560856 0.7700740322470665 0.35437702015042305 0.20032598450779915 0.963155921548605] ]",
+  "[ 3/2 → 25/16 | s:saw note:F2 partials:[0.6084080748260021 0.4424846563488245 0.755185678601265 0.04328125901520252 0.04244415462017059 0.3994515985250473 0.787989066913724 0.3180440980941057] ]",
+  "[ 25/16 → 13/8 | s:saw note:Ab1 partials:[0.17092766426503658 0.7808954659849405 0.8234915658831596 0.8643151633441448 0.9781719036400318 0.5102015696465969 0.018259897828102112 0.25844234600663185] ]",
+  "[ 13/8 → 27/16 | s:saw note:Db2 partials:[0.49675471149384975 0.2965749856084585 0.09848833456635475 0.19172007404267788 0.22677889838814735 0.9841996673494577 0.11156083643436432 0.6079028844833374] ]",
+  "[ 27/16 → 7/4 | s:saw note:Bb1 partials:[0.29589061066508293 0.13011129200458527 0.8021425940096378 0.38040103763341904 0.33274981752038 0.29745868407189846 0.9898250997066498 0.743482418358326] ]",
+  "[ 7/4 → 29/16 | s:saw note:Ab1 partials:[0.20473789609968662 0.7480021081864834 0.30757393687963486 0.5827204789966345 0.22094514779746532 0.6370698790997267 0.16573002003133297 0.0638319905847311] ]",
+  "[ 29/16 → 15/8 | s:saw note:Db2 partials:[0.4695742893964052 0.6690364442765713 0.6216684486716986 0.41342394426465034 0.9508822970092297 0.8403679896146059 0.91759910620749 0.6591395419090986] ]",
+  "[ 15/8 → 31/16 | s:saw note:F2 partials:[0.5945571791380644 0.3962489552795887 0.563431927934289 0.4742323160171509 0.4185752831399441 0.9703940469771624 0.5282467231154442 0.6896266285330057] ]",
+  "[ 31/16 → 2/1 | s:saw note:Bb2 partials:[0.8672592639923096 0.3438429981470108 0.9795673936605453 0.46547594852745533 0.9770395755767822 0.36851615831255913 0.7725539114326239 0.876962523907423] ]",
+  "[ 2/1 → 33/16 | s:saw note:C3 partials:[0.9595271199941635 0.5427457969635725 0.45864437520504 0.8057199101895094 0.18388565629720688 0.17221237532794476 0.8838487900793552 0.4976818822324276] ]",
+  "[ 33/16 → 17/8 | s:saw note:Bb1 partials:[0.3324784208089113 0.6005446836352348 0.1564352661371231 0.765217661857605 0.12899602390825748 0.20880493707954884 0.9156261626631021 0.5550615340471268] ]",
+  "[ 17/8 → 35/16 | s:saw note:Bb2 partials:[0.9033902939409018 0.22919894196093082 0.8388008493930101 0.9108077362179756 0.32246968522667885 0.16122018359601498 0.31932324543595314 0.18524732999503613] ]",
+  "[ 35/16 → 9/4 | s:saw note:F1 partials:[0.037000780925154686 0.30360451713204384 0.7516817897558212 0.17065968923270702 0.24669718369841576 0.978821286931634 0.9620356522500515 0.12417634017765522] ]",
+  "[ 9/4 → 37/16 | s:saw note:C2 partials:[0.34548251144587994 0.30419893004000187 0.10205957666039467 0.9906709585338831 0.3156223688274622 0.3745057098567486 0.7668170686811209 0.9379972033202648] ]",
+  "[ 37/16 → 19/8 | s:saw note:F2 partials:[0.6649543270468712 0.41613837145268917 0.9078915324062109 0.2232209537178278 0.2918607946485281 0.4931973237544298 0.7035325299948454 0.29280414804816246] ]",
+  "[ 19/8 → 39/16 | s:saw note:Bb2 partials:[0.8365066405385733 0.5369812995195389 0.2263860274106264 0.21759207546710968 0.2172116208821535 0.09454222768545151 0.8075542915612459 0.9017798062413931] ]",
+  "[ 39/16 → 5/2 | s:saw note:G1 partials:[0.14231421053409576 0.6801821701228619 0.7958894111216068 0.9494249671697617 0.179213372990489 0.22531690262258053 0.7458387855440378 0.3595987129956484] ]",
+  "[ 5/2 → 41/16 | s:saw note:Db2 partials:[0.45861607417464256 0.6807645913213491 0.07009582966566086 0.1450389064848423 0.2579921595752239 0.612881500273943 0.5503941811621189 0.7027011960744858] ]",
+  "[ 41/16 → 21/8 | s:saw note:F2 partials:[0.6068673655390739 0.8489279896020889 0.027898555621504784 0.90520747192204 0.18605150654911995 0.30939464271068573 0.16843407973647118 0.5127317048609257] ]",
+  "[ 21/8 → 43/16 | s:saw note:G1 partials:[0.16019348427653313 0.47758268006145954 0.9749126061797142 0.8025561925023794 0.3600110989063978 0.324309878051281 0.5655391272157431 0.13364790193736553] ]",
+  "[ 43/16 → 11/4 | s:saw note:Eb2 partials:[0.538035349920392 0.4103843830525875 0.6443832442164421 0.7532152868807316 0.32128027081489563 0.29064710810780525 0.5972099266946316 0.8252892810851336] ]",
+  "[ 11/4 → 45/16 | s:saw note:F2 partials:[0.6332327704876661 0.7342763151973486 0.16935866326093674 0.4754706546664238 0.528122790157795 0.21934260986745358 0.7476693484932184 0.2995396424084902] ]",
+  "[ 45/16 → 23/8 | s:saw note:Bb2 partials:[0.8912940509617329 0.5256196465343237 0.25639201514422894 0.46860250271856785 0.08611978217959404 0.6175916157662868 0.990638293325901 0.11189854890108109] ]",
+  "[ 23/8 → 47/16 | s:saw note:F1 partials:[0.01625417172908783 0.28409438766539097 0.3075305689126253 0.40343056432902813 0.5556836389005184 0.6926821582019329 0.5635769125074148 0.017873913049697876] ]",
+  "[ 47/16 → 3/1 | s:saw note:Bb1 partials:[0.2830589488148689 0.3613663297146559 0.6216250211000443 0.6083405166864395 0.27202711440622807 0.771099541336298 0.3156145606189966 0.736228458583355] ]",
+  "[ 3/1 → 49/16 | s:saw note:Ab1 partials:[0.21728911064565182 0.7605195846408606 0.11240843310952187 0.4372697602957487 0.15630115941166878 0.1653979979455471 0.5303416550159454 0.07218753732740879] ]",
+  "[ 49/16 → 25/8 | s:saw note:F1 partials:[0.012518879026174545 0.6565517522394657 0.783835593611002 0.2481316588819027 0.27786846831440926 0.6153149046003819 0.39914070069789886 0.2175555843859911] ]",
+  "[ 25/8 → 51/16 | s:saw note:C2 partials:[0.34324387833476067 0.14098095521330833 0.012934491038322449 0.827436288818717 0.5283997394144535 0.8942463714629412 0.4924008697271347 0.9298017006367445] ]",
+  "[ 51/16 → 13/4 | s:saw note:Bb2 partials:[0.9057559575885534 0.5731389932334423 0.06561482697725296 0.02156665176153183 0.4685337021946907 0.000788738951086998 0.6995994579046965 0.9893404543399811] ]",
+  "[ 13/4 → 53/16 | s:saw note:C3 partials:[0.9923650715500116 0.7797339502722025 0.1992435697466135 0.9005183521658182 0.718992218375206 0.23745290748775005 0.28872333094477654 0.35448253713548183] ]",
+  "[ 53/16 → 27/8 | s:saw note:Bb1 partials:[0.3235324025154114 0.5165992900729179 0.6231792941689491 0.8034896682947874 0.6663950439542532 0.4207208137959242 0.9748435858637094 0.27676148526370525] ]",
+  "[ 27/8 → 55/16 | s:saw note:C2 partials:[0.40869180113077164 0.4018078800290823 0.34696186147630215 0.9572948440909386 0.400035472586751 0.3531211093068123 0.7240961641073227 0.8125612027943134] ]",
+  "[ 55/16 → 7/2 | s:saw note:Ab2 partials:[0.775677714496851 0.0502743236720562 0.3246541116386652 0.503994770348072 0.8252716399729252 0.89872563816607 0.060319963842630386 0.25497629307210445] ]",
+  "[ 7/2 → 57/16 | s:saw note:C2 partials:[0.40994881466031075 0.6455810181796551 0.35704658553004265 0.2732649203389883 0.31587288342416286 0.23243548162281513 0.22569947130978107 0.17241661623120308] ]",
+  "[ 57/16 → 29/8 | s:saw note:Ab2 partials:[0.8133465722203255 0.8327706772834063 0.32914630882442 0.23131784796714783 0.7526696771383286 0.1361286472529173 0.11441296897828579 0.36366880126297474] ]",
+  "[ 29/8 → 59/16 | s:saw note:C3 partials:[0.9391485787928104 0.3380728308111429 0.7723016366362572 0.998674126341939 0.7193406894803047 0.6963680125772953 0.9260678570717573 0.7829763628542423] ]",
+  "[ 59/16 → 15/4 | s:saw note:C3 partials:[0.9731374885886908 0.0494034755975008 0.990720022469759 0.9819309785962105 0.22877203114330769 0.7265191469341516 0.4922411348670721 0.7549834884703159] ]",
+  "[ 15/4 → 61/16 | s:saw note:Ab2 partials:[0.8121673222631216 0.25548945367336273 0.5759696904569864 0.6668333616107702 0.9233786761760712 0.11143362522125244 0.9734930321574211 0.369325939565897] ]",
+  "[ 61/16 → 31/8 | s:saw note:G1 partials:[0.1008925698697567 0.7558664139360189 0.1523460578173399 0.6523381881415844 0.9690635204315186 0.7343240566551685 0.9544064309448004 0.9150135722011328] ]",
+  "[ 31/8 → 63/16 | s:saw note:G2 partials:[0.7361665386706591 0.7657648548483849 0.21474426984786987 0.8228576295077801 0.5647660344839096 0.08148551359772682 0.9714624118059874 0.13992334716022015] ]",
+  "[ 63/16 → 4/1 | s:saw note:Bb1 partials:[0.3056422360241413 0.8881660811603069 0.7683485243469477 0.08641545102000237 0.5427133180201054 0.20803124643862247 0.5347504671663046 0.5977730695158243] ]",
+]
+`;
+
 exports[`runs examples > example "range" example index 0 1`] = `
 [
   "[ 0/1 → 1/8 | s:hh cutoff:2250 ]",

From 35016b58476b17d6b9a2c98b922df2d1fa9e76f6 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 15 Oct 2025 14:56:20 -0500
Subject: [PATCH 007/110] Mention range in docstring

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

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 327f8df51..77e77caa7 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2380,7 +2380,7 @@ export const scrub = register(
  * Can also be used to create a new synth via `s('user').partials(...)`
  *
  * @name partials
- * @param {number[] | Pattern} partials List of magnitudes for partials. 0th entry is the first harmonic (i.e. DC offset is skipped)
+ * @param {number[] | Pattern} partials List of [0, 1] magnitudes for partials. 0th entry is the first harmonic (i.e. DC offset is skipped)
  * @example
  * s("user").seg(16).n(irand(8)).scale("A:major")
  *   .partials([1, 0, 1, 0, 0, 1])
@@ -2394,7 +2394,7 @@ export const { partials } = registerControl('partials');
  * Rotates the harmonics of one of the core synths ('sine', 'tri', 'saw', 'user', ..) by a list of phases
  *
  * @name phases
- * @param {number[] | Pattern} phases List of phases for partials. 0th entry is the first phase (i.e. DC offset is skipped)
+ * @param {number[] | Pattern} phases List of [0, 1) phases for partials. 0th entry is the first phase (i.e. DC offset is skipped)
  * @example
  * s("saw").seg(8).n(irand(12)).scale("G#:minor")
  *   .partials(binaryL(256))

From fd03d1fdfbc57d7b1e4b8c14bdb414d44bdc0ec8 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 15 Oct 2025 15:14:31 -0500
Subject: [PATCH 008/110] Update conditional to allow  to control user
 waveforms

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

diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 0294762fb..10df1776b 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -472,7 +472,7 @@ export function getOscillator(s, t, value) {
   }
   s = s === 'user' && !partials ? 'triangle' : s;
   // If no partials are given, use stock waveforms
-  if (!partials || !partials?.length || s === 'sine') {
+  if (!partials || partials?.length === 0 || s === 'sine') {
     o = getAudioContext().createOscillator();
     o.type = s || 'triangle';
   }

From 47c85f8540386d36c42c5bc64f952bde12ac79d5 Mon Sep 17 00:00:00 2001
From: jeromew <jeromew@noreply.codeberg.org>
Date: Thu, 16 Oct 2025 14:06:33 +0200
Subject: [PATCH 009/110] fix interoperability of `all` with hydra

Hydra add methods on Array.prototype which breaks the Array enumeration with for...in.
Use for...of instead
cf https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...of#difference_between_for...of_and_for...in for details on the issue

without this fix, it is impossible to use both `await initHydra()` and `all` in the same strudel code. Strudel errors with "Error: got "undefined" instead of pattern."

example code: https://strudel.cc/#YXdhaXQgaW5pdEh5ZHJhKCkKCmFsbChwaWFub3JvbGwpCgokOiBzKCJiZCIp
---
 packages/core/repl.mjs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 171697eb9..064ef1eb8 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -227,8 +227,8 @@ export function repl({
         pattern = eachTransform(pattern);
       }
       if (allTransforms.length) {
-        for (let i in allTransforms) {
-          pattern = allTransforms[i](pattern);
+        for (const transform of allTransforms) {
+          pattern = transform(pattern);
         }
       }
 

From 1be9f40574aa213d3ef501024e5a0e18cb04fef9 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Sat, 18 Oct 2025 10:42:35 +0100
Subject: [PATCH 010/110] timeline feature

---
 packages/core/impure.mjs | 60 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 packages/core/impure.mjs

diff --git a/packages/core/impure.mjs b/packages/core/impure.mjs
new file mode 100644
index 000000000..66fc1dd5f
--- /dev/null
+++ b/packages/core/impure.mjs
@@ -0,0 +1,60 @@
+/*
+stateful.mjs - File of shame for stateful, impure and otherwise illegal pattern methods
+Copyright (C) 2025 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/core/index.mjs>
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+
+import { register, reify } from './pattern.mjs';
+
+let timelines = {};
+
+export const reset_timelines = function () {
+  timelines = {};
+};
+
+export const timeline = register(
+  'timeline',
+  function (tpat, pat) {
+    tpat = reify(tpat);
+    const f = function (state) {
+      let scheduler = !!state.controls._cps;
+
+      const timehaps = tpat.query(state);
+      const result = [];
+      for (const timehap of timehaps) {
+        const tlid = timehap.value;
+        const ignore = false;
+        let offset;
+        if (tlid in timelines) {
+          offset = timelines[tlid];
+        } else {
+          const timearc = timehap.wholeOrPart();
+          if (!scheduler || state.span.begin.lt(timearc.midpoint())) {
+            offset = timearc.begin;
+          } else {
+            // Sync to end of timearc if we first see it over halfway into its
+            // timespan. Allows 'cuing up' next timeline when live coding.
+            offset = timearc.end;
+          }
+        }
+        if (scheduler) {
+          // update state
+          timelines[tlid] = offset;
+          const negative = 0 - tlid;
+          if (negative in timelines) {
+            delete timelines[negative];
+          }
+        }
+
+        const pathaps = pat
+          .late(offset)
+          .query(state.setSpan(timehap.part))
+          .map((h) => h.setContext(h.combineContext(timehap)));
+        result.push(...pathaps);
+      }
+      return result;
+    };
+    return new Pattern(f, pat._steps);
+  },
+  false,
+);

From b2ce4591d9bd4260511bb08a06f791f515452456 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Sat, 18 Oct 2025 10:42:55 +0100
Subject: [PATCH 011/110] sort exports and add impure.mjs

---
 packages/core/index.mjs | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/packages/core/index.mjs b/packages/core/index.mjs
index e4daf445a..9260e3671 100644
--- a/packages/core/index.mjs
+++ b/packages/core/index.mjs
@@ -1,6 +1,6 @@
 /*
 index.mjs - <short description TODO>
-Copyright (C) 2022 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/core/index.mjs>
+Copyright (C) 2025 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/core/index.mjs>
 This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
@@ -11,20 +11,21 @@ import createClock from './zyklus.mjs';
 import { logger } from './logger.mjs';
 export { Fraction, controls, createClock };
 export * from './controls.mjs';
-export * from './hap.mjs';
-export * from './pattern.mjs';
-export * from './signal.mjs';
-export * from './pick.mjs';
-export * from './state.mjs';
-export * from './timespan.mjs';
-export * from './util.mjs';
-export * from './speak.mjs';
-export * from './evaluate.mjs';
-export * from './repl.mjs';
 export * from './cyclist.mjs';
+export * from './evaluate.mjs';
+export * from './hap.mjs';
+export * from './impure.mjs';
 export * from './logger.mjs';
+export * from './pattern.mjs';
+export * from './pick.mjs';
+export * from './repl.mjs';
+export * from './signal.mjs';
+export * from './speak.mjs';
+export * from './state.mjs';
 export * from './time.mjs';
+export * from './timespan.mjs';
 export * from './ui.mjs';
+export * from './util.mjs';
 export { default as drawLine } from './drawLine.mjs';
 // below won't work with runtime.mjs (json import fails)
 /* import * as p from './package.json';

From 92a82ce4bdf951ae80a34c0e609aa3515951fa6f Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Sat, 18 Oct 2025 10:49:15 +0100
Subject: [PATCH 012/110] delint

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

diff --git a/packages/core/impure.mjs b/packages/core/impure.mjs
index 66fc1dd5f..e16cfbe45 100644
--- a/packages/core/impure.mjs
+++ b/packages/core/impure.mjs
@@ -4,7 +4,7 @@ Copyright (C) 2025 Strudel contributors - see <https://codeberg.org/uzu/strudel/
 This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-import { register, reify } from './pattern.mjs';
+import { register, reify, Pattern } from './pattern.mjs';
 
 let timelines = {};
 

From 4c49cd9297326cf4991f1dca879bef3ed657be51 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sat, 18 Oct 2025 11:24:56 -0500
Subject: [PATCH 013/110] More examples

---
 packages/core/controls.mjs                | 30 ++++++++++++++++++
 test/__snapshots__/examples.test.mjs.snap | 37 +++++++++++++++++++++++
 2 files changed, 67 insertions(+)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 55a07cc27..281bf76b7 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -456,6 +456,9 @@ export const { attack, att } = registerControl('attack', 'att');
  * Whole numbers and simple ratios sound more natural,
  * while decimal numbers and complex ratios sound metallic.
  *
+ * A number may be added afterwards to control the harmonicity of
+ * any of the 8 individual FMs (e.g. `fmh2`)
+ *
  * @name fmh
  * @param {number | Pattern} harmonicity
  * @example
@@ -470,6 +473,11 @@ export const { fmh, fmh1, fmh2, fmh3, fmh4, fmh5, fmh6, fmh7, fmh8 } = registerM
  * Sets the Frequency Modulation of the synth.
  * Controls the modulation index, which defines the brightness of the sound.
  *
+ * A number may be added afterwards to control the modulation index of
+ * any of the 8 individual FMs (e.g. `fm3`). Also, FMs may be routed into
+ * each other with matrix commands like `fm13`, which would send `fm1` back into
+ * `fm3`
+ *
  * @name fmi
  * @param {number | Pattern} brightness modulation index
  * @synonyms fm
@@ -477,6 +485,10 @@ export const { fmh, fmh1, fmh2, fmh3, fmh4, fmh5, fmh6, fmh7, fmh8 } = registerM
  * note("c e g b g e")
  * .fm("<0 1 2 8 32>")
  * ._scope()
+ * @example
+ * s("sine").note("F1").seg(8)
+ *  .fm(4).fm2(rand.mul(4)).fm3(saw.mul(8).slow(8))
+ *  .fmh(1.06).fmh2(10).fmh3(0.1)
  *
  */
 export const { fmi, fmi1, fmi2, fmi3, fmi4, fmi5, fmi6, fmi7, fmi8, fm, fm1, fm2, fm3, fm4, fm5, fm6, fm7, fm8 } =
@@ -485,6 +497,9 @@ export const { fmi, fmi1, fmi2, fmi3, fmi4, fmi5, fmi6, fmi7, fmi8, fm, fm1, fm2
 /**
  * Ramp type of fm envelope. Exp might be a bit broken..
  *
+ * A number may be added afterwards to control the envelope of
+ * any of the 8 individual FMs (e.g. `fmenv4`)
+ *
  * @name fmenv
  * @param {number | Pattern} type lin | exp
  * @example
@@ -503,6 +518,9 @@ export const { fmenv, fmenv1, fmenv2, fmenv3, fmenv4, fmenv5, fmenv6, fmenv7, fm
 /**
  * Attack time for the FM envelope: time it takes to reach maximum modulation
  *
+ * A number may be added afterwards to control the attack of the envelope of
+ * any of the 8 individual FMs (e.g. `fmatt5`)
+ *
  * @name fmattack
  * @synonyms fmatt
  * @param {number | Pattern} time attack time
@@ -537,6 +555,9 @@ export const {
 /**
  * Waveform of the fm modulator
  *
+ * A number may be added afterwards to control the waveform
+ * any of the 8 individual FMs (e.g. `fmwave6`)
+ *
  * @name fmwave
  * @param {number | Pattern} wave waveform
  * @example
@@ -553,6 +574,9 @@ export const { fmwave, fmwave1, fmwave2, fmwave3, fmwave4, fmwave5, fmwave6, fmw
 /**
  * Decay time for the FM envelope: seconds until the sustain level is reached after the attack phase.
  *
+ * A number may be added afterwards to control the decay of the envelope of
+ * any of the 8 individual FMs (e.g. `fmdec6`)
+ *
  * @name fmdecay
  * @synonyms fmdec
  * @param {number | Pattern} time decay time
@@ -587,6 +611,9 @@ export const {
 /**
  * Sustain level for the FM envelope: how much modulation is applied after the decay phase
  *
+ * A number may be added afterwards to control the sustain of the envelope of
+ * any of the 8 individual FMs (e.g. `fmsus7`)
+ *
  * @name fmsustain
  * @synonyms fmsus
  * @param {number | Pattern} level sustain level
@@ -621,6 +648,9 @@ export const {
 /**
  * Release time for the FM envelope: how much modulation is applied after the note is released
  *
+ * A number may be added afterwards to control the release of the envelope of
+ * any of the 8 individual FMs (e.g. `fmrel8`)
+ *
  * @name fmrelease
  * @synonyms fmrel
  * @param {number | Pattern} time release time
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 590c47e4e..04360a4dd 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -4101,6 +4101,43 @@ exports[`runs examples > example "fmi" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "fmi" example index 1 1`] = `
+[
+  "[ 0/1 → 1/8 | s:sine note:F1 fmi:4 fmi2:0 fmi3:0 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 1/8 → 1/4 | s:sine note:F1 fmi:4 fmi2:2.7408622801303864 fmi3:0.125 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 1/4 → 3/8 | s:sine note:F1 fmi:4 fmi2:1.479038767516613 fmi3:0.25 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 3/8 → 1/2 | s:sine note:F1 fmi:4 fmi2:1.605570062994957 fmi3:0.375 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 1/2 → 5/8 | s:sine note:F1 fmi:4 fmi2:1.041922464966774 fmi3:0.5 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 5/8 → 3/4 | s:sine note:F1 fmi:4 fmi2:0.5425434708595276 fmi3:0.625 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 3/4 → 7/8 | s:sine note:F1 fmi:4 fmi2:0.7833059206604958 fmi3:0.75 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 7/8 → 1/1 | s:sine note:F1 fmi:4 fmi2:1.590524323284626 fmi3:0.875 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 1/1 → 9/8 | s:sine note:F1 fmi:4 fmi2:2.078168660402298 fmi3:1 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 9/8 → 5/4 | s:sine note:F1 fmi:4 fmi2:2.689958058297634 fmi3:1.125 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 5/4 → 11/8 | s:sine note:F1 fmi:4 fmi2:2.914912812411785 fmi3:1.25 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 11/8 → 3/2 | s:sine note:F1 fmi:4 fmi2:0.7312150076031685 fmi3:1.375 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 3/2 → 13/8 | s:sine note:F1 fmi:4 fmi2:2.4336322993040085 fmi3:1.5 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 13/8 → 7/4 | s:sine note:F1 fmi:4 fmi2:1.987018845975399 fmi3:1.625 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 7/4 → 15/8 | s:sine note:F1 fmi:4 fmi2:0.8189515843987465 fmi3:1.75 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 15/8 → 2/1 | s:sine note:F1 fmi:4 fmi2:2.3782287165522575 fmi3:1.875 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 2/1 → 17/8 | s:sine note:F1 fmi:4 fmi2:3.838108479976654 fmi3:2 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 17/8 → 9/4 | s:sine note:F1 fmi:4 fmi2:3.613561175763607 fmi3:2.125 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 9/4 → 19/8 | s:sine note:F1 fmi:4 fmi2:1.3819300457835197 fmi3:2.25 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 19/8 → 5/2 | s:sine note:F1 fmi:4 fmi2:3.346026562154293 fmi3:2.375 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 5/2 → 21/8 | s:sine note:F1 fmi:4 fmi2:1.8344642966985703 fmi3:2.5 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 21/8 → 11/4 | s:sine note:F1 fmi:4 fmi2:0.6407739371061325 fmi3:2.625 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 11/4 → 23/8 | s:sine note:F1 fmi:4 fmi2:2.5329310819506645 fmi3:2.75 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 23/8 → 3/1 | s:sine note:F1 fmi:4 fmi2:0.06501668691635132 fmi3:2.875 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 3/1 → 25/8 | s:sine note:F1 fmi:4 fmi2:0.8691564425826073 fmi3:3 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 25/8 → 13/4 | s:sine note:F1 fmi:4 fmi2:1.3729755133390427 fmi3:3.125 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 13/4 → 27/8 | s:sine note:F1 fmi:4 fmi2:3.9694602862000465 fmi3:3.25 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 27/8 → 7/2 | s:sine note:F1 fmi:4 fmi2:1.6347672045230865 fmi3:3.375 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 7/2 → 29/8 | s:sine note:F1 fmi:4 fmi2:1.639795258641243 fmi3:3.5 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 29/8 → 15/4 | s:sine note:F1 fmi:4 fmi2:3.7565943151712418 fmi3:3.625 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 15/4 → 31/8 | s:sine note:F1 fmi:4 fmi2:3.2486692890524864 fmi3:3.75 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+  "[ 31/8 → 4/1 | s:sine note:F1 fmi:4 fmi2:2.9446661546826363 fmi3:3.875 fmh:1.06 fmh2:10 fmh3:0.1 ]",
+]
+`;
+
 exports[`runs examples > example "fmsustain" example index 0 1`] = `
 [
   "[ 0/1 → 1/6 | note:c fmi:4 fmdecay:0.1 fmsustain:1 ]",

From bfa8fa3c757b2b457ee6aa5ef1a55f8bf14902e2 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Sun, 16 Nov 2025 09:23:11 +0000
Subject: [PATCH 014/110] [perf] fix `connect leak` when .noise() is in the mix

---
 packages/superdough/helpers.mjs | 14 +++++++++++++-
 packages/superdough/noise.mjs   |  3 ++-
 packages/superdough/synth.mjs   | 23 +++++++++++++----------
 3 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 47161ed61..de64df0e8 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -262,7 +262,15 @@ export function drywet(dry, wet, wetAmount = 0) {
   let mix = ac.createGain();
   dry_gain.connect(mix);
   wet_gain.connect(mix);
-  return mix;
+  return {
+    node: mix,
+    onended: () => {
+      dry_gain.disconnect(mix);
+      wet_gain.disconnect(mix);
+      dry.disconnect(dry_gain);
+      wet.disconnect(wet_gain);
+    },
+  };
 }
 
 let curves = ['linear', 'exponential'];
@@ -297,6 +305,10 @@ export function getVibratoOscillator(param, value, t) {
     gain.gain.value = vibmod * 100;
     vibratoOscillator.connect(gain);
     gain.connect(param);
+    vibratoOscillator.onended = () => {
+      gain.disconnect(param);
+      vibratoOscillator.disconnect(gain);
+    };
     vibratoOscillator.start(t);
     return vibratoOscillator;
   }
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 816dd252b..3e41515df 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -65,8 +65,9 @@ export function getNoiseOscillator(type = 'white', t, density = 0.02) {
 export function getNoiseMix(inputNode, wet, t) {
   const noiseOscillator = getNoiseOscillator('pink', t);
   const noiseMix = drywet(inputNode, noiseOscillator.node, wet);
+  noiseOscillator.node.onended = () => noiseMix.onended();
   return {
-    node: noiseMix,
+    node: noiseMix.node,
     stop: (time) => noiseOscillator?.stop(time),
   };
 }
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index e35b98806..a9ec7975c 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -47,19 +47,17 @@ export function registerSynthSounds() {
           [0.001, 0.05, 0.6, 0.01],
         );
 
-        let sound = getOscillator(s, t, value);
-        let { node: o, stop, triggerRelease } = sound;
-
         // turn down
         const g = gainNode(0.3);
 
-        const { duration } = value;
-
-        o.onended = () => {
-          o.disconnect();
+        let sound = getOscillator(s, t, value, () => {
           g.disconnect();
           onended();
-        };
+        });
+
+        let { node: o, stop, triggerRelease } = sound;
+
+        const { duration } = value;
 
         const envGain = gainNode(1);
         let node = o.connect(g).connect(envGain);
@@ -446,7 +444,7 @@ export function waveformN(partials, type) {
 }
 
 // expects one of waveforms as s
-export function getOscillator(s, t, value) {
+export function getOscillator(s, t, value, onended) {
   let { n: partials, duration, noise = 0 } = value;
   let o;
   // If no partials are given, use stock waveforms
@@ -460,7 +458,6 @@ export function getOscillator(s, t, value) {
   }
   // set frequency
   o.frequency.value = getFrequencyFromValue(value);
-  o.start(t);
 
   let vibratoOscillator = getVibratoOscillator(o.detune, value, t);
 
@@ -473,6 +470,12 @@ export function getOscillator(s, t, value) {
     noiseMix = getNoiseMix(o, noise, t);
   }
 
+  o.onended = () => {
+    noiseMix?.node.disconnect();
+    onended();
+  };
+  o.start(t);
+
   return {
     node: noiseMix?.node || o,
     stop: (time) => {

From cc10122b7184d4271c4a166673a76726854ac1c7 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 16 Nov 2025 19:20:42 -0600
Subject: [PATCH 015/110] Testing out approach to allow list patterns in
 partials

---
 packages/core/controls.mjs         | 28 ---------------
 packages/core/pattern.mjs          | 51 ++++++++++++++++++++++++++
 website/src/pages/learn/synths.mdx | 57 ++++++++++++++++++++++++++----
 3 files changed, 101 insertions(+), 35 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 1d19a94b6..9a2be7f44 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2583,31 +2583,3 @@ export const scrub = register(
   },
   false,
 );
-
-/**
- * Scale the magnitude of the harmonics of one of the core synths ('sine', 'tri', 'saw', ..)
- *
- * Can also be used to create a new synth via `s('user').partials(...)`
- *
- * @name partials
- * @param {number[] | Pattern} partials List of [0, 1] magnitudes for partials. 0th entry is the first harmonic (i.e. DC offset is skipped)
- * @example
- * s("user").seg(16).n(irand(8)).scale("A:major")
- *   .partials([1, 0, 1, 0, 0, 1])
- * @example
- * s("saw").seg(8).n(irand(12)).scale("G#:minor")
- *   .partials(binaryL(256))
- */
-export const { partials } = registerControl('partials');
-
-/**
- * Rotates the harmonics of one of the core synths ('sine', 'tri', 'saw', 'user', ..) by a list of phases
- *
- * @name phases
- * @param {number[] | Pattern} phases List of [0, 1) phases for partials. 0th entry is the first phase (i.e. DC offset is skipped)
- * @example
- * s("saw").seg(8).n(irand(12)).scale("G#:minor")
- *   .partials(binaryL(256))
- *   .phases(randL(20))
- */
-export const { phases } = registerControl('phases');
diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index e29769900..f08667cf7 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -3624,3 +3624,54 @@ for (const name of distAlgoNames) {
     return this.distort(argsPat);
   };
 }
+
+/**
+ * Turns a list of patterns into a single pattern which outputs list-values
+ *
+ * @name parray
+ * @returns Pattern
+ */
+export const parray = (pats) => {
+  const pack = (...xs) => xs;
+  let acc = pure(curry(pack, null, pats.length));
+  for (const p of pats) acc = acc.appBoth(reify(p));
+  return acc;
+};
+
+/**
+ * Scale the magnitude of the harmonics of one of the core synths ('sine', 'tri', 'saw', ..)
+ *
+ * Can also be used to create a new synth via `s('user').partials(...)`
+ *
+ * @name partials
+ * @param {number[] | Pattern} partials List of [0, 1] magnitudes for partials. 0th entry is the first harmonic (i.e. DC offset is skipped)
+ * @example
+ * s("user").seg(16).n(irand(8)).scale("A:major")
+ *   .partials([1, 0, 1, 0, 0, 1])
+ * @example
+ * s("saw").seg(8).n(irand(12)).scale("G#:minor")
+ *   .partials(binaryL(256))
+ */
+export const { partials } = register('partials', (list, pat) => {
+  if (Array.isArray(list)) {
+    list = parray(list);
+  }
+  return pat.withValue((v) => ({...v, partials: list}));
+});
+
+/**
+ * Rotates the harmonics of one of the core synths ('sine', 'tri', 'saw', 'user', ..) by a list of phases
+ *
+ * @name phases
+ * @param {number[] | Pattern} phases List of [0, 1) phases for partials. 0th entry is the first phase (i.e. DC offset is skipped)
+ * @example
+ * s("saw").seg(8).n(irand(12)).scale("G#:minor")
+ *   .partials(binaryL(256))
+ *   .phases(randL(20))
+ */
+export const { phases } = register('phases', (list, pat) => {
+  if (Array.isArray(list)) {
+    list = parray(list);
+  }
+  return pat.withValue((v) => ({...v, phases: list}));
+});
diff --git a/website/src/pages/learn/synths.mdx b/website/src/pages/learn/synths.mdx
index 0fcc41363..1a65568df 100644
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@@ -48,28 +48,71 @@ You can also use the `crackle` type to play some subtle noise crackles. You can
 
 ### Additive Synthesis
 
-To tame the harsh sound of the basic waveforms, we can set the `n` control to limit the overtones of the waveform:
+Waveforms are often composed of several [harmonics](https://en.wikipedia.org/wiki/Harmonic) above a fundamental frequency, lying at integer multiples. These overtones combine to give a sound its unique timbral quality.
+
+For the basic waveforms, we offer you control over these harmonics with the `partials` and `phases` functions.
+
+#### Partials
+
+`partials` refers to the magnitude of each harmonic relative to the fundamental frequency. They can thus be used to spectrally filter these waveforms and tame some of their harshness:
 
 <MiniRepl
   client:idle
   tune={`note("c2 <eb2 <g2 g1>>".fast(2))
 .sound("sawtooth")
-.n("<32 16 8 4>")
+.partials([1, 1, 0, 1])
 ._scope()`}
 />
 
-When the `n` control is used on a basic waveform, it defines the number of harmonic partials the sound is getting.
-You can also set `n` directly in mini notation with `sound`:
+`partials` can also be used to construct _new_ waveforms not present in our basic set with the 'user' sound source:
 
 <MiniRepl
   client:idle
   tune={`note("c2 <eb2 <g2 g1>>".fast(2))
-.sound("sawtooth:<32 16 8 4>")
+.sound("user")
+.partials([1, 0, 0.3, 0, 0.1, 0, 0, 0.3])
 ._scope()`}
 />
 
-Note for tidal users: `n` in tidal is synonymous to `note` for synths only.
-In strudel, this is not the case, where `n` will always change timbre, be it though different samples or different waveforms.
+We may algorithmically construct lists of partials with Javascript code like:
+
+<MiniRepl
+  client:idle
+  tune={`const numHarmonics = 22;
+note("c2 <eb2 <g2 g1>>".fast(2))
+.sound("user")
+.partials(new Array(numHarmonics).fill(1))
+._scope()`}
+/>
+
+This approach can act as a form of bandlimiting. `partials` is also compatible with pattern functions designed to produce lists, like `randL` or `binaryL`:
+
+<MiniRepl
+  client:idle
+  tune={`const numHarmonics = 22;
+note("c2 <eb2 <g2 g1>>".fast(2))
+.sound("user")
+.partials(randL(8))
+._scope()`}
+/>
+
+Note that the first value in the `partials` array controls the magnitude of the fundamental harmonic rather than the DC offset, which is fixed at 0.
+
+#### Phases
+
+We mentioned that our sounds can be broken into a constituent set of harmonics above a fundamental frequency. These are defined by two values: their magnitude (how loud they are) and their [phase](https://en.wikipedia.org/wiki/Phase_(waves)), which can be thought of as which point in its cycle each sine wave is initialized at when we begin adding them.
+
+These phases too can be declared in Strudel and can give your sounds interesting depth.
+
+<MiniRepl
+  client:idle
+  tune={`const numHarmonics = 22;
+note("c2 <eb2 <g2 g1>>".fast(2))
+.sound("user")
+.partials(randL(8))
+.phases(randL(8).late(0.3))
+._scope()`}
+/>
 
 ## Vibrato
 

From 7a3bea6f9087105ed0be0982798b9dd26c9ed089 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 16 Nov 2025 19:38:59 -0600
Subject: [PATCH 016/110] Working version

---
 packages/core/pattern.mjs          |  5 +++--
 website/src/pages/learn/synths.mdx | 10 ++++++++++
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index f08667cf7..cd8c5871a 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -3653,10 +3653,11 @@ export const parray = (pats) => {
  *   .partials(binaryL(256))
  */
 export const { partials } = register('partials', (list, pat) => {
+  debugger;
   if (Array.isArray(list)) {
     list = parray(list);
   }
-  return pat.withValue((v) => ({...v, partials: list}));
+  return pat.withValue((v) => (l) => ({...v, partials: l})).appLeft(list);
 });
 
 /**
@@ -3673,5 +3674,5 @@ export const { phases } = register('phases', (list, pat) => {
   if (Array.isArray(list)) {
     list = parray(list);
   }
-  return pat.withValue((v) => ({...v, phases: list}));
+  return pat.withValue((v) => (l) => ({...v, phases: l})).appLeft(list);
 });
diff --git a/website/src/pages/learn/synths.mdx b/website/src/pages/learn/synths.mdx
index 1a65568df..b209dc9c0 100644
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@@ -96,6 +96,16 @@ note("c2 <eb2 <g2 g1>>".fast(2))
 ._scope()`}
 />
 
+and with lists _of_ patterns:
+
+<MiniRepl
+  client:idle
+  tune={`note("c2 <eb2 <g2 g1>>".fast(4))
+.sound("user")
+.partials([1, 0, "0 1", "0 1 0.3", rand])
+._scope()`}
+/>
+
 Note that the first value in the `partials` array controls the magnitude of the fundamental harmonic rather than the DC offset, which is fixed at 0.
 
 #### Phases

From f5ed6dbe79a683dac229ed095ac0c4ff592c72ea Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 16 Nov 2025 20:28:22 -0600
Subject: [PATCH 017/110] Top level functions

---
 packages/core/pattern.mjs                | 36 +++++++++++++++------
 packages/core/test/pattern.test.mjs      |  4 +--
 website/src/components/Header/Search.css |  4 +--
 website/src/pages/learn/synths.mdx       | 40 +++++++++++++++---------
 4 files changed, 56 insertions(+), 28 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index cd8c5871a..3c21bd1b2 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -3644,35 +3644,51 @@ export const parray = (pats) => {
  * Can also be used to create a new synth via `s('user').partials(...)`
  *
  * @name partials
- * @param {number[] | Pattern} partials List of [0, 1] magnitudes for partials. 0th entry is the first harmonic (i.e. DC offset is skipped)
+ * @param {number[] | Pattern} magnitudes List of [0, 1] magnitudes for partials. 0th entry is the fundamental harmonic (i.e. DC offset is skipped)
  * @example
  * s("user").seg(16).n(irand(8)).scale("A:major")
  *   .partials([1, 0, 1, 0, 0, 1])
  * @example
  * s("saw").seg(8).n(irand(12)).scale("G#:minor")
- *   .partials(binaryL(256))
+ *   .partials(randL(16))
  */
-export const { partials } = register('partials', (list, pat) => {
-  debugger;
+register('partials', (list, pat) => {
   if (Array.isArray(list)) {
     list = parray(list);
   }
-  return pat.withValue((v) => (l) => ({...v, partials: l})).appLeft(list);
+  return pat.withValue((v) => (l) => ({ ...v, partials: l })).appLeft(list);
 });
 
+// Also create a top-level function
+export const partials = (list) => {
+  if (Array.isArray(list)) {
+    list = parray(list);
+  }
+  return list.as('partials');
+};
+
 /**
  * Rotates the harmonics of one of the core synths ('sine', 'tri', 'saw', 'user', ..) by a list of phases
  *
  * @name phases
- * @param {number[] | Pattern} phases List of [0, 1) phases for partials. 0th entry is the first phase (i.e. DC offset is skipped)
+ * @param {number[] | Pattern} phases List of [0, 1) phases for partials. 0th entry is the fundamental phase (i.e. DC offset is skipped)
  * @example
  * s("saw").seg(8).n(irand(12)).scale("G#:minor")
- *   .partials(binaryL(256))
- *   .phases(randL(20))
+ *   .partials(randL(16))
+ *   .phases(randL(16))
  */
-export const { phases } = register('phases', (list, pat) => {
+register('phases', (list, pat) => {
   if (Array.isArray(list)) {
     list = parray(list);
   }
-  return pat.withValue((v) => (l) => ({...v, phases: l})).appLeft(list);
+  pat = pat ?? pure({});
+  return pat.withValue((v) => (l) => ({ ...v, phases: l })).appLeft(list);
 });
+
+// Also create a top-level function
+export const phases = (list) => {
+  if (Array.isArray(list)) {
+    list = parray(list);
+  }
+  return list.as('phases');
+};
diff --git a/packages/core/test/pattern.test.mjs b/packages/core/test/pattern.test.mjs
index 625f40756..1df5c8776 100644
--- a/packages/core/test/pattern.test.mjs
+++ b/packages/core/test/pattern.test.mjs
@@ -796,7 +796,7 @@ describe('Pattern', () => {
     });
   });
   describe('apply', () => {
-    (it('Can apply a function', () => {
+    it('Can apply a function', () => {
       expect(sequence('a', 'b').apply(fast(2)).firstCycle()).toStrictEqual(sequence('a', 'b').fast(2).firstCycle());
     }),
       it('Can apply a pattern of functions', () => {
@@ -804,7 +804,7 @@ describe('Pattern', () => {
         expect(sequence('a', 'b').apply(fast(2), fast(3)).firstCycle()).toStrictEqual(
           sequence('a', 'b').fast(2, 3).firstCycle(),
         );
-      }));
+      });
   });
   describe('layer', () => {
     it('Can layer up multiple functions', () => {
diff --git a/website/src/components/Header/Search.css b/website/src/components/Header/Search.css
index b14146cbd..456ef9f6b 100644
--- a/website/src/components/Header/Search.css
+++ b/website/src/components/Header/Search.css
@@ -18,8 +18,8 @@
   --docsearch-modal-background: var(--background);
   --docsearch-muted-color: color-mix(in srgb, var(--foreground), #fff 30%);
   --docsearch-key-gradient: var(--foreground);
-  --docsearch-key-shadow:
-    inset 0 -2px 0 0 var(--gutterForeground), inset 0 0 1px 1px var(--foreground), 0 1px 2px 1px var(--gutterBackground);
+  --docsearch-key-shadow: inset 0 -2px 0 0 var(--gutterForeground), inset 0 0 1px 1px var(--foreground),
+    0 1px 2px 1px var(--gutterBackground);
 }
 .dark {
   --docsearch-muted-color: color-mix(in srgb, var(--foreground), #000 30%);
diff --git a/website/src/pages/learn/synths.mdx b/website/src/pages/learn/synths.mdx
index b209dc9c0..6fc5b6925 100644
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@@ -48,7 +48,7 @@ You can also use the `crackle` type to play some subtle noise crackles. You can
 
 ### Additive Synthesis
 
-Waveforms are often composed of several [harmonics](https://en.wikipedia.org/wiki/Harmonic) above a fundamental frequency, lying at integer multiples. These overtones combine to give a sound its unique timbral quality.
+Periodic waveforms are composed of several [harmonics](https://en.wikipedia.org/wiki/Harmonic) above a fundamental frequency, lying at integer multiples. These overtones combine to give a sound its unique timbral quality.
 
 For the basic waveforms, we offer you control over these harmonics with the `partials` and `phases` functions.
 
@@ -60,7 +60,7 @@ For the basic waveforms, we offer you control over these harmonics with the `par
   client:idle
   tune={`note("c2 <eb2 <g2 g1>>".fast(2))
 .sound("sawtooth")
-.partials([1, 1, 0, 1])
+.partials([1, 1, "<1 0>", "<1 0>", "<1 0>", "<1 0>", "<1 0>"])
 ._scope()`}
 />
 
@@ -74,25 +74,38 @@ For the basic waveforms, we offer you control over these harmonics with the `par
 ._scope()`}
 />
 
-We may algorithmically construct lists of partials with Javascript code like:
+We may algorithmically construct lists of magnitudes with Javascript code like:
 
 <MiniRepl
   client:idle
   tune={`const numHarmonics = 22;
 note("c2 <eb2 <g2 g1>>".fast(2))
-.sound("user")
+.sound("saw")
 .partials(new Array(numHarmonics).fill(1))
 ._scope()`}
 />
 
-This approach can act as a form of bandlimiting. `partials` is also compatible with pattern functions designed to produce lists, like `randL` or `binaryL`:
+which acts as a spectral filter or
 
 <MiniRepl
   client:idle
-  tune={`const numHarmonics = 22;
-note("c2 <eb2 <g2 g1>>".fast(2))
+  tune={`note("c2 <eb2 <g2 g1>>").fast(2)
 .sound("user")
-.partials(randL(8))
+.partials(new Array(50).fill(0)
+  .map((_, idx) => ((-1) ** (idx + 1)) / (idx + 1))
+)
+._scope()`}
+/>
+
+which recovers a familiar waveform.
+
+`partials` is also compatible with pattern functions designed to produce lists, like `randL` or `binaryL`:
+
+<MiniRepl
+  client:idle
+  tune={`note("c2 <eb2 <g2 g1>>").fast(2)
+.sound("user")
+.partials(randL(10))
 ._scope()`}
 />
 
@@ -110,17 +123,16 @@ Note that the first value in the `partials` array controls the magnitude of the
 
 #### Phases
 
-We mentioned that our sounds can be broken into a constituent set of harmonics above a fundamental frequency. These are defined by two values: their magnitude (how loud they are) and their [phase](https://en.wikipedia.org/wiki/Phase_(waves)), which can be thought of as which point in its cycle each sine wave is initialized at when we begin adding them.
+Earlier, we mentioned that periodic waveforms can be broken into a set of harmonics above a fundamental frequency. Each harmonic has two defining properties: its magnitude (how loud it is) and its phase, which determines where in its cycle that sine wave starts when the waveform is built.
 
 These phases too can be declared in Strudel and can give your sounds interesting depth.
 
 <MiniRepl
   client:idle
-  tune={`const numHarmonics = 22;
-note("c2 <eb2 <g2 g1>>".fast(2))
-.sound("user")
-.partials(randL(8))
-.phases(randL(8).late(0.3))
+  tune={`note("c2 <eb2 <g2 g1>>".fast(2))
+.sound("saw")
+.partials(randL(100))
+.phases(randL(100))
 ._scope()`}
 />
 

From 641bd2f356f16072dd69e75509697294e479ac38 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 16 Nov 2025 22:17:53 -0600
Subject: [PATCH 018/110] Properly patternify everything

---
 packages/core/pattern.mjs                 |  45 +++---
 test/__snapshots__/examples.test.mjs.snap | 160 +++++++++++++---------
 website/src/pages/learn/synths.mdx        |  13 +-
 3 files changed, 123 insertions(+), 95 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 3c21bd1b2..4737f0db0 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -3638,6 +3638,13 @@ export const parray = (pats) => {
   return acc;
 };
 
+const _ensureListPattern = (list) => {
+  if (Array.isArray(list)) {
+    return parray(list);
+  }
+  return reify(list);
+};
+
 /**
  * Scale the magnitude of the harmonics of one of the core synths ('sine', 'tri', 'saw', ..)
  *
@@ -3650,21 +3657,15 @@ export const parray = (pats) => {
  *   .partials([1, 0, 1, 0, 0, 1])
  * @example
  * s("saw").seg(8).n(irand(12)).scale("G#:minor")
- *   .partials(randL(16))
+ *   .partials(binaryL(irand(256).add("1")))
  */
-register('partials', (list, pat) => {
-  if (Array.isArray(list)) {
-    list = parray(list);
-  }
-  return pat.withValue((v) => (l) => ({ ...v, partials: l })).appLeft(list);
-});
+Pattern.prototype.partials = function (list) {
+  return this.withValue((v) => (l) => ({ ...v, partials: l })).appLeft(_ensureListPattern(list));
+};
 
 // Also create a top-level function
 export const partials = (list) => {
-  if (Array.isArray(list)) {
-    list = parray(list);
-  }
-  return list.as('partials');
+  return _ensureListPattern(list).as('partials');
 };
 
 /**
@@ -3673,22 +3674,16 @@ export const partials = (list) => {
  * @name phases
  * @param {number[] | Pattern} phases List of [0, 1) phases for partials. 0th entry is the fundamental phase (i.e. DC offset is skipped)
  * @example
- * s("saw").seg(8).n(irand(12)).scale("G#:minor")
- *   .partials(randL(16))
- *   .phases(randL(16))
+ * // Phase cancellation
+ * s("saw").seg(8).n(irand(12)).scale("G#1:minor")
+ *   .partials(partials([1, 1, 1]))
+ *   .superimpose(x => x.phases([0.5, 0.5, 0.5]))
  */
-register('phases', (list, pat) => {
-  if (Array.isArray(list)) {
-    list = parray(list);
-  }
-  pat = pat ?? pure({});
-  return pat.withValue((v) => (l) => ({ ...v, phases: l })).appLeft(list);
-});
+Pattern.prototype.phases = function (list) {
+  return this.withValue((v) => (l) => ({ ...v, phases: l })).appLeft(_ensureListPattern(list));
+};
 
 // Also create a top-level function
 export const phases = (list) => {
-  if (Array.isArray(list)) {
-    list = parray(list);
-  }
-  return list.as('phases');
+  return _ensureListPattern(list).as('phases');
 };
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 4b4c36e98..32e61c31d 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -7290,38 +7290,38 @@ exports[`runs examples > example "partials" example index 0 1`] = `
 
 exports[`runs examples > example "partials" example index 1 1`] = `
 [
-  "[ 0/1 → 1/8 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 1/8 → 1/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 1/4 → 3/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 3/8 → 1/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 1/2 → 5/8 | s:saw note:C#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 5/8 → 3/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 3/4 → 7/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 7/8 → 1/1 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 1/1 → 9/8 | s:saw note:F#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 9/8 → 5/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 5/4 → 11/8 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 11/8 → 3/2 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 3/2 → 13/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 13/8 → 7/4 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 7/4 → 15/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 15/8 → 2/1 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 2/1 → 17/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 17/8 → 9/4 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 9/4 → 19/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 19/8 → 5/2 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 5/2 → 21/8 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 21/8 → 11/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 11/4 → 23/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 23/8 → 3/1 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 3/1 → 25/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 25/8 → 13/4 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 13/4 → 27/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 27/8 → 7/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 7/2 → 29/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 29/8 → 15/4 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 15/4 → 31/8 | s:saw note:B4 partials:[1 0 0 0 0 0 0 0 0] ]",
-  "[ 31/8 → 4/1 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] ]",
+  "[ 0/1 → 1/8 | s:saw note:G#3 partials:[1] ]",
+  "[ 1/8 → 1/4 | s:saw note:A#4 partials:[1 0 1 1 0 0 0 0] ]",
+  "[ 1/4 → 3/8 | s:saw note:D#4 partials:[1 0 1 1 1 1 1] ]",
+  "[ 3/8 → 1/2 | s:saw note:D#4 partials:[1 1 0 0 1 1 1] ]",
+  "[ 1/2 → 5/8 | s:saw note:C#4 partials:[1 0 0 0 0 1 1] ]",
+  "[ 5/8 → 3/4 | s:saw note:A#3 partials:[1 0 0 0 1 1] ]",
+  "[ 3/4 → 7/8 | s:saw note:B3 partials:[1 1 0 0 1 1] ]",
+  "[ 7/8 → 1/1 | s:saw note:D#4 partials:[1 1 0 0 1 1 0] ]",
+  "[ 1/1 → 9/8 | s:saw note:F#4 partials:[1 0 0 0 0 1 1 0] ]",
+  "[ 9/8 → 5/4 | s:saw note:A#4 partials:[1 0 1 0 1 1 0 1] ]",
+  "[ 5/4 → 11/8 | s:saw note:A#4 partials:[1 0 1 1 1 0 1 1] ]",
+  "[ 11/8 → 3/2 | s:saw note:B3 partials:[1 0 1 1 1 1] ]",
+  "[ 3/2 → 13/8 | s:saw note:G#4 partials:[1 0 0 1 1 1 0 0] ]",
+  "[ 13/8 → 7/4 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0] ]",
+  "[ 7/4 → 15/8 | s:saw note:B3 partials:[1 1 0 1 0 1] ]",
+  "[ 15/8 → 2/1 | s:saw note:G#4 partials:[1 0 0 1 1 0 0 1] ]",
+  "[ 2/1 → 17/8 | s:saw note:D#5 partials:[1 1 1 1 0 1 1 0] ]",
+  "[ 17/8 → 9/4 | s:saw note:C#5 partials:[1 1 1 0 1 0 0 0] ]",
+  "[ 9/4 → 19/8 | s:saw note:D#4 partials:[1 0 1 1 0 0 1] ]",
+  "[ 19/8 → 5/2 | s:saw note:C#5 partials:[1 1 0 1 0 1 1 1] ]",
+  "[ 5/2 → 21/8 | s:saw note:E4 partials:[1 1 1 0 1 1 0] ]",
+  "[ 21/8 → 11/4 | s:saw note:A#3 partials:[1 0 1 0 1 0] ]",
+  "[ 11/4 → 23/8 | s:saw note:G#4 partials:[1 0 1 0 0 0 1 1] ]",
+  "[ 23/8 → 3/1 | s:saw note:G#3 partials:[1 0 1] ]",
+  "[ 3/1 → 25/8 | s:saw note:B3 partials:[1 1 1 0 0 0] ]",
+  "[ 25/8 → 13/4 | s:saw note:D#4 partials:[1 0 1 1 0 0 0] ]",
+  "[ 13/4 → 27/8 | s:saw note:D#5 partials:[1 1 1 1 1 1 1 1] ]",
+  "[ 27/8 → 7/2 | s:saw note:D#4 partials:[1 1 0 1 0 0 1] ]",
+  "[ 7/2 → 29/8 | s:saw note:D#4 partials:[1 1 0 1 0 0 1] ]",
+  "[ 29/8 → 15/4 | s:saw note:D#5 partials:[1 1 1 1 0 0 0 1] ]",
+  "[ 15/4 → 31/8 | s:saw note:B4 partials:[1 1 0 1 0 0 0 0] ]",
+  "[ 31/8 → 4/1 | s:saw note:A#4 partials:[1 0 1 1 1 1 0 1] ]",
 ]
 `;
 
@@ -7580,38 +7580,70 @@ exports[`runs examples > example "phasersweep" example index 0 1`] = `
 
 exports[`runs examples > example "phases" example index 0 1`] = `
 [
-  "[ 0/1 → 1/8 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0] ]",
-  "[ 1/8 → 1/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6852155700325966 0.17723728902637959 0.8521428182721138 0.5022399611771107 0.9780306946486235 0.3186125475913286 0.1851645242422819 0.8495976086705923 0.9832699615508318 0.8203876558691263 0.7365445382893085 0.6727468091994524 0.4794053863734007 0.35482912696897984 0.5666771996766329 0.4527092967182398 0.5699347071349621 0.7358296867460012 0.5444891396909952 0.11270620673894882] ]",
-  "[ 1/4 → 3/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.36975969187915325 0.18273563869297504 0.012781793251633644 0.5423613861203194 0.12467948533594608 0.7188410349190235 0.856887087225914 0.8818203993141651 0.8917219173163176 0.110306391492486 0.07148400321602821 0.8493648078292608 0.9100127145648003 0.4820226952433586 0.037094997242093086 0.9857278112322092 0.23439379036426544 0.46701666340231895 0.15832693874835968 0.6921216659247875] ]",
-  "[ 3/8 → 1/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.40139251574873924 0.15799915604293346 0.9604704882949591 0.03873417526483536 0.4157217647880316 0.27756719291210175 0.8800551909953356 0.5692523363977671 0.11026228219270706 0.7190891150385141 0.404962956905365 0.50828124769032 0.9681975357234478 0.34809120930731297 0.9345223866403103 0.9851128943264484 0.11768617853522301 0.538263589143753 0.6650313660502434 0.02540053054690361] ]",
-  "[ 1/2 → 5/8 | s:saw note:C#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.2604806162416935 0.3654713351279497 0.9900747090578079 0.22572625242173672 0.9328999016433954 0.5273839123547077 0.7047769222408533 0.7311522178351879 0.42673745937645435 0.7099553178995848 0.5597201306372881 0.8968746215105057 0.15695763938128948 0.3792166206985712 0.4147114269435406 0.38739512488245964 0.7585489805787802 0.3875726908445358 0.867314238101244 0.1866922564804554] ]",
-  "[ 5/8 → 3/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.1356358677148819 0.5403102282434702 0.07321739941835403 0.9646544624119997 0.7707359045743942 0.46888123638927937 0.9489036612212658 0.366748945787549 0.5029341224581003 0.7194344792515039 0.282692551612854 0.7303404528647661 0.7155798356980085 0.637981578707695 0.39654020965099335 0.008769871667027473 0.5857728160917759 0.3513293471187353 0.43080931156873703 0.518209295347333] ]",
-  "[ 3/4 → 7/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.19582648016512394 0.0024610888212919235 0.08272589556872845 0.09592138417065144 0.9678201265633106 0.3249557167291641 0.9463537875562906 0.20766610652208328 0.19126702845096588 0.4482936095446348 0.23314787074923515 0.07724925130605698 0.8329483829438686 0.39804019033908844 0.2529231123626232 0.889951054006815 0.716364661231637 0.3905949704349041 0.990752438083291 0.275751456618309] ]",
-  "[ 7/8 → 1/1 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.3976310808211565 0.13476407527923584 0.963376859202981 0.6579397786408663 0.5203975513577461 0.865439185872674 0.5583905670791864 0.2736878804862499 0.17021040990948677 0.3456706069409847 0.5848060417920351 0.9889458417892456 0.9307208992540836 0.7148868907243013 0.7419579364359379 0.8103639334440231 0.3331365995109081 0.19130694679915905 0.03261224366724491 0.808204049244523] ]",
-  "[ 1/1 → 9/8 | s:saw note:F#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.5195421651005745 0.9349692352116108 0.1718774326145649 0.9601866770535707 0.2802200373262167 0.8732441551983356 0.01810968853533268 0.42737805284559727 0.26281314715743065 0.7521175239235163 0.568607984110713 0.5046361442655325 0.03172125294804573 0.3706745784729719 0.9402780849486589 0.3995086643844843 0.35769628174602985 0.023460431024432182 0.043030962347984314 0.6526827793568373] ]",
-  "[ 9/8 → 5/4 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6724895145744085 0.21410975232720375 0.5229047331959009 0.20957534946501255 0.7402758821845055 0.2681974694132805 0.4059371296316385 0.9422509074211121 0.6584139950573444 0.26589646376669407 0.16059227287769318 0.17166719026863575 0.6234225388616323 0.020276052877306938 0.4836352560669184 0.8991366866976023 0.1860280428081751 0.06238717399537563 0.4383583478629589 0.4902789145708084] ]",
-  "[ 5/4 → 11/8 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.7287282031029463 0.9341024849563837 0.5098182689398527 0.5608645845204592 0.6812942810356617 0.5015129633247852 0.4602120481431484 0.927369873970747 0.19313151575624943 0.5240397155284882 0.444337897002697 0.19362097792327404 0.7068767864257097 0.920799495652318 0.2648108974099159 0.9700228478759527 0.20331068895757198 0.38390261493623257 0.0038731005042791367 0.9156702514737844] ]",
-  "[ 11/8 → 3/2 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.18280375190079212 0.40527783520519733 0.30504362285137177 0.7622128054499626 0.842598931863904 0.053796686232089996 0.5124214049428701 0.9178454764187336 0.09979427233338356 0.8280061967670918 0.5572535842657089 0.0622002687305212 0.9205668028444052 0.7738517206162214 0.04644870012998581 0.2117986585944891 0.26436166651546955 0.26421429589390755 0.4649084359407425 0.10490566119551659] ]",
-  "[ 3/2 → 13/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6084080748260021 0.4424846563488245 0.755185678601265 0.04328125901520252 0.04244415462017059 0.3994515985250473 0.787989066913724 0.3180440980941057 0.30072982981801033 0.24217353947460651 0.7830625418573618 0.7733921892940998 0.7720277719199657 0.4402343425899744 0.21046430803835392 0.38635879568755627 0.5671729445457458 0.9510521050542593 0.010756833478808403 0.5728995501995087] ]",
-  "[ 13/8 → 7/4 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.49675471149384975 0.2965749856084585 0.09848833456635475 0.19172007404267788 0.22677889838814735 0.9841996673494577 0.11156083643436432 0.6079028844833374 0.9412728808820248 0.9376902114599943 0.3611182738095522 0.5901201106607914 0.26860327646136284 0.9782364591956139 0.18694544956088066 0.004641396924853325 0.42020696587860584 0.06209231913089752 0.4790260009467602 0.21088780276477337] ]",
-  "[ 7/4 → 15/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.20473789609968662 0.7480021081864834 0.30757393687963486 0.5827204789966345 0.22094514779746532 0.6370698790997267 0.16573002003133297 0.0638319905847311 0.12625465169548988 0.4565841108560562 0.46095744147896767 0.646710304543376 0.045173922553658485 0.4833248760551214 0.1326297614723444 0.5275116711854935 0.9871038906276226 0.424171743914485 0.761672617867589 0.08582597225904465] ]",
-  "[ 15/8 → 2/1 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.5945571791380644 0.3962489552795887 0.563431927934289 0.4742323160171509 0.4185752831399441 0.9703940469771624 0.5282467231154442 0.6896266285330057 0.6941124945878983 0.2423656489700079 0.225077323615551 0.5445358455181122 0.014737963676452637 0.2848400343209505 0.14955217391252518 0.9782383926212788 0.6327074971050024 0.23327310755848885 0.4324392694979906 0.4326172359287739] ]",
-  "[ 2/1 → 17/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9595271199941635 0.5427457969635725 0.45864437520504 0.8057199101895094 0.18388565629720688 0.17221237532794476 0.8838487900793552 0.4976818822324276 0.7543560564517975 0.34416236728429794 0.8638174068182707 0.5697487238794565 0.005243342369794846 0.6361143626272678 0.6039986703544855 0.38708674535155296 0.5463927835226059 0.5717255529016256 0.15141930803656578 0.22688637301325798] ]",
-  "[ 17/8 → 9/4 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9033902939409018 0.22919894196093082 0.8388008493930101 0.9108077362179756 0.32246968522667885 0.16122018359601498 0.31932324543595314 0.18524732999503613 0.19110161997377872 0.5346284378319979 0.38531880639493465 0.7401201985776424 0.07450124807655811 0.18417961709201336 0.5768439751118422 0.7161206863820553 0.5836263168603182 0.9591280855238438 0.7728104889392853 0.0006709620356559753] ]",
-  "[ 9/4 → 19/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.34548251144587994 0.30419893004000187 0.10205957666039467 0.9906709585338831 0.3156223688274622 0.3745057098567486 0.7668170686811209 0.9379972033202648 0.689277408644557 0.8690325897186995 0.36728161945939064 0.9668608456850052 0.7341883443295956 0.32575040124356747 0.8095720671117306 0.3182998225092888 0.38158727809786797 0.5534052699804306 0.5973556581884623 0.752589326351881] ]",
-  "[ 19/8 → 5/2 | s:saw note:C#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.8365066405385733 0.5369812995195389 0.2263860274106264 0.21759207546710968 0.2172116208821535 0.09454222768545151 0.8075542915612459 0.9017798062413931 0.46291174553334713 0.01372767798602581 0.3509599883109331 0.4871185813099146 0.3525365497916937 0.6883120182901621 0.19577431678771973 0.287217665463686 0.025726469233632088 0.11798650585114956 0.8464976660907269 0.981348654255271] ]",
-  "[ 5/2 → 21/8 | s:saw note:E4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.45861607417464256 0.6807645913213491 0.07009582966566086 0.1450389064848423 0.2579921595752239 0.612881500273943 0.5503941811621189 0.7027011960744858 0.681745121255517 0.24246043153107166 0.2981361001729965 0.02195165678858757 0.10680225491523743 0.9413154497742653 0.6108828671276569 0.9479686040431261 0.17599895782768726 0.6629563421010971 0.5875700414180756 0.05703482776880264] ]",
-  "[ 21/8 → 11/4 | s:saw note:A#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.16019348427653313 0.47758268006145954 0.9749126061797142 0.8025561925023794 0.3600110989063978 0.324309878051281 0.5655391272157431 0.13364790193736553 0.3045873437076807 0.3814875278621912 0.14350778982043266 0.6017840709537268 0.11792952008545399 0.7185723781585693 0.6789924055337906 0.43416675738990307 0.9378792773932219 0.48162082210183144 0.37555896304547787 0.4686833508312702] ]",
-  "[ 11/4 → 23/8 | s:saw note:G#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.6332327704876661 0.7342763151973486 0.16935866326093674 0.4754706546664238 0.528122790157795 0.21934260986745358 0.7476693484932184 0.2995396424084902 0.46688378043472767 0.9741295631974936 0.9878341723233461 0.9837898630648851 0.15651432052254677 0.2896903567016125 0.7395600061863661 0.3490046579390764 0.014511989429593086 0.6857758145779371 0.7405510656535625 0.4224672969430685] ]",
-  "[ 23/8 → 3/1 | s:saw note:G#3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.01625417172908783 0.28409438766539097 0.3075305689126253 0.40343056432902813 0.5556836389005184 0.6926821582019329 0.5635769125074148 0.017873913049697876 0.5601800158619881 0.28681862354278564 0.8022358678281307 0.13467839546501637 0.02351163513958454 0.1987263821065426 0.4515750799328089 0.0009761657565832138 0.11555273085832596 0.25053937546908855 0.29571316950023174 0.15751986764371395] ]",
-  "[ 3/1 → 25/8 | s:saw note:B3 partials:[1 0 0 0 0 0 0 0 0] phases:[0.21728911064565182 0.7605195846408606 0.11240843310952187 0.4372697602957487 0.15630115941166878 0.1653979979455471 0.5303416550159454 0.07218753732740879 0.47459222190082073 0.04051801189780235 0.8742353077977896 0.9356274232268333 0.6662059463560581 0.4364917427301407 0.4163493011146784 0.9820694588124752 0.09098831936717033 0.41974459774792194 0.05833998881280422 0.2601191997528076] ]",
-  "[ 25/8 → 13/4 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.34324387833476067 0.14098095521330833 0.012934491038322449 0.827436288818717 0.5283997394144535 0.8942463714629412 0.4924008697271347 0.9298017006367445 0.18076439201831818 0.5243716649711132 0.015810951590538025 0.7476964127272367 0.6734520178288221 0.3267945274710655 0.9760967157781124 0.9397075213491917 0.7225867230445147 0.938586825504899 0.9692913070321083 0.5398030783981085] ]",
-  "[ 13/4 → 27/8 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9923650715500116 0.7797339502722025 0.1992435697466135 0.9005183521658182 0.718992218375206 0.23745290748775005 0.28872333094477654 0.35448253713548183 0.6209003105759621 0.3761858306825161 0.019171399995684624 0.7563913837075233 0.1559751983731985 0.4236980527639389 0.08094430714845657 0.4560011047869921 0.5958948992192745 0.37061405926942825 0.18633292242884636 0.346891064196825] ]",
-  "[ 27/8 → 7/2 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.40869180113077164 0.4018078800290823 0.34696186147630215 0.9572948440909386 0.400035472586751 0.3531211093068123 0.7240961641073227 0.8125612027943134 0.3587487991899252 0.1545814611017704 0.8934940584003925 0.9094721674919128 0.2336172368377447 0.17333386465907097 0.227950319647789 0.12384821102023125 0.5896956156939268 0.3293947223573923 0.619540523737669 0.8746719229966402] ]",
-  "[ 7/2 → 29/8 | s:saw note:D#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.40994881466031075 0.6455810181796551 0.35704658553004265 0.2732649203389883 0.31587288342416286 0.23243548162281513 0.22569947130978107 0.17241661623120308 0.7624858524650335 0.02111036144196987 0.6966175157576799 0.32112877257168293 0.2512516509741545 0.08602019399404526 0.16260642930865288 0.2627844326198101 0.1954369619488716 0.16302869468927383 0.4046020060777664 0.0904023926705122] ]",
-  "[ 29/8 → 15/4 | s:saw note:D#5 partials:[1 0 0 0 0 0 0 0 0] phases:[0.9391485787928104 0.3380728308111429 0.7723016366362572 0.998674126341939 0.7193406894803047 0.6963680125772953 0.9260678570717573 0.7829763628542423 0.42278125509619713 0.913721015676856 0.38873230293393135 0.7281809840351343 0.952108234167099 0.649707704782486 0.9456792045384645 0.4331315904855728 0.63712502643466 0.9180345926433802 0.7379776351153851 0.7914005517959595] ]",
-  "[ 15/4 → 31/8 | s:saw note:B4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.8121673222631216 0.25548945367336273 0.5759696904569864 0.6668333616107702 0.9233786761760712 0.11143362522125244 0.9734930321574211 0.369325939565897 0.6248745918273926 0.719582824036479 0.24051696807146072 0.20336504466831684 0.6860735435038805 0.10649923048913479 0.8736641593277454 0.042930178344249725 0.09769343212246895 0.7966452036052942 0.5882443580776453 0.8942952174693346] ]",
-  "[ 31/8 → 4/1 | s:saw note:A#4 partials:[1 0 0 0 0 0 0 0 0] phases:[0.7361665386706591 0.7657648548483849 0.21474426984786987 0.8228576295077801 0.5647660344839096 0.08148551359772682 0.9714624118059874 0.13992334716022015 0.9609981551766396 0.6844500284641981 0.23610286228358746 0.5974335502833128 0.20678778178989887 0.5261937081813812 0.7417268306016922 0.9810918122529984 0.8138748407363892 0.9389897901564837 0.7420910261571407 0.48839940316975117] ]",
+  "[ 0/1 → 1/8 | s:saw note:G#1 partials:{partials:1} ]",
+  "[ 0/1 → 1/8 | s:saw note:G#1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 1/8 → 1/4 | s:saw note:A#2 partials:{partials:1} ]",
+  "[ 1/8 → 1/4 | s:saw note:A#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 1/4 → 3/8 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 1/4 → 3/8 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 3/8 → 1/2 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 3/8 → 1/2 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 1/2 → 5/8 | s:saw note:C#2 partials:{partials:1} ]",
+  "[ 1/2 → 5/8 | s:saw note:C#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 5/8 → 3/4 | s:saw note:A#1 partials:{partials:1} ]",
+  "[ 5/8 → 3/4 | s:saw note:A#1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 3/4 → 7/8 | s:saw note:B1 partials:{partials:1} ]",
+  "[ 3/4 → 7/8 | s:saw note:B1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 7/8 → 1/1 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 7/8 → 1/1 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 1/1 → 9/8 | s:saw note:F#2 partials:{partials:1} ]",
+  "[ 1/1 → 9/8 | s:saw note:F#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 9/8 → 5/4 | s:saw note:A#2 partials:{partials:1} ]",
+  "[ 9/8 → 5/4 | s:saw note:A#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 5/4 → 11/8 | s:saw note:A#2 partials:{partials:1} ]",
+  "[ 5/4 → 11/8 | s:saw note:A#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 11/8 → 3/2 | s:saw note:B1 partials:{partials:1} ]",
+  "[ 11/8 → 3/2 | s:saw note:B1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 3/2 → 13/8 | s:saw note:G#2 partials:{partials:1} ]",
+  "[ 3/2 → 13/8 | s:saw note:G#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 13/8 → 7/4 | s:saw note:E2 partials:{partials:1} ]",
+  "[ 13/8 → 7/4 | s:saw note:E2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 7/4 → 15/8 | s:saw note:B1 partials:{partials:1} ]",
+  "[ 7/4 → 15/8 | s:saw note:B1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 15/8 → 2/1 | s:saw note:G#2 partials:{partials:1} ]",
+  "[ 15/8 → 2/1 | s:saw note:G#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 2/1 → 17/8 | s:saw note:D#3 partials:{partials:1} ]",
+  "[ 2/1 → 17/8 | s:saw note:D#3 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 17/8 → 9/4 | s:saw note:C#3 partials:{partials:1} ]",
+  "[ 17/8 → 9/4 | s:saw note:C#3 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 9/4 → 19/8 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 9/4 → 19/8 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 19/8 → 5/2 | s:saw note:C#3 partials:{partials:1} ]",
+  "[ 19/8 → 5/2 | s:saw note:C#3 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 5/2 → 21/8 | s:saw note:E2 partials:{partials:1} ]",
+  "[ 5/2 → 21/8 | s:saw note:E2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 21/8 → 11/4 | s:saw note:A#1 partials:{partials:1} ]",
+  "[ 21/8 → 11/4 | s:saw note:A#1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 11/4 → 23/8 | s:saw note:G#2 partials:{partials:1} ]",
+  "[ 11/4 → 23/8 | s:saw note:G#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 23/8 → 3/1 | s:saw note:G#1 partials:{partials:1} ]",
+  "[ 23/8 → 3/1 | s:saw note:G#1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 3/1 → 25/8 | s:saw note:B1 partials:{partials:1} ]",
+  "[ 3/1 → 25/8 | s:saw note:B1 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 25/8 → 13/4 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 25/8 → 13/4 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 13/4 → 27/8 | s:saw note:D#3 partials:{partials:1} ]",
+  "[ 13/4 → 27/8 | s:saw note:D#3 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 27/8 → 7/2 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 27/8 → 7/2 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 7/2 → 29/8 | s:saw note:D#2 partials:{partials:1} ]",
+  "[ 7/2 → 29/8 | s:saw note:D#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 29/8 → 15/4 | s:saw note:D#3 partials:{partials:1} ]",
+  "[ 29/8 → 15/4 | s:saw note:D#3 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 15/4 → 31/8 | s:saw note:B2 partials:{partials:1} ]",
+  "[ 15/4 → 31/8 | s:saw note:B2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
+  "[ 31/8 → 4/1 | s:saw note:A#2 partials:{partials:1} ]",
+  "[ 31/8 → 4/1 | s:saw note:A#2 partials:{partials:1} phases:[0.5 0.5 0.5] ]",
 ]
 `;
 
diff --git a/website/src/pages/learn/synths.mdx b/website/src/pages/learn/synths.mdx
index 6fc5b6925..56b28c0e4 100644
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@@ -85,7 +85,7 @@ note("c2 <eb2 <g2 g1>>".fast(2))
 ._scope()`}
 />
 
-which acts as a spectral filter or
+which acts as a spectral filter. Or:
 
 <MiniRepl
   client:idle
@@ -129,11 +129,12 @@ These phases too can be declared in Strudel and can give your sounds interesting
 
 <MiniRepl
   client:idle
-  tune={`note("c2 <eb2 <g2 g1>>".fast(2))
-.sound("saw")
-.partials(randL(100))
-.phases(randL(100))
-._scope()`}
+  tune={`s("saw").seg(16).n(irand(12)).scale("F1:minor")
+  .penv(48).panchor(0).pdec(0.05)
+  .delay(0.25).room(0.25)
+  .compressor(-20).vib(0.3)
+  .partials(randL(200))
+  .phases(randL(200))`}
 />
 
 ## Vibrato

From 30cc46ea66a4cd3d9b5b7dca3ab6446fc76d6845 Mon Sep 17 00:00:00 2001
From: scrappy_fiddler <foo@bar.cc>
Date: Mon, 17 Nov 2025 20:04:40 +0100
Subject: [PATCH 019/110] wchooseCycles has now notes in an example

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

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 604d1c805..62fc26ad8 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -524,7 +524,7 @@ export const wchoose = (...pairs) => wchooseWith(rand, ...pairs);
  * @example
  * wchooseCycles(["bd",10], ["hh",1], ["sd",1]).s().fast(8)
  * @example
- * wchooseCycles(["bd bd bd",5], ["hh hh hh",3], ["sd sd sd",1]).fast(4).s()
+ * wchooseCycles(["c c c",5], ["a a a",3], ["f f f",1]).fast(4).note()
  * @example
  * // The probability can itself be a pattern
  * wchooseCycles(["bd(3,8)","<5 0>"], ["hh hh hh",3]).fast(4).s()

From 99beb4454deb9099a40f355ba4dc3898f341adbe Mon Sep 17 00:00:00 2001
From: scrappy_fiddler <foo@bar.cc>
Date: Mon, 17 Nov 2025 20:49:26 +0100
Subject: [PATCH 020/110] update snapshot with note example

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

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 32e61c31d..31e4bddd3 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -12484,54 +12484,54 @@ exports[`runs examples > example "wchooseCycles" example index 0 1`] = `
 
 exports[`runs examples > example "wchooseCycles" example index 1 1`] = `
 [
-  "[ 0/1 → 1/12 | s:bd ]",
-  "[ 1/12 → 1/6 | s:bd ]",
-  "[ 1/6 → 1/4 | s:bd ]",
-  "[ 1/4 → 1/3 | s:bd ]",
-  "[ 1/3 → 5/12 | s:bd ]",
-  "[ 5/12 → 1/2 | s:bd ]",
-  "[ 1/2 → 7/12 | s:sd ]",
-  "[ 7/12 → 2/3 | s:sd ]",
-  "[ 2/3 → 3/4 | s:sd ]",
-  "[ 3/4 → 5/6 | s:bd ]",
-  "[ 5/6 → 11/12 | s:bd ]",
-  "[ 11/12 → 1/1 | s:bd ]",
-  "[ 1/1 → 13/12 | s:bd ]",
-  "[ 13/12 → 7/6 | s:bd ]",
-  "[ 7/6 → 5/4 | s:bd ]",
-  "[ 5/4 → 4/3 | s:bd ]",
-  "[ 4/3 → 17/12 | s:bd ]",
-  "[ 17/12 → 3/2 | s:bd ]",
-  "[ 3/2 → 19/12 | s:hh ]",
-  "[ 19/12 → 5/3 | s:hh ]",
-  "[ 5/3 → 7/4 | s:hh ]",
-  "[ 7/4 → 11/6 | s:bd ]",
-  "[ 11/6 → 23/12 | s:bd ]",
-  "[ 23/12 → 2/1 | s:bd ]",
-  "[ 2/1 → 25/12 | s:hh ]",
-  "[ 25/12 → 13/6 | s:hh ]",
-  "[ 13/6 → 9/4 | s:hh ]",
-  "[ 9/4 → 7/3 | s:hh ]",
-  "[ 7/3 → 29/12 | s:hh ]",
-  "[ 29/12 → 5/2 | s:hh ]",
-  "[ 5/2 → 31/12 | s:bd ]",
-  "[ 31/12 → 8/3 | s:bd ]",
-  "[ 8/3 → 11/4 | s:bd ]",
-  "[ 11/4 → 17/6 | s:bd ]",
-  "[ 17/6 → 35/12 | s:bd ]",
-  "[ 35/12 → 3/1 | s:bd ]",
-  "[ 3/1 → 37/12 | s:bd ]",
-  "[ 37/12 → 19/6 | s:bd ]",
-  "[ 19/6 → 13/4 | s:bd ]",
-  "[ 13/4 → 10/3 | s:sd ]",
-  "[ 10/3 → 41/12 | s:sd ]",
-  "[ 41/12 → 7/2 | s:sd ]",
-  "[ 7/2 → 43/12 | s:hh ]",
-  "[ 43/12 → 11/3 | s:hh ]",
-  "[ 11/3 → 15/4 | s:hh ]",
-  "[ 15/4 → 23/6 | s:bd ]",
-  "[ 23/6 → 47/12 | s:bd ]",
-  "[ 47/12 → 4/1 | s:bd ]",
+  "[ 0/1 → 1/12 | note:c ]",
+  "[ 1/12 → 1/6 | note:c ]",
+  "[ 1/6 → 1/4 | note:c ]",
+  "[ 1/4 → 1/3 | note:c ]",
+  "[ 1/3 → 5/12 | note:c ]",
+  "[ 5/12 → 1/2 | note:c ]",
+  "[ 1/2 → 7/12 | note:f ]",
+  "[ 7/12 → 2/3 | note:f ]",
+  "[ 2/3 → 3/4 | note:f ]",
+  "[ 3/4 → 5/6 | note:c ]",
+  "[ 5/6 → 11/12 | note:c ]",
+  "[ 11/12 → 1/1 | note:c ]",
+  "[ 1/1 → 13/12 | note:c ]",
+  "[ 13/12 → 7/6 | note:c ]",
+  "[ 7/6 → 5/4 | note:c ]",
+  "[ 5/4 → 4/3 | note:c ]",
+  "[ 4/3 → 17/12 | note:c ]",
+  "[ 17/12 → 3/2 | note:c ]",
+  "[ 3/2 → 19/12 | note:a ]",
+  "[ 19/12 → 5/3 | note:a ]",
+  "[ 5/3 → 7/4 | note:a ]",
+  "[ 7/4 → 11/6 | note:c ]",
+  "[ 11/6 → 23/12 | note:c ]",
+  "[ 23/12 → 2/1 | note:c ]",
+  "[ 2/1 → 25/12 | note:a ]",
+  "[ 25/12 → 13/6 | note:a ]",
+  "[ 13/6 → 9/4 | note:a ]",
+  "[ 9/4 → 7/3 | note:a ]",
+  "[ 7/3 → 29/12 | note:a ]",
+  "[ 29/12 → 5/2 | note:a ]",
+  "[ 5/2 → 31/12 | note:c ]",
+  "[ 31/12 → 8/3 | note:c ]",
+  "[ 8/3 → 11/4 | note:c ]",
+  "[ 11/4 → 17/6 | note:c ]",
+  "[ 17/6 → 35/12 | note:c ]",
+  "[ 35/12 → 3/1 | note:c ]",
+  "[ 3/1 → 37/12 | note:c ]",
+  "[ 37/12 → 19/6 | note:c ]",
+  "[ 19/6 → 13/4 | note:c ]",
+  "[ 13/4 → 10/3 | note:f ]",
+  "[ 10/3 → 41/12 | note:f ]",
+  "[ 41/12 → 7/2 | note:f ]",
+  "[ 7/2 → 43/12 | note:a ]",
+  "[ 43/12 → 11/3 | note:a ]",
+  "[ 11/3 → 15/4 | note:a ]",
+  "[ 15/4 → 23/6 | note:c ]",
+  "[ 23/6 → 47/12 | note:c ]",
+  "[ 47/12 → 4/1 | note:c ]",
 ]
 `;
 

From 654c1a86f08550586049fcef4a6b4c9ac5007755 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 18 Nov 2025 16:02:33 -0600
Subject: [PATCH 021/110] Simplify declarations via globalThis; fix
 cleanup/stop

---
 packages/core/controls.mjs      | 106 +++++---------------------------
 packages/superdough/helpers.mjs |  46 +++++++++-----
 2 files changed, 44 insertions(+), 108 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 02178de97..854f48ffb 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -468,7 +468,8 @@ export const { attack, att } = registerControl('attack', 'att');
  * ._scope()
  *
  */
-export const { fmh, fmh1, fmh2, fmh3, fmh4, fmh5, fmh6, fmh7, fmh8 } = registerMultiControl(['fmh', 'fmi'], 8, 'fmh');
+Object.assign(globalThis, registerMultiControl(['fmh', 'fmi'], 8, 'fmh'));
+
 /**
  * Sets the Frequency Modulation of the synth.
  * Controls the modulation index, which defines the brightness of the sound.
@@ -491,8 +492,8 @@ export const { fmh, fmh1, fmh2, fmh3, fmh4, fmh5, fmh6, fmh7, fmh8 } = registerM
  *  .fmh(1.06).fmh2(10).fmh3(0.1)
  *
  */
-export const { fmi, fmi1, fmi2, fmi3, fmi4, fmi5, fmi6, fmi7, fmi8, fm, fm1, fm2, fm3, fm4, fm5, fm6, fm7, fm8 } =
-  registerMultiControl(['fmi', 'fmh'], 8, 'fm');
+Object.assign(globalThis, registerMultiControl(['fmi', 'fmh'], 8, 'fm'));
+
 // fm envelope
 /**
  * Ramp type of fm envelope. Exp might be a bit broken..
@@ -511,10 +512,8 @@ export const { fmi, fmi1, fmi2, fmi3, fmi4, fmi5, fmi6, fmi7, fmi8, fm, fm1, fm2
  * ._scope()
  *
  */
-export const { fmenv, fmenv1, fmenv2, fmenv3, fmenv4, fmenv5, fmenv6, fmenv7, fmenv8 } = registerMultiControl(
-  'fmenv',
-  8,
-);
+Object.assign(globalThis, registerMultiControl('fmenv', 8));
+
 /**
  * Attack time for the FM envelope: time it takes to reach maximum modulation
  *
@@ -531,26 +530,7 @@ export const { fmenv, fmenv1, fmenv2, fmenv3, fmenv4, fmenv5, fmenv6, fmenv7, fm
  * ._scope()
  *
  */
-export const {
-  fmattack,
-  fmattack1,
-  fmattack2,
-  fmattack3,
-  fmattack4,
-  fmattack5,
-  fmattack6,
-  fmattack7,
-  fmattack8,
-  fmatt,
-  fmatt1,
-  fmatt2,
-  fmatt3,
-  fmatt4,
-  fmatt5,
-  fmatt6,
-  fmatt7,
-  fmatt8,
-} = registerMultiControl('fmattack', 8, 'fmatt');
+Object.assign(globalThis, registerMultiControl('fmattack', 8, 'fmatt'));
 
 /**
  * Waveform of the fm modulator
@@ -566,10 +546,7 @@ export const {
  * n("0 1 2 3".fast(4)).chord("<Dm Am F G>").voicing().s("sawtooth").fmwave("brown").fm(.6)
  *
  */
-export const { fmwave, fmwave1, fmwave2, fmwave3, fmwave4, fmwave5, fmwave6, fmwave7, fmwave8 } = registerMultiControl(
-  'fmwave',
-  8,
-);
+Object.assign(globalThis, registerMultiControl('fmwave', 8));
 
 /**
  * Decay time for the FM envelope: seconds until the sustain level is reached after the attack phase.
@@ -588,26 +565,8 @@ export const { fmwave, fmwave1, fmwave2, fmwave3, fmwave4, fmwave5, fmwave6, fmw
  * ._scope()
  *
  */
-export const {
-  fmdecay,
-  fmdecay1,
-  fmdecay2,
-  fmdecay3,
-  fmdecay4,
-  fmdecay5,
-  fmdecay6,
-  fmdecay7,
-  fmdecay8,
-  fmdec,
-  fmdec1,
-  fmdec2,
-  fmdec3,
-  fmdec4,
-  fmdec5,
-  fmdec6,
-  fmdec7,
-  fmdec8,
-} = registerMultiControl('fmdecay', 8, 'fmdec');
+Object.assign(globalThis, registerMultiControl('fmdecay', 8, 'fmdec'));
+
 /**
  * Sustain level for the FM envelope: how much modulation is applied after the decay phase
  *
@@ -625,26 +584,8 @@ export const {
  * ._scope()
  *
  */
-export const {
-  fmsustain,
-  fmsustain1,
-  fmsustain2,
-  fmsustain3,
-  fmsustain4,
-  fmsustain5,
-  fmsustain6,
-  fmsustain7,
-  fmsustain8,
-  fmsus,
-  fmsus1,
-  fmsus2,
-  fmsus3,
-  fmsus4,
-  fmsus5,
-  fmsus6,
-  fmsus7,
-  fmsus8,
-} = registerMultiControl('fmsustain', 8, 'fmsus');
+Object.assign(globalThis, registerMultiControl('fmsustain', 8, 'fmsus'));
+
 /**
  * Release time for the FM envelope: how much modulation is applied after the note is released
  *
@@ -656,31 +597,12 @@ export const {
  * @param {number | Pattern} time release time
  *
  */
-export const {
-  fmrelease,
-  fmrelease1,
-  fmrelease2,
-  fmrelease3,
-  fmrelease4,
-  fmrelease5,
-  fmrelease6,
-  fmrelease7,
-  fmrelease8,
-  fmrel,
-  fmrel1,
-  fmrel2,
-  fmrel3,
-  fmrel4,
-  fmrel5,
-  fmrel6,
-  fmrel7,
-  fmrel8,
-} = registerMultiControl('fmrelease', 8, 'fmrel');
+Object.assign(globalThis, registerMultiControl('fmrelease', 8, 'fmrel'));
 
 // FM Matrix
 for (let i = 0; i <= 8; i++) {
   for (let j = 0; j <= 8; j++) {
-    registerControl(`fmi${i}${j}`, `fm${i}${j}`);
+    Object.assign(globalThis, registerControl(`fmi${i}${j}`, `fm${i}${j}`));
   }
 }
 
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index b856a0d88..0ab43791d 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -336,6 +336,7 @@ export function webAudioTimeout(audioContext, onComplete, startTime, stopTime) {
   constantNode.stop(stopTime);
   return constantNode;
 }
+
 const mod = (freq, type = 'sine') => {
   const ctx = getAudioContext();
   let osc;
@@ -349,10 +350,10 @@ const mod = (freq, type = 'sine') => {
     osc.frequency.value = freq;
   }
   osc.start();
-  return { osc, stop: (t) => osc.stop(t), freq };
+  return { osc, freq };
 };
 
-const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
+const fm = (frequencyparam, harmonicityRatio, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
   const modfreq = carrfreq * harmonicityRatio;
   return mod(modfreq, wave);
@@ -360,7 +361,7 @@ const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') =>
 
 export function applyFM(param, value, begin) {
   const ac = getAudioContext();
-  let stop = (t) => {};
+  const toStop = []; // fm oscillators we will expose `stop` for
   const fms = {};
   // Matrix
   for (let i = 1; i <= 8; i++) {
@@ -377,8 +378,8 @@ export function applyFM(param, value, begin) {
       if (!amt) continue;
       let io = [];
       for (let [isMod, idx] of [
-        [true, i],
-        [false, j],
+        [true, i], // source
+        [false, j], // target
       ]) {
         if (idx === 0) {
           io.push(param);
@@ -387,15 +388,11 @@ export function applyFM(param, value, begin) {
         if (!fms[idx]) {
           const idxS = idx === 1 ? '' : idx;
           const { osc, freq } = fm(param, value[`fmh${idxS}`] ?? 1, value[`fmwave${idxS}`] ?? 'sine');
-          const currStop = stop;
-          stop = (t) => {
-            currStop(t);
-            osc.stop(t);
-          };
+          toStop.push(osc);
+          const toCleanup = [osc]; // nodes we want to cleanup after oscillator `stop`
           const adsr = ['attack', 'decay', 'sustain', 'release'].map((s) => value[`fm${s}${idxS}`]);
-          if (!adsr.some((v) => v !== undefined)) {
-            fms[idx] = { input: osc.frequency, output: osc, freq };
-          } else {
+          let output = osc;
+          if (adsr.some((v) => v !== undefined)) {
             const envGain = ac.createGain();
             const [attack, decay, sustain, release] = getADSRValues(adsr);
             const holdEnd = begin + value.duration;
@@ -412,12 +409,16 @@ export function applyFM(param, value, begin) {
               holdEnd,
               fmEnvelopeType === 'exp' ? 'exponential' : 'linear',
             );
-            fms[idx] = { input: osc.frequency, output: osc.connect(envGain), freq };
+            toCleanup.push(envGain);
+            output = osc.connect(envGain);
           }
+          fms[idx] = { input: osc.frequency, output, freq, toCleanup };
+          osc.onended = () => cleanupNodes(fms[idx].toCleanup);
         }
-        const { input, output, freq } = fms[idx];
+        const { input, output, freq, toCleanup } = fms[idx];
         const g = gainNode(amt * freq);
         io.push(isMod ? output.connect(g) : input);
+        toCleanup.push(g);
       }
       if (!io[1]) {
         logger(
@@ -429,7 +430,9 @@ export function applyFM(param, value, begin) {
       io[0].connect(io[1]);
     }
   }
-  return { stop };
+  return {
+    stop: (t) => toStop.forEach((m) => m?.stop(t)),
+  };
 }
 
 // Saturation curves
@@ -549,3 +552,14 @@ export const destroyAudioWorkletNode = (node) => {
   node.disconnect();
   node.parameters.get('end')?.setValueAtTime(0, 0);
 };
+
+export const cleanupNode = (node, time) => {
+  if (node == null) return;
+  node.disconnect?.();
+  node.parameters?.get('end')?.setValueAtTime(0, 0);
+  node.stop?.(time);
+};
+
+export const cleanupNodes = (nodes, time) => {
+  nodes.forEach((n) => cleanupNode(n, time));
+};

From dd2c808cd71a7f5892f7e57c0f0a6fe7540d332c Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 19 Nov 2025 21:55:35 +0100
Subject: [PATCH 022/110] hotfix: reduce sounds-tab click to play latency

---
 website/src/repl/components/panel/SoundsTab.jsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/src/repl/components/panel/SoundsTab.jsx b/website/src/repl/components/panel/SoundsTab.jsx
index a9f10bf12..3d363f8a1 100644
--- a/website/src/repl/components/panel/SoundsTab.jsx
+++ b/website/src/repl/components/panel/SoundsTab.jsx
@@ -126,7 +126,7 @@ export function SoundsTab() {
                 try {
                   // Pre-load the sample by calling onTrigger with a future time
                   // This triggers the loading but schedules playback for later
-                  const time = ctx.currentTime + 0.5; // Give 500ms for loading
+                  const time = ctx.currentTime + 0.05;
                   const ref = await onTrigger(time, params, onended);
                   trigRef.current = ref;
                   if (ref?.node) {

From 8144ec46bd7eeaf1d0cfbbe5c59a54a347941aeb Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 19 Nov 2025 18:35:35 -0600
Subject: [PATCH 023/110] Attempt system for sounds tab previews

---
 packages/superdough/superdough.mjs            |  4 +-
 .../src/repl/components/panel/SoundsTab.jsx   | 37 +++++++++++++------
 2 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 65c444120..73fece4f5 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -263,8 +263,8 @@ let audioReady;
 export async function initAudioOnFirstClick(options) {
   if (!audioReady) {
     audioReady = new Promise((resolve) => {
-      document.addEventListener('click', async function listener() {
-        document.removeEventListener('click', listener);
+      document.addEventListener('mousedown', async function listener() {
+        document.removeEventListener('mousedown', listener);
         await initAudio(options);
         resolve();
       });
diff --git a/website/src/repl/components/panel/SoundsTab.jsx b/website/src/repl/components/panel/SoundsTab.jsx
index a9f10bf12..311f593e1 100644
--- a/website/src/repl/components/panel/SoundsTab.jsx
+++ b/website/src/repl/components/panel/SoundsTab.jsx
@@ -14,6 +14,10 @@ import { prebake } from '@src/repl/prebake.mjs';
 const getSamples = (samples) =>
   Array.isArray(samples) ? samples.length : typeof samples === 'object' ? Object.values(samples).length : 1;
 
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 export function SoundsTab() {
   const sounds = useStore(soundMap);
 
@@ -121,19 +125,30 @@ export function SoundsTab() {
                   sustain: 1,
                   duration: 0.5,
                 };
-                soundPreviewIdx++;
                 const onended = () => trigRef.current?.node?.disconnect();
-                try {
-                  // Pre-load the sample by calling onTrigger with a future time
-                  // This triggers the loading but schedules playback for later
-                  const time = ctx.currentTime + 0.5; // Give 500ms for loading
-                  const ref = await onTrigger(time, params, onended);
-                  trigRef.current = ref;
-                  if (ref?.node) {
-                    connectToDestination(ref.node);
+                // Attempt to play the sample and retry every 200ms until 10 attempts have been reached
+                let errMsg;
+                for (let attempt = 0; attempt < 10; attempt++) {
+                  try {
+                    // Pre-load the sample by calling onTrigger with a future time
+                    // This triggers the loading but schedules playback for later
+                    const time = ctx.currentTime + 0.05; // Give 50ms for loading
+                    const ref = await onTrigger(time, params, onended);
+                    trigRef.current = ref;
+                    if (ref?.node) {
+                      connectToDestination(ref.node);
+                      soundPreviewIdx++;
+                      break;
+                    }
+                  } catch (err) {
+                    console.log(err);
+                    errMsg = err;
+                  }
+                  if (attempt == 9) {
+                    console.warn('Failed to trigger sound after 10 attempts' + (errMsg ? `: ${errMsg}` : ''));
+                  } else {
+                    await wait(200);
                   }
-                } catch (err) {
-                  console.warn('Failed to trigger sound:', err);
                 }
               }}
             >

From 74488f8480d28606c192379f9df8695cfd962977 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 19 Nov 2025 18:41:56 -0600
Subject: [PATCH 024/110] Stray log message

---
 website/src/repl/components/panel/SoundsTab.jsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/website/src/repl/components/panel/SoundsTab.jsx b/website/src/repl/components/panel/SoundsTab.jsx
index 311f593e1..61d4ba1ce 100644
--- a/website/src/repl/components/panel/SoundsTab.jsx
+++ b/website/src/repl/components/panel/SoundsTab.jsx
@@ -141,7 +141,6 @@ export function SoundsTab() {
                       break;
                     }
                   } catch (err) {
-                    console.log(err);
                     errMsg = err;
                   }
                   if (attempt == 9) {

From 8ed72b4573503890d04fffafee50e1f28cca9990 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 20 Nov 2025 13:05:41 +0000
Subject: [PATCH 025/110] [perf] fix `connect-leak` in `delay` effect

---
 packages/superdough/superdough.mjs       | 3 ++-
 packages/superdough/superdoughoutput.mjs | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 65c444120..c548e7396 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -692,7 +692,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   // delay
   if (delay > 0 && delaytime > 0 && delayfeedback > 0) {
     orbitBus.getDelay(delaytime, delayfeedback, t);
-    orbitBus.sendDelay(post, delay);
+    const send = orbitBus.sendDelay(post, delay);
+    audioNodes.push(send)
   }
   // reverb
   if (room > 0) {
diff --git a/packages/superdough/superdoughoutput.mjs b/packages/superdough/superdoughoutput.mjs
index a4235efd0..d8ead7d06 100644
--- a/packages/superdough/superdoughoutput.mjs
+++ b/packages/superdough/superdoughoutput.mjs
@@ -82,7 +82,7 @@ export class Orbit {
   }
 
   sendDelay(node, amount) {
-    effectSend(node, this.delayNode, amount);
+    return effectSend(node, this.delayNode, amount);
   }
 
   duck(t, onsettime = 0, attacktime = 0.1, depth = 1) {

From d9f63b8dfa28112192ed5b6a2d2cfe7cb41cc41d Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Sun, 16 Nov 2025 09:23:11 +0000
Subject: [PATCH 026/110] [perf] fix `connect leak` when .noise() is in the mix

---
 packages/superdough/helpers.mjs | 14 +++++++++++++-
 packages/superdough/noise.mjs   |  3 ++-
 packages/superdough/synth.mjs   | 23 +++++++++++++----------
 3 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 47161ed61..de64df0e8 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -262,7 +262,15 @@ export function drywet(dry, wet, wetAmount = 0) {
   let mix = ac.createGain();
   dry_gain.connect(mix);
   wet_gain.connect(mix);
-  return mix;
+  return {
+    node: mix,
+    onended: () => {
+      dry_gain.disconnect(mix);
+      wet_gain.disconnect(mix);
+      dry.disconnect(dry_gain);
+      wet.disconnect(wet_gain);
+    },
+  };
 }
 
 let curves = ['linear', 'exponential'];
@@ -297,6 +305,10 @@ export function getVibratoOscillator(param, value, t) {
     gain.gain.value = vibmod * 100;
     vibratoOscillator.connect(gain);
     gain.connect(param);
+    vibratoOscillator.onended = () => {
+      gain.disconnect(param);
+      vibratoOscillator.disconnect(gain);
+    };
     vibratoOscillator.start(t);
     return vibratoOscillator;
   }
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 816dd252b..3e41515df 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -65,8 +65,9 @@ export function getNoiseOscillator(type = 'white', t, density = 0.02) {
 export function getNoiseMix(inputNode, wet, t) {
   const noiseOscillator = getNoiseOscillator('pink', t);
   const noiseMix = drywet(inputNode, noiseOscillator.node, wet);
+  noiseOscillator.node.onended = () => noiseMix.onended();
   return {
-    node: noiseMix,
+    node: noiseMix.node,
     stop: (time) => noiseOscillator?.stop(time),
   };
 }
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 10df1776b..2dc9e2be8 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -48,19 +48,17 @@ export function registerSynthSounds() {
           [0.001, 0.05, 0.6, 0.01],
         );
 
-        let sound = getOscillator(s, t, value);
-        let { node: o, stop, triggerRelease } = sound;
-
         // turn down
         const g = gainNode(0.3);
 
-        const { duration } = value;
-
-        o.onended = () => {
-          o.disconnect();
+        let sound = getOscillator(s, t, value, () => {
           g.disconnect();
           onended();
-        };
+        });
+
+        let { node: o, stop, triggerRelease } = sound;
+
+        const { duration } = value;
 
         const envGain = gainNode(1);
         let node = o.connect(g).connect(envGain);
@@ -460,7 +458,7 @@ export function waveformN(partials, phases, type) {
 }
 
 // expects one of waveforms as s
-export function getOscillator(s, t, value) {
+export function getOscillator(s, t, value, onended) {
   const { duration, noise = 0 } = value;
   const partials = value.partials ?? value.n;
   let o;
@@ -482,7 +480,6 @@ export function getOscillator(s, t, value) {
   }
   // set frequency
   o.frequency.value = getFrequencyFromValue(value);
-  o.start(t);
 
   let vibratoOscillator = getVibratoOscillator(o.detune, value, t);
 
@@ -495,6 +492,12 @@ export function getOscillator(s, t, value) {
     noiseMix = getNoiseMix(o, noise, t);
   }
 
+  o.onended = () => {
+    noiseMix?.node.disconnect();
+    onended();
+  };
+  o.start(t);
+
   return {
     node: noiseMix?.node || o,
     stop: (time) => {

From 7267990e20ed07c86b95a5c17985461e4f77f8d6 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 20 Nov 2025 13:35:37 +0000
Subject: [PATCH 027/110] Fix codeformat

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index c548e7396..650f9c2ce 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -693,7 +693,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   if (delay > 0 && delaytime > 0 && delayfeedback > 0) {
     orbitBus.getDelay(delaytime, delayfeedback, t);
     const send = orbitBus.sendDelay(post, delay);
-    audioNodes.push(send)
+    audioNodes.push(send);
   }
   // reverb
   if (room > 0) {

From 0435711051ee5d890f15a11b8c2fdd0def231996 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 20 Nov 2025 17:36:00 +0000
Subject: [PATCH 028/110] [perf] fix `connect-leak` added by #1742 when noise()
 is not used

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

diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 2dc9e2be8..768638f04 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -493,6 +493,7 @@ export function getOscillator(s, t, value, onended) {
   }
 
   o.onended = () => {
+    o.disconnect();
     noiseMix?.node.disconnect();
     onended();
   };

From 907f03f3bfe35bc4b6695490030e6f4822747629 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 20 Nov 2025 17:40:51 +0000
Subject: [PATCH 029/110] [perf] fix `connect-leak` in fm modulation

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

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index de64df0e8..58c4aa35e 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -362,9 +362,9 @@ const mod = (freq, range = 1, type = 'sine') => {
   }
 
   osc.start();
-  const g = new GainNode(ctx, { gain: range });
+  const g = gainNode(range);
   osc.connect(g); // -range, range
-  return { node: g, stop: (t) => osc.stop(t) };
+  return { node: g, stop: (t) => osc.stop(t), osc: osc };
 };
 const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
@@ -416,6 +416,11 @@ export function applyFM(param, value, begin) {
       modulator.connect(envGain);
       envGain.connect(param);
     }
+    fmmod.osc.onended = () => {
+      envGain.disconnect();
+      modulator.disconnect();
+      fmmod.osc.disconnect();
+    };
   }
   return { stop };
 }

From 4758effdc6386fc6e1e38aeb0445db33a264b126 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Thu, 20 Nov 2025 18:22:44 -0600
Subject: [PATCH 030/110] Use frac due to negative frequencies from FM

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

diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 359bc833a..32367b64c 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -532,7 +532,7 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
         const freqVoice = applySemitoneDetuneToFrequency(freq, detuner(n));
         // We must wrap this here because it is passed into sawblep below which
         // has domain [0, 1]
-        const dt = ffrac(freqVoice * INVSR);
+        const dt = frac(freqVoice * INVSR);
         this.phase[n] = this.phase[n] ?? Math.random();
         const v = waveshapes.sawblep(this.phase[n], dt);
 

From 21543956c6b26f3ae96dcf43f80f377e1a51e755 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Thu, 20 Nov 2025 18:26:12 -0600
Subject: [PATCH 031/110] Also for wavetable

---
 packages/superdough/worklets.mjs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 32367b64c..e60cd223e 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -1338,7 +1338,7 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
       const tablePos = clamp(pv(parameters.position, i), 0, 1);
       const idx = tablePos * (this.numFrames - 1);
       const fIdx = idx | 0;
-      const frac = idx - fIdx;
+      const interpT = idx - fIdx;
       const warpAmount = clamp(pv(parameters.warp, i), 0, 1);
       const warpMode = pv(parameters.warpMode, i);
       const phaseRand = clamp(pv(parameters.phaserand, i), 0, 1);
@@ -1368,13 +1368,13 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
         const ph = this._warpPhase(this.phase[n], warpAmount, warpMode);
         const s0 = this._sampleFrame(table[fIdx], ph);
         const s1 = this._sampleFrame(table[Math.min(this.numFrames - 1, fIdx + 1)], ph);
-        let s = s0 + (s1 - s0) * frac;
+        let s = lerp(s0, s1, interpT);
         if (warpMode === WarpMode.FLIP && this.phase[n] < warpAmount) {
           s = -s;
         }
         outL[i] += s * gainL * normalizer;
         outR[i] += s * gainR * normalizer;
-        this.phase[n] = ffrac(this.phase[n] + dPhase);
+        this.phase[n] = frac(this.phase[n] + dPhase);
       }
     }
     return true;

From f637b8b0dd0c3bbe29c53d128a943b9e6260be9b Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 20 Nov 2025 17:40:51 +0000
Subject: [PATCH 032/110] [perf] fix `connect-leak` in fm modulation

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

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index de64df0e8..58c4aa35e 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -362,9 +362,9 @@ const mod = (freq, range = 1, type = 'sine') => {
   }
 
   osc.start();
-  const g = new GainNode(ctx, { gain: range });
+  const g = gainNode(range);
   osc.connect(g); // -range, range
-  return { node: g, stop: (t) => osc.stop(t) };
+  return { node: g, stop: (t) => osc.stop(t), osc: osc };
 };
 const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
@@ -416,6 +416,11 @@ export function applyFM(param, value, begin) {
       modulator.connect(envGain);
       envGain.connect(param);
     }
+    fmmod.osc.onended = () => {
+      envGain.disconnect();
+      modulator.disconnect();
+      fmmod.osc.disconnect();
+    };
   }
   return { stop };
 }

From e72e26eb81a62bcb9a96dedfa05fb82fac857cca Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sat, 22 Nov 2025 17:11:17 -0500
Subject: [PATCH 033/110] add comment

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

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 6e3d97c92..bcb70eec9 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -217,6 +217,7 @@ export function repl({
         let patterns = [];
         let soloActive = false;
         for (const [key, value] of Object.entries(pPatterns)) {
+          // handle soloed patterns ex: S$: s("bd!4")
           const isSolod = key.length > 1 && key.startsWith('S');
           if (isSolod && soloActive === false) {
             // first time we see a soloed pattern, clear existing patterns

From 19fd0fc649ba8b92271facd3ae9e9e5ac01ebd2c Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sat, 22 Nov 2025 17:17:41 -0500
Subject: [PATCH 034/110] rm unessecary file

---
 packages/draw/text.mjs | 144 -----------------------------------------
 1 file changed, 144 deletions(-)
 delete mode 100644 packages/draw/text.mjs

diff --git a/packages/draw/text.mjs b/packages/draw/text.mjs
deleted file mode 100644
index ba76df079..000000000
--- a/packages/draw/text.mjs
+++ /dev/null
@@ -1,144 +0,0 @@
-import { Pattern, midiToFreq, getFrequency } from '@strudel/core';
-import { getTheme, getDrawContext } from './draw.mjs';
-
-const c = midiToFreq(36);
-
-const circlePos = (cx, cy, radius, angle) => {
-  angle = angle * Math.PI * 2;
-  const x = Math.sin(angle) * radius + cx;
-  const y = Math.cos(angle) * radius + cy;
-  return [x, y];
-};
-
-const freq2angle = (freq, root) => {
-  return 0.5 - (Math.log2(freq / root) % 1);
-};
-
-export function pitchwheel({
-  haps,
-  ctx,
-  id,
-  hapcircles = 1,
-  circle = 0,
-  edo = 12,
-  root = c,
-  thickness = 3,
-  hapRadius = 6,
-  mode = 'flake',
-  margin = 10,
-} = {}) {
-  const connectdots = mode === 'polygon';
-  const centerlines = mode === 'flake';
-  const w = ctx.canvas.width;
-  const h = ctx.canvas.height;
-  ctx.clearRect(0, 0, w, h);
-  const color = getTheme().foreground;
-
-  const size = Math.min(w, h);
-  const radius = size / 2 - thickness / 2 - hapRadius - margin;
-  const centerX = w / 2;
-  const centerY = h / 2;
-
-  if (id) {
-    haps = haps.filter((hap) => hap.hasTag(id));
-  }
-  ctx.strokeStyle = color;
-  ctx.fillStyle = color;
-  ctx.globalAlpha = 1;
-  ctx.lineWidth = thickness;
-
-  if (circle) {
-    ctx.beginPath();
-    ctx.arc(centerX, centerY, radius, 0, 2 * Math.PI);
-    ctx.stroke();
-  }
-
-  if (edo) {
-    Array.from({ length: edo }, (_, i) => {
-      const angle = freq2angle(root * Math.pow(2, i / edo), root);
-      const [x, y] = circlePos(centerX, centerY, radius, angle);
-      ctx.beginPath();
-      ctx.arc(x, y, hapRadius, 0, 2 * Math.PI);
-      ctx.fill();
-    });
-    ctx.stroke();
-  }
-
-  let shape = [];
-  ctx.lineWidth = hapRadius;
-  haps.forEach((hap) => {
-    let freq;
-    try {
-      freq = getFrequency(hap);
-    } catch (err) {
-      return;
-    }
-    const angle = freq2angle(freq, root);
-    const [x, y] = circlePos(centerX, centerY, radius, angle);
-    const hapColor = hap.value.color || color;
-    ctx.strokeStyle = hapColor;
-    ctx.fillStyle = hapColor;
-    const { velocity = 1, gain = 1 } = hap.value || {};
-    const alpha = velocity * gain;
-    ctx.globalAlpha = alpha;
-    shape.push([x, y, angle, hapColor, alpha]);
-    ctx.beginPath();
-    if (hapcircles) {
-      ctx.moveTo(x + hapRadius, y);
-      ctx.arc(x, y, hapRadius, 0, 2 * Math.PI);
-      ctx.fill();
-    }
-    if (centerlines) {
-      ctx.moveTo(centerX, centerY);
-      ctx.lineTo(x, y);
-    }
-    ctx.stroke();
-  });
-
-  ctx.strokeStyle = color;
-  ctx.globalAlpha = 1;
-  if (connectdots && shape.length) {
-    shape = shape.sort((a, b) => a[2] - b[2]);
-    ctx.beginPath();
-    ctx.moveTo(shape[0][0], shape[0][1]);
-    shape.forEach(([x, y, _, color, alpha]) => {
-      ctx.strokeStyle = color;
-      ctx.globalAlpha = alpha;
-      ctx.lineTo(x, y);
-    });
-    ctx.lineTo(shape[0][0], shape[0][1]);
-    ctx.stroke();
-  }
-
-  return;
-}
-
-/**
- * Renders a pitch circle to visualize frequencies within one octave
- * @name pitchwheel
- * @param {number} hapcircles
- * @param {number} circle
- * @param {number} edo
- * @param {string} root
- * @param {number} thickness
- * @param {number} hapRadius
- * @param {string} mode
- * @param {number} margin
- * @example
- * n("0 .. 12").scale("C:chromatic")
- * .s("sawtooth")
- * .lpf(500)
- * ._pitchwheel()
- */
-Pattern.prototype.pitchwheel = function (options = {}) {
-  let { ctx = getDrawContext(), id = 1 } = options;
-  return this.tag(id).onPaint((_, time, haps) =>
-    pitchwheel({
-      ...options,
-      time,
-      ctx,
-      haps: haps.filter((hap) => hap.isActive(time)),
-      id,
-    }),
-  );
-};

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 035/110] 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 9a2be7f44..8297746dc 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 1d5f3a4f30c415b53ea1b0a5d88d31d318725631 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sat, 22 Nov 2025 18:21:24 -0500
Subject: [PATCH 036/110] prevent filter modulation pops

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

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index de64df0e8..8e45f7bca 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -238,7 +238,7 @@ export function createFilter(context, start, end, params, cps) {
   if (sync != null) {
     rate = cps * sync;
   }
-  const lfoValues = { depth, dcoffset, skew, shape, frequency: rate };
+  const lfoValues = { depth, dcoffset, skew, shape, frequency: rate, min: 10, max: 20000 };
   getParamLfo(context, frequencyParam, start, end, lfoValues);
   return filter;
 }

From adc3a9ac6cb780c653c843c5c296c5fbb8f106b0 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sat, 22 Nov 2025 20:51:30 -0600
Subject: [PATCH 037/110] Swap with temp variable

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

diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index e60cd223e..bf633a63b 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -543,8 +543,9 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
         if (pn >= 1.0) pn -= 1.0;
         this.phase[n] = pn;
         // invert right and left gain
+        const tmp = gainL;
         gainL = gainR;
-        gainR = gainL;
+        gainR = tmp;
       }
     }
     return true;

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 038/110] 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 8e45f7bca..7bca637f2 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 650f9c2ce..4e1a145c0 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 039/110] 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 9a2be7f44..299169973 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 7bca637f2..65f5cc36d 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 040/110] 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 31e4bddd3..4345eedbf 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 041/110] 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 de64df0e8..59608698d 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 042/110] 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 9a2be7f44..5c5883e9a 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 31e4bddd3..4d4da8b22 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 6221099af80f87e783339d46f31b685b0ce0f3ed Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 18:09:38 -0500
Subject: [PATCH 043/110] working

---
 packages/core/repl.mjs                        |  1 +
 .../repl/components/button/action-button.jsx  | 24 ++++++++++++
 .../panel/ImportPrebakeScriptButton.jsx       | 39 +++++++++++++++++++
 website/src/repl/components/panel/Panel.jsx   |  2 +-
 .../src/repl/components/panel/PatternsTab.jsx |  2 +-
 .../src/repl/components/panel/SettingsTab.jsx | 12 ++++--
 website/src/repl/prebake.mjs                  | 11 +++++-
 website/src/repl/useReplContext.jsx           | 11 ++++--
 website/src/settings.mjs                      |  3 ++
 9 files changed, 94 insertions(+), 11 deletions(-)
 create mode 100644 website/src/repl/components/panel/ImportPrebakeScriptButton.jsx

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index bcb70eec9..90b4fcbb8 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -147,6 +147,7 @@ export function repl({
 
   // set pattern methods that use this repl via closure
   const injectPatternMethods = () => {
+    
     Pattern.prototype.p = function (id) {
       if (typeof id === 'string' && (id.startsWith('_') || id.endsWith('_'))) {
         // allows muting a pattern x with x_ or _x
diff --git a/website/src/repl/components/button/action-button.jsx b/website/src/repl/components/button/action-button.jsx
index d589b7bed..eb395212c 100644
--- a/website/src/repl/components/button/action-button.jsx
+++ b/website/src/repl/components/button/action-button.jsx
@@ -8,3 +8,27 @@ export function ActionButton({ children, label, labelIsHidden, className, ...but
     </button>
   );
 }
+export function ActionInput({ label, className, ...inputProps }) {
+  return (
+    <label className={cx("hover:opacity-50 cursor-pointer text-nowrap w-fit", className)}>
+      <input
+        style={{ display: 'none' }}
+        {...inputProps}
+      />
+      {label}
+    </label>
+  );
+}
+
+export function SpecialActionButton(props) {
+  const { className, ...buttonProps } = props
+
+  return <ActionButton {...buttonProps} className={cx("bg-background p-2 max-w-[300px] rounded-md hover:opacity-50", className)} />
+
+}
+export function SpecialActionInput(props) {
+  const { className, ...inputProps } = props
+  return <ActionInput {...inputProps} className={cx("bg-background p-2  max-w-[300px] rounded-md hover:opacity-50", className)} />
+}
+
+
diff --git a/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
new file mode 100644
index 000000000..c521c527b
--- /dev/null
+++ b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
@@ -0,0 +1,39 @@
+import { errorLogger } from '@strudel/core';
+import { useSettings, storeStartupScript } from '../../../settings.mjs';
+import { SpecialActionInput } from '../button/action-button';
+
+async function importScript(script) {
+    const reader = new FileReader()
+    reader.readAsText(script)
+
+    reader.onload = () => {
+        const text = reader.result;
+        console.info(text)
+        storeStartupScript(text)
+
+    };
+
+    reader.onerror = () => {
+        errorLogger(new Error('failed to import prebake script'), 'ImportPrebakeScriptButton')
+    }
+
+}
+export function ImportPrebakeScriptButton() {
+    const settings = useSettings();
+
+    return <SpecialActionInput type="file"
+        label="import prebake script"
+        accept=".strudel, .txt"
+        onChange={(e) => importScript(e.target.files[0])} />
+
+    // return <label className="hover:opacity-50 cursor-pointer">
+    //     <input
+    //         style={{ display: 'none' }}
+    //         type="file"
+    //         // multiple
+    //         accept=".strudel, .txt"
+    //         onChange={(e) => importScript(e.target.files[0])}
+    //     />
+    //     import prebake script
+    // </label>
+}
\ No newline at end of file
diff --git a/website/src/repl/components/panel/Panel.jsx b/website/src/repl/components/panel/Panel.jsx
index b26c2edef..1af859f81 100644
--- a/website/src/repl/components/panel/Panel.jsx
+++ b/website/src/repl/components/panel/Panel.jsx
@@ -127,7 +127,7 @@ function PanelContent({ context, tab }) {
     case tabNames.reference:
       return <Reference />;
     case tabNames.settings:
-      return <SettingsTab started={context.started} />;
+      return <SettingsTab started={context.started} context={context} />;
     case tabNames.files:
       return <FilesTab />;
     default:
diff --git a/website/src/repl/components/panel/PatternsTab.jsx b/website/src/repl/components/panel/PatternsTab.jsx
index 5e0d50e72..67585d20a 100644
--- a/website/src/repl/components/panel/PatternsTab.jsx
+++ b/website/src/repl/components/panel/PatternsTab.jsx
@@ -83,7 +83,7 @@ function UserPatterns({ context }) {
   const activePattern = useActivePattern();
   const viewingPatternStore = useViewingPatternData();
   const viewingPatternData = parseJSON(viewingPatternStore);
-  const { userPatterns, patternFilter, patternAutoStart } = useSettings();
+  const { userPatterns, patternFilter, patternAutoStart, } = useSettings();
   const viewingPatternID = viewingPatternData?.id;
   return (
     <div className="flex flex-col gap-2 flex-grow overflow-hidden h-full pb-2 ">
diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index 85991f55c..2c66ed1a3 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -7,6 +7,8 @@ import { AudioDeviceSelector } from './AudioDeviceSelector.jsx';
 import { AudioEngineTargetSelector } from './AudioEngineTargetSelector.jsx';
 import { confirmDialog } from '../../util.mjs';
 import { DEFAULT_MAX_POLYPHONY, setMaxPolyphony, setMultiChannelOrbits } from '@strudel/webaudio';
+import { ActionButton, SpecialActionButton } from '../button/action-button.jsx';
+import { ImportPrebakeScriptButton } from './ImportPrebakeScriptButton.jsx';
 
 function Checkbox({ label, value, onChange, disabled = false }) {
   return (
@@ -86,7 +88,7 @@ const fontFamilyOptions = {
 
 const RELOAD_MSG = 'Changing this setting requires the window to reload itself. OK?';
 
-export function SettingsTab({ started }) {
+export function SettingsTab({ started,context }) {
   const {
     theme,
     keybindings,
@@ -113,6 +115,7 @@ export function SettingsTab({ started }) {
     isTabIndentationEnabled,
     isMultiCursorEnabled,
     patternAutoStart,
+    startupScript,
   } = useSettings();
   const shouldAlwaysSync = isUdels();
   const canChangeAudioDevice = AudioContext.prototype.setSinkId != null;
@@ -204,6 +207,8 @@ export function SettingsTab({ started }) {
           />
         </FormItem>
       </div>
+      <ImportPrebakeScriptButton />
+      {/* <SpecialActionButton label="edit startup script" onClick={() => context.editStartupScript(startupScript)}></SpecialActionButton> */}
       <FormItem label="Keybindings">
         <ButtonGroup
           value={keybindings}
@@ -313,8 +318,7 @@ export function SettingsTab({ started }) {
       </FormItem>
       <FormItem label="Zen Mode">Try clicking the logo in the top left!</FormItem>
       <FormItem label="Reset Settings">
-        <button
-          className="bg-background p-2 max-w-[300px] rounded-md hover:opacity-50"
+        <SpecialActionButton
           onClick={() => {
             confirmDialog('Sure?').then((r) => {
               if (r) {
@@ -325,7 +329,7 @@ export function SettingsTab({ started }) {
           }}
         >
           restore default settings
-        </button>
+        </SpecialActionButton>
       </FormItem>
     </div>
   );
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index 8a6ccc7e0..960771f05 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -1,14 +1,23 @@
-import { Pattern, noteToMidi, valueToMidi } from '@strudel/core';
+import { Pattern,  noteToMidi, valueToMidi } from '@strudel/core';
 import { aliasBank, registerSynthSounds, registerZZFXSounds, samples } from '@strudel/webaudio';
 import { registerSamplesFromDB } from './idbutils.mjs';
 import './piano.mjs';
 import './files.mjs';
+import { settingsMap } from '@src/settings.mjs';
+import { evaluate } from '@strudel/transpiler';
 
 const { BASE_URL } = import.meta.env;
 const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 const baseCDN = 'https://strudel.b-cdn.net';
 
 export async function prebake() {
+
+  // const settings = settingsMap.get()
+  
+
+  // const prebakeScript = settings.startupScript || '';
+  // await  evaluate(prebakeScript);
+
   // https://archive.org/details/SalamanderGrandPianoV3
   // License: CC-by http://creativecommons.org/licenses/by/3.0/ Author: Alexander Holm
   await Promise.all([
diff --git a/website/src/repl/useReplContext.jsx b/website/src/repl/useReplContext.jsx
index ac30fe342..4e8b2b946 100644
--- a/website/src/repl/useReplContext.jsx
+++ b/website/src/repl/useReplContext.jsx
@@ -6,7 +6,7 @@ This program is free software: you can redistribute it and/or modify it under th
 
 import { code2hash, getPerformanceTimeSeconds, logger, silence } from '@strudel/core';
 import { getDrawContext } from '@strudel/draw';
-import { transpiler } from '@strudel/transpiler';
+import { evaluate, transpiler } from '@strudel/transpiler';
 import {
   getAudioContextCurrentTime,
   webaudioOutput,
@@ -47,6 +47,7 @@ if (typeof window !== 'undefined') {
     multiChannelOrbits: parseBoolean(multiChannelOrbits),
   });
   modulesLoading = loadModules();
+  // prebakeScript = evaluate(settingsMap.get().startupScript ?? '')
   presets = prebake();
   drawContext = getDrawContext();
   clearCanvas = () => drawContext.clearRect(0, 0, drawContext.canvas.height, drawContext.canvas.width);
@@ -63,11 +64,10 @@ async function getModule(name) {
 const initialCode = `// LOADING`;
 
 export function useReplContext() {
-  const { isSyncEnabled, audioEngineTarget } = useSettings();
+  const { isSyncEnabled, audioEngineTarget, startupScript } = useSettings();
   const shouldUseWebaudio = audioEngineTarget !== audioEngineTargets.osc;
   const defaultOutput = shouldUseWebaudio ? webaudioOutput : superdirtOutput;
   const getTime = shouldUseWebaudio ? getAudioContextCurrentTime : getPerformanceTimeSeconds;
-
   const init = useCallback(() => {
     const drawTime = [-2, 2];
     const drawContext = getDrawContext();
@@ -84,7 +84,9 @@ export function useReplContext() {
       pattern: silence,
       drawTime,
       drawContext,
-      prebake: async () => Promise.all([modulesLoading, presets]),
+      prebake: async () => Promise.all([modulesLoading, presets,]).then(() => {
+        return evaluate(startupScript ?? '')
+      }),
       onUpdateState: (state) => {
         setReplState({ ...state });
       },
@@ -200,6 +202,7 @@ export function useReplContext() {
     }
   };
 
+
   const handleEvaluate = () => {
     editorRef.current.evaluate();
   };
diff --git a/website/src/settings.mjs b/website/src/settings.mjs
index 7c62b0ded..1fff439be 100644
--- a/website/src/settings.mjs
+++ b/website/src/settings.mjs
@@ -45,6 +45,7 @@ export const defaultSettings = {
   isPanelOpen: true,
   togglePanelTrigger: 'click', //click | hover
   userPatterns: '{}',
+  startupScript: '//edit this script to run code on startup\n',
   audioEngineTarget: audioEngineTargets.webaudio,
   isButtonRowHidden: false,
   isCSSAnimationDisabled: false,
@@ -108,6 +109,8 @@ export const setActiveFooter = (tab) => settingsMap.setKey('activeFooter', tab);
 export const setPanelPinned = (bool) => settingsMap.setKey('isPanelPinned', bool);
 export const setIsPanelOpened = (bool) => settingsMap.setKey('isPanelOpen', bool);
 
+export const storeStartupScript = (script) => settingsMap.setKey('startupScript', script);
+
 export const setIsZen = (active) => settingsMap.setKey('isZen', !!active);
 
 const patternSetting = (key) =>

From d5dfbd7aa4d4236bdf143b94b7abddf7a9fe93c5 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 18:45:13 -0500
Subject: [PATCH 044/110] cleanup

---
 packages/core/repl.mjs                        |  1 -
 .../repl/components/button/action-button.jsx  | 45 ++++++++++-------
 .../panel/ImportPrebakeScriptButton.jsx       | 48 ++++++++-----------
 website/src/repl/components/panel/Panel.jsx   |  2 +-
 .../src/repl/components/panel/PatternsTab.jsx |  2 +-
 .../src/repl/components/panel/SettingsTab.jsx |  3 +-
 website/src/repl/prebake.mjs                  |  4 +-
 website/src/repl/useReplContext.jsx           |  8 ++--
 8 files changed, 54 insertions(+), 59 deletions(-)

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 90b4fcbb8..bcb70eec9 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -147,7 +147,6 @@ export function repl({
 
   // set pattern methods that use this repl via closure
   const injectPatternMethods = () => {
-    
     Pattern.prototype.p = function (id) {
       if (typeof id === 'string' && (id.startsWith('_') || id.endsWith('_'))) {
         // allows muting a pattern x with x_ or _x
diff --git a/website/src/repl/components/button/action-button.jsx b/website/src/repl/components/button/action-button.jsx
index eb395212c..7364d2af0 100644
--- a/website/src/repl/components/button/action-button.jsx
+++ b/website/src/repl/components/button/action-button.jsx
@@ -8,27 +8,36 @@ export function ActionButton({ children, label, labelIsHidden, className, ...but
     </button>
   );
 }
-export function ActionInput({ label, className, ...inputProps }) {
+
+export function SpecialActionButton(props) {
+  const { className, ...buttonProps } = props;
+
   return (
-    <label className={cx("hover:opacity-50 cursor-pointer text-nowrap w-fit", className)}>
-      <input
-        style={{ display: 'none' }}
-        {...inputProps}
-      />
-      {label}
+    <ActionButton
+      {...buttonProps}
+      className={cx('bg-background p-2 max-w-[300px] rounded-md hover:opacity-50', className)}
+    />
+  );
+}
+
+export function ActionInput({ label, className, ...props }) {
+  return (
+    <label className={cx('inline-flex items-center cursor-pointer', className)}>
+      <input {...props} className="sr-only peer" />
+
+      <span className="inline-flex items-center transition-opacity peer-hover:opacity-60 peer-focus-visible:ring-2 peer-focus-visible:ring-blue-500">
+        {label}
+      </span>
     </label>
   );
 }
 
-export function SpecialActionButton(props) {
-  const { className, ...buttonProps } = props
-
-  return <ActionButton {...buttonProps} className={cx("bg-background p-2 max-w-[300px] rounded-md hover:opacity-50", className)} />
-
+export function SpecialActionInput({ className, ...props }) {
+  return (
+    <ActionInput
+      {...props}
+      className={className}
+      label={<span className="bg-background p-2 max-w-[300px] rounded-md">{props.label}</span>}
+    />
+  );
 }
-export function SpecialActionInput(props) {
-  const { className, ...inputProps } = props
-  return <ActionInput {...inputProps} className={cx("bg-background p-2  max-w-[300px] rounded-md hover:opacity-50", className)} />
-}
-
-
diff --git a/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
index c521c527b..74b4ebd33 100644
--- a/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
+++ b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
@@ -3,37 +3,27 @@ import { useSettings, storeStartupScript } from '../../../settings.mjs';
 import { SpecialActionInput } from '../button/action-button';
 
 async function importScript(script) {
-    const reader = new FileReader()
-    reader.readAsText(script)
+  const reader = new FileReader();
+  reader.readAsText(script);
 
-    reader.onload = () => {
-        const text = reader.result;
-        console.info(text)
-        storeStartupScript(text)
-
-    };
-
-    reader.onerror = () => {
-        errorLogger(new Error('failed to import prebake script'), 'ImportPrebakeScriptButton')
-    }
+  reader.onload = () => {
+    const text = reader.result;
+    storeStartupScript(text);
+  };
 
+  reader.onerror = () => {
+    errorLogger(new Error('failed to import prebake script'), 'importScript');
+  };
 }
 export function ImportPrebakeScriptButton() {
-    const settings = useSettings();
+  const settings = useSettings();
 
-    return <SpecialActionInput type="file"
-        label="import prebake script"
-        accept=".strudel, .txt"
-        onChange={(e) => importScript(e.target.files[0])} />
-
-    // return <label className="hover:opacity-50 cursor-pointer">
-    //     <input
-    //         style={{ display: 'none' }}
-    //         type="file"
-    //         // multiple
-    //         accept=".strudel, .txt"
-    //         onChange={(e) => importScript(e.target.files[0])}
-    //     />
-    //     import prebake script
-    // </label>
-}
\ No newline at end of file
+  return (
+    <SpecialActionInput
+      type="file"
+      label="import prebake script"
+      accept=".strudel"
+      onChange={(e) => importScript(e.target.files[0])}
+    />
+  );
+}
diff --git a/website/src/repl/components/panel/Panel.jsx b/website/src/repl/components/panel/Panel.jsx
index 1af859f81..b26c2edef 100644
--- a/website/src/repl/components/panel/Panel.jsx
+++ b/website/src/repl/components/panel/Panel.jsx
@@ -127,7 +127,7 @@ function PanelContent({ context, tab }) {
     case tabNames.reference:
       return <Reference />;
     case tabNames.settings:
-      return <SettingsTab started={context.started} context={context} />;
+      return <SettingsTab started={context.started} />;
     case tabNames.files:
       return <FilesTab />;
     default:
diff --git a/website/src/repl/components/panel/PatternsTab.jsx b/website/src/repl/components/panel/PatternsTab.jsx
index 67585d20a..5e0d50e72 100644
--- a/website/src/repl/components/panel/PatternsTab.jsx
+++ b/website/src/repl/components/panel/PatternsTab.jsx
@@ -83,7 +83,7 @@ function UserPatterns({ context }) {
   const activePattern = useActivePattern();
   const viewingPatternStore = useViewingPatternData();
   const viewingPatternData = parseJSON(viewingPatternStore);
-  const { userPatterns, patternFilter, patternAutoStart, } = useSettings();
+  const { userPatterns, patternFilter, patternAutoStart } = useSettings();
   const viewingPatternID = viewingPatternData?.id;
   return (
     <div className="flex flex-col gap-2 flex-grow overflow-hidden h-full pb-2 ">
diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index 2c66ed1a3..42232db73 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -88,7 +88,7 @@ const fontFamilyOptions = {
 
 const RELOAD_MSG = 'Changing this setting requires the window to reload itself. OK?';
 
-export function SettingsTab({ started,context }) {
+export function SettingsTab({ started }) {
   const {
     theme,
     keybindings,
@@ -208,7 +208,6 @@ export function SettingsTab({ started,context }) {
         </FormItem>
       </div>
       <ImportPrebakeScriptButton />
-      {/* <SpecialActionButton label="edit startup script" onClick={() => context.editStartupScript(startupScript)}></SpecialActionButton> */}
       <FormItem label="Keybindings">
         <ButtonGroup
           value={keybindings}
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index 960771f05..ab8f03e34 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -1,4 +1,4 @@
-import { Pattern,  noteToMidi, valueToMidi } from '@strudel/core';
+import { Pattern, noteToMidi, valueToMidi } from '@strudel/core';
 import { aliasBank, registerSynthSounds, registerZZFXSounds, samples } from '@strudel/webaudio';
 import { registerSamplesFromDB } from './idbutils.mjs';
 import './piano.mjs';
@@ -11,9 +11,7 @@ const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL
 const baseCDN = 'https://strudel.b-cdn.net';
 
 export async function prebake() {
-
   // const settings = settingsMap.get()
-  
 
   // const prebakeScript = settings.startupScript || '';
   // await  evaluate(prebakeScript);
diff --git a/website/src/repl/useReplContext.jsx b/website/src/repl/useReplContext.jsx
index 4e8b2b946..8c533906d 100644
--- a/website/src/repl/useReplContext.jsx
+++ b/website/src/repl/useReplContext.jsx
@@ -84,9 +84,10 @@ export function useReplContext() {
       pattern: silence,
       drawTime,
       drawContext,
-      prebake: async () => Promise.all([modulesLoading, presets,]).then(() => {
-        return evaluate(startupScript ?? '')
-      }),
+      prebake: async () =>
+        Promise.all([modulesLoading, presets]).then(() => {
+          return evaluate(startupScript ?? '');
+        }),
       onUpdateState: (state) => {
         setReplState({ ...state });
       },
@@ -202,7 +203,6 @@ export function useReplContext() {
     }
   };
 
-
   const handleEvaluate = () => {
     editorRef.current.evaluate();
   };

From 3a7b2377650abcfb7f1199d817fb52872651d04c Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 18:59:16 -0500
Subject: [PATCH 045/110] change variable name

---
 .../src/repl/components/panel/ImportPrebakeScriptButton.jsx | 4 ++--
 website/src/repl/components/panel/SettingsTab.jsx           | 2 +-
 website/src/repl/prebake.mjs                                | 5 -----
 website/src/repl/useReplContext.jsx                         | 6 +++---
 website/src/settings.mjs                                    | 4 ++--
 5 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
index 74b4ebd33..c997f6b6e 100644
--- a/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
+++ b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
@@ -1,5 +1,5 @@
 import { errorLogger } from '@strudel/core';
-import { useSettings, storeStartupScript } from '../../../settings.mjs';
+import { useSettings, storePrebakeScript } from '../../../settings.mjs';
 import { SpecialActionInput } from '../button/action-button';
 
 async function importScript(script) {
@@ -8,7 +8,7 @@ async function importScript(script) {
 
   reader.onload = () => {
     const text = reader.result;
-    storeStartupScript(text);
+    storePrebakeScript(text);
   };
 
   reader.onerror = () => {
diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index 42232db73..b243e8516 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -115,7 +115,7 @@ export function SettingsTab({ started }) {
     isTabIndentationEnabled,
     isMultiCursorEnabled,
     patternAutoStart,
-    startupScript,
+    prebakeScript,
   } = useSettings();
   const shouldAlwaysSync = isUdels();
   const canChangeAudioDevice = AudioContext.prototype.setSinkId != null;
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index ab8f03e34..53a2a6003 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -11,11 +11,6 @@ const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL
 const baseCDN = 'https://strudel.b-cdn.net';
 
 export async function prebake() {
-  // const settings = settingsMap.get()
-
-  // const prebakeScript = settings.startupScript || '';
-  // await  evaluate(prebakeScript);
-
   // https://archive.org/details/SalamanderGrandPianoV3
   // License: CC-by http://creativecommons.org/licenses/by/3.0/ Author: Alexander Holm
   await Promise.all([
diff --git a/website/src/repl/useReplContext.jsx b/website/src/repl/useReplContext.jsx
index 8c533906d..ce0820b08 100644
--- a/website/src/repl/useReplContext.jsx
+++ b/website/src/repl/useReplContext.jsx
@@ -47,7 +47,7 @@ if (typeof window !== 'undefined') {
     multiChannelOrbits: parseBoolean(multiChannelOrbits),
   });
   modulesLoading = loadModules();
-  // prebakeScript = evaluate(settingsMap.get().startupScript ?? '')
+  // prebakeScript = evaluate(settingsMap.get().prebakeScript ?? '')
   presets = prebake();
   drawContext = getDrawContext();
   clearCanvas = () => drawContext.clearRect(0, 0, drawContext.canvas.height, drawContext.canvas.width);
@@ -64,7 +64,7 @@ async function getModule(name) {
 const initialCode = `// LOADING`;
 
 export function useReplContext() {
-  const { isSyncEnabled, audioEngineTarget, startupScript } = useSettings();
+  const { isSyncEnabled, audioEngineTarget, prebakeScript } = useSettings();
   const shouldUseWebaudio = audioEngineTarget !== audioEngineTargets.osc;
   const defaultOutput = shouldUseWebaudio ? webaudioOutput : superdirtOutput;
   const getTime = shouldUseWebaudio ? getAudioContextCurrentTime : getPerformanceTimeSeconds;
@@ -86,7 +86,7 @@ export function useReplContext() {
       drawContext,
       prebake: async () =>
         Promise.all([modulesLoading, presets]).then(() => {
-          return evaluate(startupScript ?? '');
+          return evaluate(prebakeScript ?? '');
         }),
       onUpdateState: (state) => {
         setReplState({ ...state });
diff --git a/website/src/settings.mjs b/website/src/settings.mjs
index 1fff439be..a1ddc90cb 100644
--- a/website/src/settings.mjs
+++ b/website/src/settings.mjs
@@ -45,7 +45,7 @@ export const defaultSettings = {
   isPanelOpen: true,
   togglePanelTrigger: 'click', //click | hover
   userPatterns: '{}',
-  startupScript: '//edit this script to run code on startup\n',
+  prebakeScript: '',
   audioEngineTarget: audioEngineTargets.webaudio,
   isButtonRowHidden: false,
   isCSSAnimationDisabled: false,
@@ -109,7 +109,7 @@ export const setActiveFooter = (tab) => settingsMap.setKey('activeFooter', tab);
 export const setPanelPinned = (bool) => settingsMap.setKey('isPanelPinned', bool);
 export const setIsPanelOpened = (bool) => settingsMap.setKey('isPanelOpen', bool);
 
-export const storeStartupScript = (script) => settingsMap.setKey('startupScript', script);
+export const storePrebakeScript = (script) => settingsMap.setKey('prebakeScript', script);
 
 export const setIsZen = (active) => settingsMap.setKey('isZen', !!active);
 

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 046/110] synonym:

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

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 8297746dc..809a45ab2 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 4caacb0de1bcd2cb45f9800e90365b50d1fb2174 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 19:12:28 -0500
Subject: [PATCH 047/110] only eval if script

---
 website/src/repl/useReplContext.jsx | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/website/src/repl/useReplContext.jsx b/website/src/repl/useReplContext.jsx
index ce0820b08..71a221525 100644
--- a/website/src/repl/useReplContext.jsx
+++ b/website/src/repl/useReplContext.jsx
@@ -47,7 +47,6 @@ if (typeof window !== 'undefined') {
     multiChannelOrbits: parseBoolean(multiChannelOrbits),
   });
   modulesLoading = loadModules();
-  // prebakeScript = evaluate(settingsMap.get().prebakeScript ?? '')
   presets = prebake();
   drawContext = getDrawContext();
   clearCanvas = () => drawContext.clearRect(0, 0, drawContext.canvas.height, drawContext.canvas.width);
@@ -86,7 +85,9 @@ export function useReplContext() {
       drawContext,
       prebake: async () =>
         Promise.all([modulesLoading, presets]).then(() => {
-          return evaluate(prebakeScript ?? '');
+          if (prebakeScript?.length) {
+            return evaluate(prebakeScript ?? '');
+          }
         }),
       onUpdateState: (state) => {
         setReplState({ ...state });

From 7bc6fcbf2a56a8b0f12aed9d9c386fbe43dbfa6c Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 18:24:48 -0600
Subject: [PATCH 048/110] Add channel support to midi in

---
 packages/midi/midi.mjs                    | 34 +++++++++++++++++------
 test/__snapshots__/examples.test.mjs.snap | 21 ++++++++++++++
 2 files changed, 46 insertions(+), 9 deletions(-)

diff --git a/packages/midi/midi.mjs b/packages/midi/midi.mjs
index 32f030125..0fee380c6 100644
--- a/packages/midi/midi.mjs
+++ b/packages/midi/midi.mjs
@@ -479,14 +479,23 @@ Pattern.prototype.midi = function (midiport, options = {}) {
 
 let listeners = {};
 const refs = {};
+const refsByChan = {};
 
 /**
  * MIDI input: Opens a MIDI input port to receive MIDI control change messages.
+ *
+ * The output is a function that accepts a midi cc value to query as well as (optionally) a midi channel
  * @param {string | number} input MIDI device name or index defaulting to 0
- * @returns {Function}
+ * @returns {function(number, number=): function(): number} A function from (cc, channel?) to
+ *   the most recently received midi cc value through the input (normalized to 0 to 1)
  * @example
- * let cc = await midin('IAC Driver Bus 1')
+ * const cc = await midin('IAC Driver Bus 1')
  * note("c a f e").lpf(cc(0).range(0, 1000)).lpq(cc(1).range(0, 10)).sound("sawtooth")
+ * @example
+ * const allCC = await midin('IAC Driver Bus 1')
+ * const cc = (ccNum) => allCC(ccNum, 2) // just channel 2
+ * note("c a f e").s("saw")
+ *   .when(cc(0).gt(0), x => x.postgain(0))
  */
 export async function midin(input) {
   if (isPattern(input)) {
@@ -511,17 +520,24 @@ export async function midin(input) {
       }`,
     );
   }
-  // ensure refs for this input are initialized
-  if (!refs[input]) {
-    refs[input] = {};
-  }
-  const cc = (cc) => ref(() => refs[input][cc] || 0);
+  refs[input] ??= {};
+  refsByChan[input] ??= {};
+  const cc = (cc, chan) => {
+    if (chan !== undefined) {
+      return ref(() => refsByChan[input][cc]?.[chan] || 0);
+    }
+    return ref(() => refs[input][cc] || 0);
+  };
 
   listeners[input] && device.removeListener('midimessage', listeners[input]);
   listeners[input] = (e) => {
-    const cc = e.dataBytes[0];
+    const ccNum = e.dataBytes[0];
     const v = e.dataBytes[1];
-    refs[input] && (refs[input][cc] = v / 127);
+    const chan = e.message.channel;
+    const scaled = v / 127;
+    refsByChan[input][ccNum] ??= {};
+    refsByChan[input][ccNum][chan] = scaled;
+    refs[input][ccNum] = scaled;
   };
   device.addListener('midimessage', listeners[input]);
   return cc;
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 31e4bddd3..783fee998 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -6533,6 +6533,27 @@ exports[`runs examples > example "midin" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "midin" example index 1 1`] = `
+[
+  "[ 0/1 → 1/4 | note:c s:saw ]",
+  "[ 1/4 → 1/2 | note:a s:saw ]",
+  "[ 1/2 → 3/4 | note:f s:saw ]",
+  "[ 3/4 → 1/1 | note:e s:saw ]",
+  "[ 1/1 → 5/4 | note:c s:saw ]",
+  "[ 5/4 → 3/2 | note:a s:saw ]",
+  "[ 3/2 → 7/4 | note:f s:saw ]",
+  "[ 7/4 → 2/1 | note:e s:saw ]",
+  "[ 2/1 → 9/4 | note:c s:saw ]",
+  "[ 9/4 → 5/2 | note:a s:saw ]",
+  "[ 5/2 → 11/4 | note:f s:saw ]",
+  "[ 11/4 → 3/1 | note:e s:saw ]",
+  "[ 3/1 → 13/4 | note:c s:saw ]",
+  "[ 13/4 → 7/2 | note:a s:saw ]",
+  "[ 7/2 → 15/4 | note:f s:saw ]",
+  "[ 15/4 → 4/1 | note:e s:saw ]",
+]
+`;
+
 exports[`runs examples > example "midiport" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c midiport:0 ]",

From 20016fd9aa57f1d7d3e5df75f541a6fe42b42659 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Sun, 23 Nov 2025 20:25:13 -0500
Subject: [PATCH 049/110] update hash

---
 website/src/repl/components/panel/SettingsTab.jsx | 12 ++++++++++--
 website/src/repl/useReplContext.jsx               | 10 ++++++++--
 website/src/repl/util.mjs                         | 11 +++++------
 website/src/settings.mjs                          |  2 ++
 4 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index b243e8516..f46fa661c 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -115,7 +115,7 @@ export function SettingsTab({ started }) {
     isTabIndentationEnabled,
     isMultiCursorEnabled,
     patternAutoStart,
-    prebakeScript,
+    includePrebakeScriptInShare,
   } = useSettings();
   const shouldAlwaysSync = isUdels();
   const canChangeAudioDevice = AudioContext.prototype.setSinkId != null;
@@ -207,7 +207,15 @@ export function SettingsTab({ started }) {
           />
         </FormItem>
       </div>
-      <ImportPrebakeScriptButton />
+      <FormItem label="Prebake">
+        <ImportPrebakeScriptButton />
+        <Checkbox
+          label="Include prebake script in share"
+          onChange={(cbEvent) => settingsMap.setKey('includePrebakeScriptInShare', cbEvent.target.checked)}
+          value={includePrebakeScriptInShare}
+        />
+      </FormItem>
+
       <FormItem label="Keybindings">
         <ButtonGroup
           value={keybindings}
diff --git a/website/src/repl/useReplContext.jsx b/website/src/repl/useReplContext.jsx
index 71a221525..8dcb6b754 100644
--- a/website/src/repl/useReplContext.jsx
+++ b/website/src/repl/useReplContext.jsx
@@ -63,7 +63,7 @@ async function getModule(name) {
 const initialCode = `// LOADING`;
 
 export function useReplContext() {
-  const { isSyncEnabled, audioEngineTarget, prebakeScript } = useSettings();
+  const { isSyncEnabled, audioEngineTarget, prebakeScript, includePrebakeScriptInShare } = useSettings();
   const shouldUseWebaudio = audioEngineTarget !== audioEngineTargets.osc;
   const defaultOutput = shouldUseWebaudio ? webaudioOutput : superdirtOutput;
   const getTime = shouldUseWebaudio ? getAudioContextCurrentTime : getPerformanceTimeSeconds;
@@ -218,7 +218,13 @@ export function useReplContext() {
     editorRef.current.repl.evaluate(code);
   };
 
-  const handleShare = async () => shareCode(replState.code);
+  const handleShare = async () => {
+    let code = replState.code;
+    if (includePrebakeScriptInShare) {
+      code = prebakeScript + '\n' + code;
+    }
+    shareCode(code);
+  };
   const context = {
     started,
     pending,
diff --git a/website/src/repl/util.mjs b/website/src/repl/util.mjs
index ac27158f4..4a7cb26a8 100644
--- a/website/src/repl/util.mjs
+++ b/website/src/repl/util.mjs
@@ -1,11 +1,10 @@
-import { evalScope, hash2code, logger } from '@strudel/core';
+import { code2hash, evalScope, hash2code, logger } from '@strudel/core';
 import { settingPatterns } from '../settings.mjs';
 import { setVersionDefaults } from '@strudel/webaudio';
 import { getMetadata } from '../metadata_parser';
 import { isTauri } from '../tauri.mjs';
 import './Repl.css';
 import { createClient } from '@supabase/supabase-js';
-import { nanoid } from 'nanoid';
 import { writeText } from '@tauri-apps/plugin-clipboard-manager';
 import { $featuredPatterns /* , loadDBPatterns */ } from '@src/user_pattern_utils.mjs';
 
@@ -109,9 +108,8 @@ export function confirmDialog(msg) {
   });
 }
 
-let lastShared;
-
 //RIP due to SPAM
+// let lastShared;
 // export async function shareCode(codeToShare) {
 //   // const codeToShare = activeCode || code;
 //   if (lastShared === codeToShare) {
@@ -146,9 +144,10 @@ let lastShared;
 //   });
 // }
 
-export async function shareCode() {
+export async function shareCode(codeToShare) {
   try {
-    const shareUrl = window.location.href;
+    const hash = '#' + code2hash(codeToShare);
+    const shareUrl = window.location.origin + window.location.pathname + hash;
     if (isTauri()) {
       await writeText(shareUrl);
     } else {
diff --git a/website/src/settings.mjs b/website/src/settings.mjs
index a1ddc90cb..8ec7d455a 100644
--- a/website/src/settings.mjs
+++ b/website/src/settings.mjs
@@ -51,6 +51,7 @@ export const defaultSettings = {
   isCSSAnimationDisabled: false,
   maxPolyphony: 128,
   multiChannelOrbits: false,
+  includePrebakeScriptInShare: true,
 };
 
 let search = null;
@@ -97,6 +98,7 @@ export function useSettings() {
     isPanelOpen: parseBoolean(state.isPanelOpen),
     userPatterns: userPatterns,
     multiChannelOrbits: parseBoolean(state.multiChannelOrbits),
+    includePrebakeScriptInShare: parseBoolean(state.includePrebakeScriptInShare),
     patternAutoStart: isUdels()
       ? false
       : state.patternAutoStart === undefined

From 020a6bc75fb1467a518c32c2d132298747693d8a Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 20:31:31 -0600
Subject: [PATCH 050/110] First pass at transient processor

---
 packages/core/controls.mjs       |  2 +
 packages/superdough/worklets.mjs | 70 ++++++++++++++++++++++++++++++++
 2 files changed, 72 insertions(+)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 809a45ab2..80a244efc 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2584,3 +2584,5 @@ export const scrub = register(
   },
   false,
 );
+
+export const { transient } = registerControl(['transient', 'transsustain', 'transattack']);
diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index bf633a63b..334e2d829 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -11,6 +11,9 @@ const PI = Math.PI;
 const TWO_PI = 2 * PI;
 const INVSR = 1 / sampleRate;
 
+const timeToCoeff = (t) => Math.exp(-INVSR / t);
+const dbToLin = (db) => Math.pow(10, db / 20);
+
 const clamp = (num, min, max) => Math.min(Math.max(num, min), max);
 const mod = (n, m) => ((n % m) + m) % m;
 const lerp = (a, b, n) => n * (b - a) + a;
@@ -1383,3 +1386,70 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
 }
 
 registerProcessor('wavetable-oscillator-processor', WavetableOscillatorProcessor);
+
+class TransientProcessor extends AudioWorkletProcessor {
+  static get parameterDescriptors() {
+    return [];
+  }
+
+  constructor(options) {
+    super();
+    this.gainCoeff = timeToCoeff(0.2);
+    this.avgGain = 1;
+    let {
+      attackTime = 0.003,
+      sustainTime = 0.08,
+      attack = 0,
+      sustain = 0,
+      sensitivity = 0.1,
+      mix = 1,
+    } = options.processorOptions;
+    attackTime = clamp(attackTime, 0.0005, 0.05);
+    sustainTime = clamp(sustainTime, 0.01, 0.5);
+    this.attackCoeff = timeToCoeff(attackTime);
+    this.sustainCoeff = timeToCoeff(sustainTime);
+    this.attackAmt = clamp(attack, -1, 1);
+    this.sustainAmt = clamp(sustain, -1, 1);
+    this.scaling = 0.5 + 5 * clamp(sensitivity, 0, 1);
+    this.mix = clamp(mix, 0, 1);
+  }
+
+  process(inputs, outputs, _params) {
+    const input = inputs[0];
+    const output = outputs[0];
+    if (!input || !output) {
+      return true;
+    }
+    const channels = output.length;
+    this.attackEnv ??= new Float32Array(channels);
+    this.sustainEnv ??= new Float32Array(channels);
+    let avgGain = this.avgGain;
+    for (let ch = 0; ch < channels; ch++) {
+      const inCh = input[ch];
+      const outCh = output[ch];
+      let attEnv = this.attackEnv[ch];
+      let susEnv = this.sustainEnv[ch];
+      for (let i = 0; i < blockSize; i++) {
+        const x = Math.abs(inCh[i]);
+        attEnv = lerp(attEnv, x, this.attackCoeff);
+        susEnv = lerp(susEnv, x, this.sustainCoeff);
+        const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1.5, 1.5);
+        const attScale = Math.max(0, peakiness);
+        const susScale = Math.max(0, -peakiness);
+        const attackGain = dbToLin(this.attackAmt * attScale * 18); // max 18db
+        const sustainGain = dbToLin(this.sustainAmt * susScale * 36); // max 36db
+        const gain = clamp(attackGain * sustainGain, 0, 8);
+        avgGain = lerp(avgGain, gain, this.gainCoeff);
+        const makeup = avgGain > 1e-3 ? 1 / avgGain : 1;
+        const wet = x * gain * makeup;
+        outCh[i] = lerp(x, wet, this.mix);
+      }
+      this.attackEnv[ch] = attEnv;
+      this.sustainEnv[ch] = susEnv;
+    }
+    this.avgGain = avgGain;
+    return true;
+  }
+}
+
+registerProcessor('transient-processor', TransientProcessor);

From 68840de188622e302276aa7dd31f8c895e6c6887 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 20:58:28 -0600
Subject: [PATCH 051/110] Working version

---
 packages/superdough/superdough.mjs | 19 +++++++++++++++++++
 packages/superdough/worklets.mjs   | 13 ++++++-------
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 650f9c2ce..acf6edef2 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -451,6 +451,9 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     compressorKnee,
     compressorAttack,
     compressorRelease,
+    transient,
+    transsustain,
+    transattack,
   } = value;
 
   delaytime = delaytime ?? cycleToSeconds(delaysync, cps);
@@ -532,6 +535,22 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   chain.push(sourceNode);
   stretch !== undefined && chain.push(getWorklet(ac, 'phase-vocoder-processor', { pitchFactor: stretch }));
 
+  transient !== undefined &&
+    chain.push(
+      getWorklet(
+        ac,
+        'transient-processor',
+        {},
+        {
+          processorOptions: {
+            attack: transient,
+            sustain: transsustain,
+            attackTime: transattack,
+          },
+        },
+      ),
+    );
+
   // gain stage
   chain.push(gainNode(gain));
 
diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 334e2d829..6af7dffc1 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -11,7 +11,7 @@ const PI = Math.PI;
 const TWO_PI = 2 * PI;
 const INVSR = 1 / sampleRate;
 
-const timeToCoeff = (t) => Math.exp(-INVSR / t);
+const timeToCoeff = (t) => 1 - Math.exp(-INVSR / t);
 const dbToLin = (db) => Math.pow(10, db / 20);
 
 const clamp = (num, min, max) => Math.min(Math.max(num, min), max);
@@ -1420,17 +1420,16 @@ class TransientProcessor extends AudioWorkletProcessor {
     if (!input || !output) {
       return true;
     }
-    const channels = output.length;
+    const channels = input.length;
     this.attackEnv ??= new Float32Array(channels);
     this.sustainEnv ??= new Float32Array(channels);
     let avgGain = this.avgGain;
     for (let ch = 0; ch < channels; ch++) {
-      const inCh = input[ch];
-      const outCh = output[ch];
       let attEnv = this.attackEnv[ch];
       let susEnv = this.sustainEnv[ch];
-      for (let i = 0; i < blockSize; i++) {
-        const x = Math.abs(inCh[i]);
+      for (let n = 0; n < blockSize; n++) {
+        const sample = input[ch][n];
+        const x = Math.abs(sample);
         attEnv = lerp(attEnv, x, this.attackCoeff);
         susEnv = lerp(susEnv, x, this.sustainCoeff);
         const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1.5, 1.5);
@@ -1442,7 +1441,7 @@ class TransientProcessor extends AudioWorkletProcessor {
         avgGain = lerp(avgGain, gain, this.gainCoeff);
         const makeup = avgGain > 1e-3 ? 1 / avgGain : 1;
         const wet = x * gain * makeup;
-        outCh[i] = lerp(x, wet, this.mix);
+        output[ch][n] = lerp(sample, wet, this.mix);
       }
       this.attackEnv[ch] = attEnv;
       this.sustainEnv[ch] = susEnv;

From df047fd48dbb4df27ca596f2ca085eeb2fb86c4d Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 22:28:10 -0600
Subject: [PATCH 052/110] Optimizations

---
 packages/core/controls.mjs         | 14 +++++++++++++-
 packages/superdough/superdough.mjs |  2 --
 packages/superdough/worklets.mjs   | 16 +++++++++++-----
 3 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 80a244efc..bca7036ad 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2585,4 +2585,16 @@ export const scrub = register(
   false,
 );
 
-export const { transient } = registerControl(['transient', 'transsustain', 'transattack']);
+/**
+ * Transient shaper. Gives independent control over the emphasis on transients
+ * and sustains
+ *
+ * @name transient
+ * @param {number | Pattern} attack Emphasis on transients; between -1 (deaccentuate) and 1 (accentuate)
+ * @param {number | Pattern} sustain Emphasis on the sustains; between -1 (deaccentuate) and 1 (accentuate)
+ * @example
+ * s("bd").transient("<-1 -0.5 0 0.5 1>")
+ * @example
+ * s("hh*16").bank("tr909").transient("<-1:1 1:-1>")
+ */
+export const { transient } = registerControl(['transient', 'transsustain']);
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index acf6edef2..ac6ca7322 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -453,7 +453,6 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     compressorRelease,
     transient,
     transsustain,
-    transattack,
   } = value;
 
   delaytime = delaytime ?? cycleToSeconds(delaysync, cps);
@@ -545,7 +544,6 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
           processorOptions: {
             attack: transient,
             sustain: transsustain,
-            attackTime: transattack,
           },
         },
       ),
diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 6af7dffc1..6b370166c 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -1412,6 +1412,10 @@ class TransientProcessor extends AudioWorkletProcessor {
     this.sustainAmt = clamp(sustain, -1, 1);
     this.scaling = 0.5 + 5 * clamp(sensitivity, 0, 1);
     this.mix = clamp(mix, 0, 1);
+    const maxAttackDb = this.attackAmt * 6;
+    const maxSustainDb = this.sustainAmt * 36;
+    this.attackMaxGain = dbToLin(maxAttackDb) - 1; // increasing from 1
+    this.sustainMaxGain = dbToLin(maxSustainDb) - 1;
   }
 
   process(inputs, outputs, _params) {
@@ -1433,15 +1437,17 @@ class TransientProcessor extends AudioWorkletProcessor {
         attEnv = lerp(attEnv, x, this.attackCoeff);
         susEnv = lerp(susEnv, x, this.sustainCoeff);
         const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1.5, 1.5);
-        const attScale = Math.max(0, peakiness);
-        const susScale = Math.max(0, -peakiness);
-        const attackGain = dbToLin(this.attackAmt * attScale * 18); // max 18db
-        const sustainGain = dbToLin(this.sustainAmt * susScale * 36); // max 36db
+        const attScale = peakiness > 0 ? peakiness : 0;
+        const susScale = peakiness < 0 ? -peakiness : 0;
+        const attackGain = 1 + attScale * this.attackMaxGain;
+        const sustainGain = 1 + susScale * this.sustainMaxGain;
         const gain = clamp(attackGain * sustainGain, 0, 8);
         avgGain = lerp(avgGain, gain, this.gainCoeff);
         const makeup = avgGain > 1e-3 ? 1 / avgGain : 1;
         const wet = x * gain * makeup;
-        output[ch][n] = lerp(sample, wet, this.mix);
+        let y = lerp(sample, wet, this.mix);
+        y /= (1 + Math.abs(y)); // soft clip
+        output[ch][n] = y;
       }
       this.attackEnv[ch] = attEnv;
       this.sustainEnv[ch] = susEnv;

From be36898803a59f201d3d3db4e79bf35a2cc53edb Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 22:29:33 -0600
Subject: [PATCH 053/110] Formatting and examples

---
 packages/superdough/worklets.mjs          |  2 +-
 test/__snapshots__/examples.test.mjs.snap | 78 +++++++++++++++++++++++
 2 files changed, 79 insertions(+), 1 deletion(-)

diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 6b370166c..e5dd0a0d7 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -1446,7 +1446,7 @@ class TransientProcessor extends AudioWorkletProcessor {
         const makeup = avgGain > 1e-3 ? 1 / avgGain : 1;
         const wet = x * gain * makeup;
         let y = lerp(sample, wet, this.mix);
-        y /= (1 + Math.abs(y)); // soft clip
+        y /= 1 + Math.abs(y); // soft clip
         output[ch][n] = y;
       }
       this.attackEnv[ch] = attEnv;
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 31e4bddd3..66777d5e1 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -11410,6 +11410,84 @@ exports[`runs examples > example "tour" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "transient" example index 0 1`] = `
+[
+  "[ 0/1 → 1/1 | s:bd transient:-1 ]",
+  "[ 1/1 → 2/1 | s:bd transient:-0.5 ]",
+  "[ 2/1 → 3/1 | s:bd transient:0 ]",
+  "[ 3/1 → 4/1 | s:bd transient:0.5 ]",
+]
+`;
+
+exports[`runs examples > example "transient" example index 1 1`] = `
+[
+  "[ 0/1 → 1/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 1/16 → 1/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 1/8 → 3/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 3/16 → 1/4 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 1/4 → 5/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 5/16 → 3/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 3/8 → 7/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 7/16 → 1/2 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 1/2 → 9/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 9/16 → 5/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 5/8 → 11/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 11/16 → 3/4 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 3/4 → 13/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 13/16 → 7/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 7/8 → 15/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 15/16 → 1/1 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 1/1 → 17/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 17/16 → 9/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 9/8 → 19/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 19/16 → 5/4 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 5/4 → 21/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 21/16 → 11/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 11/8 → 23/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 23/16 → 3/2 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 3/2 → 25/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 25/16 → 13/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 13/8 → 27/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 27/16 → 7/4 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 7/4 → 29/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 29/16 → 15/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 15/8 → 31/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 31/16 → 2/1 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 2/1 → 33/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 33/16 → 17/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 17/8 → 35/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 35/16 → 9/4 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 9/4 → 37/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 37/16 → 19/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 19/8 → 39/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 39/16 → 5/2 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 5/2 → 41/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 41/16 → 21/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 21/8 → 43/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 43/16 → 11/4 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 11/4 → 45/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 45/16 → 23/8 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 23/8 → 47/16 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 47/16 → 3/1 | s:hh bank:tr909 transient:-1 transsustain:1 ]",
+  "[ 3/1 → 49/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 49/16 → 25/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 25/8 → 51/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 51/16 → 13/4 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 13/4 → 53/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 53/16 → 27/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 27/8 → 55/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 55/16 → 7/2 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 7/2 → 57/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 57/16 → 29/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 29/8 → 59/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 59/16 → 15/4 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 15/4 → 61/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 61/16 → 31/8 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 31/8 → 63/16 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+  "[ 63/16 → 4/1 | s:hh bank:tr909 transient:1 transsustain:-1 ]",
+]
+`;
+
 exports[`runs examples > example "transpose" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:C2 ]",

From 6c01c16a0cbd4dda8f4fe6081746824d79972701 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 22:39:21 -0600
Subject: [PATCH 054/110] Fix typo

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

diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index e5dd0a0d7..67d5e1641 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -1436,7 +1436,7 @@ class TransientProcessor extends AudioWorkletProcessor {
         const x = Math.abs(sample);
         attEnv = lerp(attEnv, x, this.attackCoeff);
         susEnv = lerp(susEnv, x, this.sustainCoeff);
-        const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1.5, 1.5);
+        const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1, 1);
         const attScale = peakiness > 0 ? peakiness : 0;
         const susScale = peakiness < 0 ? -peakiness : 0;
         const attackGain = 1 + attScale * this.attackMaxGain;
@@ -1444,7 +1444,7 @@ class TransientProcessor extends AudioWorkletProcessor {
         const gain = clamp(attackGain * sustainGain, 0, 8);
         avgGain = lerp(avgGain, gain, this.gainCoeff);
         const makeup = avgGain > 1e-3 ? 1 / avgGain : 1;
-        const wet = x * gain * makeup;
+        const wet = sample * gain * makeup;
         let y = lerp(sample, wet, this.mix);
         y /= 1 + Math.abs(y); // soft clip
         output[ch][n] = y;

From 36587ae74732fa69f58704b2a0f3a0ebfbf8e96a Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 23 Nov 2025 22:55:36 -0600
Subject: [PATCH 055/110] Switch back to original version

---
 packages/superdough/worklets.mjs | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 67d5e1641..d88e9dea2 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -1412,10 +1412,6 @@ class TransientProcessor extends AudioWorkletProcessor {
     this.sustainAmt = clamp(sustain, -1, 1);
     this.scaling = 0.5 + 5 * clamp(sensitivity, 0, 1);
     this.mix = clamp(mix, 0, 1);
-    const maxAttackDb = this.attackAmt * 6;
-    const maxSustainDb = this.sustainAmt * 36;
-    this.attackMaxGain = dbToLin(maxAttackDb) - 1; // increasing from 1
-    this.sustainMaxGain = dbToLin(maxSustainDb) - 1;
   }
 
   process(inputs, outputs, _params) {
@@ -1436,11 +1432,11 @@ class TransientProcessor extends AudioWorkletProcessor {
         const x = Math.abs(sample);
         attEnv = lerp(attEnv, x, this.attackCoeff);
         susEnv = lerp(susEnv, x, this.sustainCoeff);
-        const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1, 1);
+        const peakiness = clamp((this.scaling * (attEnv - susEnv)) / (susEnv + 1e-6), -1.5, 1.5);
         const attScale = peakiness > 0 ? peakiness : 0;
         const susScale = peakiness < 0 ? -peakiness : 0;
-        const attackGain = 1 + attScale * this.attackMaxGain;
-        const sustainGain = 1 + susScale * this.sustainMaxGain;
+        const attackGain = dbToLin(this.attackAmt * attScale * 18);
+        const sustainGain = dbToLin(this.sustainAmt * susScale * 36);
         const gain = clamp(attackGain * sustainGain, 0, 8);
         avgGain = lerp(avgGain, gain, this.gainCoeff);
         const makeup = avgGain > 1e-3 ? 1 / avgGain : 1;

From d5e5ab83ac642c23518fe6d4f7584cad0079276b Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Mon, 24 Nov 2025 10:39:37 -0500
Subject: [PATCH 056/110] fix style

---
 website/src/repl/components/button/action-button.jsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/src/repl/components/button/action-button.jsx b/website/src/repl/components/button/action-button.jsx
index 7364d2af0..3499fbb43 100644
--- a/website/src/repl/components/button/action-button.jsx
+++ b/website/src/repl/components/button/action-button.jsx
@@ -25,7 +25,7 @@ export function ActionInput({ label, className, ...props }) {
     <label className={cx('inline-flex items-center cursor-pointer', className)}>
       <input {...props} className="sr-only peer" />
 
-      <span className="inline-flex items-center transition-opacity peer-hover:opacity-60 peer-focus-visible:ring-2 peer-focus-visible:ring-blue-500">
+      <span className="inline-flex items-center peer-hover:opacity-50">
         {label}
       </span>
     </label>

From 7a4babf6e1faa50cf650a086806e5d87ea1e0958 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Mon, 24 Nov 2025 10:40:16 -0500
Subject: [PATCH 057/110] format

---
 website/src/repl/components/button/action-button.jsx | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/website/src/repl/components/button/action-button.jsx b/website/src/repl/components/button/action-button.jsx
index 3499fbb43..de674b696 100644
--- a/website/src/repl/components/button/action-button.jsx
+++ b/website/src/repl/components/button/action-button.jsx
@@ -25,9 +25,7 @@ export function ActionInput({ label, className, ...props }) {
     <label className={cx('inline-flex items-center cursor-pointer', className)}>
       <input {...props} className="sr-only peer" />
 
-      <span className="inline-flex items-center peer-hover:opacity-50">
-        {label}
-      </span>
+      <span className="inline-flex items-center peer-hover:opacity-50">{label}</span>
     </label>
   );
 }

From 89a6efb69e1a1bc74e240a949fbc19c3134f0bc7 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Mon, 24 Nov 2025 16:10:00 +0000
Subject: [PATCH 058/110] [perf] level 5 `connect-leak` on `vowel`

---
 packages/superdough/vowel.mjs | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/packages/superdough/vowel.mjs b/packages/superdough/vowel.mjs
index 3f30aef1e..fda0c6479 100644
--- a/packages/superdough/vowel.mjs
+++ b/packages/superdough/vowel.mjs
@@ -45,7 +45,8 @@ if (typeof GainNode !== 'undefined') {
         throw new Error('vowel: unknown vowel ' + letter);
       }
       const { gains, qs, freqs } = vowelFormant[letter];
-      const makeupGain = ac.createGain();
+      this.makeupGain = ac.createGain();
+      this.audioNodes = [];
       for (let i = 0; i < 5; i++) {
         const gain = ac.createGain();
         gain.gain.value = gains[i];
@@ -53,14 +54,25 @@ if (typeof GainNode !== 'undefined') {
         filter.type = 'bandpass';
         filter.Q.value = qs[i];
         filter.frequency.value = freqs[i];
-        this.connect(filter);
+        super.connect(filter);
         filter.connect(gain);
-        gain.connect(makeupGain);
+        this.audioNodes.push(filter);
+        gain.connect(this.makeupGain);
+        this.audioNodes.push(gain);
       }
-      makeupGain.gain.value = 8; // how much makeup gain to add?
-      this.connect = (target) => makeupGain.connect(target);
+      this.makeupGain.gain.value = 8; // how much makeup gain to add?
       return this;
     }
+    connect(target) {
+      this.makeupGain.connect(target);
+    }
+    disconnect() {
+      this.makeupGain.disconnect();
+      this.audioNodes.forEach((n) => n.disconnect());
+      super.disconnect();
+      this.makeupGain = null;
+      this.audioNodes = null;
+    }
   }
 
   AudioContext.prototype.createVowelFilter = function (letter) {

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 059/110] 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 2ff2089df..a9d7cc266 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 11427dc5b..ad11f595c 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 4e1a145c0..e3177c7d6 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 060/110] [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 650f9c2ce..a549ff68f 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 061/110] 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 4345eedbf..8cbee39da 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 062/110] [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 650f9c2ce..a549ff68f 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 a278f21f1b0a8923d3d454c0e0f0b70de828845b Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Mon, 24 Nov 2025 17:52:00 -0600
Subject: [PATCH 063/110] Allow register in autocomplete, add vel as synonym
 for velocity, fix some controls

---
 packages/core/controls.mjs | 20 +++++++++-----------
 packages/core/pattern.mjs  |  1 -
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index a9d7cc266..a59b30d1a 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -380,12 +380,13 @@ export const { accelerate } = registerControl('accelerate');
  * Sets the velocity from 0 to 1. Is multiplied together with gain.
  *
  * @name velocity
+ * @synonyms vel
  * @example
  * s("hh*8")
  * .gain(".4!2 1 .4!2 1 .4 1")
  * .velocity(".4 1")
  */
-export const { velocity } = registerControl('velocity');
+export const { velocity, vel } = registerControl('velocity', 'vel');
 /**
  * Controls the gain by an exponential amount.
  *
@@ -1323,14 +1324,13 @@ export const { lpdepth } = registerControl('lpdepth');
  * Depth of the LFO for the lowpass filter, in HZ
  *
  * @name lpdepthfrequency
- * @synonyms
- * lpdethfreq
+ * @synonyms lpdepthfreq
  * @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');
+export const { lpdepthfrequency, lpdepthfreq } = registerControl('lpdepthfrequency', 'lpdepthfreq');
 
 /**
  * Shape of the LFO for the lowpass filter
@@ -1384,14 +1384,13 @@ export const { bpdepth } = registerControl('bpdepth');
  * Depth of the LFO for the bandpass filter, in HZ
  *
  * @name bpdepthfrequency
- * @synonyms
- * bpdethfreq
+ * @synonyms bpdepthfreq
  * @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');
+export const { bpdepthfrequency, bpdepthfreq } = registerControl('bpdepthfrequency', 'bpdepthfreq');
 
 /**
  * Shape of the LFO for the bandpass filter
@@ -1439,20 +1438,19 @@ export const { hpsync } = registerControl('hpsync');
  * @name hpdepth
  * @param {number | Pattern} depth depth of modulation
  */
-export const { hpdepth, hpdepthfreq } = registerControl('hpdepth');
+export const { hpdepth } = registerControl('hpdepth');
 
 /**
  * Depth of the LFO for the hipass filter, in hz
  *
  * @name hpdepthfrequency
- * @synonyms
- * hpdethfreq
+ * @synonyms hpdepthfreq
  * @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');
+export const { hpdepthfrequency, hpdepthfreq } = registerControl('hpdepthfrequency', 'hpdepthfreq');
 
 /**
  * Shape of the LFO for the highpass filter
diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 4737f0db0..01a7efbd1 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1587,7 +1587,6 @@ export const func = curry((a, b) => reify(b).func(a));
  *
  * @param {string | string[]} name name of the function, or an array of names to be used as synonyms
  * @param {function} func function with 1 or more params, where last is the current pattern
- * @noAutocomplete
  *
  */
 export function register(name, func, patternify = true, preserveSteps = false, join = (x) => x.innerJoin()) {

From d7afb8a6c097de11a34fdde58a9f976e38a3ba18 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Mon, 24 Nov 2025 18:01:20 -0600
Subject: [PATCH 064/110] Add register example

---
 packages/core/pattern.mjs                 |  7 +++++
 test/__snapshots__/examples.test.mjs.snap | 37 +++++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 01a7efbd1..4753ebfd9 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1587,6 +1587,13 @@ export const func = curry((a, b) => reify(b).func(a));
  *
  * @param {string | string[]} name name of the function, or an array of names to be used as synonyms
  * @param {function} func function with 1 or more params, where last is the current pattern
+ * @param {bool} patternify defaults to true; if set to false, you will have more control over the arguments to `func` as they will be
+ *   in their raw form and it will be up to you to patternify them and/or query them for values
+ * @example
+ * const vlpf = register('vlpf', (freq, pat) => {
+ *   return pat.fmap((v) => ({...v, cutoff: freq * (v.velocity ?? 1) }));
+ * })
+ * s("saw").seg(8).velocity(rand).vlpf(800)
  *
  */
 export function register(name, func, patternify = true, preserveSteps = false, join = (x) => x.innerJoin()) {
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 8cbee39da..db1b62288 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -9064,6 +9064,43 @@ exports[`runs examples > example "ratio" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "register" example index 0 1`] = `
+[
+  "[ 0/1 → 1/8 | s:saw velocity:0 cutoff:0 ]",
+  "[ 1/8 → 1/4 | s:saw velocity:0.6852155700325966 cutoff:548.1724560260773 ]",
+  "[ 1/4 → 3/8 | s:saw velocity:0.36975969187915325 cutoff:295.8077535033226 ]",
+  "[ 3/8 → 1/2 | s:saw velocity:0.40139251574873924 cutoff:321.1140125989914 ]",
+  "[ 1/2 → 5/8 | s:saw velocity:0.2604806162416935 cutoff:208.3844929933548 ]",
+  "[ 5/8 → 3/4 | s:saw velocity:0.1356358677148819 cutoff:108.50869417190552 ]",
+  "[ 3/4 → 7/8 | s:saw velocity:0.19582648016512394 cutoff:156.66118413209915 ]",
+  "[ 7/8 → 1/1 | s:saw velocity:0.3976310808211565 cutoff:318.1048646569252 ]",
+  "[ 1/1 → 9/8 | s:saw velocity:0.5195421651005745 cutoff:415.6337320804596 ]",
+  "[ 9/8 → 5/4 | s:saw velocity:0.6724895145744085 cutoff:537.9916116595268 ]",
+  "[ 5/4 → 11/8 | s:saw velocity:0.7287282031029463 cutoff:582.982562482357 ]",
+  "[ 11/8 → 3/2 | s:saw velocity:0.18280375190079212 cutoff:146.2430015206337 ]",
+  "[ 3/2 → 13/8 | s:saw velocity:0.6084080748260021 cutoff:486.7264598608017 ]",
+  "[ 13/8 → 7/4 | s:saw velocity:0.49675471149384975 cutoff:397.4037691950798 ]",
+  "[ 7/4 → 15/8 | s:saw velocity:0.20473789609968662 cutoff:163.7903168797493 ]",
+  "[ 15/8 → 2/1 | s:saw velocity:0.5945571791380644 cutoff:475.6457433104515 ]",
+  "[ 2/1 → 17/8 | s:saw velocity:0.9595271199941635 cutoff:767.6216959953308 ]",
+  "[ 17/8 → 9/4 | s:saw velocity:0.9033902939409018 cutoff:722.7122351527214 ]",
+  "[ 9/4 → 19/8 | s:saw velocity:0.34548251144587994 cutoff:276.38600915670395 ]",
+  "[ 19/8 → 5/2 | s:saw velocity:0.8365066405385733 cutoff:669.2053124308586 ]",
+  "[ 5/2 → 21/8 | s:saw velocity:0.45861607417464256 cutoff:366.89285933971405 ]",
+  "[ 21/8 → 11/4 | s:saw velocity:0.16019348427653313 cutoff:128.1547874212265 ]",
+  "[ 11/4 → 23/8 | s:saw velocity:0.6332327704876661 cutoff:506.5862163901329 ]",
+  "[ 23/8 → 3/1 | s:saw velocity:0.01625417172908783 cutoff:13.003337383270264 ]",
+  "[ 3/1 → 25/8 | s:saw velocity:0.21728911064565182 cutoff:173.83128851652145 ]",
+  "[ 25/8 → 13/4 | s:saw velocity:0.34324387833476067 cutoff:274.59510266780853 ]",
+  "[ 13/4 → 27/8 | s:saw velocity:0.9923650715500116 cutoff:793.8920572400093 ]",
+  "[ 27/8 → 7/2 | s:saw velocity:0.40869180113077164 cutoff:326.9534409046173 ]",
+  "[ 7/2 → 29/8 | s:saw velocity:0.40994881466031075 cutoff:327.9590517282486 ]",
+  "[ 29/8 → 15/4 | s:saw velocity:0.9391485787928104 cutoff:751.3188630342484 ]",
+  "[ 15/4 → 31/8 | s:saw velocity:0.8121673222631216 cutoff:649.7338578104973 ]",
+  "[ 31/8 → 4/1 | s:saw velocity:0.7361665386706591 cutoff:588.9332309365273 ]",
+]
+`;
+
 exports[`runs examples > example "release" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c3 release:0 ]",

From 7e5a907ce57210783375268e76b482b31835c1bb Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Mon, 24 Nov 2025 18:41:25 -0600
Subject: [PATCH 065/110] Add a few more functions to autocomplete

---
 packages/core/pattern.mjs                 |  27 ++++-
 test/__snapshots__/examples.test.mjs.snap | 133 ++++++++++++++++++++++
 2 files changed, 155 insertions(+), 5 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 4753ebfd9..14b2b11e6 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -574,7 +574,8 @@ export class Pattern {
    * Returns a new Pattern, which only returns haps that meet the given test.
    * @param {Function} hap_test - a function which returns false for haps to be removed from the pattern
    * @returns Pattern
-   * @noAutocomplete
+   * @example
+   * s("bd*8").velocity(rand).filterHaps((h) => (h.whole.begin % 1) < h.value.velocity)
    */
   filterHaps(hap_test) {
     return new Pattern((state) => this.query(state).filter(hap_test));
@@ -585,12 +586,22 @@ export class Pattern {
    * inside haps.
    * @param {Function} value_test
    * @returns Pattern
-   * @noAutocomplete
+   * @synonyms filtval
+   * @example
+   * const drums = s("bd sd bd sd")
+   * kick: drums.filterValues((v) => v.s === 'bd').duck(2)
+   * snare: drums.filterValues((v) => v.s === 'sd')
+   * bass: s("saw!4").note("G#1").lpf(80).lpenv(4).orbit(2)
    */
   filterValues(value_test) {
     return new Pattern((state) => this.query(state).filter((hap) => value_test(hap.value))).setSteps(this._steps);
   }
 
+  // synonym
+  filtval(value_test) {
+    this.filterValues(value_test);
+  }
+
   /**
    * Returns a new pattern, with haps containing undefined values removed from
    * query results.
@@ -2665,8 +2676,13 @@ export const hsl = register('hsl', (h, s, l, pat) => {
 /**
  * Tags each Hap with an identifier. Good for filtering. The function populates Hap.context.tags (Array).
  * @name tag
- * @noAutocomplete
  * @param {string} tag anything unique
+ * @example
+ * s("saw!16").note("F1")
+ *   .lpf(tri.range(40, 80).slow(4)).lpenv(5).lpq(4).lpd(0.15)
+ *   .when(rand.late(0.1).gte(0.5), x => x.transpose("12").tag('altered'))
+ *   .when(rand.late(0.2).gte(0.5), x => x.s("square").tag('altered'))
+ *   .when("<0 1>", x => x.filter((hap) => hap.hasTag('altered')))
  */
 Pattern.prototype.tag = function (tag) {
   return this.withContext((ctx) => ({ ...ctx, tags: (ctx.tags || []).concat([tag]) }));
@@ -2677,15 +2693,16 @@ Pattern.prototype.tag = function (tag) {
  * @name filter
  * @param {Function} test function to test Hap
  * @example
- * s("hh!7 oh").filter(hap => hap.value.s==='hh')
+ * s("hh!7 oh").filter(hap => hap.value.s === 'hh')
  */
 export const filter = register('filter', (test, pat) => pat.withHaps((haps) => haps.filter(test)));
 
 /**
  * Filters haps by their begin time
  * @name filterWhen
- * @noAutocomplete
  * @param {Function} test function to test Hap.whole.begin
+ * @example
+ * oneCycle: s("bd*4").filterWhen((t) => t < 1)
  */
 export const filterWhen = register('filterWhen', (test, pat) => pat.filter((h) => test(h.whole.begin)));
 
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index db1b62288..68eae8243 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -4043,6 +4043,70 @@ exports[`runs examples > example "filter" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "filterHaps" example index 0 1`] = `
+[
+  "[ 1/8 → 1/4 | s:bd velocity:0.6852155700325966 ]",
+  "[ 1/4 → 3/8 | s:bd velocity:0.36975969187915325 ]",
+  "[ 3/8 → 1/2 | s:bd velocity:0.40139251574873924 ]",
+  "[ 1/1 → 9/8 | s:bd velocity:0.5195421651005745 ]",
+  "[ 9/8 → 5/4 | s:bd velocity:0.6724895145744085 ]",
+  "[ 5/4 → 11/8 | s:bd velocity:0.7287282031029463 ]",
+  "[ 3/2 → 13/8 | s:bd velocity:0.6084080748260021 ]",
+  "[ 2/1 → 17/8 | s:bd velocity:0.9595271199941635 ]",
+  "[ 17/8 → 9/4 | s:bd velocity:0.9033902939409018 ]",
+  "[ 9/4 → 19/8 | s:bd velocity:0.34548251144587994 ]",
+  "[ 19/8 → 5/2 | s:bd velocity:0.8365066405385733 ]",
+  "[ 3/1 → 25/8 | s:bd velocity:0.21728911064565182 ]",
+  "[ 25/8 → 13/4 | s:bd velocity:0.34324387833476067 ]",
+  "[ 13/4 → 27/8 | s:bd velocity:0.9923650715500116 ]",
+  "[ 27/8 → 7/2 | s:bd velocity:0.40869180113077164 ]",
+  "[ 29/8 → 15/4 | s:bd velocity:0.9391485787928104 ]",
+  "[ 15/4 → 31/8 | s:bd velocity:0.8121673222631216 ]",
+]
+`;
+
+exports[`runs examples > example "filterValues" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 1/4 → 1/2 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 1/2 → 3/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 3/4 → 1/1 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 1/1 → 5/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 5/4 → 3/2 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 3/2 → 7/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 7/4 → 2/1 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 2/1 → 9/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 9/4 → 5/2 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 5/2 → 11/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 11/4 → 3/1 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 3/1 → 13/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 13/4 → 7/2 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 7/2 → 15/4 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+  "[ 15/4 → 4/1 | s:saw note:G#1 cutoff:80 lpenv:4 orbit:2 ]",
+]
+`;
+
+exports[`runs examples > example "filterWhen" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | s:bd ]",
+  "[ 1/4 → 1/2 | s:bd ]",
+  "[ 1/2 → 3/4 | s:bd ]",
+  "[ 3/4 → 1/1 | s:bd ]",
+  "[ 1/1 → 5/4 | s:bd ]",
+  "[ 5/4 → 3/2 | s:bd ]",
+  "[ 3/2 → 7/4 | s:bd ]",
+  "[ 7/4 → 2/1 | s:bd ]",
+  "[ 2/1 → 9/4 | s:bd ]",
+  "[ 9/4 → 5/2 | s:bd ]",
+  "[ 5/2 → 11/4 | s:bd ]",
+  "[ 11/4 → 3/1 | s:bd ]",
+  "[ 3/1 → 13/4 | s:bd ]",
+  "[ 13/4 → 7/2 | s:bd ]",
+  "[ 7/2 → 15/4 | s:bd ]",
+  "[ 15/4 → 4/1 | s:bd ]",
+]
+`;
+
 exports[`runs examples > example "firstOf" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:g3 ]",
@@ -11749,6 +11813,75 @@ exports[`runs examples > example "sysexid" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "tag" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | s:square note:F1 cutoff:40 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 1/16 → 1/8 | s:square note:F1 cutoff:41.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 1/8 → 3/16 | s:square note:F1 cutoff:42.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 3/16 → 1/4 | s:square note:F1 cutoff:43.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 1/4 → 5/16 | s:square note:F1 cutoff:45 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 5/16 → 3/8 | s:square note:F1 cutoff:46.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 3/8 → 7/16 | s:square note:F1 cutoff:47.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 7/16 → 1/2 | s:square note:F1 cutoff:48.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 1/2 → 9/16 | s:square note:F1 cutoff:50 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 9/16 → 5/8 | s:square note:F1 cutoff:51.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 5/8 → 11/16 | s:square note:F1 cutoff:52.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 11/16 → 3/4 | s:square note:F1 cutoff:53.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 3/4 → 13/16 | s:square note:F1 cutoff:55 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 13/16 → 7/8 | s:square note:F1 cutoff:56.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 7/8 → 15/16 | s:square note:F1 cutoff:57.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 15/16 → 1/1 | s:square note:F1 cutoff:58.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 1/1 → 17/16 | s:saw note:F2 cutoff:60 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 17/16 → 9/8 | s:saw note:F2 cutoff:61.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 9/8 → 19/16 | s:saw note:F2 cutoff:62.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 19/16 → 5/4 | s:saw note:F2 cutoff:63.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 5/4 → 21/16 | s:saw note:F2 cutoff:65 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 21/16 → 11/8 | s:saw note:F2 cutoff:66.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 11/8 → 23/16 | s:saw note:F2 cutoff:67.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 23/16 → 3/2 | s:saw note:F2 cutoff:68.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 3/2 → 25/16 | s:saw note:F2 cutoff:70 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 25/16 → 13/8 | s:saw note:F2 cutoff:71.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 13/8 → 27/16 | s:saw note:F2 cutoff:72.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 27/16 → 7/4 | s:saw note:F2 cutoff:73.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 7/4 → 29/16 | s:saw note:F2 cutoff:75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 29/16 → 15/8 | s:saw note:F2 cutoff:76.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 15/8 → 31/16 | s:saw note:F2 cutoff:77.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 31/16 → 2/1 | s:saw note:F2 cutoff:78.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 2/1 → 33/16 | s:saw note:F1 cutoff:80 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 33/16 → 17/8 | s:saw note:F1 cutoff:78.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 17/8 → 35/16 | s:saw note:F1 cutoff:77.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 35/16 → 9/4 | s:saw note:F1 cutoff:76.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 9/4 → 37/16 | s:saw note:F1 cutoff:75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 37/16 → 19/8 | s:saw note:F1 cutoff:73.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 19/8 → 39/16 | s:saw note:F1 cutoff:72.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 39/16 → 5/2 | s:saw note:F1 cutoff:71.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 5/2 → 41/16 | s:saw note:F1 cutoff:70 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 41/16 → 21/8 | s:saw note:F1 cutoff:68.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 21/8 → 43/16 | s:saw note:F1 cutoff:67.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 43/16 → 11/4 | s:saw note:F1 cutoff:66.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 11/4 → 45/16 | s:saw note:F1 cutoff:65 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 45/16 → 23/8 | s:saw note:F1 cutoff:63.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 23/8 → 47/16 | s:saw note:F1 cutoff:62.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 47/16 → 3/1 | s:saw note:F1 cutoff:61.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 3/1 → 49/16 | s:square note:F1 cutoff:60 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 49/16 → 25/8 | s:square note:F1 cutoff:58.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 25/8 → 51/16 | s:square note:F1 cutoff:57.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 51/16 → 13/4 | s:square note:F1 cutoff:56.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 13/4 → 53/16 | s:square note:F1 cutoff:55 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 53/16 → 27/8 | s:square note:F1 cutoff:53.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 27/8 → 55/16 | s:square note:F1 cutoff:52.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 55/16 → 7/2 | s:square note:F1 cutoff:51.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 7/2 → 57/16 | s:square note:F1 cutoff:50 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 57/16 → 29/8 | s:square note:F1 cutoff:48.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 29/8 → 59/16 | s:square note:F1 cutoff:47.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 59/16 → 15/4 | s:square note:F1 cutoff:46.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 15/4 → 61/16 | s:square note:F1 cutoff:45 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 61/16 → 31/8 | s:square note:F1 cutoff:43.75 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 31/8 → 63/16 | s:square note:F1 cutoff:42.5 lpenv:5 resonance:4 lpdecay:0.15 ]",
+  "[ 63/16 → 4/1 | s:square note:F1 cutoff:41.25 lpenv:5 resonance:4 lpdecay:0.15 ]",
+]
+`;
+
 exports[`runs examples > example "take" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | s:bd ]",

From 39e7f700791bc92b3949a1ca721e64d002f94842 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Mon, 24 Nov 2025 18:43:47 -0600
Subject: [PATCH 066/110] Remove synonym

---
 packages/core/pattern.mjs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 14b2b11e6..9f5929a6d 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -586,7 +586,6 @@ export class Pattern {
    * inside haps.
    * @param {Function} value_test
    * @returns Pattern
-   * @synonyms filtval
    * @example
    * const drums = s("bd sd bd sd")
    * kick: drums.filterValues((v) => v.s === 'bd').duck(2)
@@ -597,11 +596,6 @@ export class Pattern {
     return new Pattern((state) => this.query(state).filter((hap) => value_test(hap.value))).setSteps(this._steps);
   }
 
-  // synonym
-  filtval(value_test) {
-    this.filterValues(value_test);
-  }
-
   /**
    * Returns a new pattern, with haps containing undefined values removed from
    * query results.

From 2bc208d8f5f92bfedc0c4445cda57f5b817c485c Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Mon, 24 Nov 2025 19:05:42 -0600
Subject: [PATCH 067/110] Use errorLogger for query and tonal errors

---
 packages/core/pattern.mjs |  4 ++--
 packages/tonal/tonal.mjs  | 13 +++++++++++--
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 4737f0db0..239195392 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -25,7 +25,7 @@ import {
   stringifyValues,
 } from './util.mjs';
 import drawLine from './drawLine.mjs';
-import { logger } from './logger.mjs';
+import { errorLogger, logger } from './logger.mjs';
 
 let stringParser;
 
@@ -414,7 +414,7 @@ export class Pattern {
     try {
       return this.query(new State(new TimeSpan(begin, end), controls));
     } catch (err) {
-      logger(`[query]: ${err.message}`, 'error');
+      errorLogger(err, 'query');
       return [];
     }
   }
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 427a66f4c..951f0f7e6 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -5,7 +5,16 @@ This program is free software: you can redistribute it and/or modify it under th
 */
 
 import { Note, Interval, Scale } from '@tonaljs/tonal';
-import { register, _mod, logger, isNote, noteToMidi, removeUndefineds, getAccidentalsOffset } from '@strudel/core';
+import {
+  _mod,
+  errorLogger,
+  getAccidentalsOffset,
+  isNote,
+  logger,
+  noteToMidi,
+  register,
+  removeUndefineds,
+} from '@strudel/core';
 import { stepInNamedScale, nearestNumberIndex } from './tonleiter.mjs';
 
 const octavesInterval = (octaves) => (octaves <= 0 ? -1 : 1) + octaves * 7 + 'P';
@@ -294,7 +303,7 @@ export const scale = register(
             }
             if (offset != 0) scaleNote = Note.transpose(scaleNote, Interval.fromSemitones(offset));
           } catch (err) {
-            logger(`[tonal] ${err.message}`, 'error');
+            errorLogger(err, 'tonal');
             return; // will be removed
           }
         }

From 89da9bbdb04dcd71c93ba241cc76c4f29f55c076 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Tue, 25 Nov 2025 10:31:53 +0000
Subject: [PATCH 068/110] [perf] in `noise`, let noiseMix do the disconnect
 when it exists

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

diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 768638f04..3b27bf6c1 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -493,7 +493,7 @@ export function getOscillator(s, t, value, onended) {
   }
 
   o.onended = () => {
-    o.disconnect();
+    noiseMix || o.disconnect();
     noiseMix?.node.disconnect();
     onended();
   };

From ab64451d65099f60e4deeb3caf4afb8e9db77b01 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Tue, 25 Nov 2025 10:49:30 +0000
Subject: [PATCH 069/110] [hydra] return the hydra object when await
 initHydra(..) is called

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 2cb265c2f..c13410121 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -35,6 +35,7 @@ export async function initHydra(options = {}) {
       hydra.synth.s0.init({ src: canvas });
     }
   }
+  return hydra;
 }
 
 export function clearHydra() {

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 070/110] 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 44dc91cdc..21a6d9624 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 d65b908bda4784975ae8cc57f23562a68798dc2a Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 25 Nov 2025 17:27:37 -0600
Subject: [PATCH 071/110] Disconnect lfos for phaser and filters

---
 packages/superdough/helpers.mjs    |  5 +++--
 packages/superdough/superdough.mjs | 35 ++++++++++++++++++++----------
 2 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index baa4db25e..ed2c0c448 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -240,6 +240,7 @@ export function createFilter(context, start, end, params, cps, cycle) {
     rate = cps * sync;
   }
   const hasLFO = [depth, depthfrequency, skew, shape, rate].some((v) => v !== undefined);
+  let lfo;
   if (hasLFO) {
     depth = depth ?? 1;
     const time = cycle / cps;
@@ -255,10 +256,10 @@ export function createFilter(context, start, end, params, cps, cycle) {
       time,
       curve: 1,
     };
-    getParamLfo(context, frequencyParam, start, end, lfoValues);
+    lfo = getParamLfo(context, frequencyParam, start, end, lfoValues);
   }
 
-  return filter;
+  return { filter, lfo };
 }
 
 // stays 1 until .5, then fades out
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 0db41c088..110f2b31d 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -287,7 +287,7 @@ export function connectToDestination(input, channels) {
 
 function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000, sweep = 2000) {
   const ac = getAudioContext();
-  const lfoGain = getLfo(ac, time, end, { frequency, depth: sweep * 2 });
+  const lfo = getLfo(ac, time, end, { frequency, depth: sweep * 2 });
 
   //filters
   const numStages = 2; //num of filters in series
@@ -300,14 +300,14 @@ function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000
     filter.frequency.value = centerFrequency + fOffset;
     filter.Q.value = 2 - Math.min(Math.max(depth * 2, 0), 1.9);
 
-    lfoGain.connect(filter.detune);
+    lfo.connect(filter.detune);
     fOffset += 282;
     if (i > 0) {
       filterChain[i - 1].connect(filter);
     }
     filterChain.push(filter);
   }
-  return filterChain[filterChain.length - 1];
+  return { filter: filterChain[filterChain.length - 1], lfo };
 }
 
 function getFilterType(ftype) {
@@ -561,9 +561,13 @@ 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, cycle);
-    chain.push(lp());
+    const { filter: lpf1, lfo: lfo1 } = lp();
+    chain.push(lpf1);
+    lfo1 && audioNodes.push(lfo1);
     if (ftype === '24db') {
-      chain.push(lp());
+      const { filter: lpf2, lfo: lfo2 } = lp();
+      chain.push(lpf2);
+      lfo2 && audioNodes.push(lfo2);
     }
   }
 
@@ -590,9 +594,13 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     const hpParams = pickAndRename(value, hpMap);
     hpParams.type = 'highpass';
     let hp = () => createFilter(ac, t, end, hpParams, cps, cycle);
-    chain.push(hp());
+    const { filter: hpf1, lfo: lfo1 } = hp();
+    chain.push(hpf1);
+    lfo1 && audioNodes.push(lfo1)
     if (ftype === '24db') {
-      chain.push(hp());
+      const { filter: hpf2, lfo: lfo2 } = hp();
+      chain.push(hpf2);
+      lfo2 && audioNodes.push(lfo2)
     }
   }
 
@@ -619,9 +627,13 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     const bpParams = pickAndRename(value, bpMap);
     bpParams.type = 'bandpass';
     let bp = () => createFilter(ac, t, end, bpParams, cps, cycle);
-    chain.push(bp());
+    const { filter: bpf1, lfo: lfo1 } = bp();
+    chain.push(bpf1);
+    lfo1 && audioNodes.push(lfo1)
     if (ftype === '24db') {
-      chain.push(bp());
+      const { filter: bpf2, lfo: lfo2 } = hp();
+      chain.push(bpf2);
+      lfo2 && audioNodes.push(lfo2)
     }
   }
 
@@ -685,8 +697,9 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   }
   // phaser
   if (phaser !== undefined && phaserdepth > 0) {
-    const phaserFX = getPhaser(t, endWithRelease, phaser, phaserdepth, phasercenter, phasersweep);
-    chain.push(phaserFX);
+    const { phaser, lfo } = getPhaser(t, endWithRelease, phaser, phaserdepth, phasercenter, phasersweep);
+    audioNodes.push(lfo);
+    chain.push(phaser);
   }
 
   // last gain

From 692359309f211cda7b5dd26a6cd20c208a6090b7 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 25 Nov 2025 17:31:11 -0600
Subject: [PATCH 072/110] Typo and formatting

---
 packages/superdough/superdough.mjs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 110f2b31d..5a8b72806 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -596,11 +596,11 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     let hp = () => createFilter(ac, t, end, hpParams, cps, cycle);
     const { filter: hpf1, lfo: lfo1 } = hp();
     chain.push(hpf1);
-    lfo1 && audioNodes.push(lfo1)
+    lfo1 && audioNodes.push(lfo1);
     if (ftype === '24db') {
       const { filter: hpf2, lfo: lfo2 } = hp();
       chain.push(hpf2);
-      lfo2 && audioNodes.push(lfo2)
+      lfo2 && audioNodes.push(lfo2);
     }
   }
 
@@ -629,11 +629,11 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     let bp = () => createFilter(ac, t, end, bpParams, cps, cycle);
     const { filter: bpf1, lfo: lfo1 } = bp();
     chain.push(bpf1);
-    lfo1 && audioNodes.push(lfo1)
+    lfo1 && audioNodes.push(lfo1);
     if (ftype === '24db') {
-      const { filter: bpf2, lfo: lfo2 } = hp();
+      const { filter: bpf2, lfo: lfo2 } = bp();
       chain.push(bpf2);
-      lfo2 && audioNodes.push(lfo2)
+      lfo2 && audioNodes.push(lfo2);
     }
   }
 

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 073/110] 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 31b83f5a3..891ae61fe 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 074/110] 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 891ae61fe..dfba1394a 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 075/110] 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 dfba1394a..1d5a8e7a6 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 84bac3582..aaa1a8e48 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 44ec79f77..0c0660117 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 01d4eb838..83b7b497a 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 076/110] 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 83b7b497a..3659edcd0 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 077/110] 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 0c0660117..48830541a 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 {

From d217119391f3f189869dc01134f981887d6ea297 Mon Sep 17 00:00:00 2001
From: Peter Egger <peterpf@duck.com>
Date: Sat, 22 Nov 2025 22:31:50 +0100
Subject: [PATCH 078/110] fix(tool/dbpatch): add missing package name

---
 tools/dbpatch/package.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tools/dbpatch/package.json b/tools/dbpatch/package.json
index 3ee042ad9..21d79e199 100644
--- a/tools/dbpatch/package.json
+++ b/tools/dbpatch/package.json
@@ -1,4 +1,5 @@
 {
+  "name": "dbpatch",
   "dependencies": {
     "csv": "^6.3.11"
   },

From f4b1baac878d99af91916fe27174f8b268320b33 Mon Sep 17 00:00:00 2001
From: Alex McLean <alex@slab.org>
Date: Thu, 27 Nov 2025 15:34:18 +0000
Subject: [PATCH 079/110] add revv() for reversing whole patterns

---
 packages/core/pattern.mjs                 | 19 ++++++++++++++++++-
 packages/core/test/pattern.test.mjs       | 12 ++++++++++++
 test/__snapshots__/examples.test.mjs.snap | 13 +++++++++++++
 3 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 4737f0db0..9a9ffe98f 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -2234,7 +2234,7 @@ export const brak = register('brak', function (pat) {
 });
 
 /**
- * Reverse all haps in a pattern
+ * Reverse all cycles in a pattern. See also `revv` for reversing a whole pattern.
  *
  * @name rev
  * @memberof Pattern
@@ -2266,6 +2266,23 @@ export const rev = register(
   true,
 );
 
+/**
+ * Reverse a whole pattern. See also `revv` for reversing each cycle.
+ *
+ * @name rev
+ * @memberof Pattern
+ * @returns Pattern
+ * @example
+ * // This is the same as `<[g e] [d c]>`. If `rev()` is used, you get
+ * // the same as `<[d c] [g e]>`, where each cycle reverses, but the order of
+ * // cycles stays the same.
+ * note("<[c d] [e g]>").revv()
+ */
+export const revv = register('revv', function (pat) {
+  const negateSpan = (span) => new TimeSpan(Fraction(0).sub(span.end), Fraction(0).sub(span.begin));
+  return pat.withQuerySpan(negateSpan).withHapSpan(negateSpan);
+});
+
 /** Like press, but allows you to specify the amount by which each
  * event is shifted. pressBy(0.5) is the same as press, while
  * pressBy(1/3) shifts each event by a third of its timespan.
diff --git a/packages/core/test/pattern.test.mjs b/packages/core/test/pattern.test.mjs
index 1df5c8776..408ff274b 100644
--- a/packages/core/test/pattern.test.mjs
+++ b/packages/core/test/pattern.test.mjs
@@ -586,6 +586,18 @@ describe('Pattern', () => {
           .map((a) => a.value),
       ).toStrictEqual(['c', 'b', 'a']);
     });
+    it('Does not reverse the order of cycles', () => {
+      expect(fastcat('a', 'b', 'c', 'd').slow(2).rev().fast(2).sortHapsByPart().firstCycle()).toStrictEqual(
+        fastcat('b', 'a', 'd', 'c').firstCycle(),
+      );
+    });
+  });
+  describe('revv()', () => {
+    it('Does reverse the order of cycles', () => {
+      expect(fastcat('a', 'b', 'c', 'd').slow(2).revv().fast(2).sortHapsByPart().firstCycle()).toStrictEqual(
+        fastcat('d', 'c', 'b', 'a').firstCycle(),
+      );
+    });
   });
   describe('sequence()', () => {
     it('Can work like fastcat', () => {
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 4fc037b19..064f4c2d5 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -9256,6 +9256,19 @@ exports[`runs examples > example "rev" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "rev" example index 0 2`] = `
+[
+  "[ 0/1 → 1/2 | note:g ]",
+  "[ 1/2 → 1/1 | note:e ]",
+  "[ 1/1 → 3/2 | note:d ]",
+  "[ 3/2 → 2/1 | note:c ]",
+  "[ 2/1 → 5/2 | note:g ]",
+  "[ 5/2 → 3/1 | note:e ]",
+  "[ 3/1 → 7/2 | note:d ]",
+  "[ 7/2 → 4/1 | note:c ]",
+]
+`;
+
 exports[`runs examples > example "ribbon" example index 0 1`] = `
 [
   "[ 0/1 → 1/1 | note:d ]",

From b824c45ba40eb99e434171995b02d8541b09890e Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 27 Nov 2025 21:11:50 +0100
Subject: [PATCH 080/110] Merge remote-tracking branch 'origin/main' into
 glossing/sounds-tab-preview

---
 packages/core/controls.mjs                    |  56 +-
 packages/core/pattern.mjs                     |   4 +-
 packages/core/repl.mjs                        |  21 +-
 packages/core/signal.mjs                      |   2 +-
 packages/hydra/hydra.mjs                      |   1 +
 packages/sampler/sample-server.mjs            |   4 +-
 packages/superdough/helpers.mjs               |  53 +-
 packages/superdough/noise.mjs                 |   3 +-
 packages/superdough/sampler.mjs               |   4 +-
 packages/superdough/superdough.mjs            |  13 +-
 packages/superdough/superdoughoutput.mjs      |   2 +-
 packages/superdough/synth.mjs                 |  24 +-
 packages/superdough/util.mjs                  |  10 +
 packages/superdough/vowel.mjs                 |  22 +-
 packages/superdough/wavetable.mjs             |   5 +-
 packages/superdough/worklets.mjs              |  11 +-
 packages/tonal/tonal.mjs                      |  13 +-
 test/__snapshots__/examples.test.mjs.snap     | 534 ++++++++++++++++--
 .../repl/components/button/action-button.jsx  |  31 +
 .../panel/ImportPrebakeScriptButton.jsx       |  29 +
 .../src/repl/components/panel/SettingsTab.jsx |  17 +-
 .../src/repl/components/panel/SoundsTab.jsx   |  13 +-
 website/src/repl/prebake.mjs                  |   2 +
 website/src/repl/useReplContext.jsx           |  20 +-
 website/src/repl/util.mjs                     |  11 +-
 website/src/settings.mjs                      |   5 +
 26 files changed, 777 insertions(+), 133 deletions(-)
 create mode 100644 website/src/repl/components/panel/ImportPrebakeScriptButton.jsx

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 9a2be7f44..21a6d9624 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,8 +1314,23 @@ 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');
+/**
+ * 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
@@ -1361,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
  *
@@ -1407,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
@@ -1820,12 +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").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');
+export const { octave, oct } = registerControl('octave', 'oct');
 
 // ['ophatdecay'],
 // TODO: example
@@ -1833,6 +1878,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(
@@ -1840,7 +1886,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
diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 4737f0db0..239195392 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -25,7 +25,7 @@ import {
   stringifyValues,
 } from './util.mjs';
 import drawLine from './drawLine.mjs';
-import { logger } from './logger.mjs';
+import { errorLogger, logger } from './logger.mjs';
 
 let stringParser;
 
@@ -414,7 +414,7 @@ export class Pattern {
     try {
       return this.query(new State(new TimeSpan(begin, end), controls));
     } catch (err) {
-      logger(`[query]: ${err.message}`, 'error');
+      errorLogger(err, 'query');
       return [];
     }
   }
diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 171697eb9..67028cb0c 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -152,9 +152,9 @@ export function repl({
         // allows muting a pattern x with x_ or _x
         return silence;
       }
-      if (id === '$') {
+      if (id.includes('$')) {
         // allows adding anonymous patterns with $:
-        id = `$${anonymousIndex}`;
+        id = `${id}${anonymousIndex}`;
         anonymousIndex++;
       }
       pPatterns[id] = this;
@@ -215,8 +215,19 @@ export function repl({
       let { pattern, meta } = await _evaluate(code, transpiler, transpilerOptions);
       if (Object.keys(pPatterns).length) {
         let patterns = [];
+        let soloActive = false;
         for (const [key, value] of Object.entries(pPatterns)) {
-          patterns.push(value.withState((state) => state.setControls({ id: key })));
+          // handle soloed patterns ex: S$: s("bd!4")
+          const isSolod = key.length > 1 && key.startsWith('S');
+          if (isSolod && soloActive === false) {
+            // first time we see a soloed pattern, clear existing patterns
+            patterns = [];
+            soloActive = true;
+          }
+          if (!soloActive || (soloActive && isSolod)) {
+            const valWithState = value.withState((state) => state.setControls({ id: key }));
+            patterns.push(valWithState);
+          }
         }
         if (eachTransform) {
           // Explicit lambda so only element (not index and array) are passed
@@ -227,8 +238,8 @@ export function repl({
         pattern = eachTransform(pattern);
       }
       if (allTransforms.length) {
-        for (let i in allTransforms) {
-          pattern = allTransforms[i](pattern);
+        for (const transform of allTransforms) {
+          pattern = transform(pattern);
         }
       }
 
diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 604d1c805..62fc26ad8 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -524,7 +524,7 @@ export const wchoose = (...pairs) => wchooseWith(rand, ...pairs);
  * @example
  * wchooseCycles(["bd",10], ["hh",1], ["sd",1]).s().fast(8)
  * @example
- * wchooseCycles(["bd bd bd",5], ["hh hh hh",3], ["sd sd sd",1]).fast(4).s()
+ * wchooseCycles(["c c c",5], ["a a a",3], ["f f f",1]).fast(4).note()
  * @example
  * // The probability can itself be a pattern
  * wchooseCycles(["bd(3,8)","<5 0>"], ["hh hh hh",3]).fast(4).s()
diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 2cb265c2f..c13410121 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -35,6 +35,7 @@ export async function initHydra(options = {}) {
       hydra.synth.s0.init({ src: canvas });
     }
   }
+  return hydra;
 }
 
 export function clearHydra() {
diff --git a/packages/sampler/sample-server.mjs b/packages/sampler/sample-server.mjs
index 31b83f5a3..1d5a8e7a6 100644
--- a/packages/sampler/sample-server.mjs
+++ b/packages/sampler/sample-server.mjs
@@ -9,6 +9,7 @@ import readline from 'readline';
 import os from 'os';
 
 const LOG = !!process.env.LOG || false;
+const PORT = process.env.PORT || 5432;
 const VALID_AUDIO_EXTENSIONS = ['wav', 'mp3', 'ogg'];
 
 const isAudioFile = (f) => {
@@ -54,7 +55,6 @@ async function getBanks(directory, flat = false) {
     banks[bank].push(subDir);
     return subDir;
   });
-  banks._base = `http://localhost:5432`;
   return { banks, files };
 }
 
@@ -134,8 +134,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();
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 47161ed61..baa4db25e 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -191,8 +191,7 @@ 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) {
+export function createFilter(context, start, end, params, cps, cycle) {
   let {
     frequency,
     anchor,
@@ -202,12 +201,14 @@ export function createFilter(context, start, end, params, cps) {
     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 });
@@ -238,8 +239,25 @@ export function createFilter(context, start, end, params, cps) {
   if (sync != null) {
     rate = cps * sync;
   }
-  const lfoValues = { depth, dcoffset, skew, shape, frequency: rate };
-  getParamLfo(context, frequencyParam, start, end, lfoValues);
+  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: modDepth,
+      dcoffset,
+      skew,
+      shape,
+      frequency: rate ?? cps,
+      min: -frequency + 30,
+      max: 20000 - frequency,
+      time,
+      curve: 1,
+    };
+    getParamLfo(context, frequencyParam, start, end, lfoValues);
+  }
+
   return filter;
 }
 
@@ -262,7 +280,15 @@ export function drywet(dry, wet, wetAmount = 0) {
   let mix = ac.createGain();
   dry_gain.connect(mix);
   wet_gain.connect(mix);
-  return mix;
+  return {
+    node: mix,
+    onended: () => {
+      dry_gain.disconnect(mix);
+      wet_gain.disconnect(mix);
+      dry.disconnect(dry_gain);
+      wet.disconnect(wet_gain);
+    },
+  };
 }
 
 let curves = ['linear', 'exponential'];
@@ -297,6 +323,10 @@ export function getVibratoOscillator(param, value, t) {
     gain.gain.value = vibmod * 100;
     vibratoOscillator.connect(gain);
     gain.connect(param);
+    vibratoOscillator.onended = () => {
+      gain.disconnect(param);
+      vibratoOscillator.disconnect(gain);
+    };
     vibratoOscillator.start(t);
     return vibratoOscillator;
   }
@@ -350,9 +380,9 @@ const mod = (freq, range = 1, type = 'sine') => {
   }
 
   osc.start();
-  const g = new GainNode(ctx, { gain: range });
+  const g = gainNode(range);
   osc.connect(g); // -range, range
-  return { node: g, stop: (t) => osc.stop(t) };
+  return { node: g, stop: (t) => osc.stop(t), osc: osc };
 };
 const fm = (frequencyparam, harmonicityRatio, modulationIndex, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
@@ -404,6 +434,11 @@ export function applyFM(param, value, begin) {
       modulator.connect(envGain);
       envGain.connect(param);
     }
+    fmmod.osc.onended = () => {
+      envGain.disconnect();
+      modulator.disconnect();
+      fmmod.osc.disconnect();
+    };
   }
   return { stop };
 }
@@ -505,7 +540,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
@@ -514,7 +549,7 @@ export const getFrequencyFromValue = (value, defaultNote = 36) => {
   if (!freq && typeof note === 'number') {
     freq = midiToFreq(note); // + 48);
   }
-
+  freq *= Math.pow(2, octave);
   return Number(freq);
 };
 
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 816dd252b..3e41515df 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -65,8 +65,9 @@ export function getNoiseOscillator(type = 'white', t, density = 0.02) {
 export function getNoiseMix(inputNode, wet, t) {
   const noiseOscillator = getNoiseOscillator('pink', t);
   const noiseMix = drywet(inputNode, noiseOscillator.node, wet);
+  noiseOscillator.node.onended = () => noiseMix.onended();
   return {
-    node: noiseMix,
+    node: noiseMix.node,
     stop: (time) => noiseOscillator?.stop(time),
   };
 }
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index 84bac3582..aaa1a8e48 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/superdough.mjs b/packages/superdough/superdough.mjs
index 73fece4f5..d4a10531b 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -553,13 +553,14 @@ 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',
     };
     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());
@@ -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());
@@ -665,6 +668,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);
   }
 
@@ -692,7 +696,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   // delay
   if (delay > 0 && delaytime > 0 && delayfeedback > 0) {
     orbitBus.getDelay(delaytime, delayfeedback, t);
-    orbitBus.sendDelay(post, delay);
+    const send = orbitBus.sendDelay(post, delay);
+    audioNodes.push(send);
   }
   // reverb
   if (room > 0) {
diff --git a/packages/superdough/superdoughoutput.mjs b/packages/superdough/superdoughoutput.mjs
index a4235efd0..d8ead7d06 100644
--- a/packages/superdough/superdoughoutput.mjs
+++ b/packages/superdough/superdoughoutput.mjs
@@ -82,7 +82,7 @@ export class Orbit {
   }
 
   sendDelay(node, amount) {
-    effectSend(node, this.delayNode, amount);
+    return effectSend(node, this.delayNode, amount);
   }
 
   duck(t, onsettime = 0, attacktime = 0.1, depth = 1) {
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 10df1776b..768638f04 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -48,19 +48,17 @@ export function registerSynthSounds() {
           [0.001, 0.05, 0.6, 0.01],
         );
 
-        let sound = getOscillator(s, t, value);
-        let { node: o, stop, triggerRelease } = sound;
-
         // turn down
         const g = gainNode(0.3);
 
-        const { duration } = value;
-
-        o.onended = () => {
-          o.disconnect();
+        let sound = getOscillator(s, t, value, () => {
           g.disconnect();
           onended();
-        };
+        });
+
+        let { node: o, stop, triggerRelease } = sound;
+
+        const { duration } = value;
 
         const envGain = gainNode(1);
         let node = o.connect(g).connect(envGain);
@@ -460,7 +458,7 @@ export function waveformN(partials, phases, type) {
 }
 
 // expects one of waveforms as s
-export function getOscillator(s, t, value) {
+export function getOscillator(s, t, value, onended) {
   const { duration, noise = 0 } = value;
   const partials = value.partials ?? value.n;
   let o;
@@ -482,7 +480,6 @@ export function getOscillator(s, t, value) {
   }
   // set frequency
   o.frequency.value = getFrequencyFromValue(value);
-  o.start(t);
 
   let vibratoOscillator = getVibratoOscillator(o.detune, value, t);
 
@@ -495,6 +492,13 @@ export function getOscillator(s, t, value) {
     noiseMix = getNoiseMix(o, noise, t);
   }
 
+  o.onended = () => {
+    o.disconnect();
+    noiseMix?.node.disconnect();
+    onended();
+  };
+  o.start(t);
+
   return {
     node: noiseMix?.node || o,
     stop: (time) => {
diff --git a/packages/superdough/util.mjs b/packages/superdough/util.mjs
index 44ec79f77..48830541a 100644
--- a/packages/superdough/util.mjs
+++ b/packages/superdough/util.mjs
@@ -114,3 +114,13 @@ export function getCommonSampleInfo(hapValue, bank) {
 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/vowel.mjs b/packages/superdough/vowel.mjs
index 3f30aef1e..fda0c6479 100644
--- a/packages/superdough/vowel.mjs
+++ b/packages/superdough/vowel.mjs
@@ -45,7 +45,8 @@ if (typeof GainNode !== 'undefined') {
         throw new Error('vowel: unknown vowel ' + letter);
       }
       const { gains, qs, freqs } = vowelFormant[letter];
-      const makeupGain = ac.createGain();
+      this.makeupGain = ac.createGain();
+      this.audioNodes = [];
       for (let i = 0; i < 5; i++) {
         const gain = ac.createGain();
         gain.gain.value = gains[i];
@@ -53,14 +54,25 @@ if (typeof GainNode !== 'undefined') {
         filter.type = 'bandpass';
         filter.Q.value = qs[i];
         filter.frequency.value = freqs[i];
-        this.connect(filter);
+        super.connect(filter);
         filter.connect(gain);
-        gain.connect(makeupGain);
+        this.audioNodes.push(filter);
+        gain.connect(this.makeupGain);
+        this.audioNodes.push(gain);
       }
-      makeupGain.gain.value = 8; // how much makeup gain to add?
-      this.connect = (target) => makeupGain.connect(target);
+      this.makeupGain.gain.value = 8; // how much makeup gain to add?
       return this;
     }
+    connect(target) {
+      this.makeupGain.connect(target);
+    }
+    disconnect() {
+      this.makeupGain.disconnect();
+      this.audioNodes.forEach((n) => n.disconnect());
+      super.disconnect();
+      this.makeupGain = null;
+      this.audioNodes = null;
+    }
   }
 
   AudioContext.prototype.createVowelFilter = function (letter) {
diff --git a/packages/superdough/wavetable.mjs b/packages/superdough/wavetable.mjs
index 01d4eb838..3659edcd0 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,
@@ -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}"`);
diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index 359bc833a..bf633a63b 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -532,7 +532,7 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
         const freqVoice = applySemitoneDetuneToFrequency(freq, detuner(n));
         // We must wrap this here because it is passed into sawblep below which
         // has domain [0, 1]
-        const dt = ffrac(freqVoice * INVSR);
+        const dt = frac(freqVoice * INVSR);
         this.phase[n] = this.phase[n] ?? Math.random();
         const v = waveshapes.sawblep(this.phase[n], dt);
 
@@ -543,8 +543,9 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
         if (pn >= 1.0) pn -= 1.0;
         this.phase[n] = pn;
         // invert right and left gain
+        const tmp = gainL;
         gainL = gainR;
-        gainR = gainL;
+        gainR = tmp;
       }
     }
     return true;
@@ -1338,7 +1339,7 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
       const tablePos = clamp(pv(parameters.position, i), 0, 1);
       const idx = tablePos * (this.numFrames - 1);
       const fIdx = idx | 0;
-      const frac = idx - fIdx;
+      const interpT = idx - fIdx;
       const warpAmount = clamp(pv(parameters.warp, i), 0, 1);
       const warpMode = pv(parameters.warpMode, i);
       const phaseRand = clamp(pv(parameters.phaserand, i), 0, 1);
@@ -1368,13 +1369,13 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
         const ph = this._warpPhase(this.phase[n], warpAmount, warpMode);
         const s0 = this._sampleFrame(table[fIdx], ph);
         const s1 = this._sampleFrame(table[Math.min(this.numFrames - 1, fIdx + 1)], ph);
-        let s = s0 + (s1 - s0) * frac;
+        let s = lerp(s0, s1, interpT);
         if (warpMode === WarpMode.FLIP && this.phase[n] < warpAmount) {
           s = -s;
         }
         outL[i] += s * gainL * normalizer;
         outR[i] += s * gainR * normalizer;
-        this.phase[n] = ffrac(this.phase[n] + dPhase);
+        this.phase[n] = frac(this.phase[n] + dPhase);
       }
     }
     return true;
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 427a66f4c..951f0f7e6 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -5,7 +5,16 @@ This program is free software: you can redistribute it and/or modify it under th
 */
 
 import { Note, Interval, Scale } from '@tonaljs/tonal';
-import { register, _mod, logger, isNote, noteToMidi, removeUndefineds, getAccidentalsOffset } from '@strudel/core';
+import {
+  _mod,
+  errorLogger,
+  getAccidentalsOffset,
+  isNote,
+  logger,
+  noteToMidi,
+  register,
+  removeUndefineds,
+} from '@strudel/core';
 import { stepInNamedScale, nearestNumberIndex } from './tonleiter.mjs';
 
 const octavesInterval = (octaves) => (octaves <= 0 ? -1 : 1) + octaves * 7 + 'P';
@@ -294,7 +303,7 @@ export const scale = register(
             }
             if (offset != 0) scaleNote = Note.transpose(scaleNote, Interval.fromSemitones(offset));
           } catch (err) {
-            logger(`[tonal] ${err.message}`, 'error');
+            errorLogger(err, 'tonal');
             return; // will be removed
           }
         }
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 32e61c31d..4fc037b19 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 ]",
@@ -5969,6 +6107,144 @@ 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 "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 ]",
@@ -6157,6 +6433,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 +6544,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 ]",
@@ -6888,18 +7302,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 ]",
 ]
 `;
 
@@ -12484,54 +12898,54 @@ exports[`runs examples > example "wchooseCycles" example index 0 1`] = `
 
 exports[`runs examples > example "wchooseCycles" example index 1 1`] = `
 [
-  "[ 0/1 → 1/12 | s:bd ]",
-  "[ 1/12 → 1/6 | s:bd ]",
-  "[ 1/6 → 1/4 | s:bd ]",
-  "[ 1/4 → 1/3 | s:bd ]",
-  "[ 1/3 → 5/12 | s:bd ]",
-  "[ 5/12 → 1/2 | s:bd ]",
-  "[ 1/2 → 7/12 | s:sd ]",
-  "[ 7/12 → 2/3 | s:sd ]",
-  "[ 2/3 → 3/4 | s:sd ]",
-  "[ 3/4 → 5/6 | s:bd ]",
-  "[ 5/6 → 11/12 | s:bd ]",
-  "[ 11/12 → 1/1 | s:bd ]",
-  "[ 1/1 → 13/12 | s:bd ]",
-  "[ 13/12 → 7/6 | s:bd ]",
-  "[ 7/6 → 5/4 | s:bd ]",
-  "[ 5/4 → 4/3 | s:bd ]",
-  "[ 4/3 → 17/12 | s:bd ]",
-  "[ 17/12 → 3/2 | s:bd ]",
-  "[ 3/2 → 19/12 | s:hh ]",
-  "[ 19/12 → 5/3 | s:hh ]",
-  "[ 5/3 → 7/4 | s:hh ]",
-  "[ 7/4 → 11/6 | s:bd ]",
-  "[ 11/6 → 23/12 | s:bd ]",
-  "[ 23/12 → 2/1 | s:bd ]",
-  "[ 2/1 → 25/12 | s:hh ]",
-  "[ 25/12 → 13/6 | s:hh ]",
-  "[ 13/6 → 9/4 | s:hh ]",
-  "[ 9/4 → 7/3 | s:hh ]",
-  "[ 7/3 → 29/12 | s:hh ]",
-  "[ 29/12 → 5/2 | s:hh ]",
-  "[ 5/2 → 31/12 | s:bd ]",
-  "[ 31/12 → 8/3 | s:bd ]",
-  "[ 8/3 → 11/4 | s:bd ]",
-  "[ 11/4 → 17/6 | s:bd ]",
-  "[ 17/6 → 35/12 | s:bd ]",
-  "[ 35/12 → 3/1 | s:bd ]",
-  "[ 3/1 → 37/12 | s:bd ]",
-  "[ 37/12 → 19/6 | s:bd ]",
-  "[ 19/6 → 13/4 | s:bd ]",
-  "[ 13/4 → 10/3 | s:sd ]",
-  "[ 10/3 → 41/12 | s:sd ]",
-  "[ 41/12 → 7/2 | s:sd ]",
-  "[ 7/2 → 43/12 | s:hh ]",
-  "[ 43/12 → 11/3 | s:hh ]",
-  "[ 11/3 → 15/4 | s:hh ]",
-  "[ 15/4 → 23/6 | s:bd ]",
-  "[ 23/6 → 47/12 | s:bd ]",
-  "[ 47/12 → 4/1 | s:bd ]",
+  "[ 0/1 → 1/12 | note:c ]",
+  "[ 1/12 → 1/6 | note:c ]",
+  "[ 1/6 → 1/4 | note:c ]",
+  "[ 1/4 → 1/3 | note:c ]",
+  "[ 1/3 → 5/12 | note:c ]",
+  "[ 5/12 → 1/2 | note:c ]",
+  "[ 1/2 → 7/12 | note:f ]",
+  "[ 7/12 → 2/3 | note:f ]",
+  "[ 2/3 → 3/4 | note:f ]",
+  "[ 3/4 → 5/6 | note:c ]",
+  "[ 5/6 → 11/12 | note:c ]",
+  "[ 11/12 → 1/1 | note:c ]",
+  "[ 1/1 → 13/12 | note:c ]",
+  "[ 13/12 → 7/6 | note:c ]",
+  "[ 7/6 → 5/4 | note:c ]",
+  "[ 5/4 → 4/3 | note:c ]",
+  "[ 4/3 → 17/12 | note:c ]",
+  "[ 17/12 → 3/2 | note:c ]",
+  "[ 3/2 → 19/12 | note:a ]",
+  "[ 19/12 → 5/3 | note:a ]",
+  "[ 5/3 → 7/4 | note:a ]",
+  "[ 7/4 → 11/6 | note:c ]",
+  "[ 11/6 → 23/12 | note:c ]",
+  "[ 23/12 → 2/1 | note:c ]",
+  "[ 2/1 → 25/12 | note:a ]",
+  "[ 25/12 → 13/6 | note:a ]",
+  "[ 13/6 → 9/4 | note:a ]",
+  "[ 9/4 → 7/3 | note:a ]",
+  "[ 7/3 → 29/12 | note:a ]",
+  "[ 29/12 → 5/2 | note:a ]",
+  "[ 5/2 → 31/12 | note:c ]",
+  "[ 31/12 → 8/3 | note:c ]",
+  "[ 8/3 → 11/4 | note:c ]",
+  "[ 11/4 → 17/6 | note:c ]",
+  "[ 17/6 → 35/12 | note:c ]",
+  "[ 35/12 → 3/1 | note:c ]",
+  "[ 3/1 → 37/12 | note:c ]",
+  "[ 37/12 → 19/6 | note:c ]",
+  "[ 19/6 → 13/4 | note:c ]",
+  "[ 13/4 → 10/3 | note:f ]",
+  "[ 10/3 → 41/12 | note:f ]",
+  "[ 41/12 → 7/2 | note:f ]",
+  "[ 7/2 → 43/12 | note:a ]",
+  "[ 43/12 → 11/3 | note:a ]",
+  "[ 11/3 → 15/4 | note:a ]",
+  "[ 15/4 → 23/6 | note:c ]",
+  "[ 23/6 → 47/12 | note:c ]",
+  "[ 47/12 → 4/1 | note:c ]",
 ]
 `;
 
diff --git a/website/src/repl/components/button/action-button.jsx b/website/src/repl/components/button/action-button.jsx
index d589b7bed..de674b696 100644
--- a/website/src/repl/components/button/action-button.jsx
+++ b/website/src/repl/components/button/action-button.jsx
@@ -8,3 +8,34 @@ export function ActionButton({ children, label, labelIsHidden, className, ...but
     </button>
   );
 }
+
+export function SpecialActionButton(props) {
+  const { className, ...buttonProps } = props;
+
+  return (
+    <ActionButton
+      {...buttonProps}
+      className={cx('bg-background p-2 max-w-[300px] rounded-md hover:opacity-50', className)}
+    />
+  );
+}
+
+export function ActionInput({ label, className, ...props }) {
+  return (
+    <label className={cx('inline-flex items-center cursor-pointer', className)}>
+      <input {...props} className="sr-only peer" />
+
+      <span className="inline-flex items-center peer-hover:opacity-50">{label}</span>
+    </label>
+  );
+}
+
+export function SpecialActionInput({ className, ...props }) {
+  return (
+    <ActionInput
+      {...props}
+      className={className}
+      label={<span className="bg-background p-2 max-w-[300px] rounded-md">{props.label}</span>}
+    />
+  );
+}
diff --git a/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
new file mode 100644
index 000000000..c997f6b6e
--- /dev/null
+++ b/website/src/repl/components/panel/ImportPrebakeScriptButton.jsx
@@ -0,0 +1,29 @@
+import { errorLogger } from '@strudel/core';
+import { useSettings, storePrebakeScript } from '../../../settings.mjs';
+import { SpecialActionInput } from '../button/action-button';
+
+async function importScript(script) {
+  const reader = new FileReader();
+  reader.readAsText(script);
+
+  reader.onload = () => {
+    const text = reader.result;
+    storePrebakeScript(text);
+  };
+
+  reader.onerror = () => {
+    errorLogger(new Error('failed to import prebake script'), 'importScript');
+  };
+}
+export function ImportPrebakeScriptButton() {
+  const settings = useSettings();
+
+  return (
+    <SpecialActionInput
+      type="file"
+      label="import prebake script"
+      accept=".strudel"
+      onChange={(e) => importScript(e.target.files[0])}
+    />
+  );
+}
diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index 85991f55c..f46fa661c 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -7,6 +7,8 @@ import { AudioDeviceSelector } from './AudioDeviceSelector.jsx';
 import { AudioEngineTargetSelector } from './AudioEngineTargetSelector.jsx';
 import { confirmDialog } from '../../util.mjs';
 import { DEFAULT_MAX_POLYPHONY, setMaxPolyphony, setMultiChannelOrbits } from '@strudel/webaudio';
+import { ActionButton, SpecialActionButton } from '../button/action-button.jsx';
+import { ImportPrebakeScriptButton } from './ImportPrebakeScriptButton.jsx';
 
 function Checkbox({ label, value, onChange, disabled = false }) {
   return (
@@ -113,6 +115,7 @@ export function SettingsTab({ started }) {
     isTabIndentationEnabled,
     isMultiCursorEnabled,
     patternAutoStart,
+    includePrebakeScriptInShare,
   } = useSettings();
   const shouldAlwaysSync = isUdels();
   const canChangeAudioDevice = AudioContext.prototype.setSinkId != null;
@@ -204,6 +207,15 @@ export function SettingsTab({ started }) {
           />
         </FormItem>
       </div>
+      <FormItem label="Prebake">
+        <ImportPrebakeScriptButton />
+        <Checkbox
+          label="Include prebake script in share"
+          onChange={(cbEvent) => settingsMap.setKey('includePrebakeScriptInShare', cbEvent.target.checked)}
+          value={includePrebakeScriptInShare}
+        />
+      </FormItem>
+
       <FormItem label="Keybindings">
         <ButtonGroup
           value={keybindings}
@@ -313,8 +325,7 @@ export function SettingsTab({ started }) {
       </FormItem>
       <FormItem label="Zen Mode">Try clicking the logo in the top left!</FormItem>
       <FormItem label="Reset Settings">
-        <button
-          className="bg-background p-2 max-w-[300px] rounded-md hover:opacity-50"
+        <SpecialActionButton
           onClick={() => {
             confirmDialog('Sure?').then((r) => {
               if (r) {
@@ -325,7 +336,7 @@ export function SettingsTab({ started }) {
           }}
         >
           restore default settings
-        </button>
+        </SpecialActionButton>
       </FormItem>
     </div>
   );
diff --git a/website/src/repl/components/panel/SoundsTab.jsx b/website/src/repl/components/panel/SoundsTab.jsx
index 61d4ba1ce..d965dce89 100644
--- a/website/src/repl/components/panel/SoundsTab.jsx
+++ b/website/src/repl/components/panel/SoundsTab.jsx
@@ -60,6 +60,7 @@ export function SoundsTab() {
 
   // holds mutable ref to current triggered sound
   const trigRef = useRef();
+  const numRef = useRef(0);
 
   // Used to cycle through sound previews on banks with multiple sounds
   let soundPreviewIdx = 0;
@@ -70,6 +71,14 @@ export function SoundsTab() {
     trigRef.current = undefined;
     ref?.stop?.(getAudioContext().currentTime + 0.01);
   });
+  useEvent('keydown', (e) => {
+    if (!isNaN(Number(e.key))) {
+      numRef.current = Number(e.key);
+    }
+  });
+  useEvent('keyup', (e) => {
+    numRef.current = 0;
+  });
   return (
     <div id="sounds-tab" className="px-4 flex gap-2 flex-col w-full h-full text-foreground">
       <Textbox placeholder="Search" value={search} onChange={(v) => setSearch(v)} />
@@ -119,7 +128,7 @@ export function SoundsTab() {
                 const params = {
                   note: ['synth', 'soundfont'].includes(data.type) ? 'a3' : undefined,
                   s: name,
-                  n: soundPreviewIdx,
+                  n: numRef.current,
                   clip: 1,
                   release: 0.5,
                   sustain: 1,
@@ -137,7 +146,7 @@ export function SoundsTab() {
                     trigRef.current = ref;
                     if (ref?.node) {
                       connectToDestination(ref.node);
-                      soundPreviewIdx++;
+                      // soundPreviewIdx++;
                       break;
                     }
                   } catch (err) {
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index 8a6ccc7e0..53a2a6003 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -3,6 +3,8 @@ import { aliasBank, registerSynthSounds, registerZZFXSounds, samples } from '@st
 import { registerSamplesFromDB } from './idbutils.mjs';
 import './piano.mjs';
 import './files.mjs';
+import { settingsMap } from '@src/settings.mjs';
+import { evaluate } from '@strudel/transpiler';
 
 const { BASE_URL } = import.meta.env;
 const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
diff --git a/website/src/repl/useReplContext.jsx b/website/src/repl/useReplContext.jsx
index ac30fe342..8dcb6b754 100644
--- a/website/src/repl/useReplContext.jsx
+++ b/website/src/repl/useReplContext.jsx
@@ -6,7 +6,7 @@ This program is free software: you can redistribute it and/or modify it under th
 
 import { code2hash, getPerformanceTimeSeconds, logger, silence } from '@strudel/core';
 import { getDrawContext } from '@strudel/draw';
-import { transpiler } from '@strudel/transpiler';
+import { evaluate, transpiler } from '@strudel/transpiler';
 import {
   getAudioContextCurrentTime,
   webaudioOutput,
@@ -63,11 +63,10 @@ async function getModule(name) {
 const initialCode = `// LOADING`;
 
 export function useReplContext() {
-  const { isSyncEnabled, audioEngineTarget } = useSettings();
+  const { isSyncEnabled, audioEngineTarget, prebakeScript, includePrebakeScriptInShare } = useSettings();
   const shouldUseWebaudio = audioEngineTarget !== audioEngineTargets.osc;
   const defaultOutput = shouldUseWebaudio ? webaudioOutput : superdirtOutput;
   const getTime = shouldUseWebaudio ? getAudioContextCurrentTime : getPerformanceTimeSeconds;
-
   const init = useCallback(() => {
     const drawTime = [-2, 2];
     const drawContext = getDrawContext();
@@ -84,7 +83,12 @@ export function useReplContext() {
       pattern: silence,
       drawTime,
       drawContext,
-      prebake: async () => Promise.all([modulesLoading, presets]),
+      prebake: async () =>
+        Promise.all([modulesLoading, presets]).then(() => {
+          if (prebakeScript?.length) {
+            return evaluate(prebakeScript ?? '');
+          }
+        }),
       onUpdateState: (state) => {
         setReplState({ ...state });
       },
@@ -214,7 +218,13 @@ export function useReplContext() {
     editorRef.current.repl.evaluate(code);
   };
 
-  const handleShare = async () => shareCode(replState.code);
+  const handleShare = async () => {
+    let code = replState.code;
+    if (includePrebakeScriptInShare) {
+      code = prebakeScript + '\n' + code;
+    }
+    shareCode(code);
+  };
   const context = {
     started,
     pending,
diff --git a/website/src/repl/util.mjs b/website/src/repl/util.mjs
index ac27158f4..4a7cb26a8 100644
--- a/website/src/repl/util.mjs
+++ b/website/src/repl/util.mjs
@@ -1,11 +1,10 @@
-import { evalScope, hash2code, logger } from '@strudel/core';
+import { code2hash, evalScope, hash2code, logger } from '@strudel/core';
 import { settingPatterns } from '../settings.mjs';
 import { setVersionDefaults } from '@strudel/webaudio';
 import { getMetadata } from '../metadata_parser';
 import { isTauri } from '../tauri.mjs';
 import './Repl.css';
 import { createClient } from '@supabase/supabase-js';
-import { nanoid } from 'nanoid';
 import { writeText } from '@tauri-apps/plugin-clipboard-manager';
 import { $featuredPatterns /* , loadDBPatterns */ } from '@src/user_pattern_utils.mjs';
 
@@ -109,9 +108,8 @@ export function confirmDialog(msg) {
   });
 }
 
-let lastShared;
-
 //RIP due to SPAM
+// let lastShared;
 // export async function shareCode(codeToShare) {
 //   // const codeToShare = activeCode || code;
 //   if (lastShared === codeToShare) {
@@ -146,9 +144,10 @@ let lastShared;
 //   });
 // }
 
-export async function shareCode() {
+export async function shareCode(codeToShare) {
   try {
-    const shareUrl = window.location.href;
+    const hash = '#' + code2hash(codeToShare);
+    const shareUrl = window.location.origin + window.location.pathname + hash;
     if (isTauri()) {
       await writeText(shareUrl);
     } else {
diff --git a/website/src/settings.mjs b/website/src/settings.mjs
index 7c62b0ded..8ec7d455a 100644
--- a/website/src/settings.mjs
+++ b/website/src/settings.mjs
@@ -45,11 +45,13 @@ export const defaultSettings = {
   isPanelOpen: true,
   togglePanelTrigger: 'click', //click | hover
   userPatterns: '{}',
+  prebakeScript: '',
   audioEngineTarget: audioEngineTargets.webaudio,
   isButtonRowHidden: false,
   isCSSAnimationDisabled: false,
   maxPolyphony: 128,
   multiChannelOrbits: false,
+  includePrebakeScriptInShare: true,
 };
 
 let search = null;
@@ -96,6 +98,7 @@ export function useSettings() {
     isPanelOpen: parseBoolean(state.isPanelOpen),
     userPatterns: userPatterns,
     multiChannelOrbits: parseBoolean(state.multiChannelOrbits),
+    includePrebakeScriptInShare: parseBoolean(state.includePrebakeScriptInShare),
     patternAutoStart: isUdels()
       ? false
       : state.patternAutoStart === undefined
@@ -108,6 +111,8 @@ export const setActiveFooter = (tab) => settingsMap.setKey('activeFooter', tab);
 export const setPanelPinned = (bool) => settingsMap.setKey('isPanelPinned', bool);
 export const setIsPanelOpened = (bool) => settingsMap.setKey('isPanelOpen', bool);
 
+export const storePrebakeScript = (script) => settingsMap.setKey('prebakeScript', script);
+
 export const setIsZen = (active) => settingsMap.setKey('isZen', !!active);
 
 const patternSetting = (key) =>

From 3c4ba667c84a46fcdd7f423d377c8eac8876af71 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 27 Nov 2025 21:29:37 +0100
Subject: [PATCH 081/110] cleanup

---
 website/src/repl/components/panel/SoundsTab.jsx | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/website/src/repl/components/panel/SoundsTab.jsx b/website/src/repl/components/panel/SoundsTab.jsx
index 44619a530..52fbf928c 100644
--- a/website/src/repl/components/panel/SoundsTab.jsx
+++ b/website/src/repl/components/panel/SoundsTab.jsx
@@ -62,9 +62,6 @@ export function SoundsTab() {
   const trigRef = useRef();
   const numRef = useRef(0);
 
-  // Used to cycle through sound previews on banks with multiple sounds
-  let soundPreviewIdx = 0;
-
   // stop current sound on mouseup
   useEvent('mouseup', () => {
     const ref = trigRef.current;

From 405338e4f05e46be01b706aeb951a215668036d2 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 27 Nov 2025 22:25:32 +0100
Subject: [PATCH 082/110] add CHANGELOG.md + basic script to generate

---
 CHANGELOG.md | 88 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 warm.js      | 14 +++++++++
 2 files changed, 102 insertions(+)
 create mode 100644 CHANGELOG.md
 create mode 100644 warm.js

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 000000000..a13e379d9
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,88 @@
+# changelog
+
+NOTE: you can generate this with `node warm.js`. it might still not be perfectly sorted...
+
+## november 2025
+
+- 2025-11-27T22:03:53+01:00 [perf] in `noise`, let noiseMix do the disconnect when it exists by jeromew in: [#1783](https://codeberg.org/uzu/strudel/pulls/1783) 
+- 2025-11-27T22:01:01+01:00 Bug Fix: Retries for sounds tab by glossing in: [#1754](https://codeberg.org/uzu/strudel/pulls/1754) 
+- 2025-11-27T20:36:46+01:00 [hydra] return the hydra object when await initHydra(..) is called by jeromew in: [#1784](https://codeberg.org/uzu/strudel/pulls/1784) 
+- 2025-11-27T20:36:14+01:00 Use errorLogger for query and tonal errors by glossing in: [#1782](https://codeberg.org/uzu/strudel/pulls/1782) 
+- 2025-11-27T20:27:10+01:00 [perf] level 5 `connect-leak` on `vowel` by jeromew in: [#1779](https://codeberg.org/uzu/strudel/pulls/1779) 
+- 2025-11-26T08:23:38+01:00 feat: add prebake script import button for loading .strudel files by daslyfe in: [#1774](https://codeberg.org/uzu/strudel/pulls/1774) 
+- 2025-11-26T07:39:28+01:00 Fix Sampler port trampling by Dayglo in: [#1717](https://codeberg.org/uzu/strudel/pulls/1717) 
+- 2025-11-25T20:59:09+01:00 Feat: Hook up octave and fix example by glossing in: [#1773](https://codeberg.org/uzu/strudel/pulls/1773) 
+- 2025-11-25T20:48:09+01:00 [perf] fix `connect-leak` in `tremolo` param by jeromew in: [#1780](https://codeberg.org/uzu/strudel/pulls/1780) 
+- 2025-11-24T17:51:20+01:00 filter modulation improvements! by daslyfe in: [#1769](https://codeberg.org/uzu/strudel/pulls/1769) 
+- 2025-11-24T01:20:53+01:00 Add o as a synonym for orbit by daslyfe in: [#1766](https://codeberg.org/uzu/strudel/pulls/1766) 
+- 2025-11-23T22:23:26+01:00 [perf] fix `connect-leak` in `fm` modulation by jeromew in: [#1758](https://codeberg.org/uzu/strudel/pulls/1758) 
+- 2025-11-23T09:47:24+01:00 Fix interoperability issue between `all` and `await initHydra()` by jeromew in: [#1663](https://codeberg.org/uzu/strudel/pulls/1663) 
+- 2025-11-23T04:23:06+01:00 Bug fix: Swap l/r gains with temp variable by glossing in: [#1768](https://codeberg.org/uzu/strudel/pulls/1768) 
+- 2025-11-23T00:52:28+01:00 FIX: prevent LFO filter modulation from popping from negative values by daslyfe in: [#1767](https://codeberg.org/uzu/strudel/pulls/1767) 
+- 2025-11-21T01:56:11+01:00 Bug Fix: Use frac due to negative frequencies from FM by glossing in: [#1759](https://codeberg.org/uzu/strudel/pulls/1759) 
+- 2025-11-20T19:48:16+01:00 [perf] fix `connect-leak` added by #1742 when noise() is not used by jeromew in: [#1757](https://codeberg.org/uzu/strudel/pulls/1757) 
+- 2025-11-20T14:51:00+01:00 [perf] fix `connect-leak` in `delay` effect by jeromew in: [#1755](https://codeberg.org/uzu/strudel/pulls/1755) 
+- 2025-11-20T14:49:41+01:00 [perf] fix `connect leak` when .noise() is in the mix by jeromew in: [#1742](https://codeberg.org/uzu/strudel/pulls/1742) 
+- 2025-11-18T23:52:45+01:00 wchooseCycles has now notes in an example by scrappy_fiddler in: [#1748](https://codeberg.org/uzu/strudel/pulls/1748) 
+- 2025-11-17T05:31:54+01:00 Feature: Partials by glossing in: [#1659](https://codeberg.org/uzu/strudel/pulls/1659) 
+- 2025-11-16T22:06:14+01:00 README: update superdough documentation by TristanMlct in: [#1741](https://codeberg.org/uzu/strudel/pulls/1741) 
+- 2025-11-16T21:08:54+01:00 Worklet optimizations by glossing in: [#1730](https://codeberg.org/uzu/strudel/pulls/1730) 
+- 2025-11-15T14:59:30+01:00 [perf] disconnect Offline AudioNode connections in generateReverb by jeromew in: [#1740](https://codeberg.org/uzu/strudel/pulls/1740) 
+- 2025-11-15T14:57:47+01:00 [perf] disconnect `send` effect AudioNode when `room` is used by jeromew in: [#1736](https://codeberg.org/uzu/strudel/pulls/1736) 
+- 2025-11-12T21:22:34+01:00 [supradough] fix: unstable filter by froos in: [#1593](https://codeberg.org/uzu/strudel/pulls/1593) 
+- 2025-11-12T21:12:07+01:00 Fix link syntax in `project-start` by Kissaki in: [#1724](https://codeberg.org/uzu/strudel/pulls/1724) 
+- 2025-11-12T21:06:13+01:00 Fix web README sample code by Kissaki in: [#1725](https://codeberg.org/uzu/strudel/pulls/1725) 
+- 2025-11-12T20:59:39+01:00 Fix typo: 'studel' -> 'strudel' by drhayes in: [#1726](https://codeberg.org/uzu/strudel/pulls/1726) 
+- 2025-11-12T15:23:41+01:00 fix for node 24 support in tests - #1718 by ausav in: [#1719](https://codeberg.org/uzu/strudel/pulls/1719) 
+- 2025-11-11T09:00:49+01:00 soundAlias example fix by PepsiiMan in: [#1720](https://codeberg.org/uzu/strudel/pulls/1720)
+- 2025-11-10T08:18:36+01:00 fix: Make Supradough package build by munshkr in: [#1711](https://codeberg.org/uzu/strudel/pulls/1711) 
+- 2025-11-10T08:18:00+01:00 added docs for spaces in scale names by ondras in: [#1715](https://codeberg.org/uzu/strudel/pulls/1715) 
+- 2025-11-10T02:44:01+01:00 Feature: LFOs for Filters by glossing in: [#1636](https://codeberg.org/uzu/strudel/pulls/1636)
+- 2025-11-05T17:07:00+01:00 improvement: sync midi messages to audio context clock by daslyfe in: [#1708](https://codeberg.org/uzu/strudel/pulls/1708) 
+- 2025-11-04T19:36:14+01:00 Add stick button mappings to gamepad implementation and improve docs by kaosuryoko in: [#1696](https://codeberg.org/uzu/strudel/pulls/1696) 
+- 2025-11-04T19:29:35+01:00 Refactor sound stopping and triggering logic in SoundsTab component by IJOL in: [#1688](https://codeberg.org/uzu/strudel/pulls/1688) 
+- 2025-11-04T19:13:21+01:00 Add setting to toggle pattern auto-start on pattern change by moumar in: [#1690](https://codeberg.org/uzu/strudel/pulls/1690) 
+- 2025-11-04T18:58:50+01:00 Voicings JSDoc by sharkeys_lunchbox in: [#1686](https://codeberg.org/uzu/strudel/pulls/1686)
+- 2025-11-01T07:50:40+01:00 FIX: Loading local samples uses too much memory by daslyfe in: [#1706](https://codeberg.org/uzu/strudel/pulls/1706) 
+
+ 
+## october 2025
+
+- 2025-10-28T22:58:24+01:00 Bug Fix: Handle scale-for-notes when n also supplied by glossing in: [#1625](https://codeberg.org/uzu/strudel/pulls/1625) 
+- 2025-10-28T22:51:16+01:00 Repurpose vim shortcuts for usability by dtricks in: [#1624](https://codeberg.org/uzu/strudel/pulls/1624) 
+- 2025-10-28T22:35:21+01:00 Add support for euclidian in mondo with `bd&3:8` by TristanCacqueray in: [#1630](https://codeberg.org/uzu/strudel/pulls/1630)
+- 2025-10-27T10:42:07+01:00 Use bunny cdn for all samples and json files by yaxu in: [#1701](https://codeberg.org/uzu/strudel/pulls/1701) 
+- 2025-10-26T22:52:54+01:00 degithub - switch some samples to bunnycdn by yaxu in: [#1697](https://codeberg.org/uzu/strudel/pulls/1697) 
+- 2025-10-26T17:09:22+01:00 Fix ZZFX example by moumar in: [#1685](https://codeberg.org/uzu/strudel/pulls/1685) 
+- 2025-10-23T15:56:04+02:00 Make osc port and host configurable. Changes dependencies. by yaxu in: [#1682](https://codeberg.org/uzu/strudel/pulls/1682) 
+- 2025-10-23T03:47:31+02:00 Adds back shape to superdough by glossing in: [#1672](https://codeberg.org/uzu/strudel/pulls/1672) 
+- 2025-10-22T22:15:19+02:00 Fix sampler.mjs githubPath by jeromew in: [#1684](https://codeberg.org/uzu/strudel/pulls/1684) 
+- 2025-10-22T16:20:50+02:00 Fix onPaint for widgets by yaxu in: [#1658](https://codeberg.org/uzu/strudel/pulls/1658) 
+- 2025-10-22T15:19:12+02:00 Fix a bug introduced by #4e17cfbdd6 by milliganf in: [#1679](https://codeberg.org/uzu/strudel/pulls/1679) 
+- 2025-10-18T04:29:20+02:00 Bug Fix: Wavetable: phase wrapping at 1 and detune by glossing in: [#1620](https://codeberg.org/uzu/strudel/pulls/1620) 
+- 2025-10-16T20:26:28+02:00 github samples: default to "samples" if repository is not specified by prezmop in: [#1644](https://codeberg.org/uzu/strudel/pulls/1644) 
+- 2025-10-16T17:33:39+02:00 Docs: add example of custom chained function by dariusk in: [#1642](https://codeberg.org/uzu/strudel/pulls/1642) 
+- 2025-10-14T12:39:48+02:00 textbox by yaxu in: [#1650](https://codeberg.org/uzu/strudel/pulls/1650) 
+- 2025-10-13T07:05:57+02:00 Feature: Wavetable FM by glossing in: [#1623](https://codeberg.org/uzu/strudel/pulls/1623) 
+- 2025-10-12T20:43:42+02:00 fix: repair REPL sample sources and URL concat (#1640) by erikfox in: [#1646](https://codeberg.org/uzu/strudel/pulls/1646)
+- 2025-10-10T11:25:02+02:00 Add control-metadata by yaxu in: [#1634](https://codeberg.org/uzu/strudel/pulls/1634) 
+- 2025-10-07T22:59:39+02:00 Fix MQTT: change the trigger handler to match new hap by jurrchen in: [#1629](https://codeberg.org/uzu/strudel/pulls/1629) 
+- 2025-10-05T21:42:19+02:00 Fix case sensitivity for synonym search by vvolhejn in: [#1618](https://codeberg.org/uzu/strudel/pulls/1618) 
+- 2025-10-01T08:56:35+02:00 Optimize wavetable synth by glossing in: [#1613](https://codeberg.org/uzu/strudel/pulls/1613) 
+- 2025-10-01T02:02:33+02:00 fix: pattern switching by daslyfe in: [#1616](https://codeberg.org/uzu/strudel/pulls/1616) 
+
+## September 2025
+
+- 2025-09-29T02:10:54+02:00 fix wavetable JSON by daslyfe in: [#1611](https://codeberg.org/uzu/strudel/pulls/1611) 
+- 2025-09-28T21:28:16+02:00 rename wavetable controls to match existing naming conventions by daslyfe in: [#1610](https://codeberg.org/uzu/strudel/pulls/1610) 
+- 2025-09-27T23:28:13+02:00 Feature: Wavetable synth improvements by glossing in: [#1607](https://codeberg.org/uzu/strudel/pulls/1607) 
+- 2025-09-27T21:43:10+02:00 wavetable improvements by daslyfe in: [#1608](https://codeberg.org/uzu/strudel/pulls/1608) 
+- 2025-09-26T08:48:46+02:00 create orbit based DJ filter by daslyfe in: [#1603](https://codeberg.org/uzu/strudel/pulls/1603) 
+- 2025-09-23T13:28:20+02:00 fix: time signal by daslyfe in: [#1583](https://codeberg.org/uzu/strudel/pulls/1583) 
+- 2025-09-21T16:16:06+02:00 mondo: fix all + setcpm + setcps by froos in: [#1600](https://codeberg.org/uzu/strudel/pulls/1600) 
+- 2025-09-19T21:59:43+02:00 fix: osc error message by froos in: [#1597](https://codeberg.org/uzu/strudel/pulls/1597) 
+- 2025-09-18T21:09:56+02:00 osc: --debug flag to see incoming messages by froos in: [#1595](https://codeberg.org/uzu/strudel/pulls/1595) 
+- 2025-09-17T14:12:10+02:00 simplify osc usage by froos in: [#1588](https://codeberg.org/uzu/strudel/pulls/1588) 
+- 2025-09-16T16:59:58+02:00 dev: logger errors to console in dev mode by daslyfe in: [#1585](https://codeberg.org/uzu/strudel/pulls/1585) 
+- 2025-09-15T22:52:14+02:00 add tic80 font by froos in: [#1579](https://codeberg.org/uzu/strudel/pulls/1579) 
+- 2025-09-15T00:00:19+02:00 supradough: fix delay + add some jsdoc types by froos in: [#1578](https://codeberg.org/uzu/strudel/pulls/1578) 
\ No newline at end of file
diff --git a/warm.js b/warm.js
new file mode 100644
index 000000000..0d148dee9
--- /dev/null
+++ b/warm.js
@@ -0,0 +1,14 @@
+fetch('https://codeberg.org/api/v1/repos/uzu/strudel/pulls?state=closed&page=1')
+  .then((res) => res.json())
+  .then((pulls) => {
+    const r = pulls
+      .filter((pull) => pull.merged)
+      .sort((a, b) => new Date(b.closed_at) - new Date(a.closed_at))
+      .map((pull) => `${pull.closed_at} ${pull.title} by ${pull.user.login || '?'} in: [#${pull.number}](${pull.url}) `)
+      .join('\n');
+    console.log(r);
+  });
+
+/*
+
+  */

From ec263925098dc168fd89834ca62d1cc9b0fd18a2 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 27 Nov 2025 22:53:38 +0100
Subject: [PATCH 083/110] fix: return silence when no pattern is returned

---
 packages/core/repl.mjs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 67028cb0c..4d59f5990 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -244,8 +244,7 @@ export function repl({
       }
 
       if (!isPattern(pattern)) {
-        const message = `got "${typeof evaluated}" instead of pattern`;
-        throw new Error(message + (typeof evaluated === 'function' ? ', did you forget to call a function?' : '.'));
+        pattern = silence;
       }
       logger(`[eval] code updated`);
       pattern = await setPattern(pattern, autostart);

From a6008e270097f28e012baaa97b2c8e21bb82f944 Mon Sep 17 00:00:00 2001
From: ndr0n <esquilofreniko@gmail.com>
Date: Fri, 28 Nov 2025 04:03:48 +0000
Subject: [PATCH 084/110] added export to getSuperdoughAudioController() so
 that its possible to route superdough audio on external application
 integrations.

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 0db41c088..5e9bb59da 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -274,7 +274,7 @@ export async function initAudioOnFirstClick(options) {
 }
 
 let controller;
-function getSuperdoughAudioController() {
+export function getSuperdoughAudioController() {
   if (controller == null) {
     controller = new SuperdoughAudioController(getAudioContext());
   }

From d84db1e663b2d89867700b60788f3ca54ffc4081 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 28 Nov 2025 10:02:57 +0100
Subject: [PATCH 085/110] hotfix: auto deploy to warm.strudel.cc when main
 changes

---
 .forgejo/workflows/deploy-warm-beta.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.forgejo/workflows/deploy-warm-beta.yml b/.forgejo/workflows/deploy-warm-beta.yml
index 2de6670c8..e6636a729 100644
--- a/.forgejo/workflows/deploy-warm-beta.yml
+++ b/.forgejo/workflows/deploy-warm-beta.yml
@@ -1,6 +1,9 @@
 name: Build and Deploy to beta (warm.strudel.cc)
 
-on: [workflow_dispatch]
+on:
+  push:
+    branches:
+      - main
 
 # Allow one concurrent deployment
 concurrency:

From 18dc4944bffff559fe686395eb487731088ed2e5 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 28 Nov 2025 12:36:23 -0600
Subject: [PATCH 086/110] Typos and cleanup

---
 packages/superdough/superdough.mjs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 5a8b72806..f54689acb 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -307,7 +307,7 @@ function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000
     }
     filterChain.push(filter);
   }
-  return { filter: filterChain[filterChain.length - 1], lfo };
+  return { phaser: filterChain[filterChain.length - 1], lfo };
 }
 
 function getFilterType(ftype) {
@@ -413,7 +413,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     release = 0,
 
     //phaser
-    phaserrate: phaser,
+    phaserrate,
     phaserdepth = getDefaultValue('phaserdepth'),
     phasersweep,
     phasercenter,
@@ -560,7 +560,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, cycle);
+    const lp = () => createFilter(ac, t, end, lpParams, cps, cycle);
     const { filter: lpf1, lfo: lfo1 } = lp();
     chain.push(lpf1);
     lfo1 && audioNodes.push(lfo1);
@@ -593,7 +593,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     };
     const hpParams = pickAndRename(value, hpMap);
     hpParams.type = 'highpass';
-    let hp = () => createFilter(ac, t, end, hpParams, cps, cycle);
+    const hp = () => createFilter(ac, t, end, hpParams, cps, cycle);
     const { filter: hpf1, lfo: lfo1 } = hp();
     chain.push(hpf1);
     lfo1 && audioNodes.push(lfo1);
@@ -626,7 +626,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     };
     const bpParams = pickAndRename(value, bpMap);
     bpParams.type = 'bandpass';
-    let bp = () => createFilter(ac, t, end, bpParams, cps, cycle);
+    const bp = () => createFilter(ac, t, end, bpParams, cps, cycle);
     const { filter: bpf1, lfo: lfo1 } = bp();
     chain.push(bpf1);
     lfo1 && audioNodes.push(lfo1);
@@ -696,8 +696,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     chain.push(panner);
   }
   // phaser
-  if (phaser !== undefined && phaserdepth > 0) {
-    const { phaser, lfo } = getPhaser(t, endWithRelease, phaser, phaserdepth, phasercenter, phasersweep);
+  if (phaserrate !== undefined && phaserdepth > 0) {
+    const { phaser, lfo } = getPhaser(t, endWithRelease, phaserrate, phaserdepth, phasercenter, phasersweep);
     audioNodes.push(lfo);
     chain.push(phaser);
   }

From cb591815edb75dcd0d52f0ef8f63f211b1c22dad Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Fri, 28 Nov 2025 21:35:35 +0000
Subject: [PATCH 087/110] fix copy paste errors

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

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 9a9ffe98f..88a0993c9 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -2267,9 +2267,9 @@ export const rev = register(
 );
 
 /**
- * Reverse a whole pattern. See also `revv` for reversing each cycle.
+ * Reverse a whole pattern. See also `rev` for reversing each cycle.
  *
- * @name rev
+ * @name revv
  * @memberof Pattern
  * @returns Pattern
  * @example

From 956598da18fbfd66256fbcb18e1225c31e32af30 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Fri, 28 Nov 2025 22:03:21 +0000
Subject: [PATCH 088/110] snapshot

---
 test/__snapshots__/examples.test.mjs.snap | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 064f4c2d5..e4b46b97f 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -9256,7 +9256,7 @@ exports[`runs examples > example "rev" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "rev" example index 0 2`] = `
+exports[`runs examples > example "revv" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | note:g ]",
   "[ 1/2 → 1/1 | note:e ]",

From b65cc2128feabf0a5909e652fe59058303aadbf1 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Sat, 29 Nov 2025 14:47:03 +0000
Subject: [PATCH 089/110] [perf] fix phaser leak of unused biquads

---
 packages/superdough/superdough.mjs | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 6f610d514..514c492cf 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -290,7 +290,7 @@ function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000
   const lfo = getLfo(ac, time, end, { frequency, depth: sweep * 2 });
 
   //filters
-  const numStages = 2; //num of filters in series
+  const numStages = 1; //num of filters in series
   let fOffset = 0;
   const filterChain = [];
   for (let i = 0; i < numStages; i++) {
@@ -302,12 +302,9 @@ function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000
 
     lfo.connect(filter.detune);
     fOffset += 282;
-    if (i > 0) {
-      filterChain[i - 1].connect(filter);
-    }
     filterChain.push(filter);
   }
-  return { phaser: filterChain[filterChain.length - 1], lfo };
+  return { phaser: filterChain, lfo };
 }
 
 function getFilterType(ftype) {
@@ -699,7 +696,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   if (phaserrate !== undefined && phaserdepth > 0) {
     const { phaser, lfo } = getPhaser(t, endWithRelease, phaserrate, phaserdepth, phasercenter, phasersweep);
     audioNodes.push(lfo);
-    chain.push(phaser);
+    Array.prototype.push.apply(chain, phaser);
   }
 
   // last gain

From 68b1cb87ca32ebcc9080a25abe5cf2019ffad24d Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Mon, 1 Dec 2025 15:29:19 +0000
Subject: [PATCH 090/110] [perf] release unused AudioBufferSourceNode +
 releaseAudioNode

---
 packages/superdough/helpers.mjs   | 31 +++++++++++++++++++++++++++----
 packages/superdough/sampler.mjs   | 16 +++++++++-------
 packages/superdough/synth.mjs     | 13 +++++--------
 packages/superdough/wavetable.mjs |  5 ++---
 packages/superdough/worklets.mjs  |  9 +++++----
 5 files changed, 48 insertions(+), 26 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index ed2c0c448..3e9b81135 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -554,10 +554,33 @@ export const getFrequencyFromValue = (value, defaultNote = 36) => {
   return Number(freq);
 };
 
-export const destroyAudioWorkletNode = (node) => {
-  if (node == null) {
-    return;
+export const releaseAudioNode = (node) => {
+  // check we received an AudioNode
+  if (!(node instanceof AudioNode)) {
+    throw new Error('releaseAudioNode can only release an AudioNode');
   }
+
+  // https://developer.mozilla.org/en-US/docs/Web/API/AudioNode/disconnect
   node.disconnect();
-  node.parameters.get('end')?.setValueAtTime(0, 0);
+
+  // make sure all AudioScheduledSourceNode is in a stopped state
+  // https://developer.mozilla.org/en-US/docs/Web/API/AudioScheduledSourceNode
+  if (node instanceof AudioScheduledSourceNode) {
+    try {
+      node.stop();
+    } catch (e) {
+      if (e instanceof DOMException && e.name === 'InvalidStateError') {
+        node.start(node.context.currentTime + 5); // will never happen
+        node.stop();
+      }
+    }
+  }
+
+  // https://www.w3.org/TR/webaudio-1.1/#AudioNode-actively-processing
+  // An AudioWorkletNode is actively processing when its AudioWorkletProcessor's [[callable process]]
+  // returns true and either its active source flag is true or
+  // any AudioNode connected to one of its inputs is actively processing.
+  if (node instanceof AudioWorkletNode) {
+    node.parameters.get('end')?.setValueAtTime(0, 0);
+  }
 };
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index aaa1a8e48..e066a2606 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -1,7 +1,7 @@
 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';
+import { getADSRValues, getParamADSR, getPitchEnvelope, getVibratoOscillator, releaseAudioNode } from './helpers.mjs';
 import { logger } from './logger.mjs';
 
 const bufferCache = {}; // string: Promise<ArrayBuffer>
@@ -286,17 +286,19 @@ export async function onTriggerSample(t, value, onended, bank, resolveUrl) {
 
   const { bufferSource, sliceDuration, offset } = await getSampleBufferSource(value, bank, resolveUrl);
 
-  // asny stuff above took too long?
-  if (ac.currentTime > t) {
-    logger(`[sampler] still loading sound "${s}:${n}"`, 'highlight');
-    // console.warn('sample still loading:', s, n);
-    return;
-  }
   if (!bufferSource) {
     logger(`[sampler] could not load "${s}:${n}"`, 'error');
     return;
   }
 
+  // async stuff above took too long?
+  if (ac.currentTime > t) {
+    logger(`[sampler] loading sound "${s}:${n}" took too long`, 'highlight');
+    // AudioBufferSourceNode will never be used. discard it
+    releaseAudioNode(bufferSource);
+    return;
+  }
+
   // vibrato
   let vibratoOscillator = getVibratoOscillator(bufferSource.detune, value, t);
 
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 3b27bf6c1..d50aebae2 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -3,7 +3,6 @@ import { registerSound, soundMap } from './superdough.mjs';
 import { getAudioContext } from './audioContext.mjs';
 import {
   applyFM,
-  destroyAudioWorkletNode,
   gainNode,
   getADSRValues,
   getFrequencyFromValue,
@@ -13,6 +12,7 @@ import {
   getVibratoOscillator,
   getWorklet,
   noises,
+  releaseAudioNode,
   webAudioTimeout,
 } from './helpers.mjs';
 import { logger } from './logger.mjs';
@@ -192,8 +192,7 @@ export function registerSynthSounds() {
       let timeoutNode = webAudioTimeout(
         ac,
         () => {
-          destroyAudioWorkletNode(o);
-          envGain.disconnect();
+          releaseAudioNode(o);
           onended();
           fm?.stop();
           vibratoOscillator?.stop();
@@ -270,8 +269,7 @@ export function registerSynthSounds() {
       let timeoutNode = webAudioTimeout(
         ac,
         () => {
-          destroyAudioWorkletNode(o);
-          envGain.disconnect();
+          releaseAudioNode(o);
           onended();
         },
         begin,
@@ -344,9 +342,8 @@ export function registerSynthSounds() {
       let timeoutNode = webAudioTimeout(
         ac,
         () => {
-          destroyAudioWorkletNode(o);
-          destroyAudioWorkletNode(lfo);
-          envGain.disconnect();
+          releaseAudioNode(o);
+          lfo && releaseAudioNode(lfo);
           onended();
           fm?.stop();
           vibratoOscillator?.stop();
diff --git a/packages/superdough/wavetable.mjs b/packages/superdough/wavetable.mjs
index 3659edcd0..e9d810414 100644
--- a/packages/superdough/wavetable.mjs
+++ b/packages/superdough/wavetable.mjs
@@ -3,13 +3,13 @@ import { getBaseURL, getCommonSampleInfo } from './util.mjs';
 import {
   applyFM,
   applyParameterModulators,
-  destroyAudioWorkletNode,
   getADSRValues,
   getFrequencyFromValue,
   getParamADSR,
   getPitchEnvelope,
   getVibratoOscillator,
   getWorklet,
+  releaseAudioNode,
   webAudioTimeout,
 } from './helpers.mjs';
 import { logger } from './logger.mjs';
@@ -319,10 +319,9 @@ export async function onTriggerSynth(t, value, onended, tables, cps, frameLen) {
   const timeoutNode = webAudioTimeout(
     ac,
     () => {
-      destroyAudioWorkletNode(source);
+      releaseAudioNode(source);
       vibratoOscillator?.stop();
       fm?.stop();
-      node.disconnect();
       wtPosModulators?.disconnect();
       wtWarpModulators?.disconnect();
       onended();
diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index bf633a63b..2f75453b9 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -508,13 +508,14 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
     ];
   }
   process(_input, outputs, params) {
-    if (currentTime <= params.begin[0]) {
-      return true;
-    }
     if (currentTime >= params.end[0]) {
-      // this.port.postMessage({ type: 'onended' });
+      // should terminate
       return false;
     }
+    if (currentTime <= params.begin[0]) {
+      // keep alive
+      return true;
+    }
     const output = outputs[0];
     const voices = params.voices[0]; // k-rate
     for (let i = 0; i < output[0].length; i++) {

From af7855402ff42f156758cedff87a041519a0417d Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Mon, 1 Dec 2025 20:43:55 +0000
Subject: [PATCH 091/110] Accept non-instanciated nodes for better developer
 experience

---
 packages/superdough/helpers.mjs | 2 ++
 packages/superdough/synth.mjs   | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 3e9b81135..3f57d0a52 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -555,6 +555,8 @@ export const getFrequencyFromValue = (value, defaultNote = 36) => {
 };
 
 export const releaseAudioNode = (node) => {
+  if (node == null) return;
+
   // check we received an AudioNode
   if (!(node instanceof AudioNode)) {
     throw new Error('releaseAudioNode can only release an AudioNode');
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index d50aebae2..b02354465 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -343,7 +343,7 @@ export function registerSynthSounds() {
         ac,
         () => {
           releaseAudioNode(o);
-          lfo && releaseAudioNode(lfo);
+          releaseAudioNode(lfo);
           onended();
           fm?.stop();
           vibratoOscillator?.stop();

From 0ec9826de548ac7ac0b9d22b58ae6a4f17da7b90 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Tue, 2 Dec 2025 09:29:50 +0000
Subject: [PATCH 092/110] onceEnded mechanism to clean audioNode.onended
 callbacks

---
 packages/soundfonts/fontloader.mjs |  5 ++--
 packages/superdough/helpers.mjs    | 46 ++++++++++++++++++------------
 packages/superdough/sampler.mjs    | 13 +++++++--
 packages/superdough/zzfx.mjs       |  7 +++--
 4 files changed, 45 insertions(+), 26 deletions(-)

diff --git a/packages/soundfonts/fontloader.mjs b/packages/soundfonts/fontloader.mjs
index 427f57e31..ca9e45d51 100644
--- a/packages/soundfonts/fontloader.mjs
+++ b/packages/soundfonts/fontloader.mjs
@@ -6,6 +6,7 @@ import {
   getADSRValues,
   getPitchEnvelope,
   getVibratoOscillator,
+  onceEnded,
 } from '@strudel/webaudio';
 import gm from './gm.mjs';
 
@@ -170,12 +171,12 @@ export function registerSoundfonts() {
 
         bufferSource.stop(envEnd);
         const stop = (releaseTime) => {};
-        bufferSource.onended = () => {
+        onceEnded(bufferSource, () => {
           bufferSource.disconnect();
           vibratoOscillator?.stop();
           node.disconnect();
           onended();
-        };
+        });
         return { node, stop };
       },
       { type: 'soundfont', prebake: true, fonts },
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 3f57d0a52..219c66d6f 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -349,20 +349,11 @@ export function webAudioTimeout(audioContext, onComplete, startTime, stopTime) {
   constantNode.connect(zeroGain);
 
   // Schedule the `onComplete` callback to occur at `stopTime`
-  constantNode.onended = () => {
-    // Ensure garbage collection
-    try {
-      zeroGain.disconnect();
-    } catch {
-      // pass
-    }
-    try {
-      constantNode.disconnect();
-    } catch {
-      // pass
-    }
+  onceEnded(constantNode, () => {
+    releaseAudioNode(zeroGain);
+    releaseAudioNode(constantNode);
     onComplete();
-  };
+  });
   constantNode.start(startTime);
   constantNode.stop(stopTime);
   return constantNode;
@@ -554,6 +545,17 @@ export const getFrequencyFromValue = (value, defaultNote = 36) => {
   return Number(freq);
 };
 
+// This helper should be used instead of the `node.onended = callback` pattern
+// It adds a mechanism to help minimize gc retention
+export const onceEnded = (node, callback) => {
+  let onended = callback;
+  node.onended = function cleanup() {
+    onended && onended();
+    onended = null;
+    this.onended = null;
+  };
+};
+
 export const releaseAudioNode = (node) => {
   if (node == null) return;
 
@@ -565,16 +567,24 @@ export const releaseAudioNode = (node) => {
   // https://developer.mozilla.org/en-US/docs/Web/API/AudioNode/disconnect
   node.disconnect();
 
-  // make sure all AudioScheduledSourceNode is in a stopped state
+  // make sure all AudioScheduledSourceNodes are in a stopped state
   // https://developer.mozilla.org/en-US/docs/Web/API/AudioScheduledSourceNode
   if (node instanceof AudioScheduledSourceNode) {
+    if (node.onended && node.onended.name !== 'cleanup') {
+      logger(
+        `[superdough] Deprecation warning: it seems your code path is setting 'node.onended = callback' instead of using the onceEnded helper`,
+      );
+    }
     try {
       node.stop();
     } catch (e) {
-      if (e instanceof DOMException && e.name === 'InvalidStateError') {
-        node.start(node.context.currentTime + 5); // will never happen
-        node.stop();
-      }
+      // At the stage, `start` was not called on the node
+      // but an `onended` callback releasing resources may exist
+      // and we want it to fire :
+      // - we force a start/stop cycle so that `onended` gets called
+      // - we `lock` the node so that no-one can start it
+      node.start(node.context.currentTime + 5); // will never happen
+      node.stop();
     }
   }
 
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index e066a2606..1e8c786bf 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -1,7 +1,14 @@
 import { getBaseURL, getCommonSampleInfo } from './util.mjs';
 import { registerSound, registerWaveTable } from './index.mjs';
 import { getAudioContext } from './audioContext.mjs';
-import { getADSRValues, getParamADSR, getPitchEnvelope, getVibratoOscillator, releaseAudioNode } from './helpers.mjs';
+import {
+  getADSRValues,
+  getParamADSR,
+  getPitchEnvelope,
+  getVibratoOscillator,
+  onceEnded,
+  releaseAudioNode,
+} from './helpers.mjs';
 import { logger } from './logger.mjs';
 
 const bufferCache = {}; // string: Promise<ArrayBuffer>
@@ -321,13 +328,13 @@ export async function onTriggerSample(t, value, onended, bank, resolveUrl) {
 
   const out = ac.createGain(); // we need a separate gain for the cutgroups because firefox...
   node.connect(out);
-  bufferSource.onended = function () {
+  onceEnded(bufferSource, function () {
     bufferSource.disconnect();
     vibratoOscillator?.stop();
     node.disconnect();
     out.disconnect();
     onended();
-  };
+  });
   let envEnd = holdEnd + release + 0.01;
   bufferSource.stop(envEnd);
   const stop = (endTime) => {
diff --git a/packages/superdough/zzfx.mjs b/packages/superdough/zzfx.mjs
index 32db0395a..4a4c58c9c 100644
--- a/packages/superdough/zzfx.mjs
+++ b/packages/superdough/zzfx.mjs
@@ -3,6 +3,7 @@ import { midiToFreq, noteToMidi } from './util.mjs';
 import { registerSound } from './superdough.mjs';
 import { getAudioContext } from './audioContext.mjs';
 import { buildSamples } from './zzfx_fork.mjs';
+import { onceEnded, releaseAudioNode } from './helpers.mjs';
 
 export const getZZFX = (value, t) => {
   let {
@@ -83,10 +84,10 @@ export function registerZZFXSounds() {
       wave,
       (t, value, onended) => {
         const { node: o } = getZZFX({ s: wave, ...value }, t);
-        o.onended = () => {
-          o.disconnect();
+        onceEnded(o, () => {
+          releaseAudioNode(o);
           onended();
-        };
+        });
         return {
           node: o,
           stop: () => {},

From 1d4f2b81d8bac8f37ed79f26ed936810f2c62627 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 3 Dec 2025 11:12:30 -0600
Subject: [PATCH 093/110] Switch back to explicit exports and use new release
 mechanism

---
 packages/core/controls.mjs      | 105 +++++++++++++++++++++++++++++---
 packages/superdough/helpers.mjs |  34 ++++-------
 2 files changed, 108 insertions(+), 31 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 8a848fec0..426fd7479 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -468,7 +468,7 @@ export const { attack, att } = registerControl('attack', 'att');
  * ._scope()
  *
  */
-Object.assign(globalThis, registerMultiControl(['fmh', 'fmi'], 8, 'fmh'));
+export const { fmh, fmh1, fmh2, fmh3, fmh4, fmh5, fmh6, fmh7, fmh8 } = registerMultiControl(['fmh', 'fmi'], 8, 'fmh');
 
 /**
  * Sets the Frequency Modulation of the synth.
@@ -492,7 +492,8 @@ Object.assign(globalThis, registerMultiControl(['fmh', 'fmi'], 8, 'fmh'));
  *  .fmh(1.06).fmh2(10).fmh3(0.1)
  *
  */
-Object.assign(globalThis, registerMultiControl(['fmi', 'fmh'], 8, 'fm'));
+export const { fmi, fmi1, fmi2, fmi3, fmi4, fmi5, fmi6, fmi7, fmi8, fm, fm1, fm2, fm3, fm4, fm5, fm6, fm7, fm8 } =
+  registerMultiControl(['fmi', 'fmh'], 8, 'fm');
 
 // fm envelope
 /**
@@ -512,7 +513,10 @@ Object.assign(globalThis, registerMultiControl(['fmi', 'fmh'], 8, 'fm'));
  * ._scope()
  *
  */
-Object.assign(globalThis, registerMultiControl('fmenv', 8));
+export const { fmenv, fmenv1, fmenv2, fmenv3, fmenv4, fmenv5, fmenv6, fmenv7, fmenv8 } = registerMultiControl(
+  'fmenv',
+  8,
+);
 
 /**
  * Attack time for the FM envelope: time it takes to reach maximum modulation
@@ -530,7 +534,26 @@ Object.assign(globalThis, registerMultiControl('fmenv', 8));
  * ._scope()
  *
  */
-Object.assign(globalThis, registerMultiControl('fmattack', 8, 'fmatt'));
+export const {
+  fmattack,
+  fmattack1,
+  fmattack2,
+  fmattack3,
+  fmattack4,
+  fmattack5,
+  fmattack6,
+  fmattack7,
+  fmattack8,
+  fmatt,
+  fmatt1,
+  fmatt2,
+  fmatt3,
+  fmatt4,
+  fmatt5,
+  fmatt6,
+  fmatt7,
+  fmatt8,
+} = registerMultiControl('fmattack', 8, 'fmatt');
 
 /**
  * Waveform of the fm modulator
@@ -546,7 +569,10 @@ Object.assign(globalThis, registerMultiControl('fmattack', 8, 'fmatt'));
  * n("0 1 2 3".fast(4)).chord("<Dm Am F G>").voicing().s("sawtooth").fmwave("brown").fm(.6)
  *
  */
-Object.assign(globalThis, registerMultiControl('fmwave', 8));
+export const { fmwave, fmwave1, fmwave2, fmwave3, fmwave4, fmwave5, fmwave6, fmwave7, fmwave8 } = registerMultiControl(
+  'fmwave',
+  8,
+);
 
 /**
  * Decay time for the FM envelope: seconds until the sustain level is reached after the attack phase.
@@ -565,7 +591,26 @@ Object.assign(globalThis, registerMultiControl('fmwave', 8));
  * ._scope()
  *
  */
-Object.assign(globalThis, registerMultiControl('fmdecay', 8, 'fmdec'));
+export const {
+  fmdecay,
+  fmdecay1,
+  fmdecay2,
+  fmdecay3,
+  fmdecay4,
+  fmdecay5,
+  fmdecay6,
+  fmdecay7,
+  fmdecay8,
+  fmdec,
+  fmdec1,
+  fmdec2,
+  fmdec3,
+  fmdec4,
+  fmdec5,
+  fmdec6,
+  fmdec7,
+  fmdec8,
+} = registerMultiControl('fmdecay', 8, 'fmdec');
 
 /**
  * Sustain level for the FM envelope: how much modulation is applied after the decay phase
@@ -584,7 +629,26 @@ Object.assign(globalThis, registerMultiControl('fmdecay', 8, 'fmdec'));
  * ._scope()
  *
  */
-Object.assign(globalThis, registerMultiControl('fmsustain', 8, 'fmsus'));
+export const {
+  fmsustain,
+  fmsustain1,
+  fmsustain2,
+  fmsustain3,
+  fmsustain4,
+  fmsustain5,
+  fmsustain6,
+  fmsustain7,
+  fmsustain8,
+  fmsus,
+  fmsus1,
+  fmsus2,
+  fmsus3,
+  fmsus4,
+  fmsus5,
+  fmsus6,
+  fmsus7,
+  fmsus8,
+} = registerMultiControl('fmsustain', 8, 'fmsus');
 
 /**
  * Release time for the FM envelope: how much modulation is applied after the note is released
@@ -597,12 +661,35 @@ Object.assign(globalThis, registerMultiControl('fmsustain', 8, 'fmsus'));
  * @param {number | Pattern} time release time
  *
  */
-Object.assign(globalThis, registerMultiControl('fmrelease', 8, 'fmrel'));
+export const {
+  fmrelease,
+  fmrelease1,
+  fmrelease2,
+  fmrelease3,
+  fmrelease4,
+  fmrelease5,
+  fmrelease6,
+  fmrelease7,
+  fmrelease8,
+  fmrel,
+  fmrel1,
+  fmrel2,
+  fmrel3,
+  fmrel4,
+  fmrel5,
+  fmrel6,
+  fmrel7,
+  fmrel8,
+} = registerMultiControl('fmrelease', 8, 'fmrel');
 
 // FM Matrix
+// Note: we do not declare top-level exports here since it would add
+// ~162 more explicit exports. This is likely fine as the most common use-case would be to at least
+// declare one other FM prior to utilizing the matrix functionality, but if we ever decide we need it,
+// TODO to add it explicitly / go with the globalThis approach
 for (let i = 0; i <= 8; i++) {
   for (let j = 0; j <= 8; j++) {
-    Object.assign(globalThis, registerControl(`fmi${i}${j}`, `fm${i}${j}`));
+    registerControl(`fmi${i}${j}`, `fm${i}${j}`);
   }
 }
 
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 073ed00bd..2080d32ed 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -372,13 +372,13 @@ const mod = (freq, type = 'sine') => {
     osc.frequency.value = freq;
   }
   osc.start();
-  return { osc, freq };
+  return osc;
 };
 
 const fm = (frequencyparam, harmonicityRatio, wave = 'sine') => {
   const carrfreq = frequencyparam.value;
   const modfreq = carrfreq * harmonicityRatio;
-  return mod(modfreq, wave);
+  return { osc: mod(modfreq, wave), freq: modfreq };
 };
 
 export function applyFM(param, value, begin) {
@@ -434,13 +434,12 @@ export function applyFM(param, value, begin) {
             toCleanup.push(envGain);
             output = osc.connect(envGain);
           }
-          fms[idx] = { input: osc.frequency, output, freq, toCleanup };
-          osc.onended = () => cleanupNodes(fms[idx].toCleanup);
+          fms[idx] = { input: osc.frequency, output, freq, osc, toCleanup };
         }
-        const { input, output, freq, toCleanup } = fms[idx];
+        const { input, output, freq, osc, toCleanup } = fms[idx];
         const g = gainNode(amt * freq);
         io.push(isMod ? output.connect(g) : input);
-        toCleanup.push(g);
+        cleanupOnEnd(osc, [...toCleanup, g]);
       }
       if (!io[1]) {
         logger(
@@ -451,11 +450,6 @@ export function applyFM(param, value, begin) {
       }
       io[0].connect(io[1]);
     }
-    fmmod.osc.onended = () => {
-      envGain.disconnect();
-      modulator.disconnect();
-      fmmod.osc.disconnect();
-    };
   }
   return {
     stop: (t) => toStop.forEach((m) => m?.stop(t)),
@@ -575,10 +569,9 @@ export const getFrequencyFromValue = (value, defaultNote = 36) => {
 // This helper should be used instead of the `node.onended = callback` pattern
 // It adds a mechanism to help minimize gc retention
 export const onceEnded = (node, callback) => {
-  let onended = callback;
+  const onended = callback;
   node.onended = function cleanup() {
     onended && onended();
-    onended = null;
     this.onended = null;
   };
 };
@@ -624,13 +617,10 @@ export const releaseAudioNode = (node) => {
   }
 };
 
-export const cleanupNode = (node, time) => {
-  if (node == null) return;
-  node.disconnect?.();
-  node.parameters?.get('end')?.setValueAtTime(0, 0);
-  node.stop?.(time);
-};
-
-export const cleanupNodes = (nodes, time) => {
-  nodes.forEach((n) => cleanupNode(n, time));
+// Once the `anchor` node has ended, release all nodes in `toCleanup`
+export const cleanupOnEnd = (anchor, toCleanup) => {
+  onceEnded(
+    anchor,
+    () => toCleanup.forEach((n) => releaseAudioNode(n)),
+  );
 };

From 196f70ab6bfa14613490dd1117d1e01ab48249c3 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 3 Dec 2025 11:13:21 -0600
Subject: [PATCH 094/110] Formatting

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

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 2080d32ed..0b696df9b 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -619,8 +619,5 @@ export const releaseAudioNode = (node) => {
 
 // Once the `anchor` node has ended, release all nodes in `toCleanup`
 export const cleanupOnEnd = (anchor, toCleanup) => {
-  onceEnded(
-    anchor,
-    () => toCleanup.forEach((n) => releaseAudioNode(n)),
-  );
+  onceEnded(anchor, () => toCleanup.forEach((n) => releaseAudioNode(n)));
 };

From 0b711e879c767ab1c4bfba7af0c655d28da70f8c Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 4 Dec 2025 08:23:36 +0000
Subject: [PATCH 095/110] Improve naming & backward compat

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 514c492cf..191665498 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -291,7 +291,7 @@ function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000
 
   //filters
   const numStages = 1; //num of filters in series
-  let fOffset = 0;
+  let fOffset = 282; //for backward compat in #1800
   const filterChain = [];
   for (let i = 0; i < numStages; i++) {
     const filter = ac.createBiquadFilter();
@@ -304,7 +304,7 @@ function getPhaser(time, end, frequency = 1, depth = 0.5, centerFrequency = 1000
     fOffset += 282;
     filterChain.push(filter);
   }
-  return { phaser: filterChain, lfo };
+  return { filterChain, lfo };
 }
 
 function getFilterType(ftype) {
@@ -694,9 +694,9 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   }
   // phaser
   if (phaserrate !== undefined && phaserdepth > 0) {
-    const { phaser, lfo } = getPhaser(t, endWithRelease, phaserrate, phaserdepth, phasercenter, phasersweep);
+    const { filterChain, lfo } = getPhaser(t, endWithRelease, phaserrate, phaserdepth, phasercenter, phasersweep);
     audioNodes.push(lfo);
-    Array.prototype.push.apply(chain, phaser);
+    chain.push(...filterChain);
   }
 
   // last gain

From 46291bf85ca0cf583568266f02f7370c6eb67e82 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 4 Dec 2025 13:17:20 +0000
Subject: [PATCH 096/110] Difuse the `onceEnded` mechanism

---
 packages/superdough/helpers.mjs |  4 ++--
 packages/superdough/noise.mjs   |  4 ++--
 packages/superdough/synth.mjs   | 13 +++++++------
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 0b696df9b..6fe1e5b72 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -324,10 +324,10 @@ export function getVibratoOscillator(param, value, t) {
     gain.gain.value = vibmod * 100;
     vibratoOscillator.connect(gain);
     gain.connect(param);
-    vibratoOscillator.onended = () => {
+    onceEnded(vibratoOscillator, () => {
       gain.disconnect(param);
       vibratoOscillator.disconnect(gain);
-    };
+    });
     vibratoOscillator.start(t);
     return vibratoOscillator;
   }
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 3e41515df..da60e87a1 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -1,4 +1,4 @@
-import { drywet } from './helpers.mjs';
+import { drywet, onceEnded } from './helpers.mjs';
 import { getAudioContext } from './audioContext.mjs';
 
 let noiseCache = {};
@@ -65,7 +65,7 @@ export function getNoiseOscillator(type = 'white', t, density = 0.02) {
 export function getNoiseMix(inputNode, wet, t) {
   const noiseOscillator = getNoiseOscillator('pink', t);
   const noiseMix = drywet(inputNode, noiseOscillator.node, wet);
-  noiseOscillator.node.onended = () => noiseMix.onended();
+  onceEnded(noiseOscillator.node, () => noiseMix.onended());
   return {
     node: noiseMix.node,
     stop: (time) => noiseOscillator?.stop(time),
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index b02354465..a2d3aeca0 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -1,5 +1,6 @@
 import { clamp } from './util.mjs';
 import { registerSound, soundMap } from './superdough.mjs';
+import { onceEnded } from './helpers.mjs';
 import { getAudioContext } from './audioContext.mjs';
 import {
   applyFM,
@@ -110,7 +111,7 @@ export function registerSynthSounds() {
 
       const mix = gainNode(mixGain);
 
-      o.onended = () => {
+      onceEnded(o, () => {
         o.disconnect();
         g.disconnect();
         sat.disconnect();
@@ -118,7 +119,7 @@ export function registerSynthSounds() {
         noiseGain.disconnect();
         mix.disconnect();
         onended();
-      };
+      });
 
       const node = o.connect(sat).connect(g).connect(mix);
       noise.node.connect(noiseGain).connect(mix);
@@ -384,11 +385,11 @@ export function registerSynthSounds() {
 
         const { duration } = value;
 
-        o.onended = () => {
+        onceEnded(o, () => {
           o.disconnect();
           g.disconnect();
           onended();
-        };
+        });
 
         const envGain = gainNode(1);
         let node = o.connect(g).connect(envGain);
@@ -489,11 +490,11 @@ export function getOscillator(s, t, value, onended) {
     noiseMix = getNoiseMix(o, noise, t);
   }
 
-  o.onended = () => {
+  onceEnded(o, () => {
     noiseMix || o.disconnect();
     noiseMix?.node.disconnect();
     onended();
-  };
+  });
   o.start(t);
 
   return {

From c7586e96ff8ff1bbeb7b8d6b965d4a8a6b8fce3b Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 4 Dec 2025 13:20:17 +0000
Subject: [PATCH 097/110] Add comment on `end` worklet param

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

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 6fe1e5b72..f000db63e 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -613,6 +613,8 @@ export const releaseAudioNode = (node) => {
   // returns true and either its active source flag is true or
   // any AudioNode connected to one of its inputs is actively processing.
   if (node instanceof AudioWorkletNode) {
+    // while `end` is not native to the web audio API, it is common practice in superdough
+    // to use that param in the worklets to trigger returning false from the processor
     node.parameters.get('end')?.setValueAtTime(0, 0);
   }
 };

From f6f507dd291ccdaca4ca5b2d32dc456fd48edbe2 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 4 Dec 2025 15:26:59 +0000
Subject: [PATCH 098/110] propagate `releaseAudioNode` in packages

---
 packages/soundfonts/fontloader.mjs |  6 +++---
 packages/superdough/helpers.mjs    |  6 +++---
 packages/superdough/sampler.mjs    |  8 ++++----
 packages/superdough/superdough.mjs |  4 ++--
 packages/superdough/synth.mjs      | 24 ++++++++++++------------
 packages/superdough/wavetable.mjs  |  6 +++---
 6 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/packages/soundfonts/fontloader.mjs b/packages/soundfonts/fontloader.mjs
index ca9e45d51..95e210890 100644
--- a/packages/soundfonts/fontloader.mjs
+++ b/packages/soundfonts/fontloader.mjs
@@ -7,6 +7,7 @@ import {
   getPitchEnvelope,
   getVibratoOscillator,
   onceEnded,
+  releaseAudioNode,
 } from '@strudel/webaudio';
 import gm from './gm.mjs';
 
@@ -172,9 +173,8 @@ export function registerSoundfonts() {
         bufferSource.stop(envEnd);
         const stop = (releaseTime) => {};
         onceEnded(bufferSource, () => {
-          bufferSource.disconnect();
-          vibratoOscillator?.stop();
-          node.disconnect();
+          releaseAudioNode(bufferSource);
+          releaseAudioNode(vibratoOscillator);
           onended();
         });
         return { node, stop };
diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index f000db63e..5202dbdfe 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -189,7 +189,7 @@ export function applyParameterModulators(audioContext, param, start, end, envelo
     getParamADSR(param, attack, decay, sustain, release, min, max, start, holdEnd, curve);
   }
   const lfo = getParamLfo(audioContext, param, start, end, lfoValues);
-  return { lfo, disconnect: () => lfo?.disconnect() };
+  return lfo
 }
 export function createFilter(context, start, end, params, cps, cycle) {
   let {
@@ -325,8 +325,8 @@ export function getVibratoOscillator(param, value, t) {
     vibratoOscillator.connect(gain);
     gain.connect(param);
     onceEnded(vibratoOscillator, () => {
-      gain.disconnect(param);
-      vibratoOscillator.disconnect(gain);
+      releaseAudioNode(gain);
+      releaseAudioNode(vibratoOscillator);
     });
     vibratoOscillator.start(t);
     return vibratoOscillator;
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index 1e8c786bf..0e1e291ff 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -329,10 +329,10 @@ export async function onTriggerSample(t, value, onended, bank, resolveUrl) {
   const out = ac.createGain(); // we need a separate gain for the cutgroups because firefox...
   node.connect(out);
   onceEnded(bufferSource, function () {
-    bufferSource.disconnect();
-    vibratoOscillator?.stop();
-    node.disconnect();
-    out.disconnect();
+    releaseAudioNode(bufferSource);
+    releaseAudioNode(vibratoOscillator);
+    releaseAudioNode(node);
+    releaseAudioNode(out);
     onended();
   });
   let envEnd = holdEnd + release + 0.01;
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 6f610d514..bfcf3ab5c 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -9,7 +9,7 @@ import './reverb.mjs';
 import './vowel.mjs';
 import { nanFallback, _mod, cycleToSeconds, pickAndRename } from './util.mjs';
 import workletsUrl from './worklets.mjs?audioworklet';
-import { createFilter, gainNode, getCompressor, getDistortion, getLfo, getWorklet, effectSend } from './helpers.mjs';
+import { createFilter, gainNode, getCompressor, getDistortion, getLfo, getWorklet, effectSend, releaseAudioNode } from './helpers.mjs';
 import { map } from 'nanostores';
 import { logger } from './logger.mjs';
 import { loadBuffer } from './sampler.mjs';
@@ -506,7 +506,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   } else if (getSound(s)) {
     const { onTrigger } = getSound(s);
     const onEnded = () => {
-      audioNodes.forEach((n) => n?.disconnect());
+      audioNodes.forEach((n) => releaseAudioNode(n));
       activeSoundSources.delete(chainID);
     };
     const soundHandle = await onTrigger(t, value, onEnded, cps);
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index a2d3aeca0..e82c889ac 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -1,6 +1,5 @@
 import { clamp } from './util.mjs';
 import { registerSound, soundMap } from './superdough.mjs';
-import { onceEnded } from './helpers.mjs';
 import { getAudioContext } from './audioContext.mjs';
 import {
   applyFM,
@@ -13,6 +12,7 @@ import {
   getVibratoOscillator,
   getWorklet,
   noises,
+  onceEnded,
   releaseAudioNode,
   webAudioTimeout,
 } from './helpers.mjs';
@@ -53,7 +53,7 @@ export function registerSynthSounds() {
         const g = gainNode(0.3);
 
         let sound = getOscillator(s, t, value, () => {
-          g.disconnect();
+          releaseAudioNode(g);
           onended();
         });
 
@@ -112,12 +112,12 @@ export function registerSynthSounds() {
       const mix = gainNode(mixGain);
 
       onceEnded(o, () => {
-        o.disconnect();
-        g.disconnect();
-        sat.disconnect();
-        noise.node.disconnect();
-        noiseGain.disconnect();
-        mix.disconnect();
+        releaseAudioNode(o);
+        releaseAudioNode(g);
+        releaseAudioNode(sat);
+        releaseAudioNode(noise.node);
+        releaseAudioNode(noiseGain);
+        releaseAudioNode(mix);
         onended();
       });
 
@@ -386,8 +386,8 @@ export function registerSynthSounds() {
         const { duration } = value;
 
         onceEnded(o, () => {
-          o.disconnect();
-          g.disconnect();
+          releaseAudioNode(o);
+          releaseAudioNode(g);
           onended();
         });
 
@@ -491,8 +491,8 @@ export function getOscillator(s, t, value, onended) {
   }
 
   onceEnded(o, () => {
-    noiseMix || o.disconnect();
-    noiseMix?.node.disconnect();
+    noiseMix || releaseAudioNode(o);
+    releaseAudioNode(noiseMix?.node);
     onended();
   });
   o.start(t);
diff --git a/packages/superdough/wavetable.mjs b/packages/superdough/wavetable.mjs
index e9d810414..4311c5cab 100644
--- a/packages/superdough/wavetable.mjs
+++ b/packages/superdough/wavetable.mjs
@@ -320,10 +320,10 @@ export async function onTriggerSynth(t, value, onended, tables, cps, frameLen) {
     ac,
     () => {
       releaseAudioNode(source);
-      vibratoOscillator?.stop();
+      releaseAudioNode(vibratoOscillator);
       fm?.stop();
-      wtPosModulators?.disconnect();
-      wtWarpModulators?.disconnect();
+      releaseAudioNode(wtPosModulators);
+      releaseAudioNode(wtWarpModulators);
       onended();
     },
     t,

From 1225d0443748b04c1a84b077c71f88b5f66c7428 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Thu, 4 Dec 2025 15:29:21 +0000
Subject: [PATCH 099/110] codeformat

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

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index 5202dbdfe..a5f199fb1 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -189,7 +189,7 @@ export function applyParameterModulators(audioContext, param, start, end, envelo
     getParamADSR(param, attack, decay, sustain, release, min, max, start, holdEnd, curve);
   }
   const lfo = getParamLfo(audioContext, param, start, end, lfoValues);
-  return lfo
+  return lfo;
 }
 export function createFilter(context, start, end, params, cps, cycle) {
   let {
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index bfcf3ab5c..98a875130 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -9,7 +9,16 @@ import './reverb.mjs';
 import './vowel.mjs';
 import { nanFallback, _mod, cycleToSeconds, pickAndRename } from './util.mjs';
 import workletsUrl from './worklets.mjs?audioworklet';
-import { createFilter, gainNode, getCompressor, getDistortion, getLfo, getWorklet, effectSend, releaseAudioNode } from './helpers.mjs';
+import {
+  createFilter,
+  gainNode,
+  getCompressor,
+  getDistortion,
+  getLfo,
+  getWorklet,
+  effectSend,
+  releaseAudioNode,
+} from './helpers.mjs';
 import { map } from 'nanostores';
 import { logger } from './logger.mjs';
 import { loadBuffer } from './sampler.mjs';

From 16b5faf3331ce18a9a791059a7a71995815ecb54 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 7 Dec 2025 11:23:55 -0600
Subject: [PATCH 100/110] Removing failing tests due to shabda removal

---
 packages/superdough/sampler.mjs           |  6 ----
 test/__snapshots__/examples.test.mjs.snap | 36 -----------------------
 2 files changed, 42 deletions(-)

diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index 1e8c786bf..bdf524d10 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -243,12 +243,6 @@ export async function fetchSampleMap(url) {
  *  sd: '808sd/SD0010.WAV'
  *  }, 'https://raw.githubusercontent.com/tidalcycles/Dirt-Samples/master/');
  * s("[bd ~]*2, [~ hh]*2, ~ sd")
- * @example
- * samples('shabda:noise,chimp:2')
- * s("noise <chimp:0*2 chimp:1>")
- * @example
- * samples('shabda/speech/fr-FR/f:chocolat')
- * s("chocolat*4")
  */
 
 export const samples = async (sampleMap, baseUrl = sampleMap._base || '', options = {}) => {
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 5c76f4a89..7ecaf97ba 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -9722,42 +9722,6 @@ exports[`runs examples > example "samples" example index 1 1`] = `
 ]
 `;
 
-exports[`runs examples > example "samples" example index 2 1`] = `
-[
-  "[ 0/1 → 1/2 | s:noise ]",
-  "[ 1/2 → 3/4 | s:chimp n:0 ]",
-  "[ 3/4 → 1/1 | s:chimp n:0 ]",
-  "[ 1/1 → 3/2 | s:noise ]",
-  "[ 3/2 → 2/1 | s:chimp n:1 ]",
-  "[ 2/1 → 5/2 | s:noise ]",
-  "[ 5/2 → 11/4 | s:chimp n:0 ]",
-  "[ 11/4 → 3/1 | s:chimp n:0 ]",
-  "[ 3/1 → 7/2 | s:noise ]",
-  "[ 7/2 → 4/1 | s:chimp n:1 ]",
-]
-`;
-
-exports[`runs examples > example "samples" example index 3 1`] = `
-[
-  "[ 0/1 → 1/4 | s:chocolat ]",
-  "[ 1/4 → 1/2 | s:chocolat ]",
-  "[ 1/2 → 3/4 | s:chocolat ]",
-  "[ 3/4 → 1/1 | s:chocolat ]",
-  "[ 1/1 → 5/4 | s:chocolat ]",
-  "[ 5/4 → 3/2 | s:chocolat ]",
-  "[ 3/2 → 7/4 | s:chocolat ]",
-  "[ 7/4 → 2/1 | s:chocolat ]",
-  "[ 2/1 → 9/4 | s:chocolat ]",
-  "[ 9/4 → 5/2 | s:chocolat ]",
-  "[ 5/2 → 11/4 | s:chocolat ]",
-  "[ 11/4 → 3/1 | s:chocolat ]",
-  "[ 3/1 → 13/4 | s:chocolat ]",
-  "[ 13/4 → 7/2 | s:chocolat ]",
-  "[ 7/2 → 15/4 | s:chocolat ]",
-  "[ 15/4 → 4/1 | s:chocolat ]",
-]
-`;
-
 exports[`runs examples > example "saw" example index 0 1`] = `
 [
   "[ 0/1 → 1/8 | note:c3 clip:0 ]",

From fe7e8f7add4b45216416d1f65038a6bb65f4ec04 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 7 Dec 2025 13:21:06 -0600
Subject: [PATCH 101/110] Clearer docstring

---
 packages/midi/midi.mjs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/midi/midi.mjs b/packages/midi/midi.mjs
index 0fee380c6..cd38d3587 100644
--- a/packages/midi/midi.mjs
+++ b/packages/midi/midi.mjs
@@ -486,8 +486,9 @@ const refsByChan = {};
  *
  * The output is a function that accepts a midi cc value to query as well as (optionally) a midi channel
  * @param {string | number} input MIDI device name or index defaulting to 0
- * @returns {function(number, number=): function(): number} A function from (cc, channel?) to
- *   the most recently received midi cc value through the input (normalized to 0 to 1)
+ * @returns {function(number, number=): Pattern} A function from (cc, channel?) to a pattern.
+ *   When queried, the pattern will produces the most recently received midi value (normalized to 0 to 1)
+ *   that came through that cc number (and channel, if provided)
  * @example
  * const cc = await midin('IAC Driver Bus 1')
  * note("c a f e").lpf(cc(0).range(0, 1000)).lpq(cc(1).range(0, 10)).sound("sawtooth")

From 358b1e3f563ffe6bafd33689b1fec8e7c02c4ecc Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 7 Dec 2025 13:28:57 -0600
Subject: [PATCH 102/110] Make sure processor turns off; fix array sizes for
 JIT

---
 packages/superdough/superdough.mjs |  2 ++
 packages/superdough/worklets.mjs   | 17 ++++++++++++++---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 52bf332e3..b4df1f734 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -544,6 +544,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
           processorOptions: {
             attack: transient,
             sustain: transsustain,
+            begin: t,
+            end: endWithRelease,
           },
         },
       ),
diff --git a/packages/superdough/worklets.mjs b/packages/superdough/worklets.mjs
index d190cf41f..a59aeb756 100644
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@@ -1404,6 +1404,8 @@ class TransientProcessor extends AudioWorkletProcessor {
       sustain = 0,
       sensitivity = 0.1,
       mix = 1,
+      begin = 0,
+      end = 0,
     } = options.processorOptions;
     attackTime = clamp(attackTime, 0.0005, 0.05);
     sustainTime = clamp(sustainTime, 0.01, 0.5);
@@ -1413,17 +1415,26 @@ class TransientProcessor extends AudioWorkletProcessor {
     this.sustainAmt = clamp(sustain, -1, 1);
     this.scaling = 0.5 + 5 * clamp(sensitivity, 0, 1);
     this.mix = clamp(mix, 0, 1);
+    this.begin = begin;
+    this.end = end;
+    this.attackEnv = new Float32Array(2); // assume stereo
+    this.sustainEnv = new Float32Array(2);
   }
 
   process(inputs, outputs, _params) {
     const input = inputs[0];
     const output = outputs[0];
-    if (!input || !output) {
+    if (currentTime >= this.end) {
+      return false;
+    }
+    if (currentTime <= this.begin) {
       return true;
     }
     const channels = input.length;
-    this.attackEnv ??= new Float32Array(channels);
-    this.sustainEnv ??= new Float32Array(channels);
+    if (channels > this.attackEnv.length) {
+      this.attackEnv = new Float32Array(channels);
+      this.sustainEnv = new Float32Array(channels);
+    }
     let avgGain = this.avgGain;
     for (let ch = 0; ch < channels; ch++) {
       let attEnv = this.attackEnv[ch];

From 71d36b79edfdf85cb035764b418662210226d245 Mon Sep 17 00:00:00 2001
From: jeromew <jerome.wagner@m4x.org>
Date: Mon, 8 Dec 2025 17:31:34 +0000
Subject: [PATCH 103/110] Improve getOscillator/noiseMix release

---
 packages/superdough/helpers.mjs | 9 ++++++---
 packages/superdough/noise.mjs   | 7 +++++--
 packages/superdough/synth.mjs   | 3 ++-
 3 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/packages/superdough/helpers.mjs b/packages/superdough/helpers.mjs
index a5f199fb1..5abc2bad1 100644
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@@ -283,9 +283,12 @@ export function drywet(dry, wet, wetAmount = 0) {
   wet_gain.connect(mix);
   return {
     node: mix,
-    onended: () => {
-      dry_gain.disconnect(mix);
-      wet_gain.disconnect(mix);
+    teardown: () => {
+      releaseAudioNode(dry_gain);
+      releaseAudioNode(wet_gain);
+      // it is not the responsability of drywet
+      // to call `releaseAudioNode` on
+      // the 2 external args dry and wet
       dry.disconnect(dry_gain);
       wet.disconnect(wet_gain);
     },
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index da60e87a1..52d9306a1 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -1,4 +1,4 @@
-import { drywet, onceEnded } from './helpers.mjs';
+import { drywet, onceEnded, releaseAudioNode } from './helpers.mjs';
 import { getAudioContext } from './audioContext.mjs';
 
 let noiseCache = {};
@@ -65,9 +65,12 @@ export function getNoiseOscillator(type = 'white', t, density = 0.02) {
 export function getNoiseMix(inputNode, wet, t) {
   const noiseOscillator = getNoiseOscillator('pink', t);
   const noiseMix = drywet(inputNode, noiseOscillator.node, wet);
-  onceEnded(noiseOscillator.node, () => noiseMix.onended());
+  onceEnded(noiseOscillator.node, () => {
+    releaseAudioNode(noiseOscillator.node);
+  });
   return {
     node: noiseMix.node,
     stop: (time) => noiseOscillator?.stop(time),
+    teardown: noiseMix.teardown,
   };
 }
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index e82c889ac..d9ee0d936 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -491,7 +491,8 @@ export function getOscillator(s, t, value, onended) {
   }
 
   onceEnded(o, () => {
-    noiseMix || releaseAudioNode(o);
+    noiseMix?.teardown();
+    releaseAudioNode(o);
     releaseAudioNode(noiseMix?.node);
     onended();
   });

From e89414e400362ebe064858e4c0b1cc3441b56dca Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Wed, 10 Dec 2025 09:19:12 +0000
Subject: [PATCH 104/110] fix .as so it doesn't set undefined values

---
 packages/core/controls.mjs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index c7edef74f..f28d13f62 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2753,8 +2753,13 @@ export const as = register('as', (mapping, pat) => {
   mapping = Array.isArray(mapping) ? mapping : [mapping];
   return pat.fmap((v) => {
     v = Array.isArray(v) ? v : [v];
-    v = Object.fromEntries(mapping.map((prop, i) => [getControlName(prop), v[i]]));
-    return v;
+    const entries = [];
+    for (let i = 0; i < mapping.length; ++i) {
+      if (v[i] !== undefined) {
+        entries.push([getControlName(mapping[i]), v[i]]);
+      }
+    }
+    return Object.fromEntries(entries);
   });
 });
 

From 12884cba3a0db216fa14a1c1c3d2521ab38fcccf Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Thu, 11 Dec 2025 12:09:26 +0000
Subject: [PATCH 105/110] Updates relating to LLM, github, etc

---
 CONTRIBUTING.md | 37 ++++++++++++++++++++-----------------
 1 file changed, 20 insertions(+), 17 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a7f65b5bf..a4cf5d9e0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -4,20 +4,13 @@ Thanks for wanting to contribute!!! There are many ways you can add value to thi
 
 ## Move to codeberg
 
-We are currently in the process of moving from github to codeberg -- not everything is working, please bear with us.
-
-To update your local clone, you can run this command:
-
-```
-git remote set-url origin git@codeberg.org:uzu/strudel.git
-```
-
+Along with many other live coding projects, we have moved from Microsoft's Github platform to Codeberg for ethical reasons. Please don't fork the project back to github.
 
 ## Communication Channels
 
-To get in touch with the contributors, either
+To get in touch with the community, either
 
-- [join the Tidal Discord Channel](https://discord.com/invite/HGEdXmRkzT) and go to the #strudel channel
+- [join the Tidal Discord Channel](https://discord.com/invite/HGEdXmRkzT) and go to the #strudel channels
 - Find related discussions on the [tidal club forum](https://club.tidalcycles.org/)
 
 ## Ask a Question
@@ -36,22 +29,33 @@ Use one of the Communication Channels listed above and drop us a line or two!
 ## Share Music
 
 If you made some music with strudel, you can give back some love and share what you've done!
-Your creation could also be part of the random selection in the REPL if you want.
 Use one of the Communication Channels listed above.
+(There used to be a random selection of contributed patterns in the REPL, but that is unfortunately disabled for now due to abuse)
 
 ## Improve the Docs
 
-If you find some weak spots in the [docs](https://strudel.cc/workshop/getting-started/),
-you can edit each file directly on codeburg. (we are currently fixing the "Edit this page" links in the right sidebar)
+If you find some weak spots in the [docs](https://strudel.cc/workshop/getting-started/), you can edit each file directly on codeburg. There are "Edit this page" links in the right sidebar that take you to the right place.
 
 ## Propose a Feature
 
-If you want a specific feature that is not part of strudel yet, feel free to use one of the communication channels above.
-Maybe you even want to help with the implementation of that feature!
+If you want a specific feature that is not part of strudel yet, feel free to use one of the communication channels above. Please bear in mind that this is a free/open source project, oriented around collaborative discussion. Maybe you even want to help with the implementation of that feature!
+
+## Contribute a feature
+
+It's generally best to start with discussion rather than do loads of work on something and then find it doesn't fit the collective goals of the project, or something like that.
+
+## AI/LLM policy
+
+Strudel is a project handmade by humans, with a lot of thought and nuance. We are still developing our response to the onslaught of LLM technology.
+
+If you have used LLMs (so called 'AI'), please make that clear in the pull request. If code is LLM-generated/isn't your own work, then the PR will not be merged, for practical and legal reasons.
+
+There are #llm-chat and #llm-share channels on our discord. Please do not discuss or share LLM-related things outside of those channels.
 
 ## Report a Bug
 
 If you've found a bug, or some behaviour that does not seem right, you are welcome to file an [issue](https://codeberg.org/uzu/strudel/issues).
+
 Please check that it has not been reported before.
 
 ## Fix a Bug
@@ -118,8 +122,7 @@ There are also eslint extensions / plugins for most editors.
 
 ## Running all CI Checks
 
-When opening a PR, the CI runner will automatically check the code style and eslint, as well as run all tests.
-You can run the same check with `pnpm check`
+When opening a PR, the CI runner will (once approved by a human) check the code style and eslint, as well as run all tests. You can run the same check with `pnpm check`.
 
 ## Package Workflow
 

From 960f1de9d2d125c95737b73abaf382fcfe4b5ab7 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Thu, 11 Dec 2025 12:16:54 +0000
Subject: [PATCH 106/110] tweaks

---
 CONTRIBUTING.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a4cf5d9e0..10146bec2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -10,7 +10,7 @@ Along with many other live coding projects, we have moved from Microsoft's Githu
 
 To get in touch with the community, either
 
-- [join the Tidal Discord Channel](https://discord.com/invite/HGEdXmRkzT) and go to the #strudel channels
+- [join the Uzulang Discord Server](https://discord.com/invite/HGEdXmRkzT) and go to the strudel channels (Uzulangs are a family of live coding languages inspired by each other, including TidalCycles as well as Strudel)
 - Find related discussions on the [tidal club forum](https://club.tidalcycles.org/)
 
 ## Ask a Question
@@ -42,9 +42,9 @@ If you want a specific feature that is not part of strudel yet, feel free to use
 
 ## Contribute a feature
 
-It's generally best to start with discussion rather than do loads of work on something and then find it doesn't fit the collective goals of the project, or something like that.
+Pull requests welcome! Consider starting with discussion or proof-of-concept first, rather than do loads of work on something and then find it doesn't fit the collective goals of the project, or something like that.
 
-## AI/LLM policy
+### AI/LLM policy
 
 Strudel is a project handmade by humans, with a lot of thought and nuance. We are still developing our response to the onslaught of LLM technology.
 

From 96835be056e626020b6917ab8fad2cbcbcae1232 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Thu, 11 Dec 2025 15:07:57 +0000
Subject: [PATCH 107/110] tweaks

---
 CONTRIBUTING.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 10146bec2..b8a941fc1 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -34,7 +34,7 @@ Use one of the Communication Channels listed above.
 
 ## Improve the Docs
 
-If you find some weak spots in the [docs](https://strudel.cc/workshop/getting-started/), you can edit each file directly on codeburg. There are "Edit this page" links in the right sidebar that take you to the right place.
+If you find some weak spots in the [docs](https://strudel.cc/workshop/getting-started/), you can edit each file directly on codeberg. There are "Edit this page" links in the right sidebar that take you to the right place.
 
 ## Propose a Feature
 
@@ -44,11 +44,13 @@ If you want a specific feature that is not part of strudel yet, feel free to use
 
 Pull requests welcome! Consider starting with discussion or proof-of-concept first, rather than do loads of work on something and then find it doesn't fit the collective goals of the project, or something like that.
 
+At the time of writing we have a PR backlog, and generally prioritise bugfixes and contributions that have arisen through community discussion.
+
 ### AI/LLM policy
 
-Strudel is a project handmade by humans, with a lot of thought and nuance. We are still developing our response to the onslaught of LLM technology.
+Strudel is a project handmade by humans, with thought and nuance. 
 
-If you have used LLMs (so called 'AI'), please make that clear in the pull request. If code is LLM-generated/isn't your own work, then the PR will not be merged, for practical and legal reasons.
+If you have used LLMs (so called 'AI'), please detail that in the pull request. We are still developing our response to the onslaught of LLM technology, but for practical and legal reasons are currently not accepting wholly LLM-generated code. We are also not accepting PRs that add LLM features to strudel itself.
 
 There are #llm-chat and #llm-share channels on our discord. Please do not discuss or share LLM-related things outside of those channels.
 

From 8cbe4b945cfbd050ddbd85755c459a65135a90f0 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Thu, 11 Dec 2025 16:39:08 +0000
Subject: [PATCH 108/110] Respond to glossing's review

---
 packages/core/impure.mjs | 35 +++++++++++++++++++++++++++++------
 packages/core/repl.mjs   |  4 ++++
 2 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/packages/core/impure.mjs b/packages/core/impure.mjs
index e16cfbe45..84886aa49 100644
--- a/packages/core/impure.mjs
+++ b/packages/core/impure.mjs
@@ -8,24 +8,48 @@ import { register, reify, Pattern } from './pattern.mjs';
 
 let timelines = {};
 
+export const reset_state = function () {
+  reset_timelines();
+};
+
 export const reset_timelines = function () {
   timelines = {};
 };
 
+/***
+ * Allows you to switch a pattern between different 'timelines'. This is particularly useful when
+ * live coding, for example when you want to cue a pattern up to play from its start.
+ *
+ * Timelines are specified by number, so that if you had a pattern like
+ * `n("<0 1 2 3>").s("num").timeline(1)` playing, then changed the '1'
+ * to '2', it would always align '0' to the nearest cycle. You will likely want to trigger
+ * an evaluation a little bit before the cycle starts, to avoid missing events.
+ *
+ * If you change and evaluate a pattern without changing the timeline, it will stay on that timeline
+ * without resetting.
+ *
+ * Rather than incrementing a timeline to reset it, it's easier to negate it, e.g. by switching between `-2`
+ * and `2`. This is because when you negate a timeline it will always reset.
+ *
+ * You can also pattern the timeline if you want, to create strange resetting patterns.
+ */
+
 export const timeline = register(
   'timeline',
   function (tpat, pat) {
     tpat = reify(tpat);
     const f = function (state) {
-      let scheduler = !!state.controls._cps;
+      // Is this called from the scheduler? (rather than from e.g. the visualiser)
+      const scheduler = !!state.controls._cyclist;
 
       const timehaps = tpat.query(state);
       const result = [];
       for (const timehap of timehaps) {
         const tlid = timehap.value;
-        const ignore = false;
         let offset;
-        if (tlid in timelines) {
+        if (tlid === 0) {
+          offset = 0;
+        } else if (tlid in timelines) {
           offset = timelines[tlid];
         } else {
           const timearc = timehap.wholeOrPart();
@@ -40,9 +64,8 @@ export const timeline = register(
         if (scheduler) {
           // update state
           timelines[tlid] = offset;
-          const negative = 0 - tlid;
-          if (negative in timelines) {
-            delete timelines[negative];
+          if (tlid !== 0) {
+            delete timelines[-tlid];
           }
         }
 
diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 171697eb9..cd78cca48 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -5,6 +5,7 @@ import { errorLogger, logger } from './logger.mjs';
 import { setTime } from './time.mjs';
 import { evalScope } from './evaluate.mjs';
 import { register, Pattern, isPattern, silence, stack } from './pattern.mjs';
+import { reset_state } from './impure.mjs';
 
 export function repl({
   defaultOutput,
@@ -52,6 +53,9 @@ export function repl({
     onToggle: (started) => {
       updateState({ started });
       onToggle?.(started);
+      if (!started) {
+        reset_state();
+      }
     },
     setInterval,
     clearInterval,

From 37990b459f3571d4b254ca99030e21d4cf836104 Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Thu, 11 Dec 2025 16:51:25 +0000
Subject: [PATCH 109/110] bugfix and tweak doc

---
 packages/core/impure.mjs | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/packages/core/impure.mjs b/packages/core/impure.mjs
index 84886aa49..304f801f5 100644
--- a/packages/core/impure.mjs
+++ b/packages/core/impure.mjs
@@ -25,13 +25,21 @@ export const reset_timelines = function () {
  * to '2', it would always align '0' to the nearest cycle. You will likely want to trigger
  * an evaluation a little bit before the cycle starts, to avoid missing events.
  *
- * If you change and evaluate a pattern without changing the timeline, it will stay on that timeline
- * without resetting.
+ * After the first use, a timeline will continue with the same 'offset'. That is, if you change
+ * a pattern without changing its timeline number, it will stay on that timeline without resetting.
  *
  * Rather than incrementing a timeline to reset it, it's easier to negate it, e.g. by switching between `-2`
  * and `2`. This is because when you negate a timeline it will always reset.
  *
  * You can also pattern the timeline if you want, to create strange resetting patterns.
+ * @param {number | Pattern} timeline The timeline that the pattern should play on.
+ * @example
+ * n("<0 1 2 3>(3,8)")
+ *   .sound("num")
+ *   // resets the timeline every two cycles, by negating the timeline.
+ *   // in a lot of cases this will be edited by a human live coder
+ *   // rather than patterned!
+ *   .timeline("<2 -2>".slow(2))
  */
 
 export const timeline = register(
@@ -40,8 +48,7 @@ export const timeline = register(
     tpat = reify(tpat);
     const f = function (state) {
       // Is this called from the scheduler? (rather than from e.g. the visualiser)
-      const scheduler = !!state.controls._cyclist;
-
+      const scheduler = !!state.controls.cyclist;
       const timehaps = tpat.query(state);
       const result = [];
       for (const timehap of timehaps) {

From c6e0f0533e927a878339a9828c32d21ac9115a7c Mon Sep 17 00:00:00 2001
From: alex <alex@slab.org>
Date: Thu, 11 Dec 2025 23:32:10 +0000
Subject: [PATCH 110/110] add delta

---
 packages/core/signal.mjs                  |  9 ++++
 test/__snapshots__/examples.test.mjs.snap | 53 +++++++++++++++++++++++
 2 files changed, 62 insertions(+)

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 62fc26ad8..9ac768951 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -882,3 +882,12 @@ export const whenKey = register('whenKey', function (input, func, pat) {
 export const keyDown = register('keyDown', function (pat) {
   return pat.fmap(_keyDown);
 });
+
+/**
+ * A pattern that gives the duration of events that are combined with it.
+ * @example
+ * sound("bd sd [bd bd] sd*4 [- sd] [bd [bd bd]]").note(delta.withValue(x => 1/x + 20))
+ */
+export const delta = new Pattern(function (state) {
+  return [new Hap(undefined, state.span, state.span.duration)];
+});
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 09d285b5d..17dcb08ba 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -2784,6 +2784,59 @@ exports[`runs examples > example "delaysync" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "delta" example index 0 1`] = `
+[
+  "[ 0/1 → 1/6 | s:bd note:26 ]",
+  "[ 1/6 → 1/3 | s:sd note:26 ]",
+  "[ 1/3 → 5/12 | s:bd note:32 ]",
+  "[ 5/12 → 1/2 | s:bd note:32 ]",
+  "[ 1/2 → 13/24 | s:sd note:44 ]",
+  "[ 13/24 → 7/12 | s:sd note:44 ]",
+  "[ 7/12 → 5/8 | s:sd note:44 ]",
+  "[ 5/8 → 2/3 | s:sd note:44 ]",
+  "[ 3/4 → 5/6 | s:sd note:32 ]",
+  "[ 5/6 → 11/12 | s:bd note:32 ]",
+  "[ 11/12 → 23/24 | s:bd note:44 ]",
+  "[ 23/24 → 1/1 | s:bd note:44 ]",
+  "[ 1/1 → 7/6 | s:bd note:26 ]",
+  "[ 7/6 → 4/3 | s:sd note:26 ]",
+  "[ 4/3 → 17/12 | s:bd note:32 ]",
+  "[ 17/12 → 3/2 | s:bd note:32 ]",
+  "[ 3/2 → 37/24 | s:sd note:44 ]",
+  "[ 37/24 → 19/12 | s:sd note:44 ]",
+  "[ 19/12 → 13/8 | s:sd note:44 ]",
+  "[ 13/8 → 5/3 | s:sd note:44 ]",
+  "[ 7/4 → 11/6 | s:sd note:32 ]",
+  "[ 11/6 → 23/12 | s:bd note:32 ]",
+  "[ 23/12 → 47/24 | s:bd note:44 ]",
+  "[ 47/24 → 2/1 | s:bd note:44 ]",
+  "[ 2/1 → 13/6 | s:bd note:26 ]",
+  "[ 13/6 → 7/3 | s:sd note:26 ]",
+  "[ 7/3 → 29/12 | s:bd note:32 ]",
+  "[ 29/12 → 5/2 | s:bd note:32 ]",
+  "[ 5/2 → 61/24 | s:sd note:44 ]",
+  "[ 61/24 → 31/12 | s:sd note:44 ]",
+  "[ 31/12 → 21/8 | s:sd note:44 ]",
+  "[ 21/8 → 8/3 | s:sd note:44 ]",
+  "[ 11/4 → 17/6 | s:sd note:32 ]",
+  "[ 17/6 → 35/12 | s:bd note:32 ]",
+  "[ 35/12 → 71/24 | s:bd note:44 ]",
+  "[ 71/24 → 3/1 | s:bd note:44 ]",
+  "[ 3/1 → 19/6 | s:bd note:26 ]",
+  "[ 19/6 → 10/3 | s:sd note:26 ]",
+  "[ 10/3 → 41/12 | s:bd note:32 ]",
+  "[ 41/12 → 7/2 | s:bd note:32 ]",
+  "[ 7/2 → 85/24 | s:sd note:44 ]",
+  "[ 85/24 → 43/12 | s:sd note:44 ]",
+  "[ 43/12 → 29/8 | s:sd note:44 ]",
+  "[ 29/8 → 11/3 | s:sd note:44 ]",
+  "[ 15/4 → 23/6 | s:sd note:32 ]",
+  "[ 23/6 → 47/12 | s:bd note:32 ]",
+  "[ 47/12 → 95/24 | s:bd note:44 ]",
+  "[ 95/24 → 4/1 | s:bd note:44 ]",
+]
+`;
+
 exports[`runs examples > example "density" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | s:crackle density:0.01 ]",