Web IDE 환경의 Sandbox 제약을 극복한 Client-side Spell Checker 설계 전략

Context

Browser-based IDE는 Sandbox 구조로 인해 Local File System 접근 및 Background Process 실행이 제한됨. 기존 Desktop 기반 Extension의 의존성 문제와 외부 API 전송으로 인한 소스코드 유출 및 Privacy 침해 위험이 존재함.

Technical Solution

• Local-first 아키텍처 채택을 통한 Client-side Dictionary 처리로 외부 데이터 전송 차단
• .cspell.json 파일을 통한 프로젝트 단위 Custom Dictionary 공유로 팀 내 일관된 용어 검증 체계 구축
• Code-aware 필터링 로직 적용을 통해 'const', 'typeof' 등 예약어를 오탐지(False Positive)에서 제외
• LanguageTool 기반의 Local Server 구동 방식으로 문법 검사 기능을 브라우저 내부에 격리하여 구현
• Glob Pattern 기반의 File Exclusion 설정을 통해 node_modules 등 불필요한 스캔 범위를 제한하여 리소스 낭비 방지

Key Takeaway

제한된 실행 환경(Sandbox) 내의 도구 설계 시, 외부 의존성을 제거한 Local-first 접근 방식이 보안성과 성능 최적화의 핵심임.