mage-engine 3.25.6 → 3.25.8

package/dist/mage.js

@@ -56057,6 +56057,34 @@ const parseBoundingBoxSize = (boundingBox = {}) => {
     };
   }
 };
+
+/**
+ * Compute the world-space AABB size for a body using Box3.setFromObject().
+ * Returns { width, height, length } or null if the box is degenerate (all zeros).
+ */
+const getWorldBoundingBoxSize = body => {
+  const worldBox = new Box3().setFromObject(body);
+  const worldSize = new Vector3$1();
+  worldBox.getSize(worldSize);
+  if (worldSize.x === 0 && worldSize.y === 0 && worldSize.z === 0) {
+    return null;
+  }
+  return {
+    width: worldSize.x,
+    height: worldSize.y,
+    length: worldSize.z
+  };
+};
+
+/**
+ * Derive a bounding sphere radius from the world-space AABB.
+ * Returns the radius (half the longest axis) or null if the box is degenerate.
+ */
+const getWorldBoundingSphereRadius = body => {
+  const size = getWorldBoundingBoxSize(body);
+  if (!size) return null;
+  return Math.max(size.width, size.height, size.length) / 2;
+};
 const extractPositionAndQuaternion$1 = element => {
   const {
     x,
@@ -56099,29 +56127,24 @@ const extractBoxDescription = element => {
 // More accurate for imported models whose geometry may be offset from the
 // element origin, but can produce unexpected results for complex hierarchies.
 const extractWorldBoxDescription = element => {
-  const body = element.getBody();
-  const worldBox = new Box3().setFromObject(body);
-  const worldSize = new Vector3$1();
-  worldBox.getSize(worldSize);
+  const size = getWorldBoundingBoxSize(element.getBody());
 
   // Fall back to the legacy path if the world box is degenerate.
-  if (worldSize.x === 0 && worldSize.y === 0 && worldSize.z === 0) {
+  if (!size) {
     return extractBoxDescription(element);
   }
   return {
-    width: worldSize.x,
-    height: worldSize.y,
-    length: worldSize.z,
+    ...size,
     size: {
-      x: worldSize.x,
-      y: worldSize.y,
-      z: worldSize.z
+      x: size.width,
+      y: size.height,
+      z: size.length
     },
     ...extractPositionAndQuaternion$1(element)
   };
 };
 const extractSphereDescription = element => {
-  const radius = element.boundingSphere.radius;
+  const radius = getWorldBoundingSphereRadius(element.getBody()) ?? element.boundingSphere.radius;
   return {
     radius,
     ...extractPositionAndQuaternion$1(element)
@@ -56140,7 +56163,7 @@ const getSphereDescriptionForElement = element => ({
 });
 const getPlayerDescriptionForElement = element => ({
   ...DEFAULT_PLAYER_DESCRIPTION,
-  ...extractBoxDescription(element)
+  ...extractWorldBoxDescription(element)
 });
 const mapColliderTypeToDescription$1 = (colliderType = COLLIDER_TYPES$2.BOX) => ({
   [COLLIDER_TYPES$2.BOX]: getBoxDescriptionForElement$1,
@@ -56179,7 +56202,7 @@ const convertAmmoVector = ({
   x: z,
   y,
   z: x
-});var physicsUtils=/*#__PURE__*/Object.freeze({__proto__:null,DEFAULT_DESCRIPTION:DEFAULT_DESCRIPTION$1,mapColliderTypeToAddEvent:mapColliderTypeToAddEvent$1,extractBoundingBox:extractBoundingBox,extractBiggestBoundingBox:extractBiggestBoundingBox,extractBoundingSphere:extractBoundingSphere,extractBiggestBoundingSphere:extractBiggestBoundingSphere,parseBoundingBoxSize:parseBoundingBoxSize,extractPositionAndQuaternion:extractPositionAndQuaternion$1,extractBoxDescription:extractBoxDescription,extractSphereDescription:extractSphereDescription,getBoxDescriptionForElement:getBoxDescriptionForElement$1,getSphereDescriptionForElement:getSphereDescriptionForElement,getPlayerDescriptionForElement:getPlayerDescriptionForElement,mapColliderTypeToDescription:mapColliderTypeToDescription$1,iterateGeometries:iterateGeometries$1,convertAmmoVector:convertAmmoVector});const getHostURL = () => `${document.location.protocol}//${document.location.host}`;
+});var physicsUtils=/*#__PURE__*/Object.freeze({__proto__:null,DEFAULT_DESCRIPTION:DEFAULT_DESCRIPTION$1,mapColliderTypeToAddEvent:mapColliderTypeToAddEvent$1,extractBoundingBox:extractBoundingBox,extractBiggestBoundingBox:extractBiggestBoundingBox,extractBoundingSphere:extractBoundingSphere,extractBiggestBoundingSphere:extractBiggestBoundingSphere,parseBoundingBoxSize:parseBoundingBoxSize,getWorldBoundingBoxSize:getWorldBoundingBoxSize,getWorldBoundingSphereRadius:getWorldBoundingSphereRadius,extractPositionAndQuaternion:extractPositionAndQuaternion$1,extractBoxDescription:extractBoxDescription,extractSphereDescription:extractSphereDescription,getBoxDescriptionForElement:getBoxDescriptionForElement$1,getSphereDescriptionForElement:getSphereDescriptionForElement,getPlayerDescriptionForElement:getPlayerDescriptionForElement,mapColliderTypeToDescription:mapColliderTypeToDescription$1,iterateGeometries:iterateGeometries$1,convertAmmoVector:convertAmmoVector});const getHostURL = () => `${document.location.protocol}//${document.location.host}`;
 const {
   COLLIDER_TYPES: COLLIDER_TYPES$1
 } = PHYSICS_CONSTANTS;
@@ -56520,13 +56543,22 @@ let Physics = /*#__PURE__*/function (_EventDispatcher) {
     value: function add(element, options = {}) {
       if (Config$1.physics().enabled) {
         const {
-          colliderType = COLLIDER_TYPES$1.BOX
+          colliderType = COLLIDER_TYPES$1.BOX,
+          colliderWidth,
+          colliderHeight,
+          colliderLength,
+          colliderRadius,
+          ...rest
         } = options;
         const uuid = element.uuid();
         const description = {
           ...mapColliderTypeToDescription(colliderType)(element),
-          ...options
+          ...rest
         };
+        if (colliderWidth != null) description.width = colliderWidth;
+        if (colliderHeight != null) description.height = colliderHeight;
+        if (colliderLength != null) description.length = colliderLength;
+        if (colliderRadius != null) description.radius = colliderRadius;
         this.storeElement(element, options);
         this.worker.postMessage({
           event: mapColliderTypeToAddEvent(description.collider),
@@ -58125,10 +58157,11 @@ var Physics$1 = new Physics();let Orbit = /*#__PURE__*/function (_EventDispatche
     _this.gizmo = new Gizmo();
     _this.plane = new TransformControlsPlane();
 
-    // Set gizmo and plane to layer 1 ONLY so mirrors don't render them
-    // Main camera must enable layer 1 to see these
-    _this.gizmo.layers.set(1);
-    _this.plane.layers.set(1);
+    // Set gizmo and plane to layer 2 ONLY so they render in a dedicated pass
+    // on top of everything (sky, post-processing, etc.)
+    // Layer 1 = editor helpers (togglable), Layer 2 = gizmo (always visible)
+    _this.gizmo.layers.set(2);
+    _this.plane.layers.set(2);
 
     // Helper function to set depth properties on materials
     const setMaterialDepth = material => {
@@ -58142,15 +58175,15 @@ var Physics$1 = new Physics();let Orbit = /*#__PURE__*/function (_EventDispatche
       });
     };
 
-    // Also set layer 1 on all children recursively
-    // Set high renderOrder and disable depthTest so gizmos render on top of sky/water
+    // Also set layer 2 on all children recursively
+    // Disable depthTest so gizmos render on top of everything
     _this.gizmo.traverse(child => {
-      child.layers.set(1);
+      child.layers.set(2);
       child.renderOrder = 999;
       setMaterialDepth(child.material);
     });
     _this.plane.traverse(child => {
-      child.layers.set(1);
+      child.layers.set(2);
       child.renderOrder = 999;
       setMaterialDepth(child.material);
     });
@@ -58191,8 +58224,8 @@ var Physics$1 = new Physics();let Orbit = /*#__PURE__*/function (_EventDispatche
     _this.setAndDispatch("showY", true);
     _this.setAndDispatch("showZ", true);
     _this.ray = new Raycaster();
-    // Enable layer 1 so raycaster can pick gizmo objects (which are on layer 1)
-    _this.ray.layers.enable(1);
+    // Enable layer 2 so raycaster can pick gizmo objects (which are on layer 2)
+    _this.ray.layers.enable(2);
     _this._tempVector = new Vector3$1();
     _this._tempVector2 = new Vector3$1();
     _this._tempQuaternion = new Quaternion();
@@ -60103,10 +60136,12 @@ var Controls$1 = new Controls();let Scene = /*#__PURE__*/function () {
     key: "createCamera",
     value: function createCamera(camera) {
       this.camera = camera;
-      // Enable layer 1 so camera can see editor-only objects (helpers, grid, gizmos)
+      // Enable layer 1 so camera can see editor-only objects (helpers, grid)
+      // Enable layer 2 so camera can see gizmos (rendered in separate pass)
       // Mirror cameras only use layer 0, so they won't render these
       if (this.camera && this.camera.getBody()) {
         this.camera.getBody().layers.enable(1);
+        this.camera.getBody().layers.enable(2);
       }
     }
   }, {
@@ -60204,6 +60239,53 @@ var Controls$1 = new Controls();let Scene = /*#__PURE__*/function () {
       this.renderer.setRenderTarget(null);
       this.renderer.render(this.scene, this.camera.getBody());
     }
+
+    // Render gizmo layer (layer 2) on top of everything.
+    // Called after main render or post-processing to ensure gizmos are always visible
+    // regardless of sky, post-processing, or sortObjects setting.
+  }, {
+    key: "renderGizmoLayer",
+    value: function renderGizmoLayer() {
+      if (!this.renderer || !this.camera) return;
+      const cameraBody = this.camera.getBody();
+
+      // Save current camera layer mask
+      const savedLayers = cameraBody.layers.mask;
+
+      // Set camera to only see layer 2 (gizmo layer)
+      cameraBody.layers.set(2);
+
+      // Ensure we render to screen (not a post-processing buffer)
+      this.renderer.setRenderTarget(null);
+      // Clear only depth so gizmo renders on top of the already-drawn frame
+      this.renderer.autoClear = false;
+      this.renderer.clearDepth();
+      this.renderer.render(this.scene, cameraBody);
+      this.renderer.autoClear = true;
+
+      // Restore camera layers
+      cameraBody.layers.mask = savedLayers;
+    }
+
+    // Toggle editor helpers visibility (layer 1: grid, light helpers, camera helpers)
+    // Does NOT affect gizmos (layer 2) which are always visible
+  }, {
+    key: "setHelpersVisible",
+    value: function setHelpersVisible(visible) {
+      if (!this.camera || !this.camera.getBody()) return;
+      const cameraBody = this.camera.getBody();
+      if (visible) {
+        cameraBody.layers.enable(1);
+      } else {
+        cameraBody.layers.disable(1);
+      }
+      this.helpersVisible = visible;
+    }
+  }, {
+    key: "getHelpersVisible",
+    value: function getHelpersVisible() {
+      return this.helpersVisible !== false;
+    }
   }, {
     key: "setFog",
     value: function setFog(color, density) {
@@ -61301,7 +61383,7 @@ function applyMiddleware() {
 
 var thunk = createThunkMiddleware();
 thunk.withExtraArgument = createThunkMiddleware;var name = "mage-engine";
-var version$1 = "3.25.6";
+var version$1 = "3.25.8";
 var description = "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.";
 var main = "dist/mage.js";
 var author$1 = {
@@ -64742,6 +64824,33 @@ let Element$1 = /*#__PURE__*/function (_Entity) {
         setUpLightsAndShadows(this.getBody());
       }
     }
+  }, {
+    key: "getComputedColliderSize",
+    value: function getComputedColliderSize() {
+      const result = {};
+      try {
+        const body = this.getBody();
+        const worldSize = body ? getWorldBoundingBoxSize(body) : null;
+        if (worldSize) {
+          result.width = parseFloat(worldSize.width.toFixed(3));
+          result.height = parseFloat(worldSize.height.toFixed(3));
+          result.length = parseFloat(worldSize.length.toFixed(3));
+          result.radius = parseFloat(getWorldBoundingSphereRadius(body).toFixed(3));
+        } else if (this.boundingBox) {
+          const size = parseBoundingBoxSize(this.boundingBox);
+          const scale = this.getScale();
+          result.width = parseFloat((size.x * scale.x).toFixed(3));
+          result.height = parseFloat((size.y * scale.y).toFixed(3));
+          result.length = parseFloat((size.z * scale.z).toFixed(3));
+        }
+        if (result.radius == null && this.boundingSphere) {
+          result.radius = parseFloat(this.boundingSphere.radius.toFixed(3));
+        }
+      } catch {
+        // bounding box/sphere not yet available
+      }
+      return result;
+    }
   }, {
     key: "addToScene",
     value: function addToScene() {
@@ -65675,7 +65784,8 @@ let Element$1 = /*#__PURE__*/function (_Entity) {
           ..._superPropGet(Element, "toJSON", this, 3)([parseJSON]),
           // Physics options (state is not used by Importer, only options)
           physics: {
-            options: this.getPhysicsOptions()
+            options: this.getPhysicsOptions(),
+            computedSize: this.getComputedColliderSize()
           },
           // Textures with serialized map
           textures: serializeMap(this.textures),
@@ -92772,6 +92882,11 @@ let Level = /*#__PURE__*/function (_EventDispatcher) {
       } else {
         Scene$1.render(dt);
       }
+
+      // Render gizmo layer on top of everything (separate pass with depth clear)
+      // This ensures gizmos are always visible regardless of sky, post-processing,
+      // or the sortObjects=false setting used when shadows are enabled.
+      Scene$1.renderGizmoLayer();
       Particles$1.update(dt);
       this.onUpdate(dt);
       Scene$1.update(dt);
@@ -98062,7 +98177,877 @@ let Sound = /*#__PURE__*/function (_Entity) {
       });
     }
   }]);
-}(Entity);const BLOB_TYPE = "application/javascript";
+}(Entity);var LineSegmentsGeometry = function () {
+
+	InstancedBufferGeometry.call( this );
+
+	this.type = 'LineSegmentsGeometry';
+
+	var positions = [ - 1, 2, 0, 1, 2, 0, - 1, 1, 0, 1, 1, 0, - 1, 0, 0, 1, 0, 0, - 1, - 1, 0, 1, - 1, 0 ];
+	var uvs = [ - 1, 2, 1, 2, - 1, 1, 1, 1, - 1, - 1, 1, - 1, - 1, - 2, 1, - 2 ];
+	var index = [ 0, 2, 1, 2, 3, 1, 2, 4, 3, 4, 5, 3, 4, 6, 5, 6, 7, 5 ];
+
+	this.setIndex( index );
+	this.setAttribute( 'position', new Float32BufferAttribute( positions, 3 ) );
+	this.setAttribute( 'uv', new Float32BufferAttribute( uvs, 2 ) );
+
+};
+
+LineSegmentsGeometry.prototype = Object.assign( Object.create( InstancedBufferGeometry.prototype ), {
+
+	constructor: LineSegmentsGeometry,
+
+	isLineSegmentsGeometry: true,
+
+	applyMatrix4: function ( matrix ) {
+
+		var start = this.attributes.instanceStart;
+		var end = this.attributes.instanceEnd;
+
+		if ( start !== undefined ) {
+
+			start.applyMatrix4( matrix );
+
+			end.applyMatrix4( matrix );
+
+			start.needsUpdate = true;
+
+		}
+
+		if ( this.boundingBox !== null ) {
+
+			this.computeBoundingBox();
+
+		}
+
+		if ( this.boundingSphere !== null ) {
+
+			this.computeBoundingSphere();
+
+		}
+
+		return this;
+
+	},
+
+	setPositions: function ( array ) {
+
+		var lineSegments;
+
+		if ( array instanceof Float32Array ) {
+
+			lineSegments = array;
+
+		} else if ( Array.isArray( array ) ) {
+
+			lineSegments = new Float32Array( array );
+
+		}
+
+		var instanceBuffer = new InstancedInterleavedBuffer( lineSegments, 6, 1 ); // xyz, xyz
+
+		this.setAttribute( 'instanceStart', new InterleavedBufferAttribute( instanceBuffer, 3, 0 ) ); // xyz
+		this.setAttribute( 'instanceEnd', new InterleavedBufferAttribute( instanceBuffer, 3, 3 ) ); // xyz
+
+		//
+
+		this.computeBoundingBox();
+		this.computeBoundingSphere();
+
+		return this;
+
+	},
+
+	setColors: function ( array ) {
+
+		var colors;
+
+		if ( array instanceof Float32Array ) {
+
+			colors = array;
+
+		} else if ( Array.isArray( array ) ) {
+
+			colors = new Float32Array( array );
+
+		}
+
+		var instanceColorBuffer = new InstancedInterleavedBuffer( colors, 6, 1 ); // rgb, rgb
+
+		this.setAttribute( 'instanceColorStart', new InterleavedBufferAttribute( instanceColorBuffer, 3, 0 ) ); // rgb
+		this.setAttribute( 'instanceColorEnd', new InterleavedBufferAttribute( instanceColorBuffer, 3, 3 ) ); // rgb
+
+		return this;
+
+	},
+
+	fromWireframeGeometry: function ( geometry ) {
+
+		this.setPositions( geometry.attributes.position.array );
+
+		return this;
+
+	},
+
+	fromEdgesGeometry: function ( geometry ) {
+
+		this.setPositions( geometry.attributes.position.array );
+
+		return this;
+
+	},
+
+	fromMesh: function ( mesh ) {
+
+		this.fromWireframeGeometry( new WireframeGeometry( mesh.geometry ) );
+
+		// set colors, maybe
+
+		return this;
+
+	},
+
+	fromLineSegments: function ( lineSegments ) {
+
+		var geometry = lineSegments.geometry;
+
+		if ( geometry.isGeometry ) {
+
+			console.error( 'THREE.LineSegmentsGeometry no longer supports Geometry. Use THREE.BufferGeometry instead.' );
+			return;
+
+		} else if ( geometry.isBufferGeometry ) {
+
+			this.setPositions( geometry.attributes.position.array ); // assumes non-indexed
+
+		}
+
+		// set colors, maybe
+
+		return this;
+
+	},
+
+	computeBoundingBox: function () {
+
+		var box = new Box3();
+
+		return function computeBoundingBox() {
+
+			if ( this.boundingBox === null ) {
+
+				this.boundingBox = new Box3();
+
+			}
+
+			var start = this.attributes.instanceStart;
+			var end = this.attributes.instanceEnd;
+
+			if ( start !== undefined && end !== undefined ) {
+
+				this.boundingBox.setFromBufferAttribute( start );
+
+				box.setFromBufferAttribute( end );
+
+				this.boundingBox.union( box );
+
+			}
+
+		};
+
+	}(),
+
+	computeBoundingSphere: function () {
+
+		var vector = new Vector3$1();
+
+		return function computeBoundingSphere() {
+
+			if ( this.boundingSphere === null ) {
+
+				this.boundingSphere = new Sphere$1();
+
+			}
+
+			if ( this.boundingBox === null ) {
+
+				this.computeBoundingBox();
+
+			}
+
+			var start = this.attributes.instanceStart;
+			var end = this.attributes.instanceEnd;
+
+			if ( start !== undefined && end !== undefined ) {
+
+				var center = this.boundingSphere.center;
+
+				this.boundingBox.getCenter( center );
+
+				var maxRadiusSq = 0;
+
+				for ( var i = 0, il = start.count; i < il; i ++ ) {
+
+					vector.fromBufferAttribute( start, i );
+					maxRadiusSq = Math.max( maxRadiusSq, center.distanceToSquared( vector ) );
+
+					vector.fromBufferAttribute( end, i );
+					maxRadiusSq = Math.max( maxRadiusSq, center.distanceToSquared( vector ) );
+
+				}
+
+				this.boundingSphere.radius = Math.sqrt( maxRadiusSq );
+
+				if ( isNaN( this.boundingSphere.radius ) ) {
+
+					console.error( 'THREE.LineSegmentsGeometry.computeBoundingSphere(): Computed radius is NaN. The instanced position data is likely to have NaN values.', this );
+
+				}
+
+			}
+
+		};
+
+	}(),
+
+	toJSON: function () {
+
+		// todo
+
+	},
+
+	applyMatrix: function ( matrix ) {
+
+		console.warn( 'THREE.LineSegmentsGeometry: applyMatrix() has been renamed to applyMatrix4().' );
+
+		return this.applyMatrix4( matrix );
+
+	}
+
+} );/**
+ * parameters = {
+ *  color: <hex>,
+ *  linewidth: <float>,
+ *  dashed: <boolean>,
+ *  dashScale: <float>,
+ *  dashSize: <float>,
+ *  dashOffset: <float>,
+ *  gapSize: <float>,
+ *  resolution: <Vector2>, // to be set by renderer
+ * }
+ */
+
+UniformsLib.line = {
+
+	linewidth: { value: 1 },
+	resolution: { value: new Vector2( 1, 1 ) },
+	dashScale: { value: 1 },
+	dashSize: { value: 1 },
+	dashOffset: { value: 0 },
+	gapSize: { value: 1 }, // todo FIX - maybe change to totalSize
+	opacity: { value: 1 }
+
+};
+
+ShaderLib[ 'line' ] = {
+
+	uniforms: UniformsUtils.merge( [
+		UniformsLib.common,
+		UniformsLib.fog,
+		UniformsLib.line
+	] ),
+
+	vertexShader:
+		`
+		#include <common>
+		#include <color_pars_vertex>
+		#include <fog_pars_vertex>
+		#include <logdepthbuf_pars_vertex>
+		#include <clipping_planes_pars_vertex>
+
+		uniform float linewidth;
+		uniform vec2 resolution;
+
+		attribute vec3 instanceStart;
+		attribute vec3 instanceEnd;
+
+		attribute vec3 instanceColorStart;
+		attribute vec3 instanceColorEnd;
+
+		varying vec2 vUv;
+
+		#ifdef USE_DASH
+
+			uniform float dashScale;
+			attribute float instanceDistanceStart;
+			attribute float instanceDistanceEnd;
+			varying float vLineDistance;
+
+		#endif
+
+		void trimSegment( const in vec4 start, inout vec4 end ) {
+
+			// trim end segment so it terminates between the camera plane and the near plane
+
+			// conservative estimate of the near plane
+			float a = projectionMatrix[ 2 ][ 2 ]; // 3nd entry in 3th column
+			float b = projectionMatrix[ 3 ][ 2 ]; // 3nd entry in 4th column
+			float nearEstimate = - 0.5 * b / a;
+
+			float alpha = ( nearEstimate - start.z ) / ( end.z - start.z );
+
+			end.xyz = mix( start.xyz, end.xyz, alpha );
+
+		}
+
+		void main() {
+
+			#ifdef USE_COLOR
+
+				vColor.xyz = ( position.y < 0.5 ) ? instanceColorStart : instanceColorEnd;
+
+			#endif
+
+			#ifdef USE_DASH
+
+				vLineDistance = ( position.y < 0.5 ) ? dashScale * instanceDistanceStart : dashScale * instanceDistanceEnd;
+
+			#endif
+
+			float aspect = resolution.x / resolution.y;
+
+			vUv = uv;
+
+			// camera space
+			vec4 start = modelViewMatrix * vec4( instanceStart, 1.0 );
+			vec4 end = modelViewMatrix * vec4( instanceEnd, 1.0 );
+
+			// special case for perspective projection, and segments that terminate either in, or behind, the camera plane
+			// clearly the gpu firmware has a way of addressing this issue when projecting into ndc space
+			// but we need to perform ndc-space calculations in the shader, so we must address this issue directly
+			// perhaps there is a more elegant solution -- WestLangley
+
+			bool perspective = ( projectionMatrix[ 2 ][ 3 ] == - 1.0 ); // 4th entry in the 3rd column
+
+			if ( perspective ) {
+
+				if ( start.z < 0.0 && end.z >= 0.0 ) {
+
+					trimSegment( start, end );
+
+				} else if ( end.z < 0.0 && start.z >= 0.0 ) {
+
+					trimSegment( end, start );
+
+				}
+
+			}
+
+			// clip space
+			vec4 clipStart = projectionMatrix * start;
+			vec4 clipEnd = projectionMatrix * end;
+
+			// ndc space
+			vec2 ndcStart = clipStart.xy / clipStart.w;
+			vec2 ndcEnd = clipEnd.xy / clipEnd.w;
+
+			// direction
+			vec2 dir = ndcEnd - ndcStart;
+
+			// account for clip-space aspect ratio
+			dir.x *= aspect;
+			dir = normalize( dir );
+
+			// perpendicular to dir
+			vec2 offset = vec2( dir.y, - dir.x );
+
+			// undo aspect ratio adjustment
+			dir.x /= aspect;
+			offset.x /= aspect;
+
+			// sign flip
+			if ( position.x < 0.0 ) offset *= - 1.0;
+
+			// endcaps
+			if ( position.y < 0.0 ) {
+
+				offset += - dir;
+
+			} else if ( position.y > 1.0 ) {
+
+				offset += dir;
+
+			}
+
+			// adjust for linewidth
+			offset *= linewidth;
+
+			// adjust for clip-space to screen-space conversion // maybe resolution should be based on viewport ...
+			offset /= resolution.y;
+
+			// select end
+			vec4 clip = ( position.y < 0.5 ) ? clipStart : clipEnd;
+
+			// back to clip space
+			offset *= clip.w;
+
+			clip.xy += offset;
+
+			gl_Position = clip;
+
+			vec4 mvPosition = ( position.y < 0.5 ) ? start : end; // this is an approximation
+
+			#include <logdepthbuf_vertex>
+			#include <clipping_planes_vertex>
+			#include <fog_vertex>
+
+		}
+		`,
+
+	fragmentShader:
+		`
+		uniform vec3 diffuse;
+		uniform float opacity;
+
+		#ifdef USE_DASH
+
+			uniform float dashSize;
+			uniform float dashOffset;
+			uniform float gapSize;
+
+		#endif
+
+		varying float vLineDistance;
+
+		#include <common>
+		#include <color_pars_fragment>
+		#include <fog_pars_fragment>
+		#include <logdepthbuf_pars_fragment>
+		#include <clipping_planes_pars_fragment>
+
+		varying vec2 vUv;
+
+		void main() {
+
+			#include <clipping_planes_fragment>
+
+			#ifdef USE_DASH
+
+				if ( vUv.y < - 1.0 || vUv.y > 1.0 ) discard; // discard endcaps
+
+				if ( mod( vLineDistance + dashOffset, dashSize + gapSize ) > dashSize ) discard; // todo - FIX
+
+			#endif
+
+			if ( abs( vUv.y ) > 1.0 ) {
+
+				float a = vUv.x;
+				float b = ( vUv.y > 0.0 ) ? vUv.y - 1.0 : vUv.y + 1.0;
+				float len2 = a * a + b * b;
+
+				if ( len2 > 1.0 ) discard;
+
+			}
+
+			vec4 diffuseColor = vec4( diffuse, opacity );
+
+			#include <logdepthbuf_fragment>
+			#include <color_fragment>
+
+			gl_FragColor = vec4( diffuseColor.rgb, diffuseColor.a );
+
+			#include <tonemapping_fragment>
+			#include <encodings_fragment>
+			#include <fog_fragment>
+			#include <premultiplied_alpha_fragment>
+
+		}
+		`
+};
+
+var LineMaterial = function ( parameters ) {
+
+	ShaderMaterial.call( this, {
+
+		type: 'LineMaterial',
+
+		uniforms: UniformsUtils.clone( ShaderLib[ 'line' ].uniforms ),
+
+		vertexShader: ShaderLib[ 'line' ].vertexShader,
+		fragmentShader: ShaderLib[ 'line' ].fragmentShader,
+
+		clipping: true // required for clipping support
+
+	} );
+
+	this.dashed = false;
+
+	Object.defineProperties( this, {
+
+		color: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.diffuse.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.diffuse.value = value;
+
+			}
+
+		},
+
+		linewidth: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.linewidth.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.linewidth.value = value;
+
+			}
+
+		},
+
+		dashScale: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.dashScale.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.dashScale.value = value;
+
+			}
+
+		},
+
+		dashSize: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.dashSize.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.dashSize.value = value;
+
+			}
+
+		},
+
+		dashOffset: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.dashOffset.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.dashOffset.value = value;
+
+			}
+
+		},
+
+		gapSize: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.gapSize.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.gapSize.value = value;
+
+			}
+
+		},
+
+		opacity: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.opacity.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.opacity.value = value;
+
+			}
+
+		},
+
+		resolution: {
+
+			enumerable: true,
+
+			get: function () {
+
+				return this.uniforms.resolution.value;
+
+			},
+
+			set: function ( value ) {
+
+				this.uniforms.resolution.value.copy( value );
+
+			}
+
+		}
+
+	} );
+
+	this.setValues( parameters );
+
+};
+
+LineMaterial.prototype = Object.create( ShaderMaterial.prototype );
+LineMaterial.prototype.constructor = LineMaterial;
+
+LineMaterial.prototype.isLineMaterial = true;var LineSegments2 = function ( geometry, material ) {
+
+	if ( geometry === undefined ) geometry = new LineSegmentsGeometry();
+	if ( material === undefined ) material = new LineMaterial( { color: Math.random() * 0xffffff } );
+
+	Mesh.call( this, geometry, material );
+
+	this.type = 'LineSegments2';
+
+};
+
+LineSegments2.prototype = Object.assign( Object.create( Mesh.prototype ), {
+
+	constructor: LineSegments2,
+
+	isLineSegments2: true,
+
+	computeLineDistances: ( function () { // for backwards-compatability, but could be a method of LineSegmentsGeometry...
+
+		var start = new Vector3$1();
+		var end = new Vector3$1();
+
+		return function computeLineDistances() {
+
+			var geometry = this.geometry;
+
+			var instanceStart = geometry.attributes.instanceStart;
+			var instanceEnd = geometry.attributes.instanceEnd;
+			var lineDistances = new Float32Array( 2 * instanceStart.data.count );
+
+			for ( var i = 0, j = 0, l = instanceStart.data.count; i < l; i ++, j += 2 ) {
+
+				start.fromBufferAttribute( instanceStart, i );
+				end.fromBufferAttribute( instanceEnd, i );
+
+				lineDistances[ j ] = ( j === 0 ) ? 0 : lineDistances[ j - 1 ];
+				lineDistances[ j + 1 ] = lineDistances[ j ] + start.distanceTo( end );
+
+			}
+
+			var instanceDistanceBuffer = new InstancedInterleavedBuffer( lineDistances, 2, 1 ); // d0, d1
+
+			geometry.setAttribute( 'instanceDistanceStart', new InterleavedBufferAttribute( instanceDistanceBuffer, 1, 0 ) ); // d0
+			geometry.setAttribute( 'instanceDistanceEnd', new InterleavedBufferAttribute( instanceDistanceBuffer, 1, 1 ) ); // d1
+
+			return this;
+
+		};
+
+	}() ),
+
+	raycast: ( function () {
+
+		var start = new Vector4();
+		var end = new Vector4();
+
+		var ssOrigin = new Vector4();
+		var ssOrigin3 = new Vector3$1();
+		var mvMatrix = new Matrix4();
+		var line = new Line3();
+		var closestPoint = new Vector3$1();
+
+		return function raycast( raycaster, intersects ) {
+
+			if ( raycaster.camera === null ) {
+
+				console.error( 'LineSegments2: "Raycaster.camera" needs to be set in order to raycast against LineSegments2.' );
+
+			}
+
+			var threshold = ( raycaster.params.Line2 !== undefined ) ? raycaster.params.Line2.threshold || 0 : 0;
+
+			var ray = raycaster.ray;
+			var camera = raycaster.camera;
+			var projectionMatrix = camera.projectionMatrix;
+
+			var geometry = this.geometry;
+			var material = this.material;
+			var resolution = material.resolution;
+			var lineWidth = material.linewidth + threshold;
+
+			var instanceStart = geometry.attributes.instanceStart;
+			var instanceEnd = geometry.attributes.instanceEnd;
+
+			// camera forward is negative
+			var near = - camera.near;
+
+			// pick a point 1 unit out along the ray to avoid the ray origin
+			// sitting at the camera origin which will cause "w" to be 0 when
+			// applying the projection matrix.
+			ray.at( 1, ssOrigin );
+
+			// ndc space [ - 1.0, 1.0 ]
+			ssOrigin.w = 1;
+			ssOrigin.applyMatrix4( camera.matrixWorldInverse );
+			ssOrigin.applyMatrix4( projectionMatrix );
+			ssOrigin.multiplyScalar( 1 / ssOrigin.w );
+
+			// screen space
+			ssOrigin.x *= resolution.x / 2;
+			ssOrigin.y *= resolution.y / 2;
+			ssOrigin.z = 0;
+
+			ssOrigin3.copy( ssOrigin );
+
+			var matrixWorld = this.matrixWorld;
+			mvMatrix.multiplyMatrices( camera.matrixWorldInverse, matrixWorld );
+
+			for ( var i = 0, l = instanceStart.count; i < l; i ++ ) {
+
+				start.fromBufferAttribute( instanceStart, i );
+				end.fromBufferAttribute( instanceEnd, i );
+
+				start.w = 1;
+				end.w = 1;
+
+				// camera space
+				start.applyMatrix4( mvMatrix );
+				end.applyMatrix4( mvMatrix );
+
+				// skip the segment if it's entirely behind the camera
+				var isBehindCameraNear = start.z > near && end.z > near;
+				if ( isBehindCameraNear ) {
+
+					continue;
+
+				}
+
+				// trim the segment if it extends behind camera near
+				if ( start.z > near ) {
+
+					const deltaDist = start.z - end.z;
+					const t = ( start.z - near ) / deltaDist;
+					start.lerp( end, t );
+
+				} else if ( end.z > near ) {
+
+					const deltaDist = end.z - start.z;
+					const t = ( end.z - near ) / deltaDist;
+					end.lerp( start, t );
+
+				}
+
+				// clip space
+				start.applyMatrix4( projectionMatrix );
+				end.applyMatrix4( projectionMatrix );
+
+				// ndc space [ - 1.0, 1.0 ]
+				start.multiplyScalar( 1 / start.w );
+				end.multiplyScalar( 1 / end.w );
+
+				// screen space
+				start.x *= resolution.x / 2;
+				start.y *= resolution.y / 2;
+
+				end.x *= resolution.x / 2;
+				end.y *= resolution.y / 2;
+
+				// create 2d segment
+				line.start.copy( start );
+				line.start.z = 0;
+
+				line.end.copy( end );
+				line.end.z = 0;
+
+				// get closest point on ray to segment
+				var param = line.closestPointToPointParameter( ssOrigin3, true );
+				line.at( param, closestPoint );
+
+				// check if the intersection point is within clip space
+				var zPos = MathUtils.lerp( start.z, end.z, param );
+				var isInClipSpace = zPos >= - 1 && zPos <= 1;
+
+				var isInside = ssOrigin3.distanceTo( closestPoint ) < lineWidth * 0.5;
+
+				if ( isInClipSpace && isInside ) {
+
+					line.start.fromBufferAttribute( instanceStart, i );
+					line.end.fromBufferAttribute( instanceEnd, i );
+
+					line.start.applyMatrix4( matrixWorld );
+					line.end.applyMatrix4( matrixWorld );
+
+					var pointOnLine = new Vector3$1();
+					var point = new Vector3$1();
+
+					ray.distanceSqToSegment( line.start, line.end, point, pointOnLine );
+
+					intersects.push( {
+
+						point: point,
+						pointOnLine: pointOnLine,
+						distance: ray.origin.distanceTo( point ),
+
+						object: this,
+						face: null,
+						faceIndex: i,
+						uv: null,
+						uv2: null,
+
+					} );
+
+				}
+
+			}
+
+		};
+
+	}() )
+
+} );const BLOB_TYPE = "application/javascript";
 const createBlob = task => new Blob(["(", task.toString(), ")()"], {
   type: BLOB_TYPE
 });
@@ -98155,22 +99140,34 @@ const DEFAULT_HITBOX_OPTIONS = {
   shadowsEnabled: false
 };
 const getBoxHitbox = element => {
-  const size = new Vector3$1();
-  element.boundingBox.getSize(size);
-  const scaledSize = {
-    x: size.x + HIT_BOX_INCREASE,
-    y: size.y + HIT_BOX_INCREASE,
-    z: size.z + HIT_BOX_INCREASE
-  };
-  const box = new Box(scaledSize.x, scaledSize.y, scaledSize.z, HIT_BOX_COLOR, DEFAULT_HITBOX_OPTIONS);
-
-  //box.setQuaternion(quaternion);
+  const opts = element.getPhysicsOptions() || {};
+  let w, h, l;
+  if (opts.colliderWidth != null || opts.colliderHeight != null || opts.colliderLength != null) {
+    w = (opts.colliderWidth ?? 1) + HIT_BOX_INCREASE;
+    h = (opts.colliderHeight ?? 1) + HIT_BOX_INCREASE;
+    l = (opts.colliderLength ?? 1) + HIT_BOX_INCREASE;
+  } else {
+    const size = getWorldBoundingBoxSize(element.getBody());
+    if (size) {
+      w = size.width + HIT_BOX_INCREASE;
+      h = size.height + HIT_BOX_INCREASE;
+      l = size.length + HIT_BOX_INCREASE;
+    } else {
+      const fallback = new Vector3$1();
+      element.boundingBox.getSize(fallback);
+      w = fallback.x + HIT_BOX_INCREASE;
+      h = fallback.y + HIT_BOX_INCREASE;
+      l = fallback.z + HIT_BOX_INCREASE;
+    }
+  }
+  const box = new Box(w, h, l, HIT_BOX_COLOR, DEFAULT_HITBOX_OPTIONS);
   box.setWireframe(true);
   box.setWireframeLineWidth(2);
   return box;
 };
 const getSphereHitbox = element => {
-  const radius = element.boundingSphere.radius;
+  const opts = element.getPhysicsOptions() || {};
+  const radius = opts.colliderRadius ?? getWorldBoundingSphereRadius(element.getBody()) ?? element.boundingSphere.radius;
   const sphere = new Sphere(radius, HIT_BOX_COLOR, DEFAULT_HITBOX_OPTIONS);
   sphere.setWireframe(true);
   sphere.setWireframeLineWidth(2);
@@ -100314,4 +101311,4 @@ var Shaders$1 = new Shaders();let Shader = /*#__PURE__*/_createClass(function Sh
   ...light_contants,
   ...material_constants,
   ...controls_contants
-};export{AUDIO_RAMPS,AmbientLight,AmbientSound,Atmosphere,Audio$1 as Audio,Axes,BUILTIN,BaseScript,Box,CONTROL_EVENTS,Camera,Color,Cone,Config$1 as Config,Controls$1 as Controls,Cube,CurveLine,Cylinder,DirectionalSound,ENTITY_EVENTS,ENTITY_TYPES,Element$1 as Element,Entity,EventDispatcher,Explosion,Exporter,FEATURES,Features$1 as Features,Fire,Fountain,GameRunner$1 as GameRunner,Grid,HelperSprite,HemisphereLight,INPUT_EVENTS,Images$1 as Images,Importer,Input$1 as Input,Label,LabelComponent,Level,Lights$1 as Lights,Line,MirrorElement as Mirror,Models$1 as Models,Ocean,PALETTES,PARTICLES,PHYSICS_CONSTANTS,PHYSICS_EVENTS,ParticleEmitter,ParticleEmitterGroup,Particles$1 as Particles,Physics$1 as Physics,Plane,PointLight,PostProcessing$1 as PostProcessing,Proton,ProtonParticleEmitter,Provider,Rain,Router$1 as Router,Scene$1 as Scene,Scripts$1 as Scripts,Shader,Sky,Skybox,Snow,Sound,Sphere,SpotLight,Sprite,Stats$1 as Stats,SunLight,three_module as THREE,THREEJS_CONTROL_EVENTS,Trail,Universe$1 as Universe,Vector3$1 as Vector3,Water,author,connect,constants,createElement,easing,functions,hitbox as hitboxUtils,index_esm as inferno,map$1 as map,math,object,physicsUtils,index$1 as rxjs,index as store,strings,uuid$1 as uuid,workers,index$2 as xstate};
+};export{AUDIO_RAMPS,AmbientLight,AmbientSound,Atmosphere,Audio$1 as Audio,Axes,BUILTIN,BaseScript,Box,CONTROL_EVENTS,Camera,Color,Cone,Config$1 as Config,Controls$1 as Controls,Cube,CurveLine,Cylinder,DirectionalSound,ENTITY_EVENTS,ENTITY_TYPES,Element$1 as Element,Entity,EventDispatcher,Explosion,Exporter,FEATURES,Features$1 as Features,Fire,Fountain,GameRunner$1 as GameRunner,Grid,HelperSprite,HemisphereLight,INPUT_EVENTS,Images$1 as Images,Importer,Input$1 as Input,Label,LabelComponent,Level,Lights$1 as Lights,Line,LineMaterial,LineSegments2,LineSegmentsGeometry,MirrorElement as Mirror,Models$1 as Models,Ocean,PALETTES,PARTICLES,PHYSICS_CONSTANTS,PHYSICS_EVENTS,ParticleEmitter,ParticleEmitterGroup,Particles$1 as Particles,Physics$1 as Physics,Plane,PointLight,PostProcessing$1 as PostProcessing,Proton,ProtonParticleEmitter,Provider,Rain,Router$1 as Router,Scene$1 as Scene,Scripts$1 as Scripts,Shader,Sky,Skybox,Snow,Sound,Sphere,SpotLight,Sprite,Stats$1 as Stats,SunLight,three_module as THREE,THREEJS_CONTROL_EVENTS,Trail,Universe$1 as Universe,Vector3$1 as Vector3,Water,author,connect,constants,createElement,easing,functions,hitbox as hitboxUtils,index_esm as inferno,map$1 as map,math,object,physicsUtils,index$1 as rxjs,index as store,strings,uuid$1 as uuid,workers,index$2 as xstate};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mage-engine",
-    "version": "3.25.6",
+    "version": "3.25.8",
     "description": "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.",
     "main": "dist/mage.js",
     "author": {