@series-inc/rundot-syncplay 5.26.0 → 5.28.0-beta.0

package/dist/physics3d.js

@@ -7,6 +7,73 @@ import { buildSolverHull, rayHullIntervalLocal, } from './physics3d-hull.js';
 import { computeShapeMassProperties } from './physics3d-mass.js';
 import { heightfieldLocalBounds, heightfieldLocalTriangles } from './physics3d-heightfield.js';
 import { conservativeToi, toiProxiesOf, toiProxyOf, } from './physics3d-toi.js';
+/**
+ * Creates a centered axis-aligned box shape from full dimensional sizes (sizeX, sizeY, sizeZ).
+ */
+export function createBoxShapeFromExtents(sizeX, sizeY, sizeZ) {
+    if (!Number.isFinite(sizeX) || sizeX <= 0 || !Number.isFinite(sizeY) || sizeY <= 0 || !Number.isFinite(sizeZ) || sizeZ <= 0) {
+        throw new Error(`createBoxShapeFromExtents: sizeX, sizeY, sizeZ must be positive finite numbers, received (${sizeX}, ${sizeY}, ${sizeZ})`);
+    }
+    return {
+        type: 'box',
+        halfX: sizeX / 2,
+        halfY: sizeY / 2,
+        halfZ: sizeZ / 2,
+    };
+}
+/**
+ * Creates a box shape from min and max bounding coordinates.
+ * Returns a simple box if centered at (0,0,0), or a single-child compound with offset if not centered.
+ */
+export function createBoxShapeFromMinMax(min, max) {
+    if (!Number.isFinite(min.x) || !Number.isFinite(min.y) || !Number.isFinite(min.z)
+        || !Number.isFinite(max.x) || !Number.isFinite(max.y) || !Number.isFinite(max.z)) {
+        throw new Error('createBoxShapeFromMinMax: min and max coordinates must be finite numbers');
+    }
+    if (max.x <= min.x || max.y <= min.y || max.z <= min.z) {
+        throw new Error(`createBoxShapeFromMinMax: max must be strictly greater than min on all axes, received min (${min.x},${min.y},${min.z}) max (${max.x},${max.y},${max.z})`);
+    }
+    const halfX = (max.x - min.x) / 2;
+    const halfY = (max.y - min.y) / 2;
+    const halfZ = (max.z - min.z) / 2;
+    const cx = (min.x + max.x) / 2;
+    const cy = (min.y + max.y) / 2;
+    const cz = (min.z + max.z) / 2;
+    if (cx === 0 && cy === 0 && cz === 0) {
+        return { type: 'box', halfX, halfY, halfZ };
+    }
+    return {
+        type: 'compound',
+        children: [
+            {
+                shape: { type: 'box', halfX, halfY, halfZ },
+                offset: { x: cx, y: cy, z: cz },
+            },
+        ],
+    };
+}
+/**
+ * Creates an upright capsule shape anchored at its base (y = 0), matching character controller conventions.
+ * Encapsulates the offset into a single-child compound shape centered at y = halfHeight + radius.
+ */
+export function createCapsuleShapeFromBase(radius, totalHeight) {
+    if (!Number.isFinite(radius) || radius <= 0 || !Number.isFinite(totalHeight) || totalHeight <= 0) {
+        throw new Error(`createCapsuleShapeFromBase: radius and totalHeight must be positive finite numbers, received radius ${radius}, totalHeight ${totalHeight}`);
+    }
+    if (totalHeight <= 2 * radius) {
+        throw new Error(`createCapsuleShapeFromBase: totalHeight must be strictly greater than 2 * radius (${2 * radius}), received ${totalHeight}`);
+    }
+    const halfHeight = (totalHeight - 2 * radius) / 2;
+    return {
+        type: 'compound',
+        children: [
+            {
+                shape: { type: 'capsule', radius, halfHeight },
+                offset: { x: 0, y: halfHeight + radius, z: 0 },
+            },
+        ],
+    };
+}
 export const deterministicPhysicsCallback3D = {
     collisionEnter: 1,
     collisionStay: 2,
@@ -281,6 +348,145 @@ export function applyDeterministicWorldEdit3D(world, edit) {
             : world.jointCache.filter((entry) => !removeJointIds.has(entry.jointId)),
     };
 }
+function applyKinematicUpdatesInternal(world, poseById, dt, callerName) {
+    const updatedIds = new Set();
+    const movedBodies = new Map();
+    const newBodies = world.bodies.map((body) => {
+        const pose = poseById.get(body.id);
+        if (pose === undefined) {
+            return body;
+        }
+        if (body.kind !== 'kinematic') {
+            throw new Error(`${callerName}: body ${body.id} is ${body.kind}, expected kinematic`);
+        }
+        updatedIds.add(body.id);
+        let vx = pose.vx;
+        let vy = pose.vy;
+        let vz = pose.vz;
+        if (vx === undefined || vy === undefined || vz === undefined) {
+            if (dt !== undefined) {
+                vx = vx ?? (pose.x - body.x) / dt;
+                vy = vy ?? (pose.y - body.y) / dt;
+                vz = vz ?? (pose.z - body.z) / dt;
+            }
+            else {
+                vx = vx ?? body.vx;
+                vy = vy ?? body.vy;
+                vz = vz ?? body.vz;
+            }
+        }
+        let angularVel = body.angularVel;
+        if (pose.angularVelX !== undefined || pose.angularVelY !== undefined || pose.angularVelZ !== undefined) {
+            angularVel = {
+                x: pose.angularVelX ?? body.angularVel?.x ?? 0,
+                y: pose.angularVelY ?? body.angularVel?.y ?? 0,
+                z: pose.angularVelZ ?? body.angularVel?.z ?? 0,
+            };
+        }
+        const updated = {
+            ...body,
+            x: pose.x,
+            y: pose.y,
+            z: pose.z,
+            vx,
+            vy,
+            vz,
+            rx: pose.rx ?? body.rx,
+            ry: pose.ry ?? body.ry,
+            rz: pose.rz ?? body.rz,
+            orientation: pose.orientation ?? body.orientation,
+            angularVel,
+        };
+        movedBodies.set(body.id, updated);
+        return updated;
+    });
+    for (const id of poseById.keys()) {
+        if (!updatedIds.has(id)) {
+            throw new Error(`${callerName}: cannot update unknown kinematic body ${id}`);
+        }
+    }
+    // Wake any dynamic bodies that share active pairs with updated kinematics
+    const wokenDynamicIds = new Set();
+    for (const pair of world.activePairMetadata) {
+        if (movedBodies.has(pair.a)) {
+            for (const member of contactIslandFor(world, pair.b)) {
+                wokenDynamicIds.add(member);
+            }
+        }
+        else if (movedBodies.has(pair.b)) {
+            for (const member of contactIslandFor(world, pair.a)) {
+                wokenDynamicIds.add(member);
+            }
+        }
+    }
+    const finalBodies = wokenDynamicIds.size === 0
+        ? newBodies
+        : newBodies.map((body) => (wokenDynamicIds.has(body.id) && body.kind === 'dynamic' && body.sleeping
+            ? { ...body, sleeping: false, lowVelFrames: 0 }
+            : body));
+    return {
+        ...world,
+        bodies: finalBodies,
+    };
+}
+/**
+ * Fast batch update of kinematic body transforms and velocities without
+ * allocating Set instances or re-sorting world bodies. Wakes touching dynamic
+ * bodies across active contact pairs. If linear velocity (vx, vy, vz) is omitted
+ * and dtTicks (> 0) is supplied, linear velocity is derived as (newPos - oldPos) / dtTicks.
+ */
+export function setDeterministicKinematicPoses3D(world, poses, options = {}) {
+    if (poses.length === 0) {
+        return world;
+    }
+    const dt = options.dtTicks !== undefined && options.dtTicks > 0 ? options.dtTicks : undefined;
+    const poseById = new Map();
+    for (const pose of poses) {
+        if (!Number.isFinite(pose.x) || !Number.isFinite(pose.y) || !Number.isFinite(pose.z)) {
+            throw new Error(`setDeterministicKinematicPoses3D: body ${pose.id} position must be finite numbers`);
+        }
+        poseById.set(pose.id, pose);
+    }
+    return applyKinematicUpdatesInternal(world, poseById, dt, 'setDeterministicKinematicPoses3D');
+}
+/**
+ * Allocation-free flat buffer batch update of kinematic body transforms.
+ * Accepts flat [x, y, z, qx, qy, qz, qw] arrays with stride 7 per bodyId,
+ * eliminating caller-side object allocations on high-frequency animation loops.
+ */
+export function setDeterministicKinematicTransforms3D(world, buffer, options = {}) {
+    const { bodyIds, transforms } = buffer;
+    if (transforms.length !== bodyIds.length * 7) {
+        throw new Error(`setDeterministicKinematicTransforms3D: transforms length must equal bodyIds.length * 7 (${bodyIds.length * 7}), received ${transforms.length}`);
+    }
+    if (bodyIds.length === 0) {
+        return world;
+    }
+    const dt = options.dtTicks !== undefined && options.dtTicks > 0 ? options.dtTicks : undefined;
+    const poseById = new Map();
+    for (let i = 0; i < bodyIds.length; i += 1) {
+        const id = bodyIds[i];
+        const offset = i * 7;
+        const x = transforms[offset];
+        const y = transforms[offset + 1];
+        const z = transforms[offset + 2];
+        const qx = transforms[offset + 3];
+        const qy = transforms[offset + 4];
+        const qz = transforms[offset + 5];
+        const qw = transforms[offset + 6];
+        if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)
+            || !Number.isFinite(qx) || !Number.isFinite(qy) || !Number.isFinite(qz) || !Number.isFinite(qw)) {
+            throw new Error(`setDeterministicKinematicTransforms3D: body ${id} transform contains non-finite numbers`);
+        }
+        poseById.set(id, {
+            x,
+            y,
+            z,
+            orientation: { x: qx, y: qy, z: qz, w: qw },
+        });
+    }
+    return applyKinematicUpdatesInternal(world, poseById, dt, 'setDeterministicKinematicTransforms3D');
+}
 /**
  * Apply a deterministic impulse to a body (linear + angular via lever arm),
  * waking the body and its contact island. Returns a new canonical world.
@@ -3112,6 +3318,27 @@ function rayBodyDistance(body, query) {
     if (body.shape.type === 'hull') {
         return rayHullBodyDistance(body, body.shape, query);
     }
+    if (body.shape.type === 'compound') {
+        let closestDistance;
+        for (let index = 0; index < body.shape.children.length; index += 1) {
+            const child = body.shape.children[index];
+            const childBody = {
+                ...body,
+                x: (body.x ?? 0) + (child.offset?.x ?? 0),
+                y: (body.y ?? 0) + (child.offset?.y ?? 0),
+                z: (body.z ?? 0) + (child.offset?.z ?? 0),
+                shape: child.shape,
+                rx: (body.rx ?? 0) + canonicalQuarterTurns(child.quarterTurns?.x ?? 0) / 4,
+                ry: (body.ry ?? 0) + canonicalQuarterTurns(child.quarterTurns?.y ?? 0) / 4,
+                rz: (body.rz ?? 0) + canonicalQuarterTurns(child.quarterTurns?.z ?? 0) / 4,
+            };
+            const childDistance = rayBodyDistance(childBody, query);
+            if (childDistance !== undefined && (closestDistance === undefined || childDistance < closestDistance)) {
+                closestDistance = childDistance;
+            }
+        }
+        return closestDistance;
+    }
     return rayAabbDistance(toBounds(body), query);
 }
 function rayHullBodyDistance(body, shape, query) {
@@ -3425,13 +3652,61 @@ function countCandidatePairs(bodies) {
     countCandidatePairsCalls += 1;
     return broadphaseCandidatePairs(bodies).length;
 }
+function compoundChildDetailedHit(body, query, distance) {
+    if (body.shape.type !== 'compound') {
+        return undefined;
+    }
+    let bestChildIndex;
+    let bestNormal;
+    let bestDistDiff = Infinity;
+    for (let index = 0; index < body.shape.children.length; index += 1) {
+        const child = body.shape.children[index];
+        const childBody = {
+            ...body,
+            x: (body.x ?? 0) + (child.offset?.x ?? 0),
+            y: (body.y ?? 0) + (child.offset?.y ?? 0),
+            z: (body.z ?? 0) + (child.offset?.z ?? 0),
+            shape: child.shape,
+            rx: (body.rx ?? 0) + canonicalQuarterTurns(child.quarterTurns?.x ?? 0) / 4,
+            ry: (body.ry ?? 0) + canonicalQuarterTurns(child.quarterTurns?.y ?? 0) / 4,
+            rz: (body.rz ?? 0) + canonicalQuarterTurns(child.quarterTurns?.z ?? 0) / 4,
+        };
+        const childDist = 'dx' in query ? rayBodyDistance(childBody, query) : undefined;
+        if (childDist !== undefined) {
+            const diff = Math.abs(childDist - distance);
+            if (diff < bestDistDiff) {
+                bestDistDiff = diff;
+                bestChildIndex = index;
+                const center = quantizePoint({
+                    x: query.x + query.dx * childDist,
+                    y: query.y + query.dy * childDist,
+                    z: query.z + query.dz * childDist,
+                });
+                bestNormal = hitNormalForBody(childBody, center);
+            }
+        }
+    }
+    if (bestChildIndex !== undefined && bestNormal !== undefined) {
+        return { childIndex: bestChildIndex, normal: bestNormal };
+    }
+    return undefined;
+}
 function detailedHitForBody(body, query, distance, castRadius) {
     const center = quantizePoint({
         x: query.x + query.dx * distance,
         y: query.y + query.dy * distance,
         z: query.z + query.dz * distance,
     });
-    const normal = hitNormalForBody(body, center);
+    let normal;
+    let childIndex;
+    if (body.shape.type === 'compound') {
+        const compoundHit = compoundChildDetailedHit(body, query, distance);
+        childIndex = compoundHit?.childIndex;
+        normal = compoundHit?.normal ?? hitNormalForBody(body, center);
+    }
+    else {
+        normal = hitNormalForBody(body, center);
+    }
     const point = quantizePoint({
         x: center.x - normal.x * castRadius,
         y: center.y - normal.y * castRadius,
@@ -3443,6 +3718,7 @@ function detailedHitForBody(body, query, distance, castRadius) {
         point,
         normal,
         penetration: distance === 0 ? penetrationAtPoint(body, center, castRadius) : 0,
+        childIndex,
     };
 }
 function hitNormalForBody(body, point) {
@@ -3453,6 +3729,24 @@ function hitNormalForBody(body, point) {
             z: point.z - body.z,
         });
     }
+    if (body.shape.type === 'capsule') {
+        const halfHeight = body.shape.halfHeight;
+        let localPoint = { x: point.x - body.x, y: point.y - body.y, z: point.z - body.z };
+        if (body.orientation !== undefined) {
+            localPoint = rotatePointByQuatInverse(body.orientation, localPoint);
+        }
+        const clampedY = Math.max(-halfHeight, Math.min(halfHeight, localPoint.y));
+        const localDelta = {
+            x: localPoint.x,
+            y: localPoint.y - clampedY,
+            z: localPoint.z,
+        };
+        const localNormal = normalizePoint(localDelta);
+        if (body.orientation !== undefined) {
+            return normalizePoint(rotatePointByQuat(body.orientation, localNormal));
+        }
+        return localNormal;
+    }
     const bounds = toBounds(body);
     const candidates = [
         { normal: { x: -1, y: 0, z: 0 }, distance: Math.abs(point.x - bounds.minX), axis: 'x-' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/rundot-syncplay",
-  "version": "5.26.0",
+  "version": "5.28.0-beta.0",
   "description": "Kinetix orchestration, rollback, replay, late-join, and deterministic networking for RUN.game",
   "repository": {
     "type": "git",
@@ -42,6 +42,11 @@
       "import": "./dist/tools/index.js",
       "default": "./dist/tools/index.js"
     },
+    "./debug": {
+      "types": "./dist/debug-wireframe.d.ts",
+      "import": "./dist/debug-wireframe.js",
+      "default": "./dist/debug-wireframe.js"
+    },
     "./modules/component-model": {
       "types": "./dist/modules/component-model.d.ts",
       "import": "./dist/modules/component-model.js",
@@ -163,7 +168,7 @@
     "test:core": "node --expose-gc --import tsx --test --test-concurrency=1 tests/canonical.test.ts tests/canonical-portability.test.ts tests/runtime-session.test.ts tests/kinetix-runtime-session.test.ts tests/runtime-support.test.ts tests/runtime-guards.test.ts tests/r3f-render-adapter.test.ts tests/snapshot-cost.test.ts tests/sdkSession.test.ts tests/input-authority.test.ts tests/session-wire.test.ts tests/runtime-room-metadata.test.ts tests/session-snapshot.test.ts tests/authority-room.test.ts tests/networked-client-snapshot.test.ts tests/runner.test.ts tests/testing.test.ts tests/browser-session.test.ts tests/secret-config.test.ts tests/secret-protocol.test.ts tests/secret-authority.test.ts tests/secret-client.test.ts tests/late-join-checksum.test.ts tests/late-join-input-backfill.test.ts tests/replay-scoring.test.ts tests/bot-backfill.test.ts tests/latency-simulation.test.ts tests/production-input-budget.test.ts tests/time-sync.test.ts tests/match-log.test.ts tests/spectator.test.ts tests/synctest.test.ts tests/instant-replay.test.ts tests/session-promotion.test.ts tests/physics3d-broadphase-stats.test.ts tests/entrypoints.test.ts tests/export-surface.test.ts tests/module-seam.test.ts tests/module-contract-portability.test.ts tests/module-identity.test.ts tests/module-corpus.test.ts tests/component-model.test.ts tests/component-model-rollback.test.ts tests/component-model-integration.test.ts tests/actors-ai.test.ts tests/character-3d.test.ts tests/character-3d-certification.test.ts tests/combat-modules.test.ts tests/combat-modules-integration.test.ts tests/firearm.test.ts tests/gameplay-effects.test.ts tests/spatial-interaction.test.ts tests/stats-abilities.test.ts tests/inventory-equipment.test.ts tests/inventory-equipment-certification.test.ts tests/platformer-2d.test.ts tests/platformer-2d-certification.test.ts tests/module-promotion.test.ts tests/module-docs.test.ts tests/module-bundle-budget.test.ts tests/published-side-effects.test.ts tests/host-timing.test.ts tests/test-manifest.test.ts tests/coarse-region.test.ts tests/input-codec.test.ts tests/command-ingress.test.ts tests/session-reconfigure.test.ts tests/prediction-mode.test.ts tests/ephemeral-channel.test.ts tests/runner-surface.test.ts tests/runner-harness.test.ts tests/effects-adapter-bounds.test.ts tests/simulated-match-secrets.test.ts tests/run-glue-surface.test.mjs core/tests/core-boundary.test.mjs tests/math-core-parity.test.ts tests/math-profile.test.ts tests/movement3d-kcc-unit-contract.test.ts tests/movement3d-static-ground.test.ts",
     "test:sdk-contract": "node --import tsx --test tests/sdk-runtime-contract.test.ts",
     "test:soak": "tsx --test tests/runtime-soak.test.ts",
-    "test:extended": "tsx --test tests/kcc-vehicle-characterization.test.ts tests/animation.test.ts tests/asset-cooking.test.ts tests/backend-proof-checksum-vectors.test.ts tests/bot-documents.test.ts tests/bot-primitives.test.ts tests/collider-cooking.test.ts tests/collision.test.ts tests/command-timeline.test.ts tests/config-bundle.test.ts tests/cosmetic-physics3d.test.ts tests/deterministic-primitives.test.ts tests/ecs-lite.test.ts tests/effects-adapter.test.ts tests/engine-runtime.test.ts tests/errors.test.ts tests/events.test.ts tests/input-button.test.ts tests/load-128-players.test.ts tests/math.test.ts tests/movement.test.ts tests/movement3d.test.ts tests/multiclient-authority.test.ts tests/navigation.test.ts tests/noise.test.ts tests/physics-cert.test.ts tests/physics2d.test.ts tests/physics3d-ccd.test.ts tests/physics3d-coverage.test.ts tests/physics3d-destruction-cert.test.ts tests/physics3d-geometry-limits.test.ts tests/physics3d-heightfield.test.ts tests/physics3d-hull.test.ts tests/physics3d-joints.test.ts tests/physics3d-kinematic-mesh.test.ts tests/physics3d-mass.test.ts tests/physics3d-materials.test.ts tests/physics3d-mesh-onesided.test.ts tests/physics3d-query-index.test.ts tests/physics3d-recipes.test.ts tests/physics3d-rotation-convention.test.ts tests/physics3d-shared.test.ts tests/physics3d-sleeping-manifold-reuse.test.ts tests/physics3d-solver.test.ts tests/physics3d-static-memoization.test.ts tests/physics3d-static-overlap-memo.test.ts tests/physics3d-cylinder-hull.test.ts tests/physics3d-stacking.test.ts tests/physics3d-toi.test.ts tests/physics3d-vehicle.test.ts tests/physics3d-voxel.test.ts tests/physics3d-world-edit.test.ts tests/physics3d.test.ts tests/physics-vector-generator.test.ts tests/random.test.ts tests/rollback-history.test.ts tests/schema-artifacts.test.ts tests/schema-codegen.test.ts tests/schema-dsl-binary.test.ts tests/schema.test.ts tests/signals.test.ts tests/sparse-set.test.ts tests/static-checker.test.ts tests/system-lifecycle.test.ts tests/wire-canonical-sentinels.test.ts tests/ws-frame.test.ts",
+    "test:extended": "tsx --test tests/kcc-vehicle-characterization.test.ts tests/animation.test.ts tests/asset-cooking.test.ts tests/backend-proof-checksum-vectors.test.ts tests/bot-documents.test.ts tests/bot-primitives.test.ts tests/collider-cooking.test.ts tests/collision.test.ts tests/command-timeline.test.ts tests/config-bundle.test.ts tests/cosmetic-physics3d.test.ts tests/deterministic-primitives.test.ts tests/ecs-lite.test.ts tests/effects-adapter.test.ts tests/engine-runtime.test.ts tests/errors.test.ts tests/events.test.ts tests/input-button.test.ts tests/load-128-players.test.ts tests/math.test.ts tests/movement.test.ts tests/movement3d.test.ts tests/multiclient-authority.test.ts tests/navigation.test.ts tests/noise.test.ts tests/physics-cert.test.ts tests/physics2d.test.ts tests/physics3d-ccd.test.ts tests/physics3d-coverage.test.ts tests/physics3d-debug-wireframe.test.ts tests/physics3d-destruction-cert.test.ts tests/physics3d-geometry-limits.test.ts tests/physics3d-heightfield.test.ts tests/physics3d-hull.test.ts tests/physics3d-joints.test.ts tests/physics3d-kinematic-mesh.test.ts tests/physics3d-kinematic-poses.test.ts tests/physics3d-kinematic-transforms.test.ts tests/physics3d-mass.test.ts tests/physics3d-materials.test.ts tests/physics3d-mesh-onesided.test.ts tests/physics3d-queries-capsule-childindex.test.ts tests/physics3d-query-index.test.ts tests/physics3d-recipes.test.ts tests/physics3d-rotation-convention.test.ts tests/physics3d-shape-builders.test.ts tests/physics3d-shared.test.ts tests/physics3d-sleeping-manifold-reuse.test.ts tests/physics3d-solver.test.ts tests/physics3d-static-memoization.test.ts tests/physics3d-static-overlap-memo.test.ts tests/physics3d-cylinder-hull.test.ts tests/physics3d-stacking.test.ts tests/physics3d-toi.test.ts tests/physics3d-vehicle.test.ts tests/physics3d-voxel-carving.test.ts tests/physics3d-voxel-dda.test.ts tests/physics3d-voxel.test.ts tests/physics3d-world-edit.test.ts tests/physics3d.test.ts tests/physics-vector-generator.test.ts tests/random.test.ts tests/rollback-history.test.ts tests/schema-artifacts.test.ts tests/schema-codegen.test.ts tests/schema-dsl-binary.test.ts tests/schema.test.ts tests/signals.test.ts tests/sparse-set.test.ts tests/static-checker.test.ts tests/system-lifecycle.test.ts tests/wire-canonical-sentinels.test.ts tests/ws-frame.test.ts",
     "test:ci": "npm run build && npm run test",
     "build:native": "node core/scripts/build-native.mjs",
     "build:mobile-native": "node core/scripts/build-mobile-native.mjs",