@tonybfox/threejs-tools 1.0.3 → 1.0.5

package/dist/asset-loader/index.cjs

@@ -40,6 +40,10 @@ var import_GLTFLoader = require("three/examples/jsm/loaders/GLTFLoader.js");
 var import_FBXLoader = require("three/examples/jsm/loaders/FBXLoader.js");
 var import_OBJLoader = require("three/examples/jsm/loaders/OBJLoader.js");
 var import_USDLoader = require("three/examples/jsm/loaders/USDLoader.js");
+var import_ColladaLoader = require("three/examples/jsm/loaders/ColladaLoader.js");
+var import_STLLoader = require("three/examples/jsm/loaders/STLLoader.js");
+var import_PLYLoader = require("three/examples/jsm/loaders/PLYLoader.js");
+var import_MFLoader = require("three/examples/jsm/loaders/3MFLoader.js");
 var AssetLoader = class extends THREE.EventDispatcher {
   constructor() {
     super();
@@ -53,6 +57,10 @@ var AssetLoader = class extends THREE.EventDispatcher {
     this.fbxLoader = new import_FBXLoader.FBXLoader();
     this.objLoader = new import_OBJLoader.OBJLoader();
     this.usdLoader = new import_USDLoader.USDLoader();
+    this.colladaLoader = new import_ColladaLoader.ColladaLoader();
+    this.stlLoader = new import_STLLoader.STLLoader();
+    this.plyLoader = new import_PLYLoader.PLYLoader();
+    this.threeMFLoader = new import_MFLoader.ThreeMFLoader();
   }
   /**
    * Create a placeholder cube with shader effect
@@ -180,7 +188,7 @@ var AssetLoader = class extends THREE.EventDispatcher {
     const center = boundingBox.getCenter(new THREE.Vector3());
     const bottomCenter = new THREE.Vector3(
       center.x,
-      boundingBox.min.y + 0.01,
+      boundingBox.min.y - 0.01,
       center.z
     );
     if (!Number.isFinite(bottomCenter.x) || !Number.isFinite(bottomCenter.y) || !Number.isFinite(bottomCenter.z)) {
@@ -222,6 +230,7 @@ var AssetLoader = class extends THREE.EventDispatcher {
       size,
       lowResUrl,
       enableCaching = true,
+      disablePlaceholder = false,
       placeholderColor = 5227511,
       placeholderOpacity = 0.4,
       errorColor = 16729156,
@@ -241,7 +250,7 @@ var AssetLoader = class extends THREE.EventDispatcher {
     }
     this.errorColor = errorColor;
     this.errorOpacity = errorOpacity;
-    if (size) {
+    if (size && !disablePlaceholder) {
       this.placeholder = this.createPlaceholder(
         size,
         placeholderColor,
@@ -348,6 +357,59 @@ var AssetLoader = class extends THREE.EventDispatcher {
             onError
           );
           break;
+        case "dae":
+          this.colladaLoader.load(
+            url,
+            (collada) => {
+              const scene = collada.scene;
+              this.positionAssetAtBottomCenter(scene);
+              resolve(scene);
+            },
+            onProgress,
+            onError
+          );
+          break;
+        case "stl":
+          this.stlLoader.load(
+            url,
+            (geometry) => {
+              const material = new THREE.MeshStandardMaterial({
+                color: 8947848
+              });
+              const mesh = new THREE.Mesh(geometry, material);
+              this.positionAssetAtBottomCenter(mesh);
+              resolve(mesh);
+            },
+            onProgress,
+            onError
+          );
+          break;
+        case "ply":
+          this.plyLoader.load(
+            url,
+            (geometry) => {
+              const material = new THREE.MeshStandardMaterial({
+                vertexColors: true
+              });
+              const mesh = new THREE.Mesh(geometry, material);
+              this.positionAssetAtBottomCenter(mesh);
+              resolve(mesh);
+            },
+            onProgress,
+            onError
+          );
+          break;
+        case "3mf":
+          this.threeMFLoader.load(
+            url,
+            (object) => {
+              this.positionAssetAtBottomCenter(object);
+              resolve(object);
+            },
+            onProgress,
+            onError
+          );
+          break;
         default:
           reject(new Error(`Unsupported asset type: ${type}`));
       }
@@ -394,4 +456,3 @@ var AssetLoader = class extends THREE.EventDispatcher {
 0 && (module.exports = {
   AssetLoader
 });
-//# sourceMappingURL=index.cjs.map

package/dist/asset-loader/index.d.mts

@@ -19,13 +19,14 @@ interface AssetLoaderEventMap {
         lowRes: THREE.Object3D;
     };
 }
-type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz';
+type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz' | 'dae' | 'stl' | 'ply' | '3mf';
 interface AssetLoaderOptions {
     type: AssetType;
     url: string;
     size?: [number, number, number];
     lowResUrl?: string;
     enableCaching?: boolean;
+    disablePlaceholder?: boolean;
     placeholderColor?: number;
     placeholderOpacity?: number;
     errorColor?: number;
@@ -37,6 +38,10 @@ declare class AssetLoader extends THREE.EventDispatcher<AssetLoaderEventMap> {
     private fbxLoader;
     private objLoader;
     private usdLoader;
+    private colladaLoader;
+    private stlLoader;
+    private plyLoader;
+    private threeMFLoader;
     private placeholder;
     private loadedAsset;
     private lowResAsset;

package/dist/asset-loader/index.d.ts

@@ -19,13 +19,14 @@ interface AssetLoaderEventMap {
         lowRes: THREE.Object3D;
     };
 }
-type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz';
+type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz' | 'dae' | 'stl' | 'ply' | '3mf';
 interface AssetLoaderOptions {
     type: AssetType;
     url: string;
     size?: [number, number, number];
     lowResUrl?: string;
     enableCaching?: boolean;
+    disablePlaceholder?: boolean;
     placeholderColor?: number;
     placeholderOpacity?: number;
     errorColor?: number;
@@ -37,6 +38,10 @@ declare class AssetLoader extends THREE.EventDispatcher<AssetLoaderEventMap> {
     private fbxLoader;
     private objLoader;
     private usdLoader;
+    private colladaLoader;
+    private stlLoader;
+    private plyLoader;
+    private threeMFLoader;
     private placeholder;
     private loadedAsset;
     private lowResAsset;

package/dist/asset-loader/index.mjs

@@ -1,7 +1,6 @@
 import {
   AssetLoader
-} from "../chunk-WZ6IGBSE.mjs";
+} from "../chunk-LUE7VHLK.mjs";
 export {
   AssetLoader
 };
-//# sourceMappingURL=index.mjs.map

package/dist/camera/index.cjs

@@ -391,4 +391,3 @@ function resolveAspect(renderer, domElement) {
 0 && (module.exports = {
   DualCameraControls
 });
-//# sourceMappingURL=index.cjs.map

package/dist/camera/index.mjs

@@ -1,7 +1,6 @@
 import {
   DualCameraControls
-} from "../chunk-IEE7DQOU.mjs";
+} from "../chunk-XA7OKYSM.mjs";
 export {
   DualCameraControls
 };
-//# sourceMappingURL=index.mjs.map

package/dist/{chunk-EQDOX34V.mjs → chunk-2CDI7ORN.mjs}

@@ -161,4 +161,3 @@ var InfiniteGrid = class extends THREE.Object3D {
 export {
   InfiniteGrid
 };
-//# sourceMappingURL=chunk-EQDOX34V.mjs.map

package/dist/{chunk-EIROAPF7.mjs → chunk-FBTT6MU6.mjs}

@@ -384,4 +384,3 @@ var TerrainTool = class extends THREE.EventDispatcher {
 export {
   TerrainTool
 };
-//# sourceMappingURL=chunk-EIROAPF7.mjs.map

package/dist/{chunk-VETFQ3IQ.mjs → chunk-IAZH4OHC.mjs}

@@ -397,4 +397,3 @@ var ViewHelper = class extends THREE.EventDispatcher {
 export {
   ViewHelper
 };
-//# sourceMappingURL=chunk-VETFQ3IQ.mjs.map

package/dist/{chunk-WZ6IGBSE.mjs → chunk-LUE7VHLK.mjs}

@@ -4,6 +4,10 @@ import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
 import { FBXLoader } from "three/examples/jsm/loaders/FBXLoader.js";
 import { OBJLoader } from "three/examples/jsm/loaders/OBJLoader.js";
 import { USDLoader } from "three/examples/jsm/loaders/USDLoader.js";
+import { ColladaLoader } from "three/examples/jsm/loaders/ColladaLoader.js";
+import { STLLoader } from "three/examples/jsm/loaders/STLLoader.js";
+import { PLYLoader } from "three/examples/jsm/loaders/PLYLoader.js";
+import { ThreeMFLoader } from "three/examples/jsm/loaders/3MFLoader.js";
 var AssetLoader = class extends THREE.EventDispatcher {
   constructor() {
     super();
@@ -17,6 +21,10 @@ var AssetLoader = class extends THREE.EventDispatcher {
     this.fbxLoader = new FBXLoader();
     this.objLoader = new OBJLoader();
     this.usdLoader = new USDLoader();
+    this.colladaLoader = new ColladaLoader();
+    this.stlLoader = new STLLoader();
+    this.plyLoader = new PLYLoader();
+    this.threeMFLoader = new ThreeMFLoader();
   }
   /**
    * Create a placeholder cube with shader effect
@@ -144,7 +152,7 @@ var AssetLoader = class extends THREE.EventDispatcher {
     const center = boundingBox.getCenter(new THREE.Vector3());
     const bottomCenter = new THREE.Vector3(
       center.x,
-      boundingBox.min.y + 0.01,
+      boundingBox.min.y - 0.01,
       center.z
     );
     if (!Number.isFinite(bottomCenter.x) || !Number.isFinite(bottomCenter.y) || !Number.isFinite(bottomCenter.z)) {
@@ -186,6 +194,7 @@ var AssetLoader = class extends THREE.EventDispatcher {
       size,
       lowResUrl,
       enableCaching = true,
+      disablePlaceholder = false,
       placeholderColor = 5227511,
       placeholderOpacity = 0.4,
       errorColor = 16729156,
@@ -205,7 +214,7 @@ var AssetLoader = class extends THREE.EventDispatcher {
     }
     this.errorColor = errorColor;
     this.errorOpacity = errorOpacity;
-    if (size) {
+    if (size && !disablePlaceholder) {
       this.placeholder = this.createPlaceholder(
         size,
         placeholderColor,
@@ -312,6 +321,59 @@ var AssetLoader = class extends THREE.EventDispatcher {
             onError
           );
           break;
+        case "dae":
+          this.colladaLoader.load(
+            url,
+            (collada) => {
+              const scene = collada.scene;
+              this.positionAssetAtBottomCenter(scene);
+              resolve(scene);
+            },
+            onProgress,
+            onError
+          );
+          break;
+        case "stl":
+          this.stlLoader.load(
+            url,
+            (geometry) => {
+              const material = new THREE.MeshStandardMaterial({
+                color: 8947848
+              });
+              const mesh = new THREE.Mesh(geometry, material);
+              this.positionAssetAtBottomCenter(mesh);
+              resolve(mesh);
+            },
+            onProgress,
+            onError
+          );
+          break;
+        case "ply":
+          this.plyLoader.load(
+            url,
+            (geometry) => {
+              const material = new THREE.MeshStandardMaterial({
+                vertexColors: true
+              });
+              const mesh = new THREE.Mesh(geometry, material);
+              this.positionAssetAtBottomCenter(mesh);
+              resolve(mesh);
+            },
+            onProgress,
+            onError
+          );
+          break;
+        case "3mf":
+          this.threeMFLoader.load(
+            url,
+            (object) => {
+              this.positionAssetAtBottomCenter(object);
+              resolve(object);
+            },
+            onProgress,
+            onError
+          );
+          break;
         default:
           reject(new Error(`Unsupported asset type: ${type}`));
       }
@@ -358,4 +420,3 @@ var AssetLoader = class extends THREE.EventDispatcher {
 export {
   AssetLoader
 };
-//# sourceMappingURL=chunk-WZ6IGBSE.mjs.map

package/dist/{chunk-5DP6WDB3.mjs → chunk-OZKJ3GAD.mjs}

@@ -1158,4 +1158,3 @@ export {
   SnapMode,
   MeasurementTool
 };
-//# sourceMappingURL=chunk-5DP6WDB3.mjs.map

package/dist/{chunk-IIAZ2WJJ.mjs → chunk-W4DAAAW6.mjs}

@@ -402,4 +402,3 @@ var SunLightTool = class extends THREE.EventDispatcher {
 export {
   SunLightTool
 };
-//# sourceMappingURL=chunk-IIAZ2WJJ.mjs.map

package/dist/{chunk-IEE7DQOU.mjs → chunk-XA7OKYSM.mjs}

@@ -355,4 +355,3 @@ function resolveAspect(renderer, domElement) {
 export {
   DualCameraControls
 };
-//# sourceMappingURL=chunk-IEE7DQOU.mjs.map

package/dist/{chunk-BJKSICFA.mjs → chunk-YMMLYGHV.mjs}

@@ -1576,4 +1576,3 @@ export {
   TransformControlsGizmo,
   TransformControlsPlane
 };
-//# sourceMappingURL=chunk-BJKSICFA.mjs.map

package/dist/{chunk-P35QJCOG.mjs → chunk-ZNGFST7K.mjs}

@@ -11,6 +11,7 @@ var CompassOverlay = class extends THREE.EventDispatcher {
       size: options.size || 100,
       position: options.position || "bottom-right",
       offset: options.offset || { x: 20, y: 20 },
+      northDirection: options.northDirection?.clone().normalize() || new THREE.Vector3(0, 0, -1),
       colors: {
         background: options.colors?.background || "#1a1a1a",
         border: options.colors?.border || "#333333",
@@ -23,6 +24,7 @@ var CompassOverlay = class extends THREE.EventDispatcher {
     this.container = this.options.container;
     this.createCompassElement();
     this.setupStyles();
+    this.start();
   }
   createCompassElement() {
     this.compassElement = document.createElement("div");
@@ -229,8 +231,13 @@ var CompassOverlay = class extends THREE.EventDispatcher {
     forward.transformDirection(cameraMatrix);
     forward.y = 0;
     forward.normalize();
+    const north = this.options.northDirection.clone();
+    north.y = 0;
+    north.normalize();
     const targetAngle = Math.atan2(-forward.x, -forward.z) * (180 / Math.PI);
-    let angleDiff = targetAngle - this.currentRotation;
+    const northAngle = Math.atan2(-north.x, -north.z) * (180 / Math.PI);
+    const adjustedAngle = targetAngle - northAngle;
+    let angleDiff = adjustedAngle - this.currentRotation;
     while (angleDiff > 180) angleDiff -= 360;
     while (angleDiff < -180) angleDiff += 360;
     this.currentRotation += angleDiff;
@@ -242,6 +249,9 @@ var CompassOverlay = class extends THREE.EventDispatcher {
   setCamera(camera) {
     this.camera = camera;
   }
+  getNorthDirection() {
+    return this.options.northDirection.clone();
+  }
   setSize(size) {
     this.options.size = size;
     this.compassElement.style.width = `${size}px`;
@@ -275,17 +285,17 @@ var CompassOverlay = class extends THREE.EventDispatcher {
     this.updateStyles();
   }
   /**
-   * Helper method to reset camera to look north (world Z- direction)
+   * Helper method to reset camera to look north
    * This is a convenience method that can be called when handling the 'resetToNorth' event
    */
-  static resetCameraToNorth(camera, smooth = true) {
+  static resetCameraToNorth(camera, smooth = true, northDirection = new THREE.Vector3(0, 0, -1)) {
     if (smooth) {
       const startQuaternion = camera.quaternion.clone();
       const targetQuaternion = new THREE.Quaternion();
       const targetMatrix = new THREE.Matrix4();
       targetMatrix.lookAt(
         camera.position,
-        camera.position.clone().add(new THREE.Vector3(0, 0, -1)),
+        camera.position.clone().add(northDirection),
         new THREE.Vector3(0, 1, 0)
       );
       targetQuaternion.setFromRotationMatrix(targetMatrix);
@@ -306,7 +316,7 @@ var CompassOverlay = class extends THREE.EventDispatcher {
       };
       animate();
     } else {
-      camera.lookAt(camera.position.clone().add(new THREE.Vector3(0, 0, -1)));
+      camera.lookAt(camera.position.clone().add(northDirection));
     }
   }
   updateStyles() {
@@ -336,4 +346,3 @@ var CompassOverlay = class extends THREE.EventDispatcher {
 export {
   CompassOverlay
 };
-//# sourceMappingURL=chunk-P35QJCOG.mjs.map

package/dist/compass/index.cjs

@@ -47,6 +47,7 @@ var CompassOverlay = class extends THREE.EventDispatcher {
       size: options.size || 100,
       position: options.position || "bottom-right",
       offset: options.offset || { x: 20, y: 20 },
+      northDirection: options.northDirection?.clone().normalize() || new THREE.Vector3(0, 0, -1),
       colors: {
         background: options.colors?.background || "#1a1a1a",
         border: options.colors?.border || "#333333",
@@ -59,6 +60,7 @@ var CompassOverlay = class extends THREE.EventDispatcher {
     this.container = this.options.container;
     this.createCompassElement();
     this.setupStyles();
+    this.start();
   }
   createCompassElement() {
     this.compassElement = document.createElement("div");
@@ -265,8 +267,13 @@ var CompassOverlay = class extends THREE.EventDispatcher {
     forward.transformDirection(cameraMatrix);
     forward.y = 0;
     forward.normalize();
+    const north = this.options.northDirection.clone();
+    north.y = 0;
+    north.normalize();
     const targetAngle = Math.atan2(-forward.x, -forward.z) * (180 / Math.PI);
-    let angleDiff = targetAngle - this.currentRotation;
+    const northAngle = Math.atan2(-north.x, -north.z) * (180 / Math.PI);
+    const adjustedAngle = targetAngle - northAngle;
+    let angleDiff = adjustedAngle - this.currentRotation;
     while (angleDiff > 180) angleDiff -= 360;
     while (angleDiff < -180) angleDiff += 360;
     this.currentRotation += angleDiff;
@@ -278,6 +285,9 @@ var CompassOverlay = class extends THREE.EventDispatcher {
   setCamera(camera) {
     this.camera = camera;
   }
+  getNorthDirection() {
+    return this.options.northDirection.clone();
+  }
   setSize(size) {
     this.options.size = size;
     this.compassElement.style.width = `${size}px`;
@@ -311,17 +321,17 @@ var CompassOverlay = class extends THREE.EventDispatcher {
     this.updateStyles();
   }
   /**
-   * Helper method to reset camera to look north (world Z- direction)
+   * Helper method to reset camera to look north
    * This is a convenience method that can be called when handling the 'resetToNorth' event
    */
-  static resetCameraToNorth(camera, smooth = true) {
+  static resetCameraToNorth(camera, smooth = true, northDirection = new THREE.Vector3(0, 0, -1)) {
     if (smooth) {
       const startQuaternion = camera.quaternion.clone();
       const targetQuaternion = new THREE.Quaternion();
       const targetMatrix = new THREE.Matrix4();
       targetMatrix.lookAt(
         camera.position,
-        camera.position.clone().add(new THREE.Vector3(0, 0, -1)),
+        camera.position.clone().add(northDirection),
         new THREE.Vector3(0, 1, 0)
       );
       targetQuaternion.setFromRotationMatrix(targetMatrix);
@@ -342,7 +352,7 @@ var CompassOverlay = class extends THREE.EventDispatcher {
       };
       animate();
     } else {
-      camera.lookAt(camera.position.clone().add(new THREE.Vector3(0, 0, -1)));
+      camera.lookAt(camera.position.clone().add(northDirection));
     }
   }
   updateStyles() {
@@ -372,4 +382,3 @@ var CompassOverlay = class extends THREE.EventDispatcher {
 0 && (module.exports = {
   CompassOverlay
 });
-//# sourceMappingURL=index.cjs.map

package/dist/compass/index.d.mts

@@ -8,6 +8,7 @@ interface CompassOverlayOptions {
         x: number;
         y: number;
     };
+    northDirection?: THREE.Vector3;
     colors?: {
         background: string;
         border: string;
@@ -40,6 +41,7 @@ declare class CompassOverlay extends THREE.EventDispatcher<CompassOverlayEventMa
     stop(): void;
     update(): void;
     setCamera(camera: THREE.Camera): void;
+    getNorthDirection(): THREE.Vector3;
     setSize(size: number): void;
     setPosition(position: CompassOverlayOptions['position'], offset?: {
         x: number;
@@ -47,10 +49,10 @@ declare class CompassOverlay extends THREE.EventDispatcher<CompassOverlayEventMa
     }): void;
     setColors(colors: Partial<CompassOverlayOptions['colors']>): void;
     /**
-     * Helper method to reset camera to look north (world Z- direction)
+     * Helper method to reset camera to look north
      * This is a convenience method that can be called when handling the 'resetToNorth' event
      */
-    static resetCameraToNorth(camera: THREE.Camera, smooth?: boolean): void;
+    static resetCameraToNorth(camera: THREE.Camera, smooth?: boolean, northDirection?: THREE.Vector3): void;
     private updateStyles;
     dispose(): void;
 }

package/dist/compass/index.d.ts

@@ -8,6 +8,7 @@ interface CompassOverlayOptions {
         x: number;
         y: number;
     };
+    northDirection?: THREE.Vector3;
     colors?: {
         background: string;
         border: string;
@@ -40,6 +41,7 @@ declare class CompassOverlay extends THREE.EventDispatcher<CompassOverlayEventMa
     stop(): void;
     update(): void;
     setCamera(camera: THREE.Camera): void;
+    getNorthDirection(): THREE.Vector3;
     setSize(size: number): void;
     setPosition(position: CompassOverlayOptions['position'], offset?: {
         x: number;
@@ -47,10 +49,10 @@ declare class CompassOverlay extends THREE.EventDispatcher<CompassOverlayEventMa
     }): void;
     setColors(colors: Partial<CompassOverlayOptions['colors']>): void;
     /**
-     * Helper method to reset camera to look north (world Z- direction)
+     * Helper method to reset camera to look north
      * This is a convenience method that can be called when handling the 'resetToNorth' event
      */
-    static resetCameraToNorth(camera: THREE.Camera, smooth?: boolean): void;
+    static resetCameraToNorth(camera: THREE.Camera, smooth?: boolean, northDirection?: THREE.Vector3): void;
     private updateStyles;
     dispose(): void;
 }

package/dist/compass/index.mjs

@@ -1,7 +1,6 @@
 import {
   CompassOverlay
-} from "../chunk-P35QJCOG.mjs";
+} from "../chunk-ZNGFST7K.mjs";
 export {
   CompassOverlay
 };
-//# sourceMappingURL=index.mjs.map

package/dist/grid/index.cjs

@@ -197,4 +197,3 @@ var InfiniteGrid = class extends THREE.Object3D {
 0 && (module.exports = {
   InfiniteGrid
 });
-//# sourceMappingURL=index.cjs.map

package/dist/grid/index.mjs

@@ -1,7 +1,6 @@
 import {
   InfiniteGrid
-} from "../chunk-EQDOX34V.mjs";
+} from "../chunk-2CDI7ORN.mjs";
 export {
   InfiniteGrid
 };
-//# sourceMappingURL=index.mjs.map