@bendyline/squisq-editor-react 1.2.1 → 1.2.2

package/dist/PreviewPanel.d.ts

@@ -6,14 +6,9 @@
  *
  * The markdown-derived Doc (from markdownToDoc) contains hierarchical blocks
  * with template names, heading text, and body content — but no audio or
- * visual layers. This component bridges the gap by:
- *
- * 1. Flattening the block tree into a linear slide sequence
- * 2. Converting each block into a TemplateBlock-compatible object
- *    (mapping heading text → title, templateOverrides → template fields)
- * 3. Synthesizing a dummy audio segment so DocPlayer's timing works
- *    (the player enters fallback-timer mode when audio can't load)
- * 4. Passing the prepared Doc to DocPlayer for SVG-based rendering
+ * visual layers. This component bridges the gap by using buildPreviewDoc()
+ * to flatten blocks, convert them to TemplateBlock slides with interleaved
+ * images, and synthesize timing.
  */
 import type { ContentContainer } from '@bendyline/squisq/storage';
 export interface PreviewPanelProps {

package/dist/PreviewPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PreviewPanel.d.ts","sourceRoot":"","sources":["../src/PreviewPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC;AAmUD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAc,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,iBAAiB,2CA2HvF"}
+{"version":3,"file":"PreviewPanel.d.ts","sourceRoot":"","sources":["../src/PreviewPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKlE,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAc,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,iBAAiB,2CA2HvF"}

package/dist/PreviewPanel.js

@@ -7,295 +7,17 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * The markdown-derived Doc (from markdownToDoc) contains hierarchical blocks
  * with template names, heading text, and body content — but no audio or
- * visual layers. This component bridges the gap by:
- *
- * 1. Flattening the block tree into a linear slide sequence
- * 2. Converting each block into a TemplateBlock-compatible object
- *    (mapping heading text → title, templateOverrides → template fields)
- * 3. Synthesizing a dummy audio segment so DocPlayer's timing works
- *    (the player enters fallback-timer mode when audio can't load)
- * 4. Passing the prepared Doc to DocPlayer for SVG-based rendering
+ * visual layers. This component bridges the gap by using buildPreviewDoc()
+ * to flatten blocks, convert them to TemplateBlock slides with interleaved
+ * images, and synthesize timing.
  */
 import { useState, useEffect } from 'react';
 import { DocPlayer, LinearDocView } from '@bendyline/squisq-react';
-import { flattenBlocks } from '@bendyline/squisq/doc';
-import { hasTemplate } from '@bendyline/squisq/doc';
-import { extractPlainText } from '@bendyline/squisq/markdown';
-import { getChildren } from '@bendyline/squisq/markdown';
 import { applyTransform } from '@bendyline/squisq/transform';
 import { resolveAudioMapping } from '@bendyline/squisq/doc';
 import { useEditorContext } from './EditorContext';
 import { usePreviewSettings } from './PreviewControls';
-// ── Helpers ────────────────────────────────────────────────────────
-/**
- * Extract plain text from an array of markdown block nodes.
- * Walks paragraphs, blockquotes, and list items to collect all text.
- */
-function extractBodyText(contents) {
-    if (!contents || contents.length === 0)
-        return '';
-    const parts = [];
-    for (const node of contents) {
-        parts.push(extractPlainText(node));
-    }
-    return parts.join('\n').trim();
-}
-/**
- * Extract images from a block's markdown contents.
- * Walks the node tree recursively to find all MarkdownImage nodes.
- */
-function extractBlockImages(contents) {
-    if (!contents || contents.length === 0)
-        return [];
-    const images = [];
-    function walk(node) {
-        if ('type' in node && node.type === 'image' && 'url' in node) {
-            const img = node;
-            if (img.url) {
-                images.push({ src: img.url, alt: img.alt ?? '' });
-            }
-        }
-        for (const child of getChildren(node)) {
-            walk(child);
-        }
-    }
-    for (const node of contents) {
-        walk(node);
-    }
-    return images;
-}
-/**
- * Collect all unique images from an entire Doc's block tree.
- * Walks nested children to find every image across all blocks.
- */
-function collectAllDocImages(blocks) {
-    const seen = new Set();
-    const images = [];
-    function walkBlocks(blockList) {
-        for (const block of blockList) {
-            for (const img of extractBlockImages(block.contents)) {
-                if (!seen.has(img.src)) {
-                    seen.add(img.src);
-                    images.push(img);
-                }
-            }
-            if (block.children) {
-                walkBlocks(block.children);
-            }
-        }
-    }
-    walkBlocks(blocks);
-    return images;
-}
-/**
- * Extract list items from markdown body content.
- * Returns an array of plain text strings for each list item found.
- */
-function extractListItems(contents) {
-    if (!contents)
-        return [];
-    const items = [];
-    for (const node of contents) {
-        if (node.type === 'list') {
-            for (const item of node.children) {
-                const text = extractPlainText(item).trim();
-                if (text)
-                    items.push(text);
-            }
-        }
-    }
-    return items;
-}
-/**
- * Provide sensible default fields for templates that require more than
- * just a `title`. This prevents crashes from undefined required fields
- * when the markdown annotations don't supply all template-specific values.
- */
-function getTemplateDefaults(templateName, headingText, block) {
-    const body = extractBodyText(block.contents);
-    switch (templateName) {
-        case 'statHighlight':
-            return {
-                stat: headingText,
-                description: body || headingText,
-            };
-        case 'quoteBlock':
-        case 'fullBleedQuote':
-        case 'pullQuote':
-            return {
-                quote: body || headingText,
-            };
-        case 'factCard':
-            return {
-                fact: headingText,
-                explanation: body || headingText,
-            };
-        case 'comparisonBar':
-            return {
-                leftLabel: 'A',
-                leftValue: 60,
-                rightLabel: 'B',
-                rightValue: 40,
-            };
-        case 'listBlock':
-            return {
-                items: extractListItems(block.contents) || ['Item 1', 'Item 2', 'Item 3'],
-            };
-        case 'definitionCard':
-            return {
-                term: headingText,
-                definition: body || headingText,
-            };
-        case 'dateEvent':
-            return {
-                date: headingText,
-                description: body || headingText,
-            };
-        default:
-            return {};
-    }
-}
-/**
- * Convert a markdown-derived Block into a TemplateBlock-compatible object.
- *
- * The block's heading text becomes `title` (works for sectionHeader,
- * titleBlock, factCard, etc.). Any templateOverrides from annotation
- * syntax `{[template key=value]}` are spread on top so template-specific
- * fields (stat, quote, description, …) are available.
- *
- * If the requested template doesn't exist in the registry, falls back
- * to `sectionHeader` to avoid "Unknown template" warnings.
- */
-function blockToSlide(block, index) {
-    const headingText = block.sourceHeading
-        ? extractPlainText(block.sourceHeading)
-        : block.title || block.id || `Slide ${index + 1}`;
-    // Validate template name — fall back to sectionHeader for unknowns
-    const requestedTemplate = block.template || 'sectionHeader';
-    const template = hasTemplate(requestedTemplate) ? requestedTemplate : 'sectionHeader';
-    // Get sensible defaults for templates that need more than just `title`
-    const defaults = getTemplateDefaults(template, headingText, block);
-    // Spread the block itself to pick up any template-specific fields
-    // placed directly on the block by applyTransform (e.g. stat, description,
-    // quote, colorScheme). These are not in templateOverrides — they live
-    // on the block object because the transform produces hybrid Block+Template
-    // objects via the timing allocator.
-    const { id: _id, startTime: _st, duration: _d, audioSegment: _as, layers: _l, transition: _tr, template: _t, title: _ti, children: _c, contents: _co, sourceHeading: _sh, templateOverrides: _to, ...extraFields } = block;
-    return {
-        id: block.id,
-        template,
-        duration: block.duration,
-        audioSegment: 0,
-        transition: index > 0 ? { type: 'fade', duration: 0.5 } : undefined,
-        // Provide heading text as title — consumed by sectionHeader, titleBlock, etc.
-        title: headingText,
-        // Template-specific defaults (safe fallbacks for required fields)
-        ...defaults,
-        // Template-specific fields from transform (stat, description, quote, etc.)
-        ...extraFields,
-        // Spread annotation overrides last so explicit values win
-        ...block.templateOverrides,
-    };
-}
-/** Ambient motions to rotate on image slides. */
-const IMAGE_MOTIONS = [
-    'zoomIn',
-    'zoomOut',
-    'panLeft',
-    'panRight',
-];
-/**
- * Build a player-ready Doc from the markdown-derived Doc.
- *
- * Flattens hierarchical blocks, converts each to a TemplateBlock-compatible
- * slide, recalculates timing, and adds a synthetic audio segment.
- *
- * Images found in the markdown are used in two ways:
- * 1. Per-block: if a block has images, its first image becomes the background
- *    (via imageWithCaption template) or an accent image on text templates.
- * 2. Global: remaining images are interleaved as standalone image slides
- *    for visual variety.
- */
-function buildPreviewDoc(doc) {
-    const flat = flattenBlocks(doc.blocks);
-    // Collect all images from the doc for global interleaving
-    const allImages = collectAllDocImages(doc.blocks);
-    // Track which images are used per-block so we can interleave the rest
-    const usedImageSrcs = new Set();
-    // First pass: convert blocks to slides, using per-block images
-    const slides = [];
-    let motionIndex = 0;
-    for (let i = 0; i < flat.length; i++) {
-        const block = flat[i];
-        const blockImages = extractBlockImages(block.contents);
-        const slide = blockToSlide(block, i);
-        // If the block has images and is using the default sectionHeader template,
-        // upgrade it to imageWithCaption so the image becomes the slide background.
-        if (blockImages.length > 0 && slide.template === 'sectionHeader') {
-            const img = blockImages[0];
-            usedImageSrcs.add(img.src);
-            slide.template = 'imageWithCaption';
-            slide.imageSrc = img.src;
-            slide.imageAlt = img.alt;
-            slide.caption = slide.title;
-            slide.captionPosition = 'bottom';
-            slide.ambientMotion = IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length];
-        }
-        else if (blockImages.length > 0) {
-            // For other templates, add the first image as an accent
-            const img = blockImages[0];
-            usedImageSrcs.add(img.src);
-            if (!slide.accentImage) {
-                slide.accentImage = {
-                    src: img.src,
-                    alt: img.alt,
-                    position: 'left-strip',
-                    ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
-                };
-            }
-        }
-        slides.push(slide);
-    }
-    // Second pass: interleave unused images as standalone imageWithCaption slides.
-    // Spread them evenly through the sequence for visual variety.
-    const unusedImages = allImages.filter((img) => !usedImageSrcs.has(img.src));
-    if (unusedImages.length > 0 && slides.length > 0) {
-        const interval = Math.max(2, Math.floor(slides.length / (unusedImages.length + 1)));
-        let insertOffset = 0;
-        for (let imgIdx = 0; imgIdx < unusedImages.length; imgIdx++) {
-            const insertAt = Math.min((imgIdx + 1) * interval + insertOffset, slides.length);
-            const img = unusedImages[imgIdx];
-            slides.splice(insertAt, 0, {
-                id: `img-interleave-${imgIdx}`,
-                template: 'imageWithCaption',
-                duration: 5,
-                audioSegment: 0,
-                imageSrc: img.src,
-                imageAlt: img.alt,
-                ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
-                transition: { type: 'fade', duration: 0.5 },
-            });
-            insertOffset++;
-        }
-    }
-    // Recalculate sequential timing
-    let t = 0;
-    for (const slide of slides) {
-        slide.startTime = t;
-        t += slide.duration;
-    }
-    return {
-        articleId: doc.articleId,
-        duration: t,
-        blocks: slides,
-        audio: {
-            // Synthetic segment — audio will fail to load and DocPlayer will use
-            // its fallback timer to advance currentTime via requestAnimationFrame.
-            segments: t > 0 ? [{ src: '', name: 'preview', duration: t, startTime: 0 }] : [],
-        },
-        ...(doc.captions ? { captions: doc.captions } : {}),
-    };
-}
+import { buildPreviewDoc } from './buildPreviewDoc';
 // ── Component ──────────────────────────────────────────────────────
 /**
  * Live preview panel that renders the current document as a slideshow

package/dist/PreviewPanel.js.map

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

package/dist/buildPreviewDoc.d.ts

@@ -0,0 +1,22 @@
+/**
+ * buildPreviewDoc — Converts a markdown-derived Doc into a player-ready Doc
+ * with TemplateBlock slides and interleaved images.
+ *
+ * Shared between PreviewPanel (live preview) and export flows (HTML/video).
+ *
+ * Pipeline:
+ * 1. Flatten hierarchical blocks into a linear slide sequence
+ * 2. Convert each block into a TemplateBlock-compatible object
+ * 3. Interleave images as standalone imageWithCaption slides
+ * 4. Synthesize a dummy audio segment for timer-based playback
+ */
+import type { Doc } from '@bendyline/squisq/schemas';
+/**
+ * Build a player-ready Doc from a markdown-derived Doc.
+ *
+ * Flattens hierarchical blocks, converts each to a TemplateBlock-compatible
+ * slide, interleaves images, recalculates timing, and adds a synthetic
+ * audio segment.
+ */
+export declare function buildPreviewDoc(doc: Doc): Doc;
+//# sourceMappingURL=buildPreviewDoc.d.ts.map

package/dist/buildPreviewDoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPreviewDoc.d.ts","sourceRoot":"","sources":["../src/buildPreviewDoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAS,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAwJ5D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CA8E7C"}

package/dist/buildPreviewDoc.js

@@ -0,0 +1,212 @@
+/**
+ * buildPreviewDoc — Converts a markdown-derived Doc into a player-ready Doc
+ * with TemplateBlock slides and interleaved images.
+ *
+ * Shared between PreviewPanel (live preview) and export flows (HTML/video).
+ *
+ * Pipeline:
+ * 1. Flatten hierarchical blocks into a linear slide sequence
+ * 2. Convert each block into a TemplateBlock-compatible object
+ * 3. Interleave images as standalone imageWithCaption slides
+ * 4. Synthesize a dummy audio segment for timer-based playback
+ */
+import { flattenBlocks, hasTemplate } from '@bendyline/squisq/doc';
+import { extractPlainText } from '@bendyline/squisq/markdown';
+import { getChildren } from '@bendyline/squisq/markdown';
+// ── Helpers ────────────────────────────────────────────────────────
+function extractBodyText(contents) {
+    if (!contents || contents.length === 0)
+        return '';
+    const parts = [];
+    for (const node of contents) {
+        parts.push(extractPlainText(node));
+    }
+    return parts.join('\n').trim();
+}
+function extractBlockImages(contents) {
+    if (!contents || contents.length === 0)
+        return [];
+    const images = [];
+    function walk(node) {
+        if ('type' in node && node.type === 'image' && 'url' in node) {
+            const img = node;
+            if (img.url) {
+                images.push({ src: img.url, alt: img.alt ?? '' });
+            }
+        }
+        for (const child of getChildren(node)) {
+            walk(child);
+        }
+    }
+    for (const node of contents) {
+        walk(node);
+    }
+    return images;
+}
+function collectAllDocImages(blocks) {
+    const seen = new Set();
+    const images = [];
+    function walkBlocks(blockList) {
+        for (const block of blockList) {
+            for (const img of extractBlockImages(block.contents)) {
+                if (!seen.has(img.src)) {
+                    seen.add(img.src);
+                    images.push(img);
+                }
+            }
+            if (block.children) {
+                walkBlocks(block.children);
+            }
+        }
+    }
+    walkBlocks(blocks);
+    return images;
+}
+function extractListItems(contents) {
+    if (!contents)
+        return [];
+    const items = [];
+    for (const node of contents) {
+        if (node.type === 'list') {
+            for (const item of node.children) {
+                const text = extractPlainText(item).trim();
+                if (text)
+                    items.push(text);
+            }
+        }
+    }
+    return items;
+}
+function getTemplateDefaults(templateName, headingText, block) {
+    const body = extractBodyText(block.contents);
+    switch (templateName) {
+        case 'statHighlight':
+            return { stat: headingText, description: body || headingText };
+        case 'quoteBlock':
+        case 'fullBleedQuote':
+        case 'pullQuote':
+            return { quote: body || headingText };
+        case 'factCard':
+            return { fact: headingText, explanation: body || headingText };
+        case 'comparisonBar':
+            return { leftLabel: 'A', leftValue: 60, rightLabel: 'B', rightValue: 40 };
+        case 'listBlock': {
+            const items = extractListItems(block.contents);
+            return { items: items.length > 0 ? items : ['Item 1', 'Item 2', 'Item 3'] };
+        }
+        case 'definitionCard':
+            return { term: headingText, definition: body || headingText };
+        case 'dateEvent':
+            return { date: headingText, description: body || headingText };
+        default:
+            return {};
+    }
+}
+function blockToSlide(block, index) {
+    const headingText = block.sourceHeading
+        ? extractPlainText(block.sourceHeading)
+        : block.title || block.id || `Slide ${index + 1}`;
+    const requestedTemplate = block.template || 'sectionHeader';
+    const template = hasTemplate(requestedTemplate) ? requestedTemplate : 'sectionHeader';
+    const defaults = getTemplateDefaults(template, headingText, block);
+    const { id: _id, startTime: _st, duration: _d, audioSegment: _as, layers: _l, transition: _tr, template: _t, title: _ti, children: _c, contents: _co, sourceHeading: _sh, templateOverrides: _to, ...extraFields } = block;
+    return {
+        id: block.id,
+        template,
+        duration: block.duration,
+        audioSegment: 0,
+        transition: index > 0 ? { type: 'fade', duration: 0.5 } : undefined,
+        title: headingText,
+        ...defaults,
+        ...extraFields,
+        ...block.templateOverrides,
+    };
+}
+const IMAGE_MOTIONS = [
+    'zoomIn',
+    'zoomOut',
+    'panLeft',
+    'panRight',
+];
+// ── Public API ─────────────────────────────────────────────────────
+/**
+ * Build a player-ready Doc from a markdown-derived Doc.
+ *
+ * Flattens hierarchical blocks, converts each to a TemplateBlock-compatible
+ * slide, interleaves images, recalculates timing, and adds a synthetic
+ * audio segment.
+ */
+export function buildPreviewDoc(doc) {
+    const flat = flattenBlocks(doc.blocks);
+    const allImages = collectAllDocImages(doc.blocks);
+    const usedImageSrcs = new Set();
+    const slides = [];
+    let motionIndex = 0;
+    for (let i = 0; i < flat.length; i++) {
+        const block = flat[i];
+        const blockImages = extractBlockImages(block.contents);
+        const slide = blockToSlide(block, i);
+        if (blockImages.length > 0 && slide.template === 'sectionHeader') {
+            const img = blockImages[0];
+            usedImageSrcs.add(img.src);
+            slide.template = 'imageWithCaption';
+            slide.imageSrc = img.src;
+            slide.imageAlt = img.alt;
+            slide.caption = slide.title;
+            slide.captionPosition = 'bottom';
+            slide.ambientMotion = IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length];
+        }
+        else if (blockImages.length > 0) {
+            const img = blockImages[0];
+            usedImageSrcs.add(img.src);
+            if (!slide.accentImage) {
+                slide.accentImage = {
+                    src: img.src,
+                    alt: img.alt,
+                    position: 'left-strip',
+                    ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
+                };
+            }
+        }
+        slides.push(slide);
+    }
+    // Interleave unused images
+    const unusedImages = allImages.filter((img) => !usedImageSrcs.has(img.src));
+    if (unusedImages.length > 0 && slides.length > 0) {
+        const interval = Math.max(2, Math.floor(slides.length / (unusedImages.length + 1)));
+        let insertOffset = 0;
+        for (let imgIdx = 0; imgIdx < unusedImages.length; imgIdx++) {
+            const insertAt = Math.min((imgIdx + 1) * interval + insertOffset, slides.length);
+            const img = unusedImages[imgIdx];
+            slides.splice(insertAt, 0, {
+                id: `img-interleave-${imgIdx}`,
+                template: 'imageWithCaption',
+                duration: 5,
+                audioSegment: 0,
+                imageSrc: img.src,
+                imageAlt: img.alt,
+                ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
+                transition: { type: 'fade', duration: 0.5 },
+            });
+            insertOffset++;
+        }
+    }
+    // Recalculate timing
+    let t = 0;
+    for (const slide of slides) {
+        slide.startTime = t;
+        t += slide.duration;
+    }
+    return {
+        articleId: doc.articleId,
+        duration: t,
+        blocks: slides,
+        audio: {
+            segments: t > 0 ? [{ src: '', name: 'preview', duration: t, startTime: 0 }] : [],
+        },
+        ...(doc.captions ? { captions: doc.captions } : {}),
+        ...(doc.startBlock ? { startBlock: doc.startBlock } : {}),
+        ...(doc.themeId ? { themeId: doc.themeId } : {}),
+    };
+}
+//# sourceMappingURL=buildPreviewDoc.js.map

package/dist/buildPreviewDoc.js.map

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

package/dist/index.d.ts

@@ -42,5 +42,6 @@ export { useFileDrop, classifyFile } from './hooks/useFileDrop.js';
 export type { FileCategory, DragContentType, DropTarget, UseFileDropOptions, UseFileDropResult, } from './hooks/useFileDrop.js';
 export { partitionFiles, processMediaFiles, processTextFile, processTextFiles, } from './utils/dropUtils.js';
 export { markdownToTiptap, tiptapToMarkdown } from './tiptapBridge.js';
+export { buildPreviewDoc } from './buildPreviewDoc.js';
 export { HeadingWithTemplate } from './TemplateAnnotation.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -36,6 +36,8 @@ export { useFileDrop, classifyFile } from './hooks/useFileDrop.js';
 export { partitionFiles, processMediaFiles, processTextFile, processTextFiles, } from './utils/dropUtils.js';
 // Bridge utilities
 export { markdownToTiptap, tiptapToMarkdown } from './tiptapBridge.js';
+// Slideshow builder (shared between PreviewPanel and export flows)
+export { buildPreviewDoc } from './buildPreviewDoc.js';
 // Tiptap extension: Heading with template annotation support
 export { HeadingWithTemplate } from './TemplateAnnotation.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAStE,0CAA0C;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AASnE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE,6DAA6D;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAStE,0CAA0C;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AASnE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,6DAA6D;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-editor-react",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "React editor shell with raw/WYSIWYG/preview modes for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -46,9 +46,9 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@bendyline/squisq": "1.2.1",
-    "@bendyline/squisq-formats": "1.2.1",
-    "@bendyline/squisq-react": "1.1.1",
+    "@bendyline/squisq": "1.2.2",
+    "@bendyline/squisq-formats": "1.2.2",
+    "@bendyline/squisq-react": "1.1.2",
     "@monaco-editor/react": "4.7.0",
     "@tiptap/extension-image": "2.27.2",
     "@tiptap/extension-placeholder": "2.27.2",

package/src/PreviewPanel.tsx

@@ -6,29 +6,20 @@
  *
  * The markdown-derived Doc (from markdownToDoc) contains hierarchical blocks
  * with template names, heading text, and body content — but no audio or
- * visual layers. This component bridges the gap by:
- *
- * 1. Flattening the block tree into a linear slide sequence
- * 2. Converting each block into a TemplateBlock-compatible object
- *    (mapping heading text → title, templateOverrides → template fields)
- * 3. Synthesizing a dummy audio segment so DocPlayer's timing works
- *    (the player enters fallback-timer mode when audio can't load)
- * 4. Passing the prepared Doc to DocPlayer for SVG-based rendering
+ * visual layers. This component bridges the gap by using buildPreviewDoc()
+ * to flatten blocks, convert them to TemplateBlock slides with interleaved
+ * images, and synthesize timing.
  */
 
 import { useState, useEffect } from 'react';
 import { DocPlayer, LinearDocView } from '@bendyline/squisq-react';
-import { flattenBlocks } from '@bendyline/squisq/doc';
-import { hasTemplate } from '@bendyline/squisq/doc';
-import { extractPlainText } from '@bendyline/squisq/markdown';
-import type { Block, Doc } from '@bendyline/squisq/schemas';
-import type { MarkdownBlockNode, MarkdownList, MarkdownNode } from '@bendyline/squisq/markdown';
-import { getChildren } from '@bendyline/squisq/markdown';
+import type { Doc } from '@bendyline/squisq/schemas';
 import { applyTransform } from '@bendyline/squisq/transform';
 import { resolveAudioMapping } from '@bendyline/squisq/doc';
 import type { ContentContainer } from '@bendyline/squisq/storage';
 import { useEditorContext } from './EditorContext';
 import { usePreviewSettings } from './PreviewControls';
+import { buildPreviewDoc } from './buildPreviewDoc';
 
 export interface PreviewPanelProps {
   /** Base path for resolving media URLs in DocPlayer */
@@ -39,325 +30,6 @@ export interface PreviewPanelProps {
   container?: ContentContainer | null;
 }
 
-// ── Helpers ────────────────────────────────────────────────────────
-
-/**
- * Extract plain text from an array of markdown block nodes.
- * Walks paragraphs, blockquotes, and list items to collect all text.
- */
-function extractBodyText(contents: MarkdownBlockNode[] | undefined): string {
-  if (!contents || contents.length === 0) return '';
-  const parts: string[] = [];
-  for (const node of contents) {
-    parts.push(extractPlainText(node));
-  }
-  return parts.join('\n').trim();
-}
-
-/**
- * Extract images from a block's markdown contents.
- * Walks the node tree recursively to find all MarkdownImage nodes.
- */
-function extractBlockImages(
-  contents: MarkdownBlockNode[] | undefined,
-): Array<{ src: string; alt: string }> {
-  if (!contents || contents.length === 0) return [];
-  const images: Array<{ src: string; alt: string }> = [];
-
-  function walk(node: MarkdownNode): void {
-    if ('type' in node && node.type === 'image' && 'url' in node) {
-      const img = node as { url: string; alt?: string };
-      if (img.url) {
-        images.push({ src: img.url, alt: img.alt ?? '' });
-      }
-    }
-    for (const child of getChildren(node)) {
-      walk(child);
-    }
-  }
-
-  for (const node of contents) {
-    walk(node);
-  }
-  return images;
-}
-
-/**
- * Collect all unique images from an entire Doc's block tree.
- * Walks nested children to find every image across all blocks.
- */
-function collectAllDocImages(blocks: Block[]): Array<{ src: string; alt: string }> {
-  const seen = new Set<string>();
-  const images: Array<{ src: string; alt: string }> = [];
-
-  function walkBlocks(blockList: Block[]): void {
-    for (const block of blockList) {
-      for (const img of extractBlockImages(block.contents)) {
-        if (!seen.has(img.src)) {
-          seen.add(img.src);
-          images.push(img);
-        }
-      }
-      if (block.children) {
-        walkBlocks(block.children);
-      }
-    }
-  }
-
-  walkBlocks(blocks);
-  return images;
-}
-
-/**
- * Extract list items from markdown body content.
- * Returns an array of plain text strings for each list item found.
- */
-function extractListItems(contents: MarkdownBlockNode[] | undefined): string[] {
-  if (!contents) return [];
-  const items: string[] = [];
-  for (const node of contents) {
-    if (node.type === 'list') {
-      for (const item of (node as MarkdownList).children) {
-        const text = extractPlainText(item).trim();
-        if (text) items.push(text);
-      }
-    }
-  }
-  return items;
-}
-
-/**
- * Provide sensible default fields for templates that require more than
- * just a `title`. This prevents crashes from undefined required fields
- * when the markdown annotations don't supply all template-specific values.
- */
-function getTemplateDefaults(
-  templateName: string,
-  headingText: string,
-  block: Block,
-): Record<string, unknown> {
-  const body = extractBodyText(block.contents);
-
-  switch (templateName) {
-    case 'statHighlight':
-      return {
-        stat: headingText,
-        description: body || headingText,
-      };
-
-    case 'quoteBlock':
-    case 'fullBleedQuote':
-    case 'pullQuote':
-      return {
-        quote: body || headingText,
-      };
-
-    case 'factCard':
-      return {
-        fact: headingText,
-        explanation: body || headingText,
-      };
-
-    case 'comparisonBar':
-      return {
-        leftLabel: 'A',
-        leftValue: 60,
-        rightLabel: 'B',
-        rightValue: 40,
-      };
-
-    case 'listBlock':
-      return {
-        items: extractListItems(block.contents) || ['Item 1', 'Item 2', 'Item 3'],
-      };
-
-    case 'definitionCard':
-      return {
-        term: headingText,
-        definition: body || headingText,
-      };
-
-    case 'dateEvent':
-      return {
-        date: headingText,
-        description: body || headingText,
-      };
-
-    default:
-      return {};
-  }
-}
-
-/**
- * Convert a markdown-derived Block into a TemplateBlock-compatible object.
- *
- * The block's heading text becomes `title` (works for sectionHeader,
- * titleBlock, factCard, etc.). Any templateOverrides from annotation
- * syntax `{[template key=value]}` are spread on top so template-specific
- * fields (stat, quote, description, …) are available.
- *
- * If the requested template doesn't exist in the registry, falls back
- * to `sectionHeader` to avoid "Unknown template" warnings.
- */
-function blockToSlide(block: Block, index: number): Record<string, unknown> {
-  const headingText = block.sourceHeading
-    ? extractPlainText(block.sourceHeading)
-    : block.title || block.id || `Slide ${index + 1}`;
-
-  // Validate template name — fall back to sectionHeader for unknowns
-  const requestedTemplate = block.template || 'sectionHeader';
-  const template = hasTemplate(requestedTemplate) ? requestedTemplate : 'sectionHeader';
-
-  // Get sensible defaults for templates that need more than just `title`
-  const defaults = getTemplateDefaults(template, headingText, block);
-
-  // Spread the block itself to pick up any template-specific fields
-  // placed directly on the block by applyTransform (e.g. stat, description,
-  // quote, colorScheme). These are not in templateOverrides — they live
-  // on the block object because the transform produces hybrid Block+Template
-  // objects via the timing allocator.
-  const {
-    id: _id,
-    startTime: _st,
-    duration: _d,
-    audioSegment: _as,
-    layers: _l,
-    transition: _tr,
-    template: _t,
-    title: _ti,
-    children: _c,
-    contents: _co,
-    sourceHeading: _sh,
-    templateOverrides: _to,
-    ...extraFields
-  } = block as unknown as Record<string, unknown>;
-
-  return {
-    id: block.id,
-    template,
-    duration: block.duration,
-    audioSegment: 0,
-    transition: index > 0 ? { type: 'fade', duration: 0.5 } : undefined,
-    // Provide heading text as title — consumed by sectionHeader, titleBlock, etc.
-    title: headingText,
-    // Template-specific defaults (safe fallbacks for required fields)
-    ...defaults,
-    // Template-specific fields from transform (stat, description, quote, etc.)
-    ...extraFields,
-    // Spread annotation overrides last so explicit values win
-    ...block.templateOverrides,
-  };
-}
-
-/** Ambient motions to rotate on image slides. */
-const IMAGE_MOTIONS: Array<'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight'> = [
-  'zoomIn',
-  'zoomOut',
-  'panLeft',
-  'panRight',
-];
-
-/**
- * Build a player-ready Doc from the markdown-derived Doc.
- *
- * Flattens hierarchical blocks, converts each to a TemplateBlock-compatible
- * slide, recalculates timing, and adds a synthetic audio segment.
- *
- * Images found in the markdown are used in two ways:
- * 1. Per-block: if a block has images, its first image becomes the background
- *    (via imageWithCaption template) or an accent image on text templates.
- * 2. Global: remaining images are interleaved as standalone image slides
- *    for visual variety.
- */
-function buildPreviewDoc(doc: Doc): Doc {
-  const flat = flattenBlocks(doc.blocks);
-
-  // Collect all images from the doc for global interleaving
-  const allImages = collectAllDocImages(doc.blocks);
-
-  // Track which images are used per-block so we can interleave the rest
-  const usedImageSrcs = new Set<string>();
-
-  // First pass: convert blocks to slides, using per-block images
-  const slides: Record<string, unknown>[] = [];
-  let motionIndex = 0;
-
-  for (let i = 0; i < flat.length; i++) {
-    const block = flat[i];
-    const blockImages = extractBlockImages(block.contents);
-    const slide = blockToSlide(block, i);
-
-    // If the block has images and is using the default sectionHeader template,
-    // upgrade it to imageWithCaption so the image becomes the slide background.
-    if (blockImages.length > 0 && slide.template === 'sectionHeader') {
-      const img = blockImages[0];
-      usedImageSrcs.add(img.src);
-      slide.template = 'imageWithCaption';
-      slide.imageSrc = img.src;
-      slide.imageAlt = img.alt;
-      slide.caption = slide.title as string;
-      slide.captionPosition = 'bottom';
-      slide.ambientMotion = IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length];
-    } else if (blockImages.length > 0) {
-      // For other templates, add the first image as an accent
-      const img = blockImages[0];
-      usedImageSrcs.add(img.src);
-      if (!slide.accentImage) {
-        slide.accentImage = {
-          src: img.src,
-          alt: img.alt,
-          position: 'left-strip',
-          ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
-        };
-      }
-    }
-
-    slides.push(slide);
-  }
-
-  // Second pass: interleave unused images as standalone imageWithCaption slides.
-  // Spread them evenly through the sequence for visual variety.
-  const unusedImages = allImages.filter((img) => !usedImageSrcs.has(img.src));
-  if (unusedImages.length > 0 && slides.length > 0) {
-    const interval = Math.max(2, Math.floor(slides.length / (unusedImages.length + 1)));
-    let insertOffset = 0;
-    for (let imgIdx = 0; imgIdx < unusedImages.length; imgIdx++) {
-      const insertAt = Math.min((imgIdx + 1) * interval + insertOffset, slides.length);
-      const img = unusedImages[imgIdx];
-      slides.splice(insertAt, 0, {
-        id: `img-interleave-${imgIdx}`,
-        template: 'imageWithCaption',
-        duration: 5,
-        audioSegment: 0,
-        imageSrc: img.src,
-        imageAlt: img.alt,
-        ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
-        transition: { type: 'fade', duration: 0.5 },
-      });
-      insertOffset++;
-    }
-  }
-
-  // Recalculate sequential timing
-  let t = 0;
-  for (const slide of slides) {
-    slide.startTime = t;
-    t += slide.duration as number;
-  }
-
-  return {
-    articleId: doc.articleId,
-    duration: t,
-    blocks: slides as unknown as Block[],
-    audio: {
-      // Synthetic segment — audio will fail to load and DocPlayer will use
-      // its fallback timer to advance currentTime via requestAnimationFrame.
-      segments: t > 0 ? [{ src: '', name: 'preview', duration: t, startTime: 0 }] : [],
-    },
-    ...(doc.captions ? { captions: doc.captions } : {}),
-  };
-}
-
 // ── Component ──────────────────────────────────────────────────────
 
 /**

package/src/buildPreviewDoc.ts

@@ -0,0 +1,254 @@
+/**
+ * buildPreviewDoc — Converts a markdown-derived Doc into a player-ready Doc
+ * with TemplateBlock slides and interleaved images.
+ *
+ * Shared between PreviewPanel (live preview) and export flows (HTML/video).
+ *
+ * Pipeline:
+ * 1. Flatten hierarchical blocks into a linear slide sequence
+ * 2. Convert each block into a TemplateBlock-compatible object
+ * 3. Interleave images as standalone imageWithCaption slides
+ * 4. Synthesize a dummy audio segment for timer-based playback
+ */
+
+import { flattenBlocks, hasTemplate } from '@bendyline/squisq/doc';
+import { extractPlainText } from '@bendyline/squisq/markdown';
+import { getChildren } from '@bendyline/squisq/markdown';
+import type { Block, Doc } from '@bendyline/squisq/schemas';
+import type { MarkdownBlockNode, MarkdownList, MarkdownNode } from '@bendyline/squisq/markdown';
+
+// ── Helpers ────────────────────────────────────────────────────────
+
+function extractBodyText(contents: MarkdownBlockNode[] | undefined): string {
+  if (!contents || contents.length === 0) return '';
+  const parts: string[] = [];
+  for (const node of contents) {
+    parts.push(extractPlainText(node));
+  }
+  return parts.join('\n').trim();
+}
+
+function extractBlockImages(
+  contents: MarkdownBlockNode[] | undefined,
+): Array<{ src: string; alt: string }> {
+  if (!contents || contents.length === 0) return [];
+  const images: Array<{ src: string; alt: string }> = [];
+
+  function walk(node: MarkdownNode): void {
+    if ('type' in node && node.type === 'image' && 'url' in node) {
+      const img = node as { url: string; alt?: string };
+      if (img.url) {
+        images.push({ src: img.url, alt: img.alt ?? '' });
+      }
+    }
+    for (const child of getChildren(node)) {
+      walk(child);
+    }
+  }
+
+  for (const node of contents) {
+    walk(node);
+  }
+  return images;
+}
+
+function collectAllDocImages(blocks: Block[]): Array<{ src: string; alt: string }> {
+  const seen = new Set<string>();
+  const images: Array<{ src: string; alt: string }> = [];
+
+  function walkBlocks(blockList: Block[]): void {
+    for (const block of blockList) {
+      for (const img of extractBlockImages(block.contents)) {
+        if (!seen.has(img.src)) {
+          seen.add(img.src);
+          images.push(img);
+        }
+      }
+      if (block.children) {
+        walkBlocks(block.children);
+      }
+    }
+  }
+
+  walkBlocks(blocks);
+  return images;
+}
+
+function extractListItems(contents: MarkdownBlockNode[] | undefined): string[] {
+  if (!contents) return [];
+  const items: string[] = [];
+  for (const node of contents) {
+    if (node.type === 'list') {
+      for (const item of (node as MarkdownList).children) {
+        const text = extractPlainText(item).trim();
+        if (text) items.push(text);
+      }
+    }
+  }
+  return items;
+}
+
+function getTemplateDefaults(
+  templateName: string,
+  headingText: string,
+  block: Block,
+): Record<string, unknown> {
+  const body = extractBodyText(block.contents);
+
+  switch (templateName) {
+    case 'statHighlight':
+      return { stat: headingText, description: body || headingText };
+    case 'quoteBlock':
+    case 'fullBleedQuote':
+    case 'pullQuote':
+      return { quote: body || headingText };
+    case 'factCard':
+      return { fact: headingText, explanation: body || headingText };
+    case 'comparisonBar':
+      return { leftLabel: 'A', leftValue: 60, rightLabel: 'B', rightValue: 40 };
+    case 'listBlock': {
+      const items = extractListItems(block.contents);
+      return { items: items.length > 0 ? items : ['Item 1', 'Item 2', 'Item 3'] };
+    }
+    case 'definitionCard':
+      return { term: headingText, definition: body || headingText };
+    case 'dateEvent':
+      return { date: headingText, description: body || headingText };
+    default:
+      return {};
+  }
+}
+
+function blockToSlide(block: Block, index: number): Record<string, unknown> {
+  const headingText = block.sourceHeading
+    ? extractPlainText(block.sourceHeading)
+    : block.title || block.id || `Slide ${index + 1}`;
+
+  const requestedTemplate = block.template || 'sectionHeader';
+  const template = hasTemplate(requestedTemplate) ? requestedTemplate : 'sectionHeader';
+  const defaults = getTemplateDefaults(template, headingText, block);
+
+  const {
+    id: _id,
+    startTime: _st,
+    duration: _d,
+    audioSegment: _as,
+    layers: _l,
+    transition: _tr,
+    template: _t,
+    title: _ti,
+    children: _c,
+    contents: _co,
+    sourceHeading: _sh,
+    templateOverrides: _to,
+    ...extraFields
+  } = block as unknown as Record<string, unknown>;
+
+  return {
+    id: block.id,
+    template,
+    duration: block.duration,
+    audioSegment: 0,
+    transition: index > 0 ? { type: 'fade', duration: 0.5 } : undefined,
+    title: headingText,
+    ...defaults,
+    ...extraFields,
+    ...block.templateOverrides,
+  };
+}
+
+const IMAGE_MOTIONS: Array<'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight'> = [
+  'zoomIn',
+  'zoomOut',
+  'panLeft',
+  'panRight',
+];
+
+// ── Public API ─────────────────────────────────────────────────────
+
+/**
+ * Build a player-ready Doc from a markdown-derived Doc.
+ *
+ * Flattens hierarchical blocks, converts each to a TemplateBlock-compatible
+ * slide, interleaves images, recalculates timing, and adds a synthetic
+ * audio segment.
+ */
+export function buildPreviewDoc(doc: Doc): Doc {
+  const flat = flattenBlocks(doc.blocks);
+  const allImages = collectAllDocImages(doc.blocks);
+  const usedImageSrcs = new Set<string>();
+
+  const slides: Record<string, unknown>[] = [];
+  let motionIndex = 0;
+
+  for (let i = 0; i < flat.length; i++) {
+    const block = flat[i];
+    const blockImages = extractBlockImages(block.contents);
+    const slide = blockToSlide(block, i);
+
+    if (blockImages.length > 0 && slide.template === 'sectionHeader') {
+      const img = blockImages[0];
+      usedImageSrcs.add(img.src);
+      slide.template = 'imageWithCaption';
+      slide.imageSrc = img.src;
+      slide.imageAlt = img.alt;
+      slide.caption = slide.title as string;
+      slide.captionPosition = 'bottom';
+      slide.ambientMotion = IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length];
+    } else if (blockImages.length > 0) {
+      const img = blockImages[0];
+      usedImageSrcs.add(img.src);
+      if (!slide.accentImage) {
+        slide.accentImage = {
+          src: img.src,
+          alt: img.alt,
+          position: 'left-strip',
+          ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
+        };
+      }
+    }
+
+    slides.push(slide);
+  }
+
+  // Interleave unused images
+  const unusedImages = allImages.filter((img) => !usedImageSrcs.has(img.src));
+  if (unusedImages.length > 0 && slides.length > 0) {
+    const interval = Math.max(2, Math.floor(slides.length / (unusedImages.length + 1)));
+    let insertOffset = 0;
+    for (let imgIdx = 0; imgIdx < unusedImages.length; imgIdx++) {
+      const insertAt = Math.min((imgIdx + 1) * interval + insertOffset, slides.length);
+      const img = unusedImages[imgIdx];
+      slides.splice(insertAt, 0, {
+        id: `img-interleave-${imgIdx}`,
+        template: 'imageWithCaption',
+        duration: 5,
+        audioSegment: 0,
+        imageSrc: img.src,
+        imageAlt: img.alt,
+        ambientMotion: IMAGE_MOTIONS[motionIndex++ % IMAGE_MOTIONS.length],
+        transition: { type: 'fade', duration: 0.5 },
+      });
+      insertOffset++;
+    }
+  }
+
+  // Recalculate timing
+  let t = 0;
+  for (const slide of slides) {
+    slide.startTime = t;
+    t += slide.duration as number;
+  }
+
+  return {
+    articleId: doc.articleId,
+    duration: t,
+    blocks: slides as unknown as Block[],
+    audio: {
+      segments: t > 0 ? [{ src: '', name: 'preview', duration: t, startTime: 0 }] : [],
+    },
+    ...(doc.captions ? { captions: doc.captions } : {}),
+    ...(doc.startBlock ? { startBlock: doc.startBlock } : {}),
+    ...(doc.themeId ? { themeId: doc.themeId } : {}),
+  };
+}

package/src/index.ts

@@ -83,5 +83,8 @@ export {
 // Bridge utilities
 export { markdownToTiptap, tiptapToMarkdown } from './tiptapBridge.js';
 
+// Slideshow builder (shared between PreviewPanel and export flows)
+export { buildPreviewDoc } from './buildPreviewDoc.js';
+
 // Tiptap extension: Heading with template annotation support
 export { HeadingWithTemplate } from './TemplateAnnotation.js';