Library·운영 중·2025-09: 진행중
scrollbar-toc
스크롤바 sticky 목차 NPM 라이브러리
페이지의 모든 h1~h6를 자동 추출해 스크롤바 옆에 비례 sticky 버튼을 렌더링하는 라이브러리입니다.
기술 스택
만든 이유
나무위키처럼 스크롤바에 목차가 뜨는 것이 센세이셔널하였습니다. 기존 ToC 라이브러리는 사이드바에 텍스트를 그리지만, 이 라이브러리는 빈 공간(스크롤바 옆)을 활용합니다.
코멘트
의존성 0으로 React / Vue / Svelte / Vanilla 어느 환경에서도 가볍게 import할 수 있습니다. 하루 만에 v1을 publish했고, 누적 459 다운로드를 기록하고 있습니다.
주요 특징
- 01의존성을 없앴습니다
- 02tsdown (Rolldown 기반) 빌더로 ESM + CJS + .d.ts 듀얼 출력
- 03IntersectionObserver 대신 rAF 폴링 + Map 추적: Next.js 16 cacheComponents 환경 대응
- 04WeakMap → Map 전환: 참조 끊김 케이스에서 명시적 cleanup 보장
- 05History API monkey-patch + popstate로 SPA 네비게이션 시점 일괄 정리
- 06GitHub Actions + NPM SLSA Provenance: 검증된 빌드만 publish
비고
- ·BBlog에서 dogfooding: 발견된 이슈를 즉시 라이브러리에 반영
- ·MIT 라이선스