fix: HWPX ColorRef 상위 바이트 보존

[dicebattle]

변경 요약

HWPX 색상 문자열 #AARRGGBB를 HWP ColorRef로 변환할 때 상위 바이트를 버리지 않고 보존하도록 수정했습니다.

이번 문제에서는 faceColor="#FF000000" / alpha="0" 조합이 들어간 표 배경이 검정색으로 렌더링되고 있었습니다. 기존 파서는 #FF000000을 0x00000000으로 바꿨고, 이 값이 뒤쪽 렌더링 단계에서 일반 검정 채우기로 처리되었습니다.

style_resolver 쪽에는 이미 ColorRef의 상위 바이트가 0이 아닌 경우 특수값 또는 확장값으로 보고 채우기 없음으로 처리하는 로직이 있으므로, 파서에서 #AARRGGBB를 0xAABBGGRR 형태로 보존하게 바꾸는 것이 가장 작은 수정 범위라고 판단했습니다.

추가로 parse_color_str 단위 테스트에서 #FF000000, #FFFFFFFF, 반투명 예시의 상위 바이트 보존을 검증하도록 기대값을 갱신했습니다.

관련 이슈

closes #606

테스트

• cargo test 통과
• cargo clippy -- -D warnings 통과
• 관련 샘플 파일로 SVG 내보내기 확인
  • 123kb.hwp 2페이지: rect fill="#000000" 65개 → 0개
  • 74kb.hwp 1페이지: rect fill="#000000" 31개 → 0개
• 웹(WASM) 렌더링 확인 (이번 검증은 CLI export-svg / export-pdf 경로에서 수행했습니다)

추가로 실행한 검증:

• cargo test --lib
• cargo test --test svg_snapshot
• cargo build --release --bin rhwp
• target/release/rhwp export-pdf로 두 샘플 PDF 재생성 후 비교

스크린샷

123kb.hwp 2페이지

74kb.hwp 1페이지

---

이 PR의 코드 변경과 본문 작성에는 AI 도구(Codex)가 사용되었습니다.

[edwardkim]

@dicebattle 님 안녕하세요. 첫 PR 환영합니다. 검토 진행 중 안내 한 가지 드립니다.

시각 판정 자료 영역

본 PR 의 본질 (#AARRGGBB 8자리 색상 상위 바이트 보존) + Issue #606 의 자기 진단 (PR 본문 전부 한글 + before/after 정량 측정 + 검증 결과까지) 모두 매우 정합하게 작성되어 있어 본 환경 결정적 검증 (cargo test 1140 passed / clippy 0 / svg_snapshot 6/6 / 광범위 페이지네이션 sweep 164 fixture 회귀 0) 통과를 확인했습니다.

다만 본 환경 samples/ 폴더에 123kb.hwp / 74kb.hwp 샘플이 없어 메인테이너 직접 시각 판정이 어려운 상황입니다. 본 환경 fixture 11개 (HWPX 6 + exam_* 5) 측정 결과 BEFORE/AFTER 모두 rect fill="#000000" 0건으로 동일하여, 이 결함이 발현되는 faceColor="#FF000000" + alpha="0" 조합 자체가 흔치 않은 엣지 케이스로 확인됩니다.

보완 요청 사항

본 PR 머지 전 가능하다면 다음 두 가지 함께 부탁드립니다:

1. 샘플 파일 동봉 — 123kb.hwp / 74kb.hwp 를 PR 에 포함해주시면 (samples/ 폴더 또는 별도 samples/issue-606/ 영역) 메인테이너가 직접 시각 판정 가능 + 본 사이클 회귀 차단 영역으로 영구 보존
2. 한컴 버전 정보 — 두 샘플 파일이 한컴 한글 어떤 버전 (예: 2018 / 2020 / 2022 / 웹기안기 / 한컴오피스 X 등) 으로 작성/저장됐는지 알려주시면 좋겠습니다 (#AARRGGBB + alpha="0" 조합이 어떤 작성 환경에서 발현되는지 영역 정합)

이 두 자료가 추가되면 본 PR 의 본질 영역 (HWPX 8자리 색상 + 알파 채널) 회귀 차단 가드로 영구 보존되어, 향후 다른 영역 정정에서도 본 결함 재발 차단이 가능해집니다.

본 환경 측정 요약 (참고)

• cargo test --lib --release: 1140 passed (회귀 0)
• cargo clippy --release --lib: 0건
• cargo test --release --test svg_snapshot --test issue_546 --test issue_554: 모두 통과
• 광범위 페이지네이션 sweep: 164 fixture / 1,684 페이지 / 차이 0
• Docker WASM 빌드: 4,588,198 bytes
• 본 환경 11 fixture rect fill="#000000" 측정: BEFORE 0 / AFTER 0 (본 환경 미발현)

본 PR 의 진단 (HWP5 read_color_ref 는 4바이트 그대로 보존하는데 HWPX parse_color_str 만 상위 바이트 손실 → HWP5/HWPX 비정합) + 정정 (#AARRGGBB → 0xAABBGGRR 보존) 의 본질이 매우 정확합니다. style_resolver.rs:700 의 (s.background_color >> 24) != 0 체크가 이미 의도된 fix 영역으로 자리잡고 있어 본 PR 의 작은 변경 (단일 함수 +9/-5) 으로 깨끗하게 해결되는 패턴이 우수합니다.

샘플 파일 + 한컴 버전 정보 추가 후 메인테이너 시각 판정 → 머지 단계로 진행하겠습니다. 수고하셨습니다.

[dicebattle]

준비해서 보강하겠습니다. 코멘트 감사드립니다.