All notable changes to the Hyper Effects package are documented in this file.
- Loosen dependency constraints for equatable to
>=2.0.5 <3.0.0.
- New Effects
- Padding effect for dynamic padding adjustments.
- Global roll effect for universal rolling animations.
- Width & height factor support in align effect.
- Scroll Transition Enhancements
- Additional event variables for finer control.
- Improved transition state management.
- Pointer Transition Features
usePointerRouteroption for flexible pointer event handling.- Enhanced pointer position tracking.
- New AnimatedEffect Properties
resetValues- Controls value reset behavior.interruptable- Manages animation interruption.skipIf- Conditional animation execution.startState- Initial animation state control.transformHitsproperty for translate effect.rotateInandrotateOutmethods for rotate effect.
- Added New Examples
- group_animation.dart
- rolling_app_bar_animation.dart
- rolling_pictures_animation.dart
- scroll_phase_slide.dart
- scroll_phase_blur.dart
- success_card_animation.dart
- Breaking Changes
- Effect apply function's child parameter is now nullable.
- Text rolling API redesigned for consistency with other effects.
- New unified interface matching other animation effects.
- Previous text rolling methods have been deprecated.
startImmediatelyreplaced with more flexiblestartState.- Removed unnecessary PostFrame callbacks from pointer transition logic.
- Improvements
- Default blur effect state now starts un-blurred.
- Added
characterTapeBuilderstoSymbolTapeStrategyfor customization. - Fixed issues with scroll transitions to provide smoother and more consistent user experience.
- Resolved Dart analysis issues for better code quality
- New
startImmediatelyboolean in .animate() - Improved documentation for
AnimatedEffect
- Value clamping for:
OpacityEffect(0.0 - 1.0)ClipEffect(0.0 - 1.0)ColorFilterEffect(0.0 - 1.0)
- Prevents exceptions with out-of-range curves
- Animation controller state change exception handling
- New Effects
- Rolling Text effect for text animations
- Shake effect for vibration animations
- Align effect for alignment control
- Animation Control
oneShotfunction for immediate animationsanimateAfterfor sequential animationsresetAllfor animation state reset- Repeat parameter for cyclic animations
- Delay parameter for timed starts
playIffor conditional execution
- Breaking Changes
- Renamed:
toggle→triggerin .animate()AnimatedEffect→EffectWidgetEffectAnimationValue→EffectQueryPostFrameWidget→PostFrame
- Enhanced
EffectQuerywithlinearValueandcurvedValue
- Renamed:
- Improvements
- Updated effect extensions with
fromstate support - Added convenience methods (slideIn/Out, fadeIn/Out)
- Updated effect extensions with
- Documentation improvements
- Added example GIFs in README
- Initial release of Hyper Effects
- Core animation and effect system
- Basic effect implementations
- Documentation and examples