@voidberg/quarto 0.1.0

package/dist/opf.js

@@ -0,0 +1,172 @@
+import { escapeXml } from "./util.js";
+export const CONTAINER_XML = `<?xml version="1.0" encoding="UTF-8"?>
+<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
+  <rootfiles>
+    <rootfile full-path="EPUB/content.opf" media-type="application/oebps-package+xml"/>
+  </rootfiles>
+</container>
+`;
+/** A fixed timestamp keeps builds reproducible when no date is supplied. */
+const EPOCH = "1970-01-01T00:00:00Z";
+/**
+ * EPUB3 requires `dcterms:modified` to be exactly `CCYY-MM-DDThh:mm:ssZ` — UTC,
+ * no fractional seconds. Normalize whatever the caller passed (commonly a full
+ * `Date.toISOString()` with milliseconds) into that form, falling back to
+ * {@link EPOCH} when it isn't a parseable date.
+ */
+function normalizeModified(date) {
+    if (!date)
+        return EPOCH;
+    const t = Date.parse(date);
+    if (Number.isNaN(t))
+        return EPOCH;
+    return `${new Date(t).toISOString().slice(0, 19)}Z`;
+}
+export function buildOpf(meta, manifest, spine, options = {}) {
+    const modified = normalizeModified(meta.date);
+    const metaTags = [
+        `<dc:identifier id="pub-id">${escapeXml(meta.id)}</dc:identifier>`,
+        `<dc:title>${escapeXml(meta.title)}</dc:title>`,
+        `<dc:language>${escapeXml(meta.language)}</dc:language>`,
+        `<meta property="dcterms:modified">${modified}</meta>`,
+    ];
+    for (const author of meta.authors) {
+        metaTags.push(`<dc:creator>${escapeXml(author)}</dc:creator>`);
+    }
+    if (meta.publisher)
+        metaTags.push(`<dc:publisher>${escapeXml(meta.publisher)}</dc:publisher>`);
+    if (meta.description)
+        metaTags.push(`<dc:description>${escapeXml(meta.description)}</dc:description>`);
+    if (meta.date)
+        metaTags.push(`<dc:date>${escapeXml(meta.date)}</dc:date>`);
+    if (meta.coverImageId)
+        metaTags.push(`<meta name="cover" content="${escapeXml(meta.coverImageId)}"/>`);
+    const manifestTags = manifest.map((item) => {
+        const props = item.properties ? ` properties="${item.properties}"` : "";
+        return `<item id="${escapeXml(item.id)}" href="${escapeXml(item.href)}" media-type="${item.mediaType}"${props}/>`;
+    });
+    const spineTags = spine.map((idref) => `<itemref idref="${escapeXml(idref)}"/>`);
+    const spineToc = options.ncxId ? ` toc="${escapeXml(options.ncxId)}"` : "";
+    // EPUB2 guide — deprecated in EPUB3 but still used by Kindle/older readers to
+    // locate the cover and reading start.
+    const guideBlock = options.guide?.length
+        ? `\n  <guide>\n    ${options.guide
+            .map((r) => `<reference type="${escapeXml(r.type)}" title="${escapeXml(r.title)}" href="${escapeXml(r.href)}"/>`)
+            .join("\n    ")}\n  </guide>`
+        : "";
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<package xmlns="http://www.idpf.org/2007/opf" version="3.0" unique-identifier="pub-id" xml:lang="${escapeXml(meta.language)}">
+  <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
+    ${metaTags.join("\n    ")}
+  </metadata>
+  <manifest>
+    ${manifestTags.join("\n    ")}
+  </manifest>
+  <spine${spineToc}>
+    ${spineTags.join("\n    ")}
+  </spine>${guideBlock}
+</package>
+`;
+}
+/**
+ * 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 function buildNav(navTitle, language, entries, hidden = false, landmarks = []) {
+    const items = entries
+        .map((e) => `        <li><a href="${escapeXml(e.href)}">${escapeXml(e.title)}</a></li>`)
+        .join("\n");
+    const hiddenAttr = hidden ? ` hidden=""` : "";
+    const heading = hidden ? "" : `\n      <h1>${escapeXml(navTitle)}</h1>`;
+    // EPUB3 landmarks nav — lets readers jump to the cover / reading start. Hidden,
+    // it's a navigation aid, not a visible page.
+    const landmarksNav = landmarks.length
+        ? `\n    <nav epub:type="landmarks" hidden="">\n      <ol>\n${landmarks
+            .map((l) => `        <li><a epub:type="${escapeXml(l.type)}" href="${escapeXml(l.href)}">${escapeXml(l.title)}</a></li>`)
+            .join("\n")}\n      </ol>\n    </nav>`
+        : "";
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="${escapeXml(language)}" xml:lang="${escapeXml(language)}">
+  <head>
+    <meta charset="utf-8"/>
+    <title>${escapeXml(navTitle)}</title>
+  </head>
+  <body>
+    <nav epub:type="toc" id="toc"${hiddenAttr}>${heading}
+      <ol>
+${items}
+      </ol>
+    </nav>${landmarksNav}
+  </body>
+</html>
+`;
+}
+/** EPUB2 NCX, kept for older e-reader compatibility. */
+export function buildNcx(id, title, entries) {
+    const points = entries
+        .map((e, i) => `    <navPoint id="nav-${i + 1}" playOrder="${i + 1}">
+      <navLabel><text>${escapeXml(e.title)}</text></navLabel>
+      <content src="${escapeXml(e.href)}"/>
+    </navPoint>`)
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<ncx xmlns="http://www.daisy.org/z3986/2005/ncx/" version="2005-1">
+  <head>
+    <meta name="dtb:uid" content="${escapeXml(id)}"/>
+    <meta name="dtb:depth" content="1"/>
+    <meta name="dtb:totalPageCount" content="0"/>
+    <meta name="dtb:maxPageNumber" content="0"/>
+  </head>
+  <docTitle><text>${escapeXml(title)}</text></docTitle>
+  <navMap>
+${points}
+  </navMap>
+</ncx>
+`;
+}
+/**
+ * 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 function buildSvgCover(opts) {
+    const bg = opts.background ? `;background:${opts.background}` : "";
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="${escapeXml(opts.language)}" xml:lang="${escapeXml(opts.language)}">
+  <head>
+    <meta charset="utf-8"/>
+    <title>${escapeXml(opts.title)}</title>
+    <style>@page{margin:0}html,body{margin:0;padding:0;height:100%;overflow:hidden${bg}}svg{display:block;width:100%;height:100vh${bg}}</style>
+  </head>
+  <body epub:type="cover">
+    <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" height="100vh" viewBox="0 0 ${opts.width} ${opts.height}" preserveAspectRatio="xMidYMid meet">
+      <image width="${opts.width}" height="${opts.height}" xlink:href="${escapeXml(opts.imageHref)}"/>
+    </svg>
+  </body>
+</html>
+`;
+}
+/** Wrap body HTML in a complete XHTML content document. */
+export function buildXhtml(opts) {
+    const css = opts.cssHref
+        ? `\n    <link rel="stylesheet" type="text/css" href="${escapeXml(opts.cssHref)}"/>`
+        : "";
+    const bodyClass = opts.bodyClass ? ` class="${escapeXml(opts.bodyClass)}"` : "";
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="${escapeXml(opts.language)}" xml:lang="${escapeXml(opts.language)}">
+  <head>
+    <meta charset="utf-8"/>
+    <title>${escapeXml(opts.title)}</title>${css}
+  </head>
+  <body${bodyClass}>
+${opts.bodyHtml}
+  </body>
+</html>
+`;
+}
+//# sourceMappingURL=opf.js.map

package/dist/opf.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+/** A single chapter (content document) in the EPUB. */
+export interface Chapter {
+    /** Chapter title. Used in the navigation/TOC and as the page heading. */
+    title: string;
+    /**
+     * Chapter body as an HTML fragment. It does not need to be well-formed XML —
+     * it is parsed and re-serialized as valid XHTML for you.
+     */
+    html: string;
+    /**
+     * When `true`, the chapter is included in the reading order (spine) but kept
+     * out of the navigation document and NCX. Useful for single-article books
+     * where a TOC entry would be redundant.
+     */
+    excludeFromToc?: boolean;
+    /**
+     * Optional author for this specific chapter, shown under the title.
+     */
+    author?: string;
+    /**
+     * Set to `false` to omit the auto-generated `<h1>` title heading and render
+     * only your HTML. Defaults to `true`.
+     */
+    insertTitle?: boolean;
+}
+/** An image to embed, either fetched from a URL or provided as raw bytes. */
+export type ImageSource = string | Uint8Array;
+/** Raw image bytes plus MIME type, as seen by an {@link ImageTransform}. */
+export interface RawImage {
+    data: Uint8Array;
+    mime: string;
+}
+/**
+ * Transform a fetched image before it is embedded. Return replacement
+ * bytes + MIME, or `null` to drop the image. May be async.
+ */
+export type ImageTransform = (image: RawImage) => RawImage | null | Promise<RawImage | null>;
+/**
+ * Build the final cover. Receives the resolved cover image (downloaded and
+ * passed through {@link ImageTransform}, or `null` when the book has no cover
+ * source) plus the book's metadata, and returns the bytes to embed — e.g. to
+ * compose a designed cover with the title. Return `null` for no cover. May be async.
+ */
+export type CoverTransform = (cover: RawImage | null, meta: {
+    title: string;
+    author?: string;
+}) => RawImage | null | Promise<RawImage | null>;
+export interface EpubOptions {
+    /** Book title. */
+    title: string;
+    /** Book author(s). A single string or a list. */
+    author?: string | string[];
+    /** Publisher metadata. */
+    publisher?: string;
+    /** Free-text description / synopsis. */
+    description?: string;
+    /** BCP-47 language tag. Defaults to `"en"`. */
+    language?: string;
+    /**
+     * Unique identifier for the book. If omitted, a deterministic `urn:uuid:` is
+     * derived from the title + author so repeated builds are stable.
+     */
+    id?: string;
+    /**
+     * Cover image. A URL (downloaded) or raw bytes. When provided, a dedicated
+     * cover page is generated.
+     */
+    cover?: ImageSource;
+    /**
+     * When no `cover` is given, use the first chapter's *leading* image (one that
+     * appears before any text) as the cover, removing it from the body so it isn't
+     * shown twice. Images that follow text are left untouched. Defaults to `false`.
+     */
+    coverFromLeadImage?: boolean;
+    /**
+     * Whether to emit a navigation document / TOC. When `false`, no nav page is
+     * generated and chapters are not listed — the differentiator this library
+     * exists for. Defaults to `true`.
+     */
+    includeToc?: boolean;
+    /**
+     * Title shown on the table-of-contents page. Defaults to `"Table of Contents"`.
+     */
+    tocTitle?: string;
+    /**
+     * CSS colour used to fill the letterbox bands around the cover on the cover
+     * page (when the cover image's aspect doesn't match the device page). Set it to
+     * the cover's edge/background colour so the bands blend in. Defaults to the
+     * reader's page background.
+     */
+    coverBackground?: string;
+    /**
+     * Override the bundled stylesheet. Pass a CSS string, or `false` to ship no
+     * stylesheet at all.
+     */
+    css?: string | false;
+    /**
+     * Fetch and embed `<img>` sources (and the cover) into the package so the EPUB
+     * is self-contained. Defaults to `true`.
+     *
+     * When `false`, nothing is fetched and any non-`data:` `<img>` (remote URLs and
+     * relative paths) is dropped — only inline `data:` images survive, keeping the
+     * output valid. To embed already-fetched bytes without hitting the network,
+     * keep this `true` and pass a custom {@link EpubOptions.fetch}.
+     */
+    downloadImages?: boolean;
+    /**
+     * Publication date as an ISO-8601 string (e.g. `"2026-06-25T00:00:00Z"`).
+     * Injected for you when running on a normal runtime; pass explicitly for
+     * reproducible builds.
+     */
+    date?: string;
+    /** Custom fetch implementation (defaults to the global `fetch`). */
+    fetch?: typeof fetch;
+    /**
+     * Hook to transform each fetched image (and the cover) before it is embedded —
+     * e.g. to transcode a format the target device can't render, or to resize.
+     * Runs after download and before the core-media-type check, so it can also
+     * rescue an otherwise-unsupported type by converting it. Return replacement
+     * bytes + MIME, or `null` to drop the image. Defaults to leaving images as-is.
+     */
+    transformImage?: ImageTransform;
+    /**
+     * Build the final cover before embedding (after the source image is downloaded
+     * and transcoded). Called even when there is no cover source, so it can compose
+     * a cover from metadata alone. See {@link CoverTransform}.
+     */
+    transformCover?: CoverTransform;
+}
+/** Input passed to {@link generateEpub}. */
+export interface EpubInput extends EpubOptions {
+    chapters: Chapter[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/util.d.ts

@@ -0,0 +1,25 @@
+/** Escape a string for use in XML text / attribute content. */
+export declare function escapeXml(value: string): string;
+export declare function encodeUtf8(value: string): Uint8Array;
+export declare function decodeUtf8(bytes: Uint8Array): string;
+/**
+ * Derive a stable `urn:uuid:` from arbitrary seed text using a FNV-1a based
+ * hash. Deterministic by design — repeated builds of the same book produce the
+ * same identifier, and we avoid `Math.random()`/`Date` so the library stays
+ * runtime-agnostic and reproducible.
+ */
+export declare function deterministicUuid(seed: string): string;
+export declare function mimeFromUrl(url: string): string | undefined;
+export declare function extFromMime(mime: string): string;
+export declare function isCoreImageType(mime: string): boolean;
+/**
+ * Read an image's pixel dimensions from its header, without decoding it.
+ * Supports PNG, GIF and JPEG (the types quarto embeds as covers); returns
+ * `undefined` for anything else or malformed data.
+ */
+export declare function imageSize(bytes: Uint8Array, mime: string): {
+    width: number;
+    height: number;
+} | undefined;
+/** Detect an image MIME type from its leading magic bytes. */
+export declare function sniffImageMime(bytes: Uint8Array): string | undefined;

package/dist/util.js

@@ -0,0 +1,157 @@
+/** Escape a string for use in XML text / attribute content. */
+export function escapeXml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+const TEXT_ENCODER = new TextEncoder();
+export function encodeUtf8(value) {
+    return TEXT_ENCODER.encode(value);
+}
+const TEXT_DECODER = new TextDecoder();
+export function decodeUtf8(bytes) {
+    return TEXT_DECODER.decode(bytes);
+}
+/**
+ * Derive a stable `urn:uuid:` from arbitrary seed text using a FNV-1a based
+ * hash. Deterministic by design — repeated builds of the same book produce the
+ * same identifier, and we avoid `Math.random()`/`Date` so the library stays
+ * runtime-agnostic and reproducible.
+ */
+export function deterministicUuid(seed) {
+    // Produce 16 bytes by hashing the seed with several different offsets.
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < 16; i++) {
+        let hash = 0x811c9dc5 ^ (i * 0x01000193);
+        for (let j = 0; j < seed.length; j++) {
+            hash ^= seed.charCodeAt(j) + i;
+            hash = Math.imul(hash, 0x01000193);
+        }
+        bytes[i] = (hash >>> 16) & 0xff;
+    }
+    // Set RFC-4122 version (4) and variant bits so it is a well-formed UUID.
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0"));
+    return `urn:uuid:${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex
+        .slice(6, 8)
+        .join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10, 16).join("")}`;
+}
+const MIME_BY_EXT = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    svg: "image/svg+xml",
+    webp: "image/webp",
+};
+const EXT_BY_MIME = {
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/gif": "gif",
+    "image/svg+xml": "svg",
+    "image/webp": "webp",
+};
+export function mimeFromUrl(url) {
+    const clean = url.split("?")[0]?.split("#")[0] ?? "";
+    const ext = clean.split(".").pop()?.toLowerCase();
+    return ext ? MIME_BY_EXT[ext] : undefined;
+}
+export function extFromMime(mime) {
+    return EXT_BY_MIME[mime.split(";")[0].trim().toLowerCase()] ?? "img";
+}
+/**
+ * EPUB 3.3 "core media types" for images. Anything outside this set needs a
+ * manifest fallback to be valid, so quarto only embeds these and drops the rest
+ * (it does no image transcoding).
+ */
+const CORE_IMAGE_TYPES = new Set([
+    "image/gif",
+    "image/jpeg",
+    "image/png",
+    "image/svg+xml",
+    "image/webp",
+]);
+export function isCoreImageType(mime) {
+    return CORE_IMAGE_TYPES.has(mime.split(";")[0].trim().toLowerCase());
+}
+/**
+ * Read an image's pixel dimensions from its header, without decoding it.
+ * Supports PNG, GIF and JPEG (the types quarto embeds as covers); returns
+ * `undefined` for anything else or malformed data.
+ */
+export function imageSize(bytes, mime) {
+    switch (mime.split(";")[0].trim().toLowerCase()) {
+        case "image/png":
+            return pngSize(bytes);
+        case "image/gif":
+            return gifSize(bytes);
+        case "image/jpeg":
+            return jpegSize(bytes);
+        default:
+            return undefined;
+    }
+}
+function u16be(b, o) {
+    return (b[o] << 8) | b[o + 1];
+}
+function u32be(b, o) {
+    return ((b[o] << 24) | (b[o + 1] << 16) | (b[o + 2] << 8) | b[o + 3]) >>> 0;
+}
+function pngSize(b) {
+    // 8-byte signature + IHDR length(4) + "IHDR"(4); width@16, height@20 (big-endian).
+    if (b.length < 24)
+        return undefined;
+    return { width: u32be(b, 16), height: u32be(b, 20) };
+}
+function gifSize(b) {
+    // Logical screen descriptor: width@6, height@8 (little-endian).
+    if (b.length < 10)
+        return undefined;
+    return { width: b[6] | (b[7] << 8), height: b[8] | (b[9] << 8) };
+}
+function jpegSize(b) {
+    let o = 2; // skip SOI (0xFFD8)
+    while (o + 9 < b.length) {
+        if (b[o] !== 0xff) {
+            o++;
+            continue;
+        }
+        const marker = b[o + 1];
+        // Start-of-frame markers carry the dimensions (excluding DHT/JPG/DAC).
+        if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+            return { height: u16be(b, o + 5), width: u16be(b, o + 7) };
+        }
+        const len = u16be(b, o + 2);
+        if (len < 2)
+            return undefined;
+        o += 2 + len;
+    }
+    return undefined;
+}
+/** Detect an image MIME type from its leading magic bytes. */
+export function sniffImageMime(bytes) {
+    if (bytes.length < 4)
+        return undefined;
+    if (bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return "image/jpeg";
+    if (bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47)
+        return "image/png";
+    if (bytes[0] === 0x47 && bytes[1] === 0x49 && bytes[2] === 0x46)
+        return "image/gif";
+    if (bytes.length >= 12 &&
+        bytes[0] === 0x52 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x46 &&
+        bytes[8] === 0x57 &&
+        bytes[9] === 0x45 &&
+        bytes[10] === 0x42 &&
+        bytes[11] === 0x50)
+        return "image/webp";
+    return undefined;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/dist/zip.d.ts

@@ -0,0 +1,9 @@
+import { type Unzipped } from "fflate";
+/**
+ * Build an EPUB zip. The OCF spec requires the first entry to be an uncompressed
+ * `mimetype` file containing exactly `application/epub+zip`; everything else is
+ * deflated normally.
+ */
+export declare function zipEpub(files: Record<string, Uint8Array>): Uint8Array;
+/** Unzip an EPUB into a path → bytes map. */
+export declare function unzipEpub(epub: Uint8Array): Unzipped;

package/dist/zip.js

@@ -0,0 +1,22 @@
+import { unzipSync, zipSync } from "fflate";
+import { encodeUtf8 } from "./util.js";
+/**
+ * Build an EPUB zip. The OCF spec requires the first entry to be an uncompressed
+ * `mimetype` file containing exactly `application/epub+zip`; everything else is
+ * deflated normally.
+ */
+export function zipEpub(files) {
+    const zippable = {
+        // Stored (level 0), and first by virtue of insertion order.
+        mimetype: [encodeUtf8("application/epub+zip"), { level: 0 }],
+    };
+    for (const [path, data] of Object.entries(files)) {
+        zippable[path] = data;
+    }
+    return zipSync(zippable, { level: 6 });
+}
+/** Unzip an EPUB into a path → bytes map. */
+export function unzipEpub(epub) {
+    return unzipSync(epub);
+}
+//# sourceMappingURL=zip.js.map

package/dist/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAiB,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAiC;IACvD,MAAM,QAAQ,GAAa;QACzB,4DAA4D;QAC5D,QAAQ,EAAE,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;KAC7D,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@voidberg/quarto",
+  "version": "0.1.0",
+  "description": "Generate EPUB3 and Kobo kepub files from HTML — runtime-agnostic, in-memory, with optional table of contents.",
+  "keywords": [
+    "epub",
+    "epub3",
+    "kepub",
+    "kobo",
+    "ebook",
+    "html-to-epub"
+  ],
+  "license": "MIT",
+  "author": "Alexandru Badiu <alexandru@badiu.me>",
+  "homepage": "https://github.com/voidberg/quarto",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voidberg/quarto.git"
+  },
+  "bugs": {
+    "url": "https://github.com/voidberg/quarto/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "validate": "node scripts/validate-epubcheck.mjs",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "fallow": "npx -y fallow",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "parse5": "^7.2.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.1",
+    "@types/node": "^24.13.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.9"
+  }
+}