namespace MultiWheelC.TrajectoryPlanning.EMPlanner;

/// <summary>执行层的车辆状态快照来源；具体实现可在模块外读取定位或硬件，但核心只消费返回的不可变快照。</summary>
public interface IVehicleStateProvider
{
    /// <summary>捕获一次车辆位姿、带符号纵向速度、可选加速度、时刻和序列号快照。</summary>
    /// <returns>不可变 <see cref="VehicleMotionState"/>；其位置单位为 m、航向为 rad、速度为 m/s。</returns>
    VehicleMotionState Capture();
}