Add control aliases (#497)

* add and simplify control aliases, fixes #496
* roomsize now alias of room
* simplify webaudio param handling
---------

Co-authored-by: Felix Roos <flix91@gmail.com>

packages/core/controls.mjs

@@ -13,11 +13,12 @@ const generic_params = [
    *
    * @name s
    * @param {string | Pattern} sound The sound / pattern of sounds to pick
+   * @synonyms sound
    * @example
    * s("bd hh")
    *
    */
-  ['s', 's', 'sound'],
+  ['s', 'sound'],
   /**
    * Selects the given index from the sample map.
    * Numbers too high will wrap around.
@@ -29,7 +30,7 @@ const generic_params = [
    * s("bd sd,hh*3").n("<0 1>")
    */
   // also see https://github.com/tidalcycles/strudel/pull/63
-  ['f', 'n', 'The sample number to choose for a synth or sampleset'],
+  ['n'],
   /**
    * Plays the given note name or midi number. A note name consists of
    *
@@ -49,10 +50,8 @@ const generic_params = [
    * @example
    * note("60 69 65 64")
    */
-  ['f', 'note', 'The note or pitch to play a sound or synth with'],
-  //['s', 'toArg', 'for internal sound routing'],
-  // ["f", "from", "for internal sound routing"),
-  //['f', 'to', 'for internal sound routing'],
+  ['note'],
+
   /**
    * A pattern of numbers that speed up (or slow down) samples while they play. Currently only supported by osc / superdirt.
    *
@@ -63,7 +62,7 @@ const generic_params = [
    * s("sax").accelerate("<0 1 2 4 8 16>").slow(2).osc()
    *
    */
-  ['f', 'accelerate', 'a pattern of numbers that speed up (or slow down) samples while they play.'],
+  ['accelerate'],
   /**
    * Controls the gain by an exponential amount.
    *
@@ -73,11 +72,7 @@ const generic_params = [
    * s("hh*8").gain(".4!2 1 .4!2 1 .4 1")
    *
    */
-  [
-    'f',
-    'gain',
-    'a pattern of numbers that specify volume. Values less than 1 make the sound quieter. Values greater than 1 make the sound louder. For the linear equivalent, see @amp@.',
-  ],
+  ['gain'],
   /**
    * Like {@link gain}, but linear.
    *
@@ -88,17 +83,18 @@ const generic_params = [
    * s("bd*8").amp(".1*2 .5 .1*2 .5 .1 .5").osc()
    *
    */
-  ['f', 'amp', 'like @gain@, but linear.'],
+  ['amp'],
   /**
    * Amplitude envelope attack time: Specifies how long it takes for the sound to reach its peak value, relative to the onset.
    *
    * @name attack
    * @param {number | Pattern} attack time in seconds.
+   * @synonyms att
    * @example
    * note("c3 e3").attack("<0 .1 .5>")
    *
    */
-  ['f', 'attack'],
+  ['attack', 'att'],
 
   /**
    * Select the sound bank to use. To be used together with `s`. The bank name (+ "_") will be prepended to the value of `s`.
@@ -109,7 +105,7 @@ const generic_params = [
    * s("bd sd").bank('RolandTR909') // = s("RolandTR909_bd RolandTR909_sd")
    *
    */
-  ['f', 'bank', 'selects sound bank to use'],
+  ['bank'],
 
   /**
    * Amplitude envelope decay time: the time it takes after the attack time to reach the sustain level.
@@ -121,36 +117,30 @@ const generic_params = [
    * note("c3 e3").decay("<.1 .2 .3 .4>").sustain(0)
    *
    */
-  ['f', 'decay', ''],
+  ['decay'],
   /**
    * Amplitude envelope sustain level: The level which is reached after attack / decay, being sustained until the offset.
    *
    * @name sustain
    * @param {number | Pattern} gain sustain level between 0 and 1
+   * @synonyms sus
    * @example
    * note("c3 e3").decay(.2).sustain("<0 .1 .4 .6 1>")
    *
    */
-  ['f', 'sustain', ''],
+  ['sustain', 'sus'],
   /**
    * Amplitude envelope release time: The time it takes after the offset to go from sustain level to zero.
    *
    * @name release
    * @param {number | Pattern} time release time in seconds
+   * @synonyms rel
    * @example
    * note("c3 e3 g3 c4").release("<0 .1 .4 .6 1>/2")
    *
    */
-  [
-    'f',
-    'release',
-    'a pattern of numbers to specify the release time (in seconds) of an envelope applied to each sample.',
-  ],
-  [
-    'f',
-    'hold',
-    'a pattern of numbers to specify the hold time (in seconds) of an envelope applied to each sample. Only takes effect if `attack` and `release` are also specified.',
-  ],
+  ['release', 'rel'],
+  ['hold'],
   // TODO: in tidal, it seems to be normalized
   /**
    * Sets the center frequency of the **b**and-**p**ass **f**ilter.
@@ -162,8 +152,9 @@ const generic_params = [
    * s("bd sd,hh*3").bpf("<1000 2000 4000 8000>")
    *
    */
-  ['f', 'bpf', ''],
-  ['f', 'bandf', 'A pattern of numbers from 0 to 1. Sets the center frequency of the band-pass filter.'],
+  // currently an alias of 'bandf' https://github.com/tidalcycles/strudel/issues/496
+  // ['bpf'],
+  ['bandf', 'bpf'],
   // TODO: in tidal, it seems to be normalized
   /**
    * Sets the **b**and-**p**ass **q**-factor (resonance)
@@ -175,8 +166,9 @@ const generic_params = [
    * s("bd sd").bpf(500).bpq("<0 1 2 3>")
    *
    */
-  ['f', 'bpq', ''],
-  ['f', 'bandq', 'a pattern of anumbers from 0 to 1. Sets the q-factor of the band-pass filter.'],
+  // currently an alias of 'bandq' https://github.com/tidalcycles/strudel/issues/496
+  // ['bpq'],
+  ['bandq', 'bpq'],
   /**
    * a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.
    *
@@ -188,11 +180,7 @@ const generic_params = [
    * s("rave").begin("<0 .25 .5 .75>")
    *
    */
-  [
-    'f',
-    'begin',
-    'a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.',
-  ],
+  ['begin'],
   /**
    * The same as .begin, but cuts off the end off each sample.
    *
@@ -203,11 +191,7 @@ const generic_params = [
    * s("bd*2,oh*4").end("<.1 .2 .5 1>")
    *
    */
-  [
-    'f',
-    'end',
-    'the same as `begin`, but cuts the end off samples, shortening them; e.g. `0.75` to cut off the last quarter of each sample.',
-  ],
+  ['end'],
   /**
    * Loops the sample (from `begin` to `end`) the specified number of times.
    * Note that the tempo of the loop is not synced with the cycle tempo.
@@ -218,7 +202,7 @@ const generic_params = [
    * s("bd").loop("<1 2 3 4>").osc()
    *
    */
-  ['f', 'loop', 'loops the sample (from `begin` to `end`) the specified number of times.'],
+  ['loop'],
   // TODO: currently duplicated with "native" legato
   // TODO: superdirt legato will do more: https://youtu.be/dQPmE1WaD1k?t=419
   /**
@@ -230,8 +214,8 @@ const generic_params = [
    * "c4 eb4 g4 bb4".legato("<0.125 .25 .5 .75 1 2 4>")
    *
    */
-  // ['f', 'legato', 'controls the amount of overlap between two adjacent sounds'],
-  // ['f', 'clhatdecay', ''],
+  // ['legato'],
+  // ['clhatdecay'],
   /**
    * bit crusher effect.
    *
@@ -241,11 +225,7 @@ const generic_params = [
    * s("<bd sd>,hh*3").fast(2).crush("<16 8 7 6 5 4 3 2>")
    *
    */
-  [
-    'f',
-    'crush',
-    'bit crushing, a pattern of numbers from 1 (for drastic reduction in bit-depth) to 16 (for barely no reduction).',
-  ],
+  ['crush'],
   /**
    * fake-resampling for lowering the sample rate. Caution: This effect seems to only work in chromium based browsers
    *
@@ -255,11 +235,7 @@ const generic_params = [
    * s("bd sd,hh*4").coarse("<1 4 8 16 32>")
    *
    */
-  [
-    'f',
-    'coarse',
-    'fake-resampling, a pattern of numbers for lowering the sample rate, i.e. 1 for original 2 for half, 3 for a third and so on.',
-  ],
+  ['coarse'],
 
   /**
    * choose the channel the pattern is sent to in superdirt
@@ -268,7 +244,7 @@ const generic_params = [
    * @param {number | Pattern} channel channel number
    *
    */
-  ['i', 'channel', 'choose the channel the pattern is sent to in superdirt'],
+  ['channel'],
   /**
    * In the style of classic drum-machines, `cut` will stop a playing sample as soon as another samples with in same cutgroup is to be played. An example would be an open hi-hat followed by a closed one, essentially muting the open.
    *
@@ -278,23 +254,18 @@ const generic_params = [
    * s("rd*4").cut(1)
    *
    */
-  [
-    'i',
-    'cut',
-    'In the style of classic drum-machines, `cut` will stop a playing sample as soon as another samples with in same cutgroup is to be played. An example would be an open hi-hat followed by a closed one, essentially muting the open.',
-  ],
+  ['cut'],
   /**
    * Applies the cutoff frequency of the **l**ow-**p**ass **f**ilter.
    *
    * @name lpf
    * @param {number | Pattern} frequency audible between 0 and 20000
-   * @synonyms cutoff
+   * @synonyms cutoff, ctf
    * @example
    * s("bd sd,hh*3").lpf("<4000 2000 1000 500 200 100>")
    *
    */
-  ['f', 'lpf'],
-  ['f', 'cutoff', 'a pattern of numbers from 0 to 1. Applies the cutoff frequency of the low-pass filter.'],
+  ['cutoff', 'ctf', 'lpf'],
   /**
    * Applies the cutoff frequency of the **h**igh-**p**ass **f**ilter.
    *
@@ -305,8 +276,9 @@ const generic_params = [
    * s("bd sd,hh*4").hpf("<4000 2000 1000 500 200 100>")
    *
    */
-  ['f', 'hpf', ''],
-  ['f', 'hcutoff', ''],
+  // currently an alias of 'hcutoff' https://github.com/tidalcycles/strudel/issues/496
+  // ['hpf'],
+  ['hcutoff', 'hpf'],
   /**
    * Controls the **h**igh-**p**ass **q**-value.
    *
@@ -317,8 +289,7 @@ const generic_params = [
    * s("bd sd,hh*4").hpf(2000).hpq("<0 10 20 30>")
    *
    */
-  ['f', 'hresonance', ''],
-  ['f', 'hpq', ''],
+  ['hresonance', 'hpq'],
   /**
    * Controls the **l**ow-**p**ass **q**-value.
    *
@@ -329,8 +300,8 @@ const generic_params = [
    * s("bd sd,hh*4").lpf(2000).lpq("<0 10 20 30>")
    *
    */
-  ['f', 'lpq'],
-  ['f', 'resonance', ''],
+  // currently an alias of 'resonance' https://github.com/tidalcycles/strudel/issues/496
+  ['resonance', 'lpq'],
   /**
    * DJ filter, below 0.5 is low pass filter, above is high pass filter.
    *
@@ -340,8 +311,8 @@ const generic_params = [
    * n("0 3 7 [10,24]").s('superzow').octave(3).djf("<.5 .25 .5 .75>").osc()
    *
    */
-  ['f', 'djf', 'DJ filter, below 0.5 is low pass filter, above is high pass filter.'],
-  // ['f', 'cutoffegint', ''],
+  ['djf'],
+  // ['cutoffegint'],
   // TODO: does not seem to work
   /**
    * Sets the level of the delay signal.
@@ -352,28 +323,30 @@ const generic_params = [
    * s("bd").delay("<0 .25 .5 1>")
    *
    */
-  ['f', 'delay', 'a pattern of numbers from 0 to 1. Sets the level of the delay signal.'],
+  ['delay'],
   /**
    * Sets the level of the signal that is fed back into the delay.
    * Caution: Values >= 1 will result in a signal that gets louder and louder! Don't do it
    *
    * @name delayfeedback
    * @param {number | Pattern} feedback between 0 and 1
+   * @synonyms delayfb, dfb
    * @example
    * s("bd").delay(.25).delayfeedback("<.25 .5 .75 1>").slow(2)
    *
    */
-  ['f', 'delayfeedback', 'a pattern of numbers from 0 to 1. Sets the amount of delay feedback.'],
+  ['delayfeedback', 'delayfb', 'dfb'],
   /**
    * Sets the time of the delay effect.
    *
    * @name delaytime
    * @param {number | Pattern} seconds between 0 and Infinity
+   * @synonyms delayt, dt
    * @example
    * s("bd").delay(.25).delaytime("<.125 .25 .5 1>").slow(2)
    *
    */
-  ['f', 'delaytime', 'a pattern of numbers from 0 to 1. Sets the length of the delay.'],
+  ['delaytime', 'delayt', 'dt'],
   /* // TODO: test
    * Specifies whether delaytime is calculated relative to cps.
    *
@@ -383,22 +356,19 @@ const generic_params = [
    * s("sd").delay().lock(1).osc()
    *
    */
-  [
-    'f',
-    'lock',
-    'A pattern of numbers. Specifies whether delaytime is calculated relative to cps. When set to 1, delaytime is a direct multiple of a cycle.',
-  ],
+  ['lock'],
   /**
    * Set detune of oscillators. Works only with some synths, see <a target="_blank" href="https://tidalcycles.org/docs/patternlib/tutorials/synthesizers">tidal doc</a>
    *
    * @name detune
    * @param {number | Pattern} amount between 0 and 1
+   * @synonyms det
    * @superdirtOnly
    * @example
    * n("0 3 7").s('superzow').octave(3).detune("<0 .25 .5 1 2>").osc()
    *
    */
-  ['f', 'detune', ''],
+  ['detune', 'det'],
   /**
    * Set dryness of reverb. See {@link room} and {@link size} for more information about reverb.
    *
@@ -409,11 +379,7 @@ const generic_params = [
    * @superdirtOnly
    *
    */
-  [
-    'f',
-    'dry',
-    'when set to `1` will disable all reverb for this pattern. See `room` and `size` for more information about reverb.',
-  ],
+  ['dry'],
   // TODO: does not seem to do anything
   /*
    * Used when using {@link begin}/{@link end} or {@link chop}/{@link striate} and friends, to change the fade out time of the 'grain' envelope.
@@ -424,17 +390,9 @@ const generic_params = [
    * s("oh*4").end(.1).fadeTime("<0 .2 .4 .8>").osc()
    *
    */
-  [
-    'f',
-    'fadeTime',
-    "Used when using begin/end or chop/striate and friends, to change the fade out time of the 'grain' envelope.",
-  ],
+  ['fadeTime', 'fadeOutTime'],
   // TODO: see above
-  [
-    'f',
-    'fadeInTime',
-    'As with fadeTime, but controls the fade in time of the grain envelope. Not used if the grain begins at position 0 in the sample.',
-  ],
+  ['fadeInTime'],
   /**
    * Set frequency of sound.
    *
@@ -446,15 +404,15 @@ const generic_params = [
    * freq("110".mul.out(".5 1.5 .6 [2 3]")).s("superzow").osc()
    *
    */
-  ['f', 'freq', ''],
+  ['freq'],
   // TODO: https://tidalcycles.org/docs/configuration/MIDIOSC/control-voltage/#gate
-  ['f', 'gate', ''],
-  // ['f', 'hatgrain', ''],
-  // ['f', 'lagogo', ''],
-  // ['f', 'lclap', ''],
-  // ['f', 'lclaves', ''],
-  // ['f', 'lclhat', ''],
-  // ['f', 'lcrash', ''],
+  ['gate', 'gat'],
+  // ['hatgrain'],
+  // ['lagogo'],
+  // ['lclap'],
+  // ['lclaves'],
+  // ['lclhat'],
+  // ['lcrash'],
   // TODO:
   // https://tidalcycles.org/docs/reference/audio_effects/#leslie-1
   // https://tidalcycles.org/docs/reference/audio_effects/#leslie
@@ -468,7 +426,7 @@ const generic_params = [
    * @superdirtOnly
    *
    */
-  ['f', 'leslie', ''],
+  ['leslie'],
   /**
    * Rate of modulation / rotation for leslie effect
    *
@@ -480,7 +438,7 @@ const generic_params = [
    *
    */
   // TODO: the rate seems to "lag" (in the example, 1 will be fast)
-  ['f', 'lrate', ''],
+  ['lrate'],
   /**
    * Physical size of the cabinet in meters. Be careful, it might be slightly larger than your computer. Affects the Doppler amount (pitch warble)
    *
@@ -491,31 +449,28 @@ const generic_params = [
    * @superdirtOnly
    *
    */
-  ['f', 'lsize', ''],
-  // ['f', 'lfo', ''],
-  // ['f', 'lfocutoffint', ''],
-  // ['f', 'lfodelay', ''],
-  // ['f', 'lfoint', ''],
-  // ['f', 'lfopitchint', ''],
-  // ['f', 'lfoshape', ''],
-  // ['f', 'lfosync', ''],
-  // ['f', 'lhitom', ''],
-  // ['f', 'lkick', ''],
-  // ['f', 'llotom', ''],
-  // ['f', 'lophat', ''],
-  // ['f', 'lsnare', ''],
-  ['f', 'degree', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'mtranspose', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'ctranspose', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'harmonic', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'stepsPerOctave', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'octaveR', ''], // TODO: what is this? not found in tidal doc
-  // TODO: why is this needed? what's the difference to late / early?
-  [
-    'f',
-    'nudge',
-    'Nudges events into the future by the specified number of seconds. Negative numbers work up to a point as well (due to internal latency)',
-  ],
+  ['lsize'],
+  // ['lfo'],
+  // ['lfocutoffint'],
+  // ['lfodelay'],
+  // ['lfoint'],
+  // ['lfopitchint'],
+  // ['lfoshape'],
+  // ['lfosync'],
+  // ['lhitom'],
+  // ['lkick'],
+  // ['llotom'],
+  // ['lophat'],
+  // ['lsnare'],
+  ['degree'], // TODO: what is this? not found in tidal doc
+  ['mtranspose'], // TODO: what is this? not found in tidal doc
+  ['ctranspose'], // TODO: what is this? not found in tidal doc
+  ['harmonic'], // TODO: what is this? not found in tidal doc
+  ['stepsPerOctave'], // TODO: what is this? not found in tidal doc
+  ['octaveR'], // TODO: what is this? not found in tidal doc
+  // TODO: why is this needed? what's the difference to late / early? Answer: it's in seconds, and delays the message at
+  // OSC time (so can't be negative, at least not beyond the latency value)
+  ['nudge'],
   // TODO: the following doc is just a guess, it's not documented in tidal doc.
   /**
    * Sets the default octave of a synth.
@@ -526,9 +481,9 @@ const generic_params = [
    * n("0,4,7").s('supersquare').octave("<3 4 5 6>").osc()
    * @superDirtOnly
    */
-  ['i', 'octave', ''],
-  ['f', 'offset', ''], // TODO: what is this? not found in tidal doc
-  // ['f', 'ophatdecay', ''],
+  ['octave'],
+  ['offset'], // TODO: what is this? not found in tidal doc
+  // ['ophatdecay'],
   // TODO: example
   /**
    * An `orbit` is a global parameter context for patterns. Patterns with the same orbit will share the same global effects.
@@ -541,13 +496,9 @@ const generic_params = [
    *   s("~ sd").delay(.5).delaytime(.125).orbit(2)
    * )
    */
-  [
-    'i',
-    'orbit',
-    'a pattern of numbers. An `orbit` is a global parameter context for patterns. Patterns with the same orbit will share hardware output bus offset and global effects, e.g. reverb and delay. The maximum number of orbits is specified in the superdirt startup, numbers higher than maximum will wrap around.',
-  ],
-  ['f', 'overgain', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'overshape', ''], // TODO: what is this? not found in tidal doc
+  ['orbit'],
+  ['overgain'], // TODO: what is this? not found in tidal doc Answer: gain is limited to maximum of 2. This allows you to go over that
+  ['overshape'], // TODO: what is this? not found in tidal doc. Similar to above, but limited to 1
   /**
    * Sets position in stereo.
    *
@@ -557,11 +508,7 @@ const generic_params = [
    * s("[bd hh]*2").pan("<.5 1 .5 0>")
    *
    */
-  [
-    'f',
-    'pan',
-    'a pattern of numbers between 0 and 1, from left to right (assuming stereo), once round a circle (assuming multichannel)',
-  ],
+  ['pan'],
   // TODO: this has no effect (see example)
   /*
    * Controls how much multichannel output is fanned out
@@ -572,11 +519,7 @@ const generic_params = [
    * s("[bd hh]*2").pan("<.5 1 .5 0>").panspan("<0 .5 1>").osc()
    *
    */
-  [
-    'f',
-    'panspan',
-    'a pattern of numbers between -inf and inf, which controls how much multichannel output is fanned out (negative is backwards ordering)',
-  ],
+  ['panspan'],
   // TODO: this has no effect (see example)
   /*
    * Controls how much multichannel output is spread
@@ -587,34 +530,22 @@ const generic_params = [
    * s("[bd hh]*2").pan("<.5 1 .5 0>").pansplay("<0 .5 1>").osc()
    *
    */
-  [
-    'f',
-    'pansplay',
-    'a pattern of numbers between 0.0 and 1.0, which controls the multichannel spread range (multichannel only)',
-  ],
-  [
-    'f',
-    'panwidth',
-    'a pattern of numbers between 0.0 and inf, which controls how much each channel is distributed over neighbours (multichannel only)',
-  ],
-  [
-    'f',
-    'panorient',
-    'a pattern of numbers between -1.0 and 1.0, which controls the relative position of the centre pan in a pair of adjacent speakers (multichannel only)',
-  ],
-  // ['f', 'pitch1', ''],
-  // ['f', 'pitch2', ''],
-  // ['f', 'pitch3', ''],
-  // ['f', 'portamento', ''],
+  ['pansplay'],
+  ['panwidth'],
+  ['panorient'],
+  // ['pitch1'],
+  // ['pitch2'],
+  // ['pitch3'],
+  // ['portamento'],
   // TODO: LFO rate see https://tidalcycles.org/docs/patternlib/tutorials/synthesizers/#supersquare
-  ['f', 'rate', "used in SuperDirt softsynths as a control rate or 'speed'"],
+  ['rate'],
   // TODO: slide param for certain synths
-  ['f', 'slide', ''],
+  ['slide'],
   // TODO: detune? https://tidalcycles.org/docs/patternlib/tutorials/synthesizers/#supersquare
-  ['f', 'semitone', ''],
+  ['semitone'],
   // TODO: dedup with synth param, see https://tidalcycles.org/docs/reference/synthesizers/#superpiano
-  // ['f', 'velocity', ''],
-  ['f', 'voice', ''], // TODO: synth param
+  // ['velocity'],
+  ['voice'], // TODO: synth param
   /**
    * Sets the level of reverb.
    *
@@ -624,13 +555,13 @@ const generic_params = [
    * s("bd sd").room("<0 .2 .4 .6 .8 1>")
    *
    */
-  ['f', 'room', 'a pattern of numbers from 0 to 1. Sets the level of reverb.'],
+  ['room'],
   /**
    * Sets the room size of the reverb, see {@link room}.
    *
    * @name roomsize
-   * @synonyms size
    * @param {number | Pattern} size between 0 and 10
+   * @synonyms size, sz
    * @example
    * s("bd sd").room(.8).roomsize("<0 1 2 4 8>")
    *
@@ -638,20 +569,11 @@ const generic_params = [
   // TODO: find out why :
   // s("bd sd").room(.8).roomsize("<0 .2 .4 .6 .8 [1,0]>").osc()
   // .. does not work. Is it because room is only one effect?
-  [
-    'f',
-    'size',
-    'a pattern of numbers from 0 to 1. Sets the perceptual size (reverb time) of the `room` to be used in reverb.',
-  ],
-  [
-    'f',
-    'roomsize',
-    'a pattern of numbers from 0 to 1. Sets the perceptual size (reverb time) of the `room` to be used in reverb.',
-  ],
-  // ['f', 'sagogo', ''],
-  // ['f', 'sclap', ''],
-  // ['f', 'sclaves', ''],
-  // ['f', 'scrash', ''],
+  ['size', 'sz', 'roomsize'],
+  // ['sagogo'],
+  // ['sclap'],
+  // ['sclaves'],
+  // ['scrash'],
   /**
    * Wave shaping distortion. CAUTION: it might get loud
    *
@@ -661,11 +583,7 @@ const generic_params = [
    * s("bd sd,hh*4").shape("<0 .2 .4 .6 .8>")
    *
    */
-  [
-    'f',
-    'shape',
-    'wave shaping distortion, a pattern of numbers from 0 for no distortion up to 1 for loads of distortion.',
-  ],
+  ['shape'],
   /**
    * Changes the speed of sample playback, i.e. a cheap way of changing pitch.
    *
@@ -677,11 +595,7 @@ const generic_params = [
    * speed("1 1.5*2 [2 1.1]").s("piano").clip(1)
    *
    */
-  [
-    'f',
-    'speed',
-    'a pattern of numbers which changes the speed of sample playback, i.e. a cheap way of changing pitch. Negative values will play the sample backwards!',
-  ],
+  ['speed'],
   /**
    * Used in conjunction with {@link speed}, accepts values of "r" (rate, default behavior), "c" (cycles), or "s" (seconds). Using `unit "c"` means `speed` will be interpreted in units of cycles, e.g. `speed "1"` means samples will be stretched to fill a cycle. Using `unit "s"` means the playback speed will be adjusted so that the duration is the number of seconds specified by `speed`.
    *
@@ -692,11 +606,7 @@ const generic_params = [
    * @superdirtOnly
    *
    */
-  [
-    's',
-    'unit',
-    'used in conjunction with `speed`, accepts values of "r" (rate, default behavior), "c" (cycles), or "s" (seconds). Using `unit "c"` means `speed` will be interpreted in units of cycles, e.g. `speed "1"` means samples will be stretched to fill a cycle. Using `unit "s"` means the playback speed will be adjusted so that the duration is the number of seconds specified by `speed`.',
-  ],
+  ['unit'],
   /**
    * Made by Calum Gunn. Reminiscent of some weird mixture of filter, ring-modulator and pitch-shifter. The SuperCollider manual defines Squiz as:
    *
@@ -709,14 +619,14 @@ const generic_params = [
    * @superdirtOnly
    *
    */
-  ['f', 'squiz', ''],
-  ['f', 'stutterdepth', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'stuttertime', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'timescale', ''], // TODO: what is this? not found in tidal doc
-  ['f', 'timescalewin', ''], // TODO: what is this? not found in tidal doc
-  // ['f', 'tomdecay', ''],
-  // ['f', 'vcfegint', ''],
-  // ['f', 'vcoegint', ''],
+  ['squiz'],
+  // ['stutterdepth'], // TODO: what is this? not found in tidal doc
+  // ['stuttertime'], // TODO: what is this? not found in tidal doc
+  // ['timescale'], // TODO: what is this? not found in tidal doc
+  // ['timescalewin'], // TODO: what is this? not found in tidal doc
+  // ['tomdecay'],
+  // ['vcfegint'],
+  // ['vcoegint'],
   // TODO: Use a rest (~) to override the effect <- vowel
   /**
    *
@@ -729,11 +639,7 @@ const generic_params = [
    * .vowel("<a e i <o u>>")
    *
    */
-  [
-    's',
-    'vowel',
-    'formant filter to make things sound like vowels, a pattern of either `a`, `e`, `i`, `o` or `u`. Use a rest (`~`) for no effect.',
-  ],
+  ['vowel'],
   /* // TODO: find out how it works
    * Made by Calum Gunn. Divides an audio stream into tiny segments, using the signal's zero-crossings as segment boundaries, and discards a fraction of them. Takes a number between 1 and 100, denoted the percentage of segments to drop. The SuperCollider manual describes the Waveloss effect this way:
    *
@@ -744,12 +650,12 @@ const generic_params = [
    *
    * @name waveloss
    */
-  ['f', 'waveloss', ''],
+  ['waveloss'],
   // TODO: midi effects?
-  ['f', 'dur', ''],
-  // ['f', 'modwheel', ''],
-  ['f', 'expression', ''],
-  ['f', 'sustainpedal', ''],
+  ['dur'],
+  // ['modwheel'],
+  ['expression'],
+  ['sustainpedal'],
   /* // TODO: doesn't seem to do anything
    *
    * Tremolo Audio DSP effect
@@ -760,59 +666,58 @@ const generic_params = [
    * n("0,4,7").tremolodepth("<0 .3 .6 .9>").osc()
    *
    */
-  // TODO: tremdp alias
-  ['f', 'tremolodepth', "Tremolo Audio DSP effect | params are 'tremolorate' and 'tremolodepth'"],
-  ['f', 'tremolorate', "Tremolo Audio DSP effect | params are 'tremolorate' and 'tremolodepth'"],
+  ['tremolodepth', 'tremdp'],
+  ['tremolorate', 'tremr'],
   // TODO: doesn't seem to do anything
-  ['f', 'phaserdepth', "Phaser Audio DSP effect | params are 'phaserrate' and 'phaserdepth'"],
-  ['f', 'phaserrate', "Phaser Audio DSP effect | params are 'phaserrate' and 'phaserdepth'"],
+  ['phaserdepth', 'phasdp'],
+  ['phaserrate', 'phasr'],
 
-  ['f', 'fshift', 'frequency shifter'],
-  ['f', 'fshiftnote', 'frequency shifter'],
-  ['f', 'fshiftphase', 'frequency shifter'],
+  ['fshift'],
+  ['fshiftnote'],
+  ['fshiftphase'],
 
-  ['f', 'triode', 'tube distortion'],
-  ['f', 'krush', 'shape/bass enhancer'],
-  ['f', 'kcutoff', ''],
-  ['f', 'octer', 'octaver effect'],
-  ['f', 'octersub', 'octaver effect'],
-  ['f', 'octersubsub', 'octaver effect'],
-  ['f', 'ring', 'ring modulation'],
-  ['f', 'ringf', 'ring modulation'],
-  ['f', 'ringdf', 'ring modulation'],
-  ['f', 'distort', 'noisy fuzzy distortion'],
-  ['f', 'freeze', 'Spectral freeze'],
-  ['f', 'xsdelay', ''],
-  ['f', 'tsdelay', ''],
-  ['f', 'real', 'Spectral conform'],
-  ['f', 'imag', ''],
-  ['f', 'enhance', 'Spectral enhance'],
-  ['f', 'partials', ''],
-  ['f', 'comb', 'Spectral comb'],
-  ['f', 'smear', 'Spectral smear'],
-  ['f', 'scram', 'Spectral scramble'],
-  ['f', 'binshift', 'Spectral binshift'],
-  ['f', 'hbrick', 'High pass sort of spectral filter'],
-  ['f', 'lbrick', 'Low pass sort of spectral filter'],
-  ['f', 'midichan', ''],
-  ['f', 'control', ''],
-  ['f', 'ccn', ''],
-  ['f', 'ccv', ''],
-  ['f', 'polyTouch', ''],
-  ['f', 'midibend', ''],
-  ['f', 'miditouch', ''],
-  ['f', 'ctlNum', ''],
-  ['f', 'frameRate', ''],
-  ['f', 'frames', ''],
-  ['f', 'hours', ''],
-  ['s', 'midicmd', ''],
-  ['f', 'minutes', ''],
-  ['f', 'progNum', ''],
-  ['f', 'seconds', ''],
-  ['f', 'songPtr', ''],
-  ['f', 'uid', ''],
-  ['f', 'val', ''],
-  ['f', 'cps', ''],
+  ['triode'],
+  ['krush'],
+  ['kcutoff'],
+  ['octer'],
+  ['octersub'],
+  ['octersubsub'],
+  ['ring'],
+  ['ringf'],
+  ['ringdf'],
+  ['distort'],
+  ['freeze'],
+  ['xsdelay'],
+  ['tsdelay'],
+  ['real'],
+  ['imag'],
+  ['enhance'],
+  ['partials'],
+  ['comb'],
+  ['smear'],
+  ['scram'],
+  ['binshift'],
+  ['hbrick'],
+  ['lbrick'],
+  ['midichan'],
+  ['control'],
+  ['ccn'],
+  ['ccv'],
+  ['polyTouch'],
+  ['midibend'],
+  ['miditouch'],
+  ['ctlNum'],
+  ['frameRate'],
+  ['frames'],
+  ['hours'],
+  ['midicmd'],
+  ['minutes'],
+  ['progNum'],
+  ['seconds'],
+  ['songPtr'],
+  ['uid'],
+  ['val'],
+  ['cps'],
   /**
    * If set to 1, samples will be cut to the duration of their event.
    * In tidal, this would be done with legato, which [is about to land in strudel too](https://github.com/tidalcycles/strudel/issues/111)
@@ -823,7 +728,7 @@ const generic_params = [
    * note("c a f e ~").s("piano").clip(1)
    *
    */
-  ['f', 'clip', ''],
+  ['clip'],
 ];
 
 // TODO: slice / splice https://www.youtube.com/watch?v=hKhPdO0RKDQ&list=PL2lW1zNIIwj3bDkh-Y3LUGDuRcoUigoDs&index=13
@@ -838,9 +743,13 @@ const _setter = (func, name) =>
     return this.set(func(...pats));
   };
 
-generic_params.forEach(([type, name, description]) => {
+generic_params.forEach(([name, ...aliases]) => {
   controls[name] = (...pats) => _name(name, ...pats);
   Pattern.prototype[name] = _setter(controls[name], name);
+  aliases.forEach((alias) => {
+    controls[alias] = controls[name];
+    Pattern.prototype[alias] = Pattern.prototype[name];
+  });
 });
 
 // create custom param

packages/webaudio/webaudio.mjs

@@ -208,20 +208,14 @@ export const webaudioOutput = async (hap, deadline, hapDuration) => {
     note,
     gain = 0.8,
     // low pass
-    lpf,
-    cutoff = lpf,
-    lpq = 1,
-    resonance = lpq,
+    cutoff,
+    resonance = 1,
     // high pass
-    hpf,
-    hcutoff = hpf,
-    hpq = 1,
-    hresonance = hpq,
+    hcutoff,
+    hresonance = 1,
     // band pass
-    bpf,
-    bandf = bpf,
-    bpq = 1,
-    bandq = bpq,
+    bandf,
+    bandq = 1,
     //
     coarse,
     crush,
@@ -241,7 +235,6 @@ export const webaudioOutput = async (hap, deadline, hapDuration) => {
     orbit = 1,
     room,
     size = 2,
-    roomsize = size,
   } = hap.value;
   const { velocity = 1 } = hap.context;
   gain *= velocity; // legacy fix for velocity
@@ -373,8 +366,8 @@ export const webaudioOutput = async (hap, deadline, hapDuration) => {
   }
   // reverb
   let reverbSend;
-  if (room > 0 && roomsize > 0) {
-    const reverbNode = getReverb(orbit, roomsize);
+  if (room > 0 && size > 0) {
+    const reverbNode = getReverb(orbit, size);
     reverbSend = effectSend(post, reverbNode, room);
   }
 

test/__snapshots__/examples.test.mjs.snap

@@ -885,39 +885,39 @@ exports[`runs examples > example "begin" example index 0 1`] = `
 
 exports[`runs examples > example "bpf" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd bpf:1000 ]",
-  "[ 1/2 → 1/1 | s:sd bpf:1000 ]",
-  "[ 0/1 → 1/3 | s:hh bpf:1000 ]",
-  "[ 1/3 → 2/3 | s:hh bpf:1000 ]",
-  "[ 2/3 → 1/1 | s:hh bpf:1000 ]",
-  "[ 1/1 → 3/2 | s:bd bpf:2000 ]",
-  "[ 3/2 → 2/1 | s:sd bpf:2000 ]",
-  "[ 1/1 → 4/3 | s:hh bpf:2000 ]",
-  "[ 4/3 → 5/3 | s:hh bpf:2000 ]",
-  "[ 5/3 → 2/1 | s:hh bpf:2000 ]",
-  "[ 2/1 → 5/2 | s:bd bpf:4000 ]",
-  "[ 5/2 → 3/1 | s:sd bpf:4000 ]",
-  "[ 2/1 → 7/3 | s:hh bpf:4000 ]",
-  "[ 7/3 → 8/3 | s:hh bpf:4000 ]",
-  "[ 8/3 → 3/1 | s:hh bpf:4000 ]",
-  "[ 3/1 → 7/2 | s:bd bpf:8000 ]",
-  "[ 7/2 → 4/1 | s:sd bpf:8000 ]",
-  "[ 3/1 → 10/3 | s:hh bpf:8000 ]",
-  "[ 10/3 → 11/3 | s:hh bpf:8000 ]",
-  "[ 11/3 → 4/1 | s:hh bpf:8000 ]",
+  "[ 0/1 → 1/2 | s:bd bandf:1000 ]",
+  "[ 1/2 → 1/1 | s:sd bandf:1000 ]",
+  "[ 0/1 → 1/3 | s:hh bandf:1000 ]",
+  "[ 1/3 → 2/3 | s:hh bandf:1000 ]",
+  "[ 2/3 → 1/1 | s:hh bandf:1000 ]",
+  "[ 1/1 → 3/2 | s:bd bandf:2000 ]",
+  "[ 3/2 → 2/1 | s:sd bandf:2000 ]",
+  "[ 1/1 → 4/3 | s:hh bandf:2000 ]",
+  "[ 4/3 → 5/3 | s:hh bandf:2000 ]",
+  "[ 5/3 → 2/1 | s:hh bandf:2000 ]",
+  "[ 2/1 → 5/2 | s:bd bandf:4000 ]",
+  "[ 5/2 → 3/1 | s:sd bandf:4000 ]",
+  "[ 2/1 → 7/3 | s:hh bandf:4000 ]",
+  "[ 7/3 → 8/3 | s:hh bandf:4000 ]",
+  "[ 8/3 → 3/1 | s:hh bandf:4000 ]",
+  "[ 3/1 → 7/2 | s:bd bandf:8000 ]",
+  "[ 7/2 → 4/1 | s:sd bandf:8000 ]",
+  "[ 3/1 → 10/3 | s:hh bandf:8000 ]",
+  "[ 10/3 → 11/3 | s:hh bandf:8000 ]",
+  "[ 11/3 → 4/1 | s:hh bandf:8000 ]",
 ]
 `;
 
 exports[`runs examples > example "bpq" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd bpf:500 bpq:0 ]",
-  "[ 1/2 → 1/1 | s:sd bpf:500 bpq:0 ]",
-  "[ 1/1 → 3/2 | s:bd bpf:500 bpq:1 ]",
-  "[ 3/2 → 2/1 | s:sd bpf:500 bpq:1 ]",
-  "[ 2/1 → 5/2 | s:bd bpf:500 bpq:2 ]",
-  "[ 5/2 → 3/1 | s:sd bpf:500 bpq:2 ]",
-  "[ 3/1 → 7/2 | s:bd bpf:500 bpq:3 ]",
-  "[ 7/2 → 4/1 | s:sd bpf:500 bpq:3 ]",
+  "[ 0/1 → 1/2 | s:bd bandf:500 bandq:0 ]",
+  "[ 1/2 → 1/1 | s:sd bandf:500 bandq:0 ]",
+  "[ 1/1 → 3/2 | s:bd bandf:500 bandq:1 ]",
+  "[ 3/2 → 2/1 | s:sd bandf:500 bandq:1 ]",
+  "[ 2/1 → 5/2 | s:bd bandf:500 bandq:2 ]",
+  "[ 5/2 → 3/1 | s:sd bandf:500 bandq:2 ]",
+  "[ 3/1 → 7/2 | s:bd bandf:500 bandq:3 ]",
+  "[ 7/2 → 4/1 | s:sd bandf:500 bandq:3 ]",
 ]
 `;
 
@@ -1896,59 +1896,59 @@ exports[`runs examples > example "gain" example index 0 1`] = `
 
 exports[`runs examples > example "hpf" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd hpf:4000 ]",
-  "[ 1/2 → 1/1 | s:sd hpf:4000 ]",
-  "[ 0/1 → 1/4 | s:hh hpf:4000 ]",
-  "[ 1/4 → 1/2 | s:hh hpf:4000 ]",
-  "[ 1/2 → 3/4 | s:hh hpf:4000 ]",
-  "[ 3/4 → 1/1 | s:hh hpf:4000 ]",
-  "[ 1/1 → 3/2 | s:bd hpf:2000 ]",
-  "[ 3/2 → 2/1 | s:sd hpf:2000 ]",
-  "[ 1/1 → 5/4 | s:hh hpf:2000 ]",
-  "[ 5/4 → 3/2 | s:hh hpf:2000 ]",
-  "[ 3/2 → 7/4 | s:hh hpf:2000 ]",
-  "[ 7/4 → 2/1 | s:hh hpf:2000 ]",
-  "[ 2/1 → 5/2 | s:bd hpf:1000 ]",
-  "[ 5/2 → 3/1 | s:sd hpf:1000 ]",
-  "[ 2/1 → 9/4 | s:hh hpf:1000 ]",
-  "[ 9/4 → 5/2 | s:hh hpf:1000 ]",
-  "[ 5/2 → 11/4 | s:hh hpf:1000 ]",
-  "[ 11/4 → 3/1 | s:hh hpf:1000 ]",
-  "[ 3/1 → 7/2 | s:bd hpf:500 ]",
-  "[ 7/2 → 4/1 | s:sd hpf:500 ]",
-  "[ 3/1 → 13/4 | s:hh hpf:500 ]",
-  "[ 13/4 → 7/2 | s:hh hpf:500 ]",
-  "[ 7/2 → 15/4 | s:hh hpf:500 ]",
-  "[ 15/4 → 4/1 | s:hh hpf:500 ]",
+  "[ 0/1 → 1/2 | s:bd hcutoff:4000 ]",
+  "[ 1/2 → 1/1 | s:sd hcutoff:4000 ]",
+  "[ 0/1 → 1/4 | s:hh hcutoff:4000 ]",
+  "[ 1/4 → 1/2 | s:hh hcutoff:4000 ]",
+  "[ 1/2 → 3/4 | s:hh hcutoff:4000 ]",
+  "[ 3/4 → 1/1 | s:hh hcutoff:4000 ]",
+  "[ 1/1 → 3/2 | s:bd hcutoff:2000 ]",
+  "[ 3/2 → 2/1 | s:sd hcutoff:2000 ]",
+  "[ 1/1 → 5/4 | s:hh hcutoff:2000 ]",
+  "[ 5/4 → 3/2 | s:hh hcutoff:2000 ]",
+  "[ 3/2 → 7/4 | s:hh hcutoff:2000 ]",
+  "[ 7/4 → 2/1 | s:hh hcutoff:2000 ]",
+  "[ 2/1 → 5/2 | s:bd hcutoff:1000 ]",
+  "[ 5/2 → 3/1 | s:sd hcutoff:1000 ]",
+  "[ 2/1 → 9/4 | s:hh hcutoff:1000 ]",
+  "[ 9/4 → 5/2 | s:hh hcutoff:1000 ]",
+  "[ 5/2 → 11/4 | s:hh hcutoff:1000 ]",
+  "[ 11/4 → 3/1 | s:hh hcutoff:1000 ]",
+  "[ 3/1 → 7/2 | s:bd hcutoff:500 ]",
+  "[ 7/2 → 4/1 | s:sd hcutoff:500 ]",
+  "[ 3/1 → 13/4 | s:hh hcutoff:500 ]",
+  "[ 13/4 → 7/2 | s:hh hcutoff:500 ]",
+  "[ 7/2 → 15/4 | s:hh hcutoff:500 ]",
+  "[ 15/4 → 4/1 | s:hh hcutoff:500 ]",
 ]
 `;
 
 exports[`runs examples > example "hpq" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd hpf:2000 hpq:0 ]",
-  "[ 1/2 → 1/1 | s:sd hpf:2000 hpq:0 ]",
-  "[ 0/1 → 1/4 | s:hh hpf:2000 hpq:0 ]",
-  "[ 1/4 → 1/2 | s:hh hpf:2000 hpq:0 ]",
-  "[ 1/2 → 3/4 | s:hh hpf:2000 hpq:0 ]",
-  "[ 3/4 → 1/1 | s:hh hpf:2000 hpq:0 ]",
-  "[ 1/1 → 3/2 | s:bd hpf:2000 hpq:10 ]",
-  "[ 3/2 → 2/1 | s:sd hpf:2000 hpq:10 ]",
-  "[ 1/1 → 5/4 | s:hh hpf:2000 hpq:10 ]",
-  "[ 5/4 → 3/2 | s:hh hpf:2000 hpq:10 ]",
-  "[ 3/2 → 7/4 | s:hh hpf:2000 hpq:10 ]",
-  "[ 7/4 → 2/1 | s:hh hpf:2000 hpq:10 ]",
-  "[ 2/1 → 5/2 | s:bd hpf:2000 hpq:20 ]",
-  "[ 5/2 → 3/1 | s:sd hpf:2000 hpq:20 ]",
-  "[ 2/1 → 9/4 | s:hh hpf:2000 hpq:20 ]",
-  "[ 9/4 → 5/2 | s:hh hpf:2000 hpq:20 ]",
-  "[ 5/2 → 11/4 | s:hh hpf:2000 hpq:20 ]",
-  "[ 11/4 → 3/1 | s:hh hpf:2000 hpq:20 ]",
-  "[ 3/1 → 7/2 | s:bd hpf:2000 hpq:30 ]",
-  "[ 7/2 → 4/1 | s:sd hpf:2000 hpq:30 ]",
-  "[ 3/1 → 13/4 | s:hh hpf:2000 hpq:30 ]",
-  "[ 13/4 → 7/2 | s:hh hpf:2000 hpq:30 ]",
-  "[ 7/2 → 15/4 | s:hh hpf:2000 hpq:30 ]",
-  "[ 15/4 → 4/1 | s:hh hpf:2000 hpq:30 ]",
+  "[ 0/1 → 1/2 | s:bd hcutoff:2000 hresonance:0 ]",
+  "[ 1/2 → 1/1 | s:sd hcutoff:2000 hresonance:0 ]",
+  "[ 0/1 → 1/4 | s:hh hcutoff:2000 hresonance:0 ]",
+  "[ 1/4 → 1/2 | s:hh hcutoff:2000 hresonance:0 ]",
+  "[ 1/2 → 3/4 | s:hh hcutoff:2000 hresonance:0 ]",
+  "[ 3/4 → 1/1 | s:hh hcutoff:2000 hresonance:0 ]",
+  "[ 1/1 → 3/2 | s:bd hcutoff:2000 hresonance:10 ]",
+  "[ 3/2 → 2/1 | s:sd hcutoff:2000 hresonance:10 ]",
+  "[ 1/1 → 5/4 | s:hh hcutoff:2000 hresonance:10 ]",
+  "[ 5/4 → 3/2 | s:hh hcutoff:2000 hresonance:10 ]",
+  "[ 3/2 → 7/4 | s:hh hcutoff:2000 hresonance:10 ]",
+  "[ 7/4 → 2/1 | s:hh hcutoff:2000 hresonance:10 ]",
+  "[ 2/1 → 5/2 | s:bd hcutoff:2000 hresonance:20 ]",
+  "[ 5/2 → 3/1 | s:sd hcutoff:2000 hresonance:20 ]",
+  "[ 2/1 → 9/4 | s:hh hcutoff:2000 hresonance:20 ]",
+  "[ 9/4 → 5/2 | s:hh hcutoff:2000 hresonance:20 ]",
+  "[ 5/2 → 11/4 | s:hh hcutoff:2000 hresonance:20 ]",
+  "[ 11/4 → 3/1 | s:hh hcutoff:2000 hresonance:20 ]",
+  "[ 3/1 → 7/2 | s:bd hcutoff:2000 hresonance:30 ]",
+  "[ 7/2 → 4/1 | s:sd hcutoff:2000 hresonance:30 ]",
+  "[ 3/1 → 13/4 | s:hh hcutoff:2000 hresonance:30 ]",
+  "[ 13/4 → 7/2 | s:hh hcutoff:2000 hresonance:30 ]",
+  "[ 7/2 → 15/4 | s:hh hcutoff:2000 hresonance:30 ]",
+  "[ 15/4 → 4/1 | s:hh hcutoff:2000 hresonance:30 ]",
 ]
 `;
 
@@ -2383,55 +2383,55 @@ exports[`runs examples > example "loopAtCps" example index 0 1`] = `
 
 exports[`runs examples > example "lpf" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd lpf:4000 ]",
-  "[ 1/2 → 1/1 | s:sd lpf:4000 ]",
-  "[ 0/1 → 1/3 | s:hh lpf:4000 ]",
-  "[ 1/3 → 2/3 | s:hh lpf:4000 ]",
-  "[ 2/3 → 1/1 | s:hh lpf:4000 ]",
-  "[ 1/1 → 3/2 | s:bd lpf:2000 ]",
-  "[ 3/2 → 2/1 | s:sd lpf:2000 ]",
-  "[ 1/1 → 4/3 | s:hh lpf:2000 ]",
-  "[ 4/3 → 5/3 | s:hh lpf:2000 ]",
-  "[ 5/3 → 2/1 | s:hh lpf:2000 ]",
-  "[ 2/1 → 5/2 | s:bd lpf:1000 ]",
-  "[ 5/2 → 3/1 | s:sd lpf:1000 ]",
-  "[ 2/1 → 7/3 | s:hh lpf:1000 ]",
-  "[ 7/3 → 8/3 | s:hh lpf:1000 ]",
-  "[ 8/3 → 3/1 | s:hh lpf:1000 ]",
-  "[ 3/1 → 7/2 | s:bd lpf:500 ]",
-  "[ 7/2 → 4/1 | s:sd lpf:500 ]",
-  "[ 3/1 → 10/3 | s:hh lpf:500 ]",
-  "[ 10/3 → 11/3 | s:hh lpf:500 ]",
-  "[ 11/3 → 4/1 | s:hh lpf:500 ]",
+  "[ 0/1 → 1/2 | s:bd cutoff:4000 ]",
+  "[ 1/2 → 1/1 | s:sd cutoff:4000 ]",
+  "[ 0/1 → 1/3 | s:hh cutoff:4000 ]",
+  "[ 1/3 → 2/3 | s:hh cutoff:4000 ]",
+  "[ 2/3 → 1/1 | s:hh cutoff:4000 ]",
+  "[ 1/1 → 3/2 | s:bd cutoff:2000 ]",
+  "[ 3/2 → 2/1 | s:sd cutoff:2000 ]",
+  "[ 1/1 → 4/3 | s:hh cutoff:2000 ]",
+  "[ 4/3 → 5/3 | s:hh cutoff:2000 ]",
+  "[ 5/3 → 2/1 | s:hh cutoff:2000 ]",
+  "[ 2/1 → 5/2 | s:bd cutoff:1000 ]",
+  "[ 5/2 → 3/1 | s:sd cutoff:1000 ]",
+  "[ 2/1 → 7/3 | s:hh cutoff:1000 ]",
+  "[ 7/3 → 8/3 | s:hh cutoff:1000 ]",
+  "[ 8/3 → 3/1 | s:hh cutoff:1000 ]",
+  "[ 3/1 → 7/2 | s:bd cutoff:500 ]",
+  "[ 7/2 → 4/1 | s:sd cutoff:500 ]",
+  "[ 3/1 → 10/3 | s:hh cutoff:500 ]",
+  "[ 10/3 → 11/3 | s:hh cutoff:500 ]",
+  "[ 11/3 → 4/1 | s:hh cutoff:500 ]",
 ]
 `;
 
 exports[`runs examples > example "lpq" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd lpf:2000 lpq:0 ]",
-  "[ 1/2 → 1/1 | s:sd lpf:2000 lpq:0 ]",
-  "[ 0/1 → 1/4 | s:hh lpf:2000 lpq:0 ]",
-  "[ 1/4 → 1/2 | s:hh lpf:2000 lpq:0 ]",
-  "[ 1/2 → 3/4 | s:hh lpf:2000 lpq:0 ]",
-  "[ 3/4 → 1/1 | s:hh lpf:2000 lpq:0 ]",
-  "[ 1/1 → 3/2 | s:bd lpf:2000 lpq:10 ]",
-  "[ 3/2 → 2/1 | s:sd lpf:2000 lpq:10 ]",
-  "[ 1/1 → 5/4 | s:hh lpf:2000 lpq:10 ]",
-  "[ 5/4 → 3/2 | s:hh lpf:2000 lpq:10 ]",
-  "[ 3/2 → 7/4 | s:hh lpf:2000 lpq:10 ]",
-  "[ 7/4 → 2/1 | s:hh lpf:2000 lpq:10 ]",
-  "[ 2/1 → 5/2 | s:bd lpf:2000 lpq:20 ]",
-  "[ 5/2 → 3/1 | s:sd lpf:2000 lpq:20 ]",
-  "[ 2/1 → 9/4 | s:hh lpf:2000 lpq:20 ]",
-  "[ 9/4 → 5/2 | s:hh lpf:2000 lpq:20 ]",
-  "[ 5/2 → 11/4 | s:hh lpf:2000 lpq:20 ]",
-  "[ 11/4 → 3/1 | s:hh lpf:2000 lpq:20 ]",
-  "[ 3/1 → 7/2 | s:bd lpf:2000 lpq:30 ]",
-  "[ 7/2 → 4/1 | s:sd lpf:2000 lpq:30 ]",
-  "[ 3/1 → 13/4 | s:hh lpf:2000 lpq:30 ]",
-  "[ 13/4 → 7/2 | s:hh lpf:2000 lpq:30 ]",
-  "[ 7/2 → 15/4 | s:hh lpf:2000 lpq:30 ]",
-  "[ 15/4 → 4/1 | s:hh lpf:2000 lpq:30 ]",
+  "[ 0/1 → 1/2 | s:bd cutoff:2000 resonance:0 ]",
+  "[ 1/2 → 1/1 | s:sd cutoff:2000 resonance:0 ]",
+  "[ 0/1 → 1/4 | s:hh cutoff:2000 resonance:0 ]",
+  "[ 1/4 → 1/2 | s:hh cutoff:2000 resonance:0 ]",
+  "[ 1/2 → 3/4 | s:hh cutoff:2000 resonance:0 ]",
+  "[ 3/4 → 1/1 | s:hh cutoff:2000 resonance:0 ]",
+  "[ 1/1 → 3/2 | s:bd cutoff:2000 resonance:10 ]",
+  "[ 3/2 → 2/1 | s:sd cutoff:2000 resonance:10 ]",
+  "[ 1/1 → 5/4 | s:hh cutoff:2000 resonance:10 ]",
+  "[ 5/4 → 3/2 | s:hh cutoff:2000 resonance:10 ]",
+  "[ 3/2 → 7/4 | s:hh cutoff:2000 resonance:10 ]",
+  "[ 7/4 → 2/1 | s:hh cutoff:2000 resonance:10 ]",
+  "[ 2/1 → 5/2 | s:bd cutoff:2000 resonance:20 ]",
+  "[ 5/2 → 3/1 | s:sd cutoff:2000 resonance:20 ]",
+  "[ 2/1 → 9/4 | s:hh cutoff:2000 resonance:20 ]",
+  "[ 9/4 → 5/2 | s:hh cutoff:2000 resonance:20 ]",
+  "[ 5/2 → 11/4 | s:hh cutoff:2000 resonance:20 ]",
+  "[ 11/4 → 3/1 | s:hh cutoff:2000 resonance:20 ]",
+  "[ 3/1 → 7/2 | s:bd cutoff:2000 resonance:30 ]",
+  "[ 7/2 → 4/1 | s:sd cutoff:2000 resonance:30 ]",
+  "[ 3/1 → 13/4 | s:hh cutoff:2000 resonance:30 ]",
+  "[ 13/4 → 7/2 | s:hh cutoff:2000 resonance:30 ]",
+  "[ 7/2 → 15/4 | s:hh cutoff:2000 resonance:30 ]",
+  "[ 15/4 → 4/1 | s:hh cutoff:2000 resonance:30 ]",
 ]
 `;
 
@@ -3233,14 +3233,14 @@ exports[`runs examples > example "room" example index 0 1`] = `
 
 exports[`runs examples > example "roomsize" example index 0 1`] = `
 [
-  "[ 0/1 → 1/2 | s:bd room:0.8 roomsize:0 ]",
-  "[ 1/2 → 1/1 | s:sd room:0.8 roomsize:0 ]",
-  "[ 1/1 → 3/2 | s:bd room:0.8 roomsize:1 ]",
-  "[ 3/2 → 2/1 | s:sd room:0.8 roomsize:1 ]",
-  "[ 2/1 → 5/2 | s:bd room:0.8 roomsize:2 ]",
-  "[ 5/2 → 3/1 | s:sd room:0.8 roomsize:2 ]",
-  "[ 3/1 → 7/2 | s:bd room:0.8 roomsize:4 ]",
-  "[ 7/2 → 4/1 | s:sd room:0.8 roomsize:4 ]",
+  "[ 0/1 → 1/2 | s:bd room:0.8 size:0 ]",
+  "[ 1/2 → 1/1 | s:sd room:0.8 size:0 ]",
+  "[ 1/1 → 3/2 | s:bd room:0.8 size:1 ]",
+  "[ 3/2 → 2/1 | s:sd room:0.8 size:1 ]",
+  "[ 2/1 → 5/2 | s:bd room:0.8 size:2 ]",
+  "[ 5/2 → 3/1 | s:sd room:0.8 size:2 ]",
+  "[ 3/1 → 7/2 | s:bd room:0.8 size:4 ]",
+  "[ 7/2 → 4/1 | s:sd room:0.8 size:4 ]",
 ]
 `;
 
@@ -3690,39 +3690,6 @@ exports[`runs examples > example "sine" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "slice" example index 0 1`] = `
-[
-  "[ (15/16 → 1/1) ⇝ 9/8 | begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 3/4 → 15/16 | begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 21/32 → 3/4 | begin:0.5 end:0.625 _slices:8 s:breaks165 ]",
-  "[ 9/16 → 21/32 | begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 3/8 → 9/16 | begin:0.625 end:0.75 _slices:8 s:breaks165 ]",
-  "[ 3/16 → 3/8 | begin:0.75 end:0.875 _slices:8 s:breaks165 ]",
-  "[ 0/1 → 3/16 | begin:0.875 end:1 _slices:8 s:breaks165 ]",
-  "[ 21/16 → 3/2 | begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 9/8 → 21/16 | begin:0.125 end:0.25 _slices:8 s:breaks165 ]",
-  "[ 15/16 ⇜ (1/1 → 9/8) | begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 3/2 → 27/16 | begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 27/16 → 15/8 | begin:0.125 end:0.25 _slices:8 s:breaks165 ]",
-  "[ 15/8 → 63/32 | begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ (63/32 → 2/1) ⇝ 33/16 | begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 63/32 ⇜ (2/1 → 33/16) | begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 33/16 → 9/4 | begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 9/4 → 75/32 | begin:0.5 end:0.625 _slices:8 s:breaks165 ]",
-  "[ 75/32 → 39/16 | begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 39/16 → 21/8 | begin:0.625 end:0.75 _slices:8 s:breaks165 ]",
-  "[ 21/8 → 45/16 | begin:0.75 end:0.875 _slices:8 s:breaks165 ]",
-  "[ 45/16 → 3/1 | begin:0.875 end:1 _slices:8 s:breaks165 ]",
-  "[ 3/1 → 51/16 | begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 51/16 → 27/8 | begin:0.125 end:0.25 _slices:8 s:breaks165 ]",
-  "[ 27/8 → 57/16 | begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 57/16 → 15/4 | begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 15/4 → 123/32 | begin:0.5 end:0.625 _slices:8 s:breaks165 ]",
-  "[ 123/32 → 63/16 | begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ (63/16 → 4/1) ⇝ 33/8 | begin:0.625 end:0.75 _slices:8 s:breaks165 ]",
-]
-`;
-
 exports[`runs examples > example "slow" example index 0 1`] = `
 [
   "[ 0/1 → 1/1 | s:bd ]",
@@ -3848,36 +3815,6 @@ exports[`runs examples > example "speed" example index 1 1`] = `
 ]
 `;
 
-exports[`runs examples > example "splice" example index 0 1`] = `
-[
-  "[ 0/1 → 5/26 | speed:0.65 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 5/26 → 5/13 | speed:0.65 unit:c begin:0.125 end:0.25 _slices:8 s:breaks165 ]",
-  "[ 5/13 → 20/39 | speed:0.9750000000000001 unit:c begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 20/39 → 25/39 | speed:0.9750000000000001 unit:c begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 25/39 → 10/13 | speed:0.9750000000000001 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 10/13 → 25/26 | speed:0.65 unit:c begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ (25/26 → 1/1) ⇝ 35/26 | speed:0.325 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 25/26 ⇜ (1/1 → 35/26) | speed:0.325 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 35/26 → 20/13 | speed:0.65 unit:c begin:0.875 end:1 _slices:8 s:breaks165 ]",
-  "[ 20/13 → 45/26 | speed:0.65 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 45/26 → 25/13 | speed:0.65 unit:c begin:0.125 end:0.25 _slices:8 s:breaks165 ]",
-  "[ (25/13 → 2/1) ⇝ 80/39 | speed:0.9750000000000001 unit:c begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 25/13 ⇜ (2/1 → 80/39) | speed:0.9750000000000001 unit:c begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 80/39 → 85/39 | speed:0.9750000000000001 unit:c begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 85/39 → 30/13 | speed:0.9750000000000001 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 30/13 → 5/2 | speed:0.65 unit:c begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 5/2 → 75/26 | speed:0.325 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ (75/26 → 3/1) ⇝ 40/13 | speed:0.65 unit:c begin:0.875 end:1 _slices:8 s:breaks165 ]",
-  "[ 75/26 ⇜ (3/1 → 40/13) | speed:0.65 unit:c begin:0.875 end:1 _slices:8 s:breaks165 ]",
-  "[ 40/13 → 85/26 | speed:0.65 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ 85/26 → 45/13 | speed:0.65 unit:c begin:0.125 end:0.25 _slices:8 s:breaks165 ]",
-  "[ 45/13 → 140/39 | speed:0.9750000000000001 unit:c begin:0.25 end:0.375 _slices:8 s:breaks165 ]",
-  "[ 140/39 → 145/39 | speed:0.9750000000000001 unit:c begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-  "[ 145/39 → 50/13 | speed:0.9750000000000001 unit:c begin:0 end:0.125 _slices:8 s:breaks165 ]",
-  "[ (50/13 → 4/1) ⇝ 105/26 | speed:0.65 unit:c begin:0.375 end:0.5 _slices:8 s:breaks165 ]",
-]
-`;
-
 exports[`runs examples > example "square" example index 0 1`] = `
 [
   "[ 0/1 → 1/2 | note:C3 ]",
@@ -4294,48 +4231,6 @@ exports[`runs examples > example "vowel" example index 0 1`] = `
 ]
 `;
 
-exports[`runs examples > example "weave" example index 0 1`] = `
-[
-  "[ 0/1 → 1/8 | pan:0.015625 s:bd ]",
-  "[ 3/8 → 1/2 | pan:0.109375 s:bd ]",
-  "[ 3/4 → 7/8 | pan:0.203125 s:bd ]",
-  "[ 1/1 → 9/8 | pan:0.265625 s:bd ]",
-  "[ 11/8 → 3/2 | pan:0.359375 s:bd ]",
-  "[ 7/4 → 15/8 | pan:0.453125 s:bd ]",
-  "[ 2/1 → 17/8 | pan:0.515625 s:bd ]",
-  "[ 19/8 → 5/2 | pan:0.609375 s:bd ]",
-  "[ 11/4 → 23/8 | pan:0.703125 s:bd ]",
-  "[ 3/1 → 25/8 | pan:0.765625 s:bd ]",
-  "[ 27/8 → 7/2 | pan:0.859375 s:bd ]",
-  "[ 15/4 → 31/8 | pan:0.953125 s:bd ]",
-  "[ 1/2 → 1/1 | pan:0.6875 s:sd ]",
-  "[ 3/2 → 2/1 | pan:0.9375 s:sd ]",
-  "[ 5/2 → 3/1 | pan:0.1875 s:sd ]",
-  "[ 7/2 → 4/1 | pan:0.4375 s:sd ]",
-]
-`;
-
-exports[`runs examples > example "weave" example index 1 1`] = `
-[
-  "[ 0/1 → 1/8 | n:0 s:bd ]",
-  "[ 3/8 → 1/2 | n:0 s:bd ]",
-  "[ 3/4 → 7/8 | n:0 s:bd ]",
-  "[ 1/1 → 9/8 | n:1 s:bd ]",
-  "[ 11/8 → 3/2 | n:1 s:bd ]",
-  "[ 7/4 → 15/8 | n:1 s:bd ]",
-  "[ 2/1 → 17/8 | n:2 s:bd ]",
-  "[ 19/8 → 5/2 | n:2 s:bd ]",
-  "[ 11/4 → 23/8 | n:2 s:bd ]",
-  "[ 3/1 → 25/8 | n:3 s:bd ]",
-  "[ 27/8 → 7/2 | n:3 s:bd ]",
-  "[ 15/4 → 31/8 | n:3 s:bd ]",
-  "[ 1/2 → 1/1 | n:4 s:sd ]",
-  "[ 3/2 → 2/1 | n:5 s:sd ]",
-  "[ 5/2 → 3/1 | n:6 s:sd ]",
-  "[ 7/2 → 4/1 | n:7 s:sd ]",
-]
-`;
-
 exports[`runs examples > example "webdirt" example index 0 1`] = `
 [
   "[ 0/1 → 1/8 | s:bd n:0 ]",