初始提交：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>

vendor/libghostty-spm/Sources/GhosttyTerminal/Metrics/TerminalInputModifiers.swift

@@ -0,0 +1,62 @@
+//
+//  TerminalInputModifiers.swift
+//  libghostty-spm
+//
+//  Created by Lakr233 on 2026/3/16.
+//
+
+import GhosttyKit
+
+#if canImport(UIKit)
+    import UIKit
+#elseif canImport(AppKit)
+    import AppKit
+#endif
+
+public struct TerminalInputModifiers: OptionSet, Sendable {
+    public let rawValue: UInt32
+
+    public init(rawValue: UInt32) {
+        self.rawValue = rawValue
+    }
+
+    public static let shift = TerminalInputModifiers(rawValue: 1 << 0)
+    public static let ctrl = TerminalInputModifiers(rawValue: 1 << 1)
+    public static let alt = TerminalInputModifiers(rawValue: 1 << 2)
+    public static let super_ = TerminalInputModifiers(rawValue: 1 << 3)
+    public static let caps = TerminalInputModifiers(rawValue: 1 << 4)
+    public static let num = TerminalInputModifiers(rawValue: 1 << 5)
+    public static let shiftRight = TerminalInputModifiers(rawValue: 1 << 6)
+    public static let ctrlRight = TerminalInputModifiers(rawValue: 1 << 7)
+    public static let altRight = TerminalInputModifiers(rawValue: 1 << 8)
+    public static let superRight = TerminalInputModifiers(rawValue: 1 << 9)
+
+    public var ghosttyMods: ghostty_input_mods_e {
+        ghostty_input_mods_e(rawValue)
+    }
+
+    #if canImport(UIKit)
+        public init(from flags: UIKeyModifierFlags) {
+            var mods = TerminalInputModifiers()
+            if flags.contains(.shift) { mods.insert(.shift) }
+            if flags.contains(.control) { mods.insert(.ctrl) }
+            if flags.contains(.alternate) { mods.insert(.alt) }
+            if flags.contains(.command) { mods.insert(.super_) }
+            if flags.contains(.alphaShift) { mods.insert(.caps) }
+            if flags.contains(.numericPad) { mods.insert(.num) }
+            self = mods
+        }
+
+    #elseif canImport(AppKit)
+        public init(from flags: NSEvent.ModifierFlags) {
+            var mods = TerminalInputModifiers()
+            if flags.contains(.shift) { mods.insert(.shift) }
+            if flags.contains(.control) { mods.insert(.ctrl) }
+            if flags.contains(.option) { mods.insert(.alt) }
+            if flags.contains(.command) { mods.insert(.super_) }
+            if flags.contains(.capsLock) { mods.insert(.caps) }
+            if flags.contains(.numericPad) { mods.insert(.num) }
+            self = mods
+        }
+    #endif
+}