@woosh/meep-engine 3.14.4 → 3.14.6

package/src/engine/network/sim/ActionRecordCursor.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Forward cursor over the records of one closed {@link ActionLog} frame.
+ *
+ * The record layout is self-describing (see {@link ActionLog}), so any reader
+ * can walk it — and five did, each with its own copy of the header parse: the
+ * replicator's scope scan and action copy, the rewind engine's boundary pass,
+ * and the rollback server's history read and retransmission check. This is
+ * that parse in one place. {@link next} reads one record's header and exposes
+ * the layout as positions into the frame's buffer; what a reader does with the
+ * prior-state entries or the action payload is its own business.
+ *
+ * Allocation-free after construction: a reader owns one cursor and re-opens
+ * it per frame. After `next` returns true the buffer's `position` is at the
+ * END of the record, so a reader that wants the prior-state entries sets
+ * `position = prior_start` and reads `prior_count` of them; `next` seeks from
+ * `record_end` regardless of where the reader left the position.
+ *
+ * ```
+ *   cursor.open(action_log, frame);
+ *   while (cursor.next()) {
+ *       // cursor.action_type_id, cursor.sender_id,
+ *       // cursor.buffer.raw_bytes[cursor.payload_start .. + cursor.payload_len]
+ *   }
+ * ```
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class ActionRecordCursor {
+    /**
+     * The open frame's buffer, positioned at {@link record_end} after each
+     * successful {@link next}.
+     * @type {BinaryBuffer|null}
+     */
+    buffer: BinaryBuffer | null;
+    /** @type {number} first byte of the current record */
+    record_start: number;
+    /** @type {number} prior-state entries in the current record */
+    prior_count: number;
+    /**
+     * First byte of the first prior-state entry. Each entry is
+     * `varint entity_id, uint8 component_type_id, uint32 len, bytes[len]`.
+     * @type {number}
+     */
+    prior_start: number;
+    /** @type {number} */
+    action_type_id: number;
+    /**
+     * The record's provenance byte: a peer id, `SENDER_LOCAL` or
+     * `SENDER_DERIVED` (see {@link SimActionExecutor}).
+     * @type {number}
+     */
+    sender_id: number;
+    /** @type {number} first byte of the action payload */
+    payload_start: number;
+    /** @type {number} */
+    payload_len: number;
+    /**
+     * One past the last byte of the current record — and so the first byte of
+     * the next, which is where {@link next} resumes. `0` before the first
+     * record.
+     * @type {number}
+     */
+    record_end: number;
+    /**
+     * Position the cursor before the first record of `frame`, which must be
+     * closed and present in the log (see {@link ActionLog#buffer_for}).
+     *
+     * @param {ActionLog} action_log
+     * @param {number} frame
+     */
+    open(action_log: ActionLog, frame: number): void;
+    /**
+     * Advance to the next record. Returns false once the frame is exhausted,
+     * leaving the fields as they were.
+     *
+     * @returns {boolean}
+     */
+    next(): boolean;
+    #private;
+}
+//# sourceMappingURL=ActionRecordCursor.d.ts.map

package/src/engine/network/sim/ActionRecordCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionRecordCursor.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/sim/ActionRecordCursor.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IACI;;;;OAIG;IACH,QAFU,eAAa,IAAI,CAEb;IAEd,sDAAsD;IACtD,cADW,MAAM,CACA;IAEjB,+DAA+D;IAC/D,aADW,MAAM,CACD;IAEhB;;;;OAIG;IACH,aAFU,MAAM,CAEA;IAEhB,qBAAqB;IACrB,gBADW,MAAM,CACE;IAEnB;;;;OAIG;IACH,WAFU,MAAM,CAEF;IAEd,sDAAsD;IACtD,eADW,MAAM,CACC;IAElB,qBAAqB;IACrB,aADW,MAAM,CACD;IAEhB;;;;;OAKG;IACH,YAFU,MAAM,CAED;IAKf;;;;;;OAMG;IACH,mCAFW,MAAM,QAMhB;IAED;;;;;OAKG;IACH,QAFa,OAAO,CAyBnB;;CACJ"}

package/src/engine/network/sim/ActionRecordCursor.js

@@ -0,0 +1,120 @@
+/**
+ * Forward cursor over the records of one closed {@link ActionLog} frame.
+ *
+ * The record layout is self-describing (see {@link ActionLog}), so any reader
+ * can walk it — and five did, each with its own copy of the header parse: the
+ * replicator's scope scan and action copy, the rewind engine's boundary pass,
+ * and the rollback server's history read and retransmission check. This is
+ * that parse in one place. {@link next} reads one record's header and exposes
+ * the layout as positions into the frame's buffer; what a reader does with the
+ * prior-state entries or the action payload is its own business.
+ *
+ * Allocation-free after construction: a reader owns one cursor and re-opens
+ * it per frame. After `next` returns true the buffer's `position` is at the
+ * END of the record, so a reader that wants the prior-state entries sets
+ * `position = prior_start` and reads `prior_count` of them; `next` seeks from
+ * `record_end` regardless of where the reader left the position.
+ *
+ * ```
+ *   cursor.open(action_log, frame);
+ *   while (cursor.next()) {
+ *       // cursor.action_type_id, cursor.sender_id,
+ *       // cursor.buffer.raw_bytes[cursor.payload_start .. + cursor.payload_len]
+ *   }
+ * ```
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class ActionRecordCursor {
+    /**
+     * The open frame's buffer, positioned at {@link record_end} after each
+     * successful {@link next}.
+     * @type {BinaryBuffer|null}
+     */
+    buffer = null;
+
+    /** @type {number} first byte of the current record */
+    record_start = 0;
+
+    /** @type {number} prior-state entries in the current record */
+    prior_count = 0;
+
+    /**
+     * First byte of the first prior-state entry. Each entry is
+     * `varint entity_id, uint8 component_type_id, uint32 len, bytes[len]`.
+     * @type {number}
+     */
+    prior_start = 0;
+
+    /** @type {number} */
+    action_type_id = 0;
+
+    /**
+     * The record's provenance byte: a peer id, `SENDER_LOCAL` or
+     * `SENDER_DERIVED` (see {@link SimActionExecutor}).
+     * @type {number}
+     */
+    sender_id = 0;
+
+    /** @type {number} first byte of the action payload */
+    payload_start = 0;
+
+    /** @type {number} */
+    payload_len = 0;
+
+    /**
+     * One past the last byte of the current record — and so the first byte of
+     * the next, which is where {@link next} resumes. `0` before the first
+     * record.
+     * @type {number}
+     */
+    record_end = 0;
+
+    /** @type {number} one past the last byte of the frame */
+    #end = 0;
+
+    /**
+     * Position the cursor before the first record of `frame`, which must be
+     * closed and present in the log (see {@link ActionLog#buffer_for}).
+     *
+     * @param {ActionLog} action_log
+     * @param {number} frame
+     */
+    open(action_log, frame) {
+        this.buffer = action_log.buffer_for(frame); // rewinds to 0
+        this.#end = action_log.write_end_for(frame);
+        this.record_end = 0;
+    }
+
+    /**
+     * Advance to the next record. Returns false once the frame is exhausted,
+     * leaving the fields as they were.
+     *
+     * @returns {boolean}
+     */
+    next() {
+        if (this.record_end >= this.#end) return false;
+
+        const buffer = this.buffer;
+        buffer.position = this.record_end;
+
+        this.record_start = buffer.position;
+        this.prior_count = buffer.readUintVar();
+        this.prior_start = buffer.position;
+        for (let i = 0; i < this.prior_count; i++) {
+            buffer.readUintVar();                   // entity_id
+            buffer.readUint8();                     // component_type_id
+            const prior_len = buffer.readUint32();
+            buffer.position += prior_len;           // prior payload
+        }
+        this.action_type_id = buffer.readUint8();
+        this.sender_id = buffer.readUint8();
+        this.payload_len = buffer.readUint32();
+        this.payload_start = buffer.position;
+        this.record_end = this.payload_start + this.payload_len;
+        buffer.position = this.record_end;
+
+        return true;
+    }
+}

package/src/engine/network/sim/RewindEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RewindEngine.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/sim/RewindEngine.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAQI;;;;;;OAMG;IACH,uDANW;QACV,UAAc,YAAY;QAC1B,KAAS,yBAAyB;QAClC,kBAAsB,8BAA8B;KACjD,EAiBH;IAdG;;OAEG;IACH,sBAA4B;IAE5B;;OAEG;IACH,8BAAkB;IAElB;;OAEG;IACH,gDAA4C;IAGhD;;;;;OAKG;IACH,kBAFW,MAAM,QA2BhB;IAED;;;;;;;;;OASG;IACH,yBAHW,MAAM,gBACN,MAAM,QAWhB;;CAwEJ"}
+{"version":3,"file":"RewindEngine.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/sim/RewindEngine.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAeI;;;;;;OAMG;IACH,uDANW;QACV,UAAc,YAAY;QAC1B,KAAS,yBAAyB;QAClC,kBAAsB,8BAA8B;KACjD,EAiBH;IAdG;;OAEG;IACH,sBAA4B;IAE5B;;OAEG;IACH,8BAAkB;IAElB;;OAEG;IACH,gDAA4C;IAGhD;;;;;OAKG;IACH,kBAFW,MAAM,QA0BhB;IAED;;;;;;;;;OASG;IACH,yBAHW,MAAM,gBACN,MAAM,QAWhB;;CAiDJ"}

package/src/engine/network/sim/RewindEngine.js

@@ -1,4 +1,5 @@
 import { assert } from "../../../core/assert.js";
+import { ActionRecordCursor } from "./ActionRecordCursor.js";
 
 /**
  * Walks the {@link ActionLog} backwards to restore prior component state.
@@ -28,6 +29,13 @@ export class RewindEngine {
      */
     #record_starts = new Int32Array(64);
 
+    /**
+     * Walks a frame's records to find where each starts.
+     * @type {ActionRecordCursor}
+     * @private
+     */
+    #cursor = new ActionRecordCursor();
+
     /**
      * @param {{
      *   action_log: ActionLog,
@@ -64,20 +72,19 @@ export class RewindEngine {
             throw new Error(`RewindEngine.undo_frame: frame ${frame} is not present in the action log`);
         }
 
-        const buffer = this.action_log.buffer_for(frame);
-        const end = this.action_log.write_end_for(frame);
-
         // 1. First pass: walk forward to find record boundaries.
+        const cursor = this.#cursor;
+        cursor.open(this.action_log, frame);
         let record_count = 0;
-        while (buffer.position < end) {
+        while (cursor.next()) {
             if (record_count >= this.#record_starts.length) {
                 this.#grow_record_starts();
             }
-            this.#record_starts[record_count++] = buffer.position;
-            this.#skip_record(buffer);
+            this.#record_starts[record_count++] = cursor.record_start;
         }
 
         // 2. Second pass: iterate records in reverse, restoring prior state.
+        const buffer = cursor.buffer;
         for (let i = record_count - 1; i >= 0; i--) {
             buffer.position = this.#record_starts[i];
             this.#restore_prior_state(buffer);
@@ -106,29 +113,6 @@ export class RewindEngine {
         }
     }
 
-    /**
-     * Walk past a single record without restoring anything. Buffer position
-     * advances to the start of the next record (or to `end` if this was the last).
-     *
-     * @param {BinaryBuffer} buffer
-     * @private
-     */
-    #skip_record(buffer) {
-        // Skip prior_state entries.
-        const prior_count = buffer.readUintVar();
-        for (let i = 0; i < prior_count; i++) {
-            buffer.readUintVar();           // entity_id
-            buffer.readUint8();             // component_type_id
-            const len = buffer.readUint32();
-            buffer.position += len;         // skip prior payload
-        }
-        // Skip action.
-        buffer.readUint8();                 // action_type_id
-        buffer.readUint8();                 // sender_id
-        const action_len = buffer.readUint32();
-        buffer.position += action_len;      // skip action payload
-    }
-
     /**
      * Read the prior_state entries of the record at the buffer's current position
      * and write them back into the live components. Buffer position advances past

package/src/engine/network/sim/SimActionExecutor.d.ts

@@ -122,8 +122,7 @@ export class SimActionExecutor {
      *
      * Set by a rollback orchestrator for the span in which the frame's local
      * sim runs (see `ServerAuthoritativeServer.__replay_frame`) and cleared
-     * immediately after, so it covers nested `execute` calls made from an
-     * action's `apply` during that span. Everything else — arrived input,
+     * immediately after. Everything outside that span — arrived input,
      * locally-authored actions — is left with its real sender.
      *
      * Only the RECORDED byte changes. `sender_id` still drives the
@@ -192,7 +191,7 @@ export class SimActionExecutor {
      * @param {SimAction} action
      * @param {number} [sender_id] peer that originated this action.
      *   Defaults to {@link SENDER_LOCAL} for locally-originated actions.
-     *   Must be in `[0, 254]` for remote-originated actions.
+     *   Must be in `[0, MAX_PEER_ID]` for remote-originated actions.
      * @returns {boolean} true if the action was applied; false if it was
      *   rejected by the {@link authorize} gate (and therefore not applied or
      *   logged).

package/src/engine/network/sim/SimActionExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimActionExecutor.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/sim/SimActionExecutor.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,2BAFU,MAAM,CAEiB;AAEjC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,6BAFU,MAAM,CAEmB;AAEnC;;;;;GAKG;AACH,0BAFU,MAAM,CAEgB;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IA4DI;;;;;;;;;OASG;IACH,sGATW;QACV,KAAS,yBAAyB;QAClC,UAAc,YAAY;QAC1B,eAAmB,oBAAoB;QACvC,kBAAsB,8BAA8B;QACpD,UAAc,uBAAuB;QACrC,gBAAoB,CAAC,mBAAmB;KACrC,EAyFH;IAxJD;;;;;;;;;OASG;IACH,gBAFU,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAEP;IAEtB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,uBAFuB,MAAM,aAAa,MAAM,wBAAwB,OAAO,CAE9D;IAEjB;;;;;;;;;;;;;;;;OAgBG;IACH,UAFU,OAAO,CAEA;IAab;;OAEG;IACH,8BAAkB;IAElB;;OAEG;IACH,sBAA4B;IAE5B;;OAEG;IACH,mCAAsC;IAEtC;;OAEG;IACH,gDAA4C;IAE5C;;;;OAIG;IACH,iCAA4B;IAE5B;;;;;;;;;;;OAWG;IACH,kBAFU,mBAAiB,IAAI,CAES;IA4BxC;;;;;;;OAOG;IACH,mBAFU,MAAM,CAEqB;IAErC;;;;;;;OAOG;IACH,kBAFU,MAAM,CAEoB;IAGxC;;;;;;;;;;OAUG;IACH,uCAPW,MAAM,GAGJ,OAAO,CAgJnB;;CACJ;mBA5XkB,uCAAuC"}
+{"version":3,"file":"SimActionExecutor.d.ts","sourceRoot":"","sources":["../../../../../src/engine/network/sim/SimActionExecutor.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,2BAFU,MAAM,CAEiB;AAEjC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,6BAFU,MAAM,CAEmB;AAEnC;;;;;GAKG;AACH,0BAFU,MAAM,CAEgB;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IA2DI;;;;;;;;;OASG;IACH,sGATW;QACV,KAAS,yBAAyB;QAClC,UAAc,YAAY;QAC1B,eAAmB,oBAAoB;QACvC,kBAAsB,8BAA8B;QACpD,UAAc,uBAAuB;QACrC,gBAAoB,CAAC,mBAAmB;KACrC,EAyFH;IAvJD;;;;;;;;;OASG;IACH,gBAFU,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAEP;IAEtB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,uBAFuB,MAAM,aAAa,MAAM,wBAAwB,OAAO,CAE9D;IAEjB;;;;;;;;;;;;;;;OAeG;IACH,UAFU,OAAO,CAEA;IAab;;OAEG;IACH,8BAAkB;IAElB;;OAEG;IACH,sBAA4B;IAE5B;;OAEG;IACH,mCAAsC;IAEtC;;OAEG;IACH,gDAA4C;IAE5C;;;;OAIG;IACH,iCAA4B;IAE5B;;;;;;;;;;;OAWG;IACH,kBAFU,mBAAiB,IAAI,CAES;IA4BxC;;;;;;;OAOG;IACH,mBAFU,MAAM,CAEqB;IAErC;;;;;;;OAOG;IACH,kBAFU,MAAM,CAEoB;IAGxC;;;;;;;;;;OAUG;IACH,uCAPW,MAAM,GAGJ,OAAO,CAgJnB;;CACJ;mBA3XkB,uCAAuC"}

package/src/engine/network/sim/SimActionExecutor.js

@@ -116,8 +116,7 @@ export class SimActionExecutor {
      *
      * Set by a rollback orchestrator for the span in which the frame's local
      * sim runs (see `ServerAuthoritativeServer.__replay_frame`) and cleared
-     * immediately after, so it covers nested `execute` calls made from an
-     * action's `apply` during that span. Everything else — arrived input,
+     * immediately after. Everything outside that span — arrived input,
      * locally-authored actions — is left with its real sender.
      *
      * Only the RECORDED byte changes. `sender_id` still drives the
@@ -233,7 +232,7 @@ export class SimActionExecutor {
      * @param {SimAction} action
      * @param {number} [sender_id] peer that originated this action.
      *   Defaults to {@link SENDER_LOCAL} for locally-originated actions.
-     *   Must be in `[0, 254]` for remote-originated actions.
+     *   Must be in `[0, MAX_PEER_ID]` for remote-originated actions.
      * @returns {boolean} true if the action was applied; false if it was
      *   rejected by the {@link authorize} gate (and therefore not applied or
      *   logged).
@@ -250,18 +249,18 @@ export class SimActionExecutor {
             `execute: action class '${action.constructor.action_type_name ?? action.constructor.name}' has no wire type_id — register it (NetworkSession.defineAction, or SimActionRegistry.register) before executing it`,
         );
         assert.isNonNegativeInteger(sender_id, 'sender_id');
-        // A remote sender that reaches a provenance sentinel would be recorded
-        // as local-authored or sim-derived, and a rollback replay reads the
-        // sentinel back as "this record is mine to recompute" — so the peer's
-        // input would apply once and then disappear on the first replay of its
-        // frame, with nothing logged. Real runtime check: asserts strip in prod,
-        // and silent input loss is not something to ship behind one.
+        // A sender above the peer range is either the sim-derived sentinel —
+        // which a rollback replay reads back as "this record is mine to
+        // recompute", so the peer's input would apply once and then disappear
+        // on the first replay of its frame, with nothing logged — or a value
+        // that does not fit the record's one byte at all. SENDER_LOCAL itself
+        // is the caller saying "mine". Real runtime check: asserts strip in
+        // prod, and silent input loss is not something to ship behind one.
         if (sender_id > MAX_PEER_ID && sender_id !== SENDER_LOCAL) {
             throw new Error(
-                `SimActionExecutor.execute: sender_id ${sender_id} is reserved (SENDER_DERIVED); remote peer ids must be in [0, ${MAX_PEER_ID}]`,
+                `SimActionExecutor.execute: sender_id ${sender_id} is not a peer id; remote peer ids must be in [0, ${MAX_PEER_ID}] — 254 and 255 are reserved provenance markers`,
             );
         }
-        assert.ok(sender_id <= 0xFF, 'sender_id must fit in a uint8');
 
         // Expose the originating sender to apply / affected_components / the
         // authorize policy before any of them run.

package/src/engine/physics/ecs/PhysicsSystem.d.ts

@@ -835,6 +835,33 @@ export class PhysicsSystem extends System<any> {
      * {@link InterpolationSystem} blends consecutive ticks from these snapshots.
      * Only awake (moving) bodies are recorded, so the log stays sparse. No-op
      * unless {@link interpolationLog} is wired.
+     *
+     * **A body created after this pass has no snapshot for the step it was born on, and renders
+     * from one snapshot for a step.** This pass runs at the end of `fixedUpdate`, and game code
+     * runs after it — that ordering is correct, the sim must read the solved poses — so a body
+     * spawned by game code is invisible to the tick it was spawned into. Its first record is the
+     * NEXT tick, and `InterpolationLog.interpolate` handles the missing half gracefully by falling
+     * back to whichever snapshot exists. That is the right primitive behaviour and it produces a
+     * bad picture: the entity is drawn at the *newer* tick for a whole frame budget, so it appears
+     * to jump a full step's travel and then hold still for one. Measured at 165 Hz by a port
+     * (GAP-036) as four frames of a rocket parked at the muzzle, reported by a player as
+     * "projectiles move with jerks".
+     *
+     * **Why this is documented rather than fixed, which is the part worth knowing.** The obvious
+     * fix — record a body's pose when it links — does not fit this log. {@link InterpolationLog} is
+     * a strictly monotonic tick ring: `begin_tick` throws while a tick is open, pages are
+     * contiguous ranges that the next page's bytes follow immediately, and `#ticks` is keyed by
+     * tick number — so re-opening the closed tick to append one body would overwrite that tick's
+     * metadata for every other body in it. The fix that does work is to move this pass out of
+     * `fixedUpdate` into a system registered after every simulation system, which is what a
+     * consumer hitting this did; that costs a second mandatory registration, which is a trade this
+     * engine has decided against elsewhere. Closing it properly means either a per-body "first
+     * tick" the blend can consult, or a log that accepts an out-of-order record.
+     *
+     * The workaround needs no engine change: put the body on the application's own timeline via a
+     * pose recorder registered last, since `__interp_restore` does not filter by `sourceId` and
+     * `PhysicsSystem` still restores the authoritative pose before it integrates.
+     *
      * @private
      */
     private __interp_record;

package/src/engine/physics/ecs/PhysicsSystem.d.ts.map

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

package/src/engine/physics/ecs/PhysicsSystem.js

@@ -1839,6 +1839,33 @@ export class PhysicsSystem extends System {
      * {@link InterpolationSystem} blends consecutive ticks from these snapshots.
      * Only awake (moving) bodies are recorded, so the log stays sparse. No-op
      * unless {@link interpolationLog} is wired.
+     *
+     * **A body created after this pass has no snapshot for the step it was born on, and renders
+     * from one snapshot for a step.** This pass runs at the end of `fixedUpdate`, and game code
+     * runs after it — that ordering is correct, the sim must read the solved poses — so a body
+     * spawned by game code is invisible to the tick it was spawned into. Its first record is the
+     * NEXT tick, and `InterpolationLog.interpolate` handles the missing half gracefully by falling
+     * back to whichever snapshot exists. That is the right primitive behaviour and it produces a
+     * bad picture: the entity is drawn at the *newer* tick for a whole frame budget, so it appears
+     * to jump a full step's travel and then hold still for one. Measured at 165 Hz by a port
+     * (GAP-036) as four frames of a rocket parked at the muzzle, reported by a player as
+     * "projectiles move with jerks".
+     *
+     * **Why this is documented rather than fixed, which is the part worth knowing.** The obvious
+     * fix — record a body's pose when it links — does not fit this log. {@link InterpolationLog} is
+     * a strictly monotonic tick ring: `begin_tick` throws while a tick is open, pages are
+     * contiguous ranges that the next page's bytes follow immediately, and `#ticks` is keyed by
+     * tick number — so re-opening the closed tick to append one body would overwrite that tick's
+     * metadata for every other body in it. The fix that does work is to move this pass out of
+     * `fixedUpdate` into a system registered after every simulation system, which is what a
+     * consumer hitting this did; that costs a second mandatory registration, which is a trade this
+     * engine has decided against elsewhere. Closing it properly means either a per-body "first
+     * tick" the blend can consult, or a log that accepts an out-of-order record.
+     *
+     * The workaround needs no engine change: put the body on the application's own timeline via a
+     * pose recorder registered last, since `__interp_restore` does not filter by `sourceId` and
+     * `PhysicsSystem` still restores the authoritative pose before it integrates.
+     *
      * @private
      */
     __interp_record() {

package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts

@@ -64,11 +64,11 @@ export class FluidObstacleSystem extends System<any> {
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#370@#refresh_masks"(fluid: FluidComponent): void;
+    static "__#372@#refresh_masks"(fluid: FluidComponent): void;
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#370@#clear_field"(fluid: FluidComponent): void;
+    static "__#372@#clear_field"(fluid: FluidComponent): void;
     /**
      * Mark every cell of `fluid` whose centre lies within `inflation` of the
      * posed shape as solid. Iteration is clipped to the shape's world AABB
@@ -80,7 +80,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} inflation       world-units SDF threshold
      * @param {Float64Array} point     length-3 scratch
      */
-    static "__#370@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
+    static "__#372@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
     /**
      * Write the obstacle's translation velocity onto every face of every cell
      * it voxelized — the moving-wall boundary condition. Runs AFTER the mask
@@ -100,7 +100,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} wvy
      * @param {number} wvz
      */
-    static "__#370@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
+    static "__#372@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
     constructor();
     dependencies: (typeof FluidObstacle)[];
     components_used: (ResourceAccessSpecification<typeof Transform> | ResourceAccessSpecification<typeof RigidBody> | ResourceAccessSpecification<typeof Collider> | ResourceAccessSpecification<typeof FluidComponent> | ResourceAccessSpecification<typeof FluidObstacle>)[];

package/src/engine/sound/SoundEngine.d.ts

@@ -13,6 +13,30 @@ declare class SoundEngine {
     sopra: SopraEngine | null;
     context: AudioContext;
     destination: GainNode;
+    /**
+     * @param {number} value
+     */
+    set volume(arg: number);
+    /**
+     * The one master fader in the graph, and the only one worth reaching for.
+     *
+     * Everything is downstream of {@link destination}: {@link obtainSopra}
+     * passes it as the sopra bus tree's output, and a `ProbeReverbRenderer` is
+     * constructed against the same node, so the dry mix and the wet return both
+     * pass through this gain.
+     *
+     * The bus named `master` inside sopra is NOT this. The probe reverb's
+     * return joins the graph BELOW the bus tree, so `busGraph.setVolume('master', 0)`
+     * silences the dry signal and leaves the wet tail of every sound at full
+     * level — audible, and audible only in reverberant rooms.
+     *
+     * This was an `Object.defineProperties` block, which the declaration
+     * generator does not read, so `sound.volume = 0.5` was a compile error
+     * against a property that exists and works.
+     *
+     * @returns {number}
+     */
+    get volume(): number;
     /**
      * Create and own the sopra engine, built on this SoundEngine's existing AudioContext + master
      * destination (never a second context). Wired in by the sound systems, which supply an

package/src/engine/sound/SoundEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/sound/SoundEngine.js"],"names":[],"mappings":";AAEA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,OAFU,WAAW,GAAC,IAAI,CAEb;IAkBO,sBAWd;IAUF,sBAA2B;IAiB/B;;;;;;;;;;OAUG;IACH,6CAFa,WAAW,CAQvB;IAED;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,iBAFa,QAAQ,IAAI,CAAC,CAMzB;IAED;;;OAGG;IACH,SAFa,QAAQ,GAAG,CAAC,CAWxB;CACJ;4BAzH2B,wBAAwB"}
+{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/sound/SoundEngine.js"],"names":[],"mappings":";AAEA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,OAFU,WAAW,GAAC,IAAI,CAEb;IAkBO,sBAWd;IAUF,sBAA2B;IA4B/B;;OAEG;IACH,wBAEC;IA5BD;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAEC;IASD;;;;;;;;;;OAUG;IACH,6CAFa,WAAW,CAQvB;IAED;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,iBAFa,QAAQ,IAAI,CAAC,CAMzB;IAED;;;OAGG;IACH,SAFa,QAAQ,GAAG,CAAC,CAWxB;CACJ;4BA3I2B,wBAAwB"}

package/src/engine/sound/SoundEngine.js

@@ -53,18 +53,36 @@ class SoundEngine {
         this.destination = gainNode;
         gainNode.connect(compressor);
         compressor.connect(context.destination);
+    }
 
-        // master channel
-        Object.defineProperties(this, {
-            volume: {
-                get: function () {
-                    return gainNode.gain.value;
-                },
-                set: function (val) {
-                    gainNode.gain.setValueAtTime(val, context.currentTime, 0);
-                }
-            }
-        });
+    /**
+     * The one master fader in the graph, and the only one worth reaching for.
+     *
+     * Everything is downstream of {@link destination}: {@link obtainSopra}
+     * passes it as the sopra bus tree's output, and a `ProbeReverbRenderer` is
+     * constructed against the same node, so the dry mix and the wet return both
+     * pass through this gain.
+     *
+     * The bus named `master` inside sopra is NOT this. The probe reverb's
+     * return joins the graph BELOW the bus tree, so `busGraph.setVolume('master', 0)`
+     * silences the dry signal and leaves the wet tail of every sound at full
+     * level — audible, and audible only in reverberant rooms.
+     *
+     * This was an `Object.defineProperties` block, which the declaration
+     * generator does not read, so `sound.volume = 0.5` was a compile error
+     * against a property that exists and works.
+     *
+     * @returns {number}
+     */
+    get volume() {
+        return this.destination.gain.value;
+    }
+
+    /**
+     * @param {number} value
+     */
+    set volume(value) {
+        this.destination.gain.setValueAtTime(value, this.context.currentTime, 0);
     }
 
     /**

package/src/engine/sound/simulation/configureAcousticSimulation.d.ts

@@ -14,18 +14,26 @@
  *
  * Returns the simulator so the caller can tune it (`rayCount`, `smoothing`, `random_seed`, `medium`), bake
  * against its `occluderIndex` (reverb / visibility), and enable corner-leakage (`pathing` + `setProbeField`).
- * For probe-baked reverb, pass a configured {@link ProbeReverbRenderer} as `options.probeReverb` (or assign
- * `audioEmitterSystem.probeReverb` yourself afterwards).
+ * For probe-baked reverb, pass a configured {@link ProbeReverbRenderer} as `probeReverb`. It reaches both
+ * halves: the emitter system, which drives it per frame, and {@link AcousticProbeFieldSystem}, which hands
+ * it the field on link. Assigning `audioEmitterSystem.probeReverb` yourself instead wires only the first,
+ * and a renderer with no field renders silence.
  *
  * Call once during engine configuration, after the `AudioEmitterSystem` is constructed (construct it
  * without an `acousticSim` argument — this injects it).
  *
- * @param {EngineConfiguration} configuration the config the acoustic systems are added to
+ * @param {{addManySystems: function(...System):*}} configuration whatever the systems are added to.
+ * Structural rather than {@link EngineConfiguration}, because `addManySystems` is the only method
+ * this helper calls and an application driving the {@link EntityManager} directly has no
+ * `EngineConfiguration` to hand it — `EngineConfiguration.systems` is `@private`, so the only way
+ * through was a collector object and an `as unknown as` cast (GAP-033).
  * @param {AudioEmitterSystem} audioEmitterSystem the system whose `update()` drives the simulation
  * @param {AcousticSimulator} [simulator] reuse this simulator instead of creating one (default: a fresh one)
  * @param {ProbeReverbRenderer} [probeReverb] optional probe-reverb renderer to wire (left untouched if omitted)
  * @returns {AcousticSimulator} the shared simulator (tune `random_seed` / `medium` on it directly)
  */
-export function configureAcousticSimulation(configuration: EngineConfiguration, audioEmitterSystem: AudioEmitterSystem, simulator?: AcousticSimulator, probeReverb?: ProbeReverbRenderer): AcousticSimulator;
+export function configureAcousticSimulation(configuration: {
+    addManySystems: (...args: System[]) => any;
+}, audioEmitterSystem: AudioEmitterSystem, simulator?: AcousticSimulator, probeReverb?: ProbeReverbRenderer): AcousticSimulator;
 import { AcousticSimulator } from "./AcousticSimulator.js";
 //# sourceMappingURL=configureAcousticSimulation.d.ts.map

package/src/engine/sound/simulation/configureAcousticSimulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configureAcousticSimulation.d.ts","sourceRoot":"","sources":["../../../../../src/engine/sound/simulation/configureAcousticSimulation.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,oIAJW,iBAAiB,sCAEf,iBAAiB,CAgB7B;kCA/CiC,wBAAwB"}
+{"version":3,"file":"configureAcousticSimulation.d.ts","sourceRoot":"","sources":["../../../../../src/engine/sound/simulation/configureAcousticSimulation.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,2DAVW;IAAC,cAAc,6BAAuB;CAAC,sDAMvC,iBAAiB,sCAEf,iBAAiB,CAgB7B;kCArDiC,wBAAwB"}