轉譯模型與 Chromium/PDF 邊界
先備知識：Document IR、export profiles。
一份語意、兩層設定
Section titled “一份語意、兩層設定”Rust 擁有 .mdi parse、diagnostic code、UTF-8 span，以及 semantic HTML/baseline EPUB/DOCX/TXT。它是 ruby、tate-chu-yoko、不換行、kern、blank paragraph、pagebreak 等 MDI 意義的唯一 authority。
EPUB/DOCX adapter 對已 parse 的 Rust IR 套用 metadata、chapter、typography、page setup、numbering。Chromium path 與 app UI preference 是 host 設定。這樣不把 platform-specific print policy 塞入 parser。
設定型 publication export 必須明示 layout.system。japanese-publisher 是 strict 的日文書籍契約：橫書為 Shirokuban、10 pt 明朝體、鏡像頁、左裝訂 27×26；直書為 A4 landscape 小說原稿、鏡像頁、右裝訂 40×30。word 刻意採不相容的契約：A4、四邊 25.4 mm、無鏡像、流動 typographic layout，且拒絕 strict。
| 輸出 | baseline | 可設定 route |
|---|---|---|
| HTML | renderHtml(source) | { bodyOnly: true } 或附 diagnostics/headings 的 renderHtmlWithDiagnostics。 |
| TXT | renderTextFormat | caller 傳入 indent。 |
| EPUB | renderEpub(source) | await renderEpub(source, { profile, cover })。 |
| DOCX | renderDocx(source) | await renderDocx(source, profile)。 |
| — | @illusions-lab/mdi/node 將 Rust HTML 與 profile 交給 Chromium-capable host。 |
diagnostics 與 HTML
Section titled “diagnostics 與 HTML”匯出 UI 先呼叫 parse(source)/prepareRender(source)。document 保留 span，diagnostics 保留 warning。renderHtmlWithDiagnostics 另回傳 HTML 與 headings。Rust ABI 尚不能讓 renderer 接受 serialized IR handle，因此 helper 依序以同一份 source validate/render，而不創造第二個 parser。
renderHtml 回傳有 stylesheet 的完整 page；bodyOnly 回傳供 app shell 使用的 body contents。ruby 使用 <ruby>/<rt>/<rp>，MDI extension 有可預期的 mdi-* class。
EPUB/DOCX
Section titled “EPUB/DOCX”單一參數的 synchronous call 是 Rust baseline export。可設定 call 為 async，會把 Rust IR 結構轉換至 Node adapter，JavaScript 不會重新 parse MDI source。EPUB 接受 metadata、直排、font、indent、chapter level、JPEG/PNG cover；DOCX 接受 metadata、page size/orientation/margin、font/size/line spacing/indent、page number。
DOCX 將 pagebreak、書寫方向、paragraph 與可用 inline/run formatting map 到 OOXML。ruby、tate-chu-yoko、禁則/不換行、kern、強制 blank 的結果是 OOXML approximation，不是 browser-identical。重要組版請在實際 reader 驗證。
Chromium/PDF 邊界
Section titled “Chromium/PDF 邊界”@illusions-lab/mdi/node 的 preparePdfExport(source, profile) 回傳 Rust HTML、profile 與 front matter writing direction；Electron 可在自己的 BrowserWindow print。renderPdfWithChromium 會 load 另外安裝的 @illusions-lab/mdi-to-pdf (Playwright)，或使用 Electron-compatible { renderHtmlToPdf } adapter。
PDF adapter 套用紙張、橫向、邊距、直/橫排、font/size/line spacing、每行字數/每頁行數、indent、page number。browser WASM 不能 spawn Chromium，須把 request 交給 Node/Electron/Tauri/CLI host。Chromium 收到的是完成 HTML/CSS，從不接觸 .mdi。