oppi.li
source dump of claude code
1import chalk from 'chalk'
2import { supportsHyperlinks } from '../ink/supports-hyperlinks.js'
3
4// OSC 8 hyperlink escape sequences
5// Format: \e]8;;URL\e\\TEXT\e]8;;\e\\
6// Using \x07 (BEL) as terminator which is more widely supported
7export const OSC8_START = '\x1b]8;;'
8export const OSC8_END = '\x07'
9
10type HyperlinkOptions = {
11 supportsHyperlinks?: boolean
12}
13
14/**
15 * Create a clickable hyperlink using OSC 8 escape sequences.
16 * Falls back to plain text if the terminal doesn't support hyperlinks.
17 *
18 * @param url - The URL to link to
19 * @param content - Optional content to display as the link text (only when hyperlinks are supported).
20 * If provided and hyperlinks are supported, this text is shown as a clickable link.
21 * If hyperlinks are not supported, content is ignored and only the URL is shown.
22 * @param options - Optional overrides for testing (supportsHyperlinks)
23 */
24export function createHyperlink(
25 url: string,
26 content?: string,
27 options?: HyperlinkOptions,
28): string {
29 const hasSupport = options?.supportsHyperlinks ?? supportsHyperlinks()
30 if (!hasSupport) {
31 return url
32 }
33
34 // Apply basic ANSI blue color - wrap-ansi preserves this across line breaks
35 // RGB colors (like theme colors) are NOT preserved by wrap-ansi with OSC 8
36 const displayText = content ?? url
37 const coloredText = chalk.blue(displayText)
38 return `${OSC8_START}${url}${OSC8_END}${coloredText}${OSC8_START}${OSC8_END}`
39}