본질

rhwp-studio/src/view/virtual-scroll.ts는 zoom ≤ 0.5 + pages > 1 + viewport > 0 일 때 다중 열 그리드 배치로 분기하며 각 페이지의 X 좌표를 pageLefts[i] = marginLeft + col * (pw + gap) 로 열별 계산. canvas-view.ts 는 canvas.style.left = ${pageLefts[i]}px 로 페이지 element 위치 결정.

그러나 input-handler-mouse.ts 는 getPageLeft(pageIdx) 를 0회 호출, 14곳 분기 모두 단일 컬럼 가정 공식 사용:

const pageLeft = (scrollContent.clientWidth - pageDisplayWidth) / 2;

→ 그리드 모드에서 모든 페이지의 click 좌표가 어긋남.

정량 측정 (e2e, 2026-05-07)

samples/exam_kor.hwp (20p) + viewport 1600×1000 + headless Chrome.

zoom=0.5 (columns=2)

zoom=0.25 (columns=5)

→ 가운데 열 (col 2 @ columns=5) 만 우연히 0px. 양 끝 열 ±581.3px 어긋남.

zoom=1.0 (단일 컬럼 baseline)

모든 페이지 delta=0 → 단일 컬럼 모드 정상 (correct=−1 sentinel → fallback 공식 = buggy 공식 결과).

실제 click 검증

zoom=0.5 + page 1 (col 1) hwpX=100 의도:

• CORRECT click @(865.0) → cursor.pos = {sec:0, para:39, char:70} (정상)
• BUGGY click @(579.4) → cursor.pos = {sec:0, para:31, char:0} (page 0 영역 떨어짐)

영향 분기 (14곳)

핵심 사용자 영향: 475 / 811 / 889 — 일반 click / dblclick / context menu.

정정 방향

virtualScroll.getPageLeftResolved(pageIdx, containerWidth) 헬퍼 도입:

getPageLeftResolved(pageIdx: number, containerWidth: number): number {
  const pl = this.pageLefts[pageIdx] ?? -1;
  if (pl >= 0) return pl;  // 그리드 모드
  const pw = this.pageWidths[pageIdx] ?? 0;
  return (containerWidth - pw) / 2;  // 단일 컬럼 fallback
}

→ input-handler-mouse 의 14곳 모두 virtualScroll.getPageLeftResolved(pageIdx, sc.clientWidth) 한 줄로 치환. 단일 컬럼 모드는 무회귀 (sentinel −1 → 기존 공식).

한컴 호환 결함

한컴 오피스도 다중 페이지 그리드 모드 (여러 페이지 동시 보기) 가 존재하며, 그 모드에서 click 좌표는 정확히 처리됨 (사용자 직접 시연 확인, 2026-05-07). RHWP 만 그리드 모드에서 click 좌표 어긋남 → 한컴 호환 결함.

본 정정의 기대 동작: 한컴 그리드 모드와 동일하게 클릭 → 클릭한 페이지 안의 정확한 위치에 cursor 배치.

우선순위

High (UX-blocking) — 줌 25%/50% 사용 시 마우스 동작 전반 어긋남.

참고

• 진단 노트: mydocs/troubleshootings/grid_mode_click_coord.md
• e2e 측정 스크립트: rhwp-studio/e2e/grid-mode-click-coord.test.mjs
• 관련 영역 (input-handler-mouse cluster): rhwp-studio: 마우스 드래그 텍스트 선택 하이라이트가 페이지 밖으로 튀고 버벅임 #658, rhwp-studio: 텍스트 드래그 선택 중 커서와 스크롤 위치가 튀는 현상 #661, 표 내부 셀 선택 불가 #669