namespace BaseGames.Core
{
    /// <summary>
    /// 难度服务接口（架构 §DifficultyModule）。
    /// 提供当前难度档位及缩放参数，供跨程序集的游戏系统（战斗、商店、掉落等）查询，
    /// 无需直接依赖 <see cref="DifficultyManager"/> 具体类型。
    /// </summary>
    public interface IDifficultyService
    {
        /// <summary>当前难度档位。</summary>
        DifficultyLevel CurrentLevel { get; }

        /// <summary>当前档位对应的缩放配置。未配置时返回 null。</summary>
        DifficultyScalerSO CurrentScaler { get; }

        /// <summary>切换到指定难度。SteelSoul 模式一旦选定不可降级。</summary>
        void ChangeDifficulty(DifficultyLevel level);

        /// <summary>按档位查找缩放器，未配置时返回 null。</summary>
        DifficultyScalerSO GetScaler(DifficultyLevel level);
    }
}