@bendyline/squisq-formats 1.4.2 → 2.0.1

package/dist/chunk-XKUMNGBW.js

@@ -0,0 +1,131 @@
+import {
+  baseDirOf,
+  findRelByType,
+  resolveTarget
+} from "./chunk-YRT7GQ5Y.js";
+import {
+  NS_DRAWINGML,
+  REL_THEME,
+  getPartRelationships,
+  getPartXml
+} from "./chunk-WC7WULGV.js";
+
+// src/ooxml/themeReader.ts
+var HEX6_RE = /^[0-9a-fA-F]{6}$/;
+var SYS_COLOR_DEFAULTS = {
+  windowText: "000000",
+  window: "ffffff"
+};
+function resolveSchemeColor(slot) {
+  for (let i = 0; i < slot.childNodes.length; i++) {
+    const child = slot.childNodes[i];
+    if (!child || child.nodeType !== 1) continue;
+    const el = child;
+    if (el.localName === "srgbClr") {
+      const val = el.getAttribute("val");
+      return val && HEX6_RE.test(val) ? `#${val.toLowerCase()}` : null;
+    }
+    if (el.localName === "sysClr") {
+      const lastClr = el.getAttribute("lastClr");
+      if (lastClr && HEX6_RE.test(lastClr)) return `#${lastClr.toLowerCase()}`;
+      const val = el.getAttribute("val");
+      const known = val ? SYS_COLOR_DEFAULTS[val] : void 0;
+      return known ? `#${known}` : null;
+    }
+    return null;
+  }
+  return null;
+}
+function firstNS(parent, local) {
+  const els = parent.getElementsByTagNameNS(NS_DRAWINGML, local);
+  return els.length > 0 ? els[0] : null;
+}
+function parseColorScheme(clrScheme, warnings) {
+  const resolve = (slotName) => {
+    const slot = firstNS(clrScheme, slotName);
+    if (!slot) return null;
+    return resolveSchemeColor(slot);
+  };
+  const dk1 = resolve("dk1");
+  const lt1 = resolve("lt1");
+  if (!dk1) warnings.push("theme: dk1 color could not be resolved; using #000000");
+  if (!lt1) warnings.push("theme: lt1 color could not be resolved; using #ffffff");
+  const dk2 = resolve("dk2");
+  const lt2 = resolve("lt2");
+  const colors = {
+    dk1: dk1 ?? "#000000",
+    lt1: lt1 ?? "#ffffff",
+    dk2: dk2 ?? dk1 ?? "#000000",
+    lt2: lt2 ?? lt1 ?? "#ffffff"
+  };
+  for (const slot of ["accent1", "accent2", "accent3", "accent4", "accent5", "accent6"]) {
+    const hex = resolve(slot);
+    if (hex) colors[slot] = hex;
+    else warnings.push(`theme: ${slot} color could not be resolved; dropped`);
+  }
+  for (const slot of ["hlink", "folHlink"]) {
+    const hex = resolve(slot);
+    if (hex) colors[slot] = hex;
+  }
+  return colors;
+}
+function parseFontScheme(fontScheme, warnings) {
+  const readLatin = (fontName) => {
+    const font = firstNS(fontScheme, fontName);
+    if (!font) return void 0;
+    const latin = firstNS(font, "latin");
+    const typeface = latin?.getAttribute("typeface")?.trim();
+    if (!typeface) {
+      warnings.push(`theme: ${fontName} has no latin typeface`);
+      return void 0;
+    }
+    return typeface;
+  };
+  const majorLatin = readLatin("majorFont");
+  const minorLatin = readLatin("minorFont");
+  if (!majorLatin && !minorLatin) return void 0;
+  return {
+    ...majorLatin ? { majorLatin } : {},
+    ...minorLatin ? { minorLatin } : {}
+  };
+}
+function parseThemeXml(themeDoc) {
+  const warnings = [];
+  const root = firstNS(themeDoc, "theme");
+  const name = root?.getAttribute("name")?.trim() || void 0;
+  const clrScheme = firstNS(themeDoc, "clrScheme");
+  let colors;
+  if (clrScheme) {
+    colors = parseColorScheme(clrScheme, warnings);
+  } else {
+    warnings.push("theme: no clrScheme found");
+  }
+  const fontScheme = firstNS(themeDoc, "fontScheme");
+  let fonts;
+  if (fontScheme) {
+    fonts = parseFontScheme(fontScheme, warnings);
+  } else {
+    warnings.push("theme: no fontScheme found");
+  }
+  return {
+    ...name ? { name } : {},
+    ...colors ? { colors } : {},
+    ...fonts ? { fonts } : {},
+    warnings
+  };
+}
+async function readThemePart(pkg, fromPartPath) {
+  const rels = await getPartRelationships(pkg, fromPartPath);
+  const rel = findRelByType(rels, REL_THEME);
+  if (!rel) return null;
+  const themePath = resolveTarget(baseDirOf(fromPartPath), rel.target);
+  const doc = await getPartXml(pkg, themePath);
+  if (!doc) return null;
+  return parseThemeXml(doc);
+}
+
+export {
+  parseThemeXml,
+  readThemePart
+};
+//# sourceMappingURL=chunk-XKUMNGBW.js.map

package/dist/chunk-XKUMNGBW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ooxml/themeReader.ts"],"sourcesContent":["/**\n * OOXML theme reader — parses a `theme1.xml` part (DrawingML `a:theme`)\n * into normalized color and font schemes.\n *\n * Shared by DOCX/PPTX/XLSX theme inference: all three formats carry the same\n * theme part shape, differing only in where the part hangs (document/master/\n * workbook relationships). This module never fails hard — unreadable slots\n * degrade to fallbacks or absence, with a warning per degradation.\n */\n\nimport type { OoxmlPackage } from './types.js';\nimport { getPartRelationships, getPartXml } from './reader.js';\nimport { NS_DRAWINGML, REL_THEME } from './namespaces.js';\nimport { baseDirOf, findRelByType, resolveTarget } from './readUtils.js';\n\n/**\n * The clrScheme slots as normalized `#rrggbb` strings. The four surface/text\n * slots always resolve (falling back to black/white when degraded); accent and\n * hyperlink slots are omitted when unresolvable.\n */\nexport interface OoxmlColorScheme {\n  dk1: string;\n  lt1: string;\n  dk2: string;\n  lt2: string;\n  accent1?: string;\n  accent2?: string;\n  accent3?: string;\n  accent4?: string;\n  accent5?: string;\n  accent6?: string;\n  hlink?: string;\n  folHlink?: string;\n}\n\nexport interface OoxmlFontScheme {\n  /** `a:fontScheme > a:majorFont > a:latin@typeface` (headings). */\n  majorLatin?: string;\n  /** `a:fontScheme > a:minorFont > a:latin@typeface` (body). */\n  minorLatin?: string;\n}\n\nexport interface OoxmlTheme {\n  /** `a:theme@name` (e.g. \"Office Theme\", \"Ion\"). */\n  name?: string;\n  /** Absent when the theme carries no parseable `a:clrScheme`. */\n  colors?: OoxmlColorScheme;\n  /** Absent when the theme carries no `a:fontScheme` latin typefaces. */\n  fonts?: OoxmlFontScheme;\n  warnings: string[];\n}\n\nconst HEX6_RE = /^[0-9a-fA-F]{6}$/;\n\n/** Well-known sysClr values that resolve without a `lastClr` hint. */\nconst SYS_COLOR_DEFAULTS: Record<string, string> = {\n  windowText: '000000',\n  window: 'ffffff',\n};\n\n/**\n * Resolve one clrScheme slot element to a `#rrggbb` string, or null.\n * Only the base color matters for theming — trailing transform children\n * (`a:lumMod`, `a:tint`, …) are ignored.\n */\nfunction resolveSchemeColor(slot: Element): string | null {\n  for (let i = 0; i < slot.childNodes.length; i++) {\n    const child = slot.childNodes[i];\n    if (!child || child.nodeType !== 1) continue;\n    const el = child as Element;\n    if (el.localName === 'srgbClr') {\n      const val = el.getAttribute('val');\n      return val && HEX6_RE.test(val) ? `#${val.toLowerCase()}` : null;\n    }\n    if (el.localName === 'sysClr') {\n      const lastClr = el.getAttribute('lastClr');\n      if (lastClr && HEX6_RE.test(lastClr)) return `#${lastClr.toLowerCase()}`;\n      const val = el.getAttribute('val');\n      const known = val ? SYS_COLOR_DEFAULTS[val] : undefined;\n      return known ? `#${known}` : null;\n    }\n    // Any other color form (schemeClr self-reference, prstClr, …) is\n    // unresolvable without a full DrawingML color pipeline.\n    return null;\n  }\n  return null;\n}\n\nfunction firstNS(parent: Element | Document, local: string): Element | null {\n  const els = parent.getElementsByTagNameNS(NS_DRAWINGML, local);\n  return els.length > 0 ? els[0]! : null;\n}\n\nfunction parseColorScheme(clrScheme: Element, warnings: string[]): OoxmlColorScheme {\n  const resolve = (slotName: string): string | null => {\n    const slot = firstNS(clrScheme, slotName);\n    if (!slot) return null;\n    return resolveSchemeColor(slot);\n  };\n\n  const dk1 = resolve('dk1');\n  const lt1 = resolve('lt1');\n  if (!dk1) warnings.push('theme: dk1 color could not be resolved; using #000000');\n  if (!lt1) warnings.push('theme: lt1 color could not be resolved; using #ffffff');\n\n  const dk2 = resolve('dk2');\n  const lt2 = resolve('lt2');\n\n  const colors: OoxmlColorScheme = {\n    dk1: dk1 ?? '#000000',\n    lt1: lt1 ?? '#ffffff',\n    dk2: dk2 ?? dk1 ?? '#000000',\n    lt2: lt2 ?? lt1 ?? '#ffffff',\n  };\n\n  for (const slot of ['accent1', 'accent2', 'accent3', 'accent4', 'accent5', 'accent6'] as const) {\n    const hex = resolve(slot);\n    if (hex) colors[slot] = hex;\n    else warnings.push(`theme: ${slot} color could not be resolved; dropped`);\n  }\n  for (const slot of ['hlink', 'folHlink'] as const) {\n    const hex = resolve(slot);\n    if (hex) colors[slot] = hex;\n  }\n  return colors;\n}\n\nfunction parseFontScheme(fontScheme: Element, warnings: string[]): OoxmlFontScheme | undefined {\n  const readLatin = (fontName: 'majorFont' | 'minorFont'): string | undefined => {\n    const font = firstNS(fontScheme, fontName);\n    if (!font) return undefined;\n    const latin = firstNS(font, 'latin');\n    const typeface = latin?.getAttribute('typeface')?.trim();\n    if (!typeface) {\n      warnings.push(`theme: ${fontName} has no latin typeface`);\n      return undefined;\n    }\n    return typeface;\n  };\n\n  const majorLatin = readLatin('majorFont');\n  const minorLatin = readLatin('minorFont');\n  if (!majorLatin && !minorLatin) return undefined;\n  return {\n    ...(majorLatin ? { majorLatin } : {}),\n    ...(minorLatin ? { minorLatin } : {}),\n  };\n}\n\n/** Parse an already-loaded theme part Document. */\nexport function parseThemeXml(themeDoc: Document): OoxmlTheme {\n  const warnings: string[] = [];\n\n  const root = firstNS(themeDoc, 'theme');\n  const name = root?.getAttribute('name')?.trim() || undefined;\n\n  const clrScheme = firstNS(themeDoc, 'clrScheme');\n  let colors: OoxmlColorScheme | undefined;\n  if (clrScheme) {\n    colors = parseColorScheme(clrScheme, warnings);\n  } else {\n    warnings.push('theme: no clrScheme found');\n  }\n\n  const fontScheme = firstNS(themeDoc, 'fontScheme');\n  let fonts: OoxmlFontScheme | undefined;\n  if (fontScheme) {\n    fonts = parseFontScheme(fontScheme, warnings);\n  } else {\n    warnings.push('theme: no fontScheme found');\n  }\n\n  return {\n    ...(name ? { name } : {}),\n    ...(colors ? { colors } : {}),\n    ...(fonts ? { fonts } : {}),\n    warnings,\n  };\n}\n\n/**\n * Resolve the theme part related from `fromPartPath` (via `REL_THEME`) and\n * parse it. Returns null when the part has no theme relationship or the\n * target part is missing — callers decide whether that's an error.\n */\nexport async function readThemePart(\n  pkg: OoxmlPackage,\n  fromPartPath: string,\n): Promise<OoxmlTheme | null> {\n  const rels = await getPartRelationships(pkg, fromPartPath);\n  const rel = findRelByType(rels, REL_THEME);\n  if (!rel) return null;\n  const themePath = resolveTarget(baseDirOf(fromPartPath), rel.target);\n  const doc = await getPartXml(pkg, themePath);\n  if (!doc) return null;\n  return parseThemeXml(doc);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-YRT7GQ5Y.js

@@ -0,0 +1,28 @@
+// src/ooxml/readUtils.ts
+function attrNS(el, ns, local, qualified) {
+  return el.getAttributeNS(ns, local) ?? el.getAttribute(qualified);
+}
+function baseDirOf(path) {
+  const slash = path.lastIndexOf("/");
+  return slash === -1 ? "" : path.slice(0, slash);
+}
+function resolveTarget(baseDir, target) {
+  if (target.startsWith("/")) return target.replace(/^\//, "");
+  const stack = baseDir ? baseDir.split("/") : [];
+  for (const seg of target.split("/")) {
+    if (seg === "..") stack.pop();
+    else if (seg !== ".") stack.push(seg);
+  }
+  return stack.join("/");
+}
+function findRelByType(rels, type) {
+  return rels.find((r) => r.type === type);
+}
+
+export {
+  attrNS,
+  baseDirOf,
+  resolveTarget,
+  findRelByType
+};
+//# sourceMappingURL=chunk-YRT7GQ5Y.js.map

package/dist/chunk-YRT7GQ5Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ooxml/readUtils.ts"],"sourcesContent":["/**\n * Shared DOM-read helpers for OOXML importers.\n *\n * Every importer walks parts with `getElementsByTagNameNS` and resolves\n * relationship targets relative to the referencing part; these helpers hold\n * the common pieces so new readers (theme, slide layouts) don't re-implement\n * them per format.\n */\n\nimport type { Relationship } from './types.js';\n\n/**\n * Read a namespaced attribute with a qualified-name fallback for documents\n * whose producer omitted the namespace declaration (e.g. `r:id`).\n */\nexport function attrNS(el: Element, ns: string, local: string, qualified: string): string | null {\n  return el.getAttributeNS(ns, local) ?? el.getAttribute(qualified);\n}\n\n/** Directory portion of a part path, e.g. `ppt/slides/slide1.xml` → `ppt/slides`. */\nexport function baseDirOf(path: string): string {\n  const slash = path.lastIndexOf('/');\n  return slash === -1 ? '' : path.slice(0, slash);\n}\n\n/**\n * Resolve a relationship target against the referencing part's directory.\n * Absolute targets (leading `/`) are package-rooted; relative targets may\n * climb with `..` segments (e.g. `../slideLayouts/slideLayout1.xml`).\n */\nexport function resolveTarget(baseDir: string, target: string): string {\n  if (target.startsWith('/')) return target.replace(/^\\//, '');\n  const stack = baseDir ? baseDir.split('/') : [];\n  for (const seg of target.split('/')) {\n    if (seg === '..') stack.pop();\n    else if (seg !== '.') stack.push(seg);\n  }\n  return stack.join('/');\n}\n\n/** First relationship of the given type, if any. */\nexport function findRelByType(rels: Relationship[], type: string): Relationship | undefined {\n  return rels.find((r) => r.type === type);\n}\n"],"mappings":";AAeO,SAAS,OAAO,IAAa,IAAY,OAAe,WAAkC;AAC/F,SAAO,GAAG,eAAe,IAAI,KAAK,KAAK,GAAG,aAAa,SAAS;AAClE;AAGO,SAAS,UAAU,MAAsB;AAC9C,QAAM,QAAQ,KAAK,YAAY,GAAG;AAClC,SAAO,UAAU,KAAK,KAAK,KAAK,MAAM,GAAG,KAAK;AAChD;AAOO,SAAS,cAAc,SAAiB,QAAwB;AACrE,MAAI,OAAO,WAAW,GAAG,EAAG,QAAO,OAAO,QAAQ,OAAO,EAAE;AAC3D,QAAM,QAAQ,UAAU,QAAQ,MAAM,GAAG,IAAI,CAAC;AAC9C,aAAW,OAAO,OAAO,MAAM,GAAG,GAAG;AACnC,QAAI,QAAQ,KAAM,OAAM,IAAI;AAAA,aACnB,QAAQ,IAAK,OAAM,KAAK,GAAG;AAAA,EACtC;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;AAGO,SAAS,cAAc,MAAsB,MAAwC;AAC1F,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AACzC;","names":[]}

package/dist/container/index.d.ts

@@ -1,4 +1,6 @@
 import { ContentContainer, MemoryContentContainer } from '@bendyline/squisq/storage';
+import { c as ZipSafetyLimits } from '../zipLimits-BOKCB7qk.js';
+export { Z as ZipSafetyError, a as ZipSafetyErrorCode, b as ZipSafetyErrorOptions } from '../zipLimits-BOKCB7qk.js';
 
 /**
  * Container ZIP serialization — convert between ContentContainer and ZIP archives.
@@ -13,6 +15,14 @@ import { ContentContainer, MemoryContentContainer } from '@bendyline/squisq/stor
  *   timing.json
  */
 
+type ZipToContainerOptions = ZipSafetyLimits;
+interface ContainerToZipOptions {
+    /** STORE avoids producing archives that violate strict import compression-ratio policies. */
+    compression?: 'STORE' | 'DEFLATE';
+    /** JSZip DEFLATE level; ignored for STORE. */
+    compressionLevel?: number;
+}
+
 /**
  * Serialize a ContentContainer to a ZIP blob.
  *
@@ -22,7 +32,7 @@ import { ContentContainer, MemoryContentContainer } from '@bendyline/squisq/stor
  * @param container — The container to serialize
  * @returns A Blob containing the ZIP archive
  */
-declare function containerToZip(container: ContentContainer): Promise<Blob>;
+declare function containerToZip(container: ContentContainer, options?: ContainerToZipOptions): Promise<Blob>;
 /**
  * Deserialize a ZIP archive into a MemoryContentContainer.
  *
@@ -33,6 +43,6 @@ declare function containerToZip(container: ContentContainer): Promise<Blob>;
  * @param zipData — The ZIP archive as ArrayBuffer, Uint8Array, or Blob
  * @returns A MemoryContentContainer populated with the ZIP's contents
  */
-declare function zipToContainer(zipData: ArrayBuffer | Uint8Array | Blob): Promise<MemoryContentContainer>;
+declare function zipToContainer(zipData: ArrayBuffer | Uint8Array | Blob, options?: ZipToContainerOptions): Promise<MemoryContentContainer>;
 
-export { containerToZip, zipToContainer };
+export { type ContainerToZipOptions, ZipSafetyLimits, type ZipToContainerOptions, containerToZip, zipToContainer };

package/dist/container/index.js

@@ -1,42 +1,45 @@
+import {
+  ZipSafetyError,
+  assertSafeZipPath,
+  openBoundedZipArchive
+} 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) {
+    assertSafeZipPath(entry.path);
     const data = await container.readFile(entry.path);
     if (data) {
       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) {
-  const zip = await JSZip.loadAsync(zipData);
+async function zipToContainer(zipData, options = {}) {
+  const archive = await openBoundedZipArchive(zipData, options);
   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);
+  for (const { path } of archive.entries) {
+    const data = await archive.read(path);
+    if (data) await container.writeFile(path, data);
+    archive.release(path);
+  }
   return container;
 }
 export {
+  ZipSafetyError,
   containerToZip,
   zipToContainer
 };

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';\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":[]}
+{"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,6 +1,8 @@
-import { Doc } from '@bendyline/squisq/schemas';
+import { ThemeRegistry, Doc } from '@bendyline/squisq/schemas';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
+import { O as OoxmlOpenOptions } from '../reader-B9L8Ucbj.js';
 import { ContentContainer } from '@bendyline/squisq/storage';
+import '../zipLimits-BOKCB7qk.js';
 
 /**
  * DOCX Export
@@ -41,6 +43,8 @@ interface DocxExportOptions {
      * the theme's primary color to headings.
      */
     themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
     /**
      * 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
@@ -94,7 +98,7 @@ declare function docToDocx(doc: Doc, options?: DocxExportOptions): Promise<Array
 /**
  * Options for DOCX import.
  */
-interface DocxImportOptions {
+interface DocxImportOptions extends OoxmlOpenOptions {
     /**
      * Whether to extract embedded images as base64 data URIs.
      * When false, images are represented as `[Image]` placeholders.

package/dist/docx/index.js

@@ -4,13 +4,15 @@ import {
   docxToDoc,
   docxToMarkdownDoc,
   markdownDocToDocx
-} from "../chunk-WWBIKRNP.js";
+} from "../chunk-CRAVSMPZ.js";
 import "../chunk-6M7Z25LA.js";
 import "../chunk-PN52A5AA.js";
-import "../chunk-SHLPSADL.js";
+import "../chunk-U32AG3G3.js";
 import "../chunk-U4MRIFKL.js";
+import "../chunk-WC7WULGV.js";
+import "../chunk-FE6OJV6O.js";
 import "../chunk-SSUPBUF5.js";
-import "../chunk-DQAZR57U.js";
+import "../chunk-O3GVVND4.js";
 export {
   docToDocx,
   docxToContainer,

package/dist/epub/index.d.ts

@@ -1,4 +1,4 @@
-import { AudioSegment, Doc } from '@bendyline/squisq/schemas';
+import { ThemeRegistry, AudioSegment, Doc } from '@bendyline/squisq/schemas';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
 
 /**
@@ -37,6 +37,8 @@ interface EpubExportOptions {
     publisher?: string;
     /** Squisq theme ID for CSS styling */
     themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
     /** Pre-resolved image data keyed by relative path as it appears in the markdown */
     images?: Map<string, ArrayBuffer>;
     /** Cover image data (JPEG or PNG) */

package/dist/epub/index.js

@@ -1,11 +1,11 @@
 import {
   docToEpub,
   markdownDocToEpub
-} from "../chunk-5LSSWZPU.js";
+} from "../chunk-4VUWTSGM.js";
 import "../chunk-PN52A5AA.js";
 import "../chunk-U4MRIFKL.js";
-import "../chunk-MJGRI6XR.js";
-import "../chunk-DQAZR57U.js";
+import "../chunk-MLX2BOJC.js";
+import "../chunk-O3GVVND4.js";
 export {
   docToEpub,
   markdownDocToEpub

package/dist/export-D2NkylDT.d.ts

@@ -0,0 +1,69 @@
+import { MarkdownDocument } from '@bendyline/squisq/markdown';
+import { O as OoxmlOpenOptions } from './reader-B9L8Ucbj.js';
+import { Doc } from '@bendyline/squisq/schemas';
+
+/**
+ * XLSX import — SpreadsheetML (.xlsx) → MarkdownDocument.
+ *
+ * Reuses the shared ooxml/ reader (zip + DOMParser). Reads the workbook's
+ * sheet list, resolves each sheet part via relationships, pulls shared strings,
+ * and turns each worksheet's cell grid into a markdown table (first row treated
+ * as the header). By default every sheet is imported, each preceded by an H1 of
+ * the sheet name; pass `options.sheet` (index or name) to import just one.
+ */
+
+interface XlsxImportOptions extends OoxmlOpenOptions {
+    /** Which sheet to import (0-based index or sheet name). Default: all sheets. */
+    sheet?: number | string;
+}
+declare function xlsxToMarkdownDoc(data: ArrayBuffer | Blob, options?: XlsxImportOptions): Promise<MarkdownDocument>;
+
+/**
+ * XLSX export — MarkdownDocument → SpreadsheetML (.xlsx).
+ *
+ * Tables-only fidelity (honestly documented): every `table` node in the
+ * markdown AST becomes one worksheet; all other content (headings, prose,
+ * lists, images, …) is dropped except that the nearest preceding heading is
+ * used to name the sheet. This mirrors the import side (`xlsxToMarkdownDoc`),
+ * which turns each worksheet grid back into a markdown table.
+ *
+ * Cells are emitted as inline strings (`t="inlineStr"`) so no sharedStrings
+ * part is needed, except values matching a plain-number pattern, which are
+ * emitted as numeric cells. The package is assembled with the shared ooxml/
+ * writer (auto-generates `[Content_Types].xml` + `_rels`), so only the
+ * SpreadsheetML-specific parts (workbook, worksheets, styles) are written here.
+ *
+ * @example
+ * ```ts
+ * import { parseMarkdown } from '@bendyline/squisq/markdown';
+ * import { markdownDocToXlsx } from '@bendyline/squisq-formats/xlsx';
+ *
+ * const md = parseMarkdown('# Metrics\n\n| A | B |\n| - | - |\n| 1 | 2 |');
+ * const buffer = await markdownDocToXlsx(md);
+ * ```
+ */
+
+/**
+ * Options for XLSX export.
+ */
+interface XlsxExportOptions {
+    /** Workbook title (written to core properties). */
+    title?: string;
+    /** Workbook author (written to core properties). */
+    author?: string;
+    /** Prefix used for auto-named sheets when no heading precedes a table. Default: "Sheet". */
+    sheetNamePrefix?: string;
+}
+/**
+ * Convert a MarkdownDocument to a .xlsx file (tables-only fidelity).
+ *
+ * Each markdown `table` becomes one worksheet; a document with no tables
+ * yields a single empty sheet (a valid, openable file — never throws).
+ */
+declare function markdownDocToXlsx(doc: MarkdownDocument, options?: XlsxExportOptions): Promise<ArrayBuffer>;
+/**
+ * Convert a squisq Doc to a .xlsx file (via the markdown table model).
+ */
+declare function docToXlsx(doc: Doc, options?: XlsxExportOptions): Promise<ArrayBuffer>;
+
+export { type XlsxExportOptions as X, type XlsxImportOptions as a, docToXlsx as d, markdownDocToXlsx as m, xlsxToMarkdownDoc as x };

package/dist/extract-H6RXJMHP.js

@@ -0,0 +1,15 @@
+import {
+  extractDocxTheme,
+  extractPptxTheme,
+  extractXlsxTheme
+} from "./chunk-2KPARF2P.js";
+import "./chunk-XKUMNGBW.js";
+import "./chunk-YRT7GQ5Y.js";
+import "./chunk-WC7WULGV.js";
+import "./chunk-FE6OJV6O.js";
+export {
+  extractDocxTheme,
+  extractPptxTheme,
+  extractXlsxTheme
+};
+//# sourceMappingURL=extract-H6RXJMHP.js.map

package/dist/extract-H6RXJMHP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/html/index.d.ts

@@ -1,52 +1,8 @@
-import { Doc, Theme } from '@bendyline/squisq/schemas';
+import { Theme, ThemeRegistry, Doc } from '@bendyline/squisq/schemas';
+import { H as HtmlExportOptions } from '../import-DTkDxHmZ.js';
+export { a as HtmlImportOptions, c as collectImagePaths, h as htmlToMarkdown, b as htmlToMarkdownDoc, d as htmlToMarkdownDocSync } from '../import-DTkDxHmZ.js';
 import { HtmlPolicy, MarkdownDocument } from '@bendyline/squisq/markdown';
 
-/**
- * HTML Template Generation for SquisqPlayer Exports
- *
- * Generates complete, self-contained HTML documents that load the SquisqPlayer
- * IIFE bundle and render a Doc as either an interactive slideshow or a static
- * scrollable document.
- *
- * Two variants:
- * 1. **Inline** — All JS, CSS, and images are embedded in the HTML (single file).
- * 2. **External** — JS is referenced via `<script src>`, images via relative paths.
- */
-
-interface HtmlExportOptions {
-    /** The IIFE player bundle source code (from @bendyline/squisq-react/standalone-source) */
-    playerScript: string;
-    /**
-     * Map of relative image paths (as they appear in the Doc) to binary image data.
-     * For inline HTML export, these are converted to base64 data URIs.
-     * For ZIP export, these are written as separate files.
-     */
-    images?: Map<string, ArrayBuffer>;
-    /**
-     * Map of audio segment identifiers to binary audio data.
-     * Keys should match the audio segment `name` or `url` fields in the Doc.
-     * Only used in ZIP exports — single HTML uses timer-based playback.
-     */
-    audio?: Map<string, ArrayBuffer>;
-    /** Rendering mode: 'slideshow' (interactive, default) or 'static' (scrollable) */
-    mode?: 'slideshow' | 'static';
-    /** HTML page title (default: 'Squisq Document') */
-    title?: string;
-    /** Auto-play slideshow on load (default: false) */
-    autoPlay?: boolean;
-    /**
-     * Squisq theme ID to apply (e.g., 'documentary', 'cinematic').
-     * When set, the theme is assigned to the Doc before rendering,
-     * so the SquisqPlayer renders with that theme's colors and typography.
-     */
-    themeId?: string;
-}
-/**
- * Collect all relative image paths referenced in a Doc's layers and template blocks.
- * Returns a Set of unique relative paths that need to be resolved.
- */
-declare function collectImagePaths(doc: Doc): Set<string>;
-
 /**
  * Image Utilities for HTML Export
  *
@@ -134,6 +90,8 @@ interface PlainHtmlExportOptions {
      * When both `theme` and `themeId` are provided, `theme` wins.
      */
     themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
     /**
      * Optional FontAwesome CSS text to inline into the rendered page,
      * replacing the default cross-origin `<link>` to cdnjs. Required for
@@ -191,13 +149,14 @@ interface PlainHtmlBundleOptions {
     /** Optional theme applied uniformly to every page. Overrides {@link themeId}. */
     theme?: Theme;
     /**
-     * Optional theme id (e.g. `'warm-earth'`, `'gezellig'`). Resolved via
-     * `resolveTheme` and applied to every page. Convenient for callers
-     * that track themes by id (like the host export dialog) without
-     * having to resolve to a `Theme` object first. When both `theme` and
-     * `themeId` are supplied, `theme` wins.
+     * Optional theme id (e.g. `'warm-earth'`, `'gezellig'`) applied to every
+     * page. Each document resolves its own inline definition before consulting
+     * {@link themeRegistry}. When both `theme` and `themeId` are supplied,
+     * `theme` wins.
      */
     themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
     /** Maximum recursion depth (default: unlimited; cycles always handled). */
     maxDepth?: number;
     /**
@@ -242,6 +201,7 @@ declare function collectLinkRefs(doc: MarkdownDocument): Set<string>;
  * `<a href>` at runtime — there is no post-render link rewrite hook in
  * the player path.
  */
+
 interface HtmlBundleOptions {
     /** Entry document path relative to the container root (e.g. `'home.md'`). */
     entryPath: string;
@@ -255,6 +215,8 @@ interface HtmlBundleOptions {
     title?: string;
     /** Theme id applied uniformly to every page. */
     themeId?: string;
+    /** Explicit caller-owned registry for non-document custom themes. */
+    themeRegistry?: ThemeRegistry;
     /** Rendering mode for every page (default: 'static' — scrollable, link-friendly). */
     mode?: 'slideshow' | 'static';
     /** Maximum recursion depth (default: unlimited; cycles always handled). */
@@ -278,38 +240,6 @@ interface HtmlBundleOptions {
  */
 declare function markdownDocsToHtmlBundle(options: HtmlBundleOptions): Promise<Blob>;
 
-/**
- * HTML Import Module — @bendyline/squisq-formats/html
- *
- * Converts an HTML document (or fragment) into a squisq `MarkdownDocument`.
- * Built on the existing `parseHtmlToNodes` (parse5-backed) + `sanitizeHtmlNodes`
- * from `@bendyline/squisq/markdown`, so no new dependency is introduced.
- *
- * The primary consumer is email: HTML mail bodies are hostile input, so the
- * parse is sanitized by default (scripts/styles/event handlers/dangerous URLs
- * stripped) before the tree is walked into markdown nodes.
- *
- * Two entry points mirror the docx/pdf importers:
- *   - `htmlToMarkdownDoc(data, options?)` → `MarkdownDocument`
- *   - `htmlToMarkdown(html, options?)` → markdown string (convenience for the
- *     string-in/string-out path email body conversion needs)
- */
-
-interface HtmlImportOptions {
-    /**
-     * Strip scripts / styles / event handlers / dangerous URLs before walking
-     * the tree. Default `true` — HTML email is untrusted; only disable for
-     * trusted input where you want raw fidelity.
-     */
-    sanitize?: boolean;
-}
-/** Parse HTML into a squisq `MarkdownDocument`. */
-declare function htmlToMarkdownDocSync(html: string, options?: HtmlImportOptions): MarkdownDocument;
-/** Async, ArrayBuffer-accepting entry mirroring docx/pdf importers. */
-declare function htmlToMarkdownDoc(data: ArrayBuffer | Uint8Array | string, options?: HtmlImportOptions): Promise<MarkdownDocument>;
-/** Convenience string→string conversion (used for email HTML bodies). */
-declare function htmlToMarkdown(html: string, options?: HtmlImportOptions): string;
-
 /**
  * HTML Export Module — @bendyline/squisq-formats/html
  *
@@ -404,4 +334,4 @@ declare function docToHtml(doc: Doc, options: HtmlExportOptions): string;
  */
 declare function docToHtmlZip(doc: Doc, options: HtmlZipExportOptions): Promise<Blob>;
 
-export { type HtmlBundleOptions, type HtmlExportOptions, type HtmlImportOptions, type HtmlZipExportOptions, type PlainHtmlBundleOptions, type PlainHtmlExportOptions, arrayBufferToBase64DataUrl, collectImagePaths, collectLinkRefs, docToHtml, docToHtmlZip, extractFilename, htmlToMarkdown, htmlToMarkdownDoc, htmlToMarkdownDocSync, inferMimeType, markdownDocToPlainHtml, markdownDocsToHtmlBundle, markdownDocsToPlainHtmlBundle };
+export { type HtmlBundleOptions, HtmlExportOptions, type HtmlZipExportOptions, type PlainHtmlBundleOptions, type PlainHtmlExportOptions, arrayBufferToBase64DataUrl, collectLinkRefs, docToHtml, docToHtmlZip, extractFilename, inferMimeType, markdownDocToPlainHtml, markdownDocsToHtmlBundle, markdownDocsToPlainHtmlBundle };

package/dist/html/index.js

@@ -9,13 +9,13 @@ import {
   markdownDocToPlainHtml,
   markdownDocsToHtmlBundle,
   markdownDocsToPlainHtmlBundle
-} from "../chunk-46FMDOWZ.js";
+} from "../chunk-LXYLOOST.js";
 import {
   arrayBufferToBase64DataUrl,
   extractFilename,
   inferMimeType
-} from "../chunk-MJGRI6XR.js";
-import "../chunk-DQAZR57U.js";
+} from "../chunk-MLX2BOJC.js";
+import "../chunk-O3GVVND4.js";
 export {
   arrayBufferToBase64DataUrl,
   collectImagePaths,