rlo-engine 1.0.3 → 1.1.0

package/dist/Instruments/Decay/ChromaticPercussionSynth.js

@@ -3,21 +3,28 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for Chromatic Percussion (Bells, Marimba, Vibraphone).
  * Characterized by a pure tone with a very fast attack and immediate decay.
  */
+/**
+ * Emulates struck melodic instruments like a Glockenspiel or Marimba using rapid decay envelopes and metallic overtones.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class ChromaticPercussionSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.7, a: 0.005, d: 0.5, m: 6.0 };
+        this._envelopeConfig = { _peakVelocity: 0.7, _attackTimeSeconds: 0.005, _decayTimeSeconds: 0.5, _maxDurationSeconds: 6.0 };
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
-        const osc = this._osc(ctx, 0 /* Osc.Sine */, 0, gain);
-        this._set(osc.frequency, freq * 1.1, time);
-        this._exp(osc.frequency, freq, time + 0.02);
-        const overtoneGain = this._gain(ctx, 0, masterGain);
-        this._set(overtoneGain.gain, Math.max(0.001, velocity * 0.25), time);
-        this._exp(overtoneGain.gain, 0.001, time + safeDuration);
-        const overtone = this._osc(ctx, 0 /* Osc.Sine */, freq * 2.76, overtoneGain);
+        const osc = this._createOscillator(ctx, "sine", 0, gain);
+        this._setValueAtTime(osc.frequency, freq * 1.1, time);
+        this._exponentialRampToValue(osc.frequency, freq, time + 0.02);
+        const overtoneGain = this._createGain(ctx, 0, masterGain);
+        this._setValueAtTime(overtoneGain.gain, Math.max(0.001, velocity * 0.25), time);
+        this._exponentialRampToValue(overtoneGain.gain, 0.001, time + safeDuration);
+        const overtone = this._createOscillator(ctx, "sine", freq * 2.76, overtoneGain);
         overtoneGain.connect(masterGain);
-        this._on(time, stopTime, osc, overtone);
+        this._scheduleNodeStartStop(time, stopTime, osc, overtone);
     }
 }
 //# sourceMappingURL=ChromaticPercussionSynth.js.map

package/dist/Instruments/Decay/ChromaticPercussionSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChromaticPercussionSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/ChromaticPercussionSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAA5D;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAyBtD,CAAC;IAvBW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAY,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE5C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAY,IAAI,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC;QAErE,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEjC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"ChromaticPercussionSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/ChromaticPercussionSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAA5D;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAyBlI,CAAC;IAvBW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE/D,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAChF,IAAI,CAAC,uBAAuB,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC;QAEhF,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEjC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/Instruments/Decay/DecaySynthBase.d.ts

@@ -1,18 +1,24 @@
 import { CoreSynthBase } from "../CoreSynthBase.js";
 export type DecayCfg = {
-    v: number;
-    a: number;
-    d: number;
-    m: number;
+    _peakVelocity: number;
+    _attackTimeSeconds: number;
+    _decayTimeSeconds: number;
+    _maxDurationSeconds: number;
 };
 /**
- * Abstract base class for plucked, struck, and decaying synthesizers.
- * Handles GainNode creation, Nyquist safety limits, and decay volume envelopes.
+ * Abstract base class for plucked, struck, and decaying synthesizers (e.g. Pianos, Guitars, Marimbas).
+ *
+ * @reason Physics Simulation:
+ * Unlike Analog instruments that hold their peak volume as long as a key is pressed,
+ * physical instruments like Guitars or Pianos immediately begin decaying the moment they are struck.
+ * This class abstracts the mathematical envelope necessary to simulate that physical decay,
+ * including a hard `maxDurationSeconds` limit to prevent infinite resonance loops from
+ * leaking memory if a MIDI file passes a malformed 60-second note duration.
  */
 export declare abstract class DecaySynthBase extends CoreSynthBase {
-    protected _c: DecayCfg;
+    protected _envelopeConfig: DecayCfg;
     _playNote(ctx: AudioContext, masterGain: GainNode, time: number, freq: number, duration: number, velocity: number): void;
-    protected _cfg(): DecayCfg;
+    protected _getEnvelopeConfig(): DecayCfg;
     /** Override this for complex envelopes (like electric guitar compression) */
     protected _applyDecay(gainParam: AudioParam, peakVol: number, time: number, attack: number, safeDuration: number, decayTail: number): void;
     /**

package/dist/Instruments/Decay/DecaySynthBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DecaySynthBase.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/DecaySynthBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;GAGG;AACH,8BAAsB,cAAe,SAAQ,aAAa;IACxD,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAuC;IAEtD,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;IAiCP,SAAS,CAAC,IAAI,IAAI,QAAQ;IAI1B,6EAA6E;IAC7E,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI;IAIP;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAChC,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CACpB"}
+{"version":3,"file":"DecaySynthBase.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/DecaySynthBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC;AAErI;;;;;;;;;GASG;AACH,8BAAsB,cAAe,SAAQ,aAAa;IACxD,SAAS,CAAC,eAAe,EAAE,QAAQ,CAAsG;IAElI,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;IAiCP,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC,6EAA6E;IAC7E,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI;IAIP;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAChC,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CACpB"}

package/dist/Instruments/Decay/DecaySynthBase.js

@@ -1,35 +1,42 @@
-import { CoreSynthBase } from "../CoreSynthBase.js";
+import { CoreSynthBase, hasStrictGC } from "../CoreSynthBase.js";
 /**
- * Abstract base class for plucked, struck, and decaying synthesizers.
- * Handles GainNode creation, Nyquist safety limits, and decay volume envelopes.
+ * Abstract base class for plucked, struck, and decaying synthesizers (e.g. Pianos, Guitars, Marimbas).
+ *
+ * @reason Physics Simulation:
+ * Unlike Analog instruments that hold their peak volume as long as a key is pressed,
+ * physical instruments like Guitars or Pianos immediately begin decaying the moment they are struck.
+ * This class abstracts the mathematical envelope necessary to simulate that physical decay,
+ * including a hard `maxDurationSeconds` limit to prevent infinite resonance loops from
+ * leaking memory if a MIDI file passes a malformed 60-second note duration.
  */
 export class DecaySynthBase extends CoreSynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.5, a: 0.02, d: 0.2, m: 4.0 };
+        this._envelopeConfig = { _peakVelocity: 0.5, _attackTimeSeconds: 0.02, _decayTimeSeconds: 0.2, _maxDurationSeconds: 4.0 };
     }
     _playNote(ctx, masterGain, time, freq, duration, velocity) {
         const gain = ctx.createGain();
-        const c = this._cfg();
-        const peakVol = Math.max(0.001, velocity * c.v);
+        const c = this._getEnvelopeConfig();
+        const peakVol = Math.max(0.001, velocity * c._peakVelocity);
         /** Physical strings/mallets stop vibrating quickly. Protects against stuck MIDI notes. */
-        const safeDuration = Math.max(0.02, Math.min(duration, c.m));
-        this._set(gain.gain, 0, time);
-        this._lin(gain.gain, peakVol, time + c.a);
-        this._applyDecay(gain.gain, peakVol, time, c.a, safeDuration, c.d);
+        const safeDuration = Math.max(0.02, Math.min(duration, c._maxDurationSeconds));
+        this._setValueAtTime(gain.gain, 0, time);
+        this._linearRampToValue(gain.gain, peakVol, time + c._attackTimeSeconds);
+        this._applyDecay(gain.gain, peakVol, time, c._attackTimeSeconds, safeDuration, c._decayTimeSeconds);
         /** Pad the oscillator stop time slightly past the volume decay to prevent digital clicking */
-        const stopTime = time + safeDuration + c.d + 0.1;
+        const stopTime = time + safeDuration + c._decayTimeSeconds + 0.1;
         const output = this._setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime);
         const finalNode = output || gain;
         finalNode.connect(masterGain);
-        this._gc(ctx, time, stopTime + 2.0, finalNode);
+        if (hasStrictGC)
+            this._scheduleNodeDisposal(ctx, time, stopTime + 2.0, finalNode);
     }
-    _cfg() {
-        return this._c;
+    _getEnvelopeConfig() {
+        return this._envelopeConfig;
     }
     /** Override this for complex envelopes (like electric guitar compression) */
     _applyDecay(gainParam, peakVol, time, attack, safeDuration, decayTail) {
-        this._exp(gainParam, 0.001, time + safeDuration + decayTail);
+        this._exponentialRampToValue(gainParam, 0.001, time + safeDuration + decayTail);
     }
 }
 //# sourceMappingURL=DecaySynthBase.js.map

package/dist/Instruments/Decay/DecaySynthBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecaySynthBase.js","sourceRoot":"","sources":["../../../Instruments/Decay/DecaySynthBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD;;;GAGG;AACH,MAAM,OAAgB,cAAe,SAAQ,aAAa;IAA1D;;QACY,OAAE,GAAa,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAuE/D,CAAC;IArEQ,SAAS,CACd,GAAiB,EACjB,UAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAE9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhD,0FAA0F;QAC1F,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,8FAA8F;QAC9F,MAAM,QAAQ,GAAG,IAAI,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAEjD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CACjC,GAAG,EACH,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,QAAQ,CACT,CAAC;QAEF,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC;QACjC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,GAAG,GAAG,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAES,IAAI;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,6EAA6E;IACnE,WAAW,CACnB,SAAqB,EACrB,OAAe,EACf,IAAY,EACZ,MAAc,EACd,YAAoB,EACpB,SAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;IAC/D,CAAC;CAeF"}
+{"version":3,"file":"DecaySynthBase.js","sourceRoot":"","sources":["../../../Instruments/Decay/DecaySynthBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIjE;;;;;;;;;GASG;AACH,MAAM,OAAgB,cAAe,SAAQ,aAAa;IAA1D;;QACY,oBAAe,GAAa,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAuE3I,CAAC;IArEQ,SAAS,CACd,GAAiB,EACjB,UAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAE9B,MAAM,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;QAE5D,0FAA0F;QAC1F,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAE/E,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAEzE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAEpG,8FAA8F;QAC9F,MAAM,QAAQ,GAAG,IAAI,GAAG,YAAY,GAAG,CAAC,CAAC,iBAAiB,GAAG,GAAG,CAAC;QAEjE,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CACjC,GAAG,EACH,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,QAAQ,CACT,CAAC;QAEF,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC;QACjC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,WAAW;YAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,GAAG,GAAG,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAES,kBAAkB;QAC1B,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,6EAA6E;IACnE,WAAW,CACnB,SAAqB,EACrB,OAAe,EACf,IAAY,EACZ,MAAc,EACd,YAAoB,EACpB,SAAiB;QAEjB,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;IAClF,CAAC;CAeF"}

package/dist/Instruments/Decay/ElectricGuitarSynth.d.ts

@@ -2,12 +2,19 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
 /**
  * Synthesizer strategy for Electric and Distorted Guitars.
  */
+/**
+ * Simulates a distorted electric guitar using a sawtooth wave run through heavy overdrive and bandpass filtering.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class ElectricGuitarSynth extends DecaySynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        d: number;
-        m: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _decayTimeSeconds: number;
+        _maxDurationSeconds: number;
     };
     protected _applyDecay(gainParam: AudioParam, peakVol: number, time: number, attack: number, safeDuration: number, decayTail: number): void;
     protected _setupSynthesis(ctx: AudioContext, masterGain: GainNode, gain: GainNode, time: number, freq: number, velocity: number, safeDuration: number, stopTime: number): AudioNode | void;

package/dist/Instruments/Decay/ElectricGuitarSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElectricGuitarSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/ElectricGuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,SAAS,CAAC,EAAE;;;;;MAAuC;IAEnD,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI;IAUP,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CA6CpB"}
+{"version":3,"file":"ElectricGuitarSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/ElectricGuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,SAAS,CAAC,eAAe;;;;;MAAsG;IAE/H,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,IAAI;IAUP,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CA6CpB"}

package/dist/Instruments/Decay/ElectricGuitarSynth.js

@@ -2,29 +2,36 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
 /**
  * Synthesizer strategy for Electric and Distorted Guitars.
  */
+/**
+ * Simulates a distorted electric guitar using a sawtooth wave run through heavy overdrive and bandpass filtering.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class ElectricGuitarSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.5, a: 0.02, d: 0.2, m: 4.0 };
+        this._envelopeConfig = { _peakVelocity: 0.5, _attackTimeSeconds: 0.02, _decayTimeSeconds: 0.2, _maxDurationSeconds: 4.0 };
     }
     _applyDecay(gainParam, peakVol, time, attack, safeDuration, decayTail) {
         /** Compressed sustain mimicking an electric guitar amp */
-        this._exp(gainParam, Math.max(0.001, peakVol * 0.4), time + Math.min(0.5, safeDuration));
-        this._exp(gainParam, 0.001, time + safeDuration + decayTail);
+        this._exponentialRampToValue(gainParam, Math.max(0.001, peakVol * 0.4), time + Math.min(0.5, safeDuration));
+        this._exponentialRampToValue(gainParam, 0.001, time + safeDuration + decayTail);
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
-        const filter = this._filterSweep(ctx, 0 /* Filter.Lowpass */, 2500 + velocity * 1500, 600, time, safeDuration);
-        const [osc, osc2] = this._stereoOsc(ctx, 2 /* Osc.Sawtooth */, 0, 1, 0, gain);
-        this._set(osc.frequency, freq * 1.02, time);
-        this._exp(osc.frequency, freq, time + 0.05);
-        this._set(osc2.frequency, freq * 1.022, time);
-        this._exp(osc2.frequency, freq * 1.002, time + 0.05);
-        const vibrato = this._lfo(ctx, 5.0, freq * 0.015, time, 0.2, stopTime, osc.frequency, 0.4);
+        const filter = this._createFilterSweep(ctx, "lowpass", 2500 + velocity * 1500, 600, time, safeDuration);
+        const [osc, osc2] = this._createStereoOscillator(ctx, "sawtooth", 0, 1, 0, gain);
+        this._setValueAtTime(osc.frequency, freq * 1.02, time);
+        this._exponentialRampToValue(osc.frequency, freq, time + 0.05);
+        this._setValueAtTime(osc2.frequency, freq * 1.022, time);
+        this._exponentialRampToValue(osc2.frequency, freq * 1.002, time + 0.05);
+        const vibrato = this._createLFO(ctx, 5.0, freq * 0.015, time, 0.2, stopTime, osc.frequency, 0.4);
         vibrato.connect(osc2.frequency);
         gain.connect(filter);
         /** Heavy plectrum attack */
-        this._transient(ctx, 1 /* Osc.Square */, 3500, masterGain, time, Math.max(0.001, velocity * 0.25), 0.015);
-        this._on(time, stopTime, osc, osc2);
+        this._createTransient(ctx, "square", 3500, masterGain, time, Math.max(0.001, velocity * 0.25), 0.015);
+        this._scheduleNodeStartStop(time, stopTime, osc, osc2);
         return filter;
     }
 }

package/dist/Instruments/Decay/ElectricGuitarSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElectricGuitarSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/ElectricGuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAAvD;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAyErD,CAAC;IAvEW,WAAW,CACnB,SAAqB,EACrB,OAAe,EACf,IAAY,EACZ,MAAc,EACd,YAAoB,EACpB,SAAiB;QAEjB,0DAA0D;QAC1D,IAAI,CAAC,IAAI,CACP,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,EAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CACnC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;IAC/D,CAAC;IAES,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,GAAG,0BAEH,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtB,GAAG,EACH,IAAI,EACJ,YAAY,CACb,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,wBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAErD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,GAAG,EACH,GAAG,EACH,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,GAAG,CAAC,SAAS,EACb,GAAG,CACJ,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErB,4BAA4B;QAC5B,IAAI,CAAC,UAAU,CACb,GAAG,sBAEH,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAChC,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAEpC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"ElectricGuitarSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/ElectricGuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAAvD;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAyEjI,CAAC;IAvEW,WAAW,CACnB,SAAqB,EACrB,OAAe,EACf,IAAY,EACZ,MAAc,EACd,YAAoB,EACpB,SAAiB;QAEjB,0DAA0D;QAC1D,IAAI,CAAC,uBAAuB,CAC1B,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,EAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CACnC,CAAC;QACF,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;IAClF,CAAC;IAES,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CACpC,GAAG,EACH,SAAS,EACT,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtB,GAAG,EACH,IAAI,EACJ,YAAY,CACb,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAExE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAC7B,GAAG,EACH,GAAG,EACH,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,GAAG,CAAC,SAAS,EACb,GAAG,CACJ,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErB,4BAA4B;QAC5B,IAAI,CAAC,gBAAgB,CACnB,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAChC,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAEvD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/Instruments/Decay/EthnicSynth.d.ts

@@ -3,12 +3,19 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for Ethnic instruments (Sitar, Shamisen, Koto).
  * Uses a bandpass filter over a square wave to emulate a hollow, plucked resonator.
  */
+/**
+ * A generalized plucked/struck string synthesizer meant to emulate instruments like a Sitar or Koto.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class EthnicSynth extends DecaySynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        d: number;
-        m: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _decayTimeSeconds: number;
+        _maxDurationSeconds: number;
     };
     protected _setupSynthesis(ctx: AudioContext, masterGain: GainNode, gain: GainNode, time: number, freq: number, velocity: number, safeDuration: number, stopTime: number): AudioNode | void;
 }

package/dist/Instruments/Decay/EthnicSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EthnicSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/EthnicSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAC7C,SAAS,CAAC,EAAE;;;;;MAAuC;IAEnD,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAmBpB"}
+{"version":3,"file":"EthnicSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/EthnicSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAC7C,SAAS,CAAC,eAAe;;;;;MAAsG;IAE/H,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAmBpB"}

package/dist/Instruments/Decay/EthnicSynth.js

@@ -3,19 +3,26 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for Ethnic instruments (Sitar, Shamisen, Koto).
  * Uses a bandpass filter over a square wave to emulate a hollow, plucked resonator.
  */
+/**
+ * A generalized plucked/struck string synthesizer meant to emulate instruments like a Sitar or Koto.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class EthnicSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.6, a: 0.02, d: 0.1, m: 4.0 };
+        this._envelopeConfig = { _peakVelocity: 0.6, _attackTimeSeconds: 0.02, _decayTimeSeconds: 0.1, _maxDurationSeconds: 4.0 };
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
-        const osc = this._osc(ctx, 1 /* Osc.Square */, 0, gain);
-        this._set(osc.frequency, freq * 1.05, time);
-        this._exp(osc.frequency, freq, time + 0.08);
-        const filter = this._filterSweep(ctx, 2 /* Filter.Bandpass */, freq * 2.5, freq, time, safeDuration);
+        const osc = this._createOscillator(ctx, "square", 0, gain);
+        this._setValueAtTime(osc.frequency, freq * 1.05, time);
+        this._exponentialRampToValue(osc.frequency, freq, time + 0.08);
+        const filter = this._createFilterSweep(ctx, "bandpass", freq * 2.5, freq, time, safeDuration);
         filter.Q.value = 2;
         filter.connect(gain);
-        this._on(time, stopTime, osc);
+        this._scheduleNodeStartStop(time, stopTime, osc);
     }
 }
 //# sourceMappingURL=EthnicSynth.js.map

package/dist/Instruments/Decay/EthnicSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"EthnicSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/EthnicSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,cAAc;IAA/C;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IA8BrD,CAAC;IA5BW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,sBAAc,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,GAAG,2BAEH,IAAI,GAAG,GAAG,EACV,IAAI,EACJ,IAAI,EACJ,YAAY,CACb,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAEnB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAErB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"EthnicSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/EthnicSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,cAAc;IAA/C;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IA8BjI,CAAC;IA5BW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CACpC,GAAG,EACH,UAAU,EACV,IAAI,GAAG,GAAG,EACV,IAAI,EACJ,IAAI,EACJ,YAAY,CACb,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAEnB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAErB,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/Instruments/Decay/GuitarSynth.d.ts

@@ -2,12 +2,19 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
 /**
  * Synthesizer strategy for Acoustic Guitars using a plucked sawtooth.
  */
+/**
+ * Simulates an acoustic guitar pluck using the Karplus-Strong algorithm or filtered sawtooth impulses.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class GuitarSynth extends DecaySynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        d: number;
-        m: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _decayTimeSeconds: number;
+        _maxDurationSeconds: number;
     };
     protected _setupSynthesis(ctx: AudioContext, masterGain: GainNode, gain: GainNode, time: number, freq: number, velocity: number, safeDuration: number, stopTime: number): AudioNode | void;
 }

package/dist/Instruments/Decay/GuitarSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GuitarSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/GuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAC7C,SAAS,CAAC,EAAE;;;;;MAAuC;IAEnD,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAgCpB"}
+{"version":3,"file":"GuitarSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/GuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAC7C,SAAS,CAAC,eAAe;;;;;MAAsG;IAE/H,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAgCpB"}

package/dist/Instruments/Decay/GuitarSynth.js

@@ -2,21 +2,28 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
 /**
  * Synthesizer strategy for Acoustic Guitars using a plucked sawtooth.
  */
+/**
+ * Simulates an acoustic guitar pluck using the Karplus-Strong algorithm or filtered sawtooth impulses.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class GuitarSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.6, a: 0.02, d: 0.2, m: 4.0 };
+        this._envelopeConfig = { _peakVelocity: 0.6, _attackTimeSeconds: 0.02, _decayTimeSeconds: 0.2, _maxDurationSeconds: 4.0 };
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
         /** Bright attack that quickly muffles as the acoustic string loses kinetic energy */
-        const filter = this._filterSweep(ctx, 0 /* Filter.Lowpass */, 2000 + velocity * 1000, 200, time, safeDuration);
-        const osc = this._osc(ctx, 2 /* Osc.Sawtooth */, 0, gain);
-        this._set(osc.frequency, freq * 1.02, time);
-        this._exp(osc.frequency, freq, time + 0.05);
+        const filter = this._createFilterSweep(ctx, "lowpass", 2000 + velocity * 1000, 200, time, safeDuration);
+        const osc = this._createOscillator(ctx, "sawtooth", 0, gain);
+        this._setValueAtTime(osc.frequency, freq * 1.02, time);
+        this._exponentialRampToValue(osc.frequency, freq, time + 0.05);
         gain.connect(filter);
         /** Plectrum Pluck: the sharp, plastic click of a pick striking a steel string */
-        this._transient(ctx, 1 /* Osc.Square */, 3500, masterGain, time, Math.max(0.001, velocity * 0.25), 0.015);
-        this._on(time, stopTime, osc);
+        this._createTransient(ctx, "square", 3500, masterGain, time, Math.max(0.001, velocity * 0.25), 0.015);
+        this._scheduleNodeStartStop(time, stopTime, osc);
         return filter;
     }
 }

package/dist/Instruments/Decay/GuitarSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"GuitarSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/GuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,cAAc;IAA/C;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IA2CrD,CAAC;IAzCW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,qFAAqF;QACrF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,GAAG,0BAEH,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtB,GAAG,EACH,IAAI,EACJ,YAAY,CACb,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErB,iFAAiF;QACjF,IAAI,CAAC,UAAU,CACb,GAAG,sBAEH,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAChC,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE9B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"GuitarSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/GuitarSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,cAAc;IAA/C;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IA2CjI,CAAC;IAzCW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,qFAAqF;QACrF,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CACpC,GAAG,EACH,SAAS,EACT,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtB,GAAG,EACH,IAAI,EACJ,YAAY,CACb,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErB,iFAAiF;QACjF,IAAI,CAAC,gBAAgB,CACnB,GAAG,EACH,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAChC,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEjD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/Instruments/Decay/KarplusSynth.d.ts

@@ -4,6 +4,13 @@ import { CoreSynthBase } from "../CoreSynthBase.js";
  * Uses a noise burst fed into a tuned delay line with a feedback filter
  * to accurately simulate the physics of plucked strings (Acoustic Guitar, Harp).
  */
+/**
+ * Implements the Karplus-Strong string synthesis algorithm using a short noise burst fed through a tightly tuned feedback delay line.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class KarplusSynth extends CoreSynthBase {
     _playNote(ctx: AudioContext, masterGain: GainNode, time: number, freq: number, duration: number, velocity: number): void;
 }

package/dist/Instruments/Decay/KarplusSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KarplusSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/KarplusSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,qBAAqB,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,aAAa;IACtC,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CAsCR"}
+{"version":3,"file":"KarplusSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/KarplusSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuB,MAAM,qBAAqB,CAAC;AAEzE;;;;GAIG;AACH;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,aAAa;IACtC,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CAsCR"}

package/dist/Instruments/Decay/KarplusSynth.js

@@ -1,9 +1,16 @@
-import { CoreSynthBase } from "../CoreSynthBase.js";
+import { CoreSynthBase, hasStrictGC } from "../CoreSynthBase.js";
 /**
  * Synthesizer strategy for Karplus-Strong physical modeling.
  * Uses a noise burst fed into a tuned delay line with a feedback filter
  * to accurately simulate the physics of plucked strings (Acoustic Guitar, Harp).
  */
+/**
+ * Implements the Karplus-Strong string synthesis algorithm using a short noise burst fed through a tightly tuned feedback delay line.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class KarplusSynth extends CoreSynthBase {
     _playNote(ctx, masterGain, time, freq, duration, velocity) {
         const delayTime = 1 / freq;
@@ -18,17 +25,18 @@ export class KarplusSynth extends CoreSynthBase {
         const delay = ctx.createDelay(delayTime);
         delay.delayTime.value = delayTime;
         // 3. The Body Damping (Lowpass filter inside the feedback loop to absorb high frequencies)
-        const filter = this._filter(ctx, 0 /* Filter.Lowpass */);
+        const filter = this._createFilter(ctx, "lowpass");
         filter.frequency.value = Math.min(22000, freq * 6);
         // 4. The Tension (Feedback gain)
-        const feedback = this._gain(ctx, 0.98); // Higher value = longer ring time
+        const feedback = this._createGain(ctx, 0.98); // Higher value = longer ring time
         burst.connect(delay).connect(filter).connect(feedback).connect(delay);
-        const output = this._gain(ctx, 0, masterGain);
-        this._set(output.gain, 1, time);
-        this._exp(output.gain, 0.001, time + duration);
+        const output = this._createGain(ctx, 0, masterGain);
+        this._setValueAtTime(output.gain, 1, time);
+        this._exponentialRampToValue(output.gain, 0.001, time + duration);
         delay.connect(output);
-        this._on(time, time + duration, burst);
-        this._gc(ctx, time, time + duration + 3.0, output, delay, filter, feedback);
+        this._scheduleNodeStartStop(time, time + duration, burst);
+        if (hasStrictGC)
+            this._scheduleNodeDisposal(ctx, time, time + duration + 3.0, output, delay, filter, feedback);
     }
 }
 //# sourceMappingURL=KarplusSynth.js.map

package/dist/Instruments/Decay/KarplusSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"KarplusSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/KarplusSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,qBAAqB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IACtC,SAAS,CACd,GAAiB,EACjB,UAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC;QAE3B,uDAAuD;QACvD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAClC,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,EACvC,GAAG,CAAC,UAAU,CACf,CAAC;QACF,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAClC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QAE/C,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAE3B,mEAAmE;QACnE,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACzC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC;QAElC,2FAA2F;QAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,yBAAiB,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QAEnD,iCAAiC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,kCAAkC;QAE1E,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;QAE/C,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;QAEvC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9E,CAAC;CACF"}
+{"version":3,"file":"KarplusSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/KarplusSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEzE;;;;GAIG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IACtC,SAAS,CACd,GAAiB,EACjB,UAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC;QAE3B,uDAAuD;QACvD,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAClC,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,EACvC,GAAG,CAAC,UAAU,CACf,CAAC;QACF,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAClC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QAE/C,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAE3B,mEAAmE;QACnE,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACzC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC;QAElC,2FAA2F;QAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QAEnD,iCAAiC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,kCAAkC;QAEhF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEtE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;QAElE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE1D,IAAI,WAAW;YAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjH,CAAC;CACF"}

package/dist/Instruments/Decay/PianoSynth.d.ts

@@ -2,12 +2,19 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
 /**
  * Synthesizer strategy for Piano and similar percussive-melodic instruments.
  */
+/**
+ * Simulates a piano using a complex decay envelope, subtle detuning for string realism, and a lowpass filter that closes over time.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class PianoSynth extends DecaySynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        d: number;
-        m: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _decayTimeSeconds: number;
+        _maxDurationSeconds: number;
     };
     protected _setupSynthesis(ctx: AudioContext, masterGain: GainNode, gain: GainNode, time: number, freq: number, velocity: number, safeDuration: number, stopTime: number): AudioNode | void;
 }

package/dist/Instruments/Decay/PianoSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PianoSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/PianoSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,SAAS,CAAC,EAAE;;;;;MAAwC;IAEpD,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CA+CpB"}
+{"version":3,"file":"PianoSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/PianoSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,SAAS,CAAC,eAAe;;;;;MAAuG;IAEhI,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CA+CpB"}

package/dist/Instruments/Decay/PianoSynth.js

@@ -2,30 +2,37 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
 /**
  * Synthesizer strategy for Piano and similar percussive-melodic instruments.
  */
+/**
+ * Simulates a piano using a complex decay envelope, subtle detuning for string realism, and a lowpass filter that closes over time.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class PianoSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.8, a: 0.015, d: 0.1, m: 5.0 };
+        this._envelopeConfig = { _peakVelocity: 0.8, _attackTimeSeconds: 0.015, _decayTimeSeconds: 0.1, _maxDurationSeconds: 5.0 };
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
         /** Key-tracking the filter ensures high notes aren't artificially muffled or phase-distorted. Capped at Nyquist. */
-        const filter = this._filterSweep(ctx, 0 /* Filter.Lowpass */, freq + 800 + velocity * 1000, freq + 200, time, Math.min(safeDuration, 1.0));
-        const osc1 = this._osc(ctx, 3 /* Osc.Triangle */, freq, gain);
+        const filter = this._createFilterSweep(ctx, "lowpass", freq + 800 + velocity * 1000, freq + 200, time, Math.min(safeDuration, 1.0));
+        const osc1 = this._createOscillator(ctx, "triangle", freq, gain);
         /** Slight inharmonicity stretching, strictly capped below Nyquist to prevent digital aliasing */
-        const overtoneGain = this._gain(ctx, 0);
-        const osc2 = this._osc(ctx, 0 /* Osc.Sine */, freq * 2.003, overtoneGain);
-        const osc3 = this._osc(ctx, 0 /* Osc.Sine */, freq * 3.007, overtoneGain);
+        const overtoneGain = this._createGain(ctx, 0);
+        const osc2 = this._createOscillator(ctx, "sine", freq * 2.003, overtoneGain);
+        const osc3 = this._createOscillator(ctx, "sine", freq * 3.007, overtoneGain);
         /** Dynamically pan lower keys to the left ear, and higher keys to the right ear */
-        const panner = this._pan(ctx, Math.max(-0.8, Math.min(0.8, (freq - 261.6) / 800)));
+        const panner = this._createStereoPanner(ctx, Math.max(-0.8, Math.min(0.8, (freq - 261.6) / 800)));
         /** Sympathetic string resonance: metallic clangs decay much faster than the fundamental */
-        this._set(overtoneGain.gain, 0, time);
-        this._lin(overtoneGain.gain, Math.max(0.001, velocity * 0.15), time + 0.01);
-        this._exp(overtoneGain.gain, 0.001, time + Math.min(safeDuration, 0.5));
+        this._setValueAtTime(overtoneGain.gain, 0, time);
+        this._linearRampToValue(overtoneGain.gain, Math.max(0.001, velocity * 0.15), time + 0.01);
+        this._exponentialRampToValue(overtoneGain.gain, 0.001, time + Math.min(safeDuration, 0.5));
         overtoneGain.connect(panner);
         /** Mechanical Hammer Thump: the physical impact of the wooden hammer on the strings */
-        this._transient(ctx, 0 /* Osc.Sine */, 60, panner, time, Math.max(0.001, velocity * 0.4), 0.05, 0.005);
+        this._createTransient(ctx, "sine", 60, panner, time, Math.max(0.001, velocity * 0.4), 0.05, 0.005);
         gain.connect(panner).connect(filter);
-        this._on(time, stopTime, osc1, osc2, osc3);
+        this._scheduleNodeStartStop(time, stopTime, osc1, osc2, osc3);
         return filter;
     }
 }

package/dist/Instruments/Decay/PianoSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"PianoSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/PianoSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAA9C;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IA0DtD,CAAC;IAxDW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,oHAAoH;QACpH,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,GAAG,0BAEH,IAAI,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,EAC5B,IAAI,GAAG,GAAG,EACV,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAC5B,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAgB,IAAI,EAAE,IAAI,CAAC,CAAC;QAEtD,iGAAiG;QACjG,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAY,IAAI,GAAG,KAAK,EAAE,YAAY,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAY,IAAI,GAAG,KAAK,EAAE,YAAY,CAAC,CAAC;QAElE,mFAAmF;QACnF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,GAAG,EACH,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CACpD,CAAC;QAEF,2FAA2F;QAC3F,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;QACxE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE7B,uFAAuF;QACvF,IAAI,CAAC,UAAU,CACb,GAAG,oBAEH,EAAE,EACF,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,EAC/B,IAAI,EACJ,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE3C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"PianoSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/PianoSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAA9C;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IA0DlI,CAAC;IAxDW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,oHAAoH;QACpH,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CACpC,GAAG,EACH,SAAS,EACT,IAAI,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,EAC5B,IAAI,GAAG,GAAG,EACV,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAC5B,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAEjE,iGAAiG;QACjG,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,YAAY,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,YAAY,CAAC,CAAC;QAE7E,mFAAmF;QACnF,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CACrC,GAAG,EACH,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CACpD,CAAC;QAEF,2FAA2F;QAC3F,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAC1F,IAAI,CAAC,uBAAuB,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3F,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE7B,uFAAuF;QACvF,IAAI,CAAC,gBAAgB,CACnB,GAAG,EACH,MAAM,EACN,EAAE,EACF,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,EAC/B,IAAI,EACJ,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE9D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}