## 배경

commit 8ee17fd (v1) 머지 후 rhwp-studio 검증에서 잔상이 남아 추가 조사.
edwardkim#1154 의 시각 증상은 세 가지 독립 원인이 동시 발생하고 있었음:

1. 동일 bin_id Pic 컨트롤 수직 인접 시 스케일 미스매치 (SVG/Canvas 공통)
2. rhwp-studio overlay `<img>` 가 crop 필드를 완전히 무시 (overlay only)
3. 큰 PNG/JPEG 의 비동기 디코드가 scheduleReRender(200/600ms) 를 초과 (flow only)

v1 commit 8ee17fd 은 원인 1 처리. v2 (본 commit) 가 원인 2 + 3 처리.

## Stage 1 — overlay path 가 crop 을 honor

- src/document_core/queries/rendering.rs : write_overlay_image 가
  image.crop 이 Some 일 때 JSON 에 crop 필드 출력.
- rhwp-studio/src/view/page-renderer.ts :
  - OverlayImageInfo.crop?: { left, top, right, bottom } 필드 추가.
  - toOverlayInfo (폴백 경로) 도 op.crop 전달.
  - createOverlayLayer 가 crop 있으면 wrapper div + overflow:hidden +
    scaled img 패턴으로 source rect → dest rect 매핑.
    (HU/px = 75, compute_image_crop_src 와 동일 환산)
  - filter / mixBlendMode / opacity 는 기존대로 `<img>` 자체에 적용.

→ 페이지 2 박스 18 윈도우 chrome frame 잔상 제거, 한컴 PDF 시각 일치.

## Stage 2 — 큰 이미지 비동기 디코드 안전망

- scheduleReRender delays [200, 600] → [200, 600, 1500] 확장.
- prefetchFlowImages 신규 메서드 :
  - wasm.getPageLayerTree(pageIdx) JSON 에서 flow image 의 mime/base64
    추출 (behindText/inFrontOfText 는 제외, overlay 별도 처리).
  - new Image() + image.decode() 으로 prefetch, 모든 디코드 완료 후
    한 번 더 renderPageToCanvasFiltered 호출.
- scheduleReRender 안에서 queueMicrotask 로 prefetch 실행 — setTimeout
  흐름과 독립 동작하는 안전망.

→ 페이지 4 박스 27 (Adenville City Pass Card 종이+핀 디자인, PNG ~130KB)
  외곽 그림 누락 해결, 한컴 PDF 시각 일치.

## 검증

- 페이지 2 박스 18 / 페이지 4 박스 27 / 페이지 4 박스 28 시각 한컴 PDF 일치
- cargo test --release --lib : 1432 passed / 0 failed / 6 ignored
- cargo clippy --release --lib -- -D warnings : clean
- npx tsc --noEmit (rhwp-studio) : clean
- Docker WASM 빌드 : 정상

## 회귀 보호

- Stage 1 변경은 BehindText/InFrontOfText overlay 경로에만 영향, flow layer
  변경 없음. crop 없는 overlay 는 기존 동작 유지.
- Stage 2 변경은 flow layer 추가 재렌더 + image prefetch 만 추가. 이미지가
  없는 페이지는 imageCount=0 으로 skip, 비용 없음.
- Rust 변경은 JSON 출력 1 줄 추가 — 기존 모든 cargo test / clippy 통과 유지.

## 변경 파일

- src/document_core/queries/rendering.rs (+7)
- rhwp-studio/src/view/page-renderer.ts (+120 / -13)
- mydocs/{plans,working,report}/task_m100_1154_v2*.md (수행/구현/단계별/최종)
- pkg/* WASM 재빌드 (gitignore)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>