🔧 Update Pack 2 #5

Author: SaadArdati

lib/src/pointer_transition.dart

@@ -1,8 +1,8 @@
 import 'package:flutter/widgets.dart';
-import 'post_frame_widget.dart';
 
 import 'apple_curves.dart';
 import 'effect_query.dart';
+import 'post_frame_widget.dart';
 
 /// Represents the pointer event for [PointerTransition].
 class PointerTransitionEvent {
@@ -52,6 +52,7 @@ extension PointerTransitionExt on Widget {
     PointerTransitionBuilder builder, {
     Alignment origin = Alignment.center,
     bool useGlobalPointer = false,
+    bool usePointerRouter = true,
     bool transitionBetweenBounds = true,
     bool resetOnExitBounds = true,
     Curve curve = appleEaseInOut,
@@ -61,6 +62,7 @@ extension PointerTransitionExt on Widget {
       builder: builder,
       origin: origin,
       useGlobalPointer: useGlobalPointer,
+      usePointerRouter: usePointerRouter,
       transitionBetweenBounds: transitionBetweenBounds,
       resetOnExitBounds: resetOnExitBounds,
       curve: curve,
@@ -87,7 +89,7 @@ class PointerTransition extends StatefulWidget {
 
   /// Decides whether this transition calculates the value based on the global
   /// position of the pointer device or the local position of the pointer
-  /// device.
+  /// device relative to the widget's box.
   final bool useGlobalPointer;
 
   /// Decides whether this transition should transition between when the pointer
@@ -99,6 +101,17 @@ class PointerTransition extends StatefulWidget {
   /// the widget.
   final bool resetOnExitBounds;
 
+  /// Whether this transition should rely on
+  /// [WidgetsBinding.instance.pointerRouter.addGlobalRoute] to read
+  /// the pointer device's position, which is useful for reading cursor
+  /// events that may not be read properly via [MouseRegion]s like if the
+  /// cursor is outside the bounds of the physical window or applies some
+  /// unusual gesture that may not be normally detected.
+  ///
+  /// If set to false, a traditional [MouseRegion] is used to read
+  /// the pointer device's position.
+  final bool usePointerRouter;
+
   /// The child widget to apply the effects to.
   final Widget child;
 
@@ -119,6 +132,7 @@ class PointerTransition extends StatefulWidget {
     this.useGlobalPointer = false,
     this.transitionBetweenBounds = true,
     this.resetOnExitBounds = true,
+    this.usePointerRouter = true,
     this.builder,
     this.curve = appleEaseInOut,
     this.duration = const Duration(milliseconds: 125),
@@ -174,7 +188,10 @@ class _PointerTransitionState extends State<PointerTransition>
   @override
   void initState() {
     super.initState();
-    WidgetsBinding.instance.pointerRouter.addGlobalRoute(updateState);
+    if (widget.usePointerRouter) {
+      WidgetsBinding.instance.pointerRouter.addGlobalRoute(updateState);
+    }
+
     _controller.addListener(animationListener);
   }
 
@@ -193,6 +210,14 @@ class _PointerTransitionState extends State<PointerTransition>
         curve: widget.curve,
       );
     }
+
+    if (oldWidget.usePointerRouter != widget.usePointerRouter) {
+      if (widget.usePointerRouter) {
+        WidgetsBinding.instance.pointerRouter.addGlobalRoute(updateState);
+      } else {
+        WidgetsBinding.instance.pointerRouter.removeGlobalRoute(updateState);
+      }
+    }
   }
 
   void animationListener() {
@@ -210,7 +235,10 @@ class _PointerTransitionState extends State<PointerTransition>
     _animation.dispose();
     _controller.removeListener(animationListener);
     _controller.dispose();
-    WidgetsBinding.instance.pointerRouter.removeGlobalRoute(updateState);
+
+    if (widget.usePointerRouter) {
+      WidgetsBinding.instance.pointerRouter.removeGlobalRoute(updateState);
+    }
     super.dispose();
   }
 
@@ -345,7 +373,7 @@ class _PointerTransitionState extends State<PointerTransition>
 
   @override
   Widget build(BuildContext context) {
-    final Widget child = widget.builder?.call(
+    Widget child = widget.builder?.call(
           context,
           widget.child,
           PointerTransitionEvent(
@@ -357,6 +385,14 @@ class _PointerTransitionState extends State<PointerTransition>
         ) ??
         widget.child;
 
+    if (!widget.usePointerRouter) {
+      child = MouseRegion(
+        onHover: (event) => updateState(event),
+        onExit: (event) => resetValue(),
+        child: child,
+      );
+    }
+
     return PostFrame(
       child: AnimatedBuilder(
         animation: _animation,