@ericchen1990/pano-view 0.1.6 → 0.2.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, ComponentPropsWithoutRef } from 'react';
+import { ReactNode, CSSProperties, ComponentPropsWithoutRef } from 'react';
 import { Texture, ColorRepresentation, Vector3 } from 'three';
 
 declare const MAX_HOTSPOT_PITCH = 90;
@@ -75,6 +75,51 @@ type PanoramaPointerEvent = {
     clientY: number;
 };
 
+type KeyboardControlAction = "left" | "right" | "up" | "down" | "zoomIn" | "zoomOut" | "previousScene" | "nextScene" | "reset";
+type KeyboardControlKeys = Partial<Record<KeyboardControlAction, string | readonly string[]>>;
+/** Options for keyboard-driven panorama navigation. */
+type KeyboardControlsProps = {
+    /** Whether keyboard handling is active. Defaults to true. */
+    enabled?: boolean;
+    /**
+     * Custom key bindings. Each action accepts a key, code, or list of either.
+     * Matching is case-insensitive for `event.key` and exact for `event.code`.
+     */
+    keys?: KeyboardControlKeys;
+    /** Yaw/pitch change rate in degrees per second. Defaults to 60. */
+    rotateSpeed?: number;
+    /** FOV change rate in degrees per second. Defaults to 30. */
+    zoomSpeed?: number;
+    /** Speed multiplier while Shift is held. Defaults to 3. */
+    shiftMultiplier?: number;
+    /** Inverts up/down look direction. Defaults to false. */
+    invert?: boolean;
+    /**
+     * Maximum FOV change rate in degrees per second. When omitted, no extra
+     * rate cap is applied. Usually supplied by PanoView from `controls.fovSpeed`.
+     */
+    fovSpeed?: number;
+    /** Called once when the previous-scene binding is pressed. */
+    onPreviousScene?: () => void;
+    /** Called once when the next-scene binding is pressed. */
+    onNextScene?: () => void;
+};
+/**
+ * Returns the scene id `step` positions away from `activeSceneId` in
+ * `scenes`, wrapping at both ends. Returns `null` when the list is empty or
+ * the active id is missing.
+ */
+declare function cycleSceneId(scenes: readonly {
+    id: string;
+}[], activeSceneId: string, step: 1 | -1): string | null;
+/**
+ * Adds keyboard navigation to the nearest PanoView. PanoView mounts a default
+ * instance; render your own to customize bindings or scene callbacks. Hold
+ * movement/zoom keys for continuous motion; scene and reset bindings fire once
+ * per key press.
+ */
+declare function KeyboardControls({ enabled, keys, rotateSpeed, zoomSpeed, shiftMultiplier, invert, fovSpeed, onPreviousScene, onNextScene, }: KeyboardControlsProps): null;
+
 type PanoViewState = {
     /** Horizontal look angle in degrees. Positive values look right. */
     yaw: number;
@@ -97,16 +142,74 @@ type PanoViewHandle = {
     stopAutoRotate: () => void;
     toggleFullscreen: () => Promise<void>;
 };
+type MouseControlButton = "left" | "middle" | "right";
+/** Options for the default mouse control channel (also MouseControls props). */
+type MouseControlsOptions = {
+    /** Whether mouse handling is active. Defaults to true. */
+    enabled?: boolean;
+    /** Pointer drag multiplier. Defaults to 0.35. */
+    rotateSpeed?: number;
+    /** Wheel zoom multiplier. Defaults to 0.08. */
+    zoomSpeed?: number;
+    /** Whether mouse-wheel zoom is enabled. Defaults to true. */
+    wheel?: boolean;
+    /** Inverts drag direction. Defaults to the all-mode `invert` value. */
+    invert?: boolean;
+    /** Mouse buttons that may drag the panorama. Defaults to `["left"]`. */
+    buttons?: readonly MouseControlButton[];
+};
+/** Options for the default touch control channel (also TouchControls props). */
+type TouchControlsOptions = {
+    /** Whether touch handling is active. Defaults to true. */
+    enabled?: boolean;
+    /** Pointer drag multiplier. Defaults to 0.35. */
+    rotateSpeed?: number;
+    /** Inverts drag direction. Defaults to the all-mode `invert` value. */
+    invert?: boolean;
+    /** Whether two-finger pinch zoom is enabled. Defaults to true. */
+    pinchZoom?: boolean;
+};
 type PanoramaControlsOptions = {
+    /**
+     * Master switch for user view controls. Defaults to true. Setting
+     * `controls={false}` on PanoView still disables all user input.
+     */
+    enabled?: boolean;
     /** Enables drag and zoom inertia. Defaults to true. */
     inertia?: boolean;
     /** @deprecated Render <AutoRotate enabled /> inside PanoView instead. */
     autoRotate?: boolean;
     /** @deprecated Use AutoRotate's speed prop instead. */
     autoRotateSpeed?: number;
-    /** Pointer drag multiplier. Defaults to 0.35. */
+    /**
+     * Inverts drag/pan direction for mouse and touch. Defaults to false.
+     * Per-channel `invert` on MouseControls / TouchControls overrides this.
+     */
+    invert?: boolean;
+    /**
+     * Allows pitch and FOV to briefly overshoot hard limits while dragging,
+     * then spring back on release. Defaults to false.
+     */
+    bouncingLimits?: boolean;
+    /**
+     * Maximum FOV change rate in degrees per second for wheel and keyboard
+     * zoom. When omitted, no extra rate cap is applied.
+     */
+    fovSpeed?: number;
+    /**
+     * Relative factor for stopping inertia. Lower values fade out more
+     * smoothly. Defaults to 0.01.
+     */
+    frictionStop?: number;
+    /**
+     * Default pointer drag multiplier for mouse and touch. Defaults to 0.35.
+     * Prefer `controls.mouse` / `controls.touch` for per-channel overrides.
+     */
     rotateSpeed?: number;
-    /** Wheel zoom multiplier. Defaults to 0.08. */
+    /**
+     * Default wheel zoom multiplier for mouse. Defaults to 0.08.
+     * Prefer `controls.mouse.zoomSpeed` for overrides.
+     */
     zoomSpeed?: number;
     /**
      * Rotation target-following speed in seconds^-1. Defaults to 14; use 0 for
@@ -118,16 +221,174 @@ type PanoramaControlsOptions = {
      * immediate response. Must be a non-negative finite number.
      */
     zoomDamping?: number;
-    /** Enables focusable keyboard controls. Defaults to true. */
-    keyboard?: boolean;
+    /**
+     * Mouse channel. `true` / omit mounts defaults; `false` skips the default
+     * instance (render a custom MouseControls child); an object merges with
+     * defaults and supports `enabled`.
+     */
+    mouse?: boolean | MouseControlsOptions;
+    /**
+     * Touch channel. Same shape as `mouse`.
+     */
+    touch?: boolean | TouchControlsOptions;
+    /**
+     * Keyboard channel. Same shape as `mouse`. Set to false when providing a
+     * custom KeyboardControls child.
+     */
+    keyboard?: boolean | KeyboardControlsProps;
+};
+
+/** Lowest allowed `appearance.opacity` (background only). */
+declare const MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY = 0.4;
+type PanoContextMenuSelectContext = {
+    position: PanoramaPointerEvent["position"];
+    view: PanoViewState;
+    nativeEvent: MouseEvent | PointerEvent;
+    close: () => void;
+};
+type PanoContextMenuActionItem = {
+    type?: "item";
+    id: string;
+    label: string;
+    /** React icon node (inline SVG, icon library component, emoji, etc.). */
+    icon?: ReactNode;
+    /** Image URL; ignored when `icon` is set. */
+    image?: string;
+    imageAlt?: string;
+    disabled?: boolean;
+    hidden?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    onSelect: (context: PanoContextMenuSelectContext) => void;
+};
+type PanoContextMenuSeparatorItem = {
+    type: "separator";
+    id?: string;
+    className?: string;
+    style?: CSSProperties;
+};
+type PanoContextMenuItem = PanoContextMenuActionItem | PanoContextMenuSeparatorItem;
+/** Built-in menu entries hosts can reuse without reimplementing behavior. */
+type PanoContextMenuPresetId = "resetView" | "fullscreen" | "separator";
+/**
+ * Reference a built-in preset, optionally overriding presentation fields.
+ * Action wiring (reset / fullscreen toggle and enter/exit label) stays built-in.
+ */
+type PanoContextMenuPresetRef = {
+    preset: PanoContextMenuPresetId;
+    id?: string;
+    label?: string;
+    className?: string;
+    style?: CSSProperties;
+    disabled?: boolean;
+    hidden?: boolean;
+};
+/** A custom action item, a preset id string, or a preset ref with overrides. */
+type PanoContextMenuEntry = PanoContextMenuActionItem | PanoContextMenuPresetId | PanoContextMenuPresetRef;
+type PanoContextMenuAppearance = {
+    background?: string;
+    color?: string;
+    border?: string;
+    borderRadius?: number | string;
+    shadow?: string;
+    /**
+     * Background-only opacity from {@link MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY}
+     * to 1. Defaults to 1. Text and icons stay fully opaque.
+     */
+    opacity?: number;
+    fontSize?: number | string;
+    minWidth?: number | string;
+    padding?: number | string;
+    iconSize?: number;
+    itemPadding?: string;
+    itemHoverBackground?: string;
+    itemDisabledColor?: string;
+    separatorColor?: string;
+    separatorMargin?: string;
+};
+type PanoContextMenuRenderProps = {
+    event: PanoramaPointerEvent;
+    view: PanoViewState;
+    close: () => void;
+};
+type PanoContextMenuProps = {
+    /**
+     * Menu entries. May mix concrete items with built-in presets
+     * (`"resetView"`, `"fullscreen"`, `"separator"`). When omitted, the
+     * default Reset view / Fullscreen list is used (see also `prepend` /
+     * `append`).
+     */
+    items?: readonly PanoContextMenuEntry[];
+    /**
+     * Entries placed before the default menu when `items` is omitted.
+     * Ignored when `items` is provided.
+     */
+    prepend?: readonly PanoContextMenuEntry[];
+    /**
+     * Entries placed after the default menu when `items` is omitted.
+     * Ignored when `items` is provided.
+     */
+    append?: readonly PanoContextMenuEntry[];
+    appearance?: PanoContextMenuAppearance;
+    className?: string;
+    style?: CSSProperties;
+    itemClassName?: string;
+    separatorClassName?: string;
+    /**
+     * Fully custom menu content. When provided, takes precedence over `items`.
+     * Opening, closing, and positioning remain handled by PanoContextMenu.
+     */
+    children?: (props: PanoContextMenuRenderProps) => ReactNode;
 };
+/**
+ * Custom panorama context menu. Must render inside PanoView. Prefer
+ * PanoView's `contextMenu` prop for the default menu; use this component
+ * when replacing the default instance (`contextMenu={false}`).
+ */
+declare function PanoContextMenu({ items, prepend, append, appearance, className, style, itemClassName, separatorClassName, children, }: PanoContextMenuProps): null;
+type PanoContextMenuPresetActions = {
+    reset: () => void;
+    toggleFullscreen: () => void;
+    /** When true, the fullscreen preset shows Exit fullscreen. */
+    isFullscreen?: boolean;
+};
+type PanoContextMenuPresets = {
+    resetView: PanoContextMenuActionItem;
+    fullscreen: PanoContextMenuActionItem;
+    separator: (id?: string) => PanoContextMenuSeparatorItem;
+    /** Default menu: Reset view, separator, Enter/Exit fullscreen. */
+    defaults: PanoContextMenuItem[];
+};
+/**
+ * Builds reusable built-in context-menu items. Prefer preset id strings
+ * (`"resetView"`, `"fullscreen"`) in `items` / `append` / `prepend` when
+ * configuring `PanoView`; use this helper when assembling items manually.
+ */
+declare function createPanoContextMenuPresets(actions: PanoContextMenuPresetActions): PanoContextMenuPresets;
+/** Alias for `createPanoContextMenuPresets(actions).defaults`. */
+declare function createDefaultPanoContextMenuItems(actions: PanoContextMenuPresetActions): PanoContextMenuItem[];
+/**
+ * Expands preset ids / refs into concrete menu items using the given presets.
+ */
+declare function resolvePanoContextMenuEntries(entries: readonly PanoContextMenuEntry[], presets: PanoContextMenuPresets): PanoContextMenuItem[];
+/**
+ * Resolves `items`, or `prepend` + defaults + `append` when `items` is omitted.
+ */
+declare function composePanoContextMenuItems(props: Pick<PanoContextMenuProps, "items" | "prepend" | "append">, presets: PanoContextMenuPresets): PanoContextMenuItem[];
 
-type PanoViewProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange"> & {
+type PanoViewProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChange" | "contextMenu"> & {
     children?: ReactNode;
     initialView?: Partial<PanoViewState>;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
+    /**
+     * Default context menu. `true` / omit mounts Reset view + Fullscreen;
+     * `false` skips the default instance; an object merges appearance and
+     * may use `items` (full replace, supports preset ids), or `prepend` /
+     * `append` to keep the defaults and add entries.
+     */
+    contextMenu?: boolean | PanoContextMenuProps;
     onViewChange?: (view: PanoViewState) => void;
     onPanoramaClick?: (event: PanoramaPointerEvent) => void;
     onPanoramaDoubleClick?: (event: PanoramaPointerEvent) => void;
@@ -135,12 +396,19 @@ type PanoViewProps = Omit<ComponentPropsWithoutRef<"div">, "children" | "onChang
     /** Canvas pixel ratio. Defaults to a capped range of 1–2. */
     dpr?: number | [number, number];
 };
-declare const PanoView: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "onChange"> & {
+declare const PanoView: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "contextMenu" | "onChange"> & {
     children?: ReactNode;
     initialView?: Partial<PanoViewState>;
     minFov?: number;
     maxFov?: number;
     controls?: boolean | PanoramaControlsOptions;
+    /**
+     * Default context menu. `true` / omit mounts Reset view + Fullscreen;
+     * `false` skips the default instance; an object merges appearance and
+     * may use `items` (full replace, supports preset ids), or `prepend` /
+     * `append` to keep the defaults and add entries.
+     */
+    contextMenu?: boolean | PanoContextMenuProps;
     onViewChange?: (view: PanoViewState) => void;
     onPanoramaClick?: (event: PanoramaPointerEvent) => void;
     onPanoramaDoubleClick?: (event: PanoramaPointerEvent) => void;
@@ -169,6 +437,105 @@ type AutoRotateProps = {
  */
 declare function AutoRotate({ enabled, speed, acceleration, startDelay, }: AutoRotateProps): null;
 
+type ViewInteractionSource = "mouse" | "touch" | "keyboard";
+type PanoWheelEvent = {
+    /** Signed wheel delta (same sign convention as WheelEvent.deltaY). */
+    delta: number;
+    nativeEvent: WheelEvent;
+};
+type PanoResizeEvent = {
+    width: number;
+    height: number;
+};
+type ViewInteractionEvent = {
+    source: ViewInteractionSource;
+};
+type PanoEventMap = {
+    viewchange: PanoViewState;
+    viewsettled: PanoViewState;
+    viewinteractionstart: ViewInteractionEvent;
+    viewinteractionend: ViewInteractionEvent;
+    click: PanoramaPointerEvent;
+    doubleclick: PanoramaPointerEvent;
+    pointerdown: PanoramaPointerEvent;
+    pointerup: PanoramaPointerEvent;
+    pointermove: PanoramaPointerEvent;
+    contextmenu: PanoramaPointerEvent;
+    wheel: PanoWheelEvent;
+    idle: undefined;
+    idleend: undefined;
+    enterfullscreen: undefined;
+    exitfullscreen: undefined;
+    resize: PanoResizeEvent;
+    autorotatestart: undefined;
+    autorotatestop: undefined;
+    autorotateoneround: undefined;
+};
+type PanoEventType = keyof PanoEventMap;
+type PanoEventListener<T extends PanoEventType> = (payload: PanoEventMap[T]) => void;
+type PanoEventBus = {
+    subscribe: <T extends PanoEventType>(type: T, listener: PanoEventListener<T>) => () => void;
+    emit: <T extends PanoEventType>(type: T, payload: PanoEventMap[T]) => void;
+};
+
+type PanoEventsProps = {
+    /**
+     * Milliseconds without user interaction before `onIdle`. Defaults to 2000.
+     * Each PanoEvents instance tracks idle independently.
+     */
+    idleTime?: number;
+    onViewChange?: (view: PanoViewState) => void;
+    onViewSettled?: (view: PanoViewState) => void;
+    onViewInteractionStart?: (event: ViewInteractionEvent) => void;
+    onViewInteractionEnd?: (event: ViewInteractionEvent) => void;
+    onClick?: (event: PanoramaPointerEvent) => void;
+    onDoubleClick?: (event: PanoramaPointerEvent) => void;
+    onPointerDown?: (event: PanoramaPointerEvent) => void;
+    onPointerUp?: (event: PanoramaPointerEvent) => void;
+    onPointerMove?: (event: PanoramaPointerEvent) => void;
+    onContextMenu?: (event: PanoramaPointerEvent) => void;
+    onWheel?: (event: PanoWheelEvent) => void;
+    onIdle?: () => void;
+    onIdleEnd?: () => void;
+    onEnterFullscreen?: () => void;
+    onExitFullscreen?: () => void;
+    onResize?: (event: PanoResizeEvent) => void;
+    onAutoRotateStart?: () => void;
+    onAutoRotateStop?: () => void;
+    onAutoRotateOneRound?: () => void;
+};
+/**
+ * Subscribes to viewer-level panorama events. Must run inside PanoView.
+ * Prefer the {@link PanoEvents} component for declarative usage.
+ */
+declare function usePanoEvents({ idleTime, onViewChange, onViewSettled, onViewInteractionStart, onViewInteractionEnd, onClick, onDoubleClick, onPointerDown, onPointerUp, onPointerMove, onContextMenu, onWheel, onIdle, onIdleEnd, onEnterFullscreen, onExitFullscreen, onResize, onAutoRotateStart, onAutoRotateStop, onAutoRotateOneRound, }: PanoEventsProps): void;
+/**
+ * Declarative viewer-level event listeners for the nearest PanoView.
+ * Multiple instances may coexist; each tracks its own idle timer.
+ */
+declare function PanoEvents(props: PanoEventsProps): null;
+
+type MouseControlsProps = MouseControlsOptions & {
+    /**
+     * Maximum FOV change rate in degrees per second for wheel zoom. When
+     * omitted, no extra rate cap is applied. Usually supplied by PanoView from
+     * `controls.fovSpeed`.
+     */
+    fovSpeed?: number;
+};
+/**
+ * Adds mouse (and pen) drag / wheel navigation to the nearest PanoView.
+ * PanoView mounts a default instance; render your own only to override.
+ */
+declare function MouseControls({ enabled, rotateSpeed, zoomSpeed, wheel, invert, buttons, fovSpeed, }: MouseControlsProps): null;
+
+type TouchControlsProps = TouchControlsOptions;
+/**
+ * Adds touch drag and pinch-zoom navigation to the nearest PanoView.
+ * PanoView mounts a default instance; render your own only to override.
+ */
+declare function TouchControls({ enabled, rotateSpeed, invert, pinchZoom, }: TouchControlsProps): null;
+
 type SphereProps = {
     src: string;
     /** Horizontal image offset in degrees. */
@@ -361,8 +728,21 @@ type GraphicPaint = {
 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 & {
@@ -378,7 +758,7 @@ type SvgPathGraphic = GraphicPaint & {
     path: string;
     viewBox: [x: number, y: number, width: number, height: number];
 };
-type GraphicDefinition = CircleGraphic | RectangleGraphic | RingGraphic | SvgGraphic | SvgPathGraphic;
+type GraphicDefinition = CircleGraphic | TriangleGraphic | DiamondGraphic | StarGraphic | ArrowGraphic | RectangleGraphic | RingGraphic | SvgGraphic | SvgPathGraphic;
 type GraphicHotspotProps = HotspotCommonProps & {
     graphic: GraphicDefinition;
     onLoad?: (texture: Texture) => void;
@@ -524,4 +904,4 @@ type PointHotspotDefinition = ImageHotspotDefinition | GraphicHotspotDefinition
 /** A serializable, discriminated hotspot collection item. */
 type HotspotDefinition = PointHotspotDefinition | PolygonHotspotDefinition | PolylineHotspotDefinition;
 
-export { AutoRotate, type AutoRotateProps, type CircleGraphic, type CubeFaceCode, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPosition, type HotspotScaleMode, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, MAX_HOTSPOT_PITCH, PanoView, type PanoViewHandle, type PanoViewProps, type PanoViewState, type PanoramaControlsOptions, type PanoramaPointerEvent, type PanoramaScene, PanoramaScenes, type PanoramaScenesProps, type PanoramaTransition, type PanoramaTransitionEndEvent, type PanoramaTransitionErrorEvent, type PanoramaTransitionPreset, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewOptions, Sphere, type SpherePanoramaScene, type SphereProps, type SvgGraphic, type SvgPathGraphic, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TilePanoramaScene, type TileProps, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, clampPanoPitch, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, unwrapPolygonVertices, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };
+export { type ArrowGraphic, AutoRotate, type AutoRotateProps, type CircleGraphic, type CubeFaceCode, type DiamondGraphic, type GraphicDefinition, GraphicHotspot, type GraphicHotspotDefinition, type GraphicHotspotProps, type HotspotCommonProps, type HotspotDefinition, type HotspotDefinitionBase, type HotspotDragEvent, type HotspotInputSource, type HotspotInteractionEvent, type HotspotMode, type HotspotPosition, type HotspotScaleMode, ImageHotspot, type ImageHotspotDefinition, type ImageHotspotProps, type KeyboardControlAction, type KeyboardControlKeys, KeyboardControls, type KeyboardControlsProps, MAX_HOTSPOT_PITCH, MIN_PANO_CONTEXT_MENU_BACKGROUND_OPACITY, type MouseControlButton, MouseControls, type MouseControlsOptions, type MouseControlsProps, PanoContextMenu, type PanoContextMenuActionItem, type PanoContextMenuAppearance, type PanoContextMenuEntry, type PanoContextMenuItem, type PanoContextMenuPresetActions, type PanoContextMenuPresetId, type PanoContextMenuPresetRef, type PanoContextMenuPresets, type PanoContextMenuProps, type PanoContextMenuRenderProps, type PanoContextMenuSelectContext, type PanoContextMenuSeparatorItem, type PanoEventBus, type PanoEventListener, type PanoEventMap, type PanoEventType, PanoEvents, type PanoEventsProps, type PanoResizeEvent, PanoView, type PanoViewHandle, type PanoViewProps, type PanoViewState, type PanoWheelEvent, type PanoramaControlsOptions, type PanoramaPointerEvent, type PanoramaScene, PanoramaScenes, type PanoramaScenesProps, type PanoramaTransition, type PanoramaTransitionEndEvent, type PanoramaTransitionErrorEvent, type PanoramaTransitionPreset, type PointHotspotDefinition, type PointHotspotDefinitionBase, PolygonHotspot, type PolygonHotspotDefinition, type PolygonHotspotProps, type PolygonValidationCode, type PolygonValidationIssue, type PolygonVerticesChangeEvent, PolylineHotspot, type PolylineHotspotDefinition, type PolylineHotspotProps, type PolylineValidationIssue, type PolylineVerticesChangeEvent, type RectangleGraphic, type RingGraphic, type SequenceFrameDirection, type SequenceFrameEvent, SequenceHotspot, type SequenceHotspotDefinition, type SequenceHotspotErrorEvent, type SequenceHotspotProps, type SequenceLoadProgress, type SequencePlaybackState, type SetPanoViewOptions, Sphere, type SpherePanoramaScene, type SphereProps, type StarGraphic, type SvgGraphic, type SvgPathGraphic, Tile, type TileAddress, type TileLoadError, type TileLoadProgress, type TileMultiresConfig, type TilePanoramaScene, type TileProps, TouchControls, type TouchControlsOptions, type TouchControlsProps, type TriangleGraphic, VideoHotspot, type VideoHotspotDefinition, type VideoHotspotErrorEvent, type VideoHotspotProps, type VideoPlaybackState, type ViewInteractionEvent, type ViewInteractionSource, clampPanoPitch, composePanoContextMenuItems, createDefaultPanoContextMenuItems, createPanoContextMenuPresets, cycleSceneId, normalizePanoPosition, normalizePanoYaw, panoPositionToVector3, resolvePanoContextMenuEntries, unwrapPolygonVertices, usePanoEvents, validatePolygonVertices, validatePolylineVertices, vector3ToPanoPosition };