@cognite/reveal 4.32.3 → 4.34.0

package/dist/packages/rendering/src/pointcloud-rendering/PointCloudMaterial.d.ts

@@ -1,7 +1,4 @@
-/*!
- * Adapted from pnext/three-loader (https://github.com/pnext/three-loader)
- */
-import { Camera, RawShaderMaterial, Texture, WebGLRenderer } from 'three';
+import { Camera, DataTexture, WebGLRenderer, RawShaderMaterial, Texture } from 'three';
 import { PointColorType, PointShape, PointSizeType } from './enums';
 import { PointClassification, IUniform, OctreeMaterialParams } from './types';
 import { PointCloudObjectAppearanceTexture } from './PointCloudObjectAppearanceTexture';
@@ -45,7 +42,7 @@ export declare class PointCloudMaterial extends RawShaderMaterial {
     useDrawingBufferSize: boolean;
     lights: boolean;
     fog: boolean;
-    visibleNodesTexture: Texture | undefined;
+    visibleNodesTexture: DataTexture | undefined;
     visibleNodeTextureOffsets: Map<string, number>;
     private readonly _gradient;
     private gradientTexture;

package/dist/packages/rendering/src/pointcloud-rendering/PointCloudObjectAppearanceTexture.d.ts

@@ -1,10 +1,10 @@
+import { CompletePointCloudAppearance, StyledPointCloudVolumeCollection } from '../../../pointcloud-styling';
+import { PointCloudObjectIdMaps } from './PointCloudObjectIdMaps';
+import { DataSourceType } from '../../../data-providers';
 /*!
  * Copyright 2022 Cognite AS
  */
 import * as THREE from 'three';
-import { PointCloudAnnotationVolumeCollection, CompletePointCloudAppearance, StyledPointCloudVolumeCollection } from '../../../pointcloud-styling';
-import { PointCloudObjectIdMaps } from './PointCloudObjectIdMaps';
-import { DataSourceType } from '../../../data-providers';
 export declare class PointCloudObjectAppearanceTexture {
     private readonly _objectStyleTexture;
     private _needsReconstruction;
@@ -21,7 +21,7 @@ export declare class PointCloudObjectAppearanceTexture {
     private resetTexture;
     onBeforeRender(): void;
     assignStyledObjectSet(styledCollection: StyledPointCloudVolumeCollection<DataSourceType>): void;
-    removeStyledObjectSet(collection: PointCloudAnnotationVolumeCollection): void;
+    removeStyledObjectSet(collection: StyledPointCloudVolumeCollection<DataSourceType>['volumeCollection']): void;
     removeAllStyledObjectSets(): void;
     set defaultAppearance(appearance: CompletePointCloudAppearance);
     get defaultAppearance(): CompletePointCloudAppearance;

package/dist/packages/rendering/src/pointcloud-rendering/PointCloudObjectIdMaps.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { DMInstanceKey, DMInstanceRef } from '../../../utilities';
 export type PointCloudObjectIdMaps = {
     annotationToObjectIds: Map<number | DMInstanceKey, number>;

package/dist/packages/rendering/src/pointcloud-rendering/constants.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Adapted from pnext/three-loader (https://github.com/pnext/three-loader)
- */
 import { Color } from 'three';
 export declare const DEFAULT_MAX_POINT_SIZE = 10;
 export declare const DEFAULT_MIN_NODE_PIXEL_SIZE = 50;

package/dist/packages/rendering/src/pointcloud-rendering/texture-generation.d.ts

@@ -1,7 +1,4 @@
-/*!
- * Adapted from pnext/three-loader (https://github.com/pnext/three-loader)
- */
-import { Color, DataTexture, Texture } from 'three';
+import { Color, Texture, DataTexture } from 'three';
 import { PointClassification, IGradient } from './types';
 export declare function generateDataTexture(width: number, height: number, color: Color, alpha: number): DataTexture;
 export declare function generateGradientTexture(gradient: IGradient): Texture;

package/dist/packages/rendering/src/pointcloud-rendering/types.d.ts

@@ -1,7 +1,4 @@
-/*!
- * Adapted from pnext/three-loader (https://github.com/pnext/three-loader)
- */
-import { Color, IUniform as IThreeUniform, Vector4, type Box3, type Vector3 } from 'three';
+import { Color, IUniform as IThreeUniform, Vector4, Box3, Vector3 } from 'three';
 export type IGradient = [number, Color][];
 export interface PointClassification {
     [value: string]: Vector4;

package/dist/packages/rendering/src/render-passes/GeometryPass.d.ts

@@ -1,10 +1,10 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import * as THREE from 'three';
 import { CadMaterialManager } from '../CadMaterialManager';
 import { RenderMode } from '../rendering/RenderMode';
 import { RenderPass } from '../RenderPass';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import type * as THREE from 'three';
 export declare class GeometryPass implements RenderPass {
     private readonly _geometryScene;
     private readonly _materialManager;

package/dist/packages/rendering/src/render-passes/PointCloudEffectsPass.d.ts

@@ -1,7 +1,7 @@
-import * as THREE from 'three';
 import { RenderPass } from '../RenderPass';
 import { PointCloudPassParameters } from './types';
 import { PointCloudMaterialManager } from '../PointCloudMaterialManager';
+import type * as THREE from 'three';
 export declare class PointCloudEffectsPass implements RenderPass {
     private readonly _viewerScene;
     private readonly _pointCloudMaterialManager;

package/dist/packages/rendering/src/render-passes/PostProcessingPass.d.ts

@@ -1,10 +1,10 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import * as THREE from 'three';
 import { PostProcessingObjectsVisibilityParameters } from './types';
 import { RenderPass } from '../RenderPass';
 import { PostProcessingPipelineOptions } from '../render-pipeline-providers/types';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import type * as THREE from 'three';
 /**
  * Single pass that applies post processing effects and
  * combines results from geometry passes.

package/dist/packages/rendering/src/render-passes/SSAOPass.d.ts

@@ -1,9 +1,9 @@
+import { SsaoParameters } from '../rendering/types';
+import { RenderPass } from '../RenderPass';
 /*!
  * Copyright 2022 Cognite AS
  */
 import * as THREE from 'three';
-import { SsaoParameters } from '../rendering/types';
-import { RenderPass } from '../RenderPass';
 export declare class SSAOPass implements RenderPass {
     private readonly _fullScreenTriangle;
     private readonly _ssaoShaderMaterial;

package/dist/packages/rendering/src/render-passes/types.d.ts

@@ -1,9 +1,6 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { PointShape } from '../pointcloud-rendering';
-import * as THREE from 'three';
 import { EdlOptions } from '../rendering/types';
+import * as THREE from 'three';
 export type BlendOptions = {
     blendDestination: THREE.BlendingDstFactor;
     blendSource: THREE.BlendingDstFactor | THREE.BlendingSrcFactor;

package/dist/packages/rendering/src/render-pipeline-providers/CadGeometryRenderModePipelineProvider.d.ts

@@ -1,13 +1,13 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import * as THREE from 'three';
 import { CadMaterialManager } from '../CadMaterialManager';
 import { RenderPass } from '../RenderPass';
 import { RenderPipelineProvider } from '../RenderPipelineProvider';
 import { RenderMode } from '../rendering/RenderMode';
 import { SceneHandler } from '../../../utilities';
 import { SettableRenderTarget } from '../rendering/SettableRenderTarget';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
 export declare class CadGeometryRenderModePipelineProvider implements RenderPipelineProvider, SettableRenderTarget {
     private readonly _renderTargetData;
     private readonly _geometryPass;

package/dist/packages/rendering/src/render-pipeline-providers/CadGeometryRenderPipelineProvider.d.ts

@@ -1,13 +1,10 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { SceneHandler } from '../../../utilities';
-import * as THREE from 'three';
 import { CadMaterialManager } from '../CadMaterialManager';
 import { RenderOptions } from '../rendering/types';
 import { RenderPass } from '../RenderPass';
 import { RenderPipelineProvider } from '../RenderPipelineProvider';
 import { CadGeometryRenderTargets } from './types';
+import * as THREE from 'three';
 export declare class CadGeometryRenderPipelineProvider implements RenderPipelineProvider {
     private readonly _cadGeometryRenderTargets;
     private readonly _cadGeometryRenderPasses;

package/dist/packages/rendering/src/render-pipeline-providers/DefaultRenderPipelineProvider.d.ts

@@ -1,7 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import * as THREE from 'three';
 import { CadMaterialManager } from '../CadMaterialManager';
 import { RenderPass } from '../RenderPass';
 import { RenderPipelineProvider } from '../RenderPipelineProvider';
@@ -9,6 +5,10 @@ import { RenderOptions } from '../rendering/types';
 import { SceneHandler } from '../../../utilities';
 import { PointCloudMaterialManager } from '../PointCloudMaterialManager';
 import { SettableRenderTarget } from '../rendering/SettableRenderTarget';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
 export declare class DefaultRenderPipelineProvider implements RenderPipelineProvider, SettableRenderTarget {
     private readonly _viewerScene;
     private readonly _renderTargetData;

package/dist/packages/rendering/src/render-pipeline-providers/PointCloudRenderPipelineProvider.d.ts

@@ -1,13 +1,13 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import * as THREE from 'three';
 import { RenderPass } from '../RenderPass';
 import { RenderPipelineProvider } from '../RenderPipelineProvider';
 import { SceneHandler } from '../../../utilities';
 import { PointCloudRenderTargets } from './types';
 import { PointCloudParameters } from '../rendering/types';
 import { PointCloudMaterialManager } from '../PointCloudMaterialManager';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
 export declare class PointCloudRenderPipelineProvider implements RenderPipelineProvider {
     private readonly _renderTargetData;
     private readonly _renderParameters;

package/dist/packages/rendering/src/render-pipeline-providers/pointCloudParameterUtils.d.ts

@@ -1,5 +1,2 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { EdlOptions } from '../rendering/types';
 export declare function shouldApplyEdl(edlOptions: EdlOptions): boolean;

package/dist/packages/rendering/src/render-pipeline-providers/types.d.ts

@@ -1,8 +1,8 @@
+import { EdlOptions } from '../rendering/types';
 /*!
  * Copyright 2022 Cognite AS
  */
-import * as THREE from 'three';
-import { EdlOptions } from '../rendering/types';
+import type * as THREE from 'three';
 export type RenderTargetData = {
     currentRenderSize: THREE.Vector2;
     ssaoRenderTarget: THREE.WebGLRenderTarget;

package/dist/packages/rendering/src/rendering/SettableRenderTarget.d.ts

@@ -1,7 +1,4 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import type { WebGLRenderTarget } from 'three';
+import { WebGLRenderTarget } from 'three';
 /**
  * Interface for allowing render targets in renderPipelines to be changed dynamicaly in RevealManager.
  */

package/dist/packages/rendering/src/rendering/materials.d.ts

@@ -1,8 +1,8 @@
+import { RenderMode } from './RenderMode';
 /*!
  * Copyright 2021 Cognite AS
  */
 import * as THREE from 'three';
-import { RenderMode } from './RenderMode';
 export interface Materials {
     box: THREE.RawShaderMaterial;
     circle: THREE.RawShaderMaterial;

package/dist/packages/rendering/src/utilities/GpuTimer.d.ts

@@ -0,0 +1,19 @@
+export declare class GpuTimer {
+    private readonly _gl;
+    private readonly _ext;
+    private readonly enabled;
+    private _frameQueries;
+    private _frames;
+    private _timings;
+    private _prevTimings;
+    private _freeQueries;
+    get timings(): number[];
+    constructor(context: WebGL2RenderingContext);
+    loseContext(): void;
+    begin(name: string): void;
+    mark(name: string): void;
+    end(): void;
+    private checkDisjoint;
+    private allocateQuery;
+    private resolveFrameTimings;
+}

package/dist/packages/rendering/src/utilities/renderUtilities.d.ts

@@ -1,11 +1,11 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import * as THREE from 'three';
 import { WebGLRendererStateHelper } from '../../../utilities';
 import { CadMaterialManager } from '../CadMaterialManager';
 import { StyledTreeIndexSets } from './types';
 import { BlitOptions, DepthBlendBlitOptions, PointCloudPassParameters, PointCloudPostProcessingOptions } from '../render-passes/types';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
 export declare const unitOrthographicCamera: THREE.OrthographicCamera;
 export declare function createFullScreenTriangleMesh(shaderMaterial: THREE.RawShaderMaterial): THREE.Mesh;
 export declare function createRenderTarget(width?: number, height?: number, multiSampleCount?: number): THREE.WebGLRenderTarget;

package/dist/packages/rendering/src/utilities/types.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2021 Cognite AS
- */
 import { IndexSet } from '../../../utilities';
 import * as THREE from 'three';
 /**

package/dist/packages/rendering/visual-tests/Blending.VisualTest.d.ts

@@ -0,0 +1,5 @@
+import { StreamingTestFixtureComponents } from '../../../visual-tests/test-fixtures/StreamingVisualTestFixture';
+import { StreamingVisualTestFixture } from '../../../visual-tests';
+export default class BlendingTestFixture extends StreamingVisualTestFixture {
+    setup(testFixtureComponents: StreamingTestFixtureComponents): Promise<void>;
+}

package/dist/packages/rendering/visual-tests/RenderTarget.VisualTest.d.ts

@@ -0,0 +1,9 @@
+import { StreamingTestFixtureComponents, StreamingVisualTestFixture } from '../../../visual-tests/test-fixtures/StreamingVisualTestFixture';
+export default class RenderTargetVisualTest extends StreamingVisualTestFixture {
+    private readonly _orthographicCamera;
+    private readonly _testScene;
+    private _glRenderer;
+    constructor();
+    setup(testFixtureComponents: StreamingTestFixtureComponents): Promise<void>;
+    render(): void;
+}

package/dist/packages/rendering/visual-tests/Rendering.VisualTest.d.ts

@@ -0,0 +1,13 @@
+import { StreamingTestFixtureComponents, StreamingVisualTestFixture } from '../../../visual-tests/test-fixtures/StreamingVisualTestFixture';
+export default class RenderingVisualTestFixture extends StreamingVisualTestFixture {
+    private readonly guiData;
+    setup(testFixtureComponents: StreamingTestFixtureComponents): Promise<void>;
+    private setupGui;
+    private timings;
+    render(): void;
+    private setupBackgroundColorGUI;
+    private setupMockCadStyling;
+    private getGridFromBoundingBox;
+    private getCustomBoxFromBoundingBox;
+    private attachTransformControlsTo;
+}

package/dist/packages/rendering/visual-tests/Resize.VisualTest.d.ts

@@ -0,0 +1,5 @@
+import { StreamingTestFixtureComponents } from '../../../visual-tests/test-fixtures/StreamingVisualTestFixture';
+import { StreamingVisualTestFixture } from '../../../visual-tests';
+export default class ResizeVisualTestFixture extends StreamingVisualTestFixture {
+    setup(testFixtureComponents: StreamingTestFixtureComponents): Promise<void>;
+}

package/dist/packages/rendering/visual-tests/Ssao.VisualTest.d.ts

@@ -0,0 +1,4 @@
+import { StreamingTestFixtureComponents, StreamingVisualTestFixture } from '../../../visual-tests/test-fixtures/StreamingVisualTestFixture';
+export default class SsaoVisualTest extends StreamingVisualTestFixture {
+    setup(testFixtureComponents: StreamingTestFixtureComponents): Promise<void>;
+}

package/dist/packages/sector-loader/index.d.ts

@@ -1,5 +1,5 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-export { SectorRepository } from './src/SectorRepository';
+export type { SectorRepository } from './src/SectorRepository';
 export { GltfSectorRepository } from './src/GltfSectorRepository';

package/dist/packages/sector-loader/src/GltfSectorLoader.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { ConsumedSector, WantedSector } from '../../cad-parsers';
 import { BinaryFileProvider } from '../../data-providers';
 export declare class GltfSectorLoader {

package/dist/packages/sector-loader/src/GltfSectorRepository.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2021 Cognite AS
- */
 import { ConsumedSector, WantedSector } from '../../cad-parsers';
 import { BinaryFileProvider, ModelIdentifier } from '../../data-providers';
 import { SectorRepository } from './SectorRepository';

package/dist/packages/sector-loader/src/SectorRepository.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2021 Cognite AS
- */
 import { ConsumedSector, WantedSector } from '../../cad-parsers';
 import { ModelIdentifier } from '../../data-providers';
 export type SectorId = number;

package/dist/packages/sector-loader/visual-tests/SectorLoader.VisualTest.d.ts

@@ -0,0 +1,8 @@
+import { SimpleTestFixtureComponents, SimpleVisualTestFixture } from '../../../visual-tests';
+export default class SectorLoaderVisualTestFixture extends SimpleVisualTestFixture {
+    setup(simpleTestFixtureComponents: SimpleTestFixtureComponents): Promise<void>;
+    private loadSectors;
+    private initializeGroup;
+    private createGltfSectorGroup;
+    private getShaderMaterial;
+}

package/dist/packages/sector-parser/index.d.ts

@@ -2,4 +2,5 @@
  * Copyright 2021 Cognite AS
  */
 export { GltfSectorParser } from './src/GltfSectorParser';
-export { RevealGeometryCollectionType, ParsedGeometry } from './src/types';
+export type { ParsedGeometry } from './src/types';
+export { RevealGeometryCollectionType } from './src/types';

package/dist/packages/sector-parser/src/constants.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { TypedArrayConstructor } from '../../utilities';
 export declare const COLLECTION_TYPE_SIZES: Map<string, number>;
 export declare const DATA_TYPE_BYTE_SIZES: Map<number, TypedArrayConstructor>;

package/dist/packages/sector-parser/src/reveal-glb-parser/GlbMetadataParser.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2021 Cognite AS
- */
 import { GlbHeaderData } from '../types';
 export declare class GlbMetadataParser {
     private readonly _textDecoder;

package/dist/packages/sector-parser/src/reveal-glb-parser/primitiveGeometries.d.ts

@@ -1,8 +1,8 @@
+import { RevealGeometryCollectionType } from '../types';
 /*!
  * Copyright 2021 Cognite AS
  */
 import * as THREE from 'three';
-import { RevealGeometryCollectionType } from '../types';
 export declare function setBoxGeometry(geometry: THREE.BufferGeometry): THREE.Box3;
 export declare function setQuadGeometry(geometry: THREE.BufferGeometry, includeNormal?: boolean): THREE.Box3;
 export declare function setTrapeziumGeometry(geometry: THREE.BufferGeometry): THREE.Box3;

package/dist/packages/sector-parser/src/types.d.ts

@@ -1,7 +1,4 @@
-/*!
- * Copyright 2021 Cognite AS
- */
-import type { InstancedBufferGeometry, BufferGeometry, Texture as ThreeTexture } from 'three';
+import { InstancedBufferGeometry, BufferGeometry, Texture as ThreeTexture } from 'three';
 export type GltfJson = {
     accessors: Accessor[];
     asset: Asset;

package/dist/packages/sector-parser/visual-tests/GeneralCylinder.VisualTest.d.ts

@@ -0,0 +1,4 @@
+import { PrimitivesVisualTestFixture } from './PrimitivesVisualTestFixture';
+export default class GeneralCylinderVisualTest extends PrimitivesVisualTestFixture {
+    constructor();
+}

package/dist/packages/sector-parser/visual-tests/PrimitivesVisualTestFixture.d.ts

@@ -0,0 +1,9 @@
+import { Primitive, PrimitiveName } from '../../../test-utilities/src/primitives';
+import { SimpleTestFixtureComponents, SimpleVisualTestFixture } from '../../../visual-tests';
+export declare abstract class PrimitivesVisualTestFixture extends SimpleVisualTestFixture {
+    private readonly _primitives;
+    private readonly _primitiveName;
+    constructor(primitiveName: PrimitiveName, primitives: Primitive[]);
+    setup(simpleTestFixtureComponents: SimpleTestFixtureComponents): Promise<void>;
+    private initializeGroup;
+}

package/dist/packages/sector-parser/visual-tests/SectorParser.VisualTest.d.ts

@@ -0,0 +1,6 @@
+import { SimpleTestFixtureComponents, SimpleVisualTestFixture } from '../../../visual-tests';
+export default class SectorParserVisualTestFixture extends SimpleVisualTestFixture {
+    setup(simpleTestFixtureComponents: SimpleTestFixtureComponents): Promise<void>;
+    private loadSectors;
+    private initializeGroup;
+}

package/dist/packages/sector-parser/visual-tests/testMaterials.d.ts

@@ -0,0 +1,6 @@
+import { RevealGeometryCollectionType } from '../src/types';
+/*!
+ * Copyright 2021 Cognite AS
+ */
+import * as THREE from 'three';
+export declare function getMaterialsMap(treeIndexCount: number): Map<RevealGeometryCollectionType, THREE.RawShaderMaterial>;

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

@@ -1,18 +1,20 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-export { HtmlOverlayTool, HtmlOverlayOptions, HtmlOverlayToolOptions, HtmlOverlayToolClusteringOptions, HtmlOverlayPositionUpdatedDelegate, HtmlOverlayCreateClusterDelegate } from './src/HtmlOverlay/HtmlOverlayTool';
+export type { HtmlOverlayOptions, HtmlOverlayToolOptions, HtmlOverlayToolClusteringOptions, HtmlOverlayPositionUpdatedDelegate, HtmlOverlayCreateClusterDelegate } from './src/HtmlOverlay/HtmlOverlayTool';
+export { HtmlOverlayTool } from './src/HtmlOverlay/HtmlOverlayTool';
 export { DebugCameraTool } from './src/DebugCameraTool';
 export { AxisViewTool } from './src/AxisView/AxisViewTool';
 export { AxisGizmoTool } from './src/AxisGizmo/AxisGizmoTool';
 export { AxisGizmoOptions } from './src/AxisGizmo/AxisGizmoOptions';
-export { AxisBoxConfig, AxisBoxCompassConfig, AxisBoxFaceConfig, AbsolutePosition, RelativePosition } from './src/AxisView/types';
+export type { AxisBoxConfig, AxisBoxCompassConfig, AxisBoxFaceConfig, AbsolutePosition, RelativePosition } from './src/AxisView/types';
 export { Corner } from './src/utilities/Corner';
-export { Overlay3DTool, Overlay3DToolParameters, OverlayEventHandler, OverlayToolEvent, OverlayCollectionOptions } from './src/Overlay3D/Overlay3DTool';
+export type { Overlay3DToolParameters, OverlayEventHandler, OverlayToolEvent, OverlayCollectionOptions } from './src/Overlay3D/Overlay3DTool';
+export { Overlay3DTool } from './src/Overlay3D/Overlay3DTool';
 export { TimelineTool } from './src/Timeline/TimelineTool';
 export { Keyframe } from './src/Timeline/Keyframe';
-export { TimelineDateUpdateDelegate } from './src/Timeline/types';
+export type { TimelineDateUpdateDelegate } from './src/Timeline/types';
 export { Cognite3DViewerToolBase } from './src/Cognite3DViewerToolBase';
 export { MeasurementTool } from './src/Measurement/MeasurementTool';
-export { Measurement } from './src/Measurement/types';
-export { DistanceToLabelDelegate, MeasurementOptions, MeasurementAddedDelegate, MeasurementStartedDelegate, MeasurementEndedDelegate } from './src/Measurement/types';
+export type { Measurement } from './src/Measurement/types';
+export type { DistanceToLabelDelegate, MeasurementOptions, MeasurementAddedDelegate, MeasurementStartedDelegate, MeasurementEndedDelegate } from './src/Measurement/types';

package/dist/packages/tools/src/AxisView/AxisViewTool.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2021 Cognite AS
- */
 import { Cognite3DViewerToolBase } from '../Cognite3DViewerToolBase';
 import { AxisBoxConfig } from './types';
 import { Cognite3DViewer } from '../../../api';

package/dist/packages/tools/src/AxisView/types.d.ts

@@ -1,8 +1,8 @@
+import { Corner } from '../utilities/Corner';
 /*!
  * Copyright 2021 Cognite AS
  */
 import * as THREE from 'three';
-import { Corner } from '../utilities/Corner';
 /**
  * Configuration of {@link AxisViewTool}.
  */

package/dist/packages/tools/src/DebugCameraTool.d.ts

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2021 Cognite AS
- */
 import { Cognite3DViewerToolBase } from './Cognite3DViewerToolBase';
 import { Cognite3DViewer } from '../../api';
 import { DataSourceType } from '../../data-providers';

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

@@ -1,10 +1,10 @@
+import { Cognite3DViewerToolBase } from '../Cognite3DViewerToolBase';
+import { Cognite3DViewer } from '../../../api';
+import { DataSourceType } from '../../../data-providers';
 /*!
  * Copyright 2021 Cognite AS
  */
 import * as THREE from 'three';
-import { Cognite3DViewerToolBase } from '../Cognite3DViewerToolBase';
-import { Cognite3DViewer } from '../../../api';
-import { DataSourceType } from '../../../data-providers';
 /**
  * Callback that is triggered whenever the 2D position of an overlay is updated
  * in {@link HtmlOverlayTool}.
@@ -50,8 +50,20 @@ export type HtmlOverlayToolClusteringOptions = {
     /**
      * Callback that is triggered when a set of overlays are clustered together
      * to create a "composite" element as a placeholder for the clustered elements.
-     * Note that this callback will be triggered every frame for each cluster so it
-     * must be performant.
+     * Composite elements are cached and reused across frames, so this callback is
+     * only invoked when the cluster composition changes (i.e. when the set of
+     * clustered overlays differs from any previously seen cluster).
+     *
+     * Note: because the callback is not re-invoked while a cluster persists,
+     * the produced composite element will not reflect later mutations to the
+     * `userData` of any clustered overlay. Treat `userData` as immutable for
+     * overlays that may be clustered, or rebuild the affected overlays
+     * (remove + add) to force a fresh composite to be created.
+     *
+     * The composite's screen position is updated each frame by the tool, but
+     * the callback itself should not depend on viewport state (camera position,
+     * cluster midpoint, screen coordinates, etc.) since the returned element
+     * is reused across frames as the camera moves.
      */
     createClusterElementCallback: HtmlOverlayCreateClusterDelegate;
 };
@@ -108,6 +120,10 @@ export declare class HtmlOverlayTool extends Cognite3DViewerToolBase {
     private readonly _compositeOverlays;
     private _visible;
     private readonly TIMER_ADVANCE_MS;
+    private readonly _elementIds;
+    private _nextElementId;
+    private readonly _clusterCache;
+    private readonly _aliveClusterKeys;
     private readonly _onSceneRenderedHandler;
     private readonly _onViewerDisposedHandler;
     private readonly _preallocatedVariables;
@@ -167,7 +183,20 @@ export declare class HtmlOverlayTool extends Cognite3DViewerToolBase {
     private commitDOMChanges;
     private clusterElements;
     private cleanupClusterElements;
+    /**
+     * Invalidate any cached cluster composites that referenced the given overlay
+     * element. Used when an overlay is removed so its cluster composite is
+     * detached from the DOM immediately rather than lingering until the next
+     * frame's stale-cluster sweep.
+     */
+    private invalidateClustersForElement;
+    /**
+     * Remove cluster cache entries that were not reused during the current frame
+     * and detach their composite elements from the DOM.
+     */
+    private removeStaleClusters;
     private clusterByOverlapInScreenSpace;
+    private createClusterKey;
     private addComposite;
     private onSceneRendered;
     private onViewerDisposed;

package/dist/packages/tools/src/Measurement/MeasurementManager.d.ts

@@ -1,9 +1,9 @@
+import { HtmlOverlayTool } from '../HtmlOverlay/HtmlOverlayTool';
+import { Measurement, MeasurementOptions } from './types';
 /*!
  * Copyright 2022 Cognite AS
  */
 import * as THREE from 'three';
-import { HtmlOverlayTool } from '../HtmlOverlay/HtmlOverlayTool';
-import { Measurement, MeasurementOptions } from './types';
 export declare class MeasurementManager {
     private readonly _measurementLabel;
     private readonly _line;

package/dist/packages/tools/src/Measurement/MeasurementTool.d.ts

@@ -1,12 +1,9 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { Cognite3DViewer } from '../../../api';
 import { Cognite3DViewerToolBase } from '../Cognite3DViewerToolBase';
 import { DisposedDelegate } from '../../../utilities';
-import * as THREE from 'three';
 import { MeasurementAddedDelegate, MeasurementStartedDelegate, MeasurementEndedDelegate, MeasurementOptions, Measurement } from './types';
 import { DataSourceType } from '../../../data-providers';
+import * as THREE from 'three';
 /**
  * Enables {@link Cognite3DViewer} to perform a point to point measurement.
  * This can be achieved by selecting a point on the 3D Object and drag the pointer to