ticker 0.3.1

ticker: ^0.3.1 copied to clipboard

MAJOR IMPROVEMENT: Added configurable animation starting positions

• New animationStartConfig parameter allows control over initial animation behavior
• TickerAnimationStartConfig.first() - Start from first character (e.g., '0' for numbers) - DEFAULT
• TickerAnimationStartConfig.current() - No initial animation, show value immediately
• TickerAnimationStartConfig.last() - Start from last character (e.g., '9' for numbers)
• TickerAnimationStartConfig.random() - Start from random character each time
• TickerAnimationStartConfig.specific(char) - Start from specific character
• Configuration only applies to initial animation, preserving fluidity for subsequent changes
• BACKWARD COMPATIBLE: Default behavior maintains existing production behavior

CRITICAL FIX: Completely redesigned character count change animations

• Problem solved: Eliminated jarring layout shifts when character count changes (e.g., 999 → 1000)
• Old behavior: 999 → 000 → 1000 (confusing intermediate state + sudden layout shift)
• New behavior: 999 → 0999 → 1000 (smooth transition with no layout shifts)
• Smart character addition strategy:
  • Numbers: Add leading characters at the beginning for natural counting effect
  • Text: Balanced character addition between start and end (e.g., DOG → ADOGA → TIGER)
• Graceful shrinking: Characters animate to empty before removal
• Respects animation start configuration for new characters
• Two-phase animation approach ensures final layout is established immediately

ENHANCED DEMOS: Added comprehensive demonstration screens

• New AnimationStartDemoScreen showcases all starting position configurations
• New CharacterCountDemoScreen demonstrates improved character count transitions
• Interactive controls for testing different scenarios
• Real-time comparison of behaviors

IMPROVED ARCHITECTURE: Replaced Levenshtein algorithm with intelligent transition system

• Better visual results with smoother animations
• Reduced complexity while improving user experience
• More predictable and controllable animation behavior

• wholeNumberStyle - Apply custom styling to digits before the decimal point
• decimalPointStyle - Apply custom styling to the decimal point character
• decimalDigitsStyle - Apply custom styling to digits after the decimal point

• Financial data where you want to emphasize whole numbers over decimals
• Scoreboard or dashboard displays with mixed styling needs
• Currency formatting with different visual treatments for decimal parts

• Useful for chaining animations or updating UI after transitions complete
• Follows clean architecture principles by providing a clear interface between presentation and business logic

• Improved to animate from initialValue to current text when called without parameters
• Added ability to animate from initialValue to a new value when called with a parameter
• This provides a powerful way to replay initial animations or reset to initial state

• Added initialValue property to set a starting value before animation
• Added animateOnLoad property to control whether animation happens on first render
• Added animate() method for programmatic animation control

• Resolved character dropping issue in the Levenshtein algorithm implementation
• Improved animation continuity for smooth transitions between text states
• Enhanced ticker column behavior to handle edge cases properly

• Reduced unnecessary state updates during animations
• Improved animation timing and synchronization
• Fixed initialization issues in the interactive demo

• Fixed import paths for better code organization
• Corrected documentation references for better API clarity
• Enhanced separation between domain and presentation layers

• Updated constant names to follow lowerCamelCase convention (e.g., EMPTY_CHAR to emptyChar)
• Fixed comment references in documentation to ensure proper visibility
• Improved code formatting and documentation clarity

• Smooth scrolling animations for text transitions
• Customizable animation duration, curve, and direction
• Support for different character sets (numbers, alphabets, custom characters)
• Flexible alignment and positioning options
• Precise character spacing and layout control