Merge branch 'main' into space-shell/helix-keybindings

2026-01-19 10:05:14 +01:00 · 2026-01-19 10:05:14 +01:00 · d2f2c6df02
commit d2f2c6df02
parent 18cc1e4466 8ec1d4d034
95 changed files with 3810 additions and 695 deletions
--- a/packages/codemirror/codemirror.mjs
+++ b/packages/codemirror/codemirror.mjs
@ -24,6 +24,7 @@ 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';

@ -119,6 +120,14 @@ 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?.()),
@ -425,6 +434,7 @@ 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')
--- a/packages/codemirror/labelJump.mjs
+++ b/packages/codemirror/labelJump.mjs
@ -0,0 +1,31 @@
+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;
+}
--- a/packages/codemirror/package.json
+++ b/packages/codemirror/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/codemirror",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "Codemirror Extensions for Strudel",
  "main": "index.mjs",
  "publishConfig": {
--- a/packages/codemirror/slider.mjs
+++ b/packages/codemirror/slider.mjs
@ -117,6 +117,7 @@ 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
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
--- a/packages/core/drawLine.mjs
+++ b/packages/core/drawLine.mjs
@ -15,6 +15,7 @@ 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
--- a/packages/core/euclid.mjs
+++ b/packages/core/euclid.mjs
@ -61,6 +61,7 @@ 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
@ -73,6 +74,7 @@ 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
@ -156,6 +158,7 @@ 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
@ -187,6 +190,7 @@ 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
@ -208,6 +212,7 @@ 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)
--- a/packages/core/index.mjs
+++ b/packages/core/index.mjs
@ -22,7 +22,7 @@ export * from './repl.mjs';
 export * from './signal.mjs';
 export * from './speak.mjs';
 export * from './state.mjs';
-export * from './time.mjs';
+export * from './schedulerState.mjs';
 export * from './timespan.mjs';
 export * from './ui.mjs';
 export * from './util.mjs';
--- a/packages/core/package.json
+++ b/packages/core/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/core",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Port of Tidal Cycles to JavaScript",
  "main": "index.mjs",
  "type": "module",
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
--- a/packages/core/pick.mjs
+++ b/packages/core/pick.mjs
@ -28,6 +28,7 @@ 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}
@ -57,6 +58,7 @@ 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}
@ -67,6 +69,7 @@ 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
@ -83,6 +86,7 @@ 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
@ -93,6 +97,7 @@ 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}
@ -103,6 +108,7 @@ 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}
@ -112,6 +118,7 @@ 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}
@ -122,6 +129,7 @@ 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}
@ -138,6 +146,7 @@ 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}
@ -148,6 +157,7 @@ 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}
@ -159,6 +169,7 @@ 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
@ -180,6 +191,7 @@ export const { inhabit, pickSqueeze } = register(['inhabit', 'pickSqueeze'], fun
 * second one.
 * @name inhabitmod
 * @synonyms pickmodSqueeze
+ * @tags combiners
 * @param {Pattern} pat
 * @param {*} xs
 * @returns {Pattern}
@ -192,6 +204,7 @@ 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}
--- a/packages/core/repl.mjs
+++ b/packages/core/repl.mjs
@ -2,7 +2,13 @@ import { NeoCyclist } from './neocyclist.mjs';
 import { Cyclist } from './cyclist.mjs';
 import { evaluate as _evaluate } from './evaluate.mjs';
 import { errorLogger, logger } from './logger.mjs';
-import { setTime } from './time.mjs';
+import {
+  setCpsFunc,
+  setIsStarted,
+  setPattern as exposeSchedulerPattern,
+  setTime,
+  setTriggerFunc,
+} from './schedulerState.mjs';
 import { evalScope } from './evaluate.mjs';
 import { register, Pattern, isPattern, silence, stack } from './pattern.mjs';
 import { reset_state } from './impure.mjs';
@ -52,6 +58,7 @@ export function repl({
    getTime,
    onToggle: (started) => {
      updateState({ started });
+      setIsStarted(started);
      onToggle?.(started);
      if (!started) {
        reset_state();
@ -65,6 +72,8 @@ 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;
@ -89,6 +98,7 @@ 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?
@ -106,6 +116,7 @@ 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
@ -119,7 +130,9 @@ export function repl({

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

-  /** 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
+  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
   * a version that applies the function to each pattern separately.
   * ```
   * $: sound("bd - cp sd")
@ -131,18 +144,21 @@ 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;
--- a/packages/core/schedulerState.mjs
+++ b/packages/core/schedulerState.mjs
@ -0,0 +1,53 @@
+/*
+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;
+}
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@ -24,6 +24,7 @@ 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))
@ -38,6 +39,7 @@ 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();

@ -45,6 +47,7 @@ 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))
@ -59,6 +62,7 @@ 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();

@ -66,12 +70,14 @@ 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")
@ -83,6 +89,7 @@ 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")
@ -94,12 +101,14 @@ 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")
 *
@ -110,6 +119,7 @@ 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();

@ -117,6 +127,7 @@ 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")
 *
@ -127,6 +138,7 @@ 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);

@ -134,6 +146,7 @@ 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")
 *
@ -144,6 +157,7 @@ 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);

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

@ -158,6 +173,7 @@ 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")
 *
@ -167,6 +183,7 @@ 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")
 *
@ -269,6 +286,7 @@ 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')
@ -280,6 +298,7 @@ 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")
@ -290,6 +309,7 @@ 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))
@ -304,6 +324,7 @@ 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
@ -321,6 +342,7 @@ 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)))
@ -334,6 +356,7 @@ 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
 */
@ -353,6 +376,7 @@ 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")
@ -384,6 +408,7 @@ 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
@ -397,6 +422,7 @@ 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
@ -409,6 +435,7 @@ 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
@ -428,6 +455,7 @@ 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();
@ -441,6 +469,7 @@ 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))
@ -449,6 +478,7 @@ 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();

@ -458,6 +488,7 @@ 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))
@ -468,6 +499,7 @@ 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)
 */
@ -479,6 +511,7 @@ 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)
@ -501,6 +534,7 @@ 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}
@ -514,6 +548,7 @@ 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}
@ -524,6 +559,7 @@ 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
@ -539,6 +575,7 @@ 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}
 */
@ -549,6 +586,7 @@ 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}
 */
@ -558,6 +596,7 @@ Pattern.prototype.choose2 = function (...xs) {

 /**
 * Picks one of the elements at random each cycle.
+ * @tags temporal
 * @synonyms randcat
 * @returns {Pattern}
 * @example
@ -600,6 +639,7 @@ 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
@ -609,6 +649,7 @@ 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
@ -652,6 +693,7 @@ 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
@ -664,6 +706,7 @@ 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
@ -684,6 +727,7 @@ 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
@ -709,6 +753,7 @@ 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
@ -725,6 +770,7 @@ 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
@ -753,6 +799,7 @@ 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
@ -771,6 +818,7 @@ 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
@ -790,6 +838,7 @@ 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
@ -811,6 +860,7 @@ 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"))
 */
@ -833,6 +883,7 @@ 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"))
 */
@ -847,6 +898,7 @@ 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"))
 */
@ -861,6 +913,7 @@ 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"))
 */
@ -872,6 +925,7 @@ export const rarely = register('rarely', function (func, pat) {
 *
 * Shorthand for `.sometimesBy(0.1, fn)`
 *
+ * @tags temporal
 * @name almostNever
 * @memberof Pattern
 * @returns Pattern
@ -886,6 +940,7 @@ export const almostNever = register('almostNever', function (func, pat) {
 *
 * Shorthand for `.sometimesBy(0.9, fn)`
 *
+ * @tags temporal
 * @name almostAlways
 * @memberof Pattern
 * @returns Pattern
@ -900,6 +955,7 @@ export const almostAlways = register('almostAlways', function (func, pat) {
 *
 * Shorthand for `.sometimesBy(0, fn)` (never calls fn)
 *
+ * @tags temporal
 * @name never
 * @memberof Pattern
 * @returns Pattern
@ -914,6 +970,7 @@ export const never = register('never', function (_, pat) {
 *
 * Shorthand for `.sometimesBy(1, fn)` (always calls fn)
 *
+ * @tags temporal
 * @name always
 * @memberof Pattern
 * @returns Pattern
@ -942,6 +999,7 @@ 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
@ -958,6 +1016,7 @@ 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
@ -975,6 +1034,8 @@ 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")
@ -993,6 +1054,7 @@ 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
@ -1010,6 +1072,7 @@ 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);
--- a/packages/core/time.mjs
+++ b/packages/core/time.mjs
@ -1,11 +0,0 @@
-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;
-}
--- a/packages/csound/index.mjs
+++ b/packages/csound/index.mjs
@ -135,6 +135,8 @@ 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;
--- a/packages/csound/package.json
+++ b/packages/csound/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/csound",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "csound bindings for strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/draw/package.json
+++ b/packages/draw/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/draw",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Helpers for drawing with Strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/draw/pianoroll.mjs
+++ b/packages/draw/pianoroll.mjs
@ -42,6 +42,7 @@ 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
@ -299,6 +300,7 @@ 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 });
--- a/packages/draw/pitchwheel.mjs
+++ b/packages/draw/pitchwheel.mjs
@ -116,6 +116,7 @@ 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
--- a/packages/draw/spiral.mjs
+++ b/packages/draw/spiral.mjs
@ -129,6 +129,7 @@ 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
--- a/packages/embed/package.json
+++ b/packages/embed/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/embed",
-  "version": "1.1.1",
+  "version": "1.1.2",
  "description": "Embeddable Web Component to load a Strudel REPL into an iframe",
  "main": "embed.js",
  "type": "module",
--- a/packages/gamepad/package.json
+++ b/packages/gamepad/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/gamepad",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Gamepad Inputs for strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/hydra/package.json
+++ b/packages/hydra/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/hydra",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Hydra integration for strudel",
  "main": "hydra.mjs",
  "type": "module",
--- a/packages/midi/midi.mjs
+++ b/packages/midi/midi.mjs
@ -5,9 +5,23 @@ This program is free software: you can redistribute it and/or modify it under th
 */

 import * as _WebMidi from 'webmidi';
-import { Pattern, isPattern, logger, ref } from '@strudel/core';
+import {
+  Hap,
+  Pattern,
+  TimeSpan,
+  getCps,
+  getIsStarted,
+  getPattern,
+  getTime,
+  getTriggerFunc,
+  isPattern,
+  logger,
+  ref,
+  reify,
+} 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:
@ -124,6 +138,7 @@ 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();
@ -137,6 +152,7 @@ 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")
@ -291,6 +307,7 @@ 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
@ -477,14 +494,42 @@ Pattern.prototype.midi = function (midiport, options = {}) {
  });
 };

-let listeners = {};
-const refs = {};
-const refsByChan = {};
+/**
+ * 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;
+}

 /**
 * 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)
@ -498,29 +543,11 @@ const refsByChan = {};
 * 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) {
-  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)}` : ''
-      }`,
-    );
-  }
+  const device = await _initialize(input);
  refs[input] ??= {};
  refsByChan[input] ??= {};
  const cc = (cc, chan) => {
@ -532,8 +559,7 @@ export async function midin(input) {

  listeners[input] && device.removeListener('midimessage', listeners[input]);
  listeners[input] = (e) => {
-    const ccNum = e.dataBytes[0];
-    const v = e.dataBytes[1];
+    const [ccNum, v] = e.dataBytes;
    const chan = e.message.channel;
    const scaled = v / 127;
    refsByChan[input][ccNum] ??= {};
@ -543,3 +569,133 @@ 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;
+}
--- a/packages/midi/package.json
+++ b/packages/midi/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/midi",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "Midi API for strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/mini/package.json
+++ b/packages/mini/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/mini",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Mini notation for strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/mondo/package.json
+++ b/packages/mondo/package.json
@ -1,6 +1,6 @@
 {
  "name": "mondolang",
-  "version": "1.1.1",
+  "version": "1.1.2",
  "description": "a language for functional composition that translates to js",
  "main": "mondo.mjs",
  "type": "module",
--- a/packages/mondough/package.json
+++ b/packages/mondough/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/mondo",
-  "version": "1.1.5",
+  "version": "1.1.6",
  "description": "mondo notation for strudel",
  "main": "mondough.mjs",
  "type": "module",
--- a/packages/motion/motion.mjs
+++ b/packages/motion/motion.mjs
@ -7,6 +7,7 @@ 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")
 *
@ -17,6 +18,7 @@ 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")
 *
@ -27,6 +29,7 @@ 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")
 *
@ -37,6 +40,7 @@ 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")
 *
@ -47,6 +51,7 @@ 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")
 *
@ -57,6 +62,7 @@ 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")
 *
@ -67,6 +73,7 @@ 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")
 *
@ -77,6 +84,7 @@ 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")
 *
@ -87,6 +95,7 @@ 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")
 *
@ -97,6 +106,7 @@ 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")
 *
@ -107,6 +117,7 @@ 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")
 *
@ -117,6 +128,7 @@ 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")
 *
@ -127,6 +139,7 @@ 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")
 *
@ -137,6 +150,7 @@ 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")
 *
@ -147,6 +161,7 @@ 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")
 *
--- a/packages/motion/package.json
+++ b/packages/motion/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/motion",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "DeviceMotion API for strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/mqtt/package.json
+++ b/packages/mqtt/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/mqtt",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "MQTT API for strudel",
  "main": "mqtt.mjs",
  "type": "module",
--- a/packages/osc/osc.mjs
+++ b/packages/osc/osc.mjs
@ -79,6 +79,7 @@ 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
 */
--- a/packages/osc/package.json
+++ b/packages/osc/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/osc",
-  "version": "1.3.0",
+  "version": "1.3.2",
  "description": "OSC messaging for strudel",
  "main": "osc.mjs",
  "bin": "./server.js",
--- a/packages/reference/package.json
+++ b/packages/reference/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/reference",
-  "version": "1.2.1",
+  "version": "1.2.2",
  "description": "Headless reference of all strudel functions",
  "main": "index.mjs",
  "type": "module",
--- a/packages/repl/package.json
+++ b/packages/repl/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/repl",
-  "version": "1.2.7",
+  "version": "1.3.0",
  "description": "Strudel REPL as a Web Component",
  "module": "index.mjs",
  "publishConfig": {
--- a/packages/repl/repl-component.mjs
+++ b/packages/repl/repl-component.mjs
@ -1,11 +1,12 @@
 import { silence } from '@strudel/core';
 import { getDrawContext } from '@strudel/draw';
 import { transpiler } from '@strudel/transpiler';
-import { getAudioContext, webaudioOutput } from '@strudel/webaudio';
+import { getAudioContext, webaudioOutput, initAudioOnFirstClick } from '@strudel/webaudio';
 import { StrudelMirror, codemirrorSettings } from '@strudel/codemirror';
 import { prebake } from './prebake.mjs';

 if (typeof HTMLElement !== 'undefined') {
+  initAudioOnFirstClick();
  class StrudelRepl extends HTMLElement {
    static observedAttributes = ['code'];
    settings = codemirrorSettings.get();
--- a/packages/sampler/package.json
+++ b/packages/sampler/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/sampler",
-  "version": "0.2.3",
+  "version": "0.2.4",
  "description": "",
  "keywords": [
    "tidalcycles",
--- a/packages/serial/package.json
+++ b/packages/serial/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/serial",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Webserial API for strudel",
  "main": "serial.mjs",
  "type": "module",
--- a/packages/serial/serial.mjs
+++ b/packages/serial/serial.mjs
@ -68,7 +68,7 @@ Pattern.prototype.serial = function (br = 115200, sendcrc = false, singlecharids
    if (!(name in writeMessagers)) {
      getWriter(name, br);
    }
-    const onTrigger = (t_deprecate, hap, currentTime, cps, targetTime) => {
+    const onTrigger = (hap, currentTime, _cps, targetTime) => {
      var message = '';
      var chk = 0;
      if (typeof hap.value === 'object') {
--- a/packages/soundfonts/package.json
+++ b/packages/soundfonts/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/soundfonts",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "Soundsfont support for strudel",
  "main": "index.mjs",
  "publishConfig": {
--- a/packages/superdough/audioContext.mjs
+++ b/packages/superdough/audioContext.mjs
@ -1,3 +1,12 @@
+/*
+audioContext.mjs - Audio Context manager
+
+Sets up a common and accessible audio context for all superdough operations
+
+Copyright (C) 2025 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/superdough/audiocontext.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 audioContext;

 export const setDefaultAudioContext = () => {
--- a/packages/superdough/helpers.mjs
+++ b/packages/superdough/helpers.mjs
@ -1,6 +1,7 @@
 import { getAudioContext } from './audioContext.mjs';
 import { logger } from './logger.mjs';
 import { getNoiseBuffer } from './noise.mjs';
+import { getNodeFromPool } from './nodePools.mjs';
 import { clamp, nanFallback, midiToFreq, noteToMidi } from './util.mjs';

 export const noises = ['pink', 'white', 'brown', 'crackle'];
@ -145,6 +146,7 @@ export function getLfo(audioContext, properties = {}) {
 }

 export function getCompressor(ac, threshold, ratio, knee, attack, release) {
+  const node = getNodeFromPool('compressor', () => new DynamicsCompressorNode(ac, {}));
  const options = {
    threshold: threshold ?? -3,
    ratio: ratio ?? 10,
@ -152,7 +154,10 @@ export function getCompressor(ac, threshold, ratio, knee, attack, release) {
    attack: attack ?? 0.005,
    release: release ?? 0.05,
  };
-  return new DynamicsCompressorNode(ac, options);
+  Object.entries(options).forEach(([key, value]) => {
+    node[key].value = value;
+  });
+  return node;
 }

 // changes the default values of the envelope based on what parameters the user has defined
@ -167,6 +172,7 @@ 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)];
 };
@ -233,10 +239,12 @@ export function createFilter(context, start, end, params, cps, cycle) {
    filter = getWorklet(context, 'ladder-processor', { frequency, q, drive });
    frequencyParam = filter.parameters.get('frequency');
  } else {
-    filter = context.createBiquadFilter();
+    const factory = () => context.createBiquadFilter();
+    filter = getNodeFromPool('filter', factory);
    filter.type = type;
-    filter.Q.value = q;
-    filter.frequency.value = frequency;
+    Object.entries({ Q: q, frequency }).forEach(([key, value]) => {
+      filter[key].value = value;
+    });
    frequencyParam = filter.frequency;
  }
  const envelopeValues = [params.attack, params.decay, params.sustain, params.release];
@ -461,10 +469,11 @@ export function applyFM(param, value, begin) {
          nodes[`fm_${idx}`] = [osc];
        }
        const { input, output, freq, osc, toCleanup } = fms[idx];
-        const g = gainNode(amt * freq);
-        io.push(isMod ? output.connect(g) : input);
-        cleanupOnEnd(osc, [...toCleanup, g]);
-        nodes[`fm_${idx}_gain`] = [g];
+        const gAmt = gainNode(amt);
+        const gFreq = gainNode(freq);
+        io.push(isMod ? output.connect(gAmt).connect(gFreq) : input);
+        cleanupOnEnd(osc, [...toCleanup, gAmt, gFreq]);
+        nodes[`fm_${idx}_gain`] = [gAmt];
      }
      if (!io[1]) {
        logger(
--- a/packages/superdough/modulators.mjs
+++ b/packages/superdough/modulators.mjs
@ -32,8 +32,9 @@ const getNodeParam = (node, name) => {

 const controlTargets = getSuperdoughControlTargets();

-const getControlData = (control) => {
-  return controlTargets[control.split('_')[0]];
+const getControlData = (control, subControl) => {
+  const controlNoIdx = control.split('_')[0];
+  return controlTargets[`${controlNoIdx}_${subControl}`] ?? controlTargets[controlNoIdx];
 };

 const getRangeForParam = (paramName, currentValue) => {
@ -59,8 +60,7 @@ const clampWithWaveShaper = (modulator, min, max) => {
 };

 const getTargetParamsForControl = (control, nodes, subControl) => {
-  const lookupKey = subControl ? `${control}_${subControl}` : control;
-  const targetInfo = getControlData(lookupKey) ?? getControlData(control);
+  const targetInfo = getControlData(control, subControl);
  if (!targetInfo) {
    errorLogger(
      new Error(`Could not find control data for target '${control}'. It may not be modulatable.`),
--- a/packages/superdough/nodePools.mjs
+++ b/packages/superdough/nodePools.mjs
@ -0,0 +1,84 @@
+/*
+nodePools.mjs - Helper functions related to pooling and re-using audio nodes
+
+Copyright (C) 2025 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/superdough/nodePools.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/>.
+*/
+
+const nodePools = new Map();
+const POOL_KEY = Symbol('nodePoolKey');
+
+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));
+  const visited = new Set(); // prioritize deepest definition
+  let proto = node;
+  // Move up the prototype chain
+  while (proto !== Object.prototype) {
+    for (const key of Object.getOwnPropertyNames(proto)) {
+      if (visited.has(key)) continue;
+      visited.add(key);
+      const value = node[key];
+      if (value instanceof AudioParam) {
+        params.add(value);
+      }
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+  return params;
+};
+
+export const releaseNodeToPool = (node) => {
+  node.disconnect();
+  if (node instanceof AudioScheduledSourceNode) {
+    // not reusable
+    return;
+  }
+  const key = node[POOL_KEY];
+  if (key == null) return;
+  const now = getNodeTime(node);
+  getParams(node).forEach((param) => param.cancelScheduledValues(now));
+  const pool = nodePools.get(key) ?? [];
+  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;
+};
+
+// 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 (!found) {
+    node = factory();
+  }
+  node[POOL_KEY] = key;
+  return node;
+};
--- a/packages/superdough/ola-processor.js
+++ b/packages/superdough/ola-processor.js
@ -35,7 +35,9 @@ class OLAProcessor extends AudioWorkletProcessor {
  }

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

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

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

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

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

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

-  /** Add contents of output buffers just processed to output buffers **/
+  /** Add contents of output buffers just processed to output buffers
+   * @tags internals
+   **/
  handleOutputBuffersToRetrieve() {
    for (let i = 0; i < this.nbOutputs; i++) {
      for (let j = 0; j < this.outputBuffers[i].length; j++) {
--- a/packages/superdough/package.json
+++ b/packages/superdough/package.json
@ -1,6 +1,6 @@
 {
  "name": "superdough",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "simple web audio synth and sampler intended for live coding. inspired by superdirt and webdirt.",
  "main": "index.mjs",
  "type": "module",
@ -36,6 +36,8 @@
    "vite-plugin-bundle-audioworklet": "workspace:*"
  },
  "dependencies": {
+    "@kabelsalat/lib": "^0.4.1",
+    "@kabelsalat/web": "^0.4.1",
    "nanostores": "^0.11.3"
  },
  "engines": {
--- a/packages/superdough/reverbGen.mjs
+++ b/packages/superdough/reverbGen.mjs
@ -18,6 +18,7 @@ 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
@ -50,7 +51,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.
@ -81,7 +82,9 @@ 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.*/
+  immediately within the current execution context, or later.
+ @tags internals
+  */
 var applyGradualLowpass = function (input, lpFreqStart, lpFreqEnd, lpFreqEndAt, callback) {
  if (lpFreqStart == 0) {
    callback(input);
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@ -65,21 +65,22 @@ export const getSampleBufferSource = async (hapValue, bank, resolveUrl) => {
  bufferSource.playbackRate.value = playbackRate;

  const { loopBegin = 0, loopEnd = 1, begin = 0, end = 1 } = hapValue;
+  const bufferDuration = bufferSource.buffer.duration;

-  // "The computation of the offset into the sound is performed using the sound buffer's natural sample rate,
-  // rather than the current playback rate, so even if the sound is playing at twice its normal speed,
-  // the midway point through a 10-second audio buffer is still 5."
-  const offset = begin * bufferSource.buffer.duration;
+  // The computation of the offset into the sound is performed using the sound buffer's natural duration,
+  // rather than the playback duration, so that even if the sound is playing at twice its normal speed,
+  // the midway point through a 10-second audio buffer is still 5.
+  const offset = begin * bufferDuration;

  const loop = hapValue.loop;
  if (loop) {
    bufferSource.loop = true;
-    bufferSource.loopStart = loopBegin * bufferSource.buffer.duration - offset;
-    bufferSource.loopEnd = loopEnd * bufferSource.buffer.duration - offset;
+    bufferSource.loopStart = loopBegin * bufferDuration;
+    bufferSource.loopEnd = loopEnd * bufferDuration;
  }
-  const bufferDuration = bufferSource.buffer.duration / bufferSource.playbackRate.value;
-  const sliceDuration = (end - begin) * bufferDuration;
-  return { bufferSource, offset, bufferDuration, sliceDuration };
+  const playbackDuration = bufferDuration / bufferSource.playbackRate.value;
+  const sliceDuration = (end - begin) * playbackDuration;
+  return { bufferSource, offset, bufferDuration, playbackDuration, sliceDuration };
 };

 export const loadBuffer = (url, ac, s, n = 0) => {
@ -234,6 +235,7 @@ 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")
--- a/packages/superdough/superdough.mjs
+++ b/packages/superdough/superdough.mjs
@ -9,12 +9,14 @@ import './reverb.mjs';
 import './vowel.mjs';
 import { clamp, nanFallback, _mod, cycleToSeconds, pickAndRename } from './util.mjs';
 import workletsUrl from './worklets.mjs?audioworklet';
+import { getNodeFromPool, isPoolable, releaseNodeToPool } from './nodePools.mjs';
 import {
  createFilter,
  effectSend,
  gainNode,
  getCompressor,
  getDistortion,
+  getFrequencyFromValue,
  getLfo,
  getWorklet,
  releaseAudioNode,
@ -38,6 +40,7 @@ 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)
@ -71,6 +74,7 @@ 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
@ -126,6 +130,8 @@ 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) {
@ -144,6 +150,7 @@ 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
 */
@ -253,6 +260,14 @@ 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;
+}
+
 // this function should be called on first user interaction (to avoid console warning)
 export async function initAudio(options = {}) {
  const {
@ -299,6 +314,7 @@ export async function initAudio(options = {}) {
  } catch (err) {
    console.warn('could not load AudioWorklet effects', err);
  }
+  await initKabelsalat();
  logger('[superdough] ready');
 }
 let audioReady;
@ -342,7 +358,7 @@ function getPhaser(begin, end, frequency = 1, depth = 0.5, centerFrequency = 100
  let fOffset = 282; //for backward compat in #1800
  const filterChain = [];
  for (let i = 0; i < numStages; i++) {
-    const filter = ac.createBiquadFilter();
+    const filter = getNodeFromPool('filter', () => ac.createBiquadFilter());
    filter.type = 'notch';
    filter.gain.value = 1;
    filter.frequency.value = centerFrequency + fOffset;
@ -407,9 +423,9 @@ function mapChannelNumbers(channels) {
 }

 class Chain {
-  constructor(head) {
-    this.audioNodes = [head];
-    this.tails = [head];
+  constructor() {
+    this.audioNodes = [];
+    this.tails = [];
  }
  connect(...nodes) {
    nodes.forEach((node) => {
@ -428,12 +444,20 @@ class Chain {
    return this;
  }
  releaseNodes() {
-    this.audioNodes.forEach((n) => releaseAudioNode(n));
+    this.audioNodes.forEach((n) => (isPoolable(n) ? releaseNodeToPool(n) : releaseAudioNode(n)));
    this.audioNodes = [];
    this.tails = [];
  }
 }

+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: {} };
@ -538,6 +562,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
    value.s = s;
  }

+  const chain = new Chain(); // connection manager which tracks audio nodes for releasing
+
  // get source AudioNode
  let sourceNode;
  if (source) {
@ -545,8 +571,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
    nodes.main['source'] = [sourceNode];
  } else if (getSound(s)) {
    const { onTrigger } = getSound(s);
-    // We have to use onEnded because some sources (e.g. `sampler`) have
-    // an internal duration which is longer than `value.duration`
+
    const onEnded = () =>
      webAudioTimeout(
        ac,
@ -557,6 +582,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
        0,
        endWithRelease,
      );
+
    const soundHandle = await onTrigger(t, value, onEnded, cps);

    if (soundHandle) {
@ -578,7 +604,8 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
    return;
  }

-  const chain = new Chain(sourceNode); // connection manager which tracks audio nodes for releasing
+  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;
@ -596,7 +623,6 @@ 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));
@ -607,8 +633,21 @@ 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);

-    if (stretch !== undefined) {
-      const phaseVocoder = getWorklet(ac, 'phase-vocoder-processor', { pitchFactor: stretch });
+    // 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 });
      chain.connect(phaseVocoder);
      fxNodes['stretch'] = [phaseVocoder];
    }
--- a/packages/superdough/superdoughoutput.mjs
+++ b/packages/superdough/superdoughoutput.mjs
@ -1,3 +1,12 @@
+/*
+superdoughoutput.mjs - Output controller for superdough
+
+Handles setting up and mixing to the outputs as well as all global (orbit) effects
+
+Copyright (C) 2025 Strudel contributors - see <https://codeberg.org/uzu/strudel/src/branch/main/packages/superdough/superdoughoutput.mjs>
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+
 import { effectSend, getWorklet, webAudioTimeout } from './helpers.mjs';
 import { errorLogger } from './logger.mjs';
 import { clamp } from './util.mjs';
--- a/packages/superdough/synth.mjs
+++ b/packages/superdough/synth.mjs
@ -18,6 +18,7 @@ import {
 } from './helpers.mjs';
 import { logger } from './logger.mjs';
 import { getNoiseMix, getNoiseOscillator } from './noise.mjs';
+import { getNodeFromPool, releaseNodeToPool } from './nodePools.mjs';

 const waveforms = ['triangle', 'square', 'sawtooth', 'sine', 'user', 'one'];
 const waveformAliases = [
@ -167,22 +168,22 @@ export function registerSynthSounds() {
      const end = holdend + release + 0.01;
      const voices = clamp(unison, 1, 100);
      let panspread = voices > 1 ? clamp(spread, 0, 1) : 0;
-      let o = getWorklet(
-        ac,
-        'supersaw-oscillator',
-        {
-          frequency,
-          begin,
-          end,
-          freqspread: detune,
-          voices,
-          panspread,
-        },
-        {
-          outputChannelCount: [2],
-        },
-      );
-
+      const params = {
+        frequency,
+        begin,
+        end,
+        freqspread: detune,
+        voices,
+        panspread,
+      };
+      const factory = () => new AudioWorkletNode(ac, 'supersaw-oscillator', { outputChannelCount: [2] });
+      const o = getNodeFromPool('supersaw', factory);
+      Object.entries(params).forEach(([key, value]) => {
+        const param = o.parameters.get(key);
+        const target = value !== undefined ? value : param.defaultValue;
+        param.value = target;
+      });
+      o.port.postMessage({ type: 'initialize' });
      const gainAdjustment = 1 / Math.sqrt(voices);
      getPitchEnvelope(o.parameters.get('detune'), value, begin, holdend);
      const vibratoHandle = getVibratoOscillator(o.parameters.get('detune'), value, begin);
@ -195,7 +196,7 @@ export function registerSynthSounds() {
      let timeoutNode = webAudioTimeout(
        ac,
        () => {
-          releaseAudioNode(o);
+          releaseNodeToPool(o);
          onended();
          fmHandle?.stop();
          vibratoHandle?.stop();
--- a/packages/superdough/util.mjs
+++ b/packages/superdough/util.mjs
@ -110,7 +110,9 @@ export function getCommonSampleInfo(hapValue, bank) {
  return { transpose, url, index, midi, label };
 }

-/** Selects entries from `source` and renames them via `map` */
+/** Selects entries from `source` and renames them via `map`
+ * @tags internals
+ */
 export const pickAndRename = (source, map) => {
  return Object.fromEntries(Object.entries(map).map(([newKey, oldKey]) => [newKey, source[oldKey]]));
 };
--- a/packages/superdough/wavetable.mjs
+++ b/packages/superdough/wavetable.mjs
@ -8,10 +8,10 @@ import {
  getParamADSR,
  getPitchEnvelope,
  getVibratoOscillator,
-  getWorklet,
-  releaseAudioNode,
  webAudioTimeout,
+  releaseAudioNode,
 } from './helpers.mjs';
+import { getNodeFromPool, releaseNodeToPool } from './nodePools.mjs';
 import { logger } from './logger.mjs';

 export const Warpmode = Object.freeze({
@ -186,6 +186,7 @@ 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);
@ -230,24 +231,26 @@ export async function onTriggerSynth(t, value, onended, tables, cps, frameLen) {
  }
  const endWithRelease = holdEnd + release;
  const envEnd = endWithRelease + 0.01;
-  const source = getWorklet(
-    ac,
-    'wavetable-oscillator-processor',
-    {
-      begin: t,
-      end: envEnd,
-      frequency,
-      freqspread: value.detune,
-      position: value.wt,
-      warp: value.warp,
-      warpMode: warpmode,
-      voices: Math.max(value.unison ?? 1, 1),
-      panspread: value.spread,
-      phaserand: (value.wtphaserand ?? value.unison > 1) ? 1 : 0,
-    },
-    { outputChannelCount: [2] },
-  );
-  source.port.postMessage({ type: 'table', payload });
+  const params = {
+    begin: t,
+    end: envEnd,
+    frequency,
+    freqspread: value.detune,
+    position: value.wt,
+    warp: value.warp,
+    warpMode: warpmode,
+    voices: Math.max(value.unison ?? 1, 1),
+    panspread: value.spread,
+    phaserand: (value.wtphaserand ?? value.unison > 1) ? 1 : 0,
+  };
+  const factory = () => new AudioWorkletNode(ac, 'wavetable-oscillator-processor', { outputChannelCount: [2] });
+  const source = getNodeFromPool('wavetable', factory);
+  Object.entries(params).forEach(([key, value]) => {
+    const param = source.parameters.get(key);
+    const target = value !== undefined ? value : param.defaultValue;
+    param.value = target;
+  });
+  source.port.postMessage({ type: 'initialize', payload });
  if (ac.currentTime > t) {
    logger(`[wavetable] still loading sound "${s}:${n}"`, 'highlight');
    return;
@ -333,7 +336,7 @@ export async function onTriggerSynth(t, value, onended, tables, cps, frameLen) {
  const timeoutNode = webAudioTimeout(
    ac,
    () => {
-      releaseAudioNode(source);
+      releaseNodeToPool(source);
      vibratoHandle?.stop();
      fmHandle?.stop();
      releaseAudioNode(wtPosModulators);
--- a/packages/superdough/worklets.mjs
+++ b/packages/superdough/worklets.mjs
@ -5,6 +5,9 @@
 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;
@ -463,22 +466,31 @@ registerProcessor('distort-processor', DistortProcessor);
 class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
  constructor() {
    super();
+    this.port.onmessage = (e) => {
+      const { type, payload } = e.data || {};
+      if (type === 'initialize') {
+        this.initialize(payload);
+      }
+    };
+    this.initialize();
+  }
+  initialize(_options) {
    this.phase = [];
  }
  static get parameterDescriptors() {
    return [
      {
        name: 'begin',
-        defaultValue: 0,
+        defaultValue: -1,
        max: Number.POSITIVE_INFINITY,
-        min: 0,
+        min: -1,
      },

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

      {
@ -513,12 +525,17 @@ class SuperSawOscillatorProcessor extends AudioWorkletProcessor {
    ];
  }
  process(_input, outputs, params) {
-    if (currentTime >= params.end[0]) {
-      // should terminate
+    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) {
      return false;
-    }
-    if (currentTime <= params.begin[0]) {
-      // keep alive
+    } else if (ended || notStarted || !beginDefined) {
      return true;
    }
    const output = outputs[0];
@ -629,14 +646,18 @@ class PhaseVocoderProcessor extends OLAProcessor {
    this.timeCursor += this.hopSize;
  }

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

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

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

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

 registerProcessor('pulse-oscillator', PulseOscillatorProcessor);

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

  constructor(options) {
    super(options);
-    this.frameLen = 0;
-    this.numFrames = 0;
-    this.phase = [];
-
    this.port.onmessage = (e) => {
      const { type, payload } = e.data || {};
-      if (type === 'table') {
-        const key = payload.key;
-        this.frameLen = payload.frameLen;
-        if (!tablesCache[key]) {
-          const tables = [payload.frames];
-          let table = tables[0];
-          for (let level = 1; level < 1; level++) {
-            const nextLen = table.length >> 1;
-            const nextTable = table.map((frame) => {
-              const avg = new Float32Array(nextLen);
-              for (let i = 0; i < nextLen; i++) {
-                avg[i] = (frame[2 * i] + frame[2 * i + 1]) / 2;
-              }
-              return avg;
-            });
-            tables.push(nextTable);
-            table = nextTable;
-            if (nextLen <= 32) break;
-          }
-          tablesCache[key] = tables;
-        }
-        this.tables = tablesCache[key];
-        this.numFrames = this.tables[0].length;
+      if (type === 'initialize') {
+        this.initialize(payload);
      }
    };
+    this.initialize();
+  }
+  initialize(options) {
+    this.table = null;
+    this.frameLen = null;
+    this.numFrames = null;
+    this.phase = [];
+    if (options?.key) {
+      const key = options.key;
+      this.frameLen = options.frameLen;
+      if (!tablesCache[key]) {
+        tablesCache[key] = options.frames;
+      }
+      this.table = tablesCache[key];
+      this.numFrames = this.table.length;
+    }
  }

  _mirror(x) {
@ -1325,25 +1343,23 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
    return a + (b - a) * frac;
  }

-  _chooseMip(dphi) {
-    const approxHarm = clamp(dphi, 1e-6, 64);
-    let level = 0;
-    while (level + 1 < (this.tables?.length || 1) && approxHarm < this.tables[level][0].length / 8) {
-      level++;
-    }
-    return level;
-  }
-
  process(_inputs, outputs, parameters) {
-    if (currentTime >= parameters.end[0]) {
+    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) {
      return false;
-    }
-    if (currentTime <= parameters.begin[0]) {
+    } else if (ended || notStarted || !beginDefined) {
      return true;
    }
    const outL = outputs[0][0];
    const outR = outputs[0][1] || outputs[0][0];
-    if (!this.tables) {
+    if (!this.table) {
      outL.fill(0);
      if (outR !== outL) outR.set(outL);
      return true;
@ -1377,14 +1393,12 @@ class WavetableOscillatorProcessor extends AudioWorkletProcessor {
        }
        const fVoice = applySemitoneDetuneToFrequency(f, detuner(n)); // voice detune
        const dPhase = fVoice * INVSR;
-        const level = this._chooseMip(dPhase);
-        const table = this.tables[level];

        // warp phase then sample
        this.phase[n] = this.phase[n] ?? Math.random() * phaseRand;
        const ph = this._warpPhase(this.phase[n], warpAmount, warpMode);
-        const s0 = this._sampleFrame(table[fIdx], ph);
-        const s1 = this._sampleFrame(table[Math.min(this.numFrames - 1, fIdx + 1)], ph);
+        const s0 = this._sampleFrame(this.table[fIdx], ph);
+        const s1 = this._sampleFrame(this.table[Math.min(this.numFrames - 1, fIdx + 1)], ph);
        let s = lerp(s0, s1, interpT);
        if (warpMode === WarpMode.FLIP && this.phase[n] < warpAmount) {
          s = -s;
@ -1478,3 +1492,81 @@ 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);
--- a/packages/supradough/dough.mjs
+++ b/packages/supradough/dough.mjs
@ -19,6 +19,7 @@ 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) {
--- a/packages/tonal/package.json
+++ b/packages/tonal/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/tonal",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Tonal functions for strudel",
  "main": "index.mjs",
  "publishConfig": {
--- a/packages/tonal/tonal.mjs
+++ b/packages/tonal/tonal.mjs
@ -100,6 +100,7 @@ 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
@ -154,6 +155,7 @@ 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
@ -244,6 +246,7 @@ 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
--- a/packages/tonal/voicings.mjs
+++ b/packages/tonal/voicings.mjs
@ -90,6 +90,7 @@ 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
@ -133,6 +134,7 @@ 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
@ -157,6 +159,7 @@ 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
@ -189,6 +192,7 @@ 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/packages/transpiler/package.json
+++ b/packages/transpiler/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/transpiler",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Transpiler for strudel user code. Converts syntactically correct but semantically meaningless JS into evaluatable strudel code.",
  "main": "index.mjs",
  "type": "module",
--- a/packages/transpiler/test/transpiler.test.mjs
+++ b/packages/transpiler/test/transpiler.test.mjs
@ -26,6 +26,20 @@ describe('transpiler', () => {
  it('adds await to bare samples call', () => {
    expect(transpiler("samples('xxx');", simple).output).toEqual("await samples('xxx');");
  });
+  it('handles mini strings in K(...)', () => {
+    expect(transpiler('K("bd sd")', simple).output).toEqual("worklet('pat[0]', m('bd sd', 2));");
+  });
+  it('treats K(...) as kabelsalat', () => {
+    expect(transpiler('K(1+2)', simple).output).toEqual("worklet('1 + 2');");
+  });
+  it('automatically calls functions in K(...)', () => {
+    expect(transpiler('K(() => { return 1 + 2 })', simple).output).toEqual(
+      "worklet('(() => {\\n    return 1 + 2\\n})()');",
+    );
+  });
+  it('handles strudel S(...) inside kabelsalat K(...)', () => {
+    expect(transpiler('K(S("bd".fast(4)))', simple).output).toEqual("worklet('pat[0]', m('bd', 4).fast(4));");
+  });
  /*   it('parses dynamic imports', () => {
    expect(
      transpiler("const { default: foo } = await import('https://bar.com/foo.js');", {
@ -42,4 +56,18 @@ describe('transpiler', () => {
      [12, 14],
    ]);
  });
+  it('allows disabling mini', () => {
+    const code = `/* mini-off */
+      const randPrefix = Math.random() > 0.5 ? "b" : "s";
+      const drumPat = \`\${randPrefix}d\`;
+      // mini-on
+      s(drumPat).lpf("5000 10000") // make sure mini still runs;
+    `;
+    const { output, miniLocations } = transpiler(code, { ...simple, emitMiniLocations: true });
+    expect(output).not.toContain("m('b'");
+    expect(output).not.toContain("m('s'");
+    const cutoffIdx = code.indexOf('5000 10000');
+    expect(miniLocations).toHaveLength(2);
+    expect(miniLocations[0][0]).toEqual(cutoffIdx);
+  });
 });
--- a/packages/transpiler/transpiler.mjs
+++ b/packages/transpiler/transpiler.mjs
@ -21,12 +21,15 @@ export function registerLanguage(type, config) {
 export function transpiler(input, options = {}) {
  const { wrapAsync = false, addReturn = true, emitMiniLocations = true, emitWidgets = true } = options;

+  const comments = [];
  let ast = parse(input, {
    ecmaVersion: 2022,
    allowAwaitOutsideFunction: true,
    locations: true,
+    onComment: comments,
  });

+  const miniDisableRanges = findMiniDisableRanges(comments, input.length);
  let miniLocations = [];
  const collectMiniLocations = (value, node) => {
    const minilang = languages.get('minilang');
@ -66,6 +69,9 @@ export function transpiler(input, options = {}) {
        return this.replace(tidalWithLocation(raw, offset));
      }
      if (isBackTickString(node, parent)) {
+        if (isMiniDisabled(node.start, miniDisableRanges)) {
+          return;
+        }
        const { quasis } = node;
        const { raw } = quasis[0].value;
        this.skip();
@ -73,6 +79,9 @@ export function transpiler(input, options = {}) {
        return this.replace(miniWithLocation(raw, node));
      }
      if (isStringWithDoubleQuotes(node)) {
+        if (isMiniDisabled(node.start, miniDisableRanges)) {
+          return;
+        }
        const { value } = node;
        this.skip();
        emitMiniLocations && collectMiniLocations(value, node);
@ -110,7 +119,64 @@ export function transpiler(input, options = {}) {
        return this.replace(labelToP(node));
      }
    },
-    leave(node, parent, prop, index) {},
+
+    leave(node, parent, prop, index) {
+      if (!isKabelCall(node)) return;
+
+      let [expr, ...rest] = node.arguments;
+      if (!expr) throw new Error('K(...) requires an expression');
+
+      if (shouldCallKabelExpression(expr)) {
+        expr = {
+          type: 'CallExpression',
+          callee: expr,
+          arguments: [],
+          optional: false,
+        };
+      }
+
+      const { template, patternExprs } = extractPatternPlaceholders(expr);
+      if (patternExprs.length) {
+        const workletArgs = [{ type: 'Literal', value: template }, ...patternExprs, ...rest];
+
+        let callee = node.callee;
+        if (callee.type === 'ChainExpression') callee = callee.expression;
+        if (callee.type === 'MemberExpression') {
+          return this.replace({
+            type: 'CallExpression',
+            callee: workletMemberAst(callee.object),
+            arguments: workletArgs,
+            optional: false,
+          });
+        }
+        return this.replace({
+          type: 'CallExpression',
+          callee: { type: 'Identifier', name: 'worklet' },
+          arguments: workletArgs,
+          optional: false,
+        });
+      }
+
+      const kabelSrc = genExprSource(expr);
+      const workletArgs = [{ type: 'Literal', value: kabelSrc }, ...rest];
+
+      let callee = node.callee;
+      if (callee.type === 'ChainExpression') callee = callee.expression;
+      if (callee.type === 'MemberExpression') {
+        return this.replace({
+          type: 'CallExpression',
+          callee: workletMemberAst(callee.object),
+          arguments: workletArgs,
+          optional: false,
+        });
+      }
+      return this.replace({
+        type: 'CallExpression',
+        callee: { type: 'Identifier', name: 'worklet' },
+        arguments: workletArgs,
+        optional: false,
+      });
+    },
  });

  let { body } = ast;
@ -146,6 +212,166 @@ export function transpiler(input, options = {}) {
  return { output, miniLocations, widgets };
 }

+function isKabelCall(node) {
+  if (node.type !== 'CallExpression') return false;
+  let callee = node.callee;
+  if (callee.type === 'ChainExpression') callee = callee.expression;
+  if (callee.type === 'MemberExpression') return !callee.computed && callee.property?.name === 'K';
+  return callee.type === 'Identifier' && callee.name === 'K';
+}
+
+function shouldCallKabelExpression(expr) {
+  if (expr.type !== 'ArrowFunctionExpression' && expr.type !== 'FunctionExpression') {
+    return false;
+  }
+  if (expr.params.length) {
+    return false;
+  }
+  return expr.body?.type === 'BlockStatement';
+}
+
+function genExprSource(expr) {
+  return escodegen.generate(expr, { format: { semicolons: false } });
+}
+
+function extractPatternPlaceholders(expr) {
+  const templateExpr = cloneNode(expr);
+  const parents = new Map();
+  const targets = [];
+
+  walk(templateExpr, {
+    enter(node, parent, prop, index) {
+      parents.set(node, { parent, prop, index });
+      const patternExpr = getStrudelPatternExpr(node);
+      if (patternExpr) {
+        targets.push({ node, patternExpr });
+        this.skip();
+      }
+    },
+  });
+
+  if (!targets.length) {
+    return { template: genExprSource(templateExpr), patternExprs: [] };
+  }
+
+  targets.sort((a, b) => getPatternNodeOrder(a.node) - getPatternNodeOrder(b.node));
+
+  const patternExprs = targets.map(({ patternExpr }) => cloneNode(patternExpr));
+
+  let currentExpr = templateExpr;
+  targets.forEach(({ node }, index) => {
+    currentExpr = replaceNode(node, placeholderAst(index), parents, currentExpr);
+  });
+
+  const template = genExprSource(currentExpr);
+  return { template, patternExprs };
+}
+
+function getStrudelPatternExpr(node) {
+  if (isStrudelPatternWrap(node)) {
+    const arg = node.arguments?.[0];
+    if (!arg) {
+      throw new Error('S(...) requires an argument');
+    }
+    return arg;
+  }
+  if (isMiniCall(node)) {
+    return node;
+  }
+  return null;
+}
+
+function isStrudelPatternWrap(node) {
+  if (node.type !== 'CallExpression') {
+    return false;
+  }
+  const callee = node.callee;
+  if (callee.type === 'Identifier') {
+    return callee.name === 'S';
+  }
+  if (callee.type === 'MemberExpression' && !callee.computed) {
+    return callee.property?.name === 'S';
+  }
+  return false;
+}
+
+function getMinilangName() {
+  const minilang = languages.get('minilang');
+  return minilang?.name || 'm';
+}
+
+// Used to identify transpiled `m(...)` calls for proper conversion
+// to, say, kabelsalat placeholders
+function isMiniCall(node) {
+  if (node.type !== 'CallExpression') {
+    return false;
+  }
+  const callee = node.callee;
+  if (callee.type !== 'Identifier') {
+    return false;
+  }
+  if (callee.name !== getMinilangName()) {
+    return false;
+  }
+  const firstArg = node.arguments?.[0];
+  return firstArg?.type === 'Literal' && typeof firstArg.value === 'string';
+}
+
+// If `start` is available, we use it. If it's already been transpiled
+// to `m(...)`, use the provided offset
+function getPatternNodeOrder(node) {
+  if (typeof node.start === 'number') {
+    return node.start;
+  }
+  if (isMiniCall(node)) {
+    const offsetArg = node.arguments?.[1];
+    if (offsetArg?.type === 'Literal' && typeof offsetArg.value === 'number') {
+      return offsetArg.value;
+    }
+  }
+  return 0;
+}
+
+function placeholderAst(index) {
+  return {
+    type: 'MemberExpression',
+    object: { type: 'Identifier', name: 'pat' },
+    property: { type: 'Literal', value: index },
+    computed: true,
+    optional: false,
+  };
+}
+
+function replaceNode(node, replacement, parents, currentRoot) {
+  const info = parents.get(node);
+  if (!info || !info.parent) {
+    return replacement;
+  }
+
+  const { parent, prop, index } = info;
+  if (Array.isArray(parent[prop])) {
+    parent[prop][index] = replacement;
+  } else {
+    parent[prop] = replacement;
+  }
+  parents.set(replacement, { parent, prop, index });
+  return currentRoot;
+}
+
+function cloneNode(node) {
+  return JSON.parse(JSON.stringify(node));
+}
+
+function workletMemberAst(objectExpr) {
+  return {
+    type: 'MemberExpression',
+    object: objectExpr,
+    property: { type: 'Identifier', name: 'worklet' },
+    computed: false,
+    optional: false,
+  };
+}
+
 function isStringWithDoubleQuotes(node, locations, code) {
  if (node.type !== 'Literal') {
    return false;
@ -327,3 +553,32 @@ function languageWithLocation(name, value, offset) {
    optional: false,
  };
 }
+
+function findMiniDisableRanges(comments, codeEnd) {
+  const ranges = [];
+  const stack = []; // used to track on/off pairs
+  for (const comment of comments) {
+    const value = comment.value.trim();
+    if (value.startsWith('mini-off')) {
+      stack.push(comment.start);
+    } else if (value.startsWith('mini-on')) {
+      const start = stack.pop();
+      ranges.push([start, comment.end]);
+    }
+  }
+  while (stack.length) {
+    // If no closing mini-on is found, just turn it off until `codeEnd`
+    const start = stack.pop();
+    ranges.push([start, codeEnd]);
+  }
+  return ranges;
+}
+
+function isMiniDisabled(offset, miniDisableRanges) {
+  for (const [start, end] of miniDisableRanges) {
+    if (offset >= start && offset < end) {
+      return true;
+    }
+  }
+  return false;
+}
--- a/packages/vite-plugin-bundle-audioworklet/package.json
+++ b/packages/vite-plugin-bundle-audioworklet/package.json
@ -1,7 +1,7 @@
 {
  "name": "vite-plugin-bundle-audioworklet",
  "main": "./vite-plugin-bundle-audioworklet.js",
-  "version": "0.1.1",
+  "version": "0.1.2",
  "description": "",
  "keywords": [
    "vite",
--- a/packages/web/package.json
+++ b/packages/web/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/web",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "Easy to setup, opiniated bundle of Strudel for the browser.",
  "module": "web.mjs",
  "publishConfig": {
--- a/packages/webaudio/package.json
+++ b/packages/webaudio/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/webaudio",
-  "version": "1.2.6",
+  "version": "1.3.0",
  "description": "Web Audio helpers for Strudel",
  "main": "index.mjs",
  "type": "module",
--- a/packages/webaudio/scope.mjs
+++ b/packages/webaudio/scope.mjs
@ -98,6 +98,7 @@ function clearScreen(smear = 0, smearRGB = `0,0,0`, ctx = getDrawContext()) {
 /**
 * Renders an oscilloscope for the frequency domain of the audio signal.
 * @name fscope
+ * @tags visualization
 * @param {string} color line color as hex or color name. defaults to white.
 * @param {number} scale scales the y-axis. Defaults to 0.25
 * @param {number} pos y-position relative to screen height. 0 = top, 1 = bottom of screen
@ -122,6 +123,7 @@ Pattern.prototype.fscope = function (config = {}) {
 * Renders an oscilloscope for the time domain of the audio signal.
 * @name scope
 * @synonyms tscope
+ * @tags visualization
 * @param {object} config optional config with options:
 * @param {boolean} align if 1, the scope will be aligned to the first zero crossing. defaults to 1
 * @param {string} color line color as hex or color name. defaults to white.
--- a/packages/webaudio/spectrum.mjs
+++ b/packages/webaudio/spectrum.mjs
@ -5,6 +5,7 @@ import { analysers, getAnalyzerData } from 'superdough';
 /**
 * Renders a spectrum analyzer for the incoming audio signal.
 * @name spectrum
+ * @tags visualization
 * @param {object} config optional config with options:
 * @param {integer} thickness line thickness in px (default 3)
 * @param {integer} speed scroll speed (default 1)
--- a/packages/webaudio/webaudio.mjs
+++ b/packages/webaudio/webaudio.mjs
@ -103,8 +103,10 @@ export async function renderPatternAudio(
 }

 export function webaudioRepl(options = {}) {
+  const audioContext = options.audioContext ?? getAudioContext();
+  setAudioContext(audioContext);
  options = {
-    getTime: () => getAudioContext().currentTime,
+    getTime: () => audioContext.currentTime,
    defaultOutput: webaudioOutput,
    ...options,
  };
--- a/packages/xen/package.json
+++ b/packages/xen/package.json
@ -1,6 +1,6 @@
 {
  "name": "@strudel/xen",
-  "version": "1.2.5",
+  "version": "1.2.6",
  "description": "Xenharmonic API for strudel",
  "main": "index.mjs",
  "type": "module",