fix(tui): open rendered links on click

AGENTS.md

@@ -19,6 +19,13 @@
 - Expose the meaningful state dimensions through story keybindings and list them in `StoryFooter`; include a reset command when combinations can leave the fixture in a confusing state.
 - Run a specific story with `OPENCODE_STORY=<story-id> bun run dev:live` from the development worktree, and exercise narrow and wide terminal sizes when layout is relevant.
 
+## TUI Theme Tokens
+
+- Choose theme tokens by semantic role, not by their current color. Do not use raw `theme.hue` values or borrow an unrelated semantic token to achieve a preferred appearance.
+- Use `text.feedback` and `background.feedback` only for outcome or status feedback such as errors, warnings, success messages, and informational messages. Use `formfield` states for form-control text, ordinals, and selection markers, and `action` states for actions.
+- If the theme does not expose a token for the required semantic role, extend the theme schema, defaults, resolution, and types with that role before using it in a component. Do not repurpose the nearest-looking existing token.
+- When changing the public theme token surface, verify the built-in light and dark defaults and the custom-theme fallback path in addition to the affected TUI component.
+
 ## Branch Names
 
 Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as `feat/` or `fix/`.

packages/tui/src/app.tsx

@@ -44,6 +44,7 @@ import {
   type TuiApp,
 } from "./context/runtime"
 import { DialogProvider, useDialog } from "./ui/dialog"
+import { linkAt } from "./ui/link"
 import { DialogIntegration } from "./component/dialog-integration"
 import { ErrorComponent } from "./component/error-component"
 import { PluginRouteMissing } from "./component/plugin-route-missing"
@@ -1270,7 +1271,13 @@ function App(props: { pair?: DialogPairCredentials }) {
         evt.preventDefault()
         evt.stopPropagation()
       }}
-      onMouseUp={copyOnSelectEnabled() ? () => Selection.copy(renderer, toast, clipboard) : undefined}
+      onMouseUp={(event) => {
+        if (copyOnSelectEnabled()) Selection.copy(renderer, toast, clipboard)
+        if (event.defaultPrevented || event.button !== MouseButton.LEFT || event.isDragging) return
+        const href = linkAt(renderer.currentRenderBuffer, event.x, event.y)
+        if (!href) return
+        open(href).catch(() => {})
+      }}
     >
       <box
         flexGrow={1}

packages/tui/src/routes/session/form.tsx

@@ -904,7 +904,13 @@ export function FormPrompt(props: {
                               <text
                                 width={4}
                                 flexShrink={0}
-                                fg={picked() ? theme.text.feedback.success.default : theme.text.subdued}
+                                fg={
+                                  active()
+                                    ? theme.text.formfield.focused
+                                    : picked()
+                                      ? theme.text.formfield.selected
+                                      : theme.text.subdued
+                                }
                               >
                                 [{picked() ? "✓" : " "}]
                               </text>
@@ -914,7 +920,7 @@ export function FormPrompt(props: {
                             </text>
                           </box>
                           <Show when={!multi()}>
-                            <text fg={theme.text.feedback.success.default}>{picked() ? " ✓" : ""}</text>
+                            <text fg={theme.text.formfield.selected}>{picked() ? " ✓" : ""}</text>
                           </Show>
                         </box>
                         <Show when={row.description}>
@@ -953,7 +959,13 @@ export function FormPrompt(props: {
                           <text
                             width={4}
                             flexShrink={0}
-                            fg={customChecked() ? theme.text.feedback.success.default : theme.text.subdued}
+                            fg={
+                              other()
+                                ? theme.text.formfield.focused
+                                : customChecked()
+                                  ? theme.text.formfield.selected
+                                  : theme.text.subdued
+                            }
                           >
                             [{customChecked() ? "✓" : " "}]
                           </text>
@@ -966,7 +978,7 @@ export function FormPrompt(props: {
                                 {input() || "Type your own answer"}
                               </text>
                               <Show when={!multi() && customPicked()}>
-                                <text fg={theme.text.feedback.success.default}>✓</text>
+                                <text fg={theme.text.formfield.selected}>✓</text>
                               </Show>
                             </>
                           }

packages/tui/src/ui/link.tsx

@@ -1,5 +1,5 @@
 import type { JSX } from "solid-js"
-import type { RGBA } from "@opentui/core"
+import { getLinkId, type OptimizedBuffer, type RGBA } from "@opentui/core"
 import open from "open"
 
 export interface LinkProps {
@@ -24,7 +24,8 @@ export function Link(props: LinkProps) {
       bg={props.bg}
       width={props.width}
       wrapMode={props.wrapMode}
-      onMouseUp={() => {
+      onMouseUp={(event) => {
+        event.stopPropagation()
         open(props.href).catch(() => {})
       }}
     >
@@ -32,3 +33,11 @@ export function Link(props: LinkProps) {
     </text>
   )
 }
+
+export function linkAt(buffer: OptimizedBuffer, x: number, y: number) {
+  if (x < 0 || x >= buffer.width || y < 0 || y >= buffer.height) return
+  const id = getLinkId(buffer.buffers.attributes[y * buffer.width + x] ?? 0)
+  if (!id) return
+  const lib = buffer.lib as typeof buffer.lib & { linkGetUrl(id: number): string }
+  return lib.linkGetUrl(id) || undefined
+}

packages/tui/test/ui/link.test.ts

@@ -0,0 +1,28 @@
+import { expect, test } from "bun:test"
+import { StyledText, TextRenderable } from "@opentui/core"
+import { createTestRenderer, setRendererCapabilities } from "@opentui/core/testing"
+import { linkAt } from "../../src/ui/link"
+
+test("resolves terminal hyperlink metadata at the clicked cell", async () => {
+  const app = await createTestRenderer({ width: 60, height: 4 })
+  setRendererCapabilities(app.renderer, { hyperlinks: true })
+  const href = "file:///tmp/example.ts#L12"
+  app.renderer.root.add(
+    new TextRenderable(app.renderer, {
+      content: new StyledText([{ __isChunk: true, text: "example", link: { url: href } }]),
+      width: "100%",
+      height: 1,
+    }),
+  )
+
+  try {
+    await app.waitForFrame((frame) => frame.includes("example"))
+    const buffer = app.renderer.currentRenderBuffer
+    const links = Array.from({ length: buffer.width * buffer.height }, (_, index) =>
+      linkAt(buffer, index % buffer.width, Math.floor(index / buffer.width)),
+    )
+    expect(links).toContain(href)
+  } finally {
+    app.renderer.destroy()
+  }
+})