@cognite/reveal 4.32.2 → 4.33.0

package/dist/packages/360-images/index.d.ts

@@ -1,24 +1,26 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-export { Image360, Image360IconStyle } from './src/entity/Image360';
-export { Image360Revision } from './src/entity/Image360Revision';
-export { Image360Collection, Image360AnnotationAssetFilter, Image360AnnotationAssetQueryResult, InstanceLinkable360ImageAnnotationType, AssetAnnotationImage360Info, AssetHybridAnnotationImage360Info } from './src/collection/Image360Collection';
+export type { Image360, Image360IconStyle } from './src/entity/Image360';
+export type { Image360Revision } from './src/entity/Image360Revision';
+export type { Image360Collection, Image360AnnotationAssetFilter, Image360AnnotationAssetQueryResult, InstanceLinkable360ImageAnnotationType, AssetAnnotationImage360Info, AssetHybridAnnotationImage360Info } from './src/collection/Image360Collection';
 export { Image360Facade } from './src/Image360Facade';
 export { Image360CollectionFactory } from './src/collection/Image360CollectionFactory';
 export { Image360Entity } from './src/entity/Image360Entity';
 export { Image360RevisionEntity } from './src/entity/Image360RevisionEntity';
-export { Image360Visualization } from './src/entity/Image360Visualization';
-export { Image360EnteredDelegate, Image360ExitedDelegate } from './src/types';
-export { Image360AnnotationAppearance, Image360AnnotationFilterOptions, Image360AnnotationInstanceReference } from './src/annotation/types';
-export { Image360AnnotationIntersection } from './src/annotation/Image360AnnotationIntersection';
-export { Image360Annotation } from './src/annotation/Image360Annotation';
+export type { Image360Visualization } from './src/entity/Image360Visualization';
+export type { Image360EnteredDelegate, Image360ExitedDelegate, HtmlClusterRendererOptions } from './src/types';
+export type { Image360AnnotationAppearance, Image360AnnotationFilterOptions, Image360AnnotationInstanceReference } from './src/annotation/types';
+export type { Image360AnnotationIntersection } from './src/annotation/Image360AnnotationIntersection';
+export type { Image360Annotation } from './src/annotation/Image360Annotation';
 export { DefaultImage360Collection } from './src/collection/DefaultImage360Collection';
-export { IconsOptions } from './src/icons/IconCollection';
-export { ClusteredIconData } from './src/icons/clustering/ClusterRenderingStrategy';
-export { HtmlClusterRendererOptions } from './src/icons/clustering/HtmlClusterRenderer';
-export { Image360ClusterIntersectionData, Image360CollectionSourceType, Image360IconIntersectionData } from './src/types';
+export type { IconsOptions } from './src/icons/IconCollection';
+export type { ClusteredIconData } from './src/icons/clustering/ClusterRenderingStrategy';
+export { HtmlClusterCoordinator } from './src/icons/clustering/HtmlClusterCoordinator';
+export type { HtmlClusterCollection } from './src/icons/clustering/HtmlClusterCoordinator';
+export type { Image360ClusterIntersectionData, Image360CollectionSourceType, Image360IconIntersectionData } from './src/types';
 export { Image360AnnotationFilter } from './src/annotation/Image360AnnotationFilter';
+export { isCoreDmImage360Annotation, isImageAssetLinkAnnotation, isImageInstanceLinkAnnotation } from './src/annotation/typeGuards';
 export { DEFAULT_IMAGE_360_OPACITY } from './src/entity/Image360VisualizationBox';
 export { Image360Action } from './src/Image360Action';
 export { Image360History } from './src/Image360History';

package/dist/packages/360-images/src/Image360Facade.d.ts

@@ -1,15 +1,16 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { Camera, Matrix4, Vector2 } from 'three';
-import { Image360Entity } from './entity/Image360Entity';
-import { Image360CollectionFactory } from './collection/Image360CollectionFactory';
-import { DefaultImage360Collection } from './collection/DefaultImage360Collection';
-import { IconCullingScheme } from './icons/IconCollection';
-import { Image360RevisionEntity } from './entity/Image360RevisionEntity';
-import { Image360AnnotationFilterOptions } from './annotation/types';
-import { DataSourceType } from '../../data-providers';
-import { Image360ClusterIntersectionData, Image360IconIntersectionData } from './types';
+import type { Camera, Vector2 } from 'three';
+import { Matrix4 } from 'three';
+import type { Image360Entity } from './entity/Image360Entity';
+import type { Image360CollectionFactory } from './collection/Image360CollectionFactory';
+import type { DefaultImage360Collection } from './collection/DefaultImage360Collection';
+import type { IconCullingScheme } from './icons/IconCollection';
+import type { Image360RevisionEntity } from './entity/Image360RevisionEntity';
+import type { Image360AnnotationFilterOptions } from './annotation/types';
+import type { DataSourceType } from '../../data-providers';
+import type { Image360ClusterIntersectionData, Image360IconIntersectionData } from './types';
 export declare class Image360Facade<T extends DataSourceType> {
     private readonly _entityFactory;
     private readonly _image360Collections;

package/dist/packages/360-images/src/Image360History.d.ts

@@ -1,8 +1,8 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { DataSourceType } from '../../data-providers';
-import { Image360 } from './entity/Image360';
+import type { DataSourceType } from '../../data-providers';
+import type { Image360 } from './entity/Image360';
 import { Image360Action } from './Image360Action';
 export declare class Image360History {
     private readonly _images;

package/dist/packages/360-images/src/annotation/Image360Annotation.d.ts

@@ -1,8 +1,8 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { Color, Vector3 } from 'three';
-import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
+import type { Color, Vector3 } from 'three';
+import type { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
 /**
  * An annotation associated with a 360 image revision
  */

package/dist/packages/360-images/src/annotation/Image360AnnotationFilter.d.ts

@@ -1,8 +1,8 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { Image360AnnotationFilterOptions } from './types';
-import { DataSourceType } from '../../../data-providers';
+import type { Image360AnnotationFilterOptions } from './types';
+import type { DataSourceType } from '../../../data-providers';
 export declare class Image360AnnotationFilter {
     private readonly _annotationFilter;
     private fillDefaultAnnotationOptionValues;

package/dist/packages/360-images/src/annotation/Image360AnnotationIntersection.d.ts

@@ -1,9 +1,9 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
-import { Image360Annotation } from './Image360Annotation';
-import { Vector3 } from 'three';
+import type { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
+import type { Image360Annotation } from './Image360Annotation';
+import type { Vector3 } from 'three';
 /**
  * Describes an intersection with a 360 image annotation
  */

package/dist/packages/360-images/src/annotation/ImageAnnotationObject.d.ts

@@ -1,10 +1,11 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { DataSourceType, Image360FileDescriptor } from '../../../data-providers';
-import { Color, Matrix4, Vector3, Object3D, Raycaster } from 'three';
-import { Image360Annotation } from './Image360Annotation';
-import { Image360AnnotationAppearance } from './types';
+import type { DataSourceType, Image360FileDescriptor } from '../../../data-providers';
+import type { Object3D, Raycaster } from 'three';
+import { Color, Matrix4, Vector3 } from 'three';
+import type { Image360Annotation } from './Image360Annotation';
+import type { Image360AnnotationAppearance } from './types';
 type FaceType = Image360FileDescriptor['face'];
 export declare class ImageAnnotationObject<T extends DataSourceType> implements Image360Annotation<T> {
     private readonly _annotation;

package/dist/packages/360-images/src/annotation/geometry/BoxAnnotationGeometryData.d.ts

@@ -1,9 +1,10 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
-import { BufferGeometry, Matrix4, PlaneGeometry, Vector3 } from 'three';
-import { AnnotationsBoundingBox } from '@cognite/sdk';
+import type { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
+import type { BufferGeometry, Vector3 } from 'three';
+import { Matrix4, PlaneGeometry } from 'three';
+import type { AnnotationsBoundingBox } from '@cognite/sdk';
 export declare class BoxAnnotationGeometryData implements ImageAnnotationObjectGeometryData {
     private readonly _geometry;
     private readonly _initialTranslation;

package/dist/packages/360-images/src/annotation/geometry/DmMesh3dAnnotationGeometryData.d.ts

@@ -1,8 +1,9 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { BufferGeometry, Matrix4, Vector3 } from 'three';
-import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
+import type { Vector3 } from 'three';
+import { BufferGeometry, Matrix4 } from 'three';
+import type { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
 export declare class DmMesh3dAnnotationGeometryData implements ImageAnnotationObjectGeometryData {
     private readonly _geometry;
     private readonly _outlinePoints;

package/dist/packages/360-images/src/annotation/geometry/ImageAnnotationGeometryData.d.ts

@@ -1,7 +1,7 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { BufferGeometry, Matrix4, Vector3 } from 'three';
+import type { BufferGeometry, Matrix4, Vector3 } from 'three';
 export interface ImageAnnotationObjectGeometryData {
     getGeometry(): BufferGeometry;
     getOutlinePoints(): Vector3[];

package/dist/packages/360-images/src/annotation/geometry/PolygonAnnotationGeometryData.d.ts

@@ -1,9 +1,10 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { BufferGeometry, Matrix4, ShapeGeometry, Vector3 } from 'three';
-import { AnnotationsPolygon } from '@cognite/sdk';
-import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
+import type { BufferGeometry, Vector3 } from 'three';
+import { Matrix4, ShapeGeometry } from 'three';
+import type { AnnotationsPolygon } from '@cognite/sdk';
+import type { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
 export declare class PolygonAnnotationGeometryData implements ImageAnnotationObjectGeometryData {
     private readonly _geometry;
     private readonly _outlinePoints;

package/dist/packages/360-images/src/annotation/geometry/utils.d.ts

@@ -1,5 +1,6 @@
 /*!
  * Copyright 2025 Cognite AS
  */
-import { Vector2, Vector3 } from 'three';
+import type { Vector2 } from 'three';
+import { Vector3 } from 'three';
 export declare function convertPointsTo3d(points: Vector2[]): Vector3[];

package/dist/packages/360-images/src/annotation/getInstanceId.d.ts

@@ -1,6 +1,6 @@
 /*!
  * Copyright 2025 Cognite AS
  */
-import { DataSourceType } from '../../../data-providers';
-import { InstanceReference } from '../../../data-providers/src/types';
+import type { DataSourceType } from '../../../data-providers';
+import type { InstanceReference } from '../../../data-providers/src/types';
 export declare function getClassicInstanceRef<T extends DataSourceType>(annotation: T['image360AnnotationType']): InstanceReference<T> | undefined;

package/dist/packages/360-images/src/annotation/typeGuards.d.ts

@@ -1,8 +1,8 @@
 /*!
  * Copyright 2025 Cognite AS
  */
-import { AnnotationData, AnnotationModel, AnnotationsObjectDetection, AnnotationsTypesImagesAssetLink, AnnotationsTypesImagesInstanceLink, AnnotationType } from '@cognite/sdk';
-import { DataSourceType, DMDataSourceType, ImageAssetLinkAnnotationInfo, ImageInstanceLinkAnnotationInfo } from '../../../data-providers';
+import type { AnnotationData, AnnotationModel, AnnotationsObjectDetection, AnnotationsTypesImagesAssetLink, AnnotationsTypesImagesInstanceLink, AnnotationType } from '@cognite/sdk';
+import type { DataSourceType, DMDataSourceType, ImageAssetLinkAnnotationInfo, ImageInstanceLinkAnnotationInfo } from '../../../data-providers';
 export declare function isCoreDmImage360Annotation(annotation: DataSourceType['image360AnnotationType']): annotation is DMDataSourceType['image360AnnotationType'];
 export declare function isAnnotationsObjectDetection(annotationType: AnnotationType, annotation: AnnotationData): annotation is AnnotationsObjectDetection;
 export declare function isImageAssetLinkAnnotation(annotation: AnnotationModel): annotation is ImageAssetLinkAnnotationInfo;

package/dist/packages/360-images/src/annotation/types.d.ts

@@ -1,9 +1,9 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { AnnotationStatus } from '@cognite/sdk';
-import { ClassicDataSourceType, DataSourceType, DMDataSourceType, InstanceReference } from '../../../data-providers';
-import { Color } from 'three';
+import type { AnnotationStatus } from '@cognite/sdk';
+import type { ClassicDataSourceType, DataSourceType, DMDataSourceType, InstanceReference } from '../../../data-providers';
+import type { Color } from 'three';
 /**
  * The appearance of a 360 image annotation
  */

package/dist/packages/360-images/src/cache/Image360LoadingCache.d.ts

@@ -1,9 +1,9 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { Image360Entity } from '../entity/Image360Entity';
-import { Image360RevisionEntity } from '../entity/Image360RevisionEntity';
-import { DataSourceType } from '../../../data-providers';
+import type { Image360Entity } from '../entity/Image360Entity';
+import type { Image360RevisionEntity } from '../entity/Image360RevisionEntity';
+import type { DataSourceType } from '../../../data-providers';
 export type DownloadRequest<T extends DataSourceType> = {
     entity: Image360Entity<T>;
     revision: Image360RevisionEntity<T>;

package/dist/packages/360-images/src/collection/DefaultImage360Collection.d.ts

@@ -1,22 +1,25 @@
 /*!
  * Copyright 2023 Cognite AS
  */
+import type { BeforeSceneRenderedDelegate } from '../../../utilities';
 import { EventTrigger } from '../../../utilities';
-import { AssetAnnotationImage360Info, AssetHybridAnnotationImage360Info, Image360AnnotationAssetFilter, Image360AnnotationAssetQueryResult, Image360Collection } from './Image360Collection';
-import { Image360Entity } from '../entity/Image360Entity';
-import { Image360EnteredDelegate, Image360ExitedDelegate } from '../types';
-import { ClusterIntersectionData, IconCollection, IconCullingScheme } from '../icons/IconCollection';
-import { Overlay3DIcon } from '../../../3d-overlays';
-import { Image360AnnotationAppearance } from '../annotation/types';
-import { ClassicDataSourceType, DataSourceType, DMDataSourceType, Image360FileDescriptor, Image360Provider } from '../../../data-providers';
-import { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
-import { Matrix4, Ray } from 'three';
-import { InstanceReference } from '../../../data-providers/src/types';
+import type { AssetAnnotationImage360Info, AssetHybridAnnotationImage360Info, Image360AnnotationAssetFilter, Image360AnnotationAssetQueryResult, Image360Collection } from './Image360Collection';
+import type { Image360Entity } from '../entity/Image360Entity';
+import type { Image360EnteredDelegate, Image360ExitedDelegate } from '../types';
+import type { ClusterIntersectionData, IconCollection, IconCullingScheme } from '../icons/IconCollection';
+import type { Overlay3DIcon } from '../../../3d-overlays';
+import type { Image360AnnotationAppearance } from '../annotation/types';
+import type { ClusterScreenInfo } from '../icons/clustering';
+import type { HtmlClusterCollection } from '../icons/clustering/HtmlClusterCoordinator';
+import type { ClassicDataSourceType, DataSourceType, DMDataSourceType, Image360FileDescriptor, Image360Provider } from '../../../data-providers';
+import type { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
+import type { Matrix4, Ray } from 'three';
+import type { InstanceReference } from '../../../data-providers/src/types';
 /**
  * Default implementation of {@link Image360Collection}. Used for events when entering
  * and exiting 360 image mode
  */
-export declare class DefaultImage360Collection<T extends DataSourceType> implements Image360Collection<T> {
+export declare class DefaultImage360Collection<T extends DataSourceType> implements Image360Collection<T>, HtmlClusterCollection {
     /**
      * A list containing all the 360 images in this set.
      */
@@ -131,6 +134,9 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
     getEntitiesFromIcons(icons: Overlay3DIcon[]): Image360Entity<T>[];
     clearHoveredCluster(): void;
     setHoveredClusterIcon(icon: Overlay3DIcon | undefined): void;
+    getStagedHtmlClusterScreenInfos(): ClusterScreenInfo[];
+    applyHtmlClusterOcclusion(occludedIcons: Set<Overlay3DIcon>): void;
+    updateIcons(params: Parameters<BeforeSceneRenderedDelegate>[0]): void;
     remove(entity: Image360Entity<T>): void;
     dispose(): void;
     get needsRedraw(): boolean;

package/dist/packages/360-images/src/collection/Image360Collection.d.ts

@@ -1,15 +1,15 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { Image360 } from './../entity/Image360';
-import { Image360EnteredDelegate, Image360ExitedDelegate } from '../types';
-import { Image360AnnotationAppearance, Image360AnnotationInstanceReference } from '../annotation/types';
-import { Image360Revision } from '../entity/Image360Revision';
-import { IdEither } from '@cognite/sdk';
-import { Image360Annotation } from '../annotation/Image360Annotation';
-import { ClassicDataSourceType, DataSourceType, DMDataSourceType, ImageInstanceLinkAnnotationInfo } from '../../../data-providers';
-import { Matrix4 } from 'three';
-import { ImageAssetLinkAnnotationInfo } from '../../../data-providers';
+import type { Image360 } from './../entity/Image360';
+import type { Image360EnteredDelegate, Image360ExitedDelegate } from '../types';
+import type { Image360AnnotationAppearance, Image360AnnotationInstanceReference } from '../annotation/types';
+import type { Image360Revision } from '../entity/Image360Revision';
+import type { IdEither } from '@cognite/sdk';
+import type { Image360Annotation } from '../annotation/Image360Annotation';
+import type { ClassicDataSourceType, DataSourceType, DMDataSourceType, ImageInstanceLinkAnnotationInfo } from '../../../data-providers';
+import type { Matrix4 } from 'three';
+import type { ImageAssetLinkAnnotationInfo } from '../../../data-providers';
 /**
  * Annotation type that may be linked to assets. Only relevant for classic annotations, where some
  * annotation types are visible in Reveal, but not linkable to assets

package/dist/packages/360-images/src/collection/Image360CollectionFactory.d.ts

@@ -1,20 +1,19 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { DataSourceType } from '../../../data-providers';
-import { BeforeSceneRenderedDelegate, DeviceDescriptor, EventTrigger, SceneHandler } from '../../../utilities';
+import type { DataSourceType } from '../../../data-providers';
+import type { DeviceDescriptor, SceneHandler } from '../../../utilities';
 import { DefaultImage360Collection } from './DefaultImage360Collection';
-import { IconsOptions } from '../icons/IconCollection';
+import type { IconsOptions } from '../icons/IconCollection';
 import { type Matrix4 } from 'three';
-import { Image360AnnotationFilterOptions } from '../annotation/types';
-import { Image360ProviderMap } from '../../../data-providers/src/Image360Provider';
+import type { Image360AnnotationFilterOptions } from '../annotation/types';
+import type { Image360ProviderMap } from '../../../data-providers/src/Image360Provider';
 export declare class Image360CollectionFactory {
     private readonly _image360ProviderMap;
     private readonly _sceneHandler;
-    private readonly _onBeforeSceneRendered;
     private readonly _iconsOptions;
     private readonly _device;
     private readonly _setNeedsRedraw;
-    constructor(image360ProviderMap: Image360ProviderMap, sceneHandler: SceneHandler, onBeforeSceneRendered: EventTrigger<BeforeSceneRenderedDelegate>, setNeedsRedraw: () => void, device: DeviceDescriptor, iconsOptions?: IconsOptions);
+    constructor(image360ProviderMap: Image360ProviderMap, sceneHandler: SceneHandler, setNeedsRedraw: () => void, device: DeviceDescriptor, iconsOptions?: IconsOptions);
     create<T extends DataSourceType>(image360Identifier: T['image360Identifier'], postTransform: Matrix4, preMultipliedRotation: boolean, annotationFilter: Image360AnnotationFilterOptions): Promise<DefaultImage360Collection<T>>;
 }

package/dist/packages/360-images/src/collection/createCollectionIdString.d.ts

@@ -1,5 +1,5 @@
 /*!
  * Copyright 2025 Cognite AS
  */
-import { DataSourceType } from '../../../data-providers';
+import type { DataSourceType } from '../../../data-providers';
 export declare function createCollectionIdString(id: DataSourceType['image360Identifier']): string;

package/dist/packages/360-images/src/entity/Image360.d.ts

@@ -1,11 +1,12 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
-import { Image360Revision } from './Image360Revision';
-import { Image360Visualization } from './Image360Visualization';
-import { Color, type Matrix4 } from 'three';
-import { Image360Id } from '../../../data-providers/src/types';
+import type { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
+import type { Image360Revision } from './Image360Revision';
+import type { Image360Visualization } from './Image360Visualization';
+import type { Color } from 'three';
+import { type Matrix4 } from 'three';
+import type { Image360Id } from '../../../data-providers/src/types';
 /**
  * Image360 icon style
  */

package/dist/packages/360-images/src/entity/Image360Entity.d.ts

@@ -1,16 +1,17 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { DeviceDescriptor, SceneHandler } from '../../../utilities';
-import { DataSourceType, Image360Provider } from '../../../data-providers';
-import { Image360 } from './Image360';
-import { Historical360ImageSet, Image360RevisionId } from '../../../data-providers/src/types';
+import type { DeviceDescriptor, SceneHandler } from '../../../utilities';
+import type { DataSourceType, Image360Provider } from '../../../data-providers';
+import type { Image360 } from './Image360';
+import type { Historical360ImageSet, Image360RevisionId } from '../../../data-providers/src/types';
 import { Image360RevisionEntity } from './Image360RevisionEntity';
 import { Image360VisualizationBox } from './Image360VisualizationBox';
-import { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
-import { Overlay3DIcon } from '../../../3d-overlays';
-import { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
-import { Color, Matrix4, type Raycaster } from 'three';
+import type { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
+import type { Overlay3DIcon } from '../../../3d-overlays';
+import type { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
+import type { Color, Matrix4 } from 'three';
+import { type Raycaster } from 'three';
 export declare class Image360Entity<T extends DataSourceType> implements Image360<T> {
     private readonly _revisions;
     private readonly _imageMetadata;

package/dist/packages/360-images/src/entity/Image360Revision.d.ts

@@ -1,8 +1,8 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { Image360Annotation } from '../annotation/Image360Annotation';
-import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
+import type { Image360Annotation } from '../annotation/Image360Annotation';
+import type { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
 /**
  * Interface used to manage historical revisions of {@link Image360}.
  * One instance represents one specific image revision.

package/dist/packages/360-images/src/entity/Image360RevisionEntity.d.ts

@@ -1,14 +1,13 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { Image360Descriptor, DataSourceType, Image360Provider } from '../../../data-providers';
-import { Image360Revision } from './Image360Revision';
-import { Image360VisualizationBox } from './Image360VisualizationBox';
+import type { Image360Descriptor, Image360RevisionId, DataSourceType, Image360Provider } from '../../../data-providers';
+import type { Image360Revision } from './Image360Revision';
+import type { Image360VisualizationBox } from './Image360VisualizationBox';
 import { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
 import { type Raycaster } from 'three';
-import { Image360AnnotationAppearance } from '../annotation/types';
-import { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
-import { Image360RevisionId } from '../../../data-providers/src/types';
+import type { Image360AnnotationAppearance } from '../annotation/types';
+import type { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
 export declare class Image360RevisionEntity<T extends DataSourceType> implements Image360Revision<T> {
     private readonly _imageProvider;
     private readonly _image360Descriptor;
@@ -18,8 +17,8 @@ export declare class Image360RevisionEntity<T extends DataSourceType> implements
     private _onFullResolutionCompleted;
     private _defaultAppearance;
     private readonly _identifier;
-    private _annotations;
-    private _annotationsPromise;
+    private readonly _annotationKeyToAnnotationObject;
+    private _allAnnotations;
     private readonly _annotationFilterer;
     constructor(imageProvider: Image360Provider<T>, image360Descriptor: Image360Descriptor<T>, image360VisualizationBox: Image360VisualizationBox, annotationFilterer: Image360AnnotationFilter);
     /**
@@ -50,7 +49,8 @@ export declare class Image360RevisionEntity<T extends DataSourceType> implements
     getPreviewThumbnailUrl(face?: 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom'): Promise<string | undefined>;
     private loadPreviewTextures;
     private loadFullTextures;
-    private loadAndSetAnnotations;
+    private loadAndSetAllAnnotations;
+    createAndAddAnnotationObjects(annotations: T['image360AnnotationType'][]): Promise<ImageAnnotationObject<T>[]>;
     setDefaultAppearance(appearance: Image360AnnotationAppearance): void;
     private propagateDefaultAppearanceToAnnotations;
     /**

package/dist/packages/360-images/src/entity/Image360VisualizationBox.d.ts

@@ -2,10 +2,10 @@
  * Copyright 2022 Cognite AS
  */
 import * as THREE from 'three';
-import { DeviceDescriptor, SceneHandler } from '../../../utilities';
-import { DataSourceType, Image360Face, Image360Texture } from '../../../data-providers';
-import { Image360Visualization } from './Image360Visualization';
-import { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
+import type { DeviceDescriptor, SceneHandler } from '../../../utilities';
+import type { DataSourceType, Image360Face, Image360Texture } from '../../../data-providers';
+import type { Image360Visualization } from './Image360Visualization';
+import type { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
 export declare const DEFAULT_IMAGE_360_OPACITY = 1;
 export declare class Image360VisualizationBox implements Image360Visualization {
     private readonly MAX_MOBILE_IMAGE_SIZE;

package/dist/packages/360-images/src/icons/FlooredIconManager.d.ts

@@ -1,9 +1,10 @@
 /*!
  * Copyright 2026 Cognite AS
  */
-import { CanvasTexture, Matrix4, Texture, Vector3 } from 'three';
-import { SceneHandler } from '../../../utilities';
-import { Overlay3DIcon } from '../../../3d-overlays';
+import type { Texture } from 'three';
+import { CanvasTexture, Matrix4, Vector3 } from 'three';
+import type { SceneHandler } from '../../../utilities';
+import type { Overlay3DIcon } from '../../../3d-overlays';
 /**
  * Manages two floor disc meshes (same level, elevated) and the floor hover mesh.
  * Encapsulates all per-frame instance placement and elevation routing.
@@ -25,6 +26,8 @@ export declare class FlooredIconManager {
     private readonly _floorDiscMeshColor;
     private readonly _sameLevelCapacity;
     private _referenceWorldY;
+    private _prevSameLevelCount;
+    private _prevElevatedCount;
     constructor(capacity: number, iconRadius: number, maxPixelSize: number, sameLevelTexture: Texture, hoverIconTexture: CanvasTexture, sceneHandler: SceneHandler);
     set hoverVisible(value: boolean);
     showMeshes(): void;

package/dist/packages/360-images/src/icons/IconCollection.d.ts

@@ -1,17 +1,18 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { Matrix4, Ray, Vector3 } from 'three';
-import { BeforeSceneRenderedDelegate, EventTrigger, SceneHandler } from '../../../utilities';
-import { DefaultOverlay3DContentType, IconOctree, Overlay3DIcon } from '../../../3d-overlays';
-import { PointOctant } from 'sparse-octree';
-import { HtmlClusterRendererOptions } from './clustering/HtmlClusterRenderer';
+import type { Ray } from 'three';
+import { Matrix4, Vector3 } from 'three';
+import type { BeforeSceneRenderedDelegate, SceneHandler } from '../../../utilities';
+import type { DefaultOverlay3DContentType } from '../../../3d-overlays';
+import { IconOctree, Overlay3DIcon } from '../../../3d-overlays';
+import type { PointOctant } from 'sparse-octree';
+import type { ClusterScreenInfo } from './clustering';
+import type { HtmlClusterRendererOptions } from '../types';
 export type IconCullingScheme = 'clustered' | 'proximity';
 export type IconsOptions = {
     platformMaxPointsSize?: number;
     htmlClusterOptions?: HtmlClusterRendererOptions;
-    clusterDistanceThreshold?: number;
-    maxOctreeDepth?: number;
     enableHtmlClusters?: boolean;
     enableFloorIcons?: boolean;
 };
@@ -47,7 +48,7 @@ export declare class IconCollection {
     private readonly _pointsObject;
     private readonly _computeClustersEventHandler;
     private readonly _computeProximityPointsEventHandler;
-    private readonly _onBeforeSceneRenderedEvent;
+    private readonly _adaptiveScaleRenderSize;
     private readonly _iconRadius;
     private readonly _renderPositions;
     private readonly _renderColors;
@@ -62,8 +63,8 @@ export declare class IconCollection {
     private _proximityPointLimit;
     private _clusterDistanceThreshold;
     private _maxOctreeDepth;
-    private _activeCullingSchemeEventHandeler;
     private _iconCullingScheme;
+    private _activeCullingHandler;
     private readonly _floorDiscs;
     private _floorMode;
     private _preFloorPointsObjectVisible;
@@ -81,7 +82,7 @@ export declare class IconCollection {
     getMaxOctreeDepth(): number | undefined;
     isHtmlClustersEnabled(): boolean;
     setMaxOctreeDepth(depth: number | undefined): void;
-    constructor(points: Vector3[], sceneHandler: SceneHandler, onBeforeSceneRendered: EventTrigger<BeforeSceneRenderedDelegate>, iconOptions?: IconsOptions, setNeedsRedraw?: () => void);
+    constructor(points: Vector3[], sceneHandler: SceneHandler, iconOptions?: IconsOptions, setNeedsRedraw?: () => void);
     setTransform(transform: Matrix4): void;
     getTransform(out?: Matrix4): Matrix4;
     /**
@@ -93,6 +94,8 @@ export declare class IconCollection {
     intersectCluster(ray: Ray): ClusterIntersectionData | undefined;
     setHoveredClusterIcon(icon: Overlay3DIcon | undefined): void;
     clearHoveredCluster(): void;
+    getStagedHtmlClusterScreenInfos(): ClusterScreenInfo[];
+    applyHtmlClusterOcclusion(occludedIcons: Set<Overlay3DIcon>): void;
     /**
      * Get the currently visible clustered icons (for external intersection handling).
      */
@@ -150,6 +153,8 @@ export declare class IconCollection {
     private updateIconSpritesRenderData;
     private computeProximityPoints;
     private initializeImage360Icons;
+    updateIcons(params: Parameters<BeforeSceneRenderedDelegate>[0]): void;
+    updateCulling(params: Parameters<BeforeSceneRenderedDelegate>[0]): void;
     dispose(): void;
     private createHoverSprite;
     private createOuterRingsTexture;

package/dist/packages/360-images/src/icons/clustering/ClusterRenderingStrategy.d.ts

@@ -1,8 +1,8 @@
 /*!
  * Copyright 2026 Cognite AS
  */
-import { Matrix4, PerspectiveCamera, Vector3, WebGLRenderer } from 'three';
-import { Overlay3DIcon } from '../../../../3d-overlays';
+import type { Matrix4, PerspectiveCamera, Vector3, WebGLRenderer } from 'three';
+import type { Overlay3DIcon } from '../../../../3d-overlays';
 export type ClusteredIconData = {
     icon: Overlay3DIcon;
     isCluster: boolean;
@@ -16,3 +16,10 @@ export type ClusterRenderParams = {
     camera: PerspectiveCamera;
     modelTransform: Matrix4;
 };
+export type ClusterScreenInfo = {
+    data: ClusteredIconData;
+    screenPos: Vector3;
+    worldPos: Vector3;
+    distance: number;
+    projectedSize: number;
+};

package/dist/packages/360-images/src/icons/clustering/HtmlClusterCoordinator.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2026 Cognite AS
+ */
+import type { Overlay3DIcon } from '../../../../3d-overlays';
+import type { ClusterScreenInfo } from './ClusterRenderingStrategy';
+export interface HtmlClusterCollection {
+    getStagedHtmlClusterScreenInfos(): ClusterScreenInfo[];
+    applyHtmlClusterOcclusion(occludedIcons: Set<Overlay3DIcon>): void;
+}
+/**
+ * Coordinates HTML cluster occlusion detection across multiple Image360Collections.
+ * Gathers per-frame screen-space data from all collections and computes a single
+ * global occlusion set, then feeds it back to each collection for DOM updates.
+ */
+export declare class HtmlClusterCoordinator {
+    private readonly _occlusionFactor;
+    runCoordinator(collections: HtmlClusterCollection[]): void;
+    private computeGlobalOcclusion;
+}