namespace BaseGames.Tutorial
{
    /// <summary>
    /// 教程提示服务接口。通过 ServiceLocator 注册，供触发器和测试使用。
    /// </summary>
    public interface ITutorialService
    {
        /// <summary>显示提示。若 hintId 已完成则忽略。</summary>
        void ShowHint(string hintId, string text, float duration = 4f);

        /// <summary>标记提示为已完成并隐藏当前显示中的提示。</summary>
        void CompleteHint(string hintId);

        /// <summary>查询指定提示是否已完成。</summary>
        bool IsHintCompleted(string hintId);
    }
}