이슈

closes #977 — Skia replay 경로에서 일부 목차 개요번호가 910 px 우측 밀려 정렬 어긋남.

본질

WASM WasmTextMeasurer 의 미등록 폰트 폭 폴백이 두 함수 에 분기되어 있는데, 한쪽만 native heuristic 으로 통일하면 잔존:

• measure_char_width_hwp — 일반 문자 (라틴, 구두점 등)
• measure_hangul_width_hwp — 한글 '가' 대리 측정

종전 두 경로 모두 미등록 폰트에 cached_js_measure (JS Canvas measureText) 사용 → 브라우저 fallback 폰트로 측정 → 폰트별로 폭 변동.

한컴은 LEFT tab + tab_extended[0] 에 "tab_pos − 한컴_선행텍스트폭" 으로 행별 tab 폭을 미리 계산해 저장. 우리 한글 폭이 한컴 metric 과 다르면, 같은 ext[0] 더해도 디지트 x 좌표가 행별 한글 개수 차이 × 폭차 만큼 누적 어긋남.

수정

두 폴백 모두 native EmbeddedTextMeasurer 와 동일 휴리스틱으로 통일:

• CJK / fullwidth: font_size (1.0 em)
• 좁은 구두점: font_size * 0.3 (PR fix(text_measurement): 좁은 구두점 (U+2018/U+2019/U+2027) 폭 분류 + native/WASM 동기화 #1026 narrow_punct 분기 보존)
• 일반 문자: font_size * 0.5
• 한글 음절: font_size (1.0 em, 미등록 폰트 시)

JS Canvas 폴백은 폰트별 브라우저 fallback 으로 폭이 변동되어 본질적으로 한컴 metric 과 합치 불가능 → 제거.

영향

• 등록 폰트 (맑은 고딕, HCR Batang 등): measure_char_width_embedded 가 Some 반환 → 본 분기 미진입, 무회귀.
• 미등록 폰트 (나눔바른고딕 등): native 와 동일 폭 산출 → SVG 와 WASM 일관 정렬.

검증

• issue_874_ktx_toc_page_number_right_align (PR fix(text_measurement): 좁은 구두점 (U+2018/U+2019/U+2027) 폭 분류 + native/WASM 동기화 #1026 회귀 가드): 1/1 PASS
• svg_snapshot (golden SVG 8 종): 8/8 PASS (form_002, issue_147/157/267/617/677, table_text, determinism)
• cargo check --lib --target wasm32-unknown-unknown: OK
• Docker WASM 빌드 성공
• 작업지시자 시각 재현 확인 (TOC 페이지 디지트 정렬)

이력

• 1차 시도 PR Task #977: 목차 개요번호 WASM 정렬 어긋남 정정 — 문자 폭 폴백 공용화 #980 (자진 close), 2차 PR Task #977: 목차 개요번호 WASM 정렬 어긋남 정정 — 문자 폭 폴백 공용화 #1045 (메인테이너 close — "PR fix(text_measurement): 좁은 구두점 (U+2018/U+2019/U+2027) 폭 분류 + native/WASM 동기화 #1026 본질 흡수" 판단).
• 본 v3 는 PR fix(text_measurement): 좁은 구두점 (U+2018/U+2019/U+2027) 폭 분류 + native/WASM 동기화 #1026 (5/21 머지, narrow_punct 분기) 흡수 후 잔존 본질 (한글 폭 폴백) 을 처리.

변경 파일

• src/renderer/layout/text_measurement.rs — 핵심 수정 (2 폴백 통일).
• mydocs/plans/task_m100_977_v3.md
• mydocs/working/task_m100_977_v3_stage{1,2,3}.md
• mydocs/report/task_m100_977_v3_report.md

🤖 Generated with Claude Code