using UnityEngine;

namespace BaseGames.Enemies.Perception
{
    /// <summary>
    /// 敌人感知系统接口。
    /// EnemyBase 通过此接口与感知实现解耦，支持运行时替换。
    /// 当前实现为 <see cref="PhysicsPerceptionSystem"/>（纯物理射线 / 圆形范围检测）。
    /// 若未来替换底层传感器实现，只需重新实现此接口，上层代码无需改动。
    /// </summary>
    public interface IPerceptionSystem
    {
        /// <summary>指定槽位是否已配置（用于运行前的能力检测，避免无效查询）。</summary>
        bool HasSlot(string slotName);

        /// <summary>指定槽位是否检测到任意目标。</summary>
        bool HasAnyDetection(string slotName);

        /// <summary>指定槽位是否正在检测 target 对象。</summary>
        bool IsDetecting(string slotName, GameObject target);

        /// <summary>返回指定槽位第一个检测到的对象，无检测则返回 null。</summary>
        GameObject GetFirstDetection(string slotName);

        /// <summary>
        /// 返回指定槽位感知区域的半径（圆形区域）。
        /// 槽位不存在、非圆形区域或实现不支持时返回 -1。
        /// 主要供编辑器 Gizmos 绘制使用。
        /// </summary>
        float GetSensorRadius(string slotName);

        /// <summary>
        /// 返回指定槽位检测原点相对于感知组件 transform 的偏移（X 分量已根据朝向翻转）。
        /// 槽位不存在时返回 <see cref="Vector2.zero"/>。
        /// 供 EnemyBase.OnDrawGizmos 定位各感知圆心使用，避免所有圆重叠在 transform.position。
        /// </summary>
        Vector2 GetSensorOffset(string slotName);

        /// <summary>暂停或恢复感知系统（LOD / 超出活跃范围时调用）。</summary>
        void SetSuspended(bool suspended);
    }
}