@ericchen1990/pano-view 1.0.0 → 2.1.0

package/dist/index.d.mts

@@ -31,6 +31,11 @@ type HotspotDragEvent = HotspotInteractionEvent & {
 };
 /** 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. */
@@ -39,6 +44,16 @@ type HotspotTooltipContent = {
     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;
@@ -47,15 +62,17 @@ type HotspotCommonProps = {
      * Defaults to always visible when content is present.
      */
     tooltip?: string | HotspotTooltipContent;
-    /** Defaults to `"always"`. `"hover"` and `"click"` require `interactive`. */
+    /** Defaults to `"always"`. `"hover"` and `"click"` require `interactive` and `pointerEvents` other than `"none"`. */
     tooltipTrigger?: HotspotTooltipTrigger;
-    /** Defaults to `"top"`. */
+    /** 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. */
@@ -80,6 +97,12 @@ 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"`).
@@ -145,7 +168,8 @@ declare function cycleSceneId(scenes: readonly {
  * 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.
+ * 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;
 
@@ -493,6 +517,150 @@ type AutoRotateProps = {
  */
 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). */
@@ -526,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;
@@ -559,12 +744,23 @@ 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 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 PanoViewer.
  * Multiple instances may coexist; each tracks its own idle timer.
@@ -594,14 +790,197 @@ declare function TouchControls({ enabled, rotateSpeed, invert, pinchZoom, }: Tou
 
 type SphereProps = {
     src: string;
+    /**
+     * Low-resolution 2:1 equirectangular image shown while `src` loads.
+     * Relative paths resolve against the directory of `src`. Root-absolute and
+     * `http(s)` / `blob:` / `data:` URLs are used as-is. For krpano sphere
+     * scenes, copy `<preview url>`.
+     */
+    previewUrl: string;
     /** Horizontal image offset in degrees. */
     yawOffset?: number;
+    /** Called once the first paintable texture (preview or `src`) is ready. */
+    onReady?: () => void;
     onLoad?: (texture: Texture) => void;
     onError?: (error: unknown) => void;
+    /** Called when `previewUrl` cannot be loaded; `src` still continues. */
+    onPreviewError?: (error: unknown) => void;
+    /** Keeps the source mounted for preloading without drawing it. */
+    visible?: boolean;
+};
+declare function Sphere({ src, previewUrl, yawOffset, onReady, onLoad, onError, onPreviewError, 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;
 };
-declare function Sphere({ src, yawOffset, onLoad, onError, visible, }: SphereProps): react.JSX.Element | null;
 
 type CubeFaceCode = "f" | "r" | "b" | "l" | "u" | "d";
 type TileAddress = {
@@ -633,18 +1012,30 @@ type TileLoadError = {
 };
 type TileProps = {
     baseUrl: string;
+    /**
+     * Tile size followed by ascending cube-face sizes (`TILESIZE,LEVELSIZE1,...`).
+     * For krpano output, copy `image.cube.multires` from the XML.
+     */
     multires: string | TileMultiresConfig;
-    /** Defaults to `${baseUrl}/previews/cube-vertical.webp`. */
-    previewUrl?: string | null;
+    /**
+     * Preview atlas path. Relative paths resolve against `baseUrl`; root-absolute
+     * and `http(s)` / `blob:` / `data:` URLs are used as-is. For krpano output,
+     * copy `<preview url>` (often `preview.jpg` at the scene root). This package's
+     * common cube atlas path is `previews/cube-vertical.webp`.
+     */
+    previewUrl: string;
     /**
      * Face order in the vertical preview atlas, from top to bottom. Defaults to
-     * `l/f/r/b/u/d`.
+     * `l/f/r/b/u/d`, matching krpano `preview.striporder` `LFRBUD`.
      */
     previewFaceOrder?: readonly CubeFaceCode[];
     /**
-     * Relative to `baseUrl`; supports krpano cube-tile `%s` and `%l` placeholders,
-     * horizontal `%h`/`%x`/`%u`/`%c`, vertical `%v`/`%y`/`%w`/`%r`, and index padding
-     * such as `%0h` or `%00v`.
+     * Path relative to `baseUrl`. Defaults to
+     * `tiles/%s/l%l/%v/l%l_%s_%h_%v.webp`. For krpano output, copy `<cube url>`
+     * from the XML; krpano templates often use `%v_%h` instead of this default
+     * `%h_%v`, so omitting `urlTemplate` requests the wrong files. Supports
+     * krpano cube-tile `%s` and `%l` placeholders, horizontal `%h`/`%x`/`%u`/`%c`,
+     * vertical `%v`/`%y`/`%w`/`%r`, and index padding such as `%0h` or `%00v`.
      */
     urlTemplate?: string;
     /** Returns a path relative to `baseUrl`; takes precedence over `urlTemplate`. */
@@ -668,16 +1059,11 @@ type TileProps = {
     onLevelChange?: (level: number) => void;
 };
 
-type SceneTransitionPreset = "none" | "crossfade" | "zoom" | "blackout" | "whiteFlash" | "slideRightToLeft" | "slideTopToBottom" | "slideDiagonal" | "circleOpen" | "verticalOpen" | "horizontalOpen" | "ellipticZoomOpen";
-type SceneTransition = SceneTransitionPreset | {
-    preset: SceneTransitionPreset;
-    /** Overrides the KRpano-compatible default duration in seconds. */
-    duration?: number;
-};
 type SphereScene = {
     id: string;
     type: "sphere";
     src: string;
+    previewUrl: string;
     yawOffset?: number;
 };
 type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
@@ -739,6 +1125,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;
@@ -749,7 +1139,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";
@@ -768,13 +1158,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;
@@ -857,29 +1251,6 @@ 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 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 TextHotspotAlign = "left" | "center" | "right";
 type TextHotspotVerticalAlign = "top" | "middle" | "bottom";
 type TextHotspotWhiteSpace = "normal" | "nowrap";
@@ -887,9 +1258,11 @@ type TextHotspotFontStyle = "normal" | "italic";
 /** Serializable typography and panel paint for a text hotspot. */
 type TextHotspotStyle = {
     fontFamily?: string;
-    /** Fraction of the texture height. Defaults to 0.18. */
+    /** 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. */
@@ -931,7 +1304,7 @@ type IframeHotspotProps = HotspotCommonProps & {
     onLoad?: () => void;
     onError?: (error: unknown) => void;
 };
-declare function IframeHotspot({ src, title, sandbox, allow, referrerPolicy, loading, pointerPolicy, background, opacity, width, height, onLoad, onError, ...anchorProps }: IframeHotspotProps): 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;
 
@@ -942,6 +1315,7 @@ declare function panoPositionToVector3(position: HotspotPosition, radius?: numbe
 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 = {
@@ -950,6 +1324,8 @@ 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;
@@ -957,6 +1333,7 @@ type HotspotDefinitionBase = {
     tooltipTrigger?: HotspotTooltipTrigger;
     tooltipPlacement?: HotspotTooltipPlacement;
     tooltipOffset?: number;
+    tooltipAppearance?: HotspotTooltipAppearance;
 };
 /** Shared serializable fields for a hotspot anchored at one yaw/pitch point. */
 type PointHotspotDefinitionBase = HotspotDefinitionBase & {
@@ -1023,6 +1400,8 @@ type PolygonHotspotDefinition = HotspotDefinitionBase & {
     stroke?: string;
     strokeWidth?: number;
     strokeOpacity?: number;
+    strokeDashSize?: number;
+    strokeGapSize?: number;
 };
 /** An open path. This extends the original point and polygon hotspot categories. */
 type PolylineHotspotDefinition = HotspotDefinitionBase & {
@@ -1031,9 +1410,11 @@ type PolylineHotspotDefinition = HotspotDefinitionBase & {
     stroke?: string;
     strokeWidth?: number;
     strokeOpacity?: number;
+    strokeDashSize?: number;
+    strokeGapSize?: number;
 };
 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, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, 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, 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, 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, type PanoResizeEvent, 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, 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 };