Update docstring and add an example

Working version of inputs as sound sources
2026-09-02 14:19:49 -04:00 · 2026-01-11 19:10:02 -06:00 · 2026-01-11 19:03:20 -06:00
145 changed files with 972 additions and 3692 deletions
@@ -1,5 +0,0 @@
-{
-	"devToolbar": {
-		"enabled": false
-	}
-}
@@ -12,13 +12,6 @@ function defineTags(dictionary) {
      doclet.synonyms = doclet.synonyms_text.split(/[ ,]+/);
    },
  });
-
-  dictionary.defineTag('tags', {
-    mustHaveValue: true,
-    onTagged: function (doclet, tag) {
-      doclet.tags = tag.value.split(/[ ,]+/);
-    },
-  });
 }

 module.exports = { defineTags: defineTags };
@@ -1,211 +0,0 @@
-0 silly argv {
-0 silly argv   _: [ 'version' ],
-0 silly argv   private: false,
-0 silly argv   lernaVersion: '8.1.9',
-0 silly argv   '$0': 'node_modules/lerna/dist/cli.js'
-0 silly argv }
-1 notice cli v8.1.9
-2 verbose packageConfigs Explicit "packages" configuration found in lerna.json. Resolving packages using the configured glob(s): ["packages/*"]
-3 verbose rootPath /Users/jaderose/Documents/Github/cstrudel/strudel
-4 info versioning independent
-5 silly isAnythingCommitted
-6 verbose isAnythingCommitted 1
-7 silly getCurrentBranch
-8 verbose currentBranch main
-9 silly remoteBranchExists
-10 silly isBehindUpstream
-11 silly isBehindUpstream main is behind origin/main by 0 commit(s) and ahead by 4
-12 silly hasTags
-13 verbose hasTags true
-14 silly git-describe.sync "@strudel/codemirror@1.2.7-4-ga3ac9646" => {"lastTagName":"@strudel/codemirror@1.2.7","lastVersion":"1.2.7","refCount":"4","sha":"a3ac9646","isDirty":false}
-15 info Looking for changed packages since @strudel/codemirror@1.2.7
-16 silly checking diff packages/codemirror
-17 silly no diff found in @strudel/codemirror
-18 silly checking diff packages/core
-19 silly no diff found in @strudel/core
-20 silly checking diff packages/csound
-21 silly no diff found in @strudel/csound
-22 silly checking diff packages/desktopbridge
-23 silly no diff found in @strudel/desktopbridge
-24 silly checking diff packages/draw
-25 silly no diff found in @strudel/draw
-26 silly checking diff packages/embed
-27 silly no diff found in @strudel/embed
-28 silly checking diff packages/gamepad
-29 silly no diff found in @strudel/gamepad
-30 silly checking diff packages/hs2js
-31 silly no diff found in hs2js
-32 silly checking diff packages/hydra
-33 silly no diff found in @strudel/hydra
-34 silly checking diff packages/midi
-35 silly no diff found in @strudel/midi
-36 silly checking diff packages/mini
-37 silly no diff found in @strudel/mini
-38 silly checking diff packages/mondo
-39 silly no diff found in mondolang
-40 silly checking diff packages/mondough
-41 silly no diff found in @strudel/mondo
-42 silly checking diff packages/motion
-43 silly no diff found in @strudel/motion
-44 silly checking diff packages/mqtt
-45 silly no diff found in @strudel/mqtt
-46 silly checking diff packages/osc
-47 silly found diff in packages/osc/server.js
-48 verbose filtered diff [ 'packages/osc/server.js' ]
-49 silly checking diff packages/reference
-50 silly no diff found in @strudel/reference
-51 silly checking diff packages/repl
-52 silly no diff found in @strudel/repl
-53 silly checking diff packages/sampler
-54 silly no diff found in @strudel/sampler
-55 silly checking diff packages/serial
-56 silly no diff found in @strudel/serial
-57 silly checking diff packages/soundfonts
-58 silly no diff found in @strudel/soundfonts
-59 silly checking diff packages/superdough
-60 silly found diff in packages/superdough/package.json
-61 verbose filtered diff [ 'packages/superdough/package.json' ]
-62 silly checking diff packages/supradough
-63 silly found diff in packages/supradough/package.json
-64 verbose filtered diff [ 'packages/supradough/package.json' ]
-65 silly checking diff packages/tidal
-66 silly no diff found in @strudel/tidal
-67 silly checking diff packages/tonal
-68 silly no diff found in @strudel/tonal
-69 silly checking diff packages/transpiler
-70 silly no diff found in @strudel/transpiler
-71 silly checking diff packages/vite-plugin-bundle-audioworklet
-72 silly no diff found in vite-plugin-bundle-audioworklet
-73 silly checking diff packages/web
-74 silly no diff found in @strudel/web
-75 silly checking diff packages/webaudio
-76 silly found diff in packages/webaudio/package.json
-77 verbose filtered diff [ 'packages/webaudio/package.json' ]
-78 silly checking diff packages/xen
-79 silly no diff found in @strudel/xen
-80 verbose updated @strudel/codemirror
-81 verbose updated @strudel/csound
-82 verbose updated @strudel/midi
-83 verbose updated @strudel/osc
-84 verbose updated @strudel/repl
-85 verbose updated @strudel/soundfonts
-86 verbose updated superdough
-87 verbose updated supradough
-88 verbose updated @strudel/web
-89 verbose updated @strudel/webaudio
-90 verbose git-describe undefined => "@strudel/codemirror@1.2.7-4-ga3ac9646"
-91 silly git-describe parsed => {"lastTagName":"@strudel/codemirror@1.2.7","lastVersion":"1.2.7","refCount":"4","sha":"a3ac9646","isDirty":false}
-92 info execute Skipping releases
-93 silly lifecycle No script for "preversion" in "@strudel/monorepo", continuing
-94 silly lifecycle No script for "preversion" in "@strudel/osc", continuing
-95 silly lifecycle No script for "preversion" in "superdough", continuing
-96 silly lifecycle No script for "preversion" in "supradough", continuing
-97 verbose version supradough has no lockfile. Skipping lockfile update.
-98 verbose version @strudel/osc has no lockfile. Skipping lockfile update.
-99 verbose version superdough has no lockfile. Skipping lockfile update.
-100 silly lifecycle No script for "version" in "supradough", continuing
-101 silly lifecycle No script for "version" in "superdough", continuing
-102 silly lifecycle No script for "preversion" in "@strudel/codemirror", continuing
-103 silly lifecycle No script for "preversion" in "@strudel/webaudio", continuing
-104 silly lifecycle No script for "version" in "@strudel/osc", continuing
-105 verbose version @strudel/webaudio has no lockfile. Skipping lockfile update.
-106 verbose version @strudel/codemirror has no lockfile. Skipping lockfile update.
-107 silly lifecycle No script for "version" in "@strudel/codemirror", continuing
-108 silly lifecycle No script for "version" in "@strudel/webaudio", continuing
-109 silly lifecycle No script for "preversion" in "@strudel/csound", continuing
-110 silly lifecycle No script for "preversion" in "@strudel/midi", continuing
-111 silly lifecycle No script for "preversion" in "@strudel/soundfonts", continuing
-112 silly lifecycle No script for "preversion" in "@strudel/web", continuing
-113 verbose version @strudel/csound has no lockfile. Skipping lockfile update.
-114 verbose version @strudel/midi has no lockfile. Skipping lockfile update.
-115 verbose version @strudel/soundfonts has no lockfile. Skipping lockfile update.
-116 verbose version @strudel/web has no lockfile. Skipping lockfile update.
-117 silly lifecycle No script for "version" in "@strudel/midi", continuing
-118 silly lifecycle No script for "version" in "@strudel/csound", continuing
-119 silly lifecycle No script for "version" in "@strudel/soundfonts", continuing
-120 silly lifecycle No script for "preversion" in "@strudel/repl", continuing
-121 verbose version @strudel/repl has no lockfile. Skipping lockfile update.
-122 silly lifecycle No script for "version" in "@strudel/web", continuing
-123 silly lifecycle No script for "version" in "@strudel/repl", continuing
-124 silly lifecycle No script for "version" in "@strudel/monorepo", continuing
-125 verbose version Updating root pnpm-lock.yaml
-126 silly version Skipped applying prettier to ignored file: packages/supradough/package.json
-127 silly version Skipped applying prettier to ignored file: packages/superdough/package.json
-128 silly version Skipped applying prettier to ignored file: packages/osc/package.json
-129 silly version Skipped applying prettier to ignored file: packages/codemirror/package.json
-130 silly version Skipped applying prettier to ignored file: packages/webaudio/package.json
-131 silly version Skipped applying prettier to ignored file: packages/midi/package.json
-132 silly version Skipped applying prettier to ignored file: packages/csound/package.json
-133 silly version Skipped applying prettier to ignored file: packages/soundfonts/package.json
-134 silly version Skipped applying prettier to ignored file: packages/web/package.json
-135 silly version Skipped applying prettier to ignored file: packages/repl/package.json
-136 silly version Skipped applying prettier to ignored file: pnpm-lock.yaml
-137 silly gitAdd [
-137 silly gitAdd   'packages/supradough/package.json',
-137 silly gitAdd   'packages/superdough/package.json',
-137 silly gitAdd   'packages/osc/package.json',
-137 silly gitAdd   'packages/codemirror/package.json',
-137 silly gitAdd   'packages/webaudio/package.json',
-137 silly gitAdd   'packages/midi/package.json',
-137 silly gitAdd   'packages/csound/package.json',
-137 silly gitAdd   'packages/soundfonts/package.json',
-137 silly gitAdd   'packages/web/package.json',
-137 silly gitAdd   'packages/repl/package.json',
-137 silly gitAdd   'pnpm-lock.yaml'
-137 silly gitAdd ]
-138 silly gitCommit Publish
-138 silly gitCommit
-138 silly gitCommit  - @strudel/codemirror@1.2.8
-138 silly gitCommit  - @strudel/csound@1.2.8
-138 silly gitCommit  - @strudel/midi@1.2.8
-138 silly gitCommit  - @strudel/osc@1.3.2
-138 silly gitCommit  - @strudel/repl@1.2.9
-138 silly gitCommit  - @strudel/soundfonts@1.2.8
-138 silly gitCommit  - superdough@1.2.5
-138 silly gitCommit  - supradough@1.2.4
-138 silly gitCommit  - @strudel/web@1.2.8
-138 silly gitCommit  - @strudel/webaudio@1.2.9
-139 verbose git [
-139 verbose git   'commit',
-139 verbose git   '-F',
-139 verbose git   '/private/var/folders/hc/yf_zr55547sbcpz5rj7q85sc0000gn/T/3c85b5d4-56ae-40e9-8df7-db2bc1048402/lerna-commit.txt'
-139 verbose git ]
-140 silly gitTag @strudel/codemirror@1.2.8 git tag %s -m %s
-141 verbose git [
-141 verbose git   'tag',
-141 verbose git   '@strudel/codemirror@1.2.8',
-141 verbose git   '-m',
-141 verbose git   '@strudel/codemirror@1.2.8'
-141 verbose git ]
-142 silly gitTag @strudel/csound@1.2.8 git tag %s -m %s
-143 verbose git [ 'tag', '@strudel/csound@1.2.8', '-m', '@strudel/csound@1.2.8' ]
-144 silly gitTag @strudel/midi@1.2.8 git tag %s -m %s
-145 verbose git [ 'tag', '@strudel/midi@1.2.8', '-m', '@strudel/midi@1.2.8' ]
-146 silly gitTag @strudel/osc@1.3.2 git tag %s -m %s
-147 verbose git [ 'tag', '@strudel/osc@1.3.2', '-m', '@strudel/osc@1.3.2' ]
-148 silly gitTag @strudel/repl@1.2.9 git tag %s -m %s
-149 verbose git [ 'tag', '@strudel/repl@1.2.9', '-m', '@strudel/repl@1.2.9' ]
-150 silly gitTag @strudel/soundfonts@1.2.8 git tag %s -m %s
-151 verbose git [
-151 verbose git   'tag',
-151 verbose git   '@strudel/soundfonts@1.2.8',
-151 verbose git   '-m',
-151 verbose git   '@strudel/soundfonts@1.2.8'
-151 verbose git ]
-152 silly gitTag superdough@1.2.5 git tag %s -m %s
-153 verbose git [ 'tag', 'superdough@1.2.5', '-m', 'superdough@1.2.5' ]
-154 silly gitTag supradough@1.2.4 git tag %s -m %s
-155 verbose git [ 'tag', 'supradough@1.2.4', '-m', 'supradough@1.2.4' ]
-156 silly gitTag @strudel/web@1.2.8 git tag %s -m %s
-157 verbose git [ 'tag', '@strudel/web@1.2.8', '-m', '@strudel/web@1.2.8' ]
-158 silly gitTag @strudel/webaudio@1.2.9 git tag %s -m %s
-159 verbose git [ 'tag', '@strudel/webaudio@1.2.9', '-m', '@strudel/webaudio@1.2.9' ]
-160 error Error: Command failed with exit code 128: git tag superdough@1.2.5 -m superdough@1.2.5
-160 error fatal: tag 'superdough@1.2.5' already exists
-160 error     at makeError (/Users/jaderose/Documents/Github/cstrudel/strudel/node_modules/.pnpm/execa@5.0.0/node_modules/execa/lib/error.js:59:11)
-160 error     at handlePromise (/Users/jaderose/Documents/Github/cstrudel/strudel/node_modules/.pnpm/execa@5.0.0/node_modules/execa/index.js:114:26)
-160 error     at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
-160 error     at async Promise.all (index 6)
-160 error     at async VersionCommand.gitCommitAndTagVersionForUpdates (/Users/jaderose/Documents/Github/cstrudel/strudel/node_modules/.pnpm/lerna@8.1.9_encoding@0.1.13/node_modules/lerna/dist/index.js:9957:11)
-160 error     at async VersionCommand.commitAndTagUpdates (/Users/jaderose/Documents/Github/cstrudel/strudel/node_modules/.pnpm/lerna@8.1.9_encoding@0.1.13/node_modules/lerna/dist/index.js:9933:18)
-160 error     at async Promise.all (index 0)
@@ -24,7 +24,6 @@ import { sliderPlugin, updateSliderWidgets } from './slider.mjs';
 import { activateTheme, initTheme, theme } from './themes.mjs';
 import { isTooltipEnabled } from './tooltip.mjs';
 import { updateWidgets, widgetPlugin } from './widget.mjs';
-import { jumpToCharacter } from './labelJump.mjs';

 export { toggleBlockComment, toggleBlockCommentByLine, toggleComment, toggleLineComment } from '@codemirror/commands';

@@ -120,14 +119,6 @@ export function initEditor({ initialCode = '', onChange, onEvaluate, onStop, roo
            preventDefault: true,
            run: () => onStop?.(),
          },
-          {
-            key: 'Alt-w',
-            run: (view) => jumpToCharacter(view, '$', 1),
-          },
-          {
-            key: 'Alt-q',
-            run: (view) => jumpToCharacter(view, '$', -1),
-          },
          /* {
            key: 'Ctrl-Shift-.',
            run: () => (onPanic ? onPanic() : onStop?.()),
@@ -434,7 +425,6 @@ function s4() {
 /**
 * Overrides the css of highlighted events. Make sure to use single quotes!
 * @name markcss
- * @tag visualization
 * @example
 * note("c a f e")
 * .markcss('text-decoration:underline')
@@ -1,31 +0,0 @@
-import { EditorSelection } from '@codemirror/state';
-import { SearchCursor } from '@codemirror/search';
-
-export function jumpToCharacter(view, character, direction = 1) {
-  const { state, dispatch } = view;
-  const pos = state.selection.main.head;
-  const cursor = new SearchCursor(state.doc, character);
-
-  let characterPositions = [];
-  let jumpPos;
-  while (!cursor.next().done) {
-    characterPositions.push(cursor.value.to);
-  }
-  if (!characterPositions.length) {
-    return false;
-  }
-  if (direction > 0) {
-    jumpPos = characterPositions.find((x) => x > pos + 1) ?? characterPositions.at(0); // Loop back around for convenience
-  } else {
-    jumpPos = characterPositions.reverse().find((x) => x < pos + 1) ?? characterPositions.at(0);
-  }
-
-  if (jumpPos == null) {
-    return false;
-  }
-  dispatch({
-    selection: EditorSelection.cursor(jumpPos - 1),
-    scrollIntoView: true,
-  });
-  return true;
-}
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/codemirror",
-  "version": "1.3.0",
+  "version": "1.2.6",
  "description": "Codemirror Extensions for Strudel",
  "main": "index.mjs",
  "publishConfig": {
@@ -117,7 +117,6 @@ export const sliderPlugin = ViewPlugin.fromClass(
 * Displays a slider widget to allow the user manipulate a value
 *
 * @name slider
- * @tags external_io, visualization
 * @param {number} value Initial value
 * @param {number} min Minimum value - optional, defaults to 0
 * @param {number} max Maximum value - optional, defaults to 1
@@ -198,7 +198,6 @@ export function activateTheme(name) {
  const themeSettings = settings[name] || settings.strudelTheme;
  // set css variables
  themeStyle.innerHTML = `:root {
-      color-scheme: ${themeSettings.light ? 'light' : 'dark'};
      ${Object.entries(themeSettings)
        // important to override fallback
        .map(([key, value]) => `--${key}: ${value} !important;`)
@@ -17,15 +17,13 @@ export const settings = {
  background: 'white',
  lineBackground: 'transparent',
  foreground: deepPurple,
-  muted: deepPurple + '50',
  caret: '#797977',
  selection: yellowPink,
  selectionMatch: '#2B323D',
-  gutterBackground: pinkAccent,
+  gutterBackground: grey,
  gutterForeground: lightGrey,
  gutterBorder: 'transparent',
  lineHighlight: pinkAccent,
-  light: true,
 };

 export default createTheme({
@@ -31,7 +31,6 @@ const palette = palettes['Sour Watermelon B'];
 export const settings = {
  background: palette[3],
  foreground: palette[1],
-  muted: palette[1] + '50',
  caret: palette[0],
  selection: palette[0],
  selectionMatch: palette[1],
@@ -8,7 +8,6 @@ export const settings = {
  background: '#282b2e',
  lineBackground: '#282b2e99',
  foreground: '#a9b7c6',
-  muted: '#a9b7c650',
  caret: '#00FF00',
  selection: '#343739',
  selectionMatch: '#343739',
@@ -20,7 +19,6 @@ export default createTheme({
  settings: {
    background: '#282b2e',
    foreground: '#a9b7c6',
-    muted: '#a9b7c650',
    caret: '#00FF00',
    selection: '#4e5254',
    selectionMatch: '#4e5254',
@@ -12,7 +12,6 @@ export const settings = {
  background: hex[0],
  lineBackground: 'transparent',
  foreground: hex[1],
-  muted: hex[2],
  selection: hex[2],
  selectionMatch: hex[0],
  gutterBackground: hex[0],
@@ -11,7 +11,6 @@ export const settings = {
  background: '#272C35',
  lineBackground: '#272C3599',
  foreground: 'hsl(220, 14%, 71%)',
-  muted: 'hsl(220, 14%, 41%)',
  caret: '#797977',
  selection: '#ffffff30',
  selectionMatch: '#2B323D',
@@ -26,7 +25,6 @@ export default createTheme({
  settings: {
    background: '#272C35',
    foreground: '#9d9b97',
-    muted: 'hsl(220, 14%, 41%)',
    caret: '#797977',
    selection: '#3d4c64',
    selectionMatch: '#3d4c64',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#21202e',
  lineBackground: '#21202e99',
  foreground: '#edecee',
-  muted: '#edecee50',
  caret: '#a277ff',
  selection: '#3d375e7f',
  selectionMatch: '#3d375e7f',
@@ -19,7 +18,6 @@ export default createTheme({
  settings: {
    background: '#21202e',
    foreground: '#edecee',
-    muted: '#edecee50',
    caret: '#a277ff',
    selection: '#5a51898f',
    selectionMatch: '#5a51898f',
@@ -6,7 +6,6 @@ export const settings = {
  background: '#FFFFFF',
  lineBackground: '#FFFFFF99',
  foreground: '#000000',
-  muted: '#00000050',
  caret: '#FBAC52',
  selection: '#FFD420',
  selectionMatch: '#FFD420',
@@ -21,7 +20,6 @@ export default createTheme({
  settings: {
    background: '#FFFFFF',
    foreground: '#000000',
-    muted: '#00000050',
    caret: '#FBAC52',
    selection: '#FFD420',
    selectionMatch: '#FFD420',
@@ -2,8 +2,7 @@ import { tags as t } from '@lezer/highlight';
 import { createTheme } from './theme-helper.mjs';
 export const settings = {
  background: 'black',
-  foreground: 'white',
-  muted: '#ffffff50',
+  foreground: 'white', // whats that?
  caret: 'white',
  selection: '#ffffff20',
  selectionMatch: '#036dd626',
@@ -3,8 +3,7 @@ import { createTheme } from './theme-helper.mjs';
 export const settings = {
  background: '#051DB5',
  lineBackground: '#051DB550',
-  foreground: 'white',
-  muted: '#ffffff50',
+  foreground: 'white', // whats that?
  caret: 'white',
  selection: 'rgba(128, 203, 196, 0.5)',
  selectionMatch: '#036dd626',
@@ -11,7 +11,6 @@ export const settings = {
  background: hex[0],
  lineBackground: 'transparent',
  foreground: hex[2],
-  muted: hex[3],
  selection: hex[3],
  selectionMatch: hex[0],
  gutterBackground: hex[0],
@@ -9,7 +9,6 @@ export const settings = {
  background: '#242424',
  lineBackground: '#24242499',
  foreground: '#f8f8f2',
-  muted: '#f8f8f250',
  caret: '#FFFFFF',
  selection: 'rgba(255, 255, 255, 0.1)',
  selectionMatch: 'rgba(255, 255, 255, 0.2)',
@@ -24,7 +23,6 @@ export default createTheme({
  settings: {
    background: '#242424',
    foreground: '#f8f8f2',
-    muted: '#f8f8f250',
    caret: '#FFFFFF',
    selection: 'rgba(255, 255, 255, 0.1)',
    selectionMatch: 'rgba(255, 255, 255, 0.2)',
@@ -11,7 +11,6 @@ export const settings = {
  background: '#282a36',
  lineBackground: '#282a3699',
  foreground: '#f8f8f2',
-  muted: '#f8f8f250',
  caret: '#f8f8f0',
  selection: 'rgba(255, 255, 255, 0.1)',
  selectionMatch: 'rgba(255, 255, 255, 0.2)',
@@ -28,7 +27,6 @@ export default createTheme({
  settings: {
    background: '#282a36',
    foreground: '#f8f8f2',
-    muted: '#f8f8f250',
    caret: '#f8f8f0',
    selection: 'rgba(255, 255, 255, 0.1)',
    selectionMatch: 'rgba(255, 255, 255, 0.2)',
@@ -10,7 +10,6 @@ export const settings = {
  background: '#2a2734',
  lineBackground: '#2a273499',
  foreground: '#eeebff',
-  muted: '#eeebff50',
  caret: '#ffad5c',
  selection: 'rgba(255, 255, 255, 0.1)',
  gutterBackground: '#2a2734',
@@ -23,7 +22,6 @@ export default createTheme({
  settings: {
    background: '#2a2734',
    foreground: '#6c6783',
-    muted: '#eeebff50',
    caret: '#ffad5c',
    selection: '#9a86fd',
    selectionMatch: '#9a86fd',
@@ -6,7 +6,6 @@ export const settings = {
  background: '#fff',
  lineBackground: '#ffffff99',
  foreground: '#000',
-  muted: '#00000050',
  caret: '#FFFFFF',
  selection: '#d7d4f0',
  selectionMatch: '#d7d4f0',
@@ -21,7 +20,6 @@ export default createTheme({
  settings: {
    background: '#fff',
    foreground: '#000',
-    muted: '#00000050',
    caret: '#FFFFFF',
    selection: '#d7d4f0',
    selectionMatch: '#d7d4f0',
@@ -23,7 +23,6 @@ export const settings = {
  background: hex[0],
  lineBackground: 'transparent',
  foreground: hex[10],
-  muted: hex[7],
  selection: hex[8],
  selectionMatch: hex[0],
  gutterBackground: hex[3],
@@ -5,7 +5,6 @@ export const settings = {
  background: '#0d1117',
  lineBackground: '#0d111799',
  foreground: '#c9d1d9',
-  muted: '#c9d1d950',
  caret: '#c9d1d9',
  selection: '#003d73',
  selectionMatch: '#003d73',
@@ -17,7 +16,6 @@ export default createTheme({
  settings: {
    background: '#0d1117',
    foreground: '#c9d1d9',
-    muted: '#c9d1d950',
    caret: '#c9d1d9',
    selection: '#003d73',
    selectionMatch: '#003d73',
@@ -6,7 +6,6 @@ export const settings = {
  background: '#fff',
  lineBackground: '#ffffff99',
  foreground: '#24292e',
-  muted: '#24292e50',
  selection: '#BBDFFF',
  selectionMatch: '#BBDFFF',
  gutterBackground: '#fff',
@@ -18,7 +17,6 @@ export default createTheme({
  settings: {
    background: '#fff',
    foreground: '#24292e',
-    muted: '#24292e50',
    selection: '#BBDFFF',
    selectionMatch: '#BBDFFF',
    gutterBackground: '#fff',
@@ -13,7 +13,6 @@ export const settings = {
  background: hex[0],
  lineBackground: 'transparent',
  foreground: hex[2],
-  muted: hex[2] + '50',
  selection: hex[4],
  selectionMatch: hex[0],
  gutterBackground: hex[0],
@@ -10,7 +10,6 @@ export const settings = {
  background: '#282828',
  lineBackground: '#28282899',
  foreground: '#ebdbb2',
-  muted: '#ebdbb250',
  caret: '#ebdbb2',
  selection: '#bdae93',
  selectionMatch: '#bdae93',
@@ -24,7 +23,6 @@ export default createTheme({
  settings: {
    background: '#282828',
    foreground: '#ebdbb2',
-    muted: '#ebdbb250',
    caret: '#ebdbb2',
    selection: '#b99d555c',
    selectionMatch: '#b99d555c',
@@ -11,7 +11,6 @@ export const settings = {
  background: '#fbf1c7',
  lineBackground: '#fbf1c799',
  foreground: '#3c3836',
-  muted: '#3c383650',
  caret: '#af3a03',
  selection: '#ebdbb2',
  selectionMatch: '#bdae93',
@@ -26,7 +25,6 @@ export default createTheme({
  settings: {
    background: '#fbf1c7',
    foreground: '#3c3836',
-    muted: '#3c383650',
    caret: '#af3a03',
    selection: '#bdae9391',
    selectionMatch: '#bdae9391',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#212121',
  lineBackground: '#21212199',
  foreground: '#bdbdbd',
-  muted: '#bdbdbd50',
  caret: '#a0a4ae',
  selection: '#d7d4f0',
  selectionMatch: '#d7d4f0',
@@ -20,7 +19,6 @@ export default createTheme({
  settings: {
    background: '#212121',
    foreground: '#bdbdbd',
-    muted: '#bdbdbd50',
    caret: '#a0a4ae',
    selection: '#d7d4f063',
    selectionMatch: '#d7d4f063',
@@ -5,8 +5,7 @@ export const settings = {
  light: true,
  background: '#FAFAFA',
  lineBackground: '#FAFAFA99',
-  foreground: '#6182B8',
-  muted: '#6182B850',
+  foreground: '#90A4AE',
  caret: '#272727',
  selection: '#80CBC440',
  selectionMatch: '#FAFAFA',
@@ -20,7 +19,6 @@ export default createTheme({
  settings: {
    background: '#FAFAFA',
    foreground: '#90A4AE',
-    muted: '#6182B850',
    caret: '#272727',
    selection: '#80CBC440',
    selectionMatch: '#80CBC440',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#272822',
  lineBackground: '#27282299',
  foreground: '#FFFFFF',
-  muted: '#FFFFFF50',
  caret: '#FFFFFF',
  selection: '#49483E',
  selectionMatch: '#49483E',
@@ -19,7 +18,6 @@ export default createTheme({
  settings: {
    background: '#272822',
    foreground: '#FFFFFF',
-    muted: '#FFFFFF50',
    caret: '#FFFFFF',
    selection: '#49483E',
    selectionMatch: '#49483E',
@@ -6,7 +6,6 @@ export const settings = {
  background: '#f2f1f8',
  lineBackground: '#f2f1f899',
  foreground: '#0c006b',
-  muted: '#0c006b50',
  caret: '#5c49e9',
  selection: '#d5d1f2',
  selectionMatch: '#d5d1f2',
@@ -20,7 +19,6 @@ export default createTheme({
  settings: {
    background: '#f2f1f8',
    foreground: '#0c006b',
-    muted: '#0c006b50',
    caret: '#5c49e9',
    selection: '#d5d1f2',
    selectionMatch: '#d5d1f2',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#2e3440',
  lineBackground: '#2e344099',
  foreground: '#FFFFFF',
-  muted: '#FFFFFF50',
  caret: '#FFFFFF',
  selection: '#3b4252',
  selectionMatch: '#e5e9f0',
@@ -21,7 +20,6 @@ export default createTheme({
  settings: {
    background: '#2e3440',
    foreground: '#FFFFFF',
-    muted: '#FFFFFF50',
    caret: '#FFFFFF',
    selection: '#00000073',
    selectionMatch: '#00000073',
@@ -13,7 +13,6 @@ export const settings = {
  background: hex[0],
  lineBackground: 'transparent',
  foreground: hex[2],
-  muted: hex[2] + '50',
  selection: hex[4],
  selectionMatch: hex[0],
  gutterBackground: hex[0],
@@ -5,7 +5,6 @@ export const settings = {
  background: '#002b36',
  lineBackground: '#002b3699',
  foreground: '#93a1a1',
-  muted: '#93a1a150',
  caret: '#839496',
  selection: '#173541',
  selectionMatch: '#aafe661a',
@@ -46,7 +45,6 @@ export default createTheme({
  settings: {
    background: c.background,
    foreground: c.foreground,
-    muted: c.muted,
    caret: c.cursor,
    selection: c.selection,
    selectionMatch: c.selection,
@@ -8,7 +8,6 @@ export const settings = {
  background: '#fdf6e3',
  lineBackground: '#fdf6e399',
  foreground: '#657b83',
-  muted: '#657b8350',
  caret: '#586e75',
  selection: '#dfd9c8',
  selectionMatch: '#dfd9c8',
@@ -20,7 +19,6 @@ export const settings = {
 const c = {
  background: '#FDF6E3',
  foreground: '#657B83',
-  muted: '#657b8350',
  selection: '#EEE8D5',
  selectionMatch: '#EEE8D5',
  cursor: '#657B83',
@@ -13,7 +13,6 @@ export const settings = {
  background: '#000000',
  lineBackground: 'transparent',
  foreground: hex[4],
-  muted: hex[6],
  selection: hex[6],
  gutterBackground: hex[0],
  gutterForeground: hex[5],
@@ -5,7 +5,6 @@ export const settings = {
  background: '#222',
  lineBackground: '#22222299',
  foreground: '#fff',
-  muted: '#8a919966',
  caret: '#ffcc00',
  selection: 'rgba(128, 203, 196, 0.5)',
  selectionMatch: '#036dd626',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#303841',
  lineBackground: '#30384199',
  foreground: '#FFFFFF',
-  muted: '#FFFFFF50',
  caret: '#FBAC52',
  selection: '#4C5964',
  selectionMatch: '#3A546E',
@@ -19,7 +18,6 @@ export default createTheme({
  settings: {
    background: '#303841',
    foreground: '#FFFFFF',
-    muted: '#FFFFFF50',
    caret: '#FBAC52',
    selection: '#4C5964',
    selectionMatch: '#3A546E',
@@ -9,8 +9,7 @@ let colorD = '#f8fc55';

 export const settings = {
  background: '#000000',
-  foreground: colorA,
-  muted: colorA + '50',
+  foreground: colorA, // whats that?
  caret: colorC,
  selection: colorD,
  selectionMatch: colorA,
@@ -4,8 +4,7 @@ import { createTheme } from './theme-helper.mjs';
 export const settings = {
  background: '#24283b',
  lineBackground: '#24283b99',
-  foreground: '#f9f2f9',
-  muted: '#f9f2f950',
+  foreground: '#7982a9',
  caret: '#c0caf5',
  selection: '#6f7bb630',
  selectionMatch: '#1f2335',
@@ -19,8 +18,7 @@ export default createTheme({
  theme: 'dark',
  settings: {
    background: '#24283b',
-    foreground: '#f9f2f9',
-    muted: '#f9f2f950',
+    foreground: '#7982a9',
    caret: '#c0caf5',
    selection: '#6f7bb630',
    selectionMatch: '#343b5f',
@@ -4,8 +4,7 @@ import { createTheme } from './theme-helper.mjs';
 export const settings = {
  background: '#1a1b26',
  lineBackground: '#1a1b2699',
-  foreground: '#f8fcf9',
-  muted: '#f8fcf950',
+  foreground: '#787c99',
  caret: '#c0caf5',
  selection: '#515c7e40',
  selectionMatch: '#16161e',
@@ -19,8 +18,7 @@ export default createTheme({
  theme: 'dark',
  settings: {
    background: '#1a1b26',
-    foreground: '#f8fcf9',
-    muted: '#f8fcf950',
+    foreground: '#787c99',
    caret: '#c0caf5',
    selection: '#515c7e40',
    selectionMatch: '#16161e',
@@ -6,7 +6,6 @@ export const settings = {
  background: '#e1e2e7',
  lineBackground: '#e1e2e799',
  foreground: '#3760bf',
-  muted: '#3760bf50',
  caret: '#3760bf',
  selection: '#99a7df',
  selectionMatch: '#99a7df',
@@ -21,7 +20,6 @@ export default createTheme({
  settings: {
    background: '#e1e2e7',
    foreground: '#3760bf',
-    muted: '#3760bf50',
    caret: '#3760bf',
    selection: '#99a7df',
    selectionMatch: '#99a7df',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#1e1e1e',
  lineBackground: '#1e1e1e99',
  foreground: '#fff',
-  muted: '#ffffff50',
  caret: '#c6c6c6',
  selection: '#6199ff2f',
  selectionMatch: '#72a1ff59',
@@ -20,7 +19,6 @@ export default createTheme({
  settings: {
    background: '#1e1e1e',
    foreground: '#fff',
-    muted: '#ffffff50',
    caret: '#c6c6c6',
    selection: '#6199ff2f',
    selectionMatch: '#72a1ff59',
@@ -5,7 +5,6 @@ export const settings = {
  background: '#ffffff',
  lineBackground: '#ffffff50',
  foreground: '#383a42',
-  muted: '#383a4250',
  caret: '#000',
  selection: '#add6ff',
  selectionMatch: '#a8ac94',
@@ -21,7 +20,6 @@ export default createTheme({
  settings: {
    background: '#ffffff',
    foreground: '#383a42',
-    muted: '#383a4250',
    caret: '#000',
    selection: '#add6ff',
    selectionMatch: '#a8ac94',
@@ -2,8 +2,7 @@ import { tags as t } from '@lezer/highlight';
 import { createTheme } from './theme-helper.mjs';
 export const settings = {
  background: 'white',
-  foreground: 'black',
-  muted: '#00000050',
+  foreground: 'black', // whats that?
  caret: 'black',
  selection: 'rgba(128, 203, 196, 0.5)',
  selectionMatch: '#ffffff26',
@@ -6,7 +6,6 @@ export const settings = {
  background: '#fff',
  lineBackground: '#ffffff99',
  foreground: '#3D3D3D',
-  muted: '#3D3D3D50',
  selection: '#BBDFFF',
  selectionMatch: '#BBDFFF',
  gutterBackground: '#fff',
@@ -19,7 +18,6 @@ export default createTheme({
  settings: {
    background: '#fff',
    foreground: '#3D3D3D',
-    muted: '#3D3D3D50',
    selection: '#BBDFFF',
    selectionMatch: '#BBDFFF',
    gutterBackground: '#fff',
@@ -15,7 +15,6 @@ import Fraction, { gcd } from './fraction.mjs';
 * - "-" hold previous value
 * - "." silence
 *
- * @tags visualization
 * @param {Pattern} pattern the pattern to use
 * @param {number} chars max number of characters (approximately)
 * @returns string
@@ -61,7 +61,6 @@ export const bjorklund = function (ons, steps) {
 *
 * @memberof Pattern
 * @name euclid
- * @tags temporal
 * @param {number} pulses the number of onsets/beats
 * @param {number} steps the number of steps to fill
 * @returns Pattern
@@ -74,7 +73,6 @@ export const bjorklund = function (ons, steps) {
 * Like `euclid`, but has an additional parameter for 'rotating' the resulting sequence.
 * @memberof Pattern
 * @name euclidRot
- * @tags temporal
 * @param {number} pulses the number of onsets/beats
 * @param {number} steps the number of steps to fill
 * @param {number} rotation offset in steps
@@ -158,7 +156,6 @@ export const { euclidrot, euclidRot } = register(['euclidrot', 'euclidRot'], fun
 * so there will be no gaps.
 * @name euclidLegato
 * @memberof Pattern
- * @tags temporal
 * @param {number} pulses the number of onsets/beats
 * @param {number} steps the number of steps to fill
 * @param rotation offset in steps
@@ -190,7 +187,6 @@ export const euclidLegato = register(['euclidLegato'], function (pulses, steps,
 * the resulting sequence
 * @name euclidLegatoRot
 * @memberof Pattern
- * @tags temporal
 * @param {number} pulses the number of onsets/beats
 * @param {number} steps the number of steps to fill
 * @param {number} rotation offset in steps
@@ -212,7 +208,6 @@ export const euclidLegatoRot = register(['euclidLegatoRot'], function (pulses, s
 * @name euclidish
 * @synonyms eish
 * @memberof Pattern
- * @tags temporal
 * @param {number} pulses the number of onsets
 * @param {number} steps the number of steps to fill
 * @param {number} groove exists between the extremes of 0 (straight euclidian) and 1 (straight pulse)
@@ -22,7 +22,7 @@ export * from './repl.mjs';
 export * from './signal.mjs';
 export * from './speak.mjs';
 export * from './state.mjs';
-export * from './schedulerState.mjs';
+export * from './time.mjs';
 export * from './timespan.mjs';
 export * from './ui.mjs';
 export * from './util.mjs';
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/core",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Port of Tidal Cycles to JavaScript",
  "main": "index.mjs",
  "type": "module",
@@ -28,7 +28,6 @@ const _pick = function (lookup, pat, modulo = true) {

 /** * Picks patterns (or plain values) either from a list (by index) or a lookup table (by name).
 * Similar to `inhabit`, but maintains the structure of the original patterns.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -58,7 +57,6 @@ const __pick = register('pick', function (lookup, pat) {
 * it wraps around, rather than sticking at the maximum value.
 * For example, if you pick the fifth pattern of a list of three, you'll get the
 * second one.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -69,7 +67,6 @@ export const pickmod = register('pickmod', function (lookup, pat) {
 });

 /** * pickF lets you use a pattern of numbers to pick which function to apply to another pattern.
- * @tags combiners, functional
 * @param {Pattern} pat
 * @param {Pattern} lookup a pattern of indices
 * @param {function[]} funcs the array of functions from which to pull
@@ -86,7 +83,6 @@ export const pickF = register('pickF', function (lookup, funcs, pat) {

 /** * The same as `pickF`, but if you pick a number greater than the size of the functions list,
 * it wraps around, rather than sticking at the maximum value.
- * @tags combiners
 * @param {Pattern} pat
 * @param {Pattern} lookup a pattern of indices
 * @param {function[]} funcs the array of functions from which to pull
@@ -97,7 +93,6 @@ export const pickmodF = register('pickmodF', function (lookup, funcs, pat) {
 });

 /** * Similar to `pick`, but it applies an outerJoin instead of an innerJoin.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -108,7 +103,6 @@ export const pickOut = register('pickOut', function (lookup, pat) {

 /** * The same as `pickOut`, but if you pick a number greater than the size of the list,
 * it wraps around, rather than sticking at the maximum value.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -118,7 +112,6 @@ export const pickmodOut = register('pickmodOut', function (lookup, pat) {
 });

 /** * Similar to `pick`, but the choosen pattern is restarted when its index is triggered.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -129,7 +122,6 @@ export const pickRestart = register('pickRestart', function (lookup, pat) {

 /** * The same as `pickRestart`, but if you pick a number greater than the size of the list,
   * it wraps around, rather than sticking at the maximum value.
-   * @tags combiners
   * @param {Pattern} pat
   * @param {*} xs
   * @returns {Pattern}
@@ -146,7 +138,6 @@ export const pickmodRestart = register('pickmodRestart', function (lookup, pat)
 });

 /** * Similar to `pick`, but the choosen pattern is reset when its index is triggered.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -157,7 +148,6 @@ export const pickReset = register('pickReset', function (lookup, pat) {

 /** * The same as `pickReset`, but if you pick a number greater than the size of the list,
 * it wraps around, rather than sticking at the maximum value.
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -169,7 +159,6 @@ export const pickmodReset = register('pickmodReset', function (lookup, pat) {
 /** Picks patterns (or plain values) either from a list (by index) or a lookup table (by name).
   * Similar to `pick`, but cycles are squeezed into the target ('inhabited') pattern.
   * @name inhabit
-   * @tags combiners
   * @synonyms pickSqueeze
   * @param {Pattern} pat
   * @param {*} xs
@@ -191,7 +180,6 @@ export const { inhabit, pickSqueeze } = register(['inhabit', 'pickSqueeze'], fun
 * second one.
 * @name inhabitmod
 * @synonyms pickmodSqueeze
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -204,7 +192,6 @@ export const { inhabitmod, pickmodSqueeze } = register(['inhabitmod', 'pickmodSq
 /**
 * Pick from the list of values (or patterns of values) via the index using the given
 * pattern of integers. The selected pattern will be compressed to fit the duration of the selecting event
- * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -2,13 +2,7 @@ import { NeoCyclist } from './neocyclist.mjs';
 import { Cyclist } from './cyclist.mjs';
 import { evaluate as _evaluate } from './evaluate.mjs';
 import { errorLogger, logger } from './logger.mjs';
-import {
-  setCpsFunc,
-  setIsStarted,
-  setPattern as exposeSchedulerPattern,
-  setTime,
-  setTriggerFunc,
-} from './schedulerState.mjs';
+import { setTime } from './time.mjs';
 import { evalScope } from './evaluate.mjs';
 import { register, Pattern, isPattern, silence, stack } from './pattern.mjs';
 import { reset_state } from './impure.mjs';
@@ -58,7 +52,6 @@ export function repl({
    getTime,
    onToggle: (started) => {
      updateState({ started });
-      setIsStarted(started);
      onToggle?.(started);
      if (!started) {
        reset_state();
@@ -72,8 +65,6 @@ export function repl({
  // NeoCyclist uses a shared worker to communicate between instances, which is not supported on mobile chrome
  const scheduler =
    sync && typeof SharedWorker != 'undefined' ? new NeoCyclist(schedulerOptions) : new Cyclist(schedulerOptions);
-  setTriggerFunc(schedulerOptions.onTrigger);
-  setCpsFunc(() => scheduler.cps);
  let pPatterns = {};
  let anonymousIndex = 0;
  let allTransform;
@@ -98,7 +89,6 @@ export function repl({
  const setPattern = async (pattern, autostart = true) => {
    pattern = editPattern?.(pattern) || pattern;
    await scheduler.setPattern(pattern, autostart);
-    exposeSchedulerPattern(pattern);
    return pattern;
  };
  setTime(() => scheduler.now()); // TODO: refactor?
@@ -116,7 +106,6 @@ export function repl({
   * Changes the global tempo to the given cycles per minute
   *
   * @name setcpm
-   * @tags temporal
   * @alias setCpm
   * @param {number} cpm cycles per minute
   * @example
@@ -130,9 +119,7 @@ export function repl({

  // TODO - not documented as jsdoc examples as the test framework doesn't simulate enough context for `each` and `all`..

-  let allTransforms = [];
-  /**
-   * Applies a function to all the running patterns. Note that the patterns are groups together into a single `stack` before the function is applied. This is probably what you want, but see `each` for
+  /** Applies a function to all the running patterns. Note that the patterns are groups together into a single `stack` before the function is applied. This is probably what you want, but see `each` for
   * a version that applies the function to each pattern separately.
   * ```
   * $: sound("bd - cp sd")
@@ -144,21 +131,18 @@ export function repl({
   * $: sound("hh*8")
   * all(x => x.pianoroll())
   * ```
-   *
-   * @tags combiners
   */
+  let allTransforms = [];
  const all = function (transform) {
    allTransforms.push(transform);
    return silence;
  };
  /** Applies a function to each of the running patterns separately. This is intended for future use with upcoming 'stepwise' features. See `all` for a version that applies the function to all the patterns stacked together into a single pattern.
-   *
   * ```
   * $: sound("bd - cp sd")
   * $: sound("hh*8")
   * each(fast("<2 3>"))
   * ```
-   * @tags combiners
   */
  const each = function (transform) {
    eachTransform = transform;
@@ -1,53 +0,0 @@
-/*
-schedulerState.mjs - Module to pipe out various parameters from the scheduler for global consumption
-Copyright (C) 2026 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/core/schedulerState.mjs>
-This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
-*/
-
-let time;
-let cpsFunc;
-let pattern;
-let triggerFunc;
-let isStarted;
-export function getTime() {
-  if (!time) {
-    throw new Error('no time set! use setTime to define a time source');
-  }
-  return time();
-}
-
-export function setTime(func) {
-  time = func;
-}
-
-export function setCpsFunc(func) {
-  cpsFunc = func;
-}
-
-export function getCps() {
-  return cpsFunc?.();
-}
-
-export function setPattern(pat) {
-  pattern = pat;
-}
-
-export function getPattern() {
-  return pattern;
-}
-
-export function setTriggerFunc(func) {
-  triggerFunc = func;
-}
-
-export function getTriggerFunc() {
-  return triggerFunc;
-}
-
-export function setIsStarted(val) {
-  isStarted = !!val;
-}
-
-export function getIsStarted() {
-  return isStarted;
-}
@@ -24,7 +24,6 @@ export const signal = (func) => {
 *  A sawtooth signal between 0 and 1.
 *
 * @return {Pattern}
- * @tags generators
 * @example
 * note("<c3 [eb3,g3] g2 [g3,bb3]>*8")
 * .clip(saw.slow(2))
@@ -39,7 +38,6 @@ export const saw = signal((t) => t % 1);
 *  A sawtooth signal between -1 and 1 (like `saw`, but bipolar).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const saw2 = saw.toBipolar();

@@ -47,7 +45,6 @@ export const saw2 = saw.toBipolar();
 *  A sawtooth signal between 1 and 0 (like `saw`, but flipped).
 *
 * @return {Pattern}
- * @tags generators
 * @example
 * note("<c3 [eb3,g3] g2 [g3,bb3]>*8")
 * .clip(isaw.slow(2))
@@ -62,7 +59,6 @@ export const isaw = signal((t) => 1 - (t % 1));
 *  A sawtooth signal between 1 and -1 (like `saw2`, but flipped).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const isaw2 = isaw.toBipolar();

@@ -70,14 +66,12 @@ export const isaw2 = isaw.toBipolar();
 *  A sine signal between -1 and 1 (like `sine`, but bipolar).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const sine2 = signal((t) => Math.sin(Math.PI * 2 * t));

 /**
 *  A sine signal between 0 and 1.
 * @return {Pattern}
- * @tags generators
 * @example
 * n(sine.segment(16).range(0,15))
 * .scale("C:minor")
@@ -89,7 +83,6 @@ export const sine = sine2.fromBipolar();
 *  A cosine signal between 0 and 1.
 *
 * @return {Pattern}
- * @tags generators
 * @example
 * n(stack(sine,cosine).segment(16).range(0,15))
 * .scale("C:minor")
@@ -101,14 +94,12 @@ export const cosine = sine._early(Fraction(1).div(4));
 *  A cosine signal between -1 and 1 (like `cosine`, but bipolar).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const cosine2 = sine2._early(Fraction(1).div(4));

 /**
 *  A square signal between 0 and 1.
 * @return {Pattern}
- * @tags generators
 * @example
 * n(square.segment(4).range(0,7)).scale("C:minor")
 *
@@ -119,7 +110,6 @@ export const square = signal((t) => Math.floor((t * 2) % 2));
 *  A square signal between -1 and 1 (like `square`, but bipolar).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const square2 = square.toBipolar();

@@ -127,7 +117,6 @@ export const square2 = square.toBipolar();
 *  A triangle signal between 0 and 1.
 *
 * @return {Pattern}
- * @tags generators
 * @example
 * n(tri.segment(8).range(0,7)).scale("C:minor")
 *
@@ -138,7 +127,6 @@ export const tri = fastcat(saw, isaw);
 *  A triangle signal between -1 and 1 (like `tri`, but bipolar).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const tri2 = fastcat(saw2, isaw2);

@@ -146,7 +134,6 @@ export const tri2 = fastcat(saw2, isaw2);
 *  An inverted triangle signal between 1 and 0 (like `tri`, but flipped).
 *
 * @return {Pattern}
- * @tags generators
 * @example
 * n(itri.segment(8).range(0,7)).scale("C:minor")
 *
@@ -157,7 +144,6 @@ export const itri = fastcat(isaw, saw);
 *  An inverted triangle signal between -1 and 1 (like `itri`, but bipolar).
 *
 * @return {Pattern}
- * @tags generators
 */
 export const itri2 = fastcat(isaw2, saw2);

@@ -165,7 +151,6 @@ export const itri2 = fastcat(isaw2, saw2);
 *  A signal representing the cycle time.
 *
 * @return {Pattern}
- * @tags generators
 */
 export const time = signal(id);

@@ -173,7 +158,6 @@ export const time = signal(id);
 *  The mouse's x position value ranges from 0 to 1.
 * @name mousex
 * @return {Pattern}
- * @tags external_io
 * @example
 * n(mousex.segment(4).range(0,7)).scale("C:minor")
 *
@@ -183,7 +167,6 @@ export const time = signal(id);
 *  The mouse's y position value ranges from 0 to 1.
 * @name mousey
 * @return {Pattern}
- * @tags external_io
 * @example
 * n(mousey.segment(4).range(0,7)).scale("C:minor")
 *
@@ -286,7 +269,6 @@ export const getRandsAtTime = (t, n = 1, seed = 0) => {
 * precise RNG, try `useRNG('precise')`.
 *
 * @name useRNG
- * @tags generators, math
 * @param {string} mod - Mode. One of 'legacy', 'precise'
 * @example
 * useRNG('legacy')
@@ -298,7 +280,6 @@ export const useRNG = (mode = 'legacy') => (RNG_MODE = mode);

 /**
 * A discrete pattern of numbers from 0 to n-1
- * @tags generators
 * @example
 * n(run(4)).scale("C4:pentatonic")
 * // n("0 1 2 3").scale("C4:pentatonic")
@@ -309,7 +290,6 @@ export const run = (n) => saw.range(0, n).round().segment(n);
 * Creates a binary pattern from a number.
 *
 * @name binary
- * @tags generators
 * @param {number} n - input number to convert to binary
 * @example
 * "hh".s().struct(binary(5))
@@ -324,7 +304,6 @@ export const binary = (n) => {
 * Creates a binary pattern from a number, padded to n bits long.
 *
 * @name binaryN
- * @tags generators
 * @param {number} n - input number to convert to binary
 * @param {number} nBits - pattern length, defaults to 16
 * @example
@@ -342,7 +321,6 @@ export const binaryN = (n, nBits = 16) => {
 * Creates a binary list pattern from a number.
 *
 * @name binaryL
- * @tags generators
 * @param {number} n - input number to convert to binary
 * s("saw").seg(8)
 *   .partials(binaryL(irand(4096).add(1)))
@@ -356,7 +334,6 @@ export const binaryL = (n) => {
 * Creates a binary list pattern from a number, padded to n bits long.
 *
 * @name binaryNL
- * @tags generators
 * @param {number} n - input number to convert to binary
 * @param {number} nBits - pattern length, defaults to 16
 */
@@ -376,7 +353,6 @@ export const binaryNL = (n, nBits = 16) => {
 * Creates a list of random numbers of the given length
 *
 * @name randL
- * @tags generators
 * @param {number} n Number of random numbers to sample
 * @example
 * s("saw").seg(16).n(irand(12)).scale("F1:minor")
@@ -408,7 +384,6 @@ const _rearrangeWith = (ipat, n, pat) => {
 * Slices a pattern into the given number of parts, then plays those parts in random order.
 * Each part will be played exactly once per cycle.
 * @name shuffle
- * @tags temporal
 * @example
 * note("c d e f").sound("piano").shuffle(4)
 * @example
@@ -422,7 +397,6 @@ export const shuffle = register('shuffle', (n, pat) => {
 * Slices a pattern into the given number of parts, then plays those parts at random. Similar to `shuffle`,
 * but parts might be played more than once, or not at all, per cycle.
 * @name scramble
- * @tags temporal
 * @example
 * note("c d e f").sound("piano").scramble(4)
 * @example
@@ -435,7 +409,6 @@ export const scramble = register('scramble', (n, pat) => {
 /**
 * Modify a pattern by applying a function to the `randomSeed` control if present
 *
- * @tags math
 * @param {Function} func Function from seed (or undefined) to seed (or undefined)
 * @param {Pattern} pat Pattern to update
 * @returns Pattern
@@ -455,7 +428,6 @@ export const withSeed = (func, pat) => {
 * that use randomness, like `shuffle` and `sometimes`.
 *
 * @name seed
- * @tags math
 * @param {number} n A new seed. Can be any number.
 * @example
 * $: s("hh*4").degrade();
@@ -469,7 +441,6 @@ export const seed = register('seed', (n, pat) => {
 * A continuous pattern of random numbers, between 0 and 1.
 *
 * @name rand
- * @tags generators
 * @example
 * // randomly change the cutoff
 * s("bd*4,hh*8").cutoff(rand.range(500,8000))
@@ -478,7 +449,6 @@ export const seed = register('seed', (n, pat) => {
 export const rand = signal((t, controls) => getRandsAtTime(t, 1, controls.randSeed));
 /**
 * A continuous pattern of random numbers, between -1 and 1
- * @tags generators
 */
 export const rand2 = rand.toBipolar();

@@ -488,7 +458,6 @@ export const _brandBy = (p) => rand.fmap((x) => x < p);
 * A continuous pattern of 0 or 1 (binary random), with a probability for the value being 1
 *
 * @name brandBy
- * @tags generators
 * @param {number} probability - a number between 0 and 1
 * @example
 * s("hh*10").pan(brandBy(0.2))
@@ -499,7 +468,6 @@ export const brandBy = (pPat) => reify(pPat).fmap(_brandBy).innerJoin();
 * A continuous pattern of 0 or 1 (binary random)
 *
 * @name brand
- * @tags generators
 * @example
 * s("hh*10").pan(brand)
 */
@@ -511,7 +479,6 @@ export const _irand = (i) => rand.fmap((x) => Math.trunc(x * i));
 * A continuous pattern of random integers, between 0 and n-1.
 *
 * @name irand
- * @tags generators
 * @param {number} n max value (exclusive)
 * @example
 * // randomly select scale notes from 0 - 7 (= C to C)
@@ -534,7 +501,6 @@ export const __chooseWith = (pat, xs) => {
 /**
 * Choose from the list of values (or patterns of values) using the given
 * pattern of numbers, which should be in the range of 0..1
- * @tags temporal
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -548,7 +514,6 @@ export const chooseWith = (pat, xs) => {
 /**
 * As with {chooseWith}, but the structure comes from the chosen values, rather
 * than the pattern you're using to choose with.
- * @tags temporal
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@@ -559,7 +524,6 @@ export const chooseInWith = (pat, xs) => {

 /**
 * Chooses randomly from the given list of elements.
- * @tags temporal
 * @param  {...any} xs values / patterns to choose from.
 * @returns {Pattern} - a continuous pattern.
 * @example
@@ -575,7 +539,6 @@ export const chooseOut = choose;
 * Chooses from the given list of values (or patterns of values), according
 * to the pattern that the method is called on. The pattern should be in
 * the range 0 .. 1.
- * @tags temporal
 * @param  {...any} xs
 * @returns {Pattern}
 */
@@ -586,7 +549,6 @@ Pattern.prototype.choose = function (...xs) {
 /**
 * As with choose, but the pattern that this method is called on should be
 * in the range -1 .. 1
- * @tags temporal
 * @param  {...any} xs
 * @returns {Pattern}
 */
@@ -596,7 +558,6 @@ Pattern.prototype.choose2 = function (...xs) {

 /**
 * Picks one of the elements at random each cycle.
- * @tags temporal
 * @synonyms randcat
 * @returns {Pattern}
 * @example
@@ -639,7 +600,6 @@ const wchooseWith = (...args) => _wchooseWith(...args).outerJoin();

 /**
 * Chooses randomly from the given list of elements by giving a probability to each element
- * @tags temporal
 * @param {...any} pairs arrays of value and weight
 * @returns {Pattern} - a continuous pattern.
 * @example
@@ -649,7 +609,6 @@ export const wchoose = (...pairs) => wchooseWith(rand, ...pairs);

 /**
 * Picks one of the elements at random each cycle by giving a probability to each element
- * @tags temporal
 * @synonyms wrandcat
 * @returns {Pattern}
 * @example
@@ -693,7 +652,6 @@ function _berlin(t, seed = 0) {
 /**
 * Generates a continuous pattern of [perlin noise](https://en.wikipedia.org/wiki/Perlin_noise), in the range 0..1.
 *
- * @tags generators
 * @name perlin
 * @example
 * // randomly change the cutoff
@@ -706,7 +664,6 @@ export const perlin = signal((t, controls) => _perlin(t, controls.randSeed));
 * Generates a continuous pattern of [berlin noise](conceived by Jame Coyne and Jade Rowland as a joke but turned out to be surprisingly cool and useful,
 * like perlin noise but with sawtooth waves), in the range 0..1.
 *
- * @tags generators
 * @name berlin
 * @example
 * // ascending arpeggios
@@ -727,7 +684,6 @@ export const degradeByWith = register(
 * 0 = 0% chance of removal
 * 1 = 100% chance of removal
 *
- * @tags temporal
 * @name degradeBy
 * @memberof Pattern
 * @param {number} amount - a number between 0 and 1
@@ -753,7 +709,6 @@ export const degradeBy = register(
 *
 * Randomly removes 50% of events from the pattern. Shorthand for `.degradeBy(0.5)`
 *
- * @tags temporal
 * @name degrade
 * @memberof Pattern
 * @returns Pattern
@@ -770,7 +725,6 @@ export const degrade = register('degrade', (pat) => pat._degradeBy(0.5), true, t
 * 1 = 0% chance of removal
 * Events that would be removed by degradeBy are let through by undegradeBy and vice versa (see second example).
 *
- * @tags temporal
 * @name undegradeBy
 * @memberof Pattern
 * @param {number} amount - a number between 0 and 1
@@ -799,7 +753,6 @@ export const undegradeBy = register(
 * Inverse of `degrade`: Randomly removes 50% of events from the pattern. Shorthand for `.undegradeBy(0.5)`
 * Events that would be removed by degrade are let through by undegrade and vice versa (see second example).
 *
- * @tags temporal
 * @name undegrade
 * @memberof Pattern
 * @returns Pattern
@@ -818,7 +771,6 @@ export const undegrade = register('undegrade', (pat) => pat._undegradeBy(0.5), t
 * Randomly applies the given function by the given probability.
 * Similar to `someCyclesBy`
 *
- * @tags temporal
 * @name sometimesBy
 * @memberof Pattern
 * @param {number | Pattern} probability - a number between 0 and 1
@@ -838,7 +790,6 @@ export const sometimesBy = register('sometimesBy', function (patx, func, pat) {
 *
 * Applies the given function with a 50% chance
 *
- * @tags temporal
 * @name sometimes
 * @memberof Pattern
 * @param {function} function - the transformation to apply
@@ -860,7 +811,6 @@ export const sometimes = register('sometimes', function (func, pat) {
 * @param {number | Pattern} probability - a number between 0 and 1
 * @param {function} function - the transformation to apply
 * @returns Pattern
- * @tags temporal
 * @example
 * s("bd,hh*8").someCyclesBy(.3, x=>x.speed("0.5"))
 */
@@ -883,7 +833,6 @@ export const someCyclesBy = register('someCyclesBy', function (patx, func, pat)
 * @name someCycles
 * @memberof Pattern
 * @returns Pattern
- * @tags temporal
 * @example
 * s("bd,hh*8").someCycles(x=>x.speed("0.5"))
 */
@@ -898,7 +847,6 @@ export const someCycles = register('someCycles', function (func, pat) {
 * @name often
 * @memberof Pattern
 * @returns Pattern
- * @tags temporal
 * @example
 * s("hh*8").often(x=>x.speed("0.5"))
 */
@@ -913,7 +861,6 @@ export const often = register('often', function (func, pat) {
 * @name rarely
 * @memberof Pattern
 * @returns Pattern
- * @tags temporal
 * @example
 * s("hh*8").rarely(x=>x.speed("0.5"))
 */
@@ -925,7 +872,6 @@ export const rarely = register('rarely', function (func, pat) {
 *
 * Shorthand for `.sometimesBy(0.1, fn)`
 *
- * @tags temporal
 * @name almostNever
 * @memberof Pattern
 * @returns Pattern
@@ -940,7 +886,6 @@ export const almostNever = register('almostNever', function (func, pat) {
 *
 * Shorthand for `.sometimesBy(0.9, fn)`
 *
- * @tags temporal
 * @name almostAlways
 * @memberof Pattern
 * @returns Pattern
@@ -955,7 +900,6 @@ export const almostAlways = register('almostAlways', function (func, pat) {
 *
 * Shorthand for `.sometimesBy(0, fn)` (never calls fn)
 *
- * @tags temporal
 * @name never
 * @memberof Pattern
 * @returns Pattern
@@ -970,7 +914,6 @@ export const never = register('never', function (_, pat) {
 *
 * Shorthand for `.sometimesBy(1, fn)` (always calls fn)
 *
- * @tags temporal
 * @name always
 * @memberof Pattern
 * @returns Pattern
@@ -999,7 +942,6 @@ export function _keyDown(keyname) {
 * Do something on a keypress, or array of keypresses
 * [Key name reference](https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values)
 *
- * @tags external_io
 * @name whenKey
 * @memberof Pattern
 * @returns Pattern
@@ -1016,7 +958,6 @@ export const whenKey = register('whenKey', function (input, func, pat) {
 * returns true when a key or array of keys is held
 * [Key name reference](https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values)
 *
- * @tags external_io
 * @name keyDown
 * @memberof Pattern
 * @returns Pattern
@@ -1034,8 +975,6 @@ export const keyDown = register('keyDown', function (pat) {
 * event durations, from the pattern that it is combined with.
 * For example `cyclesPer.struct("1 1 [1 1] 1")` would give the same as `"0.25 0.25 [0.125 0.125] 0.25"`.
 * See also its reciprocal, `per`, also known as `perCycle`.
- *
- * @tags temporal
 * @example
 * // Shorter events are lower in pitch
 * sound("saw saw [saw saw] saw")
@@ -1054,7 +993,6 @@ export const cyclesPer = new Pattern(function (state) {
 * event durations, from the pattern that it is combined with.
 * For example `per.struct("1 1 [1 1] 1")` would give the same as `"4 4 [8 8] 4"`.
 * See also its reciprocal, `cyclesPer`.
- * @tags temporal
 * @synonyms perCycle
 * @example
 * // Shorter events are more distorted
@@ -1072,7 +1010,6 @@ export const perCycle = per;
 * particular, where the event duration halves, the
 * returned value increases by one. `perx.struct("1 1 [1 [1 1]] 1")` would therefore be
 * the same as `"3 3 [4 [5 5]] 3"`.
- * @tags temporal
 */
 export const perx = new Pattern(function (state) {
  const n = Fraction(1).div(state.span.duration);
@@ -0,0 +1,11 @@
+let time;
+export function getTime() {
+  if (!time) {
+    throw new Error('no time set! use setTime to define a time source');
+  }
+  return time();
+}
+
+export function setTime(func) {
+  time = func;
+}
@@ -135,8 +135,6 @@ export async function loadOrc(url) {
 *  p4 -- MIDI key number (as a real number, not an integer but in [0, 127].
 *  p5 -- MIDI velocity (as a real number, not an integer but in [0, 127].
 *  p6 -- Strudel controls, as a string.
- *
- * @tags external_io
 */
 export const csoundm = register('csoundm', (instrument, pat) => {
  let p1 = instrument;
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/csound",
-  "version": "1.3.0",
+  "version": "1.2.6",
  "description": "csound bindings for strudel",
  "main": "index.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/draw",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Helpers for drawing with Strudel",
  "main": "index.mjs",
  "type": "module",
@@ -42,7 +42,6 @@ const getValue = (e) => {
 *
 * @name pianoroll
 * @synonyms punchcard
- * @tags visualization
 * @param {Object} options Object containing all the optional following parameters as key value pairs:
 * @param {integer} cycles number of cycles to be displayed at the same time - defaults to 4
 * @param {number} playhead location of the active notes on the time axis - 0 to 1, defaults to 0.5
@@ -300,7 +299,6 @@ Pattern.prototype.punchcard = function (options) {
 * Supports all the same options as pianoroll.
 *
 * @name wordfall
- * @tags visualization
 */
 Pattern.prototype.wordfall = function (options) {
  return this.punchcard({ vertical: 1, labels: 1, stroke: 0, fillActive: 1, active: 'white', ...options });
@@ -116,7 +116,6 @@ export function pitchwheel({
 /**
 * Renders a pitch circle to visualize frequencies within one octave
 * @name pitchwheel
- * @tags visualization
 * @param {number} hapcircles
 * @param {number} circle
 * @param {number} edo
@@ -129,7 +129,6 @@ function drawSpiral(options) {
 * Displays a spiral visual.
 *
 * @name spiral
- * @tags visualization
 * @param {Object} options Object containing all the optional following parameters as key value pairs:
 * @param {number} stretch controls the rotations per cycle ratio, where 1 = 1 cycle / 360 degrees
 * @param {number} size the diameter of the spiral
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/embed",
-  "version": "1.1.2",
+  "version": "1.1.1",
  "description": "Embeddable Web Component to load a Strudel REPL into an iframe",
  "main": "embed.js",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/gamepad",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Gamepad Inputs for strudel",
  "main": "index.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/hydra",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Hydra integration for strudel",
  "main": "hydra.mjs",
  "type": "module",
@@ -5,23 +5,9 @@ This program is free software: you can redistribute it and/or modify it under th
 */

 import * as _WebMidi from 'webmidi';
-import {
-  Hap,
-  Pattern,
-  TimeSpan,
-  getCps,
-  getIsStarted,
-  getPattern,
-  getTime,
-  getTriggerFunc,
-  isPattern,
-  logger,
-  ref,
-  reify,
-} from '@strudel/core';
+import { Pattern, isPattern, logger, ref } from '@strudel/core';
 import { noteToMidi, getControlName } from '@strudel/core';
 import { Note } from 'webmidi';
-import { getAudioContext } from '@strudel/webaudio';
 import { scheduleAtTime } from '../superdough/helpers.mjs';

 // if you use WebMidi from outside of this package, make sure to import that instance:
@@ -138,7 +124,6 @@ function githubPath(base, subpath = '') {

 /**
 * configures the default midimap, which is used when no "midimap" port is set
- * @tags external_io
 * @example
 * defaultmidimap({ lpf: 74 })
 * $: note("c a f e").midi();
@@ -152,7 +137,6 @@ let loadCache = {};

 /**
 * Adds midimaps to the registry. Inside each midimap, control names (e.g. lpf) are mapped to cc numbers.
- * @tags external_io
 * @example
 * midimaps({ mymap: { lpf: 74 } })
 * $: note("c a f e")
@@ -307,7 +291,6 @@ function sendNote(note, velocity, duration, device, midichan, targetTime) {

 /**
 * MIDI output: Opens a MIDI output port.
- * @tags external_io
 * @param {string | number} midiport MIDI device name or index defaulting to 0
 * @param {object} options Additional MIDI configuration options
 * @example
@@ -494,42 +477,14 @@ Pattern.prototype.midi = function (midiport, options = {}) {
  });
 };

-/**
- * Initialize a midi device
- */
-async function _initialize(input) {
-  if (isPattern(input)) {
-    throw new Error(
-      `[midi] Midi input cannot be a pattern. Make sure to pass device name with single quotes. Example: midin('${
-        WebMidi.outputs?.[0]?.name || 'IAC Driver Bus 1'
-      }')`,
-    );
-  }
-  const initial = await enableWebMidi(); // only returns on first init
-  const device = getDevice(input, WebMidi.inputs);
-  if (!device) {
-    throw new Error(
-      `[midi] Midi device "${input}" not found.. connected devices: ${getMidiDeviceNamesString(WebMidi.inputs)}`,
-    );
-  }
-  if (initial) {
-    const otherInputs = WebMidi.inputs.filter((o) => o.name !== device.name);
-    logger(
-      `[midi] Midi enabled! Using "${device.name}". ${
-        otherInputs?.length ? `Also available: ${getMidiDeviceNamesString(otherInputs)}` : ''
-      }`,
-    );
-  }
-  return device;
-}
+let listeners = {};
+const refs = {};
+const refsByChan = {};

 /**
 * MIDI input: Opens a MIDI input port to receive MIDI control change messages.
 *
 * The output is a function that accepts a midi cc value to query as well as (optionally) a midi channel
- *
- * @name midin
- * @tags external_io
 * @param {string | number} input MIDI device name or index defaulting to 0
 * @returns {function(number, number=): Pattern} A function from (cc, channel?) to a pattern.
 *   When queried, the pattern will produces the most recently received midi value (normalized to 0 to 1)
@@ -543,11 +498,29 @@ async function _initialize(input) {
 * note("c a f e").s("saw")
 *   .when(cc(0).gt(0), x => x.postgain(0))
 */
-let listeners = {};
-const refs = {};
-const refsByChan = {};
 export async function midin(input) {
-  const device = await _initialize(input);
+  if (isPattern(input)) {
+    throw new Error(
+      `midin: does not accept Pattern as input. Make sure to pass device name with single quotes. Example: midin('${
+        WebMidi.outputs?.[0]?.name || 'IAC Driver Bus 1'
+      }')`,
+    );
+  }
+  const initial = await enableWebMidi(); // only returns on first init
+  const device = getDevice(input, WebMidi.inputs);
+  if (!device) {
+    throw new Error(
+      `midiin: device "${input}" not found.. connected devices: ${getMidiDeviceNamesString(WebMidi.inputs)}`,
+    );
+  }
+  if (initial) {
+    const otherInputs = WebMidi.inputs.filter((o) => o.name !== device.name);
+    logger(
+      `Midi enabled! Using "${device.name}". ${
+        otherInputs?.length ? `Also available: ${getMidiDeviceNamesString(otherInputs)}` : ''
+      }`,
+    );
+  }
  refs[input] ??= {};
  refsByChan[input] ??= {};
  const cc = (cc, chan) => {
@@ -559,7 +532,8 @@ export async function midin(input) {

  listeners[input] && device.removeListener('midimessage', listeners[input]);
  listeners[input] = (e) => {
-    const [ccNum, v] = e.dataBytes;
+    const ccNum = e.dataBytes[0];
+    const v = e.dataBytes[1];
    const chan = e.message.channel;
    const scaled = v / 127;
    refsByChan[input][ccNum] ??= {};
@@ -569,133 +543,3 @@ export async function midin(input) {
  device.addListener('midimessage', listeners[input]);
  return cc;
 }
-
-/**
- * MIDI keyboard: Opens a MIDI input port to receive MIDI keyboard messages.
- *
- * The note length is fixed as Superdough is not currently set up for undetermined
- * note durations
- *
- * @name midikeys
- * @tags external_io
- * @param {string | number} input MIDI device name or index defaulting to 0
- * @returns {function((number | Pattern)=): Pattern} A function that produces a pattern.
- *   When queried, the pattern will produces the most recently played midi notes and velocities,
- *   lasting for the specified duration
- * @example
- * const kb = await midikeys('Arturia KeyStep 32')
- * kb().s("tri").lpf(80).lpe(6).lpd(0.1).room(2).delay(0.35)
- * @example
- * const kb = await midikeys('Arturia KeyStep 32')
- * kb("0.5 1")
- *   .s("saw")
- *   .add(note(rand.mul(0.3)))
- *   .lpf(1000).lpe(2).room(0.5)
- */
-const kHaps = {};
-const kListeners = {};
-
-function _triggerKeyboard(input, cps, now, latencyCycles) {
-  const pattern = getPattern();
-  const trigger = getTriggerFunc();
-  if (!pattern || !trigger) {
-    return false;
-  }
-  const t = now + latencyCycles;
-  const eps = 1e-6;
-  const haps = pattern.queryArc(t - eps, t + eps, { _cps: cps });
-  // Only keep haps coming from `midikeys`
-  const kbHaps = haps.filter((hap) => hap.value?.midikey?.startsWith(`${input}_`));
-  const ctxNow = getAudioContext().currentTime;
-  if (!kbHaps.length) {
-    return false;
-  }
-  kbHaps.forEach((hap) => {
-    if (!hap.hasOnset()) {
-      return;
-    }
-    const t = ctxNow + (hap.whole.begin - now) / cps;
-    const duration = hap.duration / cps;
-    trigger(hap, t - ctxNow, duration, cps, t);
-  });
-
-  return true;
-}
-export async function midikeys(input) {
-  const device = await _initialize(input);
-  if (!kHaps[input]) {
-    kHaps[input] = [];
-  }
-  kListeners[input] && device.removeListener('midimessage', kListeners[input]);
-  kListeners[input] = (e) => {
-    const { dataBytes, message } = e;
-    const noteon = message.command === 9;
-    let noteoff = message.command === 8;
-    // Don't enqueue or trigger midi notes if scheduler is not started
-    const notStarted = !getIsStarted();
-    // Ignore non-note messages (e.g. CC, pitchbend, modwheel, etc.)
-    const notANote = !noteon && !noteoff;
-    if (notStarted || notANote) {
-      return;
-    }
-    const [note, velocity] = dataBytes;
-    noteoff ||= noteon && velocity === 0; // handle devices which may use velocity = 0 to signal noteoff
-    const key = `${input}_${note}`;
-    const cps = getCps() ?? 0.5;
-    const triggerAvailable = !!(getPattern() && getTriggerFunc());
-    const latencySeconds = triggerAvailable ? 0.01 : 0.06; // avoid missing notes due to cyclist / trigger latency
-    const now = getTime();
-    const t = now + latencySeconds * cps;
-    const span = new TimeSpan(t, t);
-    let value = { midikey: key };
-    if (noteoff) {
-      /* TODO: It's a big effort, but we could modify superdough to allow for situations where
-      we don't know the hap duration in advance. This would mean, for example, that if the hap
-      is flagged as such a special note-on event, we have all effects be persistent & all ADSR
-      envelopes stop at the S stage [and store references to them by `midikey`]
-      If this is implemented, then getting full keyboard functionality should be as simple
-      as sending the corresponding note-off event below and triggering `release` on each of those
-      referenced effects/envelopes
-      
-      value = { ...value, noteoff: true };
-  
-      If this is achieved, we can remove the noteLength parameter
-      */
-      return;
-    } else {
-      value = { ...value, note: Math.round(note), velocity: velocity / 127 };
-    }
-    kHaps[input].push(new Hap(span, span, value, {}));
-    if (!noteoff && triggerAvailable) {
-      // If we have access to a trigger function, we call it to immediately
-      // dispatch to the audio engine, rather than waiting for cyclist to catch these haps
-      const triggered = _triggerKeyboard(input, cps, now, latencySeconds * cps);
-      if (triggered) {
-        kHaps[input] = [];
-      }
-    }
-  };
-  device.addListener('midimessage', kListeners[input]);
-  const kb = (noteLength = 0.5) => {
-    const nlPat = reify(noteLength);
-    const query = (state) => {
-      const haps = kHaps[input].flatMap((hap) => {
-        const lenHaps = nlPat.query(state.setSpan(hap.wholeOrPart()));
-        return lenHaps.map((lenHap) => {
-          const nl = lenHap.value ?? 0.5;
-          const whole = new TimeSpan(hap.whole.begin, hap.whole.begin.add(nl));
-          const part = new TimeSpan(hap.part.begin, hap.part.begin.add(nl));
-          const context = hap.combineContext(lenHap);
-          return new Hap(whole, part, hap.value, context);
-        });
-      });
-      if (state.controls.cyclist) {
-        // Notes have been sent; clear them
-        kHaps[input] = [];
-      }
-      return haps;
-    };
-    return new Pattern(query);
-  };
-  return kb;
-}
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/midi",
-  "version": "1.3.0",
+  "version": "1.2.6",
  "description": "Midi API for strudel",
  "main": "index.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/mini",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Mini notation for strudel",
  "main": "index.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "mondolang",
-  "version": "1.1.2",
+  "version": "1.1.1",
  "description": "a language for functional composition that translates to js",
  "main": "mondo.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/mondo",
-  "version": "1.1.6",
+  "version": "1.1.5",
  "description": "mondo notation for strudel",
  "main": "mondough.mjs",
  "type": "module",
@@ -7,7 +7,6 @@ import { signal } from '../core/signal.mjs';
 * @name accelerationX
 * @return {Pattern}
 * @synonyms accX
- * @tags external_io
 * @example
 * n(accelerationX.segment(4).range(0,7)).scale("C:minor")
 *
@@ -18,7 +17,6 @@ import { signal } from '../core/signal.mjs';
 * @name accelerationY
 * @return {Pattern}
 * @synonyms accY
- * @tags external_io
 * @example
 * n(accelerationY.segment(4).range(0,7)).scale("C:minor")
 *
@@ -29,7 +27,6 @@ import { signal } from '../core/signal.mjs';
 * @name accelerationZ
 * @return {Pattern}
 * @synonyms accZ
- * @tags external_io
 * @example
 * n(accelerationZ.segment(4).range(0,7)).scale("C:minor")
 *
@@ -40,7 +37,6 @@ import { signal } from '../core/signal.mjs';
 * @name gravityX
 * @return {Pattern}
 * @synonyms gravX
- * @tags external_io
 * @example
 * n(gravityX.segment(4).range(0,7)).scale("C:minor")
 *
@@ -51,7 +47,6 @@ import { signal } from '../core/signal.mjs';
 * @name gravityY
 * @return {Pattern}
 * @synonyms gravY
- * @tags external_io
 * @example
 * n(gravityY.segment(4).range(0,7)).scale("C:minor")
 *
@@ -62,7 +57,6 @@ import { signal } from '../core/signal.mjs';
 * @name gravityZ
 * @return {Pattern}
 * @synonyms gravZ
- * @tags external_io
 * @example
 * n(gravityZ.segment(4).range(0,7)).scale("C:minor")
 *
@@ -73,7 +67,6 @@ import { signal } from '../core/signal.mjs';
 * @name rotationAlpha
 * @return {Pattern}
 * @synonyms rotA, rotZ, rotationZ
- * @tags external_io
 * @example
 * n(rotationAlpha.segment(4).range(0,7)).scale("C:minor")
 *
@@ -84,7 +77,6 @@ import { signal } from '../core/signal.mjs';
 * @name rotationBeta
 * @return {Pattern}
 * @synonyms rotB, rotX, rotationX
- * @tags external_io
 * @example
 * n(rotationBeta.segment(4).range(0,7)).scale("C:minor")
 *
@@ -95,7 +87,6 @@ import { signal } from '../core/signal.mjs';
 * @name rotationGamma
 * @return {Pattern}
 * @synonyms rotG, rotY, rotationY
- * @tags external_io
 * @example
 * n(rotationGamma.segment(4).range(0,7)).scale("C:minor")
 *
@@ -106,7 +97,6 @@ import { signal } from '../core/signal.mjs';
 * @name orientationAlpha
 * @return {Pattern}
 * @synonyms oriA, oriZ, orientationZ
- * @tags external_io
 * @example
 * n(orientationAlpha.segment(4).range(0,7)).scale("C:minor")
 *
@@ -117,7 +107,6 @@ import { signal } from '../core/signal.mjs';
 * @name orientationBeta
 * @return {Pattern}
 * @synonyms oriB, oriX, orientationX
- * @tags external_io
 * @example
 * n(orientationBeta.segment(4).range(0,7)).scale("C:minor")
 *
@@ -128,7 +117,6 @@ import { signal } from '../core/signal.mjs';
 * @name orientationGamma
 * @return {Pattern}
 * @synonyms oriG, oriY, orientationY
- * @tags external_io
 * @example
 * n(orientationGamma.segment(4).range(0,7)).scale("C:minor")
 *
@@ -139,7 +127,6 @@ import { signal } from '../core/signal.mjs';
 * @name absoluteOrientationAlpha
 * @return {Pattern}
 * @synonyms absOriA, absOriZ, absoluteOrientationZ
- * @tags external_io
 * @example
 * n(absoluteOrientationAlpha.segment(4).range(0,7)).scale("C:minor")
 *
@@ -150,7 +137,6 @@ import { signal } from '../core/signal.mjs';
 * @name absoluteOrientationBeta
 * @return {Pattern}
 * @synonyms absOriB, absOriX, absoluteOrientationX
- * @tags external_io
 * @example
 * n(absoluteOrientationBeta.segment(4).range(0,7)).scale("C:minor")
 *
@@ -161,7 +147,6 @@ import { signal } from '../core/signal.mjs';
 * @name absoluteOrientationGamma
 * @return {Pattern}
 * @synonyms absOriG, absOriY, absoluteOrientationY
- * @tags external_io
 * @example
 * n(absoluteOrientationGamma.segment(4).range(0,7)).scale("C:minor")
 *
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/motion",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "DeviceMotion API for strudel",
  "main": "index.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/mqtt",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "MQTT API for strudel",
  "main": "mqtt.mjs",
  "type": "module",
@@ -79,7 +79,6 @@ export async function oscTrigger(hap, currentTime, cps = 1, targetTime) {
 * For more info, read [MIDI & OSC in the docs](https://strudel.cc/learn/input-output/)
 *
 * @name osc
- * @tags external_io
 * @memberof Pattern
 * @returns Pattern
 */
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/osc",
-  "version": "1.3.2",
+  "version": "1.3.0",
  "description": "OSC messaging for strudel",
  "main": "osc.mjs",
  "bin": "./server.js",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/reference",
-  "version": "1.2.2",
+  "version": "1.2.1",
  "description": "Headless reference of all strudel functions",
  "main": "index.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/repl",
-  "version": "1.3.0",
+  "version": "1.2.7",
  "description": "Strudel REPL as a Web Component",
  "module": "index.mjs",
  "publishConfig": {
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/sampler",
-  "version": "0.2.4",
+  "version": "0.2.3",
  "description": "",
  "keywords": [
    "tidalcycles",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/serial",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Webserial API for strudel",
  "main": "serial.mjs",
  "type": "module",
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/soundfonts",
-  "version": "1.3.0",
+  "version": "1.2.6",
  "description": "Soundsfont support for strudel",
  "main": "index.mjs",
  "publishConfig": {
@@ -154,8 +154,9 @@ export function getCompressor(ac, threshold, ratio, knee, attack, release) {
    attack: attack ?? 0.005,
    release: release ?? 0.05,
  };
+  const now = ac.currentTime;
  Object.entries(options).forEach(([key, value]) => {
-    node[key].value = value;
+    node[key].setValueAtTime(value, now);
  });
  return node;
 }
@@ -172,7 +173,6 @@ export const getADSRValues = (params, curve = 'linear', defaultValues) => {
  if (a == null && d == null && s == null && r == null) {
    return defaultValues ?? [envmin, envmin, envmax, releaseMin];
  }
-
  const sustain = s != null ? s : (a != null && d == null) || (a == null && d == null) ? envmax : envmin;
  return [Math.max(a ?? 0, envmin), Math.max(d ?? 0, envmin), Math.min(sustain, envmax), Math.max(r ?? 0, releaseMin)];
 };
@@ -242,8 +242,9 @@ export function createFilter(context, start, end, params, cps, cycle) {
    const factory = () => context.createBiquadFilter();
    filter = getNodeFromPool('filter', factory);
    filter.type = type;
+    const now = context.currentTime;
    Object.entries({ Q: q, frequency }).forEach(([key, value]) => {
-      filter[key].value = value;
+      filter[key].setValueAtTime(value, now);
    });
    frequencyParam = filter.frequency;
  }
@@ -98,7 +98,6 @@ export const connectLFO = (id, params, nodeTracker) => {
    fxi = 'main',
    depth = 1,
    depthabs,
-    retrig = 0,
    ...filteredParams
  } = params;
  const { targetParams, paramName } = getTargetParamsForControl(control, nodeTracker[fxi], subControl);
@@ -110,7 +109,7 @@ export const connectLFO = (id, params, nodeTracker) => {
  const modParams = {
    ...filteredParams,
    frequency: sync !== undefined ? sync * cps : rate,
-    time: retrig > 0.5 ? 0 : cycle / cps,
+    time: cycle / cps,
    depth: depthValue,
    min,
    max,
@@ -7,13 +7,11 @@ This program is free software: you can redistribute it and/or modify it under th

 const nodePools = new Map();
 const POOL_KEY = Symbol('nodePoolKey');
+const IS_WORKLET_DEAD = Symbol('nodePoolIsWorkletDead');
+const MAX_POOL_SIZE = 64;

 export const isPoolable = (node) => !!node[POOL_KEY];

-const getNodeTime = (node) => {
-  return node.context?.currentTime ?? 0;
-};
-
 const getParams = (node) => {
  const params = new Set();
  node.parameters?.forEach((param) => params.add(param));
@@ -40,43 +38,34 @@ export const releaseNodeToPool = (node) => {
    // not reusable
    return;
  }
+  if (node[IS_WORKLET_DEAD]) {
+    // Worklet already terminated, don't pool it
+    return;
+  }
  const key = node[POOL_KEY];
  if (key == null) return;
-  const now = getNodeTime(node);
+  const now = node.context?.currentTime ?? 0;
  getParams(node).forEach((param) => param.cancelScheduledValues(now));
  const pool = nodePools.get(key) ?? [];
-  pool.push(new WeakRef(node));
-  nodePools.set(key, pool);
+  if (pool.length < MAX_POOL_SIZE) {
+    pool.push(new WeakRef(node));
+    nodePools.set(key, pool);
+  }
 };

-// Audio worklets are given a grace period to survive (`return true`) after
-// being released. This concludes at time `end + 0.5`. We test here whether we are
-// within some safe distance of that (`end + 0.45`) and if so, permit the node to be
-// released. This helps to prevent race conditions between node termination and node
-// re-use
-const isNodeAlive = (node) => {
-  // Skip check if node is not a worklet
-  if (!(node instanceof AudioWorkletNode)) return true;
-  const now = getNodeTime(node);
-  const end = node?.parameters?.get('end').value ?? 0;
-  return now < end + 0.45;
-};
+export const markWorkletAsDead = (worklet) => (worklet[IS_WORKLET_DEAD] = true);

 // Attempt to get node from the pool. If this fails, fall back
 // to building it with the factory
 export const getNodeFromPool = (key, factory) => {
  const pool = nodePools.get(key) ?? [];
  let node;
-  let found = false;
  while (pool.length) {
    const ref = pool.pop();
    node = ref?.deref();
-    if (node != null && isNodeAlive(node)) {
-      found = true;
-      break;
-    }
+    if (node != null && !node[IS_WORKLET_DEAD]) break;
  }
-  if (!found) {
+  if (node == null || node[IS_WORKLET_DEAD]) {
    node = factory();
  }
  node[POOL_KEY] = key;
@@ -35,9 +35,7 @@ class OLAProcessor extends AudioWorkletProcessor {
  }

  /** Handles dynamic reallocation of input/output channels buffer
-   * (channel numbers may vary during lifecycle)
-   * @tags internals
-   **/
+     (channel numbers may lety during lifecycle) **/
  reallocateChannelsIfNeeded(inputs, outputs) {
    for (let i = 0; i < this.nbInputs; i++) {
      let nbChannels = inputs[i].length;
@@ -90,10 +88,7 @@ class OLAProcessor extends AudioWorkletProcessor {
    }
  }

-  /**
-   * Read next web audio block to input buffers
-   * @tags internals
-   **/
+  /** Read next web audio block to input buffers **/
  readInputs(inputs) {
    // when playback is paused, we may stop receiving new samples
    if (inputs[0].length && inputs[0][0].length == 0) {
@@ -113,9 +108,7 @@ class OLAProcessor extends AudioWorkletProcessor {
    }
  }

-  /** Write next web audio block from output buffers
-   * @tags internals
-   **/
+  /** Write next web audio block from output buffers **/
  writeOutputs(outputs) {
    for (let i = 0; i < this.nbInputs; i++) {
      for (let j = 0; j < this.inputBuffers[i].length; j++) {
@@ -125,9 +118,7 @@ class OLAProcessor extends AudioWorkletProcessor {
    }
  }

-  /** Shift left content of input buffers to receive new web audio block
-   * @tags internals
-   **/
+  /** Shift left content of input buffers to receive new web audio block **/
  shiftInputBuffers() {
    for (let i = 0; i < this.nbInputs; i++) {
      for (let j = 0; j < this.inputBuffers[i].length; j++) {
@@ -136,9 +127,7 @@ class OLAProcessor extends AudioWorkletProcessor {
    }
  }

-  /** Shift left content of output buffers to receive new web audio block
-   * @tags internals
-   **/
+  /** Shift left content of output buffers to receive new web audio block **/
  shiftOutputBuffers() {
    for (let i = 0; i < this.nbOutputs; i++) {
      for (let j = 0; j < this.outputBuffers[i].length; j++) {
@@ -148,9 +137,7 @@ class OLAProcessor extends AudioWorkletProcessor {
    }
  }

-  /** Copy contents of input buffers to buffer actually sent to process
-   * @tags internals
-   **/
+  /** Copy contents of input buffers to buffer actually sent to process **/
  prepareInputBuffersToSend() {
    for (let i = 0; i < this.nbInputs; i++) {
      for (let j = 0; j < this.inputBuffers[i].length; j++) {
@@ -159,9 +146,7 @@ class OLAProcessor extends AudioWorkletProcessor {
    }
  }

-  /** Add contents of output buffers just processed to output buffers
-   * @tags internals
-   **/
+  /** Add contents of output buffers just processed to output buffers **/
  handleOutputBuffersToRetrieve() {
    for (let i = 0; i < this.nbOutputs; i++) {
      for (let j = 0; j < this.outputBuffers[i].length; j++) {
@@ -1,6 +1,6 @@
 {
  "name": "superdough",
-  "version": "1.3.0",
+  "version": "1.2.6",
  "description": "simple web audio synth and sampler intended for live coding. inspired by superdirt and webdirt.",
  "main": "index.mjs",
  "type": "module",
@@ -36,8 +36,6 @@
    "vite-plugin-bundle-audioworklet": "workspace:*"
  },
  "dependencies": {
-    "@kabelsalat/lib": "^0.4.1",
-    "@kabelsalat/web": "^0.4.1",
    "nanostores": "^0.11.3"
  },
  "engines": {
@@ -18,7 +18,6 @@ var reverbGen = {};

 /** Generates a reverb impulse response.

- @tags internals
 @param {!Object} params TODO: Document the properties.
 @param {!function(!AudioBuffer)} callback Function to call when
  the impulse response has been generated. The impulse response
@@ -51,7 +50,7 @@ reverbGen.generateReverb = function (params, callback) {

 /** Creates a canvas element showing a graph of the given data.

- @tags internals
+
 @param {!Float32Array} data An array of numbers, or a Float32Array.
 @param {number} width Width in pixels of the canvas.
 @param {number} height Height in pixels of the canvas.
@@ -82,9 +81,7 @@ reverbGen.generateGraph = function (data, width, height, min, max) {
 @param {number} lpFreqEnd
 @param {number} lpFreqEndAt
 @param {!function(!AudioBuffer)} callback May be called
-  immediately within the current execution context, or later.
- @tags internals
-  */
+  immediately within the current execution context, or later.*/
 var applyGradualLowpass = function (input, lpFreqStart, lpFreqEnd, lpFreqEndAt, callback) {
  if (lpFreqStart == 0) {
    callback(input);
@@ -235,7 +235,6 @@ export async function fetchSampleMap(url) {

 /**
 * Loads a collection of samples to use with `s`
- * @tags samples
 * @example
 * samples('github:tidalcycles/dirt-samples');
 * s("[bd ~]*2, [~ hh]*2, ~ sd")
@@ -14,10 +14,11 @@ import {
  createFilter,
  effectSend,
  gainNode,
+  getADSRValues,
  getCompressor,
  getDistortion,
-  getFrequencyFromValue,
  getLfo,
+  getParamADSR,
  getWorklet,
  releaseAudioNode,
  webAudioTimeout,
@@ -40,7 +41,6 @@ export let maxPolyphony = DEFAULT_MAX_POLYPHONY;
 * start to die out in first-in-first-out order once the max polyphony has been hit
 *
 * @name setMaxPolyphony
- * @tags fx, superdough
 * @param {number} Max polyphony. Defaults to 128
 * @example
 * setMaxPolyphony(4)
@@ -74,7 +74,6 @@ export function applyGainCurve(val) {
 * quadratic, exponential, etc. rather than linear
 *
 * @name setGainCurve
- * @tags fx, superdough
 * @param {Function} function to apply to all gain values
 * @example
 * setGainCurve((x) => x * x) // quadratic gain
@@ -130,8 +129,6 @@ async function aliasBankPath(path) {
 * Optionally accepts a single argument string of a path to a JSON file containing bank aliases.
 * @param {string} bank - The bank to alias
 * @param {string} alias - The alias to use for the bank
- *
- * @tags samples
 */
 export async function aliasBank(...args) {
  switch (args.length) {
@@ -150,7 +147,6 @@ export async function aliasBank(...args) {

 /**
 * Register an alias for a sound.
- * @tags samples
 * @param {string} original - The original sound name
 * @param {string} alias - The alias to use for the sound
 */
@@ -182,6 +178,19 @@ export const getAudioDevices = async () => {
  return devicesMap;
 };

+let AUDIO_INPUTS;
+export const getAudioInputs = async () => {
+  await navigator.mediaDevices.getUserMedia({ audio: true });
+  let mediaDevices = await navigator.mediaDevices.enumerateDevices();
+  mediaDevices = mediaDevices.filter((device) => device.kind === 'audioinput' && device.deviceId !== 'default');
+  const devicesMap = new Map();
+  devicesMap.set(DEFAULT_AUDIO_DEVICE_NAME, '');
+  mediaDevices.forEach((device) => {
+    devicesMap.set(device.label, device.deviceId);
+  });
+  return devicesMap;
+};
+
 let defaultDefaultValues = {
  s: 'triangle',
  gain: 0.8,
@@ -260,14 +269,7 @@ export function loadWorklets() {
  return workletsLoading;
 }

-let kabel;
-async function initKabelsalat() {
-  const { SalatRepl } = await import('@kabelsalat/web');
-  logger('[kabelsalat] ready');
-  kabel = new SalatRepl({ localScope: true });
-  return kabel;
-}
-
+let AUDIO_OUTPUTS;
 // this function should be called on first user interaction (to avoid console warning)
 export async function initAudio(options = {}) {
  const {
@@ -288,8 +290,8 @@ export async function initAudio(options = {}) {

  if (audioDeviceName != null && audioDeviceName != DEFAULT_AUDIO_DEVICE_NAME) {
    try {
-      const devices = await getAudioDevices();
-      const id = devices.get(audioDeviceName);
+      AUDIO_OUTPUTS = await getAudioDevices();
+      const id = AUDIO_OUTPUTS.get(audioDeviceName);
      const isValidID = (id ?? '').length > 0;
      if (audioCtx.sinkId !== id && isValidID) {
        await audioCtx.setSinkId(id);
@@ -314,7 +316,6 @@ export async function initAudio(options = {}) {
  } catch (err) {
    console.warn('could not load AudioWorklet effects', err);
  }
-  await initKabelsalat();
  logger('[superdough] ready');
 }
 let audioReady;
@@ -331,6 +332,51 @@ export async function initAudioOnFirstClick(options) {
  return audioReady;
 }

+const CACHED_INPUTS = {};
+export async function getInput(input) {
+  let sourceNode = CACHED_INPUTS[input];
+  if (sourceNode === undefined) {
+    const ac = getAudioContext();
+    if (!AUDIO_INPUTS) {
+      AUDIO_INPUTS = await getAudioInputs();
+    }
+    const available = Array.from(AUDIO_INPUTS.keys());
+    // Convert numerical inputs to their corresponding device name
+    const deviceName = typeof input === 'number' ? available[input] : input;
+    const inputId = AUDIO_INPUTS.get(deviceName);
+    if (inputId === undefined) {
+      throw new Error(`[superdough] input "${input}" not found. Available inputs: ${available.join(', ')}`);
+    }
+    const stream = await navigator.mediaDevices.getUserMedia({
+      audio: {
+        deviceId: { exact: inputId },
+        channelCount: { ideal: 2 },
+        sampleRate: { ideal: ac.sampleRate },
+        echoCancellation: false,
+        noiseSuppression: false,
+        autoGainControl: false,
+        latency: { ideal: 0.01 },
+      },
+    });
+    sourceNode = ac.createMediaStreamSource(stream);
+    CACHED_INPUTS[input] = sourceNode;
+  }
+  return sourceNode;
+}
+
+async function getInputHandle(input, value, start, end) {
+  const inputNode = await getInput(input);
+  const envGain = gainNode(0);
+  inputNode.connect(envGain);
+  const [attack, decay, sustain, release] = getADSRValues(
+    [value.attack, value.decay, value.sustain, value.release],
+    'linear',
+    [0.001, 0.05, 0.6, 0.01],
+  );
+  getParamADSR(envGain.gain, attack, decay, sustain, release, 0, 1, start, end, 'linear');
+  return { inputNode, envGain };
+}
+
 let controller;
 export function getSuperdoughAudioController() {
  if (controller == null) {
@@ -450,14 +496,6 @@ class Chain {
  }
 }

-const compileKabel = (code) => {
-  if (!kabel) {
-    throw new Error('kabelsalat not loaded');
-  }
-  const node = kabel.evaluate(code);
-  return node.compile({ log: false });
-};
-
 export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5) => {
  // mapping from main FX and numbered FX chains to nodes
  const nodes = { main: {} };
@@ -520,6 +558,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
    fft = getDefaultValue('fft'), // fftSize 0 - 10
    FX = [],
    FXrelease,
+    input,
  } = value;

  delaytime = delaytime ?? cycleToSeconds(delaysync, cps);
@@ -569,6 +608,21 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
  if (source) {
    sourceNode = source(t, value, hapDuration, cps);
    nodes.main['source'] = [sourceNode];
+  } else if (input) {
+    const { inputNode, envGain } = await getInputHandle(input, value, t, end);
+    sourceNode = envGain;
+    webAudioTimeout(
+      ac,
+      () => {
+        chain.releaseNodes();
+        activeSoundSources.delete(chainID);
+        // We disconnect inputNode instead of releasing it
+        // because we want inputs to persist
+        inputNode.disconnect(envGain);
+      },
+      t,
+      endWithRelease,
+    );
  } else if (getSound(s)) {
    const { onTrigger } = getSound(s);

@@ -605,7 +659,6 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
  }

  chain.connect(sourceNode);
-
  FX = [...FX, value]; // run through the FX chain and then run through all FX outside of it as well
  for (let [idx, fx] of Object.entries(FX)) {
    const key = idx == FX.length - 1 ? 'main' : idx;
@@ -623,6 +676,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
      delayfeedback = getDefaultValue('delayfeedback'),
      delaysync = getDefaultValue('delaysync'),
      delaytime,
+      stretch = getDefaultValue('stretch'),
      i = getDefaultValue('i'),
    } = fx;
    gain = applyGainCurve(nanFallback(gain, 1));
@@ -633,21 +687,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
    gain *= velocity; // velocity currently only multiplies with gain. it might do other things in the future
    delaytime = delaytime ?? cycleToSeconds(delaysync, cps);

-    // Kabelsalat
-    if (fx.workletSrc !== undefined) {
-      const workletNode = getWorklet(ac, 'generic-processor', {}, { outputChannelCount: [2] });
-      chain.connect(workletNode);
-      const workletSrc = fx.workletSrc
-        .replace(/\bpat\[(\d+)\]/g, (_, i) => fx.workletInputs[i])
-        .replaceAll('sFreq', getFrequencyFromValue(value))
-        .replaceAll('sGate', `cc('strudel-gate-${chainID}')`);
-      /* global compileKabel */
-      const { src, ugens, registers } = compileKabel(workletSrc);
-      workletNode.port.postMessage({ src, schema: { ugens, registers }, start: t, gateEnd: end, end: endWithRelease });
-    }
-
-    if (fx.stretch !== undefined) {
-      const phaseVocoder = getWorklet(ac, 'phase-vocoder-processor', { pitchFactor: fx.stretch });
+    if (stretch !== undefined) {
+      const phaseVocoder = getWorklet(ac, 'phase-vocoder-processor', { pitchFactor: stretch });
      chain.connect(phaseVocoder);
      fxNodes['stretch'] = [phaseVocoder];
    }
@@ -18,7 +18,7 @@ import {
 } from './helpers.mjs';
 import { logger } from './logger.mjs';
 import { getNoiseMix, getNoiseOscillator } from './noise.mjs';
-import { getNodeFromPool, releaseNodeToPool } from './nodePools.mjs';
+import { getNodeFromPool, markWorkletAsDead, releaseNodeToPool } from './nodePools.mjs';

 const waveforms = ['triangle', 'square', 'sawtooth', 'sine', 'user', 'one'];
 const waveformAliases = [
@@ -178,12 +178,17 @@ export function registerSynthSounds() {
      };
      const factory = () => new AudioWorkletNode(ac, 'supersaw-oscillator', { outputChannelCount: [2] });
      const o = getNodeFromPool('supersaw', factory);
+      const now = ac.currentTime;
      Object.entries(params).forEach(([key, value]) => {
        const param = o.parameters.get(key);
        const target = value !== undefined ? value : param.defaultValue;
-        param.value = target;
+        param.setValueAtTime(target, now);
      });
      o.port.postMessage({ type: 'initialize' });
+      o.port.onmessage = (e) => {
+        if (e.data.type === 'died') markWorkletAsDead(o);
+        o.port.onmessage = null;
+      };
      const gainAdjustment = 1 / Math.sqrt(voices);
      getPitchEnvelope(o.parameters.get('detune'), value, begin, holdend);
      const vibratoHandle = getVibratoOscillator(o.parameters.get('detune'), value, begin);
@@ -110,9 +110,7 @@ export function getCommonSampleInfo(hapValue, bank) {
  return { transpose, url, index, midi, label };
 }

-/** Selects entries from `source` and renames them via `map`
- * @tags internals
- */
+/** Selects entries from `source` and renames them via `map` */
 export const pickAndRename = (source, map) => {
  return Object.fromEntries(Object.entries(map).map(([newKey, oldKey]) => [newKey, source[oldKey]]));
 };
@@ -11,7 +11,7 @@ import {
  webAudioTimeout,
  releaseAudioNode,
 } from './helpers.mjs';
-import { getNodeFromPool, releaseNodeToPool } from './nodePools.mjs';
+import { getNodeFromPool, markWorkletAsDead, releaseNodeToPool } from './nodePools.mjs';
 import { logger } from './logger.mjs';

 export const Warpmode = Object.freeze({
@@ -186,7 +186,6 @@ export function registerWaveTable(key, tables, params) {
 * Loads a collection of wavetables to use with `s`
 *
 * @name tables
- * @tags fx
 */
 export const tables = async (url, frameLen, json, options = {}) => {
  if (json !== undefined) return _processTables(json, url, frameLen);
@@ -245,12 +244,17 @@ export async function onTriggerSynth(t, value, onended, tables, cps, frameLen) {
  };
  const factory = () => new AudioWorkletNode(ac, 'wavetable-oscillator-processor', { outputChannelCount: [2] });
  const source = getNodeFromPool('wavetable', factory);
+  const now = ac.currentTime;
  Object.entries(params).forEach(([key, value]) => {
    const param = source.parameters.get(key);
    const target = value !== undefined ? value : param.defaultValue;
-    param.value = target;
+    param.setValueAtTime(target, now);
  });
  source.port.postMessage({ type: 'initialize', payload });
+  source.port.onmessage = (e) => {
+    if (e.data.type === 'died') markWorkletAsDead(source);
+    source.port.onmessage = null;
+  };
  if (ac.currentTime > t) {
    logger(`[wavetable] still loading sound "${s}:${n}"`, 'highlight');
    return;
@@ -5,9 +5,6 @@
 import OLAProcessor from './ola-processor';
 import FFT from './fft.js';
 import { getDistortionAlgorithm } from './helpers.mjs';
-import * as ugens from '@kabelsalat/lib/src/ugens.js';
-
-const UGENS = new Map(Object.entries(ugens));

 const blockSize = 128;
 const PI = Math.PI;
@@ -466,6 +463,7 @@ registerProcessor('distort-processor', DistortProcessor);
 class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
  constructor() {
    super();
+    this.isAlive = true; // used internally to prevent multiple death messages
    this.port.onmessage = (e) => {
      const { type, payload } = e.data || {};
      if (type === 'initialize') {
@@ -481,16 +479,16 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
    return [
      {
        name: 'begin',
-        defaultValue: -1,
+        defaultValue: 0,
        max: Number.POSITIVE_INFINITY,
-        min: -1,
+        min: 0,
      },

      {
        name: 'end',
-        defaultValue: -1,
+        defaultValue: 0,
        max: Number.POSITIVE_INFINITY,
-        min: -1,
+        min: 0,
      },

      {
@@ -525,17 +523,16 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
    ];
  }
  process(_input, outputs, params) {
-    const begin = params.begin[0];
-    const end = params.end[0];
-    const beginDefined = begin >= 0;
-    const endDefined = end >= 0;
-    // We give a 0.5s grace period (for node pooling) before termination
-    const shouldTerminate = endDefined && currentTime >= end + 0.5;
-    const ended = endDefined && currentTime >= end;
-    const notStarted = currentTime <= begin;
-    if (shouldTerminate) {
+    if (currentTime >= params.end[0] + 0.5) {
+      // Outside of grace period - should terminate
+      if (this.isAlive) {
+        this.port.postMessage({ type: 'died' });
+        this.isAlive = false;
+      }
      return false;
-    } else if (ended || notStarted || !beginDefined) {
+    }
+    if (currentTime >= params.end[0] || currentTime <= params.begin[0]) {
+      // Inside of grace period or not yet started
      return true;
    }
    const output = outputs[0];
@@ -646,18 +643,14 @@ class PhaseVocoderProcessor extends OLAProcessor {
    this.timeCursor += this.hopSize;
  }

-  /** Apply Hann window in-place
-   * @tags internals
-   */
+  /** Apply Hann window in-place */
  applyHannWindow(input) {
    for (let i = 0; i < this.blockSize; i++) {
      input[i] *= this.hannWindow[i] * 1.62;
    }
  }

-  /** Compute squared magnitudes for peak finding
-   * @tags internals
-   **/
+  /** Compute squared magnitudes for peak finding **/
  computeMagnitudes() {
    let i = 0,
      j = 0;
@@ -671,9 +664,7 @@ class PhaseVocoderProcessor extends OLAProcessor {
    }
  }

-  /** Find peaks in spectrum magnitudes
-   * @tags internals
-   **/
+  /** Find peaks in spectrum magnitudes **/
  findPeaks() {
    this.nbPeaks = 0;
    let i = 2;
@@ -694,9 +685,7 @@ class PhaseVocoderProcessor extends OLAProcessor {
    }
  }

-  /** Shift peaks and regions of influence by pitchFactor into new specturm
-   * @tags internals
-   */
+  /** Shift peaks and regions of influence by pitchFactor into new specturm */
  shiftPeaks(pitchFactor) {
    // zero-fill new spectrum
    this.freqComplexBufferShifted.fill(0);
@@ -849,9 +838,7 @@ class PulseOscillatorProcessor extends AudioWorkletProcessor {

 registerProcessor('pulse-oscillator', PulseOscillatorProcessor);

-/**  BYTE BEATS
- * @tags internals
- */
+/**  BYTE BEATS */
 const chyx = {
  /*bit*/ bitC: function (x, y, z) {
    return x & y ? z : 0;
@@ -1161,8 +1148,8 @@ const tablesCache = {};
 class WavetableOscillatorProcessor extends AudioWorkletProcessor {
  static get parameterDescriptors() {
    return [
-      { name: 'begin', defaultValue: -1, min: -1, max: Number.POSITIVE_INFINITY },
-      { name: 'end', defaultValue: -1, min: -1, max: Number.POSITIVE_INFINITY },
+      { name: 'begin', defaultValue: 0, min: 0, max: Number.POSITIVE_INFINITY },
+      { name: 'end', defaultValue: 0, min: 0, max: Number.POSITIVE_INFINITY },
      { name: 'frequency', defaultValue: 440, min: Number.EPSILON },
      { name: 'detune', defaultValue: 0 },
      { name: 'freqspread', defaultValue: 0.18, min: 0 },
@@ -1177,6 +1164,7 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {

  constructor(options) {
    super(options);
+    this.isAlive = true; // used internally to prevent multiple death messages
    this.port.onmessage = (e) => {
      const { type, payload } = e.data || {};
      if (type === 'initialize') {
@@ -1344,17 +1332,16 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
  }

  process(_inputs, outputs, parameters) {
-    const begin = parameters.begin[0];
-    const end = parameters.end[0];
-    const beginDefined = begin >= 0;
-    const endDefined = end >= 0;
-    // We give a 0.5s grace period (for node pooling) before termination
-    const shouldTerminate = endDefined && currentTime >= end + 0.5;
-    const ended = endDefined && currentTime >= end;
-    const notStarted = currentTime <= begin;
-    if (shouldTerminate) {
+    if (currentTime >= parameters.end[0] + 0.5) {
+      // Outside of grace period - should terminate
+      if (this.isAlive) {
+        this.port.postMessage({ type: 'died' });
+        this.isAlive = false;
+      }
      return false;
-    } else if (ended || notStarted || !beginDefined) {
+    }
+    if (currentTime >= parameters.end[0] || currentTime <= parameters.begin[0]) {
+      // Inside of grace period or not yet started
      return true;
    }
    const outL = outputs[0][0];
@@ -1492,81 +1479,3 @@ class TransientProcessor extends AudioWorkletProcessor {
 }

 registerProcessor('transient-processor', TransientProcessor);
-
-class GenericProcessor extends AudioWorkletProcessor {
-  constructor() {
-    super();
-    this.playPos = 0;
-    const channels = 16;
-    this.outputs = new Array(channels).fill(0);
-    this.sources = new Array(channels).fill(0);
-    this.gateEnded = false;
-    this.started = false;
-    this.port.onmessage = (event) => {
-      let {
-        src,
-        schema: { ugens, registers },
-        start,
-        gateEnd,
-        end,
-      } = event.data;
-      this.start = start;
-      this.gateEnd = gateEnd;
-      this.end = end;
-      this.registers = new Array(registers).fill(0);
-      this.src = `o.fill(0); // reset outputs\n${src}`;
-      this.nodes = [];
-      for (let i = 0; i < ugens.length; i++) {
-        const ugen = ugens[i];
-        const nodeClass = UGENS.get(ugen.type);
-        const node = new nodeClass(i, ugen, sampleRate);
-        if (node.type === 'cc' && ugen.inputs?.[0]?.includes('strudel-gate')) {
-          node.setValue(1);
-          this.gateNode = node;
-        }
-        this.nodes[i] = node;
-      }
-      this.genSample = new Function(
-        'time',
-        'nodes',
-        'input',
-        'r', // registers
-        'o', // outputs
-        's', // sources
-        this.src,
-      );
-    };
-  }
-  process(inputs, outputs) {
-    const input = inputs[0]?.[0];
-    if (currentTime >= this.end) {
-      return false;
-    } else if (this.genSample === undefined || currentTime < this.start) {
-      // pending
-      return true;
-    }
-    this.started = true;
-    if (!this.gateEnded && currentTime > this.gateEnd) {
-      this.gateNode?.setValue(0);
-      this.gateEnded = true;
-    }
-    const output = outputs[0];
-    const outL = output[0];
-    const outR = output[1];
-    for (let n = 0; n < blockSize; n++) {
-      this.genSample(this.playPos, this.nodes, input ? input[n] : 0, this.registers, this.outputs, this.sources);
-      const left = this.outputs[0];
-      const right = this.outputs[1];
-      // Spread to stereo if possible; else mixdown to mono
-      if (outR) {
-        outL[n] = left;
-        outR[n] = right;
-      } else {
-        outL[n] = 0.5 * (left + right);
-      }
-      this.playPos += 1 / sampleRate;
-    }
-    return true;
-  }
-}
-registerProcessor('generic-processor', GenericProcessor);
@@ -19,7 +19,6 @@ function applyGainCurve(val) {
 * @param {number} a - Signal A (can be a single value or an array value in buffer processing).
 * @param {number} b - Signal B (can be a single value or an array value in buffer processing).
 * @param {number} m - Crossfade parameter (0.0 = all A, 1.0 = all B, 0.5 = equal mix).
- * @tags internals
 * @returns {number} Crossfaded output value.
 */
 function crossfade(a, b, m) {
@@ -1,6 +1,6 @@
 {
  "name": "@strudel/tonal",
-  "version": "1.2.6",
+  "version": "1.2.5",
  "description": "Tonal functions for strudel",
  "main": "index.mjs",
  "publishConfig": {
@@ -100,7 +100,6 @@ function scaleOffset(scale, offset, note) {
 * - 5P = perfect fifth
 * - 5d = diminished fifth
 *
- * @tags music_theory
 * @param {string | number} amount Either number of semitones or interval string.
 * @returns Pattern
 * @memberof Pattern
@@ -155,7 +154,6 @@ export const { transpose, trans } = register(['transpose', 'trans'], function tr
 *
 * @memberof Pattern
 * @name scaleTranspose
- * @tags music_theory
 * @param {offset} offset number of steps inside the scale
 * @returns Pattern
 * @synonyms scaleTrans, strans
@@ -246,7 +244,6 @@ function _getNearestScaleNote(scaleName, note, preferHigher = true) {
 * The root note defaults to octave 3, if no octave number is given.
 *
 * @name scale
- * @tags music_theory
 * @param {string} scale Name of scale
 * @returns Pattern
 * @example
@@ -90,7 +90,6 @@ export const setVoicingRange = (name, range) => addVoicings(name, voicingRegistr
 * Adds a new custom voicing dictionary.
 *
 * @name addVoicings
- * @tags music_theory
 * @memberof Pattern
 * @param {string} name identifier for the voicing dictionary
 * @param {Object} dictionary maps chord symbol to possible voicings
@@ -134,7 +133,6 @@ const getVoicing = (chord, dictionaryName, lastVoicing) => {
 * Uses [chord-voicings package](https://github.com/felixroos/chord-voicings#chord-voicings).
 *
 * @name voicings
- * @tags music_theory
 * @memberof Pattern
 * @param {string} dictionary which voicing dictionary to use.
 * @returns Pattern
@@ -159,7 +157,6 @@ export const voicings = register('voicings', function (dictionary, pat) {
 * Maps the chords of the incoming pattern to root notes in the given octave.
 *
 * @name rootNotes
- * @tags music_theory
 * @memberof Pattern
 * @param {octave} octave octave to use
 * @returns Pattern
@@ -192,7 +189,6 @@ export const rootNotes = register('rootNotes', function (octave, pat) {
 * If you pass a pattern of strings to voicing, they will be interpreted as chords.
 *
 * @name voicing
- * @tags music_theory
 * @returns Pattern
 * @example
 * n("0 1 2 3").chord("<C Am F G>").voicing()
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Aria	c3018a29a0	Update docstring and add an example	2026-01-11 19:10:02 -06:00
Aria	6bd1c877aa	Working version of inputs as sound sources	2026-01-11 19:03:20 -06:00