namespace IvfTl.AutoFocus.Layout
{
    /// <summary>
    /// 单一来源、已就近优先解析好的有效拍摄层配置（M2-02，§2.4/§2.5）。
    /// 由 <see cref="PhotoLayerCalculator.Resolve"/> 产出，喂给 <see cref="PhotoLayerCalculator.ComputeLayerPositions"/>。
    /// 纯数据，无外部依赖。
    /// </summary>
    public sealed class FocusLayerConfig
    {
        /// <summary>层间距脉冲（工艺值；必填，无代码默认 — §2.5 不兜底）。</summary>
        public int LayerSpacingPulse { get; init; }

        /// <summary>拍照总层数（业务参数；设备级 SQL DEFAULT 5）。</summary>
        public int LayerCount { get; init; }

        /// <summary>对焦起点下移层数（清晰层在第几层之上；设备级 SQL DEFAULT 2，well 级复用 move_down_layer）。</summary>
        public int LayerDown { get; init; }
    }
}