Resolved walkthrough plan returned by planCameraTour.

Pure data — no methods, no lifecycle. Driving the tour against a View is the job of the separate playCameraTour helper, which feeds these waypoints into the existing CameraPath + CameraPathAnimation playback infrastructure.

The included spaceGraph is the same graph the planner operated on, surfaced here so callers can render an overview map / minimap, or pre-load assets for upcoming rooms.

interface CameraTour {
    estimatedDurationMs: number;
    spaceGraph: SpaceGraph;
    waypoints: readonly CameraTourWaypoint[];
}

Properties

estimatedDurationMs: number

Estimated total playback duration in milliseconds — sum of per-waypoint dwell times plus inter-waypoint flight times (using CameraTourPlanOptions.flightDurationMs as the default flight estimate). Independent of any later playback-speed overrides.

spaceGraph: SpaceGraph

The space graph the tour was planned over, returned for inspection / overview rendering. Same instance the active TourPlanner consumed.

waypoints: readonly CameraTourWaypoint[]

Ordered list of waypoints to visit. Includes both in-space stops and any portal-transit waypoints inserted by the smoother. Always non-empty when planCameraTour succeeds.