You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Document mouse/trackpad click handling in Gesture mode
Spec that primary mouse/trackpad clicks (alongside touches and pen
presses) open the radial menu so /tether is usable on desktop without a
touchscreen, and clarify that non-primary buttons remain unhandled.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
| Gestures |`Gestures`|`HandPointingIcon`| Always available | Pane-content touches open the Gesture mode radial menu. |
90
+
| Gestures |`Gestures`|`HandPointingIcon`| Always available | Pane-content touches, pen presses, and primary mouse/trackpad clicks open the Gesture mode radial menu. |
91
91
| Text selection |`Select`|`CursorTextIcon`| Always available | Touches are reserved for terminal text selection and copy/paste. If the TUI is capturing mouse events, MouseTerm activates mouse override for the active pane. |
92
92
| Cursor |`Cursor`|`CursorClickIcon`| Only when the active TUI is capturing mouse events | Touches are passed through as terminal mouse/cursor input. |
93
93
@@ -96,6 +96,16 @@ Default touch mode is **Gestures**.
96
96
If Cursor mode is active and the active pane stops capturing mouse events, the
97
97
selector must fall back to Gestures.
98
98
99
+
Gesture mode intentionally consumes primary mouse/trackpad clicks in addition to
100
+
touch input. This keeps the `/tether` prototype usable in desktop browsers,
101
+
narrow desktop viewports, and Storybook without a touchscreen. A primary
102
+
mouse/trackpad click in pane content must start radial gesture handling, call
103
+
`preventDefault()`, stop propagation, and capture that pointer; it is not passed
104
+
through to the embedded `Wall`, xterm, or dockview for focus, selection, or pane
105
+
interaction. Non-primary mouse buttons are ignored by gesture handling so their
106
+
browser or host behavior can continue. Users who want terminal selection or TUI
107
+
mouse input must choose Select or Cursor mode explicitly.
108
+
99
109
## 5. Gesture Mode
100
110
101
111
Gesture mode is the default pane-content touch behavior. Tapping the pane content
0 commit comments