제안 내용

멀티 렌더러를 안정적으로 지원할 수 있도록 렌더링 구조를 단계적으로 분리합니다.

기존에는 각 renderer가 PageRenderTree를 직접 해석하는 흐름에 가까웠습니다. 이 시리즈에서는 renderer backend가 공통으로 replay할 수 있는 PageLayerTree를 중간 IR로 두고, SVG / Canvas2D / native Skia / CanvasKit / PDF export backend가 같은 layer contract를 기준으로 동작하게 합니다.

Document / Layout
-> PageRenderTree
-> PageLayerTree
-> SVG / Canvas2D / CanvasKit / native Skia / PDF export backend

이 이슈는 멀티 렌더러 작업을 리뷰 가능한 PR 단위로 나누어 추적하기 위한 tracking issue입니다. 기준은 단순히 변경 파일 수를 줄이는 것이 아니라, 각 PR이 독립적으로 설명 가능한 contract를 갖도록 만드는 것입니다.

분할 기준

• 기본 동작을 바로 바꾸지 않는 구조 변경은 먼저 넣습니다.
• public rendering path가 바뀌는 PR은 별도로 둡니다.
• path 전환 뒤에는 visual/pixel diff 같은 검증 pipeline을 따로 붙입니다.
• native Skia backend는 Canvas 전환과 섞지 않고 별도 backend PR로 둡니다.
• native Skia 안에서도 equation, raw SVG, form control, text, image effect처럼 실패 양상이 다른 leaf replay는 독립적으로 검토합니다.
• foundation만 추가하고 consumer가 없는 phase는 가능하면 다음 consumer 작업과 합칩니다.
• Text IR v2는 source table, placement/cluster metadata, special visual externalization을 각각 쪼개지 않고 TextRun compatibility contract 단위로 묶습니다.
• GlyphRun/GlyphOutline은 당분간 canonical path가 아니라 optional text variant로만 둡니다. TextRun fallback이 항상 남아 있어야 합니다.
• text variant adoption은 writer contract, diagnostics, backend selection gate를 먼저 만들고, 실제 backend replay는 별도 phase에서 엽니다.
• CanvasKit은 Canvas2D-assisted preview가 아니라 native Skia로 이어지는 독립 replay backend로 키웁니다. canvaskitMode=default는 direct replay 우선이며 Canvas2D overlay로 조용히 숨기지 않습니다. canvaskitMode=compat도 overlay fallback이 아니라 더 보수적인 CanvasKit direct replay policy입니다.
• CanvasKit overlay 제거는 mode/diagnostics foundation -> raster image direct replay -> equation/formObject -> TextRun effects -> GlyphRun/GlyphOutline gates 순서로 진행합니다. 지원하지 않는 기능은 Canvas2D paint로 덮지 않고 TextRun fallback, deterministic reject reason, backend diagnostics로 드러냅니다. raster output은 fuzzy 허용, semantic decision은 exact 기준으로 둡니다.
• CanvasKit direct replay가 기존 Canvas2D와 의도적으로 달라지는 경우는 Skia strict replay improvement로 fixture/diagnostics에 명시하고, compatibility mismatch와 구분합니다.
• PDF export는 PNG raster export와 다른 출력 계약으로 보고 별도 PR로 둡니다. 다만 SVG->PDF MVP와 direct/vector hardening은 같은 PDF backend contract 안에서 같이 봅니다.
• native binding/Swift package는 별도 사용자 표면입니다. native render/export API가 추가될 때마다 Swift/XCFramework/FFI 문서 영향 여부를 같이 확인합니다.

최신 확인 결과 (2026-06-10)

• devel은 4574299f 기준입니다. P22는 PR #1346으로 devel에 반영되었고 merge commit은 2bc411f4입니다. 이후 devel에는 fix(hwpx): 그림 effects/shadow roundtrip 보존 #1349, Task #1350 useFontSpace 직렬화 시 항상 false 고정 (IR 값 무시) #1351, #1354도 반영되어 있습니다.
• P16/P17/P18/P19/P20/P21/P22는 devel 반영 완료 상태입니다.
  • P16: PR render: add browser CanvasKit direct renderer #996 반영, browser CanvasKit direct renderer foundation.
  • P17: PR render: harden CanvasKit direct replay contract #1057 cherry-pick 반영, default/compat 모두 hidden Canvas2D overlay 없는 direct replay contract.
  • P18: PR render: expand CanvasKit image replay coverage #1096 반영, CanvasKit image replay coverage expansion.
  • P19: PR #1117은 maintainer-side cherry-pick 수용 후 closed. devel 반영 커밋은 c54e80d0, 3945a937, 225e8229, 4d1938e7, 90f6fa84, 606505bd입니다.
  • P20: PR render: add glyph payload resource proof diagnostics #1159 반영, glyph payload resource identity key와 native Skia font-construction proof diagnostics.
  • P21: PR render: add renderer baseline sweep reports #1312 반영, renderer baseline sweep report와 replay-plane/surface-axis baseline.
  • P22: PR render: reduce WebCanvas layer adapter and split option metadata #1346 반영, WebCanvas direct PaintOp replay와 layer option metadata closure.
• 6월 1일 이후 devel에는 renderer 후속 작업의 기준이 되는 layout/object/security 수정이 크게 들어왔습니다.
  • HWPX: 용지 기준 BehindText 그림/표의 z-order가 보존되지 않아 텍스트가 겹침 #1197/task 1245: 어울림 그림 및 미주 수식 배치 보정 #1250/Task #1197: HWPX 용지 기준 BehindText 그림/표 z-order 보존 #1252: HWPX 용지 기준 BehindText 그림/표 z-order, paper object layer metadata, master page SVG z-order 보정. P21 replay-plane/z-order baseline에 반영했습니다.
  • BookReview.hwp 글상자 내용이 영역 밖으로 출력되는 회귀 #1187/Task #1187: BookReview.hwp 글상자 내용 clip 회귀 수정 #1190: BookReview.hwp 글상자 clip 회귀 수정. text box clip path가 SVG/Canvas2D/CanvasKit/native Skia에서 같은 replay-plane 기준을 쓰는지 P21 baseline에서 확인했습니다.
  • task 1139 후속 보정: 3-09월_교육_통합_2023.hwp 19쪽 렌더링 정합 불일치 #1189/task 1189: task 1139 후속 미주/수식 정합 보정 #1194, 수식 큰 연산자(Σ/∏/∫) 피연산자 간격 누락 — 시그마가 우측 항에 붙어 렌더 #1233/수식 큰 연산자(Σ/∏/∫) 피연산자 간격 추가 (closes #1233) #1235, fix(#1300): 수식 위첨자를 base 상단에 정렬 — 키 큰 base 윗줄 침범 해소 #1301, 수식 무브레이스 첨자 공백 구분 미지원 — 미주 시그마 상·하한 깨짐 (sum_k=1 ^6) #1304/수식 괄호 그룹 뒤 위첨자 orphan — (k+1)^2 의 지수가 위로 안 올라감 #1305/수식 미주 시그마·괄호 지수 렌더 수정 (#1304, #1305) #1306: 미주/수식 흐름, 큰 연산자, 괄호 뒤 첨자, 시그마 상하한 보정. equation/endnote fixture baseline은 이 정합 보정 이후 결과를 기준으로 잡습니다.
  • 수식 포함 줄의 본문 한글 압축·겹침 — 거짓 오버플로우 (3-09월_교육_통합_2023 6쪽 문26) #1219/수식 포함 줄 본문 한글 압축·겹침 해소 (closes #1219) #1223, HWP5 표 셀 세로정렬/줄높이 정합 — z-표 행 압축·열 정렬 어긋남 (3-09월_교육_통합_2023 4쪽 문26) #1221/HWP5 수식-only 셀 z-표 행 압축 수정 — tac 순서매핑 (closes #1221) #1225, 미주(해설) 영역 줄간격이 한컴보다 좁게 렌더 — 풀이 페이지 행간 압축 #1236/미주(해설) 다줄 문단 줄간격 간헐적 좁음 수정 (closes #1236) #1240, 미주 문제 제목 앞 between-notes margin 누락 — 다줄 문단으로 끝나는 문제 다음 제목이 이전 줄에 붙음 #1238/Task #1246: 미주 between-notes margin min-gap (HeightCursor) — closes #1238, #1246 #1247, 수식 다행(S=… 등) 줄 병합 — 4줄이 3줄로 렌더 #1239/미주 연속 인라인 수식 다행 병합 해소 (closes #1239) #1241, task 1139 후속 보정: 3-09월_교육_통합_2022 7쪽 문25-26 하단 그림 배치 불일치 #1245/task 1245: 어울림 그림 및 미주 수식 배치 보정 #1250, #1274 후속: 교육 통합 HWP/PDF 문항 흐름 drift 검출 고도화 #1284/task 1284: #1274 후속 교육 통합 문항 흐름 drift 보정 #1292, fix(#1302): 미주 다줄 문단 다음 같은 미주 연속 문단 줄간격 과소 수정 #1303: 교육 통합 문항 흐름, TAC-only line, forced line break, continuation spacing 보정. P21 visual sweep은 이 흐름 보정들을 baseline으로 삼았습니다.
  • 폰트 충실도: 한컴 돋움 미설치 시 Noto Sans CJK 대체로 글리프가 PDF보다 크고 두껍게 렌더 #1224/폰트 충실도: 한컴 돋움 폴백을 Noto Sans KR ExtraLight로 (closes #1224) #1234: 한컴 돋움 폴백을 Noto Sans KR ExtraLight로 맞춘 font baseline. TextRun/GlyphRun/font proof fixture의 예상 raster가 이 기준에 의존합니다.
  • 사각형 글상자 안의 picture click hit-test 미지원 (이중 nested 구조) #1171/사각형 글상자 안 picture 클릭 hit-test / 속성 / 삽입 지원 (#1171) #1254, rhwp-studio: 셀 안 picture 복사 (Ctrl+C) 미지원 — copy_control_native 셀 컨텍스트 누락 (#1151 후속) #1161/feat: 표 셀(중첩 포함) picture 복사(Ctrl+C) 지원 + 떠있는 개체 paste cascade (#1161) #1228, rhwp-studio: exam_social.hwp 중첩 표 셀에서 내부 클립보드 붙여넣기 시 바깥 셀에 삽입됨 #1198/Task #1198: exam_social.hwp 중첩 표 셀 붙여넣기 경로 보존 #1207, 그림/표/도형의 textFlow 속성이 roundtrip 시 항상 BOTH_SIDES로 초기화됨 #1188/Task #1188 그림/표/도형의 textFlow 속성이 roundtrip 시 항상 BOTH_SIDES로 초기화됨 #1213: 글상자 안 picture, 중첩 표 cellPath, textFlow, picture copy/paste cascade 보정. object/image replay fixture와 hit-test/editing diagnostics에서 같은 path metadata를 유지해야 합니다.
  • HWPX 미주 우측 단 '다른 풀이' 미표시 (3-09월_교육_통합_2022) — 미주 2단 배치/오버플로 조사 #1200/HWPX curve 도형 <hp:seg> 파싱 — 외곽선(태그 박스) 렌더링 (closes #1200) #1203, HWPX: masterpage XML의 바탕쪽 EVEN/ODD가 파싱·연결되지 않음 #1201/Task #1201: HWPX masterpage idRef 연결 보강 #1242, HWPX 시리얼라이저에서 탭 폭이 4000으로 고정 #1267, HWPX에서 Bookmark/Field/Hyperlink dispatcher 연결 누락으로 인해 모든 필드 컨트롤 소멸 #1289, Task #1298 (#1289 후속 작업) - fix: HWPX 시리얼라이저 0-length field range fieldBegin/fieldEnd 인터리빙 수정 #1299: HWPX curve/masterpage/tab/field/serializer ordering 보정. layer lowering과 renderer sweep fixture가 parser/serializer 최신 contract를 되돌리지 않도록 확인합니다.
  • 확장 프로그램 service worker의 외부 URL fetch 경로 보안 강화 #1307: 확장 프로그램 fetch 보안 강화. renderer phase 자체는 아니지만 후속 PR 최신화 과정에서 extension-side URL/sender/redirect/credentials hardening을 되돌리면 안 됩니다.
• 후속 구현 검토 결과, P21에서 replay-plane/z-order, renderer baseline runner, 작은 representative manifest, CanvasKit surface axis, native/browser performance report를 report-first 형태로 닫았습니다. large corpus 확장은 후속으로 분리합니다. P23에서는 PDF artifact를 hard gate로 넣지 않고, export-pdf 결과와 browser Canvas 출력을 비교하는 report-only PDF visual diff를 추가했습니다.
• P22는 WebCanvas layer adapter 축소와 layer option metadata closure로 완료되었습니다. public Canvas route를 다시 바꾸지 않고, 이미 layer 기반인 route의 내부 adapter risk를 줄이는 boundary cleanup으로 닫았습니다.
• P23은 PDF export/native API packaging으로 진행 중입니다. PR #1359에서 SVG-derived PDF export를 DocumentCore native API와 CLI가 공유하는 표면으로 올리고, render-diff CI에 report-only PDF visual diff summary/artifacts를 추가합니다.
• strict BitmapGlyph/SvgGlyph, variation/TTC, shapedModern/cross-scope/MixedPerGlyph는 writer-ready 선언이 아니라 producer-output corpus와 proof gate 중심으로 유지합니다.

계획 업데이트 (2026-06-10)

CanvasKit 방향은 overlay fallback을 줄이는 수준이 아니라, browser CanvasKit과 future native Skia가 같은 replay contract를 공유할 수 있도록 overlay-free direct replay를 기본 전제로 둡니다. P16-P21이 devel에 반영되었으므로 이후 계획은 “초기 renderer 도입”이 아니라 “direct replay coverage를 어떤 contract 단위로 넓히고 검증할지”가 기준입니다.

• canvaskitMode=default: direct CanvasKit replay 우선.
• canvaskitMode=compat: Canvas2D overlay fallback이 아니라 conservative CanvasKit direct replay policy.
• unsupported case: Canvas2D paint로 숨기지 않고 TextRun fallback, deterministic reject reason, backend diagnostics 중 하나로 처리.
• canvaskitSurface=auto|webgpu|webgl|software: render mode와 별도인 diagnostics axis. browser baseline, native-vs-CanvasKit parity report, aggregate Markdown report에 요청 surface와 fallback reason을 보존합니다.
• P17은 bridge/schema/payload gate hardening으로 완료했습니다. latest devel layout fixes와 섞지 않고, compat direct replay reporting, bridge fallback safety, schema metadata sync, deterministic reject reason 기준을 먼저 닫았습니다.
• P18은 image replay coverage로 완료했습니다. crop/fill-mode/original-size/transform/cache-key/direct diagnostics는 닫았고, effect/filter와 broader object replay는 후속으로 넘깁니다.
• P19는 text/glyph advanced payload gate와 COLRv1 supported replay subset으로 완료했습니다. PR #1117은 maintainer-side cherry-pick 수용 후 closed 되었고, ColorLayers, BitmapGlyph, SvgGlyph, GlyphOutline richer payload의 validator/reject reason과 COLRv1 solid/linear/radial/sweep CanvasKit direct replay subset이 devel에 들어갔습니다. composite/blend/clip reuse/unreachable graph/malformed root/unordered stop은 deterministic reject로 유지합니다.
• P20은 glyph payload resource corpus와 font construction proof로 완료했습니다. PR #1159에서 static vector glyph/resource payload fixture, payloadResourceKey, cache-key/resource identity, face index/variation/exact typeface construction failure diagnostics를 묶어서 GlyphRun/GlyphOutline replay eligibility 전제를 단단히 했습니다.
• P21은 renderer sweep / replay-plane ordering / surface axis를 합친 baseline infrastructure phase로 완료했습니다. PR #1312에서 SVG, Canvas2D, CanvasKit, native Skia를 작은 representative manifest/report에서 비교하는 report-first 파이프라인, Full Renderer Sweep manual workflow, browser/native baseline report, surface axis diagnostics를 정리했습니다. Large corpus 확장과 PDF artifact 수집은 P21에 넣지 않았습니다.
• P22는 WebCanvas direct PaintOp replay와 layer option metadata closure로 완료했습니다. Canvas public path를 다시 바꾸지 않고, WebCanvas layer replay가 leaf payload를 임시 legacy node로 되돌리는 부분을 줄였고 buildOptions/debugOptions/outputOptions contract를 명확히 했습니다.
• P23은 PDF export와 native render/export API packaging입니다. PR #1359에서는 먼저 SVG-derived PDF export를 DocumentCore native API로 올리고 CLI export-pdf가 같은 API를 쓰도록 정리합니다. render-diff CI에는 report-only PDF visual diff를 추가해 export-pdf raster와 browser Canvas 출력의 차이를 summary/artifact로 남깁니다. Direct/vector PageLayerTree -> PDF, PDF visual diff hard gate, Swift/XCFramework/FFI packaging 변경은 후속으로 남깁니다.
• P24는 strict BitmapGlyph/SvgGlyph producer-output corpus widening입니다. 기존 handcrafted payload fixture를 더 늘리는 게 아니라, 실제 lowering/resource path를 통과한 one-strike bitmap payload와 sanitized static vector payload를 corpus로 추가합니다.
• P25는 exact font replay corpus widening입니다. native Skia variation/TTC proof는 real variable-font / real collection corpus와 digest-pinned positive/negative controls로 넓히고, CanvasKit variation/TTC는 exact construction proof가 생길 때까지 conservative fallback을 유지합니다.
• P26은 authority-gated v2 follow-up입니다. 추가 COLRv1 blend/composite/clip primitive, shapedModern width input/line breaking, cross-scope variants, public MixedPerGlyph writer emission은 concrete document/use case와 fallback/reject policy가 준비될 때까지 보류합니다.
• direct replay가 Canvas2D와 의도적으로 달라지는 경우는 Skia strict replay improvement로 fixture/diagnostics에 명시하고, compatibility mismatch와 구분합니다.
• crossScopeVariants, MixedPerGlyph, shapedModern layout mutation은 schema vocabulary와 validator gate는 유지하되, 실제 writer emission은 use case / corpus / backend semantics가 준비될 때까지 보류합니다.

Text IR v2 설계 상태

Text IR v2는 기존 TextRun fallback을 유지한 채, backend가 더 엄격한 text variant를 선택할 수 있는 compatibility contract를 단계적으로 여는 작업입니다.

• P11: source table, source span, placement/cluster metadata, special visual op externalization, feature negotiation metadata를 추가했습니다.
• P12: GlyphRun optional sidecar와 font/blob/face identity contract를 추가했습니다. native Skia와 Canvas2D/layered SVG는 fallback을 유지합니다.
• P13: textV2 diagnostics, validation issue, line-break risk telemetry, fallback-free profile guard를 schema minor 1.10으로 정리했습니다.
• P14: GlyphOutline strict sidecar와 backend text variant selection diagnostics를 schema minor 1.11로 추가했습니다. 기존 renderers는 TextRun fallback을 유지했습니다.
• P19: advanced GlyphOutline payload vocabulary와 COLRv1 bounded graph contract를 schema minor 1.14로 추가했습니다. CanvasKit은 solid/linear/radial/full-circle sweep gradient subset만 direct replay하고, 나머지는 deterministic reject와 TextRun fallback을 유지합니다.
• P20: payloadResourceKey, resource table minor 1.4, native font-construction proof diagnostics를 추가했습니다. exact glyph-id replay는 proof가 있는 native cases로만 제한하고, CanvasKit variation/TTC는 conservative fallback을 유지합니다.

비목표도 유지합니다.

• GlyphRun/GlyphOutline을 canonical text path로 전환하지 않습니다.
• font blob / font face resource table을 완성했다고 보지 않습니다.
• native Skia glyph id replay나 CanvasKit glyph replay를 기본 경로로 넣지 않습니다.
• public render path를 바꾸지 않습니다.
• Text IR v2 schema를 최종 안정화했다고 선언하지 않습니다.

P16 이후 보존/이동한 수정 방향

P16이 devel에 반영되었으므로, 이후 phase는 CanvasKit direct replay renderer를 더 크게 만드는 방식이 아니라 contract 단위로 안정성을 넓히는 방식으로 갑니다.

• CanvasKit direct replay 방향은 유지합니다.
  • default mode에서는 unsupported op를 Canvas2D overlay로 조용히 가리지 않습니다.
  • compat mode도 Canvas2D overlay fallback이 아니라 conservative direct replay mode입니다.
  • 필요한 경우 더 보수적인 clip padding / sampling / variant selection / cache policy를 선택하고, unsupported case는 deterministic fallback/reject diagnostics로 남깁니다.
• P17은 다음 hardening을 완료했습니다.
  • replay bridge fallback safety
  • layer schema metadata sync
  • compat direct replay reporting
  • CanvasKit payload replay gates and reject reasons
• P18은 image replay coverage expansion으로 완료했습니다.
  • crop / fill-mode / original-size / transform replay
  • image cache key payload fingerprint
  • direct image diagnostics and replay-plan detail
  • effect / brightness / contrast는 direct pixel effect가 아니라 diagnostics로 노출
• P19는 text/glyph advanced payload gate와 COLRv1 supported replay subset으로 완료했습니다. 관련 PR은 #1117입니다.
  • GlyphRun/GlyphOutline은 canonical path가 아니라 gated text variant입니다.
  • ColorLayers, BitmapGlyph, SvgGlyph payload validator/reject reason을 고정했습니다.
  • COLRv1 solid/linear/radial/sweep graph는 CanvasKit direct replay subset으로 열었고, composite/blend/clip reuse처럼 아직 replay하지 않을 payload는 deterministic reject로 남겼습니다.
  • GlyphOutline은 generic Path처럼 섞지 않고 text variant gate로만 다룹니다.
  • Canvas2D/CanvasKit GlyphOutline replay branch parity를 payloadKind, colorFormat, COLRv1 graph node.kind 기준으로 검증했습니다.
• P20은 glyph payload resource corpus와 font construction proof로 완료했습니다. 관련 PR은 #1159입니다.
  • static vector glyph/resource payload fixture로 resource identity와 cache key를 검증합니다.
  • payloadResourceKey로 color/bitmap/SVG glyph sidecar resource/cache identity를 분리했습니다.
  • face index, variation, exact typeface construction 실패를 backend별 silent fallback이 아니라 diagnostics/reject matrix로 확인합니다.
• P21은 sweep/report이면서 replay-plane ordering baseline으로 완료했습니다. 관련 PR은 #1312입니다.
  • SVG / Canvas2D / native Skia / CanvasKit을 작은 representative fixture 기준으로 비교할 수 있는 runner와 report를 정리했습니다.
  • replay-plane subtree detection, z-order, empty-plane skip, static cache plane key가 backend마다 갈라지지 않게 고정했습니다.
  • WebGPU/software surface axis와 performance metrics는 default CI gate가 아니라 artifact/report로 먼저 두었습니다.
• P22는 WebCanvas boundary cleanup으로 완료했습니다. 관련 PR은 #1346입니다.
  • WebCanvas layer replay가 image/page-background/shape/text/equation/footnote/form payload를 직접 소비하도록 legacy wrapper adapter를 줄였습니다.
  • layer buildOptions, debugOptions, outputOptions는 build-time metadata, debug display metadata, replay semantics를 구분해서 내보냅니다.
  • public Canvas route를 다시 바꾸지 않고, 이미 layer 기반인 route의 내부 adapter risk를 줄였습니다.
• P23은 PDF export와 native API packaging입니다. 관련 PR은 #1359입니다.
  • SVG-derived PDF export를 DocumentCore native API와 CLI가 공유하는 표면으로 올립니다.
  • render-diff CI에 report-only PDF visual diff를 추가해 export-pdf raster와 browser Canvas 출력의 차이를 JSON/Markdown summary와 artifact로 남깁니다.
  • direct/vector hardening, PDF visual diff hard gate, Swift/XCFramework/FFI packaging 변경은 후속으로 남깁니다.
• P24/P25는 strict glyph/font proof를 넓히는 phase입니다.
  • P24는 strict BitmapGlyph/SvgGlyph producer-output corpus를 추가합니다.
  • P25는 native variation/TTC real corpus와 CanvasKit exact construction proof gate를 다룹니다.
• P26은 authority-gated follow-up입니다.
  • COLRv1 추가 primitive, shapedModern, cross-scope variants, public MixedPerGlyph는 concrete corpus/use case가 생길 때까지 writer emission을 열지 않습니다.
• 최신 devel에는 layout/render/security 수정이 계속 들어오고 있으므로, 후속 renderer PR은 항상 최신 devel 위에서 시작합니다. broad layout fix나 extension fetch security fix는 renderer backend PR에 섞지 않고 이미 devel에 들어간 correctness/security fix를 전제로 삼습니다.

현재 진행상황

P22까지 devel에 반영되었습니다. 현재 next action은 P23입니다. P23 PR #1359에서는 PDF export를 native DocumentCore API와 CLI가 공유하는 표면으로 올리고, report-only PDF visual diff를 render-diff CI에 추가합니다. Direct/vector PDF backend와 PDF visual diff hard gate는 후속으로 분리합니다.

• P1: 렌더러 프론트엔드/백엔드 1차 분리

  • PageLayerTree, LayerNode, PaintOp, LayerBuilder 추가
  • layer tree JSON export 추가
  • opt-in layer SVG replay 경로 추가
  • 관련 PR: render: introduce PageLayerTree generation API #419

• P2: Canvas 렌더링을 PageLayerTree 기반으로 전환

  • native Canvas recorder에 layer replay 경로 추가
  • browser renderPageToCanvas를 layer replay 경로로 전환
  • legacy Canvas 경로는 별도 API로 유지
  • 관련 PR: render: route Canvas rendering through PageLayerTree #456

• P3: Canvas visual diff 테스트 추가

  • legacy Canvas와 layer Canvas 결과 비교
  • fixture별 diff artifact 저장
  • GitHub Actions workflow 추가
  • 관련 PR: test: add canvas visual diff pipeline #498

• P4: native Skia PNG raster backend 추가

  • native-skia feature 추가
  • PageLayerTree 기반 Skia replay 구현
  • native-only PNG export API 추가
  • raster guard / image replay / fallback replay / native Skia smoke test 추가
  • 관련 PR: render: add native Skia PNG raster backend #599

• P5: native Skia equation replay 추가

  • EquationNode.layout_box 기반 replay
  • fraction / atop / sqrt / script / matrix 등 주요 layout node 처리
  • 관련 PR: render: replay equations in native Skia PNG output #626

• P6: native Skia raw SVG fragment replay

  • RawSvgNode.svg fragment를 안전한 wrapper SVG로 감싼 뒤 resvg/tiny-skia로 rasterize
  • external href 차단, fragment byte/pixel guard, invalid SVG fallback 유지
  • 관련 PR: render: replay raw SVG fragments in native Skia PNG output #720

• P7: native Skia form control static replay

  • push button / checkbox / radio button / combo box / edit field 정적 drawing
  • PNG/export 경로에서 form object가 placeholder로만 보이지 않도록 보강
  • 관련 PR: Skia form control static replay (P7) #740

• P8: Layer IR schema/resource key hardening

  • paint/schema.rs 추가
  • layer schema metadata와 resource key versioning 추가
  • wasm export contract test 추가
  • layer output option consumption을 renderer 경로에서 확인
  • 관련 PR: render: harden PageLayerTree schema and resource keys #761

• P9: native Skia text replay parity + module split

  • native Skia text replay가 기존 TextRunNode의 char overlap, tab leader, control mark, decoration, vertical rotation 정보를 소비하도록 보강
  • 커진 text replay 구현을 renderer/skia/text_replay.rs로 분리
  • 관련 PR: render: improve Skia text replay parity #769

• P10: P9에 fold

  • 별도 PR로 열기에는 순수 리팩터링에 가까워서 P9에 포함했습니다.

• P11: Text IR v2 compatibility contract

  • source table, source span, placement/cluster metadata, special visual op externalization, feature negotiation metadata 추가
  • docs/text-ir-v2.md에 migration contract 문서화
  • 관련 PR: render: add Text IR v2 compatibility contract #797

• P12: Guarded GlyphRun variant contract

  • TextRun fallback을 유지한 상태에서 GlyphRun optional sidecar variant 도입
  • font blob, face identity, replay eligibility 타입 추가
  • 관련 PR: render: add guarded GlyphRun layer variant contract #840 (cherry-pick/squash 후 closed)
  • devel merge commit: 249e5653; squashed feature commit: 08af19b6

• P13: Text IR v2 diagnostics/schema closure

  • TextV2Diagnostics, slot diagnostics, validation issue, line-break risk, compatibility profile 추가
  • layer schema minor 1.10
  • 관련 PR: render: add Text IR v2 diagnostics and schema closure #881 (closed 후 devel cherry-pick)
  • devel commit: 47c3e756

• P14: GlyphOutline text variant adoption + backend selection diagnostics

  • PaintOp::GlyphOutline strict sidecar contract 추가
  • layer schema minor 1.11
  • text.glyphOutline / text.glyphOutline.strictSidecar JSON feature metadata 추가
  • analyze_text_variant_selection backend selection diagnostics API 추가
  • 기존 renderers는 GlyphOutline을 직접 그리지 않고 TextRun fallback을 유지
  • 관련 PR: render: adopt guarded text variants for backend replay #916 (closed 후 devel cherry-pick)
  • devel commit: 586d914a

• P15: CanvasKit replay policy diagnostics

  • getCanvasKitReplayPlan(page, mode) diagnostics-only API 추가
  • CanvasKit default / compat mode contract와 hidden overlay inventory 추가
  • default는 hidden Canvas2D overlay를 금지하고, compat는 transition overlay를 명시적으로 보고하는 P15 기준 policy plan입니다.
  • 이후 P16에서는 compat도 Canvas2D overlay fallback이 아니라 conservative direct replay policy로 구현합니다.
  • 관련 PR: render: add CanvasKit replay policy diagnostics #925 (closed 후 devel cherry-pick)
  • devel commit: e94b1d01

• P16: Browser CanvasKit direct renderer and overlay-free mode split

  • Studio에 browser CanvasKit backend를 추가했습니다.
  • PageLayerTree를 직접 replay하며 Canvas2D overlay pass를 backend contract로 들여오지 않습니다.
  • render-backend.ts에서 canvas2d / canvaskit backend, renderer=skia alias, canvaskitMode=default|compat, canvaskitSurface=auto|webgpu|webgl|software, renderProfile resolver를 정리했습니다.
  • URL 기반 renderer opt-in은 localStorage에 고정하지 않고, invalid renderer 값은 diagnostic/warning으로 드러냅니다.
  • default mode는 native-preparation direct replay입니다.
  • compat mode는 conservative direct replay입니다. clip padding, sampling, variant selection, cache policy는 보수적으로 고를 수 있지만 Canvas2D paint를 덮는 fallback pass는 쓰지 않습니다.
  • getPageLayerTreeObject(page, profile) bridge는 JSON parse/shape validation을 수행하고, legacy empty layer shape는 안전한 empty PageLayerTree로 낮춥니다.
  • renderer diagnostics는 unsupported op, surface fallback reason, per-page render failure를 남깁니다.
  • 관련 PR: render: add browser CanvasKit direct renderer #996 (closed 후 devel 반영)
  • devel merge/report commit: 3d4a9c34; feature commit: 933c056e; follow-up docs commit: 20482412

• P17: CanvasKit direct replay contract hardening

  • compat mode가 Canvas2D overlay fallback이 아니라 direct replay contract로 보고되도록 native/WASM/Studio diagnostics를 정리했습니다.
  • CanvasKit replay mode policy를 DIRECT_ONLY 계약으로 모아 hidden overlay 허용 여부와 direct replay required 여부를 한 곳에서 설명합니다.
  • Studio bridge fallback도 hiddenCanvas2dOverlayAllowed=false, directReplayRequired=true contract를 유지합니다.
  • layer schema constant export와 LAYER_TREE_SCHEMA 동기화 테스트를 보강했습니다.
  • CanvasKit renderer / Studio fallback regression test로 Canvas2D overlay replay가 다시 들어오지 않게 막았습니다.
  • 관련 PR: render: harden CanvasKit direct replay contract #1057 (closed 후 devel cherry-pick)
  • devel commits: dbfd7563, 06047e53; review/report commit: 2b1cdb40

• P18: CanvasKit image replay coverage expansion

  • 관련 PR: render: expand CanvasKit image replay coverage #1096
  • CanvasKit image replay가 layer JSON의 crop, originalSize, fillMode, transform payload를 소비하도록 확장합니다.
  • crop source rect는 기존 SVG replay와 같은 HWPUNIT 75 HU/px 기준으로 계산합니다.
  • image cache key에 base64 payload fingerprint를 포함해 같은 imageRef의 다른 payload 충돌을 막습니다.
  • getCanvasKitReplayPlan은 simple image를 direct로 보고, image effect / brightness / contrast는 아직 diagnostics/detail로 남깁니다.
  • non-goal: grayscale/blackWhite/pattern8x8 pixel filter, RawSvg/WMF/OLE object replay, TextRun/glyph replay.
  • devel merge commit: 6cbd25ea; 처리 기록 commit: 17f6ad84

• P19: Text/glyph advanced payload gates + COLRv1 supported replay subset

  • 관련 PR: render: gate advanced glyph outline payloads #1117 (maintainer-side cherry-pick 수용 후 closed)
  • devel 반영 커밋: c54e80d0, 3945a937, 225e8229, 4d1938e7, 90f6fa84, 606505bd
  • layer schema minor 1.14와 text.glyphOutline.advancedPayloads feature metadata를 추가했습니다.
  • ColorLayers, BitmapGlyph, SvgGlyph, richer GlyphOutline payload family를 writer-ready로 선언하지 않고 gate vocabulary와 diagnostics로 먼저 노출했습니다.
  • COLRv1 solid/linear/radial/sweep graph만 CanvasKit direct replay subset으로 열고, composite/blend/clip reuse/unreachable graph/malformed root/unordered stop은 deterministic reject로 유지했습니다.
  • Canvas2D/CanvasKit branch parity, fallback/reject reason, schema/README/docs contract를 함께 검증했습니다.
  • non-goal 유지: arbitrary font construction, canonical text path 전환, native/SVG full color glyph replay.

• P20: Glyph payload resource corpus and font construction proof

  • 관련 PR: render: add glyph payload resource proof diagnostics #1159
  • devel merge commit: 0f1c22ba
  • layer schema minor 1.15, resource table minor 1.4
  • payloadResourceKey로 color/bitmap/SVG glyph sidecar resource/cache identity를 분리했습니다.
  • ResourceArena font blob ref lookup과 native Skia glyph-run replay proof diagnostics를 추가했습니다.
  • native Skia exact glyph-id replay는 계속 닫아 두고 missing blob bytes, replay eligibility, face index, variation, typeface construction blocker를 분리했습니다.

• P21: Renderer sweep, replay-plane ordering, surface axis, and report artifacts

  • 관련 PR: render: add renderer baseline sweep reports #1312
  • devel merge commit: 785f5ef7
  • 작은 representative manifest와 scripts/renderer_baseline.py report pipeline을 추가했습니다.
  • browser Canvas2D/CanvasKit baseline, native Skia vs CanvasKit parity report, CanvasKit surface axis/performance diagnostics를 정리했습니다.
  • Full Renderer Sweep manual workflow를 추가했습니다.
  • replay-plane subtree detection/helper를 CanvasKit/native Skia/WebCanvas 경로에서 공유하도록 정리했습니다.
  • non-goal 유지: large corpus expansion, PDF artifact collection, default CI gate.

• P22: WebCanvas direct PaintOp replay and layer option metadata closure

  • 관련 PR: render: reduce WebCanvas layer adapter and split option metadata #1346
  • devel merge commit: 2bc411f4
  • WebCanvas layer replay에서 core PaintOp leaf payload를 직접 소비하도록 legacy wrapper adapter를 줄였습니다.
  • layer JSON의 buildOptions, debugOptions, outputOptions metadata를 분리하고 legacy outputOptions mirror를 compatibility field로 유지했습니다.
  • public Canvas route는 그대로 유지했고, 내부 adapter risk cleanup으로 닫았습니다.

다음 분할 후보

• P23: PDF export and native render/export API packaging

  • 관련 PR: render: expose native PDF export API #1359
  • PDF는 PNG raster export와 다른 출력 계약입니다. P21에서는 PDF artifact를 baseline report에 넣지 않았으므로, export API 안정화는 별도 phase로 봅니다.
  • 이번 PR은 native-only SVG-derived PDF export MVP를 DocumentCore::render_page_pdf_native, render_pages_pdf_native, render_document_pdf_native API로 올리고, CLI export-pdf가 같은 API를 쓰게 합니다.
  • 단일/다중 페이지, page range, output path handling, error reporting은 focused test와 CLI smoke로 확인합니다.
  • render-diff CI에는 report-only PDF visual diff를 추가합니다. export-pdf 결과를 pdftoppm으로 rasterize하고 browser Canvas 출력과 비교해 JSON/Markdown summary와 artifacts를 남깁니다.
  • 이후 PageLayerTree에서 직접 PDF/vector recording으로 가는 경로를 검토합니다.
  • Swift/XCFramework/FFI packaging 변경과 PDF visual diff hard gate는 후속으로 둡니다.
  • unsupported object는 기존 fallback을 유지합니다.

• P24: Strict BitmapGlyph/SvgGlyph producer-output corpus widening

  • handcrafted strict payload fixture를 더 늘리는 대신 실제 lowering/resource path를 통과한 producer-output fixture를 추가합니다.
  • BitmapGlyph는 one producer-selected strike, deterministic alpha/scaling/filtering, no strict backendDefault, resource bytes in cache key, colorSpaceDefaulted diagnostics를 유지합니다.
  • SvgGlyph는 VectorResourceId, required viewBox, securityMode=staticSanitized, script/animation/external/interactivity hard false, no raw SVG-in-font replay를 유지합니다.
  • strictVisual without valid payload는 hard reject하고 compatibility export는 TextRun/GlyphRun fallback을 유지합니다.

• P25: Exact font replay corpus widening

  • native Skia variation replay는 real variable-font corpus와 digest-pinned positive/negative controls로 넓힙니다.
  • native Skia TTC/OTC replay는 real collection fixture, face-index positive/negative, wrong-face/high-index/ambiguous metadata, digest mismatch를 corpus로 검증합니다.
  • CanvasKit variation/TTC는 public API path가 exact variation tuple / exact collection face construction을 증명할 때까지 variationUnsupported / faceIndexUnsupported fallback을 유지합니다.
  • public u32 glyph id range guard는 backend enablement 뒤에도 유지합니다.

• P26: Guarded v2 authority follow-ups

  • COLRv1 추가 blend/composite/clip primitive는 concrete document가 있고 glyph-payload-local semantics를 유지할 때만 엽니다.
  • shapedModern width input/line breaking은 representative HWP corpus, width-delta distribution, fallback split, cluster mapping, vertical metrics, table/cell review 전까지 report-only로 둡니다.
  • cross-scope variants는 same-scope fallback이 부족한 concrete use case가 생길 때까지 vocabulary/diagnostics만 유지합니다.
  • public MixedPerGlyph writer emission은 cluster/grapheme orientation, GlyphTransformRun, transform replay, vertical fixtures, backend fallback/reject policy가 안정될 때까지 homogeneous run split을 기본으로 둡니다.

합친 phase

• P10은 P9에 합쳤습니다. 순수 리팩터링이라 별도 리뷰 단위로 두면 같은 text replay 코드를 두 번 보게 됩니다.
• 기존 P11/P12/P13은 P11로 합쳤습니다. source table, placement/cluster metadata, special visuals externalization은 모두 TextRun v2 compatibility contract를 완성하는 한 묶음입니다.
• 기존 P14/P15/P16은 P12로 합쳤습니다. font resource table만 따로 넣으면 consumer가 없는 foundation PR이 되고, native Skia guard는 같은 GlyphRun variant contract입니다.
• P13은 diagnostics/shape profile/schema closeout을 합쳐 devel에 반영했습니다. variantOps/schema v2 compatibility는 실제 writer 전환 없이 후속 text variant adoption에서 다룹니다.
• 실제 P14가 GlyphOutline/Text variant adoption으로 반영됐고 P15가 diagnostics-only policy로 반영됐으므로, browser CanvasKit 구현은 P16부터 overlay-free direct renderer로 시작합니다.
• image geometry/cache-key direct replay는 P18에서 완료했고, effect/filter와 broader object replay는 후속 direct replay coverage로 남깁니다.
• advanced glyph payload gate는 P19로 완료했습니다. PR #1117은 payload validator, branch parity test, deterministic reject reason을 먼저 닫고, COLRv1 solid/linear/radial/sweep CanvasKit subset만 같은 gate 아래에서 열었습니다.
• COLRv1 solid/linear/radial/sweep color glyph replay subset은 P19에 합쳤습니다. gate vocabulary만 두면 phase가 너무 작아지고, CanvasKit direct replay consumer가 같은 PR에 있어야 validator의 의미가 분명하기 때문입니다.
• glyph payload resource corpus와 font construction proof는 P20으로 완료했습니다. resource identity/cache key와 exact typeface construction failure는 실제 glyph replay eligibility의 전제라 sweep보다 먼저 검증했습니다.
• replay-plane ordering, 작은 renderer baseline manifest, surface-axis diagnostics, performance report는 P21로 완료했습니다. Large corpus manifest expansion과 PDF artifact collection은 P21에서 분리했습니다.
• WebCanvas direct PaintOp replay와 layer option metadata는 P22에 합쳤습니다. 둘 다 public path 전환이 아니라 layer boundary cleanup이고, 같은 JSON/JS/Studio type contract를 확인해야 했기 때문입니다.
• PDF export backend와 native render/export API packaging은 P23으로 이동했습니다. P21에서 PDF artifact collection은 분리했고, P23 PR #1359는 SVG-derived PDF export API surface를 안정화하면서 report-only PDF visual diff artifacts를 render-diff CI에 추가합니다.
• strict BitmapGlyph와 SvgGlyph producer-output corpus widening은 P24에 묶습니다. 둘 다 strict payload resource family hardening이고, shared resource/cache/validator contract를 함께 확인해야 합니다.
• variation font와 TTC/OTC exact replay corpus widening은 P25에 묶습니다. 둘 다 exact font construction proof와 digest/face/axis negative controls가 핵심입니다.
• shapedModern, cross-scope variants, public MixedPerGlyph, 추가 COLRv1 primitive는 P26 authority-gated follow-up으로 유지합니다. concrete corpus/use case 없이 별도 구현 phase로 열지 않습니다.

별도 트래킹

• export-png: VLM 프리셋 확장 (GPT-4V / Gemini / Qwen-VL / LLaVA) #613: export-png VLM preset 확장
• export-png: DPI 메타데이터 옵션 (--dpi <값>) — PNG pHYs chunk + 인쇄 워크플로우 #614: PNG DPI metadata / pHYs chunk
• 글상자 컨테이너 자식 표/문단 미렌더 — table-in-tbox.hwp p1 본 양식 표 누락 (한글 2022 PDF mismatch) #696: 최신 upstream layout/render correctness 이슈. raster 기준에 영향을 줄 수 있으므로 추적합니다.
• 빈 문단 위 treat-as-char 글상자 — FullParagraph/Shape PageItem advance 이중 가산으로 세로 간격 2배 #990 / HWP3→HWP5/HWPX 변환 시 표/그림 anchor 타입 변경으로 다이어그램 overflow + 라벨 z-order 어긋남 (sample16 p18) #991 / M100: HeightMeasurer ↔ cell_units 측정 정합 (task993 LAYOUT_OVERFLOW 50건 회귀 해소) #1022 / M100: 페이지보다 큰 단일 표 셀 내부 분할 (intra-cell line split) — #993/#1022 후속 page-larger #1025 / M100: 세로 측정 정합 — 페이지네이터 과측정으로 콘텐츠 다음쪽 밀림 + 박스 아래 여백 (#1022 후속) #1027 / HWP3 외곽선 paper-edge 정합 회귀 (PR #1003 cherry-pick --theirs 충돌 해소 사고) #1029 / HWP3 vs HWP5 변환본 페이지별 paragraph alignment 차이 (37.5% 정합, 40/64 페이지 미정합) #1035 / 중첩 표 외곽선 미표시 — 1×1 wrapper 외곽 테두리 lookup off-by-one #1043 / 글상자 안 각주 본문 누락 — 페이지 하단 각주 영역 집계 시 Shape 내부 controls 미traverse (footnote-tbox-01.hwpx) #1052: 최신 layout/page/table/text measurement baseline. 후속 renderer PR은 이 기준 위에서 시작합니다.
• table-vpos-01.hwpx p.5 PUA U+F02B1~F02BC 매핑 — 사각형 안 숫자 (한컴 권위) 가 원문자/두부로 출력 #727 / table-in-tbox.hwp 2페이지 글자 크기 이상 — CharShape 적용 영역 결함 #915 / fix(text_measurement): 좁은 구두점 (U+2018/U+2019/U+2027) 폭 분류 + native/WASM 동기화 #1026: text measurement, CharShape offset, PUA fallback 기준. TextRun/GlyphRun gate에서 추적합니다.
• HWPX form-002 변환 HWP 한컴 손상 판정 #852 / HWP3 sample16 Shape/Text 정합 격차 종합 (gradient + border + HEAD numbering + 공백) #1008 / HWP5 변환본 paragraph height 과대 측정 (HWP3 대비 약 2배) — p21 alignment + p23 overflow 야기 #1037 / HWPX slash/backSlash type을 선 종류로 오파싱 → 대각선 없는 셀에 검은 대각선 렌더 #1038: HWPX/HWP form, paragraph, shape, slash/backSlash contract. object/image replay fixture 기준으로 반영합니다.
• [bug, CI 한정] PNG 렌더가 headless macOS 에서 hang — 미설치 폰트 fallback 시 CoreText downloadable lookup IPC 대기 #823: headless macOS PNG hang. native font/resource fallback diagnostics에 반영합니다.
• shortcut.hwp PDF 정합성 잔여 결함 4건 (헤더 표 spacing / 좌여백 / 단 구분선 점선 / 우측탭 오버플로) #842 / shortcut.hwp PDF 정합성: 우측탭 정렬·단 구분선 점선·헤더 바 위치 (#842 중 3건) #843: shortcut.hwp PDF 정합성 기준. PDF export fixture 기준으로 반영합니다.
• 다단: 마지막 단에서 명시적 단 나누기 시 같은 페이지 새 단-밴드 미생성 (shortcut.hwp p3→p4, ≈#768) #846 / shortcut.hwp: 쪽나누기로 시작하는 페이지의 헤더 TAC 띠 ↔ 본문 사이 ~28px gap 미재현 #866 / shortcut.hwp: 페이지 수 7≠8 + 다단 zone 경계에서 잔존 LAYOUT_OVERFLOW 2건 #867 / shortcut.hwp: Task #866 후속 — PartialParagraph 헤더띠 / Table only 페이지첫 / Stage 2 누적 / 점선 길이 #874: shortcut.hwp 다단/page-break/layout 잔여 결함. PDF/layout fixture로 추적합니다.
• HWP3 PUA U+F080F (한컴 굵은 가로선) 글리프 부재 — 머리말/꼬리말 패턴 시각 차이 #826 / HCR Basic-PUA 코드포인트(U+F53A 등) 미렌더 — shortcut.hwp 제목 첫 글자 "흔" 누락 #848: PUA glyph/font 미렌더. text/font/glyph fallback 계획에서 추적합니다.
• HWP3 sample14 의 그림(bin_id=2) 내부 콘텐츠 누락 — 박스 외곽만 렌더, 내부 텍스트 안 보임 #860 / HWP3 sample14 WMF metafile element y 좌표 순서 한컴 반대 — 캡션/박스 위치 어긋남 #864 / HWP3 → HWP5 변환본 (hwp3-sample10-hwp5.hwp) 의 image 누락 — placeholder 만 표시 #873 / [bug] hwp3-sample16.hwp WASM 로드 실패 — RawVec capacity overflow (HWP3 picture record alignment) #877 / WMF 한글 텍스트 y 위치 50% 하단 오프셋 — dominant-baseline + SVG-as-image 호환성 #914: HWP3 picture/WMF/metafile/object replay 문제. P18에는 섞지 않았고 후속 object replay coverage에서 추적합니다.
• BookReview.hwp 글상자 내용이 영역 밖으로 출력되는 회귀 #1187 / Task #1187: BookReview.hwp 글상자 내용 clip 회귀 수정 #1190: BookReview.hwp 글상자 clip 회귀. P21 renderer sweep에서 text box clip baseline으로 반영했습니다.
• task 1139 후속 보정: 3-09월_교육_통합_2023.hwp 19쪽 렌더링 정합 불일치 #1189 / task 1189: task 1139 후속 미주/수식 정합 보정 #1194: 미주/수식 흐름 후속 보정. equation/endnote baseline으로 추적합니다.
• HWPX: 용지 기준 BehindText 그림/표의 z-order가 보존되지 않아 텍스트가 겹침 #1197 / task 1245: 어울림 그림 및 미주 수식 배치 보정 #1250 / Task #1197: HWPX 용지 기준 BehindText 그림/표 z-order 보존 #1252: BehindText, paper object layer, master page z-order. P21 replay-plane/z-order baseline으로 반영했습니다.
• 사각형 글상자 안의 picture click hit-test 미지원 (이중 nested 구조) #1171 / 사각형 글상자 안 picture 클릭 hit-test / 속성 / 삽입 지원 (#1171) #1254, rhwp-studio: 셀 안 picture 복사 (Ctrl+C) 미지원 — copy_control_native 셀 컨텍스트 누락 (#1151 후속) #1161 / feat: 표 셀(중첩 포함) picture 복사(Ctrl+C) 지원 + 떠있는 개체 paste cascade (#1161) #1228, rhwp-studio: exam_social.hwp 중첩 표 셀에서 내부 클립보드 붙여넣기 시 바깥 셀에 삽입됨 #1198 / Task #1198: exam_social.hwp 중첩 표 셀 붙여넣기 경로 보존 #1207, 그림/표/도형의 textFlow 속성이 roundtrip 시 항상 BOTH_SIDES로 초기화됨 #1188 / Task #1188 그림/표/도형의 textFlow 속성이 roundtrip 시 항상 BOTH_SIDES로 초기화됨 #1213: picture/cellPath/textFlow/editing path metadata. object/image replay fixture와 hit-test diagnostics 기준으로 반영합니다.
• HWPX 미주 우측 단 '다른 풀이' 미표시 (3-09월_교육_통합_2022) — 미주 2단 배치/오버플로 조사 #1200 / HWPX curve 도형 <hp:seg> 파싱 — 외곽선(태그 박스) 렌더링 (closes #1200) #1203, HWPX: masterpage XML의 바탕쪽 EVEN/ODD가 파싱·연결되지 않음 #1201 / Task #1201: HWPX masterpage idRef 연결 보강 #1242, HWPX 시리얼라이저에서 탭 폭이 4000으로 고정 #1267, HWPX에서 Bookmark/Field/Hyperlink dispatcher 연결 누락으로 인해 모든 필드 컨트롤 소멸 #1289, Task #1298 (#1289 후속 작업) - fix: HWPX 시리얼라이저 0-length field range fieldBegin/fieldEnd 인터리빙 수정 #1299: HWPX curve/masterpage/tab/field/serializer ordering. layer lowering과 renderer sweep fixture 기준으로 반영합니다.
• HWPX 수식 스크립트 토큰 처리 — root/sqrt glued, rm+bar, prime glued 미렌더 #1204 / HWPX 수식 스크립트 토큰 처리 — root/sqrt glued, rm+bar, prime glued (closes #1204) #1208, 수식 포함 줄의 본문 한글 압축·겹침 — 거짓 오버플로우 (3-09월_교육_통합_2023 6쪽 문26) #1219 / 수식 포함 줄 본문 한글 압축·겹침 해소 (closes #1219) #1223, HWP5 표 셀 세로정렬/줄높이 정합 — z-표 행 압축·열 정렬 어긋남 (3-09월_교육_통합_2023 4쪽 문26) #1221 / HWP5 수식-only 셀 z-표 행 압축 수정 — tac 순서매핑 (closes #1221) #1225, 수식 큰 연산자(Σ/∏/∫) 피연산자 간격 누락 — 시그마가 우측 항에 붙어 렌더 #1233 / 수식 큰 연산자(Σ/∏/∫) 피연산자 간격 추가 (closes #1233) #1235, fix(#1300): 수식 위첨자를 base 상단에 정렬 — 키 큰 base 윗줄 침범 해소 #1301, 수식 무브레이스 첨자 공백 구분 미지원 — 미주 시그마 상·하한 깨짐 (sum_k=1 ^6) #1304 / 수식 괄호 그룹 뒤 위첨자 orphan — (k+1)^2 의 지수가 위로 안 올라감 #1305 / 수식 미주 시그마·괄호 지수 렌더 수정 (#1304, #1305) #1306: equation parsing/layout and TAC ordering baseline. equation/TextRun/GlyphRun fixture 기준으로 반영합니다.
• 폰트 충실도: 한컴 돋움 미설치 시 Noto Sans CJK 대체로 글리프가 PDF보다 크고 두껍게 렌더 #1224 / 폰트 충실도: 한컴 돋움 폴백을 Noto Sans KR ExtraLight로 (closes #1224) #1234: font fallback baseline. text/font/glyph raster expectation 기준으로 반영합니다.
• 미주(해설) 영역 줄간격이 한컴보다 좁게 렌더 — 풀이 페이지 행간 압축 #1236 / 미주(해설) 다줄 문단 줄간격 간헐적 좁음 수정 (closes #1236) #1240, 미주 문제 제목 앞 between-notes margin 누락 — 다줄 문단으로 끝나는 문제 다음 제목이 이전 줄에 붙음 #1238 / Task #1246: 미주 between-notes margin min-gap (HeightCursor) — closes #1238, #1246 #1247, 수식 다행(S=… 등) 줄 병합 — 4줄이 3줄로 렌더 #1239 / 미주 연속 인라인 수식 다행 병합 해소 (closes #1239) #1241, task 1139 후속 보정: 3-09월_교육_통합_2022 7쪽 문25-26 하단 그림 배치 불일치 #1245 / task 1245: 어울림 그림 및 미주 수식 배치 보정 #1250, 미주 모양 UI와 미주 사이/구분선 아래 렌더링이 한컴과 불일치 #1253 / task 1253: 미주 모양 UI와 HWPX 구분선 굵기 정합 #1255, #1274 후속: 교육 통합 HWP/PDF 문항 흐름 drift 검출 고도화 #1284 / task 1284: #1274 후속 교육 통합 문항 흐름 drift 보정 #1292, fix(#1302): 미주 다줄 문단 다음 같은 미주 연속 문단 줄간격 과소 수정 #1303: endnote/question flow and visual sweep baseline. P21 report corpus 기준으로 반영했습니다.
• 확장 프로그램 service worker의 외부 URL fetch 경로 보안 강화 #1307: extension-side URL fetch security hardening. renderer phase는 아니지만 후속 PR 최신화 때 sender/URL/redirect/credentials hardening을 되돌리지 않습니다.

완료 기준

• public Canvas 렌더링이 PageLayerTree 기반으로 안정적으로 동작함
• Canvas legacy vs layer Canvas visual diff pipeline이 CI에서 동작함
• native Skia backend가 feature-gated 상태로 추가되고 기본 PNG 렌더링 테스트를 통과함
• native Skia PNG 경로에서 equation replay가 동작함
• native Skia PNG 경로에서 raw SVG fragment replay가 동작함
• native Skia PNG 경로에서 form control static replay가 동작함
• PageLayerTree JSON / JS export가 backend replay에 필요한 주요 정보를 안정적으로 보존함
• Text IR v2 compatibility contract가 source table, placement/cluster metadata, special visual ops를 함께 보존함
• GlyphRun foundation이 들어가되 TextRun fallback이 유지되고 native Skia는 exact blob-backed typeface replay 전까지 fallback을 유지함
• Text IR v2 diagnostics/schema closure가 fallback reason, feature negotiation, shaped profile boundary, line-break risk telemetry, fallback-free strict guard를 additive textV2 diagnostics contract로 설명함
• GlyphOutline strict sidecar와 backend text variant selection diagnostics가 들어가되 TextRun fallback이 유지됨
• CanvasKit replay policy diagnostics가 devel에 들어가고 hidden overlay inventory가 public API로 노출됨
• Browser CanvasKit renderer가 default/compat 모두 hidden Canvas2D overlay 없이 direct replay backend로 동작함
• CanvasKit direct replay hardening이 bridge fallback, schema sync, direct compat reporting, payload gates, deterministic reject reason을 갖춤
• CanvasKit image replay가 crop/fill-mode/original-size/transform/cache-key를 직접 소비하고, effect/filter gap을 deterministic diagnostics로 남김
• Text/glyph advanced payload gates가 schema minor, feature metadata, Canvas2D/CanvasKit branch parity, deterministic reject reason을 갖추고 COLRv1 solid/linear/radial/sweep subset 외 payload replay를 닫아 둠
• Canvas2D/CanvasKit GlyphOutline replay branch parity가 payloadKind, colorFormat, COLRv1 graph node 기준으로 검증됨
• COLRv1 solid/linear/radial/sweep graph가 CanvasKit direct replay subset과 deterministic reject matrix를 가짐
• glyph payload resource corpus와 font construction proof fixture가 resource identity, cache key, exact typeface construction failure를 검증함
• 작은 renderer baseline manifest가 SVG / Canvas2D / native Skia / CanvasKit을 같은 IR 기준으로 report-first 비교함
• replay-plane ordering, z-order, empty-plane skip, static cache plane key가 backend 공통 helper/fixture로 검증됨
• 주요 fixture에 대한 visual regression 테스트와 performance report가 artifact workflow에서 동작함
• WebGPU/software surface axis와 browser/native renderer baseline report가 artifact workflow에서 동작함
• WebCanvas layer replay가 core leaf PaintOp를 임시 legacy wrapper 없이 직접 소비함
• layer buildOptions / debugOptions / outputOptions metadata가 JSON/JS/Studio 타입과 backend replay semantics에서 일관됨
• CanvasKit direct replay coverage가 page background/vector, equation/formObject, TextRun effects 순서의 Canvas2D-vs-CanvasKit fixture와 diagnostics를 갖춤
• CanvasKit GlyphRun gate와 GlyphOutline strict sidecar가 TextRun fallback, deterministic fallback reason, anchor/fallback/monochrome fill-only 조건을 공유하고 generic Path로 섞이지 않음
• strict BitmapGlyph producer-output corpus가 one-strike resource, deterministic scaling/filtering, color-space default diagnostics, cache-key contract를 검증함
• strict SvgGlyph producer-output corpus가 sanitized static vector resource, required viewBox, hard-false safety flags, no raw SVG replay contract를 검증함
• native variation/TTC real corpus와 CanvasKit exact-construction proof gate가 backend divergence를 deterministic diagnostics로 설명함
• Skia image effect/cache/resource diagnostics와 HWP3 picture / WMF / EMF / OLE native object replay가 fallback을 보존하면서 동작함
• PDF export backend가 단일/다중 페이지, page range, page metadata, vector/raster fallback policy를 안정적으로 처리하고 native binding packaging 기준에서도 설명 가능함
• shapedModern, cross-scope variants, public MixedPerGlyph, 추가 COLRv1 primitive가 concrete corpus/use case 없이 writer emission으로 열리지 않음

참고

• feat: introduce skia renderer #165
• 다양한 렌더러 지원을 위한 PageLayerTree 생성 API 추가 제안 #364
• render: introduce PageLayerTree generation API #419
• render: route Canvas rendering through PageLayerTree #456
• test: add canvas visual diff pipeline #498
• Task #508: PageLayerTree image brightness/contrast JSON 필드 추가 #510
• 멀티 렌더러 지원 트래킹 이슈 #536
• render: add native Skia PNG raster backend #599
• render: replay equations in native Skia PNG output #626
• render: replay raw SVG fragments in native Skia PNG output #720
• Skia form control static replay (P7) #740
• render: harden PageLayerTree schema and resource keys #761
• render: improve Skia text replay parity #769
• render: add Text IR v2 compatibility contract #797
• render: add guarded GlyphRun layer variant contract #840
• render: add Text IR v2 diagnostics and schema closure #881
• render: adopt guarded text variants for backend replay #916
• render: add CanvasKit replay policy diagnostics #925
• render: add browser CanvasKit direct renderer #996
• render: harden CanvasKit direct replay contract #1057
• render: expand CanvasKit image replay coverage #1096
• render: gate advanced glyph outline payloads #1117
• render: add glyph payload resource proof diagnostics #1159
• render: add renderer baseline sweep reports #1312
• render: reduce WebCanvas layer adapter and split option metadata #1346
• render: expose native PDF export API #1359
• 수식 미주 시그마·괄호 지수 렌더 수정 (#1304, #1305) #1306
• 수식 괄호 그룹 뒤 위첨자 orphan — (k+1)^2 의 지수가 위로 안 올라감 #1305
• 수식 무브레이스 첨자 공백 구분 미지원 — 미주 시그마 상·하한 깨짐 (sum_k=1 ^6) #1304
• fix(#1302): 미주 다줄 문단 다음 같은 미주 연속 문단 줄간격 과소 수정 #1303
• fix(#1300): 수식 위첨자를 base 상단에 정렬 — 키 큰 base 윗줄 침범 해소 #1301
• Task #1298 (#1289 후속 작업) - fix: HWPX 시리얼라이저 0-length field range fieldBegin/fieldEnd 인터리빙 수정 #1299
• task 1284: #1274 후속 교육 통합 문항 흐름 drift 보정 #1292
• HWPX에서 Bookmark/Field/Hyperlink dispatcher 연결 누락으로 인해 모든 필드 컨트롤 소멸 #1289
• HWPX 시리얼라이저에서 탭 폭이 4000으로 고정 #1267
• 사각형 글상자 안 picture 클릭 hit-test / 속성 / 삽입 지원 (#1171) #1254
• Task #1197: HWPX 용지 기준 BehindText 그림/표 z-order 보존 #1252
• task 1245: 어울림 그림 및 미주 수식 배치 보정 #1250
• task 1139 후속 보정: 3-09월_교육_통합_2022 7쪽 문25-26 하단 그림 배치 불일치 #1245
• 수식 다행(S=… 등) 줄 병합 — 4줄이 3줄로 렌더 #1239
• 미주 문제 제목 앞 between-notes margin 누락 — 다줄 문단으로 끝나는 문제 다음 제목이 이전 줄에 붙음 #1238
• 수식 큰 연산자(Σ/∏/∫) 피연산자 간격 누락 — 시그마가 우측 항에 붙어 렌더 #1233
• HWP5 표 셀 세로정렬/줄높이 정합 — z-표 행 압축·열 정렬 어긋남 (3-09월_교육_통합_2023 4쪽 문26) #1221
• HWP5 wrap=Square 인라인 표 단락 세로 측정 부족 — 답안/표 행 겹침 (3-09월_교육_통합_2023 4쪽 문26) #1218
• rhwp-studio: 텍스트 입력 시 document-changed 기반 전체 visible page 재렌더로 입력 지연 발생 #1211
• HWPX: masterpage XML의 바탕쪽 EVEN/ODD가 파싱·연결되지 않음 #1201