feat: add type guard for DefaultCameraManager and bump to 4.16.0

documentation/docs/examples/controlsmodes.mdx

@@ -31,10 +31,14 @@ Default value is `false`.
 Example of setting different camera controls options:
 
 ```jsx runnable
+// import { isDefaultCameraManager } from '@cognite/reveal';
+
 const newControlsOptions = {
   mouseWheelAction: 'zoomToCursor',
   changeCameraTargetOnClick: true,
 };
 
-viewer.cameraManager.setCameraControlsOptions(newControlsOptions);
+if (isDefaultCameraManager(viewer.cameraManager)) {
+  viewer.cameraManager.setCameraControlsOptions(newControlsOptions);
+}
 ```

viewer/api-entry-points/core.ts

@@ -13,6 +13,7 @@ export {
   CameraControlsOptions,
   DebouncedCameraStopEventTrigger,
   DefaultCameraManager,
+  isDefaultCameraManager,
   CameraManagerEventType,
   CameraManagerHelper,
   CameraManager,

viewer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/reveal",
-  "version": "4.15.2",
+  "version": "4.16.0",
   "description": "WebGL based 3D viewer for CAD and point clouds processed in Cognite Data Fusion.",
   "homepage": "https://github.com/cognitedata/reveal/tree/master/viewer",
   "repository": {

viewer/packages/camera-manager/index.ts

@@ -1,7 +1,7 @@
 /*!
  * Copyright 2021 Cognite AS
  */
-export { DefaultCameraManager } from './src/DefaultCameraManager';
+export { DefaultCameraManager, isDefaultCameraManager } from './src/DefaultCameraManager';
 export { ProxyCameraManager } from './src/ProxyCameraManager';
 export { StationaryCameraManager } from './src/StationaryCameraManager';
 export { CameraManagerHelper } from './src/CameraManagerHelper';

viewer/packages/camera-manager/src/DefaultCameraManager.ts

@@ -668,3 +668,10 @@ export class DefaultCameraManager implements CameraManager {
     return clamp(duration, DefaultCameraManager.MinAnimationDuration, DefaultCameraManager.MaxAnimationDuration);
   }
 }
+
+/**
+ * type guard which determines if the provided camera manager is a @see { DefaultCameraManager }
+ */
+export function isDefaultCameraManager(cameraManager: CameraManager): cameraManager is DefaultCameraManager {
+  return cameraManager instanceof DefaultCameraManager;
+}

viewer/reveal.api.md

@@ -1332,6 +1332,9 @@ export class InvertedNodeCollection extends NodeCollection {
     serialize(): SerializedNodeCollection;
 }
 
+// @public
+export function isDefaultCameraManager(cameraManager: CameraManager): cameraManager is DefaultCameraManager;
+
 // @beta
 export function isFlexibleCameraManager(manager: CameraManager): manager is IFlexibleCameraManager;