@vworlds/vecs 1.0.10 → 1.0.11

package/dist/util/events.js

@@ -1,10 +1,23 @@
 /**
- * The following type declarations define an alternative typings interface for eventemitter3
- * Inspired by typings in @yandeu/events https://github.com/yandeu/events
- * Turns out those typings pretty much can be used directly on eventemitter3
+ * Strongly-typed wrapper around `eventemitter3`.
+ *
+ * The class declared in this file is purely a typings shim — at module load
+ * its prototype is swapped out for `EventEmitter` from `eventemitter3` so the
+ * concrete behavior is provided by that library, while consumers see typed
+ * `on` / `emit` / `off` signatures driven by an `EventMap`.
+ *
+ * Inspired by the typings in `@yandeu/events`
+ * (https://github.com/yandeu/events). The original typings turned out to be
+ * usable directly on top of `eventemitter3`.
+ *
+ * @internal Used only inside the package, to expose typed entity-level events.
  */
 import eventEmitter3 from "eventemitter3";
 const { EventEmitter } = eventEmitter3;
+/**
+ * Typed event emitter shape. Replaced at runtime by `EventEmitter` from
+ * `eventemitter3` (see the assignment below the class body).
+ */
 class events {
     on(event, fn, context) {
         return 0;
@@ -38,6 +51,14 @@ class events {
     }
 }
 events = EventEmitter;
+/**
+ * Typed `EventEmitter` parameterised by an `EventMap` of `eventName -> handler`.
+ *
+ * Constructed lazily by `Entity.events`. Inherits its concrete behavior from
+ * `eventemitter3`'s `EventEmitter`.
+ *
+ * @internal
+ */
 export class Events extends events {
 }
 //# sourceMappingURL=events.js.map

package/dist/util/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/util/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,aAAa,MAAM,eAAe,CAAC;AAC1C,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC;AAmBvC,MAAM,MAAM;IACH,EAAE,CACP,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,IAAI,CAAiC,KAAQ,EAAE,GAAG,IAA4B;QACnF,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,IAAI,CACT,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,UAAU;QACf,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,SAAS,CAAC,KAA2B;QAC1C,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,aAAa,CAAC,KAA2B;QAC9C,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,cAAc,CACnB,KAAQ,EACR,EAA+B,EAC/B,OAAa,EACb,IAAc;QAEd,OAAO,CAAQ,CAAC;IAClB,CAAC;IACD,kBAAkB,CAAC,KAA4B;QAC7C,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,GAAG,CACR,KAAQ,EACR,EAA2C,EAC3C,OAAa,EACb,IAA0B;QAE1B,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,WAAW,CAChB,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;CACF;AAEA,MAAc,GAAG,YAAY,CAAC;AAE/B,MAAM,OAAO,MAA6C,SAAQ,MAAgB;CAAG"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/util/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,aAAa,MAAM,eAAe,CAAC;AAC1C,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC;AA0BvC;;;GAGG;AACH,MAAM,MAAM;IACH,EAAE,CACP,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,IAAI,CAAiC,KAAQ,EAAE,GAAG,IAA4B;QACnF,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,IAAI,CACT,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,UAAU;QACf,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,SAAS,CAAC,KAA2B;QAC1C,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,aAAa,CAAC,KAA2B;QAC9C,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,cAAc,CACnB,KAAQ,EACR,EAA+B,EAC/B,OAAa,EACb,IAAc;QAEd,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,kBAAkB,CAAC,KAA4B;QACpD,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,GAAG,CACR,KAAQ,EACR,EAA2C,EAC3C,OAAa,EACb,IAA0B;QAE1B,OAAO,CAAQ,CAAC;IAClB,CAAC;IACM,WAAW,CAChB,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;CACF;AAEA,MAAc,GAAG,YAAY,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,OAAO,MAA6C,SAAQ,MAAgB;CAAG"}

package/dist/util/ordered_set.d.ts

@@ -1,17 +1 @@
-export declare class OrderedSet<T> implements Set<T> {
-    private items;
-    private readonly compare;
-    constructor(compare: (a: T, b: T) => number);
-    private bisect;
-    add(value: T): this;
-    has(value: T): boolean;
-    delete(value: T): boolean;
-    clear(): void;
-    get size(): number;
-    forEach(callbackfn: (value: T, value2: T, set: Set<T>) => void, thisArg?: unknown): void;
-    [Symbol.iterator](): IterableIterator<T>;
-    entries(): IterableIterator<[T, T]>;
-    keys(): IterableIterator<T>;
-    values(): IterableIterator<T>;
-    get [Symbol.toStringTag](): string;
-}
+export {};

package/dist/util/ordered_set.js

@@ -1,14 +1,32 @@
+/**
+ * A `Set<T>` whose iteration order is determined by a comparator instead of
+ * insertion order.
+ *
+ * Backed by a sorted array. Insertions and lookups are `O(log n)` (binary
+ * search) plus the cost of an array splice on `add` / `delete`.
+ *
+ * Used by `Query.sort` to keep matched entities in a user-defined order so
+ * iteration in `forEach` and `each` walks them sorted.
+ *
+ * @internal Used only inside the package.
+ *
+ * @typeParam T - Element type stored in the set.
+ */
 export class OrderedSet {
     constructor(compare) {
-        this.items = [];
-        this.compare = compare;
+        this._items = [];
+        this._compare = compare;
     }
-    bisect(value) {
+    /**
+     * Return the index where `value` should be inserted to keep the array
+     * sorted (binary search; mirrors Python's `bisect_left`).
+     */
+    _bisect(value) {
         let lo = 0;
-        let hi = this.items.length;
+        let hi = this._items.length;
         while (lo < hi) {
             const mid = (lo + hi) >>> 1;
-            if (this.compare(this.items[mid], value) < 0) {
+            if (this._compare(this._items[mid], value) < 0) {
                 lo = mid + 1;
             }
             else {
@@ -17,53 +35,84 @@ export class OrderedSet {
         }
         return lo;
     }
+    /** Number of elements currently stored. */
+    get size() {
+        return this._items.length;
+    }
+    /** Tag used by `Object.prototype.toString` for stringification. */
+    get [Symbol.toStringTag]() {
+        return "OrderedSet";
+    }
+    /**
+     * Insert `value` at the position determined by the comparator. No-op when
+     * an element compares equal to `value`.
+     *
+     * @param value - Element to insert.
+     */
     add(value) {
-        const i = this.bisect(value);
-        if (i < this.items.length && this.compare(this.items[i], value) === 0) {
+        const i = this._bisect(value);
+        if (i < this._items.length && this._compare(this._items[i], value) === 0) {
             return this;
         }
-        this.items.splice(i, 0, value);
+        this._items.splice(i, 0, value);
         return this;
     }
+    /**
+     * Return `true` when an element comparing equal to `value` is in the set.
+     *
+     * @param value - Element to look up.
+     */
     has(value) {
-        const i = this.bisect(value);
-        return i < this.items.length && this.compare(this.items[i], value) === 0;
+        const i = this._bisect(value);
+        return i < this._items.length && this._compare(this._items[i], value) === 0;
     }
+    /**
+     * Remove the element comparing equal to `value`. Returns `true` if an
+     * element was removed.
+     *
+     * @param value - Element to remove.
+     */
     delete(value) {
-        const i = this.bisect(value);
-        if (i < this.items.length && this.compare(this.items[i], value) === 0) {
-            this.items.splice(i, 1);
+        const i = this._bisect(value);
+        if (i < this._items.length && this._compare(this._items[i], value) === 0) {
+            this._items.splice(i, 1);
             return true;
         }
         return false;
     }
+    /** Remove every element. */
     clear() {
-        this.items.length = 0;
-    }
-    get size() {
-        return this.items.length;
+        this._items.length = 0;
     }
+    /**
+     * Visit each element in sorted order.
+     *
+     * @param callbackfn - Invoked with `(value, value, set)` for each element
+     *   (`Set` interface compatibility — both arguments are the same value).
+     * @param thisArg - Optional `this` binding for the callback.
+     */
     forEach(callbackfn, thisArg) {
-        for (const item of this.items) {
+        for (const item of this._items) {
             callbackfn.call(thisArg, item, item, this);
         }
     }
+    /** Iterator over elements in sorted order. */
     [Symbol.iterator]() {
-        return this.items[Symbol.iterator]();
+        return this._items[Symbol.iterator]();
     }
+    /** Iterator yielding `[value, value]` pairs in sorted order. */
     *entries() {
-        for (const item of this.items) {
+        for (const item of this._items) {
             yield [item, item];
         }
     }
+    /** Iterator over elements in sorted order. */
     keys() {
-        return this.items[Symbol.iterator]();
+        return this._items[Symbol.iterator]();
     }
+    /** Iterator over elements in sorted order. */
     values() {
-        return this.items[Symbol.iterator]();
-    }
-    get [Symbol.toStringTag]() {
-        return "OrderedSet";
+        return this._items[Symbol.iterator]();
     }
 }
 //# sourceMappingURL=ordered_set.js.map

package/dist/util/ordered_set.js.map

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