Task #688: table-vpos-01.hwpx p.5 nested 표 외부 셀 height 미반영 (외부 표 + 측정자 1×1 unwrap 동일 결함)

[planet6897]

요약

samples/table-vpos-01.hwpx 5쪽 마지막 큰 표(pi=34, "정부혁신 4대 추진전략 / 12대 추진과제")의 nested 11×3 그리드(4그룹 + 12 추진과제)가 SVG 출력에서 시각적으로 누락되는 결함을 수정합니다.

PDF 권위본 (pdf/table-vpos-01-2022.pdf) 5쪽과 시각 정합 회복.

결함 본질 (두 곳 동일 코드 결함)

외부 1×1 표 셀 안에 nested 표 2개 (1×1 헤더 + 11×3 그리드) 가 있는 구조 처리 시:

• src/renderer/layout/table_layout.rs::layout_table()
• src/renderer/height_measurer.rs::measure_table_impl()

두 곳 모두 1×1 래퍼 unwrap 로직이 `flat_map(...).find_map(...)` 으로 셀 paragraphs 전체를 훑어 첫 nested 표만 가져오는 패턴.

paragraphs 가 2개 이상이면 두 번째 nested 표가 통째 누락:

• layout_table: 외부 표가 nested 1×1 헤더로 unwrap → 11×3 그리드 누락
• measure_table: measured_table.row_heights 가 nested 1×1 헤더 height(57.72px) 로 잡힘 → cell-clip 이 작게 그려져 nested 11×3 셀(y=295~)이 클립 밖

두 결함이 결합되어 페이지 5 의 nested 11×3 그리드가 SVG 에 그려지지 않거나 클립으로 가려졌습니다.

수정

두 곳 모두 unwrap 조건을 다음 4가지 모두 충족하는 경우로 좁힘:

1. 외부 표 1×1 단일 셀 (현행)
2. 셀 paragraphs 가 정확히 1개
3. 그 paragraph 의 control 이 정확히 1개의 nested table 만
4. visible text 없음 (현행)

Commit	파일	라인
Stage 1	`src/renderer/layout/table_layout.rs`	+15 / -7
Stage 3 fix	`src/renderer/height_measurer.rs`	+13 / -9

검증

시각 정합 (DoD 1~4)

`rsvg-convert` 로 SVG → PNG 변환:

시점	페이지 5 PNG	nested 11×3 그리드
결함 (수정 전)	❌	누락
Stage 1 만	26 KB	클립으로 가려짐
Stage 1 + Stage 3 fix	142 KB	✅ 완전 표시 (PDF 권위본 정합)

광범위 회귀 (DoD 5)

159 샘플 / 1502 페이지 SVG byte 비교:

• 의도된 변경: `table-vpos-01.{hwp,hwpx}` 페이지 5
• 자연 해소: `exam_social.hwp` 페이지 1 (동일 결함이 paras=3 인 1×1 셀에도 영향, 외부 표 정상 렌더로 cell-clip 통합)
• 회귀 0건

단위 테스트 (DoD 6)

`cargo test` 1192+ 테스트 전부 통과 (SVG 스냅샷 6건 포함)

보조 관찰 (별개 결함, 본 PR 범위 외)

• 페이지 2 hwp_used diff = -791.9px, 페이지 3 = -1658.3px — 본 수정과 무관, 후속 이슈 분리 권장
• 1×1 래퍼 unwrap 로직이 `layout_table` 과 `height_measurer` 두 곳에 중복 — 향후 공통 helper 추출 검토

Test plan

• `cargo build --release`
• `cargo test --release` 전체 통과
• `samples/table-vpos-01.hwpx` SVG 시각 정합 (PDF 권위본 비교)
• 159 샘플 / 1502 페이지 회귀 검증 (회귀 0건)

closes #688

🤖 Generated with Claude Code