@hua-labs/motion-core 2.4.1 → 2.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +113 -115
  2. package/dist/index.d.mts +1 -2
  3. package/dist/index.d.ts +1 -2
  4. package/package.json +6 -6
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @hua-labs/motion-core
2
2
 
3
- A collection of 55+ React animation hooks built on a ref-based engine. Direct DOM manipulation for consistent performance with zero external dependencies. All hooks are TypeScript-native and SSR-compatible. React Native support via dedicated native hooks using the Animated API.
3
+ A collection of 60+ React animation hooks built on a ref-based engine. Direct DOM manipulation for consistent performance with zero external dependencies. All hooks are TypeScript-native and SSR-compatible. React Native support via dedicated native hooks using the Animated API.
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/@hua-labs/motion-core.svg)](https://www.npmjs.com/package/@hua-labs/motion-core)
6
6
  [![npm downloads](https://img.shields.io/npm/dm/@hua-labs/motion-core.svg)](https://www.npmjs.com/package/@hua-labs/motion-core)
@@ -10,13 +10,12 @@ A collection of 55+ React animation hooks built on a ref-based engine. Direct DO
10
10
 
11
11
  ## Features
12
12
 
13
- - **55+ animation hooks — Fade, slide, scale, scroll, interactions, gestures, orchestration**
13
+ - **60+ animation hooks — Fade, slide, scale, scroll, interactions, gestures, orchestration**
14
14
  - **Zero dependencies — Pure JavaScript motion engine**
15
15
  - **Ref-based — Direct DOM manipulation for consistent performance**
16
16
  - **SSR compatible — Works with Next.js, Remix, and SSR frameworks**
17
17
  - **React Native — 10 native hooks via Animated API (separate entry point)**
18
18
  - **Fully tested — Comprehensive test coverage**
19
- - **Pro hooks included — 18 advanced hooks absorbed from @hua-labs/pro (auto-play, orchestration, game loop, and more)**
20
19
 
21
20
  ## Installation
22
21
 
@@ -29,7 +28,7 @@ pnpm add @hua-labs/motion-core
29
28
  ## Quick Start
30
29
 
31
30
  ```tsx
32
- import { useFadeIn, useSlideUp } from "@hua-labs/motion-core";
31
+ import { useFadeIn, useSlideUp } from '@hua-labs/motion-core';
33
32
 
34
33
  function Hero() {
35
34
  const fadeIn = useFadeIn({ duration: 800 });
@@ -37,18 +36,14 @@ function Hero() {
37
36
 
38
37
  return (
39
38
  <div>
40
- <h1 ref={fadeIn.ref} style={fadeIn.style}>
41
- Welcome
42
- </h1>
43
- <p ref={slideUp.ref} style={slideUp.style}>
44
- Animated content
45
- </p>
39
+ <h1 ref={fadeIn.ref} style={fadeIn.style}>Welcome</h1>
40
+ <p ref={slideUp.ref} style={slideUp.style}>Animated content</p>
46
41
  </div>
47
42
  );
48
43
  }
49
44
 
50
45
  // React Native — import from /native
51
- import { useFadeIn, useStagger } from "@hua-labs/motion-core/native";
46
+ import { useFadeIn, useStagger } from '@hua-labs/motion-core/native';
52
47
 
53
48
  function ListItem() {
54
49
  const fadeIn = useFadeIn({ duration: 400 });
@@ -58,114 +53,117 @@ function ListItem() {
58
53
  </Animated.View>
59
54
  );
60
55
  }
56
+
61
57
  ```
62
58
 
63
59
  ## API
64
60
 
65
- | Export | Type | Description |
66
- | -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
67
- | `MotionEngine` | class | Zero-dependency pure JavaScript motion engine class |
68
- | `motionEngine` | variable | Singleton instance of MotionEngine |
69
- | `TransitionEffects` | class | Transition effect system class (fade, slide, scale, etc.) |
70
- | `transitionEffects` | variable | Singleton instance of TransitionEffects |
71
- | `useSimplePageMotion` | hook | Simple fade+slide page entrance animation |
72
- | `usePageMotions` | hook | Multi-element page entrance orchestration |
73
- | `useSmartMotion` | hook | Adaptive motion based on device performance |
74
- | `useUnifiedMotion` | hook | All-in-one motion hook with presets |
75
- | `useFadeIn` | hook | Fade-in animation hook |
76
- | `useSlideUp` | hook | Slide-up entrance animation |
77
- | `useSlideLeft` | hook | Slide-left entrance animation |
78
- | `useSlideRight` | hook | Slide-right entrance animation |
79
- | `useScaleIn` | hook | Scale-in entrance animation |
80
- | `useBounceIn` | hook | Bounce-in entrance animation |
81
- | `usePulse` | hook | Repeating pulse animation |
82
- | `useSpringMotion` | hook | Spring physics animation |
83
- | `useGradient` | hook | Animated gradient background |
84
- | `useHoverMotion` | hook | Hover interaction animation |
85
- | `useClickToggle` | hook | Click-triggered toggle animation |
86
- | `useFocusToggle` | hook | Focus-triggered toggle animation |
87
- | `useScrollReveal` | hook | Scroll-triggered reveal animation |
88
- | `useScrollProgress` | hook | Scroll position as 0-1 progress value |
89
- | `useMotionState` | hook | Animation state tracking (idle, running, complete) |
90
- | `useRepeat` | hook | Repeating animation with configurable count |
91
- | `useToggleMotion` | hook | Toggle between two animation states |
92
- | `useSlideDown` | hook | Slide-down entrance animation |
93
- | `useInView` | hook | IntersectionObserver-based visibility detection |
94
- | `useMouse` | hook | Mouse position tracking |
95
- | `useReducedMotion` | hook | Detect prefers-reduced-motion setting |
96
- | `useWindowSize` | hook | Responsive window size tracking |
97
- | `useGesture` | hook | Multi-gesture handler (drag, swipe, pinch) |
98
- | `useGestureMotion` | hook | Gesture-driven motion animation |
99
- | `useButtonEffect` | hook | Ripple / press feedback effect for buttons |
100
- | `useVisibilityToggle` | hook | Animate an element in/out based on a boolean visibility flag |
101
- | `useScrollToggle` | hook | Toggle animation state based on scroll position threshold |
102
- | `useCardList` | hook | Staggered entrance animation for a list of cards |
103
- | `useLoadingSpinner` | hook | Continuous rotation animation for loading spinners |
104
- | `useNavigation` | hook | Slide/fade animation for navigation transitions |
105
- | `useSkeleton` | hook | Shimmer animation for skeleton loading placeholders |
106
- | `useTypewriter` | hook | Typewriter character-by-character text reveal animation |
107
- | `useCustomCursor` | hook | Custom cursor tracking and animation |
108
- | `useMagneticCursor` | hook | Magnetic cursor attraction effect for interactive elements |
109
- | `useSmoothScroll` | hook | Smooth programmatic scroll with easing |
110
- | `useElementProgress` | hook | Track an element's scroll progress as a 0–1 value |
111
- | `useAutoFade` | hook | Auto-playing opacity animation with repeat, loop, and manual fadeIn/fadeOut controls |
112
- | `useAutoPlay` | hook | Interval-driven step counter with pause-on-hover, pause-on-blur, and repeat controls |
113
- | `useAutoScale` | hook | Auto-playing scale animation with bounce/elastic easing and manual scaleIn/scaleOut controls |
114
- | `useAutoSlide` | hook | Auto-playing translate animation across eight directional presets with repeat and toggle |
115
- | `useMotionOrchestra` | hook | Coordinate multiple named motion steps in sequential, parallel, or stagger playback mode |
116
- | `useOrchestration` | hook | Timeline-based motion orchestration with seek, variable speed, reverse, and per-step callbacks |
117
- | `useSequence` | hook | Run an ordered array of motion hooks one after another with optional delay and loop |
118
- | `useLayoutMotion` | hook | Animate layout properties (width, height, flex, grid) between two style states |
119
- | `useKeyboardToggle` | hook | Toggle a boolean state with configurable key bindings, combos, and optional auto-reset |
120
- | `useScrollDirection` | hook | Detect current scroll direction (up / down / idle) with a configurable threshold |
121
- | `useStickyToggle` | hook | Boolean flag that becomes true once the page scrolls past a given pixel offset |
122
- | `useInteractive` | hook | Scale state machine for hover and click interactions with configurable scale values |
123
- | `usePerformanceMonitor` | hook | Measure real-time FPS via requestAnimationFrame and flag low-performance conditions |
124
- | `useLanguageAwareMotion` | hook | Scroll-reveal animation that pauses or restarts when the active locale changes |
125
- | `useGameLoop` | hook | Fixed-timestep requestAnimationFrame loop with FPS tracking, pause, and update/render callbacks |
126
- | `useMotion` | hook | General-purpose from/to animation hook supporting fade, slide, scale, and rotate presets |
127
- | `useViewportToggle` | hook | IntersectionObserver-based viewport enter/exit detection with once and trigger-mode options (absorbed from @hua-labs/pro; renamed from useVisibilityToggle to avoid collision) |
128
- | `useScrollPositionToggle` | hook | Toggle visibility based on a window.pageYOffset threshold, with a scrollToTop helper (absorbed from @hua-labs/pro; renamed from useScrollToggle to avoid collision) |
129
- | `neutral` | variable | Built-in neutral motion profile (minimal, system-respecting) |
130
- | `hua` | variable | Built-in hua motion profile (expressive, brand-aligned) |
131
- | `resolveProfile` | function | Resolve a built-in profile name or MotionProfile object to a MotionProfile |
132
- | `mergeProfileOverrides` | function | Deep-merge overrides into a base MotionProfile |
133
- | `MotionProfileProvider` | component | React context provider that supplies a MotionProfile to the subtree |
134
- | `useMotionProfile` | hook | Hook to read the current MotionProfile from context |
135
- | `observeElement` | function | Shared IntersectionObserver helper — observe an element and invoke a callback on visibility change |
136
- | `linear` | function | Linear easing (no acceleration) |
137
- | `easeIn` | function | Ease-in curve (slow start) |
138
- | `easeOut` | function | Ease-out curve (slow end) |
139
- | `easeInOut` | function | Smooth ease-in-out curve |
140
- | `getEasing` | function | Get easing function by name |
141
- | `applyEasing` | function | Apply an easing function to a raw progress value (throws on invalid) |
142
- | `safeApplyEasing` | function | Apply an easing function to a progress value, falling back to linear on error |
143
- | `isValidEasing` | function | Check whether a string is a recognised EasingType name |
144
- | `getAvailableEasings` | function | Return the list of all registered easing names |
145
- | `isEasingFunction` | function | Type-guard that checks whether a value is a callable EasingFunction |
146
- | `easingPresets` | variable | Map of named easing preset strings to EasingFunction objects |
147
- | `getPresetEasing` | function | Look up an EasingFunction by preset name |
148
- | `calculateSpring` | function | Pure function that computes spring position/velocity for a given time step |
149
- | `Motion` | component | React wrapper component that applies a motion hook to its child element via ref |
150
- | `useCountUp` | hook | Animated counter that counts up to a target number |
151
- | `useClipReveal` | hook | Clip-path reveal animation (wipe-in effect) |
152
- | `useBlurIn` | hook | Blur-to-clear entrance animation |
153
- | `useStagger` | hook | Orchestrate staggered entrance animations across a list of elements |
154
- | `MOTION_PRESETS` | variable | Built-in preset configurations keyed by element role (hero, title, button, card, text, image) |
155
- | `PAGE_MOTIONS` | variable | Page-level motion configs keyed by page type (home, dashboard, product, blog) |
156
- | `mergeWithPreset` | function | Merge a MotionPreset with custom overrides |
157
- | `getPagePreset` | function | Get PageMotionsConfig for a given PageType |
158
- | `getMotionPreset` | function | Get a MotionPreset by element role string |
159
- | `useFadeIn (native)` | hook | Native fade-in using Animated.timing |
160
- | `useSlideUp (native)` | hook | Native slide-up using Animated.parallel |
161
- | `useSlideDown (native)` | hook | Native slide-down using Animated.parallel |
162
- | `useSlideLeft (native)` | hook | Native slide-left using Animated.parallel |
163
- | `useSlideRight (native)` | hook | Native slide-right using Animated.parallel |
164
- | `useScaleIn (native)` | hook | Native scale-in using Animated.parallel |
165
- | `useBounceIn (native)` | hook | Native bounce-in using Animated.spring |
166
- | `useSpringMotion (native)` | hook | Native generic spring animation with animateTo() |
167
- | `usePulse (native)` | hook | Native looping pulse using Animated.loop |
168
- | `useStagger (native)` | hook | Native staggered list animation using Animated.stagger |
61
+ | Export | Type | Description |
62
+ |--------|------|-------------|
63
+ | `MotionEngine` | class | Zero-dependency pure JavaScript motion engine class |
64
+ | `motionEngine` | variable | Singleton instance of MotionEngine |
65
+ | `TransitionEffects` | class | Transition effect system class (fade, slide, scale, etc.) |
66
+ | `transitionEffects` | variable | Singleton instance of TransitionEffects |
67
+ | `useSimplePageMotion` | hook | Simple fade+slide page entrance animation |
68
+ | `usePageMotions` | hook | Multi-element page entrance orchestration |
69
+ | `useSmartMotion` | hook | Adaptive motion based on device performance |
70
+ | `useUnifiedMotion` | hook | All-in-one motion hook with presets |
71
+ | `useFadeIn` | hook | Fade-in animation hook |
72
+ | `useSlideUp` | hook | Slide-up entrance animation |
73
+ | `useSlideLeft` | hook | Slide-left entrance animation |
74
+ | `useSlideRight` | hook | Slide-right entrance animation |
75
+ | `useScaleIn` | hook | Scale-in entrance animation |
76
+ | `useBounceIn` | hook | Bounce-in entrance animation |
77
+ | `usePulse` | hook | Repeating pulse animation |
78
+ | `useSpringMotion` | hook | Spring physics animation |
79
+ | `useGradient` | hook | Animated gradient background |
80
+ | `useHoverMotion` | hook | Hover interaction animation |
81
+ | `useClickToggle` | hook | Click-triggered toggle animation |
82
+ | `useFocusToggle` | hook | Focus-triggered toggle animation |
83
+ | `useScrollReveal` | hook | Scroll-triggered reveal animation |
84
+ | `useScrollProgress` | hook | Scroll position as 0-1 progress value |
85
+ | `useMotionState` | hook | Animation state tracking (idle, running, complete) |
86
+ | `useRepeat` | hook | Repeating animation with configurable count |
87
+ | `useToggleMotion` | hook | Toggle between two animation states |
88
+ | `useSlideDown` | hook | Slide-down entrance animation |
89
+ | `useInView` | hook | IntersectionObserver-based visibility detection |
90
+ | `useMouse` | hook | Mouse position tracking |
91
+ | `useReducedMotion` | hook | Detect prefers-reduced-motion setting |
92
+ | `useReducedMotionObject` | hook | Returns { prefersReducedMotion } object (extended form of useReducedMotion) |
93
+ | `useWindowSize` | hook | Responsive window size tracking |
94
+ | `useGesture` | hook | Multi-gesture handler (drag, swipe, pinch) |
95
+ | `useGestureMotion` | hook | Gesture-driven motion animation |
96
+ | `useButtonEffect` | hook | Ripple / press feedback effect for buttons |
97
+ | `useVisibilityToggle` | hook | Animate an element in/out based on a boolean visibility flag |
98
+ | `useScrollToggle` | hook | Toggle animation state based on scroll position threshold |
99
+ | `useCardList` | hook | Staggered entrance animation for a list of cards |
100
+ | `useLoadingSpinner` | hook | Continuous rotation animation for loading spinners |
101
+ | `useNavigation` | hook | Slide/fade animation for navigation transitions |
102
+ | `useSkeleton` | hook | Shimmer animation for skeleton loading placeholders |
103
+ | `useTypewriter` | hook | Typewriter character-by-character text reveal animation |
104
+ | `useCustomCursor` | hook | Custom cursor tracking and animation |
105
+ | `useMagneticCursor` | hook | Magnetic cursor attraction effect for interactive elements |
106
+ | `useSmoothScroll` | hook | Smooth programmatic scroll with easing |
107
+ | `useElementProgress` | hook | Track an element's scroll progress as a 0–1 value |
108
+ | `neutral` | variable | Built-in neutral motion profile (minimal, system-respecting) |
109
+ | `hua` | variable | Built-in hua motion profile (expressive, brand-aligned) |
110
+ | `resolveProfile` | function | Resolve a built-in profile name or MotionProfile object to a MotionProfile |
111
+ | `mergeProfileOverrides` | function | Deep-merge overrides into a base MotionProfile |
112
+ | `MotionProfileProvider` | component | React context provider that supplies a MotionProfile to the subtree |
113
+ | `useMotionProfile` | hook | Hook to read the current MotionProfile from context |
114
+ | `observeElement` | function | Shared IntersectionObserver helper — observe an element and invoke a callback on visibility change |
115
+ | `linear` | function | Linear easing (no acceleration) |
116
+ | `easeIn` | function | Ease-in curve (slow start) |
117
+ | `easeOut` | function | Ease-out curve (slow end) |
118
+ | `easeInOut` | function | Smooth ease-in-out curve |
119
+ | `getEasing` | function | Get easing function by name |
120
+ | `applyEasing` | function | Apply an easing function to a raw progress value (throws on invalid) |
121
+ | `safeApplyEasing` | function | Apply an easing function to a progress value, falling back to linear on error |
122
+ | `isValidEasing` | function | Check whether a string is a recognised EasingType name |
123
+ | `getAvailableEasings` | function | Return the list of all registered easing names |
124
+ | `isEasingFunction` | function | Type-guard that checks whether a value is a callable EasingFunction |
125
+ | `easingPresets` | variable | Map of named easing preset strings to EasingFunction objects |
126
+ | `getPresetEasing` | function | Look up an EasingFunction by preset name |
127
+ | `calculateSpring` | function | Pure function that computes spring position/velocity for a given time step |
128
+ | `useAutoFade` | hook | Auto-looping fade animation |
129
+ | `useAutoPlay` | hook | Auto-looping playback animation |
130
+ | `useAutoScale` | hook | Auto-looping scale animation |
131
+ | `useAutoSlide` | hook | Auto-looping slide animation |
132
+ | `useMotionOrchestra` | hook | Multi-mode orchestrator (sequential/parallel/stagger) with dynamic step registration |
133
+ | `useOrchestration` | hook | rAF-based timeline engine with seek, speed, reverse support |
134
+ | `useSequence` | hook | [DEPRECATED] Sequential motion chaining — use useOrchestration or useMotionOrchestra instead |
135
+ | `useLayoutMotion` | hook | Layout change animation with FLIP technique |
136
+ | `createLayoutTransition` | function | Factory function to create layout transition configs |
137
+ | `useKeyboardToggle` | hook | Keyboard shortcut-triggered toggle animation |
138
+ | `useScrollDirection` | hook | Detect scroll direction (up/down) for show/hide patterns |
139
+ | `useStickyToggle` | hook | Toggle animation based on sticky scroll threshold |
140
+ | `useInteractive` | hook | Combined hover/press/focus interaction state |
141
+ | `usePerformanceMonitor` | hook | FPS and frame timing monitor for motion performance |
142
+ | `useLanguageAwareMotion` | hook | Direction-aware motion that adapts to LTR/RTL languages |
143
+ | `useGameLoop` | hook | Fixed-timestep game loop with state management |
144
+ | `useMotion` | hook | Flexible single-element motion hook with from/to config |
145
+ | `useViewportToggle` | hook | IntersectionObserver-based viewport visibility toggle (renamed from pro useVisibilityToggle) |
146
+ | `useScrollPositionToggle` | hook | pageYOffset-based scroll position toggle (renamed from pro useScrollToggle) |
147
+ | `Motion` | component | React wrapper component that applies a motion hook to its child element via ref |
148
+ | `useCountUp` | hook | Animated counter that counts up to a target number |
149
+ | `useClipReveal` | hook | Clip-path reveal animation (wipe-in effect) |
150
+ | `useBlurIn` | hook | Blur-to-clear entrance animation |
151
+ | `useStagger` | hook | Orchestrate staggered entrance animations across a list of elements |
152
+ | `MOTION_PRESETS` | variable | Built-in preset configurations keyed by element role (hero, title, button, card, text, image) |
153
+ | `PAGE_MOTIONS` | variable | Page-level motion configs keyed by page type (home, dashboard, product, blog) |
154
+ | `mergeWithPreset` | function | Merge a MotionPreset with custom overrides |
155
+ | `getPagePreset` | function | Get PageMotionsConfig for a given PageType |
156
+ | `getMotionPreset` | function | Get a MotionPreset by element role string |
157
+ | `useFadeIn (native)` | hook | Native fade-in using Animated.timing |
158
+ | `useSlideUp (native)` | hook | Native slide-up using Animated.parallel |
159
+ | `useSlideDown (native)` | hook | Native slide-down using Animated.parallel |
160
+ | `useSlideLeft (native)` | hook | Native slide-left using Animated.parallel |
161
+ | `useSlideRight (native)` | hook | Native slide-right using Animated.parallel |
162
+ | `useScaleIn (native)` | hook | Native scale-in using Animated.parallel |
163
+ | `useBounceIn (native)` | hook | Native bounce-in using Animated.spring |
164
+ | `useSpringMotion (native)` | hook | Native generic spring animation with animateTo() |
165
+ | `usePulse (native)` | hook | Native looping pulse using Animated.loop |
166
+ | `useStagger (native)` | hook | Native staggered list animation using Animated.stagger |
169
167
 
170
168
  ## Documentation
171
169
 
package/dist/index.d.mts CHANGED
@@ -2,7 +2,6 @@ import { P as PageType, a as PageMotionRef, b as PageMotionsConfig, B as BaseMot
2
2
  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';
3
3
  import * as react from 'react';
4
4
  import react__default, { CSSProperties, RefObject } from 'react';
5
- import * as react_jsx_runtime from 'react/jsx-runtime';
6
5
 
7
6
  /**
8
7
  * 1단계 API: 프리셋 기반 페이지 모션 (기존 방식)
@@ -1432,7 +1431,7 @@ interface MotionProps extends react__default.HTMLAttributes<HTMLElement> {
1432
1431
  * // 커스텀 요소 + 타입
1433
1432
  * <Motion as="section" type="slideUp" duration={800}>...</Motion>
1434
1433
  */
1435
- declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react_jsx_runtime.JSX.Element;
1434
+ declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react__default.JSX.Element;
1436
1435
 
1437
1436
  interface CountUpOptions {
1438
1437
  /** 목표 숫자 */
package/dist/index.d.ts CHANGED
@@ -2,7 +2,6 @@ import { P as PageType, a as PageMotionRef, b as PageMotionsConfig, B as BaseMot
2
2
  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';
3
3
  import * as react from 'react';
4
4
  import react__default, { CSSProperties, RefObject } from 'react';
5
- import * as react_jsx_runtime from 'react/jsx-runtime';
6
5
 
7
6
  /**
8
7
  * 1단계 API: 프리셋 기반 페이지 모션 (기존 방식)
@@ -1432,7 +1431,7 @@ interface MotionProps extends react__default.HTMLAttributes<HTMLElement> {
1432
1431
  * // 커스텀 요소 + 타입
1433
1432
  * <Motion as="section" type="slideUp" duration={800}>...</Motion>
1434
1433
  */
1435
- declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react_jsx_runtime.JSX.Element;
1434
+ declare function Motion({ as: Component, type, effects, scroll, delay, duration, children, className, style: userStyle, ...rest }: MotionProps): react__default.JSX.Element;
1436
1435
 
1437
1436
  interface CountUpOptions {
1438
1437
  /** 목표 숫자 */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hua-labs/motion-core",
3
- "version": "2.4.1",
3
+ "version": "2.4.2",
4
4
  "description": "HUA Motion Core - Essential animation hooks for React developers",
5
5
  "main": "./dist/index.cjs",
6
6
  "module": "./dist/index.mjs",
@@ -29,14 +29,14 @@
29
29
  "devDependencies": {
30
30
  "@testing-library/jest-dom": "^6.9.1",
31
31
  "@testing-library/react": "^16.3.2",
32
- "@types/node": "^25.3.5",
33
- "@types/react": "^19.2.14",
32
+ "@types/node": "^25.9.3",
33
+ "@types/react": "^19.2.17",
34
34
  "@types/react-dom": "^19.2.3",
35
- "@vitejs/plugin-react": "^6.0.1",
36
- "eslint": "^10.0.3",
35
+ "@vitejs/plugin-react": "^5.2.0",
36
+ "eslint": "^10.5.0",
37
37
  "tsup": "^8.5.1",
38
38
  "typescript": "^5.9.3",
39
- "vitest": "^4.0.18"
39
+ "vitest": "^4.1.8"
40
40
  },
41
41
  "peerDependencies": {
42
42
  "react": ">=19.0.0",