Zero-dependency, 1KB 미만으로 구현한 고효율 React 단축키 훅 설계

Context

반복되는 keydown 이벤트 보일러플레이트 제거와 다양한 OS 환경의 키 조합 대응 필요성 증대. 기존 방식의 stale closure 문제로 인한 useCallback 의존성 및 입력 필드 내 이벤트 간섭 해결이 핵심 과제.

Technical Solution

• Ref 기반의 최신 콜백 참조 구조를 통한 useCallback 없이 최신 상태를 보장하는 stale closure 해결 설계
• OS별 차이(Cmd/Ctrl)를 'mod'라는 추상화 키워드로 통합하여 크로스 플랫폼 호환성 확보
• Input, Textarea 등 입력 요소에서 이벤트 실행을 기본 차단하되 Escape 키만 예외 허용하는 스마트 필터링 로직 구현
• ShortcutProvider를 통한 Scope 기반 계층적 이벤트 관리 체계 도입으로 UI 영역별 단축키 충돌 방지
• Case-insensitive 및 Whitespace-tolerant 파싱 로직을 통한 유연한 키 조합 정의 방식 채택
• Zero-dependency 설계를 통한 런타임 오버헤드 최소화 및 번들 사이즈 최적화