@woosh/meep-engine 3.21.0 → 3.22.0

package/src/engine/scene/transitionToScene.d.ts

@@ -7,12 +7,18 @@
  * answering E22). What covers the load is the loading screen this returns, on both backends; if the
  * legacy path wants its layers hidden underneath that too, it is the one that owns them.
  *
- * @param {Task[]} [tasks]
- * @param {Scene} scene
- * @param {Engine} engine
- * @param {string} [name]
+ * @param {Object} options
+ * @param {Task[]} [options.tasks]
+ * @param {Scene} options.scene
+ * @param {Engine} options.engine
+ * @param {string} [options.name]
  * @return {Promise}
  */
-export function transitionToScene({ tasks, scene, engine, name }?: Task[]): Promise<any>;
+export function transitionToScene({ tasks, scene, engine, name }: {
+    tasks?: Task[];
+    scene: Scene;
+    engine: Engine;
+    name?: string;
+}): Promise<any>;
 import Task from "../../core/process/task/Task.js";
 //# sourceMappingURL=transitionToScene.d.ts.map

package/src/engine/scene/transitionToScene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitionToScene.d.ts","sourceRoot":"","sources":["../../../../src/engine/scene/transitionToScene.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AACH,mEANW,IAAI,EAAE,gBAiGhB;iBArHgB,iCAAiC"}
+{"version":3,"file":"transitionToScene.d.ts","sourceRoot":"","sources":["../../../../src/engine/scene/transitionToScene.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;GAeG;AACH;IAN4B,KAAK,GAAtB,IAAI,EAAE;IACS,KAAK;IACJ,MAAM;IACL,IAAI,GAArB,MAAM;iBA8FhB;iBAtHgB,iCAAiC"}

package/src/engine/scene/transitionToScene.js

@@ -21,10 +21,11 @@ import { createTaskWaitForMeshesToLoad } from "../graphics/ecs/mesh/createTaskWa
  * answering E22). What covers the load is the loading screen this returns, on both backends; if the
  * legacy path wants its layers hidden underneath that too, it is the one that owns them.
  *
- * @param {Task[]} [tasks]
- * @param {Scene} scene
- * @param {Engine} engine
- * @param {string} [name]
+ * @param {Object} options
+ * @param {Task[]} [options.tasks]
+ * @param {Scene} options.scene
+ * @param {Engine} options.engine
+ * @param {string} [options.name]
  * @return {Promise}
  */
 export function transitionToScene({

package/src/engine/simulation/Ticker.d.ts

@@ -54,9 +54,12 @@ declare class Ticker {
     get is_paused(): boolean;
     /**
      *
-     * @param {number} [maxTimeout]
+     * @param {Object} [options]
+     * @param {number} [options.maxTimeout]
      */
-    start({ maxTimeout }?: number): void;
+    start({ maxTimeout }?: {
+        maxTimeout?: number;
+    }): void;
     pause(): void;
     resume(): void;
     stop(): void;

package/src/engine/simulation/Ticker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ticker.d.ts","sourceRoot":"","sources":["../../../../src/engine/simulation/Ticker.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;GAcG;AACH;IACI;;;OAGG;IACH,gBAFU,KAAK,CAEK;IAEpB;;;;;;;;;;;;OAYG;IACH,uBAFU,OAAO,CAEY;IAkC7B;;;;OAIG;IACH,qBAAsB;IAUtB;;;;OAIG;IACH,yBAEC;IAED;;;;OAIG;IACH,yBAEC;IAuGD;;;OAGG;IACH,uBAFW,MAAM,QAiFhB;IAED,cAWC;IAED,eAaC;IAED,aAYC;;CACJ;kBA3UiB,aAAa"}
+{"version":3,"file":"Ticker.d.ts","sourceRoot":"","sources":["../../../../src/engine/simulation/Ticker.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;GAcG;AACH;IACI;;;OAGG;IACH,gBAFU,KAAK,CAEK;IAEpB;;;;;;;;;;;;OAYG;IACH,uBAFU,OAAO,CAEY;IAkC7B;;;;OAIG;IACH,qBAAsB;IAUtB;;;;OAIG;IACH,yBAEC;IAED;;;;OAIG;IACH,yBAEC;IAuGD;;;;OAIG;IACH;QAF4B,UAAU,GAA3B,MAAM;aAiFhB;IAED,cAWC;IAED,eAaC;IAED,aAYC;;CACJ;kBA5UiB,aAAa"}

package/src/engine/simulation/Ticker.js

@@ -207,7 +207,8 @@ class Ticker {
 
     /**
      *
-     * @param {number} [maxTimeout]
+     * @param {Object} [options]
+     * @param {number} [options.maxTimeout]
      */
     start({ maxTimeout = 100 } = {}) {
         assert.isNumber(maxTimeout, 'maxTimeout');

package/src/engine/sound/SoundEngine.d.ts

@@ -1,4 +1,8 @@
 export default SoundEngine;
+export type BufferProvider = import("./sopra/asset/BufferProvider.js").BufferProvider;
+/**
+ * @typedef {import("./sopra/asset/BufferProvider.js").BufferProvider} BufferProvider
+ */
 /**
  *
  * @author Alex Goldring

package/src/engine/sound/SoundEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/sound/SoundEngine.js"],"names":[],"mappings":";AAEA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,OAFU,WAAW,GAAC,IAAI,CAEb;IAkBO,sBAWd;IAUF,sBAA2B;IA4B/B;;OAEG;IACH,0BAEC;IA5BD;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAEC;IASD;;;;;;;;;;OAUG;IACH,6CAFa,WAAW,CAQvB;IAED;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,iBAFa,QAAQ,IAAI,CAAC,CAMzB;IAED;;;OAGG;IACH,SAFa,QAAQ,GAAG,CAAC,CAWxB;CACJ;4BA3I2B,wBAAwB"}
+{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/sound/SoundEngine.js"],"names":[],"mappings":";6BAGa,OAAO,iCAAiC,EAAE,cAAc;AADrE;;GAEG;AAEH;;;;GAIG;AACH;IACI;;;;OAIG;IACH,OAFU,WAAW,GAAC,IAAI,CAEb;IAkBO,sBAWd;IAUF,sBAA2B;IA4B/B;;OAEG;IACH,0BAEC;IA5BD;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAEC;IASD;;;;;;;;;;OAUG;IACH,4BAHW,cAAc,GACZ,WAAW,CAQvB;IAED;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,iBAFa,QAAQ,IAAI,CAAC,CAMzB;IAED;;;OAGG;IACH,SAFa,QAAQ,GAAG,CAAC,CAWxB;CACJ;4BA/I2B,wBAAwB"}

package/src/engine/sound/SoundEngine.js

@@ -1,5 +1,9 @@
 import { SopraEngine } from "./sopra/SopraEngine.js";
 
+/**
+ * @typedef {import("./sopra/asset/BufferProvider.js").BufferProvider} BufferProvider
+ */
+
 /**
  *
  * @author Alex Goldring

package/src/engine/sound/material/concrete/json/deserializeSoundMaterialFromJSON.d.ts

@@ -1,8 +1,12 @@
 /**
  *
- * @param {string} type
- * @param {*} data
+ * @param {Object} options
+ * @param {string} options.type
+ * @param {*} options.data
  * @return {AbstractSoundMaterialDefinition}
  */
-export function deserializeSoundMaterialFromJSON({ type, data }: string): AbstractSoundMaterialDefinition;
+export function deserializeSoundMaterialFromJSON({ type, data }: {
+    type: string;
+    data: any;
+}): AbstractSoundMaterialDefinition;
 //# sourceMappingURL=deserializeSoundMaterialFromJSON.d.ts.map

package/src/engine/sound/material/concrete/json/deserializeSoundMaterialFromJSON.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deserializeSoundMaterialFromJSON.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/material/concrete/json/deserializeSoundMaterialFromJSON.js"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,iEAJW,MAAM,mCAuBhB"}
+{"version":3,"file":"deserializeSoundMaterialFromJSON.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/material/concrete/json/deserializeSoundMaterialFromJSON.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH;IAJ2B,IAAI,EAApB,MAAM;IACK,IAAI;oCAsBzB"}

package/src/engine/sound/material/concrete/json/deserializeSoundMaterialFromJSON.js

@@ -5,8 +5,9 @@ import { SoundMaterialComposition } from "../SoundMaterialComposition.js";
 
 /**
  *
- * @param {string} type
- * @param {*} data
+ * @param {Object} options
+ * @param {string} options.type
+ * @param {*} options.data
  * @return {AbstractSoundMaterialDefinition}
  */
 export function deserializeSoundMaterialFromJSON({ type, data }) {

package/src/engine/sound/simulation/ecs/AcousticSimulationSystem.d.ts

@@ -12,6 +12,16 @@ export class AcousticSimulationSystem extends System<any> {
      * @param {AcousticSimulator} simulator the shared simulation engine
      */
     constructor(simulator: AcousticSimulator);
+    /**
+     * Kept so {@link link} can reach the dataset: the occluder pose is announced there now rather
+     * than through the transform's own signals.
+     * @type {EntityManager|null}
+     */
+    entityManager: EntityManager | null;
+    /**
+     * @param {EntityManager} entityManager
+     */
+    startup(entityManager: EntityManager): Promise<void>;
     dependencies: (typeof Transform64 | typeof Collider | typeof AcousticBody)[];
     /**
      * Per-entity records: { handle, transform, onMove }.

package/src/engine/sound/simulation/ecs/AcousticSimulationSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcousticSimulationSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/ecs/AcousticSimulationSystem.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH;IAwBI;;OAEG;IACH,0CASC;IApBD,6EAAqD;IAErD;;;OAGG;IACH,MAFU,MAAM,EAAE,CAER;IASN;;OAEG;IACH,6BAA0B;IAI9B;;;;;OAKG;IACH,WALW,YAAY,YACZ,QAAQ,aACR,WAAW,UACX,MAAM,QAahB;IAED;;;;;OAKG;IACH,aALW,YAAY,YACZ,QAAQ,aACR,WAAW,UACX,MAAM,QAgBhB;CACJ;uBA7FsB,wBAAwB;4BACnB,uCAAuC;yBAC1C,kCAAkC;6BAC9B,mBAAmB"}
+{"version":3,"file":"AcousticSimulationSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/ecs/AcousticSimulationSystem.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH;IAwBI;;OAEG;IACH,0CASC;IAlCD;;;;OAIG;IACH,eAFU,gBAAc,IAAI,CAEP;IAErB;;OAEG;IACH,qDAEC;IAED,6EAAqD;IAErD;;;OAGG;IACH,MAFU,MAAM,EAAE,CAER;IASN;;OAEG;IACH,6BAA0B;IAI9B;;;;;OAKG;IACH,WALW,YAAY,YACZ,QAAQ,aACR,WAAW,UACX,MAAM,QAahB;IAED;;;;;OAKG;IACH,aALW,YAAY,YACZ,QAAQ,aACR,WAAW,UACX,MAAM,QAgBhB;CACJ;uBA7FsB,wBAAwB;4BACnB,uCAAuC;yBAC1C,kCAAkC;6BAC9B,mBAAmB"}

package/src/engine/sound/sopra/SopraEngine.d.ts

@@ -225,6 +225,11 @@ export class SopraEngine {
     __onInstanceFinished(instance: EventInstance): void;
     #private;
 }
+export type Vector3 = import("../../../core/geom/Vector3.js").Vector3;
+export type AnimationCurve = import("../../animation/curve/AnimationCurve.js").AnimationCurve;
+export type BufferProvider = import("./asset/BufferProvider.js").BufferProvider;
+export type DuckingRule = import("./definition/DuckingRule.js").DuckingRule;
+export type EventDescription = import("./definition/EventDescription.js").EventDescription;
 import { ParameterStore } from "./runtime/ParameterStore.js";
 import { SopraPlaybackContext } from "./runtime/SopraPlaybackContext.js";
 import { VoiceManager } from "./runtime/VoiceManager.js";

package/src/engine/sound/sopra/SopraEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SopraEngine.d.ts","sourceRoot":"","sources":["../../../../../src/engine/sound/sopra/SopraEngine.js"],"names":[],"mappings":";;;;8BAcU,MAAM;;;;;;;AAahB;;;;;;;GAOG;AACH;IAsFI;;;OAGG;IACH,uBAFa,aAAa,EAAE,CAS3B;IA3DD;;;;OAIG;IACH,0BAJW,gBAAgB,mBAChB,SAAS,kCA4BnB;IAlED;;OAEG;IACH,YAFU,cAAc,CAEU;IAElC;;;;OAIG;IACH,wBAFU,oBAAoB,CAEsB;IAEpD;;;OAGG;IACH,cAFU,YAAY,CAEY;IAElC;;;;OAIG;IACH,kBAFU,UAAQ,IAAI,CAEE;IAuBpB;;OAEG;IACH,cAFU,gBAAgB,CAEM;IAEhC;;OAEG;IACH,aAFU,SAAS,CAEe;IAElC;;OAEG;IACH,+BAAoC;IAEpC;;OAEG;IACH,UAFU,QAAQ,CAEyC;IAI/D;;OAEG;IACH,0BAEC;IAED;;;;OAIG;IACH,iCAEC;IAeD;;;OAGG;IACH,yBAFW,aAAa,EAAE,QAKzB;IAED;;;;;OAKG;IACH,wDAHW;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,IAAI,CAAC,EAAC,MAAM,CAAC;QAAC,eAAe,CAAC,EAAC,oBAAoB,CAAA;KAAC,GAC5H,aAAa,CAOzB;IAED;;;;;OAKG;IACH,mDAHW;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,IAAI,CAAC,EAAC,MAAM,CAAC;QAAC,eAAe,CAAC,EAAC,oBAAoB,CAAA;KAAC,GAC5H,aAAa,CAuBzB;IAED;;;;;;OAMG;IACH,qDAHW;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,WAAW,CAAC,EAAC,MAAM,CAAA;KAAC,GACrD,aAAa,CAIzB;IAED;;OAEG;IACH,eAFW,aAAa,QAIvB;IAED;;;;;;;OAOG;IACH,uBALW,aAAa,GAAC,IAAI,2CAElB;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,QAAQ,CAAC,EAAC,MAAM,CAAA;KAAC,GAClD,aAAa,GAAC,IAAI,CAmB9B;IAED;;;OAGG;IACH,mBAHW,MAAM,SACN,MAAM,QAIhB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CAI5B;IAED;;;OAGG;IACH,qCAEC;IAED;;;;OAIG;IACH,sBAHW,MAAM,iBACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,kBACG,MAAM,gBAIzB;IAED;;;;;OAKG;IACH,+BAJW,MAAM,SACN,MAAM,+BAKhB;IAED;;;OAGG;IACH,oBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;;OAKG;IACH,wBAHW,aAAa,iBACb;QAAC,QAAQ,CAAC,EAAC,MAAM,CAAA;KAAC,QAe5B;IAED;;;;;OAKG;IACH,oBAJW,MAAM,UACN,MAAM,EAAE,GACN,aAAa,CAUzB;IAED;;;OAGG;IACH,aAFW,MAAM,QAahB;IAED;;;;OAIG;IACH,mCAEC;IAED;;OAEG;IACH,qBAWC;IAwCD;;OAEG;IACH,kCAEC;IAED;;;;OAIG;IACH,+BAFW,aAAa,QAKvB;;CACJ;+BAxa8B,6BAA6B;qCACvB,mCAAmC;6BAC3C,2BAA2B;yBANd,uBAAuB;8BACnC,+BAA+B;8BAE/B,4BAA4B;8BAD5B,+BAA+B"}
+{"version":3,"file":"SopraEngine.d.ts","sourceRoot":"","sources":["../../../../../src/engine/sound/sopra/SopraEngine.js"],"names":[],"mappings":"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"}

package/src/engine/sound/sopra/SopraEngine.js

@@ -9,6 +9,14 @@ import { ParameterStore } from "./runtime/ParameterStore.js";
 import { SopraPlaybackContext } from "./runtime/SopraPlaybackContext.js";
 import { VoiceManager } from "./runtime/VoiceManager.js";
 
+/**
+ * @typedef {import("../../../core/geom/Vector3.js").Vector3} Vector3
+ * @typedef {import("../../animation/curve/AnimationCurve.js").AnimationCurve} AnimationCurve
+ * @typedef {import("./asset/BufferProvider.js").BufferProvider} BufferProvider
+ * @typedef {import("./definition/DuckingRule.js").DuckingRule} DuckingRule
+ * @typedef {import("./definition/EventDescription.js").EventDescription} EventDescription
+ */
+
 /**
  * Default top-level bus ids, kept identical to the channel names the legacy sound components used, so
  * the settings UI and any converted `channel` string keep resolving.

package/src/engine/sound/sopra/definition/BusDefinition.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("./effect/AbstractAudioEffect.js").AbstractAudioEffect} AbstractAudioEffect
+ */
 /**
  * A node in the mixer bus tree. The {@link BusGraph} instantiates a set of these into chained
  * GainNodes: a bus routes `input → effect[0] → … → effect[n] → output`, and `output` connects into
@@ -80,4 +83,5 @@ export class BusDefinition {
 export namespace BusDefinition {
     let typeName: string;
 }
+export type AbstractAudioEffect = import("./effect/AbstractAudioEffect.js").AbstractAudioEffect;
 //# sourceMappingURL=BusDefinition.d.ts.map

package/src/engine/sound/sopra/definition/BusDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BusDefinition.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/definition/BusDefinition.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IAiCI;;;;;OAKG;IACH,gBAJW,MAAM,yCACN;QAAC,QAAQ,CAAC,EAAC,MAAM,CAAC;QAAC,MAAM,CAAC,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,qBAAqB,CAAC;QAAC,KAAK,CAAC,EAAC;YAAC,WAAW,EAAC,MAAM,CAAC;YAAA,OAAO,EAAC,MAAM,CAAA;SAAC,EAAE,CAAA;KAAC,GAC9G,aAAa,CAYzB;IA/CD;;;OAGG;IACH,IAFU,MAAM,CAER;IAER;;;;OAIG;IACH,UAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,SAFU,qBAAqB,CAElB;IAEb;;;OAGG;IACH,OAFU;QAAC,WAAW,EAAC,MAAM,CAAC;QAAC,OAAO,EAAC,MAAM,CAAA;KAAC,EAAE,CAErC;IAoBX;;;;OAIG;IACH,cAHW,aAAa,GACX,OAAO,CA0BnB;IAED,eAgBC;IAED,uBAUC;IAED;;;;;;;;;;;;MAQC;IAED;;;;;;aAMC;CACJ"}
+{"version":3,"file":"BusDefinition.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/definition/BusDefinition.js"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;;GAIG;AACH;IAiCI;;;;;OAKG;IACH,gBAJW,MAAM,yCACN;QAAC,QAAQ,CAAC,EAAC,MAAM,CAAC;QAAC,MAAM,CAAC,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,mBAAmB,EAAE,CAAC;QAAC,KAAK,CAAC,EAAC;YAAC,WAAW,EAAC,MAAM,CAAC;YAAA,OAAO,EAAC,MAAM,CAAA;SAAC,EAAE,CAAA;KAAC,GAC9G,aAAa,CAYzB;IA/CD;;;OAGG;IACH,IAFU,MAAM,CAER;IAER;;;;OAIG;IACH,UAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,SAFU,mBAAmB,EAAE,CAElB;IAEb;;;OAGG;IACH,OAFU;QAAC,WAAW,EAAC,MAAM,CAAC;QAAC,OAAO,EAAC,MAAM,CAAA;KAAC,EAAE,CAErC;IAoBX;;;;OAIG;IACH,cAHW,aAAa,GACX,OAAO,CA0BnB;IAED,eAgBC;IAED,uBAUC;IAED;;;;;;;;;;;;MAQC;IAED;;;;;;aAMC;CACJ;;;;kCAzIY,OAAO,iCAAiC,EAAE,mBAAmB"}

package/src/engine/sound/sopra/definition/BusDefinition.js

@@ -3,6 +3,10 @@ import { computeHashFloat } from "../../../../core/primitives/numbers/computeHas
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 import { deserializeAudioEffectFromJSON, serializeAudioEffectToJSON } from "../serialization/sopraJSON.js";
 
+/**
+ * @typedef {import("./effect/AbstractAudioEffect.js").AbstractAudioEffect} AbstractAudioEffect
+ */
+
 /**
  * A node in the mixer bus tree. The {@link BusGraph} instantiates a set of these into chained
  * GainNodes: a bus routes `input → effect[0] → … → effect[n] → output`, and `output` connects into

package/src/engine/sound/sopra/definition/EventDescription.d.ts

@@ -129,6 +129,7 @@ export class EventDescription {
 export namespace EventDescription {
     let typeName: string;
 }
+export type AbstractAudioClip = import("./clip/AbstractAudioClip.js").AbstractAudioClip;
 import { SopraPanningModel } from "./SopraPanningModel.js";
 import { AnimationCurve } from "../../../animation/curve/AnimationCurve.js";
 import { VoiceStealMode } from "./VoiceStealMode.js";

package/src/engine/sound/sopra/definition/EventDescription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventDescription.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/definition/EventDescription.js"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH;IA+EI;;;;;;OAMG;IACH,mBALW,MAAM,qKAEN,QAAQ,gBAAgB,CAAC,GACvB,gBAAgB,CAgC5B;IAlHD;;;OAGG;IACH,OAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,4BAAkC;IAElC;;;OAGG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,MAFU,OAAO,CAEJ;IAEb;;;OAGG;IACH,cAFU,iBAAiB,GAAC,MAAM,CAEI;IAEtC;;OAEG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,aAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,aAFU,cAAc,CAEW;IAEnC;;;OAGG;IACH,cAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,WAFU,cAAc,GAAC,MAAM,CAEG;IAElC;;;OAGG;IACH,oBAFU,MAAM,CAES;IAyCzB;;;;OAIG;IACH,cAHW,gBAAgB,GACd,OAAO,CAgBnB;IAED;;;;;OAKG;IACH,QAFa,MAAM,CAkBlB;IAED,0BAkBC;IAED;;;;;;;;;;;;;;;;;;;MAgBC;IAED;;;;;;;;;;;;;;aAmCC;CACJ;;;;kCA7PiC,wBAAwB;+BAH3B,4CAA4C;+BAI5C,qBAAqB"}
+{"version":3,"file":"EventDescription.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/definition/EventDescription.js"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH;IA+EI;;;;;;OAMG;IACH,mBALW,MAAM,YACN,iBAAiB,wIACjB,QAAQ,gBAAgB,CAAC,GACvB,gBAAgB,CAgC5B;IAlHD;;;OAGG;IACH,OAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,UAFU,iBAAiB,CAEO;IAElC;;;OAGG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,MAFU,OAAO,CAEJ;IAEb;;;OAGG;IACH,cAFU,iBAAiB,GAAC,MAAM,CAEI;IAEtC;;OAEG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,aAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,aAFU,cAAc,CAEW;IAEnC;;;OAGG;IACH,cAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,WAFU,cAAc,GAAC,MAAM,CAEG;IAElC;;;OAGG;IACH,oBAFU,MAAM,CAES;IAyCzB;;;;OAIG;IACH,cAHW,gBAAgB,GACd,OAAO,CAgBnB;IAED;;;;;OAKG;IACH,QAFa,MAAM,CAkBlB;IAED,0BAkBC;IAED;;;;;;;;;;;;;;;;;;;MAgBC;IAED;;;;;;;;;;;;;;aAmCC;CACJ;;;;gCA7PY,OAAO,6BAA6B,EAAE,iBAAiB;kCAJlC,wBAAwB;+BAH3B,4CAA4C;+BAI5C,qBAAqB"}

package/src/engine/sound/sopra/definition/EventDescription.js

@@ -7,6 +7,10 @@ import { SilenceAudioClip } from "./clip/SilenceAudioClip.js";
 import { SopraPanningModel } from "./SopraPanningModel.js";
 import { VoiceStealMode } from "./VoiceStealMode.js";
 
+/**
+ * @typedef {import("./clip/AbstractAudioClip.js").AbstractAudioClip} AbstractAudioClip
+ */
+
 /**
  * Constant flat-1 attenuation curve = "no attenuation". Used as the default for non-3D events.
  * @returns {AnimationCurve}

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

@@ -1,3 +1,7 @@
+/**
+ * @typedef {import("../../runtime/SopraPlaybackContext.js").SopraPlaybackContext} SopraPlaybackContext
+ * @typedef {import("./SampleAudioClip.js").SampleAudioClip} SampleAudioClip
+ */
 /**
  * Base class for all audio clips.
  *
@@ -90,4 +94,6 @@ export class AbstractAudioClip {
      */
     readonly isAudioClip: boolean;
 }
+export type SopraPlaybackContext = import("../../runtime/SopraPlaybackContext.js").SopraPlaybackContext;
+export type SampleAudioClip = import("./SampleAudioClip.js").SampleAudioClip;
 //# sourceMappingURL=AbstractAudioClip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AbstractAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/AbstractAudioClip.js"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH;IAEI;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,8BAFW,iBAAiB,QAK3B;IAED;;;;;OAKG;IACH,cAHW,iBAAiB,GACf,OAAO,CAKnB;IAED;;;;OAIG;IACH,QAFa,MAAM,CAOlB;IAED;;;;;;;;;;;;;;OAcG;IACH,kBATW;QAAC,UAAU,6BAA4B,MAAM,CAAC;QAAC,QAAQ,uBAAuB;QAAC,YAAY,SAAW,MAAM,KAAE,CAAC,MAAM,GAAC,SAAS,CAAC,CAAA;KAAC,WAIjI,MAAM,eACN,MAAM,WACN,MAAM,GACJ;QAAC,KAAK,EAAE;YAAC,IAAI,kBAAkB;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAIpH;IAED;;;;;;;;OAQG;IACH,yBAHW,iBAAiB,GACf,iBAAiB,CAI7B;IAED;;;;;;OAMG;IACH,SAFa,OAAO,CAInB;IAGL;;;OAGG;IACH,sBAFU,OAAO,CAEsB;CANtC"}
+{"version":3,"file":"AbstractAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/AbstractAudioClip.js"],"names":[],"mappings":"AAGA;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH;IAEI;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,8BAFW,iBAAiB,QAK3B;IAED;;;;;OAKG;IACH,cAHW,iBAAiB,GACf,OAAO,CAKnB;IAED;;;;OAIG;IACH,QAFa,MAAM,CAOlB;IAED;;;;;;;;;;;;;;OAcG;IACH,kBATW;QAAC,UAAU,SAAW,eAAe,KAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,oBAAoB,CAAC;QAAC,YAAY,SAAW,MAAM,KAAE,CAAC,MAAM,GAAC,SAAS,CAAC,CAAA;KAAC,WAIjI,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,CAAA;SAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAIpH;IAED;;;;;;;;OAQG;IACH,yBAHW,eAAe,EAAE,GACf,eAAe,EAAE,CAI7B;IAED;;;;;;OAMG;IACH,SAFa,OAAO,CAInB;IAGL;;;OAGG;IACH,sBAFU,OAAO,CAEsB;CANtC;mCAvGY,OAAO,uCAAuC,EAAE,oBAAoB;8BACpE,OAAO,sBAAsB,EAAE,eAAe"}

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

@@ -1,6 +1,11 @@
 import { combine_hash } from "../../../../../core/collection/array/combine_hash.js";
 import { computeHashFloat } from "../../../../../core/primitives/numbers/computeHashFloat.js";
 
+/**
+ * @typedef {import("../../runtime/SopraPlaybackContext.js").SopraPlaybackContext} SopraPlaybackContext
+ * @typedef {import("./SampleAudioClip.js").SampleAudioClip} SampleAudioClip
+ */
+
 /**
  * Base class for all audio clips.
  *

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

@@ -36,7 +36,7 @@ export class BlendContainerAudioClip extends ContainerAudioClip {
     blends: AnimationCurve[];
     planTimeline(env: any, gainDb?: number, pitchCents?: number, offset?: number): {
         plays: {
-            clip: SampleAudioClip;
+            clip: import("./SampleAudioClip.js").SampleAudioClip;
             offset: number;
             gainDb: number;
             pitchCents: number;

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

@@ -21,6 +21,7 @@ export class ContainerAudioClip extends AbstractAudioClip {
      */
     addChildren(clips: AbstractAudioClip[]): this;
     clearChildren(): void;
+    collectSampleClips(out?: any[]): any[];
     /**
      * Container equality: the inherited gain/pitch (via `super.equals`) plus a same-length,
      * element-wise child comparison. Concrete subclasses override and extend this via

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

@@ -1 +1 @@
-{"version":3,"file":"ContainerAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/ContainerAudioClip.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IAEI;;OAEG;IACH,UAFU,iBAAiB,EAAE,CAEf;IAEd;;;;OAIG;IACH,eAHW,iBAAiB,GACf,IAAI,CAQhB;IAED;;;;OAIG;IACH,mBAHW,iBAAiB,EAAE,GACjB,IAAI,CAQhB;IAED,sBAEC;IA6BD;;;;;;OAMG;IACH,cAHW,kBAAkB,GAChB,OAAO,CAqBnB;CA4BJ;kCA7HiC,wBAAwB"}
+{"version":3,"file":"ContainerAudioClip.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/sound/sopra/definition/clip/ContainerAudioClip.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IAEI;;OAEG;IACH,UAFU,iBAAiB,EAAE,CAEf;IAEd;;;;OAIG;IACH,eAHW,iBAAiB,GACf,IAAI,CAQhB;IAED;;;;OAIG;IACH,mBAHW,iBAAiB,EAAE,GACjB,IAAI,CAQhB;IAED,sBAEC;IAED,uCAQC;IAmBD;;;;;;OAMG;IACH,cAHW,kBAAkB,GAChB,OAAO,CAqBnB;CA4BJ;kCA7HiC,wBAAwB"}

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

@@ -86,7 +86,7 @@ export class RandomContainerAudioClip extends ContainerAudioClip {
     pickChildIndex(playback: SopraPlaybackContext): number;
     planTimeline(env: any, gainDb?: number, pitchCents?: number, offset?: number): {
         plays: {
-            clip: SampleAudioClip;
+            clip: import("./SampleAudioClip.js").SampleAudioClip;
             offset: number;
             gainDb: number;
             pitchCents: number;

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

@@ -86,15 +86,23 @@ export class SampleAudioClip extends AbstractAudioClip {
         pitchRandom?: number;
         gainRandom?: number;
     }): void;
+    /**
+     * @param {*} env
+     * @param {number} [gainDb]
+     * @param {number} [pitchCents]
+     * @param {number} [offset]
+     * @returns {{plays: {clip: SampleAudioClip, offset: number, gainDb: number, pitchCents: number}[], duration: number}}
+     */
     planTimeline(env: any, gainDb?: number, pitchCents?: number, offset?: number): {
         plays: {
-            clip: this;
+            clip: SampleAudioClip;
             offset: number;
             gainDb: number;
             pitchCents: number;
         }[];
-        duration: any;
+        duration: number;
     };
+    collectSampleClips(out?: any[]): any[];
 }
 export namespace SampleAudioClip {
     let typeName: string;

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;;;;;;;;MAkBC;CAUJ;;;;kCAzLiC,wBAAwB"}
+{"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,CAAA;SAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAoBpH;IAED,uCAGC;CAKJ;;;;kCAhMiC,wBAAwB"}

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

@@ -158,6 +158,13 @@ export class SampleAudioClip extends AbstractAudioClip {
         this.gainRandom = gainRandom;
     }
 
+    /**
+     * @param {*} env
+     * @param {number} [gainDb]
+     * @param {number} [pitchCents]
+     * @param {number} [offset]
+     * @returns {{plays: {clip: SampleAudioClip, offset: number, gainDb: number, pitchCents: number}[], duration: number}}
+     */
     planTimeline(env, gainDb = 0, pitchCents = 0, offset = 0) {
         let g = gainDb + this.gain;
         let p = pitchCents + this.pitch;

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

@@ -25,7 +25,7 @@ export class SequenceContainerAudioClip extends ContainerAudioClip {
     }): void;
     planTimeline(env: any, gainDb?: number, pitchCents?: number, offset?: number): {
         plays: {
-            clip: SampleAudioClip;
+            clip: import("./SampleAudioClip.js").SampleAudioClip;
             offset: number;
             gainDb: number;
             pitchCents: number;

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

@@ -26,7 +26,7 @@ export class SwitchContainerAudioClip extends ContainerAudioClip {
     defaultValue: number;
     planTimeline(env: any, gainDb?: number, pitchCents?: number, offset?: number): {
         plays: {
-            clip: SampleAudioClip;
+            clip: import("./SampleAudioClip.js").SampleAudioClip;
             offset: number;
             gainDb: number;
             pitchCents: number;

package/src/engine/sound/sopra/runtime/BusGraph.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("../definition/BusDefinition.js").BusDefinition} BusDefinition
+ */
 /**
  * A {@link BusDefinition.parentId} equal to this means "no parent" — the bus is a root and routes
  * straight to the engine destination.
@@ -83,4 +86,5 @@ export class BusGraph {
     approachVolume(id: string, linear: number, timeConstant: number): void;
     #private;
 }
+export type BusDefinition = import("../definition/BusDefinition.js").BusDefinition;
 //# sourceMappingURL=BusGraph.d.ts.map

package/src/engine/sound/sopra/runtime/BusGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BusGraph.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/BusGraph.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,8BAFU,MAAM,CAEkB;AAElC;;;;;GAKG;AACH;IAkBI;;;OAGG;IACH,iBAHW,gBAAgB,eAChB,SAAS,EAKnB;IAvBD;;;OAGG;IACH,OAFU,IAAI,MAAM,EAAE;QAAC,UAAU,gBAAgB;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAA;KAAC,CAAC,CAEpE;IAqBlB;;;;OAIG;IACH,mBAFW,eAAe,QAgFzB;IAED;;;OAGG;IACH,QAHW,MAAM,GACJ,OAAO,CAInB;IAoBD;;;;OAIG;IACH,aAHW,MAAM,GACJ,SAAS,CAIrB;IAED;;;;;OAKG;IACH,cAHW,MAAM,GACJ,SAAS,CAIrB;IAED;;;OAGG;IACH,cAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,cAHW,MAAM,UACN,MAAM,QAOhB;IAED;;;OAGG;IACH,gBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,eALW,MAAM,UACN,MAAM,YACN,MAAM,eACN,MAAM,QAOhB;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,UACN,MAAM,gBACN,MAAM,QAQhB;;CACJ"}
+{"version":3,"file":"BusGraph.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/BusGraph.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;GAIG;AACH,8BAFU,MAAM,CAEkB;AAElC;;;;;GAKG;AACH;IAkBI;;;OAGG;IACH,iBAHW,gBAAgB,eAChB,SAAS,EAKnB;IAvBD;;;OAGG;IACH,OAFU,IAAI,MAAM,EAAE;QAAC,UAAU,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAA;KAAC,CAAC,CAEpE;IAqBlB;;;;OAIG;IACH,mBAFW,aAAa,EAAE,QAgFzB;IAED;;;OAGG;IACH,QAHW,MAAM,GACJ,OAAO,CAInB;IAoBD;;;;OAIG;IACH,aAHW,MAAM,GACJ,SAAS,CAIrB;IAED;;;;;OAKG;IACH,cAHW,MAAM,GACJ,SAAS,CAIrB;IAED;;;OAGG;IACH,cAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,cAHW,MAAM,UACN,MAAM,QAOhB;IAED;;;OAGG;IACH,gBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,eALW,MAAM,UACN,MAAM,YACN,MAAM,eACN,MAAM,QAOhB;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,UACN,MAAM,gBACN,MAAM,QAQhB;;CACJ;4BArOY,OAAO,gCAAgC,EAAE,aAAa"}

package/src/engine/sound/sopra/runtime/BusGraph.js

@@ -2,6 +2,10 @@ import { dB2Volume } from "../../dB2Volume.js";
 import { volume2dB } from "../../volume2dB.js";
 import { rampGain } from "../util/fadeOutAndStop.js";
 
+/**
+ * @typedef {import("../definition/BusDefinition.js").BusDefinition} BusDefinition
+ */
+
 /**
  * A {@link BusDefinition.parentId} equal to this means "no parent" — the bus is a root and routes
  * straight to the engine destination.

package/src/engine/sound/sopra/runtime/EventInstance.d.ts

@@ -113,7 +113,7 @@ export class EventInstance {
      * Live voices currently sounding (timeline order).
      * @returns {Voice[]}
      */
-    get voices(): Voice[];
+    get voices(): import("./Voice.js").Voice[];
     /**
      * Begin playback at context time `now`.
      * @param {number} now
@@ -184,4 +184,12 @@ export class EventInstance {
     stop(): void;
     #private;
 }
+export type Quaternion = import("../../../../core/geom/Quaternion.js").Quaternion;
+export type Vector3 = import("../../../../core/geom/Vector3.js").Vector3;
+export type AcousticSolution = import("../../simulation/core/AcousticSolution.js").AcousticSolution;
+export type AcousticDirectivity = import("../../simulation/definition/AcousticDirectivity.js").AcousticDirectivity;
+export type SopraEngine = import("../SopraEngine.js").SopraEngine;
+export type EventDescription = import("../definition/EventDescription.js").EventDescription;
+export type SopraPlaybackContext = import("./SopraPlaybackContext.js").SopraPlaybackContext;
+export type Voice = import("./Voice.js").Voice;
 //# sourceMappingURL=EventInstance.d.ts.map

package/src/engine/sound/sopra/runtime/EventInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventInstance.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/EventInstance.js"],"names":[],"mappings":";;;iCAUU,MAAM;;;;;;AAoFhB;;;;;;;;;GASG;AACH;IAqII;;;;OAIG;IACH,mMAFW;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,eAAe,CAAC,uBAAsB;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAC,OAAO,CAAC;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,YAAY,CAAC,EAAC,MAAM,CAAC;QAAC,WAAW,CAAC,aAAY;QAAC,WAAW,CAAC,sBAAoB;KAAC,EA0EnQ;IAhND;;OAEG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,OAFU,kBAAkB,GAAC,MAAM,CAEA;IAEnC;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,cAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,aAAuB;IAyHnB;;OAEG;IACH,oBAAoB;IAEpB;;OAEG;IACH,8BAA8B;IAE9B;;OAEG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,UAAQ,IAAI,CAEE;IAExB;;;;;OAKG;IACH,aAFU,aAAW,IAAI,CAEK;IAE9B;;;;;OAKG;IACH,aAFU,sBAAoB,IAAI,CAEJ;IAE9B;;OAEG;IACH,SAFU,OAAO,CAEK;IAEtB;;OAEG;IACH,oBAFU,MAAM,CAEqB;IAErC;;OAEG;IACH,sCAAsC;IAW1C;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,sBAeC;IAED;;;OAGG;IACH,WAFW,MAAM,QAyChB;IAiID;;;OAGG;IACH,qBAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;OAGG;IACH,cAFW,MAAM,QAQhB;IAED;;;;;;;;;;;OAWG;IACH,8CA4CC;IAED;;;;;OAKG;IACH,uBAJW,MAAM,YACN,MAAM,eACN,MAAM,QAQhB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,eACN,MAAM,QAYhB;IAED;;;;OAIG;IACH,cAFW,MAAM,QAehB;IAED;;OAEG;IACH,gBAEC;IAED;;;;;OAKG;IACH,YAHW,MAAM,oBACN,UAAQ,IAAI,QAkDtB;IAmGD;;OAEG;IACH,aAsCC;;CACJ"}
+{"version":3,"file":"EventInstance.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/EventInstance.js"],"names":[],"mappings":";;;iCAqBU,MAAM;;;;;;AAoFhB;;;;;;;;;GASG;AACH;IAqII;;;;OAIG;IACH,oBAJW,WAAW,eACX,gBAAgB,qIAChB;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAC,OAAO,CAAC;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,eAAe,CAAC,EAAC,oBAAoB,CAAC;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAC,OAAO,CAAC;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,YAAY,CAAC,EAAC,MAAM,CAAC;QAAC,WAAW,CAAC,EAAC,UAAU,CAAC;QAAC,WAAW,CAAC,EAAC,mBAAmB,CAAA;KAAC,EA0EnQ;IAhND;;OAEG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,OAFU,kBAAkB,GAAC,MAAM,CAEA;IAEnC;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,cAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,aAAuB;IAyHnB;;OAEG;IACH,QAFU,WAAW,CAED;IAEpB;;OAEG;IACH,aAFU,gBAAgB,CAEI;IAE9B;;OAEG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,OAAO,GAAC,IAAI,CAEE;IAExB;;;;;OAKG;IACH,aAFU,UAAU,GAAC,IAAI,CAEK;IAE9B;;;;;OAKG;IACH,aAFU,mBAAmB,GAAC,IAAI,CAEJ;IAE9B;;OAEG;IACH,SAFU,OAAO,CAEK;IAEtB;;OAEG;IACH,oBAFU,MAAM,CAEqB;IAErC;;OAEG;IACH,iBAFU,oBAAoB,CAEQ;IAW1C;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,2CAeC;IAED;;;OAGG;IACH,WAFW,MAAM,QAyChB;IAiID;;;OAGG;IACH,qBAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;OAGG;IACH,cAFW,MAAM,QAQhB;IAED;;;;;;;;;;;OAWG;IACH,sBAFW,gBAAgB,QA8C1B;IAED;;;;;OAKG;IACH,uBAJW,MAAM,YACN,MAAM,eACN,MAAM,QAQhB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,eACN,MAAM,QAYhB;IAED;;;;OAIG;IACH,cAFW,MAAM,QAehB;IAED;;OAEG;IACH,gBAEC;IAED;;;;;OAKG;IACH,YAHW,MAAM,oBACN,OAAO,GAAC,IAAI,QAkDtB;IAmGD;;OAEG;IACH,aAsCC;;CACJ;yBA31BY,OAAO,qCAAqC,EAAE,UAAU;sBACxD,OAAO,kCAAkC,EAAE,OAAO;+BAClD,OAAO,2CAA2C,EAAE,gBAAgB;kCACpE,OAAO,oDAAoD,EAAE,mBAAmB;0BAChF,OAAO,mBAAmB,EAAE,WAAW;+BACvC,OAAO,mCAAmC,EAAE,gBAAgB;mCAC5D,OAAO,2BAA2B,EAAE,oBAAoB;oBACxD,OAAO,YAAY,EAAE,KAAK"}

package/src/engine/sound/sopra/runtime/EventInstance.js

@@ -6,6 +6,17 @@ import { VOICE_POOL } from "./VoicePool.js";
 import { LOW_MID_HZ, MID_HIGH_HZ } from "../../simulation/render/reverbImpulseResponse.js";
 import { v3_distance } from "../../../../core/geom/vec3/v3_distance.js";
 
+/**
+ * @typedef {import("../../../../core/geom/Quaternion.js").Quaternion} Quaternion
+ * @typedef {import("../../../../core/geom/Vector3.js").Vector3} Vector3
+ * @typedef {import("../../simulation/core/AcousticSolution.js").AcousticSolution} AcousticSolution
+ * @typedef {import("../../simulation/definition/AcousticDirectivity.js").AcousticDirectivity} AcousticDirectivity
+ * @typedef {import("../SopraEngine.js").SopraEngine} SopraEngine
+ * @typedef {import("../definition/EventDescription.js").EventDescription} EventDescription
+ * @typedef {import("./SopraPlaybackContext.js").SopraPlaybackContext} SopraPlaybackContext
+ * @typedef {import("./Voice.js").Voice} Voice
+ */
+
 /**
  * Lifecycle state of an {@link EventInstance}.
  * @enum {number}

package/src/engine/sound/sopra/runtime/VoiceManager.d.ts

@@ -35,4 +35,6 @@ export class VoiceManager {
     makeRoom(description: EventDescription): boolean;
     #private;
 }
+export type EventDescription = import("../definition/EventDescription.js").EventDescription;
+export type EventInstance = import("./EventInstance.js").EventInstance;
 //# sourceMappingURL=VoiceManager.d.ts.map

package/src/engine/sound/sopra/runtime/VoiceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceManager.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/VoiceManager.js"],"names":[],"mappings":"AA2CA;;;;;;;;;;;;GAYG;AACH;IAQI;;OAEG;IACH,wCAIC;IAED;;OAEG;IACH,0CAaC;IAED;;;OAGG;IACH,8CAFa,MAAM,CAMlB;IAED;;;;;;OAMG;IACH,yCAHa,OAAO,CA4BnB;;CAEJ"}
+{"version":3,"file":"VoiceManager.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/VoiceManager.js"],"names":[],"mappings":"AAgDA;;;;;;;;;;;;GAYG;AACH;IAQI;;OAEG;IACH,mBAFW,aAAa,QAMvB;IAED;;OAEG;IACH,qBAFW,aAAa,QAevB;IAED;;;OAGG;IACH,2BAHW,gBAAgB,GACd,MAAM,CAMlB;IAED;;;;;;OAMG;IACH,sBAJW,gBAAgB,GACd,OAAO,CA4BnB;;CAEJ;+BAxIY,OAAO,mCAAmC,EAAE,gBAAgB;4BAC5D,OAAO,oBAAoB,EAAE,aAAa"}

package/src/engine/sound/sopra/runtime/VoiceManager.js

@@ -1,6 +1,11 @@
 import { HashMap } from "../../../../core/collection/map/HashMap.js";
 import { VoiceStealMode } from "../definition/VoiceStealMode.js";
 
+/**
+ * @typedef {import("../definition/EventDescription.js").EventDescription} EventDescription
+ * @typedef {import("./EventInstance.js").EventInstance} EventInstance
+ */
+
 /**
  *
  * @param {EventInstance} a

package/src/engine/ui/DraggableAspect.d.ts

@@ -15,13 +15,20 @@
 export class DraggableAspect {
     /**
      *
-     * @param {EventTarget} el
-     * @param {(position:Vector2, event:Event)=>*} [dragStart=noop]
-     * @param {(position:Vector2, origin:Vector2, delta:Vector2, event:Event)=>*} [drag=noop]
-     * @param {(position:Vector2, origin:Vector2, event:Event)=>*} [dragEnd=noop]
-     * @param {boolean} [stopPropagation=true] prevent propagation of pointer events up the DOM tree
+     * @param {Object} options
+     * @param {EventTarget} options.el
+     * @param {(position:Vector2, event:Event)=>*} [options.dragStart=noop]
+     * @param {(position:Vector2, origin:Vector2, delta:Vector2, event:Event)=>*} [options.drag=noop]
+     * @param {(position:Vector2, origin:Vector2, event:Event)=>*} [options.dragEnd=noop]
+     * @param {boolean} [options.stopPropagation=true] prevent propagation of pointer events up the DOM tree
      */
-    constructor({ el, dragStart, drag, dragEnd, stopPropagation }: EventTarget);
+    constructor({ el, dragStart, drag, dragEnd, stopPropagation }: {
+        el: EventTarget;
+        dragStart?: (position: Vector2, event: Event) => any;
+        drag?: (position: Vector2, origin: Vector2, delta: Vector2, event: Event) => any;
+        dragEnd?: (position: Vector2, origin: Vector2, event: Event) => any;
+        stopPropagation?: boolean;
+    });
     /**
      *
      * @type {PointerDevice}
@@ -39,4 +46,5 @@ export class DraggableAspect {
     stop(): void;
 }
 import { PointerDevice } from "../input/devices/PointerDevice.js";
+import Vector2 from "../../core/geom/Vector2.js";
 //# sourceMappingURL=DraggableAspect.d.ts.map

package/src/engine/ui/DraggableAspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DraggableAspect.d.ts","sourceRoot":"","sources":["../../../../src/engine/ui/DraggableAspect.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH;IACI;;;;;;;OAOG;IACH,+DANW,WAAW,EA2ErB;IApEG;;;;;OAKG;IACH,8BAAyC;IAQnB,+BAA8C;IAwDxE;;;OAGG;IACH,cAFa,aAAa,CAIzB;IAED,cAEC;IAED,aAGC;CACJ;8BAhHyD,mCAAmC"}
+{"version":3,"file":"DraggableAspect.d.ts","sourceRoot":"","sources":["../../../../src/engine/ui/DraggableAspect.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH;IACI;;;;;;;;OAQG;IACH;QANgC,EAAE,EAAvB,WAAW;QACkC,SAAS,GAAtD,CAAC,QAAQ,EAAC,OAAO,EAAE,KAAK,EAAC,KAAK,QAAI;QAC0C,IAAI,GAAhF,CAAC,QAAQ,EAAC,OAAO,EAAE,MAAM,EAAC,OAAO,EAAE,KAAK,EAAC,OAAO,EAAE,KAAK,EAAC,KAAK,QAAI;QACJ,OAAO,GAApE,CAAC,QAAQ,EAAC,OAAO,EAAE,MAAM,EAAC,OAAO,EAAE,KAAK,EAAC,KAAK,QAAI;QAChC,eAAe,GAAjC,OAAO;OAuEjB;IApEG;;;;;OAKG;IACH,8BAAyC;IAQnB,+BAA8C;IAwDxE;;;OAGG;IACH,cAFa,aAAa,CAIzB;IAED,cAEC;IAED,aAGC;CACJ;8BAjHyD,mCAAmC;oBADzE,4BAA4B"}

package/src/engine/ui/DraggableAspect.js

@@ -19,11 +19,12 @@ import { PointerDevice, readPositionFromMouseEvent } from "../input/devices/Poin
 export class DraggableAspect {
     /**
      *
-     * @param {EventTarget} el
-     * @param {(position:Vector2, event:Event)=>*} [dragStart=noop]
-     * @param {(position:Vector2, origin:Vector2, delta:Vector2, event:Event)=>*} [drag=noop]
-     * @param {(position:Vector2, origin:Vector2, event:Event)=>*} [dragEnd=noop]
-     * @param {boolean} [stopPropagation=true] prevent propagation of pointer events up the DOM tree
+     * @param {Object} options
+     * @param {EventTarget} options.el
+     * @param {(position:Vector2, event:Event)=>*} [options.dragStart=noop]
+     * @param {(position:Vector2, origin:Vector2, delta:Vector2, event:Event)=>*} [options.drag=noop]
+     * @param {(position:Vector2, origin:Vector2, event:Event)=>*} [options.dragEnd=noop]
+     * @param {boolean} [options.stopPropagation=true] prevent propagation of pointer events up the DOM tree
      */
     constructor({ el, dragStart = noop, drag = noop, dragEnd = noop, stopPropagation = true }) {
         /**