@series-inc/rundot-syncplay 5.23.0-beta.7 → 5.23.0

package/README.md

@@ -45,11 +45,16 @@ creators. See `docs/syncplay-netcode-observability.md`,
 `docs/syncplay-replay-verified-leaderboards.md`, and
 `docs/syncplay-wire-format.md`.
 
-The deterministic deploy check (`project:deploy-check` /
-`project:deploy-check-verify`) is an internal-consistency **receipt** — it
-proves the bundle it describes is the bundle that was checked — not a
-cryptographic signature or provenance proof
-(see `.plans/deterministic-multiplayer-branch-cleanup.md`).
+Deployability is gated by build-time certification, not by stamped proof
+artifacts. The deployable preflight is `project:check` with the
+`static-determinism` section required — it proves the simulation is a real,
+file-backed, replayable module before upload. The optional deploy-check
+commands (`project:deploy-check` / `project:deploy-check-verify`) remain as a
+local, internal-consistency **receipt** — they prove the bundle they describe is
+the bundle that was checked — but they are **not** a cryptographic signature,
+provenance proof, or a backend admission gate. Venus upload validation and
+room-server startup accept a bare `deterministic: true` room and never read
+these artifacts.
 
 CI lanes:
 
@@ -79,6 +84,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`:
 
@@ -249,14 +262,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
@@ -268,6 +324,51 @@ Implemented:
   checksums, and CLI-certified mechanic invariants.
 - Counter Duel package-local example with replay verification and event output.
 
+## Deterministic Standard Library
+
+The determinism static checker blocks the entire transcendental family
+(`Math.sin/cos/tan/atan2/sqrt/hypot/pow/...`), `Math.random`, and `Date.now`
+inside simulation code — those can differ in low bits across JS engines and
+desync a lockstep match. Every simulation surface these primitives cover is
+provided as a pure-integer, byte-identical replacement. **Never hand-roll fixed
+math or reach for `Math.*`; use these.**
+
+`ctx.math` (`createDeterministicMath`, wired into every step context):
+
+- **Scalar:** `sqrt` (throws on negative), `abs`, `sign`, `min`, `max`, `lerp`,
+  `mod` (Euclidean; throws on modulus 0), `inverseLerp`, `remap`, `smoothstep`,
+  `exp`, `log`/`log2Fixed` (throw on non-positive). `exp`/`log` are ≤1% over
+  their fixed-representable range; `sqrt` is exact-to-a-unit.
+- **Trig & angles (unit is TURNS, one revolution == `fixedScale`):** accurate
+  `sinTurns`/`cosTurns` (5th-order minimax, exact at cardinal turns, ≤5e-3 sweep
+  error), `tanTurns`, `atan2(y, x)` → turns in `[0, fixedScale)` CCW from +x
+  (`atan2(0,0) === 0`), `wrapTurns`, `angleDeltaTurns` (shortest signed),
+  `turnsToRadians`/`radiansToTurns`. `createDeterministicMath` requires
+  `fixedScale % 4 === 0`.
+- **Vectors:** vec2 `sub/scale/dot/cross/lengthSq/length/distanceSq/distance/
+  normalize` (zero → `{0,0}`), `hypot`, `perp/negate/rotate/fromAngleTurns/
+  angleTurns`; vec3 core `add/sub/scale/dot/cross/lengthSq/length/distance/
+  normalize/lerp/negate`.
+- **Domains & overflow:** domain violations (`sqrt(neg)`, `log(≤0)`, `mod(_,0)`,
+  non-integer fixed inputs) fail fast. Vector/`abs`/`sign`/negation ops saturate
+  at `±maxFixed` rather than throw. `mul`/`div` are integer-exact only while
+  `|a·b| ≤ 2^53` (~95k real units at the default `fixedScale` 1000).
+
+`ctx.random` (`DeterministicRandom`) — seeded, reproducible sampling on top of
+the existing `nextInt/nextFixed/fork`: `nextBool`, `nextRangeFixed`,
+`nextAngleTurns`, `pickOne` (throws on empty), `weighted` (throws on length
+mismatch / non-positive total), `gaussian(math)` (Box-Muller).
+
+Segment geometry (imported from the package, like the AABB/circle primitives):
+`orientation`, `pointOnSegment`, `segmentsIntersect`, `closestPointOnSegment`,
+`segmentPointDistance`, `segmentSegmentDistance` (the distance/closest ops take a
+`DeterministicMath` for their `sqrt`).
+
+Hash & value noise (`noise.ts`, pure importable functions — replaces the
+cross-engine `Math.sin`-hash desync class): `hashUint32`, `hash2` (integer
+avalanche hashes), `valueNoise1D`/`valueNoise2D` (smooth, in `[-fixedScale,
+fixedScale]`), `fbm2D`.
+
 ## Commands
 
 ```bash
@@ -283,16 +384,12 @@ npm run project:release-verify -- ./deterministic-game/artifacts/deterministic/p
 npm run project:release-bundle -- ./deterministic-game/artifacts/deterministic/project-release-evidence.json --json ./deterministic-game/artifacts/deterministic/project-release-bundle.json
 npm run project:release-bundle-verify -- ./deterministic-game/artifacts/deterministic/project-release-bundle.json --out ./deterministic-game/artifacts/deterministic/project-release-bundle-verification.md --json ./deterministic-game/artifacts/deterministic/project-release-bundle-verification.json --junit ./deterministic-game/artifacts/deterministic/project-release-bundle-verification.xml
 npm run project:release-bundle-schema -- --json artifacts/reports/project-release-bundle-schema.json
-npm run project:deploy-check -- ./deterministic-game/syncplay.project.json --bundle ./deterministic-game/artifacts/deterministic/project-release-bundle.json --out ./deterministic-game/artifacts/deterministic/project-deploy-check.md --json ./deterministic-game/artifacts/deterministic/project-deploy-check.json --junit ./deterministic-game/artifacts/deterministic/project-deploy-check.xml
-npm run project:deploy-check-verify -- ./deterministic-game/artifacts/deterministic/project-deploy-check.json --out ./deterministic-game/artifacts/deterministic/project-deploy-check-verification.md --json ./deterministic-game/artifacts/deterministic/project-deploy-check-verification.json --junit ./deterministic-game/artifacts/deterministic/project-deploy-check-verification.xml
 npm run project:ci-workflow -- --out .github/workflows/syncplay-ci.yml --json artifacts/reports/project-ci-workflow.json
 npm run project:scaffold -- ./deterministic-h5 --name "H5 Arena" --template h5 --sdk-version ^0.8.0 --deterministic-version ^0.3.0
 npm run project:check -- ./deterministic-h5/syncplay.project.json --require descriptor,assets,config,replay-runtime,creator-boundary,static-determinism --frames 32 --out-dir ./deterministic-h5/artifacts/deterministic --dist ./deterministic-h5/dist --out ./deterministic-h5/artifacts/deterministic/project-check-browser.md --json ./deterministic-h5/artifacts/deterministic/project-check-browser.json --junit ./deterministic-h5/artifacts/deterministic/project-check-browser.xml --release-json ./deterministic-h5/artifacts/deterministic/project-release-evidence-browser.json --browser-runtime chromium --browser-json ./deterministic-h5/artifacts/deterministic/project-browser-proof-chromium.json
 npm run project:release-verify -- ./deterministic-h5/artifacts/deterministic/project-release-evidence-browser.json --require-browser-proof --json ./deterministic-h5/artifacts/deterministic/project-release-verification-browser.json
 npm run project:release-bundle -- ./deterministic-h5/artifacts/deterministic/project-release-evidence-browser.json --require-browser-proof --json ./deterministic-h5/artifacts/deterministic/project-release-bundle-browser.json
 npm run project:release-bundle-verify -- ./deterministic-h5/artifacts/deterministic/project-release-bundle-browser.json --out ./deterministic-h5/artifacts/deterministic/project-release-bundle-verification-browser.md --json ./deterministic-h5/artifacts/deterministic/project-release-bundle-verification-browser.json --junit ./deterministic-h5/artifacts/deterministic/project-release-bundle-verification-browser.xml
-npm run project:deploy-check -- ./deterministic-h5/syncplay.project.json --require-browser-proof --bundle ./deterministic-h5/artifacts/deterministic/project-release-bundle-browser.json --out ./deterministic-h5/artifacts/deterministic/project-deploy-check.md --json ./deterministic-h5/artifacts/deterministic/project-deploy-check.json --junit ./deterministic-h5/artifacts/deterministic/project-deploy-check.xml
-npm run project:deploy-check-verify -- ./deterministic-h5/artifacts/deterministic/project-deploy-check.json --out ./deterministic-h5/artifacts/deterministic/project-deploy-check-verification.md --json ./deterministic-h5/artifacts/deterministic/project-deploy-check-verification.json --junit ./deterministic-h5/artifacts/deterministic/project-deploy-check-verification.xml
 npm run project:doctor -- ./deterministic-h5/syncplay.project.json --require-browser-proof --json ./deterministic-h5/artifacts/deterministic/project-doctor-ci.json --junit ./deterministic-h5/artifacts/deterministic/project-doctor-ci.xml
 npm run --prefix ./deterministic-h5 build
 npm run project:scaffold -- ./deterministic-systems --name "Systems Test" --template systems
@@ -602,9 +699,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,57 +1,89 @@
-export { verifyReplay } from './replay.js';
-export { verifyReplayWithDescriptor as verifyDeterministicReplay } from './replay.js';
-export { createOfflineSession } from './offline-session.js';
-export { createSyncplayOfflineRuntime } from './sdk-offline.js';
-export { createSyncplayOfflineRuntime as createSyncplayGameRuntime } from './sdk-offline.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 { 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 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 './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 { 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 { 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 { 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 { 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, DeterministicPhysicsConstraint3D, DeterministicPhysicsContactDetail3D, DeterministicPhysicsContactEvent3D, DeterministicPhysicsDetailedHit3D, DeterministicPhysicsHit3D, DeterministicPhysicsImpulseApplication3D, DeterministicPhysicsOverlapQuery3D, DeterministicPhysicsPrimitiveShape3D, DeterministicPhysicsQuaternion3D, DeterministicPhysicsQueryOptions3D, DeterministicPhysicsRaycastQuery3D, DeterministicPhysicsScheduledQuery3D, DeterministicPhysicsShape3D, DeterministicPhysicsShapeCastQuery3D, DeterministicPhysicsStepResult3D, DeterministicPhysicsVec3, DeterministicPhysicsWorld3D } from './physics3d.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,53 +1,48 @@
-export { verifyReplay } from './replay.js';
-export { verifyReplayWithDescriptor as verifyDeterministicReplay } from './replay.js';
-export { createOfflineSession } from './offline-session.js';
-export { createSyncplayOfflineRuntime } from './sdk-offline.js';
-export { createSyncplayOfflineRuntime as createSyncplayGameRuntime } from './sdk-offline.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';
+// 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 * from './movement.js';
-export * from './movement3d.js';
-export * from './navigation.js';
-export * from './navmesh.js';
-export * from './collision.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 { 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 { 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 { 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 { 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;
@@ -171,6 +177,18 @@ export interface CertificationFixedFoundationMetrics {
         readonly mul: number;
         readonly div: number;
         readonly clamp: number;
+        readonly sqrt: number;
+        readonly exp: number;
+        readonly atan2Axis: number;
+        readonly normalizeLen: number;
+        readonly vec3Cross: {
+            readonly x: number;
+            readonly y: number;
+            readonly z: number;
+        };
+        readonly segmentDistance: number;
+        readonly sample: number;
+        readonly noiseSample: number;
     };
     readonly vectors: {
         readonly a: {
@@ -308,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;