Task #703: BehindText/InFrontOfText 표 본문 흐름 누락 정정 (closes #703)

[planet6897]

Summary

• typeset.rs 의 표 컨트롤 처리 분기에 BehindText/InFrontOfText (글뒤로/글앞으로) 가드 누락으로 데코레이션 표가 본문 cur_h 에 잘못 가산되어 trailing 항목이 다음 페이지로 밀리는 결함 정정 (+13 줄, pagination/engine.rs:976-981 와 동일 시멘틱).
• samples/basic/calendar_year.hwp: 한글2022 PDF 1 페이지 ↔ SVG 2 페이지 결함 해소.
• 의도하지 않은 추가 정합: samples/table-ipc.hwp 13 → 10 페이지 (11 개 InFrontOfText 표 자동 정합).

Root cause

• pagination/engine.rs:976-981 에는 BehindText/InFrontOfText 표를 Shape 처럼 push 후 continue 하는 가드가 있으나, 메인 pagination 인 typeset.rs 의 typeset_table_paragraph 분기에 미반영.
• place_table_with_text 가 cur_h += pre_height + table_total_height 를 BehindText/InFrontOfText 표에도 적용하여 본문 흐름 누적이 발생.
• calendar_year pi=1 (글뒤로 1×1 wrapper Table 캐리어 빈 paragraph) 단독으로 +23.77 px drift 발생, trailing PushButton (pi=12) 이 다음 페이지로 밀림.

정정

src/renderer/typeset.rs:1370 의 Control::Table 분기 진입 시점에 가드 추가:

if matches!(
    table.common.text_wrap,
    crate::model::shape::TextWrap::InFrontOfText
        | crate::model::shape::TextWrap::BehindText
) {
    st.current_items.push(PageItem::Shape {
        para_index: para_idx,
        control_index: ctrl_idx,
    });
    continue;
}

분리된 후속 이슈

본 task 분석 단계에서 함께 식별된 통합재정통계 (2010.11/2011.10) 페이지 분할 결함은 다른 본질로 확인 (TopAndBottom TAC 1×1 + 각주 환경 0.84 px borderline) — Issue #704 별도 분리. tests/issue_703.rs 의 해당 2 케이스는 #[ignore] 처리.

Test plan

• cargo test --lib --release: 1158 passed; 0 failed
• cargo test --release --test issue_703: 1 passed; 0 failed; 2 ignored (Issue 통합재정통계 페이지 분할 — TopAndBottom TAC 1×1 wrapper + 각주 환경에서 trailing 빈 paragraph 가 0.84 px 부족으로 다음 페이지로 밀림 #704)
• cargo test --release --test svg_snapshot: 7 passed; 0 failed
• cargo test --release --tests (전체 통합): 0 fail
• cargo clippy --release -- -D warnings: 0 신규 경고
• cargo build --release: 정상
• 196 샘플 SVG/PDF 페이지 수 비교: 회귀 0, 정합 +2 (calendar_year, table-ipc)
  • baseline: mydocs/report/svg_vs_pdf_diff_20260508.tsv
  • after: mydocs/report/svg_vs_pdf_diff_20260508_after.tsv

변경 파일

파일	변동
src/renderer/typeset.rs	+13 본질 정정 + 단위 테스트
tests/issue_703.rs	신규 +51 (3 통합 테스트)
mydocs/plans/task_m100_703.md, _impl.md	신규 (수행/구현 계획서)
mydocs/working/task_m100_703_stage{1,2,3}.md	신규 (단계별 보고서)
mydocs/report/task_m100_703_report.md	신규 (최종 보고서)
mydocs/report/svg_vs_pdf_diff_20260508*.tsv	신규 (196 샘플 비교 baseline + after)

Closes #703.