4.11.0

CHANGELOG.md

@@ -1,4 +1,12 @@
 
+## 4.11.0
+February 18, 2023
+- Deprecated 
+  Set<StateX> get states - Set of States is too accessible
+- Introduced these getters instead:
+  StateX? get startState
+  StateX? get endState
+
 ## 4.10.0
 January 24, 2023
 - StateX({StateXController? controller, bool? runAsync, bool? useInherited}) {

example/lib/src/another_app/home/inherited/controller/inherit_controller.dart

@@ -13,8 +13,8 @@ class InheritController extends StateXController {
   /// The InheritedWidget is the first State object it registered with.
   @override
   bool dependOnInheritedWidget(BuildContext? context) =>
-      states.first.dependOnInheritedWidget(context);
+      startState?.dependOnInheritedWidget(context) ?? false;
 
   /// Rebuild the InheritedWidget to also rebuild its dependencies.
-  void newAnimals() => states.first.notifyClients();
+  void newAnimals() => startState?.notifyClients();
 }

example/test/test_controller.dart

@@ -107,7 +107,7 @@ void testsController(WidgetTester tester) {
   expect(con, isA<Controller>(), reason: location);
 
   // The Set of State objects
-  con.states;
+//  con.states; // Deprecated
 
   // Continuing the testing coverage
   con.notifyClients();

lib/state_extended.dart

@@ -1206,8 +1206,7 @@ abstract class StateX<T extends StatefulWidget> extends State<StatefulWidget>
 /// {@category StateX class}
 abstract class StateF<T extends StatefulWidget> extends StateX<T> {
   ///
-  StateF({StateXController? controller})
-      : super(controller: controller, runAsync: true);
+  StateF({super.controller}) : super(runAsync: true);
 }
 
 /// A State object that explicitly implements a built-in InheritedWidget
@@ -1216,8 +1215,7 @@ abstract class StateF<T extends StatefulWidget> extends StateX<T> {
 /// {@category StateX class}
 abstract class StateIn<T extends StatefulWidget> extends StateX<T> {
   ///
-  StateIn({StateXController? controller})
-      : super(controller: controller, useInherited: true);
+  StateIn({super.controller}) : super(useInherited: true);
 }
 
 /// Collects Controllers of various types.
@@ -1687,11 +1685,18 @@ mixin SetStateMixin {
     return state == null ? null : state as T;
   }
 
-  // /// Return a 'copy' of the Set of State objects.
-  // Set<StateX> get states => Set.from(_stateXSet.whereType<StateX>());
+  /// Return a 'copy' of the Set of State objects.
+  // Set<StateX> get states => Set.from(_stateXSet?.whereType<StateX>());
 
   /// The Set of State objects.
+  @Deprecated('Set states is too accessible')
   Set<StateX> get states => _stateXSet;
+
+  /// Return the first State object
+  StateX? get startState => _stateXSet.isEmpty ? null : _stateXSet.first;
+
+  /// Return the 'latest' State object
+  StateX? get endState => _stateXSet.isEmpty ? null : _stateXSet.last;
 }
 
 /// Used to explicitly return the 'type' indicated.
@@ -2388,10 +2393,9 @@ class _StateXInheritedWidget extends InheritedWidget {
 /// Supply a widget to depend upon a StateX's InheritedWidget
 class _SetStateWidget extends StatelessWidget {
   const _SetStateWidget({
-    Key? key,
     required this.stateX,
     required this.widgetFunc,
-  }) : super(key: key);
+  });
   final StateX stateX;
   final WidgetBuilder widgetFunc;
   @override
@@ -2415,12 +2419,11 @@ abstract class AppStateX<T extends StatefulWidget> extends StateX<T>
   /// Optionally supply as many State Controllers as you like to work with this App.
   /// Optionally supply a 'data object' to to be accessible to the App's InheritedWidget.
   AppStateX({
-    StateXController? controller,
+    super.controller,
     List<StateXController>? controllers,
     Object? object,
     // Save the current error handler
-  })  : _currentErrorFunc = FlutterError.onError,
-        super(controller: controller) {
+  }) : _currentErrorFunc = FlutterError.onError {
     //Record this as the 'root' State object.
     setRootStateX(this);
     _dataObj = object;
@@ -2687,9 +2690,9 @@ abstract class AppStateX<T extends StatefulWidget> extends StateX<T>
 /// Pass a State object as a parameter to this StatefulWidget
 class _StateStatefulWidget extends StatefulWidget {
   const _StateStatefulWidget({
-    Key? key,
+    super.key,
     required this.state,
-  }) : super(key: key);
+  });
   final State<StatefulWidget> state;
   @override
   //ignore: no_logic_in_create_state
@@ -2945,7 +2948,7 @@ mixin _ControllersById<T extends StatefulWidget> on StateX<T> {
 @protected
 class SetState extends StatelessWidget {
   /// Supply a 'builder' passing in the App's 'data object' and latest BuildContext object.
-  const SetState({Key? key, required this.builder}) : super(key: key);
+  const SetState({super.key, required this.builder});
 
   /// This is called with every rebuild of the App's inherited widget.
   final Widget Function(BuildContext context, Object? object) builder;

pubspec.lock

@@ -78,10 +78,10 @@ packages:
     dependency: "direct dev"
     description:
       name: flutter_lints
-      sha256: a25a15ebbdfc33ab1cd26c63a6ee519df92338a9c10f122adda92938253bef04
+      sha256: e2a421b7e59244faef694ba7b30562e489c2b489866e505074eb005cd7060db7
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.3"
+    version: "3.0.1"
   flutter_localizations:
     dependency: "direct main"
     description: flutter
@@ -130,10 +130,10 @@ packages:
     dependency: transitive
     description:
       name: lints
-      sha256: "0a217c6c989d21039f1498c3ed9f3ed71b354e69873f13a8dfc3c9fe76f1b452"
+      sha256: cbf8d4b858bb0134ef3ef87841abdf8d63bfc255c266b7bf6b39daa1085c4290
       url: "https://pub.dev"
     source: hosted
-    version: "2.1.1"
+    version: "3.0.0"
   matcher:
     dependency: transitive
     description:

pubspec.yaml

@@ -1,6 +1,6 @@
 name: state_extended
 description: This class extends the capabilities of Flutter's State class and includes a controller.
-version: 4.10.0
+version: 4.11.0
 homepage: https://www.andrioussolutions.com
 repository: https://github.com/AndriousSolutions/state_extended
 
@@ -32,7 +32,7 @@ dev_dependencies:
   # activated in the `analysis_options.yaml` file located at the root of your
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
-  flutter_lints: ^2.0.0
+  flutter_lints: ^3.0.0
 
   # Needed here as well for testing
   flutter_test: