@cognite/reveal 4.9.2 → 4.10.1

package/dist/packages/api/src/public/migration/Cognite3DViewer.d.ts

@@ -279,7 +279,7 @@ export declare class Cognite3DViewer {
      * @param datasource The data data source which holds the references to the 360 image sets.
      * @param dataModelIdentifier The search parameters to apply when querying Cognite Datamodels that contains the 360 images.
      */
-    add360ImageSet(datasource: 'datamodels', dataModelIdentifier: Image360DataModelIdentifier): Promise<Image360Collection>;
+    add360ImageSet(datasource: 'datamodels', dataModelIdentifier: Image360DataModelIdentifier, add360ImageOptions?: AddImage360Options): Promise<Image360Collection>;
     /**
      * Adds a set of 360 images to the scene from the /events API in Cognite Data Fusion.
      * @param datasource The CDF data source which holds the references to the 360 image sets.

package/dist/packages/camera-manager/index.d.ts

@@ -11,6 +11,7 @@ export { ComboControlsOptions } from './src/ComboControlsOptions';
 export { CameraControlsOptions } from './src/CameraControlsOptions';
 export { DebouncedCameraStopEventTrigger } from './src/utils/DebouncedCameraStopEventTrigger';
 export { IFlexibleCameraManager } from './src/Flexible/IFlexibleCameraManager';
+export { FlexibleControlsTypeChangeDelegate } from './src/Flexible/IFlexibleCameraManager';
 export { FlexibleCameraManager } from './src/Flexible/FlexibleCameraManager';
 export { FlexibleControlsOptions } from './src/Flexible/FlexibleControlsOptions';
 export { FlexibleWheelZoomType } from './src/Flexible/FlexibleWheelZoomType';

package/dist/packages/camera-manager/src/Flexible/DampedSpherical.d.ts

@@ -7,14 +7,17 @@ export declare class DampedSpherical {
     readonly end: Spherical;
     private readonly _valueVector;
     private readonly _endVector;
+    static isVertical(vector: Vector3): boolean;
     isChanged(epsilon: number): boolean;
     getValueVector(): Vector3;
     getEndVector(): Vector3;
     setValueVector(vector: Vector3): void;
     setEndVector(vector: Vector3): void;
+    setThetaFromVector(vector: Vector3): void;
     copy(vector: Vector3): void;
     synchronize(): void;
     synchronizeEnd(): void;
     damp(dampeningFactor: number): void;
+    static correctPhi(value: Spherical): void;
     static dampSphericalVectors(value: Spherical, end: Spherical, dampeningFactor: number): void;
 }

package/dist/packages/camera-manager/src/Flexible/DampedVector3.d.ts

@@ -14,6 +14,7 @@ export declare class DampedVector3 {
     copy(value: Vector3): void;
     add(other: DampedVector3): void;
     synchronize(): void;
+    synchronizeEnd(): void;
     damp(dampeningFactor: number): void;
     /**
      * Suppose this(DampedVector3) is the position that orbits around the center point (DampedVector3). This has to be damped as a vector

package/dist/packages/camera-manager/src/Flexible/FlexibleCameraManager.d.ts

@@ -7,7 +7,8 @@ import { FlexibleControlsOptions } from './FlexibleControlsOptions';
 import { InputHandler } from '../../../utilities';
 import { CameraEventDelegate, CameraManagerCallbackData, CameraManagerEventType, CameraState } from './../types';
 import { CameraManager } from './../CameraManager';
-import { IFlexibleCameraManager } from './IFlexibleCameraManager';
+import { FlexibleControlsType } from './FlexibleControlsType';
+import { FlexibleControlsTypeChangeDelegate, IFlexibleCameraManager } from './IFlexibleCameraManager';
 type RaycastCallback = (x: number, y: number, pickBoundingBox: boolean) => Promise<CameraManagerCallbackData>;
 /**
  * Flexible implementation of {@link CameraManager}. The user can switch between Orbit, FirstPersion or OrbitInCenter
@@ -15,7 +16,7 @@ type RaycastCallback = (x: number, y: number, pickBoundingBox: boolean) => Promi
  * @beta
  */
 export declare class FlexibleCameraManager implements IFlexibleCameraManager {
-    private readonly _events;
+    private readonly _triggers;
     private readonly _stopEventTrigger;
     private readonly _controls;
     private readonly _camera;
@@ -46,6 +47,10 @@ export declare class FlexibleCameraManager implements IFlexibleCameraManager {
     fitCameraToBoundingBox(boundingBox: Box3, duration?: number, radiusFactor?: number): void;
     update(deltaTime: number, boundingBox: Box3): void;
     dispose(): void;
+    get controlsType(): FlexibleControlsType;
+    set controlsType(value: FlexibleControlsType);
+    addControlsTypeChangeListener(callback: FlexibleControlsTypeChangeDelegate): void;
+    removeControlsTypeChangeListener(callback: FlexibleControlsTypeChangeDelegate): void;
     get options(): FlexibleControlsOptions;
     get controls(): FlexibleControls;
     get camera(): PerspectiveCamera;
@@ -55,12 +60,15 @@ export declare class FlexibleCameraManager implements IFlexibleCameraManager {
     private set isEnabled(value);
     private getPosition;
     private getTarget;
+    getBoundingBoxDiagonal(): number;
+    getHorizontalDiagonal(): number;
     setPositionAndTarget(position: Vector3, target: Vector3): void;
-    private getPickedPointPixelCoordinates;
+    private readonly getPickedPointByPixelCoordinates;
     private getTargetByBoundingBox;
     private addEventListeners;
     private removeEventListeners;
     private readonly onCameraChange;
+    private readonly onControlsTypeChange;
     private readonly onKeyDown;
     private readonly onClick;
     private readonly onDoubleClick;
@@ -69,7 +77,5 @@ export declare class FlexibleCameraManager implements IFlexibleCameraManager {
     private setTargetAndCameraPosition;
     private updateCameraNearAndFar;
     private updateControlsSensitivity;
-    getBoundingBoxDiagonal(): number;
-    getHorizontalDiagonal(): number;
 }
 export {};

package/dist/packages/camera-manager/src/Flexible/FlexibleControls.d.ts

@@ -1,22 +1,19 @@
 /*!
  * Copyright 2024 Cognite AS
  */
-import { EventDispatcher, OrthographicCamera, PerspectiveCamera, Quaternion, Vector3 } from 'three';
+import { EventDispatcher, OrthographicCamera, PerspectiveCamera, Quaternion, Vector2, Vector3 } from 'three';
 import { FlexibleControlsType } from './FlexibleControlsType';
 import { FlexibleControlsOptions } from './FlexibleControlsOptions';
-export type FlexibleControlsEvent = {
-    cameraChange: {
-        camera: {
-            position: Vector3;
-            target: Vector3;
-        };
-    };
-};
+import { DampedVector3 } from './DampedVector3';
+import { DampedSpherical } from './DampedSpherical';
+import { FlexibleControlsEvent } from './FlexibleControlsEvent';
+import { GetPickedPointByPixelCoordinates } from './GetPickedPointByPixelCoordinates';
 /**
  * @beta
  */
 export declare class FlexibleControls extends EventDispatcher<FlexibleControlsEvent> {
     private _isEnabled;
+    private _isInitialized;
     temporarlyDisableKeyboard: boolean;
     private readonly _options;
     private readonly _domElement;
@@ -27,66 +24,69 @@ export declare class FlexibleControls extends EventDispatcher<FlexibleControlsEv
     private _scrollDirection;
     private _scrollDistance;
     private _tempTarget;
-    private readonly _rawCameraRotation;
-    private readonly _accumulatedMouseRotation;
     private readonly _keyboard;
     private readonly _pointEventCache;
+    private _getPickedPointByPixelCoordinates;
     private readonly _reusableVector3s;
     constructor(camera: PerspectiveCamera | OrthographicCamera, domElement: HTMLElement, options: FlexibleControlsOptions);
     dispose(): void;
     get options(): FlexibleControlsOptions;
+    get camera(): PerspectiveCamera | OrthographicCamera;
+    get cameraVector(): DampedSpherical;
+    get cameraPosition(): DampedVector3;
     get isEnabled(): boolean;
-    set isEnabled(isEnabled: boolean);
-    /**
-     * Camera rotation to be used by the camera instead of target-based rotation.
-     * This rotation is used only when set to non-default quaternion value (not identity rotation quaternion).
-     * Externally, value is updated by `CameraManager` when `setState` method with non-zero rotation is called. Automatically
-     * resets to default value when `setState` method is called with no rotation value.
-     */
-    get cameraRawRotation(): Quaternion;
+    set isEnabled(value: boolean);
+    get isInitialized(): boolean;
+    set isInitialized(value: boolean);
     get controlsType(): FlexibleControlsType;
+    set getPickedPointByPixelCoordinates(getPickedPointByPixelCoordinates: GetPickedPointByPixelCoordinates | undefined);
+    get getPickedPointByPixelCoordinates(): GetPickedPointByPixelCoordinates | undefined;
     getTarget(): Vector3;
     setTarget(value: Vector3): void;
-    getLookAt(): Vector3;
+    private getLookAt;
     getState(): {
         target: Vector3;
         position: Vector3;
     };
+    private getMousePosition;
+    getNormalizedPixelCoordinates(event: PointerEvent): Vector2;
     setScrollCursor(value: Vector3 | undefined): void;
     setTempTarget(value: Vector3 | undefined): void;
-    setState(position: Vector3, target: Vector3): void;
+    setPositionAndTarget(position: Vector3, target: Vector3): void;
+    setPositionAndDirection(position: Vector3, direction: Vector3): void;
+    setPositionAndRotation(position: Vector3, rotation: Quaternion): void;
     setControlsType(controlsType: FlexibleControlsType): boolean;
     private getPanFactor;
     private getWheelSpeed;
     private getDampingFactor;
     private newVector3;
     update(deltaTimeS: number, forceUpdate?: boolean): boolean;
-    triggerCameraChangeEvent: () => void;
+    triggerCameraChangeEvent(): void;
+    triggerControlsTypeChangeEvent(): void;
     private readonly onPointerDown;
     private readonly onMouseDown;
+    private startMouse;
     private readonly onPointerUp;
-    private readonly onMouseUp;
     private readonly onMouseWheel;
     private readonly onTouchStart;
     private readonly onFocusChanged;
     private readonly onContextMenu;
     addEventListeners(): void;
     private removeEventListeners;
-    private startMouseRotation;
     private startTouchRotation;
     private rotate;
-    private getAzimuthCompensationFactor;
-    private rotateByAngles;
+    getAzimuthCompensationFactor(): number;
+    rotateByAngles(deltaAzimuth: number, deltaPolar: number): void;
     private rawRotateByAngles;
     private startTouchPinch;
-    private startMousePan;
     private pan;
-    private translate;
+    translate(delta: Vector3): void;
     private dollyOrthographicCamera;
     private dollyWithWheelScroll;
-    private getRadiusAndTranslation;
+    private getTranslation;
     private getTranslationByDirection;
     private getTranslationByScrollCursor;
+    private getStep;
     private handleKeyboard;
     private handleRotationFromKeyboard;
     private handleMoveFromKeyboard;

package/dist/packages/camera-manager/src/Flexible/FlexibleControlsEvent.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2024 Cognite AS
+ */
+import { Vector3 } from 'three';
+import { FlexibleControlsType } from './FlexibleControlsType';
+/**
+ * @beta
+ */
+export type FlexibleControlsEvent = {
+    cameraChange: {
+        content: {
+            position: Vector3;
+            target: Vector3;
+        };
+    };
+    controlsTypeChange: {
+        controlsType: FlexibleControlsType;
+    };
+};

package/dist/packages/camera-manager/src/Flexible/FlexibleControlsTranslator.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2024 Cognite AS
+ */
+import { FlexibleControls } from './FlexibleControls';
+/**
+ * @beta
+ * This class handles the translation of the camera.
+ * It tries to translate the camera so the same (x,y, z) point is below the mouse
+ */
+export declare class FlexibleControlsTranslator {
+    private readonly _controls;
+    private readonly _prevPickedPoint;
+    private readonly _plane;
+    private readonly _raycaster;
+    private _camera;
+    constructor(controls: FlexibleControls);
+    initialize(event: PointerEvent): Promise<boolean>;
+    translate(event: PointerEvent): boolean;
+}

package/dist/packages/camera-manager/src/Flexible/GetPickedPointByPixelCoordinates.d.ts

@@ -0,0 +1,5 @@
+/*!
+ * Copyright 2024 Cognite AS
+ */
+import { Vector3 } from 'three';
+export type GetPickedPointByPixelCoordinates = (pixelX: number, pixelY: number) => Promise<Vector3>;

package/dist/packages/camera-manager/src/Flexible/IFlexibleCameraManager.d.ts

@@ -1,13 +1,20 @@
 /*!
  * Copyright 2024 Cognite AS
  */
-import { FlexibleControlsOptions } from './FlexibleControlsOptions';
 import { CameraManager } from '../CameraManager';
+import { FlexibleControlsType } from './FlexibleControlsType';
+/**
+ * @beta
+ */
+export type FlexibleControlsTypeChangeDelegate = (controlsType: FlexibleControlsType) => void;
 /**
  * Flexible implementation of {@link CameraManager}. The user can switch between Orbit, FirstPersion or OrbitInCenter
  * Supports automatic update of camera near and far planes and animated change of camera position and target.
  * @beta
  */
 export interface IFlexibleCameraManager extends CameraManager {
-    get options(): FlexibleControlsOptions;
+    get controlsType(): FlexibleControlsType;
+    set controlsType(value: FlexibleControlsType);
+    addControlsTypeChangeListener(callback: FlexibleControlsTypeChangeDelegate): void;
+    removeControlsTypeChangeListener(callback: FlexibleControlsTypeChangeDelegate): void;
 }

package/dist/packages/tools/src/HtmlOverlay/BucketGrid2D.d.ts

@@ -1,7 +1,4 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-import * as THREE from 'three';
+import { Box2 } from 'three';
 /**
  * Data structure that splits a 2D region into cells where each cell can contain zero to many
  * elements. Elements can be stored in several cells. This data structure make overlap lookups
@@ -20,9 +17,9 @@ export declare class BucketGrid2D<T> {
      * This is used to avoid expensive re-allocations of cells when removing elements.
      */
     private readonly _removedElements;
-    constructor(bounds: THREE.Box2, dimensions: [width: number, height: number]);
-    insert(bounds: THREE.Box2, element: T): void;
-    overlappingElements(bounds: THREE.Box2): Generator<T>;
-    removeOverlappingElements(bounds: THREE.Box2): Generator<T>;
+    constructor(bounds: Box2, dimensions: [width: number, height: number]);
+    insert(bounds: Box2, element: T): void;
+    overlappingElements(bounds: Box2): Generator<T>;
+    removeOverlappingElements(bounds: Box2): Generator<T>;
     private cellsIntersecting;
 }

package/dist/packages/utilities/index.d.ts

@@ -5,7 +5,7 @@ export { traverseDepthFirst } from './src/objectTraversal';
 export { transformCameraConfiguration } from './src/transformCameraConfiguration';
 export { RandomColors } from './src/RandomColors';
 export { CameraConfiguration } from './src/CameraConfiguration';
-export { EventTrigger, clickOrTouchEventOffset, InputHandler, disposeOfAllEventListeners } from './src/events';
+export { EventTrigger, clickOrTouchEventOffset, getClickOrTouchEventPoint, InputHandler, disposeOfAllEventListeners } from './src/events';
 export { DisposedDelegate, BeforeSceneRenderedDelegate, SceneRenderedDelegate, PointerEventDelegate, PointerEventData } from './src/events/types';
 export { assertNever } from './src/assertNever';
 export { NumericRange } from './src/NumericRange';

package/dist/packages/utilities/src/events/clickOrTouchEventOffset.d.ts

@@ -1,13 +1,21 @@
 /*!
  * Copyright 2021 Cognite AS
  */
+import { Vector2 } from 'three';
 /**
  * Determines clicked or touched coordinate as offset
- * @param ev        An PointerEvent or WheelEvent.
+ * @param event     An PointerEvent or WheelEvent.
  * @param target    HTML element to find coordinates relative to.
  * @returns A struct containing coordinates relative to the HTML element provided.
  */
-export declare function clickOrTouchEventOffset(ev: PointerEvent | WheelEvent, target: HTMLElement): {
+export declare function clickOrTouchEventOffset(event: PointerEvent | WheelEvent, target: HTMLElement): {
     offsetX: number;
     offsetY: number;
 };
+/**
+ * Determines clicked or touched coordinate as offset
+ * @param event     An PointerEvent or WheelEvent.
+ * @param target    HTML element to find coordinates relative to.
+ * @returns A Vector2 containing coordinates relative to the HTML element provided.
+ */
+export declare function getClickOrTouchEventPoint(event: PointerEvent | WheelEvent, target: HTMLElement): Vector2;

package/dist/packages/utilities/src/events/index.d.ts

@@ -1,7 +1,7 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-export { clickOrTouchEventOffset } from './clickOrTouchEventOffset';
+export { clickOrTouchEventOffset, getClickOrTouchEventPoint } from './clickOrTouchEventOffset';
 export { EventTrigger } from './EventTrigger';
 export { InputHandler, disposeOfAllEventListeners } from './InputHandler';
 export * from './types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/reveal",
-  "version": "4.9.2",
+  "version": "4.10.1",
   "description": "WebGL based 3D viewer for CAD and point clouds processed in Cognite Data Fusion.",
   "homepage": "https://github.com/cognitedata/reveal/tree/master/viewer",
   "repository": {
@@ -71,7 +71,7 @@
     "html2canvas": "^1.4.1",
     "lodash": "4.17.21",
     "loglevel": "1.9.1",
-    "mixpanel-browser": "2.48.1",
+    "mixpanel-browser": "2.49.0",
     "path-browserify": "1.0.1",
     "random-seed": "0.3.0",
     "rxjs": "7.8.1",
@@ -81,7 +81,7 @@
   "devDependencies": {
     "@azure/msal-browser": "2.38.3",
     "@cognite/sdk": "8.3.0",
-    "@microsoft/api-extractor": "7.39.4",
+    "@microsoft/api-extractor": "7.40.1",
     "@types/dat.gui": "0.7.12",
     "@types/gl": "^6.0.2",
     "@types/glob": "8.1.0",
@@ -90,15 +90,15 @@
     "@types/jest-image-snapshot": "6.4.0",
     "@types/jsdom": "21.1.6",
     "@types/lodash": "4.14.202",
-    "@types/mixpanel-browser": "2.48.1",
-    "@types/node": "18.19.14",
+    "@types/mixpanel-browser": "2.49.0",
+    "@types/node": "18.19.15",
     "@types/random-seed": "0.3.5",
     "@types/skmeans": "0.11.7",
     "@types/stats": "0.16.30",
     "@types/three": "0.158.2",
     "@types/tween.js": "18.5.1",
-    "@typescript-eslint/eslint-plugin": "6.20.0",
-    "@typescript-eslint/parser": "6.20.0",
+    "@typescript-eslint/eslint-plugin": "6.21.0",
+    "@typescript-eslint/parser": "6.21.0",
     "concurrently": "8.2.2",
     "cross-env": "7.0.3",
     "dat.gui": "0.7.9",
@@ -108,7 +108,7 @@
     "eslint-plugin-jsdoc": "46.10.1",
     "eslint-plugin-lodash": "7.4.0",
     "eslint-plugin-prettier": "5.1.3",
-    "eslint-plugin-unused-imports": "3.0.0",
+    "eslint-plugin-unused-imports": "3.1.0",
     "file-loader": "6.2.0",
     "gl": "6.0.2",
     "glob": "10.3.10",
@@ -123,7 +123,7 @@
     "jsdom": "23.2.0",
     "moq.ts": "10.0.8",
     "nock": "13.5.1",
-    "prettier": "3.2.4",
+    "prettier": "3.2.5",
     "process": "0.11.10",
     "puppeteer": "21.11.0",
     "random-seed": "0.3.0",