import { Hotkey, ValidationResult } from "./hotkey.cjs";

//#region src/validate.d.ts
/**
 * Validates a hotkey string and returns any warnings or errors.
 *
 * Checks for:
 * - Valid syntax (modifier+...+key format)
 * - Known modifiers
 * - Known keys
 *
 * @param hotkey - The hotkey string to validate
 * @returns A ValidationResult with validity status, warnings, and errors
 *
 * @example
 * ```ts
 * validateHotkey('Mod+S')
 * // { valid: true, warnings: [], errors: [] }
 *
 * validateHotkey('')
 * // { valid: false, warnings: [], errors: ['Hotkey cannot be empty'] }
 * ```
 */
declare function validateHotkey(hotkey: Hotkey | (string & {})): ValidationResult;
/**
 * Validates a hotkey and throws an error if invalid.
 * Useful for development-time validation.
 *
 * @param hotkey - The hotkey string to validate
 * @throws Error if the hotkey is invalid
 *
 * @example
 * ```ts
 * assertValidHotkey('Mod+S') // OK
 * assertValidHotkey('') // Throws Error: Invalid hotkey: Hotkey cannot be empty
 * ```
 */
declare function assertValidHotkey(hotkey: Hotkey | (string & {})): void;
/**
 * Validates a hotkey and logs warnings to the console.
 * Useful for development-time feedback.
 *
 * @param hotkey - The hotkey string to validate
 * @returns True if the hotkey is valid (may still have warnings)
 *
 * @example
 * ```ts
 * checkHotkey('Alt+C')
 * // Console: Warning: Alt+C may not work reliably on macOS...
 * // Returns: true
 * ```
 */
declare function checkHotkey(hotkey: Hotkey | (string & {})): boolean;
//#endregion
export { assertValidHotkey, checkHotkey, validateHotkey };
//# sourceMappingURL=validate.d.cts.map