fix(tvos): stabilize remote select handling

lib/services/apple_tv_remote_touch_service.dart

@@ -20,6 +20,8 @@ class AppleTvRemoteTouchService {
 
   final BasicMessageChannel<dynamic> _channel;
   final void Function(LogicalKeyboardKey logicalKey) _simulateKeyPress;
+  final void Function(LogicalKeyboardKey logicalKey) _simulateKeyDown;
+  final void Function(LogicalKeyboardKey logicalKey) _simulateKeyUp;
   final VoidCallback _scheduleFrame;
   final DateTime Function() _now;
   final GamepadDuplicateInputGuard _duplicateInputGuard;
@@ -39,10 +41,13 @@ class AppleTvRemoteTouchService {
   DateTime? _lastSwipeAt;
   DateTime? _lastDirectionalInputAt;
   DateTime? _lastSyntheticSelectAt;
+  bool _selectPressedFromClick = false;
 
   AppleTvRemoteTouchService({
     BasicMessageChannel<dynamic>? channel,
     void Function(LogicalKeyboardKey logicalKey)? simulateKeyPress,
+    void Function(LogicalKeyboardKey logicalKey)? simulateKeyDown,
+    void Function(LogicalKeyboardKey logicalKey)? simulateKeyUp,
     VoidCallback? scheduleFrame,
     DateTime Function()? now,
     GamepadDuplicateInputGuard? duplicateInputGuard,
@@ -54,6 +59,8 @@ class AppleTvRemoteTouchService {
   }) : assert(axisSwitchDominanceRatio >= 1),
        _channel = channel ?? const BasicMessageChannel<dynamic>(_channelName, JSONMessageCodec()),
        _simulateKeyPress = simulateKeyPress ?? key_sim.simulateKeyPress,
+       _simulateKeyDown = simulateKeyDown ?? key_sim.simulateKeyDown,
+       _simulateKeyUp = simulateKeyUp ?? key_sim.simulateKeyUp,
        _scheduleFrame = scheduleFrame ?? key_sim.scheduleFrameIfIdle,
        _now = now ?? DateTime.now,
        _duplicateInputGuard =
@@ -72,6 +79,7 @@ class AppleTvRemoteTouchService {
     _channel.setMessageHandler(null);
     _unregisterNativeKeyHandler();
     _duplicateInputGuard.clear();
+    _releaseSelectFromClick(source: 'stop');
     _resetTouch();
     _listening = false;
   }
@@ -117,8 +125,9 @@ class AppleTvRemoteTouchService {
       case 'cancelled':
         _resetTouch();
       case 'click_e':
-        _emitSelect();
+        _releaseSelectFromClick(source: 'click_e');
       case 'click_s':
+        _pressSelectFromClick();
       case 'loc':
         break;
       default:
@@ -212,12 +221,12 @@ class AppleTvRemoteTouchService {
     return axis == _SwipeAxis.horizontal ? horizontal : vertical;
   }
 
-  void _emitSelect() {
+  void _pressSelectFromClick() {
     final now = _now();
     final lastDirectionalInputAt = _lastDirectionalInputAt;
     if (lastDirectionalInputAt != null && now.difference(lastDirectionalInputAt) <= clickAfterDirectionSuppression) {
       final age = now.difference(lastDirectionalInputAt).inMilliseconds;
-      _log('suppress key=${_keyName(LogicalKeyboardKey.enter)} source=click_e reason=recent-direction age=${age}ms');
+      _log('suppress key=${_keyName(LogicalKeyboardKey.enter)} source=click_s reason=recent-direction age=${age}ms');
       return;
     }
 
@@ -225,14 +234,35 @@ class AppleTvRemoteTouchService {
     if (lastSyntheticSelectAt != null && now.difference(lastSyntheticSelectAt).abs() <= duplicateSuppressionWindow) {
       final age = now.difference(lastSyntheticSelectAt).abs().inMilliseconds;
       _log(
-        'suppress key=${_keyName(LogicalKeyboardKey.enter)} source=click_e reason=recent-synthetic-select age=${age}ms',
+        'suppress key=${_keyName(LogicalKeyboardKey.enter)} source=click_s reason=recent-synthetic-select age=${age}ms',
       );
       return;
     }
 
-    if (_emitKey(LogicalKeyboardKey.enter, source: 'click_e')) {
-      _lastSyntheticSelectAt = now;
+    if (_duplicateInputGuard.shouldSuppressSyntheticKey(LogicalKeyboardKey.enter)) {
+      _log('suppress key=${_keyName(LogicalKeyboardKey.enter)} source=click_s reason=recent-native');
+      return;
     }
+
+    _setTraditionalFocusHighlight();
+    _scheduleFrame();
+    _selectPressedFromClick = true;
+    _log('emit keydown=${_keyName(LogicalKeyboardKey.enter)} source=click_s');
+    _simulateKeyDown(LogicalKeyboardKey.enter);
+  }
+
+  void _releaseSelectFromClick({required String source}) {
+    if (!_selectPressedFromClick) {
+      _log('ignore keyup=${_keyName(LogicalKeyboardKey.enter)} source=$source reason=no-click-select-down');
+      return;
+    }
+
+    _setTraditionalFocusHighlight();
+    _scheduleFrame();
+    _selectPressedFromClick = false;
+    _lastSyntheticSelectAt = _now();
+    _log('emit keyup=${_keyName(LogicalKeyboardKey.enter)} source=$source');
+    _simulateKeyUp(LogicalKeyboardKey.enter);
   }
 
   bool _emitKey(LogicalKeyboardKey logicalKey, {required String source, String? detail}) {

lib/utils/key_event_simulator.dart

@@ -30,15 +30,7 @@ void simulateKeyPress(LogicalKeyboardKey logicalKey) {
       deviceType: ui.KeyEventDeviceType.directionalPad,
     );
 
-    FocusNode? node = focusNode;
-    KeyEventResult result = KeyEventResult.ignored;
-
-    while (node != null && result != KeyEventResult.handled) {
-      if (node.onKeyEvent != null) {
-        result = node.onKeyEvent!(node, keyDownEvent);
-      }
-      node = node.parent;
-    }
+    _dispatchKeyEvent(focusNode, keyDownEvent);
 
     final keyUpEvent = KeyUpEvent(
       physicalKey: physicalKey,
@@ -47,17 +39,58 @@ void simulateKeyPress(LogicalKeyboardKey logicalKey) {
       deviceType: ui.KeyEventDeviceType.directionalPad,
     );
 
-    node = focusNode;
-    while (node != null) {
-      if (node.onKeyEvent != null) {
-        final upResult = node.onKeyEvent!(node, keyUpEvent);
-        if (upResult == KeyEventResult.handled) break;
-      }
-      node = node.parent;
-    }
+    _dispatchKeyEvent(focusNode, keyUpEvent);
   });
 }
 
+/// Simulate only key down. Pair with [simulateKeyUp] for held buttons.
+void simulateKeyDown(LogicalKeyboardKey logicalKey) {
+  scheduleFrameIfIdle();
+  SchedulerBinding.instance.addPostFrameCallback((_) {
+    final focusNode = FocusManager.instance.primaryFocus;
+    if (focusNode == null) return;
+
+    _dispatchKeyEvent(
+      focusNode,
+      KeyDownEvent(
+        physicalKey: _getPhysicalKey(logicalKey),
+        logicalKey: logicalKey,
+        timeStamp: Duration(milliseconds: DateTime.now().millisecondsSinceEpoch),
+        deviceType: ui.KeyEventDeviceType.directionalPad,
+      ),
+    );
+  });
+}
+
+/// Simulate only key up. The release half of [simulateKeyDown].
+void simulateKeyUp(LogicalKeyboardKey logicalKey) {
+  scheduleFrameIfIdle();
+  SchedulerBinding.instance.addPostFrameCallback((_) {
+    final focusNode = FocusManager.instance.primaryFocus;
+    if (focusNode == null) return;
+
+    _dispatchKeyEvent(
+      focusNode,
+      KeyUpEvent(
+        physicalKey: _getPhysicalKey(logicalKey),
+        logicalKey: logicalKey,
+        timeStamp: Duration(milliseconds: DateTime.now().millisecondsSinceEpoch),
+        deviceType: ui.KeyEventDeviceType.directionalPad,
+      ),
+    );
+  });
+}
+
+void _dispatchKeyEvent(FocusNode focusNode, KeyEvent event) {
+  FocusNode? node = focusNode;
+  while (node != null) {
+    if (node.onKeyEvent != null && node.onKeyEvent!(node, event) == KeyEventResult.handled) {
+      break;
+    }
+    node = node.parent;
+  }
+}
+
 /// Force a frame when the engine is idle so focus visuals update immediately
 /// on external input (desktop may not wake up without mouse/keyboard activity).
 void scheduleFrameIfIdle() {