feat: release v7.16.0

Author: Anthony Gordon

example/pubspec.lock

@@ -5,10 +5,10 @@ packages:
     dependency: transitive
     description:
       name: app_badge_plus
-      sha256: ce3d8fdfcf39a1552cc8dea499ee3b4a86273ccf04c8de29e7960c739b045ae6
+      sha256: "81130fe6150ce2a1f12af4bb7d6f646496d284d5f87f2c121af8258a453bbb3f"
       url: "https://pub.dev"
     source: hosted
-    version: "1.2.7"
+    version: "1.2.8"
   args:
     dependency: transitive
     description:
@@ -85,10 +85,10 @@ packages:
     dependency: transitive
     description:
       name: connectivity_plus
-      sha256: b8fe52979ff12432ecf8f0abf6ff70410b1bb734be1c9e4f2f86807ad7166c79
+      sha256: "62ffa266d9a23b79fb3fcbc206afc00bb979417ba57b1324c546b5aab95ba057"
       url: "https://pub.dev"
     source: hosted
-    version: "7.1.0"
+    version: "7.1.1"
   connectivity_plus_platform_interface:
     dependency: transitive
     description:
@@ -373,6 +373,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.20.2"
+  jni:
+    dependency: transitive
+    description:
+      name: jni
+      sha256: c2230682d5bc2362c1c9e8d3c7f406d9cbba23ab3f2e203a025dd47e0fb2e68f
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.0"
+  jni_flutter:
+    dependency: transitive
+    description:
+      name: jni_flutter
+      sha256: "8b59e590786050b1cd866677dddaf76b1ade5e7bc751abe04b86e84d379d3ba6"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.1"
   leak_tracker:
     dependency: transitive
     description:
@@ -467,7 +483,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "7.14.1"
+    version: "7.15.0"
   objective_c:
     dependency: transitive
     description:
@@ -476,6 +492,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "9.3.0"
+  package_config:
+    dependency: transitive
+    description:
+      name: package_config
+      sha256: f096c55ebb7deb7e384101542bfba8c52696c1b56fca2eb62827989ef2353bbc
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.0"
   path:
     dependency: transitive
     description:
@@ -496,10 +520,10 @@ packages:
     dependency: transitive
     description:
       name: path_provider_android
-      sha256: "149441ca6e4f38193b2e004c0ca6376a3d11f51fa5a77552d8bd4d2b0c0912ba"
+      sha256: "69cbd515a62b94d32a7944f086b2f82b4ac40a1d45bebfc00813a430ab2dabcd"
       url: "https://pub.dev"
     source: hosted
-    version: "2.2.23"
+    version: "2.3.1"
   path_provider_foundation:
     dependency: transitive
     description:

lib/widgets/src/collection_view.dart

@@ -448,12 +448,20 @@ class CollectionView<T> extends StatefulWidget {
        paginatedData = data,
        this.data = null;
 
+  /// Returns a [CollectionViewStateActions] instance for the given [stateName].
+  static CollectionViewStateActions stateActions(String stateName) =>
+      CollectionViewStateActions(stateName);
+
   /// Resets the state.
+  @Deprecated('Use CollectionView.stateActions(stateName).reset() instead')
   static void stateReset(String stateName) {
     updateState(stateName, data: {"action": "reset", "data": {}});
   }
 
   /// Removes an item from the list at the given index.
+  @Deprecated(
+    'Use CollectionView.stateActions(stateName).removeFromIndex(index) instead',
+  )
   static void removeFromIndex(String stateName, int index) {
     updateState(
       stateName,
@@ -465,17 +473,60 @@ class CollectionView<T> extends StatefulWidget {
   }
 }
 
+/// State actions for [CollectionView].
+///
+/// Example usage:
+/// ```dart
+/// CollectionView.stateActions("my_list").reset();
+/// CollectionView.stateActions("my_list").addItem(newItem);
+/// CollectionView.stateActions("my_list").removeFromIndex(2);
+/// ```
+class CollectionViewStateActions extends StateActions {
+  CollectionViewStateActions(super.state);
+
+  /// Resets the CollectionView, clearing data and re-fetching.
+  void reset() {
+    action("reset");
+  }
+
+  /// Removes the item at [index] from the list.
+  void removeFromIndex(int index) {
+    action("removeFromIndex", data: {"index": index});
+  }
+
+  /// Re-fetches data from the data callback.
+  void refreshData() {
+    action("refreshData");
+  }
+
+  /// Appends [item] to the end of the list.
+  void addItem(dynamic item) {
+    action("addItem", data: {"item": item});
+  }
+
+  /// Inserts [item] at [index] in the list.
+  void insertItem(int index, dynamic item) {
+    action("insertItem", data: {"index": index, "item": item});
+  }
+
+  /// Replaces the item at [index] with [item].
+  void updateItemAtIndex(int index, dynamic item) {
+    action("updateItemAtIndex", data: {"index": index, "item": item});
+  }
+}
+
 class _CollectionViewState<T> extends NyState<CollectionView<T>> {
   List<T> _data = [];
+  bool _syncDataInitialized = false;
   int _iteration = 1;
   final RefreshController _refreshController = RefreshController(
     initialRefresh: false,
   );
 
   @override
   void initState() {
-    super.initState();
     stateName = widget.stateName;
+    super.initState();
   }
 
   @override
@@ -487,6 +538,7 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
   @override
   get init => () {
     _iteration = 1;
+    _syncDataInitialized = false;
 
     if (widget.isPullable) {
       // Pullable mode - use paginatedData
@@ -562,6 +614,34 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
       _data.removeAt(index);
       setState(() {});
     },
+    'refreshData': (_) async {
+      _data = [];
+      await reboot();
+    },
+    'addItem': (data) {
+      if (data is! Map || !data.containsKey('item')) return;
+      _data.add(data['item']);
+      setState(() {});
+    },
+    'insertItem': (data) {
+      if (data is! Map ||
+          !data.containsKey('index') ||
+          !data.containsKey('item'))
+        return;
+      int index = (data['index'] as int).clamp(0, _data.length);
+      _data.insert(index, data['item']);
+      setState(() {});
+    },
+    'updateItemAtIndex': (data) {
+      if (data is! Map ||
+          !data.containsKey('index') ||
+          !data.containsKey('item'))
+        return;
+      int index = data['index'];
+      if (index < 0 || index >= _data.length) return;
+      _data[index] = data['item'];
+      setState(() {});
+    },
   };
 
   /// Refresh the list (for pullable mode)
@@ -720,7 +800,10 @@ class _CollectionViewState<T> extends NyState<CollectionView<T>> {
   /// Build regular (non-pullable) view
   Widget _buildRegularView(Widget loadingWidget) {
     if (widget.data is! Future Function()) {
-      _data = widget.data!() ?? [];
+      if (!_syncDataInitialized) {
+        _data = widget.data!() ?? [];
+        _syncDataInitialized = true;
+      }
       if (_data.isEmpty) {
         return _buildEmptyWidget();
       }

lib/widgets/src/input_field.dart

@@ -1023,11 +1023,33 @@ class InputField extends StatefulWidget {
       TextFieldStateActions(stateName);
 }
 
-/// Provides state management actions for [InputField] widgets.
+/// State actions for [InputField].
 ///
-/// Extends [FormStateActions] to provide text field-specific operations.
+/// Example usage:
+/// ```dart
+/// InputField.stateActions("my_field").clear();
+/// InputField.stateActions("my_field").setValue("Hello");
+/// InputField.stateActions("my_field").focus();
+/// InputField.stateActions("my_field").unfocus();
+/// InputField.stateActions("my_field").toggleObscure();
+/// ```
 class TextFieldStateActions extends FormStateActions {
   TextFieldStateActions(super.state);
+
+  /// Request focus on the text field.
+  void focus() {
+    action("focus");
+  }
+
+  /// Remove focus from the text field.
+  void unfocus() {
+    action("unfocus");
+  }
+
+  /// Toggle password visibility.
+  void toggleObscure() {
+    action("toggleObscure");
+  }
 }
 
 class _InputFieldState extends NyState<InputField> {
@@ -1063,6 +1085,15 @@ class _InputFieldState extends NyState<InputField> {
       widget.controller.text = text;
       setState(() {});
     },
+    "focus": (_) {
+      _focus.requestFocus();
+    },
+    "unfocus": (_) {
+      _focus.unfocus();
+    },
+    "toggleObscure": (_) {
+      _toggleObscured();
+    },
   };
 
   @override

lib/widgets/src/language_switcher.dart

@@ -206,6 +206,10 @@ class LanguageSwitcher extends StatefulWidget {
 
   static String state = "ny_lang_switcher";
 
+  /// Returns a [LanguageSwitcherStateActions] instance for the given [stateName].
+  static LanguageSwitcherStateActions stateActions([String? stateName]) =>
+      LanguageSwitcherStateActions(stateName ?? state);
+
   /// Get the current language
   static Future<Map<String, dynamic>?> currentLanguage({String? key}) async {
     key ??= state;
@@ -492,10 +496,7 @@ class LanguageSwitcher extends StatefulWidget {
                           // store the language
                           await storeLanguage(object: {data.key: data.value});
 
-                          updateState(
-                            state,
-                            data: {"action": "refresh-page", "data": {}},
-                          );
+                          LanguageSwitcher.stateActions().refresh();
                           if (!isSelected) {
                             onLanguageChange?.call(data.key);
                           }
@@ -1126,6 +1127,27 @@ class LanguageSwitcher extends StatefulWidget {
   createState() => _LanguageSwitcherState();
 }
 
+/// State actions for [LanguageSwitcher].
+///
+/// Example usage:
+/// ```dart
+/// LanguageSwitcher.stateActions().refresh();
+/// LanguageSwitcher.stateActions().setLanguage("es");
+/// ```
+class LanguageSwitcherStateActions extends StateActions {
+  LanguageSwitcherStateActions(super.state);
+
+  /// Refresh the language switcher, re-fetching the language list.
+  void refresh() {
+    action("refresh");
+  }
+
+  /// Programmatically set the language by locale code.
+  void setLanguage(String localeCode) {
+    action("setLanguage", data: {"localeCode": localeCode});
+  }
+}
+
 class _LanguageSwitcherState extends NyState<LanguageSwitcher> {
   Map<String, dynamic>? selectedLanguage;
   List<Map<String, String>> languages = [];
@@ -1135,6 +1157,20 @@ class _LanguageSwitcherState extends NyState<LanguageSwitcher> {
     stateName = LanguageSwitcher.state;
   }
 
+  @override
+  Map<String, Function> get stateActions => {
+    'refresh': (_) async {
+      languages = await LanguageSwitcher.getLanguageList();
+      selectedLanguage = await LanguageSwitcher.currentLanguage();
+      setState(() {});
+    },
+    'setLanguage': (data) async {
+      if (data is! Map || !data.containsKey('localeCode')) return;
+      String localeCode = data['localeCode'];
+      await _onChange(localeCode);
+    },
+  };
+
   @override
   get init => () async {
     languages = await LanguageSwitcher.getLanguageList();

lib/widgets/src/ny_page.dart

@@ -42,6 +42,7 @@ abstract class NyPage<T extends StatefulWidget> extends NyBaseState<T>
       if (stateName?.contains("Closure: _") ?? false) {
         stateName = stateName?.replaceAll("Closure: _", "Closure: () => _");
       }
+      (widget as NyStatefulWidget).controller.state = stateName;
     }
 
     if (stateManaged && allowStateUpdates) {