@x-viewer/core 0.21.13 → 0.21.15

package/dist/types/core/Configs.d.ts

@@ -119,6 +119,13 @@ export interface ModelConfig {
      * @default false
      */
     merge?: boolean;
+    /**
+     * When true, mesh geometry is quantized after load.
+     * When false, quantization is skipped.
+     * When omitted, {@link Viewer3d} uses {@link BaseViewer.enableQuantization};
+     * @hidden
+     */
+    quantize?: boolean;
     /**
      * Whether to generate and display edges/outlines for the model.
      * Useful for Viewer3d to show wireframe edges.

package/dist/types/core/Constants.d.ts

@@ -49,6 +49,29 @@ export declare const HighlightColorRgba: number[];
  * Object outline color.
  */
 export declare const OutlineColorRgba: number[];
+/**
+ * 3D selection outline (EffectComposer OutlinePass) — saturated UI orange (gltfEditor-like).
+ * Composites after {@link OutputPass}; use display-referred sRGB.
+ */
+export declare const SelectionOutlineVisibleColor = 16742144;
+/**
+ * Hidden-edge tint for OutlinePass. Match {@link SelectionOutlineVisibleColor} so depth-classified “hidden”
+ * segments do not read as missing (closer to gltfeditor-style continuous orange).
+ */
+export declare const SelectionOutlineHiddenColor = 16742144;
+/**
+ * OutlinePass edge strength. Additive blend on bright backgrounds needs a higher value to stay visible.
+ */
+export declare const SelectionOutlineEdgeStrength = 10;
+/** No secondary blur halo (glow pass off). */
+export declare const SelectionOutlineEdgeGlow = 0;
+/** Blur radius in OutlinePass edge buffers — ~2–4 px at full internal resolution; see EffectManager pixel ratio. */
+export declare const SelectionOutlineEdgeThickness = 3.5;
+/**
+ * OutlinePass internal downsample (default in three.js is 2). Use 1 for sharper screen-space edges
+ * (slightly higher GPU cost).
+ */
+export declare const SelectionOutlineDownSampleRatio = 1;
 /**
  * Default object opacity value.
  */

package/dist/types/core/controls/TransformControls.d.ts

@@ -0,0 +1,292 @@
+import * as THREE from "three";
+import { TransformMode } from "./TransformGizmo";
+export type TransformControlsMode = TransformMode;
+export type PropertyName = "camera" | "object" | "enabled" | "axis" | "mode" | "translationSnap" | "rotationSnap" | "scaleSnap" | "space" | "size" | "dragging" | "showX" | "showY" | "showZ" | "minX" | "maxX" | "minY" | "maxY" | "minZ" | "maxZ" | "worldPosition" | "worldPositionStart" | "worldQuaternion" | "worldQuaternionStart" | "cameraPosition" | "cameraQuaternion" | "pointStart" | "pointEnd" | "rotationAxis" | "rotationAngle" | "eye";
+export type EventName = "camera-changed" | "object-changed" | "enabled-changed" | "axis-changed" | "mode-changed" | "translationSnap-changed" | "rotationSnap-changed" | "scaleSnap-changed" | "space-changed" | "size-changed" | "dragging-changed" | "showX-changed" | "showY-changed" | "showZ-changed" | "minX-changed" | "maxX-changed" | "minY-changed" | "maxY-changed" | "minZ-changed" | "maxZ-changed" | "worldPosition-changed" | "worldPositionStart-changed" | "worldQuaternion-changed" | "worldQuaternionStart-changed" | "cameraPosition-changed" | "cameraQuaternion-changed" | "pointStart-changed" | "pointEnd-changed" | "rotationAxis-changed" | "rotationAngle-changed" | "eye-changed";
+export interface TransformControlsEventMap {
+    /**
+     * Fires if any type of change (object or property change) is performed. Property changes are separate events you
+     * can add event listeners to. The event type is "propertyname-changed".
+     */
+    change: object;
+    /**
+     * Fires if a pointer (mouse/touch) becomes active.
+     */
+    mouseDown: {
+        mode: TransformControlsMode;
+    };
+    /**
+     * Fires if a pointer (mouse/touch) is no longer active.
+     */
+    mouseUp: {
+        mode: TransformControlsMode;
+    };
+    /**
+     * Fires if the controlled 3D object is changed.
+     */
+    objectChange: object;
+    /**
+     * start dragging.
+     */
+    draggingStart: object;
+    /**
+     * dragging.
+     */
+    dragging: object;
+    /**
+     * end dragging.
+     */
+    draggingEnd: object;
+    "camera-changed": {
+        value: unknown;
+    };
+    "object-changed": {
+        value: unknown;
+    };
+    "enabled-changed": {
+        value: unknown;
+    };
+    "axis-changed": {
+        value: unknown;
+    };
+    "mode-changed": {
+        value: unknown;
+    };
+    "translationSnap-changed": {
+        value: unknown;
+    };
+    "rotationSnap-changed": {
+        value: unknown;
+    };
+    "scaleSnap-changed": {
+        value: unknown;
+    };
+    "space-changed": {
+        value: unknown;
+    };
+    "size-changed": {
+        value: unknown;
+    };
+    "dragging-changed": {
+        value: unknown;
+    };
+    "showX-changed": {
+        value: unknown;
+    };
+    "showY-changed": {
+        value: unknown;
+    };
+    "showZ-changed": {
+        value: unknown;
+    };
+    "minX-changed": {
+        value: unknown;
+    };
+    "maxX-changed": {
+        value: unknown;
+    };
+    "minY-changed": {
+        value: unknown;
+    };
+    "maxY-changed": {
+        value: unknown;
+    };
+    "minZ-changed": {
+        value: unknown;
+    };
+    "maxZ-changed": {
+        value: unknown;
+    };
+    "worldPosition-changed": {
+        value: unknown;
+    };
+    "worldPositionStart-changed": {
+        value: unknown;
+    };
+    "worldQuaternion-changed": {
+        value: unknown;
+    };
+    "worldQuaternionStart-changed": {
+        value: unknown;
+    };
+    "cameraPosition-changed": {
+        value: unknown;
+    };
+    "cameraQuaternion-changed": {
+        value: unknown;
+    };
+    "pointStart-changed": {
+        value: unknown;
+    };
+    "pointEnd-changed": {
+        value: unknown;
+    };
+    "rotationAxis-changed": {
+        value: unknown;
+    };
+    "rotationAngle-changed": {
+        value: unknown;
+    };
+    "eye-changed": {
+        value: unknown;
+    };
+}
+/**
+ * This class can be used to transform objects in 3D space by adapting a similar interaction model of DCC tools like
+ * Blender. Unlike other controls, it is not intended to transform the scene's camera.
+ *
+ * TransformControls expects that its attached 3D object is part of the scene graph.
+ */
+declare class TransformControls extends THREE.Controls<TransformControlsEventMap> {
+    object: any;
+    enabled: any;
+    camera: any;
+    axis: "X" | "Y" | "Z" | "E" | "XY" | "YZ" | "XZ" | "XYZ" | "XYZE" | null;
+    mode: any;
+    translationSnap: any;
+    rotationSnap: any;
+    scaleSnap: any;
+    space: any;
+    size: any;
+    dragging: any;
+    showX: any;
+    showY: any;
+    showZ: any;
+    minX: any;
+    maxX: any;
+    minY: any;
+    maxY: any;
+    minZ: any;
+    maxZ: any;
+    worldPosition: any;
+    worldPositionStart: any;
+    worldQuaternion: any;
+    worldQuaternionStart: any;
+    cameraPosition: any;
+    cameraQuaternion: any;
+    pointStart: any;
+    pointEnd: any;
+    rotationAxis: any;
+    rotationAngle: any;
+    eye: any;
+    _root: any;
+    _gizmo: any;
+    _plane: any;
+    _offset: any;
+    _startNorm: any;
+    _endNorm: any;
+    _cameraScale: any;
+    _parentPosition: any;
+    _parentQuaternion: any;
+    _parentQuaternionInv: any;
+    _parentScale: any;
+    _worldScaleStart: any;
+    _worldQuaternionInv: any;
+    _worldScale: any;
+    _positionStart: any;
+    _quaternionStart: any;
+    _scaleStart: any;
+    _getPointer: any;
+    _onPointerDown: any;
+    _onPointerHover: any;
+    _onPointerMove: any;
+    _onPointerUp: any;
+    constructor(camera: any, domElement?: any);
+    connect(): void;
+    disconnect(): void;
+    getHelper(): any;
+    pointerHover(pointer: any): void;
+    pointerDown(pointer: any): void;
+    pointerMove(pointer: any): void;
+    pointerUp(pointer: any): void;
+    dispose(): void;
+    attach(object: THREE.Object3D): this;
+    detach(): this;
+    reset(): void;
+    getRaycaster(): THREE.Raycaster;
+    getMode(): any;
+    setMode(mode: any): void;
+    setTranslationSnap(translationSnap: any): void;
+    setRotationSnap(rotationSnap: any): void;
+    setScaleSnap(scaleSnap: any): void;
+    setSize(size: any): void;
+    setSpace(space: any): void;
+}
+declare class TransformControlsGizmo extends THREE.Object3D {
+    object: any;
+    enabled: any;
+    camera: any;
+    axis: any;
+    mode: any;
+    translationSnap: any;
+    rotationSnap: any;
+    scaleSnap: any;
+    space: any;
+    size: any;
+    dragging: any;
+    showX: any;
+    showY: any;
+    showZ: any;
+    minX: any;
+    maxX: any;
+    minY: any;
+    maxY: any;
+    minZ: any;
+    maxZ: any;
+    worldPosition: any;
+    worldPositionStart: any;
+    worldQuaternion: any;
+    worldQuaternionStart: any;
+    cameraPosition: any;
+    cameraQuaternion: any;
+    pointStart: any;
+    pointEnd: any;
+    rotationAxis: any;
+    rotationAngle: any;
+    eye: any;
+    isTransformControlsGizmo: any;
+    readonly type: string;
+    gizmo: any;
+    picker: any;
+    helper: any;
+    constructor();
+    updateMatrixWorld(force: boolean): void;
+}
+declare class TransformControlsPlane extends THREE.Mesh {
+    object: any;
+    enabled: any;
+    camera: any;
+    axis: any;
+    mode: any;
+    translationSnap: any;
+    rotationSnap: any;
+    scaleSnap: any;
+    space: any;
+    size: any;
+    dragging: any;
+    showX: any;
+    showY: any;
+    showZ: any;
+    minX: any;
+    maxX: any;
+    minY: any;
+    maxY: any;
+    minZ: any;
+    maxZ: any;
+    worldPosition: any;
+    worldPositionStart: any;
+    worldQuaternion: any;
+    worldQuaternionStart: any;
+    cameraPosition: any;
+    cameraQuaternion: any;
+    pointStart: any;
+    pointEnd: any;
+    rotationAxis: any;
+    rotationAngle: any;
+    eye: any;
+    isTransformControlsPlane: boolean;
+    readonly type: string;
+    constructor();
+    updateMatrixWorld(force: boolean): void;
+}
+export { TransformControls, TransformControlsGizmo, TransformControlsPlane };

package/dist/types/core/controls/TransformGizmo.d.ts

@@ -0,0 +1,92 @@
+import * as THREE from "three";
+import type { BaseViewer } from "../viewers/BaseViewer";
+/** Default translation snap (world units). */
+export declare const DefaultGizmoTranslationSnap = 0.1;
+/** Default rotation snap in degrees. */
+export declare const DefaultGizmoRotationSnap = 15;
+/** Default scale snap. */
+export declare const DefaultGizmoScaleSnap = 0.25;
+export declare enum CoordinateSpace {
+    Local = "Local",
+    World = "World"
+}
+export declare enum TransformMode {
+    Translate = "Translate",
+    Rotate = "Rotate",
+    Scale = "Scale"
+}
+export declare enum SnapType {
+    None = 0,
+    Floor = 1,
+    Wall = 2,
+    Entity = 4,
+    All = 65535
+}
+export interface SnapConfig {
+    snapEnabled?: boolean;
+    snapType?: SnapType;
+    snapRadius?: number;
+    gizmoTranslationSnap?: number;
+    gizmoScaleSnap?: number;
+    gizmoRotationSnap?: number;
+}
+export interface TransformGizmoCallbacks {
+    onDraggingStart?: () => void;
+    onDragging?: () => void;
+    onDraggingEnd?: () => void;
+    /** Fired after mode changes (toolbar, W/E/S keys, or API). */
+    onTransformModeChange?: (mode: TransformMode) => void;
+}
+/**
+ * Transform gizmo (translate / rotate / scale) for a {@link BaseViewer} 3D scene.
+ */
+export declare class TransformGizmo {
+    private viewer;
+    private scene;
+    private transformControl;
+    private dragStartPosition;
+    private dragStartRotation;
+    private dragStartScale;
+    private target;
+    active: boolean;
+    private space;
+    private lastMode;
+    private snapConfig;
+    private isShiftPressing;
+    private callbacks;
+    private readonly boundKeyDown;
+    private readonly boundKeyUp;
+    private readonly boundBeforeRender;
+    constructor(viewer: BaseViewer, callbacks?: TransformGizmoCallbacks);
+    setCallbacks(callbacks: TransformGizmoCallbacks): void;
+    attach(object: THREE.Object3D): void;
+    detach(): void;
+    isActive(): boolean;
+    getAttachedObject(): THREE.Object3D | undefined;
+    /**
+     * Recomputes gizmo handle positions from the attached object's world matrix
+     * after external edits (e.g. property panel) that do not emit transform control "change".
+     */
+    refreshHelperToAttachedObject(): void;
+    private keyDownEvent;
+    private keyUpEvent;
+    private changedEvent;
+    private draggingStartEvent;
+    private draggingEvent;
+    private draggingEndEvent;
+    enableSnap(enable: boolean): void;
+    isSnapEnabled(): boolean;
+    getSpace(): CoordinateSpace;
+    setSpace(space: CoordinateSpace): void;
+    getTransformMode(): TransformMode;
+    setTransformMode(mode: TransformMode): void;
+    getTranslationSnap(): number;
+    setTranslationSnap(snap: number): void;
+    getRotationSnap(): number;
+    setRotationSnap(snap: number): void;
+    getScaleSnap(): number;
+    setScaleSnap(snap: number): void;
+    getSnapConfig(): SnapConfig;
+    setSnapConfig(config: SnapConfig): void;
+    destroy(): void;
+}

package/dist/types/core/controls/index.d.ts

@@ -2,3 +2,5 @@ export * from "./Control";
 export * from "./OrbitControls";
 export * from "./PlanControls";
 export * from "./CameraControlsEx";
+export * from "./TransformControls";
+export * from "./TransformGizmo";

package/dist/types/core/dxf/DxfLoader.d.ts

@@ -282,17 +282,6 @@ export declare class DxfLoader extends THREE.Loader {
      * Parses DWG/DXF from memory (same pipeline as {@link parse} after download).
      */
     parseFromBuffer(data: ArrayBuffer | Uint8Array, onProgress?: (event: ProgressEvent) => void): Promise<IDxf>;
-    private parseDownloadedContent;
-    /**
-     * Aborts loading or parsing progress if any.
-     * We cann't resume any progress once aborted.
-     * TODO: the abort logic is not well tested yet, need to be verified.
-     */
-    abort(): this;
-    /**
-     * If loading or parsing progress is aborted.
-     */
-    isAborted(): boolean;
     /**
      * Generates/load threejs objects according to the dxf data.
      * @param data