fix: Layout 리팩터링 Phase 2 line_break_char_idx 다중화 누락 회귀 정정 (Task #518 재적용, closes #648)

[planet6897]

개요

이슈 #648 정정. Task #518 (Layout 리팩터링 Phase 2 — line_break_char_idx: Option<usize> → line_break_char_indices: Vec<usize> 다중화) 의 원 commit b395e8e6 를 cherry-pick 재적용. 이슈 #496 본질 (B) ls[2..] break 미사용 결함 해결.

⚠️ 의존성 — 본 PR 은 PR #649 (Task #517) 선행 머지 필요

본 PR 의 LAYOUT_BREAK_INDICES 디버그 로깅은 PR #649 가 도입한 layout_debug_enabled() 헬퍼에 의존합니다. 따라서 PR #649 선행 머지 → 본 PR 자동 1 commit 축약 → 머지 순으로 진행 권장.

현재 본 PR 은 head=pr-task648 (= pr-task647 + Task #518 commit) 으로 구성되어 있어 GitHub 상에는 2 commit 으로 표시됩니다. PR #649 머지 후에는 본 PR diff 가 b395e8e6 단일 commit 으로 자동 축약됩니다.

회귀 메커니즘

이슈 #618 (Task #519) → PR #620, 이슈 #647 (Task #517) → PR #649 와 동일 패턴: 묶음 머지 a7e43f9 (Task #517/#518/#519/#520/#521/#523/#528) 가 local/devel 에는 머지되었으나 stream/devel 으로 승격되지 않음.

$ git merge-base --is-ancestor b395e8e6 stream/devel
NOT in stream/devel

$ git grep -n "line_break_char_idx" stream/devel -- src/
stream/devel:src/renderer/layout/paragraph_layout.rs:265: let line_break_char_idx: Option<usize> = ...
stream/devel:src/renderer/layout/paragraph_layout.rs:398: if let Some(break_idx) = line_break_char_idx {

→ Task #518 이전 단일 break 시그니처 그대로.

변경 내역

원 commit b395e8e6 를 git cherry-pick -x 로 그대로 적용 (충돌 없음).

핵심 변경 (src/renderer/layout/paragraph_layout.rs -40/+77):

항목	회귀 (이전)	정정
변수	line_break_char_idx: Option<usize>	line_break_char_indices: Vec<usize>
사용 범위	ls[1] 만	ls[1..] 모두
알고리즘	ctrl_gap 합산 (controls 많은 paragraph 에서 over-subtract → saturating 0 → 항상 None)	char_offsets[i] >= ts 인 첫 i 직접 룩업
wrap 결정	단일 break_idx 검사	next_break 추적 + 다중 break 검사
디버그	—	LAYOUT_BREAK_INDICES 로깅 추가

검증

$ cargo build
Finished `dev` profile

$ cargo test --release --lib
test result: ok. 1141 passed; 0 failed; 2 ignored; 0 measured; 0 filtered out

회귀 케이스 (원 commit 보고 인용): exam_science p2 pi=61 본문 1줄 column 폭 초과 → 3줄 정상 wrap (ls[1] break char 5 + ls[2] break char 28). 7 샘플 170 페이지 중 same=167 / diff=3 (exam_science 정확도 정정).

참고

• 원 이슈: Layout 리팩터링 Phase 2: line_break_char_idx 다중화 (ls[2..] break 사용) #518 (CLOSED)
• 회귀 이슈: Layout 리팩터링 Phase 2 line_break_char_idx 다중화 누락 회귀 — Task #518 정정이 devel 에 미머지 #648
• 본질 이슈: exam_science.hwp 2페이지 12번 본문 줄간격 압축 (인라인 수식 다수) #496 (B)
• 원 fix 커밋: b395e8e6
• 묶음 머지: a7e43f9 (Merge local/devel: Task Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517/Layout 리팩터링 Phase 2: line_break_char_idx 다중화 (ls[2..] break 사용) #518/그림(Picture) 회전·뒤집기(flip) 속성이 SVG 렌더링에 적용되지 않음 #519/exam_science.hwp 문제7: inline 도형(tac=true, wrap=TopAndBottom)이 다음 문단 라인에 그려져 텍스트와 겹침 #520/exam_eng p2 18번 답안지 위치가 박스 하단에 너무 가까움 — 그림(BehindText) 의 vertical extent 가 paragraph height 에 미반영 #521/exam_science 페이지 1 → 2 누적 vpos drift: 문제 6번 <보기>/답안이 다음 페이지로 밀림 #523/옛한글 PUA → KS X 1026-1:2007 자모 변환 (HncPUAConverter 정합) — exam_kor 17p 고어 미렌더 #528)
• 동일 패턴 선행 사례: PR fix: Picture flip/rotation 누락 회귀 정정 (Task #519 재적용, closes #618) #620 (Task 그림(Picture) 회전·뒤집기(flip) 속성이 SVG 렌더링에 적용되지 않음 #519), PR fix: Layout 리팩터링 Phase 1 디버그 인프라 누락 회귀 정정 (Task #517 재적용, closes #647) #649 (Task Layout 리팩터링 Phase 1: 디버그 인프라 + 회귀 검증 도구 #517 — 의존)