fix: 🐛 Accommodate over scroll

Author: aditya-chavda

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 - Fixed [#576](https://github.com/SimformSolutionsPvtLtd/showcaseview/issues/576) - Fixed the showcase key update issue by removing the old controller entry and registering the new key.
 - Fixed [#578](https://github.com/SimformSolutionsPvtLtd/showcaseview/issues/578) - Fixed showcase key issue.
+- Fixed [#583](https://github.com/SimformSolutionsPvtLtd/showcaseview/pull/583) - Accommodate 
+  over scroll when auto scroll is enabled.
 
 ## [5.0.0]
 

lib/src/showcase/showcase.dart

@@ -563,7 +563,7 @@ class _ShowcaseState extends State<Showcase> {
     super.didUpdateWidget(oldWidget);
     if (oldWidget == widget) return;
     _updateControllerValues();
-    if(oldWidget.showcaseKey != widget.showcaseKey) {
+    if (oldWidget.showcaseKey != widget.showcaseKey) {
       ShowcaseService.instance.removeController(
         key: oldWidget.showcaseKey,
         id: _uniqueId,

lib/src/showcase/showcase_controller.dart

@@ -181,6 +181,8 @@ class ShowcaseController {
       duration: showcaseView.scrollDuration,
       alignment: config.scrollAlignment,
     );
+    // For the cases when scrollAlignment causes overscroll.
+    await _waitForScrollToSettle();
 
     isScrollRunning = false;
     setupShowcase(shouldUpdateOverlay: shouldUpdateOverlay);
@@ -456,6 +458,28 @@ class ShowcaseController {
     scheduler.addPostFrameCallback((_) => process());
   }
 
+  /// Waits until the scroll position stops changing (settles).
+  Future<void> _waitForScrollToSettle({
+    Duration checkInterval = const Duration(milliseconds: 60),
+    int maxChecks = 120,
+  }) async {
+    final scrollableState = Scrollable.maybeOf(_context);
+    if (scrollableState == null) return;
+
+    final position = scrollableState.position;
+    var lastPixels = position.pixels;
+    var checks = 0;
+
+    while (checks < maxChecks) {
+      await Future<void>.delayed(checkInterval);
+      if (!position.hasPixels) break;
+      final currentPixels = position.pixels;
+      if ((currentPixels - lastPixels).abs() < 0.5) break;
+      lastPixels = currentPixels;
+      checks++;
+    }
+  }
+
   @override
   int get hashCode => Object.hash(id, key);
 

lib/src/tooltip/tooltip_content.dart

@@ -94,15 +94,22 @@ class ToolTipContent extends StatelessWidget {
       );
     }
 
+    // For horizontal action positioning, use Row layout
+    final gap = SizedBox(
+      width: tooltipActionConfig.gapBetweenContentAndAction,
+    );
+
     // For vertical action positioning (default), use Column layout
     final contentColumn = Column(
       mainAxisSize: MainAxisSize.min,
       children: <Widget>[
         if (titleWidget != null) titleWidget,
         if (descriptionWidget != null) descriptionWidget,
         if (actionWidget != null &&
-            tooltipActionConfig.position.isInsideVertical)
+            tooltipActionConfig.position.isInsideVertical) ...[
+          gap,
           actionWidget,
+        ],
       ],
     );
 
@@ -112,10 +119,6 @@ class ToolTipContent extends StatelessWidget {
       return contentColumn;
     }
 
-    // For horizontal action positioning, use Row layout
-    final gap = SizedBox(
-      width: tooltipActionConfig.gapBetweenContentAndAction,
-    );
     return Row(
       mainAxisSize: MainAxisSize.min,
       children: [