@hua-labs/motion-core 2.4.0 → 2.4.1

package/dist/native.d.mts

@@ -1,5 +1,5 @@
-import { M as MotionElement, _ as MotionState } from './springPhysics-DLyZ4nbx.mjs';
-export { B as BaseMotionOptions, e as BounceOptions, p as BuiltInProfileName, D as DeepPartial, q as EasingFunction, r as EasingType, F as FadeInOptions, u as MOTION_PRESETS, v as MotionCallback, x as MotionDirection, y as MotionEasing, z as MotionEngine, A as MotionFrame, C as MotionInstance, J as MotionOptions, 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, a0 as MotionTrigger, a3 as PAGE_MOTIONS, f as PulseOptions, a7 as ReducedMotionStrategy, d as ScaleOptions, S as SlideOptions, a8 as SpringConfig, g as SpringOptions, 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 { M as MotionElement, a0 as MotionState } from './springPhysics-BZVRi9PQ.mjs';
+export { B as BaseMotionOptions, f as BounceOptions, q as BuiltInProfileName, D as DeepPartial, r as EasingFunction, s as EasingType, F as FadeInOptions, v as MOTION_PRESETS, w as MotionCallback, y as MotionDirection, z as MotionEasing, C as MotionEngine, J as MotionFrame, K as MotionInstance, L as MotionOptions, 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, a2 as MotionTrigger, a6 as PAGE_MOTIONS, g as PulseOptions, aa as ReducedMotionStrategy, e as ScaleOptions, S as SlideOptions, ac as SpringConfig, h as SpringOptions, ad as SpringPhysicsConfig, ae as SpringResult, 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 { ViewStyle, Animated } from 'react-native';
 import 'react';
 

package/dist/native.d.ts

@@ -1,5 +1,5 @@
-import { M as MotionElement, _ as MotionState } from './springPhysics-DLyZ4nbx.js';
-export { B as BaseMotionOptions, e as BounceOptions, p as BuiltInProfileName, D as DeepPartial, q as EasingFunction, r as EasingType, F as FadeInOptions, u as MOTION_PRESETS, v as MotionCallback, x as MotionDirection, y as MotionEasing, z as MotionEngine, A as MotionFrame, C as MotionInstance, J as MotionOptions, 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, a0 as MotionTrigger, a3 as PAGE_MOTIONS, f as PulseOptions, a7 as ReducedMotionStrategy, d as ScaleOptions, S as SlideOptions, a8 as SpringConfig, g as SpringOptions, 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 { M as MotionElement, a0 as MotionState } from './springPhysics-BZVRi9PQ.js';
+export { B as BaseMotionOptions, f as BounceOptions, q as BuiltInProfileName, D as DeepPartial, r as EasingFunction, s as EasingType, F as FadeInOptions, v as MOTION_PRESETS, w as MotionCallback, y as MotionDirection, z as MotionEasing, C as MotionEngine, J as MotionFrame, K as MotionInstance, L as MotionOptions, 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, a2 as MotionTrigger, a6 as PAGE_MOTIONS, g as PulseOptions, aa as ReducedMotionStrategy, e as ScaleOptions, S as SlideOptions, ac as SpringConfig, h as SpringOptions, ad as SpringPhysicsConfig, ae as SpringResult, 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 { ViewStyle, Animated } from 'react-native';
 import 'react';
 

package/dist/{springPhysics-DLyZ4nbx.d.mts → springPhysics-BZVRi9PQ.d.mts}

@@ -194,10 +194,10 @@ declare const transitionEffects: TransitionEffects;
 
 type MotionElement = HTMLDivElement | HTMLSpanElement | HTMLButtonElement | HTMLHeadingElement | HTMLParagraphElement | HTMLImageElement;
 type MotionStyle = CSSProperties & {
-    '--motion-delay'?: string;
-    '--motion-duration'?: string;
-    '--motion-easing'?: string;
-    '--motion-progress'?: string;
+    "--motion-delay"?: string;
+    "--motion-duration"?: string;
+    "--motion-easing"?: string;
+    "--motion-progress"?: string;
 };
 interface BaseMotionOptions {
     /** 모션 시작 지연 시간 (ms) */
@@ -261,7 +261,7 @@ interface FadeInOptions extends BaseMotionOptions {
 }
 interface SlideOptions extends BaseMotionOptions {
     /** 슬라이드 방향 */
-    direction?: 'up' | 'down' | 'left' | 'right';
+    direction?: "up" | "down" | "left" | "right";
     /** 슬라이드 거리 (px) */
     distance?: number;
 }
@@ -309,9 +309,9 @@ interface GestureOptions extends BaseMotionOptions {
     /** 틸트 제스처 활성화 */
     tilt?: boolean;
 }
-type MotionDirection = 'up' | 'down' | 'left' | 'right';
-type MotionEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'bounce' | 'elastic';
-type MotionTrigger = 'scroll' | 'click' | 'hover' | 'focus' | 'auto';
+type MotionDirection = "up" | "down" | "left" | "right";
+type MotionEasing = "linear" | "ease-in" | "ease-out" | "ease-in-out" | "bounce" | "elastic";
+type MotionTrigger = "scroll" | "click" | "hover" | "focus" | "auto";
 type MotionCallback = () => void;
 type MotionProgressCallback = (progress: number) => void;
 type MotionStateCallback<T extends MotionElement = HTMLDivElement> = (state: BaseMotionReturn<T>) => void;
@@ -333,7 +333,7 @@ interface MotionConfig {
     /** 디버그 모드 활성화 */
     debug?: boolean;
     /** 로그 레벨 */
-    logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
+    logLevel?: "none" | "error" | "warn" | "info" | "debug";
 }
 interface InViewOptions {
     /** Intersection Observer 임계값 */
@@ -391,7 +391,7 @@ interface WindowSizeReturn {
     /** 마운트 여부 (SSR 대응) */
     isMounted: boolean;
 }
-type ScrollRevealMotionType = 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+type ScrollRevealMotionType = "fadeIn" | "slideUp" | "slideLeft" | "slideRight" | "scaleIn" | "bounceIn";
 interface ScrollRevealOptions extends BaseMotionOptions {
     /** 루트 마진 */
     rootMargin?: string;
@@ -402,7 +402,7 @@ interface GradientOptions extends BaseMotionOptions {
     /** 그라디언트 색상 배열 */
     colors?: string[];
     /** 그라디언트 방향 */
-    direction?: 'horizontal' | 'vertical' | 'diagonal';
+    direction?: "horizontal" | "vertical" | "diagonal";
     /** 그라디언트 크기 (%) */
     size?: number;
 }
@@ -410,7 +410,7 @@ interface ToggleMotionOptions extends BaseMotionOptions {
 }
 interface RepeatOptions extends BaseMotionOptions {
     /** 반복 효과 타입 */
-    type?: 'pulse' | 'bounce' | 'wave' | 'fade';
+    type?: "pulse" | "bounce" | "wave" | "fade";
     /** 효과 강도 */
     intensity?: number;
 }
@@ -422,10 +422,61 @@ interface HoverMotionOptions extends BaseMotionOptions {
     /** 호버 시 투명도 */
     hoverOpacity?: number;
 }
+/**
+ * Standard return type for entrance/exit animation hooks.
+ * Used by: useFadeIn, useSlideUp, useScaleIn, useBounceIn, etc.
+ */
+interface EntranceMotionReturn<T extends MotionElement = HTMLDivElement> extends BaseMotionReturn<T> {
+    /** Pause the animation */
+    pause: () => void;
+    /** Resume a paused animation */
+    resume: () => void;
+}
+/**
+ * Standard return type for style-only hooks (no animation controls).
+ * Used by: useBlurIn, useClipReveal, etc.
+ */
+interface StyleMotionReturn<T extends MotionElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
+    style: MotionStyle;
+    isVisible: boolean;
+}
+/**
+ * Standard return type for toggle/interaction hooks.
+ * Used by: useClickToggle, useFocusToggle, useKeyboardToggle, etc.
+ */
+interface ToggleMotionReturn<T extends MotionElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
+    isActive: boolean;
+    mounted: boolean;
+    toggle: () => void;
+    activate: () => void;
+    deactivate: () => void;
+    reset: () => void;
+}
+/**
+ * Standard return type for observation/utility hooks.
+ * Used by: useInView, useElementProgress, etc.
+ */
+interface ObserverReturn<T extends MotionElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
+}
+/**
+ * Standard return type for auto-looping animation hooks.
+ * Used by: useAutoFade, useAutoScale, useAutoSlide, etc.
+ */
+interface AutoMotionReturn {
+    isAnimating: boolean;
+    isVisible: boolean;
+    mounted: boolean;
+    start: () => void;
+    stop: () => void;
+    reset: () => void;
+}
 
-type PageType = 'home' | 'dashboard' | 'product' | 'blog';
-type MotionType = 'hero' | 'title' | 'button' | 'card' | 'text' | 'image';
-type EntranceType = 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+type PageType = "home" | "dashboard" | "product" | "blog";
+type MotionType = "hero" | "title" | "button" | "card" | "text" | "image";
+type EntranceType = "fadeIn" | "slideUp" | "slideLeft" | "slideRight" | "scaleIn" | "bounceIn";
 interface PageMotionElement {
     type: MotionType;
     entrance?: EntranceType;
@@ -482,8 +533,10 @@ interface GestureConfig {
     swipe?: boolean;
     tilt?: boolean;
 }
-interface OrchestrationConfig {
-    sequence?: 'sequential' | 'parallel' | 'stagger';
+/** @deprecated Renamed to SequenceOrchestrationConfig to avoid collision with useOrchestration's config. */
+type OrchestrationConfig = SequenceOrchestrationConfig;
+interface SequenceOrchestrationConfig {
+    sequence?: "sequential" | "parallel" | "stagger";
     staggerDelay?: number;
     staggerDuration?: number;
 }
@@ -684,4 +737,4 @@ interface SpringResult {
  */
 declare function calculateSpring(currentValue: number, currentVelocity: number, targetValue: number, deltaTime: number, config: SpringConfig): SpringResult;
 
-export { type MotionStateCallback as $, type MotionFrame as A, type BaseMotionOptions as B, type Motion as C, type DeepPartial as D, type EntranceType as E, type FadeInOptions as F, type GradientOptions as G, type HoverMotionOptions as H, type InteractionReturn as I, type MotionOptions as J, type MotionPreset as K, type MotionProfile as L, type MotionElement as M, type MotionProfileBase as N, type MotionProfileEntrance as O, type PageType as P, type MotionProfileInteraction as Q, type RepeatOptions as R, type SlideOptions as S, type ToggleMotionOptions as T, MotionProfileProvider as U, type MotionProfileProviderProps as V, type WindowSizeOptions as W, type MotionProfileSpring as X, type MotionProfileStagger as Y, type MotionProgressCallback as Z, type MotionState as _, type PageMotionRef as a, type MotionTrigger as a0, type MotionType as a1, type OrchestrationConfig as a2, PAGE_MOTIONS as a3, type PageMotionElement as a4, type PerformanceMetrics as a5, type PresetConfig as a6, type ReducedMotionStrategy as a7, type SpringConfig$1 as a8, type SpringConfig as a9, resolveProfile as aA, safeApplyEasing as aB, transitionEffects as aC, useMotionProfile as aD, type SpringResult as aa, TransitionEffects as ab, type TransitionOptions as ac, type TransitionType as ad, applyEasing as ae, calculateSpring as af, easeIn as ag, easeInOut as ah, easeInOutQuad as ai, easeInQuad as aj, easeOut as ak, easeOutQuad as al, easingPresets as am, getAvailableEasings as an, getEasing as ao, getMotionPreset as ap, getPagePreset as aq, getPresetEasing as ar, hua as as, isEasingFunction as at, isValidEasing as au, linear as av, mergeProfileOverrides as aw, mergeWithPreset as ax, motionEngine as ay, neutral as az, type PageMotionsConfig as b, type BaseMotionReturn as c, type ScaleOptions as d, type BounceOptions as e, type PulseOptions as f, type SpringOptions as g, type ScrollRevealOptions as h, type InViewOptions as i, type InViewReturn as j, type MouseOptions as k, type MouseReturn as l, type ReducedMotionReturn as m, type WindowSizeReturn as n, type ScrollRevealMotionType as o, type BuiltInProfileName as p, type EasingFunction as q, type EasingType as r, type GestureConfig as s, type GestureOptions as t, MOTION_PRESETS as u, type MotionCallback as v, type MotionConfig as w, type MotionDirection as x, type MotionEasing as y, MotionEngine as z };
+export { type MotionProgressCallback as $, type AutoMotionReturn as A, type BaseMotionOptions as B, MotionEngine as C, type DeepPartial as D, type EntranceType as E, type FadeInOptions as F, type GradientOptions as G, type HoverMotionOptions as H, type InteractionReturn as I, type MotionFrame as J, type Motion as K, type MotionOptions as L, type MotionElement as M, type MotionPreset as N, type MotionProfile as O, type PageType as P, type MotionProfileBase as Q, type RepeatOptions as R, type SlideOptions as S, type ToggleMotionOptions as T, type MotionProfileEntrance as U, type MotionProfileInteraction as V, type WindowSizeOptions as W, MotionProfileProvider as X, type MotionProfileProviderProps as Y, type MotionProfileSpring as Z, type MotionProfileStagger as _, type PageMotionRef as a, type MotionState as a0, type MotionStateCallback as a1, type MotionTrigger as a2, type MotionType as a3, type ObserverReturn as a4, type OrchestrationConfig as a5, PAGE_MOTIONS as a6, type PageMotionElement as a7, type PerformanceMetrics as a8, type PresetConfig as a9, isValidEasing as aA, linear as aB, mergeProfileOverrides as aC, mergeWithPreset as aD, motionEngine as aE, neutral as aF, resolveProfile as aG, safeApplyEasing as aH, transitionEffects as aI, useMotionProfile as aJ, type ReducedMotionStrategy as aa, type SequenceOrchestrationConfig as ab, type SpringConfig$1 as ac, type SpringConfig as ad, type SpringResult as ae, type StyleMotionReturn as af, type ToggleMotionReturn as ag, TransitionEffects as ah, type TransitionOptions as ai, type TransitionType as aj, applyEasing as ak, calculateSpring as al, easeIn as am, easeInOut as an, easeInOutQuad as ao, easeInQuad as ap, easeOut as aq, easeOutQuad as ar, easingPresets as as, getAvailableEasings as at, getEasing as au, getMotionPreset as av, getPagePreset as aw, getPresetEasing as ax, hua as ay, isEasingFunction as az, type PageMotionsConfig as b, type BaseMotionReturn as c, type EntranceMotionReturn as d, type ScaleOptions as e, type BounceOptions as f, type PulseOptions as g, type SpringOptions as h, type ScrollRevealOptions as i, type InViewOptions as j, type InViewReturn as k, type MouseOptions as l, type MouseReturn as m, type ReducedMotionReturn as n, type WindowSizeReturn as o, type ScrollRevealMotionType as p, type BuiltInProfileName as q, type EasingFunction as r, type EasingType as s, type GestureConfig as t, type GestureOptions as u, MOTION_PRESETS as v, type MotionCallback as w, type MotionConfig as x, type MotionDirection as y, type MotionEasing as z };

package/dist/{springPhysics-DLyZ4nbx.d.ts → springPhysics-BZVRi9PQ.d.ts}

@@ -194,10 +194,10 @@ declare const transitionEffects: TransitionEffects;
 
 type MotionElement = HTMLDivElement | HTMLSpanElement | HTMLButtonElement | HTMLHeadingElement | HTMLParagraphElement | HTMLImageElement;
 type MotionStyle = CSSProperties & {
-    '--motion-delay'?: string;
-    '--motion-duration'?: string;
-    '--motion-easing'?: string;
-    '--motion-progress'?: string;
+    "--motion-delay"?: string;
+    "--motion-duration"?: string;
+    "--motion-easing"?: string;
+    "--motion-progress"?: string;
 };
 interface BaseMotionOptions {
     /** 모션 시작 지연 시간 (ms) */
@@ -261,7 +261,7 @@ interface FadeInOptions extends BaseMotionOptions {
 }
 interface SlideOptions extends BaseMotionOptions {
     /** 슬라이드 방향 */
-    direction?: 'up' | 'down' | 'left' | 'right';
+    direction?: "up" | "down" | "left" | "right";
     /** 슬라이드 거리 (px) */
     distance?: number;
 }
@@ -309,9 +309,9 @@ interface GestureOptions extends BaseMotionOptions {
     /** 틸트 제스처 활성화 */
     tilt?: boolean;
 }
-type MotionDirection = 'up' | 'down' | 'left' | 'right';
-type MotionEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'bounce' | 'elastic';
-type MotionTrigger = 'scroll' | 'click' | 'hover' | 'focus' | 'auto';
+type MotionDirection = "up" | "down" | "left" | "right";
+type MotionEasing = "linear" | "ease-in" | "ease-out" | "ease-in-out" | "bounce" | "elastic";
+type MotionTrigger = "scroll" | "click" | "hover" | "focus" | "auto";
 type MotionCallback = () => void;
 type MotionProgressCallback = (progress: number) => void;
 type MotionStateCallback<T extends MotionElement = HTMLDivElement> = (state: BaseMotionReturn<T>) => void;
@@ -333,7 +333,7 @@ interface MotionConfig {
     /** 디버그 모드 활성화 */
     debug?: boolean;
     /** 로그 레벨 */
-    logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
+    logLevel?: "none" | "error" | "warn" | "info" | "debug";
 }
 interface InViewOptions {
     /** Intersection Observer 임계값 */
@@ -391,7 +391,7 @@ interface WindowSizeReturn {
     /** 마운트 여부 (SSR 대응) */
     isMounted: boolean;
 }
-type ScrollRevealMotionType = 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+type ScrollRevealMotionType = "fadeIn" | "slideUp" | "slideLeft" | "slideRight" | "scaleIn" | "bounceIn";
 interface ScrollRevealOptions extends BaseMotionOptions {
     /** 루트 마진 */
     rootMargin?: string;
@@ -402,7 +402,7 @@ interface GradientOptions extends BaseMotionOptions {
     /** 그라디언트 색상 배열 */
     colors?: string[];
     /** 그라디언트 방향 */
-    direction?: 'horizontal' | 'vertical' | 'diagonal';
+    direction?: "horizontal" | "vertical" | "diagonal";
     /** 그라디언트 크기 (%) */
     size?: number;
 }
@@ -410,7 +410,7 @@ interface ToggleMotionOptions extends BaseMotionOptions {
 }
 interface RepeatOptions extends BaseMotionOptions {
     /** 반복 효과 타입 */
-    type?: 'pulse' | 'bounce' | 'wave' | 'fade';
+    type?: "pulse" | "bounce" | "wave" | "fade";
     /** 효과 강도 */
     intensity?: number;
 }
@@ -422,10 +422,61 @@ interface HoverMotionOptions extends BaseMotionOptions {
     /** 호버 시 투명도 */
     hoverOpacity?: number;
 }
+/**
+ * Standard return type for entrance/exit animation hooks.
+ * Used by: useFadeIn, useSlideUp, useScaleIn, useBounceIn, etc.
+ */
+interface EntranceMotionReturn<T extends MotionElement = HTMLDivElement> extends BaseMotionReturn<T> {
+    /** Pause the animation */
+    pause: () => void;
+    /** Resume a paused animation */
+    resume: () => void;
+}
+/**
+ * Standard return type for style-only hooks (no animation controls).
+ * Used by: useBlurIn, useClipReveal, etc.
+ */
+interface StyleMotionReturn<T extends MotionElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
+    style: MotionStyle;
+    isVisible: boolean;
+}
+/**
+ * Standard return type for toggle/interaction hooks.
+ * Used by: useClickToggle, useFocusToggle, useKeyboardToggle, etc.
+ */
+interface ToggleMotionReturn<T extends MotionElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
+    isActive: boolean;
+    mounted: boolean;
+    toggle: () => void;
+    activate: () => void;
+    deactivate: () => void;
+    reset: () => void;
+}
+/**
+ * Standard return type for observation/utility hooks.
+ * Used by: useInView, useElementProgress, etc.
+ */
+interface ObserverReturn<T extends MotionElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
+}
+/**
+ * Standard return type for auto-looping animation hooks.
+ * Used by: useAutoFade, useAutoScale, useAutoSlide, etc.
+ */
+interface AutoMotionReturn {
+    isAnimating: boolean;
+    isVisible: boolean;
+    mounted: boolean;
+    start: () => void;
+    stop: () => void;
+    reset: () => void;
+}
 
-type PageType = 'home' | 'dashboard' | 'product' | 'blog';
-type MotionType = 'hero' | 'title' | 'button' | 'card' | 'text' | 'image';
-type EntranceType = 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+type PageType = "home" | "dashboard" | "product" | "blog";
+type MotionType = "hero" | "title" | "button" | "card" | "text" | "image";
+type EntranceType = "fadeIn" | "slideUp" | "slideLeft" | "slideRight" | "scaleIn" | "bounceIn";
 interface PageMotionElement {
     type: MotionType;
     entrance?: EntranceType;
@@ -482,8 +533,10 @@ interface GestureConfig {
     swipe?: boolean;
     tilt?: boolean;
 }
-interface OrchestrationConfig {
-    sequence?: 'sequential' | 'parallel' | 'stagger';
+/** @deprecated Renamed to SequenceOrchestrationConfig to avoid collision with useOrchestration's config. */
+type OrchestrationConfig = SequenceOrchestrationConfig;
+interface SequenceOrchestrationConfig {
+    sequence?: "sequential" | "parallel" | "stagger";
     staggerDelay?: number;
     staggerDuration?: number;
 }
@@ -684,4 +737,4 @@ interface SpringResult {
  */
 declare function calculateSpring(currentValue: number, currentVelocity: number, targetValue: number, deltaTime: number, config: SpringConfig): SpringResult;
 
-export { type MotionStateCallback as $, type MotionFrame as A, type BaseMotionOptions as B, type Motion as C, type DeepPartial as D, type EntranceType as E, type FadeInOptions as F, type GradientOptions as G, type HoverMotionOptions as H, type InteractionReturn as I, type MotionOptions as J, type MotionPreset as K, type MotionProfile as L, type MotionElement as M, type MotionProfileBase as N, type MotionProfileEntrance as O, type PageType as P, type MotionProfileInteraction as Q, type RepeatOptions as R, type SlideOptions as S, type ToggleMotionOptions as T, MotionProfileProvider as U, type MotionProfileProviderProps as V, type WindowSizeOptions as W, type MotionProfileSpring as X, type MotionProfileStagger as Y, type MotionProgressCallback as Z, type MotionState as _, type PageMotionRef as a, type MotionTrigger as a0, type MotionType as a1, type OrchestrationConfig as a2, PAGE_MOTIONS as a3, type PageMotionElement as a4, type PerformanceMetrics as a5, type PresetConfig as a6, type ReducedMotionStrategy as a7, type SpringConfig$1 as a8, type SpringConfig as a9, resolveProfile as aA, safeApplyEasing as aB, transitionEffects as aC, useMotionProfile as aD, type SpringResult as aa, TransitionEffects as ab, type TransitionOptions as ac, type TransitionType as ad, applyEasing as ae, calculateSpring as af, easeIn as ag, easeInOut as ah, easeInOutQuad as ai, easeInQuad as aj, easeOut as ak, easeOutQuad as al, easingPresets as am, getAvailableEasings as an, getEasing as ao, getMotionPreset as ap, getPagePreset as aq, getPresetEasing as ar, hua as as, isEasingFunction as at, isValidEasing as au, linear as av, mergeProfileOverrides as aw, mergeWithPreset as ax, motionEngine as ay, neutral as az, type PageMotionsConfig as b, type BaseMotionReturn as c, type ScaleOptions as d, type BounceOptions as e, type PulseOptions as f, type SpringOptions as g, type ScrollRevealOptions as h, type InViewOptions as i, type InViewReturn as j, type MouseOptions as k, type MouseReturn as l, type ReducedMotionReturn as m, type WindowSizeReturn as n, type ScrollRevealMotionType as o, type BuiltInProfileName as p, type EasingFunction as q, type EasingType as r, type GestureConfig as s, type GestureOptions as t, MOTION_PRESETS as u, type MotionCallback as v, type MotionConfig as w, type MotionDirection as x, type MotionEasing as y, MotionEngine as z };
+export { type MotionProgressCallback as $, type AutoMotionReturn as A, type BaseMotionOptions as B, MotionEngine as C, type DeepPartial as D, type EntranceType as E, type FadeInOptions as F, type GradientOptions as G, type HoverMotionOptions as H, type InteractionReturn as I, type MotionFrame as J, type Motion as K, type MotionOptions as L, type MotionElement as M, type MotionPreset as N, type MotionProfile as O, type PageType as P, type MotionProfileBase as Q, type RepeatOptions as R, type SlideOptions as S, type ToggleMotionOptions as T, type MotionProfileEntrance as U, type MotionProfileInteraction as V, type WindowSizeOptions as W, MotionProfileProvider as X, type MotionProfileProviderProps as Y, type MotionProfileSpring as Z, type MotionProfileStagger as _, type PageMotionRef as a, type MotionState as a0, type MotionStateCallback as a1, type MotionTrigger as a2, type MotionType as a3, type ObserverReturn as a4, type OrchestrationConfig as a5, PAGE_MOTIONS as a6, type PageMotionElement as a7, type PerformanceMetrics as a8, type PresetConfig as a9, isValidEasing as aA, linear as aB, mergeProfileOverrides as aC, mergeWithPreset as aD, motionEngine as aE, neutral as aF, resolveProfile as aG, safeApplyEasing as aH, transitionEffects as aI, useMotionProfile as aJ, type ReducedMotionStrategy as aa, type SequenceOrchestrationConfig as ab, type SpringConfig$1 as ac, type SpringConfig as ad, type SpringResult as ae, type StyleMotionReturn as af, type ToggleMotionReturn as ag, TransitionEffects as ah, type TransitionOptions as ai, type TransitionType as aj, applyEasing as ak, calculateSpring as al, easeIn as am, easeInOut as an, easeInOutQuad as ao, easeInQuad as ap, easeOut as aq, easeOutQuad as ar, easingPresets as as, getAvailableEasings as at, getEasing as au, getMotionPreset as av, getPagePreset as aw, getPresetEasing as ax, hua as ay, isEasingFunction as az, type PageMotionsConfig as b, type BaseMotionReturn as c, type EntranceMotionReturn as d, type ScaleOptions as e, type BounceOptions as f, type PulseOptions as g, type SpringOptions as h, type ScrollRevealOptions as i, type InViewOptions as j, type InViewReturn as k, type MouseOptions as l, type MouseReturn as m, type ReducedMotionReturn as n, type WindowSizeReturn as o, type ScrollRevealMotionType as p, type BuiltInProfileName as q, type EasingFunction as r, type EasingType as s, type GestureConfig as t, type GestureOptions as u, MOTION_PRESETS as v, type MotionCallback as w, type MotionConfig as x, type MotionDirection as y, type MotionEasing as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hua-labs/motion-core",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "HUA Motion Core - Essential animation hooks for React developers",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -32,7 +32,7 @@
     "@types/node": "^25.3.5",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.4",
+    "@vitejs/plugin-react": "^6.0.1",
     "eslint": "^10.0.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",