Suspensive

Suspensive는 "React Suspense를 위한 모든 것"을 표방하는 라이브러리다. 로딩·에러·복구 상태를 컴포넌트마다 isLoading, isError로 분기하는 대신, 선언적인 컴포넌트 경계로 밀어내 관심사를 분리한다.

이 책은 공식 문서(https://suspensive.org/ko)의 개념을 필자의 관점으로 요약한 탐구 노트다. 정확한 API 시그니처와 최신 정보는 항상 공식 문서를 확인하자.

패키지는 크게 넷으로 나뉜다.

• @suspensive/react — Suspense, ErrorBoundary, Delay, ClientOnly 등 코어 프리미티브
• @suspensive/react-query — TanStack Query를 선언적으로 감싸는 SuspenseQuery 계열
• @suspensive/jotai — Jotai atom을 컴포넌트로 다루는 Atom, AtomValue, SetAtom
• @suspensive/codemods — 메이저 버전 마이그레이션 자동화

앞부분(1~4장)은 "왜 쓰고 어떻게 쓰는가"를 개념·사용법 위주로 다룬다. 뒷부분(5장부터)은 @suspensive/react의 소스를 한 컴포넌트씩 뜯어보며 내부 구현과 설계 의도를 정리한 분석 노트다. Object.assign 공통 패턴에서 시작해 useIsClient·ClientOnly·DefaultProps·Suspense·Delay·ErrorBoundary· ErrorBoundaryGroup·lazy 순으로, 코드가 왜 그렇게 생겼는지를 한 줄씩 읽는다.