hikari-animation 0.2.0

Animation hooks, easing functions and transition utilities for the Hikari design system
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! # Hikari Animation System
//!
//! A high-performance, declarative animation system with support for dynamic values,
//! complex timelines, and smooth transitions.
//!
//! ## Architecture
//!
//! The animation system is built on several core components:
//!
//! - **[`config`]** - Global animation configuration (enabled, duration_scale, reduced_motion)
//! - **[`builder`]** - Fluent builder API for creating animations with static and dynamic values
//! - **[`context`]** - Runtime context providing element dimensions, mouse position, and other state
//! - **[`style`]** - Type-safe CSS property manipulation with [`StyleStringBuilder`]
//! - **[`easing`]** - Easing functions for natural motion (ease-in-out, bounce, elastic, etc.)
//! - **[`tween`]** - Interpolation system for smooth value transitions
//! - **[`timeline`]** - Timeline-based animation sequencing
//! - **[`presets`]** - Pre-built animation presets (fade, slide, scale, etc.)
//! - **[`events`]** - Animation event system
//! - **[`timer`]** - High-precision timer for frame-based animations
//! - **[`core`]** - Core animation primitives and utilities
//!
//! ## Features
//!
//! - **Type-Safe CSS**: Compile-time checked CSS properties
//! - **Dynamic Values**: Compute animation values at runtime from context
//! - **Multi-Element**: Control multiple DOM elements simultaneously
//! - **Easing Functions**: 30+ easing functions for natural motion
//! - **Timeline Control**: Sequence and coordinate complex animations
//! - **Framework Agnostic**: Core works without any specific UI framework
//! - **Reduced Motion**: Automatic prefers-reduced-motion detection
//!
//! ## Platform Support
//!
//! This animation system is built for WASI unified environments, using tairitsu-vdom
//! for cross-platform browser API access. It works consistently across different
//! deployment targets.

// Pure Rust modules (no external dependencies required)
pub mod breathing;
pub mod config;
pub mod core;
pub mod debug;
pub mod easing;
pub mod error;
pub mod presets;
pub mod state;
pub mod state_machine;
pub mod timeline;
pub mod tween;

// Pure Rust exports
pub use core::*;

pub use breathing::*;
pub use config::AnimationConfig;
pub use debug::AnimationDebugProvider;
pub use easing::*;
pub use error::*;
pub use presets::*;
pub use state::*;
pub use state_machine::*;
pub use timeline::*;
pub use tween::*;

// Modules that use browser APIs via tairitsu
pub mod background_animation;
pub mod builder;
pub mod context;
pub mod events;
pub mod global_manager;
pub mod hooks;
pub mod lifecycle;
pub mod prefers_reduced_motion;
pub mod provider;
pub mod scrollbar;
pub mod style;
pub mod timer;

// Re-export browser API modules
pub use background_animation::*;
pub use builder::*;
pub use context::AnimationContext;
pub use events::*;
pub use global_manager::*;
pub use hooks::tween::{UseTween, use_animation_engine, use_tween};
pub use hooks::{
    UseTransition, use_animated_value, use_animation_frame, use_interval, use_timeout,
    use_transition, use_transition_with_config,
};
pub use lifecycle::*;
pub use prefers_reduced_motion::*;
pub use provider::{
    AnimationProviderContext, init_animation_provider, try_use_animation_config,
    use_animation_config, use_animation_duration_scale, use_animation_enabled,
    use_animation_reduced_motion,
};
pub use scrollbar::*;
pub use style::*;
pub use timer::*;