@woosh/meep-engine 2.119.100 → 2.119.103

package/src/core/model/node-graph/NodeGraph.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Graph of nodes, implements node-based programming pattern
+ * Notable contemporary examples include:
+ *  * SideFX Houdini
+ *  * Blender - geometry nodes, shaders
+ *  * Unreal Engine - blueprints
+ *  * Grasshopper
+ * @see https://en.wikipedia.org/wiki/Node_graph_architecture
+ */
 export class NodeGraph {
     /**
      * @private
@@ -6,6 +15,7 @@ export class NodeGraph {
      */
     private readonly nodes;
     /**
+     * Flat hierarchy of all connections between nodes
      * @private
      * @readonly
      * @type {List<Connection>}
@@ -28,9 +38,10 @@ export class NodeGraph {
     /**
      * Gets incremented every time structure of the graph changes, meaning nodes or connections are added/removed
      * Unsigned integer value
+     * @readonly
      * @return {number}
      */
-    get version(): number;
+    readonly get version(): number;
     /**
      * @readonly
      */
@@ -107,12 +118,14 @@ export class NodeGraph {
      */
     traverseConnections(visitor: (arg0: Connection) => any, thisArg?: any): void;
     /**
-     * Returns an array of all node instances, note that this array is a copy
+     * Returns an array of all node instances
+     * NOTE: this array is a copy
      * @return {NodeInstance[]}
      */
     getNodes(): NodeInstance[];
     /**
-     * Returns an array of all connections, note that this array is a copy
+     * Returns an array of all connections
+     * NOTE: this array is a copy
      * @return {Connection[]}
      */
     getConnections(): Connection[];
@@ -211,6 +224,11 @@ export class NodeGraph {
      */
     getConnectionsAttachedToNode(id: number, result: number[]): number;
     /**
+     * Useful for type checks
+     * @example
+     *      if(graph.isNodeGraph === true){
+     *          // yep, that's a NodeGraph alright!
+     *      }
      * @readonly
      * @type {boolean}
      */

package/src/core/model/node-graph/NodeGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/node-graph/NodeGraph.js"],"names":[],"mappings":"AASA;IAEI;;;;OAIG;IACH,uBAAmB;IAEnB;;;;OAIG;IACH,6BAAyB;IAEzB;;;;;OAKG;IACH,4BAA0B;IAE1B;;;;;OAKG;IACH,kCAAgC;IAQhC;;;;OAIG;IACH,eAFY,MAAM,CAIjB;IAED;;OAEG;IACH;QACI;;;WAGG;4BADO,MAAM,CAAC,YAAY,EAAC,MAAM,CAAC;QAIrC;;;WAGG;8BADO,MAAM,CAAC,YAAY,EAAC,MAAM,CAAC;QAIrC;;;WAGG;kCADO,MAAM,CAAC,UAAU,EAAC,MAAM,CAAC;QAInC;;;WAGG;oCADO,MAAM,CAAC,UAAU,EAAC,MAAM,CAAC;MAGrC;IAEF;;OAEG;IACH,cAQC;IAED;;;OAGG;IACH,YAFW,SAAS,QAYnB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;;;OAMG;IACH,aAHW,SAAS,GACP;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAe5D;IAED;;;;;;;;OAQG;IACH,sCAJW,YAAY,EAAE,GAEZ;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAmF5D;IAED;;;;OAIG;IACH,uBAHW,CAAS,IAAY,EAAZ,YAAY,KAAE,GAAC,uBAKlC;IAED;;;;OAIG;IACH,6BAHW,CAAS,IAAU,EAAV,UAAU,KAAE,GAAC,uBAKhC;IAED;;;OAGG;IACH,YAFY,YAAY,EAAE,CAIzB;IAED;;;OAGG;IACH,kBAFY,UAAU,EAAE,CAIvB;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CAgBnB;IAED;;;;OAIG;IACH,mCAHW,eAAe,GACb,YAAY,EAAE,CAsB1B;IAED;;;;OAIG;IACH,kCAHW,IAAI,CAAC,eAAe,CAAC,GACnB,YAAY,EAAE,CAqB1B;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,YAAY,GAAC,SAAS,CAkBlC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,YAAY,CAWxB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,UAAU,GAAC,SAAS,CAgBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,WACN,MAAM,GACJ,yBAAyB,GAAC,SAAS,CAY/C;IAED;;;;OAIG;IACH,iBAHW,eAAe,GACb,MAAM,CAclB;IAED;;;OAGG;IACH,cAFW,YAAY,QAkBtB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CA8BnB;IAED;;;;;;;;OAQG;IACH,uCANW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAqClB;IAED;;;;;;;;OAQG;IACH,6BAPW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAuDlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,UACN,MAAM,EAAE,GACN,MAAM,CAyBlB;IAGL;;;OAGG;IACH,sBAFU,OAAO,CAEc;;CAN9B;6BAzpB4B,wBAAwB;2BAD1B,iBAAiB"}
+{"version":3,"file":"NodeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/node-graph/NodeGraph.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH;IAEI;;;;OAIG;IACH,uBAAmB;IAEnB;;;;;OAKG;IACH,6BAAyB;IAEzB;;;;;OAKG;IACH,4BAA0B;IAE1B;;;;;OAKG;IACH,kCAAgC;IAQhC;;;;;OAKG;IACH,wBAFY,MAAM,CAIjB;IAED;;OAEG;IACH;QACI;;;WAGG;4BADO,MAAM,CAAC,YAAY,EAAC,MAAM,CAAC;QAIrC;;;WAGG;8BADO,MAAM,CAAC,YAAY,EAAC,MAAM,CAAC;QAIrC;;;WAGG;kCADO,MAAM,CAAC,UAAU,EAAC,MAAM,CAAC;QAInC;;;WAGG;oCADO,MAAM,CAAC,UAAU,EAAC,MAAM,CAAC;MAGrC;IAEF;;OAEG;IACH,cAQC;IAED;;;OAGG;IACH,YAFW,SAAS,QAYnB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;;;OAMG;IACH,aAHW,SAAS,GACP;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAe5D;IAED;;;;;;;;OAQG;IACH,sCAJW,YAAY,EAAE,GAEZ;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAmF5D;IAED;;;;OAIG;IACH,uBAHW,CAAS,IAAY,EAAZ,YAAY,KAAE,GAAC,uBAKlC;IAED;;;;OAIG;IACH,6BAHW,CAAS,IAAU,EAAV,UAAU,KAAE,GAAC,uBAKhC;IAED;;;;OAIG;IACH,YAFY,YAAY,EAAE,CAIzB;IAED;;;;OAIG;IACH,kBAFY,UAAU,EAAE,CAIvB;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CAgBnB;IAED;;;;OAIG;IACH,mCAHW,eAAe,GACb,YAAY,EAAE,CAsB1B;IAED;;;;OAIG;IACH,kCAHW,IAAI,CAAC,eAAe,CAAC,GACnB,YAAY,EAAE,CAqB1B;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,YAAY,GAAC,SAAS,CAkBlC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,YAAY,CAWxB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,UAAU,GAAC,SAAS,CAgBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,WACN,MAAM,GACJ,yBAAyB,GAAC,SAAS,CAY/C;IAED;;;;OAIG;IACH,iBAHW,eAAe,GACb,MAAM,CAclB;IAED;;;OAGG;IACH,cAFW,YAAY,QAkBtB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CA8BnB;IAED;;;;;;;;OAQG;IACH,uCANW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAqClB;IAED;;;;;;;;OAQG;IACH,6BAPW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAuDlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,UACN,MAAM,EAAE,GACN,MAAM,CAyBlB;IAGL;;;;;;;;OAQG;IACH,sBAFU,OAAO,CAEc;;CAX9B;6BAtqB4B,wBAAwB;2BAD1B,iBAAiB"}

package/src/core/model/node-graph/NodeGraph.js

@@ -7,6 +7,15 @@ import { Connection } from "./Connection.js";
 import { NodeInstance } from "./node/NodeInstance.js";
 import { PortDirection } from "./node/PortDirection.js";
 
+/**
+ * Graph of nodes, implements node-based programming pattern
+ * Notable contemporary examples include:
+ *  * SideFX Houdini
+ *  * Blender - geometry nodes, shaders
+ *  * Unreal Engine - blueprints
+ *  * Grasshopper
+ * @see https://en.wikipedia.org/wiki/Node_graph_architecture
+ */
 export class NodeGraph {
 
     /**
@@ -17,6 +26,7 @@ export class NodeGraph {
     nodes = new List();
 
     /**
+     * Flat hierarchy of all connections between nodes
      * @private
      * @readonly
      * @type {List<Connection>}
@@ -48,6 +58,7 @@ export class NodeGraph {
     /**
      * Gets incremented every time structure of the graph changes, meaning nodes or connections are added/removed
      * Unsigned integer value
+     * @readonly
      * @return {number}
      */
     get version() {
@@ -257,7 +268,8 @@ export class NodeGraph {
     }
 
     /**
-     * Returns an array of all node instances, note that this array is a copy
+     * Returns an array of all node instances
+     * NOTE: this array is a copy
      * @return {NodeInstance[]}
      */
     getNodes() {
@@ -265,7 +277,8 @@ export class NodeGraph {
     }
 
     /**
-     * Returns an array of all connections, note that this array is a copy
+     * Returns an array of all connections
+     * NOTE: this array is a copy
      * @return {Connection[]}
      */
     getConnections() {
@@ -672,6 +685,11 @@ export class NodeGraph {
 }
 
 /**
+ * Useful for type checks
+ * @example
+ *      if(graph.isNodeGraph === true){
+ *          // yep, that's a NodeGraph alright!
+ *      }
  * @readonly
  * @type {boolean}
  */

package/src/core/model/node-graph/node/NodeDescription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeDescription.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/node-graph/node/NodeDescription.js"],"names":[],"mappings":"AAwCA;IACI;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;;;;;OAMG;IACH,IAFU,MAAM,CAEO;IAEvB;;;OAGG;IACH,iBAFU,IAAI,EAAE,CAEL;IAEX;;;OAGG;IACH,YAFU,wBAAwB,EAAE,CAEpB;IAEhB;;OAEG;IACH;QACI;;;WAGG;4BADO,MAAM,CAAC,IAAI,CAAC;QAGtB;;;WAGG;8BADO,MAAM,CAAC,IAAI,CAAC;MAGxB;IAEF;;;;OAIG;IACH,wBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,gBAFa,IAAI,EAAE,CAIlB;IAED;;;OAGG;IACH,eAFa,IAAI,EAAE,CAIlB;IAED;;;;;;OAMG;IACH,sBALW,MAAM,QACN,qBAAqB,iBACrB,MAAM,GAAC,OAAO,GAAC,MAAM,GACnB,MAAM,CA0ClB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,wBAAwB,CAiBpC;IAGD;;;;;;OAMG;IACH,iBALW,QAAQ,2BAER,aAAa,GACX,MAAM,CA2BlB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CAuBnB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,IAAI,GAAC,IAAI,CAgBrB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,EAAE,CAwBjB;IAED;;;;;OAKG;IACH,+BAHW,aAAa,GACZ,OAAO,CAiBlB;IAED;;;;OAIG;IACH,+BAHW,aAAa,GACZ,IAAI,EAAE,CAuBjB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,aACN,aAAa,GACZ,IAAI,GAAC,SAAS,CAmBzB;IAED;;;OAGG;IACH,YAFa,IAAI,EAAE,CAIlB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAYnB;IAED,mBAEC;IAED;;;;MAMC;IAED;;;;;;OAMG;IACH,8BALW,EAAE,YAGF,YAAY,QAUtB;IAKL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAR1C;;;;qBAvaoB,WAAW;yCADS,yCAAyC;mBAH/D,kCAAkC;sCAEf,sCAAsC;8BAG9C,oBAAoB"}
+{"version":3,"file":"NodeDescription.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/node-graph/node/NodeDescription.js"],"names":[],"mappings":"AAwCA;IACI;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;;;;;OAMG;IACH,IAFU,MAAM,CAEO;IAEvB;;;OAGG;IACH,iBAFU,IAAI,EAAE,CAEL;IAEX;;;OAGG;IACH,YAFU,wBAAwB,EAAE,CAEpB;IAEhB;;OAEG;IACH;QACI;;;WAGG;4BADO,MAAM,CAAC,IAAI,CAAC;QAGtB;;;WAGG;8BADO,MAAM,CAAC,IAAI,CAAC;MAGxB;IAEF;;;;OAIG;IACH,wBAFW,YAAY,QAItB;IAED;;;OAGG;IACH,gBAFa,IAAI,EAAE,CAIlB;IAED;;;OAGG;IACH,eAFa,IAAI,EAAE,CAIlB;IAED;;;;;;OAMG;IACH,sBALW,MAAM,QACN,qBAAqB,iBACrB,MAAM,GAAC,OAAO,GAAC,MAAM,GACnB,MAAM,CA0ClB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,wBAAwB,GAAC,IAAI,CAiBzC;IAGD;;;;;;OAMG;IACH,iBALW,QAAQ,2BAER,aAAa,GACX,MAAM,CA2BlB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CAuBnB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,IAAI,GAAC,IAAI,CAgBrB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,IAAI,EAAE,CAwBjB;IAED;;;;;OAKG;IACH,+BAHW,aAAa,GACZ,OAAO,CAiBlB;IAED;;;;OAIG;IACH,+BAHW,aAAa,GACZ,IAAI,EAAE,CAuBjB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,aACN,aAAa,GACZ,IAAI,GAAC,SAAS,CAmBzB;IAED;;;OAGG;IACH,YAFa,IAAI,EAAE,CAIlB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CAYnB;IAED,mBAEC;IAED;;;;MAMC;IAED;;;;;;OAMG;IACH,8BALW,EAAE,YAGF,YAAY,QAUtB;IAKL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAR1C;;;;qBAvaoB,WAAW;yCADS,yCAAyC;mBAH/D,kCAAkC;sCAEf,sCAAsC;8BAG9C,oBAAoB"}

package/src/core/model/node-graph/node/NodeDescription.js

@@ -159,7 +159,7 @@ export class NodeDescription {
     /**
      *
      * @param {number} id
-     * @returns {NodeParameterDescription}
+     * @returns {NodeParameterDescription|null}
      */
     getParameter(id) {
         assert.isNonNegativeInteger(id, 'id');

package/src/core/primitives/strings/string_jaro_distance.d.ts

@@ -1,5 +1,6 @@
 /**
- * Calculate Jaro distance between two strings, this is a measure of string similarity. Higher value means more similarity.
+ * Calculate Jaro distance between two strings, this is a measure of string similarity.
+ * Higher value means more similarity.
  * @param {string} first
  * @param {string} second
  * @param {number} first_length

package/src/core/primitives/strings/string_jaro_distance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string_jaro_distance.d.ts","sourceRoot":"","sources":["../../../../../src/core/primitives/strings/string_jaro_distance.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,4CANW,MAAM,UACN,MAAM,gBACN,MAAM,iBACN,MAAM,GACL,MAAM,CAmBjB"}
+{"version":3,"file":"string_jaro_distance.d.ts","sourceRoot":"","sources":["../../../../../src/core/primitives/strings/string_jaro_distance.js"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,4CANW,MAAM,UACN,MAAM,gBACN,MAAM,iBACN,MAAM,GACL,MAAM,CAsBjB"}

package/src/core/primitives/strings/string_jaro_distance.js

@@ -1,9 +1,11 @@
+import { assert } from "../../assert.js";
 import { BitSet } from "../../binary/BitSet.js";
 import { max2 } from "../../math/max2.js";
 import { min2 } from "../../math/min2.js";
 
 /**
- * Calculate Jaro distance between two strings, this is a measure of string similarity. Higher value means more similarity.
+ * Calculate Jaro distance between two strings, this is a measure of string similarity.
+ * Higher value means more similarity.
  * @param {string} first
  * @param {string} second
  * @param {number} first_length
@@ -14,7 +16,10 @@ export function string_jaro_distance(
     first, second,
     first_length, second_length
 ) {
+    assert.isString(first,'first');
+    assert.isString(second,'second');
 
+    // TODO can do better for short strings under 32 characters by using int32 bitmask. This would avoid allocation entirely
     const matches1 = BitSet.fixedSize(first_length);
     const matches2 = BitSet.fixedSize(second_length);
 

package/src/core/primitives/strings/string_jaro_winkler.d.ts

@@ -2,7 +2,7 @@
  * Calculate the Jaro-Winkler distance between two strings
  * @param {string} first The string to compare
  * @param {string} second The string to compare with
- * @returns {number} similarity score, higher value means strings are more similar
+ * @returns {number} similarity score, higher value means strings are more similar, between 0 and 1
  */
 export function string_jaro_winkler(first: string, second: string): number;
 //# sourceMappingURL=string_jaro_winkler.d.ts.map

package/src/core/primitives/strings/string_jaro_winkler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string_jaro_winkler.d.ts","sourceRoot":"","sources":["../../../../../src/core/primitives/strings/string_jaro_winkler.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,2CAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAwBlB"}
+{"version":3,"file":"string_jaro_winkler.d.ts","sourceRoot":"","sources":["../../../../../src/core/primitives/strings/string_jaro_winkler.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,2CAJW,MAAM,UACN,MAAM,GACJ,MAAM,CA6BlB"}

package/src/core/primitives/strings/string_jaro_winkler.js

@@ -1,3 +1,4 @@
+import { assert } from "../../assert.js";
 import { min3 } from "../../math/min3.js";
 import { string_jaro_distance } from "./string_jaro_distance.js";
 
@@ -5,9 +6,12 @@ import { string_jaro_distance } from "./string_jaro_distance.js";
  * Calculate the Jaro-Winkler distance between two strings
  * @param {string} first The string to compare
  * @param {string} second The string to compare with
- * @returns {number} similarity score, higher value means strings are more similar
+ * @returns {number} similarity score, higher value means strings are more similar, between 0 and 1
  */
 export function string_jaro_winkler(first, second) {
+    assert.isString(first, 'first');
+    assert.isString(second, 'second');
+
     const l1 = first.length;
     const l2 = second.length;
 
@@ -24,20 +28,21 @@ export function string_jaro_winkler(first, second) {
         return 0;
     }
 
-    // Transform to Jaro-Winkler:
-    // Prefix scale gives more favorable ratings to strings that share common prefixes:
+    // Transform to Jaro-Winkler
+    // Prefix scale gives more favorable ratings to strings that share common prefixes
+
     const prefix_scale = 0.1;
     const prefix = getPrefix(first, second, min3(l1, l2, 4));
+
     return similarity + prefix * prefix_scale * (1 - similarity);
 }
 
 /**
- * Counts the number of common characters at the beginning
- * of each word up to a maximum of 4
+ * Counts the number of common characters at the beginning of each word up to a maximum of {@link character_limit}
  * @param {string} a1 The first string to compare
  * @param {string} a2 The second string to compare
  * @param {number} character_limit
- * @returns {number}
+ * @returns {number} number of matching characters from the start of the string, up to limit
  */
 function getPrefix(a1, a2, character_limit) {
 

package/src/core/process/worker/WorkerBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/core/process/worker/WorkerBuilder.js"],"names":[],"mappings":";AAQA;IAEI;;;OAGG;IACH,SAFU,MAAM,EAAE,CAEL;IACb,YAAa;IACb;;;OAGG;IACH,WAFU;QAAC,CAAC,WAAU;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,EAAE,CAEtB;IACf,sBAA6B;IAE7B;;;OAGG;IACH,cAFW,MAAM,QAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,WAAS,MAAM,QAIzB;IAED;;;;;OAKG;IACH,6CAKC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAMhB;IAED;;;OAGG;IACH,SAFa,WAAW,CAyGvB;CACJ;wBAzKuB,8BAA8B;wBAC9B,kBAAkB"}
+{"version":3,"file":"WorkerBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/core/process/worker/WorkerBuilder.js"],"names":[],"mappings":";AAQA;IAEI;;;OAGG;IACH,SAFU,MAAM,EAAE,CAEL;IACb,YAAa;IACb;;;OAGG;IACH,WAFU;QAAC,CAAC,WAAU;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,EAAE,CAEtB;IACf,sBAA6B;IAE7B;;;OAGG;IACH,cAFW,MAAM,QAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,WAAS,MAAM,QAIzB;IAED;;;;;OAKG;IACH,6CAKC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAMhB;IAED;;;OAGG;IACH,SAFa,WAAW,CA2HvB;CACJ;wBA3LuB,8BAA8B;wBAC9B,kBAAkB"}

package/src/core/process/worker/WorkerBuilder.js

@@ -116,6 +116,7 @@ class WorkerBuilder {
 
         //api handler
         Array.prototype.push.apply(codeLines, [
+            //language=js
             `function extractTransferables(obj, result) {
                 if (typeof obj !== "object") {
                     return; //not an object, skip
@@ -133,35 +134,52 @@ class WorkerBuilder {
                     }
                 }
             }`,
-            'globalScope.onmessage = function(event){',
-            '   var eventData = event.data;',
-            '   var requestId = eventData.id',
-            '   var methodName = eventData.methodName;',
-            '   var parameters = eventData.parameters;',
-            '   var method = api[methodName];',
-
-            '   function sendResult(result){',
-            '       var transferables = [];',
-            '       extractTransferables(result, transferables);',
-            '       globalScope.postMessage({methodName: methodName, id: requestId, result: result}, transferables);',
-            '   }',
-
-            '   function sendError(error){',
-            '       let stack = "";',
-            '       try{stack = error.stack.split("\\n")}catch(e){}',
-            '       globalScope.postMessage({methodName: methodName, id: requestId, error: {message: error.message, stack: stack }});',
-            '   }',
-
-            '   if(method === undefined){',
-            '       sendError(new Error("API named \'"+methodName+"\' was not found."));',
-            '   }else{',
-            '       try{',
-            '           method.apply(null,parameters).then(sendResult, sendError);',
-            '       }catch(e){',
-            '           sendError(e);',
-            '       }',
-            '   }',
-            '};'
+            //language=js
+            `globalScope.onmessage = function (event) {
+                const eventData = event.data;
+                const requestId = eventData.id
+                const methodName = eventData.methodName;
+                const parameters = eventData.parameters;
+                const method = api[methodName];
+
+                function sendResult(result) {
+                    const transferables = [];
+                    extractTransferables(result, transferables);
+                    globalScope.postMessage({ methodName: methodName, id: requestId, result: result }, transferables);
+                }
+
+                function sendError(error) {
+                    let stack = "";
+                    try {
+                        stack = error.stack.split("\\n")
+                    } catch (e) {
+                    }
+                    globalScope.postMessage({
+                        methodName: methodName,
+                        id: requestId,
+                        error: { message: error.message, stack: stack }
+                    });
+                }
+
+                if (method === undefined) {
+                    sendError(new Error("API named \'" + methodName + "\' was not found."));
+                } else {
+                    try {
+                        const method_result = method.apply(null, parameters);
+                        
+                        if(typeof method_result.then === "function"){
+                            // thenable
+                            method_result.then(sendResult, sendError);
+                        }else{
+                            // straight value
+                            sendResult(method_result);
+                        }
+                        
+                    } catch (e) {
+                        sendError(e);
+                    }
+                }
+            };`
         ]);
 
         const code = codeLines.join("\n");

package/src/engine/achievements/AchievementGateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AchievementGateway.d.ts","sourceRoot":"","sources":["../../../../src/engine/achievements/AchievementGateway.js"],"names":[],"mappings":"AAAA;;GAEG;AACH;IAKI;;;OAGG;IACH,eAFa,OAAO,CAAC,MAAM,EAAE,CAAC,CAK7B;IAED;;;;OAIG;IACH,iCAGC;CACJ"}
+{"version":3,"file":"AchievementGateway.d.ts","sourceRoot":"","sources":["../../../../src/engine/achievements/AchievementGateway.js"],"names":[],"mappings":"AAAA;;GAEG;AACH;IAEI;;;OAGG;IACH,eAFa,OAAO,CAAC,MAAM,EAAE,CAAC,CAK7B;IAED;;;;OAIG;IACH,iCAGC;CACJ"}

package/src/engine/achievements/AchievementGateway.js

@@ -2,9 +2,6 @@
  * Base class for implementing achievement system API connectors
  */
 export class AchievementGateway {
-    constructor() {
-
-    }
 
     /**
      * Retrieve list of unlocked achievements

package/src/engine/animation/curve/AnimationCurve.d.ts

@@ -1,6 +1,6 @@
 /**
- * Modelled on unity's AnimationCurve
- * @see https://github.com/nothke/ThreadableCurve/blob/master/ThreadableCurve.cs
+ * Describes change of a numeric value over time. Values are stored in {@link Keyframe}s, interpolation is defined by tangents on keyframes
+ * Inspired by unity's AnimationCurve, see https://docs.unity3d.com/ScriptReference/AnimationCurve.html
  */
 export class AnimationCurve {
     /**

package/src/engine/animation/curve/AnimationCurve.js

@@ -20,8 +20,8 @@ function compareKeyframeToTime(time, keyframe) {
 }
 
 /**
- * Modelled on unity's AnimationCurve
- * @see https://github.com/nothke/ThreadableCurve/blob/master/ThreadableCurve.cs
+ * Describes change of a numeric value over time. Values are stored in {@link Keyframe}s, interpolation is defined by tangents on keyframes
+ * Inspired by unity's AnimationCurve, see https://docs.unity3d.com/ScriptReference/AnimationCurve.html
  */
 export class AnimationCurve {
     /**

package/src/engine/animation/curve/Keyframe.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Single keyframe of {@link AnimationCurve}
+ */
 export class Keyframe {
     /**
      *
@@ -19,12 +22,12 @@ export class Keyframe {
      */
     time: number;
     /**
-     * Incoming tangent
+     * Incoming tangent, affects the slope of the curve from previous key
      * @type {number}
      */
     inTangent: number;
     /**
-     * Outgoing tangent
+     * Outgoing tangent, affect the slope of the curve from this key to the next key
      * @type {number}
      */
     outTangent: number;
@@ -70,6 +73,7 @@ export class Keyframe {
         outTangent: any;
     }): void;
     /**
+     * Useful for type checks
      * @readonly
      * @type {boolean}
      */

package/src/engine/animation/curve/Keyframe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Keyframe.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/Keyframe.js"],"names":[],"mappings":"AAGA;IAyBI;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,GACL,QAAQ,CAQnB;IAtCD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,MAAM,CAED;IAkBf;;;;;;OAMG;IACH,UALW,MAAM,SACN,MAAM,aACN,MAAM,cACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAQnB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAOlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAKjB;IAED;;;;;MAOC;IAED;;;;;aAQC;IAIL;;;OAGG;IACH,qBAFU,OAAO,CAEY;CAN5B"}
+{"version":3,"file":"Keyframe.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/Keyframe.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAyBI;;;;;;;OAOG;IACH,kBANW,MAAM,SACN,MAAM,cACN,MAAM,eACN,MAAM,GACL,QAAQ,CAQnB;IAtCD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,MAAM,CAED;IAkBf;;;;;;OAMG;IACH,UALW,MAAM,SACN,MAAM,aACN,MAAM,cACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAQnB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAOlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAKjB;IAED;;;;;MAOC;IAED;;;;;aAQC;IAIL;;;;OAIG;IACH,qBAFU,OAAO,CAEY;CAP5B"}

package/src/engine/animation/curve/Keyframe.js

@@ -1,6 +1,9 @@
 import { assert } from "../../../core/assert.js";
 import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
 
+/**
+ * Single keyframe of {@link AnimationCurve}
+ */
 export class Keyframe {
     /**
      *
@@ -15,13 +18,13 @@ export class Keyframe {
     time = 0;
 
     /**
-     * Incoming tangent
+     * Incoming tangent, affects the slope of the curve from previous key
      * @type {number}
      */
     inTangent = 0;
 
     /**
-     * Outgoing tangent
+     * Outgoing tangent, affect the slope of the curve from this key to the next key
      * @type {number}
      */
     outTangent = 0;
@@ -135,6 +138,7 @@ export class Keyframe {
 }
 
 /**
+ * Useful for type checks
  * @readonly
  * @type {boolean}
  */

package/src/engine/animation/keyed2/AnimationTrack.d.ts

@@ -1,4 +1,8 @@
 export default AnimationTrack;
+/**
+ * Optimize multi-variable animation descriptor
+ * Consider using {@link AnimationCurve} if you're starting a new project as it's simpler to use and is more streamlined
+ */
 declare class AnimationTrack {
     /**
      *

package/src/engine/animation/keyed2/AnimationTrack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationTrack.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/keyed2/AnimationTrack.js"],"names":[],"mappings":";AAGA;IACI;;;;OAIG;IACH,wBAHW,QAAQ,EA0ClB;IAtCG;;;OAGG;IACH,YAFU,QAAQ,CAEU;IAE5B;;;OAGG;IACH,eAFU,MAAM,CAEsB;IAEtC;;;OAGG;IACH,WAFU,MAAM,EAAE,CAEC;IAEnB;;;OAGG;IACH,UAFU,MAAM,EAAE,CAEA;IAElB,kBAAyC;IACzC,gBAAuC;IAEvC;;;OAGG;IACH,gBAFU,MAAM,EAAE,CAEM;IAExB;;;OAGG;IACH,qBAFU,UAAU,CAES;IAGjC,iBAmBC;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAwBlB;IAED;;;;OAIG;IACH,6BAHW,MAAM,sBACN,CAAS,IAAM,EAAN,MAAM,KAAE,MAAM,QAKjC;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACJ,MAAM,CAgBlB;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACJ,MAAM,CA8BlB;IAED;;;;OAIG;IACH,wBAHW,MAAM,UACN,MAAM,EAAE,QAkBlB;CACJ"}
+{"version":3,"file":"AnimationTrack.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/keyed2/AnimationTrack.js"],"names":[],"mappings":";AAGA;;;GAGG;AACH;IACI;;;;OAIG;IACH,wBAHW,QAAQ,EA0ClB;IAtCG;;;OAGG;IACH,YAFU,QAAQ,CAEU;IAE5B;;;OAGG;IACH,eAFU,MAAM,CAEsB;IAEtC;;;OAGG;IACH,WAFU,MAAM,EAAE,CAEC;IAEnB;;;OAGG;IACH,UAFU,MAAM,EAAE,CAEA;IAElB,kBAAyC;IACzC,gBAAuC;IAEvC;;;OAGG;IACH,gBAFU,MAAM,EAAE,CAEM;IAExB;;;OAGG;IACH,qBAFU,UAAU,CAES;IAGjC,iBAmBC;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAwBlB;IAED;;;;OAIG;IACH,6BAHW,MAAM,sBACN,CAAS,IAAM,EAAN,MAAM,KAAE,MAAM,QAKjC;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACJ,MAAM,CAgBlB;IAED;;;;OAIG;IACH,wBAHW,MAAM,GACJ,MAAM,CA8BlB;IAED;;;;OAIG;IACH,wBAHW,MAAM,UACN,MAAM,EAAE,QAkBlB;CACJ"}

package/src/engine/animation/keyed2/AnimationTrack.js

@@ -1,6 +1,10 @@
 import { assert } from "../../../core/assert.js";
 import { isTypedArray } from "../../../core/collection/array/typed/isTypedArray.js";
 
+/**
+ * Optimize multi-variable animation descriptor
+ * Consider using {@link AnimationCurve} if you're starting a new project as it's simpler to use and is more streamlined
+ */
 class AnimationTrack {
     /**
      *

package/src/engine/ecs/gui/position/ViewportPosition.d.ts

@@ -64,7 +64,7 @@ declare class ViewportPosition {
         anchor: any;
         screenEdgeWidth: number;
         stickToScreenEdge: boolean;
-        enabled: any;
+        enabled: boolean;
     };
 }
 declare namespace ViewportPosition {

package/src/engine/ecs/terrain/ecs/Terrain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/Terrain.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/Terrain.js"],"names":[],"mappings":"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"}

package/src/engine/ecs/terrain/ecs/Terrain.js

@@ -34,9 +34,11 @@ import { TerrainFlags } from "./TerrainFlags.js";
 
 let idCounter = 0;
 
+const TILE_SIZE = 7;
+
 class Terrain {
     /**
-     *
+     * @readonly
      * @type {number}
      */
     id = idCounter++;
@@ -1029,7 +1031,5 @@ function mendMissedPoints(points, missIndices) {
 }
 
 
-const TILE_SIZE = 7;
-
 export default Terrain;
 

package/src/engine/grid/transform2grid/Transform2GridPositionMode.js

@@ -3,7 +3,13 @@
  * @enum {number}
  */
 export const Transform2GridPositionMode = {
+    /**
+     * Maps to fractional grid position
+     */
     Continuous: 0,
+    /**
+     * Maps transform to the lowest grid position on each axis (floor operation)
+     */
     Floor: 1,
     Ceil: 2,
     Round: 3

package/src/engine/input/devices/InputDeviceSwitch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputDeviceSwitch.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/InputDeviceSwitch.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IACI;;;OAGG;IACH,MAFU,MAAM,CAEG;IACnB;;;OAGG;IACH,IAFU,MAAM,CAEC;IACjB;;;OAGG;IACH,SAFU,OAAO,CAEF;IAEf,cAOC;IAED,gBAOC;CACJ;mBAvCkB,uCAAuC"}
+{"version":3,"file":"InputDeviceSwitch.d.ts","sourceRoot":"","sources":["../../../../../src/engine/input/devices/InputDeviceSwitch.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IAEI;;;;OAIG;IACH,eAFU,MAAM,CAEG;IAEnB;;;;OAIG;IACH,aAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,SAFU,OAAO,CAEF;IAEf;;;OAGG;IACH,aAFa,OAAO,CAInB;IAED;;;OAGG;IACH,cAOC;IAED;;;OAGG;IACH,gBAOC;CACJ;mBA5DkB,uCAAuC"}

package/src/engine/input/devices/InputDeviceSwitch.js

@@ -1,25 +1,42 @@
 import Signal from "../../../core/events/signal/Signal.js";
 
 /**
- * Representation of an input device key
+ * Representation of an input device key/button
  */
 export class InputDeviceSwitch {
+
     /**
-     * Button press
+     * Switch press
+     * @readonly
      * @type {Signal}
      */
     down = new Signal()
+
     /**
-     * Button release
+     * Switch release
+     * @readonly
      * @type {Signal}
      */
     up = new Signal()
+
     /**
      * is button currently being pressed?
      * @type {boolean}
      */
     is_down = false
 
+    /**
+     * Convenience accessor, dual of {@link is_down}
+     * @returns {boolean}
+     */
+    get is_up() {
+        return !this.is_down;
+    }
+
+    /**
+     * Execute press, will trigger {@link down} signal if previous state was up
+     * Idempotent
+     */
     press() {
         if (this.is_down) {
             return;
@@ -29,6 +46,10 @@ export class InputDeviceSwitch {
         this.down.send0();
     }
 
+    /**
+     * Execute release, will trigger {@link up} signal if previous state was down
+     * Idempotent
+     */
     release() {
         if (!this.is_down) {
             return;

package/src/engine/input/devices/events/eventToSourceIdentifier.d.ts

@@ -1,7 +1,7 @@
 /**
  *
  * @param {TouchEvent|MouseEvent} event
- * @returns {number}
+ * @returns {number} index of touch or mouse button that corresponded to this event, multiplexed with the device ID in MSB area
  */
 export function eventToSourceIdentifier(event: TouchEvent | MouseEvent): number;
 //# sourceMappingURL=eventToSourceIdentifier.d.ts.map

package/src/engine/input/devices/events/eventToSourceIdentifier.js

@@ -1,7 +1,7 @@
 /**
  *
  * @param {TouchEvent|MouseEvent} event
- * @returns {number}
+ * @returns {number} index of touch or mouse button that corresponded to this event, multiplexed with the device ID in MSB area
  */
 export function eventToSourceIdentifier(event) {
     let device_id = 0;

package/src/view/View.js

@@ -351,7 +351,7 @@ class View {
     /**
      *
      * @param {View} child
-     * @returns {View}
+     * @returns {View} this
      */
     addChild(child) {
         assert.defined(child, 'child');