🔧 Update Pack 2 #10

Author: SaadArdati

lib/hyper_effects.dart

@@ -10,5 +10,5 @@ export 'src/effect_query.dart';
 export 'src/pointer_transition.dart';
 export 'src/apple_curves.dart';
 export 'src/post_frame_widget.dart';
-export 'src/animation_persister.dart';
+export 'src/animation_retainer.dart';
 export 'src/animated_group_effect.dart';

lib/src/animated_effect.dart

@@ -63,6 +63,7 @@ extension AnimatedEffectExt on Widget? {
     int repeat = 0,
     bool reverse = false,
     bool startImmediately = false,
+    bool skipFirstTime = false,
     bool resetValues = false,
     bool waitForLastAnimation = false,
     Duration delay = Duration.zero,
@@ -78,6 +79,7 @@ extension AnimatedEffectExt on Widget? {
       repeat: repeat,
       reverse: reverse,
       startImmediately: startImmediately,
+      skipFirstTime: skipFirstTime,
       resetValues: resetValues,
       waitForLastAnimation: waitForLastAnimation,
       delay: delay,
@@ -261,6 +263,8 @@ class AnimatedEffect extends StatefulWidget {
   /// built, ignoring the value of [trigger] initially.
   final bool startImmediately;
 
+  final bool skipFirstTime;
+
   /// Normally, an effect represents the current state of the widget and this
   /// animate effect is only in charge of lerping between states of those
   /// effect values.
@@ -301,6 +305,7 @@ class AnimatedEffect extends StatefulWidget {
     this.repeat = 0,
     this.reverse = false,
     this.startImmediately = false,
+    this.skipFirstTime = false,
     this.resetValues = false,
     this.waitForLastAnimation = false,
     this.delay = Duration.zero,
@@ -334,7 +339,7 @@ class AnimatedEffectState extends State<AnimatedEffect>
   /// The animation controller that drives the animation.
   late final AnimationController controller = AnimationController(
     vsync: this,
-    value: shouldSkip ? 1 : 0,
+    value: widget.skipFirstTime || shouldSkip ? 1 : 0,
     duration: widget.duration,
   );
 
@@ -426,7 +431,7 @@ class AnimatedEffectState extends State<AnimatedEffect>
         // ancestor's [AnimationTriggerType] is
         // [AnimationTriggerType.afterLast].
         final AnimatedEffectState? parentState =
-            context.findAncestorStateOfType<AnimatedEffectState>();
+        context.findAncestorStateOfType<AnimatedEffectState>();
         final AnimationTriggerType? triggerType =
             parentState?.widget.triggerType;
         if (parentState != null &&
@@ -438,7 +443,7 @@ class AnimatedEffectState extends State<AnimatedEffect>
         // [ResetAllAnimationsEffect], reset all animations in the chain.
         else {
           final resetState =
-              context.findAncestorStateOfType<ResetAllAnimationsEffectState>();
+          context.findAncestorStateOfType<ResetAllAnimationsEffectState>();
           resetState?.reset();
         }
       }
@@ -495,15 +500,16 @@ class AnimatedEffectState extends State<AnimatedEffect>
   Widget build(BuildContext context) {
     return AnimatedBuilder(
       animation: controller,
-      builder: (context, child) => EffectQuery(
-        linearValue: controller.value,
-        curvedValue: widget.curve.transform(controller.value),
-        isTransition: false,
-        resetValues: widget.resetValues,
-        duration: widget.duration,
-        curve: widget.curve,
-        child: child!,
-      ),
+      builder: (context, child) =>
+          EffectQuery(
+            linearValue: controller.value,
+            curvedValue: widget.curve.transform(controller.value),
+            isTransition: false,
+            resetValues: widget.resetValues,
+            duration: widget.duration,
+            curve: widget.curve,
+            child: child!,
+          ),
       child: widget.child,
     );
   }

lib/src/animated_group_effect.dart

@@ -109,11 +109,7 @@ class AnimatedGroup extends StatefulWidget {
   /// first time, but subsequent insertions should animate.
   final bool triggerAddImmediately;
 
-  /// Whether to use the swap animation when possible. If set to `false`, the
-  /// swap animation will be skipped and the new child will have the
-  /// [addBuilder] applied to it and the old child will have the
-  /// [removeBuilder] applied to it.
-  final bool useSwapWhenPossible;
+  final bool noSwapping;
 
   /// Creates an [AnimatedGroup] with the given parameters.
   const AnimatedGroup({
@@ -124,7 +120,7 @@ class AnimatedGroup extends StatefulWidget {
     this.addBuilder = _defaultAddedChildBuilder,
     this.swapBuilder = _defaultSwappedChildBuilder,
     this.triggerAddImmediately = false,
-    this.useSwapWhenPossible = true,
+    this.noSwapping = false,
   });
 
   @override
@@ -162,6 +158,7 @@ class _AnimatedGroupState extends State<AnimatedGroup> {
             removeBuilder: widget.removeBuilder,
             addBuilder: widget.addBuilder,
             swapBuilder: widget.swapBuilder,
+            noSwapping: widget.noSwapping,
             child:
                 widget.children.length > index ? widget.children[index] : null,
           );
@@ -190,6 +187,8 @@ class AnimatedChild extends StatefulWidget {
   /// child.
   final bool useSnapshots;
 
+  final bool noSwapping;
+
   /// The builder that wraps the given [child] in a widget that animates the
   /// removal of the child out of the widget tree.
   final RemovedChildBuilder removeBuilder;
@@ -208,6 +207,7 @@ class AnimatedChild extends StatefulWidget {
     required this.child,
     this.triggerAdd = true,
     this.useSnapshots = true,
+    this.noSwapping = false,
     this.removeBuilder = _defaultRemovedChildBuilder,
     this.addBuilder = _defaultAddedChildBuilder,
     this.swapBuilder = _defaultSwappedChildBuilder,
@@ -255,7 +255,7 @@ class _AnimatedChildState extends State<AnimatedChild> {
       alignment: Alignment.center,
       clipBehavior: Clip.none,
       children: [
-        if (widget.child == null)
+        if (widget.noSwapping || widget.child == null)
           if (prevChild case Widget prev)
             KeyedSubtree(
               key: removedKey,
@@ -264,10 +264,12 @@ class _AnimatedChildState extends State<AnimatedChild> {
         if (widget.child case Widget child)
           widget.addBuilder(
             context,
-            widget.swapBuilder(
-              context,
-              child,
-            ),
+            widget.noSwapping
+                ? child
+                : widget.swapBuilder(
+                    context,
+                    child,
+                  ),
             () => !widget.triggerAdd,
           ),
       ],