@series-inc/rundot-syncplay 5.26.0-beta.9 → 5.27.0

package/dist/authority-room.d.ts

@@ -179,6 +179,8 @@ export interface AuthorityRoomNetcodeStats {
     readonly confirmedThrough: number;
     /** Ticks in which each slot's input had to be substituted (cumulative). */
     readonly substitutedTicksBySlot: Readonly<Record<number, number>>;
+    /** Slots with a seated player. Empty slots substitute every tick by design. */
+    readonly occupiedSlots: readonly number[];
     readonly clientStats: Readonly<Record<number, AuthorityRoomClientNetStats>>;
     /** Command requests dropped for seat, size, rate, sequence, or stale generation. */
     readonly rejectedCommands: number;
@@ -239,6 +241,14 @@ export interface DeterministicAuthorityRoom {
      * ticks, so this is idempotent.
      */
     onPlayerReconnected(playerId: string): void;
+    /**
+     * A player's transport dropped and their seat entered the host's grace
+     * window. The slot stays reserved and keeps being substituted, so release
+     * the input they were holding — otherwise a player who drops mid-movement
+     * keeps moving until the grace window expires. Safe to call for a player
+     * with no slot (spectator, unknown id).
+     */
+    onPlayerDisconnected(playerId: string): void;
     /** Advance the authority by one server tick and broadcast newly-confirmed frames. */
     onTick(): void;
     /**

package/dist/authority-room.js

@@ -351,6 +351,11 @@ export function createDeterministicAuthorityRoom(transport, config) {
         sendCatchUpTo(playerId, plan, 'join');
         return true;
     }
+    function onPlayerDisconnected(playerId) {
+        const slot = slotByPlayer.get(playerId);
+        if (slot !== undefined)
+            authority.neutralizeSlot(slot);
+    }
     function onPlayerReconnected(playerId) {
         // A spectator reconnect is a full re-greet: its timeline may have forked
         // arbitrarily far and it holds no slot the redundancy window protects.
@@ -779,6 +784,10 @@ export function createDeterministicAuthorityRoom(transport, config) {
         // departed player's input; their slot stays reserved because `assignedSlots` never decreases,
         // so the authority substitutes for it rather than handing the number to a new joiner.
         const slot = slotByPlayer.get(playerId);
+        // The slot stays reserved and keeps being substituted (see above), so
+        // release the departing player's last held input.
+        if (slot !== undefined)
+            authority.neutralizeSlot(slot);
         slotByPlayer.delete(playerId);
         if (slot !== undefined)
             secretAuthority?.onPlayerLeft(playerId, slot);
@@ -853,6 +862,7 @@ export function createDeterministicAuthorityRoom(transport, config) {
         onPlayerSecretMessage,
         onPlayerLeave,
         onPlayerReconnected,
+        onPlayerDisconnected,
         onTick,
         snapshot() {
             return {
@@ -899,6 +909,7 @@ export function createDeterministicAuthorityRoom(transport, config) {
             return {
                 confirmedThrough: authority.confirmedThrough,
                 substitutedTicksBySlot: Object.fromEntries(substitutedTicksBySlot),
+                occupiedSlots: [...slotByPlayer.values()].sort((a, b) => a - b),
                 clientStats: Object.fromEntries(clientNetStatsBySlot),
                 rejectedCommands,
                 rejectedReconfigures,

package/dist/browser.d.ts

@@ -24,8 +24,8 @@ export { createNetworkedSyncplayClient, prepareNetworkedSyncplayTransport } from
 export { createSyncplayRunner } from './runner.js';
 export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
 export { circleCastDeterministicPhysics2D, createDeterministicPhysicsWorld2D, nearestDeterministicPhysicsHit2D, queryDeterministicPhysicsAabb2D, queryDeterministicPhysicsShapeOverlap2D, raycastAllDeterministicPhysics2D, raycastDeterministicPhysics2D, stepDeterministicPhysicsWorld2D } from './physics2d.js';
-export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
-export { cookDeterministicVoxelChunkCollider3D } from './physics3d-voxel.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, setDeterministicKinematicPoses3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
+export { cookDeterministicVoxelChunkCollider3D, raycastDeterministicVoxelChunk3D } from './physics3d-voxel.js';
 export { cylinderHullVertices } from './physics3d-hull.js';
 export { createDeterministicCosmeticPhysicsWorld3D, setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D, stepDeterministicCosmeticPhysicsWorld3D } from './cosmetic-physics3d.js';
 export { stepDeterministicVehicle3D } from './physics3d-vehicle.js';
@@ -35,7 +35,7 @@ export { createDeterministicDescriptorBinarySchema, generateSchemaBinarySource,
 export { createDeterministicBinarySerializer, deterministicDslMaxPlayers, parseDeterministicSchemaDsl, stableDeterministicDslSchemaJson } from './schema-dsl-binary.js';
 export { createSyncplaySession } from './sdk-session.js';
 export { createSessionFromPromotionSnapshot, exportPromotionSnapshot } from './session-promotion.js';
-export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot } from './session-snapshot.js';
+export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot, MAX_JSON_ESCAPE_EXPANSION, SNAPSHOT_CHUNK_ENVELOPE_OVERHEAD_BYTES } from './session-snapshot.js';
 export { decodeDeterministicSessionMessage, deterministicSessionWireVersion, encodeDeterministicSessionMessage } from './session-wire.js';
 export { createDeterministicSignalBus } from './signals.js';
 export { createDeterministicSparseSet } from './sparse-set.js';
@@ -65,8 +65,8 @@ export type { CookedDeterministicNavmesh, DeterministicNavmeshAgent, Determinist
 export type { ConfirmedSyncplayPresentationFrame, KinetixRuntimeFactory, NetworkedClientTransport, NetworkedSyncplayClient, NetworkedSyncplayClientInputDelayOptions, NetworkedSyncplayClientNetStats, NetworkedSyncplayClientOptions, NetworkedSyncplayClientPacingOptions, NetworkedSyncplayPreparationOptions, NetworkedSyncplaySessionDescriptor, NetworkedSyncplaySlotPresence, PreparedNetworkedSyncplayTransport, SyncplayPredictionMode, SyncplayRemoteInputPrediction } from './networked-client.js';
 export type { SyncplayRunner, SyncplayRunnerConfig, SyncplayRunnerConnectionEvent, SyncplayRunnerOccupancy, SyncplayRunnerOfflineOptions, SyncplayRunnerPresentation, SyncplayRunnerSnapshot, SyncplayRunnerStatus, SyncplayRunnerTransport } from './runner.js';
 export type { DeterministicBodyKind, DeterministicContactEvent2D, DeterministicContactEventType, DeterministicPhysicsAabbQuery2D, DeterministicPhysicsActivePair2D, DeterministicPhysicsBody2D, DeterministicPhysicsCircleCastQuery2D, DeterministicPhysicsConstraint2D, DeterministicPhysicsHit2D, DeterministicPhysicsQueryOptions2D, DeterministicPhysicsRaycastQuery2D, DeterministicPhysicsShape2D, DeterministicPhysicsShapeOverlapQuery2D, DeterministicPhysicsStepOptions2D, DeterministicPhysicsStepResult2D, DeterministicPhysicsWorld2D } from './physics2d.js';
-export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D, DeterministicPhysicsWorldEdit3D } from './physics3d.js';
-export type { DeterministicVoxelChunk3D, DeterministicVoxelCompoundShape3D } from './physics3d-voxel.js';
+export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicKinematicPose3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D, DeterministicPhysicsWorldEdit3D } from './physics3d.js';
+export type { DeterministicVoxelChunk3D, DeterministicVoxelCompoundShape3D, DeterministicVoxelRayHit3D } from './physics3d-voxel.js';
 export type { DeterministicAuthoritativeBodyProxy3D, DeterministicCosmeticPhysicsBody3D, DeterministicCosmeticPhysicsStepOptions3D, DeterministicCosmeticPhysicsStepResult3D, DeterministicCosmeticPhysicsWorld3D } from './cosmetic-physics3d.js';
 export type { DeterministicPhysicsJoint3D } from './physics3d-joints.js';
 export type { DeterministicVehicle3D, DeterministicVehicleImpulse3D, DeterministicVehicleInput3D, DeterministicVehicleStepOptions3D, DeterministicVehicleStepResult3D, DeterministicVehicleWheel3D, DeterministicVehicleWheelTelemetry3D } from './physics3d-vehicle.js';

package/dist/browser.js

@@ -25,8 +25,8 @@ export { createNetworkedSyncplayClient, prepareNetworkedSyncplayTransport } from
 export { createSyncplayRunner } from './runner.js';
 export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
 export { circleCastDeterministicPhysics2D, createDeterministicPhysicsWorld2D, nearestDeterministicPhysicsHit2D, queryDeterministicPhysicsAabb2D, queryDeterministicPhysicsShapeOverlap2D, raycastAllDeterministicPhysics2D, raycastDeterministicPhysics2D, stepDeterministicPhysicsWorld2D } from './physics2d.js';
-export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
-export { cookDeterministicVoxelChunkCollider3D } from './physics3d-voxel.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, setDeterministicKinematicPoses3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
+export { cookDeterministicVoxelChunkCollider3D, raycastDeterministicVoxelChunk3D } from './physics3d-voxel.js';
 export { cylinderHullVertices } from './physics3d-hull.js';
 export { createDeterministicCosmeticPhysicsWorld3D, setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D, stepDeterministicCosmeticPhysicsWorld3D } from './cosmetic-physics3d.js';
 export { stepDeterministicVehicle3D } from './physics3d-vehicle.js';
@@ -36,7 +36,7 @@ export { createDeterministicDescriptorBinarySchema, generateSchemaBinarySource,
 export { createDeterministicBinarySerializer, deterministicDslMaxPlayers, parseDeterministicSchemaDsl, stableDeterministicDslSchemaJson } from './schema-dsl-binary.js';
 export { createSyncplaySession } from './sdk-session.js';
 export { createSessionFromPromotionSnapshot, exportPromotionSnapshot } from './session-promotion.js';
-export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot } from './session-snapshot.js';
+export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot, MAX_JSON_ESCAPE_EXPANSION, SNAPSHOT_CHUNK_ENVELOPE_OVERHEAD_BYTES } from './session-snapshot.js';
 export { decodeDeterministicSessionMessage, deterministicSessionWireVersion, encodeDeterministicSessionMessage } from './session-wire.js';
 export { createDeterministicSignalBus } from './signals.js';
 export { createDeterministicSparseSet } from './sparse-set.js';

package/dist/creator.d.ts

@@ -12,12 +12,12 @@ export type { RecordedChecksum, RecordedCommandFrame, RecordedDebugEvent, Record
 export type { ReplayRuntimeFactory, ReplayVerificationConfig, ReplayVerificationExecution } from './replay.js';
 export type { SyncplaySession, SyncplaySessionPolicy } from './sdk-session.js';
 export type { InstantReplayInputFrame, InstantReplayResult, InstantReplayRunner, InstantReplayRunnerOptions, InstantReplayRunOptions, RunInstantReplayOptions, } from './instant-replay.js';
-export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D, } from './physics3d.js';
-export { cookDeterministicVoxelChunkCollider3D } from './physics3d-voxel.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, setDeterministicKinematicPoses3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D, } from './physics3d.js';
+export { cookDeterministicVoxelChunkCollider3D, raycastDeterministicVoxelChunk3D } from './physics3d-voxel.js';
 export { cylinderHullVertices } from './physics3d-hull.js';
 export { stepDeterministicVehicle3D } from './physics3d-vehicle.js';
-export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D, DeterministicPhysicsWorldEdit3D, } from './physics3d.js';
-export type { DeterministicVoxelChunk3D, DeterministicVoxelCompoundShape3D } from './physics3d-voxel.js';
+export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicKinematicPose3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D, DeterministicPhysicsWorldEdit3D, } from './physics3d.js';
+export type { DeterministicVoxelChunk3D, DeterministicVoxelCompoundShape3D, DeterministicVoxelRayHit3D } from './physics3d-voxel.js';
 export type { DeterministicPhysicsJoint3D } from './physics3d-joints.js';
 export type { DeterministicVehicle3D, DeterministicVehicleImpulse3D, DeterministicVehicleInput3D, DeterministicVehicleStepOptions3D, DeterministicVehicleStepResult3D, DeterministicVehicleWheel3D, DeterministicVehicleWheelTelemetry3D, } from './physics3d-vehicle.js';
 export type { DeterministicPhysicsMaterial } from './deterministic-primitives.js';

package/dist/creator.js

@@ -9,7 +9,7 @@ export { runSyncplaySynctest } from './synctest.js';
 // create/step/edit, impulses, queries, vehicles, and voxel-chunk collider
 // cooking. Cosmetic physics, KCC (movement3d), and the destruction-cert runner
 // stay off it — the first two are not requested, the third reads wall clock.
-export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D, } from './physics3d.js';
-export { cookDeterministicVoxelChunkCollider3D } from './physics3d-voxel.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, setDeterministicKinematicPoses3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D, } from './physics3d.js';
+export { cookDeterministicVoxelChunkCollider3D, raycastDeterministicVoxelChunk3D } from './physics3d-voxel.js';
 export { cylinderHullVertices } from './physics3d-hull.js';
 export { stepDeterministicVehicle3D } from './physics3d-vehicle.js';

package/dist/dev-authority-room.js

@@ -1,5 +1,5 @@
 import { createDeterministicAuthorityRoom, } from './authority-room.js';
-import { SYSTEM_MSG_RECONNECTED } from '@series-inc/rundot-game-sdk/mp-server';
+import { SYSTEM_MSG_DISCONNECTED, SYSTEM_MSG_RECONNECTED } from '@series-inc/rundot-game-sdk/mp-server';
 import { createHash, createPrivateKey, generateKeyPairSync, randomBytes, sign } from 'node:crypto';
 import { validateSyncplaySecretSystemsConfig } from './secret-config.js';
 import { assertKinetixRuntimeIdentity, kinetixSessionConfigDigest, } from '@series-inc/rundot-syncplay/core/runtime';
@@ -138,6 +138,13 @@ export class DevSyncplayAuthorityRoom {
                 this.room.onPlayerReconnected(playerId);
                 return;
             }
+            // The dev server already emits this on socket loss. Handle it so local
+            // play matches production: a player who drops mid-movement stops instead
+            // of having their held input repeated through the grace window.
+            if (msgType === SYSTEM_MSG_DISCONNECTED) {
+                this.room.onPlayerDisconnected(playerId);
+                return;
+            }
             if (msgType === SECRET_MSG_TYPE) {
                 const envelope = typeof data === 'string' ? data : JSON.stringify(data);
                 this.room.onPlayerSecretMessage(playerId, envelope);

package/dist/index.d.ts

@@ -27,8 +27,8 @@ export { createNetworkedSyncplayClient, prepareNetworkedSyncplayTransport } from
 export { createSyncplayRunner } from './runner.js';
 export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
 export { circleCastDeterministicPhysics2D, createDeterministicPhysicsWorld2D, nearestDeterministicPhysicsHit2D, queryDeterministicPhysicsAabb2D, queryDeterministicPhysicsShapeOverlap2D, raycastAllDeterministicPhysics2D, raycastDeterministicPhysics2D, stepDeterministicPhysicsWorld2D } from './physics2d.js';
-export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
-export { cookDeterministicVoxelChunkCollider3D } from './physics3d-voxel.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, setDeterministicKinematicPoses3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
+export { cookDeterministicVoxelChunkCollider3D, raycastDeterministicVoxelChunk3D } from './physics3d-voxel.js';
 export { cylinderHullVertices } from './physics3d-hull.js';
 export { runDeterministicPhysics3DDestructionCert } from './physics3d-destruction-cert.js';
 export { createDeterministicCosmeticPhysicsWorld3D, setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D, stepDeterministicCosmeticPhysicsWorld3D } from './cosmetic-physics3d.js';
@@ -44,7 +44,7 @@ export { withRuntimeDeterminismGuards } from './runtime-guards.js';
 export { createDeterministicDescriptorBinarySchema, generateSchemaBinarySource, generateSchemaTypes, proveSchemaBinaryRoundTrip } from './schema-codegen.js';
 export { createDeterministicBinarySerializer, deterministicDslMaxPlayers, parseDeterministicSchemaDsl, stableDeterministicDslSchemaJson } from './schema-dsl-binary.js';
 export { createSyncplaySession } from './sdk-session.js';
-export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot } from './session-snapshot.js';
+export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot, MAX_JSON_ESCAPE_EXPANSION, SNAPSHOT_CHUNK_ENVELOPE_OVERHEAD_BYTES } from './session-snapshot.js';
 export { decodeDeterministicSessionMessage, deterministicSessionWireVersion, encodeDeterministicSessionMessage } from './session-wire.js';
 export { createDeterministicSignalBus } from './signals.js';
 export { createDeterministicSparseSet } from './sparse-set.js';
@@ -77,8 +77,8 @@ export type { CookedDeterministicNavmesh, DeterministicNavmeshAgent, Determinist
 export type { ConfirmedSyncplayPresentationFrame, KinetixRuntimeFactory, NetworkedClientTransport, NetworkedSyncplayClient, NetworkedSyncplayClientInputDelayOptions, NetworkedSyncplayClientNetStats, NetworkedSyncplayClientOptions, NetworkedSyncplayClientPacingOptions, NetworkedSyncplayPreparationOptions, NetworkedSyncplaySessionDescriptor, PreparedNetworkedSyncplayTransport, SyncplayPredictionMode, SyncplayRemoteInputPrediction } from './networked-client.js';
 export type { SyncplayRunner, SyncplayRunnerConfig, SyncplayRunnerConnectionEvent, SyncplayRunnerOccupancy, SyncplayRunnerOfflineOptions, SyncplayRunnerPresentation, SyncplayRunnerSnapshot, SyncplayRunnerStatus, SyncplayRunnerTransport } from './runner.js';
 export type { DeterministicBodyKind, DeterministicContactEvent2D, DeterministicContactEventType, DeterministicPhysicsAabbQuery2D, DeterministicPhysicsBody2D, DeterministicPhysicsCircleCastQuery2D, DeterministicPhysicsConstraint2D, DeterministicPhysicsHit2D, DeterministicPhysicsQueryOptions2D, DeterministicPhysicsRaycastQuery2D, DeterministicPhysicsShape2D, DeterministicPhysicsShapeOverlapQuery2D, DeterministicPhysicsStepOptions2D, DeterministicPhysicsStepResult2D, DeterministicPhysicsWorld2D } from './physics2d.js';
-export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D, DeterministicPhysicsWorldEdit3D } from './physics3d.js';
-export type { DeterministicVoxelChunk3D, DeterministicVoxelCompoundShape3D } from './physics3d-voxel.js';
+export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicKinematicPose3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D, DeterministicPhysicsWorldEdit3D } from './physics3d.js';
+export type { DeterministicVoxelChunk3D, DeterministicVoxelCompoundShape3D, DeterministicVoxelRayHit3D } from './physics3d-voxel.js';
 export type { DeterministicDestructionCertOptions, DeterministicDestructionCertResult } from './physics3d-destruction-cert.js';
 export type { DeterministicAuthoritativeBodyProxy3D, DeterministicCosmeticPhysicsBody3D, DeterministicCosmeticPhysicsStepOptions3D, DeterministicCosmeticPhysicsStepResult3D, DeterministicCosmeticPhysicsWorld3D } from './cosmetic-physics3d.js';
 export type { DeterministicPhysicsJoint3D } from './physics3d-joints.js';

package/dist/index.js

@@ -28,8 +28,8 @@ export { createNetworkedSyncplayClient, prepareNetworkedSyncplayTransport } from
 export { createSyncplayRunner } from './runner.js';
 export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
 export { circleCastDeterministicPhysics2D, createDeterministicPhysicsWorld2D, nearestDeterministicPhysicsHit2D, queryDeterministicPhysicsAabb2D, queryDeterministicPhysicsShapeOverlap2D, raycastAllDeterministicPhysics2D, raycastDeterministicPhysics2D, stepDeterministicPhysicsWorld2D } from './physics2d.js';
-export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
-export { cookDeterministicVoxelChunkCollider3D } from './physics3d-voxel.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, applyDeterministicWorldEdit3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, createTrustedDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, setDeterministicKinematicPoses3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
+export { cookDeterministicVoxelChunkCollider3D, raycastDeterministicVoxelChunk3D } from './physics3d-voxel.js';
 export { cylinderHullVertices } from './physics3d-hull.js';
 export { runDeterministicPhysics3DDestructionCert } from './physics3d-destruction-cert.js';
 export { createDeterministicCosmeticPhysicsWorld3D, setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D, stepDeterministicCosmeticPhysicsWorld3D } from './cosmetic-physics3d.js';
@@ -45,7 +45,7 @@ export { withRuntimeDeterminismGuards } from './runtime-guards.js';
 export { createDeterministicDescriptorBinarySchema, generateSchemaBinarySource, generateSchemaTypes, proveSchemaBinaryRoundTrip } from './schema-codegen.js';
 export { createDeterministicBinarySerializer, deterministicDslMaxPlayers, parseDeterministicSchemaDsl, stableDeterministicDslSchemaJson } from './schema-dsl-binary.js';
 export { createSyncplaySession } from './sdk-session.js';
-export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot } from './session-snapshot.js';
+export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot, MAX_JSON_ESCAPE_EXPANSION, SNAPSHOT_CHUNK_ENVELOPE_OVERHEAD_BYTES } from './session-snapshot.js';
 export { decodeDeterministicSessionMessage, deterministicSessionWireVersion, encodeDeterministicSessionMessage } from './session-wire.js';
 export { createDeterministicSignalBus } from './signals.js';
 export { createDeterministicSparseSet } from './sparse-set.js';

package/dist/input-authority.d.ts

@@ -83,6 +83,14 @@ export interface InputAuthority {
      * frontier; a no-op at or below the current earliest retained tick.
      */
     pruneConfirmedBefore(tick: number): void;
+    /**
+     * Forget a slot's last confirmed input so later substitutions fall back to
+     * `neutralInput`. Call this when a slot's player disconnects or leaves: the
+     * slot stays reserved and keeps being substituted, so without this the
+     * authority repeats whatever they were holding when they dropped for the
+     * rest of the match. Out-of-roster slots are ignored.
+     */
+    neutralizeSlot(slot: number): void;
     stats(): InputAuthorityStats;
 }
 export declare function createInputAuthority(config: InputAuthorityConfig): InputAuthority;

package/dist/input-authority.js

@@ -185,6 +185,19 @@ export function createInputAuthority(config) {
             }
             earliestRetained = tick;
         },
+        neutralizeSlot(slot) {
+            if (!Number.isInteger(slot) || slot < 0 || slot >= playerCount)
+                return;
+            lastConfirmedInput[slot] = config.neutralInput;
+            // Resetting the last-confirmed value is not enough on its own: clients
+            // queue ahead by `inputDelayTicks`, so a dropping player usually has
+            // future ticks already buffered. `confirmTick` reassigns
+            // `lastConfirmedInput` from any submitted input, so leaving those in
+            // place would resurrect the held input on the very next confirm.
+            for (const slots of pending.values()) {
+                slots[slot] = undefined;
+            }
+        },
         stats() {
             return { confirmedTicks, substitutedInputs, droppedLateInputs, rejectedFutureInputs };
         },

package/dist/networked-client.d.ts

@@ -142,6 +142,14 @@ export interface NetworkedSyncplayClientNetStats {
     readonly droppedConfirmedPresentationFrames: number;
     /** Commands this client refused to send (oversized payload). */
     readonly rejectedCommands: number;
+    /**
+     * Confirmed ticks in which THIS client's own input was substituted because it
+     * did not reach the authority in time. Monotonic within a session and reset on
+     * session-start. Counted per applied tick, so a batch of confirmations that
+     * substitutes some ticks and not the last one still reports every one — a
+     * consumer reading `confirmedPlayerPresence` alone sees only the final tick.
+     */
+    readonly ownInputSubstitutions: number;
 }
 export type NetworkedSyncplaySlotPresence = 'human' | 'substituted' | 'empty' | 'unknown';
 export interface ConfirmedSyncplayPresentationFrame<Projection> {

package/dist/networked-client.js

@@ -282,6 +282,7 @@ export function createNetworkedSyncplayClient(options) {
     let sessionGeneration = 0;
     let commandSequence = 0;
     let droppedConfirmedPresentationFrames = 0;
+    let ownInputSubstitutions = 0;
     let rejectedCommands = 0;
     const ephemeralHandlers = new Set();
     let pendingEphemeral;
@@ -427,6 +428,7 @@ export function createNetworkedSyncplayClient(options) {
             confirmed.clear();
             reportedTicks.length = 0;
             lastAutoReportedTick = -1;
+            ownInputSubstitutions = 0;
             transferCollector = createSnapshotTransferCollector(snapshotCollectorOptions);
             outgoingTransferQueue.length = 0;
             tickRateHz = message.tickRateHz;
@@ -912,6 +914,11 @@ export function createNetworkedSyncplayClient(options) {
             for (let playerSlot = 0; playerSlot < playerCount; playerSlot += 1) {
                 lastConfirmedBySlot[playerSlot] = confInputs[playerSlot];
             }
+            // Per APPLIED tick, not per drained batch: `confirmedPlayerPresence`
+            // latches only the last tick of a batch, so a burst that substitutes
+            // several ticks and ends on a delivered one would otherwise vanish.
+            if (slot >= 0 && confFrame.substitutedSlots.includes(slot))
+                ownInputSubstitutions += 1;
             appliedThrough = tick;
             confirmedPlayerPresence = classifyPresence(confFrame);
             const presentationEligible = presentationWasLive || (freshRoomFirstFrame && tick === 0);
@@ -1232,6 +1239,7 @@ export function createNetworkedSyncplayClient(options) {
                 maxRollbackDepth,
                 droppedConfirmedPresentationFrames,
                 rejectedCommands,
+                ownInputSubstitutions,
             };
         },
         get generation() {

package/dist/node.d.ts

@@ -19,6 +19,8 @@ export { buildMerkleTree, bytesToHex, concatBytes, constantTimeEqual, createBrow
 export type { SyncplaySecretAuthorityCrypto, SyncplaySecretBrowserCrypto } from './secret-crypto.js';
 export * from './ws-frame.js';
 export { SYNCPLAY_DETERMINISTIC_ROOM_OPTION_KEYS } from './rooms-config-keys.js';
+export { createSyncplayRuntimePin, parseSyncplayRuntimeRoomMetadata, MAX_SYNCPLAY_SESSION_CONFIG_BYTES, } from './runtime-room-metadata.js';
+export type { SyncplayRuntimeIdentity, SyncplayRuntimeRoomMetadata, ParsedSyncplayRuntimeRoomMetadata, SyncplayRuntimeConfigInput, } from './runtime-room-metadata.js';
 export type { SyncplayDeterministicRoomOptionKey } from './rooms-config-keys.js';
 export { assertCookedColliderIsRuntimeValid, cookConvexDecomposition, } from './collider-cooking.js';
 export type { ColliderCookOptions, ColliderSourceMesh, CookedCollider, CookedColliderHull, } from './collider-cooking.js';

package/dist/node.js

@@ -16,6 +16,7 @@ export * from './secret-authority.js';
 export { buildMerkleTree, bytesToHex, concatBytes, constantTimeEqual, createBrowserSyncplaySecretCrypto, hexToBytes, merkleLeafHash, merkleNodeHash, merkleProof, sha256Bytes, signedReceiptBytes, verifyHashChainReveal, verifyMerkleProof, verifySyncplaySignedReceipt, } from './secret-crypto.js';
 export * from './ws-frame.js';
 export { SYNCPLAY_DETERMINISTIC_ROOM_OPTION_KEYS } from './rooms-config-keys.js';
+export { createSyncplayRuntimePin, parseSyncplayRuntimeRoomMetadata, MAX_SYNCPLAY_SESSION_CONFIG_BYTES, } from './runtime-room-metadata.js';
 export { assertCookedColliderIsRuntimeValid, cookConvexDecomposition, } from './collider-cooking.js';
 // Dev-server deterministic room class (relocated from the game SDK). A game's
 // vite.config passes this to rundotMultiplayerPlugin({ deterministicRoomClass }).

package/dist/physics3d-voxel.d.ts

@@ -1,4 +1,4 @@
-import type { DeterministicPhysicsShape3D } from './physics3d.js';
+import type { DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsShape3D } from './physics3d.js';
 export interface DeterministicVoxelChunk3D {
     readonly dimX: number;
     readonly dimY: number;
@@ -8,9 +8,31 @@ export interface DeterministicVoxelChunk3D {
     /** Row-major occupancy: occupancy[x + dimX * (y + dimY * z)]; non-zero = solid. */
     readonly occupancy: readonly (0 | 1)[];
 }
+export interface DeterministicVoxelRayHit3D {
+    readonly hit: boolean;
+    readonly distance: number;
+    readonly voxelX: number;
+    readonly voxelY: number;
+    readonly voxelZ: number;
+    readonly point: {
+        readonly x: number;
+        readonly y: number;
+        readonly z: number;
+    };
+    readonly normal: {
+        readonly x: number;
+        readonly y: number;
+        readonly z: number;
+    };
+}
 export type DeterministicVoxelCompoundShape3D = Extract<DeterministicPhysicsShape3D, {
     readonly type: 'compound';
 }>;
+/**
+ * Amanatides & Woo 3D Digital Differential Analyzer (DDA) fast voxel grid raycaster.
+ * Marches through chunk cells in O(distance) directly over the occupancy bitset.
+ */
+export declare function raycastDeterministicVoxelChunk3D(chunk: DeterministicVoxelChunk3D, query: DeterministicPhysicsRaycastQuery3D): DeterministicVoxelRayHit3D | undefined;
 /**
  * Deterministic greedy box merge: scan z→y→x ascending and grow each unconsumed
  * solid cell into the largest box along +x, then +y, then +z. A solid n³ chunk

package/dist/physics3d-voxel.js

@@ -1,3 +1,141 @@
+/**
+ * Amanatides & Woo 3D Digital Differential Analyzer (DDA) fast voxel grid raycaster.
+ * Marches through chunk cells in O(distance) directly over the occupancy bitset.
+ */
+export function raycastDeterministicVoxelChunk3D(chunk, query) {
+    const { dimX, dimY, dimZ, cellSize, occupancy } = chunk;
+    if (cellSize <= 0 || occupancy.length !== dimX * dimY * dimZ) {
+        return undefined;
+    }
+    const dirLen = Math.hypot(query.dx, query.dy, query.dz);
+    if (dirLen <= 1e-12) {
+        return undefined;
+    }
+    const dx = query.dx / dirLen;
+    const dy = query.dy / dirLen;
+    const dz = query.dz / dirLen;
+    const maxDistance = query.maxDistance;
+    if (maxDistance < 0) {
+        return undefined;
+    }
+    const ox = query.x / cellSize;
+    const oy = query.y / cellSize;
+    const oz = query.z / cellSize;
+    let tMin = 0;
+    let tMax = maxDistance / cellSize;
+    let enterNormal = { x: 0, y: 0, z: 0 };
+    const axes = [
+        { o: ox, d: dx, min: 0, max: dimX, nx: 1, ny: 0, nz: 0 },
+        { o: oy, d: dy, min: 0, max: dimY, nx: 0, ny: 1, nz: 0 },
+        { o: oz, d: dz, min: 0, max: dimZ, nx: 0, ny: 0, nz: 1 },
+    ];
+    for (const axis of axes) {
+        if (Math.abs(axis.d) < 1e-12) {
+            if (axis.o < axis.min || axis.o > axis.max) {
+                return undefined;
+            }
+        }
+        else {
+            let t1 = (axis.min - axis.o) / axis.d;
+            let t2 = (axis.max - axis.o) / axis.d;
+            let n1 = { x: -axis.nx, y: -axis.ny, z: -axis.nz };
+            if (t1 > t2) {
+                const temp = t1;
+                t1 = t2;
+                t2 = temp;
+                n1 = { x: axis.nx, y: axis.ny, z: axis.nz };
+            }
+            if (t1 > tMin) {
+                tMin = t1;
+                enterNormal = n1;
+            }
+            if (t2 < tMax) {
+                tMax = t2;
+            }
+            if (tMin > tMax) {
+                return undefined;
+            }
+        }
+    }
+    if (ox >= 0 && ox < dimX && oy >= 0 && oy < dimY && oz >= 0 && oz < dimZ) {
+        tMin = 0;
+    }
+    const startX = ox + dx * tMin;
+    const startY = oy + dy * tMin;
+    const startZ = oz + dz * tMin;
+    let currentX = Math.floor(startX);
+    let currentY = Math.floor(startY);
+    let currentZ = Math.floor(startZ);
+    currentX = Math.max(0, Math.min(dimX - 1, currentX));
+    currentY = Math.max(0, Math.min(dimY - 1, currentY));
+    currentZ = Math.max(0, Math.min(dimZ - 1, currentZ));
+    const stepX = dx > 0 ? 1 : dx < 0 ? -1 : 0;
+    const stepY = dy > 0 ? 1 : dy < 0 ? -1 : 0;
+    const stepZ = dz > 0 ? 1 : dz < 0 ? -1 : 0;
+    const tDeltaX = stepX !== 0 ? Math.abs(1 / dx) : Infinity;
+    const tDeltaY = stepY !== 0 ? Math.abs(1 / dy) : Infinity;
+    const tDeltaZ = stepZ !== 0 ? Math.abs(1 / dz) : Infinity;
+    let tMaxX = stepX > 0 ? (currentX + 1 - ox) / dx : stepX < 0 ? (currentX - ox) / dx : Infinity;
+    let tMaxY = stepY > 0 ? (currentY + 1 - oy) / dy : stepY < 0 ? (currentY - oy) / dy : Infinity;
+    let tMaxZ = stepZ > 0 ? (currentZ + 1 - oz) / dz : stepZ < 0 ? (currentZ - oz) / dz : Infinity;
+    let currentNormal = enterNormal;
+    let hitDistanceGrid = tMin;
+    while (currentX >= 0 && currentX < dimX && currentY >= 0 && currentY < dimY && currentZ >= 0 && currentZ < dimZ) {
+        const cellIndex = currentX + dimX * (currentY + dimY * currentZ);
+        if (occupancy[cellIndex] === 1) {
+            const worldDistance = hitDistanceGrid * cellSize;
+            if (worldDistance > maxDistance) {
+                return undefined;
+            }
+            const hitPoint = {
+                x: query.x + dx * worldDistance,
+                y: query.y + dy * worldDistance,
+                z: query.z + dz * worldDistance,
+            };
+            return {
+                hit: true,
+                distance: worldDistance,
+                voxelX: currentX,
+                voxelY: currentY,
+                voxelZ: currentZ,
+                point: hitPoint,
+                normal: currentNormal,
+            };
+        }
+        if (tMaxX < tMaxY) {
+            if (tMaxX < tMaxZ) {
+                hitDistanceGrid = tMaxX;
+                tMaxX += tDeltaX;
+                currentX += stepX;
+                currentNormal = { x: -stepX, y: 0, z: 0 };
+            }
+            else {
+                hitDistanceGrid = tMaxZ;
+                tMaxZ += tDeltaZ;
+                currentZ += stepZ;
+                currentNormal = { x: 0, y: 0, z: -stepZ };
+            }
+        }
+        else {
+            if (tMaxY < tMaxZ) {
+                hitDistanceGrid = tMaxY;
+                tMaxY += tDeltaY;
+                currentY += stepY;
+                currentNormal = { x: 0, y: -stepY, z: 0 };
+            }
+            else {
+                hitDistanceGrid = tMaxZ;
+                tMaxZ += tDeltaZ;
+                currentZ += stepZ;
+                currentNormal = { x: 0, y: 0, z: -stepZ };
+            }
+        }
+        if (hitDistanceGrid > tMax) {
+            break;
+        }
+    }
+    return undefined;
+}
 /**
  * Deterministic greedy box merge: scan z→y→x ascending and grow each unconsumed
  * solid cell into the largest box along +x, then +y, then +z. A solid n³ chunk

package/dist/physics3d.d.ts

@@ -202,6 +202,23 @@ export interface DeterministicPhysicsDetailedHit3D extends DeterministicPhysicsH
     readonly point: Point3D;
     readonly normal: Point3D;
     readonly penetration: number;
+    readonly childIndex?: number;
+}
+export interface DeterministicKinematicPose3D {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly rx?: number;
+    readonly ry?: number;
+    readonly rz?: number;
+    readonly orientation?: DeterministicPhysicsQuaternion3D;
+    readonly vx?: number;
+    readonly vy?: number;
+    readonly vz?: number;
+    readonly angularVelX?: number;
+    readonly angularVelY?: number;
+    readonly angularVelZ?: number;
 }
 export interface DeterministicPhysicsScheduledQuery3D {
     readonly id: string;
@@ -363,6 +380,15 @@ export interface DeterministicPhysicsWorldEdit3D {
  * inside each edit list.
  */
 export declare function applyDeterministicWorldEdit3D(world: DeterministicPhysicsWorld3D, edit: DeterministicPhysicsWorldEdit3D): DeterministicPhysicsWorld3D;
+/**
+ * Fast batch update of kinematic body transforms and velocities without
+ * allocating Set instances or re-sorting world bodies. Wakes touching dynamic
+ * bodies across active contact pairs. If linear velocity (vx, vy, vz) is omitted
+ * and dtTicks (> 0) is supplied, linear velocity is derived as (newPos - oldPos) / dtTicks.
+ */
+export declare function setDeterministicKinematicPoses3D(world: DeterministicPhysicsWorld3D, poses: readonly DeterministicKinematicPose3D[], options?: {
+    readonly dtTicks?: number;
+}): DeterministicPhysicsWorld3D;
 /**
  * Apply a deterministic impulse to a body (linear + angular via lever arm),
  * waking the body and its contact island. Returns a new canonical world.