Maintainer note: preview 정확도와 rhwp Skia renderer 정합성에 집중합니다

[postmelee]

2026-06-01 메인테이너 결정입니다.

당분간 알한글은 새 편집 기능을 빠르게 넓히기보다 upstream rhwp Skia renderer의 시각 정합성을 높이고, 그 결과를 Quick Look, Finder thumbnail, PDF export, native viewer preview 정확도로 연결하는 것으로 결정했습니다.

현재 앱의 사용자-facing viewer/editor는 rhwp-studio 기반 WKWebView 경로를 유지합니다. Quick Look과 Thumbnail의 기본 preview 경로도 안정성 gate가 통과될 때까지 현행 fallback을 유지합니다. Skia 경로는 이미 opt-in 진단 경로와 visual diff 측정 기반을 갖추고 있으므로, 문서별 시각 차이, 성능, package size, fallback 안정성을 확인하면서 단계적으로 확대합니다.

다만 이는 앱 배포나 upstream rhwp release 반영을 멈춘다는 뜻은 아닙니다. 안정적인 rhwp release tag가 나오면 core, bundled rhwp-studio, provenance, smoke 검증을 맞춰 꾸준히 반영하고, public release도 필요한 patch 단위로 계속 진행합니다.

이 결정의 의도는 Swift/CoreGraphics에서 HWP 조판과 renderer를 계속 복제하는 것이 아니라, 문서 의미와 렌더링의 진실 원천을 rhwp core 쪽으로 모으는 것입니다. Swift/macOS 계층은 Finder/Quick Look 통합, sandbox, open/save/share/export flow, native shell, interaction, overlay를 맡고, HWP/HWPX parsing, layout, Skia rendering 정합성은 upstream rhwp와 bridge contract를 중심으로 개선합니다.

기여 우선순위는 다음과 같습니다.

1. rhwp-studio reference와 Skia/native preview 사이의 visual diff를 줄이는 upstream rhwp renderer 개선
2. 재현 가능한 HWP/HWPX sample과 before/after screenshot, visual diff summary 제공
3. Quick Look/Thumbnail/PDF/native viewer가 공유할 수 있는 renderer contract와 fallback 조건 정리
4. filename field context, external linked image 같은 open/resource contract 정리
5. Skia default 전환을 위한 visual, performance, memory, package size, fallback readiness 검증

반대로, renderer gate 없이 native editor mutation이나 저장 가능한 편집 기능을 먼저 여는 작업은 우선순위가 아닙니다. native editor 기능은 hit-test, selection, mutation, dirty state, save/round-trip gate가 준비된 뒤 별도 단계로 다룹니다.

관련 작업과 제한사항은 README 상단의 현재 작업 축에도 짧게 반영해 두겠습니다.