rlo-engine 1.0.3 → 1.1.0

package/dist/Instruments/Analog/ReeseBassSynth.js

@@ -3,20 +3,27 @@ import { AnalogSynthBase } from "./AnalogSynthBase.js";
  * Synthesizer strategy for Reese/Wobble Bass.
  * Uses heavily detuned sawtooths and an LFO-driven lowpass filter.
  */
+/**
+ * A staple of Drum & Bass music, this uses two heavily detuned sawtooth waves to create a thick, phasing, and wide bass tone.
+ *
+ * @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 ReeseBassSynth extends AnalogSynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.7, a: 0.05, r: 0.2 };
+        this._envelopeConfig = { _peakVelocity: 0.7, _attackTimeSeconds: 0.05, _releaseTimeSeconds: 0.2 };
     }
     _setupSynthesis(ctx, gain, time, freq, velocity, sustainTime, releaseTime, stopTime) {
-        const filter = this._filter(ctx, 0 /* Filter.Lowpass */);
-        this._set(filter.frequency, freq * 2, time);
+        const filter = this._createFilter(ctx, "lowpass");
+        this._setValueAtTime(filter.frequency, freq * 2, time);
         // Wobble LFO: syncs roughly to tempo (e.g. 1/8th notes ~4-8 Hz)
-        this._lfo(ctx, 6, freq * 3, time, 0, stopTime, filter.frequency);
+        this._createLFO(ctx, 6, freq * 3, time, 0, stopTime, filter.frequency);
         // Deep, phasing detune
-        const [osc1, osc2] = this._stereoOsc(ctx, 2 /* Osc.Sawtooth */, freq / 2, 1.015, 0.4, filter);
+        const [osc1, osc2] = this._createStereoOscillator(ctx, "sawtooth", freq / 2, 1.015, 0.4, filter);
         filter.connect(gain);
-        this._on(time, stopTime, osc1, osc2);
+        this._scheduleNodeStartStop(time, stopTime, osc1, osc2);
     }
 }
 //# sourceMappingURL=ReeseBassSynth.js.map

package/dist/Instruments/Analog/ReeseBassSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReeseBassSynth.js","sourceRoot":"","sources":["../../../Instruments/Analog/ReeseBassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,sBAAsB,CAAC;AAGlE;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IAAnD;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IA8B7C,CAAC;IA5BW,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,QAAgB;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,yBAAiB,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAE5C,gEAAgE;QAChE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjE,uBAAuB;QACvB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAClC,GAAG,wBAEH,IAAI,GAAG,CAAC,EACR,KAAK,EACL,GAAG,EACH,MAAM,CACP,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"ReeseBassSynth.js","sourceRoot":"","sources":["../../../Instruments/Analog/ReeseBassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,sBAAsB,CAAC;AAGlE;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IAAnD;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IA8BzG,CAAC;IA5BW,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,QAAgB;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAEvD,gEAAgE;QAChE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvE,uBAAuB;QACvB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAC/C,GAAG,EACH,UAAU,EACV,IAAI,GAAG,CAAC,EACR,KAAK,EACL,GAAG,EACH,MAAM,CACP,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/Instruments/Analog/StringSynth.js

@@ -7,12 +7,12 @@ export class StringSynth extends AnalogSynthBase {
         return { v: 0.3, a: d < 0.4 ? 0.05 : 0.2, r: d < 0.4 ? 0.1 : 0.5 };
     }
     _setupSynthesis(ctx, gain, time, freq, velocity, sustainTime, releaseTime, stopTime) {
-        const [osc1, osc2] = this._stereoOsc(ctx, 2 /* Osc.Sawtooth */, freq, 1.005, 0.6, gain);
-        const lfo = this._lfo(ctx, 4.5, freq * 0.012, time, 0.3, stopTime, osc1.frequency);
+        const [osc1, osc2] = this._createStereoOscillator(ctx, "sawtooth", freq, 1.005, 0.6, gain);
+        const lfo = this._createLFO(ctx, 4.5, freq * 0.012, time, 0.3, stopTime, osc1.frequency);
         lfo.connect(osc2.frequency);
-        const filter = this._filterSweep(ctx, 0 /* Filter.Lowpass */, freq + 1200 + velocity * 1000, freq + 800, time, sustainTime + releaseTime);
+        const filter = this._createFilterSweep(ctx, "lowpass", freq + 1200 + velocity * 1000, freq + 800, time, sustainTime + releaseTime);
         gain.connect(filter);
-        this._on(time, stopTime, osc1, osc2);
+        this._scheduleNodeStartStop(time, stopTime, osc1, osc2);
         return filter;
     }
 }

package/dist/Instruments/Analog/StringSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"StringSynth.js","sourceRoot":"","sources":["../../../Instruments/Analog/StringSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,eAAe;IACpC,IAAI,CAAC,CAAS;QACtB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACrE,CAAC;IAES,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,QAAgB;QAEhB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAClC,GAAG,wBAEH,IAAI,EACJ,KAAK,EACL,GAAG,EACH,IAAI,CACL,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,GAAG,EACH,GAAG,EACH,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,SAAS,CACf,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,GAAG,0BAEH,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EAC7B,IAAI,GAAG,GAAG,EACV,IAAI,EACJ,WAAW,GAAG,WAAW,CAC1B,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"StringSynth.js","sourceRoot":"","sources":["../../../Instruments/Analog/StringSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,eAAe;IACpC,IAAI,CAAC,CAAS;QACtB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACrE,CAAC;IAES,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,QAAgB;QAEhB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAC/C,GAAG,EACH,UAAU,EACV,IAAI,EACJ,KAAK,EACL,GAAG,EACH,IAAI,CACL,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CACzB,GAAG,EACH,GAAG,EACH,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,SAAS,CACf,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CACpC,GAAG,EACH,SAAS,EACT,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EAC7B,IAAI,GAAG,GAAG,EACV,IAAI,EACJ,WAAW,GAAG,WAAW,CAC1B,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAErB,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAExD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/Instruments/Analog/WoodwindSynth.d.ts

@@ -3,11 +3,18 @@ import { AnalogSynthBase } from "./AnalogSynthBase.js";
  * Synthesizer strategy for Woodwinds and Pipes (Flute, Piccolo, Recorder, Ocarina).
  * Characterized by a pure, hollow, and breathy tone using sine and triangle waves.
  */
+/**
+ * Emulates a flute or clarinet using a pure sine or triangle wave with gentle vibrato and a breathy noise layer.
+ *
+ * @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 WoodwindSynth extends AnalogSynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        r: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _releaseTimeSeconds: number;
     };
     protected _setupSynthesis(ctx: AudioContext, gain: GainNode, time: number, freq: number, velocity: number, sustainTime: number, releaseTime: number, stopTime: number): AudioNode | void;
 }

package/dist/Instruments/Analog/WoodwindSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WoodwindSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Analog/WoodwindSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAChD,SAAS,CAAC,EAAE;;;;MAA+B;IAE3C,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAsCpB"}
+{"version":3,"file":"WoodwindSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Analog/WoodwindSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;GAGG;AACH;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAChD,SAAS,CAAC,eAAe;;;;MAA8E;IAEvG,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAsCpB"}

package/dist/Instruments/Analog/WoodwindSynth.js

@@ -3,32 +3,39 @@ import { AnalogSynthBase } from "./AnalogSynthBase.js";
  * Synthesizer strategy for Woodwinds and Pipes (Flute, Piccolo, Recorder, Ocarina).
  * Characterized by a pure, hollow, and breathy tone using sine and triangle waves.
  */
+/**
+ * Emulates a flute or clarinet using a pure sine or triangle wave with gentle vibrato and a breathy noise layer.
+ *
+ * @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 WoodwindSynth extends AnalogSynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.7, a: 0.05, r: 0.1 };
+        this._envelopeConfig = { _peakVelocity: 0.7, _attackTimeSeconds: 0.05, _releaseTimeSeconds: 0.1 };
     }
     _setupSynthesis(ctx, gain, time, freq, velocity, sustainTime, releaseTime, stopTime) {
         /** Flutes are mostly a fundamental sine wave with a tiny bit of triangle for the "chiff" sound */
-        const osc1 = this._osc(ctx, 0 /* Osc.Sine */, freq, gain);
+        const osc1 = this._createOscillator(ctx, "sine", freq, gain);
         /** Triangle is mixed much lower just to provide a bit of upper harmonic texture */
-        const triGain = this._gain(ctx, 0, gain);
+        const triGain = this._createGain(ctx, 0, gain);
         /** Breath transient: louder at attack, decaying to a whisper during sustain */
-        this._set(triGain.gain, 0.3, time);
-        this._exp(triGain.gain, 0.05, time + 0.2);
-        const osc2 = this._osc(ctx, 3 /* Osc.Triangle */, freq, triGain);
+        this._setValueAtTime(triGain.gain, 0.3, time);
+        this._exponentialRampToValue(triGain.gain, 0.05, time + 0.2);
+        const osc2 = this._createOscillator(ctx, "triangle", freq, triGain);
         /** Lowpass filter to keep it extremely smooth and remove any digital sharpness */
-        const filter = this._filter(ctx, 0 /* Filter.Lowpass */);
-        this._set(filter.frequency, freq + 800, time);
+        const filter = this._createFilter(ctx, "lowpass");
+        this._setValueAtTime(filter.frequency, freq + 800, time);
         /** Diaphragm vibrato: blooms slowly after the initial breath attack */
-        const vibrato = this._lfo(ctx, 5.5, freq * 0.015, time, 0.4, stopTime, osc1.frequency);
+        const vibrato = this._createLFO(ctx, 5.5, freq * 0.015, time, 0.4, stopTime, osc1.frequency);
         vibrato.connect(osc2.frequency);
         /** True Amplitude Modulation (Tremolo) pipelined from the diaphragm vibrato */
-        const tremoloNode = this._gain(ctx, 1.0);
-        const tremoloDepth = this._gain(ctx, 0.15, tremoloNode.gain);
+        const tremoloNode = this._createGain(ctx, 1.0);
+        const tremoloDepth = this._createGain(ctx, 0.15, tremoloNode.gain);
         vibrato.connect(tremoloDepth);
         gain.connect(tremoloNode).connect(filter);
-        this._on(time, stopTime, osc1, osc2);
+        this._scheduleNodeStartStop(time, stopTime, osc1, osc2);
         return filter;
     }
 }

package/dist/Instruments/Analog/WoodwindSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"WoodwindSynth.js","sourceRoot":"","sources":["../../../Instruments/Analog/WoodwindSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAAlD;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAiD7C,CAAC;IA/CW,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,QAAgB;QAEhB,kGAAkG;QAClG,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAY,IAAI,EAAE,IAAI,CAAC,CAAC;QAElD,mFAAmF;QACnF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzC,+EAA+E;QAC/E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAgB,IAAI,EAAE,OAAO,CAAC,CAAC;QAEzD,kFAAkF;QAClF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,yBAAiB,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;QAE9C,uEAAuE;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,GAAG,EACH,GAAG,EACH,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,SAAS,CACf,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhC,+EAA+E;QAC/E,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAE9B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"WoodwindSynth.js","sourceRoot":"","sources":["../../../Instruments/Analog/WoodwindSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAAlD;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAiDzG,CAAC;IA/CW,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,QAAgB;QAEhB,kGAAkG;QAClG,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE7D,mFAAmF;QACnF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/C,+EAA+E;QAC/E,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAEpE,kFAAkF;QAClF,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;QAEzD,uEAAuE;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAC7B,GAAG,EACH,GAAG,EACH,IAAI,GAAG,KAAK,EACZ,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,SAAS,CACf,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhC,+EAA+E;QAC/E,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAE9B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAExD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/Instruments/CoreSynthBase.d.ts

@@ -1,29 +1,36 @@
 import { ISynthInstrument } from "./ISynthInstrument.js";
-export declare const enum Osc {
-    Sine = 0,
-    Square = 1,
-    Sawtooth = 2,
-    Triangle = 3
-}
-export declare const enum Filter {
-    Lowpass = 0,
-    Highpass = 1,
-    Bandpass = 2
-}
+export declare const hasStrictGC: boolean;
+export type Osc = "sine" | "square" | "sawtooth" | "triangle";
+export type Filter = "lowpass" | "highpass" | "bandpass";
 export declare abstract class CoreSynthBase implements ISynthInstrument {
     abstract _playNote(ctx: AudioContext, masterGain: GainNode, time: number, freq: number, duration: number, velocity: number): void;
-    _osc(ctx: AudioContext, type: Osc, freq: number, dest?: AudioNode | AudioParam): OscillatorNode;
-    _gain(ctx: AudioContext, val: number, dest?: AudioNode | AudioParam): GainNode;
-    _filter(ctx: AudioContext, type: Filter): BiquadFilterNode;
-    _pan(ctx: AudioContext, val: number, dest?: AudioNode): StereoPannerNode;
-    _on(t: number, s: number, ...n: AudioScheduledSourceNode[]): void;
-    _set(p: AudioParam, v: number, t: number): void;
-    _lin(p: AudioParam, v: number, t: number): void;
-    _exp(p: AudioParam, v: number, t: number): void;
-    _transient(ctx: AudioContext, type: Osc, freq: number, dest: AudioNode, time: number, peak: number, dur: number, atk?: number): void;
-    _filterSweep(ctx: AudioContext, type: Filter, f1: number, f2: number, t1: number, dur: number): BiquadFilterNode;
-    _stereoOsc(ctx: AudioContext, type: Osc, freq: number, detune: number, pan: number, dest: AudioNode): [OscillatorNode, OscillatorNode];
-    _lfo(ctx: AudioContext, freq: number, depth: number, time: number, fadeIn: number, stopTime: number, dest: AudioNode | AudioParam, delay?: number): GainNode;
-    _gc(ctx: AudioContext, time: number, stopTime: number, ...nodes: AudioNode[]): void;
+    _createOscillator(ctx: AudioContext, type: Osc, freq: number, dest?: AudioNode | AudioParam): OscillatorNode;
+    _createGain(ctx: AudioContext, val: number, dest?: AudioNode | AudioParam): GainNode;
+    _createFilter(ctx: AudioContext, type: Filter): BiquadFilterNode;
+    _createStereoPanner(ctx: AudioContext, val: number, dest?: AudioNode): StereoPannerNode;
+    _scheduleNodeStartStop(t: number, s: number, ...n: AudioScheduledSourceNode[]): void;
+    _setValueAtTime(p: AudioParam, v: number, t: number): void;
+    _linearRampToValue(p: AudioParam, v: number, t: number): void;
+    _exponentialRampToValue(p: AudioParam, v: number, t: number): void;
+    _createTransient(ctx: AudioContext, type: Osc, freq: number, dest: AudioNode, time: number, peak: number, dur: number, atk?: number): void;
+    _createFilterSweep(ctx: AudioContext, type: Filter, f1: number, f2: number, t1: number, dur: number): BiquadFilterNode;
+    _createStereoOscillator(ctx: AudioContext, type: Osc, freq: number, detune: number, pan: number, dest: AudioNode): [OscillatorNode, OscillatorNode];
+    _createLFO(ctx: AudioContext, freq: number, depth: number, time: number, fadeIn: number, stopTime: number, dest: AudioNode | AudioParam, delay?: number): GainNode;
+    /**
+     * Schedules a delayed garbage collection using a native C++ audio thread.
+     *
+     * @reason Why we use a dummy OscillatorNode instead of setTimeout:
+     * The JS event loop is inherently jittery and subject to GC pauses and tab throttling.
+     * By scheduling a silent OscillatorNode with a precise `.stop(stopTime)`, we leverage
+     * the Web Audio API's C++ audio thread to trigger the `onended` callback precisely at the sample
+     * boundary. This guarantees that `disconnect()` is called on exhausted nodes exactly when
+     * they finish decaying, preventing memory leaks (stray disconnected nodes) without any JS timing overhead.
+     *
+     * @param ctx The AudioContext.
+     * @param time The start time of the GC lifecycle.
+     * @param stopTime The exact time when the audio nodes should be completely unlinked from the graph.
+     * @param nodes The nodes to disconnect.
+     */
+    _scheduleNodeDisposal(ctx: AudioContext, time: number, stopTime: number, ...nodes: AudioNode[]): void;
 }
 //# sourceMappingURL=CoreSynthBase.d.ts.map

package/dist/Instruments/CoreSynthBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoreSynthBase.d.ts","sourceRoot":"","sources":["../../Instruments/CoreSynthBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,0BAAkB,GAAG;IACnB,IAAI,IAAI;IACR,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,QAAQ,IAAI;CACb;AACD,0BAAkB,MAAM;IACtB,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,QAAQ,IAAI;CACb;AAED,8BAAsB,aAAc,YAAW,gBAAgB;aAC7C,SAAS,CACvB,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;IAEA,IAAI,CACT,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAC5B,cAAc;IAOV,KAAK,CACV,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAC5B,QAAQ;IAMJ,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAK1D,IAAI,CACT,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,SAAS,GACf,gBAAgB;IAMZ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAMjE,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAG/C,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAG/C,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/C,UAAU,CACf,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAU,GACd,IAAI;IAOA,YAAY,CACjB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,GACV,gBAAgB;IAMZ,UAAU,CACf,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,GACd,CAAC,cAAc,EAAE,cAAc,CAAC;IAM5B,IAAI,CACT,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,GAAG,UAAU,EAC5B,KAAK,GAAE,MAAU,GAChB,QAAQ;IASJ,GAAG,CACR,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,KAAK,EAAE,SAAS,EAAE,GACpB,IAAI;CAcR"}
+{"version":3,"file":"CoreSynthBase.d.ts","sourceRoot":"","sources":["../../Instruments/CoreSynthBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,eAAO,MAAM,WAAW,SACmD,CAAC;AAE5E,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzD,8BAAsB,aAAc,YAAW,gBAAgB;aAC7C,SAAS,CACvB,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;IAEA,iBAAiB,CACtB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAC5B,cAAc;IAOV,WAAW,CAChB,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAC5B,QAAQ;IAMJ,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKhE,mBAAmB,CACxB,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,SAAS,GACf,gBAAgB;IAMZ,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAMpF,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAG1D,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAG7D,uBAAuB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlE,gBAAgB,CACrB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAU,GACd,IAAI;IAOA,kBAAkB,CACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,GACV,gBAAgB;IAMZ,uBAAuB,CAC5B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,GACd,CAAC,cAAc,EAAE,cAAc,CAAC;IAM5B,UAAU,CACf,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,GAAG,UAAU,EAC5B,KAAK,GAAE,MAAU,GAChB,QAAQ;IASX;;;;;;;;;;;;;;OAcG;IACI,qBAAqB,CAC1B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,KAAK,EAAE,SAAS,EAAE,GACpB,IAAI;CAkBR"}

package/dist/Instruments/CoreSynthBase.js

@@ -1,86 +1,105 @@
-const hasStrictGC = typeof __ENABLE_STRICT_GC__ !== "undefined" ? __ENABLE_STRICT_GC__ : true;
+export const hasStrictGC = typeof __ENABLE_STRICT_GC__ !== "undefined" ? __ENABLE_STRICT_GC__ : true;
 export class CoreSynthBase {
-    _osc(ctx, type, freq, dest) {
+    _createOscillator(ctx, type, freq, dest) {
         const o = ctx.createOscillator();
-        o.type = ["sine", "square", "sawtooth", "triangle"][type];
+        o.type = type;
         if (freq)
             o.frequency.value = Math.min(22000, freq);
         if (dest)
             o.connect(dest);
         return o;
     }
-    _gain(ctx, val, dest) {
+    _createGain(ctx, val, dest) {
         const g = ctx.createGain();
         g.gain.value = val;
         if (dest)
             g.connect(dest);
         return g;
     }
-    _filter(ctx, type) {
+    _createFilter(ctx, type) {
         const f = ctx.createBiquadFilter();
-        f.type = ["lowpass", "highpass", "bandpass"][type];
+        f.type = type;
         return f;
     }
-    _pan(ctx, val, dest) {
+    _createStereoPanner(ctx, val, dest) {
         const p = ctx.createStereoPanner();
         p.pan.value = val;
         if (dest)
             p.connect(dest);
         return p;
     }
-    _on(t, s, ...n) {
+    _scheduleNodeStartStop(t, s, ...n) {
         n.forEach((x) => {
             x.start(t);
             x.stop(s);
         });
     }
-    _set(p, v, t) {
+    _setValueAtTime(p, v, t) {
         p.setValueAtTime(Math.min(22000, v), t);
     }
-    _lin(p, v, t) {
+    _linearRampToValue(p, v, t) {
         p.linearRampToValueAtTime(Math.min(22000, v), t);
     }
-    _exp(p, v, t) {
+    _exponentialRampToValue(p, v, t) {
         p.exponentialRampToValueAtTime(Math.min(22000, v), t);
     }
-    _transient(ctx, type, freq, dest, time, peak, dur, atk = 0) {
-        const g = this._gain(ctx, 0, dest);
-        this._set(g.gain, atk > 0 ? 0 : peak, time);
+    _createTransient(ctx, type, freq, dest, time, peak, dur, atk = 0) {
+        const g = this._createGain(ctx, 0, dest);
+        this._setValueAtTime(g.gain, atk > 0 ? 0 : peak, time);
         if (atk > 0)
-            this._lin(g.gain, peak, time + atk);
-        this._exp(g.gain, 0.001, time + dur);
-        this._on(time, time + dur, this._osc(ctx, type, freq, g));
+            this._linearRampToValue(g.gain, peak, time + atk);
+        this._exponentialRampToValue(g.gain, 0.001, time + dur);
+        this._scheduleNodeStartStop(time, time + dur, this._createOscillator(ctx, type, freq, g));
     }
-    _filterSweep(ctx, type, f1, f2, t1, dur) {
-        const f = this._filter(ctx, type);
-        this._set(f.frequency, f1, t1);
-        this._exp(f.frequency, f2, t1 + dur);
+    _createFilterSweep(ctx, type, f1, f2, t1, dur) {
+        const f = this._createFilter(ctx, type);
+        this._setValueAtTime(f.frequency, f1, t1);
+        this._exponentialRampToValue(f.frequency, f2, t1 + dur);
         return f;
     }
-    _stereoOsc(ctx, type, freq, detune, pan, dest) {
+    _createStereoOscillator(ctx, type, freq, detune, pan, dest) {
         return [
-            this._osc(ctx, type, freq, this._pan(ctx, -pan, dest)),
-            this._osc(ctx, type, freq * detune, this._pan(ctx, pan, dest)),
+            this._createOscillator(ctx, type, freq, this._createStereoPanner(ctx, -pan, dest)),
+            this._createOscillator(ctx, type, freq * detune, this._createStereoPanner(ctx, pan, dest)),
         ];
     }
-    _lfo(ctx, freq, depth, time, fadeIn, stopTime, dest, delay = 0) {
-        const g = this._gain(ctx, 0, dest);
-        this._set(g.gain, 0, time);
+    _createLFO(ctx, freq, depth, time, fadeIn, stopTime, dest, delay = 0) {
+        const g = this._createGain(ctx, 0, dest);
+        this._setValueAtTime(g.gain, 0, time);
         if (delay > 0)
-            this._set(g.gain, 0, time + delay);
-        this._lin(g.gain, depth, time + delay + fadeIn);
-        this._on(time, stopTime, this._osc(ctx, 0 /* Osc.Sine */, freq, g));
+            this._setValueAtTime(g.gain, 0, time + delay);
+        this._linearRampToValue(g.gain, depth, time + delay + fadeIn);
+        this._scheduleNodeStartStop(time, stopTime, this._createOscillator(ctx, "sine", freq, g));
         return g;
     }
-    _gc(ctx, time, stopTime, ...nodes) {
+    /**
+     * Schedules a delayed garbage collection using a native C++ audio thread.
+     *
+     * @reason Why we use a dummy OscillatorNode instead of setTimeout:
+     * The JS event loop is inherently jittery and subject to GC pauses and tab throttling.
+     * By scheduling a silent OscillatorNode with a precise `.stop(stopTime)`, we leverage
+     * the Web Audio API's C++ audio thread to trigger the `onended` callback precisely at the sample
+     * boundary. This guarantees that `disconnect()` is called on exhausted nodes exactly when
+     * they finish decaying, preventing memory leaks (stray disconnected nodes) without any JS timing overhead.
+     *
+     * @param ctx The AudioContext.
+     * @param time The start time of the GC lifecycle.
+     * @param stopTime The exact time when the audio nodes should be completely unlinked from the graph.
+     * @param nodes The nodes to disconnect.
+     */
+    _scheduleNodeDisposal(ctx, time, stopTime, ...nodes) {
         if (hasStrictGC) {
-            const gcOsc = ctx.createOscillator();
+            const gcOsc = this._createOscillator(ctx, "sine", 0);
             gcOsc.onended = () => {
                 nodes.forEach((n) => {
                     try {
-                        n.disconnect();
+                        if (n && typeof n.disconnect === "function") {
+                            n.disconnect();
+                        }
+                    }
+                    catch (e) {
+                        // Safe swallow: Node may have been externally disconnected by Game Engine routing.
                     }
-                    catch (e) { }
                 });
             };
             gcOsc.start(time);

package/dist/Instruments/CoreSynthBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoreSynthBase.js","sourceRoot":"","sources":["../../Instruments/CoreSynthBase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CoreSynthBase.js","sourceRoot":"","sources":["../../Instruments/CoreSynthBase.ts"],"names":[],"mappings":"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"}

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

@@ -3,12 +3,19 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for Inharmonic Additive bells/glass.
  * Stacks sine waves at non-integer multiples to create metallic, clanging overtones.
  */
+/**
+ * Creates complex timbres by summing together multiple sine waves at mathematically calculated harmonic ratios.
+ *
+ * @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 AdditiveSynth 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/AdditiveSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdditiveSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/AdditiveSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAY,MAAM,qBAAqB,CAAC;AAG/D;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,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;CAapB"}
+{"version":3,"file":"AdditiveSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/AdditiveSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAY,MAAM,qBAAqB,CAAC;AAG/D;;;GAGG;AACH;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,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;CAapB"}

package/dist/Instruments/Decay/AdditiveSynth.js

@@ -3,10 +3,17 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for Inharmonic Additive bells/glass.
  * Stacks sine waves at non-integer multiples to create metallic, clanging overtones.
  */
+/**
+ * Creates complex timbres by summing together multiple sine waves at mathematically calculated harmonic ratios.
+ *
+ * @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 AdditiveSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.6, a: 0.005, d: 0.5, m: 5.0 };
+        this._envelopeConfig = { _peakVelocity: 0.6, _attackTimeSeconds: 0.005, _decayTimeSeconds: 0.5, _maxDurationSeconds: 5.0 };
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
         const ratios = [1.0, 2.76, 5.4, 8.9, 13.3];
@@ -16,7 +23,7 @@ export class AdditiveSynth extends DecaySynthBase {
             if (hFreq < 22000) {
                 const peak = Math.max(0.001, velocity * (1 / (i + 1.5)));
                 const dur = Math.max(0.1, safeDuration * decays[i]);
-                this._transient(ctx, 0 /* Osc.Sine */, hFreq, gain, time, peak, dur, 0.005);
+                this._createTransient(ctx, "sine", hFreq, gain, time, peak, dur, 0.005);
             }
         });
     }

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

@@ -1 +1 @@
-{"version":3,"file":"AdditiveSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/AdditiveSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAY,MAAM,qBAAqB,CAAC;AAG/D;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAAjD;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAwBtD,CAAC;IAtBW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,yCAAyC;QAEnF,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;YAC3B,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,IAAI,CAAC,UAAU,CAAC,GAAG,oBAAY,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACtE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"AdditiveSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/AdditiveSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAY,MAAM,qBAAqB,CAAC;AAG/D;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAAjD;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAwBlI,CAAC;IAtBW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,yCAAyC;QAEnF,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;YAC3B,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -2,11 +2,18 @@ import { AnalogSynthBase } from "../Analog/AnalogSynthBase.js";
 /**
  * Synthesizer strategy for Brass and Wind instruments with a slow filter envelope.
  */
+/**
+ * Simulates a brass instrument (e.g. Trumpet/Trombone) using a sawtooth wave and an envelope-driven lowpass filter to mimic breath pressure.
+ *
+ * @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 BrassSynth extends AnalogSynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        r: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _releaseTimeSeconds: number;
     };
     protected _setupSynthesis(ctx: AudioContext, gain: GainNode, time: number, freq: number, velocity: number, sustainTime: number, releaseTime: number, stopTime: number): AudioNode | void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"BrassSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/BrassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;GAEG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAC7C,SAAS,CAAC,EAAE;;;;MAA8B;IAE1C,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAsBpB"}
+{"version":3,"file":"BrassSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/BrassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;GAEG;AACH;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAC7C,SAAS,CAAC,eAAe;;;;MAA6E;IAEtG,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAsBpB"}

package/dist/Instruments/Decay/BrassSynth.js

@@ -2,27 +2,34 @@ import { AnalogSynthBase } from "../Analog/AnalogSynthBase.js";
 /**
  * Synthesizer strategy for Brass and Wind instruments with a slow filter envelope.
  */
+/**
+ * Simulates a brass instrument (e.g. Trumpet/Trombone) using a sawtooth wave and an envelope-driven lowpass filter to mimic breath pressure.
+ *
+ * @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 BrassSynth extends AnalogSynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.5, a: 0.1, r: 0.1 };
+        this._envelopeConfig = { _peakVelocity: 0.5, _attackTimeSeconds: 0.1, _releaseTimeSeconds: 0.1 };
     }
     _setupSynthesis(ctx, gain, time, freq, velocity, sustainTime, releaseTime, stopTime) {
-        const osc = this._osc(ctx, 1 /* Osc.Square */, 0, gain);
-        this._set(osc.frequency, freq * 0.95, time);
-        this._exp(osc.frequency, freq, time + 0.05);
-        const blareGain = this._gain(ctx, 0, gain);
-        this._set(blareGain.gain, 0, time);
-        this._lin(blareGain.gain, Math.max(0.001, velocity * 0.25), time + 0.05);
-        this._exp(blareGain.gain, 0.001, time + 0.2);
-        const blare = this._osc(ctx, 2 /* Osc.Sawtooth */, freq * 2, blareGain);
-        const filter = this._filter(ctx, 0 /* Filter.Lowpass */);
-        this._set(filter.frequency, freq + 400, time);
-        this._lin(filter.frequency, freq + 1500 + velocity * 1000, time + 0.1);
-        this._exp(filter.frequency, freq + 400, time + sustainTime + releaseTime);
+        const osc = this._createOscillator(ctx, "square", 0, gain);
+        this._setValueAtTime(osc.frequency, freq * 0.95, time);
+        this._exponentialRampToValue(osc.frequency, freq, time + 0.05);
+        const blareGain = this._createGain(ctx, 0, gain);
+        this._setValueAtTime(blareGain.gain, 0, time);
+        this._linearRampToValue(blareGain.gain, Math.max(0.001, velocity * 0.25), time + 0.05);
+        this._exponentialRampToValue(blareGain.gain, 0.001, time + 0.2);
+        const blare = this._createOscillator(ctx, "sawtooth", freq * 2, blareGain);
+        const filter = this._createFilter(ctx, "lowpass");
+        this._setValueAtTime(filter.frequency, freq + 400, time);
+        this._linearRampToValue(filter.frequency, freq + 1500 + velocity * 1000, time + 0.1);
+        this._exponentialRampToValue(filter.frequency, freq + 400, time + sustainTime + releaseTime);
         gain.connect(filter);
-        this._on(time, stopTime, osc);
-        this._on(time, time + 0.2, blare);
+        this._scheduleNodeStartStop(time, stopTime, osc);
+        this._scheduleNodeStartStop(time, time + 0.2, blare);
         return filter;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"BrassSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/BrassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,eAAe;IAA/C;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAiC5C,CAAC;IA/BW,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,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,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAgB,IAAI,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QAEhE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,yBAAiB,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;QAE1E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAElC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"BrassSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/BrassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;GAEG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,eAAe;IAA/C;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAiCxG,CAAC;IA/BW,eAAe,CACvB,GAAiB,EACjB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,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,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QACvF,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QAE3E,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QACrF,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;QAE7F,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAErD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -3,12 +3,19 @@ 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 declare class ChromaticPercussionSynth 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/ChromaticPercussionSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChromaticPercussionSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/ChromaticPercussionSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D,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;CAcpB"}
+{"version":3,"file":"ChromaticPercussionSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/ChromaticPercussionSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D,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;CAcpB"}