@hua-labs/motion-core 2.3.0 → 2.4.1

package/dist/springPhysics-BZVRi9PQ.d.ts

@@ -0,0 +1,740 @@
+import * as react from 'react';
+import { CSSProperties, RefObject } from 'react';
+
+/**
+ * HUA Motion Core - 의존성 제로 모션 엔진
+ *
+ * 순수 JavaScript로 구현된 고성능 모션 엔진
+ * GPU 가속, 레이어 분리, 성능 최적화 포함
+ */
+interface MotionFrame {
+    progress: number;
+    properties: {
+        opacity?: number;
+        transform?: string;
+        scale?: number;
+        translateX?: number;
+        translateY?: number;
+        rotate?: number;
+        rotateX?: number;
+        rotateY?: number;
+        rotateZ?: number;
+        skewX?: number;
+        skewY?: number;
+    };
+}
+interface MotionOptions {
+    duration: number;
+    easing: (t: number) => number;
+    delay?: number;
+    direction?: 'forward' | 'reverse' | 'alternate';
+    iterations?: number;
+    fill?: 'none' | 'forwards' | 'backwards' | 'both';
+    onStart?: () => void;
+    onUpdate?: (progress: number) => void;
+    onComplete?: () => void;
+    onCancel?: () => void;
+}
+interface Motion {
+    id: string;
+    element: HTMLElement;
+    isRunning: boolean;
+    isPaused: boolean;
+    currentProgress: number;
+    startTime: number;
+    pauseTime: number;
+    options: MotionOptions;
+}
+declare class MotionEngine {
+    private motions;
+    private isRunning;
+    private animationFrameId;
+    /**
+     * 모션 시작
+     */
+    motion(element: HTMLElement, motionFrames: MotionFrame[], options: MotionOptions): Promise<string>;
+    /**
+     * 모션 중지
+     */
+    stop(motionId: string): void;
+    /**
+     * 모션 일시정지
+     */
+    pause(motionId: string): void;
+    /**
+     * 모션 재개
+     */
+    resume(motionId: string): void;
+    /**
+     * 모든 모션 중지
+     */
+    stopAll(): void;
+    /**
+     * 모션 상태 확인
+     */
+    getMotion(motionId: string): Motion | undefined;
+    /**
+     * 실행 중인 모션 수
+     */
+    getActiveMotionCount(): number;
+    /**
+     * 애니메이션 루프 시작
+     */
+    private startAnimationLoop;
+    /**
+     * 애니메이션 루프 중지
+     */
+    private stopAnimationLoop;
+    /**
+     * 메인 애니메이션 루프
+     */
+    private animate;
+    /**
+     * 모션 프레임 적용
+     */
+    private applyMotionFrame;
+    /**
+     * GPU 가속 활성화
+     */
+    private enableGPUAcceleration;
+    /**
+     * 레이어 분리
+     */
+    private createLayer;
+    /**
+     * 고유 모션 ID 생성
+     */
+    private generateMotionId;
+    /**
+     * 정리
+     */
+    destroy(): void;
+}
+declare const motionEngine: MotionEngine;
+
+/**
+ * HUA Motion Core - 전환 효과 시스템
+ *
+ * CSS Motion API를 활용한 고성능 전환 효과들
+ * GPU 가속 및 레이어 분리 최적화 포함
+ */
+
+type TransitionType = 'fade' | 'slide' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'scale' | 'flip' | 'morph' | 'cube' | 'zoom';
+interface TransitionOptions extends Omit<MotionOptions, 'easing'> {
+    type: TransitionType;
+    easing?: (t: number) => number;
+    distance?: number;
+    scale?: number;
+    perspective?: number;
+    onTransitionStart?: () => void;
+    onTransitionComplete?: () => void;
+}
+declare class TransitionEffects {
+    private static instance;
+    private activeTransitions;
+    static getInstance(): TransitionEffects;
+    /**
+     * 공통 전환 실행 헬퍼
+     */
+    private executeTransition;
+    /**
+     * 페이드 인/아웃 전환
+     */
+    fade(element: HTMLElement, options: Omit<TransitionOptions, 'type'>): Promise<void>;
+    /**
+     * 슬라이드 전환
+     */
+    slide(element: HTMLElement, options: Omit<TransitionOptions, 'type'>): Promise<void>;
+    /**
+     * 스케일 전환
+     */
+    scale(element: HTMLElement, options: Omit<TransitionOptions, 'type'>): Promise<void>;
+    /**
+     * 플립 전환 (3D 회전)
+     */
+    flip(element: HTMLElement, options: Omit<TransitionOptions, 'type'>): Promise<void>;
+    /**
+     * 큐브 전환 (3D 큐브 회전)
+     */
+    cube(element: HTMLElement, options: Omit<TransitionOptions, 'type'>): Promise<void>;
+    /**
+     * 모프 전환 (복합 변형)
+     */
+    morph(element: HTMLElement, options: Omit<TransitionOptions, 'type'>): Promise<void>;
+    /**
+     * 전환 중지
+     */
+    stopTransition(transitionId: string): void;
+    /**
+     * 모든 전환 중지
+     */
+    stopAllTransitions(): void;
+    /**
+     * 활성 전환 수 확인
+     */
+    getActiveTransitionCount(): number;
+    /**
+     * GPU 가속 활성화
+     */
+    private enableGPUAcceleration;
+    /**
+     * 기본 이징 함수
+     */
+    private getDefaultEasing;
+    /**
+     * 고유 전환 ID 생성
+     */
+    private generateTransitionId;
+    /**
+     * 정리
+     */
+    destroy(): void;
+}
+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;
+};
+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;
+}
+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;
+}
+interface InteractionReturn<T extends MotionElement = HTMLDivElement> extends BaseMotionReturn<T> {
+    /** 가시성 토글 함수 */
+    toggle?: () => void;
+    /** 표시 함수 */
+    show?: () => void;
+    /** 숨김 함수 */
+    hide?: () => void;
+}
+interface FadeInOptions extends BaseMotionOptions {
+    /** 초기 투명도 */
+    initialOpacity?: number;
+    /** 목표 투명도 */
+    targetOpacity?: number;
+}
+interface SlideOptions extends BaseMotionOptions {
+    /** 슬라이드 방향 */
+    direction?: "up" | "down" | "left" | "right";
+    /** 슬라이드 거리 (px) */
+    distance?: number;
+}
+interface ScaleOptions extends BaseMotionOptions {
+    /** 초기 스케일 */
+    initialScale?: number;
+    /** 목표 스케일 */
+    targetScale?: number;
+}
+interface BounceOptions extends BaseMotionOptions {
+    /** 바운스 강도 */
+    intensity?: number;
+    /** 바운스 횟수 */
+    bounces?: number;
+}
+interface PulseOptions extends BaseMotionOptions {
+    /** 펄스 강도 */
+    intensity?: number;
+    /** 반복 횟수 (-1 = 무한) */
+    repeatCount?: number;
+    /** 반복 간격 (ms) */
+    repeatDelay?: number;
+}
+interface SpringOptions extends BaseMotionOptions {
+    /** 스프링 질량 */
+    mass?: number;
+    /** 스프링 강성 */
+    stiffness?: number;
+    /** 스프링 감쇠 */
+    damping?: number;
+    /** 정지 임계값 */
+    restDelta?: number;
+    /** 정지 속도 */
+    restSpeed?: number;
+}
+interface GestureOptions extends BaseMotionOptions {
+    /** 호버 제스처 활성화 */
+    hover?: boolean;
+    /** 드래그 제스처 활성화 */
+    drag?: boolean;
+    /** 핀치 제스처 활성화 */
+    pinch?: boolean;
+    /** 스와이프 제스처 활성화 */
+    swipe?: boolean;
+    /** 틸트 제스처 활성화 */
+    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 MotionCallback = () => void;
+type MotionProgressCallback = (progress: number) => void;
+type MotionStateCallback<T extends MotionElement = HTMLDivElement> = (state: BaseMotionReturn<T>) => void;
+interface PerformanceMetrics {
+    /** 모션 시작 시간 */
+    startTime: number;
+    /** 모션 종료 시간 */
+    endTime?: number;
+    /** 총 지속 시간 */
+    duration: number;
+    /** FPS */
+    fps: number;
+    /** 메모리 사용량 */
+    memoryUsage?: number;
+}
+interface MotionConfig {
+    /** 성능 모니터링 활성화 */
+    enablePerformanceMonitoring?: boolean;
+    /** 디버그 모드 활성화 */
+    debug?: boolean;
+    /** 로그 레벨 */
+    logLevel?: "none" | "error" | "warn" | "info" | "debug";
+}
+interface InViewOptions {
+    /** Intersection Observer 임계값 */
+    threshold?: number | number[];
+    /** 루트 마진 */
+    rootMargin?: string;
+    /** 한 번만 트리거할지 여부 */
+    triggerOnce?: boolean;
+    /** 초기 가시성 상태 */
+    initialInView?: boolean;
+}
+interface InViewReturn<T extends HTMLElement = HTMLDivElement> {
+    /** DOM 요소 참조 */
+    ref: RefObject<T | null>;
+    /** 요소가 화면에 보이는지 여부 */
+    inView: boolean;
+    /** IntersectionObserver 엔트리 */
+    entry: IntersectionObserverEntry | null;
+}
+interface MouseOptions {
+    /** 타겟 요소 참조 */
+    targetRef?: RefObject<HTMLElement | null>;
+    /** 스로틀 시간 (ms) */
+    throttle?: number;
+}
+interface MouseReturn {
+    /** 마우스 X 좌표 (viewport 기준) */
+    x: number;
+    /** 마우스 Y 좌표 (viewport 기준) */
+    y: number;
+    /** 요소 내 상대 X 좌표 (0-1) */
+    elementX: number;
+    /** 요소 내 상대 Y 좌표 (0-1) */
+    elementY: number;
+    /** 마우스가 타겟 위에 있는지 여부 */
+    isOver: boolean;
+}
+interface ReducedMotionReturn {
+    /** 사용자가 모션 감소를 선호하는지 여부 */
+    prefersReducedMotion: boolean;
+}
+interface WindowSizeOptions {
+    /** 디바운스 시간 (ms) */
+    debounce?: number;
+    /** 초기 너비 */
+    initialWidth?: number;
+    /** 초기 높이 */
+    initialHeight?: number;
+}
+interface WindowSizeReturn {
+    /** 윈도우 너비 */
+    width: number;
+    /** 윈도우 높이 */
+    height: number;
+    /** 마운트 여부 (SSR 대응) */
+    isMounted: boolean;
+}
+type ScrollRevealMotionType = "fadeIn" | "slideUp" | "slideLeft" | "slideRight" | "scaleIn" | "bounceIn";
+interface ScrollRevealOptions extends BaseMotionOptions {
+    /** 루트 마진 */
+    rootMargin?: string;
+    /** 모션 타입 */
+    motionType?: ScrollRevealMotionType;
+}
+interface GradientOptions extends BaseMotionOptions {
+    /** 그라디언트 색상 배열 */
+    colors?: string[];
+    /** 그라디언트 방향 */
+    direction?: "horizontal" | "vertical" | "diagonal";
+    /** 그라디언트 크기 (%) */
+    size?: number;
+}
+interface ToggleMotionOptions extends BaseMotionOptions {
+}
+interface RepeatOptions extends BaseMotionOptions {
+    /** 반복 효과 타입 */
+    type?: "pulse" | "bounce" | "wave" | "fade";
+    /** 효과 강도 */
+    intensity?: number;
+}
+interface HoverMotionOptions extends BaseMotionOptions {
+    /** 호버 시 스케일 */
+    hoverScale?: number;
+    /** 호버 시 Y 오프셋 (px) */
+    hoverY?: number;
+    /** 호버 시 투명도 */
+    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";
+interface PageMotionElement {
+    type: MotionType;
+    entrance?: EntranceType;
+    hover?: boolean;
+    click?: boolean;
+    delay?: number;
+    duration?: number;
+    threshold?: number;
+}
+interface PageMotionsConfig {
+    [elementId: string]: PageMotionElement;
+}
+interface MotionState {
+    internalVisibility: boolean;
+    triggeredVisibility: boolean;
+    finalVisibility: boolean;
+    opacity: number;
+    translateY: number;
+    translateX: number;
+    scale: number;
+    rotation: number;
+    isHovered: boolean;
+    isClicked: boolean;
+    isAnimating: boolean;
+}
+interface PageMotionRef<T extends HTMLElement = HTMLElement> {
+    ref: React.RefObject<T | null>;
+    style: React.CSSProperties;
+    isVisible: boolean;
+    isHovered: boolean;
+    isClicked: boolean;
+}
+interface MotionPreset {
+    entrance: EntranceType;
+    delay: number;
+    duration: number;
+    hover: boolean;
+    click: boolean;
+}
+interface PresetConfig {
+    [key: string]: MotionPreset;
+}
+interface SpringConfig$1 {
+    mass?: number;
+    stiffness?: number;
+    damping?: number;
+    restDelta?: number;
+    restSpeed?: number;
+}
+interface GestureConfig {
+    hover?: boolean;
+    drag?: boolean;
+    pinch?: boolean;
+    swipe?: boolean;
+    tilt?: boolean;
+}
+/** @deprecated Renamed to SequenceOrchestrationConfig to avoid collision with useOrchestration's config. */
+type OrchestrationConfig = SequenceOrchestrationConfig;
+interface SequenceOrchestrationConfig {
+    sequence?: "sequential" | "parallel" | "stagger";
+    staggerDelay?: number;
+    staggerDuration?: number;
+}
+
+declare const MOTION_PRESETS: PresetConfig;
+declare const PAGE_MOTIONS: Record<PageType, PageMotionsConfig>;
+/**
+ * 프리셋과 커스텀 설정을 병합
+ */
+declare function mergeWithPreset(preset: MotionPreset, custom?: Partial<MotionPreset>): MotionPreset;
+/**
+ * 페이지 타입으로 프리셋 가져오기
+ */
+declare function getPagePreset(pageType: PageType): PageMotionsConfig;
+/**
+ * 모션 타입으로 기본 프리셋 가져오기
+ */
+declare function getMotionPreset(type: string): MotionPreset;
+
+/** 프로필 전체의 기본 모션 디폴트 */
+interface MotionProfileBase {
+    /** 기본 duration (ms) */
+    duration: number;
+    /** 기본 easing (CSS 또는 named preset) */
+    easing: string;
+    /** IntersectionObserver 임계값 */
+    threshold: number;
+    /** 한 번만 트리거할지 여부 */
+    triggerOnce: boolean;
+}
+/** 입장 애니메이션 디폴트 */
+interface MotionProfileEntrance {
+    slide: {
+        /** 슬라이드 거리 (px) */
+        distance: number;
+        /** 슬라이드 전용 이징 */
+        easing: string;
+    };
+    fade: {
+        /** 초기 투명도 */
+        initialOpacity: number;
+    };
+    scale: {
+        /** 초기 스케일 (useScrollReveal/useStagger용, 0.95 등 미세 변화) */
+        from: number;
+    };
+    bounce: {
+        /** 바운스 강도 */
+        intensity: number;
+        /** 바운스 전용 이징 */
+        easing: string;
+    };
+}
+/** 스태거 디폴트 */
+interface MotionProfileStagger {
+    /** 아이템 간 딜레이 (ms) */
+    perItem: number;
+    /** 첫 아이템 전 딜레이 (ms) */
+    baseDelay: number;
+}
+/** 인터랙션 디폴트 */
+interface MotionProfileInteraction {
+    hover: {
+        /** 호버 시 스케일 */
+        scale: number;
+        /** 호버 시 Y 오프셋 (px) */
+        y: number;
+        /** 호버 duration (ms) */
+        duration: number;
+        /** 호버 이징 */
+        easing: string;
+    };
+}
+/** 스프링 물리 디폴트 */
+interface MotionProfileSpring {
+    /** 질량 */
+    mass: number;
+    /** 강성 */
+    stiffness: number;
+    /** 감쇠 */
+    damping: number;
+    /** 정지 임계값 */
+    restDelta: number;
+    /** 정지 속도 */
+    restSpeed: number;
+}
+/** reduced motion 전략 */
+type ReducedMotionStrategy = 'skip' | 'fade-only' | 'minimal';
+/** 전체 Motion Profile */
+interface MotionProfile {
+    /** 프로필 이름 */
+    name: string;
+    /** 공통 디폴트 */
+    base: MotionProfileBase;
+    /** 입장 애니메이션 */
+    entrance: MotionProfileEntrance;
+    /** 스태거 */
+    stagger: MotionProfileStagger;
+    /** 인터랙션 */
+    interaction: MotionProfileInteraction;
+    /** 스프링 물리 */
+    spring: MotionProfileSpring;
+    /** reduced motion 전략 */
+    reducedMotion: ReducedMotionStrategy;
+}
+/** 내장 프로필 이름 */
+type BuiltInProfileName = 'neutral' | 'hua';
+/** DeepPartial 유틸리티 */
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+/**
+ * neutral 프로필 — 기존 하드코딩 디폴트와 동일.
+ * Provider 없을 때 fallback으로 사용되므로 하위 호환 100% 보장.
+ */
+declare const neutral: MotionProfile;
+
+/**
+ * HUA 프로필 — 스르륵 쫀뜩한 브랜드 시그니처.
+ *
+ * 특징:
+ * - CSS ease-out 기반이되 끝에 미세한 오버슈트 (1.04~1.06)
+ * - 도착점을 살짝 지나쳤다가 돌아오는 탄성
+ * - 바운스 없이 쫀뜩 (높은 감쇠 + 높은 강성)
+ * - neutral보다 짧은 duration, 좁은 distance → 더 정교한 느낌
+ */
+declare const hua: MotionProfile;
+
+interface MotionProfileProviderProps {
+    /** 내장 프로필 이름 또는 커스텀 프로필 객체 */
+    profile?: BuiltInProfileName | MotionProfile;
+    /** 선택한 프로필 위에 부분 오버라이드 */
+    overrides?: DeepPartial<MotionProfile>;
+    children: React.ReactNode;
+}
+declare function MotionProfileProvider({ profile, overrides, children, }: MotionProfileProviderProps): react.FunctionComponentElement<react.ProviderProps<MotionProfile>>;
+/**
+ * 현재 프로필을 가져옴.
+ * Provider 밖에서 호출 시 neutral 프로필 반환 (하위 호환).
+ */
+declare function useMotionProfile(): MotionProfile;
+
+/** 이름 또는 객체에서 프로필 resolve */
+declare function resolveProfile(profile: BuiltInProfileName | MotionProfile): MotionProfile;
+/** 프로필에 오버라이드를 깊은 병합 */
+declare function mergeProfileOverrides(base: MotionProfile, overrides: DeepPartial<MotionProfile>): MotionProfile;
+
+type EasingFunction = (t: number) => number;
+declare const linear: EasingFunction;
+declare const easeIn: EasingFunction;
+declare const easeOut: EasingFunction;
+declare const easeInOut: EasingFunction;
+declare const easeInQuad: EasingFunction;
+declare const easeOutQuad: EasingFunction;
+declare const easeInOutQuad: EasingFunction;
+type EasingType = 'linear' | 'easeIn' | 'easeOut' | 'easeInOut' | 'easeInQuad' | 'easeOutQuad' | 'easeInOutQuad' | 'easeInCubic' | 'easeOutCubic' | 'easeInOutCubic' | 'easeInQuart' | 'easeOutQuart' | 'easeInOutQuart' | 'easeInQuint' | 'easeOutQuint' | 'easeInOutQuint' | 'easeInSine' | 'easeOutSine' | 'easeInOutSine' | 'easeInExpo' | 'easeOutExpo' | 'easeInOutExpo' | 'easeInCirc' | 'easeOutCirc' | 'easeInOutCirc' | 'easeInBounce' | 'easeOutBounce' | 'easeInOutBounce' | 'easeInBack' | 'easeOutBack' | 'easeInOutBack' | 'easeInElastic' | 'easeOutElastic' | 'easeInOutElastic' | 'pulse' | 'pulseSmooth' | 'skeletonWave' | 'blink';
+declare function isValidEasing(easingName: string): boolean;
+declare function getEasing(easingName: unknown): EasingFunction;
+declare function applyEasing(t: number, easingName: string | EasingFunction): number;
+declare function safeApplyEasing(t: number, easingName: unknown): number;
+declare function getAvailableEasings(): string[];
+declare function isEasingFunction(value: any): value is EasingFunction;
+declare const easingPresets: {
+    readonly default: "easeOut";
+    readonly smooth: "easeInOutCubic";
+    readonly fast: "easeOutQuad";
+    readonly slow: "easeInOutSine";
+    readonly bouncy: "easeOutBounce";
+    readonly elastic: "easeOutElastic";
+    readonly fade: "easeInOut";
+    readonly scale: "easeOutBack";
+};
+declare function getPresetEasing(preset: keyof typeof easingPresets): EasingFunction;
+
+/**
+ * Spring physics calculation (Hooke's Law + damping)
+ *
+ * Pure function — no side effects, fully testable.
+ */
+interface SpringConfig {
+    stiffness: number;
+    damping: number;
+    mass: number;
+}
+interface SpringResult {
+    value: number;
+    velocity: number;
+}
+/**
+ * Calculate one step of a damped spring simulation.
+ *
+ * @param currentValue   Current position
+ * @param currentVelocity Current velocity
+ * @param targetValue    Equilibrium (target) position
+ * @param deltaTime      Time step in seconds
+ * @param config         Spring parameters (stiffness, damping, mass)
+ */
+declare function calculateSpring(currentValue: number, currentVelocity: number, targetValue: number, deltaTime: number, config: SpringConfig): SpringResult;
+
+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 };