🔧 Update Pack 2 #24

- Add AnimationBehavior option for AnimatedEffect.
- Add `HyperEffectsAnimationConfig` inherited widget.

Author: BirjuVachhani

lib/hyper_effects.dart

@@ -1,14 +1,15 @@
 library;
 
 export 'src/animated_effect.dart';
+export 'src/animated_group_effect.dart';
+export 'src/animation_config.dart';
+export 'src/animation_retainer.dart';
+export 'src/apple_curves.dart';
+export 'src/effect_query.dart';
 export 'src/effect_widget.dart';
 export 'src/effects/effects.dart';
 export 'src/extensions.dart';
-export 'src/scroll_phase.dart';
-export 'src/scroll_transition.dart';
-export 'src/effect_query.dart';
 export 'src/pointer_transition.dart';
-export 'src/apple_curves.dart';
 export 'src/post_frame_widget.dart';
-export 'src/animation_retainer.dart';
-export 'src/animated_group_effect.dart';
+export 'src/scroll_phase.dart';
+export 'src/scroll_transition.dart';

lib/src/animated_effect.dart

@@ -76,6 +76,7 @@ extension AnimatedEffectExt on Widget? {
     VoidCallback? onEnd,
     BooleanCallback? playIf,
     BooleanCallback? skipIf,
+    AnimationBehavior? animationBehavior,
   }) {
     return AnimatedEffect(
       triggerType: AnimationTriggerType.trigger,
@@ -91,6 +92,7 @@ extension AnimatedEffectExt on Widget? {
       onEnd: onEnd,
       playIf: playIf,
       skipIf: skipIf,
+      animationBehavior: animationBehavior,
       child: this,
     );
   }
@@ -150,6 +152,7 @@ extension AnimatedEffectExt on Widget? {
     VoidCallback? onEnd,
     BooleanCallback? playIf,
     BooleanCallback? skipIf,
+    AnimationBehavior? animationBehavior,
   }) {
     return AnimatedEffect(
       triggerType: AnimationTriggerType.afterLast,
@@ -164,6 +167,7 @@ extension AnimatedEffectExt on Widget? {
       onEnd: onEnd,
       playIf: playIf,
       skipIf: skipIf,
+      animationBehavior: animationBehavior,
       child: this,
     );
   }
@@ -219,6 +223,7 @@ extension AnimatedEffectExt on Widget? {
     VoidCallback? onEnd,
     BooleanCallback? playIf,
     BooleanCallback? skipIf,
+    AnimationBehavior? animationBehavior,
   }) {
     return AnimatedEffect(
       key: key,
@@ -233,6 +238,7 @@ extension AnimatedEffectExt on Widget? {
       delay: delay,
       playIf: playIf,
       skipIf: skipIf,
+      animationBehavior: animationBehavior,
       child: this,
     );
   }
@@ -321,6 +327,10 @@ class AnimatedEffect extends StatefulWidget {
   /// the ending values.
   final BooleanCallback? skipIf;
 
+  /// The behavior of the controller when
+  /// [AccessibilityFeatures.disableAnimations] is true.
+  final AnimationBehavior? animationBehavior;
+
   /// Creates [AnimatedEffect] widget.
   const AnimatedEffect({
     super.key,
@@ -338,6 +348,7 @@ class AnimatedEffect extends StatefulWidget {
     this.delay = Duration.zero,
     this.playIf,
     this.skipIf,
+    this.animationBehavior,
   });
 
   @override
@@ -371,6 +382,9 @@ class AnimatedEffectState extends State<AnimatedEffect>
             ? 1
             : 0,
     duration: widget.duration,
+    animationBehavior: widget.animationBehavior ??
+        HyperEffectsAnimationConfig.maybeOf(context)?.animationBehavior ??
+        AnimationBehavior.normal,
   );
 
   /// The number of times the animation should be repeated.

lib/src/animation_config.dart

@@ -0,0 +1,32 @@
+import 'package:flutter/cupertino.dart';
+
+/// Provides a way to configure the animation behavior globally for a subtree.
+class HyperEffectsAnimationConfig extends InheritedWidget {
+  /// The animation behavior to use for the subtree.
+  final AnimationBehavior? animationBehavior;
+
+  /// Returns the [HyperEffectsAnimationConfig] from the closest instance of
+  /// this class that encloses the given context.
+  static HyperEffectsAnimationConfig of(BuildContext context) {
+    return maybeOf(context)!;
+  }
+
+  /// Returns the [HyperEffectsAnimationConfig] from the closest instance of
+  /// this class that encloses the given context.
+  static HyperEffectsAnimationConfig? maybeOf(BuildContext context) {
+    return context
+        .dependOnInheritedWidgetOfExactType<HyperEffectsAnimationConfig>();
+  }
+
+  /// Creates a new [HyperEffectsAnimationConfig] widget.
+  const HyperEffectsAnimationConfig({
+    super.key,
+    required super.child,
+    this.animationBehavior,
+  });
+
+  @override
+  bool updateShouldNotify(covariant HyperEffectsAnimationConfig oldWidget) {
+    return animationBehavior != oldWidget.animationBehavior;
+  }
+}

lib/src/pointer_transition.dart

@@ -1,7 +1,6 @@
 import 'package:flutter/widgets.dart';
 
-import 'apple_curves.dart';
-import 'effect_query.dart';
+import '../hyper_effects.dart';
 
 /// Represents the pointer event for [PointerTransition].
 class PointerTransitionEvent {
@@ -57,6 +56,7 @@ extension PointerTransitionExt on Widget {
     Curve curve = appleEaseInOut,
     Duration duration = const Duration(milliseconds: 125),
     Key? key,
+    AnimationBehavior? animationBehavior,
   }) {
     return PointerTransition(
       key: key,
@@ -69,6 +69,7 @@ extension PointerTransitionExt on Widget {
       curve: curve,
       duration: duration,
       child: this,
+      animationBehavior: animationBehavior,
     );
   }
 }
@@ -124,6 +125,10 @@ class PointerTransition extends StatefulWidget {
   /// about to reset.
   final Duration duration;
 
+  /// The behavior of the controller when
+  /// [AccessibilityFeatures.disableAnimations] is true.
+  final AnimationBehavior? animationBehavior;
+
   /// Creates a new [PointerTransition] with the given [builder], [origin],
   /// [useGlobalPointer], [child], [curve], and [duration].
   const PointerTransition({
@@ -137,6 +142,7 @@ class PointerTransition extends StatefulWidget {
     this.builder,
     this.curve = appleEaseInOut,
     this.duration = const Duration(milliseconds: 125),
+    this.animationBehavior,
   });
 
   @override
@@ -148,6 +154,9 @@ class _PointerTransitionState extends State<PointerTransition>
   late final AnimationController _controller = AnimationController(
     vsync: this,
     duration: widget.duration,
+    animationBehavior: widget.animationBehavior ??
+        HyperEffectsAnimationConfig.maybeOf(context)?.animationBehavior ??
+        AnimationBehavior.normal,
   );
 
   late CurvedAnimation _animation = CurvedAnimation(