Task #702: shortcut.hwp 다단 정의 후속 갱신 누락 정정 (closes #702)

[planet6897]

Summary

samples/basic/shortcut.hwp (한글 2010 단축키 일람표, A4 가로) 의 SVG 출력이 한글 2022 PDF 정답 (pdf/basic/shortcut-2022.pdf, 7쪽) 대비 10쪽 (+43%) 으로 폭주하던 결함 정정.

항목	수정 전	수정 후
페이지 수	10	8 (PDF 7 +1쪽)
LAYOUT_OVERFLOW	다수 (40~60px)	1건 (페이지 8 마지막)
페이지 1 지우기	1단 6항목 적층	2단 3+3 분할 ✓
페이지 2 섹션	파일 header 만	파일+미리보기+편집 통합 ✓

Root cause (2건)

본질 1A — Distribute 다단의 짧은 컬럼 vpos-reset 임계값

src/renderer/typeset.rs:430-446

기존 임계값 pv > 5000 이 짧은 Distribute (배분) 컬럼 (예: 지우기 3+3 분배, 마지막 paragraph vpos=3000) 에서 미달 → column-advance 미발동 → 6항목 1단 적층.

정정: ColumnType::Distribute (HWPX BalancedNewspaper) 한정 임계값 pv > 0 으로 완화. Normal/단단 분기는 기존 pv > 5000 유지.

본질 1B — Page/Column break + 새 ColumnDef 미적용

shortcut.hwp p2 의 파일/미리보기/편집 sections 는 다음 패턴 사용:

• [쪽나누기] + 단정의:1단 + 표(header)
• [단나누기] + 단정의:2단 배분

기존 코드는 MultiColumn break 만 ColumnDef 적용 → Page/Column break 동반 ColumnDef 무시 → col_count 가 이전 zone 값 유지 → 페이지 분기 폭주.

정정: Page/Column break 처리 시 새 ColumnDef 검출 후 zone 재정의:

• Column + has_diff_col_def: process_multicolumn_break 호출
• Column + 동일 ColumnDef: 기존 advance_column_or_new_page
• Page/Section + has_diff_col_def: force_new_page 후 ColumnDef 적용

변경 파일

• src/renderer/typeset.rs (+50 / -6)
  • ColumnType import + TypesetState.current_zone_column_type 필드
  • TypesetState::new 시그니처 변경 (column_type 인자)
  • 메인 루프 column-break 검출 + ColumnDef 적용
  • vpos-reset trigger 분기 (Distribute 한정 완화)
  • process_multicolumn_break 에서 column_type 전파
• tests/issue_702.rs (신규, 2 회귀 가드)
  • shortcut_distribute_short_column_split: 페이지 수 ≤ 8
  • shortcut_page2_has_three_sections: 페이지 2 SVG 에 파일/편집 헤더 모두 존재
• mydocs/plans/task_m100_702.md, task_m100_702_impl.md
• mydocs/working/task_m100_702_stage2.md, task_m100_702_stage3.md
• mydocs/report/task_m100_702_report.md

회귀 차단 가드

Normal (NEWSPAPER) 다단은 기존 pv > 5000 유지 → Task #321/#418/#470 회귀 차단:

• tests/exam_eng_multicolumn.rs: 14 passed
• tests/issue_418.rs: 1 passed
• tests/svg_snapshot.rs: 7 passed (golden snapshots)
• tests/issue_702.rs: 2 passed (신규 가드)
• 전체 cargo test --release: 1248+ tests, 0 failed

잔여 결함 → 별도 이슈 분리

• Issue shortcut.hwp pi=94 bare [단나누기] 마지막 col 시프트 — 1쪽 잔여 차이 (Task #702 후속) #708: pi=94 bare [단나누기] at last col 1쪽 시프트
  • fix 시도 시 test_539_partial_paragraph_after_overlay_shape, test_548_cell_inline_shape_first_line_indent_p8, test_exam_math_page_count 회귀 발견 → rollback
  • 별도 task 에서 회귀 가드 더 정밀 분석 후 처리
• Issue shortcut.hwp 부수 결함 — PUA 글자 + 탭 leader + 바탕쪽 자동번호 미렌더 (Task #702 후속) #709: 부수 시각 결함 4건 (PUA 글자 / 탭 leader / 바탕쪽 자동번호 / 우측 정렬)

다른 열린 PR 과의 관계

src/renderer/typeset.rs 를 건드리는 다른 열린 PR (#644, #679, #707) 과 텍스트 충돌 없음 (각각 다른 line 영역, 다른 함수 분기):

• PR Task #643: 페이지 분할 드리프트 정정 (5축 정합) — closes #643 #644 (Task 페이지 분할 드리프트 — pi=80 마지막 줄 다음 페이지로 넘어감 (2022 국립국어원 업무계획.hwp p6) #643): L563-571 vpos_end + L881 LAYOUT_DRIFT_SAFETY_PX (다른 메커니즘)
• PR Task #676: 통합재정통계 trailing empty paragraph 페이지 분리 정정 #679 (Task 통합재정통계 2010.11/2011.10 — 본문 끝 빈 줄이 페이지 2로 밀려 PAGE_MISMATCH (1p → 2p) #676): L629/L894-898/L1005-1029 typeset_paragraph + trailing empty 가드 (col_count == 1 한정)
• PR Task #703: BehindText/InFrontOfText 표 본문 흐름 누락 정정 (closes #703) #707 (Task BehindText/InFrontOfText 표가 paragraph 높이에 포함되어 trailing 항목이 다음 페이지로 밀림 (calendar_year, 통합재정통계) #703): L1368-1382 BehindText/InFrontOfText 표 분기 (표 shape 처리)

머지 순서 무관, rebase + cargo test 통과 시 안전.

Test plan

• cargo build --release 통과
• cargo test --release: 1248+ passed, 0 failed
• rhwp dump-pages samples/basic/shortcut.hwp: 페이지 1 지우기 단 5/6 = items=3/3, 페이지 2 = 파일+미리보기+편집 통합
• rhwp export-svg samples/basic/shortcut.hwp: 8쪽 (수정 전 10쪽), LAYOUT_OVERFLOW 1건 (수정 전 다수)
• 시각 판정 (qlmanage 비교): 페이지 1, 2 PDF 정합 우수
• 광범위 샘플 회귀 (KTX, aift, hwp-multi-001, kps-ai, exam_eng): 무회귀

🤖 Generated with Claude Code