Typos and some examples

packages/core/pattern.mjs

@@ -3729,6 +3729,22 @@ export const phases = (list) => {
  * @name FX
  * @memberof Pattern
  * @returns Pattern
+ * @example
+ * $: s("[sbd <hh [bd | lt | oh]>]*4").dec(.4)
+ *   .FX(
+ *     phaser(0.5).gain(2),
+ *     bpf(800),
+ *     distort(1.3),
+ *     room(0.2),
+ *     delay(0.5).gain(1.25),
+ *     distort(0.3),
+ *   ).fxr(1.7) // sets release time of effects (like delay)
+ * @example
+ * $: s("saw").fm(0.5)
+ *   .delay(0.3) // outer effects are applied *last*
+ *   .FX(coarse(4)) // first coarse
+ *   .FX(lpf(500).lpe(4).lpa(1).lpd(2)) // then lpf
+ *   .FX(distort(1)) // then distort
  */
 Pattern.prototype.FX = function (...effects) {
   effects = effects.map(reify);

packages/superdough/modulators.mjs

@@ -112,7 +112,7 @@ export const connectLFO = (id, params, nodeTracker) => {
     max,
   };
   const lfoNode = getLfo(getAudioContext(), modParams);
-  nodeTracker[0][`lfo_${id}`] = [lfoNode];
+  nodeTracker.main[`lfo_${id}`] = [lfoNode];
   targetParams.forEach((t) => lfoNode.connect(t));
   return lfoNode;
 };
@@ -134,7 +134,7 @@ export const connectEnvelope = (id, params, nodeTracker) => {
     decayCurve: dcurve,
     releaseCurve: rcurve,
   });
-  nodeTracker[0][`env_${id}`] = [envNode];
+  nodeTracker.main[`env_${id}`] = [envNode];
   targetParams.forEach((t) => envNode.connect(t));
   return envNode;
 };

packages/superdough/superdough.mjs

@@ -196,6 +196,7 @@ let defaultDefaultValues = {
   fft: 8,
   tremolodepth: 1,
   tremolophase: 0,
+  release: 0.01,
 };
 
 const defaultDefaultDefaultValues = Object.freeze({ ...defaultDefaultValues });
@@ -473,7 +474,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     duckattack,
     duckdepth,
     djf,
-    release = 0.01,
+    release = getDefaultValue('release'),
     dry,
     delay = getDefaultValue('delay'),
     delayfeedback = getDefaultValue('delayfeedback'),
@@ -544,7 +545,18 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     nodes.main['source'] = [sourceNode];
   } else if (getSound(s)) {
     const { onTrigger } = getSound(s);
-    const onEnded = () => {};
+    // We have to use onEnded because some sources (e.g. `sampler`) have
+    // an internal duration which is longer than `value.duration`
+    const onEnded = () =>
+      webAudioTimeout(
+        ac,
+        () => {
+          chain.releaseNodes();
+          activeSoundSources.delete(chainID);
+        },
+        0,
+        endWithRelease,
+      );
     const soundHandle = await onTrigger(t, value, onEnded, cps);
 
     if (soundHandle) {
@@ -566,7 +578,7 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
     return;
   }
 
-  const chain = new Chain(sourceNode); // audio nodes that will be connected to each other sequentially
+  const chain = new Chain(sourceNode); // connection manager which tracks audio nodes for releasing
   FX = [...FX, value]; // run through the FX chain and then run through all FX outside of it as well
   for (let [idx, fx] of Object.entries(FX)) {
     const key = idx == FX.length - 1 ? 'main' : idx;
@@ -990,15 +1002,6 @@ export const superdough = async (value, t, hapDuration, cps = 0.5, cycle = 0.5)
       }
     }
   });
-  webAudioTimeout(
-    ac,
-    () => {
-      chain.releaseNodes();
-      activeSoundSources.delete(chainID);
-    },
-    0,
-    endWithRelease,
-  );
 };
 
 export const superdoughTrigger = (t, hap, ct, cps) => {