Summary

• compute_body_wide_top_reserve_for_para (typeset.rs:2127-2174) 의 VertRelTo::Paper 분기에서 paper-rel vertical_offset 을 body-rel 변환 없이 reserve 에 누적하던 버그 정정
• exam_kor.hwp 24→22 페이지 단축 (page 2, 15 orphan 페이지 사라짐)
• pi=0.30 (page 1 단 1), pi=1.25 (page 14 단 1) split → FullParagraph 로 해소
• closes exam_kor.hwp 24페이지 → 20페이지 정합 (한컴 PDF 호환) #435, closes 다단 col 1 시작 reserve 과대 산정 (exam_kor 페이지 1 pi=30 split) #393 (옵션 A 적용 완료)

변경 내용

버그

samples/exam_kor.hwp 의 body-wide TopAndBottom 표 (pi=0 wrap=TopAndBottom vert=Paper(38mm)) 처리 시:

• 표가 paper 38mm (= 143.6 px) 부터 시작 (헤더 영역)
• 본문 영역 (margin_top 56mm = 211.7 px) 안으로 79.2 px 침범
• HWP 실제 col 1 시작점: vpos=7085 HU = 94.5 px (body-rel)
• rhwp 산정 reserve: 306.1 px (= shape_y_offset + h + outer_bottom, paper-rel 좌표를 body-rel 처럼 누적)
• 차이: +211.6 px 과대

이로 인해 col 1 의 가용 공간이 부족해져 paragraph split 발생, page 2 (49px) / page 15 (104px) orphan 페이지 생성.

수정

-if matches!(common.vert_rel_to, VertRelTo::Paper) {
-    let shape_top_abs = ...vertical_offset...;
-    let shape_bottom_abs = shape_top_abs + ...height...;
-    if shape_bottom_abs <= body_top { continue; }
-}
-let shape_y_offset = ...vertical_offset...;
-if shape_y_offset > body_h / 3.0 { continue; }
-let bottom = shape_y_offset + shape_h + outer_bottom;
+let raw_v_offset = ...vertical_offset...;
+
+// body-rel 기준 시작/끝 y 계산.
+// - VertRelTo::Paper: body_top 차감. 본문과 안 겹치면 skip, 일부만 겹치면 침범 영역만 reserve.
+// - VertRelTo::Page / Para: vertical_offset 이 이미 body-rel.
+let (body_y, body_bottom) = if matches!(common.vert_rel_to, VertRelTo::Paper) {
+    let shape_top_abs = raw_v_offset;
+    let shape_bottom_abs = shape_top_abs + shape_h;
+    if shape_bottom_abs <= body_top { continue; }
+    ((shape_top_abs - body_top).max(0.0), shape_bottom_abs - body_top)
+} else {
+    (raw_v_offset, raw_v_offset + shape_h)
+};
+
+if body_y > body_h / 3.0 { continue; }
+let bottom = body_bottom + outer_bottom;

결과 메트릭

회귀 검증

cargo test --release: 1062 passed, 0 failed

잔여 작업 (별도 이슈로 분리)

22→20 페이지 정합 미달성 — 다음 3 가지 별도 메커니즘:

• Square wrap 표 직후 col 0 over-fill (exam_kor 페이지 14 단 0 1225>1211) #439 — Square wrap 표 직후 col 0 over-fill (페이지 14 단 0 1225>1211)
• 다단 섹션에서 [단나누기] 후 새 페이지가 단일 컬럼으로 출력 (exam_kor 페이지 15) #440 — 다단 섹션에서 [단나누기] 후 새 페이지가 단일 컬럼으로 출력 (페이지 15)
• 다단 col 0 cur_h 가 HWP vpos 대비 ~100px over-advance (exam_kor 섹션 2 페이지 18) #441 — 다단 col 0 cur_h 가 HWP vpos 대비 ~100px over-advance (섹션 2 페이지 18)

Test plan

• cargo build --release --bin rhwp 성공
• cargo test --release 1062 passed, 0 failed
• rhwp dump-pages samples/exam_kor.hwp -p 0 → 단 1 used 1207.6 → 1035.8 px
• rhwp dump-pages samples/exam_kor.hwp -p 13 → 단 1 used 1193.5 → 1076.9 px
• rhwp export-svg samples/exam_kor.hwp → 22 SVG (was 24)
• 회귀 검증: exam_eng 8 / k-water-rfp 28 / hwpspec 177 / synam-001 35 페이지 유지
• RHWP_TYPESET_DRIFT=1 로 col 1 reserve 변화 (306.1 → 94.5) 정량 확인

단계별 커밋

• e0cdc2e Stage 1: 베이스라인 측정 + 진단 데이터 수집
• 0879f11 Stage 2: col 1 reserve 정정 (typeset.rs 32 lines)
• bd08d6b Stage 3: 일반 페이지 누적 부족 조사 (코드 변경 없음)
• 0a096fc Stage 5: 최종 결과보고서 + 오늘할일 갱신

관련

• 수행계획서: mydocs/plans/task_m100_435.md
• 구현 계획서: mydocs/plans/task_m100_435_impl.md
• 단계별 보고서: mydocs/working/task_m100_435_stage{1,2,3}.md
• 최종 보고서: mydocs/report/task_m100_435_report.md