@woosh/meep-engine 2.119.129 → 2.119.131

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.119.129",
+  "version": "2.119.131",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/bvh2/bvh3/ebvh_optimize_treelet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ebvh_optimize_treelet.d.ts","sourceRoot":"","sources":["../../../../../src/core/bvh2/bvh3/ebvh_optimize_treelet.js"],"names":[],"mappings":"AAoNA;;;;;;;GAOG;AACH,2CAJW,GAAG,QACH,MAAM,iBACN,MAAM,QA0IhB"}
+{"version":3,"file":"ebvh_optimize_treelet.d.ts","sourceRoot":"","sources":["../../../../../src/core/bvh2/bvh3/ebvh_optimize_treelet.js"],"names":[],"mappings":"AAgNA;;;;;;;GAOG;AACH,2CAJW,GAAG,QACH,MAAM,iBACN,MAAM,QA0IhB"}

package/src/core/bvh2/bvh3/ebvh_optimize_treelet.js

@@ -85,13 +85,9 @@ function optimize_treelet(bvh, root, leaves, leaf_count) {
 
     // Initialize costs of individual leaves
     for (let i = 0; i < leaf_count; i++) {
-        // TODO implement a full cost heuristic
         const leaf = leaves[i];
 
-        // we use height, which is available, as a proxy for triangle count
-        const triangle_count = bvh.node_get_height(leaf);
-
-        scratch_cost[1 << i] = SAH_COST_TRIANGLE * bvh.node_get_surface_area(leaf) * triangle_count;
+        scratch_cost[1 << i] = SAH_COST_TRIANGLE * bvh.node_get_surface_area(leaf) ;
     }
 
     // Optimize every subset of leaves

package/src/core/math/factorial.d.ts

@@ -1,6 +1,9 @@
 /**
- * Compute factorial of X
- * @param {number} x
+ * Compute factorial of X (X!)
+ * Note that factorial of 13 is already 6,227,020,800 which exceeds 32bit integer limit
+ * Note that this implementation is intended for small inputs only
+ * @example factorial(5) == 5 * 4 * 3 * 2 * 1 == 120
+ * @param {number} x must be an integer
  * @return {number}
  */
 export function factorial(x: number): number;

package/src/core/math/factorial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factorial.d.ts","sourceRoot":"","sources":["../../../../src/core/math/factorial.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,6BAHW,MAAM,GACL,MAAM,CAWjB"}
+{"version":3,"file":"factorial.d.ts","sourceRoot":"","sources":["../../../../src/core/math/factorial.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,6BAHW,MAAM,GACL,MAAM,CAejB"}

package/src/core/math/factorial.js

@@ -1,10 +1,17 @@
 /**
- * Compute factorial of X
- * @param {number} x
+ * Compute factorial of X (X!)
+ * Note that factorial of 13 is already 6,227,020,800 which exceeds 32bit integer limit
+ * Note that this implementation is intended for small inputs only
+ * @example factorial(5) == 5 * 4 * 3 * 2 * 1 == 120
+ * @param {number} x must be an integer
  * @return {number}
  */
 export function factorial(x) {
 
+    // NOTE: implementation is naive and pretty slow, consider following for improvements:
+    // * http://www.luschny.de/math/factorial/FastFactorialFunctions.htm
+    // * https://stackoverflow.com/questions/1751334/fast-algorithms-for-computing-the-factorial
+
     let result = 1;
 
     for (let i = x; i > 0; --i) {

package/src/core/math/solveQuadratic.d.ts

@@ -1,5 +1,7 @@
 /**
- * Return solutions for a quadratic equation
+ * Return solutions for a quadratic polynomial: ax² + bx + c
+ * Typically there will be 2 solution, in some cases we will have 0, having 1 solution is impossible
+ * This solver only deals with real numbers, so imaginary solution are not provided. In case solution would be imaginary - we return 0 roots
  * @param {number} a
  * @param {number} b
  * @param {number} c

package/src/core/math/solveQuadratic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solveQuadratic.d.ts","sourceRoot":"","sources":["../../../../src/core/math/solveQuadratic.js"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,uCAJW,MAAM,EAAE,iBACR,MAAM,KAJN,MAAM,KACN,MAAM,KACN,MAAM,GAGJ,MAAM,CAoDlB"}
+{"version":3,"file":"solveQuadratic.d.ts","sourceRoot":"","sources":["../../../../src/core/math/solveQuadratic.js"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,uCAJW,MAAM,EAAE,iBACR,MAAM,KAJN,MAAM,KACN,MAAM,KACN,MAAM,GAGJ,MAAM,CAsDlB"}

package/src/core/math/solveQuadratic.js

@@ -2,7 +2,9 @@ import { assert } from "../assert.js";
 import { EPSILON } from "./EPSILON.js";
 
 /**
- * Return solutions for a quadratic equation
+ * Return solutions for a quadratic polynomial: ax² + bx + c
+ * Typically there will be 2 solution, in some cases we will have 0, having 1 solution is impossible
+ * This solver only deals with real numbers, so imaginary solution are not provided. In case solution would be imaginary - we return 0 roots
  * @param {number} a
  * @param {number} b
  * @param {number} c
@@ -47,6 +49,8 @@ export function solveQuadratic(
         const disc_sqr = b * b - 4 * a * c;
 
         if (disc_sqr >= 0) {
+            // if discriminant square is negative, solution can only be imaginary, we don't deal with that
+
             const disc = Math.sqrt(disc_sqr);
             const a2 = 2 * a;
 

package/src/engine/ecs/transform/Transform.d.ts

@@ -161,6 +161,11 @@ export class Transform {
      *      - scale:    [1,1,1]
      */
     makeIdentity(): void;
+    /**
+     * Identity Transform is where position is 0, rotation is 0 (un-rotated) and scale is 1
+     * @returns {boolean}
+     */
+    isIdentity(): boolean;
     toString(): string;
     /**
      * @readonly

package/src/engine/ecs/transform/Transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;GAGG;AACH;IAwQI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAuDD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IArWD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;OAGG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IA4BD;;;;OAIG;IACH,sBAHW,SAAS,KACT,SAAS,QAMnB;IAED;;;OAGG;IACH,oBAFW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,QAgBpC;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBA/XI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;GAGG;AACH;IAwQI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAiED;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IA/WD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;OAGG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IA4BD;;;;OAIG;IACH,sBAHW,SAAS,KACT,SAAS,QAMnB;IAED;;;OAGG;IACH,oBAFW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,QAgBpC;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA2BL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAZ9B;;kBAIS,MAAM;;oBAzYI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}

package/src/engine/ecs/transform/Transform.js

@@ -363,6 +363,16 @@ export class Transform {
         this.fromMatrix4(MATRIX_4_IDENTITY);
     }
 
+    /**
+     * Identity Transform is where position is 0, rotation is 0 (un-rotated) and scale is 1
+     * @returns {boolean}
+     */
+    isIdentity() {
+        return this.position.equals(Vector3.zero)
+            && this.rotation.equals(Quaternion.identity)
+            && this.scale.equals(Vector3.one);
+    }
+
     toString() {
         return `{ position: ${this.position}, rotation: ${this.rotation}, scale: ${this.scale} }`;
     }

package/src/view/elements/EmptyView.d.ts

@@ -1,5 +1,15 @@
 export default EmptyView;
 declare class EmptyView extends View<HTMLElement> {
+    /**
+     *
+     * @param {string[]} [classList]
+     * @param {Object<string>} [css]
+     * @param {Object} [attr]
+     * @param {Element} [el]
+     * @param {string} [tag]
+     * @returns {EmptyView}
+     */
+    static absolute({ classList, css, attr, el, tag }?: string[]): EmptyView;
     /**
      *
      * @param {View[]} elements

package/src/view/elements/EmptyView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyView.d.ts","sourceRoot":"","sources":["../../../../src/view/elements/EmptyView.js"],"names":[],"mappings":";AAEA;IAiCI;;;;;OAKG;IACH,uBAJW,IAAI,EAAE,YACN;QAAC,SAAS,EAAC,MAAM,EAAE,CAAC;QAAA,GAAG,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,EAAE,CAAA;KAAC,GACrC,SAAS,CAQpB;IAED,2BAEC;IAhDD;;;;;;;;;OASG;IACH,8DATW,MAAM,EAAE,EA6BlB;IAhBO,QAAY;CAmCvB;iBApDgB,YAAY"}
+{"version":3,"file":"EmptyView.d.ts","sourceRoot":"","sources":["../../../../src/view/elements/EmptyView.js"],"names":[],"mappings":";AAGA;IAyCI;;;;;;;;OAQG;IACH,oDAPW,MAAM,EAAE,GAKN,SAAS,CAoBrB;IAED;;;;;OAKG;IACH,uBAJW,IAAI,EAAE,YACN;QAAC,SAAS,EAAC,MAAM,EAAE,CAAC;QAAA,GAAG,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,EAAE,CAAA;KAAC,GACrC,SAAS,CAQpB;IAED,2BAEC;IArFD;;;;;;;;;OASG;IACH,8DATW,MAAM,EAAE,EAqClB;IAhBO,QAAY;CAgEvB;iBAzFgB,YAAY"}

package/src/view/elements/EmptyView.js

@@ -1,3 +1,4 @@
+import { CSS_ABSOLUTE_POSITIONING } from "../CSS_ABSOLUTE_POSITIONING.js";
 import View from "../View.js";
 
 class EmptyView extends View {
@@ -11,7 +12,15 @@ class EmptyView extends View {
      * @extends {View}
      * @constructor
      */
-    constructor({ classList = [], el, tag = 'div', tagNamespace = undefined, css, attr } = {}) {
+    constructor({
+                    classList = [],
+                    el,
+                    tag = 'div',
+                    tagNamespace = undefined,
+                    css,
+                    attr
+    } = {}) {
+
         super();
 
         if (el !== undefined) {
@@ -33,6 +42,35 @@ class EmptyView extends View {
         }
     }
 
+    /**
+     *
+     * @param {string[]} [classList]
+     * @param {Object<string>} [css]
+     * @param {Object} [attr]
+     * @param {Element} [el]
+     * @param {string} [tag]
+     * @returns {EmptyView}
+     */
+    static absolute({
+                        classList=[],
+                        css,
+                        attr,
+                        el,
+                        tag
+    } = {}) {
+
+        return new EmptyView({
+            classList,
+            css: {
+                css,
+                ...CSS_ABSOLUTE_POSITIONING
+            },
+            attr,
+            el,
+            tag
+        });
+    }
+
     /**
      *
      * @param {View[]} elements