@voidberg/quarto 0.1.0

package/dist/html.js

@@ -0,0 +1,430 @@
+import { parse, parseFragment } from "parse5";
+const VOID_ELEMENTS = new Set([
+    "area",
+    "base",
+    "br",
+    "col",
+    "embed",
+    "hr",
+    "img",
+    "input",
+    "link",
+    "meta",
+    "param",
+    "source",
+    "track",
+    "wbr",
+]);
+// Inline elements whose content model is phrasing-only: they may not contain
+// block/flow elements. (`a`, `ins`, `del`, `map` are transparent — excluded.)
+const PHRASING_ONLY = new Set([
+    "span",
+    "em",
+    "strong",
+    "b",
+    "i",
+    "u",
+    "s",
+    "small",
+    "mark",
+    "code",
+    "kbd",
+    "samp",
+    "sub",
+    "sup",
+    "abbr",
+    "cite",
+    "q",
+    "dfn",
+    "time",
+    "var",
+    "bdi",
+    "bdo",
+    "big",
+    "tt",
+]);
+// Block/flow elements that may not appear inside phrasing content.
+const BLOCK_ELEMENTS = new Set([
+    "div",
+    "p",
+    "section",
+    "article",
+    "aside",
+    "header",
+    "footer",
+    "nav",
+    "main",
+    "figure",
+    "figcaption",
+    "blockquote",
+    "ul",
+    "ol",
+    "li",
+    "dl",
+    "dt",
+    "dd",
+    "table",
+    "caption",
+    "thead",
+    "tbody",
+    "tfoot",
+    "tr",
+    "td",
+    "th",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "hr",
+    "pre",
+    "form",
+    "fieldset",
+    "address",
+]);
+function isText(node) {
+    return node.nodeName === "#text";
+}
+function isComment(node) {
+    return node.nodeName === "#comment";
+}
+function isElement(node) {
+    return "tagName" in node && Array.isArray(node.attrs);
+}
+function escapeText(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeAttr(value) {
+    // Only &, < and " need escaping in a double-quoted XML attribute value;
+    // regular spaces are valid and must be preserved (so e.g. multi-token class
+    // names and alt/title text survive intact).
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/"/g, "&quot;");
+}
+/** Serialize a parse5 node list as well-formed XHTML. */
+function serializeNodes(nodes) {
+    let out = "";
+    for (const node of nodes) {
+        if (isText(node)) {
+            out += escapeText(node.value);
+        }
+        else if (isComment(node)) {
+            out += `<!--${node.data}-->`;
+        }
+        else if (isElement(node)) {
+            const tag = node.tagName;
+            const attrs = node.attrs
+                .map((a) => {
+                const name = a.prefix ? `${a.prefix}:${a.name}` : a.name;
+                return ` ${name}="${escapeAttr(a.value)}"`;
+            })
+                .join("");
+            if (VOID_ELEMENTS.has(tag) && node.childNodes.length === 0) {
+                out += `<${tag}${attrs}/>`;
+            }
+            else {
+                out += `<${tag}${attrs}>${serializeNodes(node.childNodes)}</${tag}>`;
+            }
+        }
+    }
+    return out;
+}
+/** Walk every element in a subtree, depth-first. */
+function walkElements(nodes, visit) {
+    for (const node of nodes) {
+        if (isElement(node)) {
+            visit(node);
+            walkElements(node.childNodes, visit);
+        }
+    }
+}
+/**
+ * Browsers (and parse5) tolerate block elements nested inside phrasing-only
+ * inline elements like `<span><div>…</div></span>`, but that violates the XHTML
+ * content model and EPUBCheck rejects it. Bottom-up, rewrite any phrasing-only
+ * element that contains a block child into a `<div>` (keeping its attributes), so
+ * the structure becomes valid without losing content.
+ */
+function fixBlockInPhrasing(nodes) {
+    for (const node of nodes) {
+        if (!isElement(node))
+            continue;
+        fixBlockInPhrasing(node.childNodes);
+        if (PHRASING_ONLY.has(node.tagName) &&
+            node.childNodes.some((c) => isElement(c) && BLOCK_ELEMENTS.has(c.tagName))) {
+            node.nodeName = "div";
+            node.tagName = "div";
+        }
+    }
+}
+function getAttr(el, name) {
+    return el.attrs.find((a) => a.name === name)?.value;
+}
+function setAttr(el, name, value) {
+    const existing = el.attrs.find((a) => a.name === name);
+    if (existing)
+        existing.value = value;
+    else
+        el.attrs.push({ name, value });
+}
+/** A parsed HTML fragment ready to inspect, mutate and serialize. */
+export class HtmlFragment {
+    nodes;
+    constructor(nodes) {
+        this.nodes = nodes;
+    }
+    static parse(html) {
+        const frag = parseFragment(html);
+        fixBlockInPhrasing(frag.childNodes);
+        return new HtmlFragment(frag.childNodes);
+    }
+    /** Collect the `src` of every `<img>` (in document order). */
+    imageSources() {
+        const srcs = [];
+        walkElements(this.nodes, (el) => {
+            if (el.tagName === "img") {
+                const src = getAttr(el, "src");
+                if (src)
+                    srcs.push(src);
+            }
+        });
+        return srcs;
+    }
+    /**
+     * Walk every `<img>` (depth-first, splice-safe) and apply a decision based on
+     * its `src`:
+     *  - a string  → rewrite `src` to it (and ensure `alt`);
+     *  - `null`    → remove the element;
+     *  - `undefined` → leave it (and ensure `alt`).
+     */
+    transformImages(decide) {
+        const process = (nodes) => {
+            for (let i = nodes.length - 1; i >= 0; i--) {
+                const node = nodes[i];
+                if (!isElement(node))
+                    continue;
+                if (node.tagName === "img") {
+                    const result = decide(getAttr(node, "src"));
+                    if (result === null) {
+                        nodes.splice(i, 1);
+                    }
+                    else {
+                        if (typeof result === "string")
+                            setAttr(node, "src", result);
+                        if (getAttr(node, "alt") === undefined)
+                            setAttr(node, "alt", "");
+                    }
+                }
+                else {
+                    process(node.childNodes);
+                }
+            }
+        };
+        process(this.nodes);
+    }
+    /**
+     * Resolve every `<img>` against an embedded-image map (original src → in-package
+     * path). Matched images are rewritten and given alt text. When
+     * `stripUnresolved` is set, images that were not embedded (failed downloads,
+     * unsupported sources) are removed entirely so the EPUB has no dangling
+     * foreign resources — EPUBCheck rejects those.
+     */
+    resolveImages(map, stripUnresolved) {
+        this.transformImages((src) => {
+            if (src && map.has(src))
+                return map.get(src);
+            return stripUnresolved ? null : undefined;
+        });
+    }
+    /**
+     * Remove every `<img>` that references something outside the container — i.e.
+     * anything that isn't an inline `data:` URI (remote URLs and relative paths
+     * alike). Used when image downloading is disabled: only self-contained `data:`
+     * images can survive, so this keeps the EPUB valid instead of leaving dangling
+     * references EPUBCheck rejects.
+     */
+    stripExternalImages() {
+        this.transformImages((src) => (src && /^data:/i.test(src) ? undefined : null));
+    }
+    /**
+     * If the fragment's first meaningful content is an image (i.e. no text
+     * precedes it), remove that image and return its `src` — for promoting an
+     * article's lead image to the cover. Returns `undefined` when text comes first,
+     * so we never pull an image out of the middle of the prose.
+     */
+    extractLeadImage() {
+        let src;
+        // A wrapper is "empty" if nothing but whitespace/comments remains.
+        const isEmpty = (el) => el.childNodes.every((c) => isComment(c) || (isText(c) && c.value.trim() === ""));
+        const visit = (nodes) => {
+            for (let i = 0; i < nodes.length; i++) {
+                const node = nodes[i];
+                if (isText(node)) {
+                    if (node.value.trim() !== "")
+                        return "text";
+                    continue;
+                }
+                if (!isElement(node))
+                    continue;
+                if (node.tagName === "img") {
+                    src = getAttr(node, "src");
+                    nodes.splice(i, 1);
+                    return "img";
+                }
+                const inner = visit(node.childNodes);
+                if (inner === "img") {
+                    // The lead image lived inside this wrapper; drop it too if now empty
+                    // (a remaining <figcaption> etc. keeps it). Propagates up the nesting.
+                    if (isEmpty(node))
+                        nodes.splice(i, 1);
+                    return "img";
+                }
+                if (inner === "text")
+                    return "text";
+            }
+            return undefined;
+        };
+        return visit(this.nodes) === "img" ? src : undefined;
+    }
+    serialize() {
+        return serializeNodes(this.nodes);
+    }
+}
+// --- kepub transform ---------------------------------------------------------
+// Block-level tags whose text Kobo expects to be segmented for location tracking.
+// (`pre` is intentionally absent — it lives in KOBO_SKIP, whose check runs first.)
+const KOBO_SEGMENT_BLOCKS = new Set([
+    "p",
+    "li",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "blockquote",
+    "td",
+    "th",
+    "figcaption",
+    "dd",
+    "dt",
+]);
+// Never wrap text inside these.
+const KOBO_SKIP = new Set(["script", "style", "pre", "audio", "video", "svg", "math"]);
+/**
+ * Transform an XHTML content document into its Kobo (kepub) form, mirroring
+ * kepubify:
+ *
+ *  - every text run inside a block element is wrapped in
+ *    `<span class="koboSpan" id="kobo.{segment}.{fragment}">` so the firmware can
+ *    track reading position and anchor highlights precisely;
+ *  - the body content is wrapped in `<div id="book-columns"><div id="book-inner">`
+ *    which Kobo relies on for pagination and justification.
+ *
+ * Returns a complete XHTML document string. If the input has no parseable
+ * `<body>`, it is returned unchanged.
+ */
+export function kepubifyXhtml(documentHtml) {
+    const doc = parse(documentHtml);
+    const html = findElement(doc.childNodes, "html");
+    const body = html ? findElement(html.childNodes, "body") : undefined;
+    if (!html || !body)
+        return documentHtml;
+    const counter = { segment: 0 };
+    wrapTextNodes(body.childNodes, counter);
+    const inner = {
+        nodeName: "div",
+        tagName: "div",
+        attrs: [{ name: "id", value: "book-inner" }],
+        childNodes: body.childNodes,
+    };
+    const columns = {
+        nodeName: "div",
+        tagName: "div",
+        attrs: [{ name: "id", value: "book-columns" }],
+        childNodes: [inner],
+    };
+    body.childNodes = [columns];
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE html>\n${serializeNodes([html])}\n`;
+}
+function findElement(nodes, tagName) {
+    for (const node of nodes) {
+        if (isElement(node)) {
+            if (node.tagName === tagName)
+                return node;
+            const nested = findElement(node.childNodes, tagName);
+            if (nested)
+                return nested;
+        }
+    }
+    return undefined;
+}
+/**
+ * Recurse into the tree, treating each block in {@link KOBO_SEGMENT_BLOCKS} as
+ * one location segment and wrapping its text via {@link wrapInline}.
+ *
+ * Known simplification vs. full kepubify: only text inside a recognised block
+ * is wrapped. Loose text that sits directly in a non-block container (e.g. a
+ * bare text node under a `<div>`) is left unwrapped, and a block nested inside
+ * another block shares its parent's segment number. Content that quarto itself
+ * generates is always block-wrapped, so this only affects arbitrary inputs and
+ * costs Kobo a little location-tracking granularity — never validity.
+ */
+function wrapTextNodes(nodes, counter) {
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        if (isElement(node)) {
+            if (KOBO_SKIP.has(node.tagName))
+                continue;
+            if (KOBO_SEGMENT_BLOCKS.has(node.tagName)) {
+                counter.segment++;
+                wrapInline(node, counter.segment);
+            }
+            else {
+                wrapTextNodes(node.childNodes, counter);
+            }
+        }
+    }
+}
+/**
+ * Wrap each non-empty text node within a block in its own koboSpan, numbering
+ * fragments sequentially. Nested inline elements keep their structure; only the
+ * text leaves are wrapped.
+ */
+function wrapInline(block, segment) {
+    const fragment = { n: 0 };
+    const transform = (nodes) => {
+        const result = [];
+        for (const node of nodes) {
+            if (isText(node)) {
+                if (node.value.trim() === "") {
+                    result.push(node);
+                    continue;
+                }
+                fragment.n++;
+                result.push(koboSpan(segment, fragment.n, [node]));
+            }
+            else if (isElement(node) && !KOBO_SKIP.has(node.tagName)) {
+                node.childNodes = transform(node.childNodes);
+                result.push(node);
+            }
+            else {
+                result.push(node);
+            }
+        }
+        return result;
+    };
+    block.childNodes = transform(block.childNodes);
+}
+function koboSpan(segment, fragment, children) {
+    return {
+        nodeName: "span",
+        tagName: "span",
+        attrs: [
+            { name: "class", value: "koboSpan" },
+            { name: "id", value: `kobo.${segment}.${fragment}` },
+        ],
+        childNodes: children,
+    };
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAqC9C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AAEH,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,OAAO;IACP,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,GAAG;IACH,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;CACL,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,KAAK;IACL,GAAG;IACH,SAAS;IACT,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,MAAM;IACN,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,UAAU;IACV,SAAS;CACV,CAAC,CAAC;AAEH,SAAS,MAAM,CAAC,IAAU;IACxB,OAAO,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC;AACnC,CAAC;AACD,SAAS,SAAS,CAAC,IAAU;IAC3B,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC;AACtC,CAAC;AACD,SAAS,SAAS,CAAC,IAAU;IAC3B,OAAO,SAAS,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAoB,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC;AACD,SAAS,UAAU,CAAC,KAAa;IAC/B,wEAAwE;IACxE,4EAA4E;IAC5E,4CAA4C;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC;AAED,yDAAyD;AACzD,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,GAAG,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,CAAC;QAC/B,CAAC;aAAM,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;iBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzD,OAAO,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;YAC7C,CAAC,CAAC;iBACD,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,GAAG,IAAI,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,GAAG,IAAI,IAAI,GAAG,GAAG,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oDAAoD;AACpD,SAAS,YAAY,CAAC,KAAa,EAAE,KAAgC;IACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,KAAa;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/B,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpC,IACE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAC1E,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,EAAe,EAAE,IAAY;IAC5C,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,CAAC;AACtD,CAAC;AACD,SAAS,OAAO,CAAC,EAAe,EAAE,IAAY,EAAE,KAAa;IAC3D,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACvD,IAAI,QAAQ;QAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;;QAChC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,qEAAqE;AACrE,MAAM,OAAO,YAAY;IACN,KAAK,CAAS;IAE/B,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAY;QACvB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAA0B,CAAC;QAC1D,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,8DAA8D;IAC9D,YAAY;QACV,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE;YAC9B,IAAI,EAAE,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC/B,IAAI,GAAG;oBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACK,eAAe,CAAC,MAA8D;QACpF,MAAM,OAAO,GAAG,CAAC,KAAa,EAAQ,EAAE;YACtC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC/B,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC5C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;wBACpB,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACrB,CAAC;yBAAM,CAAC;wBACN,IAAI,OAAO,MAAM,KAAK,QAAQ;4BAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;wBAC7D,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,SAAS;4BAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,GAAwB,EAAE,eAAwB;QAC9D,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE;YAC3B,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YAC9C,OAAO,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB;QACjB,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACH,gBAAgB;QACd,IAAI,GAAuB,CAAC;QAE5B,mEAAmE;QACnE,MAAM,OAAO,GAAG,CAAC,EAAe,EAAW,EAAE,CAC3C,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAEnF,MAAM,KAAK,GAAG,CAAC,KAAa,EAA8B,EAAE;YAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACvB,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;wBAAE,OAAO,MAAM,CAAC;oBAC5C,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC/B,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;oBAC3B,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC3B,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACnB,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACrC,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;oBACpB,qEAAqE;oBACrE,uEAAuE;oBACvE,IAAI,OAAO,CAAC,IAAI,CAAC;wBAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtC,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,IAAI,KAAK,KAAK,MAAM;oBAAE,OAAO,MAAM,CAAC;YACtC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAED,SAAS;QACP,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF;AAED,gFAAgF;AAEhF,kFAAkF;AAClF,mFAAmF;AACnF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,YAAY;IACZ,IAAI;IACJ,IAAI;IACJ,YAAY;IACZ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AACH,gCAAgC;AAChC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAA0B,CAAC;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,YAAY,CAAC;IAExC,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC/B,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAExC,MAAM,KAAK,GAAgB;QACzB,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAC5C,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;IACF,MAAM,OAAO,GAAgB;QAC3B,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAC9C,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,CAAC;IAE5B,OAAO,4DAA4D,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,OAAe;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,KAAa,EAAE,OAA4B;IAChE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,SAAS;YAC1C,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1C,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,KAAkB,EAAE,OAAe;IACrD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE;QAC1C,MAAM,MAAM,GAAW,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAClB,SAAS;gBACX,CAAC;gBACD,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrD,CAAC;iBAAM,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3D,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,QAAgB,EAAE,QAAgB;IACnE,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,MAAM;QACf,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE;YACpC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,OAAO,IAAI,QAAQ,EAAE,EAAE;SACrD;QACD,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC"}

package/dist/images.d.ts

@@ -0,0 +1,24 @@
+import type { ImageTransform } from "./types.js";
+export interface EmbeddedImage {
+    /** Path inside the EPUB, e.g. `images/img-1.jpg`. */
+    path: string;
+    /** Manifest id. */
+    id: string;
+    mime: string;
+    data: Uint8Array;
+}
+/** Fetch a single image URL (or accept raw bytes) and classify its type. */
+export declare function fetchImage(source: string | Uint8Array, fetcher: typeof fetch): Promise<{
+    data: Uint8Array;
+    mime: string;
+}>;
+/**
+ * Download a set of image sources concurrently, skipping any that fail, return
+ * no bytes, or aren't an EPUB core image type (the book stays valid even when a
+ * source 404s or is unsupported). Returns the embedded images plus a map from
+ * original URL → in-package path for rewriting.
+ */
+export declare function embedImages(urls: string[], fetcher: typeof fetch, transform?: ImageTransform): Promise<{
+    images: EmbeddedImage[];
+    rewrites: Map<string, string>;
+}>;

package/dist/images.js

@@ -0,0 +1,51 @@
+import { extFromMime, isCoreImageType, mimeFromUrl, sniffImageMime } from "./util.js";
+/** Fetch a single image URL (or accept raw bytes) and classify its type. */
+export async function fetchImage(source, fetcher) {
+    if (typeof source !== "string") {
+        return { data: source, mime: sniffImageMime(source) ?? "image/jpeg" };
+    }
+    const res = await fetcher(source);
+    if (!res.ok)
+        throw new Error(`Failed to fetch image ${source}: HTTP ${res.status}`);
+    const data = new Uint8Array(await res.arrayBuffer());
+    const headerMime = res.headers.get("content-type")?.split(";")[0]?.trim();
+    const mime = sniffImageMime(data) ||
+        (headerMime?.startsWith("image/") ? headerMime : undefined) ||
+        mimeFromUrl(source) ||
+        "image/jpeg";
+    return { data, mime };
+}
+/**
+ * Download a set of image sources concurrently, skipping any that fail, return
+ * no bytes, or aren't an EPUB core image type (the book stays valid even when a
+ * source 404s or is unsupported). Returns the embedded images plus a map from
+ * original URL → in-package path for rewriting.
+ */
+export async function embedImages(urls, fetcher, transform) {
+    const unique = [...new Set(urls)].filter((u) => u.length > 0);
+    const images = [];
+    const rewrites = new Map();
+    const results = await Promise.allSettled(unique.map(async (url) => {
+        const img = await fetchImage(url, fetcher);
+        return transform ? await transform(img) : img;
+    }));
+    let counter = 0;
+    results.forEach((result, i) => {
+        const url = unique[i];
+        // Skip anything we can't embed: failed fetches, transform-dropped (null) or
+        // empty payloads, and types EPUB can't carry without a fallback — the
+        // corresponding <img> is then stripped so the EPUB stays valid.
+        if (result.status !== "fulfilled" || result.value === null)
+            return;
+        if (result.value.data.length === 0 || !isCoreImageType(result.value.mime))
+            return;
+        counter++;
+        const ext = extFromMime(result.value.mime);
+        const path = `images/img-${counter}.${ext}`;
+        const id = `img-${counter}`;
+        images.push({ path, id, mime: result.value.mime, data: result.value.data });
+        rewrites.set(url, path);
+    });
+    return { images, rewrites };
+}
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_CSS } from "./css.js";
+export { generateEpub } from "./epub.js";
+export { toKepub } from "./kepub.js";
+export type { Chapter, CoverTransform, EpubInput, EpubOptions, ImageSource, ImageTransform, RawImage, } from "./types.js";
+export { imageSize } from "./util.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_CSS } from "./css.js";
+export { generateEpub } from "./epub.js";
+export { toKepub } from "./kepub.js";
+export { imageSize } from "./util.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAUrC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/kepub.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert a standard EPUB into a Kobo kepub in memory — the equivalent of
+ * running `kepubify`, with no external binary required.
+ *
+ * Every content document is rewritten with Kobo reading-location spans and the
+ * `book-columns`/`book-inner` wrappers. The navigation document is left
+ * untouched. The returned bytes should be written with a `.kepub.epub`
+ * extension so Kobo devices recognise the enhanced format.
+ */
+export declare function toKepub(epub: Uint8Array): Uint8Array;

package/dist/kepub.js

@@ -0,0 +1,32 @@
+import { kepubifyXhtml } from "./html.js";
+import { decodeUtf8, encodeUtf8 } from "./util.js";
+import { unzipEpub, zipEpub } from "./zip.js";
+const XHTML_RE = /\.x?html?$/i;
+const NAV_RE = /epub:type=["']toc["']/;
+/**
+ * Convert a standard EPUB into a Kobo kepub in memory — the equivalent of
+ * running `kepubify`, with no external binary required.
+ *
+ * Every content document is rewritten with Kobo reading-location spans and the
+ * `book-columns`/`book-inner` wrappers. The navigation document is left
+ * untouched. The returned bytes should be written with a `.kepub.epub`
+ * extension so Kobo devices recognise the enhanced format.
+ */
+export function toKepub(epub) {
+    const entries = unzipEpub(epub);
+    const files = {};
+    for (const [path, bytes] of Object.entries(entries)) {
+        if (path === "mimetype")
+            continue; // re-added (stored, first) by zipEpub
+        if (XHTML_RE.test(path)) {
+            const html = decodeUtf8(bytes);
+            // Skip the navigation document; Kobo builds its TOC from it directly.
+            files[path] = NAV_RE.test(html) ? bytes : encodeUtf8(kepubifyXhtml(html));
+        }
+        else {
+            files[path] = bytes;
+        }
+    }
+    return zipEpub(files);
+}
+//# sourceMappingURL=kepub.js.map

package/dist/kepub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kepub.js","sourceRoot":"","sources":["../src/kepub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,QAAQ,GAAG,aAAa,CAAC;AAC/B,MAAM,MAAM,GAAG,uBAAuB,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,IAAgB;IACtC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAA+B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,KAAK,UAAU;YAAE,SAAS,CAAC,sCAAsC;QACzE,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,sEAAsE;YACtE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/opf.d.ts

@@ -0,0 +1,65 @@
+export interface ManifestItem {
+    id: string;
+    href: string;
+    mediaType: string;
+    /** EPUB3 manifest properties, e.g. `"nav"` or `"cover-image"`. */
+    properties?: string;
+}
+export interface NavEntry {
+    href: string;
+    title: string;
+}
+/** A reference for the EPUB2 `<guide>` or the EPUB3 landmarks nav (e.g. cover, start). */
+export interface Reference {
+    type: string;
+    href: string;
+    title: string;
+}
+export interface OpfMetadata {
+    id: string;
+    title: string;
+    authors: string[];
+    language: string;
+    publisher?: string;
+    description?: string;
+    date?: string;
+    coverImageId?: string;
+}
+export declare const CONTAINER_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<container version=\"1.0\" xmlns=\"urn:oasis:names:tc:opendocument:xmlns:container\">\n  <rootfiles>\n    <rootfile full-path=\"EPUB/content.opf\" media-type=\"application/oebps-package+xml\"/>\n  </rootfiles>\n</container>\n";
+export declare function buildOpf(meta: OpfMetadata, manifest: ManifestItem[], spine: string[], options?: {
+    ncxId?: string;
+    guide?: Reference[];
+}): string;
+/**
+ * EPUB3 navigation document. EPUB3 mandates exactly one `nav` document, so even
+ * when a book opts out of a table of contents we still emit one — but mark it
+ * `hidden` and keep it out of the spine so no visible TOC page appears.
+ */
+export declare function buildNav(navTitle: string, language: string, entries: NavEntry[], hidden?: boolean, landmarks?: Reference[]): string;
+/** EPUB2 NCX, kept for older e-reader compatibility. */
+export declare function buildNcx(id: string, title: string, entries: NavEntry[]): string;
+export interface SvgCoverOptions {
+    title: string;
+    language: string;
+    imageHref: string;
+    width: number;
+    height: number;
+    /** Fills the letterbox bands around the cover image (e.g. to match its edges). */
+    background?: string;
+}
+/**
+ * A cover page that wraps the image in an SVG scaled to fit the viewport
+ * (`preserveAspectRatio="xMidYMid meet"`). This is the portable way to make a
+ * cover fill and center consistently across readers — inline `<img>` layout
+ * anchors awkwardly on e-ink devices like Kobo.
+ */
+export declare function buildSvgCover(opts: SvgCoverOptions): string;
+export interface XhtmlPageOptions {
+    title: string;
+    language: string;
+    cssHref?: string;
+    bodyHtml: string;
+    bodyClass?: string;
+}
+/** Wrap body HTML in a complete XHTML content document. */
+export declare function buildXhtml(opts: XhtmlPageOptions): string;