@woosh/meep-engine 3.21.0 → 3.23.0

package/src/engine/EngineConfiguration.d.ts

@@ -1,3 +1,18 @@
+/**
+ * @template [T=any]
+ * @typedef {import("../core/primitives/Class.js").Class<T>} Class
+ */
+/**
+ * A `@template` applies to the whole docblock it sits in, so a generic alias needs one of its own.
+ * @template CTX, Asset
+ * @typedef {import("./asset/loaders/AssetLoader.js").AssetLoader<CTX, Asset>} AssetLoader
+ */
+/**
+ * @typedef {import("./Engine.js").default} Engine
+ * @typedef {import("./ecs/System.js").System} System
+ * @typedef {import("./knowledge/database/StaticKnowledgeDataTableDescriptor.js").StaticKnowledgeDataTableDescriptor} StaticKnowledgeDataTableDescriptor
+ * @typedef {import("./plugin/EnginePlugin.js").EnginePlugin} EnginePlugin
+ */
 export class EngineConfiguration {
     /**
      * @private
@@ -22,9 +37,9 @@ export class EngineConfiguration {
     private readonly knowledge;
     /**
      *
-     * @type {Map<string,AssetLoader<any>>}
+     * @type {Map<string,AssetLoader<any,any>>}
      */
-    loaders: Map<string, AssetLoader<any>>;
+    loaders: Map<string, AssetLoader<any, any>>;
     /**
      *
      * @param {string} type
@@ -34,15 +49,15 @@ export class EngineConfiguration {
     /**
      * @template T
      * @param {string} type
-     * @param {AssetLoader<T>} loader
+     * @param {AssetLoader<any,T>} loader
      */
-    addLoader<T>(type: string, loader: AssetLoader<T>): boolean;
+    addLoader<T>(type: string, loader: import("./asset/loaders/AssetLoader.js").AssetLoader<any, T>): boolean;
     /**
      * @template T
      * @param {string} type
-     * @returns {AssetLoader<T>}
+     * @returns {AssetLoader<any,T>}
      */
-    removeLoader<T_1>(type: string): AssetLoader<T_1>;
+    removeLoader<T_1>(type: string): import("./asset/loaders/AssetLoader.js").AssetLoader<any, T_1>;
     /**
      *
      * @param {Class<EnginePlugin>} plugin
@@ -54,11 +69,11 @@ export class EngineConfiguration {
      * @param {System} system
      * @returns {boolean}
      */
-    addSystem(system: System): boolean;
+    addSystem(system: import("./ecs/System.js").System<any>): boolean;
     /**
-     * @param {System} systems
+     * @param {...System} systems
      */
-    addManySystems(...systems: System): void;
+    addManySystems(...systems: import("./ecs/System.js").System<any>[]): void;
     /**
      *
      * @param {StaticKnowledgeDataTableDescriptor} table
@@ -71,4 +86,13 @@ export class EngineConfiguration {
      */
     apply(engine: Engine): Promise<void>;
 }
+export type Class<T = any> = import("../core/primitives/Class.js").Class<T>;
+/**
+ * A `@template` applies to the whole docblock it sits in, so a generic alias needs one of its own.
+ */
+export type AssetLoader<CTX, Asset> = import("./asset/loaders/AssetLoader.js").AssetLoader<CTX, Asset>;
+export type Engine = import("./Engine.js").default;
+export type System = import("./ecs/System.js").System<any>;
+export type StaticKnowledgeDataTableDescriptor = import("./knowledge/database/StaticKnowledgeDataTableDescriptor.js").StaticKnowledgeDataTableDescriptor;
+export type EnginePlugin = import("./plugin/EnginePlugin.js").EnginePlugin;
 //# sourceMappingURL=EngineConfiguration.d.ts.map

package/src/engine/EngineConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineConfiguration.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineConfiguration.js"],"names":[],"mappings":"AAGA;IAEI;;;OAGG;IACH,gBAAa;IAEb;;;OAGG;IACH,gBAAa;IAEb;;;;;;;;;OASG;IACH,2BAAe;IAEf;;;OAGG;IACH,SAFU,IAAI,MAAM,mBAAkB,CAElB;IAEpB;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAHW,MAAM,mCAWhB;IAED;;;;OAIG;IACH,wBAHW,MAAM,oBAWhB;IAED;;;;OAIG;IACH,wCAFa,OAAO,CAQnB;IAED;;;;OAIG;IACH,2BAFa,OAAO,CAUnB;IAED;;OAEG;IACH,yCAKC;IAED;;;;OAIG;IACH,yDAFa,OAAO,CASnB;IAED;;;OAGG;IACH,qCAmDC;CACJ"}
+{"version":3,"file":"EngineConfiguration.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineConfiguration.js"],"names":[],"mappings":"AAGA;;;GAGG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AAEH;IAEI;;;OAGG;IACH,gBAAa;IAEb;;;OAGG;IACH,gBAAa;IAEb;;;;;;;;;OASG;IACH,2BAAe;IAEf;;;OAGG;IACH,SAFU,IAAI,MAAM,EAAC,YAAY,GAAG,EAAC,GAAG,CAAC,CAAC,CAEtB;IAEpB;;;;OAIG;IACH,gBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAHW,MAAM,iFAWhB;IAED;;;;OAIG;IACH,wBAHW,MAAM,kEAWhB;IAED;;;;OAIG;IACH,kBAHW,MAAM,YAAY,CAAC,GACjB,OAAO,CAQnB;IAED;;;;OAIG;IACH,0DAFa,OAAO,CAUnB;IAED;;OAEG;IACH,0EAKC;IAED;;;;OAIG;IACH,oBAHW,kCAAkC,GAChC,OAAO,CASnB;IAED;;;OAGG;IACH,cAFW,MAAM,iBAqDhB;CACJ;6BAnMY,OAAO,6BAA6B,EAAE,KAAK,CAAC,CAAC,CAAC;;;;sCAM9C,OAAO,gCAAgC,EAAE,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;qBAIhE,OAAO,aAAa,EAAE,OAAO;;iDAE7B,OAAO,4DAA4D,EAAE,kCAAkC;2BACvG,OAAO,0BAA0B,EAAE,YAAY"}

package/src/engine/EngineConfiguration.js

@@ -1,6 +1,24 @@
 import { assert } from "../core/assert.js";
 import { computeSystemName } from "./ecs/computeSystemName.js";
 
+/**
+ * @template [T=any]
+ * @typedef {import("../core/primitives/Class.js").Class<T>} Class
+ */
+
+/**
+ * A `@template` applies to the whole docblock it sits in, so a generic alias needs one of its own.
+ * @template CTX, Asset
+ * @typedef {import("./asset/loaders/AssetLoader.js").AssetLoader<CTX, Asset>} AssetLoader
+ */
+
+/**
+ * @typedef {import("./Engine.js").default} Engine
+ * @typedef {import("./ecs/System.js").System} System
+ * @typedef {import("./knowledge/database/StaticKnowledgeDataTableDescriptor.js").StaticKnowledgeDataTableDescriptor} StaticKnowledgeDataTableDescriptor
+ * @typedef {import("./plugin/EnginePlugin.js").EnginePlugin} EnginePlugin
+ */
+
 export class EngineConfiguration {
 
     /**
@@ -29,7 +47,7 @@ export class EngineConfiguration {
 
     /**
      *
-     * @type {Map<string,AssetLoader<any>>}
+     * @type {Map<string,AssetLoader<any,any>>}
      */
     loaders = new Map();
 
@@ -45,7 +63,7 @@ export class EngineConfiguration {
     /**
      * @template T
      * @param {string} type
-     * @param {AssetLoader<T>} loader
+     * @param {AssetLoader<any,T>} loader
      */
     addLoader(type, loader) {
         if (this.loaders.has(type)) {
@@ -60,7 +78,7 @@ export class EngineConfiguration {
     /**
      * @template T
      * @param {string} type
-     * @returns {AssetLoader<T>}
+     * @returns {AssetLoader<any,T>}
      */
     removeLoader(type) {
         const assetLoader = this.loaders.get(type);
@@ -101,7 +119,7 @@ export class EngineConfiguration {
     }
 
     /**
-     * @param {System} systems
+     * @param {...System} systems
      */
     addManySystems(...systems) {
         assert.defined(systems, "systems");

package/src/engine/EngineHarness.d.ts

@@ -1,10 +1,13 @@
 export class EngineHarness {
     /**
      * Quick initialization of the engine in a sensible default configuration
-     * @param {(config:EngineConfiguration,engine:Engine)=>*} [configuration]
+     * @param {Object} [options]
+     * @param {(config:EngineConfiguration,engine:Engine)=>*} [options.configuration]
      * @return {Promise<Engine>}
      */
-    static bootstrap({ configuration }?: (config: EngineConfiguration, engine: Engine) => any): Promise<Engine>;
+    static bootstrap({ configuration }?: {
+        configuration?: (config: EngineConfiguration, engine: Engine) => any;
+    }): Promise<Engine>;
     /**
      * The Shade scene this engine's harness systems draw into, made on first ask.
      *
@@ -144,16 +147,23 @@ export class EngineHarness {
     }): Promise<Entity>;
     /**
      *
-     * @param {Engine} engine
-     * @param {Vector2} [size]
-     * @param {String} [diffuse0]
-     * @param heightMap
-     * @param {number} [resolution]
-     * @param {number} [waterLevel]
-     * @param {boolean} [enableWater]
+     * @param {Object} options
+     * @param {Engine} options.engine
+     * @param {Vector2} [options.size]
+     * @param {String} [options.diffuse0]
+     * @param {number} [options.resolution]
+     * @param {number} [options.waterLevel]
+     * @param {boolean} [options.enableWater]
      * @returns {Terrain}
      */
-    static buildTerrain({ engine, size, diffuse0, resolution, waterLevel, enableWater, }: Engine): Terrain;
+    static buildTerrain({ engine, size, diffuse0, resolution, waterLevel, enableWater, }: {
+        engine: Engine;
+        size?: Vector2;
+        diffuse0?: string;
+        resolution?: number;
+        waterLevel?: number;
+        enableWater?: boolean;
+    }): Terrain;
     /**
      * @readonly
      * @type {Promise|null}
@@ -182,6 +192,7 @@ export namespace EngineHarness {
      */
     function getSingleton(): EngineHarness;
 }
+export type EntityComponentDataset = import("./ecs/EntityComponentDataset.js").EntityComponentDataset;
 import Engine from "./Engine.js";
 import { EngineConfiguration } from "./EngineConfiguration.js";
 import { Scene } from "../shade/renderer/scene/Scene.js";
@@ -189,5 +200,6 @@ import { FrameRateView } from "../view/elements/FrameRateView.js";
 import Vector3 from "../core/geom/Vector3.js";
 import Entity from "./ecs/Entity.js";
 import { Color } from "../core/color/Color.js";
+import Vector2 from "../core/geom/Vector2.js";
 import Terrain from "./ecs/terrain/ecs/Terrain.js";
 //# sourceMappingURL=EngineHarness.d.ts.map

package/src/engine/EngineHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AA2EA;IAmBI;;;;OAIG;IACH,qCAHW,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI,GAC5C,QAAQ,MAAM,CAAC,CAM1B;IAED;;;;;;;;;OASG;IACH,0BAHW,MAAM,GACJ,KAAK,CAYjB;IAED;;;;;;;;;OASG;IACH,6BAHW,MAAM,GACJ,aAAa,CAQzB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG;QAClB,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH;QApB0B,MAAM,EAArB,MAAM;QACgC,KAAK,GAA3C;YAAC,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAA;SAAC;QACrB,SAAS;QACT,WAAW;QACF,KAAK,GAArB,MAAM;QACU,GAAG,GAAnB,MAAM;QACU,QAAQ,GAAxB,MAAM;QACwB,WAAW,GAAzC;YAAC,CAAC,EAAC,MAAM,CAAC;YAAC,CAAC,EAAC,MAAM,CAAA;SAAC;QACJ,iBAAiB,GAAjC,MAAM;QACW,WAAW,GAA5B,OAAO;QACU,aAAa,GAA9B,OAAO;QACU,YAAY,GAA7B,OAAO;QACU,aAAa,GAA9B,OAAO;QACS,iBAAiB,GAAjC,MAAM;QACU,iBAAiB,GAAjC,MAAM;QACW,gBAAgB,GAAjC,OAAO;QACU,cAAc,GAA/B,OAAO;QACS,mBAAmB,GAAnC,MAAM;QACW,OAAO,GAAxB,OAAO;sBA0EjB;IAGD;;;;;;;;;;;;OAYG;IACH;QAXyB,MAAM,EAApB,MAAM;QACyB,GAAG;QACnB,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;QACO,GAAG,GAAjB,KAAK;QACU,YAAY,GAA3B,MAAM;QACU,YAAY,GAA5B,OAAO;QACO,OAAO,GAArB,KAAK;QACU,gBAAgB,GAA/B,MAAM;QACS,iBAAiB,GAAhC,MAAM;sBA2DhB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG;QAChC,QAAQ,MAAM,CAAC,CA6C3B;IAGD;;;;;;;;;;OAUG;IACH,sFATW,MAAM,GAOJ,OAAO,CA0DnB;IApfD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAEb;IAGL;;;OAGG;IACH,QAFU,MAAM,CAEiC;IA0DrD;;;;;OAKG;IACH;QAJkE,aAAa,GAApE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5B,mBAAmB,GAApC,OAAO;QACL,QAAQ,MAAM,CAAC,CA0D3B;CAkXJ;;IAID;;;OAGG;IACH,uCAMC;;mBAhkBkB,aAAa;oCACI,0BAA0B;sBAOxC,kCAAkC;8BAjB1B,mCAAmC;oBAD7C,yBAAyB;mBAK1B,iBAAiB;sBATd,wBAAwB;oBAW1B,8BAA8B"}
+{"version":3,"file":"EngineHarness.d.ts","sourceRoot":"","sources":["../../../src/engine/EngineHarness.js"],"names":[],"mappings":"AA+EA;IAmBI;;;;;OAKG;IACH;QAHmE,aAAa,GAArE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5C,QAAQ,MAAM,CAAC,CAM1B;IAED;;;;;;;;;OASG;IACH,0BAHW,MAAM,GACJ,KAAK,CAYjB;IAED;;;;;;;;;OASG;IACH,6BAHW,MAAM,GACJ,aAAa,CAQzB;IAkED;;;;;;;;;;;;;OAaG;IACH;QAZyB,MAAM,EAApB,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACN,MAAM,GAAtB,OAAO;QACQ,QAAQ,GAAvB,MAAM;QACS,KAAK,GAApB,MAAM;QACS,GAAG,GAAlB,MAAM;QACU,QAAQ,GAAxB,OAAO;QACQ,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACS,WAAW,GAA1B,MAAM;QACJ,MAAM,CA+DlB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH;QApB0B,MAAM,EAArB,MAAM;QACgC,KAAK,GAA3C;YAAC,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAA;SAAC;QACrB,SAAS;QACT,WAAW;QACF,KAAK,GAArB,MAAM;QACU,GAAG,GAAnB,MAAM;QACU,QAAQ,GAAxB,MAAM;QACwB,WAAW,GAAzC;YAAC,CAAC,EAAC,MAAM,CAAC;YAAC,CAAC,EAAC,MAAM,CAAA;SAAC;QACJ,iBAAiB,GAAjC,MAAM;QACW,WAAW,GAA5B,OAAO;QACU,aAAa,GAA9B,OAAO;QACU,YAAY,GAA7B,OAAO;QACU,aAAa,GAA9B,OAAO;QACS,iBAAiB,GAAjC,MAAM;QACU,iBAAiB,GAAjC,MAAM;QACW,gBAAgB,GAAjC,OAAO;QACU,cAAc,GAA/B,OAAO;QACS,mBAAmB,GAAnC,MAAM;QACW,OAAO,GAAxB,OAAO;sBA0EjB;IAGD;;;;;;;;;;;;OAYG;IACH;QAXyB,MAAM,EAApB,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACP,mBAAmB,GAAlC,MAAM;QACU,UAAU,GAA1B,OAAO;QACO,GAAG,GAAjB,KAAK;QACU,YAAY,GAA3B,MAAM;QACU,YAAY,GAA5B,OAAO;QACO,OAAO,GAArB,KAAK;QACU,gBAAgB,GAA/B,MAAM;QACS,iBAAiB,GAAhC,MAAM;sBA2DhB;IAED;;;;;;;OAOG;IACH;QAN0B,YAAY,GAA3B,MAAM;QACQ,MAAM,EAApB,MAAM;QACS,WAAW,GAA1B,MAAM;QACyB,GAAG,GAAlC,sBAAsB;QACpB,QAAQ,MAAM,CAAC,CA6C3B;IAGD;;;;;;;;;;OAUG;IACH;QAR2B,MAAM,EAAtB,MAAM;QACY,IAAI,GAAtB,OAAO;QACU,QAAQ;QACR,UAAU,GAA3B,MAAM;QACW,UAAU,GAA3B,MAAM;QACY,WAAW,GAA7B,OAAO;QACL,OAAO,CA0DnB;IArfD;;;OAGG;IACH,YAFU,eAAQ,IAAI,CAEb;IAGL;;;OAGG;IACH,QAFU,MAAM,CAEiC;IA2DrD;;;;;OAKG;IACH;QAJkE,aAAa,GAApE,CAAC,MAAM,EAAC,mBAAmB,EAAC,MAAM,EAAC,MAAM,QAAI;QAC5B,mBAAmB,GAApC,OAAO;QACL,QAAQ,MAAM,CAAC,CA0D3B;CAkXJ;;IAID;;;OAGG;IACH,uCAMC;;qCA7iBY,OAAO,iCAAiC,EAAE,sBAAsB;mBAxB1D,aAAa;oCACI,0BAA0B;sBAOxC,kCAAkC;8BAjB1B,mCAAmC;oBAD7C,yBAAyB;mBAK1B,iBAAiB;sBATd,wBAAwB;oBAG1B,yBAAyB;oBAQzB,8BAA8B"}

package/src/engine/EngineHarness.js

@@ -36,6 +36,10 @@ import { WebEnginePlatform } from "./platform/WebEnginePlatform.js";
 import SoundListener from "./sound/ecs/SoundListener.js";
 import SoundListenerSystem from "./sound/ecs/SoundListenerSystem.js";
 
+/**
+ * @typedef {import("./ecs/EntityComponentDataset.js").EntityComponentDataset} EntityComponentDataset
+ */
+
 /**
  * The Shade scene a harness's systems draw into, one per engine.
  *
@@ -94,7 +98,8 @@ export class EngineHarness {
 
     /**
      * Quick initialization of the engine in a sensible default configuration
-     * @param {(config:EngineConfiguration,engine:Engine)=>*} [configuration]
+     * @param {Object} [options]
+     * @param {(config:EngineConfiguration,engine:Engine)=>*} [options.configuration]
      * @return {Promise<Engine>}
      */
     static async bootstrap({ configuration } = {}) {
@@ -509,13 +514,13 @@ export class EngineHarness {
 
     /**
      *
-     * @param {Engine} engine
-     * @param {Vector2} [size]
-     * @param {String} [diffuse0]
-     * @param heightMap
-     * @param {number} [resolution]
-     * @param {number} [waterLevel]
-     * @param {boolean} [enableWater]
+     * @param {Object} options
+     * @param {Engine} options.engine
+     * @param {Vector2} [options.size]
+     * @param {String} [options.diffuse0]
+     * @param {number} [options.resolution]
+     * @param {number} [options.waterLevel]
+     * @param {boolean} [options.enableWater]
      * @returns {Terrain}
      */
     static async buildTerrain(

package/src/engine/EntityCreator.d.ts

@@ -11,23 +11,38 @@
  * up — 32 is ample for that, and the 256 the legacy translator used existed to emulate "play
  * everything", which a click does not need.
  *
- * @param {Vector3} [position]
- * @param {number} [timeout] seconds before the backstop kills the entity regardless
- * @param {String} [url]
- * @param {EventDescription} [event]
- * @param {boolean} [positioned]
- * @param {String|SopraDefaultBus} [channel]
- * @param {number} [volume]
+ * @param {Object} options
+ * @param {Vector3} [options.position]
+ * @param {number} [options.timeout] seconds before the backstop kills the entity regardless
+ * @param {String} [options.url]
+ * @param {EventDescription} [options.event]
+ * @param {boolean} [options.positioned]
+ * @param {String|SopraDefaultBus} [options.channel]
+ * @param {number} [options.volume]
  * @returns {Entity}
  */
-export function createSound({ position, timeout, url, event, positioned, channel, volume }?: Vector3): Entity;
+export function createSound({ position, timeout, url, event, positioned, channel, volume }: {
+    position?: Vector3;
+    timeout?: number;
+    url?: string;
+    event?: EventDescription;
+    positioned?: boolean;
+    channel?: string | SopraDefaultBus;
+    volume?: number;
+}): Entity;
 /**
  * Builds an entity that runs the given action once, after the timeout, and then destroys itself.
- * @param {number} timeout in seconds
- * @param {function} action
+ * @param {Object} options
+ * @param {number} options.timeout in seconds
+ * @param {function} options.action
  * @returns {Entity}
  */
-export function createTimer({ timeout, action }: number): Entity;
+export function createTimer({ timeout, action }: {
+    timeout: number;
+    action: Function;
+}): Entity;
 import Vector3 from "../core/geom/Vector3.js";
+import { EventDescription } from "./sound/sopra/definition/EventDescription.js";
+import { SopraDefaultBus } from "./sound/sopra/SopraEngine.js";
 import Entity from './ecs/Entity.js';
 //# sourceMappingURL=EntityCreator.d.ts.map

package/src/engine/EntityCreator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityCreator.d.ts","sourceRoot":"","sources":["../../../src/engine/EntityCreator.js"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,6FATW,OAAO,GAOL,MAAM,CAmClB;AAED;;;;;GAKG;AACH,iDAJW,MAAM,GAEJ,MAAM,CAelB;oBApHmB,yBAAyB;mBAE1B,iBAAiB"}
+{"version":3,"file":"EntityCreator.d.ts","sourceRoot":"","sources":["../../../src/engine/EntityCreator.js"],"names":[],"mappings":"AAyCA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAT6B,QAAQ,GAA1B,OAAO;IACU,OAAO,GAAxB,MAAM;IACW,GAAG;IACO,KAAK,GAAhC,gBAAgB;IACE,UAAU,GAA5B,OAAO;IAC0B,OAAO,GAAxC,SAAO,eAAe;IACL,MAAM,GAAvB,MAAM;IACJ,MAAM,CAmClB;AAED;;;;;;GAMG;AACH;IAJ2B,OAAO,EAAvB,MAAM;IACY,MAAM;IACtB,MAAM,CAelB;oBAvHmB,yBAAyB;iCAYZ,8CAA8C;gCAE/C,8BAA8B;mBAZ3C,iBAAiB"}

package/src/engine/EntityCreator.js

@@ -19,10 +19,11 @@ import { SopraDefaultBus } from "./sound/sopra/SopraEngine.js";
  * as-is (it already owns its bus and its spatialization, so `channel` and `positioned` do not apply to
  * it), or a `url` to play once.
  *
- * @param {EventDescription} [event]
- * @param {String} [url]
- * @param {boolean} [positioned] 3D (attenuates and pans by distance) vs 2D. Ignored when `event` is given
- * @param {String|SopraDefaultBus} [channel] bus to route to. Ignored when `event` is given
+ * @param {Object} options
+ * @param {EventDescription} [options.event]
+ * @param {String} [options.url]
+ * @param {boolean} [options.positioned] 3D (attenuates and pans by distance) vs 2D. Ignored when `event` is given
+ * @param {String|SopraDefaultBus} [options.channel] bus to route to. Ignored when `event` is given
  * @returns {EventDescription}
  */
 function resolveSoundEvent({ event, url, positioned, channel }) {
@@ -51,13 +52,14 @@ function resolveSoundEvent({ event, url, positioned, channel }) {
  * up — 32 is ample for that, and the 256 the legacy translator used existed to emulate "play
  * everything", which a click does not need.
  *
- * @param {Vector3} [position]
- * @param {number} [timeout] seconds before the backstop kills the entity regardless
- * @param {String} [url]
- * @param {EventDescription} [event]
- * @param {boolean} [positioned]
- * @param {String|SopraDefaultBus} [channel]
- * @param {number} [volume]
+ * @param {Object} options
+ * @param {Vector3} [options.position]
+ * @param {number} [options.timeout] seconds before the backstop kills the entity regardless
+ * @param {String} [options.url]
+ * @param {EventDescription} [options.event]
+ * @param {boolean} [options.positioned]
+ * @param {String|SopraDefaultBus} [options.channel]
+ * @param {number} [options.volume]
  * @returns {Entity}
  */
 export function createSound(
@@ -97,8 +99,9 @@ export function createSound(
 
 /**
  * Builds an entity that runs the given action once, after the timeout, and then destroys itself.
- * @param {number} timeout in seconds
- * @param {function} action
+ * @param {Object} options
+ * @param {number} options.timeout in seconds
+ * @param {function} options.action
  * @returns {Entity}
  */
 export function createTimer({ timeout, action }) {

package/src/engine/animation/EntityAnimation.d.ts

@@ -9,7 +9,7 @@ declare class EntityAnimation {
      * @type {Array.<AnimationSpec>} animationSpecs
      */
     animationSpecs: Array<AnimationSpec>;
-    ended: ObservedValue;
+    ended: ObservedValue<boolean>;
     entity: number;
     /**
      *

package/src/engine/animation/EntityAnimation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityAnimation.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/EntityAnimation.js"],"names":[],"mappings":";AAiCA;IAQI;;;OAGG;IACH,oBAFW,MAAM,EAIhB;IAbD;;OAEG;IACH,gBAFU,MAAO,aAAa,CAAC,CAEX;IAEpB,qBAAiC;IAO7B,eAAoB;IAGxB;;;OAGG;IACH,cAFa,QAAQ,GAAG,CAAC,CAUxB;IAED,kFAGC;IAED,oEAEC;IAED,+DAEC;IAED;;;;OAIG;IACH,kBAHW,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,GAClC,eAAe,CAW3B;IAED,qBA4CC;CACJ;AAtID;;GAEG;AACH;IAOI;;;;;;OAMG;IACH;;;kBAJW,MAAM,YACN,MAAM,sBACN,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAO/B;IAlBD;;;OAGG;IACH,OAFU,QAAM,IAAI,CAEP;IAUT,kBAA0B;IAC1B,iBAAwB;IACxB,wBALW,MAAM,KAAK,MAAM,CAKgB;IAC5C;;;MAAgB;CAEvB;;;;;;;0BA1ByB,mCAAmC"}
+{"version":3,"file":"EntityAnimation.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/EntityAnimation.js"],"names":[],"mappings":";AAiCA;IAQI;;;OAGG;IACH,oBAFW,MAAM,EAIhB;IAbD;;OAEG;IACH,gBAFU,MAAO,aAAa,CAAC,CAEX;IAEpB,8BAAiC;IAO7B,eAAoB;IAGxB;;;OAGG;IACH,cAFa,QAAQ,GAAG,CAAC,CAUxB;IAED,kFAGC;IAED,oEAEC;IAED,+DAEC;IAED;;;;OAIG;IACH,kBAHW,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,GAClC,eAAe,CAW3B;IAED,qBA4CC;CACJ;AAtID;;GAEG;AACH;IAOI;;;;;;OAMG;IACH;;;kBAJW,MAAM,YACN,MAAM,sBACN,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAO/B;IAlBD;;;OAGG;IACH,OAFU,QAAM,IAAI,CAEP;IAUT,kBAA0B;IAC1B,iBAAwB;IACxB,wBALW,MAAM,KAAK,MAAM,CAKgB;IAC5C;;;MAAgB;CAEvB;;;;;;;0BA1ByB,mCAAmC"}

package/src/engine/animation/curve/actionProcessorOperations/curveActions.d.ts

@@ -1,24 +1,34 @@
 export class keyframesContext {
     /**
      *
-     * @param {AnimationCurve} curve
-     * @param {function} removeKeyframe
-     * @param {function} addKeyframe
-     * @param {Map} keyframeViews
-     * @param {ObservedValue} activeKeyframe
-     * @param {List} selectedKeyframes
-     * @param {function} handleCurveUpdate
-     * @param {function} updateGraph
+     * @param {Object} options
+     * @param {AnimationCurve} options.curve
+     * @param {function} options.removeKeyframe
+     * @param {function} options.addKeyframe
+     * @param {Map} options.keyframeViews
+     * @param {ObservedValue} options.activeKeyframe
+     * @param {List} options.selectedKeyframes
+     * @param {function} options.handleCurveUpdate
+     * @param {function} options.updateGraph
      */
-    constructor({ curve, removeKeyframe, addKeyframe, keyframeViews, activeKeyframe, selectedKeyframes, handleCurveUpdate, updateGraph }: AnimationCurve);
-    refCurve: any;
-    fnRemoveKeyframe: any;
-    fnAddKeyframe: any;
-    refKeyframeViews: any;
-    refActiveKeyframe: any;
-    refSelectionKeyframes: any;
-    fnHandleCurveUpdate: any;
-    fnUpdateGraph: any;
+    constructor({ curve, removeKeyframe, addKeyframe, keyframeViews, activeKeyframe, selectedKeyframes, handleCurveUpdate, updateGraph }: {
+        curve: AnimationCurve;
+        removeKeyframe: Function;
+        addKeyframe: Function;
+        keyframeViews: Map<any, any>;
+        activeKeyframe: ObservedValue;
+        selectedKeyframes: List<any>;
+        handleCurveUpdate: Function;
+        updateGraph: Function;
+    });
+    refCurve: AnimationCurve;
+    fnRemoveKeyframe: Function;
+    fnAddKeyframe: Function;
+    refKeyframeViews: Map<any, any>;
+    refActiveKeyframe: ObservedValue;
+    refSelectionKeyframes: List<any>;
+    fnHandleCurveUpdate: Function;
+    fnUpdateGraph: Function;
 }
 export class RemoveKeyframeAction extends Action<any> {
     /**
@@ -101,7 +111,7 @@ export class SelectionAction extends Action<any> {
     revert(context: any): Promise<void>;
 }
 import { AnimationCurve } from "../AnimationCurve.js";
-import { Action } from "../../../../core/process/undo/Action.js";
 import List from "../../../../core/collection/list/List.js";
+import { Action } from "../../../../core/process/undo/Action.js";
 import { Keyframe } from "../Keyframe.js";
 //# sourceMappingURL=curveActions.d.ts.map

package/src/engine/animation/curve/actionProcessorOperations/curveActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"curveActions.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/actionProcessorOperations/curveActions.js"],"names":[],"mappings":"AAKA;IACI;;;;;;;;;;OAUG;IACH,sIATW,cAAc,EAkBxB;IARG,cAAqB;IACrB,sBAAsC;IACtC,mBAAgC;IAChC,sBAAqC;IACrC,uBAAuC;IACvC,2BAA8C;IAC9C,yBAA4C;IAC5C,mBAAgC;CAEvC;AAED;IACI;;;;;OAKG;IACH,wDAHW,QAAQ,WACR,gBAAgB,EAc1B;IAVG,0BAA2C;IAC3C,0BAAuC;IAEvC,gCAA4B;IAE5B,0BAAsE;IACtE,oCAA0C;IAM9C,mCASC;IAED,oCAMC;CACJ;AAED;IACI;;;;OAIG;IACH,0BAHW,QAAQ,WACR,gBAAgB,EAO1B;IAHG,2BAA4C;IAE5C,gCAA4B;IAGhC,mCAIC;IAED,oCAKC;CACJ;AAED;IACI;;;;;;;OAOG;IACH,iCANW,cAAc,qBACd,cAAc,qBACd,cAAc,mBACd,cAAc,WACd,gBAAgB,EAW1B;IAPG,8BAAsC;IACtC,gCAAkD;IAElD,4BAAkC;IAClC,8BAA8C;IAE9C,gCAA4B;IAGhC,mCAQC;IAED,oCAKC;CACJ;AAED;IACI;;;;;;;OAOG;IACH,0BANW,QAAQ,0BACR,QAAQ,wBACR,QAAQ,0CAER,gBAAgB,EAU1B;IANG,sBAA+B;IAC/B,6BAAwD;IACxD,2BAAoD;IAEpD,gCAA4B;IAC5B,gCAAgD;IAGpD,mCAKC;IAED,oCAKC;CACJ;AAED;IACI;;;;;;OAMG;IACH,uHAFW,gBAAgB,EAU1B;IANG,gCAAiD;IACjD,wBAA8B;IAE9B,4BAAkC;IAElC,gCAA4B;IAGhC,mCAMC;IAED,oCAMC;CACJ;+BAzM4B,sBAAsB;uBAD9B,yCAAyC;iBAG7C,0CAA0C;yBADpC,gBAAgB"}
+{"version":3,"file":"curveActions.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/actionProcessorOperations/curveActions.js"],"names":[],"mappings":"AAKA;IACI;;;;;;;;;;;OAWG;IACH;QATmC,KAAK,EAA7B,cAAc;QACI,cAAc;QACd,WAAW;QAChB,aAAa;QACH,cAAc;QACvB,iBAAiB;QACb,iBAAiB;QACjB,WAAW;OAWvC;IARG,yBAAqB;IACrB,2BAAsC;IACtC,wBAAgC;IAChC,gCAAqC;IACrC,iCAAuC;IACvC,iCAA8C;IAC9C,8BAA4C;IAC5C,wBAAgC;CAEvC;AAED;IACI;;;;;OAKG;IACH,wDAHW,QAAQ,WACR,gBAAgB,EAc1B;IAVG,0BAA2C;IAC3C,0BAAuC;IAEvC,gCAA4B;IAE5B,0BAAsE;IACtE,oCAA0C;IAM9C,mCASC;IAED,oCAMC;CACJ;AAED;IACI;;;;OAIG;IACH,0BAHW,QAAQ,WACR,gBAAgB,EAO1B;IAHG,2BAA4C;IAE5C,gCAA4B;IAGhC,mCAIC;IAED,oCAKC;CACJ;AAED;IACI;;;;;;;OAOG;IACH,iCANW,cAAc,qBACd,cAAc,qBACd,cAAc,mBACd,cAAc,WACd,gBAAgB,EAW1B;IAPG,8BAAsC;IACtC,gCAAkD;IAElD,4BAAkC;IAClC,8BAA8C;IAE9C,gCAA4B;IAGhC,mCAQC;IAED,oCAKC;CACJ;AAED;IACI;;;;;;;OAOG;IACH,0BANW,QAAQ,0BACR,QAAQ,wBACR,QAAQ,0CAER,gBAAgB,EAU1B;IANG,sBAA+B;IAC/B,6BAAwD;IACxD,2BAAoD;IAEpD,gCAA4B;IAC5B,gCAAgD;IAGpD,mCAKC;IAED,oCAKC;CACJ;AAED;IACI;;;;;;OAMG;IACH,uHAFW,gBAAgB,EAU1B;IANG,gCAAiD;IACjD,wBAA8B;IAE9B,4BAAkC;IAElC,gCAA4B;IAGhC,mCAMC;IAED,oCAMC;CACJ;+BA1M4B,sBAAsB;iBAElC,0CAA0C;uBAHtC,yCAAyC;yBAEvC,gBAAgB"}

package/src/engine/animation/curve/actionProcessorOperations/curveActions.js

@@ -6,14 +6,15 @@ import List from "../../../../core/collection/list/List.js";
 export class keyframesContext{
     /**
      *
-     * @param {AnimationCurve} curve
-     * @param {function} removeKeyframe
-     * @param {function} addKeyframe
-     * @param {Map} keyframeViews
-     * @param {ObservedValue} activeKeyframe
-     * @param {List} selectedKeyframes
-     * @param {function} handleCurveUpdate
-     * @param {function} updateGraph
+     * @param {Object} options
+     * @param {AnimationCurve} options.curve
+     * @param {function} options.removeKeyframe
+     * @param {function} options.addKeyframe
+     * @param {Map} options.keyframeViews
+     * @param {ObservedValue} options.activeKeyframe
+     * @param {List} options.selectedKeyframes
+     * @param {function} options.handleCurveUpdate
+     * @param {function} options.updateGraph
      */
     constructor({curve, removeKeyframe, addKeyframe, keyframeViews, activeKeyframe, selectedKeyframes, handleCurveUpdate, updateGraph}) {
         this.refCurve = curve;

package/src/engine/animation/curve/draw/build_plot_entity_from_array.d.ts

@@ -1,14 +1,24 @@
 /**
  *
- * @param {number[]} data
- * @param {number} x
- * @param {number} y
- * @param {number} [width]
- * @param {number} [height]
- * @param {Vector2} [margin]
- * @param {string} [label]
+ * @param {Object} options
+ * @param {number[]} options.data
+ * @param {number} options.x
+ * @param {number} options.y
+ * @param {number} [options.width]
+ * @param {number} [options.height]
+ * @param {Vector2} [options.margin]
+ * @param {string} [options.label]
  * @return {Entity}
  */
-export function build_plot_entity_from_array({ data, x, y, width, height, margin, label }: number[]): Entity;
+export function build_plot_entity_from_array({ data, x, y, width, height, margin, label }: {
+    data: number[];
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    margin?: Vector2;
+    label?: string;
+}): Entity;
+import Vector2 from "../../../../core/geom/Vector2.js";
 import Entity from "../../../ecs/Entity.js";
 //# sourceMappingURL=build_plot_entity_from_array.d.ts.map

package/src/engine/animation/curve/draw/build_plot_entity_from_array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_plot_entity_from_array.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/draw/build_plot_entity_from_array.js"],"names":[],"mappings":"AASA;;;;;;;;;;GAUG;AACH,2FATW,MAAM,EAAE,GAOP,MAAM,CAyCjB;mBAxDkB,wBAAwB"}
+{"version":3,"file":"build_plot_entity_from_array.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/draw/build_plot_entity_from_array.js"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH;IAT6B,IAAI,EAAtB,MAAM,EAAE;IACQ,CAAC,EAAjB,MAAM;IACU,CAAC,EAAjB,MAAM;IACW,KAAK,GAAtB,MAAM;IACW,MAAM,GAAvB,MAAM;IACY,MAAM,GAAxB,OAAO;IACU,KAAK,GAAtB,MAAM;IACL,MAAM,CAyCjB;oBA3DmB,kCAAkC;mBAEnC,wBAAwB"}

package/src/engine/animation/curve/draw/build_plot_entity_from_array.js

@@ -9,13 +9,14 @@ import { canvas2d_plot_data_line } from "../../../graphics/canvas/canvas2d_plot_
 
 /**
  *
- * @param {number[]} data
- * @param {number} x
- * @param {number} y
- * @param {number} [width]
- * @param {number} [height]
- * @param {Vector2} [margin]
- * @param {string} [label]
+ * @param {Object} options
+ * @param {number[]} options.data
+ * @param {number} options.x
+ * @param {number} options.y
+ * @param {number} [options.width]
+ * @param {number} [options.height]
+ * @param {Vector2} [options.margin]
+ * @param {string} [options.label]
  * @return {Entity}
  */
 export function build_plot_entity_from_array({

package/src/engine/animation/curve/editor/CurveEditorView.d.ts

@@ -1,22 +1,33 @@
 export class CurveEditorView extends EmptyView {
     /**
      *
-     * @param {AnimationCurve} curve
-     * @param {Vector2} [size]
-     * @param {Vector2} [margin] How much space to leave empty around the plotted bounds
-     * @param {boolean} [enableEdit]
-     * @param {AABB2} [validEditableBounds]
-     * @param {ActionProcessor} [actionProcessor]
+     * @param {Object} options
+     * @param {AnimationCurve} options.curve
+     * @param {Vector2} [options.size]
+     * @param {Vector2} [options.margin] How much space to leave empty around the plotted bounds
+     * @param {boolean} [options.enableEdit]
+     * @param {AABB2} [options.validEditableBounds]
+     * @param {ActionProcessor} [options.actionProcessor]
      */
-    constructor({ curve, size, margin, enableEdit, validEditableBounds, actionProcessor }: AnimationCurve);
+    constructor({ curve, size, margin, enableEdit, validEditableBounds, actionProcessor }: {
+        curve: AnimationCurve;
+        size?: Vector2;
+        margin?: Vector2;
+        enableEdit?: boolean;
+        validEditableBounds?: AABB2;
+        actionProcessor?: ActionProcessor<any, any>;
+    });
     gridSpacing: number;
     zoomLevel: number;
     curve: AnimationCurve;
-    margin: AnimationCurve;
-    enableEdit: AnimationCurve;
-    validEditableBounds: AnimationCurve;
-    actionProcessor: AnimationCurve;
+    margin: Vector2;
+    enableEdit: boolean;
+    validEditableBounds: AABB2;
+    actionProcessor: ActionProcessor<any, any>;
     build(): void;
 }
 import EmptyView from "../../../../view/elements/EmptyView.js";
+import Vector2 from "../../../../core/geom/Vector2.js";
+import AABB2 from "../../../../core/geom/2d/aabb/AABB2.js";
+import { ActionProcessor } from "../../../../core/process/undo/ActionProcessor.js";
 //# sourceMappingURL=CurveEditorView.d.ts.map

package/src/engine/animation/curve/editor/CurveEditorView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CurveEditorView.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/editor/CurveEditorView.js"],"names":[],"mappings":"AA0CA;IAII;;;;;;;;OAQG;IACH,uGAwBC;IApCD,oBAAiB;IACjB,kBAAc;IA2BV,sBAAkB;IAElB,uBAAoB;IACpB,2BAA4B;IAC5B,oCAA8C;IAC9C,gCAAsC;IAK1C,cA8PC;CACJ;sBA7UqB,wCAAwC"}
+{"version":3,"file":"CurveEditorView.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/editor/CurveEditorView.js"],"names":[],"mappings":"AA0CA;IAII;;;;;;;;;OASG;IACH;QAPmC,KAAK;QACX,IAAI,GAAtB,OAAO;QACW,MAAM,GAAxB,OAAO;QACW,UAAU,GAA5B,OAAO;QACS,mBAAmB,GAAnC,KAAK;QACqB,eAAe;OA0BnD;IArCD,oBAAiB;IACjB,kBAAc;IA4BV,sBAAkB;IAElB,gBAAoB;IACpB,oBAA4B;IAC5B,2BAA8C;IAC9C,2CAAsC;IAK1C,cA8PC;CACJ;sBA9UqB,wCAAwC;oBAH1C,kCAAkC;kBACpC,wCAAwC;gCAC5B,kDAAkD"}

package/src/engine/animation/curve/editor/CurveEditorView.js

@@ -46,12 +46,13 @@ export class CurveEditorView extends EmptyView{
 
     /**
      *
-     * @param {AnimationCurve} curve
-     * @param {Vector2} [size]
-     * @param {Vector2} [margin] How much space to leave empty around the plotted bounds
-     * @param {boolean} [enableEdit]
-     * @param {AABB2} [validEditableBounds]
-     * @param {ActionProcessor} [actionProcessor]
+     * @param {Object} options
+     * @param {AnimationCurve} options.curve
+     * @param {Vector2} [options.size]
+     * @param {Vector2} [options.margin] How much space to leave empty around the plotted bounds
+     * @param {boolean} [options.enableEdit]
+     * @param {AABB2} [options.validEditableBounds]
+     * @param {ActionProcessor} [options.actionProcessor]
      */
     constructor({
                     curve,