=========
Changelog
=========

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

0.0.1 (2026-01-24)
==================

Initial Release
---------------

**Features:**

- ✨ Video splash screen support using media_kit
- 🎬 Cross-platform video playback (Android, iOS, macOS, Windows, Linux, Web)
- 🎮 Manual playback control via ``SplashVideoController``
- 🔄 Infinite looping support with user-controlled exit
- 📱 Flexible overlay system (title, footer, custom builder)
- 🎯 Auto-navigation or manual navigation control
- 🎨 Multiple display modes (fullscreen, aspect ratio, none)
- ⚡ Defer first frame pattern for smooth native-to-Flutter transitions
- 🛡️ Runtime validation for configuration rules
- 📦 Type-safe source system (Asset, Network, DeviceFile, Bytes)

**Components Included:**

- ``SplashVideo`` widget - Main entry point
- ``SplashVideoController`` - Playback control
- ``VideoConfig`` - Configuration options
- ``Source`` types - Video source abstractions
- ``VisibilityEnum`` - Display mode options

**Documentation:**

- Comprehensive README with usage examples
- Implementation plan (RST)
- Implementation completion guide (RST)
- Example application with 4 usage patterns
- Inline API documentation

**Dependencies:**

- ``media_kit ^1.2.6``
- ``media_kit_video ^2.0.1``
- Platform-specific media_kit libraries

**Known Limitations:**

- Boomerang loop playback not yet implemented (planned for future release)
- Advanced analytics hooks not included
- No built-in preloading/caching support

**Breaking Changes:**

None (initial release)

**Migration:**

Not applicable (initial release)

---

*Format based on* `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_