shortcut.hwp: 다단/구분 칸 암묵 수직 spacing 미재현 → 모든 구분 칸 위·아래 줄 간격 압축 + 일부 페이지 본문영역 초과 렌더링

[planet6897]

대상

• 샘플: samples/basic/shortcut.hwp ↔ 한컴 PDF pdf/basic/shortcut-2022.pdf
• 관측 브랜치: combined-842-846-849 (devel 통합 후에도 동일 예상)

증상

1. 모든 구분 칸 위·아래 줄 간격 좁음 — 섹션 헤더 띠와 <…에서> 부제목 줄 주변 수직 여백이 한컴 대비 ~20px 부족.
   • A. 1×1 TAC 표 띠: 커서 이동·지우기·파일·편집·보기·입력·서식·쪽·도구·표·기타 (Table 1x1 tac=true wrap=위아래, 본체 6.2mm≈23.5px + outer_margin 1mm, anchor 문단 PS line=100%)
   • B. <…에서> 부제목 줄: <미리 보기 상태에서>·<편집 화면 분할에서>·<그림 넣기에서>·<글상자에서>·<상용구에서>·<스타일에서>·<글자 속성>·<문단 속성>·<개요 번호>·<매크로에서>·<F5 셀 블록 상태에서>·<그림 그리기에서> (일반 문단, PS line=160%, bold)
2. 일부 페이지에서 본문영역(body_area) 하단을 넘어 바닥 여백까지 렌더링 — 3쪽 SVG 콘텐츠 max y ≈ 766.1px > 본문영역 하단 758.4px(상단 56.7 + 높이 701.7). 단0~단18(19개 zone)이 쌓여 마지막 zone zone_y_offset=720.2px > 701.7px.

원인 가설

• 한컴은 다단 zone 전환(1단↔2단 다단나누기)과 TAC 표 anchor 문단 주변에 명시 spacing(before/after)에 없는 암묵 수직 간격(2027px) 을 넣는데 rhwp가 이를 재현하지 않음 → 구분 칸 띠가 짧음 → 시각적 압축 + 페이지네이터가 한 쪽에 zone 과적재 → 본문영역 초과.
• 추가 결함: 3쪽 단3에서 <편집 화면 분할에서>(pi=94)와 "화면 이동"(pi=95)이 둘 다 vpos=0으로 겹침 — 닫힌 shortcut.hwp 페이지 3 끝 column-break 행이 페이지 4 첫 줄로 밀림 (다단 zone 분할 결함) #768(다단 zone 분할 행 밀림)과 동일 패턴, 3쪽 overflow에 직접 기여.
• 페이지네이터가 누적 offset의 body_bottom 초과 시 다음 페이지 break 검사가 TAC 표 띠 + 다단 zone 조합에서 작동 안 함.

참고

• Task shortcut.hwp PDF 정합성 잔여 결함 4건 (헤더 표 spacing / 좌여백 / 단 구분선 점선 / 우측탭 오버플로) #842 결함 baseline/line_height/line_spacing 역공학 #1(헤더 1×1 TAC 표 앞뒤 spacing 압축)로 이미 진단·보류됨 — 본 이슈는 1쪽 첫 헤더 띠뿐 아니라 전 페이지 모든 구분 칸에 적용됨을 확장 보고 + 본문영역 초과 증상 추가.
• 관련: RFC [RFC] 한컴 PDF paragraph spacing 알고리즘 정밀 분석 (heading + TAC 표 + zone-level) #774(한컴 PDF paragraph spacing 알고리즘 정밀 분석), 닫힌 shortcut.hwp 페이지 3 끝 column-break 행이 페이지 4 첫 줄로 밀림 (다단 zone 분할 결함) #768 / shortcut.hwp 페이지 2~7 헤더 TAC 1x1 표 후속 spacing 누락 (~13-33px 압축) #770 / shortcut.hwp 페이지 1 헤더 단일 LINE_SEG TAC 표 후속 spacing 누락 (~38px 압축) #773 / Task #773 후속 정정: H1' (column top sb) + H3b (zone 전환 ColumnDef.spacing/2) #776
• 본질 정정 위험군 — RFC [RFC] 한컴 PDF paragraph spacing 알고리즘 정밀 분석 (heading + TAC 표 + zone-level) #774 분석 + 광역 회귀 + 한컴 2010/2020 정답지 검증 동반 필수.
• 진단 자료: mydocs/working/task_m100_842_stage5.md (1쪽 PDF↔rhwp 정밀 비교), 본 이슈 dump-pages/export-svg 관측치.

[planet6897]

진단 완료 — RFC #774 선행으로 전환 (소스 정정 보류)

브랜치 local/task853 에서 진단 + 부분 정정 시도 완료. 결론: 소스 변경 0, RFC #774 선행 권고.

근원: src/renderer/layout/paragraph_layout.rs 의 is_column_top 예외가 column/페이지 첫 문단의 spacing_before 를 통째 드롭. 제목 문단(PS before=52.9px, LINE_SEG vertical_pos=26.45px)이 섹션-top → 드롭 → 한컴 PDF(top≈83.6px = body_top+26.9px ≈ vertical_pos) 대비 ~25px 위로 압축. 추가로 제목↔헤더 ~15px / 헤더↔본문 ~20px deficit 은 다단나누기 zone 전환·TAC 표 띠 line-height 기반 한컴 암묵 간격(= RFC #774 영역). 증상2(3쪽 콘텐츠가 body_bottom 초과) = pi=94/95 vpos=0 겹침, 닫힌 #768 패턴.

부분 정정 시도 결과(is_column_top && para_index==0 에서 spacing_before 를 vertical_pos 로 클램프): shortcut.hwp 제목 위치는 한컴 PDF 와 정합되나, ① 페이지 수 7→8 (한컴 7쪽 — band-transition deficit 미해결로 한쪽으로만 늘어남) ② svg_snapshot 2건(issue_267 목차 제목, issue_617 exam_kor p5) 불확정 시프트 ③ 주 증상(다단나누기 band 간격, band-top 문단은 spacing_before==0)은 그대로 → revert.

후속: 한컴 paragraph spacing(섹션-top / band-top / 페이지-top 각 spacing_before 규칙) + zone 전환 암묵 간격 + TAC 표 띠 line-height 를 PDF·IR 대조로 명세화(RFC #774) 후, paragraph_layout / height_measurer / 페이지 break 를 일괄 정정. 증상2(3쪽 overflow)는 그에 포함하거나 #768 재오픈. 광역 회귀 + 한컴 2010/2020 정답지 검증 필수.

상세: mydocs/working/task_m100_853_stage1.md, mydocs/working/task_m100_853_stage2.md, mydocs/report/task_m100_853_report.md.

[planet6897]

진행 갱신 (브랜치 local/task853) — 범위 확대 후 Stage 2/3 정정 구현

작업지시자 지시로 범위를 "제목 + band 간격 + overflow 전부"로 확대해 정정 구현 완료. cargo test --release 전건 통과(34 suites), svg_snapshot 8/8(golden 2건 갱신 — 섹션-시작 문단 LINE_SEG.vertical_pos 정합).

✅ 완료

• Stage 2 — paragraph_layout.rs: is_column_top && para_index==0(섹션 첫 문단)일 때 spacing_before 를 LINE_SEG.vertical_pos 로 클램프. 제목 baseline 79.4→105.8 (top≈83.8px ≈ 한컴 PDF 83.6px).
• Stage 3-2 — typeset.rs::place_table_with_text: 전폭 TAC 표가 자기 줄에 놓인 경우, 표 줄 높이(표 본체+outer margin)와 일치하는 LINE_SEG 인덱스로 표 앞 텍스트 줄(line0)을 표보다 먼저 배치. PUA 필러 케이스(복학원서.hwp pi=16)는 is_alphanumeric() 로 제외. 2쪽 "파일" 헤더 띠 상단 +3.8→+19.8px(PDF +19.1px ✓), 하단 +27.3→+43.3px(PDF +43.1px ✓).
• Stage 3-3 — typeset.rs: ① 1단 ColumnDef 간격(가로 무의미)을 zone 진입 세로 간격으로 — zone 전환 시 (이전 zone /2)+(새 zone /2) 를 zone_y_offset 에 더함. 1쪽 헤더 띠 zone 69.1→88.0(PDF +87.6px ✓), 본문 zone 100.2→138.0(PDF +137.9px ✓). ② 새 다단 zone 이 페이지 하단 자리 부족 시 다음 페이지로 — LAYOUT_OVERFLOW 25→13.

⏸ 잔존 (RFC #774 영역 — 한컴 정답지 cross-check 필요)

1. 2쪽(쪽나누기로 시작) 헤더 띠↔본문 ~28px gap — pi=36 ColumnDef 간격=0mm 이라 미설명. 후보: TAC wrap=위아래 추가 예약 / 쪽나눔=RowBreak(0x04000006) / 1단→2단 전환 고정 간격. 한컴 편집기(Windows) cross-check 필요.
2. shortcut.hwp 페이지 수 7≠8 + LAYOUT_OVERFLOW 13건 — 잔존 overflow 는 2단 배분(Distribute) 컬럼 분배 메커니즘 영역(별도).

분석 모델·측정: mydocs/tech/hancom_zone_paragraph_spacing.md. 최종 보고서: mydocs/report/task_m100_853_report.md. 커밋: f0d34713(S2) → 1f7328b2(S3-2) → d011d43d/b74967bf(S3-3). 이슈는 잔존 1·2 처리 위해 OPEN 유지.

[planet6897]

마무리 — Stage 2/3 완료, 잔존 2건 후속 이슈로 분리

작업지시자 지시로 본 타스크를 여기서 마무리. 완료 내역(브랜치 local/task853, cargo test --release 전건 통과 34 suites, svg_snapshot 8/8):

• Stage 2 f0d34713 — 섹션-top 제목 spacing_before → LINE_SEG.vertical_pos 클램프
• Stage 3-2 1f7328b2 — 헤더 띠 line0 텍스트를 표 위 별도 줄로 (PR Task #770: shortcut 페이지 2~7 헤더 TAC 표 후속 LINE_SEG 정합 #771/Task shortcut.hwp 페이지 2~7 헤더 TAC 1x1 표 후속 spacing 누락 (~13-33px 압축) #770 과 동일 효과를 typeset.rs::place_table_with_text 경로로)
• Stage 3-3 d011d43d — 1단 ColumnDef 간격을 zone 진입 세로 간격으로 (1쪽 완전 정합: 헤더 띠 +88px, 본문 +138px, 한컴 PDF ±1px)
• Stage 3-3b/c b74967bf ca3d6484 — 다단 zone 가드 + Distribute vpos-reset 검출 → LAYOUT_OVERFLOW 25→2

잔존(한컴 정답지 cross-check / 추가 측정 필요)은 신규 이슈로:

• shortcut.hwp: 쪽나누기로 시작하는 페이지의 헤더 TAC 띠 ↔ 본문 사이 ~28px gap 미재현 #866 — 쪽나누기로 시작하는 페이지의 헤더 TAC 띠↔본문 ~28px gap 미재현 (PR Task #770: shortcut 페이지 2~7 헤더 TAC 표 후속 LINE_SEG 정합 #771/RFC [RFC] 한컴 PDF paragraph spacing 알고리즘 정밀 분석 (heading + TAC 표 + zone-level) #774 가 못 닫은 본질)
• shortcut.hwp: 페이지 수 7≠8 + 다단 zone 경계에서 잔존 LAYOUT_OVERFLOW 2건 #867 — 페이지 수 7≠8 + 잔존 LAYOUT_OVERFLOW 2건 (shortcut.hwp: 쪽나누기로 시작하는 페이지의 헤더 TAC 띠 ↔ 본문 사이 ~28px gap 미재현 #866 에 종속)

최종 보고서: mydocs/report/task_m100_853_report.md. 분석 모델: mydocs/tech/hancom_zone_paragraph_spacing.md. 본 이슈 close.