@series-inc/rundot-syncplay 5.26.0-beta.2 → 5.26.0-beta.4

package/dist/physics3d.js

@@ -2080,6 +2080,33 @@ function warmMapToCache(warm, bodies) {
         || left.anchorY - right.anchorY
         || left.anchorZ - right.anchorZ);
 }
+/**
+ * Exact-overlap memo for static/static pairs. Neither body can move, so the
+ * result is invariant for the lifetime of both objects, and static bodies keep
+ * their identity across steps (see the `kind === 'static'` passthrough in the
+ * solver's body rebuild). Without this, every prop resting on a heightfield
+ * regenerates the terrain's triangles on every step to re-derive an answer that
+ * cannot change.
+ */
+// rdm-ignore-next-line determinism/no-mutable-collection-state: pure derived overlap memo keyed by immutable body identity
+const staticOverlapCache = new WeakMap();
+function shapesOverlapForPair(left, right) {
+    if (left.kind !== 'static' || right.kind !== 'static') {
+        return shapesOverlap3D(bodyPose(left), bodyPose(right));
+    }
+    let memo = staticOverlapCache.get(left);
+    if (memo === undefined) {
+        memo = new WeakMap();
+        staticOverlapCache.set(left, memo);
+    }
+    const cached = memo.get(right);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const overlap = shapesOverlap3D(bodyPose(left), bodyPose(right));
+    memo.set(right, overlap);
+    return overlap;
+}
 function detectContacts(bodies, keepPair) {
     const contacts = [];
     for (const pair of broadphaseCandidatePairs(bodies)) {
@@ -2091,7 +2118,7 @@ function detectContacts(bodies, keepPair) {
         if ((left.mask & right.layer) === 0 ||
             (right.mask & left.layer) === 0 ||
             !boundsOverlap(pair.leftBounds, pair.rightBounds) ||
-            !shapesOverlap3D(bodyPose(left), bodyPose(right))) {
+            !shapesOverlapForPair(left, right)) {
             continue;
         }
         const pairId = [left.id, right.id].sort(compareStrings).join('|');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/rundot-syncplay",
-  "version": "5.26.0-beta.2",
+  "version": "5.26.0-beta.4",
   "description": "Kinetix orchestration, rollback, replay, late-join, and deterministic networking for RUN.game",
   "repository": {
     "type": "git",
@@ -70,7 +70,9 @@
       "types": "./core/physics.d.ts",
       "default": "./core/src/physics/index.mjs"
     },
+    "./core/box3d-probe": "./core/src/physics/box3d-probe.mjs",
     "./core/build-native": "./core/scripts/build-native.mjs",
+    "./core/build-mobile-native": "./core/scripts/build-mobile-native.mjs",
     "./core/build-wasm-physics": "./core/scripts/build-wasm-physics.mjs",
     "./core/preflight": "./core/scripts/preflight.mjs"
   },
@@ -88,17 +90,19 @@
   "scripts": {
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
     "test": "npm run test:core",
-    "test:core": "tsx --test tests/canonical.test.ts tests/runtime-session.test.ts tests/kinetix-runtime-session.test.ts tests/runtime-support.test.ts tests/runtime-guards.test.ts tests/r3f-render-adapter.test.ts tests/snapshot-cost.test.ts tests/sdkSession.test.ts tests/input-authority.test.ts tests/session-wire.test.ts tests/session-snapshot.test.ts tests/authority-room.test.ts tests/networked-client-snapshot.test.ts tests/runner.test.ts tests/testing.test.ts tests/browser-session.test.ts tests/secret-config.test.ts tests/secret-protocol.test.ts tests/secret-authority.test.ts tests/secret-client.test.ts tests/late-join-checksum.test.ts tests/late-join-input-backfill.test.ts tests/replay-scoring.test.ts tests/bot-backfill.test.ts tests/latency-simulation.test.ts tests/time-sync.test.ts tests/match-log.test.ts tests/spectator.test.ts tests/synctest.test.ts tests/instant-replay.test.ts tests/session-promotion.test.ts tests/physics3d-broadphase-stats.test.ts tests/entrypoints.test.ts tests/export-surface.test.ts tests/test-manifest.test.ts tests/coarse-region.test.ts tests/input-codec.test.ts tests/platformer-content.test.ts tests/command-ingress.test.ts tests/session-reconfigure.test.ts tests/prediction-mode.test.ts tests/ephemeral-channel.test.ts tests/runner-surface.test.ts tests/runner-harness.test.ts tests/effects-adapter-bounds.test.ts tests/simulated-match-secrets.test.ts tests/run-glue-surface.test.mjs core/tests/core-boundary.test.mjs tests/math-core-parity.test.ts",
+    "test:core": "tsx --test tests/canonical.test.ts tests/runtime-session.test.ts tests/kinetix-runtime-session.test.ts tests/runtime-support.test.ts tests/runtime-guards.test.ts tests/r3f-render-adapter.test.ts tests/snapshot-cost.test.ts tests/sdkSession.test.ts tests/input-authority.test.ts tests/session-wire.test.ts tests/session-snapshot.test.ts tests/authority-room.test.ts tests/networked-client-snapshot.test.ts tests/runner.test.ts tests/testing.test.ts tests/browser-session.test.ts tests/secret-config.test.ts tests/secret-protocol.test.ts tests/secret-authority.test.ts tests/secret-client.test.ts tests/late-join-checksum.test.ts tests/late-join-input-backfill.test.ts tests/replay-scoring.test.ts tests/bot-backfill.test.ts tests/latency-simulation.test.ts tests/time-sync.test.ts tests/match-log.test.ts tests/spectator.test.ts tests/synctest.test.ts tests/instant-replay.test.ts tests/session-promotion.test.ts tests/physics3d-broadphase-stats.test.ts tests/entrypoints.test.ts tests/export-surface.test.ts tests/test-manifest.test.ts tests/coarse-region.test.ts tests/input-codec.test.ts tests/platformer-content.test.ts tests/command-ingress.test.ts tests/session-reconfigure.test.ts tests/prediction-mode.test.ts tests/ephemeral-channel.test.ts tests/runner-surface.test.ts tests/runner-harness.test.ts tests/effects-adapter-bounds.test.ts tests/simulated-match-secrets.test.ts tests/run-glue-surface.test.mjs core/tests/core-boundary.test.mjs tests/math-core-parity.test.ts tests/movement3d-kcc-unit-contract.test.ts tests/movement3d-static-ground.test.ts",
     "test:soak": "tsx --test tests/runtime-soak.test.ts",
-    "test:extended": "tsx --test tests/animation.test.ts tests/asset-cooking.test.ts tests/backend-proof-checksum-vectors.test.ts tests/bot-documents.test.ts tests/bot-primitives.test.ts tests/collider-cooking.test.ts tests/collision.test.ts tests/command-timeline.test.ts tests/config-bundle.test.ts tests/cosmetic-physics3d.test.ts tests/deterministic-primitives.test.ts tests/ecs-lite.test.ts tests/effects-adapter.test.ts tests/engine-runtime.test.ts tests/errors.test.ts tests/events.test.ts tests/input-button.test.ts tests/load-128-players.test.ts tests/math.test.ts tests/movement.test.ts tests/movement3d.test.ts tests/multiclient-authority.test.ts tests/navigation.test.ts tests/noise.test.ts tests/physics-cert.test.ts tests/physics2d.test.ts tests/physics3d-ccd.test.ts tests/physics3d-coverage.test.ts tests/physics3d-destruction-cert.test.ts tests/physics3d-heightfield.test.ts tests/physics3d-hull.test.ts tests/physics3d-joints.test.ts tests/physics3d-kinematic-mesh.test.ts tests/physics3d-mass.test.ts tests/physics3d-materials.test.ts tests/physics3d-mesh-onesided.test.ts tests/physics3d-query-index.test.ts tests/physics3d-recipes.test.ts tests/physics3d-rotation-convention.test.ts tests/physics3d-shared.test.ts tests/physics3d-sleeping-manifold-reuse.test.ts tests/physics3d-solver.test.ts tests/physics3d-stacking.test.ts tests/physics3d-toi.test.ts tests/physics3d-vehicle.test.ts tests/physics3d-voxel.test.ts tests/physics3d-world-edit.test.ts tests/physics3d.test.ts tests/physics-vector-generator.test.ts tests/random.test.ts tests/rollback-history.test.ts tests/schema-artifacts.test.ts tests/schema-codegen.test.ts tests/schema-dsl-binary.test.ts tests/schema.test.ts tests/signals.test.ts tests/sparse-set.test.ts tests/static-checker.test.ts tests/system-lifecycle.test.ts tests/wire-canonical-sentinels.test.ts tests/ws-frame.test.ts",
+    "test:extended": "tsx --test tests/kcc-vehicle-characterization.test.ts tests/animation.test.ts tests/asset-cooking.test.ts tests/backend-proof-checksum-vectors.test.ts tests/bot-documents.test.ts tests/bot-primitives.test.ts tests/collider-cooking.test.ts tests/collision.test.ts tests/command-timeline.test.ts tests/config-bundle.test.ts tests/cosmetic-physics3d.test.ts tests/deterministic-primitives.test.ts tests/ecs-lite.test.ts tests/effects-adapter.test.ts tests/engine-runtime.test.ts tests/errors.test.ts tests/events.test.ts tests/input-button.test.ts tests/load-128-players.test.ts tests/math.test.ts tests/movement.test.ts tests/movement3d.test.ts tests/multiclient-authority.test.ts tests/navigation.test.ts tests/noise.test.ts tests/physics-cert.test.ts tests/physics2d.test.ts tests/physics3d-ccd.test.ts tests/physics3d-coverage.test.ts tests/physics3d-destruction-cert.test.ts tests/physics3d-geometry-limits.test.ts tests/physics3d-heightfield.test.ts tests/physics3d-hull.test.ts tests/physics3d-joints.test.ts tests/physics3d-kinematic-mesh.test.ts tests/physics3d-mass.test.ts tests/physics3d-materials.test.ts tests/physics3d-mesh-onesided.test.ts tests/physics3d-query-index.test.ts tests/physics3d-recipes.test.ts tests/physics3d-rotation-convention.test.ts tests/physics3d-shared.test.ts tests/physics3d-sleeping-manifold-reuse.test.ts tests/physics3d-solver.test.ts tests/physics3d-static-memoization.test.ts tests/physics3d-static-overlap-memo.test.ts tests/physics3d-cylinder-hull.test.ts tests/physics3d-stacking.test.ts tests/physics3d-toi.test.ts tests/physics3d-vehicle.test.ts tests/physics3d-voxel.test.ts tests/physics3d-world-edit.test.ts tests/physics3d.test.ts tests/physics-vector-generator.test.ts tests/random.test.ts tests/rollback-history.test.ts tests/schema-artifacts.test.ts tests/schema-codegen.test.ts tests/schema-dsl-binary.test.ts tests/schema.test.ts tests/signals.test.ts tests/sparse-set.test.ts tests/static-checker.test.ts tests/system-lifecycle.test.ts tests/wire-canonical-sentinels.test.ts tests/ws-frame.test.ts",
     "test:ci": "npm run build && npm run test:core",
     "build:native": "node core/scripts/build-native.mjs",
+    "build:mobile-native": "node core/scripts/build-mobile-native.mjs",
     "build:wasm-physics": "node core/scripts/build-wasm-physics.mjs",
     "test:determinism": "node --test core/tests/*.test.mjs",
     "generate:platformer-manifest": "node core/scripts/generate-platformer2d-manifest.mjs",
     "generate:physics-vectors": "node scripts/gen-physics-vectors.mjs",
     "test:physics-vectors": "node --import tsx/esm --test tests/physics-vector-generator.test.ts",
-    "pack:dry-run": "npm pack --dry-run"
+    "pack:dry-run": "npm pack --dry-run",
+    "bench:cross-lane": "node core/bench/cross-lane.mjs"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "keywords": [

package/dist/prediction-culling.d.ts

@@ -1,34 +0,0 @@
-export type PredictionCullingMode = 'off' | 'local-area';
-export interface PredictionCullingOptions {
-    readonly mode: PredictionCullingMode;
-    readonly players: number;
-    readonly objectsPerPlayer: number;
-    readonly frames: number;
-    readonly seed: number;
-    readonly radius: number;
-    readonly includeHiddenThreat?: boolean;
-}
-export interface PredictionCullingResult {
-    readonly mode: PredictionCullingMode;
-    readonly players: number;
-    readonly objects: number;
-    readonly frames: number;
-    readonly seed: number;
-    readonly radius: number;
-    readonly averagePredictedObjects: string;
-    readonly minPredictedObjects: number;
-    readonly maxPredictedObjects: number;
-    readonly visibleCorrections: number;
-    readonly hiddenAuthoritativeInteractions: number;
-    readonly predictedObjectSteps: number;
-    readonly verifiedObjectSteps: number;
-    readonly culledObjectSteps: number;
-    readonly restoreFrame: number;
-    readonly predictedChecksum: string;
-    readonly verifiedChecksum: string;
-    readonly resimulatedChecksum: string;
-    readonly predictionFilterChecksum: string;
-    readonly completeChecksum: string;
-    readonly result: 'pass' | 'fail';
-}
-export declare function runPredictionCullingLab(options: PredictionCullingOptions): PredictionCullingResult;

package/dist/prediction-culling.js

@@ -1,200 +0,0 @@
-import { defaultChecksum } from './canonical.js';
-export function runPredictionCullingLab(options) {
-    validateOptions(options);
-    const objects = createObjects(options);
-    let previousPredicted = new Set();
-    let predictedTotal = 0;
-    let minPredictedObjects = Number.POSITIVE_INFINITY;
-    let maxPredictedObjects = 0;
-    let visibleCorrections = 0;
-    let hiddenAuthoritativeInteractions = 0;
-    let predictedObjectSteps = 0;
-    let verifiedObjectSteps = 0;
-    let predictedChecksum = '';
-    let verifiedChecksum = '';
-    let completeChecksum = '';
-    const filterHistory = [];
-    const frameHistory = [];
-    const restoreFrame = Math.floor(options.frames * 0.6);
-    for (let frame = 0; frame < options.frames; frame += 1) {
-        const predictedBySlot = [];
-        const frameState = [];
-        for (const object of objects) {
-            frameState.push(getObjectFrameState(object, frame, options.seed));
-        }
-        frameHistory.push(frameState);
-        const localPredicted = new Set();
-        for (let slot = 0; slot < options.players; slot += 1) {
-            const player = getPlayerPosition(slot, frame, options.seed);
-            const slotPredicted = [];
-            for (const objectState of frameState) {
-                const object = objects[objectState.id];
-                if (shouldPredictObject(options.mode, player, object, objectState, options.radius)) {
-                    slotPredicted.push(objectState.id);
-                    if (slot === 0) {
-                        localPredicted.add(objectState.id);
-                    }
-                }
-            }
-            predictedObjectSteps += slotPredicted.length;
-            predictedBySlot.push(slotPredicted);
-        }
-        for (const objectState of frameState) {
-            if (objectState.canAffectPlayer && !localPredicted.has(objectState.id)) {
-                hiddenAuthoritativeInteractions += 1;
-            }
-        }
-        for (const objectId of localPredicted) {
-            if (!previousPredicted.has(objectId) && frame > 0) {
-                visibleCorrections += 1;
-            }
-        }
-        previousPredicted = localPredicted;
-        filterHistory.push(predictedBySlot);
-        predictedTotal += localPredicted.size;
-        minPredictedObjects = Math.min(minPredictedObjects, localPredicted.size);
-        maxPredictedObjects = Math.max(maxPredictedObjects, localPredicted.size);
-        predictedChecksum = defaultChecksum({
-            frame,
-            predictedBySlot,
-            previousChecksum: predictedChecksum,
-        });
-        verifiedObjectSteps += frameState.length;
-        verifiedChecksum = defaultChecksum({
-            frame,
-            objects: frameState,
-            previousChecksum: verifiedChecksum,
-        });
-        completeChecksum = defaultChecksum({
-            frame,
-            player: getPlayerPosition(0, frame, options.seed),
-            objects: frameState,
-            previousChecksum: completeChecksum,
-        });
-    }
-    const resimulatedChecksum = resimulateVerifiedChecksum(frameHistory, restoreFrame);
-    const predictionFilterChecksum = defaultChecksum(filterHistory);
-    const culledObjectSteps = options.mode === 'off' ? 0 : verifiedObjectSteps * options.players - predictedObjectSteps;
-    return {
-        mode: options.mode,
-        players: options.players,
-        objects: objects.length,
-        frames: options.frames,
-        seed: options.seed,
-        radius: options.radius,
-        averagePredictedObjects: (predictedTotal / options.frames).toFixed(2),
-        minPredictedObjects,
-        maxPredictedObjects,
-        visibleCorrections,
-        hiddenAuthoritativeInteractions,
-        predictedObjectSteps,
-        verifiedObjectSteps,
-        culledObjectSteps,
-        restoreFrame,
-        predictedChecksum,
-        verifiedChecksum,
-        resimulatedChecksum,
-        predictionFilterChecksum,
-        completeChecksum,
-        result: hiddenAuthoritativeInteractions === 0 && verifiedChecksum === resimulatedChecksum ? 'pass' : 'fail',
-    };
-}
-function createObjects(options) {
-    const objects = [];
-    for (let slot = 0; slot < options.players; slot += 1) {
-        for (let index = 0; index < options.objectsPerPlayer; index += 1) {
-            const id = objects.length;
-            objects.push({
-                id,
-                ownerSlot: slot,
-                offsetX: ((index * 37 + options.seed) % 90) - 45,
-                offsetY: ((index * 53 + options.seed) % 90) - 45,
-                alwaysPredict: index % 17 === 0,
-                canAffectPlayer: index % 17 === 0,
-            });
-        }
-    }
-    if (options.includeHiddenThreat === true) {
-        objects.push({
-            id: objects.length,
-            ownerSlot: Math.max(1, options.players - 1),
-            offsetX: 10_000,
-            offsetY: 10_000,
-            alwaysPredict: false,
-            canAffectPlayer: true,
-        });
-    }
-    return objects;
-}
-function shouldPredictObject(mode, player, object, objectState, radius) {
-    if (mode === 'off') {
-        return true;
-    }
-    if (object.alwaysPredict) {
-        return true;
-    }
-    const dx = objectState.x - player.x;
-    const dy = objectState.y - player.y;
-    return dx * dx + dy * dy <= radius * radius;
-}
-function getPlayerPosition(slot, frame, seed) {
-    return {
-        x: slot * 100 + ((frame * 3 + seed) % 37),
-        y: ((frame * 5 + seed) % 41) - 20,
-    };
-}
-function getObjectFrameState(object, frame, seed) {
-    const owner = getPlayerPosition(object.ownerSlot, frame, seed);
-    return {
-        id: object.id,
-        x: owner.x + object.offsetX + ((frame + object.id) % 7) - 3,
-        y: owner.y + object.offsetY + ((frame * 2 + object.id) % 7) - 3,
-        active: (frame + object.id) % 29 === 0 ? 0 : 1,
-        canAffectPlayer: object.canAffectPlayer,
-    };
-}
-function validateOptions(options) {
-    if (options.mode !== 'off' && options.mode !== 'local-area') {
-        throw new Error('prediction culling mode must be off or local-area');
-    }
-    if (!Number.isInteger(options.players) || options.players < 1 || options.players > 128) {
-        throw new Error('prediction culling players must be between 1 and 128');
-    }
-    if (!Number.isInteger(options.objectsPerPlayer) || options.objectsPerPlayer < 1 || options.objectsPerPlayer > 128) {
-        throw new Error('objectsPerPlayer must be between 1 and 128');
-    }
-    if (!Number.isInteger(options.frames) || options.frames < 1) {
-        throw new Error('prediction culling frames must be at least 1');
-    }
-    if (!Number.isInteger(options.seed)) {
-        throw new Error('prediction culling seed must be an integer');
-    }
-    if (!Number.isInteger(options.radius) || options.radius < 1) {
-        throw new Error('prediction culling radius must be a positive integer');
-    }
-}
-function resimulateVerifiedChecksum(frameHistory, restoreFrame) {
-    let checksum = '';
-    for (let frame = 0; frame < frameHistory.length; frame += 1) {
-        if (frame === restoreFrame) {
-            checksum = resimulateVerifiedChecksumPrefix(frameHistory, frame);
-        }
-        checksum = defaultChecksum({
-            frame,
-            objects: frameHistory[frame],
-            previousChecksum: checksum,
-        });
-    }
-    return checksum;
-}
-function resimulateVerifiedChecksumPrefix(frameHistory, endFrameExclusive) {
-    let checksum = '';
-    for (let frame = 0; frame < endFrameExclusive; frame += 1) {
-        checksum = defaultChecksum({
-            frame,
-            objects: frameHistory[frame],
-            previousChecksum: checksum,
-        });
-    }
-    return checksum;
-}