Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

💡 OSC 8 hyperlink support

Đang mở
  • Có gì không ổn?
#67 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
55/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
c, typescript
Lĩnh vực
cli

Hướng nghiên cứu

Bắt đầu với kiểm thử đang thất bại trong test/osc8-hyperlinks.test.ts và thao tác văn bản trong ops.ts. Theo dõi quá trình giải mã văn bản qua reduce tại src/clayterm.c:562, sau đó xác minh rằng renderer phát ra OSC 8 xung quanh run, đồng thời giữ các byte liên kết có độ rộng bằng không khi render và đo lường.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement

Is your feature request related to a problem?

There's no built-in way to render a hyperlink inside text. Terminals support OSC 8 hyperlinks (ESC ]8;;<url> … ESC ]8;;), which render as clickable links, but text only takes a string plus styling—so a CLI can't emit a clickable URL without hand-writing the escape sequence and fighting the renderer's U+FFFD substitution.

Describe the solution you'd like

Either a new link("value", { href: "https://example.com" }) util, or extending the text options with an optional { href }.

link("docs", { href: "https://example.com" });
text("docs", { href: "https://example.com" });
// emits:  ESC ]8;;https://example.com ST   docs   ESC ]8;; ST

The link text renders and measures like normal text; the OSC 8 open/close bytes are zero-width.

Describe alternatives you've considered

Putting the OSC 8 bytes inside the content string doesn't work today—they'd be mangled to U+FFFD. A verbatim-passthrough escape hatch (#66) would let you hand-roll it, but a first-class href option keeps width accounting correct and the call site readable.

Additional context

Failing test case on nm/repro/osc8-hyperlinks (test · diff).

Needs an href field on the text op (ops.ts)—or a link() helper that sets it—carried through the text decode in reduce (src/clayterm.c:562); the renderer emits the OSC 8 open before the run's glyph cells and the close after, both zero-width.

Ngôn ngữ chính
TypeScript
Star
42
Fork
2
Merge trung bình
21 giờ 40 phút
Pull request đã merge (30 ngày)
9

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của bombshell-dev/tty

Tất cả issue của bombshell-dev/tty

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.