ohah/hwpjs

✨ Features

• 탭 문자를 `htC` span으로 렌더링
• 테이블 셀 내 gso 이미지(`ShapeComponentPicture`) 렌더링
• 선 도형(`ShapeComponentLine`) SVG 렌더링 구현

🐛 Bug Fixes

• HWP 5.1+ LineSeg 없는 문서의 렌더링 겹침 해결
• 합성 LineSeg 관련 다수 개선
• 글자 폭 근사 기반 줄바꿈 추정 추가
• 테이블/이미지 높이 반영
• line_height 조정 (`text_height × 0.75`)
• 공백 폭 조정 (justify 정렬 보정)
• 개체 마진 보정 및 위치 정확도 개선
• 들여쓰기/내어쓰기(`has_indentation`) 적용
• + 10 more

📦 Chores

• napi-rs 최신 버전 업데이트 및 PDF 모듈 제거
• cargo fmt 적용
• SSR 빌드에서 `@ohah/hwpjs`를 externals로 설정

✨ Features

• 배포용 문서 (Distribution Document) 지원 추가 (#7928524b)

🐛 Bug Fixes

• 테이블 셀 내 GSO 이미지 중복 렌더링 버그 수정 (#d14f9a48, #a5eae450)

📦 Chores

• 브라우저 WASM 불필요한 Buffer polyfill 제거 (#b9efa648)
• 스냅샷 재생성 (#515f7908)
• 릴리스 스킬 추가 및 사용자 확인 체크포인트 추가 (#ae5515ad, #f43f14e4)
• cargo fmt 포맷팅 수정 (#dd36ec62, #814572d9)

📦 Contributors

• @ohah
• @skyisle (Alan Jeon)

💥 Breaking Changes

• PDF 모듈 완전 제거: `printpdf`, `image`, `rusttype` 의존성 및 `viewer/pdf` 코드 삭제. wasm 타겟 호환을 위해 제거되었습니다.

🐛 Bug Fixes

• 테이블 border 렌더링: 한컴 원본과 일치하도록 border 선택 로직 전면 재수정 (#125, #129)
• 인접 셀 border `line_type=0`일 때 반대쪽 셀 border fallback 적용
• 내부 행 경계에서 lower cell Top border 우선 사용
• 외곽 border에서 table default vs cell border 선택 로직 개선
• 가로 외곽선도 열별로 border 확인하여 `line_type=0` 구간 건너뜀
• 테이블 셀 높이: 한컴 원본과 일치하도록 계산 수정 (#118)
• 테이블 오른쪽 외곽선 누락 및 leading 공백 처리 수정
• 중첩 테이블: 파싱/렌더링 지원 (#124)
• + 9 more

📦 Improvements

• napi-rs 업데이트: `napi 3.0.0 → 3.8.3`, `napi-derive 3.0.0 → 3.5.2`, `@napi-rs/cli ^3.2.0 → ^3.5.1`
• border overshoot: `stroke-width/2`로 동적 계산
• 페이지별 HTML 분리 API: `to_html_pages` 추가 및 table-bug 스냅샷 테스트
• 마크다운 뷰어: 하이퍼링크/개요/번호매기기 코드 리뷰 반영 (#113)

📋 What's Changed

• chore(config): exclude dist, legacy, npm from format and lint by @ohah in https://github.com/ohah/hwpjs/pull/4
• docs(config): add hwp 5.0 spec skill split by subsection by @ohah in https://github.com/ohah/hwpjs/pull/5
• fix(core): fix http_quiv typo to http-equiv in HTML meta charset tag by @hulryung in https://github.com/ohah/hwpjs/pull/7
• refactor(core): reduce duplicate LIST_HEADER logic in header/footer/footnote/endnote processing by @ohah in https://github.com/ohah/hwpjs/pull/6
• feat(core): align HTML table output with fixtures (htG only when caption) by @ohah in https://github.com/ohah/hwpjs/pull/9
• feat(core): bundle Liberation Sans for PDF tests and improve image handling by @ohah in https://github.com/ohah/hwpjs/pull/10
• chore(node): disable to-pdf CLI and batch pdf options, document for later by @ohah in https://github.com/ohah/hwpjs/pull/11
• feat(core): match table layout to fixture (table2 DOM order, htb style, htG height) by @ohah in https://github.com/ohah/hwpjs/pull/12
• + 88 more

✨ New Contributors

• @ohah made their first contribution in https://github.com/ohah/hwpjs/pull/4
• @hulryung made their first contribution in https://github.com/ohah/hwpjs/pull/7
• @minozzang508 made their first contribution in https://github.com/ohah/hwpjs/pull/1
• Full Changelog: https://github.com/ohah/hwpjs/compare/@ohah/hwpjs@0.1.0-rc.4...@ohah/hwpjs@0.1.0-rc.7

📋 What's Changed

• chore(config): exclude dist, legacy, npm from format and lint by @ohah in https://github.com/ohah/hwpjs/pull/4
• docs(config): add hwp 5.0 spec skill split by subsection by @ohah in https://github.com/ohah/hwpjs/pull/5
• fix(core): fix http_quiv typo to http-equiv in HTML meta charset tag by @hulryung in https://github.com/ohah/hwpjs/pull/7
• refactor(core): reduce duplicate LIST_HEADER logic in header/footer/footnote/endnote processing by @ohah in https://github.com/ohah/hwpjs/pull/6
• feat(core): align HTML table output with fixtures (htG only when caption) by @ohah in https://github.com/ohah/hwpjs/pull/9
• feat(core): bundle Liberation Sans for PDF tests and improve image handling by @ohah in https://github.com/ohah/hwpjs/pull/10
• chore(node): disable to-pdf CLI and batch pdf options, document for later by @ohah in https://github.com/ohah/hwpjs/pull/11
• feat(core): match table layout to fixture (table2 DOM order, htb style, htG height) by @ohah in https://github.com/ohah/hwpjs/pull/12
• + 59 more

✨ New Contributors

• @ohah made their first contribution in https://github.com/ohah/hwpjs/pull/4
• @hulryung made their first contribution in https://github.com/ohah/hwpjs/pull/7
• Full Changelog: https://github.com/ohah/hwpjs/compare/@ohah/hwpjs@0.1.0-rc.4...@ohah/hwpjs@0.1.0-rc.6

📋 What's Changed

• chore(config): exclude dist, legacy, npm from format and lint by @ohah in https://github.com/ohah/hwpjs/pull/4
• docs(config): add hwp 5.0 spec skill split by subsection by @ohah in https://github.com/ohah/hwpjs/pull/5
• fix(core): fix http_quiv typo to http-equiv in HTML meta charset tag by @hulryung in https://github.com/ohah/hwpjs/pull/7
• refactor(core): reduce duplicate LIST_HEADER logic in header/footer/footnote/endnote processing by @ohah in https://github.com/ohah/hwpjs/pull/6
• feat(core): align HTML table output with fixtures (htG only when caption) by @ohah in https://github.com/ohah/hwpjs/pull/9
• feat(core): bundle Liberation Sans for PDF tests and improve image handling by @ohah in https://github.com/ohah/hwpjs/pull/10
• chore(node): disable to-pdf CLI and batch pdf options, document for later by @ohah in https://github.com/ohah/hwpjs/pull/11
• feat(core): match table layout to fixture (table2 DOM order, htb style, htG height) by @ohah in https://github.com/ohah/hwpjs/pull/12
• + 5 more

✨ New Contributors

• @hulryung made their first contribution in https://github.com/ohah/hwpjs/pull/7
• Full Changelog: https://github.com/ohah/hwpjs/compare/@ohah/hwpjs@0.1.0-rc.4...@ohah/hwpjs@0.1.0-rc.5

📦 ✨ 새로운 기능

• HTML 뷰어 완전 구현: HWP 문서를 HTML로 변환하는 기능 추가
• 섹션 기반 페이지 레이아웃 구현 (mm 단위) [`976f603`](https://github.com/ohah/hwpjs/commit/976f603)
• 머리말/꼬리말 섹션별 렌더링 [`9097f7a`](https://github.com/ohah/hwpjs/commit/9097f7a)
• 페이지 번호 렌더링 지원 [`4b0eff5`](https://github.com/ohah/hwpjs/commit/4b0eff5)
• CSS 클래스 기반 스타일링 시스템 [`d38d1c0`](https://github.com/ohah/hwpjs/commit/d38d1c0)
• ParaShape 및 ParaLineSeg 스타일 적용 [`c8d2bbc`](https://github.com/ohah/hwpjs/commit/c8d2bbc), [`251f3b4`](https://github.com/ohah/hwpjs/commit/251f3b4)
• CLI 명령어 추가: `to-html` 명령어로 HTML 변환 지원 [`7278093`](https://github.com/ohah/hwpjs/commit/7278093)
• NAPI-RS 바인딩: `to_html()` 함수 추가 [`54a7de2`](https://github.com/ohah/hwpjs/commit/54a7de2)
• + 25 more

📦 🐛 버그 수정 (49개)

• 테이블 캡션 마진 계산 수정 [`9e48b90`](https://github.com/ohah/hwpjs/commit/9e48b90)
• 테이블 위치 계산 및 페이지네이션 로직 개선 [`2ae05bb`](https://github.com/ohah/hwpjs/commit/2ae05bb)
• 테이블 캡션이 셀 내용으로 처리되는 문제 수정 [`5a797bc`](https://github.com/ohah/hwpjs/commit/5a797bc)
• 테이블 행 높이 계산: 셀 높이 속성 우선순위 적용 [`0c20678`](https://github.com/ohah/hwpjs/commit/0c20678)
• 테이블 열 위치 계산: 동일 행 셀 사용 [`ed060f6`](https://github.com/ohah/hwpjs/commit/ed060f6)
• 테이블 테두리 렌더링: 오른쪽 가장자리 수직 테두리 항상 그리기 [`a5a31b5`](https://github.com/ohah/hwpjs/commit/a5a31b5)
• 테이블 하단 테두리 항상 그리기 [`8709e4b`](https://github.com/ohah/hwpjs/commit/8709e4b)
• 테이블 셀 높이: 모든 shape 컴포넌트 고려 [`cffd0ff`](https://github.com/ohah/hwpjs/commit/cffd0ff)
• + 35 more

📦 🔧 리팩토링

• HTML 뷰어 모듈화: mod.rs를 별도 모듈로 분리하여 유지보수성 향상 [`52d8683`](https://github.com/ohah/hwpjs/commit/52d8683)
• 테이블 렌더링 모듈 분리: table.rs를 여러 모듈로 분리 [`d503ad0`](https://github.com/ohah/hwpjs/commit/d503ad0), [`d37a92b`](https://github.com/ohah/hwpjs/commit/d37a92b)
• bodytext ctrl_header 모듈 분리: 모듈 폴더로 그룹화 [`d2d4314`](https://github.com/ohah/hwpjs/commit/d2d4314), [`a7bf007`](https://github.com/ohah/hwpjs/commit/a7bf007)
• HTML 뷰어 구조 재구성: 테이블 및 이미지 렌더링 모듈 업데이트 [`b67dec6`](https://github.com/ohah/hwpjs/commit/b67dec6), [`9422ec0`](https://github.com/ohah/hwpjs/commit/9422ec0)
• 공통 뷰어 코어 모듈: Renderer trait을 포함한 공통 코어 모듈 추가 [`b0100a4`](https://github.com/ohah/hwpjs/commit/b0100a4)
• 마크다운 뷰어 리팩토링: 공통 코어 로직 사용 [`cdd2ea2`](https://github.com/ohah/hwpjs/commit/cdd2ea2)
• 함수 파라미터 그룹화: 구조체로 그룹화하여 파라미터 수 감소 [`39b3029`](https://github.com/ohah/hwpjs/commit/39b3029)
• render_table 함수 시그니처 단순화 [`fcc0f99`](https://github.com/ohah/hwpjs/commit/fcc0f99)
• + 11 more

📦 📚 문서 및 테스트

• HTML 뷰어 가이드 및 예제 추가 [`c4fef16`](https://github.com/ohah/hwpjs/commit/c4fef16)
• HTML 뷰어 테스트 규칙 추가 [`b9272c1`](https://github.com/ohah/hwpjs/commit/b9272c1)
• AGENTS.md 구조 단순화 [`ba18670`](https://github.com/ohah/hwpjs/commit/ba18670)
• 함수 파라미터 설계 가이드라인 예제 업데이트 [`a8c8bdd`](https://github.com/ohah/hwpjs/commit/a8c8bdd)
• React Native 예제: ArrayBuffer 사용으로 업데이트 [`294f848`](https://github.com/ohah/hwpjs/commit/294f848)
• 백로그: 완료된 작업 제거 및 현재 작업 업데이트 [`2192f01`](https://github.com/ohah/hwpjs/commit/2192f01), [`4b0d567`](https://github.com/ohah/hwpjs/commit/4b0d567)
• Canvas 및 PDF 뷰어 구조 및 문서 추가 [`492ab6f`](https://github.com/ohah/hwpjs/commit/492ab6f)
• 프로젝트 구조에 CLI 설명 추가 [`8a4d66d`](https://github.com/ohah/hwpjs/commit/8a4d66d)
• + 14 more

📦 🔨 빌드 및 의존성

• 빌드 아티팩트 업데이트 (모든 플랫폼) [`f62ad7d`](https://github.com/ohah/hwpjs/commit/f62ad7d), [`4a148ac`](https://github.com/ohah/hwpjs/commit/4a148ac)
• optionalDependencies 버전을 0.1.0-rc.4로 업데이트 [`8a43102`](https://github.com/ohah/hwpjs/commit/8a43102)
• 버전을 0.1.0-rc.4로 업데이트 [`8200932`](https://github.com/ohah/hwpjs/commit/8200932)
• 사용하지 않는 wasm-runtime 의존성 제거 [`5a8116b`](https://github.com/ohah/hwpjs/commit/5a8116b)

📦 🎯 주요 개선 영역

• 1. HTML 뷰어: 완전한 HTML 변환 기능 구현
• 2. 테이블 렌더링: 대폭 개선된 테이블 렌더링 품질
• 3. 개요 번호: HWP 표준 개요 번호 지원
• 4. 안전성: unsafe 코드 제거 및 메모리 안전성 향상

📦 HTML 뷰어 사용

• ```typescript
• import { toHtml } from '@ohah/hwpjs';
• const html = await toHtml(buffer);
• ```

📦 CLI 사용

• ```bash
• hwpjs to-html input.hwp -o output.html
• hwpjs to-markdown input.hwp -o output.md --save-images
• ```

📦 1. **에러 처리 개선**

• `HwpError` 타입 도입으로 구조화된 에러 처리
• 모든 에러를 `String`에서 `HwpError`로 전환
• `cfb.rs`, `preview_image.rs`, `common.rs` 등 에러 처리 개선
• 릴리스 빌드에서 디버그 로그 비활성화
• 관련 커밋:
• [`70c7dcd`](https://github.com/ohah/hwpjs/commit/70c7dcd) - refactor(core): replace String errors with structured HwpError type
• [`66a8eaf`](https://github.com/ohah/hwpjs/commit/66a8eaf) - refactor(core): update viewer and preview_image error handling to use HwpError
• [`d7bb00f`](https://github.com/ohah/hwpjs/commit/d7bb00f) - style(core): format cfb.rs error handling code
• + 3 more

📦 2. **테스트 구조 개선**

• `lib.rs`에서 테스트를 `tests/` 디렉토리로 분리
• `parse` 메서드를 작은 함수로 분할
• 테스트 파일 정리 (trailing newlines 제거)
• 관련 커밋:
• [`8267d21`](https://github.com/ohah/hwpjs/commit/8267d21) - style(core): remove trailing newlines in test files
• [`f871b93`](https://github.com/ohah/hwpjs/commit/f871b93) - refactor(core): extract tests from lib.rs to tests/ directory
• [`32a52ad`](https://github.com/ohah/hwpjs/commit/32a52ad) - refactor(core): split parse method into smaller functions

📦 3. **Markdown 변환 버그 수정**

• 각주/미주 처리 중복 방지
• 각주/미주 참조 텍스트 보존
• 헤더/푸터 텍스트 중복 방지
• 테이블 셀 내용 중복 방지
• 관련 커밋:
• [`e9855ac`](https://github.com/ohah/hwpjs/commit/e9855ac) - fix(core): prevent footnote/endnote processing in convert_paragraph_to_markdown
• [`b725d56`](https://github.com/ohah/hwpjs/commit/b725d56) - fix(core): preserve footnote/endnote reference text in body paragraphs
• [`4fe5b40`](https://github.com/ohah/hwpjs/commit/4fe5b40) - fix(core): prevent duplicate header/footer text in markdown output
• + 2 more

📦 4. **Markdown 뷰어 리팩토링**

• 문서 구조에 맞게 모듈 재구성
• `document/bodytext/` 구조로 재구성
• `list_header.rs`, `para_text.rs`, `table.rs` 등 이동
• `SHAPE_COMPONENT`에서 `PARA_HEADER` 처리 개선
• 관련 커밋:
• [`6d9cdb6`](https://github.com/ohah/hwpjs/commit/6d9cdb6) - refactor: reorganize markdown viewer modules into document structure
• [`50716c1`](https://github.com/ohah/hwpjs/commit/50716c1) - fix(core): handle PARA_HEADER after LIST_HEADER in SHAPE_COMPONENT
• [`7494a2e`](https://github.com/ohah/hwpjs/commit/7494a2e) - test(core): update markdown snapshot tests
• + 1 more

📦 5. **헤더/푸터 기능 구현**

• 가변 길이 헤더/푸터 파싱 구현
• 헤더/푸터 컨트롤 데이터 구조 파싱
• `ControlMask` 구조체 및 비트 플래그 메서드 구현
• JSON 직렬화에 flags 배열 추가
• `control_mask`를 사용한 Markdown 변환 최적화
• 관련 커밋:
• [`d2162ee`](https://github.com/ohah/hwpjs/commit/d2162ee) - feat(core): implement ControlMask structure with bit flag methods
• [`0679b1e`](https://github.com/ohah/hwpjs/commit/0679b1e) - feat(core): enhance ControlMask JSON serialization with flags array
• + 6 more

📦 6. **각주/미주 기능 개선**

• 8바이트 각주/미주 데이터 파싱을 위한 `FootnoteEndnote` variant 추가
• 각주/미주 파싱 로직 개선
• Markdown 뷰어에서 각주/미주 처리 단순화
• 관련 커밋:
• [`cacb0fc`](https://github.com/ohah/hwpjs/commit/cacb0fc) - fix(core): improve footnote and endnote parsing logic
• [`8d6f1f5`](https://github.com/ohah/hwpjs/commit/8d6f1f5) - chore(core): fix unused variable warnings
• [`91ce50e`](https://github.com/ohah/hwpjs/commit/91ce50e) - test(core): update snapshot files for footnote, endnote, and header/footer
• [`71b053f`](https://github.com/ohah/hwpjs/commit/71b053f) - refactor(core): simplify footnote/endnote handling in markdown viewer
• + 3 more

📦 7. **SummaryInformation 파싱**

• `VT_LPWSTR` 지원 SummaryInformation 파싱 구현
• `parse_summary_information_json` 함수 추가
• `encoding_rs` 의존성 업데이트
• 관련 커밋:
• [`858a031`](https://github.com/ohah/hwpjs/commit/858a031) - feat(core): implement SummaryInformation parsing with VT_LPWSTR support
• [`3293798`](https://github.com/ohah/hwpjs/commit/3293798) - chore: update Cargo.lock for encoding_rs dependency
• [`97b2e79`](https://github.com/ohah/hwpjs/commit/97b2e79) - test: update snapshots with SummaryInformation fields
• [`9d6e767`](https://github.com/ohah/hwpjs/commit/9d6e767) - refactor: simplify SummaryInformation parsing code
• + 1 more

📦 8. **CLI 도구 추가**

• HWP 파일 변환용 CLI 도구 추가
• 명령어: `to-json`, `to-markdown`, `info`, `extract-images`, `batch`
• CLI 문서 및 예제 추가
• `bin/hwpjs.js` 실행 파일 추가
• 관련 커밋:
• [`8e8bc2d`](https://github.com/ohah/hwpjs/commit/8e8bc2d) - feat: add CLI tool for HWP file conversion
• [`5c027d1`](https://github.com/ohah/hwpjs/commit/5c027d1) - docs: add CLI examples and documentation
• [`9cdd20a`](https://github.com/ohah/hwpjs/commit/9cdd20a) - docs: update CLI documentation and remove from backlog
• + 1 more

📦 9. **패키지 최적화**

• 패키지 크기 최적화: 205MB → 131MB
• 패키지 크기 체크 스크립트 추가
• 관련 커밋:
• [`d9af8fc`](https://github.com/ohah/hwpjs/commit/d9af8fc) - perf: optimize package size from 205MB to 131MB
• [`07e8fac`](https://github.com/ohah/hwpjs/commit/07e8fac) - feat: add package size check script

📦 10. **문서 개선**

• 설치 가이드 리팩토링 (통합 install 및 platform tabs)
• API 문서에 플랫폼별 예제 추가
• PlatformTabs 컴포넌트 추가
• 로고 SVG 추가 및 헤더 로고 설정
• MIT 라이선스 파일 추가
• README 및 개발 가이드 업데이트
• 관련 커밋:
• [`e77312d`](https://github.com/ohah/hwpjs/commit/e77312d) - docs: add deployment guide and publish script
• + 27 more

📦 11. **React Native 개선**

• ArrayBuffer 지원 구현 (crabygen 버그 우회)
• `createVecFromSlice` 커스텀 함수 구현
• 관련 커밋:
• [`4792ede`](https://github.com/ohah/hwpjs/commit/4792ede) - fix(react-native): implement ArrayBuffer support with custom createVecFromSlice function
• [`8824a18`](https://github.com/ohah/hwpjs/commit/8824a18) - docs(backlog): update ArrayBuffer implementation status with codegen bug workaround

📦 12. **스펙 문서화**

• 수식 편집기 문서 추가
• 각주/미주 및 ColumnDefinition 데이터 구조 문서 추가
• 관련 커밋:
• [`6c08fda`](https://github.com/ohah/hwpjs/commit/6c08fda) - docs(spec): add comprehensive formula editor documentation
• [`38a5314`](https://github.com/ohah/hwpjs/commit/38a5314) - docs(spec): add FootnoteEndnote and ColumnDefinition data structure documentation

📦 13. **빌드 및 배포**

• 버전 업데이트: 0.1.0-rc.1 → 0.1.0-rc.2
• 빌드 아티팩트 업데이트
• 의존성 업데이트
• 배포 가이드 및 publish 스크립트 추가
• 관련 커밋:
• [`3bfa312`](https://github.com/ohah/hwpjs/commit/3bfa312) - chore(hwpjs): bump version to 0.1.0-rc.2
• [`2919839`](https://github.com/ohah/hwpjs/commit/2919839) - chore: update build artifacts and dependencies
• [`e77312d`](https://github.com/ohah/hwpjs/commit/e77312d) - docs: add deployment guide and publish script

📦 14. **기타**

• `legacy/ruby-hwp` gitignore 추가
• 스냅샷 테스트 파일 대량 업데이트
• 스타일 개선 (CSS, UI 컴포넌트)
• 관련 커밋:
• [`076882f`](https://github.com/ohah/hwpjs/commit/076882f) - chore: add legacy/ruby-hwp to gitignore
• [`025df6c`](https://github.com/ohah/hwpjs/commit/025df6c) - chore: remove legacy/ruby-hwp from git tracking
• [`f297ad6`](https://github.com/ohah/hwpjs/commit/f297ad6) - docs(docs): add platform-specific examples and improve API documentation
• ---

📦 새로 추가된 파일

• `crates/hwp-core/src/error.rs` - 에러 타입 정의
• `crates/hwp-core/src/document/summary_information.rs` - SummaryInformation 파싱
• `packages/hwpjs/bin/hwpjs.js` - CLI 실행 파일
• `packages/hwpjs/src-cli/` - CLI 소스 코드
• `packages/hwpjs/scripts/check-package-size.sh` - 패키지 크기 체크
• `packages/hwpjs/scripts/publish.sh` - 배포 스크립트
• `docs/components/PlatformTabs.tsx` - 플랫폼 탭 컴포넌트
• `crates/hwp-core/tests/` - 테스트 디렉토리 구조

📦 주요 수정 파일

• 모든 `crates/hwp-core/src/` 파일 - 에러 처리 개선
• `crates/hwp-core/src/viewer/markdown/` - 구조 재구성
• `packages/hwpjs/package.json` - 버전 및 의존성 업데이트
• 문서 파일들 - 대폭 개선