namespace BaseGames.Animation
{
    /// <summary>
    /// 动画事件接收接口（架构 §AnimationModule）。
    /// 由 PlayerAnimationEvents / EnemyAnimationEvents 实现。
    /// AnimationEventBinder 将 Animancer 回调路由至此接口，避免硬耦合。
    /// </summary>
    public interface IAnimationEventHandler
    {
        /// <summary>
        /// 处理由 Animancer ClipTransition 触发的动画事件。
        /// </summary>
        /// <param name="type">事件类型。</param>
        /// <param name="payload">附加字符串数据（可为 null 或空）。</param>
        void HandleEvent(AnimationEventType type, string payload);
    }
}