@hua-labs/motion-core 2.4.0 → 2.4.2

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import { P as PageType, a as PageMotionRef, b as PageMotionsConfig, B as BaseMotionOptions, E as EntranceType, M as MotionElement, c as BaseMotionReturn, F as FadeInOptions, S as SlideOptions, d as ScaleOptions, e as BounceOptions, f as PulseOptions, g as SpringOptions, G as GradientOptions, H as HoverMotionOptions, h as ScrollRevealOptions, R as RepeatOptions, T as ToggleMotionOptions, I as InteractionReturn, i as InViewOptions, j as InViewReturn, k as MouseOptions, l as MouseReturn, m as ReducedMotionReturn, W as WindowSizeOptions, n as WindowSizeReturn, o as ScrollRevealMotionType } from './springPhysics-DLyZ4nbx.mjs';
-export { p as BuiltInProfileName, D as DeepPartial, q as EasingFunction, r as EasingType, s as GestureConfig, t as GestureOptions, u as MOTION_PRESETS, v as MotionCallback, w as MotionConfig, x as MotionDirection, y as MotionEasing, z as MotionEngine, A as MotionFrame, C as MotionInstance, J as MotionOptions, K as MotionPreset, L as MotionProfile, N as MotionProfileBase, O as MotionProfileEntrance, Q as MotionProfileInteraction, U as MotionProfileProvider, V as MotionProfileProviderProps, X as MotionProfileSpring, Y as MotionProfileStagger, Z as MotionProgressCallback, _ as MotionState, $ as MotionStateCallback, a0 as MotionTrigger, a1 as MotionType, a2 as OrchestrationConfig, a3 as PAGE_MOTIONS, a4 as PageMotionElement, a5 as PerformanceMetrics, a6 as PresetConfig, a7 as ReducedMotionStrategy, a8 as SpringConfig, a9 as SpringPhysicsConfig, aa as SpringResult, ab as TransitionEffects, ac as TransitionOptions, ad as TransitionType, ae as applyEasing, af as calculateSpring, ag as easeIn, ah as easeInOut, ai as easeInOutQuad, aj as easeInQuad, ak as easeOut, al as easeOutQuad, am as easingPresets, an as getAvailableEasings, ao as getEasing, ap as getMotionPreset, aq as getPagePreset, ar as getPresetEasing, as as hua, at as isEasingFunction, au as isValidEasing, av as linear, aw as mergeProfileOverrides, ax as mergeWithPreset, ay as motionEngine, az as neutral, aA as resolveProfile, aB as safeApplyEasing, aC as transitionEffects, aD as useMotionProfile } from './springPhysics-DLyZ4nbx.mjs';
+import { P as PageType, a as PageMotionRef, b as PageMotionsConfig, B as BaseMotionOptions, E as EntranceType, M as MotionElement, c as BaseMotionReturn, F as FadeInOptions, d as EntranceMotionReturn, S as SlideOptions, e as ScaleOptions, f as BounceOptions, g as PulseOptions, h as SpringOptions, G as GradientOptions, H as HoverMotionOptions, i as ScrollRevealOptions, R as RepeatOptions, T as ToggleMotionOptions, I as InteractionReturn, j as InViewOptions, k as InViewReturn, l as MouseOptions, m as MouseReturn, n as ReducedMotionReturn, W as WindowSizeOptions, o as WindowSizeReturn, p as ScrollRevealMotionType } from './springPhysics-BZVRi9PQ.mjs';
+export { A as AutoMotionReturn, q as BuiltInProfileName, D as DeepPartial, r as EasingFunction, s as EasingType, t as GestureConfig, u as GestureOptions, v as MOTION_PRESETS, w as MotionCallback, x as MotionConfig, y as MotionDirection, z as MotionEasing, C as MotionEngine, J as MotionFrame, K as MotionInstance, L as MotionOptions, N as MotionPreset, O as MotionProfile, Q as MotionProfileBase, U as MotionProfileEntrance, V as MotionProfileInteraction, X as MotionProfileProvider, Y as MotionProfileProviderProps, Z as MotionProfileSpring, _ as MotionProfileStagger, $ as MotionProgressCallback, a0 as MotionState, a1 as MotionStateCallback, a2 as MotionTrigger, a3 as MotionType, a4 as ObserverReturn, a5 as OrchestrationConfig, a6 as PAGE_MOTIONS, a7 as PageMotionElement, a8 as PerformanceMetrics, a9 as PresetConfig, aa as ReducedMotionStrategy, ab as SequenceOrchestrationConfig, ac as SpringConfig, ad as SpringPhysicsConfig, ae as SpringResult, af as StyleMotionReturn, ag as ToggleMotionReturn, ah as TransitionEffects, ai as TransitionOptions, aj as TransitionType, ak as applyEasing, al as calculateSpring, am as easeIn, an as easeInOut, ao as easeInOutQuad, ap as easeInQuad, aq as easeOut, ar as easeOutQuad, as as easingPresets, at as getAvailableEasings, au as getEasing, av as getMotionPreset, aw as getPagePreset, ax as getPresetEasing, ay as hua, az as isEasingFunction, aA as isValidEasing, aB as linear, aC as mergeProfileOverrides, aD as mergeWithPreset, aE as motionEngine, aF as neutral, aG as resolveProfile, aH as safeApplyEasing, aI as transitionEffects, aJ as useMotionProfile } from './springPhysics-BZVRi9PQ.mjs';
 import * as react from 'react';
 import react__default, { CSSProperties, RefObject } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * 1단계 API: 프리셋 기반 페이지 모션 (기존 방식)
@@ -99,9 +98,9 @@ interface UseUnifiedMotionOptions extends Omit<BaseMotionOptions, 'autoStart'> {
 }
 declare function useUnifiedMotion<T extends MotionElement = HTMLDivElement>(options: UseUnifiedMotionOptions): BaseMotionReturn<T>;
 
-declare function useFadeIn<T extends MotionElement = HTMLDivElement>(options?: FadeInOptions): BaseMotionReturn<T>;
+declare function useFadeIn<T extends MotionElement = HTMLDivElement>(options?: FadeInOptions): EntranceMotionReturn<T>;
 
-declare function useSlideUp<T extends MotionElement = HTMLDivElement>(options?: SlideOptions): BaseMotionReturn<T>;
+declare function useSlideUp<T extends MotionElement = HTMLDivElement>(options?: SlideOptions): EntranceMotionReturn<T>;
 
 /**
  * useSlideLeft - 오른쪽에서 왼쪽으로 슬라이드하며 나타나는 애니메이션 훅
@@ -120,7 +119,7 @@ declare function useSlideUp<T extends MotionElement = HTMLDivElement>(options?:
  * );
  * ```
  */
-declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, 'direction'>): BaseMotionReturn<T>;
+declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, "direction">): EntranceMotionReturn<T>;
 
 /**
  * useSlideRight - 왼쪽에서 오른쪽으로 슬라이드하며 나타나는 애니메이션 훅
@@ -139,11 +138,11 @@ declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?
  * );
  * ```
  */
-declare function useSlideRight<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, 'direction'>): BaseMotionReturn<T>;
+declare function useSlideRight<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, "direction">): EntranceMotionReturn<T>;
 
-declare function useScaleIn<T extends MotionElement = HTMLDivElement>(options?: ScaleOptions): BaseMotionReturn<T>;
+declare function useScaleIn<T extends MotionElement = HTMLDivElement>(options?: ScaleOptions): EntranceMotionReturn<T>;
 
-declare function useBounceIn<T extends MotionElement = HTMLDivElement>(options?: BounceOptions): BaseMotionReturn<T>;
+declare function useBounceIn<T extends MotionElement = HTMLDivElement>(options?: BounceOptions): EntranceMotionReturn<T>;
 
 declare function usePulse<T extends MotionElement = HTMLDivElement>(options?: PulseOptions): BaseMotionReturn<T>;
 
@@ -287,7 +286,7 @@ declare function useToggleMotion<T extends MotionElement = HTMLDivElement>(optio
  * );
  * ```
  */
-declare function useSlideDown<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, 'direction'>): BaseMotionReturn<T>;
+declare function useSlideDown<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, "direction">): EntranceMotionReturn<T>;
 
 /**
  * useInView - 요소의 뷰포트 가시성 감지 훅
@@ -348,9 +347,11 @@ declare function useMouse(options?: MouseOptions): MouseReturn;
  * Detects user's prefers-reduced-motion setting.
  * Used to reduce or disable motion for accessibility.
  *
+ * @returns {boolean} 모션 감소 선호 여부 / Whether reduced motion is preferred
+ *
  * @example
  * ```tsx
- * const { prefersReducedMotion } = useReducedMotion()
+ * const prefersReducedMotion = useReducedMotion()
  *
  * return (
  *   <motion.div
@@ -362,7 +363,19 @@ declare function useMouse(options?: MouseOptions): MouseReturn;
  * )
  * ```
  */
-declare function useReducedMotion(): ReducedMotionReturn;
+declare function useReducedMotion(): boolean;
+/**
+ * useReducedMotionObject - 객체 형태 반환 (backwards compat)
+ * Returns `{ prefersReducedMotion: boolean }` for backwards compatibility.
+ *
+ * @deprecated Use `useReducedMotion()` which returns `boolean` directly.
+ *
+ * @example
+ * ```tsx
+ * const { prefersReducedMotion } = useReducedMotionObject()
+ * ```
+ */
+declare function useReducedMotionObject(): ReducedMotionReturn;
 
 /**
  * useWindowSize - 윈도우 크기 추적 훅
@@ -1069,14 +1082,21 @@ interface OrchestrationReturn {
 }
 declare function useOrchestration(options?: OrchestrationConfig): OrchestrationReturn;
 
+/** The subset of BaseMotionReturn that useSequence actually consumes. */
+type SequenceMotionResult = Pick<BaseMotionReturn<MotionElement>, "start" | "stop" | "reset" | "ref"> & {
+    pause?: () => void;
+    resume?: () => void;
+};
 interface SequenceConfig {
     autoStart?: boolean;
     loop?: boolean;
 }
+/** @deprecated Use useOrchestration or useMotionOrchestra instead. */
 interface SequenceItem {
-    hook: () => any;
+    hook: () => SequenceMotionResult;
     delay?: number;
 }
+/** @deprecated Use useOrchestration or useMotionOrchestra instead. */
 declare function useSequence(sequence: SequenceItem[], options?: SequenceConfig): {
     start: () => void;
     stop: () => void;
@@ -1086,7 +1106,7 @@ declare function useSequence(sequence: SequenceItem[], options?: SequenceConfig)
     isPlaying: boolean;
     currentIndex: number;
     totalMotions: number;
-    ref: any;
+    ref: react.RefObject<MotionElement | null>;
 };
 
 interface LayoutMotionConfig {
@@ -1411,7 +1431,7 @@ interface MotionProps extends react__default.HTMLAttributes<HTMLElement> {
  * // 커스텀 요소 + 타입
  * <Motion as="section" type="slideUp" duration={800}>...</Motion>
  */
-declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react_jsx_runtime.JSX.Element;
+declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react__default.JSX.Element;
 
 interface CountUpOptions {
     /** 목표 숫자 */
@@ -1555,4 +1575,4 @@ interface UseStaggerReturn {
  */
 declare function useStagger(options: UseStaggerOptions): UseStaggerReturn;
 
-export { type AutoFadeConfig, type AutoMotionConfig, type AutoPlayConfig, type AutoScaleConfig, type AutoSlideConfig, BaseMotionOptions, BaseMotionReturn, type BlurInOptions, type BlurInReturn, BounceOptions, type ButtonEffectOptions, type CardListOptions, type ClipRevealOptions, type ClipRevealReturn, type CountUpOptions, type CountUpReturn, type CustomCursorOptions, type CustomCursorReturn, type ElementProgressOptions, type ElementProgressReturn, EntranceType, FadeInOptions, type GameLoopConfig, type GameState, GradientOptions, HoverMotionOptions, InViewOptions, InViewReturn, InteractionReturn, type InteractiveConfig, type InteractiveState, type KeyboardToggleConfig, type LanguageConfig, type LayoutMotionConfig, type LayoutState, type LoadingSpinnerOptions, type MagneticCursorOptions, type MagneticCursorReturn, Motion, type MotionEffects, MotionElement, type MotionFromToConfig, type MotionProps, MouseOptions, MouseReturn, type NavigationOptions, PageMotionRef, PageMotionsConfig, PageType, type PerformanceMonitorConfig, type PerformanceMonitorState, PulseOptions, ReducedMotionReturn, RepeatOptions, ScaleOptions, type ScrollDirectionConfig, type ScrollPositionToggleConfig, ScrollRevealMotionType, ScrollRevealOptions, type ScrollToggleOptions, type SequenceConfig, type SkeletonOptions, SlideOptions, type SmoothScrollOptions, type SmoothScrollReturn, SpringOptions, type StickyToggleConfig, ToggleMotionOptions, type TypewriterOptions, type TypewriterReturn, type MotionConfig as UseMotionConfig, type OrchestrationConfig as UseOrchestrationConfig, type UseStaggerOptions, type UseStaggerReturn, type UseUnifiedMotionOptions, type ViewportToggleConfig, type VisibilityToggleOptions, WindowSizeOptions, WindowSizeReturn, createLayoutTransition, observeElement, useAutoFade, useAutoPlay, useAutoScale, useAutoSlide, useBlurIn, useBounceIn, useButtonEffect, useCardList, useClickToggle, useClipReveal, useCountUp, useCustomCursor, useElementProgress, useFadeIn, useFocusToggle, useGameLoop, useGesture, useGestureMotion, useGradient, useHoverMotion, useInView, useInteractive, useKeyboardToggle, useLanguageAwareMotion, useLayoutMotion, useLoadingSpinner, useMagneticCursor, useMotion, useMotionOrchestra, useMotionState, useMouse, useNavigation, useOrchestration, usePageMotions, usePerformanceMonitor, usePulse, useReducedMotion, useRepeat, useScaleIn, useScrollDirection, useScrollPositionToggle, useScrollProgress, useScrollReveal, useScrollToggle, useSequence, useSimplePageMotion, useSkeleton, useSlideDown, useSlideLeft, useSlideRight, useSlideUp, useSmartMotion, useSmoothScroll, useSpringMotion, useStagger, useStickyToggle, useToggleMotion, useTypewriter, useUnifiedMotion, useViewportToggle, useVisibilityToggle, useWindowSize };
+export { type AutoFadeConfig, type AutoMotionConfig, type AutoPlayConfig, type AutoScaleConfig, type AutoSlideConfig, BaseMotionOptions, BaseMotionReturn, type BlurInOptions, type BlurInReturn, BounceOptions, type ButtonEffectOptions, type CardListOptions, type ClipRevealOptions, type ClipRevealReturn, type CountUpOptions, type CountUpReturn, type CustomCursorOptions, type CustomCursorReturn, type ElementProgressOptions, type ElementProgressReturn, EntranceMotionReturn, EntranceType, FadeInOptions, type GameLoopConfig, type GameState, GradientOptions, HoverMotionOptions, InViewOptions, InViewReturn, InteractionReturn, type InteractiveConfig, type InteractiveState, type KeyboardToggleConfig, type LanguageConfig, type LayoutMotionConfig, type LayoutState, type LoadingSpinnerOptions, type MagneticCursorOptions, type MagneticCursorReturn, Motion, type MotionEffects, MotionElement, type MotionFromToConfig, type MotionProps, MouseOptions, MouseReturn, type NavigationOptions, PageMotionRef, PageMotionsConfig, PageType, type PerformanceMonitorConfig, type PerformanceMonitorState, PulseOptions, ReducedMotionReturn, RepeatOptions, ScaleOptions, type ScrollDirectionConfig, type ScrollPositionToggleConfig, ScrollRevealMotionType, ScrollRevealOptions, type ScrollToggleOptions, type SequenceConfig, type SkeletonOptions, SlideOptions, type SmoothScrollOptions, type SmoothScrollReturn, SpringOptions, type StickyToggleConfig, ToggleMotionOptions, type TypewriterOptions, type TypewriterReturn, type MotionConfig as UseMotionConfig, type OrchestrationConfig as UseOrchestrationConfig, type UseStaggerOptions, type UseStaggerReturn, type UseUnifiedMotionOptions, type ViewportToggleConfig, type VisibilityToggleOptions, WindowSizeOptions, WindowSizeReturn, createLayoutTransition, observeElement, useAutoFade, useAutoPlay, useAutoScale, useAutoSlide, useBlurIn, useBounceIn, useButtonEffect, useCardList, useClickToggle, useClipReveal, useCountUp, useCustomCursor, useElementProgress, useFadeIn, useFocusToggle, useGameLoop, useGesture, useGestureMotion, useGradient, useHoverMotion, useInView, useInteractive, useKeyboardToggle, useLanguageAwareMotion, useLayoutMotion, useLoadingSpinner, useMagneticCursor, useMotion, useMotionOrchestra, useMotionState, useMouse, useNavigation, useOrchestration, usePageMotions, usePerformanceMonitor, usePulse, useReducedMotion, useReducedMotionObject, useRepeat, useScaleIn, useScrollDirection, useScrollPositionToggle, useScrollProgress, useScrollReveal, useScrollToggle, useSequence, useSimplePageMotion, useSkeleton, useSlideDown, useSlideLeft, useSlideRight, useSlideUp, useSmartMotion, useSmoothScroll, useSpringMotion, useStagger, useStickyToggle, useToggleMotion, useTypewriter, useUnifiedMotion, useViewportToggle, useVisibilityToggle, useWindowSize };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import { P as PageType, a as PageMotionRef, b as PageMotionsConfig, B as BaseMotionOptions, E as EntranceType, M as MotionElement, c as BaseMotionReturn, F as FadeInOptions, S as SlideOptions, d as ScaleOptions, e as BounceOptions, f as PulseOptions, g as SpringOptions, G as GradientOptions, H as HoverMotionOptions, h as ScrollRevealOptions, R as RepeatOptions, T as ToggleMotionOptions, I as InteractionReturn, i as InViewOptions, j as InViewReturn, k as MouseOptions, l as MouseReturn, m as ReducedMotionReturn, W as WindowSizeOptions, n as WindowSizeReturn, o as ScrollRevealMotionType } from './springPhysics-DLyZ4nbx.js';
-export { p as BuiltInProfileName, D as DeepPartial, q as EasingFunction, r as EasingType, s as GestureConfig, t as GestureOptions, u as MOTION_PRESETS, v as MotionCallback, w as MotionConfig, x as MotionDirection, y as MotionEasing, z as MotionEngine, A as MotionFrame, C as MotionInstance, J as MotionOptions, K as MotionPreset, L as MotionProfile, N as MotionProfileBase, O as MotionProfileEntrance, Q as MotionProfileInteraction, U as MotionProfileProvider, V as MotionProfileProviderProps, X as MotionProfileSpring, Y as MotionProfileStagger, Z as MotionProgressCallback, _ as MotionState, $ as MotionStateCallback, a0 as MotionTrigger, a1 as MotionType, a2 as OrchestrationConfig, a3 as PAGE_MOTIONS, a4 as PageMotionElement, a5 as PerformanceMetrics, a6 as PresetConfig, a7 as ReducedMotionStrategy, a8 as SpringConfig, a9 as SpringPhysicsConfig, aa as SpringResult, ab as TransitionEffects, ac as TransitionOptions, ad as TransitionType, ae as applyEasing, af as calculateSpring, ag as easeIn, ah as easeInOut, ai as easeInOutQuad, aj as easeInQuad, ak as easeOut, al as easeOutQuad, am as easingPresets, an as getAvailableEasings, ao as getEasing, ap as getMotionPreset, aq as getPagePreset, ar as getPresetEasing, as as hua, at as isEasingFunction, au as isValidEasing, av as linear, aw as mergeProfileOverrides, ax as mergeWithPreset, ay as motionEngine, az as neutral, aA as resolveProfile, aB as safeApplyEasing, aC as transitionEffects, aD as useMotionProfile } from './springPhysics-DLyZ4nbx.js';
+import { P as PageType, a as PageMotionRef, b as PageMotionsConfig, B as BaseMotionOptions, E as EntranceType, M as MotionElement, c as BaseMotionReturn, F as FadeInOptions, d as EntranceMotionReturn, S as SlideOptions, e as ScaleOptions, f as BounceOptions, g as PulseOptions, h as SpringOptions, G as GradientOptions, H as HoverMotionOptions, i as ScrollRevealOptions, R as RepeatOptions, T as ToggleMotionOptions, I as InteractionReturn, j as InViewOptions, k as InViewReturn, l as MouseOptions, m as MouseReturn, n as ReducedMotionReturn, W as WindowSizeOptions, o as WindowSizeReturn, p as ScrollRevealMotionType } from './springPhysics-BZVRi9PQ.js';
+export { A as AutoMotionReturn, q as BuiltInProfileName, D as DeepPartial, r as EasingFunction, s as EasingType, t as GestureConfig, u as GestureOptions, v as MOTION_PRESETS, w as MotionCallback, x as MotionConfig, y as MotionDirection, z as MotionEasing, C as MotionEngine, J as MotionFrame, K as MotionInstance, L as MotionOptions, N as MotionPreset, O as MotionProfile, Q as MotionProfileBase, U as MotionProfileEntrance, V as MotionProfileInteraction, X as MotionProfileProvider, Y as MotionProfileProviderProps, Z as MotionProfileSpring, _ as MotionProfileStagger, $ as MotionProgressCallback, a0 as MotionState, a1 as MotionStateCallback, a2 as MotionTrigger, a3 as MotionType, a4 as ObserverReturn, a5 as OrchestrationConfig, a6 as PAGE_MOTIONS, a7 as PageMotionElement, a8 as PerformanceMetrics, a9 as PresetConfig, aa as ReducedMotionStrategy, ab as SequenceOrchestrationConfig, ac as SpringConfig, ad as SpringPhysicsConfig, ae as SpringResult, af as StyleMotionReturn, ag as ToggleMotionReturn, ah as TransitionEffects, ai as TransitionOptions, aj as TransitionType, ak as applyEasing, al as calculateSpring, am as easeIn, an as easeInOut, ao as easeInOutQuad, ap as easeInQuad, aq as easeOut, ar as easeOutQuad, as as easingPresets, at as getAvailableEasings, au as getEasing, av as getMotionPreset, aw as getPagePreset, ax as getPresetEasing, ay as hua, az as isEasingFunction, aA as isValidEasing, aB as linear, aC as mergeProfileOverrides, aD as mergeWithPreset, aE as motionEngine, aF as neutral, aG as resolveProfile, aH as safeApplyEasing, aI as transitionEffects, aJ as useMotionProfile } from './springPhysics-BZVRi9PQ.js';
 import * as react from 'react';
 import react__default, { CSSProperties, RefObject } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * 1단계 API: 프리셋 기반 페이지 모션 (기존 방식)
@@ -99,9 +98,9 @@ interface UseUnifiedMotionOptions extends Omit<BaseMotionOptions, 'autoStart'> {
 }
 declare function useUnifiedMotion<T extends MotionElement = HTMLDivElement>(options: UseUnifiedMotionOptions): BaseMotionReturn<T>;
 
-declare function useFadeIn<T extends MotionElement = HTMLDivElement>(options?: FadeInOptions): BaseMotionReturn<T>;
+declare function useFadeIn<T extends MotionElement = HTMLDivElement>(options?: FadeInOptions): EntranceMotionReturn<T>;
 
-declare function useSlideUp<T extends MotionElement = HTMLDivElement>(options?: SlideOptions): BaseMotionReturn<T>;
+declare function useSlideUp<T extends MotionElement = HTMLDivElement>(options?: SlideOptions): EntranceMotionReturn<T>;
 
 /**
  * useSlideLeft - 오른쪽에서 왼쪽으로 슬라이드하며 나타나는 애니메이션 훅
@@ -120,7 +119,7 @@ declare function useSlideUp<T extends MotionElement = HTMLDivElement>(options?:
  * );
  * ```
  */
-declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, 'direction'>): BaseMotionReturn<T>;
+declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, "direction">): EntranceMotionReturn<T>;
 
 /**
  * useSlideRight - 왼쪽에서 오른쪽으로 슬라이드하며 나타나는 애니메이션 훅
@@ -139,11 +138,11 @@ declare function useSlideLeft<T extends MotionElement = HTMLDivElement>(options?
  * );
  * ```
  */
-declare function useSlideRight<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, 'direction'>): BaseMotionReturn<T>;
+declare function useSlideRight<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, "direction">): EntranceMotionReturn<T>;
 
-declare function useScaleIn<T extends MotionElement = HTMLDivElement>(options?: ScaleOptions): BaseMotionReturn<T>;
+declare function useScaleIn<T extends MotionElement = HTMLDivElement>(options?: ScaleOptions): EntranceMotionReturn<T>;
 
-declare function useBounceIn<T extends MotionElement = HTMLDivElement>(options?: BounceOptions): BaseMotionReturn<T>;
+declare function useBounceIn<T extends MotionElement = HTMLDivElement>(options?: BounceOptions): EntranceMotionReturn<T>;
 
 declare function usePulse<T extends MotionElement = HTMLDivElement>(options?: PulseOptions): BaseMotionReturn<T>;
 
@@ -287,7 +286,7 @@ declare function useToggleMotion<T extends MotionElement = HTMLDivElement>(optio
  * );
  * ```
  */
-declare function useSlideDown<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, 'direction'>): BaseMotionReturn<T>;
+declare function useSlideDown<T extends MotionElement = HTMLDivElement>(options?: Omit<SlideOptions, "direction">): EntranceMotionReturn<T>;
 
 /**
  * useInView - 요소의 뷰포트 가시성 감지 훅
@@ -348,9 +347,11 @@ declare function useMouse(options?: MouseOptions): MouseReturn;
  * Detects user's prefers-reduced-motion setting.
  * Used to reduce or disable motion for accessibility.
  *
+ * @returns {boolean} 모션 감소 선호 여부 / Whether reduced motion is preferred
+ *
  * @example
  * ```tsx
- * const { prefersReducedMotion } = useReducedMotion()
+ * const prefersReducedMotion = useReducedMotion()
  *
  * return (
  *   <motion.div
@@ -362,7 +363,19 @@ declare function useMouse(options?: MouseOptions): MouseReturn;
  * )
  * ```
  */
-declare function useReducedMotion(): ReducedMotionReturn;
+declare function useReducedMotion(): boolean;
+/**
+ * useReducedMotionObject - 객체 형태 반환 (backwards compat)
+ * Returns `{ prefersReducedMotion: boolean }` for backwards compatibility.
+ *
+ * @deprecated Use `useReducedMotion()` which returns `boolean` directly.
+ *
+ * @example
+ * ```tsx
+ * const { prefersReducedMotion } = useReducedMotionObject()
+ * ```
+ */
+declare function useReducedMotionObject(): ReducedMotionReturn;
 
 /**
  * useWindowSize - 윈도우 크기 추적 훅
@@ -1069,14 +1082,21 @@ interface OrchestrationReturn {
 }
 declare function useOrchestration(options?: OrchestrationConfig): OrchestrationReturn;
 
+/** The subset of BaseMotionReturn that useSequence actually consumes. */
+type SequenceMotionResult = Pick<BaseMotionReturn<MotionElement>, "start" | "stop" | "reset" | "ref"> & {
+    pause?: () => void;
+    resume?: () => void;
+};
 interface SequenceConfig {
     autoStart?: boolean;
     loop?: boolean;
 }
+/** @deprecated Use useOrchestration or useMotionOrchestra instead. */
 interface SequenceItem {
-    hook: () => any;
+    hook: () => SequenceMotionResult;
     delay?: number;
 }
+/** @deprecated Use useOrchestration or useMotionOrchestra instead. */
 declare function useSequence(sequence: SequenceItem[], options?: SequenceConfig): {
     start: () => void;
     stop: () => void;
@@ -1086,7 +1106,7 @@ declare function useSequence(sequence: SequenceItem[], options?: SequenceConfig)
     isPlaying: boolean;
     currentIndex: number;
     totalMotions: number;
-    ref: any;
+    ref: react.RefObject<MotionElement | null>;
 };
 
 interface LayoutMotionConfig {
@@ -1411,7 +1431,7 @@ interface MotionProps extends react__default.HTMLAttributes<HTMLElement> {
  * // 커스텀 요소 + 타입
  * <Motion as="section" type="slideUp" duration={800}>...</Motion>
  */
-declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react_jsx_runtime.JSX.Element;
+declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react__default.JSX.Element;
 
 interface CountUpOptions {
     /** 목표 숫자 */
@@ -1555,4 +1575,4 @@ interface UseStaggerReturn {
  */
 declare function useStagger(options: UseStaggerOptions): UseStaggerReturn;
 
-export { type AutoFadeConfig, type AutoMotionConfig, type AutoPlayConfig, type AutoScaleConfig, type AutoSlideConfig, BaseMotionOptions, BaseMotionReturn, type BlurInOptions, type BlurInReturn, BounceOptions, type ButtonEffectOptions, type CardListOptions, type ClipRevealOptions, type ClipRevealReturn, type CountUpOptions, type CountUpReturn, type CustomCursorOptions, type CustomCursorReturn, type ElementProgressOptions, type ElementProgressReturn, EntranceType, FadeInOptions, type GameLoopConfig, type GameState, GradientOptions, HoverMotionOptions, InViewOptions, InViewReturn, InteractionReturn, type InteractiveConfig, type InteractiveState, type KeyboardToggleConfig, type LanguageConfig, type LayoutMotionConfig, type LayoutState, type LoadingSpinnerOptions, type MagneticCursorOptions, type MagneticCursorReturn, Motion, type MotionEffects, MotionElement, type MotionFromToConfig, type MotionProps, MouseOptions, MouseReturn, type NavigationOptions, PageMotionRef, PageMotionsConfig, PageType, type PerformanceMonitorConfig, type PerformanceMonitorState, PulseOptions, ReducedMotionReturn, RepeatOptions, ScaleOptions, type ScrollDirectionConfig, type ScrollPositionToggleConfig, ScrollRevealMotionType, ScrollRevealOptions, type ScrollToggleOptions, type SequenceConfig, type SkeletonOptions, SlideOptions, type SmoothScrollOptions, type SmoothScrollReturn, SpringOptions, type StickyToggleConfig, ToggleMotionOptions, type TypewriterOptions, type TypewriterReturn, type MotionConfig as UseMotionConfig, type OrchestrationConfig as UseOrchestrationConfig, type UseStaggerOptions, type UseStaggerReturn, type UseUnifiedMotionOptions, type ViewportToggleConfig, type VisibilityToggleOptions, WindowSizeOptions, WindowSizeReturn, createLayoutTransition, observeElement, useAutoFade, useAutoPlay, useAutoScale, useAutoSlide, useBlurIn, useBounceIn, useButtonEffect, useCardList, useClickToggle, useClipReveal, useCountUp, useCustomCursor, useElementProgress, useFadeIn, useFocusToggle, useGameLoop, useGesture, useGestureMotion, useGradient, useHoverMotion, useInView, useInteractive, useKeyboardToggle, useLanguageAwareMotion, useLayoutMotion, useLoadingSpinner, useMagneticCursor, useMotion, useMotionOrchestra, useMotionState, useMouse, useNavigation, useOrchestration, usePageMotions, usePerformanceMonitor, usePulse, useReducedMotion, useRepeat, useScaleIn, useScrollDirection, useScrollPositionToggle, useScrollProgress, useScrollReveal, useScrollToggle, useSequence, useSimplePageMotion, useSkeleton, useSlideDown, useSlideLeft, useSlideRight, useSlideUp, useSmartMotion, useSmoothScroll, useSpringMotion, useStagger, useStickyToggle, useToggleMotion, useTypewriter, useUnifiedMotion, useViewportToggle, useVisibilityToggle, useWindowSize };
+export { type AutoFadeConfig, type AutoMotionConfig, type AutoPlayConfig, type AutoScaleConfig, type AutoSlideConfig, BaseMotionOptions, BaseMotionReturn, type BlurInOptions, type BlurInReturn, BounceOptions, type ButtonEffectOptions, type CardListOptions, type ClipRevealOptions, type ClipRevealReturn, type CountUpOptions, type CountUpReturn, type CustomCursorOptions, type CustomCursorReturn, type ElementProgressOptions, type ElementProgressReturn, EntranceMotionReturn, EntranceType, FadeInOptions, type GameLoopConfig, type GameState, GradientOptions, HoverMotionOptions, InViewOptions, InViewReturn, InteractionReturn, type InteractiveConfig, type InteractiveState, type KeyboardToggleConfig, type LanguageConfig, type LayoutMotionConfig, type LayoutState, type LoadingSpinnerOptions, type MagneticCursorOptions, type MagneticCursorReturn, Motion, type MotionEffects, MotionElement, type MotionFromToConfig, type MotionProps, MouseOptions, MouseReturn, type NavigationOptions, PageMotionRef, PageMotionsConfig, PageType, type PerformanceMonitorConfig, type PerformanceMonitorState, PulseOptions, ReducedMotionReturn, RepeatOptions, ScaleOptions, type ScrollDirectionConfig, type ScrollPositionToggleConfig, ScrollRevealMotionType, ScrollRevealOptions, type ScrollToggleOptions, type SequenceConfig, type SkeletonOptions, SlideOptions, type SmoothScrollOptions, type SmoothScrollReturn, SpringOptions, type StickyToggleConfig, ToggleMotionOptions, type TypewriterOptions, type TypewriterReturn, type MotionConfig as UseMotionConfig, type OrchestrationConfig as UseOrchestrationConfig, type UseStaggerOptions, type UseStaggerReturn, type UseUnifiedMotionOptions, type ViewportToggleConfig, type VisibilityToggleOptions, WindowSizeOptions, WindowSizeReturn, createLayoutTransition, observeElement, useAutoFade, useAutoPlay, useAutoScale, useAutoSlide, useBlurIn, useBounceIn, useButtonEffect, useCardList, useClickToggle, useClipReveal, useCountUp, useCustomCursor, useElementProgress, useFadeIn, useFocusToggle, useGameLoop, useGesture, useGestureMotion, useGradient, useHoverMotion, useInView, useInteractive, useKeyboardToggle, useLanguageAwareMotion, useLayoutMotion, useLoadingSpinner, useMagneticCursor, useMotion, useMotionOrchestra, useMotionState, useMouse, useNavigation, useOrchestration, usePageMotions, usePerformanceMonitor, usePulse, useReducedMotion, useReducedMotionObject, useRepeat, useScaleIn, useScrollDirection, useScrollPositionToggle, useScrollProgress, useScrollReveal, useScrollToggle, useSequence, useSimplePageMotion, useSkeleton, useSlideDown, useSlideLeft, useSlideRight, useSlideUp, useSmartMotion, useSmoothScroll, useSpringMotion, useStagger, useStickyToggle, useToggleMotion, useTypewriter, useUnifiedMotion, useViewportToggle, useVisibilityToggle, useWindowSize };

package/dist/index.mjs

@@ -942,6 +942,10 @@ function useFadeIn(options = {}) {
     setProgress(0);
     onReset?.();
   }, [stop, onReset]);
+  const pause = useCallback(() => {
+  }, []);
+  const resume = useCallback(() => {
+  }, []);
   useEffect(() => {
     if (!ref.current || !autoStart) return;
     return observeElement(
@@ -958,14 +962,25 @@ function useFadeIn(options = {}) {
       stop();
     };
   }, [stop]);
-  const style = useMemo(() => ({
-    opacity: isVisible ? targetOpacity : initialOpacity,
-    transition: `opacity ${duration}ms ${easing}`,
-    "--motion-delay": `${delay}ms`,
-    "--motion-duration": `${duration}ms`,
-    "--motion-easing": easing,
-    "--motion-progress": `${progress}`
-  }), [isVisible, targetOpacity, initialOpacity, duration, easing, delay, progress]);
+  const style = useMemo(
+    () => ({
+      opacity: isVisible ? targetOpacity : initialOpacity,
+      transition: `opacity ${duration}ms ${easing}`,
+      "--motion-delay": `${delay}ms`,
+      "--motion-duration": `${duration}ms`,
+      "--motion-easing": easing,
+      "--motion-progress": `${progress}`
+    }),
+    [
+      isVisible,
+      targetOpacity,
+      initialOpacity,
+      duration,
+      easing,
+      delay,
+      progress
+    ]
+  );
   return {
     ref,
     isVisible,
@@ -974,7 +989,9 @@ function useFadeIn(options = {}) {
     progress,
     start,
     stop,
-    reset
+    reset,
+    pause,
+    resume
   };
 }
 function useSlideUp(options = {}) {
@@ -1063,6 +1080,10 @@ function useSlideUp(options = {}) {
     setProgress(0);
     onReset?.();
   }, [stop, onReset]);
+  const pause = useCallback(() => {
+  }, []);
+  const resume = useCallback(() => {
+  }, []);
   useEffect(() => {
     if (!ref.current || !autoStart) return;
     return observeElement(
@@ -1079,21 +1100,37 @@ function useSlideUp(options = {}) {
       stop();
     };
   }, [stop]);
-  const initialTransform = useMemo(() => getInitialTransform2(), [getInitialTransform2]);
+  const initialTransform = useMemo(
+    () => getInitialTransform2(),
+    [getInitialTransform2]
+  );
   const finalTransform = useMemo(() => {
     return direction === "left" || direction === "right" ? "translateX(0)" : "translateY(0)";
   }, [direction]);
-  const style = useMemo(() => ({
-    opacity: isVisible ? 1 : 0,
-    transform: isVisible ? finalTransform : initialTransform,
-    transition: `opacity ${duration}ms ${easing}, transform ${duration}ms ${easing}`,
-    "--motion-delay": `${delay}ms`,
-    "--motion-duration": `${duration}ms`,
-    "--motion-easing": easing,
-    "--motion-progress": `${progress}`,
-    "--motion-direction": direction,
-    "--motion-distance": `${distance}px`
-  }), [isVisible, initialTransform, finalTransform, duration, easing, delay, progress, direction, distance]);
+  const style = useMemo(
+    () => ({
+      opacity: isVisible ? 1 : 0,
+      transform: isVisible ? finalTransform : initialTransform,
+      transition: `opacity ${duration}ms ${easing}, transform ${duration}ms ${easing}`,
+      "--motion-delay": `${delay}ms`,
+      "--motion-duration": `${duration}ms`,
+      "--motion-easing": easing,
+      "--motion-progress": `${progress}`,
+      "--motion-direction": direction,
+      "--motion-distance": `${distance}px`
+    }),
+    [
+      isVisible,
+      initialTransform,
+      finalTransform,
+      duration,
+      easing,
+      delay,
+      progress,
+      direction,
+      distance
+    ]
+  );
   return {
     ref,
     isVisible,
@@ -1102,7 +1139,9 @@ function useSlideUp(options = {}) {
     progress,
     start,
     stop,
-    reset
+    reset,
+    pause,
+    resume
   };
 }
 
@@ -1182,6 +1221,10 @@ function useScaleIn(options = {}) {
     }
     onReset?.();
   }, [stop, initialScale, onReset]);
+  const pause = useCallback(() => {
+  }, []);
+  const resume = useCallback(() => {
+  }, []);
   useEffect(() => {
     if (!ref.current || !autoStart) return;
     return observeElement(
@@ -1198,15 +1241,18 @@ function useScaleIn(options = {}) {
       stop();
     };
   }, [stop]);
-  const style = useMemo(() => ({
-    transform: `scale(${scale})`,
-    opacity,
-    transition: `all ${duration}ms ${easing}`,
-    "--motion-delay": `${delay}ms`,
-    "--motion-duration": `${duration}ms`,
-    "--motion-easing": easing,
-    "--motion-progress": `${progress}`
-  }), [scale, opacity, duration, easing, delay, progress]);
+  const style = useMemo(
+    () => ({
+      transform: `scale(${scale})`,
+      opacity,
+      transition: `all ${duration}ms ${easing}`,
+      "--motion-delay": `${delay}ms`,
+      "--motion-duration": `${duration}ms`,
+      "--motion-easing": easing,
+      "--motion-progress": `${progress}`
+    }),
+    [scale, opacity, duration, easing, delay, progress]
+  );
   return {
     ref,
     isVisible,
@@ -1215,7 +1261,9 @@ function useScaleIn(options = {}) {
     progress,
     start,
     reset,
-    stop
+    stop,
+    pause,
+    resume
   };
 }
 function useBounceIn(options = {}) {
@@ -1293,6 +1341,10 @@ function useBounceIn(options = {}) {
     }
     onReset?.();
   }, [stop, onReset]);
+  const pause = useCallback(() => {
+  }, []);
+  const resume = useCallback(() => {
+  }, []);
   useEffect(() => {
     if (!ref.current || !autoStart) return;
     return observeElement(
@@ -1309,15 +1361,18 @@ function useBounceIn(options = {}) {
       stop();
     };
   }, [stop]);
-  const style = useMemo(() => ({
-    transform: `scale(${scale})`,
-    opacity,
-    transition: `all ${duration}ms ${easing}`,
-    "--motion-delay": `${delay}ms`,
-    "--motion-duration": `${duration}ms`,
-    "--motion-easing": easing,
-    "--motion-progress": `${progress}`
-  }), [scale, opacity, duration, easing, delay, progress]);
+  const style = useMemo(
+    () => ({
+      transform: `scale(${scale})`,
+      opacity,
+      transition: `all ${duration}ms ${easing}`,
+      "--motion-delay": `${delay}ms`,
+      "--motion-duration": `${duration}ms`,
+      "--motion-easing": easing,
+      "--motion-progress": `${progress}`
+    }),
+    [scale, opacity, duration, easing, delay, progress]
+  );
   return {
     ref,
     isVisible,
@@ -1326,7 +1381,9 @@ function useBounceIn(options = {}) {
     progress,
     start,
     reset,
-    stop
+    stop,
+    pause,
+    resume
   };
 }
 function usePulse(options = {}) {
@@ -2590,9 +2647,11 @@ function useReducedMotion() {
       mediaQuery.removeEventListener("change", handleChange);
     };
   }, []);
-  return {
-    prefersReducedMotion
-  };
+  return prefersReducedMotion;
+}
+function useReducedMotionObject() {
+  const prefersReducedMotion = useReducedMotion();
+  return { prefersReducedMotion };
 }
 function useWindowSize(options = {}) {
   const {
@@ -6016,8 +6075,7 @@ function useSequence(sequence, options = {}) {
     isPlaying,
     currentIndex,
     totalMotions: sequence.length,
-    ref: motions[0]?.ref || (() => {
-    })
+    ref: motions[0]?.ref ?? { current: null }
     // 첫 번째 모션의 ref 반환
   };
 }
@@ -7339,6 +7397,6 @@ function useStagger(options) {
   };
 }
 
-export { Motion, createLayoutTransition, observeElement, useAutoFade, useAutoPlay, useAutoScale, useAutoSlide, useBlurIn, useBounceIn, useButtonEffect, useCardList, useClickToggle, useClipReveal, useCountUp, useCustomCursor, useElementProgress, useFadeIn, useFocusToggle, useGameLoop, useGesture, useGestureMotion, useGradient, useHoverMotion, useInView, useInteractive, useKeyboardToggle, useLanguageAwareMotion, useLayoutMotion, useLoadingSpinner, useMagneticCursor, useMotion, useMotionOrchestra, useMotionState, useMouse, useNavigation, useOrchestration, usePageMotions, usePerformanceMonitor, usePulse, useReducedMotion, useRepeat, useScaleIn, useScrollDirection, useScrollPositionToggle, useScrollProgress, useScrollReveal, useScrollToggle, useSequence, useSimplePageMotion, useSkeleton, useSlideDown, useSlideLeft, useSlideRight, useSlideUp, useSmartMotion, useSmoothScroll, useSpringMotion, useStagger, useStickyToggle, useToggleMotion, useTypewriter, useUnifiedMotion, useViewportToggle, useVisibilityToggle, useWindowSize };
+export { Motion, createLayoutTransition, observeElement, useAutoFade, useAutoPlay, useAutoScale, useAutoSlide, useBlurIn, useBounceIn, useButtonEffect, useCardList, useClickToggle, useClipReveal, useCountUp, useCustomCursor, useElementProgress, useFadeIn, useFocusToggle, useGameLoop, useGesture, useGestureMotion, useGradient, useHoverMotion, useInView, useInteractive, useKeyboardToggle, useLanguageAwareMotion, useLayoutMotion, useLoadingSpinner, useMagneticCursor, useMotion, useMotionOrchestra, useMotionState, useMouse, useNavigation, useOrchestration, usePageMotions, usePerformanceMonitor, usePulse, useReducedMotion, useReducedMotionObject, useRepeat, useScaleIn, useScrollDirection, useScrollPositionToggle, useScrollProgress, useScrollReveal, useScrollToggle, useSequence, useSimplePageMotion, useSkeleton, useSlideDown, useSlideLeft, useSlideRight, useSlideUp, useSmartMotion, useSmoothScroll, useSpringMotion, useStagger, useStickyToggle, useToggleMotion, useTypewriter, useUnifiedMotion, useViewportToggle, useVisibilityToggle, useWindowSize };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map