[planet6897]

요약

글이 있는 host 문단에 문단 기준 자리차지 표가 둘(T3 오프셋 0, T4 양수 오프셋) 있는 HWP 저장본에서 T4 가 정본보다 약 88px 아래에 그려지던 문제를 고친다. T4 의 세로 오프셋을 문단 원점이 아니라 T3 아래로 밀려 저장된 host 첫 줄에서 쟀기 때문이다.

• 이슈: Closes [layout/table] HWP 저장본에서 글 host 의 양수 오프셋 자리차지 표를 문단 원점이 아니라 밀린 host 저장 줄에서 잰다 — T4 가 88px 아래 (합성 K1~K4) #8156
• base: upstream/devel f7abae4a8
• fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 위에 쌓았다. 첫 커밋 95af7c48c 는 fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 의 코드 커밋(e648df1cf)을 cherry-pick 한 것이다. K1~K3 의 남은 +4.3px 는 fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 몫이라 함께 있어야 수용 기준을 확인할 수 있다. fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 병합 뒤 rebase 한다.
• code head: 5b5e42912
• 증적 head: 19626cce2

원인 — 생산 → 소비 경로

1. 같은 문단의 오프셋 0 표 T3 는 흐름을 소비한다. 한/글은 host 첫 줄을 T3 띠 아래에 저장한다(K4: 문단 원점 3200HU, host 줄 vpos 9766HU = 3200 + T3 띠 6566HU).
2. typeset/table/block/entry.rs 의 통째 배치는 저장 사다리가 인증한 그 첫 줄 원점(source_text_origin)을 글줄 원점이자 표 앵커로 from_stored_host / from_stored_head_host 에 넘겼다. 이 합성은 제어문자가 글 앞이라 from_stored_head_host 갈래를 탄다.
3. 그 결과 T4 의 table_top 이 T3 띠(87.5px)만큼 내려가 확정 배치로 기록되고(record_paragraph_float_placement), layout 이 그 값을 그대로 그렸다.
4. T3 는 문단 원점(placement_para_start_height)에 놓인다. 같은 문단의 두 공동 앵커 표가 서로 다른 원점에서 재였다.

수정

같은 문단에 앞선 공동 앵커 자리차지 표가 있으면(has_preceding_coanchored_float) 두 생성자에 문단 원점을 넘긴다.

• 글줄은 종전대로 저장 원점(stored_host_origin)을 쓴다. 글줄 위치는 바뀌지 않는다.
• T4 의 자연 위치가 앞 표의 띠와 겹칠 때 아래로 쌓는 처리는 기존 HostPlacementConstraint 가 그대로 맡는다(K1·K3).
• 앞 표가 없는 host(단일 양수 오프셋 표)는 이 분기를 타지 않는다.

검증

입력은 #7687 합성 K1~K4(samples/issue7687/gen_titled_host_after_band.py)를 한/글 2020 으로 HWP 저장한 samples/issue8156/titled-host-hancom2020-saved.hwp(SHA-256 0fe65f11…fd776)다. 정본은 같은 HWP 의 한/글 2020 Print pdf/issue8156/titled-host-hancom2020-saved-2020.pdf(4쪽, 5ce45d9d…05df8)다.

직접 좌표 (96dpi px)

위치	한/글 정본	#8157 만	이 PR
K1 T4 윗변	492.4	700.5	492.9
K2 T4 윗변	612.3	700.5	612.9
K3 T4 윗변	471.2	679.1	471.6
K4 T4 윗변	298.4	386.3	298.7
K4 host 「K4 제목」	262.6	262.5	262.5 (불변)
K4 T3 윗변	178.5	178.7	178.7 (불변)

PDF 텍스트 상자 대조: 네 쪽 모든 표 셀 글자·본문 줄이 정본과 0.5px 안에서 맞는다.

Visual Sweep — 전쪽 TSV (tolerant_content_match_percent, raw 2px 실루엣)

전체 쪽수 rhwp 4 = 정본 4.

출력	1쪽	2쪽	3쪽	4쪽
Native 수정 전(#8157 만)	73.37	71.81	68.73	53.07
Native 이 PR	100.00	100.00	100.00	100.00
fresh WASM 이 PR	100.00	100.00	100.00	100.00

대표 이미지 (head 19626cce2)

K4(4쪽, 앞 빈 host 없음) — 수정 전 / 수정 후 review (Native)

K4 overlay (이 PR, Native / fresh WASM)

K1(1쪽, T4 가 앞 빈 host 의 T2 띠 아래에 쌓이는 경우) — 수정 전 / 수정 후 review (Native), overlay (이 PR, Native / fresh WASM)

직접 판독: K4 의 T4 는 「K4 제목」 줄 아래·「K4 글 1」 위에, K1 의 T4 는 T2 바로 아래에 놓여 정본 괘선과 겹친다. 글줄·T3 는 전후 같다. 남은 차이는 글리프 굵기뿐이다.

회귀 검사

tests/cases/issue_8156_saved_host_offset_float_anchor.rs::saved_titled_host_measures_offset_float_from_paragraph_origin 를 추가했다. 기대값은 원본 속성(오프셋 9000HU, 바깥 여백 283HU)과 저장 줄에서 정한 관계이며, 정본 PDF 와 0.6px 안에서 맞는다.

• K2·K4: T4 − T3 = 오프셋, host 첫 글줄 = T3 아랫변 + 아래 바깥 여백(저장 줄 보존), host 글줄은 T4 위, T4 뒤 첫 글줄 = T4 아랫변 + 아래 바깥 여백
• K1·K3: T4 윗변 = T2 아랫변 + 아래·위 바깥 여백, host 글줄 = T4 아랫변 + 아래 바깥 여백
• 쪽수 4

	결과
수정 전 (#8157 만)	FAIL K2 T4 윗변 − T3 윗변: 실제 207.6, 기대 120.0
수정 후	PASS
#7687 검사 2건	전후 PASS

영향 범위

samples 전수 1,318 문서와 별도 10k 코퍼스 9,991 문서의 전쪽 SVG 를 수정 전(#8157 만)·후로 해시 비교했다. 바뀐 문서 0, 오류 0. 이 형상(글 host + 앞 공동 앵커 표 + 양수 오프셋 표 + 저장 줄)은 새 HWP 표본에서만 나타난다. 저장 줄 없는 issue7687/titled-host.hwpx 와 한글문서파일형식은 바이트 단위로 같다.

게이트 (head 5b5e42912, base f7abae4a8)

• Rust lint 묶음: fmt check, clippy native, clippy wasm32, workspace build, clippy all-targets, suite manifest --check --base-ref f7abae4a8 — 통과, error 0
• rust-unit-test-tiers --check: 통과
• nextest(release-test) 11,473 / 11,474 통과. 실패 1건 issue_6520_svg_layer_contract::subset_font_bytes_are_deterministic_for_multiple_codepoints 는 검증 환경 글꼴 때문이며 base 에서도 같다(fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 과 동일).
• fresh WASM: scripts/wasm-pack-locked.sh --target web 로 빌드한 패키지로 Sweep 했다.

남은 것 / 비범위

• [renderer/layout] 빈 host 문단의 다중 자리차지 표: host 줄·빈 문단이 표 사이 틈을 채우고 띠에 걸리는 줄만 띠 아래로 가야 한다 (한글문서파일형식 19쪽 −17.4px) #7687 의 빈 공동 앵커 host 띠 바깥 여백은 fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 범위다.
• 저장 줄 없는 HWPX 재조판 경로는 바꾸지 않았다(이미 정본 위치).
• 반례 「앞 표 없는 단일 양수 오프셋 표」 전용 합성 표본은 만들지 않았다. 해당 문서는 분기 조건상 경로가 바뀌지 않으며, 위 전수 SVG 비교에서 변화가 없음을 확인했다.

🤖 Generated with Claude Code

최신 devel rebase (2026-10-23, #8173 절차)

• 기준 upstream/devel def947c21 로 충돌 없이 rebase(fix(typeset): 빈 공동 앵커 host 자리차지 표의 띠·흐름에 바깥 여백을 거듭 더하지 않는다 (#7687) #8157 의 코드 커밋을 그대로 아래에 둔 적층 유지). head c5d49433d (이전 19626cce2). 위 SHA 고정 URL 은 새 head 로 갱신했다(같은 파일).
• 로컬 검증(head c5d49433d, 빌드 전 소스 touch): fmt · Clippy 3종 · workspace build · manifest --check · unit tier 통과, nextest 11,478건 중 11,477 통과(실패 1건 issue_6520_svg_layer_contract::subset_font_bytes_are_deterministic_for_multiple_codepoints 는 이 host 의 시스템 한컴 글꼴 탓으로 base 에서도 같은 assertion 실패, 무관).
• Visual Sweep(2px 실루엣 raw, --compat 2022, base = devel def947c21 + 무관 커밋, 바이너리·WASM sha256 확인):

입력	쪽수 rhwp/한/글	base Native / WASM 최저	head Native / WASM 최저	0.1%p 넘게 내린 쪽
samples/issue8156/titled-host-hancom2020-saved.hwp	4/4	53.07 / 52.33 (1–4쪽 미달)	100.00 / 100.00	없음
samples/issue7687/titled-host.hwpx	4/4	76.86 / 72.87 (1–3쪽 미달)	95.09 / 94.84	없음

[jangster77]

기여해 주셔서 감사합니다. 이 PR의 기능을 검토·체리픽 통합하여 PR #8228로 devel에 반영했습니다.

• 확인한 원 contributor head: c5d49433d00bb46f2b88f30de257637c0b6d8c40. 원 source branch의 후속 변경 없이 같은 head임을 다시 확인했습니다.
• 통합 merge: 3e02fe2749866a8453af3eb3901b9c1a674cccaf; 개별 PR 검토 기록은 문서 PR #8231에 확정했습니다.
• 최종 head b1e93d8de2d4842f725415aee19bd5b98ecfb8b3의 Full CI·CodeQL·Render Diff·Proptest·Adapter·Gym 계약은 모두 성공했습니다.
• 로컬 runtime source 673c1d5f7cdcb5573b793ba2d2abaaedd2602134에서 전체 nextest11,481 PASS/0 FAIL/45 skip, 별도 CI A/B/C/D 합계11,288 PASS/0 FAIL/45 skip입니다. 로컬과 CI 실행 수를 구분합니다.
• 공통 전쪽 검증은 Native/fresh WASM 각각35조건·2,041쪽, 최저91.87422%/91.82753%, 90% 미만·누락·동일 조건 base 대비0.1%p 이상 하락0쪽입니다. 해당 원 PR에 대응하는 입력과 직접 판독은 아래 및 개별 기록으로 구분했습니다.

원 기여에서는 양수 오프셋 자리차지 표의 원점을 밀린 저장 줄이 아닌 문단 소유 정보로 결정합니다.

원 기여와 통합 보정

#8157과 같은 4d06f563a6ba38c3d77cd8cbb81c02b9913f4c19는 중복 제외하고 고유 2개 기능 commit을 적용했습니다.

원 기여 기능과 메인터너의 통합 보정 범위는 위 개별 검토 문서의 적용 commit·소비 경로·실제 회귀 결과에 구분했습니다. 다른 PR의 문서나 제외한 sample16·편람을 이 PR의 개선 증거로 대신하지 않았습니다.

해당 원 PR의 전쪽 비교

조건	Native 쪽수·최저 / TSV	fresh WASM 쪽수·최저 / TSV
saved-host	4쪽 / 100.00000%	4쪽 / 100.00000%

전체 페이지 90% 미만·누락 0쪽입니다. 같은 조건의 고정 base 대비 0.1%p 이상 하락은 0쪽이며, 쪽수 개선은 본문 소유·순서 보존을 따로 확인했습니다. 실제 입력·PDF SHA-256과 증적 바이트.

이 원 PR에 대응하는 정식 회귀 1건의 실제 PASS는 개별 검토 기록에 기재했습니다.

직접 확인한 증적

직접 판독: K1에서 앞 빈 host의 띠와 T4를, K4에서 앞 빈 host가 없는 T3/T4 상대 오프셋과 host/뒤 글줄을 확인했습니다.

Visual Sweep 비교·병합 판정 방법과 공통 producer·해시·잔여 원장을 연결합니다. 일치율은 내용 픽셀 중심 자동 비교 보조값이며 사람 판독의 정확도나 완전한 픽셀 동일성을 뜻하지 않습니다.

이 원 PR은 별도 직접 merge가 아니라 통합 PR에 반영했으므로 종료하겠습니다. contributor의 원격 브랜치는 유지합니다. 관련 이슈 전체의 완료 여부는 개별 증거 범위로 별도 판단하며 이 PR 종료만으로 일괄 종료하지 않습니다.