다단: 마지막 단 단나누기 시 같은 페이지 새 단-밴드 (배분 단 한정) — #846 + #849

[planet6897]

개요

다단(2단 이상) zone 의 마지막 단에서 명시적 단나누기([단나누기])를 만났을 때, 새 페이지가 아니라 같은 페이지에 새 단-밴드를 시작하도록 한다 (≈ 닫힌 #768). 단, 이는 단 유형이 "배분"(Distribute) 인 zone 에서만 — "일반"(Normal/신문형) 단은 기존대로 새 페이지로 간다.

local/task846 (#846, 신규 동작) + local/task849 (#849, 배분 단 한정 게이트 + 회귀 해소) 를 묶은 PR.

closes #846
closes #849

변경 내용

• src/renderer/typeset.rs:
  • start_new_column_band(...) 추가 — 마지막 단 명시적 단나누기 시: flush_column → 다음 밴드 콘텐츠에 떠다니는(글자처럼 취급 아닌) 표·그림·그리기 개체가 있으면 새 페이지, 아니면 직전 밴드 높이만큼 zone_y_offset 진행 후 같은 페이지에 새 밴드 (들어갈 공간이 있을 때; 없으면 새 페이지).
  • paginate 의 ColumnBreakType::Column 경로: 마지막 단 + col_count > 1 + current_zone_column_type == ColumnType::Distribute 일 때만 start_new_column_band 호출. 그 외(Normal/Parallel zone, 비-마지막 단)는 기존 advance_column_or_new_page 유지.
  • process_multicolumn_break 는 변경 없음 ([다단나누기] 동작 보존).
• mydocs/plans|working|report/task_m100_846*.md, task_m100_849*.md: 수행/구현 계획서, 단계별 보고서, 최종 보고서.

효과 / 검증

샘플	한컴 PDF	base(devel)	본 PR
basic/shortcut.hwp	7 (2022)	8	7 ✅ (pi=94/95 <편집 화면 분할에서> | 화면 이동 ⟶ Ctrl+W,N 가 페이지 4 → 페이지 3)
exam_math.hwp (신문형 다단)	20	20	20 (무변화)
21_언어_기출_편집가능본.hwp	15/16	15	15 (무변화)
그 외 다단 샘플 (exam_eng/kor/science/social, k-water-rfp, biz_plan, hwpspec, hwp-3.0-HWPML, aift, treatise, interview, issue-505-equations …)	—	—	무변화

• SVG 바이트 비교(export-svg): shortcut.hwp 페이지 3~7 변화 + 페이지 8 제거(8→7페이지). 그 외 다단 샘플 전 페이지 base 와 바이트 동일.
• cargo test --lib: 1232 passed, 0 failed.
• cargo clippy --lib: 신규 경고 0.

Test plan

• cargo test
• cargo clippy
• rhwp export-svg samples/basic/shortcut.hwp — 페이지 3 하단에 <편집 화면 분할에서> / 화면 이동 ⟶ Ctrl+W,N 2단 밴드 정상 표시, 총 7페이지
• rhwp dump-pages samples/exam_math.hwp -p 0 — 20페이지 (회귀 없음)

🤖 Generated with Claude Code

[edwardkim]

검토 + cherry-pick 머지 완료. 감사합니다.

처리 결과

• cherry-pick: GitHub PR diff 기반 (author Jaeook Ryu 보존, mydocs 제외)
• devel push: 7468c930
• closes 다단: 마지막 단에서 명시적 단 나누기 시 같은 페이지 새 단-밴드 미생성 (shortcut.hwp p3→p4, ≈#768) #846, 다단: 마지막 단 단나누기의 같은-페이지-새-밴드는 "배분" 단에서만 (신문형 단은 새 페이지) #849

재검증

검증	결과
cargo test --release --lib	1246 passed (회귀 0)
SVG before/after	shortcut.hwp 8→7페이지 (한컴 2022 PDF 정합)
다단 샘플 회귀	exam_math 등 전부 무변화
시각 판정	★ 통과

배분 단 한정 게이트(#849)로 신문형 다단 회귀를 차단한 설계가 좋습니다. 수고하셨습니다.