using XP.Hardware.MotionControl.Abstractions.Enums;

namespace XP.Hardware.MotionControl.Abstractions
{
    /// <summary>
    /// 安全门策略接口 | Safety Door Strategy Interface
    /// 定义安全防护门的控制能力 | Defines safety door control capabilities
    /// </summary>
    public interface ISafetyDoor
    {
        /// <summary>门状态 | Door status</summary>
        DoorStatus Status { get; }

        /// <summary>联锁信号是否有效（true=联锁中，禁止开门）| Interlock active (true=interlocked, door open blocked)</summary>
        bool IsInterlocked { get; }

        /// <summary>开门 | Open door</summary>
        /// <returns>操作结果 | Operation result</returns>
        MotionResult Open();

        /// <summary>关门 | Close door</summary>
        /// <returns>操作结果 | Operation result</returns>
        MotionResult Close();

        /// <summary>停止门 | Stop door</summary>
        /// <returns>操作结果 | Operation result</returns>
        MotionResult Stop();

        /// <summary>从 PLC 更新状态 | Update status from PLC</summary>
        void UpdateStatus();
    }
}