@cognite/reveal 2.0.0-beta.4 → 2.2.0

package/{public → core/src/public}/migration/Cognite3DModel.d.ts

@@ -5,10 +5,10 @@ import * as THREE from 'three';
 import { CogniteInternalId } from '@cognite/sdk';
 import { CameraConfiguration } from './types';
 import { CogniteModelBase } from './CogniteModelBase';
-import { NumericRange } from '../../utilities';
 import { SupportedModelTypes } from '../types';
-import { NodeCollectionBase } from '../../datamodels/cad/styling';
-import { NodeAppearance } from '../../datamodels/cad';
+import { WellKnownUnit } from './types';
+import { NumericRange } from '../../../../packages/utilities';
+import { NodeCollectionBase, NodeAppearance } from '../../../../packages/cad-styling';
 /**
  * Represents a single 3D CAD model loaded from CDF.
  * @noInheritDoc
@@ -16,6 +16,19 @@ import { NodeAppearance } from '../../datamodels/cad';
  */
 export declare class Cognite3DModel extends THREE.Object3D implements CogniteModelBase {
     readonly type: SupportedModelTypes;
+    /**
+     * Returns the unit the coordinates for the model is stored. Returns an empty string
+     * if no unit has been stored.
+     * Note that coordinates in Reveal always are converted to meters using {@see modelUnitToMetersFactor}.
+     * @version New since 2.1
+     */
+    get modelUnit(): WellKnownUnit | '';
+    /**
+     * Returns the conversion factor that converts from model coordinates to meters. Note that this can
+     * return undefined if the model has been stored in an unsupported unit.
+     * @version New since 2.1
+     */
+    get modelUnitToMetersFactor(): number | undefined;
     /**
      * The CDF model ID of the model.
      */
@@ -25,7 +38,7 @@ export declare class Cognite3DModel extends THREE.Object3D implements CogniteMod
      */
     readonly revisionId: number;
     private readonly cadModel;
-    private readonly client;
+    private readonly nodesApiClient;
     private readonly nodeIdAndTreeIndexMaps;
     private readonly _styledNodeCollections;
     /**
@@ -41,6 +54,13 @@ export declare class Cognite3DModel extends THREE.Object3D implements CogniteMod
      * {@link assignStyledNodeCollection}.
      */
     getDefaultNodeAppearance(): NodeAppearance;
+    /**
+     * Returns all currently registered node collections and associated appearance.
+     */
+    get styledNodeCollections(): {
+        nodeCollection: NodeCollectionBase;
+        appearance: NodeAppearance;
+    }[];
     /**
      * Customizes rendering style for a set of nodes, e.g. to highlight, hide
      * or color code a set of 3D objects. This allows for custom look and feel
@@ -67,12 +87,21 @@ export declare class Cognite3DModel extends THREE.Object3D implements CogniteMod
      * const visibleNodes = new TreeIndexNodeCollection(someTreeIndices);
      * model.assignStyledNodeCollection(visibleSet, { rendererGhosted: false });
      * ```
+     * @throws Error if node collection already has been assigned to the model.
      */
     assignStyledNodeCollection(nodeCollection: NodeCollectionBase, appearance: NodeAppearance): void;
+    /**
+     * Updates styled node collections with a new appearance.
+     * @param nodeCollection    A node collection previously assigned using {@link assignStyledNodeCollection}.
+     * @param newAppearance     New appearance for the nodes in the collection.
+     * @throws Error if node collection hasn't previously been assigned using {@link assignStyledNodeCollection}.
+     */
+    updateStyledNodeCollection(nodeCollection: NodeCollectionBase, newAppearance: NodeAppearance): void;
     /**
      * Removes styling for previously added styled collection, resetting the style to the default (or
      * the style imposed by other styled collections).
      * @param nodeCollection   Node collection previously added using {@link assignStyledNodeCollection}.
+     * @throws Error if node collection isn't assigned to the model.
      */
     unassignStyledNodeCollection(nodeCollection: NodeCollectionBase): void;
     /**
@@ -139,11 +168,11 @@ export declare class Cognite3DModel extends THREE.Object3D implements CogniteMod
      *
      * @param treeIndex     Tree index of node to find ancestor tree index range for.
      * @param generation    What "generation" to find. 0 is the node itself,
-     *                      1 means parent, 2 means grandparent etc. If the node doesn't
-     *                      have as many ancestors, the root of the model is returned. This can
-     *                      be determined by checking that the range returned includes 0.
-     * @returns             Tree index range of the subtree spanned by the ancestor at the
-     *                      "generation" specified, or the root.
+     * 1 means parent, 2 means grandparent etc. If the node doesn't have as many
+     * ancestors, the root of the model is returned. This can be determined by checking
+     * that the range returned includes 0.
+     * @returns Tree index range of the subtree spanned by the ancestor at the
+     * "generation" specified, or the root.
      */
     getAncestorTreeIndices(treeIndex: number, generation: number): Promise<NumericRange>;
     /**

package/{public → core/src/public}/migration/Cognite3DViewer.d.ts

@@ -2,15 +2,15 @@
  * Copyright 2021 Cognite AS
  */
 import * as THREE from 'three';
-import { AddModelOptions, Cognite3DViewerOptions, Intersection, CameraChangeDelegate, PointerEventDelegate, CadModelBudget } from './types';
+import { AddModelOptions, Cognite3DViewerOptions, Intersection, CameraChangeDelegate, PointerEventDelegate, CadModelBudget, PointCloudBudget } from './types';
 import { CogniteModelBase } from './CogniteModelBase';
 import { Cognite3DModel } from './Cognite3DModel';
 import { CognitePointCloudModel } from './CognitePointCloudModel';
 import { DisposedDelegate, SceneRenderedDelegate } from '../types';
 import { SupportedModelTypes } from '../../datamodels/base';
 import { IntersectionFromPixelOptions } from '../..';
-import ComboControls from '../../combo-camera-controls';
 import { ViewerState } from '../../utilities/ViewStateHelper';
+import ComboControls from '../../../../packages/camera-manager';
 /**
  * @example
  * ```js
@@ -22,7 +22,6 @@ import { ViewerState } from '../../utilities/ViewStateHelper';
  * @module @cognite/reveal
  */
 export declare class Cognite3DViewer {
-    private readonly _viewStateHelper;
     private get canvas();
     /**
      * For now it just always returns true.
@@ -40,12 +39,13 @@ export declare class Cognite3DViewer {
      * Returns the renderer used to produce images from 3D geometry.
      */
     get renderer(): THREE.WebGLRenderer;
+    private readonly _cdfSdkClient;
+    private readonly _dataSource;
     private readonly camera;
     private readonly scene;
     private readonly controls;
-    private readonly sdkClient;
     private readonly _subscription;
-    private readonly _revealManager;
+    private readonly _revealManagerHelper;
     private readonly _domElement;
     private readonly _renderer;
     private readonly _boundAnimate;
@@ -58,9 +58,9 @@ export declare class Cognite3DViewer {
     private readonly renderController;
     private latestRequestId;
     private readonly clock;
-    private _slicingNeedsUpdate;
-    private _geometryFilters;
+    private _clippingNeedsUpdate;
     private readonly spinner;
+    private get revealManager();
     /**
      * Reusable buffers used by functions in Cognite3dViewer to avoid allocations.
      */
@@ -75,6 +75,16 @@ export declare class Cognite3DViewer {
      * budget is shared between all added CAD models and not a per-model budget.
      */
     set cadBudget(budget: CadModelBudget);
+    /**
+     * Returns the point cloud budget. The budget is shared between all loaded
+     * point cloud models.
+     */
+    get pointCloudBudget(): PointCloudBudget;
+    /**
+     * Sets the point cloud budget. The budget is shared between all loaded
+     * point cloud models.
+     */
+    set pointCloudBudget(budget: PointCloudBudget);
     /**
      * Gets a list of models currently added to the viewer.
      */
@@ -84,6 +94,12 @@ export declare class Cognite3DViewer {
      * Returns reveal version installed.
      */
     getVersion(): string;
+    /**
+     * Sets the log level. Used for debugging.
+     * Defaults to 'none' (which is identical to 'silent').
+     * @param level
+     */
+    setLogLevel(level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent' | 'none'): void;
     /**
      * Dispose of WebGL resources. Can be used to free up memory when the viewer is no longer in use.
      * @see {@link https://threejs.org/docs/#manual/en/introduction/How-to-dispose-of-objects}
@@ -141,7 +157,7 @@ export declare class Cognite3DViewer {
      * node collections and applies the `state` object.
      * @param state Viewer state retrieved from {@link Cognite3DViewer.getViewState}.
      */
-    setViewState(state: ViewerState): void;
+    setViewState(state: ViewerState): Promise<void>;
     /**
      * Add a new model to the viewer.
      * Call {@link Cognite3DViewer.fitCameraToModel} to see the model after the model has loaded.
@@ -264,36 +280,46 @@ export declare class Cognite3DViewer {
      */
     setBackgroundColor(color: THREE.Color): void;
     /**
-     * Sets per-pixel slicing planes. Pixels behind any of the planes will be sliced away.
-     * @param slicingPlanes The planes to use for slicing.
+     * Sets per-pixel clipping planes. Pixels behind any of the planes will be sliced away.
+     * @param clippingPlanes The planes to use for clipping.
      * @example
      * ```js
      * // Hide pixels with values less than 0 in the x direction
      * const plane = new THREE.Plane(new THREE.Vector3(1, 0, 0), 0);
-     * viewer.setSlicingPlanes([plane]);
+     * viewer.setClippingPlanes([plane]);
      * ```
      * ```js
      * // Hide pixels with values greater than 20 in the x direction
      *  const plane = new THREE.Plane(new THREE.Vector3(-1, 0, 0), 20);
-     * viewer.setSlicingPlanes([plane]);
+     * viewer.setClippingPlanes([plane]);
      * ```
      * ```js
      * // Hide pixels with values less than 0 in the x direction or greater than 0 in the y direction
      * const xPlane = new THREE.Plane(new THREE.Vector3(1, 0, 0), 0);
      * const yPlane = new THREE.Plane(new THREE.Vector3(0, -1, 0), 0);
-     * viewer.setSlicingPlanes([xPlane, yPlane]);
+     * viewer.setClippingPlanes([xPlane, yPlane]);
      * ```
      * ```js
      * // Hide pixels behind an arbitrary, non axis-aligned plane
      *  const plane = new THREE.Plane(new THREE.Vector3(1.5, 20, -19), 20);
-     * viewer.setSlicingPlanes([plane]);
+     * viewer.setClippingPlanes([plane]);
      * ```
      * ```js
-     * // Disable slicing planes
-     *  viewer.setSlicingPlanes([]);
+     * // Disable clipping planes
+     *  viewer.setClippingPlanes([]);
      * ```
      */
+    setClippingPlanes(clippingPlanes: THREE.Plane[]): void;
+    /**
+     * @param slicingPlanes
+     * @deprecated Since version 2.1, will be removed in version 3.0. Use {@link setClippingPlanes}.
+     */
     setSlicingPlanes(slicingPlanes: THREE.Plane[]): void;
+    /**
+     * Returns the current active clipping planes.
+     * @version New in 2.1
+     */
+    getClippingPlanes(): THREE.Plane[];
     /**
      * @obvious
      * @returns The THREE.Camera used for rendering.
@@ -412,9 +438,8 @@ export declare class Cognite3DViewer {
     fitCameraToBoundingBox(box: THREE.Box3, duration?: number, radiusFactor?: number): void;
     /**
      * Typically used when you perform some changes and can't see them unless you move camera.
-     * To fix this forceRerender might be used.
      */
-    forceRerender(): void;
+    requestRedraw(): void;
     /**
      * Allows to move camera with WASM or arrows keys.
      */
@@ -516,20 +541,15 @@ export declare class Cognite3DViewer {
     private getModels;
     /** @private */
     private moveCameraTo;
+    /**
+     * Creates a helper for managing viewer state.
+     */
+    private createViewStateHelper;
     /** @private */
     private animate;
     /** @private */
     private updateCameraNearAndFar;
     /** @private */
     private resizeIfNecessary;
-    private startPointerEventListeners;
-    /**
-     * Removes a geometry filter for the model provided.
-     * @param model
-     */
-    private removeGeometryFilterForModel;
-    /**
-     * Updates slicing planes. Must be called after manipulating geometry filters.
-     */
-    private updateSlicingPlanes;
+    private readonly startPointerEventListeners;
 }

package/{public → core/src/public}/migration/CognitePointCloudModel.d.ts

@@ -82,15 +82,9 @@ export declare class CognitePointCloudModel extends THREE.Object3D implements Co
      */
     getClasses(): Array<number | WellKnownAsprsPointClassCodes>;
     /**
-     * Returns the current budget measured in number of points.
+     * Returns the current number of visible/loaded points.
      */
-    get pointBudget(): number;
-    /**
-     * The point budget limits the number of points loaded and rendered at any given time,
-     * which helps to adapt performance requirements to the capabilities of different hardware.
-     * Recommended values are between 500.000  and 10.000.000.
-     */
-    set pointBudget(count: number);
+    get visiblePointCount(): number;
     /**
      * Determines how points currently are colored.
      */

package/{public → core/src/public}/migration/types.d.ts

@@ -12,6 +12,10 @@ export declare type Color = {
     g: number;
     b: number;
 };
+/**
+ * Units supported by {@link Cognite3DModel}.
+ */
+export declare type WellKnownUnit = 'Meters' | 'Centimeters' | 'Millimeters' | 'Micrometers' | 'Kilometers' | 'Feet' | 'Inches' | 'Yards' | 'Miles' | 'Mils' | 'Microinches';
 /**
  * Callback to monitor loaded requests and progress.
  * Use OnLoadingCallback instead of onProgress/onComplete.
@@ -39,6 +43,20 @@ export interface Cognite3DViewerOptions {
         target: THREE.WebGLRenderTarget;
         autoSetSize?: boolean;
     };
+    /**
+     * Style the loading indicator.
+     */
+    loadingIndicatorStyle?: {
+        /**
+         * What corner the spinner should be placed in. Defaults top topLeft.
+         */
+        placement: 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+        /**
+         * Opacity of the spinner in fractions. Valid values are between
+         * 0.2 and 1.0. Defaults to 1.0.
+         */
+        opacity: number;
+    };
     /**
      * When false, camera near and far planes will not be updated automatically (defaults to true).
      * This can be useful when you have custom content in the 3D view and need to better
@@ -92,8 +110,20 @@ export interface Cognite3DViewerOptions {
     enableEdges?: boolean;
     /** Callback to download stream progress. */
     onLoading?: OnLoadingCallback;
+    /**
+     * Allows providing a custom data source that Reveal will
+     * use to load model data. Note that some features might not
+     * work when implementing a custom data source. Please refer
+     * to the Reveal documentation for details.
+     *
+     * Note that the data source must support {@link CdfModelIdentifier}.
+     *
+     * This cannot be used together with {@link _localModels}.
+     */
+    customDataSource?: DataSource;
 }
 import { GeometryFilter } from '../../public/types';
+import { DataSource } from '../../../../packages/data-source';
 export { GeometryFilter };
 /**
  * @module @cognite/reveal
@@ -103,8 +133,6 @@ export interface AddModelOptions {
     revisionId: number;
     localPath?: string;
     geometryFilter?: GeometryFilter;
-    orthographicCamera?: boolean;
-    onComplete?: () => void;
 }
 export declare type CadIntersection = {
     /**
@@ -158,7 +186,7 @@ export declare type Intersection = CadIntersection | PointCloudIntersection;
 /**
  * @module @cognite/reveal
  */
-export { CameraConfiguration } from '../../utilities';
+export { CameraConfiguration } from '../../../../packages/utilities';
 /**
  * Delegate for pointer events.
  * @module @cognite/reveal
@@ -208,6 +236,22 @@ export declare type CadModelBudget = {
      * are very important for the framerate.
      */
     readonly maximumNumberOfDrawCalls: number;
+    /**
+     * Maximum render cost. This number can be thought of as triangle count, although the number
+     * doesn't match this directly.
+     */
+    readonly maximumRenderCost: number;
+};
+/**
+ * Represents a budget of how many point from point clouds can be
+ * loaded at the same time.
+ */
+export declare type PointCloudBudget = {
+    /**
+     * Total number of points that can be loaded for all point clouds models
+     * accumulated.
+     */
+    readonly numberOfPoints: number;
 };
 /**
  * Options to control how {@link Cognite3DViewer.getIntersectionFromPixel} behaves.

package/core/src/public/types.d.ts

@@ -0,0 +1,46 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import { LoadingState, SectorCuller } from '../../../packages/cad-geometry-loaders';
+import { SectorQuads, RenderOptions } from '../../../packages/rendering';
+import { SectorGeometry } from '../../../packages/cad-parsers';
+/**
+ * @property logMetrics Might be used to disable usage statistics.
+ * @property nodeAppearanceProvider Style node by tree-index.
+ * @property internal Internals are for internal usage only (like unit-testing).
+ */
+export declare type RevealOptions = {
+    logMetrics?: boolean;
+    renderOptions?: RenderOptions;
+    internal?: {
+        parseCallback?: (parsed: {
+            lod: string;
+            data: SectorGeometry | SectorQuads;
+        }) => void;
+        sectorCuller?: SectorCuller;
+    };
+};
+export interface GeometryFilter {
+    /**
+     * The bounds to load geometry within. By default this box is in CDF coordinate space which
+     * will be transformed into coordinates relative to the model using the the model transformation
+     * which can be specified using {@link https://docs.cognite.com/api/v1/#operation/update3DRevisions |the CDF API},
+     * or set in {@link https://fusion.cognite.com/ |Cognite Fusion}.
+     * @see {@link isBoundingBoxInModelCoordinates}.
+     */
+    boundingBox?: THREE.Box3;
+    /**
+     * When set, the geometry filter {@link boundingBox} will be considered to be in "Reveal/ThreeJS space".
+     * Rather than CDF space which is the default. When using Reveal space, the model transformation
+     * which can be specified using {@link https://docs.cognite.com/api/v1/#operation/update3DRevisions |the CDF API},
+     * or set in {@link https://fusion.cognite.com/ |Cognite Fusion}.
+     */
+    isBoundingBoxInModelCoordinates?: boolean;
+}
+/**
+ * Handler for events about data being loaded.
+ */
+export declare type LoadingStateChangeListener = (loadingState: LoadingState) => any;
+export * from '../datamodels/pointcloud/types';
+export * from './migration/types';
+export { SupportedModelTypes } from '../datamodels/base';

package/core/src/storage/RevealManagerHelper.d.ts

@@ -0,0 +1,58 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import * as THREE from 'three';
+import { AddModelOptions } from '../public/migration/types';
+import { RevealOptions } from '../public/types';
+import { PointCloudNode, RevealManager } from '../internals';
+import { DataSource } from '../../../packages/data-source';
+import { CadNode } from '../../../packages/rendering';
+import { CogniteClient } from '@cognite/sdk';
+/**
+ * Helper for {@link RevealManager} for creating a uniform interface for
+ * working with instances that fetch models from CDF or instances that fetch
+ * models from local storage (i.e. in development/debugging).
+ */
+export declare class RevealManagerHelper {
+    private readonly _revealManager;
+    addCadModel: (model: AddModelOptions) => Promise<CadNode>;
+    addPointCloudModel: (model: AddModelOptions) => Promise<PointCloudNode>;
+    private constructor();
+    private constructor();
+    /**
+     * Create helper for RevealManager that loads models from local storage. This is only
+     * meant for use in debugging and development.
+     * @param renderer
+     * @param scene
+     * @param revealOptions
+     */
+    static createLocalHelper(renderer: THREE.WebGLRenderer, scene: THREE.Scene, revealOptions: RevealOptions): RevealManagerHelper;
+    /**
+     * Creates a helper for RevealManager that loads models from CDF.
+     * @param renderer
+     * @param scene
+     * @param revealOptions
+     * @param sdkClient
+     */
+    static createCdfHelper(renderer: THREE.WebGLRenderer, scene: THREE.Scene, revealOptions: RevealOptions, sdkClient: CogniteClient): RevealManagerHelper;
+    static createCustomDataSourceHelper(renderer: THREE.WebGLRenderer, scene: THREE.Scene, revealOptions: RevealOptions, dataSource: DataSource): RevealManagerHelper;
+    get revealManager(): RevealManager;
+    /**
+     * Adds a local CAD model.
+     * @param model
+     * @param revealManager
+     */
+    private static addLocalCadModel;
+    /**
+     * Adds a CDF hosted CAD model.
+     * @param model
+     * @param revealManager
+     */
+    private static addCdfCadModel;
+    /**
+     * Add a CDF hosted point cloud model.
+     * @param model
+     * @param revealManager
+     */
+    private static addCdfPointCloudModel;
+}

package/{utilities → core/src/utilities}/BoundingBoxClipper.d.ts

@@ -3,10 +3,9 @@
  */
 import * as THREE from 'three';
 export declare class BoundingBoxClipper {
-    private _intersection;
     private readonly _box;
     private readonly _clippingPlanes;
-    constructor(box?: THREE.Box3, intersection?: boolean);
+    constructor(box?: THREE.Box3);
     set minX(x: number);
     get minX(): number;
     set minY(y: number);
@@ -19,8 +18,6 @@ export declare class BoundingBoxClipper {
     get maxY(): number;
     set maxZ(z: number);
     get maxZ(): number;
-    set intersection(value: boolean);
-    get intersection(): boolean;
     private updatePlanes;
     get clippingPlanes(): THREE.Plane[];
 }

package/{utilities → core/src/utilities}/Spinner.d.ts

@@ -2,18 +2,17 @@
  * Copyright 2021 Cognite AS
  */
 import * as THREE from 'three';
+export declare type Corner = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
 export declare class Spinner {
     private static readonly stylesId;
-    static classnames: {
-        base: string;
-        loading: string;
-        dark: string;
-    };
+    private static readonly classnames;
     private static readonly titles;
     private _loading;
     private static loadStyles;
     private readonly el;
     constructor(parent: HTMLElement);
+    set placement(placement: Corner);
+    set opacity(fractionOpacity: number);
     get loading(): boolean;
     set loading(loadingState: boolean);
     /**

package/{utilities → core/src/utilities}/ViewStateHelper.d.ts

@@ -1,10 +1,10 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-import { NodeAppearance } from '../datamodels/cad/NodeAppearance';
+import * as THREE from 'three';
 import { Cognite3DViewer } from '../public/migration/Cognite3DViewer';
+import { NodeAppearance } from '../../../packages/cad-styling';
 import { CogniteClient } from '@cognite/sdk';
-import * as THREE from 'three';
 export declare type ViewerState = {
     camera: {
         position: THREE.Vector3;
@@ -26,8 +26,8 @@ export declare type ModelState = {
 export declare class ViewStateHelper {
     private readonly _cameraControls;
     private readonly _viewer;
-    private _client;
-    constructor(viewer: Cognite3DViewer, client: CogniteClient);
+    private readonly _cdfClient;
+    constructor(viewer: Cognite3DViewer, cdfClient: CogniteClient);
     getCurrentState(): ViewerState;
-    setState(viewerState: ViewerState): void;
+    setState(viewerState: ViewerState): Promise<void>;
 }

package/core/src/utilities/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+export { worldToViewportCoordinates, worldToNormalizedViewportCoordinates } from './worldToViewport';
+export { BoundingBoxClipper } from './BoundingBoxClipper';
+export { assertNever, EventTrigger } from '../../../packages/utilities';
+export { LoadingState } from '../../../packages/cad-geometry-loaders';
+export { LocalModelIdentifier, CdfModelIdentifier } from '../../../packages/modeldata-api';

package/{utilities → core/src/utilities}/reflection.d.ts

@@ -5,9 +5,3 @@
  * Retrieves the property type of a single property of a type.
  */
 export declare type PropType<TObj, TProp extends keyof TObj> = TObj[TProp];
-/**
- * Removes the readonly modifier for a property.
- */
-export declare type Mutable<T> = {
-    -readonly [P in keyof T]: T[P];
-};

package/core/src/utilities/worldToViewport.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import * as THREE from 'three';
+/**
+ * Maps from 3D world coordinates to normalized screen coordinates
+ * relative to the canvas being rendered to. X and Y will
+ * be in range [0, 1]. Z is in range [-1, 1] if the coordinate
+ * is inside the camera near and far planes.
+ * @param camera      Camera used to project point from 3D to NDC coordinates
+ * @param position3D  World position in 3D
+ * @param out         Optionally pre-allocated THREE.Vector3
+ * @returns           Relative screen coordinates in X, Y and Z in range [-1, 1] if point
+ * is within near/far of camera.
+ */
+export declare function worldToNormalizedViewportCoordinates(camera: THREE.PerspectiveCamera, position3D: THREE.Vector3, out?: THREE.Vector3): THREE.Vector3;
+/**
+ * Maps from 3D world coordinates to screen coordinates
+ * relative to the canvas. X and Y will be in absolute
+ * coordinates (0,0 being the top left of the canvas). Z is
+ * in range [-1, 1] if the coordinate
+ * is inside the camera near and far planes.
+ * @param renderer    Renderer used to render the "world"
+ * @param camera      Camera used to project point from 3D to NDC coordinates
+ * @param position3D  World position in 3D
+ * @param out         Optionally pre-allocated THREE.Vector3
+ * @returns           Relative screen coordinates in X, Y and Z in range [-1, 1] if point
+ * is within near/far of camera.
+ */
+export declare function worldToViewportCoordinates(renderer: THREE.WebGLRenderer, camera: THREE.PerspectiveCamera, position3D: THREE.Vector3, out?: THREE.Vector3): THREE.Vector3;

package/{utilities/events/clickOrTouchEventOffset.d.ts → core/utilities.d.ts}

@@ -1,4 +1,4 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-export {};
+export * from './src/utilities';

package/extensions/datasource.d.ts

@@ -0,0 +1,9 @@
+/*!
+ * Copyright 2021 Cognite AS
+ */
+/**
+ * @module @cognite/reveal/extensions/datasource
+ */
+export { DataSource } from '../packages/data-source';
+export { NodesApiClient } from '../packages/nodes-api';
+export { ModelIdentifier, CdfModelIdentifier, ModelMetadataProvider, ModelDataProvider } from '../packages/modeldata-api';