[planet6897]

요약

쪽 끝에서 나뉘는 쪽 나눔 표의 첫 조각이 저장 첫 프레임 경로(stored_complete_extent·첫 조각 빈 밴드)로 확정되고 앞선 배치 계획이 없을 때, 위 캡션이 붙은 표가 캡션 높이(약 25px)만큼 내려 그려지던 문제를 고친다. 첫 조각 아래 괘선이 본문 아래를 넘던 넘침도 함께 사라진다.

Refs #7732 (issue1937 20쪽의 원인 중 하나 — 이슈 전체를 닫지 않는다)

#8133 에 의존한다. 이 branch 는 upstream/devel d9fd85ed5 위에 #8133(#8125 가는 획 장치 한 칸 — Native Skia·WASM Canvas2D·CanvasKit)의 코드 커밋 6개를 그대로 얹었다(5개는 이 PR 커밋 아래, CanvasKit e89e55644 는 맨 위 — #8133 의 CI CanvasKit readiness 보정을 따라 얹었다). 새 표본 4쪽이 그 수정 없이는 0.48px 표 괘선이 옅게 찍혀 86% 대라, 회귀 추가 선행 조건(전쪽 Native/fresh WASM 90% 이상)을 충족하려면 #8133 이 필요하다. #8133 병합 뒤 rebase 하면 이 PR 의 diff 는 아래 두 커밋만 남는다.

• 5d80f3047 fix(table): 원점에서 캡션 이중 계상 제거 + 표본·정본 PDF·회귀 검사
• 692168436 docs(report): 수정 전후 review/overlay

원인

src/renderer/typeset/table/continuation/fragment/emit.rs 에서 이 경로가 원점을 새로 만들 때 위 캡션 높이 caption_extra 를 원점에 넣었다. 이후 소비 지점은 모두 원점을 위 캡션을 포함한 개체 상자의 위끝으로 보고 캡션을 한 번 더 더한다.

소비 지점	원점 사용
예산 budget.rs	프레임 = 하단 − 원점 − 캡션
확정 commit_fragment	캡션 + 조각 높이
그리기 table_partial.rs	표 = 원점 + 캡션 + 간격

그래서 캡션이 두 번 들어갔다. 이 이중 계상은 fd1a53fdc 에서 들어왔고, 그 커밋의 사례에는 위 캡션이 없었다.

변경

한 줄이다. 이 경로의 원점에서 캡션을 빼 current_height + host_before_overhead + vert_offset_overhead 로 만든다. 다른 원점 생산자와 같은 정의다.

• 적용: 저장 첫 프레임 경로로 확정되고 앞선 배치 계획이 없는 첫 조각 중 위 캡션이 있는 표.
• 비적용(값이 바뀌지 않음): 아래 캡션 표, 캡션 없는 표, 이어지는 조각. caption_extra 는 첫 조각의 위 캡션에서만 0이 아니다.

검증 (head 692168436)

이후 head e89e55644 는 #8133 의 CanvasKit 커밋(rhwp-studio/src/view/canvaskit-renderer.ts)만 더했다. Visual Sweep 의 Native·fresh WASM(Canvas2D) 출력과 회귀 검사에는 닿지 않는 경로라 아래 결과·이미지(692168436 고정)를 그대로 쓴다.

표본 교체

이전 표본 top_caption_rowbreak_p31.hwp 는 그 사이 devel 의 다른 변경으로 이 경로를 타지 않게 되어 수정 전에도 통과했다(이전 본문의 ⚠ 항목). 그래서 결함이 실제로 남아 있는 issue1937 20쪽에서 새 표본을 만들었다.

• 입력 samples/issue1937/top_caption_rowbreak_p20.hwp — samples/issue1937_rowbreak_footnote_overpagination.hwp(50쪽)의 문단 126–145(18–21쪽)만 남겨 한/글 2024 로 다시 저장한 5쪽 문서. 저장 줄과 표 첫 프레임은 한/글이 다시 썼다.
• 기준 pdf/issue1937/top_caption_rowbreak_p20-2024.pdf — 같은 저장본의 한/글 2024 Print 출력(5쪽).
• 3쪽 끝 표(pi=18)는 위 캡션 «< 부담금 개별법령상 납부의무 완화 규정 종합 >» 을 달고 쪽 끝에서 나뉜다. 정본은 표 위 괘선 834.1px · 첫 조각 아래 괘선 1005.0px(96dpi)다.
• 이전 p31 표본·PDF 는 이 PR 에서 뺐다.

전체 쪽 Visual Sweep

판정값 = raw 실루엣(TSV 4열), --compat 2024. 수정 전 = 같은 branch 에서 emit.rs 만 되돌린 빌드.

쪽	Native 수정 전	Native 수정 후	fresh WASM 수정 전	fresh WASM 수정 후
1	99.96	99.96	99.96	99.96
2	99.99	99.99	100.00	100.00
3	73.84	99.90	73.87	99.87
4	99.59	99.59	99.49	99.49
5	99.73	99.73	99.56	99.56

• 쪽수: rhwp 5쪽 = 한/글 5쪽. 수정 후 90% 미만 쪽 없음(Native·WASM 모두, 최저 99.49).
• render tree: 수정 후 캡션 줄 810.2–823.5px, 표 834.9–1006.2px(정본 캡션 글자 807.4–823.4 · 괘선 834.1/1005.0). 수정 전 표 위끝 859.6px.
• 직접 판독(3쪽 아래): 수정 전에는 캡션과 표가 약 25px 내려가 overlay 에서 PDF 표와 어긋나고 셋째 행이 본문 아래로 넘친다. 수정 후 캡션·머리행·1~3행 괘선과 글자가 PDF 와 겹친다(Native·WASM 같음).

대표 이미지 (3쪽)

Native 수정 전 review / overlay

Native 수정 후 review / overlay

fresh WASM 수정 전 / 수정 후 review

회귀 테스트

tests/cases/issue_7732_source_frame_top_caption_origin.rs — stored_first_frame_top_caption_table_is_drawn_once_below_its_caption

• 쪽수 5(한/글 2024 Print 정본).
• 캡션 줄이 표 바로 위에 한 번 놓인다(캡션 아래 ≤ 표 위, 간격 12px 이내).
• 첫 조각이 본문 영역 안에 든다.
• 3쪽은 Native 99.90 · WASM 99.87(양쪽 98% 이상)이고 직접 판독을 마쳐, 정본 표 위 괘선 834.1px · 첫 조각 아래 괘선 1005.0px 을 ±2px 로 고정한다.
• 수정 전 실패(emit.rs 만 되돌린 빌드): 표가 캡션 높이만큼 내려 첫 조각이 본문 아래를 넘는 assertion 에서 실패. 수정 후 통과.

게이트 (head 코드)

• fmt diff 0, Clippy(native · wasm32 · workspace all-targets · native-skia all-targets), workspace build, manifest --check 통과.
• nextest(--features native-skia) 11,531건 중 11,528 통과. 실패 3건 issue_7966_pdf_close_stroke::* 는 이 host 의 core.autocrlf=true 가 fixture pdf/issue7966/close-stroke-controls.pdf 를 CRLF 로 꺼내 바이트가 바뀐 탓이다(ImportResourceLimit). 저장소 blob 그대로의 바이트로 되돌리면 3건 모두 통과한다. 이 변경과 무관하다.

원문 문서(보조 증거)

발췌 전 원문 samples/issue1937_rowbreak_footnote_overpagination.hwp 20쪽: Native 70.93 → 94.03, fresh WASM 71.30 → 94.92. 원문에는 이 수정과 무관하게 수정 전후 값이 같은 90% 미만 쪽(21·33–43쪽, Native 는 49쪽 포함)이 남아 있어 검증 대상·fixture 로 쓰지 않고 보조 증거로만 적는다. 이 PR 은 #7732 전체를 닫지 않는다.

미검증

• 10k 코퍼스·samples A/B 의 넓은 영향(12문서 넘침만 감소, 쪽수 변화 없음 / samples 변화 없음)은 이전 head(같은 emit.rs 한 줄)에서 잰 값이며 새 base 에서 다시 재지 않았다.
• 한/글이 저장한 합성 입력(위/아래/없음 캡션, 오프셋)은 이 경로를 타지 않아(host 배치를 받음) 다른 경로의 무변화만 확인했다.

🤖 Generated with Claude Code

[planet6897]

devel 에 이미 반영되어 닫습니다

#8191 이 devel 에 들어간 뒤 이 PR 이 충돌 상태가 되어 다시 확인했습니다. 이 PR 의 코드 없이 최신 upstream/devel 9418ed0c7 에 이 PR 의 회귀 검사와 표본(samples/issue1937/top_caption_rowbreak_p20.hwp)만 얹어 실행하면 통과합니다.

회귀 검사	devel 9418ed0c7
issue_7732_source_frame_top_caption_origin::stored_first_frame_top_caption_table_is_drawn_once_below_its_caption	통과 (표 위 괘선 정본 834.1px ±2)

devel 의 저장 첫 프레임 경로가 위 캡션 표 원점에 캡션을 두 번 더하지 않게 되어, 이 PR 의 emit.rs 한 줄 수정이 더 필요 없습니다. 이 PR 은 닫습니다.

• 이 PR 이 얹고 있던 가는 획 수정([native-skia] 장치 한 칸보다 가는 획이 anti-alias 덮임만큼 옅어져 표 괘선이 사라진다 #8125)은 fix(renderer): Native Skia·WASM Canvas2D 획은 장치 한 칸보다 가늘게 그리지 않는다 (#8125) #8133 에서 계속 진행합니다(최신 devel 위로 rebase·재검증 중).
• 회귀 검사·표본·Print PDF 는 브랜치 fix/source-frame-top-caption-origin 에 남아 있습니다. 이 표본은 4쪽이 fix(renderer): Native Skia·WASM Canvas2D 획은 장치 한 칸보다 가늘게 그리지 않는다 (#8125) #8133 없이는 90% 미만이라 fix(renderer): Native Skia·WASM Canvas2D 획은 장치 한 칸보다 가늘게 그리지 않는다 (#8125) #8133 병합 뒤 검사만 따로 올리는 것을 검토하겠습니다.
• [7445] 소상공인 중간보고서 RowBreak 표·각주 전체 피델리티 #7732 는 다른 쪽 잔여가 있어 열어 둡니다.