@bendyline/squisq-formats 2.8.8 → 2.8.9

package/dist/{chunk-LK4KCVN6.js → chunk-SZ3OIY6G.js}

@@ -1,3 +1,7 @@
+import {
+  findDiagrams,
+  rasterizeDiagrams
+} from "./chunk-4LIFEQKX.js";
 import {
   arrayBufferToBase64DataUrl,
   extractFilename,
@@ -8,8 +12,9 @@ import {
 } from "./chunk-VCZUXQUL.js";
 import {
   FootnoteIndex,
-  footnoteIds
-} from "./chunk-BXWNU4T5.js";
+  footnoteIds,
+  withoutBlockTags
+} from "./chunk-DTJQK7U7.js";
 import {
   imageSizeAttributes
 } from "./chunk-JZR32FON.js";
@@ -294,7 +299,9 @@ function escapeHtml(str) {
 import {
   findBlockVideoEmbed,
   isSvgIslandLang,
+  mediaKindForUrl,
   parseSvgIsland,
+  parseTimeSeconds,
   sanitizeHtmlNodes,
   svgIslandDataUrl,
   svgSourceFromDataUrl,
@@ -304,7 +311,11 @@ import {
   readFrontmatterThemeId as readFrontmatterThemeId2
 } from "@bendyline/squisq/markdown";
 import { resolveFontFamily, buildGoogleFontsUrl } from "@bendyline/squisq/schemas";
-import { resolveThemeForDoc } from "@bendyline/squisq/doc";
+import {
+  isMediaAnnotationName,
+  parseStandaloneAnnotation,
+  resolveThemeForDoc
+} from "@bendyline/squisq/doc";
 function markdownDocToPlainHtml(doc, options = {}) {
   const { title, body, fontsLink, iconsLink, themedCss, featureCss } = renderPlainHtml(
     doc,
@@ -347,7 +358,8 @@ function renderPlainHtml(doc, options) {
     iconsCss,
     htmlPolicy = "sanitize",
     externalResources = "deny",
-    videoEmbeds
+    videoEmbeds,
+    icons
   } = options;
   const resolveId = themeId ?? readFrontmatterThemeId2(doc.frontmatter);
   const theme = options.theme ?? (resolveId ? resolveThemeForDoc(doc, resolveId, options.themeRegistry) : void 0);
@@ -358,13 +370,14 @@ function renderPlainHtml(doc, options) {
     htmlPolicy,
     footnotes,
     videoEmbeds,
+    icons,
     textColor: theme?.colors.text
   };
-  const body = renderTopLevel(doc.children, ctx) + renderFootnotesSection(footnotes, ctx);
+  const blocks = withoutBlockTags(doc, { keepMedia: true }).children;
+  const body = renderTopLevel(blocks, ctx) + renderFootnotesSection(footnotes, ctx);
   const fontsLink = theme && externalResources === "allow" ? renderFontsLink(theme) : "";
-  const usesIcons = docUsesIcons(doc);
   let iconsLink = "";
-  if (usesIcons) {
+  if (ctx.usesFontIcons) {
     iconsLink = iconsCss ? `<style data-fa-inline>
 ${escapeStyleText(iconsCss)}
 </style>
@@ -375,13 +388,17 @@ ${escapeStyleText(iconsCss)}
 ${VIDEO_EMBED_CSS}` : "";
   const svgCss = docUsesSvgIslands(doc) ? `
 ${SVG_ISLAND_CSS}` : "";
+  const mediaCss = ctx.usesMediaPlayers ? `
+${MEDIA_PLAYER_CSS}` : "";
+  const iconCss = ctx.usesSvgIcons ? `
+${SVG_ICON_CSS}` : "";
   return {
     title,
     body,
     fontsLink,
     iconsLink,
     themedCss,
-    featureCss: `${FEATURE_CSS}${videoCss}${svgCss}`
+    featureCss: `${FEATURE_CSS}${videoCss}${svgCss}${mediaCss}${iconCss}`
   };
 }
 function escapeStyleText(css) {
@@ -389,18 +406,7 @@ function escapeStyleText(css) {
 }
 var FONT_AWESOME_LINK = `<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.3.1/css/all.min.css" crossorigin="anonymous" referrerpolicy="no-referrer">
 `;
-function docUsesIcons(doc) {
-  function visit(node) {
-    if (!node || typeof node !== "object") return false;
-    const n = node;
-    if (n.type === "inlineIcon") return true;
-    if (Array.isArray(n.children)) {
-      for (const child of n.children) if (visit(child)) return true;
-    }
-    return false;
-  }
-  return visit(doc);
-}
+var SVG_ICON_CSS = `  .squisq-icon { display: inline-block; height: 1em; vertical-align: -0.125em; overflow: visible; }`;
 function docUsesVideoEmbeds(doc, htmlPolicy) {
   const iframeIn = (nodes) => nodes.some(
     (node) => node.type === "htmlElement" && (videoEmbedFromIframe(node) !== null || iframeIn(node.children))
@@ -441,15 +447,21 @@ function renderTopLevel(children, ctx) {
         continue;
       }
     }
-    const video = node && node.type === "paragraph" ? findBlockVideoEmbed(node) : null;
-    if (video) {
-      out.push(videoEmbedToHtml(video.embed, video.title, ctx));
-      continue;
-    }
-    out.push(nodeToHtml(node, ctx));
+    const html = topLevelBlockToHtml(node, ctx);
+    if (html !== null) out.push(html);
   }
   return out.join("\n");
 }
+function topLevelBlockToHtml(node, ctx) {
+  if (node?.type !== "paragraph") return nodeToHtml(node, ctx);
+  const video = findBlockVideoEmbed(node);
+  if (video) return videoEmbedToHtml(video.embed, video.title, ctx);
+  const tag = parseStandaloneAnnotation(node);
+  if (tag?.template && isMediaAnnotationName(tag.template)) {
+    return mediaAnnotationToHtml(tag.template, tag.params, ctx);
+  }
+  return nodeToHtml(node, ctx);
+}
 function renderFootnotesSection(footnotes, ctx) {
   if (footnotes.isEmpty) return "";
   const items = footnotes.ordered().map((fn) => {
@@ -484,7 +496,7 @@ function renderFeatureSection(heading, bodyNodes, side, ctx) {
   const headingHtml = `<${headingTag}>${childrenToHtml({ children: heading.children }, ctx)}</${headingTag}>`;
   const featured = takeFirstImage(bodyNodes);
   const media = featured.image ? renderFeatureImage(featured.image, ctx) : '<div class="squisq-feature__media squisq-feature__media--empty"></div>';
-  const textHtml = [headingHtml, ...featured.remaining.map((n) => nodeToHtml(n, ctx))].filter((s) => s.length > 0).join("\n");
+  const textHtml = [headingHtml, ...featured.remaining.map((n) => topLevelBlockToHtml(n, ctx))].filter((s) => !!s).join("\n");
   const sideClass = side === "leftFeature" ? "squisq-feature--left" : "squisq-feature--right";
   return `<section class="squisq-feature ${sideClass}">
 ${media}
@@ -807,6 +819,11 @@ function nodeToHtml(node, ctx) {
     case "image": {
       const original = node.url ?? "";
       const resolved = ctx?.images?.get(original) ?? original;
+      const mediaKind = mediaKindForUrl(original);
+      if (mediaKind) {
+        const label = node.alt || node.title || void 0;
+        return mediaPlayerHtml(mediaKind, resolved, label, ctx) ?? escapeHtml2(node.alt ?? "");
+      }
       const safeSrc = sanitizeUrl(resolved, "media") ?? svgDataImageToHtmlSrc(resolved);
       if (!safeSrc) return escapeHtml2(node.alt ?? "");
       return `<img src="${escapeAttr(safeSrc)}" alt="${escapeAttr(node.alt ?? "")}"${imageSizeAttributes(node)} />`;
@@ -816,9 +833,16 @@ function nodeToHtml(node, ctx) {
     case "table":
       return tableToHtml(node, ctx);
     case "inlineIcon": {
+      const token = escapeAttr(node.token ?? `${node.family}:${node.name}`);
+      const svg = ctx?.icons?.get(`${node.family}:${node.name}`);
+      if (svg) {
+        ctx.usesSvgIcons = true;
+        const width = Number((svg.width / svg.height).toFixed(4));
+        return `<svg class="squisq-icon" viewBox="0 0 ${svg.width} ${svg.height}" width="${width}em" height="1em" fill="currentColor" aria-hidden="true" focusable="false" data-icon="${token}"><path d="${escapeAttr(svg.path)}"/></svg>`;
+      }
+      if (ctx) ctx.usesFontIcons = true;
       const family = escapeAttr(node.family ?? "solid");
       const name = escapeAttr(node.name ?? "");
-      const token = escapeAttr(node.token ?? `${node.family}:${node.name}`);
       return `<i class="fa-${family} fa-${name}" data-icon="${token}" aria-hidden="true"></i>`;
     }
     case "htmlBlock":
@@ -955,6 +979,28 @@ var VIDEO_EMBED_CSS = `  .squisq-video-embed { display: block; max-width: 720px;
   .squisq-video-embed-play::after { content: ''; position: absolute; left: 26px; top: 12px; border-style: solid; border-width: 10px 0 10px 16px; border-color: transparent transparent transparent #fff; }
   .squisq-video-embed-provider { position: absolute; left: 12px; bottom: 10px; color: #fff; font-size: 0.8em; font-weight: 600; text-shadow: 0 1px 2px rgba(0, 0, 0, 0.8); }
   .squisq-video-embed-caption { margin-top: 0.4em; font-size: 0.875em; opacity: 0.8; }`;
+function mediaPlayerHtml(kind, src, label, ctx) {
+  const safeSrc = sanitizeUrl(src, "media");
+  if (!safeSrc) return null;
+  if (ctx) ctx.usesMediaPlayers = true;
+  const aria = label ? ` aria-label="${escapeAttr(label)}"` : "";
+  return `<${kind} class="squisq-media" src="${escapeAttr(safeSrc)}" controls preload="metadata"${aria}></${kind}>`;
+}
+function mediaAnnotationToHtml(template, params, ctx) {
+  if (!params.src) return null;
+  const kind = template === "video" ? "video" : "audio";
+  let src = ctx?.images?.get(params.src) ?? params.src;
+  const start = parseTimeSeconds(params.clipStart ?? "");
+  const end = parseTimeSeconds(params.clipEnd ?? "");
+  if ((start !== null || end !== null) && !src.includes("#")) {
+    src += `#t=${start ?? ""}${end !== null ? `,${end}` : ""}`;
+  }
+  const player = mediaPlayerHtml(kind, src, void 0, ctx);
+  return player ? `<figure class="squisq-media-clip">${player}</figure>` : null;
+}
+var MEDIA_PLAYER_CSS = `  .squisq-media-clip { margin: 1.25em 0; }
+  video.squisq-media { display: block; width: 100%; max-width: 720px; height: auto; border-radius: 6px; }
+  audio.squisq-media { display: block; width: 100%; max-width: 480px; }`;
 function svgDataImageToHtmlSrc(url) {
   const source = svgSourceFromDataUrl(url);
   const result = source === null ? null : parseSvgIsland(source);
@@ -976,6 +1022,80 @@ function escapeAttr(s) {
   return escapeHtml2(s).replace(/"/g, "&quot;");
 }
 
+// src/html/plainHtmlPrepare.ts
+import { isDataFilePath } from "@bendyline/squisq/doc";
+var PAGE_DIAGRAM_KINDS = [
+  "mermaid",
+  "diagram",
+  "timeline",
+  "container",
+  "chart"
+];
+function needsPlainHtmlPreparation(doc, options = {}) {
+  let icons = false;
+  let data = false;
+  const visit = (node) => {
+    if (!node || typeof node !== "object" || icons && data) return;
+    const n = node;
+    if (n.type === "inlineIcon") icons = true;
+    if (n.type === "heading") {
+      const src = n.templateAnnotation?.params?.src;
+      if (src && isDataFilePath(src)) data = true;
+    }
+    if (Array.isArray(n.children)) n.children.forEach(visit);
+  };
+  doc.children.forEach(visit);
+  if (icons || data && options.container) return true;
+  if (!options.renderDiagram) return false;
+  return findDiagrams(doc).some((diagram) => PAGE_DIAGRAM_KINDS.includes(diagram.kind));
+}
+async function prepareMarkdownDocForPlainHtml(doc, options = {}) {
+  const { renderDiagram, container, signal, onWarning } = options;
+  let markdownDoc = doc;
+  if (container) {
+    const { materializeDataReferences, DATA_PREVIEW_ROWS } = await import("./materialize-ICXNO4S4.js");
+    markdownDoc = await materializeDataReferences(markdownDoc, container, onWarning, {
+      maxRows: options.maxDataRows ?? DATA_PREVIEW_ROWS,
+      tableCache: options.dataTableCache
+    });
+  }
+  signal?.throwIfAborted();
+  const { plainHtmlIcons } = await import("./plainHtmlIcons-KBSIJ5EN.js");
+  const icons = await plainHtmlIcons(markdownDoc);
+  const images = /* @__PURE__ */ new Map();
+  if (!renderDiagram) return { markdownDoc, images, icons };
+  const pictured = await rasterizeDiagrams(markdownDoc, renderDiagram, {
+    kinds: PAGE_DIAGRAM_KINDS,
+    urlPrefix: "squisq-picture",
+    signal,
+    onWarning
+  });
+  const widths = /* @__PURE__ */ new Map();
+  for (const [url, picture] of pictured.images) {
+    const bytes = picture.data;
+    const buffer = bytes.buffer.slice(
+      bytes.byteOffset,
+      bytes.byteOffset + bytes.byteLength
+    );
+    images.set(url, arrayBufferToBase64DataUrl(buffer, picture.contentType));
+    widths.set(url, Math.round(picture.width));
+  }
+  return { markdownDoc: withPictureWidths(pictured.markdownDoc, widths), images, icons };
+}
+function withPictureWidths(doc, widths) {
+  if (widths.size === 0) return doc;
+  const visit = (node) => {
+    if (node.type === "image") {
+      const width = widths.get(node.url);
+      return width === void 0 ? node : { ...node, width };
+    }
+    const children = node.children;
+    if (!Array.isArray(children)) return node;
+    return { ...node, children: children.map(visit) };
+  };
+  return { ...doc, children: doc.children.map(visit) };
+}
+
 // src/html/plainHtmlBundle.ts
 import JSZip from "jszip";
 import { parseMarkdown, inferDocumentTitle } from "@bendyline/squisq/markdown";
@@ -2645,6 +2765,8 @@ export {
   generateExternalHtml,
   markdownDocToPlainHtml,
   markdownDocToPlainHtmlParts,
+  needsPlainHtmlPreparation,
+  prepareMarkdownDocForPlainHtml,
   markdownDocsToPlainHtmlBundle,
   collectLinkRefs,
   HTML_PAGE_TEMPLATE_CONTENT_START,

package/dist/{chunk-KROH7FNT.js → chunk-VKLJUHC2.js}

@@ -55,8 +55,9 @@ import {
   resolveTarget
 } from "./chunk-S5PCVMKU.js";
 import {
-  renumberFootnotes
-} from "./chunk-BXWNU4T5.js";
+  renumberFootnotes,
+  withoutBlockTags
+} from "./chunk-DTJQK7U7.js";
 import {
   buildContainer
 } from "./chunk-IIQYS2YH.js";
@@ -65,7 +66,7 @@ import {
   fontAwesomeFaces,
   fontAwesomeGlyph,
   obfuscateDocxFont
-} from "./chunk-LBXBRFBZ.js";
+} from "./chunk-DDMPZZJF.js";
 import {
   authoredImageSize,
   extToMime,
@@ -214,8 +215,9 @@ function pointsToTwips(points) {
 }
 
 // src/docx/export.ts
-async function markdownDocToDocx(doc, options = {}) {
+async function markdownDocToDocx(source, options = {}) {
   options.signal?.throwIfAborted();
+  const doc = withoutBlockTags(source);
   const resolvedOptions = options.themeId !== void 0 ? options : { ...options, themeId: readFrontmatterThemeId(doc.frontmatter) };
   const ctx = new ExportContext(resolvedOptions, doc);
   const stories = partitionDocumentStories(doc.children);

package/dist/{chunk-GDUZJ75A.js → chunk-WVDAFJFS.js}

@@ -251,7 +251,7 @@ async function collectContainerAssets(container, pattern, signal, flattenBasenam
 async function collectContainerImages(container, signal) {
   return collectContainerAssets(container, IMAGE_ASSET_RE, signal);
 }
-function dataReferenceWarnings(doc, formatLabel) {
+function dataReferenceSources(doc) {
   const srcs = /* @__PURE__ */ new Set();
   const visit = (blocks) => {
     for (const block of blocks) {
@@ -261,10 +261,38 @@ function dataReferenceWarnings(doc, formatLabel) {
     }
   };
   visit(doc.blocks);
-  return [...srcs].map(
-    (src) => `${formatLabel} cannot embed the data sidecar "${src}"; the export carries its bounded preview and the link will not resolve outside the source container.`
+  return srcs;
+}
+function dataReferenceWarnings(doc, formatLabel) {
+  return [...dataReferenceSources(doc)].map(
+    (src) => `${formatLabel} cannot embed the data sidecar "${src}"; the export shows its first rows and the link will not resolve outside the source container.`
+  );
+}
+async function markdownWithDataPreview(input, warnings) {
+  const markdownDoc = await markdownOf(input);
+  if (dataReferenceSources(input.doc).size === 0) return markdownDoc;
+  const { materializeDataReferences, DATA_PREVIEW_ROWS } = await import("./materialize-ICXNO4S4.js");
+  return materializeDataReferences(
+    markdownDoc,
+    input.container,
+    (message) => warnings.push(message),
+    { maxRows: DATA_PREVIEW_ROWS }
   );
 }
+async function docWithDataPreview(input, warnings) {
+  if (dataReferenceSources(input.doc).size === 0) return input.doc;
+  const [{ resolveDataReferences }, { defaultDataReaders }] = await Promise.all([
+    import("@bendyline/squisq/doc"),
+    import("./readers-3P5A6A2A.js")
+  ]);
+  const { doc, diagnostics } = await resolveDataReferences(input.doc, input.container, {
+    readers: defaultDataReaders()
+  });
+  for (const diagnostic of diagnostics) {
+    if (diagnostic.severity !== "info") warnings.push(diagnostic.message);
+  }
+  return doc;
+}
 async function collectContainerDocxImages(container, signal) {
   const images = await collectContainerImages(container, signal);
   const { extToMime } = await import("./images-PQCYRJJ5.js");
@@ -351,7 +379,8 @@ function defaultFormats() {
     async exportDoc(input, options) {
       const { markdownDocToDocx } = await import("./docx/index.js");
       const raw = optionsFor(options, "docx");
-      const markdownDoc = await markdownOf(input);
+      const warnings = [];
+      const markdownDoc = await markdownWithDataPreview(input, warnings);
       const containerImages = await collectContainerDocxImages(input.container, options.signal);
       const images = new Map([...containerImages, ...raw.images ?? /* @__PURE__ */ new Map()]);
       const buf = await markdownDocToDocx(markdownDoc, {
@@ -361,7 +390,10 @@ function defaultFormats() {
         themeRegistry: options.themeRegistry ?? raw.themeRegistry,
         images
       });
-      return ok(await toBytes(buf), MIME.docx, markdownFidelityWarnings(markdownDoc, "docx"));
+      return ok(await toBytes(buf), MIME.docx, [
+        ...markdownFidelityWarnings(markdownDoc, "docx"),
+        ...warnings
+      ]);
     }
   };
   const pdf = {
@@ -381,8 +413,8 @@ function defaultFormats() {
     async exportDoc(input, options) {
       const { markdownDocToPdf } = await import("./pdf/index.js");
       const raw = optionsFor(options, "pdf");
-      const markdownDoc = await markdownOf(input);
       const pdfWarnings = [];
+      const markdownDoc = await markdownWithDataPreview(input, pdfWarnings);
       const containerImages = await collectContainerDocxImages(input.container, options.signal);
       const images = new Map([...containerImages, ...raw.images ?? /* @__PURE__ */ new Map()]);
       const buf = await markdownDocToPdf(markdownDoc, {
@@ -420,7 +452,8 @@ function defaultFormats() {
       const containerImages = await collectContainerImages(input.container, options.signal);
       const images = new Map([...containerImages, ...raw.images ?? /* @__PURE__ */ new Map()]);
       const pptxWarnings = [];
-      const buf = await docToPptx(input.doc, {
+      const doc = await docWithDataPreview(input, pptxWarnings);
+      const buf = await docToPptx(doc, {
         ...raw,
         ...options.title !== void 0 ? { title: options.title } : {},
         themeId: resolveThemeId(input, options),
@@ -456,7 +489,7 @@ function defaultFormats() {
     },
     async exportDoc(input, options) {
       const { markdownDocToXlsx } = await import("./xlsx/index.js");
-      const { materializeDataReferences } = await import("./materialize-G4WC5UG3.js");
+      const { materializeDataReferences } = await import("./materialize-ICXNO4S4.js");
       const warnings = [];
       const markdownDoc = await materializeDataReferences(
         await markdownOf(input),
@@ -495,7 +528,7 @@ function defaultFormats() {
     },
     async exportDoc(input, options) {
       const { markdownDocToCsv } = await import("./csv/index.js");
-      const { materializeDataReferences } = await import("./materialize-G4WC5UG3.js");
+      const { materializeDataReferences } = await import("./materialize-ICXNO4S4.js");
       const warnings = [];
       const markdownDoc = await materializeDataReferences(
         await markdownOf(input),
@@ -528,9 +561,11 @@ function defaultFormats() {
     // so there is nothing to extract into a container this wave.
     async exportDoc(input, options) {
       const raw = optionsFor(options, "html");
+      const warnings = [];
+      const doc = await docWithDataPreview(input, warnings);
       if (raw.playerScriptPath) {
         const { generateExternalHtml } = await import("./html/index.js");
-        const htmlText2 = generateExternalHtml(input.doc, {
+        const htmlText2 = generateExternalHtml(doc, {
           ...raw,
           playerScriptPath: raw.playerScriptPath,
           title: options.title ?? input.baseName,
@@ -538,7 +573,7 @@ function defaultFormats() {
           themeId: resolveThemeId(input, options),
           themeRegistry: options.themeRegistry ?? raw.themeRegistry
         });
-        return ok(new TextEncoder().encode(htmlText2), MIME.html);
+        return ok(new TextEncoder().encode(htmlText2), MIME.html, warnings);
       }
       const playerScript = await requirePlayerScript(options, "html");
       const { docToHtml } = await import("./html/index.js");
@@ -550,7 +585,7 @@ function defaultFormats() {
         false
       );
       const images = new Map([...containerImages, ...media, ...raw.images ?? /* @__PURE__ */ new Map()]);
-      const htmlText = docToHtml(input.doc, {
+      const htmlText = docToHtml(doc, {
         ...raw,
         playerScript,
         images,
@@ -560,11 +595,10 @@ function defaultFormats() {
         themeId: resolveThemeId(input, options),
         themeRegistry: options.themeRegistry ?? raw.themeRegistry
       });
-      return ok(
-        new TextEncoder().encode(htmlText),
-        MIME.html,
-        dataReferenceWarnings(input.doc, "Single-file HTML")
-      );
+      return ok(new TextEncoder().encode(htmlText), MIME.html, [
+        ...dataReferenceWarnings(input.doc, "Single-file HTML"),
+        ...warnings
+      ]);
     }
   };
   const htmlzip = {
@@ -596,7 +630,9 @@ function defaultFormats() {
         ...media,
         ...raw.images ?? /* @__PURE__ */ new Map()
       ]);
-      const blob = await docToHtmlZip(input.doc, {
+      const warnings = [];
+      const doc = await docWithDataPreview(input, warnings);
+      const blob = await docToHtmlZip(doc, {
         ...raw,
         playerScript,
         images,
@@ -606,7 +642,7 @@ function defaultFormats() {
         themeId: resolveThemeId(input, options),
         themeRegistry: options.themeRegistry ?? raw.themeRegistry
       });
-      return ok(await toBytes(blob), MIME.zip);
+      return ok(await toBytes(blob), MIME.zip, warnings);
     }
   };
   const epub = {
@@ -618,7 +654,8 @@ function defaultFormats() {
     async exportDoc(input, options) {
       const { markdownDocToEpub } = await import("./epub/index.js");
       const raw = optionsFor(options, "epub");
-      const markdownDoc = await markdownOf(input);
+      const warnings = [];
+      const markdownDoc = await markdownWithDataPreview(input, warnings);
       const containerImages = await collectContainerImages(input.container, options.signal);
       const images = new Map([...containerImages, ...raw.images ?? /* @__PURE__ */ new Map()]);
       const buf = await markdownDocToEpub(markdownDoc, {
@@ -630,7 +667,8 @@ function defaultFormats() {
       });
       return ok(await toBytes(buf), MIME.epub, [
         ...markdownFidelityWarnings(markdownDoc, "epub"),
-        ...dataReferenceWarnings(input.doc, "EPUB")
+        ...dataReferenceWarnings(input.doc, "EPUB"),
+        ...warnings
       ]);
     }
   };

package/dist/chunk-YRFBWYAD.js

@@ -0,0 +1,128 @@
+import {
+  defaultDataReaders
+} from "./chunk-5HUHSLGA.js";
+
+// src/data/materialize.ts
+import {
+  isDataFilePath
+} from "@bendyline/squisq/doc";
+function tableRow(cells) {
+  return {
+    type: "tableRow",
+    children: cells.map((value) => ({
+      type: "tableCell",
+      children: value ? [{ type: "text", value }] : []
+    }))
+  };
+}
+function count(n) {
+  return n.toLocaleString("en-US");
+}
+function extensionOf(path) {
+  const base = path.split("/").pop() ?? path;
+  const dot = base.lastIndexOf(".");
+  return dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
+}
+var DATA_PREVIEW_ROWS = 100;
+async function materializeDataReferences(markdownDoc, container, onWarning, options = {}) {
+  const readers = defaultDataReaders();
+  const children = [];
+  let changed = false;
+  for (const [index, node] of markdownDoc.children.entries()) {
+    children.push(node);
+    if (node.type !== "heading") continue;
+    const params = node.templateAnnotation?.params;
+    const src = params?.src;
+    if (!src || !isDataFilePath(src)) continue;
+    if (markdownDoc.children[index + 1]?.type === "table") continue;
+    const label = params?.sheet && params?.anchor ? `${params.sheet}!${params.anchor}` : src;
+    if (!container) {
+      onWarning?.(
+        `Data reference "${src}" could not be embedded: the export has no source container to read it from.`
+      );
+      continue;
+    }
+    const ext = extensionOf(src);
+    const reader = readers.find((r) => r.extensions.includes(ext));
+    if (!reader) {
+      onWarning?.(`Data reference "${src}" could not be embedded: no reader for ".${ext}".`);
+      continue;
+    }
+    const previewRows = Number.parseInt(params?.previewRows ?? "", 10);
+    const maxRows = options.maxRows === void 0 ? Number.POSITIVE_INFINITY : previewRows > 0 ? previewRows : options.maxRows;
+    const readOptions = {
+      maxRows,
+      ...params?.sheet ? { sheet: params.sheet } : {},
+      ...params?.anchor ? { anchor: params.anchor } : {},
+      ...params?.headerRow !== void 0 ? { headerRow: params.headerRow !== "false" } : {},
+      // Exports honor the author's curated view: the sort/filter params
+      // shape the embedded full table exactly as they shape previews.
+      ...params?.sort ? { sort: params.sort } : {},
+      ...params?.filter ? { filter: params.filter } : {}
+    };
+    const cacheKey = [
+      src,
+      readOptions.sheet ?? "",
+      readOptions.anchor ?? "",
+      String(readOptions.headerRow ?? ""),
+      readOptions.sort ?? "",
+      readOptions.filter ?? "",
+      String(maxRows)
+    ].join("\0");
+    let pending = options.tableCache?.get(cacheKey);
+    if (!pending) {
+      let bytes = null;
+      try {
+        bytes = await container.readFile(src);
+      } catch {
+        bytes = null;
+      }
+      if (!bytes) {
+        onWarning?.(`Data reference "${src}" could not be embedded: file not found in container.`);
+        continue;
+      }
+      pending = reader.read(bytes, readOptions);
+      options.tableCache?.set(cacheKey, pending);
+    }
+    try {
+      const table = await pending;
+      const mdTable = {
+        type: "table",
+        children: [tableRow(table.headers), ...table.rows.map(tableRow)]
+      };
+      children.push(mdTable);
+      if (table.totalRows > table.rows.length) {
+        children.push({
+          type: "paragraph",
+          children: [
+            {
+              type: "emphasis",
+              children: [
+                {
+                  type: "text",
+                  value: `Showing ${count(table.rows.length)} of ${count(table.totalRows)} rows.`
+                }
+              ]
+            }
+          ]
+        });
+      }
+      changed = true;
+      if (ext === "xlsx") {
+        onWarning?.(
+          `Region ${label} exported as values; formulas in the sidecar workbook were not carried over.`
+        );
+      }
+    } catch (err) {
+      onWarning?.(
+        `Data reference "${src}" could not be embedded: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  return changed ? { ...markdownDoc, children } : markdownDoc;
+}
+
+export {
+  DATA_PREVIEW_ROWS,
+  materializeDataReferences
+};

package/dist/{chunk-SVYTUYZM.js → chunk-ZJERBWTB.js}

@@ -14,13 +14,14 @@ import {
 } from "./chunk-JU2RHXUB.js";
 import {
   FootnoteIndex,
-  footnoteIds
-} from "./chunk-BXWNU4T5.js";
+  footnoteIds,
+  withoutBlockTags
+} from "./chunk-DTJQK7U7.js";
 import {
   collectInlineIconFamilies,
   fontAwesomeFaces,
   fontAwesomeGlyph
-} from "./chunk-LBXBRFBZ.js";
+} from "./chunk-DDMPZZJF.js";
 import {
   imageSizeAttributes
 } from "./chunk-JZR32FON.js";
@@ -30,8 +31,9 @@ import JSZip from "jszip";
 import { resolveFontFamily } from "@bendyline/squisq/schemas";
 import { resolveThemeForDoc } from "@bendyline/squisq/doc";
 import { isHtmlLineBreak, readFrontmatterThemeId, sanitizeUrl } from "@bendyline/squisq/markdown";
-async function markdownDocToEpub(sourceDoc, options = {}) {
+async function markdownDocToEpub(authoredDoc, options = {}) {
   options.signal?.throwIfAborted();
+  const sourceDoc = withoutBlockTags(authoredDoc);
   const themeId = options.themeId ?? readFrontmatterThemeId(sourceDoc.frontmatter);
   const islandColor = themeId ? resolveThemeForDoc(sourceDoc, themeId, options.themeRegistry).colors.text : void 0;
   const { doc, images: islandImages } = svgIslandsAsImages(sourceDoc, { color: islandColor });