From a4ab8e1b06e80c9092b75fb5bd8107aa24f288a0 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 6 Aug 2025 00:45:01 -0500
Subject: [PATCH 01/18] First pass at extending scale function to include notes

---
 packages/tonal/tonal.mjs     | 113 ++++++++++++++++++++++-------------
 packages/tonal/tonleiter.mjs |  14 ++++-
 2 files changed, 84 insertions(+), 43 deletions(-)

diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index c4dd5488..2aca7e9c 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -6,7 +6,8 @@ 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, silence, logger, pure, isNote } from '@strudel/core';
-import { stepInNamedScale } from './tonleiter.mjs';
+import { stepInNamedScale, scaleToChromas } from './tonleiter.mjs';
+import { noteToMidi } from '../core/util.mjs'
 
 const octavesInterval = (octaves) => (octaves <= 0 ? -1 : 1) + octaves * 7 + 'P';
 
@@ -171,8 +172,52 @@ export const { scaleTranspose, scaleTrans, strans } = register(
   },
 );
 
+// Converts a step value, which is a number optionally decorated with sharps and flats,
+// to a number and an `offset` number of semitones
+function _convertStepToNumberAndOffset(step) {
+  if (isNote(step)) {
+    // legacy..
+    return pure(step);
+  }
+  let asNumber = Number(step);
+  let offset = 0;
+  if (isNaN(asNumber)) {
+    step = String(step);
+    // Check to see if the format correctly matches the expected one of
+    // Optionally starting with + or -
+    // A number
+    // Some number of sharps or flats (but not both)
+    const match = /^[-+]?(\d+)((#{1,})|(b{1,}))?$/.exec(step);
+
+    if (!match) {
+      logger(
+        `[tonal] invalid scale step "${step}", expected number or integer with optional # b suffixes`,
+        'error',
+      );
+      return silence;
+    }
+    asNumber = Number(match[2]);
+    // The number of semitones will be given by either the total number of sharps (match 3)
+    // or the negative of the total number of flats (match 4)
+    offset = match[3].length > 0 ? match[3].length : -match[4].length;
+  }
+  return [asNumber, offset];
+}
+
+// Finds the nearest (named) scale note to `note` (a string which is then converted to a midi number)
+function _getNearestScaleNote(scaleName, note) {
+  let midiNote = noteToMidi(note);
+  const octave = (midiNote / 12) >> 0;
+  const goal = midiNote % 12;
+  const chromas = scaleToChromas(scaleName);
+  return chromas.reduce((prev, curr) => {
+    return Math.abs(curr - goal) < Math.abs(prev - goal) ? curr : prev;
+  }) + octave * 12;
+}
+
 /**
- * Turns numbers into notes in the scale (zero indexed). Also sets scale for other scale operations, like {@link Pattern#scaleTranspose}.
+ * Turns numbers into notes in the scale (zero indexed) or quantizes notes to a scale.
+ * Also sets scale for other scale operations, like {@link Pattern#scaleTranspose}.
  *
  * A scale consists of a root note (e.g. `c4`, `c`, `f#`, `bb4`) followed by semicolon (':') and then a [scale type](https://github.com/tonaljs/tonal/blob/main/packages/scale-type/data.ts).
  *
@@ -200,58 +245,42 @@ export const scale = register(
     if (Array.isArray(scale)) {
       scale = scale.flat().join(' ');
     }
-    return (
+    let output = (
       pat
         .fmap((value) => {
           const isObject = typeof value === 'object';
-          let step = isObject ? value.n : value;
-          if (isObject) {
+          // The case where the note has been defined via `n`
+          if ((isObject && 'n' in value) || !isObject) {
+            let step = isObject ? value.n : value;
+            debugger;
             delete value.n; // remove n so it won't cause trouble
-          }
-          if (isNote(step)) {
-            // legacy..
-            return pure(step);
-          }
-          let asNumber = Number(step);
-          let semitones = 0;
-          if (isNaN(asNumber)) {
-            step = String(step);
-            if (!/^[-+]?\d+(#*|b*){1}$/.test(step)) {
-              logger(
-                `[tonal] invalid scale step "${step}", expected number or integer with optional # b suffixes`,
-                'error',
-              );
-              return silence;
-            }
-            const isharp = step.indexOf('#');
-            if (isharp >= 0) {
-              asNumber = Number(step.substring(0, isharp));
-              semitones = step.length - isharp;
-            } else {
-              const iflat = step.indexOf('b');
-              asNumber = Number(step.substring(0, iflat));
-              semitones = iflat - step.length;
+            let [number, offset] = _convertStepToNumberAndOffset(step);
+            try {
+              let note;
+              if (isObject && value.anchor) {
+                note = stepInNamedScale(number, scale, value.anchor);
+              } else {
+                note = scaleStep(number, scale);
+              }
+              if (offset != 0) note = Note.transpose(note, Interval.fromSemitones(offset));
+              value = pure(isObject ? { ...value, note } : note);
+            } catch (err) {
+              logger(`[tonal] ${err.message}`, 'error');
+              value = silence;
             }
+            return value;
           }
-          try {
-            let note;
-            if (isObject && value.anchor) {
-              note = stepInNamedScale(asNumber, scale, value.anchor);
-            } else {
-              note = scaleStep(asNumber, scale);
-            }
-            if (semitones != 0) note = Note.transpose(note, Interval.fromSemitones(semitones));
-            value = pure(isObject ? { ...value, note } : note);
-          } catch (err) {
-            logger(`[tonal] ${err.message}`, 'error');
-            value = silence;
+          // The case where the note has been defined via `note`
+          else {
+            let note = _getNearestScaleNote(scale, value.note);
+            return pure(isObject ? { ...value, note } : note);
           }
-          return value;
         })
         .outerJoin()
         // legacy:
         .withHap((hap) => hap.setContext({ ...hap.context, scale }))
     );
+    return output;
   },
   true,
   true, // preserve step count
diff --git a/packages/tonal/tonleiter.mjs b/packages/tonal/tonleiter.mjs
index 3814394f..63ae9c94 100644
--- a/packages/tonal/tonleiter.mjs
+++ b/packages/tonal/tonleiter.mjs
@@ -222,6 +222,7 @@ export const Note = {
 };
 
 // TODO: support octave numbers
+// Example: Note("Bb3").transpose("c3")
 export function transpose(note, step) {
   // example: E, 3
   const stepNumber = Step.tokenize(step)[1]; // 3
@@ -236,4 +237,15 @@ export function transpose(note, step) {
   return [targetNote, offsetAccidentals].join('');
 }
 
-//Note("Bb3").transpose("c3")
+// Converts a `scaleName` into a corresponding list of chromas between 0 and 12
+export function scaleToChromas (scaleName) {
+  if (Array.isArray(scaleName)) {
+    scaleName = scaleName.flat().join(' ');
+  }
+  const [tonic, name] = Scale.tokenize(scaleName);
+  const rootMidi = noteToMidi(tonic);
+  const chroma = rootMidi % 12;
+  const intervals = Scale.get(name).intervals;
+  const scaleSteps = intervals.map(Interval.semitones);
+  return scaleSteps.map(s => (s + chroma) % 12);
+}

From 7046c1f54669f26a93252349af28e6adca4b6310 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 6 Aug 2025 10:17:48 -0500
Subject: [PATCH 02/18] Cleanup and simplification; improved docstrings

---
 packages/tonal/tonal.mjs | 43 +++++++++++++++++++++++-----------------
 1 file changed, 25 insertions(+), 18 deletions(-)

diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 2aca7e9c..5b0c63b9 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -183,11 +183,10 @@ function _convertStepToNumberAndOffset(step) {
   let offset = 0;
   if (isNaN(asNumber)) {
     step = String(step);
-    // Check to see if the format correctly matches the expected one of
-    // Optionally starting with + or -
-    // A number
-    // Some number of sharps or flats (but not both)
-    const match = /^[-+]?(\d+)((#{1,})|(b{1,}))?$/.exec(step);
+    // Check to see if the step matches the expected format:
+    //   - A number (possibly negative)
+    //   - Some number of sharps or flats (but not both)
+    const match = /^(-?\d+)(#+|b+)?$/.exec(step);
 
     if (!match) {
       logger(
@@ -196,27 +195,33 @@ function _convertStepToNumberAndOffset(step) {
       );
       return silence;
     }
-    asNumber = Number(match[2]);
-    // The number of semitones will be given by either the total number of sharps (match 3)
-    // or the negative of the total number of flats (match 4)
-    offset = match[3].length > 0 ? match[3].length : -match[4].length;
+    asNumber = Number(match[1]);
+    // These decorations will determine the semitone offset based on the number of
+    // sharps or flats
+    const decorations = match[2] || '';
+    offset = decorations[0] === '#' ? decorations.length : -decorations.length;
   }
   return [asNumber, offset];
 }
 
-// Finds the nearest (named) scale note to `note` (a string which is then converted to a midi number)
+// Finds the nearest scale note to `note`
 function _getNearestScaleNote(scaleName, note) {
-  let midiNote = noteToMidi(note);
+  let midiNote = typeof note === 'string' ? noteToMidi(note) : note;
   const octave = (midiNote / 12) >> 0;
-  const goal = midiNote % 12;
-  const chromas = scaleToChromas(scaleName);
-  return chromas.reduce((prev, curr) => {
-    return Math.abs(curr - goal) < Math.abs(prev - goal) ? curr : prev;
+  const targetChroma = midiNote % 12;
+  const scaleChromas = scaleToChromas(scaleName);
+  return scaleChromas.reduce((prev, curr) => {
+    // Include equality so ties are broken upwards
+    return Math.abs(curr - targetChroma) <= Math.abs(prev - targetChroma) ? curr : prev;
   }) + octave * 12;
 }
 
 /**
  * Turns numbers into notes in the scale (zero indexed) or quantizes notes to a scale.
+ *
+ * When describing notes via numbers, note that negative numbers can be used to wrap backwards
+ * in the scale as well as sharps or flats (but not both) to produce notes outside of the scale.
+ *
  * Also sets scale for other scale operations, like {@link Pattern#scaleTranspose}.
  *
  * A scale consists of a root note (e.g. `c4`, `c`, `f#`, `bb4`) followed by semicolon (':') and then a [scale type](https://github.com/tonaljs/tonal/blob/main/packages/scale-type/data.ts).
@@ -236,6 +241,10 @@ function _getNearestScaleNote(scaleName, note) {
  * n(rand.range(0,12).segment(8))
  * .scale("C:ritusen")
  * .s("piano")
+ * @example
+ * n("<[0,7b] [-4# -4] [-2,7##] 4 [0,7] [-4# -4b] [-2,7###] 4b>*4")
+ * .scale("C:<major minor>/2")
+ * .s("piano")
  */
 
 export const scale = register(
@@ -245,14 +254,13 @@ export const scale = register(
     if (Array.isArray(scale)) {
       scale = scale.flat().join(' ');
     }
-    let output = (
+    return (
       pat
         .fmap((value) => {
           const isObject = typeof value === 'object';
           // The case where the note has been defined via `n`
           if ((isObject && 'n' in value) || !isObject) {
             let step = isObject ? value.n : value;
-            debugger;
             delete value.n; // remove n so it won't cause trouble
             let [number, offset] = _convertStepToNumberAndOffset(step);
             try {
@@ -280,7 +288,6 @@ export const scale = register(
         // legacy:
         .withHap((hap) => hap.setContext({ ...hap.context, scale }))
     );
-    return output;
   },
   true,
   true, // preserve step count

From a4c040e10134c8978fdeda318bddb93caf5fa267 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Wed, 6 Aug 2025 12:37:55 -0500
Subject: [PATCH 03/18] Add new tests, organize old tests, fix issue with  note

---
 packages/tonal/test/tonal.test.mjs | 171 +++++++++++++++++------------
 packages/tonal/tonal.mjs           |  32 +++---
 packages/tonal/tonleiter.mjs       |   4 +-
 3 files changed, 120 insertions(+), 87 deletions(-)

diff --git a/packages/tonal/test/tonal.test.mjs b/packages/tonal/test/tonal.test.mjs
index cd8b3c88..5486d513 100644
--- a/packages/tonal/test/tonal.test.mjs
+++ b/packages/tonal/test/tonal.test.mjs
@@ -7,80 +7,113 @@ This program is free software: you can redistribute it and/or modify it under th
 // import { strict as assert } from 'assert';
 
 import '../tonal.mjs'; // need to import this to add prototypes
-import { pure, n, seq, note } from '@strudel/core';
+import { pure, n, seq, note, noteToMidi } from '@strudel/core';
 import { describe, it, expect } from 'vitest';
 import { mini } from '../../mini/mini.mjs';
 
 describe('tonal', () => {
-  it('Should run tonal functions ', () => {
-    expect(pure('c3').scale('C major').scaleTranspose(1).firstCycleValues).toEqual(['D3']);
+  describe('scaleTranspose', () => {
+    it('transposes notes by scale degrees', () => {
+      expect(pure('c3').scale('C major').scaleTranspose(1).firstCycleValues).toEqual(['D3']);
+    });
   });
-  it('scale with plain values', () => {
-    expect(
-      seq(0, 1, 2)
-        .scale('C major')
-        .note()
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C3', 'D3', 'E3']);
+  describe('scale', () => {
+    it('converts plain values', () => {
+      expect(
+        seq(0, 1, 2)
+          .scale('C major')
+          .note()
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C3', 'D3', 'E3']);
+    });
+    it('converts n values', () => {
+      expect(
+        n(seq(0, 1, 2))
+          .scale('C major')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C3', 'D3', 'E3']);
+    });
+    it('converts n values (mini notation)', () => {
+      expect(
+        n(seq(0, 1, 2))
+          .scale('C:major')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C3', 'D3', 'E3']);
+    });
+    it('converts n values (no tonic)', () => {
+      expect(
+        n(seq(0, 1, 2))
+          .scale('major')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C3', 'D3', 'E3']);
+    });
+    it('converts n values (explicit mini notation)', () => {
+      expect(
+        n(seq(0, 1, 2))
+          .scale(mini('C:major'))
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C3', 'D3', 'E3']);
+    });
+    it('converts decorated n values', () => {
+      expect(
+        n(seq('0b', '1#', '-2', '3##', '4bb'))
+          .scale('C major')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['B2', 'Eb3', 'A2', 'G3', 'F3']);
+    });
+    it('produces silence for mixed sharps and flats', () => {
+      expect(
+        n(seq('0b#', '1#b', '2#b#'))
+          .scale('C major')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['', '', '']);
+    });
+    it('snaps notes (upwards) to scale', () => {
+      const inputNotes = ['Cb', 'Eb', 'G', 'A#', 'Bb'];
+      let expectedNotes = ['B2', 'E3', 'G3', 'B3', 'B3'];
+
+      // Notes are converted to midi by scale
+      expectedNotes = expectedNotes.map((note) => noteToMidi(note));
+
+      expect(
+        note(seq(inputNotes))
+          .scale('C major')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(expectedNotes);
+    });
   });
-  it('scale with n values', () => {
-    expect(
-      n(seq(0, 1, 2))
-        .scale('C major')
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C3', 'D3', 'E3']);
-  });
-  it('scale with colon', () => {
-    expect(
-      n(seq(0, 1, 2))
-        .scale('C:major')
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C3', 'D3', 'E3']);
-  });
-  it('scale without tonic', () => {
-    expect(
-      n(seq(0, 1, 2))
-        .scale('major')
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C3', 'D3', 'E3']);
-  });
-  it('scale with mininotation colon', () => {
-    expect(
-      n(seq(0, 1, 2))
-        .scale(mini('C:major'))
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C3', 'D3', 'E3']);
-  });
-  it('transposes note numbers with interval numbers', () => {
-    expect(
-      note(seq(40, 40, 40))
-        .transpose(0, 1, 2)
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual([40, 41, 42]);
-    expect(seq(40, 40, 40).transpose(0, 1, 2).firstCycleValues).toEqual([40, 41, 42]);
-  });
-  it('transposes note numbers with interval strings', () => {
-    expect(
-      note(seq(40, 40, 40))
-        .transpose('1P', '2M', '3m')
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual([40, 42, 43]);
-    expect(seq(40, 40, 40).transpose('1P', '2M', '3m').firstCycleValues).toEqual([40, 42, 43]);
-  });
-  it('transposes note strings with interval numbers', () => {
-    expect(
-      note(seq('c', 'c', 'c'))
-        .transpose(0, 1, 2)
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C', 'Db', 'D']);
-    expect(seq('c', 'c', 'c').transpose(0, 1, 2).firstCycleValues).toEqual(['C', 'Db', 'D']);
-  });
-  it('transposes note strings with interval strings', () => {
-    expect(
-      note(seq('c', 'c', 'c'))
-        .transpose('1P', '2M', '3m')
-        .firstCycleValues.map((h) => h.note),
-    ).toEqual(['C', 'D', 'Eb']);
-    expect(seq('c', 'c', 'c').transpose('1P', '2M', '3m').firstCycleValues).toEqual(['C', 'D', 'Eb']);
+  describe('transpose', () => {
+    it('transposes note numbers with interval numbers', () => {
+      expect(
+        note(seq(40, 40, 40))
+          .transpose(0, 1, 2)
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual([40, 41, 42]);
+      expect(seq(40, 40, 40).transpose(0, 1, 2).firstCycleValues).toEqual([40, 41, 42]);
+    });
+    it('transposes note numbers with interval strings', () => {
+      expect(
+        note(seq(40, 40, 40))
+          .transpose('1P', '2M', '3m')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual([40, 42, 43]);
+      expect(seq(40, 40, 40).transpose('1P', '2M', '3m').firstCycleValues).toEqual([40, 42, 43]);
+    });
+    it('transposes note strings with interval numbers', () => {
+      expect(
+        note(seq('c', 'c', 'c'))
+          .transpose(0, 1, 2)
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C', 'Db', 'D']);
+      expect(seq('c', 'c', 'c').transpose(0, 1, 2).firstCycleValues).toEqual(['C', 'Db', 'D']);
+    });
+    it('transposes note strings with interval strings', () => {
+      expect(
+        note(seq('c', 'c', 'c'))
+          .transpose('1P', '2M', '3m')
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(['C', 'D', 'Eb']);
+      expect(seq('c', 'c', 'c').transpose('1P', '2M', '3m').firstCycleValues).toEqual(['C', 'D', 'Eb']);
+    });
   });
 });
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 5b0c63b9..5e505c75 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -7,7 +7,7 @@ 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, silence, logger, pure, isNote } from '@strudel/core';
 import { stepInNamedScale, scaleToChromas } from './tonleiter.mjs';
-import { noteToMidi } from '../core/util.mjs'
+import { noteToMidi } from '../core/util.mjs';
 
 const octavesInterval = (octaves) => (octaves <= 0 ? -1 : 1) + octaves * 7 + 'P';
 
@@ -175,25 +175,18 @@ export const { scaleTranspose, scaleTrans, strans } = register(
 // Converts a step value, which is a number optionally decorated with sharps and flats,
 // to a number and an `offset` number of semitones
 function _convertStepToNumberAndOffset(step) {
-  if (isNote(step)) {
-    // legacy..
-    return pure(step);
-  }
   let asNumber = Number(step);
   let offset = 0;
   if (isNaN(asNumber)) {
     step = String(step);
     // Check to see if the step matches the expected format:
-    //   - A number (possibly negative)
-    //   - Some number of sharps or flats (but not both)
+    // - A number (possibly negative)
+    // - Some number of sharps or flats (but not both)
     const match = /^(-?\d+)(#+|b+)?$/.exec(step);
 
     if (!match) {
-      logger(
-        `[tonal] invalid scale step "${step}", expected number or integer with optional # b suffixes`,
-        'error',
-      );
-      return silence;
+      logger(`[tonal] invalid scale step "${step}", expected number or integer with optional # b suffixes`, 'error');
+      return [silence, 0];
     }
     asNumber = Number(match[1]);
     // These decorations will determine the semitone offset based on the number of
@@ -210,10 +203,13 @@ function _getNearestScaleNote(scaleName, note) {
   const octave = (midiNote / 12) >> 0;
   const targetChroma = midiNote % 12;
   const scaleChromas = scaleToChromas(scaleName);
-  return scaleChromas.reduce((prev, curr) => {
-    // Include equality so ties are broken upwards
-    return Math.abs(curr - targetChroma) <= Math.abs(prev - targetChroma) ? curr : prev;
-  }) + octave * 12;
+  return (
+    scaleChromas.reduce((prev, curr) => {
+      // Include equality so ties are broken upwards
+      return Math.abs(curr - targetChroma) <= Math.abs(prev - targetChroma) ? curr : prev;
+    }) +
+    octave * 12
+  );
 }
 
 /**
@@ -262,6 +258,10 @@ export const scale = register(
           if ((isObject && 'n' in value) || !isObject) {
             let step = isObject ? value.n : value;
             delete value.n; // remove n so it won't cause trouble
+            if (isNote(step)) {
+              // legacy..
+              return pure(step);
+            }
             let [number, offset] = _convertStepToNumberAndOffset(step);
             try {
               let note;
diff --git a/packages/tonal/tonleiter.mjs b/packages/tonal/tonleiter.mjs
index 63ae9c94..39c819cd 100644
--- a/packages/tonal/tonleiter.mjs
+++ b/packages/tonal/tonleiter.mjs
@@ -238,7 +238,7 @@ export function transpose(note, step) {
 }
 
 // Converts a `scaleName` into a corresponding list of chromas between 0 and 12
-export function scaleToChromas (scaleName) {
+export function scaleToChromas(scaleName) {
   if (Array.isArray(scaleName)) {
     scaleName = scaleName.flat().join(' ');
   }
@@ -247,5 +247,5 @@ export function scaleToChromas (scaleName) {
   const chroma = rootMidi % 12;
   const intervals = Scale.get(name).intervals;
   const scaleSteps = intervals.map(Interval.semitones);
-  return scaleSteps.map(s => (s + chroma) % 12);
+  return scaleSteps.map((s) => (s + chroma) % 12);
 }

From c8c6a2ce08e0fca7857323156ba2a8adf877cd5c Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 15 Aug 2025 13:34:43 -0500
Subject: [PATCH 04/18] Add example test and update fastChunk test (which was
 previously broken)

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

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index eb6c238d..1b5e73d3 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3418,6 +3418,8 @@ exports[`runs examples > example "fast" example index 0 1`] = `
 
 exports[`runs examples > example "fastChunk" example index 0 1`] = `
 [
+  "[ 0/1 → 1/4 | color:red note:0 ]",
+  "[ 1/4 → 1/2 | color:red note:1 ]",
   "[ 1/2 → 3/4 | note:E2 ]",
   "[ 3/4 → 1/1 | note:F2 ]",
   "[ 1/1 → 5/4 | note:G2 ]",
@@ -3426,6 +3428,8 @@ exports[`runs examples > example "fastChunk" example index 0 1`] = `
   "[ 7/4 → 2/1 | note:C3 ]",
   "[ 2/1 → 9/4 | note:D3 ]",
   "[ 9/4 → 5/2 | note:D2 ]",
+  "[ 5/2 → 11/4 | color:red note:2 ]",
+  "[ 11/4 → 3/1 | color:red note:3 ]",
   "[ 3/1 → 13/4 | note:G2 ]",
   "[ 13/4 → 7/2 | note:A2 ]",
   "[ 7/2 → 15/4 | note:B2 ]",
@@ -8414,6 +8418,39 @@ exports[`runs examples > example "scale" example index 2 1`] = `
 ]
 `;
 
+exports[`runs examples > example "scale" example index 3 1`] = `
+[
+  "[ 0/1 → 1/4 | note:C3 s:piano ]",
+  "[ 0/1 → 1/4 | note:B3 s:piano ]",
+  "[ 1/4 → 3/8 | note:Gb2 s:piano ]",
+  "[ 3/8 → 1/2 | note:F2 s:piano ]",
+  "[ 1/2 → 3/4 | note:A2 s:piano ]",
+  "[ 1/2 → 3/4 | note:D4 s:piano ]",
+  "[ 3/4 → 1/1 | note:G3 s:piano ]",
+  "[ 1/1 → 5/4 | note:C3 s:piano ]",
+  "[ 1/1 → 5/4 | note:C4 s:piano ]",
+  "[ 5/4 → 11/8 | note:Gb2 s:piano ]",
+  "[ 11/8 → 3/2 | note:E2 s:piano ]",
+  "[ 3/2 → 7/4 | note:A2 s:piano ]",
+  "[ 3/2 → 7/4 | note:Eb4 s:piano ]",
+  "[ 7/4 → 2/1 | note:F#3 s:piano ]",
+  "[ 2/1 → 9/4 | note:C3 s:piano ]",
+  "[ 2/1 → 9/4 | note:B3 s:piano ]",
+  "[ 9/4 → 19/8 | note:Gb2 s:piano ]",
+  "[ 19/8 → 5/2 | note:F2 s:piano ]",
+  "[ 5/2 → 11/4 | note:Ab2 s:piano ]",
+  "[ 5/2 → 11/4 | note:D4 s:piano ]",
+  "[ 11/4 → 3/1 | note:G3 s:piano ]",
+  "[ 3/1 → 13/4 | note:C3 s:piano ]",
+  "[ 3/1 → 13/4 | note:C4 s:piano ]",
+  "[ 13/4 → 27/8 | note:Gb2 s:piano ]",
+  "[ 27/8 → 7/2 | note:E2 s:piano ]",
+  "[ 7/2 → 15/4 | note:Ab2 s:piano ]",
+  "[ 7/2 → 15/4 | note:Eb4 s:piano ]",
+  "[ 15/4 → 4/1 | note:F#3 s:piano ]",
+]
+`;
+
 exports[`runs examples > example "scaleTranspose" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | note:C3 ]",

From 4f15d681b0cdccf1410c1107567c1f194d08e130 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Thu, 21 Aug 2025 13:12:36 -0500
Subject: [PATCH 05/18] Add release parameter, avoid clicks, some cleanup

---
 packages/core/controls.mjs         | 56 ++++++++++++--------
 packages/superdough/superdough.mjs | 84 ++++++++++++++++++------------
 2 files changed, 87 insertions(+), 53 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index e6181d45..4d6f8d8b 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -141,8 +141,8 @@ export const { note } = registerControl(['note', 'n']);
  */
 export const { accelerate } = registerControl('accelerate');
 /**
- *
  * Sets the velocity from 0 to 1. Is multiplied together with gain.
+ *
  * @name velocity
  * @example
  * s("hh*8")
@@ -254,7 +254,7 @@ export const { fmenv } = registerControl('fmenv');
 export const { fmattack } = registerControl('fmattack');
 
 /**
- * waveform of the fm modulator
+ * Waveform of the fm modulator
  *
  * @name fmwave
  * @param {number | Pattern} wave waveform
@@ -377,7 +377,7 @@ export const { bandf, bpf, bp } = registerControl(['bandf', 'bandq', 'bpenv'], '
 // ['bpq'],
 export const { bandq, bpq } = registerControl('bandq', 'bpq');
 /**
- * a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
+ * A pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
  *
  * @memberof Pattern
  * @name begin
@@ -438,7 +438,7 @@ export const { loopBegin, loopb } = registerControl('loopBegin', 'loopb');
  */
 export const { loopEnd, loope } = registerControl('loopEnd', 'loope');
 /**
- * bit crusher effect.
+ * Bit crusher effect.
  *
  * @name crush
  * @param {number | Pattern} depth between 1 (for drastic reduction in bit-depth) to 16 (for barely no reduction).
@@ -449,7 +449,7 @@ export const { loopEnd, loope } = registerControl('loopEnd', 'loope');
 // ['clhatdecay'],
 export const { crush } = registerControl('crush');
 /**
- * fake-resampling for lowering the sample rate. Caution: This effect seems to only work in chromium based browsers
+ * Fake-resampling for lowering the sample rate. Caution: This effect seems to only work in chromium based browsers
  *
  * @name coarse
  * @param {number | Pattern} factor 1 for original 2 for half, 3 for a third and so on.
@@ -460,7 +460,7 @@ export const { crush } = registerControl('crush');
 export const { coarse } = registerControl('coarse');
 
 /**
- * modulate the amplitude of a sound with a continuous waveform
+ * Modulate the amplitude of a sound with a continuous waveform
  *
  * @name tremolo
  * @synonyms trem
@@ -472,7 +472,7 @@ export const { coarse } = registerControl('coarse');
 export const { tremolo } = registerControl(['tremolo', 'tremolodepth', 'tremoloskew', 'tremolophase'], 'trem');
 
 /**
- * modulate the amplitude of a sound with a continuous waveform
+ * Modulate the amplitude of a sound with a continuous waveform
  *
  * @name tremolosync
  * @synonyms tremsync
@@ -487,7 +487,7 @@ export const { tremolosync } = registerControl(
 );
 
 /**
- * depth of amplitude modulation
+ * Depth of amplitude modulation
  *
  * @name tremolodepth
  * @synonyms tremdepth
@@ -498,7 +498,7 @@ export const { tremolosync } = registerControl(
  */
 export const { tremolodepth } = registerControl('tremolodepth', 'tremdepth');
 /**
- * alter the shape of the modulation waveform
+ * Alter the shape of the modulation waveform
  *
  * @name tremoloskew
  * @synonyms tremskew
@@ -510,7 +510,7 @@ export const { tremolodepth } = registerControl('tremolodepth', 'tremdepth');
 export const { tremoloskew } = registerControl('tremoloskew', 'tremskew');
 
 /**
- * alter the phase of the modulation waveform
+ * Alter the phase of the modulation waveform
  *
  * @name tremolophase
  * @synonyms tremphase
@@ -522,7 +522,7 @@ export const { tremoloskew } = registerControl('tremoloskew', 'tremskew');
 export const { tremolophase } = registerControl('tremolophase', 'tremphase');
 
 /**
- * shape of amplitude modulation
+ * Shape of amplitude modulation
  *
  * @name tremoloshape
  * @param {number | Pattern} shape tri | square | sine | saw | ramp
@@ -532,7 +532,7 @@ export const { tremolophase } = registerControl('tremolophase', 'tremphase');
  */
 export const { tremoloshape } = registerControl('tremoloshape', 'tremshape');
 /**
- * filter overdrive for supported filter types
+ * Filter overdrive for supported filter types
  *
  * @name drive
  * @param {number | Pattern} amount
@@ -542,7 +542,7 @@ export const { tremoloshape } = registerControl('tremoloshape', 'tremshape');
  */
 
 /**
- * modulate the amplitude of an orbit to create a "sidechain" like effect
+ * Modulate the amplitude of an orbit to create a "sidechain" like effect
  *
  * @name duckorbit
  * @param {number | Pattern} orbit target orbit
@@ -554,7 +554,7 @@ export const { tremoloshape } = registerControl('tremoloshape', 'tremshape');
 export const { duck } = registerControl('duckorbit', 'duck');
 
 /**
- *  the amount of ducking applied to target orbit
+ * The amount of ducking applied to target orbit
  *
  * @name duckdepth
  * @param {number | Pattern} depth depth of modulation from 0 to 1
@@ -566,16 +566,30 @@ export const { duck } = registerControl('duckorbit', 'duck');
 export const { duckdepth } = registerControl('duckdepth');
 
 /**
- *  the attack time of the duck effect
+ * The attack time of the duck effect. Can be used to prevent clicking or for creative rhythmic effects
  *
  * @name duckattack
  * @param {number | Pattern} time
  * @example
- * stack( n(run(8)).scale("c:minor").s("sawtooth").delay(.7).orbit(2), s("bd:4!4").beat("0,4,8,11,14",16).duckorbit(2).duckattack("<0.2 0 0.4>").duckdepth(1))
+ * sound: n(run(8)).scale("c:minor").s("sawtooth").lpf(200).delay(.7).orbit(2)
+ * duckerWithClick: s("bd*4").duckorbit(2).duckattack(0).postgain(0)
+ * _duckerWithoutClick: s("bd*4").duckorbit(2).duckattack(0.003).postgain(0)
  *
  */
 export const { duckattack } = registerControl('duckattack', 'duckatt');
 
+/**
+ * The release time of the duck effect
+ *
+ * @name duckrelease
+ * @param {number | Pattern} time
+ * @example
+ * sound: n(run(8)).scale("c:minor").s("sawtooth").delay(.7).orbit(2)
+ * ducker: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit(2).duckrelease("<0.2 0 0.4>").duckdepth(1)
+ *
+ */
+export const { duckrelease } = registerControl('duckrelease', 'duckrelease');
+
 export const { drive } = registerControl('drive');
 
 /**
@@ -618,7 +632,7 @@ export const { byteBeatStartTime, bbst } = registerControl('byteBeatStartTime',
 export const { channels, ch } = registerControl('channels', 'ch');
 
 /**
- * controls the pulsewidth of the pulse oscillator
+ * Controls the pulsewidth of the pulse oscillator
  *
  * @name pw
  * @param {number | Pattern} pulsewidth
@@ -630,7 +644,7 @@ export const { channels, ch } = registerControl('channels', 'ch');
 export const { pw } = registerControl(['pw', 'pwrate', 'pwsweep']);
 
 /**
- * controls the lfo rate for the pulsewidth of the pulse oscillator
+ * Controls the lfo rate for the pulsewidth of the pulse oscillator
  *
  * @name pwrate
  * @param {number | Pattern} rate
@@ -642,7 +656,7 @@ export const { pw } = registerControl(['pw', 'pwrate', 'pwsweep']);
 export const { pwrate } = registerControl('pwrate');
 
 /**
- * controls the lfo sweep for the pulsewidth of the pulse oscillator
+ * Controls the lfo sweep for the pulsewidth of the pulse oscillator
  *
  * @name pwsweep
  * @param {number | Pattern} sweep
@@ -683,7 +697,7 @@ export const { phaserrate, ph, phaser } = registerControl(
 export const { phasersweep, phs } = registerControl('phasersweep', 'phs');
 
 /**
- *  The center frequency of the phaser in HZ. Defaults to 1000
+ * The center frequency of the phaser in HZ. Defaults to 1000
  *
  * @name phasercenter
  * @synonyms phc
@@ -711,7 +725,7 @@ export const { phasercenter, phc } = registerControl('phasercenter', 'phc');
 export const { phaserdepth, phd, phasdp } = registerControl('phaserdepth', 'phd', 'phasdp');
 
 /**
- * choose the channel the pattern is sent to in superdirt
+ * Choose the channel the pattern is sent to in superdirt
  *
  * @name channel
  * @param {number | Pattern} channel channel number
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index eb1466d9..a7572724 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -331,18 +331,19 @@ function getDelay(orbit, delaytime, delayfeedback, t, channels) {
     //logger(`delayfeedback was clamped to ${maxfeedback} to save your ears`);
   }
   delayfeedback = clamp(delayfeedback, 0, 0.98);
-  if (!orbits[orbit].delayNode) {
+  let delayNode = orbits[orbit].delayNode;
+  if (delayNode === undefined) {
     const ac = getAudioContext();
     const dly = ac.createFeedbackDelay(1, delaytime, delayfeedback);
     dly.start?.(t); // for some reason, this throws when audion extension is installed..
     connectToOrbit(dly, orbit);
-    orbits[orbit].delayNode = dly;
+    delayNode = dly;
   }
-  orbits[orbit].delayNode.delayTime.value !== delaytime &&
-    orbits[orbit].delayNode.delayTime.setValueAtTime(delaytime, t);
-  orbits[orbit].delayNode.feedback.value !== delayfeedback &&
-    orbits[orbit].delayNode.feedback.setValueAtTime(delayfeedback, t);
-  return orbits[orbit].delayNode;
+  delayNode.delayTime.value !== delaytime &&
+    delayNode.delayTime.setValueAtTime(delaytime, t);
+  delayNode.feedback.value !== delayfeedback &&
+    delayNode.feedback.setValueAtTime(delayfeedback, t);
+  return delayNode;
 }
 
 export function getLfo(audioContext, begin, end, properties = {}) {
@@ -398,42 +399,59 @@ function getFilterType(ftype) {
   return typeof ftype === 'number' ? filterTypes[Math.floor(_mod(ftype, filterTypes.length))] : ftype;
 }
 
-//type orbit {
-// gain: number,
-// reverbNode: reverbNode
-// delayNode: delayNode
-//}
+// type orbit {
+//   output: GainNode,
+//   reverbNode: ConvolverNode
+//   delayNode: FeedbackDelayNode
+// }
 let orbits = {};
 function connectToOrbit(node, orbit) {
   if (orbits[orbit] == null) {
     errorLogger(new Error('target orbit does not exist'), 'superdough');
   }
-  node.connect(orbits[orbit].gain);
+  node.connect(orbits[orbit].output);
 }
 
 function setOrbit(audioContext, orbit, channels) {
   if (orbits[orbit] == null) {
     orbits[orbit] = {
-      gain: new GainNode(audioContext, { gain: 1 }),
+      // Setup output node through which all audio filters prior to hitting
+      // the destination (and thus allows for global volume automation)
+      output: new GainNode(audioContext, { gain: 1 }),
     };
-    connectToDestination(orbits[orbit].gain, channels);
+    connectToDestination(orbits[orbit].output, channels);
   }
 }
-function duckOrbit(audioContext, targetOrbit, t, attacktime = 0.1, duckdepth = 1) {
-  const targetArr = [targetOrbit].flat();
 
-  targetArr.forEach((target) => {
+function duckOrbit(audioContext, targetOrbit, t, attacktime = 0.003, releasetime = 0.1, duckdepth = 1) {
+  const targetArr = [targetOrbit].flat();
+  const attackArr = [attacktime].flat();
+  const releaseArr = [releasetime].flat();
+  const depthArr = [duckdepth].flat();
+
+  targetArr.forEach((target, idx) => {
     if (orbits[target] == null) {
       errorLogger(new Error(`duck target orbit ${target} does not exist`), 'superdough');
       return;
     }
+    const attack = attackArr[idx] ?? attackArr[0];
+    const release = Math.max(releaseArr[idx] ?? releaseArr[0], 0.002);
+    const depth = depthArr[idx] ?? depthArr[0];
+    const gainParam = orbits[target].output.gain;
     webAudioTimeout(
       audioContext,
       () => {
-        orbits[target].gain.gain.cancelScheduledValues(t);
-        const currVal = orbits[target].gain.gain.value;
-        orbits[target].gain.gain.linearRampToValueAtTime(clamp(1 - Math.pow(duckdepth, 0.5), 0.01, currVal), t);
-        orbits[target].gain.gain.exponentialRampToValueAtTime(1, t + Math.max(0.002, attacktime));
+        gainParam.cancelScheduledValues(t);
+        const currVal = gainParam.value;
+        const duckedVal = clamp(1 - Math.sqrt(depth), 0.01, currVal);
+
+        // Guarantees the value is set to currVal at time t. This in conjunction with
+        // cancelScheduledValues above emulates cancelAndHoldAtTime on browsers which lack
+        // that method
+        gainParam.setValueAtTime(currVal, t);
+
+        gainParam.exponentialRampToValueAtTime(duckedVal, t + attack);
+        gainParam.exponentialRampToValueAtTime(1, t + attack + release);
       },
       0,
       t - 0.01,
@@ -444,27 +462,28 @@ function duckOrbit(audioContext, targetOrbit, t, attacktime = 0.1, duckdepth = 1
 let hasChanged = (now, before) => now !== undefined && now !== before;
 function getReverb(orbit, duration, fade, lp, dim, ir) {
   // If no reverb has been created for a given orbit, create one
-  if (!orbits[orbit].reverbNode) {
+  let reverbNode = orbits[orbit].reverbNode;
+  if (reverbNode === undefined) {
     const ac = getAudioContext();
     const reverb = ac.createReverb(duration, fade, lp, dim, ir);
     connectToOrbit(reverb, orbit);
-    orbits[orbit].reverbNode = reverb;
+    reverbNode = reverb;
   }
   if (
-    hasChanged(duration, orbits[orbit].reverbNode.duration) ||
-    hasChanged(fade, orbits[orbit].reverbNode.fade) ||
-    hasChanged(lp, orbits[orbit].reverbNode.lp) ||
-    hasChanged(dim, orbits[orbit].reverbNode.dim) ||
-    orbits[orbit].reverbNode.ir !== ir
+    hasChanged(duration, reverbNode.duration) ||
+    hasChanged(fade, reverbNode.fade) ||
+    hasChanged(lp, reverbNode.lp) ||
+    hasChanged(dim, reverbNode.dim) ||
+    reverbNode.ir !== ir
   ) {
     // only regenerate when something has changed
     // avoids endless regeneration on things like
     // stack(s("a"), s("b").rsize(8)).room(.5)
     // this only works when args may stay undefined until here
     // setting default values breaks this
-    orbits[orbit].reverbNode.generate(duration, fade, lp, dim, ir);
+    reverbNode.generate(duration, fade, lp, dim, ir);
   }
-  return orbits[orbit].reverbNode;
+  return reverbNode;
 }
 
 export let analysers = {},
@@ -562,6 +581,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     density = getDefaultValue('density'),
     duckorbit,
     duckattack,
+    duckrelease,
     duckdepth,
     // filters
     fanchor = getDefaultValue('fanchor'),
@@ -640,7 +660,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   setOrbit(ac, orbit, channels, t, cycle, cps);
 
   if (duckorbit != null) {
-    duckOrbit(ac, duckorbit, t, duckattack, duckdepth);
+    duckOrbit(ac, duckorbit, t, duckattack, duckrelease, duckdepth);
   }
 
   gain = applyGainCurve(nanFallback(gain, 1));

From bf5d9917ab8366e2d82289945405cc3721b448f6 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Thu, 21 Aug 2025 13:20:12 -0500
Subject: [PATCH 06/18] Codeformat and examples

---
 packages/codemirror/autocomplete.mjs      |  2 +-
 packages/superdough/superdough.mjs        |  6 +--
 test/__snapshots__/examples.test.mjs.snap | 57 -----------------------
 website/src/pages/learn/samples.mdx       |  2 +-
 website/src/repl/Repl.css                 |  1 -
 5 files changed, 4 insertions(+), 64 deletions(-)

diff --git a/packages/codemirror/autocomplete.mjs b/packages/codemirror/autocomplete.mjs
index d3091d87..c0845895 100644
--- a/packages/codemirror/autocomplete.mjs
+++ b/packages/codemirror/autocomplete.mjs
@@ -74,7 +74,7 @@ const hasExcludedTags = (doc) =>
 
 const jsdocCompletions = jsdoc.docs
   .filter((doc) => isValidDoc(doc) && !hasExcludedTags(doc))
-   // https://codemirror.net/docs/ref/#autocomplete.Completion
+  // https://codemirror.net/docs/ref/#autocomplete.Completion
   .map((doc) => ({
     label: getDocLabel(doc),
     // detail: 'xxx', // An optional short piece of information to show (with a different style) after the label.
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index a7572724..b8975a85 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -339,10 +339,8 @@ function getDelay(orbit, delaytime, delayfeedback, t, channels) {
     connectToOrbit(dly, orbit);
     delayNode = dly;
   }
-  delayNode.delayTime.value !== delaytime &&
-    delayNode.delayTime.setValueAtTime(delaytime, t);
-  delayNode.feedback.value !== delayfeedback &&
-    delayNode.feedback.setValueAtTime(delayfeedback, t);
+  delayNode.delayTime.value !== delaytime && delayNode.delayTime.setValueAtTime(delaytime, t);
+  delayNode.feedback.value !== delayfeedback && delayNode.feedback.setValueAtTime(delayfeedback, t);
   return delayNode;
 }
 
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 39874935..6002fa84 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3036,63 +3036,6 @@ exports[`runs examples > example "dry" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "duckattack" example index 0 1`] = `
-[
-  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 0/1 → 1/8 | note:C3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 1/8 → 1/4 | note:D3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 1/4 → 3/8 | note:Eb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 3/8 → 1/2 | note:F3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 1/2 → 5/8 | note:G3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 5/8 → 3/4 | note:Ab3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 3/4 → 7/8 | note:Bb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 7/8 → 1/1 | note:C4 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
-  "[ 1/1 → 9/8 | note:C3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 9/8 → 5/4 | note:D3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
-  "[ 5/4 → 11/8 | note:Eb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 11/8 → 3/2 | note:F3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
-  "[ 3/2 → 13/8 | note:G3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 13/8 → 7/4 | note:Ab3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
-  "[ 7/4 → 15/8 | note:Bb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
-  "[ 15/8 → 2/1 | note:C4 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
-  "[ 2/1 → 17/8 | note:C3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 17/8 → 9/4 | note:D3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
-  "[ 9/4 → 19/8 | note:Eb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 19/8 → 5/2 | note:F3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
-  "[ 5/2 → 21/8 | note:G3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 21/8 → 11/4 | note:Ab3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
-  "[ 11/4 → 23/8 | note:Bb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
-  "[ 23/8 → 3/1 | note:C4 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 3/1 → 25/8 | note:C3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 25/8 → 13/4 | note:D3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 13/4 → 27/8 | note:Eb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 27/8 → 7/2 | note:F3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 7/2 → 29/8 | note:G3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 29/8 → 15/4 | note:Ab3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 15/4 → 31/8 | note:Bb3 s:sawtooth delay:0.7 orbit:2 ]",
-  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
-  "[ 31/8 → 4/1 | note:C4 s:sawtooth delay:0.7 orbit:2 ]",
-]
-`;
-
 exports[`runs examples > example "duckdepth" example index 0 1`] = `
 [
   "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
diff --git a/website/src/pages/learn/samples.mdx b/website/src/pages/learn/samples.mdx
index 47531974..0deb6070 100644
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@@ -363,7 +363,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
 
diff --git a/website/src/repl/Repl.css b/website/src/repl/Repl.css
index 62e7dcf2..b8443081 100644
--- a/website/src/repl/Repl.css
+++ b/website/src/repl/Repl.css
@@ -198,5 +198,4 @@
 }
 
 .autocomplete-info-tooltip::-webkit-scrollbar-thumb:hover {
-
 }

From 9a9fe83f9c341d5689475854c78de7ace8043d0a Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Thu, 21 Aug 2025 14:13:01 -0500
Subject: [PATCH 07/18] Example tests

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

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 6002fa84..85079269 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3036,6 +3036,27 @@ exports[`runs examples > example "dry" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "duckattack" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+]
+`;
+
 exports[`runs examples > example "duckdepth" example index 0 1`] = `
 [
   "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
@@ -3118,6 +3139,31 @@ exports[`runs examples > example "duckorbit" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "duckrelease" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
+  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
+  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
+  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
+  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
+  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
+  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
+  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
+  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
+  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
+  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+]
+`;
+
 exports[`runs examples > example "duration" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:c s:piano duration:0.5 ]",

From b08890bd9e7604ca374b954d655c5c3e5333d991 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 22 Aug 2025 11:25:13 -0500
Subject: [PATCH 08/18] Working version with note names

---
 packages/tonal/test/tonal.test.mjs | 25 ++++++++--
 packages/tonal/tonal.mjs           | 79 ++++++++++++++++++++----------
 packages/tonal/tonleiter.mjs       | 17 +------
 3 files changed, 75 insertions(+), 46 deletions(-)

diff --git a/packages/tonal/test/tonal.test.mjs b/packages/tonal/test/tonal.test.mjs
index 5486d513..a64b455b 100644
--- a/packages/tonal/test/tonal.test.mjs
+++ b/packages/tonal/test/tonal.test.mjs
@@ -70,10 +70,7 @@ describe('tonal', () => {
     });
     it('snaps notes (upwards) to scale', () => {
       const inputNotes = ['Cb', 'Eb', 'G', 'A#', 'Bb'];
-      let expectedNotes = ['B2', 'E3', 'G3', 'B3', 'B3'];
-
-      // Notes are converted to midi by scale
-      expectedNotes = expectedNotes.map((note) => noteToMidi(note));
+      const expectedNotes = ['B2', 'E3', 'G3', 'B3', 'B3'];
 
       expect(
         note(seq(inputNotes))
@@ -81,6 +78,26 @@ describe('tonal', () => {
           .firstCycleValues.map((h) => h.note),
       ).toEqual(expectedNotes);
     });
+    it('snaps notes to the correct octave', () => {
+      const inputNotes = ['Cb0', 'Eb4', 'G1', 'A#19', 'Bb8'];
+      const expectedNotes = ['B#0', 'D#4', 'G#1', 'A#19', 'A#8'];
+
+      expect(
+        note(seq(inputNotes))
+          .scale('A# minor') // A#, B#, C#, D#, E#, F#, G#
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(expectedNotes);
+    });
+    it('handles scale names provided with colons', () => {
+      const inputNotes = ['Cb', 'E', 'G', 'A#', 'Bb'];
+      const expectedNotes = ['A#2', 'D#3', 'G#3', 'A#3', 'A#3'];
+
+      expect(
+        note(seq(inputNotes))
+          .scale('F#:pentatonic') // F#, G#, A#, C#, and D#
+          .firstCycleValues.map((h) => h.note),
+      ).toEqual(expectedNotes);
+    });
   });
   describe('transpose', () => {
     it('transposes note numbers with interval numbers', () => {
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 5e505c75..28e2606e 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -6,20 +6,28 @@ 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, silence, logger, pure, isNote } from '@strudel/core';
-import { stepInNamedScale, scaleToChromas } from './tonleiter.mjs';
+import { stepInNamedScale, nearestNumberIndex } from './tonleiter.mjs';
 import { noteToMidi } from '../core/util.mjs';
 
 const octavesInterval = (octaves) => (octaves <= 0 ? -1 : 1) + octaves * 7 + 'P';
 
-function scaleStep(step, scale) {
-  scale = scale.replaceAll(':', ' ');
-  step = Math.ceil(step);
-  let { intervals, tonic, empty } = Scale.get(scale);
-  if ((empty && isNote(scale)) || (empty && !tonic)) {
-    throw new Error(`incomplete scale. Make sure to use ":" instead of spaces, example: .scale("C:major")`);
+function getScale(scaleName) {
+  scaleName = scaleName.replaceAll(':', ' ');
+  const scale = Scale.get(scaleName);
+  const { tonic, empty } = scale;
+  if ((empty && isNote(scaleName)) || (empty && !tonic)) {
+    throw new Error(
+      `Scale name ${scaleName} is incomplete. Make sure to use ":" instead of spaces, example: .scale("C:major")`,
+    );
   } else if (empty) {
-    throw new Error(`invalid scale "${scale}"`);
+    throw new Error(`Invalid scale name "${scaleName}"`);
   }
+  return scale;
+}
+
+function scaleStep(step, scale) {
+  step = Math.ceil(step);
+  let { intervals, tonic } = getScale(scale);
   tonic = tonic || 'C';
   const { pc, oct = 3 } = Note.get(tonic);
   const octaveOffset = Math.floor(step / intervals.length);
@@ -31,8 +39,7 @@ function scaleStep(step, scale) {
 // transpose note inside scale by offset steps
 // function scaleOffset(scale: string, offset: number, note: string) {
 function scaleOffset(scale, offset, note) {
-  let [tonic, scaleName] = Scale.tokenize(scale);
-  let { notes } = Scale.get(`${tonic} ${scaleName}`);
+  let { notes } = getScale(scale);
   notes = notes.map((note) => Note.get(note).pc); // use only pc!
   offset = Number(offset);
   if (isNaN(offset)) {
@@ -197,19 +204,37 @@ function _convertStepToNumberAndOffset(step) {
   return [asNumber, offset];
 }
 
+let scaleToMidisAndNotes = {};
 // Finds the nearest scale note to `note`
-function _getNearestScaleNote(scaleName, note) {
-  let midiNote = typeof note === 'string' ? noteToMidi(note) : note;
-  const octave = (midiNote / 12) >> 0;
-  const targetChroma = midiNote % 12;
-  const scaleChromas = scaleToChromas(scaleName);
-  return (
-    scaleChromas.reduce((prev, curr) => {
-      // Include equality so ties are broken upwards
-      return Math.abs(curr - targetChroma) <= Math.abs(prev - targetChroma) ? curr : prev;
-    }) +
-    octave * 12
-  );
+function _getNearestScaleNote(scaleName, note, preferHigher = true) {
+  let noteMidi = typeof note === 'string' ? noteToMidi(note) : note;
+  noteMidi = Math.max(noteMidi, 24); // we will not play notes below C0
+  if (scaleToMidisAndNotes[scaleName] === undefined) {
+    const { intervals, tonic } = getScale(scaleName);
+    const { pc } = Note.get(tonic);
+    const expandedIntervals = intervals.concat('8P'); // add the octave for wrapping
+    const sNotes = expandedIntervals.map((interval) => Note.transpose(pc + '0', interval));
+    const sMidi = sNotes.map(noteToMidi);
+    // Cache
+    scaleToMidisAndNotes[scaleName] = [sMidi, sNotes];
+  }
+  const [scaleMidis, scaleNotes] = scaleToMidisAndNotes[scaleName];
+  const rootMidi = scaleMidis[0];
+  const octaveDiff = Math.floor((noteMidi - rootMidi) / 12);
+  let filteredNotes = []; // we must filter the notes to avoid negative octave values
+  let filteredMidis = [];
+  for (let i = 0; i < scaleMidis.length; i++) {
+    const newMidi = scaleMidis[i] + 12 * octaveDiff;
+    if (newMidi < 24) {
+      continue;
+    }
+    filteredMidis.push(newMidi);
+    const oldNote = scaleNotes[i];
+    const newNote = Note.transpose(oldNote, Interval.fromSemitones(12 * octaveDiff));
+    filteredNotes.push(newNote);
+  }
+  const noteIdx = nearestNumberIndex(noteMidi, filteredMidis, preferHigher);
+  return filteredNotes[noteIdx];
 }
 
 /**
@@ -254,15 +279,15 @@ export const scale = register(
       pat
         .fmap((value) => {
           const isObject = typeof value === 'object';
-          // The case where the note has been defined via `n`
-          if ((isObject && 'n' in value) || !isObject) {
-            let step = isObject ? value.n : value;
+          // The case where the note has been defined via `n` or `pure`
+          if (!isObject || (isObject && ('n' in value || 'value' in value))) {
+            const step = isObject ? (value.n ?? value.value) : value;
             delete value.n; // remove n so it won't cause trouble
             if (isNote(step)) {
               // legacy..
               return pure(step);
             }
-            let [number, offset] = _convertStepToNumberAndOffset(step);
+            const [number, offset] = _convertStepToNumberAndOffset(step);
             try {
               let note;
               if (isObject && value.anchor) {
@@ -280,7 +305,7 @@ export const scale = register(
           }
           // The case where the note has been defined via `note`
           else {
-            let note = _getNearestScaleNote(scale, value.note);
+            const note = _getNearestScaleNote(scale, value.note);
             return pure(isObject ? { ...value, note } : note);
           }
         })
diff --git a/packages/tonal/tonleiter.mjs b/packages/tonal/tonleiter.mjs
index 39c819cd..23312964 100644
--- a/packages/tonal/tonleiter.mjs
+++ b/packages/tonal/tonleiter.mjs
@@ -101,11 +101,11 @@ export function nearestNumberIndex(target, numbers, preferHigher) {
 let scaleSteps = {}; // [scaleName]: semitones[]
 
 export function stepInNamedScale(step, scale, anchor, preferHigher) {
-  let [root, scaleName] = Scale.tokenize(scale);
+  const [root, scaleName] = Scale.tokenize(scale);
   const rootMidi = x2midi(root);
   const rootChroma = midi2chroma(rootMidi);
   if (!scaleSteps[scaleName]) {
-    let { intervals } = Scale.get(`C ${scaleName}`);
+    const { intervals } = Scale.get(`C ${scaleName}`);
     // cache result
     scaleSteps[scaleName] = intervals.map(step2semitones);
   }
@@ -236,16 +236,3 @@ export function transpose(note, step) {
   const offsetAccidentals = accidentalString(Step.accidentals(step) + Note.accidentals(note) + stepIndex - indexOffset); // "we need to add a # to to the G to make it a major third from E"
   return [targetNote, offsetAccidentals].join('');
 }
-
-// Converts a `scaleName` into a corresponding list of chromas between 0 and 12
-export function scaleToChromas(scaleName) {
-  if (Array.isArray(scaleName)) {
-    scaleName = scaleName.flat().join(' ');
-  }
-  const [tonic, name] = Scale.tokenize(scaleName);
-  const rootMidi = noteToMidi(tonic);
-  const chroma = rootMidi % 12;
-  const intervals = Scale.get(name).intervals;
-  const scaleSteps = intervals.map(Interval.semitones);
-  return scaleSteps.map((s) => (s + chroma) % 12);
-}

From 79453ac2c3c71a1ba4d2ce34471cd125a2744cd5 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 22 Aug 2025 13:17:13 -0500
Subject: [PATCH 09/18] Allow negatives and multi-accidentals

---
 packages/core/util.mjs             |  4 ++--
 packages/superdough/util.mjs       |  2 +-
 packages/tonal/test/tonal.test.mjs |  2 +-
 packages/tonal/tonal.mjs           | 24 +++++-------------------
 4 files changed, 9 insertions(+), 23 deletions(-)

diff --git a/packages/core/util.mjs b/packages/core/util.mjs
index 2e7c6e02..ef3f1e96 100644
--- a/packages/core/util.mjs
+++ b/packages/core/util.mjs
@@ -8,12 +8,12 @@ import { logger } from './logger.mjs';
 
 // returns true if the given string is a note
 export const isNoteWithOctave = (name) => /^[a-gA-G][#bs]*[0-9]$/.test(name);
-export const isNote = (name) => /^[a-gA-G][#bsf]*[0-9]?$/.test(name);
+export const isNote = (name) => /^[a-gA-G][#bsf]*-?[0-9]?$/.test(name);
 export const tokenizeNote = (note) => {
   if (typeof note !== 'string') {
     return [];
   }
-  const [pc, acc = '', oct] = note.match(/^([a-gA-G])([#bsf]*)([0-9]*)$/)?.slice(1) || [];
+  const [pc, acc = '', oct] = note.match(/^([a-gA-G])([#bsf]*)(-?[0-9]*)$/)?.slice(1) || [];
   if (!pc) {
     return [];
   }
diff --git a/packages/superdough/util.mjs b/packages/superdough/util.mjs
index f4d59024..764ebb43 100644
--- a/packages/superdough/util.mjs
+++ b/packages/superdough/util.mjs
@@ -7,7 +7,7 @@ export const tokenizeNote = (note) => {
   if (typeof note !== 'string') {
     return [];
   }
-  const [pc, acc = '', oct] = note.match(/^([a-gA-G])([#bsf]*)([0-9]*)$/)?.slice(1) || [];
+  const [pc, acc = '', oct] = note.match(/^([a-gA-G])([#bsf]*)(-?[0-9]*)$/)?.slice(1) || [];
   if (!pc) {
     return [];
   }
diff --git a/packages/tonal/test/tonal.test.mjs b/packages/tonal/test/tonal.test.mjs
index a64b455b..cb856fa9 100644
--- a/packages/tonal/test/tonal.test.mjs
+++ b/packages/tonal/test/tonal.test.mjs
@@ -80,7 +80,7 @@ describe('tonal', () => {
     });
     it('snaps notes to the correct octave', () => {
       const inputNotes = ['Cb0', 'Eb4', 'G1', 'A#19', 'Bb8'];
-      const expectedNotes = ['B#0', 'D#4', 'G#1', 'A#19', 'A#8'];
+      const expectedNotes = ['B#-1', 'D#4', 'G#1', 'A#19', 'A#8'];
 
       expect(
         note(seq(inputNotes))
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 28e2606e..2ec698c3 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -128,10 +128,7 @@ export const { transpose, trans } = register(['transpose', 'trans'], function tr
     const interval = !isNaN(Number(intervalOrSemitones))
       ? Interval.fromSemitones(intervalOrSemitones)
       : String(intervalOrSemitones);
-    // TODO: move simplify to player to preserve enharmonics
-    // tone.js doesn't understand multiple sharps flats e.g. F##3 has to be turned into G3
-    // TODO: check if this is still relevant..
-    const targetNote = Note.simplify(Note.transpose(note, interval));
+    const targetNote = Note.transpose(note, interval);
     if (typeof hap.value === 'object') {
       return hap.withValue(() => ({ ...hap.value, note: targetNote }));
     }
@@ -208,7 +205,6 @@ let scaleToMidisAndNotes = {};
 // Finds the nearest scale note to `note`
 function _getNearestScaleNote(scaleName, note, preferHigher = true) {
   let noteMidi = typeof note === 'string' ? noteToMidi(note) : note;
-  noteMidi = Math.max(noteMidi, 24); // we will not play notes below C0
   if (scaleToMidisAndNotes[scaleName] === undefined) {
     const { intervals, tonic } = getScale(scaleName);
     const { pc } = Note.get(tonic);
@@ -221,20 +217,10 @@ function _getNearestScaleNote(scaleName, note, preferHigher = true) {
   const [scaleMidis, scaleNotes] = scaleToMidisAndNotes[scaleName];
   const rootMidi = scaleMidis[0];
   const octaveDiff = Math.floor((noteMidi - rootMidi) / 12);
-  let filteredNotes = []; // we must filter the notes to avoid negative octave values
-  let filteredMidis = [];
-  for (let i = 0; i < scaleMidis.length; i++) {
-    const newMidi = scaleMidis[i] + 12 * octaveDiff;
-    if (newMidi < 24) {
-      continue;
-    }
-    filteredMidis.push(newMidi);
-    const oldNote = scaleNotes[i];
-    const newNote = Note.transpose(oldNote, Interval.fromSemitones(12 * octaveDiff));
-    filteredNotes.push(newNote);
-  }
-  const noteIdx = nearestNumberIndex(noteMidi, filteredMidis, preferHigher);
-  return filteredNotes[noteIdx];
+  const alignedMidis = scaleMidis.map((m) => m + 12 * octaveDiff);
+  const noteIdx = nearestNumberIndex(noteMidi, alignedMidis, preferHigher);
+  const noteMatch = scaleNotes[noteIdx];
+  return Note.transpose(noteMatch, Interval.fromSemitones(12 * octaveDiff));
 }
 
 /**

From b8c46d6b26f7b3d5864c3f3b02e1ec90468a510d Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 22 Aug 2025 13:23:41 -0500
Subject: [PATCH 10/18] Added some description and examples of
 multi-accidentals and negative octaves

---
 packages/core/controls.mjs                |  4 +-
 packages/tonal/tonal.mjs                  |  2 +
 test/__snapshots__/examples.test.mjs.snap | 90 +++++++++++++++++++++++
 3 files changed, 95 insertions(+), 1 deletion(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index e6181d45..de152d41 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -113,7 +113,7 @@ export const { n } = registerControl('n');
  *
  * - a letter (a-g or A-G)
  * - optional accidentals (b or #)
- * - optional octave number (0-9). Defaults to 3
+ * - optional (possibly negative) octave number (0-9). Defaults to 3
  *
  * Examples of valid note names: `c`, `bb`, `Bb`, `f#`, `c3`, `A4`, `Eb2`, `c#5`
  *
@@ -126,6 +126,8 @@ export const { n } = registerControl('n');
  * note("c4 a4 f4 e4")
  * @example
  * note("60 69 65 64")
+ * @example
+ * note("fbb1 a#0 cbbb-1 e##-2").sound("saw")
  */
 export const { note } = registerControl(['note', 'n']);
 
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 2ec698c3..4f189e3d 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -252,6 +252,8 @@ function _getNearestScaleNote(scaleName, note, preferHigher = true) {
  * n("<[0,7b] [-4# -4] [-2,7##] 4 [0,7] [-4# -4b] [-2,7###] 4b>*4")
  * .scale("C:<major minor>/2")
  * .s("piano")
+ * @example
+ * note("C1*16").transpose(irand(36)).scale('Cb2 major').scaleTranspose(3)
  */
 
 export const scale = register(
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 09482375..77c2773c 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -6436,6 +6436,27 @@ exports[`runs examples > example "note" example index 2 1`] = `
 ]
 `;
 
+exports[`runs examples > example "note" example index 3 1`] = `
+[
+  "[ 0/1 → 1/4 | note:fbb1 s:saw ]",
+  "[ 1/4 → 1/2 | note:a#0 s:saw ]",
+  "[ 1/2 → 3/4 | note:cbbb-1 s:saw ]",
+  "[ 3/4 → 1/1 | note:e##-2 s:saw ]",
+  "[ 1/1 → 5/4 | note:fbb1 s:saw ]",
+  "[ 5/4 → 3/2 | note:a#0 s:saw ]",
+  "[ 3/2 → 7/4 | note:cbbb-1 s:saw ]",
+  "[ 7/4 → 2/1 | note:e##-2 s:saw ]",
+  "[ 2/1 → 9/4 | note:fbb1 s:saw ]",
+  "[ 9/4 → 5/2 | note:a#0 s:saw ]",
+  "[ 5/2 → 11/4 | note:cbbb-1 s:saw ]",
+  "[ 11/4 → 3/1 | note:e##-2 s:saw ]",
+  "[ 3/1 → 13/4 | note:fbb1 s:saw ]",
+  "[ 13/4 → 7/2 | note:a#0 s:saw ]",
+  "[ 7/2 → 15/4 | note:cbbb-1 s:saw ]",
+  "[ 15/4 → 4/1 | note:e##-2 s:saw ]",
+]
+`;
+
 exports[`runs examples > example "nrpnn" example index 0 1`] = `
 [
   "[ 0/1 → 1/1 | note:c4 nrpnn:[1 8] nrpv:123 midichan:1 ]",
@@ -8699,6 +8720,75 @@ exports[`runs examples > example "scale" example index 3 1`] = `
 ]
 `;
 
+exports[`runs examples > example "scale" example index 4 1`] = `
+[
+  "[ 0/1 → 1/16 | note:Gb1 ]",
+  "[ 1/16 → 1/8 | note:Gb1 ]",
+  "[ 1/8 → 3/16 | note:Gb1 ]",
+  "[ 3/16 → 1/4 | note:Gb1 ]",
+  "[ 1/4 → 5/16 | note:Gb1 ]",
+  "[ 5/16 → 3/8 | note:Gb1 ]",
+  "[ 3/8 → 7/16 | note:Gb1 ]",
+  "[ 7/16 → 1/2 | note:Gb1 ]",
+  "[ 1/2 → 9/16 | note:Gb1 ]",
+  "[ 9/16 → 5/8 | note:Gb1 ]",
+  "[ 5/8 → 11/16 | note:Gb1 ]",
+  "[ 11/16 → 3/4 | note:Gb1 ]",
+  "[ 3/4 → 13/16 | note:Gb1 ]",
+  "[ 13/16 → 7/8 | note:Gb1 ]",
+  "[ 7/8 → 15/16 | note:Gb1 ]",
+  "[ 15/16 → 1/1 | note:Gb1 ]",
+  "[ 1/1 → 17/16 | note:Cb3 ]",
+  "[ 17/16 → 9/8 | note:Cb3 ]",
+  "[ 9/8 → 19/16 | note:Cb3 ]",
+  "[ 19/16 → 5/4 | note:Cb3 ]",
+  "[ 5/4 → 21/16 | note:Cb3 ]",
+  "[ 21/16 → 11/8 | note:Cb3 ]",
+  "[ 11/8 → 23/16 | note:Cb3 ]",
+  "[ 23/16 → 3/2 | note:Cb3 ]",
+  "[ 3/2 → 25/16 | note:Cb3 ]",
+  "[ 25/16 → 13/8 | note:Cb3 ]",
+  "[ 13/8 → 27/16 | note:Cb3 ]",
+  "[ 27/16 → 7/4 | note:Cb3 ]",
+  "[ 7/4 → 29/16 | note:Cb3 ]",
+  "[ 29/16 → 15/8 | note:Cb3 ]",
+  "[ 15/8 → 31/16 | note:Cb3 ]",
+  "[ 31/16 → 2/1 | note:Cb3 ]",
+  "[ 2/1 → 33/16 | note:Eb4 ]",
+  "[ 33/16 → 17/8 | note:Eb4 ]",
+  "[ 17/8 → 35/16 | note:Eb4 ]",
+  "[ 35/16 → 9/4 | note:Eb4 ]",
+  "[ 9/4 → 37/16 | note:Eb4 ]",
+  "[ 37/16 → 19/8 | note:Eb4 ]",
+  "[ 19/8 → 39/16 | note:Eb4 ]",
+  "[ 39/16 → 5/2 | note:Eb4 ]",
+  "[ 5/2 → 41/16 | note:Eb4 ]",
+  "[ 41/16 → 21/8 | note:Eb4 ]",
+  "[ 21/8 → 43/16 | note:Eb4 ]",
+  "[ 43/16 → 11/4 | note:Eb4 ]",
+  "[ 11/4 → 45/16 | note:Eb4 ]",
+  "[ 45/16 → 23/8 | note:Eb4 ]",
+  "[ 23/8 → 47/16 | note:Eb4 ]",
+  "[ 47/16 → 3/1 | note:Eb4 ]",
+  "[ 3/1 → 49/16 | note:Db2 ]",
+  "[ 49/16 → 25/8 | note:Db2 ]",
+  "[ 25/8 → 51/16 | note:Db2 ]",
+  "[ 51/16 → 13/4 | note:Db2 ]",
+  "[ 13/4 → 53/16 | note:Db2 ]",
+  "[ 53/16 → 27/8 | note:Db2 ]",
+  "[ 27/8 → 55/16 | note:Db2 ]",
+  "[ 55/16 → 7/2 | note:Db2 ]",
+  "[ 7/2 → 57/16 | note:Db2 ]",
+  "[ 57/16 → 29/8 | note:Db2 ]",
+  "[ 29/8 → 59/16 | note:Db2 ]",
+  "[ 59/16 → 15/4 | note:Db2 ]",
+  "[ 15/4 → 61/16 | note:Db2 ]",
+  "[ 61/16 → 31/8 | note:Db2 ]",
+  "[ 31/8 → 63/16 | note:Db2 ]",
+  "[ 63/16 → 4/1 | note:Db2 ]",
+]
+`;
+
 exports[`runs examples > example "scaleTranspose" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | note:C3 ]",

From 3d25aa1b91ec75532682c3d786ca5d862c0c374f Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 26 Aug 2025 12:06:10 -0500
Subject: [PATCH 11/18] Rename params, more examples

---
 packages/core/controls.mjs                |  74 ++++++---
 packages/superdough/superdough.mjs        |  16 +-
 test/__snapshots__/examples.test.mjs.snap | 191 +++++++++++++++++-----
 3 files changed, 217 insertions(+), 64 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 4d6f8d8b..4deb6f77 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -542,13 +542,19 @@ export const { tremoloshape } = registerControl('tremoloshape', 'tremshape');
  */
 
 /**
- * Modulate the amplitude of an orbit to create a "sidechain" like effect
+ * Modulate the amplitude of an orbit to create a "sidechain" like effect.
+ *
+ * Can be applied to multiple orbits with the ':' mininotation, e.g. `duckorbit("2:3")`
  *
  * @name duckorbit
  * @param {number | Pattern} orbit target orbit
  * @example
  * $: n(run(16)).scale("c:minor:pentatonic").s("sawtooth").delay(.7).orbit(2)
  * $: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit(2).duckattack(0.2).duckdepth(1)
+ * @example
+ * $: n(run(16)).scale("c:minor:pentatonic").s("sawtooth").delay(.7).orbit(2)
+ * $: s("hh*16").orbit(3)
+ * $: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit("2:3").duckattack(0.2).duckdepth(1)
  *
  */
 export const { duck } = registerControl('duckorbit', 'duck');
@@ -556,40 +562,70 @@ export const { duck } = registerControl('duckorbit', 'duck');
 /**
  * The amount of ducking applied to target orbit
  *
+ * Can vary across orbits with the ':' mininotation, e.g. `duckdepth("0.3:0.1")`.
+ * Note: this requires first applying the effect to multiple orbits with e.g. `duckorbit("2:3")`.
+ *
  * @name duckdepth
  * @param {number | Pattern} depth depth of modulation from 0 to 1
  * @example
  * stack( n(run(8)).scale("c:minor").s("sawtooth").delay(.7).orbit(2), s("bd:4!4").beat("0,4,8,11,14",16).duckorbit(2).duckattack(0.2).duckdepth("<1 .9 .6 0>"))
+ * @example
+ * $: n(run(16)).scale("c:minor:pentatonic").s("sawtooth").delay(.7).orbit(2)
+ * $: s("hh*16").orbit(3)
+ * $: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit("2:3").duckattack(0.2).duckdepth("1:0.5")
  *
  */
-
 export const { duckdepth } = registerControl('duckdepth');
 
 /**
- * The attack time of the duck effect. Can be used to prevent clicking or for creative rhythmic effects
+ * The time required for the ducked signal(s) to reach their lowest volume.
+ * Can be used to prevent clicking or for creative rhythmic effects.
+
+ * Can vary across orbits with the ':' mininotation, e.g. `duckonset("0:0.003")`.
+ * Note: this requires first applying the effect to multiple orbits with e.g. `duckorbit("2:3")`.
+ *
+ * @name duckonset
+ * @synonyms duckons
+ *
+ * @param {number | Pattern} time The onset time in seconds
+ * @example
+ * // Clicks
+ * sound: n(run(8)).scale("c:minor").s("sawtooth").lpf(200).delay(.7).orbit(2)
+ * duckerWithClick: s("bd*4").duckorbit(2).duckonset(0).postgain(0)
+ * @example
+ * // No clicks
+ * sound: n(run(8)).scale("c:minor").s("sawtooth").lpf(200).delay(.7).orbit(2)
+ * duckerWithoutClick: s("bd*4").duckorbit(2).duckonset(0.003).postgain(0)
+ * @example
+ * // Rhythmic
+ * noise: s("pink").distort("2:1").orbit(4) // used rhythmically with 0.3 onset below
+ * hhat: s("hh*16").orbit(7)
+ * ducker: s("bd*4").bank("tr909").duckorbit("4:7").duckonset("0.3:0.003").duckattack(0.25)
+ *
+ */
+export const { duckonset } = registerControl('duckonset', 'duckons');
+
+/**
+ * The time required for the ducked signal(s) to return to their normal volume.
+
+ * Can vary across orbits with the ':' mininotation, e.g. `duckonset("0:0.003")`.
+ * Note: this requires first applying the effect to multiple orbits with e.g. `duckorbit("2:3")`.
  *
  * @name duckattack
- * @param {number | Pattern} time
+ * @synonyms duckatt
+ *
+ * @param {number | Pattern} time The attack time in seconds
  * @example
- * sound: n(run(8)).scale("c:minor").s("sawtooth").lpf(200).delay(.7).orbit(2)
- * duckerWithClick: s("bd*4").duckorbit(2).duckattack(0).postgain(0)
- * _duckerWithoutClick: s("bd*4").duckorbit(2).duckattack(0.003).postgain(0)
+ * sound: n(run(8)).scale("c:minor").s("sawtooth").delay(.7).orbit(2)
+ * ducker: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit(2).duckattack("<0.2 0 0.4>").duckdepth(1)
+ * @example
+ * moreduck: n(run(8)).scale("c:minor").s("sawtooth").delay(.7).orbit(2)
+ * lessduck: s("hh*16").orbit(5)
+ * ducker: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit("2:5").duckattack("0.4:0.1")
  *
  */
 export const { duckattack } = registerControl('duckattack', 'duckatt');
 
-/**
- * The release time of the duck effect
- *
- * @name duckrelease
- * @param {number | Pattern} time
- * @example
- * sound: n(run(8)).scale("c:minor").s("sawtooth").delay(.7).orbit(2)
- * ducker: s("bd:4!4").beat("0,4,8,11,14",16).duckorbit(2).duckrelease("<0.2 0 0.4>").duckdepth(1)
- *
- */
-export const { duckrelease } = registerControl('duckrelease', 'duckrelease');
-
 export const { drive } = registerControl('drive');
 
 /**
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index b8975a85..98ffae16 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -421,10 +421,10 @@ function setOrbit(audioContext, orbit, channels) {
   }
 }
 
-function duckOrbit(audioContext, targetOrbit, t, attacktime = 0.003, releasetime = 0.1, duckdepth = 1) {
+function duckOrbit(audioContext, targetOrbit, t, onsettime = 0.003, attacktime = 0.1, duckdepth = 1) {
   const targetArr = [targetOrbit].flat();
+  const onsetArr = [onsettime].flat();
   const attackArr = [attacktime].flat();
-  const releaseArr = [releasetime].flat();
   const depthArr = [duckdepth].flat();
 
   targetArr.forEach((target, idx) => {
@@ -432,8 +432,8 @@ function duckOrbit(audioContext, targetOrbit, t, attacktime = 0.003, releasetime
       errorLogger(new Error(`duck target orbit ${target} does not exist`), 'superdough');
       return;
     }
-    const attack = attackArr[idx] ?? attackArr[0];
-    const release = Math.max(releaseArr[idx] ?? releaseArr[0], 0.002);
+    const onset = onsetArr[idx] ?? onsetArr[0];
+    const attack = Math.max(attackArr[idx] ?? attackArr[0], 0.002);
     const depth = depthArr[idx] ?? depthArr[0];
     const gainParam = orbits[target].output.gain;
     webAudioTimeout(
@@ -448,8 +448,8 @@ function duckOrbit(audioContext, targetOrbit, t, attacktime = 0.003, releasetime
         // that method
         gainParam.setValueAtTime(currVal, t);
 
-        gainParam.exponentialRampToValueAtTime(duckedVal, t + attack);
-        gainParam.exponentialRampToValueAtTime(1, t + attack + release);
+        gainParam.exponentialRampToValueAtTime(duckedVal, t + onset);
+        gainParam.exponentialRampToValueAtTime(1, t + onset + attack);
       },
       0,
       t - 0.01,
@@ -578,8 +578,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     postgain = getDefaultValue('postgain'),
     density = getDefaultValue('density'),
     duckorbit,
+    duckonset,
     duckattack,
-    duckrelease,
     duckdepth,
     // filters
     fanchor = getDefaultValue('fanchor'),
@@ -658,7 +658,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
   setOrbit(ac, orbit, channels, t, cycle, cps);
 
   if (duckorbit != null) {
-    duckOrbit(ac, duckorbit, t, duckattack, duckrelease, duckdepth);
+    duckOrbit(ac, duckorbit, t, duckonset, duckattack, duckdepth);
   }
 
   gain = applyGainCurve(nanFallback(gain, 1));
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 85079269..4655b5cd 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3038,22 +3038,51 @@ exports[`runs examples > example "dry" example index 0 1`] = `
 
 exports[`runs examples > example "duckattack" example index 0 1`] = `
 [
-  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
-  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckattack:0.003 postgain:0 ]",
+  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
+  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
+  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
+  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
+  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:2 duckattack:0 duckdepth:1 ]",
+  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
+  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
+  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
+  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
+  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:2 duckattack:0.4 duckdepth:1 ]",
+  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
+]
+`;
+
+exports[`runs examples > example "duckattack" example index 1 1`] = `
+[
+  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
+  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:[2 5] duckattack:[0.4 0.1] ]",
 ]
 `;
 
@@ -3114,6 +3143,94 @@ exports[`runs examples > example "duckdepth" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "duckdepth" example index 1 1`] = `
+[
+  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:[1 0.5] ]",
+]
+`;
+
+exports[`runs examples > example "duckonset" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+]
+`;
+
+exports[`runs examples > example "duckonset" example index 1 1`] = `
+[
+  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+]
+`;
+
+exports[`runs examples > example "duckonset" example index 2 1`] = `
+[
+  "[ 0/1 → 1/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 1/4 → 1/2 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 1/2 → 3/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 3/4 → 1/1 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 1/1 → 5/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 5/4 → 3/2 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 3/2 → 7/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 7/4 → 2/1 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 2/1 → 9/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 9/4 → 5/2 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 5/2 → 11/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 11/4 → 3/1 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 3/1 → 13/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 13/4 → 7/2 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 7/2 → 15/4 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+  "[ 15/4 → 4/1 | s:bd bank:tr909 duckorbit:[4 7] duckonset:[0.3 0.003] duckattack:0.25 ]",
+]
+`;
+
 exports[`runs examples > example "duckorbit" example index 0 1`] = `
 [
   "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckattack:0.2 duckdepth:1 ]",
@@ -3139,28 +3256,28 @@ exports[`runs examples > example "duckorbit" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "duckrelease" example index 0 1`] = `
+exports[`runs examples > example "duckorbit" example index 1 1`] = `
 [
-  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
-  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
-  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
-  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
-  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:2 duckrelease:0 duckdepth:1 ]",
-  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
-  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
-  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
-  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
-  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:2 duckrelease:0.4 duckdepth:1 ]",
-  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
-  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:2 duckrelease:0.2 duckdepth:1 ]",
+  "[ 0/1 → 1/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 1/4 → 5/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 1/2 → 9/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 11/16 → 3/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 7/8 → 15/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 1/1 → 17/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 5/4 → 21/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 3/2 → 25/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 27/16 → 7/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 15/8 → 31/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 2/1 → 33/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 9/4 → 37/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 5/2 → 41/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 43/16 → 11/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 23/8 → 47/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 3/1 → 49/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 13/4 → 53/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 7/2 → 57/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 59/16 → 15/4 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
+  "[ 31/8 → 63/16 | s:bd n:4 duckorbit:[2 3] duckattack:0.2 duckdepth:1 ]",
 ]
 `;
 

From 022ac95bbd169b9a490e3bbccaa9933d0ba61f8e Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Tue, 26 Aug 2025 12:09:12 -0500
Subject: [PATCH 12/18] Typo

---
 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 4deb6f77..25d2e52f 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -580,7 +580,7 @@ export const { duckdepth } = registerControl('duckdepth');
 /**
  * The time required for the ducked signal(s) to reach their lowest volume.
  * Can be used to prevent clicking or for creative rhythmic effects.
-
+ *
  * Can vary across orbits with the ':' mininotation, e.g. `duckonset("0:0.003")`.
  * Note: this requires first applying the effect to multiple orbits with e.g. `duckorbit("2:3")`.
  *
@@ -607,7 +607,7 @@ export const { duckonset } = registerControl('duckonset', 'duckons');
 
 /**
  * The time required for the ducked signal(s) to return to their normal volume.
-
+ *
  * Can vary across orbits with the ':' mininotation, e.g. `duckonset("0:0.003")`.
  * Note: this requires first applying the effect to multiple orbits with e.g. `duckorbit("2:3")`.
  *

From 4e2e79086446e7b82c5bf382125ef69b09ceba16 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Mon, 1 Sep 2025 20:45:53 -0500
Subject: [PATCH 13/18] Set delay and reverb nodes properly

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 0c205bcc..29079695 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -336,7 +336,7 @@ function getDelay(orbit, delaytime, delayfeedback, t) {
     const dly = ac.createFeedbackDelay(1, delaytime, delayfeedback);
     dly.start?.(t); // for some reason, this throws when audion extension is installed..
     connectToOrbit(dly, orbit);
-    delayNode = dly;
+    orbits[orbit].delayNode = dly;
   }
   delayNode.delayTime.value !== delaytime && delayNode.delayTime.setValueAtTime(delaytime, t);
   delayNode.feedback.value !== delayfeedback && delayNode.feedback.setValueAtTime(delayfeedback, t);
@@ -464,7 +464,7 @@ function getReverb(orbit, duration, fade, lp, dim, ir, irspeed, irbegin) {
     const ac = getAudioContext();
     const reverb = ac.createReverb(duration, fade, lp, dim, ir, irspeed, irbegin);
     connectToOrbit(reverb, orbit);
-    reverbNode = reverb;
+    orbits[orbit].reverbNode = reverb;
   }
 
   if (

From 9c108862ef0edfe1d2c50e51337ff4f646bfbe2f Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Fri, 5 Sep 2025 22:09:50 -0500
Subject: [PATCH 14/18] Corrected piping

---
 packages/superdough/superdough.mjs                | 14 +++++++-------
 website/src/repl/components/panel/SettingsTab.jsx |  2 +-
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 29079695..5e5969fe 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -333,10 +333,10 @@ function getDelay(orbit, delaytime, delayfeedback, t) {
   let delayNode = orbits[orbit].delayNode;
   if (delayNode === undefined) {
     const ac = getAudioContext();
-    const dly = ac.createFeedbackDelay(1, delaytime, delayfeedback);
-    dly.start?.(t); // for some reason, this throws when audion extension is installed..
-    connectToOrbit(dly, orbit);
-    orbits[orbit].delayNode = dly;
+    delayNode = ac.createFeedbackDelay(1, delaytime, delayfeedback);
+    delayNode.start?.(t); // for some reason, this throws when audion extension is installed..
+    connectToOrbit(delayNode, orbit);
+    orbits[orbit].delayNode = delayNode;
   }
   delayNode.delayTime.value !== delaytime && delayNode.delayTime.setValueAtTime(delaytime, t);
   delayNode.feedback.value !== delayfeedback && delayNode.feedback.setValueAtTime(delayfeedback, t);
@@ -462,9 +462,9 @@ function getReverb(orbit, duration, fade, lp, dim, ir, irspeed, irbegin) {
   let reverbNode = orbits[orbit].reverbNode;
   if (reverbNode === undefined) {
     const ac = getAudioContext();
-    const reverb = ac.createReverb(duration, fade, lp, dim, ir, irspeed, irbegin);
-    connectToOrbit(reverb, orbit);
-    orbits[orbit].reverbNode = reverb;
+    reverbNode = ac.createReverb(duration, fade, lp, dim, ir, irspeed, irbegin);
+    connectToOrbit(reverbNode, orbit);
+    orbits[orbit].reverbNode = reverbNode;
   }
 
   if (
diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index 8f02ca8b..26c9ae28 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -312,7 +312,7 @@ export function SettingsTab({ started }) {
             confirmDialog('Sure?').then((r) => {
               if (r) {
                 const { userPatterns } = settingsMap.get(); // keep current patterns
-                settingsMap.set({...defaultSettings, userPatterns});
+                settingsMap.set({ ...defaultSettings, userPatterns });
               }
             });
           }}

From 798eb22d9a5a5be342b2e78a34f845a3c748d184 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sat, 6 Sep 2025 10:09:44 -0500
Subject: [PATCH 15/18] Use currentTime for exact scheduling

---
 packages/core/controls.mjs                |  8 +--
 packages/superdough/superdough.mjs        | 21 ++++----
 test/__snapshots__/examples.test.mjs.snap | 64 +++++++++++------------
 3 files changed, 47 insertions(+), 46 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 589a0634..af0c4b1a 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -590,12 +590,12 @@ export const { duckdepth } = registerControl('duckdepth');
  * @param {number | Pattern} time The onset time in seconds
  * @example
  * // Clicks
- * sound: n(run(8)).scale("c:minor").s("sawtooth").lpf(200).delay(.7).orbit(2)
- * duckerWithClick: s("bd*4").duckorbit(2).duckonset(0).postgain(0)
+ * sound: freq("63.2388").s("sine").orbit(2).gain(4)
+ * duckerWithClick: s("bd*4").duckorbit(2).duckattack(0.3).duckonset(0).postgain(0)
  * @example
  * // No clicks
- * sound: n(run(8)).scale("c:minor").s("sawtooth").lpf(200).delay(.7).orbit(2)
- * duckerWithoutClick: s("bd*4").duckorbit(2).duckonset(0.003).postgain(0)
+ * sound: freq("63.2388").s("sine").orbit(2).gain(4)
+ * duckerWithoutClick: s("bd*4").duckorbit(2).duckattack(0.3).duckonset(0.01).postgain(0)
  * @example
  * // Rhythmic
  * noise: s("pink").distort("2:1").orbit(4) // used rhythmically with 0.3 onset below
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 5e5969fe..59590db6 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -420,7 +420,7 @@ function setOrbit(audioContext, orbit, channels) {
   }
 }
 
-function duckOrbit(audioContext, targetOrbit, t, onsettime = 0.003, attacktime = 0.1, duckdepth = 1) {
+function duckOrbit(audioContext, targetOrbit, t, onsettime = 0, attacktime = 0.1, duckdepth = 1) {
   const targetArr = [targetOrbit].flat();
   const onsetArr = [onsettime].flat();
   const attackArr = [attacktime].flat();
@@ -438,17 +438,18 @@ function duckOrbit(audioContext, targetOrbit, t, onsettime = 0.003, attacktime =
     webAudioTimeout(
       audioContext,
       () => {
-        gainParam.cancelScheduledValues(t);
+        const now = audioContext.currentTime;
+
+        // cancelScheduledValues and setValueAtTime together emulate cancelAndHoldAtTime
+        // on browsers which lack that method
         const currVal = gainParam.value;
+        gainParam.cancelScheduledValues(now);
+        gainParam.setValueAtTime(currVal, now);
+
+        const t0 = Math.max(t, now); // guard against now > t
         const duckedVal = clamp(1 - Math.sqrt(depth), 0.01, currVal);
-
-        // Guarantees the value is set to currVal at time t. This in conjunction with
-        // cancelScheduledValues above emulates cancelAndHoldAtTime on browsers which lack
-        // that method
-        gainParam.setValueAtTime(currVal, t);
-
-        gainParam.exponentialRampToValueAtTime(duckedVal, t + onset);
-        gainParam.exponentialRampToValueAtTime(1, t + onset + attack);
+        gainParam.exponentialRampToValueAtTime(duckedVal, t0 + onset);
+        gainParam.exponentialRampToValueAtTime(1, t0 + onset + attack);
       },
       0,
       t - 0.01,
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index ba54328b..7579794f 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3170,43 +3170,43 @@ exports[`runs examples > example "duckdepth" example index 1 1`] = `
 
 exports[`runs examples > example "duckonset" example index 0 1`] = `
 [
-  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
-  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckonset:0 postgain:0 ]",
+  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
+  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0 postgain:0 ]",
 ]
 `;
 
 exports[`runs examples > example "duckonset" example index 1 1`] = `
 [
-  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
-  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckonset:0.003 postgain:0 ]",
+  "[ 0/1 → 1/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 1/4 → 1/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 1/2 → 3/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 3/4 → 1/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 1/1 → 5/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 5/4 → 3/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 3/2 → 7/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 7/4 → 2/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 2/1 → 9/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 9/4 → 5/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 5/2 → 11/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 11/4 → 3/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 3/1 → 13/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 13/4 → 7/2 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 7/2 → 15/4 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
+  "[ 15/4 → 4/1 | s:bd duckorbit:2 duckattack:0.3 duckonset:0.01 postgain:0 ]",
 ]
 `;
 

From ed00686804fecfa05609f7c21c93f2ce3512fded Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sat, 13 Sep 2025 14:29:28 -0500
Subject: [PATCH 16/18] Codeformat

---
 website/src/pages/learn/xen.mdx | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/website/src/pages/learn/xen.mdx b/website/src/pages/learn/xen.mdx
index 32e2c0b4..b8b27ac7 100644
--- a/website/src/pages/learn/xen.mdx
+++ b/website/src/pages/learn/xen.mdx
@@ -16,10 +16,7 @@ These functions allow the use of scales other than your typical chromatic 12 bas
 
 Here's an example of how to configure a basic hexany scale:
 
-<MiniRepl
-  client:idle
-  tune={`"0 1 2 3 4 5".tune("hexany15").mul("220").freq()`}
-/>
+<MiniRepl client:idle tune={`"0 1 2 3 4 5".tune("hexany15").mul("220").freq()`} />
 
 Try other scales like `hexany1`, `iraq`, `gumbeng`, `gunkali`, or `tranh3`
 
@@ -67,6 +64,7 @@ Another helpful trick when exploring new tunings is to strum them.
 Many have a much more enchanting sound that was chosen over many generations of musicians for being strummed.
 
 Take the `sanza` tuning:
+
 <MiniRepl
   client:idle
   tune={`"4 5 6 7 8 9".tune("sanza")
@@ -77,10 +75,7 @@ Take the `sanza` tuning:
 Notes 7 and 9 will clash quite a bit if you arp them normally. Many tunings will have this sort of sound, and it can feel distracting on its own.
 See how close they are on the pitch wheel?
 
-<MiniRepl
-  client:idle
-  tune={`"[7 9]!3".tune("sanza").mul(getFreq('c3')).freq()._pitchwheel()`}
-/>
+<MiniRepl client:idle tune={`"[7 9]!3".tune("sanza").mul(getFreq('c3')).freq()._pitchwheel()`} />
 
 This quality is often due to how the tunings were formed with instruments that were played differently than a piano.
 As such, some tunings are much better strummed, with the subtle clash of the detuned notes actually making the sound much more magical:

From 92b2013cf6efa9f29372060ab6a052081633cb23 Mon Sep 17 00:00:00 2001
From: Aria <weglossing@gmail.com>
Date: Sun, 14 Sep 2025 17:04:39 -0500
Subject: [PATCH 17/18] Correctly handle silences for non-notes

---
 packages/tonal/test/tonal.test.mjs | 2 +-
 packages/tonal/tonal.mjs           | 7 +++----
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/tonal/test/tonal.test.mjs b/packages/tonal/test/tonal.test.mjs
index cb856fa9..5f61b05a 100644
--- a/packages/tonal/test/tonal.test.mjs
+++ b/packages/tonal/test/tonal.test.mjs
@@ -66,7 +66,7 @@ describe('tonal', () => {
         n(seq('0b#', '1#b', '2#b#'))
           .scale('C major')
           .firstCycleValues.map((h) => h.note),
-      ).toEqual(['', '', '']);
+      ).toEqual([]);
     });
     it('snaps notes (upwards) to scale', () => {
       const inputNotes = ['Cb', 'Eb', 'G', 'A#', 'Bb'];
diff --git a/packages/tonal/tonal.mjs b/packages/tonal/tonal.mjs
index 4f189e3d..ae75ab69 100644
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@@ -189,8 +189,7 @@ function _convertStepToNumberAndOffset(step) {
     const match = /^(-?\d+)(#+|b+)?$/.exec(step);
 
     if (!match) {
-      logger(`[tonal] invalid scale step "${step}", expected number or integer with optional # b suffixes`, 'error');
-      return [silence, 0];
+      throw new Error(`invalid scale step "${step}", expected number or integer with optional # b suffixes`);
     }
     asNumber = Number(match[1]);
     // These decorations will determine the semitone offset based on the number of
@@ -275,8 +274,8 @@ export const scale = register(
               // legacy..
               return pure(step);
             }
-            const [number, offset] = _convertStepToNumberAndOffset(step);
             try {
+              const [number, offset] = _convertStepToNumberAndOffset(step);
               let note;
               if (isObject && value.anchor) {
                 note = stepInNamedScale(number, scale, value.anchor);
@@ -287,7 +286,7 @@ export const scale = register(
               value = pure(isObject ? { ...value, note } : note);
             } catch (err) {
               logger(`[tonal] ${err.message}`, 'error');
-              value = silence;
+              return silence;
             }
             return value;
           }

From a7e485992e6bba4dd62a30787565e18408152137 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Mon, 15 Sep 2025 20:54:39 +0200
Subject: [PATCH 18/18] add tic80 font

---
 website/public/fonts/tic80/license.txt          |   5 +++++
 website/public/fonts/tic80/readme.txt           |  16 ++++++++++++++++
 website/public/fonts/tic80/tic-80-wide-font.otf | Bin 0 -> 10020 bytes
 .../src/repl/components/panel/SettingsTab.jsx   |   1 +
 website/src/styles/index.css                    |   5 +++++
 5 files changed, 27 insertions(+)
 create mode 100644 website/public/fonts/tic80/license.txt
 create mode 100644 website/public/fonts/tic80/readme.txt
 create mode 100644 website/public/fonts/tic80/tic-80-wide-font.otf

diff --git a/website/public/fonts/tic80/license.txt b/website/public/fonts/tic80/license.txt
new file mode 100644
index 00000000..e42ba4eb
--- /dev/null
+++ b/website/public/fonts/tic80/license.txt
@@ -0,0 +1,5 @@
+The FontStruction “TIC-80 wide font”
+(https://fontstruct.com/fontstructions/show/1388526) by “nesbox” is licensed
+under a Creative Commons CC0 Public Domain Dedication license
+(http://creativecommons.org/publicdomain/zero/1.0/).
+[ancestry]
\ No newline at end of file
diff --git a/website/public/fonts/tic80/readme.txt b/website/public/fonts/tic80/readme.txt
new file mode 100644
index 00000000..b3aaff55
--- /dev/null
+++ b/website/public/fonts/tic80/readme.txt
@@ -0,0 +1,16 @@
+The font file in this archive was created using Fontstruct the free, online
+font-building tool.
+This font was created by “nesbox”.
+This font has a homepage where this archive and other versions may be found:
+https://fontstruct.com/fontstructions/show/1388526
+[ancestry]
+Try Fontstruct at https://fontstruct.com
+It’s easy and it’s fun.
+
+Fontstruct is copyright ©2017-2025 Rob Meek
+
+LEGAL NOTICE:
+In using this font you must comply with the licensing terms described in the
+file “license.txt” included with this archive.
+If you redistribute the font file in this archive, it must be accompanied by all
+the other files from this archive, including this one.
diff --git a/website/public/fonts/tic80/tic-80-wide-font.otf b/website/public/fonts/tic80/tic-80-wide-font.otf
new file mode 100644
index 0000000000000000000000000000000000000000..ba1c1caf4c74de8484950313ad046f5cd7c56ace
GIT binary patch
literal 10020
zcmeHMZERa-6+YJ=*G}SmHA^U)TP|o~V>EV}u1!0rXqOV&!Dwl_ZYpENN!-M39cQ+)
zrjt9S!6qOurU`}wV-iSwYT6$pgeEpV1{>-In#K=4eoS*1(-0E;n1*9#NqNpW@4dcu
z+^+ix%u(!f-}|0(o^#G~&b{{CfB5izYNxv?NY3cknDeKn#(zQ-4iWYLb<d%FA0Z-(
z=&CqAqx%mfhYL^5{R~SzIR5lRHZ{Au|HBSJnJ5sNPNyalSATmK4j#q-wrMPM9csG=
z^2_+Yayna_kNtepb<m&1{{z|7{47l#z$q(=H+v?PO<(`m$PS{*UnPoNHk&IH=~<d2
zdhZ)J?=TYn&u;9!=~(v%Unhz@j}>}(-;X}w|FrLs^(X~ILv(Z}zgsuj_n387(ieOH
z2i_?V`Mvc3g((z#H3$@lO+Fz{VjZs#zv+wdc(1WThY!*&a-0oyUyfy+|J`}yb1Qrj
zBB02AMICwGx>5h#WB1ct=TBbqAG>Srx~p@c&t_fs_(J>r>waJU^;UALz3y78Pj{`A
zEqBeo$1l6*FZGjk1K(JiM_#vXL{$R#X98b_cU07hp~Oo#j^dBc-Q~Q~*>E0JL~YkQ
z@$=`;mtWfZ(irdkAA9|u#%)mulftsP5APct+&*+VGnqb~n<?_r(9#vO6t|W(#As<_
zVCh}KrS+kOn6<Gx7O31B3;rt>`f|)(=vi1;S9zkl^5<R(TUKc64deOEiJ`^2A6A17
zTXfju;@#hJPNxda_*~{x5zEDCXAH}Siut*TV*6-r_DnuAHC=RO(uMKdyfZwsd8FBd
zb1*$McPf={UZ<dC4e!0JR*F;>?bT8wUOTtE*k4(UESGIwEZdcGq*k(*%aN4?Z>T2h
z<;6$`c0d7AWif;u*oPe*)g-U3;JrM+a+&20i!7U_iP}b}M0EWI+Ra@;8KTn|o;+<o
zNyq3jv_P*}hpit6t_o}k91AQ2{vPZLZVT=W9u0mo`2FAup{~%8&{sp}!ad=Sg&z(7
z)9$iAWZ!Fl*ZxOjV<a7UIPyv~5xp(?h3I3^zqR$WeV{Gd_DtJL?eA#+c>B@z2ipJG
zaYe_cI_~OtwBzO26|q!oA@)q{mCntb2Ra|>{9)(0&eyxH>AI=w-mYJERl0|}k99xT
zeXb|cb5+ko&qB{{dX{?=y|?t<-}~#{SJ!P^chkCu);-r3=-bq{tM5eLclsXdd%W-I
zz8B(={qgV<PxP-GsEveI4y=xZ=O5{>>H${bOOHq5;YSAIk+F!Jt@4(YiP{aiDPH@$
ztxI29{Yrm4@_Zz22kiLLP^1e7{9h?o%3Pdkl2gButS0+WBpjhIdOjZB+W(#nEZ0i4
zQa?(ALZURwiz`V}RxOvF;WA2zxtLN$ub5iiWnGtdmW3Ef56J8X9sz^ZWK+C)wwhp1
zObOn-3KW8vJuWhxu#qi@91m|3Zb?AOA_c7K>|jA-)`ePWfNcvBaJ2%ix}GcLIuluT
zA;fFXnr)H^w&1F0&ipwAaqIT0XZ?!Rq$r9J<I9cMk8oLGNQ}UY29P>6`Q$piTk2Fz
z`n6Y*aOrhptyB-mk5%JG>uHOk`YTDTwiZFsW~#C#=%xz!GrC$rwa~a;oxCRYN`rXV
zdX>3{n7o}{y1kv?lVV<ItdU!K(AF5Mloh<r881*cukUGKff+iI{tK1ezlTjKPaVm*
z+egS&H6bwwrw|Xu8~9=f#%k<Wv%qJQ%-q!yvl#ZIWrT`I1H#3G#5+f!t+C)Q!7>J=
z*9Y2jc=xQ?pXF?*9W5fuYNxT4D`jnEzyNrpn^P~%1n{6jv$n|`U;#Chz?nF_0VxjP
zfhW4#5Otr;ZGF+}f@eiDpw|dDdkoK=F+iYzO%DB0n?WUGqh2u9kmN2enz<rrLGSBe
zftE2Uqt0{YU9&ET%_V`>OX;Gp*rp4*$&TjQ8@EahWvR4a17|Dci&B5BLao#=3ljeE
zgUNu|?`Fe4;0)8H(K&IIvhq%$ua-1#8m68%UL=!#ZGSJVBpR^rT=KlL6?blFu~!lv
z*O8(X^a*#!wmPT%junc|Wp9F27U2)+0|lY0*qIVq2%)$c7ffi_HmuT}ARf*F3-{_G
zdib1aYi4B23sn=Js%OC`^o85ks;9lt%<87zXtLyErUvJQ13O?&y*tznZ_<0O>RH@-
zHDYMkFM%_}we71A>ovakR&VZViIHXxsktDd5!5xnYm0&8hW4&)rF}i;)w7&)6aZkF
zJRm@L(9#+YIDkFwZ7q-6j-EFjN&>7tD|j?RuU=3?QCX5pC*VQ}s>@~nZ3q-ic@?y~
zM@a)jjokJ{$S&8W)w81gj!UWuof+$93`qTqMd6^PQ7NkpS5+BpqoL#7s3|}6k_8zT
zN!7q<c*Iqpkt<lP^VQ?LZv=s;a>HoocF~dEKs-42XIkvMRVbWO#E29yrKHI@UU$wK
zR$y{yZa7aUt86v(mWhLXYk0)n?w>EP3&iY-tEc^jF~@7L$!q=r=3xOtp<)7;A_^3L
z&REYS2RMX`!=T2{TvDEaQc{CnbLh{S`HG|+h7)k^FQLf(ntPzJ7oZg`Lnxc62k4EQ
zV{hK2*Bi?^J+KqVkSgUX-s?1%USx6slAh*Pm0`>vn&{BjczWG%+fc7sGQHugaVMK{
zyB=xu1_aj)Jt4U^ceR4jf9KBk{=z3F33Etp+XW#2=%q@O{7!^p+8EU&f~bE@@qh{C
z#52mSw^u8ChiLBIu%dNkQ!edb$!tc$C%84u7}xA6|9B=Qe6!yT90l<1;tW1`;H}aL
zmjDGDK_Oq#TA9|`a<Xunsx2t#;i77-d{dbD<=s|E?cjhdh%VBtfiX_~Hehaa7>V4_
zYDCzs*feDx1f?m?a&XEe)E?My0?8Yw6VFQ>&iD(7z1|RkS!7FTuv$V2d6erMl;jzj
z2sQM(89;fh&RxK*4xgeYe6Qo;29hbhyvR&+c?^^dmlJhYzwEj9MzD_fq&7T=>J<ej
zAT=x8qD)~SvSa~zS_9;l2_pS&a@{InFok8-2L_WXEHtpvH|;&bX-S%?*{s=ksSzI@
zm7!}2$zOKVu#lI(qbSvcE;yqskj63H4M(QGr3%O@U(;Fz({S-n{%Y3PoD3F*!3kb-
z!QdgRU-R5FGe2af7KCZs+-}UrGH253d}WN=^0gA8g&i&$ZggwUa>r{yp=3(Qx8WXv
zTrTo1oaeDEBvuP}*PZM@6UCERd(s5YdoYS53Pp|;M5i)h^x9yJ0do}*x2y7-0+gVt
znS>1IcxUIZ;}+EG91c{#s$ujBL(`oMQ}gK#R;VdqRgFyxNwCw)4QE3y=eWoq43xgP
z!I5xy&{}b}#1CwkHgJD4;Kt`V)PI|4{Nm#OL5ICo%3z)O>1C~~Kb`41Wd5OkOW=g}
zd;K+@WZ|iddlaB9y1|^m^Dw%_$RQe{c_W8ufPP?Po8t7Okt1}3{$k`PZL)@p+(t3$
zRwK95Q42qx%BzF!vwmgd7|jOu8o85>27YSfE*cN6Gjbmt3>H<!gNOCOr@iM7{lOQF
zY*A0}H6sTo5|ZZ`&<RpcsNJlGXnp8%BZsLYG;Cy>x<WgR9HIAzK5FDB4TSD6avRy9
zFB!R=HiaHEatDouo-}fdwukXMu^{cF!SD_vchTnXaU=K9`@&yW85?8aU+|NcP#biv
z2|s6K)Fu3HBcm?%fRRxb`${9DF7_THqb_#Q$f%3`MI)mw_V<j8y4Y_R8Fh(VZDiCX
za;=e3m&pA_MqQ%vR0!Bmm+0rrI_eUA(a5Mv+b)&4E^QCeDCKCD&QKmdj8Ea`@*+7j
zLuo3|IL^%DXc&CjOe1ud_F?xRZO5^L-_SF70-1(%9Q$UVcMwNYG)Jc>1#54%`_0Zf
zP4<q!dLF1U;>`h~1aSDRxQJXlV+PkDV9Nv7gv6GC4F?DvSxrd{SwVafYdJ*YP%F&@
z^mCMz3>A^F0$oQ*{JGu=J}>TGUml%!1J)M#b2h;9X&_;I<G`CiCb=3MR}p?&<7$6P
zh+5;-oE8vG0oHQxm_&ZJpwioEE9$=u$3>u+Fx4OQsz2z(&&;{hytGD<llnGe7@-}&
zFhbV?gD;<8Vjhf039dVYhs@+G{+NxN!%_S(Qx71Q<H#lBcW967O5tcmj?!QNpHWM!
z>qesWooMo-EO5OfU@Z^UC&7rimr0+GB;6^@%}Gv~vq|tPLyCDE(iCvq4($|BoD^KV
z!dkPy!kx*{oPbT`Ll$ew6z<M(?3=`+t<yNa8`U_1p3TzDkayC~OL|6kfk$-BkL=t>
zc}LRuLMAuk;F+Orai2iepA9;hf|GKJ`P5`Oo64Vba>soS4igi(>~yg>TevQn<fn`U
zd7Q|r`W*3vX2*ZH@I%Pfc6??5w2&-J=T0X#Z`r<m>+rT@F*AXurh^Q6klnwjiCo^Z
zFtTIo$hAp@Ihs$WikUmo&S);1g%@XZbjUd{H-0KJ;q1v}Q<)iOPkJ&lflav?c7kvx
zj1FRDl|(K-m7EooNzq8&na<~uNNjS9EstlWoZIJ86DKn>Q_h{~+37R+f^#B=XR+Bc
z$jQ7jo}S!&I=B1yk@@V+yLavc-`}3)Z_jd_f6a6B?OC40d~LjD{8!C#+_mZJx0v^>
IUluR_2cfFLr2qf`

literal 0
HcmV?d00001

diff --git a/website/src/repl/components/panel/SettingsTab.jsx b/website/src/repl/components/panel/SettingsTab.jsx
index 26c9ae28..80daef01 100644
--- a/website/src/repl/components/panel/SettingsTab.jsx
+++ b/website/src/repl/components/panel/SettingsTab.jsx
@@ -74,6 +74,7 @@ const fontFamilyOptions = {
   FiraCode: 'FiraCode',
   'FiraCode-SemiBold': 'FiraCode SemiBold',
   teletext: 'teletext',
+  tic80: 'tic80',
   mode7: 'mode7',
   BigBlueTerminal: 'BigBlueTerminal',
   x3270: 'x3270',
diff --git a/website/src/styles/index.css b/website/src/styles/index.css
index 7fa4b2df..41b282ff 100644
--- a/website/src/styles/index.css
+++ b/website/src/styles/index.css
@@ -50,6 +50,11 @@
   src: url('/fonts/teletext/EuropeanTeletext.ttf');
   size-adjust: 90%;
 }
+@font-face {
+  font-family: 'tic80';
+  src: url('/fonts/tic80/tic-80-wide-font.otf');
+  size-adjust: 60%;
+}
 @font-face {
   font-family: 'mode7';
   src: url('/fonts/mode7/MODE7GX3.TTF');