@hua-labs/motion-core 2.0.0 → 2.0.1

package/dist/managers/MotionStateManager.js

@@ -0,0 +1,159 @@
+/**
+ * MotionStateManager - 모션 상태 관리 클래스
+ *
+ * 상태 충돌 문제 해결을 위해 3가지 상태를 분리:
+ * - internalVisibility: 내부 로직 (초기화, 리셋 등)
+ * - triggeredVisibility: 외부 트리거 (Intersection Observer)
+ * - finalVisibility: 최종 계산된 상태
+ */
+export class MotionStateManager {
+    constructor() {
+        this.states = new Map();
+        this.listeners = new Map();
+    }
+    /**
+     * 요소의 상태를 초기화
+     */
+    initializeElement(elementId, config) {
+        const initialState = {
+            internalVisibility: false, // 초기에 숨김 상태로 시작 (스크롤 리빌용)
+            triggeredVisibility: false, // Intersection Observer가 아직 트리거되지 않음
+            finalVisibility: false, // 초기에 숨김 상태로 시작
+            opacity: 0, // 초기에 투명 상태로 시작
+            translateY: 20, // 초기에 아래로 이동된 상태로 시작
+            translateX: 0,
+            scale: 0.95, // 초기에 약간 축소된 상태로 시작
+            rotation: 0,
+            isHovered: false,
+            isClicked: false,
+            isAnimating: false
+        };
+        this.states.set(elementId, initialState);
+        this.computeFinalState(elementId);
+    }
+    /**
+     * 내부 가시성 상태 업데이트 (초기화, 리셋 등)
+     */
+    setInternalVisibility(elementId, visible) {
+        const state = this.states.get(elementId);
+        if (!state)
+            return;
+        state.internalVisibility = visible;
+        this.computeFinalState(elementId);
+        this.notifyListeners(elementId, state);
+    }
+    /**
+     * 외부 트리거 가시성 상태 업데이트 (Intersection Observer)
+     */
+    setTriggeredVisibility(elementId, visible) {
+        const state = this.states.get(elementId);
+        if (!state)
+            return;
+        state.triggeredVisibility = visible;
+        this.computeFinalState(elementId);
+        this.notifyListeners(elementId, state);
+    }
+    /**
+     * 모션 값 업데이트
+     */
+    updateMotionValues(elementId, values) {
+        const state = this.states.get(elementId);
+        if (!state)
+            return;
+        Object.assign(state, values);
+        this.notifyListeners(elementId, state);
+    }
+    /**
+     * 최종 상태 계산
+     */
+    computeFinalState(elementId) {
+        const state = this.states.get(elementId);
+        if (!state)
+            return;
+        // 내부 또는 외부 트리거 중 하나라도 true면 최종적으로 보임
+        state.finalVisibility = state.internalVisibility || state.triggeredVisibility;
+        // 모션 중 상태 업데이트
+        state.isAnimating = state.finalVisibility && (state.opacity < 1 || state.translateY > 0);
+    }
+    /**
+     * 현재 상태 조회
+     */
+    getState(elementId) {
+        return this.states.get(elementId);
+    }
+    /**
+     * 모든 상태 조회
+     */
+    getAllStates() {
+        return new Map(this.states);
+    }
+    /**
+     * 상태 변경 리스너 등록
+     */
+    subscribe(elementId, listener) {
+        if (!this.listeners.has(elementId)) {
+            this.listeners.set(elementId, new Set());
+        }
+        this.listeners.get(elementId).add(listener);
+        // 구독 해제 함수 반환
+        return () => {
+            const listeners = this.listeners.get(elementId);
+            if (listeners) {
+                listeners.delete(listener);
+            }
+        };
+    }
+    /**
+     * 리스너들에게 상태 변경 알림
+     */
+    notifyListeners(elementId, state) {
+        const listeners = this.listeners.get(elementId);
+        if (!listeners)
+            return;
+        listeners.forEach(listener => {
+            try {
+                listener(state);
+            }
+            catch (error) {
+                if (process.env.NODE_ENV === 'development') {
+                    console.error(`MotionStateManager listener error for ${elementId}:`, error);
+                }
+            }
+        });
+    }
+    /**
+     * 모든 상태 초기화
+     */
+    reset() {
+        this.states.clear();
+        this.listeners.clear();
+    }
+    /**
+     * 특정 요소 상태 초기화
+     */
+    resetElement(elementId) {
+        this.states.delete(elementId);
+        this.listeners.delete(elementId);
+    }
+    /**
+     * 디버그용 상태 출력
+     */
+    debug() {
+        if (process.env.NODE_ENV === 'development') {
+            console.log('MotionStateManager Debug:');
+            this.states.forEach((state, elementId) => {
+                console.log(`  ${elementId}:`, {
+                    internalVisibility: state.internalVisibility,
+                    triggeredVisibility: state.triggeredVisibility,
+                    finalVisibility: state.finalVisibility,
+                    opacity: state.opacity,
+                    translateY: state.translateY,
+                    isAnimating: state.isAnimating
+                });
+            });
+        }
+    }
+}
+// 싱글톤 인스턴스
+export const motionStateManager = new MotionStateManager();
+//# sourceMappingURL=MotionStateManager.js.map

package/dist/managers/MotionStateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MotionStateManager.js","sourceRoot":"","sources":["../../src/managers/MotionStateManager.ts"],"names":[],"mappings":"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"}

package/dist/presets/index.d.ts

@@ -0,0 +1,16 @@
+import type { MotionPreset, PresetConfig, PageType, PageMotionsConfig } from '../types';
+export declare const MOTION_PRESETS: PresetConfig;
+export declare const PAGE_MOTIONS: Record<PageType, PageMotionsConfig>;
+/**
+ * 프리셋과 커스텀 설정을 병합
+ */
+export declare function mergeWithPreset(preset: MotionPreset, custom?: Partial<MotionPreset>): MotionPreset;
+/**
+ * 페이지 타입으로 프리셋 가져오기
+ */
+export declare function getPagePreset(pageType: PageType): PageMotionsConfig;
+/**
+ * 모션 타입으로 기본 프리셋 가져오기
+ */
+export declare function getMotionPreset(type: string): MotionPreset;
+//# sourceMappingURL=index.d.ts.map

package/dist/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAMvF,eAAO,MAAM,cAAc,EAAE,YA2C5B,CAAA;AAMD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CA4C5D,CAAA;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,YAAY,CAKd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE1D"}

package/dist/presets/index.js

@@ -0,0 +1,120 @@
+// ========================================
+// HUA Motion SDK - Preset System
+// ========================================
+// ========================================
+// 기본 모션 프리셋
+// ========================================
+export const MOTION_PRESETS = {
+    hero: {
+        entrance: 'fadeIn',
+        delay: 200,
+        duration: 800,
+        hover: false,
+        click: false
+    },
+    title: {
+        entrance: 'slideUp',
+        delay: 400,
+        duration: 700,
+        hover: false,
+        click: false
+    },
+    button: {
+        entrance: 'scaleIn',
+        delay: 600,
+        duration: 300,
+        hover: true,
+        click: true
+    },
+    card: {
+        entrance: 'slideUp',
+        delay: 800,
+        duration: 500,
+        hover: true,
+        click: false
+    },
+    text: {
+        entrance: 'fadeIn',
+        delay: 200,
+        duration: 600,
+        hover: false,
+        click: false
+    },
+    image: {
+        entrance: 'scaleIn',
+        delay: 400,
+        duration: 600,
+        hover: true,
+        click: false
+    }
+};
+// ========================================
+// 페이지별 프리셋 (1단계: useSimplePageMotion)
+// ========================================
+export const PAGE_MOTIONS = {
+    // 홈페이지
+    home: {
+        hero: { type: 'hero' },
+        title: { type: 'title' },
+        description: { type: 'text' },
+        cta: { type: 'button' },
+        feature1: { type: 'card' },
+        feature2: { type: 'card' },
+        feature3: { type: 'card' }
+    },
+    // 대시보드
+    dashboard: {
+        header: { type: 'hero' },
+        sidebar: { type: 'card', entrance: 'slideLeft' },
+        main: { type: 'text', entrance: 'fadeIn' },
+        card1: { type: 'card' },
+        card2: { type: 'card' },
+        card3: { type: 'card' },
+        chart: { type: 'image' }
+    },
+    // 제품 페이지
+    product: {
+        hero: { type: 'hero' },
+        title: { type: 'title' },
+        image: { type: 'image' },
+        description: { type: 'text' },
+        price: { type: 'text' },
+        buyButton: { type: 'button' },
+        features: { type: 'card' }
+    },
+    // 블로그
+    blog: {
+        header: { type: 'hero' },
+        title: { type: 'title' },
+        content: { type: 'text' },
+        sidebar: { type: 'card', entrance: 'slideRight' },
+        related1: { type: 'card' },
+        related2: { type: 'card' },
+        related3: { type: 'card' }
+    }
+};
+// ========================================
+// 프리셋 유틸리티 함수
+// ========================================
+/**
+ * 프리셋과 커스텀 설정을 병합
+ */
+export function mergeWithPreset(preset, custom = {}) {
+    return {
+        ...preset,
+        ...custom
+    };
+}
+/**
+ * 페이지 타입으로 프리셋 가져오기
+ */
+export function getPagePreset(pageType) {
+    return PAGE_MOTIONS[pageType];
+}
+/**
+ * 모션 타입으로 기본 프리셋 가져오기
+ */
+export function getMotionPreset(type) {
+    return MOTION_PRESETS[type] || MOTION_PRESETS.text;
+}
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"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"}

package/dist/types/common.d.ts

@@ -0,0 +1,155 @@
+import { RefObject, CSSProperties } from 'react';
+export type MotionElement = HTMLDivElement | HTMLSpanElement | HTMLButtonElement | HTMLHeadingElement | HTMLParagraphElement | HTMLImageElement;
+export type MotionRef<T extends MotionElement = HTMLDivElement> = RefObject<T | null>;
+export type MotionStyle = CSSProperties & {
+    '--motion-delay'?: string;
+    '--motion-duration'?: string;
+    '--motion-easing'?: string;
+    '--motion-progress'?: string;
+};
+export interface BaseMotionOptions {
+    /** 모션 시작 지연 시간 (ms) */
+    delay?: number;
+    /** 모션 지속 시간 (ms) */
+    duration?: number;
+    /** Intersection Observer 임계값 (0-1) */
+    threshold?: number;
+    /** 한 번만 트리거할지 여부 */
+    triggerOnce?: boolean;
+    /** 이징 함수명 */
+    easing?: string;
+    /** 자동 시작 여부 */
+    autoStart?: boolean;
+    /** 모션 완료 시 콜백 */
+    onComplete?: () => void;
+    /** 모션 시작 시 콜백 */
+    onStart?: () => void;
+    /** 모션 중단 시 콜백 */
+    onStop?: () => void;
+    /** 모션 리셋 시 콜백 */
+    onReset?: () => void;
+}
+export interface BaseMotionReturn<T extends MotionElement = HTMLDivElement> {
+    /** DOM 요소 참조 (React 19 호환) */
+    ref: React.RefObject<T | null>;
+    /** 요소가 화면에 보이는지 여부 */
+    isVisible: boolean;
+    /** 모션이 진행 중인지 여부 */
+    isAnimating: boolean;
+    /** 적용할 CSS 스타일 (React 19 호환) - useFadeIn 등에서는 항상 반환됨 */
+    style: MotionStyle;
+    /** 적용할 CSS 클래스명 */
+    className?: string;
+    /** 모션 진행률 (0-1) - useFadeIn 등에서는 항상 반환됨 */
+    progress: number;
+    /** 모션 시작 함수 - useFadeIn 등에서는 항상 반환됨 */
+    start: () => void;
+    /** 모션 리셋 함수 - useFadeIn 등에서는 항상 반환됨 */
+    reset: () => void;
+    /** 모션 중단 함수 - useFadeIn 등에서는 항상 반환됨 */
+    stop: () => void;
+    /** 모션 일시정지 함수 - 일부 훅에서만 제공 */
+    pause?: () => void;
+    /** 모션 재개 함수 - 일부 훅에서만 제공 */
+    resume?: () => void;
+}
+export interface InteractionReturn<T extends MotionElement = HTMLDivElement> extends BaseMotionReturn<T> {
+    /** 가시성 토글 함수 */
+    toggle?: () => void;
+    /** 표시 함수 */
+    show?: () => void;
+    /** 숨김 함수 */
+    hide?: () => void;
+}
+export interface FadeInOptions extends BaseMotionOptions {
+    /** 초기 투명도 */
+    initialOpacity?: number;
+    /** 목표 투명도 */
+    targetOpacity?: number;
+}
+export interface SlideOptions extends BaseMotionOptions {
+    /** 슬라이드 방향 */
+    direction?: 'up' | 'down' | 'left' | 'right';
+    /** 슬라이드 거리 (px) */
+    distance?: number;
+}
+export interface ScaleOptions extends BaseMotionOptions {
+    /** 초기 스케일 */
+    initialScale?: number;
+    /** 목표 스케일 */
+    targetScale?: number;
+}
+export interface BounceOptions extends BaseMotionOptions {
+    /** 바운스 강도 */
+    intensity?: number;
+    /** 바운스 횟수 */
+    bounces?: number;
+}
+export interface PulseOptions extends BaseMotionOptions {
+    /** 펄스 강도 */
+    intensity?: number;
+    /** 반복 횟수 (-1 = 무한) */
+    repeatCount?: number;
+    /** 반복 간격 (ms) */
+    repeatDelay?: number;
+}
+export interface SpringOptions extends BaseMotionOptions {
+    /** 스프링 질량 */
+    mass?: number;
+    /** 스프링 강성 */
+    stiffness?: number;
+    /** 스프링 감쇠 */
+    damping?: number;
+    /** 정지 임계값 */
+    restDelta?: number;
+    /** 정지 속도 */
+    restSpeed?: number;
+}
+export interface GestureOptions extends BaseMotionOptions {
+    /** 호버 제스처 활성화 */
+    hover?: boolean;
+    /** 드래그 제스처 활성화 */
+    drag?: boolean;
+    /** 핀치 제스처 활성화 */
+    pinch?: boolean;
+    /** 스와이프 제스처 활성화 */
+    swipe?: boolean;
+    /** 틸트 제스처 활성화 */
+    tilt?: boolean;
+}
+export interface OrchestrationOptions extends BaseMotionOptions {
+    /** 모션 시퀀스 타입 */
+    sequence?: 'sequential' | 'parallel' | 'stagger';
+    /** 스태거 지연 시간 */
+    staggerDelay?: number;
+    /** 스태거 지속 시간 */
+    staggerDuration?: number;
+}
+export type MotionDirection = 'up' | 'down' | 'left' | 'right';
+export type MotionEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'bounce' | 'elastic';
+export type MotionSequence = 'sequential' | 'parallel' | 'stagger';
+export type MotionTrigger = 'scroll' | 'click' | 'hover' | 'focus' | 'auto';
+export type MotionCallback = () => void;
+export type MotionProgressCallback = (progress: number) => void;
+export type MotionStateCallback<T extends MotionElement = HTMLDivElement> = (state: BaseMotionReturn<T>) => void;
+export interface PerformanceMetrics {
+    /** 모션 시작 시간 */
+    startTime: number;
+    /** 모션 종료 시간 */
+    endTime?: number;
+    /** 총 지속 시간 */
+    duration: number;
+    /** FPS */
+    fps: number;
+    /** 메모리 사용량 */
+    memoryUsage?: number;
+}
+export interface MotionConfig {
+    /** 성능 모니터링 활성화 */
+    enablePerformanceMonitoring?: boolean;
+    /** 디버그 모드 활성화 */
+    debug?: boolean;
+    /** 로그 레벨 */
+    logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"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"}

package/dist/types/common.js

@@ -0,0 +1,5 @@
+// ========================================
+// HUA Motion SDK - 공통 타입 정의 (React 19 호환)
+// ========================================
+export {};
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,0CAA0C;AAC1C,2CAA2C"}

package/dist/types/index.d.ts

@@ -1,109 +1,77 @@
-import { RefObject, CSSProperties } from 'react';
-export type MotionElement = HTMLDivElement | HTMLSpanElement | HTMLButtonElement | HTMLHeadingElement | HTMLParagraphElement | HTMLImageElement;
-export type MotionRef<T extends MotionElement = HTMLDivElement> = RefObject<T | null>;
-export type MotionStyle = CSSProperties & {
-    '--motion-delay'?: string;
-    '--motion-duration'?: string;
-    '--motion-easing'?: string;
-    '--motion-progress'?: string;
-};
-export interface BaseMotionOptions {
-    /** 모션 시작 지연 시간 (ms) */
+import { BaseMotionOptions, BaseMotionReturn } from './common';
+export * from './common';
+export type PageType = 'home' | 'dashboard' | 'product' | 'blog';
+export type MotionType = 'hero' | 'title' | 'button' | 'card' | 'text' | 'image';
+export type EntranceType = 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+export interface PageMotionElement {
+    type: MotionType;
+    entrance?: EntranceType;
+    hover?: boolean;
+    click?: boolean;
     delay?: number;
-    /** 모션 지속 시간 (ms) */
     duration?: number;
-    /** Intersection Observer 임계값 (0-1) */
     threshold?: number;
-    /** 한 번만 트리거할지 여부 */
-    triggerOnce?: boolean;
-    /** 이징 함수명 */
-    easing?: string;
-    /** 자동 시작 여부 */
-    autoStart?: boolean;
-    /** 모션 완료 시 콜백 */
-    onComplete?: () => void;
-    /** 모션 시작 시 콜백 */
-    onStart?: () => void;
-    /** 모션 중단 시 콜백 */
-    onStop?: () => void;
-    /** 모션 리셋 시 콜백 */
-    onReset?: () => void;
 }
-export interface BaseMotionReturn<T extends MotionElement = HTMLDivElement> {
-    /** DOM 요소 참조 */
-    ref: MotionRef<T>;
-    /** 요소가 화면에 보이는지 여부 */
-    isVisible: boolean;
-    /** 모션이 진행 중인지 여부 */
+export interface PageMotionsConfig {
+    [elementId: string]: PageMotionElement;
+}
+export interface MotionState {
+    internalVisibility: boolean;
+    triggeredVisibility: boolean;
+    finalVisibility: boolean;
+    opacity: number;
+    translateY: number;
+    translateX: number;
+    scale: number;
+    rotation: number;
+    isHovered: boolean;
+    isClicked: boolean;
     isAnimating: boolean;
-    /** 적용할 CSS 스타일 */
-    style?: MotionStyle;
-    /** 적용할 CSS 클래스명 */
-    className?: string;
-    /** 모션 진행률 (0-1) */
-    progress?: number;
-    /** 모션 시작 함수 */
-    start?: () => void;
-    /** 모션 리셋 함수 */
-    reset?: () => void;
-    /** 모션 중단 함수 */
-    stop?: () => void;
-    /** 모션 일시정지 함수 */
-    pause?: () => void;
-    /** 모션 재개 함수 */
-    resume?: () => void;
-    /** 모션 토글 함수 (선택적) */
-    toggle?: () => void;
 }
-export interface InteractionReturn<T extends MotionElement = HTMLDivElement> extends BaseMotionReturn<T> {
-    start: () => void;
+export interface MotionRef<T extends HTMLElement = HTMLElement> {
+    ref: React.RefObject<T | null>;
+    style: React.CSSProperties;
     isVisible: boolean;
-    focus?: () => void;
-    blur?: () => void;
-    hover?: () => void;
-    leave?: () => void;
-    click?: () => void;
-    release?: () => void;
-    show?: () => void;
-    hide?: () => void;
-    isFocused?: boolean;
-    isHovered?: boolean;
-    isClicked?: boolean;
+    isHovered: boolean;
+    isClicked: boolean;
+}
+export interface SmartMotionOptions<T extends HTMLElement = HTMLElement> extends BaseMotionOptions {
+    type?: MotionType;
+    entrance?: EntranceType;
+    hover?: boolean;
+    click?: boolean;
+}
+export interface SmartMotionReturn<T extends HTMLElement = HTMLElement> extends BaseMotionReturn<T> {
+    isHovered: boolean;
+    isClicked: boolean;
 }
-export interface FadeInOptions extends BaseMotionOptions {
-    /** 초기 투명도 */
-    initialOpacity?: number;
-    /** 목표 투명도 */
-    targetOpacity?: number;
+export interface MotionPreset {
+    entrance: EntranceType;
+    delay: number;
+    duration: number;
+    hover: boolean;
+    click: boolean;
 }
-export interface SlideOptions extends BaseMotionOptions {
-    /** 슬라이드 방향 */
-    direction?: 'up' | 'down' | 'left' | 'right';
-    /** 슬라이드 거리 (px) */
-    distance?: number;
+export interface PresetConfig {
+    [key: string]: MotionPreset;
 }
-export interface ScaleOptions extends BaseMotionOptions {
-    /** 초기 스케일 */
-    initialScale?: number;
-    /** 목표 스케일 */
-    targetScale?: number;
+export interface SpringConfig {
+    mass?: number;
+    stiffness?: number;
+    damping?: number;
+    restDelta?: number;
+    restSpeed?: number;
 }
-export interface BounceOptions extends BaseMotionOptions {
-    /** 바운스 높이 (px) */
-    bounceHeight?: number;
-    /** 바운스 횟수 */
-    bounceCount?: number;
+export interface GestureConfig {
+    hover?: boolean;
+    drag?: boolean;
+    pinch?: boolean;
+    swipe?: boolean;
+    tilt?: boolean;
 }
-export interface PulseOptions extends BaseMotionOptions {
-    /** 펄스 스케일 */
-    pulseScale?: number;
-    /** 반복 횟수 */
-    pulseCount?: number;
+export interface OrchestrationConfig {
+    sequence?: 'sequential' | 'parallel' | 'stagger';
+    staggerDelay?: number;
+    staggerDuration?: number;
 }
-export type MotionDirection = 'up' | 'down' | 'left' | 'right';
-export type MotionEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
-export type MotionTrigger = 'scroll' | 'click' | 'hover' | 'focus' | 'auto';
-export type MotionCallback = () => void;
-export type MotionProgressCallback = (progress: number) => void;
-export type MotionStateCallback<T extends MotionElement = HTMLDivElement> = (state: BaseMotionReturn<T>) => void;
 //# sourceMappingURL=index.d.ts.map