using System;
using UnityEngine;

namespace BaseGames.Enemies
{
    /// <summary>
    /// 导航代理抽象接口（架构 07_EnemyModule §5）。
    /// EnemyBase 和 BD Task 只依赖此接口，不依赖具体导航库。
    /// 实现：EnemyNavAgent（PathBerserker2d）；测试用 NullPathAgent。
    /// </summary>
    public interface IPathAgent
    {
        /// <summary>请求移动到世界坐标 target。</summary>
        void RequestMoveTo(Vector2 target);

        /// <summary>立即停止导航（清除路径）。</summary>
        void StopNavigation();

        /// <summary>是否已到达目标（距离 ≤ stoppingDistance）。</summary>
        bool IsAtDestination();

        /// <summary>运行时覆盖移动速度。</summary>
        void SetSpeed(float speed);

        /// <summary>当前帧是否在移动（速度 > 0.01 且有有效路径）。</summary>
        bool IsMoving { get; }

        /// <summary>是否接近平台边缘（脚下或前方无地面时为 true）。</summary>
        bool IsNearEdge();

        /// <summary>路径寻路失败事件（目标不可达时触发）。</summary>
        event Action OnNavPathFailed;
    }

    // ── 无导航 / 测试用空实现 ─────────────────────────────────────────────
    public sealed class NullPathAgent : IPathAgent
    {
        public void RequestMoveTo(Vector2 _) { }
        public void StopNavigation()         { }
        public bool IsAtDestination()        => true;
        public void SetSpeed(float _)        { }
        public bool IsMoving                 => false;
        public bool IsNearEdge()             => false;
        public event Action OnNavPathFailed  { add { } remove { } }
    }
}