WIP Android HWP · HWPX 보기 1단계 (관리자 지시 10/20): rhwp v0.8.7 (MIT, 커밋 1a76570 고정) 를 얇은 C ABI (tool/rhwp_ffi) 와 함께 NDK 로 빌드 (tool/build_rhwp_android.sh - git sparse 받기 · Rust 1.93.1 · Cargo.lock --locked · 16KB 정렬 · 경로 /jj 로 바꿈) → APK 의 libjj_rhwp.so 를 dart:ffi 로 · 보기 화면 HwpSource: 보는 쪽의 5쪽 묶음만 PDF 로 바꾸고 다음 묶음을 미리, 묶음마다 3분 제한, 실패한 묶음은 그 쪽에 이유 · 다시 보면 다시 · 닫으면 멈춤 · 파일 탐색기: 보기 컴포넌트를 켰을 때 앱 안에서, 열지 못하면 이유를 알리고 다른 앱으로 · 문서의 가로 쪽은 자동으로 반 나누지 않음 (내 판단) · 라이선스 화면 · Android 고지 · 시험 hwp_source_test (가짜 엔진, Windows 통합) (검토 대기)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 17:43:20 +09:00 · 2026-10-20 17:43:20 +09:00 · ced0ae9e5d
parent 4b450e2e5c
commit ced0ae9e5d
18 changed files with 2923 additions and 2 deletions
--- a/android/app/build.gradle.kts
+++ b/android/app/build.gradle.kts
@ -67,9 +67,12 @@ android {
    sourceSets["main"].jniLibs.srcDir("../../third_party/tor/android")
    // 86: 7-Zip 25.01 (lib7zz.so 라는 이름의 실행 파일 - 7z · RAR 풀기): tool/build_7zz_android.sh (공식 소스, SHA-256 고정)
    sourceSets["main"].jniLibs.srcDir("../../third_party/7zip/android")
+    // 관리자 지시 (10/20): HWP · HWPX → PDF (libjj_rhwp.so - dart:ffi 로 읽는 라이브러리): tool/build_rhwp_android.sh (rhwp v0.8.7, 커밋 고정)
+    sourceSets["main"].jniLibs.srcDir("../../third_party/rhwp/android")
    // 195: third_party 의 실행 파일은 third_party_libs.txt 에 적은 것만 (공유 폴더에 다른 판이 있어도 섞이지 않게)
    val thirdPartyLibs = file("third_party_libs.txt").readLines().map { it.trim() }.filter { it.isNotEmpty() && !it.startsWith("#") }.toSet()
-    listOf("../../third_party/rsync/android", "../../third_party/sdcpp/android", "../../third_party/tor/android", "../../third_party/7zip/android").forEach { dir ->
+    listOf("../../third_party/rsync/android", "../../third_party/sdcpp/android", "../../third_party/tor/android", "../../third_party/7zip/android",
+        "../../third_party/rhwp/android").forEach { dir ->
        fileTree(dir).matching { include("**/*.so") }.forEach { so ->
            if (so.name !in thirdPartyLibs) packaging.jniLibs.excludes += "**/${so.name}"
        }
--- a/android/app/third_party_libs.txt
+++ b/android/app/third_party_libs.txt
@ -7,3 +7,4 @@ libsdcli.so
 libsdcli_v80.so
 libtor.so
 lib7zz.so
+libjj_rhwp.so
--- a/assets/l10n/en.json
+++ b/assets/l10n/en.json
@ -545,6 +545,7 @@
 "{0}: 작업 중이라 옮기지 않았습니다": "{0}: not moved because it is being processed",
 "{0}: 저장하지 않았습니다": "{0}: not saved",
 "{0}: 체크한 동영상 {1}개를 {2} 로 옮깁니다": "{0}: moves the {1} checked videos to {2}",
+ "{0}~{1}쪽을 {2}초 안에 바꾸지 못했습니다": "Couldn't convert pages {0}-{1} within {2} s",
 "{0}개": "{0}",
 "{0}개 ZIP 으로 묶기": "Compress {0} items to ZIP",
 "{0}개 · {1}": "{0} · {1}",
@ -1024,6 +1025,7 @@
 "단축키 - Total Commander: F5 복사 · F6 이동 · F7 새 폴더 · F8 지우기 · Insert/Space 표시 · Ctrl+R 새로 고침. 그 밖: Ctrl+C · X · V (복사 · 잘라내기 · 붙여넣기) · Ctrl+A 모두 표시 · F5 새로 고침": "Shortcuts - Total Commander: F5 copy · F6 move · F7 new folder · F8 delete · Insert/Space mark · Ctrl+R refresh. Others: Ctrl+C · X · V (copy · cut · paste) · Ctrl+A mark all · F5 refresh",
 "단축키 해제": "Unregister hotkey",
 "닫기": "Close",
+ "닫힌 문서입니다": "The document is closed",
 "닫힘 (실행 안 함)": "Closed (not run)",
 "담아 두고 붙여넣기 (기본)": "Hold and paste (default)",
 "답이 없습니다": "No answer",
@ -1786,6 +1788,7 @@
 "앱 안 브라우저의 쿠키 (로그인) · 사이트 데이터 · 캐시 · 방문 기록과, 다운로드용으로 내보낸 쿠키 파일을 지웁니다. 사이트에 다시 로그인해야 합니다. 즐겨찾기는 그대로입니다.": "Deletes the in-app browser's cookies (logins), site data, cache and history, plus the cookie file exported for downloads. You'll need to log in to sites again. Bookmarks are kept.",
 "앱 안 웹 브라우저 · 즐겨찾기 · 동영상 다운로드": "In-app web browser · bookmarks · video downloads",
 "앱 안 웹 브라우저: [건너뛰기] 를 대신 누르고, 건너뛸 수 없는 광고는 소리를 끄고 빨리 넘깁니다 (넘기는 동안 화면 위쪽에 \"광고 건너뛰는 중…\")": "In-app web browser: presses [Skip] for you, and mutes and fast-forwards ads that can't be skipped (\"Skipping ad…\" shows at the top while skipping)",
+ "앱 안에서 열지 못해 다른 앱으로 엽니다: {0}": "Couldn't open it in the app, opening with another app: {0}",
 "앱 지우기": "Uninstall app",
 "앱 휴지통에 {0}일 두었다가 지웁니다 (탐색기 [휴지통] 에서 되살리기).": "Kept in the app trash for {0} days, then deleted (restore from [Trash] in the explorer).",
 "앱에 들어 있는 것 (기본)": "Built into the app (default)",
@ -1825,6 +1828,7 @@
 "엔진": "Engine",
 "여기까지 범위 고르기": "Select range up to here",
 "여기에 놓으면 MKV 만들기의 동영상 목록에 추가합니다": "Drop here to add to the Make MKV video list",
+ "여는 중: {0}": "Opening: {0}",
 "여러 개를 골랐을 때": "When several are selected",
 "여러 동영상을 MKV 로 만들 때 동시에 처리할 개수 (재인코딩은 CPU 를 많이 씁니다)": "How many to process at once when making several videos into MKV (re-encoding uses a lot of CPU)",
 "여러 번 틀려 {0}초 뒤에 다시 넣을 수 있습니다": "Too many wrong tries. You can try again in {0} s",
--- a/assets/l10n/ja.json
+++ b/assets/l10n/ja.json
@ -545,6 +545,7 @@
 "{0}: 작업 중이라 옮기지 않았습니다": "{0}: 作業中のため移動しませんでした",
 "{0}: 저장하지 않았습니다": "{0}: 保存しませんでした",
 "{0}: 체크한 동영상 {1}개를 {2} 로 옮깁니다": "{0}: チェックした動画 {1}個を {2} に移動します",
+ "{0}~{1}쪽을 {2}초 안에 바꾸지 못했습니다": "{0}~{1} ページを {2} 秒以内に変換できませんでした",
 "{0}개": "{0}個",
 "{0}개 ZIP 으로 묶기": "{0} 件を ZIP にまとめる",
 "{0}개 · {1}": "{0}個・{1}",
@ -1024,6 +1025,7 @@
 "단축키 - Total Commander: F5 복사 · F6 이동 · F7 새 폴더 · F8 지우기 · Insert/Space 표시 · Ctrl+R 새로 고침. 그 밖: Ctrl+C · X · V (복사 · 잘라내기 · 붙여넣기) · Ctrl+A 모두 표시 · F5 새로 고침": "ショートカット - Total Commander: F5 コピー · F6 移動 · F7 新しいフォルダー · F8 削除 · Insert/Space マーク · Ctrl+R 更新。その他: Ctrl+C · X · V (コピー · 切り取り · 貼り付け) · Ctrl+A すべてマーク · F5 更新",
 "단축키 해제": "ショートカット解除",
 "닫기": "閉じる",
+ "닫힌 문서입니다": "文書は閉じられています",
 "닫힘 (실행 안 함)": "閉じた (実行しない)",
 "담아 두고 붙여넣기 (기본)": "保持して貼り付け (既定)",
 "답이 없습니다": "応答がありません",
@ -1786,6 +1788,7 @@
 "앱 안 브라우저의 쿠키 (로그인) · 사이트 데이터 · 캐시 · 방문 기록과, 다운로드용으로 내보낸 쿠키 파일을 지웁니다. 사이트에 다시 로그인해야 합니다. 즐겨찾기는 그대로입니다.": "アプリ内ブラウザの Cookie (ログイン)・サイトデータ・キャッシュ・閲覧履歴と、ダウンロード用に書き出した Cookie ファイルを削除します。サイトへの再ログインが必要です。お気に入りはそのままです。",
 "앱 안 웹 브라우저 · 즐겨찾기 · 동영상 다운로드": "アプリ内 Web ブラウザー・ブックマーク・動画ダウンロード",
 "앱 안 웹 브라우저: [건너뛰기] 를 대신 누르고, 건너뛸 수 없는 광고는 소리를 끄고 빨리 넘깁니다 (넘기는 동안 화면 위쪽에 \"광고 건너뛰는 중…\")": "アプリ内ウェブブラウザー:［スキップ］を代わりに押し、スキップできない広告は音を消して早送りします（スキップ中は画面上部に「広告をスキップ中…」）",
+ "앱 안에서 열지 못해 다른 앱으로 엽니다: {0}": "アプリ内で開けないため、他のアプリで開きます: {0}",
 "앱 지우기": "アプリを削除",
 "앱 휴지통에 {0}일 두었다가 지웁니다 (탐색기 [휴지통] 에서 되살리기).": "アプリのゴミ箱に {0} 日間置いてから削除します (エクスプローラーの [ゴミ箱] から復元できます)。",
 "앱에 들어 있는 것 (기본)": "アプリに内蔵 (既定)",
@ -1825,6 +1828,7 @@
 "엔진": "エンジン",
 "여기까지 범위 고르기": "ここまで範囲選択",
 "여기에 놓으면 MKV 만들기의 동영상 목록에 추가합니다": "ここにドロップすると MKV 作成の動画リストに追加します",
+ "여는 중: {0}": "開いています: {0}",
 "여러 개를 골랐을 때": "複数選んだとき",
 "여러 동영상을 MKV 로 만들 때 동시에 처리할 개수 (재인코딩은 CPU 를 많이 씁니다)": "複数の動画を MKV にするとき同時に処理する数（再エンコードは CPU を多く使います）",
 "여러 번 틀려 {0}초 뒤에 다시 넣을 수 있습니다": "何度も間違えたため {0} 秒後に再入力できます",
--- a/assets/l10n/zh-Hans.json
+++ b/assets/l10n/zh-Hans.json
@ -545,6 +545,7 @@
 "{0}: 작업 중이라 옮기지 않았습니다": "{0}: 正在处理，未移动",
 "{0}: 저장하지 않았습니다": "{0}：未保存",
 "{0}: 체크한 동영상 {1}개를 {2} 로 옮깁니다": "{0}: 将勾选的 {1} 个视频移到 {2}",
+ "{0}~{1}쪽을 {2}초 안에 바꾸지 못했습니다": "无法在 {2} 秒内转换第 {0}~{1} 页",
 "{0}개": "{0} 个",
 "{0}개 ZIP 으로 묶기": "将 {0} 项压缩为 ZIP",
 "{0}개 · {1}": "{0} 个 · {1}",
@ -1024,6 +1025,7 @@
 "단축키 - Total Commander: F5 복사 · F6 이동 · F7 새 폴더 · F8 지우기 · Insert/Space 표시 · Ctrl+R 새로 고침. 그 밖: Ctrl+C · X · V (복사 · 잘라내기 · 붙여넣기) · Ctrl+A 모두 표시 · F5 새로 고침": "快捷键 - Total Commander: F5 复制 · F6 移动 · F7 新建文件夹 · F8 删除 · Insert/Space 标记 · Ctrl+R 刷新。其他: Ctrl+C · X · V (复制 · 剪切 · 粘贴) · Ctrl+A 全部标记 · F5 刷新",
 "단축키 해제": "注销快捷键",
 "닫기": "关闭",
+ "닫힌 문서입니다": "文档已关闭",
 "닫힘 (실행 안 함)": "已关闭 (未执行)",
 "담아 두고 붙여넣기 (기본)": "暂存后粘贴 (默认)",
 "답이 없습니다": "没有应答",
@ -1786,6 +1788,7 @@
 "앱 안 브라우저의 쿠키 (로그인) · 사이트 데이터 · 캐시 · 방문 기록과, 다운로드용으로 내보낸 쿠키 파일을 지웁니다. 사이트에 다시 로그인해야 합니다. 즐겨찾기는 그대로입니다.": "删除应用内浏览器的 Cookie (登录) · 网站数据 · 缓存 · 浏览记录，以及为下载导出的 Cookie 文件。需要重新登录网站。收藏保持不变。",
 "앱 안 웹 브라우저 · 즐겨찾기 · 동영상 다운로드": "应用内浏览器 · 书签 · 视频下载",
 "앱 안 웹 브라우저: [건너뛰기] 를 대신 누르고, 건너뛸 수 없는 광고는 소리를 끄고 빨리 넘깁니다 (넘기는 동안 화면 위쪽에 \"광고 건너뛰는 중…\")": "应用内网页浏览器: 代为点击［跳过］，无法跳过的广告会静音并快进（跳过时屏幕顶部显示“正在跳过广告…”）",
+ "앱 안에서 열지 못해 다른 앱으로 엽니다: {0}": "无法在应用内打开，改用其他应用打开: {0}",
 "앱 지우기": "卸载应用",
 "앱 휴지통에 {0}일 두었다가 지웁니다 (탐색기 [휴지통] 에서 되살리기).": "在应用回收站保留 {0} 天后删除 (可在资源管理器的 [回收站] 中还原)。",
 "앱에 들어 있는 것 (기본)": "应用内置 (默认)",
@ -1825,6 +1828,7 @@
 "엔진": "引擎",
 "여기까지 범위 고르기": "选择到此处的范围",
 "여기에 놓으면 MKV 만들기의 동영상 목록에 추가합니다": "拖放到此处即可加入制作 MKV 的视频列表",
+ "여는 중: {0}": "正在打开: {0}",
 "여러 개를 골랐을 때": "选择多个时",
 "여러 동영상을 MKV 로 만들 때 동시에 처리할 개수 (재인코딩은 CPU 를 많이 씁니다)": "将多个视频制作成 MKV 时同时处理的数量（重新编码会占用大量 CPU）",
 "여러 번 틀려 {0}초 뒤에 다시 넣을 수 있습니다": "错误次数过多，{0} 秒后可再次输入",
--- a/assets/licenses/RHWP_LICENSES.txt
+++ b/assets/licenses/RHWP_LICENSES.txt
@ -0,0 +1,278 @@
+rhwp v0.8.7 (https://github.com/edwardkim/rhwp, commit 1a76570e833917d15817415a53c09ad61ab3203f)
+Android: libjj_rhwp.so (HWP / HWPX -> PDF), built by tool/build_rhwp_android.sh with tool/rhwp_ffi
+
+MIT License
+
+Copyright (c) 2025-2026 Edward Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---------------------------------------------------------------------
+rhwp THIRD_PARTY_LICENSES.md
+---------------------------------------------------------------------
+
+# Third-Party Licenses
+
+rhwp 프로젝트가 사용하는 서드파티 라이브러리 및 리소스의 라이선스 목록이다.
+
+기준 파일:
+
+- `Cargo.toml` / `Cargo.lock` (`rhwp` v0.8.7)
+- `rhwp-studio/package.json` / `rhwp-studio/package-lock.json`
+- `rhwp-chrome/package.json` / `rhwp-chrome/package-lock.json`
+- `rhwp-firefox/package.json` / `rhwp-firefox/package-lock.json`
+- `rhwp-vscode/package.json` / `rhwp-vscode/package-lock.json`
+- `assets/fonts/FONTS.md`
+
+---
+
+## Rust 크레이트
+
+### 직접 의존성
+
+| 크레이트 | 버전 | 라이선스 | 저장소 | 비고 |
+|---------|------|---------|--------|------|
+| aes | 0.9.2 | MIT OR Apache-2.0 | RustCrypto/block-ciphers | HWPX 암호화 |
+| base64 | 0.23.1 | MIT OR Apache-2.0 | marshallpierce/rust-base64 | Base64 인코딩 |
+| blake3 | 1.8.6 | CC0-1.0 OR Apache-2.0 OR Apache-2.0 WITH LLVM-exception | BLAKE3-team/BLAKE3 | 해시/진단 |
+| byteorder | 1.5.0 | Unlicense OR MIT | BurntSushi/byteorder | 바이너리 endian 처리 |
+| cbc | 0.2.1 | MIT OR Apache-2.0 | RustCrypto/block-modes | HWPX 암호화 모드 |
+| cfb | 0.14.0 | MIT | mdsteele/rust-cfb | OLE Compound File |
+| cipher | 0.5.2 | MIT OR Apache-2.0 | RustCrypto/traits | 암호 trait |
+| codepage | 0.1.2 | Apache-2.0 OR MIT | hsivonen/codepage | 코드페이지 처리 |
+| console_error_panic_hook | 0.1.7 | Apache-2.0/MIT | rustwasm/console_error_panic_hook | WASM panic hook |
+| crc32fast | 1.5.0 | MIT OR Apache-2.0 | srijs/rust-crc32fast | HWP3 암호 키 검증 |
+| des | 0.9.0 | MIT OR Apache-2.0 | RustCrypto/block-ciphers | HWP3 암호화 |
+| ed25519-dalek | 2.2.0 | BSD-3-Clause | dalek-cryptography/curve25519-dalek | capsule 서명 |
+| embedded-io | 0.7.1 | MIT OR Apache-2.0 | rust-embedded/embedded-hal | IO trait |
+| encoding_rs | 0.8.35 | (Apache-2.0 OR MIT) AND BSD-3-Clause | hsivonen/encoding_rs | 문자 인코딩 |
+| flate2 | 1.1.9 | MIT OR Apache-2.0 | rust-lang/flate2-rs | 압축/해제 |
+| getrandom | 0.4.3 | MIT OR Apache-2.0 | rust-random/getrandom | 서명 키 난수 생성 |
+| hmac | 0.13.0 | MIT OR Apache-2.0 | RustCrypto/MACs | HWPX 무결성 |
+| image | 0.25.10 | MIT OR Apache-2.0 | image-rs/image | BMP/JPEG/PNG 디코딩 |
+| js-sys | 0.3.102 | MIT OR Apache-2.0 | rustwasm/wasm-bindgen | WASM JS interop |
+| paste | 1.0.15 | MIT OR Apache-2.0 | dtolnay/paste | 매크로 보조 |
+| pbkdf2 | 0.13.0 | MIT OR Apache-2.0 | RustCrypto/password-hashes | HWPX 키 파생 |
+| pcx | 0.2.5 | MIT OR Apache-2.0 OR WTFPL | kryptan/pcx | PCX 이미지 디코딩 |
+| pdf-writer | 0.12.1 | MIT OR Apache-2.0 | typst/pdf-writer | PDF 출력 |
+| quick-xml | 0.41.0 | MIT | tafia/quick-xml | HWPX XML 파싱 |
+| resvg | 0.47.0 | Apache-2.0 OR MIT | linebender/resvg | native-skia SVG raster (optional) |
+| roxmltree | 0.21.1 | MIT OR Apache-2.0 | RazrFalcon/roxmltree | XML 검증·정규화 |
+| serde | 1.0.229 | MIT OR Apache-2.0 | serde-rs/serde | 직렬화 |
+| serde_json | 1.0.151 | MIT OR Apache-2.0 | serde-rs/json | JSON 직렬화 |
+| sha1 | 0.11.0 | MIT OR Apache-2.0 | RustCrypto/hashes | HWPX 암호 키 파생 |
+| sha2 | 0.11.0 | MIT OR Apache-2.0 | RustCrypto/hashes | 서명·CAS 해시 |
+| skia-safe | 0.99.0 | MIT | rust-skia/rust-skia | native-skia PNG/PDF backend (optional) |
+| snafu | 0.9.2 | MIT OR Apache-2.0 | shepmaster/snafu | 에러 처리 |
+| strum | 0.28.0 | MIT | Peternator7/strum | enum derive |
+| subsecond | 0.7.10 | MIT OR Apache-2.0 | DioxusLabs/dioxus | 개발 핫패치 (optional) |
+| subsetter | 0.2.6 | MIT OR Apache-2.0 | typst/subsetter | 폰트 subset |
+| svg2pdf | 0.13.0 | MIT OR Apache-2.0 | typst/svg2pdf | SVG → PDF |
+| svgtypes | 0.16.1 | Apache-2.0 OR MIT | linebender/svgtypes | SVG 값 파싱 |
+| ttf-parser | 0.25.1 | MIT OR Apache-2.0 | harfbuzz/ttf-parser | 폰트 파싱 |
+| unicode-properties | 0.1.4 | MIT OR Apache-2.0 | unicode-rs/unicode-properties | 유니코드 문자 분류 |
+| unicode-segmentation | 1.13.3 | MIT OR Apache-2.0 | unicode-rs/unicode-segmentation | grapheme/word segmentation |
+| unicode-width | 0.2.2 | MIT OR Apache-2.0 | unicode-rs/unicode-width | 문자 폭 계산 |
+| usvg | 0.45.1 | Apache-2.0 OR MIT | linebender/resvg | SVG 파싱 |
+| wasm-bindgen | 0.2.125 | MIT OR Apache-2.0 | rustwasm/wasm-bindgen | WASM binding |
+| wasm-bindgen-test | 0.3.75 | MIT OR Apache-2.0 | rustwasm/wasm-bindgen | WASM 테스트 |
+| web-sys | 0.3.102 | MIT OR Apache-2.0 | rustwasm/wasm-bindgen | Web API binding |
+| zip | 8.6.0 | MIT | zip-rs/zip2 | HWPX ZIP 처리 |
+
+### 전체 Rust 의존성 요약
+
+`cargo metadata --locked` 기준 package entry는 247개이며, 그중 registry 또는 Git
+source를 가진 외부 Rust 크레이트는 243개다. 나머지 4개는 현재 workspace 패키지다.
+
+주요 라이선스군:
+
+- MIT / Apache-2.0 dual license 계열
+- MIT 단독
+- Apache-2.0 OR MIT
+- BSD-2-Clause / BSD-3-Clause
+- Zlib
+- Unlicense
+- 0BSD
+- ISC
+- Unicode-DFS-2016
+- CC0-1.0 / Apache-2.0 WITH LLVM-exception (`blake3`)
+- WTFPL 대체 선택지 포함 (`pcx`, MIT/Apache 선택 가능)
+
+> 모든 Rust 의존성은 MIT, Apache-2.0, BSD, Zlib, Unlicense, 0BSD, ISC 등 permissive license 계열이거나
+> permissive option을 포함하며, rhwp의 MIT 라이선스와 호환된다.
+
+---
+
+## npm 패키지
+
+### npm 배포 패키지
+
+| 패키지 | 버전 | 라이선스 | 용도 |
+|--------|------|---------|------|
+| @rhwp/core | 0.8.6 | MIT | WASM parser/renderer API |
+| @rhwp/editor | 0.8.6 | MIT | iframe 기반 웹 에디터 wrapper |
+
+### rhwp-studio
+
+| 패키지 | Lock 버전 | 라이선스 | 용도 |
+|--------|-----------|---------|------|
+| canvaskit-wasm | 0.42.0 | BSD-3-Clause | CanvasKit 렌더링 backend |
+| @noble/hashes | 2.4.0 | MIT | 렌더 리소스 키와 문서 digest |
+| @types/chrome | 0.2.5 | MIT | Chrome API 타입 |
+| pixelmatch | 7.2.0 | ISC | 시각 diff 픽셀 비교 |
+| pngjs | 7.0.0 | MIT | 시각 diff PNG 처리 |
+| puppeteer-core | 25.5.0 | Apache-2.0 | E2E 테스트 / CDP 연결 |
+| typescript | 7.0.2 | Apache-2.0 | TypeScript 컴파일 |
+| vite | 8.2.1 | MIT | 개발 서버 + 빌드 |
+| vite-plugin-pwa | 1.3.0 | MIT | PWA 빌드 보조 |
+| workbox-window | 7.4.1 | MIT | Service worker runtime 보조 |
+
+### rhwp-chrome / rhwp-firefox
+
+| 패키지 | Lock 버전 | 라이선스 | 용도 |
+|--------|-----------|---------|------|
+| typescript | 7.0.2 | Apache-2.0 | TypeScript 컴파일 |
+| vite | 8.2.1 | MIT | 확장 번들 빌드 |
+
+### rhwp-vscode
+
+| 패키지 | Lock 버전 | 라이선스 | 용도 |
+|--------|-----------|---------|------|
+| @types/node | 18.15.13 | MIT | Node.js 타입 |
+| @types/vscode | 1.82.0 | MIT | VS Code API 타입 |
+| @typescript/native | 7.0.2 | Apache-2.0 | TypeScript native preview 컴파일러 |
+| copy-webpack-plugin | 14.0.0 | MIT | Webpack 파일 복사 |
+| null-loader | 4.0.1 | MIT | Webpack 로더 |
+| ts-loader | 9.6.2 | MIT | Webpack TypeScript 로더 |
+| typescript | 6.0.2 | Apache-2.0 | TypeScript 컴파일 |
+| webpack | 5.109.2 | MIT | 번들러 |
+| webpack-cli | 7.2.2 | MIT | Webpack CLI |
+| @noble/hashes | 2.4.0 | MIT | 문서 digest |
+| canvaskit-wasm | 0.42.0 | BSD-3-Clause | 자동 선택 CanvasKit backend |
+
+### rhwp-shared
+
+`rhwp-shared`는 현재 별도 외부 npm 의존성이 없는 shared source package다.
+
+---
+
+## 웹 폰트 및 폰트 리소스
+
+`assets/fonts/`에 포함된 canonical 폰트 목록이다. 저작권 보호가 필요한 한컴/Microsoft 폰트는 Git에
+포함하지 않으며, 세부 파일 목록과 폴백 관계는 `assets/fonts/FONTS.md`를 참조한다.
+
+| 폰트/리소스 | 라이선스 | 출처 | 비고 |
+|-------------|---------|------|------|
+| Pretendard (9종) | SIL Open Font License 1.1 | github.com/orioncactus/pretendard | Sans-serif fallback |
+| Noto Serif KR (2종) | SIL Open Font License 1.1 | Google Fonts | Serif fallback |
+| Noto Sans KR (3종) | SIL Open Font License 1.1 | Google Fonts | Sans-serif fallback |
+| Nanum Myeongjo (3종) | SIL Open Font License 1.1 | Google Fonts | Serif fallback |
+| Nanum Gothic (3종) | SIL Open Font License 1.1 | Google Fonts | Sans-serif fallback |
+| Nanum Gothic Coding (2종) | SIL Open Font License 1.1 | Google Fonts | Monospace fallback |
+| Gowun Batang (2종) | SIL Open Font License 1.1 | Google Fonts | Serif fallback |
+| Gowun Dodum | SIL Open Font License 1.1 | Google Fonts | Sans-serif fallback |
+| D2 Coding (2종) | SIL Open Font License 1.1 | NAVER | Monospace fallback |
+| Spoqa Han Sans | SIL Open Font License 1.1 | github.com/spoqa/spoqa-han-sans | Sans-serif fallback |
+| Source Han Serif K Old Hangul subset | SIL Open Font License 1.1 | Adobe / Google | 옛한글 PUA fallback, `SourceHanSerifK-OFL.txt` 동봉 |
+| Latin Modern Math | GUST Font License | GUST / TeX ecosystem | 수식 fallback |
+| Cafe24 써라운드 | 카페24 무료 배포 | fonts.cafe24.com | 장식체 |
+| Cafe24 슈퍼매직 | 카페24 무료 배포 | fonts.cafe24.com | 장식체 |
+| 행복고딕 (Happiness Sans, 4종) | 무료 배포 | 행복나눔재단 | Sans-serif fallback |
+
+---
+
+## 도구
+
+| 도구 | 라이선스 | 용도 |
+|------|---------|------|
+| Docker | Apache-2.0 | WASM 빌드 환경 |
+| wasm-pack | MIT OR Apache-2.0 | WASM 패키징 |
+| Chrome DevTools Protocol | BSD-3-Clause | E2E 테스트 / 브라우저 자동화 |
+| GitHub Actions | GitHub Terms | CI/CD |
+| npm Trusted Publishing / OIDC | npm Terms | npm 배포 |
+
+---
+
+## 직접 포팅한 알고리즘
+
+### Volexity hwp-extract
+
+- 출처: [volexity/hwp-extract](https://github.com/volexity/hwp-extract), commit
+  `e5f8b5e1590dee973630666e687e919fa70da2e2`
+- 참조 파일: `src/hwp_extract/encrypt.py`
+- 적용 위치: `src/parser/crypto.rs`의 HWP5 EncryptVersion 4 키 파생 및 비트 단위
+  AES-CFB 복호화
+- 라이선스: BSD-3-Clause
+
+Modified BSD License
+
+_Copyright © `2024`, `Volexity, Inc`_
+
+_All rights reserved._
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the `Volexity, Inc` nor the
+   names of its contributors may be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL `Volexity, Inc` BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+## 참조한 오픈소스 프로젝트 (스펙·설계 참조)
+
+rhwp는 아래 프로젝트들의 **코드를 직접 복사하지 않으며**, 공개된 스펙 정보(enum 값·속성 기본값·태그 이름·검증 규칙 등)만 참조한다.
+Apache-2.0 라이선스 고지 의무는 본 문서, 관련 기술 문서, 그리고 각 참조 파일의 헤더 주석으로 충족한다.
+
+| 프로젝트 | 라이선스 | 참조 범위 | rhwp 위치 |
+|---------|---------|----------|-----------|
+| [hancom-io/hwpx-owpml-model](https://github.com/hancom-io/hwpx-owpml-model) | Apache-2.0 © 2022 Hancom Inc. | HWPX enum 정의, 속성 기본값, 태그 전체 집합, canonical 속성·자식 순서 | `src/serializer/hwpx/canonical_defaults.rs`, `src/serializer/hwpx/{header,table,shape,picture}.rs`, `mydocs/tech/hwpx_hancom_reference.md` |
+| [hancom-io/dvc](https://github.com/hancom-io/dvc) | Apache-2.0 © 2022 Hancom Inc. | HWPX 검증 규칙 JSON 스키마, errorCode 체계 | `mydocs/tech/hwpx_dvc_reference.md` |
+
+---
+
+## 라이선스 호환성
+
+rhwp는 **MIT 라이선스**로 배포된다.
+
+- MIT, Apache-2.0, BSD, Zlib, Unlicense, 0BSD, ISC, CC0 — MIT와 호환되는 permissive license 계열
+- `encoding_rs`의 BSD-3-Clause 조항은 고지 의무를 요구하며, 이 문서로 충족
+- `pcx`는 WTFPL 대체 선택지를 포함하지만 MIT/Apache-2.0 선택지가 있어 rhwp MIT 배포와 호환
+- 오픈 폰트는 SIL OFL 1.1 또는 GUST Font License 등 재배포 가능한 라이선스만 Git에 포함
+- 저작권 보호 대상 폰트(한컴, Microsoft 등)는 Git에 포함하지 않으며 `ttfs/FONTS.md`, `assets/fonts/FONTS.md`에서 목록과 폴백만 관리
+
+---
+
+*이 문서는 `Cargo.toml`, `Cargo.lock`, 각 `package.json`/`package-lock.json`, `assets/fonts/FONTS.md` 기준으로 현행화되었으며, 의존성 업데이트 시 함께 갱신해야 한다.*
--- a/assets/licenses/THIRD_PARTY_NOTICES_ANDROID.txt
+++ b/assets/licenses/THIRD_PARTY_NOTICES_ANDROID.txt
@ -58,6 +58,10 @@ JJ_MKVMaker (Android) - 포함된 오픈 소스 구성 요소 및 라이선스
  (이 앱은 RAR 을 만들지 않습니다). 공식 소스 (https://www.7-zip.org/a/7z2501-src.7z) 를 고치지 않고 Android NDK 로 빌드
  (빌드 방법: 소스의 tool/build_7zz_android.sh). 따로 실행하는 프로그램이며, 대응 소스는 위 주소와 이 앱 판의 태그에 있습니다.
  원문: 앱 안 "오픈 소스 라이선스" 의 7-Zip (7ZIP_LICENSE.txt) · GNU LGPL 2.1
+- rhwp v0.8.7 (libjj_rhwp.so - HWP · HWPX 를 PDF 로 바꿔 보기)  MIT  https://github.com/edwardkim/rhwp
+  Copyright (c) 2025-2026 Edward Kim. 커밋 1a76570 을 고치지 않고, 얇은 C 함수 묶음 (소스의 tool/rhwp_ffi) 과 함께 Android NDK 로
+  빌드 (빌드 방법: 소스의 tool/build_rhwp_android.sh). 함께 묶인 Rust crate 들 (MIT · Apache-2.0 등) 의 목록과 원문:
+  앱 안 "오픈 소스 라이선스" 의 rhwp (RHWP_LICENSES.txt)
 - stable-diffusion.cpp · ggml (libsdcli.so 라는 이름의 실행 파일)  MIT  https://github.com/leejet/stable-diffusion.cpp
  커밋 228c707 을 고치지 않고 Android NDK 로 빌드 (AI 그림 · 해상도 올리기, 빌드 방법: 소스의 tool/build_sdcpp_android.sh)
  함께 묶인 구성 요소: ggml (MIT) · libwebp · libwebm (BSD-3) · Oniguruma · Darts-clone (BSD-2) · utf8proc · nlohmann/json ·
--- a/integration_test/hwp_source_test.dart
+++ b/integration_test/hwp_source_test.dart
@ -0,0 +1,134 @@
+import 'dart:async';
+import 'dart:io';
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:image/image.dart' as img;
+import 'package:integration_test/integration_test.dart';
+import 'package:jj_mkvmaker/core/hwp_source.dart';
+import 'package:jj_mkvmaker/core/reader_sources.dart';
+import 'package:path/path.dart' as p;
+import 'package:pdfrx/pdfrx.dart';
+
+import 'support/temp_dir.dart';
+
+/// 쪽마다 그림 한 장인 진짜 PDF 를 만드는 가짜 엔진 (rhwp 대신) - 부른 범위를 적어 둔다
+class _FakeEngine implements HwpPdfEngine {
+  final int pages;
+  final String tempDir;
+  final calls = <(int, int)>[];
+  var failNext = 0;
+  Completer<void>? hold;
+  _FakeEngine(this.pages, this.tempDir);
+
+  @override
+  Future<HwpPdfDoc> open(String path, {String? password}) async {
+    if (password == 'bad') throw const HwpPdfException('암호가 틀림');
+    return _FakeDoc(this);
+  }
+}
+
+class _FakeDoc implements HwpPdfDoc {
+  final _FakeEngine e;
+  var closed = false;
+  _FakeDoc(this.e);
+  @override
+  int get pageCount => e.pages;
+
+  @override
+  Future<void> exportPdf(int from, int to, String out, {List<String> fontDirs = const []}) async {
+    e.calls.add((from, to));
+    // 끝나지 않는 변환 (시간 제한 시험): 풀려도 아무것도 쓰지 않는다 (시험이 끝난 뒤 폴더에 쓰지 않게)
+    if (e.hold != null) {
+      await e.hold!.future;
+      throw const HwpPdfException('늦게 끝남');
+    }
+    if (e.failNext > 0) {
+      e.failNext--;
+      throw const HwpPdfException('렌더 실패');
+    }
+    final docs = <PdfDocument>[];
+    for (var i = from; i < to; i++) {
+      final png = p.join(e.tempDir, 'pg$i.png');
+      // 쪽마다 폭이 달라 (100 + 쪽 번호) 어느 쪽이 그려졌는지 크기로 안다
+      File(png).writeAsBytesSync(img.encodePng(img.Image(width: 100 + i, height: 140)));
+      docs.add(await imagePageDocument(png, tempDir: e.tempDir, sourceName: 'jj_fake_$i'));
+    }
+    final outDoc = await PdfDocument.createNew(sourceName: 'jj_fake_out_$from');
+    outDoc.pages = [for (final d in docs) d.pages.first];
+    File(out).writeAsBytesSync(await outDoc.encodePdf());
+    await outDoc.dispose();
+    for (final d in docs) {
+      await d.dispose();
+    }
+  }
+
+  @override
+  Future<void> close() async => closed = true;
+}
+
+/// 관리자 지시 (10/20): HWP · HWPX 보기 - 보는 쪽의 묶음만 PDF 로 바꾸고 다음 묶음을 미리 만든다 · 시간 제한 · 실패하면 다시 · 닫기.
+/// (rhwp 대신 가짜 엔진, PDF 를 그리는 PDFium 이 필요해 Windows 통합 시험)
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('보는 쪽의 묶음 (5쪽) 만 바꾸고 다음 묶음을 미리 · 끝 묶음은 남은 쪽만', (tester) async {
+    final dir = testTempDir('jj_hwpsrc_');
+    final doc = File(p.join(dir.path, 'a.hwp'))..writeAsStringSync('x');
+    final engine = _FakeEngine(12, dir.path);
+    final src = await tester.runAsync(() => HwpSource.open(doc.path, engine: engine, tempDir: dir.path, chunk: 5));
+    expect(src!.length, 12);
+    expect(src.pageName(0), '1 / 12');
+    final first = await tester.runAsync(() => src.load(0, maxWidth: 200));
+    expect(first!.image, isNotNull);
+    first.dispose();
+    await tester.runAsync(() => Future<void>.delayed(const Duration(seconds: 2)));
+    expect(engine.calls, [(0, 5), (5, 10)], reason: '첫 묶음 + 다음 묶음 미리');
+    // 끝 쪽: 남은 2쪽만 (11번째 = 폭 110)
+    final last = await tester.runAsync(() => src.load(11, maxWidth: 200));
+    expect(last!.image, isNotNull);
+    last.dispose();
+    expect(engine.calls.last, (10, 12));
+    // 이미 만든 묶음은 다시 만들지 않는다
+    final again = await tester.runAsync(() => src.load(3, maxWidth: 200));
+    again!.dispose();
+    expect(engine.calls.where((c) => c == (0, 5)), hasLength(1));
+    await tester.runAsync(src.dispose);
+    expect(Directory(src.work.path).existsSync(), isFalse, reason: '닫으면 임시 PDF 를 지움');
+  });
+
+  testWidgets('묶음이 실패하면 그 쪽에 이유, 다시 보면 다시 만든다 · 시간 제한 · 열기 실패', (tester) async {
+    final dir = testTempDir('jj_hwpsrc_');
+    final doc = File(p.join(dir.path, 'b.hwpx'))..writeAsStringSync('x');
+    final engine = _FakeEngine(3, dir.path)..failNext = 1;
+    final src = await tester.runAsync(() => HwpSource.open(doc.path, engine: engine, tempDir: dir.path, chunk: 5,
+        timeout: const Duration(seconds: 2)));
+    Object? err;
+    await tester.runAsync(() => src!.load(0, maxWidth: 200).then((r) => r.dispose(), onError: (Object e) {
+          err = e;
+        }));
+    expect('$err', contains('렌더 실패'));
+    final ok = await tester.runAsync(() => src!.load(0, maxWidth: 200));
+    expect(ok!.image, isNotNull, reason: '실패한 묶음은 다시');
+    ok.dispose();
+    await tester.runAsync(src!.dispose);
+
+    // 시간 제한: 끝나지 않는 변환
+    final slow = _FakeEngine(3, dir.path)..hold = Completer<void>();
+    final s2 = await tester.runAsync(() => HwpSource.open(doc.path, engine: slow, tempDir: dir.path, timeout: const Duration(seconds: 1)));
+    Object? err2;
+    await tester.runAsync(() => s2!.load(1, maxWidth: 200).then((r) => r.dispose(), onError: (Object e) {
+          err2 = e;
+        }));
+    expect(err2, isA<HwpPdfException>());
+    expect('$err2', contains('1~3'));
+    slow.hold!.complete();
+    await tester.runAsync(s2!.dispose);
+
+    // 열기 실패 (암호 등) 는 그대로 알린다 - 파일 탐색기는 다른 앱으로 연다
+    Object? err3;
+    await tester.runAsync(() => HwpSource.open(doc.path, engine: engine, tempDir: dir.path, password: 'bad').then((_) {}, onError: (Object e) {
+          err3 = e;
+        }));
+    expect('$err3', contains('암호'));
+  });
+}
--- a/lib/core/hwp_source.dart
+++ b/lib/core/hwp_source.dart
@ -0,0 +1,131 @@
+import 'dart:async';
+import 'dart:io';
+import 'dart:math' as math;
+
+import 'package:path/path.dart' as p;
+import 'package:pdfrx/pdfrx.dart';
+
+import 'reader_sources.dart';
+import 'vfs.dart';
+import '../l10n/tr.dart';
+
+/// HWP · HWPX 확장자 (앱 안에서 PDF 로 바꿔 보기 - Android, rhwp)
+const hwpExtensions = ['hwp', 'hwpx'];
+
+/// HWP · HWPX → PDF 엔진 (Android: APK 의 libjj_rhwp.so - lib/platform/android/hwp_pdf_ffi.dart, 시험: 가짜)
+abstract class HwpPdfEngine {
+  /// 문서 열기 (암호가 있으면 [password]). 실패하면 [HwpPdfException]
+  Future<HwpPdfDoc> open(String path, {String? password});
+}
+
+/// 연 문서: 쪽 수와 쪽 범위 → PDF
+abstract class HwpPdfDoc {
+  int get pageCount;
+
+  /// [from] 부터 [to] 앞까지 (0 부터) 를 PDF 파일 [out] 으로. [fontDirs] 는 글꼴을 찾을 폴더들
+  Future<void> exportPdf(int from, int to, String out, {List<String> fontDirs = const []});
+  Future<void> close();
+}
+
+class HwpPdfException implements Exception {
+  final String message;
+  const HwpPdfException(this.message);
+  @override
+  String toString() => message;
+}
+
+/// 관리자 지시 (10/20): HWP · HWPX 를 보기 화면으로 - 큰 문서 (편람 383쪽은 PC 에서도 14분) 를 통째로 바꾸지 않고,
+/// 보는 쪽이 든 [chunk] 쪽 묶음만 PDF 로 바꿔 보이면서 다음 묶음을 뒤에서 미리 만든다. 묶음마다 [timeout],
+/// 닫으면 (dispose) 더 만들지 않는다. 바꾸는 중의 쪽은 보기 화면이 기다리는 표시를 보이고, 실패한 묶음은 그 쪽에 이유가 보인다.
+class HwpSource extends ReaderSource {
+  final String path;
+  final HwpPdfDoc doc;
+  final Directory work;
+  final List<String> fontDirs;
+  final int chunk;
+  final Duration timeout;
+  @override
+  final String title;
+
+  final _chunks = <int, Future<PdfDocument>>{};
+  final _opened = <PdfDocument>[];
+  var _disposed = false;
+
+  HwpSource._(this.path, this.doc, this.work, this.title, {required this.fontDirs, required this.chunk, required this.timeout});
+
+  /// 문서를 연다 (WebDAV 등은 [tempDir] 로 받은 뒤). 열지 못하면 [HwpPdfException]
+  static Future<HwpSource> open(String path,
+      {required HwpPdfEngine engine,
+      required String tempDir,
+      String? password,
+      List<String> fontDirs = const [],
+      int chunk = 5,
+      Duration timeout = const Duration(minutes: 3)}) async {
+    final local = await vLocalCopy(path, tempDir);
+    final doc = await engine.open(local, password: password);
+    final work = Directory(p.join(tempDir, 'jj_hwp_${DateTime.now().microsecondsSinceEpoch}'))..createSync(recursive: true);
+    return HwpSource._(path, doc, work, vBasename(path), fontDirs: fontDirs, chunk: chunk, timeout: timeout);
+  }
+
+  @override
+  int get length => doc.pageCount;
+  @override
+  String pageName(int i) => '${i + 1} / $length';
+
+  /// [k] 번째 묶음의 PDF (한 번만 만든다 - 실패하면 다음에 다시)
+  Future<PdfDocument> _chunk(int k) => _chunks[k] ??= _make(k).onError<Object>((e, st) {
+        _chunks.remove(k);
+        Error.throwWithStackTrace(e, st);
+      });
+
+  Future<PdfDocument> _make(int k) async {
+    if (_disposed) throw StateError(tr('닫힌 문서입니다'));
+    final from = k * chunk, to = math.min(from + chunk, length);
+    final out = p.join(work.path, 'p$k.pdf');
+    try {
+      await doc.exportPdf(from, to, out, fontDirs: fontDirs).timeout(timeout);
+    } on TimeoutException {
+      throw HwpPdfException(trf('{0}~{1}쪽을 {2}초 안에 바꾸지 못했습니다', [from + 1, to, timeout.inSeconds]));
+    }
+    if (_disposed) throw StateError(tr('닫힌 문서입니다'));
+    await pdfrxFlutterInitialize();
+    final pdf = await PdfDocument.openFile(out);
+    if (_disposed) {
+      await pdf.dispose();
+      throw StateError(tr('닫힌 문서입니다'));
+    }
+    _opened.add(pdf);
+    return pdf;
+  }
+
+  @override
+  Future<ReaderImage> load(int i, {required int maxWidth}) async {
+    final k = i ~/ chunk;
+    final pdf = await _chunk(k);
+    // 다음 묶음을 미리 (넘겨 볼 때 기다리지 않게) - 실패해도 여기서는 알리지 않는다 (그 쪽을 볼 때 보임)
+    if ((k + 1) * chunk < length) unawaited(_chunk(k + 1).then((_) {}, onError: (Object _) {}));
+    final page = pdf.pages[i - k * chunk];
+    final w = maxWidth.toDouble();
+    final h = w * page.height / page.width;
+    final image = await page.render(fullWidth: w, fullHeight: h, backgroundColor: 0xffffffff);
+    if (image == null) return const ReaderImage();
+    try {
+      return ReaderImage(image: await image.createImage());
+    } finally {
+      image.dispose();
+    }
+  }
+
+  @override
+  Future<void> dispose() async {
+    _disposed = true;
+    for (final d in _opened) {
+      await d.dispose();
+    }
+    _opened.clear();
+    await doc.close(); // 바꾸는 중이면 그것이 끝난 뒤에 닫힌다 (엔진이 한 번에 하나씩)
+    try {
+      if (work.existsSync()) work.deleteSync(recursive: true);
+    } catch (_) {}
+  }
+}
--- a/lib/platform/android/hwp_pdf_ffi.dart
+++ b/lib/platform/android/hwp_pdf_ffi.dart
@ -0,0 +1,126 @@
+import 'dart:async';
+import 'dart:ffi';
+import 'dart:isolate';
+
+import 'package:ffi/ffi.dart';
+
+import '../../core/hwp_source.dart';
+
+/// 관리자 지시 (10/20): Android 의 HWP · HWPX → PDF - APK 에 든 libjj_rhwp.so (rhwp v0.8.7, MIT - tool/build_rhwp_android.sh ·
+/// tool/rhwp_ffi) 를 dart:ffi 로 부른다. 여는 것 · 바꾸는 것은 다른 isolate 에서 (화면을 막지 않게), 한 문서는 한 번에 하나씩.
+class RhwpEngine implements HwpPdfEngine {
+  static const libName = 'libjj_rhwp.so';
+
+  /// 글꼴을 찾을 폴더 (Android 는 rhwp 가 시스템 글꼴을 스스로 찾지 않는다 - 한글은 Noto Sans/Serif CJK KR 로 대신 그림).
+  /// 관리자 판단 (10/20): 한글 글꼴 컴포넌트를 받으면 그 폴더를 앞에 더한다 (아직 없음)
+  static const fontDirs = ['/system/fonts'];
+
+  /// 라이브러리를 읽을 수 있는지 (없으면 다른 앱으로 연다)
+  static bool get available {
+    try {
+      DynamicLibrary.open(libName);
+      return true;
+    } catch (_) {
+      return false;
+    }
+  }
+
+  @override
+  Future<HwpPdfDoc> open(String path, {String? password}) async {
+    final (handle, err) = await Isolate.run(() => _open(path, password ?? ''));
+    if (handle == 0) throw HwpPdfException(err ?? 'rhwp');
+    final pages = await Isolate.run(() => _pageCount(handle));
+    return _RhwpDoc(handle, pages);
+  }
+}
+
+class _RhwpDoc implements HwpPdfDoc {
+  final int _handle;
+  @override
+  final int pageCount;
+  var _closed = false;
+
+  /// 한 번에 하나씩 (rhwp 문서는 여러 스레드에서 함께 쓰지 않는다)
+  Future<void> _queue = Future.value();
+
+  _RhwpDoc(this._handle, this.pageCount);
+
+  Future<T> _serial<T>(Future<T> Function() f) {
+    final run = _queue.then((_) => f());
+    _queue = run.then((_) {}, onError: (Object _) {});
+    return run;
+  }
+
+  @override
+  Future<void> exportPdf(int from, int to, String out, {List<String> fontDirs = const []}) => _serial(() async {
+        if (_closed) throw const HwpPdfException('closed');
+        final h = _handle, dirs = fontDirs.join('\n');
+        final err = await Isolate.run(() => _export(h, from, to, dirs, out));
+        if (err != null) throw HwpPdfException(err);
+      });
+
+  @override
+  Future<void> close() => _serial(() async {
+        if (_closed) return;
+        _closed = true;
+        _close(_handle);
+      });
+}
+
+// ───────── C 함수 (isolate 안에서 부른다 - 핸들은 주소 숫자로 넘긴다) ─────────
+
+typedef _OpenC = Pointer<Void> Function(Pointer<Utf8>, Pointer<Utf8>, Pointer<Pointer<Utf8>>);
+typedef _CountC = Int32 Function(Pointer<Void>);
+typedef _CountD = int Function(Pointer<Void>);
+typedef _ExportC = Int32 Function(Pointer<Void>, Int32, Int32, Pointer<Utf8>, Pointer<Utf8>, Pointer<Pointer<Utf8>>);
+typedef _ExportD = int Function(Pointer<Void>, int, int, Pointer<Utf8>, Pointer<Utf8>, Pointer<Pointer<Utf8>>);
+typedef _CloseC = Void Function(Pointer<Void>);
+typedef _CloseD = void Function(Pointer<Void>);
+typedef _FreeC = Void Function(Pointer<Utf8>);
+typedef _FreeD = void Function(Pointer<Utf8>);
+
+DynamicLibrary _lib() => DynamicLibrary.open(RhwpEngine.libName);
+
+/// 돌려받은 오류 글을 읽고 푼다
+String? _takeError(DynamicLibrary lib, Pointer<Pointer<Utf8>> err) {
+  final p = err.value;
+  if (p == nullptr) return null;
+  final s = p.toDartString();
+  lib.lookupFunction<_FreeC, _FreeD>('jj_rhwp_free')(p);
+  return s;
+}
+
+(int, String?) _open(String path, String password) {
+  final lib = _lib();
+  final open = lib.lookupFunction<_OpenC, _OpenC>('jj_rhwp_open');
+  final a = path.toNativeUtf8(), b = password.toNativeUtf8();
+  final err = calloc<Pointer<Utf8>>();
+  try {
+    final doc = open(a, b, err);
+    return (doc.address, _takeError(lib, err));
+  } finally {
+    calloc.free(a);
+    calloc.free(b);
+    calloc.free(err);
+  }
+}
+
+int _pageCount(int handle) => _lib().lookupFunction<_CountC, _CountD>('jj_rhwp_page_count')(Pointer<Void>.fromAddress(handle));
+
+String? _export(int handle, int from, int to, String fontDirs, String out) {
+  final lib = _lib();
+  final export = lib.lookupFunction<_ExportC, _ExportD>('jj_rhwp_export_pdf');
+  final d = fontDirs.toNativeUtf8(), o = out.toNativeUtf8();
+  final err = calloc<Pointer<Utf8>>();
+  try {
+    final r = export(Pointer<Void>.fromAddress(handle), from, to, d, o, err);
+    final e = _takeError(lib, err);
+    return r == 0 ? null : (e ?? 'rhwp');
+  } finally {
+    calloc.free(d);
+    calloc.free(o);
+    calloc.free(err);
+  }
+}
+
+void _close(int handle) => _lib().lookupFunction<_CloseC, _CloseD>('jj_rhwp_close')(Pointer<Void>.fromAddress(handle));
--- a/lib/ui/explorer_page.dart
+++ b/lib/ui/explorer_page.dart
@ -25,6 +25,7 @@ import '../core/ftp.dart' show FtpCertException, FtpRegistry;
 import '../core/smb.dart' show SmbRegistry;
 import '../core/webdav.dart' show DavRegistry;
 import '../platform/android/android_storage.dart';
+import '../platform/android/hwp_pdf_ffi.dart' show RhwpEngine;
 import 'app_actions.dart';
 import 'explorer_look.dart';
 import 'key_hint.dart';
@ -50,6 +51,7 @@ import '../app/component_store.dart';
 import '../app/components.dart';
 import 'zip_page.dart';
 import '../core/reader_sources.dart';
+import '../core/hwp_source.dart';
 import '../l10n/tr.dart';
 import 'explorer_bookmarks.dart';
 import 'explorer_search.dart';
@ -1672,6 +1674,11 @@ class _ExplorerPageState extends State<ExplorerPage> {
      if (ext == 'pdf') return _viewPdf(path);
      if (zipExtensions.contains(ext)) return _openZip(path, pane);
    }
+    // 관리자 지시 (10/20): Android 의 HWP · HWPX 는 앱 안에서 PDF 로 바꿔 본다 (rhwp - APK 에 들어 있음, 보기 컴포넌트를 켰을 때).
+    // 열지 못하면 (암호 · 깨진 파일 · 라이브러리 없음) 이유를 알리고 예전처럼 다른 앱으로
+    if (Platform.isAndroid && c.settings.components.contains('viewer') && hwpExtensions.contains(extOf(path)) && RhwpEngine.available) {
+      if (await _viewHwp(path)) return;
+    }
    // 문서 미리보기 (Windows: 설치한 변환기로 PDF 로 바꿔 봄)
    if (c.settings.components.contains('docs') && Platform.isWindows &&
        AppComponent.docExtensions.contains(extOf(path))) {
@ -1783,6 +1790,42 @@ class _ExplorerPageState extends State<ExplorerPage> {
    await openReader(context, c, src);
  }

+  /// 관리자 지시 (10/20): HWP · HWPX → 보기 화면 (보는 쪽부터 몇 쪽씩 PDF 로 바꿈 - [HwpSource]). 열지 못하면 false
+  Future<bool> _viewHwp(String path) async {
+    final temp = await c.services.storage.tempDirectory();
+    if (!mounted) return true;
+    final dialog = showDialog<void>(
+      context: context,
+      barrierDismissible: false,
+      builder: (_) => AlertDialog(
+        content: Row(children: [
+          const CircularProgressIndicator(),
+          const SizedBox(width: 16),
+          Expanded(child: Text(trf('여는 중: {0}', [vBasename(path)]))),
+        ]),
+      ),
+    );
+    HwpSource? src;
+    Object? error;
+    try {
+      src = await HwpSource.open(path, engine: RhwpEngine(), tempDir: temp, fontDirs: RhwpEngine.fontDirs);
+    } catch (e) {
+      error = e;
+    }
+    if (mounted) Navigator.of(context).pop();
+    await dialog;
+    if (src == null) {
+      _snack(trf('앱 안에서 열지 못해 다른 앱으로 엽니다: {0}', [error]));
+      return false;
+    }
+    if (!mounted) {
+      await src.dispose();
+      return true;
+    }
+    await openReader(context, c, src);
+    return true;
+  }
+
  Future<void> _viewPdf(String path) async {
    final temp = await c.services.storage.tempDirectory();
    PdfSource src;
--- a/lib/ui/license_texts.dart
+++ b/lib/ui/license_texts.dart
@ -40,6 +40,8 @@ List<(List<String>, String)> get _licenseAssets => [
  (['smbj 0.15.0 · asn-one · Bouncy Castle · SLF4J · MBassador (Android SMB)'], 'assets/licenses/SMBJ_LICENSES.txt'),
  // Tor 브라우저: tor 와 함께 묶인 Libevent · OpenSSL · zlib · zstd (공식 번들의 docs)
  (['Tor 0.4.9.13 (Libevent · OpenSSL · zlib · Zstandard)'], 'assets/licenses/TOR_LICENSES.txt'),
+  // 관리자 지시 (10/20): Android 의 HWP · HWPX 보기 (libjj_rhwp.so - rhwp MIT 와 함께 묶인 Rust crate 들)
+  if (Platform.isAndroid) (['rhwp 0.8.7 (HWP · HWPX → PDF)'], 'assets/licenses/RHWP_LICENSES.txt'),
  // 175: 함께 빌드한 네이티브 라이브러리 (Dart 쪽 패키지 라이선스와 따로)
  ([tr('whisper.cpp · ggml (whisper_ggml 안)')], 'assets/licenses/WHISPER_CPP_LICENSE.txt'),
  (['ONNX Runtime 1.15.1 (Microsoft)'], 'assets/licenses/ONNXRUNTIME_LICENSES.txt'),
--- a/lib/ui/reader_page.dart
+++ b/lib/ui/reader_page.dart
@ -7,6 +7,7 @@ import 'package:wakelock_plus/wakelock_plus.dart';

 import '../app/app_controller.dart';
 import '../core/reader_sources.dart';
+import '../core/hwp_source.dart' show HwpSource;
 import '../core/vfs.dart';
 import '../l10n/tr.dart';
 import 'ai_image_page.dart';
@ -159,7 +160,8 @@ class _ReaderPageState extends State<ReaderPage> {
    if (d == null) return false;
    Size turned(Size s) => _turns.isOdd ? Size(s.height, s.width) : s;
    return autoSplitsPage(turned(d), [for (final e in _dims.entries) if (e.key != page) turned(e.value)],
-        bundle: src is! ImageFilesSource);
+        // 관리자 지시 (10/20) · 내 판단: HWP · HWPX 문서의 가로 쪽 (가로 표 등) 은 만화 두 쪽 스캔이 아니라 나누지 않는다
+        bundle: src is! ImageFilesSource && src is! HwpSource);
  }

  /// 223: 나눠 본 장에서 바로 한 장으로 (설정을 "끄기" 로)
--- a/tool/build_rhwp_android.sh
+++ b/tool/build_rhwp_android.sh
@ -0,0 +1,95 @@
+#!/bin/sh
+# 관리자 지시 (10/20): Android (arm64) 에서 HWP · HWPX 를 PDF 로 바꿔 앱의 보기 화면으로 연다 - rhwp (Rust, MIT) 를
+# tool/rhwp_ffi (얇은 C ABI) 와 함께 NDK 로 빌드해 third_party/rhwp/android/arm64-v8a/libjj_rhwp.so 로 둔다 (rsync · 7zz 와 같은 방식 -
+# APK 의 jniLibs 로 들어가 앱이 dart:ffi 로 읽는다).
+#   소스: https://github.com/edwardkim/rhwp v0.8.7 = 커밋 1a76570 (고정 - git 커밋 해시가 내용의 SHA-1 지문이다, 고치지 않음).
+#     저장소가 크므로 (예제 문서 · PDF 로 4GB 넘음) 빌드에 쓰는 폴더만 받는다 (git sparse, 깊이 1).
+#   라이선스: rhwp MIT (LICENSE) · 의존 crate 들 (THIRD_PARTY_LICENSES.md) - 둘 다 third_party/rhwp 에 함께 둔다.
+#   도구: Rust 1.93.1 (rhwp 의 rust-toolchain.toml 과 같음, tools/rust - RUSTUP_HOME · CARGO_HOME) + Android NDK clang (링커).
+#     Windows 에서는 호스트 쪽 (빌드 스크립트) 을 MSVC 로 링크하므로 tools/VSBuildTools 의 vcvars64 환경을 읽어 온다.
+#   16KB 쪽 기기 (Android 15+) 에서도 읽히게 -z max-page-size=16384, 다시 만들어도 같은 파일이 되게 경로를 /jj 로 바꿔 적는다.
+#   의존 crate 판은 tool/rhwp_ffi/Cargo.lock 으로 고정 (--locked).
+# 사용법 (Git Bash): sh tool/build_rhwp_android.sh   - Android NDK 가 필요 (ANDROID_NDK 또는 tools/android-sdk/ndk/*)
+#   다시 만들어지는지 보기: JJ_RHWP_CHECK=1 sh tool/build_rhwp_android.sh  (깨끗한 target 으로 두 번 빌드해 해시를 견줌)
+set -e
+APP=$(cd "$(dirname "$0")/.." && pwd)
+TOOLS=$(cd "$APP/.." && pwd)/tools
+VER=0.8.7
+REV=1a76570e833917d15817415a53c09ad61ab3203f
+NDK_ROOT=${ANDROID_NDK:-$(ls -d "$TOOLS"/android-sdk/ndk/* | sort | tail -1)}
+case "$(uname -s)" in MINGW*|MSYS*|CYGWIN*) HOST=windows-x86_64; EXE=.exe; CMD=.cmd ;; Darwin) HOST=darwin-x86_64; EXE=; CMD= ;; *) HOST=linux-x86_64; EXE=; CMD= ;; esac
+TC=$NDK_ROOT/toolchains/llvm/prebuilt/$HOST/bin
+export RUSTUP_HOME=${RUSTUP_HOME:-$TOOLS/rust/rustup}
+export CARGO_HOME=${CARGO_HOME:-$TOOLS/rust/cargo}
+export PATH="$CARGO_HOME/bin:$PATH"
+
+# Windows: 호스트 링커 (MSVC) 환경
+if [ "$HOST" = windows-x86_64 ] && [ -z "$VCINSTALLDIR" ]; then
+  VC=$(cygpath -w "$TOOLS/VSBuildTools/VC/Auxiliary/Build/vcvars64.bat")
+  ENVF=$(mktemp)
+  # cmd 에 따옴표를 넘기면 Git Bash 가 바꿔 버려, 부를 것을 .cmd 파일로 적어 그것을 돌린다
+  BAT=$(mktemp --suffix=.cmd)
+  printf '@call "%s" >nul\r\n@set\r\n' "$VC" > "$BAT"
+  cmd //c "$(cygpath -w "$BAT")" | tr -d '\r' > "$ENVF"
+  rm -f "$BAT"
+  while IFS='=' read -r k v; do
+    case "$k" in
+      Path|PATH) PATH="$(cygpath -u -p "$v"):$PATH" ;;
+      LIB|LIBPATH|INCLUDE|VCINSTALLDIR|VCToolsInstallDir|WindowsSdkDir|WindowsSDKVersion|UCRTVersion|UniversalCRTSdkDir) export "$k=$v" ;;
+    esac
+  done < "$ENVF"
+  rm -f "$ENVF"
+  export PATH
+  [ -n "$VCINSTALLDIR" ] || { echo "vcvars64 환경을 읽지 못함: $VC"; exit 1; }
+fi
+
+# 작업 폴더: tools 아래 (빌드 캐시가 수 GB - 시스템 임시 폴더 (C:) 가 모자라 시험이 실패했다, 10/20). 다시 빌드할 때 이어 쓴다
+WORK=${JJ_RHWP_WORK:-$TOOLS/src/rhwp/build}
+mkdir -p "$WORK"
+SRC=$WORK/rhwp
+if [ "$(git -C "$SRC" rev-parse HEAD 2>/dev/null)" != "$REV" ]; then
+  rm -rf "$SRC"
+  git init -q "$SRC"
+  git -C "$SRC" remote add origin https://github.com/edwardkim/rhwp.git
+  git -C "$SRC" sparse-checkout init --no-cone
+  printf '%s\n' '/*' '!/samples/' '!/pdf/' '!/mydocs/' '!/saved/' '!/tests/' '!/gym/' '!/rhwp-*/' '!/npm/' '!/typescript/' \
+    '!/tools/' '!/fuzz/' '!/scripts/' '/saved/blank2010.hwp' '/mydocs/manual/' '/mydocs/tech/' > "$SRC/.git/info/sparse-checkout"
+  git -C "$SRC" fetch -q --depth 1 --filter=blob:none origin "$REV"
+  git -C "$SRC" checkout -q FETCH_HEAD
+fi
+[ "$(git -C "$SRC" rev-parse HEAD)" = "$REV" ] || { echo "rhwp 커밋이 다름"; exit 1; }
+[ -z "$(git -C "$SRC" status --porcelain)" ] || { echo "rhwp 소스가 바뀌어 있음"; exit 1; }
+
+rm -rf "$WORK/ffi"
+cp -r "$APP/tool/rhwp_ffi" "$WORK/ffi"
+# 처음 한 번: 의존 판을 rhwp 의 Cargo.lock 그대로 이어받아 tool/rhwp_ffi/Cargo.lock 을 만든다 (그 뒤로는 --locked)
+LOCKED=--locked
+if [ ! -f "$APP/tool/rhwp_ffi/Cargo.lock" ]; then
+  cp "$SRC/Cargo.lock" "$WORK/ffi/Cargo.lock"
+  LOCKED=
+fi
+export CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER="$TC/aarch64-linux-android24-clang$CMD"
+export CC_aarch64_linux_android="$TC/aarch64-linux-android24-clang$CMD"
+export AR_aarch64_linux_android="$TC/llvm-ar$EXE"
+W=$WORK
+[ "$HOST" = windows-x86_64 ] && W=$(cygpath -m "$WORK")
+export RUSTFLAGS="-C link-arg=-Wl,-z,max-page-size=16384 -C link-arg=-Wl,--build-id=none --remap-path-prefix=$W=/jj --remap-path-prefix=$(cygpath -m "$CARGO_HOME" 2>/dev/null || echo "$CARGO_HOME")=/cargo"
+export JJ_RHWP_VERSION=$VER
+build() {
+  cargo build -q --release $LOCKED --target aarch64-linux-android --manifest-path "$WORK/ffi/Cargo.toml" --target-dir "$1"
+  "$TC/llvm-strip$EXE" -o "$2" "$1/aarch64-linux-android/release/libjj_rhwp.so"
+}
+OUT="$APP/third_party/rhwp/android/arm64-v8a"
+mkdir -p "$OUT"
+build "$WORK/target" "$OUT/libjj_rhwp.so"
+[ -n "$LOCKED" ] || cp "$WORK/ffi/Cargo.lock" "$APP/tool/rhwp_ffi/Cargo.lock"
+cp "$SRC/LICENSE" "$OUT/../LICENSE.txt"
+cp "$SRC/THIRD_PARTY_LICENSES.md" "$OUT/../THIRD_PARTY_LICENSES.md"
+if [ -n "$JJ_RHWP_CHECK" ]; then
+  rm -rf "$WORK/target2"
+  build "$WORK/target2" "$WORK/again.so"
+  A=$(sha256sum < "$OUT/libjj_rhwp.so"); B=$(sha256sum < "$WORK/again.so")
+  [ "$A" = "$B" ] && echo "다시 만들어도 같음" || { echo "다시 만들면 다름: $A / $B"; exit 1; }
+fi
+ls -l "$OUT/libjj_rhwp.so"
+sha256sum "$OUT/libjj_rhwp.so"
--- a/tool/rhwp_ffi/Cargo.lock
+++ b/tool/rhwp_ffi/Cargo.lock
--- a/tool/rhwp_ffi/Cargo.toml
+++ b/tool/rhwp_ffi/Cargo.toml
@ -0,0 +1,20 @@
+# JJ_MKVMaker: HWP · HWPX → PDF (rhwp) 의 C ABI - tool/build_rhwp_android.sh 가 rhwp 소스 (커밋 고정) 옆에 두고 빌드한다
+[package]
+name = "jj_rhwp"
+version = "0.1.0"
+edition = "2021"
+license = "MIT"
+publish = false
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+# 빌드 스크립트가 ../rhwp 에 rhwp v0.8.7 (커밋 1a76570) 을 받아 둔다
+rhwp = { path = "../rhwp", default-features = false }
+
+[profile.release]
+opt-level = 3
+lto = "thin"
+codegen-units = 1
+strip = true
--- a/tool/rhwp_ffi/rust-toolchain.toml
+++ b/tool/rhwp_ffi/rust-toolchain.toml
@ -0,0 +1,5 @@
+# rhwp v0.8.7 과 같은 판 (rhwp 의 rust-toolchain.toml)
+[toolchain]
+channel = "1.93.1"
+targets = ["aarch64-linux-android"]
+profile = "minimal"
--- a/tool/rhwp_ffi/src/lib.rs
+++ b/tool/rhwp_ffi/src/lib.rs
@ -0,0 +1,137 @@
+//! JJ_MKVMaker: HWP · HWPX 를 PDF 로 바꾸는 얇은 C ABI (rhwp, MIT - https://github.com/edwardkim/rhwp).
+//! 관리자 지시 (10/20): Android 에서 HWP · HWPX 를 앱의 보기 화면 (PDF) 으로 연다 - 문서를 한 번 열고, 쪽 범위마다 PDF 를 만든다
+//! (큰 문서는 앞쪽부터 몇 쪽씩 보이면서 뒤를 이어 만든다). Dart 는 dart:ffi 로 부른다 (lib/platform/android/hwp_pdf.dart).
+//! 오류 글 · 돌려준 글은 jj_rhwp_free 로 푼다. 어느 함수도 panic 을 C 쪽으로 넘기지 않는다.
+
+use std::ffi::{c_char, c_int, CStr, CString};
+use std::panic::{catch_unwind, AssertUnwindSafe};
+use std::path::PathBuf;
+use std::ptr::null_mut;
+
+use rhwp::document_core::DocumentCore;
+use rhwp::renderer::pdf::PdfExportOptions;
+
+/// 연 문서
+pub struct JjRhwpDoc {
+    core: DocumentCore,
+}
+
+fn text(p: *const c_char) -> Option<String> {
+    if p.is_null() {
+        return None;
+    }
+    Some(unsafe { CStr::from_ptr(p) }.to_string_lossy().into_owned())
+}
+
+fn set_err(err: *mut *mut c_char, msg: &str) {
+    if err.is_null() {
+        return;
+    }
+    let c = CString::new(msg.replace('\0', " ")).unwrap_or_default();
+    unsafe { *err = c.into_raw() };
+}
+
+fn guarded<T>(err: *mut *mut c_char, fail: T, f: impl FnOnce() -> Result<T, String>) -> T {
+    match catch_unwind(AssertUnwindSafe(f)) {
+        Ok(Ok(v)) => v,
+        Ok(Err(e)) => {
+            set_err(err, &e);
+            fail
+        }
+        Err(p) => {
+            let msg = p
+                .downcast_ref::<&str>()
+                .map(|s| s.to_string())
+                .or_else(|| p.downcast_ref::<String>().cloned())
+                .unwrap_or_else(|| "panic".to_string());
+            set_err(err, &format!("rhwp panic: {msg}"));
+            fail
+        }
+    }
+}
+
+/// 판 (예: "0.8.7") - 라이선스 화면 · 작업 기록용. jj_rhwp_free 로 푼다
+#[no_mangle]
+pub extern "C" fn jj_rhwp_version() -> *mut c_char {
+    CString::new(option_env!("JJ_RHWP_VERSION").unwrap_or("?")).unwrap_or_default().into_raw()
+}
+
+/// 문서 열기 (password 는 null 이나 "" 이면 없음). 실패하면 null 과 err
+#[no_mangle]
+pub extern "C" fn jj_rhwp_open(path: *const c_char, password: *const c_char, err: *mut *mut c_char) -> *mut JjRhwpDoc {
+    guarded(err, null_mut(), || {
+        let path = text(path).ok_or("경로 없음")?;
+        let data = std::fs::read(&path).map_err(|e| e.to_string())?;
+        let core = match text(password).filter(|p| !p.is_empty()) {
+            Some(p) => DocumentCore::from_bytes_with_password(&data, p.as_bytes()),
+            None => DocumentCore::from_bytes(&data),
+        }
+        .map_err(|e| e.to_string())?;
+        Ok(Box::into_raw(Box::new(JjRhwpDoc { core })))
+    })
+}
+
+/// 쪽 수 (doc 이 null 이면 -1)
+#[no_mangle]
+pub extern "C" fn jj_rhwp_page_count(doc: *const JjRhwpDoc) -> c_int {
+    if doc.is_null() {
+        return -1;
+    }
+    let doc = unsafe { &*doc };
+    catch_unwind(AssertUnwindSafe(|| doc.core.page_count() as c_int)).unwrap_or(-1)
+}
+
+/// [from, to) 쪽 (0 부터) 을 PDF 파일 out 으로. font_dirs 는 줄바꿈 (\n) 으로 나눈 글꼴 폴더들 (Android 는 시스템 글꼴을
+/// 스스로 찾지 않으므로 /system/fonts 와 앱이 받은 한글 글꼴 폴더를 넘긴다). 성공 0, 실패 -1 과 err
+#[no_mangle]
+pub extern "C" fn jj_rhwp_export_pdf(
+    doc: *const JjRhwpDoc,
+    from: c_int,
+    to: c_int,
+    font_dirs: *const c_char,
+    out: *const c_char,
+    err: *mut *mut c_char,
+) -> c_int {
+    guarded(err, -1, || {
+        if doc.is_null() {
+            return Err("문서 없음".into());
+        }
+        let doc = unsafe { &*doc };
+        let count = doc.core.page_count() as c_int;
+        if from < 0 || to > count || from >= to {
+            return Err(format!("쪽 범위가 맞지 않음: {from}..{to} / {count}"));
+        }
+        let out = text(out).ok_or("저장할 곳 없음")?;
+        let mut options = PdfExportOptions::default();
+        options.font_paths = text(font_dirs)
+            .unwrap_or_default()
+            .split('\n')
+            .map(str::trim)
+            .filter(|s| !s.is_empty())
+            .map(PathBuf::from)
+            .collect();
+        let pages: Vec<u32> = (from as u32..to as u32).collect();
+        let bytes = doc.core.render_pages_pdf_native_with_options(&pages, &options).map_err(|e| e.to_string())?;
+        // 다 쓴 뒤에 이름을 바꾼다 (보기 화면이 반쪽 파일을 읽지 않게)
+        let part = format!("{out}.part");
+        std::fs::write(&part, &bytes).map_err(|e| e.to_string())?;
+        std::fs::rename(&part, &out).map_err(|e| e.to_string())?;
+        Ok(0)
+    })
+}
+
+/// 문서 닫기
+#[no_mangle]
+pub extern "C" fn jj_rhwp_close(doc: *mut JjRhwpDoc) {
+    if !doc.is_null() {
+        let _ = catch_unwind(AssertUnwindSafe(|| drop(unsafe { Box::from_raw(doc) })));
+    }
+}
+
+/// 이 라이브러리가 돌려준 글 (err · 판) 풀기
+#[no_mangle]
+pub extern "C" fn jj_rhwp_free(s: *mut c_char) {
+    if !s.is_null() {
+        drop(unsafe { CString::from_raw(s) });
+    }
+}