@ericchen1990/pano-view 3.5.0 → 3.6.0

package/dist/index.d.mts

@@ -2,6 +2,22 @@ import * as react from 'react';
 import { CSSProperties, ReactNode, ComponentPropsWithoutRef, IframeHTMLAttributes, RefObject } from 'react';
 import { Texture, ColorRepresentation, Vector3 } from 'three';
 
+/** Camera-center limits in degrees. A yaw min greater than max crosses ±180°. */
+type PanoViewLimits = {
+    yaw?: {
+        min: number;
+        max: number;
+    };
+    pitch?: {
+        min: number;
+        max: number;
+    };
+    fov?: {
+        min: number;
+        max: number;
+    };
+};
+
 declare const MAX_HOTSPOT_PITCH = 90;
 type HotspotPosition = {
     /** Horizontal panorama angle in degrees. Positive values look right. */
@@ -100,6 +116,8 @@ type HotspotCommonProps = {
     opacity?: number;
     renderOrder?: number;
     visible?: boolean;
+    /** Show a 3px selection border around a point hotspot. Defaults to false. */
+    selected?: boolean;
     /** Whether the hotspot accepts pointer and keyboard interaction. Defaults to true. */
     interactive?: boolean;
     /**
@@ -736,9 +754,40 @@ type PanoCursors = {
 };
 declare const DEFAULT_PANO_CURSORS: Required<PanoCursors>;
 
+type PanoOverlayRenderContext = {
+    /** Stable viewer-local portal target; null until the DOM has mounted. */
+    portalContainer: HTMLDivElement | null;
+    /** Available viewer space in CSS pixels, independent of nested portal targets. */
+    size: {
+        width: number;
+        height: number;
+    };
+    /** Screen-visible part of the viewer, in viewer-local CSS pixels. */
+    visibleRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    isFullscreen: boolean;
+};
+/** Read inside PanoViewer.renderOverlay or its DOM descendants. */
+declare function usePanoOverlay(): PanoOverlayRenderContext;
+/** Coordinate a custom modal with viewer inputs. Accessibility stays with the modal. */
+declare function usePanoModal(open: boolean): void;
+/** Keep nested portals inside the active dialog's interactive subtree. */
+declare function PanoOverlayPortalProvider({ container, children, }: {
+    container: HTMLDivElement | null;
+    children: ReactNode;
+}): react.JSX.Element;
+
 type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
+    /** Viewer-local DOM UI, rendered outside the Three.js tree, including in fullscreen. */
+    renderOverlay?: (context: PanoOverlayRenderContext) => ReactNode;
     initialView?: Partial<PanoViewerState>;
+    /** Camera-center limits; scene limits override individual axes. */
+    viewLimits?: PanoViewLimits;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
@@ -772,7 +821,11 @@ type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onCha
 };
 declare const PanoViewer: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
+    /** Viewer-local DOM UI, rendered outside the Three.js tree, including in fullscreen. */
+    renderOverlay?: (context: PanoOverlayRenderContext) => ReactNode;
     initialView?: Partial<PanoViewerState>;
+    /** Camera-center limits; scene limits override individual axes. */
+    viewLimits?: PanoViewLimits;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
@@ -991,18 +1044,21 @@ type SphereTileProps = {
     onLevelChange?: (level: number) => void;
 };
 
-type SphereScene = {
+type SceneViewOptions = {
+    viewLimits?: PanoViewLimits;
+};
+type SphereScene = SceneViewOptions & {
     id: string;
     type: "sphere";
     src: string;
     previewUrl: string;
     yawOffset?: number;
 };
-type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
+type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & SceneViewOptions & {
     id: string;
     type: "tile";
 };
-type SphereTileScene = Omit<SphereTileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
+type SphereTileScene = Omit<SphereTileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & SceneViewOptions & {
     id: string;
     type: "sphereTile";
 };
@@ -1081,6 +1137,37 @@ type LoadSceneFromJsonOptions = Omit<SceneFromViewerConfigOptions, "baseUrl"> &
 declare function sceneFromViewerConfig(value: unknown, options: SceneFromViewerConfigOptions): TileScene | SphereTileScene;
 declare function loadSceneFromJson(url: string, options: LoadSceneFromJsonOptions): Promise<TileScene | SphereTileScene>;
 
+type ProjectPopupBlock = {
+    id: string;
+} & ({
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    src: string;
+    alt?: string;
+} | {
+    type: "video";
+    src: string;
+    poster?: string;
+} | {
+    type: "audio";
+    src: string;
+});
+type ProjectPopupDefinition = {
+    id: string;
+    title: string;
+    blocks: ProjectPopupBlock[];
+};
+type PopupAssetUrlContext = {
+    defaultUrl: string;
+    popupId: string;
+    blockId: string;
+    field: "src" | "poster";
+};
+type PopupAssetUrlResolver = (path: string, context: PopupAssetUrlContext) => string;
+declare function resolveProjectPopupAssets(popup: ProjectPopupDefinition, baseUrl: string, resolver?: PopupAssetUrlResolver): ProjectPopupDefinition;
+
 type GraphicPaint = {
     fill?: string;
     stroke?: string;
@@ -1245,6 +1332,7 @@ type VideoHotspotDefinition = PointHotspotDefinitionBase & {
 type AudioHotspotDefinition = PointHotspotDefinitionBase & {
     type: "audio";
     src: string | string[];
+    format?: string | string[];
     playing?: boolean;
     loop?: boolean;
     muted?: boolean;
@@ -1296,12 +1384,36 @@ type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
+type JsonValue = null | boolean | number | string | JsonValue[] | JsonObject;
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+declare const projectHotspotTriggers: readonly ["click", "pointerenter", "pointerleave"];
+type ProjectHotspotTrigger = typeof projectHotspotTriggers[number];
+type ProjectCustomHotspotAction = {
+    type: "custom";
+    actionId: string;
+    params?: JsonObject;
+};
+declare function hotspotAction(hotspot: ProjectHotspotDefinition, trigger: ProjectHotspotTrigger): ProjectHotspotAction | undefined;
+declare function setHotspotAction(hotspot: ProjectHotspotDefinition, trigger: ProjectHotspotTrigger, action?: ProjectHotspotAction): ProjectHotspotDefinition;
+type ProjectHotspotAction = ProjectCustomHotspotAction | {
+    type: "scene";
+    sceneId: string;
+} | {
+    type: "view";
+    view: PanoViewerState;
+    duration?: number;
+} | {
+    type: "popup";
+    popupId: string;
+};
 type ProjectHotspotDefinition = HotspotDefinition & {
-    action?: {
-        type: "scene";
-        sceneId: string;
-    };
+    /** Legacy click fallback. events.click takes precedence. */
+    action?: ProjectHotspotAction;
+    events?: Partial<Record<ProjectHotspotTrigger, ProjectHotspotAction>>;
 };
+declare function resolveHotspotAssets(hotspot: ProjectHotspotDefinition, baseUrl: string, sceneId: string, resolver?: AssetUrlResolver): ProjectHotspotDefinition;
 
 type PanoProjectSceneDefinition = {
     id: string;
@@ -1316,6 +1428,7 @@ type PanoProjectSceneDefinition = {
         baseUrl?: string;
     };
     initialView?: Partial<PanoViewerState>;
+    viewLimits?: PanoViewLimits;
     hotspots?: ProjectHotspotDefinition[];
 };
 type PanoProjectDefinition = {
@@ -1323,6 +1436,7 @@ type PanoProjectDefinition = {
     title?: string;
     initialSceneId?: string;
     scenes: PanoProjectSceneDefinition[];
+    popups?: ProjectPopupDefinition[];
 };
 type LoadedProjectScene = {
     scene: TileScene | SphereTileScene;
@@ -1334,13 +1448,18 @@ type LoadedPanoProject = {
     title?: string;
     initialSceneId: string;
     scenes: LoadedProjectScene[];
+    popups?: ProjectPopupDefinition[];
 };
 type LoadPanoProjectOptions = JsonRequestOptions & {
     /** Directory used for project-relative references. Required for object input. */
     baseUrl?: string;
     resolveAssetUrl?: AssetUrlResolver;
+    resolvePopupAssetUrl?: PopupAssetUrlResolver;
 };
-declare function parsePanoProject(value: unknown): PanoProjectDefinition;
+/** Drafts permit empty scenes and unfinished popup titles/media; loading and export always validate strictly. */
+declare function parsePanoProject(value: unknown, options?: {
+    draft?: boolean;
+}): PanoProjectDefinition;
 declare function loadPanoProject(source: string | PanoProjectDefinition, options?: LoadPanoProjectOptions): Promise<LoadedPanoProject>;
 
 type ProjectHotspotClickEvent = {
@@ -1350,27 +1469,43 @@ type ProjectHotspotClickEvent = {
     defaultPrevented: boolean;
     preventDefault: () => void;
 };
+type ProjectHotspotEvent = ProjectHotspotClickEvent & {
+    trigger: ProjectHotspotTrigger;
+};
+type ProjectCustomActionEvent = ProjectHotspotEvent & {
+    action: ProjectCustomHotspotAction;
+};
+type ProjectPopupRequestEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    popup: ProjectPopupDefinition;
+};
 type ProjectHotspotErrorEvent = {
     sceneId: string;
     hotspot: ProjectHotspotDefinition;
     error: unknown;
+    trigger?: ProjectHotspotTrigger;
 };
 type ProjectHotspotRenderContext = {
     sceneId: string;
     playing: boolean;
     onClick: (event: HotspotInteractionEvent) => void;
+    onHoverChange: (hovered: boolean, event: HotspotInteractionEvent) => void;
     togglePlayback: () => void;
     reportError: (error: unknown) => void;
     renderDefault: () => ReactNode;
 };
 type ProjectScenesProps = Omit<ScenesProps, "scenes" | "defaultActiveSceneId" | "renderHotspots"> & {
     project: LoadedPanoProject;
+    onHotspotEvent?: (event: ProjectHotspotEvent) => void;
+    onCustomAction?: (event: ProjectCustomActionEvent) => void | Promise<void>;
     onHotspotClick?: (event: ProjectHotspotClickEvent) => void;
+    onPopupRequest?: (event: ProjectPopupRequestEvent) => void;
     onHotspotError?: (event: ProjectHotspotErrorEvent) => void;
     /** Return undefined for the default renderer, or null to hide this hotspot. */
     renderHotspot?: (hotspot: ProjectHotspotDefinition, context: ProjectHotspotRenderContext) => ReactNode;
 };
-declare function ProjectScenes({ project, activeSceneId, onActiveSceneIdChange, onSceneReady, onHotspotClick, onHotspotError, renderHotspot, ...options }: ProjectScenesProps): react.JSX.Element;
+declare function ProjectScenes({ project, activeSceneId, onActiveSceneIdChange, onSceneReady, onHotspotClick, onHotspotEvent, onHotspotError, onPopupRequest, onCustomAction, renderHotspot, ...options }: ProjectScenesProps): react.JSX.Element;
 
 /** Options for automatic horizontal panorama rotation. */
 type AutoRotateProps = {
@@ -1399,6 +1534,8 @@ type AudioHotspotErrorEvent = {
 };
 type AudioHotspotProps = HotspotCommonProps & {
     src: string | string[];
+    /** Container hints for extensionless sources such as blob URLs, in source order. */
+    format?: string | string[];
     playing: boolean;
     loop?: boolean;
     muted?: boolean;
@@ -1418,7 +1555,7 @@ type AudioHotspotProps = HotspotCommonProps & {
     onEnded?: () => void;
     onError?: (event: AudioHotspotErrorEvent) => void;
 };
-declare function AudioHotspot({ id, src, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
+declare function AudioHotspot({ id, src, format, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
 
 type BackgroundAudioSource = string | readonly string[];
 type BackgroundAudioErrorEvent = {
@@ -1900,4 +2037,4 @@ declare function vector3ToPanoPosition(vector: Pick<Vector3, "x" | "y" | "z">):
 declare const DEFAULT_HOTSPOT_TOOLTIP_OFFSET = 12;
 declare const DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE: Required<HotspotTooltipAppearance>;
 
-export { type ArrowGraphic, type AssetUrlContext, type AssetUrlResolver, 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, type CubemapViewerConfig, 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 JsonRequestOptions, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, 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, PanoDataError, type PanoDataErrorCode, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoProjectDefinition, type PanoProjectSceneDefinition, 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 ProjectHotspotClickEvent, type ProjectHotspotDefinition, type ProjectHotspotErrorEvent, type ProjectHotspotRenderContext, ProjectScenes, type ProjectScenesProps, type RectangleGraphic, type RingGraphic, type Scene, type SceneFromViewerConfigOptions, 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, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type SphereViewerConfig, 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, type ViewerConfig, type ViewerDocument, 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, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parsePanoProject, resolvePanoContextMenuEntries, sceneFromViewerConfig, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+export { type ArrowGraphic, type AssetUrlContext, type AssetUrlResolver, 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, type CubemapViewerConfig, 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 JsonObject, type JsonRequestOptions, type JsonValue, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, 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, PanoDataError, type PanoDataErrorCode, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, PanoOverlayPortalProvider, type PanoOverlayRenderContext, type PanoProjectDefinition, type PanoProjectSceneDefinition, 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 PanoViewLimits, 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 PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomActionEvent, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotClickEvent, type ProjectHotspotDefinition, type ProjectHotspotErrorEvent, type ProjectHotspotEvent, type ProjectHotspotRenderContext, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type ProjectPopupRequestEvent, ProjectScenes, type ProjectScenesProps, type RectangleGraphic, type RingGraphic, type Scene, type SceneFromViewerConfigOptions, 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, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type SphereViewerConfig, 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, type ViewerConfig, type ViewerDocument, 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, hotspotAction, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parsePanoProject, projectHotspotTriggers, resolvePanoContextMenuEntries, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction, unwrapPolygonVertices, usePanoEvents, usePanoModal, usePanoOverlay, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };

package/dist/index.d.ts

@@ -2,6 +2,22 @@ import * as react from 'react';
 import { CSSProperties, ReactNode, ComponentPropsWithoutRef, IframeHTMLAttributes, RefObject } from 'react';
 import { Texture, ColorRepresentation, Vector3 } from 'three';
 
+/** Camera-center limits in degrees. A yaw min greater than max crosses ±180°. */
+type PanoViewLimits = {
+    yaw?: {
+        min: number;
+        max: number;
+    };
+    pitch?: {
+        min: number;
+        max: number;
+    };
+    fov?: {
+        min: number;
+        max: number;
+    };
+};
+
 declare const MAX_HOTSPOT_PITCH = 90;
 type HotspotPosition = {
     /** Horizontal panorama angle in degrees. Positive values look right. */
@@ -100,6 +116,8 @@ type HotspotCommonProps = {
     opacity?: number;
     renderOrder?: number;
     visible?: boolean;
+    /** Show a 3px selection border around a point hotspot. Defaults to false. */
+    selected?: boolean;
     /** Whether the hotspot accepts pointer and keyboard interaction. Defaults to true. */
     interactive?: boolean;
     /**
@@ -736,9 +754,40 @@ type PanoCursors = {
 };
 declare const DEFAULT_PANO_CURSORS: Required<PanoCursors>;
 
+type PanoOverlayRenderContext = {
+    /** Stable viewer-local portal target; null until the DOM has mounted. */
+    portalContainer: HTMLDivElement | null;
+    /** Available viewer space in CSS pixels, independent of nested portal targets. */
+    size: {
+        width: number;
+        height: number;
+    };
+    /** Screen-visible part of the viewer, in viewer-local CSS pixels. */
+    visibleRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    isFullscreen: boolean;
+};
+/** Read inside PanoViewer.renderOverlay or its DOM descendants. */
+declare function usePanoOverlay(): PanoOverlayRenderContext;
+/** Coordinate a custom modal with viewer inputs. Accessibility stays with the modal. */
+declare function usePanoModal(open: boolean): void;
+/** Keep nested portals inside the active dialog's interactive subtree. */
+declare function PanoOverlayPortalProvider({ container, children, }: {
+    container: HTMLDivElement | null;
+    children: ReactNode;
+}): react.JSX.Element;
+
 type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
+    /** Viewer-local DOM UI, rendered outside the Three.js tree, including in fullscreen. */
+    renderOverlay?: (context: PanoOverlayRenderContext) => ReactNode;
     initialView?: Partial<PanoViewerState>;
+    /** Camera-center limits; scene limits override individual axes. */
+    viewLimits?: PanoViewLimits;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
@@ -772,7 +821,11 @@ type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onCha
 };
 declare const PanoViewer: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
+    /** Viewer-local DOM UI, rendered outside the Three.js tree, including in fullscreen. */
+    renderOverlay?: (context: PanoOverlayRenderContext) => ReactNode;
     initialView?: Partial<PanoViewerState>;
+    /** Camera-center limits; scene limits override individual axes. */
+    viewLimits?: PanoViewLimits;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
@@ -991,18 +1044,21 @@ type SphereTileProps = {
     onLevelChange?: (level: number) => void;
 };
 
-type SphereScene = {
+type SceneViewOptions = {
+    viewLimits?: PanoViewLimits;
+};
+type SphereScene = SceneViewOptions & {
     id: string;
     type: "sphere";
     src: string;
     previewUrl: string;
     yawOffset?: number;
 };
-type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
+type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & SceneViewOptions & {
     id: string;
     type: "tile";
 };
-type SphereTileScene = Omit<SphereTileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
+type SphereTileScene = Omit<SphereTileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & SceneViewOptions & {
     id: string;
     type: "sphereTile";
 };
@@ -1081,6 +1137,37 @@ type LoadSceneFromJsonOptions = Omit<SceneFromViewerConfigOptions, "baseUrl"> &
 declare function sceneFromViewerConfig(value: unknown, options: SceneFromViewerConfigOptions): TileScene | SphereTileScene;
 declare function loadSceneFromJson(url: string, options: LoadSceneFromJsonOptions): Promise<TileScene | SphereTileScene>;
 
+type ProjectPopupBlock = {
+    id: string;
+} & ({
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    src: string;
+    alt?: string;
+} | {
+    type: "video";
+    src: string;
+    poster?: string;
+} | {
+    type: "audio";
+    src: string;
+});
+type ProjectPopupDefinition = {
+    id: string;
+    title: string;
+    blocks: ProjectPopupBlock[];
+};
+type PopupAssetUrlContext = {
+    defaultUrl: string;
+    popupId: string;
+    blockId: string;
+    field: "src" | "poster";
+};
+type PopupAssetUrlResolver = (path: string, context: PopupAssetUrlContext) => string;
+declare function resolveProjectPopupAssets(popup: ProjectPopupDefinition, baseUrl: string, resolver?: PopupAssetUrlResolver): ProjectPopupDefinition;
+
 type GraphicPaint = {
     fill?: string;
     stroke?: string;
@@ -1245,6 +1332,7 @@ type VideoHotspotDefinition = PointHotspotDefinitionBase & {
 type AudioHotspotDefinition = PointHotspotDefinitionBase & {
     type: "audio";
     src: string | string[];
+    format?: string | string[];
     playing?: boolean;
     loop?: boolean;
     muted?: boolean;
@@ -1296,12 +1384,36 @@ type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
+type JsonValue = null | boolean | number | string | JsonValue[] | JsonObject;
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+declare const projectHotspotTriggers: readonly ["click", "pointerenter", "pointerleave"];
+type ProjectHotspotTrigger = typeof projectHotspotTriggers[number];
+type ProjectCustomHotspotAction = {
+    type: "custom";
+    actionId: string;
+    params?: JsonObject;
+};
+declare function hotspotAction(hotspot: ProjectHotspotDefinition, trigger: ProjectHotspotTrigger): ProjectHotspotAction | undefined;
+declare function setHotspotAction(hotspot: ProjectHotspotDefinition, trigger: ProjectHotspotTrigger, action?: ProjectHotspotAction): ProjectHotspotDefinition;
+type ProjectHotspotAction = ProjectCustomHotspotAction | {
+    type: "scene";
+    sceneId: string;
+} | {
+    type: "view";
+    view: PanoViewerState;
+    duration?: number;
+} | {
+    type: "popup";
+    popupId: string;
+};
 type ProjectHotspotDefinition = HotspotDefinition & {
-    action?: {
-        type: "scene";
-        sceneId: string;
-    };
+    /** Legacy click fallback. events.click takes precedence. */
+    action?: ProjectHotspotAction;
+    events?: Partial<Record<ProjectHotspotTrigger, ProjectHotspotAction>>;
 };
+declare function resolveHotspotAssets(hotspot: ProjectHotspotDefinition, baseUrl: string, sceneId: string, resolver?: AssetUrlResolver): ProjectHotspotDefinition;
 
 type PanoProjectSceneDefinition = {
     id: string;
@@ -1316,6 +1428,7 @@ type PanoProjectSceneDefinition = {
         baseUrl?: string;
     };
     initialView?: Partial<PanoViewerState>;
+    viewLimits?: PanoViewLimits;
     hotspots?: ProjectHotspotDefinition[];
 };
 type PanoProjectDefinition = {
@@ -1323,6 +1436,7 @@ type PanoProjectDefinition = {
     title?: string;
     initialSceneId?: string;
     scenes: PanoProjectSceneDefinition[];
+    popups?: ProjectPopupDefinition[];
 };
 type LoadedProjectScene = {
     scene: TileScene | SphereTileScene;
@@ -1334,13 +1448,18 @@ type LoadedPanoProject = {
     title?: string;
     initialSceneId: string;
     scenes: LoadedProjectScene[];
+    popups?: ProjectPopupDefinition[];
 };
 type LoadPanoProjectOptions = JsonRequestOptions & {
     /** Directory used for project-relative references. Required for object input. */
     baseUrl?: string;
     resolveAssetUrl?: AssetUrlResolver;
+    resolvePopupAssetUrl?: PopupAssetUrlResolver;
 };
-declare function parsePanoProject(value: unknown): PanoProjectDefinition;
+/** Drafts permit empty scenes and unfinished popup titles/media; loading and export always validate strictly. */
+declare function parsePanoProject(value: unknown, options?: {
+    draft?: boolean;
+}): PanoProjectDefinition;
 declare function loadPanoProject(source: string | PanoProjectDefinition, options?: LoadPanoProjectOptions): Promise<LoadedPanoProject>;
 
 type ProjectHotspotClickEvent = {
@@ -1350,27 +1469,43 @@ type ProjectHotspotClickEvent = {
     defaultPrevented: boolean;
     preventDefault: () => void;
 };
+type ProjectHotspotEvent = ProjectHotspotClickEvent & {
+    trigger: ProjectHotspotTrigger;
+};
+type ProjectCustomActionEvent = ProjectHotspotEvent & {
+    action: ProjectCustomHotspotAction;
+};
+type ProjectPopupRequestEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    popup: ProjectPopupDefinition;
+};
 type ProjectHotspotErrorEvent = {
     sceneId: string;
     hotspot: ProjectHotspotDefinition;
     error: unknown;
+    trigger?: ProjectHotspotTrigger;
 };
 type ProjectHotspotRenderContext = {
     sceneId: string;
     playing: boolean;
     onClick: (event: HotspotInteractionEvent) => void;
+    onHoverChange: (hovered: boolean, event: HotspotInteractionEvent) => void;
     togglePlayback: () => void;
     reportError: (error: unknown) => void;
     renderDefault: () => ReactNode;
 };
 type ProjectScenesProps = Omit<ScenesProps, "scenes" | "defaultActiveSceneId" | "renderHotspots"> & {
     project: LoadedPanoProject;
+    onHotspotEvent?: (event: ProjectHotspotEvent) => void;
+    onCustomAction?: (event: ProjectCustomActionEvent) => void | Promise<void>;
     onHotspotClick?: (event: ProjectHotspotClickEvent) => void;
+    onPopupRequest?: (event: ProjectPopupRequestEvent) => void;
     onHotspotError?: (event: ProjectHotspotErrorEvent) => void;
     /** Return undefined for the default renderer, or null to hide this hotspot. */
     renderHotspot?: (hotspot: ProjectHotspotDefinition, context: ProjectHotspotRenderContext) => ReactNode;
 };
-declare function ProjectScenes({ project, activeSceneId, onActiveSceneIdChange, onSceneReady, onHotspotClick, onHotspotError, renderHotspot, ...options }: ProjectScenesProps): react.JSX.Element;
+declare function ProjectScenes({ project, activeSceneId, onActiveSceneIdChange, onSceneReady, onHotspotClick, onHotspotEvent, onHotspotError, onPopupRequest, onCustomAction, renderHotspot, ...options }: ProjectScenesProps): react.JSX.Element;
 
 /** Options for automatic horizontal panorama rotation. */
 type AutoRotateProps = {
@@ -1399,6 +1534,8 @@ type AudioHotspotErrorEvent = {
 };
 type AudioHotspotProps = HotspotCommonProps & {
     src: string | string[];
+    /** Container hints for extensionless sources such as blob URLs, in source order. */
+    format?: string | string[];
     playing: boolean;
     loop?: boolean;
     muted?: boolean;
@@ -1418,7 +1555,7 @@ type AudioHotspotProps = HotspotCommonProps & {
     onEnded?: () => void;
     onError?: (event: AudioHotspotErrorEvent) => void;
 };
-declare function AudioHotspot({ id, src, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
+declare function AudioHotspot({ id, src, format, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
 
 type BackgroundAudioSource = string | readonly string[];
 type BackgroundAudioErrorEvent = {
@@ -1900,4 +2037,4 @@ declare function vector3ToPanoPosition(vector: Pick<Vector3, "x" | "y" | "z">):
 declare const DEFAULT_HOTSPOT_TOOLTIP_OFFSET = 12;
 declare const DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE: Required<HotspotTooltipAppearance>;
 
-export { type ArrowGraphic, type AssetUrlContext, type AssetUrlResolver, 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, type CubemapViewerConfig, 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 JsonRequestOptions, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, 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, PanoDataError, type PanoDataErrorCode, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoProjectDefinition, type PanoProjectSceneDefinition, 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 ProjectHotspotClickEvent, type ProjectHotspotDefinition, type ProjectHotspotErrorEvent, type ProjectHotspotRenderContext, ProjectScenes, type ProjectScenesProps, type RectangleGraphic, type RingGraphic, type Scene, type SceneFromViewerConfigOptions, 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, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type SphereViewerConfig, 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, type ViewerConfig, type ViewerDocument, 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, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parsePanoProject, resolvePanoContextMenuEntries, sceneFromViewerConfig, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+export { type ArrowGraphic, type AssetUrlContext, type AssetUrlResolver, 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, type CubemapViewerConfig, 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 JsonObject, type JsonRequestOptions, type JsonValue, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, 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, PanoDataError, type PanoDataErrorCode, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, PanoOverlayPortalProvider, type PanoOverlayRenderContext, type PanoProjectDefinition, type PanoProjectSceneDefinition, 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 PanoViewLimits, 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 PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomActionEvent, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotClickEvent, type ProjectHotspotDefinition, type ProjectHotspotErrorEvent, type ProjectHotspotEvent, type ProjectHotspotRenderContext, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type ProjectPopupRequestEvent, ProjectScenes, type ProjectScenesProps, type RectangleGraphic, type RingGraphic, type Scene, type SceneFromViewerConfigOptions, 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, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type SphereViewerConfig, 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, type ViewerConfig, type ViewerDocument, 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, hotspotAction, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parsePanoProject, projectHotspotTriggers, resolvePanoContextMenuEntries, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction, unwrapPolygonVertices, usePanoEvents, usePanoModal, usePanoOverlay, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };