OpenPanel is an open-source web and product analytics platform, an open-source alternative to Mixpanel with optional self-hosting.
'use client';
import { animate, type Transition, useMotionValue } from 'motion/react';
import { useEffect, useRef } from 'react';
import { DEFAULT_CHART_ENTER_TRANSITION } from './animation';
/** Drives 0→1 enter progress using the studio motion transition (spring or tween). */
export function useMountProgress(
enterTransition: Transition | undefined,
delaySeconds: number,
replayKey: number | string
) {
const progress = useMotionValue(0);
const transitionRef = useRef(enterTransition);
transitionRef.current = enterTransition;
// replayKey intentionally retriggers enter when motion settings change
// biome-ignore lint/correctness/useExhaustiveDependencies: replayKey
useEffect(() => {
progress.set(0);
const controls = animate(progress, 1, {
...(transitionRef.current ?? DEFAULT_CHART_ENTER_TRANSITION),
delay: delaySeconds,
});
return () => controls.stop();
}, [delaySeconds, replayKey, progress]);
return progress;
}