@weasel-js/core 1.7.3 → 1.8.0

package/dist/animation/useAnimator.js

@@ -1,51 +1,54 @@
 import { useVisibleRaf as e } from "../scheduling/useVisibleRaf.js";
 import { createLoop as t, createTweenLoop as n } from "./loop.js";
-import { createStagger as r } from "./stagger.js";
-import { createTimeline as i } from "./timeline/createTimeline.js";
-import { ColorOverrideRegistry as a } from "./colorRegistry.js";
-import { AnimatorEventHub as o } from "./observe.js";
-import { SPRING_PRESETS as s, easeOut as c, resolveEasing as l } from "@weasel-js/geom";
-import { useCallback as u, useEffect as d, useInsertionEffect as f, useMemo as p, useRef as m } from "react";
-import { useLatest as h } from "@weasel-js/react";
+import { stepSpring as r } from "./engine/integrator.js";
+import { createCodec as i } from "./engine/codec.js";
+import { axesOf as a } from "./engine/axes.js";
+import { createStagger as o } from "./stagger.js";
+import { createTimeline as s } from "./timeline/createTimeline.js";
+import { ColorOverrideRegistry as c } from "./colorRegistry.js";
+import { AnimatorEventHub as l } from "./observe.js";
+import { SPRING_PRESETS as u, easeOut as d, resolveEasing as f } from "@weasel-js/geom";
+import { useCallback as p, useEffect as m, useInsertionEffect as h, useMemo as g, useRef as _ } from "react";
+import { useLatest as v } from "@weasel-js/react";
 //#region src/animation/useAnimator.ts
-var g = (e, t, n) => e + (t - e) * n;
-function _(e) {
-	let t = e.preset ? s[e.preset] : null;
+function y(e) {
+	let t = e.preset ? u[e.preset] : null;
 	return {
 		stiffness: e.stiffness ?? t?.stiffness ?? 170,
 		damping: e.damping ?? t?.damping ?? 26,
 		mass: e.mass ?? t?.mass ?? 1
 	};
 }
-function v(s = {}) {
-	let v = h(s), y = m(/* @__PURE__ */ new Map()), b = m(1), x = m(0), S = m(1), C = m(!1), w = m(new a()), T = m(/* @__PURE__ */ new Set()), E = m(null), D = e(u((e) => {
-		E.current?.(e);
+function b(u = {}) {
+	let b = v(u), x = _(/* @__PURE__ */ new Map()), S = _(1), C = _(0), w = _(null), T = _(1), E = _(!1), D = _(new c()), O = _(/* @__PURE__ */ new Set()), k = _(null), A = e(p((e) => {
+		k.current?.(e);
 	}, []), {
-		requestFrame: s.requestFrame,
-		cancelFrame: s.cancelFrame,
+		requestFrame: u.requestFrame,
+		cancelFrame: u.cancelFrame,
 		onResume: () => {
-			for (let e of y.current.values()) e.lastRealNow = null;
+			for (let e of x.current.values()) e.lastRealNow = null;
+			w.current = null;
 		}
-	}), O = h(D), k = m(!0), A = m(!1), j = () => !k.current && (A.current || (A.current = !0, (typeof process > "u" || process.env.NODE_ENV !== "production") && console.error("weasel useAnimator: animation tick fired after the host component unmounted. This usually means cleanup logic was bypassed — check for refactors that removed the unmount effect or replaced cancelAll with a custom path.")), !0), { api: M, tickAll: N } = p(() => {
-		let e = () => (v.current.now ?? (typeof performance < "u" ? performance.now.bind(performance) : Date.now))(), a = {
-			setTimer: (e, t) => (v.current.setTimer ?? ((e, t) => setTimeout(e, t)))(e, t),
-			clearTimer: (e) => (v.current.clearTimer ?? ((e) => clearTimeout(e)))(e),
+	}), j = v(A), M = _(!0), N = _(!1), P = () => !M.current && (N.current || (N.current = !0, (typeof process > "u" || process.env.NODE_ENV !== "production") && console.error("weasel useAnimator: animation tick fired after the host component unmounted. This usually means cleanup logic was bypassed — check for refactors that removed the unmount effect or replaced cancelAll with a custom path.")), !0), { api: F, tickAll: I } = g(() => {
+		let e = () => (b.current.now ?? (typeof performance < "u" ? performance.now.bind(performance) : Date.now))(), c = {
+			setTimer: (e, t) => (b.current.setTimer ?? ((e, t) => setTimeout(e, t)))(e, t),
+			clearTimer: (e) => (b.current.clearTimer ?? ((e) => clearTimeout(e)))(e),
 			now: e
-		}, s = /* @__PURE__ */ new Map(), u = (e) => {
-			let t = s.get(e);
+		}, u = /* @__PURE__ */ new Map(), p = (e) => {
+			let t = u.get(e);
 			if (t) {
-				s.delete(e);
+				u.delete(e);
 				for (let e of t) e();
 			}
-		}, d = (e, t) => {
-			let n = s.get(e) ?? [];
-			return n.push(t), s.set(e, n), () => {
-				let n = s.get(e);
+		}, m = (e, t) => {
+			let n = u.get(e) ?? [];
+			return n.push(t), u.set(e, n), () => {
+				let n = u.get(e);
 				if (!n) return;
 				let r = n.indexOf(t);
-				r >= 0 && n.splice(r, 1), n.length === 0 && s.delete(e);
+				r >= 0 && n.splice(r, 1), n.length === 0 && u.delete(e);
 			};
-		}, f = new o(), p = (e) => {
+		}, h = new l(), g = i(), _ = (e) => {
 			if (!e.info) {
 				let t = {
 					id: e.id,
@@ -54,73 +57,76 @@ function v(s = {}) {
 				e.cancelKey != null && (t.key = e.cancelKey), e.label != null && (t.label = e.label), e.info = t;
 			}
 			return e.info;
-		}, m = (e) => {
-			let t = y.current.get(e);
-			t && !t.ended && (t.ended = !0, f.watched && f.emit({
+		}, v = (e) => {
+			let t = x.current.get(e);
+			t && !t.ended && (t.ended = !0, h.watched && h.emit({
 				type: "end",
-				animation: p(t)
+				animation: _(t)
 			}));
-		}, h = (e, t) => {
-			let n = y.current.get(e);
-			n && (n.onCancel?.(), y.current.delete(e), u(e), f.watched && !n.ended && f.emit(t ? {
+		}, k = (e, t) => {
+			let n = x.current.get(e);
+			n && (n.onCancel?.(), g.stop(e), x.current.delete(e), p(e), h.watched && !n.ended && h.emit(t ? {
 				type: "interrupt",
-				animation: p(n),
-				by: p(t)
+				animation: _(n),
+				by: _(t)
 			} : {
 				type: "cancel",
-				animation: p(n)
+				animation: _(n)
 			}));
-		}, E = (e) => {
-			let t = [];
-			for (let n of y.current.values()) {
+		}, A = (e) => {
+			let t = [], n = w.current == null ? 0 : Math.max(0, e - w.current);
+			w.current = e, g.frame(n * (E.current ? 0 : T.current));
+			for (let n of x.current.values()) {
 				let r = n.lastRealNow == null ? 0 : Math.max(0, e - n.lastRealNow);
 				n.lastRealNow = e;
-				let i = C.current ? 0 : S.current * (n.paused ? 0 : n.timeScale);
-				n.virtualNow += r * i, x.current += 1;
+				let i = E.current ? 0 : T.current * (n.paused ? 0 : n.timeScale);
+				n.virtualNow += r * i, C.current += 1;
 				try {
 					n.tick(n.virtualNow, i) && t.push(n);
 				} finally {
-					--x.current;
+					--C.current;
 				}
 			}
-			for (let e of t) y.current.get(e.id) === e && (m(e.id), y.current.delete(e.id), u(e.id));
-			for (let e of T.current) try {
+			for (let e of t) x.current.get(e.id) === e && (v(e.id), x.current.delete(e.id), p(e.id));
+			for (let e of O.current) try {
 				e();
 			} catch (e) {
 				console.error("useAnimator: onTick subscriber threw", e);
 			}
-			y.current.size > 0 && O.current.request();
-		}, D = () => {
-			y.current.size !== 0 && O.current.request();
-		}, k = (e, t) => {
+			x.current.size > 0 ? j.current.request() : w.current = null;
+		}, M = () => {
+			x.current.size !== 0 && j.current.request();
+		}, N = (e, t) => {
 			let n = [];
-			for (let t of y.current.values()) t.cancelKey === e && n.push(t.id);
-			for (let e of n) h(e, t);
-		}, A = (t) => {
+			for (let t of x.current.values()) t.cancelKey === e && n.push(t.id);
+			for (let e of n) k(e, t);
+		}, F = (e) => {
+			g.has(e.id) && g.rate(e.id, e.paused ? 0 : e.timeScale);
+		}, I = (t) => {
 			let n = t;
-			return t.cancelKey != null && !t.keepExisting && k(t.cancelKey, n), n.paused = !1, n.timeScale = 1, n.virtualNow = 0, n.lastRealNow = e(), y.current.set(n.id, n), f.watched && f.emit({
+			return t.cancelKey != null && !t.keepExisting && N(t.cancelKey, n), n.paused = !1, n.timeScale = 1, n.virtualNow = 0, n.lastRealNow = e(), x.current.set(n.id, n), h.watched && h.emit({
 				type: "start",
-				animation: p(n)
-			}), D(), {
+				animation: _(n)
+			}), M(), {
 				id: n.id,
-				cancel: () => h(n.id),
+				cancel: () => k(n.id),
 				pause: () => {
-					let e = y.current.get(n.id);
-					e && (e.paused = !0);
+					let e = x.current.get(n.id);
+					e && (e.paused = !0, F(e));
 				},
 				resume: () => {
-					let e = y.current.get(n.id);
-					e && (e.paused = !1);
+					let e = x.current.get(n.id);
+					e && (e.paused = !1, F(e));
 				},
 				setTimeScale: (e) => {
-					let t = y.current.get(n.id);
-					t && (t.timeScale = e);
+					let t = x.current.get(n.id);
+					t && (t.timeScale = e, F(t));
 				},
-				timeScale: () => y.current.get(n.id)?.timeScale ?? 1,
-				isPaused: () => y.current.get(n.id)?.paused ?? !1
+				timeScale: () => x.current.get(n.id)?.timeScale ?? 1,
+				isPaused: () => x.current.get(n.id)?.paused ?? !1
 			};
-		}, M = ({ kind: e, cancelKey: t, label: n }) => {
-			let r = b.current++, i, a = A({
+		}, L = ({ kind: e, cancelKey: t, label: n }) => {
+			let r = S.current++, i, a = I({
 				id: r,
 				kind: e,
 				cancelKey: t,
@@ -140,61 +146,97 @@ function v(s = {}) {
 					i = e;
 				},
 				finish: () => {
-					y.current.has(r) && (m(r), y.current.delete(r), u(r));
+					x.current.has(r) && (v(r), x.current.delete(r), p(r));
 				},
 				cancelKey: t
 			};
-		}, N = (e) => {
-			let t = b.current++, n = l(e.easing ?? c), r = e.interpolator ? e.interpolator(e.from, e.to) : null, i = r ? null : e.interpolate ?? ((e, t, n) => {
-				if (typeof e == "number" && typeof t == "number") return g(e, t, n);
-				throw Error("tween: interpolate or interpolator is required for non-numeric T");
-			}), a = !1;
-			return A({
-				id: t,
+		}, R = (t) => {
+			let n = t.interpolate || t.interpolator ? null : a(t.from), r = n && a(t.to), i = n && r && r.shape === n.shape ? n : null;
+			if (!i && !t.interpolate && !t.interpolator) throw Error("tween: interpolate or interpolator is required for non-numeric T");
+			let o = S.current++, s = f(t.easing ?? d), c = t.interpolator ? t.interpolator(t.from, t.to) : null, l = !1;
+			w.current ??= e();
+			let u = g.tween({
+				id: o,
+				ms: Math.max(t.ms, 1),
+				ease: s,
+				from: i ? i.to(t.from) : [0],
+				to: i ? i.to(t.to) : [1]
+			});
+			return I({
+				id: o,
 				kind: "tween",
-				cancelKey: e.cancelKey,
-				label: e.label,
-				progress: (t) => e.ms <= 0 ? 1 : Math.min(1, t / e.ms),
-				tick(o) {
-					if (j()) return !0;
-					let s = o - 0, c = e.ms <= 0 ? 1 : Math.min(1, Math.max(0, s / e.ms)), l = n(c), u = r ? r(l) : i(e.from, e.to, l);
-					return e.onTick(u), c >= 1 && !a && (a = !0, y.current.has(t) && (m(t), e.onDone?.()), !0);
+				cancelKey: t.cancelKey,
+				label: t.label,
+				progress: (e) => t.ms <= 0 ? 1 : Math.min(1, e / t.ms),
+				tick(e) {
+					if (P()) return g.stop(o), !0;
+					let n = t.ms <= 0 ? 1 : Math.min(1, e / t.ms), r;
+					if (i) r = n >= 1 ? t.to : i.from(u.cols, u.at);
+					else {
+						let e = n >= 1 ? s(1) : u.cols[u.at];
+						r = c ? c(e) : t.interpolate(t.from, t.to, e);
+					}
+					return t.onTick(r), n >= 1 && !l && (l = !0, g.stop(o), x.current.has(o) && (v(o), t.onDone?.()), !0);
 				}
 			});
-		}, P = (e, t = "physics") => {
-			let n = b.current++;
-			if (typeof e.from != "number" && (!e.add || !e.subtract || !e.scale || !e.magnitude)) throw Error("physics: add/subtract/scale/magnitude are required for non-numeric T");
-			let r = e.add ?? ((e, t) => e + t), i = e.subtract ?? ((e, t) => e - t), a = e.scale ?? ((e, t) => e * t), o = e.magnitude ?? ((e) => Math.abs(e)), { stiffness: s, damping: c, mass: l } = _(e), u = e.restThreshold ?? .01, d = e.to ?? null, f = e.from, p = e.velocity ?? a(e.from, 0), h = null;
-			return {
-				...A({
-					id: n,
-					kind: t,
-					cancelKey: e.cancelKey,
-					label: e.label,
-					tick(t) {
-						if (j()) return !0;
-						if (h == null) return h = t, d == null && o(p) < u ? (m(n), e.onDone?.(), !0) : (e.onTick(f), !1);
-						let g = Math.min(.064, (t - h) / 1e3);
-						h = t;
-						let _ = i(f, d ?? f), v = a(_, d == null ? 0 : -s), y = a(p, -c), b = a(r(v, y), 1 / l);
-						p = r(p, a(b, g)), f = r(f, a(p, g)), e.onTick(f);
-						let x = o(p) < u, S = d == null || o(i(f, d)) < u;
-						return x && S ? (d != null && e.onTick(d), m(n), e.onDone?.(), !0) : !1;
+		}, z = (t, n = "physics") => {
+			let i = S.current++;
+			if (typeof t.from != "number" && (!t.add || !t.subtract || !t.scale || !t.magnitude)) throw Error("physics: add/subtract/scale/magnitude are required for non-numeric T");
+			let o = t.add ?? ((e, t) => e + t), s = t.subtract ?? ((e, t) => e - t), c = t.scale ?? ((e, t) => e * t), l = t.magnitude ?? ((e) => Math.abs(e)), { stiffness: u, damping: d, mass: f } = y(t), p = t.restThreshold ?? .01, m = t.to ?? null, h = t.from, _ = t.velocity ?? c(t.from, 0), b = null, x = d > 0 && f > 0 && (u > 0 || n === "decay") ? a(t.from) : null, C = (e) => e == null || a(e)?.shape === x.shape, T = x && C(t.to) && C(t.velocity) ? x : null, E = null;
+			T && (w.current ??= e(), E = g.spring({
+				id: i,
+				axes: T.count,
+				from: T.to(t.from),
+				to: t.to == null ? null : T.to(t.to),
+				velocity: t.velocity == null ? Array(T.count).fill(0) : T.to(t.velocity),
+				stiffness: u,
+				damping: d,
+				mass: f
+			}));
+			let D = I({
+				id: i,
+				kind: n,
+				cancelKey: t.cancelKey,
+				label: t.label,
+				tick(e) {
+					if (P()) return g.stop(i), !0;
+					if (b == null) {
+						if (b = e, m == null && l(_) < p) return g.stop(i), v(i), t.onDone?.(), !0;
+						if (!T) return t.onTick(h), !1;
+					}
+					if (T) {
+						let e = E.motion();
+						h = T.from(e.value), _ = T.from(e.velocity);
+					} else {
+						let t = Math.min(.064, (e - b) / 1e3), n = r({
+							add: o,
+							subtract: s,
+							scale: c
+						}, h, _, m, u, d, f, t);
+						h = n.value, _ = n.velocity;
 					}
-				}),
+					b = e, t.onTick(h);
+					let n = l(_) < p, a = m == null || l(s(h, m)) < p;
+					return n && a ? (m != null && t.onTick(m), g.stop(i), v(i), t.onDone?.(), !0) : !1;
+				}
+			}), O = (e, t) => {
+				if (!C(e)) throw Error(`physics: ${t} is not the same shape as \`from\``);
+			};
+			return {
+				...D,
 				setTarget: (e) => {
-					d = e;
+					T && e != null && O(e, "setTarget"), m = e, T && g.has(i) && g.retarget(i, e == null ? null : T.to(e));
 				},
 				setVelocity: (e) => {
-					p = e;
+					T && O(e, "setVelocity"), _ = e, T && g.has(i) && g.push(i, T.to(e));
 				}
 			};
-		}, F = {
-			tween: N,
-			spring: (e) => P(e, "spring"),
+		}, B = {
+			tween: R,
+			spring: (e) => z(e, "spring"),
 			decay: (e) => {
 				let t = e.friction ?? .95, n = -Math.log(t);
-				return P({
+				return z({
 					from: e.from,
 					to: null,
 					velocity: e.velocity,
@@ -212,61 +254,61 @@ function v(s = {}) {
 					label: e.label
 				}, "decay");
 			},
-			physics: P,
-			cancel: (e) => h(e.id),
-			cancelKey: (e) => k(e),
+			physics: z,
+			cancel: (e) => k(e.id),
+			cancelKey: (e) => N(e),
 			cancelAll: () => {
 				let e = [];
-				for (let t of y.current.values()) t.onCancel?.(), e.push(t);
-				y.current.clear();
-				for (let t of e) u(t.id);
-				if (f.watched) for (let t of e) f.emit({
+				for (let t of x.current.values()) t.onCancel?.(), g.stop(t.id), e.push(t);
+				x.current.clear(), w.current = null;
+				for (let t of e) p(t.id);
+				if (h.watched) for (let t of e) h.emit({
 					type: "cancel",
-					animation: p(t)
+					animation: _(t)
 				});
-				O.current.cancel();
+				j.current.cancel();
 			},
 			isActive: (e) => {
-				if (e == null) return y.current.size > 0;
-				for (let t of y.current.values()) if (t.cancelKey === e) return !0;
+				if (e == null) return x.current.size > 0;
+				for (let t of x.current.values()) if (t.cancelKey === e) return !0;
 				return !1;
 			},
-			isTicking: () => x.current > 0,
+			isTicking: () => C.current > 0,
 			pause: () => {
-				C.current = !0;
+				E.current = !0;
 			},
 			resume: () => {
-				C.current = !1;
+				E.current = !1;
 			},
-			isPaused: () => C.current,
+			isPaused: () => E.current,
 			setTimeScale: (e) => {
-				S.current = e;
+				T.current = e;
 			},
-			timeScale: () => S.current,
+			timeScale: () => T.current,
 			pauseKey: (e) => {
-				for (let t of y.current.values()) t.cancelKey === e && (t.paused = !0);
+				for (let t of x.current.values()) t.cancelKey === e && (t.paused = !0, F(t));
 			},
 			resumeKey: (e) => {
-				for (let t of y.current.values()) t.cancelKey === e && (t.paused = !1);
+				for (let t of x.current.values()) t.cancelKey === e && (t.paused = !1, F(t));
 			},
 			setTimeScaleByKey: (e, t) => {
-				for (let n of y.current.values()) n.cancelKey === e && (n.timeScale = t);
+				for (let n of x.current.values()) n.cancelKey === e && (n.timeScale = t, F(n));
 			},
-			loop: (e, n) => t(M, e, n),
-			tweenLoop: (e) => n(F, M, e),
-			stagger: ((e, t, n, i) => r(F, a, M, d, e, t, n, i)),
+			loop: (e, n) => t(L, e, n),
+			tweenLoop: (e) => n(B, L, e),
+			stagger: ((e, t, n, r) => o(B, c, L, m, e, t, n, r)),
 			timeline: (e) => {
-				let t = b.current++, n = () => {
-					let e = y.current.get(t);
-					return e && p(e);
+				let t = S.current++, n = () => {
+					let e = x.current.get(t);
+					return e && _(e);
 				};
-				return i(A, t, e, {
+				return s(I, t, e, {
 					get watched() {
-						return f.watched;
+						return h.watched;
 					},
 					fire: (e, t, r, i) => {
 						let a = n();
-						a && f.emit({
+						a && h.emit({
 							type: "fire",
 							animation: a,
 							track: e,
@@ -277,7 +319,7 @@ function v(s = {}) {
 					},
 					lap: (e) => {
 						let t = n();
-						t && f.emit({
+						t && h.emit({
 							type: "lap",
 							animation: t,
 							lap: e
@@ -285,20 +327,20 @@ function v(s = {}) {
 					}
 				});
 			},
-			colorOverrides: w.current,
-			onTick: (e) => (T.current.add(e), () => {
-				T.current.delete(e);
+			colorOverrides: D.current,
+			onTick: (e) => (O.current.add(e), () => {
+				O.current.delete(e);
 			}),
 			keepAlive: () => {
-				let e = M({ kind: "keepAlive" });
+				let e = L({ kind: "keepAlive" });
 				return () => e.cancel();
 			},
-			watch: (e) => f.add(e),
+			watch: (e) => h.add(e),
 			live: () => {
 				let e = [];
-				for (let t of y.current.values()) {
+				for (let t of x.current.values()) {
 					let n = {
-						...p(t),
+						..._(t),
 						paused: t.paused,
 						timeScale: t.timeScale,
 						elapsed: t.virtualNow,
@@ -310,20 +352,20 @@ function v(s = {}) {
 			}
 		};
 		return {
-			api: F,
-			tickAll: E
+			api: B,
+			tickAll: A
 		};
-	}, [O, v]);
-	return f(() => {
-		E.current = N;
-	}, [N]), d(() => {
-		let e = w.current;
-		return k.current = !0, () => {
-			k.current = !1, M.cancelAll(), e.clearAll();
+	}, [j, b]);
+	return h(() => {
+		k.current = I;
+	}, [I]), m(() => {
+		let e = D.current;
+		return M.current = !0, () => {
+			M.current = !1, F.cancelAll(), e.clearAll();
 		};
-	}, [M]), M;
+	}, [F]), F;
 }
 //#endregion
-export { v as useAnimator };
+export { b as useAnimator };
 
 //# sourceMappingURL=useAnimator.js.map