@cognite/reveal 4.22.0 → 4.23.0-dev.20250122

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

@@ -3,7 +3,7 @@
  */
 export { Image360, Image360IconStyle } from './src/entity/Image360';
 export { Image360Revision } from './src/entity/Image360Revision';
-export { Image360Collection, Image360AnnotationAssetFilter, Image360AnnotationAssetQueryResult, AssetAnnotationImage360Info } from './src/collection/Image360Collection';
+export { Image360Collection, Image360AnnotationAssetFilter, Image360AnnotationAssetQueryResult, InstanceLinkable360ImageAnnotationType, AssetAnnotationImage360Info } from './src/collection/Image360Collection';
 export { Image360Facade } from './src/Image360Facade';
 export { Image360CollectionFactory } from './src/collection/Image360CollectionFactory';
 export { Image360Entity } from './src/entity/Image360Entity';
@@ -15,5 +15,9 @@ export { Image360AnnotationIntersection } from './src/annotation/Image360Annotat
 export { Image360Annotation } from './src/annotation/Image360Annotation';
 export { DefaultImage360Collection } from './src/collection/DefaultImage360Collection';
 export { IconsOptions } from './src/icons/IconCollection';
-export { Image360History } from './src/Image360History';
+export { Image360CollectionSourceType, Image360IconIntersectionData } from './src/types';
+export { Image360AnnotationFilter } from './src/annotation/Image360AnnotationFilter';
+export { DEFAULT_IMAGE_360_OPACITY } from './src/entity/Image360VisualizationBox';
 export { Image360Action } from './src/Image360Action';
+export { Image360History } from './src/Image360History';
+export { createCollectionIdString } from './src/collection/createCollectionIdString';

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

@@ -22,8 +22,8 @@ export declare class Image360Facade<T extends DataSourceType> {
     setHoverIconVisibilityForEntity(entity: Image360Entity<T>, visible: boolean): void;
     hideAllHoverIcons(): boolean;
     set allIconCullingScheme(scheme: IconCullingScheme);
-    constructor(_entityFactory: Image360CollectionFactory<T>);
-    create(dataProviderFilter: T['image360Identifier'], annotationFilter?: Image360AnnotationFilterOptions, postTransform?: THREE.Matrix4, preComputedRotation?: boolean): Promise<DefaultImage360Collection<T>>;
+    constructor(_entityFactory: Image360CollectionFactory);
+    create<Image360CollectionSourceType extends DataSourceType>(collectionIdentifier: Image360CollectionSourceType['image360Identifier'], annotationFilter?: Image360AnnotationFilterOptions, postTransform?: THREE.Matrix4, preComputedRotation?: boolean): Promise<DefaultImage360Collection<T>>;
     removeSet(collection: DefaultImage360Collection<T>): void;
     delete(entity: Image360Entity<T>): Promise<void>;
     preload(entity: Image360Entity<T>, revision: Image360RevisionEntity<T>, lockDownload?: boolean): Promise<void>;

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

@@ -1,15 +1,16 @@
 /*!
  * Copyright 2022 Cognite AS
  */
+import { DataSourceType } from '../../data-providers';
 import { Image360 } from './entity/Image360';
 import { Image360Action } from './Image360Action';
 export declare class Image360History {
     private readonly _images;
     private _currentIndex;
-    start(image: Image360): void;
+    start(image: Image360<DataSourceType>): void;
     private current;
     clear(): void;
     private isLegalIndex;
     canDoAction(action: Image360Action): boolean;
-    doAction(action: Image360Action): Image360 | undefined;
+    doAction(action: Image360Action): Image360<DataSourceType> | undefined;
 }

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

@@ -1,12 +1,12 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { AnnotationModel } from '@cognite/sdk';
 import { Image360AnnotationFilterOptions } from './types';
+import { DataSourceType } from '../../../data-providers';
 export declare class Image360AnnotationFilter {
     private readonly _annotationFilter;
     private fillDefaultAnnotationOptionValues;
     constructor(options: Image360AnnotationFilterOptions);
     private filterStatus;
-    filter(annotation: AnnotationModel): boolean;
+    filter(annotation: DataSourceType['image360AnnotationType']): boolean;
 }

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

@@ -1,12 +1,13 @@
 /*!
  * Copyright 2023 Cognite AS
  */
+import { ClassicDataSourceType, DataSourceType } from '../../../data-providers';
 import { Image360Annotation } from './Image360Annotation';
 import { Vector3 } from 'three';
 /**
  * Describes an intersection with a 360 image annotation
  */
-export type Image360AnnotationIntersection = {
+export type Image360AnnotationIntersection<T extends DataSourceType = ClassicDataSourceType> = {
     /**
      * The intersection type.
      */
@@ -14,7 +15,7 @@ export type Image360AnnotationIntersection = {
     /**
      * The intersected annotation
      */
-    annotation: Image360Annotation;
+    annotation: Image360Annotation<T>;
     /**
      * The world direction from the camera to the intersection point
      */

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

@@ -1,9 +1,8 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { AnnotationModel } from '@cognite/sdk';
 import { DataSourceType, Image360FileDescriptor } from '../../../data-providers';
-import { Color, Vector3, Object3D, Raycaster } from 'three';
+import { Color, Matrix4, Vector3, Object3D, Raycaster } from 'three';
 import { Image360Annotation } from './Image360Annotation';
 import { Image360AnnotationAppearance } from './types';
 type FaceType = Image360FileDescriptor['face'];
@@ -15,11 +14,12 @@ export declare class ImageAnnotationObject<T extends DataSourceType> implements
     private readonly _objectGroup;
     private _defaultAppearance;
     private readonly _appearance;
-    get annotation(): AnnotationModel;
-    static createAnnotationObject<StaticT extends DataSourceType>(annotation: AnnotationModel, face: FaceType): ImageAnnotationObject<StaticT> | undefined;
+    get annotation(): T['image360AnnotationType'];
+    static createAnnotationObject<StaticT extends DataSourceType>(annotation: StaticT['image360AnnotationType'], face: FaceType | undefined, visualizationBoxTransform: Matrix4): ImageAnnotationObject<StaticT> | undefined;
     private static createObjectData;
-    private static createObjectDetectionAnnotationData;
+    private static createObjectDetectionAnnotationGeometry;
     private static createAssetLinkAnnotationData;
+    private static createFdmAnnotationData;
     private constructor();
     private getRotationFromFace;
     private initializeTransform;

package/dist/packages/360-images/src/annotation/{BoxAnnotationData.d.ts → geometry/BoxAnnotationGeometryData.d.ts}

@@ -1,10 +1,10 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { ImageAnnotationObjectData } from './ImageAnnotationData';
-import { BufferGeometry, Matrix4, PlaneGeometry, Vector2 } from 'three';
+import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
+import { BufferGeometry, Matrix4, PlaneGeometry, Vector3 } from 'three';
 import { AnnotationsBoundingBox } from '@cognite/sdk';
-export declare class BoxAnnotationData implements ImageAnnotationObjectData {
+export declare class BoxAnnotationGeometryData implements ImageAnnotationObjectGeometryData {
     private readonly _geometry;
     private readonly _initialTranslation;
     private readonly _outline;
@@ -12,5 +12,5 @@ export declare class BoxAnnotationData implements ImageAnnotationObjectData {
     createGeometry(annotationsBox: AnnotationsBoundingBox): PlaneGeometry;
     getGeometry(): BufferGeometry;
     getNormalizationMatrix(): Matrix4;
-    getOutlinePoints(): Vector2[];
+    getOutlinePoints(): Vector3[];
 }

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

@@ -0,0 +1,15 @@
+/*!
+ * Copyright 2023 Cognite AS
+ */
+import { BufferGeometry, Matrix4, Vector3 } from 'three';
+import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
+export declare class DmMesh3dAnnotationGeometryData implements ImageAnnotationObjectGeometryData {
+    private readonly _geometry;
+    private readonly _outlinePoints;
+    private readonly _inverseVisualizationBoxTransform;
+    constructor(positions: Vector3[], visualizationBoxTransform: Matrix4);
+    createGeometry(points: Vector3[]): BufferGeometry;
+    getGeometry(): BufferGeometry;
+    getNormalizationMatrix(): Matrix4;
+    getOutlinePoints(): Vector3[];
+}

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

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

package/dist/packages/360-images/src/annotation/{PolygonAnnotationData.d.ts → geometry/PolygonAnnotationGeometryData.d.ts}

@@ -1,15 +1,15 @@
 /*!
  * Copyright 2023 Cognite AS
  */
-import { BufferGeometry, Matrix4, ShapeGeometry, Vector2 } from 'three';
+import { BufferGeometry, Matrix4, ShapeGeometry, Vector3 } from 'three';
 import { AnnotationsPolygon } from '@cognite/sdk';
-import { ImageAnnotationObjectData } from './ImageAnnotationData';
-export declare class PolygonAnnotationData implements ImageAnnotationObjectData {
+import { ImageAnnotationObjectGeometryData } from './ImageAnnotationGeometryData';
+export declare class PolygonAnnotationGeometryData implements ImageAnnotationObjectGeometryData {
     private readonly _geometry;
     private readonly _outlinePoints;
     constructor(polygon: AnnotationsPolygon);
     createGeometry(polygon: AnnotationsPolygon): ShapeGeometry;
     getGeometry(): BufferGeometry;
     getNormalizationMatrix(): Matrix4;
-    getOutlinePoints(): Vector2[];
+    getOutlinePoints(): Vector3[];
 }

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

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

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

@@ -0,0 +1,5 @@
+/*!
+ * 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

@@ -0,0 +1,5 @@
+/*!
+ * 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

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

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

@@ -0,0 +1,8 @@
+/*!
+ * Copyright 2025 Cognite AS
+ */
+import { AnnotationData, AnnotationsCogniteAnnotationTypesImagesAssetLink, AnnotationsObjectDetection, AnnotationType } from '@cognite/sdk';
+import { DataSourceType, DMDataSourceType } 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 isAnnotationAssetLink(annotationType: AnnotationType, annotation: AnnotationData): annotation is AnnotationsCogniteAnnotationTypesImagesAssetLink;

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

@@ -4,29 +4,29 @@
 import { Image360Entity } from '../entity/Image360Entity';
 import { Image360RevisionEntity } from '../entity/Image360RevisionEntity';
 import { DataSourceType } from '../../../data-providers';
-export type DownloadRequest = {
-    entity: Image360Entity<DataSourceType>;
-    revision: Image360RevisionEntity<DataSourceType>;
+export type DownloadRequest<T extends DataSourceType> = {
+    entity: Image360Entity<T>;
+    revision: Image360RevisionEntity<T>;
     anyCompleted: Promise<void>;
     allCompleted: Promise<void>;
     abort: () => void;
 };
-export type Loaded360Image = {
-    entity: Image360Entity<DataSourceType>;
-    revision: Image360RevisionEntity<DataSourceType>;
+export type Loaded360Image<T extends DataSourceType> = {
+    entity: Image360Entity<T>;
+    revision: Image360RevisionEntity<T>;
 };
-export declare class Image360LoadingCache {
+export declare class Image360LoadingCache<T extends DataSourceType> {
     private readonly _imageCacheSize;
     private readonly _downloadCacheSize;
     private readonly _loaded360Images;
     private readonly _inProgressDownloads;
     private _lockedDownload;
-    get cachedRevisions(): Image360RevisionEntity<DataSourceType>[];
-    get currentlyLoadingEntities(): DownloadRequest[];
-    getDownloadInProgress(revision: Image360RevisionEntity<DataSourceType>): DownloadRequest | undefined;
+    get cachedRevisions(): Image360RevisionEntity<T>[];
+    get currentlyLoadingEntities(): DownloadRequest<T>[];
+    getDownloadInProgress(revision: Image360RevisionEntity<T>): DownloadRequest<T> | undefined;
     constructor(_imageCacheSize?: number, _downloadCacheSize?: number);
-    cachedPreload(entity: Image360Entity<DataSourceType>, revision: Image360RevisionEntity<DataSourceType>, lockDownload?: boolean): Promise<void>;
-    purge(entity: Image360Entity<DataSourceType>): Promise<void>;
+    cachedPreload(entity: Image360Entity<T>, revision: Image360RevisionEntity<T>, lockDownload?: boolean): Promise<void>;
+    purge(entity: Image360Entity<T>): Promise<void>;
     private cacheWhenAllComplete;
     private purgeFromInProgressDownloads;
     private addRevisionToCache;

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

@@ -7,10 +7,10 @@ import { Image360Entity } from '../entity/Image360Entity';
 import { Image360EnteredDelegate, Image360ExitedDelegate } from '../types';
 import { IconCollection, IconCullingScheme } from '../icons/IconCollection';
 import { Image360AnnotationAppearance } from '../annotation/types';
-import { IdEither } from '@cognite/sdk';
-import { DataSourceType, Image360DataProvider } from '../../../data-providers';
+import { ClassicDataSourceType, DataSourceType, DMDataSourceType, Image360FileDescriptor, Image360Provider } from '../../../data-providers';
 import { Image360AnnotationFilter } from '../annotation/Image360AnnotationFilter';
 import { Matrix4 } from 'three';
+import { InstanceReference } from '../../../data-providers/src/types';
 /**
  * Default implementation of {@link Image360Collection}. Used for events when entering
  * and exiting 360 image mode
@@ -35,6 +35,10 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
     private readonly _collectionId;
     private readonly _collectionLabel;
     private readonly _setNeedsRedraw;
+    get collectionId(): T['image360Identifier'];
+    /**
+     * @deprecated
+     */
     get id(): string;
     get label(): string | undefined;
     get targetRevisionDate(): Date | undefined;
@@ -43,11 +47,11 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
      * The events from the image collection.
      */
     get events(): {
-        image360Entered: EventTrigger<Image360EnteredDelegate>;
+        image360Entered: EventTrigger<Image360EnteredDelegate<T>>;
         image360Exited: EventTrigger<Image360ExitedDelegate>;
     };
     get isCollectionVisible(): boolean;
-    constructor(collectionId: string, collectionLabel: string | undefined, entities: Image360Entity<T>[], icons: IconCollection, annotationFilter: Image360AnnotationFilter, image360DataProvider: Image360DataProvider, setNeedsRedraw: () => void);
+    constructor(identifier: T['image360Identifier'], collectionLabel: string | undefined, entities: Image360Entity<T>[], icons: IconCollection, annotationFilter: Image360AnnotationFilter, image360DataProvider: Image360Provider<T>, setNeedsRedraw: () => void);
     getModelTransformation(out?: Matrix4): Matrix4;
     setModelTransformation(matrix: Matrix4): void;
     /**
@@ -57,7 +61,7 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
      * @param event The event type.
      * @param callback Callback to be called when the event is fired.
      */
-    on(event: 'image360Entered', callback: Image360EnteredDelegate): void;
+    on(event: 'image360Entered', callback: Image360EnteredDelegate<T>): void;
     on(event: 'image360Exited', callback: Image360ExitedDelegate): void;
     /**
      * Specify parameters used to determine the number of icons that are visible when entering 360 Images.
@@ -78,7 +82,7 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
      * @param event The event type.
      * @param callback Callback function to be unsubscribed.
      */
-    off(event: 'image360Entered', callback: Image360EnteredDelegate): void;
+    off(event: 'image360Entered', callback: Image360EnteredDelegate<T>): void;
     off(event: 'image360Exited', callback: Image360ExitedDelegate): void;
     setSelectedForAll(selected: boolean): void;
     setSelectedVisibility(visible: boolean): boolean;
@@ -89,9 +93,10 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
     resetRedraw(): void;
     getDefaultAnnotationStyle(): Image360AnnotationAppearance;
     setDefaultAnnotationStyle(defaultStyle: Image360AnnotationAppearance): void;
-    findImageAnnotations(filter: Image360AnnotationAssetFilter): Promise<Image360AnnotationAssetQueryResult[]>;
-    getAssetIds(): Promise<IdEither[]>;
-    getAnnotationsInfo(): Promise<AssetAnnotationImage360Info<T>[]>;
-    private getAllFileDescriptors;
-    private createFileIdToEntityRevisionMap;
+    findImageAnnotations(filter: Image360AnnotationAssetFilter<T>): Promise<Image360AnnotationAssetQueryResult<T>[]>;
+    getAssetIds(): Promise<InstanceReference<T>[]>;
+    getAnnotationsInfo(source: 'assets'): Promise<AssetAnnotationImage360Info<ClassicDataSourceType>[]>;
+    getAnnotationsInfo(source: 'cdm'): Promise<AssetAnnotationImage360Info<DMDataSourceType>[]>;
+    getAnnotationsInfo(source: 'all'): Promise<AssetAnnotationImage360Info<DataSourceType>[]>;
+    getAllFileDescriptors(): Image360FileDescriptor[];
 }

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

@@ -7,16 +7,22 @@ import { Image360AnnotationAppearance } from '../annotation/types';
 import { Image360Revision } from '../entity/Image360Revision';
 import { IdEither } from '@cognite/sdk';
 import { Image360Annotation } from '../annotation/Image360Annotation';
-import { ClassicDataSourceType, DataSourceType, ImageAssetLinkAnnotationInfo } from '../../../data-providers';
+import { ClassicDataSourceType, DataSourceType, DMDataSourceType } from '../../../data-providers';
 import { Matrix4 } from 'three';
+import { ImageAssetLinkAnnotationInfo, InstanceReference } 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
+ */
+export type InstanceLinkable360ImageAnnotationType<T extends DataSourceType> = T extends ClassicDataSourceType ? ImageAssetLinkAnnotationInfo : T['image360AnnotationType'];
 /**
  * Filter for finding annotations related to an asset
  */
-export type Image360AnnotationAssetFilter = {
+export type Image360AnnotationAssetFilter<T extends DataSourceType = ClassicDataSourceType> = {
     /**
      * Reference to the wanted asset
      */
-    assetRef: IdEither;
+    assetRef: InstanceReference<T>;
 };
 /**
  * Asset search return type, including information about the image in which the asset is found
@@ -25,7 +31,7 @@ export type AssetAnnotationImage360Info<T extends DataSourceType = ClassicDataSo
     /**
      * Reference to the relevant asset
      */
-    annotationInfo: ImageAssetLinkAnnotationInfo;
+    annotationInfo: InstanceLinkable360ImageAnnotationType<T>;
     /**
      * The image entity in which the asset was found
      */
@@ -38,19 +44,19 @@ export type AssetAnnotationImage360Info<T extends DataSourceType = ClassicDataSo
 /**
  * Result item from an asset annotation query
  */
-export type Image360AnnotationAssetQueryResult = {
+export type Image360AnnotationAssetQueryResult<T extends DataSourceType = ClassicDataSourceType> = {
     /**
      * The Image360 to which the result annotation belongs
      */
-    image: Image360;
+    image: Image360<T>;
     /**
      * The image revision to which the result annotation belongs
      */
-    revision: Image360Revision;
+    revision: Image360Revision<T>;
     /**
      * The found annotation
      */
-    annotation: Image360Annotation;
+    annotation: Image360Annotation<T>;
 };
 /**
  * A wrapper that represents a set of 360 images.
@@ -137,14 +143,14 @@ export interface Image360Collection<T extends DataSourceType = ClassicDataSource
      * @param event The event type.
      * @param callback Callback to be called when the event is fired.
      */
-    on(event: 'image360Entered', callback: Image360EnteredDelegate): void;
+    on(event: 'image360Entered', callback: Image360EnteredDelegate<T>): void;
     on(event: 'image360Exited', callback: Image360ExitedDelegate): void;
     /**
      * Unsubscribes from 360 image dataset event.
      * @param event The event type.
      * @param callback Callback function to be unsubscribed.
      */
-    off(event: 'image360Entered', callback: Image360EnteredDelegate): void;
+    off(event: 'image360Entered', callback: Image360EnteredDelegate<T>): void;
     off(event: 'image360Exited', callback: Image360ExitedDelegate): void;
     /**
      * Get the assigned default style affecting all annotations
@@ -157,18 +163,30 @@ export interface Image360Collection<T extends DataSourceType = ClassicDataSource
     /**
      * Find 360 images associated with an asset through CDF annotations
      */
-    findImageAnnotations(filter: Image360AnnotationAssetFilter): Promise<Image360AnnotationAssetQueryResult[]>;
+    findImageAnnotations(filter: Image360AnnotationAssetFilter<T>): Promise<Image360AnnotationAssetQueryResult<T>[]>;
     /**
      * Get IDs of all CDF assets associated with this 360 image collection through CDF annotations
      *
-     * @deprecated Use {@link Image360Collection.getAnnotationsInfo}
+     * @deprecated Use {@link Image360Collection['getAnnotationsInfo']}
      */
     getAssetIds(): Promise<IdEither[]>;
     /**
-     * Get IDs of all CDF assets and related image/revision associated with this
-     * 360 image collection through CDF annotations
+     * Fetches annotations from all available sources
+     */
+    getAnnotationsInfo(source: 'all'): Promise<AssetAnnotationImage360Info<DataSourceType>[]>;
+    /**
+     * Fetches annotations from the CDF Annotation APIs, which are linked to CDF assets
+     */
+    getAnnotationsInfo(source: 'assets'): Promise<AssetAnnotationImage360Info<ClassicDataSourceType>[]>;
+    /**
+     * Fetches annotations from the CDF Core Data Model
+     */
+    getAnnotationsInfo(source: 'cdm'): Promise<AssetAnnotationImage360Info<DMDataSourceType>[]>;
+    /**
+     * Get info of assets and annotations associated with this
+     * 360 image collection through various sources
      *
-     * @param source What source data to pull the annotation info from
+     * @param source What source data to pull the annotation info from. Must be `'asset'`, `'cdm'` or `'all'`
      */
-    getAnnotationsInfo(source: 'assets'): Promise<AssetAnnotationImage360Info<T>[]>;
+    getAnnotationsInfo(source: 'assets' | 'cdm' | 'all'): Promise<AssetAnnotationImage360Info<ClassicDataSourceType>[] | AssetAnnotationImage360Info<DMDataSourceType> | AssetAnnotationImage360Info<DataSourceType>[]>;
 }

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

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

@@ -0,0 +1,5 @@
+/*!
+ * 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

@@ -5,6 +5,7 @@ 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';
 /**
  * Image360 icon style
  */
@@ -34,7 +35,7 @@ export interface Image360<T extends DataSourceType = ClassicDataSourceType> {
      * Get Id of 360 image entity.
      * @returns Station Id
      */
-    readonly id: string;
+    readonly id: Image360Id<T>;
     /**
      * Get label of 360 image entity.
      * @returns Station label

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

@@ -2,9 +2,9 @@
  * Copyright 2022 Cognite AS
  */
 import { DeviceDescriptor, SceneHandler } from '../../../utilities';
-import { DataSourceType, Image360DataProvider } from '../../../data-providers';
+import { DataSourceType, Image360Provider } from '../../../data-providers';
 import { Image360 } from './Image360';
-import { Historical360ImageSet } from '../../../data-providers/src/types';
+import { Historical360ImageSet, Image360RevisionId } from '../../../data-providers/src/types';
 import { Image360RevisionEntity } from './Image360RevisionEntity';
 import { Image360VisualizationBox } from './Image360VisualizationBox';
 import { ImageAnnotationObject } from '../annotation/ImageAnnotationObject';
@@ -41,13 +41,13 @@ export declare class Image360Entity<T extends DataSourceType> implements Image36
      * Get Id of 360 image entity.
      * @returns Station Id
      */
-    get id(): string;
+    get id(): Image360RevisionId<T>;
     /**
      * Get label of 360 image entity.
      * @returns Station label
      * */
     get label(): string | undefined;
-    constructor(image360Metadata: Historical360ImageSet, sceneHandler: SceneHandler, imageProvider: Image360DataProvider, 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);
     setWorldTransform(matrix: Matrix4): void;
     /**
      * List all historical images for this entity.

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

@@ -1,13 +1,14 @@
 /*!
  * Copyright 2022 Cognite AS
  */
-import { Image360DataProvider, Image360Descriptor, DataSourceType } from '../../../data-providers';
+import { Image360Descriptor, DataSourceType, Image360Provider } from '../../../data-providers';
 import { Image360Revision } from './Image360Revision';
 import { 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';
 export declare class Image360RevisionEntity<T extends DataSourceType> implements Image360Revision<T> {
     private readonly _imageProvider;
     private readonly _image360Descriptor;
@@ -16,10 +17,15 @@ export declare class Image360RevisionEntity<T extends DataSourceType> implements
     private _fullResolutionTextures;
     private _onFullResolutionCompleted;
     private _defaultAppearance;
+    private readonly _identifier;
     private _annotations;
     private _annotationsPromise;
     private readonly _annotationFilterer;
-    constructor(imageProvider: Image360DataProvider, image360Descriptor: Image360Descriptor, image360VisualizationBox: Image360VisualizationBox, annotationFilterer: Image360AnnotationFilter);
+    constructor(imageProvider: Image360Provider<T>, image360Descriptor: Image360Descriptor<T>, image360VisualizationBox: Image360VisualizationBox, annotationFilterer: Image360AnnotationFilter);
+    /**
+     * The identifier of this image 360 revision
+     */
+    get identifier(): Image360RevisionId<T>;
     /**
      * The date of this revision. Undefined if the revision is undated.
      * @returns Date | undefined
@@ -60,5 +66,5 @@ export declare class Image360RevisionEntity<T extends DataSourceType> implements
      * This has no effect if full resolution has already been applied.
      */
     applyFullResolutionTextures(): Promise<void>;
-    getDescriptors(): Image360Descriptor;
+    getDescriptors(): Image360Descriptor<T>;
 }

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

@@ -29,6 +29,7 @@ export declare class Image360VisualizationBox implements Image360Visualization {
     constructor(worldTransform: THREE.Matrix4, sceneHandler: SceneHandler, device: DeviceDescriptor);
     setWorldTransform(matrix: THREE.Matrix4): void;
     loadImages(textures: Image360Texture[]): void;
+    getTransform(): THREE.Matrix4;
     loadFaceTextures(faces: Image360Face[]): Promise<Image360Texture[]>;
     unloadImages(): void;
     private getScaledImageTexture;

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

@@ -4,13 +4,17 @@
 import { Vector3 } from 'three';
 import { Image360 } from './entity/Image360';
 import { Image360Revision } from './entity/Image360Revision';
-import { DataSourceType } from '../../data-providers';
+import { ClassicDataSourceType, DataSourceType } from '../../data-providers';
 import { Image360Entity } from './entity/Image360Entity';
 import { DefaultImage360Collection } from './collection/DefaultImage360Collection';
+/**
+ * The SourceType of a 360 image collection
+ */
+export type Image360CollectionSourceType = 'event' | 'dm' | 'cdm';
 /**
  * Delegate for 360 image mode entered events.
  */
-export type Image360EnteredDelegate = (image360: Image360, revision: Image360Revision) => void;
+export type Image360EnteredDelegate<T extends DataSourceType = ClassicDataSourceType> = (image360: Image360<T>, revision: Image360Revision<T>) => void;
 /**
  * Delegate for 360 image mode exited events.
  */