@hua-labs/motion-core 2.0.0

package/dist/hooks/useRepeat.js

@@ -0,0 +1,179 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+export function useRepeat(options = {}) {
+    const { duration = 1000, easing = 'ease-in-out', repeatCount = -1, // 기본값: 무한 반복
+    repeatDelay = 0, repeatDirection = 'forward', repeatMode = 'loop', autoStart = true, initialScale = 1, initialOpacity = 1, initialRotate = 0, initialTranslateY = 0, initialTranslateX = 0, targetScale = 1.2, targetOpacity = 0.8, targetRotate = 10, targetTranslateY = -10, targetTranslateX = 0, onComplete, onStart, onStop, onReset } = options;
+    const ref = useRef(null);
+    const [isVisible, setIsVisible] = useState(false);
+    const [isAnimating, setIsAnimating] = useState(false);
+    const [progress, setProgress] = useState(0);
+    const [currentRepeat, setCurrentRepeat] = useState(0);
+    const [isRepeating, setIsRepeating] = useState(false);
+    const [animationDirection, setAnimationDirection] = useState('forward');
+    // 애니메이션 루프 함수
+    const runAnimation = useCallback(() => {
+        if (!isRepeating)
+            return;
+        setIsAnimating(true);
+        setProgress(0);
+        onStart?.();
+        // 애니메이션 진행
+        const startTime = Date.now();
+        const animate = () => {
+            if (!isRepeating)
+                return;
+            const elapsed = Date.now() - startTime;
+            const currentProgress = Math.min(elapsed / duration, 1);
+            // 이징 적용
+            const easedProgress = currentProgress;
+            setProgress(easedProgress);
+            if (currentProgress < 1) {
+                requestAnimationFrame(animate);
+            }
+            else {
+                // 애니메이션 완료
+                setIsAnimating(false);
+                setProgress(1);
+                // 반복 방향 결정
+                let nextDirection = animationDirection;
+                if (repeatDirection === 'alternate') {
+                    nextDirection = animationDirection === 'forward' ? 'reverse' : 'forward';
+                    setAnimationDirection(nextDirection);
+                }
+                // 반복 카운트 증가
+                const nextRepeat = currentRepeat + 1;
+                setCurrentRepeat(nextRepeat);
+                // 반복 조건 확인
+                if (repeatCount === -1 || nextRepeat < repeatCount) {
+                    // 지연 후 다음 반복
+                    setTimeout(() => {
+                        if (isRepeating) {
+                            runAnimation();
+                        }
+                    }, repeatDelay);
+                }
+                else {
+                    // 반복 완료
+                    setIsRepeating(false);
+                    onComplete?.();
+                }
+            }
+        };
+        requestAnimationFrame(animate);
+    }, [isRepeating, duration, onStart, onComplete, currentRepeat, repeatCount, repeatDelay, repeatMode, animationDirection]);
+    // 반복 시작 함수
+    const startRepeat = useCallback(() => {
+        if (isRepeating)
+            return;
+        setIsRepeating(true);
+        setCurrentRepeat(0);
+        setAnimationDirection('forward');
+        runAnimation();
+    }, [isRepeating, runAnimation]);
+    // 반복 중단 함수
+    const stopRepeat = useCallback(() => {
+        setIsRepeating(false);
+        setIsAnimating(false);
+        onStop?.();
+    }, [onStop]);
+    // 반복 일시정지 함수
+    const pauseRepeat = useCallback(() => {
+        setIsRepeating(false);
+        setIsAnimating(false);
+    }, []);
+    // 반복 재개 함수
+    const resumeRepeat = useCallback(() => {
+        if (!isRepeating && currentRepeat < (repeatCount === -1 ? Infinity : repeatCount)) {
+            setIsRepeating(true);
+            runAnimation();
+        }
+    }, [isRepeating, currentRepeat, repeatCount, runAnimation]);
+    // 모션 시작 함수
+    const start = useCallback(() => {
+        if (!isVisible) {
+            setIsVisible(true);
+            startRepeat();
+        }
+    }, [isVisible, startRepeat]);
+    // 모션 중단 함수
+    const stop = useCallback(() => {
+        stopRepeat();
+    }, [stopRepeat]);
+    // 모션 리셋 함수
+    const reset = useCallback(() => {
+        setIsVisible(false);
+        setIsAnimating(false);
+        setProgress(0);
+        setCurrentRepeat(0);
+        setIsRepeating(false);
+        setAnimationDirection('forward');
+        onReset?.();
+    }, [onReset]);
+    // 모션 일시정지 함수
+    const pause = useCallback(() => {
+        pauseRepeat();
+    }, [pauseRepeat]);
+    // 모션 재개 함수
+    const resume = useCallback(() => {
+        if (isVisible) {
+            resumeRepeat();
+        }
+    }, [isVisible, resumeRepeat]);
+    // 자동 시작
+    useEffect(() => {
+        if (autoStart) {
+            startRepeat();
+        }
+    }, [autoStart, startRepeat]);
+    // 컴포넌트 언마운트 시 정리
+    useEffect(() => {
+        return () => {
+            setIsRepeating(false);
+        };
+    }, []);
+    // 현재 진행률에 따른 스타일 계산
+    const getCurrentStyle = () => {
+        let currentProgress = progress;
+        // 반복 방향에 따른 진행률 조정
+        if (animationDirection === 'reverse') {
+            currentProgress = 1 - progress;
+        }
+        // 반복 모드에 따른 진행률 조정
+        if (repeatMode === 'bounce') {
+            currentProgress = Math.sin(currentProgress * Math.PI);
+        }
+        const scale = initialScale + (targetScale - initialScale) * currentProgress;
+        const opacity = initialOpacity + (targetOpacity - initialOpacity) * currentProgress;
+        const rotate = initialRotate + (targetRotate - initialRotate) * currentProgress;
+        const translateY = initialTranslateY + (targetTranslateY - initialTranslateY) * currentProgress;
+        const translateX = initialTranslateX + (targetTranslateX - initialTranslateX) * currentProgress;
+        return {
+            transform: `
+        scale(${scale})
+        rotate(${rotate}deg)
+        translate(${translateX}px, ${translateY}px)
+      `,
+            opacity,
+            transition: `all ${duration}ms ${easing}`,
+            willChange: 'transform, opacity'
+        };
+    };
+    const style = getCurrentStyle();
+    return {
+        ref,
+        isVisible,
+        isAnimating,
+        style,
+        progress,
+        start,
+        stop,
+        reset,
+        pause,
+        resume,
+        repeatCount,
+        currentRepeat,
+        isRepeating,
+        repeatDirection,
+        repeatMode
+    };
+}
+//# sourceMappingURL=useRepeat.js.map

package/dist/hooks/useRepeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRepeat.js","sourceRoot":"","sources":["../../src/hooks/useRepeat.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useScaleIn.d.ts

@@ -0,0 +1,3 @@
+import { ScaleOptions, BaseMotionReturn, MotionElement } from '../types';
+export declare function useScaleIn<T extends MotionElement = HTMLDivElement>(options?: ScaleOptions): BaseMotionReturn<T>;
+//# sourceMappingURL=useScaleIn.d.ts.map

package/dist/hooks/useScaleIn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScaleIn.d.ts","sourceRoot":"","sources":["../../src/hooks/useScaleIn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExE,wBAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,GAAG,cAAc,EACjE,OAAO,GAAE,YAAiB,GACzB,gBAAgB,CAAC,CAAC,CAAC,CAqIrB"}

package/dist/hooks/useScaleIn.js

@@ -0,0 +1,111 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+export function useScaleIn(options = {}) {
+    const { delay = 0, duration = 700, threshold = 0.1, triggerOnce = true, easing = 'ease-out', autoStart = true, initialScale = 0.5, targetScale = 1, onComplete, onStart, onStop, onReset } = options;
+    const ref = useRef(null);
+    const [isVisible, setIsVisible] = useState(false);
+    const [isAnimating, setIsAnimating] = useState(false);
+    const [progress, setProgress] = useState(0);
+    const observerRef = useRef(null);
+    const timeoutRef = useRef(null);
+    // 모션 시작 함수
+    const start = useCallback(() => {
+        if (isAnimating)
+            return;
+        setIsAnimating(true);
+        setProgress(0);
+        onStart?.();
+        // 지연 시간 적용
+        if (delay > 0) {
+            timeoutRef.current = window.setTimeout(() => {
+                setIsVisible(true);
+                setProgress(1);
+                setIsAnimating(false);
+                onComplete?.();
+            }, delay);
+        }
+        else {
+            setIsVisible(true);
+            setProgress(1);
+            setIsAnimating(false);
+            onComplete?.();
+        }
+    }, [delay, isAnimating, onStart, onComplete]);
+    // 모션 중단 함수
+    const stop = useCallback(() => {
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+            timeoutRef.current = null;
+        }
+        setIsAnimating(false);
+        onStop?.();
+    }, [onStop]);
+    // 모션 리셋 함수
+    const reset = useCallback(() => {
+        stop();
+        setIsVisible(false);
+        setProgress(0);
+        onReset?.();
+    }, [stop, onReset]);
+    // 모션 일시정지 함수
+    const pause = useCallback(() => {
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+            timeoutRef.current = null;
+        }
+        setIsAnimating(false);
+    }, []);
+    // 모션 재개 함수
+    const resume = useCallback(() => {
+        if (!isVisible && !isAnimating) {
+            start();
+        }
+    }, [isVisible, isAnimating, start]);
+    // Intersection Observer 설정
+    useEffect(() => {
+        if (!ref.current || !autoStart)
+            return;
+        observerRef.current = new IntersectionObserver((entries) => {
+            entries.forEach((entry) => {
+                if (entry.isIntersecting) {
+                    start();
+                    if (triggerOnce) {
+                        observerRef.current?.disconnect();
+                    }
+                }
+            });
+        }, { threshold });
+        observerRef.current.observe(ref.current);
+        return () => {
+            if (observerRef.current) {
+                observerRef.current.disconnect();
+            }
+        };
+    }, [autoStart, threshold, triggerOnce, start]);
+    // 컴포넌트 언마운트 시 정리
+    useEffect(() => {
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+        };
+    }, []);
+    // 스타일 계산
+    const style = {
+        transform: `scale(${isVisible ? targetScale : initialScale})`,
+        transition: `transform ${duration}ms ${easing}`,
+        willChange: 'transform'
+    };
+    return {
+        ref,
+        isVisible,
+        isAnimating,
+        style,
+        progress,
+        start,
+        stop,
+        reset,
+        pause,
+        resume
+    };
+}
+//# sourceMappingURL=useScaleIn.js.map

package/dist/hooks/useScaleIn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScaleIn.js","sourceRoot":"","sources":["../../src/hooks/useScaleIn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGhE,MAAM,UAAU,UAAU,CACxB,UAAwB,EAAE;IAE1B,MAAM,EACJ,KAAK,GAAG,CAAC,EACT,QAAQ,GAAG,GAAG,EACd,SAAS,GAAG,GAAG,EACf,WAAW,GAAG,IAAI,EAClB,MAAM,GAAG,UAAU,EACnB,SAAS,GAAG,IAAI,EAChB,YAAY,GAAG,GAAG,EAClB,WAAW,GAAG,CAAC,EACf,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EACrC,GAAG,OAAO,CAAA;IAEX,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAA;IAC3B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,MAAM,CAA8B,IAAI,CAAC,CAAA;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAE9C,WAAW;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,WAAW;YAAE,OAAM;QAEvB,cAAc,CAAC,IAAI,CAAC,CAAA;QACpB,WAAW,CAAC,CAAC,CAAC,CAAA;QACd,OAAO,EAAE,EAAE,CAAA;QAEX,WAAW;QACX,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBAC1C,YAAY,CAAC,IAAI,CAAC,CAAA;gBAClB,WAAW,CAAC,CAAC,CAAC,CAAA;gBACd,cAAc,CAAC,KAAK,CAAC,CAAA;gBACrB,UAAU,EAAE,EAAE,CAAA;YAChB,CAAC,EAAE,KAAK,CAAC,CAAA;QACX,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,CAAA;YAClB,WAAW,CAAC,CAAC,CAAC,CAAA;YACd,cAAc,CAAC,KAAK,CAAC,CAAA;YACrB,UAAU,EAAE,EAAE,CAAA;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;IAE7C,WAAW;IACX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAA;QAC3B,CAAC;QACD,cAAc,CAAC,KAAK,CAAC,CAAA;QACrB,MAAM,EAAE,EAAE,CAAA;IACZ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,WAAW;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,EAAE,CAAA;QACN,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,WAAW,CAAC,CAAC,CAAC,CAAA;QACd,OAAO,EAAE,EAAE,CAAA;IACb,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAEnB,aAAa;IACb,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAA;QAC3B,CAAC;QACD,cAAc,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,WAAW;IACX,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,KAAK,EAAE,CAAA;QACT,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAA;IAEnC,2BAA2B;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtC,WAAW,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAC5C,CAAC,OAAO,EAAE,EAAE;YACV,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;oBACzB,KAAK,EAAE,CAAA;oBACP,IAAI,WAAW,EAAE,CAAC;wBAChB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,EACD,EAAE,SAAS,EAAE,CACd,CAAA;QAED,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAExC,OAAO,GAAG,EAAE;YACV,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,CAAA;YAClC,CAAC;QACH,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAA;IAE9C,iBAAiB;IACjB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAClC,CAAC;QACH,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS;IACT,MAAM,KAAK,GAAwB;QACjC,SAAS,EAAE,SAAS,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,GAAG;QAC7D,UAAU,EAAE,aAAa,QAAQ,MAAM,MAAM,EAAE;QAC/C,UAAU,EAAE,WAAW;KACxB,CAAA;IAED,OAAO;QACL,GAAG;QACH,SAAS;QACT,WAAW;QACX,KAAK;QACL,QAAQ;QACR,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/hooks/useScrollProgress.d.ts

@@ -0,0 +1,21 @@
+import { BaseMotionOptions, BaseMotionReturn, MotionElement } from '../types';
+export interface ScrollProgressOptions extends BaseMotionOptions {
+    progressScale?: number;
+    progressOpacity?: number;
+    progressRotate?: number;
+    progressTranslateY?: number;
+    progressTranslateX?: number;
+    initialScale?: number;
+    initialOpacity?: number;
+    initialRotate?: number;
+    initialTranslateY?: number;
+    initialTranslateX?: number;
+    scrollThreshold?: number;
+    progressDirection?: 'horizontal' | 'vertical' | 'both';
+}
+export declare function useScrollProgress<T extends MotionElement = HTMLDivElement>(options?: ScrollProgressOptions): BaseMotionReturn<T> & {
+    scrollProgress: number;
+    scrollDirection: 'up' | 'down' | null;
+    scrollVelocity: number;
+};
+//# sourceMappingURL=useScrollProgress.d.ts.map

package/dist/hooks/useScrollProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollProgress.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollProgress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7E,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAA;CACvD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,aAAa,GAAG,cAAc,EACxE,OAAO,GAAE,qBAA0B,GAClC,gBAAgB,CAAC,CAAC,CAAC,GAAG;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IACrC,cAAc,EAAE,MAAM,CAAA;CACvB,CA6KA"}

package/dist/hooks/useScrollProgress.js

@@ -0,0 +1,139 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+export function useScrollProgress(options = {}) {
+    const { duration = 300, easing = 'ease-out', progressScale = 1, progressOpacity, progressRotate, progressTranslateY, progressTranslateX, initialScale = 0.8, initialOpacity = 0.5, initialRotate = 0, initialTranslateY = 0, initialTranslateX = 0, scrollThreshold = 0.1, progressDirection = 'both', onComplete, onStart, onStop, onReset } = options;
+    const ref = useRef(null);
+    const [isVisible, setIsVisible] = useState(false);
+    const [isAnimating, setIsAnimating] = useState(false);
+    const [progress, setProgress] = useState(0);
+    const [scrollProgress, setScrollProgress] = useState(0);
+    const [scrollDirection, setScrollDirection] = useState(null);
+    const [scrollVelocity, setScrollVelocity] = useState(0);
+    const [lastScrollY, setLastScrollY] = useState(0);
+    const [lastScrollTime, setLastScrollTime] = useState(Date.now());
+    // 스크롤 이벤트 핸들러
+    const handleScroll = useCallback(() => {
+        if (!ref.current)
+            return;
+        const currentScrollY = window.scrollY;
+        const currentTime = Date.now();
+        const rect = ref.current.getBoundingClientRect();
+        const threshold = window.innerHeight * scrollThreshold;
+        // 스크롤 진행률 계산 (0-1)
+        const elementTop = rect.top + currentScrollY;
+        const elementHeight = rect.height;
+        const viewportHeight = window.innerHeight;
+        const documentHeight = document.documentElement.scrollHeight;
+        let newScrollProgress = 0;
+        if (progressDirection === 'vertical' || progressDirection === 'both') {
+            // 세로 스크롤 진행률
+            const scrollRange = documentHeight - viewportHeight;
+            newScrollProgress = Math.max(0, Math.min(1, currentScrollY / scrollRange));
+        }
+        else if (progressDirection === 'horizontal') {
+            // 가로 스크롤 진행률 (요소가 뷰포트에 들어올 때)
+            const elementProgress = Math.max(0, Math.min(1, (viewportHeight - rect.top) / (viewportHeight + elementHeight)));
+            newScrollProgress = elementProgress;
+        }
+        setScrollProgress(newScrollProgress);
+        // 스크롤 방향과 속도 계산
+        const isScrollingDown = currentScrollY > lastScrollY;
+        const isScrollingUp = currentScrollY < lastScrollY;
+        const timeDiff = currentTime - lastScrollTime;
+        const scrollDiff = Math.abs(currentScrollY - lastScrollY);
+        const velocity = timeDiff > 0 ? scrollDiff / timeDiff : 0;
+        if (isScrollingDown) {
+            setScrollDirection('down');
+        }
+        else if (isScrollingUp) {
+            setScrollDirection('up');
+        }
+        setScrollVelocity(velocity);
+        // 요소가 뷰포트에 보이는지 확인
+        const shouldBeVisible = rect.top <= threshold;
+        if (shouldBeVisible && !isVisible) {
+            setIsVisible(true);
+            setIsAnimating(true);
+            setProgress(0);
+            onStart?.();
+            setTimeout(() => {
+                setIsAnimating(false);
+                setProgress(1);
+                onComplete?.();
+            }, duration);
+        }
+        setLastScrollY(currentScrollY);
+        setLastScrollTime(currentTime);
+    }, [isVisible, lastScrollY, lastScrollTime, progressDirection, scrollThreshold, duration, onStart, onComplete]);
+    // 스크롤 이벤트 리스너 설정
+    useEffect(() => {
+        window.addEventListener('scroll', handleScroll, { passive: true });
+        handleScroll(); // 초기 상태 확인
+        return () => {
+            window.removeEventListener('scroll', handleScroll);
+        };
+    }, [handleScroll]);
+    // 모션 시작 함수
+    const start = useCallback(() => {
+        if (!isVisible) {
+            setIsVisible(true);
+            setIsAnimating(true);
+            setProgress(0);
+            onStart?.();
+            setTimeout(() => {
+                setIsAnimating(false);
+                setProgress(1);
+                onComplete?.();
+            }, duration);
+        }
+    }, [isVisible, duration, onStart, onComplete]);
+    // 모션 중단 함수
+    const stop = useCallback(() => {
+        setIsAnimating(false);
+        onStop?.();
+    }, [onStop]);
+    // 모션 리셋 함수
+    const reset = useCallback(() => {
+        setIsVisible(false);
+        setIsAnimating(false);
+        setProgress(0);
+        setScrollProgress(0);
+        onReset?.();
+    }, [onReset]);
+    // 모션 일시정지 함수
+    const pause = useCallback(() => {
+        setIsAnimating(false);
+    }, []);
+    // 모션 재개 함수
+    const resume = useCallback(() => {
+        if (isVisible) {
+            setIsAnimating(true);
+        }
+    }, [isVisible]);
+    // 스타일 계산 (스크롤 진행률에 따라)
+    const style = {
+        transform: `
+      scale(${initialScale + (progressScale - initialScale) * scrollProgress})
+      rotate(${initialRotate + (progressRotate || 0 - initialRotate) * scrollProgress}deg)
+      translate(${initialTranslateX + (progressTranslateX || 0 - initialTranslateX) * scrollProgress}px, ${initialTranslateY + (progressTranslateY || 0 - initialTranslateY) * scrollProgress}px)
+    `,
+        opacity: initialOpacity + (progressOpacity || 1 - initialOpacity) * scrollProgress,
+        transition: `all ${duration}ms ${easing}`,
+        willChange: 'transform, opacity'
+    };
+    return {
+        ref,
+        isVisible,
+        isAnimating,
+        style,
+        progress,
+        start,
+        stop,
+        reset,
+        pause,
+        resume,
+        scrollProgress,
+        scrollDirection,
+        scrollVelocity
+    };
+}
+//# sourceMappingURL=useScrollProgress.js.map

package/dist/hooks/useScrollProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollProgress.js","sourceRoot":"","sources":["../../src/hooks/useScrollProgress.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useScrollReveal.d.ts

@@ -0,0 +1,17 @@
+import { BaseMotionOptions, BaseMotionReturn, MotionElement } from '../types';
+export interface ScrollRevealOptions extends BaseMotionOptions {
+    revealScale?: number;
+    revealOpacity?: number;
+    revealRotate?: number;
+    revealTranslateY?: number;
+    revealTranslateX?: number;
+    initialScale?: number;
+    initialOpacity?: number;
+    initialRotate?: number;
+    initialTranslateY?: number;
+    initialTranslateX?: number;
+    scrollThreshold?: number;
+    scrollDirection?: 'up' | 'down' | 'both';
+}
+export declare function useScrollReveal<T extends MotionElement = HTMLDivElement>(options?: ScrollRevealOptions): BaseMotionReturn<T>;
+//# sourceMappingURL=useScrollReveal.d.ts.map

package/dist/hooks/useScrollReveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollReveal.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollReveal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7E,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;CACzC;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,aAAa,GAAG,cAAc,EACtE,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAAC,CAAC,CAAC,CA0HrB"}

package/dist/hooks/useScrollReveal.js

@@ -0,0 +1,95 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+export function useScrollReveal(options = {}) {
+    const { duration = 700, easing = 'ease-out', revealScale = 1, revealOpacity = 1, revealRotate = 0, revealTranslateY = 0, revealTranslateX = 0, initialScale = 0.8, initialOpacity = 0, initialRotate = 0, initialTranslateY = 50, initialTranslateX = 0, scrollThreshold = 0.1, scrollDirection = 'both', onComplete, onStart, onStop, onReset } = options;
+    const ref = useRef(null);
+    const [isRevealed, setIsRevealed] = useState(false);
+    const [isAnimating, setIsAnimating] = useState(false);
+    const [progress, setProgress] = useState(0);
+    // 스크롤 이벤트 핸들러
+    const handleScroll = useCallback(() => {
+        if (!ref.current)
+            return;
+        const rect = ref.current.getBoundingClientRect();
+        const threshold = window.innerHeight * scrollThreshold;
+        const shouldReveal = rect.top <= threshold;
+        if (shouldReveal && !isRevealed) {
+            setIsRevealed(true);
+            setIsAnimating(true);
+            setProgress(0);
+            onStart?.();
+            setTimeout(() => {
+                setIsAnimating(false);
+                setProgress(1);
+                onComplete?.();
+            }, duration);
+        }
+    }, [isRevealed, scrollThreshold, duration, onStart, onComplete]);
+    // 스크롤 이벤트 리스너 설정
+    useEffect(() => {
+        window.addEventListener('scroll', handleScroll, { passive: true });
+        handleScroll();
+        return () => {
+            window.removeEventListener('scroll', handleScroll);
+        };
+    }, [handleScroll]);
+    // 모션 시작 함수
+    const start = useCallback(() => {
+        if (!isRevealed) {
+            setIsRevealed(true);
+            setIsAnimating(true);
+            setProgress(0);
+            onStart?.();
+            setTimeout(() => {
+                setIsAnimating(false);
+                setProgress(1);
+                onComplete?.();
+            }, duration);
+        }
+    }, [isRevealed, duration, onStart, onComplete]);
+    // 모션 중단 함수
+    const stop = useCallback(() => {
+        setIsAnimating(false);
+        onStop?.();
+    }, [onStop]);
+    // 모션 리셋 함수
+    const reset = useCallback(() => {
+        setIsRevealed(false);
+        setIsAnimating(false);
+        setProgress(0);
+        onReset?.();
+    }, [onReset]);
+    // 모션 일시정지 함수
+    const pause = useCallback(() => {
+        setIsAnimating(false);
+    }, []);
+    // 모션 재개 함수
+    const resume = useCallback(() => {
+        if (isRevealed) {
+            setIsAnimating(true);
+        }
+    }, [isRevealed]);
+    // 스타일 계산
+    const style = {
+        transform: `
+      scale(${isRevealed ? revealScale : initialScale})
+      rotate(${isRevealed ? revealRotate : initialRotate}deg)
+      translate(${isRevealed ? revealTranslateX : initialTranslateX}px, ${isRevealed ? revealTranslateY : initialTranslateY}px)
+    `,
+        opacity: isRevealed ? revealOpacity : initialOpacity,
+        transition: `all ${duration}ms ${easing}`,
+        willChange: 'transform, opacity'
+    };
+    return {
+        ref,
+        isVisible: isRevealed,
+        isAnimating,
+        style,
+        progress,
+        start,
+        stop,
+        reset,
+        pause,
+        resume
+    };
+}
+//# sourceMappingURL=useScrollReveal.js.map

package/dist/hooks/useScrollReveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollReveal.js","sourceRoot":"","sources":["../../src/hooks/useScrollReveal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAkBhE,MAAM,UAAU,eAAe,CAC7B,UAA+B,EAAE;IAEjC,MAAM,EACJ,QAAQ,GAAG,GAAG,EACd,MAAM,GAAG,UAAU,EACnB,WAAW,GAAG,CAAC,EACf,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,CAAC,EAChB,gBAAgB,GAAG,CAAC,EACpB,gBAAgB,GAAG,CAAC,EACpB,YAAY,GAAG,GAAG,EAClB,cAAc,GAAG,CAAC,EAClB,aAAa,GAAG,CAAC,EACjB,iBAAiB,GAAG,EAAE,EACtB,iBAAiB,GAAG,CAAC,EACrB,eAAe,GAAG,GAAG,EACrB,eAAe,GAAG,MAAM,EACxB,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EACrC,GAAG,OAAO,CAAA;IAEX,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAA;IAC3B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAE3C,cAAc;IACd,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAM;QAExB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAA;QAChD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,GAAG,eAAe,CAAA;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,IAAI,SAAS,CAAA;QAE1C,IAAI,YAAY,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,aAAa,CAAC,IAAI,CAAC,CAAA;YACnB,cAAc,CAAC,IAAI,CAAC,CAAA;YACpB,WAAW,CAAC,CAAC,CAAC,CAAA;YACd,OAAO,EAAE,EAAE,CAAA;YAEX,UAAU,CAAC,GAAG,EAAE;gBACd,cAAc,CAAC,KAAK,CAAC,CAAA;gBACrB,WAAW,CAAC,CAAC,CAAC,CAAA;gBACd,UAAU,EAAE,EAAE,CAAA;YAChB,CAAC,EAAE,QAAQ,CAAC,CAAA;QACd,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;IAEhE,iBAAiB;IACjB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAClE,YAAY,EAAE,CAAA;QAEd,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACpD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,WAAW;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,aAAa,CAAC,IAAI,CAAC,CAAA;YACnB,cAAc,CAAC,IAAI,CAAC,CAAA;YACpB,WAAW,CAAC,CAAC,CAAC,CAAA;YACd,OAAO,EAAE,EAAE,CAAA;YAEX,UAAU,CAAC,GAAG,EAAE;gBACd,cAAc,CAAC,KAAK,CAAC,CAAA;gBACrB,WAAW,CAAC,CAAC,CAAC,CAAA;gBACd,UAAU,EAAE,EAAE,CAAA;YAChB,CAAC,EAAE,QAAQ,CAAC,CAAA;QACd,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;IAE/C,WAAW;IACX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,cAAc,CAAC,KAAK,CAAC,CAAA;QACrB,MAAM,EAAE,EAAE,CAAA;IACZ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,WAAW;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,aAAa,CAAC,KAAK,CAAC,CAAA;QACpB,cAAc,CAAC,KAAK,CAAC,CAAA;QACrB,WAAW,CAAC,CAAC,CAAC,CAAA;QACd,OAAO,EAAE,EAAE,CAAA;IACb,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,aAAa;IACb,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,cAAc,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,WAAW;IACX,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,UAAU,EAAE,CAAC;YACf,cAAc,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAEhB,SAAS;IACT,MAAM,KAAK,GAAwB;QACjC,SAAS,EAAE;cACD,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;eACtC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa;kBACtC,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,OAAO,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,iBAAiB;KACtH;QACD,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc;QACpD,UAAU,EAAE,OAAO,QAAQ,MAAM,MAAM,EAAE;QACzC,UAAU,EAAE,oBAAoB;KACjC,CAAA;IAED,OAAO;QACL,GAAG;QACH,SAAS,EAAE,UAAU;QACrB,WAAW;QACX,KAAK;QACL,QAAQ;QACR,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/hooks/useScrollToggle.d.ts

@@ -0,0 +1,17 @@
+import { BaseMotionOptions, BaseMotionReturn, MotionElement } from '../types';
+export interface ScrollToggleOptions extends BaseMotionOptions {
+    showScale?: number;
+    showOpacity?: number;
+    showRotate?: number;
+    showTranslateY?: number;
+    showTranslateX?: number;
+    hideScale?: number;
+    hideOpacity?: number;
+    hideRotate?: number;
+    hideTranslateY?: number;
+    hideTranslateX?: number;
+    scrollThreshold?: number;
+    scrollDirection?: 'up' | 'down' | 'both';
+}
+export declare function useScrollToggle<T extends MotionElement = HTMLDivElement>(options?: ScrollToggleOptions): BaseMotionReturn<T>;
+//# sourceMappingURL=useScrollToggle.d.ts.map

package/dist/hooks/useScrollToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollToggle.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollToggle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7E,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;CACzC;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,aAAa,GAAG,cAAc,EACtE,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAAC,CAAC,CAAC,CAoJrB"}