Summary

planet6897 사이클 누적 PR. 최근 작업 영역:

exam_kor 18p Square wrap 표 + TAC 그림 위치 결함 (#534) — 신규 추가

samples/exam_kor.hwp 18 페이지 우측 단 [A]/[B] 표시기 옆 인라인 그림이 단 영역을 30-70% 침범하는 결함 정정.

• 본질: layout_shape_item 의 TAC Picture x 계산이 paragraph_layout 의 inner_pad 로직 (visible stroke + border_spacing[0,1]=0 케이스) 과 비정합. wrap_host paragraph (Square wrap 표 보유) 는 paragraph_layout 미호출되어 layout_shape_item 만 emit → inner_pad (= box_margin_left) 누락된 위치 (~11.33 px 좌측 시프트)
• 정정: src/renderer/layout.rs::layout_shape_item TAC Picture 분기에 has_visible_stroke + border_spacing 검사 + inner_pad_left 가산 (+19 라인)
• Stage 1 추가 조사 (eprintln 임시 로깅) 으로 emit code path 식별 후 본질 확정 — 단일 root cause 정합 fix

검증: exam_kor p18 pi=50/56 image x: 593.39 → 604.72 (+11.33 px), p19 pi=60: 128.51 → 139.84. 광범위 8 샘플 192 페이지 중 190 byte-identical, 변경 2 페이지 모두 동일 본질 의도된 정정.

exam_kor 14p Square wrap 표 직후 baseline 누락 (#533)

samples/exam_kor.hwp 14 페이지 우측 단 줄간격 일관성 결함 정정.

• 본질: 비-TAC Square wrap 인라인 표 직후 y_offset 이 표 bottom 으로만 advance — 호스트 문단 텍스트가 표보다 길게 늘어진 케이스에서 다음 문단이 baseline (~13 px ≈ 978 HU) 만큼 위로 시프트
• 정정: src/renderer/layout.rs::layout_table_item 의 비-TAC Square wrap 분기에 호스트 마지막 LINE_SEG 영역 max() 가산 (+18 라인). vpos 가 column 누적 좌표이므로 first.vertical_pos 차감 패턴 필수
• 회귀 차단: !is_tac + wrap=Square + max() 3중 가드

검증: 광범위 8 샘플 192 페이지 중 190 byte-identical, 변경 2 페이지 (p14 + p17) 모두 동일 본질 의도된 정정.

옛한글 PUA → KS X 1026-1:2007 자모 변환 (#528, #512 흡수)

samples/exam_kor.hwp p17 의 중세국어 표기 미렌더 결함 해결.

• 본질: HanCom Hanyang-PUA 인코딩 (BMP PUA U+E0BC-F8F7) — 한/글 2010 이전 옛한글
• 자료원: KTUG HanyangPuaTableProject (Public Domain, 5,660 매핑, 함초롬바탕 정합)
• 변환 적용: src/renderer/pua_oldhangul.rs (자동 생성) + Composer display_text 인프라 + svg/web_canvas draw_text 시점 변환 (Option A — 인덱싱 불변성 유지)
• 폰트 fallback: Source Han Serif K Old Hangul subset (Adobe + Google, SIL OFL 1.1, 234 KB woff2, 357/368 cmap, ccmp/ljmo/vjmo/tjmo 4/4 보존)
• CSS unicode-range 격리: 일반 한글 (U+AC00-D7AF) 미영향
• 한컴 책괄호 + 예시 마커: U+F0854/F0855 → 《 》, U+F00DA → ▸ (잠정)
• PUA 옛한글 영역 KS X 1026-1:2007 자모 변환 영역 (HncPUAConverter 정합) #512 흡수 완료

검증 (exam_kor p17): PUA 잔존 112 → 0 (100%), Hangul Jamo 0 → 102, 책괄호 0 → 66.

Layout 리팩터링 Phase 0~2

• Phase 0 — 분석 + 로드맵 (mydocs/tech/layout_refactor_roadmap.md)
• Phase 1 (Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517) — 디버그 인프라 (RHWP_LAYOUT_DEBUG=1) + 회귀 검증 도구 (scripts/svg_regression_diff.sh)
• Phase 2 (Layout 리팩터링 Phase 2: line_break_char_idx 다중화 (ls[2..] break 사용) #518) — line_break_char_idx 다중화 (Option → Vec) — exam_science.hwp 2페이지 12번 본문 줄간격 압축 (인라인 수식 다수) #496 본질 (B) 해결

planet6897 작성 issue 6건 처리

• exam_kor 16p 우측 "홀수형" 뱃지 누락 (master 외 별도 요소) #465 재현 불가 / close
• 확장 바탕쪽: 다른 apply_to 조합 (active=Odd + ext=Both 등) 동작 미검증 #467 보류 / close (확장 바탕쪽 다른 apply_to)
• 페이지 12 layout drift — 누적 trailing line_spacing으로 23번 paragraph가 한컴 PDF 대비 ~200px 하향 #479 해결 / close (페이지 12 layout drift)
• samples/exam_science.hwp 페이지 1 2번 답안지 위치 약간 아래로 밀림 #491 보류 / close (PDF 좌표 정규화 선결)
• exam_science.hwp 2페이지 12번 본문 줄간격 압축 (인라인 수식 다수) #496 Phase 2 로 본질 (B) 해결 / close
• exam_science 페이지 2 박스 안 사각형이 multi-line paragraph 의 잘못된 줄 위치에 그려짐 #500 완료 (신규 fix) / close — 셀 인라인 Shape ls[1]+ 위치 정합

회귀 정정 / 외부 PR 처리

• exam_kor 15p 우측 단 본문 overflow (pi=103-105 col 1 경계 LINE_SEG vpos-reset 미인식) #464 / compute_square_wrap_tbl_x_right horz_rel_to=Paper/Page 케이스 보강 #466 / exam_kor 6p 좌측 단 [18~21] passage 박스 하단 줄 — cross-column 박스 연속 미감지 #468/469 / 21_언어_기출 1p 좌측 단 pi=10 cross-column vpos-reset 미인식 (cv != 0) #470/471 layout 회귀 정정
• 그림 crop 변환의 scale 기준 오류 — original_size_hu(표시 HU) 가 96-DPI native HU 와 일치하지 않을 때 viewBox 과대 #473 그림 crop scale 75 HU/px 룰 fallback
• draw_text 의 PUA 강제 변환 회귀 — 일반 텍스트의 원문자/특수문자 영역 결함 (PR #251 origin) #509 PUA 글머리표 글리프 회귀 정정
• 그림(Picture) 회전·뒤집기(flip) 속성이 SVG 렌더링에 적용되지 않음 #519 그림 flip/rotation SVG 적용
• exam_science.hwp 문제7: inline 도형(tac=true, wrap=TopAndBottom)이 다음 문단 라인에 그려져 텍스트와 겹침 #520 인라인 TAC y 이중 합산 정정
• 복학원서.hwp s0:pi=0 의 BehindText 그림 컨트롤 출력 누락 #514 복학원서.hwp PCX 학교 로고 → PNG 변환 (RGBA 투명)
• exam_kor.hwp 14p 우측 단 — Square wrap 표 다음 문단 baseline 누락 (~13px 시프트) #533 Square wrap 호스트 다음 문단 baseline 누락
• exam_kor.hwp 18p 우측 단 — Square wrap 인라인 표 + TAC 그림 동일 paragraph 의 그림 x 좌표 우측 과다 시프트 #534 Square wrap 표 + TAC 그림 동일 paragraph 의 그림 inner_pad 누락

변경 통계

주요 신규 영역:

• exam_kor.hwp 18p 우측 단 — Square wrap 인라인 표 + TAC 그림 동일 paragraph 의 그림 x 좌표 우측 과다 시프트 #534: src/renderer/layout.rs::layout_shape_item (+19 라인, TAC Picture inner_pad 정합)
• exam_kor.hwp 14p 우측 단 — Square wrap 표 다음 문단 baseline 누락 (~13px 시프트) #533: src/renderer/layout.rs::layout_table_item (+18 라인, host 텍스트 영역 max advance)
• 옛한글 PUA → KS X 1026-1:2007 자모 변환 (HncPUAConverter 정합) — exam_kor 17p 고어 미렌더 #528 (PUA 옛한글 영역 KS X 1026-1:2007 자모 변환 영역 (HncPUAConverter 정합) #512 흡수):
  • src/renderer/pua_oldhangul.rs (자동 생성, 5,773 라인)
  • src/renderer/composer.rs (display_text 필드 + convert_pua_old_hangul)
  • src/renderer/svg.rs / web_canvas.rs (draw_text PUA 변환 적용)
  • src/renderer/mod.rs::generic_fallback (font-family 체인 보강)
  • src/renderer/layout/paragraph_layout.rs::map_pua_bullet_char (책괄호 + 예시 마커)
  • web/fonts/SourceHanSerifK-OldHangul-subset.woff2 + SourceHanSerifK-OFL.txt
  • rhwp-studio/src/core/font-loader.ts (FontEntry.unicodeRange + 신규 엔트리)
  • scripts/gen_pua_oldhangul_rs.py (재생성 스크립트)

Test plan

• cargo test --lib 1116 passed
• cargo test --test svg_snapshot 6/6 통과
• cargo test --test issue_418 1/1 통과
• cargo test --test issue_501 1/1 통과
• 작업지시자 시각 판정 ★ (exam_kor p17 옛한글 / p14 줄간격 / p18 그림 위치)
• 8 샘플 192 페이지 광범위 회귀 검증 (scripts/svg_regression_diff.sh) — 회귀 0 (Tasks exam_kor.hwp 14p 우측 단 — Square wrap 표 다음 문단 baseline 누락 (~13px 시프트) #533/exam_kor.hwp 18p 우측 단 — Square wrap 인라인 표 + TAC 그림 동일 paragraph 의 그림 x 좌표 우측 과다 시프트 #534)
• 메인테이너 시각 판정 (한컴 2010 / 2020 정답지 비교)
• cherry-pick 영역별 분리 검토 권장

참고

• 본 PR 은 누적 commits 라 전체 머지보다 Task 단위 cherry-pick 이 적합할 수 있음
• Tasks exam_kor.hwp 14p 우측 단 — Square wrap 표 다음 문단 baseline 누락 (~13px 시프트) #533 / exam_kor.hwp 18p 우측 단 — Square wrap 인라인 표 + TAC 그림 동일 paragraph 의 그림 x 좌표 우측 과다 시프트 #534 는 자체로 완결된 영역 — src/renderer/layout.rs 만 변경, 단독 cherry-pick 가능
• Task 옛한글 PUA → KS X 1026-1:2007 자모 변환 (HncPUAConverter 정합) — exam_kor 17p 고어 미렌더 #528 (옛한글 PUA) 도 자체로 완결된 영역 — 단독 cherry-pick 가능
• 메모리 정합 (feedback_pdf_not_authoritative / feedback_essential_fix_regression_risk / feedback_rule_not_heuristic)
• 보고서: mydocs/report/task_m100_534_report.md + task_m100_533_report.md + task_m100_528_report.md + Stage 보고서들

닫히는 이슈

• closes exam_kor.hwp 18p 우측 단 — Square wrap 인라인 표 + TAC 그림 동일 paragraph 의 그림 x 좌표 우측 과다 시프트 #534 (Square wrap 표 + TAC 그림 inner_pad)
• closes exam_kor.hwp 14p 우측 단 — Square wrap 표 다음 문단 baseline 누락 (~13px 시프트) #533 (Square wrap host baseline 누락)
• closes 옛한글 PUA → KS X 1026-1:2007 자모 변환 (HncPUAConverter 정합) — exam_kor 17p 고어 미렌더 #528 (옛한글 PUA 변환)
• closes PUA 옛한글 영역 KS X 1026-1:2007 자모 변환 영역 (HncPUAConverter 정합) #512 (옛한글 PUA → KS X 1026-1:2007 자모 변환 (HncPUAConverter 정합) — exam_kor 17p 고어 미렌더 #528 흡수)
• closes Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517 (Layout Phase 1)
• closes Layout 리팩터링 Phase 2: line_break_char_idx 다중화 (ls[2..] break 사용) #518 (Layout Phase 2)