@hua-labs/motion-core 2.1.0-alpha.0.1 → 2.1.0-alpha.0.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 (2) hide show
  1. package/README.md +55 -21
  2. package/package.json +11 -11
package/README.md CHANGED
@@ -1,23 +1,35 @@
1
- # HUA Motion Core
1
+ # @hua-labs/motion-core
2
2
 
3
- The foundation of React motion ✨
3
+ 30+ production-tested React animation hooks. Zero dependencies, SSR-ready.
4
+ 프로덕션 검증 완료 React 애니메이션 훅 30개 이상. 의존성 없음, SSR 지원.
4
5
 
5
- ## Overview
6
+ [![npm version](https://img.shields.io/npm/v/@hua-labs/motion-core.svg)](https://www.npmjs.com/package/@hua-labs/motion-core)
7
+ [![license](https://img.shields.io/npm/l/@hua-labs/motion-core.svg)](https://github.com/HUA-Labs/HUA-Labs-public/blob/main/LICENSE)
6
8
 
7
- HUA Motion Core provides a comprehensive collection of 25 essential motion hooks designed to simplify animation implementation in React applications. Built with TypeScript and extensively tested, it offers intuitive APIs for creating smooth, performant animations.
9
+ > **⚠️ Alpha Release**: This package is currently in alpha. APIs may change before the stable release.
8
10
 
9
- **Every React app needs motion. Start here.**
11
+ ---
12
+
13
+ ## English
14
+
15
+ ### Overview
16
+
17
+ A production-ready collection of 30+ motion hooks optimized for React. Built on a ref-based engine that delivers smooth 60fps animations with zero external dependencies. Every hook is TypeScript-native and SSR-compatible.
18
+
19
+ ### Why motion-core?
10
20
 
11
- ## Features
21
+ motion-core provides essential animation primitives for React applications through direct DOM manipulation. The ref-based approach offers predictable performance characteristics while maintaining a small bundle footprint.
12
22
 
13
- - **25 Essential Hooks** Complete collection covering fade, slide, scale, scroll, and interaction animations
14
- - **TypeScript First** Full type safety with comprehensive type definitions
15
- - **Battle Tested** 74%+ function coverage with 517 test cases
16
- - **Zero Dependencies** Lightweight with no external animation dependencies
17
- - **SSR Ready** Works seamlessly with Next.js and other SSR frameworks
18
- - **Highly Customizable** Extensive configuration options for each hook
23
+ ### Key Features
19
24
 
20
- ## Installation
25
+ - **30+ Optimized Hooks** - Fade, slide, scale, scroll, parallax, and gesture animations
26
+ - **Performance First** - Direct ref manipulation for consistent 60fps
27
+ - **Zero Dependencies** - Pure JavaScript motion engine (~15KB gzipped)
28
+ - **TypeScript Native** - Complete type safety with inferred types
29
+ - **SSR Compatible** - Works with Next.js, Remix, and all SSR frameworks
30
+ - **Battle Tested** - 74%+ coverage with 517 test cases
31
+
32
+ ### Installation
21
33
 
22
34
  ```bash
23
35
  npm install @hua-labs/motion-core
@@ -218,25 +230,47 @@ const fadeIn: BaseMotionReturn<HTMLDivElement> = useFadeIn({
218
230
  - **Motion Advanced** - Complex animations ✅ (Available)
219
231
  - **Motion Enterprise** - Team solutions (Planned)
220
232
 
221
- ## Browser Support
233
+ ### Documentation
234
+
235
+ - [Detailed Guide](./DETAILED_GUIDE.md) - Complete API reference and advanced usage
236
+ - [TypeScript Definitions](./dist/index.d.ts) - Type definitions
237
+
238
+ ### Browser Support
222
239
 
223
240
  - Chrome 60+
224
241
  - Firefox 60+
225
242
  - Safari 12+
226
243
  - Edge 79+
227
244
 
228
- ## Contributing
245
+ ---
229
246
 
230
- We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
247
+ ## Korean
231
248
 
232
- ## License
249
+ ### 개요
233
250
 
234
- MIT License - see [LICENSE](LICENSE) file for details.
251
+ React를 위한 프로덕션 준비 완료 모션 훅 30개 이상의 컬렉션입니다. 외부 의존성 없이 부드러운 60fps 애니메이션을 제공하는 ref 기반 엔진으로 구축되었습니다. 모든 훅은 TypeScript 네이티브이며 SSR과 호환됩니다.
235
252
 
236
- ## Changelog
253
+ ### 주요 기능
237
254
 
238
- See [CHANGELOG.md](CHANGELOG.md) for release history.
255
+ - **30개 이상의 최적화된 훅** - 페이드, 슬라이드, 스케일, 스크롤, 패럴랙스, 제스처 애니메이션
256
+ - **성능 우선** - 일관된 60fps를 위한 직접 ref 조작
257
+ - **의존성 없음** - 순수 JavaScript 모션 엔진 (~15KB gzipped)
258
+ - **TypeScript 네이티브** - 타입 추론이 포함된 완전한 타입 안전성
259
+ - **SSR 호환** - Next.js, Remix 및 모든 SSR 프레임워크와 작동
260
+ - **검증 완료** - 517개 테스트 케이스로 74% 이상 커버리지
261
+
262
+ ### 설치
263
+
264
+ ```bash
265
+ npm install @hua-labs/motion-core
266
+ ```
267
+
268
+ ### 문서
269
+
270
+ - [상세 가이드](./DETAILED_GUIDE.md) - 완전한 API 레퍼런스 및 고급 사용법
239
271
 
240
272
  ---
241
273
 
242
- Built with ❤️ by [HUA Labs](https://github.com/HUA-Labs)
274
+ ## License
275
+
276
+ MIT © HUA Labs
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hua-labs/motion-core",
3
- "version": "2.1.0-alpha.0.1",
3
+ "version": "2.1.0-alpha.0.2",
4
4
  "description": "HUA Motion Core - Essential animation hooks for React developers",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
@@ -30,21 +30,21 @@
30
30
  "react-dom": ">=16.8.0"
31
31
  },
32
32
  "keywords": [
33
+ "hua-labs",
34
+ "react",
35
+ "typescript",
33
36
  "motion",
34
37
  "animation",
35
38
  "hooks",
36
- "react",
37
- "typescript",
39
+ "transitions",
40
+ "gestures",
41
+ "scroll",
38
42
  "fade",
39
43
  "slide",
40
- "scale",
41
- "bounce",
42
- "pulse",
43
- "scroll",
44
- "hover",
45
- "click",
46
- "korean",
47
- "english"
44
+ "spring",
45
+ "performance",
46
+ "ssr",
47
+ "nextjs"
48
48
  ],
49
49
  "author": "HUA Labs",
50
50
  "license": "MIT",