spanda 0.9.2

A general-purpose animation library for Rust — tweening, keyframes, timelines, and physics.
Documentation 
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
100
101
102
103
104

//! # spanda
//!
//! *Sanskrit: स्पन्द — vibration, pulse, the throb of motion.*
//!
//! A general-purpose animation library for Rust.  Zero mandatory dependencies,
//! `no_std`-ready, and designed to work anywhere: terminal UIs, web (WASM),
//! game engines (Bevy), or native desktop apps.
//!
//! ## Feature flags
//!
//! | Flag       | What it adds                                          |
//! |------------|-------------------------------------------------------|
//! | `std`      | *(default)* wall-clock driver, thread-safe internals  |
//! | `serde`    | `Serialize`/`Deserialize` on all public types         |
//! | `bevy`     | `SpandaPlugin` for Bevy 0.18                          |
//! | `wasm`     | `requestAnimationFrame` driver                        |
//! | `palette`  | Colour interpolation via the `palette` crate          |
//! | `tokio`    | `async` / `.await` on timeline completion             |
//!
//! ## Quick start
//!
//! ```rust
//! use spanda::{Tween, Easing};
//! use spanda::traits::Update;
//!
//! let mut tween = Tween::new(0.0_f32, 100.0)
//!     .duration(1.0)
//!     .easing(Easing::EaseOutCubic)
//!     .build();
//!
//! // Simulate 10 frames:
//! for _ in 0..10 {
//!     tween.update(0.1);
//! }
//!
//! assert!(tween.is_complete());
//! assert!((tween.value() - 100.0).abs() < 1e-6);
//! ```

#![cfg_attr(not(feature = "std"), no_std)]
#![forbid(unsafe_code)]
#![warn(missing_docs, missing_debug_implementations)]

#[cfg(not(feature = "std"))]
extern crate alloc;

// ── Module declarations ───────────────────────────────────────────────────────

pub mod bezier;
pub mod clock;
pub mod drag;
pub mod driver;
pub mod easing;
pub mod gesture;
pub mod inertia;
pub mod integrations;
pub mod keyframe;
pub mod layout;
pub mod morph;
pub mod motion_path;
pub mod path;
pub mod scroll;
pub mod spring;
pub mod svg_draw;
pub mod svg_path;
pub mod timeline;
pub mod traits;
pub mod tween;

#[cfg(feature = "palette")]
pub mod colour;

#[cfg(feature = "gpu")]
pub mod gpu;

// ── Top-level re-exports (ergonomic imports) ──────────────────────────────────

pub use bezier::{CatmullRomSpline, PathEvaluate2D, tangent_angle, tangent_angle_deg};
pub use clock::{Clock, ManualClock, MockClock};
pub use drag::{DragAxis, DragConstraints, DragState, PointerData};
pub use driver::{AnimationDriver, AnimationId};
pub use easing::Easing;
pub use gesture::{Gesture, GestureConfig, GestureRecognizer, SwipeDirection};
pub use inertia::{Inertia, InertiaConfig, InertiaN};
pub use keyframe::{Keyframe, KeyframeTrack, Loop};
pub use layout::{
    LayoutAnimation, LayoutAnimator, LayoutTransition, Rect, SharedElementTransition,
};
pub use morph::{MorphPath, resample};
pub use motion_path::{CompoundPath, PathCommand, PolyPath};
pub use path::{BezierPath, MotionPath, MotionPathTween, PathEvaluate};
pub use scroll::{ScrollClock, ScrollDriver};
pub use spring::{Spring, SpringAnimatable, SpringConfig, SpringN};
pub use svg_draw::{draw_on, draw_on_reverse};
pub use svg_path::SvgPathParser;
pub use timeline::{At, Sequence, Timeline, stagger};
pub use traits::{Animatable, Interpolate, Update};
pub use tween::{Tween, TweenState, round_to, snap_to};

#[cfg(feature = "std")]
pub use clock::WallClock;

#[cfg(feature = "palette")]
pub use colour::{InLab, InLinear, InOklch, lerp_in_lab, lerp_in_linear, lerp_in_oklch};