chore(release): bump version to 7.24.1

Author: agordn52

CHANGELOG.md

@@ -1,3 +1,12 @@
+## [7.24.1] - 2026-05-10
+
+### Fixed
+
+* **`CollectionView` no longer crashes mid-refresh on long lists** - `_onRefresh` previously assigned `_data = []` synchronously *before* awaiting the new data, which could leave the live `SliverList` pointing at an empty list mid-frame and throw `RangeError` when cached children relayed out. `_data` is now mutated only inside `setState` after the new data resolves
+* **`CollectionView` accepts `List<dynamic>` returned from JSON-decoded API responses** - previously a `List<dynamic>` (the typical shape from `jsonDecode`) would trip an internal `List<T>` assertion. The widget now lazily casts via `List.cast<T>()`, so callers no longer have to call `.cast<T>()` themselves
+* **`CollectionView.stateActions(name).refreshData()` no longer clears the list mid-fetch** - `_data` was being cleared synchronously before the new data resolved, briefly showing an empty state. The list is now preserved until the new data is ready
+* **Null result from `paginatedData` on pull-to-refresh now preserves the existing list** instead of incorrectly calling `loadNoData()`. The refresh indicator settles and the previous data remains visible
+
 ## [7.24.0] - 2026-05-07
 
 ### Added

README.md

@@ -49,7 +49,7 @@ import 'package:nylo_support/widgets/ny_widgets.dart';
 
 ```yaml
 dependencies:
-  nylo_support: ^7.24.0
+  nylo_support: ^7.24.1
 ```
 
 ### Documentation

example/pubspec.lock

@@ -483,7 +483,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "7.23.0"
+    version: "7.24.1"
   objective_c:
     dependency: transitive
     description:

lib/widgets/src/collection_view.dart

@@ -555,8 +555,7 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
           _data = [];
           return;
         }
-        assert(data is List<T>, "Data must be a List<$T>");
-        _data = data;
+        _data = _coerceToList(data);
       } else {
         awaitData(
           perform: () async {
@@ -565,8 +564,7 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
               _data = [];
               return;
             }
-            assert(data is List<T>, "Data must be a List<$T>");
-            _data = data;
+            _data = _coerceToList(data);
           },
         );
       }
@@ -576,10 +574,10 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
         final data = widget.data!();
         if (data == null) {
           _data = [];
-          return;
+        } else {
+          _data = _coerceToList(data);
         }
-        assert(data is List<T>, "Data must be a List<$T>");
-        _data = data;
+        _syncDataInitialized = true;
         return;
       }
       awaitData(
@@ -589,8 +587,7 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
             _data = [];
             return;
           }
-          assert(data is List<T>, "Data must be a List<$T>");
-          _data = data;
+          _data = _coerceToList(data);
         },
       );
     }
@@ -622,9 +619,7 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
     },
     'refreshData': (_) async {
       setLoading(true);
-      _data = [];
       _iteration = 1;
-      _syncDataInitialized = false;
       if (widget.isPullable) {
         _refreshController.refreshCompleted(resetFooterState: true);
       }
@@ -636,10 +631,8 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
         } else if (widget.data != null) {
           result = await Future.value(widget.data!());
         }
-        if (result != null) {
-          assert(result is List<T>, "Data must be a List<$T>");
-          _data = result;
-        }
+        _data = result == null ? [] : _coerceToList(result);
+        _syncDataInitialized = true;
       } catch (e) {
         NyLogger.error(e.toString());
       }
@@ -675,55 +668,60 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
   /// Refresh the list (for pullable mode)
   Future<void> _onRefresh() async {
     _iteration = 1;
-    _data = [];
 
     if (widget.beforeRefresh != null) {
       await widget.beforeRefresh!();
     }
 
-    List<T>? newData = [];
+    dynamic rawData;
     if (widget.paginatedData is! Future Function(int)) {
-      newData = widget.paginatedData!(_iteration);
+      rawData = widget.paginatedData!(_iteration);
     } else {
-      newData = await widget.paginatedData!(_iteration);
+      rawData = await widget.paginatedData!(_iteration);
     }
-    if (newData == null) {
-      _refreshController.loadNoData();
+    if (rawData == null) {
+      if (mounted) {
+        _refreshController.refreshCompleted(resetFooterState: true);
+      }
       return;
     }
 
-    _data = newData;
-
+    List<T> resolved = _coerceToList(rawData);
     if (widget.afterRefresh != null) {
-      _data = widget.afterRefresh!(_data);
+      final after = widget.afterRefresh!(resolved);
+      if (after is List<T>) {
+        resolved = after;
+      } else if (after is List) {
+        resolved = after.cast<T>();
+      }
     }
 
-    if (widget.onRefresh == null) {
-      _refreshController.refreshCompleted(resetFooterState: true);
-      setState(() {});
-      return;
+    if (widget.onRefresh != null) {
+      await widget.onRefresh!();
     }
-    await widget.onRefresh!();
 
+    if (!mounted) return;
+    setState(() {
+      _data = resolved;
+    });
     _refreshController.refreshCompleted(resetFooterState: true);
-
-    setState(() {});
   }
 
   /// Load more data (for pullable mode)
   Future<void> _onLoading() async {
     _iteration++;
 
-    List<T>? newData = [];
+    dynamic rawData;
     if (widget.paginatedData is! Future Function(int)) {
-      newData = widget.paginatedData!(_iteration);
+      rawData = widget.paginatedData!(_iteration);
     } else {
-      newData = await widget.paginatedData!(_iteration);
+      rawData = await widget.paginatedData!(_iteration);
     }
-    if (newData == null) {
+    if (rawData == null) {
       _refreshController.loadNoData();
       return;
     }
+    final List<T> newData = _coerceToList(rawData);
     if (newData.isEmpty) {
       _refreshController.loadNoData();
       return;
@@ -782,6 +780,16 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
     return result;
   }
 
+  /// Coerces a raw value into a `List<T>`. Accepts a `List<T>` directly, casts
+  /// a generic `List` (e.g. `List<dynamic>` decoded from a JSON API response)
+  /// to `List<T>`, and falls back to an empty list otherwise.
+  List<T> _coerceToList(dynamic data) {
+    if (data is List<T>) return data;
+    if (data is List) return data.cast<T>();
+    assert(false, "Data must be a List<$T>");
+    return [];
+  }
+
   /// Returns the header widget based on headerStyle
   Widget _headerType() {
     return switch (widget.headerStyle) {
@@ -829,7 +837,8 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
   Widget _buildRegularView(Widget loadingWidget) {
     if (widget.data is! Future Function()) {
       if (!_syncDataInitialized) {
-        _data = widget.data!() ?? [];
+        final raw = widget.data!();
+        _data = raw == null ? [] : _coerceToList(raw);
         _syncDataInitialized = true;
       }
       if (_data.isEmpty) {

pubspec.yaml

@@ -1,6 +1,6 @@
 name: nylo_support
 description: Support library for the Nylo framework. This library supports routing, widgets, localization, cli, storage and more.
-version: 7.24.0
+version: 7.24.1
 homepage: https://nylo.dev
 repository: https://github.com/nylo-core/support/tree/7.x
 issue_tracker: https://github.com/nylo-core/support/issues