개요

samples/exam_math.hwp 페이지 12 좌측 컬럼 #29 안의 정규분포 z-table에서 모든 셀의 숫자/헤더 텍스트가 SVG 출력 시 두 번 그려져 겹치던 버그 수정. (closes
#301)

근본 원인 — Task #287 회귀

z-table 셀은 text="" + Equation 컨트롤 1개 구조. 빈 runs를 가진 셀 paragraph의 TAC 수식이 두 경로에서 EquationNode로 emit:

1. paragraph_layout.rs:1996-2057 (Task #287에서 추가) — 빈-runs 인라인 EquationNode push + set_inline_shape_position 호출
2. table_layout.rs:1602-1648 (기존) — has_text_in_para = false 분기에서 직접 EquationNode push, 중복 검사 없음

Task #287 도입 시 table_layout 측 가드를 함께 추가하지 않은 것이 원인. 두 경로의 좌표 계산 미세 차이(Δx≈2.5/28.9, Δy≈-1.31)로 살짝 어긋난 두 텍스트가 겹쳐
보였음.

변경 내용

코드

• src/renderer/layout/table_layout.rs (+5 -1)
  • Equation 분기에 tree.get_inline_shape_position(section_index, cp_idx, ctrl_idx).is_some() 가드 추가
  • paragraph_layout이 이미 렌더했으면 inline_x만 진행하고 직접 emit 스킵
  • 기존 has_text_in_para 검사는 보조 가드로 유지 (코너 케이스 보호)

테스트

• tests/issue_301.rs (신규, +45)
  • z-table 값 0.1915/0.3413/0.4332 각 1회 출현 검증
  • 0.4772는 본문에도 등장하므로 2회 검증

검증

시각 비교

수정 전: z-table 셀 텍스트 겹침 (헤더 P(0≤Z≤z)가 IR(t)≤Z≤2)처럼 보이고, 0.1915가 0.191$.1915 형태로 출력)
수정 후: z-table 1회 깔끔한 렌더링

영향 범위

• 수정 영향: 빈 텍스트 셀 + TAC 수식 컨트롤 가진 모든 표
• WASM canvas 경로: 동일 RenderTree 사용하므로 본 수정으로 동시 해결
• Picture/Shape 유사 패턴: 본 PR 범위 외, 별도 이슈 후보

산출물

• mydocs/plans/task_301{,_impl}.md
• mydocs/working/task_301_stage{1,2,3}.md
• mydocs/report/task_301_report.md

교훈

양방향 렌더 경로의 동기화 검증. Task #287에서 paragraph_layout에 빈-runs TAC 수식 처리를 추가할 때 table_layout의 기존 fallback과의 중복 가능성이 점검되지 않아 회귀가 발생. 같은 노드를 emit할 수 있는 두 경로가 있는 구조에서는 한쪽 추가 시 다른쪽 가드를 함께 점검하는 절차가 필요. 본 수정은 set_inline_shape_position이라는 기존 메커니즘을 그대로 is_rendered 플래그로 재활용하여 별도 상태 추가 없이 해결.