@ericchen1990/pano-view 0.2.0 → 2.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, ComponentPropsWithoutRef } from 'react';
+import { CSSProperties, ReactNode, ComponentPropsWithoutRef, IframeHTMLAttributes } from 'react';
 import { Texture, ColorRepresentation, Vector3 } from 'three';
 
 declare const MAX_HOTSPOT_PITCH = 90;
@@ -29,9 +29,50 @@ type HotspotDragEvent = HotspotInteractionEvent & {
     source: "pointer";
     startPosition: HotspotPosition;
 };
+/** When a hotspot tooltip is shown. Defaults to `"always"`. */
+type HotspotTooltipTrigger = "always" | "hover" | "click";
+/**
+ * Pointer hit-testing for a hotspot. `"none"` ignores mouse, touch, and pen
+ * so events pass through to the panorama. Defaults to `"auto"`.
+ */
+type HotspotPointerEvents = "auto" | "none";
+/** Where the tooltip sits relative to the hotspot. Defaults to `"top"`. */
+type HotspotTooltipPlacement = "top" | "bottom" | "left" | "right";
+/** Plain-text and/or image content for a hotspot tooltip. */
+type HotspotTooltipContent = {
+    text?: string;
+    image?: string;
+    imageAlt?: string;
+};
+/** Visual styling for a hotspot tooltip bubble. */
+type HotspotTooltipAppearance = {
+    background?: string;
+    color?: string;
+    border?: string;
+    borderRadius?: number | string;
+    shadow?: string;
+    padding?: number | string;
+    fontSize?: number | string;
+};
 type HotspotCommonProps = {
     id: string;
     position: HotspotPosition;
+    /**
+     * Tooltip shown at the hotspot anchor. A string is treated as `{ text }`.
+     * Defaults to always visible when content is present.
+     */
+    tooltip?: string | HotspotTooltipContent;
+    /** Defaults to `"always"`. `"hover"` and `"click"` require `interactive` and `pointerEvents` other than `"none"`. */
+    tooltipTrigger?: HotspotTooltipTrigger;
+    /** Screen direction for the tooltip. Defaults to `"top"`. */
+    tooltipPlacement?: HotspotTooltipPlacement;
+    /**
+     * Screen-space gap in CSS pixels between the hotspot edge and the tooltip.
+     * Defaults to 12.
+     */
+    tooltipOffset?: number;
+    /** Optional bubble paint overrides. Unset fields use the library default theme. */
+    tooltipAppearance?: HotspotTooltipAppearance;
     /** Angular width in degrees. Defaults to 12. */
     width?: number;
     /** Angular height in degrees. Defaults to 8. */
@@ -56,6 +97,17 @@ type HotspotCommonProps = {
     visible?: boolean;
     /** Whether the hotspot accepts pointer and keyboard interaction. Defaults to true. */
     interactive?: boolean;
+    /**
+     * Pointer hit-testing. `"none"` ignores mouse, touch, and pen so events
+     * pass through to the panorama. Defaults to `"auto"`.
+     * `interactive={false}` also disables pointer hits.
+     */
+    pointerEvents?: HotspotPointerEvents;
+    /**
+     * Canvas cursor while this hotspot is hovered. Defaults to the viewer's
+     * `cursors.hotspot` value (`"pointer"`).
+     */
+    cursor?: CSSProperties["cursor"];
     draggable?: boolean;
     /** Required for keyboard-accessible clickable hotspots. */
     ariaLabel?: string;
@@ -96,7 +148,7 @@ type KeyboardControlsProps = {
     invert?: boolean;
     /**
      * Maximum FOV change rate in degrees per second. When omitted, no extra
-     * rate cap is applied. Usually supplied by PanoView from `controls.fovSpeed`.
+     * rate cap is applied. Usually supplied by PanoViewer from `controls.fovSpeed`.
      */
     fovSpeed?: number;
     /** Called once when the previous-scene binding is pressed. */
@@ -113,14 +165,15 @@ declare function cycleSceneId(scenes: readonly {
     id: string;
 }[], activeSceneId: string, step: 1 | -1): string | null;
 /**
- * Adds keyboard navigation to the nearest PanoView. PanoView mounts a default
- * instance; render your own to customize bindings or scene callbacks. Hold
- * movement/zoom keys for continuous motion; scene and reset bindings fire once
- * per key press.
+ * Adds keyboard navigation to the nearest PanoViewer. Enabled by default;
+ * render this component only to override properties, bindings, or scene
+ * callbacks. Hold movement/zoom keys for continuous motion; scene and reset
+ * bindings fire once per key press. Click the viewer to focus it before
+ * keys are received.
  */
 declare function KeyboardControls({ enabled, keys, rotateSpeed, zoomSpeed, shiftMultiplier, invert, fovSpeed, onPreviousScene, onNextScene, }: KeyboardControlsProps): null;
 
-type PanoViewState = {
+type PanoViewerState = {
     /** Horizontal look angle in degrees. Positive values look right. */
     yaw: number;
     /** Vertical look angle in degrees. Positive values look up. */
@@ -128,13 +181,13 @@ type PanoViewState = {
     /** Vertical perspective field of view in degrees. */
     fov: number;
 };
-type SetPanoViewOptions = {
+type SetPanoViewerOptions = {
     /** Apply the new view immediately instead of preserving current inertia. */
     immediate?: boolean;
 };
-type PanoViewHandle = {
-    getView: () => PanoViewState;
-    setView: (view: Partial<PanoViewState>, options?: SetPanoViewOptions) => void;
+type PanoViewerHandle = {
+    getView: () => PanoViewerState;
+    setView: (view: Partial<PanoViewerState>, options?: SetPanoViewerOptions) => void;
     reset: () => void;
     /** @deprecated Control an AutoRotate component's enabled prop instead. */
     startAutoRotate: () => void;
@@ -172,12 +225,12 @@ type TouchControlsOptions = {
 type PanoramaControlsOptions = {
     /**
      * Master switch for user view controls. Defaults to true. Setting
-     * `controls={false}` on PanoView still disables all user input.
+     * `controls={false}` on PanoViewer still disables all user input.
      */
     enabled?: boolean;
     /** Enables drag and zoom inertia. Defaults to true. */
     inertia?: boolean;
-    /** @deprecated Render <AutoRotate enabled /> inside PanoView instead. */
+    /** @deprecated Render <AutoRotate enabled /> inside PanoViewer instead. */
     autoRotate?: boolean;
     /** @deprecated Use AutoRotate's speed prop instead. */
     autoRotateSpeed?: number;
@@ -222,9 +275,9 @@ type PanoramaControlsOptions = {
      */
     zoomDamping?: number;
     /**
-     * Mouse channel. `true` / omit mounts defaults; `false` skips the default
-     * instance (render a custom MouseControls child); an object merges with
-     * defaults and supports `enabled`.
+     * Mouse channel. `true` / omit mounts defaults; `false` disables the
+     * default instance; an object merges with defaults and supports `enabled`.
+     * Rendering `<MouseControls />` as a child also replaces the default.
      */
     mouse?: boolean | MouseControlsOptions;
     /**
@@ -232,8 +285,8 @@ type PanoramaControlsOptions = {
      */
     touch?: boolean | TouchControlsOptions;
     /**
-     * Keyboard channel. Same shape as `mouse`. Set to false when providing a
-     * custom KeyboardControls child.
+     * Keyboard channel. Same shape as `mouse`. Rendering `<KeyboardControls />`
+     * as a child replaces the default (no need to set this to false).
      */
     keyboard?: boolean | KeyboardControlsProps;
 };
@@ -242,7 +295,7 @@ type PanoramaControlsOptions = {
 declare const MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY = 0.4;
 type PanoContextMenuSelectContext = {
     position: PanoramaPointerEvent["position"];
-    view: PanoViewState;
+    view: PanoViewerState;
     nativeEvent: MouseEvent | PointerEvent;
     close: () => void;
 };
@@ -308,7 +361,7 @@ type PanoContextMenuAppearance = {
 };
 type PanoContextMenuRenderProps = {
     event: PanoramaPointerEvent;
-    view: PanoViewState;
+    view: PanoViewerState;
     close: () => void;
 };
 type PanoContextMenuProps = {
@@ -341,8 +394,8 @@ type PanoContextMenuProps = {
     children?: (props: PanoContextMenuRenderProps) => ReactNode;
 };
 /**
- * Custom panorama context menu. Must render inside PanoView. Prefer
- * PanoView's `contextMenu` prop for the default menu; use this component
+ * Custom panorama context menu. Must render inside PanoViewer. Prefer
+ * PanoViewer's `contextMenu` prop for the default menu; use this component
  * when replacing the default instance (`contextMenu={false}`).
  */
 declare function PanoContextMenu({ items, prepend, append, appearance, className, style, itemClassName, separatorClassName, children, }: PanoContextMenuProps): null;
@@ -362,7 +415,7 @@ type PanoContextMenuPresets = {
 /**
  * Builds reusable built-in context-menu items. Prefer preset id strings
  * (`"resetView"`, `"fullscreen"`) in `items` / `append` / `prepend` when
- * configuring `PanoView`; use this helper when assembling items manually.
+ * configuring `PanoViewer`; use this helper when assembling items manually.
  */
 declare function createPanoContextMenuPresets(actions: PanoContextMenuPresetActions): PanoContextMenuPresets;
 /** Alias for `createPanoContextMenuPresets(actions).defaults`. */
@@ -376,12 +429,33 @@ declare function resolvePanoContextMenuEntries(entries: readonly PanoContextMenu
  */
 declare function composePanoContextMenuItems(props: Pick<PanoContextMenuProps, "items" | "prepend" | "append">, presets: PanoContextMenuPresets): PanoContextMenuItem[];
 
-type PanoViewProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange" | "contextMenu"> & {
+/** A CSS `cursor` value applied to the panorama canvas. */
+type PanoCursor = NonNullable<CSSProperties["cursor"]>;
+/** Canvas cursor values for viewer idle, drag, and hotspot interaction. */
+type PanoCursors = {
+    /** Idle canvas cursor. Defaults to `"grab"`. */
+    default?: PanoCursor;
+    /** Cursor while dragging the panorama with the mouse. Defaults to `"grabbing"`. */
+    dragging?: PanoCursor;
+    /** Cursor while hovering an interactive hotspot. Defaults to `"pointer"`. */
+    hotspot?: PanoCursor;
+    /** Cursor while dragging a hotspot. Defaults to `"move"`. */
+    hotspotDragging?: PanoCursor;
+};
+declare const DEFAULT_PANO_CURSORS: Required<PanoCursors>;
+
+type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
-    initialView?: Partial<PanoViewState>;
+    initialView?: Partial<PanoViewerState>;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
+    /**
+     * Canvas cursor. `true` / omit uses grab / grabbing / pointer / move;
+     * `false` leaves the canvas cursor unchanged; an object merges with the
+     * defaults (`default`, `dragging`, `hotspot`, `hotspotDragging`).
+     */
+    cursors?: boolean | PanoCursors;
     /**
      * Default context menu. `true` / omit mounts Reset view + Fullscreen;
      * `false` skips the default instance; an object merges appearance and
@@ -389,19 +463,25 @@ type PanoViewProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChang
      * `append` to keep the defaults and add entries.
      */
     contextMenu?: boolean | PanoContextMenuProps;
-    onViewChange?: (view: PanoViewState) => void;
+    onViewChange?: (view: PanoViewerState) => void;
     onPanoramaClick?: (event: PanoramaPointerEvent) => void;
     onPanoramaDoubleClick?: (event: PanoramaPointerEvent) => void;
     onPanoramaPointerMove?: (event: PanoramaPointerEvent) => void;
     /** Canvas pixel ratio. Defaults to a capped range of 1–2. */
     dpr?: number | [number, number];
 };
-declare const PanoView: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "contextMenu" | "onChange"> & {
+declare const PanoViewer: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "contextMenu" | "onChange"> & {
     children?: ReactNode;
-    initialView?: Partial<PanoViewState>;
+    initialView?: Partial<PanoViewerState>;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
+    /**
+     * Canvas cursor. `true` / omit uses grab / grabbing / pointer / move;
+     * `false` leaves the canvas cursor unchanged; an object merges with the
+     * defaults (`default`, `dragging`, `hotspot`, `hotspotDragging`).
+     */
+    cursors?: boolean | PanoCursors;
     /**
      * Default context menu. `true` / omit mounts Reset view + Fullscreen;
      * `false` skips the default instance; an object merges appearance and
@@ -409,13 +489,13 @@ declare const PanoView: react.ForwardRefExoticComponent<Omit<Omit<react.Detailed
      * `append` to keep the defaults and add entries.
      */
     contextMenu?: boolean | PanoContextMenuProps;
-    onViewChange?: (view: PanoViewState) => void;
+    onViewChange?: (view: PanoViewerState) => void;
     onPanoramaClick?: (event: PanoramaPointerEvent) => void;
     onPanoramaDoubleClick?: (event: PanoramaPointerEvent) => void;
     onPanoramaPointerMove?: (event: PanoramaPointerEvent) => void;
     /** Canvas pixel ratio. Defaults to a capped range of 1–2. */
     dpr?: number | [number, number];
-} & react.RefAttributes<PanoViewHandle>>;
+} & react.RefAttributes<PanoViewerHandle>>;
 
 /** Options for automatic horizontal panorama rotation. */
 type AutoRotateProps = {
@@ -432,11 +512,155 @@ type AutoRotateProps = {
     startDelay?: number;
 };
 /**
- * Adds automatic rotation to the nearest PanoView. Render one instance as a
- * child of PanoView, alongside its panorama source.
+ * Adds automatic rotation to the nearest PanoViewer. Render one instance as a
+ * child of PanoViewer, alongside its panorama source.
  */
 declare function AutoRotate({ enabled, speed, acceleration, startDelay, }: AutoRotateProps): null;
 
+declare const PANO_FILTER_PRESETS: readonly ["none", "grayscale", "sepia", "vintage", "cool", "warm", "pencil", "coloredPencil", "crayon", "watercolor", "cartoon", "crosshatch"];
+type PanoFilterPreset = (typeof PANO_FILTER_PRESETS)[number];
+
+type PanoFilterProps = {
+    /** Built-in look. Defaults to `none` (identity). */
+    preset?: PanoFilterPreset;
+    /** Mix with the original panorama, 0–1. Defaults to 1. */
+    intensity?: number;
+    /** When false, the panorama renders without a filter. Defaults to true. */
+    enabled?: boolean;
+};
+/**
+ * Applies a color or artistic filter to the panorama source of the nearest
+ * PanoViewer. Render one instance as a child of PanoViewer. Hotspots and HTML
+ * chrome are not filtered.
+ */
+declare function PanoFilter({ preset, intensity, enabled, }: PanoFilterProps): null;
+
+type GyroTouchMode = "off" | "horizontaloffset" | "full" | "disablegyro";
+
+type GyroHandle = {
+    resetSensor: (yaw?: number, pitch?: number) => void;
+    isAvailable: () => boolean;
+    isEnabled: () => boolean;
+    /**
+     * Requests iOS sensor permission. Call this directly from a user gesture
+     * before setting `enabled` to true.
+     */
+    requestPermission: () => Promise<boolean>;
+};
+type GyroProps = {
+    /** Whether device-orientation control is requested. Defaults to false. */
+    enabled?: boolean;
+    /** Whether device roll levels the camera. Defaults to true. */
+    camroll?: boolean;
+    /** Whether to follow compass-oriented headings. Defaults to false. */
+    absolute?: boolean;
+    /** Panorama yaw that represents North, in degrees. Defaults to 0. */
+    north?: number;
+    /** Sensor smoothing from 0 (none) to 0.99 (strong). Defaults to 0. */
+    friction?: number;
+    /** How touch dragging combines with gyro movement. Defaults to "full". */
+    touchMode?: GyroTouchMode;
+    /** Seconds used to blend from the current view when enabling. Defaults to 0.5. */
+    softstart?: number;
+    /** Allow capability detection on desktop-class devices. Defaults to false. */
+    desktopSupport?: boolean;
+    onAvailable?: () => void;
+    onUnavailable?: () => void;
+    onEnable?: () => void;
+    onDisable?: () => void;
+    onDenied?: () => void;
+};
+/**
+ * Adds device-orientation navigation to the nearest PanoViewer.
+ * Sensor access is opt-in and disabled by default.
+ */
+declare const Gyro: react.ForwardRefExoticComponent<GyroProps & react.RefAttributes<GyroHandle>>;
+
+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;
+    /** Radial lens distortion coefficients. Zero disables distortion. */
+    k1: number;
+    k2: 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 WebVRProps = {
+    /** Mount the built-in Enter / Exit / Setup chrome. Defaults to true. */
+    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";
+    /** Headset preset or a custom lens profile. */
+    profile?: WebVRProfileId | WebVRProfile;
+    /** 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. Click the view to re-lock after Escape. 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;
+    requestPermission: () => Promise<boolean>;
+};
+type WebVRSettings = {
+    screensize: number | "auto";
+    profileId: WebVRProfileId;
+};
+
+declare const WebVR: react.ForwardRefExoticComponent<WebVRProps & react.RefAttributes<WebVRHandle>>;
+
+declare const DEFAULT_WEBVR_CHROME_APPEARANCE: Required<Omit<WebVRChromeAppearance, "setupTitle">>;
+
+declare const WEBVR_PROFILE_IDS: readonly ["none", "cardboard-v1", "cardboard-v2", "gear-vr", "daydream"];
+declare const WEBVR_PROFILES: Record<WebVRProfileId, WebVRProfile>;
+
+declare const DEFAULT_WEBVR_CURSOR_DWELL_MS = 1500;
+
 type ViewInteractionSource = "mouse" | "touch" | "keyboard";
 type PanoWheelEvent = {
     /** Signed wheel delta (same sign convention as WheelEvent.deltaY). */
@@ -451,8 +675,8 @@ type ViewInteractionEvent = {
     source: ViewInteractionSource;
 };
 type PanoEventMap = {
-    viewchange: PanoViewState;
-    viewsettled: PanoViewState;
+    viewchange: PanoViewerState;
+    viewsettled: PanoViewerState;
     viewinteractionstart: ViewInteractionEvent;
     viewinteractionend: ViewInteractionEvent;
     click: PanoramaPointerEvent;
@@ -470,6 +694,23 @@ type PanoEventMap = {
     autorotatestart: undefined;
     autorotatestop: undefined;
     autorotateoneround: undefined;
+    gyroavailable: undefined;
+    gyrounavailable: undefined;
+    gyroenable: undefined;
+    gyrodisable: undefined;
+    gyrodenied: undefined;
+    vravailable: undefined;
+    vrunavailable: undefined;
+    vrenter: {
+        mode: WebVRMode;
+    };
+    vrexit: {
+        mode: WebVRMode;
+    };
+    vrdenied: {
+        error?: unknown;
+    };
+    vrunknowndevice: undefined;
 };
 type PanoEventType = keyof PanoEventMap;
 type PanoEventListener<T extends PanoEventType> = (payload: PanoEventMap[T]) => void;
@@ -484,8 +725,8 @@ type PanoEventsProps = {
      * Each PanoEvents instance tracks idle independently.
      */
     idleTime?: number;
-    onViewChange?: (view: PanoViewState) => void;
-    onViewSettled?: (view: PanoViewState) => void;
+    onViewChange?: (view: PanoViewerState) => void;
+    onViewSettled?: (view: PanoViewerState) => void;
     onViewInteractionStart?: (event: ViewInteractionEvent) => void;
     onViewInteractionEnd?: (event: ViewInteractionEvent) => void;
     onClick?: (event: PanoramaPointerEvent) => void;
@@ -503,14 +744,25 @@ type PanoEventsProps = {
     onAutoRotateStart?: () => void;
     onAutoRotateStop?: () => void;
     onAutoRotateOneRound?: () => void;
+    onGyroAvailable?: () => void;
+    onGyroUnavailable?: () => void;
+    onGyroEnable?: () => void;
+    onGyroDisable?: () => void;
+    onGyroDenied?: () => void;
+    onVRAvailable?: () => void;
+    onVRUnavailable?: () => void;
+    onVREnter?: (mode: WebVRMode) => void;
+    onVRExit?: (mode: WebVRMode) => void;
+    onVRDenied?: (error?: unknown) => void;
+    onVRUnknownDevice?: () => void;
 };
 /**
- * Subscribes to viewer-level panorama events. Must run inside PanoView.
+ * Subscribes to viewer-level panorama events. Must run inside PanoViewer.
  * Prefer the {@link PanoEvents} component for declarative usage.
  */
-declare function usePanoEvents({ idleTime, onViewChange, onViewSettled, onViewInteractionStart, onViewInteractionEnd, onClick, onDoubleClick, onPointerDown, onPointerUp, onPointerMove, onContextMenu, onWheel, onIdle, onIdleEnd, onEnterFullscreen, onExitFullscreen, onResize, onAutoRotateStart, onAutoRotateStop, onAutoRotateOneRound, }: PanoEventsProps): void;
+declare function usePanoEvents({ idleTime, onViewChange, onViewSettled, onViewInteractionStart, onViewInteractionEnd, onClick, onDoubleClick, onPointerDown, onPointerUp, onPointerMove, onContextMenu, onWheel, onIdle, onIdleEnd, onEnterFullscreen, onExitFullscreen, onResize, onAutoRotateStart, onAutoRotateStop, onAutoRotateOneRound, onGyroAvailable, onGyroUnavailable, onGyroEnable, onGyroDisable, onGyroDenied, onVRAvailable, onVRUnavailable, onVREnter, onVRExit, onVRDenied, onVRUnknownDevice, }: PanoEventsProps): void;
 /**
- * Declarative viewer-level event listeners for the nearest PanoView.
+ * Declarative viewer-level event listeners for the nearest PanoViewer.
  * Multiple instances may coexist; each tracks its own idle timer.
  */
 declare function PanoEvents(props: PanoEventsProps): null;
@@ -518,21 +770,21 @@ declare function PanoEvents(props: PanoEventsProps): null;
 type MouseControlsProps = MouseControlsOptions & {
     /**
      * Maximum FOV change rate in degrees per second for wheel zoom. When
-     * omitted, no extra rate cap is applied. Usually supplied by PanoView from
+     * omitted, no extra rate cap is applied. Usually supplied by PanoViewer from
      * `controls.fovSpeed`.
      */
     fovSpeed?: number;
 };
 /**
- * Adds mouse (and pen) drag / wheel navigation to the nearest PanoView.
- * PanoView mounts a default instance; render your own only to override.
+ * Adds mouse (and pen) drag / wheel navigation to the nearest PanoViewer.
+ * Enabled by default; render this component only to override properties.
  */
 declare function MouseControls({ enabled, rotateSpeed, zoomSpeed, wheel, invert, buttons, fovSpeed, }: MouseControlsProps): null;
 
 type TouchControlsProps = TouchControlsOptions;
 /**
- * Adds touch drag and pinch-zoom navigation to the nearest PanoView.
- * PanoView mounts a default instance; render your own only to override.
+ * Adds touch drag and pinch-zoom navigation to the nearest PanoViewer.
+ * Enabled by default; render this component only to override properties.
  */
 declare function TouchControls({ enabled, rotateSpeed, invert, pinchZoom, }: TouchControlsProps): null;
 
@@ -547,6 +799,178 @@ type SphereProps = {
 };
 declare function Sphere({ src, yawOffset, onLoad, onError, visible, }: SphereProps): react.JSX.Element | null;
 
+type VideoPlaybackState = "playing" | "paused" | "ended" | "blocked";
+type VideoHotspotErrorEvent = {
+    id: string;
+    source: "poster" | "video";
+    error: unknown;
+};
+type VideoHotspotProps = HotspotCommonProps & {
+    src: string;
+    playing: boolean;
+    poster?: string;
+    loop?: boolean;
+    muted?: boolean;
+    volume?: number;
+    playsInline?: boolean;
+    preload?: "none" | "metadata" | "auto";
+    crossOrigin?: "" | "anonymous" | "use-credentials";
+    onPlaybackStateChange?: (state: VideoPlaybackState) => void;
+    onPlaybackError?: (error: unknown) => void;
+    onEnded?: () => void;
+    onError?: (event: VideoHotspotErrorEvent) => void;
+};
+declare function VideoHotspot({ id, src, playing, poster, loop, muted, volume, playsInline, preload, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: VideoHotspotProps): react.JSX.Element;
+
+type PanoVideoSource = {
+    src: string;
+    type?: string;
+};
+type PanoVideoVariant = {
+    id: string;
+    label: string;
+    poster?: string;
+    sources: readonly PanoVideoSource[];
+};
+type PanoVideoTrackKind = "subtitles" | "captions";
+type PanoVideoTrack = {
+    /** Defaults to `srcLang`. */
+    id?: string;
+    src: string;
+    srcLang: string;
+    label: string;
+    kind?: PanoVideoTrackKind;
+    default?: boolean;
+};
+type PanoVideoCaptionAppearance = {
+    color?: string;
+    background?: string;
+    fontSize?: number | string;
+    fontFamily?: string;
+    fontWeight?: CSSProperties["fontWeight"];
+    textShadow?: string;
+    padding?: string;
+    borderRadius?: number | string;
+    maxWidth?: number | string;
+    bottom?: number | string;
+    lineHeight?: number | string;
+};
+type PanoVideoControlsAppearance = {
+    background?: string;
+    color?: string;
+    accent?: string;
+    borderRadius?: number | string;
+    fontSize?: number | string;
+    padding?: string;
+};
+type PanoVideoErrorSource = "poster" | "video" | "track";
+type PanoVideoErrorEvent = {
+    source: PanoVideoErrorSource;
+    error: unknown;
+};
+type PanoVideoPlaybackSnapshot = {
+    ready: boolean;
+    playing: boolean;
+    blocked: boolean;
+    ended: boolean;
+    currentTime: number;
+    duration: number;
+    volume: number;
+    /** False when the element ignores `volume` (iOS Safari). Mute still works. */
+    volumeAdjustable: boolean;
+    muted: boolean;
+    playbackRate: number;
+    variantId: string;
+    variants: readonly PanoVideoVariant[];
+    trackId: string | null;
+    tracks: readonly PanoVideoTrack[];
+    captionText: string;
+    captionAppearance: Required<PanoVideoCaptionAppearance>;
+    captionsEnabled: boolean;
+    playbackRates: readonly number[];
+    playbackState: VideoPlaybackState;
+};
+type PanoVideoController = {
+    subscribe: (onStoreChange: () => void) => () => void;
+    getSnapshot: () => PanoVideoPlaybackSnapshot;
+    play: () => Promise<void>;
+    pause: () => void;
+    togglePlay: () => void;
+    seek: (time: number) => void;
+    setVolume: (volume: number) => void;
+    setMuted: (muted: boolean) => void;
+    toggleMuted: () => void;
+    setPlaybackRate: (rate: number) => void;
+    setVariantId: (id: string) => void;
+    setTrackId: (id: string | null) => void;
+    setCaptionAppearance: (appearance: Partial<PanoVideoCaptionAppearance>) => void;
+};
+
+type PanoVideoProps = {
+    /** Single-file shortcut when `variants` is omitted. */
+    src?: string;
+    poster?: string;
+    variants?: readonly PanoVideoVariant[];
+    defaultVariantId?: string;
+    tracks?: readonly PanoVideoTrack[];
+    /**
+     * Caption overlay. `true` / omit uses the default appearance; `false`
+     * hides captions and the control-bar language menu; an object merges
+     * with the defaults.
+     */
+    captions?: boolean | PanoVideoCaptionAppearance;
+    /**
+     * Playback chrome. `true` / omit mounts the default bar; `false` skips
+     * it; an object mounts the default bar with appearance overrides.
+     * Render `PanoVideoControls` as a PanoViewer child to replace the default.
+     */
+    controls?: boolean | PanoVideoControlsAppearance;
+    /** Horizontal video offset in degrees. */
+    yawOffset?: number;
+    loop?: boolean;
+    muted?: boolean;
+    volume?: number;
+    autoPlay?: boolean;
+    playsInline?: boolean;
+    preload?: "none" | "metadata" | "auto";
+    crossOrigin?: "" | "anonymous" | "use-credentials";
+    playbackRates?: readonly number[];
+    /** Keeps the source mounted for preloading without drawing it. */
+    visible?: boolean;
+    onLoad?: () => void;
+    onError?: (event: PanoVideoErrorEvent) => void;
+    onPlaybackStateChange?: (state: VideoPlaybackState) => void;
+    onEnded?: () => void;
+    onVariantChange?: (id: string) => void;
+    onTrackChange?: (id: string | null) => void;
+};
+/**
+ * Equirectangular 360 video mapped onto the panorama sphere. Mount inside
+ * PanoViewer. Default playback chrome and captions portal to the viewer overlay.
+ */
+declare function PanoVideo({ src, poster, variants: variantsProp, defaultVariantId, tracks: tracksProp, captions, controls, yawOffset, loop, muted, volume, autoPlay, playsInline, preload, crossOrigin, playbackRates, visible, onLoad, onError, onPlaybackStateChange, onEnded, onVariantChange, onTrackChange, }: PanoVideoProps): react.JSX.Element | null;
+
+declare const DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE: Required<PanoVideoControlsAppearance>;
+type PanoVideoControlsProps = {
+    appearance?: PanoVideoControlsAppearance;
+};
+/**
+ * Claims the default playback chrome slot for a custom replacement.
+ * Render inside PanoViewer when overriding the built-in controls.
+ */
+declare function PanoVideoControls({ appearance }: PanoVideoControlsProps): null;
+
+declare const DEFAULT_PANO_VIDEO_PLAYBACK_RATES: readonly [0.5, 1, 1.25, 1.5, 2];
+
+declare const DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE: Required<PanoVideoCaptionAppearance>;
+
+type SceneTransitionPreset = "none" | "crossfade" | "zoom" | "blackout" | "whiteFlash" | "slideRightToLeft" | "slideTopToBottom" | "slideDiagonal" | "circleOpen" | "verticalOpen" | "horizontalOpen" | "ellipticZoomOpen" | "pixelate" | "gridWipe" | "gridWipeUp" | "gridWipeRight" | "gridWipeDiagonal" | "gridWipeCenter" | "gridWipeChecker" | "dissolve" | "shatter" | "particles" | "glitch" | "swirl" | "clockWipe" | "ripple" | "zoomBlur" | "hexDissolve" | "filmBurn";
+type SceneTransition = SceneTransitionPreset | {
+    preset: SceneTransitionPreset;
+    /** Overrides the preset default duration in seconds. */
+    duration?: number;
+};
+
 type CubeFaceCode = "f" | "r" | "b" | "l" | "u" | "d";
 type TileAddress = {
     face: CubeFaceCode;
@@ -612,40 +1036,34 @@ type TileProps = {
     onLevelChange?: (level: number) => void;
 };
 
-type PanoramaTransitionPreset = "none" | "crossfade" | "zoom" | "blackout" | "whiteFlash" | "slideRightToLeft" | "slideTopToBottom" | "slideDiagonal" | "circleOpen" | "verticalOpen" | "horizontalOpen" | "ellipticZoomOpen";
-type PanoramaTransition = PanoramaTransitionPreset | {
-    preset: PanoramaTransitionPreset;
-    /** Overrides the KRpano-compatible default duration in seconds. */
-    duration?: number;
-};
-type SpherePanoramaScene = {
+type SphereScene = {
     id: string;
     type: "sphere";
     src: string;
     yawOffset?: number;
 };
-type TilePanoramaScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
+type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
     id: string;
     type: "tile";
 };
-type PanoramaScene = SpherePanoramaScene | TilePanoramaScene;
-type PanoramaTransitionEndEvent = {
+type Scene = SphereScene | TileScene;
+type SceneTransitionEndEvent = {
     previousSceneId: string;
     sceneId: string;
-    preset: PanoramaTransitionPreset;
+    preset: SceneTransitionPreset;
 };
-type PanoramaTransitionErrorEvent = {
+type SceneTransitionErrorEvent = {
     sceneId: string;
     error: unknown;
 };
-type PanoramaScenesProps = {
-    scenes: readonly PanoramaScene[];
+type ScenesProps = {
+    scenes: readonly Scene[];
     activeSceneId: string;
-    transition?: PanoramaTransition;
+    transition?: SceneTransition;
     /** Rendered only after a scene has finished transitioning in. */
-    renderHotspots?: (scene: PanoramaScene) => ReactNode;
-    onTransitionEnd?: (event: PanoramaTransitionEndEvent) => void;
-    onTransitionError?: (event: PanoramaTransitionErrorEvent) => void;
+    renderHotspots?: (scene: Scene) => ReactNode;
+    onTransitionEnd?: (event: SceneTransitionEndEvent) => void;
+    onTransitionError?: (event: SceneTransitionErrorEvent) => void;
     /** Viewer-wide budget shared by every tile scene. Defaults to 128 MiB. */
     maxTextureMemoryMb?: number;
     /** Viewer-wide tile request limit. Defaults to 4. */
@@ -653,7 +1071,7 @@ type PanoramaScenesProps = {
     /** Maximum physical-pixel area of the outgoing GPU snapshot. */
     snapshotMaxPixels?: number;
 };
-declare function PanoramaScenes({ maxTextureMemoryMb, maxConcurrentTileLoads, ...props }: PanoramaScenesProps): react.JSX.Element;
+declare function Scenes({ maxTextureMemoryMb, maxConcurrentTileLoads, ...props }: ScenesProps): react.JSX.Element;
 
 type ImageHotspotProps = HotspotCommonProps & {
     src: string;
@@ -683,6 +1101,10 @@ type PolygonHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "heig
     strokeWidth?: number;
     /** Opacity of the polygon boundary, from 0 to 1. Defaults to 1. */
     strokeOpacity?: number;
+    /** Dash length in CSS pixels. Omit or 0 for a solid stroke. */
+    strokeDashSize?: number;
+    /** Gap length in CSS pixels. Defaults to `strokeDashSize` when dashed. */
+    strokeGapSize?: number;
     onVerticesChange?: (event: PolygonVerticesChangeEvent) => void;
     onDragStart?: (event: PolygonVerticesChangeEvent) => void;
     onDragEnd?: (event: PolygonVerticesChangeEvent) => void;
@@ -693,7 +1115,7 @@ type UnwrappedVertex = HotspotPosition & {
 };
 declare function unwrapPolygonVertices(vertices: HotspotPosition[]): UnwrappedVertex[];
 declare function validatePolygonVertices(vertices: HotspotPosition[]): PolygonValidationIssue[];
-declare function PolygonHotspot({ id, vertices, fill, fillOpacity, stroke, strokeWidth, strokeOpacity, interactive, renderOrder, draggable, onVerticesChange, onDragStart, onDragEnd, onInvalid, ...anchorProps }: PolygonHotspotProps): react.JSX.Element | null;
+declare function PolygonHotspot({ id, vertices, fill, fillOpacity, stroke, strokeWidth, strokeOpacity, strokeDashSize, strokeGapSize, interactive, renderOrder, draggable, onVerticesChange, onDragStart, onDragEnd, onInvalid, ...anchorProps }: PolygonHotspotProps): react.JSX.Element | null;
 
 type PolylineValidationIssue = {
     code: "too_few_vertices";
@@ -712,13 +1134,17 @@ type PolylineHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "hei
     /** Screen-space line width in CSS pixels. Defaults to 2. */
     strokeWidth?: number;
     strokeOpacity?: number;
+    /** Dash length in CSS pixels. Omit or 0 for a solid stroke. */
+    strokeDashSize?: number;
+    /** Gap length in CSS pixels. Defaults to `strokeDashSize` when dashed. */
+    strokeGapSize?: number;
     onVerticesChange?: (event: PolylineVerticesChangeEvent) => void;
     onDragStart?: (event: PolylineVerticesChangeEvent) => void;
     onDragEnd?: (event: PolylineVerticesChangeEvent) => void;
     onInvalid?: (issues: PolylineValidationIssue[]) => void;
 };
 declare function validatePolylineVertices(vertices: HotspotPosition[]): PolylineValidationIssue[];
-declare function PolylineHotspot({ id, vertices, stroke, strokeWidth, strokeOpacity, renderOrder, draggable, onVerticesChange, onDragStart, onDragEnd, onInvalid, ...anchorProps }: PolylineHotspotProps): react.JSX.Element | null;
+declare function PolylineHotspot({ id, vertices, stroke, strokeWidth, strokeOpacity, strokeDashSize, strokeGapSize, renderOrder, draggable, onVerticesChange, onDragStart, onDragEnd, onInvalid, ...anchorProps }: PolylineHotspotProps): react.JSX.Element | null;
 
 type GraphicPaint = {
     fill?: string;
@@ -801,28 +1227,60 @@ type SequenceHotspotProps = HotspotCommonProps & {
 };
 declare function SequenceHotspot({ id, src, frameCount: requestedFrameCount, frameDirection, playing, fps, loop, width, height, opacity, onFrameChange, onLoadProgress, onPlaybackStateChange, onEnded, onError, ...anchorProps }: SequenceHotspotProps): react.JSX.Element;
 
-type VideoPlaybackState = "playing" | "paused" | "ended" | "blocked";
-type VideoHotspotErrorEvent = {
-    id: string;
-    source: "poster" | "video";
-    error: unknown;
+type TextHotspotAlign = "left" | "center" | "right";
+type TextHotspotVerticalAlign = "top" | "middle" | "bottom";
+type TextHotspotWhiteSpace = "normal" | "nowrap";
+type TextHotspotFontStyle = "normal" | "italic";
+/** Serializable typography and panel paint for a text hotspot. */
+type TextHotspotStyle = {
+    fontFamily?: string;
+    /** Canvas pixels. Defaults to 96. */
+    fontSize?: number;
+    /** CSS font-weight. Defaults to 600. */
+    fontWeight?: number | string;
+    /** CSS font-style. Defaults to `"normal"`. */
+    fontStyle?: TextHotspotFontStyle;
+    color?: string;
+    /** CSS color. An empty string skips the panel fill. */
+    background?: string;
+    backgroundOpacity?: number;
+    /** Fraction of the texture's shorter side. */
+    padding?: number;
+    align?: TextHotspotAlign;
+    verticalAlign?: TextHotspotVerticalAlign;
+    lineHeight?: number;
+    whiteSpace?: TextHotspotWhiteSpace;
+    /** Fraction of the texture's shorter side, from 0 to 0.5. */
+    borderRadius?: number;
+    stroke?: string;
+    strokeWidth?: number;
 };
-type VideoHotspotProps = HotspotCommonProps & {
+type TextHotspotProps = HotspotCommonProps & TextHotspotStyle & {
+    text: string;
+    onLoad?: (texture: Texture) => void;
+    onError?: (error: unknown) => void;
+};
+declare function TextHotspot({ text, width, height, opacity, fontFamily, fontSize, fontWeight, fontStyle, color, background, backgroundOpacity, padding, align, verticalAlign, lineHeight, whiteSpace, borderRadius, stroke, strokeWidth, onLoad, onError, ...anchorProps }: TextHotspotProps): react.JSX.Element;
+
+type IframePointerPolicy = "hotspot" | "content";
+type IframeHotspotProps = HotspotCommonProps & {
     src: string;
-    playing: boolean;
-    poster?: string;
-    loop?: boolean;
-    muted?: boolean;
-    volume?: number;
-    playsInline?: boolean;
-    preload?: "none" | "metadata" | "auto";
-    crossOrigin?: "" | "anonymous" | "use-credentials";
-    onPlaybackStateChange?: (state: VideoPlaybackState) => void;
-    onPlaybackError?: (error: unknown) => void;
-    onEnded?: () => void;
-    onError?: (event: VideoHotspotErrorEvent) => void;
+    /** Accessible iframe title. Falls back to ariaLabel. */
+    title?: string;
+    sandbox?: string;
+    allow?: string;
+    referrerPolicy?: IframeHTMLAttributes<HTMLIFrameElement>["referrerPolicy"];
+    loading?: "eager" | "lazy";
+    /**
+     * `hotspot` lets panorama pointer events hit the WebGL plane.
+     * `content` makes the embedded page interactive.
+     */
+    pointerPolicy?: IframePointerPolicy;
+    background?: string;
+    onLoad?: () => void;
+    onError?: (error: unknown) => void;
 };
-declare function VideoHotspot({ id, src, playing, poster, loop, muted, volume, playsInline, preload, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: VideoHotspotProps): react.JSX.Element;
+declare function IframeHotspot({ src, title, sandbox, allow, referrerPolicy, loading, pointerPolicy, background, opacity, width, height, onLoad, onError, interactive, pointerEvents, ...anchorProps }: IframeHotspotProps): react.JSX.Element;
 
 declare function Tile({ baseUrl, multires, previewUrl, previewFaceOrder, urlTemplate, resolveTileUrl, maxTextureMemoryMb, maxConcurrentLoads, retryCount, loadMode, visible, onReady, onPreviewError, onLoadProgress, onTileError, onLevelChange, }: TileProps): react.JSX.Element;
 
@@ -832,6 +1290,9 @@ declare function normalizePanoPosition(position: HotspotPosition): HotspotPositi
 declare function panoPositionToVector3(position: HotspotPosition, radius?: number): Vector3;
 declare function vector3ToPanoPosition(vector: Pick<Vector3, "x" | "y" | "z">): HotspotPosition;
 
+declare const DEFAULT_HOTSPOT_TOOLTIP_OFFSET = 12;
+declare const DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE: Required<HotspotTooltipAppearance>;
+
 /** Shared serializable fields for every saved hotspot definition. */
 type HotspotDefinitionBase = {
     id: string;
@@ -839,7 +1300,16 @@ type HotspotDefinitionBase = {
     label?: string;
     visible?: boolean;
     interactive?: boolean;
+    /** Pointer hit-testing. `"none"` ignores mouse, touch, and pen. */
+    pointerEvents?: HotspotPointerEvents;
+    /** Canvas cursor while this hotspot is hovered. */
+    cursor?: CSSProperties["cursor"];
     renderOrder?: number;
+    tooltip?: string | HotspotTooltipContent;
+    tooltipTrigger?: HotspotTooltipTrigger;
+    tooltipPlacement?: HotspotTooltipPlacement;
+    tooltipOffset?: number;
+    tooltipAppearance?: HotspotTooltipAppearance;
 };
 /** Shared serializable fields for a hotspot anchored at one yaw/pitch point. */
 type PointHotspotDefinitionBase = HotspotDefinitionBase & {
@@ -883,6 +1353,21 @@ type VideoHotspotDefinition = PointHotspotDefinitionBase & {
     preload?: "none" | "metadata" | "auto";
     crossOrigin?: "" | "anonymous" | "use-credentials";
 };
+type TextHotspotDefinition = PointHotspotDefinitionBase & TextHotspotStyle & {
+    type: "text";
+    text: string;
+};
+type IframeHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "iframe";
+    src: string;
+    title?: string;
+    sandbox?: string;
+    allow?: string;
+    referrerPolicy?: string;
+    loading?: "eager" | "lazy";
+    pointerPolicy?: IframePointerPolicy;
+    background?: string;
+};
 type PolygonHotspotDefinition = HotspotDefinitionBase & {
     type: "polygon";
     vertices: HotspotPosition[];
@@ -891,17 +1376,21 @@ type PolygonHotspotDefinition = HotspotDefinitionBase & {
     stroke?: string;
     strokeWidth?: number;
     strokeOpacity?: number;
+    strokeDashSize?: number;
+    strokeGapSize?: number;
 };
-/** An open path. This extends the original five hotspot categories. */
+/** An open path. This extends the original point and polygon hotspot categories. */
 type PolylineHotspotDefinition = HotspotDefinitionBase & {
     type: "polyline";
     vertices: HotspotPosition[];
     stroke?: string;
     strokeWidth?: number;
     strokeOpacity?: number;
+    strokeDashSize?: number;
+    strokeGapSize?: number;
 };
-type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition | SequenceHotspotDefinition | VideoHotspotDefinition;
+type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition | SequenceHotspotDefinition | VideoHotspotDefinition | TextHotspotDefinition | IframeHotspotDefinition;
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
-export { type ArrowGraphic, AutoRotate, type AutoRotateProps, type CircleGraphic, type CubeFaceCode, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPosition, type HotspotScaleMode, 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, 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 PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, type PanoResizeEvent, PanoView, type PanoViewHandle, type PanoViewProps, type PanoViewState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PanoramaScene, PanoramaScenes, type PanoramaScenesProps, type PanoramaTransition, type PanoramaTransitionEndEvent, type PanoramaTransitionErrorEvent, type PanoramaTransitionPreset, 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 SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewOptions, Sphere, type SpherePanoramaScene, type SphereProps, type StarGraphic, type SvgGraphic, type SvgPathGraphic, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TilePanoramaScene, type TileProps, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+export { type ArrowGraphic, AutoRotate, type AutoRotateProps, 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 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 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, 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, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };