@ericchen1990/pano-view 4.1.0 → 5.1.0

package/dist/index.d.mts

@@ -239,6 +239,149 @@ declare function cycleSceneId(scenes: readonly {
  */
 declare function KeyboardControls({ enabled, keys, rotateSpeed, zoomSpeed, shiftMultiplier, invert, fovSpeed, onPreviousScene, onNextScene, }: KeyboardControlsProps): null;
 
+type WebVRInteractionMode = "auto" | "gaze" | "pointer";
+type WebVRInputState = Readonly<{
+    mode: "gaze" | "pointer" | "paused" | null;
+    source: "head" | "controller" | "hand" | "system" | null;
+}>;
+type WebVRMode = "webxr" | "mobilevr" | "fake";
+type WebVRProfileId = "none" | "cardboard-v1" | "cardboard-v2" | "gear-vr" | "daydream";
+type WebVRProfile = {
+    id?: string;
+    label?: string;
+    /** Vertical field of view for each eye, in degrees. */
+    fov: number;
+    /** Distance between the eyes, in millimetres. */
+    ipdMm: number;
+    /** Distance from the display to the headset lens, in millimetres. */
+    screenToLensMm?: number;
+    /**
+     * Distance from the headset tray bottom to the lens center, in millimetres.
+     * `0` or omitted keeps the optical axis on the vertical screen center.
+     */
+    trayDistanceMm?: number;
+    /** Radial lens distortion coefficients. Zero disables distortion. */
+    k1: number;
+    k2: number;
+};
+/** Target WebXR session refresh rate. Omitting keeps the store default (`"high"`). */
+type WebVRFrameRate = "low" | "mid" | "high" | number;
+type WebVRChromeAppearance = {
+    background?: CSSProperties["background"];
+    color?: CSSProperties["color"];
+    accent?: CSSProperties["color"];
+    borderRadius?: CSSProperties["borderRadius"];
+    fontSize?: CSSProperties["fontSize"];
+    setupTitle?: ReactNode;
+};
+type WebVRChrome = boolean | WebVRChromeAppearance;
+type WebVRState = {
+    input?: WebVRInputState;
+    available: boolean;
+    enabled: boolean;
+    mode: WebVRMode | null;
+};
+type WebVRProps = {
+    /** Input policy; auto uses explicit selection in WebXR and dwell in fallback VR. */
+    interactionMode?: WebVRInteractionMode;
+    /**
+     * Mount the built-in session chrome (Exit VR / MobileVR Setup). Defaults to
+     * true. Enter VR is not rendered; host apps drive entry through the handle
+     * or `usePanoViewer`.
+     */
+    chrome?: WebVRChrome;
+    /** Enable the phone stereoscopic fallback. Defaults to true. */
+    mobileVr?: boolean;
+    /** Treat desktop device-orientation sensors as MobileVR. Defaults to false. */
+    desktopSupport?: boolean;
+    /** Allow a mouse-driven stereoscopic desktop simulation. Defaults to true. */
+    fakeSupport?: boolean;
+    /** Physical diagonal screen size in inches, or automatic detection. */
+    screensize?: number | "auto";
+    /**
+     * Cardboard Device Parameter Database URL used when `screensize` is
+     * `"auto"`. Defaults to Google's public DPDB. Pass `""` or `null` to skip
+     * the online lookup for unknown devices.
+     */
+    databaseUrl?: string | null;
+    /** Headset preset or a custom lens profile. */
+    profile?: WebVRProfileId | WebVRProfile;
+    /**
+     * Follow compass-oriented headings in MobileVR. Defaults to false.
+     * Has no effect in WebXR sessions.
+     */
+    absolute?: boolean;
+    /** Panorama yaw that represents North when `absolute` is enabled. Defaults to 0. */
+    north?: number;
+    /**
+     * Gyro smoothing from 0 (none) to 0.99 (strong). Defaults to 0.
+     * Keep at 0 for normal viewing.
+     */
+    friction?: number;
+    /**
+     * Allow horizontal touch dragging to correct MobileVR heading. Defaults to
+     * false because headset trays can trigger false touches.
+     */
+    touchSupport?: boolean;
+    /**
+     * Distortion / WebXR framebuffer scale factor. Defaults to 1. Clamped to
+     * 0.5–2. Must be set before entering WebXR (cannot change mid-session).
+     */
+    oversampling?: number;
+    /**
+     * WebXR fixed foveation in the range 0–1. Omit to keep the device default.
+     * `0` is full resolution; `1` is maximum edge downsampling.
+     */
+    foveation?: number;
+    /**
+     * Target WebXR refresh rate. Omit to keep the store default (`"high"`).
+     * A numeric Hz picks the closest rate from `session.supportedFrameRates`.
+     */
+    frameRate?: WebVRFrameRate;
+    /** Show a center reticle in VR. Defaults to true. */
+    cursor?: boolean;
+    /**
+     * Milliseconds to keep looking at a hotspot before a gaze click.
+     * Defaults to 1500. Set to 0 to disable auto-click.
+     */
+    cursorDwellMs?: number;
+    /**
+     * Keep the display awake while MobileVR or simulated VR is active.
+     * Uses the Screen Wake Lock API when available, otherwise a looping
+     * hidden video. Defaults to true.
+     */
+    wakelock?: boolean;
+    /**
+     * Lock the mouse in simulated desktop VR so movement looks around with
+     * no visible cursor. Right-click to release; left-click the view to re-lock.
+     * While unlocked, the reticle and gaze actions are paused. Defaults to true.
+     */
+    mousePointerLock?: boolean;
+    onAvailable?: () => void;
+    onUnavailable?: () => void;
+    onEnterVR?: (mode: WebVRMode) => void;
+    onExitVR?: (mode: WebVRMode) => void;
+    onDenied?: (error?: unknown) => void;
+    onUnknownDevice?: () => void;
+};
+type WebVRHandle = {
+    enterVR: () => Promise<boolean>;
+    exitVR: () => Promise<void>;
+    toggleVR: () => Promise<boolean>;
+    isAvailable: () => boolean;
+    isEnabled: () => boolean;
+    getMode: () => WebVRMode | null;
+    getState: () => WebVRState;
+    subscribe: (onStoreChange: () => void) => () => void;
+    requestPermission: () => Promise<boolean>;
+    /** Reset the active fallback mode, or both modes outside VR; explicit props still apply. */
+    resetSettings: () => void;
+};
+type WebVRSettings = {
+    screensize: number | "auto";
+    profileId: WebVRProfileId;
+};
+
 type PanoSpatialControlAdapter = {
     /** Degrees. Update the existing model viewing controls, not the panorama camera. */
     rotateBy?: (yaw: number, pitch: number) => void;
@@ -253,7 +396,7 @@ type PanoSpatialControlAdapter = {
 };
 
 type PanoMediaController = Pick<PanoVideoController, "subscribe" | "play" | "pause" | "seek" | "setVolume" | "setMuted"> & {
-    getSnapshot: () => Pick<PanoVideoPlaybackSnapshot, "ready" | "playing" | "currentTime" | "duration" | "volume" | "volumeAdjustable" | "muted">;
+    getSnapshot: () => Pick<PanoVideoPlaybackSnapshot, "ready" | "playing" | "currentTime" | "duration" | "hasAudio" | "volume" | "volumeAdjustable" | "muted">;
 };
 type PanoControlAction = {
     id: string;
@@ -279,6 +422,7 @@ type VideoHotspotProps = HotspotCommonProps & {
     playing: boolean;
     poster?: string;
     loop?: boolean;
+    /** Defaults to false so manually started playback includes audio. */
     muted?: boolean;
     volume?: number;
     /**
@@ -348,6 +492,8 @@ type PanoVideoPlaybackSnapshot = {
     ended: boolean;
     currentTime: number;
     duration: number;
+    /** Undefined when audio track presence is unknown. */
+    hasAudio?: boolean;
     volume: number;
     /** False when the element ignores `volume` (iOS Safari). Mute still works. */
     volumeAdjustable: boolean;
@@ -379,141 +525,6 @@ type PanoVideoController = {
     setCaptionAppearance: (appearance: Partial<PanoVideoCaptionAppearance>) => void;
 };
 
-type WebVRMode = "webxr" | "mobilevr" | "fake";
-type WebVRProfileId = "none" | "cardboard-v1" | "cardboard-v2" | "gear-vr" | "daydream";
-type WebVRProfile = {
-    id?: string;
-    label?: string;
-    /** Vertical field of view for each eye, in degrees. */
-    fov: number;
-    /** Distance between the eyes, in millimetres. */
-    ipdMm: number;
-    /** Distance from the display to the headset lens, in millimetres. */
-    screenToLensMm?: number;
-    /**
-     * Distance from the headset tray bottom to the lens center, in millimetres.
-     * `0` or omitted keeps the optical axis on the vertical screen center.
-     */
-    trayDistanceMm?: number;
-    /** Radial lens distortion coefficients. Zero disables distortion. */
-    k1: number;
-    k2: number;
-};
-/** Target WebXR session refresh rate. Omitting keeps the store default (`"high"`). */
-type WebVRFrameRate = "low" | "mid" | "high" | number;
-type WebVRChromeAppearance = {
-    background?: CSSProperties["background"];
-    color?: CSSProperties["color"];
-    accent?: CSSProperties["color"];
-    borderRadius?: CSSProperties["borderRadius"];
-    fontSize?: CSSProperties["fontSize"];
-    setupTitle?: ReactNode;
-};
-type WebVRChrome = boolean | WebVRChromeAppearance;
-type WebVRState = {
-    available: boolean;
-    enabled: boolean;
-    mode: WebVRMode | null;
-};
-type WebVRProps = {
-    /**
-     * Mount the built-in session chrome (Exit VR / MobileVR Setup). Defaults to
-     * true. Enter VR is not rendered; host apps drive entry through the handle
-     * or `usePanoViewer`.
-     */
-    chrome?: WebVRChrome;
-    /** Enable the phone stereoscopic fallback. Defaults to true. */
-    mobileVr?: boolean;
-    /** Treat desktop device-orientation sensors as MobileVR. Defaults to false. */
-    desktopSupport?: boolean;
-    /** Allow a mouse-driven stereoscopic desktop simulation. Defaults to true. */
-    fakeSupport?: boolean;
-    /** Physical diagonal screen size in inches, or automatic detection. */
-    screensize?: number | "auto";
-    /**
-     * Cardboard Device Parameter Database URL used when `screensize` is
-     * `"auto"`. Defaults to Google's public DPDB. Pass `""` or `null` to skip
-     * the online lookup for unknown devices.
-     */
-    databaseUrl?: string | null;
-    /** Headset preset or a custom lens profile. */
-    profile?: WebVRProfileId | WebVRProfile;
-    /**
-     * Follow compass-oriented headings in MobileVR. Defaults to false.
-     * Has no effect in WebXR sessions.
-     */
-    absolute?: boolean;
-    /** Panorama yaw that represents North when `absolute` is enabled. Defaults to 0. */
-    north?: number;
-    /**
-     * Gyro smoothing from 0 (none) to 0.99 (strong). Defaults to 0.
-     * Keep at 0 for normal viewing.
-     */
-    friction?: number;
-    /**
-     * Allow horizontal touch dragging to correct MobileVR heading. Defaults to
-     * false because headset trays can trigger false touches.
-     */
-    touchSupport?: boolean;
-    /**
-     * Distortion / WebXR framebuffer scale factor. Defaults to 1. Clamped to
-     * 0.5–2. Must be set before entering WebXR (cannot change mid-session).
-     */
-    oversampling?: number;
-    /**
-     * WebXR fixed foveation in the range 0–1. Omit to keep the device default.
-     * `0` is full resolution; `1` is maximum edge downsampling.
-     */
-    foveation?: number;
-    /**
-     * Target WebXR refresh rate. Omit to keep the store default (`"high"`).
-     * A numeric Hz picks the closest rate from `session.supportedFrameRates`.
-     */
-    frameRate?: WebVRFrameRate;
-    /** Show a center reticle in VR. Defaults to true. */
-    cursor?: boolean;
-    /**
-     * Milliseconds to keep looking at a hotspot before a gaze click.
-     * Defaults to 1500. Set to 0 to disable auto-click.
-     */
-    cursorDwellMs?: number;
-    /**
-     * Keep the display awake while MobileVR or simulated VR is active.
-     * Uses the Screen Wake Lock API when available, otherwise a looping
-     * hidden video. Defaults to true.
-     */
-    wakelock?: boolean;
-    /**
-     * Lock the mouse in simulated desktop VR so movement looks around with
-     * no visible cursor. Right-click to release; left-click the view to re-lock.
-     * While unlocked, the reticle and gaze actions are paused. Defaults to true.
-     */
-    mousePointerLock?: boolean;
-    onAvailable?: () => void;
-    onUnavailable?: () => void;
-    onEnterVR?: (mode: WebVRMode) => void;
-    onExitVR?: (mode: WebVRMode) => void;
-    onDenied?: (error?: unknown) => void;
-    onUnknownDevice?: () => void;
-};
-type WebVRHandle = {
-    enterVR: () => Promise<boolean>;
-    exitVR: () => Promise<void>;
-    toggleVR: () => Promise<boolean>;
-    isAvailable: () => boolean;
-    isEnabled: () => boolean;
-    getMode: () => WebVRMode | null;
-    getState: () => WebVRState;
-    subscribe: (onStoreChange: () => void) => () => void;
-    requestPermission: () => Promise<boolean>;
-    /** Reset the active fallback mode, or both modes outside VR; explicit props still apply. */
-    resetSettings: () => void;
-};
-type WebVRSettings = {
-    screensize: number | "auto";
-    profileId: WebVRProfileId;
-};
-
 type PanoViewerState = {
     /** Horizontal look angle in degrees. Positive values look right. */
     yaw: number;
@@ -2044,6 +2055,9 @@ type PanoSceneMenuAppearance = {
     gap?: number | string;
     borderRadius?: number | string;
     selectionColor?: string;
+    /** Hover and keyboard-focus border color. Defaults to `"#7dd3fc"`. */
+    focusColor?: string;
+    /** Shared active/hover/focus border width in pixels. Defaults to 2. */
     selectionWidth?: number;
     labelBackground?: string;
     labelColor?: string;
@@ -2057,6 +2071,10 @@ type PanoSceneMenuProps = {
     items: readonly PanoSceneMenuItem[];
     activeId?: string | null;
     onSelect?: (id: string) => void;
+    /** Show an icon for scenes successfully displayed by this viewer. Defaults to false. */
+    showVisited?: boolean;
+    /** Accessible description for visited scenes; never rendered as visible text. */
+    visitedLabel?: string;
     /**
      * Screen anchor. Defaults to bottom, centered on that edge, with a 12px inset.
      * Corner `axis` chooses a horizontal or vertical strip.
@@ -2100,7 +2118,7 @@ type PanoSceneMenuProps = {
     toggle?: PanoOverlayToggle;
 };
 declare const DEFAULT_PANO_SCENE_MENU_APPEARANCE: Required<PanoSceneMenuAppearance>;
-declare function PanoSceneMenu({ items, activeId, onSelect, anchor, width, height, collapsible, defaultExpanded, expanded: expandedProp, onExpandedChange, showArrows, loop, dragMotion: dragMotionProp, appearance, className, style, label, previousLabel, nextLabel, expandLabel, collapseLabel, toggle, }: PanoSceneMenuProps): react.JSX.Element;
+declare function PanoSceneMenu({ items, activeId, onSelect, showVisited, visitedLabel, anchor, width, height, collapsible, defaultExpanded, expanded: expandedProp, onExpandedChange, showArrows, loop, dragMotion: dragMotionProp, appearance, className, style, label, previousLabel, nextLabel, expandLabel, collapseLabel, toggle, }: PanoSceneMenuProps): react.JSX.Element;
 
 type ViewInteractionSource = "mouse" | "touch" | "keyboard";
 type PanoWheelEvent = {
@@ -2623,4 +2641,48 @@ declare function PanoSpatialControls({ children, position, width, distance, clas
 /** Adapts an existing media element without owning its source or playback lifetime. */
 declare function usePanoMediaController(ref: RefObject<HTMLMediaElement | null>): PanoMediaController;
 
-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_SCENE_MENU_APPEARANCE, 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, EMPTY_WEBVR_STATE, 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 HotspotTooltipScaleMode, 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, PANO_OVERLAY_ALIGNS, 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 PanoControlAction, PanoControlButton, PanoControlGroup, type PanoControlGroupProps, type PanoCursor, type PanoCursors, PanoDataError, type PanoDataErrorCode, PanoDialogSurfaceContext, type PanoDragMotion, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, PanoMap, type PanoMapControlsDefinition, type PanoMapDefinition, type PanoMapDialogPresentation, type PanoMapEditChange, type PanoMapGradientStop, PanoMapOverlay, type PanoMapOverlayProps, type PanoMapPanelPresentation, type PanoMapPresentation, type PanoMapProps, type PanoMapSectorDefinition, type PanoMapSectorGradient, type PanoMapSpotDefinition, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoMediaController, PanoMediaControls, PanoModelControls, PanoOverlay, type PanoOverlayAlign, type PanoOverlayAnchor, type PanoOverlayAxis, type PanoOverlayChevron, type PanoOverlayCollapseEdge, type PanoOverlayContentAlign, type PanoOverlayInset, PanoOverlayPortalProvider, type PanoOverlayProps, type PanoOverlayRenderContext, type PanoOverlayToggle, type PanoOverlayToggleState, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoResizeEvent, PanoSceneMenu, type PanoSceneMenuAppearance, type PanoSceneMenuItem, type PanoSceneMenuLabelAlign, type PanoSceneMenuProps, PanoScrollControls, type PanoSpatialControlAdapter, PanoSpatialControls, type PanoSpatialControlsProps, 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 ResolvedOverlayAnchor, 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 WebVRFrameRate, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, type WebVRState, clampPanoPitch, composePanoContextMenuItems, containRect, containerPointToImage, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, headingFromVector, horizontalFov, hotspotAction, imagePointToContainer, isOverlayCorner, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parseOverlayAnchor, parsePanoMap, parsePanoProject, projectHotspotTriggers, resolveOverlayAnchor, resolveOverlayToggleIcon, resolvePanoContextMenuEntries, resolvePanoMapAssets, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, sectorRotation, setHotspotAction, unwrapPolygonVertices, usePanoDialogSurface, usePanoEvents, usePanoMediaController, usePanoModal, usePanoOverlay, usePanoSpatialControls, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+type WebVRSceneMenuAppearance = {
+    controlColor?: string;
+    controlBackground?: string;
+    controlOpacity?: number;
+    selectionColor?: string;
+    focusColor?: string;
+    /** Shared selected/gaze/focus outline width in reference pixels. Defaults to 4; range 0–8. */
+    selectionWidth?: number;
+    borderRadius?: number;
+    labelColor?: string;
+    labelBackground?: string;
+    fontSize?: number;
+    labelPlacement?: "center" | "bottom";
+};
+declare const DEFAULT_WEBVR_SCENE_MENU_APPEARANCE: Required<WebVRSceneMenuAppearance>;
+type WebVRSceneMenuProps = {
+    items: readonly PanoSceneMenuItem[];
+    activeId?: string | null;
+    onSelect?: (id: string) => void;
+    /** Show an icon for scenes successfully displayed by this viewer. Defaults to false. */
+    showVisited?: boolean;
+    /** Accessible description for visited scenes; never rendered as visible text. */
+    visitedLabel?: string;
+    /** Defaults to the original compact curved grid. */
+    layout?: "compact" | "flat" | "arc";
+    /** All mode grows the row count and ignores rows. Defaults to paged. */
+    displayMode?: "paged" | "all";
+    /** Arc coverage in degrees, 60–360. Defaults to 180. */
+    arcAngle?: number;
+    columns?: number;
+    rows?: number;
+    loop?: boolean;
+    closeOnSelect?: boolean;
+    follow?: boolean;
+    navigationPitch?: number;
+    distance?: number;
+    scale?: number;
+    fadeDurationMs?: number;
+    showTitles?: boolean;
+    appearance?: WebVRSceneMenuAppearance;
+};
+/** Native spatial UI. Mount beside WebVR and Scenes inside PanoViewer. */
+declare function WebVRSceneMenu(props: WebVRSceneMenuProps): react.JSX.Element | null;
+
+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_SCENE_MENU_APPEARANCE, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, DEFAULT_WEBVR_SCENE_MENU_APPEARANCE, type DiamondGraphic, EMPTY_WEBVR_STATE, 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 HotspotTooltipScaleMode, 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, PANO_OVERLAY_ALIGNS, 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 PanoControlAction, PanoControlButton, PanoControlGroup, type PanoControlGroupProps, type PanoCursor, type PanoCursors, PanoDataError, type PanoDataErrorCode, PanoDialogSurfaceContext, type PanoDragMotion, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, PanoMap, type PanoMapControlsDefinition, type PanoMapDefinition, type PanoMapDialogPresentation, type PanoMapEditChange, type PanoMapGradientStop, PanoMapOverlay, type PanoMapOverlayProps, type PanoMapPanelPresentation, type PanoMapPresentation, type PanoMapProps, type PanoMapSectorDefinition, type PanoMapSectorGradient, type PanoMapSpotDefinition, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoMediaController, PanoMediaControls, PanoModelControls, PanoOverlay, type PanoOverlayAlign, type PanoOverlayAnchor, type PanoOverlayAxis, type PanoOverlayChevron, type PanoOverlayCollapseEdge, type PanoOverlayContentAlign, type PanoOverlayInset, PanoOverlayPortalProvider, type PanoOverlayProps, type PanoOverlayRenderContext, type PanoOverlayToggle, type PanoOverlayToggleState, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoResizeEvent, PanoSceneMenu, type PanoSceneMenuAppearance, type PanoSceneMenuItem, type PanoSceneMenuLabelAlign, type PanoSceneMenuProps, PanoScrollControls, type PanoSpatialControlAdapter, PanoSpatialControls, type PanoSpatialControlsProps, 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 ResolvedOverlayAnchor, 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 WebVRFrameRate, type WebVRHandle, type WebVRInputState, type WebVRInteractionMode, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, WebVRSceneMenu, type WebVRSceneMenuAppearance, type WebVRSceneMenuProps, type WebVRSettings, type WebVRState, clampPanoPitch, composePanoContextMenuItems, containRect, containerPointToImage, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, headingFromVector, horizontalFov, hotspotAction, imagePointToContainer, isOverlayCorner, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parseOverlayAnchor, parsePanoMap, parsePanoProject, projectHotspotTriggers, resolveOverlayAnchor, resolveOverlayToggleIcon, resolvePanoContextMenuEntries, resolvePanoMapAssets, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, sectorRotation, setHotspotAction, unwrapPolygonVertices, usePanoDialogSurface, usePanoEvents, usePanoMediaController, usePanoModal, usePanoOverlay, usePanoSpatialControls, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };