@flighthq/physics3d 0.5.1-next.903.f434bc2 → 0.5.1-next.905.5fbf787

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/physics3d`. The `@fl
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/physics3d@0.5.1-next.903.f434bc2](https://github.com/flighthq/flight/tree/f434bc233778d75aeea61995df3a8cfaec459a85/packages/physics3d)
-- [License](https://github.com/flighthq/flight/blob/f434bc233778d75aeea61995df3a8cfaec459a85/LICENSE.md)
+- [Source for @flighthq/physics3d@0.5.1-next.905.5fbf787](https://github.com/flighthq/flight/tree/5fbf7874064c384307542d68b4dcb6a895ff0dcf/packages/physics3d)
+- [License](https://github.com/flighthq/flight/blob/5fbf7874064c384307542d68b4dcb6a895ff0dcf/LICENSE.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/physics3d",
-  "version": "0.5.1-next.903.f434bc2",
+  "version": "0.5.1-next.905.5fbf787",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,13 +38,13 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/collision": "0.5.1-next.903.f434bc2",
-    "@flighthq/entity": "0.5.1-next.903.f434bc2",
-    "@flighthq/log": "0.5.1-next.903.f434bc2",
-    "@flighthq/math": "0.5.1-next.903.f434bc2",
-    "@flighthq/node": "0.5.1-next.903.f434bc2",
-    "@flighthq/spatial": "0.5.1-next.903.f434bc2",
-    "@flighthq/types": "0.5.1-next.903.f434bc2"
+    "@flighthq/collision": "0.5.1-next.905.5fbf787",
+    "@flighthq/entity": "0.5.1-next.905.5fbf787",
+    "@flighthq/log": "0.5.1-next.905.5fbf787",
+    "@flighthq/math": "0.5.1-next.905.5fbf787",
+    "@flighthq/node": "0.5.1-next.905.5fbf787",
+    "@flighthq/spatial": "0.5.1-next.905.5fbf787",
+    "@flighthq/types": "0.5.1-next.905.5fbf787"
   },
   "devDependencies": {
     "@flighthq/geometry": "*",

package/src/colliderTransform.test.ts

@@ -4,6 +4,12 @@ import { describe, expect, it } from 'vitest';
 
 import {
   createPhysics3DColliderWorldShape,
+  initializeCollisionBox3D,
+  initializeCollisionCapsule3D,
+  initializeCollisionCone3D,
+  initializeCollisionConvex3D,
+  initializeCollisionCylinder3D,
+  initializeCollisionSphere3D,
   updatePhysics3DColliderWorldShape,
   writePhysics3DColliderBounds,
 } from './colliderTransform';
@@ -64,6 +70,41 @@ describe('createPhysics3DColliderWorldShape', () => {
   });
 });
 
+describe('initializeCollisionBox3D', () => {
+  it('is the construction initializer of createCollisionBox3D', () => {
+    expect(typeof initializeCollisionBox3D).toBe('function');
+  });
+});
+
+describe('initializeCollisionCapsule3D', () => {
+  it('is the construction initializer of createCollisionCapsule3D', () => {
+    expect(typeof initializeCollisionCapsule3D).toBe('function');
+  });
+});
+describe('initializeCollisionCone3D', () => {
+  it('is the construction initializer of createCollisionCone3D', () => {
+    expect(typeof initializeCollisionCone3D).toBe('function');
+  });
+});
+
+describe('initializeCollisionConvex3D', () => {
+  it('is the construction initializer of createCollisionConvex3D', () => {
+    expect(typeof initializeCollisionConvex3D).toBe('function');
+  });
+});
+
+describe('initializeCollisionCylinder3D', () => {
+  it('is the construction initializer of createCollisionCylinder3D', () => {
+    expect(typeof initializeCollisionCylinder3D).toBe('function');
+  });
+});
+
+describe('initializeCollisionSphere3D', () => {
+  it('is the construction initializer of createCollisionSphere3D', () => {
+    expect(typeof initializeCollisionSphere3D).toBe('function');
+  });
+});
+
 describe('updatePhysics3DColliderWorldShape', () => {
   it('translates a sphere by the body position', () => {
     const body = createRigidBody3D('dynamic');

package/src/contacts.test.ts

@@ -1,6 +1,11 @@
 import { describe, expect, it } from 'vitest';
 
-import { createPhysics3DContact, createPhysics3DContactPoint } from './contacts';
+import {
+  createPhysics3DContact,
+  createPhysics3DContactPoint,
+  initializePhysics3DContact,
+  initializePhysics3DContactPoint,
+} from './contacts';
 
 describe('createPhysics3DContact', () => {
   it('orders the pair by index whichever way round it is given', () => {
@@ -62,3 +67,14 @@ describe('createPhysics3DContactPoint', () => {
     ]);
   });
 });
+describe('initializePhysics3DContact', () => {
+  it('is the construction initializer of createPhysics3DContact', () => {
+    expect(typeof initializePhysics3DContact).toBe('function');
+  });
+});
+
+describe('initializePhysics3DContactPoint', () => {
+  it('is the construction initializer of createPhysics3DContactPoint', () => {
+    expect(typeof initializePhysics3DContactPoint).toBe('function');
+  });
+});

package/src/debugGeometry.test.ts

@@ -8,7 +8,11 @@ import type { CollisionBuiltInShape3D, Physics3DWorld, RigidBody3D } from '@flig
 import { beforeEach, describe, expect, it } from 'vitest';
 
 import { buildPhysics3DContacts } from './contactIntake';
-import { createPhysics3DDebugGeometry, writePhysics3DDebugGeometry } from './debugGeometry';
+import {
+  createPhysics3DDebugGeometry,
+  initializePhysics3DDebugGeometry,
+  writePhysics3DDebugGeometry,
+} from './debugGeometry';
 import { createPhysics3DBallAndSocketJoint } from './jointFactories';
 import { addPhysics3DJoint } from './jointRegistry';
 import { registerBuiltInPhysics3DJointSolvers } from './registerBuiltInPhysics3DJointSolvers';
@@ -57,6 +61,11 @@ describe('createPhysics3DDebugGeometry', () => {
   });
 });
 
+describe('initializePhysics3DDebugGeometry', () => {
+  it('is the construction initializer of createPhysics3DDebugGeometry', () => {
+    expect(typeof initializePhysics3DDebugGeometry).toBe('function');
+  });
+});
 describe('writePhysics3DDebugGeometry', () => {
   it('draws explicit mesh triangles and heightfield grid edges', () => {
     const world = createPhysics3DWorld();

package/src/jointFactories.test.ts

@@ -8,6 +8,13 @@ import {
   createPhysics3DGeneric6DofJoint,
   createPhysics3DHingeJoint,
   createPhysics3DSliderJoint,
+  initializePhysics3DBallAndSocketJoint,
+  initializePhysics3DConeTwistJoint,
+  initializePhysics3DDistanceJoint,
+  initializePhysics3DFixedJoint,
+  initializePhysics3DGeneric6DofJoint,
+  initializePhysics3DHingeJoint,
+  initializePhysics3DSliderJoint,
 } from './jointFactories';
 import {
   Physics3DBallAndSocketJointKind,
@@ -242,3 +249,44 @@ describe('createPhysics3DSliderJoint', () => {
     expect(joint.maxMotorForce).toBe(15);
   });
 });
+describe('initializePhysics3DBallAndSocketJoint', () => {
+  it('is the construction initializer of createPhysics3DBallAndSocketJoint', () => {
+    expect(typeof initializePhysics3DBallAndSocketJoint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DConeTwistJoint', () => {
+  it('is the construction initializer of createPhysics3DConeTwistJoint', () => {
+    expect(typeof initializePhysics3DConeTwistJoint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DDistanceJoint', () => {
+  it('is the construction initializer of createPhysics3DDistanceJoint', () => {
+    expect(typeof initializePhysics3DDistanceJoint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DFixedJoint', () => {
+  it('is the construction initializer of createPhysics3DFixedJoint', () => {
+    expect(typeof initializePhysics3DFixedJoint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DGeneric6DofJoint', () => {
+  it('is the construction initializer of createPhysics3DGeneric6DofJoint', () => {
+    expect(typeof initializePhysics3DGeneric6DofJoint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DHingeJoint', () => {
+  it('is the construction initializer of createPhysics3DHingeJoint', () => {
+    expect(typeof initializePhysics3DHingeJoint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DSliderJoint', () => {
+  it('is the construction initializer of createPhysics3DSliderJoint', () => {
+    expect(typeof initializePhysics3DSliderJoint).toBe('function');
+  });
+});

package/src/jointReaction.test.ts

@@ -8,6 +8,7 @@ import {
   createPhysics3DJointReaction,
   getPhysics3DJointReactionForce,
   getPhysics3DJointReactionTorque,
+  initializePhysics3DJointReaction,
   writePhysics3DJointReaction,
 } from './jointReaction';
 import { addPhysics3DJoint } from './jointRegistry';
@@ -117,6 +118,42 @@ describe('getPhysics3DJointReactionTorque', () => {
   });
 });
 
+describe('initializePhysics3DJointReaction', () => {
+  it('is the construction initializer of createPhysics3DJointReaction', () => {
+    expect(typeof initializePhysics3DJointReaction).toBe('function');
+  });
+});
+
+interface HangingScene {
+  world: Physics3DWorld;
+  joint: ReturnType<typeof createPhysics3DBallAndSocketJoint>;
+}
+
+// One body hanging from a static anchor by a ball-and-socket, which is the simplest arrangement whose
+// reaction has a value known without reference to the solver: it is the hanging weight.
+function createHangingScene(mass: number, gravity: number): HangingScene {
+  const world = createPhysics3DWorld();
+  world.gravityY = -gravity;
+  registerBuiltInPhysics3DJointSolvers(world);
+  const anchor = createRigidBody3D('static');
+  addPhysics3DBody(world, anchor);
+  const hanging = createUnitBody(mass);
+  addPhysics3DBody(world, hanging);
+  const joint = createPhysics3DBallAndSocketJoint({ bodyA: 0, bodyB: 1 });
+  addPhysics3DJoint(world, joint);
+  return { world, joint };
+}
+
+function createUnitBody(mass: number): RigidBody3D {
+  const body = createRigidBody3D('dynamic');
+  const data = createPhysics3DMassData();
+  data.mass = mass;
+  data.inertiaXX = mass;
+  data.inertiaYY = mass;
+  data.inertiaZZ = mass;
+  setRigidBody3DMassData(body, data);
+  return body;
+}
 describe('writePhysics3DJointReaction', () => {
   it('MEASURES THE WEIGHT A JOINT IS HOLDING UP', () => {
     // The reading that makes the API worth having, checked against a number derived from outside the
@@ -208,34 +245,3 @@ describe('writePhysics3DJointReaction', () => {
     expect(Math.abs(out.forceY)).toBeCloseTo(20, 0);
   });
 });
-
-interface HangingScene {
-  world: Physics3DWorld;
-  joint: ReturnType<typeof createPhysics3DBallAndSocketJoint>;
-}
-
-// One body hanging from a static anchor by a ball-and-socket, which is the simplest arrangement whose
-// reaction has a value known without reference to the solver: it is the hanging weight.
-function createHangingScene(mass: number, gravity: number): HangingScene {
-  const world = createPhysics3DWorld();
-  world.gravityY = -gravity;
-  registerBuiltInPhysics3DJointSolvers(world);
-  const anchor = createRigidBody3D('static');
-  addPhysics3DBody(world, anchor);
-  const hanging = createUnitBody(mass);
-  addPhysics3DBody(world, hanging);
-  const joint = createPhysics3DBallAndSocketJoint({ bodyA: 0, bodyB: 1 });
-  addPhysics3DJoint(world, joint);
-  return { world, joint };
-}
-
-function createUnitBody(mass: number): RigidBody3D {
-  const body = createRigidBody3D('dynamic');
-  const data = createPhysics3DMassData();
-  data.mass = mass;
-  data.inertiaXX = mass;
-  data.inertiaYY = mass;
-  data.inertiaZZ = mass;
-  setRigidBody3DMassData(body, data);
-  return body;
-}

package/src/massProperties.test.ts

@@ -4,15 +4,16 @@ import { describe, expect, it } from 'vitest';
 import {
   combinePhysics3DMassData,
   computePhysics3DBoxMassData,
+  computePhysics3DCapsuleMassData,
   computePhysics3DColliderMassData,
   computePhysics3DConeMassData,
-  computePhysics3DCylinderMassData,
   computePhysics3DConvexHullMassData,
-  computePhysics3DCapsuleMassData,
+  computePhysics3DCylinderMassData,
   computePhysics3DSphereMassData,
   createPhysics3DMassData,
-  updateRigidBody3DMassData,
+  initializePhysics3DMassData,
   setRigidBody3DMassData,
+  updateRigidBody3DMassData,
 } from './massProperties';
 import { addPhysics3DBody, createPhysics3DCollider, createPhysics3DWorld, createRigidBody3D } from './world';
 
@@ -427,6 +428,12 @@ describe('createPhysics3DMassData', () => {
   });
 });
 
+describe('initializePhysics3DMassData', () => {
+  it('is the construction initializer of createPhysics3DMassData', () => {
+    expect(typeof initializePhysics3DMassData).toBe('function');
+  });
+});
+
 describe('setRigidBody3DMassData', () => {
   it('derives the inverse mass and a non-zero inverse tensor for a dynamic body', () => {
     const body = testBody('dynamic');
@@ -496,7 +503,6 @@ describe('setRigidBody3DMassData', () => {
     expect(body.centerY).toBe(4);
   });
 });
-
 describe('updateRigidBody3DMassData', () => {
   it('derives a body mass from its colliders', () => {
     const world = createPhysics3DWorld();

package/src/solver.test.ts

@@ -17,6 +17,8 @@ import { setRigidBody3DMassData } from './massProperties';
 import {
   createPhysics3DContactConstraint,
   createPhysics3DContactConstraintPoint,
+  initializePhysics3DContactConstraint,
+  initializePhysics3DContactConstraintPoint,
   preparePhysics3DContactConstraints,
   solvePhysics3DContactPositions,
   solvePhysics3DContactVelocities,
@@ -55,6 +57,18 @@ describe('createPhysics3DContactConstraintPoint', () => {
   });
 });
 
+describe('initializePhysics3DContactConstraint', () => {
+  it('is the construction initializer of createPhysics3DContactConstraint', () => {
+    expect(typeof initializePhysics3DContactConstraint).toBe('function');
+  });
+});
+
+describe('initializePhysics3DContactConstraintPoint', () => {
+  it('is the construction initializer of createPhysics3DContactConstraintPoint', () => {
+    expect(typeof initializePhysics3DContactConstraintPoint).toBe('function');
+  });
+});
+
 describe('preparePhysics3DContactConstraints', () => {
   it('builds a friction basis orthonormal to the contact normal', () => {
     const world = createFallingBoxWorld();
@@ -293,6 +307,93 @@ describe('solvePhysics3DContactPositions', () => {
   });
 });
 
+function createContactPoint(featureId: number, depth: number): Physics3DContactPoint {
+  const point = createPhysics3DContactPointRecord();
+  point.depth = depth;
+  point.featureId = featureId;
+  point.rAY = -0.5;
+  point.rBY = 0.5;
+  return point;
+}
+
+function createContact(bodyA: number, bodyB: number): Physics3DContact {
+  const contact = createPhysics3DContactRecord(bodyA, bodyB);
+  contact.normalY = 1;
+  contact.pointCount = 1;
+  contact.points.push(createContactPoint(1, 0.01));
+  contact.touching = true;
+  return contact;
+}
+
+function createUnitBox(world: Physics3DWorld): RigidBody3D {
+  const body = createRigidBody3D();
+  const mass = createPhysics3DMassData();
+  computePhysics3DBoxMassData(0.5, 0.5, 0.5, 1, mass);
+  setRigidBody3DMassData(body, mass);
+  refreshRigidBody3DWorldInertia(body);
+  addPhysics3DBody(world, body);
+  return body;
+}
+
+// The solver reads the SOLVE ISLAND contact slices rather than `world.contacts`, so a world assembled
+// by hand needs the same workspace `stepPhysics3D` builds before it reaches the solver. Without it every
+// prepare finds nothing to do — which is the correct answer for a world with no awake islands, and the
+// reason this is a factory step rather than something prepare rebuilds for itself.
+//
+// A test that changes what belongs in an island AFTER this — putting a body to sleep, disabling a
+// contact, making a body static — has to call it again, exactly as a real step rebuilds every step.
+function buildSolveWorkspace(world: Physics3DWorld): Physics3DWorld {
+  updatePhysics3DSleep(world, 1 / 60);
+  buildPhysics3DSolveIslands(world);
+  return world;
+}
+
+// One dynamic box whose single contact point references a body that is not in the world's contact
+// partner slot — used for the basis and mass-denominator tests, where only body A matters.
+function createFallingBoxWorld(): Physics3DWorld {
+  const world = createPhysics3DWorld();
+  const box = createUnitBox(world);
+  const other = createUnitBox(world);
+  world.contacts.push(createContact(box.index, other.index));
+  return buildSolveWorkspace(world);
+}
+
+// Two unit boxes with REAL colliders, overlapping vertically by `depth`, with contacts generated the
+// way a step generates them. The position pass reads geometry, so this is the only fixture shape its
+// tests can be written against.
+function createOverlappingBoxWorld(depth: number): Physics3DWorld {
+  const world = createPhysics3DWorld();
+  const upper = createUnitBox(world);
+  const lower = createUnitBox(world);
+  setPhysics3DBodyType(lower, 'static');
+  for (const body of [upper, lower]) {
+    addPhysics3DCollider(
+      world,
+      body,
+      createPhysics3DCollider({ kind: 'aabb', minX: -0.5, minY: -0.5, minZ: -0.5, maxX: 0.5, maxY: 0.5, maxZ: 0.5 }),
+    );
+  }
+  upper.y = 1 - depth;
+  buildPhysics3DContacts(world);
+  return buildSolveWorkspace(world);
+}
+
+function createBoxOnGroundWorld(): Physics3DWorld {
+  const world = createPhysics3DWorld();
+  const box = createUnitBox(world);
+  const ground = createUnitBox(world);
+  setPhysics3DBodyType(ground, 'static');
+  world.contacts.push(createContact(box.index, ground.index));
+  return buildSolveWorkspace(world);
+}
+
+function createTwoDynamicBodyWorld(): Physics3DWorld {
+  const world = createPhysics3DWorld();
+  const upper = createUnitBox(world);
+  const lower = createUnitBox(world);
+  world.contacts.push(createContact(upper.index, lower.index));
+  return buildSolveWorkspace(world);
+}
 describe('solvePhysics3DContactVelocities', () => {
   it('removes the approach velocity of a body resting on static ground', () => {
     const world = createBoxOnGroundWorld();
@@ -464,91 +565,3 @@ describe('warmStartPhysics3DContacts', () => {
     expect(Math.abs(warm.bodies[0].velocityY)).toBeLessThanOrEqual(Math.abs(cold.bodies[0].velocityY));
   });
 });
-
-function createContactPoint(featureId: number, depth: number): Physics3DContactPoint {
-  const point = createPhysics3DContactPointRecord();
-  point.depth = depth;
-  point.featureId = featureId;
-  point.rAY = -0.5;
-  point.rBY = 0.5;
-  return point;
-}
-
-function createContact(bodyA: number, bodyB: number): Physics3DContact {
-  const contact = createPhysics3DContactRecord(bodyA, bodyB);
-  contact.normalY = 1;
-  contact.pointCount = 1;
-  contact.points.push(createContactPoint(1, 0.01));
-  contact.touching = true;
-  return contact;
-}
-
-function createUnitBox(world: Physics3DWorld): RigidBody3D {
-  const body = createRigidBody3D();
-  const mass = createPhysics3DMassData();
-  computePhysics3DBoxMassData(0.5, 0.5, 0.5, 1, mass);
-  setRigidBody3DMassData(body, mass);
-  refreshRigidBody3DWorldInertia(body);
-  addPhysics3DBody(world, body);
-  return body;
-}
-
-// The solver reads the SOLVE ISLAND contact slices rather than `world.contacts`, so a world assembled
-// by hand needs the same workspace `stepPhysics3D` builds before it reaches the solver. Without it every
-// prepare finds nothing to do — which is the correct answer for a world with no awake islands, and the
-// reason this is a factory step rather than something prepare rebuilds for itself.
-//
-// A test that changes what belongs in an island AFTER this — putting a body to sleep, disabling a
-// contact, making a body static — has to call it again, exactly as a real step rebuilds every step.
-function buildSolveWorkspace(world: Physics3DWorld): Physics3DWorld {
-  updatePhysics3DSleep(world, 1 / 60);
-  buildPhysics3DSolveIslands(world);
-  return world;
-}
-
-// One dynamic box whose single contact point references a body that is not in the world's contact
-// partner slot — used for the basis and mass-denominator tests, where only body A matters.
-function createFallingBoxWorld(): Physics3DWorld {
-  const world = createPhysics3DWorld();
-  const box = createUnitBox(world);
-  const other = createUnitBox(world);
-  world.contacts.push(createContact(box.index, other.index));
-  return buildSolveWorkspace(world);
-}
-
-// Two unit boxes with REAL colliders, overlapping vertically by `depth`, with contacts generated the
-// way a step generates them. The position pass reads geometry, so this is the only fixture shape its
-// tests can be written against.
-function createOverlappingBoxWorld(depth: number): Physics3DWorld {
-  const world = createPhysics3DWorld();
-  const upper = createUnitBox(world);
-  const lower = createUnitBox(world);
-  setPhysics3DBodyType(lower, 'static');
-  for (const body of [upper, lower]) {
-    addPhysics3DCollider(
-      world,
-      body,
-      createPhysics3DCollider({ kind: 'aabb', minX: -0.5, minY: -0.5, minZ: -0.5, maxX: 0.5, maxY: 0.5, maxZ: 0.5 }),
-    );
-  }
-  upper.y = 1 - depth;
-  buildPhysics3DContacts(world);
-  return buildSolveWorkspace(world);
-}
-
-function createBoxOnGroundWorld(): Physics3DWorld {
-  const world = createPhysics3DWorld();
-  const box = createUnitBox(world);
-  const ground = createUnitBox(world);
-  setPhysics3DBodyType(ground, 'static');
-  world.contacts.push(createContact(box.index, ground.index));
-  return buildSolveWorkspace(world);
-}
-
-function createTwoDynamicBodyWorld(): Physics3DWorld {
-  const world = createPhysics3DWorld();
-  const upper = createUnitBox(world);
-  const lower = createUnitBox(world);
-  world.contacts.push(createContact(upper.index, lower.index));
-  return buildSolveWorkspace(world);
-}

package/src/world.test.ts

@@ -15,6 +15,7 @@ import { addPhysics3DJoint } from './jointRegistry';
 import { computePhysics3DSphereMassData, createPhysics3DMassData, setRigidBody3DMassData } from './massProperties';
 import { registerBuiltInPhysics3DJointSolvers } from './registerBuiltInPhysics3DJointSolvers';
 import {
+  Physics3DWorldVersion,
   addPhysics3DBody,
   addPhysics3DCollider,
   applyPhysics3DForce,
@@ -29,8 +30,10 @@ import {
   createRigidBody3D,
   findPhysics3DBody,
   hydratePhysics3DWorld,
+  initializePhysics3DCollider,
+  initializePhysics3DWorld,
+  initializeRigidBody3D,
   invalidatePhysics3DCollider,
-  Physics3DWorldVersion,
   removePhysics3DBody,
   removePhysics3DCollider,
   setPhysics3DBodyBullet,
@@ -541,6 +544,24 @@ describe('hydratePhysics3DWorld', () => {
   });
 });
 
+describe('initializePhysics3DCollider', () => {
+  it('is the construction initializer of createPhysics3DCollider', () => {
+    expect(typeof initializePhysics3DCollider).toBe('function');
+  });
+});
+
+describe('initializePhysics3DWorld', () => {
+  it('is the construction initializer of createPhysics3DWorld', () => {
+    expect(typeof initializePhysics3DWorld).toBe('function');
+  });
+});
+
+describe('initializeRigidBody3D', () => {
+  it('is the construction initializer of createRigidBody3D', () => {
+    expect(typeof initializeRigidBody3D).toBe('function');
+  });
+});
+
 describe('invalidatePhysics3DCollider', () => {
   it('rebuilds the mass properties after the local shape is edited in place', () => {
     const world = createPhysics3DWorld();
@@ -763,6 +784,38 @@ describe('removePhysics3DCollider', () => {
   });
 });
 
+function contact(bodyA: number, bodyB: number): Physics3DWorld['contacts'][number] {
+  const value = createPhysics3DContact(bodyA, bodyB);
+  value.normalY = 1;
+  value.friction = 0.2;
+  value.touching = true;
+  return value;
+}
+
+function sphere(): RigidBody3D {
+  const body = createRigidBody3D();
+  const data = createPhysics3DMassData();
+  computePhysics3DSphereMassData(1, 1, data);
+  setRigidBody3DMassData(body, data);
+  return body;
+}
+
+beforeEach(() => {
+  registerBuiltInCollisionSupports3D();
+  registerBuiltInCollisionFaceQueries3D();
+});
+
+function colliderUnitBox(): CollisionBuiltInShape3D {
+  return { kind: 'aabb', minX: -0.5, minY: -0.5, minZ: -0.5, maxX: 0.5, maxY: 0.5, maxZ: 0.5 };
+}
+
+function addColliderTestBody(world: Physics3DWorld, y = 0): RigidBody3D {
+  const body = createRigidBody3D('dynamic');
+  body.y = y;
+  addPhysics3DBody(world, body);
+  return body;
+}
+
 describe('setPhysics3DBodyBullet', () => {
   it('changes continuous-collision policy and wakes an owned body', () => {
     const world = createPhysics3DWorld();
@@ -843,38 +896,6 @@ describe('setPhysics3DBodySleepEnabled', () => {
   });
 });
 
-function contact(bodyA: number, bodyB: number): Physics3DWorld['contacts'][number] {
-  const value = createPhysics3DContact(bodyA, bodyB);
-  value.normalY = 1;
-  value.friction = 0.2;
-  value.touching = true;
-  return value;
-}
-
-function sphere(): RigidBody3D {
-  const body = createRigidBody3D();
-  const data = createPhysics3DMassData();
-  computePhysics3DSphereMassData(1, 1, data);
-  setRigidBody3DMassData(body, data);
-  return body;
-}
-
-beforeEach(() => {
-  registerBuiltInCollisionSupports3D();
-  registerBuiltInCollisionFaceQueries3D();
-});
-
-function colliderUnitBox(): CollisionBuiltInShape3D {
-  return { kind: 'aabb', minX: -0.5, minY: -0.5, minZ: -0.5, maxX: 0.5, maxY: 0.5, maxZ: 0.5 };
-}
-
-function addColliderTestBody(world: Physics3DWorld, y = 0): RigidBody3D {
-  const body = createRigidBody3D('dynamic');
-  body.y = y;
-  addPhysics3DBody(world, body);
-  return body;
-}
-
 describe('setPhysics3DBodyTransform', () => {
   it('moves the body and refreshes the world inertia', () => {
     const body = sphere();
@@ -948,7 +969,6 @@ describe('setPhysics3DBodyTransform', () => {
     expect(neighbour.sleeping).toBe(false);
   });
 });
-
 describe('setPhysics3DBodyType', () => {
   it('declines to make a static terrain body movable', () => {
     const body = createRigidBody3D('static');

package/src/worldQueries.test.ts

@@ -14,6 +14,9 @@ import {
   createPhysics3DQueryResult,
   createPhysics3DRayResult,
   createPhysics3DShapeCastResult,
+  initializePhysics3DQueryResult,
+  initializePhysics3DRayResult,
+  initializePhysics3DShapeCastResult,
   queryPhysics3DPoint,
   queryPhysics3DRay,
   queryPhysics3DRayClosest,
@@ -81,6 +84,24 @@ describe('createPhysics3DShapeCastResult', () => {
   });
 });
 
+describe('initializePhysics3DQueryResult', () => {
+  it('is the construction initializer of createPhysics3DQueryResult', () => {
+    expect(typeof initializePhysics3DQueryResult).toBe('function');
+  });
+});
+
+describe('initializePhysics3DRayResult', () => {
+  it('is the construction initializer of createPhysics3DRayResult', () => {
+    expect(typeof initializePhysics3DRayResult).toBe('function');
+  });
+});
+
+describe('initializePhysics3DShapeCastResult', () => {
+  it('is the construction initializer of createPhysics3DShapeCastResult', () => {
+    expect(typeof initializePhysics3DShapeCastResult).toBe('function');
+  });
+});
+
 describe('queryPhysics3DPoint', () => {
   it('finds the collider containing the point', () => {
     const world = createPhysics3DWorld();
@@ -311,7 +332,6 @@ describe('queryPhysics3DRay', () => {
     expect(out.hits[0].fraction).toBeCloseTo(4.5, 6);
   });
 });
-
 describe('queryPhysics3DRayClosest', () => {
   it('writes only the nearest hit', () => {
     const world = createPhysics3DWorld();