상위 Epic: #309
선행: #310 (분석 도구), #311 (vpos-reset 가설 부정), #312 (TypesetEngine 발견)

배경

#312 조사 도중 코드베이스에 이미 존재하는 `TypesetEngine` 이 검증 모드로 동작 중이며, 4샘플 모두에서 Paginator 보다 정확한 페이지 수를 산출함을 발견.

검증 출처: `dump-pages` stderr `TYPESET_VERIFY` 메시지 (debug 빌드 한정)

코드 현황

• `src/renderer/typeset.rs` — 단일 패스 조판 엔진. format() → fits() → place/split 흐름
• `src/document_core/queries/rendering.rs:837~` — Paginator 결과와 병렬 검증 (페이지 수 차이 시 stderr 경고)
• 실제 렌더링은 Paginator 결과 사용. TypesetEngine 결과는 검증용으로만 폐기

작업 범위

1. 호환성 검토: TypesetEngine 의 `PaginationResult` 출력이 Paginator API 와 동일 형식인지 확인
2. 진입점 전환: `DocumentCore::paginate`에서 Paginator → TypesetEngine 으로 변경
3. 회귀 검증:
   • `cargo test` 992 passed 유지
   • 4샘플 페이지 수: 21_언어=15, exam_math=20, exam_kor=24, exam_eng=9
   • SVG 시각 회귀 (rhwp-studio E2E 또는 export-svg 비교)
4. 부속물 정리:
   • vpos-reset 실험 플래그 (`--respect-vpos-reset` from 페이지네이션에서 LINE_SEG vpos-reset을 단/페이지 경계로 강제 #311) 보존/제거 결정
   • PaginationOpts.respect_vpos_reset 필드 처리
   • Paginator 코드 정리/제거 (또는 fallback으로 보존)
5. 검증 코드 제거: TYPESET_VERIFY 분기 정리

검증 매트릭스 (목표)

비범위

• TypesetEngine 자체 알고리즘 변경
• 새 페이지네이션 엔진 작성

위험 / 대응

완료 조건

• 4샘플 모두 TypesetEngine 결과로 렌더링 + 페이지 수 일치 (21_언어 15쪽)
• `cargo test` 회귀 0
• Epic 페이지네이션 엔진 LINE_SEG vpos 우선 모드 전환 (Epic) #309 핵심 목표 달성 → Epic 클로즈 평가

참고

• `mydocs/report/task_m100_312_report.md`
• `mydocs/tech/line_seg_vpos_analysis.md`
• `src/renderer/typeset.rs` (전체)