@vworlds/vecs 1.0.11 → 1.0.13

package/dist/timer.js

@@ -0,0 +1,154 @@
+/** Shared state and start/stop control for concrete tick sources. */
+class BaseTickSource {
+    constructor() {
+        /** @internal */
+        this._didTick = false;
+        /** @internal */
+        this._running = true;
+        /** @internal */
+        this._lastEvaluatedFrame = -1;
+        /** @internal */
+        this._timeSinceLastTick = 0;
+        /** @internal Delta accumulated into the most recent tick, in milliseconds. */
+        this._lastFireDelta = 0;
+    }
+    get didTick() {
+        return this._didTick;
+    }
+    get lastFireDelta() {
+        return this._lastFireDelta;
+    }
+    /** Resume this source without replaying time elapsed while stopped. */
+    start() {
+        this._running = true;
+        return this;
+    }
+    /** Pause this source, freezing accumulators and counters until `start()`. */
+    stop() {
+        this._running = false;
+        return this;
+    }
+    /** @internal Register this source with `world`. */
+    _register(world) {
+        world._registerTickSource(this);
+    }
+}
+/** Fires every `intervalSeconds` of accumulated wall-clock time. */
+export class IntervalTickSource extends BaseTickSource {
+    /**
+     * 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) {
+        super();
+        this._accumulator = 0;
+        if (intervalSeconds <= 0) {
+            throw "interval seconds must be greater than 0";
+        }
+        this._intervalMs = intervalSeconds * 1000;
+    }
+    /** @internal */
+    _evalTick(deltaMs, frameId) {
+        if (this._lastEvaluatedFrame === frameId) {
+            return this._didTick;
+        }
+        this._lastEvaluatedFrame = frameId;
+        if (!this._running) {
+            this._didTick = false;
+            return false;
+        }
+        this._timeSinceLastTick += deltaMs;
+        this._accumulator += deltaMs;
+        let fired = false;
+        if (this._accumulator >= this._intervalMs) {
+            this._accumulator -= this._intervalMs;
+            fired = true;
+            this._lastFireDelta = this._timeSinceLastTick;
+            this._timeSinceLastTick = 0;
+        }
+        this._didTick = fired;
+        return fired;
+    }
+}
+/** Fires every `rate` ticks of `source`, or every `rate` frames without one. */
+export class RateTickSource extends BaseTickSource {
+    /**
+     * 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, source) {
+        super();
+        this._counter = 0;
+        if (!Number.isInteger(rate) || rate <= 0) {
+            throw "rate must be a positive integer";
+        }
+        this._rate = rate;
+        this._source = source;
+    }
+    /** @internal */
+    _evalTick(deltaMs, frameId) {
+        if (this._lastEvaluatedFrame === frameId) {
+            return this._didTick;
+        }
+        this._lastEvaluatedFrame = frameId;
+        if (!this._running) {
+            this._didTick = false;
+            return false;
+        }
+        const upstreamFired = this._source ? this._source._evalTick(deltaMs, frameId) : true;
+        const upstreamDelta = this._source ? this._source.lastFireDelta : deltaMs;
+        let fired = false;
+        if (upstreamFired) {
+            this._timeSinceLastTick += upstreamDelta;
+            this._counter++;
+            if (this._counter >= this._rate) {
+                this._counter = 0;
+                fired = true;
+                this._lastFireDelta = this._timeSinceLastTick;
+                this._timeSinceLastTick = 0;
+            }
+        }
+        this._didTick = fired;
+        return fired;
+    }
+    /** @internal */
+    _register(world) {
+        super._register(world);
+        this._source?._register(world);
+    }
+}
+/** @internal Singleton source used by systems with no explicit cadence. */
+class _AlwaysTickSource {
+    constructor() {
+        this._lastDelta = 0;
+    }
+    get didTick() {
+        return true;
+    }
+    get lastFireDelta() {
+        return this._lastDelta;
+    }
+    /** @internal */
+    _evalTick(deltaMs, _frameId) {
+        this._lastDelta = deltaMs;
+        return true;
+    }
+    /** @internal */
+    _register(_world) { }
+}
+/** @internal Shared default clock for unconfigured systems. */
+export const ALWAYS_TICK_SOURCE = new _AlwaysTickSource();
+//# sourceMappingURL=timer.js.map

package/dist/timer.js.map

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

package/dist/util/array_map.js

@@ -29,10 +29,11 @@ export class ArrayMap {
      * @param value - Value to store.
      */
     set(key, value) {
-        if (this._backend[key] === undefined) {
+        const backend = this._backend;
+        if (backend[key] === undefined) {
             this._size++;
         }
-        this._backend[key] = value;
+        backend[key] = value;
     }
     /**
      * Retrieve the value stored at `key`, or `undefined` if no entry exists.
@@ -56,8 +57,9 @@ export class ArrayMap {
      * @param key - Non-negative integer key.
      */
     delete(key) {
-        if (this._backend[key] !== undefined) {
-            this._backend[key] = undefined;
+        const backend = this._backend;
+        if (backend[key] !== undefined) {
+            backend[key] = undefined;
             this._size--;
         }
     }
@@ -67,11 +69,13 @@ export class ArrayMap {
      * @param callback - Invoked with `(value, key, map)` for each entry.
      */
     forEach(callback) {
-        this._backend.forEach((value, index) => {
+        const backend = this._backend;
+        for (let i = 0; i < backend.length; i++) {
+            const value = backend[i];
             if (value !== undefined) {
-                callback(value, index, this);
+                callback(value, i, this);
             }
-        });
+        }
     }
     /** Remove all entries and reset {@link size} to zero. */
     clear() {

package/dist/util/array_map.js.map

@@ -1 +1 @@
-{"version":3,"file":"array_map.js","sourceRoot":"","sources":["../../src/util/array_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,QAAQ;IAArB;QACU,aAAQ,GAAsB,EAAE,CAAC;QACjC,UAAK,GAAW,CAAC,CAAC;IAoE5B,CAAC;IAlEC,kDAAkD;IAClD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAQ;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;YACpC,IAAI,CAAC,KAAK,EAAE,CAAC;SACd;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,GAAW;QACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;YACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;SACd;IACH,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,QAA2D;QACxE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACrC,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;aAC9B;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IAClD,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"array_map.js","sourceRoot":"","sources":["../../src/util/array_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,QAAQ;IAArB;QACU,aAAQ,GAAsB,EAAE,CAAC;QACjC,UAAK,GAAW,CAAC,CAAC;IAwE5B,CAAC;IAtEC,kDAAkD;IAClD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAQ;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;SACd;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;YAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;SACd;IACH,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,QAA2D;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;aAC1B;SACF;IACH,CAAC;IAED,yDAAyD;IAClD,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF"}

package/dist/util/bitset.d.ts

@@ -10,7 +10,7 @@
  * compact bit-flag fields:
  *
  * ```ts
- * class Tags extends Component {
+ * class Tags {
  *   tags = new Bitset();
  * }
  *
@@ -33,12 +33,26 @@ export declare class Bitset {
      */
     addBit(bptr: BitPtr): void;
     /**
-     * Clear bit `n`. Trailing zero words are trimmed so the internal storage
-     * stays compact.
+     * Clear the bit described by `bptr` (fast path using a pre-computed
+     * {@link BitPtr}). Storage is not compacted automatically; call
+     * {@link compact} to trim trailing zero words when needed.
+     *
+     * @param bptr - Pre-computed pointer to a bit position.
+     */
+    deleteBit(bptr: BitPtr): void;
+    /**
+     * Clear bit `n`. Storage is not compacted automatically; call
+     * {@link compact} to trim trailing zero words when needed.
      *
      * @param n - Non-negative integer bit index.
      */
     delete(n: number): void;
+    /**
+     * Trim trailing zero words from the backing storage.
+     */
+    compact(): void;
+    /** Remove every set bit. */
+    clear(): void;
     /**
      * Return `true` when bit `n` is set.
      *

package/dist/util/bitset.js

@@ -10,7 +10,7 @@
  * compact bit-flag fields:
  *
  * ```ts
- * class Tags extends Component {
+ * class Tags {
  *   tags = new Bitset();
  * }
  *
@@ -29,9 +29,7 @@ export class Bitset {
      * @param n - Non-negative integer bit index.
      */
     add(n) {
-        const arrayIndex = Math.floor(n / 32);
-        const bitmask = 1 << (n % 32);
-        this._addIndexBitmask(arrayIndex, bitmask);
+        this._bits[n >>> 5] |= 1 << n;
     }
     /**
      * Set the bit described by `bptr` (fast path using a pre-computed
@@ -40,40 +38,53 @@ export class Bitset {
      * @param bptr - Pre-computed pointer to a bit position.
      */
     addBit(bptr) {
-        this._addIndexBitmask(bptr.arrayIndex, bptr.bitmask);
+        this._bits[bptr.arrayIndex] |= bptr.bitmask;
     }
     /**
-     * Clear bit `n`. Trailing zero words are trimmed so the internal storage
-     * stays compact.
+     * Clear the bit described by `bptr` (fast path using a pre-computed
+     * {@link BitPtr}). Storage is not compacted automatically; call
+     * {@link compact} to trim trailing zero words when needed.
+     *
+     * @param bptr - Pre-computed pointer to a bit position.
+     */
+    deleteBit(bptr) {
+        const current = this._bits[bptr.arrayIndex];
+        if (current) {
+            this._bits[bptr.arrayIndex] = current & ~bptr.bitmask;
+        }
+    }
+    /**
+     * Clear bit `n`. Storage is not compacted automatically; call
+     * {@link compact} to trim trailing zero words when needed.
      *
      * @param n - Non-negative integer bit index.
      */
     delete(n) {
-        const arrayIndex = Math.floor(n / 32);
+        const arrayIndex = n >>> 5;
         const current = this._bits[arrayIndex];
-        if (current === undefined) {
-            return;
-        }
-        else {
-            this._bits[arrayIndex] = current & ~(1 << (n % 32));
+        if (current) {
+            this._bits[arrayIndex] = current & ~(1 << n);
         }
+    }
+    /**
+     * Trim trailing zero words from the backing storage.
+     */
+    compact() {
         while (this._bits.length && this._bits[this._bits.length - 1] === 0) {
             this._bits.pop();
         }
     }
+    /** Remove every set bit. */
+    clear() {
+        this._bits.length = 0;
+    }
     /**
      * Return `true` when bit `n` is set.
      *
      * @param n - Non-negative integer bit index.
      */
     has(n) {
-        const arrayIndex = Math.floor(n / 32);
-        if (arrayIndex >= this._bits.length) {
-            return false;
-        }
-        const bitIndex = n % 32;
-        const bitmask = 1 << bitIndex;
-        return this._hasIndexBitmask(arrayIndex, bitmask);
+        return (this._bits[n >>> 5] & (1 << n)) !== 0;
     }
     /**
      * Return `true` when the bit described by `bptr` is set (fast path).
@@ -81,7 +92,7 @@ export class Bitset {
      * @param bptr - Pre-computed pointer to a bit position.
      */
     hasBit(bptr) {
-        return this._hasIndexBitmask(bptr.arrayIndex, bptr.bitmask);
+        return (this._bits[bptr.arrayIndex] & bptr.bitmask) !== 0;
     }
     /**
      * Return `true` when this bitset and `other` have exactly the same bits set.
@@ -89,7 +100,13 @@ export class Bitset {
      * @param other - Bitset to compare against.
      */
     equal(other) {
-        return (this._bits.length === other._bits.length && this._bits.every((v, i) => other._bits[i] === v));
+        const maxLength = Math.max(this._bits.length, other._bits.length);
+        for (let i = 0; i < maxLength; i++) {
+            if ((this._bits[i] || 0) !== (other._bits[i] || 0)) {
+                return false;
+            }
+        }
+        return true;
     }
     /**
      * Return `true` when every bit set in `other` is also set in this bitset
@@ -101,11 +118,11 @@ export class Bitset {
      * @param other - Bitset whose set bits must all appear in this bitset.
      */
     hasBitset(other) {
-        if (this._bits.length < other._bits.length) {
-            return false;
-        }
-        for (let i = 0; i < other._bits.length; i++) {
-            if ((this._bits[i] & other._bits[i]) !== (other._bits[i] || 0)) {
+        const bits = this._bits;
+        const otherBits = other._bits;
+        for (let i = 0; i < otherBits.length; i++) {
+            const otherWord = otherBits[i] | 0;
+            if ((bits[i] & otherWord) !== otherWord) {
                 return false;
             }
         }
@@ -177,8 +194,8 @@ export class BitPtr {
     /** The raw bit index this pointer refers to. */
     value) {
         this.value = value;
-        this.arrayIndex = Math.floor(value / 32);
-        this.bitmask = 1 << (value % 32);
+        this.arrayIndex = value >>> 5;
+        this.bitmask = 1 << value;
     }
     /**
      * Return `true` when both pointers refer to the same bit position.
@@ -186,7 +203,7 @@ export class BitPtr {
      * @param other - Pointer to compare against.
      */
     equals(other) {
-        return this.arrayIndex == other.arrayIndex && this.bitmask == other.bitmask;
+        return this.arrayIndex === other.arrayIndex && this.bitmask === other.bitmask;
     }
 }
 //# sourceMappingURL=bitset.js.map

package/dist/util/bitset.js.map

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

package/dist/world.d.ts

@@ -1,4 +1,4 @@
-import { Component, ComponentClassOrType, ComponentMeta, Hook } from "./component.js";
+import { type ComponentClass, ComponentClassOrType, ComponentMeta, Hook } from "./component.js";
 import { Entity } from "./entity.js";
 import { Query } from "./query.js";
 import { System } from "./system.js";
@@ -23,6 +23,9 @@ import { IPhase } from "./phase.js";
  * ```ts
  * const world = new World();
  *
+ * class Position { x = 0; y = 0; }
+ * class Velocity { vx = 0; vy = 0; }
+ *
  * world.registerComponent(Position);
  * world.registerComponent(Velocity);
  *
@@ -30,6 +33,7 @@ import { IPhase } from "./phase.js";
  *   .requires(Position, Velocity)
  *   .each([Position, Velocity], (e, [pos, vel]) => {
  *     pos.x += vel.vx;
+ *     e.modified(Position);
  *   });
  *
  * world.start();
@@ -48,6 +52,8 @@ import { IPhase } from "./phase.js";
  * drains the queue at top level.
  */
 export declare class World {
+    /** Hidden property key used to store this world's meta on component classes. */
+    readonly worldKey: string;
     constructor();
     /** Read-only view of the live entities, keyed by entity id. */
     get entities(): Omit<Map<number, Entity>, "set" | "delete" | "clear">;
@@ -102,9 +108,9 @@ export declare class World {
     /**
      * Register a component class with the world.
      *
-     * Must be called before any entity uses the component. Registration is
-     * disabled once {@link start} (or {@link disableComponentRegistration}) is
-     * called.
+     * Must be called before any entity uses the component. Components are plain
+     * classes constructed with no arguments. Registration is disabled once
+     * {@link start} (or {@link disableComponentRegistration}) is called.
      *
      * **Overloads:**
      * - `registerComponent(Class)` — type id auto-assigned from the
@@ -116,13 +122,14 @@ export declare class World {
      * - `registerComponent(Class, type, componentName)` — explicit id + name.
      *
      * @param ComponentClass - Component class to register.
-     * @throws When the class has already been registered or registration is
-     *   disabled.
+     * @returns The world-specific metadata record for the component class.
+     * @throws When the class has already been registered in this world or
+     *   registration is disabled.
      */
-    registerComponent(ComponentClass: typeof Component): void;
-    registerComponent(ComponentClass: typeof Component, type: number): void;
-    registerComponent(ComponentClass: typeof Component, componentName?: string): void;
-    registerComponent(ComponentClass: typeof Component, type: number, componentName: string): void;
+    registerComponent(ComponentClass: ComponentClass): ComponentMeta;
+    registerComponent(ComponentClass: ComponentClass, type: number): ComponentMeta;
+    registerComponent(ComponentClass: ComponentClass, componentName?: string): ComponentMeta;
+    registerComponent(ComponentClass: ComponentClass, type: number, componentName: string): ComponentMeta;
     /**
      * Look up the {@link ComponentMeta} for a registered component.
      *
@@ -147,14 +154,14 @@ export declare class World {
      *
      * ```ts
      * world.hook(Sprite)
-     *   .onAdd(c => c.initialize(scene))
-     *   .onRemove(c => c.destroy());
+     *   .onAdd((entity, c) => c.initialize(scene, entity))
+     *   .onRemove((entity, c) => c.destroy(scene, entity));
      * ```
      *
      * @param C - Component class.
      * @returns The hook bound to that component type.
      */
-    hook<T extends typeof Component>(C: T): Hook<InstanceType<T>>;
+    hook<T extends ComponentClass>(C: T): Hook<InstanceType<T>>;
     /**
      * Declare a group of mutually exclusive components.
      *
@@ -176,7 +183,7 @@ export declare class World {
      * @param components - Two or more component classes that cannot coexist.
      * @throws When any class has not been registered.
      */
-    setExclusiveComponents(...components: (typeof Component)[]): void;
+    setExclusiveComponents(...components: ComponentClass[]): void;
     /**
      * Set the starting value of the auto-incrementing entity id counter.
      *
@@ -298,7 +305,7 @@ export declare class World {
      *   guaranteed present (not validated at runtime).
      */
     filter<Q extends QueryDSL>(q: Q): Filter<ExtractRequired<Q>>;
-    filter<T extends (typeof Component)[]>(q: QueryDSL, _guaranteed: readonly [...T]): Filter<T>;
+    filter<T extends ComponentClass[]>(q: QueryDSL, _guaranteed: readonly [...T]): Filter<T>;
     /**
      * Add a named phase to the update pipeline.
      *
@@ -334,22 +341,46 @@ export declare class World {
      */
     start(): void;
     /**
-     * Execute every system in `phase` for one tick.
+     * Open a new frame and evaluate every registered tick source once.
+     *
+     * Call this before one or more {@link runPhase} calls when manually driving
+     * phases. {@link progress} wraps this automatically for the full pipeline.
+     *
+     * @param delta - Milliseconds elapsed since the previous frame.
+     * @throws When a frame is already open.
+     */
+    beginFrame(delta: number): void;
+    /**
+     * Close the current frame.
+     *
+     * @throws When no frame is currently open.
+     */
+    endFrame(): void;
+    /**
+     * Execute every system in `phase` within the current frame.
      *
      * Pending top-level mutations are drained before the first system runs so
      * each system observes a consistent world. Each system body executes in a
      * deferred scope; mutations made by callbacks land in the world queue and
      * are processed before the next system runs.
      *
+     * `runPhase` is safe to call re-entrantly from a system body: it reuses the
+     * frame opened by {@link beginFrame} and does not advance `_frameCounter` or
+     * re-evaluate tick sources.
+     *
      * @param phase - Phase reference returned from {@link addPhase}.
      * @param now - Absolute timestamp in milliseconds (e.g. `Date.now()`).
      * @param delta - Milliseconds elapsed since the previous tick.
+     * @throws When called outside an open frame.
      */
     runPhase(phase: IPhase, now: number, delta: number): void;
     /**
      * Run every phase in the pipeline in registration order.
      *
-     * Equivalent to calling {@link runPhase} for each phase manually.
+     * Equivalent to `beginFrame(delta)`, calling {@link runPhase} for each
+     * phase, then {@link endFrame}. All registered tick sources are evaluated
+     * once up front for the whole frame, and the frame is closed in a `finally`
+     * block if a system throws.
      *
      * @param now - Absolute timestamp in milliseconds (e.g. `Date.now()`).
      * @param delta - Milliseconds elapsed since the previous tick.