@ericchen1990/pano-view 3.4.2 → 3.5.0

package/dist/index.d.ts

@@ -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;
@@ -805,6 +805,573 @@ declare const PanoViewer: react.ForwardRefExoticComponent<Omit<Omit<react.Detail
     dpr?: number | [number, number];
 } & react.RefAttributes<PanoViewerHandle>>;
 
+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;
+    });
+}
+
+/** 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 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;
+};
+
+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 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 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;
+};
+
+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 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;
+};
+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 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[];
+    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 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. */
@@ -1119,140 +1686,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 +1739,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 +1854,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 +1889,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 +1900,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 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 };