@cognite/reveal 4.32.3 → 4.34.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,7 +1,4 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import { Camera, Matrix4, Vector2 } from 'three';
+import { Camera, Vector2, Matrix4 } from 'three';
 import { Image360Entity } from './entity/Image360Entity';
 import { Image360CollectionFactory } from './collection/Image360CollectionFactory';
 import { DefaultImage360Collection } from './collection/DefaultImage360Collection';

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { DataSourceType } from '../../data-providers';
 import { Image360 } from './entity/Image360';
 import { Image360Action } from './Image360Action';

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2023 Cognite AS
- */
 import { Color, Vector3 } from 'three';
 import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
 /**

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2023 Cognite AS
- */
 import { Image360AnnotationFilterOptions } from './types';
 import { DataSourceType } from '../../../data-providers';
 export declare class Image360AnnotationFilter {

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2023 Cognite AS
- */
 import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
 import { Image360Annotation } from './Image360Annotation';
 import { Vector3 } from 'three';

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

@@ -1,8 +1,5 @@
-/*!
- * Copyright 2023 Cognite AS
- */
 import { DataSourceType, Image360FileDescriptor } from '../../../data-providers';
-import { Color, Matrix4, Vector3, Object3D, Raycaster } from 'three';
+import { Object3D, Raycaster, Color, Matrix4, Vector3 } from 'three';
 import { Image360Annotation } from './Image360Annotation';
 import { Image360AnnotationAppearance } from './types';
 type FaceType = Image360FileDescriptor['face'];

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

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

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

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

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

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

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

@@ -1,7 +1,4 @@
-/*!
- * Copyright 2023 Cognite AS
- */
-import { BufferGeometry, Matrix4, ShapeGeometry, Vector3 } from 'three';
+import { BufferGeometry, Vector3, Matrix4, ShapeGeometry } from 'three';
 import { AnnotationsPolygon } from '@cognite/sdk';
 import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
 export declare class PolygonAnnotationGeometryData implements ImageAnnotationObjectGeometryData {

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2024 Cognite AS
- */
 import { Box3, Vector3 } from 'three';
 export declare class Vector3ArrayUtils {
     static getSignedHorizontalArea(polygon: Vector3[]): number;

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

@@ -1,5 +1,2 @@
-/*!
- * Copyright 2024 Cognite AS
- */
 import { Vector3 } from 'three';
 export declare function createTriangleIndexesFromVectors(vectors: Vector3[]): number[] | undefined;

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

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

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2025 Cognite AS
- */
 import { DataSourceType } from '../../../data-providers';
 import { 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,6 +1,3 @@
-/*!
- * Copyright 2025 Cognite AS
- */
 import { AnnotationData, AnnotationModel, AnnotationsObjectDetection, AnnotationsTypesImagesAssetLink, AnnotationsTypesImagesInstanceLink, AnnotationType } from '@cognite/sdk';
 import { DataSourceType, DMDataSourceType, ImageAssetLinkAnnotationInfo, ImageInstanceLinkAnnotationInfo } from '../../../data-providers';
 export declare function isCoreDmImage360Annotation(annotation: DataSourceType['image360AnnotationType']): annotation is DMDataSourceType['image360AnnotationType'];

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2023 Cognite AS
- */
 import { AnnotationStatus } from '@cognite/sdk';
 import { ClassicDataSourceType, DataSourceType, DMDataSourceType, InstanceReference } from '../../../data-providers';
 import { Color } from 'three';

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { Image360Entity } from '../entity/Image360Entity';
 import { Image360RevisionEntity } from '../entity/Image360RevisionEntity';
 import { DataSourceType } from '../../../data-providers';

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

@@ -1,13 +1,12 @@
-/*!
- * Copyright 2023 Cognite AS
- */
-import { EventTrigger } from '../../../utilities';
+import { BeforeSceneRenderedDelegate, 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 { ClusterScreenInfo } from '../icons/clustering';
+import { HtmlClusterCollection } from '../icons/clustering/HtmlClusterCoordinator';
 import { ClassicDataSourceType, DataSourceType, DMDataSourceType, Image360FileDescriptor, Image360Provider } from '../../../data-providers';
 import { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
 import { Matrix4, Ray } from 'three';
@@ -16,7 +15,7 @@ import { 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 +130,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,11 @@
-/*!
- * 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 { ClassicDataSourceType, DataSourceType, DMDataSourceType, ImageInstanceLinkAnnotationInfo, ImageAssetLinkAnnotationInfo } from '../../../data-providers';
 import { Matrix4 } from 'three';
-import { 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,16 @@
-/*!
- * Copyright 2023 Cognite AS
- */
 import { DataSourceType } from '../../../data-providers';
-import { BeforeSceneRenderedDelegate, DeviceDescriptor, EventTrigger, SceneHandler } from '../../../utilities';
+import { DeviceDescriptor, SceneHandler } from '../../../utilities';
 import { DefaultImage360Collection } from './DefaultImage360Collection';
 import { IconsOptions } from '../icons/IconCollection';
-import { type Matrix4 } from 'three';
+import { Matrix4 } from 'three';
 import { Image360AnnotationFilterOptions } from '../annotation/types';
 import { 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,2 @@
-/*!
- * Copyright 2025 Cognite AS
- */
 import { DataSourceType } from '../../../data-providers';
 export declare function createCollectionIdString(id: DataSourceType['image360Identifier']): string;

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

@@ -1,10 +1,7 @@
-/*!
- * 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 { Color, Matrix4 } from 'three';
 import { Image360Id } from '../../../data-providers/src/types';
 /**
  * Image360 icon style

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { DeviceDescriptor, SceneHandler } from '../../../utilities';
 import { DataSourceType, Image360Provider } from '../../../data-providers';
 import { Image360 } from './Image360';
@@ -10,7 +7,7 @@ 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 { Color, Matrix4, Raycaster } from 'three';
 export declare class Image360Entity<T extends DataSourceType> implements Image360<T> {
     private readonly _revisions;
     private readonly _imageMetadata;
@@ -47,7 +44,7 @@ export declare class Image360Entity<T extends DataSourceType> implements Image36
      * @returns Station label
      * */
     get label(): string | undefined;
-    constructor(image360Metadata: Historical360ImageSet<T>, sceneHandler: SceneHandler, imageProvider: Image360Provider<T>, annotationFilterer: Image360AnnotationFilter, transform: Matrix4, icon: Overlay3DIcon, device: DeviceDescriptor);
+    constructor(image360Metadata: Historical360ImageSet<T>, sceneHandler: SceneHandler, imageProvider: Image360Provider<T>, annotationFilterer: Image360AnnotationFilter, transform: Matrix4, icon: Overlay3DIcon, device: DeviceDescriptor, requestRedraw?: () => void);
     setWorldTransform(matrix: Matrix4): void;
     /**
      * List all historical images for this entity.

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

@@ -0,0 +1,34 @@
+import { DeviceDescriptor } from '../../../utilities';
+import { Image360Face, Image360Texture } from '../../../data-providers';
+import { JpegType } from '../utils/JpegDataStreamParser';
+import { Texture, TextureLoader } from 'three';
+export type Image360FaceWithUrl = Image360Face & {
+    downloadUrl: string;
+};
+export declare function hasDownloadUrl(face: Image360Face): face is Image360FaceWithUrl;
+export interface FaceTextureLoader {
+    load(face: Image360Face, onFirstFaceReady?: () => void, onJpegTypeDetected?: (type: JpegType) => void, abortSignal?: AbortSignal): Promise<Image360Texture>;
+}
+/**
+ * Handles all texture loading for 360 image cube faces:
+ * - URL-based streaming (progressive and baseline JPEG detection)
+ * - In-memory buffer decoding
+ */
+export declare class Image360FaceTextureLoader implements FaceTextureLoader {
+    private readonly _device;
+    private readonly _textureLoader;
+    private readonly _onUpdate;
+    private readonly _updateFaceTexture;
+    private readonly _isMeshAlive;
+    private readonly MAX_MOBILE_IMAGE_SIZE;
+    constructor(_device: DeviceDescriptor, _textureLoader: TextureLoader, _onUpdate: () => void, _updateFaceTexture: (face: Image360Face['face'], texture: Texture) => void, _isMeshAlive: () => boolean);
+    /**
+     * Loads a texture for a single cube face. Automatically selects the streaming path when
+     * face has a downloadUrl (progressive/baseline JPEG detection) or decodes from in-memory buffer otherwise.
+     */
+    load(face: Image360Face, onFirstFaceReady?: () => void, onJpegTypeDetected?: (type: JpegType) => void, abortSignal?: AbortSignal): Promise<Image360Texture>;
+    private loadFromBuffer;
+    private streamFaceTexture;
+    private finalizeTexture;
+    private applyBitmapToTexture;
+}

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

@@ -1,6 +1,3 @@
-/*!
- * Copyright 2022 Cognite AS
- */
 import { Image360Annotation } from '../annotation/Image360Annotation';
 import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
 /**

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

@@ -1,14 +1,11 @@
-/*!
- * Copyright 2022 Cognite AS
- */
-import { Image360Descriptor, DataSourceType, Image360Provider } from '../../../data-providers';
+import { Image360Descriptor, Image360RevisionId, DataSourceType, Image360Provider } from '../../../data-providers';
 import { Image360Revision } from './Image360Revision';
 import { Image360VisualizationBox } from './Image360VisualizationBox';
+import { JpegType } from '../utils/JpegDataStreamParser';
 import { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
-import { type Raycaster } from 'three';
+import { Raycaster } from 'three';
 import { Image360AnnotationAppearance } from '../annotation/types';
 import { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
-import { Image360RevisionId } from '../../../data-providers/src/types';
 export declare class Image360RevisionEntity<T extends DataSourceType> implements Image360Revision<T> {
     private readonly _imageProvider;
     private readonly _image360Descriptor;
@@ -16,10 +13,11 @@ export declare class Image360RevisionEntity<T extends DataSourceType> implements
     private _previewTextures;
     private _fullResolutionTextures;
     private _onFullResolutionCompleted;
+    private _jpegType;
     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);
     /**
@@ -31,6 +29,7 @@ export declare class Image360RevisionEntity<T extends DataSourceType> implements
      * @returns Date | undefined
      */
     get date(): Date | undefined;
+    get jpegType(): JpegType | undefined;
     getAnnotations(): Promise<ImageAnnotationObject<T>[]>;
     intersectAnnotations(raycaster: Raycaster): ImageAnnotationObject<T> | undefined;
     /**
@@ -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

@@ -1,24 +1,26 @@
-/*!
- * 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 { JpegType } from '../utils/JpegDataStreamParser';
+import { FaceTextureLoader } from './Image360FaceTextureLoader';
+/*!
+ * Copyright 2022 Cognite AS
+ */
+import * as THREE from 'three';
 export declare const DEFAULT_IMAGE_360_OPACITY = 1;
 export declare class Image360VisualizationBox implements Image360Visualization {
-    private readonly MAX_MOBILE_IMAGE_SIZE;
+    private readonly _requestRedraw;
     private readonly _worldTransform;
     private _visualizationMesh;
     private _faceMaterials;
     private readonly _sceneHandler;
-    private readonly _device;
     private readonly _visualizationState;
     private readonly _textureLoader;
     private readonly _faceMaterialOrder;
     private readonly _annotationsGroup;
     private readonly _localTransform;
+    private readonly _loader;
     get visible(): boolean;
     set visible(value: boolean);
     get opacity(): number;
@@ -26,12 +28,14 @@ export declare class Image360VisualizationBox implements Image360Visualization {
     set scale(value: THREE.Vector3);
     set renderOrder(value: number);
     setAnnotations(annotations: ImageAnnotationObject<DataSourceType>[]): void;
-    constructor(worldTransform: THREE.Matrix4, sceneHandler: SceneHandler, device: DeviceDescriptor);
+    constructor(worldTransform: THREE.Matrix4, sceneHandler: SceneHandler, device: DeviceDescriptor, _requestRedraw?: () => void, faceTextureLoader?: FaceTextureLoader);
     setWorldTransform(matrix: THREE.Matrix4): void;
-    loadImages(textures: Image360Texture[]): void;
+    setImages(textures: Image360Texture[]): void;
+    private buildVisualizationMesh;
     getTransform(): THREE.Matrix4;
-    loadFaceTextures(faces: Image360Face[]): Promise<Image360Texture[]>;
+    loadFaceTextures(faces: Image360Face[], onFirstFaceReady?: () => void, onFirstFaceTypeDetected?: (type: JpegType) => void, abortSignal?: AbortSignal): Promise<Image360Texture[]>;
+    private createPlaceholderMesh;
+    updateFaceTexture(face: Image360Face['face'], texture: THREE.Texture): void;
     unloadImages(): void;
-    private getScaledImageTexture;
     setAnnotationsVisibility(visibility: boolean): void;
 }

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

@@ -1,7 +1,4 @@
-/*!
- * Copyright 2026 Cognite AS
- */
-import { CanvasTexture, Matrix4, Texture, Vector3 } from 'three';
+import { Texture, CanvasTexture, Matrix4, Vector3 } from 'three';
 import { SceneHandler } from '../../../utilities';
 import { Overlay3DIcon } from '../../../3d-overlays';
 /**

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

@@ -1,17 +1,13 @@
-/*!
- * Copyright 2023 Cognite AS
- */
-import { Matrix4, Ray, Vector3 } from 'three';
-import { BeforeSceneRenderedDelegate, EventTrigger, SceneHandler } from '../../../utilities';
+import { Ray, Matrix4, Vector3 } from 'three';
+import { BeforeSceneRenderedDelegate, SceneHandler } from '../../../utilities';
 import { DefaultOverlay3DContentType, IconOctree, Overlay3DIcon } from '../../../3d-overlays';
 import { PointOctant } from 'sparse-octree';
-import { HtmlClusterRendererOptions } from './clustering/HtmlClusterRenderer';
+import { ClusterScreenInfo } from './clustering';
+import { 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 +43,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 +58,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 +77,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 +89,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 +148,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,6 +1,3 @@
-/*!
- * Copyright 2026 Cognite AS
- */
 import { Matrix4, PerspectiveCamera, Vector3, WebGLRenderer } from 'three';
 import { Overlay3DIcon } from '../../../../3d-overlays';
 export type ClusteredIconData = {
@@ -16,3 +13,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,16 @@
+import { Overlay3DIcon } from '../../../../3d-overlays';
+import { 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;
+}

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

@@ -1,14 +1,6 @@
-/*!
- * Copyright 2026 Cognite AS
- */
 import { Overlay3DIcon } from '../../../../3d-overlays';
-import { ClusteredIconData, ClusterRenderParams } from './ClusterRenderingStrategy';
-export type HtmlClusterRendererOptions = {
-    maxPoolSize?: number;
-    classPrefix?: string;
-    enableHoverAnimations?: boolean;
-    zIndex?: number;
-};
+import { ClusteredIconData, ClusterRenderParams, ClusterScreenInfo } from './ClusterRenderingStrategy';
+import { HtmlClusterRendererOptions } from '../../types';
 /** HTML-based cluster rendering for high-definition text display */
 export declare class HtmlClusterRenderer {
     private readonly _container;
@@ -22,15 +14,21 @@ export declare class HtmlClusterRenderer {
     private readonly _baseSize;
     private readonly _minSize;
     private readonly _maxSize;
+    private readonly _clusterFadeStartDistance;
+    private readonly _clusterFadeEndDistance;
     private readonly _pendingReleaseTimeouts;
     private _hoveredClusterIcon;
     private _isVisible;
     private _isAttached;
     private _domElement;
-    private readonly _tempPosition;
-    private readonly _tempProjectedPosition;
+    private _stagedScreenInfos;
+    private _stagedCanvas;
+    private _stagedCanvasRect;
+    private readonly _countSpanCache;
     constructor(options?: HtmlClusterRendererOptions);
-    updateClusters(visibleClusters: ClusteredIconData[], params: ClusterRenderParams): void;
+    prepareClusters(visibleClusters: ClusteredIconData[], params: ClusterRenderParams): void;
+    getStagedScreenInfos(): ClusterScreenInfo[];
+    applyWithOcclusion(occludedIcons: Set<Overlay3DIcon>): void;
     setHoveredCluster(icon: Overlay3DIcon | undefined): void;
     getHoveredCluster(): Overlay3DIcon | undefined;
     setVisible(visible: boolean): void;
@@ -43,6 +41,8 @@ export declare class HtmlClusterRenderer {
     private acquireElement;
     private releaseElement;
     private createClusterElement;
-    private updateClusterElement;
+    private computeClusterScreenInfos;
+    private computeFadeOpacity;
+    private applyClusterElementUpdate;
     private setElementHovered;
 }