save_points_extensions_utils 1.2.0

Extensions and reusable widgets. Provides 100+ widget extensions, 40+ animated effects, 40+ pre-built UI components, data type extensions, form validators, spacing utilities, and more. Zero dependenci [...]

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.2.0 - 2026-02-01

Added

• 40+ Widget Animation Effects: Easy-to-use animation extensions for any widget

  • Fade Animations: fadeIn(), fadeOut(), fade() - Control opacity with smooth transitions
  • Scale Animations: scaleIn(), scaleOut(), animatedScale() - Scale widgets with various effects
  • Slide Animations: slideInFromLeft(), slideInFromRight(), slideInFromTop(), slideInFromBottom(), slide() - Directional slide-in effects
  • Rotation Animations: animatedRotate(), spinIn(), spin() - Rotation and continuous spinning
  • Bounce & Elastic: bounceIn(), bounce(), elasticIn() - Elastic bounce effects
  • Shake Animations: shake(), shakeHorizontal(), shakeVertical() - Error feedback effects
  • Pulse Animations: pulse(), heartbeat() - Pulsing and heartbeat effects
  • Flip Animations: flipHorizontal(), flipVertical(), flipIn() - Card flip effects
  • Shimmer: shimmer() - Loading placeholder effect with customizable direction
  • Zoom Animations: zoomIn(), zoomOut() - Zoom with fade effects
  • Special Effects: swing(), wobble(), blurIn(), float(), glow() - Unique animation effects
  • Fun Animations: jello(), rubberBand() - Playful animation effects
  • Hero Animation: hero() - Easy hero transition wrapper
  • Utility Animations: animatedSize(), crossFade(), animatedColor(), typing() - Utility animation wrappers

• Widget Animation Effects Demo Section: Interactive showcase in the demo app

  • Each animation includes restart/toggle functionality
  • Organized by animation category
  • Hero animation demo with navigation

Changed

• Renamed WidgetAnimationExtensions to AnimatedWidgetEffectsExtensions to avoid conflicts
• Renamed rotate() to animatedRotate() and scale() to animatedScale() to avoid conflicts with transform extensions
• Updated package description to highlight 40+ animated effects
• Enhanced exports in extensions.dart to include all animation-related extensions

Documentation

• Added comprehensive widget animation effects section in demo app
• All animation methods include inline documentation and examples
• Updated README with widget animation effects documentation

1.1.0 - 2026-02-01

Added

• 40+ Pre-built UI Components: Production-ready reusable widgets
  • AvatarWidget - Customizable avatar with fallback and status indicator
  • BadgeWidget - Notification and status badges
  • BreadcrumbWidget - Navigation breadcrumbs
  • CarouselWidget - Image/content carousel with indicators
  • ClipCard - Demonstration card for clip extensions
  • ColorCard - Color manipulation demonstration
  • CopyButton - Copy-to-clipboard button widget
  • CustomBottomSheet - Styled bottom sheet component
  • CustomButton - Customizable button with loading states
  • CustomCard - Enhanced card with various styles
  • CustomChip - Stylized chip/tag component
  • CustomDialog - Customizable dialog with actions
  • CustomListTile - Enhanced list tile with more options
  • CustomTextField - Styled text field with validation
  • DataCard - Card for displaying data with labels
  • DividerWidget - Customizable divider with text
  • DrawerWidget - Navigation drawer component
  • DropdownWidget - Custom dropdown selector
  • EmptyCard - Empty state card component
  • EmptyStateWidget - Full empty state with icon and message
  • ErrorCard - Error display card
  • ExpansionCard - Expandable card with content
  • FloatingActionButtonWidget - Custom FAB with extended options
  • GestureCard - Demonstration card for gesture extensions
  • HeroDetailPage - Hero animation detail page
  • IconButtonWidget - Custom icon button
  • InfoBanner - Information banner component
  • LoadingIndicator - Custom loading spinner
  • MenuWidget - Menu/popup menu component
  • NavigationBarWidget - Bottom navigation bar
  • NotificationCard - Notification display card
  • ProgressBar - Linear and circular progress indicators
  • RatingWidget - Star rating component
  • SearchBarWidget - Search input with filtering
  • SectionWrapper - Section wrapper for organized layouts
  • SegmentedControl - iOS-style segmented control
  • ShimmerLoading - Shimmer loading effect
  • SkeletonLoader - Skeleton screen loader
  • SnackbarWidget - Custom snackbar component
  • StepperWidget - Step-by-step progress indicator
  • TabsWidget - Custom tabs component
  • TagWidget - Tag/label component
  • TimelineWidget - Timeline component for events
  • ToggleCard - Toggle demonstration card
  • TooltipWidget - Custom tooltip component
  • TransformCard - Transform extensions demonstration card

Changed

• Updated package description to highlight 40+ pre-built components
• Enhanced component library with comprehensive widget collection

Documentation

• Added components section in library structure
• All components include inline documentation and examples

1.0.2+1 - 2025-12-16

Added

• Example directory with comprehensive demo app
• Example tab now visible on pub.dev package page
• Example demonstrates all major features: widget extensions, string/number/date extensions, validators, debounce/throttle

Documentation

• Added working example that showcases package capabilities
• Example includes interactive demonstrations of all extension types

1.0.1+1 - 2025-12-16

Added

• Live demo link in README (https://chipper-crisp-9bdfab.netlify.app/)
• Demo preview GIF in README
• Enhanced documentation with demo call-to-action buttons

Changed

• Updated README installation instructions to use pub.dev version
• Improved README navigation with demo link
• Updated CHANGELOG with proper release date

Documentation

• Added prominent demo links in multiple README sections
• Updated installation examples to reflect published package

1.0.0+1 - 2025-12-01

Added

• 100+ Widget Extensions: Comprehensive widget chaining and modification methods

  • Core extensions (padding, margin, center, container, opacity, visibility)
  • Gesture extensions (onTap, onLongPress, onDoubleTap, inkWell)
  • Clip extensions (clipRRect, clipOval, clipRect)
  • Transform extensions (rotate, scale, translate)
  • Layout extensions (align, positioned, aspectRatio)
  • Material extensions (material, card)
  • Animation extensions (hero, animatedSwitcher)
  • Scroll extensions (scrollable, singleChildScrollView)
  • Sizing extensions (sizedBox, constrained, expanded)
  • Semantics extensions (tooltip, semanticsLabel)
  • Text extensions (textStyle, textAlign)
  • Icon extensions (iconSize, iconColor)
  • Image extensions (imageFit, imageAlignment)
  • List extensions (listView, gridView)
  • Stack extensions (positioned, align)
  • Column/Row extensions (withSpacing, withMainAxisAlignment)

• Data Type Extensions: Enhanced functionality for built-in types

  • String extensions (capitalize, validation, formatting)
  • List extensions (chunk, firstOrNull, lastOrNull, safe operations)
  • Map extensions (getOrDefault, filter, mapKeys, mapValues)
  • Number extensions (formatCurrency, isBetween, clamp)
  • DateTime extensions (isToday, isYesterday, format, timeAgo)
  • Color extensions (darken, lighten, hexString, isDark)
  • Context extensions (theme access, screen dimensions, navigation)
  • Animation extensions (status checks, value mapping, controller utilities)

• Form Validation: Comprehensive validators

  • Basic validators (required, email, phone, URL, numeric, integer)
  • Length validators (minLength, maxLength, rangeLength)
  • Pattern validators (custom regex)
  • Comparison validators (match, minValue, maxValue, range)
  • Combined validators (combine multiple validators)

• Utility Classes:

  • Spacing utilities (constants and helpers)
  • App constants (animation durations, delays, retries, pagination)
  • Formatters (number, date, string)
  • Helpers (retry, debounce, throttle)
  • Color utilities (manipulation, conversion)
  • URL utilities (parsing, validation)

• Configuration Models: Immutable data classes with copyWith

  • RetryConfig, PaginationConfig, FormatterConfig
  • ValidatorConfig, UrlConfig, ColorConfig
  • AnimationConfig, CacheConfig

• Documentation:

  • Comprehensive README with examples
  • Best practices guide
  • Conflict prevention guide
  • Library declaration guide
  • Publishing guide

Features

• Zero dependencies (pure Flutter/Dart)
• Null-safe extensions
• Type-safe utilities
• Fully documented with examples
• Production-ready code
• Modular architecture
• Conflict prevention strategies

Documentation

• Complete API documentation
• Usage examples for all extensions
• Best practices guide
• Conflict prevention strategies
• Publishing guide