🎨 Rich Animation Effects - Pulse, breathe, fire, comet, sparkle, wave, and more
🌈 Advanced Color System - Predefined palettes, custom gradients, smooth color cycling
📝 Simple DSL Syntax - Write animations in intuitive, declarative language
⚡ High Performance - Optimized for embedded systems with minimal memory usage
🔧 Extensible - Create custom animations and effects
🎯 Position-Based Effects - Precise control over individual LED positions
📊 Dynamic Parameters - Animate colors, positions, sizes with oscillating values
🎭 Sequences - Create complex shows with timing and loops

🚀 Quick Start

Simple Pulsing Animation

# Define colors
color bordeaux = 0x6F2C4F

# Create pulsing animation
animation pulse_bordeaux = pulsating_animation(color=bordeaux, period=3s)

# Run it
run pulse_bordeaux

Rainbow Color Cycling

# Use predefined rainbow palette
animation rainbow_cycle = rich_palette(
  palette=PALETTE_RAINBOW
  cycle_period=5s
  transition_type=1
)

run rainbow_cycle

Custom Color Palette

# Define a sunset palette
palette sunset = [
  (0, 0x191970)    # Midnight blue
  (64, purple)     # Purple
  (128, 0xFF69B4)  # Hot pink
  (192, orange)    # Orange
  (255, yellow)    # Yellow
]

# Create palette animation
animation sunset_glow = rich_palette(
  palette=sunset
  cycle_period=8s
  transition_type=1
)

run sunset_glow

Reusable Templates

Create parameterized animation patterns that can be reused with different settings:

# Define a reusable template
template pulse_effect {
  param color type color
  param speed
  param brightness
  
  animation pulse = pulsating_animation(
    color=color
    period=speed
    opacity=brightness
  )
  
  run pulse
}

# Use the template with different parameters
pulse_effect(red, 2s, 255)     # Bright red pulse
pulse_effect(blue, 1s, 150)    # Dimmer blue pulse
pulse_effect(0xFF69B4, 3s, 200) # Hot pink pulse

Animation Sequences

animation red_pulse = pulsating_animation(color=red, period=2s)
animation green_pulse = pulsating_animation(color=green, period=2s)
animation blue_pulse = pulsating_animation(color=blue, period=2s)

sequence rgb_show {
  play red_pulse for 3s
  wait 500ms
  play green_pulse for 3s
  wait 500ms
  play blue_pulse for 3s
  
  repeat 2 times {
    play red_pulse for 1s
    play green_pulse for 1s
    play blue_pulse for 1s
  }
}

run rgb_show

📚 Documentation

Getting Started

Quick Start Guide - Get up and running in 5 minutes
DSL Reference - Complete DSL syntax and features
Examples - Comprehensive examples and tutorials

Reference

Animation Class Hierarchy - All available animations and parameters
Oscillation Patterns - Dynamic value patterns and waveforms
Troubleshooting - Common issues and solutions

Advanced

User Functions - Create custom animation functions
Animation Development - Create custom animations
Transpiler Architecture - DSL transpiler internals and processing flow

🎯 Core Concepts

DSL-First Design

Write animations using simple, declarative syntax:

animation fire_effect = fire_animation(intensity=200, cooling_rate=55, sparking_rate=120)
run fire_effect

Dynamic Parameters

Use oscillating values to create complex effects:

animation pulsing_comet = comet_animation(
  color=red
  tail_length = smooth(min_value=5, max_value=15, duration=3s)
  speed=2
)

Color Palettes

Rich color transitions with predefined or custom palettes:

palette custom_palette = [(0, blue), (128, purple), (255, pink)]
animation palette_cycle = rich_palette(palette=custom_palette, cycle_period=4s)

🎨 Animation Types

Basic Effects

Pulse - Breathing/pulsing effects with smooth transitions
Sparkle - Random twinkling and starfield effects
Fire - Realistic fire simulation with warm colors
Comet - Moving comet with customizable tail

Color Animations

Rich Palette - Smooth color transitions using predefined palettes
Color Cycling - Custom color sequences with smooth blending
Gradient - Linear and radial color gradients
Plasma - Classic plasma effects with sine wave interference

Pattern Effects

Wave - Mathematical waveforms (sine, triangle, square, sawtooth)
Noise - Organic patterns using Perlin noise
Position-Based - Precise control over individual LED positions

Motion Effects

Bounce - Physics-based bouncing with gravity and damping
Shift - Scrolling and translation effects
Scale - Size transformation and breathing effects
Jitter - Add random variations to any animation

🔧 Installation

Prerequisites

Tasmota firmware with Berry support
Addressable LED strip (WS2812, SK6812, etc.)

Setup

Enable Berry in Tasmota configuration
Configure LED strip using Tasmota's LED configuration
Import the framework:
```
import animation
```
Create your first animation using the DSL

🌈 Predefined Palettes

The framework includes several built-in color palettes:

PALETTE_RAINBOW - Standard 7-color rainbow (Red → Orange → Yellow → Green → Blue → Indigo → Violet)
PALETTE_RGB - Simple RGB cycle (Red → Green → Blue)
PALETTE_FIRE - Warm fire colors (Black → Dark Red → Red → Orange → Yellow)
PALETTE_SUNSET_TICKS - Sunset colors (Orange Red → Dark Orange → Gold → Hot Pink → Purple → Midnight Blue)
PALETTE_OCEAN - Blue and green ocean tones (Navy → Blue → Cyan → Spring Green → Green)
PALETTE_FOREST - Various green forest tones (Dark Green → Forest Green → Lime Green → Mint Green → Light Green)

# Use any predefined palette
animation ocean_waves = rich_palette(
  palette=PALETTE_OCEAN
  cycle_period=8s
  transition_type=1
)
run ocean_waves

📄 License

This project is licensed under the MIT License.

Happy Animating! 🎨✨