@spiffcommerce/preview 5.6.0 → 5.7.0-alpha.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { Engine } from '@babylonjs/core/Engines/engine';
 import { ISceneLoaderProgressEvent } from '@babylonjs/core/Loading/sceneLoader';
+import { Engine } from '@babylonjs/core/Engines/engine';
 import { Scene } from '@babylonjs/core/scene';
 import { Mesh } from '@babylonjs/core/Meshes/mesh';
 import { AutoRotationBehavior } from '@babylonjs/core/Behaviors/Cameras/autoRotationBehavior';
@@ -174,9 +174,20 @@ type ThreeDPreviewService = {
     /**
      * Loads a model into the scene.
      * @param modelDetails The details of the model to load.
+     * @param options Optional configuration.
      * @returns A reference to the model container. Call `getInitializationPromise()` to wait for the model to be loaded.
      */
-    loadModel(modelDetails: ModelDetails): ModelContainer;
+    loadModel(modelDetails: ModelDetails, options?: {
+        /**
+         * When true, camera will automatically animate to the model after it loads.
+         * @default true
+         */
+        refocusCamera?: boolean;
+        /**
+         * An event handler that is called when loading progress changes.
+         */
+        progressHandler?: (event: ISceneLoaderProgressEvent) => void;
+    }): ModelContainer;
     /**
      * Preloads a model into the scene. This will load the model into memory, but it will not be visible in the scene.
      * @param url The url of the model to preload.
@@ -1108,7 +1119,10 @@ declare class SpiffCommerce3DPreviewService implements ThreeDPreviewService {
     fireResizeEvent(): void;
     setHighlights(materials: readonly MaterialHandle[], color?: readonly [number, number, number]): void;
     setRenderingPipelineConfiguration(renderingPipelineConfiguration: RenderingPipelineConfiguration): void;
-    loadModel(modelDetails: ModelDetails, progressHandler?: (event: ISceneLoaderProgressEvent) => void): ModelContainer;
+    loadModel(modelDetails: ModelDetails, options?: {
+        refocusCamera?: boolean;
+        progressHandler?: (event: ISceneLoaderProgressEvent) => void;
+    }): ModelContainer;
     preloadModel(url: string): Promise<void>;
     getAllModels(): ReadonlyArray<ModelContainer>;
     getModelById(id: string): ModelContainer | undefined;