@woosh/meep-engine 3.45.0 → 3.47.0

package/src/engine/sound/sopra/definition/clip/SampleAudioClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SampleAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/SampleAudioClip.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IA2CI;;;;;OAKG;IACH,iBAJW,MAAM,mFACN;QAAC,UAAU,CAAC,EAAC,OAAO,CAAC;QAAC,IAAI,CAAC,EAAC,OAAO,CAAC;QAAC,IAAI,CAAC,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,UAAU,CAAC,EAAC,MAAM,CAAA;KAAC,GAC5I,eAAe,CAyB3B;IAtED;;;OAGG;IACH,KAFU,MAAM,CAEP;IAET;;;OAGG;IACH,YAFU,OAAO,CAEE;IAEnB;;OAEG;IACH,MAFU,OAAO,CAEJ;IAEb;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,YAFU,MAAM,CAED;IAiCf;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAWnB;IAkBD;;OAEG;IACH,SAFa,eAAe,CAe3B;IAED;;;;;;;;;;MAYC;IAED;;;;;;;;;;aAUC;IAED;;;;;;OAMG;IACH,gCALW,MAAM,eACN,MAAM,WACN,MAAM,GACJ;QAAC,KAAK,EAAE;YAAC,IAAI,EAAE,eAAe,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CA6BtI;IAED,uCAGC;CAKJ;;;;kCAzMiC,wBAAwB"}
+{"version":3,"file":"SampleAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/SampleAudioClip.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH;IA2CI;;;;;OAKG;IACH,iBAJW,MAAM,mFACN;QAAC,UAAU,CAAC,EAAC,OAAO,CAAC;QAAC,IAAI,CAAC,EAAC,OAAO,CAAC;QAAC,IAAI,CAAC,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,UAAU,CAAC,EAAC,MAAM,CAAA;KAAC,GAC5I,eAAe,CAyB3B;IAtED;;;OAGG;IACH,KAFU,MAAM,CAEP;IAET;;;OAGG;IACH,YAFU,OAAO,CAEE;IAEnB;;OAEG;IACH,MAFU,OAAO,CAEJ;IAEb;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,YAFU,MAAM,CAED;IAiCf;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAWnB;IAwBD;;OAEG;IACH,SAFa,eAAe,CAe3B;IAED;;;;;;;;;;MAYC;IAED;;;;;;;;;;aAUC;IAED;;;;;;OAMG;IACH,gCALW,MAAM,eACN,MAAM,WACN,MAAM,GACJ;QAAC,KAAK,EAAE;YAAC,IAAI,EAAE,eAAe,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CA6BtI;IAED,uCAGC;CAKJ;;;;kCA/MiC,wBAAwB"}

package/src/engine/sound/sopra/definition/clip/SampleAudioClip.js

@@ -1,4 +1,5 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
 import { computeStringHash } from "../../../../../core/primitives/strings/computeStringHash.js";
 import { AbstractAudioClip } from "./AbstractAudioClip.js";
@@ -102,14 +103,20 @@ export class SampleAudioClip extends AbstractAudioClip {
      * @returns {number}
      */
     hash() {
-        return combine_hash(
-            super.hash(),
-            computeStringHash(this.url),
-            this.usingAlias ? 1 : 0,
-            this.loop ? 1 : 0,
-            computeHashFloat(this.loopStart),
-            computeHashFloat(this.loopEnd),
-            computeHashFloat(this.pitchRandom),
+        return hash_mix2(
+            hash_mix3(
+                hash_mix3(
+                    hash_mix3(
+                        super.hash(),
+                        computeStringHash(this.url),
+                        this.usingAlias ? 1 : 0
+                    ),
+                    this.loop ? 1 : 0,
+                    computeHashFloat(this.loopStart)
+                ),
+                computeHashFloat(this.loopEnd),
+                computeHashFloat(this.pitchRandom)
+            ),
             computeHashFloat(this.gainRandom)
         );
     }

package/src/engine/sound/sopra/definition/clip/SilenceAudioClip.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
 import { AbstractAudioClip } from "./AbstractAudioClip.js";
 
@@ -39,7 +39,7 @@ export class SilenceAudioClip extends AbstractAudioClip {
     }
 
     hash() {
-        return combine_hash(
+        return hash_mix2(
             super.hash(),
             computeHashFloat(this.duration)
         );

package/src/engine/sound/sopra/definition/clip/SwitchContainerAudioClip.d.ts

@@ -46,12 +46,12 @@ export class SwitchContainerAudioClip extends ContainerAudioClip {
         parameter: string;
         defaultValue: number;
         children: {
-            type: string;
             /**
              * @param {AbstractAudioClip[]} [children]
              * @param {{parameter?:string, defaultValue?:number}} [options]
              * @returns {SwitchContainerAudioClip}
              */
+            type: string;
             data: any;
         }[];
     };

package/src/engine/sound/sopra/definition/clip/SwitchContainerAudioClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SwitchContainerAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/SwitchContainerAudioClip.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IAcI;;;;OAIG;IACH,uBAJW,mBAAmB,gCACnB;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,YAAY,CAAC,EAAC,MAAM,CAAA;KAAC,GACvC,wBAAwB,CAUpC;IAzBD;;;OAGG;IACH,WAFU,MAAM,CAED;IAEf;;;OAGG;IACH,cAFU,MAAM,CAEC;IAmCjB;;;;;;;;;MAWC;IAED;;;OAGG;IACH,cAHW,wBAAwB,GACtB,OAAO,CAMnB;IAWD,kCAYC;IAED;;;;;;;YA/EA;;;;eAIG;;;MAmFF;IAED;;;;;;aAMC;;CACJ;;;;mCAvHkC,yBAAyB"}
+{"version":3,"file":"SwitchContainerAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/SwitchContainerAudioClip.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IAcI;;;;OAIG;IACH,uBAJW,mBAAmB,gCACnB;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,YAAY,CAAC,EAAC,MAAM,CAAA;KAAC,GACvC,wBAAwB,CAUpC;IAzBD;;;OAGG;IACH,WAFU,MAAM,CAED;IAEf;;;OAGG;IACH,cAFU,MAAM,CAEC;IAmCjB;;;;;;;;;MAWC;IAED;;;OAGG;IACH,cAHW,wBAAwB,GACtB,OAAO,CAMnB;IAWD,kCAYC;IAED;;;;;;YA/EA;;;;eAIG;;;;MAmFF;IAED;;;;;;aAMC;;CACJ;;;;mCAvHkC,yBAAyB"}

package/src/engine/sound/sopra/definition/clip/SwitchContainerAudioClip.js

@@ -1,4 +1,4 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
 import { computeStringHash } from "../../../../../core/primitives/strings/computeStringHash.js";
 import { ContainerAudioClip } from "./ContainerAudioClip.js";
@@ -82,7 +82,7 @@ export class SwitchContainerAudioClip extends ContainerAudioClip {
 
     hash() {
         // super.hash() already folds gain/pitch + children; only this class's own fields go on top
-        return combine_hash(
+        return hash_mix3(
             super.hash(),
             computeStringHash(this.parameter),
             computeHashFloat(this.defaultValue)

package/src/engine/sound/sopra/definition/effect/AbstractAudioEffect.d.ts

@@ -1,24 +1,53 @@
 /**
- * Base class for serializable bus insert effects.
+ * What {@link AbstractAudioEffect#build} returns: the live sub-graph, as the two nodes it is spliced in by,
+ * and the parameters that can be moved while it plays.
  *
- * An effect is a DEFINITION; {@link build} turns it into a live WebAudio sub-graph. The returned
- * `{ input, output }` lets the {@link BusGraph} splice the effect into a bus chain
- * (`input → effect → output`); for single-node effects `input === output`.
+ * `params` holds the live {@link AudioParam} of each of the class's {@link AbstractAudioEffect.parameters},
+ * in that order. Omitted by an effect that declares none.
+ *
+ * @typedef {{input: AudioNode, output: AudioNode, params?: AudioParam[]}} BuiltAudioEffect
+ */
+/**
+ * Base class for serializable insert effects — on a bus ({@link BusDefinition.effects}) or on an event
+ * ({@link EventDescription.effects}).
+ *
+ * An effect is a DEFINITION; {@link build} turns it into a live WebAudio sub-graph, once per bus or once per
+ * playing instance. The returned `{ input, output }` lets an {@link EffectChain} splice the effect in
+ * (`input → effect → output`); for single-node effects `input === output`. The definition is never touched
+ * at runtime: a parameter moved on a built effect moves that one copy (see `SopraEngine.setBusEffectParam`,
+ * `EventInstance.setEffectParam`).
+ *
+ * A subclass that has parameters worth moving while it plays names them in a static `parameters` list and
+ * returns their `AudioParam`s from {@link build} in the same order. An "effect param" is one of those — a
+ * live `AudioParam` of an insert — which is not the same thing as a sopra parameter (the named game value
+ * of `SopraEngine.setParameter`).
  */
 export class AbstractAudioEffect {
     /**
      * Construct the live WebAudio nodes for this effect.
      * @param {BaseAudioContext} ctx
-     * @returns {{input: AudioNode, output: AudioNode}}
+     * @returns {BuiltAudioEffect}
      */
-    build(ctx: BaseAudioContext): {
-        input: AudioNode;
-        output: AudioNode;
-    };
+    build(ctx: BaseAudioContext): BuiltAudioEffect;
     /**
      * @readonly
      * @type {boolean}
      */
     readonly isAudioEffect: boolean;
 }
+export namespace AbstractAudioEffect {
+    let parameters: string[];
+}
+/**
+ * What {@link AbstractAudioEffectbuild } returns: the live sub-graph, as the two nodes it is spliced in by,
+ * and the parameters that can be moved while it plays.
+ *
+ * `params` holds the live {@link AudioParam } of each of the class's {@link AbstractAudioEffect.parameters },
+ * in that order. Omitted by an effect that declares none.
+ */
+export type BuiltAudioEffect = {
+    input: AudioNode;
+    output: AudioNode;
+    params?: AudioParam[];
+};
 //# sourceMappingURL=AbstractAudioEffect.d.ts.map

package/src/engine/sound/sopra/definition/effect/AbstractAudioEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractAudioEffect.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/effect/AbstractAudioEffect.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH;IAEI;;;;OAIG;IACH,WAHW,gBAAgB,GACd;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAC,CAIjD;IAGL;;;OAGG;IACH,wBAFU,OAAO,CAE0B;CAN1C"}
+{"version":3,"file":"AbstractAudioEffect.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/effect/AbstractAudioEffect.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;GAcG;AACH;IAEI;;;;OAIG;IACH,WAHW,gBAAgB,GACd,gBAAgB,CAI5B;IAcL;;;OAGG;IACH,wBAFU,OAAO,CAE0B;CAjB1C;;oBASS,MAAM,EAAE;;;;;;;;;+BArCL;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CAAC"}

package/src/engine/sound/sopra/definition/effect/AbstractAudioEffect.js

@@ -1,22 +1,51 @@
 /**
- * Base class for serializable bus insert effects.
+ * What {@link AbstractAudioEffect#build} returns: the live sub-graph, as the two nodes it is spliced in by,
+ * and the parameters that can be moved while it plays.
  *
- * An effect is a DEFINITION; {@link build} turns it into a live WebAudio sub-graph. The returned
- * `{ input, output }` lets the {@link BusGraph} splice the effect into a bus chain
- * (`input → effect → output`); for single-node effects `input === output`.
+ * `params` holds the live {@link AudioParam} of each of the class's {@link AbstractAudioEffect.parameters},
+ * in that order. Omitted by an effect that declares none.
+ *
+ * @typedef {{input: AudioNode, output: AudioNode, params?: AudioParam[]}} BuiltAudioEffect
+ */
+
+/**
+ * Base class for serializable insert effects — on a bus ({@link BusDefinition.effects}) or on an event
+ * ({@link EventDescription.effects}).
+ *
+ * An effect is a DEFINITION; {@link build} turns it into a live WebAudio sub-graph, once per bus or once per
+ * playing instance. The returned `{ input, output }` lets an {@link EffectChain} splice the effect in
+ * (`input → effect → output`); for single-node effects `input === output`. The definition is never touched
+ * at runtime: a parameter moved on a built effect moves that one copy (see `SopraEngine.setBusEffectParam`,
+ * `EventInstance.setEffectParam`).
+ *
+ * A subclass that has parameters worth moving while it plays names them in a static `parameters` list and
+ * returns their `AudioParam`s from {@link build} in the same order. An "effect param" is one of those — a
+ * live `AudioParam` of an insert — which is not the same thing as a sopra parameter (the named game value
+ * of `SopraEngine.setParameter`).
  */
 export class AbstractAudioEffect {
 
     /**
      * Construct the live WebAudio nodes for this effect.
      * @param {BaseAudioContext} ctx
-     * @returns {{input: AudioNode, output: AudioNode}}
+     * @returns {BuiltAudioEffect}
      */
     build(ctx) {
         throw new Error('Implementation must override build()');
     }
 }
 
+/**
+ * The names of the parameters this class's built effect can move while it plays, in the order
+ * {@link AbstractAudioEffect#build} returns their `AudioParam`s. Each is the name of the definition field
+ * it starts from, so the field that authors a value and the name that moves it are one word. Declared
+ * once per CLASS, so a built effect carries no names of its own. Empty: nothing to move — which is also
+ * what a subclass written before parameters existed inherits.
+ * @readonly
+ * @type {string[]}
+ */
+AbstractAudioEffect.parameters = [];
+
 /**
  * @readonly
  * @type {boolean}

package/src/engine/sound/sopra/definition/effect/CompressorEffect.d.ts

@@ -1,6 +1,9 @@
 /**
- * Dynamics compressor bus insert, backed by a {@link DynamicsCompressorNode}.
- * NOTE: this is a per-bus insert; the engine's master compressor (in SoundEngine) is separate
+ * @typedef {import("./AbstractAudioEffect.js").BuiltAudioEffect} BuiltAudioEffect
+ */
+/**
+ * Dynamics compressor insert (on a bus or an event), backed by a {@link DynamicsCompressorNode}.
+ * NOTE: this is a per-bus or per-instance insert; the engine's master compressor (in SoundEngine) is separate
  * master-glue and is not duplicated here.
  */
 export class CompressorEffect extends AbstractAudioEffect {
@@ -65,6 +68,8 @@ export class CompressorEffect extends AbstractAudioEffect {
 }
 export namespace CompressorEffect {
     let typeName: string;
+    let parameters: string[];
 }
+export type BuiltAudioEffect = import("./AbstractAudioEffect.js").BuiltAudioEffect;
 import { AbstractAudioEffect } from "./AbstractAudioEffect.js";
 //# sourceMappingURL=CompressorEffect.d.ts.map

package/src/engine/sound/sopra/definition/effect/CompressorEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompressorEffect.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/effect/CompressorEffect.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IA+BI;;;;OAIG;IACH,0DAHW;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,IAAI,CAAC,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,MAAM,CAAC,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAA;KAAC,GAC/E,gBAAgB,CAY5B;IA5CD;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;OAEG;IACH,OAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,QAFU,MAAM,CAED;IAEf;;;OAGG;IACH,SAFU,MAAM,CAED;IAmCf;;;;OAIG;IACH,cAHW,gBAAgB,GACd,OAAO,CAQnB;IAED,eAQC;IAED,0BAEC;IAED;;;;;;MAQC;IAED;;;;;;aAMC;CACJ;;;;oCAnHmC,0BAA0B"}
+{"version":3,"file":"CompressorEffect.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/effect/CompressorEffect.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;GAIG;AACH;IA+BI;;;;OAIG;IACH,0DAHW;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,IAAI,CAAC,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,MAAM,CAAC,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAA;KAAC,GAC/E,gBAAgB,CAY5B;IA5CD;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;OAEG;IACH,OAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,QAFU,MAAM,CAED;IAEf;;;OAGG;IACH,SAFU,MAAM,CAED;IAuCf;;;;OAIG;IACH,cAHW,gBAAgB,GACd,OAAO,CAQnB;IAED,eAUC;IAED,0BAEC;IAED;;;;;;MAQC;IAED;;;;;;aAMC;CACJ;;;oBAOS,MAAM,EAAE;;+BAjIL,OAAO,0BAA0B,EAAE,gBAAgB;oCAH5B,0BAA0B"}

package/src/engine/sound/sopra/definition/effect/CompressorEffect.js

@@ -1,120 +1,137 @@
-import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
-import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
-import { AbstractAudioEffect } from "./AbstractAudioEffect.js";
-
-/**
- * Dynamics compressor bus insert, backed by a {@link DynamicsCompressorNode}.
- * NOTE: this is a per-bus insert; the engine's master compressor (in SoundEngine) is separate
- * master-glue and is not duplicated here.
- */
-export class CompressorEffect extends AbstractAudioEffect {
-
-    /**
-     * dB.
-     * @type {number}
-     */
-    threshold = -24;
-
-    /**
-     * dB.
-     * @type {number}
-     */
-    knee = 30;
-
-    /**
-     * @type {number}
-     */
-    ratio = 12;
-
-    /**
-     * Seconds.
-     * @type {number}
-     */
-    attack = 0.003;
-
-    /**
-     * Seconds.
-     * @type {number}
-     */
-    release = 0.25;
-
-    /**
-     *
-     * @param {{threshold?:number, knee?:number, ratio?:number, attack?:number, release?:number}} [options]
-     * @returns {CompressorEffect}
-     */
-    static from({ threshold = -24, knee = 30, ratio = 12, attack = 0.003, release = 0.25 } = {}) {
-        const r = new CompressorEffect();
-
-        r.threshold = threshold;
-        r.knee = knee;
-        r.ratio = ratio;
-        r.attack = attack;
-        r.release = release;
-
-        return r;
-    }
-
-    /**
-     * @param {BaseAudioContext} ctx
-     * @returns {{input: AudioNode, output: AudioNode}}
-     */
-    build(ctx) {
-        const node = ctx.createDynamicsCompressor();
-
-        node.threshold.value = this.threshold;
-        node.knee.value = this.knee;
-        node.ratio.value = this.ratio;
-        node.attack.value = this.attack;
-        node.release.value = this.release;
-
-        return { input: node, output: node };
-    }
-
-    /**
-     *
-     * @param {CompressorEffect} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        return this.threshold === other.threshold
-            && this.knee === other.knee
-            && this.ratio === other.ratio
-            && this.attack === other.attack
-            && this.release === other.release;
-    }
-
-    hash() {
-        return combine_hash(
-            computeHashFloat(this.threshold),
-            computeHashFloat(this.knee),
-            computeHashFloat(this.ratio),
-            computeHashFloat(this.attack),
-            computeHashFloat(this.release)
-        );
-    }
-
-    clone() {
-        return CompressorEffect.from(this);
-    }
-
-    toJSON() {
-        return {
-            threshold: this.threshold,
-            knee: this.knee,
-            ratio: this.ratio,
-            attack: this.attack,
-            release: this.release
-        };
-    }
-
-    fromJSON({ threshold = -24, knee = 30, ratio = 12, attack = 0.003, release = 0.25 }) {
-        this.threshold = threshold;
-        this.knee = knee;
-        this.ratio = ratio;
-        this.attack = attack;
-        this.release = release;
-    }
-}
-
-CompressorEffect.typeName = "SopraCompressorEffect";
+import { hash_mix3 } from "../../../../../core/math/hash/hash_mix3.js";
+import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
+import { AbstractAudioEffect } from "./AbstractAudioEffect.js";
+
+/**
+ * @typedef {import("./AbstractAudioEffect.js").BuiltAudioEffect} BuiltAudioEffect
+ */
+
+/**
+ * Dynamics compressor insert (on a bus or an event), backed by a {@link DynamicsCompressorNode}.
+ * NOTE: this is a per-bus or per-instance insert; the engine's master compressor (in SoundEngine) is separate
+ * master-glue and is not duplicated here.
+ */
+export class CompressorEffect extends AbstractAudioEffect {
+
+    /**
+     * dB.
+     * @type {number}
+     */
+    threshold = -24;
+
+    /**
+     * dB.
+     * @type {number}
+     */
+    knee = 30;
+
+    /**
+     * @type {number}
+     */
+    ratio = 12;
+
+    /**
+     * Seconds.
+     * @type {number}
+     */
+    attack = 0.003;
+
+    /**
+     * Seconds.
+     * @type {number}
+     */
+    release = 0.25;
+
+    /**
+     *
+     * @param {{threshold?:number, knee?:number, ratio?:number, attack?:number, release?:number}} [options]
+     * @returns {CompressorEffect}
+     */
+    static from({ threshold = -24, knee = 30, ratio = 12, attack = 0.003, release = 0.25 } = {}) {
+        const r = new CompressorEffect();
+
+        r.threshold = threshold;
+        r.knee = knee;
+        r.ratio = ratio;
+        r.attack = attack;
+        r.release = release;
+
+        return r;
+    }
+
+    /**
+     * @param {BaseAudioContext} ctx
+     * @returns {BuiltAudioEffect}
+     */
+    build(ctx) {
+        const node = ctx.createDynamicsCompressor();
+
+        node.threshold.value = this.threshold;
+        node.knee.value = this.knee;
+        node.ratio.value = this.ratio;
+        node.attack.value = this.attack;
+        node.release.value = this.release;
+
+        return {
+            input: node,
+            output: node,
+            params: [node.threshold, node.knee, node.ratio, node.attack, node.release]
+        };
+    }
+
+    /**
+     *
+     * @param {CompressorEffect} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.threshold === other.threshold
+            && this.knee === other.knee
+            && this.ratio === other.ratio
+            && this.attack === other.attack
+            && this.release === other.release;
+    }
+
+    hash() {
+        return hash_mix3(
+            hash_mix3(
+                computeHashFloat(this.threshold),
+                computeHashFloat(this.knee),
+                computeHashFloat(this.ratio)
+            ),
+            computeHashFloat(this.attack),
+            computeHashFloat(this.release)
+        );
+    }
+
+    clone() {
+        return CompressorEffect.from(this);
+    }
+
+    toJSON() {
+        return {
+            threshold: this.threshold,
+            knee: this.knee,
+            ratio: this.ratio,
+            attack: this.attack,
+            release: this.release
+        };
+    }
+
+    fromJSON({ threshold = -24, knee = 30, ratio = 12, attack = 0.003, release = 0.25 }) {
+        this.threshold = threshold;
+        this.knee = knee;
+        this.ratio = ratio;
+        this.attack = attack;
+        this.release = release;
+    }
+}
+
+CompressorEffect.typeName = "SopraCompressorEffect";
+
+/**
+ * What a built compressor can move while it plays.
+ * @readonly
+ * @type {string[]}
+ */
+CompressorEffect.parameters = ['threshold', 'knee', 'ratio', 'attack', 'release'];

package/src/engine/sound/sopra/definition/effect/EqEffect.d.ts

@@ -13,7 +13,7 @@ export namespace EqFilterType {
     let Allpass: number;
 }
 /**
- * Equalizer / filter bus insert, backed by a {@link BiquadFilterNode}.
+ * Equalizer / filter insert (on a bus or an event), backed by a {@link BiquadFilterNode}.
  */
 export class EqEffect extends AbstractAudioEffect {
     /**
@@ -69,6 +69,8 @@ export class EqEffect extends AbstractAudioEffect {
 }
 export namespace EqEffect {
     let typeName: string;
+    let parameters: string[];
 }
+export type BuiltAudioEffect = import("./AbstractAudioEffect.js").BuiltAudioEffect;
 import { AbstractAudioEffect } from "./AbstractAudioEffect.js";
 //# sourceMappingURL=EqEffect.d.ts.map

package/src/engine/sound/sopra/definition/effect/EqEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EqEffect.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/effect/EqEffect.js"],"names":[],"mappings":";;;2BAMU,MAAM;;;;;;;;;;;AAoBhB;;GAEG;AACH;IAyBI;;;;OAIG;IACH,mDAHW;QAAC,UAAU,CAAC,EAAC,YAAY,GAAC,MAAM,CAAC;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,CAAC,CAAC,EAAC,MAAM,CAAC;QAAC,MAAM,CAAC,EAAC,MAAM,CAAA;KAAC,GAC7E,QAAQ,CAWpB;IArCD;;OAEG;IACH,YAFU,YAAY,GAAC,MAAM,CAEK;IAElC;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,GAFU,MAAM,CAEV;IAEN;;;OAGG;IACH,QAFU,MAAM,CAEL;IAiCX;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAOnB;IAED,eAOC;IAED,kBAEC;IAED;;;;;MAOC;IAED;;;;;aAKC;CACJ;;;;oCA3HmC,0BAA0B"}
+{"version":3,"file":"EqEffect.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/effect/EqEffect.js"],"names":[],"mappings":";;;2BAWU,MAAM;;;;;;;;;;;AAoBhB;;GAEG;AACH;IAyBI;;;;OAIG;IACH,mDAHW;QAAC,UAAU,CAAC,EAAC,YAAY,GAAC,MAAM,CAAC;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,CAAC,CAAC,EAAC,MAAM,CAAC;QAAC,MAAM,CAAC,EAAC,MAAM,CAAA;KAAC,GAC7E,QAAQ,CAWpB;IArCD;;OAEG;IACH,YAFU,YAAY,GAAC,MAAM,CAEK;IAElC;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,GAFU,MAAM,CAEV;IAEN;;;OAGG;IACH,QAFU,MAAM,CAEL;IAqCX;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAOnB;IAED,eASC;IAED,kBAEC;IAED;;;;;MAOC;IAED;;;;;aAKC;CACJ;;;oBAOS,MAAM,EAAE;;+BAzIL,OAAO,0BAA0B,EAAE,gBAAgB;oCAH5B,0BAA0B"}