namespace BaseGames.Player.States
{
    /// <summary>
    /// 使用灵泉（治疗）状态（架构 05_PlayerModule §2）。
    /// 消耗 SpringCharge，播放治愈动画；动画结束后回到 Idle。
    /// 需在地面且有充能才能进入（PlayerController 负责条件检查）。
    ///
    /// 动画在 Overlay Layer（Layer 1）播放，叠加于 Base Layer 的 Idle/Run 之上，
    /// 符合架构 05_PlayerModule §14 双层动画设计。
    /// </summary>
    public class SpringState : PlayerStateBase
    {
        public SpringState(PlayerController owner) : base(owner) { }

        public override void OnStateEnter()
        {
            // 消耗灵泉充能并治疗（PlayerStats.UseSpring 内部回复 HP）
            bool used = Stats?.UseSpring() ?? false;
            if (!used)
            {
                // 无充能时立即退出
                Owner.TransitionTo(Owner.GetState<IdleState>());
                return;
            }

            // 停止移动
            Move?.ZeroHorizontalVelocity();

            // 在 Overlay Layer（Layer 1）播放灵泉动画，叠加于 Base Layer 的 Idle 之上
            if (AnimCfg?.UseSpring != null)
            {
                var state = Owner.PlayOnOverlay(AnimCfg.UseSpring);
                if (state != null)
                {
                    state.Events(this).OnEnd = OnSpringEnd;
                    return;
                }
            }

            // 无动画则直接结束
            OnSpringEnd();
        }

        public override void OnStateExit()
        {
            // 淡出叠加层，恢复纯 Base Layer 动画
            Owner.StopOverlay(fadeDuration: 0.1f);
        }

        private void OnSpringEnd()
        {
            Owner.TransitionTo(Owner.GetState<IdleState>());
        }
    }
}