@woosh/meep-engine 2.126.74 → 2.127.0

package/src/core/model/object/objectKeyByValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectKeyByValue.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/objectKeyByValue.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,4DAFa,MAAM,GAAC,SAAS,CAU5B"}
+{"version":3,"file":"objectKeyByValue.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/object/objectKeyByValue.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,4DAFa,MAAM,GAAC,SAAS,CAY5B"}

package/src/core/model/object/objectKeyByValue.js

@@ -1,3 +1,5 @@
+import { assert } from "../../assert.js";
+
 /**
  * Given an object and a value, find the first property with matching value and returns name of that property
  * Useful for working with ENUM-like objects
@@ -7,6 +9,8 @@
  * @returns {string|undefined} name of the property, or undefined if property not found
  */
 export function objectKeyByValue(object, value) {
+    assert.isObject(object, 'object');
+
     for (let i in object) {
         if (object[i] === value) {
             return i;

package/src/engine/asset/Asset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/Asset.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH;IACI;;;;;OAKG;IACH,0CAHW,MAAM,EA2BhB;IAvBG;;;OAGG;IACH,iBAAsB;IAEtB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,cAFU,uBAAuB,CAEX;IAEtB;;;OAGG;IACH,8BAAuB;IAG3B;;;;OAIG;IACH,cAHW,KAAK,GACH,OAAO,CAOnB;IAED,YAEC;IAED;;;OAGG;IACH,YAEC;CACJ"}
+{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/Asset.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH;IACI;;;;;OAKG;IACH,4CAHW,MAAM,EA4BhB;IAvBG;;;OAGG;IACH,mBAAsB;IAEtB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,cAFU,uBAAuB,CAEX;IAEtB;;;OAGG;IACH,8BAAuB;IAG3B;;;;OAIG;IACH,2BAFa,OAAO,CAOnB;IAED,YAEC;IAED;;;OAGG;IACH,UAFa,CAAC,CAIb;CACJ"}

package/src/engine/asset/Asset.js

@@ -1,11 +1,7 @@
 /**
+ * @template T
  *
- * @param {string} path
- * @param {string} type
- * @constructor
  */
-
-
 export class Asset {
     /**
      * @template T
@@ -14,6 +10,7 @@ export class Asset {
      * @constructor
      */
     constructor(factory, byteSize = 0) {
+
         /**
          *
          * @type {function(): T}

package/src/engine/asset/AssetManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/AssetManager.js"],"names":[],"mappings":"AA8CA;;;;GAIG;AACH;IAmII;;;;;OAKG;IACH,oCAJW,GAAG,EAYb;IAhJD;;;;OAIG;IACH,eAEG;IAEH;;;OAGG;IACH,aAFU,YAAY,gBAAgB,EAAE,YAAY,CAAC,CAER;IAe7C;;;;;;OAMG;IACH,kBAFU,MAAM,CAEY;IA4B5B;;;;OAIG;IACH,iBAAc;IAEd;;;OAGG;IACH,mBAFU,iBAAiB,CAEiB;IAwE5C,gBAQC;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,QAAQ,IAAI,CAAC,CAexB;IAED;;;;;OAKG;IACH,oCAFa,OAAO,CAOnB;IAED;;OAEG;IACH,cAEC;IAED,8BAEC;IAED;;;;;;OAMG;IACH,4DAJW,iBAAiB,GAEf,cAAc,CAY1B;IAED;;;;;;;;;OASG;IACH,qFAsCC;IAED;;;;;;;OAOG;IACH,gBAJW,MAAM,QACN,MAAM,GACL,OAAO,CAKlB;IAGD;;;;;;OAMG;IACH,eALW,MAAM,QACN,MAAM,GACJ,OAAO,CAOnB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,QACN,MAAM,GACL,OAAO,CAMlB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,uBAZW,MAAM,QACN,MAAM,gBAEJ,mBAAiB,CAgE7B;IAED;;;;;;;;OAQG;IACH,kBAJW,MAAM,QACN,MAAM,2BAqChB;IAgRD;;;;;OAKG;IACH,sBA2BC;IAGD;;;;OAIG;IACH,uBAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,wBAAY,SAAS,CAMjC;IAaD;;;;;;;;;;OAUG;IACH,+BALW,MAAM,uCAEJ,IAAI,CAqBhB;IAED;;;;;;OAMG;IACH,iCALW,MAAM,uCAEJ,OAAO,CAyBnB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,kCAEJ,QAAQ,OAAO,CAAC,CAU5B;IAED;;;;;OAKG;IACH,0BAJW,MAAM,iEAwChB;IAED;;;OAGG;IACH,uBAFW,MAAM,iBAkBhB;IAED;;;;;;;OAOG;IACH,yCAFa,aAAS,IAAI,CAYzB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,mBAAiB,CAa5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,gBAAgB,GAAC,SAAS,CAQrC;IAED;;;;;OAKG;IACH,mBAJW,MAAM,QACN,MAAM,QACN,MAAM,QAUhB;IAGL;;;OAGG;IACH,yBAFU,OAAO,CAEoB;;CANpC;4BAngC2B,0CAA0C;iCAOrC,uBAAuB;6BAM3B,mBAAmB;kCAFd,6BAA6B;kCAD7B,wBAAwB;4BAE9B,0BAA0B"}
+{"version":3,"file":"AssetManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/AssetManager.js"],"names":[],"mappings":"AA8CA;;;;GAIG;AACH;IAmII;;;;;OAKG;IACH,oCAJW,GAAG,EAYb;IAhJD;;;;OAIG;IACH,eAEG;IAEH;;;OAGG;IACH,aAFU,YAAY,gBAAgB,EAAE,YAAY,CAAC,CAER;IAe7C;;;;;;OAMG;IACH,kBAFU,MAAM,CAEY;IA4B5B;;;;OAIG;IACH,iBAAc;IAEd;;;OAGG;IACH,mBAFU,iBAAiB,CAEiB;IAwE5C,gBAQC;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,QAAQ,IAAI,CAAC,CAexB;IAED;;;;;OAKG;IACH,oCAFa,OAAO,CAOnB;IAED;;OAEG;IACH,cAEC;IAED,8BAEC;IAED;;;;;;OAMG;IACH,4DAJW,iBAAiB,GAEf,cAAc,CAY1B;IAED;;;;;;;;;OASG;IACH,qFAsCC;IAED;;;;;;;OAOG;IACH,gBAJW,MAAM,QACN,MAAM,GACL,OAAO,CAKlB;IAGD;;;;;;OAMG;IACH,eALW,MAAM,QACN,MAAM,GACJ,OAAO,CAOnB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,QACN,MAAM,GACL,OAAO,CAMlB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,uBAZW,MAAM,QACN,MAAM,gBAEJ,mBAAiB,CAgE7B;IAED;;;;;;;;OAQG;IACH,kBAJW,MAAM,QACN,MAAM,2BAqChB;IAiRD;;;;;OAKG;IACH,sBA2BC;IAGD;;;;OAIG;IACH,uBAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,wBAAY,SAAS,CAMjC;IAaD;;;;;;;;;;OAUG;IACH,+BALW,MAAM,uCAEJ,IAAI,CAqBhB;IAED;;;;;;OAMG;IACH,iCALW,MAAM,uCAEJ,OAAO,CAyBnB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,kCAEJ,QAAQ,OAAO,CAAC,CAU5B;IAED;;;;;OAKG;IACH,0BAJW,MAAM,iEAwChB;IAED;;;OAGG;IACH,uBAFW,MAAM,iBAkBhB;IAED;;;;;;;OAOG;IACH,yCAFa,aAAS,IAAI,CAYzB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,mBAAiB,CAa5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,gBAAgB,GAAC,SAAS,CAQrC;IAED;;;;;OAKG;IACH,mBAJW,MAAM,QACN,MAAM,QACN,MAAM,QAUhB;IAGL;;;OAGG;IACH,yBAFU,OAAO,CAEoB;;CANpC;4BApgC2B,0CAA0C;iCAOrC,uBAAuB;6BAM3B,mBAAmB;kCAFd,6BAA6B;kCAD7B,wBAAwB;4BAE9B,0BAA0B"}

package/src/engine/asset/AssetManager.js

@@ -503,6 +503,7 @@ export class AssetManager {
      * @private
      */
     #schedule_response(asset, request) {
+        // technically you can schedule responses just fine, but commonly the user forgets to call 'startup' and so nothing happens which is perceived as a bug.
         assert.equal(this.#is_running, true, 'AssetManager must be running to schedule responses');
 
         this.#response_queue.add(new Response(asset, request));

package/src/engine/asset/AssetTransformer.js

@@ -1,5 +1,5 @@
 /**
- * Applies a transformation to an asset. Such as performing mesh simplification for example.
+ * Applies a transformation to an asset. Such as performing mesh simplification, for example.
  * Transformation is executed by the {@link AssetManager}
  * Useful for modifying/extending post-processing done on various asset types
  * @template {Asset<T>} A

package/src/engine/asset/loaders/image/codec/NativeImageDecoder.d.ts

@@ -1,8 +1,27 @@
 /**
  * Uses the browser's native image decoder
+ * @extends {Codec<{width:number, height:number, data: Uint8Array, itemSize: number, bitDepth:number}>}
  */
-export class NativeImageDecoder extends Codec<any> {
+export class NativeImageDecoder extends Codec<{
+    width: number;
+    height: number;
+    data: Uint8Array;
+    itemSize: number;
+    bitDepth: number;
+}> {
     constructor();
+    /**
+     *
+     * @param {Uint8Array} data
+     * @return {{data: Uint8Array, width: number, height: number, itemSize: number, bitDepth: number}}
+     */
+    decodeSync(data: Uint8Array): {
+        data: Uint8Array;
+        width: number;
+        height: number;
+        itemSize: number;
+        bitDepth: number;
+    };
     decode(data: any): Promise<{
         data: Uint8Array;
         width: number;

package/src/engine/asset/loaders/image/codec/NativeImageDecoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeImageDecoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/NativeImageDecoder.js"],"names":[],"mappings":"AA0BA;;GAEG;AACH;;IACI;;;;;;OA2BC;CACJ;sBA1DqB,YAAY"}
+{"version":3,"file":"NativeImageDecoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/codec/NativeImageDecoder.js"],"names":[],"mappings":"AAyDA;;;GAGG;AACH;WAF0B,MAAM;YAAS,MAAM;UAAQ,UAAU;cAAY,MAAM;cAAW,MAAM;;;IAGhG;;;;OAIG;IACH,iBAHW,UAAU,GACT;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAgBhG;IAED;;;;;;OAiBC;CACJ;sBArGqB,YAAY"}

package/src/engine/asset/loaders/image/codec/NativeImageDecoder.js

@@ -24,36 +24,79 @@ function decode(img) {
     return image_data.data;
 }
 
+/**
+ *
+ * @param {HTMLImageElement} image
+ */
+function make_decoded_data(image) {
+
+    const rgba_data = decode(image);
+
+    const width = image.width;
+    const height = image.height;
+
+    return {
+        data: rgba_data,
+        width: width,
+        height: height,
+        itemSize: 4,
+        bitDepth: 8
+    };
+}
+
+/**
+ * Convert binary data to image URL that we can load.
+ * Don't forget to call `URL.revokeObjectURL(url)` when done
+ * @param {Uint8Array} data
+ * @return {string}
+ */
+function data_to_url(data){
+    const blob = new Blob([data]);
+    return URL.createObjectURL(blob);
+}
+
 /**
  * Uses the browser's native image decoder
+ * @extends {Codec<{width:number, height:number, data: Uint8Array, itemSize: number, bitDepth:number}>}
  */
 export class NativeImageDecoder extends Codec {
+    /**
+     *
+     * @param {Uint8Array} data
+     * @return {{data: Uint8Array, width: number, height: number, itemSize: number, bitDepth: number}}
+     */
+    decodeSync(data) {
+        const image = new Image();
+
+        // convert binary data to image URL that we can load
+        const url = data_to_url(data);
+
+        image.src = url;
+
+        const result = make_decoded_data(image);
+
+        // release resources
+        URL.revokeObjectURL(url);
+
+        return result;
+    }
+
     async decode(data) {
         const image = new Image();
 
         // convert binary data to image URL that we can load
-        const blob = new Blob([data]);
-        const url = URL.createObjectURL(blob);
+        const url = data_to_url(data);
 
         image.src = url;
 
         // give the browser a chance to decode image in async
         await image.decode();
 
-        const rgba_data = decode(image);
-
-        const width = image.width;
-        const height = image.height;
+        const result = make_decoded_data(image);
 
         // release resources
         URL.revokeObjectURL(url);
 
-        return {
-            data: rgba_data,
-            width: width,
-            height: height,
-            itemSize: 4,
-            bitDepth: 8
-        };
+        return result;
     }
 }

package/src/engine/asset/loaders/image/jpeg/JpegFrame.d.ts

@@ -0,0 +1,42 @@
+export class JpegFrame {
+    /**
+     *
+     * @type {boolean}
+     */
+    extended: boolean;
+    /**
+     *
+     * @type {boolean}
+     */
+    progressive: boolean;
+    /**
+     *
+     * @type {number}
+     */
+    precision: number;
+    /**
+     *
+     * @type {number}
+     */
+    scanLines: number;
+    /**
+     *
+     * @type {number}
+     */
+    samplesPerLine: number;
+    maxH: number;
+    maxV: number;
+    mcusPerLine: number;
+    mcusPerColumn: number;
+    /**
+     *
+     * @type {Object<JpegFrameComponent>}
+     */
+    components: any;
+    /**
+     *
+     * @type {number[]}
+     */
+    componentsOrder: number[];
+}
+//# sourceMappingURL=JpegFrame.d.ts.map

package/src/engine/asset/loaders/image/jpeg/JpegFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JpegFrame.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/jpeg/JpegFrame.js"],"names":[],"mappings":"AAAA;IACI;;;OAGG;IACH,UAFU,OAAO,CAEA;IACjB;;;OAGG;IACH,aAFU,OAAO,CAEG;IACpB;;;OAGG;IACH,WAFU,MAAM,CAEF;IACd;;;OAGG;IACH,WAFU,MAAM,CAEF;IACd;;;OAGG;IACH,gBAFU,MAAM,CAEG;IAEnB,aAAS;IACT,aAAS;IAET,oBAAgB;IAChB,sBAAkB;IAElB;;;OAGG;IACH,gBAAgB;IAEhB;;;OAGG;IACH,iBAFU,MAAM,EAAE,CAEG;CACxB"}

package/src/engine/asset/loaders/image/jpeg/JpegFrame.js

@@ -0,0 +1,45 @@
+export class JpegFrame {
+    /**
+     *
+     * @type {boolean}
+     */
+    extended = false;
+    /**
+     *
+     * @type {boolean}
+     */
+    progressive = false;
+    /**
+     *
+     * @type {number}
+     */
+    precision = 8;
+    /**
+     *
+     * @type {number}
+     */
+    scanLines = 0;
+    /**
+     *
+     * @type {number}
+     */
+    samplesPerLine = 0;
+
+    maxH = 0;
+    maxV = 0;
+
+    mcusPerLine = 0;
+    mcusPerColumn = 0;
+
+    /**
+     *
+     * @type {Object<JpegFrameComponent>}
+     */
+    components = {};
+
+    /**
+     *
+     * @type {number[]}
+     */
+    componentsOrder = [];
+}

package/src/engine/asset/loaders/image/jpeg/JpegFrameComponent.d.ts

@@ -0,0 +1,42 @@
+export class JpegFrameComponent {
+    /**
+     *
+     * @type {number}
+     */
+    h: number;
+    /**
+     *
+     * @type {number}
+     */
+    v: number;
+    /**
+     * @type {number}
+     */
+    pred: number;
+    /**
+     * @type {Int32Array[][]}
+     */
+    blocks: Int32Array[][];
+    blocksPerLine: number;
+    blocksPerColumn: number;
+    /**
+     *
+     * @type {number}
+     */
+    quantizationIdx: number;
+    /**
+     * @type {Int32Array}
+     */
+    quantizationTable: Int32Array;
+    /**
+     * @see buildHuffmanTable
+     * @type {[]}
+     */
+    huffmanTableDC: [];
+    /**
+     * @see buildHuffmanTable
+     * @type {[]}
+     */
+    huffmanTableAC: [];
+}
+//# sourceMappingURL=JpegFrameComponent.d.ts.map

package/src/engine/asset/loaders/image/jpeg/JpegFrameComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JpegFrameComponent.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/jpeg/JpegFrameComponent.js"],"names":[],"mappings":"AAAA;IACI;;;OAGG;IACH,GAFU,MAAM,CAEX;IACL;;;OAGG;IACH,GAFU,MAAM,CAEX;IAEL;;OAEG;IACH,MAFU,MAAM,CAER;IAER;;OAEG;IACH,QAFU,UAAU,EAAE,EAAE,CAElB;IAEN,sBAAiB;IACjB,wBAAmB;IAEnB;;;OAGG;IACH,iBAFU,MAAM,CAEG;IAEnB;;OAEG;IACH,mBAFU,UAAU,CAEF;IAElB;;;OAGG;IACH,gBAFU,EAAE,CAEE;IAEd;;;OAGG;IACH,gBAFU,EAAE,CAEE;CACjB"}

package/src/engine/asset/loaders/image/jpeg/JpegFrameComponent.js

@@ -0,0 +1,48 @@
+export class JpegFrameComponent {
+    /**
+     *
+     * @type {number}
+     */
+    h = 0
+    /**
+     *
+     * @type {number}
+     */
+    v = 0
+
+    /**
+     * @type {number}
+     */
+    pred = 0
+
+    /**
+     * @type {Int32Array[][]}
+     */
+    blocks
+
+    blocksPerLine = 0
+    blocksPerColumn = 0
+
+    /**
+     *
+     * @type {number}
+     */
+    quantizationIdx = 0
+
+    /**
+     * @type {Int32Array}
+     */
+    quantizationTable;
+
+    /**
+     * @see buildHuffmanTable
+     * @type {[]}
+     */
+    huffmanTableDC
+
+    /**
+     * @see buildHuffmanTable
+     * @type {[]}
+     */
+    huffmanTableAC
+}

package/src/engine/asset/loaders/image/jpeg/JpegImage.d.ts

@@ -0,0 +1,60 @@
+export class JpegImage {
+    /**
+     *
+     * @param {Uint8Array} data
+     */
+    parse(data: Uint8Array): void;
+    /**
+     *
+     * @type {string[]}
+     */
+    comments: string[];
+    exifBuffer: Uint8Array;
+    width: number;
+    height: number;
+    jfif: {
+        version: {
+            major: number;
+            minor: number;
+        };
+        densityUnits: number;
+        xDensity: number;
+        yDensity: number;
+        thumbWidth: number;
+        thumbHeight: number;
+        thumbData: Uint8Array;
+    };
+    adobe: {
+        version: number;
+        flags0: number;
+        flags1: number;
+        transformCode: number;
+    };
+    /**
+     *
+     * @type {{lines:Uint8Array[], scaleX:number, scaleY:number}[]}
+     */
+    components: {
+        lines: Uint8Array[];
+        scaleX: number;
+        scaleY: number;
+    }[];
+    /**
+     *
+     * @param {number} width
+     * @param {number} height
+     * @return {Uint8Array}
+     */
+    getData(width: number, height: number): Uint8Array;
+    /**
+     *
+     * @param {{data:Uint8Array, width:number, height:number}} imageData
+     * @param {boolean} [formatAsRGBA]
+     */
+    copyToImageData(imageData: {
+        data: Uint8Array;
+        width: number;
+        height: number;
+    }, formatAsRGBA?: boolean): void;
+}
+//# sourceMappingURL=JpegImage.d.ts.map

package/src/engine/asset/loaders/image/jpeg/JpegImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JpegImage.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/jpeg/JpegImage.js"],"names":[],"mappings":"AA0CA;IAEI;;;OAGG;IACH,YAFW,UAAU,QA8WpB;IAxRG;;;OAGG;IACH,UAFU,MAAM,EAAE,CAEA;IA0DE,uBAAqD;IAuMzE,cAAiC;IACjC,eAA6B;IAC7B;;;;;;;;;;;MAAgB;IAChB;;;;;MAAkB;IAElB;;;OAGG;IACH,YAFU;QAAC,KAAK,EAAC,UAAU,EAAE,CAAC;QAAC,MAAM,EAAC,MAAM,CAAC;QAAC,MAAM,EAAC,MAAM,CAAA;KAAC,EAAE,CAE1C;IAYxB;;;;;OAKG;IACH,eAJW,MAAM,UACN,MAAM,GACL,UAAU,CAuIrB;IAED;;;;OAIG;IACH;cAHiB,UAAU;eAAQ,MAAM;gBAAS,MAAM;sBAC7C,OAAO,QA+DjB;CACJ"}