pd_cooldown 0.3.1

A professional Flutter debounce and throttle plugin providing complete solutions with built-in UI components for preventing rapid repeated actions.

Changelog

This document records all important changes to the PD Cooldown project.

Format based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.3.1

Release date: 2026-07-13

📝 Documentation

• English translation: Translated README.md and CHANGELOG.md to English
• Changelog formatting: Reorganized release dates to be on separate lines from version headers
• Version update: Updated version references in documentation files

0.3.0

Release date: 2026-06-18

✨ New Features

• Complete documentation comments: Added detailed documentation comments for all classes, enums, functions, variables, etc.
• API documentation improvement: All public API elements include dartdoc comments, achieving 100% coverage.

🔧 Improvements

• Code quality: Unified code style through dart format, fixed formatting issues
• SDK support: Extended SDK support to >=2.19.6 <4.0.0, supports Dart 3.x
• pubspec optimization: Optimized description field to comply with pub.dev publishing standards
• Static analysis: Passed flutter analyze static code analysis with no warnings or errors

🧪 Testing

• Unit tests: All test cases passed 100%
• pana score: Pre-checked via pana tool, core scoring items met

0.2.1

Release date: 2025-08-26

🔧 Improvements

• Code quality: Fixed code formatting issues, unified code style through dart format
• Test improvement: Updated unit tests for the example app to ensure test cases match actual UI
• Quality score: Achieved 120/130 score through pana tool, meeting pub.dev publishing standards

🧪 Testing

• Unit tests: Fixed and improved widget tests for the example app
• Static analysis: Passed flutter analyze static code analysis with no warnings or errors

0.2.0

✨ New Features

• Example app optimization: Improved the user interface and interaction experience of the example app
• App icon: Added professional launch icons for the example app, supporting all platforms
• App name: Updated the example app name to "Debounce Throttle Demo" for better user experience

🔧 Improvements

• UI component enhancement: Optimized visual effects and user feedback for debounce and throttle buttons
• Example code: Improved comments and explanations in example code for better readability
• Multi-platform support: Ensured consistent experience across Android, iOS, Web and other platforms

📱 Platform Support

• Android: Full support with custom launch icons
• iOS: Full support with custom launch icons
• Web: Full support with PWA configuration
• Desktop: Supports Windows, macOS, Linux desktop platforms

0.1.0

🚀 Major Changes

• Pure Dart package conversion: Converted the plugin to a pure Dart package, removed all platform-specific code and dependencies
• Architecture simplification: Removed platform interface layer, focused on core debounce and throttle functionality
• Dependency optimization: Removed flutter_web_plugins and plugin_platform_interface dependencies

🗑️ Removed

• Platform folders: Deleted android/, ios/, linux/, macos/, windows/ platform-related folders
• Platform interfaces: Removed pd_cooldown_platform_interface.dart, pd_cooldown_method_channel.dart, pd_cooldown_web.dart
• Plugin configuration: Removed plugin configuration block from pubspec.yaml
• Platform methods: Removed getPlatformVersion() method from PdCooldown class

✨ Advantages

• Lighter: Significantly reduced package size with no platform-specific code
• Simpler: Pure Dart implementation, easy to maintain and debug
• More versatile: Runs on all Flutter-supported platforms without platform-specific configuration

0.0.3

🐛 Fixed

• Debounce button logic: Fixed PDDebounceButton debounce logic error, continuous clicks now correctly reset the timer instead of being ignored
• Extension method removal: Removed cooldown_extensions.dart extension methods to simplify development complexity
• Example app optimization: Updated example app to use core EnhancedPDCooldown class for more stable implementation

🔧 Improvements

• Code simplification: Removed extension method dependencies, reduced function instance caching issues
• Debug logging: Added more detailed debug log output for debounce buttons
• Performance optimization: Optimized internal implementation mechanism for debounce and throttle

0.0.2

🐛 Fixed

• Android build issue: Fixed Android Gradle Plugin (AGP) compatibility issue, added required namespace configuration
• Integration error: Resolved "Namespace not specified" build error when integrating with other projects

0.0.1

🎉 Initial Release

✨ New Features

• Core debounce throttle functionality: Provides PDCooldown class, supports debounce throttle control for asynchronous operations
• UI components: Built-in PDThrottleButton and PDDebounceButton components
• Configurable logging: Supports custom CooldownLogger and error handling
• Multi-platform support: Supports Android, iOS, Web, Windows, macOS, Linux
• Thread safety: Uses synchronized package to ensure concurrency safety

🔧 Technical Features

• Modular architecture design with clear and maintainable code
• Complete Dart type definitions
• Supports custom cooldown duration and debounce delay
• Built-in default configuration for out-of-the-box use
• Comprehensive error handling mechanism

📚 Documentation and Examples

• Complete Chinese README documentation
• Feature-rich example application
• Detailed API documentation and usage guide
• MIT open source license

🧪 Test Coverage

• Basic unit tests
• Platform interface tests
• Example app integration tests