@series-inc/rundot-syncplay 5.23.0 → 5.24.0-beta.0

package/dist/cjs/deterministic-session.js

@@ -7,11 +7,13 @@ exports.runDeterministicSessionCoreFixture = runDeterministicSessionCoreFixture;
 exports.runDeterministicStructuredSessionInputFixture = runDeterministicStructuredSessionInputFixture;
 exports.runDeterministicSessionAuthorityFixture = runDeterministicSessionAuthorityFixture;
 exports.runDeterministicSessionLifecycleProtocolFixture = runDeterministicSessionLifecycleProtocolFixture;
+const runtime_support_js_1 = require("./runtime-support.js");
 const canonical_js_1 = require("./canonical.js");
 const commands_js_1 = require("./commands.js");
 const engine_runtime_js_1 = require("./engine-runtime.js");
 const random_js_1 = require("./random.js");
 function createDeterministicSessionCore(options) {
+    (0, runtime_support_js_1.assertSupportedJsRuntime)();
     assertPositiveInteger(options.players, 'players');
     if (options.reconnectGraceFrames !== undefined) {
         assertNonNegativeInteger(options.reconnectGraceFrames, 'reconnectGraceFrames');

package/dist/cjs/engine-parity-matrix.js

@@ -623,30 +623,47 @@ const engineParityMatrixEntries = [
             'packages/syncplay/src/physics2d.ts',
             'packages/syncplay/src/physics3d.ts',
             'packages/syncplay/src/physics3d-solver.ts',
+            'packages/syncplay/src/physics3d-toi.ts',
             'packages/syncplay/src/physics3d-joints.ts',
             'packages/syncplay/tests/physics2d.test.ts',
             'packages/syncplay/tests/physics3d-solver.test.ts',
             'packages/syncplay/tests/physics3d-joints.test.ts',
             'packages/syncplay/tests/physics3d-ccd.test.ts',
+            'packages/syncplay/tests/physics3d-toi.test.ts',
             'packages/syncplay/tests/engine-complete.test.ts',
             'packages/syncplay/src/physics3d-vehicle.ts',
             'packages/syncplay/tests/physics3d-vehicle.test.ts',
-            'warm-started sequential-impulse solver: stable stacking, tumbling, sleeping, axis locks, joints (ball/hinge/weld/rope/grab), speculative-contact CCD, compound colliders, orientation-aware queries',
+            'packages/syncplay/src/physics3d-stacking.ts',
+            'packages/syncplay/tests/physics3d-stacking.test.ts',
+            'packages/syncplay/src/physics3d-recipes.ts',
+            'packages/syncplay/tests/physics3d-recipes.test.ts',
+            'packages/syncplay/src/physics3d-hull.ts',
+            'packages/syncplay/tests/physics3d-hull.test.ts',
+            'TGS-Soft (sub-stepped soft-constraint) rigid solver: box3d-class stable stacking, tumbling, sleeping, axis locks, joints (ball/hinge/weld/rope/prismatic/spring/grab), opt-in TOI-bound CCD, compound colliders, orientation-aware queries',
+            'extreme-speed CCD (box3d model, src/physics3d-toi.ts): an opt-in ccd body whose per-tick motion exceeds half its smallest extent has its exact first time-of-impact found by GJK conservative advancement; it is advanced there and the impact resolved as a perfectly-inelastic collision (momentum transfers to the struck body — a fast bullet punches through and knocks targets loose, no non-physical stop-dead) with its position TOI-clamped so it never tunnels. A bullet at 60 units/tick into a resting stack or a frame+door cluster stays finite and bounded (fixes the #2821 relax divergence via witness-point contact anchors + a small speculative margin + shared multi-body seam impulse). Linear-sweep + stationary-target scope; glancing bodies slide (not frozen); non-ccd bodies still tunnel (opt-in). physics3d-ccd.test.ts covers momentum-transfer / no-freeze / finite-at-vx60 / rollback + permutation equivalence',
+            'stacking stability gated in CI: tower-15 (<1° tilt), 50:1 mass-ratio column, pyramid, kick-recovery, and a 20-layer stack all meet drift/penetration/up-alignment thresholds with rollback + authoring-order-permutation equivalence',
+            'convex-hull collision shape (4–16 verts): deterministic supporting-plane preprocessing, SAT+clip hull-vs-hull/box, closest-point hull-vs-sphere/capsule, support-sample hull-vs-static-mesh, exact ray/overlap/shape-cast queries; golden hull-pair battery pinned',
+            'cone-twist ball joint (swing cone + twist limits via fixed-point cosine) drives a 6-body ragdoll that settles kinetically and stays articulated; rigid-wheel vehicle recipe (sphere wheels + hinge motors) certified alongside the raycast controller',
             'builtin-rigid physics-cert lane passes all 4 determinism gates; contact/joint caches are checksummed rollback state',
-            'raycast-wheel vehicle controller (stepDeterministicVehicle3D): spring-damper suspension, friction-circle drive/steer/brake, fixed-point steering trig; certified via the physics-rigid-vehicle fixture, the builtin-rigid arena car, and a rollback-every-frame synctest scene',
-            'per-world static AABB-tree query index: raycast/overlap/shape-cast are O(log n + hits) with bit-identical results (oracle-tested; cert-lane checksums unchanged); batched applyDeterministicImpulses3D applies a frame of controller impulses in one canonical rebuild',
-            'pooled narrow-phase/constraint scratch (scalarized box face-clip over ping-pong clip slots, step-scoped constraint pool) pulled the 128-body pile impact-burst p99 from 2.06 ms to 1.54 ms (p50 0.85 → 0.72 ms, median-of-5); prismatic/breakable/collision-suppressed joints, a soft frequencyHz/dampingRatio spring joint, and per-body gravityScale round out the joint/body surface — joint breaks are sticky checksummed cache state',
+            'raycast-wheel vehicle controller (stepDeterministicVehicle3D): spring-damper suspension, friction-circle drive/steer/brake, fixed-point steering trig, moving-ground reaction (slip relative to the contact body; equal-and-opposite reaction on dynamic ground)',
+            'per-world static AABB-tree query index: raycast/overlap/shape-cast are O(log n + hits) with bit-identical results; batched applyDeterministicImpulses3D applies a frame of controller impulses in one canonical rebuild',
+            'pooled narrow-phase/constraint scratch (scalarized box face-clip over ping-pong clip slots, step-scoped constraint pool); prismatic/breakable/collision-suppressed joints, a soft frequencyHz/dampingRatio spring joint (breakable/disable-collision), and per-body gravityScale — joint breaks are sticky checksummed cache state',
+            'kinematic bodies integrate their authored velocity (linear + angular) inside the solver, drive the dynamic bodies they touch through the contact relative-velocity term, absorb the equal-and-opposite reaction (zero inverse mass), and wake the sleeping piles they push; a kinematic mesh is therefore a moving platform / conveyor collider. A dynamic mesh is rejected at world creation',
+            'one-sided mesh contacts resolve penetration for zero-radius shapes: a support sample projecting onto a triangle face uses its signed plane distance (capped at the sample shape\'s diameter), so a box or hull rests on and is pushed by a mesh instead of falling through it — previously only sphere/capsule (radius-bearing) samples could generate a resolvable mesh contact',
+            'compound colliders accept hull children (packages/syncplay/src/collider-cooking.ts): an offline V-HACD-shaped cooker voxelizes a concave triangle soup, splits it on the axis-aligned plane that best reduces concavity, and emits a compound of ≤16-vert convex hulls that the runtime validates with buildSolverHull. The cook is order-invariant and byte-reproducible (exact integer-lattice convex hull, lexicographic tie-breaks); no decomposition code runs in a simulation step',
         ],
         cliProofs: [
             'npm run lab:physics3d -- --bodies 128 --frames 1000 --no-fast-stress --json artifacts/reports/physics3d-no-fast.json',
+            'npm run lab:physics3d-stacks -- --json artifacts/reports/physics3d-stacks.json',
             'npm run certify:engine-complete -- --filter physics3d --players 128 --frames 5000 --no-fast-stress',
             'npm run lab:physics-cert -- --engine builtin-rigid --shape fixed-arena --players 4 --frames 600 --seed 7 --snapshot-every 8',
             'npm run coverage:package:physics-vehicle',
+            'npm run collider:validate -- <mesh.json> --json artifacts/reports/collider-validate.json',
         ],
         gaps: [
-            'Vehicles are raycast-wheel only (static ground, flat/axis-aligned contact normals); moving-ground reaction and rigid-wheel vehicles are tracked follow-ons.',
-            'Dynamic mesh-vs-mesh collision, convex-hull decomposition / visual collider import, and ragdolls-in-checksummed-state remain out of scope.',
-            'Cross-VM certification posture unchanged (V8↔V8 certified; WebKit nightly; Hermes documented gap).',
+            'Mesh-vs-mesh collision remains unsupported by design: a mesh collider is static or kinematic, and a dynamic concave body must be cooked to a compound of hulls (collider:cook).',
+            'Kinematic bodies resolve contacts discretely — a kinematic mesh driven faster than its own extent per tick can pass through a thin body (no CCD for kinematic; ccd is a dynamic-body opt-in).',
+            'Convex decomposition is offline only: the cooked hull set is conservative (it contains the source, inflated by up to one voxel of the chosen resolution) and hulls stay capped at 16 verts.',
         ],
         nextCliWork: [
             'Profile the remaining burst cost before further pooling; no known single lever.',
@@ -829,20 +846,26 @@ const engineParityMatrixEntries = [
         canCloseWithCli: true,
         currentEvidence: [
             'packages/syncplay/src/browser.ts',
+            'packages/syncplay/src/runtime-support.ts',
+            'packages/syncplay/tests/runtime-support.test.ts',
             'packages/sdk/src/syncplay/index.ts',
             'packages/sdk/src/syncplay/browser.ts',
             'packages/sdk/src/syncplay/node.ts',
             'packages/sdk/tests/deterministicMultiplayer.test.ts',
+            'cross-VM certification: Chromium (V8) AND WebKit (JavaScriptCore, the executable proxy for iOS WKWebView) are blocking gates on every engine PR (.github/workflows/ci-syncplay.yml cross-vm-browser). Each runs the replay proof, the number lab, and the 128-player/1000-frame engine-core numeric proof, and each must reproduce Node\'s checksums bit-for-bit; static:determinism requires a passing proof artifact per certified runtime, not just chromium',
+            'Hermes is an explicit non-goal with an enforced runtime guard: H5 games run in the platform WebView (V8 on Android, JavaScriptCore on iOS), never in React Native\'s VM, and no lane can execute Hermes — so createDeterministicSessionCore refuses to start there rather than emit checksums the authority server would silently reject (src/runtime-support.ts)',
         ],
         cliProofs: [
             'npm run lab:replay-verify-browser -- artifacts/replays/browser-proof-current.json --runtime chromium --json artifacts/certification/browser-replay-chromium-current.json',
+            'npm run lab:replay-verify-browser -- artifacts/replays/browser-proof-current.json --runtime webkit --json artifacts/certification/browser-replay-webkit-current.json',
+            'npm run lab:engine-core-browser -- --runtime webkit --json artifacts/certification/engine-core-numeric-webkit-current.json',
             'cd packages/sdk && npm test -- deterministicMultiplayer.test.ts --runInBand && npm run build:sdk',
         ],
         gaps: [
-            'Browser proof artifacts are not always present and are not yet mandatory for every parity report.',
+            'Android WebView is proven only by proxy (Chromium/V8 on Linux); the on-device APK replay harness stays a manual per-release step.',
         ],
         nextCliWork: [
-            'Require Chromium browser replay and SDK test-app proof artifacts in static:determinism certification mode.',
+            'Automate the Android WebView APK replay harness so the on-device proof stops being manual.',
         ],
         referenceDocs: [
             'external-deterministic-engine-reference:manual/replay',

package/dist/cjs/engine-parity.js

@@ -2531,7 +2531,7 @@ function runReplayWorkload128(frames, seed) {
         mismatches: verification.mismatches,
         finalChecksum: verification.finalChecksum,
         replayBytes: JSON.stringify(replay).length,
-        snapshotBytes: session.getSnapshot(session.currentFrame).stateBytes.byteLength,
+        snapshotBytes: session.getSnapshotBytes(session.currentFrame).byteLength,
     };
 }
 function runSecurityHostileClientCategory(config) {

package/dist/cjs/index.js

@@ -4,8 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeterministicCommandTimelineSnapshot = exports.createDeterministicCommandTimeline = exports.assertDeterministicPayloadFields = exports.translateAabb = exports.sortAabbsByStableId = exports.segmentsIntersect = exports.segmentSegmentDistance = exports.segmentPointDistance = exports.pointOnSegment = exports.orientation = exports.fixedVec2 = exports.fixedCircle = exports.fixedAabb = exports.closestPointOnSegment = exports.circleIntersectsAabb = exports.circleIntersects = exports.aabbIntersects = exports.aabbContainsPoint = exports.stableSortedKeys = exports.stableEntries = exports.deterministicShuffle = exports.createStableIndexedMap = exports.encodeUtf8 = exports.defaultChecksum = exports.decodeUtf8 = exports.decodeCanonicalValue = exports.cloneCanonical = exports.canonicalStringify = exports.canonicalize = exports.tickDeterministicHfsm = exports.tickDeterministicBehaviorTreeWithMemory = exports.tickDeterministicBehaviorTree = exports.selectDeterministicUtility = exports.runDeterministicBotSimulation = exports.getBlackboardValue = exports.createDeterministicBotBlackboard = exports.cookDeterministicBotAsset = exports.traceDeterministicBotDocument = exports.summarizeDeterministicBotDocumentTraceCoverage = exports.summarizeDeterministicBotDocumentTraceCounterDelta = exports.compileDeterministicBotDocument = exports.createDeterministicAuthorityRoom = exports.stableAssetCookJson = exports.materializePrototypeEntities = exports.cookDeterministicAssets = exports.assertAssetManifestMatches = exports.stepDeterministicAnimation = exports.reconstructDeterministicAnimationEvents = exports.createDeterministicAnimationRuntimeState = exports.cookDeterministicAnimation = void 0;
 exports.createDeterministicLocalAuthorityCorrectionEnvelope = exports.createDeterministicLocalAuthorityCommandBundleEnvelope = exports.createDeterministicLocalAuthorityAckEnvelope = exports.applyDeterministicLocalAuthorityInputBundleEnvelope = exports.applyDeterministicLocalAuthorityCommandBundleEnvelope = exports.createDeterministicLocalAuthorityRuntime = exports.validateDeterministicLagCompensatedShot3D = exports.validateDeterministicAuthoritativeLagCompensatedShot3D = exports.rewindDeterministicLagCompensatedTargets3D = exports.createDeterministicLagCompensation3DHistory = exports.buildDeterministicLagCompensatedHitboxProxies3D = exports.sortDeterministicInputTimelineFlags = exports.evaluateDeterministicInputTimelineResult = exports.accumulateDeterministicInputTimelineState = exports.createInputAuthority = exports.filterDeterministicEventsForPlayer = exports.createDeterministicEventTimeline = exports.SyncplayError = exports.validateDeterministicFrameSystemsStateless = exports.runDeterministicFrameRuntimeMutationCorpus = exports.isDeterministicFrameHeapStaleHandleError = exports.generateDeterministicFrameRuntimeSource = exports.createDeterministicSparseSetFrameRuntime = exports.createDeterministicSlotMap = exports.createDeterministicFrameRuntimeAccessors = exports.createDeterministicFrameRuntime = exports.createDeterministicBitset = exports.compileDeterministicDslRuntimeDescriptor = exports.assertDeterministicFrameSystemsStateless = exports.assertDeterministicFrameHeapStaleHandleError = exports.stableDeterministicEngineCompleteJson = exports.runDeterministicEngineCompleteSuite = exports.engineCompleteExecutionProofHash = exports.createDeterministicEventEffectsAdapter = exports.createEcsLiteWorld = exports.verifyDeterministicSessionRuntimeReplay = exports.createDeterministicSessionReplayBundle = exports.createDeterministicSessionCore = exports.stepTopDownBody = exports.stepKccLiteBody = exports.quantizeFpsAim = exports.detectVerticalCcdHit = exports.cookStaticColliders = exports.combineDeterministicPhysicsMaterial = exports.verifyDeterministicConfigBundle = exports.summarizeDeterministicConfigBundleFailureReasons = exports.evaluateDeterministicConfigBundleParityResult = exports.cookDeterministicConfigBundle = exports.evaluateDeterministicCommandTimelineMigrationResult = exports.deterministicPayloadMatchesFields = void 0;
 exports.queryDeterministicPhysicsShapeOverlap2D = exports.queryDeterministicPhysicsAabb2D = exports.nearestDeterministicPhysicsHit2D = exports.createDeterministicPhysicsWorld2D = exports.circleCastDeterministicPhysics2D = exports.createOfflineSession = exports.valueNoise2D = exports.valueNoise1D = exports.hashUint32 = exports.hash2 = exports.fbm2D = exports.createNetworkedSyncplayClient = exports.stepDeterministicNavmeshOffMeshTraversal = exports.stepDeterministicNavmeshAgents = exports.smoothDeterministicNavmeshPath = exports.runDeterministicNavmeshStress = exports.locateDeterministicNavmeshPolygon = exports.findDeterministicNavmeshPointPath = exports.findDeterministicNavmeshPath = exports.cookImportedDeterministicNavmesh = exports.cookDeterministicNavmesh = exports.stepDeterministicNavigationAgents = exports.smoothDeterministicPath = exports.findDeterministicPath = exports.createDeterministicFlowField = exports.cookTilemapNavigationGraph = exports.cookDeterministicNavigationGraph = exports.applyDeterministicReciprocalAvoidance = exports.stepDeterministicKcc3D = exports.stepDeterministicCarry3D = exports.validateDeterministicLagCompensatedHit = exports.stepDeterministicTopDownMover = exports.stepDeterministicKcc2D = exports.stepDeterministicFpsAim = exports.runDeterministicMovementSimulation = exports.runDeterministicMovementCrowdSimulation = exports.rewindDeterministicTargets = exports.createDeterministicMath = exports.encodeDeterministicLocalAuthorityWireEnvelope = exports.deterministicLocalAuthorityWireProtocol = exports.decodeDeterministicLocalAuthorityWireEnvelope = exports.createDeterministicLocalAuthorityWireReceiver = exports.createDeterministicLocalAuthorityWireAuth = exports.createDeterministicLocalAuthoritySnapshotTransfer = exports.createDeterministicLocalAuthoritySnapshotRequestEnvelope = exports.createDeterministicLocalAuthoritySnapshotOfferEnvelope = exports.createDeterministicLocalAuthoritySnapshotEnvelope = exports.createDeterministicLocalAuthoritySnapshotCompleteEnvelope = exports.createDeterministicLocalAuthoritySnapshotChunkEnvelope = exports.createDeterministicLocalAuthorityInputBundleEnvelope = void 0;
-exports.withRuntimeDeterminismGuards = exports.createDeterministicRollbackHistory = exports.stableReportJson = exports.stableReportDiffJson = exports.renderDeterministicReportHtml = exports.diffDeterministicReports = exports.createProtocolRollbackReport = exports.verifyScoredReplay = exports.stableFrameDumpJson = exports.stableFrameDiffJson = exports.inspectReplayFrameWithDescriptor = exports.inspectReplayFrame = exports.explainReplayChecksum = exports.diffReplayFrames = exports.verifyReplayScoreAgainstTrustedRuntime = exports.verifyDeterministicSelfContainedFrameRuntimeReplayBundle = exports.verifyDeterministicReplayBundle = exports.verifyDeterministicFrameRuntimeReplayBundle = exports.sliceDeterministicReplayBundle = exports.minimizeDeterministicReplayDesyncBundle = exports.minimizeDeterministicReplayDesync = exports.createDeterministicReplayRuntimeManifest = exports.createDeterministicReplayDebugTables = exports.createDeterministicReplayBundle = exports.verifyReplayWithDescriptor = exports.verifyReplay = exports.DeterministicRandom = exports.interpolateDeterministicRenderVec2 = exports.interpolateDeterministicRenderNumber = exports.createDeterministicR3fRenderAdapter = exports.createDeterministicR3fDebugOverlay = exports.stepDeterministicVehicle3D = exports.stepDeterministicPhysicsWorld3D = exports.shapeCastDeterministicPhysics3DDetailed = exports.shapeCastDeterministicPhysics3D = exports.setDeterministicBodyVelocity3D = exports.runDeterministicPhysics3DStress = exports.raycastDeterministicPhysics3DDetailed = exports.raycastDeterministicPhysics3D = exports.overlapDeterministicPhysics3D = exports.deterministicPhysicsCallback3D = exports.deterministicPhysicsBodyById3D = exports.deriveInverseInertia = exports.createDeterministicPhysicsWorld3D = exports.contactDetailsDeterministicPhysics3D = exports.applyDeterministicImpulses3D = exports.applyDeterministicImpulse3D = exports.stepDeterministicPhysicsWorld2D = exports.raycastDeterministicPhysics2D = exports.raycastAllDeterministicPhysics2D = void 0;
-exports.tickCooldown = exports.scheduleFrameEvent = exports.popDueFrameEvents = exports.millisecondsToFrames = exports.framesToMilliseconds = exports.createCooldown = exports.summarizeDeterministicLifecycleCounters = exports.createDeterministicLifecycleRunner = exports.createDeterministicSparseSet = exports.createDeterministicSignalBus = exports.encodeDeterministicSessionMessage = exports.deterministicSessionWireVersion = exports.decodeDeterministicSessionMessage = exports.encodeDeterministicStateSnapshot = exports.deterministicRoomDescriptorHash = exports.DEFAULT_SNAPSHOT_CHUNK_SIZE = exports.DEFAULT_MAX_SNAPSHOT_BYTES = exports.decodeDeterministicStateSnapshot = exports.createSnapshotTransferFromBytes = exports.createSnapshotTransferCollector = exports.bytesToBase64 = exports.base64ToBytes = exports.createSyncplayOfflineRuntime = exports.stableDeterministicDslSchemaJson = exports.parseDeterministicSchemaDsl = exports.deterministicDslMaxPlayers = exports.createDeterministicBinarySerializer = exports.proveSchemaBinaryRoundTrip = exports.generateSchemaTypes = exports.generateSchemaBinarySource = exports.createDeterministicDescriptorBinarySchema = exports.createSchemaArtifacts = exports.stableDescriptorId = exports.defineSyncplayGame = void 0;
+exports.diffDeterministicReports = exports.createProtocolRollbackReport = exports.verifyScoredReplay = exports.stableFrameDumpJson = exports.stableFrameDiffJson = exports.inspectReplayFrameWithDescriptor = exports.inspectReplayFrame = exports.explainReplayChecksum = exports.diffReplayFrames = exports.verifyReplayScoreAgainstTrustedRuntime = exports.verifyDeterministicSelfContainedFrameRuntimeReplayBundle = exports.verifyDeterministicReplayBundle = exports.verifyDeterministicFrameRuntimeReplayBundle = exports.sliceDeterministicReplayBundle = exports.minimizeDeterministicReplayDesyncBundle = exports.minimizeDeterministicReplayDesync = exports.createDeterministicReplayRuntimeManifest = exports.createDeterministicReplayDebugTables = exports.createDeterministicReplayBundle = exports.verifyReplayWithDescriptor = exports.verifyReplay = exports.DeterministicRandom = exports.interpolateDeterministicRenderVec2 = exports.interpolateDeterministicRenderNumber = exports.createDeterministicR3fRenderAdapter = exports.createDeterministicR3fDebugOverlay = exports.stepDeterministicVehicle3D = exports.runDeterministicTower3DScenario = exports.runDeterministicStackingSuite3D = exports.runDeterministicPyramid3DScenario = exports.runDeterministicMassRatio3DScenario = exports.runDeterministicKickRecovery3DScenario = exports.stepDeterministicPhysicsWorld3D = exports.shapeCastDeterministicPhysics3DDetailed = exports.shapeCastDeterministicPhysics3D = exports.setDeterministicBodyVelocity3D = exports.runDeterministicPhysics3DStress = exports.raycastDeterministicPhysics3DDetailed = exports.raycastDeterministicPhysics3D = exports.overlapDeterministicPhysics3D = exports.deterministicPhysicsCallback3D = exports.deterministicPhysicsBodyById3D = exports.deriveInverseInertia = exports.createDeterministicPhysicsWorld3D = exports.contactDetailsDeterministicPhysics3D = exports.applyDeterministicImpulses3D = exports.applyDeterministicImpulse3D = exports.stepDeterministicPhysicsWorld2D = exports.raycastDeterministicPhysics2D = exports.raycastAllDeterministicPhysics2D = void 0;
+exports.tickCooldown = exports.scheduleFrameEvent = exports.popDueFrameEvents = exports.millisecondsToFrames = exports.framesToMilliseconds = exports.createCooldown = exports.summarizeDeterministicLifecycleCounters = exports.createDeterministicLifecycleRunner = exports.createDeterministicSparseSet = exports.createDeterministicSignalBus = exports.encodeDeterministicSessionMessage = exports.deterministicSessionWireVersion = exports.decodeDeterministicSessionMessage = exports.encodeDeterministicStateSnapshot = exports.deterministicRoomDescriptorHash = exports.DEFAULT_SNAPSHOT_CHUNK_SIZE = exports.DEFAULT_MAX_SNAPSHOT_BYTES = exports.decodeDeterministicStateSnapshot = exports.createSnapshotTransferFromBytes = exports.createSnapshotTransferCollector = exports.bytesToBase64 = exports.base64ToBytes = exports.createSyncplayOfflineRuntime = exports.stableDeterministicDslSchemaJson = exports.parseDeterministicSchemaDsl = exports.deterministicDslMaxPlayers = exports.createDeterministicBinarySerializer = exports.proveSchemaBinaryRoundTrip = exports.generateSchemaTypes = exports.generateSchemaBinarySource = exports.createDeterministicDescriptorBinarySchema = exports.createSchemaArtifacts = exports.stableDescriptorId = exports.defineSyncplayGame = exports.withRuntimeDeterminismGuards = exports.createDeterministicRollbackHistory = exports.stableReportJson = exports.stableReportDiffJson = exports.renderDeterministicReportHtml = void 0;
 var animation_js_1 = require("./animation.js");
 Object.defineProperty(exports, "cookDeterministicAnimation", { enumerable: true, get: function () { return animation_js_1.cookDeterministicAnimation; } });
 Object.defineProperty(exports, "createDeterministicAnimationRuntimeState", { enumerable: true, get: function () { return animation_js_1.createDeterministicAnimationRuntimeState; } });
@@ -207,6 +207,12 @@ Object.defineProperty(exports, "setDeterministicBodyVelocity3D", { enumerable: t
 Object.defineProperty(exports, "shapeCastDeterministicPhysics3D", { enumerable: true, get: function () { return physics3d_js_1.shapeCastDeterministicPhysics3D; } });
 Object.defineProperty(exports, "shapeCastDeterministicPhysics3DDetailed", { enumerable: true, get: function () { return physics3d_js_1.shapeCastDeterministicPhysics3DDetailed; } });
 Object.defineProperty(exports, "stepDeterministicPhysicsWorld3D", { enumerable: true, get: function () { return physics3d_js_1.stepDeterministicPhysicsWorld3D; } });
+var physics3d_stacking_js_1 = require("./physics3d-stacking.js");
+Object.defineProperty(exports, "runDeterministicKickRecovery3DScenario", { enumerable: true, get: function () { return physics3d_stacking_js_1.runDeterministicKickRecovery3DScenario; } });
+Object.defineProperty(exports, "runDeterministicMassRatio3DScenario", { enumerable: true, get: function () { return physics3d_stacking_js_1.runDeterministicMassRatio3DScenario; } });
+Object.defineProperty(exports, "runDeterministicPyramid3DScenario", { enumerable: true, get: function () { return physics3d_stacking_js_1.runDeterministicPyramid3DScenario; } });
+Object.defineProperty(exports, "runDeterministicStackingSuite3D", { enumerable: true, get: function () { return physics3d_stacking_js_1.runDeterministicStackingSuite3D; } });
+Object.defineProperty(exports, "runDeterministicTower3DScenario", { enumerable: true, get: function () { return physics3d_stacking_js_1.runDeterministicTower3DScenario; } });
 var physics3d_vehicle_js_1 = require("./physics3d-vehicle.js");
 Object.defineProperty(exports, "stepDeterministicVehicle3D", { enumerable: true, get: function () { return physics3d_vehicle_js_1.stepDeterministicVehicle3D; } });
 var r3f_render_adapter_js_1 = require("./r3f-render-adapter.js");

package/dist/cjs/instant-replay.js

@@ -22,15 +22,10 @@ function runInstantReplay(options) {
         options.onFrame(session.getState(), session.currentFrame);
         expectedFrame += 1;
     }
-    const finalSnapshot = session.getSnapshot(session.currentFrame);
-    /* istanbul ignore if -- the session records a snapshot on every stepped frame. */
-    if (finalSnapshot === undefined) {
-        throw new errors_js_1.SyncplayError('Instant replay session has no snapshot at its final frame', {
-            code: 'instant-replay.missing-final-snapshot',
-            frame: session.currentFrame,
-        });
-    }
-    return { framesPlayed: options.inputs.length, finalChecksum: finalSnapshot.checksum };
+    return {
+        framesPlayed: options.inputs.length,
+        finalChecksum: session.computeRecordedChecksum(session.currentFrame),
+    };
 }
 /**
  * Binds a session config to a replay window. Each `run` simulates on a fresh

package/dist/cjs/movement3d.js

@@ -188,8 +188,11 @@ function computeKccPushImpulses(physics, x, y, z, velocity, geometry, maxPushImp
         const magnitude = Math.min(speedIntoBody * KCC_PUSH_MASS, maxPushImpulse);
         impulses.push({
             bodyId: body.id,
+            // Apply through the body's center of mass so the horizontal push slides the
+            // body rather than torquing it — the soft-step solver's livelier angular
+            // response otherwise lets an above-COM push tumble a light crate.
             impulse: { x: dirX * magnitude, y: 0, z: dirZ * magnitude },
-            point: { x: body.x, y, z: body.z },
+            point: { x: body.x, y: body.y, z: body.z },
         });
     }
     return impulses;
@@ -260,6 +263,19 @@ function primitiveHalfExtent(shape, m) {
     if (shape.type === 'sphere') {
         return { x: shape.radius, y: shape.radius, z: shape.radius };
     }
+    if (shape.type === 'hull') {
+        // Same symmetric bound the solver uses (physics3d-solver shapeHalfExtent).
+        let ext = { x: 0, y: 0, z: 0 };
+        for (const vertex of shape.vertices) {
+            const rotated = (0, physics3d_shared_js_1.mulMat3Vec)(m, vertex);
+            ext = {
+                x: Math.max(ext.x, Math.abs(rotated.x)),
+                y: Math.max(ext.y, Math.abs(rotated.y)),
+                z: Math.max(ext.z, Math.abs(rotated.z)),
+            };
+        }
+        return ext;
+    }
     if (shape.type === 'box') {
         return {
             x: Math.abs(m[0]) * shape.halfX + Math.abs(m[1]) * shape.halfY + Math.abs(m[2]) * shape.halfZ,

package/dist/cjs/networked-client.js

@@ -394,7 +394,7 @@ function createNetworkedSyncplayClient(options) {
             return '';
         }
         active.restoreToFrame(frame);
-        return String((0, canonical_js_1.defaultChecksum)(active.getState()));
+        return active.getWireStateChecksum(frame);
     }
     function applyConfirmedFrames(frames) {
         for (const frame of frames) {
@@ -457,9 +457,9 @@ function createNetworkedSyncplayClient(options) {
     /**
      * Report the confirmed-state checksum at `tick`, read from the rolling
      * snapshot buffer — NOT via restoreToFrame, which would rewind the live
-     * session out from under prediction. Buffer state is the serialize
-     * round-trip of the live state, i.e. exactly what a snapshot joiner will
-     * hydrate, so quorum comparisons are round-trip-consistent by construction.
+     * session out from under prediction. Quorum consistency comes from the wire
+     * checksum's full-state serialize/deserialize round-trip; synctest's codec
+     * phase verifies that round-trip is canonical on every retained frame.
      * Ticks that fell out of the buffer are skipped (the client simply is not
      * donor-eligible for them).
      */
@@ -469,7 +469,7 @@ function createNetworkedSyncplayClient(options) {
         if (active === undefined || tick < 0 || role === 'spectator') {
             return;
         }
-        const snapshot = active.getSnapshot(tick + 1);
+        const snapshot = active.peekSnapshot(tick + 1);
         if (snapshot === undefined) {
             return;
         }
@@ -477,7 +477,7 @@ function createNetworkedSyncplayClient(options) {
             kind: 'checksum-report',
             slot,
             tick,
-            checksum: (0, canonical_js_1.defaultChecksum)(snapshot.state),
+            checksum: active.getWireStateChecksum(snapshot.frame),
         }));
         reportedTicks.push(tick);
         if (reportedTicks.length > REPORTED_TICKS_RETAINED) {
@@ -531,7 +531,7 @@ function createNetworkedSyncplayClient(options) {
         const minTick = minFrame - 1;
         const candidates = reportedTicks.filter((tick) => tick >= minTick).sort((a, b) => a - b);
         for (const tick of candidates) {
-            const snapshot = active.getSnapshot(tick + 1);
+            const snapshot = active.peekSnapshot(tick + 1);
             const confirmedAtTick = timeline[tick];
             if (snapshot === undefined || confirmedAtTick === undefined) {
                 continue;
@@ -540,9 +540,9 @@ function createNetworkedSyncplayClient(options) {
                 v: 1,
                 tick,
                 sessionFrame: tick + 1,
-                stateBytes: (0, session_snapshot_js_1.bytesToBase64)(snapshot.stateBytes),
+                stateBytes: (0, session_snapshot_js_1.bytesToBase64)(active.getSnapshotBytes(snapshot.frame)),
                 randomState: snapshot.randomState,
-                stateChecksum: (0, canonical_js_1.defaultChecksum)(snapshot.state),
+                stateChecksum: active.getWireStateChecksum(snapshot.frame),
                 confirmedInputs: confirmedAtTick.map((input) => (0, canonical_js_1.cloneCanonical)(input)),
             });
             donorTransferCounter += 1;
@@ -613,6 +613,8 @@ function createNetworkedSyncplayClient(options) {
             randomState: snapshot.randomState,
             inputs: snapshot.confirmedInputs.map((input) => decodeInputSafe(input)),
         });
+        // The active state was just deserialized, so this is already the same
+        // round-tripped full-state basis used by the donor's wire checksum.
         const actualChecksum = (0, canonical_js_1.defaultChecksum)(active.getState());
         if (actualChecksum !== snapshot.stateChecksum) {
             throw new errors_js_1.SyncplayError('Hydrated snapshot state does not match its declared checksum', {

package/dist/cjs/node.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stableEngineParityJson = exports.runEngineParitySuite = exports.explainEngineParityFixture = exports.runChaosCertificationSuite = exports.explainChaosFixture = exports.startLocalWebSocketProtocolServer = exports.runLocalWebSocketAdapterTest = exports.runNetworkedInputAuthoritySpike = exports.defaultNetworkedInputAuthoritySpikeOptions = exports.verifyReplayScoreAgainstTrustedRuntime = exports.verifyReplay = exports.createSyncplaySession = exports.createOfflineSession = void 0;
+exports.cookConvexDecomposition = exports.assertCookedColliderIsRuntimeValid = exports.stableEngineParityJson = exports.runEngineParitySuite = exports.explainEngineParityFixture = exports.runChaosCertificationSuite = exports.explainChaosFixture = exports.startLocalWebSocketProtocolServer = exports.runLocalWebSocketAdapterTest = exports.runNetworkedInputAuthoritySpike = exports.defaultNetworkedInputAuthoritySpikeOptions = exports.verifyReplayScoreAgainstTrustedRuntime = exports.verifyReplay = exports.createSyncplaySession = exports.createOfflineSession = void 0;
 __exportStar(require("./multiplayer-service.js"), exports);
 __exportStar(require("./input-authority.js"), exports);
 __exportStar(require("./local-authority-wire.js"), exports);
@@ -49,3 +49,7 @@ var engine_parity_js_1 = require("./engine-parity.js");
 Object.defineProperty(exports, "explainEngineParityFixture", { enumerable: true, get: function () { return engine_parity_js_1.explainEngineParityFixture; } });
 Object.defineProperty(exports, "runEngineParitySuite", { enumerable: true, get: function () { return engine_parity_js_1.runEngineParitySuite; } });
 Object.defineProperty(exports, "stableEngineParityJson", { enumerable: true, get: function () { return engine_parity_js_1.stableEngineParityJson; } });
+// Offline collider cooking — build-time only, never part of a simulation step.
+var collider_cooking_js_1 = require("./collider-cooking.js");
+Object.defineProperty(exports, "assertCookedColliderIsRuntimeValid", { enumerable: true, get: function () { return collider_cooking_js_1.assertCookedColliderIsRuntimeValid; } });
+Object.defineProperty(exports, "cookConvexDecomposition", { enumerable: true, get: function () { return collider_cooking_js_1.cookConvexDecomposition; } });

package/dist/cjs/offline-session.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOfflineSession = createOfflineSession;
 const canonical_js_1 = require("./canonical.js");
+const checksum_basis_js_1 = require("./checksum-basis.js");
 const errors_js_1 = require("./errors.js");
 const math_js_1 = require("./math.js");
 const random_js_1 = require("./random.js");
@@ -14,6 +15,8 @@ function createOfflineSession(config) {
     const randomSeed = config.randomSeed ?? 1;
     const fixedFrameMs = 1000 / config.tickRate;
     const math = (0, math_js_1.createDeterministicMath)();
+    // LOAD-BEARING: these two clones make frame-0 reference retention private to
+    // each session and insulate exportReplay's initialState.
     const initialState = (0, canonical_js_1.cloneCanonical)(config.initialState);
     const mutable = {
         frame: 0,
@@ -165,20 +168,39 @@ function createOfflineSession(config) {
                 ],
             };
         },
+        peekSnapshot(frame) {
+            return mutable.snapshots.get(frame);
+        },
         getSnapshot(frame) {
             const snapshot = mutable.snapshots.get(frame);
             return snapshot === undefined ? undefined : cloneSnapshot(snapshot);
         },
+        getSnapshotBytes(frame) {
+            return (0, checksum_basis_js_1.serializeStateWith)(config, requireSnapshot(mutable, frame).state);
+        },
+        exportExternalSnapshot(frame) {
+            const snapshot = requireSnapshot(mutable, frame);
+            return {
+                frame: snapshot.frame,
+                stateBytes: (0, checksum_basis_js_1.serializeStateWith)(config, snapshot.state),
+                randomState: snapshot.randomState,
+                inputs: snapshot.inputs.map((input) => cloneInput(config, input)),
+            };
+        },
+        getRecordedChecksum(frame) {
+            return requireSnapshot(mutable, frame).checksum;
+        },
+        computeRecordedChecksum(frame) {
+            const snapshot = requireSnapshot(mutable, frame);
+            return snapshot.checksum ?? getChecksum(config, snapshot.state);
+        },
+        getWireStateChecksum(frame) {
+            return (0, checksum_basis_js_1.computeWireStateChecksum)(config, requireSnapshot(mutable, frame).state);
+        },
         restoreToFrame(frame) {
-            const snapshot = mutable.snapshots.get(frame);
-            if (snapshot === undefined) {
-                throw new errors_js_1.SyncplayError(`No snapshot exists for frame ${frame}`, {
-                    code: 'session.missing-snapshot',
-                    frame,
-                });
-            }
+            const snapshot = requireSnapshot(mutable, frame);
             mutable.frame = snapshot.frame;
-            mutable.state = (0, canonical_js_1.cloneCanonical)(snapshot.state);
+            mutable.state = snapshot.state;
             mutable.inputs = snapshot.inputs.map((input) => cloneInput(config, input));
             mutable.inputFlags = Array.from({ length: config.playerCount }, (_, slot) => defaultInputFlags(slot));
             mutable.random.restore({ state: snapshot.randomState });
@@ -193,7 +215,7 @@ function createOfflineSession(config) {
             (0, errors_js_1.invariant)(Number.isInteger(snapshot.frame) && snapshot.frame >= 0, 'External snapshot frame must be a non-negative integer', 'session.invalid-snapshot-frame');
             (0, errors_js_1.invariant)(snapshot.inputs.length === config.playerCount, 'External snapshot inputs must cover every player slot', 'session.invalid-snapshot-inputs');
             mutable.frame = snapshot.frame;
-            mutable.state = deserializeState(config, snapshot.stateBytes);
+            mutable.state = (0, checksum_basis_js_1.deserializeStateWith)(config, snapshot.stateBytes);
             mutable.inputs = snapshot.inputs.map((input) => cloneInput(config, input));
             mutable.inputFlags = Array.from({ length: config.playerCount }, (_, slot) => defaultInputFlags(slot));
             mutable.random.restore({ state: snapshot.randomState });
@@ -205,13 +227,16 @@ function createOfflineSession(config) {
             mutable.snapshots = new Map();
             mutable.snapshotOrder = [];
             hydratedFromExternalSnapshot = true;
-            recordSnapshot(config, mutable, snapshotBufferSize);
+            const hydratedChecksum = mutable.frame % checksumInterval === 0
+                ? getChecksum(config, mutable.state)
+                : undefined;
+            recordSnapshot(config, mutable, snapshotBufferSize, hydratedChecksum);
         },
         getSnapshotFrames() {
             return [...mutable.snapshotOrder];
         },
     };
-    recordSnapshot(config, mutable, snapshotBufferSize);
+    recordSnapshot(config, mutable, snapshotBufferSize, getChecksum(config, mutable.state));
     return session;
 }
 function runFrames(config, mutable, checksumInterval, snapshotBufferSize, replayRecordingMode, math, count) {
@@ -251,8 +276,10 @@ function runFrames(config, mutable, checksumInterval, snapshotBufferSize, replay
                 ? (0, runtime_guards_js_1.withRuntimeDeterminismGuards)(frame, () => config.step(mutable.state, effectiveInputs, frame, stepContext))
                 : config.step(mutable.state, effectiveInputs, frame, stepContext);
         mutable.frame += 1;
-        const checksum = getChecksum(config, mutable.state);
-        if (mutable.frame % checksumInterval === 0) {
+        const checksum = mutable.frame % checksumInterval === 0
+            ? getChecksum(config, mutable.state)
+            : undefined;
+        if (checksum !== undefined) {
             const checksumRecord = { frame: mutable.frame, checksum };
             config.onChecksumRecorded?.(checksumRecord);
             if (replayRecordingMode === 'memory') {
@@ -322,26 +349,28 @@ function pruneSnapshotsAfterFrame(mutable, frame) {
         return true;
     });
 }
+function requireSnapshot(mutable, frame) {
+    const snapshot = mutable.snapshots.get(frame);
+    if (snapshot === undefined) {
+        throw new errors_js_1.SyncplayError(`No snapshot exists for frame ${frame}`, {
+            code: 'session.missing-snapshot',
+            frame,
+        });
+    }
+    return snapshot;
+}
 function getChecksum(config, state) {
     return String(config.checksum?.(state) ?? (0, canonical_js_1.defaultChecksum)(config.canonicalizeState?.(state) ?? state));
 }
 function cloneInput(config, input) {
     return (0, canonical_js_1.cloneCanonical)(input);
 }
-function serializeState(config, state) {
-    return config.serializeState?.(state) ?? (0, canonical_js_1.encodeCanonicalBytes)(config.canonicalizeState?.(state) ?? state);
-}
-function deserializeState(config, bytes) {
-    return config.deserializeState?.(bytes) ?? (0, canonical_js_1.decodeCanonicalBytes)(bytes);
-}
 function recordSnapshot(config, mutable, snapshotBufferSize, checksum) {
-    const stateBytes = serializeState(config, mutable.state);
     const snapshot = {
         frame: mutable.frame,
         inputs: mutable.inputs.map((input) => cloneInput(config, input)),
-        checksum: checksum ?? getChecksum(config, mutable.state),
-        state: deserializeState(config, stateBytes),
-        stateBytes,
+        checksum,
+        state: mutable.state,
         randomState: mutable.random.snapshot().state,
     };
     const alreadyStored = mutable.snapshots.has(snapshot.frame);
@@ -364,7 +393,6 @@ function cloneSnapshot(snapshot) {
         inputs: snapshot.inputs.map((input) => (0, canonical_js_1.cloneCanonical)(input)),
         checksum: snapshot.checksum,
         state: (0, canonical_js_1.cloneCanonical)(snapshot.state),
-        stateBytes: new Uint8Array(snapshot.stateBytes),
         randomState: snapshot.randomState,
     };
 }

package/dist/cjs/physics-cert.js

@@ -319,13 +319,18 @@ function buildRigidArena(options) {
         // hinge door
         bodies.push({ id: `frame-${slot}`, kind: 'static', x: baseX + 3, y: 2, z: 0, vx: 0, vy: 0, vz: 0, shape: { type: 'box', halfX: 0.1, halfY: 0.5, halfZ: 0.5 }, layer: 1, mask: 1 });
         bodies.push({ id: `door-${slot}`, kind: 'dynamic', x: baseX + 4, y: 2, z: 0, vx: 0, vy: 0, vz: 0, mass: 1, orientation: ident, angularVel: { x: 0, y: 0, z: 0 }, shape: { type: 'box', halfX: 1, halfY: 0.5, halfZ: 0.1 }, layer: 1, mask: 1 });
-        joints.push({ id: `hinge-${slot}`, type: 'hinge', a: `frame-${slot}`, b: `door-${slot}`, anchorA: { x: 0, y: 0, z: 0 }, anchorB: { x: -1, y: 0, z: 0 }, axisA: { x: 0, y: 1, z: 0 }, motorSpeed: 0.02, maxMotorTorque: 50 });
+        joints.push({ id: `hinge-${slot}`, type: 'hinge', a: `frame-${slot}`, b: `door-${slot}`, anchorA: { x: 0, y: 0, z: 0 }, anchorB: { x: -1, y: 0, z: 0 }, axisA: { x: 0, y: 1, z: 0 }, motorSpeed: 0.02, maxMotorTorque: 50, disableCollision: true });
         // grab-target box
         bodies.push({ id: `grab-${slot}`, kind: 'dynamic', x: baseX + 6, y: 3, z: 0, vx: 0, vy: 0, vz: 0, mass: 1, orientation: ident, angularVel: { x: 0, y: 0, z: 0 }, shape: { type: 'box', halfX: 0.5, halfY: 0.5, halfZ: 0.5 }, layer: 1, mask: 1 });
         joints.push({ id: `carry-${slot}`, type: 'grab', body: `grab-${slot}`, anchor: { x: 0, y: 0, z: 0 }, targetX: baseX + 6, targetY: 4, targetZ: 0, maxForce: 20 });
         // ccd projectile toward a thin wall
         bodies.push({ id: `wall-${slot}`, kind: 'static', x: baseX + 9, y: 2, z: 0, vx: 0, vy: 0, vz: 0, shape: { type: 'box', halfX: 0.05, halfY: 2, halfZ: 2 }, layer: 1, mask: 1 });
-        bodies.push({ id: `bullet-${slot}`, kind: 'dynamic', x: baseX - 20, y: 2, z: 0, vx: 60, vy: 0, vz: 0, mass: 1, orientation: ident, angularVel: { x: 0, y: 0, z: 0 }, ccd: true, linearDamping: 1, angularDamping: 1, shape: { type: 'box', halfX: 0.2, halfY: 0.2, halfZ: 0.2 }, layer: 1, mask: 1 });
+        // vx 8 tunnels the 0.1-thick wall per step without CCD, so this exercises the
+        // exact-TOI ccd path while staying a settling-scale impact the convergence gate can
+        // reach. The extreme-speed case (vx 60 into a stack) is finiteness/determinism-tested
+        // in physics3d-ccd.test.ts — a physical punch-through does not re-settle, so it cannot
+        // live in a convergence budget.
+        bodies.push({ id: `bullet-${slot}`, kind: 'dynamic', x: baseX - 20, y: 2, z: 0, vx: 8, vy: 0, vz: 0, mass: 1, orientation: ident, angularVel: { x: 0, y: 0, z: 0 }, ccd: true, linearDamping: 1, angularDamping: 1, shape: { type: 'box', halfX: 0.2, halfY: 0.2, halfZ: 0.2 }, layer: 1, mask: 1 });
         // soft spring: bob hung 2 below a static anchor, restLength 1 → oscillates and settles
         bodies.push({ id: `spring-anchor-${slot}`, kind: 'static', x: baseX + 2, y: 6, z: 3, vx: 0, vy: 0, vz: 0, shape: { type: 'box', halfX: 0.1, halfY: 0.1, halfZ: 0.1 }, layer: 2, mask: 2 });
         bodies.push({ id: `spring-bob-${slot}`, kind: 'dynamic', x: baseX + 2, y: 4, z: 3, vx: 0, vy: 0, vz: 0, mass: 1, orientation: ident, angularVel: { x: 0, y: 0, z: 0 }, shape: { type: 'box', halfX: 0.3, halfY: 0.3, halfZ: 0.3 }, layer: 2, mask: 2 });