fix: 🐛 Fixed incorrect ShowcaseView callback scope by adding optional scope parameter

Author: vasu-nageshri

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 - Fixed [#590](https://github.com/SimformSolutionsPvtLtd/showcaseview/issues/590) - Fixed Rendering issues with scrollable showcase views inside withWidget
 - Fixed [#587](https://github.com/SimformSolutionsPvtLtd/showcaseview/issues/587) - Fixed ShowcaseView.withWidget container positioning issues on web
+- Fixed [#588](https://github.com/SimformSolutionsPvtLtd/showcaseview/issues/588) & [#593](https://github.com/SimformSolutionsPvtLtd/showcaseview/issues/593) - Fixed incorrect ShowcaseView callback scope by adding optional scope parameter
 
 ## [5.0.1]
 

doc/documentation.md

@@ -606,6 +606,27 @@ performed using that scope name, i.e.
 > If multiple scopes are registered with same name then the last registering scope would be 
 > consider valid and the rest would be overrode by the last one.
 
+## Explicit Scope Assignment with `scope`
+
+By default, `Showcase` widgets use the currently active scope. However, you can explicitly 
+assign a `Showcase` widget to a specific scope using the `scope` parameter. This is 
+particularly useful when you need to ensure a widget belongs to a specific scope regardless 
+of which scope is currently active.
+
+```dart
+Showcase(
+  key: _profileKey,
+  scope: 'profile',
+  title: 'Profile',
+  description: 'Your profile information',
+  child: Icon(Icons.person),
+),
+```
+
+This approach is helpful in scenarios with multiple active scopes in the same widget tree, 
+ensuring each `Showcase` widget targets the correct scope without relying on global state 
+changes.
+
 # Migration Guides
 
 This document provides guidance for migrating between different versions of the ShowCaseView package.

example/lib/detailscreen.dart

@@ -67,6 +67,7 @@ class _DetailState extends State<Detail> {
               key: _one,
               title: 'Title',
               description: 'Desc',
+              scope: '_detailsScreen',
               floatingActionWidget: FloatingActionWidget(
                 left: 16,
                 bottom: 16,

lib/src/showcase/showcase.dart

@@ -112,6 +112,7 @@ class Showcase extends StatefulWidget {
     this.enableAutoScroll,
     this.floatingActionWidget,
     this.targetTooltipGap = 10,
+    this.scope,
   })  : container = null,
         showcaseKey = key,
         assert(
@@ -201,6 +202,7 @@ class Showcase extends StatefulWidget {
     this.enableAutoScroll,
     this.toolTipMargin = 14,
     this.targetTooltipGap = 10,
+    this.scope,
   })  : showArrow = false,
         onToolTipClick = null,
         scaleAnimationDuration = const Duration(milliseconds: 300),
@@ -258,6 +260,11 @@ class Showcase extends StatefulWidget {
   /// target widget while showcasing.
   final GlobalKey showcaseKey;
 
+  /// Optional scope name for this showcase widget.
+  /// If provided, this widget will be registered under the specified scope
+  /// instead of the current active scope.
+  final String? scope;
+
   /// Target widget that will be showcased or highlighted
   final Widget child;
 
@@ -527,6 +534,10 @@ class Showcase extends StatefulWidget {
 }
 
 class _ShowcaseState extends State<Showcase> {
+  /// Returns the scope name for this Showcase instance.
+  late final String _scopeName =
+      widget.scope ?? ShowcaseService.instance.getScope().name;
+
   ShowcaseController get _controller => ShowcaseService.instance.getController(
         key: widget.showcaseKey,
         id: _uniqueId,
@@ -540,7 +551,8 @@ class _ShowcaseState extends State<Showcase> {
   @override
   void initState() {
     super.initState();
-    _showCaseWidgetManager = ShowcaseService.instance.getScope();
+    _showCaseWidgetManager =
+        ShowcaseService.instance.getScope(scope: _scopeName);
     ShowcaseController.register(
       id: _uniqueId,
       key: widget.showcaseKey,
@@ -603,17 +615,15 @@ class _ShowcaseState extends State<Showcase> {
   }
 
   void _updateControllerValues() {
-    final manager = ShowcaseService.instance.getScope(
-      scope: _showCaseWidgetManager.name,
-    );
+    final manager = ShowcaseService.instance.getScope(scope: _scopeName);
     if (manager == _showCaseWidgetManager) return;
     _showCaseWidgetManager = manager;
     ShowcaseService.instance.addController(
       controller: _controller
         ..showcaseView = _showCaseWidgetManager.showcaseView,
       key: widget.showcaseKey,
       id: _uniqueId,
-      scope: _showCaseWidgetManager.name,
+      scope: _scopeName,
     );
   }
 }