/**
 * terminal-links — OSC 8 clickable hyperlink support for terminal UIs.
 *
 * Modern terminals (iTerm2, WezTerm, Windows Terminal, VS Code integrated
 * terminal, Hyper, Tabby, Ghostty, most xterm-compatible) support the OSC 8
 * escape sequence for clickable hyperlinks:
 *
 *   \x1b]8;;URL\x1b\\displayed text\x1b]8;;\x1b\\
 *
 * Terminals that don't support OSC 8 simply ignore the escape and show the
 * display text, so this is safe to use unconditionally.
 */
/**
 * Wrap text in an OSC 8 clickable hyperlink escape sequence.
 *
 * If `text` is omitted, the URL itself is used as display text.
 * The escape sequence is ignored by terminals that don't support it,
 * so the display text always shows through.
 */
export declare function hyperlink(url: string, text?: string): string;
/**
 * Check if the current terminal likely supports OSC 8 hyperlinks.
 *
 * This is a best-effort heuristic. OSC 8 is safe to emit even in
 * unsupported terminals (they just ignore the escape), so this is
 * mainly useful for deciding whether to show a "(click to open)" hint.
 */
export declare function supportsHyperlinks(): boolean;
/**
 * Wrap all bare URLs found in `text` with OSC 8 hyperlinks.
 *
 * Non-URL text is left unchanged. This is useful for system messages
 * where URLs appear inline but aren't in markdown link syntax.
 */
export declare function linkifyUrls(text: string): string;
