zeba_academy_debouncer 1.0.0
zeba_academy_debouncer: ^1.0.0 copied to clipboard
A lightweight Flutter package for debounce, throttle, timer execution, search optimization and cancelable callbacks.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project follows Semantic Versioning (SemVer).
1.0.0 - 2026-07-03 #
🎉 Initial Release #
The first stable release of zeba_academy_debouncer, a lightweight and dependency-free Flutter package for debouncing, throttling, timer-based execution control, and search optimization.
✨ Added #
- Debouncer utility for delaying callback execution
- Async debounce support with
runAsync() - Throttle utility for rate-limiting repeated actions
- ExecutionController for scheduling delayed callbacks
- Immediate execution support with
flush() - Cancelable scheduled callbacks
- SearchDebouncer helper for optimizing search input
- Timer state monitoring
- Resource cleanup with
dispose() - Null Safety support
- Flutter and pure Dart compatibility
- Zero external dependencies
- Comprehensive API documentation
- Example application
- Unit tests for all core components
- GPL-3.0 License
- Production-ready README
- Cross-platform support
- ✅ Android
- ✅ iOS
- ✅ Web
- ✅ Windows
- ✅ macOS
- ✅ Linux
🚀 Performance #
- Lightweight implementation
- Minimal memory footprint
- Efficient timer management
- Optimized callback scheduling
- Fast execution with no unnecessary allocations
🔒 Stability #
- Stable public API
- Safe timer cancellation
- Proper resource disposal
- Predictable debounce behavior
- Reliable throttle execution
Upcoming #
1.1.0 (Planned) #
Added #
- Leading-edge debounce
- Trailing-edge debounce options
- Maximum wait duration
- Resettable debounce timers
- Pause and resume support
- Generic typed callbacks
- Stream-based debounce utilities
- Stream-based throttle utilities
- Callback identifiers for grouped execution
- Improved diagnostics and debugging support
Improvements #
- Performance optimizations
- Additional unit tests
- Expanded documentation
- More usage examples
2.0.0 (Future Roadmap) #
Planned Features #
- Widget extensions
- TextEditingController extensions
- SearchDelegate integration
- Riverpod extensions
- BLoC extensions
- GetX extensions
- Provider helpers
- Automatic lifecycle management
- Global debounce manager
- Named debounce groups
- Named throttle groups
- Retry helpers
- Scheduler utilities
- Advanced execution policies
- Enhanced developer tooling
- Benchmark suite
- Additional examples and templates