import { FormatDisplayOptions, Hotkey, ParsedHotkey, RegisterableHotkey } from "./hotkey.cjs";

//#region src/format.d.ts
/**
 * Converts a hotkey sequence array to a display string.
 *
 * @param sequence - Array of hotkey strings that form the sequence
 * @returns A space-separated string (e.g. ['G','G'] → 'G G')
 *
 * @example
 * ```ts
 * formatHotkeySequence(['G', 'G'])      // 'G G'
 * formatHotkeySequence(['D', 'I', 'W']) // 'D I W'
 * ```
 */
declare function formatHotkeySequence(sequence: Array<Hotkey>): string;
/**
 * Converts a ParsedHotkey back to a hotkey string.
 *
 * @param parsed - The parsed hotkey object
 * @returns A hotkey string in canonical form
 *
 * @example
 * ```ts
 * formatHotkey({ key: 'S', ctrl: true, shift: true, alt: false, meta: false, modifiers: ['Control', 'Shift'] })
 * // Returns: 'Control+Shift+S'
 * ```
 */
declare function formatHotkey(parsed: ParsedHotkey): string;
/**
 * Formats a hotkey for display in a user interface.
 *
 * On macOS, uses symbols (⌘⇧S) in the same modifier order as {@link normalizeHotkeyFromParsed}.
 * On Windows/Linux, uses text (Ctrl+Shift+S) with `+` separators.
 * The separator can be customized with `separatorToken`.
 *
 * @param hotkey - The hotkey string or ParsedHotkey to format
 * @param options - Formatting options
 * @returns A formatted string suitable for display
 *
 * @example
 * ```ts
 * formatForDisplay('Mod+Shift+S', { platform: 'mac' })
 * // Returns: '⌘ ⇧ S' (symbols separated by spaces on macOS)
 *
 * formatForDisplay('Mod+Shift+S', { platform: 'windows' })
 * // Returns: 'Ctrl+Shift+S'
 *
 * formatForDisplay('Escape')
 * // Returns: 'Esc' (on all platforms)
 * ```
 */
declare function formatForDisplay(hotkey: RegisterableHotkey | (string & {}), options?: FormatDisplayOptions): string;
/**
 * @deprecated Use {@link formatForDisplay} instead with `useSymbols: false` option.
 */
declare function formatWithLabels(hotkey: RegisterableHotkey, options?: Omit<FormatDisplayOptions, 'useSymbols'>): string;
//#endregion
export { formatForDisplay, formatHotkey, formatHotkeySequence, formatWithLabels };
//# sourceMappingURL=format.d.cts.map