Task #476 + #479 + #480 + #483 + #488 + #489 + #490 + #492: layout 정합 + 수식 정정 합본

.gitignore

@@ -78,3 +78,6 @@ rhwp-chrome/dist/
 rhwp-safari/dist/
 rhwp-safari/HWP Viewer/
 rhwp-safari/.DS_Store
+
+# 골든 SVG 비교 시 생성되는 임시 actual 파일
+tests/golden_svg/**/*.actual.svg

mydocs/orders/20260429.md

@@ -1,5 +1,14 @@
 # 오늘 할일 - 2026년 4월 29일
 
+## M100 — v1.0.0 조판 엔진
+
+| Issue | 타스크 | 상태 | 비고 |
+|------|--------|------|------|
+| #435 | exam_kor.hwp 24페이지 → 20페이지 정합 (한컴 PDF 호환) | **부분 완료 (24→22)** | `typeset.rs::compute_body_wide_top_reserve_for_para` 의 `VertRelTo::Paper` 분기 정정 (Paper-rel `vertical_offset` 을 body-rel 변환 안 하던 버그). 효과: page 1 단 1 +54.5px overflow / page 14 단 1 +106.2px overflow 해소 → pi=0.30, pi=1.25 split 차단 → page 2, 15 orphan 페이지 사라짐. 회귀: exam_eng 8 / k-water-rfp 28 / hwpspec 177 / synam-001 35 페이지 유지, cargo test 1062 passed. **잔여 22→20 미달성**: 섹션 1 페이지 14 (Square wrap 표 col 0 over-fill + col 1 under-use), 섹션 1 페이지 15 (단정의 2단인데 단 1 누락), 섹션 2 페이지 18 (pi=11 split orphan-like) 의 3 가지 별도 메커니즘. Stage 3 조사로 원래 가설 (누적 -100~-300px) 은 메트릭 차이일 뿐임 확인. 잔여 작업은 별도 task 로 분리 (옵션 A 종료) |
+| #439 | Square wrap 표 직후 col 0 over-fill (exam_kor 페이지 14 단 0 1225>1211) | **완료 (22→20)** | `typeset.rs::place_table_with_text` 에서 Square wrap (어울림) 표일 때 `current_height` 누적을 `pre_height + table_total` → `max(pre_height, v_off + table_total)` 로 변경. 호스트 텍스트와 어울림 표가 같은 수직 영역을 공유하므로 더 큰 쪽만 한 번 누적. **Stage 1 부수 발견**: 활성 페이지네이션 엔진은 `engine.rs::Paginator` 가 아닌 `typeset.rs::TypesetEngine` (`engine.rs` 는 `RHWP_USE_PAGINATOR=1` 환경변수 fallback). 이슈 가설은 fallback 경로를 지목. 효과: 페이지 14 col 0 used 1225.8→1036.1 px, col 1 items 2→18, exam_kor 22→20 페이지 (목표 21 달성, 추가 -1 단축). 회귀 검증: 149개 sample HWP 중 exam_kor 만 변화, 148개 동일. cargo test 1066 passed. **#435 잔여 작업 (섹션 1 페이지 14 over-fill) 부분 해소** |
+| #393 | 다단 col 1 시작 reserve 과대 산정 (exam_kor 페이지 1 pi=30 split) | **#435 Stage 2 로 수정 적용** | `compute_body_wide_top_reserve_for_para` Paper-rel 분기 정정. page 14 (pi=1.25 split) 동일 메커니즘 회귀 케이스 함께 해소. close 가능 (작업지시자 결정) |
+| #445 | exam_kor 페이지 가운데 세로선 + 페이지 번호 박스 시각 결함 | **완료** | 두 결함 동시 해결. (1) Paragraph border (`border_fill_id`) 가 PartialParagraph 에서 col_bottom 을 초과해 페이지 바깥(p8: y=1671 / 페이지 1587 초과)까지 그려지던 버그 — `layout.rs build_single_column` merge 그룹을 col_area 바닥/꼭대기로 클램프 (Stage 1+2). (2) 꼬리말 paragraph 의 `wrap=TopAndBottom + vert=Para` 표(페이지 번호 박스)가 paragraph top 에 정렬되어 column line 끝과 박스 top 이 만나 "붙어 보이는" 문제 — `layout_header_footer_paragraphs` 에서 표 anchor y 에 `line_height/2` 를 더해 PDF 일치 (Stage 3). 검증: exam_kor p1~20 모든 페이지에서 박스 top y=1439.47 (PDF 380.6mm 일치), column line - 박스 갭 16.3~17.0px (PDF 16px 일치). cargo test 1117 passed. snapshot 1건 갱신 (`tests/golden_svg/issue-267/ktx-toc-page.svg` invisible 구조 rect height 5.34px 변경, 가시 변화 없음) |
+
 ## 버그
 
 | Issue | 타스크 | 상태 | 비고 |

mydocs/orders/20260430.md

@@ -1,5 +1,32 @@
 # 오늘 할일 - 2026년 4월 30일
 
+## M100 — 박스 정합
+
+| Issue | 타스크 | 상태 | 비고 |
+|------|--------|------|------|
+| #468 | exam_kor 6p 좌측 단 [18~21] passage 박스 하단 줄 — cross-column 박스 연속 미감지 | **완료** | `paragraph_layout.rs:2527-2528` 의 partial 플래그가 단일 paragraph 내부 split 만 검출하던 한계를 해소. `para_border_ranges` 튜플에 `para_index` 추가 (9→10 필드). `build_single_column` merge 후 그룹의 첫/마지막 paragraph 의 sequential 인접 bf_id 검사로 partial_start/partial_end 보정. 결과: cross-column / cross-page 박스 연속 시 inner 경계 stroke 미렌더. exam_kor 6p col 0 박스 하단 stroke 미렌더 (PDF 일치) ✓, 6p col 1 박스 양방향 미렌더 ✓, 7p col 0 박스 상단 미렌더 ✓, 14p 단일 박스 정상 (Task #463 회귀 0). cargo test 1069 + svg_snapshot 6 통과, 5종 샘플 회귀 0 |
+| #469 | exam_kor 2p 우측 단 (나) cross-column 박스 좌·우 세로선이 헤더선과 맞닿음 | **완료** | Task #468 후속. `layout.rs:1740` 의 `rect_y = y_start - top_pad` 가 partial_start 박스의 후속 부분을 col_top 위(헤더선)까지 확장. `effective_top_pad/effective_bot_pad` 도입하여 partial_start/partial_end 시 inset 적용 차단. exam_kor p2 우측 단 (나) 박스 세로선 y1: 196.55 → 211.65 ✓. 신규 통합 테스트 1건 추가, cargo test 1121 + svg_snapshot 6 통과, 회귀 0 |
+| #470 | 21_언어_기출 1p 좌측 단 pi=10 cross-column vpos-reset 미인식 (cv != 0) | **완료** | Task #321 cross-paragraph vpos-reset 가드가 `cv == 0` 만 검출 → 컬럼 헤더 오프셋 (cv=9014) 인 다단 케이스 미감지. typeset.rs:415, 439 에 다단/단일 단 분기 도입: 다단은 `cv < pv && pv > 5000`, 단일 단은 기존 `cv == 0` 유지 (issue_418 partial-table split 회귀 차단). 21_언어_기출 OVERFLOW 13→10, exam_science 5→0, exam_social 4→1 (총 -11 건 추가 해소). hwpspec(단일 단) 회귀 0. cargo test 1122 통과 |
+| #471 | Task #468 cross-column 검출이 stroke_sig 머지와 불일치 (#470 후속) | **완료** | Task #468 가 bf_id 동등 비교, 머지(Task #321 v6)는 stroke_sig 기준 → bf_id 다른 paragraph 가 한 그룹이 되면 그룹의 `g.0` 이 첫 range bf_id 만 보존되어 cross-column 인접 검출 실패. 좌측 (가) 박스(pi=6 bf=7 + pi=7~9 bf=4) 가 g.0=7, composed[10].bf=4 비교로 partial_end 미설정 → 4면 stroke rect 로 하단 가로선 발생. layout.rs:1670-1699 를 stroke_sig 비교로 변경. cargo test 1123 통과, OVERFLOW 회귀 0 |
+| #473 | 그림 crop scale 기준 오류 — original_size_hu(표시 HU) 가 native HU 와 일치하지 않을 때 viewBox 과대 | **완료** | HWP crop 은 이미지 native 픽셀을 96-DPI HU 관행 (75 HU/px) 으로 인코딩. `compute_image_crop_src` 가 `original_size_hu`(표시 HU)를 scale 기준으로 사용 → 사용자가 그림 크기 변경 시 (21_언어_기출 12p `<보기>` 그림: orig 12 HU/px) viewBox 가 6.25× 과대. svg.rs:2385-2404 를 75 HU/px fallback 으로 변경 (orig/img_px 가 75 ± 5% 일 때만 orig 사용). 7종 샘플 415 페이지 / 32 nested SVG / 0 viewBox 과대 회귀. cargo test 1078 통과 |
+
+## 잔존 이슈 (별도 task)
+
+| Issue | 타스크 | 상태 | 비고 |
+|------|--------|------|------|
+| #464 | exam_kor 15p 우측 단 본문 overflow — pi=103-105 col 1 LINE_SEG vpos-reset 미인식 | 대기 | 수행계획서 작성 완료 (`mydocs/plans/task_m100_464.md`). `current_column == 0` 가드가 마지막 단의 vpos-reset 를 무시. 별도 작업 |
+| #465 | exam_kor 16p PDF 우측 "홀수형" 뱃지 별도 요소 (master 외) | 대기 | 별도 조사 필요 |
+| #466 | compute_square_wrap_tbl_x_right Paper/Page case 미구현 | 대기 | Task #463 Stage 5 후속 |
+| #467 | extension master 다른 apply_to 처리 | 대기 | Task #463 Stage 8 후속 |
+| #488 | 수식 토크나이저 rm/it/bold prefix 분리 + 렌더러 italic honor | **완료** | hwpeq 폰트 스타일 키워드(`rmK`/`rmCa`/`rmmol`/`itl`/`itaq`)가 식별자 prefix 로 합쳐져 토크나이저가 분리 못함 + svg/canvas 렌더러 Text arm 이 italic 파라미터를 무시. tokenizer.rs read_command 에 FONT_STYLES prefix 분리, svg_render/canvas_render Text arm 이 italic 파라미터 honor + 진입점 default italic=true. 단위 테스트 14건 추가 (tokenizer 8 + svg_render 6), 라이브러리 1092 통과. 8개 샘플 59페이지 raw prefix 0건. 시각 검증 중 발견된 4건 별도 이슈 분리: #489 그림 wrap, #490 셀 정렬, #491 답안지 위치, #492 컬럼 짤림 |
+| #489 | exam_science 페이지 1 5번 그림이 본문 첫 줄을 가림 | **완료** | Picture+Square wrap (어울림) 호스트 paragraph 텍스트가 LINE_SEG.segment_width 무시하고 풀컬럼 너비로 justify → 그림 영역 침범 + 비정상 단어 간격. `layout/paragraph_layout.rs:layout_composed_paragraph` 에 비-TAC Picture/Shape Square wrap 감지 + LINE_SEG cs/sw 를 effective_col_x/effective_col_w 로 적용 (200 HU 노이즈 가드). 표 Square wrap (#362/#439/#463) 은 caller 가 col_area 자체를 좁혀 호출 → 조건 미발동(회귀 0). exam_science p1 pi=21 (5번) 정정 + p2 pi=37 (8번) 동일 패턴 자동 정정. 단위 테스트 1 추가, cargo test 1093 + svg_snapshot 6 + issue_418 1 통과. 9 종 샘플 263 페이지 byte 비교 = 261 동일 / 2 정정. 보조: `main.rs` dump 에 horz_align/vert_align 표시 |
+| #490 | exam_science 페이지 1 3번 표 28/36 셀 중앙정렬 | **완료** | `paragraph_layout.rs:2227` 의 빈 runs + TAC 수식 분기 (Task #287 도입) 가 paragraph alignment 적용 누락 → text_len=0 + ctrls=1+ 셀의 수식이 좌측 고정. align_offset 계산 + inline_x 에 적용. exam_science p1 셀 7/11 의 28/36 수식 x=358.7 → 415.5 중앙 정렬. 단위 테스트 1 추가, cargo test 1094 통과. 9 종 샘플 263 페이지 byte 비교 = 257 동일 / 6 정정 (전 페이지 59 수식 모두 우측 이동, 회귀 0) |
+| #491 | exam_science 페이지 1 2번 답안지 위치 약간 아래로 | **보류 (구체 재현 정보 필요)** | HWP IR 분석: pi=9 (3x5 표) vpos=47860 → y=787.4px 정상 (HWP 인코딩 위치와 일치). PDF (A4 595×841pts) 와 SVG (272×394mm 1028×1488px) 가 다른 페이지 크기를 사용해 직접 좌표 비교 불가. "약간 아래로" 미세 차이 추정으로 본 사이클에서 명확한 재현 어려움. #489/#490 정정 후 시각 변화로 자연 해소 가능성 있음. 추후 구체적 픽셀/mm 단위 측정 또는 PDF 좌표 정규화 변환 후 재평가 필요 |
+| #492 | exam_science 페이지 1 컬럼 2 5번 밑단 짤림 | **완료(자연해소)** | #489 정정으로 자연 해소. 시각 검증: 페이지 1 단 1 의 5번 본문(y=567~687, 6 줄), 5번 <보기> ㄱ/ㄴ/ㄷ(y=788~854), 5번 선택지(y=906), 6번 문제 (y=969~1312) 모두 정상. 7번부터 페이지 2 시작. col 1 used=1108.9px / body 1215.1px (overflow 없음). #488 Stage 2 시각 검증 시 #489 의 텍스트-그림 겹침으로 인해 "잘림"으로 오인된 케이스 |
+| #495 | exam_science 페이지 2 7번 박스 안 동일 텍스트 중복 렌더링 | **완료** | `table_layout.rs:1573` 셀 paragraph 인라인 Shape 분기가 `composed.lines.first()` 만 보고 text_before 추출 → multi-line paragraph 에서 사각형이 ls[1]+ 에 있을 때 첫 줄 전체 텍스트가 paragraph_layout 결과와 중복 발행. 단계 3 v1 (TextRun 발행 제거) 시도가 synam-001 p31 "년/월" 글자 발행 누락 회귀 → 옵션 B (가드) 채택. `tac_pos` 가 ls[0] char 범위 안일 때만 text_before 발행. exam_science p2 박스 안 baseline 19 → 9 (중복 10 제거), 64 SVG 회귀 0건 (변경 1건 = 의도된 결함 수정), cargo test 1094+ 통과. 시각 검증 PDF 정합. 사각형 자체 위치 결함은 별도. **#496 (12번 줄간격 압축) 분리 처리** |
+| #496 | exam_science 페이지 2 12번 본문 줄간격 압축 (인라인 수식 다수) | **보류 (단계 1 완료, 후보 (D))** | 단계 1 진단으로 원인 식별: pi=61 이 `layout_inline_table_paragraph` 분기로 진입(`is_tac_table_inline=true` for 2행1열 tac 표). 이 함수는 multi-row 표 + multi-line 텍스트 처리 한계 — `wrapped_below_table` 한 번만 줄바꿈, ls[2] 무시 → 표 행 0 baseline 1191.68 과 paragraph 본문 baseline 1195.85 가 4px 안 겹침. PDF 는 표를 paragraph 본문과 **별도 블록** 처리. 수정 후보 (A)/(B)/(C)/(D) 검토 후 (D) **보류** 결정 (#500 과 본질 동일 — inline tac 컨트롤 처리 한계, layout 리팩터링 시 종합 해결). 코드 변경 없음, 진단 코드 모두 제거 |
+| #500 | exam_science 페이지 2 박스 안 사각형이 multi-line paragraph 의 잘못된 줄 위치 | 대기 | #495 처리 중 발견. `table_layout.rs:1640` Shape 분기 `inline_x` 가 paragraph 첫 줄 누적 폭 사용 → multi-line 에서 ls[1]+ 사각형이 잘못된 좌표. Picture 분기와 정합 (target_line 산출) 필요. #496 과 동일 본질 (inline tac 처리), 함께 layout 리팩터링 대상 |
+
 ## PR 처리
 
 | Issue | 타스크 | 상태 | 비고 |

mydocs/orders/20260501.md

@@ -1,7 +1,24 @@
 # 오늘 할일 - 2026년 5월 1일
 
+## M100 — 다단 vpos-reset 처리 정합
+
+| Issue | 타스크 | 상태 | 비고 |
+|------|--------|------|------|
+| #464 | exam_kor 15p 우측 단 본문 overflow — pi=103-105 col 1 LINE_SEG vpos-reset 미인식 | **완료** | `typeset.rs:904`, `engine.rs:609` 의 `current_column == 0` 가드 제거(룰 정합 — `col_count > 1` 이면 항상 감지). `typeset.rs:1975~1981` 의 직접 column 변경을 `advance_column_or_new_page()` 호출로 통합 (마지막 단에서 col_break 시 페이지 break 트리거). LAYOUT_OVERFLOW 16건 → 0건. exam_kor p15 PartialParagraph pi=103 lines=0..3, p16 pi=103 lines=3..6 + pi=104 + pi=105 정상 분리. 5종 다단 샘플 56 SVG 회귀 0 (변경 2건 = 의도된 결함 수정). exam_kor 페이지 수 20 유지. cargo test 1094+ 통과. Task #459 의 잔존 가드 제거 |
+| #466 | `compute_square_wrap_tbl_x_right` `horz_rel_to=Paper/Page` 케이스 보강 | **완료** | `layout.rs:3382` free function 을 `LayoutEngine` 메서드로 변환 + `horz_rel_to` 분기 추가 (Paper: ref_x=0/ref_w=paper_width, Page: ref_x=body.x/ref_w=body.width, Para/Column: col_area). caller 2곳 (`:2407, :2641`) 도 `self.dpi` 인자 제거. 9종 샘플 202 SVG 회귀 0 (Paper/Page case 발생 샘플 없음 — 잠재 결함만 보강, 기존 동작 보존). cargo test 1094+ 통과. Task #463 Stage 5 의 후속 |
+
 ## 회귀 정정
 
 | Issue | 타스크 | 상태 | 비고 |
 |------|--------|------|------|
 | #501 | mel-001.hwp 2쪽 s0:pi=22 표 셀 높이 처리 회귀 (v0.7.8 + 현재 devel, 크롬 확장 배포본 정상) | 완료 (Stage 5/5) | **본질**: HWP 의 셀 IR 에 `cell.padding.top + bottom > cell.height` 인 비정상 케이스 (mel-001 셀[21] r=2 c=2 "현 원": pad=(141,141,1700,1700), cell.h=1280 HU). HWPX `hasMargin="0"` 명시 정합. **회귀 origin**: Task #347 의 `prefer_cell_axis` 가드 (`aim=false 에서도 cell > table 이면 cell 우선`) 가 mel-001 의 1700 HU 도 cell 우선 적용 → padding 합산이 cell.height 의 2.66배 → row_heights 거대 → TAC 표 비례 축소 (scale 0.45) → 모든 행 12~20px 축소 + 셀 진입 결함. **정정**: `resolve_cell_padding` 끝에 **한컴 자체 방어 로직 모방** 가드 추가 — pad_top + pad_bottom > cell.height 면 cell.height 의 절반까지 비례 축소. measure_table_impl 1-b단계도 동일 가드 (안전망). 2 파일 변경, 신규 통합 테스트 1 (issue_501.rs). cargo test --lib 1086 passed + svg_snapshot 5/6 (form_002 부동소수 정밀도 미세 차이) + issue_418 1/1 + clippy 0건 + WASM 4,206,487 bytes. **작업지시자 시각 검증** — mel-001 p2 pi=22 r=0=26.4 (정상), 합계 r=1/r=2=17.07/17.07 (균등), 셀[21] "현 원" 정상 표시 ★. 트러블슈팅 + 위키 ([HWP 셀 Padding 방어 로직](https://github.com/edwardkim/rhwp/wiki/HWP-%EC%85%80-Padding-%EB%B0%A9%EC%96%B4-%EB%A1%9C%EC%A7%81)) 작성. **작업지시자 통찰**: *"이런 경우 한컴은 자체 방어로직으로 처리한다면?"* — Task #347 가드 (KTX 목차 정합) 보존 + 한컴 동작 모방 가드 추가 |
+
+## 잔존 이슈 (별도 task)
+
+| Issue | 타스크 | 상태 | 비고 |
+|------|--------|------|------|
+| #465 | exam_kor 16p PDF 우측 "홀수형" 뱃지 별도 요소 (master 외) | 대기 | 별도 조사 필요 |
+| #466 | compute_square_wrap_tbl_x_right Paper/Page case 미구현 | 대기 | Task #463 Stage 5 후속 |
+| #467 | extension master 다른 apply_to 처리 | 대기 | Task #463 Stage 8 후속 |
+| #496 | exam_science 페이지 2 12번 본문 줄간격 압축 | 보류 (단계 1 완료, 후보 (D)) | 2026-04-30. inline tac 컨트롤 처리 한계, layout 리팩터링 시 종합 해결 |
+| #500 | exam_science 페이지 2 박스 안 사각형 위치 결함 | 대기 | 2026-04-30. #496 과 본질 동일 (inline tac 처리), 함께 layout 리팩터링 대상 |