
-- 브라우저 밖에서 PDF 텍스트·이미지를 꺼낼 때, pdfjs-dist 를 직접 쓰면 따라오는 배관 → unpdf 에선
chore :: Obstacle -> (PdfjsDist, Unpdf)
chore Worker = ("workerSrc 를 맞추거나 워커를 끈다", "워커를 번들에 넣어 같은 스레드에서 돌린다")
chore NodeBuild = ("\"legacy 빌드를 쓰라\" 경고", "경고를 지우고, 빠진 최신 API 는 폴리필")
chore WorkersEnv = ("FinalizationRegistry·navigator 가 없다", "PDF.js 보다 먼저 전역을 채운다")
chore WorkersWasm= ("실행 중 WASM 컴파일이 막혀 있다", "JBIG2·JPEG 2000 디코더를 JS 판으로")
chore Decoders = ("디코더 WASM 을 URL(wasmUrl)로 서빙한다", "번들 조각으로 넣어두고 필요할 때만 불러온다")
chore TextLoop = ("페이지를 돌며 텍스트 조각을 잇는다", "extractText pdf { mergePages = True }")
-- 나머지도 함수 하나씩: extractImages(PNG) · renderPageAsImage · inspectPages(스캔 페이지 → OCR 판단) · 링크 · 메타
-- getDocumentProxy 로 한 번 열어 여러 함수에 넘기면 다시 파싱하지 않는다
-- 그래서 고르는 법
pick :: Need -> Where -> Library
pick (Create _) _ = Other -- 꺼내기·그리기만 한다: 만들거나 고치는 함수가 없다
pick (Edit _) _ = Other
pick _ Browser = Either -- pdfjs-dist 는 워커로 따로 돌고, unpdf 번들은 내 스레드에서 돈다
pick _ _ = Unpdf -- Node 24+ · Bun · Cloudflare Workers. pdf-parse 의 대안 (README)
-- 대가: 워커가 없으니 파싱이 내 이벤트 루프에서 돈다 → 추출 호출을 타임아웃과 경주시킨다 (README)
-- 페이지를 이미지로 그리려면 @napi-rs/canvas 를 따로 설치한다 (선택적 peerDependency)
-- 다른 PDF.js(버전 고정 등)를 쓰려면: definePDFJSModule (\_ -> import "pdfjs-dist/legacy/build/pdf.mjs")