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

package/README.md

@@ -21,6 +21,26 @@ changes validate uploaded deterministic room proof metadata and pass normalized
 proof into room startup; they do not add new matchmaking or client connection
 semantics.
 
+## State Ownership Contract
+
+`step` must not mutate the state object it receives or anything reachable from
+it. Copy every array, map, set, typed array, or object before modifying it.
+Sharing unmodified structure with the prior state is expected, and returning the
+same state unchanged is legal.
+
+Syncplay retains each returned state object in the snapshot ring by reference
+and hands it back on rollback without copying. This makes snapshot and restore
+O(1); violating the contract corrupts rollback history. Run
+`runSyncplaySynctest` in CI: its `aliasing`, `hydration`, and `codec` phases catch
+mutation, normalization-dependent behavior, and lossy codecs.
+
+For large, slowly changing state, keep an incremental running hash in immutable
+state and expose it through `config.checksum`. Recorded checksums can then be
+O(1) and interval-gated. Wire snapshots still serialize and checksum full state
+on demand; never treat `config.checksum` as the late-join checksum. See
+[`docs/syncplay-state-contract.md`](../../docs/syncplay-state-contract.md) for
+the worked pattern and validation-latency tradeoff.
+
 ## Testing
 
 `test:core` is the confidence surface. It runs the behavioral suites that pin
@@ -84,6 +104,14 @@ import { createDeterministicAuthorityServer } from '@series-inc/rundot-syncplay/
 import { rundotSyncplayPlugin } from '@series-inc/rundot-syncplay/tools';
 ```
 
+> The `@series-inc/rundot-syncplay/testing` entry (and its SDK mirror
+> `@series-inc/rundot-game-sdk/syncplay/testing`) exposes internal labs,
+> examples, fixtures, certification harnesses, and mocks for this repo's tests,
+> prototypes, and the syncplay CLI. It is **unsupported** — anything there may be
+> renamed or removed without notice, and it is deliberately excluded from the
+> export-surface goldens. Game code must import from the package root, `/browser`,
+> or `/creator` instead.
+
 The SDK bridge re-exports a browser-safe subset for games that already depend on
 `@series-inc/rundot-game-sdk`:
 
@@ -254,14 +282,57 @@ Implemented:
 - `lab:physics-cert` built-in fixed physics certification for fixed-arena and
   128-slot load shapes with snapshot/restore, stable collision/query ordering,
   and timing metrics.
+- `lab:physics-cert -- --engine builtin-rigid` certifies the 3D rigid-body
+  solver (settling stack + hinge motor + grab + speculative CCD arena) against
+  the same four determinism gates; the contact/joint caches round-trip through
+  the snapshot as canonical state.
 - `lab:physics-cert -- --engine rapier2d-compat` certification for
   `@dimforge/rapier2d-compat@0.19.3`; the current pinned cert reproduces
   snapshot/restore nondeterminism, so Rapier remains render/prototype-only for
   checksummed gameplay.
+- **Production-grade 3D rigid-body dynamics.** A warm-started sequential-impulse
+  solver (SAT + face-clipping manifolds → accumulated normal/friction impulses →
+  split-impulse position correction → island-based sleeping) delivers stable
+  stacking, full 6-DOF tumbling props, per-body axis locks (Box2D-class 2D games
+  on the 3D solver), impulse-based joints (`ball`, `hinge` with limits + motor,
+  `weld`, `distance`/rope, `spring` (soft point-to-point via
+  `frequencyHz`/`dampingRatio`, Box2D soft-constraint math), and the `grab`
+  gravity-gun/carry primitive),
+  speculative-contact CCD, and compound colliders. Opt-in per body via
+  `orientation`/`angularVel`/`mass`/`ccd`/locks; bodies without these solve as
+  rotation-locked rigid bodies through the same pipeline. New step options
+  `joints` and `velocityIterations`; mutation helpers
+  `applyDeterministicImpulse3D` / `setDeterministicBodyVelocity3D`; contact
+  events carry `normalImpulse`. The contact/joint caches live in the world and
+  are therefore checksummed and rollback-safe.
+- **Deterministic raycast-wheel vehicles.** `stepDeterministicVehicle3D` drives
+  a single dynamic chassis with N suspension raycasts (wheels are rays, not
+  bodies — Bullet/Godot raycast-vehicle lineage): spring-damper suspension,
+  friction-circle tire forces (drive/steer/brake from integer deci-unit input),
+  steering through the fixed-point `createDeterministicMath()` trig, and an
+  iterated Gauss-Seidel tire solve. The stateless controller returns quantized
+  impulses the game applies before the next physics step (the KCC pattern) —
+  use the batched `applyDeterministicImpulses3D` (one canonical-world rebuild
+  per frame; the per-impulse singular form costs an O(bodies) rebuild per
+  call); the checksum covers only load-bearing outputs
+  (impulses, grounded flags, compressions), never cosmetic telemetry. v1 targets
+  static ground with flat/axis-aligned contact normals; certified by the
+  required `physics-rigid-vehicle` fixture, a car in the `builtin-rigid` cert
+  arena, a rollback-every-frame synctest scene, and a 100%-coverage
+  `coverage:package:physics-vehicle` shard.
+- **Accelerated deterministic queries.** Raycast, overlap, and shape-cast run
+  through a per-world static AABB tree (BVH) built lazily on first query and
+  memoized by world identity — pure derived data that never enters canonical
+  state, with bit-identical results to a full scan (the tree only prunes;
+  narrow-phase tests and id-tiebroken ordering are unchanged, proven by a
+  merged-single-body-world oracle test). Query cost is flat in world size:
+  128 wheel-length raycasts cost ~0.2 ms whether the world holds 17 or 1,000
+  bodies (previously ~72 ms at 1,000).
 - Public deterministic 2D physics primitives for static/dynamic/kinematic AABB
   bodies, sensors/triggers, enter/stay/exit callbacks, layer masks,
-  deterministic AABB and ray queries, material response, simple fixed/distance/
-  spring/motor constraints, rollback-equivalent stepping, and budget metrics.
+  deterministic AABB and ray queries, material response (now including real
+  tangential friction), simple fixed/distance/spring/motor constraints,
+  rollback-equivalent stepping, and budget metrics.
 - Public deterministic movement primitives for KCC-like slopes, steps, ledges,
   moving platforms, elevators, one-way platforms, wall slides, jump buffering,
   coyote time, top-down acceleration/drag/sliding, nav steering, quantized FPS
@@ -648,9 +719,13 @@ materials, vectors, and interpolation floats stay outside replay checksums.
 - Built-in fixed physics certification includes package-local 2D/2.5D and 3D
   deterministic worlds with sensors/triggers, queries, layer masks, callbacks,
   constraints, CCD helpers, boxes, spheres, capsules, mesh static bounds,
-  deterministic angular state, and 128/512/2048-body stress samples. Remaining
-  limits are production-grade stacked rigid-body solving, visual collision
-  authoring/import, and replacing external physics engines; Rapier cert
-  currently fails with `knownIssueRapier910=reproduced`,
+  deterministic angular state, and 128/512/2048-body stress samples; the
+  `builtin-rigid` lane additionally certifies the sequential-impulse rigid-body
+  solver (stacking, joints, CCD) under the four determinism gates. Remaining
+  limits are visual collision authoring/import, convex-hull decomposition,
+  dynamic mesh-vs-mesh collision, ragdolls in checksummed state, and replacing
+  external physics engines; the ≤2 ms/step 128-body budget awaits an
+  allocation-free solver pass. Rapier cert currently fails with
+  `knownIssueRapier910=reproduced`,
   `uninterruptedChecksum=916fe725ae2e3215`, and
   `restoredChecksum=9e42622842bffff6`.

package/dist/browser.d.ts

@@ -1,60 +1,92 @@
-export { verifyReplay } from './replay.js';
-export { verifyReplayWithDescriptor as verifyDeterministicReplay } from './replay.js';
+export { cookDeterministicAnimation, createDeterministicAnimationRuntimeState, reconstructDeterministicAnimationEvents, stepDeterministicAnimation } from './animation.js';
+export { assertAssetManifestMatches, cookDeterministicAssets, materializeDeterministicMapEntities, materializePrototypeEntities, stableAssetCookJson, validatePrototypeEntitiesAgainstFrameRuntime } from './asset-cooking.js';
+export { createDeterministicAuthorityRoom } from './authority-room.js';
+export { compileDeterministicBotDocument, summarizeDeterministicBotDocumentTraceCounterDelta, summarizeDeterministicBotDocumentTraceCoverage, traceDeterministicBotDocument } from './bot-documents.js';
+export { cookDeterministicBotAsset, createDeterministicBotBlackboard, getBlackboardValue, runDeterministicBotSimulation, selectDeterministicUtility, tickDeterministicBehaviorTree, tickDeterministicBehaviorTreeWithMemory, tickDeterministicHfsm } from './bot-primitives.js';
+export { canonicalize, canonicalStringify, cloneCanonical, decodeCanonicalBytes, decodeCanonicalValue, decodeUtf8, defaultChecksum, encodeCanonicalBytes, encodeUtf8 } from './canonical.js';
+export { createStableIndexedMap, deterministicShuffle, stableEntries, stableSortedKeys } from './collections.js';
+export { aabbContainsPoint, aabbIntersects, circleIntersects, circleIntersectsAabb, closestPointOnSegment, fixedAabb, fixedCircle, fixedVec2, orientation, pointOnSegment, segmentPointDistance, segmentSegmentDistance, segmentsIntersect, sortAabbsByStableId, translateAabb } from './collision.js';
+export { assertDeterministicPayloadFields, createDeterministicCommandTimeline, createDeterministicCommandTimelineSnapshot, deterministicPayloadMatchesFields, evaluateDeterministicCommandTimelineMigrationResult } from './commands.js';
+export { cookDeterministicConfigBundle, evaluateDeterministicConfigBundleParityResult, summarizeDeterministicConfigBundleFailureReasons, verifyDeterministicConfigBundle } from './config-bundle.js';
+export { createDeterministicSessionCore, createDeterministicSessionReplayBundle, verifyDeterministicSessionRuntimeReplay } from './deterministic-session.js';
+export { createDeterministicEventEffectsAdapter } from './effects-adapter.js';
+export { assertDeterministicFrameHeapStaleHandleError, assertDeterministicFrameSystemsStateless, compileDeterministicDslRuntimeDescriptor, createDeterministicBitset, createDeterministicFrameRuntime, createDeterministicFrameRuntimeAccessors, createDeterministicSlotMap, createDeterministicSparseSetFrameRuntime, generateDeterministicFrameRuntimeSource, isDeterministicFrameHeapStaleHandleError, runDeterministicFrameRuntimeMutationCorpus, validateDeterministicFrameSystemsStateless } from './engine-runtime.js';
+export { createDeterministicEventTimeline, filterDeterministicEventsForPlayer } from './events.js';
+export { createInputAuthority } from './input-authority.js';
+export { accumulateDeterministicInputTimelineState, evaluateDeterministicInputTimelineResult, sortDeterministicInputTimelineFlags } from './input-timeline.js';
+export { createInstantReplayRunner, runInstantReplay } from './instant-replay.js';
+export { buildDeterministicLagCompensatedHitboxProxies3D, createDeterministicLagCompensation3DHistory, rewindDeterministicLagCompensatedTargets3D, validateDeterministicAuthoritativeLagCompensatedShot3D, validateDeterministicLagCompensatedShot3D } from './lag-compensation3d.js';
+export { createDeterministicLocalAuthorityRuntime } from './local-authority.js';
+export { applyDeterministicLocalAuthorityCommandBundleEnvelope, applyDeterministicLocalAuthorityInputBundleEnvelope, createDeterministicLocalAuthorityAckEnvelope, createDeterministicLocalAuthorityCommandBundleEnvelope, createDeterministicLocalAuthorityCorrectionEnvelope, createDeterministicLocalAuthorityInputBundleEnvelope, createDeterministicLocalAuthoritySnapshotChunkEnvelope, createDeterministicLocalAuthoritySnapshotCompleteEnvelope, createDeterministicLocalAuthoritySnapshotEnvelope, createDeterministicLocalAuthoritySnapshotOfferEnvelope, createDeterministicLocalAuthoritySnapshotRequestEnvelope, createDeterministicLocalAuthoritySnapshotTransfer, createDeterministicLocalAuthorityWireAuth, createDeterministicLocalAuthorityWireReceiver, decodeDeterministicLocalAuthorityWireEnvelope, deterministicLocalAuthorityWireProtocol, encodeDeterministicLocalAuthorityWireEnvelope } from './local-authority-wire.js';
+export { createDeterministicMath } from './math.js';
+export { rewindDeterministicTargets, runDeterministicMovementCrowdSimulation, runDeterministicMovementSimulation, stepDeterministicFpsAim, stepDeterministicKcc2D, stepDeterministicTopDownMover, validateDeterministicLagCompensatedHit } from './movement.js';
+export { stepDeterministicCarry3D, stepDeterministicKcc3D } from './movement3d.js';
+export { createSyncplayClient } from './multiplayer-service.js';
+export { applyDeterministicReciprocalAvoidance, cookDeterministicNavigationGraph, cookTilemapNavigationGraph, createDeterministicFlowField, findDeterministicPath, smoothDeterministicPath, stepDeterministicNavigationAgents } from './navigation.js';
+export { cookDeterministicNavmesh, cookImportedDeterministicNavmesh, findDeterministicNavmeshPath, findDeterministicNavmeshPointPath, locateDeterministicNavmeshPolygon, runDeterministicNavmeshStress, smoothDeterministicNavmeshPath, stepDeterministicNavmeshAgents, stepDeterministicNavmeshOffMeshTraversal } from './navmesh.js';
+export { createNetworkedSyncplayClient } from './networked-client.js';
+export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
 export { createOfflineSession } from './offline-session.js';
-export { createSyncplayOfflineRuntime } from './sdk-offline.js';
-export { createSyncplayOfflineRuntime as createSyncplayGameRuntime } from './sdk-offline.js';
+export { createPauseController } from './pause-resume.js';
+export { circleCastDeterministicPhysics2D, createDeterministicPhysicsWorld2D, nearestDeterministicPhysicsHit2D, queryDeterministicPhysicsAabb2D, queryDeterministicPhysicsShapeOverlap2D, raycastAllDeterministicPhysics2D, raycastDeterministicPhysics2D, stepDeterministicPhysicsWorld2D } from './physics2d.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
+export { stepDeterministicVehicle3D } from './physics3d-vehicle.js';
+export { createDeterministicR3fRenderAdapter as createDeterministicR3fAdapter, createDeterministicR3fRenderAdapter, interpolateDeterministicRenderNumber, interpolateDeterministicRenderVec2 } from './r3f-render-adapter.js';
+export { verifyReplayWithDescriptor as verifyDeterministicReplay, verifyReplay } from './replay.js';
+export { createDeterministicReplayBundle, createDeterministicReplayDebugTables, createDeterministicReplayRuntimeManifest, minimizeDeterministicReplayDesync, minimizeDeterministicReplayDesyncBundle, sliceDeterministicReplayBundle, verifyDeterministicFrameRuntimeReplayBundle, verifyDeterministicReplayBundle, verifyDeterministicSelfContainedFrameRuntimeReplayBundle, verifyReplayScoreAgainstTrustedRuntime } from './replay-bundle.js';
+export { defineSyncplayGame, stableDescriptorId } from './schema.js';
+export { createSchemaArtifacts } from './schema-artifacts.js';
+export { createDeterministicDescriptorBinarySchema, generateSchemaBinarySource, generateSchemaTypes, proveSchemaBinaryRoundTrip } from './schema-codegen.js';
+export { createDeterministicBinarySerializer, deterministicDslMaxPlayers, parseDeterministicSchemaDsl, stableDeterministicDslSchemaJson } from './schema-dsl-binary.js';
+export { createSyncplayOfflineRuntime as createSyncplayGameRuntime, createSyncplayOfflineRuntime } from './sdk-offline.js';
 export { createSyncplaySession } from './sdk-session.js';
-export type { SyncplaySession, SyncplaySessionConfig, SyncplaySessionMode, OpenRoomTransport } from './sdk-session.js';
-export { runNumberLab } from './number-lab.js';
-export { runDeterministicEngineCoreNumericProof } from './engine-core-proof.js';
-export { hydrateLabInput, labDefaultInput, labStep } from './sample-lab.js';
-export { createFixedArenaDescriptor, createInitialFixedArenaState, fixedArenaDefaultInput, fixedArenaStep, projectFixedArenaReferenceView, projectFixedArenaRenderState, runFixedArenaExample, } from './examples/fixed-arena.js';
-export { createDeterministicR3fRenderAdapter as createDeterministicR3fAdapter, createDeterministicR3fRenderAdapter, interpolateDeterministicRenderNumber, interpolateDeterministicRenderVec2, } from './r3f-render-adapter.js';
-export * from './animation.js';
-export * from './asset-cooking.js';
-export * from './bot-documents.js';
-export * from './bot-primitives.js';
-export * from './canonical.js';
-export * from './collections.js';
-export * from './commands.js';
-export * from './config-bundle.js';
-export * from './deterministic-session.js';
-export * from './effects-adapter.js';
-export * from './engine-runtime.js';
-export * from './events.js';
-export { deterministicButtonInitialState, runDeterministicButtonFixture, runDeterministicDescriptorButtonFixture, stepDeterministicButton, } from './input-button.js';
-export type { DeterministicButtonFixtureResult, DeterministicButtonState, DeterministicButtonStep, DeterministicDescriptorButtonFixtureResult, } from './input-button.js';
-export * from './input-timeline.js';
-export * from './instant-replay.js';
-export * from './pause-resume.js';
-export * from './session-promotion.js';
-export * from './lag-compensation3d.js';
-export * from './local-authority.js';
-export * from './local-authority-wire.js';
-export * from './input-authority.js';
-export * from './session-wire.js';
-export * from './session-snapshot.js';
-export * from './authority-room.js';
-export * from './networked-client.js';
-export * from './math.js';
-export { createSyncplayClient } from './multiplayer-service.js';
-export type { DeterministicAuthorityCertificationArtifact, DeterministicAuthorityCertificationVerification, DeterministicAuthorityChecksums, SyncplayClient, SyncplayClientConnection, SyncplayClientRole, SyncplayCommand, SyncplayCommandPollOptions, SyncplayCommandSubmitResult, SyncplayInput, SyncplayLifecycleResult, SyncplaySubmitResult, } from './multiplayer-service.js';
-export * from './movement.js';
-export * from './movement3d.js';
-export * from './navigation.js';
-export * from './navmesh.js';
-export * from './collision.js';
-export * from './noise.js';
-export * from './physics2d.js';
-export * from './physics3d.js';
-export * from './replay-bundle.js';
-export * from './schema.js';
-export * from './schema-artifacts.js';
-export * from './schema-codegen.js';
-export * from './schema-dsl-binary.js';
-export * from './signals.js';
-export * from './sparse-set.js';
-export * from './sample-scenes.js';
-export * from './system-lifecycle.js';
-export type { DeterministicEngineCoreNumericProof, DeterministicEngineCoreNumericProofOptions } from './engine-core-proof.js';
+export { createSessionFromPromotionSnapshot, exportPromotionSnapshot } from './session-promotion.js';
+export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot } from './session-snapshot.js';
+export { decodeDeterministicSessionMessage, deterministicSessionWireVersion, encodeDeterministicSessionMessage } from './session-wire.js';
+export { createDeterministicSignalBus } from './signals.js';
+export { createDeterministicSparseSet } from './sparse-set.js';
+export { createDeterministicLifecycleRunner, summarizeDeterministicLifecycleCounters } from './system-lifecycle.js';
+export type { CookedDeterministicAnimation, DeterministicAnimationClip, DeterministicAnimationDescriptor, DeterministicAnimationLayer, DeterministicAnimationRuntimeState, DeterministicAnimationState, DeterministicAnimationStepResult, DeterministicAnimationTrack, DeterministicAnimationTransition } from './animation.js';
+export type { DeterministicAssetCookManifest, DeterministicAssetCookResult, DeterministicAssetDependency, DeterministicAssetRecord, DeterministicAssetSource, DeterministicCookedAsset, DeterministicMapMaterializationResult, DeterministicPrototypeEntity, DeterministicPrototypeMaterializationOptions, DeterministicPrototypeRuntimeValidationResult } from './asset-cooking.js';
+export type { AuthorityRoomCatchUpEvent, AuthorityRoomClientNetStats, AuthorityRoomDesyncInfo, AuthorityRoomJoinResult, AuthorityRoomNetcodeStats, AuthorityRoomSnapshot, AuthorityRoomSnapshotEvent, AuthorityRoomStoredSnapshotMeta, AuthorityRoomTransport, DeterministicAuthorityRoom, DeterministicAuthorityRoomConfig, DeterministicAuthorityRoomRestoreState } from './authority-room.js';
+export type { CompiledDeterministicBotDocument, DeterministicBotDocument, DeterministicBotDocumentTrace, DeterministicBotDocumentTraceCounterDelta, DeterministicBotDocumentTraceCoverage } from './bot-documents.js';
+export type { CookedDeterministicBotAsset, DeterministicBehaviorTreeMemory, DeterministicBehaviorTreeNode, DeterministicBehaviorTreeService, DeterministicBehaviorTreeStatefulTick, DeterministicBehaviorTreeStatus, DeterministicBehaviorTreeTick, DeterministicBlackboardEntry, DeterministicBlackboardValue, DeterministicBotAssetSource, DeterministicBotBlackboard, DeterministicBotSimulationMetrics, DeterministicHfsmAgent, DeterministicHfsmDefinition, DeterministicHfsmState, DeterministicHfsmTransition, DeterministicUtilityConsideration, DeterministicUtilityCurve, DeterministicUtilityNestedConsideration, DeterministicUtilitySelection } from './bot-primitives.js';
+export type { CanonicalValue } from './canonical.js';
+export type { StableIndexedEntry } from './collections.js';
+export type { FixedAabb, FixedCircle, FixedVec2 } from './collision.js';
+export type { DeterministicCommandChannelDescriptor, DeterministicCommandProtocolMetrics, DeterministicCommandTimeline, DeterministicCommandTimelineConfig, DeterministicCommandTimelineMigrationMetrics, DeterministicCommandTimelineMigrationResultInput, DeterministicCommandTimelineSnapshot, DeterministicPayloadFieldDescriptor, DeterministicPayloadFieldKind, DeterministicPlayerCommand, DeterministicRejectedCommand, DeterministicReliableCommandDefaultsMetrics } from './commands.js';
+export type { CookedDeterministicConfigBundle, DeterministicConfigBundleFailureReasonInputs, DeterministicConfigBundleParityMetrics, DeterministicConfigBundleSource, DeterministicConfigBundleVerification, DeterministicConfigMigration } from './config-bundle.js';
+export type { DeterministicSessionCore, DeterministicSessionInput, DeterministicSessionInputFlag, DeterministicSessionLifecycleEvent, DeterministicSessionOptions, DeterministicSessionPlayer, DeterministicSessionReplayBundle, DeterministicSessionReplayVerification, DeterministicSessionSnapshot } from './deterministic-session.js';
+export type { DeterministicEffectDispatch, DeterministicEffectTarget, DeterministicEventEffectsAdapter, DeterministicEventEffectsAdapterConfig, DeterministicRenderSafeEffect } from './effects-adapter.js';
+export type { DeterministicCommandAccessor, DeterministicComponentAccessor, DeterministicComponentData, DeterministicComponentDescriptor, DeterministicComponentFieldDescriptor, DeterministicComponentFieldKind, DeterministicComponentFixedArrayFieldKind, DeterministicComponentFrameHeapFieldKind, DeterministicComponentScalarFieldKind, DeterministicDslRuntimeCompileOptions, DeterministicEntityRef, DeterministicEventAccessor, DeterministicFrameHeapCollectionKind, DeterministicFrameHeapCollectionSnapshot, DeterministicFrameHeapHandle, DeterministicFrameHeapSnapshot, DeterministicFrameQueryFilter, DeterministicFrameRuntime, DeterministicFrameRuntimeAccessors, DeterministicFrameRuntimeDescriptor, DeterministicFrameRuntimeOptions, DeterministicFrameSnapshot, DeterministicQueryRow, DeterministicRuntimeMessage, DeterministicRuntimePayloadDescriptor, DeterministicRuntimeSignalHandler, DeterministicSignalAccessor, DeterministicSingletonAccessor, DeterministicStatelessSystemDiagnostic, DeterministicStatelessSystemDiagnosticReason, DeterministicStatelessSystemValidationResult, DeterministicSystem, DeterministicSystemContext, DeterministicSystemDescriptor } from './engine-runtime.js';
+export type { DeterministicEventDeliveryScope, DeterministicEventEmitOptions, DeterministicEventPredictionState, DeterministicEventRecord, DeterministicEventTimeline } from './events.js';
+export type { ConfirmedInputFrame, EncodedInput, InputAuthority, InputAuthorityConfig, InputAuthorityRestoreState, InputAuthorityStats, InputRejectionReason, InputSubmissionResult } from './input-authority.js';
+export type { DeterministicInputTimelineAccumulatorState, DeterministicInputTimelineCorrection, DeterministicInputTimelineLane, DeterministicInputTimelineNegativeCases, DeterministicInputTimelineOptions, DeterministicInputTimelinePrediction, DeterministicInputTimelineReport, DeterministicInputTimelineRow, DeterministicInputTimelineVerification } from './input-timeline.js';
+export type { InstantReplayInputFrame, InstantReplayResult, InstantReplayRunner, InstantReplayRunnerOptions, InstantReplayRunOptions, RunInstantReplayOptions } from './instant-replay.js';
+export type { DeterministicAuthoritativeLagCompensation3DShotContext, DeterministicLagCompensatedPellet3DResult, DeterministicLagCompensatedShot3D, DeterministicLagCompensatedShot3DResult, DeterministicLagCompensatedTarget3D, DeterministicLagCompensation3DHistory, DeterministicLagCompensation3DHistoryOptions, DeterministicLagCompensation3DHistorySnapshot, DeterministicLagCompensation3DRewindSnapshot } from './lag-compensation3d.js';
+export type { DeterministicLocalAuthorityClient, DeterministicLocalAuthorityInputMessage, DeterministicLocalAuthorityResult, DeterministicLocalAuthorityRuntime, DeterministicLocalAuthorityRuntimeOptions, DeterministicLocalAuthorityRuntimeSnapshot, DeterministicLocalAuthorityState } from './local-authority.js';
+export type { DeterministicLocalAuthoritySnapshotIdentity, DeterministicLocalAuthoritySnapshotTransfer, DeterministicLocalAuthorityWireApplyResult, DeterministicLocalAuthorityWireAuth, DeterministicLocalAuthorityWireAuthOptions, DeterministicLocalAuthorityWireEnvelope, DeterministicLocalAuthorityWireKind, DeterministicLocalAuthorityWireReceiver, DeterministicLocalAuthorityWireReceiverOptions, DeterministicLocalAuthorityWireReceiverResult, DeterministicLocalAuthorityWireReceiverSnapshot, DeterministicLocalAuthorityWireSignOptions } from './local-authority-wire.js';
+export type { DeterministicFixedQuaternion, DeterministicFixedVec2, DeterministicFixedVec3, DeterministicMath } from './math.js';
+export type { DeterministicFpsAimState, DeterministicFpsInput, DeterministicKccBody, DeterministicKccInput, DeterministicKccStepResult, DeterministicLagCompensatedHitValidation, DeterministicLagCompensatedShot, DeterministicMovementCrowdMetrics, DeterministicMovementSimulationMetrics, DeterministicMovementStep, DeterministicMovementWorld, DeterministicMovingPlatform, DeterministicOneWayPlatform, DeterministicSlope, DeterministicTargetSnapshot, DeterministicTopDownBody, DeterministicTopDownBounds, DeterministicTopDownInput } from './movement.js';
+export type { DeterministicKccBody3D, DeterministicKccCarrierPose3D, DeterministicKccCarryResult3D, DeterministicKccCarryState3D, DeterministicKccCollisionCandidate3D, DeterministicKccCollisionFilter3D, DeterministicKccExternalImpulse3D, DeterministicKccGeometry3D, DeterministicKccInput3D, DeterministicKccPhysicsImpulse3D, DeterministicKccProcessor3D, DeterministicKccStepResult3D, DeterministicKccWorld3D, DeterministicMovingPlatform3D, DeterministicSlope3D, DeterministicStep3D } from './movement3d.js';
+export type { DeterministicAuthorityCertificationArtifact, DeterministicAuthorityCertificationVerification, DeterministicAuthorityChecksums, SyncplayClient, SyncplayClientConnection, SyncplayClientRole, SyncplayCommand, SyncplayCommandPollOptions, SyncplayCommandSubmitResult, SyncplayInput, SyncplayLifecycleResult, SyncplaySubmitResult } from './multiplayer-service.js';
+export type { CookedDeterministicNavigationGraph, DeterministicFlowField, DeterministicNavEdge, DeterministicNavigationAgent, DeterministicNavigationGraphSource, DeterministicNavigationStepOptions, DeterministicNavigationStepResult, DeterministicNavNode, DeterministicNavRegion, DeterministicPathQuery, DeterministicPathResult, DeterministicTilemapSource } from './navigation.js';
+export type { CookedDeterministicNavmesh, DeterministicNavmeshAgent, DeterministicNavmeshAgentStepResult, DeterministicNavmeshImportSource, DeterministicNavmeshLink, DeterministicNavmeshMovingAvoidanceObstacle, DeterministicNavmeshOffMeshTraversalState, DeterministicNavmeshOffMeshTraversalStep, DeterministicNavmeshPath, DeterministicNavmeshPoint, DeterministicNavmeshPolygon, DeterministicNavmeshSource } from './navmesh.js';
+export type { NetworkedClientTransport, NetworkedSyncplayClient, NetworkedSyncplayClientInputDelayOptions, NetworkedSyncplayClientNetStats, NetworkedSyncplayClientOptions, NetworkedSyncplayClientPacingOptions } from './networked-client.js';
+export type { DeterministicPauseController, DeterministicPauseState, DeterministicPauseStatus, PauseControllerOptions, PauseWrappedState } from './pause-resume.js';
+export type { DeterministicBodyKind, DeterministicContactEvent2D, DeterministicContactEventType, DeterministicPhysicsAabbQuery2D, DeterministicPhysicsActivePair2D, DeterministicPhysicsBody2D, DeterministicPhysicsCircleCastQuery2D, DeterministicPhysicsConstraint2D, DeterministicPhysicsHit2D, DeterministicPhysicsQueryOptions2D, DeterministicPhysicsRaycastQuery2D, DeterministicPhysicsShape2D, DeterministicPhysicsShapeOverlapQuery2D, DeterministicPhysicsStepOptions2D, DeterministicPhysicsStepResult2D, DeterministicPhysicsWorld2D } from './physics2d.js';
+export type { DeterministicContactCacheEntry3D, DeterministicJointCacheEntry3D, DeterministicPhysicsActivePair3D, DeterministicPhysicsAxisLock3D, DeterministicPhysicsBody3D, DeterministicPhysicsCallbackMask3D, DeterministicPhysicsCompoundChild3D, DeterministicPhysicsCompoundChildShape3D, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsHullShape3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D } from './physics3d.js';
+export type { DeterministicPhysicsJoint3D } from './physics3d-joints.js';
+export type { DeterministicVehicle3D, DeterministicVehicleImpulse3D, DeterministicVehicleInput3D, DeterministicVehicleStepOptions3D, DeterministicVehicleStepResult3D, DeterministicVehicleWheel3D, DeterministicVehicleWheelTelemetry3D } from './physics3d-vehicle.js';
+export type { DeterministicFrameRuntimeReplayBundleOptions, DeterministicFrameRuntimeReplayBundleVerification, DeterministicReplayBundle, DeterministicReplayBundleMismatch, DeterministicReplayBundleVerification, DeterministicReplayDebugTables, DeterministicReplayDesyncMinimization, DeterministicReplayRuntimeBeforeFrameId, DeterministicReplayRuntimeManifest, DeterministicReplayRuntimeManifestSource, DeterministicReplayRuntimeSystemId, DeterministicReplaySemanticModel, DeterministicReplaySemanticOperation, DeterministicReplaySliceOrigin, DeterministicReplaySnapshot, DeterministicReplayVerificationManifest, ReplayScoreVerificationReason, ReplayScoreVerificationResult } from './replay-bundle.js';
+export type { AssetDescriptor, CollectionOrdering, CommandChannelDescriptor, ConfigDescriptor, DeterministicGameDescriptor, EventDescriptor, InputFieldDescriptor, InputFieldPolicy, NumericMode, PrototypeDescriptor, SchemaFieldDescriptor, SchemaFieldKind, StateFieldDescriptor, SystemDescriptor, ValidatedDeterministicGameDescriptor } from './schema.js';
+export type { DeterministicSchemaArtifacts, SchemaFrameDump } from './schema-artifacts.js';
+export type { SchemaBinaryProof, SchemaBinarySourceOptions, SchemaTypesOptions } from './schema-codegen.js';
+export type { DeterministicBinarySerializer, DeterministicDslDeclaration, DeterministicDslDeclarationKind, DeterministicDslDictionaryEntry, DeterministicDslDictionaryFieldKind, DeterministicDslField, DeterministicDslFieldKind, DeterministicDslFixedArrayFieldKind, DeterministicDslListFieldKind, DeterministicDslScalarFieldKind, DeterministicDslScalarValue, DeterministicDslSchema, DeterministicDslSetFieldKind, DeterministicDslValue } from './schema-dsl-binary.js';
+export type { OpenRoomTransport, SyncplaySession, SyncplaySessionConfig, SyncplaySessionMode } from './sdk-session.js';
+export type { CollectedSnapshotTransfer, CreateSnapshotTransferOptions, DeterministicStateSnapshot, DeterministicStateSnapshotDecodeRejection, DeterministicStateSnapshotDecodeResult, SnapshotTransferCollector, SnapshotTransferCollectorOptions, SnapshotTransferCompleteResult, SnapshotTransferRejection, SnapshotTransferStepResult } from './session-snapshot.js';
+export type { DeterministicSessionDecodeRejection, DeterministicSessionDecodeResult, DeterministicSessionMessage, DeterministicSessionMessageKind, DeterministicSessionRole } from './session-wire.js';
+export type { DeterministicSignal, DeterministicSignalBus, DeterministicSignalBusSnapshot, DeterministicSignalSubscription } from './signals.js';
+export type { DeterministicSparseSet, DeterministicSparseSetSnapshot } from './sparse-set.js';
+export type { DeterministicLifecycleCounterSummary, DeterministicLifecycleRunner, DeterministicLifecycleSignal, DeterministicLifecycleSnapshot, DeterministicLifecycleSystemContext, DeterministicLifecycleSystemDescriptor, DeterministicLifecycleSystemHooks } from './system-lifecycle.js';
 export type { DeterministicStep, ReplayFile, ReplayVerificationResult } from './types.js';

package/dist/browser.js

@@ -1,55 +1,49 @@
-export { verifyReplay } from './replay.js';
-export { verifyReplayWithDescriptor as verifyDeterministicReplay } from './replay.js';
+// Curated public surface — every export here is supported API. Additions require regenerating tests/golden/export-surface.json.
+export { cookDeterministicAnimation, createDeterministicAnimationRuntimeState, reconstructDeterministicAnimationEvents, stepDeterministicAnimation } from './animation.js';
+export { assertAssetManifestMatches, cookDeterministicAssets, materializeDeterministicMapEntities, materializePrototypeEntities, stableAssetCookJson, validatePrototypeEntitiesAgainstFrameRuntime } from './asset-cooking.js';
+export { createDeterministicAuthorityRoom } from './authority-room.js';
+export { compileDeterministicBotDocument, summarizeDeterministicBotDocumentTraceCounterDelta, summarizeDeterministicBotDocumentTraceCoverage, traceDeterministicBotDocument } from './bot-documents.js';
+export { cookDeterministicBotAsset, createDeterministicBotBlackboard, getBlackboardValue, runDeterministicBotSimulation, selectDeterministicUtility, tickDeterministicBehaviorTree, tickDeterministicBehaviorTreeWithMemory, tickDeterministicHfsm } from './bot-primitives.js';
+export { canonicalize, canonicalStringify, cloneCanonical, decodeCanonicalBytes, decodeCanonicalValue, decodeUtf8, defaultChecksum, encodeCanonicalBytes, encodeUtf8 } from './canonical.js';
+export { createStableIndexedMap, deterministicShuffle, stableEntries, stableSortedKeys } from './collections.js';
+export { aabbContainsPoint, aabbIntersects, circleIntersects, circleIntersectsAabb, closestPointOnSegment, fixedAabb, fixedCircle, fixedVec2, orientation, pointOnSegment, segmentPointDistance, segmentSegmentDistance, segmentsIntersect, sortAabbsByStableId, translateAabb } from './collision.js';
+export { assertDeterministicPayloadFields, createDeterministicCommandTimeline, createDeterministicCommandTimelineSnapshot, deterministicPayloadMatchesFields, evaluateDeterministicCommandTimelineMigrationResult } from './commands.js';
+export { cookDeterministicConfigBundle, evaluateDeterministicConfigBundleParityResult, summarizeDeterministicConfigBundleFailureReasons, verifyDeterministicConfigBundle } from './config-bundle.js';
+export { createDeterministicSessionCore, createDeterministicSessionReplayBundle, verifyDeterministicSessionRuntimeReplay } from './deterministic-session.js';
+export { createDeterministicEventEffectsAdapter } from './effects-adapter.js';
+export { assertDeterministicFrameHeapStaleHandleError, assertDeterministicFrameSystemsStateless, compileDeterministicDslRuntimeDescriptor, createDeterministicBitset, createDeterministicFrameRuntime, createDeterministicFrameRuntimeAccessors, createDeterministicSlotMap, createDeterministicSparseSetFrameRuntime, generateDeterministicFrameRuntimeSource, isDeterministicFrameHeapStaleHandleError, runDeterministicFrameRuntimeMutationCorpus, validateDeterministicFrameSystemsStateless } from './engine-runtime.js';
+export { createDeterministicEventTimeline, filterDeterministicEventsForPlayer } from './events.js';
+export { createInputAuthority } from './input-authority.js';
+export { accumulateDeterministicInputTimelineState, evaluateDeterministicInputTimelineResult, sortDeterministicInputTimelineFlags } from './input-timeline.js';
+export { createInstantReplayRunner, runInstantReplay } from './instant-replay.js';
+export { buildDeterministicLagCompensatedHitboxProxies3D, createDeterministicLagCompensation3DHistory, rewindDeterministicLagCompensatedTargets3D, validateDeterministicAuthoritativeLagCompensatedShot3D, validateDeterministicLagCompensatedShot3D } from './lag-compensation3d.js';
+export { createDeterministicLocalAuthorityRuntime } from './local-authority.js';
+export { applyDeterministicLocalAuthorityCommandBundleEnvelope, applyDeterministicLocalAuthorityInputBundleEnvelope, createDeterministicLocalAuthorityAckEnvelope, createDeterministicLocalAuthorityCommandBundleEnvelope, createDeterministicLocalAuthorityCorrectionEnvelope, createDeterministicLocalAuthorityInputBundleEnvelope, createDeterministicLocalAuthoritySnapshotChunkEnvelope, createDeterministicLocalAuthoritySnapshotCompleteEnvelope, createDeterministicLocalAuthoritySnapshotEnvelope, createDeterministicLocalAuthoritySnapshotOfferEnvelope, createDeterministicLocalAuthoritySnapshotRequestEnvelope, createDeterministicLocalAuthoritySnapshotTransfer, createDeterministicLocalAuthorityWireAuth, createDeterministicLocalAuthorityWireReceiver, decodeDeterministicLocalAuthorityWireEnvelope, deterministicLocalAuthorityWireProtocol, encodeDeterministicLocalAuthorityWireEnvelope } from './local-authority-wire.js';
+export { createDeterministicMath } from './math.js';
+export { rewindDeterministicTargets, runDeterministicMovementCrowdSimulation, runDeterministicMovementSimulation, stepDeterministicFpsAim, stepDeterministicKcc2D, stepDeterministicTopDownMover, validateDeterministicLagCompensatedHit } from './movement.js';
+export { stepDeterministicCarry3D, stepDeterministicKcc3D } from './movement3d.js';
+export { createSyncplayClient } from './multiplayer-service.js';
+export { applyDeterministicReciprocalAvoidance, cookDeterministicNavigationGraph, cookTilemapNavigationGraph, createDeterministicFlowField, findDeterministicPath, smoothDeterministicPath, stepDeterministicNavigationAgents } from './navigation.js';
+export { cookDeterministicNavmesh, cookImportedDeterministicNavmesh, findDeterministicNavmeshPath, findDeterministicNavmeshPointPath, locateDeterministicNavmeshPolygon, runDeterministicNavmeshStress, smoothDeterministicNavmeshPath, stepDeterministicNavmeshAgents, stepDeterministicNavmeshOffMeshTraversal } from './navmesh.js';
+export { createNetworkedSyncplayClient } from './networked-client.js';
+export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
 export { createOfflineSession } from './offline-session.js';
-export { createSyncplayOfflineRuntime } from './sdk-offline.js';
-export { createSyncplayOfflineRuntime as createSyncplayGameRuntime } from './sdk-offline.js';
+export { createPauseController } from './pause-resume.js';
+export { circleCastDeterministicPhysics2D, createDeterministicPhysicsWorld2D, nearestDeterministicPhysicsHit2D, queryDeterministicPhysicsAabb2D, queryDeterministicPhysicsShapeOverlap2D, raycastAllDeterministicPhysics2D, raycastDeterministicPhysics2D, stepDeterministicPhysicsWorld2D } from './physics2d.js';
+export { applyDeterministicImpulse3D, applyDeterministicImpulses3D, contactDetailsDeterministicPhysics3D, createDeterministicPhysicsWorld3D, deriveInverseInertia, deterministicPhysicsBodyById3D, deterministicPhysicsCallback3D, overlapDeterministicPhysics3D, raycastDeterministicPhysics3D, raycastDeterministicPhysics3DDetailed, runDeterministicPhysics3DStress, setDeterministicBodyVelocity3D, shapeCastDeterministicPhysics3D, shapeCastDeterministicPhysics3DDetailed, stepDeterministicPhysicsWorld3D } from './physics3d.js';
+export { stepDeterministicVehicle3D } from './physics3d-vehicle.js';
+export { createDeterministicR3fRenderAdapter as createDeterministicR3fAdapter, createDeterministicR3fRenderAdapter, interpolateDeterministicRenderNumber, interpolateDeterministicRenderVec2 } from './r3f-render-adapter.js';
+export { verifyReplayWithDescriptor as verifyDeterministicReplay, verifyReplay } from './replay.js';
+export { createDeterministicReplayBundle, createDeterministicReplayDebugTables, createDeterministicReplayRuntimeManifest, minimizeDeterministicReplayDesync, minimizeDeterministicReplayDesyncBundle, sliceDeterministicReplayBundle, verifyDeterministicFrameRuntimeReplayBundle, verifyDeterministicReplayBundle, verifyDeterministicSelfContainedFrameRuntimeReplayBundle, verifyReplayScoreAgainstTrustedRuntime } from './replay-bundle.js';
+export { defineSyncplayGame, stableDescriptorId } from './schema.js';
+export { createSchemaArtifacts } from './schema-artifacts.js';
+export { createDeterministicDescriptorBinarySchema, generateSchemaBinarySource, generateSchemaTypes, proveSchemaBinaryRoundTrip } from './schema-codegen.js';
+export { createDeterministicBinarySerializer, deterministicDslMaxPlayers, parseDeterministicSchemaDsl, stableDeterministicDslSchemaJson } from './schema-dsl-binary.js';
+export { createSyncplayOfflineRuntime as createSyncplayGameRuntime, createSyncplayOfflineRuntime } from './sdk-offline.js';
 export { createSyncplaySession } from './sdk-session.js';
-export { runNumberLab } from './number-lab.js';
-export { runDeterministicEngineCoreNumericProof } from './engine-core-proof.js';
-export { hydrateLabInput, labDefaultInput, labStep } from './sample-lab.js';
-export { createFixedArenaDescriptor, createInitialFixedArenaState, fixedArenaDefaultInput, fixedArenaStep, projectFixedArenaReferenceView, projectFixedArenaRenderState, runFixedArenaExample, } from './examples/fixed-arena.js';
-export { createDeterministicR3fRenderAdapter as createDeterministicR3fAdapter, createDeterministicR3fRenderAdapter, interpolateDeterministicRenderNumber, interpolateDeterministicRenderVec2, } from './r3f-render-adapter.js';
-export * from './animation.js';
-export * from './asset-cooking.js';
-export * from './bot-documents.js';
-export * from './bot-primitives.js';
-export * from './canonical.js';
-export * from './collections.js';
-export * from './commands.js';
-export * from './config-bundle.js';
-export * from './deterministic-session.js';
-export * from './effects-adapter.js';
-export * from './engine-runtime.js';
-export * from './events.js';
-export { deterministicButtonInitialState, runDeterministicButtonFixture, runDeterministicDescriptorButtonFixture, stepDeterministicButton, } from './input-button.js';
-export * from './input-timeline.js';
-export * from './instant-replay.js';
-export * from './pause-resume.js';
-export * from './session-promotion.js';
-export * from './lag-compensation3d.js';
-export * from './local-authority.js';
-export * from './local-authority-wire.js';
-export * from './input-authority.js';
-export * from './session-wire.js';
-export * from './session-snapshot.js';
-export * from './authority-room.js';
-export * from './networked-client.js';
-export * from './math.js';
-export { createSyncplayClient } from './multiplayer-service.js';
-export * from './movement.js';
-export * from './movement3d.js';
-export * from './navigation.js';
-export * from './navmesh.js';
-export * from './collision.js';
-export * from './noise.js';
-export * from './physics2d.js';
-export * from './physics3d.js';
-export * from './replay-bundle.js';
-export * from './schema.js';
-export * from './schema-artifacts.js';
-export * from './schema-codegen.js';
-export * from './schema-dsl-binary.js';
-export * from './signals.js';
-export * from './sparse-set.js';
-export * from './sample-scenes.js';
-export * from './system-lifecycle.js';
+export { createSessionFromPromotionSnapshot, exportPromotionSnapshot } from './session-promotion.js';
+export { base64ToBytes, bytesToBase64, createSnapshotTransferCollector, createSnapshotTransferFromBytes, decodeDeterministicStateSnapshot, DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, deterministicRoomDescriptorHash, encodeDeterministicStateSnapshot } from './session-snapshot.js';
+export { decodeDeterministicSessionMessage, deterministicSessionWireVersion, encodeDeterministicSessionMessage } from './session-wire.js';
+export { createDeterministicSignalBus } from './signals.js';
+export { createDeterministicSparseSet } from './sparse-set.js';
+export { createDeterministicLifecycleRunner, summarizeDeterministicLifecycleCounters } from './system-lifecycle.js';

package/dist/certification.d.ts

@@ -1,6 +1,6 @@
 import { runPredictionCullingLab } from './prediction-culling.js';
 import { type ProtocolRollbackGame } from './protocol-lab.js';
-export type CertificationFixtureKind = 'event-callbacks' | 'bot-replacement' | 'ecs-lite' | 'external-physics-gate' | 'fixed-foundation' | 'genre-128' | 'kcc-lite' | 'navigation-grid' | 'netcode' | 'physics-builtin' | 'prediction-culling' | 'projectile-hitscan' | 'protocol-matrix' | 'reference-samples' | 'replay-node' | 'replay-browser' | 'schema-tooling' | 'static-analysis';
+export type CertificationFixtureKind = 'event-callbacks' | 'bot-replacement' | 'ecs-lite' | 'external-physics-gate' | 'fixed-foundation' | 'genre-128' | 'kcc-lite' | 'navigation-grid' | 'netcode' | 'physics-builtin' | 'physics-rigid-vehicle' | 'prediction-culling' | 'projectile-hitscan' | 'protocol-matrix' | 'reference-samples' | 'replay-node' | 'replay-browser' | 'schema-tooling' | 'static-analysis';
 export type CertificationRuntimeTarget = 'node' | 'chromium' | 'webkit';
 export type CertificationResult = 'pass' | 'fail' | 'skip';
 export type CertificationNetcodeShape = 'input-minimal' | 'moderate-state' | 'command-bursts';
@@ -22,7 +22,7 @@ export interface CertificationManifest {
     readonly fixtures?: readonly CertificationFixture[];
 }
 export type CertificationFixtureTier = 'required' | 'optional' | 'experimental' | 'optional-browser' | 'optional-integration' | 'stress';
-export type CertificationFixture = CertificationBotReplacementFixture | CertificationEcsLiteFixture | CertificationExternalPhysicsGateFixture | CertificationEventCallbacksFixture | CertificationFixedFoundationFixture | CertificationGenre128Fixture | CertificationKccLiteFixture | CertificationNavigationGridFixture | CertificationNetcodeFixture | CertificationPhysicsBuiltinFixture | CertificationPredictionCullingFixture | CertificationProjectileHitscanFixture | CertificationProtocolMatrixFixture | CertificationReferenceSamplesFixture | CertificationReplayNodeFixture | CertificationSchemaToolingFixture | CertificationStaticAnalysisFixture | CertificationBrowserReplayFixture;
+export type CertificationFixture = CertificationBotReplacementFixture | CertificationEcsLiteFixture | CertificationExternalPhysicsGateFixture | CertificationEventCallbacksFixture | CertificationFixedFoundationFixture | CertificationGenre128Fixture | CertificationKccLiteFixture | CertificationNavigationGridFixture | CertificationNetcodeFixture | CertificationPhysicsBuiltinFixture | CertificationPhysicsRigidVehicleFixture | CertificationPredictionCullingFixture | CertificationProjectileHitscanFixture | CertificationProtocolMatrixFixture | CertificationReferenceSamplesFixture | CertificationReplayNodeFixture | CertificationSchemaToolingFixture | CertificationStaticAnalysisFixture | CertificationBrowserReplayFixture;
 export interface CertificationFixtureBase {
     readonly fixtureId: string;
     readonly kind: CertificationFixtureKind;
@@ -66,6 +66,12 @@ export interface CertificationEventCallbacksFixture extends CertificationFixture
 export interface CertificationPhysicsBuiltinFixture extends CertificationFixtureBase {
     readonly kind: 'physics-builtin';
     readonly runtimeTarget?: 'node';
+    /** Physics engine lane to certify (defaults to the fixed-point circle lane). */
+    readonly engine?: 'builtin-fixed' | 'builtin-rigid';
+}
+export interface CertificationPhysicsRigidVehicleFixture extends CertificationFixtureBase {
+    readonly kind: 'physics-rigid-vehicle';
+    readonly runtimeTarget?: 'node';
 }
 export interface CertificationPredictionCullingFixture extends CertificationFixtureBase {
     readonly kind: 'prediction-culling';
@@ -142,7 +148,7 @@ export interface CertificationFixtureReport {
     readonly failures: readonly string[];
     readonly result: CertificationResult;
 }
-export type CertificationMetrics = CertificationBotReplacementMetrics | CertificationEcsLiteMetrics | CertificationExternalPhysicsGateMetrics | CertificationEventCallbacksMetrics | CertificationFixedFoundationMetrics | CertificationGenre128Metrics | CertificationKccLiteMetrics | CertificationNavigationGridMetrics | CertificationNetcodeMetrics | CertificationPhysicsBuiltinMetrics | CertificationPredictionCullingMetrics | CertificationProjectileHitscanMetrics | CertificationProtocolMatrixMetrics | CertificationReferenceSamplesMetrics | CertificationReplayNodeMetrics | CertificationSchemaToolingMetrics | CertificationStaticAnalysisMetrics | CertificationBrowserReplayMetrics;
+export type CertificationMetrics = CertificationBotReplacementMetrics | CertificationEcsLiteMetrics | CertificationExternalPhysicsGateMetrics | CertificationEventCallbacksMetrics | CertificationFixedFoundationMetrics | CertificationGenre128Metrics | CertificationKccLiteMetrics | CertificationNavigationGridMetrics | CertificationNetcodeMetrics | CertificationPhysicsBuiltinMetrics | CertificationPhysicsRigidVehicleMetrics | CertificationPredictionCullingMetrics | CertificationProjectileHitscanMetrics | CertificationProtocolMatrixMetrics | CertificationReferenceSamplesMetrics | CertificationReplayNodeMetrics | CertificationSchemaToolingMetrics | CertificationStaticAnalysisMetrics | CertificationBrowserReplayMetrics;
 export interface CertificationNetcodeMetrics {
     readonly shape: CertificationNetcodeShape;
     readonly game: ProtocolRollbackGame;
@@ -320,6 +326,17 @@ export interface CertificationKccLiteMetrics {
     readonly finalChecksum: string;
     readonly checksumConverged: boolean;
 }
+export interface CertificationPhysicsRigidVehicleMetrics {
+    readonly checksum: string;
+    readonly restoredChecksum: string;
+    readonly permutedChecksum: string;
+    readonly rollbackEquivalent: boolean;
+    readonly stableUnderAuthoringOrderPermutation: boolean;
+    readonly impulseSamples: number;
+    readonly groundedWheelSamples: number;
+    readonly impulsesQuantizedClean: boolean;
+    readonly checksumConverged: boolean;
+}
 export interface CertificationNavigationGridMetrics {
     readonly pathChecksum: string;
     readonly pathsFound: number;

package/dist/certification.js

@@ -5,6 +5,7 @@ import { createDeterministicEventTimeline } from './events.js';
 import { createDeterministicMath } from './math.js';
 import { valueNoise2D } from './noise.js';
 import { runPhysicsCert } from './physics-cert.js';
+import { runDeterministicVehicle3DFixture } from './physics3d-vehicle.js';
 import { runPredictionCullingLab } from './prediction-culling.js';
 import { runProtocolRollbackLab } from './protocol-lab.js';
 import { DeterministicRandom } from './random.js';
@@ -80,6 +81,60 @@ export function createDefaultCertificationManifest() {
                     requireChecksumConvergence: true,
                 },
             },
+            {
+                fixtureId: 'physics-rigid-stack',
+                kind: 'physics-builtin',
+                engine: 'builtin-rigid',
+                required: true,
+                runtimeTarget: 'node',
+                players: 4,
+                frames: 300,
+                seed: 7,
+                budgets: { requireChecksumConvergence: true },
+            },
+            {
+                fixtureId: 'physics-rigid-sleep',
+                kind: 'physics-builtin',
+                engine: 'builtin-rigid',
+                required: true,
+                runtimeTarget: 'node',
+                players: 2,
+                frames: 400,
+                seed: 3,
+                budgets: { requireChecksumConvergence: true },
+            },
+            {
+                fixtureId: 'physics-rigid-joints',
+                kind: 'physics-builtin',
+                engine: 'builtin-rigid',
+                required: true,
+                runtimeTarget: 'node',
+                players: 4,
+                frames: 200,
+                seed: 11,
+                budgets: { requireChecksumConvergence: true },
+            },
+            {
+                fixtureId: 'physics-rigid-ccd',
+                kind: 'physics-builtin',
+                engine: 'builtin-rigid',
+                required: true,
+                runtimeTarget: 'node',
+                players: 6,
+                frames: 120,
+                seed: 5,
+                budgets: { requireChecksumConvergence: true },
+            },
+            {
+                fixtureId: 'physics-rigid-vehicle',
+                kind: 'physics-rigid-vehicle',
+                required: true,
+                runtimeTarget: 'node',
+                players: 2,
+                frames: 120,
+                seed: 7,
+                budgets: { requireChecksumConvergence: true },
+            },
             {
                 fixtureId: 'prediction-culling',
                 kind: 'prediction-culling',
@@ -260,6 +315,9 @@ function runCertificationFixture(manifest, fixture) {
     if (fixture.kind === 'physics-builtin') {
         return runPhysicsBuiltinFixture(manifest, fixture);
     }
+    if (fixture.kind === 'physics-rigid-vehicle') {
+        return runPhysicsRigidVehicleFixture(manifest, fixture);
+    }
     if (fixture.kind === 'prediction-culling') {
         return runPredictionCullingFixture(manifest, fixture);
     }
@@ -479,12 +537,12 @@ function runEventCallbacksFixture(manifest, fixture) {
 }
 function runPhysicsBuiltinFixture(manifest, fixture) {
     const result = runPhysicsCert({
-        engine: 'builtin-fixed',
+        engine: fixture.engine ?? 'builtin-fixed',
         shape: 'fixed-arena',
         players: fixture.players,
         frames: fixture.frames,
         seed: fixture.seed,
-        snapshotEvery: 1,
+        snapshotEvery: fixture.engine === 'builtin-rigid' ? 8 : 1,
     });
     const metrics = {
         engine: result.engine,
@@ -500,6 +558,24 @@ function runPhysicsBuiltinFixture(manifest, fixture) {
     };
     return createFixtureReport(manifest, fixture, metrics, metrics.result);
 }
+function runPhysicsRigidVehicleFixture(manifest, fixture) {
+    const result = runDeterministicVehicle3DFixture(fixture.frames);
+    const metrics = {
+        checksum: result.checksum,
+        restoredChecksum: result.restoredChecksum,
+        permutedChecksum: result.permutedChecksum,
+        rollbackEquivalent: result.rollbackEquivalent,
+        stableUnderAuthoringOrderPermutation: result.stableUnderAuthoringOrderPermutation,
+        impulseSamples: result.impulseSamples,
+        groundedWheelSamples: result.groundedWheelSamples,
+        impulsesQuantizedClean: result.impulsesQuantizedClean,
+        checksumConverged: result.rollbackEquivalent
+            && result.stableUnderAuthoringOrderPermutation
+            && result.impulseSamples > 0
+            && result.impulsesQuantizedClean,
+    };
+    return createFixtureReport(manifest, fixture, metrics);
+}
 function runPredictionCullingFixture(manifest, fixture) {
     const passProfile = runPredictionCullingLab({
         mode: 'local-area',

package/dist/checksum-basis.d.ts

@@ -0,0 +1,4 @@
+import type { DeterministicSessionConfig } from './types.js';
+export declare function serializeStateWith<State, Input>(config: DeterministicSessionConfig<State, Input>, state: State): Uint8Array;
+export declare function deserializeStateWith<State, Input>(config: DeterministicSessionConfig<State, Input>, bytes: Uint8Array): State;
+export declare function computeWireStateChecksum<State, Input>(config: DeterministicSessionConfig<State, Input>, state: State): string;