-- Suspense: 렌더가 promise 를 "던지면" 잡아서 기다린다 — 예외와 같은 메커니즘render :: Component -> Either (Promise a) Htmlrender c = case cached c of Nothing -> Left (fetchData c) -- throw promise Just d -> Right (view d)suspense :: Html -> Component -> IO Htmlsuspense fallback c = case render c of Left p -> show fallback >> await p >> suspense fallback c -- resolve 되면 다시 렌더 Right h -> pure h-- throw fetch() 는 렌더마다 새 promise — 공식 경로: 캐시된 같은 promise 를 use 로
-- 비동기 데이터를 그리는데 로딩·에러가 늘면서 화면이 튈 때-- 각각 들고 있으면 2 × 2 = 4 칸: 넷째(로딩이면서 에러)는 있을 수 없는데 적을 수 있다data Flags a = Flags { loading :: Bool, failed :: Maybe Error, result :: Maybe a }-- 트리로 옮기면 셋 중 하나: 넷째 칸을 적을 수가 없다data View a = Loading | Failed Error | Done a-- Suspense 는 비동기를 동기처럼 보이게 한다: 없으면 promise 를 던지고, 오면 다시 그린다read :: Resource a -> arender :: a -> Html -- 결과 하나만 받는다. loading·error 를 넘기지 않는다view :: Resource a -> Htmlview r = errorBoundary onError -- reject → 가장 가까운 ErrorBoundary $ suspense spinner -- pending → 가장 가까운 Suspense $ render (read r)-- 확인: 있을 수 없는 조합을 적을 수 있는가. 적을 수 없으면 된 것이다-- 함정: 스피너가 너무 빨리 떴다 사라지는 건 이 축이 아니다 → 573. stale-while-revalidate → 570-- 모양은 algebraic effect 의 handler 에서 따왔다 — 다만 되돌아가 이어 실행하지 않고 다시 그린다
-- 닫기와 내용 변경(안내 문구, 고른 항목 맨 위로)이 한 배치로 커밋되면 사라지는 중에 내용이 바뀐다-- → 퇴장 중엔 커밋을 멈춘다. Suspense 를 빌리고, 딸려 오는 숨김만 걷어낸다freeze :: Bool -> Tree -> Dom -> Domfreeze False t _ = commit t -- 평소: 렌더한 대로 커밋freeze True _ old = unhide (suspend old) -- 얼림: 렌더는 계속, 커밋은 안 함 → 닫기 직전 모습-- Suspense 가 중단되면 하는 일 셋 — 앞의 둘은 그대로 쓰고, 셋째만 되돌린다suspend :: Dom -> Domsuspend = keepState . skipCommit . hide -- {frozen && <Suspend />}: 모듈에 하나 둔 끝나지 않는 promise 를 use → 계속 중단 -- hide: 바로 아래 요소에 display: none !important, 텍스트는 nodeValue = '', layout effect 정리·ref 떼기unhide :: Dom -> Domunhide = mapElems (\el -> el { display = "" }) -- 언제: useInsertionEffect. 커밋은 자식 먼저라 Suspense 가 숨긴 직후 같은 커밋 안에서 돈다 → 숨긴 모습이 안 그려진다 -- 누구를: <Fragment ref> 의 observeUsing 에 가짜 관찰자를 넣어 바로 아래 요소를 Set 으로 모은다 -- (붙으면 observe · 빠지면 unobserve 가 다시 불린다) -- deps 는 [frozen]: React 가 다시 숨기는 건 보임↔숨김이 바뀔 때뿐이다-- 풀릴 때: 쌓인 최신 렌더가 한 번에 커밋되고, display 는 style prop 의 값(없으면 '')으로 돌아온다-- 쓰는 쪽: <Popover>{({ isExiting }) => <Freeze frozen={isExiting}>…</Freeze>}</Popover> (React Aria)-- React 상태로 그리는 hover·press·focus 도 같이 언다. CSS :hover 는 안 언다-- 버린 길: 닫기 전 상태를 저장 → 다시 그리게 하는 상태를 전부 챙겨야 한다-- onOpenChangeComplete 로 업데이트를 미룸 → 퇴장이 중간에 끊기면 복잡하다-- 다만: observeUsing 은 react-dom 19.3 부터다(19.2.0 엔 없다). ref cleanup·use 도 19-- 텍스트 자식은 되돌리지 않아 얼어 있는 동안 비어 보인다-- 퇴장 중엔 ref 가 떨어져 있어 ref 로 재거나 포커스를 다루는 코드는 못 돈다-- 원래 인라인 display 를 지운다 · React 내부 동작에 기댄 트릭이다
-- 응답 하나 = 셸 하나 + 기다리던 경계마다 조각 하나. 마지막 경계까지 응답은 열려 있다stream :: Tree -> [Chunk]stream t = shell t : [ segment b <> swap b | b <- readyOrder (pending t) ] -- 준비된 순서, 문서 순서가 아니다 -- 마지막 조각 뒤에야 응답이 닫히고 브라우저 파싱이 끝난다 → defer 스크립트는 가장 느린 경계를 기다린다-- 셸에서 경계 자리boundary :: Boundary -> Chunkboundary b | ready b = "<!--$-->" <> html b <> "<!--/$-->" | failed b = "<!--$!-->" <> fallback b <> "<!--/$-->" -- 클라이언트가 다시 그린다 | otherwise = "<!--$?--><template id=\"B:" <> n b <> "\"></template>" <> fallback b <> "<!--/$-->" -- ready 라도 뒤로 뺀다(셸엔 $? 자리, 내용은 segment+swap): 500B 넘는 경계가 이미 쓴 것과 합쳐 12,800B(progressiveChunkSize) 를 넘을 때 -- · 스타일시트를 기다려야 할 때 · defer 일 때. 셸이 너무 커져 첫 화면이 늦어지지 않게segment b = "<div hidden id=\"S:" <> n b <> "\">" <> html b <> "</div>" -- 화면 밖에 먼저 붙는다swap b = "<script>$RC(\"B:" <> n b <> "\",\"S:" <> n b <> "\")</script>" -- $RC 정의는 첫 swap 앞에 한 번 인라인으로-- $RC: 바로 바꾸지 않는다. 표시를 $~ 로 바꿔 대기열에 넣고 한꺼번에 바꾼다($RV)reveal :: Ms -> Maybe Ms -> Delayreveal _ Nothing = nextFrame -- 아직 한 번도 안 바꿨다reveal now (Just _) | 2000 < now && now < 2300 = 2300 - now -- 이 구간이면 2.3초에 맞춘다reveal now (Just last) = last + 300 - now -- 지난 바꾸기 300ms 뒤 -- $RV: 표시 사이 fallback 노드를 지우고 S:n 의 자식을 옮겨 넣고 표시를 "$" 로. _reactRetry 가 있으면 다음 프레임에 그 경계를 하이드레이트 -- B:n 이 없으면(그 사이 지워졌다) S:n 도 지운다-- 언제 흘려보내나 (renderToPipeableStream)send :: Reader -> Hooksend Person = onShellReady -- 셸이 되면 pipe. 경계는 오는 대로send Crawler = onAllReady -- 다 풀린 뒤 pipe. 작은 경계는 셸 안에 "<!--$-->" 로, 큰 경계는 여전히 뒤로 빠져 $RC 로 끼운다 -- 셸조차 실패하면 onShellError -- pipe: 버퍼가 차면 멈췄다 'drain' 에 이어 쓴다. 'close'·'error' 면 렌더를 취소. pipe 는 한 번만