state_extended 5.0.0+2 state_extended: ^5.0.0+2 copied to clipboard
This class extends the capabilities of Flutter's State class and includes a controller.
5.0.0+2 #
September 04, 2024
- Remove all deprecated properties, functions, and methods
- Introduce RouteObserverStates.subscribeRoutes(this); in route_observer_states.dart
- Print in triggered events with showBinding == true.
- Remove updateNewStateX() from StateX. Not necessary.
- detachedAppLifecycleState() in mixin StateListener
- Remove all commented out code
- Replace runAsync(); with intiAsync();
- Replace buildIn() with builder();
- Introduce _BuilderState and _InheritedWidgetState to AppState.buildF() Calls both builder() and built-in InheritedWidget separately
- Rename bool forEach() to bool forEachState()
- mixin RecordExceptionMixin to mixin RecordExceptionMixin on State
- Update README Example app
- Separated tests into some Dart files
- Renamed part files
- Commented out mixin StateXRouteAware
- Commented out void '_copyOver' functions
4.24.0 #
August 18, 2024
- AppStateX now has FlutterError.onError = _currentErrorFunc; in deactivate() since removed from dispose()
- AppStateX now has useInherited = false by default
- No longer needed class _StateStatefulWidget or class _InheritedState or class _BuildInState
- if (rootState == null) { WidgetsBinding.instance.removeObserver(this); in deactivate()
- Deprecated state(WidgetBuilder? widgetFunc) { Use stateSet(WidgetBuilder? widgetFunc) { instead
4.23.0 #
August 05, 2024
- @Deprecated('Use stateSet() instead.') Widget state(WidgetBuilder? widgetFunc) {
4.22.1 #
August 05, 2024
- didUpdateWidget(StatefulWidget oldWidget) { to didUpdateWidget(covariant T oldWidget) { and didUpdateWidget(covariant StatefulWidget oldWidget) {
4.22.0 #
July 25, 2024
- /// Call the latest SateX object's error routine /// Possibly the error occurred there. bool onStateError(FlutterErrorDetails details) {
- /// Logs 'every' error as the error count is reset. void logErrorDetails(FlutterErrorDetails details) {
4.21.0 #
July 22, 2024
- AppState.errorStateName - String getter naming last State class throwing an error
- isEndState is deprecated, use lastState instead
- startState is deprecated, use firstState instead
4.20.0 #
July 14, 2024
- AppState class loops through all the app's StateX objects when an event occurs. Each StateX class will otherwise register as its own binding observer: WidgetsBinding.instance.addObserver(this);
- The getter, didCallChangeEvent, serves as a flag for event handling // Already called by another State object currently running. if (didCallChangeEvent) {
- didPushRoute(String route) is now deprecated after v3.8.0-14.0.pre
4.19.0 #
July 10, 2024
- AppState.detachedAppLifecycleState() 'attempts' to call State object's deactivate() and dispose()
- AppState.didChangeAppLifecycleState() encompasses life cycle event flags.
- Renamed event flags: inactive, hidden, paused, resumed, detached to _inactiveAppLifecycle, _hiddenAppLifecycle, _pausedAppLifecycle, _resumedAppLifecycle, _detachedAppLifecycle
- Renamed the functions: inactiveAppLifecycle(), hiddenAppLifecycle(), pausedAppLifecycle(), resumedAppLifecycle(), detachedAppLifecycle()
- Removed @protected from methods to be used outside an instance member's subclasses:
4.18.0 #
June 15, 2024
- getter usingCupertino assigned a local variable
- CupertinoActivityIndicator and CircularProgressIndicator used by default
- Increase test coverage
4.17.0 #
June 06, 2024
- Flag defaults to false: _useInherited = useInherited ?? false;
- Deprecated class StateF. Instead use StateX class with 'runAsync: true' Deprecated class StateIn. Instead use StateX class with 'useInherited: true'
- getter, useInherited, is also true if buildIn() id overridden
- Don't ever use build() now. Instead use new function, builder() Or use buildIn() to work with the built-in InheritedWidget like 'useInherited: true'
- New getter, builderOverridden
4.16.1 #
May 27, 2024
- Cat and Bird images now come from https:\api.sefinek.net
4.16.0 #
May 26, 2024
- The function, runAsync(), is deprecated. Set to true the parameter, runAsync, instead.
- getter, InheritedWidgetStateMixin, moved to InheritedWidgetStateMixin
4.15.0 #
May 18, 2024
- _StateXInheritedWidget() to StateXInheritedWidget() making it publicly available.
4.14.0 #
May 17, 2024
- class StateIn, now has abstract method: Widget buildIn(BuildContext context);
- Flag defaults to true: _useInherited = useInherited ?? true;
- Call built-in InheritedWidget is buildIn() function is being used: _useInherited && _buildInOverridden ? _StateXInheritedWidget(
4.13.0 #
April 15, 2024
- catchError() takes FlutterErrorDetails parameters
- snapshot.stackTrace in _futureBuilder()
4.12.0 #
March 17, 2024
- Deprecated getter, startState. Use getter firstState instead
- Deprecated getter, endState. Use getter lastState instead
4.11.0 #
February 18, 2023
- Deprecated Set
- Introduced these getters instead: StateX? get startState StateX? get endState
4.10.0 #
January 24, 2023
- StateX({StateXController? controller, bool? runAsync, bool? useInherited}) { A new optional parameter, runAsync, to run built-in FutureBuilder with every build
- abstract class StateF
4.9.0 #
December 14, 2023
- getter buildOverridden & buildFOverridden set when 'build' functions are overwritten
- Notify the developer the 'built-in' InheritedWidget is set for use and yet the buildIn() function is not used.
4.8.5 #
November 26, 2023
- Allow for additional controllers to be added in a previous initAsync() while (cnt < controllerList.length) { cnt++;
4.8.3 #
November 26, 2023
- Allow for additional controllers to call their initState() if added in a previous initState() call while (cnt < controllerList.length) {
- Container() to SizedBox() in splash_screen.dart
4.8.2 #
October 25, 2023
- didUpdateController() in didUpdateWidget() in special cases
4.8.1 #
October 23, 2023
- (state != null && state is StateX) remove necessary cast
4.8.0 #
October 23, 2023
- State? to StateX? for getter startState & endState
4.7.0+3 #
September 27, 2023
- Introduced new event handler: hiddenLifecycleState()
- Fixed class _SetStateWidget with stateX.dependOnInheritedWidget(context);
- if (!mounted) { in event handle functions
- Updating test_statex.dart
- Updated documentation topic testing
- Continue with more documentation
4.6.0 #
August 31, 2023
- Improved StateX onError() routine
- More Error handling in _futureBuilder()
- In development, rethrow errors in error handler
- Function containsType
- Splash screen in example app
- Expanded unit testing
4.5.1+2 #
August 28, 2023
- Localizations in FutureBuilderStateMixin
- getter usingCupertino
- notifyClients() has try..catch
- Update didPushRouteInformation()
- rootCon now returns the 'root' controller
- Corrected the test routines and documentation
4.4.0+1 #
August 19, 2023
- Includes an onSplashScreen routine
- onError routine also involves particular libraries
- initAsync() now only ever called once;
- Includes getter snapshot
- Continues with documentation: Get Started
4.3.0 #
August 10, 2023
- Added the contains() function in mixin _ControllersById
- Continue with more documentation
4.2.0+4 #
August 04, 2023
- Introduced onError(details) {} to the StateX class
- _key = ValueKey
- List
- Increase the testing coverage over the source code
- Introduce more documentation
4.1.1 #
August 01, 2023
- Unlike StateX, AppStateX uses both its InheritedWidget and its buildIn() function but InheritedWidget can be called separately allowing for only dependencies rebuilds
- Updated test scripts
4.1.0 #
July 31, 2023
- For the AppStateX, included the option to use the built-in InheritedWidget or not AppStateX({StateXController? controller, List
4.0.0+2 #
July 30, 2023
- StateX now has a built-in InheritedWidget
- named parameters now in the its constructor: StateX({StateXController? controller, bool? useInherited}) {
- Defaults to not using the built-in InheritedWidget be a subclass uses it: abstract class StateIn
- @protected appropriate methods
3.5.0+1 #
June 12, 2023
- New System event: WidgetsBindingObserver.didRequestAppExit()
3.4.0 #
May 27, 2023
- Rename StateSetter to SetStateMixin. Conflicted with latest Flutter
3.3.0+1 #
May 19, 2023
- Record any errors in initAsync()
- Adjusted code for Dart's future multi-window support
3.2.2+3 #
May 14, 2023
- StateX's FutureBuilder will only run once. _ranAsync changed the widget tree and so replaced with _future = runAsync();
3.2.1 #
May 08, 2023
- StateX's FutureBuilder should only run once. _ranAsync ? buildF(context) : FutureBuilder
3.2.0+1 #
May 07, 2023
- Removed the StateListeners mixin
3.1.0 #
May 07, 2023
- Introduced runAsync() in FutureBuilderStateMixin to allow initAsync() to run repeatedly.
3.0.0 #
May 01, 2023
- AppStateX can take in multiple instances of the same Controller class
- AppStateX has controllerById() to retrieve such instances.
- StateX can only take in single instances of a Controller class.
- StateX has controllerByType() to retrieve by class type.
- AppStateX controllers are available to all StateX objects in the app.
- _initAsync() in FutureBuilderStateMixin was incorrect!
2.8.0+1 #
March 26, 2023
- mixin StateListener implements RouteAware
- void didChangeLocales(List
- Include tests for the class RouteAware
2.7.1 #
March 15, 2023
- didChangeAccessibilityFeatures corrected to include _setStateAllowed
- Add further testing of the source code
2.7.0+3 #
March 15, 2023
- Removed bool get inFlutterTester so to be Web compatible
- Introduce void didChangeLocales(List
- Continued to increase the testing coverage over the source code
2.6.0 #
March 11, 2023
- bool get isEndState now used to determine if the 'latest' State object.
- Only the 'latest' State object is rebuilt with setState() after a system event.
2.5.4+1 #
March 09, 2023
- didChangeLocale(Locale? locales) to didChangeLocales(List
- Introduced system event indicator: bool get hadSystemEvent
- _rebuildRequested removed
- Adjusting further testing
2.5.3+4 #
March 08, 2023
- Bugfix. setState() no longer called in System events.
- Kept updateNewStateX() as it may be useful in special circumstances.
- Added further testing
2.5.2 #
March 06, 2023
- System events from WidgetsBinding.instance.addObserver(this); destroys current State object!
- Introduced updateNewStateX() to compensate for destroyed current State object.
- Corrected FutureBuilderStateMixin with _initAsync()
- i.e. Run the StateX object's initAsync() until it returns true
2.5.1+7 #
March 04, 2023
- StateX.notifyClients() was corrected.
- Replace buildChild() function with buildIn() function
- Updated example app in README.md
- testEventHandling(tester); in testing
- Added further testing
2.5.0+2 #
February 27, 2023
- RecordExceptionMixin stores the last error
- onAsyncError() no longer returns boolean
- Removed getter, Map<String, StateXController> get map
- bool forEach(void Function(StateXController con) func, {bool? reversed}) {
- bool forEachState(void Function(StateX state) func, {bool? reversed}) {
- startState and endState introduced to the StateX class
- WidgetsBinding.instance in activate() & deactivate()
- Incrementally adding tests for a higher percentage in Codecov
2.4.0 #
February 21, 2023
- Replace buildWidget() function with buildF() function
2.3.0 #
February 17, 2023
- onError(FlutterErrorDetails details) removed from the StateX class It was been proven ineffective and instead degraded performance.
- Corrected the 'Hello!' Example App
2.2.0+1 #
February 15, 2023
- Updated example app
- Deprecated refreshLastState() for rebuildLastState()
2.1.1 #
February 04, 2023
- Corrected getter rootState => RootState._rootStateX;
- refreshLastState() function now in AppStateX
2.1.0 #
January 23, 2023
- class _AppInheritedElement allows for better debugging
2.0.0 #
January 18, 2023
- BREAKING CHANGE Renamed remove() to bool removeByKey(String keyId) {
- included void didUpdateWidget(Page1 oldWidget) { in example app
- New function: String remove(StateXController? controller) {
1.1.0+01 #
September 16, 2022
- buildInherited() and refresh() are deprecated.
- Corrected the widget_test.dart. notifyClients() to setState()
1.0.0 #
September 10, 2022
- Production release
0.8.0+02 #
August 18, 2022
- Removed inappropriate class Swx
- StateSetter from class to mixin
- Updated and corrected README.md
0.7.0 #
August 16, 2022
- New example app: counter_app.dart
- New: class Swx extends StatefulWidget {
0.6.0 #
July 24, 2022
- Removed getter inheritedStatefulWidget
- Call initInheritedState() in buildWidget()
- Merged mixin InheritedStateMixin with InheritedStateX
0.5.0 #
July 22, 2022
- Renamed text from 'mvc_pattern.dart' to 'state_extended.dart'
- Removed void refresh() => setState(() {});
- Enhanced example apps with demonstration code.
0.4.0+02 #
July 15, 2022
- Removed the refresh() function
- Removed the class, StateXModel
- call _states.clear() in AppStateX
- Updated README.md
- Updated test scripts
0.3.0 #
July 11, 2022
- Changed keyId to identifier in mixin StateListener
0.2.0 #
July 10, 2022
- Removed abstract class AppStatefulWidget
- abstract class AppStateX
- if (!notify) { /// if the 'object' value has changed. notify = dataObject != oldWidget.dataObject; }
0.1.0 #
July 07, 2022
- Initial commit