@x-viewer/core 0.21.12 → 0.21.14

package/dist/types/core/viewers/Viewer3d.d.ts

@@ -3,17 +3,27 @@ import { BaseViewer } from "./BaseViewer";
 import { ViewerName } from "./Constants";
 import { Model3d } from "../model";
 import { Viewer3dConfig, ModelConfig, Viewpoint } from "../../core/Configs";
+import { CoordinateSpace, TransformGizmo, type TransformGizmoCallbacks, TransformMode } from "../../core/controls/TransformGizmo";
 export declare class Viewer3d extends BaseViewer {
     name: ViewerName;
     loadedModels: Model3d[];
-    distanceCullingFactor: number;
-    private shouldDispatchModelLoadEvent;
+    private transformGizmo?;
+    private transformGizmoCallbacks;
     constructor(viewerCfg: Viewer3dConfig, homeView?: Viewpoint);
-    protected setDefaultBackground(): void;
     is3d(): boolean;
     loadLocalModel(url: string, modelCfg: ModelConfig, manager?: THREE.LoadingManager, onProgress?: (event: ProgressEvent) => void): Promise<void>;
     loadModel(modelCfg: ModelConfig, onProgress?: ((event: ProgressEvent<EventTarget>) => void) | undefined): Promise<void>;
-    private loadModelInternal;
+    /**
+     * Drops cached model bounds for the tree containing {@link object} so {@link BaseViewer.getBBox}
+     * and camera helpers use up-to-date geometry after transforms.
+     */
+    invalidateModelBBoxForObject(object: THREE.Object3D): void;
+    /**
+     * Called after any external transform applied to {@link object}:
+     * invalidates the model bbox cache and re-tunes camera near/far and orbit
+     * min/max distances based on the updated scene bounds.
+     */
+    private onObjectTransformed;
     addModel(model: Model3d): void;
     /**
      * Sets distance culling factor in order to improve performance.
@@ -98,6 +108,8 @@ export declare class Viewer3d extends BaseViewer {
     setDoubleSidedMaterials(): void;
     revertDoubleSidedMaterials(): void;
     clearSelection(): void;
+    /** True when the user has an active pick selection (independent of the current cursor hit). */
+    hasSelectedObject(): boolean;
     /**
      * Gets if selection is enabled.
      */
@@ -132,4 +144,31 @@ export declare class Viewer3d extends BaseViewer {
      */
     generateSmartUv1(object?: THREE.Object3D): void;
     resize(): void;
+    /**
+     * Optional callbacks for transform gizmo drag lifecycle (e.g. disable camera navigation while dragging).
+     */
+    setTransformGizmoCallbacks(callbacks: TransformGizmoCallbacks): void;
+    private getOrCreateTransformGizmo;
+    /**
+     * Lazily created transform gizmo instance, if any operation has run.
+     */
+    getTransformGizmo(): TransformGizmo | undefined;
+    attachTransformGizmo(object: THREE.Object3D): void;
+    /**
+     * Notifies the viewer that an object's transform was changed externally
+     * (e.g. Property panel input fields): invalidates model bbox cache,
+     * re-tunes camera near/far and orbit distances, and refreshes gizmo handles.
+     */
+    notifyObjectTransformed(object: THREE.Object3D): void;
+    /**
+     * Repositions transform gizmo handles when the attached object was moved from outside the gizmo
+     * (e.g. Property panel transform fields).
+     */
+    refreshTransformGizmo(): void;
+    detachTransformGizmo(): void;
+    setTransformMode(mode: TransformMode): void;
+    getTransformMode(): TransformMode;
+    setTransformSpace(space: CoordinateSpace): void;
+    getTransformSpace(): CoordinateSpace | undefined;
+    destroy(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@x-viewer/core",
-    "version": "0.21.12",
+    "version": "0.21.14",
     "homepage": "https://dwg.thingraph.site/",
     "description": "WebGL-based 2D/3D viewer engine built on Three.js. View DWG/DXF/PDF files in the browser with no server required. Supports glTF, OBJ, FBX, IFC, STL and BimTiles formats.",
     "author": "Thingraph",