@series-inc/rundot-syncplay 6.0.0-rc.43 → 6.0.0-rc.45

package/MIGRATING-RC41-TO-RC42.md

@@ -0,0 +1,9 @@
+# Syncplay rc.42
+
+This release adds multiplayer physical assemblies and a 3D physics runtime bridge:
+- `createSyncplayPhysicalAssemblySlice`, `stepSyncplayPhysicalAssembly`, and `projectSyncplayPhysicalAssembly` under `@series-inc/rundot-syncplay/modules/physical-assembly`.
+- Authoritative Ultrahand glue, detach, and rotate operations with deterministic events.
+- Recall trajectory recording and kinematic rewinds via `createSyncplayBodyPoseTrack3D`.
+- Orientation hold controller (`createOrientationHold3D`) and kinematic path drive (`createKinematicPathDrive3D`) in 3D physics.
+- Authoritative Rapier physics bridge (`createPhysicalAssemblyBridge3D`) linking assembly events to 3D world state.
+- Disconnect recovery to release holds and active recalls on slot departure.

package/MIGRATING-RC42-TO-RC43.md

@@ -0,0 +1,32 @@
+# Syncplay rc.43
+
+This release introduces deterministic dynamic seating and player-keyed secret authority:
+
+## Dynamic Seat Control
+- Rooms can configure dynamic slot policies via `deterministic.seatPolicy`:
+  - `recycleVacatedSeats`: boolean (default `false`). When `true`, vacated seats can be claimed by new joining players.
+  - `allowHumanClaimBot`: boolean (default `false`). When `true`, new human players can take over bot-controlled slots (transition S3). Returning original owners with retained claims can always reclaim their own seat regardless of this setting.
+  - `onHumanLeave`: `'empty' | 'bot'` (default `'empty'`). Dictates slot controller when a human player disconnects or departs.
+  - `initialBotSlots`: array of slot numbers controlled by bots at match start.
+- Full state machine supporting transitions S1 through S6:
+  - `S1_empty_to_bot`
+  - `S2_empty_to_human`
+  - `S3_bot_to_human`
+  - `S4_bot_to_empty`
+  - `S5_human_to_bot`
+  - `S6_human_to_empty`
+- Authority-issued controller leases: each human and bot controller receives an immutable, room-scoped lease (`claimId`, `botLeaseId`, and `controlEpoch`). Outgoing leases are revoked prior to successor admission.
+
+## Player-Keyed Secret Authority
+- Private holdings (cards, items, secret roles, and choice commitments) are strictly bound to authenticated `playerId` and `claimId`, rather than bare slot indices.
+- Unconsumed holdings are permanently revoked upon final departure from recyclable seats.
+- Successor players occupying recycled slots never inherit prior secrets or assigned hidden roles.
+- Role arrays are sized dynamically by simulation capacity `X`, removing the previous 16-player secret limit while preserving byte and snapshot budgets.
+
+## Durable Recovery & Fencing
+- Critical seat transitions and claim modifications use monotonic revision fencing in `StateStore.saveCritical`.
+- Stored snapshots round-trip version 4 records containing explicit `seatCheckpoint` states.
+- Storage read errors fail closed to prevent accidental overwrites or fresh worker starts over existing persistent rooms.
+
+## Match Log v2
+- Match logs now support version 2 formatting with explicit `claimAttributions` mapping each confirmed input frame to the active controller claim.

package/MIGRATING-RC43-TO-RC44.md

@@ -0,0 +1,19 @@
+# Syncplay rc.44
+
+This candidate release introduces authoring and tooling gap closures across physics and presentation:
+
+## Physics Debug Overlay 3D
+- Introduced `createPhysicsDebugOverlay3D` in `@series-inc/rundot-syncplay/physics/3d` and `@series-inc/rundot-syncplay`.
+- Supports read-only extraction of wireframe geometry, contact records, joint state, and sensors from `PhysicsWorld3D` without mutating physics state or invalidating simulation digests.
+- Provides strict type definitions: `PhysicsDebugOverlay3D`, `PhysicsDebugOverlayOptions3D`, `PhysicsDebugWireframeShape3D`, `PhysicsDebugContactRecord3D`, and `PhysicsDebugJointRecord3D`.
+- Supports R3F wireframe rendering adapters and budgeting controls (`maxShapes`, `maxVertices`, `maxContacts`, `maxJoints`, `maxSensors`).
+
+## Collider Preparation
+- Introduced pure deterministic geometry cooking and validation in `collider-preparation.ts`.
+- Validates coplanar faces, non-manifold edges, slivers, and degenerate polygons before registration with the native physics solver.
+
+## Navmesh Geometry Cooking
+- Added headless geometry cooking tools for dynamic navmesh generation in `navmesh.ts`.
+
+## Presentation Inverse Kinematics
+- Added two-bone presentation inverse kinematics solver in `presentation-ik.ts` with joint constraints and pole targets.

package/MIGRATING-RC44-TO-RC45.md

@@ -0,0 +1,18 @@
+# Syncplay rc.45
+
+This release contains verified performance optimizations for snapshot decoding, physics checkpoint state commitments, and session wire encoding:
+
+## Snapshot Base64 Decoding
+- Replaced temporary quartet array allocations with four numeric scalar registers in `base64ToBytes`.
+- Preserves identical decoding error messages, validation order, and padding checks.
+- Reduces temporary heap allocations by 94 percent during snapshot Base64 decoding.
+
+## 3D Physics Checkpoint Digest Caching
+- Memoizes `#digest` and `#strongDigest` on `CapturedPhysicsGame3D` during the unreleased checkpoint lifetime.
+- Public `physics.strongDigest()` method returns a defensive copy (`.slice()`) to protect cached buffers from external modification.
+- Internal `stateCommitment` reads protected digest buffers directly without duplicate calculation or unnecessary allocation.
+
+## Session Wire Single-Pass Canonical Encoding
+- Canonicalizes outbound session message payloads once before checksum computation and envelope serialization.
+- Serializes top-level envelope properties in canonical alphabetical order.
+- Forwards pre-decoded session messages to `handleSessionText` during session swap and secret validation paths to prevent duplicate decode work.

package/core/src/physics/physics-profile-wasm-module.generated.mjs

@@ -23,7 +23,7 @@ export const physicsProfileWasmMetadata = Object.freeze({
   "sourceHash": "095061366ce3734601d06d48fa61d88a8538e1ba01e9c47663a7303ddb18fee7",
   "wasmSha256": "4b2ac3ff7d0f7a15eb31f5742a90f16f458a906d5d41bdc5fbde03e5589f94bf",
   "artifact": "profile",
-  "packageVersion": "6.0.0-rc.43",
+  "packageVersion": "6.0.0-rc.45",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/core/src/physics/physics-wasm-module.generated.mjs

@@ -23,7 +23,7 @@ export const physicsWasmMetadata = Object.freeze({
   "sourceHash": "38d5f2cde9e8d448f029fd2921a743e4a40e19dc84c03abf7bed829003e2469d",
   "wasmSha256": "5f6a3d861cf3eb79a2f8060d6c4b5512673a943044a52a9d20b39f0f2fef985f",
   "artifact": "production",
-  "packageVersion": "6.0.0-rc.43",
+  "packageVersion": "6.0.0-rc.45",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/core/src/physics2d/physics2d-wasm-module.generated.mjs

@@ -50,7 +50,7 @@ export const physics2dWasmMetadata = Object.freeze({
   "sourceHash": "faa090a03a6fddaf79c704fb1d76f810955ff35597449c8cec9541a75905a37e",
   "wasmSha256": "49cb90541deed40f5fff1015bb578e13ec9a793d51931c1227e3e5a11bbfa3f7",
   "artifact": "production",
-  "packageVersion": "6.0.0-rc.43",
+  "packageVersion": "6.0.0-rc.45",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/dist/browser.d.ts

@@ -19,7 +19,7 @@ export { createDeterministicMath } from './math.js';
 export { rewindDeterministicTargets, runDeterministicMovementCrowdSimulation, runDeterministicMovementSimulation, stepDeterministicFpsAim, stepDeterministicKcc2D, stepDeterministicTopDownMover, validateDeterministicLagCompensatedHit } from './movement.js';
 export { stepDeterministicCarry3D, stepDeterministicKcc3D } from './movement3d.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 { cookDeterministicNavmesh, cookDeterministicNavmeshFromGeometry, cookImportedDeterministicNavmesh, findDeterministicNavmeshPath, findDeterministicNavmeshPointPath, locateDeterministicNavmeshPolygon, runDeterministicNavmeshStress, smoothDeterministicNavmeshPath, stepDeterministicNavmeshAgents, stepDeterministicNavmeshOffMeshTraversal } from './navmesh.js';
 export { createNetworkedSyncplayClient, prepareNetworkedSyncplayTransport } from './networked-client.js';
 export { createSyncplayRunner } from './runner.js';
 export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
@@ -84,3 +84,6 @@ export type { MultiplayerApi, JoinTicketRequest } from '@series-inc/rundot-game-
 export { openSyncplayBrowserRoom, resolveSyncplayBrowserIntent, shareSyncplayRoom, } from './browserSession.js';
 export type { OpenSyncplayBrowserRoomOptions, OpenSyncplayBrowserRoomResult, ResolveSyncplayBrowserIntentOptions, SyncplayBrowserApi, SyncplayBrowserIntent, } from './browserSession.js';
 export { SyncplayRuntimeLeaseRequiredError } from './runtime-cleanup.js';
+export type { DeterministicNavmeshGeometrySource, DeterministicNavmeshGeometryOptions } from './navmesh.js';
+export { solveTwoBoneIk3D, solveFootPlanting3D, } from './presentation-ik.js';
+export type { TwoBoneIkInput3D, TwoBoneIkOutput3D, FootPlantingInput3D, FootPlantingOutput3D, Vec3PresentationIK, QuatPresentationIK, } from './presentation-ik.js';

package/dist/browser.js

@@ -20,7 +20,7 @@ export { createDeterministicMath } from './math.js';
 export { rewindDeterministicTargets, runDeterministicMovementCrowdSimulation, runDeterministicMovementSimulation, stepDeterministicFpsAim, stepDeterministicKcc2D, stepDeterministicTopDownMover, validateDeterministicLagCompensatedHit } from './movement.js';
 export { stepDeterministicCarry3D, stepDeterministicKcc3D } from './movement3d.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 { cookDeterministicNavmesh, cookDeterministicNavmeshFromGeometry, cookImportedDeterministicNavmesh, findDeterministicNavmeshPath, findDeterministicNavmeshPointPath, locateDeterministicNavmeshPolygon, runDeterministicNavmeshStress, smoothDeterministicNavmeshPath, stepDeterministicNavmeshAgents, stepDeterministicNavmeshOffMeshTraversal } from './navmesh.js';
 export { createNetworkedSyncplayClient, prepareNetworkedSyncplayTransport } from './networked-client.js';
 export { createSyncplayRunner } from './runner.js';
 export { fbm2D, hash2, hashUint32, valueNoise1D, valueNoise2D } from './noise.js';
@@ -49,3 +49,4 @@ export { WsMultiplayerApi } from '@series-inc/rundot-game-sdk/mp-client';
 // (RundotGameAPI comes from the SDK — syncplay may depend on the SDK).
 export { openSyncplayBrowserRoom, resolveSyncplayBrowserIntent, shareSyncplayRoom, } from './browserSession.js';
 export { SyncplayRuntimeLeaseRequiredError } from './runtime-cleanup.js';
+export { solveTwoBoneIk3D, solveFootPlanting3D, } from './presentation-ik.js';

package/dist/collider-preparation.d.ts

@@ -0,0 +1,31 @@
+import { type ColliderSourceMesh } from './collider-cooking.js';
+export interface Point3D {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}
+export interface ColliderPreparationOptions {
+    readonly minArea?: number;
+    readonly minEdge?: number;
+    readonly resolution?: number;
+    readonly quantum?: number;
+}
+export interface ColliderPreparedPart {
+    readonly normal: Point3D;
+    readonly boundaries: readonly (readonly Point3D[])[];
+    readonly area: number;
+    readonly isHole?: boolean;
+}
+export interface ColliderPreparationRemovedStats {
+    readonly degenerate: number;
+    readonly interior: number;
+    readonly coplanar: number;
+    readonly contained: number;
+}
+export interface ColliderPreparationResult {
+    readonly triangles: readonly (readonly [Point3D, Point3D, Point3D])[];
+    readonly parts: readonly ColliderPreparedPart[];
+    readonly digest: string;
+    readonly removed: ColliderPreparationRemovedStats;
+}
+export declare function prepareColliderMesh(source: ColliderSourceMesh, options?: ColliderPreparationOptions): ColliderPreparationResult;