@bendyline/squisq-formats 2.0.0 → 2.1.0

package/dist/container/index.js

@@ -2,12 +2,12 @@ import {
   ZipSafetyError,
   assertSafeZipPath,
   openBoundedZipArchive
-} from "../chunk-H7T5DXUU.js";
+} from "../chunk-FE6OJV6O.js";
 
 // src/container/index.ts
 import JSZip from "jszip";
 import { MemoryContentContainer } from "@bendyline/squisq/storage";
-async function containerToZip(container) {
+async function containerToZip(container, options = {}) {
   const zip = new JSZip();
   const entries = await container.listFiles();
   for (const entry of entries) {
@@ -17,10 +17,15 @@ async function containerToZip(container) {
       zip.file(entry.path, new Uint8Array(data));
     }
   }
+  const compression = options.compression ?? "DEFLATE";
+  const compressionLevel = options.compressionLevel ?? 6;
+  if (!Number.isSafeInteger(compressionLevel) || compressionLevel < 1 || compressionLevel > 9) {
+    throw new Error("ZIP compression level must be an integer between 1 and 9");
+  }
   return zip.generateAsync({
     type: "blob",
-    compression: "DEFLATE",
-    compressionOptions: { level: 6 }
+    compression,
+    ...compression === "DEFLATE" ? { compressionOptions: { level: compressionLevel } } : {}
   });
 }
 async function zipToContainer(zipData, options = {}) {

package/dist/container/index.js.map

@@ -1 +1 @@
-{"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';\nimport {\n  assertSafeZipPath,\n  openBoundedZipArchive,\n  ZipSafetyError,\n  type ZipSafetyLimits,\n  type ZipSafetyErrorCode,\n  type ZipSafetyErrorOptions,\n} from '../shared/zipSafety.js';\n\nexport type ZipToContainerOptions = ZipSafetyLimits;\nexport { ZipSafetyError };\nexport type { ZipSafetyLimits, ZipSafetyErrorCode, ZipSafetyErrorOptions };\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    assertSafeZipPath(entry.path);\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  options: ZipToContainerOptions = {},\n): Promise<MemoryContentContainer> {\n  const archive = await openBoundedZipArchive(zipData, options);\n  const container = new MemoryContentContainer();\n  for (const { path } of archive.entries) {\n    const data = await archive.read(path);\n    if (data) await container.writeFile(path, data);\n    archive.release(path);\n  }\n  return container;\n}\n"],"mappings":";;;;;;;AAaA,OAAO,WAAW;AAElB,SAAS,8BAA8B;AAuBvC,eAAsB,eAAe,WAA4C;AAC/E,QAAM,MAAM,IAAI,MAAM;AACtB,QAAM,UAAU,MAAM,UAAU,UAAU;AAE1C,aAAW,SAAS,SAAS;AAC3B,sBAAkB,MAAM,IAAI;AAC5B,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,SACA,UAAiC,CAAC,GACD;AACjC,QAAM,UAAU,MAAM,sBAAsB,SAAS,OAAO;AAC5D,QAAM,YAAY,IAAI,uBAAuB;AAC7C,aAAW,EAAE,KAAK,KAAK,QAAQ,SAAS;AACtC,UAAM,OAAO,MAAM,QAAQ,KAAK,IAAI;AACpC,QAAI,KAAM,OAAM,UAAU,UAAU,MAAM,IAAI;AAC9C,YAAQ,QAAQ,IAAI;AAAA,EACtB;AACA,SAAO;AACT;","names":[]}
+{"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';\nimport {\n  assertSafeZipPath,\n  openBoundedZipArchive,\n  ZipSafetyError,\n  type ZipSafetyLimits,\n  type ZipSafetyErrorCode,\n  type ZipSafetyErrorOptions,\n} from '../shared/zipSafety.js';\n\nexport type ZipToContainerOptions = ZipSafetyLimits;\nexport interface ContainerToZipOptions {\n  /** STORE avoids producing archives that violate strict import compression-ratio policies. */\n  compression?: 'STORE' | 'DEFLATE';\n  /** JSZip DEFLATE level; ignored for STORE. */\n  compressionLevel?: number;\n}\nexport { ZipSafetyError };\nexport type { ZipSafetyLimits, ZipSafetyErrorCode, ZipSafetyErrorOptions };\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(\n  container: ContentContainer,\n  options: ContainerToZipOptions = {},\n): Promise<Blob> {\n  const zip = new JSZip();\n  const entries = await container.listFiles();\n\n  for (const entry of entries) {\n    assertSafeZipPath(entry.path);\n    const data = await container.readFile(entry.path);\n    if (data) {\n      zip.file(entry.path, new Uint8Array(data));\n    }\n  }\n\n  const compression = options.compression ?? 'DEFLATE';\n  const compressionLevel = options.compressionLevel ?? 6;\n  if (!Number.isSafeInteger(compressionLevel) || compressionLevel < 1 || compressionLevel > 9) {\n    throw new Error('ZIP compression level must be an integer between 1 and 9');\n  }\n  return zip.generateAsync({\n    type: 'blob',\n    compression,\n    ...(compression === 'DEFLATE' ? { compressionOptions: { level: compressionLevel } } : {}),\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  options: ZipToContainerOptions = {},\n): Promise<MemoryContentContainer> {\n  const archive = await openBoundedZipArchive(zipData, options);\n  const container = new MemoryContentContainer();\n  for (const { path } of archive.entries) {\n    const data = await archive.read(path);\n    if (data) await container.writeFile(path, data);\n    archive.release(path);\n  }\n  return container;\n}\n"],"mappings":";;;;;;;AAaA,OAAO,WAAW;AAElB,SAAS,8BAA8B;AA6BvC,eAAsB,eACpB,WACA,UAAiC,CAAC,GACnB;AACf,QAAM,MAAM,IAAI,MAAM;AACtB,QAAM,UAAU,MAAM,UAAU,UAAU;AAE1C,aAAW,SAAS,SAAS;AAC3B,sBAAkB,MAAM,IAAI;AAC5B,UAAM,OAAO,MAAM,UAAU,SAAS,MAAM,IAAI;AAChD,QAAI,MAAM;AACR,UAAI,KAAK,MAAM,MAAM,IAAI,WAAW,IAAI,CAAC;AAAA,IAC3C;AAAA,EACF;AAEA,QAAM,cAAc,QAAQ,eAAe;AAC3C,QAAM,mBAAmB,QAAQ,oBAAoB;AACrD,MAAI,CAAC,OAAO,cAAc,gBAAgB,KAAK,mBAAmB,KAAK,mBAAmB,GAAG;AAC3F,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO,IAAI,cAAc;AAAA,IACvB,MAAM;AAAA,IACN;AAAA,IACA,GAAI,gBAAgB,YAAY,EAAE,oBAAoB,EAAE,OAAO,iBAAiB,EAAE,IAAI,CAAC;AAAA,EACzF,CAAC;AACH;AAYA,eAAsB,eACpB,SACA,UAAiC,CAAC,GACD;AACjC,QAAM,UAAU,MAAM,sBAAsB,SAAS,OAAO;AAC5D,QAAM,YAAY,IAAI,uBAAuB;AAC7C,aAAW,EAAE,KAAK,KAAK,QAAQ,SAAS;AACtC,UAAM,OAAO,MAAM,QAAQ,KAAK,IAAI;AACpC,QAAI,KAAM,OAAM,UAAU,UAAU,MAAM,IAAI;AAC9C,YAAQ,QAAQ,IAAI;AAAA,EACtB;AACA,SAAO;AACT;","names":[]}

package/dist/docx/index.d.ts

@@ -1,8 +1,8 @@
 import { ThemeRegistry, Doc } from '@bendyline/squisq/schemas';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { O as OoxmlOpenOptions } from '../reader-Gof6OrJX.js';
+import { O as OoxmlOpenOptions } from '../reader-B9L8Ucbj.js';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import '../zipLimits-bGYMS9cI.js';
+import '../zipLimits-BOKCB7qk.js';
 
 /**
  * DOCX Export

package/dist/docx/index.js

@@ -4,13 +4,14 @@ import {
   docxToDoc,
   docxToMarkdownDoc,
   markdownDocToDocx
-} from "../chunk-2CSZJEAL.js";
+} from "../chunk-NNHKUXKA.js";
 import "../chunk-6M7Z25LA.js";
 import "../chunk-PN52A5AA.js";
-import "../chunk-XTLQXR4U.js";
+import "../chunk-YRT7GQ5Y.js";
+import "../chunk-KURGXM4I.js";
 import "../chunk-U4MRIFKL.js";
-import "../chunk-4HJ6AK2Q.js";
-import "../chunk-H7T5DXUU.js";
+import "../chunk-7ARKUCQT.js";
+import "../chunk-FE6OJV6O.js";
 import "../chunk-SSUPBUF5.js";
 import "../chunk-O3GVVND4.js";
 export {

package/dist/{export-Djev9BLU.d.ts → export-D2NkylDT.d.ts}

@@ -1,5 +1,5 @@
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { O as OoxmlOpenOptions } from './reader-Gof6OrJX.js';
+import { O as OoxmlOpenOptions } from './reader-B9L8Ucbj.js';
 import { Doc } from '@bendyline/squisq/schemas';
 
 /**

package/dist/{extract-LNOA7DBK.js → extract-OJ7ZQV6P.js}

@@ -2,14 +2,14 @@ import {
   extractDocxTheme,
   extractPptxTheme,
   extractXlsxTheme
-} from "./chunk-CX3LH47J.js";
-import "./chunk-X4USWOQ2.js";
+} from "./chunk-74GO3FVS.js";
+import "./chunk-SC67HYQJ.js";
 import "./chunk-YRT7GQ5Y.js";
-import "./chunk-4HJ6AK2Q.js";
-import "./chunk-H7T5DXUU.js";
+import "./chunk-7ARKUCQT.js";
+import "./chunk-FE6OJV6O.js";
 export {
   extractDocxTheme,
   extractPptxTheme,
   extractXlsxTheme
 };
-//# sourceMappingURL=extract-LNOA7DBK.js.map
+//# sourceMappingURL=extract-OJ7ZQV6P.js.map

package/dist/html/index.js

@@ -9,7 +9,7 @@ import {
   markdownDocToPlainHtml,
   markdownDocsToHtmlBundle,
   markdownDocsToPlainHtmlBundle
-} from "../chunk-LXYLOOST.js";
+} from "../chunk-DTDF6QDP.js";
 import {
   arrayBufferToBase64DataUrl,
   extractFilename,

package/dist/{import-Yivc3kZM.d.ts → import-K8mfc0fz.d.ts}

@@ -1,6 +1,6 @@
 import { ThemeRegistry, Doc } from '@bendyline/squisq/schemas';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { O as OoxmlOpenOptions } from './reader-Gof6OrJX.js';
+import { O as OoxmlOpenOptions } from './reader-B9L8Ucbj.js';
 import { ContentContainer } from '@bendyline/squisq/storage';
 
 /**

package/dist/index.d.ts

@@ -6,15 +6,16 @@ export { PdfExportOptions, PdfImportOptions, configurePdfWorker, docToPdf, markd
 export { HtmlZipExportOptions, docToHtml, docToHtmlZip } from './html/index.js';
 export { EpubExportOptions, docToEpub, markdownDocToEpub } from './epub/index.js';
 export { ExtractedFileTheme, InferSourceFormat, InferThemeOptions, InferredFileTheme, compileExtractedTheme, inferThemeFromFile } from './infer/index.js';
-export { BUILTIN_FORMAT_IDS, BuiltinFormatOptions, ConversionError, ConversionErrorCode, ConversionErrorOptions, ConversionResult, ConvertOptions, ConvertSource, DbkFormatOptions, FormatDefinition, FormatId, FormatRegistry, MarkdownFormatOptions, NormalizedInput, convert, createRegistry, defaultFormats, defaultRegistry } from './registry/index.js';
-export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from './zipLimits-bGYMS9cI.js';
+export { BUILTIN_FORMAT_IDS, BuiltinFormatOptions, ConversionError, ConversionErrorCode, ConversionErrorOptions, ConversionResult, ConvertOptions, ConvertSource, DbkFormatOptions, FormatDefinition, FormatId, FormatRegistry, MarkdownFormatOptions, NormalizedInput, PreparedConversion, PreparedExportOptions, convert, createRegistry, defaultFormats, defaultRegistry, prepareConversion } from './registry/index.js';
+export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from './zipLimits-BOKCB7qk.js';
 export { H as HtmlExportOptions, a as HtmlImportOptions, c as collectImagePaths, h as htmlToMarkdown, b as htmlToMarkdownDoc, d as htmlToMarkdownDocSync } from './import-DTkDxHmZ.js';
-export { P as PptxExportOptions, a as PptxImportOptions, d as docToPptx, m as markdownDocToPptx, p as pptxToMarkdownDoc } from './import-Yivc3kZM.js';
-export { X as XlsxExportOptions, a as XlsxImportOptions, d as docToXlsx, m as markdownDocToXlsx, x as xlsxToMarkdownDoc } from './export-Djev9BLU.js';
+export { P as PptxExportOptions, a as PptxImportOptions, d as docToPptx, m as markdownDocToPptx, p as pptxToMarkdownDoc } from './import-K8mfc0fz.js';
+export { X as XlsxExportOptions, a as XlsxImportOptions, d as docToXlsx, m as markdownDocToXlsx, x as xlsxToMarkdownDoc } from './export-D2NkylDT.js';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/markdown';
-import './reader-Gof6OrJX.js';
+import './reader-B9L8Ucbj.js';
 import '@bendyline/squisq/storage';
-import './layouts-CZ0bdsNL.js';
-import './themeReader-DPw4J5Ss.js';
+import './layouts-BHrgZ5FS.js';
+import './themeReader-DJKErl_j.js';
 import '@bendyline/squisq/transform';
+import './container/index.js';

package/dist/index.js

@@ -7,15 +7,16 @@ import {
   convert,
   createRegistry,
   defaultFormats,
-  defaultRegistry
-} from "./chunk-2EFDWKC6.js";
+  defaultRegistry,
+  prepareConversion
+} from "./chunk-WQSHGBLN.js";
 import {
   inferThemeFromFile
-} from "./chunk-ZZ7D4DN6.js";
+} from "./chunk-EW54IRRS.js";
 import {
   ConversionError
 } from "./chunk-ODL3SSPT.js";
-import "./chunk-CX3LH47J.js";
+import "./chunk-74GO3FVS.js";
 import {
   compileExtractedTheme
 } from "./chunk-NKAJPJ4G.js";
@@ -24,21 +25,21 @@ import {
   docxToDoc,
   docxToMarkdownDoc,
   markdownDocToDocx
-} from "./chunk-2CSZJEAL.js";
+} from "./chunk-NNHKUXKA.js";
 import {
   docToPptx,
   markdownDocToPptx,
   pptxToDoc,
   pptxToMarkdownDoc
-} from "./chunk-CVNVD7VH.js";
-import "./chunk-2PRVLAU3.js";
+} from "./chunk-RLU7UFYU.js";
+import "./chunk-QFLDYKCR.js";
 import "./chunk-6M7Z25LA.js";
 import {
   docToXlsx,
   markdownDocToXlsx,
   xlsxToDoc,
   xlsxToMarkdownDoc
-} from "./chunk-HBSCRS5P.js";
+} from "./chunk-UGYF5AZE.js";
 import "./chunk-PN52A5AA.js";
 import {
   csvToDoc,
@@ -46,14 +47,14 @@ import {
   markdownDocToCsv,
   parseCsv
 } from "./chunk-RFAPOKHJ.js";
-import "./chunk-X4USWOQ2.js";
+import "./chunk-SC67HYQJ.js";
 import "./chunk-YRT7GQ5Y.js";
-import "./chunk-XTLQXR4U.js";
+import "./chunk-KURGXM4I.js";
 import "./chunk-U4MRIFKL.js";
-import "./chunk-4HJ6AK2Q.js";
+import "./chunk-7ARKUCQT.js";
 import {
   ZipSafetyError
-} from "./chunk-H7T5DXUU.js";
+} from "./chunk-FE6OJV6O.js";
 import {
   configurePdfWorker,
   docToPdf,
@@ -69,7 +70,7 @@ import {
   htmlToMarkdown,
   htmlToMarkdownDoc,
   htmlToMarkdownDocSync
-} from "./chunk-LXYLOOST.js";
+} from "./chunk-DTDF6QDP.js";
 import "./chunk-MLX2BOJC.js";
 import "./chunk-O3GVVND4.js";
 export {
@@ -109,6 +110,7 @@ export {
   pdfToMarkdownDoc,
   pptxToDoc,
   pptxToMarkdownDoc,
+  prepareConversion,
   xlsxToDoc,
   xlsxToMarkdownDoc
 };

package/dist/infer/index.d.ts

@@ -1,8 +1,8 @@
 import { Theme, DeepPartial, CustomTemplateDefinition } from '@bendyline/squisq/schemas';
-import { a as OoxmlPackage, O as OoxmlOpenOptions } from '../reader-Gof6OrJX.js';
-import { O as OoxmlColorScheme, a as OoxmlFontScheme } from '../themeReader-DPw4J5Ss.js';
-import { P as PptxColorHints } from '../layouts-CZ0bdsNL.js';
-import '../zipLimits-bGYMS9cI.js';
+import { a as OoxmlPackage, O as OoxmlOpenOptions } from '../reader-B9L8Ucbj.js';
+import { O as OoxmlColorScheme, a as OoxmlFontScheme } from '../themeReader-DJKErl_j.js';
+import { P as PptxColorHints } from '../layouts-BHrgZ5FS.js';
+import '../zipLimits-BOKCB7qk.js';
 
 /**
  * Shared types for file-import theme inference.

package/dist/infer/index.js

@@ -1,21 +1,21 @@
 import {
   inferThemeFromFile
-} from "../chunk-ZZ7D4DN6.js";
+} from "../chunk-EW54IRRS.js";
 import "../chunk-ODL3SSPT.js";
 import {
   extractDocxTheme,
   extractPptxTheme,
   extractXlsxTheme
-} from "../chunk-CX3LH47J.js";
+} from "../chunk-74GO3FVS.js";
 import {
   colorHintsFromExtraction,
   compileExtractedTheme,
   extractedThemeToPartial
 } from "../chunk-NKAJPJ4G.js";
-import "../chunk-X4USWOQ2.js";
+import "../chunk-SC67HYQJ.js";
 import "../chunk-YRT7GQ5Y.js";
-import "../chunk-4HJ6AK2Q.js";
-import "../chunk-H7T5DXUU.js";
+import "../chunk-7ARKUCQT.js";
+import "../chunk-FE6OJV6O.js";
 export {
   colorHintsFromExtraction,
   compileExtractedTheme,

package/dist/{layouts-7OUUVAGU.js → layouts-5VDIRPIJ.js}

@@ -1,12 +1,12 @@
 import {
   analyzePptxLayouts,
   inspectPptxLayouts
-} from "./chunk-2PRVLAU3.js";
+} from "./chunk-QFLDYKCR.js";
 import "./chunk-YRT7GQ5Y.js";
-import "./chunk-4HJ6AK2Q.js";
-import "./chunk-H7T5DXUU.js";
+import "./chunk-7ARKUCQT.js";
+import "./chunk-FE6OJV6O.js";
 export {
   analyzePptxLayouts,
   inspectPptxLayouts
 };
-//# sourceMappingURL=layouts-7OUUVAGU.js.map
+//# sourceMappingURL=layouts-5VDIRPIJ.js.map

package/dist/{layouts-CZ0bdsNL.d.ts → layouts-BHrgZ5FS.d.ts}

@@ -1,5 +1,5 @@
 import { CustomTemplateDefinition } from '@bendyline/squisq/schemas';
-import { O as OoxmlOpenOptions, a as OoxmlPackage } from './reader-Gof6OrJX.js';
+import { O as OoxmlOpenOptions, a as OoxmlPackage } from './reader-B9L8Ucbj.js';
 
 /**
  * PPTX slide-layout inference — reads the layouts/masters a deck actually

package/dist/ooxml/index.d.ts

@@ -1,7 +1,7 @@
-import { R as Relationship, C as CoreProperties } from '../reader-Gof6OrJX.js';
-export { b as ContentTypeMap, O as OoxmlOpenOptions, a as OoxmlPackage, P as PackagePart, c as PendingRelationship, g as getCoreProperties, d as getPartBinary, e as getPartRelationships, f as getPartXml, o as openPackage } from '../reader-Gof6OrJX.js';
-export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from '../zipLimits-bGYMS9cI.js';
-export { O as OoxmlColorScheme, a as OoxmlFontScheme, b as OoxmlTheme, p as parseThemeXml, r as readThemePart } from '../themeReader-DPw4J5Ss.js';
+import { R as Relationship, C as CoreProperties } from '../reader-B9L8Ucbj.js';
+export { b as ContentTypeMap, O as OoxmlOpenOptions, a as OoxmlPackage, P as PackagePart, c as PendingRelationship, g as getCoreProperties, d as getPartBinary, e as getPartRelationships, f as getPartXml, o as openPackage } from '../reader-B9L8Ucbj.js';
+export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions, c as ZipSafetyLimits } from '../zipLimits-BOKCB7qk.js';
+export { O as OoxmlColorScheme, a as OoxmlFontScheme, b as OoxmlTheme, p as parseThemeXml, r as readThemePart } from '../themeReader-DJKErl_j.js';
 
 /**
  * Shared DOM-read helpers for OOXML importers.

package/dist/ooxml/index.js

@@ -1,7 +1,7 @@
 import {
   parseThemeXml,
   readThemePart
-} from "../chunk-X4USWOQ2.js";
+} from "../chunk-SC67HYQJ.js";
 import {
   attrNS,
   baseDirOf,
@@ -10,7 +10,7 @@ import {
 } from "../chunk-YRT7GQ5Y.js";
 import {
   createPackage
-} from "../chunk-XTLQXR4U.js";
+} from "../chunk-KURGXM4I.js";
 import {
   attrString,
   escapeXml,
@@ -70,10 +70,10 @@ import {
   getPartRelationships,
   getPartXml,
   openPackage
-} from "../chunk-4HJ6AK2Q.js";
+} from "../chunk-7ARKUCQT.js";
 import {
   ZipSafetyError
-} from "../chunk-H7T5DXUU.js";
+} from "../chunk-FE6OJV6O.js";
 export {
   CONTENT_TYPE_CORE_PROPERTIES,
   CONTENT_TYPE_DOCX_DOCUMENT,

package/dist/pptx/index.d.ts

@@ -1,10 +1,10 @@
-import { a as PptxImportOptions } from '../import-Yivc3kZM.js';
-export { P as PptxExportOptions, d as docToPptx, m as markdownDocToPptx, b as pptxToContainer, p as pptxToMarkdownDoc } from '../import-Yivc3kZM.js';
+import { a as PptxImportOptions } from '../import-K8mfc0fz.js';
+export { P as PptxExportOptions, d as docToPptx, m as markdownDocToPptx, b as pptxToContainer, p as pptxToMarkdownDoc } from '../import-K8mfc0fz.js';
 import { Doc } from '@bendyline/squisq/schemas';
-export { A as AnalyzePptxLayoutsOptions, a as AnalyzedLayout, E as ExtractedPlaceholder, b as ExtractedSlideLayout, I as InspectPptxLayoutsOptions, L as LayoutVerdict, P as PptxColorHints, c as PptxLayoutInference, d as PptxLayoutSummary, e as analyzePptxLayouts, i as inspectPptxLayouts } from '../layouts-CZ0bdsNL.js';
+export { A as AnalyzePptxLayoutsOptions, a as AnalyzedLayout, E as ExtractedPlaceholder, b as ExtractedSlideLayout, I as InspectPptxLayoutsOptions, L as LayoutVerdict, P as PptxColorHints, c as PptxLayoutInference, d as PptxLayoutSummary, e as analyzePptxLayouts, i as inspectPptxLayouts } from '../layouts-BHrgZ5FS.js';
 import '@bendyline/squisq/markdown';
-import '../reader-Gof6OrJX.js';
-import '../zipLimits-bGYMS9cI.js';
+import '../reader-B9L8Ucbj.js';
+import '../zipLimits-BOKCB7qk.js';
 import '@bendyline/squisq/storage';
 
 /**

package/dist/pptx/index.js

@@ -4,18 +4,18 @@ import {
   pptxToContainer,
   pptxToDoc,
   pptxToMarkdownDoc
-} from "../chunk-CVNVD7VH.js";
+} from "../chunk-RLU7UFYU.js";
 import {
   analyzePptxLayouts,
   inspectPptxLayouts
-} from "../chunk-2PRVLAU3.js";
+} from "../chunk-QFLDYKCR.js";
 import "../chunk-6M7Z25LA.js";
 import "../chunk-PN52A5AA.js";
 import "../chunk-YRT7GQ5Y.js";
-import "../chunk-XTLQXR4U.js";
+import "../chunk-KURGXM4I.js";
 import "../chunk-U4MRIFKL.js";
-import "../chunk-4HJ6AK2Q.js";
-import "../chunk-H7T5DXUU.js";
+import "../chunk-7ARKUCQT.js";
+import "../chunk-FE6OJV6O.js";
 import "../chunk-SSUPBUF5.js";
 import "../chunk-MLX2BOJC.js";
 import "../chunk-O3GVVND4.js";

package/dist/{reader-Gof6OrJX.d.ts → reader-B9L8Ucbj.d.ts}

@@ -1,4 +1,4 @@
-import { c as ZipSafetyLimits } from './zipLimits-bGYMS9cI.js';
+import { c as ZipSafetyLimits } from './zipLimits-BOKCB7qk.js';
 
 /**
  * OOXML Types
@@ -89,8 +89,8 @@ interface PendingRelationship {
  * structural metadata: [Content_Types].xml, relationships, and
  * core properties.
  *
- * Uses bounded JSZip member streams and a platform DOMParser (with an xmldom
- * fallback in bare Node/SSR) to parse XML.
+ * Uses bounded JSZip member streams and a platform DOMParser (with the
+ * package-owned xmldom parser in Node/SSR) to parse XML.
  */
 
 type OoxmlOpenOptions = ZipSafetyLimits;

package/dist/registry/index.d.ts

@@ -3,14 +3,15 @@ import { TransformStyleInput, TransformStyleRegistry } from '@bendyline/squisq/t
 import { ParseOptions, StringifyOptions, MarkdownDocument } from '@bendyline/squisq/markdown';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { DocxImportOptions, DocxExportOptions } from '../docx/index.js';
-import { a as PptxImportOptions, P as PptxExportOptions } from '../import-Yivc3kZM.js';
-import { a as XlsxImportOptions, X as XlsxExportOptions } from '../export-Djev9BLU.js';
+import { a as PptxImportOptions, P as PptxExportOptions } from '../import-K8mfc0fz.js';
+import { a as XlsxImportOptions, X as XlsxExportOptions } from '../export-D2NkylDT.js';
 import { CsvImportOptions, CsvExportOptions } from '../csv/index.js';
 import { PdfImportOptions, PdfExportOptions } from '../pdf/index.js';
 import { a as HtmlImportOptions, H as HtmlExportOptions } from '../import-DTkDxHmZ.js';
 import { EpubExportOptions } from '../epub/index.js';
-import { c as ZipSafetyLimits } from '../zipLimits-bGYMS9cI.js';
-import '../reader-Gof6OrJX.js';
+import { ContainerToZipOptions } from '../container/index.js';
+import { c as ZipSafetyLimits } from '../zipLimits-BOKCB7qk.js';
+import '../reader-B9L8Ucbj.js';
 
 /**
  * Format registry — shared types.
@@ -42,7 +43,7 @@ interface MarkdownFormatOptions {
     stringify?: StringifyOptions;
 }
 /** Resource limits applied when importing a DBK/ZIP container. */
-type DbkFormatOptions = ZipSafetyLimits;
+type DbkFormatOptions = ZipSafetyLimits & ContainerToZipOptions;
 /**
  * Strongly typed option bags for built-in formats. Import and export options
  * share a bag because a single conversion may use the format on either side.
@@ -74,6 +75,8 @@ interface NormalizedInput {
 }
 /** Options threaded through `convert()` and into every format method. */
 interface ConvertOptions {
+    /** Cancel normalization, transformation, or export at the next bounded work boundary. */
+    signal?: AbortSignal;
     /** Registry to resolve formats against. Defaults to `defaultRegistry()`. */
     registry?: FormatRegistry;
     /** Explicit source format id (skips extension/byte sniffing). */
@@ -95,6 +98,15 @@ interface ConvertOptions {
     /** Typed per-format options for built-ins; custom format ids remain extensible. */
     formatOptions?: Partial<BuiltinFormatOptions> & Record<FormatId, unknown>;
 }
+/** Target-only options accepted after a source has already been normalized and transformed. */
+type PreparedExportOptions = Pick<ConvertOptions, 'signal' | 'title' | 'resolvePlayerScript' | 'formatOptions'>;
+/**
+ * An opaque normalized conversion snapshot. The source and transform pipeline
+ * has already completed; each call exports that same snapshot to one target.
+ */
+interface PreparedConversion {
+    convert(to: FormatId, options?: PreparedExportOptions): Promise<ConversionResult>;
+}
 /** Describes how a single format imports to / exports from the squisq model. */
 interface FormatDefinition {
     id: FormatId;
@@ -192,6 +204,8 @@ declare function defaultFormats(): FormatDefinition[];
  * an optional transform, then hands off to the target format's exporter.
  */
 
+/** Normalize and transform a source once, then safely export that snapshot many times. */
+declare function prepareConversion(source: ConvertSource, options?: ConvertOptions): Promise<PreparedConversion>;
 /**
  * Convert a source document to a target format.
  *
@@ -202,4 +216,4 @@ declare function defaultFormats(): FormatDefinition[];
  */
 declare function convert(source: ConvertSource, to: FormatId, options?: ConvertOptions): Promise<ConversionResult>;
 
-export { BUILTIN_FORMAT_IDS, type BuiltinFormatOptions, ConversionError, type ConversionErrorCode, type ConversionErrorOptions, type ConversionResult, type ConvertOptions, type ConvertSource, type DbkFormatOptions, type FormatDefinition, type FormatId, type FormatRegistry, type MarkdownFormatOptions, type NormalizedInput, convert, createRegistry, defaultFormats, defaultRegistry };
+export { BUILTIN_FORMAT_IDS, type BuiltinFormatOptions, ConversionError, type ConversionErrorCode, type ConversionErrorOptions, type ConversionResult, type ConvertOptions, type ConvertSource, type DbkFormatOptions, type FormatDefinition, type FormatId, type FormatRegistry, type MarkdownFormatOptions, type NormalizedInput, type PreparedConversion, type PreparedExportOptions, convert, createRegistry, defaultFormats, defaultRegistry, prepareConversion };

package/dist/registry/index.js

@@ -3,18 +3,20 @@ import {
   convert,
   createRegistry,
   defaultFormats,
-  defaultRegistry
-} from "../chunk-2EFDWKC6.js";
+  defaultRegistry,
+  prepareConversion
+} from "../chunk-WQSHGBLN.js";
 import {
   ConversionError
 } from "../chunk-ODL3SSPT.js";
-import "../chunk-H7T5DXUU.js";
+import "../chunk-FE6OJV6O.js";
 export {
   BUILTIN_FORMAT_IDS,
   ConversionError,
   convert,
   createRegistry,
   defaultFormats,
-  defaultRegistry
+  defaultRegistry,
+  prepareConversion
 };
 //# sourceMappingURL=index.js.map

package/dist/{themeReader-DPw4J5Ss.d.ts → themeReader-DJKErl_j.d.ts}

@@ -1,4 +1,4 @@
-import { a as OoxmlPackage } from './reader-Gof6OrJX.js';
+import { a as OoxmlPackage } from './reader-B9L8Ucbj.js';
 
 /**
  * OOXML theme reader — parses a `theme1.xml` part (DrawingML `a:theme`)

package/dist/xlsx/index.d.ts

@@ -1,9 +1,9 @@
 import { Doc } from '@bendyline/squisq/schemas';
-import { a as XlsxImportOptions } from '../export-Djev9BLU.js';
-export { X as XlsxExportOptions, d as docToXlsx, m as markdownDocToXlsx, x as xlsxToMarkdownDoc } from '../export-Djev9BLU.js';
+import { a as XlsxImportOptions } from '../export-D2NkylDT.js';
+export { X as XlsxExportOptions, d as docToXlsx, m as markdownDocToXlsx, x as xlsxToMarkdownDoc } from '../export-D2NkylDT.js';
 import '@bendyline/squisq/markdown';
-import '../reader-Gof6OrJX.js';
-import '../zipLimits-bGYMS9cI.js';
+import '../reader-B9L8Ucbj.js';
+import '../zipLimits-BOKCB7qk.js';
 
 /**
  * @bendyline/squisq-formats XLSX Module

package/dist/xlsx/index.js

@@ -3,12 +3,12 @@ import {
   markdownDocToXlsx,
   xlsxToDoc,
   xlsxToMarkdownDoc
-} from "../chunk-HBSCRS5P.js";
+} from "../chunk-UGYF5AZE.js";
 import "../chunk-PN52A5AA.js";
-import "../chunk-XTLQXR4U.js";
+import "../chunk-KURGXM4I.js";
 import "../chunk-U4MRIFKL.js";
-import "../chunk-4HJ6AK2Q.js";
-import "../chunk-H7T5DXUU.js";
+import "../chunk-7ARKUCQT.js";
+import "../chunk-FE6OJV6O.js";
 export {
   docToXlsx,
   markdownDocToXlsx,

package/dist/{zipLimits-bGYMS9cI.d.ts → zipLimits-BOKCB7qk.d.ts}

@@ -1,6 +1,8 @@
 /** ZIP safety policy, structured errors, path checks, and metadata validation. */
 
 interface ZipSafetyLimits {
+    /** Cooperatively cancel archive opening, validation, and member traversal. */
+    signal?: AbortSignal;
     /** Maximum number of archive records, including directories. Default: 10,000. */
     maxEntries?: number;
     /** Maximum uncompressed bytes for one member. Defaults to maxUncompressedBytes. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-formats",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Document format converters — DOCX, PDF, OOXML import/export",
   "license": "MIT",
   "author": "Bendyline",
@@ -100,7 +100,7 @@
   },
   "dependencies": {
     "@xmldom/xmldom": "0.9.10",
-    "@bendyline/squisq": "2.0.0",
+    "@bendyline/squisq": "2.1.0",
     "jszip": "3.10.1",
     "pdf-lib": "1.17.1",
     "pdfjs-dist": "4.10.38"