From 6da98a5f318784752b5badffcd0458be9a9073d9 Mon Sep 17 00:00:00 2001
From: Enelg52 <yann.grossenbacher@bluewin.ch>
Date: Tue, 23 Jan 2024 16:47:46 +0100
Subject: [PATCH 01/27] fix midi issue on firefox and quote error

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

diff --git a/packages/midi/midi.mjs b/packages/midi/midi.mjs
index f40a5049..7d253114 100644
--- a/packages/midi/midi.mjs
+++ b/packages/midi/midi.mjs
@@ -167,10 +167,16 @@ let listeners = {};
 const refs = {};
 
 export async function midin(input) {
+  if (isPattern(input)) {
+    throw new Error(
+      `.midi does not accept Pattern input. Make sure to pass device name with single quotes. Example: .midi('${
+        WebMidi.outputs?.[0]?.name || 'IAC Driver Bus 1'
+      }')`,
+    );
+  }
   const initial = await enableWebMidi(); // only returns on first init
   const device = getDevice(input, WebMidi.inputs);
-
-  if (initial) {
+  if (initial || WebMidi.enabled) {
     const otherInputs = WebMidi.inputs.filter((o) => o.name !== device.name);
     logger(
       `Midi enabled! Using "${device.name}". ${

From fb7c2b61d3fce9ca7674a5f0214dc92ea7420677 Mon Sep 17 00:00:00 2001
From: Michael Hetrick <michael.s.hetrick@gmail.com>
Date: Fri, 26 Jan 2024 07:13:09 -0800
Subject: [PATCH 02/27] Update first-sounds.mdx

Update the tutorial text to reflect that the default cpm setting has changed from 60 to 30.
---
 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 c8f321b8..eece6a3f 100644
--- a/website/src/pages/workshop/first-sounds.mdx
+++ b/website/src/pages/workshop/first-sounds.mdx
@@ -139,7 +139,7 @@ The content of a sequence will be squished into what's called a cycle.
 
 cpm = cycles per minute
 
-By default, the tempo is 60 cycles per minute = 1 cycle per second.
+By default, the tempo is 30 cycles per minute = 1 half cycle per second.
 
 </Box>
 

From d2bf9370eae184bb167f6270561e7069cc9aaa7a Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sun, 4 Feb 2024 23:24:43 +0100
Subject: [PATCH 03/27] Update README.md

add link to usage example for repl package
---
 packages/repl/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/repl/README.md b/packages/repl/README.md
index ff310948..b4cbf37c 100644
--- a/packages/repl/README.md
+++ b/packages/repl/README.md
@@ -1,3 +1,5 @@
 # @strudel/repl
 
 The Strudel REPL as a web component.
+
+[Usage example](https://github.com/tidalcycles/strudel/blob/main/examples/buildless/web-component-no-iframe.html)

From 60129413d3a89877f3457d878519697a4e3ca8a1 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 8 Feb 2024 12:19:11 +0100
Subject: [PATCH 04/27] remove cjs builds + add type module everywhere

---
 packages/codemirror/package.json   | 1 -
 packages/codemirror/vite.config.js | 4 ++--
 packages/core/package.json         | 1 -
 packages/core/vite.config.js       | 4 ++--
 packages/csound/package.json       | 2 +-
 packages/csound/vite.config.js     | 4 ++--
 packages/hydra/package.json        | 2 +-
 packages/hydra/vite.config.js      | 4 ++--
 packages/midi/package.json         | 2 +-
 packages/midi/vite.config.js       | 4 ++--
 packages/mini/package.json         | 1 -
 packages/mini/vite.config.js       | 4 ++--
 packages/osc/package.json          | 2 +-
 packages/osc/vite.config.js        | 4 ++--
 packages/repl/package.json         | 1 -
 packages/serial/package.json       | 2 +-
 packages/serial/vite.config.js     | 4 ++--
 packages/soundfonts/package.json   | 1 -
 packages/soundfonts/vite.config.js | 4 ++--
 packages/superdough/vite.config.js | 2 +-
 packages/tonal/package.json        | 1 -
 packages/tonal/vite.config.js      | 4 ++--
 packages/transpiler/package.json   | 2 +-
 packages/transpiler/vite.config.js | 4 ++--
 packages/web/package.json          | 1 -
 packages/web/vite.config.js        | 4 ++--
 packages/webaudio/package.json     | 1 -
 packages/webaudio/vite.config.js   | 4 ++--
 packages/xen/package.json          | 2 +-
 packages/xen/vite.config.js        | 4 ++--
 30 files changed, 36 insertions(+), 44 deletions(-)

diff --git a/packages/codemirror/package.json b/packages/codemirror/package.json
index c45fa2e2..d310225a 100644
--- a/packages/codemirror/package.json
+++ b/packages/codemirror/package.json
@@ -4,7 +4,6 @@
   "description": "Codemirror Extensions for Strudel",
   "main": "index.mjs",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/codemirror/vite.config.js b/packages/codemirror/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/codemirror/vite.config.js
+++ b/packages/codemirror/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/core/package.json b/packages/core/package.json
index 158e51bf..79557c51 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -5,7 +5,6 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/core/vite.config.js b/packages/core/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/core/vite.config.js
+++ b/packages/core/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/csound/package.json b/packages/csound/package.json
index 33372886..996cf401 100644
--- a/packages/csound/package.json
+++ b/packages/csound/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "csound bindings for strudel",
   "main": "index.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/csound/vite.config.js b/packages/csound/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/csound/vite.config.js
+++ b/packages/csound/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/hydra/package.json b/packages/hydra/package.json
index 97432f67..7329e88d 100644
--- a/packages/hydra/package.json
+++ b/packages/hydra/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "Hydra integration for strudel",
   "main": "hydra.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/hydra/vite.config.js b/packages/hydra/vite.config.js
index 215a9114..0caf1d2f 100644
--- a/packages/hydra/vite.config.js
+++ b/packages/hydra/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'hydra.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/midi/package.json b/packages/midi/package.json
index aea88d13..ec14e59c 100644
--- a/packages/midi/package.json
+++ b/packages/midi/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "Midi API for strudel",
   "main": "index.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/midi/vite.config.js b/packages/midi/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/midi/vite.config.js
+++ b/packages/midi/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/mini/package.json b/packages/mini/package.json
index 080c42d9..781e0a3f 100644
--- a/packages/mini/package.json
+++ b/packages/mini/package.json
@@ -5,7 +5,6 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/mini/vite.config.js b/packages/mini/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/mini/vite.config.js
+++ b/packages/mini/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/osc/package.json b/packages/osc/package.json
index 9e06bd97..1982fd6e 100644
--- a/packages/osc/package.json
+++ b/packages/osc/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "OSC messaging for strudel",
   "main": "osc.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/osc/vite.config.js b/packages/osc/vite.config.js
index 23e7bb4e..88e673b3 100644
--- a/packages/osc/vite.config.js
+++ b/packages/osc/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'osc.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/repl/package.json b/packages/repl/package.json
index 009d33d1..fd6f3354 100644
--- a/packages/repl/package.json
+++ b/packages/repl/package.json
@@ -4,7 +4,6 @@
   "description": "Strudel REPL as a Web Component",
   "main": "index.mjs",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/serial/package.json b/packages/serial/package.json
index 92741448..b02da3ff 100644
--- a/packages/serial/package.json
+++ b/packages/serial/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "Webserial API for strudel",
   "main": "serial.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/serial/vite.config.js b/packages/serial/vite.config.js
index 2f5dcc39..9e2c287d 100644
--- a/packages/serial/vite.config.js
+++ b/packages/serial/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'serial.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/soundfonts/package.json b/packages/soundfonts/package.json
index dee0ca64..08f18f46 100644
--- a/packages/soundfonts/package.json
+++ b/packages/soundfonts/package.json
@@ -4,7 +4,6 @@
   "description": "Soundsfont support for strudel",
   "main": "index.mjs",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/soundfonts/vite.config.js b/packages/soundfonts/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/soundfonts/vite.config.js
+++ b/packages/soundfonts/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/superdough/vite.config.js b/packages/superdough/vite.config.js
index dd71cf67..d94e37f4 100644
--- a/packages/superdough/vite.config.js
+++ b/packages/superdough/vite.config.js
@@ -8,7 +8,7 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
+      formats: ['es'],
       fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.cjs' })[ext],
     },
     rollupOptions: {
diff --git a/packages/tonal/package.json b/packages/tonal/package.json
index 918f9965..3677e295 100644
--- a/packages/tonal/package.json
+++ b/packages/tonal/package.json
@@ -4,7 +4,6 @@
   "description": "Tonal functions for strudel",
   "main": "index.mjs",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/tonal/vite.config.js b/packages/tonal/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/tonal/vite.config.js
+++ b/packages/tonal/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/transpiler/package.json b/packages/transpiler/package.json
index 662565a9..29ebdebc 100644
--- a/packages/transpiler/package.json
+++ b/packages/transpiler/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "Transpiler for strudel user code. Converts syntactically correct but semantically meaningless JS into evaluatable strudel code.",
   "main": "index.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/transpiler/vite.config.js b/packages/transpiler/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/transpiler/vite.config.js
+++ b/packages/transpiler/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/web/package.json b/packages/web/package.json
index 10e50290..9732b526 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -4,7 +4,6 @@
   "description": "Easy to setup, opiniated bundle of Strudel for the browser.",
   "main": "web.mjs",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/web/vite.config.js b/packages/web/vite.config.js
index 02873d65..7fe99498 100644
--- a/packages/web/vite.config.js
+++ b/packages/web/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'web.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/webaudio/package.json b/packages/webaudio/package.json
index b27ea94b..217a197f 100644
--- a/packages/webaudio/package.json
+++ b/packages/webaudio/package.json
@@ -8,7 +8,6 @@
     "example": "examples"
   },
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/webaudio/vite.config.js b/packages/webaudio/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/webaudio/vite.config.js
+++ b/packages/webaudio/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],
diff --git a/packages/xen/package.json b/packages/xen/package.json
index 8f328ba7..34053629 100644
--- a/packages/xen/package.json
+++ b/packages/xen/package.json
@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "description": "Xenharmonic API for strudel",
   "main": "index.mjs",
+  "type": "module",
   "publishConfig": {
-    "main": "dist/index.js",
     "module": "dist/index.mjs"
   },
   "scripts": {
diff --git a/packages/xen/vite.config.js b/packages/xen/vite.config.js
index c1d1a2ee..5df3edc1 100644
--- a/packages/xen/vite.config.js
+++ b/packages/xen/vite.config.js
@@ -8,8 +8,8 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'index.mjs'),
-      formats: ['es', 'cjs'],
-      fileName: (ext) => ({ es: 'index.mjs', cjs: 'index.js' })[ext],
+      formats: ['es'],
+      fileName: (ext) => ({ es: 'index.mjs' })[ext],
     },
     rollupOptions: {
       external: [...Object.keys(dependencies)],

From 5dc04d9574da43e6c32fa583a9c159570a8031f9 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 8 Feb 2024 12:36:04 +0100
Subject: [PATCH 05/27] make sure to overwrite main field

---
 packages/codemirror/package.json | 2 +-
 packages/core/package.json       | 2 +-
 packages/csound/package.json     | 2 +-
 packages/hydra/package.json      | 2 +-
 packages/midi/package.json       | 2 +-
 packages/mini/package.json       | 2 +-
 packages/osc/package.json        | 2 +-
 packages/repl/package.json       | 2 +-
 packages/serial/package.json     | 2 +-
 packages/soundfonts/package.json | 2 +-
 packages/superdough/package.json | 2 +-
 packages/tonal/package.json      | 2 +-
 packages/transpiler/package.json | 2 +-
 packages/web/package.json        | 2 +-
 packages/webaudio/package.json   | 2 +-
 packages/xen/package.json        | 2 +-
 16 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/codemirror/package.json b/packages/codemirror/package.json
index d310225a..90360abb 100644
--- a/packages/codemirror/package.json
+++ b/packages/codemirror/package.json
@@ -4,7 +4,7 @@
   "description": "Codemirror Extensions for Strudel",
   "main": "index.mjs",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/core/package.json b/packages/core/package.json
index 79557c51..5e0f7eed 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -5,7 +5,7 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "test": "vitest run",
diff --git a/packages/csound/package.json b/packages/csound/package.json
index 996cf401..8bd6394b 100644
--- a/packages/csound/package.json
+++ b/packages/csound/package.json
@@ -5,7 +5,7 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/hydra/package.json b/packages/hydra/package.json
index 7329e88d..3a863862 100644
--- a/packages/hydra/package.json
+++ b/packages/hydra/package.json
@@ -5,7 +5,7 @@
   "main": "hydra.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "server": "node server.js",
diff --git a/packages/midi/package.json b/packages/midi/package.json
index ec14e59c..fb92b4a3 100644
--- a/packages/midi/package.json
+++ b/packages/midi/package.json
@@ -5,7 +5,7 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/mini/package.json b/packages/mini/package.json
index 781e0a3f..21fd9ef2 100644
--- a/packages/mini/package.json
+++ b/packages/mini/package.json
@@ -5,7 +5,7 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "test": "vitest run",
diff --git a/packages/osc/package.json b/packages/osc/package.json
index 1982fd6e..8567a013 100644
--- a/packages/osc/package.json
+++ b/packages/osc/package.json
@@ -5,7 +5,7 @@
   "main": "osc.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "server": "node server.js",
diff --git a/packages/repl/package.json b/packages/repl/package.json
index fd6f3354..086f7851 100644
--- a/packages/repl/package.json
+++ b/packages/repl/package.json
@@ -4,7 +4,7 @@
   "description": "Strudel REPL as a Web Component",
   "main": "index.mjs",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/serial/package.json b/packages/serial/package.json
index b02da3ff..fba52514 100644
--- a/packages/serial/package.json
+++ b/packages/serial/package.json
@@ -5,7 +5,7 @@
   "main": "serial.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/soundfonts/package.json b/packages/soundfonts/package.json
index 08f18f46..0a7c3797 100644
--- a/packages/soundfonts/package.json
+++ b/packages/soundfonts/package.json
@@ -4,7 +4,7 @@
   "description": "Soundsfont support for strudel",
   "main": "index.mjs",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/superdough/package.json b/packages/superdough/package.json
index deb75784..a2308be8 100644
--- a/packages/superdough/package.json
+++ b/packages/superdough/package.json
@@ -6,7 +6,7 @@
   "type": "module",
   "publishConfig": {
     "main": "dist/index.cjs",
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "directories": {
     "example": "examples"
diff --git a/packages/tonal/package.json b/packages/tonal/package.json
index 3677e295..756f84cd 100644
--- a/packages/tonal/package.json
+++ b/packages/tonal/package.json
@@ -4,7 +4,7 @@
   "description": "Tonal functions for strudel",
   "main": "index.mjs",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/transpiler/package.json b/packages/transpiler/package.json
index 29ebdebc..0a2d68d9 100644
--- a/packages/transpiler/package.json
+++ b/packages/transpiler/package.json
@@ -5,7 +5,7 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/web/package.json b/packages/web/package.json
index 9732b526..900398dc 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -4,7 +4,7 @@
   "description": "Easy to setup, opiniated bundle of Strudel for the browser.",
   "main": "web.mjs",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",
diff --git a/packages/webaudio/package.json b/packages/webaudio/package.json
index 217a197f..0f12e1f5 100644
--- a/packages/webaudio/package.json
+++ b/packages/webaudio/package.json
@@ -8,7 +8,7 @@
     "example": "examples"
   },
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "example": "npx parcel examples/repl.html",
diff --git a/packages/xen/package.json b/packages/xen/package.json
index 34053629..ea3aa55c 100644
--- a/packages/xen/package.json
+++ b/packages/xen/package.json
@@ -5,7 +5,7 @@
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "module": "dist/index.mjs"
+    "main": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",

From 051bdaccc75ba3f14026e3b652d5e3ff97b83aa6 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Thu, 8 Feb 2024 13:04:25 +0100
Subject: [PATCH 06/27] Publish

 - @strudel/codemirror@1.0.1
 - @strudel/core@1.0.1
 - @strudel/csound@1.0.1
 - @strudel/hydra@1.0.1
 - @strudel/midi@1.0.1
 - @strudel/mini@1.0.1
 - @strudel/osc@1.0.1
 - @strudel/repl@1.0.1
 - @strudel/serial@1.0.1
 - @strudel/soundfonts@1.0.1
 - superdough@1.0.1
 - @strudel/tonal@1.0.1
 - @strudel/transpiler@1.0.1
 - @strudel/web@1.0.1
 - @strudel/webaudio@1.0.1
 - @strudel/xen@1.0.1
---
 packages/codemirror/package.json | 2 +-
 packages/core/package.json       | 2 +-
 packages/csound/package.json     | 2 +-
 packages/hydra/package.json      | 2 +-
 packages/midi/package.json       | 2 +-
 packages/mini/package.json       | 2 +-
 packages/osc/package.json        | 2 +-
 packages/repl/package.json       | 2 +-
 packages/serial/package.json     | 2 +-
 packages/soundfonts/package.json | 2 +-
 packages/superdough/package.json | 3 +--
 packages/tonal/package.json      | 2 +-
 packages/transpiler/package.json | 2 +-
 packages/web/package.json        | 2 +-
 packages/webaudio/package.json   | 2 +-
 packages/xen/package.json        | 2 +-
 16 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/packages/codemirror/package.json b/packages/codemirror/package.json
index 90360abb..22213ac7 100644
--- a/packages/codemirror/package.json
+++ b/packages/codemirror/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/codemirror",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Codemirror Extensions for Strudel",
   "main": "index.mjs",
   "publishConfig": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 5e0f7eed..7f59ed41 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/core",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Port of Tidal Cycles to JavaScript",
   "main": "index.mjs",
   "type": "module",
diff --git a/packages/csound/package.json b/packages/csound/package.json
index 8bd6394b..e0811208 100644
--- a/packages/csound/package.json
+++ b/packages/csound/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/csound",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "csound bindings for strudel",
   "main": "index.mjs",
   "type": "module",
diff --git a/packages/hydra/package.json b/packages/hydra/package.json
index 3a863862..48189663 100644
--- a/packages/hydra/package.json
+++ b/packages/hydra/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/hydra",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Hydra integration for strudel",
   "main": "hydra.mjs",
   "type": "module",
diff --git a/packages/midi/package.json b/packages/midi/package.json
index fb92b4a3..4cc2dddb 100644
--- a/packages/midi/package.json
+++ b/packages/midi/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/midi",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Midi API for strudel",
   "main": "index.mjs",
   "type": "module",
diff --git a/packages/mini/package.json b/packages/mini/package.json
index 21fd9ef2..cb4f459c 100644
--- a/packages/mini/package.json
+++ b/packages/mini/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/mini",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Mini notation for strudel",
   "main": "index.mjs",
   "type": "module",
diff --git a/packages/osc/package.json b/packages/osc/package.json
index 8567a013..92725cd4 100644
--- a/packages/osc/package.json
+++ b/packages/osc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/osc",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OSC messaging for strudel",
   "main": "osc.mjs",
   "type": "module",
diff --git a/packages/repl/package.json b/packages/repl/package.json
index 086f7851..eae203f1 100644
--- a/packages/repl/package.json
+++ b/packages/repl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/repl",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Strudel REPL as a Web Component",
   "main": "index.mjs",
   "publishConfig": {
diff --git a/packages/serial/package.json b/packages/serial/package.json
index fba52514..9a98a253 100644
--- a/packages/serial/package.json
+++ b/packages/serial/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/serial",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Webserial API for strudel",
   "main": "serial.mjs",
   "type": "module",
diff --git a/packages/soundfonts/package.json b/packages/soundfonts/package.json
index 0a7c3797..db8370c3 100644
--- a/packages/soundfonts/package.json
+++ b/packages/soundfonts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/soundfonts",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Soundsfont support for strudel",
   "main": "index.mjs",
   "publishConfig": {
diff --git a/packages/superdough/package.json b/packages/superdough/package.json
index a2308be8..f1abd95b 100644
--- a/packages/superdough/package.json
+++ b/packages/superdough/package.json
@@ -1,11 +1,10 @@
 {
   "name": "superdough",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "simple web audio synth and sampler intended for live coding. inspired by superdirt and webdirt.",
   "main": "index.mjs",
   "type": "module",
   "publishConfig": {
-    "main": "dist/index.cjs",
     "main": "dist/index.mjs"
   },
   "directories": {
diff --git a/packages/tonal/package.json b/packages/tonal/package.json
index 756f84cd..e4418228 100644
--- a/packages/tonal/package.json
+++ b/packages/tonal/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/tonal",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Tonal functions for strudel",
   "main": "index.mjs",
   "publishConfig": {
diff --git a/packages/transpiler/package.json b/packages/transpiler/package.json
index 0a2d68d9..12038fc4 100644
--- a/packages/transpiler/package.json
+++ b/packages/transpiler/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/transpiler",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Transpiler for strudel user code. Converts syntactically correct but semantically meaningless JS into evaluatable strudel code.",
   "main": "index.mjs",
   "type": "module",
diff --git a/packages/web/package.json b/packages/web/package.json
index 900398dc..68ced2d2 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/web",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Easy to setup, opiniated bundle of Strudel for the browser.",
   "main": "web.mjs",
   "publishConfig": {
diff --git a/packages/webaudio/package.json b/packages/webaudio/package.json
index 0f12e1f5..dce53961 100644
--- a/packages/webaudio/package.json
+++ b/packages/webaudio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/webaudio",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Web Audio helpers for Strudel",
   "main": "index.mjs",
   "type": "module",
diff --git a/packages/xen/package.json b/packages/xen/package.json
index ea3aa55c..8ee5d8a3 100644
--- a/packages/xen/package.json
+++ b/packages/xen/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/xen",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Xenharmonic API for strudel",
   "main": "index.mjs",
   "type": "module",

From c06a3710c148fbb96f283d6a802b5c833d252574 Mon Sep 17 00:00:00 2001
From: "Jade (Rose) Rowland" <jaderowlanddev@gmail.com>
Date: Mon, 19 Feb 2024 23:43:35 -0500
Subject: [PATCH 07/27] fixed

---
 packages/desktopbridge/midibridge.mjs | 4 ++--
 packages/midi/midi.mjs                | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/desktopbridge/midibridge.mjs b/packages/desktopbridge/midibridge.mjs
index 6959a5bb..ebbb185b 100644
--- a/packages/desktopbridge/midibridge.mjs
+++ b/packages/desktopbridge/midibridge.mjs
@@ -6,11 +6,11 @@ const OFF_MESSAGE = 0x80;
 const CC_MESSAGE = 0xb0;
 
 Pattern.prototype.midi = function (output) {
-  return this.onTrigger((time, hap, currentTime) => {
+  return this.onTrigger((time, hap, currentTime, cps) => {
     const { note, nrpnn, nrpv, ccn, ccv } = hap.value;
     const offset = (time - currentTime) * 1000;
     const velocity = Math.floor((hap.context?.velocity ?? 0.9) * 100); // TODO: refactor velocity
-    const duration = Math.floor(hap.duration.valueOf() * 1000 - 10);
+    const duration = Math.floor((hap.duration.valueOf() / cps) * 1000 - 10);
     const roundedOffset = Math.round(offset);
     const midichan = (hap.value.midichan ?? 1) - 1;
     const requestedport = output ?? 'IAC';
diff --git a/packages/midi/midi.mjs b/packages/midi/midi.mjs
index f40a5049..96a29c27 100644
--- a/packages/midi/midi.mjs
+++ b/packages/midi/midi.mjs
@@ -129,7 +129,7 @@ Pattern.prototype.midi = function (output) {
     const velocity = hap.context?.velocity ?? 0.9; // TODO: refactor velocity
 
     // note off messages will often a few ms arrive late, try to prevent glitching by subtracting from the duration length
-    const duration = Math.floor(hap.duration.valueOf() * 1000 - 10);
+    const duration = Math.floor((hap.duration.valueOf() / cps) * 1000 - 10);
     if (note != null) {
       const midiNumber = typeof note === 'number' ? note : noteToMidi(note);
       const midiNote = new Note(midiNumber, { attack: velocity, duration });

From ebdca32c806e89d6d5648462b7c200ae2c9226c5 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 21 Feb 2024 09:48:26 +0100
Subject: [PATCH 08/27] automatically add await to samples call

---
 packages/transpiler/transpiler.mjs | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/packages/transpiler/transpiler.mjs b/packages/transpiler/transpiler.mjs
index aedf8f3a..72f2e851 100644
--- a/packages/transpiler/transpiler.mjs
+++ b/packages/transpiler/transpiler.mjs
@@ -1,8 +1,7 @@
-import escodegen from 'escodegen';
-import { parse } from 'acorn';
-import { walk } from 'estree-walker';
-import { isNoteWithOctave } from '@strudel/core';
 import { getLeafLocations } from '@strudel/mini';
+import { parse } from 'acorn';
+import escodegen from 'escodegen';
+import { walk } from 'estree-walker';
 
 export function transpiler(input, options = {}) {
   const { wrapAsync = false, addReturn = true, emitMiniLocations = true, emitWidgets = true } = options;
@@ -47,6 +46,9 @@ export function transpiler(input, options = {}) {
           });
         return this.replace(widgetWithLocation(node));
       }
+      if (isBareSamplesCall(node, parent)) {
+        return this.replace(withAwait(node));
+      }
     },
     leave(node, parent, prop, index) {},
   });
@@ -119,3 +121,14 @@ function widgetWithLocation(node) {
   node.callee.name = 'sliderWithID';
   return node;
 }
+
+function isBareSamplesCall(node, parent) {
+  return node.type === 'CallExpression' && node.callee.name === 'samples' && parent.type !== 'AwaitExpression';
+}
+
+function withAwait(node) {
+  return {
+    type: 'AwaitExpression',
+    argument: node,
+  };
+}

From 38d389b83899046b190f594155fb7c374d4b596f Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 21 Feb 2024 09:50:21 +0100
Subject: [PATCH 09/27] add test

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

diff --git a/packages/transpiler/test/transpiler.test.mjs b/packages/transpiler/test/transpiler.test.mjs
index 5f1b754f..988479b4 100644
--- a/packages/transpiler/test/transpiler.test.mjs
+++ b/packages/transpiler/test/transpiler.test.mjs
@@ -23,6 +23,9 @@ describe('transpiler', () => {
   it('supports top level await', () => {
     expect(transpiler("await samples('xxx');", simple).output).toEqual("await samples('xxx');");
   });
+  it('adds await to bare samples call', () => {
+    expect(transpiler("samples('xxx');", simple).output).toEqual("await samples('xxx');");
+  });
   /*   it('parses dynamic imports', () => {
     expect(
       transpiler("const { default: foo } = await import('https://bar.com/foo.js');", {

From bf63b716af91cf512f3de83758a3b8463f346a0d Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 21 Feb 2024 10:17:45 +0100
Subject: [PATCH 10/27] refactor: remove await before samples calls in docs
 etc.. + remove /master from dirt-samples calls (there is now a main branch) +
 remove /main endings from some places

---
 examples/buildless/headless-with-samples.html |  2 +-
 examples/buildless/minimal-repl.html          |  2 +-
 examples/codemirror-repl/tunes.mjs            | 12 +++++------
 examples/headless-repl/index.html             |  2 +-
 examples/minimal-repl/tune.mjs                |  2 +-
 examples/superdough/index.html                |  2 +-
 packages/core/controls.mjs                    |  2 +-
 packages/core/pattern.mjs                     |  6 +++---
 packages/superdough/README.md                 |  4 ++--
 packages/superdough/sampler.mjs               |  2 +-
 packages/web/README.md                        |  2 +-
 .../blog/release-0.8.0-himbeermuffin.mdx      |  2 +-
 website/src/examples.mjs                      |  4 ++--
 website/src/pages/learn/getting-started.mdx   |  2 +-
 website/src/pages/learn/samples.mdx           | 20 +++++++++----------
 website/src/pages/recipes/recipes.mdx         | 20 +++++++++----------
 website/src/pages/recipes/rhythms.mdx         |  2 +-
 website/src/repl/prebake.mjs                  |  3 +--
 website/src/repl/tunes.mjs                    | 10 +++++-----
 19 files changed, 50 insertions(+), 51 deletions(-)

diff --git a/examples/buildless/headless-with-samples.html b/examples/buildless/headless-with-samples.html
index 40073d70..2ac7aa71 100644
--- a/examples/buildless/headless-with-samples.html
+++ b/examples/buildless/headless-with-samples.html
@@ -6,7 +6,7 @@
 <script type="module">
   import { initStrudel } from 'https://cdn.skypack.dev/@strudel/web@0.8.2';
   initStrudel({
-    prebake: () => samples('github:tidalcycles/Dirt-Samples/master'),
+    prebake: () => samples('github:tidalcycles/dirt-samples'),
   });
   const click = (id, action) => document.getElementById(id).addEventListener('click', action);
   click('a', () => evaluate(`s('bd,jvbass(3,8)').jux(rev)`));
diff --git a/examples/buildless/minimal-repl.html b/examples/buildless/minimal-repl.html
index 97b06f1c..c46b25ce 100644
--- a/examples/buildless/minimal-repl.html
+++ b/examples/buildless/minimal-repl.html
@@ -52,7 +52,7 @@
       });
 
       function getTune() {
-        return `await samples('github:tidalcycles/Dirt-Samples/master')
+        return `samples('github:tidalcycles/dirt-samples')
 
 stack(
   // amen
diff --git a/examples/codemirror-repl/tunes.mjs b/examples/codemirror-repl/tunes.mjs
index 73600019..901b4af9 100644
--- a/examples/codemirror-repl/tunes.mjs
+++ b/examples/codemirror-repl/tunes.mjs
@@ -1,6 +1,6 @@
 export const bumpStreet = `// froos - "22 bump street", licensed with CC BY-NC-SA 4.0
-await samples('github:felixroos/samples/main')
-await samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tidal-drum-machines/main/machines/')
+samples('github:felixroos/samples')
+samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tidal-drum-machines/main/machines/')
 
 "<[0,<6 7 9>,13,<17 20 22 26>]!2>/2"
   // make it 22 edo
@@ -33,8 +33,8 @@ await samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tid
 
 export const trafficFlam = `// froos - "traffic flam", licensed with CC BY-NC-SA 4.0
 
-await samples('github:felixroos/samples/main')
-await samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tidal-drum-machines/main/machines/')
+samples('github:felixroos/samples')
+samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tidal-drum-machines/main/machines/')
 
 addVoicings('hip', {
   m11: ['2M 3m 4P 7m'],
@@ -69,8 +69,8 @@ export const funk42 = `// froos - how to funk in 42 lines of code
 // adapted from "how to funk in two minutes" by marc rebillet https://www.youtube.com/watch?v=3vBwRfQbXkg
 // thanks to peach for the transcription: https://www.youtube.com/watch?v=8eiPXvIgda4
 
-await samples('github:felixroos/samples/main')
-await samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tidal-drum-machines/main/machines/')
+samples('github:felixroos/samples')
+samples('https://strudel.cc/tidal-drum-machines.json', 'github:ritchse/tidal-drum-machines/main/machines/')
 
 setcps(.5)
 
diff --git a/examples/headless-repl/index.html b/examples/headless-repl/index.html
index e92efdca..d9d8d108 100644
--- a/examples/headless-repl/index.html
+++ b/examples/headless-repl/index.html
@@ -15,7 +15,7 @@
     <script type="module">
       import { initStrudel } from '@strudel/web';
       initStrudel({
-        prebake: () => samples('github:tidalcycles/Dirt-Samples/master'),
+        prebake: () => samples('github:tidalcycles/dirt-samples'),
       });
 
       const click = (id, action) => document.getElementById(id).addEventListener('click', action);
diff --git a/examples/minimal-repl/tune.mjs b/examples/minimal-repl/tune.mjs
index acdc0a62..cf867127 100644
--- a/examples/minimal-repl/tune.mjs
+++ b/examples/minimal-repl/tune.mjs
@@ -1,4 +1,4 @@
-export default `await samples('github:tidalcycles/Dirt-Samples/master')
+export default `samples('github:tidalcycles/dirt-samples')
 
 stack(
   // amen
diff --git a/examples/superdough/index.html b/examples/superdough/index.html
index 43c0492a..e482d70b 100644
--- a/examples/superdough/index.html
+++ b/examples/superdough/index.html
@@ -12,7 +12,7 @@
 
       const init = Promise.all([
         initAudioOnFirstClick(),
-        samples('github:tidalcycles/Dirt-Samples/master'),
+        samples('github:tidalcycles/dirt-samples'),
         registerSynthSounds(),
       ]);
 
diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 3b2b5aab..ae7b6f44 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -292,7 +292,7 @@ const generic_params = [
    * @name begin
    * @param {number | Pattern} amount between 0 and 1, where 1 is the length of the sample
    * @example
-   * samples({ rave: 'rave/AREUREADY.wav' }, 'github:tidalcycles/Dirt-Samples/master/')
+   * samples({ rave: 'rave/AREUREADY.wav' }, 'github:tidalcycles/dirt-samples')
    * s("rave").begin("<0 .25 .5 .75>").fast(2)
    *
    */
diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 1be38113..3d859728 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -2322,10 +2322,10 @@ const _loopAt = function (factor, pat, cps = 0.5) {
  * @memberof Pattern
  * @returns Pattern
  * @example
- * await samples('github:tidalcycles/Dirt-Samples/master')
+ * samples('github:tidalcycles/dirt-samples')
  * s("breaks165").slice(8, "0 1 <2 2*2> 3 [4 0] 5 6 7".every(3, rev)).slow(0.75)
  * @example
- * await samples('github:tidalcycles/Dirt-Samples/master')
+ * samples('github:tidalcycles/dirt-samples')
  * s("breaks125").fit().slice([0,.25,.5,.75], "0 1 1 <2 3>")
  */
 
@@ -2351,7 +2351,7 @@ export const slice = register(
  * Works the same as slice, but changes the playback speed of each slice to match the duration of its step.
  * @name splice
  * @example
- * await samples('github:tidalcycles/Dirt-Samples/master')
+ * samples('github:tidalcycles/dirt-samples')
  * s("breaks165")
  * .splice(8,  "0 1 [2 3 0]@2 3 0@2 7")
  */
diff --git a/packages/superdough/README.md b/packages/superdough/README.md
index f32aa32d..b1ccae60 100644
--- a/packages/superdough/README.md
+++ b/packages/superdough/README.md
@@ -19,7 +19,7 @@ import { superdough, samples, initAudioOnFirstClick, registerSynthSounds } from
 
 const init = Promise.all([
   initAudioOnFirstClick(),
-  samples('github:tidalcycles/Dirt-Samples/master'),
+  samples('github:tidalcycles/dirt-samples'),
   registerSynthSounds(),
 ]);
 
@@ -148,7 +148,7 @@ The json file is expected to have the same format as described above.
 Because it is common to use github for samples, there is a short way to load a sample map from github:
 
 ```js
-samples('github:tidalcycles/Dirt-Samples/master')
+samples('github:tidalcycles/dirt-samples')
 ```
 
 The format is `github:<user>/<repo>/<branch>`.
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index 19fec661..3c3e670d 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -142,7 +142,7 @@ function getSamplesPrefixHandler(url) {
 /**
  * Loads a collection of samples to use with `s`
  * @example
- * samples('github:tidalcycles/Dirt-Samples/master');
+ * samples('github:tidalcycles/dirt-samples');
  * s("[bd ~]*2, [~ hh]*2, ~ sd")
  * @example
  * samples({
diff --git a/packages/web/README.md b/packages/web/README.md
index 8189b34e..b3d2f6fe 100644
--- a/packages/web/README.md
+++ b/packages/web/README.md
@@ -43,7 +43,7 @@ By default, no external samples are loaded, but you can add them like this:
 
 ```js
 initStrudel({
-  prebake: () => samples('github:tidalcycles/Dirt-Samples/master'),
+  prebake: () => samples('github:tidalcycles/dirt-samples'),
 });
 
 document.getElementById('play').addEventListener('click', 
diff --git a/website/src/content/blog/release-0.8.0-himbeermuffin.mdx b/website/src/content/blog/release-0.8.0-himbeermuffin.mdx
index c0984522..7620140b 100644
--- a/website/src/content/blog/release-0.8.0-himbeermuffin.mdx
+++ b/website/src/content/blog/release-0.8.0-himbeermuffin.mdx
@@ -29,7 +29,7 @@ edit: the desktop app performance on linux is currently not that great.. the web
 The desktop App has the same features as the webapp, with the additional ability to load samples from disk. It is currently not documented yet, but you can do something like
 
 ```js
-await samples('~/music/xxx');
+samples('~/music/xxx');
 
 s('my_sound');
 ```
diff --git a/website/src/examples.mjs b/website/src/examples.mjs
index d752e711..61132dfa 100644
--- a/website/src/examples.mjs
+++ b/website/src/examples.mjs
@@ -1,6 +1,6 @@
 export const examples = [
   `// "coastline" @by eddyflux
-await samples('github:eddyflux/crate')
+samples('github:eddyflux/crate')
 setcps(.75)
 let chords = chord("<Bbm9 Fm9>/4").dict('ireal')
 stack(
@@ -30,7 +30,7 @@ stack(
 .late("[0 .01]*4").late("[0 .01]*2").size(4)`,
   `// "broken cut 1" @by froos
 
-await samples('github:tidalcycles/Dirt-Samples/master')
+samples('github:tidalcycles/dirt-samples')
 samples({
   'slap': 'https://cdn.freesound.org/previews/495/495416_10350281-lq.mp3',
   'whirl': 'https://cdn.freesound.org/previews/495/495313_10350281-lq.mp3',
diff --git a/website/src/pages/learn/getting-started.mdx b/website/src/pages/learn/getting-started.mdx
index 0fb750c1..d18a0560 100644
--- a/website/src/pages/learn/getting-started.mdx
+++ b/website/src/pages/learn/getting-started.mdx
@@ -51,7 +51,7 @@ Alternatively, you can get a taste of what Strudel can do by clicking play on th
   bd: ['bd/BT0AADA.wav','bd/BT0AAD0.wav','bd/BT0A0DA.wav','bd/BT0A0D3.wav','bd/BT0A0D0.wav','bd/BT0A0A7.wav'],
   sd: ['sd/rytm-01-classic.wav','sd/rytm-00-hard.wav'],
   hh: ['hh27/000_hh27closedhh.wav','hh/000_hh3closedhh.wav'],
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 stack(
 s("bd,[~ <sd!3 sd(3,4,2)>],hh*8") // drums
 .speed(perlin.range(.7,.9)) // random sample speed variation
diff --git a/website/src/pages/learn/samples.mdx b/website/src/pages/learn/samples.mdx
index fffea282..56b6e65c 100644
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@@ -143,7 +143,7 @@ Because GitHub is a popular place for uploading open source samples, it has its
   bd: 'bd/BT0AADA.wav',
   sd: 'sd/rytm-01-classic.wav',
   hh: 'hh27/000_hh27closedhh.wav',
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 s("bd sd bd sd,hh*16")`}
 />
 
@@ -174,7 +174,7 @@ It is also possible, to declare multiple files for one sound, using the array no
   bd: ['bd/BT0AADA.wav','bd/BT0AAD0.wav'],
   sd: ['sd/rytm-01-classic.wav','sd/rytm-00-hard.wav'],
   hh: ['hh27/000_hh27closedhh.wav','hh/000_hh3closedhh.wav'],
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 s("bd:0 bd:1,~ <sd:0 sd:1> ~ sd:0,[hh:0 hh:1]*4")`}
 />
 
@@ -187,7 +187,7 @@ The sample number can also be set using `n`:
   bd: ['bd/BT0AADA.wav','bd/BT0AAD0.wav'],
   sd: ['sd/rytm-01-classic.wav','sd/rytm-00-hard.wav'],
   hh: ['hh27/000_hh27closedhh.wav','hh/000_hh3closedhh.wav'],
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 s("bd bd,~ sd ~ sd,hh*8").n("<0 1>")`}
 />
 
@@ -231,7 +231,7 @@ For pitched sounds, you can use `note`, just like with synths:
   client:idle
   tune={`samples({
   'gtr': 'gtr/0001_cleanC.wav',
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 note("g3 [bb3 c4] <g4 f4 eb4 f3>@2").s('gtr').gain(.5)`}
 />
 
@@ -242,7 +242,7 @@ If we want them to behave more like a synth, we can add `clip(1)`:
   client:idle
   tune={`samples({
   'gtr': 'gtr/0001_cleanC.wav',
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 note("g3 [bb3 c4] <g4 f4 eb4 f3>@2").s('gtr').clip(1)
   .gain(.5)`}
 />
@@ -256,7 +256,7 @@ If we have 2 samples with different base pitches, we can make them in tune by sp
   tune={`samples({
   'gtr': 'gtr/0001_cleanC.wav',
   'moog': { 'g3': 'moog/005_Mighty%20Moog%20G3.wav' },
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 note("g3 [bb3 c4] <g4 f4 eb4 f3>@2").s("gtr,moog").clip(1)
   .gain(.5)`}
 />
@@ -272,7 +272,7 @@ We can also declare different samples for different regions of the keyboard:
     'g2': 'moog/004_Mighty%20Moog%20G2.wav',
     'g3': 'moog/005_Mighty%20Moog%20G3.wav',
     'g4': 'moog/006_Mighty%20Moog%20G4.wav',
-  }}, 'github:tidalcycles/Dirt-Samples/master/');
+  }}, 'github:tidalcycles/dirt-samples');
 note("g2!2 <bb2 c3>!2, <c4@3 [<eb4 bb3> g4 f4]>")
   .s('moog').clip(1)
   .gain(.5).cpm(60)`}
@@ -287,7 +287,7 @@ With it, you can enter any sample name(s) to query from [freesound.org](https://
 
 <MiniRepl
   client:idle
-  tune={`await samples('shabda:bass:4,hihat:4,rimshot:2')
+  tune={`samples('shabda:bass:4,hihat:4,rimshot:2')
 stack(
   n("0 1 2 3 0 1 2 3").s('bass'),
   n("0 1*2 2 3*2").s('hihat'),
@@ -300,8 +300,8 @@ Note that the language code and the gender parameters are optional and default t
 
 <MiniRepl
   client:idle
-  tune={`await samples('shabda/speech:the_drum,forever')
-await samples('shabda/speech/fr-FR/m:magnifique')
+  tune={`samples('shabda/speech:the_drum,forever')
+samples('shabda/speech/fr-FR/m:magnifique')
 stack(
   s("the_drum*2").chop(16).speed(rand.range(0.85,1.1)),
   s("forever magnifique").slow(4).late(0.125)
diff --git a/website/src/pages/recipes/recipes.mdx b/website/src/pages/recipes/recipes.mdx
index b17df9a7..057743cb 100644
--- a/website/src/pages/recipes/recipes.mdx
+++ b/website/src/pages/recipes/recipes.mdx
@@ -60,7 +60,7 @@ A sample can be looped and chopped like this:
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:yaxu/clean-breaks/main')
+  tune={`samples('github:yaxu/clean-breaks')
 s("amen/4").fit().chop(32)`}
   punchcard
 />
@@ -71,7 +71,7 @@ Let's add randmized doubling + reversing:
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:yaxu/clean-breaks/main')
+  tune={`samples('github:yaxu/clean-breaks')
 s("amen/4").fit().chop(16).cut(1)
 .sometimesBy(.5, ply("2"))
 .sometimesBy(.25, mul(speed("-1")))`}
@@ -82,7 +82,7 @@ If we want to specify the order of samples, we can replace `chop` with `slice`:
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:yaxu/clean-breaks/main')
+  tune={`samples('github:yaxu/clean-breaks')
 s("amen/4").fit()
   .slice(8, "<0 1 2 3 4*2 5 6 [6 7]>*2")
   .cut(1).rarely(ply("2"))`}
@@ -93,7 +93,7 @@ If we use `splice` instead of `slice`, the speed adjusts to the duration of the
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:yaxu/clean-breaks/main')
+  tune={`samples('github:yaxu/clean-breaks')
 s("amen")
   .splice(8, "<0 1 2 3 4*2 5 6 [6 7]>*2")
   .cut(1).rarely(ply("2"))`}
@@ -213,7 +213,7 @@ Using `run` with `n`, we can rush through a sample bank:
 
 <MiniRepl
   client:visible
-  tune={`await samples('bubo:fox')
+  tune={`samples('bubo:fox')
 n(run(8)).s("ftabla")`}
   punchcard
 />
@@ -224,7 +224,7 @@ In this case, I hear the beginning at the third sample, which can be accounted f
 
 <MiniRepl
   client:visible
-  tune={`await samples('bubo:fox')
+  tune={`samples('bubo:fox')
 n(run(8)).s("ftabla").early(2/8)`}
 />
 
@@ -232,7 +232,7 @@ Let's add some randomness:
 
 <MiniRepl
   client:visible
-  tune={`await samples('bubo:fox')
+  tune={`samples('bubo:fox')
 n(run(8)).s("ftabla").early(2/8)
 .sometimes(mul(speed("1.5")))`}
 />
@@ -299,7 +299,7 @@ To simplify loading wavetables, any sample that starts with `wt_` will be looped
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:bubobubobubobubo/dough-waveforms/main')
+  tune={`samples('github:bubobubobubobubo/dough-waveforms')
 note("c eb g bb").s("wt_dbass").clip(2)`}
 />
 
@@ -307,7 +307,7 @@ Running through different wavetables can also give interesting variations:
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:bubobubobubobubo/dough-waveforms/main')
+  tune={`samples('github:bubobubobubobubo/dough-waveforms')
 note("c2*8").s("wt_dbass").n(run(8))`}
 />
 
@@ -315,7 +315,7 @@ note("c2*8").s("wt_dbass").n(run(8))`}
 
 <MiniRepl
   client:visible
-  tune={`await samples('github:bubobubobubobubo/dough-waveforms/main')
+  tune={`samples('github:bubobubobubobubo/dough-waveforms')
 note("c2*8").s("wt_dbass").n(run(8))
 .lpf(perlin.range(200,2000).slow(8))
 .lpenv(-3).lpa(.1).room(.5)`}
diff --git a/website/src/pages/recipes/rhythms.mdx b/website/src/pages/recipes/rhythms.mdx
index 144616c9..4a739262 100644
--- a/website/src/pages/recipes/rhythms.mdx
+++ b/website/src/pages/recipes/rhythms.mdx
@@ -8,7 +8,7 @@ import { MiniRepl } from '../../docs/MiniRepl';
 Note:
 
 - this has been (partly) translated from https://tidalcycles.org/docs/patternlib/howtos/buildrhythms
-- this only sounds good with `samples('github:tidalcycles/Dirt-Samples/master')` in prebake
+- this only sounds good with `samples('github:tidalcycles/dirt-samples')` in prebake
 
 # Build Rhythms
 
diff --git a/website/src/repl/prebake.mjs b/website/src/repl/prebake.mjs
index 2ce3a194..dc8d3c8e 100644
--- a/website/src/repl/prebake.mjs
+++ b/website/src/repl/prebake.mjs
@@ -115,13 +115,12 @@ export async function prebake() {
           'numbers/8.wav',
         ],
       },
-      'github:tidalcycles/Dirt-Samples/master/',
+      'github:tidalcycles/dirt-samples',
       {
         prebake: true,
       },
     ),
   ]);
-  // await samples('github:tidalcycles/Dirt-Samples/master');
 }
 
 const maxPan = noteToMidi('C8');
diff --git a/website/src/repl/tunes.mjs b/website/src/repl/tunes.mjs
index 66bf4787..fa7d9339 100644
--- a/website/src/repl/tunes.mjs
+++ b/website/src/repl/tunes.mjs
@@ -527,7 +527,7 @@ export const meltingsubmarine = `// "Melting submarine"
 // @license CC BY-NC-SA 4.0 https://creativecommons.org/licenses/by-nc-sa/4.0/
 // @by Felix Roos
 
-await samples('github:tidalcycles/Dirt-Samples/master/')
+samples('github:tidalcycles/dirt-samples')
 stack(
   s("bd:5,[~ <sd:1!3 sd:1(3,4,3)>],hh27(3,4,1)") // drums
   .speed(perlin.range(.7,.9)) // random sample speed variation
@@ -574,7 +574,7 @@ samples({
   sd: ['sd/rytm-01-classic.wav','sd/rytm-00-hard.wav'],
   hh: ['hh27/000_hh27closedhh.wav','hh/000_hh3closedhh.wav'],
   perc: ['perc/002_perc2.wav'],
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 
 chord("<C^7 Am7 Dm7 G7>*2").dict('lefthand').anchor("G4").voicing()
   .stack(n("0@6 [<1 2> <2 0> 1]@2").scale('C5 major'))
@@ -608,7 +608,7 @@ samples({
 bd: ['bd/BT0AADA.wav','bd/BT0AAD0.wav','bd/BT0A0DA.wav','bd/BT0A0D3.wav','bd/BT0A0D0.wav','bd/BT0A0A7.wav'],
 sd: ['sd/rytm-01-classic.wav','sd/rytm-00-hard.wav'],
 hh: ['hh27/000_hh27closedhh.wav','hh/000_hh3closedhh.wav'],
-}, 'github:tidalcycles/Dirt-Samples/master/');
+}, 'github:tidalcycles/dirt-samples');
 
 note("<8(3,8) <7 7*2> [4 5@3] 8>".sub(1) // sub 1 -> 1-indexed
 .layer(
@@ -797,7 +797,7 @@ export const amensister = `// "Amensister"
 // @license CC BY-NC-SA 4.0 https://creativecommons.org/licenses/by-nc-sa/4.0/
 // @by Felix Roos
 
-await samples('github:tidalcycles/Dirt-Samples/master')
+samples('github:tidalcycles/dirt-samples')
 
 stack(
   // amen
@@ -906,7 +906,7 @@ export const arpoon = `// "Arpoon"
 // @license CC BY-NC-SA 4.0 https://creativecommons.org/licenses/by-nc-sa/4.0/
 // @by Felix Roos
 
-await samples('github:tidalcycles/Dirt-Samples/master')
+samples('github:tidalcycles/dirt-samples')
 
 n("[0,3] 2 [1,3] 2".fast(3).lastOf(4, fast(2))).clip(2)
   .offset("<<1 2> 2 1 1>")

From 4e3d4a7060271a3941a26fa3efb42d55b4305a20 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 21 Feb 2024 15:34:25 +0100
Subject: [PATCH 11/27] hotfix: some samples were broken

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

diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index 3c3e670d..e7d1dae3 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -99,6 +99,27 @@ export const getLoadedBuffer = (url) => {
   return bufferCache[url];
 };
 
+function resolveSpecialPaths(base) {
+  if (base.startsWith('bubo:')) {
+    const [_, repo] = base.split(':');
+    base = `github:Bubobubobubobubo/dough-${repo}`;
+  }
+  return base;
+}
+
+function githubPath(base, subpath = '') {
+  if (!base.startsWith('github:')) {
+    throw new Error('expected "github:" at the start of pseudoUrl');
+  }
+  let [_, path] = base.split('github:');
+  path = path.endsWith('/') ? path.slice(0, -1) : path;
+  if (path.split('/').length === 2) {
+    // assume main as default branch if none set
+    path += '/main';
+  }
+  return `https://raw.githubusercontent.com/${path}/${subpath}`;
+}
+
 export const processSampleMap = (sampleMap, fn, baseUrl = sampleMap._base || '') => {
   return Object.entries(sampleMap).forEach(([key, value]) => {
     if (typeof value === 'string') {
@@ -108,15 +129,19 @@ export const processSampleMap = (sampleMap, fn, baseUrl = sampleMap._base || '')
       throw new Error('wrong sample map format for ' + key);
     }
     baseUrl = value._base || baseUrl;
-    const replaceUrl = (v) => (baseUrl + v).replace('github:', 'https://raw.githubusercontent.com/');
+    baseUrl = resolveSpecialPaths(baseUrl);
+    if (baseUrl.startsWith('github:')) {
+      baseUrl = githubPath(baseUrl, '');
+    }
+    const fullUrl = (v) => baseUrl + v;
     if (Array.isArray(value)) {
       //return [key, value.map(replaceUrl)];
-      value = value.map(replaceUrl);
+      value = value.map(fullUrl);
     } else {
       // must be object
       value = Object.fromEntries(
         Object.entries(value).map(([note, samples]) => {
-          return [note, (typeof samples === 'string' ? [samples] : samples).map(replaceUrl)];
+          return [note, (typeof samples === 'string' ? [samples] : samples).map(fullUrl)];
         }),
       );
     }
@@ -165,18 +190,9 @@ export const samples = async (sampleMap, baseUrl = sampleMap._base || '', option
     if (handler) {
       return handler(sampleMap);
     }
-    if (sampleMap.startsWith('bubo:')) {
-      const [_, repo] = sampleMap.split(':');
-      sampleMap = `github:Bubobubobubobubo/dough-${repo}`;
-    }
+    sampleMap = resolveSpecialPaths(sampleMap);
     if (sampleMap.startsWith('github:')) {
-      let [_, path] = sampleMap.split('github:');
-      path = path.endsWith('/') ? path.slice(0, -1) : path;
-      if (path.split('/').length === 2) {
-        // assume main as default branch if none set
-        path += '/main';
-      }
-      sampleMap = `https://raw.githubusercontent.com/${path}/strudel.json`;
+      sampleMap = githubPath(sampleMap, 'strudel.json');
     }
     if (sampleMap.startsWith('shabda:')) {
       let [_, path] = sampleMap.split('shabda:');

From f54aa3d82373b2397d0c589b35ad33293111341f Mon Sep 17 00:00:00 2001
From: eefano <77832+eefano@users.noreply.github.com>
Date: Thu, 22 Feb 2024 22:04:57 +0100
Subject: [PATCH 12/27] 'Enable Bracket Matching' option in Codemirror

---
 packages/codemirror/codemirror.mjs     | 7 ++++++-
 website/src/repl/Repl.css              | 5 +++++
 website/src/repl/panel/SettingsTab.jsx | 6 ++++++
 website/src/settings.mjs               | 2 ++
 4 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/packages/codemirror/codemirror.mjs b/packages/codemirror/codemirror.mjs
index 0eec08d1..36687a83 100644
--- a/packages/codemirror/codemirror.mjs
+++ b/packages/codemirror/codemirror.mjs
@@ -2,7 +2,7 @@ import { closeBrackets } from '@codemirror/autocomplete';
 // import { search, highlightSelectionMatches } from '@codemirror/search';
 import { history } from '@codemirror/commands';
 import { javascript } from '@codemirror/lang-javascript';
-import { defaultHighlightStyle, syntaxHighlighting } from '@codemirror/language';
+import { defaultHighlightStyle, syntaxHighlighting, bracketMatching } from '@codemirror/language';
 import { Compartment, EditorState, Prec } from '@codemirror/state';
 import {
   EditorView,
@@ -24,6 +24,7 @@ import { persistentAtom } from '@nanostores/persistent';
 
 const extensions = {
   isLineWrappingEnabled: (on) => (on ? EditorView.lineWrapping : []),
+  isBracketMatchingEnabled: (on) => (on ? bracketMatching() : []),
   isLineNumbersDisplayed: (on) => (on ? lineNumbers() : []),
   theme,
   isAutoCompletionEnabled,
@@ -37,6 +38,7 @@ const compartments = Object.fromEntries(Object.keys(extensions).map((key) => [ke
 
 export const defaultSettings = {
   keybindings: 'codemirror',
+  isBracketMatchingEnabled: false,
   isLineNumbersDisplayed: true,
   isActiveLineHighlighted: false,
   isAutoCompletionEnabled: false,
@@ -290,6 +292,9 @@ export class StrudelMirror {
   setLineWrappingEnabled(enabled) {
     this.reconfigureExtension('isLineWrappingEnabled', enabled);
   }
+  setBracketMatchingEnabled(enabled) {
+    this.reconfigureExtension('isBracketMatchingEnabled', enabled);
+  }
   setLineNumbersDisplayed(enabled) {
     this.reconfigureExtension('isLineNumbersDisplayed', enabled);
   }
diff --git a/website/src/repl/Repl.css b/website/src/repl/Repl.css
index 2d97d8a2..e2488b52 100644
--- a/website/src/repl/Repl.css
+++ b/website/src/repl/Repl.css
@@ -64,3 +64,8 @@
 #code .cm-focused {
   outline: none;
 }
+
+#code .cm-matchingBracket {
+  text-decoration: underline 0.18rem;
+  text-underline-offset: 0.25rem;
+}
diff --git a/website/src/repl/panel/SettingsTab.jsx b/website/src/repl/panel/SettingsTab.jsx
index dc221300..7b968ad5 100644
--- a/website/src/repl/panel/SettingsTab.jsx
+++ b/website/src/repl/panel/SettingsTab.jsx
@@ -77,6 +77,7 @@ export function SettingsTab({ started }) {
   const {
     theme,
     keybindings,
+    isBracketMatchingEnabled,
     isLineNumbersDisplayed,
     isPatternHighlightingEnabled,
     isActiveLineHighlighted,
@@ -137,6 +138,11 @@ export function SettingsTab({ started }) {
         ></ButtonGroup>
       </FormItem>
       <FormItem label="Code Settings">
+        <Checkbox
+          label="Enable bracket matching"
+          onChange={(cbEvent) => settingsMap.setKey('isBracketMatchingEnabled', cbEvent.target.checked)}
+          value={isBracketMatchingEnabled}
+        />
         <Checkbox
           label="Display line numbers"
           onChange={(cbEvent) => settingsMap.setKey('isLineNumbersDisplayed', cbEvent.target.checked)}
diff --git a/website/src/settings.mjs b/website/src/settings.mjs
index 27888800..6e768378 100644
--- a/website/src/settings.mjs
+++ b/website/src/settings.mjs
@@ -7,6 +7,7 @@ export const defaultAudioDeviceName = 'System Standard';
 export const defaultSettings = {
   activeFooter: 'intro',
   keybindings: 'codemirror',
+  isBracketMatchingEnabled: false,
   isLineNumbersDisplayed: true,
   isActiveLineHighlighted: true,
   isAutoCompletionEnabled: false,
@@ -40,6 +41,7 @@ export function useSettings() {
   return {
     ...state,
     isZen: [true, 'true'].includes(state.isZen) ? true : false,
+    isBracketMatchingEnabled: [true, 'true'].includes(state.isBracketMatchingEnabled) ? true : false,
     isLineNumbersDisplayed: [true, 'true'].includes(state.isLineNumbersDisplayed) ? true : false,
     isActiveLineHighlighted: [true, 'true'].includes(state.isActiveLineHighlighted) ? true : false,
     isAutoCompletionEnabled: [true, 'true'].includes(state.isAutoCompletionEnabled) ? true : false,

From 8af40a9c615e3e2d13c7aaf51544a8bfc1b3bedd Mon Sep 17 00:00:00 2001
From: eefano <77832+eefano@users.noreply.github.com>
Date: Thu, 22 Feb 2024 23:35:00 +0100
Subject: [PATCH 13/27] added <> for mininotation

---
 packages/codemirror/codemirror.mjs | 2 +-
 website/src/repl/Repl.css          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/codemirror/codemirror.mjs b/packages/codemirror/codemirror.mjs
index 36687a83..7e66c49f 100644
--- a/packages/codemirror/codemirror.mjs
+++ b/packages/codemirror/codemirror.mjs
@@ -24,7 +24,7 @@ import { persistentAtom } from '@nanostores/persistent';
 
 const extensions = {
   isLineWrappingEnabled: (on) => (on ? EditorView.lineWrapping : []),
-  isBracketMatchingEnabled: (on) => (on ? bracketMatching() : []),
+  isBracketMatchingEnabled: (on) => (on ? bracketMatching({brackets: "()[]{}<>"}) : []),
   isLineNumbersDisplayed: (on) => (on ? lineNumbers() : []),
   theme,
   isAutoCompletionEnabled,
diff --git a/website/src/repl/Repl.css b/website/src/repl/Repl.css
index e2488b52..3e13ff5a 100644
--- a/website/src/repl/Repl.css
+++ b/website/src/repl/Repl.css
@@ -67,5 +67,5 @@
 
 #code .cm-matchingBracket {
   text-decoration: underline 0.18rem;
-  text-underline-offset: 0.25rem;
+  text-underline-offset: 0.22rem;
 }

From e8b674baddde7868fa37e0af0f25755a4105eaf6 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:16:54 +0100
Subject: [PATCH 14/27] add iife build to web package

---
 packages/web/package.json   |  3 ++-
 packages/web/vite.config.js | 14 +++++++++++---
 pnpm-lock.yaml              |  6 +++---
 3 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/packages/web/package.json b/packages/web/package.json
index 68ced2d2..e0446a88 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -36,7 +36,8 @@
     "@strudel/mini": "workspace:*",
     "@strudel/tonal": "workspace:*",
     "@strudel/transpiler": "workspace:*",
-    "@strudel/webaudio": "workspace:*"
+    "@strudel/webaudio": "workspace:*",
+    "@rollup/plugin-replace": "^5.0.5"
   },
   "devDependencies": {
     "vite": "^5.0.10"
diff --git a/packages/web/vite.config.js b/packages/web/vite.config.js
index 7fe99498..bd14f5a9 100644
--- a/packages/web/vite.config.js
+++ b/packages/web/vite.config.js
@@ -1,6 +1,7 @@
 import { defineConfig } from 'vite';
 import { dependencies } from './package.json';
 import { resolve } from 'path';
+import replace from '@rollup/plugin-replace';
 
 // https://vitejs.dev/config/
 export default defineConfig({
@@ -8,11 +9,18 @@ export default defineConfig({
   build: {
     lib: {
       entry: resolve(__dirname, 'web.mjs'),
-      formats: ['es'],
-      fileName: (ext) => ({ es: 'index.mjs' })[ext],
+      name: 'strudel',
+      formats: ['es', 'iife'],
+      fileName: (ext) => ({ es: 'index.mjs', iife: 'index.js' })[ext],
     },
     rollupOptions: {
-      external: [...Object.keys(dependencies)],
+      // external: [...Object.keys(dependencies)],
+      plugins: [
+        replace({
+          'process.env.NODE_ENV': JSON.stringify('production'),
+          preventAssignment: true,
+        }),
+      ],
     },
     target: 'esnext',
   },
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index a6ccb762..4b31cc8b 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -430,6 +430,9 @@ importers:
 
   packages/web:
     dependencies:
+      '@rollup/plugin-replace':
+        specifier: ^5.0.5
+        version: 5.0.5
       '@strudel/core':
         specifier: workspace:*
         version: link:../core
@@ -3691,7 +3694,6 @@ packages:
     dependencies:
       '@rollup/pluginutils': 5.1.0
       magic-string: 0.30.5
-    dev: true
 
   /@rollup/pluginutils@3.1.0(rollup@2.79.1):
     resolution: {integrity: sha512-GksZ6pr6TpIjHm8h9lSQ8pi8BE9VeubNT0OMJ3B5uZJ8pz73NPiqOtCog/x2/QzM1ENChPKxMDhiQuRHsqc+lg==}
@@ -3717,7 +3719,6 @@ packages:
       '@types/estree': 1.0.0
       estree-walker: 2.0.2
       picomatch: 2.3.1
-    dev: true
 
   /@rollup/rollup-android-arm-eabi@4.9.2:
     resolution: {integrity: sha512-RKzxFxBHq9ysZ83fn8Iduv3A283K7zPPYuhL/z9CQuyFrjwpErJx0h4aeb/bnJ+q29GRLgJpY66ceQ/Wcsn3wA==}
@@ -7118,7 +7119,6 @@ packages:
 
   /estree-walker@2.0.2:
     resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
-    dev: true
 
   /estree-walker@3.0.3:
     resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}

From 5419ca431b2f243c3c53c517ee316fda5d81e5da Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:17:11 +0100
Subject: [PATCH 15/27] bump web package version

---
 packages/web/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/web/package.json b/packages/web/package.json
index e0446a88..3ce40736 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@strudel/web",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Easy to setup, opiniated bundle of Strudel for the browser.",
   "main": "web.mjs",
   "publishConfig": {

From a89e87ca2e9d23880e32db41e9b3d6cac37f39bd Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:21:59 +0100
Subject: [PATCH 16/27] add web package example using script tag

---
 examples/buildless/web.html | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 examples/buildless/web.html

diff --git a/examples/buildless/web.html b/examples/buildless/web.html
new file mode 100644
index 00000000..785a6071
--- /dev/null
+++ b/examples/buildless/web.html
@@ -0,0 +1,9 @@
+<script src="https://unpkg.com/@strudel/web@1.0.2/dist/index.js"></script>
+<button id="play">PLAY</button>
+<script>
+  initStrudel({
+    prebake: () => samples('github:tidalcycles/dirt-samples'),
+  });
+
+  document.getElementById('play').addEventListener('click', () => s('bd sd').play());
+</script>

From 2854f0cf347e38413989e420bf803bffe3a67e7b Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:28:43 +0100
Subject: [PATCH 17/27] try different main / module setting + bump

---
 packages/web/package.json | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/web/package.json b/packages/web/package.json
index 3ce40736..45946398 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -1,10 +1,11 @@
 {
   "name": "@strudel/web",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Easy to setup, opiniated bundle of Strudel for the browser.",
-  "main": "web.mjs",
+  "module": "web.mjs",
   "publishConfig": {
-    "main": "dist/index.mjs"
+    "main": "dist/index.js",
+    "module": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",

From c23d7850c79a426a5cd6a78f06cbb465480de00a Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:30:07 +0100
Subject: [PATCH 18/27] simplify web example

---
 examples/buildless/web.html | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/examples/buildless/web.html b/examples/buildless/web.html
index 785a6071..dc2a4c33 100644
--- a/examples/buildless/web.html
+++ b/examples/buildless/web.html
@@ -1,9 +1,8 @@
-<script src="https://unpkg.com/@strudel/web@1.0.2/dist/index.js"></script>
+<script src="https://unpkg.com/@strudel/web@1.0.3"></script>
 <button id="play">PLAY</button>
 <script>
   initStrudel({
     prebake: () => samples('github:tidalcycles/dirt-samples'),
   });
-
   document.getElementById('play').addEventListener('click', () => s('bd sd').play());
 </script>

From 6d9327aebc2eec1be619f56112d6d5d0475769b1 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:30:29 +0100
Subject: [PATCH 19/27] adapt repl package similar to web package

---
 packages/repl/package.json | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/repl/package.json b/packages/repl/package.json
index eae203f1..e6bce6d5 100644
--- a/packages/repl/package.json
+++ b/packages/repl/package.json
@@ -1,10 +1,11 @@
 {
   "name": "@strudel/repl",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Strudel REPL as a Web Component",
-  "main": "index.mjs",
+  "module": "index.mjs",
   "publishConfig": {
-    "main": "dist/index.mjs"
+    "main": "dist/index.js",
+    "module": "dist/index.mjs"
   },
   "scripts": {
     "build": "vite build",

From 058e554b0f78a464059e6ddf515c22071014b7d6 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Fri, 23 Feb 2024 14:33:07 +0100
Subject: [PATCH 20/27] update example

---
 examples/buildless/web-component-no-iframe.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/buildless/web-component-no-iframe.html b/examples/buildless/web-component-no-iframe.html
index 6c86d282..8afa85cb 100644
--- a/examples/buildless/web-component-no-iframe.html
+++ b/examples/buildless/web-component-no-iframe.html
@@ -1,4 +1,4 @@
-<script src="https://unpkg.com/@strudel/repl@0.9.4"></script>
+<script src="https://unpkg.com/@strudel/repl@1.0.2"></script>
 <strudel-editor>
   <!--
 // @date 23-08-15

From 22e3067b8caa29e88be468ee2dc324636fa92bfc Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sun, 25 Feb 2024 13:16:53 +0100
Subject: [PATCH 21/27] set bracket matching true by default

---
 examples/buildless/headless-simple.html | 2 +-
 website/src/settings.mjs                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/buildless/headless-simple.html b/examples/buildless/headless-simple.html
index 013cc87b..a9d5248a 100644
--- a/examples/buildless/headless-simple.html
+++ b/examples/buildless/headless-simple.html
@@ -5,6 +5,6 @@
   import { initStrudel } from 'https://cdn.skypack.dev/@strudel/web@0.8.2';
 
   initStrudel();
-  document.getElementById('play').addEventListener('click', () => evaluate('note("c a f e").jux(rev)'));
+  document.getElementById('play').addEventListener('click', () => strudel.evaluate('note("c a f e").jux(rev)'));
   document.getElementById('play').addEventListener('stop', () => hush());
 </script>
diff --git a/website/src/settings.mjs b/website/src/settings.mjs
index 6e768378..34aca701 100644
--- a/website/src/settings.mjs
+++ b/website/src/settings.mjs
@@ -7,7 +7,7 @@ export const defaultAudioDeviceName = 'System Standard';
 export const defaultSettings = {
   activeFooter: 'intro',
   keybindings: 'codemirror',
-  isBracketMatchingEnabled: false,
+  isBracketMatchingEnabled: true,
   isLineNumbersDisplayed: true,
   isActiveLineHighlighted: true,
   isAutoCompletionEnabled: false,

From b0b41e6718b353227a595a220e535ba03c3a6e4b Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sun, 25 Feb 2024 13:17:29 +0100
Subject: [PATCH 22/27] revert unintended change

---
 examples/buildless/headless-simple.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/buildless/headless-simple.html b/examples/buildless/headless-simple.html
index a9d5248a..013cc87b 100644
--- a/examples/buildless/headless-simple.html
+++ b/examples/buildless/headless-simple.html
@@ -5,6 +5,6 @@
   import { initStrudel } from 'https://cdn.skypack.dev/@strudel/web@0.8.2';
 
   initStrudel();
-  document.getElementById('play').addEventListener('click', () => strudel.evaluate('note("c a f e").jux(rev)'));
+  document.getElementById('play').addEventListener('click', () => evaluate('note("c a f e").jux(rev)'));
   document.getElementById('play').addEventListener('stop', () => hush());
 </script>

From 7557952155612d357d60432e97c221b35b6c1467 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sun, 25 Feb 2024 13:17:52 +0100
Subject: [PATCH 23/27] format

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

diff --git a/packages/codemirror/codemirror.mjs b/packages/codemirror/codemirror.mjs
index 7e66c49f..4470173b 100644
--- a/packages/codemirror/codemirror.mjs
+++ b/packages/codemirror/codemirror.mjs
@@ -24,7 +24,7 @@ import { persistentAtom } from '@nanostores/persistent';
 
 const extensions = {
   isLineWrappingEnabled: (on) => (on ? EditorView.lineWrapping : []),
-  isBracketMatchingEnabled: (on) => (on ? bracketMatching({brackets: "()[]{}<>"}) : []),
+  isBracketMatchingEnabled: (on) => (on ? bracketMatching({ brackets: '()[]{}<>' }) : []),
   isLineNumbersDisplayed: (on) => (on ? lineNumbers() : []),
   theme,
   isAutoCompletionEnabled,

From b9247db001d4f68cb6a0164c79b20e8501ff03f8 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Sun, 25 Feb 2024 15:09:15 +0100
Subject: [PATCH 24/27] fix: reset global fx on pattern change

---
 packages/superdough/superdough.mjs |  5 +++++
 website/src/repl/Repl.jsx          | 10 +++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/packages/superdough/superdough.mjs b/packages/superdough/superdough.mjs
index f5674f2c..4d67e038 100644
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@@ -253,6 +253,11 @@ function effectSend(input, effect, wet) {
   return send;
 }
 
+export function resetGlobalEffects() {
+  delays = {};
+  reverbs = {};
+}
+
 export const superdough = async (value, deadline, hapDuration) => {
   const ac = getAudioContext();
   if (typeof value !== 'object') {
diff --git a/website/src/repl/Repl.jsx b/website/src/repl/Repl.jsx
index 57bdb1d1..c5a8fa09 100644
--- a/website/src/repl/Repl.jsx
+++ b/website/src/repl/Repl.jsx
@@ -7,7 +7,13 @@ This program is free software: you can redistribute it and/or modify it under th
 import { code2hash, getDrawContext, logger, silence } from '@strudel/core';
 import cx from '@src/cx.mjs';
 import { transpiler } from '@strudel/transpiler';
-import { getAudioContext, initAudioOnFirstClick, webaudioOutput } from '@strudel/webaudio';
+import {
+  getAudioContext,
+  initAudioOnFirstClick,
+  webaudioOutput,
+  resetGlobalEffects,
+  resetLoadedSounds,
+} from '@strudel/webaudio';
 import { defaultAudioDeviceName } from '../settings.mjs';
 import { getAudioDevices, setAudioDevice } from './util.mjs';
 import { StrudelMirror, defaultSettings } from '@strudel/codemirror';
@@ -157,6 +163,7 @@ export function Repl({ embedded = false }) {
   };
 
   const resetEditor = async () => {
+    resetGlobalEffects();
     clearCanvas();
     resetLoadedSounds();
     editorRef.current.repl.setCps(0.5);
@@ -183,6 +190,7 @@ export function Repl({ embedded = false }) {
     setViewingPatternData(patternData);
     clearCanvas();
     resetLoadedSounds();
+    resetGlobalEffects();
     await prebake(); // declare default samples
     editorRef.current.setCode(code);
     editorRef.current.repl.evaluate(code);

From 8efadd2547111e3905b967250c3977512f1b3c29 Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 28 Feb 2024 00:34:39 +0100
Subject: [PATCH 25/27] refactor: controls are now exported directly

---
 packages/core/controls.mjs | 2869 ++++++++++++++++++------------------
 packages/core/index.mjs    |    3 +-
 2 files changed, 1451 insertions(+), 1421 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index ae7b6f44..42fa8cba 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -5,1413 +5,8 @@ This program is free software: you can redistribute it and/or modify it under th
 */
 
 import { Pattern, register, sequence } from './pattern.mjs';
-import { zipWith } from './util.mjs';
 
-const controls = {};
-const generic_params = [
-  /**
-   * Select a sound / sample by name. When using mininotation, you can also optionally supply 'n' and 'gain' parameters
-   * separated by ':'.
-   *
-   * @name s
-   * @param {string | Pattern} sound The sound / pattern of sounds to pick
-   * @synonyms sound
-   * @example
-   * s("bd hh")
-   * @example
-   * s("bd:0 bd:1 bd:0:0.3 bd:1:1.4")
-   *
-   */
-  [['s', 'n', 'gain'], 'sound'],
-  /**
-   * Define a custom webaudio node to use as a sound source.
-   *
-   * @name source
-   * @param {function} getSource
-   * @synonyms src
-   *
-   */
-  ['source', 'src'],
-  /**
-   * Selects the given index from the sample map.
-   * Numbers too high will wrap around.
-   * `n` can also be used to play midi numbers, but it is recommended to use `note` instead.
-   *
-   * @name n
-   * @param {number | Pattern} value sample index starting from 0
-   * @example
-   * s("bd sd [~ bd] sd,hh*6").n("<0 1>")
-   */
-  // also see https://github.com/tidalcycles/strudel/pull/63
-  ['n'],
-  /**
-   * Plays the given note name or midi number. A note name consists of
-   *
-   * - a letter (a-g or A-G)
-   * - optional accidentals (b or #)
-   * - optional octave number (0-9). Defaults to 3
-   *
-   * Examples of valid note names: `c`, `bb`, `Bb`, `f#`, `c3`, `A4`, `Eb2`, `c#5`
-   *
-   * You can also use midi numbers instead of note names, where 69 is mapped to A4 440Hz in 12EDO.
-   *
-   * @name note
-   * @example
-   * note("c a f e")
-   * @example
-   * note("c4 a4 f4 e4")
-   * @example
-   * note("60 69 65 64")
-   */
-  [['note', 'n']],
-
-  /**
-   * A pattern of numbers that speed up (or slow down) samples while they play. Currently only supported by osc / superdirt.
-   *
-   * @name accelerate
-   * @param {number | Pattern} amount acceleration.
-   * @superdirtOnly
-   * @example
-   * s("sax").accelerate("<0 1 2 4 8 16>").slow(2).osc()
-   *
-   */
-  ['accelerate'],
-  /**
-   * Controls the gain by an exponential amount.
-   *
-   * @name gain
-   * @param {number | Pattern} amount gain.
-   * @example
-   * s("hh*8").gain(".4!2 1 .4!2 1 .4 1").fast(2)
-   *
-   */
-  ['gain'],
-  /**
-   * Gain applied after all effects have been processed.
-   *
-   * @name postgain
-   * @example
-   * s("bd sd [~ bd] sd,hh*8")
-   * .compressor("-20:20:10:.002:.02").postgain(1.5)
-   *
-   */
-  ['postgain'],
-  /**
-   * Like `gain`, but linear.
-   *
-   * @name amp
-   * @param {number | Pattern} amount gain.
-   * @superdirtOnly
-   * @example
-   * s("bd*8").amp(".1*2 .5 .1*2 .5 .1 .5").osc()
-   *
-   */
-  ['amp'],
-  /**
-   * Amplitude envelope attack time: Specifies how long it takes for the sound to reach its peak value, relative to the onset.
-   *
-   * @name attack
-   * @param {number | Pattern} attack time in seconds.
-   * @synonyms att
-   * @example
-   * note("c3 e3 f3 g3").attack("<0 .1 .5>")
-   *
-   */
-  ['attack', 'att'],
-
-  /**
-   * Sets the Frequency Modulation Harmonicity Ratio.
-   * Controls the timbre of the sound.
-   * Whole numbers and simple ratios sound more natural,
-   * while decimal numbers and complex ratios sound metallic.
-   *
-   * @name fmh
-   * @param {number | Pattern} harmonicity
-   * @example
-   * note("c e g b g e")
-   * .fm(4)
-   * .fmh("<1 2 1.5 1.61>")
-   * .scope()
-   *
-   */
-  [['fmh', 'fmi'], 'fmh'],
-  /**
-   * Sets the Frequency Modulation of the synth.
-   * Controls the modulation index, which defines the brightness of the sound.
-   *
-   * @name fm
-   * @param {number | Pattern} brightness modulation index
-   * @synonyms fmi
-   * @example
-   * note("c e g b g e")
-   * .fm("<0 1 2 8 32>")
-   * .scope()
-   *
-   */
-  [['fmi', 'fmh'], 'fm'],
-  // fm envelope
-  /**
-   * Ramp type of fm envelope. Exp might be a bit broken..
-   *
-   * @name fmenv
-   * @param {number | Pattern} type lin | exp
-   * @example
-   * note("c e g b g e")
-   * .fm(4)
-   * .fmdecay(.2)
-   * .fmsustain(0)
-   * .fmenv("<exp lin>")
-   * .scope()
-   *
-   */
-  ['fmenv'],
-  /**
-   * Attack time for the FM envelope: time it takes to reach maximum modulation
-   *
-   * @name fmattack
-   * @param {number | Pattern} time attack time
-   * @example
-   * note("c e g b g e")
-   * .fm(4)
-   * .fmattack("<0 .05 .1 .2>")
-   * .scope()
-   *
-   */
-  ['fmattack'],
-  /**
-   * Decay time for the FM envelope: seconds until the sustain level is reached after the attack phase.
-   *
-   * @name fmdecay
-   * @param {number | Pattern} time decay time
-   * @example
-   * note("c e g b g e")
-   * .fm(4)
-   * .fmdecay("<.01 .05 .1 .2>")
-   * .fmsustain(.4)
-   * .scope()
-   *
-   */
-  ['fmdecay'],
-  /**
-   * Sustain level for the FM envelope: how much modulation is applied after the decay phase
-   *
-   * @name fmsustain
-   * @param {number | Pattern} level sustain level
-   * @example
-   * note("c e g b g e")
-   * .fm(4)
-   * .fmdecay(.1)
-   * .fmsustain("<1 .75 .5 0>")
-   * .scope()
-   *
-   */
-  ['fmsustain'],
-  // these are not really useful... skipping for now
-  ['fmrelease'],
-  ['fmvelocity'],
-
-  /**
-   * Select the sound bank to use. To be used together with `s`. The bank name (+ "_") will be prepended to the value of `s`.
-   *
-   * @name bank
-   * @param {string | Pattern} bank the name of the bank
-   * @example
-   * s("bd sd [~ bd] sd").bank('RolandTR909') // = s("RolandTR909_bd RolandTR909_sd")
-   *
-   */
-  ['bank'],
-
-  ['analyze'], // analyser node send amount 0 - 1 (used by scope)
-  ['fft'], // fftSize of analyser
-
-  /**
-   * Amplitude envelope decay time: the time it takes after the attack time to reach the sustain level.
-   * Note that the decay is only audible if the sustain value is lower than 1.
-   *
-   * @name decay
-   * @param {number | Pattern} time decay time in seconds
-   * @example
-   * note("c3 e3 f3 g3").decay("<.1 .2 .3 .4>").sustain(0)
-   *
-   */
-  ['decay', 'dec'],
-  /**
-   * Amplitude envelope sustain level: The level which is reached after attack / decay, being sustained until the offset.
-   *
-   * @name sustain
-   * @param {number | Pattern} gain sustain level between 0 and 1
-   * @synonyms sus
-   * @example
-   * note("c3 e3 f3 g3").decay(.2).sustain("<0 .1 .4 .6 1>")
-   *
-   */
-  ['sustain', 'sus'],
-  /**
-   * Amplitude envelope release time: The time it takes after the offset to go from sustain level to zero.
-   *
-   * @name release
-   * @param {number | Pattern} time release time in seconds
-   * @synonyms rel
-   * @example
-   * note("c3 e3 g3 c4").release("<0 .1 .4 .6 1>/2")
-   *
-   */
-  ['release', 'rel'],
-  ['hold'],
-  // TODO: in tidal, it seems to be normalized
-  /**
-   * Sets the center frequency of the **b**and-**p**ass **f**ilter. When using mininotation, you
-   * can also optionally supply the 'bpq' parameter separated by ':'.
-   *
-   * @name bpf
-   * @param {number | Pattern} frequency center frequency
-   * @synonyms bandf, bp
-   * @example
-   * s("bd sd [~ bd] sd,hh*6").bpf("<1000 2000 4000 8000>")
-   *
-   */
-  [['bandf', 'bandq', 'bpenv'], 'bpf', 'bp'],
-  // TODO: in tidal, it seems to be normalized
-  /**
-   * Sets the **b**and-**p**ass **q**-factor (resonance).
-   *
-   * @name bpq
-   * @param {number | Pattern} q q factor
-   * @synonyms bandq
-   * @example
-   * s("bd sd [~ bd] sd").bpf(500).bpq("<0 1 2 3>")
-   *
-   */
-  // currently an alias of 'bandq' https://github.com/tidalcycles/strudel/issues/496
-  // ['bpq'],
-  ['bandq', 'bpq'],
-  /**
-   * a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
-   *
-   * @memberof Pattern
-   * @name begin
-   * @param {number | Pattern} amount between 0 and 1, where 1 is the length of the sample
-   * @example
-   * samples({ rave: 'rave/AREUREADY.wav' }, 'github:tidalcycles/dirt-samples')
-   * s("rave").begin("<0 .25 .5 .75>").fast(2)
-   *
-   */
-  ['begin'],
-  /**
-   * The same as .begin, but cuts off the end off each sample.
-   *
-   * @memberof Pattern
-   * @name end
-   * @param {number | Pattern} length 1 = whole sample, .5 = half sample, .25 = quarter sample etc..
-   * @example
-   * s("bd*2,oh*4").end("<.1 .2 .5 1>").fast(2)
-   *
-   */
-  ['end'],
-  /**
-   * Loops the sample.
-   * Note that the tempo of the loop is not synced with the cycle tempo.
-   * To change the loop region, use loopBegin / loopEnd.
-   *
-   * @name loop
-   * @param {number | Pattern} on If 1, the sample is looped
-   * @example
-   * s("casio").loop(1)
-   *
-   */
-  ['loop'],
-  /**
-   * Begin to loop at a specific point in the sample (inbetween `begin` and `end`).
-   * Note that the loop point must be inbetween `begin` and `end`, and before `loopEnd`!
-   * Note: Samples starting with wt_ will automatically loop! (wt = wavetable)
-   *
-   * @name loopBegin
-   * @param {number | Pattern} time between 0 and 1, where 1 is the length of the sample
-   * @synonyms loopb
-   * @example
-   * s("space").loop(1)
-   * .loopBegin("<0 .125 .25>").scope()
-   */
-  ['loopBegin', 'loopb'],
-  /**
-   *
-   * End the looping section at a specific point in the sample (inbetween `begin` and `end`).
-   * Note that the loop point must be inbetween `begin` and `end`, and after `loopBegin`!
-   *
-   * @name loopEnd
-   * @param {number | Pattern} time between 0 and 1, where 1 is the length of the sample
-   * @synonyms loope
-   * @example
-   * s("space").loop(1)
-   * .loopEnd("<1 .75 .5 .25>").scope()
-   */
-  ['loopEnd', 'loope'],
-  /**
-   * bit crusher effect.
-   *
-   * @name crush
-   * @param {number | Pattern} depth between 1 (for drastic reduction in bit-depth) to 16 (for barely no reduction).
-   * @example
-   * s("<bd sd>,hh*3").fast(2).crush("<16 8 7 6 5 4 3 2>")
-   *
-   */
-  // TODO: currently duplicated with "native" legato
-  // TODO: superdirt legato will do more: https://youtu.be/dQPmE1WaD1k?t=419
-  /**
-   * a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
-   *
-   * @name legato
-   * @param {number | Pattern} duration between 0 and 1, where 1 is the length of the whole hap time
-   * @noAutocomplete
-   * @example
-   * "c4 eb4 g4 bb4".legato("<0.125 .25 .5 .75 1 2 4>")
-   *
-   */
-  // ['legato'],
-  // ['clhatdecay'],
-  ['crush'],
-  /**
-   * fake-resampling for lowering the sample rate. Caution: This effect seems to only work in chromium based browsers
-   *
-   * @name coarse
-   * @param {number | Pattern} factor 1 for original 2 for half, 3 for a third and so on.
-   * @example
-   * s("bd sd [~ bd] sd,hh*8").coarse("<1 4 8 16 32>")
-   *
-   */
-  ['coarse'],
-
-  /**
-   * 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("3:4")
-   *
-   */
-  ['channels', 'ch'],
-
-  ['phaserrate', 'phasr'], // superdirt only
-
-  /**
-   * Phaser audio effect that approximates popular guitar pedals.
-   *
-   * @name phaser
-   * @synonyms ph
-   * @param {number | Pattern} speed speed of modulation
-   * @example
-   * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
-   * .phaser("<1 2 4 8>")
-   *
-   */
-  [['phaser', 'phaserdepth', 'phasercenter', 'phasersweep'], 'ph'],
-
-  /**
-   * The frequency sweep range of the lfo for the phaser effect. Defaults to 2000
-   *
-   * @name phasersweep
-   * @synonyms phs
-   * @param {number | Pattern} phasersweep most useful values are between 0 and 4000
-   * @example
-   * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
-   * .phaser(2).phasersweep("<800 2000 4000>")
-   *
-   */
-  ['phasersweep', 'phs'],
-
-  /**
-   *  The center frequency of the phaser in HZ. Defaults to 1000
-   *
-   * @name phasercenter
-   * @synonyms phc
-   * @param {number | Pattern} centerfrequency in HZ
-   * @example
-   * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
-   * .phaser(2).phasercenter("<800 2000 4000>")
-   *
-   */
-
-  ['phasercenter', 'phc'],
-
-  /**
-   * The amount the signal is affected by the phaser effect. Defaults to 0.75
-   *
-   * @name phaserdepth
-   * @synonyms phd
-   * @param {number | Pattern} depth number between 0 and 1
-   * @example
-   * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
-   * .phaser(2).phaserdepth("<0 .5 .75 1>")
-   *
-   */
-  ['phaserdepth', 'phd', 'phasdp'], // also a superdirt control
-
-  /**
-   * choose the channel the pattern is sent to in superdirt
-   *
-   * @name channel
-   * @param {number | Pattern} channel channel number
-   *
-   */
-  ['channel'],
-  /**
-   * In the style of classic drum-machines, `cut` will stop a playing sample as soon as another samples with in same cutgroup is to be played. An example would be an open hi-hat followed by a closed one, essentially muting the open.
-   *
-   * @name cut
-   * @param {number | Pattern} group cut group number
-   * @example
-   * s("[oh hh]*4").cut(1)
-   *
-   */
-  ['cut'],
-  /**
-   * Applies the cutoff frequency of the **l**ow-**p**ass **f**ilter.
-   *
-   * When using mininotation, you can also optionally add the 'lpq' parameter, separated by ':'.
-   *
-   * @name lpf
-   * @param {number | Pattern} frequency audible between 0 and 20000
-   * @synonyms cutoff, ctf, lp
-   * @example
-   * s("bd sd [~ bd] sd,hh*6").lpf("<4000 2000 1000 500 200 100>")
-   * @example
-   * s("bd*16").lpf("1000:0 1000:10 1000:20 1000:30")
-   *
-   */
-  [['cutoff', 'resonance', 'lpenv'], 'ctf', 'lpf', 'lp'],
-
-  /**
-   * Sets the lowpass filter envelope modulation depth.
-   * @name lpenv
-   * @param {number | Pattern} modulation depth of the lowpass filter envelope between 0 and _n_
-   * @synonyms lpe
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .lpf(500)
-   * .lpa(.5)
-   * .lpenv("<4 2 1 0 -1 -2 -4>/4")
-   */
-  ['lpenv', 'lpe'],
-  /**
-   * Sets the highpass filter envelope modulation depth.
-   * @name hpenv
-   * @param {number | Pattern} modulation depth of the highpass filter envelope between 0 and _n_
-   * @synonyms hpe
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .hpf(500)
-   * .hpa(.5)
-   * .hpenv("<4 2 1 0 -1 -2 -4>/4")
-   */
-  ['hpenv', 'hpe'],
-  /**
-   * Sets the bandpass filter envelope modulation depth.
-   * @name bpenv
-   * @param {number | Pattern} modulation depth of the bandpass filter envelope between 0 and _n_
-   * @synonyms bpe
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .bpf(500)
-   * .bpa(.5)
-   * .bpenv("<4 2 1 0 -1 -2 -4>/4")
-   */
-  ['bpenv', 'bpe'],
-  /**
-   * Sets the attack duration for the lowpass filter envelope.
-   * @name lpattack
-   * @param {number | Pattern} attack time of the filter envelope
-   * @synonyms lpa
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .lpf(500)
-   * .lpa("<.5 .25 .1 .01>/4")
-   * .lpenv(4)
-   */
-  ['lpattack', 'lpa'],
-  /**
-   * Sets the attack duration for the highpass filter envelope.
-   * @name hpattack
-   * @param {number | Pattern} attack time of the highpass filter envelope
-   * @synonyms hpa
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .hpf(500)
-   * .hpa("<.5 .25 .1 .01>/4")
-   * .hpenv(4)
-   */
-  ['hpattack', 'hpa'],
-  /**
-   * Sets the attack duration for the bandpass filter envelope.
-   * @name bpattack
-   * @param {number | Pattern} attack time of the bandpass filter envelope
-   * @synonyms bpa
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .bpf(500)
-   * .bpa("<.5 .25 .1 .01>/4")
-   * .bpenv(4)
-   */
-  ['bpattack', 'bpa'],
-  /**
-   * Sets the decay duration for the lowpass filter envelope.
-   * @name lpdecay
-   * @param {number | Pattern} decay time of the filter envelope
-   * @synonyms lpd
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .lpf(500)
-   * .lpd("<.5 .25 .1 0>/4")
-   * .lps(0.2)
-   * .lpenv(4)
-   */
-  ['lpdecay', 'lpd'],
-  /**
-   * Sets the decay duration for the highpass filter envelope.
-   * @name hpdecay
-   * @param {number | Pattern} decay time of the highpass filter envelope
-   * @synonyms hpd
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .hpf(500)
-   * .hpd("<.5 .25 .1 0>/4")
-   * .hps(0.2)
-   * .hpenv(4)
-   */
-  ['hpdecay', 'hpd'],
-  /**
-   * Sets the decay duration for the bandpass filter envelope.
-   * @name bpdecay
-   * @param {number | Pattern} decay time of the bandpass filter envelope
-   * @synonyms bpd
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .bpf(500)
-   * .bpd("<.5 .25 .1 0>/4")
-   * .bps(0.2)
-   * .bpenv(4)
-   */
-  ['bpdecay', 'bpd'],
-  /**
-   * Sets the sustain amplitude for the lowpass filter envelope.
-   * @name lpsustain
-   * @param {number | Pattern} sustain amplitude of the lowpass filter envelope
-   * @synonyms lps
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .lpf(500)
-   * .lpd(.5)
-   * .lps("<0 .25 .5 1>/4")
-   * .lpenv(4)
-   */
-  ['lpsustain', 'lps'],
-  /**
-   * Sets the sustain amplitude for the highpass filter envelope.
-   * @name hpsustain
-   * @param {number | Pattern} sustain amplitude of the highpass filter envelope
-   * @synonyms hps
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .hpf(500)
-   * .hpd(.5)
-   * .hps("<0 .25 .5 1>/4")
-   * .hpenv(4)
-   */
-  ['hpsustain', 'hps'],
-  /**
-   * Sets the sustain amplitude for the bandpass filter envelope.
-   * @name bpsustain
-   * @param {number | Pattern} sustain amplitude of the bandpass filter envelope
-   * @synonyms bps
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .bpf(500)
-   * .bpd(.5)
-   * .bps("<0 .25 .5 1>/4")
-   * .bpenv(4)
-   */
-  ['bpsustain', 'bps'],
-  /**
-   * Sets the release time for the lowpass filter envelope.
-   * @name lprelease
-   * @param {number | Pattern} release time of the filter envelope
-   * @synonyms lpr
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .clip(.5)
-   * .lpf(500)
-   * .lpenv(4)
-   * .lpr("<.5 .25 .1 0>/4")
-   * .release(.5)
-   */
-  ['lprelease', 'lpr'],
-  /**
-   * Sets the release time for the highpass filter envelope.
-   * @name hprelease
-   * @param {number | Pattern} release time of the highpass filter envelope
-   * @synonyms hpr
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .clip(.5)
-   * .hpf(500)
-   * .hpenv(4)
-   * .hpr("<.5 .25 .1 0>/4")
-   * .release(.5)
-   */
-  ['hprelease', 'hpr'],
-  /**
-   * Sets the release time for the bandpass filter envelope.
-   * @name bprelease
-   * @param {number | Pattern} release time of the bandpass filter envelope
-   * @synonyms bpr
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .clip(.5)
-   * .bpf(500)
-   * .bpenv(4)
-   * .bpr("<.5 .25 .1 0>/4")
-   * .release(.5)
-   */
-  ['bprelease', 'bpr'],
-  /**
-   * Sets the filter type. The 24db filter is more aggressive. More types might be added in the future.
-   * @name ftype
-   * @param {number | Pattern} type 12db (default) or 24db
-   * @example
-   * note("c2 e2 f2 g2")
-   * .sound('sawtooth')
-   * .lpf(500)
-   * .bpenv(4)
-   * .ftype("12db 24db")
-   */
-  ['ftype'],
-  ['fanchor'],
-  /**
-   * Applies the cutoff frequency of the **h**igh-**p**ass **f**ilter.
-   *
-   * When using mininotation, you can also optionally add the 'hpq' parameter, separated by ':'.
-   *
-   * @name hpf
-   * @param {number | Pattern} frequency audible between 0 and 20000
-   * @synonyms hp, hcutoff
-   * @example
-   * s("bd sd [~ bd] sd,hh*8").hpf("<4000 2000 1000 500 200 100>")
-   * @example
-   * s("bd sd [~ bd] sd,hh*8").hpf("<2000 2000:25>")
-   *
-   */
-  // currently an alias of 'hcutoff' https://github.com/tidalcycles/strudel/issues/496
-  // ['hpf'],
-  /**
-   * Applies a vibrato to the frequency of the oscillator.
-   *
-   * @name vib
-   * @synonyms vibrato, v
-   * @param {number | Pattern} frequency of the vibrato in hertz
-   * @example
-   * note("a e")
-   * .vib("<.5 1 2 4 8 16>")
-   * @example
-   * // change the modulation depth with ":"
-   * note("a e")
-   * .vib("<.5 1 2 4 8 16>:12")
-   */
-  [['vib', 'vibmod'], 'vibrato', 'v'],
-  /**
-   * Adds pink noise to the mix
-   *
-   * @name noise
-   * @param {number | Pattern} wet wet amount
-   * @example
-   * sound("<white pink brown>/2")
-   */
-  ['noise'],
-  /**
-   * Sets the vibrato depth in semitones. Only has an effect if `vibrato` | `vib` | `v` is is also set
-   *
-   * @name vibmod
-   * @synonyms vmod
-   * @param {number | Pattern} depth of vibrato (in semitones)
-   * @example
-   * note("a e").vib(4)
-   * .vibmod("<.25 .5 1 2 12>")
-   * @example
-   * // change the vibrato frequency with ":"
-   * note("a e")
-   * .vibmod("<.25 .5 1 2 12>:8")
-   */
-  [['vibmod', 'vib'], 'vmod'],
-  [['hcutoff', 'hresonance', 'hpenv'], 'hpf', 'hp'],
-  /**
-   * Controls the **h**igh-**p**ass **q**-value.
-   *
-   * @name hpq
-   * @param {number | Pattern} q resonance factor between 0 and 50
-   * @synonyms hresonance
-   * @example
-   * s("bd sd [~ bd] sd,hh*8").hpf(2000).hpq("<0 10 20 30>")
-   *
-   */
-  ['hresonance', 'hpq'],
-  /**
-   * Controls the **l**ow-**p**ass **q**-value.
-   *
-   * @name lpq
-   * @param {number | Pattern} q resonance factor between 0 and 50
-   * @synonyms resonance
-   * @example
-   * s("bd sd [~ bd] sd,hh*8").lpf(2000).lpq("<0 10 20 30>")
-   *
-   */
-  // currently an alias of 'resonance' https://github.com/tidalcycles/strudel/issues/496
-  ['resonance', 'lpq'],
-  /**
-   * DJ filter, below 0.5 is low pass filter, above is high pass filter.
-   *
-   * @name djf
-   * @param {number | Pattern} cutoff below 0.5 is low pass filter, above is high pass filter
-   * @example
-   * n("0 3 7 [10,24]").s('superzow').octave(3).djf("<.5 .25 .5 .75>").osc()
-   *
-   */
-  ['djf'],
-  // ['cutoffegint'],
-  // TODO: does not seem to work
-  /**
-   * Sets the level of the delay signal.
-   *
-   * When using mininotation, you can also optionally add the 'delaytime' and 'delayfeedback' parameter,
-   * separated by ':'.
-   *
-   *
-   * @name delay
-   * @param {number | Pattern} level between 0 and 1
-   * @example
-   * s("bd bd").delay("<0 .25 .5 1>")
-   * @example
-   * s("bd bd").delay("0.65:0.25:0.9 0.65:0.125:0.7")
-   *
-   */
-  [['delay', 'delaytime', 'delayfeedback']],
-  /**
-   * Sets the level of the signal that is fed back into the delay.
-   * Caution: Values >= 1 will result in a signal that gets louder and louder! Don't do it
-   *
-   * @name delayfeedback
-   * @param {number | Pattern} feedback between 0 and 1
-   * @synonyms delayfb, dfb
-   * @example
-   * s("bd").delay(.25).delayfeedback("<.25 .5 .75 1>")
-   *
-   */
-  ['delayfeedback', 'delayfb', 'dfb'],
-  /**
-   * Sets the time of the delay effect.
-   *
-   * @name delaytime
-   * @param {number | Pattern} seconds between 0 and Infinity
-   * @synonyms delayt, dt
-   * @example
-   * s("bd bd").delay(.25).delaytime("<.125 .25 .5 1>")
-   *
-   */
-  ['delaytime', 'delayt', 'dt'],
-  /* // TODO: test
-   * Specifies whether delaytime is calculated relative to cps.
-   *
-   * @name lock
-   * @param {number | Pattern} enable When set to 1, delaytime is a direct multiple of a cycle.
-   * @example
-   * s("sd").delay().lock(1).osc()
-   *
-   */
-  ['lock'],
-  /**
-   * Set detune of oscillators. Works only with some synths, see <a target="_blank" href="https://tidalcycles.org/docs/patternlib/tutorials/synthesizers">tidal doc</a>
-   *
-   * @name detune
-   * @param {number | Pattern} amount between 0 and 1
-   * @synonyms det
-   * @superdirtOnly
-   * @example
-   * n("0 3 7").s('superzow').octave(3).detune("<0 .25 .5 1 2>").osc()
-   *
-   */
-  ['detune', 'det'],
-  /**
-   * Set dryness of reverb. See `room` and `size` for more information about reverb.
-   *
-   * @name dry
-   * @param {number | Pattern} dry 0 = wet, 1 = dry
-   * @example
-   * n("[0,3,7](3,8)").s("superpiano").room(.7).dry("<0 .5 .75 1>").osc()
-   * @superdirtOnly
-   *
-   */
-  ['dry'],
-  // TODO: does not seem to do anything
-  /*
-   * Used when using `begin`/`end` or `chop`/`striate` and friends, to change the fade out time of the 'grain' envelope.
-   *
-   * @name fadeTime
-   * @param {number | Pattern} time between 0 and 1
-   * @example
-   * s("oh*4").end(.1).fadeTime("<0 .2 .4 .8>").osc()
-   *
-   */
-  ['fadeTime', 'fadeOutTime'],
-  // TODO: see above
-  ['fadeInTime'],
-  /**
-   * Set frequency of sound.
-   *
-   * @name freq
-   * @param {number | Pattern} frequency in Hz. the audible range is between 20 and 20000 Hz
-   * @example
-   * freq("220 110 440 110").s("superzow").osc()
-   * @example
-   * freq("110".mul.out(".5 1.5 .6 [2 3]")).s("superzow").osc()
-   *
-   */
-  ['freq'],
-  // pitch envelope
-  /**
-   * Attack time of pitch envelope.
-   *
-   * @name pattack
-   * @synonyms patt
-   * @param {number | Pattern} time time in seconds
-   * @example
-   * note("c eb g bb").pattack("0 .1 .25 .5").slow(2)
-   *
-   */
-  ['pattack', 'patt'],
-  /**
-   * Decay time of pitch envelope.
-   *
-   * @name pdecay
-   * @synonyms pdec
-   * @param {number | Pattern} time time in seconds
-   * @example
-   * note("<c eb g bb>").pdecay("<0 .1 .25 .5>")
-   *
-   */
-  ['pdecay', 'pdec'],
-  // TODO: how to use psustain?!
-  ['psustain', 'psus'],
-  /**
-   * Release time of pitch envelope
-   *
-   * @name prelease
-   * @synonyms prel
-   * @param {number | Pattern} time time in seconds
-   * @example
-   * note("<c eb g bb> ~")
-   * .release(.5) // to hear the pitch release
-   * .prelease("<0 .1 .25 .5>")
-   *
-   */
-  ['prelease', 'prel'],
-  /**
-   * Amount of pitch envelope. Negative values will flip the envelope.
-   * If you don't set other pitch envelope controls, `pattack:.2` will be the default.
-   *
-   * @name penv
-   * @param {number | Pattern} semitones change in semitones
-   * @example
-   * note("c")
-   * .penv("<12 7 1 .5 0 -1 -7 -12>")
-   *
-   */
-  ['penv'],
-  /**
-   * Curve of envelope. Defaults to linear. exponential is good for kicks
-   *
-   * @name pcurve
-   * @param {number | Pattern} type 0 = linear, 1 = exponential
-   * @example
-   * note("g1*4")
-   * .s("sine").pdec(.5)
-   * .penv(32)
-   * .pcurve("<0 1>")
-   *
-   */
-  ['pcurve'],
-  /**
-   * Sets the range anchor of the envelope:
-   * - anchor 0: range = [note, note + penv]
-   * - anchor 1: range = [note - penv, note]
-   * If you don't set an anchor, the value will default to the psustain value.
-   *
-   * @name panchor
-   * @param {number | Pattern} anchor anchor offset
-   * @example
-   * note("c c4").penv(12).panchor("<0 .5 1 .5>")
-   *
-   */
-  ['panchor'],
-  // TODO: https://tidalcycles.org/docs/configuration/MIDIOSC/control-voltage/#gate
-  ['gate', 'gat'],
-  // ['hatgrain'],
-  // ['lagogo'],
-  // ['lclap'],
-  // ['lclaves'],
-  // ['lclhat'],
-  // ['lcrash'],
-  // TODO:
-  // https://tidalcycles.org/docs/reference/audio_effects/#leslie-1
-  // https://tidalcycles.org/docs/reference/audio_effects/#leslie
-  /**
-   * Emulation of a Leslie speaker: speakers rotating in a wooden amplified cabinet.
-   *
-   * @name leslie
-   * @param {number | Pattern} wet between 0 and 1
-   * @example
-   * n("0,4,7").s("supersquare").leslie("<0 .4 .6 1>").osc()
-   * @superdirtOnly
-   *
-   */
-  ['leslie'],
-  /**
-   * Rate of modulation / rotation for leslie effect
-   *
-   * @name lrate
-   * @param {number | Pattern} rate 6.7 for fast, 0.7 for slow
-   * @example
-   * n("0,4,7").s("supersquare").leslie(1).lrate("<1 2 4 8>").osc()
-   * @superdirtOnly
-   *
-   */
-  // TODO: the rate seems to "lag" (in the example, 1 will be fast)
-  ['lrate'],
-  /**
-   * Physical size of the cabinet in meters. Be careful, it might be slightly larger than your computer. Affects the Doppler amount (pitch warble)
-   *
-   * @name lsize
-   * @param {number | Pattern} meters somewhere between 0 and 1
-   * @example
-   * n("0,4,7").s("supersquare").leslie(1).lrate(2).lsize("<.1 .5 1>").osc()
-   * @superdirtOnly
-   *
-   */
-  ['lsize'],
-  /**
-   * Sets the displayed text for an event on the pianoroll
-   *
-   * @name label
-   * @param {string} label text to display
-   */
-  ['activeLabel'],
-  [['label', 'activeLabel']],
-  // ['lfo'],
-  // ['lfocutoffint'],
-  // ['lfodelay'],
-  // ['lfoint'],
-  // ['lfopitchint'],
-  // ['lfoshape'],
-  // ['lfosync'],
-  // ['lhitom'],
-  // ['lkick'],
-  // ['llotom'],
-  // ['lophat'],
-  // ['lsnare'],
-  ['degree'], // TODO: what is this? not found in tidal doc
-  ['mtranspose'], // TODO: what is this? not found in tidal doc
-  ['ctranspose'], // TODO: what is this? not found in tidal doc
-  ['harmonic'], // TODO: what is this? not found in tidal doc
-  ['stepsPerOctave'], // TODO: what is this? not found in tidal doc
-  ['octaveR'], // TODO: what is this? not found in tidal doc
-  // TODO: why is this needed? what's the difference to late / early? Answer: it's in seconds, and delays the message at
-  // OSC time (so can't be negative, at least not beyond the latency value)
-  ['nudge'],
-  // TODO: the following doc is just a guess, it's not documented in tidal doc.
-  /**
-   * Sets the default octave of a synth.
-   *
-   * @name octave
-   * @param {number | Pattern} octave octave number
-   * @example
-   * n("0,4,7").s('supersquare').octave("<3 4 5 6>").osc()
-   * @superDirtOnly
-   */
-  ['octave'],
-
-  // ['ophatdecay'],
-  // TODO: example
-  /**
-   * An `orbit` is a global parameter context for patterns. Patterns with the same orbit will share the same global effects.
-   *
-   * @name orbit
-   * @param {number | Pattern} number
-   * @example
-   * stack(
-   *   s("hh*6").delay(.5).delaytime(.25).orbit(1),
-   *   s("~ sd ~ sd").delay(.5).delaytime(.125).orbit(2)
-   * )
-   */
-  ['orbit'],
-  ['overgain'], // TODO: what is this? not found in tidal doc Answer: gain is limited to maximum of 2. This allows you to go over that
-  ['overshape'], // TODO: what is this? not found in tidal doc. Similar to above, but limited to 1
-  /**
-   * Sets position in stereo.
-   *
-   * @name pan
-   * @param {number | Pattern} pan between 0 and 1, from left to right (assuming stereo), once round a circle (assuming multichannel)
-   * @example
-   * s("[bd hh]*2").pan("<.5 1 .5 0>")
-   * @example
-   * s("bd rim sd rim bd ~ cp rim").pan(sine.slow(2))
-   *
-   */
-  ['pan'],
-  // TODO: this has no effect (see example)
-  /*
-   * Controls how much multichannel output is fanned out
-   *
-   * @name panspan
-   * @param {number | Pattern} span between -inf and inf, negative is backwards ordering
-   * @example
-   * s("[bd hh]*2").pan("<.5 1 .5 0>").panspan("<0 .5 1>").osc()
-   *
-   */
-  ['panspan'],
-  // TODO: this has no effect (see example)
-  /*
-   * Controls how much multichannel output is spread
-   *
-   * @name pansplay
-   * @param {number | Pattern} spread between 0 and 1
-   * @example
-   * s("[bd hh]*2").pan("<.5 1 .5 0>").pansplay("<0 .5 1>").osc()
-   *
-   */
-  ['pansplay'],
-  ['panwidth'],
-  ['panorient'],
-  // ['pitch1'],
-  // ['pitch2'],
-  // ['pitch3'],
-  // ['portamento'],
-  // TODO: LFO rate see https://tidalcycles.org/docs/patternlib/tutorials/synthesizers/#supersquare
-  ['rate'],
-  // TODO: slide param for certain synths
-  ['slide'],
-  // TODO: detune? https://tidalcycles.org/docs/patternlib/tutorials/synthesizers/#supersquare
-  ['semitone'],
-  // TODO: dedup with synth param, see https://tidalcycles.org/docs/reference/synthesizers/#superpiano
-  // ['velocity'],
-  ['voice'], // TODO: synth param
-
-  // voicings // https://github.com/tidalcycles/strudel/issues/506
-  ['chord'], // chord to voice, like C Eb Fm7 G7. the symbols can be defined via addVoicings
-  ['dictionary', 'dict'], // which dictionary to use for the voicings
-  ['anchor'], // the top note to align the voicing to, defaults to c5
-  ['offset'], // how the voicing is offset from the anchored position
-  ['octaves'], // how many octaves are voicing steps spread apart, defaults to 1
-  [['mode', 'anchor']], // below = anchor note will be removed from the voicing, useful for melody harmonization
-
-  /**
-   * Sets the level of reverb.
-   *
-   * When using mininotation, you can also optionally add the 'size' parameter, separated by ':'.
-   *
-   * @name room
-   * @param {number | Pattern} level between 0 and 1
-   * @example
-   * s("bd sd [~ bd] sd").room("<0 .2 .4 .6 .8 1>")
-   * @example
-   * s("bd sd [~ bd] sd").room("<0.9:1 0.9:4>")
-   *
-   */
-  [['room', 'size']],
-  /**
-   * Reverb lowpass starting frequency (in hertz).
-   * When this property is changed, the reverb will be recaculated, so only change this sparsely..
-   *
-   * @name roomlp
-   * @synonyms rlp
-   * @param {number} frequency between 0 and 20000hz
-   * @example
-   * s("bd sd [~ bd] sd").room(0.5).rlp(10000)
-   * @example
-   * s("bd sd [~ bd] sd").room(0.5).rlp(5000)
-   */
-  ['roomlp', 'rlp'],
-  /**
-   * Reverb lowpass frequency at -60dB (in hertz).
-   * When this property is changed, the reverb will be recaculated, so only change this sparsely..
-   *
-   * @name roomdim
-   * @synonyms rdim
-   * @param {number} frequency between 0 and 20000hz
-   * @example
-   * s("bd sd [~ bd] sd").room(0.5).rlp(10000).rdim(8000)
-   * @example
-   * s("bd sd [~ bd] sd").room(0.5).rlp(5000).rdim(400)
-   *
-   */
-  ['roomdim', 'rdim'],
-  /**
-   * Reverb fade time (in seconds).
-   * When this property is changed, the reverb will be recaculated, so only change this sparsely..
-   *
-   * @name roomfade
-   * @synonyms rfade
-   * @param {number} seconds for the reverb to fade
-   * @example
-   * s("bd sd [~ bd] sd").room(0.5).rlp(10000).rfade(0.5)
-   * @example
-   * s("bd sd [~ bd] sd").room(0.5).rlp(5000).rfade(4)
-   *
-   */
-  ['roomfade', 'rfade'],
-  /**
-   * Sets the sample to use as an impulse response for the reverb.
-   * @name iresponse
-   * @param {string | Pattern} sample to use as an impulse response
-   * @synonyms ir
-   * @example
-   * s("bd sd [~ bd] sd").room(.8).ir("<shaker_large:0 shaker_large:2>")
-   *
-   */
-  [['ir', 'i'], 'iresponse'],
-  /**
-   * Sets the room size of the reverb, see `room`.
-   * When this property is changed, the reverb will be recaculated, so only change this sparsely..
-   *
-   * @name roomsize
-   * @param {number | Pattern} size between 0 and 10
-   * @synonyms rsize, sz, size
-   * @example
-   * s("bd sd [~ bd] sd").room(.8).rsize(1)
-   * @example
-   * s("bd sd [~ bd] sd").room(.8).rsize(4)
-   *
-   */
-  // TODO: find out why :
-  // s("bd sd [~ bd] sd").room(.8).roomsize("<0 .2 .4 .6 .8 [1,0]>").osc()
-  // .. does not work. Is it because room is only one effect?
-  ['roomsize', 'size', 'sz', 'rsize'],
-  // ['sagogo'],
-  // ['sclap'],
-  // ['sclaves'],
-  // ['scrash'],
-  /**
-   * Wave shaping distortion. CAUTION: it might get loud
-   *
-   * @name shape
-   * @param {number | Pattern} distortion between 0 and 1
-   * @example
-   * s("bd sd [~ bd] sd,hh*8").shape("<0 .2 .4 .6 .8>")
-   *
-   */
-  ['shape'],
-  /**
-   * Dynamics Compressor. The params are `compressor("threshold:ratio:knee:attack:release")`
-   * More info [here](https://developer.mozilla.org/en-US/docs/Web/API/DynamicsCompressorNode?retiredLocale=de#instance_properties)
-   *
-   * @name compressor
-   * @example
-   * s("bd sd [~ bd] sd,hh*8")
-   * .compressor("-20:20:10:.002:.02")
-   *
-   */
-  [['compressor', 'compressorRatio', 'compressorKnee', 'compressorAttack', 'compressorRelease']],
-  ['compressorKnee'],
-  ['compressorRatio'],
-  ['compressorAttack'],
-  ['compressorRelease'],
-  /**
-   * Changes the speed of sample playback, i.e. a cheap way of changing pitch.
-   *
-   * @name speed
-   * @param {number | Pattern} speed -inf to inf, negative numbers play the sample backwards.
-   * @example
-   * s("bd*6").speed("1 2 4 1 -2 -4")
-   * @example
-   * speed("1 1.5*2 [2 1.1]").s("piano").clip(1)
-   *
-   */
-  ['speed'],
-  /**
-   * Used in conjunction with `speed`, accepts values of "r" (rate, default behavior), "c" (cycles), or "s" (seconds). Using `unit "c"` means `speed` will be interpreted in units of cycles, e.g. `speed "1"` means samples will be stretched to fill a cycle. Using `unit "s"` means the playback speed will be adjusted so that the duration is the number of seconds specified by `speed`.
-   *
-   * @name unit
-   * @param {number | string | Pattern} unit see description above
-   * @example
-   * speed("1 2 .5 3").s("bd").unit("c").osc()
-   * @superdirtOnly
-   *
-   */
-  ['unit'],
-  /**
-   * Made by Calum Gunn. Reminiscent of some weird mixture of filter, ring-modulator and pitch-shifter. The SuperCollider manual defines Squiz as:
-   *
-   * "A simplistic pitch-raising algorithm. It's not meant to sound natural; its sound is reminiscent of some weird mixture of filter, ring-modulator and pitch-shifter, depending on the input. The algorithm works by cutting the signal into fragments (delimited by upwards-going zero-crossings) and squeezing those fragments in the time domain (i.e. simply playing them back faster than they came in), leaving silences inbetween. All the parameters apart from memlen can be modulated."
-   *
-   * @name squiz
-   * @param {number | Pattern} squiz Try passing multiples of 2 to it - 2, 4, 8 etc.
-   * @example
-   * squiz("2 4/2 6 [8 16]").s("bd").osc()
-   * @superdirtOnly
-   *
-   */
-  ['squiz'],
-  // ['stutterdepth'], // TODO: what is this? not found in tidal doc
-  // ['stuttertime'], // TODO: what is this? not found in tidal doc
-  // ['timescale'], // TODO: what is this? not found in tidal doc
-  // ['timescalewin'], // TODO: what is this? not found in tidal doc
-  // ['tomdecay'],
-  // ['vcfegint'],
-  // ['vcoegint'],
-  // TODO: Use a rest (~) to override the effect <- vowel
-  /**
-   *
-   * Formant filter to make things sound like vowels.
-   *
-   * @name vowel
-   * @param {string | Pattern} vowel You can use a e i o u ae aa oe ue y uh un en an on, corresponding to [a] [e] [i] [o] [u] [æ] [ɑ] [ø] [y] [ɯ] [ʌ] [œ̃] [ɛ̃] [ɑ̃] [ɔ̃]. Aliases: aa = å = ɑ, oe = ø = ö, y = ı, ae = æ.
-   * @example
-   * note("[c2 <eb2 <g2 g1>>]*2").s('sawtooth')
-   * .vowel("<a e i <o u>>")
-   * @example
-   * s("bd sd mt ht bd [~ cp] ht lt").vowel("[a|e|i|o|u]")
-   *
-   */
-  ['vowel'],
-  /* // TODO: find out how it works
-   * Made by Calum Gunn. Divides an audio stream into tiny segments, using the signal's zero-crossings as segment boundaries, and discards a fraction of them. Takes a number between 1 and 100, denoted the percentage of segments to drop. The SuperCollider manual describes the Waveloss effect this way:
-   *
-   * Divide an audio stream into tiny segments, using the signal's zero-crossings as segment boundaries, and discard a fraction of them (i.e. replace them with silence of the same length). The technique was described by Trevor Wishart in a lecture. Parameters: the filter drops drop out of out of chunks. mode can be 1 to drop chunks in a simple deterministic fashion (e.g. always dropping the first 30 out of a set of 40 segments), or 2 to drop chunks randomly but in an appropriate proportion.)
-   *
-   * mode: ?
-   * waveloss: ?
-   *
-   * @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'],
-  ['expression'],
-  ['sustainpedal'],
-  /* // TODO: doesn't seem to do anything
-   *
-   * Tremolo Audio DSP effect
-   *
-   * @name tremolodepth
-   * @param {number | Pattern} depth between 0 and 1
-   * @example
-   * n("0,4,7").tremolodepth("<0 .3 .6 .9>").osc()
-   *
-   */
-  ['tremolodepth', 'tremdp'],
-  ['tremolorate', 'tremr'],
-
-  ['fshift'],
-  ['fshiftnote'],
-  ['fshiftphase'],
-
-  ['triode'],
-  ['krush'],
-  ['kcutoff'],
-  ['octer'],
-  ['octersub'],
-  ['octersubsub'],
-  ['ring'],
-  ['ringf'],
-  ['ringdf'],
-  ['distort'],
-  ['freeze'],
-  ['xsdelay'],
-  ['tsdelay'],
-  ['real'],
-  ['imag'],
-  ['enhance'],
-  ['partials'],
-  ['comb'],
-  ['smear'],
-  ['scram'],
-  ['binshift'],
-  ['hbrick'],
-  ['lbrick'],
-  ['midichan'],
-  ['control'],
-  ['ccn'],
-  ['ccv'],
-  ['polyTouch'],
-  ['midibend'],
-  ['miditouch'],
-  ['ctlNum'],
-  ['frameRate'],
-  ['frames'],
-  ['hours'],
-  ['midicmd'],
-  ['minutes'],
-  ['progNum'],
-  ['seconds'],
-  ['songPtr'],
-  ['uid'],
-  ['val'],
-  ['cps'],
-  /**
-   * Multiplies the duration with the given number. Also cuts samples off at the end if they exceed the duration.
-   * In tidal, this would be done with legato, [which has a complicated history in strudel](https://github.com/tidalcycles/strudel/issues/111).
-   * For now, if you're coming from tidal, just think clip = legato.
-   *
-   * @name clip
-   * @param {number | Pattern} factor >= 0
-   * @example
-   * note("c a f e").s("piano").clip("<.5 1 2>")
-   *
-   */
-  ['clip'],
-
-  // ZZFX
-  ['zrand'],
-  ['curve'],
-  ['slide'], // superdirt duplicate
-  ['deltaSlide'],
-  ['pitchJump'],
-  ['pitchJumpTime'],
-  ['lfo', 'repeatTime'],
-  ['znoise'], // noise on the frequency or as bubo calls it "frequency fog" :)
-  ['zmod'],
-  ['zcrush'], // like crush but scaled differently
-  ['zdelay'],
-  ['tremolo'],
-  ['zzfx'],
-];
-// TODO: slice / splice https://www.youtube.com/watch?v=hKhPdO0RKDQ&list=PL2lW1zNIIwj3bDkh-Y3LUGDuRcoUigoDs&index=13
-
-controls.createParam = function (names) {
+export function createParam(names) {
   const name = Array.isArray(names) ? names[0] : names;
 
   var withVal;
@@ -1443,20 +38,1456 @@ controls.createParam = function (names) {
   };
   Pattern.prototype[name] = setter;
   return func;
-};
+}
 
-generic_params.forEach(([names, ...aliases]) => {
+function registerControl(names, ...aliases) {
   const name = Array.isArray(names) ? names[0] : names;
-  controls[name] = controls.createParam(names);
-
+  let bag = {};
+  bag[name] = createParam(names);
   aliases.forEach((alias) => {
-    controls[alias] = controls[name];
+    bag[alias] = bag[name];
     Pattern.prototype[alias] = Pattern.prototype[name];
   });
-});
+  return bag;
+}
 
-controls.createParams = (...names) =>
-  names.reduce((acc, name) => Object.assign(acc, { [name]: controls.createParam(name) }), {});
+/**
+ * Select a sound / sample by name. When using mininotation, you can also optionally supply 'n' and 'gain' parameters
+ * separated by ':'.
+ *
+ * @name s
+ * @param {string | Pattern} sound The sound / pattern of sounds to pick
+ * @synonyms sound
+ * @example
+ * s("bd hh")
+ * @example
+ * s("bd:0 bd:1 bd:0:0.3 bd:1:1.4")
+ *
+ */
+export const { s, sound } = registerControl(['s', 'n', 'gain'], 'sound');
+
+/**
+ * Define a custom webaudio node to use as a sound source.
+ *
+ * @name source
+ * @param {function} getSource
+ * @synonyms src
+ *
+ */
+export const { source, src } = registerControl('source', 'src');
+/**
+ * Selects the given index from the sample map.
+ * Numbers too high will wrap around.
+ * `n` can also be used to play midi numbers, but it is recommended to use `note` instead.
+ *
+ * @name n
+ * @param {number | Pattern} value sample index starting from 0
+ * @example
+ * s("bd sd [~ bd] sd,hh*6").n("<0 1>")
+ */
+// also see https://github.com/tidalcycles/strudel/pull/63
+export const { n } = registerControl('n');
+/**
+ * Plays the given note name or midi number. A note name consists of
+ *
+ * - a letter (a-g or A-G)
+ * - optional accidentals (b or #)
+ * - optional octave number (0-9). Defaults to 3
+ *
+ * Examples of valid note names: `c`, `bb`, `Bb`, `f#`, `c3`, `A4`, `Eb2`, `c#5`
+ *
+ * You can also use midi numbers instead of note names, where 69 is mapped to A4 440Hz in 12EDO.
+ *
+ * @name note
+ * @example
+ * note("c a f e")
+ * @example
+ * note("c4 a4 f4 e4")
+ * @example
+ * note("60 69 65 64")
+ */
+export const { note } = registerControl(['note', 'n']);
+
+/**
+ * A pattern of numbers that speed up (or slow down) samples while they play. Currently only supported by osc / superdirt.
+ *
+ * @name accelerate
+ * @param {number | Pattern} amount acceleration.
+ * @superdirtOnly
+ * @example
+ * s("sax").accelerate("<0 1 2 4 8 16>").slow(2).osc()
+ *
+ */
+export const { accelerate } = registerControl('accelerate');
+/**
+ * Controls the gain by an exponential amount.
+ *
+ * @name gain
+ * @param {number | Pattern} amount gain.
+ * @example
+ * s("hh*8").gain(".4!2 1 .4!2 1 .4 1").fast(2)
+ *
+ */
+export const { gain } = registerControl('gain');
+/**
+ * Gain applied after all effects have been processed.
+ *
+ * @name postgain
+ * @example
+ * s("bd sd [~ bd] sd,hh*8")
+ * .compressor("-20:20:10:.002:.02").postgain(1.5)
+ *
+ */
+export const { postgain } = registerControl('postgain');
+/**
+ * Like `gain`, but linear.
+ *
+ * @name amp
+ * @param {number | Pattern} amount gain.
+ * @superdirtOnly
+ * @example
+ * s("bd*8").amp(".1*2 .5 .1*2 .5 .1 .5").osc()
+ *
+ */
+export const { amp } = registerControl('amp');
+/**
+ * Amplitude envelope attack time: Specifies how long it takes for the sound to reach its peak value, relative to the onset.
+ *
+ * @name attack
+ * @param {number | Pattern} attack time in seconds.
+ * @synonyms att
+ * @example
+ * note("c3 e3 f3 g3").attack("<0 .1 .5>")
+ *
+ */
+export const { attack, att } = registerControl('attack', 'att');
+
+/**
+ * Sets the Frequency Modulation Harmonicity Ratio.
+ * Controls the timbre of the sound.
+ * Whole numbers and simple ratios sound more natural,
+ * while decimal numbers and complex ratios sound metallic.
+ *
+ * @name fmh
+ * @param {number | Pattern} harmonicity
+ * @example
+ * note("c e g b g e")
+ * .fm(4)
+ * .fmh("<1 2 1.5 1.61>")
+ * .scope()
+ *
+ */
+export const { fmh } = registerControl(['fmh', 'fmi'], 'fmh');
+/**
+ * Sets the Frequency Modulation of the synth.
+ * Controls the modulation index, which defines the brightness of the sound.
+ *
+ * @name fm
+ * @param {number | Pattern} brightness modulation index
+ * @synonyms fmi
+ * @example
+ * note("c e g b g e")
+ * .fm("<0 1 2 8 32>")
+ * .scope()
+ *
+ */
+export const { fmi, fm } = registerControl(['fmi', 'fmh'], 'fm');
+// fm envelope
+/**
+ * Ramp type of fm envelope. Exp might be a bit broken..
+ *
+ * @name fmenv
+ * @param {number | Pattern} type lin | exp
+ * @example
+ * note("c e g b g e")
+ * .fm(4)
+ * .fmdecay(.2)
+ * .fmsustain(0)
+ * .fmenv("<exp lin>")
+ * .scope()
+ *
+ */
+export const { fmenv } = registerControl('fmenv');
+/**
+ * Attack time for the FM envelope: time it takes to reach maximum modulation
+ *
+ * @name fmattack
+ * @param {number | Pattern} time attack time
+ * @example
+ * note("c e g b g e")
+ * .fm(4)
+ * .fmattack("<0 .05 .1 .2>")
+ * .scope()
+ *
+ */
+export const { fmattack } = registerControl('fmattack');
+/**
+ * Decay time for the FM envelope: seconds until the sustain level is reached after the attack phase.
+ *
+ * @name fmdecay
+ * @param {number | Pattern} time decay time
+ * @example
+ * note("c e g b g e")
+ * .fm(4)
+ * .fmdecay("<.01 .05 .1 .2>")
+ * .fmsustain(.4)
+ * .scope()
+ *
+ */
+export const { fmdecay } = registerControl('fmdecay');
+/**
+ * Sustain level for the FM envelope: how much modulation is applied after the decay phase
+ *
+ * @name fmsustain
+ * @param {number | Pattern} level sustain level
+ * @example
+ * note("c e g b g e")
+ * .fm(4)
+ * .fmdecay(.1)
+ * .fmsustain("<1 .75 .5 0>")
+ * .scope()
+ *
+ */
+export const { fmsustain } = registerControl('fmsustain');
+// these are not really useful... skipping for now
+export const { fmrelease } = registerControl('fmrelease');
+export const { fmvelocity } = registerControl('fmvelocity');
+
+/**
+ * Select the sound bank to use. To be used together with `s`. The bank name (+ "_") will be prepended to the value of `s`.
+ *
+ * @name bank
+ * @param {string | Pattern} bank the name of the bank
+ * @example
+ * s("bd sd [~ bd] sd").bank('RolandTR909') // = s("RolandTR909_bd RolandTR909_sd")
+ *
+ */
+export const { bank } = registerControl('bank');
+
+// analyser node send amount 0 - 1 (used by scope)
+export const { analyze } = registerControl('analyze');
+// fftSize of analyser
+export const { fft } = registerControl('fft');
+
+/**
+ * Amplitude envelope decay time: the time it takes after the attack time to reach the sustain level.
+ * Note that the decay is only audible if the sustain value is lower than 1.
+ *
+ * @name decay
+ * @param {number | Pattern} time decay time in seconds
+ * @example
+ * note("c3 e3 f3 g3").decay("<.1 .2 .3 .4>").sustain(0)
+ *
+ */
+export const { decay, dec } = registerControl('decay', 'dec');
+/**
+ * Amplitude envelope sustain level: The level which is reached after attack / decay, being sustained until the offset.
+ *
+ * @name sustain
+ * @param {number | Pattern} gain sustain level between 0 and 1
+ * @synonyms sus
+ * @example
+ * note("c3 e3 f3 g3").decay(.2).sustain("<0 .1 .4 .6 1>")
+ *
+ */
+export const { sustain, sus } = registerControl('sustain', 'sus');
+/**
+ * Amplitude envelope release time: The time it takes after the offset to go from sustain level to zero.
+ *
+ * @name release
+ * @param {number | Pattern} time release time in seconds
+ * @synonyms rel
+ * @example
+ * note("c3 e3 g3 c4").release("<0 .1 .4 .6 1>/2")
+ *
+ */
+export const { release, rel } = registerControl('release', 'rel');
+export const { hold } = registerControl('hold');
+// TODO: in tidal, it seems to be normalized
+/**
+ * Sets the center frequency of the **b**and-**p**ass **f**ilter. When using mininotation, you
+ * can also optionally supply the 'bpq' parameter separated by ':'.
+ *
+ * @name bpf
+ * @param {number | Pattern} frequency center frequency
+ * @synonyms bandf, bp
+ * @example
+ * s("bd sd [~ bd] sd,hh*6").bpf("<1000 2000 4000 8000>")
+ *
+ */
+export const { bandf, bpf, bp } = registerControl(['bandf', 'bandq', 'bpenv'], 'bpf', 'bp');
+// TODO: in tidal, it seems to be normalized
+/**
+ * Sets the **b**and-**p**ass **q**-factor (resonance).
+ *
+ * @name bpq
+ * @param {number | Pattern} q q factor
+ * @synonyms bandq
+ * @example
+ * s("bd sd [~ bd] sd").bpf(500).bpq("<0 1 2 3>")
+ *
+ */
+// currently an alias of 'bandq' https://github.com/tidalcycles/strudel/issues/496
+// ['bpq'],
+export const { bandq, bpq } = registerControl('bandq', 'bpq');
+/**
+ * a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
+ *
+ * @memberof Pattern
+ * @name begin
+ * @param {number | Pattern} amount between 0 and 1, where 1 is the length of the sample
+ * @example
+ * samples({ rave: 'rave/AREUREADY.wav' }, 'github:tidalcycles/dirt-samples')
+ * s("rave").begin("<0 .25 .5 .75>").fast(2)
+ *
+ */
+export const { begin } = registerControl('begin');
+/**
+ * The same as .begin, but cuts off the end off each sample.
+ *
+ * @memberof Pattern
+ * @name end
+ * @param {number | Pattern} length 1 = whole sample, .5 = half sample, .25 = quarter sample etc..
+ * @example
+ * s("bd*2,oh*4").end("<.1 .2 .5 1>").fast(2)
+ *
+ */
+export const { end } = registerControl('end');
+/**
+ * Loops the sample.
+ * Note that the tempo of the loop is not synced with the cycle tempo.
+ * To change the loop region, use loopBegin / loopEnd.
+ *
+ * @name loop
+ * @param {number | Pattern} on If 1, the sample is looped
+ * @example
+ * s("casio").loop(1)
+ *
+ */
+export const { loop } = registerControl('loop');
+/**
+ * Begin to loop at a specific point in the sample (inbetween `begin` and `end`).
+ * Note that the loop point must be inbetween `begin` and `end`, and before `loopEnd`!
+ * Note: Samples starting with wt_ will automatically loop! (wt = wavetable)
+ *
+ * @name loopBegin
+ * @param {number | Pattern} time between 0 and 1, where 1 is the length of the sample
+ * @synonyms loopb
+ * @example
+ * s("space").loop(1)
+ * .loopBegin("<0 .125 .25>").scope()
+ */
+export const { loopBegin, loopb } = registerControl('loopBegin', 'loopb');
+/**
+ *
+ * End the looping section at a specific point in the sample (inbetween `begin` and `end`).
+ * Note that the loop point must be inbetween `begin` and `end`, and after `loopBegin`!
+ *
+ * @name loopEnd
+ * @param {number | Pattern} time between 0 and 1, where 1 is the length of the sample
+ * @synonyms loope
+ * @example
+ * s("space").loop(1)
+ * .loopEnd("<1 .75 .5 .25>").scope()
+ */
+export const { loopEnd, loope } = registerControl('loopEnd', 'loope');
+/**
+ * bit crusher effect.
+ *
+ * @name crush
+ * @param {number | Pattern} depth between 1 (for drastic reduction in bit-depth) to 16 (for barely no reduction).
+ * @example
+ * s("<bd sd>,hh*3").fast(2).crush("<16 8 7 6 5 4 3 2>")
+ *
+ */
+// TODO: currently duplicated with "native" legato
+// TODO: superdirt legato will do more: https://youtu.be/dQPmE1WaD1k?t=419
+/**
+ * a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
+ *
+ * @name legato
+ * @param {number | Pattern} duration between 0 and 1, where 1 is the length of the whole hap time
+ * @noAutocomplete
+ * @example
+ * "c4 eb4 g4 bb4".legato("<0.125 .25 .5 .75 1 2 4>")
+ *
+ */
+// ['legato'],
+// ['clhatdecay'],
+export const { crush } = registerControl('crush');
+/**
+ * fake-resampling for lowering the sample rate. Caution: This effect seems to only work in chromium based browsers
+ *
+ * @name coarse
+ * @param {number | Pattern} factor 1 for original 2 for half, 3 for a third and so on.
+ * @example
+ * s("bd sd [~ bd] sd,hh*8").coarse("<1 4 8 16 32>")
+ *
+ */
+export const { coarse } = registerControl('coarse');
+
+/**
+ * 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("3:4")
+ *
+ */
+export const { channels, ch } = registerControl('channels', 'ch');
+
+// superdirt only
+export const { phaserrate, phasr } = registerControl('phaserrate', 'phasr');
+
+/**
+ * Phaser audio effect that approximates popular guitar pedals.
+ *
+ * @name phaser
+ * @synonyms ph
+ * @param {number | Pattern} speed speed of modulation
+ * @example
+ * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
+ * .phaser("<1 2 4 8>")
+ *
+ */
+export const { phaser, ph } = registerControl(['phaser', 'phaserdepth', 'phasercenter', 'phasersweep'], 'ph');
+
+/**
+ * The frequency sweep range of the lfo for the phaser effect. Defaults to 2000
+ *
+ * @name phasersweep
+ * @synonyms phs
+ * @param {number | Pattern} phasersweep most useful values are between 0 and 4000
+ * @example
+ * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
+ * .phaser(2).phasersweep("<800 2000 4000>")
+ *
+ */
+export const { phasersweep, phs } = registerControl('phasersweep', 'phs');
+
+/**
+ *  The center frequency of the phaser in HZ. Defaults to 1000
+ *
+ * @name phasercenter
+ * @synonyms phc
+ * @param {number | Pattern} centerfrequency in HZ
+ * @example
+ * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
+ * .phaser(2).phasercenter("<800 2000 4000>")
+ *
+ */
+
+export const { phasercenter, phc } = registerControl('phasercenter', 'phc');
+
+/**
+ * The amount the signal is affected by the phaser effect. Defaults to 0.75
+ *
+ * @name phaserdepth
+ * @synonyms phd
+ * @param {number | Pattern} depth number between 0 and 1
+ * @example
+ * n(run(8)).scale("D:pentatonic").s("sawtooth").release(0.5)
+ * .phaser(2).phaserdepth("<0 .5 .75 1>")
+ *
+ */
+// also a superdirt control
+export const { phaserdepth, phd, phasdp } = registerControl('phaserdepth', 'phd', 'phasdp');
+
+/**
+ * choose the channel the pattern is sent to in superdirt
+ *
+ * @name channel
+ * @param {number | Pattern} channel channel number
+ *
+ */
+export const { channel } = registerControl('channel');
+/**
+ * In the style of classic drum-machines, `cut` will stop a playing sample as soon as another samples with in same cutgroup is to be played. An example would be an open hi-hat followed by a closed one, essentially muting the open.
+ *
+ * @name cut
+ * @param {number | Pattern} group cut group number
+ * @example
+ * s("[oh hh]*4").cut(1)
+ *
+ */
+export const { cut } = registerControl('cut');
+/**
+ * Applies the cutoff frequency of the **l**ow-**p**ass **f**ilter.
+ *
+ * When using mininotation, you can also optionally add the 'lpq' parameter, separated by ':'.
+ *
+ * @name lpf
+ * @param {number | Pattern} frequency audible between 0 and 20000
+ * @synonyms cutoff, ctf, lp
+ * @example
+ * s("bd sd [~ bd] sd,hh*6").lpf("<4000 2000 1000 500 200 100>")
+ * @example
+ * s("bd*16").lpf("1000:0 1000:10 1000:20 1000:30")
+ *
+ */
+export const { cutoff, ctf, lpf, lp } = registerControl(['cutoff', 'resonance', 'lpenv'], 'ctf', 'lpf', 'lp');
+
+/**
+ * Sets the lowpass filter envelope modulation depth.
+ * @name lpenv
+ * @param {number | Pattern} modulation depth of the lowpass filter envelope between 0 and _n_
+ * @synonyms lpe
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .lpf(500)
+ * .lpa(.5)
+ * .lpenv("<4 2 1 0 -1 -2 -4>/4")
+ */
+export const { lpenv, lpe } = registerControl('lpenv', 'lpe');
+/**
+ * Sets the highpass filter envelope modulation depth.
+ * @name hpenv
+ * @param {number | Pattern} modulation depth of the highpass filter envelope between 0 and _n_
+ * @synonyms hpe
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .hpf(500)
+ * .hpa(.5)
+ * .hpenv("<4 2 1 0 -1 -2 -4>/4")
+ */
+export const { hpenv, hpe } = registerControl('hpenv', 'hpe');
+/**
+ * Sets the bandpass filter envelope modulation depth.
+ * @name bpenv
+ * @param {number | Pattern} modulation depth of the bandpass filter envelope between 0 and _n_
+ * @synonyms bpe
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .bpf(500)
+ * .bpa(.5)
+ * .bpenv("<4 2 1 0 -1 -2 -4>/4")
+ */
+export const { bpenv, bpe } = registerControl('bpenv', 'bpe');
+/**
+ * Sets the attack duration for the lowpass filter envelope.
+ * @name lpattack
+ * @param {number | Pattern} attack time of the filter envelope
+ * @synonyms lpa
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .lpf(500)
+ * .lpa("<.5 .25 .1 .01>/4")
+ * .lpenv(4)
+ */
+export const { lpattack, lpa } = registerControl('lpattack', 'lpa');
+/**
+ * Sets the attack duration for the highpass filter envelope.
+ * @name hpattack
+ * @param {number | Pattern} attack time of the highpass filter envelope
+ * @synonyms hpa
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .hpf(500)
+ * .hpa("<.5 .25 .1 .01>/4")
+ * .hpenv(4)
+ */
+export const { hpattack, hpa } = registerControl('hpattack', 'hpa');
+/**
+ * Sets the attack duration for the bandpass filter envelope.
+ * @name bpattack
+ * @param {number | Pattern} attack time of the bandpass filter envelope
+ * @synonyms bpa
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .bpf(500)
+ * .bpa("<.5 .25 .1 .01>/4")
+ * .bpenv(4)
+ */
+export const { bpattack, bpa } = registerControl('bpattack', 'bpa');
+/**
+ * Sets the decay duration for the lowpass filter envelope.
+ * @name lpdecay
+ * @param {number | Pattern} decay time of the filter envelope
+ * @synonyms lpd
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .lpf(500)
+ * .lpd("<.5 .25 .1 0>/4")
+ * .lps(0.2)
+ * .lpenv(4)
+ */
+export const { lpdecay, lpd } = registerControl('lpdecay', 'lpd');
+/**
+ * Sets the decay duration for the highpass filter envelope.
+ * @name hpdecay
+ * @param {number | Pattern} decay time of the highpass filter envelope
+ * @synonyms hpd
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .hpf(500)
+ * .hpd("<.5 .25 .1 0>/4")
+ * .hps(0.2)
+ * .hpenv(4)
+ */
+export const { hpdecay, hpd } = registerControl('hpdecay', 'hpd');
+/**
+ * Sets the decay duration for the bandpass filter envelope.
+ * @name bpdecay
+ * @param {number | Pattern} decay time of the bandpass filter envelope
+ * @synonyms bpd
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .bpf(500)
+ * .bpd("<.5 .25 .1 0>/4")
+ * .bps(0.2)
+ * .bpenv(4)
+ */
+export const { bpdecay, bpd } = registerControl('bpdecay', 'bpd');
+/**
+ * Sets the sustain amplitude for the lowpass filter envelope.
+ * @name lpsustain
+ * @param {number | Pattern} sustain amplitude of the lowpass filter envelope
+ * @synonyms lps
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .lpf(500)
+ * .lpd(.5)
+ * .lps("<0 .25 .5 1>/4")
+ * .lpenv(4)
+ */
+export const { lpsustain, lps } = registerControl('lpsustain', 'lps');
+/**
+ * Sets the sustain amplitude for the highpass filter envelope.
+ * @name hpsustain
+ * @param {number | Pattern} sustain amplitude of the highpass filter envelope
+ * @synonyms hps
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .hpf(500)
+ * .hpd(.5)
+ * .hps("<0 .25 .5 1>/4")
+ * .hpenv(4)
+ */
+export const { hpsustain, hps } = registerControl('hpsustain', 'hps');
+/**
+ * Sets the sustain amplitude for the bandpass filter envelope.
+ * @name bpsustain
+ * @param {number | Pattern} sustain amplitude of the bandpass filter envelope
+ * @synonyms bps
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .bpf(500)
+ * .bpd(.5)
+ * .bps("<0 .25 .5 1>/4")
+ * .bpenv(4)
+ */
+export const { bpsustain, bps } = registerControl('bpsustain', 'bps');
+/**
+ * Sets the release time for the lowpass filter envelope.
+ * @name lprelease
+ * @param {number | Pattern} release time of the filter envelope
+ * @synonyms lpr
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .clip(.5)
+ * .lpf(500)
+ * .lpenv(4)
+ * .lpr("<.5 .25 .1 0>/4")
+ * .release(.5)
+ */
+export const { lprelease, lpr } = registerControl('lprelease', 'lpr');
+/**
+ * Sets the release time for the highpass filter envelope.
+ * @name hprelease
+ * @param {number | Pattern} release time of the highpass filter envelope
+ * @synonyms hpr
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .clip(.5)
+ * .hpf(500)
+ * .hpenv(4)
+ * .hpr("<.5 .25 .1 0>/4")
+ * .release(.5)
+ */
+export const { hprelease, hpr } = registerControl('hprelease', 'hpr');
+/**
+ * Sets the release time for the bandpass filter envelope.
+ * @name bprelease
+ * @param {number | Pattern} release time of the bandpass filter envelope
+ * @synonyms bpr
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .clip(.5)
+ * .bpf(500)
+ * .bpenv(4)
+ * .bpr("<.5 .25 .1 0>/4")
+ * .release(.5)
+ */
+export const { bprelease, bpr } = registerControl('bprelease', 'bpr');
+/**
+ * Sets the filter type. The 24db filter is more aggressive. More types might be added in the future.
+ * @name ftype
+ * @param {number | Pattern} type 12db (default) or 24db
+ * @example
+ * note("c2 e2 f2 g2")
+ * .sound('sawtooth')
+ * .lpf(500)
+ * .bpenv(4)
+ * .ftype("12db 24db")
+ */
+export const { ftype } = registerControl('ftype');
+export const { fanchor } = registerControl('fanchor');
+/**
+ * Applies the cutoff frequency of the **h**igh-**p**ass **f**ilter.
+ *
+ * When using mininotation, you can also optionally add the 'hpq' parameter, separated by ':'.
+ *
+ * @name hpf
+ * @param {number | Pattern} frequency audible between 0 and 20000
+ * @synonyms hp, hcutoff
+ * @example
+ * s("bd sd [~ bd] sd,hh*8").hpf("<4000 2000 1000 500 200 100>")
+ * @example
+ * s("bd sd [~ bd] sd,hh*8").hpf("<2000 2000:25>")
+ *
+ */
+// currently an alias of 'hcutoff' https://github.com/tidalcycles/strudel/issues/496
+// ['hpf'],
+/**
+ * Applies a vibrato to the frequency of the oscillator.
+ *
+ * @name vib
+ * @synonyms vibrato, v
+ * @param {number | Pattern} frequency of the vibrato in hertz
+ * @example
+ * note("a e")
+ * .vib("<.5 1 2 4 8 16>")
+ * @example
+ * // change the modulation depth with ":"
+ * note("a e")
+ * .vib("<.5 1 2 4 8 16>:12")
+ */
+export const { vib, vibrato, v } = registerControl(['vib', 'vibmod'], 'vibrato', 'v');
+/**
+ * Adds pink noise to the mix
+ *
+ * @name noise
+ * @param {number | Pattern} wet wet amount
+ * @example
+ * sound("<white pink brown>/2")
+ */
+export const { noise } = registerControl('noise');
+/**
+ * Sets the vibrato depth in semitones. Only has an effect if `vibrato` | `vib` | `v` is is also set
+ *
+ * @name vibmod
+ * @synonyms vmod
+ * @param {number | Pattern} depth of vibrato (in semitones)
+ * @example
+ * note("a e").vib(4)
+ * .vibmod("<.25 .5 1 2 12>")
+ * @example
+ * // change the vibrato frequency with ":"
+ * note("a e")
+ * .vibmod("<.25 .5 1 2 12>:8")
+ */
+export const { vibmod, vmod } = registerControl(['vibmod', 'vib'], 'vmod');
+export const { hcutoff, hpf, hp } = registerControl(['hcutoff', 'hresonance', 'hpenv'], 'hpf', 'hp');
+/**
+ * Controls the **h**igh-**p**ass **q**-value.
+ *
+ * @name hpq
+ * @param {number | Pattern} q resonance factor between 0 and 50
+ * @synonyms hresonance
+ * @example
+ * s("bd sd [~ bd] sd,hh*8").hpf(2000).hpq("<0 10 20 30>")
+ *
+ */
+export const { hresonance, hpq } = registerControl('hresonance', 'hpq');
+/**
+ * Controls the **l**ow-**p**ass **q**-value.
+ *
+ * @name lpq
+ * @param {number | Pattern} q resonance factor between 0 and 50
+ * @synonyms resonance
+ * @example
+ * s("bd sd [~ bd] sd,hh*8").lpf(2000).lpq("<0 10 20 30>")
+ *
+ */
+// currently an alias of 'resonance' https://github.com/tidalcycles/strudel/issues/496
+export const { resonance, lpq } = registerControl('resonance', 'lpq');
+/**
+ * DJ filter, below 0.5 is low pass filter, above is high pass filter.
+ *
+ * @name djf
+ * @param {number | Pattern} cutoff below 0.5 is low pass filter, above is high pass filter
+ * @example
+ * n("0 3 7 [10,24]").s('superzow').octave(3).djf("<.5 .25 .5 .75>").osc()
+ *
+ */
+export const { djf } = registerControl('djf');
+// ['cutoffegint'],
+// TODO: does not seem to work
+/**
+ * Sets the level of the delay signal.
+ *
+ * When using mininotation, you can also optionally add the 'delaytime' and 'delayfeedback' parameter,
+ * separated by ':'.
+ *
+ *
+ * @name delay
+ * @param {number | Pattern} level between 0 and 1
+ * @example
+ * s("bd bd").delay("<0 .25 .5 1>")
+ * @example
+ * s("bd bd").delay("0.65:0.25:0.9 0.65:0.125:0.7")
+ *
+ */
+export const { delay } = registerControl(['delay', 'delaytime', 'delayfeedback']);
+/**
+ * Sets the level of the signal that is fed back into the delay.
+ * Caution: Values >= 1 will result in a signal that gets louder and louder! Don't do it
+ *
+ * @name delayfeedback
+ * @param {number | Pattern} feedback between 0 and 1
+ * @synonyms delayfb, dfb
+ * @example
+ * s("bd").delay(.25).delayfeedback("<.25 .5 .75 1>")
+ *
+ */
+export const { delayfeedback, delayfb, dfb } = registerControl('delayfeedback', 'delayfb', 'dfb');
+/**
+ * Sets the time of the delay effect.
+ *
+ * @name delaytime
+ * @param {number | Pattern} seconds between 0 and Infinity
+ * @synonyms delayt, dt
+ * @example
+ * s("bd bd").delay(.25).delaytime("<.125 .25 .5 1>")
+ *
+ */
+export const { delaytime, delayt, dt } = registerControl('delaytime', 'delayt', 'dt');
+/* // TODO: test
+ * Specifies whether delaytime is calculated relative to cps.
+ *
+ * @name lock
+ * @param {number | Pattern} enable When set to 1, delaytime is a direct multiple of a cycle.
+ * @example
+ * s("sd").delay().lock(1).osc()
+ *
+ */
+export const { lock } = registerControl('lock');
+/**
+ * Set detune of oscillators. Works only with some synths, see <a target="_blank" href="https://tidalcycles.org/docs/patternlib/tutorials/synthesizers">tidal doc</a>
+ *
+ * @name detune
+ * @param {number | Pattern} amount between 0 and 1
+ * @synonyms det
+ * @superdirtOnly
+ * @example
+ * n("0 3 7").s('superzow').octave(3).detune("<0 .25 .5 1 2>").osc()
+ *
+ */
+export const { detune, det } = registerControl('detune', 'det');
+/**
+ * Set dryness of reverb. See `room` and `size` for more information about reverb.
+ *
+ * @name dry
+ * @param {number | Pattern} dry 0 = wet, 1 = dry
+ * @example
+ * n("[0,3,7](3,8)").s("superpiano").room(.7).dry("<0 .5 .75 1>").osc()
+ * @superdirtOnly
+ *
+ */
+export const { dry } = registerControl('dry');
+// TODO: does not seem to do anything
+/*
+ * Used when using `begin`/`end` or `chop`/`striate` and friends, to change the fade out time of the 'grain' envelope.
+ *
+ * @name fadeTime
+ * @param {number | Pattern} time between 0 and 1
+ * @example
+ * s("oh*4").end(.1).fadeTime("<0 .2 .4 .8>").osc()
+ *
+ */
+export const { fadeTime, fadeOutTime } = registerControl('fadeTime', 'fadeOutTime');
+// TODO: see above
+export const { fadeInTime } = registerControl('fadeInTime');
+/**
+ * Set frequency of sound.
+ *
+ * @name freq
+ * @param {number | Pattern} frequency in Hz. the audible range is between 20 and 20000 Hz
+ * @example
+ * freq("220 110 440 110").s("superzow").osc()
+ * @example
+ * freq("110".mul.out(".5 1.5 .6 [2 3]")).s("superzow").osc()
+ *
+ */
+export const { freq } = registerControl('freq');
+// pitch envelope
+/**
+ * Attack time of pitch envelope.
+ *
+ * @name pattack
+ * @synonyms patt
+ * @param {number | Pattern} time time in seconds
+ * @example
+ * note("c eb g bb").pattack("0 .1 .25 .5").slow(2)
+ *
+ */
+export const { pattack, patt } = registerControl('pattack', 'patt');
+/**
+ * Decay time of pitch envelope.
+ *
+ * @name pdecay
+ * @synonyms pdec
+ * @param {number | Pattern} time time in seconds
+ * @example
+ * note("<c eb g bb>").pdecay("<0 .1 .25 .5>")
+ *
+ */
+export const { pdecay, pdec } = registerControl('pdecay', 'pdec');
+// TODO: how to use psustain?!
+export const { psustain, psus } = registerControl('psustain', 'psus');
+/**
+ * Release time of pitch envelope
+ *
+ * @name prelease
+ * @synonyms prel
+ * @param {number | Pattern} time time in seconds
+ * @example
+ * note("<c eb g bb> ~")
+ * .release(.5) // to hear the pitch release
+ * .prelease("<0 .1 .25 .5>")
+ *
+ */
+export const { prelease, prel } = registerControl('prelease', 'prel');
+/**
+ * Amount of pitch envelope. Negative values will flip the envelope.
+ * If you don't set other pitch envelope controls, `pattack:.2` will be the default.
+ *
+ * @name penv
+ * @param {number | Pattern} semitones change in semitones
+ * @example
+ * note("c")
+ * .penv("<12 7 1 .5 0 -1 -7 -12>")
+ *
+ */
+export const { penv } = registerControl('penv');
+/**
+ * Curve of envelope. Defaults to linear. exponential is good for kicks
+ *
+ * @name pcurve
+ * @param {number | Pattern} type 0 = linear, 1 = exponential
+ * @example
+ * note("g1*4")
+ * .s("sine").pdec(.5)
+ * .penv(32)
+ * .pcurve("<0 1>")
+ *
+ */
+export const { pcurve } = registerControl('pcurve');
+/**
+ * Sets the range anchor of the envelope:
+ * - anchor 0: range = [note, note + penv]
+ * - anchor 1: range = [note - penv, note]
+ * If you don't set an anchor, the value will default to the psustain value.
+ *
+ * @name panchor
+ * @param {number | Pattern} anchor anchor offset
+ * @example
+ * note("c c4").penv(12).panchor("<0 .5 1 .5>")
+ *
+ */
+export const { panchor } = registerControl('panchor');
+// TODO: https://tidalcycles.org/docs/configuration/MIDIOSC/control-voltage/#gate
+export const { gate, gat } = registerControl('gate', 'gat');
+// ['hatgrain'],
+// ['lagogo'],
+// ['lclap'],
+// ['lclaves'],
+// ['lclhat'],
+// ['lcrash'],
+// TODO:
+// https://tidalcycles.org/docs/reference/audio_effects/#leslie-1
+// https://tidalcycles.org/docs/reference/audio_effects/#leslie
+/**
+ * Emulation of a Leslie speaker: speakers rotating in a wooden amplified cabinet.
+ *
+ * @name leslie
+ * @param {number | Pattern} wet between 0 and 1
+ * @example
+ * n("0,4,7").s("supersquare").leslie("<0 .4 .6 1>").osc()
+ * @superdirtOnly
+ *
+ */
+export const { leslie } = registerControl('leslie');
+/**
+ * Rate of modulation / rotation for leslie effect
+ *
+ * @name lrate
+ * @param {number | Pattern} rate 6.7 for fast, 0.7 for slow
+ * @example
+ * n("0,4,7").s("supersquare").leslie(1).lrate("<1 2 4 8>").osc()
+ * @superdirtOnly
+ *
+ */
+// TODO: the rate seems to "lag" (in the example, 1 will be fast)
+export const { lrate } = registerControl('lrate');
+/**
+ * Physical size of the cabinet in meters. Be careful, it might be slightly larger than your computer. Affects the Doppler amount (pitch warble)
+ *
+ * @name lsize
+ * @param {number | Pattern} meters somewhere between 0 and 1
+ * @example
+ * n("0,4,7").s("supersquare").leslie(1).lrate(2).lsize("<.1 .5 1>").osc()
+ * @superdirtOnly
+ *
+ */
+export const { lsize } = registerControl('lsize');
+/**
+ * Sets the displayed text for an event on the pianoroll
+ *
+ * @name label
+ * @param {string} label text to display
+ */
+export const { activeLabel } = registerControl('activeLabel');
+export const { label } = registerControl(['label', 'activeLabel']);
+// ['lfo'],
+// ['lfocutoffint'],
+// ['lfodelay'],
+// ['lfoint'],
+// ['lfopitchint'],
+// ['lfoshape'],
+// ['lfosync'],
+// ['lhitom'],
+// ['lkick'],
+// ['llotom'],
+// ['lophat'],
+// ['lsnare'],
+// TODO: what is this? not found in tidal doc
+export const { degree } = registerControl('degree');
+// TODO: what is this? not found in tidal doc
+export const { mtranspose } = registerControl('mtranspose');
+// TODO: what is this? not found in tidal doc
+export const { ctranspose } = registerControl('ctranspose');
+// TODO: what is this? not found in tidal doc
+export const { harmonic } = registerControl('harmonic');
+// TODO: what is this? not found in tidal doc
+export const { stepsPerOctave } = registerControl('stepsPerOctave');
+// TODO: what is this? not found in tidal doc
+export const { octaveR } = registerControl('octaveR');
+// TODO: why is this needed? what's the difference to late / early? Answer: it's in seconds, and delays the message at
+// OSC time (so can't be negative, at least not beyond the latency value)
+export const { nudge } = registerControl('nudge');
+// TODO: the following doc is just a guess, it's not documented in tidal doc.
+/**
+ * Sets the default octave of a synth.
+ *
+ * @name octave
+ * @param {number | Pattern} octave octave number
+ * @example
+ * n("0,4,7").s('supersquare').octave("<3 4 5 6>").osc()
+ * @superDirtOnly
+ */
+export const { octave } = registerControl('octave');
+
+// ['ophatdecay'],
+// TODO: example
+/**
+ * An `orbit` is a global parameter context for patterns. Patterns with the same orbit will share the same global effects.
+ *
+ * @name orbit
+ * @param {number | Pattern} number
+ * @example
+ * stack(
+ *   s("hh*6").delay(.5).delaytime(.25).orbit(1),
+ *   s("~ sd ~ sd").delay(.5).delaytime(.125).orbit(2)
+ * )
+ */
+export const { orbit } = registerControl('orbit');
+// TODO: what is this? not found in tidal doc Answer: gain is limited to maximum of 2. This allows you to go over that
+export const { overgain } = registerControl('overgain');
+// TODO: what is this? not found in tidal doc. Similar to above, but limited to 1
+export const { overshape } = registerControl('overshape');
+/**
+ * Sets position in stereo.
+ *
+ * @name pan
+ * @param {number | Pattern} pan between 0 and 1, from left to right (assuming stereo), once round a circle (assuming multichannel)
+ * @example
+ * s("[bd hh]*2").pan("<.5 1 .5 0>")
+ * @example
+ * s("bd rim sd rim bd ~ cp rim").pan(sine.slow(2))
+ *
+ */
+export const { pan } = registerControl('pan');
+// TODO: this has no effect (see example)
+/*
+ * Controls how much multichannel output is fanned out
+ *
+ * @name panspan
+ * @param {number | Pattern} span between -inf and inf, negative is backwards ordering
+ * @example
+ * s("[bd hh]*2").pan("<.5 1 .5 0>").panspan("<0 .5 1>").osc()
+ *
+ */
+export const { panspan } = registerControl('panspan');
+// TODO: this has no effect (see example)
+/*
+ * Controls how much multichannel output is spread
+ *
+ * @name pansplay
+ * @param {number | Pattern} spread between 0 and 1
+ * @example
+ * s("[bd hh]*2").pan("<.5 1 .5 0>").pansplay("<0 .5 1>").osc()
+ *
+ */
+export const { pansplay } = registerControl('pansplay');
+export const { panwidth } = registerControl('panwidth');
+export const { panorient } = registerControl('panorient');
+// ['pitch1'],
+// ['pitch2'],
+// ['pitch3'],
+// ['portamento'],
+// TODO: LFO rate see https://tidalcycles.org/docs/patternlib/tutorials/synthesizers/#supersquare
+export const { rate } = registerControl('rate');
+// TODO: slide param for certain synths
+export const { slide } = registerControl('slide');
+// TODO: detune? https://tidalcycles.org/docs/patternlib/tutorials/synthesizers/#supersquare
+export const { semitone } = registerControl('semitone');
+// TODO: dedup with synth param, see https://tidalcycles.org/docs/reference/synthesizers/#superpiano
+// ['velocity'],
+// TODO: synth param
+export const { voice } = registerControl('voice');
+
+// voicings // https://github.com/tidalcycles/strudel/issues/506
+// chord to voice, like C Eb Fm7 G7. the symbols can be defined via addVoicings
+export const { chord } = registerControl('chord');
+// which dictionary to use for the voicings
+export const { dictionary, dict } = registerControl('dictionary', 'dict');
+// the top note to align the voicing to, defaults to c5
+export const { anchor } = registerControl('anchor');
+// how the voicing is offset from the anchored position
+export const { offset } = registerControl('offset');
+// how many octaves are voicing steps spread apart, defaults to 1
+export const { octaves } = registerControl('octaves');
+// below = anchor note will be removed from the voicing, useful for melody harmonization
+export const { mode } = registerControl(['mode', 'anchor']);
+
+/**
+ * Sets the level of reverb.
+ *
+ * When using mininotation, you can also optionally add the 'size' parameter, separated by ':'.
+ *
+ * @name room
+ * @param {number | Pattern} level between 0 and 1
+ * @example
+ * s("bd sd [~ bd] sd").room("<0 .2 .4 .6 .8 1>")
+ * @example
+ * s("bd sd [~ bd] sd").room("<0.9:1 0.9:4>")
+ *
+ */
+export const { room } = registerControl(['room', 'size']);
+/**
+ * Reverb lowpass starting frequency (in hertz).
+ * When this property is changed, the reverb will be recaculated, so only change this sparsely..
+ *
+ * @name roomlp
+ * @synonyms rlp
+ * @param {number} frequency between 0 and 20000hz
+ * @example
+ * s("bd sd [~ bd] sd").room(0.5).rlp(10000)
+ * @example
+ * s("bd sd [~ bd] sd").room(0.5).rlp(5000)
+ */
+export const { roomlp, rlp } = registerControl('roomlp', 'rlp');
+/**
+ * Reverb lowpass frequency at -60dB (in hertz).
+ * When this property is changed, the reverb will be recaculated, so only change this sparsely..
+ *
+ * @name roomdim
+ * @synonyms rdim
+ * @param {number} frequency between 0 and 20000hz
+ * @example
+ * s("bd sd [~ bd] sd").room(0.5).rlp(10000).rdim(8000)
+ * @example
+ * s("bd sd [~ bd] sd").room(0.5).rlp(5000).rdim(400)
+ *
+ */
+export const { roomdim, rdim } = registerControl('roomdim', 'rdim');
+/**
+ * Reverb fade time (in seconds).
+ * When this property is changed, the reverb will be recaculated, so only change this sparsely..
+ *
+ * @name roomfade
+ * @synonyms rfade
+ * @param {number} seconds for the reverb to fade
+ * @example
+ * s("bd sd [~ bd] sd").room(0.5).rlp(10000).rfade(0.5)
+ * @example
+ * s("bd sd [~ bd] sd").room(0.5).rlp(5000).rfade(4)
+ *
+ */
+export const { roomfade, rfade } = registerControl('roomfade', 'rfade');
+/**
+ * Sets the sample to use as an impulse response for the reverb.
+ * @name iresponse
+ * @param {string | Pattern} sample to use as an impulse response
+ * @synonyms ir
+ * @example
+ * s("bd sd [~ bd] sd").room(.8).ir("<shaker_large:0 shaker_large:2>")
+ *
+ */
+export const { ir, iresponse } = registerControl(['ir', 'i'], 'iresponse');
+/**
+ * Sets the room size of the reverb, see `room`.
+ * When this property is changed, the reverb will be recaculated, so only change this sparsely..
+ *
+ * @name roomsize
+ * @param {number | Pattern} size between 0 and 10
+ * @synonyms rsize, sz, size
+ * @example
+ * s("bd sd [~ bd] sd").room(.8).rsize(1)
+ * @example
+ * s("bd sd [~ bd] sd").room(.8).rsize(4)
+ *
+ */
+// TODO: find out why :
+// s("bd sd [~ bd] sd").room(.8).roomsize("<0 .2 .4 .6 .8 [1,0]>").osc()
+// .. does not work. Is it because room is only one effect?
+export const { roomsize, size, sz, rsize } = registerControl('roomsize', 'size', 'sz', 'rsize');
+// ['sagogo'],
+// ['sclap'],
+// ['sclaves'],
+// ['scrash'],
+/**
+ * Wave shaping distortion. CAUTION: it might get loud
+ *
+ * @name shape
+ * @param {number | Pattern} distortion between 0 and 1
+ * @example
+ * s("bd sd [~ bd] sd,hh*8").shape("<0 .2 .4 .6 .8>")
+ *
+ */
+export const { shape } = registerControl('shape');
+/**
+ * Dynamics Compressor. The params are `compressor("threshold:ratio:knee:attack:release")`
+ * More info [here](https://developer.mozilla.org/en-US/docs/Web/API/DynamicsCompressorNode?retiredLocale=de#instance_properties)
+ *
+ * @name compressor
+ * @example
+ * s("bd sd [~ bd] sd,hh*8")
+ * .compressor("-20:20:10:.002:.02")
+ *
+ */
+export const { compressor } = registerControl([
+  'compressor',
+  'compressorRatio',
+  'compressorKnee',
+  'compressorAttack',
+  'compressorRelease',
+]);
+export const { compressorKnee } = registerControl('compressorKnee');
+export const { compressorRatio } = registerControl('compressorRatio');
+export const { compressorAttack } = registerControl('compressorAttack');
+export const { compressorRelease } = registerControl('compressorRelease');
+/**
+ * Changes the speed of sample playback, i.e. a cheap way of changing pitch.
+ *
+ * @name speed
+ * @param {number | Pattern} speed -inf to inf, negative numbers play the sample backwards.
+ * @example
+ * s("bd*6").speed("1 2 4 1 -2 -4")
+ * @example
+ * speed("1 1.5*2 [2 1.1]").s("piano").clip(1)
+ *
+ */
+export const { speed } = registerControl('speed');
+/**
+ * Used in conjunction with `speed`, accepts values of "r" (rate, default behavior), "c" (cycles), or "s" (seconds). Using `unit "c"` means `speed` will be interpreted in units of cycles, e.g. `speed "1"` means samples will be stretched to fill a cycle. Using `unit "s"` means the playback speed will be adjusted so that the duration is the number of seconds specified by `speed`.
+ *
+ * @name unit
+ * @param {number | string | Pattern} unit see description above
+ * @example
+ * speed("1 2 .5 3").s("bd").unit("c").osc()
+ * @superdirtOnly
+ *
+ */
+export const { unit } = registerControl('unit');
+/**
+ * Made by Calum Gunn. Reminiscent of some weird mixture of filter, ring-modulator and pitch-shifter. The SuperCollider manual defines Squiz as:
+ *
+ * "A simplistic pitch-raising algorithm. It's not meant to sound natural; its sound is reminiscent of some weird mixture of filter, ring-modulator and pitch-shifter, depending on the input. The algorithm works by cutting the signal into fragments (delimited by upwards-going zero-crossings) and squeezing those fragments in the time domain (i.e. simply playing them back faster than they came in), leaving silences inbetween. All the parameters apart from memlen can be modulated."
+ *
+ * @name squiz
+ * @param {number | Pattern} squiz Try passing multiples of 2 to it - 2, 4, 8 etc.
+ * @example
+ * squiz("2 4/2 6 [8 16]").s("bd").osc()
+ * @superdirtOnly
+ *
+ */
+export const { squiz } = registerControl('squiz');
+// TODO: what is this? not found in tidal doc
+// ['stutterdepth'],
+// TODO: what is this? not found in tidal doc
+// ['stuttertime'],
+// TODO: what is this? not found in tidal doc
+// ['timescale'],
+// TODO: what is this? not found in tidal doc
+// ['timescalewin'],
+// ['tomdecay'],
+// ['vcfegint'],
+// ['vcoegint'],
+// TODO: Use a rest (~) to override the effect <- vowel
+/**
+ *
+ * Formant filter to make things sound like vowels.
+ *
+ * @name vowel
+ * @param {string | Pattern} vowel You can use a e i o u ae aa oe ue y uh un en an on, corresponding to [a] [e] [i] [o] [u] [æ] [ɑ] [ø] [y] [ɯ] [ʌ] [œ̃] [ɛ̃] [ɑ̃] [ɔ̃]. Aliases: aa = å = ɑ, oe = ø = ö, y = ı, ae = æ.
+ * @example
+ * note("[c2 <eb2 <g2 g1>>]*2").s('sawtooth')
+ * .vowel("<a e i <o u>>")
+ * @example
+ * s("bd sd mt ht bd [~ cp] ht lt").vowel("[a|e|i|o|u]")
+ *
+ */
+export const { vowel } = registerControl('vowel');
+/* // TODO: find out how it works
+ * Made by Calum Gunn. Divides an audio stream into tiny segments, using the signal's zero-crossings as segment boundaries, and discards a fraction of them. Takes a number between 1 and 100, denoted the percentage of segments to drop. The SuperCollider manual describes the Waveloss effect this way:
+ *
+ * Divide an audio stream into tiny segments, using the signal's zero-crossings as segment boundaries, and discard a fraction of them (i.e. replace them with silence of the same length). The technique was described by Trevor Wishart in a lecture. Parameters: the filter drops drop out of out of chunks. mode can be 1 to drop chunks in a simple deterministic fashion (e.g. always dropping the first 30 out of a set of 40 segments), or 2 to drop chunks randomly but in an appropriate proportion.)
+ *
+ * mode: ?
+ * waveloss: ?
+ *
+ * @name waveloss
+ */
+export const { waveloss } = registerControl('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))
+ *
+ */
+export const { density } = registerControl('density');
+// TODO: midi effects?
+export const { dur } = registerControl('dur');
+// ['modwheel'],
+export const { expression } = registerControl('expression');
+export const { sustainpedal } = registerControl('sustainpedal');
+/* // TODO: doesn't seem to do anything
+ *
+ * Tremolo Audio DSP effect
+ *
+ * @name tremolodepth
+ * @param {number | Pattern} depth between 0 and 1
+ * @example
+ * n("0,4,7").tremolodepth("<0 .3 .6 .9>").osc()
+ *
+ */
+export const { tremolodepth, tremdp } = registerControl('tremolodepth', 'tremdp');
+export const { tremolorate, tremr } = registerControl('tremolorate', 'tremr');
+
+export const { fshift } = registerControl('fshift');
+export const { fshiftnote } = registerControl('fshiftnote');
+export const { fshiftphase } = registerControl('fshiftphase');
+
+export const { triode } = registerControl('triode');
+export const { krush } = registerControl('krush');
+export const { kcutoff } = registerControl('kcutoff');
+export const { octer } = registerControl('octer');
+export const { octersub } = registerControl('octersub');
+export const { octersubsub } = registerControl('octersubsub');
+export const { ring } = registerControl('ring');
+export const { ringf } = registerControl('ringf');
+export const { ringdf } = registerControl('ringdf');
+export const { distort } = registerControl('distort');
+export const { freeze } = registerControl('freeze');
+export const { xsdelay } = registerControl('xsdelay');
+export const { tsdelay } = registerControl('tsdelay');
+export const { real } = registerControl('real');
+export const { imag } = registerControl('imag');
+export const { enhance } = registerControl('enhance');
+export const { partials } = registerControl('partials');
+export const { comb } = registerControl('comb');
+export const { smear } = registerControl('smear');
+export const { scram } = registerControl('scram');
+export const { binshift } = registerControl('binshift');
+export const { hbrick } = registerControl('hbrick');
+export const { lbrick } = registerControl('lbrick');
+export const { midichan } = registerControl('midichan');
+export const { control } = registerControl('control');
+export const { ccn } = registerControl('ccn');
+export const { ccv } = registerControl('ccv');
+export const { polyTouch } = registerControl('polyTouch');
+export const { midibend } = registerControl('midibend');
+export const { miditouch } = registerControl('miditouch');
+export const { ctlNum } = registerControl('ctlNum');
+export const { frameRate } = registerControl('frameRate');
+export const { frames } = registerControl('frames');
+export const { hours } = registerControl('hours');
+export const { midicmd } = registerControl('midicmd');
+export const { minutes } = registerControl('minutes');
+export const { progNum } = registerControl('progNum');
+export const { seconds } = registerControl('seconds');
+export const { songPtr } = registerControl('songPtr');
+export const { uid } = registerControl('uid');
+export const { val } = registerControl('val');
+export const { cps } = registerControl('cps');
+/**
+ * Multiplies the duration with the given number. Also cuts samples off at the end if they exceed the duration.
+ * In tidal, this would be done with legato, [which has a complicated history in strudel](https://github.com/tidalcycles/strudel/issues/111).
+ * For now, if you're coming from tidal, just think clip = legato.
+ *
+ * @name clip
+ * @param {number | Pattern} factor >= 0
+ * @example
+ * note("c a f e").s("piano").clip("<.5 1 2>")
+ *
+ */
+export const { clip } = registerControl('clip');
+
+// ZZFX
+export const { zrand } = registerControl('zrand');
+export const { curve } = registerControl('curve');
+// superdirt duplicate
+// export const {slide]} = registerControl('slide']);
+export const { deltaSlide } = registerControl('deltaSlide');
+export const { pitchJump } = registerControl('pitchJump');
+export const { pitchJumpTime } = registerControl('pitchJumpTime');
+export const { lfo, repeatTime } = registerControl('lfo', 'repeatTime');
+// noise on the frequency or as bubo calls it "frequency fog" :)
+export const { znoise } = registerControl('znoise');
+export const { zmod } = registerControl('zmod');
+// like crush but scaled differently
+export const { zcrush } = registerControl('zcrush');
+export const { zdelay } = registerControl('zdelay');
+export const { tremolo } = registerControl('tremolo');
+export const { zzfx } = registerControl('zzfx');
+
+// TODO: slice / splice https://www.youtube.com/watch?v=hKhPdO0RKDQ&list=PL2lW1zNIIwj3bDkh-Y3LUGDuRcoUigoDs&index=13
+
+export let createParams = (...names) =>
+  names.reduce((acc, name) => Object.assign(acc, { [name]: createParam(name) }), {});
 
 /**
  * ADSR envelope: Combination of Attack, Decay, Sustain, and Release.
@@ -1469,25 +1500,23 @@ controls.createParams = (...names) =>
  * @example
  * note("[c3 bb2 f3 eb3]*2").sound("sawtooth").lpf(600).adsr(".1:.1:.5:.2")
  */
-controls.adsr = register('adsr', (adsr, pat) => {
+export const adsr = register('adsr', (adsr, pat) => {
   adsr = !Array.isArray(adsr) ? [adsr] : adsr;
   const [attack, decay, sustain, release] = adsr;
   return pat.set({ attack, decay, sustain, release });
 });
-controls.ad = register('ad', (t, pat) => {
+export const ad = register('ad', (t, pat) => {
   t = !Array.isArray(t) ? [t] : t;
   const [attack, decay = attack] = t;
   return pat.attack(attack).decay(decay);
 });
-controls.ds = register('ds', (t, pat) => {
+export const ds = register('ds', (t, pat) => {
   t = !Array.isArray(t) ? [t] : t;
   const [decay, sustain = 0] = t;
   return pat.set({ decay, sustain });
 });
-controls.ds = register('ar', (t, pat) => {
+export const ar = register('ar', (t, pat) => {
   t = !Array.isArray(t) ? [t] : t;
   const [attack, release = attack] = t;
   return pat.set({ attack, release });
 });
-
-export default controls;
diff --git a/packages/core/index.mjs b/packages/core/index.mjs
index d9386417..9d998349 100644
--- a/packages/core/index.mjs
+++ b/packages/core/index.mjs
@@ -4,11 +4,12 @@ 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 controls from './controls.mjs';
+import * as controls from './controls.mjs'; // legacy
 export * from './euclid.mjs';
 import Fraction from './fraction.mjs';
 import { logger } from './logger.mjs';
 export { Fraction, controls };
+export * from './controls.mjs';
 export * from './hap.mjs';
 export * from './pattern.mjs';
 export * from './signal.mjs';

From 664a19a5c48ca68f087513275deea02672c45b8a Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 28 Feb 2024 00:36:44 +0100
Subject: [PATCH 26/27] refactor: remove now redundant controls imports

---
 examples/codemirror-repl/main.js     |  3 +--
 examples/minimal-repl/main.js        | 13 ++++---------
 packages/core/animate.mjs            |  4 +---
 packages/core/test/controls.test.mjs | 10 +++++-----
 packages/core/test/pattern.test.mjs  |  3 +--
 packages/core/test/value.test.mjs    |  3 +--
 packages/repl/prebake.mjs            |  3 +--
 packages/tonal/test/tonal.test.mjs   |  3 +--
 packages/web/web.mjs                 |  3 +--
 packages/webaudio/README.md          |  3 +--
 test/runtime.mjs                     |  5 +----
 website/src/repl/util.mjs            |  8 ++------
 12 files changed, 20 insertions(+), 41 deletions(-)

diff --git a/examples/codemirror-repl/main.js b/examples/codemirror-repl/main.js
index ff83122f..815db187 100644
--- a/examples/codemirror-repl/main.js
+++ b/examples/codemirror-repl/main.js
@@ -1,6 +1,6 @@
 import { StrudelMirror } from '@strudel/codemirror';
 import { funk42 } from './tunes';
-import { drawPianoroll, evalScope, controls } from '@strudel/core';
+import { drawPianoroll, evalScope } from '@strudel/core';
 import './style.css';
 import { initAudioOnFirstClick } from '@strudel/webaudio';
 import { transpiler } from '@strudel/transpiler';
@@ -25,7 +25,6 @@ const editor = new StrudelMirror({
   prebake: async () => {
     initAudioOnFirstClick(); // needed to make the browser happy (don't await this here..)
     const loadModules = evalScope(
-      controls,
       import('@strudel/core'),
       import('@strudel/mini'),
       import('@strudel/tonal'),
diff --git a/examples/minimal-repl/main.js b/examples/minimal-repl/main.js
index 68dabe52..aa3bc7cf 100644
--- a/examples/minimal-repl/main.js
+++ b/examples/minimal-repl/main.js
@@ -1,5 +1,5 @@
-import { controls, repl, evalScope } from '@strudel/core';
-import { getAudioContext, webaudioOutput, initAudioOnFirstClick } from '@strudel/webaudio';
+import { repl, evalScope } from '@strudel/core';
+import { getAudioContext, webaudioOutput, initAudioOnFirstClick, registerSynthSounds } from '@strudel/webaudio';
 import { transpiler } from '@strudel/transpiler';
 import tune from './tune.mjs';
 
@@ -7,14 +7,9 @@ const ctx = getAudioContext();
 const input = document.getElementById('text');
 input.innerHTML = tune;
 initAudioOnFirstClick();
+registerSynthSounds();
 
-evalScope(
-  controls,
-  import('@strudel/core'),
-  import('@strudel/mini'),
-  import('@strudel/webaudio'),
-  import('@strudel/tonal'),
-);
+evalScope(import('@strudel/core'), import('@strudel/mini'), import('@strudel/webaudio'), import('@strudel/tonal'));
 
 const { evaluate } = repl({
   defaultOutput: webaudioOutput,
diff --git a/packages/core/animate.mjs b/packages/core/animate.mjs
index e9650c02..cc7e59b2 100644
--- a/packages/core/animate.mjs
+++ b/packages/core/animate.mjs
@@ -1,6 +1,4 @@
-import { Pattern, getDrawContext, silence, register, pure } from './index.mjs';
-import controls from './controls.mjs'; // do not import from index.mjs as it breaks for some reason..
-const { createParams } = controls;
+import { Pattern, getDrawContext, silence, register, pure, createParams } from './index.mjs';
 
 let clearColor = '#22222210';
 
diff --git a/packages/core/test/controls.test.mjs b/packages/core/test/controls.test.mjs
index 49aa6a4f..aa66bf98 100644
--- a/packages/core/test/controls.test.mjs
+++ b/packages/core/test/controls.test.mjs
@@ -4,23 +4,23 @@ Copyright (C) 2023 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 controls from '../controls.mjs';
+import { s } from '../controls.mjs';
 import { mini } from '../../mini/mini.mjs';
 import { describe, it, expect } from 'vitest';
 
 describe('controls', () => {
   it('should support controls', () => {
-    expect(controls.s('bd').firstCycleValues).toEqual([{ s: 'bd' }]);
+    expect(s('bd').firstCycleValues).toEqual([{ s: 'bd' }]);
   });
   it('should support compound controls', () => {
-    expect(controls.s(mini('bd:3')).firstCycleValues).toEqual([{ s: 'bd', n: 3 }]);
-    expect(controls.s(mini('bd:3 sd:4:1.4')).firstCycleValues).toEqual([
+    expect(s(mini('bd:3')).firstCycleValues).toEqual([{ s: 'bd', n: 3 }]);
+    expect(s(mini('bd:3 sd:4:1.4')).firstCycleValues).toEqual([
       { s: 'bd', n: 3 },
       { s: 'sd', n: 4, gain: 1.4 },
     ]);
   });
   it('should support ignore extra elements in compound controls', () => {
-    expect(controls.s(mini('bd:3:0.4 sd:4:0.5:3:17')).firstCycleValues).toEqual([
+    expect(s(mini('bd:3:0.4 sd:4:0.5:3:17')).firstCycleValues).toEqual([
       { s: 'bd', n: 3, gain: 0.4 },
       { s: 'sd', n: 4, gain: 0.5 },
     ]);
diff --git a/packages/core/test/pattern.test.mjs b/packages/core/test/pattern.test.mjs
index bd0aa52b..566038fd 100644
--- a/packages/core/test/pattern.test.mjs
+++ b/packages/core/test/pattern.test.mjs
@@ -51,9 +51,8 @@ import {
 
 import { steady } from '../signal.mjs';
 
-import controls from '../controls.mjs';
+import { n, s } from '../controls.mjs';
 
-const { n, s } = controls;
 const st = (begin, end) => new State(ts(begin, end));
 const ts = (begin, end) => new TimeSpan(Fraction(begin), Fraction(end));
 const hap = (whole, part, value, context = {}) => new Hap(whole, part, value, context);
diff --git a/packages/core/test/value.test.mjs b/packages/core/test/value.test.mjs
index 1a209623..c5472607 100644
--- a/packages/core/test/value.test.mjs
+++ b/packages/core/test/value.test.mjs
@@ -6,8 +6,7 @@ This program is free software: you can redistribute it and/or modify it under th
 
 import { describe, it, expect } from 'vitest';
 import { map, valued, mul } from '../value.mjs';
-import controls from '../controls.mjs';
-const { n } = controls;
+import { n } from '../controls.mjs';
 
 describe('Value', () => {
   it('unionWith', () => {
diff --git a/packages/repl/prebake.mjs b/packages/repl/prebake.mjs
index 930f263c..4315b85c 100644
--- a/packages/repl/prebake.mjs
+++ b/packages/repl/prebake.mjs
@@ -1,4 +1,4 @@
-import { controls, noteToMidi, valueToMidi, Pattern, evalScope } from '@strudel/core';
+import { noteToMidi, valueToMidi, Pattern, evalScope } from '@strudel/core';
 import { registerSynthSounds, registerZZFXSounds, samples } from '@strudel/webaudio';
 import * as core from '@strudel/core';
 
@@ -17,7 +17,6 @@ export async function prebake() {
     // import('@strudel/serial'),
     // import('@strudel/csound'),
     // import('@strudel/osc'),
-    controls, // sadly, this cannot be exported from core directly (yet)
   );
   // load samples
   const ds = 'https://raw.githubusercontent.com/felixroos/dough-samples/main/';
diff --git a/packages/tonal/test/tonal.test.mjs b/packages/tonal/test/tonal.test.mjs
index 6dfdcfac..2b829ecb 100644
--- a/packages/tonal/test/tonal.test.mjs
+++ b/packages/tonal/test/tonal.test.mjs
@@ -7,10 +7,9 @@ This program is free software: you can redistribute it and/or modify it under th
 // import { strict as assert } from 'assert';
 
 import '../tonal.mjs'; // need to import this to add prototypes
-import { pure, controls, seq } from '@strudel/core';
+import { pure, n, seq } from '@strudel/core';
 import { describe, it, expect } from 'vitest';
 import { mini } from '../../mini/mini.mjs';
-const { n } = controls;
 
 describe('tonal', () => {
   it('Should run tonal functions ', () => {
diff --git a/packages/web/web.mjs b/packages/web/web.mjs
index e7164197..660acf26 100644
--- a/packages/web/web.mjs
+++ b/packages/web/web.mjs
@@ -5,7 +5,7 @@ export * from '@strudel/transpiler';
 export * from '@strudel/mini';
 export * from '@strudel/tonal';
 export * from '@strudel/webaudio';
-import { Pattern, evalScope, controls } from '@strudel/core';
+import { Pattern, evalScope } from '@strudel/core';
 import { initAudioOnFirstClick, registerSynthSounds, webaudioScheduler } from '@strudel/webaudio';
 // import { registerSoundfonts } from '@strudel/soundfonts';
 import { evaluate as _evaluate } from '@strudel/transpiler';
@@ -15,7 +15,6 @@ import { miniAllStrings } from '@strudel/mini';
 export async function defaultPrebake() {
   const loadModules = evalScope(
     evalScope,
-    controls,
     import('@strudel/core'),
     import('@strudel/mini'),
     import('@strudel/tonal'),
diff --git a/packages/webaudio/README.md b/packages/webaudio/README.md
index 442dc4dd..d89a6d39 100644
--- a/packages/webaudio/README.md
+++ b/packages/webaudio/README.md
@@ -12,9 +12,8 @@ npm i @strudel/webaudio --save
 ## Example
 
 ```js
-import { repl, controls } from "@strudel/core";
+import { repl, note } from "@strudel/core";
 import { initAudioOnFirstClick, getAudioContext, webaudioOutput } from "@strudel/webaudio";
-const { note } = controls;
 
 initAudioOnFirstClick();
 const ctx = getAudioContext();
diff --git a/test/runtime.mjs b/test/runtime.mjs
index 6a40b09d..946c2759 100644
--- a/test/runtime.mjs
+++ b/test/runtime.mjs
@@ -7,7 +7,6 @@ import { evaluate } from '@strudel/transpiler';
 import { evalScope } from '@strudel/core';
 import * as strudel from '@strudel/core';
 import * as webaudio from '@strudel/webaudio';
-import controls from '@strudel/core/controls.mjs';
 // import gist from '@strudel/core/gist.js';
 import { mini, m } from '@strudel/mini/mini.mjs';
 // import * as voicingHelpers from '@strudel/tonal/voicings.mjs';
@@ -21,7 +20,6 @@ import '@strudel/xen/xen.mjs';
 // import '@strudel/osc/osc.mjs';
 // import '@strudel/webaudio/webaudio.mjs';
 // import '@strudel/serial/serial.mjs';
-// import controls from '@strudel/core/controls.mjs';
 import '../website/src/repl/piano';
 
 class MockedNode {
@@ -153,10 +151,9 @@ evalScope(
   strudel,
   toneHelpersMocked,
   uiHelpersMocked,
-  controls,
   webaudio,
   tonalHelpers,
-  /* controls,
+  /*
   toneHelpers,
   voicingHelpers,
   drawHelpers,
diff --git a/website/src/repl/util.mjs b/website/src/repl/util.mjs
index 08e31d42..397e2801 100644
--- a/website/src/repl/util.mjs
+++ b/website/src/repl/util.mjs
@@ -1,4 +1,4 @@
-import { controls, evalScope, hash2code, logger } from '@strudel/core';
+import { evalScope, hash2code, logger } from '@strudel/core';
 import { settingPatterns, defaultAudioDeviceName } from '../settings.mjs';
 import { getAudioContext, initializeAudioOutput, setDefaultAudioContext } from '@strudel/webaudio';
 
@@ -92,11 +92,7 @@ export function loadModules() {
     modules = modules.concat([import('@strudel/midi'), import('@strudel/osc')]);
   }
 
-  return evalScope(
-    controls, // sadly, this cannot be exported from core direclty
-    settingPatterns,
-    ...modules,
-  );
+  return evalScope(settingPatterns, ...modules);
 }
 
 let lastShared;

From abe25be05ef4335793252e4091e95797b1390a1b Mon Sep 17 00:00:00 2001
From: Felix Roos <flix91@gmail.com>
Date: Wed, 28 Feb 2024 00:36:59 +0100
Subject: [PATCH 27/27] fix examples

---
 examples/buildless/minimal-repl.html | 3 ++-
 examples/minimal-repl/tune.mjs       | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/examples/buildless/minimal-repl.html b/examples/buildless/minimal-repl.html
index c46b25ce..0e3fc32c 100644
--- a/examples/buildless/minimal-repl.html
+++ b/examples/buildless/minimal-repl.html
@@ -16,6 +16,7 @@
     </div>
     <div id="output"></div>
     <script type="module">
+      // TODO: refactor to use newer version without controls import
       import { controls, repl, evalScope } from 'https://cdn.skypack.dev/@strudel/core@0.11.0';
       import { mini } from 'https://cdn.skypack.dev/@strudel/mini@0.11.0';
       import { transpiler } from 'https://cdn.skypack.dev/@strudel/transpiler@0.11.0';
@@ -53,7 +54,7 @@
 
       function getTune() {
         return `samples('github:tidalcycles/dirt-samples')
-
+setcps(1);
 stack(
   // amen
   n("0 1 2 3 4 5 6 7")
diff --git a/examples/minimal-repl/tune.mjs b/examples/minimal-repl/tune.mjs
index cf867127..69eb2961 100644
--- a/examples/minimal-repl/tune.mjs
+++ b/examples/minimal-repl/tune.mjs
@@ -1,5 +1,5 @@
 export default `samples('github:tidalcycles/dirt-samples')
-
+setcps(1)
 stack(
   // amen
   n("0 1 2 3 4 5 6 7")