@bendyline/squisq 1.4.0 → 1.5.0

package/dist/doc/markdownToDoc.js

@@ -1,432 +0,0 @@
-/**
- * Markdown → Doc Conversion
- *
- * Converts a MarkdownDocument into a hierarchical Doc whose Block tree
- * mirrors the heading structure of the markdown. Every heading (H1–H6)
- * becomes a Block; body content between headings populates `contents`;
- * sub-headings nest as `children`.
- *
- * This enables using BlockTemplates to supply alternate visualizations
- * for each section of a markdown document.
- *
- * @example
- * ```ts
- * import { parseMarkdown } from '@bendyline/squisq/markdown';
- * import { markdownToDoc } from '@bendyline/squisq/doc';
- *
- * const md = parseMarkdown('# Intro\n\nHello world\n\n## Details\n\nMore text');
- * const doc = markdownToDoc(md);
- * // doc.blocks[0].sourceHeading.depth === 1  ("# Intro")
- * // doc.blocks[0].contents  → [paragraph("Hello world")]
- * // doc.blocks[0].children[0].sourceHeading.depth === 2  ("## Details")
- * ```
- */
-import { extractPlainText } from '../markdown/utils.js';
-import { estimateReadingTime } from '../timing/readingTime.js';
-import { resolveTemplateName } from './templates/index.js';
-// ============================================
-// ID Generation
-// ============================================
-/**
- * Convert text to a URL-friendly slug.
- * "Getting Started & More" → "getting-started-more"
- */
-const SLUG_NON_WORD_RE = /[^\w\s-]/g;
-const SLUG_SPACES_RE = /[\s_]+/g;
-const SLUG_MULTI_HYPHEN_RE = /-+/g;
-const SLUG_TRIM_HYPHEN_RE = /^-|-$/g;
-function slugify(text) {
-    return (text
-        .toLowerCase()
-        .replace(SLUG_NON_WORD_RE, '') // Remove non-word chars (except spaces and hyphens)
-        .replace(SLUG_SPACES_RE, '-') // Replace spaces/underscores with hyphens
-        .replace(SLUG_MULTI_HYPHEN_RE, '-') // Collapse multiple hyphens
-        .replace(SLUG_TRIM_HYPHEN_RE, '') || // Trim leading/trailing hyphens
-        'block'); // Fallback for empty result
-}
-/**
- * Creates an ID generator that produces unique slugified IDs.
- * Appends -2, -3, etc. for duplicate headings.
- */
-function createIdGenerator() {
-    const used = new Map();
-    return (heading, _index) => {
-        const text = extractPlainText(heading);
-        const base = slugify(text);
-        const count = used.get(base) ?? 0;
-        used.set(base, count + 1);
-        if (count === 0)
-            return base;
-        return `${base}-${count + 1}`;
-    };
-}
-// ============================================
-// Core Conversion
-// ============================================
-/**
- * Convert a MarkdownDocument into a Doc with a heading-driven Block hierarchy.
- *
- * **Algorithm:**
- * 1. Walk the document's top-level children sequentially
- * 2. Each MarkdownHeading starts a new block at its depth level
- * 3. Non-heading nodes accumulate as `contents` on the current block
- * 4. Sub-headings (deeper depth) nest as `children` of the current block
- * 5. Same-level or shallower headings close the current block and start a sibling/ancestor
- * 6. Content before the first heading goes into a "preamble" block with no sourceHeading
- *
- * @param markdownDoc - A parsed MarkdownDocument
- * @param options - Conversion options
- * @returns A Doc whose blocks mirror the markdown heading structure
- */
-export function markdownToDoc(markdownDoc, options) {
-    const articleId = options?.articleId ?? 'markdown-doc';
-    const defaultTemplate = options?.defaultTemplate ?? 'sectionHeader';
-    const defaultDuration = options?.defaultDuration ?? 5;
-    const generateId = options?.generateId ?? createIdGenerator();
-    const rootBlocks = [];
-    let headingIndex = 0;
-    // Stack tracks the nesting context: each entry is a block and its heading depth.
-    // We push when we go deeper, pop when we come back up.
-    const stack = [];
-    // Accumulator for content nodes that appear before any heading (preamble)
-    // or between the current heading and the next heading/sub-heading.
-    let pendingContents = [];
-    let currentBlock = null;
-    function flushContents() {
-        if (currentBlock && pendingContents.length > 0) {
-            currentBlock.contents = (currentBlock.contents ?? []).concat(pendingContents);
-            pendingContents = [];
-        }
-    }
-    function makeBlock(heading) {
-        const id = heading ? generateId(heading, headingIndex++) : 'preamble';
-        // Use template from annotation if present, otherwise fall back to default.
-        // Legacy template ids (e.g. `titleBlock`) are normalized to their canonical
-        // short form (`title`) so downstream comparisons can rely on the new names
-        // without sprinkling alias resolution everywhere.
-        const annotation = heading?.templateAnnotation;
-        const rawTemplate = annotation?.template ?? (heading ? defaultTemplate : undefined);
-        const template = rawTemplate != null ? resolveTemplateName(rawTemplate) : undefined;
-        // Extract heading text so templates (e.g. sectionHeader) that expect a
-        // `title` property receive it without having to reach into sourceHeading.
-        const title = heading ? extractPlainText(heading) : undefined;
-        const block = {
-            id,
-            startTime: 0,
-            duration: defaultDuration,
-            audioSegment: 0,
-            template,
-            ...(heading ? { sourceHeading: heading } : {}),
-            ...(title ? { title } : {}),
-        };
-        // Propagate key-value params from annotation to templateOverrides
-        if (annotation?.params) {
-            block.templateOverrides = annotation.params;
-        }
-        return block;
-    }
-    for (const node of markdownDoc.children) {
-        if (node.type === 'heading') {
-            const heading = node;
-            const depth = heading.depth;
-            // Flush any accumulated content to the current block
-            flushContents();
-            // Create the new block for this heading
-            const newBlock = makeBlock(heading);
-            if (stack.length === 0) {
-                // If there's a preamble block with no heading, push it first
-                if (currentBlock && !currentBlock.sourceHeading) {
-                    rootBlocks.push(currentBlock);
-                }
-                // This is a root-level block (or the first heading)
-                rootBlocks.push(newBlock);
-                stack.push({ block: newBlock, depth });
-            }
-            else {
-                // Find where this heading fits in the hierarchy
-                // Pop blocks from the stack until we find a parent with lower depth
-                while (stack.length > 0 && stack[stack.length - 1].depth >= depth) {
-                    stack.pop();
-                }
-                if (stack.length === 0) {
-                    // Same level as root or shallower — new root block
-                    rootBlocks.push(newBlock);
-                    stack.push({ block: newBlock, depth });
-                }
-                else {
-                    // Deeper — child of the current stack top
-                    const parent = stack[stack.length - 1].block;
-                    if (!parent.children)
-                        parent.children = [];
-                    parent.children.push(newBlock);
-                    stack.push({ block: newBlock, depth });
-                }
-            }
-            currentBlock = newBlock;
-        }
-        else {
-            // Non-heading block node — accumulate as content
-            if (!currentBlock) {
-                // Content before any heading → create preamble block
-                currentBlock = makeBlock(null);
-            }
-            pendingContents.push(node);
-        }
-    }
-    // Flush remaining content
-    flushContents();
-    // If we only had preamble content (no headings at all), push it
-    if (currentBlock && !currentBlock.sourceHeading && !rootBlocks.includes(currentBlock)) {
-        rootBlocks.push(currentBlock);
-    }
-    // Calculate reading-time-based durations and generate captions
-    const allBlocks = flattenBlocks(rootBlocks);
-    const minDuration = 3; // seconds — minimum for blocks with little/no text
-    const phrases = [];
-    // First pass: compute duration from body-content reading time
-    for (const block of allBlocks) {
-        const bodyText = getBlockBodyText(block);
-        if (bodyText.length > 0) {
-            const estimate = estimateReadingTime(bodyText);
-            block.duration = Math.max(minDuration, estimate.seconds);
-        }
-        else {
-            block.duration = defaultDuration;
-        }
-    }
-    // Second pass: assign start times sequentially and build caption phrases
-    let currentTime = 0;
-    for (const block of allBlocks) {
-        block.startTime = currentTime;
-        // Generate caption phrases from the block's body content
-        const bodyText = getBlockBodyText(block);
-        if (bodyText.length > 0) {
-            const sentences = splitIntoSentences(bodyText);
-            if (sentences.length > 0) {
-                const timePerSentence = block.duration / sentences.length;
-                for (let i = 0; i < sentences.length; i++) {
-                    phrases.push({
-                        text: sentences[i],
-                        startTime: currentTime + i * timePerSentence,
-                        endTime: currentTime + (i + 1) * timePerSentence,
-                        audioSegment: 0,
-                    });
-                }
-            }
-        }
-        currentTime += block.duration;
-    }
-    const captions = phrases.length > 0 ? { phrases, generatedAt: new Date().toISOString(), version: 1 } : undefined;
-    const doc = {
-        articleId,
-        duration: currentTime,
-        blocks: rootBlocks,
-        audio: {
-            segments: [],
-        },
-        ...(captions ? { captions } : {}),
-        ...(markdownDoc.frontmatter ? { frontmatter: markdownDoc.frontmatter } : {}),
-    };
-    // Auto-generate cover startBlock from the first H1 heading
-    if (options?.generateCoverBlock ?? true) {
-        const coverConfig = buildStartBlock(markdownDoc, rootBlocks);
-        if (coverConfig) {
-            doc.startBlock = coverConfig;
-        }
-    }
-    return doc;
-}
-// ============================================
-// Utilities
-// ============================================
-/**
- * Flatten a nested block tree into a depth-first ordered array.
- * Useful for calculating sequential timing or iterating all blocks.
- */
-export function flattenBlocks(blocks) {
-    const result = [];
-    for (const block of blocks) {
-        result.push(block);
-        if (block.children) {
-            result.push(...flattenBlocks(block.children));
-        }
-    }
-    return result;
-}
-/**
- * Count the total number of blocks in a nested tree (including children at all levels).
- */
-export function countBlocks(blocks) {
-    let count = 0;
-    for (const block of blocks) {
-        count += 1;
-        if (block.children) {
-            count += countBlocks(block.children);
-        }
-    }
-    return count;
-}
-/**
- * Get the heading depth for a block. Returns 0 for preamble blocks (no heading).
- */
-export function getBlockDepth(block) {
-    return block.sourceHeading?.depth ?? 0;
-}
-// ============================================
-// Internal helpers
-// ============================================
-/**
- * Extract the plain text from a block's body contents (excluding heading text).
- */
-function getBlockBodyText(block) {
-    if (!block.contents || block.contents.length === 0)
-        return '';
-    // Join with newlines to preserve paragraph/list-item boundaries.
-    // splitIntoPhrases uses these newlines as natural split points.
-    return block.contents
-        .map((node) => extractPlainText(node))
-        .join('\n')
-        .trim();
-}
-/** Maximum words per caption phrase. Long sentences get split at this point. */
-const MAX_PHRASE_WORDS = 12;
-/**
- * Split text into caption-sized phrases.
- *
- * Splits on:
- * 1. Newlines (paragraph/list-item boundaries from markdown)
- * 2. Sentence endings (.!?) followed by whitespace
- * 3. Long fragments (> MAX_PHRASE_WORDS) at clause boundaries (commas, semicolons, dashes)
- *
- * Merges very short fragments (< 15 chars) with the previous phrase.
- */
-function splitIntoSentences(text) {
-    // First split on newlines (each paragraph/list item becomes separate)
-    const lines = text
-        .split(/\n+/)
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-    // Then split each line on sentence boundaries
-    const sentenceRe = /(?<=[.!?])\s+/;
-    const fragments = [];
-    for (const line of lines) {
-        const sentences = line
-            .split(sentenceRe)
-            .map((s) => s.trim())
-            .filter((s) => s.length > 0);
-        fragments.push(...sentences);
-    }
-    if (fragments.length === 0)
-        return [];
-    // Split long fragments at clause boundaries
-    const split = [];
-    for (const frag of fragments) {
-        const words = frag.split(/\s+/);
-        if (words.length > MAX_PHRASE_WORDS) {
-            // Try to split at comma, semicolon, or dash near the midpoint
-            const mid = Math.floor(frag.length / 2);
-            const clauseRe = /[,;]\s+|\s+—\s+|\s+-\s+/g;
-            let bestSplit = -1;
-            let bestDist = Infinity;
-            let match;
-            while ((match = clauseRe.exec(frag)) !== null) {
-                const dist = Math.abs(match.index - mid);
-                if (dist < bestDist) {
-                    bestDist = dist;
-                    bestSplit = match.index + match[0].length;
-                }
-            }
-            if (bestSplit > 0 && bestSplit < frag.length - 5) {
-                split.push(frag.slice(0, bestSplit).trim());
-                split.push(frag.slice(bestSplit).trim());
-            }
-            else {
-                split.push(frag);
-            }
-        }
-        else {
-            split.push(frag);
-        }
-    }
-    // Merge very short fragments (< 15 chars) with the previous phrase
-    const merged = [split[0]];
-    for (let i = 1; i < split.length; i++) {
-        if (split[i].length < 15 && merged.length > 0) {
-            merged[merged.length - 1] += ' ' + split[i];
-        }
-        else {
-            merged.push(split[i]);
-        }
-    }
-    return merged;
-}
-/**
- * Walk a parsed HTML sub-tree depth-first for an `<img>` with a `src`.
- * Used to surface images that the WYSIWYG editor serialized as raw HTML
- * (e.g. when an image was resized — markdown's `![alt](url)` shorthand
- * has no width syntax, so resized images round-trip as `<img src width>`).
- */
-function findFirstHtmlImage(nodes) {
-    for (const node of nodes) {
-        if (node.type !== 'htmlElement')
-            continue;
-        if (node.tagName === 'img' && node.attributes.src) {
-            return { url: node.attributes.src, alt: node.attributes.alt };
-        }
-        const nested = findFirstHtmlImage(node.children);
-        if (nested)
-            return nested;
-    }
-    return undefined;
-}
-/**
- * Walk a MarkdownNode tree depth-first to find the first image reference,
- * whether expressed as a markdown image node or a raw HTML `<img>` tag.
- */
-function findFirstImage(node) {
-    if (node.type === 'image') {
-        const img = node;
-        return { url: img.url, alt: img.alt };
-    }
-    if (node.type === 'htmlBlock' || node.type === 'htmlInline') {
-        const html = node;
-        if (html.htmlChildren) {
-            const found = findFirstHtmlImage(html.htmlChildren);
-            if (found)
-                return found;
-        }
-    }
-    if ('children' in node && Array.isArray(node.children)) {
-        for (const child of node.children) {
-            const found = findFirstImage(child);
-            if (found)
-                return found;
-        }
-    }
-    return undefined;
-}
-/**
- * Build a StartBlockConfig from the document's first H1 heading and optional
- * first image. Returns undefined if the document has no H1 heading.
- */
-function buildStartBlock(markdownDoc, rootBlocks) {
-    // Find the first H1 block — it provides the cover title
-    const firstH1 = rootBlocks.find((b) => b.sourceHeading?.depth === 1);
-    if (!firstH1)
-        return undefined;
-    const title = firstH1.title ?? extractPlainText(firstH1.sourceHeading);
-    if (!title)
-        return undefined;
-    // Look for the first paragraph immediately after the H1 to use as subtitle
-    const subtitle = firstH1.contents?.[0]?.type === 'paragraph' ? extractPlainText(firstH1.contents[0]) : undefined;
-    // Scan the whole document for the first image to use as the hero
-    const firstImage = findFirstImage(markdownDoc);
-    const config = {
-        title,
-        ...(subtitle ? { subtitle } : {}),
-        ...(firstImage ? { heroSrc: firstImage.url, heroAlt: firstImage.alt ?? title } : {}),
-        ambientMotion: 'zoomIn',
-    };
-    return config;
-}
-//# sourceMappingURL=markdownToDoc.js.map

package/dist/doc/markdownToDoc.js.map

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

package/dist/doc/templates/accentImage.d.ts

@@ -1,59 +0,0 @@
-/**
- * Accent Image Utility
- *
- * Creates image layers and layout adjustments for accent images on text-based slides.
- * Accent images are tasteful additions that complement text without overwhelming it.
- *
- * Layout patterns:
- * - left-strip: 35% width vertical strip on left, text area shifted to right 65%
- * - right-strip: 35% width vertical strip on right, text area shifted to left 65%
- * - bottom-strip: 35% height horizontal strip at bottom, text area in upper 65%
- * - corner-inset: Small 25% corner image with gradient vignette
- *
- * This is shared code used by both site and efb-app doc renderers.
- */
-import type { Layer, Animation } from '../../schemas/Doc.js';
-import type { AccentImage, AccentPosition } from '../../schemas/BlockTemplates.js';
-/**
- * Layout adjustments when an accent image is present.
- * Templates use these values to reposition their text content.
- */
-export interface AccentLayout {
-    /** X offset for text center (e.g., '64%' for left-strip) */
-    textCenterX: string;
-    /** Width available for text content */
-    textWidth: string;
-    /** Y offset adjustment for vertical positioning */
-    textYAdjust: number;
-    /** Whether to adjust Y positions (for bottom-strip) */
-    adjustY: boolean;
-}
-/**
- * Default layout when no accent image is present.
- */
-export declare const DEFAULT_LAYOUT: AccentLayout;
-/**
- * Map ambientMotion values to proper Ken Burns animations.
- * Uses slowZoom variants which provide smooth pan/zoom without opacity changes.
- * Supports both standard values ('zoomIn', 'panLeft', etc.) and legacy
- * aliases ('in', 'out', 'left', 'right') for backward compatibility.
- *
- * @param motion - The ambient motion value (e.g., 'zoomIn', 'panLeft')
- * @param duration - Optional animation duration in seconds
- */
-export declare function mapAmbientMotion(motion: string | undefined, duration?: number): Animation | undefined;
-/**
- * Get layout adjustments based on accent position.
- */
-export declare function getAccentLayout(position: AccentPosition): AccentLayout;
-/**
- * Create layers for an accent image.
- * Returns the image layer and any overlay/gradient layers needed.
- */
-export declare function createAccentLayers(accent: AccentImage, slideId: string): Layer[];
-/**
- * Adjust a Y position value based on accent layout.
- * Used by templates to shift content when bottom-strip is present.
- */
-export declare function adjustY(originalY: string | number, layout: AccentLayout): string;
-//# sourceMappingURL=accentImage.d.ts.map

package/dist/doc/templates/accentImage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"accentImage.d.ts","sourceRoot":"","sources":["../../../src/doc/templates/accentImage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAA0B,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAInF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAK5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,CAmBvB;AASD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,CAiCtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CA2BhF;AAmKD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAgBhF"}