@vworlds/vecs 1.0.10 → 1.0.12

package/dist/system.js

@@ -1,9 +1,10 @@
 import { Query } from "./query.js";
 import { Phase } from "./phase.js";
+import { ALWAYS_TICK_SOURCE, IntervalTickSource, RateTickSource, } from "./timer.js";
 /**
- * A reactive processor that operates on a filtered subset of world entities.
+ * A reactive processor running over a filtered subset of world entities.
  *
- * Systems are created and registered through {@link World.system}:
+ * Systems are created and configured through {@link World.system}:
  *
  * ```ts
  * world.system("Move")
@@ -14,9 +15,9 @@ import { Phase } from "./phase.js";
  *   .exit((e) => { console.log("entity left", e.eid); });
  * ```
  *
- * All builder methods return `this` for chaining. Call {@link World.start}
- * once all systems are registered; after that, drive the loop with
- * {@link World.runPhase}.
+ * Every builder method returns `this` for chaining. After registering systems
+ * call {@link World.start} once, then drive the loop with
+ * {@link World.runPhase} or {@link World.progress}.
  *
  * Internally each system holds a single ordered **inbox** of routed events
  * (`enter`, `exit`, `update`). The world appends to it during command-queue
@@ -25,67 +26,62 @@ import { Phase } from "./phase.js";
  *
  * ### Component injection and type inference
  *
- * `enter`, `exit`, `update`, `each`, and `sort` all accept an array of
- * component classes that are resolved from the entity and passed as a typed
- * tuple to the callback. Use `{ parent: SomeComponent }` to resolve from the
- * entity's parent instead of the entity itself.
+ * `enter`, `exit`, `update`, `each`, and `sort` accept an array of component
+ * classes resolved from the entity and passed as a typed tuple to the
+ * callback. Use `{ parent: SomeComponent }` to resolve from the entity's
+ * parent instead of the entity itself.
  *
- * Components declared via {@link requires} (or the second argument of
- * {@link query}) are tracked as a type parameter `R` on the system. In
- * `sort`, `each`, and `update` inject callbacks, those components appear as
- * non-nullable; any component not in `R` remains `Type | undefined`.
+ * Components declared via {@link requires} (or the `_guaranteed` argument of
+ * {@link query}) are tracked as the type parameter `R`. Inside `sort`,
+ * `each`, and `update` injection callbacks they are non-nullable; any other
+ * component remains `Type | undefined`.
+ *
+ * @typeParam R - Component classes guaranteed present on every matched entity.
  */
 export class System extends Query {
     constructor(name, world) {
         super(name, world, false);
-        this.inbox = [];
+        /** @internal Single inbox replayed in arrival order on every `_run`. */
+        this._inbox = [];
+        /** @internal Whether this system processes events and runs callbacks. */
+        this._enabled = true;
+        /** @internal Cadence source for this system. Defaults to every frame. */
+        this._tickSource = ALWAYS_TICK_SOURCE;
     }
     /**
-     * Assign this system to a pipeline phase.
-     *
-     * The phase can be specified by name (the world will resolve it at
-     * {@link World.start | start} time) or by an {@link IPhase} reference
-     * returned from {@link World.addPhase}. Systems without an explicit phase
-     * are placed in the built-in `"update"` phase.
-     *
-     * @param p - Phase name or `IPhase` reference.
-     * @returns `this` for chaining.
+     * @internal Routing entry: register query membership for `e`, push an
+     * inbox `enter` event when an `enter` callback is registered, and bridge
+     * watched components through {@link _notifyModified} to surface them as
+     * inbox `update` events on entry.
      */
-    phase(p) {
-        if (typeof p !== "string") {
-            if (!(p instanceof Phase)) {
-                throw "Invalid Phase object";
-            }
-            if (p.world !== this.world) {
-                throw "Phase does not belong to this system's world";
-            }
-        }
-        this._phase = p;
-        return this;
-    }
-    /** @internal Routing entry: register membership and enqueue an enter event. */
     _enter(e) {
         this._entities?.add(e);
         e._addQueryMembership(this);
+        if (!this._enabled) {
+            return;
+        }
         if (this._enterCallback !== undefined) {
-            this.inbox.push({ kind: 0 /* InboxCommand.Enter */, entity: e });
+            this._inbox.push({ kind: 0 /* InboxCommand.Enter */, entity: e });
         }
-        // Bridge: surface watched components on entry through `notifyModified`,
-        // which on System pushes inbox `update` events.
-        e.forEachComponent((c) => {
-            if (this.watchlistBitmask.hasBit(c.bitPtr)) {
-                this.notifyModified(c);
+        e.components.forEach((c) => {
+            if (this._watchlistBitmask.hasBit(c.bitPtr)) {
+                this._notifyModified(c);
             }
         });
     }
-    /** @internal Routing entry: deregister membership and enqueue an exit event. */
+    /**
+     * @internal Routing entry: deregister query membership for `e` and push an
+     * inbox `exit` event when an `exit` callback is registered, capturing a
+     * snapshot of the components the callback wants to inject so they remain
+     * resolvable after the underlying components are removed.
+     */
     _exit(e) {
         this._entities?.delete(e);
         e._removeQueryMembership(this);
+        if (!this._enabled) {
+            return;
+        }
         if (this._exitCallback !== undefined) {
-            // Only snapshot the types the callback injects, and only direct (non-parent)
-            // ones — resolved at registration time. Parent refs are read from e.parent
-            // at callback time. Undefined when the callback takes no injection.
             let snapshot;
             if (this._exitSnapshotTypes && this._exitSnapshotTypes.length > 0) {
                 snapshot = new Map();
@@ -96,26 +92,37 @@ export class System extends Query {
                     }
                 }
             }
-            this.inbox.push({ kind: 1 /* InboxCommand.Exit */, entity: e, snapshot });
+            this._inbox.push({ kind: 1 /* InboxCommand.Exit */, entity: e, snapshot });
         }
     }
-    /** @internal Routing entry: enqueue an update event if the watchlist matches. */
-    notifyModified(c) {
-        if (!this.watchlistBitmask.hasBit(c.bitPtr)) {
+    /**
+     * @internal Routing entry: push an inbox `update` event when the modified
+     * component matches the watchlist.
+     */
+    _notifyModified(c) {
+        if (!this._enabled || !this._watchlistBitmask.hasBit(c.bitPtr)) {
             return;
         }
-        this.inbox.push({ kind: 2 /* InboxCommand.Update */, component: c });
+        this._inbox.push({ kind: 2 /* InboxCommand.Update */, component: c });
     }
     /**
      * @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.
+     * the `run` callback, then the `each` callback for every tracked entity.
+     *
+     * The whole body executes inside a `World.defer` scope; mutations made by
+     * callbacks land in the world queue and are processed when `_run` returns.
      */
     _run(now, delta) {
+        if (!this._enabled) {
+            return;
+        }
+        if (!this._tickSource.didTick) {
+            return;
+        }
+        const tickDelta = this._tickSource.lastFireDelta;
         this.world.defer(() => {
-            for (let i = 0; i < this.inbox.length; i++) {
-                const event = this.inbox[i];
+            for (let i = 0; i < this._inbox.length; i++) {
+                const event = this._inbox[i];
                 switch (event.kind) {
                     case 0 /* InboxCommand.Enter */:
                         this._enterCallback(event.entity);
@@ -124,61 +131,155 @@ export class System extends Query {
                         this._exitCallback(event.entity, event.snapshot);
                         break;
                     case 2 /* InboxCommand.Update */:
-                        const callback = this.componentUpdateCallbacks.get(event.component.type);
+                        const callback = this._componentUpdateCallbacks.get(event.component.type);
                         if (callback) {
                             callback(event.component);
                         }
                         break;
                 }
             }
-            this.inbox.length = 0;
+            this._inbox.length = 0;
             if (this._runCallback) {
-                this._runCallback(now, delta);
+                this._runCallback(now, tickDelta);
             }
-            if (this.eachCallback) {
-                const cb = this.eachCallback;
+            if (this._eachCallback) {
+                const cb = this._eachCallback;
                 this.forEach((e) => cb(e));
             }
         });
     }
+    /** True when this system's cadence source fired during the current frame. */
+    get didTick() {
+        return this._tickSource.didTick;
+    }
+    /** Milliseconds accumulated into this system's most recent fire. */
+    get lastFireDelta() {
+        return this._tickSource.lastFireDelta;
+    }
+    /** @internal Evaluate this system's cadence source for a frame. */
+    _evalTick(delta, frameId) {
+        return this._tickSource._evalTick(delta, frameId);
+    }
+    /** @internal Register this system source and its current cadence source. */
+    _register(world) {
+        world._registerTickSource(this);
+        this._tickSource._register(world);
+    }
+    /**
+     * Run this system at a fixed interval, expressed in seconds.
+     *
+     * This is seconds, unlike `World.beginFrame`, `World.progress`, and
+     * `runPhase`, which receive millisecond deltas. Calling `interval` replaces
+     * the current cadence source with an {@link IntervalTickSource}. When this
+     * system has a cadence source, the `delta` passed to {@link run} is the
+     * accumulated milliseconds since the previous fire, not the per-frame delta.
+     *
+     * @param seconds - Positive interval duration in seconds.
+     * @returns This system, for chaining.
+     * @throws When `seconds` is less than or equal to zero.
+     *
+     * @example
+     * ```ts
+     * world.system("AI")
+     *   .interval(0.5)
+     *   .run((now, delta) => tickAI(delta));
+     * ```
+     */
+    interval(seconds) {
+        this._setTickSource(new IntervalTickSource(seconds));
+        return this;
+    }
+    rate(n, source) {
+        this._setTickSource(new RateTickSource(n, source ?? this._tickSource));
+        return this;
+    }
     /**
-     * Register a per-tick callback that runs every time this system's phase
-     * executes, regardless of entity membership.
+     * Run this system only when another timer or system ticks.
+     *
+     * Calling `tickSource` mirrors `source` directly; no wrapper source is
+     * created. Use `.tickSource(source).rate(n)` or `.rate(n, source)` when this
+     * system should divide an upstream source. The `delta` passed to {@link run}
+     * is the accumulated milliseconds since this system last fired.
      *
-     * Use this for logic that is not driven by component updates — polling,
+     * @param source - Tick source or system source to mirror.
+     * @returns This system, for chaining.
+     *
+     * @example
+     * ```ts
+     * const second = new IntervalTickSource(1);
+     * world.system("Logger").tickSource(second).run(logStats);
+     * ```
+     */
+    tickSource(source) {
+        this._setTickSource(source);
+        return this;
+    }
+    _setTickSource(source) {
+        this._tickSource = source;
+        source._register(this.world);
+    }
+    /**
+     * Assign this system to a pipeline phase.
+     *
+     * Pass either a phase name (resolved at {@link World.start}) or an
+     * {@link IPhase} reference returned from {@link World.addPhase}. Systems
+     * with no explicit phase fall into the built-in `"update"` phase.
+     *
+     * @param p - Phase name or `IPhase` reference.
+     * @returns This system, for chaining.
+     * @throws When the phase reference is not a `Phase`, or belongs to a
+     *   different world.
+     */
+    phase(p) {
+        if (typeof p !== "string") {
+            if (!(p instanceof Phase)) {
+                throw "Invalid Phase object";
+            }
+            if (p.world !== this.world) {
+                throw "Phase does not belong to this system's world";
+            }
+        }
+        this._phase = p;
+        return this;
+    }
+    /**
+     * Register a per-tick callback fired every time this system's phase runs,
+     * regardless of entity membership.
+     *
+     * Use it for logic that is not driven by component changes — polling,
      * network flushing, global timers, etc.
      *
      * @param callback - Receives `now` (absolute timestamp in ms) and `delta`
-     *   (ms since the last tick).
-     * @returns `this` for chaining.
+     *   (ms since the previous tick). If the system has an active interval,
+     *   rate, or tick source, `delta` is the accumulated milliseconds since this
+     *   system last fired.
+     * @returns This system, for chaining.
      */
     run(callback) {
         this._runCallback = callback;
         return this;
     }
     /**
-     * Register a callback that fires **every tick** for every entity currently
-     * tracked by this system, with the listed components resolved from each
-     * entity.
+     * Register a callback fired **every tick** for **every tracked entity**,
+     * unconditionally, with the listed components resolved from each entity.
      *
      * Unlike {@link update} (which only fires when `component.modified()` is
-     * called), `each` fires unconditionally on every tick the system runs,
-     * once per tracked entity. Components declared via {@link requires} are
-     * guaranteed non-null in the resolved tuple; any other component class
-     * may be `undefined` if the entity lacks it.
+     * called), `each` fires every tick the system runs, once per tracked entity.
+     * Components declared via {@link requires} are non-nullable in the resolved
+     * tuple; any other component class may be `undefined` if the entity lacks it.
      *
      * `each` does **not** modify the system's query — define membership with
      * {@link requires} or {@link query} as usual. It does, however, implicitly
      * enable {@link track}, so matched entities are exposed via {@link entities}.
      *
-     * Only a single `each` callback may be registered per system; calling
-     * `each` a second time throws.
+     * Only one `each` callback may be registered per system; calling `each` a
+     * second time throws.
      *
      * @param components - Component classes to resolve from each entity.
      * @param callback - Receives the entity and a tuple of resolved component
-     *   instances (`undefined` for components not covered by {@link requires}).
-     * @returns `this` for chaining.
-     * @throws If `each` has already been registered on this system.
+     *   instances (`undefined` for any not covered by {@link requires}).
+     * @returns This system, for chaining.
+     * @throws When `each` has already been registered on this system.
      *
      * @example
      * ```ts
@@ -191,71 +292,109 @@ export class System extends Query {
      * ```
      */
     each(components, callback) {
-        if (this.eachCallback) {
+        if (this._eachCallback) {
             throw `each already registered for system '${this.name}'`;
         }
         this.track();
         const types = components.map((C) => this.world.getComponentType(C));
-        this.eachCallback = (e) => {
+        this._eachCallback = (e) => {
             const resolved = types.map((t) => e.get(t));
             callback(e, resolved);
         };
         return this;
     }
     /**
-     * Not supported on `System`. Throws unconditionally.
+     * Set the entity-membership predicate using a {@link QueryDSL} expression.
+     *
+     * Replaces any implicit query derived from `update` watchlists and any
+     * previous `requires` call. After calling `query`, watchlist auto-expansion
+     * via `update` is disabled.
      *
-     * Systems are owned by the world for the duration of the session. If you
-     * need a temporary reactive set, use a standalone {@link Query} instead.
+     * The optional `_guaranteed` tuple is a pure type-level hint — see
+     * {@link Query.query} for details.
+     *
+     * @param q - Query expression.
+     * @param _guaranteed - Component classes guaranteed present on every matched
+     *   entity (type hint only — not validated at runtime).
+     * @returns This system, retyped with the guaranteed tuple as its `R`.
      */
-    destroy() {
-        throw `destroy() is not supported on System '${this.name}'`;
+    query(q, _guaranteed) {
+        super.query(q, _guaranteed);
+        return this;
     }
     /**
-     * Set the entity membership predicate using the {@link QueryDSL} DSL.
+     * Shorthand for `query([...components])` — tracks entities that have **all**
+     * of the listed component types.
      *
-     * Replaces any implicit query derived from `update` watchlists and any
-     * previous `requires` call. After calling `query`, auto-expanding of
-     * `update` watchlists is disabled.
+     * Equivalent to `query({ HAS: components })`. The listed components are also
+     * recorded in the type parameter `R`, so {@link sort}, {@link each}, and
+     * {@link update} callbacks treat them as non-nullable.
+     *
+     * @param components - Component classes to require.
+     * @returns This system, retyped with the required tuple as its `R`.
+     */
+    requires(...components) {
+        super.requires(...components);
+        return this;
+    }
+    /**
+     * Disable this system.
      *
-     * The optional `guaranteed` tuple is a pure type-level hint: it tells
-     * `sort`, `each`, and `update` callbacks which components are guaranteed
-     * to be present on every matched entity, eliminating `| undefined` from
-     * those positions. It has no effect at runtime.
+     * While disabled the system is effectively invisible: the inbox is cleared
+     * immediately, any new `enter`, `exit`, or `update` events are silently
+     * dropped, and {@link _run} returns without executing any callbacks. Entity
+     * membership in the underlying query is still maintained so the tracked set
+     * remains consistent and the system resumes correctly when
+     * {@link enable} is called.
      *
-     * @param q - A {@link QueryDSL} expression.
-     * @param _guaranteed - Component classes guaranteed present on every matched
-     *   entity (type hint only — not validated at runtime).
-     * @returns `this` for chaining.
+     * Disabling is independent from tick-source cadence: `disable` suppresses
+     * callbacks, but a disabled system used as a tick source still drives
+     * downstream consumers. Use `stop()` on an external `IntervalTickSource` or
+     * `RateTickSource` reference to halt that clock itself.
+     *
+     * Calling `disable` on an already-disabled system is a no-op.
+     *
+     * @returns This system, for chaining.
      *
      * @example
      * ```ts
-     * world.system("Move")
-     *   .query({ AND: [{ HAS: Position }, { HAS: Velocity }] }, [Position, Velocity])
-     *   .each([Position, Velocity], (e, [pos, vel]) => {
-     *     pos.x += vel.vx;  // no ! needed
-     *   });
+     * const sys = world.system("AI").requires(Enemy).run(runAI);
+     * // Pause AI processing during a cutscene:
+     * sys.disable();
+     * // Resume:
+     * sys.enable();
      * ```
      */
-    query(q, _guaranteed) {
-        super.query(q, _guaranteed);
+    disable() {
+        this._enabled = false;
+        this._inbox.length = 0;
         return this;
     }
     /**
-     * Shorthand for `query([...components])` — the system tracks entities that
-     * have **all** of the listed component types.
+     * Enable this system after a previous {@link disable} call.
      *
-     * Equivalent to `query({ HAS: components })`. Unlike `query`, passing
-     * component classes here also informs the types of {@link sort} and
-     * {@link each} callbacks: listed components will be non-nullable in those
-     * tuples.
+     * Once re-enabled the system resumes its normal tick behaviour: enter, exit,
+     * and update events are queued, and {@link _run} processes the inbox and fires
+     * all registered callbacks. Events that occurred while the system was disabled
+     * are not replayed.
      *
-     * @param components - One or more component classes.
-     * @returns `this` for chaining.
+     * Calling `enable` on an already-enabled system is a no-op.
+     *
+     * @returns This system, for chaining.
      */
-    requires(...components) {
-        super.requires(...components);
+    enable() {
+        this._enabled = true;
         return this;
     }
+    /**
+     * Not supported on `System`. Throws unconditionally.
+     *
+     * Systems are owned by the world for the duration of the session; if you
+     * need a temporary reactive set use a standalone {@link Query} via
+     * {@link World.query}.
+     */
+    destroy() {
+        throw `destroy() is not supported on System '${this.name}'`;
+    }
 }
 //# sourceMappingURL=system.js.map

package/dist/system.js.map

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

package/dist/timer.d.ts

@@ -0,0 +1,50 @@
+/** A clock that the world evaluates once per frame. */
+export interface ITickSource {
+    /** True when this source fired during the current frame. */
+    readonly didTick: boolean;
+    /** Milliseconds accumulated into the most recent fire. */
+    readonly lastFireDelta: number;
+}
+/** Shared state and start/stop control for concrete tick sources. */
+declare abstract class BaseTickSource implements ITickSource {
+    get didTick(): boolean;
+    get lastFireDelta(): number;
+    /** Resume this source without replaying time elapsed while stopped. */
+    start(): this;
+    /** Pause this source, freezing accumulators and counters until `start()`. */
+    stop(): this;
+}
+/** Fires every `intervalSeconds` of accumulated wall-clock time. */
+export declare class IntervalTickSource extends BaseTickSource {
+    private readonly _intervalMs;
+    private _accumulator;
+    /**
+     * Create an interval source.
+     *
+     * Intervals are expressed in seconds, unlike `World.progress` and
+     * `World.beginFrame`, which receive millisecond deltas. Large deltas produce
+     * at most one tick; residual time is preserved by subtracting the interval.
+     *
+     * @param intervalSeconds - Positive interval duration in seconds.
+     * @throws When `intervalSeconds` is less than or equal to zero.
+     */
+    constructor(intervalSeconds: number);
+}
+/** Fires every `rate` ticks of `source`, or every `rate` frames without one. */
+export declare class RateTickSource extends BaseTickSource {
+    private readonly _rate;
+    private _counter;
+    /**
+     * Create a rate filter.
+     *
+     * Without `source`, this counts world frames. With `source`, it counts ticks
+     * from that upstream clock. The source is immutable, so cyclic source graphs
+     * cannot be constructed through the public API.
+     *
+     * @param rate - Positive integer tick divisor.
+     * @param source - Optional upstream source to divide.
+     * @throws When `rate` is not a positive integer.
+     */
+    constructor(rate: number, source?: ITickSource);
+}
+export {};