namespace BaseGames.Core.Events
{
    /// <summary>
    /// 奖励接收目标接口（架构 22_QuestChallengeModule §4）。
    /// 由 <see cref="RewardSO.Apply"/> 调用，解除 BaseGames.Quest 对 BaseGames.Player 的直接依赖。
    /// PlayerStats 实现此接口，QuestManager 持有 IRewardTarget 引用。
    /// 能力类型以 uint 位掩码传递（与 Player.AbilityType : uint 一致），避免跨程序集枚举引用。
    /// </summary>
    public interface IRewardTarget
    {
        /// <summary>增加 Geo（货币）。</summary>
        void AddGeo(int amount);

        /// <summary>增加灵魂力量上限。</summary>
        void AddSoulPower(int amount);

        /// <summary>解锁指定能力（abilityFlag 为 AbilityType 的 uint 位掩码值）。</summary>
        void UnlockAbilityFlag(uint abilityFlag);
    }
}