fix(web): restore terminal link hover styles

[StiensWout]

Problem

The Ghostty canvas migration preserved terminal link hit-testing and activation, but did not carry over xterm's hover decorations. URLs and file paths still opened with Ctrl/Cmd-click, yet there was no underline or pointer feedback to show that they were interactive.

Fix

• track the hovered implicit or OSC 8 terminal link and its complete cell range
• show the pointer cursor without requiring the activation modifier
• repaint the full link underline on hover, including wrapped links and links after wide characters
• keep Ctrl/Cmd-click as the activation safeguard

Verification

• ../../node_modules/.bin/vp test run --project unit src/terminal/ghostty/surface.test.ts src/terminal/ghostty/renderer.test.ts (40 tests)
• vp run --filter @t3tools/web typecheck
• targeted vp lint and vp fmt --check
• Playwright interaction against an isolated T3 web environment

Generated with GPT-5.6-Sol in T3 Code (Codex harness).

---

Note

Low Risk
Terminal UI and pointer/render paths only; behavior is covered by unit tests and does not change link activation or PTY I/O semantics.

Overview
Brings back xterm-style link hover feedback on the Ghostty canvas terminal: pointer cursor and underlines on implicit URLs/paths and OSC 8 links, without requiring Ctrl/Cmd until click.

Link resolution now returns a full cell range (terminalLinkAtPositionWithRange, plus range expansion for explicit hyperlinks across soft wraps). Hit-testing uses terminalGridCellAt so pointers outside the padded grid do not clamp to edge cells.

Rendering passes hoveredLinkRange into renderGhosttySnapshot, which underlines every cell in the range (including multi-row wraps). The surface tracks hover on move, clears on leave/selection drags, and suppresses hover during mouse-tracking unless the link modifier is held (shouldShowTerminalLinkHover); modifier key state updates on keydown/keyup and blur.

Activation is unchanged: onLinkActivate still receives link text only on Ctrl/Cmd-click.

^{Reviewed by Cursor Bugbot for commit b8e5747. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Restore terminal link hover styles with underline rendering and cursor feedback

• Adds hoveredLinkRange tracking to GhosttyTerminalSurface so that when a user hovers over a link, the full cell range (including wrapped lines) is underlined during rendering.
• Introduces terminalGridCellAt, terminalLinkAtPositionWithRange, and shouldShowTerminalLinkHover utilities in surface.ts to map pointer coordinates to grid cells and determine when hover feedback is appropriate.
• Suppresses link hover UI while application mouse tracking is active unless the link modifier key is held.
• Extends renderGhosttySnapshot in renderer.ts to accept an optional hoveredLinkRange and underline all cells within that range, including across row wraps.

^{Macroscope summarized b8e5747.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c1d31778-1921-44ac-b64b-6024af71198d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Approvability

Verdict: Approved b8e5747

Self-contained UI fix that restores terminal link hover underlines. Changes are well-tested and limited to the terminal rendering subsystem with no security or schema implications. Author is the primary contributor to these files.

^{You can customize Macroscope's approvability policy. Learn more.}

Dismissing prior approval to re-evaluate f2e6b6e

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit f2e6b6e. Configure here.}