@vworlds/vecs 1.0.15 → 1.0.16

package/dist/query/query.01.reactive.js

@@ -0,0 +1,58 @@
+import { Base } from "./query.00.base.js";
+export class Reactive extends Base {
+    /** @internal */
+    _enter(e) {
+        this._entities?.add(e);
+        e._addQueryMembership(this);
+        this._enterCallback?.(e);
+        e.components.forEach((c, eid) => {
+            const meta = this.world.entity(eid).ownMeta;
+            if (this._watchlistBitmask.hasBit(meta.bitPtr)) {
+                this._notifyModified(e, meta, c);
+            }
+        });
+    }
+    /** @internal */
+    _exit(e) {
+        this._exitCallback?.(e);
+        this._entities?.delete(e);
+        e._removeQueryMembership(this);
+    }
+    /** @internal */
+    _notifyModified(e, meta, c) {
+        if (!this._watchlistBitmask.hasBit(meta.bitPtr)) {
+            return;
+        }
+        if (this._isSourceSilenced()) {
+            return;
+        }
+        const callback = this._componentUpdateCallbacks.get(meta.eid);
+        if (callback) {
+            callback(e, c);
+        }
+    }
+    /** @internal */
+    _isSourceSilenced() {
+        const source = this.entity.world._routingSource;
+        return source !== undefined && this._silenceQuery?.has(source) === true;
+    }
+    onTermEvent(kind, entity) {
+        if (kind === 0 /* TermEventKind.Enter */) {
+            this._enter(entity);
+        }
+        else {
+            this._exit(entity);
+        }
+    }
+    /** @internal */
+    _watchesUpdates() {
+        return this._componentUpdateCallbacks.size > 0;
+    }
+    /** @internal */
+    _unsubscribeRootTerm() {
+        this._unsubscribeTerm?.();
+        this._unsubscribeTerm = undefined;
+        this.rootTerm = undefined;
+    }
+}
+//# sourceMappingURL=query.01.reactive.js.map

package/dist/query/query.01.reactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.01.reactive.js","sourceRoot":"","sources":["../../src/query/query.01.reactive.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,OAAO,QAAyC,SAAQ,IAAO;IACnE,gBAAgB;IACT,MAAM,CAAC,CAAS;QACrB,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,mBAAmB,CAAC,IAAW,CAAC,CAAC;QACnC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;YAC5C,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9C,IAAY,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IACT,KAAK,CAAC,CAAS;QACpB,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,sBAAsB,CAAC,IAAW,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB;IACT,eAAe,CAAC,CAAS,EAAE,IAAmB,EAAE,CAAoB;QACzE,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,gBAAgB;IACN,iBAAiB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;QAChD,OAAO,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC1E,CAAC;IAEM,WAAW,CAAC,IAAmB,EAAE,MAAc;QACpD,IAAI,IAAI,gCAAwB,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,gBAAgB;IACT,eAAe;QACpB,OAAO,IAAI,CAAC,yBAAyB,CAAC,IAAI,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,gBAAgB;IACT,oBAAoB;QACzB,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;CACF"}

package/dist/query/query.02.lifecycle.d.ts

@@ -0,0 +1,6 @@
+import { type ComponentType } from "../component.js";
+import { Reactive } from "./query.01.reactive.js";
+export declare class Lifecycle<R extends ComponentType[] = []> extends Reactive<R> {
+    build(): this;
+    destroy(): void;
+}

package/dist/query/query.02.lifecycle.js

@@ -0,0 +1,63 @@
+import { containsDownTerm } from "../dsl.js";
+import { SOURCE_TRACKED_QUERY_ERROR, EMPTY_ENTITIES } from "./query.00.base.js";
+import { Reactive } from "./query.01.reactive.js";
+export class Lifecycle extends Reactive {
+    /** @internal */
+    _backfill() {
+        if (!this._tracking || !this.rootTerm) {
+            return;
+        }
+        this.world.defer(() => {
+            for (const e of this.rootTerm ?? EMPTY_ENTITIES) {
+                this._enter(e);
+            }
+        });
+    }
+    build() {
+        if (this.built) {
+            return this;
+        }
+        if (this.world.deferred) {
+            this.world._addUnbuiltQuery(this);
+            return this;
+        }
+        return this._build();
+    }
+    /** @internal */
+    _build() {
+        if (this.built) {
+            return this;
+        }
+        if (!this._isBuildable()) {
+            this.destroy();
+            return this;
+        }
+        this.world._removeUnbuiltQuery(this);
+        if (this._dsl !== undefined) {
+            if (this._tracking && containsDownTerm(this._dsl)) {
+                this.destroy();
+                throw new Error(SOURCE_TRACKED_QUERY_ERROR);
+            }
+            this.rootTerm = this.world.getTerm(this._dsl);
+            this._unsubscribeTerm = this.rootTerm.subscribe(this);
+        }
+        this.world._addQuery(this);
+        this._built = true;
+        this._backfill();
+        return this;
+    }
+    destroy() {
+        if (this._destroyed) {
+            return;
+        }
+        this._destroyed = true;
+        this.world._removeQuery(this);
+        this._entities?.clear();
+        this._entities = undefined;
+        this._tracking = false;
+        if (!this.entity._destroyed && this.entity.get(this._queryComponentClass) !== undefined) {
+            this.entity.destroy();
+        }
+    }
+}
+//# sourceMappingURL=query.02.lifecycle.js.map

package/dist/query/query.02.lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.02.lifecycle.js","sourceRoot":"","sources":["../../src/query/query.02.lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,OAAO,SAA0C,SAAQ,QAAW;IACxE,gBAAgB;IACN,SAAS;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;YACpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC;gBAC/C,IAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK;QACV,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAW,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAQ,IAAY,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAED,gBAAgB;IACT,MAAM;QACX,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAW,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAW,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO;QACZ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAW,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,SAAS,EAAE,CAAC;YACxF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/query/query.03.tracking.d.ts

@@ -0,0 +1,15 @@
+import { type ComponentType } from "../component.js";
+import { Entity } from "../entity/index.js";
+import { Iter, type FanInjectTuple, type MaybeResolvedInjectTuple } from "../inject.js";
+import { Lifecycle } from "./query.02.lifecycle.js";
+export declare class Tracking<R extends ComponentType[] = []> extends Lifecycle<R> {
+    get count(): number;
+    has(e: Entity): boolean;
+    [Symbol.iterator](): IterableIterator<Entity>;
+    track(): this;
+    belongs(e: Entity): boolean;
+    forEach(callback: (e: Entity) => void): void;
+    forEach<J extends FanInjectTuple>(components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(cursor: typeof Entity, components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(cursor: typeof Iter, components: readonly [...J], callback: (it: Iter, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+}

package/dist/query/query.03.tracking.js

@@ -0,0 +1,31 @@
+import { forEachInjected, } from "../inject.js";
+import { Lifecycle } from "./query.02.lifecycle.js";
+export class Tracking extends Lifecycle {
+    get count() {
+        if (!this._tracking) {
+            return 0;
+        }
+        return this._entities?.size ?? this.rootTerm?.count ?? 0;
+    }
+    has(e) {
+        if (!this._tracking) {
+            return false;
+        }
+        return this._entities?.has(e) ?? this.rootTerm?.has(e) ?? false;
+    }
+    [Symbol.iterator]() {
+        return this._matchedEntities()[Symbol.iterator]();
+    }
+    track() {
+        this._assertConfigurable();
+        this._tracking = true;
+        return this;
+    }
+    belongs(e) {
+        return this.rootTerm?.has(e) ?? false;
+    }
+    forEach(arg0, arg1, arg2) {
+        forEachInjected(this.world, this._matchedEntities(), arg0, arg1, arg2);
+    }
+}
+//# sourceMappingURL=query.03.tracking.js.map

package/dist/query/query.03.tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.03.tracking.js","sourceRoot":"","sources":["../../src/query/query.03.tracking.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAIhB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,OAAO,QAAyC,SAAQ,SAAY;IACxE,IAAW,KAAK;QACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IAC3D,CAAC;IAEM,GAAG,CAAC,CAAS;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IAClE,CAAC;IAEM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpD,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,CAAS;QACtB,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IACxC,CAAC;IAiBM,OAAO,CAAC,IAAa,EAAE,IAAc,EAAE,IAAc;QAC1D,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/query/query.04.callbacks.d.ts

@@ -0,0 +1,14 @@
+import { type ComponentType } from "../component.js";
+import { Entity } from "../entity/index.js";
+import { Iter, type InjectTuple, type RequiredResolvedInjectTuple } from "../inject.js";
+import { Tracking } from "./query.03.tracking.js";
+export declare class Callbacks<R extends ComponentType[] = []> extends Tracking<R> {
+    enter<J extends InjectTuple>(inject: readonly [...J], callback: (e: Entity, injected: RequiredResolvedInjectTuple<J>) => void): this;
+    enter<J extends InjectTuple>(cursor: typeof Entity, inject: readonly [...J], callback: (e: Entity, injected: RequiredResolvedInjectTuple<J>) => void): this;
+    enter<J extends InjectTuple>(cursor: typeof Iter, inject: readonly [...J], callback: (it: Iter, injected: RequiredResolvedInjectTuple<J>) => void): this;
+    enter(callback: (e: Entity) => void): this;
+    exit<J extends InjectTuple>(inject: readonly [...J], callback: (e: Entity, injected: RequiredResolvedInjectTuple<J>) => void): this;
+    exit<J extends InjectTuple>(cursor: typeof Entity, inject: readonly [...J], callback: (e: Entity, injected: RequiredResolvedInjectTuple<J>) => void): this;
+    exit<J extends InjectTuple>(cursor: typeof Iter, inject: readonly [...J], callback: (it: Iter, injected: RequiredResolvedInjectTuple<J>) => void): this;
+    exit(callback: (e: Entity) => void): this;
+}

package/dist/query/query.04.callbacks.js

@@ -0,0 +1,65 @@
+import { directInjectEids, getInjected, getInjectedWithSrc, injectArity, isCursorMarker, Iter, mapInject, wantsIter, } from "../inject.js";
+import { Tracking } from "./query.03.tracking.js";
+export class Callbacks extends Tracking {
+    enter(arg0, arg1, arg2) {
+        this._assertConfigurable();
+        if (typeof arg0 === "function" && !isCursorMarker(arg0)) {
+            this._enterCallback = arg0;
+            return this;
+        }
+        const useIter = wantsIter(arg0);
+        const components = (isCursorMarker(arg0) ? arg1 : arg0);
+        const cb = (isCursorMarker(arg0) ? arg2 : arg1);
+        const inject = mapInject(this.world, components);
+        const arity = injectArity(inject);
+        if (useIter) {
+            this._enterCallback = (e) => {
+                const injected = new Array(arity);
+                const it = new Iter(arity);
+                it.entity = e;
+                getInjectedWithSrc(e, inject, injected, it.src, true);
+                cb(it, injected);
+            };
+        }
+        else {
+            this._enterCallback = (e) => {
+                const injected = new Array(arity);
+                getInjected(e, inject, true, injected);
+                cb(e, injected);
+            };
+        }
+        return this;
+    }
+    exit(arg0, arg1, arg2) {
+        this._assertConfigurable();
+        if (typeof arg0 === "function" && !isCursorMarker(arg0)) {
+            this._exitCallback = arg0;
+            this._exitSnapshotTypes = undefined;
+            return this;
+        }
+        const useIter = wantsIter(arg0);
+        const components = (isCursorMarker(arg0) ? arg1 : arg0);
+        const cb = (isCursorMarker(arg0) ? arg2 : arg1);
+        const inject = mapInject(this.world, components);
+        this._exitSnapshotTypes = directInjectEids(inject);
+        const arity = injectArity(inject);
+        if (useIter) {
+            this._exitCallback = (e, exitSnapshot) => {
+                const injected = new Array(arity);
+                const it = new Iter(arity);
+                it.entity = e;
+                getInjectedWithSrc(e, inject, injected, it.src, true, exitSnapshot);
+                cb(it, injected);
+            };
+        }
+        else {
+            this._exitCallback = (e, exitSnapshot) => {
+                const injected = new Array(arity);
+                getInjected(e, inject, true, injected, exitSnapshot);
+                cb(e, injected);
+            };
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=query.04.callbacks.js.map

package/dist/query/query.04.callbacks.js.map

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

package/dist/query/query.05.updates.d.ts

@@ -0,0 +1,14 @@
+import { type ComponentType } from "../component.js";
+import { Entity } from "../entity/index.js";
+import { Iter, type InjectTuple, type MaybeResolvedInjectTuple } from "../inject.js";
+import { Callbacks } from "./query.04.callbacks.js";
+export declare class Updates<R extends ComponentType[] = []> extends Callbacks<R> {
+    update<C extends ComponentType>(ComponentClass: C, callback: (e: Entity, c: InstanceType<C>) => void): this;
+    update<C extends ComponentType, J extends InjectTuple>(ComponentClass: C, inject: readonly [...J], callback: (e: Entity, c: InstanceType<C>, injected: MaybeResolvedInjectTuple<J, R>) => void): this;
+    update<C extends ComponentType, J extends InjectTuple>(cursor: typeof Entity, ComponentClass: C, inject: readonly [...J], callback: (e: Entity, c: InstanceType<C>, injected: MaybeResolvedInjectTuple<J, R>) => void): this;
+    update<C extends ComponentType>(cursor: typeof Entity, ComponentClass: C, callback: (e: Entity, c: InstanceType<C>) => void): this;
+    update<C extends ComponentType, J extends InjectTuple>(cursor: typeof Iter, ComponentClass: C, inject: readonly [...J], callback: (it: Iter, c: InstanceType<C>, injected: MaybeResolvedInjectTuple<J, R>) => void): this;
+    sort<J extends InjectTuple>(components: readonly [...J], compare: (entityA: Entity, a: MaybeResolvedInjectTuple<J, R>, entityB: Entity, b: MaybeResolvedInjectTuple<J, R>) => number): this;
+    sort<J extends InjectTuple>(cursor: typeof Entity, components: readonly [...J], compare: (entityA: Entity, a: MaybeResolvedInjectTuple<J, R>, entityB: Entity, b: MaybeResolvedInjectTuple<J, R>) => number): this;
+    sort<J extends InjectTuple>(cursor: typeof Iter, components: readonly [...J], compare: (a: Iter, aResolved: MaybeResolvedInjectTuple<J, R>, b: Iter, bResolved: MaybeResolvedInjectTuple<J, R>) => number): this;
+}

package/dist/query/query.05.updates.js

@@ -0,0 +1,81 @@
+import { OrderedSet } from "../util/ordered_set.js";
+import { getInjected, getInjectedWithSrc, injectArity, isCursorMarker, Iter, mapInject, wantsIter, } from "../inject.js";
+import { Callbacks } from "./query.04.callbacks.js";
+export class Updates extends Callbacks {
+    update(arg0, arg1, arg2, arg3) {
+        this._assertConfigurable();
+        const useIter = wantsIter(arg0);
+        if (isCursorMarker(arg0)) {
+            arg0 = arg1;
+            arg1 = arg2;
+            arg2 = arg3;
+        }
+        const ComponentClass = arg0;
+        const componentEid = this.world.entity(ComponentClass).eid;
+        if (typeof arg1 === "function") {
+            const callback = arg1;
+            this._componentUpdateCallbacks.set(componentEid, callback);
+        }
+        else {
+            const components = arg1;
+            const callback = arg2;
+            const inject = mapInject(this.world, components);
+            const arity = injectArity(inject);
+            const injected = new Array(arity);
+            if (useIter) {
+                const it = new Iter(arity);
+                const cb = (e, c) => {
+                    it.entity = e;
+                    getInjectedWithSrc(e, inject, injected, it.src);
+                    callback(it, c, injected);
+                };
+                this._componentUpdateCallbacks.set(componentEid, cb);
+            }
+            else {
+                const cb = (e, c) => {
+                    getInjected(e, inject, false, injected);
+                    callback(e, c, injected);
+                };
+                this._componentUpdateCallbacks.set(componentEid, cb);
+            }
+        }
+        this._watchlistBitmask.add(componentEid);
+        if (!this._hasExplicitQuery) {
+            this._dsl = this._watchlistBitmask.indices();
+        }
+        return this;
+    }
+    sort(arg0, arg1, arg2) {
+        this._assertConfigurable();
+        const useIter = wantsIter(arg0);
+        const components = (isCursorMarker(arg0) ? arg1 : arg0);
+        const cb = (isCursorMarker(arg0) ? arg2 : arg1);
+        const inject = mapInject(this.world, components);
+        const arity = injectArity(inject);
+        this._tracking = true;
+        if (useIter) {
+            const itA = new Iter(arity);
+            const itB = new Iter(arity);
+            const resolvedA = new Array(arity);
+            const resolvedB = new Array(arity);
+            this._entities = new OrderedSet((a, b) => {
+                itA.entity = a;
+                itB.entity = b;
+                getInjectedWithSrc(a, inject, resolvedA, itA.src);
+                getInjectedWithSrc(b, inject, resolvedB, itB.src);
+                return cb(itA, resolvedA, itB, resolvedB);
+            });
+        }
+        else {
+            const resolvedA = new Array(arity);
+            const resolvedB = new Array(arity);
+            this._entities = new OrderedSet((a, b) => {
+                getInjected(a, inject, false, resolvedA);
+                getInjected(b, inject, false, resolvedB);
+                return cb(a, resolvedA, b, resolvedB);
+            });
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=query.05.updates.js.map

package/dist/query/query.05.updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.05.updates.js","sourceRoot":"","sources":["../../src/query/query.05.updates.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,SAAS,EACT,SAAS,GAIV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,OAAO,OAAwC,SAAQ,SAAY;IA2BhE,MAAM,CACX,IAAqC,EACrC,IAA+D,EAC/D,IAA4D,EAC5D,IAA+B;QAE/B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,GAAG,IAAS,CAAC;YACjB,IAAI,GAAG,IAAgC,CAAC;YACxC,IAAI,GAAG,IAAgC,CAAC;QAC1C,CAAC;QACD,MAAM,cAAc,GAAG,IAAS,CAAC;QACjC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC;QAC3D,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAgC,CAAC;YAClD,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,IAAgC,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAgC,CAAC;YAClD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,CAAoB,EAAE,EAAE;oBAC7C,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;oBACd,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;oBAChD,QAAQ,CAAC,EAAE,EAAE,CAAoB,EAAE,QAAe,CAAC,CAAC;gBACtD,CAAC,CAAC;gBACF,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,CAAoB,EAAE,EAAE;oBAC7C,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;oBACxC,QAAQ,CAAC,CAAC,EAAE,CAAoB,EAAE,QAAe,CAAC,CAAC;gBACrD,CAAC,CAAC;gBACF,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IA+BM,IAAI,CACT,IAA4D,EAC5D,IAA0C,EAC1C,IAAe;QAEf,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAA6B,CAAC;QACpF,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAmC,CAAC;QAClF,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC/C,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;gBACf,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;gBACf,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClD,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClD,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC/C,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBACzC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBACzC,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/query/query.06.predicate.d.ts

@@ -0,0 +1,13 @@
+import { type ComponentType } from "../component.js";
+import { type QueryDSL } from "../dsl.js";
+import { Entity } from "../entity/index.js";
+import { type FanInjectTuple, type MaybeResolvedInjectTuple } from "../inject.js";
+import { Updates } from "./query.05.updates.js";
+export declare class Predicate<R extends ComponentType[] = []> extends Updates<R> {
+    query<T extends ComponentType[] = []>(q: QueryDSL, _guaranteed?: readonly [...T]): any;
+    requires<T extends ComponentType[]>(...components: [...T]): any;
+    ignoreSource(source: QueryDSL | any): this;
+    private _buildSilenceQuery;
+    groupBy<K, J extends FanInjectTuple>(components: readonly [...J], key: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => K): any;
+    groupBy(relationship: import("../component.js").ComponentRef): any;
+}

package/dist/query/query.06.predicate.js

@@ -0,0 +1,40 @@
+import { ChildOf, SilenceSource } from "../relationship.js";
+import { _getGroupedQueryCtor } from "./query.00.base.js";
+import { Updates } from "./query.05.updates.js";
+export class Predicate extends Updates {
+    query(q, _guaranteed) {
+        this._assertConfigurable();
+        this._dsl = q;
+        this._hasExplicitQuery = true;
+        return this;
+    }
+    requires(...components) {
+        this.query(components);
+        return this;
+    }
+    ignoreSource(source) {
+        this._assertConfigurable();
+        const query = typeof source === "object" && !Array.isArray(source) && "entity" in source
+            ? source
+            : this._buildSilenceQuery(source);
+        this.entity.set(SilenceSource, { target: query.entity });
+        this._silenceQuery = query;
+        return this;
+    }
+    _buildSilenceQuery(dsl) {
+        const q = this.world.query(`${this.name}:silence`).query(dsl);
+        q.entity.set(ChildOf, { target: this.entity });
+        return q;
+    }
+    /** @internal */
+    _clearSilence() {
+        this._silenceQuery = undefined;
+    }
+    groupBy(arg0, arg1) {
+        this._assertConfigurable();
+        const ctor = _getGroupedQueryCtor();
+        Object.setPrototypeOf(this, ctor.prototype);
+        return this._initialize(arg0, arg1);
+    }
+}
+//# sourceMappingURL=query.06.predicate.js.map

package/dist/query/query.06.predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.06.predicate.js","sourceRoot":"","sources":["../../src/query/query.06.predicate.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,OAAO,SAA0C,SAAQ,OAAU;IAChE,KAAK,CAAiC,CAAW,EAAE,WAA6B;QACrF,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,QAAQ,CAA4B,GAAG,UAAkB;QAC9D,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,YAAY,CAAC,MAAsB;QACxC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,MAAM,KAAK,GACT,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,QAAQ,IAAI,MAAM;YACxE,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,kBAAkB,CAAC,GAAa;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9D,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,gBAAgB;IACT,aAAa;QAClB,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;IACjC,CAAC;IAOM,OAAO,CACZ,IAA0E,EAC1E,IAAwC;QAExC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAQ,IAAY,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/query/query.07.groups.d.ts

@@ -0,0 +1,41 @@
+import { type ComponentType } from "../component.js";
+import { Entity } from "../entity/index.js";
+import { Iter, type FanInjectTuple, type MaybeResolvedInjectTuple } from "../inject.js";
+import { type World } from "../world/index.js";
+import { Predicate } from "./query.06.predicate.js";
+export declare class Group<K = unknown, R extends ComponentType[] = []> {
+    readonly key: K;
+    private readonly _world;
+    private readonly _entities;
+    constructor(world: World, key: K);
+    get count(): number;
+    has(e: Entity): boolean;
+    [Symbol.iterator](): IterableIterator<Entity>;
+    forEach(callback: (e: Entity) => void): void;
+    forEach<J extends FanInjectTuple>(components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(cursor: typeof Entity, components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(cursor: typeof Iter, components: readonly [...J], callback: (it: Iter, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+}
+export declare class Grouping {
+    readonly groups: Map<unknown, Group<unknown, []>>;
+    private readonly _world;
+    private readonly _keyOf;
+    private readonly _watchEids;
+    private readonly _entityKeys;
+    private _onGroupEnter;
+    private _onGroupExit;
+    constructor(world: World, keyOf: (e: Entity) => unknown, watchEids: Iterable<number>);
+    get(key: unknown): Group | undefined;
+    keys(): IterableIterator<unknown>;
+    setOnGroupEnter(callback: (group: Group) => void): void;
+    setOnGroupExit(callback: (key: unknown, group: Group) => void): void;
+    enter(e: Entity): void;
+    exit(e: Entity): void;
+    refresh(e: Entity, eid: number): void;
+    clear(): void;
+    private _assign;
+    private _addToBucket;
+    private _removeFromBucket;
+}
+export declare class Groups<R extends ComponentType[] = []> extends Predicate<R> {
+}

package/dist/query/query.07.groups.js

@@ -0,0 +1,110 @@
+import { forEachInjected, } from "../inject.js";
+import { Predicate } from "./query.06.predicate.js";
+export class Group {
+    constructor(world, key) {
+        this._entities = new Set();
+        this._world = world;
+        this.key = key;
+    }
+    get count() {
+        return this._entities.size;
+    }
+    has(e) {
+        return this._entities.has(e);
+    }
+    [Symbol.iterator]() {
+        return this._entities[Symbol.iterator]();
+    }
+    forEach(arg0, arg1, arg2) {
+        forEachInjected(this._world, this._entities, arg0, arg1, arg2);
+    }
+    /** @internal */
+    _add(e) {
+        this._entities.add(e);
+    }
+    /** @internal */
+    _remove(e) {
+        this._entities.delete(e);
+        return this._entities.size === 0;
+    }
+}
+export class Grouping {
+    constructor(world, keyOf, watchEids) {
+        this.groups = new Map();
+        this._entityKeys = new Map();
+        this._world = world;
+        this._keyOf = keyOf;
+        this._watchEids = new Set(watchEids);
+    }
+    get(key) {
+        return this.groups.get(key);
+    }
+    keys() {
+        return this.groups.keys();
+    }
+    setOnGroupEnter(callback) {
+        this._onGroupEnter = callback;
+    }
+    setOnGroupExit(callback) {
+        this._onGroupExit = callback;
+    }
+    enter(e) {
+        this._assign(e, this._keyOf(e));
+    }
+    exit(e) {
+        const key = this._entityKeys.get(e);
+        if (key !== undefined) {
+            this._removeFromBucket(e, key);
+        }
+        this._entityKeys.delete(e);
+    }
+    refresh(e, eid) {
+        if (!this._watchEids.has(eid)) {
+            return;
+        }
+        this._assign(e, this._keyOf(e));
+    }
+    clear() {
+        this.groups.clear();
+        this._entityKeys.clear();
+    }
+    _assign(e, newKey) {
+        const oldKey = this._entityKeys.get(e);
+        if (oldKey === newKey) {
+            return;
+        }
+        if (oldKey !== undefined) {
+            this._removeFromBucket(e, oldKey);
+        }
+        if (newKey === undefined) {
+            this._entityKeys.delete(e);
+            return;
+        }
+        this._addToBucket(e, newKey);
+        this._entityKeys.set(e, newKey);
+    }
+    _addToBucket(e, key) {
+        let group = this.groups.get(key);
+        if (group === undefined) {
+            group = new Group(this._world, key);
+            this.groups.set(key, group);
+            group._add(e);
+            this._onGroupEnter?.(group);
+            return;
+        }
+        group._add(e);
+    }
+    _removeFromBucket(e, key) {
+        const group = this.groups.get(key);
+        if (group === undefined) {
+            return;
+        }
+        if (group._remove(e)) {
+            this.groups.delete(key);
+            this._onGroupExit?.(key, group);
+        }
+    }
+}
+export class Groups extends Predicate {
+}
+//# sourceMappingURL=query.07.groups.js.map

package/dist/query/query.07.groups.js.map

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