初始提交：terminalX 可运行态（M0/M1/M1.5 已真机验证）
- M0: libghostty SSH 终端（渲染/输入/连接）+ 白屏修复(OutputGate) + 会话状态机/自动重连 - M1: tsnet 用户态组网 + SSH-over-tsnet(fd 桥)，shell 级真机验证；R5(Go+gvisor+C+++Swift 同进程) retire - M1.5: tmux -CC 原生 tab（MVP） - 结构: packages/(TXCore·TXTransport), apps/TerminalX, vendor/(libghostty-spm/libssh2/mbedtls/tsnet-bridge), artifacts/ - 文档: CLAUDE.md + docs/HANDOFF.md（新会话入口） - 环境: 认证代理→依赖 vendor 本地化；Go 在 ~/.local/go；仅模拟器/未签名 - 待续: M2 mosh, tmux 多 pane, M4 安全(host key/SE) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
kid
89
vendor/libghostty-spm/docs/guide/text-selection.html
vendored
Normal file
89
vendor/libghostty-spm/docs/guide/text-selection.html
vendored
Normal file
@@ -0,0 +1,89 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="color-scheme" content="light dark">
|
||||
<title>GhosttyKit · Text selection</title>
|
||||
<link rel="stylesheet" href="../styles.css">
|
||||
<link rel="stylesheet"
|
||||
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/styles/github.min.css"
|
||||
integrity="sha384-eFTL69TLRZTkNfYZOLM+G04821K1qZao/4QLJbet1pP4tcF+fdXq/9CdqAbWRl/L"
|
||||
crossorigin="anonymous"
|
||||
media="(prefers-color-scheme: light)">
|
||||
<link rel="stylesheet"
|
||||
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/styles/github-dark.min.css"
|
||||
integrity="sha384-wH75j6z1lH97ZOpMOInqhgKzFkAInZPPSPlZpYKYTOqsaizPvhQZmAtLcPKXpLyH"
|
||||
crossorigin="anonymous"
|
||||
media="(prefers-color-scheme: dark)">
|
||||
</head>
|
||||
<body>
|
||||
<nav class="topbar" aria-label="Primary">
|
||||
<a class="home" href="../index.html">GhosttyKit</a>
|
||||
<a href="../index.html">Overview</a>
|
||||
<a href="index.html" aria-current="page">Guide</a>
|
||||
<a href="../api/index.html">API</a>
|
||||
<a href="../architecture.html">Architecture</a>
|
||||
<a href="../build.html">Build</a>
|
||||
</nav>
|
||||
|
||||
<main>
|
||||
<h1>Text selection</h1>
|
||||
<nav class="on-this-page" aria-label="On this page">
|
||||
<strong>On this page:</strong>
|
||||
<a href="#flow">Flow</a>
|
||||
<a href="#delegate">Delegate</a>
|
||||
<a href="#range">Ranges</a>
|
||||
</nav>
|
||||
|
||||
<p>On iOS, a single-finger long press requests host text selection. GhosttyKit sends a viewport snapshot, a suggested UTF-16 range, and the source point for anchoring UI.</p>
|
||||
|
||||
<h2 id="flow">Flow</h2>
|
||||
<ol>
|
||||
<li>The user long-presses the terminal view for 0.5 seconds.</li>
|
||||
<li>The view asks Ghostty for a viewport text snapshot and a quicklook word anchor.</li>
|
||||
<li><code>TerminalTextSelectionRequest</code> arrives at the delegate.</li>
|
||||
<li>The host presents its own UI, commonly a <code>UITextView</code> sheet or popover.</li>
|
||||
</ol>
|
||||
|
||||
<h2 id="delegate">Delegate</h2>
|
||||
<pre><code class="language-swift">final class SelectionCoordinator: TerminalSurfaceTextSelectionRequestDelegate {
|
||||
func terminalDidRequestTextSelection(_ request: TerminalTextSelectionRequest) {
|
||||
let textView = UITextView()
|
||||
textView.text = request.text
|
||||
|
||||
if let range = request.anchorRange {
|
||||
textView.selectedRange = range
|
||||
} else {
|
||||
textView.selectAll(nil)
|
||||
}
|
||||
|
||||
presentSelectionUI(textView, sourcePoint: request.sourcePoint)
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
|
||||
<h2 id="range">Ranges</h2>
|
||||
<p><code>anchorRange</code> uses UTF-16 units so it can be assigned directly to <code>UITextView.selectedRange</code>. Duplicate words on the same row are disambiguated with the long-press x coordinate and Ghostty cell metrics.</p>
|
||||
<p class="muted">The MVP targets the in-memory backend and viewport text. Full scrollback selection belongs in a host selection surface.</p>
|
||||
|
||||
<nav class="pager" aria-label="Sibling pages">
|
||||
<a class="prev" href="themes.html">Themes</a>
|
||||
<a class="parent" href="index.html">↑ Guide</a>
|
||||
<a class="next" href="shellcraft.html">ShellCraftKit</a>
|
||||
</nav>
|
||||
|
||||
<footer>
|
||||
GhosttyKit · <a href="https://github.com/Lakr233/libghostty-spm">github.com/Lakr233/libghostty-spm</a>
|
||||
</footer>
|
||||
</main>
|
||||
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/highlight.min.js"
|
||||
integrity="sha384-GdEWAbCjn+ghjX0gLx7/N1hyTVmPAjdC2OvoAA0RyNcAOhqwtT8qnbCxWle2+uJX"
|
||||
crossorigin="anonymous"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.10.0/languages/swift.min.js"
|
||||
integrity="sha384-TfALNLT6HJzZieazgsVvFM0DzFWQsgl0d7mdwPLyg1yg7XE4QwLY4jqmJRNnI1S4"
|
||||
crossorigin="anonymous"></script>
|
||||
<script>hljs.highlightAll();</script>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user