namespace BaseGames.Combat
{
    /// <summary>
    /// 可受击实体接口。PlayerController 和 EnemyBase 实现此接口。
    /// HurtBox.Awake 通过 GetComponentInParent&lt;IDamageable&gt;() 注入。
    /// </summary>
    public interface IDamageable
    {
        bool IsAlive      { get; }
        bool IsInvincible { get; }
        int  Defense      { get; }
        void TakeDamage(DamageInfo info);
    }

    /// <summary>
    /// 攻击被弹反时的反制承受方（攻击发起者实现，如 EnemyBase）。
    ///
    /// 存在的理由是程序集方向：Combat 不能反向依赖 Enemies，而弹反成功的判定点
    /// （<see cref="HurtBox.ReceiveDamage"/>）是唯一同时握有弹反结果与
    /// <see cref="DamageInfo"/> 的地方，所以攻击者只能以接口形态经 DamageInfo 传进来。
    /// 与 <see cref="IDamageable"/> 同款做法。
    /// </summary>
    public interface IParryable
    {
        /// <summary>本方发起的攻击被弹反：进入硬直 <paramref name="staggerDuration"/> 秒。</summary>
        void ReceiveParry(float staggerDuration);
    }

    /// <summary>
    /// 可持有霸体的实体接口。HurtBox 在 ReceiveDamage 中做等级比较。
    /// </summary>
    public interface IPoiseSource
    {
        PoiseLevel GetCurrentPoiseLevel();
    }

    /// <summary>
    /// 护盾接口（玩家专属）。由 PlayerController.Awake() 注入 HurtBox。
    /// AbsorbDamage 返回穿透量（0 = 全部吸收，>0 = 穿透量继续走 TakeDamage 流程）。
    /// </summary>
    public interface IShieldable
    {
        bool HasShield { get; }
        int  AbsorbDamage(int amount);
    }

    /// <summary>
    /// 可破坏机关/障碍物接口。HitBox 在命中非 HurtBox 对象时尝试调用。
    /// </summary>
    public interface IBreakable
    {
        void TryInteract(DamageInfo info);
    }

    /// <summary>
    /// 可施加状态效果的实体接口（避免 Combat 直接引用 StatusEffects 程序集）。
    /// StatusEffectManager 实现此接口；HurtBox.ReceiveDamage 步骤 8 通过此接口调用。
    /// </summary>
    public interface IStatusEffectable
    {
        void ApplyStatusEffect(DamageType type);
    }
}