[fix] the voice pane swipes from anywhere, not only from the record button

[YJack0000]

Why

Report from the owner: swiping switches keyboard panes, but on the voice pane only the record button responds. Swiping anywhere else there does nothing.

The pane track in KeyboardRootView read its swipe with a plain .gesture, and a plain gesture loses to whatever the finger lands on. A Button holds the touch until it lifts, so a swipe that began on a key reached the track only at release, and the track never followed the finger. The zero-distance drag behind ⌫ (RepeatingKey) took the touch outright. That arbitration has been in place since #266 (715e1a1), which put the drag on the track. #397 did not touch it.

The track now reads the touch alongside the keys (simultaneousGesture) and disables the panes for as long as its drag is in flight. Once the swipe engages at 24pt, the key under the finger is cancelled the way a scroll view cancels a button's touch, so the swipe neither types the key nor fires the record button. A tap still presses and fires. RepeatingKey keeps its press in a @GestureState, which resets on that cancellation, so a swipe that starts on ⌫ does not leave the repeater deleting.

Scope

• ios/Keyboard/KeyboardRootView.swift: .gesture becomes .simultaneousGesture on the track, and the panes get .disabled(swiping) while the drag is in flight.
• ios/Keyboard/KeyboardKeys.swift: RepeatingKey moves its press from @State plus onEnded to @GestureState plus onChange.
• docs/design/ios-voice-keyboard.md: the pane-track section records the routing.

Out of scope: the UIKit globe key on home-button devices, which arbitrates at the UIKit level and is unchanged.

Tradeoffs

highPriorityGesture on the track also makes every start point swipe, but it withholds touch-down from the keys until the drag fails. Keys would stop darkening under the finger and the record button's press haptic would fire at release. Rejected.

simultaneousGesture alone lets the key fire at release, because the key moves with the finger and the release lands inside it. That is what .disabled(swiping) prevents.

Blast Radius

Every pane's keys, because the track wraps all of them. Taps are unchanged. What changes is a touch that starts on a key and travels sideways past 24pt: it used to stay with the key, now it moves the track and cancels the key. The candidate bar lives in the strip above the track and is not affected.

Verification

The iOS Simulator on this Mac could not run the keyboard, so the before and after runs are on a macOS SwiftUI harness that rebuilds the track's gesture graph (HStack track, @GestureState offset, contentShape, a 24pt DragGesture, a Button child, a zero-distance drag child) and drives it with synthesized mouse events. The SwiftUI gesture arbitration is shared across platforms, but touch on iOS is not mouse on macOS, so treat this as strong evidence rather than a device pass.

Before, with the track's .gesture as on main, an 80pt swipe from a blank area or the text moved the track and switched the pane. From the Button the button pressed and released, the track received no live updates, and the pane switched only at release. From the zero-distance drag child the child pressed and released and the track received nothing.

=== gesture / button / 80pt
button.isPressed=true
button.isPressed=false
track.onEnded dx=-80
stepPane
=== gesture / drag0 / 80pt
drag0 press (action + repeater.start)
drag0 release (repeater.stop)

After, with simultaneousGesture plus .disabled while the drag is in flight, all four start points move the track live and switch the pane. The button presses on touch-down, is cancelled at 24pt, and does not fire. The repeating key presses on touch-down and its @GestureState resets at 24pt, so the repeater stops.

=== simuldis / button / 80pt
button.isPressed=true
track.updating dx=-24
button.isPressed=false
track.updating dx=-80
track.onEnded dx=-80
stepPane
=== simuldis / drag0 / 80pt
drag0 press (action + repeater.start)
track.updating dx=-24
drag0 release (repeater.stop)
track.updating dx=-80
track.onEnded dx=-80
stepPane

Taps (0pt) on the button and on the repeating key press and fire identically before and after.

xcodebuild -target ParleyKeyboard -sdk iphonesimulator26.2 builds with the fix. The simulator itself is blocked on this machine: xcode-select points at the Command Line Tools, the installed CoreSimulator framework is 1048 where Xcode 26.2 expects 1051.17.7, no iOS simulator runtime is installed (simctl runtime list is empty), and xcodebuild -runFirstLaunch waits on an admin authorization this session cannot give. swift test --package-path ios/ParleyKit cannot run either: Xcode's toolchain fails to load libxcrun (arm64 slice only, /usr/bin/xcrun is arm64e) and its XCTestCore.framework is missing, and the Command Line Tools toolchain fails to link Package.swift against its own PackageDescription. Please run the device pass on a phone before merging: swipe from the text, from a blank area, from ⌫, and from the record button on the voice pane, then tap each key and hold ⌫.

🤖 Generated with Claude Code

[github-actions]

✅ SonarQube Quality Gate passed — pathorsAI_parley

0 open issues on this PR.