Refactoring & Formatting: #

• Refactored and formatted code for improved readability and consistency.

Fixes & Enhancements: #

• AppImage: Enhanced the error icon in _defaultErrorWidget to scale proportionally with the image container's height.

New Features: #

• CustomRangeSlider: Introduced a highly customizable dual-handle range slider widget with:

  • Custom theming for track, thumb, and overlay colors
  • Optional haptic feedback and customizable accessibility labels
  • Discrete or continuous value selection with validation and clamping
  • Animated thumb scaling on interaction with Material 3 inspired design
  • Elevation shadow and border effects with rounded track shape

• ValidationKey: Implemented new validation management system with:

  • ValueNotifier<String> wrapper for managing validation field keys
  • Debug labeling for easier troubleshooting
  • Comprehensive lifecycle management with listener support
  • Integration with ValidationController for enhanced field management

New Utility Types: #

• Either<L, R>: Added functional programming support with:

  • Left/Right value representation for failure/success patterns
  • Comprehensive transformation methods (map, bimap, flatMap, fold)
  • Error handling utilities (tryCatch, tryCatchAsync)
  • Combining operations (zip, zipWith) and recovery mechanisms
  • Future integration with async operation extensions
  • EitherUtils for sequence, traverse, and firstRight operations

• Option: Introduced optional value handling with:

  • Some/None pattern implementation
  • Core operations (fold, map, flatMap, getOrElse)
  • Conversion utilities to Either types

• Unit: Added unit type for representing absence of value in generic contexts

Enhancements: #

• CustomTextField:

  • Reordered initialization methods for improved clarity and reliability
  • Added validationKey property for ValidationKey association
  • Updated text style to use bodyLarge instead of displayMedium
  • Enhanced validation initialization with non-empty text handling
  • Adjusted minHeight constraint for multiline support

• ValidationController:

  • Added updateFieldValueAt method for index-based field updates
  • Implemented fieldKeys getter for retrieving all registered field keys
  • Enhanced documentation with comprehensive method descriptions

• ImageBackground:

  • Made child parameter optional for increased flexibility
  • Updated rendering logic to conditionally display child content

New Extensions: #

• List Extensions:
  • Added itemMargin extension for calculating list item margins by position
  • Implemented itemMargins extension returning named record with left/right margins

Documentation: #

• Enhanced code documentation across all new components
• Added comprehensive usage examples for new components
• Improved API documentation for validation system

Dependencies: #

• Upgraded connectivity_plus to ^6.1.5.
• Upgraded logger to ^2.6.1.

New Features: #

• ValidationController: Introduced high-performance form validation solution with:
  • Field registration/validation management
  • Efficient change detection
  • State/error message access
  • Batch validation capabilities

Improvements: #

• CustomTextField:

  • Integrated ValidationController support
  • Added focusNode and textInputAction properties
  • Optimized lifecycle management and state updates
  • Refactored internal logic for clarity and efficiency

• Image Widgets:

  • Added placeholderColor property to AppCircleImage and AppImage
  • Implemented default dimensions (defaultWidth/defaultHeight) for ImageBackground
  • Enhanced circular clipping logic
  • Improved default placeholder styling using theme colors

Documentation: #

• Updated README with usage examples and feature descriptions

Dependencies: #

• Upgraded logger dependency to ^2.6.0
• Removed equatable dependency
• Marked shared_preferences and logger for future removal

Features: #

• CustomTextField: Introduced a powerful and highly customizable CustomTextField widget with built-in validation, styling options, accessibility enhancements, and dropdown support.
• Connectivity Bloc Demo: Added a comprehensive demo showcasing real-time internet connectivity monitoring using the Bloc pattern, complete with events, states, and a repository.
• ImageBackground Widget: Launched a new ImageBackground widget to easily display images with overlay content.

New Animation Widgets: #

• AnimatedFadeScale: A widget for combining fade and scale animations seamlessly.
• FadeSlideTransition: A transition widget for creating smooth fade and slide effects.
• UI Assets: Added password visibility toggle icons directly to the package assets.

Improvements: #

• Theming: Added the AppColors class, providing a set of predefined color constants for consistent UI theming.
• String Extensions: Included a capitalize extension on the String class for convenient text formatting.

Features: #

• Enhanced Image Handling: Added comprehensive file support (File objects) for both AppImage and AppCircleImage widgets.
• Border Radius Support: Introduced borderRadius parameter for AppImage to enable custom clipping without additional widgets.
• Background Customization: Added backgroundColor parameter to both image widgets for better visual integration.
• Performance Optimizations: Implemented device pixel ratio-aware image caching for improved memory usage.
• Robust Source Detection: Enhanced network URL validation with multiple detection methods for more reliable image loading.

Improvements: #

• Unified Image API: Consolidated handling of network, asset, and file sources through a single consistent interface.
• Error Handling: Improved logging and fallback mechanisms for better debugging and user experience.
• Customization: Added fit parameter to AppCircleImage for more control over image scaling.
• Documentation: Enhanced code documentation and usage examples.

Deprecated: #

• The assetFallback parameter is now recommended to be replaced with fallbackImage for naming consistency (backward compatible).

Other Changes: #

• Fixed edge cases in network URL detection and fallback image handling.
• Improved default placeholder and error widgets for better visual consistency.

Features: #

• PIN Screen: Introduced a secure and customizable PIN entry widget for robust user authentication.
• Internet Connection Checker: Integrated utilities for real-time internet connectivity monitoring, enabling developers to build apps that gracefully handle network availability.
• Versatile Image Handling: Added customizable image widget features, including circular and rectangular shapes with placeholders, error handling, and fallbacks, simplifying image management in Flutter apps.

Deprecated: #

• Streamlined API: Deprecated SharedPreferencesService in favor of leveraging the latest shared_preferences package API for a more efficient approach to managing shared preferences.

Other Changes: #

• Bug fixes and general improvements across the library.
• Enhanced usability and code readability by streamlining utility functions and extensions.

• Minor fixes and upgrades to improve performance.

• Improved documentation for the SharedPreferencesService class.
• Added example usage in README.md.
• Bug fixes and performance improvements.

• Introduced SharedPreferencesService class for managing SharedPreferences in Flutter applications.
• Implemented methods for storing and retrieving various data types in SharedPreferences.
• Added methods to initialize, clear, and remove data from SharedPreferences.

Changes: #

• Formatted Dart code.
• Further updated documentation for improved clarity.

Added: #

• Added sample tests to ensure functionality.

Changes: #

• Updated documentation for better guidance.

• Initial release.