프로젝트 소개

이 라이브러리는 단일 튜닝 가능 API를 사용하여 웹 상호작용을 위한 촉각, 청각 및 시각적 피드백을 조율할 수 있게 합니다. navigator.vibrate를 통한 Android 진동과 입력 스위치 해킹을 통한 iOS Taptic Engine을 지원합니다. 햅틱, 사운드, 모션의 각 피드백 채널은 런타임에 독립적으로 활성화, 비활성화 또는 튜닝할 수 있습니다. 사운드는 20개의 내장 큐 또는 사용자 정의 샘플 팩을 통해 Web Audio로 합성됩니다. 모션은 이모지 파티클과 스프링 효과의 boops를 사용하며, prefers-reduced-motion 설정을 준수합니다. API는 iOS UIFeedbackGenerator 시맨틱(selection, impact, notification 등)을 모방하며 강도, 볼륨, 스케일 및 이벤트 매핑의 사용자 정의 튜닝을 허용합니다. 향후 네이티브 백엔드 교체(예: Capacitor)를 고려하여 설계되었으며, 프레임워크에 구애받지 않고 SSR에 안전하며 TypeScript 타입과 런타임 의존성 제로로 제공됩니다. 진단 도구는 진동 권한 누락과 같은 플랫폼별 문제 디버깅을 돕습니다. 플랫폼 전용 API에 직접 의존하지 않고 UI 피드백을 강화하는 데 이상적입니다.