@bendyline/squisq 1.4.0 → 1.5.0

package/dist/doc/docToMarkdown.js

@@ -1,88 +0,0 @@
-/**
- * Doc → Markdown Conversion
- *
- * Converts a Doc with a heading-driven Block hierarchy back into a
- * MarkdownDocument. This is the reverse of markdownToDoc() and enables
- * round-tripping: edit a Doc's block tree, then serialize back to markdown.
- *
- * **Algorithm:**
- * Walk the block tree depth-first. For each block:
- * 1. If it has a `sourceHeading`, emit that heading node
- * 2. Emit all nodes in `contents`
- * 3. Recurse into `children`
- *
- * @example
- * ```ts
- * import { markdownToDoc, docToMarkdown } from '@bendyline/squisq/doc';
- * import { parseMarkdown, stringifyMarkdown } from '@bendyline/squisq/markdown';
- *
- * const md = '# Hello\n\nWorld\n';
- * const doc = markdownToDoc(parseMarkdown(md));
- * const roundTripped = stringifyMarkdown(docToMarkdown(doc));
- * ```
- */
-/**
- * Convert a Doc with heading-driven blocks back to a MarkdownDocument.
- *
- * Walks the block tree depth-first, emitting heading nodes and contents
- * in document order. Blocks without a `sourceHeading` (preamble blocks)
- * emit only their contents.
- *
- * If a block has a `template` or `templateOverrides` that aren't already
- * reflected in the heading's `templateAnnotation`, the annotation is
- * injected so the round-trip preserves template assignments.
- *
- * @param doc - A Doc whose blocks may have `sourceHeading`, `contents`, and `children`
- * @returns A MarkdownDocument that can be stringified back to markdown
- */
-export function docToMarkdown(doc) {
-    const children = [];
-    function emitBlock(block) {
-        // Emit the heading node if present
-        if (block.sourceHeading) {
-            const heading = ensureAnnotation(block, block.sourceHeading);
-            children.push(heading);
-        }
-        // Emit body content
-        if (block.contents) {
-            children.push(...block.contents);
-        }
-        // Recurse into children (sub-headings)
-        if (block.children) {
-            for (const child of block.children) {
-                emitBlock(child);
-            }
-        }
-    }
-    for (const block of doc.blocks) {
-        emitBlock(block);
-    }
-    return {
-        type: 'document',
-        children,
-    };
-}
-/**
- * Ensure the heading's `templateAnnotation` reflects the block's
- * template and templateOverrides. Returns a (possibly cloned) heading.
- */
-function ensureAnnotation(block, heading) {
-    // If the heading already has an annotation, trust it (it came from parsing)
-    if (heading.templateAnnotation)
-        return heading;
-    // If the block has a non-default template or overrides, inject an annotation
-    const hasExplicitTemplate = block.template && block.template !== 'sectionHeader';
-    const hasOverrides = block.templateOverrides && Object.keys(block.templateOverrides).length > 0;
-    if (!hasExplicitTemplate && !hasOverrides)
-        return heading;
-    // Clone to avoid mutating the original
-    return {
-        ...heading,
-        children: [...heading.children],
-        templateAnnotation: {
-            template: block.template ?? 'sectionHeader',
-            ...(hasOverrides ? { params: block.templateOverrides } : {}),
-        },
-    };
-}
-//# sourceMappingURL=docToMarkdown.js.map

package/dist/doc/docToMarkdown.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"docToMarkdown.js","sourceRoot":"","sources":["../../src/doc/docToMarkdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,MAAM,QAAQ,GAAwB,EAAE,CAAC;IAEzC,SAAS,SAAS,CAAC,KAAY;QAC7B,mCAAmC;QACnC,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,oBAAoB;QACpB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,uCAAuC;QACvC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAAY,EAAE,OAAwB;IAC9D,4EAA4E;IAC5E,IAAI,OAAO,CAAC,kBAAkB;QAAE,OAAO,OAAO,CAAC;IAE/C,6EAA6E;IAC7E,MAAM,mBAAmB,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,CAAC;IACjF,MAAM,YAAY,GAAG,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAEhG,IAAI,CAAC,mBAAmB,IAAI,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC;IAE1D,uCAAuC;IACvC,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC/B,kBAAkB,EAAE;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,eAAe;YAC3C,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D;KACF,CAAC;AACJ,CAAC"}

package/dist/doc/getLayers.d.ts

@@ -1,65 +0,0 @@
-/**
- * getLayers — Compute visual layers for a block on demand.
- *
- * This is the preferred way to obtain renderable layers for a block.
- * Instead of storing pre-computed layers on the Block object, call
- * `getLayers(block, context)` to derive them from the block's template
- * name, content, and the current render context (theme, viewport, etc.).
- *
- * For raw blocks that already carry a `layers` array, those layers are
- * returned directly (with optional persistent layer injection).
- *
- * @example
- * ```ts
- * import { getLayers } from '@bendyline/squisq/doc';
- *
- * const layers = getLayers(block, {
- *   theme: DEFAULT_THEME,
- *   viewport: VIEWPORT_PRESETS.landscape,
- *   blockIndex: 0,
- *   totalBlocks: 10,
- * });
- * ```
- */
-import type { Layer } from '../schemas/Doc.js';
-import type { PersistentLayerConfig, DocBlock } from '../schemas/BlockTemplates.js';
-import type { Theme } from '../schemas/Theme.js';
-import type { ViewportConfig } from '../schemas/Viewport.js';
-/**
- * Context needed to compute layers for a block.
- *
- * Captures the visual rendering parameters: theme colors, viewport
- * configuration, persistent layers, and the block's position within
- * the doc (for template functions that vary output by index).
- */
-export interface RenderContext {
-    /** Theme for template rendering. Defaults to DEFAULT_THEME (documentary). */
-    theme?: Theme;
-    /** Target viewport configuration. Defaults to 16:9 landscape. */
-    viewport?: ViewportConfig;
-    /** Persistent layers injected behind and/or on top of all block content. */
-    persistentLayers?: PersistentLayerConfig;
-    /** 0-based index of this block in the sequence. Defaults to 0. */
-    blockIndex?: number;
-    /** Total number of blocks in the doc. Defaults to 1. */
-    totalBlocks?: number;
-}
-/**
- * Compute the visual layers for a block.
- *
- * Resolution order:
- * 1. If the block already has a non-empty `layers` array, use it (raw block).
- * 2. If the block has a `template` name that exists in the registry,
- *    call the template function to generate layers.
- * 3. Otherwise return an empty array.
- *
- * Persistent layers (bottom/top) from the render context are injected
- * around the result unless the block opts out via `useBottomLayer: false`
- * or `useTopLayer: false`.
- *
- * @param block   A Block or TemplateBlock to render.
- * @param context Render context (theme, viewport, persistent layers, position).
- * @returns The computed Layer[] for the block, ready for BlockRenderer.
- */
-export declare function getLayers(block: DocBlock, context?: RenderContext): Layer[];
-//# sourceMappingURL=getLayers.d.ts.map

package/dist/doc/getLayers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getLayers.d.ts","sourceRoot":"","sources":["../../src/doc/getLayers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAS,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAGV,qBAAqB,EACrB,QAAQ,EACT,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAW7D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAEzC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,aAAkB,GAAG,KAAK,EAAE,CAkD/E"}

package/dist/doc/getLayers.js

@@ -1,114 +0,0 @@
-/**
- * getLayers — Compute visual layers for a block on demand.
- *
- * This is the preferred way to obtain renderable layers for a block.
- * Instead of storing pre-computed layers on the Block object, call
- * `getLayers(block, context)` to derive them from the block's template
- * name, content, and the current render context (theme, viewport, etc.).
- *
- * For raw blocks that already carry a `layers` array, those layers are
- * returned directly (with optional persistent layer injection).
- *
- * @example
- * ```ts
- * import { getLayers } from '@bendyline/squisq/doc';
- *
- * const layers = getLayers(block, {
- *   theme: DEFAULT_THEME,
- *   viewport: VIEWPORT_PRESETS.landscape,
- *   blockIndex: 0,
- *   totalBlocks: 10,
- * });
- * ```
- */
-import { VIEWPORT_PRESETS } from '../schemas/Viewport.js';
-import { createTemplateContext, isTemplateBlock } from '../schemas/BlockTemplates.js';
-import { DEFAULT_THEME } from '../schemas/themeLibrary.js';
-import { templateRegistry, resolveTemplateName } from './templates/index.js';
-import { expandPersistentLayers } from './templates/persistentLayers.js';
-// ============================================
-// getLayers
-// ============================================
-/**
- * Compute the visual layers for a block.
- *
- * Resolution order:
- * 1. If the block already has a non-empty `layers` array, use it (raw block).
- * 2. If the block has a `template` name that exists in the registry,
- *    call the template function to generate layers.
- * 3. Otherwise return an empty array.
- *
- * Persistent layers (bottom/top) from the render context are injected
- * around the result unless the block opts out via `useBottomLayer: false`
- * or `useTopLayer: false`.
- *
- * @param block   A Block or TemplateBlock to render.
- * @param context Render context (theme, viewport, persistent layers, position).
- * @returns The computed Layer[] for the block, ready for BlockRenderer.
- */
-export function getLayers(block, context = {}) {
-    const theme = context.theme ?? DEFAULT_THEME;
-    const viewport = context.viewport ?? VIEWPORT_PRESETS.landscape;
-    const blockIndex = context.blockIndex ?? 0;
-    const totalBlocks = context.totalBlocks ?? 1;
-    // 1. Raw block path: block already has pre-computed layers
-    const existingLayers = block.layers;
-    if (existingLayers && existingLayers.length > 0 && !isTemplateBlock(block)) {
-        return injectPersistentLayers(existingLayers, block, context);
-    }
-    // 2. Template path: look up and call the template function.
-    //
-    // Resolve through TEMPLATE_ALIASES so legacy ids (`titleBlock`,
-    // `quoteBlock`, `mapBlock`, `listBlock`) hit the registry by their
-    // canonical short names. Without this the block-section path renders
-    // an empty SVG card: `hasTemplate()` accepts the alias (so
-    // `isAnnotatedBlock` returns true and the card wrapper renders), but
-    // a raw `block.template in templateRegistry` check below misses it
-    // and the layer list comes back empty.
-    if (isTemplateBlock(block)) {
-        const resolved = resolveTemplateName(block.template);
-        if (resolved in templateRegistry) {
-            const templateName = resolved;
-            const templateCtx = createTemplateContext(theme, blockIndex, totalBlocks, viewport);
-            let layers;
-            try {
-                // Each registry entry accepts its specific TemplateBlock variant; the
-                // discriminated union guarantees the shapes match at runtime.
-                const templateFn = templateRegistry[templateName];
-                layers = templateFn(block, templateCtx);
-                if (!Array.isArray(layers)) {
-                    console.error(`Template ${templateName} did not return an array, got:`, typeof layers);
-                    layers = [];
-                }
-            }
-            catch (err) {
-                console.error(`Error expanding template ${templateName}:`, err);
-                layers = [];
-            }
-            return injectPersistentLayers(layers, block, context);
-        }
-    }
-    // 3. Fallback: no layers and no known template
-    return injectPersistentLayers([], block, context);
-}
-// ============================================
-// Internal helpers
-// ============================================
-/**
- * Inject persistent bottom/top layers around the block's own layers,
- * respecting per-block opt-out flags.
- */
-function injectPersistentLayers(layers, block, context) {
-    const { persistentLayers } = context;
-    if (!persistentLayers)
-        return layers;
-    const bottomLayers = expandPersistentLayers(persistentLayers.bottomLayers);
-    const topLayers = expandPersistentLayers(persistentLayers.topLayers);
-    if (bottomLayers.length === 0 && topLayers.length === 0)
-        return layers;
-    const templateBlock = block;
-    const useBottom = templateBlock.useBottomLayer !== false;
-    const useTop = templateBlock.useTopLayer !== false;
-    return [...(useBottom ? bottomLayers : []), ...layers, ...(useTop ? topLayers : [])];
-}
-//# sourceMappingURL=getLayers.js.map

package/dist/doc/getLayers.js.map

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

package/dist/doc/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doc/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9F,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/doc/markdownToDoc.d.ts

@@ -1,75 +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 type { Doc, Block } from '../schemas/Doc.js';
-import type { MarkdownDocument, MarkdownHeading } from '../markdown/types.js';
-/**
- * Options for markdownToDoc().
- */
-export interface MarkdownToDocOptions {
-    /** Article ID for the generated Doc. Default: 'markdown-doc' */
-    articleId?: string;
-    /** Default template name for heading blocks. Default: 'sectionHeader' */
-    defaultTemplate?: string;
-    /** Default duration per block in seconds. Default: 5 */
-    defaultDuration?: number;
-    /** Custom ID generator. Receives the heading node and its index. */
-    generateId?: (heading: MarkdownHeading, index: number) => string;
-    /**
-     * Whether to auto-generate a cover startBlock from the first H1 heading.
-     * When true (default), a StartBlockConfig is created using the first H1's
-     * text as the title. If the document contains an image, the first image
-     * is used as the hero. Set to false to suppress automatic cover generation.
-     */
-    generateCoverBlock?: boolean;
-}
-/**
- * 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 declare function markdownToDoc(markdownDoc: MarkdownDocument, options?: MarkdownToDocOptions): Doc;
-/**
- * Flatten a nested block tree into a depth-first ordered array.
- * Useful for calculating sequential timing or iterating all blocks.
- */
-export declare function flattenBlocks(blocks: Block[]): Block[];
-/**
- * Count the total number of blocks in a nested tree (including children at all levels).
- */
-export declare function countBlocks(blocks: Block[]): number;
-/**
- * Get the heading depth for a block. Returns 0 for preamble blocks (no heading).
- */
-export declare function getBlockDepth(block: Block): number;
-//# sourceMappingURL=markdownToDoc.d.ts.map

package/dist/doc/markdownToDoc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"markdownToDoc.d.ts","sourceRoot":"","sources":["../../src/doc/markdownToDoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAiD,MAAM,mBAAmB,CAAC;AACnG,OAAO,KAAK,EACV,gBAAgB,EAEhB,eAAe,EAGhB,MAAM,sBAAsB,CAAC;AAS9B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAEjE;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAiDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,GAAG,CAqLhG;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAStD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CASnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAElD"}