@ericchen1990/pano-view 3.0.0 → 3.1.0

package/dist/index.d.mts

@@ -411,10 +411,37 @@ type SetPanoViewerOptions = {
     /** Apply the new view immediately instead of preserving current inertia. */
     immediate?: boolean;
 };
+/** Built-in interpolation curves for imperative panorama navigation. */
+type PanoViewEasing = "linear" | "easeInOutCubic";
+/** Common options for timed imperative panorama navigation. */
+type PanoViewNavigationOptions = {
+    /** Animation time in milliseconds. Defaults to 700. Pass 0 to apply immediately. */
+    duration?: number;
+    /** Interpolation curve. Defaults to "easeInOutCubic". */
+    easing?: PanoViewEasing;
+    /** Whether yaw crosses the ±180° seam through the shorter path. Defaults to true. */
+    shortestPath?: boolean;
+};
+/** Navigation options that may also change the field of view. */
+type PanoViewLookToOptions = PanoViewNavigationOptions & {
+    /** Target vertical field of view in degrees. Omit to preserve the current FOV. */
+    fov?: number;
+};
+type PanoViewNavigationResult = {
+    status: "completed" | "cancelled" | "not-found";
+};
 type PanoViewerHandle = {
     getView: () => PanoViewerState;
     setView: (view: Partial<PanoViewerState>, options?: SetPanoViewerOptions) => void;
     reset: () => void;
+    /** Animate to a yaw/pitch position, optionally changing FOV. */
+    lookTo: (position: HotspotPosition, options?: PanoViewLookToOptions) => Promise<PanoViewNavigationResult>;
+    /** Animate yaw and pitch while preserving the current FOV. */
+    moveTo: (position: HotspotPosition, options?: PanoViewNavigationOptions) => Promise<PanoViewNavigationResult>;
+    /** Animate FOV while preserving the current yaw and pitch. */
+    zoomTo: (fov: number, options?: Omit<PanoViewNavigationOptions, "shortestPath">) => Promise<PanoViewNavigationResult>;
+    /** Animate to the representative position of a mounted hotspot. */
+    lookToHotspot: (id: string, options?: PanoViewLookToOptions) => Promise<PanoViewNavigationResult>;
     /** Runs the same first-interaction media activation used by PanoViewer. */
     activateMedia: () => Promise<void>;
     enterFullscreen: () => Promise<void>;
@@ -1614,4 +1641,4 @@ type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
-export { type ArrowGraphic, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type Scene, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+export { type ArrowGraphic, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, type PanoViewEasing, type PanoViewLookToOptions, type PanoViewNavigationOptions, type PanoViewNavigationResult, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type Scene, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };

package/dist/index.d.ts

@@ -411,10 +411,37 @@ type SetPanoViewerOptions = {
     /** Apply the new view immediately instead of preserving current inertia. */
     immediate?: boolean;
 };
+/** Built-in interpolation curves for imperative panorama navigation. */
+type PanoViewEasing = "linear" | "easeInOutCubic";
+/** Common options for timed imperative panorama navigation. */
+type PanoViewNavigationOptions = {
+    /** Animation time in milliseconds. Defaults to 700. Pass 0 to apply immediately. */
+    duration?: number;
+    /** Interpolation curve. Defaults to "easeInOutCubic". */
+    easing?: PanoViewEasing;
+    /** Whether yaw crosses the ±180° seam through the shorter path. Defaults to true. */
+    shortestPath?: boolean;
+};
+/** Navigation options that may also change the field of view. */
+type PanoViewLookToOptions = PanoViewNavigationOptions & {
+    /** Target vertical field of view in degrees. Omit to preserve the current FOV. */
+    fov?: number;
+};
+type PanoViewNavigationResult = {
+    status: "completed" | "cancelled" | "not-found";
+};
 type PanoViewerHandle = {
     getView: () => PanoViewerState;
     setView: (view: Partial<PanoViewerState>, options?: SetPanoViewerOptions) => void;
     reset: () => void;
+    /** Animate to a yaw/pitch position, optionally changing FOV. */
+    lookTo: (position: HotspotPosition, options?: PanoViewLookToOptions) => Promise<PanoViewNavigationResult>;
+    /** Animate yaw and pitch while preserving the current FOV. */
+    moveTo: (position: HotspotPosition, options?: PanoViewNavigationOptions) => Promise<PanoViewNavigationResult>;
+    /** Animate FOV while preserving the current yaw and pitch. */
+    zoomTo: (fov: number, options?: Omit<PanoViewNavigationOptions, "shortestPath">) => Promise<PanoViewNavigationResult>;
+    /** Animate to the representative position of a mounted hotspot. */
+    lookToHotspot: (id: string, options?: PanoViewLookToOptions) => Promise<PanoViewNavigationResult>;
     /** Runs the same first-interaction media activation used by PanoViewer. */
     activateMedia: () => Promise<void>;
     enterFullscreen: () => Promise<void>;
@@ -1614,4 +1641,4 @@ type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
-export { type ArrowGraphic, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type Scene, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+export { type ArrowGraphic, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, type PanoViewEasing, type PanoViewLookToOptions, type PanoViewNavigationOptions, type PanoViewNavigationResult, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type Scene, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };

package/dist/index.mjs

@@ -2452,6 +2452,7 @@ var DEFAULT_ROTATE_DAMPING = 14;
 var DEFAULT_ZOOM_DAMPING = 16;
 var DEFAULT_FRICTION_STOP = 0.01;
 var VIEW_SETTLE_EPSILON = 1e-3;
+var DEFAULT_NAVIGATION_DURATION = 700;
 var PanoramaViewContext = createContext3(null);
 function clamp(value, min, max) {
   return Math.max(min, Math.min(max, value));
@@ -2471,6 +2472,15 @@ function resolveDamping(value, fallback) {
 function resolveFrictionStop(value) {
   return Number.isFinite(value) && value >= 0 ? value : DEFAULT_FRICTION_STOP;
 }
+function resolveNavigationDuration(value) {
+  return Number.isFinite(value) && value >= 0 ? value : DEFAULT_NAVIGATION_DURATION;
+}
+function applyNavigationEasing(progress, easing) {
+  if (easing === "linear") {
+    return progress;
+  }
+  return progress < 0.5 ? 4 * progress * progress * progress : 1 - Math.pow(-2 * progress + 2, 3) / 2;
+}
 function viewsEqual(a, b) {
   return a.yaw === b.yaw && a.pitch === b.pitch && a.fov === b.fov;
 }
@@ -2504,13 +2514,14 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
   const xrEulerRef = useRef(new Euler(0, 0, 0, "YXZ"));
   const minFovRef = useRef(minFov);
   const maxFovRef = useRef(maxFov);
+  const activeNavigationRef = useRef(null);
   optionsRef.current = options;
   eventBusRef.current = eventBus;
   xrSessionRef.current = xrSession;
   minFovRef.current = minFov;
   maxFovRef.current = maxFov;
   const hasInertia = () => yawVelocityRef.current !== 0 || pitchVelocityRef.current !== 0 || zoomVelocityRef.current !== 0;
-  const isUserInteracting = () => mouseActiveRef.current || touchActiveRef.current || keyboardActiveRef.current || gyroActiveRef.current || interactionLockCountRef.current > 0 || xrSessionRef.current != null || hasInertia();
+  const isUserInteracting = () => mouseActiveRef.current || touchActiveRef.current || keyboardActiveRef.current || gyroActiveRef.current || interactionLockCountRef.current > 0 || xrSessionRef.current != null || activeNavigationRef.current != null || hasInertia();
   const syncInteracting = () => {
     interactingRef.current = mouseActiveRef.current || touchActiveRef.current;
   };
@@ -2552,6 +2563,14 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
     zoomVelocityRef.current = 0;
     lastVelocitySampleAtRef.current = null;
   };
+  const cancelNavigation = () => {
+    const navigation = activeNavigationRef.current;
+    if (!navigation) {
+      return;
+    }
+    activeNavigationRef.current = null;
+    navigation.resolve({ status: "cancelled" });
+  };
   const markDirty = () => {
     dirtyRef.current = true;
     settledRef.current = false;
@@ -2564,6 +2583,7 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
     }
   };
   const acquireInteractionLock = () => {
+    cancelNavigation();
     interactionLockCountRef.current += 1;
     stopVelocity();
     if (mouseActiveRef.current) {
@@ -2588,6 +2608,7 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
     };
   };
   const setView = (view, setOptions) => {
+    cancelNavigation();
     const nextView = hardConstrainView(view);
     if (gyroActiveRef.current) {
       gyroOffsetRef.current = {
@@ -2602,7 +2623,66 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
     }
     markDirty();
   };
+  const startNavigation = (targetInput, options2) => {
+    cancelNavigation();
+    if (xrSessionRef.current != null || gyroActiveRef.current || interactionLockCountRef.current > 0) {
+      return Promise.resolve({ status: "cancelled" });
+    }
+    const from = { ...viewRef.current };
+    const safeTargetInput = {
+      yaw: targetInput.yaw !== void 0 && Number.isFinite(targetInput.yaw) ? targetInput.yaw : from.yaw,
+      pitch: targetInput.pitch !== void 0 && Number.isFinite(targetInput.pitch) ? targetInput.pitch : from.pitch,
+      fov: targetInput.fov !== void 0 && Number.isFinite(targetInput.fov) ? targetInput.fov : from.fov
+    };
+    const target = hardConstrainView(safeTargetInput, from);
+    const duration = resolveNavigationDuration(options2?.duration);
+    const rawYawDelta = targetInput.yaw !== void 0 && Number.isFinite(targetInput.yaw) ? safeTargetInput.yaw - from.yaw : 0;
+    const yawDelta = options2?.shortestPath === false ? rawYawDelta : shortestYawDelta(from.yaw, target.yaw);
+    stopVelocity();
+    targetViewRef.current = target;
+    markDirty();
+    if (duration === 0) {
+      viewRef.current = target;
+      return Promise.resolve({ status: "completed" });
+    }
+    return new Promise((resolve) => {
+      activeNavigationRef.current = {
+        from,
+        target,
+        yawDelta,
+        startedAt: performance.now(),
+        duration,
+        easing: options2?.easing,
+        resolve
+      };
+    });
+  };
+  const lookTo = (position, options2) => startNavigation(
+    {
+      yaw: position.yaw,
+      pitch: position.pitch,
+      fov: options2?.fov ?? viewRef.current.fov
+    },
+    options2
+  );
+  const moveTo = (position, options2) => startNavigation(
+    {
+      yaw: position.yaw,
+      pitch: position.pitch,
+      fov: viewRef.current.fov
+    },
+    options2
+  );
+  const zoomTo = (fov, options2) => startNavigation(
+    {
+      yaw: viewRef.current.yaw,
+      pitch: viewRef.current.pitch,
+      fov
+    },
+    options2
+  );
   const applyViewDelta = (delta, applyOptions) => {
+    cancelNavigation();
     if (interactionLockCountRef.current > 0 || xrSessionRef.current != null) {
       return false;
     }
@@ -2653,10 +2733,16 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
       getTargetView: () => ({ ...targetViewRef.current }),
       setView,
       reset: () => setView(initialViewRef.current),
+      lookTo,
+      moveTo,
+      zoomTo,
       applyViewDelta,
       setKeyboardActive: (active) => {
         const wasActive = keyboardActiveRef.current;
         keyboardActiveRef.current = active;
+        if (active) {
+          cancelNavigation();
+        }
         if (active && !wasActive) {
           eventBusRef.current.emit("viewinteractionstart", {
             source: "keyboard"
@@ -2674,6 +2760,9 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
         } else {
           touchActiveRef.current = active;
         }
+        if (active) {
+          cancelNavigation();
+        }
         syncInteracting();
         if (active && !wasActive) {
           eventBusRef.current.emit("viewinteractionstart", { source });
@@ -2690,6 +2779,9 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
       isInteractionLocked: () => interactionLockCountRef.current > 0,
       isUserInteracting,
       setGyroActive: (active) => {
+        if (active) {
+          cancelNavigation();
+        }
         gyroActiveRef.current = active;
         gyroOffsetRef.current = { yaw: 0, pitch: 0 };
         stopVelocity();
@@ -2726,7 +2818,7 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
       acquireInteractionLock,
       applyAutoRotation: (yawDelta) => {
         const inertiaFinished = yawVelocityRef.current === 0 && pitchVelocityRef.current === 0 && zoomVelocityRef.current === 0;
-        if (!Number.isFinite(yawDelta) || xrSessionRef.current != null || gyroActiveRef.current || interactionLockCountRef.current > 0 || interactingRef.current || keyboardActiveRef.current || !inertiaFinished) {
+        if (!Number.isFinite(yawDelta) || xrSessionRef.current != null || activeNavigationRef.current != null || gyroActiveRef.current || interactionLockCountRef.current > 0 || interactingRef.current || keyboardActiveRef.current || !inertiaFinished) {
           return false;
         }
         targetViewRef.current.yaw += yawDelta;
@@ -2736,6 +2828,12 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
     }),
     []
   );
+  useEffect(
+    () => () => {
+      cancelNavigation();
+    },
+    []
+  );
   useEffect(() => {
     initialViewRef.current = { ...initialView };
     setView(initialView);
@@ -2745,6 +2843,7 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
       return;
     }
     if (xrSessionRef.current && gl.xr.isPresenting) {
+      cancelNavigation();
       const xrCamera = gl.xr.getCamera();
       xrEulerRef.current.setFromQuaternion(xrCamera.quaternion, "YXZ");
       const nextView2 = {
@@ -2765,6 +2864,48 @@ var PanoramaViewRuntime = forwardRef(function PanoramaViewRuntime2({ initialView
       }
       return;
     }
+    const navigation = activeNavigationRef.current;
+    if (navigation) {
+      const progress = Math.min(
+        1,
+        Math.max(0, (performance.now() - navigation.startedAt) / navigation.duration)
+      );
+      const easedProgress = applyNavigationEasing(progress, navigation.easing);
+      const nextView2 = {
+        yaw: normalizeYaw(navigation.from.yaw + navigation.yawDelta * easedProgress),
+        pitch: navigation.from.pitch + (navigation.target.pitch - navigation.from.pitch) * easedProgress,
+        fov: navigation.from.fov + (navigation.target.fov - navigation.from.fov) * easedProgress
+      };
+      const completed = progress === 1;
+      viewRef.current = completed ? { ...navigation.target } : nextView2;
+      eulerRef.current.set(
+        MathUtils.degToRad(viewRef.current.pitch),
+        MathUtils.degToRad(-viewRef.current.yaw),
+        MathUtils.degToRad(cameraRollRef.current),
+        "YXZ"
+      );
+      camera.quaternion.setFromEuler(eulerRef.current);
+      camera.fov = viewRef.current.fov;
+      camera.updateProjectionMatrix();
+      camera.updateMatrixWorld();
+      const emittedView = { ...viewRef.current };
+      const lastEmitted2 = lastEmittedViewRef.current;
+      if (!lastEmitted2 || !viewsEqual(lastEmitted2, emittedView)) {
+        lastEmittedViewRef.current = emittedView;
+        eventBusRef.current.emit("viewchange", emittedView);
+      }
+      if (completed) {
+        activeNavigationRef.current = null;
+        settledRef.current = true;
+        eventBusRef.current.emit("viewsettled", emittedView);
+        navigation.resolve({ status: "completed" });
+        dirtyRef.current = false;
+      } else {
+        settledRef.current = false;
+        dirtyRef.current = true;
+      }
+      return;
+    }
     const frictionStop = resolveFrictionStop(optionsRef.current.frictionStop);
     const inertiaEnabled = optionsRef.current.inertia !== false;
     if (!interactingRef.current && !gyroActiveRef.current && inertiaEnabled) {
@@ -3115,6 +3256,30 @@ function useHotspotAccessibilityLayer() {
   return { controls, registry };
 }
 
+// src/hotspot/target-registry.ts
+import { createContext as createContext6 } from "react";
+var HotspotTargetRegistryContext = createContext6(
+  null
+);
+function createHotspotTargetRegistry() {
+  const targets = /* @__PURE__ */ new Map();
+  return {
+    getPosition: (id) => {
+      const target = targets.get(id);
+      return target ? { ...target.position } : null;
+    },
+    register: (id, position) => {
+      const token = Symbol(id);
+      targets.set(id, { token, position: { ...position } });
+      return () => {
+        if (targets.get(id)?.token === token) {
+          targets.delete(id);
+        }
+      };
+    }
+  };
+}
+
 // src/keyboard-controls.tsx
 import { useFrame as useFrame3, useThree as useThree2 } from "@react-three/fiber";
 import { useContext as useContext4, useEffect as useEffect4, useMemo as useMemo2, useRef as useRef4 } from "react";
@@ -3532,7 +3697,7 @@ function MouseControls({
 }
 
 // src/pano-filter/host.ts
-import { createContext as createContext6, useContext as useContext6, useSyncExternalStore } from "react";
+import { createContext as createContext7, useContext as useContext6, useSyncExternalStore } from "react";
 
 // src/pano-filter/presets.ts
 var PANO_FILTER_PRESETS = [
@@ -3573,7 +3738,7 @@ function isPanoFilterActive(snapshot) {
 }
 
 // src/pano-filter/host.ts
-var PanoFilterHostContext = createContext6(null);
+var PanoFilterHostContext = createContext7(null);
 function createPanoFilterHost() {
   return {
     snapshot: { ...DEFAULT_PANO_FILTER_SNAPSHOT },
@@ -3642,9 +3807,9 @@ function isProduction2() {
 }
 
 // src/media-activation.tsx
-import { createContext as createContext7, useContext as useContext7, useEffect as useEffect6, useRef as useRef6 } from "react";
+import { createContext as createContext8, useContext as useContext7, useEffect as useEffect6, useRef as useRef6 } from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
-var PanoMediaActivationHostContext = createContext7(null);
+var PanoMediaActivationHostContext = createContext8(null);
 function createPanoMediaActivationHost() {
   return { intents: /* @__PURE__ */ new Set(), listeners: /* @__PURE__ */ new Set(), revision: 0 };
 }
@@ -3705,7 +3870,7 @@ function PanoMediaActivationOverlay({
 
 // src/pano-context-menu.tsx
 import {
-  createContext as createContext8,
+  createContext as createContext9,
   useCallback as useCallback2,
   useContext as useContext8,
   useEffect as useEffect7,
@@ -3719,7 +3884,7 @@ import { jsx as jsx3, jsxs } from "react/jsx-runtime";
 var DEFAULT_ICON_SIZE = 16;
 var MENU_EDGE_PADDING = 8;
 var MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY = 0.4;
-var PanoContextMenuOverlayContext = createContext8(null);
+var PanoContextMenuOverlayContext = createContext9(null);
 var DEFAULT_APPEARANCE = {
   background: "#161616",
   color: "#f4f4f4",
@@ -4397,12 +4562,12 @@ function composePanoContextMenuItems(props, presets) {
     ...resolvePanoContextMenuEntries(props.append ?? [], presets)
   ];
 }
-var PanoContextMenuActionsContext = createContext8(null);
+var PanoContextMenuActionsContext = createContext9(null);
 
 // src/pano-cursor.tsx
 import { useThree as useThree4 } from "@react-three/fiber";
 import {
-  createContext as createContext9,
+  createContext as createContext10,
   useCallback as useCallback3,
   useContext as useContext9,
   useEffect as useEffect8,
@@ -4423,7 +4588,7 @@ var LAYER_PRIORITY = {
   hotspotDragging: 3,
   hidden: 4
 };
-var PanoCursorContext = createContext9(null);
+var PanoCursorContext = createContext10(null);
 function usePanoCursor() {
   return useContext9(PanoCursorContext);
 }
@@ -4998,8 +5163,8 @@ function PanoramaEventSurface() {
 }
 
 // src/scenes-host.ts
-import { createContext as createContext10 } from "react";
-var ScenesHostContext = createContext10(null);
+import { createContext as createContext11 } from "react";
+var ScenesHostContext = createContext11(null);
 function createScenesHost() {
   return {
     controller: null,
@@ -5162,9 +5327,9 @@ function TouchControls({
 }
 
 // src/video/chrome-overlay.tsx
-import { createContext as createContext11, useCallback as useCallback4, useMemo as useMemo5, useState as useState3 } from "react";
+import { createContext as createContext12, useCallback as useCallback4, useMemo as useMemo5, useState as useState3 } from "react";
 import { jsx as jsx6 } from "react/jsx-runtime";
-var PanoChromeOverlayContext = createContext11(null);
+var PanoChromeOverlayContext = createContext12(null);
 function usePanoChromeOverlay() {
   const [overlayElement, setOverlayElement] = useState3(
     null
@@ -5188,9 +5353,9 @@ function usePanoChromeOverlay() {
 }
 
 // src/video/host.ts
-import { createContext as createContext12, useContext as useContext13 } from "react";
-var PanoVideoHostContext = createContext12(null);
-var DefaultPanoVideoControlsContext = createContext12(false);
+import { createContext as createContext13, useContext as useContext13 } from "react";
+var PanoVideoHostContext = createContext13(null);
+var DefaultPanoVideoControlsContext = createContext13(false);
 function createPanoVideoHost() {
   return {
     controller: null,
@@ -6461,8 +6626,8 @@ function PanoVideoChromeBridge({
 import { useSyncExternalStore as useSyncExternalStore5 } from "react";
 
 // src/webvr/host.ts
-import { createContext as createContext13 } from "react";
-var WebVRRuntimeContext = createContext13(null);
+import { createContext as createContext14 } from "react";
+var WebVRRuntimeContext = createContext14(null);
 function createWebVRHost() {
   return {
     controller: null,
@@ -6939,6 +7104,7 @@ var PanoViewer = forwardRef2(
     const controlsRef = useRef13(null);
     const eventBus = useMemo7(() => createPanoEventBus(), []);
     const { controls: hotspotAccessibilityControls, registry } = useHotspotAccessibilityLayer();
+    const hotspotTargetRegistry = useMemo7(() => createHotspotTargetRegistry(), []);
     const { api: contextMenuOverlayApi, overlay: contextMenuOverlay } = usePanoContextMenuOverlay();
     const { api: chromeOverlayApi, setOverlayNode, overlayElement } = usePanoChromeOverlay();
     const videoHost = useMemo7(() => createPanoVideoHost(), []);
@@ -7174,6 +7340,13 @@ var PanoViewer = forwardRef2(
         reset: () => {
           controlsRef.current?.reset();
         },
+        lookTo: (position, options) => controlsRef.current?.lookTo(position, options) ?? Promise.resolve({ status: "cancelled" }),
+        moveTo: (position, options) => controlsRef.current?.moveTo(position, options) ?? Promise.resolve({ status: "cancelled" }),
+        zoomTo: (fov, options) => controlsRef.current?.zoomTo(fov, options) ?? Promise.resolve({ status: "cancelled" }),
+        lookToHotspot: (id, options) => {
+          const position = hotspotTargetRegistry.getPosition(id);
+          return position ? controlsRef.current?.lookTo(position, options) ?? Promise.resolve({ status: "cancelled" }) : Promise.resolve({ status: "not-found" });
+        },
         activateMedia,
         // -- Fullscreen --
         enterFullscreen,
@@ -7231,6 +7404,7 @@ var PanoViewer = forwardRef2(
         enterFullscreen,
         exitFullscreen,
         scenesHost,
+        hotspotTargetRegistry,
         toggleFullscreen,
         videoHost,
         webVRHost
@@ -7282,7 +7456,7 @@ var PanoViewer = forwardRef2(
                   value: { host: webVRHost, xrStore, stereoView },
                   children: [
                     /* @__PURE__ */ jsx12(PanoramaXROrigin, {}),
-                    /* @__PURE__ */ jsx12(HotspotAccessibilityContext.Provider, { value: registry, children: /* @__PURE__ */ jsx12(PanoEventBusContext.Provider, { value: eventBus, children: /* @__PURE__ */ jsx12(PanoCursorTree, { cursors: resolvedCursors, children: /* @__PURE__ */ jsx12(PanoramaViewContext.Provider, { value: controlsRef, children: /* @__PURE__ */ jsx12(
+                    /* @__PURE__ */ jsx12(HotspotAccessibilityContext.Provider, { value: registry, children: /* @__PURE__ */ jsx12(HotspotTargetRegistryContext.Provider, { value: hotspotTargetRegistry, children: /* @__PURE__ */ jsx12(PanoEventBusContext.Provider, { value: eventBus, children: /* @__PURE__ */ jsx12(PanoCursorTree, { cursors: resolvedCursors, children: /* @__PURE__ */ jsx12(PanoramaViewContext.Provider, { value: controlsRef, children: /* @__PURE__ */ jsx12(
                       PanoContextMenuOverlayContext.Provider,
                       {
                         value: contextMenuOverlayApi,
@@ -7338,7 +7512,7 @@ var PanoViewer = forwardRef2(
                           }
                         ) }) }) })
                       }
-                    ) }) }) }) })
+                    ) }) }) }) }) })
                   ]
                 }
               ) })
@@ -9364,6 +9538,10 @@ function createPanoViewerHandle(ref) {
     reset: () => {
       ref.current?.reset();
     },
+    lookTo: (position, options) => ref.current?.lookTo(position, options) ?? Promise.resolve({ status: "cancelled" }),
+    moveTo: (position, options) => ref.current?.moveTo(position, options) ?? Promise.resolve({ status: "cancelled" }),
+    zoomTo: (fov, options) => ref.current?.zoomTo(fov, options) ?? Promise.resolve({ status: "cancelled" }),
+    lookToHotspot: (id, options) => ref.current?.lookToHotspot(id, options) ?? Promise.resolve({ status: "not-found" }),
     activateMedia: () => ref.current?.activateMedia() ?? Promise.resolve(),
     enterFullscreen: () => ref.current?.enterFullscreen() ?? Promise.resolve(),
     exitFullscreen: () => ref.current?.exitFullscreen() ?? Promise.resolve(),
@@ -11210,7 +11388,7 @@ function TransitionOverlay(props) {
 // src/tile/texture-manager-context.tsx
 import { useThree as useThree17 } from "@react-three/fiber";
 import {
-  createContext as createContext14,
+  createContext as createContext15,
   useContext as useContext22,
   useEffect as useEffect25,
   useMemo as useMemo18
@@ -11444,7 +11622,7 @@ var TileTextureManager = class {
 
 // src/tile/texture-manager-context.tsx
 import { jsx as jsx21 } from "react/jsx-runtime";
-var TileTextureManagerContext = createContext14(
+var TileTextureManagerContext = createContext15(
   null
 );
 function TileTextureManagerProvider({
@@ -13193,6 +13371,7 @@ function HotspotAnchor({
   onDragEnd
 }) {
   const controlsRef = useContext25(PanoramaViewContext);
+  const hotspotTargetRegistry = useContext25(HotspotTargetRegistryContext);
   const eventBus = useContext25(PanoEventBusContext);
   const cursorApi = usePanoCursor();
   const { camera, size } = useThree20();
@@ -13208,6 +13387,12 @@ function HotspotAnchor({
     [tooltip]
   );
   const normalizedPosition = normalizePanoPosition(position);
+  useEffect29(() => {
+    if (!hotspotTargetRegistry) {
+      return;
+    }
+    return hotspotTargetRegistry.register(id, normalizedPosition);
+  }, [hotspotTargetRegistry, id, normalizedPosition.pitch, normalizedPosition.yaw]);
   const rendering = internalOrientation && internalPlacement ? { orientation: internalOrientation, placement: internalPlacement } : HOTSPOT_MODE_RENDERING[mode];
   const { orientation: orientation2, placement } = rendering;
   const resolvedScale = resolveScale(scale);