namespace SLSUtilities.Feedback
{
    /// <summary>
    /// 时间提供者接口，框架层不依赖具体的 TimeManager 实现。
    /// 游戏层通过 SelfTimeSubmodule 或适配器类实现此接口，注入到 FeedbackPlayer 中。
    /// </summary>
    public interface IFeedbackTimeProvider
    {
        /// <summary>
        /// 全局时间缩放值。
        /// </summary>
        float GlobalTimeScale { get; }

        /// <summary>
        /// 分组时间缩放值，由具体实现根据 Fraction 返回对应值。
        /// </summary>
        float GroupTimeScale { get; }

        /// <summary>
        /// 角色本地时间缩放值。
        /// </summary>
        float LocalTimeScale { get; }

        /// <summary>
        /// 根据时间设置计算实际 deltaTime（秒）。
        /// </summary>
        float GetDeltaTime(FeedbackTimeSettings settings);

        /// <summary>
        /// 根据时间设置计算综合时间缩放系数（无 deltaTime 乘入）。
        /// 返回 1.0 表示正常速度。
        /// </summary>
        float GetTimeScale(FeedbackTimeSettings settings);
    }
}