@woosh/meep-engine 2.105.0 → 2.106.1

package/package.json

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

package/src/core/assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/core/assert.js"],"names":[],"mappings":"AA6BA,6CAIC;;IAsJD;;;;;OAKG;IACH,kEAQC;;;;;;;;;;;;;;;IAmBD;;;;;;OAMG;IACH,uGAGC;IAGD;;;;OAIG;IACH,0DAMC;IAED;;;;OAIG;IACH,0DAMC;IAED;;;;OAIG;IACH,2DAMC;IAED;;;;OAIG;IACH,4DAMC;IAED;;;;OAIG;IACH,0DAMC;IAED;;;;OAIG;IACH,2DAMC;IAED;;;;OAIG;IACH,sEAMC;IAED;;;;OAIG;IACH,4DAKC;IAED;;;;OAIG;IACH,+EAKC;IAGD;;;;OAIG;IACH,yDAMC;IAED;;;;OAIG;IACH,wDAIC;IAED;;;;OAIG;IACH,yDAMC;IAED;;;;OAIG;IACH,2DAIC;IAED;;;;OAIG;IACH,mEAIC;IAED;;;;;OAKG;IACH,2EAgBC;;AA/ZD,wDAEC;AAED,6CAEC;AAbD,qDAKC;AAUD;;;;;GAKG;AACH,kCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAIhB;AAQD;;;;;GAKG;AACH,gCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,uCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AA5CD;;;;;GAKG;AACH,6BAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,oCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAKD;;;;;GAKG;AACH,0CAHW,MAAM,cACN,MAAM,QAehB;AAED;;;;;GAKG;AACH,iEAFW,MAAM,QAIhB;AAED;;;;;GAKG;AACH,mEAFW,MAAM,QAIhB;AAED;;;;;GAKG;AACH,+IAFW,MAAM,QAMhB"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../src/core/assert.js"],"names":[],"mappings":"AA+BA,6CAIC;;IAsJD;;;;;OAKG;IACH,kEAQC;;;;;;;;;;;;;;;IAmBD;;;;;;OAMG;IACH,uGAGC;IAGD;;;;OAIG;IACH,0DAMC;IAED;;;;OAIG;IACH,0DAMC;IAED;;;;OAIG;IACH,2DAMC;IAED;;;;OAIG;IACH,4DAMC;IAED;;;;OAIG;IACH,0DAMC;IAED;;;;OAIG;IACH,2DAMC;IAED;;;;OAIG;IACH,sEAMC;IAED;;;;OAIG;IACH,4DAKC;IAED;;;;OAIG;IACH,+EAKC;IAGD;;;;OAIG;IACH,yDAMC;IAED;;;;OAIG;IACH,wDAIC;IAED;;;;OAIG;IACH,yDAMC;IAED;;;;OAIG;IACH,2DAIC;IAED;;;;OAIG;IACH,mEAIC;IAED;;;;;OAKG;IACH,2EAgBC;;AA/ZD,wDAEC;AAED,6CAEC;AAfD,qDAOC;AAUD;;;;;GAKG;AACH,kCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAIhB;AAQD;;;;;GAKG;AACH,gCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,uCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AA5CD;;;;;GAKG;AACH,6BAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAyBD;;;;;GAKG;AACH,oCAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;AAKD;;;;;GAKG;AACH,0CAHW,MAAM,cACN,MAAM,QAehB;AAED;;;;;GAKG;AACH,iEAFW,MAAM,QAIhB;AAED;;;;;GAKG;AACH,mEAFW,MAAM,QAIhB;AAED;;;;;GAKG;AACH,+IAFW,MAAM,QAMhB"}

package/src/core/assert.js

@@ -4,7 +4,9 @@ import { InMemoryDescriptor } from "./debug/InMemoryDescriptor.js";
 
 function equal(a, b, m) {
     if (a !== b) {
-        const message = m !== undefined ? m : `${a} !== ${b}`;
+        const details = `${a} !== ${b}`;
+
+        const message = (m !== undefined && m !== "") ? `${m}. ${details}` : details;
         throw new Error(message);
     }
 }

package/src/core/cache/Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/Cache.js"],"names":[],"mappings":"AASA;;;;;GAKG;AACH;IASI;;;;;;;;OAQG;IACH,sGARW,MAAM,EAuFhB;IAxDG;;;;OAIG;IACH,mBAA4B;IAE5B;;;;OAIG;IACH,qBAAgC;IAEhC;;;;OAIG;IACH,gBAAmB;IACnB;;;;OAIG;IACH,eAAkB;IAGlB;;;;OAIG;IACH,aAIE;IAEF;;;OAGG;IACH,WAFU,OAAO,GAAG,EAAC,KAAK,CAAC,CAEE;IAE7B;;;OAGG;IACH,WAFU,OAAO,GAAG,EAAC,KAAK,CAAC,CAEE;IAE7B;;;OAGG;IACH,OAFU,OAAO,GAAG,EAAC,KAAK,CAAC,CAEF;IAG7B;;;;;OAKG;IACH,kBAyBC;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;OAEG;IACH,+BAEC;IAUD;;;OAGG;IACH,2BAQC;IAED,wBAEC;IAxBD;;;OAGG;IACH,qBAEC;IAoBD;;;;OAIG;IACH,wBAaC;IAED;;;;;;OAMG;IACH,yBAHW,GAAG,GACD,OAAO,CAgCnB;IAED;;;;;OAKG;IACH,6BAUC;IAED;;;OAGG;IACH,sBAFa,aAAa,GAAG,EAAC,KAAK,CAAC,GAAC,IAAI,CAIxC;IAED;;;OAGG;IACH,YAFa,OAAO,CAkBnB;IAED;;;OAGG;IACH,+BAFW,MAAM,QAWhB;IAED;;;;OAIG;IACH,SAHW,GAAG,SACH,KAAK,QAoEf;IAED;;;;OAIG;IACH,cAHW,GAAG,GACD,OAAO,CAInB;IAED;;;;OAIG;IACH,SAHW,GAAG,GACD,KAAK,GAAC,IAAI,CAYtB;IAGD;;;;;;OAMG;IACH,kBALW,GAAG,kBACM,GAAG,KAAE,KAAK,0BAElB,KAAK,CAchB;IAED;;;;OAIG;IACH,wBAqBC;IAED;;;;OAIG;IACH,YAHW,GAAG,GACD,OAAO,CAgBnB;IAED;;;;;OAKG;IACH,kBAHW,GAAG,GACD,OAAO,CAanB;IAED;;OAEG;IACH,cAcC;IAED;;;OAGG;IACH,aAOC;IAED;;;;;OAKG;IACH,wCAFa,OAAO,CAMnB;IAGL;;;OAGG;IACH,6CAAmB;IAEnB;;;OAGG;IACH,+BA5FiB,OAAO,CA4FF;IAEtB;;;OAGG;IACH,4BA9KiB,OAAO,CA8KL;;CAlBlB;mBA3hBkB,4BAA4B;6BAIlB,mBAAmB"}
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/Cache.js"],"names":[],"mappings":"AASA;;;;;GAKG;AACH;IASI;;;;;;;;OAQG;IACH,sGARW,MAAM,EAuFhB;IAxDG;;;;OAIG;IACH,mBAA4B;IAE5B;;;;OAIG;IACH,qBAAgC;IAEhC;;;;OAIG;IACH,gBAAmB;IACnB;;;;OAIG;IACH,eAAkB;IAGlB;;;;OAIG;IACH,aAIE;IAEF;;;OAGG;IACH,WAFU,OAAO,GAAG,EAAC,KAAK,CAAC,CAEE;IAE7B;;;OAGG;IACH,WAFU,OAAO,GAAG,EAAC,KAAK,CAAC,CAEE;IAE7B;;;OAGG;IACH,OAFU,OAAO,GAAG,EAAC,KAAK,CAAC,CAEF;IAG7B;;;;;OAKG;IACH,kBAyBC;IAED;;;OAGG;IACH,QAFa,MAAM,CAIlB;IAED;;OAEG;IACH,+BAEC;IAUD;;;OAGG;IACH,2BAQC;IAED,wBAEC;IAxBD;;;OAGG;IACH,qBAEC;IAoBD;;;;OAIG;IACH,wBAaC;IAED;;;;;;OAMG;IACH,yBAHW,GAAG,GACD,OAAO,CAgCnB;IAED;;;;;OAKG;IACH,6BAUC;IAED;;;OAGG;IACH,sBAFa,aAAa,GAAG,EAAC,KAAK,CAAC,GAAC,IAAI,CAIxC;IAED;;;OAGG;IACH,YAFa,OAAO,CAkBnB;IAED;;;OAGG;IACH,+BAFW,MAAM,QAWhB;IAED;;;;OAIG;IACH,SAHW,GAAG,SACH,KAAK,QAwEf;IAED;;;;OAIG;IACH,cAHW,GAAG,GACD,OAAO,CAInB;IAED;;;;OAIG;IACH,SAHW,GAAG,GACD,KAAK,GAAC,IAAI,CAYtB;IAGD;;;;;;OAMG;IACH,kBALW,GAAG,kBACM,GAAG,KAAE,KAAK,0BAElB,KAAK,CAchB;IAED;;;;OAIG;IACH,wBAqBC;IAED;;;;OAIG;IACH,YAHW,GAAG,GACD,OAAO,CAgBnB;IAED;;;;;OAKG;IACH,kBAHW,GAAG,GACD,OAAO,CAanB;IAED;;OAEG;IACH,cAcC;IAED;;;OAGG;IACH,aAOC;IAED;;;;;OAKG;IACH,wCAFa,OAAO,CAMnB;IAGL;;;OAGG;IACH,6CAAmB;IAEnB;;;OAGG;IACH,+BA5FiB,OAAO,CA4FF;IAEtB;;;OAGG;IACH,4BA9KiB,OAAO,CA8KL;;CAlBlB;mBA/hBkB,4BAA4B;6BAIlB,mBAAmB"}

package/src/core/cache/Cache.js

@@ -317,6 +317,22 @@ export class Cache {
         let element = this.data.get(key);
 
         if (element === undefined) {
+            //compute weight
+            const elementWeight = this.computeElementWeight(key, value);
+
+            /**
+             * It's possible that element being added is larger than cache's capacity,
+             * in which case entire cache will be evicted, but there still won't be enough space
+             * @type {number}
+             */
+            const weightTarget = this.#maxWeight - elementWeight;
+
+            if (weightTarget < 0) {
+                // Special case
+                // element does not fit into cache, attempting to insert it forcibly would result in a full flush and overflow
+                return;
+            }
+
             element = new CacheElement();
 
             element.key = key;
@@ -334,25 +350,8 @@ export class Cache {
                 this.__last = element;
             }
 
-            //compute weight
-            const elementWeight = this.computeElementWeight(key, value);
-
             element.weight = elementWeight;
 
-
-            /**
-             * It's possible that element being added is larger than cache's capacity,
-             * in which case entire cache will be evicted, but there still won't be enough space
-             * @type {number}
-             */
-            const weightTarget = this.#maxWeight - elementWeight;
-
-            if (weightTarget < 0) {
-                // Special case
-                // element does not fit into cache, attempting to insert it forcibly would result in a full flush and overflow
-                return;
-            }
-
             //evict elements until there is enough space for the element
             this.evictUntilWeight(weightTarget);
 
@@ -367,9 +366,14 @@ export class Cache {
                 // same value, no action required
             } else {
                 // replace value, adjust weight
-                this.#weight -= this.valueWeigher(element.value);
-                this.#weight += this.valueWeigher(value);
+                this.#weight -= element.weight;
+
+                const elementWeight = this.computeElementWeight(key, value);
+
+                this.#weight += elementWeight;
 
+                // assign new values
+                element.weight = elementWeight;
                 element.value = value;
             }
 

package/src/core/collection/array/array_copy.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=array_copy.spec.d.ts.map

package/src/core/collection/array/array_copy.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array_copy.spec.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/array/array_copy.spec.js"],"names":[],"mappings":""}

package/src/core/collection/array/array_copy.spec.js

@@ -0,0 +1,19 @@
+import { array_copy } from "./array_copy.js";
+
+test("empty array copy", () => {
+
+    const target = [];
+
+    array_copy([], 0, target, 0, 0);
+
+    expect(target).toEqual([]);
+});
+
+test("copy portion", () => {
+
+    const target = [7, 8, 9];
+
+    array_copy([1, 2, 3, 4], 1, target, 1, 2);
+
+    expect(target).toEqual([7, 2, 3])
+});

package/src/core/collection/list/List.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/List.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/List.js"],"names":[],"mappings":"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"}

package/src/core/collection/list/List.js

@@ -31,18 +31,28 @@ class List {
         removed: new Signal()
     };
 
+    /**
+     *
+     * @type {T[]}
+     */
+    data = []
+
     /**
      * @param {[]} [array]
      * @constructor
      */
     constructor(array) {
 
-        /**
-         * @private
-         * @readonly
-         * @type {T[]}
-         */
-        this.data = array !== undefined ? array.slice() : [];
+        if (array !== undefined) {
+            assert.isArray(array, 'array');
+
+            /**
+             * @private
+             * @readonly
+             * @type {T[]}
+             */
+            this.data = array.slice();
+        }
 
         /**
          * Number of elements in the list
@@ -138,9 +148,11 @@ class List {
         if (index > this.length) {
             console.error(`Overflow, attempted to insert element at ${index} past the list length(=${this.length})`);
             this.length = index;
-        }
 
-        this.data.splice(index, 0, el);
+            this.data[index] = el;
+        } else {
+            this.data.splice(index, 0, el);
+        }
 
         this.length++;
 
@@ -278,11 +290,11 @@ class List {
     addAllUnique(elements) {
         const data = this.data;
 
-        const unique = elements.filter(function (e, i) {
-            return data.indexOf(e) === -1 && elements.indexOf(e, i + 1) === -1;
-        });
+        const length = data.length;
 
-        this.addAll(unique);
+        for (let i = 0; i < length; i++) {
+            this.addUnique(data[i]);
+        }
     }
 
     /**
@@ -292,26 +304,28 @@ class List {
      * @returns {T[]}
      */
     removeMany(index, removeCount) {
-        assert.equal(typeof index, 'number', `index must a number, instead was '${typeof index}'`);
+        assert.isNonNegativeInteger(index, "index");
         assert.ok(index < this.length || index < 0, `index(=${index}) out of range (${this.length})`);
 
-        const els = this.data.splice(index, removeCount);
+        const removed_elements = this.data.splice(index, removeCount);
 
-        const removedCount = els.length;
+        const removedCount = removed_elements.length;
 
         this.length -= removedCount;
 
         assert.equal(this.length, this.data.length, `length(=${this.length}) is inconsistent with underlying data array length(=${this.data.length})`)
 
-        if (this.on.removed.hasHandlers()) {
+        const onRemoved = this.on.removed;
+
+        if (onRemoved.hasHandlers()) {
             for (let i = 0; i < removedCount; i++) {
-                const element = els[i];
+                const element = removed_elements[i];
 
-                this.on.removed.send2(element, index + i);
+                onRemoved.send2(element, index + i);
             }
         }
 
-        return els;
+        return removed_elements;
     }
 
     /**
@@ -394,8 +408,13 @@ class List {
         }
     }
 
-    sort() {
-        Array.prototype.sort.apply(this.data, arguments);
+    /**
+     *
+     * @param {function(a:T, b:T):number} [compare_function]
+     * @returns {List}
+     */
+    sort(compare_function) {
+        Array.prototype.sort.call(this.data, compare_function);
         return this;
     }
 
@@ -560,18 +579,24 @@ class List {
      *
      * @param {function(el:T):boolean} matcher
      * @param {function(el:T, index:number):*} callback
+     * @returns {boolean}
      */
     visitFirstMatch(matcher, callback) {
-        const data = this.data;
-        let i = 0;
-        const l = this.length;
-        for (; i < l; i++) {
-            const el = data[i];
-            if (matcher(el)) {
-                callback(el, i);
-                return;
-            }
+        const index = this.findIndex(matcher);
+
+        if (index === -1) {
+            return false;
         }
+
+        const el = this.data[index];
+
+        if (matcher(el)) {
+            callback(el, index);
+            return true;
+        } else {
+            return false;
+        }
+
     }
 
     /**

package/src/core/collection/list/List.spec.js

@@ -141,6 +141,29 @@ test("add increases length", () => {
     expect(list.length).toBe(2);
 });
 
+test("add dispatches relevant signal", () => {
+
+    /**
+     *
+     * @type {List<number>}
+     */
+    const list = new List();
+
+    const callback = jest.fn();
+
+    list.on.added.add(callback);
+
+    list.add(7);
+
+    expect(callback).toHaveBeenCalledTimes(1);
+    expect(callback).toHaveBeenLastCalledWith(7, 0);
+
+    list.add(11);
+
+    expect(callback).toHaveBeenCalledTimes(2);
+    expect(callback).toHaveBeenLastCalledWith(11, 1);
+});
+
 
 test("removeIf", () => {
     const list = new List([1, 3, 1]);
@@ -226,6 +249,12 @@ test("insert", () => {
     expect(list.get(1)).toBe("x");
     expect(list.get(2)).toBe("z");
     expect(add_callback).toHaveBeenLastCalledWith("z", 2);
+
+    // try insert past end
+    list.insert(4, "outside");
+
+    expect(list.length).toEqual(5);
+    expect(list.get(4)).toBe("outside");
 });
 
 test("map", () => {
@@ -309,6 +338,20 @@ test("last", () => {
 
 });
 
+test("containsAny", () => {
+
+    const list = new List([1, 3, 7, 13]);
+
+    expect(list.containsAny([])).toBe(false);
+    expect(list.containsAny([2])).toBe(false);
+    expect(list.containsAny([2, 4, 5])).toBe(false);
+    expect(list.containsAny([1])).toBe(true);
+    expect(list.containsAny([2, 1])).toBe(true);
+    expect(list.containsAny([2, 3])).toBe(true);
+
+
+});
+
 test("deepCopy", () => {
 
     const a = new List();
@@ -334,4 +377,62 @@ test("slice", () => {
     expect(new List([1, 2, 3, 4]).slice(1, 3)).toEqual([2, 3]);
     expect(new List([3, 7, 11]).slice()).toEqual([3, 7, 11]);
 
+});
+
+test("addAll triggers signals", () => {
+
+    const list = new List();
+
+    const callback = jest.fn();
+
+    list.on.added.add(callback);
+
+    list.addAll([1, 3, 7]);
+
+    expect(callback).toHaveBeenCalledTimes(3);
+
+    expect(callback).toHaveBeenCalledWith(1, 0);
+    expect(callback).toHaveBeenCalledWith(3, 1);
+    expect(callback).toHaveBeenCalledWith(7, 2);
+});
+
+test("compare method", () => {
+
+    class Thing {
+        v = 0
+
+        constructor(v) {
+            this.v = v;
+        }
+
+        compare(other) {
+            return this.v - other.v;
+        }
+    }
+
+    expect(new List().compare(new List())).toEqual(0);
+    expect(
+        new List([new Thing(7)])
+            .compare(new List())
+    ).toBeGreaterThan(0);
+
+    expect(
+        new List()
+            .compare(new List([new Thing(7)]))
+    ).toBeLessThan(0);
+
+    expect(
+        new List([new Thing(7)])
+            .compare(new List([new Thing(7)]))
+    ).toBe(0);
+
+    expect(
+        new List([new Thing(7)])
+            .compare(new List([new Thing(3)]))
+    ).toBeGreaterThan(0);
+
+    expect(
+        new List([new Thing(3)])
+            .compare(new List([new Thing(7)]))
+    ).toBeLessThan(0);
 });

package/src/core/collection/list/ListForwarder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ListForwarder.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/ListForwarder.js"],"names":[],"mappings":"AAAA;;GAEG;AACH;IAQQ;;;;OAIG;IACH,sBAAyB;IACzB;;;;OAIG;IACH,kBAAmB;IACnB;;;;OAIG;IACH,oBAAwB;IAG5B;;;OAGG;IACH,8BAOC;IAED;;;OAGG;IACH,2BAEC;IAED;;;;OAIG;IACH,sBAFY,OAAO,CAUlB;IAED;;;;OAIG;IACH,mBAMC;IAED;;;;OAIG;IACH,qBAOC;IAED;;;;OAIG;IACH,yBAFY,OAAO,CAgBlB;IAED,aAkBC;IAED,eAeC;IAED;;;OAGG;IACH,YAFY,OAAO,CAIlB;CACJ"}
+{"version":3,"file":"ListForwarder.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/ListForwarder.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IAsBI;;;OAGG;IACH,8BAOC;IAED;;;OAGG;IACH,2BAEC;IAED;;;;OAIG;IACH,YAHW,KAAK,CAAC,CAAC,GACN,OAAO,CAUlB;IA6BD;;;;OAIG;IACH,eAHW,KAAK,CAAC,CAAC,GACN,OAAO,CAgBlB;IAED,aAkBC;IAED,eAeC;IAED;;;OAGG;IACH,YAFY,OAAO,CAIlB;;CACJ;iBA3JgB,WAAW"}

package/src/core/collection/list/ListForwarder.js

@@ -1,45 +1,41 @@
+import List from "./List.js";
+
 /**
  * @template T
  */
 export class ListForwarder {
+    /**
+     * Where the data ends up
+     * @type {List<T>}
+     * @private
+     */
+    #destination = new List();
 
     /**
-     * @template T
+     * Where to take data from
+     * @type {List<T>[]}
+     * @private
      */
-    constructor() {
-
-
-        /**
-         *
-         * @type {List<T>}
-         * @private
-         */
-        this.__destination = null;
-        /**
-         *
-         * @type {List<T>[]}
-         * @private
-         */
-        this.__sources = [];
-        /**
-         *
-         * @type {boolean}
-         * @private
-         */
-        this.__is_linked = false;
-    }
+    #sources = [];
+
+    /**
+     *
+     * @type {boolean}
+     * @private
+     */
+    #is_linked = false;
 
     /**
      *
      * @param {List<T>} v
      */
     set destination(v) {
-        if (this.__is_linked) {
+        if (this.#is_linked) {
             // already linked
             throw new Error('Invalid state: linked');
         }
 
-        this.__destination = v;
+        this.#destination = v;
     }
 
     /**
@@ -47,7 +43,7 @@ export class ListForwarder {
      * @return {List<T>}
      */
     get destination() {
-        return this.__destination;
+        return this.#destination;
     }
 
     /**
@@ -56,10 +52,10 @@ export class ListForwarder {
      * @return {boolean}
      */
     add(source) {
-        this.__sources.push(source);
+        this.#sources.push(source);
 
-        if (this.__is_linked) {
-            this.__link_one(source);
+        if (this.#is_linked) {
+            this.#link_one(source);
         }
 
         return true;
@@ -70,12 +66,12 @@ export class ListForwarder {
      * @param {List<T>} source
      * @private
      */
-    __link_one(source) {
-        source.on.added.add(this.__destination.add, this.__destination);
-        source.on.removed.add(this.__destination.removeOneOf, this.__destination);
+    #link_one(source) {
+        source.on.added.add(this.#destination.add, this.#destination);
+        source.on.removed.add(this.#destination.removeOneOf, this.#destination);
 
-        // remove all data from destination
-        source.forEach(this.__destination.add, this.__destination);
+        // move data to destination
+        source.forEach(this.#destination.add, this.#destination);
     }
 
     /**
@@ -83,13 +79,13 @@ export class ListForwarder {
      * @param {List<T>} source
      * @private
      */
-    __unlink_one(source) {
+    #unlink_one(source) {
 
-        source.on.added.remove(this.__destination.add, this.__destination);
-        source.on.removed.remove(this.__destination.removeOneOf, this.__destination);
+        source.on.added.remove(this.#destination.add, this.#destination);
+        source.on.removed.remove(this.#destination.removeOneOf, this.#destination);
 
-        // move data to destination
-        source.forEach(this.__destination.removeOneOf, this.__destination);
+        // remove all data from destination
+        source.forEach(this.#destination.removeOneOf, this.#destination);
     }
 
     /**
@@ -98,55 +94,55 @@ export class ListForwarder {
      * @return {boolean}
      */
     remove(source) {
-        const i = this.__sources.indexOf(source);
+        const i = this.#sources.indexOf(source);
 
         if (i === -1) {
             return false;
         }
 
-        if (this.__is_linked) {
-            this.__unlink_one(source);
+        if (this.#is_linked) {
+            this.#unlink_one(source);
         }
 
-        this.__sources.splice(i, 1);
+        this.#sources.splice(i, 1);
 
         return true;
     }
 
     link() {
-        if (this.__is_linked) {
+        if (this.#is_linked) {
             return;
         }
 
-        if (this.__destination === null) {
+        if (this.#destination === null) {
             throw new Error('Illegal state: destination not set');
         }
 
-        this.__is_linked = true;
+        this.#is_linked = true;
 
-        const sources = this.__sources;
+        const sources = this.#sources;
         const n = sources.length;
         for (let i = 0; i < n; i++) {
             const source = sources[i];
 
-            this.__link_one(source);
+            this.#link_one(source);
         }
     }
 
     unlink() {
-        if (!this.__is_linked) {
+        if (!this.#is_linked) {
             return;
         }
 
-        this.__is_linked = false;
+        this.#is_linked = false;
 
-        const sources = this.__sources;
+        const sources = this.#sources;
         const n = sources.length;
 
         for (let i = 0; i < n; i++) {
             const source = sources[i];
 
-            this.__unlink_one(source);
+            this.#unlink_one(source);
         }
     }
 
@@ -155,6 +151,6 @@ export class ListForwarder {
      * @return {boolean}
      */
     isLinked() {
-        return this.__is_linked;
+        return this.#is_linked;
     }
 }

package/src/core/collection/list/ListForwarder.spec.js

@@ -14,6 +14,8 @@ test('isLinked returns false for new instance', () => {
 test('link without destination throws', () => {
     const sut = new ListForwarder();
 
+    sut.destination = null;
+
     expect(() => sut.link()).toThrow();
 });
 

package/src/core/collection/list/SortedListProjection.d.ts

@@ -1,4 +1,7 @@
-export class SortedListProjection {
+/**
+ * @template T
+ */
+export class SortedListProjection<T> {
     /**
      *
      * @param {List<T>} input

package/src/core/collection/list/SortedListProjection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SortedListProjection.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/SortedListProjection.js"],"names":[],"mappings":"AAGA;IACI;;;;OAIG;IACH,mBAHW,OAAO,oCACO,MAAM,EAoB9B;IAjBG;;;OAGG;IACH,OAFU,OAAO,CAEC;IAElB;;;OAGG;IACH,QAFU,OAAO,CAEO;IAExB;;;OAGG;IACH,kCAF0B,MAAM,CAEJ;IAGhC,aAIC;IAED,eAEC;IAED;;;OAGG;IACH,4BAIC;IAGD,cAUC;CAEJ;iBA9DgB,WAAW"}
+{"version":3,"file":"SortedListProjection.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/list/SortedListProjection.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IACI;;;;OAIG;IACH,mBAHW,KAAK,CAAC,CAAC,qBACE,CAAC,QAAC,CAAC,KAAE,MAAM,EAoB9B;IAjBG;;;OAGG;IACH,OAFU,KAAK,CAAC,CAAC,CAEC;IAElB;;;OAGG;IACH,QAFU,KAAK,CAAC,CAAC,CAEO;IAExB;;;OAGG;IACH,mBAFmB,CAAC,QAAE,CAAC,KAAG,MAAM,CAEJ;IAGhC,aAIC;IAED,eAEC;IAED;;;OAGG;IACH,mBAFW,CAAC,QAMX;IAGD,cAUC;CAEJ;iBAhEgB,WAAW"}

package/src/core/collection/list/SortedListProjection.js

@@ -1,6 +1,9 @@
-import List from "./List.js";
 import { binarySearchLowIndex } from "../array/binarySearchLowIndex.js";
+import List from "./List.js";
 
+/**
+ * @template T
+ */
 export class SortedListProjection {
     /**
      *

package/src/core/collection/map/AbstractAsyncMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractAsyncMap.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/map/AbstractAsyncMap.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAKI;;;;OAIG;IACH,SAHW,GAAG,GACF,QAAQ,KAAK,GAAC,SAAS,CAAC,CAInC;IAED;;;;;OAKG;IACH,SAJW,GAAG,SACH,KAAK,GACJ,QAAQ,IAAI,CAAC,CAIxB;CACJ"}
+{"version":3,"file":"AbstractAsyncMap.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/map/AbstractAsyncMap.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAEI;;;;OAIG;IACH,SAHW,GAAG,GACF,QAAQ,KAAK,GAAC,SAAS,CAAC,CAInC;IAED;;;;;OAKG;IACH,SAJW,GAAG,SACH,KAAK,GACJ,QAAQ,IAAI,CAAC,CAIxB;CACJ"}