@vworlds/vecs 1.0.8 → 1.0.10

package/dist/query.d.ts

@@ -1,9 +1,12 @@
+import { ArrayMap } from "./util/array_map.js";
+import { Bitset } from "./util/bitset.js";
 import { Component } from "./component.js";
 import type { Entity } from "./entity.js";
 import { type World } from "./world.js";
 import { type EntityTestFunc, type QueryDSL, type MaybeRequired } from "./dsl.js";
 export type { EntityTestFunc, QueryDSL, MaybeRequired };
-type EntityCallback = (e: Entity) => void;
+type EntityCallback = (e: Entity, snapshot?: Map<number, Component>) => void;
+type ComponentCallback = (c: Component) => void;
 type ComponentOrParent = typeof Component | {
     parent: typeof Component;
 };
@@ -15,18 +18,18 @@ type ComponentInstance<T> = T extends {
  * expression.
  *
  * `Query` tracks every entity whose component set satisfies the predicate set
- * via {@link requires} or {@link query}. Entry and exit callbacks fire
- * automatically as entities gain or lose matching components. The tracked set
- * is exposed via {@link entities} and {@link forEach}.
+ * via {@link requires} or {@link query}. Entry, exit, and update callbacks
+ * fire automatically when the world's command queue is processed. The tracked
+ * set is exposed via {@link entities} and {@link forEach}.
  *
- * {@link System} extends `Query` and adds per-tick runtime concerns
- * (`update`, `each`, `run`). Use `Query` directly when you only need the
- * reactive entity set without pipeline integration.
+ * {@link System} extends `Query` and queues callbacks for its next `_run`
+ * rather than firing them immediately. Use `Query` directly when you want
+ * synchronous reactive callbacks without pipeline integration.
  *
  * ### Type parameter `R`
  * Tracks which component classes are "required" (declared via {@link requires}
  * or the `_guaranteed` hint of {@link query}). Those components appear as
- * non-nullable in {@link sort} callbacks.
+ * non-nullable in {@link sort}, {@link forEach}, and {@link update} callbacks.
  */
 export declare class Query<R extends (typeof Component)[] = []> {
     /** Unique name for this query, used in logs and debug output. */
@@ -34,10 +37,16 @@ export declare class Query<R extends (typeof Component)[] = []> {
     /** The world that owns this query. */
     readonly world: World;
     protected _entities: Set<Entity> | undefined;
-    protected _enterCallback: EntityCallback[];
-    protected _exitCallback: EntityCallback[];
+    protected _enterCallback: EntityCallback | undefined;
+    protected _exitCallback: EntityCallback | undefined;
+    /** @internal Direct component type ids that the exit callback injects; undefined when no injection. */
+    protected _exitSnapshotTypes: number[] | undefined;
     protected _belongs: EntityTestFunc;
     protected hasQuery: boolean;
+    /** @internal Per-component-type update callbacks. */
+    protected componentUpdateCallbacks: ArrayMap<ComponentCallback>;
+    /** @internal Bitmask of component types this query is watching for updates. */
+    protected watchlistBitmask: Bitset;
     constructor(
     /** Unique name for this query, used in logs and debug output. */
     name: string, 
@@ -67,6 +76,11 @@ export declare class Query<R extends (typeof Component)[] = []> {
     /**
      * Iterate over every entity currently tracked by this query.
      *
+     * Mutations made by `callback` are buffered into the world command queue
+     * (deferred mode) and only become visible after iteration finishes. Nested
+     * iteration inside an already-deferred context (a system, another forEach)
+     * inherits the outer deferred scope and does not drain on exit.
+     *
      * @param callback - Called once per tracked entity, in insertion order
      *   (or sort order when {@link sort} is configured).
      */
@@ -88,11 +102,26 @@ export declare class Query<R extends (typeof Component)[] = []> {
     }) => void): void;
     /** Returns `true` if the entity satisfies this query's predicate. */
     belongs(e: Entity): boolean;
-    /** Hook for subclasses — called when a component on an entity in this query changes. */
-    notifyModified(_c: Component): void;
-    /** @internal Fires enter callbacks and adds entity to the tracked set. */
+    /**
+     * @internal Called by the world during command-queue routing when a Set
+     * command targets an entity that this query currently tracks. Default:
+     * fires the user-registered `update` callback for the component's type.
+     * `System` overrides this to push into its inbox instead.
+     */
+    notifyModified(c: Component): void;
+    /**
+     * @internal Adds the entity to the tracked set, registers query membership
+     * on the entity, fires registered enter callbacks, then bridges any
+     * already-attached watched components through `notifyModified` so that
+     * `update` callbacks see the entity once on entry. `System` overrides this
+     * to push inbox events (events fire later in `_run`).
+     */
     _enter(e: Entity): void;
-    /** @internal Fires exit callbacks and removes entity from the tracked set. */
+    /**
+     * @internal Removes the entity from the tracked set, deregisters query
+     * membership, and fires registered exit callbacks. `System` overrides this
+     * to also push an inbox event.
+     */
     _exit(e: Entity): void;
     /**
      * Register a callback that fires when an entity **enters** this query
@@ -126,10 +155,6 @@ export declare class Query<R extends (typeof Component)[] = []> {
      * (its components no longer satisfy the predicate, or it was destroyed) with
      * injected components.
      *
-     * Components that were just removed are still accessible via `get_deleted`
-     * semantics — the injected tuple includes them even though they are no
-     * longer in the entity's active component set.
-     *
      * @param inject - Component classes to resolve and inject.
      * @param callback - Receives the entity and the resolved component tuple.
      * @returns `this` for chaining.
@@ -144,6 +169,52 @@ export declare class Query<R extends (typeof Component)[] = []> {
      * @returns `this` for chaining.
      */
     exit(callback: (e: Entity) => void): this;
+    /**
+     * Register a callback that fires when a component of type `ComponentClass`
+     * is modified on any entity tracked by this query.
+     *
+     * On a {@link Query}, callbacks fire **immediately** when the world's
+     * command queue routes the corresponding `Set` command. On a {@link System},
+     * the event is buffered in the system's inbox and the callback fires during
+     * the system's next `_run`.
+     *
+     * If no other predicate has been set on this query, the watchlist
+     * automatically expands to require `ComponentClass` (equivalent to adding
+     * it to a `requires` / `HAS` query).
+     *
+     * @param ComponentClass - The component class to watch.
+     * @param callback - Receives the modified component instance.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * world.system("RenderPosition")
+     *   .update(Position, (pos) => {
+     *     sprite.setPosition(pos.x, pos.y);
+     *   });
+     * ```
+     */
+    update<C extends typeof Component>(ComponentClass: C, callback: (c: InstanceType<C>) => void): this;
+    /**
+     * Register a callback that fires when `ComponentClass` is modified, with
+     * additional components injected from the same entity.
+     *
+     * @param ComponentClass - The component class to watch.
+     * @param inject - Additional component classes to resolve from the entity.
+     * @param callback - Receives the modified component and the injected tuple.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * world.system("SyncSprite")
+     *   .update(Position, [Sprite], (pos, [sprite]) => {
+     *     sprite.sprite.setPosition(pos.x, pos.y);
+     *   });
+     * ```
+     */
+    update<C extends typeof Component, J extends (typeof Component)[]>(ComponentClass: C, inject: readonly [...J], callback: (c: InstanceType<C>, injected: {
+        [K in keyof J]: MaybeRequired<J[K], R>;
+    }) => void): this;
     /**
      * Enable sorted entity tracking: matched entities are stored in insertion
      * order determined by `compare`, which receives a tuple of resolved

package/dist/query.js

@@ -1,23 +1,25 @@
 import { OrderedSet } from "./util/ordered_set.js";
-import { buildEntityTest } from "./dsl.js";
+import { ArrayMap } from "./util/array_map.js";
+import { Bitset } from "./util/bitset.js";
+import { HAS, buildEntityTest, } from "./dsl.js";
 const EMPTY_ENTITIES = new Set();
 /**
  * A reactive, always-updated list of entities that match a given query
  * expression.
  *
  * `Query` tracks every entity whose component set satisfies the predicate set
- * via {@link requires} or {@link query}. Entry and exit callbacks fire
- * automatically as entities gain or lose matching components. The tracked set
- * is exposed via {@link entities} and {@link forEach}.
+ * via {@link requires} or {@link query}. Entry, exit, and update callbacks
+ * fire automatically when the world's command queue is processed. The tracked
+ * set is exposed via {@link entities} and {@link forEach}.
  *
- * {@link System} extends `Query` and adds per-tick runtime concerns
- * (`update`, `each`, `run`). Use `Query` directly when you only need the
- * reactive entity set without pipeline integration.
+ * {@link System} extends `Query` and queues callbacks for its next `_run`
+ * rather than firing them immediately. Use `Query` directly when you want
+ * synchronous reactive callbacks without pipeline integration.
  *
  * ### Type parameter `R`
  * Tracks which component classes are "required" (declared via {@link requires}
  * or the `_guaranteed` hint of {@link query}). Those components appear as
- * non-nullable in {@link sort} callbacks.
+ * non-nullable in {@link sort}, {@link forEach}, and {@link update} callbacks.
  */
 export class Query {
     constructor(
@@ -27,10 +29,16 @@ export class Query {
     world, track = true) {
         this.name = name;
         this.world = world;
-        this._enterCallback = [];
-        this._exitCallback = [];
+        this._enterCallback = undefined;
+        this._exitCallback = undefined;
+        /** @internal Direct component type ids that the exit callback injects; undefined when no injection. */
+        this._exitSnapshotTypes = undefined;
         this._belongs = (_e) => false;
         this.hasQuery = false;
+        /** @internal Per-component-type update callbacks. */
+        this.componentUpdateCallbacks = new ArrayMap();
+        /** @internal Bitmask of component types this query is watching for updates. */
+        this.watchlistBitmask = new Bitset();
         world._addQuery(this);
         if (track) {
             this.track();
@@ -58,11 +66,12 @@ export class Query {
         if (this._entities === undefined) {
             return;
         }
-        this.world._forEachEntity((e) => {
-            if (this.belongs(e) && !this._entities.has(e)) {
-                e._addQuery(this);
-                e._updateQueries();
-            }
+        this.world.defer(() => {
+            this.world.entities.forEach((e) => {
+                if (this.belongs(e) && !e.isInQuery(this)) {
+                    this._enter(e);
+                }
+            });
         });
     }
     /**
@@ -76,57 +85,128 @@ export class Query {
         return this._entities ?? EMPTY_ENTITIES;
     }
     forEach(componentsOrCallback, callback) {
-        if (typeof componentsOrCallback === "function") {
-            this._entities?.forEach(componentsOrCallback);
-        }
-        else {
-            if (!this._entities || !this.world) {
-                return;
+        this.world.beginDefer();
+        try {
+            if (typeof componentsOrCallback === "function") {
+                this._entities?.forEach(componentsOrCallback);
             }
-            const types = componentsOrCallback.map((C) => this.world.getComponentType(C));
-            this._entities.forEach((e) => {
-                const resolved = types.map((t) => e.get(t));
-                callback(e, resolved);
-            });
+            else {
+                if (!this._entities || !this.world) {
+                    return;
+                }
+                const types = componentsOrCallback.map((C) => this.world.getComponentType(C));
+                this._entities.forEach((e) => {
+                    const resolved = types.map((t) => e.get(t));
+                    callback(e, resolved);
+                });
+            }
+        }
+        finally {
+            this.world.endDefer();
         }
     }
     /** Returns `true` if the entity satisfies this query's predicate. */
     belongs(e) {
         return this._belongs(e);
     }
-    /** Hook for subclasses — called when a component on an entity in this query changes. */
-    notifyModified(_c) { }
-    /** @internal Fires enter callbacks and adds entity to the tracked set. */
+    /**
+     * @internal Called by the world during command-queue routing when a Set
+     * command targets an entity that this query currently tracks. Default:
+     * fires the user-registered `update` callback for the component's type.
+     * `System` overrides this to push into its inbox instead.
+     */
+    notifyModified(c) {
+        if (!this.watchlistBitmask.hasBit(c.bitPtr)) {
+            return;
+        }
+        const callback = this.componentUpdateCallbacks.get(c.type);
+        if (callback) {
+            callback(c);
+        }
+    }
+    /**
+     * @internal Adds the entity to the tracked set, registers query membership
+     * on the entity, fires registered enter callbacks, then bridges any
+     * already-attached watched components through `notifyModified` so that
+     * `update` callbacks see the entity once on entry. `System` overrides this
+     * to push inbox events (events fire later in `_run`).
+     */
     _enter(e) {
-        this._enterCallback.forEach((cb) => cb(e));
         this._entities?.add(e);
+        e._addQueryMembership(this);
+        this._enterCallback?.(e);
+        // Bridge: surface the entity's already-attached watched components as
+        // update events so `update` handlers fire once on entry without the user
+        // having to call `modified()` explicitly.
+        e.forEachComponent((c) => {
+            if (this.watchlistBitmask.hasBit(c.bitPtr)) {
+                this.notifyModified(c);
+            }
+        });
     }
-    /** @internal Fires exit callbacks and removes entity from the tracked set. */
+    /**
+     * @internal Removes the entity from the tracked set, deregisters query
+     * membership, and fires registered exit callbacks. `System` overrides this
+     * to also push an inbox event.
+     */
     _exit(e) {
-        this._exitCallback.forEach((cb) => cb(e));
+        this._exitCallback?.(e);
         this._entities?.delete(e);
+        e._removeQueryMembership(this);
     }
     enter(injectOrCallback, callback) {
         if (typeof injectOrCallback === "function") {
-            this._enterCallback.push(injectOrCallback);
+            this._enterCallback = injectOrCallback;
         }
         else {
             const inject = this.mapInjectedClassToTypes(injectOrCallback);
-            this._enterCallback.push((e) => {
+            this._enterCallback = (e) => {
                 callback(e, this.getInjected(e, inject));
-            });
+            };
         }
         return this;
     }
     exit(injectOrCallback, callback) {
         if (typeof injectOrCallback === "function") {
-            this._exitCallback.push(injectOrCallback);
+            this._exitCallback = injectOrCallback;
+            this._exitSnapshotTypes = undefined;
         }
         else {
             const inject = this.mapInjectedClassToTypes(injectOrCallback);
-            this._exitCallback.push((e) => {
-                callback(e, this.getInjected(e, inject, true));
-            });
+            // Only direct (non-parent) types need snapshotting; parent refs are read
+            // from e.parent at callback time, which is still alive.
+            this._exitSnapshotTypes = inject.filter((t) => typeof t === "number");
+            this._exitCallback = (e, exitSnapshot) => {
+                callback(e, this.getInjected(e, inject, exitSnapshot));
+            };
+        }
+        return this;
+    }
+    update(ComponentClass, injectOrCallback, callback) {
+        const type = this.world.getComponentType(ComponentClass);
+        if (typeof injectOrCallback === "function") {
+            callback = injectOrCallback;
+            this.componentUpdateCallbacks.set(type, callback);
+        }
+        else {
+            const inject = injectOrCallback;
+            const injectedComponentTypes = inject.map((C) => this.world.getComponentType(C));
+            const cb = (c) => {
+                const injected = [];
+                injectedComponentTypes.forEach((InjectedComponentType) => {
+                    injected.push(c.entity.get(InjectedComponentType));
+                });
+                if (callback) {
+                    callback(c, injected);
+                }
+            };
+            this.componentUpdateCallbacks.set(type, cb);
+        }
+        this.watchlistBitmask.add(type);
+        if (!this.hasQuery) {
+            const watchlist = this.watchlistBitmask.indices();
+            this._belongs = HAS(this.world, ...watchlist);
+            this.backfill();
         }
         return this;
     }
@@ -149,7 +229,7 @@ export class Query {
      */
     sort(components, compare) {
         const types = components.map((C) => this.world.getComponentType(C));
-        this._entities = new OrderedSet((a, b) => compare(types.map((t) => a.get(t, true)), types.map((t) => b.get(t, true))));
+        this._entities = new OrderedSet((a, b) => compare(types.map((t) => a.get(t)), types.map((t) => b.get(t))));
         this.backfill();
         return this;
     }
@@ -210,20 +290,18 @@ export class Query {
         this.query(components);
         return this;
     }
-    getComponent(e, C, considerDeleted) {
-        let c;
+    getComponent(e, C, exitSnapshot) {
         if (typeof C === "number") {
-            c = e.get(C, considerDeleted);
+            return exitSnapshot?.get(C) ?? e.get(C);
         }
         else {
-            c = e.parent && e.parent.get(C.parent, considerDeleted);
+            return e.parent?.get(C.parent);
         }
-        return c;
     }
-    getInjected(e, inject, considerDeleted = false) {
+    getInjected(e, inject, exitSnapshot) {
         const injected = [];
         inject.forEach((C) => {
-            const c = this.getComponent(e, C, considerDeleted);
+            const c = this.getComponent(e, C, exitSnapshot);
             if (!c) {
                 throw "query does not contain component";
             }

package/dist/query.js.map

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

package/dist/system.d.ts

@@ -1,5 +1,3 @@
-import { ArrayMap } from "./util/array_map.js";
-import { Bitset } from "./util/bitset.js";
 import { Component } from "./component.js";
 import { Query } from "./query.js";
 import { type QueryDSL, type MaybeRequired } from "./dsl.js";
@@ -7,7 +5,6 @@ import type { Entity } from "./entity.js";
 import { Phase, type IPhase } from "./phase.js";
 import { type World } from "./world.js";
 export type { QueryDSL as SystemQuery, EntityTestFunc } from "./dsl.js";
-type ComponentCallback = (c: Component) => void;
 type RunCallback = (now: number, delta: number) => void;
 /**
  * A reactive processor that operates on a filtered subset of world entities.
@@ -27,6 +24,11 @@ type RunCallback = (now: number, delta: number) => void;
  * once all systems are registered; after that, drive the loop with
  * {@link World.runPhase}.
  *
+ * Internally each system holds a single ordered **inbox** of routed events
+ * (`enter`, `exit`, `update`). The world appends to it during command-queue
+ * routing; the system replays the inbox at the top of every `_run` so
+ * callbacks observe events in arrival order.
+ *
  * ### Component injection and type inference
  *
  * `enter`, `exit`, `update`, `each`, and `sort` all accept an array of
@@ -40,13 +42,11 @@ type RunCallback = (now: number, delta: number) => void;
  * non-nullable; any component not in `R` remains `Type | undefined`.
  */
 export declare class System<R extends (typeof Component)[] = []> extends Query<R> {
-    protected componentUpdateCallbacks: ArrayMap<ComponentCallback>;
     protected eachCallback: ((e: Entity) => void) | undefined;
     private _runCallback;
-    private readonly updateQueue;
+    private readonly inbox;
     /** @internal */
     _phase: string | Phase | undefined;
-    protected watchlistBitmask: Bitset;
     constructor(name: string, world: World);
     /**
      * Assign this system to a pipeline phase.
@@ -60,13 +60,18 @@ export declare class System<R extends (typeof Component)[] = []> extends Query<R
      * @returns `this` for chaining.
      */
     phase(p: string | IPhase): this;
-    /** @internal Delivers a component-modified notification to this system. */
-    notifyModified(c: Component): void;
-    /** @internal Fires enter callbacks, adds entity to tracked set, queues component updates. */
+    /** @internal Routing entry: register membership and enqueue an enter event. */
     _enter(e: Entity): void;
-    /** @internal Fires exit callbacks, removes entity from tracked set, drains update queue. */
+    /** @internal Routing entry: deregister membership and enqueue an exit event. */
     _exit(e: Entity): void;
-    /** @internal Execute one tick: run `run`, fire `each`, then drain the update queue. */
+    /** @internal Routing entry: enqueue an update event if the watchlist matches. */
+    notifyModified(c: Component): void;
+    /**
+     * @internal Execute one tick: drain the inbox in arrival order, then run
+     * `runCallback` and `eachCallback`. The whole body runs in a deferred
+     * scope; any mutations made by callbacks land in the world queue and are
+     * processed by the world after `_run` returns.
+     */
     _run(now: number, delta: number): void;
     /**
      * Register a per-tick callback that runs every time this system's phase
@@ -80,47 +85,6 @@ export declare class System<R extends (typeof Component)[] = []> extends Query<R
      * @returns `this` for chaining.
      */
     run(callback: RunCallback): this;
-    /**
-     * Register a callback that fires when a component of type `ComponentClass`
-     * is modified on any entity in this system.
-     *
-     * The system will automatically begin tracking entities that have this
-     * component type (equivalent to adding it to a `requires` / `HAS` query)
-     * unless a custom {@link query} was already set.
-     *
-     * @param ComponentClass - The component class to watch.
-     * @param callback - Receives the modified component instance.
-     * @returns `this` for chaining.
-     *
-     * @example
-     * ```ts
-     * world.system("RenderPosition")
-     *   .update(Position, (pos) => {
-     *     sprite.setPosition(pos.x, pos.y);
-     *   });
-     * ```
-     */
-    update<C extends typeof Component>(ComponentClass: C, callback: (c: InstanceType<C>) => void): this;
-    /**
-     * Register a callback that fires when `ComponentClass` is modified, with
-     * additional components injected from the same entity.
-     *
-     * @param ComponentClass - The component class to watch.
-     * @param inject - Additional component classes to resolve from the entity.
-     * @param callback - Receives the modified component and the injected tuple.
-     * @returns `this` for chaining.
-     *
-     * @example
-     * ```ts
-     * world.system("SyncSprite")
-     *   .update(Position, [Sprite], (pos, [sprite]) => {
-     *     sprite.sprite.setPosition(pos.x, pos.y);
-     *   });
-     * ```
-     */
-    update<C extends typeof Component, J extends (typeof Component)[]>(ComponentClass: C, inject: readonly [...J], callback: (c: InstanceType<C>, injected: {
-        [K in keyof J]: MaybeRequired<J[K], R>;
-    }) => void): this;
     /**
      * Register a callback that fires **every tick** for every entity currently
      * tracked by this system, with the listed components resolved from each