useGenerator 의 상태는 useReducer 하나다. idle 에서 start 로 running 이 되고(에러도 함께 비운다), yield 는 status 를 두고 value 만 바꾸며, generator 가 끝나면 done, 본문 어디서든 throw 하면 catch 에서 error 로 errored 다. cancel 은 abort 하고 idle 로 되돌린다 — 안 하면 running 에 멈춘다. unmount 되면 cleanup 이 abort 하고, 기다리던 await wait 가 reject 돼 throw 가 나지만 aborted 라 에러로 치지 않는다. 같은 훅을 쓰는 쪽이 재진입 정책을 고른다: LoadingButton 은 running 동안 disabled 로 다시 못 누르게 하고 JSX 를 yield 하면 그대로 라벨이 된다. 검색은 run(q) 마다 직전 실행을 abort 하고 다시 시작해, a 다음 ab 를 치면 a 의 remote 결과가 끼어들지 않는다.

-- isLoading 없이 onClick 에서 yield 만 한다 — 시간이 코드의 한 방향(↓)으로만 흐를 때
--   멀티 단계 loading · progressive search · optimistic mutation(optimistic | reconciled | rolledBack)
data Status  = Idle | Running | Errored | Done
data Event a = Start | Yield a | Finish | Throw Error | Cancel

step :: State a -> Event a -> State a
step s Start     = s { status = Running, error = Nothing }   -- 상태와 에러 초기화가 한 번에 — 따로 set 하다 어긋날 일이 없다
step s (Yield v) = s { value = v }                           -- status 는 두고 값만
step s Finish    = s { status = Done }
step s (Throw e) = s { status = Errored, error = Just e }
step s Cancel    = s { status = Idle }                       -- 없으면 Running 에 멈춘다

-- 핸들러는 값의 흐름(async generator), 훅은 그걸 접는다
state = foldl step initial (run fn args)

run :: (Signal -> args -> Stream a) -> args -> [Event a]
run fn args = Start : map Yield (untilAborted (fn signal args)) ++ end
  where end | aborted   = []          -- abort 로 생긴 throw 는 에러가 아니다
            | otherwise = [Finish]    -- 본문 어디서 throw 하든 Throw e
-- run 은 직전 실행을 abort 하고 다시 시작한다 · unmount 도 abort

-- 재진입 정책은 쓰는 쪽이 고른다
--   버튼: Running 동안 disabled, yield 한 JSX 가 곧 라벨
--   검색: run 마다 재시작 — tier 경계(await wait)가 곧 취소 지점이라 debounce 가 필요 없다
searchTiers q = do wait 100; yield [q ++ ":local"]
                   wait 300; yield [q ++ ":local", q ++ ":remote"]

-- 확인: a 를 치고 150ms 에 ab
shown == [["a:local"], ["ab:local"], ["ab:local", "ab:remote"]]   -- a:remote 는 끼어들지 않는다
#540

모달을 열기 → 닫기 → 열기 → 닫기 → 열기 한 뒤 바깥을 클릭한다. React 19: 열 때 ref(node) 가 mousedown 리스너를 추가하고, 닫을 때 반환한 cleanup 이 제거해 남는 리스너가 1 → 0 → 1 → 0 → 1 이다. 바깥 클릭에 handler 가 한 번만 불린다. React 18 이하: 반환한 cleanup 은 무시되고, 닫을 때 같은 콜백이 ref(null) 로 다시 불려 본문이 또 돈다 — node 가 null 인 리스너가 하나 더 붙는다. 남는 리스너가 1 → 2 → 3 → 4 → 5 로 쌓이고, 바깥 클릭에 handler 가 세 번 불리고 null.contains 에서 TypeError 가 두 번 난다. 18 이하는 리스너를 별도 ref 에 저장하거나 useEffect 를 쓴다.

-- 바깥 클릭 감지를 useEffect 없이 ref callback 하나로 — React 19 부터
type RefCallback = Maybe Node -> IO Cleanup

attach :: RefCallback -> Node -> IO Cleanup
attach cb node = cb (Just node)

detach :: React -> RefCallback -> Cleanup -> IO ()
detach React19 _  cleanup = cleanup          -- 돌려준 cleanup 을 부른다
detach React18 cb _       = void (cb Nothing) -- cleanup 은 버리고 본문을 null 로 또 돈다

useClickOutside :: IO () -> RefCallback
useClickOutside handler (Just node) = do
  let onDown e = unless (node `contains` target e) handler   -- handler 는 ref 로 최신을 읽는다 (stale closure)
  addEventListener document "mousedown" onDown
  pure (removeEventListener document "mousedown" onDown)

-- 열기·닫기를 다섯 번: 남는 리스너
listeners React19 == [1, 0, 1, 0, 1]
listeners React18 == [1, 2, 3, 4, 5]   -- null.contains → TypeError
-- 18 이하는 리스너를 별도 ref 에 두거나 useEffect 로