From e4b00117c311dd309fbe0e969a5053911264b8d7 Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sat, 11 Nov 2023 14:22:52 +0100
Subject: [PATCH 01/73] Parse the synonyms tag in source documentation

---
 jsdoc-synonyms.js | 17 +++++++++++++++++
 jsdoc.config.json |  2 +-
 2 files changed, 18 insertions(+), 1 deletion(-)
 create mode 100644 jsdoc-synonyms.js

diff --git a/jsdoc-synonyms.js b/jsdoc-synonyms.js
new file mode 100644
index 00000000..29aed7b2
--- /dev/null
+++ b/jsdoc-synonyms.js
@@ -0,0 +1,17 @@
+/*
+jsdoc-synonyms.js - Add support for @synonym tag
+Copyright (C) 2023 Strudel contributors - see <https://github.com/tidalcycles/strudel/blob/main/packages/midi/midi.mjs>
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+
+function defineTags(dictionary) {
+  dictionary.defineTag('synonyms', {
+    mustHaveValue: true,
+    onTagged: function(doclet, tag) {
+      doclet.synonyms_text = tag.value;
+      doclet.synonyms = doclet.synonyms_text.split(/[ ,]+/);
+    }
+});
+};
+
+module.exports = {defineTags: defineTags}
\ No newline at end of file
diff --git a/jsdoc.config.json b/jsdoc.config.json
index ca9c3d81..4098a5c5 100644
--- a/jsdoc.config.json
+++ b/jsdoc.config.json
@@ -3,7 +3,7 @@
     "includePattern": ".+\\.(js(doc|x)?|mjs)$",
     "excludePattern": "node_modules|shift-parser|shift-reducer|shift-traverser|dist"
   },
-  "plugins": ["plugins/markdown"],
+  "plugins": ["plugins/markdown", "jsdoc-synonyms"],
   "opts": {
     "destination": "./out/",
     "recurse": true

From bbc292561f20b3fc04637c135693a55f1a77d734 Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sat, 11 Nov 2023 14:23:30 +0100
Subject: [PATCH 02/73] Use synonyms in Tooltip

---
 packages/react/src/components/Tooltip.jsx | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/packages/react/src/components/Tooltip.jsx b/packages/react/src/components/Tooltip.jsx
index a443c123..a508e761 100644
--- a/packages/react/src/components/Tooltip.jsx
+++ b/packages/react/src/components/Tooltip.jsx
@@ -31,6 +31,9 @@ window.addEventListener(
 export const strudelTooltip = hoverTooltip(
   (view, pos, side) => {
     // Word selection from CodeMirror Hover Tooltip example https://codemirror.net/examples/tooltip/#hover-tooltips
+    if (!ctrlDown) {
+      return null;
+    }
     let { from, to, text } = view.state.doc.lineAt(pos);
     let start = pos,
       end = pos;
@@ -47,11 +50,14 @@ export const strudelTooltip = hoverTooltip(
     // Get entry from Strudel documentation
     let entry = jsdoc.docs.filter((doc) => getDocLabel(doc) === word)[0];
     if (!entry) {
-      return null;
-    }
-    if (!ctrlDown) {
-      return null;
+      // Try for synonyms
+      entry = jsdoc.docs.filter((doc) => doc.synonyms && doc.synonyms.includes(word))[0];
+      if (!entry) {
+        return null;
+      }
+      entry.name = word;
     }
+
     return {
       pos: start,
       end,

From 6ba2b767b0145e1f5463f4c49bae1d1670735066 Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sat, 11 Nov 2023 14:23:55 +0100
Subject: [PATCH 03/73] Show synonyms in API reference

---
 website/src/repl/Reference.jsx | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/website/src/repl/Reference.jsx b/website/src/repl/Reference.jsx
index cf6fd5b1..b43f365e 100644
--- a/website/src/repl/Reference.jsx
+++ b/website/src/repl/Reference.jsx
@@ -37,6 +37,11 @@ export function Reference() {
           {visibleFunctions.map((entry, i) => (
             <section key={i}>
               <h3 id={`doc-${i}`}>{entry.name}</h3>
+              {!!entry.synonyms_text && (
+                <p>
+                  Synonyms: <code>{entry.synonyms_text}</code>
+                </p>
+              )}
               {/* <small>{entry.meta.filename}</small> */}
               <p dangerouslySetInnerHTML={{ __html: entry.description }}></p>
               <ul>

From 2aff31fe06bcaf3bbfce7df12ef91c847466eccc Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sat, 11 Nov 2023 14:24:20 +0100
Subject: [PATCH 04/73] Simplify JSDoc

---
 website/src/docs/JsDoc.jsx | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/website/src/docs/JsDoc.jsx b/website/src/docs/JsDoc.jsx
index 1ba80e0a..1a7a034f 100644
--- a/website/src/docs/JsDoc.jsx
+++ b/website/src/docs/JsDoc.jsx
@@ -2,19 +2,15 @@ import jsdoc from '../../../doc.json'; // doc.json is built with `npm run jsdoc-
 const docs = jsdoc.docs.reduce((acc, obj) => Object.assign(acc, { [obj.longname]: obj }), {});
 import { MiniRepl } from './MiniRepl';
 
-const getTag = (title, item) => item.tags?.find((t) => t.title === title)?.text;
-
 export function JsDoc({ name, h = 3, hideDescription, punchcard, canvasHeight }) {
   const item = docs[name];
   if (!item) {
     console.warn('Not found: ' + name);
     return <div />;
   }
-  const synonyms = getTag('synonyms', item)?.split(', ') || [];
   const CustomHeading = `h${h}`;
   const description =
     item.description?.replaceAll(/\{@link ([a-zA-Z\.]+)?#?([a-zA-Z]*)\}/g, (_, a, b) => {
-      // console.log(_, 'a', a, 'b', b);
       return `<a href="#${a.replaceAll('.', '').toLowerCase()}${b ? `-${b}` : ''}">${a}${b ? `#${b}` : ''}</a>`;
     }) || '';
   return (
@@ -22,9 +18,9 @@ export function JsDoc({ name, h = 3, hideDescription, punchcard, canvasHeight })
       {!!h && <CustomHeading>{item.longname}</CustomHeading>}
       {!hideDescription && (
         <>
-          {!!synonyms.length && (
+          {!!item.synonyms_text && (
             <span>
-              Synonyms: <code>{synonyms.join(', ')}</code>
+              Synonyms: <code>{item.synonyms_text}</code>
             </span>
           )}
           <div dangerouslySetInnerHTML={{ __html: description }} />

From bfff38a262f46daf0b9186fac35672740bdf7f2c Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sat, 11 Nov 2023 15:44:15 +0100
Subject: [PATCH 05/73] Fix code format of JSDoc synonym plugin

---
 jsdoc-synonyms.js | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/jsdoc-synonyms.js b/jsdoc-synonyms.js
index 29aed7b2..09190846 100644
--- a/jsdoc-synonyms.js
+++ b/jsdoc-synonyms.js
@@ -7,11 +7,11 @@ This program is free software: you can redistribute it and/or modify it under th
 function defineTags(dictionary) {
   dictionary.defineTag('synonyms', {
     mustHaveValue: true,
-    onTagged: function(doclet, tag) {
+    onTagged: function (doclet, tag) {
       doclet.synonyms_text = tag.value;
       doclet.synonyms = doclet.synonyms_text.split(/[ ,]+/);
-    }
-});
-};
+    },
+  });
+}
 
-module.exports = {defineTags: defineTags}
\ No newline at end of file
+module.exports = { defineTags: defineTags };

From 24e18818768b8109a6978b869fe08b78f14fc0d2 Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sat, 11 Nov 2023 15:53:03 +0100
Subject: [PATCH 06/73] Ignore jsdoc-synonyms by eslint

---
 .eslintignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.eslintignore b/.eslintignore
index 92c95c85..7d807b65 100644
--- a/.eslintignore
+++ b/.eslintignore
@@ -20,4 +20,5 @@ vite.config.js
 **/dist
 /src-tauri/target/**/*
 reverbGen.mjs
-hydra.mjs
\ No newline at end of file
+hydra.mjs
+jsdoc-synonyms.js
\ No newline at end of file

From 476bda812e93380d633800d0a99ab280e914ed39 Mon Sep 17 00:00:00 2001
From: Raphael Forment <raphael.forment@gmail.com>
Date: Fri, 17 Nov 2023 12:55:17 +0100
Subject: [PATCH 07/73] Initial work on crackle

---
 packages/superdough/noise.mjs | 17 +++++++++++++----
 packages/superdough/synth.mjs |  4 ++--
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 2c8c1d4a..6a2d418c 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -4,7 +4,7 @@ import { getAudioContext } from './superdough.mjs';
 let noiseCache = {};
 
 // lazy generates noise buffers and keeps them forever
-function getNoiseBuffer(type) {
+function getNoiseBuffer(type, density) {
   const ac = getAudioContext();
   if (noiseCache[type]) {
     return noiseCache[type];
@@ -34,17 +34,26 @@ function getNoiseBuffer(type) {
       output[i] = b0 + b1 + b2 + b3 + b4 + b5 + b6 + white * 0.5362;
       output[i] *= 0.11;
       b6 = white * 0.115926;
+    } else if (type === 'crackle') {
+      if (Math.random() < (Math.random() * (density - 0.001) + density).toFixed(4)) {
+        output[i] = Math.random() * 2 - 1;
+      } else {
+        output[i] = 0;
+      }
     }
   }
-  noiseCache[type] = noiseBuffer;
+
+  // Prevent caching to randomize crackles
+  if (type !== "crackle")
+    noiseCache[type] = noiseBuffer;
   return noiseBuffer;
 }
 
 // expects one of noises as type
-export function getNoiseOscillator(type = 'white', t) {
+export function getNoiseOscillator(type = 'white', t, density = 0.02) {
   const ac = getAudioContext();
   const o = ac.createBufferSource();
-  o.buffer = getNoiseBuffer(type);
+  o.buffer = getNoiseBuffer(type, density);
   o.loop = true;
   o.start(t);
   return {
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index dafc2e7c..53f462d5 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -22,7 +22,7 @@ const fm = (osc, harmonicityRatio, modulationIndex, wave = 'sine') => {
 };
 
 const waveforms = ['sine', 'square', 'triangle', 'sawtooth'];
-const noises = ['pink', 'white', 'brown'];
+const noises = ['pink', 'white', 'brown', 'crackle'];
 
 export function registerSynthSounds() {
   [...waveforms, ...noises].forEach((s) => {
@@ -36,7 +36,7 @@ export function registerSynthSounds() {
         if (waveforms.includes(s)) {
           sound = getOscillator(s, t, value);
         } else {
-          sound = getNoiseOscillator(s, t);
+          sound = getNoiseOscillator(s, t, 0.002);
         }
 
         let { node: o, stop, triggerRelease } = sound;

From fb28083ce616de5b3a14e36a9cc415d6802b5be8 Mon Sep 17 00:00:00 2001
From: Raphael Forment <raphael.forment@gmail.com>
Date: Fri, 17 Nov 2023 13:18:49 +0100
Subject: [PATCH 08/73] Fixing density and adding documentation

---
 packages/core/controls.mjs         | 15 +++++++++++++--
 packages/superdough/noise.mjs      |  3 ++-
 packages/superdough/superdough.mjs |  1 +
 packages/superdough/synth.mjs      |  3 ++-
 website/src/pages/learn/synths.mdx |  4 ++++
 5 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index a03658a8..a14f06df 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1214,6 +1214,17 @@ const generic_params = [
    * @name waveloss
    */
   ['waveloss'],
+  /*
+   *
+   * Noise crackle density
+   *
+   * @name density
+   * @param {number | Pattern} density between 0 and x
+   * @example
+   * s("crackle*4").density("<0.01 0.04 0.2 0.5>".slow(4))
+   *
+   */
+  ['density'],
   // TODO: midi effects?
   ['dur'],
   // ['modwheel'],
@@ -1308,7 +1319,7 @@ const generic_params = [
 ];
 // TODO: slice / splice https://www.youtube.com/watch?v=hKhPdO0RKDQ&list=PL2lW1zNIIwj3bDkh-Y3LUGDuRcoUigoDs&index=13
 
-controls.createParam = function (names) {
+controls.createParam = function(names) {
   const name = Array.isArray(names) ? names[0] : names;
 
   var withVal;
@@ -1332,7 +1343,7 @@ controls.createParam = function (names) {
 
   const func = (...pats) => sequence(...pats).withValue(withVal);
 
-  const setter = function (...pats) {
+  const setter = function(...pats) {
     if (!pats.length) {
       return this.fmap(withVal);
     }
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 6a2d418c..8993f470 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -35,7 +35,8 @@ function getNoiseBuffer(type, density) {
       output[i] *= 0.11;
       b6 = white * 0.115926;
     } else if (type === 'crackle') {
-      if (Math.random() < (Math.random() * (density - 0.001) + density).toFixed(4)) {
+      const probability = density * 0.01
+      if (Math.random() < probability) {
         output[i] = Math.random() * 2 - 1;
       } else {
         output[i] = 0;
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 00e2f42c..ed133366 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -241,6 +241,7 @@ export const superdough = async (value, deadline, hapDuration) => {
     source,
     gain = 0.8,
     postgain = 1,
+    density = 0.03,
     // filters
     ftype = '12db',
     fanchor = 0.5,
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index 53f462d5..edc3c01e 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -36,7 +36,8 @@ export function registerSynthSounds() {
         if (waveforms.includes(s)) {
           sound = getOscillator(s, t, value);
         } else {
-          sound = getNoiseOscillator(s, t, 0.002);
+          let { density } = value;
+          sound = getNoiseOscillator(s, t, density);
         }
 
         let { node: o, stop, triggerRelease } = sound;
diff --git a/website/src/pages/learn/synths.mdx b/website/src/pages/learn/synths.mdx
index 432276ef..abb74c2f 100644
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@@ -42,6 +42,10 @@ Some amount of pink noise can also be added to any oscillator by using the `nois
 
 <MiniRepl client:idle tune={`note("c3").noise("<0.1 0.25 0.5>").scope()`} />
 
+You can also use the `crackle` type to play some subtle noise crackles. You can control noise amount by using the `density` parameter:
+
+<JsDoc client:idle name="density" h={0} />
+
 ### Additive Synthesis
 
 To tame the harsh sound of the basic waveforms, we can set the `n` control to limit the overtones of the waveform:

From 2a18df61cda07a2e4328b53fddd27e091293861a Mon Sep 17 00:00:00 2001
From: Raphael Forment <raphael.forment@gmail.com>
Date: Fri, 17 Nov 2023 13:23:54 +0100
Subject: [PATCH 09/73] Fix documentation

---
 packages/core/controls.mjs         | 1 -
 website/src/pages/learn/synths.mdx | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index a14f06df..1cd69e81 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1215,7 +1215,6 @@ const generic_params = [
    */
   ['waveloss'],
   /*
-   *
    * Noise crackle density
    *
    * @name density
diff --git a/website/src/pages/learn/synths.mdx b/website/src/pages/learn/synths.mdx
index abb74c2f..d6ac5061 100644
--- a/website/src/pages/learn/synths.mdx
+++ b/website/src/pages/learn/synths.mdx
@@ -44,7 +44,7 @@ Some amount of pink noise can also be added to any oscillator by using the `nois
 
 You can also use the `crackle` type to play some subtle noise crackles. You can control noise amount by using the `density` parameter:
 
-<JsDoc client:idle name="density" h={0} />
+<MiniRepl client:idle tune={`s("crackle*4").density("<0.01 0.04 0.2 0.5>".slow(4)).scope()`} />
 
 ### Additive Synthesis
 

From 6e92c4915aaad88590fbb8d9ff0b3c8e398d28f7 Mon Sep 17 00:00:00 2001
From: Raphael Forment <raphael.forment@gmail.com>
Date: Fri, 17 Nov 2023 13:37:16 +0100
Subject: [PATCH 10/73] Run prettier

---
 packages/core/controls.mjs    | 4 ++--
 packages/superdough/noise.mjs | 5 ++---
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 1cd69e81..6449969e 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1318,7 +1318,7 @@ const generic_params = [
 ];
 // TODO: slice / splice https://www.youtube.com/watch?v=hKhPdO0RKDQ&list=PL2lW1zNIIwj3bDkh-Y3LUGDuRcoUigoDs&index=13
 
-controls.createParam = function(names) {
+controls.createParam = function (names) {
   const name = Array.isArray(names) ? names[0] : names;
 
   var withVal;
@@ -1342,7 +1342,7 @@ controls.createParam = function(names) {
 
   const func = (...pats) => sequence(...pats).withValue(withVal);
 
-  const setter = function(...pats) {
+  const setter = function (...pats) {
     if (!pats.length) {
       return this.fmap(withVal);
     }
diff --git a/packages/superdough/noise.mjs b/packages/superdough/noise.mjs
index 8993f470..24779470 100644
--- a/packages/superdough/noise.mjs
+++ b/packages/superdough/noise.mjs
@@ -35,7 +35,7 @@ function getNoiseBuffer(type, density) {
       output[i] *= 0.11;
       b6 = white * 0.115926;
     } else if (type === 'crackle') {
-      const probability = density * 0.01
+      const probability = density * 0.01;
       if (Math.random() < probability) {
         output[i] = Math.random() * 2 - 1;
       } else {
@@ -45,8 +45,7 @@ function getNoiseBuffer(type, density) {
   }
 
   // Prevent caching to randomize crackles
-  if (type !== "crackle")
-    noiseCache[type] = noiseBuffer;
+  if (type !== 'crackle') noiseCache[type] = noiseBuffer;
   return noiseBuffer;
 }
 

From c0f56be2a9d4eb0de18094fbebed77a9200a5cfc Mon Sep 17 00:00:00 2001
From: Kaspars <kasparsj@gmail.com>
Date: Fri, 17 Nov 2023 20:41:37 +0100
Subject: [PATCH 11/73] add options param to initHydra

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 692e4c14..3e86504c 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -1,13 +1,19 @@
 import { getDrawContext } from '@strudel.cycles/core';
 
-export async function initHydra() {
+export async function initHydra(
+  options = {
+    src: 'https://unpkg.com/hydra-synth',
+    detectAudio: false,
+  },
+) {
   if (!document.getElementById('hydra-canvas')) {
     const { canvas: testCanvas } = getDrawContext();
-    await import('https://unpkg.com/hydra-synth');
+    const { src, ...opts } = options;
+    await import(src);
     const hydraCanvas = testCanvas.cloneNode(true);
     hydraCanvas.id = 'hydra-canvas';
     testCanvas.after(hydraCanvas);
-    new Hydra({ canvas: hydraCanvas, detectAudio: false });
+    new Hydra(Object.assign({ canvas: hydraCanvas }, opts));
     s0.init({ src: testCanvas });
   }
 }

From 83561a0ceb02959d3765abe6db31d9f2fed49efe Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 17 Nov 2023 21:46:34 +0100
Subject: [PATCH 12/73] Update README.md

---
 README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/README.md b/README.md
index 037a9162..7d96cb20 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,6 @@ There are multiple npm packages you can use to use strudel, or only parts of it,
 - [`midi`](./packages/midi): webmidi bindings
 - [`serial`](./packages/serial): webserial bindings
 - [`tonal`](./packages/tonal): tonal functions
-- [`xen`](./packages/xen): microtonal / xenharmonic functions
 - ... [and there are more](./packages/)
 
 Click on the package names to find out more about each one.

From 09752241ba938daa099b380d440beb6e604f5849 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 17 Nov 2023 23:16:09 +0100
Subject: [PATCH 13/73] fix: multiple repls

---
 packages/core/repl.mjs | 29 ++++++++++++++++-------------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/packages/core/repl.mjs b/packages/core/repl.mjs
index 3645d594..0bd5229d 100644
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@@ -89,19 +89,22 @@ export function repl({
     allTransform = transform;
     return silence;
   };
-
-  for (let i = 1; i < 10; ++i) {
-    Object.defineProperty(Pattern.prototype, `d${i}`, {
-      get() {
-        return this.p(i);
-      },
-    });
-    Object.defineProperty(Pattern.prototype, `p${i}`, {
-      get() {
-        return this.p(i);
-      },
-    });
-    Pattern.prototype[`q${i}`] = silence;
+  try {
+    for (let i = 1; i < 10; ++i) {
+      Object.defineProperty(Pattern.prototype, `d${i}`, {
+        get() {
+          return this.p(i);
+        },
+      });
+      Object.defineProperty(Pattern.prototype, `p${i}`, {
+        get() {
+          return this.p(i);
+        },
+      });
+      Pattern.prototype[`q${i}`] = silence;
+    }
+  } catch (err) {
+    // already defined..
   }
 
   const fit = register('fit', (pat) =>

From 049aa352864cd783271ad4b9bc8f1342ca6457a1 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sat, 18 Nov 2023 21:15:52 +0100
Subject: [PATCH 14/73] hsl + hsla functions

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

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 5a9a3fe8..9a5c456a 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -2189,6 +2189,14 @@ export const duration = register('duration', function (value, pat) {
   return pat.withHapSpan((span) => new TimeSpan(span.begin, span.begin.add(value)));
 });
 
+export const hsla = register('hsla', (h, s, l, a, pat) => {
+  return pat.color(`hsla(${h}turn,${s * 100}%,${l * 100}%,${a})`);
+});
+
+export const hsl = register('hsl', (h, s, l, pat) => {
+  return pat.color(`hsl(${h}turn,${s * 100}%,${l * 100}%)`);
+});
+
 /**
  * Sets the color of the hap in visualizations like pianoroll or highlighting.
  * @name color

From f759999826526be12abf0cde8191cbddb0ac464e Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sat, 18 Nov 2023 21:16:03 +0100
Subject: [PATCH 15/73] pianoroll smear as float

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

diff --git a/packages/core/pianoroll.mjs b/packages/core/pianoroll.mjs
index 254dd94a..413807f0 100644
--- a/packages/core/pianoroll.mjs
+++ b/packages/core/pianoroll.mjs
@@ -165,10 +165,7 @@ export function pianoroll({
   barThickness = fold ? valueAxis / foldValues.length : valueAxis / valueExtent;
   ctx.fillStyle = background;
   ctx.globalAlpha = 1; // reset!
-  if (!smear) {
-    ctx.clearRect(0, 0, w, h);
-    ctx.fillRect(0, 0, w, h);
-  }
+  clearScreen(smear);
   haps.forEach((event) => {
     const isActive = event.whole.begin <= time && event.endClipped > time;
     let strokeCurrent = stroke ?? (strokeActive && isActive);
@@ -282,3 +279,13 @@ export function drawPianoroll(options) {
   const { drawTime, ...rest } = options;
   pianoroll({ ...getDrawOptions(drawTime), ...rest });
 }
+
+function clearScreen(smear = 0, smearRGB = `0,0,0`) {
+  const ctx = getDrawContext();
+  if (!smear) {
+    ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);
+  } else {
+    ctx.fillStyle = `rgba(${smearRGB},${1 - smear})`;
+    ctx.fillRect(0, 0, ctx.canvas.width, ctx.canvas.height);
+  }
+}

From b27f8e45dc0bc279c4f45859d785528bd5964987 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sat, 18 Nov 2023 21:48:50 +0100
Subject: [PATCH 16/73] hotfix: build

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

diff --git a/packages/core/pianoroll.mjs b/packages/core/pianoroll.mjs
index 413807f0..254dd94a 100644
--- a/packages/core/pianoroll.mjs
+++ b/packages/core/pianoroll.mjs
@@ -165,7 +165,10 @@ export function pianoroll({
   barThickness = fold ? valueAxis / foldValues.length : valueAxis / valueExtent;
   ctx.fillStyle = background;
   ctx.globalAlpha = 1; // reset!
-  clearScreen(smear);
+  if (!smear) {
+    ctx.clearRect(0, 0, w, h);
+    ctx.fillRect(0, 0, w, h);
+  }
   haps.forEach((event) => {
     const isActive = event.whole.begin <= time && event.endClipped > time;
     let strokeCurrent = stroke ?? (strokeActive && isActive);
@@ -279,13 +282,3 @@ export function drawPianoroll(options) {
   const { drawTime, ...rest } = options;
   pianoroll({ ...getDrawOptions(drawTime), ...rest });
 }
-
-function clearScreen(smear = 0, smearRGB = `0,0,0`) {
-  const ctx = getDrawContext();
-  if (!smear) {
-    ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);
-  } else {
-    ctx.fillStyle = `rgba(${smearRGB},${1 - smear})`;
-    ctx.fillRect(0, 0, ctx.canvas.width, ctx.canvas.height);
-  }
-}

From 7aa217828b5ee8cfc553a98ba8f7cdebff01b033 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Mon, 20 Nov 2023 23:06:35 -0500
Subject: [PATCH 17/73] testing

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 00e2f42c..be9a3df9 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -30,7 +30,11 @@ let audioContext;
 export const getAudioContext = () => {
   if (!audioContext) {
     audioContext = new AudioContext();
+    var maxChannelCount = audioContext.destination.maxChannelCount;
+    audioContext.destination.channelCount = maxChannelCount;
   }
+  //console.log(audioContext.destination.maxChannelCount);
+
   return audioContext;
 };
 
@@ -39,7 +43,10 @@ const getDestination = () => {
   const ctx = getAudioContext();
   if (!destination) {
     destination = ctx.createGain();
-    destination.connect(ctx.destination);
+    var merger = ctx.createChannelMerger(ctx.destination.channelCount);
+    merger.connect(ctx.destination);
+    destination.connect(merger, 0, 4);
+    destination.connect(merger, 0, 5);
   }
   return destination;
 };

From f0b458cd1775e8ed3f82c10d048d00a560e57c58 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Wed, 22 Nov 2023 00:03:34 -0500
Subject: [PATCH 18/73] need to figure out channels input + seperating left
 right channels from source

---
 packages/core/controls.mjs         | 13 +++++++
 packages/superdough/superdough.mjs | 60 ++++++++++++++++++++++--------
 2 files changed, 57 insertions(+), 16 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index a03658a8..a4db48cb 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -381,6 +381,19 @@ const generic_params = [
    */
   ['coarse'],
 
+  /**
+   * Allows you to set the output channels on the interface
+   *
+   * @name channels
+   * @synonyms ch
+   *
+   * @param {!Float32Array} channels Array<int>
+   * @example
+   * note("e a d b g").channels([2, 3]).room(1)
+   *
+   */
+  ['channels', 'ch'],
+
   ['phaserrate', 'phasr'], // superdirt only
 
   /**
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index be9a3df9..ef77db8a 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -27,6 +27,7 @@ export function getSound(s) {
 export const resetLoadedSounds = () => soundMap.set({});
 
 let audioContext;
+
 export const getAudioContext = () => {
   if (!audioContext) {
     audioContext = new AudioContext();
@@ -37,23 +38,39 @@ export const getAudioContext = () => {
 
   return audioContext;
 };
-
-let destination;
-const getDestination = () => {
+// outputs: Map<int, audiGainNode>
+const outputs = new Map();
+let channelMerger;
+// channels: Array<int>
+const getDestinations = (channels) => {
   const ctx = getAudioContext();
-  if (!destination) {
-    destination = ctx.createGain();
-    var merger = ctx.createChannelMerger(ctx.destination.channelCount);
-    merger.connect(ctx.destination);
-    destination.connect(merger, 0, 4);
-    destination.connect(merger, 0, 5);
+  if (channelMerger == null) {
+    channelMerger = ctx.createChannelMerger(ctx.destination.channelCount);
+    channelMerger.connect(ctx.destination);
   }
-  return destination;
+  channels.forEach((ch) => {
+    if (!outputs.has(ch)) {
+      const gain = ctx.createGain();
+      gain.channelInterpretation = 'discrete';
+      gain.connect(channelMerger, 0, ch);
+      outputs.set(ch, gain);
+    }
+  });
+  // if (!destination) {
+  //   destination = ctx.createGain();
+  //   channelMerger = ctx.createChannelMerger(ctx.destination.channelCount);
+  //   channelMerger.connect(ctx.destination);
+  //   destination.connect(channelMerger, 0, 4);
+  //   destination.connect(channelMerger, 0, 5);
+  // }
+  return channels.map((ch) => outputs.get(ch));
 };
 
 export const panic = () => {
-  getDestination().gain.linearRampToValueAtTime(0, getAudioContext().currentTime + 0.01);
-  destination = null;
+  outputs.forEach((output) => {
+    return output.gain.linearRampToValueAtTime(0, getAudioContext().currentTime + 0.01);
+  });
+  outputs.clear();
 };
 
 let workletsLoading;
@@ -101,6 +118,15 @@ export async function initAudioOnFirstClick(options) {
 
 let delays = {};
 const maxfeedback = 0.98;
+//input: audioNode, channels: Array<int>
+const connectToOutputs = (input, channels = [0, 1]) => {
+  const outputs = getDestinations(channels);
+  console.log(input);
+
+  outputs.forEach((output, i) => {
+    input.connect(output, 0);
+  });
+};
 
 function getDelay(orbit, delaytime, delayfeedback, t) {
   if (delayfeedback > maxfeedback) {
@@ -111,7 +137,7 @@ function getDelay(orbit, delaytime, delayfeedback, t) {
     const ac = getAudioContext();
     const dly = ac.createFeedbackDelay(1, delaytime, delayfeedback);
     dly.start?.(t); // for some reason, this throws when audion extension is installed..
-    dly.connect(getDestination());
+    connectToOutputs(dly, [0, 1]);
     delays[orbit] = dly;
   }
   delays[orbit].delayTime.value !== delaytime && delays[orbit].delayTime.setValueAtTime(delaytime, t);
@@ -170,7 +196,7 @@ function getReverb(orbit, duration, fade, lp, dim, ir) {
   if (!reverbs[orbit]) {
     const ac = getAudioContext();
     const reverb = ac.createReverb(duration, fade, lp, dim, ir);
-    reverb.connect(getDestination());
+    connectToOutputs(reverb, [0, 1]);
     reverbs[orbit] = reverb;
   }
   if (
@@ -275,7 +301,7 @@ export const superdough = async (value, deadline, hapDuration) => {
     bpsustain = 1,
     bprelease = 0.01,
     bandq = 1,
-
+    channels = [0, 1],
     //phaser
     phaser,
     phaserdepth = 0.75,
@@ -442,7 +468,9 @@ export const superdough = async (value, deadline, hapDuration) => {
   // last gain
   const post = gainNode(postgain);
   chain.push(post);
-  post.connect(getDestination());
+  console.log(channels);
+  // this should be an array but is getting interpreted as an int for some reason...
+  connectToOutputs(post, [channels]);
 
   // delay
   let delaySend;

From de00212bb6ed586d604bfa7fddf7ce0a99934065 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Wed, 22 Nov 2023 12:27:18 +0100
Subject: [PATCH 19/73] fix hydra performance issues

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 692e4c14..b63ca423 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -4,11 +4,11 @@ export async function initHydra() {
   if (!document.getElementById('hydra-canvas')) {
     const { canvas: testCanvas } = getDrawContext();
     await import('https://unpkg.com/hydra-synth');
-    const hydraCanvas = testCanvas.cloneNode(true);
-    hydraCanvas.id = 'hydra-canvas';
-    testCanvas.after(hydraCanvas);
-    new Hydra({ canvas: hydraCanvas, detectAudio: false });
-    s0.init({ src: testCanvas });
+    h = new Hydra({detectAudio: false });
+    h.canvas.id = 'hydra-canvas';
+    h.canvas.style.position = 'absolute';
+    h.canvas.style.top = '0px';
+    testCanvas.after(h.canvas);
   }
 }
 

From 66fd20ace5bd8e54bf76c3013dd73f31df91fde8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Wed, 22 Nov 2023 12:36:43 +0100
Subject: [PATCH 20/73] add hydra audio capture option

---
 packages/hydra/README.md | 7 +++++++
 packages/hydra/hydra.mjs | 4 ++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/packages/hydra/README.md b/packages/hydra/README.md
index d300bb88..e36a421b 100644
--- a/packages/hydra/README.md
+++ b/packages/hydra/README.md
@@ -12,6 +12,13 @@ await initHydra();
 
 Then you can use hydra below!
 
+### Enable audio capture
+Use `{audio: true}` param to enable Hydra's audio capture:
+
+```js
+await initHydra({audio: true});
+```
+
 ## Usage via npm
 
 ```sh
diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index b63ca423..e105b440 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -1,10 +1,10 @@
 import { getDrawContext } from '@strudel.cycles/core';
 
-export async function initHydra() {
+export async function initHydra(config) {
   if (!document.getElementById('hydra-canvas')) {
     const { canvas: testCanvas } = getDrawContext();
     await import('https://unpkg.com/hydra-synth');
-    h = new Hydra({detectAudio: false });
+    h = new Hydra({detectAudio: config?.audio });
     h.canvas.id = 'hydra-canvas';
     h.canvas.style.position = 'absolute';
     h.canvas.style.top = '0px';

From ebc6723f55d4879b3bfcb4853363fd14885a6228 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Wed, 22 Nov 2023 13:51:01 +0100
Subject: [PATCH 21/73] enable hydra options update

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index e105b440..778f3361 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -1,6 +1,10 @@
 import { getDrawContext } from '@strudel.cycles/core';
 
+let options = ""
+
 export async function initHydra(config) {
+
+  //load and init hydra
   if (!document.getElementById('hydra-canvas')) {
     const { canvas: testCanvas } = getDrawContext();
     await import('https://unpkg.com/hydra-synth');
@@ -10,6 +14,17 @@ export async function initHydra(config) {
     h.canvas.style.top = '0px';
     testCanvas.after(h.canvas);
   }
+
+  // update options
+  if (options != JSON.stringify(config)) {
+    options = JSON.stringify(config);
+
+    new Hydra(
+      {
+        canvas: document.getElementById('hydra-canvas'),
+        detectAudio: config?.audio
+      })
+  }
 }
 
 export const H = (p) => () => p.queryArc(getTime(), getTime())[0].value;

From a58ac967a620246b6432834cc7df4a80b87aa487 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Wed, 22 Nov 2023 13:51:42 +0100
Subject: [PATCH 22/73] add Hydra audio example to documentation

---
 website/src/pages/learn/hydra.mdx | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/website/src/pages/learn/hydra.mdx b/website/src/pages/learn/hydra.mdx
index a506e53c..dd892ff7 100644
--- a/website/src/pages/learn/hydra.mdx
+++ b/website/src/pages/learn/hydra.mdx
@@ -48,7 +48,23 @@ There is a special function `H` that allows you to use a pattern as an input to
   tune={`await initHydra()
 let pattern = "3 4 5 [6 7]*2"
 shape(H(pattern)).out(o0)
-n(pattern).scale("A:minor").piano().room(1) 
+n(pattern).scale("A:minor").piano().room(1)
+`}
+/>
+
+To use hydra audio capture, call `initHydra` with `{audio:true}` configuration param:
+
+<MiniRepl
+  client:only="react"
+  tune={`await initHydra({audio:true})
+let pattern = "<3 4 5 [6 7]*2>"
+shape(H(pattern)).repeat()
+  .scrollY(
+    ()=> a.fft[0]*.25
+  )
+  .add(src(o0).color(.71 ).scrollX(.005),.95)
+.out(o0)
+n(pattern).scale("A:minor").piano().room(1)
 `}
 />
 

From 0a280e939927ad4956ce14b3e42139935cdf83be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Wed, 22 Nov 2023 15:47:16 +0100
Subject: [PATCH 23/73] prettier code formatting

---
 packages/hydra/hydra.mjs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 778f3361..25d69c93 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -1,14 +1,13 @@
 import { getDrawContext } from '@strudel.cycles/core';
 
-let options = ""
+let options = '';
 
 export async function initHydra(config) {
-
   //load and init hydra
   if (!document.getElementById('hydra-canvas')) {
     const { canvas: testCanvas } = getDrawContext();
     await import('https://unpkg.com/hydra-synth');
-    h = new Hydra({detectAudio: config?.audio });
+    h = new Hydra({ detectAudio: config?.audio });
     h.canvas.id = 'hydra-canvas';
     h.canvas.style.position = 'absolute';
     h.canvas.style.top = '0px';
@@ -19,11 +18,10 @@ export async function initHydra(config) {
   if (options != JSON.stringify(config)) {
     options = JSON.stringify(config);
 
-    new Hydra(
-      {
-        canvas: document.getElementById('hydra-canvas'),
-        detectAudio: config?.audio
-      })
+    new Hydra({
+      canvas: document.getElementById('hydra-canvas'),
+      detectAudio: config?.audio,
+    });
   }
 }
 

From e0e896d4b534627a7539458339868ee03157ca68 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Wed, 22 Nov 2023 17:39:16 +0100
Subject: [PATCH 24/73] improve hydra audio detection initialization

---
 packages/hydra/hydra.mjs | 36 +++++++++++++++++++++---------------
 1 file changed, 21 insertions(+), 15 deletions(-)

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 25d69c93..3f41e256 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -1,27 +1,33 @@
 import { getDrawContext } from '@strudel.cycles/core';
 
-let options = '';
+let audio = false;
+let hydra;
+
+function appendCanvas(c){
+  const { canvas: testCanvas } = getDrawContext();
+  c.canvas.id = 'hydra-canvas';
+  c.canvas.style.position = 'absolute';
+  c.canvas.style.top = '0px';
+  testCanvas.after(c.canvas);
+}
 
 export async function initHydra(config) {
+  audio = config?.audio || false;
   //load and init hydra
   if (!document.getElementById('hydra-canvas')) {
-    const { canvas: testCanvas } = getDrawContext();
     await import('https://unpkg.com/hydra-synth');
-    h = new Hydra({ detectAudio: config?.audio });
-    h.canvas.id = 'hydra-canvas';
-    h.canvas.style.position = 'absolute';
-    h.canvas.style.top = '0px';
-    testCanvas.after(h.canvas);
+    hydra = new Hydra({ detectAudio: audio });
+    appendCanvas(hydra);
   }
 
-  // update options
-  if (options != JSON.stringify(config)) {
-    options = JSON.stringify(config);
-
-    new Hydra({
-      canvas: document.getElementById('hydra-canvas'),
-      detectAudio: config?.audio,
-    });
+  // if config.audio is true
+  // and current canvas des not detect audio
+  if (config?.audio && !hydra.detectAudio ){
+    //remove previous canvas without audio detection
+    document.getElementById('hydra-canvas').remove()
+    // create and append a new audio responsive canvas
+    hydra = new Hydra({ detectAudio: audio});
+    appendCanvas(hydra)
   }
 }
 

From d71877f915aa0cd11a1d58999dd60e7a926b1cd2 Mon Sep 17 00:00:00 2001
From: Alexandre Gravel-Raymond <agravelraymond@deezer.com>
Date: Wed, 22 Nov 2023 20:35:19 +0100
Subject: [PATCH 25/73] Move jsdoc files to subfolder

---
 jsdoc-synonyms.js => jsdoc/jsdoc-synonyms.js | 0
 jsdoc.config.json => jsdoc/jsdoc.config.json | 2 +-
 undocumented.mjs => jsdoc/undocumented.mjs   | 4 ++--
 package.json                                 | 6 +++---
 4 files changed, 6 insertions(+), 6 deletions(-)
 rename jsdoc-synonyms.js => jsdoc/jsdoc-synonyms.js (100%)
 rename jsdoc.config.json => jsdoc/jsdoc.config.json (78%)
 rename undocumented.mjs => jsdoc/undocumented.mjs (91%)

diff --git a/jsdoc-synonyms.js b/jsdoc/jsdoc-synonyms.js
similarity index 100%
rename from jsdoc-synonyms.js
rename to jsdoc/jsdoc-synonyms.js
diff --git a/jsdoc.config.json b/jsdoc/jsdoc.config.json
similarity index 78%
rename from jsdoc.config.json
rename to jsdoc/jsdoc.config.json
index 4098a5c5..073b16c5 100644
--- a/jsdoc.config.json
+++ b/jsdoc/jsdoc.config.json
@@ -3,7 +3,7 @@
     "includePattern": ".+\\.(js(doc|x)?|mjs)$",
     "excludePattern": "node_modules|shift-parser|shift-reducer|shift-traverser|dist"
   },
-  "plugins": ["plugins/markdown", "jsdoc-synonyms"],
+  "plugins": ["plugins/markdown", "jsdoc/jsdoc-synonyms"],
   "opts": {
     "destination": "./out/",
     "recurse": true
diff --git a/undocumented.mjs b/jsdoc/undocumented.mjs
similarity index 91%
rename from undocumented.mjs
rename to jsdoc/undocumented.mjs
index 281d27d8..657fdea6 100644
--- a/undocumented.mjs
+++ b/jsdoc/undocumented.mjs
@@ -65,7 +65,7 @@ async function getUndocumented(path, docs) {
 }
 
 // read doc.json file
-const { docs } = JSON.parse(await readFile(resolve(__dirname, 'doc.json'), 'utf8'));
+const { docs } = JSON.parse(await readFile(resolve(__dirname, '..', 'doc.json'), 'utf8'));
 
 const paths = dependencyTree.toList({
   filename: 'index.mjs',
@@ -76,7 +76,7 @@ const paths = dependencyTree.toList({
 // const paths = ['../packages/core/pattern.mjs', '../packages/core/hap.mjs'].map((rel) => resolve(__dirname, rel));
 
 const undocumented = Object.fromEntries(
-  await Promise.all(paths.map(async (path) => [path, await getUndocumented(path, docs)])),
+  await Promise.all(paths.map(async (path) => [path.replace(resolve(__dirname, '..'), ''), await getUndocumented(path, docs)])),
 );
 
 console.log(JSON.stringify(undocumented, null, 2));
diff --git a/package.json b/package.json
index 36229611..172832ee 100644
--- a/package.json
+++ b/package.json
@@ -18,12 +18,12 @@
     "build": "npm run prebuild && cd website && npm run build",
     "preview": "cd website && npm run preview",
     "osc": "cd packages/osc && npm run server",
-    "jsdoc": "jsdoc packages/ -c jsdoc.config.json",
-    "jsdoc-json": "jsdoc packages/ --template ./node_modules/jsdoc-json --destination doc.json -c jsdoc.config.json",
+    "jsdoc": "jsdoc packages/ -c jsdoc/jsdoc.config.json",
+    "jsdoc-json": "jsdoc packages/ --template ./node_modules/jsdoc-json --destination doc.json -c jsdoc/jsdoc.config.json",
     "lint": "eslint . --ext mjs,js --quiet",
     "codeformat": "prettier --write .",
     "format-check": "prettier --check .",
-    "report-undocumented": "npm run jsdoc-json && node undocumented.mjs > undocumented.json",
+    "report-undocumented": "npm run jsdoc-json && node jsdoc/undocumented.mjs > undocumented.json",
     "check": "npm run format-check && npm run lint && npm run test",
     "iclc": "cd paper && pandoc --template=pandoc/iclc.html --citeproc  --number-sections iclc2023.md -o iclc2023.html && pandoc --template=pandoc/iclc.latex --citeproc --number-sections iclc2023.md -o iclc2023.pdf"
   },

From 2868a5ff4fc21f208d83ce8ce9a4934305e284e1 Mon Sep 17 00:00:00 2001
From: Alexandre Gravel-Raymond <agravelraymond@deezer.com>
Date: Wed, 22 Nov 2023 20:36:01 +0100
Subject: [PATCH 26/73] Update the undocumented functions file

---
 undocumented.json | 210 +++++++++++++++++++++++++++++-----------------
 1 file changed, 134 insertions(+), 76 deletions(-)

diff --git a/undocumented.json b/undocumented.json
index 0d28835d..0a807c90 100644
--- a/undocumented.json
+++ b/undocumented.json
@@ -1,17 +1,17 @@
 {
-  "/home/felix/projects/strudel/packages/core/fraction.mjs": [
+  "/packages/core/fraction.mjs": [
     "gcd"
   ],
-  "/home/felix/projects/strudel/packages/core/timespan.mjs": [
+  "/packages/core/timespan.mjs": [
     "TimeSpan"
   ],
-  "/home/felix/projects/strudel/packages/core/hap.mjs": [
+  "/packages/core/hap.mjs": [
     "Hap"
   ],
-  "/home/felix/projects/strudel/packages/core/state.mjs": [
+  "/packages/core/state.mjs": [
     "State"
   ],
-  "/home/felix/projects/strudel/packages/core/util.mjs": [
+  "/packages/core/util.mjs": [
     "isNoteWithOctave",
     "isNote",
     "tokenizeNote",
@@ -34,23 +34,31 @@
     "mapArgs",
     "numeralArgs",
     "parseFractional",
-    "fractionalArgs"
+    "fractionalArgs",
+    "splitAt",
+    "zipWith",
+    "clamp",
+    "sol2note"
   ],
-  "/home/felix/projects/strudel/packages/core/value.mjs": [
+  "/packages/core/value.mjs": [
     "unionWithObj",
     "valued",
     "Value",
     "map"
   ],
-  "/home/felix/projects/strudel/packages/core/drawLine.mjs": [],
-  "/home/felix/projects/strudel/packages/core/logger.mjs": [
+  "/packages/core/drawLine.mjs": [],
+  "/packages/core/logger.mjs": [
     "logKey",
     "logger"
   ],
-  "/home/felix/projects/strudel/packages/core/pattern.mjs": [
+  "/packages/core/pattern.mjs": [
     "setStringParser",
+    "polyrhythm",
+    "pr",
+    "pm",
     "isPattern",
     "reify",
+    "fastcat",
     "set",
     "keep",
     "keepif",
@@ -74,22 +82,33 @@
     "func",
     "compressSpan",
     "compressspan",
+    "fastgap",
     "focusSpan",
     "focusspan",
+    "density",
+    "sparsity",
     "zoomArc",
     "zoomarc",
+    "inv",
+    "juxby",
+    "echowith",
+    "stutWith",
+    "stutwith",
+    "iterback",
+    "chunkback",
     "bypass",
     "duration",
-    "color",
     "colour",
-    "striate"
+    "loopat",
+    "loopatcps"
   ],
-  "/home/felix/projects/strudel/packages/core/controls.mjs": [],
-  "/home/felix/projects/strudel/packages/core/euclid.mjs": [
+  "/packages/core/controls.mjs": [],
+  "/packages/core/euclid.mjs": [
+    "bjork",
     "euclidrot",
     "euclidLegatoRot"
   ],
-  "/home/felix/projects/strudel/packages/core/signal.mjs": [
+  "/packages/core/signal.mjs": [
     "steady",
     "signal",
     "isaw",
@@ -112,34 +131,37 @@
     "degradeByWith",
     "undegrade"
   ],
-  "/home/felix/projects/strudel/packages/core/speak.mjs": [
+  "/packages/core/speak.mjs": [
     "speak"
   ],
-  "/home/felix/projects/strudel/packages/core/evaluate.mjs": [
+  "/packages/core/evaluate.mjs": [
     "evalScope",
     "evaluate"
   ],
-  "/home/felix/projects/strudel/packages/core/zyklus.mjs": [],
-  "/home/felix/projects/strudel/packages/core/cyclist.mjs": [
+  "/packages/core/zyklus.mjs": [],
+  "/packages/core/cyclist.mjs": [
     "Cyclist"
   ],
-  "/home/felix/projects/strudel/packages/core/time.mjs": [
+  "/packages/core/time.mjs": [
     "getTime",
     "setTime"
   ],
-  "/home/felix/projects/strudel/packages/core/repl.mjs": [
-    "repl"
+  "/packages/core/repl.mjs": [
+    "repl",
+    "getTrigger"
   ],
-  "/home/felix/projects/strudel/packages/core/draw.mjs": [
+  "/packages/core/draw.mjs": [
     "getDrawContext",
-    "cleanupDraw"
+    "cleanupDraw",
+    "Framer",
+    "Drawer"
   ],
-  "/home/felix/projects/strudel/packages/core/animate.mjs": [
+  "/packages/core/animate.mjs": [
     "x",
     "y",
     "w",
     "h",
-    "a",
+    "angle",
     "r",
     "fill",
     "smear",
@@ -147,85 +169,121 @@
     "moveXY",
     "zoomIn"
   ],
-  "/home/felix/projects/strudel/packages/core/pianoroll.mjs": [
-    "pianoroll"
+  "/packages/core/pianoroll.mjs": [
+    "getDrawOptions",
+    "drawPianoroll"
   ],
-  "/home/felix/projects/strudel/packages/core/ui.mjs": [
+  "/packages/core/spiral.mjs": [],
+  "/packages/core/ui.mjs": [
     "backgroundImage",
     "cleanupUi"
   ],
-  "/home/felix/projects/strudel/packages/core/gist.js": [],
-  "/home/felix/projects/strudel/packages/core/index.mjs": [],
-  "/home/felix/projects/strudel/packages/midi/midi.mjs": [
+  "/packages/core/gist.js": [],
+  "/packages/core/index.mjs": [],
+  "/packages/csound/index.mjs": [
+    "loadCSound",
+    "loadcsound",
+    "loadCsound",
+    "csound",
+    "loadOrc"
+  ],
+  "/packages/desktopbridge/utils.mjs": [
+    "Invoke",
+    "isTauri"
+  ],
+  "/packages/desktopbridge/midibridge.mjs": [],
+  "/packages/desktopbridge/oscbridge.mjs": [],
+  "/packages/desktopbridge/index.mjs": [],
+  "/packages/midi/midi.mjs": [
     "WebMidi",
-    "enableWebMidi"
+    "enableWebMidi",
+    "midin"
   ],
-  "/home/felix/projects/strudel/packages/midi/index.mjs": [],
-  "/home/felix/projects/strudel/packages/mini/krill-parser.js": [],
-  "/home/felix/projects/strudel/packages/mini/mini.mjs": [
+  "/packages/midi/index.mjs": [],
+  "/packages/mini/krill-parser.js": [],
+  "/packages/mini/mini.mjs": [
     "patternifyAST",
+    "getLeafLocation",
+    "mini2ast",
+    "getLeaves",
+    "getLeafLocations",
     "mini",
+    "m",
     "h",
-    "minify"
+    "minify",
+    "miniAllStrings"
   ],
-  "/home/felix/projects/strudel/packages/mini/index.mjs": [],
-  "/home/felix/projects/strudel/packages/soundfonts/fontloader.mjs": [
+  "/packages/mini/index.mjs": [],
+  "/packages/soundfonts/gm.mjs": [],
+  "/packages/soundfonts/fontloader.mjs": [
     "getFontBufferSource",
-    "getFontPitch"
+    "getFontPitch",
+    "registerSoundfonts"
   ],
-  "/home/felix/projects/strudel/packages/soundfonts/list.mjs": [
+  "/packages/soundfonts/list.mjs": [
     "instruments",
     "drums",
     "instrumentNames"
   ],
-  "/home/felix/projects/strudel/packages/soundfonts/sfumato.mjs": [
+  "/packages/soundfonts/sfumato.mjs": [
     "loadSoundfont"
   ],
-  "/home/felix/projects/strudel/packages/soundfonts/index.mjs": [],
-  "/home/felix/projects/strudel/packages/tonal/tonal.mjs": [],
-  "/home/felix/projects/strudel/packages/tonal/voicings.mjs": [
-    "voicingRegistry",
-    "setVoicingRange"
+  "/packages/soundfonts/index.mjs": [],
+  "/packages/tonal/tonal.mjs": [],
+  "/packages/tonal/tonleiter.mjs": [
+    "pc2chroma",
+    "rotateChroma",
+    "chroma2pc",
+    "tokenizeChord",
+    "note2pc",
+    "note2oct",
+    "note2chroma",
+    "midi2chroma",
+    "pitch2chroma",
+    "step2semitones",
+    "x2midi",
+    "scaleStep",
+    "renderVoicing",
+    "accidentalOffset",
+    "Step",
+    "Note"
   ],
-  "/home/felix/projects/strudel/packages/tonal/index.mjs": [],
-  "/home/felix/projects/strudel/packages/transpiler/transpiler.mjs": [
+  "/packages/tonal/ireal.mjs": [
+    "simple",
+    "complex"
+  ],
+  "/packages/tonal/voicings.mjs": [
+    "voicingRegistry",
+    "setVoicingRange",
+    "registerVoicings",
+    "voicingAlias"
+  ],
+  "/packages/tonal/index.mjs": [],
+  "/packages/transpiler/transpiler.mjs": [
     "transpiler"
   ],
-  "/home/felix/projects/strudel/packages/transpiler/index.mjs": [
+  "/packages/transpiler/index.mjs": [
     "evaluate"
   ],
-  "/home/felix/projects/strudel/packages/webaudio/feedbackdelay.mjs": [],
-  "/home/felix/projects/strudel/packages/webaudio/reverb.mjs": [],
-  "/home/felix/projects/strudel/packages/webaudio/sampler.mjs": [
-    "getCachedBuffer",
-    "getSampleBufferSource",
-    "loadBuffer",
-    "reverseBuffer",
-    "getLoadedBuffer",
-    "resetLoadedSamples",
-    "getLoadedSamples"
-  ],
-  "/home/felix/projects/strudel/packages/webaudio/vowel.mjs": [
-    "vowelFormant"
-  ],
-  "/home/felix/projects/strudel/packages/webaudio/webaudio.mjs": [
-    "getAudioContext",
-    "panic",
-    "initAudio",
-    "initAudioOnFirstClick",
+  "/packages/webaudio/webaudio.mjs": [
+    "webaudioOutputTrigger",
     "webaudioOutput",
-    "webaudioOutputTrigger"
+    "webaudioScheduler"
   ],
-  "/home/felix/projects/strudel/packages/webaudio/index.mjs": [],
-  "/home/felix/projects/strudel/packages/xen/xen.mjs": [
+  "/packages/webaudio/scope.mjs": [
+    "drawTimeScope",
+    "drawFrequencyScope"
+  ],
+  "/packages/webaudio/index.mjs": [],
+  "/packages/xen/xen.mjs": [
     "edo",
     "xen",
     "tuning"
   ],
-  "/home/felix/projects/strudel/packages/xen/tunejs.js": [],
-  "/home/felix/projects/strudel/packages/xen/tune.mjs": [
+  "/packages/xen/tunejs.js": [],
+  "/packages/xen/tune.mjs": [
     "tune"
   ],
-  "/home/felix/projects/strudel/packages/xen/index.mjs": [],
-  "/home/felix/projects/strudel/index.mjs": []
+  "/packages/xen/index.mjs": [],
+  "/index.mjs": []
 }

From ecc8e0a108abe03da8138f457596a3ca1585a01c Mon Sep 17 00:00:00 2001
From: Alexandre Gravel-Raymond <agravelraymond@deezer.com>
Date: Wed, 22 Nov 2023 20:38:25 +0100
Subject: [PATCH 27/73] More code beauty please

---
 jsdoc/undocumented.mjs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/jsdoc/undocumented.mjs b/jsdoc/undocumented.mjs
index 657fdea6..9376a8b6 100644
--- a/jsdoc/undocumented.mjs
+++ b/jsdoc/undocumented.mjs
@@ -76,7 +76,9 @@ const paths = dependencyTree.toList({
 // const paths = ['../packages/core/pattern.mjs', '../packages/core/hap.mjs'].map((rel) => resolve(__dirname, rel));
 
 const undocumented = Object.fromEntries(
-  await Promise.all(paths.map(async (path) => [path.replace(resolve(__dirname, '..'), ''), await getUndocumented(path, docs)])),
+  await Promise.all(
+    paths.map(async (path) => [path.replace(resolve(__dirname, '..'), ''), await getUndocumented(path, docs)]),
+  ),
 );
 
 console.log(JSON.stringify(undocumented, null, 2));

From e41973371690d4cc2ac4b6b1123182d63a0feb34 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 01:04:53 -0500
Subject: [PATCH 28/73] channel splitting and channels parameter

---
 packages/core/controls.mjs         | 35 +++++++++++++++----------
 packages/superdough/superdough.mjs | 41 +++++++++++++++---------------
 2 files changed, 42 insertions(+), 34 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index a4db48cb..899e57e9 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -4,7 +4,7 @@ Copyright (C) 2022 Strudel contributors - see <https://github.com/tidalcycles/st
 This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-import { Pattern, register, sequence } from './pattern.mjs';
+import { Pattern, register, reify, sequence } from './pattern.mjs';
 import { zipWith } from './util.mjs';
 
 const controls = {};
@@ -381,18 +381,18 @@ const generic_params = [
    */
   ['coarse'],
 
-  /**
-   * Allows you to set the output channels on the interface
-   *
-   * @name channels
-   * @synonyms ch
-   *
-   * @param {!Float32Array} channels Array<int>
-   * @example
-   * note("e a d b g").channels([2, 3]).room(1)
-   *
-   */
-  ['channels', 'ch'],
+  // /**
+  //  * Allows you to set the output channels on the interface
+  //  *
+  //  * @name channels
+  //  * @synonyms ch
+  //  *
+  //  * @param {!Float32Array} channels Array<int>
+  //  * @example
+  //  * note("e a d b g").channels([2, 3]).room(1)
+  //  *
+  //  */
+  // ['channels', 'ch'],
 
   ['phaserrate', 'phasr'], // superdirt only
 
@@ -1390,4 +1390,13 @@ controls.ds = register('ds', (ds, pat) => {
   return pat.set({ decay, sustain });
 });
 
+controls.ch = register(['channels', 'ch'], (channels, pat) => {
+  channels = !Array.isArray(channels) ? [channels] : channels;
+
+  // channels = channels.map(reify).map((channelPat) => {
+  //   // How do I return the current value of the channel pattern here?
+  // });
+  return pat.set({ channels });
+});
+
 export default controls;
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index ef77db8a..3cccfc96 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -31,38 +31,33 @@ let audioContext;
 export const getAudioContext = () => {
   if (!audioContext) {
     audioContext = new AudioContext();
-    var maxChannelCount = audioContext.destination.maxChannelCount;
+    const maxChannelCount = audioContext.destination.maxChannelCount;
     audioContext.destination.channelCount = maxChannelCount;
   }
-  //console.log(audioContext.destination.maxChannelCount);
-
   return audioContext;
 };
-// outputs: Map<int, audiGainNode>
+// outputs: Map<int, GainNode>
 const outputs = new Map();
 let channelMerger;
 // channels: Array<int>
 const getDestinations = (channels) => {
   const ctx = getAudioContext();
   if (channelMerger == null) {
-    channelMerger = ctx.createChannelMerger(ctx.destination.channelCount);
+    channelMerger = new ChannelMergerNode(ctx, { numberOfInputs: ctx.destination.channelCount });
     channelMerger.connect(ctx.destination);
   }
   channels.forEach((ch) => {
     if (!outputs.has(ch)) {
-      const gain = ctx.createGain();
-      gain.channelInterpretation = 'discrete';
+      const gain = new GainNode(ctx, {
+        channelInterpretation: 'discrete',
+        channelCount: 1,
+        channelCountMode: 'explicit',
+      });
       gain.connect(channelMerger, 0, ch);
       outputs.set(ch, gain);
     }
   });
-  // if (!destination) {
-  //   destination = ctx.createGain();
-  //   channelMerger = ctx.createChannelMerger(ctx.destination.channelCount);
-  //   channelMerger.connect(ctx.destination);
-  //   destination.connect(channelMerger, 0, 4);
-  //   destination.connect(channelMerger, 0, 5);
-  // }
+
   return channels.map((ch) => outputs.get(ch));
 };
 
@@ -121,10 +116,15 @@ const maxfeedback = 0.98;
 //input: audioNode, channels: Array<int>
 const connectToOutputs = (input, channels = [0, 1]) => {
   const outputs = getDestinations(channels);
-  console.log(input);
-
+  const ctx = getAudioContext();
+  const center = new StereoPannerNode(ctx);
+  input.connect(center);
+  const splitter = new ChannelSplitterNode(ctx, {
+    numberOfOutputs: input.channelCount,
+  });
+  center.connect(splitter);
   outputs.forEach((output, i) => {
-    input.connect(output, 0);
+    splitter.connect(output, i % input.channelCount, 0);
   });
 };
 
@@ -333,6 +333,7 @@ export const superdough = async (value, deadline, hapDuration) => {
     compressorAttack,
     compressorRelease,
   } = value;
+
   gain *= velocity; // legacy fix for velocity
   let toDisconnect = []; // audio nodes that will be disconnected when the source has ended
   const onended = () => {
@@ -466,11 +467,9 @@ export const superdough = async (value, deadline, hapDuration) => {
   }
 
   // last gain
-  const post = gainNode(postgain);
+  const post = new GainNode(ac, { gain: postgain });
   chain.push(post);
-  console.log(channels);
-  // this should be an array but is getting interpreted as an int for some reason...
-  connectToOutputs(post, [channels]);
+  connectToOutputs(post, channels);
 
   // delay
   let delaySend;

From 3fd5fdf1eec830b5d5ebba660ed1aab979b65c6c Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 12:43:51 -0500
Subject: [PATCH 29/73] preview outputs should be stereo

---
 packages/core/controls.mjs         | 38 +++++++++++++++---------------
 packages/superdough/superdough.mjs | 21 +++++++++++++----
 packages/superdough/synth.mjs      |  6 ++---
 website/src/repl/Footer.jsx        |  4 ++--
 4 files changed, 40 insertions(+), 29 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 899e57e9..01b46a9e 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -381,18 +381,18 @@ const generic_params = [
    */
   ['coarse'],
 
-  // /**
-  //  * Allows you to set the output channels on the interface
-  //  *
-  //  * @name channels
-  //  * @synonyms ch
-  //  *
-  //  * @param {!Float32Array} channels Array<int>
-  //  * @example
-  //  * note("e a d b g").channels([2, 3]).room(1)
-  //  *
-  //  */
-  // ['channels', 'ch'],
+  /**
+   * Allows you to set the output channels on the interface
+   *
+   * @name channels
+   * @synonyms ch
+   *
+   * @param {number | Pattern} channels pattern the output channels
+   * @example
+   * note("e a d b g").channels("2:3").room(1)
+   *
+   */
+  ['channels', 'ch'],
 
   ['phaserrate', 'phasr'], // superdirt only
 
@@ -1390,13 +1390,13 @@ controls.ds = register('ds', (ds, pat) => {
   return pat.set({ decay, sustain });
 });
 
-controls.ch = register(['channels', 'ch'], (channels, pat) => {
-  channels = !Array.isArray(channels) ? [channels] : channels;
+// controls.ch = register(['channels', 'ch'], (channels, pat) => {
+//   channels = !Array.isArray(channels) ? [channels] : channels;
 
-  // channels = channels.map(reify).map((channelPat) => {
-  //   // How do I return the current value of the channel pattern here?
-  // });
-  return pat.set({ channels });
-});
+//   // channels = channels.map(reify).map((channelPat) => {
+//   //   // How do I return the current value of the channel pattern here?
+//   // });
+//   return pat.set({ channels });
+// });
 
 export default controls;
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 3cccfc96..4f931304 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -23,6 +23,13 @@ export function registerSound(key, onTrigger, data = {}) {
 export function getSound(s) {
   return soundMap.get()[s];
 }
+// sounds with only one active channel will get upmixed to two, stereo sounds should remain unaffected
+// There might be a better way to do this
+export const upMixToStereo = (ctx, node) => {
+  const stereo = new StereoPannerNode(ctx);
+  node.connect(stereo);
+  return stereo;
+};
 
 export const resetLoadedSounds = () => soundMap.set({});
 
@@ -117,14 +124,16 @@ const maxfeedback = 0.98;
 const connectToOutputs = (input, channels = [0, 1]) => {
   const outputs = getDestinations(channels);
   const ctx = getAudioContext();
-  const center = new StereoPannerNode(ctx);
-  input.connect(center);
+
+  //This upmix can be avoided if correct channel counts are set throughout the app,
+  //could theoretically support surround sound audio files if that work was done
+  const stereo = upMixToStereo(ctx, input);
   const splitter = new ChannelSplitterNode(ctx, {
-    numberOfOutputs: input.channelCount,
+    numberOfOutputs: stereo.channelCount,
   });
-  center.connect(splitter);
+  stereo.connect(splitter);
   outputs.forEach((output, i) => {
-    splitter.connect(output, i % input.channelCount, 0);
+    splitter.connect(output, i % stereo.channelCount, 0);
   });
 };
 
@@ -334,6 +343,8 @@ export const superdough = async (value, deadline, hapDuration) => {
     compressorRelease,
   } = value;
 
+  channels = Array.isArray(channels) ? channels : [channels];
+
   gain *= velocity; // legacy fix for velocity
   let toDisconnect = []; // audio nodes that will be disconnected when the source has ended
   const onended = () => {
diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index dafc2e7c..fad67b75 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -71,8 +71,7 @@ export function waveformN(partials, type) {
   const real = new Float32Array(partials + 1);
   const imag = new Float32Array(partials + 1);
   const ac = getAudioContext();
-  const osc = ac.createOscillator();
-
+  const osc = new OscillatorNode(ac, { channelCount: 1, channelCountMode: 'explicit' });
   const terms = {
     sawtooth: (n) => [0, -1 / n],
     square: (n) => [0, n % 2 === 0 ? 0 : 1 / n],
@@ -125,7 +124,8 @@ export function getOscillator(
   let o;
   // If no partials are given, use stock waveforms
   if (!partials || s === 'sine') {
-    o = getAudioContext().createOscillator();
+    o = new OscillatorNode(ac, { channelCount: 1, channelCountMode: 'explicit' });
+    console.log(o);
     o.type = s || 'triangle';
   }
   // generate custom waveform if partials are given
diff --git a/website/src/repl/Footer.jsx b/website/src/repl/Footer.jsx
index b03f62d0..87e42dd7 100644
--- a/website/src/repl/Footer.jsx
+++ b/website/src/repl/Footer.jsx
@@ -7,7 +7,7 @@ import React, { useMemo, useCallback, useLayoutEffect, useRef, useState } from '
 import { Reference } from './Reference';
 import { themes } from './themes.mjs';
 import { useSettings, settingsMap, setActiveFooter, defaultSettings } from '../settings.mjs';
-import { getAudioContext, soundMap } from '@strudel.cycles/webaudio';
+import { getAudioContext, soundMap, upMixToStereo } from '@strudel.cycles/webaudio';
 import { useStore } from '@nanostores/react';
 import { FilesTab } from './FilesTab';
 
@@ -271,7 +271,7 @@ function SoundsTab() {
               const onended = () => trigRef.current?.node?.disconnect();
               trigRef.current = Promise.resolve(onTrigger(time, params, onended));
               trigRef.current.then((ref) => {
-                ref?.node.connect(ctx.destination);
+                upMixToStereo(ctx, ref?.node).connect(ctx.destination);
               });
             }}
           >

From 1f62d85d8b10ab6234169c03469389830983ec3b Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 13:29:22 -0500
Subject: [PATCH 30/73] cleaning up

---
 packages/superdough/superdough.mjs | 63 ++++++++++--------------------
 website/src/repl/Footer.jsx        |  4 +-
 2 files changed, 22 insertions(+), 45 deletions(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 4f931304..a1b81edd 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -23,13 +23,6 @@ export function registerSound(key, onTrigger, data = {}) {
 export function getSound(s) {
   return soundMap.get()[s];
 }
-// sounds with only one active channel will get upmixed to two, stereo sounds should remain unaffected
-// There might be a better way to do this
-export const upMixToStereo = (ctx, node) => {
-  const stereo = new StereoPannerNode(ctx);
-  node.connect(stereo);
-  return stereo;
-};
 
 export const resetLoadedSounds = () => soundMap.set({});
 
@@ -45,28 +38,6 @@ export const getAudioContext = () => {
 };
 // outputs: Map<int, GainNode>
 const outputs = new Map();
-let channelMerger;
-// channels: Array<int>
-const getDestinations = (channels) => {
-  const ctx = getAudioContext();
-  if (channelMerger == null) {
-    channelMerger = new ChannelMergerNode(ctx, { numberOfInputs: ctx.destination.channelCount });
-    channelMerger.connect(ctx.destination);
-  }
-  channels.forEach((ch) => {
-    if (!outputs.has(ch)) {
-      const gain = new GainNode(ctx, {
-        channelInterpretation: 'discrete',
-        channelCount: 1,
-        channelCountMode: 'explicit',
-      });
-      gain.connect(channelMerger, 0, ch);
-      outputs.set(ch, gain);
-    }
-  });
-
-  return channels.map((ch) => outputs.get(ch));
-};
 
 export const panic = () => {
   outputs.forEach((output) => {
@@ -120,20 +91,26 @@ export async function initAudioOnFirstClick(options) {
 
 let delays = {};
 const maxfeedback = 0.98;
-//input: audioNode, channels: Array<int>
-const connectToOutputs = (input, channels = [0, 1]) => {
-  const outputs = getDestinations(channels);
-  const ctx = getAudioContext();
 
-  //This upmix can be avoided if correct channel counts are set throughout the app,
-  //could theoretically support surround sound audio files if that work was done
-  const stereo = upMixToStereo(ctx, input);
+let channelMerger;
+// input: AudioNode, channels: ?Array<int>
+export const connectToDestination = (input, channels = [0, 1]) => {
+  const ctx = getAudioContext();
+  if (channelMerger == null) {
+    channelMerger = new ChannelMergerNode(ctx, { numberOfInputs: ctx.destination.channelCount });
+    channelMerger.connect(ctx.destination);
+  }
+  //This upmix can be removed if correct channel counts are set throughout the app,
+  // and then strudel could theoretically support surround sound audio files
+  const stereoMix = new StereoPannerNode(ctx);
+  input.connect(stereoMix);
+
   const splitter = new ChannelSplitterNode(ctx, {
-    numberOfOutputs: stereo.channelCount,
+    numberOfOutputs: stereoMix.channelCount,
   });
-  stereo.connect(splitter);
-  outputs.forEach((output, i) => {
-    splitter.connect(output, i % stereo.channelCount, 0);
+  stereoMix.connect(splitter);
+  channels.map((ch, i) => {
+    splitter.connect(channelMerger, i % stereoMix.channelCount, ch);
   });
 };
 
@@ -146,7 +123,7 @@ function getDelay(orbit, delaytime, delayfeedback, t) {
     const ac = getAudioContext();
     const dly = ac.createFeedbackDelay(1, delaytime, delayfeedback);
     dly.start?.(t); // for some reason, this throws when audion extension is installed..
-    connectToOutputs(dly, [0, 1]);
+    connectToDestination(dly, [0, 1]);
     delays[orbit] = dly;
   }
   delays[orbit].delayTime.value !== delaytime && delays[orbit].delayTime.setValueAtTime(delaytime, t);
@@ -205,7 +182,7 @@ function getReverb(orbit, duration, fade, lp, dim, ir) {
   if (!reverbs[orbit]) {
     const ac = getAudioContext();
     const reverb = ac.createReverb(duration, fade, lp, dim, ir);
-    connectToOutputs(reverb, [0, 1]);
+    connectToDestination(reverb, [0, 1]);
     reverbs[orbit] = reverb;
   }
   if (
@@ -480,7 +457,7 @@ export const superdough = async (value, deadline, hapDuration) => {
   // last gain
   const post = new GainNode(ac, { gain: postgain });
   chain.push(post);
-  connectToOutputs(post, channels);
+  connectToDestination(post, channels);
 
   // delay
   let delaySend;
diff --git a/website/src/repl/Footer.jsx b/website/src/repl/Footer.jsx
index 87e42dd7..35625093 100644
--- a/website/src/repl/Footer.jsx
+++ b/website/src/repl/Footer.jsx
@@ -7,7 +7,7 @@ import React, { useMemo, useCallback, useLayoutEffect, useRef, useState } from '
 import { Reference } from './Reference';
 import { themes } from './themes.mjs';
 import { useSettings, settingsMap, setActiveFooter, defaultSettings } from '../settings.mjs';
-import { getAudioContext, soundMap, upMixToStereo } from '@strudel.cycles/webaudio';
+import { getAudioContext, soundMap, connectToDestination } from '@strudel.cycles/webaudio';
 import { useStore } from '@nanostores/react';
 import { FilesTab } from './FilesTab';
 
@@ -271,7 +271,7 @@ function SoundsTab() {
               const onended = () => trigRef.current?.node?.disconnect();
               trigRef.current = Promise.resolve(onTrigger(time, params, onended));
               trigRef.current.then((ref) => {
-                upMixToStereo(ctx, ref?.node).connect(ctx.destination);
+                connectToDestination(ref?.node);
               });
             }}
           >

From 88e933ee2506c4ee948b4f09d8028db1c60416de Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 13:31:00 -0500
Subject: [PATCH 31/73] cleaning up

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

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 01b46a9e..31e6ea77 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -4,7 +4,7 @@ Copyright (C) 2022 Strudel contributors - see <https://github.com/tidalcycles/st
 This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-import { Pattern, register, reify, sequence } from './pattern.mjs';
+import { Pattern, register, sequence } from './pattern.mjs';
 import { zipWith } from './util.mjs';
 
 const controls = {};
@@ -389,7 +389,7 @@ const generic_params = [
    *
    * @param {number | Pattern} channels pattern the output channels
    * @example
-   * note("e a d b g").channels("2:3").room(1)
+   * note("e a d b g").channels("2:3")
    *
    */
   ['channels', 'ch'],
@@ -1390,13 +1390,4 @@ controls.ds = register('ds', (ds, pat) => {
   return pat.set({ decay, sustain });
 });
 
-// controls.ch = register(['channels', 'ch'], (channels, pat) => {
-//   channels = !Array.isArray(channels) ? [channels] : channels;
-
-//   // channels = channels.map(reify).map((channelPat) => {
-//   //   // How do I return the current value of the channel pattern here?
-//   // });
-//   return pat.set({ channels });
-// });
-
 export default controls;

From 64c2e7c1e8071e1676e9958d4f8f3a7f840f8b37 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 13:45:58 -0500
Subject: [PATCH 32/73] cleaning up

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

diff --git a/packages/superdough/synth.mjs b/packages/superdough/synth.mjs
index fad67b75..dafc2e7c 100644
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@@ -71,7 +71,8 @@ export function waveformN(partials, type) {
   const real = new Float32Array(partials + 1);
   const imag = new Float32Array(partials + 1);
   const ac = getAudioContext();
-  const osc = new OscillatorNode(ac, { channelCount: 1, channelCountMode: 'explicit' });
+  const osc = ac.createOscillator();
+
   const terms = {
     sawtooth: (n) => [0, -1 / n],
     square: (n) => [0, n % 2 === 0 ? 0 : 1 / n],
@@ -124,8 +125,7 @@ export function getOscillator(
   let o;
   // If no partials are given, use stock waveforms
   if (!partials || s === 'sine') {
-    o = new OscillatorNode(ac, { channelCount: 1, channelCountMode: 'explicit' });
-    console.log(o);
+    o = getAudioContext().createOscillator();
     o.type = s || 'triangle';
   }
   // generate custom waveform if partials are given

From 886b16d6fd906c1a1f917679bed0eb4011e42371 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 14:07:32 -0500
Subject: [PATCH 33/73] fixed panic function

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index a1b81edd..2eb4a64f 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -36,15 +36,6 @@ export const getAudioContext = () => {
   }
   return audioContext;
 };
-// outputs: Map<int, GainNode>
-const outputs = new Map();
-
-export const panic = () => {
-  outputs.forEach((output) => {
-    return output.gain.linearRampToValueAtTime(0, getAudioContext().currentTime + 0.01);
-  });
-  outputs.clear();
-};
 
 let workletsLoading;
 
@@ -92,13 +83,16 @@ export async function initAudioOnFirstClick(options) {
 let delays = {};
 const maxfeedback = 0.98;
 
-let channelMerger;
+let channelMerger, destinationGain;
+
 // input: AudioNode, channels: ?Array<int>
 export const connectToDestination = (input, channels = [0, 1]) => {
   const ctx = getAudioContext();
   if (channelMerger == null) {
     channelMerger = new ChannelMergerNode(ctx, { numberOfInputs: ctx.destination.channelCount });
-    channelMerger.connect(ctx.destination);
+    destinationGain = new GainNode(ctx);
+    channelMerger.connect(destinationGain);
+    destinationGain.connect(ctx.destination);
   }
   //This upmix can be removed if correct channel counts are set throughout the app,
   // and then strudel could theoretically support surround sound audio files
@@ -114,6 +108,11 @@ export const connectToDestination = (input, channels = [0, 1]) => {
   });
 };
 
+export const panic = () => {
+  destinationGain.gain.linearRampToValueAtTime(0, getAudioContext().currentTime + 0.01);
+  destinationGain = null;
+};
+
 function getDelay(orbit, delaytime, delayfeedback, t) {
   if (delayfeedback > maxfeedback) {
     //logger(`delayfeedback was clamped to ${maxfeedback} to save your ears`);

From e7376c4fc8753be908aedcfa81a4ca239abdc3ec Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Thu, 23 Nov 2023 14:17:17 -0500
Subject: [PATCH 34/73] panic function update

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 2eb4a64f..dfea5dc1 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -109,6 +109,9 @@ export const connectToDestination = (input, channels = [0, 1]) => {
 };
 
 export const panic = () => {
+  if (destinationGain == null) {
+    return;
+  }
   destinationGain.gain.linearRampToValueAtTime(0, getAudioContext().currentTime + 0.01);
   destinationGain = null;
 };

From 4fd3e6e99c45e8e4992a1ec9bfc78df42a8ea714 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 09:37:11 +0100
Subject: [PATCH 35/73] fix: entry.name mutation bug

---
 packages/react/src/components/Autocomplete.jsx | 4 ++--
 packages/react/src/components/Tooltip.jsx      | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/react/src/components/Autocomplete.jsx b/packages/react/src/components/Autocomplete.jsx
index 677baa6e..fe15ee9d 100644
--- a/packages/react/src/components/Autocomplete.jsx
+++ b/packages/react/src/components/Autocomplete.jsx
@@ -8,10 +8,10 @@ const getInnerText = (html) => {
   return div.textContent || div.innerText || '';
 };
 
-export function Autocomplete({ doc }) {
+export function Autocomplete({ doc, label }) {
   return (
     <div className="prose dark:prose-invert  max-h-[400px] overflow-auto">
-      <h3 className="pt-0 mt-0">{getDocLabel(doc)}</h3>
+      <h3 className="pt-0 mt-0">{label || getDocLabel(doc)}</h3>
       <div dangerouslySetInnerHTML={{ __html: doc.description }} />
       <ul>
         {doc.params?.map(({ name, type, description }, i) => (
diff --git a/packages/react/src/components/Tooltip.jsx b/packages/react/src/components/Tooltip.jsx
index a508e761..43a53476 100644
--- a/packages/react/src/components/Tooltip.jsx
+++ b/packages/react/src/components/Tooltip.jsx
@@ -55,7 +55,6 @@ export const strudelTooltip = hoverTooltip(
       if (!entry) {
         return null;
       }
-      entry.name = word;
     }
 
     return {
@@ -66,7 +65,7 @@ export const strudelTooltip = hoverTooltip(
       create(view) {
         let dom = document.createElement('div');
         dom.className = 'strudel-tooltip';
-        createRoot(dom).render(<Autocomplete doc={entry} />);
+        createRoot(dom).render(<Autocomplete doc={entry} label={word} />);
         return { dom };
       },
     };

From 458c97b92709254b6f05bfe55865a521c20c8143 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 09:37:26 +0100
Subject: [PATCH 36/73] list synonyms in Autocomplete

---
 packages/react/src/components/Autocomplete.jsx | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/react/src/components/Autocomplete.jsx b/packages/react/src/components/Autocomplete.jsx
index fe15ee9d..b8abfc0a 100644
--- a/packages/react/src/components/Autocomplete.jsx
+++ b/packages/react/src/components/Autocomplete.jsx
@@ -11,7 +11,12 @@ const getInnerText = (html) => {
 export function Autocomplete({ doc, label }) {
   return (
     <div className="prose dark:prose-invert  max-h-[400px] overflow-auto">
-      <h3 className="pt-0 mt-0">{label || getDocLabel(doc)}</h3>
+      <h3 className="pt-0 mt-0">{label || getDocLabel(doc)}</h3>{' '}
+      {!!doc.synonyms_text && (
+        <span>
+          Synonyms: <code>{doc.synonyms_text}</code>
+        </span>
+      )}
       <div dangerouslySetInnerHTML={{ __html: doc.description }} />
       <ul>
         {doc.params?.map(({ name, type, description }, i) => (

From 18e9ceb5013181ae7b19063c3f856bf52173c7a6 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 09:52:39 +0100
Subject: [PATCH 37/73] populate autocomplete with all synonyms + properly
 display synonyms based on label

---
 .../react/src/components/Autocomplete.jsx     | 40 +++++++++++--------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/packages/react/src/components/Autocomplete.jsx b/packages/react/src/components/Autocomplete.jsx
index b8abfc0a..9a0b9de4 100644
--- a/packages/react/src/components/Autocomplete.jsx
+++ b/packages/react/src/components/Autocomplete.jsx
@@ -2,19 +2,21 @@ import { createRoot } from 'react-dom/client';
 import jsdoc from '../../../../doc.json';
 
 const getDocLabel = (doc) => doc.name || doc.longname;
+const getDocSynonyms = (doc) => [getDocLabel(doc), ...(doc.synonyms || [])];
 const getInnerText = (html) => {
   var div = document.createElement('div');
   div.innerHTML = html;
   return div.textContent || div.innerText || '';
 };
 
-export function Autocomplete({ doc, label }) {
+export function Autocomplete({ doc, label = getDocLabel(doc) }) {
+  const synonyms = getDocSynonyms(doc).filter((a) => a !== label);
   return (
     <div className="prose dark:prose-invert  max-h-[400px] overflow-auto">
-      <h3 className="pt-0 mt-0">{label || getDocLabel(doc)}</h3>{' '}
-      {!!doc.synonyms_text && (
+      <h3 className="pt-0 mt-0">{label}</h3>{' '}
+      {!!synonyms.length && (
         <span>
-          Synonyms: <code>{doc.synonyms_text}</code>
+          Synonyms: <code>{synonyms.join(', ')}</code>
         </span>
       )}
       <div dangerouslySetInnerHTML={{ __html: doc.description }} />
@@ -53,18 +55,24 @@ const jsdocCompletions = jsdoc.docs
       !['superdirtOnly', 'noAutocomplete'].some((tag) => doc.tags?.find((t) => t.originalTitle === tag)),
   )
   // https://codemirror.net/docs/ref/#autocomplete.Completion
-  .map((doc) /*: Completion */ => ({
-    label: getDocLabel(doc),
-    // detail: 'xxx', // An optional short piece of information to show (with a different style) after the label.
-    info: () => {
-      const node = document.createElement('div');
-      // if Autocomplete is non-interactive, it could also be rendered at build time..
-      // .. using renderToStaticMarkup
-      createRoot(node).render(<Autocomplete doc={doc} />);
-      return node;
-    },
-    type: 'function', // https://codemirror.net/docs/ref/#autocomplete.Completion.type
-  }));
+  .reduce(
+    (acc, doc) /*: Completion */ =>
+      acc.concat(
+        [getDocLabel(doc), ...(doc.synonyms || [])].map((label) => ({
+          label,
+          // detail: 'xxx', // An optional short piece of information to show (with a different style) after the label.
+          info: () => {
+            const node = document.createElement('div');
+            // if Autocomplete is non-interactive, it could also be rendered at build time..
+            // .. using renderToStaticMarkup
+            createRoot(node).render(<Autocomplete doc={doc} label={label} />);
+            return node;
+          },
+          type: 'function', // https://codemirror.net/docs/ref/#autocomplete.Completion.type
+        })),
+      ),
+    [],
+  );
 
 export const strudelAutocomplete = (context /* : CompletionContext */) => {
   let word = context.matchBefore(/\w*/);

From fb7a9e2083c10226acfb7f29991076f64ea477c4 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 10:28:40 +0100
Subject: [PATCH 38/73] format

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index 3f41e256..a75614ec 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -3,7 +3,7 @@ import { getDrawContext } from '@strudel.cycles/core';
 let audio = false;
 let hydra;
 
-function appendCanvas(c){
+function appendCanvas(c) {
   const { canvas: testCanvas } = getDrawContext();
   c.canvas.id = 'hydra-canvas';
   c.canvas.style.position = 'absolute';
@@ -22,12 +22,12 @@ export async function initHydra(config) {
 
   // if config.audio is true
   // and current canvas des not detect audio
-  if (config?.audio && !hydra.detectAudio ){
+  if (config?.audio && !hydra.detectAudio) {
     //remove previous canvas without audio detection
-    document.getElementById('hydra-canvas').remove()
+    document.getElementById('hydra-canvas').remove();
     // create and append a new audio responsive canvas
-    hydra = new Hydra({ detectAudio: audio});
-    appendCanvas(hydra)
+    hydra = new Hydra({ detectAudio: audio });
+    appendCanvas(hydra);
   }
 }
 

From 456be920d345c3d6b6874a2b88a176fcbfe11e1a Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 11:17:30 +0100
Subject: [PATCH 39/73] else clause

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index b63fc46c..b2f60ddf 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -21,10 +21,9 @@ export async function initHydra(options = {}) {
     appendCanvas(hydra);
     // s0.init({ src: hydraCanvas }); // whats that?
   }
-
   // if options.detectAudio is true
   // and current canvas des not detect audio
-  if (options?.detectAudio && !hydra?.detectAudio) {
+  else if (options?.detectAudio && !hydra?.detectAudio) {
     //remove previous canvas without audio detection
     document.getElementById('hydra-canvas').remove();
     return initHydra(options);

From 9045ce05da102bdcc2b5a76922807ed1c56230b0 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 11:28:20 +0100
Subject: [PATCH 40/73] comment

---
 packages/hydra/hydra.mjs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index b2f60ddf..e2614ac0 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -16,14 +16,12 @@ export async function initHydra(options = {}) {
   if (!document.getElementById('hydra-canvas')) {
     const { src = 'https://unpkg.com/hydra-synth', ...opts } = options;
     await import(src);
-
     hydra = new Hydra(opts);
     appendCanvas(hydra);
-    // s0.init({ src: hydraCanvas }); // whats that?
-  }
-  // if options.detectAudio is true
-  // and current canvas des not detect audio
-  else if (options?.detectAudio && !hydra?.detectAudio) {
+    // hydra.synth.s0.init({ src: testCanvas });  // is this needed?
+  } else if (options?.detectAudio && !hydra?.detectAudio) {
+    // if options.detectAudio is true
+    // and current canvas des not detect audio
     //remove previous canvas without audio detection
     document.getElementById('hydra-canvas').remove();
     return initHydra(options);

From 508a6c92b28695d50e24e8c4619c525393780c58 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81mbar=20Tenorio=20Forn=C3=A9s?= <ambar@atenor.io>
Date: Fri, 24 Nov 2023 12:21:04 +0100
Subject: [PATCH 41/73] default hydra config without audio detection

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

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index e2614ac0..c97f3a48 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -11,7 +11,7 @@ function appendCanvas(c) {
   return testCanvas;
 }
 
-export async function initHydra(options = {}) {
+export async function initHydra(options = {detectAudio: false}) {
   //load and init hydra
   if (!document.getElementById('hydra-canvas')) {
     const { src = 'https://unpkg.com/hydra-synth', ...opts } = options;

From f7a283f87dd4597fdbaf527acf828f93cfa58887 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 24 Nov 2023 12:49:05 +0100
Subject: [PATCH 42/73] add feedStrudel option + smarter reinit logic

---
 packages/hydra/hydra.mjs | 30 +++++++++++++++++++-----------
 1 file changed, 19 insertions(+), 11 deletions(-)

diff --git a/packages/hydra/hydra.mjs b/packages/hydra/hydra.mjs
index c97f3a48..97ca5ac4 100644
--- a/packages/hydra/hydra.mjs
+++ b/packages/hydra/hydra.mjs
@@ -1,6 +1,6 @@
 import { getDrawContext } from '@strudel.cycles/core';
 
-let hydra;
+let latestOptions;
 
 function appendCanvas(c) {
   const { canvas: testCanvas } = getDrawContext();
@@ -11,20 +11,28 @@ function appendCanvas(c) {
   return testCanvas;
 }
 
-export async function initHydra(options = {detectAudio: false}) {
+export async function initHydra(options = {}) {
+  // reset if options have changed since last init
+  if (latestOptions && JSON.stringify(latestOptions) !== JSON.stringify(options)) {
+    document.getElementById('hydra-canvas').remove();
+  }
+  latestOptions = options;
   //load and init hydra
   if (!document.getElementById('hydra-canvas')) {
-    const { src = 'https://unpkg.com/hydra-synth', ...opts } = options;
+    console.log('reinit..');
+    const {
+      src = 'https://unpkg.com/hydra-synth',
+      feedStrudel = false,
+      ...hydraConfig
+    } = { detectAudio: false, ...options };
     await import(src);
-    hydra = new Hydra(opts);
+    const hydra = new Hydra(hydraConfig);
+    if (feedStrudel) {
+      const { canvas } = getDrawContext();
+      canvas.style.display = 'none';
+      hydra.synth.s0.init({ src: canvas });
+    }
     appendCanvas(hydra);
-    // hydra.synth.s0.init({ src: testCanvas });  // is this needed?
-  } else if (options?.detectAudio && !hydra?.detectAudio) {
-    // if options.detectAudio is true
-    // and current canvas des not detect audio
-    //remove previous canvas without audio detection
-    document.getElementById('hydra-canvas').remove();
-    return initHydra(options);
   }
 }
 

From 407510e265a28a479b45af47efd42622c05ee393 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sat, 25 Nov 2023 15:20:19 +0100
Subject: [PATCH 43/73] document feedStrudel

---
 packages/hydra/README.md          |  9 ++++-----
 website/src/pages/learn/hydra.mdx | 28 ++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/packages/hydra/README.md b/packages/hydra/README.md
index e36a421b..0b238692 100644
--- a/packages/hydra/README.md
+++ b/packages/hydra/README.md
@@ -12,12 +12,11 @@ await initHydra();
 
 Then you can use hydra below!
 
-### Enable audio capture
-Use `{audio: true}` param to enable Hydra's audio capture:
+### options
 
-```js
-await initHydra({audio: true});
-```
+You can also pass options to the `initHydra` function. These can be used to set [hydra options](https://github.com/hydra-synth/hydra-synth#api) + these strudel specific options:
+
+- `feedStrudel`: sends the strudel canvas to `s0`. The strudel canvas is used to draw `pianoroll`, `spiral`, `scope` etc..
 
 ## Usage via npm
 
diff --git a/website/src/pages/learn/hydra.mdx b/website/src/pages/learn/hydra.mdx
index d5219e6f..f1ace48b 100644
--- a/website/src/pages/learn/hydra.mdx
+++ b/website/src/pages/learn/hydra.mdx
@@ -41,6 +41,8 @@ note("[a,c,e,<a4 ab4 g4 gb4>,b4]/4").s("sawtooth").vib(2)
 `}
 />
 
+## H patterns
+
 There is a special function `H` that allows you to use a pattern as an input to hydra:
 
 <MiniRepl
@@ -52,6 +54,8 @@ n(pattern).scale("A:minor").piano().room(1)
 `}
 />
 
+## detectAudio
+
 To use hydra audio capture, call `initHydra` with `{detectAudio:true}` configuration param:
 
 <MiniRepl
@@ -69,3 +73,27 @@ n(pattern).scale("A:minor").piano().room(1)
 />
 
 You might now be able to see this properly here: [open in REPL](/#YXdhaXQgaW5pdEh5ZHJhKCkKbGV0IHBhdHRlcm4gPSAiMyA0IDUgWzYgN10qMiIKc2hhcGUoSChwYXR0ZXJuKSkub3V0KG8wKQpuKHBhdHRlcm4pLnNjYWxlKCJBOm1pbm9yIikucGlhbm8oKS5yb29tKDEpIA%3D%3D)
+
+Similar to `detectAudio`, all the [available hydra options](https://github.com/hydra-synth/hydra-synth#api) can be passed to `initHydra`.
+
+## feedStrudel
+
+Using the `feedStrudel` option, you can transform strudel visualizations with hydra:
+
+<MiniRepl
+  client:only="react"
+  tune={`await initHydra({feedStrudel:1})
+//
+src(s0).kaleid(H("<4 5 6>"))
+  .diff(osc(1,0.5,5))
+  .modulateScale(osc(2,-0.25,1))
+  .out()
+//
+stack(
+  s("bd*2,[hh:0:<.5 1>]*4,~ rim").bank("RolandTR909").speed(.9),
+  note("[<g1!3 <bb1 <f1 d1>>>]*3").s("sawtooth")
+  .room(.75).sometimes(add(note(12))).clip(.3)
+  .lpa(.05).lpenv(-4).lpf(2000).lpq(8).ftype('24db')
+).fft(4)
+  .scope({pos:0,smear:.95})`}
+/>

From 25b2eb5783a09697ed66c096dbdb483fa0549f0a Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sat, 25 Nov 2023 16:20:12 +0100
Subject: [PATCH 44/73] snapshot

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

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 34f7a850..09a1ecec 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -1038,6 +1038,31 @@ exports[`runs examples > example "ceil" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "channels" example index 0 1`] = `
+[
+  "[ 0/1 → 1/5 | note:e channels:[2 3] ]",
+  "[ 1/5 → 2/5 | note:a channels:[2 3] ]",
+  "[ 2/5 → 3/5 | note:d channels:[2 3] ]",
+  "[ 3/5 → 4/5 | note:b channels:[2 3] ]",
+  "[ 4/5 → 1/1 | note:g channels:[2 3] ]",
+  "[ 1/1 → 6/5 | note:e channels:[2 3] ]",
+  "[ 6/5 → 7/5 | note:a channels:[2 3] ]",
+  "[ 7/5 → 8/5 | note:d channels:[2 3] ]",
+  "[ 8/5 → 9/5 | note:b channels:[2 3] ]",
+  "[ 9/5 → 2/1 | note:g channels:[2 3] ]",
+  "[ 2/1 → 11/5 | note:e channels:[2 3] ]",
+  "[ 11/5 → 12/5 | note:a channels:[2 3] ]",
+  "[ 12/5 → 13/5 | note:d channels:[2 3] ]",
+  "[ 13/5 → 14/5 | note:b channels:[2 3] ]",
+  "[ 14/5 → 3/1 | note:g channels:[2 3] ]",
+  "[ 3/1 → 16/5 | note:e channels:[2 3] ]",
+  "[ 16/5 → 17/5 | note:a channels:[2 3] ]",
+  "[ 17/5 → 18/5 | note:d channels:[2 3] ]",
+  "[ 18/5 → 19/5 | note:b channels:[2 3] ]",
+  "[ 19/5 → 4/1 | note:g channels:[2 3] ]",
+]
+`;
+
 exports[`runs examples > example "chooseCycles" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | s:bd ]",

From dacd1e6146cc5dfcd11d70c7cefdbf675ac7b841 Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sun, 26 Nov 2023 22:50:17 +0100
Subject: [PATCH 45/73] Add and style algolia search

---
 website/src/components/Header/Header.astro |  6 +-
 website/src/components/Header/Search.css   | 75 ++++++++++++++++++----
 website/src/components/Header/Search.tsx   |  5 +-
 3 files changed, 68 insertions(+), 18 deletions(-)

diff --git a/website/src/components/Header/Header.astro b/website/src/components/Header/Header.astro
index 5912569d..4cee4282 100644
--- a/website/src/components/Header/Header.astro
+++ b/website/src/components/Header/Header.astro
@@ -35,7 +35,7 @@ const sidebar = SIDEBAR[langCode];
   </div>
   {/* KNOWN_LANGUAGE_CODES.length > 1 && <LanguageSelect lang={lang} client:idle /> */}
   <div class="search-item h-10">
-    <!-- <Search client:idle /> -->
+    <Search client:idle />
   </div>
   <a href="./" class="hidden md:flex cursor-pointer items-center space-x-1"
     ><CommandLineIcon className="w-5 h-5" /><span>go to REPL</span>
@@ -48,8 +48,8 @@ const sidebar = SIDEBAR[langCode];
 <style>
   /** Style Algolia */
   :root {
-    --docsearch-primary-color: var(--theme-accent);
-    --docsearch-logo-color: var(--theme-text);
+    --docsearch-primary-color: var(--lineHighlight);
+    --docsearch-logo-color: var(--foreground);
   }
 
   .search-item {
diff --git a/website/src/components/Header/Search.css b/website/src/components/Header/Search.css
index 344fcf48..c06a45e2 100644
--- a/website/src/components/Header/Search.css
+++ b/website/src/components/Header/Search.css
@@ -1,7 +1,27 @@
 /** Style Algolia */
 :root {
-  --docsearch-primary-color: var(--theme-accent);
-  --docsearch-logo-color: var(--theme-text);
+  --docsearch-primary-color: var(--lineHighlight);
+  --docsearch-logo-color: var(--foreground);
+  --docsearch-container-background: rgba(110,110,110,0.8);
+  --docsearch-modal-shadow: none;
+  --docsearch-text-color: var(--foreground);
+  --docsearch-highlight-color: var(--foreground);
+  --docsearch-searchbox-background: var(--lineBackground);
+  --docsearch-searchbox-focus-background: var(--lineBackground);
+  --docsearch-searchbox-shadow: inset 0 0 0 2px var(--lineHighlight);
+  --docsearch-hit-background: var(--background);
+  --docsearch-hit-active-color: var(--background);
+  --docsearch-hit-color: var(--foreground);
+  --docsearch-hit-shadow: 0 1px 3px 0 var(--foreground);
+  --docsearch-footer-shadow: none;
+  --docsearch-footer-background: var(--gutterBackground);
+  --docsearch-modal-background: var(--background);
+  --docsearch-muted-color: color-mix(in srgb,var(--foreground),#fff 30%);
+  --docsearch-key-gradient: var(--foreground);
+  --docsearch-key-shadow: inset 0 -2px 0 0 var(--gutterForeground),inset 0 0 1px 1px var(--foreground),0 1px 2px 1px var(--gutterBackground);
+}
+.dark {
+  --docsearch-muted-color: color-mix(in srgb,var(--foreground),#000 30%);
 }
 .search-input {
   flex-grow: 1;
@@ -14,9 +34,9 @@
   font-size: 1rem;
   font-family: inherit;
   line-height: inherit;
-  background-color: var(--theme-divider);
-  border-color: var(--theme-divider);
-  color: var(--theme-text-light);
+  background-color: var(--lineBackground);
+  border-color: var(--lineBackground);
+  color: var(--foreground);
   border-style: solid;
   border-width: 1px;
   border-radius: 0.25rem;
@@ -29,15 +49,15 @@
 }
 .search-input:hover,
 .search-input:focus {
-  color: var(--theme-text);
-  border-color: var(--theme-text-light);
+  color: var(--foreground);
+  border-color: var(--foreground);
 }
 .search-input:hover::placeholder,
 .search-input:focus::placeholder {
-  color: var(--theme-text-light);
+  color: var(--foreground);
 }
 .search-input::placeholder {
-  color: var(--theme-text-light);
+  color: var(--foreground);
 }
 .search-hint {
   position: absolute;
@@ -48,11 +68,13 @@
   align-items: center;
   justify-content: center;
   letter-spacing: 0.125em;
-  font-size: 13px;
+  font-size: 12px;
   font-family: var(--font-mono);
   pointer-events: none;
-  border-color: var(--theme-text-lighter);
-  color: var(--theme-text-light);
+  border-color: transparent;
+  color: var(--background);
+  background-color: var(--foreground);
+  box-shadow: var(--docsearch-key-shadow);
   border-style: solid;
   border-width: 1px;
   border-radius: 0.25rem;
@@ -64,12 +86,37 @@
     display: flex;
   }
 }
+.search-button {
+  background-color: var(--lineBackground) !important;
+  color: var(--foreground);
+}
 
 /* ------------------------------------------------------------ *\
 	DocSearch (Algolia)
 \* ------------------------------------------------------------ */
-
+.DocSearch-Form {
+  padding: 3px var(--docsearch-spacing);
+}
 .DocSearch-Modal .DocSearch-Hit a {
   box-shadow: none;
-  border: 1px solid var(--theme-accent);
+  border: none;
 }
+#docsearch-input.DocSearch-Input {
+  background-color: var(--lineBackground);
+  border-top: 3px solid var(--docsearch-searchbox-shadow);
+  border-bottom: 3px solid var(--docsearch-searchbox-shadow);
+}
+.DocSearch-Commands-Key {
+  color: var(--background);
+  border-radius: 0.25rem;
+}
+.DocSearch-SearchBar {
+  padding-bottom: 1px;
+}
+#docsearch-input.DocSearch-Input:focus {
+  box-shadow: none;
+}
+.DocSearch-Footer {
+  color: var(--docsearch-muted-color) !important;
+}
+.DocSearch-Logo svg .cls-1, .DocSearch-Logo svg .cls-2{fill:var(--docsearch-logo-color);}
\ No newline at end of file
diff --git a/website/src/components/Header/Search.tsx b/website/src/components/Header/Search.tsx
index f51ede45..6a152b7c 100644
--- a/website/src/components/Header/Search.tsx
+++ b/website/src/components/Header/Search.tsx
@@ -43,7 +43,7 @@ export default function Search() {
 
   return (
     <>
-      <button type="button" ref={searchButtonRef} onClick={onOpen} className="rounded-md bg-slate-900 w-full px-2">
+      <button type="button" ref={searchButtonRef} onClick={onOpen} className="rounded-md bg-slate-900 w-full px-2 search-button">
         <svg width="24" height="24" fill="none">
           <path
             d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"
@@ -74,6 +74,9 @@ export default function Search() {
             indexName={ALGOLIA.indexName}
             appId={ALGOLIA.appId}
             apiKey={ALGOLIA.apiKey}
+            getMissingResultsUrl={({ query }) => {
+              return `https://github.com/tidalcycles/strudel/issues/new?title=Missing doc for ${query}`;
+            }}
             transformItems={(items) => {
               return items.map((item) => {
                 // We transform the absolute URL into a relative URL to

From 020c3264587cdf525696851e7ad11061e5260a99 Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Sun, 26 Nov 2023 22:52:17 +0100
Subject: [PATCH 46/73] Codeformat for search

---
 website/src/components/Header/Search.css | 14 +++++++++-----
 website/src/components/Header/Search.tsx |  7 ++++++-
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/website/src/components/Header/Search.css b/website/src/components/Header/Search.css
index c06a45e2..456ef9f6 100644
--- a/website/src/components/Header/Search.css
+++ b/website/src/components/Header/Search.css
@@ -2,7 +2,7 @@
 :root {
   --docsearch-primary-color: var(--lineHighlight);
   --docsearch-logo-color: var(--foreground);
-  --docsearch-container-background: rgba(110,110,110,0.8);
+  --docsearch-container-background: rgba(110, 110, 110, 0.8);
   --docsearch-modal-shadow: none;
   --docsearch-text-color: var(--foreground);
   --docsearch-highlight-color: var(--foreground);
@@ -16,12 +16,13 @@
   --docsearch-footer-shadow: none;
   --docsearch-footer-background: var(--gutterBackground);
   --docsearch-modal-background: var(--background);
-  --docsearch-muted-color: color-mix(in srgb,var(--foreground),#fff 30%);
+  --docsearch-muted-color: color-mix(in srgb, var(--foreground), #fff 30%);
   --docsearch-key-gradient: var(--foreground);
-  --docsearch-key-shadow: inset 0 -2px 0 0 var(--gutterForeground),inset 0 0 1px 1px var(--foreground),0 1px 2px 1px var(--gutterBackground);
+  --docsearch-key-shadow: inset 0 -2px 0 0 var(--gutterForeground), inset 0 0 1px 1px var(--foreground),
+    0 1px 2px 1px var(--gutterBackground);
 }
 .dark {
-  --docsearch-muted-color: color-mix(in srgb,var(--foreground),#000 30%);
+  --docsearch-muted-color: color-mix(in srgb, var(--foreground), #000 30%);
 }
 .search-input {
   flex-grow: 1;
@@ -119,4 +120,7 @@
 .DocSearch-Footer {
   color: var(--docsearch-muted-color) !important;
 }
-.DocSearch-Logo svg .cls-1, .DocSearch-Logo svg .cls-2{fill:var(--docsearch-logo-color);}
\ No newline at end of file
+.DocSearch-Logo svg .cls-1,
+.DocSearch-Logo svg .cls-2 {
+  fill: var(--docsearch-logo-color);
+}
diff --git a/website/src/components/Header/Search.tsx b/website/src/components/Header/Search.tsx
index 6a152b7c..d3a935f5 100644
--- a/website/src/components/Header/Search.tsx
+++ b/website/src/components/Header/Search.tsx
@@ -43,7 +43,12 @@ export default function Search() {
 
   return (
     <>
-      <button type="button" ref={searchButtonRef} onClick={onOpen} className="rounded-md bg-slate-900 w-full px-2 search-button">
+      <button
+        type="button"
+        ref={searchButtonRef}
+        onClick={onOpen}
+        className="rounded-md bg-slate-900 w-full px-2 search-button"
+      >
         <svg width="24" height="24" fill="none">
           <path
             d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"

From b16f235e1c497a6917f5d6e10dab98ee0c9edd2f Mon Sep 17 00:00:00 2001
From: Drew Barnes <drew.g.barnes@gmail.com>
Date: Fri, 1 Dec 2023 14:23:07 -0800
Subject: [PATCH 47/73] Update first-sounds.mdx

---
 website/src/pages/workshop/first-sounds.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/src/pages/workshop/first-sounds.mdx b/website/src/pages/workshop/first-sounds.mdx
index 124dbde7..5897f029 100644
--- a/website/src/pages/workshop/first-sounds.mdx
+++ b/website/src/pages/workshop/first-sounds.mdx
@@ -159,7 +159,7 @@ Try adding more sounds inside a bracket!
 
 </Box>
 
-Similar to the whole sequence, the content of a sub-sequence will be squished to the its own length.
+Similar to the whole sequence, the content of a sub-sequence will be squished to its own length.
 
 **Multiplication: Speed things up**
 

From 9aec18b3a0c7cbf86f15b45e0d41cbdf14726fb2 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Sun, 3 Dec 2023 18:25:30 -0500
Subject: [PATCH 48/73] add 1 to channel selection

---
 packages/core/controls.mjs         | 2 +-
 packages/superdough/superdough.mjs | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 6eca59d8..d979ff23 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -389,7 +389,7 @@ const generic_params = [
    *
    * @param {number | Pattern} channels pattern the output channels
    * @example
-   * note("e a d b g").channels("2:3")
+   * note("e a d b g").channels("3:4")
    *
    */
   ['channels', 'ch'],
diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 8449c5c7..1291c192 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -103,8 +103,8 @@ export const connectToDestination = (input, channels = [0, 1]) => {
     numberOfOutputs: stereoMix.channelCount,
   });
   stereoMix.connect(splitter);
-  channels.map((ch, i) => {
-    splitter.connect(channelMerger, i % stereoMix.channelCount, ch);
+  channels.forEach((ch, i) => {
+    splitter.connect(channelMerger, i % stereoMix.channelCount, clamp(ch, 0, ctx.destination.channelCount - 1));
   });
 };
 
@@ -290,7 +290,7 @@ export const superdough = async (value, deadline, hapDuration) => {
     bpsustain = 1,
     bprelease = 0.01,
     bandq = 1,
-    channels = [0, 1],
+    channels = [1, 2],
     //phaser
     phaser,
     phaserdepth = 0.75,
@@ -323,7 +323,8 @@ export const superdough = async (value, deadline, hapDuration) => {
     compressorRelease,
   } = value;
 
-  channels = Array.isArray(channels) ? channels : [channels];
+  //music programs/audio gear usually labels channels 0,1 as 1,2 so imitate that behavior
+  channels = (Array.isArray(channels) ? channels : [channels]).map((ch) => ch - 1);
 
   gain *= velocity; // legacy fix for velocity
   let toDisconnect = []; // audio nodes that will be disconnected when the source has ended

From f51109cb266dcef35536d84f367789b028cb0118 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Sun, 3 Dec 2023 18:26:48 -0500
Subject: [PATCH 49/73] comment

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

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index 1291c192..2305ab44 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -323,7 +323,7 @@ export const superdough = async (value, deadline, hapDuration) => {
     compressorRelease,
   } = value;
 
-  //music programs/audio gear usually labels channels 0,1 as 1,2 so imitate that behavior
+  //music programs/audio gear usually increments inputs/outputs from 1, so imitate that behavior
   channels = (Array.isArray(channels) ? channels : [channels]).map((ch) => ch - 1);
 
   gain *= velocity; // legacy fix for velocity

From 9be10890e1465a936ba3ad2e7d1d7d8a40308cd5 Mon Sep 17 00:00:00 2001
From: Jade Rowland <jaderowlanddev@gmail.com>
Date: Sun, 3 Dec 2023 18:31:01 -0500
Subject: [PATCH 50/73] update tests

---
 test/__snapshots__/examples.test.mjs.snap | 40 +++++++++++------------
 test/__snapshots__/tunes.test.mjs.snap    |  4 +--
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 09a1ecec..bd5e9cb9 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -1040,26 +1040,26 @@ exports[`runs examples > example "ceil" example index 0 1`] = `
 
 exports[`runs examples > example "channels" example index 0 1`] = `
 [
-  "[ 0/1 → 1/5 | note:e channels:[2 3] ]",
-  "[ 1/5 → 2/5 | note:a channels:[2 3] ]",
-  "[ 2/5 → 3/5 | note:d channels:[2 3] ]",
-  "[ 3/5 → 4/5 | note:b channels:[2 3] ]",
-  "[ 4/5 → 1/1 | note:g channels:[2 3] ]",
-  "[ 1/1 → 6/5 | note:e channels:[2 3] ]",
-  "[ 6/5 → 7/5 | note:a channels:[2 3] ]",
-  "[ 7/5 → 8/5 | note:d channels:[2 3] ]",
-  "[ 8/5 → 9/5 | note:b channels:[2 3] ]",
-  "[ 9/5 → 2/1 | note:g channels:[2 3] ]",
-  "[ 2/1 → 11/5 | note:e channels:[2 3] ]",
-  "[ 11/5 → 12/5 | note:a channels:[2 3] ]",
-  "[ 12/5 → 13/5 | note:d channels:[2 3] ]",
-  "[ 13/5 → 14/5 | note:b channels:[2 3] ]",
-  "[ 14/5 → 3/1 | note:g channels:[2 3] ]",
-  "[ 3/1 → 16/5 | note:e channels:[2 3] ]",
-  "[ 16/5 → 17/5 | note:a channels:[2 3] ]",
-  "[ 17/5 → 18/5 | note:d channels:[2 3] ]",
-  "[ 18/5 → 19/5 | note:b channels:[2 3] ]",
-  "[ 19/5 → 4/1 | note:g channels:[2 3] ]",
+  "[ 0/1 → 1/5 | note:e channels:[3 4] ]",
+  "[ 1/5 → 2/5 | note:a channels:[3 4] ]",
+  "[ 2/5 → 3/5 | note:d channels:[3 4] ]",
+  "[ 3/5 → 4/5 | note:b channels:[3 4] ]",
+  "[ 4/5 → 1/1 | note:g channels:[3 4] ]",
+  "[ 1/1 → 6/5 | note:e channels:[3 4] ]",
+  "[ 6/5 → 7/5 | note:a channels:[3 4] ]",
+  "[ 7/5 → 8/5 | note:d channels:[3 4] ]",
+  "[ 8/5 → 9/5 | note:b channels:[3 4] ]",
+  "[ 9/5 → 2/1 | note:g channels:[3 4] ]",
+  "[ 2/1 → 11/5 | note:e channels:[3 4] ]",
+  "[ 11/5 → 12/5 | note:a channels:[3 4] ]",
+  "[ 12/5 → 13/5 | note:d channels:[3 4] ]",
+  "[ 13/5 → 14/5 | note:b channels:[3 4] ]",
+  "[ 14/5 → 3/1 | note:g channels:[3 4] ]",
+  "[ 3/1 → 16/5 | note:e channels:[3 4] ]",
+  "[ 16/5 → 17/5 | note:a channels:[3 4] ]",
+  "[ 17/5 → 18/5 | note:d channels:[3 4] ]",
+  "[ 18/5 → 19/5 | note:b channels:[3 4] ]",
+  "[ 19/5 → 4/1 | note:g channels:[3 4] ]",
 ]
 `;
 
diff --git a/test/__snapshots__/tunes.test.mjs.snap b/test/__snapshots__/tunes.test.mjs.snap
index 8d696d75..79fb2690 100644
--- a/test/__snapshots__/tunes.test.mjs.snap
+++ b/test/__snapshots__/tunes.test.mjs.snap
@@ -7831,8 +7831,8 @@ exports[`renders tunes > tune: hyperpop 1`] = `
   "[ 3/2 ⇜ (11/6 → 15/8) | note:C#5 s:sawtooth gain:0.3422847385870941 attack:0.001 decay:0.2 sustain:0 hcutoff:5845.47833980621 cutoff:4000 ]",
   "[ 15/8 → 2/1 | note:D3 s:sawtooth gain:0.3 attack:0.01 decay:0.1 sustain:0.5 cutoff:2151.2782118349805 lpattack:0.1 lpenv:2 ftype:24db ]",
   "[ 15/8 → 2/1 | note:D3 s:square gain:0.3 attack:0.01 decay:0.1 sustain:0.5 cutoff:2151.2782118349805 lpattack:0.1 lpenv:2 ftype:24db ]",
-  "[ (15/8 → 2/1) ⇝ 9/4 | note:A5 s:sawtooth gain:0.35343108171056004 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
-  "[ (15/8 → 2/1) ⇝ 9/4 | note:C#5 s:sawtooth gain:0.35343108171056004 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
+  "[ (15/8 → 2/1) ⇝ 9/4 | note:A5 s:sawtooth gain:0.35343108171056015 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
+  "[ (15/8 → 2/1) ⇝ 9/4 | note:C#5 s:sawtooth gain:0.35343108171056015 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
   "[ (15/8 → 2/1) ⇝ 19/8 | note:F#3 s:square gain:0.7 attack:0.01 decay:0.1 sustain:0 cutoff:2151.2782118349805 ]",
   "[ (15/8 → 2/1) ⇝ 19/8 | note:A3 s:square gain:0.7 attack:0.01 decay:0.1 sustain:0 cutoff:2151.2782118349805 ]",
   "[ 13/8 ⇜ (23/12 → 2/1) | note:F#5 s:sawtooth gain:0.3479759264430665 attack:0.001 decay:0.2 sustain:0 hcutoff:5822.02388217981 cutoff:4000 ]",

From 7c948dd8129d7ce9a5d27880139ac058897f758b Mon Sep 17 00:00:00 2001
From: "Alexandre G.-Raymond" <alex@ndre.gr>
Date: Mon, 4 Dec 2023 14:48:54 +0100
Subject: [PATCH 51/73] Prevent 404 on Algolia crawls

---
 website/src/pages/learn/csound.mdx           | 2 +-
 website/src/pages/learn/getting-started.mdx  | 2 +-
 website/src/pages/learn/sounds.mdx           | 2 +-
 website/src/pages/learn/strudel-vs-tidal.mdx | 4 ++--
 website/src/pages/learn/time-modifiers.mdx   | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/website/src/pages/learn/csound.mdx b/website/src/pages/learn/csound.mdx
index 8f854c21..4ef04419 100644
--- a/website/src/pages/learn/csound.mdx
+++ b/website/src/pages/learn/csound.mdx
@@ -145,7 +145,7 @@ In both cases, p4 is derived from the value of `freq` or `note`.
 ## Limitations / Future Plans
 
 Apart from the above listed p values, no other parameter can be patterned so far.
-This also means that [audio effects](./learn/effects) will not work.
+This also means that [audio effects](/learn/effects/) will not work.
 In the future, the integration could be improved by passing all patterned control parameters to the csound instrument.
 This could work by a unique [channel](https://kunstmusik.github.io/icsc2022-csound-web/tutorial2-interacting-with-csound/#step-4---writing-continuous-data-channels)
 for each value. Channels could be read [like this](https://github.com/csound/csound/blob/master/Android/CsoundForAndroid/CsoundAndroidExamples/src/main/res/raw/multitouch_xy.csd).
diff --git a/website/src/pages/learn/getting-started.mdx b/website/src/pages/learn/getting-started.mdx
index 29cd6b7d..0fb750c1 100644
--- a/website/src/pages/learn/getting-started.mdx
+++ b/website/src/pages/learn/getting-started.mdx
@@ -41,7 +41,7 @@ This interactive tutorial will guide you through the basics of Strudel.
 To see and hear what Strudel can do, visit the [Strudel REPL](https://strudel.cc/) and click the Shuffle icon in the top menu bar.
 You can get a feel for Strudel by browsing and editing these examples and clicking the Refresh icon to update.
 
-You can also browse through the examples [here](./examples).
+You can also browse through the examples [here](/examples).
 
 Alternatively, you can get a taste of what Strudel can do by clicking play on this track:
 
diff --git a/website/src/pages/learn/sounds.mdx b/website/src/pages/learn/sounds.mdx
index a17c2d0c..a9fd547c 100644
--- a/website/src/pages/learn/sounds.mdx
+++ b/website/src/pages/learn/sounds.mdx
@@ -19,7 +19,7 @@ You can learn more about both of these approaches in the pages [Synths](/learn/s
 
 # Combining notes and sounds
 
-In both of the above cases, we are no longer directly controlling the `note`/`freq` of the sound heard via `s`, as we were in the [Notes](/strudel/notes) page.
+In both of the above cases, we are no longer directly controlling the `note`/`freq` of the sound heard via `s`, as we were in the [Notes](/workshop/first-notes/) page.
 
 So how can we both control the sound and the pitch? We can _combine_ `note`/`freq` with `s` to change the sound of our pitches:
 
diff --git a/website/src/pages/learn/strudel-vs-tidal.mdx b/website/src/pages/learn/strudel-vs-tidal.mdx
index 60f24149..0c7213c7 100644
--- a/website/src/pages/learn/strudel-vs-tidal.mdx
+++ b/website/src/pages/learn/strudel-vs-tidal.mdx
@@ -96,13 +96,13 @@ If you find a tidal control that's not on the list, please tell!
 ## Sound
 
 Tidal is commonly paired with Superdirt / Supercollider for sound generation.
-While Strudel also has a way of [communicating with Superdirt](./learn/input-output),
+While Strudel also has a way of [communicating with Superdirt](/learn/input-output/),
 it aims to provide a standalone live coding environment that runs entirely in the browser.
 
 ### Audio Effects
 
 Many of SuperDirt's effects have been reimplemented in Strudel, using the Web Audio API.
-You can find a [list of available effects here](./learn/effects).
+You can find a [list of available effects here](/learn/effects/).
 
 ### Sampler
 
diff --git a/website/src/pages/learn/time-modifiers.mdx b/website/src/pages/learn/time-modifiers.mdx
index 217a7851..e1226512 100644
--- a/website/src/pages/learn/time-modifiers.mdx
+++ b/website/src/pages/learn/time-modifiers.mdx
@@ -110,4 +110,4 @@ Some of these have equivalent operators in the Mini Notation:
 
 <JsDoc client:idle name="ribbon" h={0} />
 
-Apart from modifying time, there are ways to [Control Parameters](functions/value-modifiers).
+Apart from modifying time, there are ways to [Control Parameters](/functions/value-modifiers/).

From 1bca05e3497c1062fc1eaf0b350672b8134b23e2 Mon Sep 17 00:00:00 2001
From: Bernhard Wagner <github.comNotification20120125@xmlizer.net>
Date: Tue, 5 Dec 2023 11:15:13 +0100
Subject: [PATCH 52/73] FIXES: palindrome abc -> abccba (#831)

* FIXES: palindrome abc -> abccba

* FIXES: tests for palindrome

---------

Co-authored-by: Bernhard Wagner <gitcommit@nosuch.biz>
---
 packages/core/pattern.mjs                 |  2 +-
 packages/core/test/pattern.test.mjs       | 13 +++++++++
 test/__snapshots__/examples.test.mjs.snap | 32 +++++++++++------------
 test/__snapshots__/tunes.test.mjs.snap    | 20 +++++++-------
 4 files changed, 40 insertions(+), 27 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 9a5c456a..f6969a73 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1985,7 +1985,7 @@ Pattern.prototype.hush = function () {
  * note("c d e g").palindrome()
  */
 export const palindrome = register('palindrome', function (pat) {
-  return pat.every(2, rev);
+  return pat.lastOf(2, rev);
 });
 
 /**
diff --git a/packages/core/test/pattern.test.mjs b/packages/core/test/pattern.test.mjs
index f4a03110..1c849499 100644
--- a/packages/core/test/pattern.test.mjs
+++ b/packages/core/test/pattern.test.mjs
@@ -20,6 +20,7 @@ import {
   slowcat,
   cat,
   sequence,
+  palindrome,
   polymeter,
   polymeterSteps,
   polyrhythm,
@@ -571,6 +572,18 @@ describe('Pattern', () => {
       expect(sequence(1, 2, 3).firstCycle()).toStrictEqual(fastcat(1, 2, 3).firstCycle());
     });
   });
+  describe('palindrome()', () => {
+    it('Can create palindrome', () => {
+      expect(
+        fastcat('a', 'b', 'c')
+          .palindrome()
+          .fast(2)
+          .firstCycle()
+          .sort((a, b) => a.part.begin.sub(b.part.begin))
+          .map((a) => a.value),
+      ).toStrictEqual(['a', 'b', 'c', 'c', 'b', 'a']);
+    });
+  });
   describe('polyrhythm()', () => {
     it('Can layer up cycles', () => {
       expect(polyrhythm(['a', 'b'], ['c']).firstCycle()).toStrictEqual(
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 34f7a850..721c7342 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -3267,22 +3267,22 @@ exports[`runs examples > example "outside" example index 0 1`] = `
 
 exports[`runs examples > example "palindrome" example index 0 1`] = `
 [
-  "[ 0/1 → 1/4 | note:g ]",
-  "[ 1/4 → 1/2 | note:e ]",
-  "[ 1/2 → 3/4 | note:d ]",
-  "[ 3/4 → 1/1 | note:c ]",
-  "[ 1/1 → 5/4 | note:c ]",
-  "[ 5/4 → 3/2 | note:d ]",
-  "[ 3/2 → 7/4 | note:e ]",
-  "[ 7/4 → 2/1 | note:g ]",
-  "[ 2/1 → 9/4 | note:g ]",
-  "[ 9/4 → 5/2 | note:e ]",
-  "[ 5/2 → 11/4 | note:d ]",
-  "[ 11/4 → 3/1 | note:c ]",
-  "[ 3/1 → 13/4 | note:c ]",
-  "[ 13/4 → 7/2 | note:d ]",
-  "[ 7/2 → 15/4 | note:e ]",
-  "[ 15/4 → 4/1 | note:g ]",
+  "[ 0/1 → 1/4 | note:c ]",
+  "[ 1/4 → 1/2 | note:d ]",
+  "[ 1/2 → 3/4 | note:e ]",
+  "[ 3/4 → 1/1 | note:g ]",
+  "[ 1/1 → 5/4 | note:g ]",
+  "[ 5/4 → 3/2 | note:e ]",
+  "[ 3/2 → 7/4 | note:d ]",
+  "[ 7/4 → 2/1 | note:c ]",
+  "[ 2/1 → 9/4 | note:c ]",
+  "[ 9/4 → 5/2 | note:d ]",
+  "[ 5/2 → 11/4 | note:e ]",
+  "[ 11/4 → 3/1 | note:g ]",
+  "[ 3/1 → 13/4 | note:g ]",
+  "[ 13/4 → 7/2 | note:e ]",
+  "[ 7/2 → 15/4 | note:d ]",
+  "[ 15/4 → 4/1 | note:c ]",
 ]
 `;
 
diff --git a/test/__snapshots__/tunes.test.mjs.snap b/test/__snapshots__/tunes.test.mjs.snap
index 8d696d75..0a341d12 100644
--- a/test/__snapshots__/tunes.test.mjs.snap
+++ b/test/__snapshots__/tunes.test.mjs.snap
@@ -8372,16 +8372,16 @@ exports[`renders tunes > tune: hyperpop 1`] = `
 
 exports[`renders tunes > tune: juxUndTollerei 1`] = `
 [
-  "[ 0/1 → 1/4 | note:bb3 s:sawtooth pan:0 cutoff:1188.2154262966046 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 0/1 → 1/4 | note:c3 s:sawtooth pan:1 cutoff:1188.2154262966046 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 1/4 → 1/2 | note:g3 s:sawtooth pan:0 cutoff:1361.2562095290161 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 1/4 → 1/2 | note:eb3 s:sawtooth pan:1 cutoff:1361.2562095290161 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 1/2 → 3/4 | note:eb3 s:sawtooth pan:0 cutoff:1524.257063143398 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 1/2 → 3/4 | note:g3 s:sawtooth pan:1 cutoff:1524.257063143398 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ (101/200 → 1/1) ⇝ 201/200 | note:65 s:triangle pan:0 cutoff:1601.4815730092653 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ (101/200 → 1/1) ⇝ 201/200 | note:55 s:triangle pan:1 cutoff:1601.4815730092653 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 3/4 → 1/1 | note:c3 s:sawtooth pan:0 cutoff:1670.953955747281 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
-  "[ 3/4 → 1/1 | note:bb3 s:sawtooth pan:1 cutoff:1670.953955747281 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 0/1 → 1/4 | note:c3 s:sawtooth pan:0 cutoff:1188.2154262966046 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 0/1 → 1/4 | note:bb3 s:sawtooth pan:1 cutoff:1188.2154262966046 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 1/4 → 1/2 | note:eb3 s:sawtooth pan:0 cutoff:1361.2562095290161 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 1/4 → 1/2 | note:g3 s:sawtooth pan:1 cutoff:1361.2562095290161 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 1/2 → 3/4 | note:g3 s:sawtooth pan:0 cutoff:1524.257063143398 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 1/2 → 3/4 | note:eb3 s:sawtooth pan:1 cutoff:1524.257063143398 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ (101/200 → 1/1) ⇝ 201/200 | note:55 s:triangle pan:0 cutoff:1601.4815730092653 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ (101/200 → 1/1) ⇝ 201/200 | note:65 s:triangle pan:1 cutoff:1601.4815730092653 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 3/4 → 1/1 | note:bb3 s:sawtooth pan:0 cutoff:1670.953955747281 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
+  "[ 3/4 → 1/1 | note:c3 s:sawtooth pan:1 cutoff:1670.953955747281 lpattack:0.2 lpenv:-2 decay:0.05 sustain:0 room:0.6 delay:0.5 delaytime:0.1 delayfeedback:0.4 ]",
 ]
 `;
 

From 2ce8576ab256c07272e38777f341f120eac2a410 Mon Sep 17 00:00:00 2001
From: Bernhard Wagner <github.comNotification20120125@xmlizer.net>
Date: Tue, 5 Dec 2023 12:19:06 +0100
Subject: [PATCH 53/73] CHANGES: github action checkout v2->v4 (#837)

Co-authored-by: Bernhard Wagner <gitcommit@nosuch.biz>
---
 .github/workflows/deploy.yml | 2 +-
 .github/workflows/test.yml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 62e91d36..51240974 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -21,7 +21,7 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
         with:
           version: 7
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 849db7d3..c35e7241 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -10,7 +10,7 @@ jobs:
         node-version: [18]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
         with:
           version: 7

From b8866cf57586157a91f507bc5af1967ea69fb889 Mon Sep 17 00:00:00 2001
From: Bernhard Wagner <github.comNotification20120125@xmlizer.net>
Date: Tue, 5 Dec 2023 12:19:17 +0100
Subject: [PATCH 54/73] CHANGES: pin pnpm to version 8.3.1 (#834)

Co-authored-by: Bernhard Wagner <gitcommit@nosuch.biz>
---
 CONTRIBUTING.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 467a9391..1826b12a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -66,7 +66,8 @@ To get the project up and running for development, make sure you have installed:
 
 - [git](https://git-scm.com/)
 - [node](https://nodejs.org/en/) >= 18
-- [pnpm](https://pnpm.io/) (`npm i pnpm -g`)
+- [pnpm](https://pnpm.io/) (`curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=8.3.1 sh -`)
+  tests failed to work correctly with newer pnpm versions, so we pin 8.3.1 for now. (see issue #833)
 
 then, do the following:
 

From fe8debe6e8888a0e5f7d30850e63a869174f48d6 Mon Sep 17 00:00:00 2001
From: Bernhard Wagner <github.comNotification20120125@xmlizer.net>
Date: Tue, 5 Dec 2023 12:19:26 +0100
Subject: [PATCH 55/73] CHANGES: github action pnpm version from 7 to 8.3.1
 (#835)

Co-authored-by: Bernhard Wagner <gitcommit@nosuch.biz>
---
 .github/workflows/deploy.yml | 2 +-
 .github/workflows/test.yml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 51240974..2279b20f 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
         with:
-          version: 7
+          version: 8.3.1
       - uses: actions/setup-node@v3
         with:
           node-version: 18
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index c35e7241..f53600e9 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -13,7 +13,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
         with:
-          version: 7
+          version: 8.3.1
       - uses: actions/setup-node@v3
         with:
           node-version: ${{ matrix.node-version }}

From ebf93c06dda0543c88782eeb0003f4e5ba34e026 Mon Sep 17 00:00:00 2001
From: Bernhard Wagner <github.comNotification20120125@xmlizer.net>
Date: Tue, 5 Dec 2023 12:19:57 +0100
Subject: [PATCH 56/73] ADDS: JetBrains IDE files (#840)

Co-authored-by: Bernhard Wagner <gitcommit@nosuch.biz>
---
 .gitignore | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 84 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index fe7f9e56..b7704c61 100644
--- a/.gitignore
+++ b/.gitignore
@@ -43,4 +43,87 @@ dev-dist
 Dirt-Samples
 tidal-drum-machines
 webaudiofontdata
-src-tauri/target
\ No newline at end of file
+src-tauri/target
+
+# BEGIN JetBrains -> END JetBrains
+
+# for JetBrains IDE users, e.g. WebStorm. Source: https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# END JetBrains -> BEGIN JetBrains

From 1190f6e0910ca1235ed6b969d0d0fe1bf80691ce Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Tue, 5 Dec 2023 18:17:33 +0100
Subject: [PATCH 57/73] fix weird rounding change...

---
 test/__snapshots__/tunes.test.mjs.snap | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/test/__snapshots__/tunes.test.mjs.snap b/test/__snapshots__/tunes.test.mjs.snap
index 79fb2690..8d696d75 100644
--- a/test/__snapshots__/tunes.test.mjs.snap
+++ b/test/__snapshots__/tunes.test.mjs.snap
@@ -7831,8 +7831,8 @@ exports[`renders tunes > tune: hyperpop 1`] = `
   "[ 3/2 ⇜ (11/6 → 15/8) | note:C#5 s:sawtooth gain:0.3422847385870941 attack:0.001 decay:0.2 sustain:0 hcutoff:5845.47833980621 cutoff:4000 ]",
   "[ 15/8 → 2/1 | note:D3 s:sawtooth gain:0.3 attack:0.01 decay:0.1 sustain:0.5 cutoff:2151.2782118349805 lpattack:0.1 lpenv:2 ftype:24db ]",
   "[ 15/8 → 2/1 | note:D3 s:square gain:0.3 attack:0.01 decay:0.1 sustain:0.5 cutoff:2151.2782118349805 lpattack:0.1 lpenv:2 ftype:24db ]",
-  "[ (15/8 → 2/1) ⇝ 9/4 | note:A5 s:sawtooth gain:0.35343108171056015 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
-  "[ (15/8 → 2/1) ⇝ 9/4 | note:C#5 s:sawtooth gain:0.35343108171056015 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
+  "[ (15/8 → 2/1) ⇝ 9/4 | note:A5 s:sawtooth gain:0.35343108171056004 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
+  "[ (15/8 → 2/1) ⇝ 9/4 | note:C#5 s:sawtooth gain:0.35343108171056004 attack:0.001 decay:0.2 sustain:0 hcutoff:5796.978025372246 cutoff:4000 ]",
   "[ (15/8 → 2/1) ⇝ 19/8 | note:F#3 s:square gain:0.7 attack:0.01 decay:0.1 sustain:0 cutoff:2151.2782118349805 ]",
   "[ (15/8 → 2/1) ⇝ 19/8 | note:A3 s:square gain:0.7 attack:0.01 decay:0.1 sustain:0 cutoff:2151.2782118349805 ]",
   "[ 13/8 ⇜ (23/12 → 2/1) | note:F#5 s:sawtooth gain:0.3479759264430665 attack:0.001 decay:0.2 sustain:0 hcutoff:5822.02388217981 cutoff:4000 ]",

From ac41426a20cf646a0d0f915b993330e54bbddd80 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Tue, 5 Dec 2023 23:09:34 +0100
Subject: [PATCH 58/73] improve slashing + base href behavior + prefix sidebar
 links & mdx links with base + add trailing slashes

---
 website/astro.config.mjs                           | 14 +++++++++-----
 .../src/components/LeftSidebar/LeftSidebar.astro   |  3 ++-
 .../components/RightSidebar/TableOfContents.tsx    |  2 +-
 website/src/repl/Header.jsx                        |  4 +++-
 4 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index f8fceaf7..84a89b33 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -13,6 +13,7 @@ import AstroPWA from '@vite-pwa/astro';
 
 const site = `https://strudel.cc/`; // root url without a path
 const base = '/'; // base path of the strudel site
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
 
 // this rehype plugin converts relative anchor links to absolute ones
 // it wokrs by prepending the absolute page path to anchor links
@@ -24,13 +25,16 @@ function absoluteAnchors() {
     const chunks = file.history[0].split('/src/pages/'); // file.history[0] is the file path
     const path = chunks[chunks.length - 1].slice(0, -4); // only path inside src/pages, without .mdx
     return rehypeUrls((url) => {
-      if (!url.href.startsWith('#')) {
-        return;
+      if (url.href.startsWith('/')) {
+        const hrefWithTrailingSlash = url.href.endsWith('/') ? url.href : url.href + '/';
+        return baseNoTrailing + hrefWithTrailingSlash;
+      }
+      if (url.href.startsWith('#')) {
+        const absoluteUrl = `${baseNoTrailing}/${path}/${url.href}`;
+        return absoluteUrl;
       }
-      const baseWithSlash = base.endsWith('/') ? base : base + '/';
-      const absoluteUrl = baseWithSlash + path + url.href;
       // console.log(url.href + ' -> ', absoluteUrl);
-      return absoluteUrl;
+      return;
     })(tree);
   };
 }
diff --git a/website/src/components/LeftSidebar/LeftSidebar.astro b/website/src/components/LeftSidebar/LeftSidebar.astro
index b3f69a7e..8b823db6 100644
--- a/website/src/components/LeftSidebar/LeftSidebar.astro
+++ b/website/src/components/LeftSidebar/LeftSidebar.astro
@@ -9,6 +9,7 @@ type Props = {
 const { currentPage } = Astro.props as Props;
 const { BASE_URL } = import.meta.env;
 let currentPageMatch = currentPage.slice(BASE_URL.length, currentPage.endsWith('/') ? -1 : undefined);
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
 const langCode = getLanguageFromURL(currentPage) || 'en';
 const sidebar = SIDEBAR[langCode];
@@ -23,7 +24,7 @@ const sidebar = SIDEBAR[langCode];
             <h2>{header}</h2>
             <ul>
               {children.map((child) => {
-                const url = Astro.site?.pathname + child.link;
+                const url = `${baseNoTrailing}/${child.link}${child.link.endsWith('/') ? '' : '/'}`;
                 return (
                   <li class="">
                     <a
diff --git a/website/src/components/RightSidebar/TableOfContents.tsx b/website/src/components/RightSidebar/TableOfContents.tsx
index 7ad31ceb..1897d43e 100644
--- a/website/src/components/RightSidebar/TableOfContents.tsx
+++ b/website/src/components/RightSidebar/TableOfContents.tsx
@@ -73,7 +73,7 @@ const TableOfContents: FC<{ headings: MarkdownHeading[]; currentPage: string }>
           .map((heading, i) => (
             <li className={`w-full`} key={i}>
               <a
-                href={`${currentPage}#${heading.slug}`}
+                href={`${currentPage}/#${heading.slug}`}
                 onClick={onLinkClick}
                 className={`py-0.5 block cursor-pointer w-full border-l-4 border-lineHighlight hover:bg-lineHighlight ${
                   ['pl-4', 'pl-9', 'pl-12'][heading.depth - minDepth]
diff --git a/website/src/repl/Header.jsx b/website/src/repl/Header.jsx
index c78e3327..5e991f8a 100644
--- a/website/src/repl/Header.jsx
+++ b/website/src/repl/Header.jsx
@@ -9,6 +9,8 @@ import React, { useContext } from 'react';
 import { useSettings, setIsZen } from '../settings.mjs';
 // import { ReplContext } from './Repl';
 import './Repl.css';
+const { BASE_URL } = import.meta.env;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
 export function Header({ context }) {
   const {
@@ -123,7 +125,7 @@ export function Header({ context }) {
           {!isEmbedded && (
             <a
               title="learn"
-              href="./workshop/getting-started"
+              href={`${baseNoTrailing}/workshop/getting-started/`}
               className={cx('hover:opacity-50 flex items-center space-x-1', !isEmbedded ? 'p-2' : 'px-2')}
             >
               <AcademicCapIcon className="w-6 h-6" />

From 3e5664a877ed0239d11a44844f201ce133c21351 Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Sun, 3 Dec 2023 16:47:40 -0500
Subject: [PATCH 59/73] Add quick fix for non root bases

---
 website/astro.config.mjs                   |  2 +-
 website/src/components/HeadCommon.astro    |  9 +++++----
 website/src/components/Header/Header.astro |  6 +++++-
 website/src/pages/swatch/index.astro       |  9 ++++++---
 website/src/repl/Footer.jsx                |  6 +++++-
 website/src/repl/Header.jsx                |  4 ++++
 website/src/repl/prebake.mjs               | 12 ++++++++----
 7 files changed, 34 insertions(+), 14 deletions(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 84a89b33..a192c4ab 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -122,7 +122,7 @@ export default defineConfig({
     }),
   ],
   site,
-  base,
+  base: base,
   vite: {
     ssr: {
       // Example: Force a broken package to skip SSR processing, if needed
diff --git a/website/src/components/HeadCommon.astro b/website/src/components/HeadCommon.astro
index 2aa6acfe..724c4b07 100644
--- a/website/src/components/HeadCommon.astro
+++ b/website/src/components/HeadCommon.astro
@@ -4,6 +4,7 @@ import '../styles/index.css';
 
 const { BASE_URL } = import.meta.env;
 const base = BASE_URL;
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
 ---
 
 <!-- Global Metadata -->
@@ -11,20 +12,20 @@ const base = BASE_URL;
 <meta name="viewport" content="width=device-width" />
 <meta name="generator" content={Astro.generator} />
 
-<link rel="icon" type="image/svg+xml" href="favicon.ico" />
+<link rel="icon" type="image/svg+xml" href={`${baseNoTrailing}/favicon.ico`} />
 
 <meta
   name="description"
   content="Strudel is a music live coding environment for the browser, porting the TidalCycles pattern language to JavaScript."
 />
-<link rel="icon" href="/favicon.ico" />
-<link rel="apple-touch-icon" href="/icons/apple-icon-180.png" sizes="180x180" />
+<link rel="icon" href={`${baseNoTrailing}/favicon.ico`} />
+<link rel="apple-touch-icon" href={`${baseNoTrailing}/icons/apple-icon-180.png`} sizes="180x180" />
 <meta name="theme-color" content="#222222" />
 
 <base href={base} />
 
 <!-- Scrollable a11y code helper -->
-<script src="./make-scrollable-code-focusable.js" is:inline></script>
+<script src{`${baseNoTrailing}/make-scrollable-code-focusable.js`} is:inline></script>
 
 <script src="/src/pwa.ts"></script>
 <!-- this does not work for some reason: -->
diff --git a/website/src/components/Header/Header.astro b/website/src/components/Header/Header.astro
index 4cee4282..b429fdb1 100644
--- a/website/src/components/Header/Header.astro
+++ b/website/src/components/Header/Header.astro
@@ -16,6 +16,10 @@ const { currentPage } = Astro.props as Props;
 // const lang = getLanguageFromURL(currentPage);
 const langCode = 'en'; // getLanguageFromURL(currentPage);
 const sidebar = SIDEBAR[langCode];
+
+const { BASE_URL } = import.meta.env;
+const base = BASE_URL;
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
 ---
 
 <nav
@@ -37,7 +41,7 @@ const sidebar = SIDEBAR[langCode];
   <div class="search-item h-10">
     <Search client:idle />
   </div>
-  <a href="./" class="hidden md:flex cursor-pointer items-center space-x-1"
+  <a href={`${baseNoTrailing}/`} class="hidden md:flex cursor-pointer items-center space-x-1"
     ><CommandLineIcon className="w-5 h-5" /><span>go to REPL</span>
   </a>
   <div class="md:hidden">
diff --git a/website/src/pages/swatch/index.astro b/website/src/pages/swatch/index.astro
index e10ebcb7..bbc9df48 100644
--- a/website/src/pages/swatch/index.astro
+++ b/website/src/pages/swatch/index.astro
@@ -5,7 +5,10 @@ import { Content } from '../../../../my-patterns/README.md';
 import HeadCommon from '../../components/HeadCommon.astro';
 
 const myPatterns = await getMyPatterns();
----
+
+const { BASE_URL } = import.meta.env;
+const base = BASE_URL;
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;---
 
 <head>
   <HeadCommon />
@@ -23,12 +26,12 @@ const myPatterns = await getMyPatterns();
       Object.entries(myPatterns).map(([name, tune]) => (
         <a
           class="rounded-md bg-slate-900 hover:bg-slate-700 cursor-pointer relative"
-          href={`./#${btoa(tune as string)}`}
+          href={`${baseNoTrailing}/#${btoa(tune as string)}`}
         >
           <div class="absolute w-full h-full flex justify-center items-center">
             <span class="bg-slate-800 p-2 rounded-md text-white">{name}</span>
           </div>
-          <img src={`./swatch/${name}.png`} />
+          <img src={`${baseNoTrailing}/swatch/${name}.png`} />
         </a>
       ))
     }
diff --git a/website/src/repl/Footer.jsx b/website/src/repl/Footer.jsx
index 35625093..dee13f5b 100644
--- a/website/src/repl/Footer.jsx
+++ b/website/src/repl/Footer.jsx
@@ -13,6 +13,10 @@ import { FilesTab } from './FilesTab';
 
 const TAURI = window.__TAURI__;
 
+const { BASE_URL } = import.meta.env;
+const base = BASE_URL;
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+
 export function Footer({ context }) {
   const footerContent = useRef();
   const [log, setLog] = useState([]);
@@ -154,7 +158,7 @@ function WelcomeTab() {
       </p>
       <p>
         To learn more about what this all means, check out the{' '}
-        <a href="./workshop/getting-started" target="_blank">
+        <a href={`${baseNoTrailing}/workshop/getting-started`} target="_blank">
           interactive tutorial
         </a>
         . Also feel free to join the{' '}
diff --git a/website/src/repl/Header.jsx b/website/src/repl/Header.jsx
index 5e991f8a..49ebe84f 100644
--- a/website/src/repl/Header.jsx
+++ b/website/src/repl/Header.jsx
@@ -12,6 +12,10 @@ import './Repl.css';
 const { BASE_URL } = import.meta.env;
 const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
+const { BASE_URL } = import.meta.env;
+const base = BASE_URL;
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+
 export function Header({ context }) {
   const {
     embedded,
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index 28678c9d..c5a04859 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -3,6 +3,10 @@ import { registerSynthSounds, registerZZFXSounds, samples } from '@strudel.cycle
 import './piano.mjs';
 import './files.mjs';
 
+const { BASE_URL } = import.meta.env;
+const base = BASE_URL;
+const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+
 export async function prebake() {
   // https://archive.org/details/SalamanderGrandPianoV3
   // License: CC-by http://creativecommons.org/licenses/by/3.0/ Author: Alexander Holm
@@ -14,16 +18,16 @@ export async function prebake() {
     // => getting "window is not defined", as soon as "@strudel.cycles/soundfonts" is imported statically
     // seems to be a problem with soundfont2
     import('@strudel.cycles/soundfonts').then(({ registerSoundfonts }) => registerSoundfonts()),
-    samples(`./piano.json`, `./piano/`, { prebake: true }),
+    samples(`${baseNoTrailing}/piano.json`, `./piano/`, { prebake: true }),
     // https://github.com/sgossner/VCSL/
     // https://api.github.com/repositories/126427031/contents/
     // LICENSE: CC0 general-purpose
-    samples(`./vcsl.json`, 'github:sgossner/VCSL/master/', { prebake: true }),
-    samples(`./tidal-drum-machines.json`, 'github:ritchse/tidal-drum-machines/main/machines/', {
+    samples(`${baseNoTrailing}/vcsl.json`, 'github:sgossner/VCSL/master/', { prebake: true }),
+    samples(`${baseNoTrailing}/tidal-drum-machines.json`, 'github:ritchse/tidal-drum-machines/main/machines/', {
       prebake: true,
       tag: 'drum-machines',
     }),
-    samples(`./EmuSP12.json`, `./EmuSP12/`, { prebake: true, tag: 'drum-machines' }),
+    samples(`${baseNoTrailing}/EmuSP12.json`, `${baseNoTrailing}/EmuSP12/`, { prebake: true, tag: 'drum-machines' }),
     samples(
       {
         casio: ['casio/high.wav', 'casio/low.wav', 'casio/noise.wav'],

From 2c43fb25123c5e0978bcdd571dd5835515c0d9dd Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Sun, 3 Dec 2023 16:50:28 -0500
Subject: [PATCH 60/73] Remove unnecessary change

---
 website/astro.config.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index a192c4ab..84a89b33 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -122,7 +122,7 @@ export default defineConfig({
     }),
   ],
   site,
-  base: base,
+  base,
   vite: {
     ssr: {
       // Example: Force a broken package to skip SSR processing, if needed

From 018a45e2d45c278b0151e0b5c58c29ed2b20740c Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Tue, 5 Dec 2023 20:52:21 -0500
Subject: [PATCH 61/73] Rework rehype plugin and clean up changes

---
 website/astro.config.mjs                      | 37 ++++++++++++-------
 website/src/components/HeadCommon.astro       |  5 +--
 website/src/components/Header/Header.astro    |  5 +--
 website/src/pages/swatch/index.astro          |  6 +--
 .../src/pages/workshop/getting-started.mdx    |  4 +-
 website/src/repl/Footer.jsx                   |  5 +--
 website/src/repl/Header.jsx                   |  4 --
 website/src/repl/prebake.mjs                  |  3 +-
 8 files changed, 36 insertions(+), 33 deletions(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 84a89b33..3a18ce54 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -15,25 +15,34 @@ const site = `https://strudel.cc/`; // root url without a path
 const base = '/'; // base path of the strudel site
 const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
 
-// this rehype plugin converts relative anchor links to absolute ones
-// it wokrs by prepending the absolute page path to anchor links
-// example: #gain -> /learn/effects/#gain
+// this rehype plugin fixes relative links
+// it works by prepending the base + page path to anchor links
+// and by prepending the base path to all other relative links
 // this is necessary when using a base href like <base href={base} />
-// in this setup, relative anchor links will always link to base, instead of the current page
-function absoluteAnchors() {
+// examples with base as "mybase":
+//   #gain -> /mybase/learn/effects/#gain
+//   /some/page -> /mybase/some/page
+function relativeURLFix() {
   return (tree, file) => {
     const chunks = file.history[0].split('/src/pages/'); // file.history[0] is the file path
     const path = chunks[chunks.length - 1].slice(0, -4); // only path inside src/pages, without .mdx
     return rehypeUrls((url) => {
-      if (url.href.startsWith('/')) {
-        const hrefWithTrailingSlash = url.href.endsWith('/') ? url.href : url.href + '/';
-        return baseNoTrailing + hrefWithTrailingSlash;
+      // NOTE: the base argument to the URL constructor is ignored if the input is already
+      //       absolute and used if not, which facilitates the comparison below
+      // true if url is relative
+      if (new URL(site).origin === new URL(url.href, site).origin) {
+        let newHref = baseNoTrailing;
+        if (url.href.startsWith('#')) {
+          // special case: a relative anchor link to the current page
+          newHref += `/${path}/${url.href}`;
+        } else {
+          // any other relative link
+          // NOTE: this does strip off serialized queries and fragments
+          newHref += (url.pathname.endsWith('/') ? url.pathname : url.pathname + '/');
+        }
+        // console.log(url.href + ' -> ', newHref);
+        return newHref;
       }
-      if (url.href.startsWith('#')) {
-        const absoluteUrl = `${baseNoTrailing}/${path}/${url.href}`;
-        return absoluteUrl;
-      }
-      // console.log(url.href + ' -> ', absoluteUrl);
       return;
     })(tree);
   };
@@ -44,7 +53,7 @@ const options = {
     remarkToc,
     // E.g. `remark-frontmatter`
   ],
-  rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: 'append' }], absoluteAnchors],
+  rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: 'append' }], relativeURLFix],
 };
 
 // https://astro.build/config
diff --git a/website/src/components/HeadCommon.astro b/website/src/components/HeadCommon.astro
index 724c4b07..ab18500f 100644
--- a/website/src/components/HeadCommon.astro
+++ b/website/src/components/HeadCommon.astro
@@ -3,8 +3,7 @@ import { pwaInfo } from 'virtual:pwa-info';
 import '../styles/index.css';
 
 const { BASE_URL } = import.meta.env;
-const base = BASE_URL;
-const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 ---
 
 <!-- Global Metadata -->
@@ -22,7 +21,7 @@ const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
 <link rel="apple-touch-icon" href={`${baseNoTrailing}/icons/apple-icon-180.png`} sizes="180x180" />
 <meta name="theme-color" content="#222222" />
 
-<base href={base} />
+<base href={BASE_URL} />
 
 <!-- Scrollable a11y code helper -->
 <script src{`${baseNoTrailing}/make-scrollable-code-focusable.js`} is:inline></script>
diff --git a/website/src/components/Header/Header.astro b/website/src/components/Header/Header.astro
index b429fdb1..6447d9d6 100644
--- a/website/src/components/Header/Header.astro
+++ b/website/src/components/Header/Header.astro
@@ -18,8 +18,7 @@ const langCode = 'en'; // getLanguageFromURL(currentPage);
 const sidebar = SIDEBAR[langCode];
 
 const { BASE_URL } = import.meta.env;
-const base = BASE_URL;
-const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 ---
 
 <nav
@@ -27,7 +26,7 @@ const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
   title="Top Navigation"
 >
   <div class="flex overflow-visible items-center grow" style="overflow:visible">
-    <a href="/" class="flex items-center text-2xl space-x-2">
+    <a href={`${baseNoTrailing}/`} class="flex items-center text-2xl space-x-2">
       <h1 class="font-bold flex space-x-2 items-baseline text-xl">
         <span>🌀</span>
         <div class="flex space-x-1 items-baseline">
diff --git a/website/src/pages/swatch/index.astro b/website/src/pages/swatch/index.astro
index bbc9df48..36088db5 100644
--- a/website/src/pages/swatch/index.astro
+++ b/website/src/pages/swatch/index.astro
@@ -7,8 +7,8 @@ import HeadCommon from '../../components/HeadCommon.astro';
 const myPatterns = await getMyPatterns();
 
 const { BASE_URL } = import.meta.env;
-const base = BASE_URL;
-const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;---
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
+---
 
 <head>
   <HeadCommon />
@@ -31,7 +31,7 @@ const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;---
           <div class="absolute w-full h-full flex justify-center items-center">
             <span class="bg-slate-800 p-2 rounded-md text-white">{name}</span>
           </div>
-          <img src={`${baseNoTrailing}/swatch/${name}.png`} />
+          <img src={`${baseNoTrailing}/swatch/${name}.png/`} />
         </a>
       ))
     }
diff --git a/website/src/pages/workshop/getting-started.mdx b/website/src/pages/workshop/getting-started.mdx
index 410c6da5..4259623c 100644
--- a/website/src/pages/workshop/getting-started.mdx
+++ b/website/src/pages/workshop/getting-started.mdx
@@ -7,7 +7,9 @@ import { MiniRepl } from '../../docs/MiniRepl';
 
 # Welcome
 
-<img src="/icons/strudel_icon.png" className="w-32 animate-pulse md:float-right ml-8" />
+<div className="w-32 animate-pulse md:float-right ml-8">
+![Strudel Icon](/icons/strudel_icon.png)
+</div>
 
 Welcome to the Strudel documentation pages!
 You've come to the right place if you want to learn how to make music with code.
diff --git a/website/src/repl/Footer.jsx b/website/src/repl/Footer.jsx
index dee13f5b..cbf0b63b 100644
--- a/website/src/repl/Footer.jsx
+++ b/website/src/repl/Footer.jsx
@@ -14,8 +14,7 @@ import { FilesTab } from './FilesTab';
 const TAURI = window.__TAURI__;
 
 const { BASE_URL } = import.meta.env;
-const base = BASE_URL;
-const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
 export function Footer({ context }) {
   const footerContent = useRef();
@@ -158,7 +157,7 @@ function WelcomeTab() {
       </p>
       <p>
         To learn more about what this all means, check out the{' '}
-        <a href={`${baseNoTrailing}/workshop/getting-started`} target="_blank">
+        <a href={`${baseNoTrailing}/workshop/getting-started/`} target="_blank">
           interactive tutorial
         </a>
         . Also feel free to join the{' '}
diff --git a/website/src/repl/Header.jsx b/website/src/repl/Header.jsx
index 49ebe84f..5e991f8a 100644
--- a/website/src/repl/Header.jsx
+++ b/website/src/repl/Header.jsx
@@ -12,10 +12,6 @@ import './Repl.css';
 const { BASE_URL } = import.meta.env;
 const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
-const { BASE_URL } = import.meta.env;
-const base = BASE_URL;
-const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
-
 export function Header({ context }) {
   const {
     embedded,
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index c5a04859..74ca0053 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -4,8 +4,7 @@ import './piano.mjs';
 import './files.mjs';
 
 const { BASE_URL } = import.meta.env;
-const base = BASE_URL;
-const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
 export async function prebake() {
   // https://archive.org/details/SalamanderGrandPianoV3

From e1a8bd333d9f955a41d0e65da28ef6e45077e9de Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 03:41:54 -0500
Subject: [PATCH 62/73] Fix comment

---
 website/astro.config.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 3a18ce54..8310fa0c 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -29,7 +29,7 @@ function relativeURLFix() {
     return rehypeUrls((url) => {
       // NOTE: the base argument to the URL constructor is ignored if the input is already
       //       absolute and used if not, which facilitates the comparison below
-      // true if url is relative
+      // true if origins are same, and relative urls are considered as origin equal to site var value
       if (new URL(site).origin === new URL(url.href, site).origin) {
         let newHref = baseNoTrailing;
         if (url.href.startsWith('#')) {

From 5332f99a5a58ee9b923f906902871ce7e14d19d7 Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 03:43:38 -0500
Subject: [PATCH 63/73] Fix another comment

---
 website/astro.config.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 8310fa0c..c91ee0bc 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -36,7 +36,7 @@ function relativeURLFix() {
           // special case: a relative anchor link to the current page
           newHref += `/${path}/${url.href}`;
         } else {
-          // any other relative link
+          // any other same origin link
           // NOTE: this does strip off serialized queries and fragments
           newHref += (url.pathname.endsWith('/') ? url.pathname : url.pathname + '/');
         }

From 8e9b607fa1d3055b083c2e25abb3e29f267bd0bb Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 03:57:30 -0500
Subject: [PATCH 64/73] Revert to simpler link parsing and run formatter

---
 website/astro.config.mjs                      | 31 +++++++++----------
 .../src/pages/workshop/getting-started.mdx    |  4 +--
 2 files changed, 15 insertions(+), 20 deletions(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index c91ee0bc..89bffbc9 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -17,7 +17,7 @@ const baseNoTrailing = base.endsWith('/') ? base.slice(0, -1) : base;
 
 // this rehype plugin fixes relative links
 // it works by prepending the base + page path to anchor links
-// and by prepending the base path to all other relative links
+// and by prepending the base path to other relative links starting with /
 // this is necessary when using a base href like <base href={base} />
 // examples with base as "mybase":
 //   #gain -> /mybase/learn/effects/#gain
@@ -27,23 +27,20 @@ function relativeURLFix() {
     const chunks = file.history[0].split('/src/pages/'); // file.history[0] is the file path
     const path = chunks[chunks.length - 1].slice(0, -4); // only path inside src/pages, without .mdx
     return rehypeUrls((url) => {
-      // NOTE: the base argument to the URL constructor is ignored if the input is already
-      //       absolute and used if not, which facilitates the comparison below
-      // true if origins are same, and relative urls are considered as origin equal to site var value
-      if (new URL(site).origin === new URL(url.href, site).origin) {
-        let newHref = baseNoTrailing;
-        if (url.href.startsWith('#')) {
-          // special case: a relative anchor link to the current page
-          newHref += `/${path}/${url.href}`;
-        } else {
-          // any other same origin link
-          // NOTE: this does strip off serialized queries and fragments
-          newHref += (url.pathname.endsWith('/') ? url.pathname : url.pathname + '/');
-        }
-        // console.log(url.href + ' -> ', newHref);
-        return newHref;
+      let newHref = baseNoTrailing;
+      if (url.href.startsWith('#')) {
+        // special case: a relative anchor link to the current page
+        newHref += `/${path}/${url.href}`;
+      } else if (url.href.startsWith('/')) {
+        // any other relative url starting with /
+        // NOTE: this does strip off serialized queries and fragments
+        newHref += url.pathname.endsWith('/') ? url.pathname : url.pathname + '/';
+      } else {
+        // leave this URL alone
+        return;
       }
-      return;
+      // console.log(url.href + ' -> ', newHref);
+      return newHref;
     })(tree);
   };
 }
diff --git a/website/src/pages/workshop/getting-started.mdx b/website/src/pages/workshop/getting-started.mdx
index 4259623c..3d37a5cf 100644
--- a/website/src/pages/workshop/getting-started.mdx
+++ b/website/src/pages/workshop/getting-started.mdx
@@ -7,9 +7,7 @@ import { MiniRepl } from '../../docs/MiniRepl';
 
 # Welcome
 
-<div className="w-32 animate-pulse md:float-right ml-8">
-![Strudel Icon](/icons/strudel_icon.png)
-</div>
+<div className="w-32 animate-pulse md:float-right ml-8">![Strudel Icon](/icons/strudel_icon.png)</div>
 
 Welcome to the Strudel documentation pages!
 You've come to the right place if you want to learn how to make music with code.

From 6b31160bbd54c8f16648538485b16126af3c2952 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 6 Dec 2023 21:34:39 +0100
Subject: [PATCH 65/73] fix: astro warnings

---
 website/src/pages/img/example-[name].png.js | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/website/src/pages/img/example-[name].png.js b/website/src/pages/img/example-[name].png.js
index 22938e38..b058a017 100644
--- a/website/src/pages/img/example-[name].png.js
+++ b/website/src/pages/img/example-[name].png.js
@@ -4,7 +4,7 @@ import { evaluate } from '@strudel.cycles/transpiler';
 import '../../../../test/runtime.mjs';
 import * as tunes from '../../repl/tunes.mjs';
 
-export async function get({ params, request }) {
+export async function GET({ params, request }) {
   const { name } = params;
   const tune = tunes[name];
   const { pattern } = await evaluate(tune);
@@ -13,10 +13,7 @@ export async function get({ params, request }) {
   const ctx = canvas.getContext('2d');
   pianoroll({ time: 4, haps, ctx, playhead: 1, fold: 1, background: 'transparent', playheadColor: 'transparent' });
   const buffer = canvas.toBuffer('image/png');
-  return {
-    body: buffer,
-    encoding: 'binary',
-  };
+  return new Response(buffer);
 }
 export function getStaticPaths() {
   return Object.keys(tunes).map((name) => ({

From 2ddd2d1f392829ad5fd9817b364daeafde6e50d7 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 6 Dec 2023 21:46:13 +0100
Subject: [PATCH 66/73] fix: search links with basehref

---
 website/src/components/Header/Search.tsx | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/website/src/components/Header/Search.tsx b/website/src/components/Header/Search.tsx
index d3a935f5..c982d80b 100644
--- a/website/src/components/Header/Search.tsx
+++ b/website/src/components/Header/Search.tsx
@@ -6,6 +6,8 @@ import './Search.css';
 
 import { createPortal } from 'react-dom';
 import * as docSearchReact from '@docsearch/react';
+const { BASE_URL } = import.meta.env;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 
 /** FIXME: This is still kinda nasty, but DocSearch is not ESM ready. */
 const DocSearchModal = docSearchReact.DocSearchModal || (docSearchReact as any).default.DocSearchModal;
@@ -89,9 +91,13 @@ export default function Search() {
                 const a = document.createElement('a');
                 a.href = item.url;
                 const hash = a.hash === '#overview' ? '' : a.hash;
+                let pathname = a.pathname;
+                pathname = pathname.startsWith('/') ? pathname.slice(1) : pathname;
+                pathname = pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
+                const url = `${baseNoTrailing}/${pathname}/${hash}`;
                 return {
                   ...item,
-                  url: `${a.pathname}${hash}`,
+                  url,
                 };
               });
             }}

From 1b372a9a7bad8698b14ceb9cb559b57e5ae176a4 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 6 Dec 2023 22:16:43 +0100
Subject: [PATCH 67/73] fix: missing hash for links starting with /

---
 website/astro.config.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 89bffbc9..b6617704 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -35,6 +35,7 @@ function relativeURLFix() {
         // any other relative url starting with /
         // NOTE: this does strip off serialized queries and fragments
         newHref += url.pathname.endsWith('/') ? url.pathname : url.pathname + '/';
+        newHref += url.hash || '';
       } else {
         // leave this URL alone
         return;

From cc4d38b4a5431b1add4044b28c6d2c140d45fd1c Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 6 Dec 2023 22:28:14 +0100
Subject: [PATCH 68/73] fix: swatch png src

---
 website/src/pages/swatch/index.astro | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/src/pages/swatch/index.astro b/website/src/pages/swatch/index.astro
index 36088db5..65484856 100644
--- a/website/src/pages/swatch/index.astro
+++ b/website/src/pages/swatch/index.astro
@@ -31,7 +31,7 @@ const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL
           <div class="absolute w-full h-full flex justify-center items-center">
             <span class="bg-slate-800 p-2 rounded-md text-white">{name}</span>
           </div>
-          <img src={`${baseNoTrailing}/swatch/${name}.png/`} />
+          <img src={`${baseNoTrailing}/swatch/${name}.png`} />
         </a>
       ))
     }

From 93c5eeb99e809392dc54edfe1c738663bf5fbac3 Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 16:44:50 -0500
Subject: [PATCH 69/73] Fix examples page and de workshop img

---
 website/src/pages/de/workshop/getting-started.mdx | 2 +-
 website/src/pages/examples/index.astro            | 7 +++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/website/src/pages/de/workshop/getting-started.mdx b/website/src/pages/de/workshop/getting-started.mdx
index 5ecc60f2..823d77dc 100644
--- a/website/src/pages/de/workshop/getting-started.mdx
+++ b/website/src/pages/de/workshop/getting-started.mdx
@@ -7,7 +7,7 @@ import { MiniRepl } from '../../../docs/MiniRepl';
 
 # Willkommen
 
-<img src="/icons/strudel_icon.png" className="w-32 animate-pulse md:float-right ml-8" />
+<div className="w-32 animate-pulse md:float-right ml-8">![Strudel Icon](/icons/strudel_icon.png)</div>
 
 Willkommen zum Strudel Workshop!
 Du hast den richtigen Ort gefunden wenn du lernen möchtest wie man mit Code Musik macht.
diff --git a/website/src/pages/examples/index.astro b/website/src/pages/examples/index.astro
index c973f2eb..d4440689 100644
--- a/website/src/pages/examples/index.astro
+++ b/website/src/pages/examples/index.astro
@@ -3,6 +3,9 @@ import * as tunes from '../../../src/repl/tunes.mjs';
 import HeadCommon from '../../components/HeadCommon.astro';
 
 import { getMetadata } from '../metadata_parser';
+
+const { BASE_URL } = import.meta.env;
+const baseNoTrailing = BASE_URL.endsWith('/') ? BASE_URL.slice(0, -1) : BASE_URL;
 ---
 
 <head>
@@ -12,11 +15,11 @@ import { getMetadata } from '../metadata_parser';
   <div class="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-6 gap-2 p-2 select-none">
     {
       Object.entries(tunes).map(([name, tune]) => (
-        <a class="rounded-md bg-slate-900 hover:bg-slate-700 cursor-pointer relative" href={`./#${btoa(tune)}`}>
+        <a class="rounded-md bg-slate-900 hover:bg-slate-700 cursor-pointer relative" href={`${baseNoTrailing}/#${btoa(tune)}`}>
           <div class="absolute w-full h-full flex justify-center items-center">
             <span class="bg-slate-800 p-2 rounded-md text-white">{getMetadata(tune)['title'] || name}</span>
           </div>
-          <img src={`./img/example-${name}.png`} />
+          <img src={`${baseNoTrailing}/img/example-${name}.png`} />
         </a>
       ))
     }

From a32ed0274543de04efa9423131f18a2e294ce8c2 Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 16:57:43 -0500
Subject: [PATCH 70/73] Fix piano and two doc images

---
 website/src/pages/learn/pwa.mdx | 4 ++--
 website/src/repl/prebake.mjs    | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/website/src/pages/learn/pwa.mdx b/website/src/pages/learn/pwa.mdx
index a283112d..ba4b6b83 100644
--- a/website/src/pages/learn/pwa.mdx
+++ b/website/src/pages/learn/pwa.mdx
@@ -49,7 +49,7 @@ A standalone app has its own desktop / homescreen icon and launches in a separat
 without the browser ui.
 
 <figure>
-  <img src="./pwa/strudel-macos.png" alt="Strudel on MacOS" />
+  ![Strudel on MacOS](/pwa/strudel-macos.png)
   <figcaption>Strudel on MacOS</figcaption>
 </figure>
 
@@ -67,7 +67,7 @@ Without a chromium based browser, you can use [nativefier](https://github.com/na
 2. run `npx nativefier strudel.cc`
 
 <figure>
-  <img src="./pwa/strudel-linux.png" alt="Strudel on Linux" />
+  ![Strudel on Linux](/pwa/strudel-linux.png)
   <figcaption>Strudel on Linux</figcaption>
 </figure>
 
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index 74ca0053..0670d57d 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -17,7 +17,7 @@ export async function prebake() {
     // => getting "window is not defined", as soon as "@strudel.cycles/soundfonts" is imported statically
     // seems to be a problem with soundfont2
     import('@strudel.cycles/soundfonts').then(({ registerSoundfonts }) => registerSoundfonts()),
-    samples(`${baseNoTrailing}/piano.json`, `./piano/`, { prebake: true }),
+    samples(`${baseNoTrailing}/piano.json`, `${baseNoTrailing}/piano/`, { prebake: true }),
     // https://github.com/sgossner/VCSL/
     // https://api.github.com/repositories/126427031/contents/
     // LICENSE: CC0 general-purpose

From 60cee7fd2f90dacb9cb3d802bd86b26918b7f67c Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 17:37:49 -0500
Subject: [PATCH 71/73] Fix to not add trailing slash to URL with filename

---
 website/astro.config.mjs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index b6617704..6ef307ef 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -33,8 +33,11 @@ function relativeURLFix() {
         newHref += `/${path}/${url.href}`;
       } else if (url.href.startsWith('/')) {
         // any other relative url starting with /
-        // NOTE: this does strip off serialized queries and fragments
-        newHref += url.pathname.endsWith('/') ? url.pathname : url.pathname + '/';
+        newHref += url.pathname;
+        if (url.pathname.indexOf('.') == -1) {
+          // append trailing slash to resource only if there is no file extension
+          newHref += url.pathname.endsWith('/') ? '' : '/';
+        }
         newHref += url.hash || '';
       } else {
         // leave this URL alone

From 78b2b5ccc3380a5176faa8651eb2312157af6f60 Mon Sep 17 00:00:00 2001
From: Priere <44214460+shiyouganai@users.noreply.github.com>
Date: Wed, 6 Dec 2023 17:54:29 -0500
Subject: [PATCH 72/73] Don't trim serialized query part of URL

---
 website/astro.config.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 6ef307ef..c5ca3317 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -38,6 +38,7 @@ function relativeURLFix() {
           // append trailing slash to resource only if there is no file extension
           newHref += url.pathname.endsWith('/') ? '' : '/';
         }
+        newHref += url.search || '';
         newHref += url.hash || '';
       } else {
         // leave this URL alone

From 20f3ddd277cd44642a9a201260d89b41fb32b166 Mon Sep 17 00:00:00 2001
From: Bernhard Wagner <gitcommit@nosuch.biz>
Date: Thu, 7 Dec 2023 10:19:26 +0100
Subject: [PATCH 73/73] CHANGES: pnpm 8.1.3 to 8.11.0

---
 .github/workflows/deploy.yml | 2 +-
 .github/workflows/test.yml   | 2 +-
 CONTRIBUTING.md              | 3 +--
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 2279b20f..256a1772 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
         with:
-          version: 8.3.1
+          version: 8.11.0
       - uses: actions/setup-node@v3
         with:
           node-version: 18
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index f53600e9..0f6c1181 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -13,7 +13,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
         with:
-          version: 8.3.1
+          version: 8.11.0
       - uses: actions/setup-node@v3
         with:
           node-version: ${{ matrix.node-version }}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1826b12a..556df3fc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -66,8 +66,7 @@ To get the project up and running for development, make sure you have installed:
 
 - [git](https://git-scm.com/)
 - [node](https://nodejs.org/en/) >= 18
-- [pnpm](https://pnpm.io/) (`curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=8.3.1 sh -`)
-  tests failed to work correctly with newer pnpm versions, so we pin 8.3.1 for now. (see issue #833)
+- [pnpm](https://pnpm.io/) (`curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=8.11.0 sh -`)
 
 then, do the following: