@hua-labs/motion-core 2.0.0 → 2.0.1

package/dist/hooks/useScrollProgress.js

@@ -1,139 +1,37 @@
-import { useRef, useState, useEffect, useCallback } from 'react';
+import { useState, useEffect } 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]);
-    // 스크롤 이벤트 리스너 설정
+    const { target, offset = 0, showOnMount = false } = options;
+    const [progress, setProgress] = useState(showOnMount ? 0 : 0);
+    const [mounted, setMounted] = useState(false);
+    // 하이드레이션 이슈 해결을 위한 mounted 상태 관리
+    useEffect(() => {
+        setMounted(true);
+    }, []);
     useEffect(() => {
-        window.addEventListener('scroll', handleScroll, { passive: true });
-        handleScroll(); // 초기 상태 확인
+        if (!mounted)
+            return;
+        const calculateProgress = () => {
+            if (typeof window !== 'undefined') {
+                const scrollTop = window.pageYOffset;
+                const scrollHeight = target || document.documentElement.scrollHeight - window.innerHeight;
+                const adjustedScrollTop = Math.max(0, scrollTop - offset);
+                const progressPercent = Math.min(100, Math.max(0, (adjustedScrollTop / scrollHeight) * 100));
+                setProgress(progressPercent);
+            }
+        };
+        // 초기 상태 확인
+        calculateProgress();
+        // 이벤트 리스너 등록
+        window.addEventListener("scroll", calculateProgress, { passive: true });
+        window.addEventListener("resize", calculateProgress, { passive: true });
         return () => {
-            window.removeEventListener('scroll', handleScroll);
+            window.removeEventListener("scroll", calculateProgress);
+            window.removeEventListener("resize", calculateProgress);
         };
-    }, [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'
-    };
+    }, [target, offset, mounted]);
     return {
-        ref,
-        isVisible,
-        isAnimating,
-        style,
         progress,
-        start,
-        stop,
-        reset,
-        pause,
-        resume,
-        scrollProgress,
-        scrollDirection,
-        scrollVelocity
+        mounted
     };
 }
 //# sourceMappingURL=useScrollProgress.js.map

package/dist/hooks/useScrollProgress.js.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollProgress.js","sourceRoot":"","sources":["../../src/hooks/useScrollProgress.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useScrollProgress.js","sourceRoot":"","sources":["../../src/hooks/useScrollProgress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQ3C,MAAM,UAAU,iBAAiB,CAAC,UAAiC,EAAE;IACnE,MAAM,EACJ,MAAM,EACN,MAAM,GAAG,CAAC,EACV,WAAW,GAAG,KAAK,EACpB,GAAG,OAAO,CAAA;IAEX,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE7C,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC7B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAA;gBACpC,MAAM,YAAY,GAAG,MAAM,IAAI,QAAQ,CAAC,eAAe,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAA;gBACzF,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;gBAEzD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,iBAAiB,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;gBAC5F,WAAW,CAAC,eAAe,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC,CAAA;QAED,WAAW;QACX,iBAAiB,EAAE,CAAA;QAEnB,aAAa;QACb,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACvE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAEvE,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAA;YACvD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAA;QACzD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAE7B,OAAO;QACL,QAAQ;QACR,OAAO;KACR,CAAA;AACH,CAAC"}

package/dist/hooks/useScrollReveal.d.ts

@@ -1,17 +1,14 @@
-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';
+import { BaseMotionReturn, MotionElement } from '../types';
+type MotionType = 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+interface ScrollRevealOptions {
+    threshold?: number;
+    rootMargin?: string;
+    triggerOnce?: boolean;
+    delay?: number;
+    motionType?: MotionType;
 }
-export declare function useScrollReveal<T extends MotionElement = HTMLDivElement>(options?: ScrollRevealOptions): BaseMotionReturn<T>;
+export declare function useScrollReveal<T extends MotionElement = HTMLDivElement>(options?: ScrollRevealOptions): BaseMotionReturn<T> & {
+    progress: number;
+};
+export {};
 //# sourceMappingURL=useScrollReveal.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"useScrollReveal.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollReveal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE1D,KAAK,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,CAAA;AAE5F,UAAU,mBAAmB;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,aAAa,GAAG,cAAc,EACtE,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAAC,CAAC,CAAC,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAmIA"}

package/dist/hooks/useScrollReveal.js

@@ -1,95 +1,116 @@
-import { useRef, useState, useEffect, useCallback } from 'react';
+import { useRef, useEffect, useCallback, useState, useMemo } 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 { threshold = 0.1, rootMargin = '0px', triggerOnce = true, delay = 0, motionType = 'fadeIn' } = options;
     const ref = useRef(null);
-    const [isRevealed, setIsRevealed] = useState(false);
+    const [isVisible, setIsVisible] = useState(false);
     const [isAnimating, setIsAnimating] = useState(false);
+    const [hasTriggered, setHasTriggered] = useState(false);
     const [progress, setProgress] = useState(0);
-    // 스크롤 이벤트 핸들러
-    const handleScroll = useCallback(() => {
+    const observerCallback = useCallback((entries) => {
+        entries.forEach(entry => {
+            if (entry.isIntersecting && (!triggerOnce || !hasTriggered)) {
+                setIsAnimating(true);
+                setTimeout(() => {
+                    setIsVisible(true);
+                    setHasTriggered(true);
+                    setProgress(1);
+                    setIsAnimating(false);
+                }, delay);
+            }
+        });
+    }, [triggerOnce, hasTriggered, delay]);
+    useEffect(() => {
         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();
+        const observer = new IntersectionObserver(observerCallback, {
+            threshold,
+            rootMargin
+        });
+        observer.observe(ref.current);
         return () => {
-            window.removeEventListener('scroll', handleScroll);
+            observer.disconnect();
         };
-    }, [handleScroll]);
-    // 모션 시작 함수
-    const start = useCallback(() => {
-        if (!isRevealed) {
-            setIsRevealed(true);
-            setIsAnimating(true);
-            setProgress(0);
-            onStart?.();
-            setTimeout(() => {
-                setIsAnimating(false);
-                setProgress(1);
-                onComplete?.();
-            }, duration);
+    }, [observerCallback, threshold, rootMargin]);
+    // 모션 스타일 생성 - 메모이제이션으로 불필요한 리렌더링 방지
+    const style = useMemo(() => {
+        const baseTransition = 'all 700ms ease-out';
+        if (!isVisible) {
+            switch (motionType) {
+                case 'fadeIn':
+                    return {
+                        opacity: 0,
+                        transition: baseTransition
+                    };
+                case 'slideUp':
+                    return {
+                        opacity: 0,
+                        transform: 'translateY(32px)',
+                        transition: baseTransition
+                    };
+                case 'slideLeft':
+                    return {
+                        opacity: 0,
+                        transform: 'translateX(-32px)',
+                        transition: baseTransition
+                    };
+                case 'slideRight':
+                    return {
+                        opacity: 0,
+                        transform: 'translateX(32px)',
+                        transition: baseTransition
+                    };
+                case 'scaleIn':
+                    return {
+                        opacity: 0,
+                        transform: 'scale(0.95)',
+                        transition: baseTransition
+                    };
+                case 'bounceIn':
+                    return {
+                        opacity: 0,
+                        transform: 'scale(0.75)',
+                        transition: baseTransition
+                    };
+                default:
+                    return {
+                        opacity: 0,
+                        transition: baseTransition
+                    };
+            }
         }
-    }, [isRevealed, duration, onStart, onComplete]);
-    // 모션 중단 함수
-    const stop = useCallback(() => {
-        setIsAnimating(false);
-        onStop?.();
-    }, [onStop]);
-    // 모션 리셋 함수
+        // 보이는 상태일 때
+        return {
+            opacity: 1,
+            transform: 'none',
+            transition: baseTransition
+        };
+    }, [isVisible, motionType]);
+    const start = useCallback(() => {
+        setIsAnimating(true);
+        setTimeout(() => {
+            setIsVisible(true);
+            setProgress(1);
+            setIsAnimating(false);
+        }, delay);
+    }, [delay]);
     const reset = useCallback(() => {
-        setIsRevealed(false);
+        setIsVisible(false);
         setIsAnimating(false);
         setProgress(0);
-        onReset?.();
-    }, [onReset]);
-    // 모션 일시정지 함수
-    const pause = useCallback(() => {
+        setHasTriggered(false);
+    }, []);
+    const stop = 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,
+        isVisible,
         isAnimating,
-        style,
         progress,
+        style,
         start,
-        stop,
         reset,
-        pause,
-        resume
+        stop
     };
 }
 //# sourceMappingURL=useScrollReveal.js.map

package/dist/hooks/useScrollReveal.js.map

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

package/dist/hooks/useSimplePageMotion.d.ts

@@ -0,0 +1,29 @@
+import type { PageType, PageMotionsConfig, MotionRef } from '../types';
+/**
+ * 1단계 API: 프리셋 기반 페이지 모션 (기존 방식)
+ *
+ * 사용법:
+ * ```typescript
+ * const motions = useSimplePageMotion('home')
+ * ```
+ *
+ * 지원하는 페이지 타입:
+ * - 'home': 홈페이지
+ * - 'dashboard': 대시보드
+ * - 'product': 제품 페이지
+ * - 'blog': 블로그
+ */
+export declare function useSimplePageMotion(pageType: PageType): Record<string, MotionRef<HTMLElement>>;
+/**
+ * 커스텀 페이지 모션 설정
+ *
+ * 사용법:
+ * ```typescript
+ * const motions = useCustomPageMotion({
+ *   hero: { type: 'hero' },
+ *   title: { type: 'title' }
+ * })
+ * ```
+ */
+export declare function useCustomPageMotion(config: PageMotionsConfig): Record<string, MotionRef<HTMLElement>>;
+//# sourceMappingURL=useSimplePageMotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSimplePageMotion.d.ts","sourceRoot":"","sources":["../../src/hooks/useSimplePageMotion.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAqB,SAAS,EAAE,MAAM,UAAU,CAAA;AAGzF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,0CAGrD;AAwID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,0CAE5D"}

package/dist/hooks/useSimplePageMotion.js

@@ -0,0 +1,145 @@
+// ========================================
+// 1단계: useSimplePageMotion (프리셋 기반) - 기존 방식
+// ========================================
+import { useRef, useEffect, useState, useCallback } from 'react';
+import { getPagePreset, getMotionPreset, mergeWithPreset } from '../presets';
+/**
+ * 1단계 API: 프리셋 기반 페이지 모션 (기존 방식)
+ *
+ * 사용법:
+ * ```typescript
+ * const motions = useSimplePageMotion('home')
+ * ```
+ *
+ * 지원하는 페이지 타입:
+ * - 'home': 홈페이지
+ * - 'dashboard': 대시보드
+ * - 'product': 제품 페이지
+ * - 'blog': 블로그
+ */
+export function useSimplePageMotion(pageType) {
+    const config = getPagePreset(pageType);
+    return useSimplePageMotions(config);
+}
+/**
+ * 1단계 내부 구현: 간단한 페이지 모션 (상태 관리자 없음)
+ */
+function useSimplePageMotions(config) {
+    const [motions, setMotions] = useState(new Map());
+    const observersRef = useRef(new Map());
+    // 모션 값 계산
+    const calculateMotionValues = useCallback((isVisible, elementConfig) => {
+        const preset = getMotionPreset(elementConfig.type);
+        const mergedConfig = mergeWithPreset(preset, elementConfig);
+        let opacity = isVisible ? 1 : 0;
+        let translateY = isVisible ? 0 : 20;
+        let translateX = 0;
+        let scale = isVisible ? 1 : 0.95;
+        return { opacity, translateY, translateX, scale };
+    }, []);
+    // 모션 초기화
+    useEffect(() => {
+        const newMotions = new Map();
+        Object.entries(config).forEach(([elementId, elementConfig]) => {
+            const ref = { current: null };
+            const { opacity, translateY, translateX, scale } = calculateMotionValues(false, elementConfig);
+            newMotions.set(elementId, {
+                ref,
+                style: {
+                    opacity,
+                    transform: `translate(${translateX}px, ${translateY}px) scale(${scale})`,
+                    transition: `all ${elementConfig.duration || 700}ms ease-out`,
+                    pointerEvents: 'auto',
+                    willChange: 'transform, opacity'
+                },
+                isVisible: false,
+                isHovered: false,
+                isClicked: false
+            });
+        });
+        setMotions(newMotions);
+    }, [config, calculateMotionValues]);
+    // Intersection Observer 설정
+    useEffect(() => {
+        const visibleElements = new Set();
+        Object.entries(config).forEach(([elementId, elementConfig]) => {
+            const observer = new IntersectionObserver((entries) => {
+                entries.forEach(entry => {
+                    if (entry.isIntersecting && !visibleElements.has(elementId)) {
+                        visibleElements.add(elementId);
+                        // 프리셋의 delay를 적용하여 모션 실행
+                        const preset = getMotionPreset(elementConfig.type);
+                        const mergedConfig = mergeWithPreset(preset, elementConfig);
+                        const delay = mergedConfig.delay || 0;
+                        setTimeout(() => {
+                            const { opacity, translateY, translateX, scale } = calculateMotionValues(true, elementConfig);
+                            setMotions(prev => {
+                                const current = prev.get(elementId);
+                                if (!current)
+                                    return prev;
+                                const newMotion = {
+                                    ...current,
+                                    style: {
+                                        ...current.style,
+                                        opacity,
+                                        transform: `translate(${translateX}px, ${translateY}px) scale(${scale})`
+                                    },
+                                    isVisible: true
+                                };
+                                const newMap = new Map(prev);
+                                newMap.set(elementId, newMotion);
+                                return newMap;
+                            });
+                            if (process.env.NODE_ENV === 'development') {
+                                console.log('모션 실행:', elementId, 'delay:', delay);
+                            }
+                        }, delay);
+                        observer.unobserve(entry.target);
+                    }
+                });
+            }, { threshold: elementConfig.threshold || 0.1 });
+            observersRef.current.set(elementId, observer);
+        });
+        // DOM이 렌더링된 후 observe 시작
+        const timer = setTimeout(() => {
+            Object.entries(config).forEach(([elementId]) => {
+                const observer = observersRef.current.get(elementId);
+                if (observer) {
+                    const element = document.querySelector(`[data-motion-id="${elementId}"]`);
+                    if (element) {
+                        observer.observe(element);
+                    }
+                }
+            });
+        }, 100);
+        return () => {
+            clearTimeout(timer);
+            observersRef.current.forEach(observer => observer.disconnect());
+            observersRef.current.clear();
+        };
+    }, [config, calculateMotionValues]);
+    // 모션 refs 반환
+    const getMotionRefs = useCallback(() => {
+        const result = {};
+        motions.forEach((motion, elementId) => {
+            result[elementId] = motion;
+        });
+        return result;
+    }, [motions]);
+    return getMotionRefs();
+}
+/**
+ * 커스텀 페이지 모션 설정
+ *
+ * 사용법:
+ * ```typescript
+ * const motions = useCustomPageMotion({
+ *   hero: { type: 'hero' },
+ *   title: { type: 'title' }
+ * })
+ * ```
+ */
+export function useCustomPageMotion(config) {
+    return useSimplePageMotions(config);
+}
+//# sourceMappingURL=useSimplePageMotion.js.map

package/dist/hooks/useSimplePageMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSimplePageMotion.js","sourceRoot":"","sources":["../../src/hooks/useSimplePageMotion.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,4CAA4C;AAC5C,2CAA2C;AAE3C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkB;IACpD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACtC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,MAAyB;IACrD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAyB,IAAI,GAAG,EAAE,CAAC,CAAA;IACzE,MAAM,YAAY,GAAG,MAAM,CAAoC,IAAI,GAAG,EAAE,CAAC,CAAA;IAEzE,UAAU;IACR,MAAM,qBAAqB,GAAG,WAAW,CAAC,CAC1C,SAAkB,EAClB,aAAgC,EAChC,EAAE;QACF,MAAM,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;QAE3D,IAAI,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/B,IAAI,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACnC,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,IAAI,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAEhC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACnD,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS;IACT,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAA;QAE/C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,EAAE;YAC5D,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;YAC7B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC,KAAK,EAAE,aAAoB,CAAC,CAAA;YAE7F,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE;gBAChC,GAAG;gBACH,KAAK,EAAE;oBACL,OAAO;oBACP,SAAS,EAAE,aAAa,UAAU,OAAO,UAAU,aAAa,KAAK,GAAG;oBACxE,UAAU,EAAE,OAAO,aAAa,CAAC,QAAQ,IAAI,GAAG,aAAa;oBAC7D,aAAa,EAAE,MAAM;oBACrB,UAAU,EAAE,oBAAoB;iBACjC;gBACD,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,KAAK;aACjB,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,UAAU,CAAC,UAAU,CAAC,CAAA;IACxB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAA;IAEnC,2BAA2B;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAA;QAEzC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,EAAE;YAC5D,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,EAAE;gBACV,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;oBACtB,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC5D,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;wBAE9B,yBAAyB;wBACzB,MAAM,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;wBAClD,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;wBAC3D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,CAAC,CAAA;wBAErC,UAAU,CAAC,GAAG,EAAE;4BACd,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC,IAAI,EAAE,aAAoB,CAAC,CAAA;4BAEpG,UAAU,CAAC,IAAI,CAAC,EAAE;gCAChB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;gCACnC,IAAI,CAAC,OAAO;oCAAE,OAAO,IAAI,CAAA;gCAEzB,MAAM,SAAS,GAAc;oCAC3B,GAAG,OAAO;oCACV,KAAK,EAAE;wCACL,GAAG,OAAO,CAAC,KAAK;wCAChB,OAAO;wCACP,SAAS,EAAE,aAAa,UAAU,OAAO,UAAU,aAAa,KAAK,GAAG;qCACzE;oCACD,SAAS,EAAE,IAAI;iCAChB,CAAA;gCAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAA;gCAC5B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;gCAChC,OAAO,MAAM,CAAA;4BACf,CAAC,CAAC,CAAA;4BAEF,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gCAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;4BACnD,CAAC;wBACH,CAAC,EAAE,KAAK,CAAC,CAAA;wBAET,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;oBAClC,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC,EACD,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,IAAI,GAAG,EAAE,CAC9C,CAAA;YAED,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;QAEF,yBAAyB;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE;gBAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;gBACpD,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,oBAAoB,SAAS,IAAI,CAAC,CAAA;oBACzE,IAAI,OAAO,EAAE,CAAC;wBACZ,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,EAAE,GAAG,CAAC,CAAA;QAEP,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YAC/D,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QAC9B,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAA;IAEnC,aAAa;IACb,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,MAAM,MAAM,GAA8B,EAAE,CAAA;QAC5C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE;YACpC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAA;QAC5B,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,OAAO,aAAa,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC"}

package/dist/hooks/useSlideLeft.d.ts

@@ -1,3 +1,13 @@
-import { SlideOptions, BaseMotionReturn, MotionElement } from '../types';
-export declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?: SlideOptions): BaseMotionReturn<T>;
+import { BaseMotionReturn, MotionElement } from '../types';
+export interface SlideLeftOptions {
+    distance?: number;
+    duration?: number;
+    delay?: number;
+    autoStart?: boolean;
+    easing?: string;
+}
+export declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?: SlideLeftOptions): BaseMotionReturn<T> & {
+    translateX: number;
+    opacity: number;
+};
 //# sourceMappingURL=useSlideLeft.d.ts.map