[SuperEditor][Android] Hide expanded drag handles after deleting the selected text (Resolves #1936)

super_editor/lib/src/default_editor/document_gestures_touch_android.dart

@@ -1332,6 +1332,7 @@ class SuperEditorAndroidControlsOverlayManagerState extends State<SuperEditorAnd
     _controlsController = SuperEditorAndroidControlsScope.rootOf(context);
     // TODO: Replace Cupertino aligner with a generic aligner because this code runs on Android.
     _toolbarAligner = CupertinoPopoverToolbarAligner();
+    widget.document.addListener(_onDocumentChange);
   }
 
   @override
@@ -1345,6 +1346,11 @@ class SuperEditorAndroidControlsOverlayManagerState extends State<SuperEditorAnd
         widget.scrollChangeSignal.addListener(_onDocumentScroll);
       }
     }
+
+    if (widget.document != oldWidget.document) {
+      oldWidget.document.removeListener(_onDocumentChange);
+      widget.document.addListener(_onDocumentChange);
+    }
   }
 
   @override
@@ -1353,6 +1359,7 @@ class SuperEditorAndroidControlsOverlayManagerState extends State<SuperEditorAnd
     // stop listening for document scroll changes.
     widget.dragHandleAutoScroller.value?.stopAutoScrollHandleMonitoring();
     widget.scrollChangeSignal.removeListener(_onDocumentScroll);
+    widget.document.removeListener(_onDocumentChange);
 
     super.dispose();
   }
@@ -1363,6 +1370,23 @@ class SuperEditorAndroidControlsOverlayManagerState extends State<SuperEditorAnd
   @visibleForTesting
   bool get wantsToDisplayMagnifier => _controlsController!.shouldShowMagnifier.value;
 
+  void _onDocumentChange(_) {
+    if (widget.selection.value?.isCollapsed == true &&
+        _controlsController!.shouldShowExpandedHandles.value == true &&
+        _dragHandleType == null) {
+      // The selection is collapsed, but the expanded handles are visible and the user isn't dragging a handle.
+      // This can happen when the selection is expanded, and the user deletes the selected text. The only situation
+      // where the expanded handles should be visible when the selection is collapsed is when the selection
+      // collapses while the user is dragging an expanded handle, which isn't the case here. Hide the handles.
+      _controlsController!
+        ..hideCollapsedHandle()
+        ..hideExpandedHandles()
+        ..hideMagnifier()
+        ..hideToolbar()
+        ..blinkCaret();
+    }
+  }
+
   void _toggleToolbarOnCollapsedHandleTap() {
     _controlsController!.toggleToolbar();
   }

super_editor/test/super_editor/mobile/super_editor_android_overlay_controls_test.dart

@@ -1,8 +1,10 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
+import 'package:flutter_test_robots/flutter_test_robots.dart';
 import 'package:flutter_test_runners/flutter_test_runners.dart';
 import 'package:super_editor/super_editor.dart';
 import 'package:super_editor/super_editor_test.dart';
+import 'package:super_text_layout/super_text_layout.dart';
 
 import '../../test_runners.dart';
 import '../../test_tools.dart';
@@ -212,6 +214,50 @@ void main() {
       expect(SuperEditorInspector.isCaretVisible(), isTrue);
     });
 
+    testWidgetsOnAndroid("hides expanded handles and toolbar when deleting an expanded selection", (tester) async {
+      // Configure BlinkController to animate, otherwise it won't blink. We want to make sure
+      // the caret blinks after deleting the content.
+      BlinkController.indeterminateAnimationsEnabled = true;
+      addTearDown(() => BlinkController.indeterminateAnimationsEnabled = false);
+
+      await _pumpSingleParagraphApp(tester);
+
+      // Double tap to select "Lorem".
+      await tester.doubleTapInParagraph("1", 1);
+      await tester.pump();
+
+      // Ensure the toolbar and the drag handles are visible.
+      expect(SuperEditorInspector.isMobileToolbarVisible(), isTrue);
+      expect(SuperEditorInspector.findMobileExpandedDragHandles(), findsNWidgets(2));
+
+      // Press backspace to delete the word "Lorem" while the expanded handles are visible.
+      await tester.ime.backspace(getter: imeClientGetter);
+
+      // Ensure the toolbar and the drag handles were hidden.
+      expect(SuperEditorInspector.isMobileToolbarVisible(), isFalse);
+      expect(SuperEditorInspector.findMobileExpandedDragHandles(), findsNothing);
+
+      // Ensure caret is blinking.
+
+      expect(SuperEditorInspector.isCaretVisible(), true);
+
+      // Duration to switch between visible and invisible.
+      final flashPeriod = SuperEditorInspector.caretFlashPeriod();
+
+      // Trigger a frame with an ellapsed time equal to the flashPeriod,
+      // so the caret should change from visible to invisible.
+      await tester.pump(flashPeriod);
+
+      // Ensure caret is invisible after the flash period.
+      expect(SuperEditorInspector.isCaretVisible(), false);
+
+      // Trigger another frame to make caret visible again.
+      await tester.pump(flashPeriod);
+
+      // Ensure caret is visible.
+      expect(SuperEditorInspector.isCaretVisible(), true);
+    });
+
     group('shows magnifier above the caret when dragging the collapsed handle', () {
       testWidgetsOnAndroid('with an ancestor scrollable', (tester) async {
         final scrollController = ScrollController();

super_editor/test/super_editor/mobile/super_editor_ios_overlay_controls_test.dart

@@ -1,6 +1,8 @@
 import 'package:flutter_test/flutter_test.dart';
+import 'package:flutter_test_robots/flutter_test_robots.dart';
 import 'package:flutter_test_runners/flutter_test_runners.dart';
 import 'package:super_editor/super_editor_test.dart';
+import 'package:super_text_layout/super_text_layout.dart';
 
 import '../../test_runners.dart';
 import '../supereditor_test_tools.dart';
@@ -109,6 +111,50 @@ void main() {
       await tester.pump(const Duration(milliseconds: 100));
     });
 
+    testWidgetsOnIos("hides expanded handles and toolbar when deleting an expanded selection", (tester) async {
+      // Configure BlinkController to animate, otherwise it won't blink. We want to make sure
+      // the caret blinks after deleting the content.
+      BlinkController.indeterminateAnimationsEnabled = true;
+      addTearDown(() => BlinkController.indeterminateAnimationsEnabled = false);
+
+      await _pumpSingleParagraphApp(tester);
+
+      // Double tap to select "Lorem".
+      await tester.doubleTapInParagraph("1", 1);
+      await tester.pump();
+
+      // Ensure the toolbar and the drag handles are visible.
+      expect(SuperEditorInspector.isMobileToolbarVisible(), isTrue);
+      expect(SuperEditorInspector.findMobileExpandedDragHandles(), findsNWidgets(2));
+
+      // Press backspace to delete the word "Lorem" while the expanded handles are visible.
+      await tester.ime.backspace(getter: imeClientGetter);
+
+      // Ensure the toolbar and the drag handles were hidden.
+      expect(SuperEditorInspector.isMobileToolbarVisible(), isFalse);
+      expect(SuperEditorInspector.findMobileExpandedDragHandles(), findsNothing);
+
+      // Ensure caret is blinking.
+
+      expect(SuperEditorInspector.isCaretVisible(), true);
+
+      // Duration to switch between visible and invisible.
+      final flashPeriod = SuperEditorInspector.caretFlashPeriod();
+
+      // Trigger a frame with an ellapsed time equal to the flashPeriod,
+      // so the caret should change from visible to invisible.
+      await tester.pump(flashPeriod);
+
+      // Ensure caret is invisible after the flash period.
+      expect(SuperEditorInspector.isCaretVisible(), false);
+
+      // Trigger another frame to make caret visible again.
+      await tester.pump(flashPeriod);
+
+      // Ensure caret is visible.
+      expect(SuperEditorInspector.isCaretVisible(), true);
+    });
+
     group("on device and web > shows ", () {
       testWidgetsOnIosDeviceAndWeb("caret", (tester) async {
         await _pumpSingleParagraphApp(tester);