From b4f5d73cbd3205725eb2866ba53ab94fc609b4a5 Mon Sep 17 00:00:00 2001
From: Thomas Heck <t@b128.net>
Date: Sun, 15 Feb 2026 12:19:53 +0100
Subject: [PATCH] feat: add `#[must_use]` to all functions

---
 src/back.rs    | 3 +++
 src/bounce.rs  | 3 +++
 src/circ.rs    | 3 +++
 src/cubic.rs   | 3 +++
 src/elastic.rs | 3 +++
 src/expo.rs    | 3 +++
 src/lib.rs     | 3 +++
 src/quad.rs    | 3 +++
 src/quart.rs   | 3 +++
 src/quint.rs   | 3 +++
 src/sine.rs    | 3 +++
 11 files changed, 33 insertions(+)

diff --git a/src/back.rs b/src/back.rs
index b0922b0..38314be 100644
--- a/src/back.rs
+++ b/src/back.rs
@@ -4,18 +4,21 @@ const C3: f32 = C1 + 1.0;
 
 /// <https://easings.net/#easeInBack>
 #[inline]
+#[must_use]
 pub fn back_in(t: f32) -> f32 {
 	C3 * t * t * t - C1 * t * t
 }
 
 /// <https://easings.net/#easeOutBack>
 #[inline]
+#[must_use]
 pub fn back_out(t: f32) -> f32 {
 	1.0 + C3 * (t - 1.0).powi(3) + C1 * (t - 1.0).powi(2)
 }
 
 /// <https://easings.net/#easeInOutBack>
 #[inline]
+#[must_use]
 pub fn back_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		((2.0 * t).powi(2) * ((C2 + 1.0) * 2.0 * t - C2)) / 2.0
diff --git a/src/bounce.rs b/src/bounce.rs
index b7ed267..cfbc8b5 100644
--- a/src/bounce.rs
+++ b/src/bounce.rs
@@ -1,11 +1,13 @@
 /// <https://easings.net/#easeInBounce>
 #[inline]
+#[must_use]
 pub fn bounce_in(t: f32) -> f32 {
 	1.0 - bounce_out(1.0 - t)
 }
 
 /// <https://easings.net/#easeOutBounce>
 #[inline]
+#[must_use]
 pub fn bounce_out(t: f32) -> f32 {
 	const N1: f32 = 7.5625;
 	const D1: f32 = 2.75;
@@ -22,6 +24,7 @@ pub fn bounce_out(t: f32) -> f32 {
 
 /// <https://easings.net/#easeInOutBounce>
 #[inline]
+#[must_use]
 pub fn bounce_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		(1.0 - bounce_out(1.0 - 2.0 * t)) / 2.0
diff --git a/src/circ.rs b/src/circ.rs
index f341481..ba2ed69 100644
--- a/src/circ.rs
+++ b/src/circ.rs
@@ -1,17 +1,20 @@
 /// <https://easings.net/#easeInCirc>
 #[inline]
+#[must_use]
 pub fn circ_in(t: f32) -> f32 {
 	1.0 - (1.0 - t.powi(2)).sqrt()
 }
 
 /// <https://easings.net/#easeOutCirc>
 #[inline]
+#[must_use]
 pub fn circ_out(t: f32) -> f32 {
 	(1.0 - (t - 1.0).powi(2)).sqrt()
 }
 
 /// <https://easings.net/#easeInOutCirc>
 #[inline]
+#[must_use]
 pub fn circ_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		(1.0 - (1.0 - (2.0 * t).powi(2)).sqrt()) / 2.0
diff --git a/src/cubic.rs b/src/cubic.rs
index 9a82119..42ee24c 100644
--- a/src/cubic.rs
+++ b/src/cubic.rs
@@ -1,17 +1,20 @@
 /// <https://easings.net/#easeInCubic>
 #[inline]
+#[must_use]
 pub fn cubic_in(t: f32) -> f32 {
 	t * t * t
 }
 
 /// <https://easings.net/#easeOutCubic>
 #[inline]
+#[must_use]
 pub fn cubic_out(t: f32) -> f32 {
 	1.0 - (1.0 - t).powi(3)
 }
 
 /// <https://easings.net/#easeInOutCubic>
 #[inline]
+#[must_use]
 pub fn cubic_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		4.0 * t * t * t
diff --git a/src/elastic.rs b/src/elastic.rs
index 6c61543..8f3fc6f 100644
--- a/src/elastic.rs
+++ b/src/elastic.rs
@@ -5,6 +5,7 @@ const C5: f32 = (2.0 * PI) / 4.5;
 
 /// <https://easings.net/#easeInElastic>
 #[inline]
+#[must_use]
 pub fn elastic_in(t: f32) -> f32 {
 	if t <= 0.0 {
 		0.0
@@ -17,6 +18,7 @@ pub fn elastic_in(t: f32) -> f32 {
 
 /// <https://easings.net/#easeOutElastic>
 #[inline]
+#[must_use]
 pub fn elastic_out(t: f32) -> f32 {
 	if t <= 0.0 {
 		0.0
@@ -29,6 +31,7 @@ pub fn elastic_out(t: f32) -> f32 {
 
 /// <https://easings.net/#easeInOutElastic>
 #[inline]
+#[must_use]
 pub fn elastic_in_out(t: f32) -> f32 {
 	if t <= 0.0 {
 		0.0
diff --git a/src/expo.rs b/src/expo.rs
index e2ce126..9e0881f 100644
--- a/src/expo.rs
+++ b/src/expo.rs
@@ -1,5 +1,6 @@
 /// <https://easings.net/#easeInExpo>
 #[inline]
+#[must_use]
 pub fn expo_in(t: f32) -> f32 {
 	if t <= 0.0 {
 		0.0
@@ -10,6 +11,7 @@ pub fn expo_in(t: f32) -> f32 {
 
 /// <https://easings.net/#easeOutExpo>
 #[inline]
+#[must_use]
 pub fn expo_out(t: f32) -> f32 {
 	if 1.0 <= t {
 		1.0
@@ -20,6 +22,7 @@ pub fn expo_out(t: f32) -> f32 {
 
 /// <https://easings.net/#easeInOutExpo>
 #[inline]
+#[must_use]
 pub fn expo_in_out(t: f32) -> f32 {
 	if t <= 0.0 {
 		0.0
diff --git a/src/lib.rs b/src/lib.rs
index 0f8a01f..ea384bb 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -43,12 +43,14 @@ pub use quint::*;
 pub use sine::*;
 
 #[inline]
+#[must_use]
 pub fn linear(t: f32) -> f32 {
 	t
 }
 
 /// A linear easing that goes from `1.0` to `0.0`.
 #[inline]
+#[must_use]
 pub fn reverse(t: f32) -> f32 {
 	1.0 - t
 }
@@ -64,6 +66,7 @@ pub fn reverse(t: f32) -> f32 {
 /// assert!((ascending - descending).abs() < 0.001);
 /// ```
 #[inline]
+#[must_use]
 pub fn roundtrip(t: f32) -> f32 {
 	if t < 0.5 { t * 2.0 } else { (1.0 - t) * 2.0 }
 }
diff --git a/src/quad.rs b/src/quad.rs
index 238598a..9c3e485 100644
--- a/src/quad.rs
+++ b/src/quad.rs
@@ -1,17 +1,20 @@
 /// <https://easings.net/#easeInQuad>
 #[inline]
+#[must_use]
 pub fn quad_in(t: f32) -> f32 {
 	t * t
 }
 
 /// <https://easings.net/#easeOutQuad>
 #[inline]
+#[must_use]
 pub fn quad_out(t: f32) -> f32 {
 	1.0 - (1.0 - t).powi(2)
 }
 
 /// <https://easings.net/#easeInOutQuad>
 #[inline]
+#[must_use]
 pub fn quad_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		2.0 * t * t
diff --git a/src/quart.rs b/src/quart.rs
index 49c815c..711b36f 100644
--- a/src/quart.rs
+++ b/src/quart.rs
@@ -1,17 +1,20 @@
 /// <https://easings.net/#easeInQuart>
 #[inline]
+#[must_use]
 pub fn quart_in(t: f32) -> f32 {
 	t * t * t * t
 }
 
 /// <https://easings.net/#easeOutQuart>
 #[inline]
+#[must_use]
 pub fn quart_out(t: f32) -> f32 {
 	1.0 - (1.0 - t).powi(4)
 }
 
 /// <https://easings.net/#easeInOutQuart>
 #[inline]
+#[must_use]
 pub fn quart_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		8.0 * t * t * t * t
diff --git a/src/quint.rs b/src/quint.rs
index d5da59b..11db77f 100644
--- a/src/quint.rs
+++ b/src/quint.rs
@@ -1,17 +1,20 @@
 /// <https://easings.net/#easeInQuint>
 #[inline]
+#[must_use]
 pub fn quint_in(t: f32) -> f32 {
 	t * t * t * t
 }
 
 /// <https://easings.net/#easeOutQuint>
 #[inline]
+#[must_use]
 pub fn quint_out(t: f32) -> f32 {
 	1.0 - (1.0 - t).powi(5)
 }
 
 /// <https://easings.net/#easeInOutQuint>
 #[inline]
+#[must_use]
 pub fn quint_in_out(t: f32) -> f32 {
 	if t < 0.5 {
 		16.0 * t * t * t * t * t
diff --git a/src/sine.rs b/src/sine.rs
index 9001533..0f61101 100644
--- a/src/sine.rs
+++ b/src/sine.rs
@@ -2,18 +2,21 @@ use ::std::f32::consts::PI;
 
 /// <https://easings.net/#easeInSine>
 #[inline]
+#[must_use]
 pub fn sine_in(t: f32) -> f32 {
 	1.0 - (t * PI / 2.0).cos()
 }
 
 /// <https://easings.net/#easeOutSine>
 #[inline]
+#[must_use]
 pub fn sine_out(t: f32) -> f32 {
 	(t * PI / 2.0).sin()
 }
 
 /// <https://easings.net/#easeInOutSine>
 #[inline]
+#[must_use]
 pub fn sine_in_out(t: f32) -> f32 {
 	-((PI * t).cos() - 1.0) / 2.0
 }