fix: 빈 paragraph + 다음 [쪽나누기] case 단독 page 차단 — HWP3 sample18 페이지 수 +2 inflate 해소 (closes #967)

[jangster77]

요약

samples/hwp3-sample18.hwp (HWP3) 페이지 수 rhwp 69 vs 한컴 67 — +2 inflate.

빈 paragraph (pi=27, pi=164) 직후 [쪽나누기] (pi=28, pi=165) case 에서 빈 paragraph 가 별도 page 분기 → 단독 빈 페이지 생성.

Root cause

src/renderer/typeset.rs:555-584 의 next_will_vpos_reset 가드:

let next_force_break = next_para.column_type == ColumnBreakType::Page
    || next_para.column_type == ColumnBreakType::Section;
if next_force_break {
    false   // ← hwp-multi-001 회귀 차단 목적
}

pi=28/165 의 [쪽나누기] → next_force_break=true → 가드 미발동 → pi=27/164 단독 page 생성.

Fix (refined v2 — overflow 시에만 발동)

기존 가드 직후 별도 분기 추가:

} else if !st.current_items.is_empty() && para_idx + 1 < paragraphs.len() {
    // [Task #967] 빈 paragraph 직후 force page break (쪽나누기) case
    let next_force_break = next_para.column_type == ColumnBreakType::Page
        || next_para.column_type == ColumnBreakType::Section;
    let is_curr_empty = para.text.is_empty() && para.controls.is_empty();
    if next_force_break && is_curr_empty {
        // empty paragraph 의 예상 height = first line_seg 의 lh + ls
        let empty_h_px = para.line_segs.first().map(|s|
            hwpunit_to_px((s.line_height + s.line_spacing) as i32, self.dpi)
        ).unwrap_or(0.0);
        let avail = st.available_height() - st.current_height;
        if empty_h_px > avail {
            // 빈 paragraph 가 fit 안 됨 → skip 으로 단독 page 차단
            continue;
        }
        // fit 가능 — 정상 emit (기존 동작)
    }
}

핵심 정밀화: 빈 paragraph 가 실제로 fit 안 되는 case 만 skip. fit 가능한 case (aift.hwp 의 18 case) 는 정상 emit.

CI 회귀 (aift snapshot) 발견 후 v2 로 정밀화. v1 (조건 무관 skip) 은 aift.hwp page 3 의 normally-fitting empty paragraph 도 skip 하여 layout 변경 → snapshot 회귀.

검증

• cargo test --release (전체): 통과 (lib 1288 + integration tests 8 svg_snapshot 포함)
• sample18.hwp 페이지 수: 69 → 67 ✓ (한컴 정합)
• 다중 sample 회귀 검증 (16 sample): 모두 회귀 0
  • sample, 10/11/13/14/16/19/4/5, table_test*, multi-table-001/002, exam_kor/math/eng
  • hwp-multi-001 (회귀 차단 case): 변경 없음 ✓
• aift.hwp snapshot test: PASS ✓ (v1 회귀 해소)

영향

영역	영향
빈 paragraph + 다음 [쪽나누기] + overflow	skip → +1 page inflate 제거
빈 paragraph + 다음 [쪽나누기] + fit 가능	영향 없음 (정상 emit)
비-빈 paragraph + 다음 [쪽나누기]	영향 없음 (기존 동작)
빈 paragraph + 다음 일반 paragraph	영향 없음 (기존 vpos-reset 가드)
hwp-multi-001 (회귀 차단)	영향 없음

잔존 (별도 task)

• HWPX sample18-hwp5.hwpx +7 inflate — 별도 issue (HWPX 특화 pagination)

관련

• 닫힌 issue #927 — sample16 페이지 수 inflate (본 fix 와 무관)

Test plan

• cargo test --release 전체 통과 (lib + integration svg_snapshot 포함)
• sample18.hwp 페이지 수 한컴 정합 (67)
• 다중 sample 회귀 0 (특히 hwp-multi-001, aift.hwp)

🤖 Generated with Claude Code

[edwardkim]

@jangster77 머지 완료 (commit d0c25754).

next_force_break (쪽나누기) 시 next_will_vpos_reset 가드 미발동 (hwp-multi-001 회귀 차단 목적) root cause 정확 진단. v2 정밀화 — v1 (조건 무관 skip) → aift.hwp snapshot 회귀 → v2 (overflow 한정, empty_h_px > avail 시에만 skip) → aift.hwp 18 case 정상 emit + sample18 fix. 일반화 위험 발견 후 케이스별 정밀화 (feedback_hancom_compat_specific_over_general 권위 사례).

본 환경 자기 검증:

• cargo test --release 전체 (lib 1288 passed + integration svg_snapshot 8) ALL GREEN
• cargo clippy --release -- -D warnings 통과
• 광범위 sweep 7 fixture / 169 페이지 / 169 same / 0 diff (aift.hwp 74 same — v1 회귀 해소 입증)
• WASM 4.4 MB 재빌드
• typeset.rs auto-merge — devel Task HWP5 시험지 sample (3-09월~3-11월): 페이지 column 높이 측정 부정합 — 한컴오피스 viewer 시각 차이 #836 Endnote (:1064/1091) 보존 + PR fix: 빈 paragraph + 다음 [쪽나누기] case 단독 page 차단 — HWP3 sample18 페이지 수 +2 inflate 해소 (closes #967) #968 :585 분기 양립

참고: samples/hwp3-sample18.hwp 영역 영역 본 PR 미포함 + 본 환경 부재 (PR 본문 fixture 추가 명시 부재). 작업지시자 결정 영역 영역 sweep 169/169 same + cargo test 전체 통과 영역 영역 회귀 부재 입증 + sample18 페이지 수 69→67 정합 영역 영역 PR 본문 신뢰 영역 영역 머지. 차후 sample18 fixture 별도 추가 권장 (회귀 가드).

CI ✅ Build & Test + CodeQL + Canvas visual diff. 잔존: HWPX sample18-hwp5.hwpx +7 inflate (별도 task).

@jangster77 PR 시리즈 (연속 5 PR #956~#964 + #966 + #968) 완결. 수고하셨습니다.