Added #

• Added explicit platform support tags (Android, iOS, Linux, macOS, Web, Windows)

---

This release adds powerful new features while maintaining full backward compatibility with v2.0.

New Features #

Gradient Background Support

• Added backgroundGradient property to EmptyViewStyle
• Added backgroundColor property for solid backgrounds
• Added backgroundBorderRadius for rounded background corners
• Added backgroundShadow for drop shadows
• Added EmptyViewStyle.gradient() factory constructor
• Added hasBackground getter for checking background state

Builder Pattern

• Added EmptyView.builder() factory constructor for custom layouts
• Builder receives BuildContext and resolved EmptyViewStyle
• Enables complex custom designs while keeping styling system

Animation Completion Callback

• Added onAnimationComplete callback
• Fires when entrance animation finishes
• Useful for triggering post-animation actions

Custom Error Widget

• Added errorWidget property
• Replaces default error icon with custom widget
• Supports complex error state designs

4 New Presets

• permissionDenied - Permission required state (orange lock icon)
• sessionExpired - Session expired state (red timer icon)
• emptyTimeline - Empty activity feed state
• noPaymentMethods - No payment methods state

Performance Improvements

• Added RepaintBoundary wrapper for animations
• Reduces unnecessary repaints during animations

Code Quality

• Added @immutable annotation to EmptyViewStyle
• Extracted all magic numbers to named constants:
  • EmptyView.defaultIconSize (80.0)
  • EmptyView.defaultErrorIconSize (60.0)
  • EmptyView.defaultAnimationDuration (600ms)
  • EmptyView.defaultRetryDelay (2 seconds)
  • EmptyView.defaultMaxRetries (3)
  • EmptyView.defaultSlideOffset (0.3)
  • EmptyView.defaultScaleFactor (0.8)
  • EmptyView.defaultBounceScaleFactor (0.5)
  • EmptyView.iconBackgroundMultiplier (1.5)
  • EmptyView.loadingIndicatorSize (24.0)
  • EmptyView.defaultButtonFontSize (16.0)
  • EmptyViewStyle.defaultImageWidthFactor (0.5)
  • EmptyViewStyle.defaultImageHeightFactor (0.3)
  • EmptyViewStyle.defaultHorizontalPadding (24.0)
  • EmptyViewStyle.defaultButtonHeight (50.0)
  • And more...

Documentation

• Added comprehensive dartdoc comments
• Updated README with v2.1 features
• Added migration guide

Breaking Changes #

None - fully backward compatible with v2.0.x

---

This is a major release with many new features while maintaining backward compatibility with v1.x.

New Features #

Prebuilt Presets

• Added EmptyViewPresets class with 12 ready-to-use empty state configurations:
  • noInternet - No internet connection state
  • emptyCart - Empty shopping cart state
  • noSearchResults - No search results state (with searchTerm support)
  • noNotifications - No notifications state
  • noMessages - No messages state
  • noFavorites - No favorites/bookmarks state
  • error - Error state with custom message
  • noData - No data available state
  • locationRequired - Location permission required state
  • maintenance - Under maintenance state
  • noOrders - No orders state
  • noFiles - No files state

Animations

• Added entrance animations with enableAnimation parameter
• Added EmptyViewAnimation enum with animation types:
  • none - No animation
  • fadeIn - Fade in effect
  • slideUp - Slide up with fade
  • slideDown - Slide down with fade
  • scale - Scale up with fade
  • bounce - Bounce effect with elastic curve
• Added animationDuration parameter for custom timing
• Added animationCurve parameter for custom animation curves

Lottie Animation Support

• Added lottiePath parameter for Lottie animations
• Supports both asset files and network URLs
• Added lottieRepeat and lottieReverse parameters

Shimmer Skeleton Loading

• Added showShimmer parameter for shimmer effect
• Added EmptyView.skeleton() factory constructor
• Added shimmerBaseColor and shimmerHighlightColor parameters
• Automatic dark mode detection for shimmer colors

Icon Support

• Added icon parameter for Material icons
• Added iconColor and iconSize parameters
• Added showIconBackground for circular background container
• Added iconBackgroundColor parameter

Secondary Action Button

• Added secondaryButtonText parameter
• Added onSecondaryButtonTap callback
• Added isSecondaryLoading parameter

Retry Logic

• Added onRetry parameter for automatic retry handling
• Added maxRetries parameter (default: 3)
• Added retryDelay parameter (default: 2 seconds)

Platform Adaptive Styling

• Added adaptive parameter for platform-specific styling
• Automatic Cupertino buttons on iOS
• Material buttons on Android

Accessibility

• Added semanticLabel parameter for custom screen reader labels
• Automatic semantic labels from title and description

Dark Mode

• Automatic dark mode detection
• Theme-aware default colors
• Added EmptyViewStyle.dark() factory

EmptyViewStyle Enhancements #

New Properties

• secondaryButtonColor - Secondary button color
• secondaryButtonTextColor - Secondary button text color
• darkModeBackgroundColor - Dark mode background
• darkModeTitleColor - Dark mode title color
• darkModeDescriptionColor - Dark mode description color
• descriptionBottomSpacing - Spacing below description
• buttonSpacing - Spacing between buttons
• buttonBorderColor - Button border color
• buttonBorderWidth - Button border width
• buttonElevation - Button elevation
• iconSizeFactor - Icon size multiplier
• iconBackgroundColor - Icon container background
• iconContainerPadding - Icon container padding

New Factory Constructors

• EmptyViewStyle.dark() - Dark mode optimized style
• EmptyViewStyle.minimal() - Minimal spacing style
• EmptyViewStyle.compact() - Compact style for small spaces
• EmptyViewStyle.spacious() - Spacious style with more padding
• EmptyViewStyle.rounded() - Pill-shaped button style

Other Improvements

• Added == operator and hashCode for equality comparison

Dependencies #

• Added lottie: ^3.1.0 for Lottie animation support
• Added shimmer: ^3.0.0 for shimmer skeleton loading

Breaking Changes #

None - fully backward compatible with v1.x

---

• Initial release
• Smart image source detection (network, file, SVG, asset)
• Customizable styling via EmptyViewStyle
• Action button with loading state support
• Custom widget support for image and button
• Responsive design adapts to screen sizes
• Full documentation and example app