@iwsdk/core 0.4.2 → 0.5.0

package/dist/physics/physicsBody.js

@@ -48,14 +48,53 @@ const PhysicsBody = createComponent('PhysicsBody', {
         enum: PhysicsState,
         default: PhysicsState.Dynamic,
     },
+    /**
+     * Linear velocity damping. Reactive: mutating it via
+     * `setValue(PhysicsBody, 'linearDamping', ...)` after the body is created is
+     * applied to the running simulation on the next frame.
+     */
     linearDamping: { type: Types.Float32, default: 0.0 },
+    /**
+     * Angular velocity damping. Reactive: mutating it via
+     * `setValue(PhysicsBody, 'angularDamping', ...)` after the body is created is
+     * applied to the running simulation on the next frame.
+     */
     angularDamping: { type: Types.Float32, default: 0.0 },
+    /**
+     * Per-body gravity multiplier (`0` floats, `1` is normal gravity). Reactive:
+     * mutating it via `setValue(PhysicsBody, 'gravityFactor', ...)` after the body
+     * is created is applied to the running simulation on the next frame.
+     */
     gravityFactor: { type: Types.Float32, default: 1.0 },
     centerOfMass: { type: Types.Vec3, default: [Infinity, Infinity, Infinity] },
     _linearVelocity: { type: Types.Vec3, default: [0.0, 0.0, 0.0] },
     _angularVelocity: { type: Types.Vec3, default: [0.0, 0.0, 0.0] },
     _engineBody: { type: Types.Float64, default: 0 },
     _engineOffset: { type: Types.Float64, default: 0 },
+    /**
+     * Last `gravityFactor` value pushed to the engine. Internal shadow used by
+     * the reactive sync to detect changes without reading back from Havok.
+     */
+    _engineGravityFactor: {
+        type: Types.Float32,
+        default: 1.0,
+    },
+    /**
+     * Last `linearDamping` value pushed to the engine. Internal shadow used by
+     * the reactive sync to detect changes without reading back from Havok.
+     */
+    _engineLinearDamping: {
+        type: Types.Float32,
+        default: 0.0,
+    },
+    /**
+     * Last `angularDamping` value pushed to the engine. Internal shadow used by
+     * the reactive sync to detect changes without reading back from Havok.
+     */
+    _engineAngularDamping: {
+        type: Types.Float32,
+        default: 0.0,
+    },
 }, 'Component to define physics behavior of an entity.');
 
 export { DEFAULT_ANGULAR_DAMPING, DEFAULT_GRAVITY_FACTOR, DEFAULT_LINEAR_DAMPING, PhysicsBody, PhysicsState };

package/dist/physics/physicsBody.js.map

@@ -1 +1 @@
-{"version":3,"file":"physicsBody.js","sources":["../../src/physics/physicsBody.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAIH;AACO,MAAM,YAAY,GAAG;AAC1B;AACwD;AACxD,IAAA,MAAM,EAAE,QAAQ;;AAEhB,IAAA,OAAO,EAAE,SAAS;AAClB;AACoI;AACpI,IAAA,SAAS,EAAE,WAAW;;AAGjB,MAAM,sBAAsB,GAAG;AAC/B,MAAM,uBAAuB,GAAG;AAChC,MAAM,sBAAsB,GAAG;AAEtC;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,WAAW,GAAG,eAAe,CACxC,aAAa,EACb;;AAEE,IAAA,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,YAAY,CAAC,OAAO;AAC9B,KAAA;IACD,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IACpD,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IACrD,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;AACpD,IAAA,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;AAC3E,IAAA,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;AAC/D,IAAA,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IAChE,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;IAChD,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;CACnD,EACD,oDAAoD;;;;"}
+{"version":3,"file":"physicsBody.js","sources":["../../src/physics/physicsBody.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAIH;AACO,MAAM,YAAY,GAAG;AAC1B;AACwD;AACxD,IAAA,MAAM,EAAE,QAAQ;;AAEhB,IAAA,OAAO,EAAE,SAAS;AAClB;AACoI;AACpI,IAAA,SAAS,EAAE,WAAW;;AAGjB,MAAM,sBAAsB,GAAG;AAC/B,MAAM,uBAAuB,GAAG;AAChC,MAAM,sBAAsB,GAAG;AAEtC;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,WAAW,GAAG,eAAe,CACxC,aAAa,EACb;;AAEE,IAAA,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,YAAY,CAAC,OAAO;AAC9B,KAAA;AACD;;;;AAIG;IACH,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;AACpD;;;;AAIG;IACH,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;AACrD;;;;AAIG;IACH,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;AACpD,IAAA,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;AAC3E,IAAA,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;AAC/D,IAAA,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IAChE,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;IAChD,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;AAClD;;;AAGG;AACH,IAAA,oBAAoB,EAAE;QACpB,IAAI,EAAE,KAAK,CAAC,OAAO;AACnB,QAAA,OAAO,EAAE,GAAG;AACb,KAAA;AACD;;;AAGG;AACH,IAAA,oBAAoB,EAAE;QACpB,IAAI,EAAE,KAAK,CAAC,OAAO;AACnB,QAAA,OAAO,EAAE,GAAG;AACb,KAAA;AACD;;;AAGG;AACH,IAAA,qBAAqB,EAAE;QACrB,IAAI,EAAE,KAAK,CAAC,OAAO;AACnB,QAAA,OAAO,EAAE,GAAG;AACb,KAAA;CACF,EACD,oDAAoD;;;;"}

package/dist/physics/physicsManipulation.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Types } from '.././index.js';
+import { Types } from '../ecs/component.js';
 /**
  * Component for applying one‑time physics manipulations to an entity.
  *

package/dist/physics/physicsManipulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physicsManipulation.d.ts","sourceRoot":"","sources":["../../src/physics/physicsManipulation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;EAQ/B,CAAC"}
+{"version":3,"file":"physicsManipulation.d.ts","sourceRoot":"","sources":["../../src/physics/physicsManipulation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;EAQ/B,CAAC"}

package/dist/physics/physicsShape.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Types } from '.././index.js';
+import { Types } from '../ecs/component.js';
 /** Available physics shape types for {@link PhysicsShape}. @category Physics */
 export declare const PhysicsShapeType: {
     /** The sphere is described by just the radius in dimensions[0]. Efficient for round objects. */
@@ -14,7 +14,8 @@ export declare const PhysicsShapeType: {
     /** A cylinder shape is defined by the radius in dimensions[0] and height in dimensions[1]. */
     readonly Cylinder: "Cylinder";
     /** Capsules are similar to cylinders, but have two half-spheres on each end.
-     * A Capsules shape is defined by the radius in dimensions[0] and height in dimensions[1]. */
+     * A Capsules shape uses radius in dimensions[0] and total end-to-end height in dimensions[1],
+     * which must be at least twice the radius. */
     readonly Capsules: "Capsules";
     /** A convex is a shape that, if two points are part of the shape, then the segment between these two points is
      * also part of the shape. The physics engine would creates a convex wrapper around the mesh. This is a great
@@ -85,7 +86,8 @@ export declare const PhysicsShape: import("elics").Component<{
             /** A cylinder shape is defined by the radius in dimensions[0] and height in dimensions[1]. */
             readonly Cylinder: "Cylinder";
             /** Capsules are similar to cylinders, but have two half-spheres on each end.
-             * A Capsules shape is defined by the radius in dimensions[0] and height in dimensions[1]. */
+             * A Capsules shape uses radius in dimensions[0] and total end-to-end height in dimensions[1],
+             * which must be at least twice the radius. */
             readonly Capsules: "Capsules";
             /** A convex is a shape that, if two points are part of the shape, then the segment between these two points is
              * also part of the shape. The physics engine would creates a convex wrapper around the mesh. This is a great

package/dist/physics/physicsShape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physicsShape.d.ts","sourceRoot":"","sources":["../../src/physics/physicsShape.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,eAAe,CAAC;AAEvD,gFAAgF;AAChF,eAAO,MAAM,gBAAgB;IAC3B,gGAAgG;;IAEhG,4GAA4G;;IAE5G,8FAA8F;;IAE9F;iGAC6F;;IAE7F;;uHAEmH;;IAEnH;mIAC+H;;IAE/H;;;;;;OAMG;;CAEK,CAAC;AAEX,eAAO,MAAM,eAAe,IAAM,CAAC;AACnC,eAAO,MAAM,mBAAmB,IAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,YAAY;IAGrB,oFAAoF;;;;YAvEtF,gGAAgG;;YAEhG,4GAA4G;;YAE5G,8FAA8F;;YAE9F;yGAC6F;;YAE7F;;+HAEmH;;YAEnH;2IAC+H;;YAE/H;;;;;;eAMG;;;;;IAuDD,sHAAsH;;;;;IAEtH,0EAA0E;;;;;IAE1E,2EAA2E;;;;;IAE3E,2DAA2D;;;;;;;;;EAK9D,CAAC"}
+{"version":3,"file":"physicsShape.d.ts","sourceRoot":"","sources":["../../src/physics/physicsShape.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAE7D,gFAAgF;AAChF,eAAO,MAAM,gBAAgB;IAC3B,gGAAgG;;IAEhG,4GAA4G;;IAE5G,8FAA8F;;IAE9F;;kDAE8C;;IAE9C;;uHAEmH;;IAEnH;mIAC+H;;IAE/H;;;;;;OAMG;;CAEK,CAAC;AAEX,eAAO,MAAM,eAAe,IAAM,CAAC;AACnC,eAAO,MAAM,mBAAmB,IAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,YAAY;IAGrB,oFAAoF;;;;YAxEtF,gGAAgG;;YAEhG,4GAA4G;;YAE5G,8FAA8F;;YAE9F;;0DAE8C;;YAE9C;;+HAEmH;;YAEnH;2IAC+H;;YAE/H;;;;;;eAMG;;;;;IAuDD,sHAAsH;;;;;IAEtH,0EAA0E;;;;;IAE1E,2EAA2E;;;;;IAE3E,2DAA2D;;;;;;;;;EAK9D,CAAC"}

package/dist/physics/physicsShape.js

@@ -15,7 +15,8 @@ const PhysicsShapeType = {
     /** A cylinder shape is defined by the radius in dimensions[0] and height in dimensions[1]. */
     Cylinder: 'Cylinder',
     /** Capsules are similar to cylinders, but have two half-spheres on each end.
-     * A Capsules shape is defined by the radius in dimensions[0] and height in dimensions[1]. */
+     * A Capsules shape uses radius in dimensions[0] and total end-to-end height in dimensions[1],
+     * which must be at least twice the radius. */
     Capsules: 'Capsules',
     /** A convex is a shape that, if two points are part of the shape, then the segment between these two points is
      * also part of the shape. The physics engine would creates a convex wrapper around the mesh. This is a great

package/dist/physics/physicsShape.js.map

@@ -1 +1 @@
-{"version":3,"file":"physicsShape.js","sources":["../../src/physics/physicsShape.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAIH;AACO,MAAM,gBAAgB,GAAG;;AAE9B,IAAA,MAAM,EAAE,QAAQ;;AAEhB,IAAA,GAAG,EAAE,KAAK;;AAEV,IAAA,QAAQ,EAAE,UAAU;AACpB;AAC6F;AAC7F,IAAA,QAAQ,EAAE,UAAU;AACpB;;AAEmH;AACnH,IAAA,UAAU,EAAE,YAAY;AACxB;AAC+H;AAC/H,IAAA,OAAO,EAAE,SAAS;AAClB;;;;;;AAMG;AACH,IAAA,IAAI,EAAE,MAAM;;AAGP,MAAM,eAAe,GAAG;AACxB,MAAM,mBAAmB,GAAG;AAC5B,MAAM,gBAAgB,GAAG;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACI,MAAM,YAAY,GAAG,eAAe,CACzC,cAAc,EACd;;AAEE,IAAA,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB,CAAC,IAAI;AAC/B,KAAA;;AAED,IAAA,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;;IAE1D,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;;IAE9C,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;;IAElD,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IAC/C,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;CAClD,EACD,iDAAiD;;;;"}
+{"version":3,"file":"physicsShape.js","sources":["../../src/physics/physicsShape.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAIH;AACO,MAAM,gBAAgB,GAAG;;AAE9B,IAAA,MAAM,EAAE,QAAQ;;AAEhB,IAAA,GAAG,EAAE,KAAK;;AAEV,IAAA,QAAQ,EAAE,UAAU;AACpB;;AAE8C;AAC9C,IAAA,QAAQ,EAAE,UAAU;AACpB;;AAEmH;AACnH,IAAA,UAAU,EAAE,YAAY;AACxB;AAC+H;AAC/H,IAAA,OAAO,EAAE,SAAS;AAClB;;;;;;AAMG;AACH,IAAA,IAAI,EAAE,MAAM;;AAGP,MAAM,eAAe,GAAG;AACxB,MAAM,mBAAmB,GAAG;AAC5B,MAAM,gBAAgB,GAAG;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACI,MAAM,YAAY,GAAG,eAAe,CACzC,cAAc,EACd;;AAEE,IAAA,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB,CAAC,IAAI;AAC/B,KAAA;;AAED,IAAA,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;;IAE1D,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;;IAE9C,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;;IAElD,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IAC/C,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;CAClD,EACD,iDAAiD;;;;"}

package/dist/physics/utils.d.ts

@@ -5,6 +5,16 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { BufferGeometry, Object3D } from '../runtime/index.js';
+/**
+ * Build a sequential index buffer (`0, 1, 2, ...`) for a non-indexed geometry.
+ *
+ * Three.js `BufferGeometry.index` is `null` for non-indexed geometry, where the
+ * position attribute already lists vertices in triangle order. Tri-mesh
+ * colliders need an explicit index list, so synthesize the implicit one.
+ *
+ * @param vertexCount Number of vertices (i.e. `geometry.attributes.position.count`).
+ */
+export declare function sequentialIndices(vertexCount: number): Uint32Array;
 export interface ShapeDetectionResult {
     shapeType: string;
     dimensions: [number, number, number] | null;

package/dist/physics/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/physics/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,cAAc,EAEd,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAW7B,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GACjB,oBAAoB,CAsEtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GACjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA+B1B;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAuBzE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/physics/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,cAAc,EAEd,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAW7B;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAMlE;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GACjB,oBAAoB,CAiFtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GACjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA+B1B;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CA6BzE"}

package/dist/physics/utils.js

@@ -15,67 +15,95 @@ const tempQuat = new Quaternion();
 const tempMatrix = new Matrix4();
 const tempMatrix2 = new Matrix4();
 const UNIT_SCALE = new Vector3(1, 1, 1);
+/**
+ * Build a sequential index buffer (`0, 1, 2, ...`) for a non-indexed geometry.
+ *
+ * Three.js `BufferGeometry.index` is `null` for non-indexed geometry, where the
+ * position attribute already lists vertices in triangle order. Tri-mesh
+ * colliders need an explicit index list, so synthesize the implicit one.
+ *
+ * @param vertexCount Number of vertices (i.e. `geometry.attributes.position.count`).
+ */
+function sequentialIndices(vertexCount) {
+    const indices = new Uint32Array(vertexCount);
+    for (let i = 0; i < vertexCount; i++) {
+        indices[i] = i;
+    }
+    return indices;
+}
 /**
  * Automatically detects the best physics shape type and calculates dimensions based on the entity's Three.js geometry
  */
 function detectShapeFromGeometry(object3D) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    // When object3D is not a Mesh we build a merged geometry purely to inspect
+    // it; it must be disposed before returning so shape auto-detection doesn't
+    // leak one merged geometry per call. A Mesh's own geometry stays in use and
+    // is never owned here. The try/finally guarantees disposal on every return.
+    const ownsGeometry = !(object3D instanceof Mesh);
     const geometry = object3D instanceof Mesh
         ? object3D.geometry
         : generateMergedGeometry(object3D);
-    // Check for specific geometry types and calculate their dimensions
-    if (geometry instanceof SphereGeometry) {
-        const radius = (_a = geometry.parameters.radius) !== null && _a !== void 0 ? _a : 1;
-        return {
-            shapeType: PhysicsShapeType.Sphere,
-            dimensions: [radius, 0, 0], // Only radius is needed for sphere
-        };
-    }
-    if (geometry instanceof BoxGeometry) {
-        const width = (_b = geometry.parameters.width) !== null && _b !== void 0 ? _b : 1;
-        const height = (_c = geometry.parameters.height) !== null && _c !== void 0 ? _c : 1;
-        const depth = (_d = geometry.parameters.depth) !== null && _d !== void 0 ? _d : 1;
-        return {
-            shapeType: PhysicsShapeType.Box,
-            dimensions: [width, height, depth],
-        };
-    }
-    if (geometry instanceof PlaneGeometry) {
-        const width = (_e = geometry.parameters.width) !== null && _e !== void 0 ? _e : 1;
-        const height = (_f = geometry.parameters.height) !== null && _f !== void 0 ? _f : 1;
-        const thickness = 0.01; // Thin plane
+    try {
+        // Check for specific geometry types and calculate their dimensions
+        if (geometry instanceof SphereGeometry) {
+            const radius = (_a = geometry.parameters.radius) !== null && _a !== void 0 ? _a : 1;
+            return {
+                shapeType: PhysicsShapeType.Sphere,
+                dimensions: [radius, 0, 0], // Only radius is needed for sphere
+            };
+        }
+        if (geometry instanceof BoxGeometry) {
+            const width = (_b = geometry.parameters.width) !== null && _b !== void 0 ? _b : 1;
+            const height = (_c = geometry.parameters.height) !== null && _c !== void 0 ? _c : 1;
+            const depth = (_d = geometry.parameters.depth) !== null && _d !== void 0 ? _d : 1;
+            return {
+                shapeType: PhysicsShapeType.Box,
+                dimensions: [width, height, depth],
+            };
+        }
+        if (geometry instanceof PlaneGeometry) {
+            const width = (_e = geometry.parameters.width) !== null && _e !== void 0 ? _e : 1;
+            const height = (_f = geometry.parameters.height) !== null && _f !== void 0 ? _f : 1;
+            const thickness = 0.01; // Thin plane
+            return {
+                shapeType: PhysicsShapeType.Box,
+                dimensions: [width, height, thickness],
+            };
+        }
+        if (geometry instanceof CylinderGeometry) {
+            const radiusTop = (_g = geometry.parameters.radiusTop) !== null && _g !== void 0 ? _g : 1;
+            const radiusBottom = (_h = geometry.parameters.radiusBottom) !== null && _h !== void 0 ? _h : 1;
+            if (radiusTop !== radiusBottom) {
+                console.warn('PhysicsSystem: detected cylinder with different radiusTop and radiusBottom. Using average radius for the physics shape.');
+            }
+            const height = (_j = geometry.parameters.height) !== null && _j !== void 0 ? _j : 1;
+            const avgRadius = (radiusTop + radiusBottom) / 2;
+            return {
+                shapeType: PhysicsShapeType.Cylinder,
+                dimensions: [avgRadius, height, 0], // Approximate bounding dimensions
+            };
+        }
+        // For generic BufferGeometry, fall back to the default ConvexHull shape type for better perf
+        if (geometry instanceof BufferGeometry) {
+            console.log(`PhysicsSystem: BufferGeometry detected for object ${object3D}, using ConvexHull.`);
+            return {
+                shapeType: PhysicsShapeType.ConvexHull,
+                dimensions: null,
+            };
+        }
+        // Fallback for unknown geometry types
+        console.warn(`PhysicsSystem: Unknown geometry type for object ${object3D}, falling back to Box`);
         return {
             shapeType: PhysicsShapeType.Box,
-            dimensions: [width, height, thickness],
+            dimensions: calculateObject3DBounds(object3D),
         };
     }
-    if (geometry instanceof CylinderGeometry) {
-        const radiusTop = (_g = geometry.parameters.radiusTop) !== null && _g !== void 0 ? _g : 1;
-        const radiusBottom = (_h = geometry.parameters.radiusBottom) !== null && _h !== void 0 ? _h : 1;
-        if (radiusTop !== radiusBottom) {
-            console.warn('PhysicsSystem: detected cylinder with different radiusTop and radiusBottom. Using average radius for the physics shape.');
+    finally {
+        if (ownsGeometry) {
+            geometry.dispose();
         }
-        const height = (_j = geometry.parameters.height) !== null && _j !== void 0 ? _j : 1;
-        const avgRadius = (radiusTop + radiusBottom) / 2;
-        return {
-            shapeType: PhysicsShapeType.Cylinder,
-            dimensions: [avgRadius, height, 0], // Approximate bounding dimensions
-        };
-    }
-    // For generic BufferGeometry, fall back to the default ConvexHull shape type for better perf
-    if (geometry instanceof BufferGeometry) {
-        console.log(`PhysicsSystem: BufferGeometry detected for object ${object3D}, using ConvexHull.`);
-        return {
-            shapeType: PhysicsShapeType.ConvexHull,
-            dimensions: null,
-        };
     }
-    // Fallback for unknown geometry types
-    console.warn(`PhysicsSystem: Unknown geometry type for object ${object3D}, falling back to Box`);
-    return {
-        shapeType: PhysicsShapeType.Box,
-        dimensions: calculateObject3DBounds(object3D),
-    };
 }
 /**
  * Calculates bounding box dimensions from Object3D for fallback cases
@@ -120,11 +148,17 @@ function generateMergedGeometry(object3D) {
         }
     });
     const mergedGeometry = mergeGeometries(geometries);
+    // The per-child clones were only working copies for the merge; their data is
+    // now copied into mergedGeometry, so free them to avoid leaking a clone of
+    // every child geometry each time a merged collider is built.
+    for (const geometry of geometries) {
+        geometry.dispose();
+    }
     tempMatrix2.copy(tempMatrix).invert();
     mergedGeometry.applyMatrix4(tempMatrix2);
     object3D.matrixWorld.copy(tempMatrix);
     return mergedGeometry;
 }
 
-export { calculateObject3DBounds, detectShapeFromGeometry, generateMergedGeometry };
+export { calculateObject3DBounds, detectShapeFromGeometry, generateMergedGeometry, sequentialIndices };
 //# sourceMappingURL=utils.js.map

package/dist/physics/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../src/physics/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sources":["../../src/physics/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/project/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export * from './normalize.js';
+export * from './paths.js';
+export * from './types.js';
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/project/index.js

@@ -0,0 +1,5 @@
+export { normalizeProjectDevOptions, normalizeProjectModuleSourcePath, normalizeProjectWorldOptions, projectRegexSpecToRegExp } from './normalize.js';
+export { ProjectSourcePathError, normalizeProjectSourcePath, projectSceneSourcePathToRuntimeUrl } from './paths.js';
+export { IWSDK_PROJECT_MANIFEST_VERSION } from './types.js';
+export { ProjectManifestValidationError, assertValidIwsdkProjectManifest, isIwsdkProjectManifest, validateIwsdkProjectManifest } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/project/normalize.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { NormalizedProjectDevOptions, NormalizedProjectWorldOptions, ProjectRegexSpec } from './types.js';
+/**
+ * Normalize the JSON-safe world contract into the existing `World.create`
+ * option shape. Asset and component values are intentionally not injected.
+ */
+export declare function normalizeProjectWorldOptions(value: unknown): NormalizedProjectWorldOptions;
+/** Normalize manifest-owned development settings for Vite/plugin consumers. */
+export declare function normalizeProjectDevOptions(value: unknown): NormalizedProjectDevOptions;
+/** Normalize an assets/components module declaration for Vite resolution. */
+export declare function normalizeProjectModuleSourcePath(sourcePath: string): string;
+/** Reconstruct a validated JSON regular-expression declaration. */
+export declare function projectRegexSpecToRegExp(spec: ProjectRegexSpec): RegExp;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/project/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/project/normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAEV,2BAA2B,EAC3B,6BAA6B,EAE7B,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAUpB;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,6BAA6B,CAwC/B;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,2BAA2B,CAyC7B;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAEvE"}

package/dist/project/normalize.js

@@ -0,0 +1,206 @@
+import { normalizeProjectSourcePath, projectSceneSourcePathToRuntimeUrl } from './paths.js';
+import { assertValidIwsdkProjectManifest } from './validation.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const TURNING_METHOD = {
+    snap: 1,
+    smooth: 2,
+};
+/**
+ * Normalize the JSON-safe world contract into the existing `World.create`
+ * option shape. Asset and component values are intentionally not injected.
+ */
+function normalizeProjectWorldOptions(value) {
+    assertValidIwsdkProjectManifest(value);
+    const manifest = value;
+    const source = manifest.world;
+    const xr = normalizeXR(source.xr);
+    return {
+        level: projectSceneSourcePathToRuntimeUrl(manifest.scene),
+        xr,
+        ...(source.input == null
+            ? {}
+            : {
+                input: {
+                    ...(typeof source.input.canvasPointerEvents === 'object'
+                        ? {
+                            canvasPointerEvents: {
+                                ...source.input.canvasPointerEvents,
+                            },
+                        }
+                        : 'canvasPointerEvents' in source.input
+                            ? {
+                                canvasPointerEvents: source.input.canvasPointerEvents,
+                            }
+                            : {}),
+                },
+            }),
+        ...(source.render == null
+            ? {}
+            : {
+                render: {
+                    ...source.render,
+                    ...(source.render.camera == null
+                        ? {}
+                        : { camera: { ...source.render.camera } }),
+                },
+            }),
+        ...(source.features == null
+            ? {}
+            : { features: normalizeFeatures(source.features) }),
+    };
+}
+/** Normalize manifest-owned development settings for Vite/plugin consumers. */
+function normalizeProjectDevOptions(value) {
+    assertValidIwsdkProjectManifest(value);
+    const manifest = value;
+    const dev = manifest.dev;
+    if (dev == null) {
+        return {};
+    }
+    const sourceEmulator = dev.emulator;
+    const emulator = sourceEmulator == null
+        ? undefined
+        : {
+            ...(sourceEmulator.device == null
+                ? {}
+                : { device: sourceEmulator.device }),
+            ...(sourceEmulator.iwer == null ? {} : { iwer: sourceEmulator.iwer }),
+            ...(sourceEmulator.environment == null
+                ? {}
+                : { environment: sourceEmulator.environment }),
+            ...(sourceEmulator.activation == null
+                ? {}
+                : {
+                    activation: typeof sourceEmulator.activation === 'object'
+                        ? projectRegexSpecToRegExp(sourceEmulator.activation)
+                        : sourceEmulator.activation,
+                }),
+            ...(sourceEmulator.injectOnBuild == null
+                ? {}
+                : { injectOnBuild: sourceEmulator.injectOnBuild }),
+            ...(sourceEmulator.userAgentException == null
+                ? {}
+                : {
+                    userAgentException: projectRegexSpecToRegExp(sourceEmulator.userAgentException),
+                }),
+        };
+    return {
+        ...(emulator == null ? {} : { emulator }),
+    };
+}
+/** Normalize an assets/components module declaration for Vite resolution. */
+function normalizeProjectModuleSourcePath(sourcePath) {
+    return normalizeProjectSourcePath(sourcePath, 'module');
+}
+/** Reconstruct a validated JSON regular-expression declaration. */
+function projectRegexSpecToRegExp(spec) {
+    var _a;
+    return new RegExp(spec.source, (_a = spec.flags) !== null && _a !== void 0 ? _a : '');
+}
+function normalizeXR(source) {
+    if (source === false) {
+        return false;
+    }
+    const sessionMode = (source.mode === 'vr' ? 'immersive-vr' : 'immersive-ar');
+    return {
+        sessionMode,
+        ...(source.offer == null ? {} : { offer: source.offer }),
+        ...(source.referenceSpace == null
+            ? {}
+            : {
+                referenceSpace: cloneReferenceSpace(source.referenceSpace),
+            }),
+        ...(source.restoreCameraOnExit == null
+            ? {}
+            : { restoreCameraOnExit: source.restoreCameraOnExit }),
+        ...(source.features == null
+            ? {}
+            : { features: cloneXRFeatures(source.features) }),
+    };
+}
+function cloneReferenceSpace(source) {
+    return typeof source === 'string'
+        ? source
+        : {
+            ...source,
+            ...(source.fallbackOrder == null
+                ? {}
+                : { fallbackOrder: [...source.fallbackOrder] }),
+        };
+}
+function cloneXRFeatures(source) {
+    return Object.fromEntries(Object.entries(source).map(([key, value]) => [
+        key,
+        value != null && typeof value === 'object' ? { ...value } : value,
+    ]));
+}
+function normalizeFeatures(source) {
+    const features = {};
+    if (source.locomotion != null) {
+        if (typeof source.locomotion === 'boolean') {
+            features.locomotion = source.locomotion;
+        }
+        else {
+            const { browserControls, initialPlayerPosition, turningMethod, ...rest } = source.locomotion;
+            features.locomotion = {
+                ...rest,
+                ...(initialPlayerPosition == null
+                    ? {}
+                    : {
+                        initialPlayerPosition: [...initialPlayerPosition],
+                    }),
+                ...(typeof browserControls === 'object'
+                    ? {
+                        browserControls: {
+                            ...browserControls,
+                        },
+                    }
+                    : browserControls == null
+                        ? {}
+                        : { browserControls }),
+                ...(turningMethod == null
+                    ? {}
+                    : {
+                        turningMethod: TURNING_METHOD[turningMethod],
+                    }),
+            };
+        }
+    }
+    if (source.grabbing != null) {
+        features.grabbing =
+            typeof source.grabbing === 'boolean'
+                ? source.grabbing
+                : { ...source.grabbing };
+    }
+    if (source.physics != null) {
+        features.physics = source.physics;
+    }
+    if (source.sceneUnderstanding != null) {
+        features.sceneUnderstanding =
+            typeof source.sceneUnderstanding === 'boolean'
+                ? source.sceneUnderstanding
+                : { ...source.sceneUnderstanding };
+    }
+    if (source.environmentRaycast != null) {
+        features.environmentRaycast = source.environmentRaycast;
+    }
+    if (source.camera != null) {
+        features.camera = source.camera;
+    }
+    if (source.spatialUI != null) {
+        features.spatialUI =
+            typeof source.spatialUI === 'boolean'
+                ? source.spatialUI
+                : { ...source.spatialUI };
+    }
+    return features;
+}
+
+export { normalizeProjectDevOptions, normalizeProjectModuleSourcePath, normalizeProjectWorldOptions, projectRegexSpecToRegExp };
+//# sourceMappingURL=normalize.js.map

package/dist/project/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sources":["../../src/project/normalize.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/project/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export type ProjectSourcePathKind = 'module' | 'scene';
+/** Error raised when a project source path is not lexically root-confined. */
+export declare class ProjectSourcePathError extends Error {
+    readonly sourcePath: string;
+    readonly kind: ProjectSourcePathKind;
+    constructor(sourcePath: string, kind: ProjectSourcePathKind, message: string);
+}
+/**
+ * Validate and normalize a project-owned source path without filesystem or
+ * Node dependencies. Returned paths always begin with `./` and use `/`.
+ */
+export declare function normalizeProjectSourcePath(sourcePath: string, kind: ProjectSourcePathKind): string;
+/** Convert a validated public scene source path into its runtime URL. */
+export declare function projectSceneSourcePathToRuntimeUrl(sourcePath: string): string;
+//# sourceMappingURL=paths.d.ts.map