listen_it 5.1.0

listen_it: ^5.1.0 copied to clipboard

NEW FEATURE: Merged with listenable_collections

This release merges the listenable_collections package into listen_it, creating a unified package for reactive primitives in Flutter.

Breaking Changes #

• None! This is a backward-compatible feature addition
• All existing listen_it functionality remains unchanged

New Features #

• Reactive Collections: Added ListNotifier, MapNotifier, and SetNotifier from listenable_collections
  • Lists, Maps, and Sets that automatically notify listeners when their contents change
  • Support for different notification modes (normal, always, manual)
  • Transaction support for batching multiple operations
  • Full compatibility with ValueListenable and ValueListenableBuilder

Migration from listenable_collections #

If you were using listenable_collections, migration is simple:

1. Update pubspec.yaml: Replace listenable_collections with listen_it: ^5.1.0
2. Update imports: Change import 'package:listenable_collections/listenable_collections.dart'; to import 'package:listen_it/listen_it.dart';
3. All APIs remain identical - no code changes needed!

Exports #

• Main export (listen_it.dart): Includes both operators and collections
• Selective export (collections.dart): Collections only
• All existing exports remain unchanged

Dependencies #

• Added collection: ^1.17.2 dependency (required for collections)

• Although this version doesn't add any new functionality but is just the rebranding of the original functional_listener package I decided to keep the version numbers so it is is easy for anyone switching to the new package and to preserve the history.

• adding debounce as extenstion method on Listenable

• Following the findings of https://github.com/escamoteur/functional_listener/issues/13 we no longer destroy the listener chain when the last listener is removed. Because this might change the behavior of your app this is seen as a breaking change and therefore the change to 4.0.0. Please observe if this leads to increasing memory usage

• added optional error handler for CustomValueNotifier in case one of the listeners throws an Exception
• added listen() extension method for normal Listenable

• stupid bug fix

• added async() extension method

  /// ValueListenable are inherently synchronous. In most cases this is what you
  /// want. But if for example your ValueListenable gets updated inside a build
  /// method of a widget which would trigger a rebuild because your widgets is
  /// listening to the ValueListenable you get an exception that you called setState
  /// inside a build method.
  /// By using [async] you push the update of the ValueListenable to the next
  /// frame. This way you can update the ValueListenable inside a build method
  /// without getting an exception.
  ValueListenable<T> async();

• CustomValueNotifier got a new property asyncNotification which if set to true postpones the notifications of listeners to the end of the frame which can be helpful if you run into Exceptions about 'calling setState inside a build function' e.g. if you monitor the CustomValueNotifier with the get_it_mixin and you update it inside the build function. Default is false.

• added listenerCount to CustomValueNotfier

• merged several PRs with bugfixes
• adds the select() method see the readme
• adds more combineLates() variants up to 6 input Listenables

• Bugfix: If you resubscribed to one of the Listenables that are returned from the extension functions in this package and then resubscribed it did not rebuild the subcription to it's previous in chain.

• Added public notifyListeners to CustomValueNotfier

• Added CustomValueNotfier

• Fixes in documentation and tests

• Added mergeWith() function

• Added package description

• Added Example and some bug fixes

• Initial release