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

package/dist/cjs/cosmetic-physics3d.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeterministicCosmeticPhysicsWorld3D = createDeterministicCosmeticPhysicsWorld3D;
+exports.setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D = setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D;
+exports.stepDeterministicCosmeticPhysicsWorld3D = stepDeterministicCosmeticPhysicsWorld3D;
+const physics3d_js_1 = require("./physics3d.js");
+const internalPhysicsWorldByCosmeticWorld = new WeakMap();
+function createDeterministicCosmeticPhysicsWorld3D(bodies, authoritativeBodyProxies = []) {
+    const normalized = normalizeCosmeticBodies(bodies, authoritativeBodyProxies);
+    const world = {
+        frame: 0,
+        bodies: normalized.bodies,
+        authoritativeBodyProxies: normalized.authoritativeBodyProxies,
+    };
+    internalPhysicsWorldByCosmeticWorld.set(world, createSimulationWorld(normalized));
+    return world;
+}
+function setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D(world, authoritativeBodyProxies) {
+    const normalized = normalizeCosmeticBodies(world.bodies, authoritativeBodyProxies);
+    const nextWorld = {
+        frame: world.frame,
+        bodies: normalized.bodies,
+        authoritativeBodyProxies: normalized.authoritativeBodyProxies,
+    };
+    const previousSimulationWorld = internalPhysicsWorldByCosmeticWorld.get(world);
+    if (previousSimulationWorld !== undefined) {
+        internalPhysicsWorldByCosmeticWorld.set(nextWorld, previousSimulationWorld);
+    }
+    return nextWorld;
+}
+function stepDeterministicCosmeticPhysicsWorld3D(world, options = {}) {
+    const normalized = normalizeCosmeticBodies(world.bodies, world.authoritativeBodyProxies);
+    const previousSimulationWorld = internalPhysicsWorldByCosmeticWorld.get(world);
+    const baseSimulationWorld = createSimulationWorld(normalized, previousSimulationWorld);
+    const movedProxyIds = movedAuthoritativeBodyProxyIds(previousSimulationWorld, normalized.authoritativeBodyProxies);
+    const simulationWorld = wakeSleepingCosmeticBodies(baseSimulationWorld, previousSimulationWorld, movedProxyIds);
+    const stepped = (0, physics3d_js_1.stepDeterministicPhysicsWorld3D)(simulationWorld, {
+        gravityY: options.gravityY,
+        dtTicks: options.dtTicks,
+        velocityIterations: options.velocityIterations,
+        substeps: options.substeps,
+        computeChecksum: false,
+        computeBroadphasePairs: options.computeBroadphasePairs,
+    });
+    const nextBodies = stepped.world.bodies.filter((body) => body.kind === 'dynamic');
+    const cosmeticBodyIds = new Set([
+        ...normalized.bodies.map((body) => body.id),
+        ...(previousSimulationWorld?.bodies ?? [])
+            .filter((body) => body.kind === 'dynamic')
+            .map((body) => body.id),
+    ]);
+    const nextWorld = {
+        frame: world.frame + 1,
+        bodies: nextBodies,
+        authoritativeBodyProxies: normalized.authoritativeBodyProxies,
+    };
+    internalPhysicsWorldByCosmeticWorld.set(nextWorld, stepped.world);
+    return {
+        world: nextWorld,
+        contacts: stepped.contacts.filter((contact) => cosmeticBodyIds.has(contact.a) || cosmeticBodyIds.has(contact.b)),
+        broadphasePairs: stepped.broadphasePairs,
+        narrowphaseContacts: stepped.narrowphaseContacts,
+        solverCorrections: stepped.solverCorrections,
+    };
+}
+function normalizeCosmeticBodies(bodies, authoritativeBodyProxies) {
+    for (const body of bodies) {
+        if (body.kind !== 'dynamic') {
+            throw new Error(`Cosmetic physics body ${body.id} must be dynamic`);
+        }
+    }
+    for (const proxy of authoritativeBodyProxies) {
+        if (proxy.kind !== 'static' && proxy.kind !== 'kinematic') {
+            throw new Error(`Authoritative cosmetic physics proxy ${proxy.id} must be static or kinematic`);
+        }
+    }
+    const normalized = (0, physics3d_js_1.createDeterministicPhysicsWorld3D)([
+        ...authoritativeBodyProxies,
+        ...bodies,
+    ]);
+    return {
+        allBodies: normalized.bodies,
+        bodies: normalized.bodies.filter((body) => body.kind === 'dynamic'),
+        authoritativeBodyProxies: normalized.bodies.filter((body) => body.kind === 'static' || body.kind === 'kinematic'),
+    };
+}
+function createSimulationWorld(normalized, previous) {
+    const base = {
+        frame: 0,
+        bodies: normalized.allBodies,
+        activePairs: [],
+        activePairMetadata: [],
+        contactCache: [],
+        jointCache: [],
+    };
+    if (previous === undefined) {
+        return base;
+    }
+    const bodyIds = new Set(base.bodies.map((body) => body.id));
+    // Keep removed endpoints in the previous-pair history so the solver can
+    // emit their exit event; missing bodies are safe here because event masks
+    // default to enabled and the warm cache below only keeps live pairs.
+    const activePairMetadata = previous.activePairMetadata;
+    const livePairIds = new Set(activePairMetadata
+        .filter((pair) => bodyIds.has(pair.a) && bodyIds.has(pair.b))
+        .map((pair) => pair.pair));
+    return {
+        ...base,
+        activePairs: previous.activePairs,
+        activePairMetadata,
+        contactCache: previous.contactCache.filter((entry) => livePairIds.has(entry.pair)),
+    };
+}
+function movedAuthoritativeBodyProxyIds(previous, current) {
+    const previousById = new Map((previous?.bodies ?? [])
+        .filter((body) => body.kind === 'static' || body.kind === 'kinematic')
+        .map((body) => [body.id, body]));
+    const currentById = new Map(current.map((proxy) => [proxy.id, proxy]));
+    const moved = new Set();
+    for (const id of new Set([...previousById.keys(), ...currentById.keys()])) {
+        const prior = previousById.get(id);
+        const next = currentById.get(id);
+        if (prior === undefined || next === undefined || !sameBodyPose(prior, next)) {
+            moved.add(id);
+        }
+    }
+    return moved;
+}
+function sameBodyPose(left, right) {
+    return left.x === right.x
+        && left.y === right.y
+        && left.z === right.z
+        && left.rx === right.rx
+        && left.ry === right.ry
+        && left.rz === right.rz
+        && sameOrientation(left.orientation, right.orientation);
+}
+function sameOrientation(left, right) {
+    if (left === undefined || right === undefined) {
+        return left === right;
+    }
+    return left.x === right.x
+        && left.y === right.y
+        && left.z === right.z
+        && left.w === right.w;
+}
+function wakeSleepingCosmeticBodies(world, previous, movedProxyIds) {
+    if (movedProxyIds.size === 0) {
+        return world;
+    }
+    const dynamicBodyIds = new Set(world.bodies.filter((body) => body.kind === 'dynamic').map((body) => body.id));
+    const dynamicContactGraph = new Map();
+    const directlySupportedIds = new Set();
+    const contacts = [
+        ...(0, physics3d_js_1.contactDetailsDeterministicPhysics3D)(world),
+        ...(previous?.activePairMetadata ?? []),
+    ];
+    for (const contact of contacts) {
+        if (contact.trigger || contact.sensor) {
+            continue;
+        }
+        const leftDynamic = dynamicBodyIds.has(contact.a);
+        const rightDynamic = dynamicBodyIds.has(contact.b);
+        if (movedProxyIds.has(contact.a) && rightDynamic) {
+            directlySupportedIds.add(contact.b);
+        }
+        if (movedProxyIds.has(contact.b) && leftDynamic) {
+            directlySupportedIds.add(contact.a);
+        }
+        if (!leftDynamic || !rightDynamic) {
+            continue;
+        }
+        const leftNeighbors = dynamicContactGraph.get(contact.a) ?? new Set();
+        leftNeighbors.add(contact.b);
+        dynamicContactGraph.set(contact.a, leftNeighbors);
+        const rightNeighbors = dynamicContactGraph.get(contact.b) ?? new Set();
+        rightNeighbors.add(contact.a);
+        dynamicContactGraph.set(contact.b, rightNeighbors);
+    }
+    const wakeIds = new Set(directlySupportedIds);
+    const pending = [...directlySupportedIds];
+    for (let index = 0; index < pending.length; index += 1) {
+        const bodyId = pending[index];
+        for (const neighbor of dynamicContactGraph.get(bodyId) ?? []) {
+            if (wakeIds.has(neighbor)) {
+                continue;
+            }
+            wakeIds.add(neighbor);
+            pending.push(neighbor);
+        }
+    }
+    let wokeBody = false;
+    const bodies = world.bodies.map((body) => {
+        if (body.kind !== 'dynamic' || body.sleeping !== true || !wakeIds.has(body.id)) {
+            return body;
+        }
+        wokeBody = true;
+        return { ...body, sleeping: false, lowVelFrames: 0 };
+    });
+    return wokeBody ? { ...world, bodies } : world;
+}

package/dist/cjs/creator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runSyncplaySynctest = exports.createSyncplayGameRuntime = exports.createSyncplayOfflineRuntime = exports.createSchemaArtifacts = exports.defineSyncplayGame = exports.verifyReplayWithDescriptor = exports.verifyReplay = exports.exportPromotionSnapshot = exports.createSessionFromPromotionSnapshot = exports.createPauseController = exports.createOfflineSession = exports.runInstantReplay = exports.createInstantReplayRunner = exports.createDeterministicCommandTimeline = exports.defaultChecksum = exports.canonicalStringify = exports.canonicalize = void 0;
+exports.stepDeterministicVehicle3D = exports.cookDeterministicVoxelChunkCollider3D = 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.applyDeterministicWorldEdit3D = exports.applyDeterministicImpulses3D = exports.applyDeterministicImpulse3D = exports.runSyncplaySynctest = exports.createSyncplayGameRuntime = exports.createSyncplayOfflineRuntime = exports.createSchemaArtifacts = exports.defineSyncplayGame = exports.verifyReplayWithDescriptor = exports.verifyReplay = exports.exportPromotionSnapshot = exports.createSessionFromPromotionSnapshot = exports.createPauseController = exports.createOfflineSession = exports.runInstantReplay = exports.createInstantReplayRunner = exports.createDeterministicCommandTimeline = exports.defaultChecksum = exports.canonicalStringify = exports.canonicalize = void 0;
 var canonical_js_1 = require("./canonical.js");
 Object.defineProperty(exports, "canonicalize", { enumerable: true, get: function () { return canonical_js_1.canonicalize; } });
 Object.defineProperty(exports, "canonicalStringify", { enumerable: true, get: function () { return canonical_js_1.canonicalStringify; } });
@@ -29,3 +29,28 @@ Object.defineProperty(exports, "createSyncplayOfflineRuntime", { enumerable: tru
 Object.defineProperty(exports, "createSyncplayGameRuntime", { enumerable: true, get: function () { return sdk_offline_js_1.createSyncplayOfflineRuntime; } });
 var synctest_js_1 = require("./synctest.js");
 Object.defineProperty(exports, "runSyncplaySynctest", { enumerable: true, get: function () { return synctest_js_1.runSyncplaySynctest; } });
+// Deterministic 3D physics is supported creator/H5 surface. Curated: world
+// 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.
+var physics3d_js_1 = require("./physics3d.js");
+Object.defineProperty(exports, "applyDeterministicImpulse3D", { enumerable: true, get: function () { return physics3d_js_1.applyDeterministicImpulse3D; } });
+Object.defineProperty(exports, "applyDeterministicImpulses3D", { enumerable: true, get: function () { return physics3d_js_1.applyDeterministicImpulses3D; } });
+Object.defineProperty(exports, "applyDeterministicWorldEdit3D", { enumerable: true, get: function () { return physics3d_js_1.applyDeterministicWorldEdit3D; } });
+Object.defineProperty(exports, "contactDetailsDeterministicPhysics3D", { enumerable: true, get: function () { return physics3d_js_1.contactDetailsDeterministicPhysics3D; } });
+Object.defineProperty(exports, "createDeterministicPhysicsWorld3D", { enumerable: true, get: function () { return physics3d_js_1.createDeterministicPhysicsWorld3D; } });
+Object.defineProperty(exports, "deriveInverseInertia", { enumerable: true, get: function () { return physics3d_js_1.deriveInverseInertia; } });
+Object.defineProperty(exports, "deterministicPhysicsBodyById3D", { enumerable: true, get: function () { return physics3d_js_1.deterministicPhysicsBodyById3D; } });
+Object.defineProperty(exports, "deterministicPhysicsCallback3D", { enumerable: true, get: function () { return physics3d_js_1.deterministicPhysicsCallback3D; } });
+Object.defineProperty(exports, "overlapDeterministicPhysics3D", { enumerable: true, get: function () { return physics3d_js_1.overlapDeterministicPhysics3D; } });
+Object.defineProperty(exports, "raycastDeterministicPhysics3D", { enumerable: true, get: function () { return physics3d_js_1.raycastDeterministicPhysics3D; } });
+Object.defineProperty(exports, "raycastDeterministicPhysics3DDetailed", { enumerable: true, get: function () { return physics3d_js_1.raycastDeterministicPhysics3DDetailed; } });
+Object.defineProperty(exports, "runDeterministicPhysics3DStress", { enumerable: true, get: function () { return physics3d_js_1.runDeterministicPhysics3DStress; } });
+Object.defineProperty(exports, "setDeterministicBodyVelocity3D", { enumerable: true, get: function () { return physics3d_js_1.setDeterministicBodyVelocity3D; } });
+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_voxel_js_1 = require("./physics3d-voxel.js");
+Object.defineProperty(exports, "cookDeterministicVoxelChunkCollider3D", { enumerable: true, get: function () { return physics3d_voxel_js_1.cookDeterministicVoxelChunkCollider3D; } });
+var physics3d_vehicle_js_1 = require("./physics3d-vehicle.js");
+Object.defineProperty(exports, "stepDeterministicVehicle3D", { enumerable: true, get: function () { return physics3d_vehicle_js_1.stepDeterministicVehicle3D; } });

package/dist/cjs/engine-complete.js

@@ -1213,7 +1213,10 @@ function createComponentReplayBundle() {
     });
 }
 function physicsCategory(bodies, requestedFrames, executedFrames, enforceThresholds, benchmark, noFastStress) {
-    const metrics = (0, physics3d_js_1.runDeterministicPhysics3DStress)(bodies, executedFrames, { allowFastStress: !noFastStress });
+    const metrics = (0, physics3d_js_1.runDeterministicPhysics3DStress)(bodies, executedFrames, {
+        allowFastStress: !noFastStress,
+        now: engineCompleteNowMs,
+    });
     const callbackMasks = (0, physics3d_js_1.runDeterministicPhysics3DCallbackMaskFixture)();
     const queryOptions = (0, physics3d_js_1.runDeterministicPhysics3DQueryOptionsFixture)();
     const materials = (0, physics3d_js_1.runDeterministicPhysics3DMaterialFixture)();
@@ -1228,8 +1231,8 @@ function physicsCategory(bodies, requestedFrames, executedFrames, enforceThresho
     // the per-frame mean budget; short ad-hoc runs skip it (gates default true).
     const rigidPile = benchmark && requestedFrames >= 2000 ? runPhysics3DRigidPileMeasurementFixture(128, 200) : undefined;
     const vehicleFleet = benchmark && requestedFrames >= 2000 ? runVehicle3DFleetMeasurementFixture(16, 200) : undefined;
-    const highBodySample512 = requestedFrames > 512 ? (0, physics3d_js_1.runDeterministicPhysics3DStress)(512, 128) : undefined;
-    const highBodySample2048 = requestedFrames > 512 ? (0, physics3d_js_1.runDeterministicPhysics3DStress)(2048, 32) : undefined;
+    const highBodySample512 = requestedFrames > 512 ? (0, physics3d_js_1.runDeterministicPhysics3DStress)(512, 128, { now: engineCompleteNowMs }) : undefined;
+    const highBodySample2048 = requestedFrames > 512 ? (0, physics3d_js_1.runDeterministicPhysics3DStress)(2048, 32, { now: engineCompleteNowMs }) : undefined;
     return categoryReport('physics3d', (0, canonical_js_1.defaultChecksum)({
         stress: metrics.checksum,
         materials: materials.checksum,
@@ -1276,10 +1279,7 @@ function physicsCategory(bodies, requestedFrames, executedFrames, enforceThresho
             && stack.settledDynamicBodies === stack.stackLayers,
         stackRollbackEquivalent: stack.rollbackEquivalent,
         stackAuthoringOrderStable: stack.stableUnderAuthoringOrderPermutation,
-        // Rigid-solver material response (impulse-based) — combine semantics unchanged
-        // (floor-average friction, max restitution); the bounce/friction velocity
-        // magnitudes come from the sequential-impulse solver, not the legacy pusher.
-        materialResponseCovered: materials.combinedFriction === 3
+        materialResponseCovered: Math.abs(materials.combinedFriction - 0.28284271) < 1e-6
             && materials.combinedRestitution === 7
             && materials.normalVelocityAfterBounce > 0
             && materials.tangentVelocityAfterFrictionY < 10
@@ -1347,7 +1347,9 @@ function physicsCategory(bodies, requestedFrames, executedFrames, enforceThresho
             ? metrics.fullPhysicsStepFrames === metrics.frames && metrics.optimizedStressFrames === 0 && metrics.extrapolatedStress === false
             : true,
         optimizedStressFramesDeclared: metrics.optimizedStressFrames === Math.max(0, metrics.frames - metrics.fullPhysicsStepFrames),
-        measuredP99WithinThreshold: enforceThresholds ? metrics.p99StepMs < 25 : true,
+        // A missing p99StepMs means the stress ran untimed — fail loud rather than
+        // pass a threshold gate that measured nothing.
+        measuredP99WithinThreshold: enforceThresholds ? (metrics.p99StepMs ?? Number.POSITIVE_INFINITY) < 25 : true,
         physicsStressProofMode: metrics.extrapolatedStress ? 'optimized-tail' : 'full-step',
     }, withFrameMetrics({
         ...metrics,

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

@@ -625,11 +625,18 @@ const engineParityMatrixEntries = [
             'packages/syncplay/src/physics3d-solver.ts',
             'packages/syncplay/src/physics3d-toi.ts',
             'packages/syncplay/src/physics3d-joints.ts',
+            'packages/syncplay/src/physics3d-mass.ts',
+            'packages/syncplay/src/physics3d-heightfield.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/physics3d-mass.test.ts',
+            'packages/syncplay/tests/physics3d-materials.test.ts',
+            'packages/syncplay/tests/physics3d-heightfield.test.ts',
+            'packages/syncplay/tests/physics3d-rotation-convention.test.ts',
+            'packages/syncplay/tests/physics3d-mesh-onesided.test.ts',
             'packages/syncplay/tests/engine-complete.test.ts',
             'packages/syncplay/src/physics3d-vehicle.ts',
             'packages/syncplay/tests/physics3d-vehicle.test.ts',
@@ -640,16 +647,17 @@ const engineParityMatrixEntries = [
             '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',
+            '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 against convex shapes and culled heightfield cell triangles; it is advanced there and the impact resolved as a perfectly-inelastic collision with momentum transfer and a TOI position clamp. physics3d-ccd.test.ts and physics3d-heightfield.test.ts cover finite-at-vx60, heightfield-cliff no-tunnel, rollback, and 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',
+            'builtin-rigid@2 certifies true hull/compound inertia and center-of-mass integration, geometric-mean friction, rolling resistance, static heightfields with CCD/query parity, and active spherical motor/orientation-spring rows',
             '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',
+            'one-sided mesh and heightfield contacts resolve penetration for zero-radius shapes while rejecting genuine back-face approaches; a shallow solver-creep recovery band keeps boxes/hulls resting without ejecting bodies from below',
             '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: [
@@ -663,6 +671,7 @@ const engineParityMatrixEntries = [
         gaps: [
             '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).',
+            'Dynamic ccd sweeps box, sphere, capsule, hull, and heightfield targets; triangle-soup mesh and compound targets remain discrete-only.',
             '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: [

package/dist/cjs/engine-parity.js

@@ -767,7 +767,7 @@ function runPhysicsCategory(config) {
             && physics3DQueries.overlapCovered
             && physics3DQueries.shapeCastCovered,
         physics3DMaterialResponse: physics3DMaterials.rollbackEquivalent
-            && physics3DMaterials.combinedFriction === 3
+            && Math.abs(physics3DMaterials.combinedFriction - 0.28284271) < 1e-6
             && physics3DMaterials.combinedRestitution === 7
             && physics3DMaterials.normalVelocityAfterBounce < 0,
         physics3DDetailedQueriesAndContacts: physics3DDetails.rollbackEquivalent
@@ -891,8 +891,11 @@ function runPhysicsCategory(config) {
         physics3DStressScheduledPostQueries: physics3DStress.scheduledPostPhysicsQueries,
         physics3DStressScheduledShapeCasts: physics3DStress.scheduledShapeCastQueries,
         physics3DStressScheduledResults: physics3DStress.scheduledQueryResultCount,
-        physics3DStressP95StepMs: physics3DStress.p95StepMs,
-        physics3DStressP99StepMs: physics3DStress.p99StepMs,
+        // Synthetic deterministic score, never wall clock: this metrics object is
+        // checksummed and compared across runtimes, so a real timing would make
+        // parity drift run to run.
+        physics3DStressP95StepCost: physics3DStress.p95StepCost,
+        physics3DStressP99StepCost: physics3DStress.p99StepCost,
         physics3DStressAngularBodies: physics3DStress.angularBodies,
         physics3DStressMeshStaticColliders: physics3DStress.meshStaticColliders,
         physics3DStressExactMeshRaycasts: physics3DStress.exactMeshRaycasts,

package/dist/cjs/index.js

@@ -4,8 +4,9 @@ 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.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;
+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.stepDeterministicCosmeticPhysicsWorld3D = exports.setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D = exports.createDeterministicCosmeticPhysicsWorld3D = exports.runDeterministicPhysics3DDestructionCert = exports.cookDeterministicVoxelChunkCollider3D = 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.applyDeterministicWorldEdit3D = exports.applyDeterministicImpulses3D = exports.applyDeterministicImpulse3D = exports.stepDeterministicPhysicsWorld2D = exports.raycastDeterministicPhysics2D = exports.raycastAllDeterministicPhysics2D = void 0;
+exports.isSyncplaySecretCommand = exports.decodeSyncplaySecretPrivateMessage = exports.validateSyncplaySecretSystemsConfig = exports.syncplaySecretLimits = exports.syncplaySecretConfigHash = 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 = exports.diffDeterministicReports = exports.createProtocolRollbackReport = exports.verifyScoredReplay = exports.stableFrameDumpJson = exports.stableFrameDiffJson = exports.inspectReplayFrameWithDescriptor = void 0;
+exports.createSyncplaySecretsClient = exports.createSyncplaySecretEventReader = exports.createSyncplaySecretAuthority = exports.verifySyncplaySignedReceipt = exports.createBrowserSyncplaySecretCrypto = exports.syncplaySecretProtocol = 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; } });
@@ -194,6 +195,7 @@ Object.defineProperty(exports, "stepDeterministicPhysicsWorld2D", { enumerable:
 var physics3d_js_1 = require("./physics3d.js");
 Object.defineProperty(exports, "applyDeterministicImpulse3D", { enumerable: true, get: function () { return physics3d_js_1.applyDeterministicImpulse3D; } });
 Object.defineProperty(exports, "applyDeterministicImpulses3D", { enumerable: true, get: function () { return physics3d_js_1.applyDeterministicImpulses3D; } });
+Object.defineProperty(exports, "applyDeterministicWorldEdit3D", { enumerable: true, get: function () { return physics3d_js_1.applyDeterministicWorldEdit3D; } });
 Object.defineProperty(exports, "contactDetailsDeterministicPhysics3D", { enumerable: true, get: function () { return physics3d_js_1.contactDetailsDeterministicPhysics3D; } });
 Object.defineProperty(exports, "createDeterministicPhysicsWorld3D", { enumerable: true, get: function () { return physics3d_js_1.createDeterministicPhysicsWorld3D; } });
 Object.defineProperty(exports, "deriveInverseInertia", { enumerable: true, get: function () { return physics3d_js_1.deriveInverseInertia; } });
@@ -207,6 +209,14 @@ 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_voxel_js_1 = require("./physics3d-voxel.js");
+Object.defineProperty(exports, "cookDeterministicVoxelChunkCollider3D", { enumerable: true, get: function () { return physics3d_voxel_js_1.cookDeterministicVoxelChunkCollider3D; } });
+var physics3d_destruction_cert_js_1 = require("./physics3d-destruction-cert.js");
+Object.defineProperty(exports, "runDeterministicPhysics3DDestructionCert", { enumerable: true, get: function () { return physics3d_destruction_cert_js_1.runDeterministicPhysics3DDestructionCert; } });
+var cosmetic_physics3d_js_1 = require("./cosmetic-physics3d.js");
+Object.defineProperty(exports, "createDeterministicCosmeticPhysicsWorld3D", { enumerable: true, get: function () { return cosmetic_physics3d_js_1.createDeterministicCosmeticPhysicsWorld3D; } });
+Object.defineProperty(exports, "setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D", { enumerable: true, get: function () { return cosmetic_physics3d_js_1.setDeterministicCosmeticPhysicsAuthoritativeBodyProxies3D; } });
+Object.defineProperty(exports, "stepDeterministicCosmeticPhysicsWorld3D", { enumerable: true, get: function () { return cosmetic_physics3d_js_1.stepDeterministicCosmeticPhysicsWorld3D; } });
 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; } });
@@ -300,3 +310,19 @@ Object.defineProperty(exports, "millisecondsToFrames", { enumerable: true, get:
 Object.defineProperty(exports, "popDueFrameEvents", { enumerable: true, get: function () { return timers_js_1.popDueFrameEvents; } });
 Object.defineProperty(exports, "scheduleFrameEvent", { enumerable: true, get: function () { return timers_js_1.scheduleFrameEvent; } });
 Object.defineProperty(exports, "tickCooldown", { enumerable: true, get: function () { return timers_js_1.tickCooldown; } });
+var secret_config_js_1 = require("./secret-config.js");
+Object.defineProperty(exports, "syncplaySecretConfigHash", { enumerable: true, get: function () { return secret_config_js_1.syncplaySecretConfigHash; } });
+Object.defineProperty(exports, "syncplaySecretLimits", { enumerable: true, get: function () { return secret_config_js_1.syncplaySecretLimits; } });
+Object.defineProperty(exports, "validateSyncplaySecretSystemsConfig", { enumerable: true, get: function () { return secret_config_js_1.validateSyncplaySecretSystemsConfig; } });
+var secret_protocol_js_1 = require("./secret-protocol.js");
+Object.defineProperty(exports, "decodeSyncplaySecretPrivateMessage", { enumerable: true, get: function () { return secret_protocol_js_1.decodeSyncplaySecretPrivateMessage; } });
+Object.defineProperty(exports, "isSyncplaySecretCommand", { enumerable: true, get: function () { return secret_protocol_js_1.isSyncplaySecretCommand; } });
+Object.defineProperty(exports, "syncplaySecretProtocol", { enumerable: true, get: function () { return secret_protocol_js_1.syncplaySecretProtocol; } });
+var secret_crypto_js_1 = require("./secret-crypto.js");
+Object.defineProperty(exports, "createBrowserSyncplaySecretCrypto", { enumerable: true, get: function () { return secret_crypto_js_1.createBrowserSyncplaySecretCrypto; } });
+Object.defineProperty(exports, "verifySyncplaySignedReceipt", { enumerable: true, get: function () { return secret_crypto_js_1.verifySyncplaySignedReceipt; } });
+var secret_authority_js_1 = require("./secret-authority.js");
+Object.defineProperty(exports, "createSyncplaySecretAuthority", { enumerable: true, get: function () { return secret_authority_js_1.createSyncplaySecretAuthority; } });
+var secret_client_js_1 = require("./secret-client.js");
+Object.defineProperty(exports, "createSyncplaySecretEventReader", { enumerable: true, get: function () { return secret_client_js_1.createSyncplaySecretEventReader; } });
+Object.defineProperty(exports, "createSyncplaySecretsClient", { enumerable: true, get: function () { return secret_client_js_1.createSyncplaySecretsClient; } });

package/dist/cjs/input-authority.js

@@ -10,6 +10,8 @@ function createInputAuthority(config) {
     const maxFutureTicks = config.maxFutureTicks ?? Number.POSITIVE_INFINITY;
     const retainedConfirmedFrames = config.retainedConfirmedFrames ?? 512;
     const pending = new Map();
+    const pendingCommands = new Map();
+    const occupiedSlotsByTick = new Map();
     const lastConfirmedInput = Array.from({ length: playerCount }, () => config.neutralInput);
     const retained = new Map();
     let confirmedThrough = -1;
@@ -22,7 +24,20 @@ function createInputAuthority(config) {
             const frame = frames[index];
             (0, errors_js_1.invariant)(Number.isInteger(frame.tick) && (index === 0 || frame.tick === frames[index - 1].tick + 1), 'restoreFrom frames must be tick-contiguous', 'input-authority.restore-gap');
             (0, errors_js_1.invariant)(frame.inputs.length === playerCount, 'restoreFrom frame inputs must cover every player slot', 'input-authority.restore-inputs');
-            retained.set(frame.tick, frame);
+            if (frame.occupiedSlots !== undefined) {
+                (0, errors_js_1.invariant)(frame.occupiedSlots.every((slot, slotIndex, slots) => (Number.isInteger(slot) &&
+                    slot >= 0 &&
+                    slot < playerCount &&
+                    (slotIndex === 0 || slots[slotIndex - 1] < slot))), 'restoreFrom occupied slots must be sorted unique valid slots', 'input-authority.restore-occupied-slots');
+                const checksumPayload = {
+                    tick: frame.tick,
+                    inputs: frame.inputs,
+                    occupiedSlots: frame.occupiedSlots,
+                    ...((frame.commands?.length ?? 0) === 0 ? {} : { commands: frame.commands }),
+                };
+                (0, errors_js_1.invariant)(frame.checksum === String((0, canonical_js_1.defaultChecksum)(checksumPayload)), 'restoreFrom occupied-slot checksum mismatch', 'input-authority.restore-occupied-checksum');
+            }
+            retained.set(frame.tick, (0, canonical_js_1.cloneCanonical)(frame));
         }
         (0, errors_js_1.invariant)(frames[frames.length - 1].tick === restoredThrough, 'restoreFrom frames must end at the restored frontier', 'input-authority.restore-frontier');
         earliestRetained = frames[0].tick;
@@ -75,11 +90,25 @@ function createInputAuthority(config) {
             }
         }
         pending.delete(tick);
+        const commands = (pendingCommands.get(tick) ?? [])
+            .map((command) => (0, canonical_js_1.cloneCanonical)(command))
+            .sort(compareAuthorityCommands);
+        pendingCommands.delete(tick);
+        const occupiedSlots = occupiedSlotsByTick.get(tick);
+        occupiedSlotsByTick.delete(tick);
+        const checksumPayload = {
+            tick,
+            inputs,
+            ...(occupiedSlots === undefined ? {} : { occupiedSlots }),
+            ...(commands.length === 0 ? {} : { commands }),
+        };
         const frame = {
             tick,
             inputs,
             substitutedSlots,
-            checksum: String((0, canonical_js_1.defaultChecksum)({ tick, inputs })),
+            ...(occupiedSlots === undefined ? {} : { occupiedSlots }),
+            ...(commands.length === 0 ? {} : { commands }),
+            checksum: String((0, canonical_js_1.defaultChecksum)(checksumPayload)),
         };
         retained.set(tick, frame);
         if (earliestRetained === -1) {
@@ -116,6 +145,22 @@ function createInputAuthority(config) {
             return confirmedThrough;
         },
         receiveInput,
+        recordOccupiedSlots(tick, slots) {
+            (0, errors_js_1.invariant)(Number.isInteger(tick) && tick >= 0, 'presence tick must be a non-negative integer', 'input-authority.presence-tick');
+            const sorted = [...slots].sort((a, b) => a - b);
+            (0, errors_js_1.invariant)(sorted.every((slot, index) => (Number.isInteger(slot) &&
+                slot >= 0 &&
+                slot < playerCount &&
+                (index === 0 || sorted[index - 1] !== slot))), 'occupied slots must be unique valid slots', 'input-authority.presence-slots');
+            occupiedSlotsByTick.set(tick, sorted);
+        },
+        queueCommand(tick, command) {
+            (0, errors_js_1.invariant)(Number.isInteger(tick) && tick >= 0, 'command tick must be a non-negative integer', 'input-authority.command-tick');
+            (0, errors_js_1.invariant)(tick > confirmedThrough, `command tick ${tick} is already confirmed`, 'input-authority.command-confirmed');
+            const commands = pendingCommands.get(tick) ?? [];
+            commands.push((0, canonical_js_1.cloneCanonical)(command));
+            pendingCommands.set(tick, commands);
+        },
         advance,
         get earliestRetainedTick() {
             return earliestRetained;
@@ -148,3 +193,22 @@ function createInputAuthority(config) {
         },
     };
 }
+function compareAuthorityCommands(left, right) {
+    const leftRecord = isCanonicalRecord(left) ? left : undefined;
+    const rightRecord = isCanonicalRecord(right) ? right : undefined;
+    const leftSystem = typeof leftRecord?.systemId === 'string' ? leftRecord.systemId : '';
+    const rightSystem = typeof rightRecord?.systemId === 'string' ? rightRecord.systemId : '';
+    const systemOrder = compareCanonicalText(leftSystem, rightSystem);
+    if (systemOrder !== 0)
+        return systemOrder;
+    const leftRequest = typeof leftRecord?.requestId === 'string' ? leftRecord.requestId : '';
+    const rightRequest = typeof rightRecord?.requestId === 'string' ? rightRecord.requestId : '';
+    const requestOrder = compareCanonicalText(leftRequest, rightRequest);
+    return requestOrder !== 0 ? requestOrder : compareCanonicalText((0, canonical_js_1.canonicalStringify)(left), (0, canonical_js_1.canonicalStringify)(right));
+}
+function compareCanonicalText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function isCanonicalRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}

package/dist/cjs/local-authority-server-runner.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCAL_AUTHORITY_SNAPSHOT_CHUNK_BYTES = void 0;
 exports.runDeterministicLocalAuthorityServerRunner = runDeterministicLocalAuthorityServerRunner;
 const node_http_1 = require("node:http");
 const canonical_js_1 = require("./canonical.js");
@@ -8,6 +9,7 @@ const commands_js_1 = require("./commands.js");
 const local_authority_wire_js_1 = require("./local-authority-wire.js");
 const lag_compensation3d_js_1 = require("./lag-compensation3d.js");
 const LOCAL_AUTHORITY_MAX_BODY_BYTES = 256 * 1024;
+exports.LOCAL_AUTHORITY_SNAPSHOT_CHUNK_BYTES = 32 * 1024;
 async function runDeterministicLocalAuthorityServerRunner(options = {}) {
     const players = options.players ?? 4;
     const seed = options.seed ?? 71;
@@ -550,7 +552,7 @@ async function driveAuthorityWireResync(baseUrl, runtime, players, seed, sequenc
         wireRequests += 1;
         wireSnapshotRequestEnvelopes += 1;
         wireAuthRejected += request.wire?.rejectionReasons.includes('missing-wire-auth') === true ? 1 : 0;
-        const transfer = (0, local_authority_wire_js_1.createDeterministicLocalAuthoritySnapshotTransfer)(runtime, identity, `runner-transfer-${seed}-${sequenceBase}`, 512);
+        const transfer = (0, local_authority_wire_js_1.createDeterministicLocalAuthoritySnapshotTransfer)(runtime, identity, `runner-transfer-${seed}-${sequenceBase}`, exports.LOCAL_AUTHORITY_SNAPSHOT_CHUNK_BYTES);
         const offer = await postWire(baseUrl, 0, (0, local_authority_wire_js_1.createDeterministicLocalAuthoritySnapshotOfferEnvelope)(sequence, transfer, authoritySign));
         sequence += 1;
         requests += 1;

package/dist/cjs/local-authority-wire.js

@@ -37,10 +37,12 @@ function encodeDeterministicLocalAuthorityWireEnvelope(envelope, sign) {
     };
     const auth = sign === undefined ? undefined : createDeterministicLocalAuthorityWireAuth(withoutChecksum, sign);
     const signedEnvelope = auth === undefined ? withoutChecksum : { ...withoutChecksum, auth };
-    return (0, canonical_js_1.canonicalStringify)({
+    const encoded = (0, canonical_js_1.canonicalStringify)({
         ...signedEnvelope,
         checksum: (0, canonical_js_1.defaultChecksum)(signedEnvelope),
     });
+    assertWireEnvelopeWithinBudget(envelope.kind, encoded);
+    return encoded;
 }
 function decodeDeterministicLocalAuthorityWireEnvelope(encoded) {
     // Bound parse cost BEFORE JSON.parse. The kind-specific budget is only known
@@ -1267,6 +1269,23 @@ const absoluteMaxWireEnvelopeBytes = 2_097_152;
 function maxWireEnvelopeBytes(kind) {
     return kind === 'input-bundle' || kind === 'command-bundle' ? 65_536 : 2_097_152;
 }
+// UTF-8 byte length is at most 3× the UTF-16 length, so every small envelope
+// (per-frame input/command bundles) skips the exact byte measurement.
+function assertWireEnvelopeWithinBudget(kind, encoded) {
+    const budget = maxWireEnvelopeBytes(kind);
+    if (encoded.length * 3 <= budget) {
+        return;
+    }
+    if (encoded.length > budget || (0, canonical_js_1.encodeUtf8)(encoded).byteLength > budget) {
+        throw new Error(wireEnvelopeBudgetError(kind, budget));
+    }
+}
+function wireEnvelopeBudgetError(kind, budget) {
+    if (kind === 'snapshot' || kind === 'correction') {
+        return `Wire ${kind} envelope exceeds the ${budget} byte monolithic budget. A state this large must ride the chunked snapshot-offer/chunk/complete transfer (createSnapshotTransferFromBytes + createDeterministicLocalAuthoritySnapshotOfferEnvelope), which carries snapshots up to the collector's maxSnapshotBytes (default 4194304).`;
+    }
+    return `Wire envelope exceeds ${budget} byte payload budget`;
+}
 function parseWireAuth(value) {
     if (!isRecord(value)) {
         throw new Error('Wire envelope auth must be an object');