@bendyline/squisq-formats 1.3.0 → 1.3.1

package/dist/container/index.d.ts

@@ -1,3 +1,5 @@
+import { ContentContainer, MemoryContentContainer } from '@bendyline/squisq/storage';
+
 /**
  * Container ZIP serialization — convert between ContentContainer and ZIP archives.
  *
@@ -10,8 +12,7 @@
  *   audio/narration.mp3
  *   timing.json
  */
-import type { ContentContainer } from '@bendyline/squisq/storage';
-import { MemoryContentContainer } from '@bendyline/squisq/storage';
+
 /**
  * Serialize a ContentContainer to a ZIP blob.
  *
@@ -21,7 +22,7 @@ import { MemoryContentContainer } from '@bendyline/squisq/storage';
  * @param container — The container to serialize
  * @returns A Blob containing the ZIP archive
  */
-export declare function containerToZip(container: ContentContainer): Promise<Blob>;
+declare function containerToZip(container: ContentContainer): Promise<Blob>;
 /**
  * Deserialize a ZIP archive into a MemoryContentContainer.
  *
@@ -32,5 +33,6 @@ export declare function containerToZip(container: ContentContainer): Promise<Blo
  * @param zipData — The ZIP archive as ArrayBuffer, Uint8Array, or Blob
  * @returns A MemoryContentContainer populated with the ZIP's contents
  */
-export declare function zipToContainer(zipData: ArrayBuffer | Uint8Array | Blob): Promise<MemoryContentContainer>;
-//# sourceMappingURL=index.d.ts.map
+declare function zipToContainer(zipData: ArrayBuffer | Uint8Array | Blob): Promise<MemoryContentContainer>;
+
+export { containerToZip, zipToContainer };

package/dist/container/index.js

@@ -1,74 +1,43 @@
-/**
- * Container ZIP serialization — convert between ContentContainer and ZIP archives.
- *
- * Uses JSZip (already a formats dependency) to serialize a ContentContainer to
- * a ZIP blob and to deserialize a ZIP blob into a MemoryContentContainer.
- *
- * ZIP structure mirrors the container's flat path hierarchy directly:
- *   index.md
- *   images/hero.jpg
- *   audio/narration.mp3
- *   timing.json
- */
-import JSZip from 'jszip';
-import { MemoryContentContainer } from '@bendyline/squisq/storage';
-/**
- * Serialize a ContentContainer to a ZIP blob.
- *
- * All files in the container are written to the ZIP archive preserving
- * their path structure. The resulting blob can be saved as a .zip file.
- *
- * @param container — The container to serialize
- * @returns A Blob containing the ZIP archive
- */
-export async function containerToZip(container) {
-    const zip = new JSZip();
-    const entries = await container.listFiles();
-    for (const entry of entries) {
-        const data = await container.readFile(entry.path);
-        if (data) {
-            zip.file(entry.path, new Uint8Array(data));
-        }
+// src/container/index.ts
+import JSZip from "jszip";
+import { MemoryContentContainer } from "@bendyline/squisq/storage";
+async function containerToZip(container) {
+  const zip = new JSZip();
+  const entries = await container.listFiles();
+  for (const entry of entries) {
+    const data = await container.readFile(entry.path);
+    if (data) {
+      zip.file(entry.path, new Uint8Array(data));
     }
-    return zip.generateAsync({
-        type: 'blob',
-        compression: 'DEFLATE',
-        compressionOptions: { level: 6 },
-    });
+  }
+  return zip.generateAsync({
+    type: "blob",
+    compression: "DEFLATE",
+    compressionOptions: { level: 6 }
+  });
 }
-/**
- * Deserialize a ZIP archive into a MemoryContentContainer.
- *
- * Reads all files from the ZIP and writes them into a new MemoryContentContainer.
- * Directory entries are skipped. The resulting container can be used immediately
- * for rendering, editing, or saving to persistent storage.
- *
- * @param zipData — The ZIP archive as ArrayBuffer, Uint8Array, or Blob
- * @returns A MemoryContentContainer populated with the ZIP's contents
- */
-export async function zipToContainer(zipData) {
-    const zip = await JSZip.loadAsync(zipData);
-    const container = new MemoryContentContainer();
-    const filePromises = [];
-    zip.forEach((relativePath, zipEntry) => {
-        // Skip directories
-        if (zipEntry.dir)
-            return;
-        // Strip leading slash if present
-        const entryPath = relativePath.startsWith('/') ? relativePath.slice(1) : relativePath;
-        if (!entryPath)
-            return;
-        // Path-traversal protection: reject absolute paths, backslashes, and .. segments
-        if (entryPath.startsWith('/') ||
-            entryPath.includes('\\') ||
-            entryPath.split('/').some((seg) => seg === '..')) {
-            return;
-        }
-        filePromises.push(zipEntry.async('arraybuffer').then((data) => {
-            return container.writeFile(entryPath, data);
-        }));
-    });
-    await Promise.all(filePromises);
-    return container;
+async function zipToContainer(zipData) {
+  const zip = await JSZip.loadAsync(zipData);
+  const container = new MemoryContentContainer();
+  const filePromises = [];
+  zip.forEach((relativePath, zipEntry) => {
+    if (zipEntry.dir) return;
+    const entryPath = relativePath.startsWith("/") ? relativePath.slice(1) : relativePath;
+    if (!entryPath) return;
+    if (entryPath.startsWith("/") || entryPath.includes("\\") || entryPath.split("/").some((seg) => seg === "..")) {
+      return;
+    }
+    filePromises.push(
+      zipEntry.async("arraybuffer").then((data) => {
+        return container.writeFile(entryPath, data);
+      })
+    );
+  });
+  await Promise.all(filePromises);
+  return container;
 }
+export {
+  containerToZip,
+  zipToContainer
+};
 //# sourceMappingURL=index.js.map

package/dist/container/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAA2B;IAC9D,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,aAAa,CAAC;QACvB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,SAAS;QACtB,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;KACjC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAwC;IAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAE/C,MAAM,YAAY,GAAoB,EAAE,CAAC;IAEzC,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE;QACrC,mBAAmB;QACnB,IAAI,QAAQ,CAAC,GAAG;YAAE,OAAO;QAEzB,iCAAiC;QACjC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QACtF,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,iFAAiF;QACjF,IACE,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YACxB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,EAChD,CAAC;YACD,OAAO;QACT,CAAC;QAED,YAAY,CAAC,IAAI,CACf,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1C,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"sources":["../../src/container/index.ts"],"sourcesContent":["/**\n * Container ZIP serialization — convert between ContentContainer and ZIP archives.\n *\n * Uses JSZip (already a formats dependency) to serialize a ContentContainer to\n * a ZIP blob and to deserialize a ZIP blob into a MemoryContentContainer.\n *\n * ZIP structure mirrors the container's flat path hierarchy directly:\n *   index.md\n *   images/hero.jpg\n *   audio/narration.mp3\n *   timing.json\n */\n\nimport JSZip from 'jszip';\nimport type { ContentContainer } from '@bendyline/squisq/storage';\nimport { MemoryContentContainer } from '@bendyline/squisq/storage';\n\n/**\n * Serialize a ContentContainer to a ZIP blob.\n *\n * All files in the container are written to the ZIP archive preserving\n * their path structure. The resulting blob can be saved as a .zip file.\n *\n * @param container — The container to serialize\n * @returns A Blob containing the ZIP archive\n */\nexport async function containerToZip(container: ContentContainer): Promise<Blob> {\n  const zip = new JSZip();\n  const entries = await container.listFiles();\n\n  for (const entry of entries) {\n    const data = await container.readFile(entry.path);\n    if (data) {\n      zip.file(entry.path, new Uint8Array(data));\n    }\n  }\n\n  return zip.generateAsync({\n    type: 'blob',\n    compression: 'DEFLATE',\n    compressionOptions: { level: 6 },\n  });\n}\n\n/**\n * Deserialize a ZIP archive into a MemoryContentContainer.\n *\n * Reads all files from the ZIP and writes them into a new MemoryContentContainer.\n * Directory entries are skipped. The resulting container can be used immediately\n * for rendering, editing, or saving to persistent storage.\n *\n * @param zipData — The ZIP archive as ArrayBuffer, Uint8Array, or Blob\n * @returns A MemoryContentContainer populated with the ZIP's contents\n */\nexport async function zipToContainer(\n  zipData: ArrayBuffer | Uint8Array | Blob,\n): Promise<MemoryContentContainer> {\n  const zip = await JSZip.loadAsync(zipData);\n  const container = new MemoryContentContainer();\n\n  const filePromises: Promise<void>[] = [];\n\n  zip.forEach((relativePath, zipEntry) => {\n    // Skip directories\n    if (zipEntry.dir) return;\n\n    // Strip leading slash if present\n    const entryPath = relativePath.startsWith('/') ? relativePath.slice(1) : relativePath;\n    if (!entryPath) return;\n\n    // Path-traversal protection: reject absolute paths, backslashes, and .. segments\n    if (\n      entryPath.startsWith('/') ||\n      entryPath.includes('\\\\') ||\n      entryPath.split('/').some((seg) => seg === '..')\n    ) {\n      return;\n    }\n\n    filePromises.push(\n      zipEntry.async('arraybuffer').then((data) => {\n        return container.writeFile(entryPath, data);\n      }),\n    );\n  });\n\n  await Promise.all(filePromises);\n  return container;\n}\n"],"mappings":";AAaA,OAAO,WAAW;AAElB,SAAS,8BAA8B;AAWvC,eAAsB,eAAe,WAA4C;AAC/E,QAAM,MAAM,IAAI,MAAM;AACtB,QAAM,UAAU,MAAM,UAAU,UAAU;AAE1C,aAAW,SAAS,SAAS;AAC3B,UAAM,OAAO,MAAM,UAAU,SAAS,MAAM,IAAI;AAChD,QAAI,MAAM;AACR,UAAI,KAAK,MAAM,MAAM,IAAI,WAAW,IAAI,CAAC;AAAA,IAC3C;AAAA,EACF;AAEA,SAAO,IAAI,cAAc;AAAA,IACvB,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB,EAAE,OAAO,EAAE;AAAA,EACjC,CAAC;AACH;AAYA,eAAsB,eACpB,SACiC;AACjC,QAAM,MAAM,MAAM,MAAM,UAAU,OAAO;AACzC,QAAM,YAAY,IAAI,uBAAuB;AAE7C,QAAM,eAAgC,CAAC;AAEvC,MAAI,QAAQ,CAAC,cAAc,aAAa;AAEtC,QAAI,SAAS,IAAK;AAGlB,UAAM,YAAY,aAAa,WAAW,GAAG,IAAI,aAAa,MAAM,CAAC,IAAI;AACzE,QAAI,CAAC,UAAW;AAGhB,QACE,UAAU,WAAW,GAAG,KACxB,UAAU,SAAS,IAAI,KACvB,UAAU,MAAM,GAAG,EAAE,KAAK,CAAC,QAAQ,QAAQ,IAAI,GAC/C;AACA;AAAA,IACF;AAEA,iBAAa;AAAA,MACX,SAAS,MAAM,aAAa,EAAE,KAAK,CAAC,SAAS;AAC3C,eAAO,UAAU,UAAU,WAAW,IAAI;AAAA,MAC5C,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,QAAM,QAAQ,IAAI,YAAY;AAC9B,SAAO;AACT;","names":[]}

package/dist/docx/index.d.ts

@@ -1,23 +1,136 @@
+import { Doc } from '@bendyline/squisq/schemas';
+import { MarkdownDocument } from '@bendyline/squisq/markdown';
+import { ContentContainer } from '@bendyline/squisq/storage';
+
 /**
- * @bendyline/squisq-formats DOCX Module
+ * DOCX Export
  *
- * Import and export squisq documents (MarkdownDocument / Doc)
- * to/from Microsoft Word .docx files (Office Open XML WordprocessingML).
+ * Converts a squisq MarkdownDocument (or Doc) into a .docx file
+ * by generating WordprocessingML XML and assembling the OOXML package.
  *
- * All operations run in the browser — no server required.
+ * No third-party docx library — all XML is generated directly using
+ * the shared ooxml/ infrastructure of this package.
  *
  * @example
  * ```ts
- * import {
- *   markdownDocToDocx,
- *   docToDocx,
- *   docxToMarkdownDoc,
- *   docxToDoc,
- * } from '@bendyline/squisq-formats/docx';
+ * import { parseMarkdown } from '@bendyline/squisq/markdown';
+ * import { markdownDocToDocx } from '@bendyline/squisq-formats/docx';
+ *
+ * const md = parseMarkdown('# Hello\n\nWorld **bold** text');
+ * const blob = await markdownDocToDocx(md);
+ * ```
+ */
+
+/**
+ * Options for DOCX export.
+ */
+interface DocxExportOptions {
+    /** Document title (appears in core properties) */
+    title?: string;
+    /** Document author */
+    author?: string;
+    /** Document description */
+    description?: string;
+    /** Default body font family. Default: "Calibri" */
+    defaultFont?: string;
+    /** Default body font size in points. Default: 11 */
+    defaultFontSize?: number;
+    /**
+     * Squisq theme ID to apply (e.g., 'documentary', 'cinematic').
+     * When set, overrides fonts with the theme's typography and applies
+     * the theme's primary color to headings.
+     */
+    themeId?: string;
+    /**
+     * Pre-resolved image data keyed by image URL/path as it appears in the
+     * markdown source. When provided, images are embedded in the .docx file
+     * as binary parts instead of emitting placeholder text.
+     */
+    images?: Map<string, {
+        data: ArrayBuffer | Uint8Array;
+        contentType: string;
+    }>;
+}
+/**
+ * Convert a MarkdownDocument to a .docx Blob.
+ *
+ * @param doc - The parsed markdown document
+ * @param options - Export options
+ * @returns An ArrayBuffer containing the .docx file
+ */
+declare function markdownDocToDocx(doc: MarkdownDocument, options?: DocxExportOptions): Promise<ArrayBuffer>;
+/**
+ * Convert a squisq Doc to a .docx Blob.
+ *
+ * Convenience wrapper that converts Doc → MarkdownDocument → DOCX.
+ *
+ * @param doc - The squisq Doc
+ * @param options - Export options
+ * @returns An ArrayBuffer containing the .docx file
+ */
+declare function docToDocx(doc: Doc, options?: DocxExportOptions): Promise<ArrayBuffer>;
+
+/**
+ * DOCX Import
+ *
+ * Parses a .docx file (Office Open XML WordprocessingML) and converts
+ * its content into a squisq MarkdownDocument (or Doc).
+ *
+ * Uses JSZip + DOMParser to read the archive and parse the XML — no
+ * third-party docx library. Handles headings, paragraphs, inline
+ * formatting (bold, italic, strikethrough), hyperlinks, lists, tables,
+ * blockquotes, code blocks, images, and footnotes.
+ *
+ * @example
+ * ```ts
+ * import { docxToMarkdownDoc } from '@bendyline/squisq-formats/docx';
+ *
+ * const response = await fetch('document.docx');
+ * const data = await response.arrayBuffer();
+ * const doc = await docxToMarkdownDoc(data);
  * ```
  */
-export { markdownDocToDocx, docToDocx } from './export.js';
-export type { DocxExportOptions } from './export.js';
-export { docxToMarkdownDoc, docxToDoc, docxToContainer } from './import.js';
-export type { DocxImportOptions } from './import.js';
-//# sourceMappingURL=index.d.ts.map
+
+/**
+ * Options for DOCX import.
+ */
+interface DocxImportOptions {
+    /**
+     * Whether to extract embedded images as base64 data URIs.
+     * When false, images are represented as `[Image]` placeholders.
+     * Default: false
+     */
+    extractImages?: boolean;
+}
+/**
+ * Convert a .docx file to a MarkdownDocument.
+ *
+ * @param data - The raw .docx file as ArrayBuffer or Blob
+ * @param options - Import options
+ * @returns A MarkdownDocument representing the document content
+ */
+declare function docxToMarkdownDoc(data: ArrayBuffer | Blob, options?: DocxImportOptions): Promise<MarkdownDocument>;
+/**
+ * Convert a .docx file to a squisq Doc.
+ *
+ * Convenience wrapper: DOCX → MarkdownDocument → Doc.
+ *
+ * @param data - The raw .docx file as ArrayBuffer or Blob
+ * @param options - Import options
+ * @returns A squisq Doc
+ */
+declare function docxToDoc(data: ArrayBuffer | Blob, options?: DocxImportOptions): Promise<Doc>;
+/**
+ * Convert a .docx file to a ContentContainer with markdown + extracted images.
+ *
+ * The container will contain:
+ * - The primary markdown document (index.md)
+ * - Any embedded images under images/ (e.g., images/image1.png)
+ *
+ * @param data - The raw .docx file as ArrayBuffer or Blob
+ * @param options - Import options
+ * @returns A ContentContainer with the document and its media
+ */
+declare function docxToContainer(data: ArrayBuffer | Blob, options?: DocxImportOptions): Promise<ContentContainer>;
+
+export { type DocxExportOptions, type DocxImportOptions, docToDocx, docxToContainer, docxToDoc, docxToMarkdownDoc, markdownDocToDocx };

package/dist/docx/index.js

@@ -1,23 +1,18 @@
-/**
- * @bendyline/squisq-formats DOCX Module
- *
- * Import and export squisq documents (MarkdownDocument / Doc)
- * to/from Microsoft Word .docx files (Office Open XML WordprocessingML).
- *
- * All operations run in the browser — no server required.
- *
- * @example
- * ```ts
- * import {
- *   markdownDocToDocx,
- *   docToDocx,
- *   docxToMarkdownDoc,
- *   docxToDoc,
- * } from '@bendyline/squisq-formats/docx';
- * ```
- */
-// Export
-export { markdownDocToDocx, docToDocx } from './export.js';
-// Import
-export { docxToMarkdownDoc, docxToDoc, docxToContainer } from './import.js';
+import {
+  docToDocx,
+  docxToContainer,
+  docxToDoc,
+  docxToMarkdownDoc,
+  markdownDocToDocx
+} from "../chunk-UDS45KUJ.js";
+import "../chunk-YN5HFCEW.js";
+import "../chunk-7DEUGIOO.js";
+import "../chunk-U4MRIFKL.js";
+export {
+  docToDocx,
+  docxToContainer,
+  docxToDoc,
+  docxToMarkdownDoc,
+  markdownDocToDocx
+};
 //# sourceMappingURL=index.js.map

package/dist/docx/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG3D,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/epub/index.d.ts

@@ -1,20 +1,75 @@
+import { AudioSegment, Doc } from '@bendyline/squisq/schemas';
+import { MarkdownDocument } from '@bendyline/squisq/markdown';
+
 /**
- * @bendyline/squisq-formats EPUB Module
+ * EPUB 3 Export
  *
- * Export squisq documents (MarkdownDocument / Doc) to EPUB 3 e-book files.
+ * Converts a MarkdownDocument (or Doc) to an EPUB 3 file (.epub).
  *
- * Content is split into chapters at H1/H2 heading boundaries. Images
- * referenced in the markdown are embedded in the archive when provided
- * via the `images` option.
+ * An EPUB is a ZIP archive containing XHTML chapter files, images,
+ * a package manifest (content.opf), and a navigation document (toc.xhtml).
+ * Content is split into chapters at H1/H2 heading boundaries.
+ *
+ * Uses JSZip for packaging (already a dependency), escapeXml from the
+ * OOXML utils, and image utilities from the HTML exporter.
  *
  * @example
  * ```ts
- * import { markdownDocToEpub, docToEpub } from '@bendyline/squisq-formats/epub';
+ * import { markdownDocToEpub } from '@bendyline/squisq-formats/epub';
  *
- * const epub = await markdownDocToEpub(markdownDoc, { title: 'My Book' });
- * const epub2 = await docToEpub(doc, { author: 'Jane Doe' });
+ * const epub = await markdownDocToEpub(markdownDoc, {
+ *   title: 'My Book',
+ *   author: 'Jane Doe',
+ * });
  * ```
  */
-export { markdownDocToEpub, docToEpub } from './export.js';
-export type { EpubExportOptions } from './export.js';
-//# sourceMappingURL=index.d.ts.map
+
+interface EpubExportOptions {
+    /** Book title (default: 'Untitled') */
+    title?: string;
+    /** Author name */
+    author?: string;
+    /** Book description / summary */
+    description?: string;
+    /** BCP-47 language code (default: 'en') */
+    language?: string;
+    /** Publisher name */
+    publisher?: string;
+    /** Squisq theme ID for CSS styling */
+    themeId?: string;
+    /** Pre-resolved image data keyed by relative path as it appears in the markdown */
+    images?: Map<string, ArrayBuffer>;
+    /** Cover image data (JPEG or PNG) */
+    coverImage?: ArrayBuffer;
+    /**
+     * Audio narration data keyed by segment src/name.
+     * When provided alongside audioSegments, EPUB 3 Media Overlays (SMIL)
+     * are generated for synchronized audio playback.
+     */
+    audio?: Map<string, ArrayBuffer>;
+    /**
+     * Audio segment metadata (from Doc.audio.segments).
+     * Required together with `audio` to generate Media Overlays.
+     * Each segment's duration and startTime are used to build SMIL timing.
+     */
+    audioSegments?: AudioSegment[];
+    /** Total document duration in seconds (used for Media Overlay metadata) */
+    totalDuration?: number;
+}
+/**
+ * Convert a MarkdownDocument to an EPUB 3 file.
+ *
+ * Chapters are split at H1/H2 heading boundaries. All referenced images
+ * (provided via `options.images`) are embedded in the archive.
+ */
+declare function markdownDocToEpub(doc: MarkdownDocument, options?: EpubExportOptions): Promise<ArrayBuffer>;
+/**
+ * Convert a squisq Doc to an EPUB 3 file.
+ *
+ * Convenience wrapper: Doc → MarkdownDocument → EPUB.
+ * When the Doc has audio segments and `options.audio` is provided,
+ * EPUB 3 Media Overlays are generated for narrated playback.
+ */
+declare function docToEpub(doc: Doc, options?: EpubExportOptions): Promise<ArrayBuffer>;
+
+export { type EpubExportOptions, docToEpub, markdownDocToEpub };

package/dist/epub/index.js

@@ -1,19 +1,11 @@
-/**
- * @bendyline/squisq-formats EPUB Module
- *
- * Export squisq documents (MarkdownDocument / Doc) to EPUB 3 e-book files.
- *
- * Content is split into chapters at H1/H2 heading boundaries. Images
- * referenced in the markdown are embedded in the archive when provided
- * via the `images` option.
- *
- * @example
- * ```ts
- * import { markdownDocToEpub, docToEpub } from '@bendyline/squisq-formats/epub';
- *
- * const epub = await markdownDocToEpub(markdownDoc, { title: 'My Book' });
- * const epub2 = await docToEpub(doc, { author: 'Jane Doe' });
- * ```
- */
-export { markdownDocToEpub, docToEpub } from './export.js';
+import {
+  docToEpub,
+  markdownDocToEpub
+} from "../chunk-ERZ627GR.js";
+import "../chunk-U4MRIFKL.js";
+import "../chunk-A3FHLTY5.js";
+export {
+  docToEpub,
+  markdownDocToEpub
+};
 //# sourceMappingURL=index.js.map

package/dist/epub/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/epub/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}