watch_it

Bug Fixes

• Fixed allReady() returning stale true value when new async singletons are registered
  • Now correctly returns false and shows loading state until new singletons complete

Improvements

• allReady() now properly detects when new async singletons are registered in pushed scopes
  • Previously, allReady() would not rebuild the UI when pushNewScope() registered new async singletons
  • Now works correctly with get_it 9.2.0's cached allReady() future
• Requires get_it ^9.2.0

Maintenance

• Updated example project

Improvements

• Renamed for clarity: callAfterFirstBuild() → callOnceAfterThisBuild(). The new name better reflects the actual behavior: it executes once after the first build where the function is called, not necessarily after the widget's first build. This makes it clear that it can be safely used inside conditionals. Since this function was only introduced in version 2.0.0, migration should be straightforward - just update the function name in your code.
• Enhanced documentation for callOnceAfterThisBuild() with better explanation of behavior and added example showing usage in conditionals for navigation when async dependencies are ready.

Maintenance

• Updated example to use command_it 9.0.2 API (execute → run, isExecuting → isRunning)

Improvements

• Better Error Messages: Watch ordering violations now show a helpful error message instead of cryptic type errors. When conditional watch calls are placed incorrectly, you'll see clear guidance on how to fix it with BAD/GOOD examples.
• Enhanced Documentation: Added "Watch Ordering and Conditional Watches" section to README with visual examples explaining why conditional watches must be at the end of build methods.
• Improved Test Coverage: Test coverage increased to 93.3%.

Maintenance

• Updated get_it dependency to ^9.0.0
• Added GitHub Actions workflow for CI/CD with automated testing and code coverage
• Improved README header with logo and better formatting to match flutter_it ecosystem style
• Added package logo to pub.dev screenshots

Breaking Changes

• BREAKING: Replaced dependency functional_listener ^4.0.0 with listen_it ^5.1.0. This is a breaking change as functional_listener has been renamed and restructured into listen_it. If you use functional_listener operators in your code, update your imports from package:functional_listener/functional_listener.dart to package:listen_it/listen_it.dart.
• BREAKING: watchValue() and registerHandler() now default to allowObservableChange: false for better performance and memory leak prevention. This means the selector function is only called once on first build. If you need to dynamically switch observables (e.g., condition ? obsA : obsB), set allowObservableChange: true. This prevents common memory leaks from inline chain creation like watchValue((m) => m.source.map(...)).

New Features

• Added callAfterFirstBuild() function that executes a callback once after the first frame has been rendered. This is useful for operations that require the widget tree to be fully built and laid out, such as showing dialogs, accessing widget dimensions, scrolling to positions, or starting animations that depend on final widget sizes. This replaces the common pattern of using WidgetsBinding.instance.addPostFrameCallback in initState().
• Added callAfterEveryBuild() function that executes a callback after every frame has been rendered. This is useful for operations that need to run after each rebuild, such as updating scroll positions, repositioning overlays, or performing measurements. The callback includes a cancel() function to stop future invocations when needed.

Performance Improvements

• watchValue() and registerHandler() now have zero overhead on rebuilds with default settings - selectors are only called once instead of on every build
• Added helpful StateError messages when observables change unexpectedly with allowObservableChange: false, guiding users to the correct fix

Bug Fixes

• Fixed createOnceAsync test isolation issue by properly resetting testCompleter in setUp
• Internal refactoring: Renamed parameters for better clarity (target → parentOrListenable, etc.)