@ericchen1990/pano-view 3.4.2 → 3.6.0

package/dist/index.d.ts

@@ -1,7 +1,23 @@
 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';
 
+/** Camera-center limits in degrees. A yaw min greater than max crosses ±180°. */
+type PanoViewLimits = {
+    yaw?: {
+        min: number;
+        max: number;
+    };
+    pitch?: {
+        min: number;
+        max: number;
+    };
+    fov?: {
+        min: number;
+        max: number;
+    };
+};
+
 declare const MAX_HOTSPOT_PITCH = 90;
 type HotspotPosition = {
     /** Horizontal panorama angle in degrees. Positive values look right. */
@@ -100,6 +116,8 @@ type HotspotCommonProps = {
     opacity?: number;
     renderOrder?: number;
     visible?: boolean;
+    /** Show a 3px selection border around a point hotspot. Defaults to false. */
+    selected?: boolean;
     /** Whether the hotspot accepts pointer and keyboard interaction. Defaults to true. */
     interactive?: boolean;
     /**
@@ -736,9 +754,40 @@ type PanoCursors = {
 };
 declare const DEFAULT_PANO_CURSORS: Required<PanoCursors>;
 
+type PanoOverlayRenderContext = {
+    /** Stable viewer-local portal target; null until the DOM has mounted. */
+    portalContainer: HTMLDivElement | null;
+    /** Available viewer space in CSS pixels, independent of nested portal targets. */
+    size: {
+        width: number;
+        height: number;
+    };
+    /** Screen-visible part of the viewer, in viewer-local CSS pixels. */
+    visibleRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    isFullscreen: boolean;
+};
+/** Read inside PanoViewer.renderOverlay or its DOM descendants. */
+declare function usePanoOverlay(): PanoOverlayRenderContext;
+/** Coordinate a custom modal with viewer inputs. Accessibility stays with the modal. */
+declare function usePanoModal(open: boolean): void;
+/** Keep nested portals inside the active dialog's interactive subtree. */
+declare function PanoOverlayPortalProvider({ container, children, }: {
+    container: HTMLDivElement | null;
+    children: ReactNode;
+}): react.JSX.Element;
+
 type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
+    /** Viewer-local DOM UI, rendered outside the Three.js tree, including in fullscreen. */
+    renderOverlay?: (context: PanoOverlayRenderContext) => ReactNode;
     initialView?: Partial<PanoViewerState>;
+    /** Camera-center limits; scene limits override individual axes. */
+    viewLimits?: PanoViewLimits;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
@@ -772,7 +821,11 @@ type PanoViewerProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onCha
 };
 declare const PanoViewer: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
+    /** Viewer-local DOM UI, rendered outside the Three.js tree, including in fullscreen. */
+    renderOverlay?: (context: PanoOverlayRenderContext) => ReactNode;
     initialView?: Partial<PanoViewerState>;
+    /** Camera-center limits; scene limits override individual axes. */
+    viewLimits?: PanoViewLimits;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
@@ -805,185 +858,836 @@ 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 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 AudioPlaybackState = "playing" | "paused" | "ended" | "blocked";
-type AudioHotspotErrorEvent = {
-    id: string;
-    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 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;
+type SphereViewerConfig = {
+    type: "sphereTile";
+    multires: {
+        tileSize: number;
+        levels: {
+            width: number;
+            height: number;
+        }[];
+    };
+    urlTemplate: string;
+    previewUrl: string;
+    indexBase: 0 | 1;
+};
+type ViewerConfig = CubemapViewerConfig | SphereViewerConfig;
+type ViewerDocument = ViewerConfig & {
+    schemaVersion: 1;
 };
-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 = {
+type SceneTransitionPreset = "none" | "crossfade" | "zoom" | "blackout" | "whiteFlash" | "slideRightToLeft" | "slideTopToBottom" | "slideDiagonal" | "circleOpen" | "verticalOpen" | "horizontalOpen" | "ellipticZoomOpen" | "pixelate" | "gridWipe" | "gridWipeUp" | "gridWipeRight" | "gridWipeDiagonal" | "gridWipeCenter" | "gridWipeChecker" | "dissolve" | "shatter" | "particles" | "glitch" | "swirl" | "clockWipe" | "ripple" | "zoomBlur" | "hexDissolve" | "filmBurn";
+type SceneTransition = SceneTransitionPreset | {
+    preset: SceneTransitionPreset;
+    /** Overrides the preset default duration in seconds. */
+    duration?: number;
+};
+
+type CubeFaceCode = "f" | "r" | "b" | "l" | "u" | "d";
+type TileAddress = {
+    face: CubeFaceCode;
+    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 TileLoadError = {
+    address: TileAddress;
+    url: string;
     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;
+type TileProps = {
+    baseUrl: 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.
+     * Tile size followed by ascending cube-face sizes (`TILESIZE,LEVELSIZE1,...`).
+     * For krpano output, copy `image.cube.multires` from the XML.
      */
-    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;
+    multires: string | TileMultiresConfig;
     /**
-     * Requests iOS sensor permission. Call this directly from a user gesture
-     * before setting `enabled` to true.
+     * 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`.
      */
-    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;
+    previewUrl: string;
+    /**
+     * Face order in the vertical preview atlas, from top to bottom. Defaults to
+     * `l/f/r/b/u/d`, matching krpano `preview.striporder` `LFRBUD`.
+     */
+    previewFaceOrder?: readonly CubeFaceCode[];
+    /**
+     * 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 relative path or absolute URL; takes precedence over `urlTemplate`. */
+    resolveTileUrl?: (address: TileAddress) => string;
+    maxTextureMemoryMb?: number;
+    maxConcurrentLoads?: number;
+    retryCount?: number;
+    /**
+     * `preview` loads only the preview atlas; `base` also preloads the visible
+     * lowest-resolution tiles before full-resolution loading begins.
+     */
+    loadMode?: "full" | "preview" | "base";
+    /** Keeps the source mounted for preloading without drawing it. */
+    visible?: boolean;
+    /** Called when the preview atlas is ready for display. */
+    onReady?: () => void;
+    /** Called when the preview atlas cannot be loaded. */
+    onPreviewError?: (error: unknown) => void;
+    onLoadProgress?: (progress: TileLoadProgress) => void;
+    onTileError?: (event: TileLoadError) => void;
+    onLevelChange?: (level: number) => 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>;
+type SphereTileLevel = {
+    width: number;
+    height: number;
+};
+type SphereTileMultiresConfig = {
+    tileSize: number;
+    /** Ascending image dimensions. The first item maps to level 0. */
+    levels: SphereTileLevel[];
+};
+type SphereTileAddress = {
+    /** Zero-based logical level, column and row; URL indices add indexBase. */
+    level: number;
+    col: number;
+    row: number;
+    imageWidth: number;
+    imageHeight: number;
+    tileSize: number;
+    /** Actual tile dimensions, including partial edge tiles. */
+    width: number;
+    height: number;
+};
+type SphereTileLoadError = {
+    address: SphereTileAddress;
+    url: string;
+    error: unknown;
+};
+type SphereTileProps = {
+    baseUrl: string;
+    /** `512,500x250,1000x500,2000x1000` or explicit ascending dimensions. */
+    multires: string | SphereTileMultiresConfig;
+    /** A 2:1 equirectangular preview, resolved relative to baseUrl. */
+    previewUrl: string;
+    /** Defaults to `tiles/%l/%h_%v.webp`. No tile overlap. */
+    urlTemplate?: string;
+    /** URL indices start at 1 for krpano (default), or 0 for raw Sharp Deep Zoom. */
+    indexBase?: 0 | 1;
+    /** Takes precedence over urlTemplate and indexBase. Receives zero-based addresses. */
+    resolveTileUrl?: (address: SphereTileAddress) => string;
+    /** Horizontal source rotation in degrees. Defaults to 0. */
+    yawOffset?: number;
+    /** Tile cache budget in MiB. Defaults to 128. Preview memory is separate. */
+    maxTextureMemoryMb?: number;
+    /** Defaults to 4. */
+    maxConcurrentLoads?: number;
+    /** Retries after the initial attempt. Defaults to 1. */
+    retryCount?: number;
+    loadMode?: "full" | "preview" | "base";
+    visible?: boolean;
+    /** First paintable preview or tile is ready, even if the preview failed. */
+    onReady?: () => void;
+    onPreviewError?: (error: unknown) => void;
+    onLoadProgress?: (progress: TileLoadProgress) => void;
+    onTileError?: (event: SphereTileLoadError) => void;
+    /** Zero-based selected level. */
+    onLevelChange?: (level: number) => void;
+};
+
+type SceneViewOptions = {
+    viewLimits?: PanoViewLimits;
+};
+type SphereScene = SceneViewOptions & {
+    id: string;
+    type: "sphere";
+    src: string;
+    previewUrl: string;
+    yawOffset?: number;
+};
+type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & SceneViewOptions & {
+    id: string;
+    type: "tile";
+};
+type SphereTileScene = Omit<SphereTileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & SceneViewOptions & {
+    id: string;
+    type: "sphereTile";
+};
+type Scene = SphereScene | TileScene | SphereTileScene;
+type SceneTransitionEndEvent = {
+    previousSceneId: string;
+    sceneId: string;
+    preset: SceneTransitionPreset;
+};
+type SceneTransitionErrorEvent = {
+    sceneId: string;
+    error: unknown;
+};
+type ScenesProps = {
+    scenes: readonly Scene[];
+    /**
+     * Controlled scene id. When provided, the parent owns the active scene.
+     * Imperative `setScene` / `nextScene` / `previousScene` will call
+     * `onActiveSceneIdChange` so the parent can update its state.
+     */
+    activeSceneId?: string;
+    /**
+     * Uncontrolled initial scene id. Used when `activeSceneId` is omitted.
+     * Imperative calls update the internal state directly.
+     */
+    defaultActiveSceneId?: string;
+    /** Called when imperative scene methods request a scene change in controlled mode. */
+    onActiveSceneIdChange?: (id: string) => void;
+    transition?: SceneTransition;
+    /** Rendered only after a scene has finished transitioning in. */
+    renderHotspots?: (scene: Scene) => ReactNode;
+    /** First paintable scene, or an incoming scene taking over after snapshot capture.
+     * The transition may still be running, and full detail may still be loading.
+     * Safe to apply the incoming camera view here.
+     */
+    onSceneReady?: (sceneId: string) => void;
+    /**
+     * Extra milliseconds to hold the outgoing snapshot after it is captured and the
+     * incoming scene has switched to full detail. `0` (default) starts the blend
+     * immediately and keeps loading detail during it. A positive value starts the
+     * blend early when the current view is already sharp, otherwise it waits at
+     * most this long. The wait is separate from the blend duration. Negative and
+     * non-finite values are treated as `0`. `transition="none"` cuts over directly
+     * once the same condition is met.
+     */
+    transitionWaitForDetailMs?: number;
+    onTransitionEnd?: (event: SceneTransitionEndEvent) => void;
+    onTransitionError?: (event: SceneTransitionErrorEvent) => void;
+    /** Viewer-wide budget shared by every tile scene. Defaults to 128 MiB. */
+    maxTextureMemoryMb?: number;
+    /** Viewer-wide tile request limit. Defaults to 4. */
+    maxConcurrentTileLoads?: number;
+    /** Maximum physical-pixel area of the outgoing GPU snapshot. */
+    snapshotMaxPixels?: number;
+};
+declare function Scenes({ maxTextureMemoryMb, maxConcurrentTileLoads, activeSceneId: controlledId, defaultActiveSceneId, onActiveSceneIdChange, scenes, ...rest }: ScenesProps): react.JSX.Element;
+
+type AssetUrlContext = {
+    defaultUrl: string;
+    kind: "tile" | "preview" | "hotspot";
+    sceneId: string;
+    hotspotId?: string;
+};
+type AssetUrlResolver = (path: string, context: AssetUrlContext) => string;
+type JsonRequestOptions = {
+    requestInit?: Pick<RequestInit, "headers" | "credentials" | "signal">;
+};
+type SceneFromViewerConfigOptions = {
+    id: string;
+    baseUrl: string;
+    resolveAssetUrl?: AssetUrlResolver;
+};
+type LoadSceneFromJsonOptions = Omit<SceneFromViewerConfigOptions, "baseUrl"> & JsonRequestOptions & {
+    baseUrl?: string;
+};
+declare function sceneFromViewerConfig(value: unknown, options: SceneFromViewerConfigOptions): TileScene | SphereTileScene;
+declare function loadSceneFromJson(url: string, options: LoadSceneFromJsonOptions): Promise<TileScene | SphereTileScene>;
+
+type ProjectPopupBlock = {
+    id: string;
+} & ({
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    src: string;
+    alt?: string;
+} | {
+    type: "video";
+    src: string;
+    poster?: string;
+} | {
+    type: "audio";
+    src: string;
+});
+type ProjectPopupDefinition = {
+    id: string;
+    title: string;
+    blocks: ProjectPopupBlock[];
+};
+type PopupAssetUrlContext = {
+    defaultUrl: string;
+    popupId: string;
+    blockId: string;
+    field: "src" | "poster";
+};
+type PopupAssetUrlResolver = (path: string, context: PopupAssetUrlContext) => string;
+declare function resolveProjectPopupAssets(popup: ProjectPopupDefinition, baseUrl: string, resolver?: PopupAssetUrlResolver): ProjectPopupDefinition;
+
+type GraphicPaint = {
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+};
+type CircleGraphic = GraphicPaint & {
+    kind: "circle";
+};
+type TriangleGraphic = GraphicPaint & {
+    kind: "triangle";
+};
+type DiamondGraphic = GraphicPaint & {
+    kind: "diamond";
+};
+type StarGraphic = GraphicPaint & {
+    kind: "star";
+};
+type ArrowGraphic = GraphicPaint & {
+    kind: "arrow";
+};
+type RectangleGraphic = GraphicPaint & {
+    kind: "rectangle";
+    /** Relative radius from 0 (square corners) to 0.5 (maximum rounded corners). */
+    cornerRadius?: number;
+};
+type RingGraphic = GraphicPaint & {
+    kind: "ring";
+    innerRadius?: number;
+};
+type SvgGraphic = {
+    kind: "svg";
+    src: string;
+};
+type SvgPathGraphic = GraphicPaint & {
+    kind: "path";
+    path: string;
+    viewBox: [x: number, y: number, width: number, height: number];
+};
+type GraphicDefinition = CircleGraphic | TriangleGraphic | DiamondGraphic | StarGraphic | ArrowGraphic | RectangleGraphic | RingGraphic | SvgGraphic | SvgPathGraphic;
+type GraphicHotspotProps = HotspotCommonProps & {
+    graphic: GraphicDefinition;
+    onLoad?: (texture: Texture) => void;
+    onError?: (error: unknown) => void;
+};
+declare function GraphicHotspot(props: GraphicHotspotProps): 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;
+
+type TextHotspotAlign = "left" | "center" | "right";
+type TextHotspotVerticalAlign = "top" | "middle" | "bottom";
+type TextHotspotWhiteSpace = "normal" | "nowrap";
+type TextHotspotFontStyle = "normal" | "italic";
+/** Serializable typography and panel paint for a text hotspot. */
+type TextHotspotStyle = {
+    fontFamily?: string;
+    /** Canvas pixels. Defaults to 96. */
+    fontSize?: number;
+    /** CSS font-weight. Defaults to 600. */
+    fontWeight?: number | string;
+    /** CSS font-style. Defaults to `"normal"`. */
+    fontStyle?: TextHotspotFontStyle;
+    color?: string;
+    /** CSS color. An empty string skips the panel fill. */
+    background?: string;
+    backgroundOpacity?: number;
+    /** Fraction of the texture's shorter side. */
+    padding?: number;
+    align?: TextHotspotAlign;
+    verticalAlign?: TextHotspotVerticalAlign;
+    lineHeight?: number;
+    whiteSpace?: TextHotspotWhiteSpace;
+    /** Fraction of the texture's shorter side, from 0 to 0.5. */
+    borderRadius?: number;
+    stroke?: string;
+    strokeWidth?: number;
+};
+type TextHotspotProps = HotspotCommonProps & TextHotspotStyle & {
+    text: string;
+    onLoad?: (texture: Texture) => void;
+    onError?: (error: unknown) => void;
+};
+declare function TextHotspot({ text, width, height, opacity, fontFamily, fontSize, fontWeight, fontStyle, color, background, backgroundOpacity, padding, align, verticalAlign, lineHeight, whiteSpace, borderRadius, stroke, strokeWidth, onLoad, onError, ...anchorProps }: TextHotspotProps): react.JSX.Element;
+
+/** Shared serializable fields for every saved hotspot definition. */
+type HotspotDefinitionBase = {
+    id: string;
+    /** Human-readable label; use it as the source for the rendered ariaLabel. */
+    label?: string;
+    visible?: boolean;
+    interactive?: boolean;
+    /** Pointer hit-testing. `"none"` ignores mouse, touch, and pen. */
+    pointerEvents?: HotspotPointerEvents;
+    /** Canvas cursor while this hotspot is hovered. */
+    cursor?: CSSProperties["cursor"];
+    renderOrder?: number;
+    tooltip?: string | HotspotTooltipContent;
+    tooltipTrigger?: HotspotTooltipTrigger;
+    tooltipPlacement?: HotspotTooltipPlacement;
+    tooltipOffset?: number;
+    tooltipAppearance?: HotspotTooltipAppearance;
+};
+/** Shared serializable fields for a hotspot anchored at one yaw/pitch point. */
+type PointHotspotDefinitionBase = HotspotDefinitionBase & {
+    position: HotspotPosition;
+    width?: number;
+    height?: number;
+    scale?: number;
+    mode?: HotspotMode;
+    distance?: number;
+    scaleMode?: HotspotScaleMode;
+    referenceFov?: number;
+    rotation?: number;
+    opacity?: number;
+};
+type ImageHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "image";
+    src: string;
+};
+type GraphicHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "graphic";
+    graphic: GraphicDefinition;
+};
+type SequenceHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "sequence";
+    src: string;
+    frameCount: number;
+    frameDirection?: "horizontal" | "vertical";
+    playing?: boolean;
+    fps?: number;
+    loop?: boolean;
+};
+type VideoHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "video";
+    src: string;
+    poster?: string;
+    playing?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    volume?: number;
+    playsInline?: boolean;
+    preload?: "none" | "metadata" | "auto";
+    crossOrigin?: "" | "anonymous" | "use-credentials";
+};
+type AudioHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "audio";
+    src: string | string[];
+    format?: string | string[];
+    playing?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    volume?: number;
+    pauseWhenHidden?: boolean;
+    range?: number;
+    icon?: string;
+    playingIcon?: string;
+    marker?: boolean;
+    crossOrigin?: "" | "anonymous" | "use-credentials";
+};
+type TextHotspotDefinition = PointHotspotDefinitionBase & TextHotspotStyle & {
+    type: "text";
+    text: string;
+};
+type IframeHotspotDefinition = PointHotspotDefinitionBase & {
+    type: "iframe";
+    src: string;
+    title?: string;
+    sandbox?: string;
+    allow?: string;
+    referrerPolicy?: string;
+    loading?: "eager" | "lazy";
+    pointerPolicy?: IframePointerPolicy;
+    background?: string;
+};
+type PolygonHotspotDefinition = HotspotDefinitionBase & {
+    type: "polygon";
+    vertices: HotspotPosition[];
+    fill?: string;
+    fillOpacity?: number;
+    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 & {
+    type: "polyline";
+    vertices: HotspotPosition[];
+    stroke?: string;
+    strokeWidth?: number;
+    strokeOpacity?: number;
+    strokeDashSize?: number;
+    strokeGapSize?: number;
+};
+type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition | SequenceHotspotDefinition | VideoHotspotDefinition | AudioHotspotDefinition | TextHotspotDefinition | IframeHotspotDefinition;
+/** A serializable, discriminated hotspot collection item. */
+type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
+
+type JsonValue = null | boolean | number | string | JsonValue[] | JsonObject;
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+declare const projectHotspotTriggers: readonly ["click", "pointerenter", "pointerleave"];
+type ProjectHotspotTrigger = typeof projectHotspotTriggers[number];
+type ProjectCustomHotspotAction = {
+    type: "custom";
+    actionId: string;
+    params?: JsonObject;
+};
+declare function hotspotAction(hotspot: ProjectHotspotDefinition, trigger: ProjectHotspotTrigger): ProjectHotspotAction | undefined;
+declare function setHotspotAction(hotspot: ProjectHotspotDefinition, trigger: ProjectHotspotTrigger, action?: ProjectHotspotAction): ProjectHotspotDefinition;
+type ProjectHotspotAction = ProjectCustomHotspotAction | {
+    type: "scene";
+    sceneId: string;
+} | {
+    type: "view";
+    view: PanoViewerState;
+    duration?: number;
+} | {
+    type: "popup";
+    popupId: string;
+};
+type ProjectHotspotDefinition = HotspotDefinition & {
+    /** Legacy click fallback. events.click takes precedence. */
+    action?: ProjectHotspotAction;
+    events?: Partial<Record<ProjectHotspotTrigger, ProjectHotspotAction>>;
+};
+declare function resolveHotspotAssets(hotspot: ProjectHotspotDefinition, baseUrl: string, sceneId: string, resolver?: AssetUrlResolver): ProjectHotspotDefinition;
+
+type PanoProjectSceneDefinition = {
+    id: string;
+    title?: string;
+    source: ({
+        viewerUrl: string;
+        viewerConfig?: never;
+    } | {
+        viewerConfig: ViewerConfig;
+        viewerUrl?: never;
+    }) & {
+        baseUrl?: string;
+    };
+    initialView?: Partial<PanoViewerState>;
+    viewLimits?: PanoViewLimits;
+    hotspots?: ProjectHotspotDefinition[];
+};
+type PanoProjectDefinition = {
+    schemaVersion: 1;
+    title?: string;
+    initialSceneId?: string;
+    scenes: PanoProjectSceneDefinition[];
+    popups?: ProjectPopupDefinition[];
+};
+type LoadedProjectScene = {
+    scene: TileScene | SphereTileScene;
+    title?: string;
+    initialView?: PanoViewerState;
+    hotspots: ProjectHotspotDefinition[];
+};
+type LoadedPanoProject = {
+    title?: string;
+    initialSceneId: string;
+    scenes: LoadedProjectScene[];
+    popups?: ProjectPopupDefinition[];
+};
+type LoadPanoProjectOptions = JsonRequestOptions & {
+    /** Directory used for project-relative references. Required for object input. */
+    baseUrl?: string;
+    resolveAssetUrl?: AssetUrlResolver;
+    resolvePopupAssetUrl?: PopupAssetUrlResolver;
+};
+/** Drafts permit empty scenes and unfinished popup titles/media; loading and export always validate strictly. */
+declare function parsePanoProject(value: unknown, options?: {
+    draft?: boolean;
+}): PanoProjectDefinition;
+declare function loadPanoProject(source: string | PanoProjectDefinition, options?: LoadPanoProjectOptions): Promise<LoadedPanoProject>;
+
+type ProjectHotspotClickEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    interaction: HotspotInteractionEvent;
+    defaultPrevented: boolean;
+    preventDefault: () => void;
+};
+type ProjectHotspotEvent = ProjectHotspotClickEvent & {
+    trigger: ProjectHotspotTrigger;
+};
+type ProjectCustomActionEvent = ProjectHotspotEvent & {
+    action: ProjectCustomHotspotAction;
+};
+type ProjectPopupRequestEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    popup: ProjectPopupDefinition;
+};
+type ProjectHotspotErrorEvent = {
+    sceneId: string;
+    hotspot: ProjectHotspotDefinition;
+    error: unknown;
+    trigger?: ProjectHotspotTrigger;
+};
+type ProjectHotspotRenderContext = {
+    sceneId: string;
+    playing: boolean;
+    onClick: (event: HotspotInteractionEvent) => void;
+    onHoverChange: (hovered: boolean, event: HotspotInteractionEvent) => void;
+    togglePlayback: () => void;
+    reportError: (error: unknown) => void;
+    renderDefault: () => ReactNode;
+};
+type ProjectScenesProps = Omit<ScenesProps, "scenes" | "defaultActiveSceneId" | "renderHotspots"> & {
+    project: LoadedPanoProject;
+    onHotspotEvent?: (event: ProjectHotspotEvent) => void;
+    onCustomAction?: (event: ProjectCustomActionEvent) => void | Promise<void>;
+    onHotspotClick?: (event: ProjectHotspotClickEvent) => void;
+    onPopupRequest?: (event: ProjectPopupRequestEvent) => void;
+    onHotspotError?: (event: ProjectHotspotErrorEvent) => void;
+    /** Return undefined for the default renderer, or null to hide this hotspot. */
+    renderHotspot?: (hotspot: ProjectHotspotDefinition, context: ProjectHotspotRenderContext) => ReactNode;
+};
+declare function ProjectScenes({ project, activeSceneId, onActiveSceneIdChange, onSceneReady, onHotspotClick, onHotspotEvent, onHotspotError, onPopupRequest, onCustomAction, 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[];
+    /** Container hints for extensionless sources such as blob URLs, in source order. */
+    format?: 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, format, playing, loop, muted, volume, range, pauseWhenHidden, icon, playingIcon, marker, crossOrigin, width, height, opacity, onPlaybackStateChange, onPlaybackError, onEnded, onError, ...anchorProps }: AudioHotspotProps): react.JSX.Element;
+
+type BackgroundAudioSource = string | readonly string[];
+type BackgroundAudioErrorEvent = {
+    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;
 
@@ -1119,140 +1823,6 @@ type TouchControlsProps = TouchControlsOptions;
  */
 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 TileLoadError = {
-    address: TileAddress;
-    url: string;
-    error: unknown;
-};
-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;
-    /**
-     * 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`, matching krpano `preview.striporder` `LFRBUD`.
-     */
-    previewFaceOrder?: readonly CubeFaceCode[];
-    /**
-     * 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`. */
-    resolveTileUrl?: (address: TileAddress) => string;
-    maxTextureMemoryMb?: number;
-    maxConcurrentLoads?: number;
-    retryCount?: number;
-    /**
-     * `preview` loads only the preview atlas; `base` also preloads the visible
-     * lowest-resolution tiles before full-resolution loading begins.
-     */
-    loadMode?: "full" | "preview" | "base";
-    /** Keeps the source mounted for preloading without drawing it. */
-    visible?: boolean;
-    /** Called when the preview atlas is ready for display. */
-    onReady?: () => void;
-    /** Called when the preview atlas cannot be loaded. */
-    onPreviewError?: (error: unknown) => void;
-    onLoadProgress?: (progress: TileLoadProgress) => void;
-    onTileError?: (event: TileLoadError) => void;
-    onLevelChange?: (level: number) => void;
-};
-
-type SphereTileLevel = {
-    width: number;
-    height: number;
-};
-type SphereTileMultiresConfig = {
-    tileSize: number;
-    /** Ascending image dimensions. The first item maps to level 0. */
-    levels: SphereTileLevel[];
-};
-type SphereTileAddress = {
-    /** Zero-based logical level, column and row; URL indices add indexBase. */
-    level: number;
-    col: number;
-    row: number;
-    imageWidth: number;
-    imageHeight: number;
-    tileSize: number;
-    /** Actual tile dimensions, including partial edge tiles. */
-    width: number;
-    height: number;
-};
-type SphereTileLoadError = {
-    address: SphereTileAddress;
-    url: string;
-    error: unknown;
-};
-type SphereTileProps = {
-    baseUrl: string;
-    /** `512,500x250,1000x500,2000x1000` or explicit ascending dimensions. */
-    multires: string | SphereTileMultiresConfig;
-    /** A 2:1 equirectangular preview, resolved relative to baseUrl. */
-    previewUrl: string;
-    /** Defaults to `tiles/%l/%h_%v.webp`. No tile overlap. */
-    urlTemplate?: string;
-    /** URL indices start at 1 for krpano (default), or 0 for raw Sharp Deep Zoom. */
-    indexBase?: 0 | 1;
-    /** Takes precedence over urlTemplate and indexBase. Receives zero-based addresses. */
-    resolveTileUrl?: (address: SphereTileAddress) => string;
-    /** Horizontal source rotation in degrees. Defaults to 0. */
-    yawOffset?: number;
-    /** Tile cache budget in MiB. Defaults to 128. Preview memory is separate. */
-    maxTextureMemoryMb?: number;
-    /** Defaults to 4. */
-    maxConcurrentLoads?: number;
-    /** Retries after the initial attempt. Defaults to 1. */
-    retryCount?: number;
-    loadMode?: "full" | "preview" | "base";
-    visible?: boolean;
-    /** First paintable preview or tile is ready, even if the preview failed. */
-    onReady?: () => void;
-    onPreviewError?: (error: unknown) => void;
-    onLoadProgress?: (progress: TileLoadProgress) => void;
-    onTileError?: (event: SphereTileLoadError) => void;
-    /** Zero-based selected level. */
-    onLevelChange?: (level: number) => void;
-};
-
 declare function SphereTile({ multires, ...props }: SphereTileProps): react.JSX.Element;
 
 type SphereProps = {
@@ -1306,114 +1876,38 @@ type PanoVideoProps = {
      * 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 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";
-    src: string;
-    previewUrl: string;
-    yawOffset?: number;
-};
-type TileScene = Omit<TileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
-    id: string;
-    type: "tile";
-};
-type SphereTileScene = Omit<SphereTileProps, "loadMode" | "visible" | "onReady" | "onPreviewError" | "onLoadProgress" | "onTileError" | "onLevelChange"> & {
-    id: string;
-    type: "sphereTile";
-};
-type Scene = SphereScene | TileScene | SphereTileScene;
-type SceneTransitionEndEvent = {
-    previousSceneId: string;
-    sceneId: string;
-    preset: SceneTransitionPreset;
-};
-type SceneTransitionErrorEvent = {
-    sceneId: string;
-    error: unknown;
-};
-type ScenesProps = {
-    scenes: readonly Scene[];
-    /**
-     * Controlled scene id. When provided, the parent owns the active scene.
-     * Imperative `setScene` / `nextScene` / `previousScene` will call
-     * `onActiveSceneIdChange` so the parent can update its state.
-     */
-    activeSceneId?: string;
-    /**
-     * Uncontrolled initial scene id. Used when `activeSceneId` is omitted.
-     * Imperative calls update the internal state directly.
-     */
-    defaultActiveSceneId?: string;
-    /** Called when imperative scene methods request a scene change in controlled mode. */
-    onActiveSceneIdChange?: (id: string) => void;
-    transition?: SceneTransition;
-    /** Rendered only after a scene has finished transitioning in. */
-    renderHotspots?: (scene: Scene) => ReactNode;
-    /** First paintable scene, or an incoming scene taking over after snapshot capture.
-     * The transition may still be running, and full detail may still be loading.
-     * Safe to apply the incoming camera view here.
-     */
-    onSceneReady?: (sceneId: string) => void;
-    /**
-     * Extra milliseconds to hold the outgoing snapshot after it is captured and the
-     * incoming scene has switched to full detail. `0` (default) starts the blend
-     * immediately and keeps loading detail during it. A positive value starts the
-     * blend early when the current view is already sharp, otherwise it waits at
-     * most this long. The wait is separate from the blend duration. Negative and
-     * non-finite values are treated as `0`. `transition="none"` cuts over directly
-     * once the same condition is met.
-     */
-    transitionWaitForDetailMs?: number;
-    onTransitionEnd?: (event: SceneTransitionEndEvent) => void;
-    onTransitionError?: (event: SceneTransitionErrorEvent) => void;
-    /** Viewer-wide budget shared by every tile scene. Defaults to 128 MiB. */
-    maxTextureMemoryMb?: number;
-    /** Viewer-wide tile request limit. Defaults to 4. */
-    maxConcurrentTileLoads?: number;
-    /** Maximum physical-pixel area of the outgoing GPU snapshot. */
-    snapshotMaxPixels?: number;
+    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;
 };
-declare function Scenes({ maxTextureMemoryMb, maxConcurrentTileLoads, activeSceneId: controlledId, defaultActiveSceneId, onActiveSceneIdChange, scenes, ...rest }: ScenesProps): react.JSX.Element;
+/**
+ * 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;
@@ -1497,52 +1991,6 @@ type PolylineHotspotProps = Omit<HotspotCommonProps, "position" | "width" | "hei
 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 TriangleGraphic = GraphicPaint & {
-    kind: "triangle";
-};
-type DiamondGraphic = GraphicPaint & {
-    kind: "diamond";
-};
-type StarGraphic = GraphicPaint & {
-    kind: "star";
-};
-type ArrowGraphic = GraphicPaint & {
-    kind: "arrow";
-};
-type RectangleGraphic = GraphicPaint & {
-    kind: "rectangle";
-    /** Relative radius from 0 (square corners) to 0.5 (maximum rounded corners). */
-    cornerRadius?: number;
-};
-type RingGraphic = GraphicPaint & {
-    kind: "ring";
-    innerRadius?: number;
-};
-type SvgGraphic = {
-    kind: "svg";
-    src: string;
-};
-type SvgPathGraphic = GraphicPaint & {
-    kind: "path";
-    path: string;
-    viewBox: [x: number, y: number, width: number, height: number];
-};
-type GraphicDefinition = CircleGraphic | TriangleGraphic | DiamondGraphic | StarGraphic | ArrowGraphic | RectangleGraphic | RingGraphic | SvgGraphic | SvgPathGraphic;
-type GraphicHotspotProps = HotspotCommonProps & {
-    graphic: GraphicDefinition;
-    onLoad?: (texture: Texture) => void;
-    onError?: (error: unknown) => void;
-};
-declare function GraphicHotspot(props: GraphicHotspotProps): react.JSX.Element;
-
 type SequenceFrameDirection = "horizontal" | "vertical";
 type SequenceLoadProgress = {
     id: string;
@@ -1578,61 +2026,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 TextHotspotAlign = "left" | "center" | "right";
-type TextHotspotVerticalAlign = "top" | "middle" | "bottom";
-type TextHotspotWhiteSpace = "normal" | "nowrap";
-type TextHotspotFontStyle = "normal" | "italic";
-/** Serializable typography and panel paint for a text hotspot. */
-type TextHotspotStyle = {
-    fontFamily?: string;
-    /** Canvas pixels. Defaults to 96. */
-    fontSize?: number;
-    /** CSS font-weight. Defaults to 600. */
-    fontWeight?: number | string;
-    /** CSS font-style. Defaults to `"normal"`. */
-    fontStyle?: TextHotspotFontStyle;
-    color?: string;
-    /** CSS color. An empty string skips the panel fill. */
-    background?: string;
-    backgroundOpacity?: number;
-    /** Fraction of the texture's shorter side. */
-    padding?: number;
-    align?: TextHotspotAlign;
-    verticalAlign?: TextHotspotVerticalAlign;
-    lineHeight?: number;
-    whiteSpace?: TextHotspotWhiteSpace;
-    /** Fraction of the texture's shorter side, from 0 to 0.5. */
-    borderRadius?: number;
-    stroke?: string;
-    strokeWidth?: number;
-};
-type TextHotspotProps = HotspotCommonProps & TextHotspotStyle & {
-    text: string;
-    onLoad?: (texture: Texture) => void;
-    onError?: (error: unknown) => void;
-};
-declare function TextHotspot({ text, width, height, opacity, fontFamily, fontSize, fontWeight, fontStyle, color, background, backgroundOpacity, padding, align, verticalAlign, lineHeight, whiteSpace, borderRadius, stroke, strokeWidth, onLoad, onError, ...anchorProps }: TextHotspotProps): react.JSX.Element;
-
-type IframePointerPolicy = "hotspot" | "content";
-type IframeHotspotProps = HotspotCommonProps & {
-    src: string;
-    /** 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;
@@ -1644,118 +2037,4 @@ declare function vector3ToPanoPosition(vector: Pick<Vector3, "x" | "y" | "z">):
 declare const DEFAULT_HOTSPOT_TOOLTIP_OFFSET = 12;
 declare const DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE: Required<HotspotTooltipAppearance>;
 
-/** Shared serializable fields for every saved hotspot definition. */
-type HotspotDefinitionBase = {
-    id: string;
-    /** Human-readable label; use it as the source for the rendered ariaLabel. */
-    label?: string;
-    visible?: boolean;
-    interactive?: boolean;
-    /** Pointer hit-testing. `"none"` ignores mouse, touch, and pen. */
-    pointerEvents?: HotspotPointerEvents;
-    /** Canvas cursor while this hotspot is hovered. */
-    cursor?: CSSProperties["cursor"];
-    renderOrder?: number;
-    tooltip?: string | HotspotTooltipContent;
-    tooltipTrigger?: HotspotTooltipTrigger;
-    tooltipPlacement?: HotspotTooltipPlacement;
-    tooltipOffset?: number;
-    tooltipAppearance?: HotspotTooltipAppearance;
-};
-/** Shared serializable fields for a hotspot anchored at one yaw/pitch point. */
-type PointHotspotDefinitionBase = HotspotDefinitionBase & {
-    position: HotspotPosition;
-    width?: number;
-    height?: number;
-    scale?: number;
-    mode?: HotspotMode;
-    distance?: number;
-    scaleMode?: HotspotScaleMode;
-    referenceFov?: number;
-    rotation?: number;
-    opacity?: number;
-};
-type ImageHotspotDefinition = PointHotspotDefinitionBase & {
-    type: "image";
-    src: string;
-};
-type GraphicHotspotDefinition = PointHotspotDefinitionBase & {
-    type: "graphic";
-    graphic: GraphicDefinition;
-};
-type SequenceHotspotDefinition = PointHotspotDefinitionBase & {
-    type: "sequence";
-    src: string;
-    frameCount: number;
-    frameDirection?: "horizontal" | "vertical";
-    playing?: boolean;
-    fps?: number;
-    loop?: boolean;
-};
-type VideoHotspotDefinition = PointHotspotDefinitionBase & {
-    type: "video";
-    src: string;
-    poster?: string;
-    playing?: boolean;
-    loop?: boolean;
-    muted?: boolean;
-    volume?: number;
-    playsInline?: boolean;
-    preload?: "none" | "metadata" | "auto";
-    crossOrigin?: "" | "anonymous" | "use-credentials";
-};
-type AudioHotspotDefinition = PointHotspotDefinitionBase & {
-    type: "audio";
-    src: string | string[];
-    playing?: boolean;
-    loop?: boolean;
-    muted?: boolean;
-    volume?: number;
-    pauseWhenHidden?: boolean;
-    range?: number;
-    icon?: string;
-    playingIcon?: string;
-    marker?: boolean;
-    crossOrigin?: "" | "anonymous" | "use-credentials";
-};
-type TextHotspotDefinition = PointHotspotDefinitionBase & TextHotspotStyle & {
-    type: "text";
-    text: string;
-};
-type IframeHotspotDefinition = PointHotspotDefinitionBase & {
-    type: "iframe";
-    src: string;
-    title?: string;
-    sandbox?: string;
-    allow?: string;
-    referrerPolicy?: string;
-    loading?: "eager" | "lazy";
-    pointerPolicy?: IframePointerPolicy;
-    background?: string;
-};
-type PolygonHotspotDefinition = HotspotDefinitionBase & {
-    type: "polygon";
-    vertices: HotspotPosition[];
-    fill?: string;
-    fillOpacity?: number;
-    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 & {
-    type: "polyline";
-    vertices: HotspotPosition[];
-    stroke?: string;
-    strokeWidth?: number;
-    strokeOpacity?: number;
-    strokeDashSize?: number;
-    strokeGapSize?: number;
-};
-type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition | SequenceHotspotDefinition | VideoHotspotDefinition | AudioHotspotDefinition | TextHotspotDefinition | IframeHotspotDefinition;
-/** 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 };
+export { type ArrowGraphic, type AssetUrlContext, type AssetUrlResolver, AudioHotspot, type AudioHotspotDefinition, type AudioHotspotErrorEvent, type AudioHotspotProps, type AudioPlaybackState, AutoRotate, type AutoRotateProps, BackgroundAudio, type BackgroundAudioController, type BackgroundAudioErrorEvent, type BackgroundAudioProps, type BackgroundAudioSnapshot, type BackgroundAudioSource, type CircleGraphic, type CubeFaceCode, type CubemapViewerConfig, DEFAULT_HOTSPOT_TOOLTIP_APPEARANCE, DEFAULT_HOTSPOT_TOOLTIP_OFFSET, DEFAULT_PANO_CURSORS, DEFAULT_PANO_VIDEO_CAPTION_APPEARANCE, DEFAULT_PANO_VIDEO_CONTROLS_APPEARANCE, DEFAULT_PANO_VIDEO_PLAYBACK_RATES, DEFAULT_WEBVR_CHROME_APPEARANCE, DEFAULT_WEBVR_CURSOR_DWELL_MS, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, Gyro, type GyroHandle, type GyroProps, type GyroTouchMode, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPointerEvents, type HotspotPosition, type HotspotScaleMode, type HotspotTooltipAppearance, type HotspotTooltipContent, type HotspotTooltipPlacement, type HotspotTooltipTrigger, IframeHotspot, type IframeHotspotDefinition, type IframeHotspotProps, type IframePointerPolicy, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type JsonObject, type JsonRequestOptions, type JsonValue, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, type LoadPanoProjectOptions, type LoadSceneFromJsonOptions, type LoadedPanoProject, type LoadedProjectScene, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PANO_FILTER_PRESETS, type PanoColorMatrix, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoCursor, type PanoCursors, PanoDataError, type PanoDataErrorCode, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, PanoFilter, type PanoFilterPreset, type PanoFilterProps, type PanoMediaActivationControls, type PanoMediaActivationOptions, PanoOverlayPortalProvider, type PanoOverlayRenderContext, type PanoProjectDefinition, type PanoProjectSceneDefinition, type PanoResizeEvent, PanoVideo, type PanoVideoCaptionAppearance, type PanoVideoController, PanoVideoControls, type PanoVideoControlsAppearance, type PanoVideoControlsProps, type PanoVideoErrorEvent, type PanoVideoErrorSource, type PanoVideoPlaybackSnapshot, type PanoVideoProps, type PanoVideoSource, type PanoVideoTrack, type PanoVideoTrackKind, type PanoVideoVariant, type PanoViewEasing, type PanoViewLimits, type PanoViewLookToOptions, type PanoViewNavigationOptions, type PanoViewNavigationResult, PanoViewer, type PanoViewerHandle, type PanoViewerProps, type PanoViewerState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type PopupAssetUrlContext, type PopupAssetUrlResolver, type ProjectCustomActionEvent, type ProjectCustomHotspotAction, type ProjectHotspotAction, type ProjectHotspotClickEvent, type ProjectHotspotDefinition, type ProjectHotspotErrorEvent, type ProjectHotspotEvent, type ProjectHotspotRenderContext, type ProjectHotspotTrigger, type ProjectPopupBlock, type ProjectPopupDefinition, type ProjectPopupRequestEvent, ProjectScenes, type ProjectScenesProps, type RectangleGraphic, type RingGraphic, type Scene, type SceneFromViewerConfigOptions, type SceneTransition, type SceneTransitionEndEvent, type SceneTransitionErrorEvent, type SceneTransitionPreset, Scenes, type ScenesController, type ScenesProps, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewerOptions, Sphere, type SphereProps, type SphereScene, SphereTile, type SphereTileAddress, type SphereTileLevel, type SphereTileLoadError, type SphereTileMultiresConfig, type SphereTileProps, type SphereTileScene, type SphereViewerConfig, type StarGraphic, type SvgGraphic, type SvgPathGraphic, TextHotspot, type TextHotspotAlign, type TextHotspotDefinition, type TextHotspotFontStyle, type TextHotspotProps, type TextHotspotStyle, type TextHotspotVerticalAlign, type TextHotspotWhiteSpace, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TileProps, type TileScene, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, type UsePanoViewerResult, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, type ViewerConfig, type ViewerDocument, WEBVR_PROFILES, WEBVR_PROFILE_IDS, WebVR, type WebVRChrome, type WebVRChromeAppearance, type WebVRHandle, type WebVRMode, type WebVRProfile, type WebVRProfileId, type WebVRProps, type WebVRSettings, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, hotspotAction, loadPanoProject, loadSceneFromJson, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, parsePanoProject, projectHotspotTriggers, resolvePanoContextMenuEntries, resolveHotspotAssets as resolveProjectHotspotAssets, resolveProjectPopupAssets, sceneFromViewerConfig, setHotspotAction, unwrapPolygonVertices, usePanoEvents, usePanoModal, usePanoOverlay, usePanoViewer, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };