@hua-labs/motion-core 2.2.0 → 2.2.2

package/README.md

@@ -1,24 +1,20 @@
 # @hua-labs/motion-core
 
-Production-ready React animation hooks — zero dependencies, SSR-ready.
+A collection of 35+ 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.
 
 [![npm version](https://img.shields.io/npm/v/@hua-labs/motion-core.svg)](https://www.npmjs.com/package/@hua-labs/motion-core)
-[![npm downloads](https://img.shields.io/npm/dw/@hua-labs/motion-core.svg)](https://www.npmjs.com/package/@hua-labs/motion-core)
+[![npm downloads](https://img.shields.io/npm/dm/@hua-labs/motion-core.svg)](https://www.npmjs.com/package/@hua-labs/motion-core)
 [![license](https://img.shields.io/npm/l/@hua-labs/motion-core.svg)](https://github.com/HUA-Labs/HUA-Labs-public/blob/main/LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
 [![React](https://img.shields.io/badge/React-19-blue)](https://reactjs.org/)
 
-## Overview
-
-A collection of 25+ 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.
-
 ## Features
 
-- **25+ animation hooks** — Fade, slide, scale, scroll, interactions, gestures
-- **Zero dependencies** — Pure JavaScript motion engine
-- **Ref-based** — Direct DOM manipulation for consistent performance
-- **SSR compatible** — Works with Next.js, Remix, and SSR frameworks
-- **Tested** — 517 test cases
+- **35+ animation hooks — Fade, slide, scale, scroll, interactions, gestures**
+- **Zero dependencies — Pure JavaScript motion engine**
+- **Ref-based — Direct DOM manipulation for consistent performance**
+- **SSR compatible — Works with Next.js, Remix, and SSR frameworks**
+- **Fully tested — Comprehensive test coverage**
 
 ## Installation
 
@@ -26,7 +22,7 @@ A collection of 25+ React animation hooks built on a ref-based engine. Direct DO
 pnpm add @hua-labs/motion-core
 ```
 
-Peer dependencies: `react >= 19.0.0`, `react-dom >= 19.0.0`
+> Peer dependencies: react >=19.0.0, react-dom >=19.0.0
 
 ## Quick Start
 
@@ -44,29 +40,120 @@ function Hero() {
     </div>
   );
 }
-```
 
-## API Overview
-
-All hooks return a consistent `BaseMotionReturn` interface:
+```
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `ref` | `RefObject<T>` | Attach to target element |
-| `style` | `CSSProperties` | Apply to element |
-| `isVisible` | `boolean` | Visibility state |
-| `isAnimating` | `boolean` | Animation in progress |
-| `start/stop/reset/pause/resume` | `() => void` | Playback controls |
+## API
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `MotionEngine` | component |  |
+| `motionEngine` | function |  |
+| `type MotionFrame` | function |  |
+| `type MotionOptions` | function |  |
+| `type Motion` | function |  |
+| `TransitionEffects` | component |  |
+| `transitionEffects` | function |  |
+| `type TransitionType` | function |  |
+| `type TransitionOptions` | function |  |
+| `PerformanceOptimizer` | component |  |
+| `performanceOptimizer` | function |  |
+| `type PerformanceOptimizerMetrics` | function |  |
+| `type OptimizationConfig` | function |  |
+| `useSimplePageMotion` | hook |  |
+| `usePageMotions` | hook |  |
+| `useSmartMotion` | hook |  |
+| `useUnifiedMotion` | hook |  |
+| `useFadeIn` | hook | Fade-in animation hook |
+| `useSlideUp` | hook | Slide-up animation hook |
+| `useSlideLeft` | hook | Slide-left animation hook |
+| `useSlideRight` | hook | Slide-right animation hook |
+| `useScaleIn` | hook | Scale-in animation hook |
+| `useBounceIn` | hook | Bounce-in animation hook |
+| `usePulse` | hook |  |
+| `useSpringMotion` | hook |  |
+| `useGradient` | hook |  |
+| `useHoverMotion` | hook | Hover interaction animation |
+| `useClickToggle` | hook |  |
+| `useFocusToggle` | hook |  |
+| `useScrollReveal` | hook | Scroll-triggered reveal animation |
+| `useScrollProgress` | hook |  |
+| `useMotionState` | hook |  |
+| `useRepeat` | hook |  |
+| `useToggleMotion` | hook |  |
+| `useSlideDown` | hook |  |
+| `useInView` | hook |  |
+| `useMouse` | hook |  |
+| `useReducedMotion` | hook |  |
+| `useWindowSize` | hook |  |
+| `useGesture` | hook |  |
+| `useGestureMotion` | hook |  |
+| `linear` | function |  |
+| `easeIn` | function |  |
+| `easeOut` | function |  |
+| `easeInOut` | function |  |
+| `easeInQuad` | function |  |
+| `easeOutQuad` | function |  |
+| `easeInOutQuad` | function |  |
+| `type EasingFunction` | function |  |
+| `type EasingType` | function |  |
+| `getEasing` | function |  |
+| `applyEasing` | function |  |
+| `safeApplyEasing` | function |  |
+| `isValidEasing` | function |  |
+| `getAvailableEasings` | function |  |
+| `isEasingFunction` | function |  |
+| `easingPresets` | function |  |
+| `getPresetEasing` | function |  |
+| `UseUnifiedMotionOptions` | type |  |
+| `PageType` | type |  |
+| `MotionType` | type |  |
+| `EntranceType` | type |  |
+| `PageMotionElement` | type |  |
+| `PageMotionsConfig` | type |  |
+| `MotionState` | type |  |
+| `PageMotionRef` | type |  |
+| `BaseMotionOptions` | type |  |
+| `BaseMotionReturn` | type |  |
+| `MotionElement` | type |  |
+| `MotionPreset` | type |  |
+| `PresetConfig` | type |  |
+| `SpringConfig` | type |  |
+| `GestureConfig` | type |  |
+| `OrchestrationConfig` | type |  |
+| `FadeInOptions` | type |  |
+| `SlideOptions` | type |  |
+| `ScaleOptions` | type |  |
+| `BounceOptions` | type |  |
+| `PulseOptions` | type |  |
+| `SpringOptions` | type |  |
+| `GestureOptions` | type |  |
+| `ScrollRevealOptions` | type |  |
+| `ScrollRevealMotionType` | type |  |
+| `GradientOptions` | type |  |
+| `ToggleMotionOptions` | type |  |
+| `RepeatOptions` | type |  |
+| `HoverMotionOptions` | type |  |
+| `InteractionReturn` | type |  |
+| `InViewOptions` | type |  |
+| `InViewReturn` | type |  |
+| `MouseOptions` | type |  |
+| `MouseReturn` | type |  |
+| `ReducedMotionReturn` | type |  |
+| `WindowSizeOptions` | type |  |
+| `WindowSizeReturn` | type |  |
+| `PerformanceMetrics` | type |  |
+| `MotionConfig` | type |  |
+| `MotionDirection` | type |  |
+| `MotionEasing` | type |  |
+| `MotionTrigger` | type |  |
+| `MotionCallback` | type |  |
+| `MotionProgressCallback` | type |  |
+| `MotionStateCallback` | type |  |
 
-**Available hooks by category:**
+## Documentation
 
-| Category | Hooks |
-|----------|-------|
-| Basic | `useFadeIn`, `useSlideUp`, `useSlideLeft`, `useSlideRight`, `useScaleIn`, `useBounceIn`, `usePulse`, `useSpringMotion`, `useGradient` |
-| Interaction | `useHoverMotion`, `useClickToggle`, `useFocusToggle`, `useToggleMotion` |
-| Scroll | `useScrollReveal`, `useScrollProgress` |
-| List | `useStaggerMotion`, `useCardList`, `useSkeleton` |
-| Utility | `useMotionState`, `useRepeat`, `useSmartMotion`, `useUnifiedMotion`, `useSimplePageMotion`, `usePageMotions`, `useGesture`, `useGestureMotion` |
+[Full Documentation](https://docs.hua-labs.com)
 
 ## Documentation
 
@@ -75,7 +162,8 @@ All hooks return a consistent `BaseMotionReturn` interface:
 
 ## Related Packages
 
-- [`@hua-labs/hua`](https://www.npmjs.com/package/@hua-labs/hua) — UX framework (includes motion)
+- [`@hua-labs/pro`](https://www.npmjs.com/package/@hua-labs/pro) — Advanced motion hooks (orchestration, auto-animations)
+- [`@hua-labs/hua`](https://www.npmjs.com/package/@hua-labs/hua) — Framework (includes motion)
 
 ## Requirements
 
@@ -83,4 +171,4 @@ React >= 19.0.0 · React DOM >= 19.0.0 · TypeScript >= 5.9
 
 ## License
 
-MIT — [HUA Labs](https://github.com/HUA-Labs/HUA-Labs-public)
+MIT — [HUA Labs](https://hua-labs.com)

package/dist/index.js

@@ -467,7 +467,14 @@ var TransitionEffects = class _TransitionEffects {
    */
   enableGPUAcceleration(element) {
     element.style.willChange = "transform, opacity";
-    element.style.transform = "translateZ(0)";
+    const currentTransform = element.style.transform;
+    if (currentTransform && currentTransform !== "none" && currentTransform !== "") {
+      if (!currentTransform.includes("translateZ")) {
+        element.style.transform = `${currentTransform} translateZ(0)`;
+      }
+    } else {
+      element.style.transform = "translateZ(0)";
+    }
   }
   /**
    * 기본 이징 함수