From 88d7868e12d9f60bfeba2462a8d981bd67bf2aa7 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 20:25:20 -0500
Subject: [PATCH 01/31] document some math funcs

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

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index c5b7953c9..0776aa5a1 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1156,12 +1156,61 @@ const COMPOSERS = {
    * @tags math
    */
   div: [numeralArgs((a, b) => a / b)],
+  /**
+   *
+   * Divides each number by the given factor.
+   * @name div
+   * @memberof Pattern
+   * @tags math
+   */
   mod: [numeralArgs(_mod)],
+  /**
+   *
+   * Raises each number to the power of the given factor
+   * @name pow
+   * @memberof Pattern
+   * @tags math
+   */
   pow: [numeralArgs(Math.pow)],
+  /**
+   *
+   * Preforms a bitwise `and` on each number and the given factor
+   * @name band
+   * @memberof Pattern
+   * @tags math
+   */
   band: [numeralArgs((a, b) => a & b)],
+  /**
+   *
+   * Preforms a bitwise `or` on each number and the given factor
+   * @name bor
+   * @memberof Pattern
+   * @tags math
+   */
   bor: [numeralArgs((a, b) => a | b)],
+  /**
+   *
+   * Preforms a bitwise `xor` on each number and the given factor
+   * @name bxor
+   * @memberof Pattern
+   * @tags math
+   */
   bxor: [numeralArgs((a, b) => a ^ b)],
+  /**
+   *
+   * Preforms a bitwise `left shift` on each number by the given factor
+   * @name blshift
+   * @memberof Pattern
+   * @tags math
+   */
   blshift: [numeralArgs((a, b) => a << b)],
+  /**
+   *
+   * Preforms a bitwise `right shift` on each number by the given factor
+   * @name brshift
+   * @memberof Pattern
+   * @tags math
+   */
   brshift: [numeralArgs((a, b) => a >> b)],
 
   // TODO - force numerical comparison if both look like numbers?

From 4f7a0f76d3b60f8bed1bca726608824e9be428e0 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 20:49:37 -0500
Subject: [PATCH 02/31] make getFreq and getFrequency synonyms and add doc

---
 packages/core/util.mjs |  41 ++-
 undocumented.json      | 732 ++++++++++++++++++++---------------------
 2 files changed, 390 insertions(+), 383 deletions(-)

diff --git a/packages/core/util.mjs b/packages/core/util.mjs
index c38c8e05f..15adedebc 100644
--- a/packages/core/util.mjs
+++ b/packages/core/util.mjs
@@ -70,17 +70,6 @@ export const getEventOffsetMs = (targetTimeSeconds, currentTimeSeconds) => {
   return (targetTimeSeconds - currentTimeSeconds) * 1000;
 };
 
-/**
- * @deprecated does not appear to be referenced or invoked anywhere in the codebase
- * @noAutocomplete
- */
-export const getFreq = (noteOrMidi) => {
-  if (typeof noteOrMidi === 'number') {
-    return midiToFreq(noteOrMidi);
-  }
-  return midiToFreq(noteToMidi(noteOrMidi));
-};
-
 const pcs = ['C', 'Db', 'D', 'Eb', 'E', 'F', 'Gb', 'G', 'Ab', 'A', 'Bb', 'B'];
 /**
  * @deprecated only used in workshop (first-notes)
@@ -130,25 +119,47 @@ export const getPlayableNoteValue = (hap) => {
   return note;
 };
 
+/**
+ * Given a hap, returns the frequency of the note or freq, if defined
+ * Given a note, returns the frequency of that note
+ * `getFreq('c3')`
+ * Given a midi note number, returns the frequency of that midi note
+ * `getFreq('c3')`
+ *
+ * @name getFrequency
+ * @synonyms getFreq
+ * @param {Hap | note | number}
+ * @returns {Number}
+ */
 export const getFrequency = (hap) => {
-  let { value, context } = hap;
+  let { value, context } =
+    typeof hap == 'object'
+      ? hap
+      : // default: interpret value as midi note.
+        { value: hap, context: { type: 'note' } };
   // if value is number => interpret as midi number as long as its not marked as frequency
   if (typeof value === 'object') {
     if (value.freq) {
       return value.freq;
     }
-    return getFreq(value.note || value.n || value.value);
+    let v = value.note || value.n || value.value;
+    if (typeof v === 'number') {
+      return midiToFreq(v);
+    }
+    return midiToFreq(noteToMidi(v));
   }
   if (typeof value === 'number' && context.type !== 'frequency') {
-    value = midiToFreq(hap.value);
+    value = midiToFreq(value);
   } else if (typeof value === 'string' && isNote(value)) {
-    value = midiToFreq(noteToMidi(hap.value));
+    value = midiToFreq(noteToMidi(value));
   } else if (typeof value !== 'number') {
     throw new Error('not a note or frequency: ' + value);
   }
   return value;
 };
 
+export const getFreq = (hap) => getFrequency(hap);
+
 // rotate array by n steps (to the left)
 export const rotate = (arr, n) => arr.slice(n).concat(arr.slice(0, n));
 
diff --git a/undocumented.json b/undocumented.json
index 3f5a3be30..f59eb2039 100644
--- a/undocumented.json
+++ b/undocumented.json
@@ -8,12 +8,19 @@
   ],
   "/packages/codemirror/autocomplete.mjs": [
     "Autocomplete",
+    "bankCompletions",
+    "getSynonymDoc",
     "strudelAutocomplete",
     "isAutoCompletionEnabled"
   ],
-  "/packages/codemirror/tooltip.mjs": [
-    "strudelTooltip",
-    "isTooltipEnabled"
+  "/packages/codemirror/basicSetup.mjs": [
+    "basicSetup",
+    "minimalSetup"
+  ],
+  "/packages/codemirror/block_utilities.mjs": [
+    "getBlockRegions",
+    "getBlockAt",
+    "evalBlock"
   ],
   "/packages/codemirror/flash.mjs": [
     "setFlash",
@@ -24,15 +31,29 @@
   "/packages/codemirror/highlight.mjs": [
     "setMiniLocations",
     "showMiniLocations",
+    "displayMiniLocations",
     "updateMiniLocations",
     "highlightMiniLocations",
+    "getMiniLocations",
+    "getActiveMiniLocations",
     "highlightExtension",
     "isPatternHighlightingEnabled"
   ],
   "/packages/codemirror/keybindings.mjs": [
     "keybindings"
   ],
-  "/packages/codemirror/themes/strudel-theme.mjs": [],
+  "/packages/codemirror/labelJump.mjs": [
+    "jumpToCharacter"
+  ],
+  "/packages/codemirror/slider.mjs": [
+    "acorn parse error: SyntaxError: undefined"
+  ],
+  "/packages/codemirror/themes/theme-helper.mjs": [
+    "createTheme"
+  ],
+  "/packages/codemirror/themes/strudel-theme.mjs": [
+    "settings"
+  ],
   "/packages/codemirror/themes/bluescreen.mjs": [
     "settings"
   ],
@@ -48,7 +69,103 @@
   "/packages/codemirror/themes/algoboy.mjs": [
     "settings"
   ],
-  "/packages/codemirror/themes/terminal.mjs": [
+  "/packages/codemirror/themes/CutiePi.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/sonic-pink.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/red-text.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/green-text.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/archBtw.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/fruitDaw.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/bluescreenlight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/androidstudio.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/atomone.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/aura.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/darcula.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/dracula.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/duotoneDark.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/eclipse.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/githubDark.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/githubLight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/gruvboxDark.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/gruvboxLight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/materialDark.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/materialLight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/nord.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/monokai.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/solarizedDark.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/solarizedLight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/sublime.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/tokyoNight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/tokioNightStorm.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/tokyoNightDay.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/vscodeDark.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/vscodeLight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/xcodeLight.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/bbedit.mjs": [
+    "settings"
+  ],
+  "/packages/codemirror/themes/noctisLilac.mjs": [
     "settings"
   ],
   "/packages/codemirror/themes.mjs": [
@@ -60,50 +177,34 @@
     "initTheme",
     "activateTheme"
   ],
-  "/packages/codemirror/slider.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+  "/packages/codemirror/tooltip.mjs": [
+    "strudelTooltip",
+    "isTooltipEnabled"
   ],
   "/packages/codemirror/widget.mjs": [
-    "addWidget",
-    "updateWidgets",
-    "setWidget",
-    "BlockWidget",
-    "widgetPlugin",
-    "registerWidget"
+    "acorn parse error: SyntaxError: undefined"
   ],
   "/packages/codemirror/codemirror.mjs": [
-    "defaultSettings",
-    "codemirrorSettings",
-    "initEditor",
-    "StrudelMirror"
+    "acorn parse error: SyntaxError: undefined"
   ],
   "/packages/codemirror/index.mjs": [],
-  "/packages/core/fraction.mjs": [
-    "gcd",
-    "lcm"
-  ],
-  "/packages/core/timespan.mjs": [
-    "TimeSpan"
-  ],
-  "/packages/core/hap.mjs": [
-    "Hap"
-  ],
-  "/packages/core/state.mjs": [
-    "State"
-  ],
   "/packages/core/logger.mjs": [
     "logKey",
+    "errorLogger",
     "logger"
   ],
   "/packages/core/util.mjs": [
     "isNoteWithOctave",
     "isNote",
     "tokenizeNote",
+    "getAccidentalsOffset",
     "noteToMidi",
     "midiToFreq",
     "freqToMidi",
     "valueToMidi",
+    "getEventOffsetMs",
     "_mod",
+    "averageArray",
     "nanFallback",
     "getSoundIndex",
     "getPlayableNoteValue",
@@ -122,13 +223,37 @@
     "fractionalArgs",
     "splitAt",
     "zipWith",
+    "pairs",
     "clamp",
     "sol2note",
+    "uniq",
+    "uniqsort",
+    "uniqsortr",
     "unicodeToBase64",
     "base64ToUnicode",
     "code2hash",
     "hash2code",
-    "objectMap"
+    "objectMap",
+    "cycleToSeconds",
+    "ClockCollator",
+    "getPerformanceTimeSeconds",
+    "keyAlias",
+    "getCurrentKeyboardState",
+    "stringifyValues"
+  ],
+  "/packages/core/fraction.mjs": [
+    "gcd",
+    "lcm",
+    "isFraction"
+  ],
+  "/packages/core/timespan.mjs": [
+    "TimeSpan"
+  ],
+  "/packages/core/hap.mjs": [
+    "Hap"
+  ],
+  "/packages/core/state.mjs": [
+    "State"
   ],
   "/packages/core/value.mjs": [
     "unionWithObj",
@@ -137,292 +262,77 @@
     "map"
   ],
   "/packages/core/drawLine.mjs": [],
-  "/packages/core/pattern.mjs": [
-    "setStringParser",
-    "polyrhythm",
-    "pr",
-    "pm",
-    "nothing",
-    "isPattern",
-    "reify",
-    "stackLeft",
-    "stackRight",
-    "stackCentre",
-    "stackBy",
-    "fastcat",
-    "_polymeterListSteps",
-    "set",
-    "keep",
-    "keepif",
-    "mod",
-    "pow",
-    "band",
-    "bor",
-    "bxor",
-    "blshift",
-    "brshift",
-    "lt",
-    "gt",
-    "lte",
-    "gte",
-    "eq",
-    "eqt",
-    "ne",
-    "net",
-    "and",
-    "or",
-    "func",
-    "compressSpan",
-    "compressspan",
-    "fastgap",
-    "focusSpan",
-    "focusspan",
-    "density",
-    "sparsity",
-    "zoomArc",
-    "zoomarc",
-    "inv",
-    "juxby",
-    "echowith",
-    "stutWith",
-    "stutwith",
-    "iterback",
-    "slowchunk",
-    "slowChunk",
-    "chunkback",
-    "fastchunk",
-    "bypass",
-    "hsla",
-    "hsl",
-    "loopat",
-    "loopatcps"
-  ],
-  "/packages/core/controls.mjs": [
-    "createParam",
-    "sound",
-    "src",
-    "att",
-    "fmi",
-    "fmrelease",
-    "fmvelocity",
-    "analyze",
-    "fft",
-    "dec",
-    "sus",
-    "rel",
-    "hold",
-    "bandf",
-    "bp",
-    "bandq",
-    "loopb",
-    "loope",
-    "ch",
-    "phaserrate",
-    "phasr",
-    "ph",
-    "phs",
-    "phc",
-    "phd",
-    "phasdp",
-    "cutoff",
-    "ctf",
-    "lp",
-    "lpe",
-    "hpe",
-    "bpe",
-    "lpa",
-    "hpa",
-    "bpa",
-    "lpd",
-    "hpd",
-    "bpd",
-    "lps",
-    "hps",
-    "bps",
-    "lpr",
-    "hpr",
-    "bpr",
-    "fanchor",
-    "vibrato",
-    "v",
-    "vmod",
-    "hcutoff",
-    "hp",
-    "hresonance",
-    "resonance",
-    "delayfb",
-    "dfb",
-    "delayt",
-    "dt",
-    "lock",
-    "det",
-    "fadeTime",
-    "fadeOutTime",
-    "fadeInTime",
-    "patt",
-    "pdec",
-    "psustain",
-    "psus",
-    "prel",
-    "gate",
-    "gat",
-    "activeLabel",
-    "degree",
-    "mtranspose",
-    "ctranspose",
-    "harmonic",
-    "stepsPerOctave",
-    "octaveR",
-    "nudge",
-    "overgain",
-    "overshape",
-    "panspan",
-    "pansplay",
-    "panwidth",
-    "panorient",
-    "rate",
-    "slide",
-    "semitone",
-    "voice",
-    "chord",
-    "dictionary",
-    "dict",
-    "anchor",
-    "offset",
-    "octaves",
-    "mode",
-    "rlp",
-    "rdim",
-    "rfade",
-    "ir",
-    "size",
-    "sz",
-    "rsize",
-    "dist",
-    "compressorKnee",
-    "compressorRatio",
-    "compressorAttack",
-    "compressorRelease",
-    "waveloss",
-    "density",
-    "expression",
-    "sustainpedal",
-    "tremolodepth",
-    "tremdp",
-    "tremolorate",
-    "tremr",
-    "fshift",
-    "fshiftnote",
-    "fshiftphase",
-    "triode",
-    "krush",
-    "kcutoff",
-    "octer",
-    "octersub",
-    "octersubsub",
-    "ring",
-    "ringf",
-    "ringdf",
-    "freeze",
-    "xsdelay",
-    "tsdelay",
-    "real",
-    "imag",
-    "enhance",
-    "partials",
-    "comb",
-    "smear",
-    "scram",
-    "binshift",
-    "hbrick",
-    "lbrick",
-    "midichan",
-    "control",
-    "ccn",
-    "ccv",
-    "polyTouch",
-    "midibend",
-    "miditouch",
-    "ctlNum",
-    "frameRate",
-    "frames",
-    "hours",
-    "midicmd",
-    "minutes",
-    "progNum",
-    "seconds",
-    "songPtr",
-    "uid",
-    "val",
-    "cps",
-    "legato",
-    "dur",
-    "zrand",
-    "curve",
-    "deltaSlide",
-    "pitchJump",
-    "pitchJumpTime",
-    "lfo",
-    "repeatTime",
-    "znoise",
-    "zmod",
-    "zcrush",
-    "zdelay",
-    "tremolo",
-    "zzfx",
-    "colour",
-    "createParams",
-    "ad",
-    "ds",
-    "ar"
-  ],
-  "/packages/core/euclid.mjs": [
-    "bjork",
-    "euclidrot"
-  ],
-  "/packages/core/zyklus.mjs": [],
-  "/packages/core/signal.mjs": [
-    "steady",
-    "signal",
-    "isaw",
-    "isaw2",
-    "saw2",
-    "sine2",
-    "cosine2",
-    "square2",
-    "tri2",
-    "time",
-    "_brandBy",
-    "_irand",
-    "pickSqueeze",
-    "pickmodSqueeze",
-    "__chooseWith",
-    "randcat",
-    "wrandcat",
-    "perlinWith",
-    "degradeByWith"
-  ],
-  "/packages/core/speak.mjs": [
-    "speak"
-  ],
   "/packages/core/evaluate.mjs": [
+    "strudelScope",
+    "userDefinedKeys",
     "evalScope",
     "evaluate"
   ],
+  "/packages/core/pattern.mjs": [
+    "acorn parse error: SyntaxError: undefined"
+  ],
+  "/packages/core/controls.mjs": [
+    "acorn parse error: SyntaxError: undefined"
+  ],
+  "/packages/core/euclid.mjs": [
+    "bjorklund",
+    "bjork",
+    "euclidrot",
+    "eish"
+  ],
+  "/packages/core/zyklus.mjs": [],
+  "/packages/core/cyclist.mjs": [
+    "Cyclist"
+  ],
+  "/packages/core/impure.mjs": [
+    "reset_state",
+    "reset_timelines",
+    "timeline"
+  ],
+  "/packages/core/pick.mjs": [
+    "pickSqueeze",
+    "pickmodSqueeze"
+  ],
   "/packages/core/neocyclist.mjs": [
     "NeoCyclist"
   ],
-  "/packages/core/cyclist.mjs": [
-    "Cyclist"
-  ],
-  "/packages/core/time.mjs": [
+  "/packages/core/schedulerState.mjs": [
     "getTime",
-    "setTime"
+    "setTime",
+    "setCpsFunc",
+    "getCps",
+    "setPattern",
+    "getPattern",
+    "setTriggerFunc",
+    "getTriggerFunc",
+    "setIsStarted",
+    "getIsStarted"
   ],
   "/packages/core/repl.mjs": [
     "repl",
     "getTrigger"
   ],
+  "/packages/core/signal.mjs": [
+    "steady",
+    "signal",
+    "mouseY",
+    "mouseX",
+    "getRandsAtTime",
+    "randrun",
+    "_brandBy",
+    "_irand",
+    "__chooseWith",
+    "chooseIn",
+    "chooseOut",
+    "randcat",
+    "wrandcat",
+    "degradeByWith",
+    "_keyDown",
+    "perCycle"
+  ],
+  "/packages/core/speak.mjs": [
+    "speak"
+  ],
   "/packages/core/ui.mjs": [
     "backgroundImage",
     "cleanupUi"
@@ -440,13 +350,19 @@
     "isTauri"
   ],
   "/packages/desktopbridge/midibridge.mjs": [],
-  "/packages/desktopbridge/oscbridge.mjs": [],
+  "/packages/desktopbridge/oscbridge.mjs": [
+    "oscTriggerTauri"
+  ],
   "/packages/desktopbridge/index.mjs": [],
   "/packages/draw/draw.mjs": [
     "getDrawContext",
     "cleanupDraw",
+    "cleanupDrawContext",
     "Framer",
-    "Drawer"
+    "Drawer",
+    "getComputedPropertyValue",
+    "getTheme",
+    "setTheme"
   ],
   "/packages/draw/animate.mjs": [
     "x",
@@ -467,16 +383,98 @@
     "convertHexToNumber"
   ],
   "/packages/draw/pianoroll.mjs": [
+    "__pianoroll",
     "getDrawOptions",
     "getPunchcardPainter",
     "drawPianoroll"
   ],
   "/packages/draw/spiral.mjs": [],
+  "/packages/draw/pitchwheel.mjs": [],
   "/packages/draw/index.mjs": [],
+  "/packages/edo/edoscale.mjs": [
+    "EdoScale"
+  ],
+  "/packages/edo/ratios.mjs": [],
+  "/packages/edo/intervals.mjs": [
+    "Intervals"
+  ],
+  "/packages/edo/pitches.mjs": [
+    "Pitches"
+  ],
+  "/packages/edo/edo.mjs": [],
+  "/packages/edo/index.mjs": [
+    "packageName"
+  ],
+  "/packages/superdough/audioContext.mjs": [
+    "setDefaultAudioContext",
+    "setAudioContext",
+    "getAudioContext",
+    "getAudioContextCurrentTime"
+  ],
+  "/packages/superdough/logger.mjs": [
+    "errorLogger",
+    "logger",
+    "setLogger"
+  ],
+  "/packages/superdough/noise.mjs": [
+    "getNoiseBuffer",
+    "getNoiseOscillator",
+    "getNoiseMix"
+  ],
+  "/packages/superdough/nodePools.mjs": [
+    "isPoolable",
+    "releaseNodeToPool",
+    "getNodeFromPool"
+  ],
+  "/packages/superdough/util.mjs": [
+    "tokenizeNote",
+    "getAccidentalsOffset",
+    "noteToMidi",
+    "midiToFreq",
+    "clamp",
+    "freqToMidi",
+    "valueToMidi",
+    "nanFallback",
+    "_mod",
+    "getSoundIndex",
+    "cycleToSeconds",
+    "secondsToCycle",
+    "getCommonSampleInfo",
+    "getBaseURL"
+  ],
+  "/packages/superdough/helpers.mjs": [
+    "noises",
+    "gainNode",
+    "effectSend",
+    "getWorklet",
+    "getParamADSR",
+    "getEnvelope",
+    "getLfo",
+    "getCompressor",
+    "getADSRValues",
+    "getParamLfo",
+    "applyParameterModulators",
+    "createFilter",
+    "drywet",
+    "getPitchEnvelope",
+    "getVibratoOscillator",
+    "scheduleAtTime",
+    "webAudioTimeout",
+    "applyFM",
+    "distortionAlgorithms",
+    "getDistortionAlgorithm",
+    "getDistortion",
+    "getFrequencyFromValue",
+    "onceEnded",
+    "releaseAudioNode",
+    "cleanupOnEnd"
+  ],
+  "/packages/midi/util.mjs": [],
+  "/packages/midi/input.mjs": [
+    "acorn parse error: SyntaxError: undefined"
+  ],
   "/packages/midi/midi.mjs": [
-    "WebMidi",
-    "enableWebMidi",
-    "midin"
+    "acorn parse error: SyntaxError: undefined"
   ],
   "/packages/midi/index.mjs": [],
   "/packages/mini/krill-parser.js": [],
@@ -502,6 +500,7 @@
   "/packages/repl/index.mjs": [],
   "/packages/soundfonts/gm.mjs": [],
   "/packages/soundfonts/fontloader.mjs": [
+    "setSoundfontUrl",
     "getFontBufferSource",
     "getFontPitch",
     "registerSoundfonts"
@@ -521,67 +520,40 @@
   "/packages/superdough/vowel.mjs": [
     "vowelFormant"
   ],
-  "/packages/superdough/logger.mjs": [
-    "logger",
-    "setLogger"
+  "/packages/superdough/superdoughdata.mjs": [
+    "getSuperdoughControlTargets"
   ],
-  "/packages/superdough/util.mjs": [
-    "tokenizeNote",
-    "noteToMidi",
-    "midiToFreq",
-    "clamp",
-    "freqToMidi",
-    "valueToMidi",
-    "nanFallback",
-    "_mod",
-    "getSoundIndex"
-  ],
-  "/packages/superdough/helpers.mjs": [
-    "gainNode",
-    "getParamADSR",
-    "getCompressor",
-    "getADSRValues",
-    "createFilter",
-    "drywet",
-    "getPitchEnvelope",
-    "getVibratoOscillator",
-    "webAudioTimeout",
-    "applyFM"
+  "/packages/superdough/modulators.mjs": [
+    "connectLFO",
+    "connectEnvelope",
+    "connectBusModulator"
   ],
   "/packages/superdough/sampler.mjs": [
     "getCachedBuffer",
+    "getDuration",
+    "getSampleInfo",
+    "getSampleBuffer",
     "getSampleBufferSource",
     "loadBuffer",
     "reverseBuffer",
     "getLoadedBuffer",
     "processSampleMap",
     "registerSamplesPrefix",
-    "onTriggerSample"
+    "fetchSampleMap",
+    "onTriggerSample",
+    "registerSampleSource"
+  ],
+  "/packages/superdough/superdoughoutput.mjs": [
+    "acorn parse error: SyntaxError: undefined"
+  ],
+  "/packages/superdough/wavetable.mjs": [
+    "Warpmode",
+    "resetSeenKeys",
+    "registerWaveTable",
+    "onTriggerSynth"
   ],
   "/packages/superdough/superdough.mjs": [
-    "soundMap",
-    "registerSound",
-    "getSound",
-    "resetLoadedSounds",
-    "setDefaultAudioContext",
-    "getAudioContext",
-    "getWorklet",
-    "initAudio",
-    "initAudioOnFirstClick",
-    "initializeAudioOutput",
-    "connectToDestination",
-    "panic",
-    "analysers",
-    "analysersData",
-    "getAnalyserById",
-    "getAnalyzerData",
-    "resetGlobalEffects",
-    "superdough",
-    "superdoughTrigger"
-  ],
-  "/packages/superdough/noise.mjs": [
-    "getNoiseOscillator",
-    "getNoiseMix"
+    "acorn parse error: SyntaxError: undefined"
   ],
   "/packages/superdough/synth.mjs": [
     "registerSynthSounds",
@@ -622,7 +594,11 @@
     "Step",
     "Note"
   ],
-  "/packages/tonal/tonal.mjs": [],
+  "/packages/tonal/tonal.mjs": [
+    "trans",
+    "scaleTrans",
+    "strans"
+  ],
   "/packages/tonal/ireal.mjs": [
     "simple",
     "complex"
@@ -639,31 +615,51 @@
     "packageName"
   ],
   "/packages/transpiler/transpiler.mjs": [
-    "registerWidgetType",
-    "transpiler",
-    "getWidgetID"
+    "registerLanguage",
+    "getLanguages",
+    "registerTranspilerPlugin",
+    "getPlugins",
+    "transpiler"
+  ],
+  "/packages/transpiler/plugin-kabelsalat.mjs": [
+    "genExprSource",
+    "extractPatternPlaceholders"
+  ],
+  "/packages/transpiler/plugin-mini.mjs": [
+    "acorn parse error: SyntaxError: undefined"
+  ],
+  "/packages/transpiler/plugin-sample.mjs": [
+    "withAwait"
+  ],
+  "/packages/transpiler/plugin-widgets.mjs": [
+    "acorn parse error: SyntaxError: undefined"
   ],
   "/packages/transpiler/index.mjs": [
     "evaluate"
   ],
+  "/packages/webaudio/supradough.mjs": [
+    "fetchSampleMap",
+    "doughsamples"
+  ],
   "/packages/webaudio/webaudio.mjs": [
     "webaudioOutput",
+    "renderPatternAudio",
     "webaudioRepl"
   ],
   "/packages/webaudio/scope.mjs": [
     "drawTimeScope",
     "drawFrequencyScope"
   ],
+  "/packages/webaudio/spectrum.mjs": [],
   "/packages/webaudio/index.mjs": [],
+  "/packages/xen/tunejs.js": [],
   "/packages/xen/xen.mjs": [
     "edo",
-    "xen",
-    "tuning"
-  ],
-  "/packages/xen/tunejs.js": [],
-  "/packages/xen/tune.mjs": [
-    "tune"
+    "ftrans",
+    "fTrans",
+    "fTranspose"
   ],
+  "/packages/xen/tune.mjs": [],
   "/packages/xen/index.mjs": [],
   "/index.mjs": []
 }

From c2572f4faddc1afb3bcf4eb4bda7524a4a57088b Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 21:00:26 -0500
Subject: [PATCH 03/31] deprecate chooseIn

---
 packages/core/signal.mjs       | 9 +++++++--
 packages/mondough/mondough.mjs | 1 -
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 4398e2ab7..42e841f6e 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -569,9 +569,14 @@ export const chooseInWith = (pat, xs) => {
  */
 export const choose = (...xs) => chooseWith(rand, xs);
 
-// todo: doc
+/**
+ * Has no difference with `choose`
+ * 
+ * @name chooseIn
+ * @deprecated
+ * @returns {Pattern}
+ */
 export const chooseIn = (...xs) => chooseInWith(rand, xs);
-export const chooseOut = choose;
 
 /**
  * Chooses from the given list of values (or patterns of values), according
diff --git a/packages/mondough/mondough.mjs b/packages/mondough/mondough.mjs
index a230c3cb9..a043adb83 100644
--- a/packages/mondough/mondough.mjs
+++ b/packages/mondough/mondough.mjs
@@ -46,7 +46,6 @@ lib[':'] = tail;
 lib['..'] = range;
 lib['def'] = () => silence;
 lib['or'] = (...children) => chooseIn(...children); // always has structure but is cyclewise.. e.g. "s oh*8.dec[.04 | .5]"
-//lib['or'] = (...children) => chooseOut(...children); // "s oh*8.dec[.04 | .5]" is better but "dec[.04 | .5].s oh*8" has no struct
 
 function evaluator(node, scope) {
   const { type } = node;

From 10b0e300578ab5efca62880e50a215bcb603a55b Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 22:13:46 -0500
Subject: [PATCH 04/31] a bunch more docs

---
 packages/core/pattern.mjs                 |   4 +-
 packages/core/schedulerState.mjs          |  11 +
 packages/core/signal.mjs                  |  22 +-
 packages/core/util.mjs                    |   1 +
 test/__snapshots__/examples.test.mjs.snap | 330 ++++++++++++++++++++++
 5 files changed, 365 insertions(+), 3 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 0776aa5a1..ed5ff9cd4 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1074,7 +1074,7 @@ const COMPOSERS = {
    * @param {Pattern} pat
    * @returns {Pattern}
    * @memberof Pattern
-   * @tags internal, combiners
+   * @tags internals, combiners
    * @example
    * // because input pattern has `s` set,
    * // it overrides the "sine" declared earlier
@@ -1099,7 +1099,7 @@ const COMPOSERS = {
    * @param {Pattern} pat
    * @memberof Pattern
    * @returns {Pattern}
-   * @tags internal, combiners
+   * @tags internals, combiners
    * @example
    * // notes, already defined, will stay "c a f e",
    * // while "s", not defined, will be set to "piano"
diff --git a/packages/core/schedulerState.mjs b/packages/core/schedulerState.mjs
index 14b4c9054..7c39fb373 100644
--- a/packages/core/schedulerState.mjs
+++ b/packages/core/schedulerState.mjs
@@ -9,6 +9,12 @@ let cpsFunc;
 let pattern;
 let triggerFunc;
 let isStarted;
+
+/**
+ * @name getTime
+ * @tags internals
+ * @returns {Number} the current cycle time as a number
+ */
 export function getTime() {
   if (!time) {
     throw new Error('no time set! use setTime to define a time source');
@@ -24,6 +30,11 @@ export function setCpsFunc(func) {
   cpsFunc = func;
 }
 
+/**
+ * @name getCps
+ * @tags internals
+ * @returns {Number} the current cycles per second
+ */
 export function getCps() {
   return cpsFunc?.();
 }
diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 42e841f6e..7e0dfbbc3 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -15,6 +15,24 @@ export function steady(value) {
   return new Pattern((state) => [new Hap(undefined, state.span, value)]);
 }
 
+/**
+ * Creates a signal given by the input function
+ *
+ * @name signal
+ * @param {*} func
+ * @returns {Pattern} signal
+ * @tags generators
+ * @example
+ * // sawtooth signal definition
+ * signal(t=>t%1).segment(16).range(30,40).note()
+ * @example
+ * signal(t=>Math.pow(t,2)%1).range(40, 60).add(5).segment(16)
+ * .off(0, x=>x.add(7))
+ * .note()
+ * .s("gm_electric_guitar_jazz,gm_epiano")
+ *   .gain(1.7)
+ * .pianoroll()
+ */
 export const signal = (func) => {
   const query = (state) => [new Hap(undefined, state.span, func(state.span.begin, state.controls))];
   return new Pattern(query);
@@ -172,6 +190,7 @@ export const time = signal(id);
 /**
  *  The mouse's x position value ranges from 0 to 1.
  * @name mousex
+ * @synonyms mouseX
  * @return {Pattern}
  * @tags external_io
  * @example
@@ -182,6 +201,7 @@ export const time = signal(id);
 /**
  *  The mouse's y position value ranges from 0 to 1.
  * @name mousey
+ * @synonyms mouseY
  * @return {Pattern}
  * @tags external_io
  * @example
@@ -571,7 +591,7 @@ export const choose = (...xs) => chooseWith(rand, xs);
 
 /**
  * Has no difference with `choose`
- * 
+ *
  * @name chooseIn
  * @deprecated
  * @returns {Pattern}
diff --git a/packages/core/util.mjs b/packages/core/util.mjs
index 15adedebc..2f499adae 100644
--- a/packages/core/util.mjs
+++ b/packages/core/util.mjs
@@ -127,6 +127,7 @@ export const getPlayableNoteValue = (hap) => {
  * `getFreq('c3')`
  *
  * @name getFrequency
+ * @tags pitch
  * @synonyms getFreq
  * @param {Hap | note | number}
  * @returns {Number}
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 458904baf..2aaa80a51 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -11639,6 +11639,336 @@ exports[`runs examples > example "shuffle" example index 1 1`] = `
 ]
 `;
 
+exports[`runs examples > example "signal" example index 0 1`] = `
+[
+  "[ 0/1 → 1/16 | note:30 ]",
+  "[ 1/16 → 1/8 | note:30.625 ]",
+  "[ 1/8 → 3/16 | note:31.25 ]",
+  "[ 3/16 → 1/4 | note:31.875 ]",
+  "[ 1/4 → 5/16 | note:32.5 ]",
+  "[ 5/16 → 3/8 | note:33.125 ]",
+  "[ 3/8 → 7/16 | note:33.75 ]",
+  "[ 7/16 → 1/2 | note:34.375 ]",
+  "[ 1/2 → 9/16 | note:35 ]",
+  "[ 9/16 → 5/8 | note:35.625 ]",
+  "[ 5/8 → 11/16 | note:36.25 ]",
+  "[ 11/16 → 3/4 | note:36.875 ]",
+  "[ 3/4 → 13/16 | note:37.5 ]",
+  "[ 13/16 → 7/8 | note:38.125 ]",
+  "[ 7/8 → 15/16 | note:38.75 ]",
+  "[ 15/16 → 1/1 | note:39.375 ]",
+  "[ 1/1 → 17/16 | note:30 ]",
+  "[ 17/16 → 9/8 | note:30.625 ]",
+  "[ 9/8 → 19/16 | note:31.25 ]",
+  "[ 19/16 → 5/4 | note:31.875 ]",
+  "[ 5/4 → 21/16 | note:32.5 ]",
+  "[ 21/16 → 11/8 | note:33.125 ]",
+  "[ 11/8 → 23/16 | note:33.75 ]",
+  "[ 23/16 → 3/2 | note:34.375 ]",
+  "[ 3/2 → 25/16 | note:35 ]",
+  "[ 25/16 → 13/8 | note:35.625 ]",
+  "[ 13/8 → 27/16 | note:36.25 ]",
+  "[ 27/16 → 7/4 | note:36.875 ]",
+  "[ 7/4 → 29/16 | note:37.5 ]",
+  "[ 29/16 → 15/8 | note:38.125 ]",
+  "[ 15/8 → 31/16 | note:38.75 ]",
+  "[ 31/16 → 2/1 | note:39.375 ]",
+  "[ 2/1 → 33/16 | note:30 ]",
+  "[ 33/16 → 17/8 | note:30.625 ]",
+  "[ 17/8 → 35/16 | note:31.25 ]",
+  "[ 35/16 → 9/4 | note:31.875 ]",
+  "[ 9/4 → 37/16 | note:32.5 ]",
+  "[ 37/16 → 19/8 | note:33.125 ]",
+  "[ 19/8 → 39/16 | note:33.75 ]",
+  "[ 39/16 → 5/2 | note:34.375 ]",
+  "[ 5/2 → 41/16 | note:35 ]",
+  "[ 41/16 → 21/8 | note:35.625 ]",
+  "[ 21/8 → 43/16 | note:36.25 ]",
+  "[ 43/16 → 11/4 | note:36.875 ]",
+  "[ 11/4 → 45/16 | note:37.5 ]",
+  "[ 45/16 → 23/8 | note:38.125 ]",
+  "[ 23/8 → 47/16 | note:38.75 ]",
+  "[ 47/16 → 3/1 | note:39.375 ]",
+  "[ 3/1 → 49/16 | note:30 ]",
+  "[ 49/16 → 25/8 | note:30.625 ]",
+  "[ 25/8 → 51/16 | note:31.25 ]",
+  "[ 51/16 → 13/4 | note:31.875 ]",
+  "[ 13/4 → 53/16 | note:32.5 ]",
+  "[ 53/16 → 27/8 | note:33.125 ]",
+  "[ 27/8 → 55/16 | note:33.75 ]",
+  "[ 55/16 → 7/2 | note:34.375 ]",
+  "[ 7/2 → 57/16 | note:35 ]",
+  "[ 57/16 → 29/8 | note:35.625 ]",
+  "[ 29/8 → 59/16 | note:36.25 ]",
+  "[ 59/16 → 15/4 | note:36.875 ]",
+  "[ 15/4 → 61/16 | note:37.5 ]",
+  "[ 61/16 → 31/8 | note:38.125 ]",
+  "[ 31/8 → 63/16 | note:38.75 ]",
+  "[ 63/16 → 4/1 | note:39.375 ]",
+]
+`;
+
+exports[`runs examples > example "signal" example index 1 1`] = `
+[
+  "[ 0/1 → 1/16 | note:45 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 0/1 → 1/16 | note:45 s:gm_epiano gain:1.7 ]",
+  "[ 0/1 → 1/16 | note:52 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 0/1 → 1/16 | note:52 s:gm_epiano gain:1.7 ]",
+  "[ 1/16 → 1/8 | note:45.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/16 → 1/8 | note:45.078125 s:gm_epiano gain:1.7 ]",
+  "[ 1/16 → 1/8 | note:52.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/16 → 1/8 | note:52.078125 s:gm_epiano gain:1.7 ]",
+  "[ 1/8 → 3/16 | note:45.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/8 → 3/16 | note:45.3125 s:gm_epiano gain:1.7 ]",
+  "[ 1/8 → 3/16 | note:52.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/8 → 3/16 | note:52.3125 s:gm_epiano gain:1.7 ]",
+  "[ 3/16 → 1/4 | note:45.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/16 → 1/4 | note:45.703125 s:gm_epiano gain:1.7 ]",
+  "[ 3/16 → 1/4 | note:52.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/16 → 1/4 | note:52.703125 s:gm_epiano gain:1.7 ]",
+  "[ 1/4 → 5/16 | note:46.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/4 → 5/16 | note:46.25 s:gm_epiano gain:1.7 ]",
+  "[ 1/4 → 5/16 | note:53.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/4 → 5/16 | note:53.25 s:gm_epiano gain:1.7 ]",
+  "[ 5/16 → 3/8 | note:46.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/16 → 3/8 | note:46.953125 s:gm_epiano gain:1.7 ]",
+  "[ 5/16 → 3/8 | note:53.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/16 → 3/8 | note:53.953125 s:gm_epiano gain:1.7 ]",
+  "[ 3/8 → 7/16 | note:47.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/8 → 7/16 | note:47.8125 s:gm_epiano gain:1.7 ]",
+  "[ 3/8 → 7/16 | note:54.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/8 → 7/16 | note:54.8125 s:gm_epiano gain:1.7 ]",
+  "[ 7/16 → 1/2 | note:48.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/16 → 1/2 | note:48.828125 s:gm_epiano gain:1.7 ]",
+  "[ 7/16 → 1/2 | note:55.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/16 → 1/2 | note:55.828125 s:gm_epiano gain:1.7 ]",
+  "[ 1/2 → 9/16 | note:50 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/2 → 9/16 | note:50 s:gm_epiano gain:1.7 ]",
+  "[ 1/2 → 9/16 | note:57 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/2 → 9/16 | note:57 s:gm_epiano gain:1.7 ]",
+  "[ 9/16 → 5/8 | note:51.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 9/16 → 5/8 | note:51.328125 s:gm_epiano gain:1.7 ]",
+  "[ 9/16 → 5/8 | note:58.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 9/16 → 5/8 | note:58.328125 s:gm_epiano gain:1.7 ]",
+  "[ 5/8 → 11/16 | note:52.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/8 → 11/16 | note:52.8125 s:gm_epiano gain:1.7 ]",
+  "[ 5/8 → 11/16 | note:59.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/8 → 11/16 | note:59.8125 s:gm_epiano gain:1.7 ]",
+  "[ 11/16 → 3/4 | note:54.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 11/16 → 3/4 | note:54.453125 s:gm_epiano gain:1.7 ]",
+  "[ 11/16 → 3/4 | note:61.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 11/16 → 3/4 | note:61.453125 s:gm_epiano gain:1.7 ]",
+  "[ 3/4 → 13/16 | note:56.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/4 → 13/16 | note:56.25 s:gm_epiano gain:1.7 ]",
+  "[ 3/4 → 13/16 | note:63.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/4 → 13/16 | note:63.25 s:gm_epiano gain:1.7 ]",
+  "[ 13/16 → 7/8 | note:58.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 13/16 → 7/8 | note:58.203125 s:gm_epiano gain:1.7 ]",
+  "[ 13/16 → 7/8 | note:65.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 13/16 → 7/8 | note:65.203125 s:gm_epiano gain:1.7 ]",
+  "[ 7/8 → 15/16 | note:60.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/8 → 15/16 | note:60.3125 s:gm_epiano gain:1.7 ]",
+  "[ 7/8 → 15/16 | note:67.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/8 → 15/16 | note:67.3125 s:gm_epiano gain:1.7 ]",
+  "[ 15/16 → 1/1 | note:62.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 15/16 → 1/1 | note:62.578125 s:gm_epiano gain:1.7 ]",
+  "[ 15/16 → 1/1 | note:69.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 15/16 → 1/1 | note:69.578125 s:gm_epiano gain:1.7 ]",
+  "[ 1/1 → 17/16 | note:45 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/1 → 17/16 | note:45 s:gm_epiano gain:1.7 ]",
+  "[ 1/1 → 17/16 | note:52 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 1/1 → 17/16 | note:52 s:gm_epiano gain:1.7 ]",
+  "[ 17/16 → 9/8 | note:47.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 17/16 → 9/8 | note:47.578125 s:gm_epiano gain:1.7 ]",
+  "[ 17/16 → 9/8 | note:54.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 17/16 → 9/8 | note:54.578125 s:gm_epiano gain:1.7 ]",
+  "[ 9/8 → 19/16 | note:50.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 9/8 → 19/16 | note:50.3125 s:gm_epiano gain:1.7 ]",
+  "[ 9/8 → 19/16 | note:57.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 9/8 → 19/16 | note:57.3125 s:gm_epiano gain:1.7 ]",
+  "[ 19/16 → 5/4 | note:53.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 19/16 → 5/4 | note:53.203125 s:gm_epiano gain:1.7 ]",
+  "[ 19/16 → 5/4 | note:60.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 19/16 → 5/4 | note:60.203125 s:gm_epiano gain:1.7 ]",
+  "[ 5/4 → 21/16 | note:56.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/4 → 21/16 | note:56.25 s:gm_epiano gain:1.7 ]",
+  "[ 5/4 → 21/16 | note:63.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/4 → 21/16 | note:63.25 s:gm_epiano gain:1.7 ]",
+  "[ 21/16 → 11/8 | note:59.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 21/16 → 11/8 | note:59.453125 s:gm_epiano gain:1.7 ]",
+  "[ 21/16 → 11/8 | note:66.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 21/16 → 11/8 | note:66.453125 s:gm_epiano gain:1.7 ]",
+  "[ 11/8 → 23/16 | note:62.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 11/8 → 23/16 | note:62.8125 s:gm_epiano gain:1.7 ]",
+  "[ 11/8 → 23/16 | note:69.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 11/8 → 23/16 | note:69.8125 s:gm_epiano gain:1.7 ]",
+  "[ 23/16 → 3/2 | note:46.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 23/16 → 3/2 | note:46.328125 s:gm_epiano gain:1.7 ]",
+  "[ 23/16 → 3/2 | note:53.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 23/16 → 3/2 | note:53.328125 s:gm_epiano gain:1.7 ]",
+  "[ 3/2 → 25/16 | note:50 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/2 → 25/16 | note:50 s:gm_epiano gain:1.7 ]",
+  "[ 3/2 → 25/16 | note:57 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/2 → 25/16 | note:57 s:gm_epiano gain:1.7 ]",
+  "[ 25/16 → 13/8 | note:53.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 25/16 → 13/8 | note:53.828125 s:gm_epiano gain:1.7 ]",
+  "[ 25/16 → 13/8 | note:60.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 25/16 → 13/8 | note:60.828125 s:gm_epiano gain:1.7 ]",
+  "[ 13/8 → 27/16 | note:57.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 13/8 → 27/16 | note:57.8125 s:gm_epiano gain:1.7 ]",
+  "[ 13/8 → 27/16 | note:64.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 13/8 → 27/16 | note:64.8125 s:gm_epiano gain:1.7 ]",
+  "[ 27/16 → 7/4 | note:61.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 27/16 → 7/4 | note:61.953125 s:gm_epiano gain:1.7 ]",
+  "[ 27/16 → 7/4 | note:68.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 27/16 → 7/4 | note:68.953125 s:gm_epiano gain:1.7 ]",
+  "[ 7/4 → 29/16 | note:46.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/4 → 29/16 | note:46.25 s:gm_epiano gain:1.7 ]",
+  "[ 7/4 → 29/16 | note:53.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/4 → 29/16 | note:53.25 s:gm_epiano gain:1.7 ]",
+  "[ 29/16 → 15/8 | note:50.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 29/16 → 15/8 | note:50.703125 s:gm_epiano gain:1.7 ]",
+  "[ 29/16 → 15/8 | note:57.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 29/16 → 15/8 | note:57.703125 s:gm_epiano gain:1.7 ]",
+  "[ 15/8 → 31/16 | note:55.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 15/8 → 31/16 | note:55.3125 s:gm_epiano gain:1.7 ]",
+  "[ 15/8 → 31/16 | note:62.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 15/8 → 31/16 | note:62.3125 s:gm_epiano gain:1.7 ]",
+  "[ 31/16 → 2/1 | note:60.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 31/16 → 2/1 | note:60.078125 s:gm_epiano gain:1.7 ]",
+  "[ 31/16 → 2/1 | note:67.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 31/16 → 2/1 | note:67.078125 s:gm_epiano gain:1.7 ]",
+  "[ 2/1 → 33/16 | note:45 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 2/1 → 33/16 | note:45 s:gm_epiano gain:1.7 ]",
+  "[ 2/1 → 33/16 | note:52 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 2/1 → 33/16 | note:52 s:gm_epiano gain:1.7 ]",
+  "[ 33/16 → 17/8 | note:50.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 33/16 → 17/8 | note:50.078125 s:gm_epiano gain:1.7 ]",
+  "[ 33/16 → 17/8 | note:57.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 33/16 → 17/8 | note:57.078125 s:gm_epiano gain:1.7 ]",
+  "[ 17/8 → 35/16 | note:55.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 17/8 → 35/16 | note:55.3125 s:gm_epiano gain:1.7 ]",
+  "[ 17/8 → 35/16 | note:62.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 17/8 → 35/16 | note:62.3125 s:gm_epiano gain:1.7 ]",
+  "[ 35/16 → 9/4 | note:60.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 35/16 → 9/4 | note:60.703125 s:gm_epiano gain:1.7 ]",
+  "[ 35/16 → 9/4 | note:67.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 35/16 → 9/4 | note:67.703125 s:gm_epiano gain:1.7 ]",
+  "[ 9/4 → 37/16 | note:46.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 9/4 → 37/16 | note:46.25 s:gm_epiano gain:1.7 ]",
+  "[ 9/4 → 37/16 | note:53.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 9/4 → 37/16 | note:53.25 s:gm_epiano gain:1.7 ]",
+  "[ 37/16 → 19/8 | note:51.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 37/16 → 19/8 | note:51.953125 s:gm_epiano gain:1.7 ]",
+  "[ 37/16 → 19/8 | note:58.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 37/16 → 19/8 | note:58.953125 s:gm_epiano gain:1.7 ]",
+  "[ 19/8 → 39/16 | note:57.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 19/8 → 39/16 | note:57.8125 s:gm_epiano gain:1.7 ]",
+  "[ 19/8 → 39/16 | note:64.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 19/8 → 39/16 | note:64.8125 s:gm_epiano gain:1.7 ]",
+  "[ 39/16 → 5/2 | note:63.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 39/16 → 5/2 | note:63.828125 s:gm_epiano gain:1.7 ]",
+  "[ 39/16 → 5/2 | note:70.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 39/16 → 5/2 | note:70.828125 s:gm_epiano gain:1.7 ]",
+  "[ 5/2 → 41/16 | note:50 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/2 → 41/16 | note:50 s:gm_epiano gain:1.7 ]",
+  "[ 5/2 → 41/16 | note:57 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 5/2 → 41/16 | note:57 s:gm_epiano gain:1.7 ]",
+  "[ 41/16 → 21/8 | note:56.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 41/16 → 21/8 | note:56.328125 s:gm_epiano gain:1.7 ]",
+  "[ 41/16 → 21/8 | note:63.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 41/16 → 21/8 | note:63.328125 s:gm_epiano gain:1.7 ]",
+  "[ 21/8 → 43/16 | note:62.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 21/8 → 43/16 | note:62.8125 s:gm_epiano gain:1.7 ]",
+  "[ 21/8 → 43/16 | note:69.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 21/8 → 43/16 | note:69.8125 s:gm_epiano gain:1.7 ]",
+  "[ 43/16 → 11/4 | note:49.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 43/16 → 11/4 | note:49.453125 s:gm_epiano gain:1.7 ]",
+  "[ 43/16 → 11/4 | note:56.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 43/16 → 11/4 | note:56.453125 s:gm_epiano gain:1.7 ]",
+  "[ 11/4 → 45/16 | note:56.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 11/4 → 45/16 | note:56.25 s:gm_epiano gain:1.7 ]",
+  "[ 11/4 → 45/16 | note:63.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 11/4 → 45/16 | note:63.25 s:gm_epiano gain:1.7 ]",
+  "[ 45/16 → 23/8 | note:63.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 45/16 → 23/8 | note:63.203125 s:gm_epiano gain:1.7 ]",
+  "[ 45/16 → 23/8 | note:70.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 45/16 → 23/8 | note:70.203125 s:gm_epiano gain:1.7 ]",
+  "[ 23/8 → 47/16 | note:50.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 23/8 → 47/16 | note:50.3125 s:gm_epiano gain:1.7 ]",
+  "[ 23/8 → 47/16 | note:57.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 23/8 → 47/16 | note:57.3125 s:gm_epiano gain:1.7 ]",
+  "[ 47/16 → 3/1 | note:57.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 47/16 → 3/1 | note:57.578125 s:gm_epiano gain:1.7 ]",
+  "[ 47/16 → 3/1 | note:64.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 47/16 → 3/1 | note:64.578125 s:gm_epiano gain:1.7 ]",
+  "[ 3/1 → 49/16 | note:45 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/1 → 49/16 | note:45 s:gm_epiano gain:1.7 ]",
+  "[ 3/1 → 49/16 | note:52 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 3/1 → 49/16 | note:52 s:gm_epiano gain:1.7 ]",
+  "[ 49/16 → 25/8 | note:52.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 49/16 → 25/8 | note:52.578125 s:gm_epiano gain:1.7 ]",
+  "[ 49/16 → 25/8 | note:59.578125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 49/16 → 25/8 | note:59.578125 s:gm_epiano gain:1.7 ]",
+  "[ 25/8 → 51/16 | note:60.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 25/8 → 51/16 | note:60.3125 s:gm_epiano gain:1.7 ]",
+  "[ 25/8 → 51/16 | note:67.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 25/8 → 51/16 | note:67.3125 s:gm_epiano gain:1.7 ]",
+  "[ 51/16 → 13/4 | note:48.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 51/16 → 13/4 | note:48.203125 s:gm_epiano gain:1.7 ]",
+  "[ 51/16 → 13/4 | note:55.203125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 51/16 → 13/4 | note:55.203125 s:gm_epiano gain:1.7 ]",
+  "[ 13/4 → 53/16 | note:56.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 13/4 → 53/16 | note:56.25 s:gm_epiano gain:1.7 ]",
+  "[ 13/4 → 53/16 | note:63.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 13/4 → 53/16 | note:63.25 s:gm_epiano gain:1.7 ]",
+  "[ 53/16 → 27/8 | note:64.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 53/16 → 27/8 | note:64.453125 s:gm_epiano gain:1.7 ]",
+  "[ 53/16 → 27/8 | note:71.453125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 53/16 → 27/8 | note:71.453125 s:gm_epiano gain:1.7 ]",
+  "[ 27/8 → 55/16 | note:52.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 27/8 → 55/16 | note:52.8125 s:gm_epiano gain:1.7 ]",
+  "[ 27/8 → 55/16 | note:59.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 27/8 → 55/16 | note:59.8125 s:gm_epiano gain:1.7 ]",
+  "[ 55/16 → 7/2 | note:61.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 55/16 → 7/2 | note:61.328125 s:gm_epiano gain:1.7 ]",
+  "[ 55/16 → 7/2 | note:68.328125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 55/16 → 7/2 | note:68.328125 s:gm_epiano gain:1.7 ]",
+  "[ 7/2 → 57/16 | note:50 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/2 → 57/16 | note:50 s:gm_epiano gain:1.7 ]",
+  "[ 7/2 → 57/16 | note:57 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 7/2 → 57/16 | note:57 s:gm_epiano gain:1.7 ]",
+  "[ 57/16 → 29/8 | note:58.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 57/16 → 29/8 | note:58.828125 s:gm_epiano gain:1.7 ]",
+  "[ 57/16 → 29/8 | note:65.828125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 57/16 → 29/8 | note:65.828125 s:gm_epiano gain:1.7 ]",
+  "[ 29/8 → 59/16 | note:47.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 29/8 → 59/16 | note:47.8125 s:gm_epiano gain:1.7 ]",
+  "[ 29/8 → 59/16 | note:54.8125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 29/8 → 59/16 | note:54.8125 s:gm_epiano gain:1.7 ]",
+  "[ 59/16 → 15/4 | note:56.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 59/16 → 15/4 | note:56.953125 s:gm_epiano gain:1.7 ]",
+  "[ 59/16 → 15/4 | note:63.953125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 59/16 → 15/4 | note:63.953125 s:gm_epiano gain:1.7 ]",
+  "[ 15/4 → 61/16 | note:46.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 15/4 → 61/16 | note:46.25 s:gm_epiano gain:1.7 ]",
+  "[ 15/4 → 61/16 | note:53.25 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 15/4 → 61/16 | note:53.25 s:gm_epiano gain:1.7 ]",
+  "[ 61/16 → 31/8 | note:55.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 61/16 → 31/8 | note:55.703125 s:gm_epiano gain:1.7 ]",
+  "[ 61/16 → 31/8 | note:62.703125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 61/16 → 31/8 | note:62.703125 s:gm_epiano gain:1.7 ]",
+  "[ 31/8 → 63/16 | note:45.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 31/8 → 63/16 | note:45.3125 s:gm_epiano gain:1.7 ]",
+  "[ 31/8 → 63/16 | note:52.3125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 31/8 → 63/16 | note:52.3125 s:gm_epiano gain:1.7 ]",
+  "[ 63/16 → 4/1 | note:55.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 63/16 → 4/1 | note:55.078125 s:gm_epiano gain:1.7 ]",
+  "[ 63/16 → 4/1 | note:62.078125 s:gm_electric_guitar_jazz gain:1.7 ]",
+  "[ 63/16 → 4/1 | note:62.078125 s:gm_epiano gain:1.7 ]",
+]
+`;
+
 exports[`runs examples > example "silence" example index 0 1`] = `[]`;
 
 exports[`runs examples > example "sine" example index 0 1`] = `

From d4ec7e9a55e44111966f47f7c0d42194eb08269a Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 23:15:45 -0500
Subject: [PATCH 05/31] modify degradeByWith to be more user friendly, add doc

---
 packages/core/signal.mjs | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 7e0dfbbc3..2a688e5b3 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -5,7 +5,7 @@ This program is free software: you can redistribute it and/or modify it under th
 */
 
 import { Hap } from './hap.mjs';
-import { Pattern, fastcat, pure, register, reify, silence, stack, sequenceP } from './pattern.mjs';
+import { Pattern, fastcat, pure, register, reify, silence, stack, sequenceP, isPattern } from './pattern.mjs';
 import Fraction from './fraction.mjs';
 
 import { id, keyAlias, getCurrentKeyboardState } from './util.mjs';
@@ -742,11 +742,32 @@ export const perlin = signal((t, controls) => _perlin(t, controls.randSeed));
  */
 export const berlin = signal((t, controls) => _berlin(t, controls.randSeed));
 
+/**
+ * `degradeByWith` is like `degradeBy`, but with more granular control. 
+ * 
+ * `degradeBy(x)` is essentially `degradeByWith(rand, x)`
+ * 
+ * This allows you to do things other than with `rand`, see examples below 
+ * 
+ * @name degradeByWith
+ * @param {Pattern|number} test
+ * @param {Pattern|number} testAgainst
+ * @memberof Pattern
+ * @tags temporal
+ * @returns {Pattern}
+ * @example
+ * note("c a f e").degradeByWith(sine, .1)
+ * @example
+ * note("c a f e").degradeByWith(perlin, .5)
+ * @example 
+ * note("c a f e").degradeByWith(sine, cosine)
+ */
 export const degradeByWith = register(
   'degradeByWith',
-  (withPat, x, pat) => pat.fmap((a) => (_) => a).appLeft(withPat.filterValues((v) => v > x)),
-  true,
-  true,
+  (withPat, x, pat) => {
+    if (!isPattern(withPat)) withPat = pure(withPat)
+    return pat.fmap((a) => (_) => a).appLeft(withPat.filterValues((v) => v > x));
+  },
 );
 
 /**

From 787adfb20f5301e6398c4751c395ac54378bcb0c Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 23:16:15 -0500
Subject: [PATCH 06/31] format and snapshot

---
 packages/core/signal.mjs                  | 23 +++++++++------------
 test/__snapshots__/examples.test.mjs.snap | 25 +++++++++++++++++++++++
 2 files changed, 35 insertions(+), 13 deletions(-)

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 2a688e5b3..9bd13d102 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -743,12 +743,12 @@ export const perlin = signal((t, controls) => _perlin(t, controls.randSeed));
 export const berlin = signal((t, controls) => _berlin(t, controls.randSeed));
 
 /**
- * `degradeByWith` is like `degradeBy`, but with more granular control. 
- * 
+ * `degradeByWith` is like `degradeBy`, but with more granular control.
+ *
  * `degradeBy(x)` is essentially `degradeByWith(rand, x)`
- * 
- * This allows you to do things other than with `rand`, see examples below 
- * 
+ *
+ * This allows you to do things other than with `rand`, see examples below
+ *
  * @name degradeByWith
  * @param {Pattern|number} test
  * @param {Pattern|number} testAgainst
@@ -759,16 +759,13 @@ export const berlin = signal((t, controls) => _berlin(t, controls.randSeed));
  * note("c a f e").degradeByWith(sine, .1)
  * @example
  * note("c a f e").degradeByWith(perlin, .5)
- * @example 
+ * @example
  * note("c a f e").degradeByWith(sine, cosine)
  */
-export const degradeByWith = register(
-  'degradeByWith',
-  (withPat, x, pat) => {
-    if (!isPattern(withPat)) withPat = pure(withPat)
-    return pat.fmap((a) => (_) => a).appLeft(withPat.filterValues((v) => v > x));
-  },
-);
+export const degradeByWith = register('degradeByWith', (withPat, x, pat) => {
+  if (!isPattern(withPat)) withPat = pure(withPat);
+  return pat.fmap((a) => (_) => a).appLeft(withPat.filterValues((v) => v > x));
+});
 
 /**
  * Randomly removes events from the pattern by a given amount.
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 2aaa80a51..af6ede9fe 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -2977,6 +2977,31 @@ exports[`runs examples > example "degradeBy" example index 2 1`] = `
 ]
 `;
 
+exports[`runs examples > example "degradeByWith" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | note:c ]",
+  "[ 1/4 → 1/2 | note:a ]",
+  "[ 1/2 → 3/4 | note:f ]",
+  "[ 3/4 → 1/1 | note:e ]",
+  "[ 1/1 → 5/4 | note:c ]",
+  "[ 5/4 → 3/2 | note:a ]",
+  "[ 3/2 → 7/4 | note:f ]",
+  "[ 7/4 → 2/1 | note:e ]",
+  "[ 2/1 → 9/4 | note:c ]",
+  "[ 9/4 → 5/2 | note:a ]",
+  "[ 5/2 → 11/4 | note:f ]",
+  "[ 11/4 → 3/1 | note:e ]",
+  "[ 3/1 → 13/4 | note:c ]",
+  "[ 13/4 → 7/2 | note:a ]",
+  "[ 7/2 → 15/4 | note:f ]",
+  "[ 15/4 → 4/1 | note:e ]",
+]
+`;
+
+exports[`runs examples > example "degradeByWith" example index 1 1`] = `[]`;
+
+exports[`runs examples > example "degradeByWith" example index 2 1`] = `[]`;
+
 exports[`runs examples > example "delay" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | s:bd delay:0 ]",

From a76a23a43d7f193de375d870068c820de9467217 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 21 Feb 2026 23:37:00 -0500
Subject: [PATCH 07/31] replace a missing sample with an existing one in
 example

---
 packages/core/controls.mjs                |  2 +-
 test/__snapshots__/examples.test.mjs.snap | 96 +++++++++++------------
 2 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 7971f1ed9..d22167c0c 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -118,7 +118,7 @@ export const { s, sound } = registerControl(['s', 'n', 'gain'], 'sound');
  * @param {number | Pattern} position Position in the wavetable from 0 to 1
  * @synonyms wavetablePosition
  * @example
- * s("squelch").bank("wt_digital").seg(8).note("F1").wt("0 0.25 0.5 0.75 1")
+ * s("wt_digital").seg(8).note("F1").wt("0 0.25 0.5 0.75 1")
  */
 export const { wt, wavetablePosition } = registerControl('wt', 'wavetablePosition');
 
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index af6ede9fe..70519695f 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -14798,54 +14798,54 @@ exports[`runs examples > example "withValue" example index 0 1`] = `
 
 exports[`runs examples > example "wt" example index 0 1`] = `
 [
-  "[ 0/1 → 1/8 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ (1/8 → 1/5) ⇝ 1/4 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ 1/8 ⇜ (1/5 → 1/4) | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 1/4 → 3/8 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ (3/8 → 2/5) ⇝ 1/2 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 3/8 ⇜ (2/5 → 1/2) | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ (1/2 → 3/5) ⇝ 5/8 | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ 1/2 ⇜ (3/5 → 5/8) | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 5/8 → 3/4 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ (3/4 → 4/5) ⇝ 7/8 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 3/4 ⇜ (4/5 → 7/8) | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 7/8 → 1/1 | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 1/1 → 9/8 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ (9/8 → 6/5) ⇝ 5/4 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ 9/8 ⇜ (6/5 → 5/4) | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 5/4 → 11/8 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ (11/8 → 7/5) ⇝ 3/2 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 11/8 ⇜ (7/5 → 3/2) | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ (3/2 → 8/5) ⇝ 13/8 | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ 3/2 ⇜ (8/5 → 13/8) | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 13/8 → 7/4 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ (7/4 → 9/5) ⇝ 15/8 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 7/4 ⇜ (9/5 → 15/8) | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 15/8 → 2/1 | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 2/1 → 17/8 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ (17/8 → 11/5) ⇝ 9/4 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ 17/8 ⇜ (11/5 → 9/4) | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 9/4 → 19/8 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ (19/8 → 12/5) ⇝ 5/2 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 19/8 ⇜ (12/5 → 5/2) | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ (5/2 → 13/5) ⇝ 21/8 | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ 5/2 ⇜ (13/5 → 21/8) | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 21/8 → 11/4 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ (11/4 → 14/5) ⇝ 23/8 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 11/4 ⇜ (14/5 → 23/8) | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 23/8 → 3/1 | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 3/1 → 25/8 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ (25/8 → 16/5) ⇝ 13/4 | s:squelch bank:wt_digital note:F1 wt:0 ]",
-  "[ 25/8 ⇜ (16/5 → 13/4) | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 13/4 → 27/8 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ (27/8 → 17/5) ⇝ 7/2 | s:squelch bank:wt_digital note:F1 wt:0.25 ]",
-  "[ 27/8 ⇜ (17/5 → 7/2) | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ (7/2 → 18/5) ⇝ 29/8 | s:squelch bank:wt_digital note:F1 wt:0.5 ]",
-  "[ 7/2 ⇜ (18/5 → 29/8) | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 29/8 → 15/4 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ (15/4 → 19/5) ⇝ 31/8 | s:squelch bank:wt_digital note:F1 wt:0.75 ]",
-  "[ 15/4 ⇜ (19/5 → 31/8) | s:squelch bank:wt_digital note:F1 wt:1 ]",
-  "[ 31/8 → 4/1 | s:squelch bank:wt_digital note:F1 wt:1 ]",
+  "[ 0/1 → 1/8 | s:wt_digital note:F1 wt:0 ]",
+  "[ (1/8 → 1/5) ⇝ 1/4 | s:wt_digital note:F1 wt:0 ]",
+  "[ 1/8 ⇜ (1/5 → 1/4) | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 1/4 → 3/8 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ (3/8 → 2/5) ⇝ 1/2 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 3/8 ⇜ (2/5 → 1/2) | s:wt_digital note:F1 wt:0.5 ]",
+  "[ (1/2 → 3/5) ⇝ 5/8 | s:wt_digital note:F1 wt:0.5 ]",
+  "[ 1/2 ⇜ (3/5 → 5/8) | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 5/8 → 3/4 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ (3/4 → 4/5) ⇝ 7/8 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 3/4 ⇜ (4/5 → 7/8) | s:wt_digital note:F1 wt:1 ]",
+  "[ 7/8 → 1/1 | s:wt_digital note:F1 wt:1 ]",
+  "[ 1/1 → 9/8 | s:wt_digital note:F1 wt:0 ]",
+  "[ (9/8 → 6/5) ⇝ 5/4 | s:wt_digital note:F1 wt:0 ]",
+  "[ 9/8 ⇜ (6/5 → 5/4) | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 5/4 → 11/8 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ (11/8 → 7/5) ⇝ 3/2 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 11/8 ⇜ (7/5 → 3/2) | s:wt_digital note:F1 wt:0.5 ]",
+  "[ (3/2 → 8/5) ⇝ 13/8 | s:wt_digital note:F1 wt:0.5 ]",
+  "[ 3/2 ⇜ (8/5 → 13/8) | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 13/8 → 7/4 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ (7/4 → 9/5) ⇝ 15/8 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 7/4 ⇜ (9/5 → 15/8) | s:wt_digital note:F1 wt:1 ]",
+  "[ 15/8 → 2/1 | s:wt_digital note:F1 wt:1 ]",
+  "[ 2/1 → 17/8 | s:wt_digital note:F1 wt:0 ]",
+  "[ (17/8 → 11/5) ⇝ 9/4 | s:wt_digital note:F1 wt:0 ]",
+  "[ 17/8 ⇜ (11/5 → 9/4) | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 9/4 → 19/8 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ (19/8 → 12/5) ⇝ 5/2 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 19/8 ⇜ (12/5 → 5/2) | s:wt_digital note:F1 wt:0.5 ]",
+  "[ (5/2 → 13/5) ⇝ 21/8 | s:wt_digital note:F1 wt:0.5 ]",
+  "[ 5/2 ⇜ (13/5 → 21/8) | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 21/8 → 11/4 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ (11/4 → 14/5) ⇝ 23/8 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 11/4 ⇜ (14/5 → 23/8) | s:wt_digital note:F1 wt:1 ]",
+  "[ 23/8 → 3/1 | s:wt_digital note:F1 wt:1 ]",
+  "[ 3/1 → 25/8 | s:wt_digital note:F1 wt:0 ]",
+  "[ (25/8 → 16/5) ⇝ 13/4 | s:wt_digital note:F1 wt:0 ]",
+  "[ 25/8 ⇜ (16/5 → 13/4) | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 13/4 → 27/8 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ (27/8 → 17/5) ⇝ 7/2 | s:wt_digital note:F1 wt:0.25 ]",
+  "[ 27/8 ⇜ (17/5 → 7/2) | s:wt_digital note:F1 wt:0.5 ]",
+  "[ (7/2 → 18/5) ⇝ 29/8 | s:wt_digital note:F1 wt:0.5 ]",
+  "[ 7/2 ⇜ (18/5 → 29/8) | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 29/8 → 15/4 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ (15/4 → 19/5) ⇝ 31/8 | s:wt_digital note:F1 wt:0.75 ]",
+  "[ 15/4 ⇜ (19/5 → 31/8) | s:wt_digital note:F1 wt:1 ]",
+  "[ 31/8 → 4/1 | s:wt_digital note:F1 wt:1 ]",
 ]
 `;
 

From 53cce1d97b27e1723efcfaa3c7131918ccec4288 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sun, 22 Feb 2026 13:35:10 -0500
Subject: [PATCH 08/31] revert undocumented.json

---
 undocumented.json | 720 +++++++++++++++++++++++-----------------------
 1 file changed, 362 insertions(+), 358 deletions(-)

diff --git a/undocumented.json b/undocumented.json
index f59eb2039..3f5a3be30 100644
--- a/undocumented.json
+++ b/undocumented.json
@@ -8,19 +8,12 @@
   ],
   "/packages/codemirror/autocomplete.mjs": [
     "Autocomplete",
-    "bankCompletions",
-    "getSynonymDoc",
     "strudelAutocomplete",
     "isAutoCompletionEnabled"
   ],
-  "/packages/codemirror/basicSetup.mjs": [
-    "basicSetup",
-    "minimalSetup"
-  ],
-  "/packages/codemirror/block_utilities.mjs": [
-    "getBlockRegions",
-    "getBlockAt",
-    "evalBlock"
+  "/packages/codemirror/tooltip.mjs": [
+    "strudelTooltip",
+    "isTooltipEnabled"
   ],
   "/packages/codemirror/flash.mjs": [
     "setFlash",
@@ -31,29 +24,15 @@
   "/packages/codemirror/highlight.mjs": [
     "setMiniLocations",
     "showMiniLocations",
-    "displayMiniLocations",
     "updateMiniLocations",
     "highlightMiniLocations",
-    "getMiniLocations",
-    "getActiveMiniLocations",
     "highlightExtension",
     "isPatternHighlightingEnabled"
   ],
   "/packages/codemirror/keybindings.mjs": [
     "keybindings"
   ],
-  "/packages/codemirror/labelJump.mjs": [
-    "jumpToCharacter"
-  ],
-  "/packages/codemirror/slider.mjs": [
-    "acorn parse error: SyntaxError: undefined"
-  ],
-  "/packages/codemirror/themes/theme-helper.mjs": [
-    "createTheme"
-  ],
-  "/packages/codemirror/themes/strudel-theme.mjs": [
-    "settings"
-  ],
+  "/packages/codemirror/themes/strudel-theme.mjs": [],
   "/packages/codemirror/themes/bluescreen.mjs": [
     "settings"
   ],
@@ -69,103 +48,7 @@
   "/packages/codemirror/themes/algoboy.mjs": [
     "settings"
   ],
-  "/packages/codemirror/themes/CutiePi.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/sonic-pink.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/red-text.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/green-text.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/archBtw.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/fruitDaw.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/bluescreenlight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/androidstudio.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/atomone.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/aura.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/darcula.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/dracula.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/duotoneDark.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/eclipse.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/githubDark.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/githubLight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/gruvboxDark.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/gruvboxLight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/materialDark.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/materialLight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/nord.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/monokai.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/solarizedDark.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/solarizedLight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/sublime.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/tokyoNight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/tokioNightStorm.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/tokyoNightDay.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/vscodeDark.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/vscodeLight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/xcodeLight.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/bbedit.mjs": [
-    "settings"
-  ],
-  "/packages/codemirror/themes/noctisLilac.mjs": [
+  "/packages/codemirror/themes/terminal.mjs": [
     "settings"
   ],
   "/packages/codemirror/themes.mjs": [
@@ -177,34 +60,50 @@
     "initTheme",
     "activateTheme"
   ],
-  "/packages/codemirror/tooltip.mjs": [
-    "strudelTooltip",
-    "isTooltipEnabled"
+  "/packages/codemirror/slider.mjs": [
+    "acorn parse error: SyntaxError: undefined"
   ],
   "/packages/codemirror/widget.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "addWidget",
+    "updateWidgets",
+    "setWidget",
+    "BlockWidget",
+    "widgetPlugin",
+    "registerWidget"
   ],
   "/packages/codemirror/codemirror.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "defaultSettings",
+    "codemirrorSettings",
+    "initEditor",
+    "StrudelMirror"
   ],
   "/packages/codemirror/index.mjs": [],
+  "/packages/core/fraction.mjs": [
+    "gcd",
+    "lcm"
+  ],
+  "/packages/core/timespan.mjs": [
+    "TimeSpan"
+  ],
+  "/packages/core/hap.mjs": [
+    "Hap"
+  ],
+  "/packages/core/state.mjs": [
+    "State"
+  ],
   "/packages/core/logger.mjs": [
     "logKey",
-    "errorLogger",
     "logger"
   ],
   "/packages/core/util.mjs": [
     "isNoteWithOctave",
     "isNote",
     "tokenizeNote",
-    "getAccidentalsOffset",
     "noteToMidi",
     "midiToFreq",
     "freqToMidi",
     "valueToMidi",
-    "getEventOffsetMs",
     "_mod",
-    "averageArray",
     "nanFallback",
     "getSoundIndex",
     "getPlayableNoteValue",
@@ -223,37 +122,13 @@
     "fractionalArgs",
     "splitAt",
     "zipWith",
-    "pairs",
     "clamp",
     "sol2note",
-    "uniq",
-    "uniqsort",
-    "uniqsortr",
     "unicodeToBase64",
     "base64ToUnicode",
     "code2hash",
     "hash2code",
-    "objectMap",
-    "cycleToSeconds",
-    "ClockCollator",
-    "getPerformanceTimeSeconds",
-    "keyAlias",
-    "getCurrentKeyboardState",
-    "stringifyValues"
-  ],
-  "/packages/core/fraction.mjs": [
-    "gcd",
-    "lcm",
-    "isFraction"
-  ],
-  "/packages/core/timespan.mjs": [
-    "TimeSpan"
-  ],
-  "/packages/core/hap.mjs": [
-    "Hap"
-  ],
-  "/packages/core/state.mjs": [
-    "State"
+    "objectMap"
   ],
   "/packages/core/value.mjs": [
     "unionWithObj",
@@ -262,77 +137,292 @@
     "map"
   ],
   "/packages/core/drawLine.mjs": [],
-  "/packages/core/evaluate.mjs": [
-    "strudelScope",
-    "userDefinedKeys",
-    "evalScope",
-    "evaluate"
-  ],
   "/packages/core/pattern.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "setStringParser",
+    "polyrhythm",
+    "pr",
+    "pm",
+    "nothing",
+    "isPattern",
+    "reify",
+    "stackLeft",
+    "stackRight",
+    "stackCentre",
+    "stackBy",
+    "fastcat",
+    "_polymeterListSteps",
+    "set",
+    "keep",
+    "keepif",
+    "mod",
+    "pow",
+    "band",
+    "bor",
+    "bxor",
+    "blshift",
+    "brshift",
+    "lt",
+    "gt",
+    "lte",
+    "gte",
+    "eq",
+    "eqt",
+    "ne",
+    "net",
+    "and",
+    "or",
+    "func",
+    "compressSpan",
+    "compressspan",
+    "fastgap",
+    "focusSpan",
+    "focusspan",
+    "density",
+    "sparsity",
+    "zoomArc",
+    "zoomarc",
+    "inv",
+    "juxby",
+    "echowith",
+    "stutWith",
+    "stutwith",
+    "iterback",
+    "slowchunk",
+    "slowChunk",
+    "chunkback",
+    "fastchunk",
+    "bypass",
+    "hsla",
+    "hsl",
+    "loopat",
+    "loopatcps"
   ],
   "/packages/core/controls.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "createParam",
+    "sound",
+    "src",
+    "att",
+    "fmi",
+    "fmrelease",
+    "fmvelocity",
+    "analyze",
+    "fft",
+    "dec",
+    "sus",
+    "rel",
+    "hold",
+    "bandf",
+    "bp",
+    "bandq",
+    "loopb",
+    "loope",
+    "ch",
+    "phaserrate",
+    "phasr",
+    "ph",
+    "phs",
+    "phc",
+    "phd",
+    "phasdp",
+    "cutoff",
+    "ctf",
+    "lp",
+    "lpe",
+    "hpe",
+    "bpe",
+    "lpa",
+    "hpa",
+    "bpa",
+    "lpd",
+    "hpd",
+    "bpd",
+    "lps",
+    "hps",
+    "bps",
+    "lpr",
+    "hpr",
+    "bpr",
+    "fanchor",
+    "vibrato",
+    "v",
+    "vmod",
+    "hcutoff",
+    "hp",
+    "hresonance",
+    "resonance",
+    "delayfb",
+    "dfb",
+    "delayt",
+    "dt",
+    "lock",
+    "det",
+    "fadeTime",
+    "fadeOutTime",
+    "fadeInTime",
+    "patt",
+    "pdec",
+    "psustain",
+    "psus",
+    "prel",
+    "gate",
+    "gat",
+    "activeLabel",
+    "degree",
+    "mtranspose",
+    "ctranspose",
+    "harmonic",
+    "stepsPerOctave",
+    "octaveR",
+    "nudge",
+    "overgain",
+    "overshape",
+    "panspan",
+    "pansplay",
+    "panwidth",
+    "panorient",
+    "rate",
+    "slide",
+    "semitone",
+    "voice",
+    "chord",
+    "dictionary",
+    "dict",
+    "anchor",
+    "offset",
+    "octaves",
+    "mode",
+    "rlp",
+    "rdim",
+    "rfade",
+    "ir",
+    "size",
+    "sz",
+    "rsize",
+    "dist",
+    "compressorKnee",
+    "compressorRatio",
+    "compressorAttack",
+    "compressorRelease",
+    "waveloss",
+    "density",
+    "expression",
+    "sustainpedal",
+    "tremolodepth",
+    "tremdp",
+    "tremolorate",
+    "tremr",
+    "fshift",
+    "fshiftnote",
+    "fshiftphase",
+    "triode",
+    "krush",
+    "kcutoff",
+    "octer",
+    "octersub",
+    "octersubsub",
+    "ring",
+    "ringf",
+    "ringdf",
+    "freeze",
+    "xsdelay",
+    "tsdelay",
+    "real",
+    "imag",
+    "enhance",
+    "partials",
+    "comb",
+    "smear",
+    "scram",
+    "binshift",
+    "hbrick",
+    "lbrick",
+    "midichan",
+    "control",
+    "ccn",
+    "ccv",
+    "polyTouch",
+    "midibend",
+    "miditouch",
+    "ctlNum",
+    "frameRate",
+    "frames",
+    "hours",
+    "midicmd",
+    "minutes",
+    "progNum",
+    "seconds",
+    "songPtr",
+    "uid",
+    "val",
+    "cps",
+    "legato",
+    "dur",
+    "zrand",
+    "curve",
+    "deltaSlide",
+    "pitchJump",
+    "pitchJumpTime",
+    "lfo",
+    "repeatTime",
+    "znoise",
+    "zmod",
+    "zcrush",
+    "zdelay",
+    "tremolo",
+    "zzfx",
+    "colour",
+    "createParams",
+    "ad",
+    "ds",
+    "ar"
   ],
   "/packages/core/euclid.mjs": [
-    "bjorklund",
     "bjork",
-    "euclidrot",
-    "eish"
+    "euclidrot"
   ],
   "/packages/core/zyklus.mjs": [],
-  "/packages/core/cyclist.mjs": [
-    "Cyclist"
-  ],
-  "/packages/core/impure.mjs": [
-    "reset_state",
-    "reset_timelines",
-    "timeline"
-  ],
-  "/packages/core/pick.mjs": [
+  "/packages/core/signal.mjs": [
+    "steady",
+    "signal",
+    "isaw",
+    "isaw2",
+    "saw2",
+    "sine2",
+    "cosine2",
+    "square2",
+    "tri2",
+    "time",
+    "_brandBy",
+    "_irand",
     "pickSqueeze",
-    "pickmodSqueeze"
+    "pickmodSqueeze",
+    "__chooseWith",
+    "randcat",
+    "wrandcat",
+    "perlinWith",
+    "degradeByWith"
+  ],
+  "/packages/core/speak.mjs": [
+    "speak"
+  ],
+  "/packages/core/evaluate.mjs": [
+    "evalScope",
+    "evaluate"
   ],
   "/packages/core/neocyclist.mjs": [
     "NeoCyclist"
   ],
-  "/packages/core/schedulerState.mjs": [
+  "/packages/core/cyclist.mjs": [
+    "Cyclist"
+  ],
+  "/packages/core/time.mjs": [
     "getTime",
-    "setTime",
-    "setCpsFunc",
-    "getCps",
-    "setPattern",
-    "getPattern",
-    "setTriggerFunc",
-    "getTriggerFunc",
-    "setIsStarted",
-    "getIsStarted"
+    "setTime"
   ],
   "/packages/core/repl.mjs": [
     "repl",
     "getTrigger"
   ],
-  "/packages/core/signal.mjs": [
-    "steady",
-    "signal",
-    "mouseY",
-    "mouseX",
-    "getRandsAtTime",
-    "randrun",
-    "_brandBy",
-    "_irand",
-    "__chooseWith",
-    "chooseIn",
-    "chooseOut",
-    "randcat",
-    "wrandcat",
-    "degradeByWith",
-    "_keyDown",
-    "perCycle"
-  ],
-  "/packages/core/speak.mjs": [
-    "speak"
-  ],
   "/packages/core/ui.mjs": [
     "backgroundImage",
     "cleanupUi"
@@ -350,19 +440,13 @@
     "isTauri"
   ],
   "/packages/desktopbridge/midibridge.mjs": [],
-  "/packages/desktopbridge/oscbridge.mjs": [
-    "oscTriggerTauri"
-  ],
+  "/packages/desktopbridge/oscbridge.mjs": [],
   "/packages/desktopbridge/index.mjs": [],
   "/packages/draw/draw.mjs": [
     "getDrawContext",
     "cleanupDraw",
-    "cleanupDrawContext",
     "Framer",
-    "Drawer",
-    "getComputedPropertyValue",
-    "getTheme",
-    "setTheme"
+    "Drawer"
   ],
   "/packages/draw/animate.mjs": [
     "x",
@@ -383,98 +467,16 @@
     "convertHexToNumber"
   ],
   "/packages/draw/pianoroll.mjs": [
-    "__pianoroll",
     "getDrawOptions",
     "getPunchcardPainter",
     "drawPianoroll"
   ],
   "/packages/draw/spiral.mjs": [],
-  "/packages/draw/pitchwheel.mjs": [],
   "/packages/draw/index.mjs": [],
-  "/packages/edo/edoscale.mjs": [
-    "EdoScale"
-  ],
-  "/packages/edo/ratios.mjs": [],
-  "/packages/edo/intervals.mjs": [
-    "Intervals"
-  ],
-  "/packages/edo/pitches.mjs": [
-    "Pitches"
-  ],
-  "/packages/edo/edo.mjs": [],
-  "/packages/edo/index.mjs": [
-    "packageName"
-  ],
-  "/packages/superdough/audioContext.mjs": [
-    "setDefaultAudioContext",
-    "setAudioContext",
-    "getAudioContext",
-    "getAudioContextCurrentTime"
-  ],
-  "/packages/superdough/logger.mjs": [
-    "errorLogger",
-    "logger",
-    "setLogger"
-  ],
-  "/packages/superdough/noise.mjs": [
-    "getNoiseBuffer",
-    "getNoiseOscillator",
-    "getNoiseMix"
-  ],
-  "/packages/superdough/nodePools.mjs": [
-    "isPoolable",
-    "releaseNodeToPool",
-    "getNodeFromPool"
-  ],
-  "/packages/superdough/util.mjs": [
-    "tokenizeNote",
-    "getAccidentalsOffset",
-    "noteToMidi",
-    "midiToFreq",
-    "clamp",
-    "freqToMidi",
-    "valueToMidi",
-    "nanFallback",
-    "_mod",
-    "getSoundIndex",
-    "cycleToSeconds",
-    "secondsToCycle",
-    "getCommonSampleInfo",
-    "getBaseURL"
-  ],
-  "/packages/superdough/helpers.mjs": [
-    "noises",
-    "gainNode",
-    "effectSend",
-    "getWorklet",
-    "getParamADSR",
-    "getEnvelope",
-    "getLfo",
-    "getCompressor",
-    "getADSRValues",
-    "getParamLfo",
-    "applyParameterModulators",
-    "createFilter",
-    "drywet",
-    "getPitchEnvelope",
-    "getVibratoOscillator",
-    "scheduleAtTime",
-    "webAudioTimeout",
-    "applyFM",
-    "distortionAlgorithms",
-    "getDistortionAlgorithm",
-    "getDistortion",
-    "getFrequencyFromValue",
-    "onceEnded",
-    "releaseAudioNode",
-    "cleanupOnEnd"
-  ],
-  "/packages/midi/util.mjs": [],
-  "/packages/midi/input.mjs": [
-    "acorn parse error: SyntaxError: undefined"
-  ],
   "/packages/midi/midi.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "WebMidi",
+    "enableWebMidi",
+    "midin"
   ],
   "/packages/midi/index.mjs": [],
   "/packages/mini/krill-parser.js": [],
@@ -500,7 +502,6 @@
   "/packages/repl/index.mjs": [],
   "/packages/soundfonts/gm.mjs": [],
   "/packages/soundfonts/fontloader.mjs": [
-    "setSoundfontUrl",
     "getFontBufferSource",
     "getFontPitch",
     "registerSoundfonts"
@@ -520,40 +521,67 @@
   "/packages/superdough/vowel.mjs": [
     "vowelFormant"
   ],
-  "/packages/superdough/superdoughdata.mjs": [
-    "getSuperdoughControlTargets"
+  "/packages/superdough/logger.mjs": [
+    "logger",
+    "setLogger"
   ],
-  "/packages/superdough/modulators.mjs": [
-    "connectLFO",
-    "connectEnvelope",
-    "connectBusModulator"
+  "/packages/superdough/util.mjs": [
+    "tokenizeNote",
+    "noteToMidi",
+    "midiToFreq",
+    "clamp",
+    "freqToMidi",
+    "valueToMidi",
+    "nanFallback",
+    "_mod",
+    "getSoundIndex"
+  ],
+  "/packages/superdough/helpers.mjs": [
+    "gainNode",
+    "getParamADSR",
+    "getCompressor",
+    "getADSRValues",
+    "createFilter",
+    "drywet",
+    "getPitchEnvelope",
+    "getVibratoOscillator",
+    "webAudioTimeout",
+    "applyFM"
   ],
   "/packages/superdough/sampler.mjs": [
     "getCachedBuffer",
-    "getDuration",
-    "getSampleInfo",
-    "getSampleBuffer",
     "getSampleBufferSource",
     "loadBuffer",
     "reverseBuffer",
     "getLoadedBuffer",
     "processSampleMap",
     "registerSamplesPrefix",
-    "fetchSampleMap",
-    "onTriggerSample",
-    "registerSampleSource"
-  ],
-  "/packages/superdough/superdoughoutput.mjs": [
-    "acorn parse error: SyntaxError: undefined"
-  ],
-  "/packages/superdough/wavetable.mjs": [
-    "Warpmode",
-    "resetSeenKeys",
-    "registerWaveTable",
-    "onTriggerSynth"
+    "onTriggerSample"
   ],
   "/packages/superdough/superdough.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "soundMap",
+    "registerSound",
+    "getSound",
+    "resetLoadedSounds",
+    "setDefaultAudioContext",
+    "getAudioContext",
+    "getWorklet",
+    "initAudio",
+    "initAudioOnFirstClick",
+    "initializeAudioOutput",
+    "connectToDestination",
+    "panic",
+    "analysers",
+    "analysersData",
+    "getAnalyserById",
+    "getAnalyzerData",
+    "resetGlobalEffects",
+    "superdough",
+    "superdoughTrigger"
+  ],
+  "/packages/superdough/noise.mjs": [
+    "getNoiseOscillator",
+    "getNoiseMix"
   ],
   "/packages/superdough/synth.mjs": [
     "registerSynthSounds",
@@ -594,11 +622,7 @@
     "Step",
     "Note"
   ],
-  "/packages/tonal/tonal.mjs": [
-    "trans",
-    "scaleTrans",
-    "strans"
-  ],
+  "/packages/tonal/tonal.mjs": [],
   "/packages/tonal/ireal.mjs": [
     "simple",
     "complex"
@@ -615,51 +639,31 @@
     "packageName"
   ],
   "/packages/transpiler/transpiler.mjs": [
-    "registerLanguage",
-    "getLanguages",
-    "registerTranspilerPlugin",
-    "getPlugins",
-    "transpiler"
-  ],
-  "/packages/transpiler/plugin-kabelsalat.mjs": [
-    "genExprSource",
-    "extractPatternPlaceholders"
-  ],
-  "/packages/transpiler/plugin-mini.mjs": [
-    "acorn parse error: SyntaxError: undefined"
-  ],
-  "/packages/transpiler/plugin-sample.mjs": [
-    "withAwait"
-  ],
-  "/packages/transpiler/plugin-widgets.mjs": [
-    "acorn parse error: SyntaxError: undefined"
+    "registerWidgetType",
+    "transpiler",
+    "getWidgetID"
   ],
   "/packages/transpiler/index.mjs": [
     "evaluate"
   ],
-  "/packages/webaudio/supradough.mjs": [
-    "fetchSampleMap",
-    "doughsamples"
-  ],
   "/packages/webaudio/webaudio.mjs": [
     "webaudioOutput",
-    "renderPatternAudio",
     "webaudioRepl"
   ],
   "/packages/webaudio/scope.mjs": [
     "drawTimeScope",
     "drawFrequencyScope"
   ],
-  "/packages/webaudio/spectrum.mjs": [],
   "/packages/webaudio/index.mjs": [],
-  "/packages/xen/tunejs.js": [],
   "/packages/xen/xen.mjs": [
     "edo",
-    "ftrans",
-    "fTrans",
-    "fTranspose"
+    "xen",
+    "tuning"
+  ],
+  "/packages/xen/tunejs.js": [],
+  "/packages/xen/tune.mjs": [
+    "tune"
   ],
-  "/packages/xen/tune.mjs": [],
   "/packages/xen/index.mjs": [],
   "/index.mjs": []
 }

From dfb2335b1c6e023dae5f977e269748a7da760ec2 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sun, 22 Feb 2026 17:28:32 -0500
Subject: [PATCH 09/31] document stackRight, Left, Centre/Center

---
 packages/core/pattern.mjs                 |  50 +++++++
 packages/core/test/pattern.test.mjs       |   3 +-
 test/__snapshots__/examples.test.mjs.snap | 171 ++++++++++++++++++++++
 3 files changed, 223 insertions(+), 1 deletion(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index ed5ff9cd4..054aade24 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1519,6 +1519,15 @@ function _stackWith(func, pats) {
   return stack(...func(steps, pats));
 }
 
+/**
+ * The input patterns are aligned to the left, with silence padded to the shorter pattern(s) in the final steps if there's a stepcount disparity. See also `stackRight` and `stackCentre/stackCenter`
+ *
+ * @name stackLeft
+ * @tags temporal, stepwise
+ * @return {Pattern}
+ * @example
+ * stackLeft("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ */
 export function stackLeft(...pats) {
   return _stackWith(
     (steps, pats) => pats.map((pat) => (pat._steps.eq(steps) ? pat : stepcat(pat, gap(steps.sub(pat._steps))))),
@@ -1526,6 +1535,15 @@ export function stackLeft(...pats) {
   );
 }
 
+/**
+ * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCentre/stackCenter`
+ *
+ * @name stackRight
+ * @tags temporal, stepwise
+ * @return {Pattern}
+ * @example
+ * stackRight("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ */
 export function stackRight(...pats) {
   return _stackWith(
     (steps, pats) => pats.map((pat) => (pat._steps.eq(steps) ? pat : stepcat(gap(steps.sub(pat._steps)), pat))),
@@ -1533,6 +1551,15 @@ export function stackRight(...pats) {
   );
 }
 
+/**
+ * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCentre/stackCenter`
+ * @name stackCentre
+ * @tags temporal, stepwise
+ * @synonyms stackCenter
+ * @return {Pattern}
+ * @example
+ * stackCentre("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ */
 export function stackCentre(...pats) {
   return _stackWith(
     (steps, pats) =>
@@ -1547,6 +1574,10 @@ export function stackCentre(...pats) {
   );
 }
 
+export function stackCenter(pats) {
+  return stackCentre(pats);
+}
+
 export function stackBy(by, ...pats) {
   const [left, ...right] = pats.map((pat) => pat._steps);
   const steps = left.maximum(...right);
@@ -2922,10 +2953,29 @@ export const { ribbon, rib } = register(['ribbon', 'rib'], (offset, cycles, pat)
   pat.early(offset).restart(pure(1).slow(cycles)),
 );
 
+/**
+ * Sets the pattern's color to the given [hsla](https://www.w3schools.com/htmL/html_colors_hsl.asp)
+ *
+ * @name hsla
+ * @param {Number} hue (0 - 360)
+ * @param {Number} saturation percentage (0 - 100)
+ * @param {Number} lightness percentage (0 - 100)
+ * @param {Number} alpha (transparency) (0.0 - 1.0)
+ * @tags visualization
+ */
 export const hsla = register('hsla', (h, s, l, a, pat) => {
   return pat.color(`hsla(${h}turn,${s * 100}%,${l * 100}%,${a})`);
 });
 
+/**
+ * Sets the pattern's color to the given [hsl](https://www.w3schools.com/htmL/html_colors_hsl.asp)
+ *
+ * @name hsl
+ * @param {Number} hue (0 - 360)
+ * @param {Number} saturation percentage (0 - 100)
+ * @param {Number} lightness percentage (0 - 100)
+ * @tags visualization
+ */
 export const hsl = register('hsl', (h, s, l, pat) => {
   return pat.color(`hsl(${h}turn,${s * 100}%,${l * 100}%)`);
 });
diff --git a/packages/core/test/pattern.test.mjs b/packages/core/test/pattern.test.mjs
index aaa14bd27..4442aa4a7 100644
--- a/packages/core/test/pattern.test.mjs
+++ b/packages/core/test/pattern.test.mjs
@@ -55,7 +55,7 @@ import {
   expand,
 } from '../index.mjs';
 
-import { log, logValues } from '../pattern.mjs';
+import { log, logValues, stackCenter } from '../pattern.mjs';
 
 import { steady } from '../signal.mjs';
 
@@ -1166,6 +1166,7 @@ describe('Pattern', () => {
       expect(stackRight(fastcat(0, 1, 2), fastcat(3, 4))._steps).toStrictEqual(Fraction(3));
       // maybe this should double when they are either all even or all odd
       expect(stackCentre(fastcat(0, 1, 2), fastcat(3, 4))._steps).toStrictEqual(Fraction(3));
+      expect(stackCenter(fastcat(0, 1, 2), fastcat(3, 4))._steps).toStrictEqual(Fraction(3));
       expect(fastcat(0, 1).ply(3)._steps).toStrictEqual(Fraction(6));
       expect(fastcat(0, 1).setSteps(undefined).ply(3)._steps).toStrictEqual(undefined);
       expect(fastcat(0, 1).fast(3)._steps).toStrictEqual(Fraction(2));
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 70519695f..622aa1a16 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -12694,6 +12694,177 @@ exports[`runs examples > example "stack" example index 1 1`] = `
 ]
 `;
 
+exports[`runs examples > example "stackCentre" example index 0 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 1/10 → 3/10 | note:C3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 3/10 → 1/2 | note:D3 ]",
+  "[ 3/10 → 1/2 | note:F3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 1/2 → 7/10 | note:Eb3 ]",
+  "[ 1/2 → 7/10 | note:G3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 7/10 → 9/10 | note:F3 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 11/10 → 13/10 | note:C3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 13/10 → 3/2 | note:D3 ]",
+  "[ 13/10 → 3/2 | note:F3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 3/2 → 17/10 | note:Eb3 ]",
+  "[ 3/2 → 17/10 | note:G3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 17/10 → 19/10 | note:F3 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 21/10 → 23/10 | note:C3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 23/10 → 5/2 | note:D3 ]",
+  "[ 23/10 → 5/2 | note:F3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 5/2 → 27/10 | note:Eb3 ]",
+  "[ 5/2 → 27/10 | note:G3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 27/10 → 29/10 | note:F3 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 31/10 → 33/10 | note:C3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 33/10 → 7/2 | note:D3 ]",
+  "[ 33/10 → 7/2 | note:F3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 7/2 → 37/10 | note:Eb3 ]",
+  "[ 7/2 → 37/10 | note:G3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 37/10 → 39/10 | note:F3 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
+exports[`runs examples > example "stackLeft" example index 0 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 0/1 → 1/5 | note:C3 ]",
+  "[ 0/1 → 1/5 | note:F3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:D3 ]",
+  "[ 1/5 → 2/5 | note:G3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 2/5 → 3/5 | note:Eb3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 3/5 → 4/5 | note:F3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 1/1 → 6/5 | note:C3 ]",
+  "[ 1/1 → 6/5 | note:F3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:D3 ]",
+  "[ 6/5 → 7/5 | note:G3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 7/5 → 8/5 | note:Eb3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 8/5 → 9/5 | note:F3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 2/1 → 11/5 | note:C3 ]",
+  "[ 2/1 → 11/5 | note:F3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:D3 ]",
+  "[ 11/5 → 12/5 | note:G3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 12/5 → 13/5 | note:Eb3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 13/5 → 14/5 | note:F3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 3/1 → 16/5 | note:C3 ]",
+  "[ 3/1 → 16/5 | note:F3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:D3 ]",
+  "[ 16/5 → 17/5 | note:G3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 17/5 → 18/5 | note:Eb3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 18/5 → 19/5 | note:F3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
+exports[`runs examples > example "stackRight" example index 0 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:C3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 2/5 → 3/5 | note:D3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 3/5 → 4/5 | note:Eb3 ]",
+  "[ 3/5 → 4/5 | note:F3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 4/5 → 1/1 | note:F3 ]",
+  "[ 4/5 → 1/1 | note:G3 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:C3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 7/5 → 8/5 | note:D3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 8/5 → 9/5 | note:Eb3 ]",
+  "[ 8/5 → 9/5 | note:F3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 9/5 → 2/1 | note:F3 ]",
+  "[ 9/5 → 2/1 | note:G3 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:C3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 12/5 → 13/5 | note:D3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 13/5 → 14/5 | note:Eb3 ]",
+  "[ 13/5 → 14/5 | note:F3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 14/5 → 3/1 | note:F3 ]",
+  "[ 14/5 → 3/1 | note:G3 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:C3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 17/5 → 18/5 | note:D3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 18/5 → 19/5 | note:Eb3 ]",
+  "[ 18/5 → 19/5 | note:F3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 19/5 → 4/1 | note:F3 ]",
+  "[ 19/5 → 4/1 | note:G3 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
 exports[`runs examples > example "stepalt" example index 0 1`] = `
 [
   "[ 0/1 → 1/5 | s:bd ]",

From 58e6b0543f56c4afca4186cf02265560e0ee27e0 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sun, 22 Feb 2026 17:37:57 -0500
Subject: [PATCH 10/31] add stackRepeat (already supported, just not exposed to
 the user)

---
 packages/core/pattern.mjs                 | 18 +++++-
 test/__snapshots__/examples.test.mjs.snap | 73 +++++++++++++++++++++++
 2 files changed, 88 insertions(+), 3 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 054aade24..65804a262 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1523,7 +1523,7 @@ function _stackWith(func, pats) {
  * The input patterns are aligned to the left, with silence padded to the shorter pattern(s) in the final steps if there's a stepcount disparity. See also `stackRight` and `stackCentre/stackCenter`
  *
  * @name stackLeft
- * @tags temporal, stepwise
+ * @tags temporal, stepwise, combiners
  * @return {Pattern}
  * @example
  * stackLeft("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
@@ -1539,7 +1539,7 @@ export function stackLeft(...pats) {
  * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCentre/stackCenter`
  *
  * @name stackRight
- * @tags temporal, stepwise
+ * @tags temporal, stepwise, combiners
  * @return {Pattern}
  * @example
  * stackRight("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
@@ -1554,7 +1554,7 @@ export function stackRight(...pats) {
 /**
  * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCentre/stackCenter`
  * @name stackCentre
- * @tags temporal, stepwise
+ * @tags temporal, stepwise, combiners
  * @synonyms stackCenter
  * @return {Pattern}
  * @example
@@ -1578,6 +1578,18 @@ export function stackCenter(pats) {
   return stackCentre(pats);
 }
 
+/**
+ * Shorthand for `pm(patterns).pace(m)` where m is the max step count in the input patterns
+ * @name stackRepeat
+ * @tags temporal, stepwise, combiners
+ * @return {Pattern}
+ * @example
+ * stackRepeat("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ */
+export function stackRepeat(...pats) {
+  return stackBy(reify('repeat'), ...pats);
+}
+
 export function stackBy(by, ...pats) {
   const [left, ...right] = pats.map((pat) => pat._steps);
   const steps = left.maximum(...right);
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 622aa1a16..a4d4e2536 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -12808,6 +12808,79 @@ exports[`runs examples > example "stackLeft" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "stackRepeat" example index 0 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 0/1 → 1/5 | note:C3 ]",
+  "[ 0/1 → 1/5 | note:F3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:D3 ]",
+  "[ 1/5 → 2/5 | note:G3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 2/5 → 3/5 | note:Eb3 ]",
+  "[ 2/5 → 3/5 | note:F3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 3/5 → 4/5 | note:F3 ]",
+  "[ 3/5 → 4/5 | note:G3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 4/5 → 1/1 | note:C3 ]",
+  "[ 4/5 → 1/1 | note:F3 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 1/1 → 6/5 | note:D3 ]",
+  "[ 1/1 → 6/5 | note:G3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:Eb3 ]",
+  "[ 6/5 → 7/5 | note:F3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 7/5 → 8/5 | note:F3 ]",
+  "[ 7/5 → 8/5 | note:G3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 8/5 → 9/5 | note:C3 ]",
+  "[ 8/5 → 9/5 | note:F3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 9/5 → 2/1 | note:D3 ]",
+  "[ 9/5 → 2/1 | note:G3 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 2/1 → 11/5 | note:Eb3 ]",
+  "[ 2/1 → 11/5 | note:F3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:F3 ]",
+  "[ 11/5 → 12/5 | note:G3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 12/5 → 13/5 | note:C3 ]",
+  "[ 12/5 → 13/5 | note:F3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 13/5 → 14/5 | note:D3 ]",
+  "[ 13/5 → 14/5 | note:G3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 14/5 → 3/1 | note:Eb3 ]",
+  "[ 14/5 → 3/1 | note:F3 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 3/1 → 16/5 | note:F3 ]",
+  "[ 3/1 → 16/5 | note:G3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:C3 ]",
+  "[ 16/5 → 17/5 | note:F3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 17/5 → 18/5 | note:D3 ]",
+  "[ 17/5 → 18/5 | note:G3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 18/5 → 19/5 | note:Eb3 ]",
+  "[ 18/5 → 19/5 | note:F3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 19/5 → 4/1 | note:F3 ]",
+  "[ 19/5 → 4/1 | note:G3 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
 exports[`runs examples > example "stackRight" example index 0 1`] = `
 [
   "[ 0/1 → 1/15 | note:G3 ]",

From 4d0a4902ab848ea41f1ea8fc6aecd65bcbb6bf47 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sun, 22 Feb 2026 17:42:09 -0500
Subject: [PATCH 11/31] enable stack variants to be chained

---
 packages/core/pattern.mjs                 |  28 +++
 test/__snapshots__/examples.test.mjs.snap | 244 ++++++++++++++++++++++
 2 files changed, 272 insertions(+)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 65804a262..f666dda87 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -850,6 +850,22 @@ export class Pattern {
     return stack(this, ...pats);
   }
 
+  stackLeft(...pats) {
+    return stackLeft(this, ...pats);
+  }
+
+  stackRight(...pats) {
+    return stackRight(this, ...pats);
+  }
+
+  stackCentre(...pats) {
+    return stackCentre(this, ...pats);
+  }
+
+  stackRepeat(...pats) {
+    return stackRepeat(this, ...pats);
+  }
+
   sequence(...pats) {
     return sequence(this, ...pats);
   }
@@ -1527,6 +1543,9 @@ function _stackWith(func, pats) {
  * @return {Pattern}
  * @example
  * stackLeft("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ * @example
+ * // chainable
+ * "0 1 2 3".stackLeft("3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
  */
 export function stackLeft(...pats) {
   return _stackWith(
@@ -1543,6 +1562,9 @@ export function stackLeft(...pats) {
  * @return {Pattern}
  * @example
  * stackRight("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ * @example
+ * // chainable
+ * "0 1 2 3".stackRight("3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
  */
 export function stackRight(...pats) {
   return _stackWith(
@@ -1559,6 +1581,9 @@ export function stackRight(...pats) {
  * @return {Pattern}
  * @example
  * stackCentre("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ * @example
+ * // chainable
+ * "0 1 2 3".stackCentre("3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
  */
 export function stackCentre(...pats) {
   return _stackWith(
@@ -1585,6 +1610,9 @@ export function stackCenter(pats) {
  * @return {Pattern}
  * @example
  * stackRepeat("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ * @example
+ * // chainable
+ * "0 1 2 3".stackRepeat("3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
  */
 export function stackRepeat(...pats) {
   return stackBy(reify('repeat'), ...pats);
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index a4d4e2536..c4d616cee 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -12751,6 +12751,63 @@ exports[`runs examples > example "stackCentre" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "stackCentre" example index 1 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 1/10 → 3/10 | note:C3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 3/10 → 1/2 | note:D3 ]",
+  "[ 3/10 → 1/2 | note:F3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 1/2 → 7/10 | note:Eb3 ]",
+  "[ 1/2 → 7/10 | note:G3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 7/10 → 9/10 | note:F3 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 11/10 → 13/10 | note:C3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 13/10 → 3/2 | note:D3 ]",
+  "[ 13/10 → 3/2 | note:F3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 3/2 → 17/10 | note:Eb3 ]",
+  "[ 3/2 → 17/10 | note:G3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 17/10 → 19/10 | note:F3 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 21/10 → 23/10 | note:C3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 23/10 → 5/2 | note:D3 ]",
+  "[ 23/10 → 5/2 | note:F3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 5/2 → 27/10 | note:Eb3 ]",
+  "[ 5/2 → 27/10 | note:G3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 27/10 → 29/10 | note:F3 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 31/10 → 33/10 | note:C3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 33/10 → 7/2 | note:D3 ]",
+  "[ 33/10 → 7/2 | note:F3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 7/2 → 37/10 | note:Eb3 ]",
+  "[ 7/2 → 37/10 | note:G3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 37/10 → 39/10 | note:F3 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
 exports[`runs examples > example "stackLeft" example index 0 1`] = `
 [
   "[ 0/1 → 1/15 | note:G3 ]",
@@ -12808,6 +12865,63 @@ exports[`runs examples > example "stackLeft" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "stackLeft" example index 1 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 0/1 → 1/5 | note:C3 ]",
+  "[ 0/1 → 1/5 | note:F3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:D3 ]",
+  "[ 1/5 → 2/5 | note:G3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 2/5 → 3/5 | note:Eb3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 3/5 → 4/5 | note:F3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 1/1 → 6/5 | note:C3 ]",
+  "[ 1/1 → 6/5 | note:F3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:D3 ]",
+  "[ 6/5 → 7/5 | note:G3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 7/5 → 8/5 | note:Eb3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 8/5 → 9/5 | note:F3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 2/1 → 11/5 | note:C3 ]",
+  "[ 2/1 → 11/5 | note:F3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:D3 ]",
+  "[ 11/5 → 12/5 | note:G3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 12/5 → 13/5 | note:Eb3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 13/5 → 14/5 | note:F3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 3/1 → 16/5 | note:C3 ]",
+  "[ 3/1 → 16/5 | note:F3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:D3 ]",
+  "[ 16/5 → 17/5 | note:G3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 17/5 → 18/5 | note:Eb3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 18/5 → 19/5 | note:F3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
 exports[`runs examples > example "stackRepeat" example index 0 1`] = `
 [
   "[ 0/1 → 1/15 | note:G3 ]",
@@ -12881,6 +12995,79 @@ exports[`runs examples > example "stackRepeat" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "stackRepeat" example index 1 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 0/1 → 1/5 | note:C3 ]",
+  "[ 0/1 → 1/5 | note:F3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:D3 ]",
+  "[ 1/5 → 2/5 | note:G3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 2/5 → 3/5 | note:Eb3 ]",
+  "[ 2/5 → 3/5 | note:F3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 3/5 → 4/5 | note:F3 ]",
+  "[ 3/5 → 4/5 | note:G3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 4/5 → 1/1 | note:C3 ]",
+  "[ 4/5 → 1/1 | note:F3 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 1/1 → 6/5 | note:D3 ]",
+  "[ 1/1 → 6/5 | note:G3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:Eb3 ]",
+  "[ 6/5 → 7/5 | note:F3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 7/5 → 8/5 | note:F3 ]",
+  "[ 7/5 → 8/5 | note:G3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 8/5 → 9/5 | note:C3 ]",
+  "[ 8/5 → 9/5 | note:F3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 9/5 → 2/1 | note:D3 ]",
+  "[ 9/5 → 2/1 | note:G3 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 2/1 → 11/5 | note:Eb3 ]",
+  "[ 2/1 → 11/5 | note:F3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:F3 ]",
+  "[ 11/5 → 12/5 | note:G3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 12/5 → 13/5 | note:C3 ]",
+  "[ 12/5 → 13/5 | note:F3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 13/5 → 14/5 | note:D3 ]",
+  "[ 13/5 → 14/5 | note:G3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 14/5 → 3/1 | note:Eb3 ]",
+  "[ 14/5 → 3/1 | note:F3 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 3/1 → 16/5 | note:F3 ]",
+  "[ 3/1 → 16/5 | note:G3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:C3 ]",
+  "[ 16/5 → 17/5 | note:F3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 17/5 → 18/5 | note:D3 ]",
+  "[ 17/5 → 18/5 | note:G3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 18/5 → 19/5 | note:Eb3 ]",
+  "[ 18/5 → 19/5 | note:F3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 19/5 → 4/1 | note:F3 ]",
+  "[ 19/5 → 4/1 | note:G3 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
 exports[`runs examples > example "stackRight" example index 0 1`] = `
 [
   "[ 0/1 → 1/15 | note:G3 ]",
@@ -12938,6 +13125,63 @@ exports[`runs examples > example "stackRight" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "stackRight" example index 1 1`] = `
+[
+  "[ 0/1 → 1/15 | note:G3 ]",
+  "[ 1/15 → 2/15 | note:Ab3 ]",
+  "[ 2/15 → 1/5 | note:Bb3 ]",
+  "[ 1/5 → 2/5 | note:C3 ]",
+  "[ 1/5 → 2/5 | note:C4 ]",
+  "[ 2/5 → 3/5 | note:D3 ]",
+  "[ 2/5 → 3/5 | note:D4 ]",
+  "[ 3/5 → 4/5 | note:Eb3 ]",
+  "[ 3/5 → 4/5 | note:F3 ]",
+  "[ 3/5 → 4/5 | note:Eb4 ]",
+  "[ 4/5 → 1/1 | note:F3 ]",
+  "[ 4/5 → 1/1 | note:G3 ]",
+  "[ 4/5 → 1/1 | note:F4 ]",
+  "[ 1/1 → 16/15 | note:G3 ]",
+  "[ 16/15 → 17/15 | note:Ab3 ]",
+  "[ 17/15 → 6/5 | note:Bb3 ]",
+  "[ 6/5 → 7/5 | note:C3 ]",
+  "[ 6/5 → 7/5 | note:C4 ]",
+  "[ 7/5 → 8/5 | note:D3 ]",
+  "[ 7/5 → 8/5 | note:D4 ]",
+  "[ 8/5 → 9/5 | note:Eb3 ]",
+  "[ 8/5 → 9/5 | note:F3 ]",
+  "[ 8/5 → 9/5 | note:Eb4 ]",
+  "[ 9/5 → 2/1 | note:F3 ]",
+  "[ 9/5 → 2/1 | note:G3 ]",
+  "[ 9/5 → 2/1 | note:F4 ]",
+  "[ 2/1 → 31/15 | note:G3 ]",
+  "[ 31/15 → 32/15 | note:Ab3 ]",
+  "[ 32/15 → 11/5 | note:Bb3 ]",
+  "[ 11/5 → 12/5 | note:C3 ]",
+  "[ 11/5 → 12/5 | note:C4 ]",
+  "[ 12/5 → 13/5 | note:D3 ]",
+  "[ 12/5 → 13/5 | note:D4 ]",
+  "[ 13/5 → 14/5 | note:Eb3 ]",
+  "[ 13/5 → 14/5 | note:F3 ]",
+  "[ 13/5 → 14/5 | note:Eb4 ]",
+  "[ 14/5 → 3/1 | note:F3 ]",
+  "[ 14/5 → 3/1 | note:G3 ]",
+  "[ 14/5 → 3/1 | note:F4 ]",
+  "[ 3/1 → 46/15 | note:G3 ]",
+  "[ 46/15 → 47/15 | note:Ab3 ]",
+  "[ 47/15 → 16/5 | note:Bb3 ]",
+  "[ 16/5 → 17/5 | note:C3 ]",
+  "[ 16/5 → 17/5 | note:C4 ]",
+  "[ 17/5 → 18/5 | note:D3 ]",
+  "[ 17/5 → 18/5 | note:D4 ]",
+  "[ 18/5 → 19/5 | note:Eb3 ]",
+  "[ 18/5 → 19/5 | note:F3 ]",
+  "[ 18/5 → 19/5 | note:Eb4 ]",
+  "[ 19/5 → 4/1 | note:F3 ]",
+  "[ 19/5 → 4/1 | note:G3 ]",
+  "[ 19/5 → 4/1 | note:F4 ]",
+]
+`;
+
 exports[`runs examples > example "stepalt" example index 0 1`] = `
 [
   "[ 0/1 → 1/5 | s:bd ]",

From aedd7de2df0c659091467f1324c7e59c64e42b1e Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Mon, 23 Feb 2026 17:00:29 -0500
Subject: [PATCH 12/31] getDur doc fix

---
 missingExamples                           | 71 +++++++++++++++++++++++
 packages/superdough/sampler.mjs           |  5 +-
 test/__snapshots__/examples.test.mjs.snap |  9 +++
 3 files changed, 83 insertions(+), 2 deletions(-)
 create mode 100644 missingExamples

diff --git a/missingExamples b/missingExamples
new file mode 100644
index 000000000..e14c770ff
--- /dev/null
+++ b/missingExamples
@@ -0,0 +1,71 @@
+(manually filled out)
+
+aliasBank
+appBoth, appLeft, appRight, appWhole
+applyGradualLowpass
+applyHannWindow
+asNumber
+bpdc
+bpdepth
+brak
+bpsync
+ccn
+ccv
+channel
+chebyshev
+chooseInWith
+chyx
+computeMagnitudes
+createCC
+crossfade
+csoundm
+cubic
+findPeaks
+fmrelease
+fold
+generateGraph
+generateReverb
+getFrequency (rendered weird rn)
+hard
+hpdc
+hprate
+hpshape
+hpskew
+hpsync
+inhabitmod
+lpshape
+lpskew
+parray
+pickAndRename
+pickmod
+pickmodF
+pickmodOut
+pickmodReset
+pickOut
+pickReset
+pickRestart
+sequenceP
+sinefold
+slider
+soundAlias
+source
+tables
+time
+warpattack
+warpdc
+warpdecay
+warpdepth
+warpenv
+warprate
+warpshape
+warpskew
+warpsustain
+warpsync
+withHap
+withHaps
+withContext
+withHapSpan
+withHapTime
+within
+withLoc
+withSeed
\ No newline at end of file
diff --git a/packages/superdough/sampler.mjs b/packages/superdough/sampler.mjs
index d45e1050b..c4b39b469 100644
--- a/packages/superdough/sampler.mjs
+++ b/packages/superdough/sampler.mjs
@@ -36,8 +36,9 @@ function humanFileSize(bytes, si) {
  *
  * Note: `must` be called with await, otherwise you'll get a pending Promise object.
  *
- * @name getDuration,getDur
- * @tag samples
+ * @name getDuration
+ * @synonym getDur
+ * @tags samples
  * @param {string} sampleName
  * @param {number} (optional) n
  *
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index c4d616cee..13498f734 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -5340,6 +5340,15 @@ exports[`runs examples > example "getDur" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "getDuration" example index 0 1`] = `
+[
+  "[ 0/1 → 1/1 | s:sax cps:null ]",
+  "[ 1/1 → 2/1 | s:sax cps:null ]",
+  "[ 2/1 → 3/1 | s:sax cps:null ]",
+  "[ 3/1 → 4/1 | s:sax cps:null ]",
+]
+`;
+
 exports[`runs examples > example "grow" example index 0 1`] = `
 [
   "[ 0/1 → 1/10 | s:tha bank:mridangam ]",

From 70213a26ae0730a0608bcc6f4ba50c02e97d15e0 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Mon, 23 Feb 2026 17:21:27 -0500
Subject: [PATCH 13/31] added some examples to things

---
 packages/core/pattern.mjs                 |  4 +++
 packages/core/pick.mjs                    |  2 ++
 packages/core/util.mjs                    |  8 +++++-
 test/__snapshots__/examples.test.mjs.snap | 30 ++++++++++++++++-------
 4 files changed, 34 insertions(+), 10 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index f666dda87..318847752 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -2532,8 +2532,12 @@ export const off = register('off', function (time_pat, func, pat) {
  * Returns a new pattern where every other cycle is played once, twice as
  * fast, and offset in time by one quarter of a cycle. Creates a kind of
  * breakbeat feel.
+ * @name brak
  * @tags temporal
  * @returns Pattern
+ * @memberof Pattern
+ * @example
+ * s("bd hh!2 rim").brak()
  */
 export const brak = register('brak', function (pat) {
   return pat.when(slowcat(false, true), (x) => fastcat(x, silence)._late(0.25));
diff --git a/packages/core/pick.mjs b/packages/core/pick.mjs
index 3974c695b..35bd5fc2c 100644
--- a/packages/core/pick.mjs
+++ b/packages/core/pick.mjs
@@ -104,6 +104,8 @@ export const pickmodF = register('pickmodF', function (pickPattern, lookup, pat)
  * @param {Pattern} pat
  * @param {*} xs
  * @returns {Pattern}
+ * @example
+ * note("<0*4 1 2*2 3*3>".pickOut(["g a", "e f", "f g f g" , "g c d"]))
  */
 export const pickOut = register('pickOut', function (lookup, pat) {
   return _pick(lookup, pat, false).outerJoin();
diff --git a/packages/core/util.mjs b/packages/core/util.mjs
index 2f499adae..65baf724e 100644
--- a/packages/core/util.mjs
+++ b/packages/core/util.mjs
@@ -121,16 +121,22 @@ export const getPlayableNoteValue = (hap) => {
 
 /**
  * Given a hap, returns the frequency of the note or freq, if defined
+ * 
  * Given a note, returns the frequency of that note
  * `getFreq('c3')`
+ * 
  * Given a midi note number, returns the frequency of that midi note
  * `getFreq('c3')`
  *
  * @name getFrequency
  * @tags pitch
  * @synonyms getFreq
- * @param {Hap | note | number}
+ * @param {Hap | note | number} input
  * @returns {Number}
+ * @example
+ * i("4 8 9 10 - - 5 7 9 11 - -").tune("tranh3")
+ * .mul(getFreq('c3'))
+ * .freq().clip(.5).room(1)
  */
 export const getFrequency = (hap) => {
   let { value, context } =
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 13498f734..163d5e8b3 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -1798,6 +1798,27 @@ exports[`runs examples > example "bpsustain" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "brak" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | s:bd ]",
+  "[ 1/4 → 1/2 | s:hh ]",
+  "[ 1/2 → 3/4 | s:hh ]",
+  "[ 3/4 → 1/1 | s:rim ]",
+  "[ 5/4 → 11/8 | s:bd ]",
+  "[ 11/8 → 3/2 | s:hh ]",
+  "[ 3/2 → 13/8 | s:hh ]",
+  "[ 13/8 → 7/4 | s:rim ]",
+  "[ 2/1 → 9/4 | s:bd ]",
+  "[ 9/4 → 5/2 | s:hh ]",
+  "[ 5/2 → 11/4 | s:hh ]",
+  "[ 11/4 → 3/1 | s:rim ]",
+  "[ 13/4 → 27/8 | s:bd ]",
+  "[ 27/8 → 7/2 | s:hh ]",
+  "[ 7/2 → 29/8 | s:hh ]",
+  "[ 29/8 → 15/4 | s:rim ]",
+]
+`;
+
 exports[`runs examples > example "brand" example index 0 1`] = `
 [
   "[ 0/1 → 1/10 | s:hh pan:true ]",
@@ -5331,15 +5352,6 @@ exports[`runs examples > example "gain" example index 0 1`] = `
 
 exports[`runs examples > example "gap" example index 0 1`] = `[]`;
 
-exports[`runs examples > example "getDur" example index 0 1`] = `
-[
-  "[ 0/1 → 1/1 | s:sax cps:null ]",
-  "[ 1/1 → 2/1 | s:sax cps:null ]",
-  "[ 2/1 → 3/1 | s:sax cps:null ]",
-  "[ 3/1 → 4/1 | s:sax cps:null ]",
-]
-`;
-
 exports[`runs examples > example "getDuration" example index 0 1`] = `
 [
   "[ 0/1 → 1/1 | s:sax cps:null ]",

From e5a08091f1632b97438af1e7331eb6e2059e6f55 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Mon, 23 Feb 2026 17:21:57 -0500
Subject: [PATCH 14/31] format

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

diff --git a/packages/core/util.mjs b/packages/core/util.mjs
index 65baf724e..6a8936e55 100644
--- a/packages/core/util.mjs
+++ b/packages/core/util.mjs
@@ -121,10 +121,10 @@ export const getPlayableNoteValue = (hap) => {
 
 /**
  * Given a hap, returns the frequency of the note or freq, if defined
- * 
+ *
  * Given a note, returns the frequency of that note
  * `getFreq('c3')`
- * 
+ *
  * Given a midi note number, returns the frequency of that midi note
  * `getFreq('c3')`
  *

From 44ec79182ede1d1aa297e149f8c4c8e15e3414f4 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Mon, 23 Feb 2026 20:06:38 -0500
Subject: [PATCH 15/31] added examples to withHap and withHaps

---
 packages/core/pattern.mjs                 |  21 ++++
 test/__snapshots__/examples.test.mjs.snap | 113 ++++++++++++++++++++++
 2 files changed, 134 insertions(+)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 318847752..f88c4159a 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -508,6 +508,16 @@ export class Pattern {
    * @param {Function} func
    * @returns Pattern
    * @noAutocomplete
+   * @example
+   * note("[a b, c d] a b c d").s("gm_piano").withHaps(x=>{
+   *   if (x.length > 1) {
+   *     x.map(hap=>{
+   *       // select gm_piano:1 sample
+   *       hap.value.n = 1
+   *     })
+   *   }
+   *   return x
+   * })
    */
   withHaps(func) {
     const result = new Pattern((state) => func(this.query(state), state));
@@ -521,6 +531,17 @@ export class Pattern {
    * @param {Function} func
    * @returns Pattern
    * @noAutocomplete
+   * @example
+   * note("c a f e").withHap(x=>{
+   *   if (x.value.note == 'c') {
+   *     x.value.s = 'gm_piano'
+   *   }
+   *   else {
+   *     x.value.s = 'gm_piano'
+   *     x.value.n = 2
+   *   }
+   *   return x
+   * })
    */
   withHap(func) {
     return this.withHaps((haps) => haps.map(func));
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 163d5e8b3..551f80cd0 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -5361,6 +5361,43 @@ exports[`runs examples > example "getDuration" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "getFrequency" example index 0 1`] = `
+[
+  "[ 0/1 → 1/12 | freq:{i:4} clip:0.5 room:1 ]",
+  "[ 1/12 → 1/6 | freq:{i:8} clip:0.5 room:1 ]",
+  "[ 1/6 → 1/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 1/4 → 1/3 | freq:{i:10} clip:0.5 room:1 ]",
+  "[ 1/2 → 7/12 | freq:{i:5} clip:0.5 room:1 ]",
+  "[ 7/12 → 2/3 | freq:{i:7} clip:0.5 room:1 ]",
+  "[ 2/3 → 3/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 3/4 → 5/6 | freq:{i:11} clip:0.5 room:1 ]",
+  "[ 1/1 → 13/12 | freq:{i:4} clip:0.5 room:1 ]",
+  "[ 13/12 → 7/6 | freq:{i:8} clip:0.5 room:1 ]",
+  "[ 7/6 → 5/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 5/4 → 4/3 | freq:{i:10} clip:0.5 room:1 ]",
+  "[ 3/2 → 19/12 | freq:{i:5} clip:0.5 room:1 ]",
+  "[ 19/12 → 5/3 | freq:{i:7} clip:0.5 room:1 ]",
+  "[ 5/3 → 7/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 7/4 → 11/6 | freq:{i:11} clip:0.5 room:1 ]",
+  "[ 2/1 → 25/12 | freq:{i:4} clip:0.5 room:1 ]",
+  "[ 25/12 → 13/6 | freq:{i:8} clip:0.5 room:1 ]",
+  "[ 13/6 → 9/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 9/4 → 7/3 | freq:{i:10} clip:0.5 room:1 ]",
+  "[ 5/2 → 31/12 | freq:{i:5} clip:0.5 room:1 ]",
+  "[ 31/12 → 8/3 | freq:{i:7} clip:0.5 room:1 ]",
+  "[ 8/3 → 11/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 11/4 → 17/6 | freq:{i:11} clip:0.5 room:1 ]",
+  "[ 3/1 → 37/12 | freq:{i:4} clip:0.5 room:1 ]",
+  "[ 37/12 → 19/6 | freq:{i:8} clip:0.5 room:1 ]",
+  "[ 19/6 → 13/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 13/4 → 10/3 | freq:{i:10} clip:0.5 room:1 ]",
+  "[ 7/2 → 43/12 | freq:{i:5} clip:0.5 room:1 ]",
+  "[ 43/12 → 11/3 | freq:{i:7} clip:0.5 room:1 ]",
+  "[ 11/3 → 15/4 | freq:{i:9} clip:0.5 room:1 ]",
+  "[ 15/4 → 23/6 | freq:{i:11} clip:0.5 room:1 ]",
+]
+`;
+
 exports[`runs examples > example "grow" example index 0 1`] = `
 [
   "[ 0/1 → 1/10 | s:tha bank:mridangam ]",
@@ -9150,6 +9187,24 @@ exports[`runs examples > example "pickF" example index 2 1`] = `
 ]
 `;
 
+exports[`runs examples > example "pickOut" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | note:g ]",
+  "[ 1/4 → 1/2 | note:g ]",
+  "[ 1/2 → 3/4 | note:a ]",
+  "[ 3/4 → 1/1 | note:a ]",
+  "[ (1/1 → 3/2) ⇝ 2/1 | note:e ]",
+  "[ 1/1 ⇜ (3/2 → 2/1) | note:f ]",
+  "[ (2/1 → 9/4) ⇝ 5/2 | note:f ]",
+  "[ 2/1 ⇜ (9/4 → 5/2) | note:g ]",
+  "[ (5/2 → 11/4) ⇝ 3/1 | note:f ]",
+  "[ 5/2 ⇜ (11/4 → 3/1) | note:g ]",
+  "[ 3/1 → 10/3 | note:g ]",
+  "[ 10/3 → 11/3 | note:c ]",
+  "[ 11/3 → 4/1 | note:d ]",
+]
+`;
+
 exports[`runs examples > example "pickmodRestart" example index 0 1`] = `
 [
   "[ 0/1 → 1/4 | note:C3 s:piano ]",
@@ -15288,6 +15343,64 @@ exports[`runs examples > example "withBase" example index 1 1`] = `
 ]
 `;
 
+exports[`runs examples > example "withHap" example index 0 1`] = `
+[
+  "[ 0/1 → 1/4 | note:c s:gm_piano ]",
+  "[ 1/4 → 1/2 | note:a s:gm_piano n:2 ]",
+  "[ 1/2 → 3/4 | note:f s:gm_piano n:2 ]",
+  "[ 3/4 → 1/1 | note:e s:gm_piano n:2 ]",
+  "[ 1/1 → 5/4 | note:c s:gm_piano ]",
+  "[ 5/4 → 3/2 | note:a s:gm_piano n:2 ]",
+  "[ 3/2 → 7/4 | note:f s:gm_piano n:2 ]",
+  "[ 7/4 → 2/1 | note:e s:gm_piano n:2 ]",
+  "[ 2/1 → 9/4 | note:c s:gm_piano ]",
+  "[ 9/4 → 5/2 | note:a s:gm_piano n:2 ]",
+  "[ 5/2 → 11/4 | note:f s:gm_piano n:2 ]",
+  "[ 11/4 → 3/1 | note:e s:gm_piano n:2 ]",
+  "[ 3/1 → 13/4 | note:c s:gm_piano ]",
+  "[ 13/4 → 7/2 | note:a s:gm_piano n:2 ]",
+  "[ 7/2 → 15/4 | note:f s:gm_piano n:2 ]",
+  "[ 15/4 → 4/1 | note:e s:gm_piano n:2 ]",
+]
+`;
+
+exports[`runs examples > example "withHaps" example index 0 1`] = `
+[
+  "[ 0/1 → 1/10 | note:a s:gm_piano n:1 ]",
+  "[ 0/1 → 1/10 | note:c s:gm_piano n:1 ]",
+  "[ 1/10 → 1/5 | note:b s:gm_piano n:1 ]",
+  "[ 1/10 → 1/5 | note:d s:gm_piano n:1 ]",
+  "[ 1/5 → 2/5 | note:a s:gm_piano n:1 ]",
+  "[ 2/5 → 3/5 | note:b s:gm_piano n:1 ]",
+  "[ 3/5 → 4/5 | note:c s:gm_piano n:1 ]",
+  "[ 4/5 → 1/1 | note:d s:gm_piano n:1 ]",
+  "[ 1/1 → 11/10 | note:a s:gm_piano n:1 ]",
+  "[ 1/1 → 11/10 | note:c s:gm_piano n:1 ]",
+  "[ 11/10 → 6/5 | note:b s:gm_piano n:1 ]",
+  "[ 11/10 → 6/5 | note:d s:gm_piano n:1 ]",
+  "[ 6/5 → 7/5 | note:a s:gm_piano n:1 ]",
+  "[ 7/5 → 8/5 | note:b s:gm_piano n:1 ]",
+  "[ 8/5 → 9/5 | note:c s:gm_piano n:1 ]",
+  "[ 9/5 → 2/1 | note:d s:gm_piano n:1 ]",
+  "[ 2/1 → 21/10 | note:a s:gm_piano n:1 ]",
+  "[ 2/1 → 21/10 | note:c s:gm_piano n:1 ]",
+  "[ 21/10 → 11/5 | note:b s:gm_piano n:1 ]",
+  "[ 21/10 → 11/5 | note:d s:gm_piano n:1 ]",
+  "[ 11/5 → 12/5 | note:a s:gm_piano n:1 ]",
+  "[ 12/5 → 13/5 | note:b s:gm_piano n:1 ]",
+  "[ 13/5 → 14/5 | note:c s:gm_piano n:1 ]",
+  "[ 14/5 → 3/1 | note:d s:gm_piano n:1 ]",
+  "[ 3/1 → 31/10 | note:a s:gm_piano n:1 ]",
+  "[ 3/1 → 31/10 | note:c s:gm_piano n:1 ]",
+  "[ 31/10 → 16/5 | note:b s:gm_piano n:1 ]",
+  "[ 31/10 → 16/5 | note:d s:gm_piano n:1 ]",
+  "[ 16/5 → 17/5 | note:a s:gm_piano n:1 ]",
+  "[ 17/5 → 18/5 | note:b s:gm_piano n:1 ]",
+  "[ 18/5 → 19/5 | note:c s:gm_piano n:1 ]",
+  "[ 19/5 → 4/1 | note:d s:gm_piano n:1 ]",
+]
+`;
+
 exports[`runs examples > example "withValue" example index 0 1`] = `
 [
   "[ 0/1 → 1/3 | 10 ]",

From 37d052a655fd038c0437854c5d62256e85b81f91 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Tue, 24 Feb 2026 01:51:38 -0500
Subject: [PATCH 16/31] Change "tidal" to "strudel" in docs

---
 website/src/pages/technical-manual/patterns.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/src/pages/technical-manual/patterns.mdx b/website/src/pages/technical-manual/patterns.mdx
index 49ede526c..eadaf8786 100644
--- a/website/src/pages/technical-manual/patterns.mdx
+++ b/website/src/pages/technical-manual/patterns.mdx
@@ -8,7 +8,7 @@ import { JsDoc } from '../../docs/JsDoc';
 
 # Patterns
 
-Patterns are the essence of Tidal. Its patterns are abstract entities that represent flows of time as functions, adapting a technique called pure functional reactive programming. Taking a time span as its input, a Pattern can output a set of events that happen within that time span. It depends on the structure of the Pattern how the events are located in time.
+Patterns are the essence of Strudel (and Tidal). Its patterns are abstract entities that represent flows of time as functions, adapting a technique called pure functional reactive programming. Taking a time span as its input, a Pattern can output a set of events that happen within that time span. It depends on the structure of the Pattern how the events are located in time.
 From now on, this process of generating events from a time span will be called **querying**.
 Example:
 

From 36a456eeb4ffe40063f5ffbbbd86c0fff55f2686 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 28 Feb 2026 14:43:04 -0500
Subject: [PATCH 17/31] Update replicate and extend examples to show difference

---
 packages/core/pattern.mjs                 |  9 +++------
 test/__snapshots__/examples.test.mjs.snap | 10 +++++-----
 2 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index f88c4159a..594aab7a8 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -3396,7 +3396,7 @@ export const drop = stepRegister('drop', function (i, pat) {
  * @tags stepwise
  * @example
  * stepcat(
- *   sound("bd bd - cp").extend(2),
+ *   sound("bd bd - <cp hh>").extend(2),
  *   sound("bd - sd -")
  * ).pace(8)
  */
@@ -3407,15 +3407,12 @@ export const extend = stepRegister('extend', function (factor, pat) {
 /**
  * *Experimental*
  *
- * `replicate` is similar to `fast` in that it increases its density, but it also increases the step count
- * accordingly. So `stepcat("a b".replicate(2), "c d")` would be the same as `"a b a b c d"`, whereas
- * `stepcat("a b".fast(2), "c d")` would be the same as `"[a b] [a b] c d"`.
+ * `replicate` is similar to `extend`, except that `replicate` will "replicate" the thing being extended. This will only differ from `extend` when the input pattern differs from cycle to cycle.
  *
- * TODO: find out how this function differs from extend
  * @tags stepwise
  * @example
  * stepcat(
- *   sound("bd bd - cp").replicate(2),
+ *   sound("bd bd - <cp hh>").replicate(2),
  *   sound("bd - sd -")
  * ).pace(8)
  */
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 551f80cd0..dbf94bf76 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -4371,7 +4371,7 @@ exports[`runs examples > example "extend" example index 0 1`] = `
   "[ 3/8 → 1/2 | s:cp ]",
   "[ 1/2 → 5/8 | s:bd ]",
   "[ 5/8 → 3/4 | s:bd ]",
-  "[ 7/8 → 1/1 | s:cp ]",
+  "[ 7/8 → 1/1 | s:hh ]",
   "[ 1/1 → 9/8 | s:bd ]",
   "[ 5/4 → 11/8 | s:sd ]",
   "[ 3/2 → 13/8 | s:bd ]",
@@ -4379,7 +4379,7 @@ exports[`runs examples > example "extend" example index 0 1`] = `
   "[ 15/8 → 2/1 | s:cp ]",
   "[ 2/1 → 17/8 | s:bd ]",
   "[ 17/8 → 9/4 | s:bd ]",
-  "[ 19/8 → 5/2 | s:cp ]",
+  "[ 19/8 → 5/2 | s:hh ]",
   "[ 5/2 → 21/8 | s:bd ]",
   "[ 11/4 → 23/8 | s:sd ]",
   "[ 3/1 → 25/8 | s:bd ]",
@@ -4387,7 +4387,7 @@ exports[`runs examples > example "extend" example index 0 1`] = `
   "[ 27/8 → 7/2 | s:cp ]",
   "[ 7/2 → 29/8 | s:bd ]",
   "[ 29/8 → 15/4 | s:bd ]",
-  "[ 31/8 → 4/1 | s:cp ]",
+  "[ 31/8 → 4/1 | s:hh ]",
 ]
 `;
 
@@ -10148,10 +10148,10 @@ exports[`runs examples > example "replicate" example index 0 1`] = `
   "[ 5/4 → 11/8 | s:sd ]",
   "[ 3/2 → 13/8 | s:bd ]",
   "[ 13/8 → 7/4 | s:bd ]",
-  "[ 15/8 → 2/1 | s:cp ]",
+  "[ 15/8 → 2/1 | s:hh ]",
   "[ 2/1 → 17/8 | s:bd ]",
   "[ 17/8 → 9/4 | s:bd ]",
-  "[ 19/8 → 5/2 | s:cp ]",
+  "[ 19/8 → 5/2 | s:hh ]",
   "[ 5/2 → 21/8 | s:bd ]",
   "[ 11/4 → 23/8 | s:sd ]",
   "[ 3/1 → 25/8 | s:bd ]",

From ee4b8fa315a0c7a36905e838650c2511085895eb Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sat, 28 Feb 2026 14:46:01 -0500
Subject: [PATCH 18/31] cleanup

---
 missingExamples | 71 -------------------------------------------------
 1 file changed, 71 deletions(-)
 delete mode 100644 missingExamples

diff --git a/missingExamples b/missingExamples
deleted file mode 100644
index e14c770ff..000000000
--- a/missingExamples
+++ /dev/null
@@ -1,71 +0,0 @@
-(manually filled out)
-
-aliasBank
-appBoth, appLeft, appRight, appWhole
-applyGradualLowpass
-applyHannWindow
-asNumber
-bpdc
-bpdepth
-brak
-bpsync
-ccn
-ccv
-channel
-chebyshev
-chooseInWith
-chyx
-computeMagnitudes
-createCC
-crossfade
-csoundm
-cubic
-findPeaks
-fmrelease
-fold
-generateGraph
-generateReverb
-getFrequency (rendered weird rn)
-hard
-hpdc
-hprate
-hpshape
-hpskew
-hpsync
-inhabitmod
-lpshape
-lpskew
-parray
-pickAndRename
-pickmod
-pickmodF
-pickmodOut
-pickmodReset
-pickOut
-pickReset
-pickRestart
-sequenceP
-sinefold
-slider
-soundAlias
-source
-tables
-time
-warpattack
-warpdc
-warpdecay
-warpdepth
-warpenv
-warprate
-warpshape
-warpskew
-warpsustain
-warpsync
-withHap
-withHaps
-withContext
-withHapSpan
-withHapTime
-within
-withLoc
-withSeed
\ No newline at end of file

From 1ef39a2ea7ed3ea706c96bf2a9e9ba97daecb0ab Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sun, 1 Mar 2026 12:42:13 -0500
Subject: [PATCH 19/31] small fixes

---
 website/src/pages/learn/signals.mdx             | 8 ++++++++
 website/src/pages/technical-manual/patterns.mdx | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/website/src/pages/learn/signals.mdx b/website/src/pages/learn/signals.mdx
index 527e42bef..501135b29 100644
--- a/website/src/pages/learn/signals.mdx
+++ b/website/src/pages/learn/signals.mdx
@@ -55,6 +55,14 @@ There is also `saw2`, `sine2`, `cosine2`, `tri2`, `square2` and `rand2` which ha
 
 <JsDoc client:idle name="brandBy" h={0} />
 
+## time
+
+<JsDoc client:idle name="time" h={0} />
+
+## creating your own signal
+
+<JsDoc client:idle name="signal" h={0} />
+
 ## mouseX
 
 <JsDoc client:idle name="mousex" h={0} />
diff --git a/website/src/pages/technical-manual/patterns.mdx b/website/src/pages/technical-manual/patterns.mdx
index eadaf8786..da97b2157 100644
--- a/website/src/pages/technical-manual/patterns.mdx
+++ b/website/src/pages/technical-manual/patterns.mdx
@@ -8,7 +8,7 @@ import { JsDoc } from '../../docs/JsDoc';
 
 # Patterns
 
-Patterns are the essence of Strudel (and Tidal). Its patterns are abstract entities that represent flows of time as functions, adapting a technique called pure functional reactive programming. Taking a time span as its input, a Pattern can output a set of events that happen within that time span. It depends on the structure of the Pattern how the events are located in time.
+Patterns are the essence of Uzu languages such as Strudel and Tidal. Its patterns are abstract entities that represent flows of time as functions, adapting a technique called pure functional reactive programming. Taking a time span as its input, a Pattern can output a set of events that happen within that time span. It depends on the structure of the Pattern how the events are located in time.
 From now on, this process of generating events from a time span will be called **querying**.
 Example:
 

From e502a3c3e5c5d8b8477be8e86d9fe6a27b615ea4 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Sun, 8 Mar 2026 19:06:49 -0400
Subject: [PATCH 20/31] change bus tags s.t. it appears in reference

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

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index d22167c0c..ac0b26c7c 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2226,7 +2226,7 @@ export const { orbit } = registerControl('orbit', 'o');
  *   otherPat.bmod(..) (to modulate another pattern with the bus)
  *
  * @name bus
- * @tags superdirt
+ * @tags superdough
  * @param {number | Pattern} number
  */
 export const { bus } = registerControl('bus');
@@ -2235,7 +2235,7 @@ export const { bus } = registerControl('bus');
  * Postgain multiplier prior to sending the signal to the audio bus.
  *
  * @name busgain
- * @tags superdirt
+ * @tags superdough
  * @synonyms bgain
  * @param {number | Pattern} number
  */

From 581bbc05fc6c7a820b2e307e747cf3a6a9f3a1f7 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 11 Mar 2026 15:24:30 -0400
Subject: [PATCH 21/31] room isn't a 0-1 value

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

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index ac0b26c7c..19e4d5ae7 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -2370,7 +2370,7 @@ export const { mode } = registerControl(['mode', 'anchor']);
  *
  * @name room
  * @tags orbit, superdough
- * @param {number | Pattern} level between 0 and 1
+ * @param {number | Pattern} level
  * @example
  * s("bd sd [~ bd] sd").room("<0 .2 .4 .6 .8 1>")
  * @example

From 8ad767363f979ea2c4534b639a54540affcc2737 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 11 Mar 2026 15:54:42 -0400
Subject: [PATCH 22/31] choosein tag

---
 packages/core/signal.mjs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 9bd13d102..57bc59038 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -594,6 +594,7 @@ export const choose = (...xs) => chooseWith(rand, xs);
  *
  * @name chooseIn
  * @deprecated
+ * @tags temporal
  * @returns {Pattern}
  */
 export const chooseIn = (...xs) => chooseInWith(rand, xs);

From 6df34625c321d01602551f301126acccca0218c7 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 11 Mar 2026 17:31:19 -0400
Subject: [PATCH 23/31] chooseInWith examples, other fixes

---
 packages/core/pattern.mjs                 |  27 +++--
 packages/core/signal.mjs                  |  20 ++--
 test/__snapshots__/examples.test.mjs.snap | 115 ++++++++++++++++------
 3 files changed, 110 insertions(+), 52 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 594aab7a8..1dcb8a7f1 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -504,6 +504,8 @@ export class Pattern {
 
   /**
    * Returns a new pattern with the given function applied to the list of haps returned by every query.
+   *
+   * As an end user, you will most likely not need to use this; look at `withContext`, `withHapSpan`, etc. instead.
    * @tags internals
    * @param {Function} func
    * @returns Pattern
@@ -511,10 +513,13 @@ export class Pattern {
    * @example
    * note("[a b, c d] a b c d").s("gm_piano").withHaps(x=>{
    *   if (x.length > 1) {
-   *     x.map(hap=>{
-   *       // select gm_piano:1 sample
-   *       hap.value.n = 1
-   *     })
+   *     x = x.map(hap => hap.withValue(val => {
+   *       return {
+   *         n: 1,
+   *         // select gm_piano:1 sample
+   *         ...val
+   *       }
+   *     }));
    *   }
    *   return x
    * })
@@ -527,6 +532,8 @@ export class Pattern {
 
   /**
    * As with `withHaps`, but applies the function to every hap, rather than every list of haps.
+   *
+   * As an end user, you will most likely not need to use this; look at `withContext`, `withHapSpan`, etc. instead.
    * @tags internals
    * @param {Function} func
    * @returns Pattern
@@ -1211,7 +1218,7 @@ const COMPOSERS = {
   pow: [numeralArgs(Math.pow)],
   /**
    *
-   * Preforms a bitwise `and` on each number and the given factor
+   * Performs a bitwise `and` on each number and the given factor
    * @name band
    * @memberof Pattern
    * @tags math
@@ -1219,7 +1226,7 @@ const COMPOSERS = {
   band: [numeralArgs((a, b) => a & b)],
   /**
    *
-   * Preforms a bitwise `or` on each number and the given factor
+   * Performs a bitwise `or` on each number and the given factor
    * @name bor
    * @memberof Pattern
    * @tags math
@@ -1227,7 +1234,7 @@ const COMPOSERS = {
   bor: [numeralArgs((a, b) => a | b)],
   /**
    *
-   * Preforms a bitwise `xor` on each number and the given factor
+   * Performs a bitwise `xor` on each number and the given factor
    * @name bxor
    * @memberof Pattern
    * @tags math
@@ -1235,7 +1242,7 @@ const COMPOSERS = {
   bxor: [numeralArgs((a, b) => a ^ b)],
   /**
    *
-   * Preforms a bitwise `left shift` on each number by the given factor
+   * Performs a bitwise `left shift` on each number by the given factor
    * @name blshift
    * @memberof Pattern
    * @tags math
@@ -1243,7 +1250,7 @@ const COMPOSERS = {
   blshift: [numeralArgs((a, b) => a << b)],
   /**
    *
-   * Preforms a bitwise `right shift` on each number by the given factor
+   * Performs a bitwise `right shift` on each number by the given factor
    * @name brshift
    * @memberof Pattern
    * @tags math
@@ -1595,7 +1602,7 @@ export function stackRight(...pats) {
 }
 
 /**
- * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCentre/stackCenter`
+ * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackRight`
  * @name stackCentre
  * @tags temporal, stepwise, combiners
  * @synonyms stackCenter
diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 57bc59038..ef2306f92 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -562,6 +562,9 @@ export const __chooseWith = (pat, xs) => {
  * @returns {Pattern}
  * @example
  * note("c2 g2!2 d2 f1").s(chooseWith(sine.fast(2), ["sawtooth", "triangle", "bd:6"]))
+ * @example
+ * // Compare with chooseInWith
+ * note(chooseWith("<0 0.5 1>*3", ["c3", "b3", "d3"]))
  */
 export const chooseWith = (pat, xs) => {
   return __chooseWith(pat, xs).outerJoin();
@@ -573,6 +576,13 @@ export const chooseWith = (pat, xs) => {
  * @tags temporal
  * @param {Pattern} pat
  * @param {*} xs
+ * @example
+ * // Because the structure comes from the chosen values (the notes, here)
+ * // The choosing pattern will only advance once per cycle (not 3 times per cycle)
+ * note(chooseInWith("<0 0.5 1>*3", ["c3", "b3", "d3"]))
+ * @example
+ * // Here, the chosen values have a structure such that the choosing pattern will advance 3 times per cycle
+ * note(chooseInWith("<0 0.5 1>*3", ["c3*3", "b3*3", "d3*3"]))
  * @returns {Pattern}
  */
 export const chooseInWith = (pat, xs) => {
@@ -589,16 +599,6 @@ export const chooseInWith = (pat, xs) => {
  */
 export const choose = (...xs) => chooseWith(rand, xs);
 
-/**
- * Has no difference with `choose`
- *
- * @name chooseIn
- * @deprecated
- * @tags temporal
- * @returns {Pattern}
- */
-export const chooseIn = (...xs) => chooseInWith(rand, xs);
-
 /**
  * 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
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index dbf94bf76..89af4be4e 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -2133,6 +2133,40 @@ exports[`runs examples > example "chooseCycles" example index 1 1`] = `
 ]
 `;
 
+exports[`runs examples > example "chooseInWith" example index 0 1`] = `
+[
+  "[ (0/1 → 1/3) ⇝ 1/1 | note:c3 ]",
+  "[ 0/1 ⇜ (1/3 → 2/3) ⇝ 1/1 | note:b3 ]",
+  "[ 0/1 ⇜ (2/3 → 1/1) | note:d3 ]",
+  "[ (1/1 → 4/3) ⇝ 2/1 | note:c3 ]",
+  "[ 1/1 ⇜ (4/3 → 5/3) ⇝ 2/1 | note:b3 ]",
+  "[ 1/1 ⇜ (5/3 → 2/1) | note:d3 ]",
+  "[ (2/1 → 7/3) ⇝ 3/1 | note:c3 ]",
+  "[ 2/1 ⇜ (7/3 → 8/3) ⇝ 3/1 | note:b3 ]",
+  "[ 2/1 ⇜ (8/3 → 3/1) | note:d3 ]",
+  "[ (3/1 → 10/3) ⇝ 4/1 | note:c3 ]",
+  "[ 3/1 ⇜ (10/3 → 11/3) ⇝ 4/1 | note:b3 ]",
+  "[ 3/1 ⇜ (11/3 → 4/1) | note:d3 ]",
+]
+`;
+
+exports[`runs examples > example "chooseInWith" example index 1 1`] = `
+[
+  "[ 0/1 → 1/3 | note:c3 ]",
+  "[ 1/3 → 2/3 | note:b3 ]",
+  "[ 2/3 → 1/1 | note:d3 ]",
+  "[ 1/1 → 4/3 | note:c3 ]",
+  "[ 4/3 → 5/3 | note:b3 ]",
+  "[ 5/3 → 2/1 | note:d3 ]",
+  "[ 2/1 → 7/3 | note:c3 ]",
+  "[ 7/3 → 8/3 | note:b3 ]",
+  "[ 8/3 → 3/1 | note:d3 ]",
+  "[ 3/1 → 10/3 | note:c3 ]",
+  "[ 10/3 → 11/3 | note:b3 ]",
+  "[ 11/3 → 4/1 | note:d3 ]",
+]
+`;
+
 exports[`runs examples > example "chooseWith" example index 0 1`] = `
 [
   "[ 0/1 → 1/5 | note:c2 s:triangle ]",
@@ -2158,6 +2192,23 @@ exports[`runs examples > example "chooseWith" example index 0 1`] = `
 ]
 `;
 
+exports[`runs examples > example "chooseWith" example index 1 1`] = `
+[
+  "[ 0/1 → 1/3 | note:c3 ]",
+  "[ 1/3 → 2/3 | note:b3 ]",
+  "[ 2/3 → 1/1 | note:d3 ]",
+  "[ 1/1 → 4/3 | note:c3 ]",
+  "[ 4/3 → 5/3 | note:b3 ]",
+  "[ 5/3 → 2/1 | note:d3 ]",
+  "[ 2/1 → 7/3 | note:c3 ]",
+  "[ 7/3 → 8/3 | note:b3 ]",
+  "[ 8/3 → 3/1 | note:d3 ]",
+  "[ 3/1 → 10/3 | note:c3 ]",
+  "[ 10/3 → 11/3 | note:b3 ]",
+  "[ 11/3 → 4/1 | note:d3 ]",
+]
+`;
+
 exports[`runs examples > example "chop" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | s:rhodes begin:0.75 end:1 speed:0.25 unit:c ]",
@@ -15366,38 +15417,38 @@ exports[`runs examples > example "withHap" example index 0 1`] = `
 
 exports[`runs examples > example "withHaps" example index 0 1`] = `
 [
-  "[ 0/1 → 1/10 | note:a s:gm_piano n:1 ]",
-  "[ 0/1 → 1/10 | note:c s:gm_piano n:1 ]",
-  "[ 1/10 → 1/5 | note:b s:gm_piano n:1 ]",
-  "[ 1/10 → 1/5 | note:d s:gm_piano n:1 ]",
-  "[ 1/5 → 2/5 | note:a s:gm_piano n:1 ]",
-  "[ 2/5 → 3/5 | note:b s:gm_piano n:1 ]",
-  "[ 3/5 → 4/5 | note:c s:gm_piano n:1 ]",
-  "[ 4/5 → 1/1 | note:d s:gm_piano n:1 ]",
-  "[ 1/1 → 11/10 | note:a s:gm_piano n:1 ]",
-  "[ 1/1 → 11/10 | note:c s:gm_piano n:1 ]",
-  "[ 11/10 → 6/5 | note:b s:gm_piano n:1 ]",
-  "[ 11/10 → 6/5 | note:d s:gm_piano n:1 ]",
-  "[ 6/5 → 7/5 | note:a s:gm_piano n:1 ]",
-  "[ 7/5 → 8/5 | note:b s:gm_piano n:1 ]",
-  "[ 8/5 → 9/5 | note:c s:gm_piano n:1 ]",
-  "[ 9/5 → 2/1 | note:d s:gm_piano n:1 ]",
-  "[ 2/1 → 21/10 | note:a s:gm_piano n:1 ]",
-  "[ 2/1 → 21/10 | note:c s:gm_piano n:1 ]",
-  "[ 21/10 → 11/5 | note:b s:gm_piano n:1 ]",
-  "[ 21/10 → 11/5 | note:d s:gm_piano n:1 ]",
-  "[ 11/5 → 12/5 | note:a s:gm_piano n:1 ]",
-  "[ 12/5 → 13/5 | note:b s:gm_piano n:1 ]",
-  "[ 13/5 → 14/5 | note:c s:gm_piano n:1 ]",
-  "[ 14/5 → 3/1 | note:d s:gm_piano n:1 ]",
-  "[ 3/1 → 31/10 | note:a s:gm_piano n:1 ]",
-  "[ 3/1 → 31/10 | note:c s:gm_piano n:1 ]",
-  "[ 31/10 → 16/5 | note:b s:gm_piano n:1 ]",
-  "[ 31/10 → 16/5 | note:d s:gm_piano n:1 ]",
-  "[ 16/5 → 17/5 | note:a s:gm_piano n:1 ]",
-  "[ 17/5 → 18/5 | note:b s:gm_piano n:1 ]",
-  "[ 18/5 → 19/5 | note:c s:gm_piano n:1 ]",
-  "[ 19/5 → 4/1 | note:d s:gm_piano n:1 ]",
+  "[ 0/1 → 1/10 | n:1 note:a s:gm_piano ]",
+  "[ 0/1 → 1/10 | n:1 note:c s:gm_piano ]",
+  "[ 1/10 → 1/5 | n:1 note:b s:gm_piano ]",
+  "[ 1/10 → 1/5 | n:1 note:d s:gm_piano ]",
+  "[ 1/5 → 2/5 | n:1 note:a s:gm_piano ]",
+  "[ 2/5 → 3/5 | n:1 note:b s:gm_piano ]",
+  "[ 3/5 → 4/5 | n:1 note:c s:gm_piano ]",
+  "[ 4/5 → 1/1 | n:1 note:d s:gm_piano ]",
+  "[ 1/1 → 11/10 | n:1 note:a s:gm_piano ]",
+  "[ 1/1 → 11/10 | n:1 note:c s:gm_piano ]",
+  "[ 11/10 → 6/5 | n:1 note:b s:gm_piano ]",
+  "[ 11/10 → 6/5 | n:1 note:d s:gm_piano ]",
+  "[ 6/5 → 7/5 | n:1 note:a s:gm_piano ]",
+  "[ 7/5 → 8/5 | n:1 note:b s:gm_piano ]",
+  "[ 8/5 → 9/5 | n:1 note:c s:gm_piano ]",
+  "[ 9/5 → 2/1 | n:1 note:d s:gm_piano ]",
+  "[ 2/1 → 21/10 | n:1 note:a s:gm_piano ]",
+  "[ 2/1 → 21/10 | n:1 note:c s:gm_piano ]",
+  "[ 21/10 → 11/5 | n:1 note:b s:gm_piano ]",
+  "[ 21/10 → 11/5 | n:1 note:d s:gm_piano ]",
+  "[ 11/5 → 12/5 | n:1 note:a s:gm_piano ]",
+  "[ 12/5 → 13/5 | n:1 note:b s:gm_piano ]",
+  "[ 13/5 → 14/5 | n:1 note:c s:gm_piano ]",
+  "[ 14/5 → 3/1 | n:1 note:d s:gm_piano ]",
+  "[ 3/1 → 31/10 | n:1 note:a s:gm_piano ]",
+  "[ 3/1 → 31/10 | n:1 note:c s:gm_piano ]",
+  "[ 31/10 → 16/5 | n:1 note:b s:gm_piano ]",
+  "[ 31/10 → 16/5 | n:1 note:d s:gm_piano ]",
+  "[ 16/5 → 17/5 | n:1 note:a s:gm_piano ]",
+  "[ 17/5 → 18/5 | n:1 note:b s:gm_piano ]",
+  "[ 18/5 → 19/5 | n:1 note:c s:gm_piano ]",
+  "[ 19/5 → 4/1 | n:1 note:d s:gm_piano ]",
 ]
 `;
 

From 91681983e27a645b8aec0583aa4634100a4ead34 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 11 Mar 2026 17:32:14 -0400
Subject: [PATCH 24/31] wording

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

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index ef2306f92..8d2c6cb55 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -744,7 +744,7 @@ export const perlin = signal((t, controls) => _perlin(t, controls.randSeed));
 export const berlin = signal((t, controls) => _berlin(t, controls.randSeed));
 
 /**
- * `degradeByWith` is like `degradeBy`, but with more granular control.
+ * `degradeByWith` is like `degradeBy`, but with control over the random or other signal used to filter out the events.
  *
  * `degradeBy(x)` is essentially `degradeByWith(rand, x)`
  *

From 8f1a0840c03c309634fd622ad8a98b675581c218 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 25 Mar 2026 14:07:10 -0400
Subject: [PATCH 25/31] edit dry tags to add to reference

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

diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 19e4d5ae7..2a13c4df2 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1988,11 +1988,10 @@ export const { spread } = registerControl('spread');
  * Set dryness of reverb. See `room` and `size` for more information about reverb.
  *
  * @name dry
- * @tags superdirt
+ * @tags superdirt, superdough
  * @param {number | Pattern} dry 0 = wet, 1 = dry
  * @example
  * n("[0,3,7](3,8)").s("superpiano").room(.7).dry("<0 .5 .75 1>").osc()
- * @superdirtOnly
  *
  */
 export const { dry } = registerControl('dry');

From 3dff15eab0e0b5fe2c8cf30cafebf3f5e0a64b20 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 25 Mar 2026 15:36:26 -0400
Subject: [PATCH 26/31] readded chooseIn due to mondough using it

---
 packages/core/signal.mjs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 8d2c6cb55..a1cf37286 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -599,6 +599,8 @@ export const chooseInWith = (pat, xs) => {
  */
 export const choose = (...xs) => chooseWith(rand, xs);
 
+export const chooseIn = (...xs) => chooseInWith(rand, xs); 
+
 /**
  * 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

From 0d73c02314a857d77aee67e74e6ee1d161f886c8 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Thu, 26 Mar 2026 01:10:42 -0400
Subject: [PATCH 27/31] format

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

diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index a1cf37286..c43366ebd 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -599,7 +599,7 @@ export const chooseInWith = (pat, xs) => {
  */
 export const choose = (...xs) => chooseWith(rand, xs);
 
-export const chooseIn = (...xs) => chooseInWith(rand, xs); 
+export const chooseIn = (...xs) => chooseInWith(rand, xs);
 
 /**
  * Chooses from the given list of values (or patterns of values), according

From 81257b5f066fe50dbcc96e5dd5f2fc603ead7cfb Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 29 Apr 2026 15:30:32 -0400
Subject: [PATCH 28/31] lt,gt,lte,etc.

---
 packages/core/pattern.mjs | 130 ++++++++++++++++++++++++++++++++------
 1 file changed, 110 insertions(+), 20 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 1dcb8a7f1..34ad1b4b3 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1258,15 +1258,105 @@ const COMPOSERS = {
   brshift: [numeralArgs((a, b) => a >> b)],
 
   // TODO - force numerical comparison if both look like numbers?
+  /**
+   * preforms a < b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   lt: [(a, b) => a < b],
+  /**
+   * preforms a > b
+   * @name gt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   gt: [(a, b) => a > b],
+  /**
+   * preforms a <= b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   lte: [(a, b) => a <= b],
+  /**
+   * preforms a >= b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   gte: [(a, b) => a >= b],
+  /**
+   * preforms a == b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   eq: [(a, b) => a == b],
+  /**
+   * preforms a === b (strictly equal)
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   eqt: [(a, b) => a === b],
+  /**
+   * preforms a != b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   ne: [(a, b) => a != b],
+  /**
+   * preforms a !== b (strictly not equal)
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   net: [(a, b) => a !== b],
+  /**
+   * preforms a && b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   and: [(a, b) => a && b],
+  /**
+   * preforms a || b
+   * @name lt
+   * @memberof Pattern
+   * @tags math
+   * @param {any} a
+   * @param {any} b
+   * @returns Pattern with boolean value(s)
+   */
   or: [(a, b) => a || b],
 
   //  bitwise ops
@@ -1759,10 +1849,10 @@ export function arrange(...sections) {
  * @tags combiners
  * @return {Pattern}
  * @example
-seqPLoop(
-  [0, 2, "bd(3,8)"],
-  [1, 3, "cp(3,8)"]
-).sound()
+ * seqPLoop(
+ * [0, 2, "bd(3,8)"],
+ * [1, 3, "cp(3,8)"]
+ * ).sound()
  */
 export function seqPLoop(...parts) {
   let total = Fraction(0);
@@ -2433,11 +2523,11 @@ export const { zoomArc, zoomarc } = register(['zoomArc', 'zoomarc'], function (a
  * @param {number} slices to play
  * @example
  * note("0 1 2 3 4 5 6 7".scale('c:mixolydian'))
- *.bite(4, "3 2 1 0")
+ * .bite(4, "3 2 1 0")
  * @example
  * sound("bd - bd bd*2, - sd:6 - sd:5 sd:1 - [- sd:2] -, hh [- cp:7]")
-  .bank("RolandTR909").speed(1.2)
-  .bite(4, "0 0 [1 2] <3 2> 0 0 [2 1] 3")
+ * .bank("RolandTR909").speed(1.2)
+ * .bite(4, "0 0 [1 2] <3 2> 0 0 [2 1] 3")
  */
 export const bite = register(
   'bite',
@@ -3510,8 +3600,8 @@ export const shrinklist = (amount, pat) => pat.shrinklist(amount);
  * "tha dhi thom nam".shrink("1 -1").sound().bank("mridangam").pace(4)
  * @example
  * note("0 1 2 3 4 5 6 7".scale("C:ritusen")).sound("folkharp")
-   .shrink("1 -1").pace(8)
-
+ * .shrink("1 -1").pace(8)
+ *
  */
 
 export const shrink = register(
@@ -3550,7 +3640,7 @@ export const shrink = register(
  * "tha dhi thom nam".grow("1 -1").sound().bank("mridangam").pace(4)
  * @example
  * note("0 1 2 3 4 5 6 7".scale("C:ritusen")).sound("folkharp")
-   .grow("1 -1").pace(8)
+ * .grow("1 -1").pace(8)
  */
 
 export const grow = register(
@@ -3574,17 +3664,17 @@ export const grow = register(
 
 /**
  * *Experimental*
- * 
- * Inserts a pattern into a list of patterns. On the first repetition it will be inserted at the end of the list, then moved backwards through the list 
- * on successive repetitions. The patterns are added together stepwise, with all repetitions taking place over a single cycle. Using `pace` to set the 
+ *
+ * Inserts a pattern into a list of patterns. On the first repetition it will be inserted at the end of the list, then moved backwards through the list
+ * on successive repetitions. The patterns are added together stepwise, with all repetitions taking place over a single cycle. Using `pace` to set the
  * number of steps per cycle is therefore usually recommended.
  *
  * @tags stepwise
  * @return {Pattern}
  * @example
  * "[c g]".tour("e f", "e f g", "g f e c").note()
-   .sound("folkharp")
-   .pace(8)
+ * .sound("folkharp")
+ * .pace(8)
  */
 export const tour = function (pat, ...many) {
   return pat.tour(...many);
@@ -3602,16 +3692,16 @@ Pattern.prototype.tour = function (...many) {
 
 /**
  * *Experimental*
- * 
- * 'zips' together the steps of the provided patterns. This can create a long repetition, taking place over a single, dense cycle. 
+ *
+ * 'zips' together the steps of the provided patterns. This can create a long repetition, taking place over a single, dense cycle.
  * Using `pace` to set the number of steps per cycle is therefore usually recommended.
- * 
+ *
  * @tags stepwise
  * @returns {Pattern}
  * @example
  * zip("e f", "e f g", "g [f e] a f4 c").note()
-   .sound("folkharp")
-   .pace(8)
+ * .sound("folkharp")
+ * .pace(8)
  */
 export const zip = function (...pats) {
   pats = pats.filter((pat) => pat.hasSteps);

From d5171e2ab794dd6ca6e772579a72d87b936e0a58 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 29 Apr 2026 15:35:05 -0400
Subject: [PATCH 29/31] named things

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

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 34ad1b4b3..ff1ef17ef 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1280,7 +1280,7 @@ const COMPOSERS = {
   gt: [(a, b) => a > b],
   /**
    * preforms a <= b
-   * @name lt
+   * @name lte
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1290,7 +1290,7 @@ const COMPOSERS = {
   lte: [(a, b) => a <= b],
   /**
    * preforms a >= b
-   * @name lt
+   * @name gte
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1300,7 +1300,7 @@ const COMPOSERS = {
   gte: [(a, b) => a >= b],
   /**
    * preforms a == b
-   * @name lt
+   * @name eq
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1310,7 +1310,7 @@ const COMPOSERS = {
   eq: [(a, b) => a == b],
   /**
    * preforms a === b (strictly equal)
-   * @name lt
+   * @name eqt
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1320,7 +1320,7 @@ const COMPOSERS = {
   eqt: [(a, b) => a === b],
   /**
    * preforms a != b
-   * @name lt
+   * @name ne
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1330,7 +1330,7 @@ const COMPOSERS = {
   ne: [(a, b) => a != b],
   /**
    * preforms a !== b (strictly not equal)
-   * @name lt
+   * @name net
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1340,7 +1340,7 @@ const COMPOSERS = {
   net: [(a, b) => a !== b],
   /**
    * preforms a && b
-   * @name lt
+   * @name and
    * @memberof Pattern
    * @tags math
    * @param {any} a
@@ -1350,7 +1350,7 @@ const COMPOSERS = {
   and: [(a, b) => a && b],
   /**
    * preforms a || b
-   * @name lt
+   * @name or
    * @memberof Pattern
    * @tags math
    * @param {any} a

From 704018f774a758236784d328c42cd07191079c2f Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Tue, 21 Jul 2026 22:48:28 -0400
Subject: [PATCH 30/31] preform/perform, mod

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

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index ff1ef17ef..5a981dd9d 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -1202,8 +1202,8 @@ const COMPOSERS = {
   div: [numeralArgs((a, b) => a / b)],
   /**
    *
-   * Divides each number by the given factor.
-   * @name div
+   * Divides each number by the given factor and returns the remainder
+   * @name mod
    * @memberof Pattern
    * @tags math
    */
@@ -1259,7 +1259,7 @@ const COMPOSERS = {
 
   // TODO - force numerical comparison if both look like numbers?
   /**
-   * preforms a < b
+   * performs a < b
    * @name lt
    * @memberof Pattern
    * @tags math
@@ -1269,7 +1269,7 @@ const COMPOSERS = {
    */
   lt: [(a, b) => a < b],
   /**
-   * preforms a > b
+   * performs a > b
    * @name gt
    * @memberof Pattern
    * @tags math
@@ -1279,7 +1279,7 @@ const COMPOSERS = {
    */
   gt: [(a, b) => a > b],
   /**
-   * preforms a <= b
+   * performs a <= b
    * @name lte
    * @memberof Pattern
    * @tags math
@@ -1289,7 +1289,7 @@ const COMPOSERS = {
    */
   lte: [(a, b) => a <= b],
   /**
-   * preforms a >= b
+   * performs a >= b
    * @name gte
    * @memberof Pattern
    * @tags math
@@ -1299,7 +1299,7 @@ const COMPOSERS = {
    */
   gte: [(a, b) => a >= b],
   /**
-   * preforms a == b
+   * performs a == b
    * @name eq
    * @memberof Pattern
    * @tags math
@@ -1309,7 +1309,7 @@ const COMPOSERS = {
    */
   eq: [(a, b) => a == b],
   /**
-   * preforms a === b (strictly equal)
+   * performs a === b (strictly equal)
    * @name eqt
    * @memberof Pattern
    * @tags math
@@ -1319,7 +1319,7 @@ const COMPOSERS = {
    */
   eqt: [(a, b) => a === b],
   /**
-   * preforms a != b
+   * performs a != b
    * @name ne
    * @memberof Pattern
    * @tags math
@@ -1329,7 +1329,7 @@ const COMPOSERS = {
    */
   ne: [(a, b) => a != b],
   /**
-   * preforms a !== b (strictly not equal)
+   * performs a !== b (strictly not equal)
    * @name net
    * @memberof Pattern
    * @tags math
@@ -1339,7 +1339,7 @@ const COMPOSERS = {
    */
   net: [(a, b) => a !== b],
   /**
-   * preforms a && b
+   * performs a && b
    * @name and
    * @memberof Pattern
    * @tags math
@@ -1349,7 +1349,7 @@ const COMPOSERS = {
    */
   and: [(a, b) => a && b],
   /**
-   * preforms a || b
+   * performs a || b
    * @name or
    * @memberof Pattern
    * @tags math

From 5148066b01efd9da70ea8eb136dc22bdf0bdb106 Mon Sep 17 00:00:00 2001
From: tyow <cute.oil5122@fastmail.com>
Date: Wed, 7 Oct 2026 16:44:43 -0400
Subject: [PATCH 31/31] stackCenter/Centre changes, fix from merge, snapshot

---
 packages/core/pattern.mjs                 | 22 +++++++++++++---------
 packages/core/signal.mjs                  |  1 +
 test/__snapshots__/examples.test.mjs.snap | 13 ++-----------
 3 files changed, 16 insertions(+), 20 deletions(-)

diff --git a/packages/core/pattern.mjs b/packages/core/pattern.mjs
index 8968b508f..1b4ac6b26 100644
--- a/packages/core/pattern.mjs
+++ b/packages/core/pattern.mjs
@@ -886,6 +886,10 @@ export class Pattern {
     return stackRight(this, ...pats);
   }
 
+  stackCenter(...pats) {
+    return stackCenter(this, ...pats);
+  }
+
   stackCentre(...pats) {
     return stackCentre(this, ...pats);
   }
@@ -1666,7 +1670,7 @@ function _stackWith(func, pats) {
 }
 
 /**
- * The input patterns are aligned to the left, with silence padded to the shorter pattern(s) in the final steps if there's a stepcount disparity. See also `stackRight` and `stackCentre/stackCenter`
+ * The input patterns are aligned to the left, with silence padded to the shorter pattern(s) in the final steps if there's a stepcount disparity. See also `stackRight` and `stackCenter/stackCentre`
  *
  * @name stackLeft
  * @tags temporal, stepwise, combiners
@@ -1685,7 +1689,7 @@ export function stackLeft(...pats) {
 }
 
 /**
- * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCentre/stackCenter`
+ * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackCenter/stackCentre`
  *
  * @name stackRight
  * @tags temporal, stepwise, combiners
@@ -1705,17 +1709,17 @@ export function stackRight(...pats) {
 
 /**
  * The input patterns are aligned to the right, with silence padded to the shorter pattern(s) in the initial steps if there's a stepcount disparity. See also `stackLeft` and `stackRight`
- * @name stackCentre
+ * @name stackCenter
  * @tags temporal, stepwise, combiners
- * @synonyms stackCenter
+ * @synonyms stackCentre
  * @return {Pattern}
  * @example
- * stackCentre("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ * stackCenter("0 1 2 3", "3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
  * @example
  * // chainable
- * "0 1 2 3".stackCentre("3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
+ * "0 1 2 3".stackCenter("3 4", "[4 5 6] 7 8 9 10").scale("c:minor").note()
  */
-export function stackCentre(...pats) {
+export function stackCenter(...pats) {
   return _stackWith(
     (steps, pats) =>
       pats.map((pat) => {
@@ -1729,8 +1733,8 @@ export function stackCentre(...pats) {
   );
 }
 
-export function stackCenter(pats) {
-  return stackCentre(pats);
+export function stackCentre(...pats) {
+  return stackCenter(...pats);
 }
 
 /**
diff --git a/packages/core/signal.mjs b/packages/core/signal.mjs
index 83a35d677..0316c86fe 100644
--- a/packages/core/signal.mjs
+++ b/packages/core/signal.mjs
@@ -6,6 +6,7 @@ This program is free software: you can redistribute it and/or modify it under th
 
 import { Hap } from './hap.mjs';
 import { Pattern, fastcat, pure, register, reify, silence, stack, sequenceP, isPattern } from './pattern.mjs';
+import { _mod } from './util.mjs';
 import Fraction from './fraction.mjs';
 
 import { id, keyAlias, getCurrentKeyboardState } from './util.mjs';
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 1d8d69922..d1e8599f3 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -7908,15 +7908,6 @@ exports[`runs examples > example "midi" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "midi" example index 1 1`] = `
-[
-  "[ 0/1 → 1/1 | note:c4 midichan:1 ]",
-  "[ 1/1 → 2/1 | note:c4 midichan:1 ]",
-  "[ 2/1 → 3/1 | note:c4 midichan:1 ]",
-  "[ 3/1 → 4/1 | note:c4 midichan:1 ]",
-]
-`;
-
 exports[`runs examples > example "midibend" example index 0 1`] = `
 [
   "[ 0/1 → 1/1 | note:c4 midibend:0 ]",
@@ -13144,7 +13135,7 @@ exports[`runs examples > example "stack" example index 1 1`] = `
 ]
 `;
 
-exports[`runs examples > example "stackCentre" example index 0 1`] = `
+exports[`runs examples > example "stackCenter" example index 0 1`] = `
 [
   "[ 0/1 → 1/15 | note:G3 ]",
   "[ 1/15 → 2/15 | note:Ab3 ]",
@@ -13201,7 +13192,7 @@ exports[`runs examples > example "stackCentre" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "stackCentre" example index 1 1`] = `
+exports[`runs examples > example "stackCenter" example index 1 1`] = `
 [
   "[ 0/1 → 1/15 | note:G3 ]",
   "[ 1/15 → 2/15 | note:Ab3 ]",