@boxpdf/html-writer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Erik Aronesty
+
+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.

package/README.md

@@ -0,0 +1,62 @@
+# `@boxpdf/html-writer`
+
+Streams text-oriented HTML from pages produced by `@boxpdf/reader`. This is the
+PDF-to-HTML package; it is intentionally named differently from `boxpdf-html`,
+which converts HTML in the opposite direction.
+
+```ts
+import { open } from "node:fs/promises";
+import { openPdf } from "@boxpdf/reader";
+import { fileSource } from "@boxpdf/reader/node";
+import { writeHtmlDocument } from "@boxpdf/html-writer";
+
+const source = await fileSource("input.pdf");
+const pdf = await openPdf(source);
+const output = await open("output.html", "w");
+
+try {
+  await writeHtmlDocument(pdf.pages(), async (chunk) => {
+    await output.write(chunk);
+  });
+} finally {
+  await output.close();
+  pdf.close();
+  await source.close();
+}
+```
+
+The default `positioned` layout preserves text coordinates. The optional
+`flow` layout uses the reader's inferred lines and tables. Images, vector
+graphics, and exact font reproduction are not yet rendered.
+
+The callback is awaited for every chunk, so a file stream, HTTP response, or
+Web `WritableStream` can apply backpressure. The caller owns and closes the PDF
+source, reader, and destination; the writer owns only HTML serialization. See
+[`examples/file.ts`](examples/file.ts) for Node file-to-file conversion and
+[`examples/http.ts`](examples/http.ts) for a streaming Web `Response`. Validate
+or allowlist user-provided PDF URLs before passing them to the HTTP example.
+
+## Compatibility oracle
+
+Tests compare normalized page geometry, text, and anchor positions with
+Poppler's `pdftohtml -c -hidden -noframes -zoom 1` output. Poppler runs only as
+an independent test oracle; its resource use is not part of the writer's memory
+contract.
+
+`pnpm poppler:report` runs the positioned writer over all 62 text fixtures in
+the pinned PDF.js corpus. The checked-in baseline currently records exact text
+and geometry agreement on 51 fixtures. The remaining cases are retained in the
+denominator; most exercise intentional PDF.js/Poppler differences in RTL text,
+font encodings, or malformed Unicode maps. `pnpm poppler:gate` rejects any loss
+from the known-good pass set and runs in CI.
+
+The writer retains the reader's logical Unicode order. RTL spans and flow lines
+receive `dir="rtl"` plus isolated bidirectional CSS so browsers perform visual
+ordering without changing extracted text. Vertical spans use CSS writing mode.
+Poppler emits visual-order text for several RTL corpus files, so those source
+strings are expected to differ.
+
+`issue16224` is the geometry exception: its 531 × 666 point MediaBox contains an
+182.77 × 32.539 point CropBox. PDF.js, `pdfinfo`, and the reader expose the
+CropBox as page size; Poppler 22.02 `pdftohtml` emits the MediaBox. The writer
+keeps the PDF.js-compatible CropBox dimensions.

package/dist/index.cjs

@@ -0,0 +1,138 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  pageToHtml: () => pageToHtml,
+  writeHtmlDocument: () => writeHtmlDocument,
+  writePage: () => writePage
+});
+module.exports = __toCommonJS(index_exports);
+var import_structure = require("@boxpdf/reader/structure");
+var styles = `.pdf-document{margin:0 auto}.pdf-page{box-sizing:border-box;margin:1rem auto;background:#fff;color:#000}.pdf-page--positioned{position:relative;overflow:hidden}.pdf-page-content{position:absolute;transform-origin:0 0}.pdf-page-content--90{transform:translateX(100%) rotate(90deg)}.pdf-page-content--180{transform:translate(100%,100%) rotate(180deg)}.pdf-page-content--270{transform:translateY(100%) rotate(270deg)}.pdf-span{position:absolute;white-space:pre;transform-origin:left bottom;unicode-bidi:isolate}.pdf-span[data-direction=ttb]{writing-mode:vertical-rl}.pdf-page--flow{max-width:60rem;padding:1rem}.pdf-page--flow p{white-space:pre-wrap;unicode-bidi:plaintext}.pdf-page table{border-collapse:collapse}.pdf-page td{padding:.15rem .4rem;vertical-align:top}`;
+async function writeHtmlDocument(pages, write, options = {}) {
+  const includeDocument = options.includeDocument ?? true;
+  if (includeDocument) {
+    await write("<!doctype html><html");
+    await write(
+      ` lang="${escapeAttribute(options.language ?? "en")}"><head><meta charset="utf-8">`
+    );
+    await write('<meta name="viewport" content="width=device-width,initial-scale=1">');
+    await write(`<title>${escapeHtml(options.title ?? "PDF document")}</title>`);
+    if (options.includeStyles ?? true) await write(`<style>${styles}</style>`);
+    await write("</head><body>");
+  }
+  await write('<main class="pdf-document">');
+  for await (const page of pages) await writePage(page, write, options);
+  await write("</main>");
+  if (includeDocument) await write("</body></html>");
+}
+async function writePage(page, write, options = {}) {
+  if ((options.layout ?? "positioned") === "flow") await writeFlowPage(page, write);
+  else await writePositionedPage(page, write);
+}
+async function pageToHtml(page, options = {}) {
+  let output = "";
+  await writePage(
+    page,
+    (chunk) => {
+      output += chunk;
+    },
+    options
+  );
+  return output;
+}
+async function writePositionedPage(page, write) {
+  const quarterTurn = page.rotate === 90 || page.rotate === 270;
+  const displayWidth = quarterTurn ? page.height : page.width;
+  const displayHeight = quarterTurn ? page.width : page.height;
+  await write(
+    `<section class="pdf-page pdf-page--positioned" data-page="${page.number}" data-rotate="${page.rotate}" style="width:${number(displayWidth)}pt;height:${number(displayHeight)}pt">`
+  );
+  await write(
+    `<div class="pdf-page-content pdf-page-content--${page.rotate}" style="width:${number(page.width)}pt;height:${number(page.height)}pt">`
+  );
+  for (const span of page.spans) await write(positionedSpan(span));
+  await write("</div></section>");
+}
+async function writeFlowPage(page, write) {
+  const structured = (0, import_structure.structurePage)(page);
+  const tables = [...structured.tables].sort((left, right) => right.bounds.y - left.bounds.y);
+  const emittedTables = /* @__PURE__ */ new Set();
+  await write(`<section class="pdf-page pdf-page--flow" data-page="${page.number}">`);
+  for (const line of structured.lines) {
+    const table = tables.find((candidate) => containsY(candidate, line.bounds.y));
+    if (table) {
+      if (!emittedTables.has(table)) {
+        await write((0, import_structure.tableToHtml)(table));
+        emittedTables.add(table);
+      }
+      continue;
+    }
+    await write(`<p${directionAttribute(line.spans)}>${escapeHtml(line.text)}</p>`);
+  }
+  for (const table of tables) {
+    if (!emittedTables.has(table)) await write((0, import_structure.tableToHtml)(table));
+  }
+  await write("</section>");
+}
+function positionedSpan(span) {
+  const direction = directionAttribute([span]);
+  const style = [
+    `left:${number(span.bounds.x)}pt`,
+    `bottom:${number(span.bounds.y)}pt`,
+    `width:${number(span.bounds.width)}pt`,
+    `height:${number(span.bounds.height)}pt`,
+    `font-size:${number(span.fontSize)}pt`
+  ].join(";");
+  return `<span class="pdf-span"${direction} style="${style}">${escapeHtml(span.text)}</span>`;
+}
+function directionAttribute(spans) {
+  const rtl = spans.filter((span) => span.direction === "rtl").length;
+  const vertical = spans.filter((span) => span.direction === "ttb").length;
+  if (vertical > rtl && vertical * 2 >= spans.length) return ' data-direction="ttb"';
+  return rtl * 2 >= spans.length && spans.length > 0 ? ' dir="rtl"' : "";
+}
+function containsY(table, y) {
+  return y >= table.bounds.y && y <= table.bounds.y + table.bounds.height;
+}
+function number(value) {
+  return Number.isFinite(value) ? String(Math.round(value * 1e3) / 1e3) : "0";
+}
+function escapeAttribute(value) {
+  return escapeHtml(value).replaceAll("`", "&#96;");
+}
+function escapeHtml(value) {
+  return [...value].map((character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    if (codePoint === 13) return "\n";
+    return isForbiddenControl(codePoint) ? "\uFFFD" : character;
+  }).join("").replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+function isForbiddenControl(codePoint) {
+  return codePoint <= 8 || codePoint === 11 || codePoint === 12 || codePoint >= 14 && codePoint <= 31 || codePoint === 127;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  pageToHtml,
+  writeHtmlDocument,
+  writePage
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { ExtractedPage, TextSpan } from \"@boxpdf/reader\";\nimport { structurePage, type Table, tableToHtml } from \"@boxpdf/reader/structure\";\n\nexport type HtmlLayout = \"positioned\" | \"flow\";\nexport type HtmlWrite = (chunk: string) => void | Promise<void>;\n\nexport interface HtmlWriterOptions {\n  layout?: HtmlLayout;\n  title?: string;\n  language?: string;\n  includeDocument?: boolean;\n  includeStyles?: boolean;\n}\n\nconst styles = `.pdf-document{margin:0 auto}.pdf-page{box-sizing:border-box;margin:1rem auto;background:#fff;color:#000}.pdf-page--positioned{position:relative;overflow:hidden}.pdf-page-content{position:absolute;transform-origin:0 0}.pdf-page-content--90{transform:translateX(100%) rotate(90deg)}.pdf-page-content--180{transform:translate(100%,100%) rotate(180deg)}.pdf-page-content--270{transform:translateY(100%) rotate(270deg)}.pdf-span{position:absolute;white-space:pre;transform-origin:left bottom;unicode-bidi:isolate}.pdf-span[data-direction=ttb]{writing-mode:vertical-rl}.pdf-page--flow{max-width:60rem;padding:1rem}.pdf-page--flow p{white-space:pre-wrap;unicode-bidi:plaintext}.pdf-page table{border-collapse:collapse}.pdf-page td{padding:.15rem .4rem;vertical-align:top}`;\n\nexport async function writeHtmlDocument(\n  pages: AsyncIterable<ExtractedPage> | Iterable<ExtractedPage>,\n  write: HtmlWrite,\n  options: HtmlWriterOptions = {},\n): Promise<void> {\n  const includeDocument = options.includeDocument ?? true;\n  if (includeDocument) {\n    await write(\"<!doctype html><html\");\n    await write(\n      ` lang=\"${escapeAttribute(options.language ?? \"en\")}\"><head><meta charset=\"utf-8\">`,\n    );\n    await write('<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">');\n    await write(`<title>${escapeHtml(options.title ?? \"PDF document\")}</title>`);\n    if (options.includeStyles ?? true) await write(`<style>${styles}</style>`);\n    await write(\"</head><body>\");\n  }\n  await write('<main class=\"pdf-document\">');\n  for await (const page of pages) await writePage(page, write, options);\n  await write(\"</main>\");\n  if (includeDocument) await write(\"</body></html>\");\n}\n\nexport async function writePage(\n  page: ExtractedPage,\n  write: HtmlWrite,\n  options: HtmlWriterOptions = {},\n): Promise<void> {\n  if ((options.layout ?? \"positioned\") === \"flow\") await writeFlowPage(page, write);\n  else await writePositionedPage(page, write);\n}\n\nexport async function pageToHtml(\n  page: ExtractedPage,\n  options: HtmlWriterOptions = {},\n): Promise<string> {\n  let output = \"\";\n  await writePage(\n    page,\n    (chunk) => {\n      output += chunk;\n    },\n    options,\n  );\n  return output;\n}\n\nasync function writePositionedPage(page: ExtractedPage, write: HtmlWrite): Promise<void> {\n  const quarterTurn = page.rotate === 90 || page.rotate === 270;\n  const displayWidth = quarterTurn ? page.height : page.width;\n  const displayHeight = quarterTurn ? page.width : page.height;\n  await write(\n    `<section class=\"pdf-page pdf-page--positioned\" data-page=\"${page.number}\" data-rotate=\"${page.rotate}\" style=\"width:${number(displayWidth)}pt;height:${number(displayHeight)}pt\">`,\n  );\n  await write(\n    `<div class=\"pdf-page-content pdf-page-content--${page.rotate}\" style=\"width:${number(page.width)}pt;height:${number(page.height)}pt\">`,\n  );\n  for (const span of page.spans) await write(positionedSpan(span));\n  await write(\"</div></section>\");\n}\n\nasync function writeFlowPage(page: ExtractedPage, write: HtmlWrite): Promise<void> {\n  const structured = structurePage(page);\n  const tables = [...structured.tables].sort((left, right) => right.bounds.y - left.bounds.y);\n  const emittedTables = new Set<Table>();\n  await write(`<section class=\"pdf-page pdf-page--flow\" data-page=\"${page.number}\">`);\n  for (const line of structured.lines) {\n    const table = tables.find((candidate) => containsY(candidate, line.bounds.y));\n    if (table) {\n      if (!emittedTables.has(table)) {\n        await write(tableToHtml(table));\n        emittedTables.add(table);\n      }\n      continue;\n    }\n    await write(`<p${directionAttribute(line.spans)}>${escapeHtml(line.text)}</p>`);\n  }\n  for (const table of tables) {\n    if (!emittedTables.has(table)) await write(tableToHtml(table));\n  }\n  await write(\"</section>\");\n}\n\nfunction positionedSpan(span: TextSpan): string {\n  const direction = directionAttribute([span]);\n  const style = [\n    `left:${number(span.bounds.x)}pt`,\n    `bottom:${number(span.bounds.y)}pt`,\n    `width:${number(span.bounds.width)}pt`,\n    `height:${number(span.bounds.height)}pt`,\n    `font-size:${number(span.fontSize)}pt`,\n  ].join(\";\");\n  return `<span class=\"pdf-span\"${direction} style=\"${style}\">${escapeHtml(span.text)}</span>`;\n}\n\nfunction directionAttribute(spans: TextSpan[]): string {\n  const rtl = spans.filter((span) => span.direction === \"rtl\").length;\n  const vertical = spans.filter((span) => span.direction === \"ttb\").length;\n  if (vertical > rtl && vertical * 2 >= spans.length) return ' data-direction=\"ttb\"';\n  return rtl * 2 >= spans.length && spans.length > 0 ? ' dir=\"rtl\"' : \"\";\n}\n\nfunction containsY(table: Table, y: number): boolean {\n  return y >= table.bounds.y && y <= table.bounds.y + table.bounds.height;\n}\n\nfunction number(value: number): string {\n  return Number.isFinite(value) ? String(Math.round(value * 1000) / 1000) : \"0\";\n}\n\nfunction escapeAttribute(value: string): string {\n  return escapeHtml(value).replaceAll(\"`\", \"&#96;\");\n}\n\nfunction escapeHtml(value: string): string {\n  return [...value]\n    .map((character) => {\n      const codePoint = character.codePointAt(0) ?? 0;\n      if (codePoint === 13) return \"\\n\";\n      return isForbiddenControl(codePoint) ? \"�\" : character;\n    })\n    .join(\"\")\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&#39;\");\n}\n\nfunction isForbiddenControl(codePoint: number): boolean {\n  return (\n    codePoint <= 8 ||\n    codePoint === 11 ||\n    codePoint === 12 ||\n    (codePoint >= 14 && codePoint <= 31) ||\n    codePoint === 127\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import { ExtractedPage } from '@boxpdf/reader';
+
+type HtmlLayout = "positioned" | "flow";
+type HtmlWrite = (chunk: string) => void | Promise<void>;
+interface HtmlWriterOptions {
+    layout?: HtmlLayout;
+    title?: string;
+    language?: string;
+    includeDocument?: boolean;
+    includeStyles?: boolean;
+}
+declare function writeHtmlDocument(pages: AsyncIterable<ExtractedPage> | Iterable<ExtractedPage>, write: HtmlWrite, options?: HtmlWriterOptions): Promise<void>;
+declare function writePage(page: ExtractedPage, write: HtmlWrite, options?: HtmlWriterOptions): Promise<void>;
+declare function pageToHtml(page: ExtractedPage, options?: HtmlWriterOptions): Promise<string>;
+
+export { type HtmlLayout, type HtmlWrite, type HtmlWriterOptions, pageToHtml, writeHtmlDocument, writePage };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { ExtractedPage } from '@boxpdf/reader';
+
+type HtmlLayout = "positioned" | "flow";
+type HtmlWrite = (chunk: string) => void | Promise<void>;
+interface HtmlWriterOptions {
+    layout?: HtmlLayout;
+    title?: string;
+    language?: string;
+    includeDocument?: boolean;
+    includeStyles?: boolean;
+}
+declare function writeHtmlDocument(pages: AsyncIterable<ExtractedPage> | Iterable<ExtractedPage>, write: HtmlWrite, options?: HtmlWriterOptions): Promise<void>;
+declare function writePage(page: ExtractedPage, write: HtmlWrite, options?: HtmlWriterOptions): Promise<void>;
+declare function pageToHtml(page: ExtractedPage, options?: HtmlWriterOptions): Promise<string>;
+
+export { type HtmlLayout, type HtmlWrite, type HtmlWriterOptions, pageToHtml, writeHtmlDocument, writePage };

package/dist/index.js

@@ -0,0 +1,111 @@
+// src/index.ts
+import { structurePage, tableToHtml } from "@boxpdf/reader/structure";
+var styles = `.pdf-document{margin:0 auto}.pdf-page{box-sizing:border-box;margin:1rem auto;background:#fff;color:#000}.pdf-page--positioned{position:relative;overflow:hidden}.pdf-page-content{position:absolute;transform-origin:0 0}.pdf-page-content--90{transform:translateX(100%) rotate(90deg)}.pdf-page-content--180{transform:translate(100%,100%) rotate(180deg)}.pdf-page-content--270{transform:translateY(100%) rotate(270deg)}.pdf-span{position:absolute;white-space:pre;transform-origin:left bottom;unicode-bidi:isolate}.pdf-span[data-direction=ttb]{writing-mode:vertical-rl}.pdf-page--flow{max-width:60rem;padding:1rem}.pdf-page--flow p{white-space:pre-wrap;unicode-bidi:plaintext}.pdf-page table{border-collapse:collapse}.pdf-page td{padding:.15rem .4rem;vertical-align:top}`;
+async function writeHtmlDocument(pages, write, options = {}) {
+  const includeDocument = options.includeDocument ?? true;
+  if (includeDocument) {
+    await write("<!doctype html><html");
+    await write(
+      ` lang="${escapeAttribute(options.language ?? "en")}"><head><meta charset="utf-8">`
+    );
+    await write('<meta name="viewport" content="width=device-width,initial-scale=1">');
+    await write(`<title>${escapeHtml(options.title ?? "PDF document")}</title>`);
+    if (options.includeStyles ?? true) await write(`<style>${styles}</style>`);
+    await write("</head><body>");
+  }
+  await write('<main class="pdf-document">');
+  for await (const page of pages) await writePage(page, write, options);
+  await write("</main>");
+  if (includeDocument) await write("</body></html>");
+}
+async function writePage(page, write, options = {}) {
+  if ((options.layout ?? "positioned") === "flow") await writeFlowPage(page, write);
+  else await writePositionedPage(page, write);
+}
+async function pageToHtml(page, options = {}) {
+  let output = "";
+  await writePage(
+    page,
+    (chunk) => {
+      output += chunk;
+    },
+    options
+  );
+  return output;
+}
+async function writePositionedPage(page, write) {
+  const quarterTurn = page.rotate === 90 || page.rotate === 270;
+  const displayWidth = quarterTurn ? page.height : page.width;
+  const displayHeight = quarterTurn ? page.width : page.height;
+  await write(
+    `<section class="pdf-page pdf-page--positioned" data-page="${page.number}" data-rotate="${page.rotate}" style="width:${number(displayWidth)}pt;height:${number(displayHeight)}pt">`
+  );
+  await write(
+    `<div class="pdf-page-content pdf-page-content--${page.rotate}" style="width:${number(page.width)}pt;height:${number(page.height)}pt">`
+  );
+  for (const span of page.spans) await write(positionedSpan(span));
+  await write("</div></section>");
+}
+async function writeFlowPage(page, write) {
+  const structured = structurePage(page);
+  const tables = [...structured.tables].sort((left, right) => right.bounds.y - left.bounds.y);
+  const emittedTables = /* @__PURE__ */ new Set();
+  await write(`<section class="pdf-page pdf-page--flow" data-page="${page.number}">`);
+  for (const line of structured.lines) {
+    const table = tables.find((candidate) => containsY(candidate, line.bounds.y));
+    if (table) {
+      if (!emittedTables.has(table)) {
+        await write(tableToHtml(table));
+        emittedTables.add(table);
+      }
+      continue;
+    }
+    await write(`<p${directionAttribute(line.spans)}>${escapeHtml(line.text)}</p>`);
+  }
+  for (const table of tables) {
+    if (!emittedTables.has(table)) await write(tableToHtml(table));
+  }
+  await write("</section>");
+}
+function positionedSpan(span) {
+  const direction = directionAttribute([span]);
+  const style = [
+    `left:${number(span.bounds.x)}pt`,
+    `bottom:${number(span.bounds.y)}pt`,
+    `width:${number(span.bounds.width)}pt`,
+    `height:${number(span.bounds.height)}pt`,
+    `font-size:${number(span.fontSize)}pt`
+  ].join(";");
+  return `<span class="pdf-span"${direction} style="${style}">${escapeHtml(span.text)}</span>`;
+}
+function directionAttribute(spans) {
+  const rtl = spans.filter((span) => span.direction === "rtl").length;
+  const vertical = spans.filter((span) => span.direction === "ttb").length;
+  if (vertical > rtl && vertical * 2 >= spans.length) return ' data-direction="ttb"';
+  return rtl * 2 >= spans.length && spans.length > 0 ? ' dir="rtl"' : "";
+}
+function containsY(table, y) {
+  return y >= table.bounds.y && y <= table.bounds.y + table.bounds.height;
+}
+function number(value) {
+  return Number.isFinite(value) ? String(Math.round(value * 1e3) / 1e3) : "0";
+}
+function escapeAttribute(value) {
+  return escapeHtml(value).replaceAll("`", "&#96;");
+}
+function escapeHtml(value) {
+  return [...value].map((character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    if (codePoint === 13) return "\n";
+    return isForbiddenControl(codePoint) ? "\uFFFD" : character;
+  }).join("").replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+function isForbiddenControl(codePoint) {
+  return codePoint <= 8 || codePoint === 11 || codePoint === 12 || codePoint >= 14 && codePoint <= 31 || codePoint === 127;
+}
+export {
+  pageToHtml,
+  writeHtmlDocument,
+  writePage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { ExtractedPage, TextSpan } from \"@boxpdf/reader\";\nimport { structurePage, type Table, tableToHtml } from \"@boxpdf/reader/structure\";\n\nexport type HtmlLayout = \"positioned\" | \"flow\";\nexport type HtmlWrite = (chunk: string) => void | Promise<void>;\n\nexport interface HtmlWriterOptions {\n  layout?: HtmlLayout;\n  title?: string;\n  language?: string;\n  includeDocument?: boolean;\n  includeStyles?: boolean;\n}\n\nconst styles = `.pdf-document{margin:0 auto}.pdf-page{box-sizing:border-box;margin:1rem auto;background:#fff;color:#000}.pdf-page--positioned{position:relative;overflow:hidden}.pdf-page-content{position:absolute;transform-origin:0 0}.pdf-page-content--90{transform:translateX(100%) rotate(90deg)}.pdf-page-content--180{transform:translate(100%,100%) rotate(180deg)}.pdf-page-content--270{transform:translateY(100%) rotate(270deg)}.pdf-span{position:absolute;white-space:pre;transform-origin:left bottom;unicode-bidi:isolate}.pdf-span[data-direction=ttb]{writing-mode:vertical-rl}.pdf-page--flow{max-width:60rem;padding:1rem}.pdf-page--flow p{white-space:pre-wrap;unicode-bidi:plaintext}.pdf-page table{border-collapse:collapse}.pdf-page td{padding:.15rem .4rem;vertical-align:top}`;\n\nexport async function writeHtmlDocument(\n  pages: AsyncIterable<ExtractedPage> | Iterable<ExtractedPage>,\n  write: HtmlWrite,\n  options: HtmlWriterOptions = {},\n): Promise<void> {\n  const includeDocument = options.includeDocument ?? true;\n  if (includeDocument) {\n    await write(\"<!doctype html><html\");\n    await write(\n      ` lang=\"${escapeAttribute(options.language ?? \"en\")}\"><head><meta charset=\"utf-8\">`,\n    );\n    await write('<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">');\n    await write(`<title>${escapeHtml(options.title ?? \"PDF document\")}</title>`);\n    if (options.includeStyles ?? true) await write(`<style>${styles}</style>`);\n    await write(\"</head><body>\");\n  }\n  await write('<main class=\"pdf-document\">');\n  for await (const page of pages) await writePage(page, write, options);\n  await write(\"</main>\");\n  if (includeDocument) await write(\"</body></html>\");\n}\n\nexport async function writePage(\n  page: ExtractedPage,\n  write: HtmlWrite,\n  options: HtmlWriterOptions = {},\n): Promise<void> {\n  if ((options.layout ?? \"positioned\") === \"flow\") await writeFlowPage(page, write);\n  else await writePositionedPage(page, write);\n}\n\nexport async function pageToHtml(\n  page: ExtractedPage,\n  options: HtmlWriterOptions = {},\n): Promise<string> {\n  let output = \"\";\n  await writePage(\n    page,\n    (chunk) => {\n      output += chunk;\n    },\n    options,\n  );\n  return output;\n}\n\nasync function writePositionedPage(page: ExtractedPage, write: HtmlWrite): Promise<void> {\n  const quarterTurn = page.rotate === 90 || page.rotate === 270;\n  const displayWidth = quarterTurn ? page.height : page.width;\n  const displayHeight = quarterTurn ? page.width : page.height;\n  await write(\n    `<section class=\"pdf-page pdf-page--positioned\" data-page=\"${page.number}\" data-rotate=\"${page.rotate}\" style=\"width:${number(displayWidth)}pt;height:${number(displayHeight)}pt\">`,\n  );\n  await write(\n    `<div class=\"pdf-page-content pdf-page-content--${page.rotate}\" style=\"width:${number(page.width)}pt;height:${number(page.height)}pt\">`,\n  );\n  for (const span of page.spans) await write(positionedSpan(span));\n  await write(\"</div></section>\");\n}\n\nasync function writeFlowPage(page: ExtractedPage, write: HtmlWrite): Promise<void> {\n  const structured = structurePage(page);\n  const tables = [...structured.tables].sort((left, right) => right.bounds.y - left.bounds.y);\n  const emittedTables = new Set<Table>();\n  await write(`<section class=\"pdf-page pdf-page--flow\" data-page=\"${page.number}\">`);\n  for (const line of structured.lines) {\n    const table = tables.find((candidate) => containsY(candidate, line.bounds.y));\n    if (table) {\n      if (!emittedTables.has(table)) {\n        await write(tableToHtml(table));\n        emittedTables.add(table);\n      }\n      continue;\n    }\n    await write(`<p${directionAttribute(line.spans)}>${escapeHtml(line.text)}</p>`);\n  }\n  for (const table of tables) {\n    if (!emittedTables.has(table)) await write(tableToHtml(table));\n  }\n  await write(\"</section>\");\n}\n\nfunction positionedSpan(span: TextSpan): string {\n  const direction = directionAttribute([span]);\n  const style = [\n    `left:${number(span.bounds.x)}pt`,\n    `bottom:${number(span.bounds.y)}pt`,\n    `width:${number(span.bounds.width)}pt`,\n    `height:${number(span.bounds.height)}pt`,\n    `font-size:${number(span.fontSize)}pt`,\n  ].join(\";\");\n  return `<span class=\"pdf-span\"${direction} style=\"${style}\">${escapeHtml(span.text)}</span>`;\n}\n\nfunction directionAttribute(spans: TextSpan[]): string {\n  const rtl = spans.filter((span) => span.direction === \"rtl\").length;\n  const vertical = spans.filter((span) => span.direction === \"ttb\").length;\n  if (vertical > rtl && vertical * 2 >= spans.length) return ' data-direction=\"ttb\"';\n  return rtl * 2 >= spans.length && spans.length > 0 ? ' dir=\"rtl\"' : \"\";\n}\n\nfunction containsY(table: Table, y: number): boolean {\n  return y >= table.bounds.y && y <= table.bounds.y + table.bounds.height;\n}\n\nfunction number(value: number): string {\n  return Number.isFinite(value) ? String(Math.round(value * 1000) / 1000) : \"0\";\n}\n\nfunction escapeAttribute(value: string): string {\n  return escapeHtml(value).replaceAll(\"`\", \"&#96;\");\n}\n\nfunction escapeHtml(value: string): string {\n  return [...value]\n    .map((character) => {\n      const codePoint = character.codePointAt(0) ?? 0;\n      if (codePoint === 13) return \"\\n\";\n      return isForbiddenControl(codePoint) ? \"�\" : character;\n    })\n    .join(\"\")\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&#39;\");\n}\n\nfunction isForbiddenControl(codePoint: number): boolean {\n  return (\n    codePoint <= 8 ||\n    codePoint === 11 ||\n    codePoint === 12 ||\n    (codePoint >= 14 && codePoint <= 31) ||\n    codePoint === 127\n  );\n}\n"],"mappings":"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","names":[]}

package/examples/file.ts

@@ -0,0 +1,25 @@
+import { once } from "node:events";
+import { createWriteStream } from "node:fs";
+import { finished } from "node:stream/promises";
+import { writeHtmlDocument } from "@boxpdf/html-writer";
+import { openPdf } from "@boxpdf/reader";
+import { fileSource } from "@boxpdf/reader/node";
+
+const [inputPath, outputPath] = process.argv.slice(2);
+if (!inputPath || !outputPath) throw new Error("usage: file.ts input.pdf output.html");
+
+const source = await fileSource(inputPath);
+const reader = await openPdf(source);
+const output = createWriteStream(outputPath, { encoding: "utf8" });
+
+try {
+  await writeHtmlDocument(reader.pages(), async (chunk) => {
+    if (!output.write(chunk)) await once(output, "drain");
+  });
+  output.end();
+  await finished(output);
+} finally {
+  output.destroy();
+  reader.close();
+  await source.close();
+}

package/examples/http.ts

@@ -0,0 +1,25 @@
+import { writeHtmlDocument } from "@boxpdf/html-writer";
+import { httpSource, openPdf } from "@boxpdf/reader";
+
+export async function pdfUrlToHtmlResponse(pdfUrl: URL): Promise<Response> {
+  const source = await httpSource(pdfUrl);
+  const reader = await openPdf(source);
+  const encoder = new TextEncoder();
+  const output = new TransformStream<Uint8Array, Uint8Array>();
+  const writer = output.writable.getWriter();
+
+  void (async () => {
+    try {
+      await writeHtmlDocument(reader.pages(), (chunk) => writer.write(encoder.encode(chunk)));
+      await writer.close();
+    } catch (error) {
+      await writer.abort(error);
+    } finally {
+      reader.close();
+    }
+  })();
+
+  return new Response(output.readable, {
+    headers: { "content-type": "text/html; charset=utf-8" },
+  });
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@boxpdf/html-writer",
+  "version": "0.1.0",
+  "description": "Stream PDF pages from @boxpdf/reader to accessible or positioned HTML.",
+  "keywords": [
+    "pdf",
+    "pdf-to-html",
+    "html-writer",
+    "streaming-pdf",
+    "text-extraction"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Erik Aronesty",
+    "email": "erik@q32.com"
+  },
+  "homepage": "https://github.com/earonesty/streaming-pdf-reader#html-writer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/earonesty/streaming-pdf-reader.git",
+    "directory": "packages/html-writer"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --sourcemap --clean",
+    "check": "biome check --error-on-warnings . && tsc --noEmit",
+    "test": "vitest run --coverage",
+    "package:check": "publint && pnpm pack --dry-run",
+    "quality": "pnpm check && pnpm test && pnpm build && pnpm package:check",
+    "prepublishOnly": "pnpm quality"
+  },
+  "peerDependencies": {
+    "@boxpdf/reader": "workspace:^"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.10",
+    "@boxpdf/reader": "workspace:*",
+    "@types/node": "^24.3.0",
+    "@vitest/coverage-v8": "4.1.11",
+    "publint": "^0.3.24",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}