@ericchen1990/pano-view 3.4.1 → 3.5.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { CSSProperties, ReactNode, ComponentPropsWithoutRef, RefObject, IframeHTMLAttributes } from 'react';
+import { CSSProperties, ReactNode, ComponentPropsWithoutRef, IframeHTMLAttributes, RefObject } from 'react';
 import { Texture, ColorRepresentation, Vector3 } from 'three';
 
 declare const MAX_HOTSPOT_PITCH = 90;
@@ -229,6 +229,10 @@ type VideoHotspotProps = HotspotCommonProps & {
     loop?: boolean;
     muted?: boolean;
     volume?: number;
+    /**
+     * Keep playback in the page. Defaults to true, including the WebKit and
+     * X5 attributes for iPhone Safari, WeChat, QQ, and UC.
+     */
     playsInline?: boolean;
     preload?: "none" | "metadata" | "auto";
     crossOrigin?: "" | "anonymous" | "use-credentials";
@@ -801,342 +805,80 @@ declare const PanoViewer: react.ForwardRefExoticComponent<Omit<Omit<react.Detail
     dpr?: number | [number, number];
 } & react.RefAttributes<PanoViewerHandle>>;
 
-/** Options for automatic horizontal panorama rotation. */
-type AutoRotateProps = {
-    /** Whether automatic rotation is active. Defaults to true. */
-    enabled?: boolean;
-    /** Rotation speed in degrees per second. Negative values rotate left. */
-    speed?: number;
-    /**
-     * Rate at which rotation reaches its target speed, in degrees per second
-     * squared. Use 0 to disable the speed ramp. Defaults to 18.
-     */
-    acceleration?: number;
-    /** Milliseconds to wait after enabling before rotation begins. */
-    startDelay?: number;
-};
-/**
- * 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;
-
-type AudioPlaybackState = "playing" | "paused" | "ended" | "blocked";
-type AudioHotspotErrorEvent = {
-    id: string;
-    error: unknown;
-};
-type AudioHotspotProps = HotspotCommonProps & {
-    src: string | string[];
-    playing: boolean;
-    loop?: boolean;
-    muted?: boolean;
-    volume?: number;
-    /** Degrees of look-away before the source is silent. Defaults to 360 (no look attenuation). */
-    range?: number;
-    pauseWhenHidden?: boolean;
-    /** Optional stopped-state image. When omitted, a built-in speaker icon is used. */
-    icon?: string;
-    /** Optional playing-state image. Falls back to `icon`, then the built-in playing icon. */
-    playingIcon?: string;
-    /** When false, no visual marker is rendered. Audio still plays. Defaults to true. */
-    marker?: boolean;
-    crossOrigin?: "" | "anonymous" | "use-credentials";
-    onPlaybackStateChange?: (state: AudioPlaybackState) => void;
-    onPlaybackError?: (error: unknown) => void;
-    onEnded?: () => void;
-    onError?: (event: AudioHotspotErrorEvent) => void;
-};
-declare function AudioHotspot({ id, src, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
+type PanoDataErrorCode = "INVALID_OPTIONS" | "FETCH_FAILED" | "HTTP_ERROR" | "INVALID_JSON" | "INVALID_CONFIG" | "UNSUPPORTED_SCHEMA_VERSION" | "UNSUPPORTED_PROJECTION" | "INVALID_PROJECT" | "INVALID_REFERENCE" | "ABORTED";
+declare class PanoDataError extends Error {
+    readonly code: PanoDataErrorCode;
+    readonly status?: number;
+    readonly sceneId?: string;
+    readonly field?: string;
+    readonly cause?: unknown;
+    constructor(code: PanoDataErrorCode, message: string, details?: {
+        status?: number;
+        sceneId?: string;
+        field?: string;
+        cause?: unknown;
+    });
+}
 
-type BackgroundAudioSource = string | readonly string[];
-type BackgroundAudioErrorEvent = {
-    error: unknown;
+/** The portable rendering contract shared by the converter and browser viewer. */
+type ViewerCubeFace = "f" | "r" | "b" | "l" | "u" | "d";
+type CubemapViewerConfig = {
+    type: "tile";
+    multires: {
+        tileSize: number;
+        levels: number[];
+    };
+    urlTemplate: string;
+    previewUrl: string;
+    previewFaceOrder: ViewerCubeFace[];
 };
-type BackgroundAudioProps = {
-    /** Shared tour track when `sources` is omitted, or fallback when a scene has no entry. */
-    src?: BackgroundAudioSource;
-    /** Per-scene tracks keyed by `Scene.id`. Requires `sceneId`. */
-    sources?: Readonly<Record<string, BackgroundAudioSource>>;
-    /** Current scene id. Required when `sources` is set. */
-    sceneId?: string;
-    /**
-     * Controlled playing state. When provided, the parent owns play/pause.
-     * When omitted, the component manages its own state and imperative
-     * `playBackgroundAudio` / `pauseBackgroundAudio` work directly.
-     */
-    playing?: boolean;
-    /** Initial playing state when `playing` is omitted. Defaults to false. */
-    defaultPlaying?: boolean;
-    /** Defaults to true. */
-    loop?: boolean;
-    muted?: boolean;
-    volume?: number;
-    pauseWhenHidden?: boolean;
-    /** Crossfade duration when the resolved track changes. Defaults to 400; 0 is a hard cut. */
-    fadeMs?: number;
-    crossOrigin?: "" | "anonymous" | "use-credentials";
-    onPlaybackStateChange?: (state: AudioPlaybackState) => void;
-    onPlaybackError?: (error: unknown) => void;
-    onEnded?: () => void;
-    onError?: (event: BackgroundAudioErrorEvent) => void;
+type SphereViewerConfig = {
+    type: "sphereTile";
+    multires: {
+        tileSize: number;
+        levels: {
+            width: number;
+            height: number;
+        }[];
+    };
+    urlTemplate: string;
+    previewUrl: string;
+    indexBase: 0 | 1;
 };
-/**
- * Adds a non-spatial soundtrack to the nearest PanoViewer. Render one instance
- * as a child of PanoViewer, alongside Scenes or a panorama source — not inside
- * renderHotspots.
- */
-declare function BackgroundAudio({ src, sources, sceneId, playing: controlledPlaying, defaultPlaying, loop, muted, volume, pauseWhenHidden, fadeMs, crossOrigin, onPlaybackStateChange, onPlaybackError, onEnded, onError, }: BackgroundAudioProps): 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];
-/** Row-major 4×5 RGBA matrix, applied in display (sRGB) space like an SVG color matrix. */
-type PanoColorMatrix = readonly [
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number,
-    number
-];
-
-type PanoFilterProps = {
-    /** Built-in look. Defaults to `none` (identity). */
-    preset?: PanoFilterPreset;
-    /** Mix with the original panorama, 0–1. Defaults to 1. */
-    intensity?: number;
-    /** Display-space RGBA matrix applied after the artistic preset. */
-    colorMatrix?: PanoColorMatrix | null;
-    /** `all` also filters hotspot textures. HTML tooltips/chrome remain host-styled. */
-    colorMatrixScope?: "panorama" | "all";
-    /** When false, the panorama renders without a filter. Defaults to true. */
-    enabled?: boolean;
+type ViewerConfig = CubemapViewerConfig | SphereViewerConfig;
+type ViewerDocument = ViewerConfig & {
+    schemaVersion: 1;
 };
-/**
- * Applies a color or artistic filter to the panorama source of the nearest
- * PanoViewer. Render one instance as a child of PanoViewer. colorMatrixScope
- * can include hotspot textures; HTML chrome remains host-styled.
- */
-declare function PanoFilter({ preset, intensity, enabled, colorMatrix, colorMatrixScope, }: 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;
+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;
 };
-/**
- * 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>>;
-
-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). */
-    delta: number;
-    nativeEvent: WheelEvent;
-};
-type PanoResizeEvent = {
+type CubeFaceCode = "f" | "r" | "b" | "l" | "u" | "d";
+type TileAddress = {
+    face: CubeFaceCode;
+    level: number;
+    row: number;
+    col: number;
+    faceSize: number;
+    tileSize: number;
     width: number;
     height: number;
 };
-type ViewInteractionEvent = {
-    source: ViewInteractionSource;
+type TileMultiresConfig = {
+    tileSize: number;
+    /** Ascending face sizes. The first value maps to l1. */
+    levels: number[];
 };
-type PanoEventMap = {
-    viewchange: PanoViewerState;
-    viewsettled: PanoViewerState;
-    viewinteractionstart: ViewInteractionEvent;
-    viewinteractionend: ViewInteractionEvent;
-    click: PanoramaPointerEvent;
-    doubleclick: PanoramaPointerEvent;
-    pointerdown: PanoramaPointerEvent;
-    pointerup: PanoramaPointerEvent;
-    pointermove: PanoramaPointerEvent;
-    contextmenu: PanoramaPointerEvent;
-    wheel: PanoWheelEvent;
-    idle: undefined;
-    idleend: undefined;
-    enterfullscreen: undefined;
-    exitfullscreen: undefined;
-    resize: PanoResizeEvent;
-    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;
-type PanoEventBus = {
-    subscribe: <T extends PanoEventType>(type: T, listener: PanoEventListener<T>) => () => void;
-    emit: <T extends PanoEventType>(type: T, payload: PanoEventMap[T]) => void;
-};
-
-type PanoEventsProps = {
-    /**
-     * Milliseconds without user interaction before `onIdle`. Defaults to 2000.
-     * Each PanoEvents instance tracks idle independently.
-     */
-    idleTime?: number;
-    onViewChange?: (view: PanoViewerState) => void;
-    onViewSettled?: (view: PanoViewerState) => void;
-    onViewInteractionStart?: (event: ViewInteractionEvent) => void;
-    onViewInteractionEnd?: (event: ViewInteractionEvent) => void;
-    onClick?: (event: PanoramaPointerEvent) => void;
-    onDoubleClick?: (event: PanoramaPointerEvent) => void;
-    onPointerDown?: (event: PanoramaPointerEvent) => void;
-    onPointerUp?: (event: PanoramaPointerEvent) => void;
-    onPointerMove?: (event: PanoramaPointerEvent) => void;
-    onContextMenu?: (event: PanoramaPointerEvent) => void;
-    onWheel?: (event: PanoWheelEvent) => void;
-    onIdle?: () => void;
-    onIdleEnd?: () => void;
-    onEnterFullscreen?: () => void;
-    onExitFullscreen?: () => void;
-    onResize?: (event: PanoResizeEvent) => void;
-    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, 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.
- */
-declare function PanoEvents(props: PanoEventsProps): null;
-
-type UsePanoViewerResult = PanoViewerHandle & {
-    ref: RefObject<PanoViewerHandle | null>;
-};
-declare function usePanoViewer(): UsePanoViewerResult;
-
-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 PanoViewer from
-     * `controls.fovSpeed`.
-     */
-    fovSpeed?: number;
-};
-/**
- * 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 PanoViewer.
- * Enabled by default; render this component only to override properties.
- */
-declare function TouchControls({ enabled, rotateSpeed, invert, pinchZoom, }: TouchControlsProps): null;
-
-type CubeFaceCode = "f" | "r" | "b" | "l" | "u" | "d";
-type TileAddress = {
-    face: CubeFaceCode;
-    level: number;
-    row: number;
-    col: number;
-    faceSize: number;
-    tileSize: number;
-    width: number;
-    height: number;
-};
-type TileMultiresConfig = {
-    tileSize: number;
-    /** Ascending face sizes. The first value maps to l1. */
-    levels: number[];
-};
-type TileLoadProgress = {
-    requested: number;
-    loaded: number;
-    failed: number;
-    active: number;
-    queued: number;
+type TileLoadProgress = {
+    requested: number;
+    loaded: number;
+    failed: number;
+    active: number;
+    queued: number;
 };
 type TileLoadError = {
     address: TileAddress;
@@ -1171,7 +913,7 @@ type TileProps = {
      * 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`. */
+    /** Returns a relative path or absolute URL; takes precedence over `urlTemplate`. */
     resolveTileUrl?: (address: TileAddress) => string;
     maxTextureMemoryMb?: number;
     maxConcurrentLoads?: number;
@@ -1249,95 +991,6 @@ type SphereTileProps = {
     onLevelChange?: (level: number) => void;
 };
 
-declare function SphereTile({ multires, ...props }: SphereTileProps): react.JSX.Element;
-
-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 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 SphereScene = {
     id: string;
     type: "sphere";
@@ -1407,95 +1060,34 @@ type ScenesProps = {
 };
 declare function Scenes({ maxTextureMemoryMb, maxConcurrentTileLoads, activeSceneId: controlledId, defaultActiveSceneId, onActiveSceneIdChange, scenes, ...rest }: ScenesProps): react.JSX.Element;
 
-type ScenesController = {
-    setScene: (id: string) => boolean;
-    nextScene: () => boolean;
-    previousScene: () => boolean;
-    getActiveSceneId: () => string;
-    getSceneIds: () => readonly string[];
-    isTransitioning: () => boolean;
-};
-
-type ImageHotspotProps = HotspotCommonProps & {
-    src: string;
-    onLoad?: (texture: Texture) => void;
-    onError?: (error: unknown) => void;
+type AssetUrlContext = {
+    defaultUrl: string;
+    kind: "tile" | "preview" | "hotspot";
+    sceneId: string;
+    hotspotId?: string;
 };
-declare function ImageHotspot({ src, width, height, opacity, onLoad, onError, ...anchorProps }: ImageHotspotProps): react.JSX.Element;
-
-type PolygonValidationCode = "too_few_vertices" | "self_intersection" | "contains_pole" | "outside_hemisphere";
-type PolygonValidationIssue = {
-    code: PolygonValidationCode;
-    message: string;
+type AssetUrlResolver = (path: string, context: AssetUrlContext) => string;
+type JsonRequestOptions = {
+    requestInit?: Pick<RequestInit, "headers" | "credentials" | "signal">;
 };
-type PolygonVerticesChangeEvent = {
+type SceneFromViewerConfigOptions = {
     id: string;
-    vertices: HotspotPosition[];
-    startVertices: HotspotPosition[];
-    position: HotspotPosition;
-    startPosition: HotspotPosition;
-};
-type PolygonHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "height" | "scale" | "mode" | "distance" | "scaleMode" | "rotation" | "onDragStart" | "onPositionChange" | "onDragEnd"> & {
-    vertices: HotspotPosition[];
-    fill?: ColorRepresentation;
-    fillOpacity?: number;
-    stroke?: ColorRepresentation;
-    /** Screen-space border width in CSS pixels. Defaults to 2. */
-    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;
-    onInvalid?: (issues: PolygonValidationIssue[]) => void;
+    baseUrl: string;
+    resolveAssetUrl?: AssetUrlResolver;
 };
-type UnwrappedVertex = HotspotPosition & {
-    unwrappedYaw: number;
+type LoadSceneFromJsonOptions = Omit<SceneFromViewerConfigOptions, "baseUrl"> & JsonRequestOptions & {
+    baseUrl?: string;
 };
-declare function unwrapPolygonVertices(vertices: HotspotPosition[]): UnwrappedVertex[];
-declare function validatePolygonVertices(vertices: HotspotPosition[]): PolygonValidationIssue[];
-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;
+declare function sceneFromViewerConfig(value: unknown, options: SceneFromViewerConfigOptions): TileScene | SphereTileScene;
+declare function loadSceneFromJson(url: string, options: LoadSceneFromJsonOptions): Promise<TileScene | SphereTileScene>;
 
-type PolylineValidationIssue = {
-    code: "too_few_vertices";
-    message: string;
+type GraphicPaint = {
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
 };
-type PolylineVerticesChangeEvent = {
-    id: string;
-    vertices: HotspotPosition[];
-    startVertices: HotspotPosition[];
-    position: HotspotPosition;
-    startPosition: HotspotPosition;
-};
-type PolylineHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "height" | "scale" | "mode" | "distance" | "scaleMode" | "rotation" | "onDragStart" | "onPositionChange" | "onDragEnd"> & {
-    vertices: HotspotPosition[];
-    stroke?: ColorRepresentation;
-    /** 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, strokeDashSize, strokeGapSize, renderOrder, draggable, onVerticesChange, onDragStart, onDragEnd, onInvalid, ...anchorProps }: PolylineHotspotProps): react.JSX.Element | null;
-
-type GraphicPaint = {
-    fill?: string;
-    stroke?: string;
-    strokeWidth?: number;
-};
-type CircleGraphic = GraphicPaint & {
-    kind: "circle";
+type CircleGraphic = GraphicPaint & {
+    kind: "circle";
 };
 type TriangleGraphic = GraphicPaint & {
     kind: "triangle";
@@ -1535,40 +1127,25 @@ type GraphicHotspotProps = HotspotCommonProps & {
 };
 declare function GraphicHotspot(props: GraphicHotspotProps): react.JSX.Element;
 
-type SequenceFrameDirection = "horizontal" | "vertical";
-type SequenceLoadProgress = {
-    id: string;
-    total: number;
-    loaded: number;
-    failed: number;
-};
-type SequenceFrameEvent = {
-    id: string;
-    index: number;
-    src: string;
-};
-type SequencePlaybackState = "playing" | "paused" | "ended";
-type SequenceHotspotErrorEvent = {
-    id: string;
-    src: string;
-    error: unknown;
-};
-type SequenceHotspotProps = HotspotCommonProps & {
-    /** A sprite sheet containing each frame in equally sized cells. */
+type IframePointerPolicy = "hotspot" | "content";
+type IframeHotspotProps = HotspotCommonProps & {
     src: string;
-    /** Number of cells in the sprite sheet, from left-to-right or top-to-bottom. */
-    frameCount: number;
-    frameDirection?: SequenceFrameDirection;
-    playing: boolean;
-    fps?: number;
-    loop?: boolean;
-    onFrameChange?: (event: SequenceFrameEvent) => void;
-    onLoadProgress?: (progress: SequenceLoadProgress) => void;
-    onPlaybackStateChange?: (state: SequencePlaybackState) => void;
-    onEnded?: () => void;
-    onError?: (event: SequenceHotspotErrorEvent) => 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 SequenceHotspot({ id, src, frameCount: requestedFrameCount, frameDirection, playing, fps, loop, width, height, opacity, onFrameChange, onLoadProgress, onPlaybackStateChange, onEnded, onError, ...anchorProps }: SequenceHotspotProps): 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;
 
 type TextHotspotAlign = "left" | "center" | "right";
 type TextHotspotVerticalAlign = "top" | "middle" | "bottom";
@@ -1605,37 +1182,6 @@ type TextHotspotProps = HotspotCommonProps & TextHotspotStyle & {
 };
 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;
-    /** 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 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;
-
-declare function normalizePanoYaw(yaw: number): number;
-declare function clampPanoPitch(pitch: number): number;
-declare function normalizePanoPosition(position: HotspotPosition): HotspotPosition;
-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;
@@ -1750,4 +1296,608 @@ type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
-export { type ArrowGraphic, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, type PanoViewEasing, type PanoViewLookToOptions, type PanoViewNavigationOptions, type PanoViewNavigationResult, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type Scene, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+type ProjectHotspotDefinition = HotspotDefinition & {
+    action?: {
+        type: "scene";
+        sceneId: string;
+    };
+};
+
+type PanoProjectSceneDefinition = {
+    id: string;
+    title?: string;
+    source: ({
+        viewerUrl: string;
+        viewerConfig?: never;
+    } | {
+        viewerConfig: ViewerConfig;
+        viewerUrl?: never;
+    }) & {
+        baseUrl?: string;
+    };
+    initialView?: Partial<PanoViewerState>;
+    hotspots?: ProjectHotspotDefinition[];
+};
+type PanoProjectDefinition = {
+    schemaVersion: 1;
+    title?: string;
+    initialSceneId?: string;
+    scenes: PanoProjectSceneDefinition[];
+};
+type LoadedProjectScene = {
+    scene: TileScene | SphereTileScene;
+    title?: string;
+    initialView?: PanoViewerState;
+    hotspots: ProjectHotspotDefinition[];
+};
+type LoadedPanoProject = {
+    title?: string;
+    initialSceneId: string;
+    scenes: LoadedProjectScene[];
+};
+type LoadPanoProjectOptions = JsonRequestOptions & {
+    /** Directory used for project-relative references. Required for object input. */
+    baseUrl?: string;
+    resolveAssetUrl?: AssetUrlResolver;
+};
+declare function parsePanoProject(value: unknown): PanoProjectDefinition;
+declare function loadPanoProject(source: string | PanoProjectDefinition, options?: LoadPanoProjectOptions): Promise<LoadedPanoProject>;
+
+type ProjectHotspotClickEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    interaction: HotspotInteractionEvent;
+    defaultPrevented: boolean;
+    preventDefault: () => void;
+};
+type ProjectHotspotErrorEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    error: unknown;
+};
+type ProjectHotspotRenderContext = {
+    sceneId: string;
+    playing: boolean;
+    onClick: (event: HotspotInteractionEvent) => void;
+    togglePlayback: () => void;
+    reportError: (error: unknown) => void;
+    renderDefault: () => ReactNode;
+};
+type ProjectScenesProps = Omit<ScenesProps, "scenes" | "defaultActiveSceneId" | "renderHotspots"> & {
+    project: LoadedPanoProject;
+    onHotspotClick?: (event: ProjectHotspotClickEvent) => void;
+    onHotspotError?: (event: ProjectHotspotErrorEvent) => void;
+    /** Return undefined for the default renderer, or null to hide this hotspot. */
+    renderHotspot?: (hotspot: ProjectHotspotDefinition, context: ProjectHotspotRenderContext) => ReactNode;
+};
+declare function ProjectScenes({ project, activeSceneId, onActiveSceneIdChange, onSceneReady, onHotspotClick, onHotspotError, renderHotspot, ...options }: ProjectScenesProps): react.JSX.Element;
+
+/** Options for automatic horizontal panorama rotation. */
+type AutoRotateProps = {
+    /** Whether automatic rotation is active. Defaults to true. */
+    enabled?: boolean;
+    /** Rotation speed in degrees per second. Negative values rotate left. */
+    speed?: number;
+    /**
+     * Rate at which rotation reaches its target speed, in degrees per second
+     * squared. Use 0 to disable the speed ramp. Defaults to 18.
+     */
+    acceleration?: number;
+    /** Milliseconds to wait after enabling before rotation begins. */
+    startDelay?: number;
+};
+/**
+ * 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;
+
+type AudioPlaybackState = "playing" | "paused" | "ended" | "blocked";
+type AudioHotspotErrorEvent = {
+    id: string;
+    error: unknown;
+};
+type AudioHotspotProps = HotspotCommonProps & {
+    src: string | string[];
+    playing: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    volume?: number;
+    /** Degrees of look-away before the source is silent. Defaults to 360 (no look attenuation). */
+    range?: number;
+    pauseWhenHidden?: boolean;
+    /** Optional stopped-state image. When omitted, a built-in speaker icon is used. */
+    icon?: string;
+    /** Optional playing-state image. Falls back to `icon`, then the built-in playing icon. */
+    playingIcon?: string;
+    /** When false, no visual marker is rendered. Audio still plays. Defaults to true. */
+    marker?: boolean;
+    crossOrigin?: "" | "anonymous" | "use-credentials";
+    onPlaybackStateChange?: (state: AudioPlaybackState) => void;
+    onPlaybackError?: (error: unknown) => void;
+    onEnded?: () => void;
+    onError?: (event: AudioHotspotErrorEvent) => void;
+};
+declare function AudioHotspot({ id, src, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
+
+type BackgroundAudioSource = string | readonly string[];
+type BackgroundAudioErrorEvent = {
+    error: unknown;
+};
+type BackgroundAudioProps = {
+    /** Shared tour track when `sources` is omitted, or fallback when a scene has no entry. */
+    src?: BackgroundAudioSource;
+    /** Per-scene tracks keyed by `Scene.id`. Requires `sceneId`. */
+    sources?: Readonly<Record<string, BackgroundAudioSource>>;
+    /** Current scene id. Required when `sources` is set. */
+    sceneId?: string;
+    /**
+     * Controlled playing state. When provided, the parent owns play/pause.
+     * When omitted, the component manages its own state and imperative
+     * `playBackgroundAudio` / `pauseBackgroundAudio` work directly.
+     */
+    playing?: boolean;
+    /** Initial playing state when `playing` is omitted. Defaults to false. */
+    defaultPlaying?: boolean;
+    /** Defaults to true. */
+    loop?: boolean;
+    muted?: boolean;
+    volume?: number;
+    pauseWhenHidden?: boolean;
+    /** Crossfade duration when the resolved track changes. Defaults to 400; 0 is a hard cut. */
+    fadeMs?: number;
+    crossOrigin?: "" | "anonymous" | "use-credentials";
+    onPlaybackStateChange?: (state: AudioPlaybackState) => void;
+    onPlaybackError?: (error: unknown) => void;
+    onEnded?: () => void;
+    onError?: (event: BackgroundAudioErrorEvent) => void;
+};
+/**
+ * Adds a non-spatial soundtrack to the nearest PanoViewer. Render one instance
+ * as a child of PanoViewer, alongside Scenes or a panorama source — not inside
+ * renderHotspots.
+ */
+declare function BackgroundAudio({ src, sources, sceneId, playing: controlledPlaying, defaultPlaying, loop, muted, volume, pauseWhenHidden, fadeMs, crossOrigin, onPlaybackStateChange, onPlaybackError, onEnded, onError, }: BackgroundAudioProps): 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];
+/** Row-major 4×5 RGBA matrix, applied in display (sRGB) space like an SVG color matrix. */
+type PanoColorMatrix = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+
+type PanoFilterProps = {
+    /** Built-in look. Defaults to `none` (identity). */
+    preset?: PanoFilterPreset;
+    /** Mix with the original panorama, 0–1. Defaults to 1. */
+    intensity?: number;
+    /** Display-space RGBA matrix applied after the artistic preset. */
+    colorMatrix?: PanoColorMatrix | null;
+    /** `all` also filters hotspot textures. HTML tooltips/chrome remain host-styled. */
+    colorMatrixScope?: "panorama" | "all";
+    /** 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. colorMatrixScope
+ * can include hotspot textures; HTML chrome remains host-styled.
+ */
+declare function PanoFilter({ preset, intensity, enabled, colorMatrix, colorMatrixScope, }: 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>>;
+
+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). */
+    delta: number;
+    nativeEvent: WheelEvent;
+};
+type PanoResizeEvent = {
+    width: number;
+    height: number;
+};
+type ViewInteractionEvent = {
+    source: ViewInteractionSource;
+};
+type PanoEventMap = {
+    viewchange: PanoViewerState;
+    viewsettled: PanoViewerState;
+    viewinteractionstart: ViewInteractionEvent;
+    viewinteractionend: ViewInteractionEvent;
+    click: PanoramaPointerEvent;
+    doubleclick: PanoramaPointerEvent;
+    pointerdown: PanoramaPointerEvent;
+    pointerup: PanoramaPointerEvent;
+    pointermove: PanoramaPointerEvent;
+    contextmenu: PanoramaPointerEvent;
+    wheel: PanoWheelEvent;
+    idle: undefined;
+    idleend: undefined;
+    enterfullscreen: undefined;
+    exitfullscreen: undefined;
+    resize: PanoResizeEvent;
+    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;
+type PanoEventBus = {
+    subscribe: <T extends PanoEventType>(type: T, listener: PanoEventListener<T>) => () => void;
+    emit: <T extends PanoEventType>(type: T, payload: PanoEventMap[T]) => void;
+};
+
+type PanoEventsProps = {
+    /**
+     * Milliseconds without user interaction before `onIdle`. Defaults to 2000.
+     * Each PanoEvents instance tracks idle independently.
+     */
+    idleTime?: number;
+    onViewChange?: (view: PanoViewerState) => void;
+    onViewSettled?: (view: PanoViewerState) => void;
+    onViewInteractionStart?: (event: ViewInteractionEvent) => void;
+    onViewInteractionEnd?: (event: ViewInteractionEvent) => void;
+    onClick?: (event: PanoramaPointerEvent) => void;
+    onDoubleClick?: (event: PanoramaPointerEvent) => void;
+    onPointerDown?: (event: PanoramaPointerEvent) => void;
+    onPointerUp?: (event: PanoramaPointerEvent) => void;
+    onPointerMove?: (event: PanoramaPointerEvent) => void;
+    onContextMenu?: (event: PanoramaPointerEvent) => void;
+    onWheel?: (event: PanoWheelEvent) => void;
+    onIdle?: () => void;
+    onIdleEnd?: () => void;
+    onEnterFullscreen?: () => void;
+    onExitFullscreen?: () => void;
+    onResize?: (event: PanoResizeEvent) => void;
+    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, 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.
+ */
+declare function PanoEvents(props: PanoEventsProps): null;
+
+type UsePanoViewerResult = PanoViewerHandle & {
+    ref: RefObject<PanoViewerHandle | null>;
+};
+declare function usePanoViewer(): UsePanoViewerResult;
+
+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 PanoViewer from
+     * `controls.fovSpeed`.
+     */
+    fovSpeed?: number;
+};
+/**
+ * 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 PanoViewer.
+ * Enabled by default; render this component only to override properties.
+ */
+declare function TouchControls({ enabled, rotateSpeed, invert, pinchZoom, }: TouchControlsProps): null;
+
+declare function SphereTile({ multires, ...props }: SphereTileProps): react.JSX.Element;
+
+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 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;
+    /**
+     * Keep playback in the page. Defaults to true, including the WebKit and
+     * X5 attributes for iPhone Safari, WeChat, QQ, and UC.
+     */
+    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 ScenesController = {
+    setScene: (id: string) => boolean;
+    nextScene: () => boolean;
+    previousScene: () => boolean;
+    getActiveSceneId: () => string;
+    getSceneIds: () => readonly string[];
+    isTransitioning: () => boolean;
+};
+
+type ImageHotspotProps = HotspotCommonProps & {
+    src: string;
+    onLoad?: (texture: Texture) => void;
+    onError?: (error: unknown) => void;
+};
+declare function ImageHotspot({ src, width, height, opacity, onLoad, onError, ...anchorProps }: ImageHotspotProps): react.JSX.Element;
+
+type PolygonValidationCode = "too_few_vertices" | "self_intersection" | "contains_pole" | "outside_hemisphere";
+type PolygonValidationIssue = {
+    code: PolygonValidationCode;
+    message: string;
+};
+type PolygonVerticesChangeEvent = {
+    id: string;
+    vertices: HotspotPosition[];
+    startVertices: HotspotPosition[];
+    position: HotspotPosition;
+    startPosition: HotspotPosition;
+};
+type PolygonHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "height" | "scale" | "mode" | "distance" | "scaleMode" | "rotation" | "onDragStart" | "onPositionChange" | "onDragEnd"> & {
+    vertices: HotspotPosition[];
+    fill?: ColorRepresentation;
+    fillOpacity?: number;
+    stroke?: ColorRepresentation;
+    /** Screen-space border width in CSS pixels. Defaults to 2. */
+    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;
+    onInvalid?: (issues: PolygonValidationIssue[]) => void;
+};
+type UnwrappedVertex = HotspotPosition & {
+    unwrappedYaw: number;
+};
+declare function unwrapPolygonVertices(vertices: HotspotPosition[]): UnwrappedVertex[];
+declare function validatePolygonVertices(vertices: HotspotPosition[]): PolygonValidationIssue[];
+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";
+    message: string;
+};
+type PolylineVerticesChangeEvent = {
+    id: string;
+    vertices: HotspotPosition[];
+    startVertices: HotspotPosition[];
+    position: HotspotPosition;
+    startPosition: HotspotPosition;
+};
+type PolylineHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "height" | "scale" | "mode" | "distance" | "scaleMode" | "rotation" | "onDragStart" | "onPositionChange" | "onDragEnd"> & {
+    vertices: HotspotPosition[];
+    stroke?: ColorRepresentation;
+    /** 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, strokeDashSize, strokeGapSize, renderOrder, draggable, onVerticesChange, onDragStart, onDragEnd, onInvalid, ...anchorProps }: PolylineHotspotProps): react.JSX.Element | null;
+
+type SequenceFrameDirection = "horizontal" | "vertical";
+type SequenceLoadProgress = {
+    id: string;
+    total: number;
+    loaded: number;
+    failed: number;
+};
+type SequenceFrameEvent = {
+    id: string;
+    index: number;
+    src: string;
+};
+type SequencePlaybackState = "playing" | "paused" | "ended";
+type SequenceHotspotErrorEvent = {
+    id: string;
+    src: string;
+    error: unknown;
+};
+type SequenceHotspotProps = HotspotCommonProps & {
+    /** A sprite sheet containing each frame in equally sized cells. */
+    src: string;
+    /** Number of cells in the sprite sheet, from left-to-right or top-to-bottom. */
+    frameCount: number;
+    frameDirection?: SequenceFrameDirection;
+    playing: boolean;
+    fps?: number;
+    loop?: boolean;
+    onFrameChange?: (event: SequenceFrameEvent) => void;
+    onLoadProgress?: (progress: SequenceLoadProgress) => void;
+    onPlaybackStateChange?: (state: SequencePlaybackState) => void;
+    onEnded?: () => void;
+    onError?: (event: SequenceHotspotErrorEvent) => void;
+};
+declare function SequenceHotspot({ id, src, frameCount: requestedFrameCount, frameDirection, playing, fps, loop, width, height, opacity, onFrameChange, onLoadProgress, onPlaybackStateChange, onEnded, onError, ...anchorProps }: SequenceHotspotProps): 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;
+
+declare function normalizePanoYaw(yaw: number): number;
+declare function clampPanoPitch(pitch: number): number;
+declare function normalizePanoPosition(position: HotspotPosition): HotspotPosition;
+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>;
+
+export { type ArrowGraphic, type AssetUrlContext, type AssetUrlResolver, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, type CubemapViewerConfig, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type JsonRequestOptions, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, PanoDataError, type PanoDataErrorCode, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, type PanoViewEasing, type PanoViewLookToOptions, type PanoViewNavigationOptions, type PanoViewNavigationResult, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type ProjectHotspotClickEvent, type ProjectHotspotDefinition, type ProjectHotspotErrorEvent, type ProjectHotspotRenderContext, ProjectScenes, type ProjectScenesProps, type RectangleGraphic, type RingGraphic, type Scene, type SceneFromViewerConfigOptions, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type SphereViewerConfig, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, type ViewerConfig, type ViewerDocument, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parsePanoProject, resolvePanoContextMenuEntries, sceneFromViewerConfig, unwrapPolygonVertices, usePanoEvents, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };