Summary

• typeset.rs::place_table_with_text (1400-1495) 의 Square wrap (어울림) 표 누적 정책을 pre_height + table_total → max(pre_height, v_off + table_total) 로 변경
• exam_kor.hwp 22→20 페이지 단축 (페이지 14 + 15 통합)
• 페이지 14 col 0 over-fill (1225.8 > 1211.3, +14.5px) 해소
• 페이지 14 col 1 items 2개 → 18개 정상 채워짐
• closes Square wrap 표 직후 col 0 over-fill (exam_kor 페이지 14 단 0 1225>1211) #439

변경 내용

버그

samples/exam_kor.hwp 페이지 14 col 0 의 4 개 Square wrap 표 (pi=33, 37, 40, 47, 모두 wrap=어울림 vert=문단 1.4mm) 처리 시:

호스트 문단 텍스트가 PartialParagraph 로 push 되며 그 높이가 current_height 에 누적되고, 이어서 표가 push 되며 table_total_height 도 추가 누적된다. 두 누적이 합산 되지만 HWP layout 에서 어울림 표는 호스트 텍스트와 같은 수직 영역 을 공유한다 (어울림 = 본문이 표 옆을 흐름).

페이지 14 col 0 의 4 표 누적 측정 (place_table_with_text 임시 디버그, 사후 revert):

페이지 14 col 0 used = 1225.8 px = 정상 누적 + 244.88 px 과다 누적 = 1211.3 본문 한계 +14.5px 초과 → pi=48 fit 실패 → col 1 advance → col 1 64.3 px (pi=48,49 만) → pi=50+ 페이지 15 로 강제 이동.

수정

+        // [Task #439] Square wrap (어울림) 표 식별.
+        let is_wrap_around_table = !table.common.treat_as_char
+            && matches!(table.common.text_wrap, crate::model::shape::TextWrap::Square);
+
         let is_first_table = !para.controls.iter().take(ctrl_idx)
             .any(|c| matches!(c, Control::Table(_)));
-        if pre_table_end_line > 0 && is_first_table {
-            let pre_height: f64 = fmt.line_advances_sum(0..pre_table_end_line);
+        let pre_height: f64 = if pre_table_end_line > 0 && is_first_table {
+            let h = fmt.line_advances_sum(0..pre_table_end_line);
             st.current_items.push(PageItem::PartialParagraph { ... });
-            st.current_height += pre_height;
-        }
+            h
+        } else { 0.0 };

         st.current_items.push(PageItem::Table { ... });
-        st.current_height += table_total_height;
+
+        // [Task #439] 누적 정책:
+        // - Square wrap (어울림): max(pre_height, v_off + table_total)
+        // - 그 외 (TopAndBottom 등): pre_height + table_total 합산 (기존 동작)
+        if is_wrap_around_table && pre_height > 0.0 {
+            let v_off_px = crate::renderer::hwpunit_to_px(vertical_offset as i32, self.dpi);
+            let table_bottom = v_off_px + table_total_height;
+            st.current_height += pre_height.max(table_bottom);
+        } else {
+            st.current_height += pre_height + table_total_height;
+        }

PageItem 자체는 PartialParagraph + Table 모두 push 유지 (layout 렌더링 보존).

결과 메트릭

회귀 검증

149 개 sample HWP 전수 페이지 수 비교 (local/devel ↔ fix 후):

$ diff baseline.txt after.txt
133a134
>   20  samples/exam_kor.hwp
136d136
<   22  samples/exam_kor.hwp

149 개 중 exam_kor.hwp 만 22→20 변경, 나머지 148 개 페이지 수 동일 ✓

특별 확인 (Square wrap 표 보유 문서):

cargo test --release --lib: 1066 passed, 0 failed

부수 발견 — 활성 페이지네이션 엔진

이슈 본문은 src/renderer/pagination/engine.rs:702-711 의 prev_is_table 분기 (trailing line_spacing 제외 로직) 를 원인으로 추정했으나, engine.rs::Paginator 는 활성 엔진이 아니다.

src/document_core/queries/rendering.rs:882-908:

let use_paginator = std::env::var("RHWP_USE_PAGINATOR").map(|v| v == "1").unwrap_or(false);
let mut result = if use_paginator {
    paginator.paginate_with_measured_opts(...)        // engine.rs (fallback)
} else {
    typesetter.typeset_section(...)                    // typeset.rs (default)
};

기본 활성 엔진은 typeset.rs::TypesetEngine. engine.rs 는 환경변수로만 활성화되는 legacy 경로. Stage 1 진단으로 발견 (engine.rs::place_table_fits 에 임시 eprintln! 삽입 → stderr 0 줄 = 호출되지 않음 확인).

흥미로운 점: engine.rs::place_table_fits (라인 1349, 1422) 에는 !is_wrap_around_table 가드가 있어 Square wrap 시 PartialParagraph 자체를 push 하지 않는다. 반면 typeset.rs::place_table_with_text 에는 그 가드가 없었다 — 두 엔진 사이의 시멘틱 누락이 본 버그의 근본 원인.

잔여 작업 (별도 이슈 권장)

• engine.rs (legacy fallback) 의 Square wrap 처리 정합성: 본 fix 와 동일한 max() 정책 적용 (현재 RHWP_USE_PAGINATOR=1 시 25 페이지 출력 = 별개 회귀). 우선순위 낮음.
• HWP 21 vs rhwp 20 페이지 차이 시각 검증 (작업지시자 PDF 비교 후 추가 task 분리 여부 결정).

Test plan

• cargo build --release --bin rhwp 성공
• cargo test --release --lib 1066 passed, 0 failed
• rhwp dump-pages samples/exam_kor.hwp -p 13 → 단 0 used 1225.8 → 1036.1 px (over-fill 해소)
• rhwp dump-pages samples/exam_kor.hwp → 22 → 20 페이지
• rhwp export-svg samples/exam_kor.hwp -p 13 → SVG 정상 (56 rect, 2205 text 요소)
• 회귀 검증: 149 개 sample HWP 페이지 수 비교 (148개 동일)
• place_table_with_text 디버그 로그로 4 표 누적 정량 확인 (538.96 → 294.08, -244.88 px)

단계별 커밋

• 3884305 Stage 1: 베이스라인 측정 + 진단 (활성 엔진 확인)
• 4ea2746 Stage 2: 원인 확정 + 구현 계획서
• 99f1596 Stage 3: Square wrap 표 누적 정책 max 적용
• df2aff3 Stage 4: 최종 결과보고서 + 오늘할일 갱신
• 50b5cab Merge local/task439

관련

• 수행계획서: mydocs/plans/task_m100_439.md
• 구현 계획서: mydocs/plans/task_m100_439_impl.md
• 단계별 보고서: mydocs/working/task_m100_439_stage{1,3}.md
• 최종 보고서: mydocs/report/task_m100_439_report.md