state_extended changelog | Flutter package

5.9.0 #

December 14 ,2024

in part13_statex_controller.dart, call all listeners in both notifyClients(); and setState(); using notifyListeners();

5.8.0 #

November 20, 2024

Allow the setState() function call in a number of event handlers // _setStateAllowed = false;

5.7.0 #

November 16, 2024

Make ChangeNotifier private in mixin, ImplNotifyListenersChangeNotifierMixin

5.6.1 #

November 15,2024

Removed mixin, ChangeNotifier, from class StateXController to be accessed indirectly using a new mixin, ImplNotifyListenersChangeNotifierMixin, that contains it as a property. This is because ChangeNotifier has no, super.dispose(), in its dispose() function.

5.6.0+1 #

November 14, 2024

Introduce setBuilder() in every Controller. Will rebuild with every setState() call.
Replacing stateSet(WidgetBuilder? builder) with the name, setBuilder in class, StateX and AppStateX
class StateXController now includes mixin, ChangeNotifier and ListenableWidgetBuilderMixin
Updated example app

5.5.0 #

October 14, 2024

AppStateX class now has the notifyClientsInBuild parameter. Defaults to true. This then notifies any dependencies when calling for a rebuild.
The runInitAsync() function in every StateX object now allows their initAsync() functions to be conditionally called with every rebuild.

5.4.0 #

October 07, 2024

Built-in InheritedWidget is now called with AppState's setState() function

5.3.0 #

October 06, 2024

getter, lastErrorMessage, in AppState class in part08_app_statex.dart

5.2.4 #

October 05, 2024

Class, AppState, has lastFlutterError() to record and return the 'last' Flutter error.

5.2.3 #

October 04, 2024

BUGFIX Removed 'default' Error Handler mistakenly left in Production.
BUGFIX Removed 'default' Error Widget Builder mistakenly left in Production.
User Error Handler, onError(), in part08_app_statex.dart.
If onError() is not overridden, Flutter's own Error Handler is called.
New getter, stateErrorHandled, can be set true by user.
Function, handledStateError(), reads getter value and resets to false.

5.2.2 #

September 26, 2024

Replace print() with debugPrint() functions
if (mounted) { // Special case: Test if already disposed super.dispose();

5.2.1+1 #

September 25, 2024

Introduce getters, deactivated and disposed in part01_statex.dart if (_deactivated) and if (_disposed || !_deactivated) in part01_statex.dart
Provide test_run_mixins.dart with more tests.

5.2.0+1 #

September 23, 2024

Parameter, 'showBinding', renamed 'printEvents'
catchAsyncError() with try..catch in FutureBuilderStateMixin
con.onAsyncError() with try..catch in part18_async_ops_mixin.dart
appState.builder() with try..catch in part10_builder_statefulwidget.dart
Call a group of tests: group('Test state_extended', testStateExtended);

5.1.0 #

September 20, 2024

catchAsyncError() for mixin FutureBuilderStateMixin

5.0.0+3 #

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
Removed InheritedWidgetStateMixin testing in RunFutureBuilderStateMixin Widget

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

state_extended 5.9.0 state_extended: ^5.9.0 copied to clipboard

Metadata