refactor: deprecate completeStateDuration in favor of completeDuration

Author: gonuit

CHANGELOG.md

@@ -1,6 +1,6 @@
 ## 3.0.0
 - **CustomRefreshIndicator**:
-  - Deprecated *indicatorFinalizeDuration*, *indicatorSettleDuration* and *indicatorCancelDuration* parameters in favor of *finalizeDuration*, *settleDuration* and *cancelDuration*.
+  - Deprecated *indicatorFinalizeDuration*, *indicatorSettleDuration*, *indicatorCancelDuration* and *completeStateDuration* parameters in favor of *finalizeDuration*, *settleDuration*, *cancelDuration* and *completeDuration*.
   - The indicator widget will now be rebuilt every time *state* changes, even if the *autoRebuilt* parameter is set to false. This will make managing the state of the indicator widget simpler.
 - **IndicatorController**:
   - The controller now extends *Animation<double>*. This allows it to be used directly with *Transition* widgets to further improve animation performance.

example/lib/indicators/check_mark_indicator.dart

@@ -51,7 +51,7 @@ class _CheckMarkIndicatorState extends State<CheckMarkIndicator> with SingleTick
   Widget build(BuildContext context) {
     return CustomRefreshIndicator(
       onRefresh: () => Future.delayed(const Duration(seconds: 2)),
-      completeStateDuration: const Duration(seconds: 2),
+      completeDuration: const Duration(seconds: 2),
       onStateChanged: (change) {
         /// set [_renderCompleteState] to true when controller.state become completed
         if (change.didChange(to: IndicatorState.complete)) {

lib/src/custom_refresh_indicator.dart

@@ -66,7 +66,7 @@ class CustomRefreshIndicator extends StatefulWidget {
 
   /// Duration for which the indicator remains at value of *1.0* and
   /// [IndicatorState.complete] state after the [onRefresh] function completes.
-  final Duration? completeStateDuration;
+  final Duration? completeDuration;
 
   /// Determines whether the received [ScrollNotification] should
   /// be handled by this widget.
@@ -161,7 +161,8 @@ class CustomRefreshIndicator extends StatefulWidget {
     Duration settleDuration = const Duration(milliseconds: 150),
     @Deprecated('In favor of finalizeDuration') Duration? indicatorFinalizeDuration,
     Duration finalizeDuration = const Duration(milliseconds: 100),
-    this.completeStateDuration,
+    @Deprecated('In favor of completeDuration') Duration? completeStateDuration,
+    Duration? completeDuration,
     this.leadingScrollIndicatorVisible = false,
     this.trailingScrollIndicatorVisible = true,
   })  : assert(
@@ -172,6 +173,7 @@ class CustomRefreshIndicator extends StatefulWidget {
         cancelDuration = indicatorCancelDuration ?? cancelDuration,
         finalizeDuration = indicatorFinalizeDuration ?? finalizeDuration,
         settleDuration = indicatorSettleDuration ?? settleDuration,
+        completeDuration = completeStateDuration ?? completeDuration,
         // set the default extent percentage value if not provided
         containerExtentPercentageToArmed = containerExtentPercentageToArmed ?? defaultContainerExtentPercentageToArmed,
         super(key: key);
@@ -542,7 +544,7 @@ class CustomRefreshIndicatorState extends State<CustomRefreshIndicator> with Tic
     if (!mounted) return;
 
     /// optional complete state
-    final completeStateDuration = widget.completeStateDuration;
+    final completeStateDuration = widget.completeDuration;
     if (completeStateDuration != null) {
       setIndicatorState(IndicatorState.complete);
       await Future.delayed(completeStateDuration);

test/src/custom_refresh_indicator_test.dart

@@ -1011,7 +1011,7 @@ void main() {
           onStateChanged: (change) => changes.add(change),
           builder: buildWithoutIndicator,
           onRefresh: fakeRefresh.instantRefresh,
-          completeStateDuration: const Duration(milliseconds: 300),
+          completeDuration: const Duration(milliseconds: 300),
           child: const DefaultList(itemsCount: 1),
         ),
       ),