@woosh/meep-engine 2.113.15 → 2.114.0

package/build/meep.module.js

@@ -53731,7 +53731,7 @@ class Color {
         this.b = b;
 
         /**
-         * Alpha channel
+         * Alpha channel (transparency)
          * Value from 0 to 1
          * @type {number}
          */
@@ -54228,6 +54228,20 @@ class Color {
         return destination;
     }
 
+    /**
+     *
+     * @param {number[]|Float32Array} source
+     * @param {number} [offset]
+     */
+    fromArray(source, offset = 0) {
+        const r = source[offset + 0];
+        const g = source[offset + 1];
+        const b = source[offset + 2];
+        const a = source[offset + 3];
+
+        this.set(r, g, b, a);
+    }
+
 
     /**
      *
@@ -54343,7 +54357,7 @@ class Color {
 }
 
 /**
- * Shortcut
+ * @deprecated use {@link Color#toArray} instead
  * @readonly
  */
 Color.prototype.writeToArray = Color.prototype.toArray;
@@ -106382,6 +106396,7 @@ function computeBinaryDataTypeByPrecision(type, precision) {
 const stack$1 = [];
 
 /**
+ * Quicksort implementation, instead of compare operator, uses scoring function
  * @template T
  * @param {T[]|ArrayLike<number>|Uint32Array} data
  * @param {function(T):number} score_function
@@ -106391,12 +106406,13 @@ const stack$1 = [];
  * @param {function(T[],number, number):*} [swap_operator]
  * @param {*} [swap_context]
  */
-function arrayQuickSort(
+function array_sort_quick(
     data,
     score_function, score_function_context,
     start = 0, end = data.length - 1,
     swap_operator = array_swap_one, swap_context = undefined
 ) {
+
     if (start >= end) {
         // section of 0 size, nothing to sort
         return;
@@ -111337,7 +111353,7 @@ class LightManager {
         array_copy(visible_light_set.elements, 0, sorted_lights, 0, visible_light_count);
         array_copy(visible_decal_set.elements, 0, sorted_lights, visible_light_count, visible_decal_count);
 
-        arrayQuickSort(sorted_lights, this.__sort_visible_light_score, this, 0, expected_sorted_size - 1);
+        array_sort_quick(sorted_lights, this.__sort_visible_light_score, this, 0, expected_sorted_size - 1);
     }
 
     __update_visible_bvh() {

package/package.json

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

package/src/core/collection/array/array_filter_by_multiple.d.ts

@@ -1,4 +1,6 @@
 /**
+ * Similar to standard {@link Array.prototype.filter}, but allows multiple filters. They work as an "AND".
+ * Useful to save allocations when multiple filters need to be applied, as the {@link Array.prototype.filter} allocates a new array for each call
  * @template T
  * @param {T[]} input_items
  * @param {((T)=>boolean)[]} filters

package/src/core/collection/array/array_filter_by_multiple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array_filter_by_multiple.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_filter_by_multiple.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oFAHiB,OAAO,UAgCvB"}
+{"version":3,"file":"array_filter_by_multiple.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_filter_by_multiple.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,oFAHiB,OAAO,UAqCvB"}

package/src/core/collection/array/array_filter_by_multiple.js

@@ -1,4 +1,6 @@
 /**
+ * Similar to standard {@link Array.prototype.filter}, but allows multiple filters. They work as an "AND".
+ * Useful to save allocations when multiple filters need to be applied, as the {@link Array.prototype.filter} allocates a new array for each call
  * @template T
  * @param {T[]} input_items
  * @param {((T)=>boolean)[]} filters
@@ -13,23 +15,28 @@ export function array_filter_by_multiple(input_items, filters) {
         return input_items;
     }
 
+    /**
+     *
+     * @type {T[]}
+     */
     const filtered = [];
 
     const input_item_count = input_items.length;
 
-
     main_loop:for (let i = 0; i < input_item_count; i++) {
-        const d = input_items[i];
+        const datum = input_items[i];
+
         for (let j = 0; j < filter_count; j++) {
             const filter = filters[j];
 
-            if (filter(d) === false) {
+            if (filter(datum) === false) {
+                // filter rejected, let's move onto next element
                 continue main_loop;
             }
         }
 
         // filters passed
-        filtered.push(d);
+        filtered.push(datum);
     }
 
     return filtered;

package/src/core/collection/array/array_group_by.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @template T,K
+ * @param {T[]} array
+ * @param {function(T):K} grouping_key_producer given an element from input array, returns a grouping key. Can be an object, if it implements .equals method keys can be compared that way as well
+ * @param keyHashFunction
+ * @returns {Map<K,T[]>}
+ */
+export function array_group_by<T, K>(array: T[], grouping_key_producer: (arg0: T) => K, keyHashFunction?: typeof returnZero): Map<K, T[]>;
+import { returnZero } from "../../function/returnZero.js";
+//# sourceMappingURL=array_group_by.d.ts.map

package/src/core/collection/array/array_group_by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array_group_by.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_group_by.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,0IA+BC;2BAzC0B,8BAA8B"}

package/src/core/collection/array/{groupArrayBy.js → array_group_by.js}

@@ -4,11 +4,11 @@ import { HashMap } from "../map/HashMap.js";
 /**
  * @template T,K
  * @param {T[]} array
- * @param {function(T):K} groupingFunction
+ * @param {function(T):K} grouping_key_producer given an element from input array, returns a grouping key. Can be an object, if it implements .equals method keys can be compared that way as well
  * @param keyHashFunction
  * @returns {Map<K,T[]>}
  */
-export function groupArrayBy(array, groupingFunction, keyHashFunction = returnZero) {
+export function array_group_by(array, grouping_key_producer, keyHashFunction = returnZero) {
     const result = new HashMap({
         keyHashFunction,
         keyEqualityFunction(a, b) {
@@ -27,7 +27,7 @@ export function groupArrayBy(array, groupingFunction, keyHashFunction = returnZe
     for (let i = 0; i < array.length; i++) {
         const element = array[i];
 
-        const groupKey = groupingFunction(element);
+        const groupKey = grouping_key_producer(element);
 
         const group = result.get(groupKey);
 

package/src/core/collection/array/array_sort_quick.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Quicksort implementation, instead of compare operator, uses scoring function
+ * @template T
+ * @param {T[]|ArrayLike<number>|Uint32Array} data
+ * @param {function(T):number} score_function
+ * @param {*} [score_function_context]
+ * @param {number} [start]
+ * @param {number} [end]
+ * @param {function(T[],number, number):*} [swap_operator]
+ * @param {*} [swap_context]
+ */
+export function array_sort_quick<T>(data: ArrayLike<number> | Uint32Array | T[], score_function: (arg0: T) => number, score_function_context?: any, start?: number, end?: number, swap_operator?: (arg0: T[], arg1: number, arg2: number) => any, swap_context?: any): void;
+//# sourceMappingURL=array_sort_quick.d.ts.map

package/src/core/collection/array/array_sort_quick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array_sort_quick.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_sort_quick.js"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,8GAPuB,MAAM,wCAElB,MAAM,QACN,MAAM,oCACO,MAAM,QAAE,MAAM,oCAmErC"}

package/src/core/collection/array/{arrayQuickSort.js → array_sort_quick.js}

@@ -1,8 +1,10 @@
+import { assert } from "../../assert.js";
 import { array_swap_one } from "./array_swap_one.js";
 
 const stack = [];
 
 /**
+ * Quicksort implementation, instead of compare operator, uses scoring function
  * @template T
  * @param {T[]|ArrayLike<number>|Uint32Array} data
  * @param {function(T):number} score_function
@@ -12,12 +14,14 @@ const stack = [];
  * @param {function(T[],number, number):*} [swap_operator]
  * @param {*} [swap_context]
  */
-export function arrayQuickSort(
+export function array_sort_quick(
     data,
     score_function, score_function_context,
     start = 0, end = data.length - 1,
     swap_operator = array_swap_one, swap_context = undefined
 ) {
+    assert.isFunction(score_function, 'score_function');
+
     if (start >= end) {
         // section of 0 size, nothing to sort
         return;

package/src/core/collection/table/RowFirstTable.d.ts

@@ -85,9 +85,9 @@ export class RowFirstTable {
     trim(): void;
     /**
      *
-     * @param {number} rowCount
+     * @param {number} row_count
      */
-    resize(rowCount: number): void;
+    resize(row_count: number): void;
     /**
      *
      * @param {number} row_index

package/src/core/collection/table/RowFirstTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAaA;;;;GAIG;AACH;IACI;;;;;OAKG;IACH,oDAHW,OAAO,EAiDjB;IAzCG;;;OAGG;IACH,wBAAgB;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,QAFU,MAAM,CAED;IAEf;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;OAGG;IACH,8BAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;;OAGG;IACH,4BAFqB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAIrD;IAED;;;OAGG;IACH,6BAFqB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAIrD;IAGD;;;;OAIG;IACH,uDAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA+BlB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAED;;;OAGG;IACH,iBAFW,MAAM,QAchB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAUlB;IAED;;;;OAIG;IACH,eAHW,MAAM,4BA8ChB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAED;;;;OAIG;IACH,YAFW,aAAa,QAmBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAmCnB;IAED;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;OAGG;IACH,iBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;OAEG;IACH,uBAIC;IAED;;OAEG;IACH,mBAEC;IAGL;;OAEG;IACH,gBAtHe,MAAM,WACN,MAAM,EAAE,KACN,MAAM,EAAE,CAoHK;IAC9B;;OAEG;IACH,gBA1Ge,MAAM,UACN,MAAM,EAAE,UAyGO;CAT7B;mBAtnBkB,+BAA+B"}
+{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AA+BA;;;;GAIG;AACH;IACI;;;;;OAKG;IACH,oDAHW,OAAO,EAiDjB;IAzCG;;;OAGG;IACH,wBAAgB;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,QAFU,MAAM,CAED;IAEf;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;OAGG;IACH,8BAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;;OAGG;IACH,4BAFqB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAIrD;IAED;;;OAGG;IACH,6BAFqB,QAAQ,QAAE,MAAM,QAAE,MAAM,EAAE,KAAG,IAAI,CAIrD;IAGD;;;;OAIG;IACH,uDAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA+BlB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAUlB;IAED;;;;OAIG;IACH,eAHW,MAAM,4BA8ChB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAED;;;;OAIG;IACH,YAFW,aAAa,QAmBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAmCnB;IAED;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;OAGG;IACH,iBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;OAEG;IACH,uBAIC;IAED;;OAEG;IACH,mBAEC;IAGL;;OAEG;IACH,gBAtHe,MAAM,WACN,MAAM,EAAE,KACN,MAAM,EAAE,CAoHK;IAC9B;;OAEG;IACH,gBA1Ge,MAAM,UACN,MAAM,EAAE,UAyGO;CAT7B;mBAhpBkB,+BAA+B"}

package/src/core/collection/table/RowFirstTable.js

@@ -11,8 +11,22 @@ import { array_buffer_copy } from "../array/typed/array_buffer_copy.js";
  */
 const DEFAULT_CAPACITY = 8;
 
+/**
+ * Must be greater than 1
+ * @type {number}
+ */
 const ALLOCATION_GROW_FACTOR = 1.5;
 
+/**
+ * Minimum number of rows to add when growing
+ * @type {number}
+ */
+const ALLOCATION_GROW_MINIMUM_STEP = 32;
+
+/**
+ * Must be less than 1 and greater than 0
+ * @type {number}
+ */
 const ALLOCATION_SHRINK_FACTOR = 0.5;
 
 /**
@@ -217,18 +231,26 @@ export class RowFirstTable {
 
     /**
      *
-     * @param {number} rowCount
+     * @param {number} row_count
      */
-    resize(rowCount) {
-        assert.isNonNegativeInteger(rowCount, 'rowCount');
+    resize(row_count) {
+        assert.isNonNegativeInteger(row_count, 'row_count');
+
+        if (this.capacity < row_count) {
 
-        if (this.capacity < rowCount) {
             //grow
-            const newSize = Math.ceil(rowCount * ALLOCATION_GROW_FACTOR);
-            this.setCapacity(newSize);
-        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > rowCount) {
+            const new_size = Math.max(
+                Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
+                row_count + ALLOCATION_GROW_MINIMUM_STEP
+            );
+
+            this.setCapacity(new_size);
+
+        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > row_count) {
+
             //shrink
-            this.setCapacity(rowCount);
+            this.setCapacity(row_count);
+
         }
 
     }

package/src/core/color/Color.d.ts

@@ -12,6 +12,8 @@ export class Color {
 
     parse(text: string): void
 
+    set(r: number, g: number, b: number, a: number): void;
+
     setRGB(r: number, g: number, b: number): void
 
     setA(a: number): void
@@ -42,5 +44,7 @@ export class Color {
 
     toJSON(): any
 
-    writeToArray(destination: ArrayLike<number>, destination_offset: number): void
+    fromArray(source: ArrayLike<number>, destination_offset?: number): void
+
+    toArray<T extends ArrayLike<number>>(destination?: T, destination_offset?: number): T
 }

package/src/core/color/Color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../../src/core/color/Color.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../../src/core/color/Color.js"],"names":[],"mappings":"AAkBA;;;GAGG;AACH;IAumBI;;;;;;OAMG;IACH,kBALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,KAAK,CAIjB;IAED;;;;;;OAMG;IACH,kBALW,MAAM,KACN,MAAM,KACN,MAAM,GACL,KAAK,CAQhB;IAGD;;;;OAIG;IACH,kBAHW,MAAM,GACL,KAAK,CAQhB;IAED;;;;OAIG;IACH,kCAHW,KAAK,UACL,KAAK,QAIf;IAED;;;;OAIG;IACH,kCAHW,KAAK,UACL,KAAK,QAIf;IA9pBD;;;;;;OAMG;IACH,gBALW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,EAuChB;IA/BG;;;;OAIG;IACH,GAFU,MAAM,CAEN;IACV;;;;OAIG;IACH,GAFU,MAAM,CAEN;IACV;;;;OAIG;IACH,GAFU,MAAM,CAEN;IAEV;;;;OAIG;IACH,GAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,oBAFU,OAAO,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,CAAC,CAE5C;IAWjC;;;OAGG;IACH,mBAEC;IAdD;;;OAGG;IACH,gBAEC;IAkBD;;;OAGG;IACH,mBAEC;IAdD;;;OAGG;IACH,gBAEC;IAkBD;;;OAGG;IACH,mBAEC;IAdD;;;OAGG;IACH,gBAEC;IAkBD;;;OAGG;IACH,mBAEC;IAdD;;;OAGG;IACH,gBAEC;IAUD;;;OAGG;IACH,qBAEC;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,KACN,MAAM,QAKhB;IAED;;;;;OAKG;IACH,eAJW,MAAM,KACN,MAAM,KACN,MAAM,QAQhB;IAED;;;OAGG;IACH,QAFW,MAAM,QAIhB;IAED;;;;;;OAMG;IACH,OALW,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAyChB;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,KACN,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,KACN,MAAM,QAqDhB;IAED;;;;;;;OAOG;IACH,UALW,MAAM,KACN,MAAM,KACN,MAAM,QAyDhB;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,KACN,MAAM,QA6ChB;IAED;;;OAGG;IACH,oBAFY,MAAM,CAIjB;IAED;;;;MAMC;IAED;;;OAGG;IACH,UAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,YAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,gBAFW,MAAM,QAUhB;IAED;;;;OAIG;IACH,SAFa,MAAM,CAQlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,cAFW,KAAK,WAOf;IAED;;;OAGG;IACH,YAFW,KAAK,QAKf;IAED;;;OAGG;IACH,SAFa,KAAK,CAQjB;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;;;;aAEC;IAED;;;;;MAOC;IAWD;;;;;OAKG;IACH,sBAJW,MAAM,EAAE,uBACR,MAAM,GACJ,MAAM,EAAE,CASpB;IAED;;;;OAIG;IACH,kBAHW,MAAM,EAAE,GAAC,YAAY,WACrB,MAAM,QAShB;IAGD;;;OAGG;IACH,2CAKC;IAED;;;OAGG;IACH,6CAOC;IAED;;;;OAIG;IACH,WAHW,MAAM,GACJ,IAAI,CAYhB;IAED;;;;;OAKG;IACH,cAJW,KAAK,KACL,KAAK,KACL,MAAM,QAOhB;IA6DL;;;OAGG;IACH,sCAjJe,MAAM,EAAE,uBACR,MAAM,KACJ,MAAM,EAAE,CA+IG;IA5JxB,sDAOC;CA+IJ;;aAUS,SAAS,KAAK,CAAC;eAMf,SAAS,KAAK,CAAC;cAMf,SAAS,KAAK,CAAC;gBAMf,SAAS,KAAK,CAAC;cAMf,SAAS,KAAK,CAAC;iBAMf,SAAS,KAAK,CAAC;eAMf,SAAS,KAAK,CAAC;eAMf,SAAS,KAAK,CAAC;qBAMf,SAAS,KAAK,CAAC;;mBA7uBN,4BAA4B"}

package/src/core/color/Color.js

@@ -54,7 +54,7 @@ export class Color {
         this.b = b;
 
         /**
-         * Alpha channel
+         * Alpha channel (transparency)
          * Value from 0 to 1
          * @type {number}
          */
@@ -566,6 +566,20 @@ export class Color {
         return destination;
     }
 
+    /**
+     *
+     * @param {number[]|Float32Array} source
+     * @param {number} [offset]
+     */
+    fromArray(source, offset = 0) {
+        const r = source[offset + 0];
+        const g = source[offset + 1];
+        const b = source[offset + 2];
+        const a = source[offset + 3];
+
+        this.set(r, g, b, a);
+    }
+
 
     /**
      *
@@ -681,7 +695,7 @@ export class Color {
 }
 
 /**
- * Shortcut
+ * @deprecated use {@link Color#toArray} instead
  * @readonly
  */
 Color.prototype.writeToArray = Color.prototype.toArray;

package/src/engine/graphics/render/forward_plus/LightManager.js

@@ -23,8 +23,8 @@ import {
     bvh_query_user_data_overlaps_frustum
 } from "../../../../core/bvh2/bvh3/query/bvh_query_user_data_overlaps_frustum.js";
 import { array_copy } from "../../../../core/collection/array/array_copy.js";
+import { array_sort_quick } from "../../../../core/collection/array/array_sort_quick.js";
 import { array_swap_one } from "../../../../core/collection/array/array_swap_one.js";
-import { arrayQuickSort } from "../../../../core/collection/array/arrayQuickSort.js";
 import { read_cluster_frustum_corners } from "../../../../core/geom/3d/frustum/read_cluster_frustum_corners.js";
 import { read_three_planes_to_array } from "../../../../core/geom/3d/frustum/read_three_planes_to_array.js";
 import { slice_frustum_linear_to_points } from "../../../../core/geom/3d/frustum/slice_frustum_linear_to_points.js";
@@ -680,7 +680,7 @@ export class LightManager {
         array_copy(visible_light_set.elements, 0, sorted_lights, 0, visible_light_count);
         array_copy(visible_decal_set.elements, 0, sorted_lights, visible_light_count, visible_decal_count);
 
-        arrayQuickSort(sorted_lights, this.__sort_visible_light_score, this, 0, expected_sorted_size - 1);
+        array_sort_quick(sorted_lights, this.__sort_visible_light_score, this, 0, expected_sorted_size - 1);
     }
 
     __update_visible_bvh() {

package/src/engine/graphics/sh3/path_tracer/sorting/sort_bvh_nodes_by_distance_to_point.js

@@ -1,5 +1,5 @@
 import { ELEMENT_WORD_COUNT } from "../../../../../core/bvh2/bvh3/BVH.js";
-import { arrayQuickSort } from "../../../../../core/collection/array/arrayQuickSort.js";
+import { array_sort_quick } from "../../../../../core/collection/array/array_sort_quick.js";
 import {
     aabb3_unsigned_distance_sqr_to_point
 } from "../../../../../core/geom/3d/aabb/aabb3_unsigned_distance_sqr_to_point.js";
@@ -28,7 +28,7 @@ export function sort_bvh_nodes_by_distance_to_point(
      For performance, we bind data directly to avoid extra copies required to read out AABB
      */
     const float32 = bvh.__data_float32;
-    arrayQuickSort(node_list, (node) => {
+    array_sort_quick(node_list, (node) => {
             const address = node * ELEMENT_WORD_COUNT;
 
             const aabb_distance_sqr = aabb3_unsigned_distance_sqr_to_point(

package/src/engine/graphics/texture/virtual/VirtualTextureTileLoader.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../../core/assert.js";
-import { arrayQuickSort } from "../../../../core/collection/array/arrayQuickSort.js";
+import { array_sort_quick } from "../../../../core/collection/array/array_sort_quick.js";
 import Signal from "../../../../core/events/signal/Signal.js";
 import { AssetManager } from "../../../asset/AssetManager.js";
 import { GameAssetType } from "../../../asset/GameAssetType.js";
@@ -142,7 +142,7 @@ export class VirtualTextureTileLoader {
          */
         const score = (fingerprint) => -usage.getCountByFingerprint(fingerprint);
 
-        arrayQuickSort(
+        array_sort_quick(
             this.#queue,
             score, null,
             0, this.#queue.length - 1

package/src/generation/grid/generation/road/GridTaskGenerateRoads.js

@@ -2,7 +2,7 @@ import { GridTags } from "../../../../../samples/generation/grid/GridTags.js";
 import { MirGridLayers } from "../../../../../samples/generation/grid/MirGridLayers.js";
 import { matcher_tag_traversable } from "../../../../../samples/generation/rules/matcher_tag_traversable.js";
 import { BitSet } from "../../../../core/binary/BitSet.js";
-import { groupArrayBy } from "../../../../core/collection/array/groupArrayBy.js";
+import { array_group_by } from "../../../../core/collection/array/array_group_by.js";
 import { collectIteratorValueToArray } from "../../../../core/collection/collectIteratorValueToArray.js";
 import BinaryHeap from "../../../../core/collection/heap/BinaryHeap.js";
 import { QuadTreeNode } from "../../../../core/geom/2d/quad-tree/QuadTreeNode.js";
@@ -169,7 +169,7 @@ function buildPaths(
     const tBuildNodeGroups = actionTask(() => {
 
         //group nodes
-        const groupMap = groupArrayBy(nodes, readMarkerNodeGroupId);
+        const groupMap = array_group_by(nodes, readMarkerNodeGroupId);
 
         /**
          *

package/src/core/collection/array/arrayQuickSort.d.ts

@@ -1,12 +0,0 @@
-/**
- * @template T
- * @param {T[]|ArrayLike<number>|Uint32Array} data
- * @param {function(T):number} score_function
- * @param {*} [score_function_context]
- * @param {number} [start]
- * @param {number} [end]
- * @param {function(T[],number, number):*} [swap_operator]
- * @param {*} [swap_context]
- */
-export function arrayQuickSort<T>(data: ArrayLike<number> | Uint32Array | T[], score_function: (arg0: T) => number, score_function_context?: any, start?: number, end?: number, swap_operator?: (arg0: T[], arg1: number, arg2: number) => any, swap_context?: any): void;
-//# sourceMappingURL=arrayQuickSort.d.ts.map

package/src/core/collection/array/arrayQuickSort.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"arrayQuickSort.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/arrayQuickSort.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,4GAPuB,MAAM,wCAElB,MAAM,QACN,MAAM,oCACO,MAAM,QAAE,MAAM,oCAiErC"}

package/src/core/collection/array/array_remove_element.d.ts

@@ -1,11 +0,0 @@
-/**
- * @deprecated
- * @template T
- * @param {T[]} array
- * @param {number} start_index
- * @param {number} end_index
- * @param {T} element
- * @return {boolean}
- */
-export function array_remove_element<T>(array: T[], start_index: number, end_index: number, element: T): boolean;
-//# sourceMappingURL=array_remove_element.d.ts.map

package/src/core/collection/array/array_remove_element.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"array_remove_element.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_remove_element.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,iEALW,MAAM,aACN,MAAM,eAEL,OAAO,CAMlB"}

package/src/core/collection/array/array_remove_element.js

@@ -1,16 +0,0 @@
-import { array_remove_first } from "./array_remove_first.js";
-
-/**
- * @deprecated
- * @template T
- * @param {T[]} array
- * @param {number} start_index
- * @param {number} end_index
- * @param {T} element
- * @return {boolean}
- */
-export function array_remove_element(array, start_index, end_index, element) {
-    console.warn('deprecated, use array_remove_first instead');
-
-    array_remove_first(array, element, start_index, end_index - start_index);
-}

package/src/core/collection/array/groupArrayBy.d.ts

@@ -1,10 +0,0 @@
-/**
- * @template T,K
- * @param {T[]} array
- * @param {function(T):K} groupingFunction
- * @param keyHashFunction
- * @returns {Map<K,T[]>}
- */
-export function groupArrayBy<T, K>(array: T[], groupingFunction: (arg0: T) => K, keyHashFunction?: typeof returnZero): Map<K, T[]>;
-import { returnZero } from "../../function/returnZero.js";
-//# sourceMappingURL=groupArrayBy.d.ts.map

package/src/core/collection/array/groupArrayBy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"groupArrayBy.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/groupArrayBy.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,mIA+BC;2BAzC0B,8BAA8B"}