namespace Hua.Todo.Maui.Services
{
    /// <summary>
    /// 全局热键服务接口，定义跨平台热键功能
    /// </summary>
    public interface IGlobalHotKeyService
    {
        /// <summary>
        /// 注册全局热键
        /// </summary>
        /// <param name="modifiers">修饰键（如 Alt, Control 等）</param>
        /// <param name="key">主键（如 X, C 等）</param>
        /// <param name="callback">热键触发时的回调函数</param>
        void RegisterHotKey(string modifiers, string key, Action callback);
        
        /// <summary>
        /// 注销已注册的热键
        /// </summary>
        void UnregisterHotKey();
        
        /// <summary>
        /// 更新热键配置
        /// </summary>
        /// <param name="modifiers">新的修饰键</param>
        /// <param name="key">新的主键</param>
        void UpdateHotKey(string modifiers, string key);
        
        /// <summary>
        /// 当前平台是否支持全局热键
        /// </summary>
        bool IsSupported { get; }
    }
}