import 'dart:ui' as ui; import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; import 'package:flutter_test/flutter_test.dart'; import 'package:plezy/focus/focusable_text_field.dart'; import 'package:plezy/utils/platform_detector.dart'; void main() { tearDown(() { TvDetectionService.debugSetAppleTVOverride(null); TvDetectionService.setForceTVSync(false); }); testWidgets('tab traversal focuses the text form field', (tester) async { final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'server_url_field'); final buttonFocusNode = FocusNode(debugLabel: 'find_server_button'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); addTearDown(buttonFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: Column( children: [ FocusableTextFormField( controller: controller, focusNode: fieldFocusNode, decoration: const InputDecoration(labelText: 'Server URL'), ), FilledButton(focusNode: buttonFocusNode, onPressed: () {}, child: const Text('Find server')), ], ), ), ), ); await tester.sendKeyEvent(LogicalKeyboardKey.tab); await tester.pump(); expect(fieldFocusNode.hasPrimaryFocus, isTrue); expect(buttonFocusNode.hasFocus, isFalse); }); testWidgets('focused text form field still receives select handling', (tester) async { final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'server_url_field'); var selects = 0; addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: FocusableTextFormField(controller: controller, focusNode: fieldFocusNode, onSelect: () => selects++), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); await tester.sendKeyEvent(LogicalKeyboardKey.select); await tester.pump(); expect(selects, 1); }); testWidgets('d-pad direction handlers are installed on the text field focus node', (tester) async { final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'name_field'); final nextFocusNode = FocusNode(debugLabel: 'next_button'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); addTearDown(nextFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: Column( children: [ FocusableTextField( controller: controller, focusNode: fieldFocusNode, onNavigateDown: nextFocusNode.requestFocus, ), FilledButton(focusNode: nextFocusNode, onPressed: () {}, child: const Text('Next')), ], ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); final handler = fieldFocusNode.onKeyEvent; expect(handler, isNotNull); final result = handler!( fieldFocusNode, const KeyDownEvent( physicalKey: PhysicalKeyboardKey.arrowDown, logicalKey: LogicalKeyboardKey.arrowDown, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.directionalPad, ), ); await tester.pump(); expect(result, KeyEventResult.handled); expect(nextFocusNode.hasPrimaryFocus, isTrue); }); testWidgets('existing focus node key handler is preserved before text field navigation', (tester) async { final controller = TextEditingController(); final handledKeys = []; final fieldFocusNode = FocusNode( debugLabel: 'custom_field', onKeyEvent: (_, event) { if (event is KeyDownEvent && event.logicalKey == LogicalKeyboardKey.arrowUp) { handledKeys.add(event.logicalKey); return KeyEventResult.handled; } return KeyEventResult.ignored; }, ); final nextFocusNode = FocusNode(debugLabel: 'next_button'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); addTearDown(nextFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: Column( children: [ FocusableTextField( controller: controller, focusNode: fieldFocusNode, onNavigateDown: nextFocusNode.requestFocus, ), FilledButton(focusNode: nextFocusNode, onPressed: () {}, child: const Text('Next')), ], ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); final handler = fieldFocusNode.onKeyEvent!; final customResult = handler( fieldFocusNode, const KeyDownEvent( physicalKey: PhysicalKeyboardKey.arrowUp, logicalKey: LogicalKeyboardKey.arrowUp, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.directionalPad, ), ); final navigationResult = handler( fieldFocusNode, const KeyDownEvent( physicalKey: PhysicalKeyboardKey.arrowDown, logicalKey: LogicalKeyboardKey.arrowDown, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.directionalPad, ), ); await tester.pump(); expect(customResult, KeyEventResult.handled); expect(handledKeys, [LogicalKeyboardKey.arrowUp]); expect(navigationResult, KeyEventResult.handled); expect(nextFocusNode.hasPrimaryFocus, isTrue); }); testWidgets('tvOS keyboard enter does not open virtual keyboard', (tester) async { TvDetectionService.debugSetAppleTVOverride(true); final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'search_field'); String? submitted; addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: FocusableTextField( controller: controller, focusNode: fieldFocusNode, onSubmitted: (value) => submitted = value, ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); await tester.sendKeyEvent(LogicalKeyboardKey.enter); await tester.pumpAndSettle(); expect(find.byType(Dialog), findsNothing); expect(submitted, isEmpty); }); testWidgets('tvOS remote select opens virtual keyboard', (tester) async { TvDetectionService.debugSetAppleTVOverride(true); await _setTvSurfaceSize(tester); final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'search_field'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: FocusableTextField(controller: controller, focusNode: fieldFocusNode), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); _dispatchKey( const KeyDownEvent( physicalKey: PhysicalKeyboardKey.select, logicalKey: LogicalKeyboardKey.select, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.directionalPad, ), ); await tester.pumpAndSettle(); expect(find.byType(Dialog), findsOneWidget); }); testWidgets('Android TV native keyboard done uses D-pad navigation', (tester) async { TvDetectionService.debugSetAppleTVOverride(null); await TvDetectionService.getInstance(forceTv: true); TvDetectionService.setForceTVSync(true); final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'name_field'); final nextFocusNode = FocusNode(debugLabel: 'next_button'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); addTearDown(nextFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: Column( children: [ FocusableTextField( controller: controller, focusNode: fieldFocusNode, textInputAction: TextInputAction.done, onNavigateDown: nextFocusNode.requestFocus, ), FilledButton(focusNode: nextFocusNode, onPressed: () {}, child: const Text('Next')), ], ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); await tester.showKeyboard(find.byType(TextField)); await tester.testTextInput.receiveAction(TextInputAction.done); await tester.pump(); expect(nextFocusNode.hasPrimaryFocus, isTrue); expect(find.byType(Dialog), findsNothing); }); testWidgets('Android TV remote keys are passed to native text input', (tester) async { TvDetectionService.debugSetAppleTVOverride(null); await TvDetectionService.getInstance(forceTv: true); TvDetectionService.setForceTVSync(true); final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'server_url_field'); final nextFocusNode = FocusNode(debugLabel: 'find_server_button'); var selects = 0; var backs = 0; addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); addTearDown(nextFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: Column( children: [ FocusableTextFormField( controller: controller, focusNode: fieldFocusNode, onNavigateDown: nextFocusNode.requestFocus, onSelect: () => selects++, onBack: () => backs++, ), FilledButton(focusNode: nextFocusNode, onPressed: () {}, child: const Text('Find server')), ], ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); final handler = fieldFocusNode.onKeyEvent!; final downResult = handler(fieldFocusNode, _remoteKey(LogicalKeyboardKey.arrowDown)); final selectResult = handler(fieldFocusNode, _remoteKey(LogicalKeyboardKey.select)); final backResult = handler(fieldFocusNode, _remoteKey(LogicalKeyboardKey.goBack)); final synthesizedSelectResult = handler( fieldFocusNode, const KeyDownEvent( physicalKey: PhysicalKeyboardKey.select, logicalKey: LogicalKeyboardKey.select, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.keyboard, ), ); await tester.pump(); expect(downResult, KeyEventResult.skipRemainingHandlers); expect(selectResult, KeyEventResult.skipRemainingHandlers); expect(backResult, KeyEventResult.skipRemainingHandlers); expect(synthesizedSelectResult, KeyEventResult.skipRemainingHandlers); expect(fieldFocusNode.hasPrimaryFocus, isTrue); expect(nextFocusNode.hasFocus, isFalse); expect(selects, 0); expect(backs, 0); expect(find.byType(Dialog), findsNothing); }); testWidgets('Android TV physical keyboard still uses field navigation', (tester) async { TvDetectionService.debugSetAppleTVOverride(null); await TvDetectionService.getInstance(forceTv: true); TvDetectionService.setForceTVSync(true); final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'name_field'); final nextFocusNode = FocusNode(debugLabel: 'next_button'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); addTearDown(nextFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: Column( children: [ FocusableTextField( controller: controller, focusNode: fieldFocusNode, onNavigateDown: nextFocusNode.requestFocus, ), FilledButton(focusNode: nextFocusNode, onPressed: () {}, child: const Text('Next')), ], ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); final result = fieldFocusNode.onKeyEvent!( fieldFocusNode, const KeyDownEvent( physicalKey: PhysicalKeyboardKey.arrowDown, logicalKey: LogicalKeyboardKey.arrowDown, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.keyboard, ), ); await tester.pump(); expect(result, KeyEventResult.handled); expect(nextFocusNode.hasPrimaryFocus, isTrue); }); testWidgets('tvOS engine-synthesized select opens the virtual keyboard', (tester) async { // The custom Flutter tvOS engine emits Siri Remote center-dpad presses // as `LogicalKeyboardKey.select` with `deviceType=keyboard` (via the // legacy `flutter/keyevent` Android DPAD_CENTER path). On Apple TV this // must open the on-screen keyboard, not submit the form. Previously // `isPhysicalKeyboardEnter` matched select+keyboard and routed through // `_submitTextInput`, which silently triggered form submit on every // dpad center press (e.g. immediate validation error on empty fields). TvDetectionService.debugSetAppleTVOverride(true); await _setTvSurfaceSize(tester); final controller = TextEditingController(text: 'query'); final fieldFocusNode = FocusNode(debugLabel: 'search_field'); String? submitted; addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: FocusableTextField( controller: controller, focusNode: fieldFocusNode, onSubmitted: (value) => submitted = value, ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); await tester.sendKeyEvent(LogicalKeyboardKey.select); await tester.pumpAndSettle(); expect(submitted, isNull); expect(find.byType(Dialog), findsOneWidget); }); testWidgets('tvOS text field handles physical keyboard text editing without opening virtual keyboard', ( tester, ) async { TvDetectionService.debugSetAppleTVOverride(true); final controller = TextEditingController(); final fieldFocusNode = FocusNode(debugLabel: 'search_field'); final changes = []; addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: FocusableTextField( controller: controller, focusNode: fieldFocusNode, maxLength: 2, inputFormatters: [FilteringTextInputFormatter.allow(RegExp('[ab]'))], onChanged: changes.add, ), ), ), ); expect(tester.widget(find.byType(TextField)).readOnly, isTrue); fieldFocusNode.requestFocus(); await tester.pump(); await tester.sendKeyEvent(LogicalKeyboardKey.keyA, character: 'a'); await tester.sendKeyEvent(LogicalKeyboardKey.keyC, character: 'c'); await tester.sendKeyEvent(LogicalKeyboardKey.keyB, character: 'b'); await tester.pumpAndSettle(); expect(controller.text, 'ab'); expect(changes, ['a', 'ab']); await tester.sendKeyEvent(LogicalKeyboardKey.backspace); await tester.pump(); expect(controller.text, 'a'); controller.selection = const TextSelection.collapsed(offset: 0); await tester.sendKeyEvent(LogicalKeyboardKey.delete); await tester.pump(); expect(controller.text, isEmpty); expect(find.byType(Dialog), findsNothing); }); testWidgets('tvOS keyboard enter inserts newline for multiline text field', (tester) async { TvDetectionService.debugSetAppleTVOverride(true); final controller = TextEditingController(text: 'a'); final fieldFocusNode = FocusNode(debugLabel: 'notes_field'); addTearDown(controller.dispose); addTearDown(fieldFocusNode.dispose); await tester.pumpWidget( MaterialApp( home: Scaffold( body: FocusableTextField( controller: controller, focusNode: fieldFocusNode, keyboardType: TextInputType.multiline, maxLines: 2, ), ), ), ); fieldFocusNode.requestFocus(); await tester.pump(); await tester.sendKeyEvent(LogicalKeyboardKey.enter); await tester.pumpAndSettle(); expect(controller.text, 'a\n'); expect(find.byType(Dialog), findsNothing); }); } Future _setTvSurfaceSize(WidgetTester tester) async { await tester.binding.setSurfaceSize(const Size(1280, 720)); addTearDown(() => tester.binding.setSurfaceSize(null)); } KeyEventResult _dispatchKey(KeyEvent event) { FocusNode? node = FocusManager.instance.primaryFocus; while (node != null) { final result = node.onKeyEvent?.call(node, event) ?? KeyEventResult.ignored; if (result != KeyEventResult.ignored) return result; node = node.parent; } return KeyEventResult.ignored; } KeyDownEvent _remoteKey(LogicalKeyboardKey key) { return KeyDownEvent( physicalKey: _physicalKeyFor(key), logicalKey: key, timeStamp: Duration.zero, deviceType: ui.KeyEventDeviceType.directionalPad, ); } PhysicalKeyboardKey _physicalKeyFor(LogicalKeyboardKey key) { if (key == LogicalKeyboardKey.arrowDown) return PhysicalKeyboardKey.arrowDown; if (key == LogicalKeyboardKey.goBack) return PhysicalKeyboardKey.escape; if (key == LogicalKeyboardKey.select) return PhysicalKeyboardKey.select; throw ArgumentError.value(key, 'key', 'Unsupported remote key'); }