@x-viewer/core 0.21.13 → 0.21.15

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

@@ -3,17 +3,16 @@ import { CSS2DRenderer } from "three/examples/jsm/renderers/CSS2DRenderer.js";
 import { ViewerName } from "./Constants";
 import type { Plugin } from "./Plugin";
 import { ViewerEvent } from "./ViewerEvent";
-import { ProgressBar, Spinner } from "../components";
+import { Spinner } from "../components";
 import { BaseViewerConfig, CameraInfo, CameraProjection, ModelConfig, Viewpoint } from "../../core/Configs";
 import { CameraManager } from "../../core/camera";
 import { CanvasRender } from "../../core/canvas";
 import { Container } from "../../core/components/Container";
 import { EffectManager } from "../../core/effect";
 import { FontManager } from "../../core/font";
-import { ZoomToRectHelper } from "../../core/helpers";
 import { InputManager } from "../../core/input-manager";
 import { Interaction } from "../../core/interactions/Interaction";
-import { BaseModelLoader, ModelLoaderManager } from "../../core/loaders";
+import { BaseModelLoader } from "../../core/loaders";
 import { Model } from "../../core/model";
 import { PickManager } from "../../core/pick";
 import { SceneManager } from "../../core/scene/SceneManager";
@@ -24,30 +23,18 @@ type ViewerEvents = {
 };
 export declare abstract class BaseViewer<BaseViewerEvents extends ViewerEvents = Record<ViewerEvent, any>> extends Event<BaseViewerEvents> {
     name: ViewerName;
-    protected viewerCfg: BaseViewerConfig;
-    protected targetMaxFps: number;
-    protected timeStamp: number;
+    container: Container;
     /**
-     * @hidden
+     * A map to store model file and id.
      */
-    protected requestAnimationFrameHandle?: number;
-    container: Container;
-    protected plugins: Plugin[];
     loadedModels: Model[];
-    protected homeView?: Viewpoint;
     protected inputManager: InputManager;
-    protected cameraManager: CameraManager;
-    protected sceneManager: SceneManager;
-    protected fontManager?: FontManager;
-    protected pickManager: PickManager;
-    protected undoManager: UndoManager;
-    protected overlayRender: CanvasRender;
-    protected css2dRenderer: CSS2DRenderer;
-    protected spinner: Spinner;
-    protected progressBar?: ProgressBar;
-    protected loaderManager: ModelLoaderManager;
-    protected zoomToRectHelper?: ZoomToRectHelper;
-    protected interaction?: Interaction;
+    /**
+     * When true, mesh geometry is quantized after load for supported 3D formats (Viewer3d)
+     * when {@link ModelConfig.quantize} is omitted. Per-model `quantize` overrides this.
+     * Defaults to `false`; set at runtime (e.g. `viewer.enableQuantization = true`) or pass `quantize` on each {@link ModelConfig}.
+     */
+    enableQuantization: boolean;
     /**
      * Enables selecting an object
      */
@@ -86,11 +73,6 @@ export declare abstract class BaseViewer<BaseViewerEvents extends ViewerEvents =
     abstract clearHighlight(): void;
     getRaycaster(): THREE.Raycaster;
     getPickManager(): PickManager;
-    /**
-     * Post-processing (GLSL watermark, optional FXAA/SSAO, …). Shared by 2D and 3D viewers.
-     * Created on first access so construction never runs before {@link BaseViewer.cameraManager} exists.
-     */
-    protected get effect(): EffectManager;
     /** Visual effects / composer (same instance as {@link BaseViewer.effect}). */
     get effectManager(): EffectManager;
     getViewerConfig(): BaseViewerConfig;
@@ -107,13 +89,11 @@ export declare abstract class BaseViewer<BaseViewerEvents extends ViewerEvents =
      * @hidden
      */
     enableRender: (time?: number) => void;
-    protected animate(timeStamp?: number): void;
     resize(): void;
     /**
-     * @deprecated use GltfLoader.setDracoDecoderPath instead
-     * @hidden
+     * Fills {@link ModelConfig.quantize} from {@link enableQuantization} when omitted, without mutating `modelCfg`.
      */
-    setDracoDecoderPath(path: string): void;
+    protected modelConfigForLoader(modelCfg: ModelConfig): ModelConfig;
     abstract loadModel(modelCfg: ModelConfig, onProgress?: (event: ProgressEvent) => void): Promise<void>;
     addModel(model: Model): void;
     removeModelById(modelId: string): void;
@@ -139,14 +119,6 @@ export declare abstract class BaseViewer<BaseViewerEvents extends ViewerEvents =
      * ```
      */
     zoomToRect(): void;
-    /**
-     * @hidden
-     */
-    deactivateZoomRect(): void;
-    /**
-     * Gets an unique modelId in case the expected id is duplicated.
-     */
-    protected getUniqueModelId(expectedModelId: string): string;
     /**
      * Gets all objects' bounding box.
      */

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

@@ -3,7 +3,6 @@ import { BaseViewer } from "./BaseViewer";
 import { ViewerName } from "./Constants";
 import { Model2dConfig, Viewer2dConfig } from "../../core/Configs";
 import { DxfData, DxfLayer } from "../../core/dxf";
-import { EventInfo } from "../../core/input-manager/InputManager";
 import { Model2d } from "../../core/model";
 export interface EntityData {
     modelId: string;
@@ -157,10 +156,6 @@ export declare const GroundPlaneRenderOrder = -1000;
 export declare class Viewer2d extends BaseViewer {
     name: ViewerName;
     loadedModels: Model2d[];
-    /**
-     * @hidden
-     */
-    masterModelId: string;
     groundPlane?: THREE.Mesh;
     raycastableObjects?: THREE.Object3D[];
     constructor(viewerCfg: Viewer2dConfig);
@@ -260,21 +255,6 @@ export declare class Viewer2d extends BaseViewer {
      * Upper right coordinate: (1, 1)
      */
     protected getHitResultByNdcCoordinate(coord: THREE.Vector2): THREE.Vector2 | undefined;
-    /**
-     * Gets mouse hit result in world coordinate
-     * @example
-     * ``` typescript
-     * document.addEventListener("click", (event) => {
-     *     const result = viewer.getHitResult(event);
-     *     const loc = result?.location;
-     *     if (loc) {
-     *         console.log(`Clicked at x: ${loc[0]}, y: ${loc[1]}`);
-     *     }
-     * });
-     * ```
-     * @hidden
-     */
-    getHitResult(event: MouseEvent | PointerEvent | EventInfo): THREE.Vector2 | undefined;
     /**
      * Returns the active layout name, or undefined if none.
      * @example
@@ -299,12 +279,6 @@ export declare class Viewer2d extends BaseViewer {
      * ```
      */
     getLayers(): (DxfLayers | PdfLayers)[];
-    /**
-     * Sets model's (aka, a dxf file) visibility.
-     * @throws Throws exception if modelId doesn't exist.
-     * @hidden
-     */
-    setModelVisibility(modelId: string, visible: boolean): void;
     /**
      * Sets visibility of a layer by name.
      * @param layerName Layer to show or hide.
@@ -318,22 +292,6 @@ export declare class Viewer2d extends BaseViewer {
      * ```
      */
     setLayerVisibility(layerName: string, visible: boolean, modelId?: string): void;
-    /**
-     * Sets layer's opacity
-     * @hidden
-     */
-    setLayerOpacity(layerName: string, opacity: number, modelId?: string): void;
-    /**
-     * Sets layer's color
-     * @throws Throws exception if layer doesn't exist.
-     * @hidden
-     */
-    setLayerColor(layerName: string, color: number, modelId?: string): void;
-    /**
-     * Resets a layer's color.
-     * @hidden
-     */
-    resetLayerColor(layerName: string, modelId?: string): void;
     /**
      * Enables small feature culling in order to improve performance.
      */

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

@@ -3,17 +3,32 @@ 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;
+    /**
+     * 3D selection set (supports multi-select). Order is insertion order.
+     * For legacy single-select APIs, the "highlighted object" is the last selected.
+     */
+    private selectedObjects;
     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.
@@ -95,6 +110,17 @@ export declare class Viewer3d extends BaseViewer {
      */
     getHighlightedObject(): THREE.Object3D | undefined;
     clearHighlight(): void;
+    /**
+     * Adds an object to the current selection set (multi-select).
+     * Does not clear existing selection.
+     */
+    addObjectToSelection(object: THREE.Object3D): void;
+    /** Removes an object from current selection set (multi-select). */
+    removeObjectFromSelection(object: THREE.Object3D): void;
+    /** Returns a shallow copy of current selection set (multi-select). */
+    getSelectedObjects(): THREE.Object3D[];
+    /** True when {@link object} is in the current selection set. */
+    isObjectSelected(object: THREE.Object3D): boolean;
     setDoubleSidedMaterials(): void;
     revertDoubleSidedMaterials(): void;
     clearSelection(): void;
@@ -134,4 +160,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/dist/types/core/viewers/ViewerEvent.d.ts

@@ -105,5 +105,10 @@ export declare enum ViewerEvent {
     /**
      * Triggered when selected object changed.
      */
-    ObjectDeselected = "objectdeselected"
+    ObjectDeselected = "objectdeselected",
+    /**
+     * Triggered when a selected object's transform (position/rotation/scale) is changed,
+     * either by the transform gizmo or programmatically.
+     */
+    ObjectTransformed = "objecttransformed"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@x-viewer/core",
-    "version": "0.21.13",
+    "version": "0.21.15",
     "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",
@@ -70,7 +70,7 @@
         "2d-polygon-boolean": "^1.0.1",
         "2d-polygon-self-intersections": "^1.3.1",
         "3d-tiles-renderer": "0.3.32",
-        "@mlightcad/libredwg-web": "^0.6.7",
+        "@mlightcad/libredwg-web": "^0.7.1",
         "camera-controls": "^1.37.4",
         "clipper-lib": "^6.4.2",
         "concaveman": "^1.2.1",