state_lifecycle_observer 0.1.1

state_lifecycle_observer: ^0.1.1 copied to clipboard

• Critical Fix: Fixed ListenableObserver listener leak when using key parameter - listener is now properly re-added in onInitState() after key changes trigger target rebuild.
• Fix: Fixed type safety issue in FutureObserver and StreamObserver - now uses AsyncSnapshot.nothing() when initialData is null instead of unsafe cast.
• Enhancement: Improved safeSetState() scheduler phase check - now only allows setState during idle phase for better safety.
• Enhancement: Added runtime assertions to AnimControllerObserver and TabControllerObserver to ensure State mixes in TickerProvider with helpful error messages.
• Feature: Added removeLifecycleObserver() method to LifecycleOwnerMixin for dynamic observer removal.
• Enhancement: Improved error message for Zone-based registration failures with detailed troubleshooting steps.

• Breaking: Move key change detection from onDidUpdateWidget to onBuild for better support of late-created observers.

• Implement Observer composability - observers can create nested observers within any lifecycle method (onInitState, onDidUpdateWidget, onBuild).

class ParentObserver extends LifecycleObserver<void> {
  ChildObserver? child;
  
  ParentObserver(super.state);
  
  @override
  void onInitState() {
    super.onInitState();
    // Create nested observers anywhere in lifecycle methods
    child = ChildObserver(state);
  }
}

• Add project logo and update README documentation.
• Add CI workflow with GitHub Actions and Codecov integration.
• Achieve 100% test coverage.

• Update documentation with addLifecycleCallback usage examples.
• Add language switch links between English and Chinese README.
• Simplify code examples to use late final for observer initialization.

• Replace assert with StateError for missing mixin, correct addLifecyccleCallback typo.

• Add addLifecyccleCallback

  void initState() {
    super.initState();
    addLifecycleCallback(
      onInitState: () {
        widget.log.onInitState++;
      },
      onDidUpdateWidget: () {
        widget.log.onDidUpdateWidget++;
      },
      onDispose: () {
        widget.log.onDispose++;
      },
      onBuild: (context) {
        widget.log.onBuild++;
      },
    );
  }

• Breaking Change: Renamed LifecycleObserverMixin to LifecycleOwnerMixin to better reflect its role.
• Breaking Change: LifecycleObserver initialization is now deferred. target is available only after onInitState is called (which happens automatically). Accessing it prematurely throws LateInitializationError.
• Enhancement: Added automatic synchronization for "late" observers. Observers added after initState are now immediately initialized to catch up with the lifecycle.
• Refactor: Introduced LifecycleState enum (created, initialized, disposed) to track component state.
• Fix: Removed StateWithObservers interface in favor of checking against LifecycleOwnerMixin directly.

• Enhancement: Introduced safeSetState in LifecycleObserver to handle state updates safely across different scheduler phases.
• Fix: FutureObserver and StreamObserver now use safeSetState to prevent errors when updates are triggered during build, layout, or paint phases.
• Docs: Reorganized README to clearly categorize built-in observers (Base, Widget, Anim) and added clarification on key usage.

• Breaking Change: Renamed onUpdate to onDidUpdateWidget to better align with Flutter's lifecycle naming.
• Breaking Change: Removed onInit. Initialization logic should be moved to the constructor or buildTarget.
• Enhancement: Added safety assertion to ensure state mixes in LifecycleObserverMixin.
• Docs: Updated README with key usage explanation and new API examples.

• Initial release.
• Added LifecycleObserver base class and LifecycleOwnerMixin.
• Included common observers:
  • AnimControllerObserver (supports full AnimationController params)
  • ScrollControllerObserver
  • TabControllerObserver
  • TextEditingControllerObserver
• Implemented automatic lifecycle management (onInit, onUpdate, onDispose).
• Seamless integration via super.build(context).