document-svg 0.1.1

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,79 @@
+# Third-party notices
+
+## Current dependency audit and notice bundle
+
+The current audit is in [docs/LICENSE_AUDIT.md](docs/LICENSE_AUDIT.md), with the
+complete machine-readable inventory in [docs/DEPENDENCY_LICENSES.json](docs/DEPENDENCY_LICENSES.json).
+[THIRD_PARTY_LICENSES.txt](THIRD_PARTY_LICENSES.txt) retains the original dependency
+license/copyright texts and is included with the Rust, Node.js and Python distributions.
+
+This software is based in part on the work of the Independent JPEG Group.
+
+## Standard PDF font metrics
+
+`src/pdf_base14.rs` rearranges numeric glyph advances from eight Adobe Core 14 AFM
+files into Rust tables. Source revision, hashes and checked glyph counts are in the
+dependency inventory. Original copyright/trademark notices and permission are in
+[licenses/Adobe-Core14-AFM.txt](licenses/Adobe-Core14-AFM.txt) and the notice bundle.
+The source is [tc-font-core14-afms](https://github.com/tecnickcom/tc-font-core14-afms/tree/0675784d24b28a55c607cad6b74596ce19ce333c).
+
+## Optional cloud architecture assets
+
+`authoring/cloud_icons.py` は、Azure・AWS・Google Cloudの公式アイコンを利用者のローカル
+キャッシュへ取得する任意ツールです。素材とキャッシュ、デモ出力は配布に含めません。原本ZIPには配布元の同梱情報も保持します。
+
+- Microsoft Azure: https://learn.microsoft.com/en-us/azure/architecture/icons/ 。構成図・研修資料・文書への利用が認められています。原形を維持し、製品名を添え、回転・反転・切り抜き・変形を行いません。
+- AWS: https://aws.amazon.com/architecture/icons/ 。公式の構成図用素材を取得します。製品・リソース・カテゴリ・グループを区別します。
+- Google Cloud: https://cloud.google.com/icons 。現行のcore product/category素材を取得します。個別製品と共通カテゴリの使い分けは公式Product icons overviewに従います。
+
+取得元URL・確認日・リリース表記・ZIPのSHA-256は `authoring/icon-sources.json`、各SVGの
+出典・原本内パス・SHA-256は生成する `catalog.json` に記録します。
+
+## Runtime dependencies
+
+このプロジェクトは、コア実行時依存をMIT、Apache-2.0、BSD-3-Clause、Zlib、IJGなどの許容的ライセンスへ限定します。GPL、AGPL、SSPL、非商用限定、ソース公開を要求する依存は採用していません。
+
+直接依存:
+
+| crate | resolved version | license |
+|---|---:|---|
+| anyhow | 1.0.104 | MIT OR Apache-2.0 |
+| base64 | 0.23.1 | MIT OR Apache-2.0 |
+| clap | 4.6.6 | MIT OR Apache-2.0 |
+| emf-core | 0.1.0 | MIT |
+| hayro-ccitt | 0.3.0 | Apache-2.0 OR MIT |
+| jpeg-decoder | 0.3.2 | MIT OR Apache-2.0 |
+| lopdf | 0.44.0 | MIT |
+| png | 0.18.1 | MIT OR Apache-2.0 |
+| quick-xml | 0.41.0 | MIT |
+| rayon | 1.12.0 | MIT OR Apache-2.0 |
+| resvg | 0.48.1 | Apache-2.0 OR MIT |
+| serde | 1.0.229 | MIT OR Apache-2.0 |
+| serde_json | 1.0.151 | MIT OR Apache-2.0 |
+| stet-fonts | 0.4.1 | Apache-2.0 OR MIT |
+| skrifa | 0.44.0 | MIT OR Apache-2.0 |
+| zip | 8.6.0 | MIT |
+
+言語バインディング専用の直接依存:
+
+| crate | resolved version | license |
+|---|---:|---|
+| napi | 3.12.2 | MIT |
+| napi-derive | 3.6.3 | MIT |
+| napi-build | 2.4.1 | MIT |
+| pyo3 | 0.29.2 | MIT OR Apache-2.0 |
+| tempfile | 3.27.0 | MIT OR Apache-2.0 |
+
+実行時依存`jpeg-encoder 0.6.1`は、PDF内のCMYK/YCCK JPEGをブラウザ互換RGB JPEGへ正規化するために使用し、ライセンスは(MIT OR Apache-2.0) AND IJGです。`tempfile`はコアのテストに加えてNode.js preview APIの一時出力管理にも使用します。
+
+2026-08-23に次のコマンドで全推移依存のSPDX表現を確認し、必須のコピーレフト依存がないことを確認しました。複数ライセンスを`OR`で提示するcrateは、MIT、Apache-2.0または他の許容的選択肢を選択します。target固有推移依存`r-efi`の`MIT OR Apache-2.0 OR LGPL-2.1-or-later`からもMITを選択します。
+
+```bash
+cargo metadata --format-version 1 \
+  | jq -r '.packages[] | [.name,.version,(.license // "MISSING")] | @tsv' \
+  | sort -u
+```
+
+リリース前には`Cargo.lock`を基準に同じ監査を再実行し、各crateの配布物に含まれるLICENSE／NOTICEも保持してください。QAだけに使う`pdftoppm`、`rsvg-convert`、LibreOfficeは外部CLIであり、このcrateへリンク・同梱しません。
+
+参照元`pdfsvgpptx`はproprietary licenseです。そのコードをcopy/vendorせず、公開仕様と観察した入出力契約をもとに独立実装しています。参照QA文書、SVG、PPTX、画像はこの配布物へ含めません。

package/docs/preview.en.md

@@ -0,0 +1,147 @@
+# document-svg preview guide
+
+[日本語](preview.ja.md) · [English](preview.en.md) · [简体中文](preview.zh-CN.md)
+
+`document-svg` is a Node.js module that turns PDF, PowerPoint, Excel, and Word files into page-by-page SVG previews. Its Rust-native conversion runs on a Node.js worker, so it does not block the event loop.
+
+## What it can do
+
+- Convert PDF, PPTX, XLSX, and DOCX files into complete SVG strings, one per page
+- Produce in-memory previews without retaining output files
+- Run in Node.js servers, Electron main processes, and server-side TypeScript
+- Create Blob URLs or Data URLs for an `<img>`
+- Copy an SVG image or its exact XML source to the clipboard
+- Surface conversion warnings through `needsReview`
+- Package SVG pages into PPTX, DOCX, or XLSX as vector images
+
+This is not a browser-only WASM converter. Run document conversion in Node.js and use only `document-svg/preview-ui` in a renderer or browser context.
+
+## Install
+
+After publication:
+
+```bash
+npm install document-svg
+```
+
+To try the repository build:
+
+```bash
+cd bindings/node
+npm install
+npm run build
+npm test
+```
+
+Node.js 18 or newer is required. A published release installs the native package matching the user's operating system and CPU.
+
+## Minimal example: get SVG markup
+
+```js
+const { preview } = require('document-svg')
+
+async function main() {
+  const report = await preview('slides.pptx', { maxPages: 100 })
+  console.log(`${report.pageCount} pages`)
+  console.log(`review required: ${report.needsReview}`)
+  const firstPageSvg = report.pages[0]?.svg
+  console.log(firstPageSvg)
+}
+main().catch(console.error)
+```
+
+Each entry in `report.pages` includes its page number, complete SVG, dimensions in points, warnings, and estimated IR size. Temporary conversion files are removed before the Promise resolves.
+
+## Display in an `<img>`
+
+```js
+import {
+  createSvgPreviewUrl,
+  revokeSvgPreviewUrl,
+} from 'document-svg/preview-ui'
+
+const url = createSvgPreviewUrl(svgMarkup)
+imageElement.src = url
+
+// Release the URL when replacing the page or unmounting the view.
+revokeSvgPreviewUrl(url)
+```
+
+Use a Data URL across process, Markdown, or renderer boundaries where Blob URLs cannot be shared:
+
+```js
+import { createSvgPreviewDataUrl } from 'document-svg/preview-ui'
+imageElement.src = createSvgPreviewDataUrl(svgMarkup)
+```
+
+Data URLs are larger strings, so prefer Blob URLs within one renderer.
+
+## React example
+
+[`../examples/SvgPreview.tsx`](../examples/SvgPreview.tsx) includes Blob URL lifecycle management, copying, and an accessible `aria-live` status message.
+
+```tsx
+const report = await preview(filePath)
+return <SvgPreview svg={report.pages[currentPage].svg} />
+```
+
+## Runnable HTML example
+
+The included example converts every page into one standalone HTML preview:
+
+```bash
+npm run example:preview -- ./slides.pptx ./preview.html
+```
+
+See [`../examples/preview-to-html.cjs`](../examples/preview-to-html.cjs). It renders conversion warnings in the output and exits with status `2` when review is required.
+
+## Copy to the clipboard
+
+```js
+import { copySvgToClipboard } from 'document-svg/preview-ui'
+
+button.addEventListener('click', async () => {
+  const copiedType = await copySvgToClipboard(svgMarkup)
+  console.log(copiedType) // image/svg+xml or text/plain
+})
+```
+
+Clipboard APIs may require HTTPS or localhost and a user gesture such as a click. When the browser cannot write the SVG MIME type, the helper copies the exact SVG source as text.
+
+## Warnings and limits
+
+```js
+const report = await preview('report.docx', {
+  maxInputBytes: 512 * 1024 * 1024,
+  maxZipEntryBytes: 128 * 1024 * 1024,
+  maxPages: 100,
+  maxXmlEvents: 20_000_000,
+  maxSvgBytes: 64 * 1024 * 1024,
+  maxTotalSvgBytes: 256 * 1024 * 1024,
+  jobs: 1,
+})
+
+if (report.needsReview) {
+  console.warn(report.warnings)
+  console.warn(report.pages.flatMap((page) => page.warnings))
+}
+```
+
+`preview-ui` rejects SVG containing scripts, event attributes, external URLs, DOCTYPE declarations, or animation. Display previews through `<img>` instead of injecting them with `innerHTML`. Visually compare important files with their originals; zero warnings does not promise pixel-identical Office layout.
+
+## Choosing an API
+
+| API | Use case | Keeps files |
+|---|---|---|
+| `preview(input, options)` | SVG strings for a UI | No |
+| `convert(input, output, options)` | Batch conversion and saved artifacts | Yes |
+| `reverse(input, output, options)` | Put SVG into an Office file | Yes |
+| `createSvgPreviewUrl(svg)` | `<img>` in the same renderer | Blob URL only |
+| `createSvgPreviewDataUrl(svg)` | Preview across process boundaries | No |
+| `copySvgToClipboard(svg)` | Copy image or source | No |
+
+The generated SVG aims to preserve editable appearance. It does not preserve Office semantics such as paragraphs, cells, or formulas.
+
+## License
+
+`MIT OR Apache-2.0`, at your option. When redistributing, you must retain copyright and license notices as required by the license you choose. See the [full terms](../LICENSE).

package/docs/preview.ja.md

@@ -0,0 +1,147 @@
+# document-svg プレビューガイド
+
+[日本語](preview.ja.md) · [English](preview.en.md) · [简体中文](preview.zh-CN.md)
+
+`document-svg`は、PDF・PowerPoint・Excel・Word文書を、アプリで安全に表示しやすいページ別SVGへ変換するNode.jsモジュールです。変換はRustのネイティブ処理をNode.jsのworkerで実行するため、イベントループを占有しません。
+
+## できること
+
+- PDF、PPTX、XLSX、DOCXを1ページずつ完全なSVG文字列へ変換
+- 出力ファイルを残さないインメモリプレビュー
+- Node.jsサーバー、Electronのmain process、サーバー側TypeScriptでの利用
+- `<img>`向けBlob URL／Data URLの生成
+- SVG画像またはSVGソースのクリップボードコピー
+- 変換警告を`needsReview`で検出
+- SVGページをPPTX、DOCX、XLSXへベクター画像として格納
+
+純粋なブラウザだけで文書を変換するWASMモジュールではありません。文書変換はNode.js側で実行し、表示ヘルパー`document-svg/preview-ui`だけをrenderer／ブラウザ側で使います。
+
+## インストール
+
+公開後:
+
+```bash
+npm install document-svg
+```
+
+このリポジトリから試す場合:
+
+```bash
+cd bindings/node
+npm install
+npm run build
+npm test
+```
+
+Node.js 18以上が必要です。配布版では実行OS／CPUに合うネイティブパッケージも同時にインストールされます。
+
+## 最小例: 文書をSVG文字列へ変換
+
+```js
+const { preview } = require('document-svg')
+
+async function main() {
+  const report = await preview('slides.pptx', { maxPages: 100 })
+  console.log(`${report.pageCount} pages`)
+  console.log(`review required: ${report.needsReview}`)
+  const firstPageSvg = report.pages[0]?.svg
+  console.log(firstPageSvg)
+}
+main().catch(console.error)
+```
+
+`report.pages`にはページ番号、SVG、pt単位の幅と高さ、警告、推定IRサイズが入ります。一時出力はPromiseの完了前に削除されます。
+
+## `<img>`で表示する
+
+```js
+import {
+  createSvgPreviewUrl,
+  revokeSvgPreviewUrl,
+} from 'document-svg/preview-ui'
+
+const url = createSvgPreviewUrl(svgMarkup)
+imageElement.src = url
+
+// ページを差し替える時や画面を破棄する時に必ず解放する
+revokeSvgPreviewUrl(url)
+```
+
+プロセス境界、Markdown、Blob URLを共有できないrendererにはData URLを使えます。
+
+```js
+import { createSvgPreviewDataUrl } from 'document-svg/preview-ui'
+imageElement.src = createSvgPreviewDataUrl(svgMarkup)
+```
+
+Data URLは文字列が大きくなるため、同一画面内ではBlob URLを推奨します。
+
+## React例
+
+Blob URLの作成・解放、コピー操作、`aria-live`の状態表示まで含む実装は[`../examples/SvgPreview.tsx`](../examples/SvgPreview.tsx)にあります。
+
+```tsx
+const report = await preview(filePath)
+return <SvgPreview svg={report.pages[currentPage].svg} />
+```
+
+## 実行できるHTML生成例
+
+同梱の例は、文書の全ページを1つのHTMLプレビューへ書き出します。
+
+```bash
+npm run example:preview -- ./slides.pptx ./preview.html
+```
+
+実装は[`../examples/preview-to-html.cjs`](../examples/preview-to-html.cjs)を参照してください。変換警告がある場合はHTML内に表示し、終了コードを`2`にします。
+
+## クリップボードへコピー
+
+```js
+import { copySvgToClipboard } from 'document-svg/preview-ui'
+
+button.addEventListener('click', async () => {
+  const copiedType = await copySvgToClipboard(svgMarkup)
+  console.log(copiedType) // image/svg+xml または text/plain
+})
+```
+
+クリップボードAPIはHTTPS／localhostなどのsecure contextと、クリック等のユーザー操作を要求する場合があります。ブラウザがSVG MIMEを扱えない場合は、正確なSVGソースをテキストとしてコピーします。
+
+## 警告と安全上限
+
+```js
+const report = await preview('report.docx', {
+  maxInputBytes: 512 * 1024 * 1024,
+  maxZipEntryBytes: 128 * 1024 * 1024,
+  maxPages: 100,
+  maxXmlEvents: 20_000_000,
+  maxSvgBytes: 64 * 1024 * 1024,
+  maxTotalSvgBytes: 256 * 1024 * 1024,
+  jobs: 1,
+})
+
+if (report.needsReview) {
+  console.warn(report.warnings)
+  console.warn(report.pages.flatMap((page) => page.warnings))
+}
+```
+
+`preview-ui`は`script`、イベント属性、外部URL、DOCTYPE、animation等を含むSVGを拒否します。表示には`innerHTML`ではなく`<img>`を使ってください。重要文書は元文書との目視比較を行い、警告ゼロを画素単位の完全一致と解釈しないでください。
+
+## APIの使い分け
+
+| API | 用途 | ファイルを残す |
+|---|---|---|
+| `preview(input, options)` | UI向けSVG文字列 | いいえ |
+| `convert(input, output, options)` | バッチ変換、成果物保存 | はい |
+| `reverse(input, output, options)` | SVGをOffice形式へ格納 | はい |
+| `createSvgPreviewUrl(svg)` | 同一rendererの`<img>`表示 | Blob URLのみ |
+| `createSvgPreviewDataUrl(svg)` | プロセス境界を越える表示 | いいえ |
+| `copySvgToClipboard(svg)` | 画像／ソースをコピー | いいえ |
+
+変換後のSVGは編集可能な見た目を優先しますが、Officeの段落・セル・数式等の意味構造を保持するものではありません。
+
+## ライセンス
+
+`MIT OR Apache-2.0`。いずれかを選択できます。再配布時は、選択したライセンスに従い著作権表示・ライセンス文を必ず保持してください。[全文](../LICENSE)。

package/docs/preview.zh-CN.md

@@ -0,0 +1,147 @@
+# document-svg 预览指南
+
+[日本語](preview.ja.md) · [English](preview.en.md) · [简体中文](preview.zh-CN.md)
+
+`document-svg` 是一个 Node.js 模块，可将 PDF、PowerPoint、Excel 和 Word 文档逐页转换为 SVG 预览。转换由 Rust 原生代码在 Node.js worker 中执行，不会阻塞事件循环。
+
+## 可以做什么
+
+- 将 PDF、PPTX、XLSX、DOCX 转换为每页一个完整的 SVG 字符串
+- 在内存中生成预览，不保留输出文件
+- 用于 Node.js 服务端、Electron main process 和服务端 TypeScript
+- 为 `<img>` 创建 Blob URL 或 Data URL
+- 将 SVG 图像或完整 XML 源码复制到剪贴板
+- 通过 `needsReview` 报告转换警告
+- 将 SVG 页面作为矢量图打包到 PPTX、DOCX 或 XLSX
+
+它不是仅在浏览器中运行的 WASM 转换器。文档转换应在 Node.js 端执行；renderer 或浏览器端只使用`document-svg/preview-ui`。
+
+## 安装
+
+发布后：
+
+```bash
+npm install document-svg
+```
+
+从本仓库试用：
+
+```bash
+cd bindings/node
+npm install
+npm run build
+npm test
+```
+
+需要 Node.js 18 或更高版本。正式发布时，会同时安装与用户操作系统和CPU匹配的原生包。
+
+## 最小示例：取得SVG字符串
+
+```js
+const { preview } = require('document-svg')
+
+async function main() {
+  const report = await preview('slides.pptx', { maxPages: 100 })
+  console.log(`${report.pageCount} pages`)
+  console.log(`review required: ${report.needsReview}`)
+  const firstPageSvg = report.pages[0]?.svg
+  console.log(firstPageSvg)
+}
+main().catch(console.error)
+```
+
+`report.pages`中的每个项目都包含页码、完整SVG、以pt为单位的宽高、警告和估算的IR大小。Promise完成前，临时转换文件会被删除。
+
+## 在`<img>`中显示
+
+```js
+import {
+  createSvgPreviewUrl,
+  revokeSvgPreviewUrl,
+} from 'document-svg/preview-ui'
+
+const url = createSvgPreviewUrl(svgMarkup)
+imageElement.src = url
+
+// 更换页面或卸载视图时释放URL
+revokeSvgPreviewUrl(url)
+```
+
+如果需要跨进程、Markdown或renderer边界传递，Blob URL无法共享时可使用Data URL：
+
+```js
+import { createSvgPreviewDataUrl } from 'document-svg/preview-ui'
+imageElement.src = createSvgPreviewDataUrl(svgMarkup)
+```
+
+Data URL字符串更大，因此在同一个renderer中建议使用Blob URL。
+
+## React示例
+
+[`../examples/SvgPreview.tsx`](../examples/SvgPreview.tsx)包含Blob URL的创建与释放、复制操作，以及可访问的`aria-live`状态提示。
+
+```tsx
+const report = await preview(filePath)
+return <SvgPreview svg={report.pages[currentPage].svg} />
+```
+
+## 可运行的HTML示例
+
+附带示例可将文档的所有页面写入一个独立HTML预览文件：
+
+```bash
+npm run example:preview -- ./slides.pptx ./preview.html
+```
+
+实现请参阅[`../examples/preview-to-html.cjs`](../examples/preview-to-html.cjs)。转换警告会显示在HTML中；需要人工检查时，进程退出码为`2`。
+
+## 复制到剪贴板
+
+```js
+import { copySvgToClipboard } from 'document-svg/preview-ui'
+
+button.addEventListener('click', async () => {
+  const copiedType = await copySvgToClipboard(svgMarkup)
+  console.log(copiedType) // image/svg+xml 或 text/plain
+})
+```
+
+剪贴板API可能要求HTTPS或localhost环境，并且必须由点击等用户操作触发。如果浏览器不支持写入SVG MIME类型，辅助函数会将完整SVG源码作为文本复制。
+
+## 警告和安全限制
+
+```js
+const report = await preview('report.docx', {
+  maxInputBytes: 512 * 1024 * 1024,
+  maxZipEntryBytes: 128 * 1024 * 1024,
+  maxPages: 100,
+  maxXmlEvents: 20_000_000,
+  maxSvgBytes: 64 * 1024 * 1024,
+  maxTotalSvgBytes: 256 * 1024 * 1024,
+  jobs: 1,
+})
+
+if (report.needsReview) {
+  console.warn(report.warnings)
+  console.warn(report.pages.flatMap((page) => page.warnings))
+}
+```
+
+`preview-ui`会拒绝包含脚本、事件属性、外部URL、DOCTYPE或动画的SVG。请通过`<img>`显示预览，不要用`innerHTML`注入。重要文档应与原文件进行目视比较；没有警告并不代表与Office像素级完全一致。
+
+## API选择
+
+| API | 用途 | 是否保留文件 |
+|---|---|---|
+| `preview(input, options)` | 为UI返回SVG字符串 | 否 |
+| `convert(input, output, options)` | 批量转换并保存结果 | 是 |
+| `reverse(input, output, options)` | 将SVG放入Office文件 | 是 |
+| `createSvgPreviewUrl(svg)` | 在同一renderer的`<img>`中显示 | 仅Blob URL |
+| `createSvgPreviewDataUrl(svg)` | 跨进程边界显示 | 否 |
+| `copySvgToClipboard(svg)` | 复制图像或源码 | 否 |
+
+生成的SVG以保留可编辑外观为目标，但不会保留段落、单元格、公式等Office语义结构。
+
+## 许可证
+
+`MIT OR Apache-2.0`，您可以选择其中一种。再分发时，必须按照所选许可证保留版权声明和许可证文本。参阅[完整条款](../LICENSE)。

package/examples/SvgPreview.tsx

@@ -0,0 +1,58 @@
+import { useEffect, useState } from "react"
+
+import {
+  copySvgToClipboard,
+  createSvgPreviewUrl,
+  revokeSvgPreviewUrl,
+} from "document-svg/preview-ui"
+
+export interface SvgPreviewProps {
+  svg: string
+  alt?: string
+}
+
+export function SvgPreview({
+  svg,
+  alt = "Office document preview",
+}: SvgPreviewProps) {
+  const [previewUrl, setPreviewUrl] = useState<string>()
+  const [copyStatus, setCopyStatus] = useState("")
+
+  useEffect(() => {
+    const url = createSvgPreviewUrl(svg)
+    setPreviewUrl(url)
+    setCopyStatus("")
+    return () => revokeSvgPreviewUrl(url)
+  }, [svg])
+
+  async function copySvg() {
+    try {
+      const format = await copySvgToClipboard(svg)
+      setCopyStatus(
+        format === "image/svg+xml"
+          ? "SVG画像をコピーしました"
+          : "SVGソースをコピーしました",
+      )
+    } catch (error) {
+      setCopyStatus(
+        error instanceof Error
+          ? `コピーできませんでした: ${error.message}`
+          : "コピーできませんでした",
+      )
+    }
+  }
+
+  return (
+    <figure>
+      {previewUrl && <img src={previewUrl} alt={alt} />}
+      <figcaption>
+        <button type="button" onClick={copySvg}>
+          SVGをコピー
+        </button>
+        <span role="status" aria-live="polite">
+          {copyStatus}
+        </span>
+      </figcaption>
+    </figure>
+  )
+}

package/examples/preview-to-html.cjs

@@ -0,0 +1,69 @@
+'use strict'
+
+const { writeFile } = require('node:fs/promises')
+const { resolve } = require('node:path')
+
+const { preview } = require('document-svg')
+const { createSvgPreviewDataUrl } = require('document-svg/preview-ui')
+
+async function main() {
+  const input = process.argv[2]
+  const output = resolve(process.argv[3] || 'document-preview.html')
+  if (!input) {
+    throw new Error(
+      'Usage: node examples/preview-to-html.cjs INPUT.pdf|pptx|xlsx|docx [OUTPUT.html]',
+    )
+  }
+
+  const report = await preview(resolve(input), {
+    maxPages: 100,
+    maxSvgBytes: 64 * 1024 * 1024,
+    maxTotalSvgBytes: 256 * 1024 * 1024,
+  })
+
+  const pages = report.pages
+    .map((page) => {
+      const url = createSvgPreviewDataUrl(page.svg)
+      return `<figure><img src="${url}" alt="Page ${page.number}"><figcaption>Page ${page.number}</figcaption></figure>`
+    })
+    .join('\n')
+
+  const warnings = report.warnings.length
+    ? `<pre>${escapeHtml(report.warnings.join('\n'))}</pre>`
+    : '<p>No conversion warnings.</p>'
+
+  const html = `<!doctype html>
+<html lang="en">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Document SVG preview</title>
+<style>
+  body { margin: 0 auto; max-width: 72rem; padding: 2rem; background: #eee; font: 16px system-ui; }
+  header, figure { background: white; padding: 1rem; border-radius: .5rem; }
+  figure { margin: 1rem 0; box-shadow: 0 2px 12px #0002; }
+  img { display: block; width: 100%; height: auto; }
+  figcaption { margin-top: .5rem; color: #555; }
+</style>
+<header><h1>${escapeHtml(report.sourceFormat.toUpperCase())} preview</h1>${warnings}</header>
+<main>${pages}</main>
+</html>`
+
+  await writeFile(output, html, { encoding: 'utf8', flag: 'wx' })
+  console.log(`Wrote ${report.pageCount} page(s) to ${output}`)
+  if (report.needsReview) process.exitCode = 2
+}
+
+function escapeHtml(value) {
+  return value.replace(/[&<>"']/g, (character) => ({
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+  })[character])
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error)
+  process.exitCode = 1
+})