scroll: Handle starting from overscroll in "scroll to end"

Author: gnprice

lib/widgets/scrolling.dart

@@ -393,6 +393,14 @@ class MessageListScrollPosition extends ScrollPositionWithSingleContext {
       return;
     }
 
+    if (pixels > maxScrollExtent) {
+      // The position is already scrolled past the end.  Let overscroll handle it.
+      // (This situation shouldn't even arise; the UI only offers this option
+      // when `pixels < maxScrollExtent`.)
+      goBallistic(0.0);
+      return;
+    }
+
     /// The top speed to move at, in logical pixels per second.
     ///
     /// This will be the speed whenever the distance to be traveled

test/flutter_checks.dart

@@ -142,6 +142,10 @@ extension TextEditingControllerChecks on Subject<TextEditingController> {
   Subject<String?> get text => has((t) => t.text, 'text');
 }
 
+extension ScrollActivityChecks on Subject<ScrollActivity> {
+  Subject<double> get velocity => has((x) => x.velocity, 'velocity');
+}
+
 extension IconChecks on Subject<Icon> {
   Subject<IconData?> get icon => has((i) => i.icon, 'icon');
   Subject<Color?> get color => has((i) => i.color, 'color');

test/widgets/scrolling_test.dart

@@ -1,4 +1,5 @@
 import 'package:checks/checks.dart';
+import 'package:flutter/foundation.dart';
 // ignore: undefined_hidden_name // anticipates https://github.com/flutter/flutter/pull/164818
 import 'package:flutter/rendering.dart' hide SliverPaintOrder;
 // ignore: undefined_hidden_name // anticipates https://github.com/flutter/flutter/pull/164818
@@ -376,6 +377,46 @@ void main() {
         // … without moving any farther.
         check(position.extentAfter).equals(0);
       });
+
+      testWidgets('starting from overscroll, just drift', (tester) async {
+        debugDefaultTargetPlatformOverride = TargetPlatform.iOS;
+        await prepare(tester, topHeight: 400, bottomHeight: 400);
+
+        // Drag into overscroll.
+        await tester.drag(findBottom, Offset(0, -100));
+        await tester.pump();
+        final offset1 = position.pixels - position.maxScrollExtent;
+        check(offset1).isGreaterThan(100 / 2);
+        check(position.activity).isA<BallisticScrollActivity>();
+
+        // Start drifting back into range.
+        await tester.pump(Duration(milliseconds: 10));
+        final offset2 = position.pixels - position.maxScrollExtent;
+        check(offset2)..isGreaterThan(0.0)..isLessThan(offset1);
+        check(position.activity).isA<BallisticScrollActivity>()
+          .velocity.isLessThan(0);
+
+        // Invoke `scrollToEnd`.  The motion should stop…
+        position.scrollToEnd();
+        await tester.pump();
+        check(position.pixels - position.maxScrollExtent).equals(offset2);
+        check(position.activity).isA<BallisticScrollActivity>()
+          .velocity.equals(0);
+
+        // … and resume drifting from there…
+        await tester.pump(Duration(milliseconds: 10));
+        final offset3 = position.pixels - position.maxScrollExtent;
+        check(offset3)..isGreaterThan(0.0)..isLessThan(offset2);
+        check(position.activity).isA<BallisticScrollActivity>()
+          .velocity.isLessThan(0);
+
+        // … to eventually return to being in range.
+        await tester.pump(Duration(seconds: 1));
+        check(position.pixels - position.maxScrollExtent).equals(0);
+        check(position.activity).isA<IdleScrollActivity>();
+
+        debugDefaultTargetPlatformOverride = null;
+      });
     });
   });
 }