@fluex/fluexgl-dsp 0.4.1 → 0.4.3

package/lib/dist/core/classes/DpsPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DpsPipeline.d.ts","sourceRoot":"","sources":["../../../src/core/classes/DpsPipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,OAAO,EAAE,gCAAgC,EAAE,MAAM,eAAe,CAAC;AAEjE;;;GAGG;AACH,qBAAa,WAAW;IAEpB;;OAEG;IACI,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAExC;;OAEG;IACI,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE3C;;OAEG;IACI,EAAE,EAAE,MAAM,CAAQ;IAEzB;;OAEG;IACI,cAAc,EAAE,OAAO,CAAS;IAEvC;;OAEG;IACH,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,gCAAgC;IAKrD;;;;;OAKG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;OAMG;IACU,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IA0CtD;;;;;;OAMG;IACU,+BAA+B;IA+BrC,6CAA6C;CAGvD"}
+{"version":3,"file":"DpsPipeline.d.ts","sourceRoot":"","sources":["../../../src/core/classes/DpsPipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,OAAO,EAAE,gCAAgC,EAAE,MAAM,eAAe,CAAC;AAGjE;;;GAGG;AACH,qBAAa,WAAW;IAEpB;;OAEG;IACI,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAExC;;OAEG;IACI,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE3C;;OAEG;IACI,EAAE,EAAE,MAAM,CAAQ;IAEzB;;OAEG;IACI,cAAc,EAAE,OAAO,CAAS;IAEvC;;OAEG;IACH,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;;;OAKG;gBACS,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,gCAAgC;IAQpF;;;;;OAKG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;OAMG;IACU,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IA0CtD;;;;;;OAMG;IACU,+BAA+B;IA+BrC,6CAA6C;CAGvD"}

package/lib/dist/core/classes/DpsPipeline.js

@@ -4,6 +4,7 @@ import { Debug } from "../../utilities/debugger";
 import { LoadWebAssemblyModule } from "../../utilities/web-assembly";
 import { ConstructProcessorWorklet, LoadWorkletOnAudioDevice } from "../../utilities/helpers";
 import { ErrorCodes, WarningCodes } from "../../console-codes";
+import { DSP } from "../../index";
 /**
  * Represents the digital signal processing (DSP) pipeline responsible for initializing
  * WebAssembly modules, AudioWorklet processors, and resolving audio output devices.
@@ -35,9 +36,12 @@ export class DspPipeline {
      * @param options - Initialization options for the DSP pipeline.
      * Must include valid paths to the WebAssembly and AudioWorklet files.
      */
-    constructor(options) {
-        this.pathToWasm = options.pathToWasm;
-        this.pathToWorklet = options.pathToWorklet;
+    constructor({ pathToWasm, pathToWorklet, options }) {
+        this.pathToWasm = pathToWasm;
+        this.pathToWorklet = pathToWorklet;
+        // @ts-ignore
+        for (const key in options)
+            DSP[key] = options[key];
     }
     /**
      * Initializes the DSP pipeline.

package/lib/dist/core/classes/Effector.d.ts

@@ -4,7 +4,7 @@ export declare abstract class Effector {
     label: string | null;
     name: string;
     audioWorkletNode: AudioWorkletNode | null;
-    parentialContext: AudioContext | null;
+    context: AudioContext | null;
     private hasRegisteredMessageEventListener;
     private events;
     private handleIncomingMessages;
@@ -13,6 +13,6 @@ export declare abstract class Effector {
     Once<K extends keyof EffectorEventMap>(event: K, cb: EffectorEventMap[K]): () => void;
     RemoveEventListener<K extends keyof EffectorEventMap>(event: K, cb: EffectorEventMap[K]): Effector;
     ClearEventListeners(event?: keyof EffectorEventMap): Effector;
-    abstract InitializeOnAttachment(parentialContext: AudioContext): Promise<void>;
+    abstract InitializeOnAttachment(context: AudioContext): Promise<void>;
 }
 //# sourceMappingURL=Effector.d.ts.map

package/lib/dist/core/classes/Effector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Effector.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Effector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGhH,8BAAsB,QAAQ;IAEnB,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,IAAI,EAAE,MAAM,CAAc;IAC1B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,gBAAgB,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEpD,OAAO,CAAC,iCAAiC,CAAkB;IAE3D,OAAO,CAAC,MAAM,CAMb;IAED,OAAO,CAAC,sBAAsB;IAgB9B,SAAS,CAAC,4BAA4B,CAAC,IAAI,EAAE,gBAAgB;IAOtD,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOjG,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAarF,mBAAmB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ;IAalG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,gBAAgB,GAAG,QAAQ;aAWpD,sBAAsB,CAAC,gBAAgB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CACxF"}
+{"version":3,"file":"Effector.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Effector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGhH,8BAAsB,QAAQ;IAEnB,EAAE,EAAE,MAAM,CAAQ;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,IAAI,EAAE,MAAM,CAAc;IAE1B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE3C,OAAO,CAAC,iCAAiC,CAAkB;IAE3D,OAAO,CAAC,MAAM,CAMb;IAED,OAAO,CAAC,sBAAsB;IAgB9B,SAAS,CAAC,4BAA4B,CAAC,IAAI,EAAE,gBAAgB;IAOtD,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOjG,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAarF,mBAAmB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ;IAalG,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,gBAAgB,GAAG,QAAQ;aAWpD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/E"}

package/lib/dist/core/classes/Effector.js

@@ -5,7 +5,7 @@ export class Effector {
     label = null;
     name = "Effector";
     audioWorkletNode = null;
-    parentialContext = null;
+    context = null;
     hasRegisteredMessageEventListener = false;
     events = {
         "incoming-processor-error": [],

package/lib/dist/core/classes/Master.d.ts

@@ -1,12 +1,24 @@
 import { Channel } from "./Channel";
+import { Effector } from "./Effector";
+import { AudioClipPlayer } from "./AudioClipPlayer";
+import { AudioClip } from "./AudioClip";
 export declare class Master {
     id: string;
     channels: Channel[];
+    effects: Effector[];
+    input: GainNode | null;
     gainNode: GainNode | null;
     analyserNode: AnalyserNode | null;
     context: AudioContext | null;
+    audioClipPlayer: AudioClipPlayer | null;
     constructor(context: AudioContext);
+    private disconnectAudioNodes;
+    private rebuildEffectChain;
+    AttachEffect(effect: Effector): void;
+    DetachEffect(effect: Effector): void;
     AttachChannel(channel: Channel): void;
     DetachChannel(channel: Channel): void;
+    HasAudioClipPlayer(): boolean;
+    AttachAudioClip(audioClip: AudioClip): void;
 }
 //# sourceMappingURL=Master.d.ts.map

package/lib/dist/core/classes/Master.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Master.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Master.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,MAAM;IAER,EAAE,EAAE,MAAM,CAAQ;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAM;IAEzB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEzC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;gBAE/B,OAAO,EAAE,YAAY;IAW1B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAcrC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAmB/C"}
+{"version":3,"file":"Master.d.ts","sourceRoot":"","sources":["../../../src/core/classes/Master.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,qBAAa,MAAM;IAER,EAAE,EAAE,MAAM,CAAQ;IAElB,QAAQ,EAAE,OAAO,EAAE,CAAM;IACzB,OAAO,EAAE,QAAQ,EAAE,CAAM;IAEzB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC9B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACzC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAE1C,OAAO,EAAE,YAAY;IAmBjC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,kBAAkB;IAuBnB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAapC,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAkBpC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAcrC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAkBrC,kBAAkB,IAAI,OAAO;IAI7B,eAAe,CAAC,SAAS,EAAE,SAAS;CAM9C"}

package/lib/dist/core/classes/Master.js

@@ -1,41 +1,112 @@
 import { v4 } from "uuid";
 import { Debug } from "../../utilities/debugger";
+import { AudioClipPlayer } from "./AudioClipPlayer";
+import { ErrorCodes } from "lib/src/console-codes";
 export class Master {
     id = v4();
     channels = [];
+    effects = [];
+    input = null;
     gainNode = null;
     analyserNode = null;
     context = null;
+    audioClipPlayer = null;
     constructor(context) {
         this.context = context;
+        this.disconnectAudioNodes();
+        this.audioClipPlayer = new AudioClipPlayer(context);
+        this.input = new GainNode(context);
         this.gainNode = new GainNode(context);
         this.analyserNode = new AnalyserNode(context);
+        this.input.connect(this.gainNode);
         this.gainNode.connect(this.analyserNode);
         this.analyserNode.connect(this.context.destination);
+        this.audioClipPlayer.Send(this);
+    }
+    disconnectAudioNodes() {
+        if (this.input)
+            this.input.disconnect();
+        if (this.gainNode)
+            this.gainNode.disconnect();
+        if (this.analyserNode)
+            this.analyserNode.disconnect();
+        this.effects.forEach(function (effect) {
+            if (effect.audioWorkletNode)
+                effect.audioWorkletNode.disconnect();
+        });
+    }
+    rebuildEffectChain() {
+        if (!this.context)
+            return;
+        if (!this.input || !this.gainNode || !this.analyserNode)
+            return;
+        this.disconnectAudioNodes();
+        let currentNode = this.input;
+        this.effects.forEach(function (effect) {
+            if (!effect.audioWorkletNode)
+                return;
+            currentNode.connect(effect.audioWorkletNode);
+            currentNode = effect.audioWorkletNode;
+        });
+        currentNode.connect(this.gainNode);
+        this.gainNode.connect(this.analyserNode);
+        this.analyserNode.connect(this.context.destination);
+    }
+    AttachEffect(effect) {
+        if (this.effects.includes(effect))
+            return Debug.Error("Could not attach the effect because it is already part of this master channel.", [
+                "Call .DetachEffect([effect Effector]) before attaching the effect."
+            ], ErrorCodes.EFFECT_ALREADY_ATTACHED);
+        if (!this.context)
+            return this.rebuildEffectChain();
+        this.effects.push(effect);
+        effect.InitializeOnAttachment(this.context);
+        this.rebuildEffectChain();
+    }
+    DetachEffect(effect) {
+        if (!this.effects.includes(effect))
+            return Debug.Error("Could not detach the effect because it is not part of this master channel.", [
+                "Call .AttachEffect([effect Effector]) before detaching the effect."
+            ], ErrorCodes.EFFECT_NOT_FOUND);
+        const self = this;
+        this.effects.forEach(function (_effect, index) {
+            if (effect.id === _effect.id) {
+                self.effects.splice(index, 1);
+                return;
+            }
+        });
+        this.rebuildEffectChain();
     }
     AttachChannel(channel) {
         if (this.channels.includes(channel))
             return Debug.Error("Could not attach the channel because it is already part of this master channel.", [
                 "Call .DetachChannel([channel Channel]) before attaching the channel."
-            ]);
+            ], ErrorCodes.CHANNEL_ALREADY_ATTACHED);
         this.channels.push(channel);
-        if (channel.output && this.gainNode)
-            channel.output.connect(this.gainNode);
+        if (channel.output && this.input)
+            channel.output.connect(this.input);
         return;
     }
     DetachChannel(channel) {
         if (!this.channels.includes(channel))
             return Debug.Error("Could not detach the channel because it is not part of this master channel.", [
                 "Call .AttachChannel([channel Channel]) before detaching the channel."
-            ]);
-        if (channel.output && this.gainNode)
-            channel.output.disconnect(this.gainNode);
+            ], ErrorCodes.CHANNEL_NOT_FOUND);
+        if (channel.output && this.input)
+            channel.output.disconnect(this.input);
         const self = this;
         this.channels.forEach(function (_channel, index) {
-            if (channel.id === _channel.id) {
-                self.channels.splice(index, 1);
+            if (channel.id !== _channel.id)
                 return;
-            }
+            self.channels.splice(index, 1);
         });
     }
+    HasAudioClipPlayer() {
+        return !!this.audioClipPlayer;
+    }
+    AttachAudioClip(audioClip) {
+        if (!this.audioClipPlayer)
+            return Debug.Error("Cannot not link AudioClip to this channel because this channel's AudioClipPlayer is undefined.");
+        this.audioClipPlayer.AttachAudioClip(audioClip);
+    }
 }

package/lib/dist/effects/classes/Analyser.d.ts

@@ -0,0 +1,16 @@
+import { Effector } from "../../core/exports";
+export declare class Analyser extends Effector {
+    label: string | null;
+    name: string;
+    analyserNode: AnalyserNode | null;
+    float32ArrayBuffer: Float32Array<ArrayBuffer>;
+    uint8ArrayBuffer: Uint8Array<ArrayBuffer>;
+    private options;
+    constructor(options?: Partial<AnalyserOptions>);
+    InitializeOnAttachment(context: AudioContext): Promise<void>;
+    SetOptions(options: Partial<AnalyserOptions>): void;
+    GetWaveformFloatData(): Float32Array | null;
+    GetWaveformByteData(): Uint8Array | null;
+    private allocateBuffers;
+}
+//# sourceMappingURL=Analyser.d.ts.map

package/lib/dist/effects/classes/Analyser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Analyser.d.ts","sourceRoot":"","sources":["../../../src/effects/classes/Analyser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEzC,kBAAkB,4BAAsB;IACxC,gBAAgB,0BAAoB;IAE3C,OAAO,CAAC,OAAO,CAKb;gBAEU,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAMjC,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAwBnD,oBAAoB,IAAI,YAAY,GAAG,IAAI;IAQ3C,mBAAmB,IAAI,UAAU,GAAG,IAAI;IAQ/C,OAAO,CAAC,eAAe;CAO1B"}

package/lib/dist/effects/classes/Analyser.js

@@ -0,0 +1,62 @@
+import { Effector } from "../../core/exports";
+export class Analyser extends Effector {
+    label = "Analyser";
+    name = "Analyser";
+    analyserNode = null;
+    float32ArrayBuffer = new Float32Array();
+    uint8ArrayBuffer = new Uint8Array();
+    options = {
+        fftSize: 32,
+        smoothingTimeConstant: 0.8,
+        minDecibels: -90,
+        maxDecibels: -10,
+    };
+    constructor(options) {
+        super();
+        if (options)
+            this.SetOptions(options);
+    }
+    async InitializeOnAttachment(context) {
+        this.context = context;
+        this.analyserNode = new AnalyserNode(context, this.options);
+        this.audioWorkletNode = this.analyserNode;
+        this.allocateBuffers();
+    }
+    SetOptions(options) {
+        Object.keys(options).forEach((key) => {
+            const value = options[key];
+            if (typeof value === "undefined")
+                return;
+            if (key === "fftSize" && value) {
+                const allowed = [32, 64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768];
+                if (!allowed.includes(value))
+                    return;
+            }
+            this.options[key] = value;
+            if (this.analyserNode) {
+                this.analyserNode[key] = value;
+            }
+        });
+        if (options.fftSize && this.analyserNode) {
+            this.allocateBuffers();
+        }
+    }
+    GetWaveformFloatData() {
+        if (!this.analyserNode)
+            return null;
+        this.analyserNode.getFloatTimeDomainData(this.float32ArrayBuffer);
+        return this.float32ArrayBuffer;
+    }
+    GetWaveformByteData() {
+        if (!this.analyserNode)
+            return null;
+        this.analyserNode.getByteTimeDomainData(this.uint8ArrayBuffer);
+        return this.uint8ArrayBuffer;
+    }
+    allocateBuffers() {
+        if (!this.analyserNode)
+            return;
+        this.float32ArrayBuffer = new Float32Array(this.analyserNode.fftSize);
+        this.uint8ArrayBuffer = new Uint8Array(this.analyserNode.fftSize);
+    }
+}

package/lib/dist/effects/classes/Chorus.d.ts

@@ -1,5 +1,5 @@
 import { Effector } from "../../core/classes/Effector";
-import { ChorusEffectOptions } from "../../typings";
+import { ChorusEffectOptions, StrictMode } from "../../typings";
 export declare class Chorus extends Effector {
     label: string | null;
     name: string;
@@ -8,8 +8,9 @@ export declare class Chorus extends Effector {
     rateHz: number;
     mix: number;
     feedback: number;
-    constructor({ baseDelayMs, depthMs, rateHz, mix, feedback }: Partial<ChorusEffectOptions>);
-    InitializeOnAttachment(parentialContext: AudioContext): Promise<void>;
+    strictMode: StrictMode;
+    constructor({ baseDelayMs, depthMs, rateHz, mix, feedback, strictMode }: Partial<ChorusEffectOptions>);
+    InitializeOnAttachment(context: AudioContext): Promise<void>;
     ReturnOptionsAsObject(): ChorusEffectOptions;
     SetBaseDelayMs(value: number): boolean;
     SetDepthMs(value: number): boolean;

package/lib/dist/effects/classes/Chorus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chorus.d.ts","sourceRoot":"","sources":["../../../src/effects/classes/Chorus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAsD,MAAM,eAAe,CAAC;AAExG,qBAAa,MAAO,SAAQ,QAAQ;IAEzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAY;IAChC,IAAI,EAAE,MAAM,CAAY;IAExB,WAAW,EAAE,MAAM,CAAM;IACzB,OAAO,EAAE,MAAM,CAAK;IACpB,MAAM,EAAE,MAAM,CAAO;IACrB,GAAG,EAAE,MAAM,CAAO;IAClB,QAAQ,EAAE,MAAM,CAAO;gBAElB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAU5E,sBAAsB,CAAC,gBAAgB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E,qBAAqB,IAAI,mBAAmB;IAU5C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKtC,UAAU,CAAC,KAAK,EAAE,MAAM;IAKxB,SAAS,CAAC,KAAK,EAAE,MAAM;IAKvB,MAAM,CAAC,KAAK,EAAE,MAAM;IAKpB,WAAW,CAAC,KAAK,EAAE,MAAM;CAInC"}
+{"version":3,"file":"Chorus.d.ts","sourceRoot":"","sources":["../../../src/effects/classes/Chorus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAsD,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpH,qBAAa,MAAO,SAAQ,QAAQ;IAEzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAY;IAChC,IAAI,EAAE,MAAM,CAAY;IAExB,WAAW,EAAE,MAAM,CAAM;IACzB,OAAO,EAAE,MAAM,CAAK;IACpB,MAAM,EAAE,MAAM,CAAO;IACrB,GAAG,EAAE,MAAM,CAAO;IAClB,QAAQ,EAAE,MAAM,CAAO;IACvB,UAAU,EAAE,UAAU,CAAuB;gBAExC,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAaxF,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE,qBAAqB,IAAI,mBAAmB;IAW5C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMtC,UAAU,CAAC,KAAK,EAAE,MAAM;IAMxB,SAAS,CAAC,KAAK,EAAE,MAAM;IAMvB,MAAM,CAAC,KAAK,EAAE,MAAM;IAMpB,WAAW,CAAC,KAAK,EAAE,MAAM;CAKnC"}

package/lib/dist/effects/classes/Chorus.js

@@ -1,6 +1,6 @@
-import { SendMessageToWorklet, CreateAudioWorkletNode } from "../../utilities/helpers";
+import { CoerceFiniteNumber, SendMessageToWorklet, CreateAudioWorkletNode } from "../../utilities/helpers";
 import { Effector } from "../../core/classes/Effector";
-import { ChorusMessageCommandId, AudioWorkletProcessorNames } from "../../typings";
+import { ChorusMessageCommandId, AudioWorkletProcessorNames, StrictMode } from "../../typings";
 export class Chorus extends Effector {
     label = "Chorus";
     name = "Chorus";
@@ -9,17 +9,20 @@ export class Chorus extends Effector {
     rateHz = 1.5;
     mix = 0.5;
     feedback = 0.2;
-    constructor({ baseDelayMs, depthMs, rateHz, mix, feedback }) {
+    strictMode = StrictMode.Disabled;
+    constructor({ baseDelayMs, depthMs, rateHz, mix, feedback, strictMode }) {
         super();
-        this.baseDelayMs = baseDelayMs ?? this.baseDelayMs;
-        this.depthMs = depthMs ?? this.depthMs;
-        this.rateHz = rateHz ?? this.rateHz;
-        this.mix = mix ?? this.mix;
-        this.feedback = feedback ?? this.feedback;
-    }
-    async InitializeOnAttachment(parentialContext) {
-        this.parentialContext = parentialContext;
-        this.audioWorkletNode = CreateAudioWorkletNode(parentialContext, AudioWorkletProcessorNames.Chorus, this.ReturnOptionsAsObject());
+        this.baseDelayMs = Math.max(0, CoerceFiniteNumber(baseDelayMs, this.baseDelayMs));
+        this.depthMs = Math.max(0, CoerceFiniteNumber(depthMs, this.depthMs));
+        this.rateHz = Math.max(0, CoerceFiniteNumber(rateHz, this.rateHz));
+        this.mix = Math.max(0, Math.min(1, CoerceFiniteNumber(mix, this.mix)));
+        this.feedback = Math.max(0, Math.min(1, CoerceFiniteNumber(feedback, this.feedback)));
+        const mode = CoerceFiniteNumber(strictMode, this.strictMode);
+        this.strictMode = mode === StrictMode.Enabled ? StrictMode.Enabled : StrictMode.Disabled;
+    }
+    async InitializeOnAttachment(context) {
+        this.context = context;
+        this.audioWorkletNode = CreateAudioWorkletNode(context, AudioWorkletProcessorNames.Chorus, this.ReturnOptionsAsObject());
     }
     ReturnOptionsAsObject() {
         return {
@@ -28,25 +31,31 @@ export class Chorus extends Effector {
             rateHz: this.rateHz,
             mix: this.mix,
             feedback: this.feedback,
+            strictMode: this.strictMode
         };
     }
     SetBaseDelayMs(value) {
+        value = Math.max(0, CoerceFiniteNumber(value, this.baseDelayMs));
         this.baseDelayMs = value;
         return SendMessageToWorklet(this.audioWorkletNode, ChorusMessageCommandId.SetBaseDelayMs, value);
     }
     SetDepthMs(value) {
+        value = Math.max(0, CoerceFiniteNumber(value, this.depthMs));
         this.depthMs = value;
         return SendMessageToWorklet(this.audioWorkletNode, ChorusMessageCommandId.SetDepthMs, value);
     }
     SetRateHz(value) {
+        value = Math.max(0, CoerceFiniteNumber(value, this.rateHz));
         this.rateHz = value;
         return SendMessageToWorklet(this.audioWorkletNode, ChorusMessageCommandId.SetRateHz, value);
     }
     SetMix(value) {
+        value = Math.max(0, Math.min(1, CoerceFiniteNumber(value, this.mix)));
         this.mix = value;
         return SendMessageToWorklet(this.audioWorkletNode, ChorusMessageCommandId.SetMix, value);
     }
     SetFeedback(value) {
+        value = Math.max(0, Math.min(1, CoerceFiniteNumber(value, this.feedback)));
         this.feedback = value;
         return SendMessageToWorklet(this.audioWorkletNode, ChorusMessageCommandId.SetFeedback, value);
     }

package/lib/dist/effects/classes/clips/HardClip.d.ts

@@ -1,12 +1,13 @@
 import { Effector } from "../../../core/classes/Effector";
-import { HardClipOptions } from "../../../typings";
+import { HardClipOptions, StrictMode } from "../../../typings";
 export declare class HardClip extends Effector {
     label: string | null;
     name: string;
     drive: number;
     gain: number;
-    constructor({ drive, gain }: Partial<HardClipOptions>);
-    InitializeOnAttachment(parentialContext: AudioContext): Promise<void>;
+    strictMode: StrictMode;
+    constructor({ drive, gain, strictMode }: Partial<HardClipOptions>);
+    InitializeOnAttachment(context: AudioContext): Promise<void>;
     ReturnOptionsAsObject(): HardClipOptions;
     SetDrive(drive: number): boolean;
     SetGain(gain: number): boolean;

package/lib/dist/effects/classes/clips/HardClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HardClip.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/clips/HardClip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAwD,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzG,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,KAAK,EAAE,MAAM,CAAK;IAClB,IAAI,EAAE,MAAM,CAAK;gBAEZ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC;IAOxC,sBAAsB,CAAC,gBAAgB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3E,qBAAqB,IAAI,eAAe;IAOvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKjC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAIxC"}
+{"version":3,"file":"HardClip.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/clips/HardClip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAwD,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAErH,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,KAAK,EAAE,MAAM,CAAK;IAClB,IAAI,EAAE,MAAM,CAAK;IACjB,UAAU,EAAE,UAAU,CAAuB;gBAExC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC;IAUpD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE,qBAAqB,IAAI,eAAe;IAQvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMjC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAKxC"}

package/lib/dist/effects/classes/clips/HardClip.js

@@ -1,31 +1,37 @@
 import { Effector } from "../../../core/classes/Effector";
-import { CreateAudioWorkletNode, SendMessageToWorklet } from "../../../utilities/helpers";
-import { HardClipMessageCommandId, AudioWorkletProcessorNames } from "../../../typings";
+import { CoerceFiniteNumber, CreateAudioWorkletNode, SendMessageToWorklet } from "../../../utilities/helpers";
+import { HardClipMessageCommandId, AudioWorkletProcessorNames, StrictMode } from "../../../typings";
 export class HardClip extends Effector {
     label = "HardClip";
     name = "HardClip";
     drive = 1;
     gain = 1;
-    constructor({ drive, gain }) {
+    strictMode = StrictMode.Disabled;
+    constructor({ drive, gain, strictMode }) {
         super();
-        this.drive = drive ?? this.drive;
-        this.gain = gain ?? this.gain;
+        this.drive = Math.max(0, CoerceFiniteNumber(drive, this.drive));
+        this.gain = Math.max(0, CoerceFiniteNumber(gain, this.gain));
+        const mode = CoerceFiniteNumber(strictMode, this.strictMode);
+        this.strictMode = mode === StrictMode.Enabled ? StrictMode.Enabled : StrictMode.Disabled;
     }
-    async InitializeOnAttachment(parentialContext) {
-        this.parentialContext = parentialContext;
-        this.audioWorkletNode = CreateAudioWorkletNode(parentialContext, AudioWorkletProcessorNames.HardClip, this.ReturnOptionsAsObject());
+    async InitializeOnAttachment(context) {
+        this.context = context;
+        this.audioWorkletNode = CreateAudioWorkletNode(context, AudioWorkletProcessorNames.HardClip, this.ReturnOptionsAsObject());
     }
     ReturnOptionsAsObject() {
         return {
             drive: this.drive,
-            gain: this.gain
+            gain: this.gain,
+            strictMode: this.strictMode
         };
     }
     SetDrive(drive) {
+        drive = Math.max(0, CoerceFiniteNumber(drive, this.drive));
         this.drive = drive;
         return SendMessageToWorklet(this.audioWorkletNode, HardClipMessageCommandId.SetDrive, drive);
     }
     SetGain(gain) {
+        gain = Math.max(0, CoerceFiniteNumber(gain, this.gain));
         this.gain = gain;
         return SendMessageToWorklet(this.audioWorkletNode, HardClipMessageCommandId.SetGain, gain);
     }

package/lib/dist/effects/classes/clips/SoftClip.d.ts

@@ -1,12 +1,13 @@
 import { Effector } from "../../../core/classes/Effector";
-import { SoftClipOptions } from "../../../typings";
+import { SoftClipOptions, StrictMode } from "../../../typings";
 export declare class SoftClip extends Effector {
     label: string | null;
     name: string;
     drive: number;
     gain: number;
-    constructor({ drive, gain }: Partial<SoftClipOptions>);
-    InitializeOnAttachment(parentialContext: AudioContext): Promise<void>;
+    strictMode: StrictMode;
+    constructor({ drive, gain, strictMode }: Partial<SoftClipOptions>);
+    InitializeOnAttachment(context: AudioContext): Promise<void>;
     ReturnOptionsAsObject(): SoftClipOptions;
     SetDrive(drive: number): boolean;
     SetGain(gain: number): boolean;

package/lib/dist/effects/classes/clips/SoftClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoftClip.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/clips/SoftClip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAwD,MAAM,kBAAkB,CAAC;AAEzG,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,KAAK,EAAE,MAAM,CAAK;IAClB,IAAI,EAAE,MAAM,CAAK;gBAEZ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC;IAOxC,sBAAsB,CAAC,gBAAgB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3E,qBAAqB,IAAI,eAAe;IAOxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAIxC"}
+{"version":3,"file":"SoftClip.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/clips/SoftClip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAwD,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAErH,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAc;IAClC,IAAI,EAAE,MAAM,CAAc;IAE1B,KAAK,EAAE,MAAM,CAAK;IAClB,IAAI,EAAE,MAAM,CAAK;IACjB,UAAU,EAAE,UAAU,CAAuB;gBAExC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC;IAUpD,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE,qBAAqB,IAAI,eAAe;IAQxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAKxC"}

package/lib/dist/effects/classes/clips/SoftClip.js

@@ -1,31 +1,37 @@
-import { CreateAudioWorkletNode, SendMessageToWorklet } from "../../../utilities/helpers";
+import { CoerceFiniteNumber, CreateAudioWorkletNode, SendMessageToWorklet } from "../../../utilities/helpers";
 import { Effector } from "../../../core/classes/Effector";
-import { AudioWorkletProcessorNames, SoftClipMessageCommandId } from "../../../typings";
+import { AudioWorkletProcessorNames, SoftClipMessageCommandId, StrictMode } from "../../../typings";
 export class SoftClip extends Effector {
     label = "SoftClip";
     name = "SoftClip";
     drive = 1;
     gain = 1;
-    constructor({ drive, gain }) {
+    strictMode = StrictMode.Disabled;
+    constructor({ drive, gain, strictMode }) {
         super();
-        this.drive = drive ?? this.drive;
-        this.gain = gain ?? this.gain;
+        this.drive = Math.max(0, CoerceFiniteNumber(drive, this.drive));
+        this.gain = Math.max(0, CoerceFiniteNumber(gain, this.gain));
+        const mode = CoerceFiniteNumber(strictMode, this.strictMode);
+        this.strictMode = mode === StrictMode.Enabled ? StrictMode.Enabled : StrictMode.Disabled;
     }
-    async InitializeOnAttachment(parentialContext) {
-        this.parentialContext = parentialContext;
-        this.audioWorkletNode = CreateAudioWorkletNode(parentialContext, AudioWorkletProcessorNames.SoftClip, this.ReturnOptionsAsObject());
+    async InitializeOnAttachment(context) {
+        this.context = context;
+        this.audioWorkletNode = CreateAudioWorkletNode(context, AudioWorkletProcessorNames.SoftClip, this.ReturnOptionsAsObject());
     }
     ReturnOptionsAsObject() {
         return {
             drive: this.drive,
-            gain: this.gain
+            gain: this.gain,
+            strictMode: this.strictMode
         };
     }
     SetDrive(drive) {
+        drive = Math.max(0, CoerceFiniteNumber(drive, this.drive));
         this.drive = drive;
         return SendMessageToWorklet(this.audioWorkletNode, SoftClipMessageCommandId.SetDrive, drive);
     }
     SetGain(gain) {
+        gain = Math.max(0, CoerceFiniteNumber(gain, this.gain));
         this.gain = gain;
         return SendMessageToWorklet(this.audioWorkletNode, SoftClipMessageCommandId.SetGain, gain);
     }

package/lib/dist/effects/classes/filters/LowPassFilter.d.ts

@@ -1,13 +1,14 @@
 import { Effector } from "../../../core/classes/Effector";
-import { LowPassFilterOptions } from "../../../typings";
+import { LowPassFilterOptions, StrictMode } from "../../../typings";
 export declare class LowPassFilter extends Effector {
     name: string;
     label: string | null;
     cutoff: number;
     q: number;
     minFrequency: number;
-    constructor({ cutoff, minFrequency, q }: Partial<LowPassFilterOptions>);
-    InitializeOnAttachment(parentialContext: AudioContext): Promise<void>;
+    strictMode: StrictMode;
+    constructor({ cutoff, minFrequency, q, strictMode }: Partial<LowPassFilterOptions>);
+    InitializeOnAttachment(context: AudioContext): Promise<void>;
     ReturnOptionsAsObject(): LowPassFilterOptions;
     SetCutoff(cutoff?: number): boolean;
     SetMinFrequency(minFrequency?: number): boolean;

package/lib/dist/effects/classes/filters/LowPassFilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LowPassFilter.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/filters/LowPassFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAI1D,OAAO,EAAE,oBAAoB,EAA6D,MAAM,kBAAkB,CAAC;AAEnH,qBAAa,aAAc,SAAQ,QAAQ;IAEhC,IAAI,EAAE,MAAM,CAAmB;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAmB;IAEvC,MAAM,EAAE,MAAM,CAAQ;IACtB,CAAC,EAAE,MAAM,CAAO;IAChB,YAAY,EAAE,MAAM,CAAM;gBAErB,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAQzD,sBAAsB,CAAC,gBAAgB,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E,qBAAqB,IAAI,oBAAoB;IAQ7C,SAAS,CAAC,MAAM,GAAE,MAAa,GAAG,OAAO;IAWzC,eAAe,CAAC,YAAY,GAAE,MAAW,GAAG,OAAO;IASnD,IAAI,CAAC,CAAC,GAAE,MAAY,GAAG,OAAO;CAQxC"}
+{"version":3,"file":"LowPassFilter.d.ts","sourceRoot":"","sources":["../../../../src/effects/classes/filters/LowPassFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAI1D,OAAO,EAAE,oBAAoB,EAA6D,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/H,qBAAa,aAAc,SAAQ,QAAQ;IAEhC,IAAI,EAAE,MAAM,CAAmB;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAmB;IAEvC,MAAM,EAAE,MAAM,CAAQ;IACtB,CAAC,EAAE,MAAM,CAAO;IAChB,YAAY,EAAE,MAAM,CAAM;IAC1B,UAAU,EAAE,UAAU,CAAuB;gBAExC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAWrE,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,qBAAqB,IAAI,oBAAoB;IAS7C,SAAS,CAAC,MAAM,GAAE,MAAa,GAAG,OAAO;IAczC,eAAe,CAAC,YAAY,GAAE,MAAW,GAAG,OAAO;IAWnD,IAAI,CAAC,CAAC,GAAE,MAAY,GAAG,OAAO;CAWxC"}