twinwire 0.0.0-stage → 1.0.0

package/dist/netcode/inputs.js

@@ -0,0 +1,43 @@
+import { isUint, MAX_STATE_BYTES } from '../core/protocol.js';
+/** Bundle recent inputs as redundancy without enabling retransmission of stale movement. */
+export function encodeInputs(inputs) {
+    if (!inputs.length || inputs.length > 32)
+        throw new RangeError('Invalid input count');
+    let size = 1, previous = -1;
+    for (const input of inputs) {
+        if (!isUint(input.seq) || input.seq <= previous || input.data.length > 1024)
+            throw new RangeError('Invalid input');
+        previous = input.seq;
+        size += 6 + input.data.length;
+    }
+    if (size > MAX_STATE_BYTES)
+        throw new RangeError('Input bundle exceeds one state frame');
+    const b = new Uint8Array(size), v = new DataView(b.buffer);
+    b[0] = inputs.length;
+    let at = 1;
+    for (const i of inputs) {
+        v.setUint32(at, i.seq, true);
+        v.setUint16(at + 4, i.data.length, true);
+        b.set(i.data, at + 6);
+        at += 6 + i.data.length;
+    }
+    return b;
+}
+export function decodeInputs(b) {
+    if (!b.length || b.length > MAX_STATE_BYTES || !b[0] || b[0] > 32)
+        return null;
+    const v = new DataView(b.buffer, b.byteOffset, b.byteLength), out = [];
+    let at = 1, previous = -1;
+    for (let n = 0; n < b[0]; n++) {
+        if (at + 6 > b.length)
+            return null;
+        const seq = v.getUint32(at, true), size = v.getUint16(at + 4, true);
+        if (seq <= previous || size > 1024 || at + 6 + size > b.length)
+            return null;
+        out.push({ seq, data: b.slice(at + 6, at + 6 + size) });
+        previous = seq;
+        at += 6 + size;
+    }
+    return at === b.length ? out : null;
+}
+//# sourceMappingURL=inputs.js.map

package/dist/netcode/inputs.js.map

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

package/dist/netcode/interpolation.d.ts

@@ -0,0 +1,44 @@
+export interface Timed<T> {
+    time: number;
+    seq: number;
+    value: T;
+    discontinuity?: boolean;
+}
+export interface SampleResult<T> {
+    value: T;
+    mode: 'hold' | 'interpolate' | 'extrapolate';
+    sourceTime: number;
+}
+/** Per-entity history. Discontinuities take effect at their timestamp; they are never blended across. */
+export declare class Timeline<T> {
+    readonly capacity: number;
+    readonly clone: (value: T) => T;
+    private samples;
+    constructor(capacity?: number, clone?: (value: T) => T);
+    get size(): number;
+    clear(): void;
+    insert(sample: Timed<T>): boolean;
+    sample(at: number, interpolate: (a: T, b: T, fraction: number) => T, extrapolate?: (last: T, previous: T, aheadMs: number, sampleIntervalMs: number) => T, maxExtrapolationMs?: number): SampleResult<T> | null;
+}
+export declare class AdaptivePlayback {
+    readonly intervalMs: number;
+    readonly minMs: number;
+    readonly maxMs: number;
+    private lateness;
+    private cursor;
+    delayMs: number;
+    constructor(intervalMs: number, minMs?: number, maxMs?: number);
+    observe(arrivalOnServerClock: number, sampleTime: number): void;
+    advance(serverNow: number, dtMs: number): number;
+    reset(): void;
+}
+export declare const lerp: (a: number, b: number, t: number) => number;
+export declare const lerpAngle: (a: number, b: number, t: number) => number;
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export declare const lerpVec3: (a: Vec3, b: Vec3, t: number) => Vec3;
+/** Validate rewind requests against a server-owned time window. This does not itself validate hits or authority. */
+export declare function rewindTime(requested: number, now: number, maxRewindMs: number): number;

package/dist/netcode/interpolation.js

@@ -0,0 +1,101 @@
+/** Per-entity history. Discontinuities take effect at their timestamp; they are never blended across. */
+export class Timeline {
+    capacity;
+    clone;
+    samples = [];
+    constructor(capacity = 64, clone = (v) => structuredClone(v)) {
+        this.capacity = capacity;
+        this.clone = clone;
+        if (!Number.isInteger(capacity) || capacity < 2 || capacity > 4096)
+            throw new RangeError('Invalid history capacity');
+    }
+    get size() { return this.samples.length; }
+    clear() { this.samples = []; }
+    insert(sample) {
+        if (!Number.isFinite(sample.time) || !Number.isSafeInteger(sample.seq) || sample.seq < 0)
+            throw new RangeError('Invalid snapshot');
+        if (this.samples.some(s => s.seq === sample.seq))
+            return false;
+        const same = this.samples.findIndex(s => s.time === sample.time);
+        if (same >= 0) {
+            if (this.samples[same].seq > sample.seq)
+                return false;
+            this.samples.splice(same, 1);
+        }
+        const copy = { ...sample, value: this.clone(sample.value) };
+        const i = this.samples.findIndex(s => s.time > sample.time);
+        if (i < 0)
+            this.samples.push(copy);
+        else
+            this.samples.splice(i, 0, copy);
+        while (this.samples.length > this.capacity)
+            this.samples.shift();
+        return true;
+    }
+    sample(at, interpolate, extrapolate, maxExtrapolationMs = 100) {
+        if (!Number.isFinite(at) || !Number.isFinite(maxExtrapolationMs) || maxExtrapolationMs < 0)
+            throw new RangeError('Invalid sample time');
+        const s = this.samples;
+        if (!s.length || s[0].time > at)
+            return null;
+        let i = s.length - 1;
+        while (i > 0 && s[i].time > at)
+            i--;
+        const a = s[i], b = s[i + 1];
+        if (b && !b.discontinuity)
+            return { value: interpolate(this.clone(a.value), this.clone(b.value), (at - a.time) / (b.time - a.time)), mode: 'interpolate', sourceTime: a.time };
+        if (!b && extrapolate && i > 0 && at > a.time && !a.discontinuity) {
+            const p = s[i - 1];
+            return { value: extrapolate(this.clone(a.value), this.clone(p.value), Math.min(at - a.time, maxExtrapolationMs), a.time - p.time), mode: 'extrapolate', sourceTime: a.time };
+        }
+        return { value: this.clone(a.value), mode: 'hold', sourceTime: a.time };
+    }
+}
+export class AdaptivePlayback {
+    intervalMs;
+    minMs;
+    maxMs;
+    lateness = [];
+    cursor = -Infinity;
+    delayMs;
+    constructor(intervalMs, minMs = intervalMs, maxMs = 400) {
+        this.intervalMs = intervalMs;
+        this.minMs = minMs;
+        this.maxMs = maxMs;
+        if (!(intervalMs > 0) || minMs < 0 || maxMs < minMs)
+            throw new RangeError('Invalid playback policy');
+        this.delayMs = minMs;
+    }
+    observe(arrivalOnServerClock, sampleTime) {
+        const late = arrivalOnServerClock - sampleTime;
+        if (!Number.isFinite(late) || late < -1000 || late > 30000)
+            return;
+        this.lateness.push(Math.max(0, late));
+        if (this.lateness.length > 128)
+            this.lateness.shift();
+    }
+    advance(serverNow, dtMs) {
+        if (!Number.isFinite(serverNow) || !Number.isFinite(dtMs) || dtMs < 0)
+            throw new RangeError('Invalid clock');
+        if (this.lateness.length) {
+            const sorted = [...this.lateness].sort((a, b) => a - b);
+            const p95 = sorted[Math.floor((sorted.length - 1) * 0.95)];
+            const target = Math.max(this.minMs, Math.min(this.maxMs, p95 + this.intervalMs));
+            const rate = target > this.delayMs ? 8 : 0.5;
+            this.delayMs += (target - this.delayMs) * (1 - Math.exp(-rate * dtMs / 1000));
+        }
+        this.cursor = Math.max(this.cursor, serverNow - this.delayMs);
+        return this.cursor;
+    }
+    reset() { this.lateness = []; this.cursor = -Infinity; this.delayMs = this.minMs; }
+}
+export const lerp = (a, b, t) => a + (b - a) * t;
+export const lerpAngle = (a, b, t) => a + Math.atan2(Math.sin(b - a), Math.cos(b - a)) * t;
+export const lerpVec3 = (a, b, t) => ({ x: lerp(a.x, b.x, t), y: lerp(a.y, b.y, t), z: lerp(a.z, b.z, t) });
+/** Validate rewind requests against a server-owned time window. This does not itself validate hits or authority. */
+export function rewindTime(requested, now, maxRewindMs) {
+    if (![requested, now, maxRewindMs].every(Number.isFinite) || maxRewindMs < 0)
+        throw new RangeError('Invalid rewind');
+    return Math.max(now - maxRewindMs, Math.min(now, requested));
+}
+//# sourceMappingURL=interpolation.js.map

package/dist/netcode/interpolation.js.map

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

package/dist/netcode/prediction.d.ts

@@ -0,0 +1,40 @@
+export interface Input<I> {
+    seq: number;
+    value: I;
+}
+/** Game-owned step/clone functions keep physics, collision and authority policy outside the transport. */
+export declare class Predictor<S, I> {
+    readonly step: (state: S, input: I, dtSeconds: number) => S;
+    readonly dtSeconds: number;
+    readonly maxPending: number;
+    readonly cloneState: (s: S) => S;
+    readonly cloneInput: (i: I) => I;
+    state: S;
+    private pending;
+    private seq;
+    private ack;
+    private serverTick;
+    constructor(initial: S, step: (state: S, input: I, dtSeconds: number) => S, dtSeconds?: number, maxPending?: number, cloneState?: (s: S) => S, cloneInput?: (i: I) => I);
+    get lastInput(): number;
+    get pendingCount(): number;
+    push(value: I): Input<I>;
+    reconcile(snapshot: {
+        ack: number;
+        tick: number;
+        state: S;
+    }): boolean;
+    recent(count?: number): Input<I>[];
+    resync(state: S, tick: number, ack?: number): void;
+}
+/** Receiver for redundant input bundles. ACK only the last input actually taken by the simulation. */
+export declare class InputInbox<I> {
+    readonly capacity: number;
+    readonly clone: (i: I) => I;
+    applied: number;
+    private queued;
+    constructor(capacity?: number, clone?: (i: I) => I);
+    add(input: Input<I>): boolean;
+    next(): Input<I> | null;
+    /** Explicit game policy after an expired input gap. Never called automatically. */
+    skipThrough(seq: number): void;
+}

package/dist/netcode/prediction.js

@@ -0,0 +1,97 @@
+/** Game-owned step/clone functions keep physics, collision and authority policy outside the transport. */
+export class Predictor {
+    step;
+    dtSeconds;
+    maxPending;
+    cloneState;
+    cloneInput;
+    state;
+    pending = [];
+    seq = 0;
+    ack = 0;
+    serverTick = -1;
+    constructor(initial, step, dtSeconds = 1 / 60, maxPending = 256, cloneState = (v) => structuredClone(v), cloneInput = (v) => structuredClone(v)) {
+        this.step = step;
+        this.dtSeconds = dtSeconds;
+        this.maxPending = maxPending;
+        this.cloneState = cloneState;
+        this.cloneInput = cloneInput;
+        if (!(dtSeconds > 0) || !Number.isFinite(dtSeconds) || !Number.isInteger(maxPending) || maxPending < 1)
+            throw new RangeError('Invalid prediction options');
+        this.state = cloneState(initial);
+    }
+    get lastInput() { return this.seq; }
+    get pendingCount() { return this.pending.length; }
+    push(value) {
+        if (this.pending.length >= this.maxPending)
+            throw new Error('Prediction history full: resync required');
+        if (this.seq >= 0xffffffff)
+            throw new Error('Input sequence exhausted: resync required');
+        const frame = { seq: ++this.seq, value: this.cloneInput(value) };
+        this.pending.push(frame);
+        this.state = this.step(this.cloneState(this.state), this.cloneInput(value), this.dtSeconds);
+        return { seq: frame.seq, value: this.cloneInput(frame.value) };
+    }
+    reconcile(snapshot) {
+        const { ack, tick } = snapshot;
+        if (!Number.isSafeInteger(ack) || ack < 0 || ack > this.seq || !Number.isSafeInteger(tick) || tick < 0)
+            throw new Error('Invalid authoritative snapshot');
+        if (tick <= this.serverTick)
+            return false;
+        if (ack < this.ack)
+            throw new Error('Authoritative acknowledgement regressed');
+        this.serverTick = tick;
+        this.ack = ack;
+        this.pending = this.pending.filter(i => i.seq > ack);
+        let state = this.cloneState(snapshot.state);
+        for (const i of this.pending)
+            state = this.step(state, this.cloneInput(i.value), this.dtSeconds);
+        this.state = state;
+        return true;
+    }
+    recent(count = 3) { return (count <= 0 ? [] : this.pending.slice(-Math.floor(count))).map(i => ({ seq: i.seq, value: this.cloneInput(i.value) })); }
+    resync(state, tick, ack = 0) {
+        if (!Number.isSafeInteger(tick) || tick < 0 || !Number.isSafeInteger(ack) || ack < 0 || ack > 0xffffffff)
+            throw new RangeError('Invalid resync');
+        this.state = this.cloneState(state);
+        this.pending = [];
+        this.serverTick = tick;
+        this.ack = this.seq = ack;
+    }
+}
+/** Receiver for redundant input bundles. ACK only the last input actually taken by the simulation. */
+export class InputInbox {
+    capacity;
+    clone;
+    applied = 0;
+    queued = new Map();
+    constructor(capacity = 256, clone = (v) => structuredClone(v)) {
+        this.capacity = capacity;
+        this.clone = clone;
+    }
+    add(input) {
+        if (!Number.isSafeInteger(input.seq) || input.seq <= this.applied || input.seq > this.applied + this.capacity || this.queued.has(input.seq))
+            return false;
+        this.queued.set(input.seq, this.clone(input.value));
+        return true;
+    }
+    next() {
+        const seq = this.applied + 1;
+        if (!this.queued.has(seq))
+            return null;
+        const value = this.queued.get(seq);
+        this.queued.delete(seq);
+        this.applied = seq;
+        return { seq, value };
+    }
+    /** Explicit game policy after an expired input gap. Never called automatically. */
+    skipThrough(seq) {
+        if (!Number.isSafeInteger(seq) || seq < this.applied || seq > this.applied + this.capacity)
+            throw new RangeError('Invalid input skip');
+        for (const n of this.queued.keys())
+            if (n <= seq)
+                this.queued.delete(n);
+        this.applied = seq;
+    }
+}
+//# sourceMappingURL=prediction.js.map

package/dist/netcode/prediction.js.map

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

package/dist/netcode/replication.d.ts

@@ -0,0 +1,36 @@
+export interface Version {
+    id: number;
+    generation: number;
+    revision: number;
+}
+export interface ReplicaUpdate extends Version {
+    deleted: boolean;
+    data: Uint8Array;
+}
+/** One instance per receiver. Whole small entity records are resent until acknowledged.
+ * This intentionally does not depend on an unacknowledged delta baseline. */
+export declare class ReplicaSender {
+    readonly maxEntities: number;
+    readonly retryMs: number;
+    private records;
+    constructor(maxEntities?: number, retryMs?: number);
+    publish(id: number, generation: number, data: Uint8Array | null): Version;
+    due(now: number, limit?: number): ReplicaUpdate[];
+    markSent(v: Version, now: number): void;
+    acknowledge(v: Version): boolean;
+    /** Reset both sender and receiver under a new world/session generation, not while old packets remain valid. */
+    clear(): void;
+}
+export declare class ReplicaReceiver {
+    readonly maxEntities: number;
+    private records;
+    constructor(maxEntities?: number);
+    apply(u: ReplicaUpdate): {
+        changed: boolean;
+        ack: Version;
+    };
+    get(id: number): Uint8Array | null;
+    clear(): void;
+}
+export declare function encodeReplica(u: ReplicaUpdate): Uint8Array;
+export declare function decodeReplica(b: Uint8Array): ReplicaUpdate | null;

package/dist/netcode/replication.js

@@ -0,0 +1,90 @@
+import { isUint } from '../core/protocol.js';
+const sameBytes = (a, b) => a.length === b.length && a.every((v, i) => b[i] === v);
+/** One instance per receiver. Whole small entity records are resent until acknowledged.
+ * This intentionally does not depend on an unacknowledged delta baseline. */
+export class ReplicaSender {
+    maxEntities;
+    retryMs;
+    records = new Map();
+    constructor(maxEntities = 1024, retryMs = 100) {
+        this.maxEntities = maxEntities;
+        this.retryMs = retryMs;
+    }
+    publish(id, generation, data) {
+        if (!isUint(id, 65535) || !isUint(generation) || generation < 1 || (data?.length ?? 0) > 1067)
+            throw new RangeError('Invalid entity');
+        const old = this.records.get(id), deleted = data === null, bytes = data?.slice() ?? new Uint8Array();
+        if (!old && this.records.size >= this.maxEntities)
+            throw new Error('Replica entity limit');
+        if (old && generation < old.update.generation)
+            throw new Error('Entity generation regressed');
+        if (old && generation === old.update.generation && old.update.deleted === deleted && sameBytes(old.update.data, bytes))
+            return { id, generation, revision: old.update.revision };
+        const revision = old && generation === old.update.generation ? old.update.revision + 1 : 1;
+        if (revision > 0xffffffff)
+            throw new Error('Entity revision exhausted');
+        const update = { id, generation, revision, deleted, data: bytes };
+        this.records.set(id, { update, ack: old && generation === old.update.generation ? old.ack : 0, sent: 0, sentAt: -Infinity });
+        return { id, generation, revision };
+    }
+    due(now, limit = 64) {
+        return [...this.records.values()].filter(r => r.ack < r.update.revision && now - r.sentAt >= this.retryMs)
+            .sort((a, b) => a.sentAt - b.sentAt).slice(0, limit).map(r => ({ ...r.update, data: r.update.data.slice() }));
+    }
+    markSent(v, now) {
+        const r = this.records.get(v.id);
+        if (!r || r.update.generation !== v.generation || r.update.revision !== v.revision)
+            return;
+        r.sent = v.revision;
+        r.sentAt = now;
+    }
+    acknowledge(v) {
+        const r = this.records.get(v.id);
+        if (!r || r.update.generation !== v.generation || !isUint(v.revision) || v.revision > r.sent)
+            return false;
+        r.ack = Math.max(r.ack, v.revision);
+        return true;
+    }
+    /** Reset both sender and receiver under a new world/session generation, not while old packets remain valid. */
+    clear() { this.records.clear(); }
+}
+export class ReplicaReceiver {
+    maxEntities;
+    records = new Map();
+    constructor(maxEntities = 1024) {
+        this.maxEntities = maxEntities;
+    }
+    apply(u) {
+        if (!isUint(u.id, 65535) || !isUint(u.generation) || !u.generation || !isUint(u.revision) || !u.revision || u.data.length > 1067)
+            throw new Error('Invalid entity update');
+        const old = this.records.get(u.id);
+        if (!old && this.records.size >= this.maxEntities)
+            throw new Error('Replica receiver full');
+        const changed = !old || u.generation > old.generation || u.generation === old.generation && u.revision > old.revision;
+        if (changed)
+            this.records.set(u.id, { ...u, data: u.data.slice() });
+        return { changed, ack: { id: u.id, generation: u.generation, revision: u.revision } };
+    }
+    get(id) { const r = this.records.get(id); return r && !r.deleted ? r.data.slice() : null; }
+    clear() { this.records.clear(); }
+}
+export function encodeReplica(u) {
+    if (!isUint(u.id, 65535) || !isUint(u.generation) || !u.generation || !isUint(u.revision) || !u.revision || u.data.length > 1067 || u.deleted && u.data.length)
+        throw new Error('Invalid entity update');
+    const b = new Uint8Array(11 + u.data.length), v = new DataView(b.buffer);
+    v.setUint16(0, u.id, true);
+    v.setUint32(2, u.generation, true);
+    v.setUint32(6, u.revision, true);
+    v.setUint8(10, +u.deleted);
+    b.set(u.data, 11);
+    return b;
+}
+export function decodeReplica(b) {
+    if (b.length < 11 || b.length > 1078)
+        return null;
+    const v = new DataView(b.buffer, b.byteOffset, b.byteLength), flag = v.getUint8(10), generation = v.getUint32(2, true), revision = v.getUint32(6, true);
+    if (flag > 1 || !generation || !revision || flag && b.length !== 11)
+        return null;
+    return { id: v.getUint16(0, true), generation, revision, deleted: !!flag, data: b.slice(11) };
+}
+//# sourceMappingURL=replication.js.map

package/dist/netcode/replication.js.map

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

package/dist/netcode/snapshots.d.ts

@@ -0,0 +1,29 @@
+import type { Json } from '../core/protocol.js';
+/**
+ * What was sent, by state seq, so the next snapshot can be a delta against the newest one the receiver acknowledged
+ * (send with `ack: true`, feed onStateAck to acknowledge). Lost snapshots cost nothing but a larger next delta.
+ * Reset on a new connection epoch (the seqs restart) or a world reset.
+ */
+export declare class SnapshotHistory<T> {
+    readonly capacity: number;
+    private sent;
+    private acked;
+    constructor(capacity?: number);
+    record(seq: number, value: T): void;
+    acknowledge(seq: number): boolean;
+    /** The acknowledged snapshot to diff against, or null for a whole snapshot. */
+    get baseline(): {
+        seq: number;
+        value: T;
+    } | null;
+    reset(): void;
+}
+export type Entities = Record<string, Record<string, Json>>;
+/** Field-level difference between two entity maps: changed fields per entity, and removed entities. */
+export interface EntityDelta {
+    set?: Entities;
+    del?: string[];
+}
+export declare function diffEntities(base: Entities | null, next: Entities): EntityDelta;
+/** Rebuild the full map from the baseline the delta was made against. Inputs are not modified. */
+export declare function applyEntityDelta(base: Entities | null, delta: EntityDelta): Entities;

package/dist/netcode/snapshots.js

@@ -0,0 +1,78 @@
+import { newer } from '../core/protocol.js';
+/**
+ * What was sent, by state seq, so the next snapshot can be a delta against the newest one the receiver acknowledged
+ * (send with `ack: true`, feed onStateAck to acknowledge). Lost snapshots cost nothing but a larger next delta.
+ * Reset on a new connection epoch (the seqs restart) or a world reset.
+ */
+export class SnapshotHistory {
+    capacity;
+    sent = new Map();
+    acked = null;
+    constructor(capacity = 64) {
+        this.capacity = capacity;
+        if (!Number.isInteger(capacity) || capacity < 1)
+            throw new RangeError('Invalid history capacity');
+    }
+    record(seq, value) {
+        if (!seq)
+            return;
+        this.sent.set(seq, value);
+        while (this.sent.size > this.capacity)
+            this.sent.delete(this.sent.keys().next().value);
+    }
+    acknowledge(seq) {
+        const value = this.sent.get(seq);
+        if (value === undefined || this.acked && !newer(seq, this.acked.seq))
+            return false;
+        this.acked = { seq, value };
+        for (const k of [...this.sent.keys()])
+            if (!newer(k, seq))
+                this.sent.delete(k);
+        return true;
+    }
+    /** The acknowledged snapshot to diff against, or null for a whole snapshot. */
+    get baseline() { return this.acked; }
+    reset() { this.sent.clear(); this.acked = null; }
+}
+const same = (a, b) => a === b || (typeof a === 'object' && a !== null && typeof b === 'object' && b !== null && JSON.stringify(a) === JSON.stringify(b));
+export function diffEntities(base, next) {
+    const out = {};
+    for (const id of Object.keys(next)) {
+        const n = next[id], b = base?.[id];
+        let fields;
+        for (const k of Object.keys(n))
+            if (!b || !same(b[k], n[k]))
+                (fields ??= {})[k] = n[k];
+        if (b)
+            for (const k of Object.keys(b))
+                if (!(k in n))
+                    (fields ??= {})[k] = null;
+        if (fields)
+            (out.set ??= {})[id] = fields;
+    }
+    if (base)
+        for (const id of Object.keys(base))
+            if (!(id in next))
+                (out.del ??= []).push(id);
+    return out;
+}
+/** Rebuild the full map from the baseline the delta was made against. Inputs are not modified. */
+export function applyEntityDelta(base, delta) {
+    const out = {};
+    if (base)
+        for (const id of Object.keys(base))
+            out[id] = { ...base[id] };
+    for (const id of delta.del ?? [])
+        delete out[id];
+    for (const [id, fields] of Object.entries(delta.set ?? {})) {
+        const e = out[id] ??= {};
+        for (const [k, v] of Object.entries(fields)) {
+            if (v === null && base?.[id] && k in base[id])
+                delete e[k];
+            else
+                e[k] = v;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/netcode/snapshots.js.map

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

package/dist/netcode/spatial.d.ts

@@ -0,0 +1,16 @@
+export interface Point {
+    x: number;
+    y: number;
+}
+/** Server-side visibility candidate lookup. Apply authorization/room filters before serializing entities. */
+export declare class SpatialGrid<Id extends string | number> {
+    readonly cellSize: number;
+    readonly maxEntities: number;
+    private items;
+    private cells;
+    constructor(cellSize?: number, maxEntities?: number);
+    private validate;
+    upsert(id: Id, p: Point): void;
+    remove(id: Id): void;
+    query(center: Point, radius: number): Set<Id>;
+}