Summary

• HWP5 binary 의 `PARA_LINE_SEG` + sparse `PARA_TEXT` 조합으로 인한 composer 의 line-to-control 매핑 어긋남 보정
• `samples/hwp3-sample16-hwp5.hwp` 페이지 18 의 다이어그램 + 라벨 z-order 정합 (가. 위, 다이어그램, 나. 아래)
• closes HWP3→HWP5/HWPX 변환 시 표/그림 anchor 타입 변경으로 다이어그램 overflow + 라벨 z-order 어긋남 (sample16 p18) #991

Root cause (KS X 6101 표 6 분석)

확장 컨트롤 (ch=1-3, 11-12, 14-18, 21-23) 은 stream 에 8 wchar 차지, visual 로 1 char position (placeholder).

→ HWP5 가 sparse text + char_offsets 으로 composer 가 line 별 text 범위 계산 시 어긋남.

pi=394 (HWP5 sample16) 예

```
3 TAC controls + 3 line_segs:
ls[0] ts=0 contains 가. 라벨
ls[1] ts=8 contains 다이어그램
ls[2] ts=18 contains 나. 라벨

HWP5 IR (sparse):
text=" " (2 chars), char_offsets=[16, 17]
composer.utf16_range_to_text_range(0, 8): text [0..0) — 빈!
→ ls[0] 빈 라인 처리 → 가. 라벨 어긋남
```

Fix (F2-narrow)

src/renderer/composer.rs 의 `compose_paragraph` 진입 시 marker synthesis layer 추가:

```rust
fn synthesize_marker_paragraph(para: &Paragraph) -> Option {
// inline-visible extended ctrl count
let inline_ctrl_count = ...; // Header/Footer/Footnote/Endnote/HiddenComment 제외

let existing_markers = para.text.chars().filter(|c| *c == '\\u{FFFC}').count();
if existing_markers >= inline_ctrl_count { return None; }  // HWP3 path

// [Task #991 좁힘] pi=394 패턴만 catch
let n_leading = (para.char_offsets.first().copied().unwrap_or(0) as usize) / 8;
if n_leading < 2 || inline_ctrl_count < 3 { return None; }

// char_offsets gap (8 wchar) 분석으로 \\u{FFFC} 마커 합성

}

pub fn compose_paragraph(para: &Paragraph) -> ComposedParagraph {
let synth = synthesize_marker_paragraph(para);
let para = synth.as_ref().unwrap_or(para); // shadow
// ... 기존 logic ...
}
```

좁힘 조건

• `inline_ctrl_count >= 3` (pi=394 = 3 TAC pattern)
• `n_leading >= 2` (leading char_offsets gap 에 2+ extended ctrl)
• `existing_markers >= inline_ctrl_count` (HWP3 자동 차단)

Verification

• ✅ cargo test --release --lib: 1297 passed, 0 failed
• ✅ cargo fmt --check: 통과
• ✅ 240 sample 페이지 수 회귀: 0 건
• ✅ HWP5 sample16 page 18 시각: PDF 정합 (가. 위, 다이어그램, 나. 아래)
• ✅ Editor pipeline (parser 미변경): 영향 없음

시도 비교

Residual / 후속

• HWPX 변종 (`hwp3-sample16-hwp5.hwpx`) 은 parser path 다름 — 본 fix 미적용. HWPX (sample16-hwp5) 잔존 회귀 3종 — 페이지수 / z-order / 박스 본문 누락 #942/HWPX +7 페이지 잔존 drift — typeset page break / table path / wrap_around 영역 (#969 v2) #988 close 영역.
• HWP5 sample16 page 22 의 paragraph overlap 은 별도 root cause (line_segs 누락) — #994 분리.

Test plan

• cargo test --release 통과 확인
• cargo fmt --check 통과 확인
• samples/hwp3-sample16-hwp5.hwp page 18 시각 정합 확인 (가. 위, 다이어그램, 나. 아래)
• 240 sample 페이지 수 변동 0 확인
• Editor 기능 (insert_text/save/cursor) 동작 확인

🤖 Generated with Claude Code