mobx

• Documentation comments for many of the public methods and classes
• Package updates

• Added toString override for MobXException
• Added an interface ObservableValue that is a common interface for all observables: Observable, Computed, ObservableFuture, ObservableStream. Thanks to @t-artikov
• Added chat link to Discord. It is now:

• Fixes the type resolution bug that prevented using types from packages like dart:ui
• Fixes the type resolution of other public Store classes referenced in the @store based generation

Thanks to @shyndman for the tremendous work on this release.

• Added a version constant that matches the pubspec.yaml

• Added new way to create Store classes using the @store annotation. This will exist as an alternative to the mixin based approach we already have.
• Includes a new option for reaction for using a custom EqualityComparator<T, T>. This is useful when you want to avoid expensive reactions by plugging in a custom comparison function for the previous and next values of the predicate.

• Fixed a bug where the ObservableFuture<T> would not show the correct status. This was happening because of the lazy evaluation strategy. We are now being eager in creating the status and monitoring the inner Future<T> immediately.
• Upgraded test_coverage

• Added two new Observer-widgets: StatelessObserverWidget and StatefulObserverWidget
• Improved the reporting of Flutter errors inside Observer widgets.
• Exposing the debugAddStackTraceInObserverName field
• Removing the deprecated authors field from pubspec.yaml

Thanks to Scott Hyndman and Remi Rousselet for the work done in this release!

• Removed the @experimental annotations for Observable{Future,Stream} and reaction.
• Removed the dependency on the meta package.
• Some formatting changes
• Reporting update or change only when the new value is different than the old value. This is mostly for observable collections like list, set, map.

• Wrapping all collection setters in conditional action wrappers. This removes the need to wrap collection mutating methods in explicit actions.

• Errors that occur internal to the setState() call are now reported via FlutterError.reportError so they don't go unnoticed by the user.
• Added a version constant that matches the pubspec.yaml

• API changes introduced to the enforceActions setting of ReactiveConfig. It is now called writePolicy and the enum EnforceActions has been renamed to ReactiveWritePolicy.
• Also introducing a readPolicy setting on ReactiveConfig. It is an enumeration with two values:
• Removing the "strict-mode" text in the exception message when the ReactiveWritePolicy is violated. This was a vestige from the mobx.js world.
• Exposing a boolean isWithinBatch on ReactiveContext, which tells if the current code is running inside a batch. This is used to conditionally apply an action-wrapper for mobx_codegen-generated setters.
• Introduced an action-wrapper called conditionallyRunInAction() that runs the given function in an action only when outside a batch.
• Increasing test coverage

enum ReactiveReadPolicy { always, never }

• README updates

• An internal change was made to support the new restrictions around non-covariant type variables in superinterfaces. This was causing compile errors in the Flutter beta/dev/master channels.

• A breaking change has been introduced to the use of the Store type. Previously it was meant to be used as an interface, which has now changed to a mixin. Instead of doing:

abstract class UserBase implements Store {}

You now do:

abstract class UserBase with Store {}

This allows us to add more convenience methods to the Store mixin without causing any breaking change in the future. With the current use of the interface, this was not possible and was limiting the purpose. Store was just a marker interface without any core functionality. With a mixin, it opens up some flexibility in adding more functionality later.

• All the docs and example code have been updated to the use of the Store mixin.