@bendyline/squisq 2.1.0 → 2.3.0

package/src/__tests__/markdownToDoc.test.ts

@@ -1,957 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { parseMarkdown, stringifyMarkdown } from '../markdown/index';
-import type { MarkdownText } from '../markdown/types';
-import { markdownToDoc, flattenBlocks, countBlocks, getBlockDepth } from '../doc/markdownToDoc';
-import { docToMarkdown } from '../doc/docToMarkdown';
-
-// Helper: parse markdown and return the first top-level block.
-function firstHeadingBlock(md: string) {
-  const parsed = parseMarkdown(md);
-  const doc = markdownToDoc(parsed, { articleId: 'test', generateCoverBlock: false });
-  return doc.blocks[0];
-}
-
-// Helper: strip positions from markdown nodes for cleaner assertions
-function stripPositions(obj: unknown): unknown {
-  if (obj === null || obj === undefined) return obj;
-  if (typeof obj !== 'object') return obj;
-  if (Array.isArray(obj)) return obj.map(stripPositions);
-  const result: Record<string, unknown> = {};
-  for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {
-    if (key === 'position') continue;
-    result[key] = stripPositions(value);
-  }
-  return result;
-}
-
-describe('markdownToDoc', () => {
-  it('converts a simple heading + paragraph into a single block', () => {
-    const md = parseMarkdown('# Title\n\nHello world');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(1);
-    expect(doc.blocks[0].id).toBe('title');
-    expect(doc.blocks[0].sourceHeading).toBeDefined();
-    expect(doc.blocks[0].sourceHeading!.depth).toBe(1);
-    expect(doc.blocks[0].contents).toHaveLength(1);
-    expect(doc.blocks[0].contents![0].type).toBe('paragraph');
-  });
-
-  it('creates preamble block for content before first heading', () => {
-    const md = parseMarkdown('Some intro text\n\n# First Heading\n\nBody');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(2);
-    // Preamble block
-    expect(doc.blocks[0].id).toBe('preamble');
-    expect(doc.blocks[0].sourceHeading).toBeUndefined();
-    expect(doc.blocks[0].contents).toHaveLength(1);
-    expect(doc.blocks[0].contents![0].type).toBe('paragraph');
-    // Heading block
-    expect(doc.blocks[1].sourceHeading).toBeDefined();
-    expect(doc.blocks[1].contents).toHaveLength(1);
-  });
-
-  it('nests H2 under H1 as children', () => {
-    const md = parseMarkdown(
-      '# Chapter\n\nIntro\n\n## Section A\n\nContent A\n\n## Section B\n\nContent B',
-    );
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(1); // One root block (H1)
-    const root = doc.blocks[0];
-    expect(root.sourceHeading!.depth).toBe(1);
-    expect(root.contents).toHaveLength(1); // "Intro" paragraph
-
-    expect(root.children).toHaveLength(2);
-    expect(root.children![0].sourceHeading!.depth).toBe(2);
-    expect(root.children![0].contents).toHaveLength(1); // "Content A"
-    expect(root.children![1].sourceHeading!.depth).toBe(2);
-    expect(root.children![1].contents).toHaveLength(1); // "Content B"
-  });
-
-  it('handles same-level headings as siblings', () => {
-    const md = parseMarkdown('## A\n\nText A\n\n## B\n\nText B\n\n## C\n\nText C');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(3);
-    expect(doc.blocks[0].id).toBe('a');
-    expect(doc.blocks[1].id).toBe('b');
-    expect(doc.blocks[2].id).toBe('c');
-  });
-
-  it('handles deep nesting H1→H2→H3→H4→H5→H6', () => {
-    const md = parseMarkdown(
-      '# L1\n\n## L2\n\n### L3\n\n#### L4\n\n##### L5\n\n###### L6\n\nDeep content',
-    );
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(1); // One root
-    let block = doc.blocks[0];
-    for (let depth = 1; depth <= 5; depth++) {
-      expect(block.sourceHeading!.depth).toBe(depth);
-      expect(block.children).toHaveLength(1);
-      block = block.children![0];
-    }
-    expect(block.sourceHeading!.depth).toBe(6);
-    expect(block.contents).toHaveLength(1);
-    expect(block.children).toBeUndefined();
-  });
-
-  it('handles mixed content between headings', () => {
-    const md = parseMarkdown(
-      '# Title\n\nParagraph\n\n- Item 1\n- Item 2\n\n```js\ncode\n```\n\n> Quote',
-    );
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks[0].contents).toHaveLength(4); // paragraph, list, code, blockquote
-    expect(doc.blocks[0].contents![0].type).toBe('paragraph');
-    expect(doc.blocks[0].contents![1].type).toBe('list');
-    expect(doc.blocks[0].contents![2].type).toBe('code');
-    expect(doc.blocks[0].contents![3].type).toBe('blockquote');
-  });
-
-  it('deduplicates IDs for duplicate headings', () => {
-    const md = parseMarkdown('# Intro\n\n# Intro\n\n# Intro');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(3);
-    expect(doc.blocks[0].id).toBe('intro');
-    expect(doc.blocks[1].id).toBe('intro-2');
-    expect(doc.blocks[2].id).toBe('intro-3');
-  });
-
-  it('handles empty document', () => {
-    const md = parseMarkdown('');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(0);
-    expect(doc.duration).toBe(0);
-  });
-
-  it('handles document with only content (no headings)', () => {
-    const md = parseMarkdown('Just some text\n\nAnd more text');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(1);
-    expect(doc.blocks[0].id).toBe('preamble');
-    expect(doc.blocks[0].sourceHeading).toBeUndefined();
-    expect(doc.blocks[0].contents).toHaveLength(2);
-  });
-
-  it('sets default template on heading blocks', () => {
-    const md = parseMarkdown('# Hello');
-    const doc = markdownToDoc(md);
-    expect(doc.blocks[0].template).toBe('sectionHeader');
-  });
-
-  it('respects custom options', () => {
-    const md = parseMarkdown('# Test');
-    const doc = markdownToDoc(md, {
-      articleId: 'custom-article',
-      defaultTemplate: 'title',
-      defaultDuration: 10,
-    });
-
-    expect(doc.articleId).toBe('custom-article');
-    expect(doc.blocks[0].template).toBe('title');
-    expect(doc.blocks[0].duration).toBe(10);
-  });
-
-  it('respects custom ID generator', () => {
-    const md = parseMarkdown('# Hello\n\n## World');
-    const doc = markdownToDoc(md, {
-      generateId: (_heading, index) => `block-${index}`,
-    });
-
-    expect(doc.blocks[0].id).toBe('block-0');
-    expect(doc.blocks[0].children![0].id).toBe('block-1');
-  });
-
-  it('calculates timing sequentially across all blocks', () => {
-    const md = parseMarkdown('# A\n\n## A1\n\n## A2\n\n# B');
-    const doc = markdownToDoc(md, { defaultDuration: 5 });
-
-    const flat = flattenBlocks(doc.blocks);
-    expect(flat).toHaveLength(4);
-    expect(flat[0].startTime).toBe(0); // # A
-    expect(flat[1].startTime).toBe(5); // ## A1
-    expect(flat[2].startTime).toBe(10); // ## A2
-    expect(flat[3].startTime).toBe(15); // # B
-    expect(doc.duration).toBe(20);
-  });
-
-  it('handles heading depth going back up (H3 → H1)', () => {
-    const md = parseMarkdown('# Top\n\n### Deep\n\nDeep content\n\n# Back to top\n\nTop content');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(2);
-    expect(doc.blocks[0].sourceHeading!.depth).toBe(1);
-    // H3 nests under H1 even though H2 was skipped
-    expect(doc.blocks[0].children).toHaveLength(1);
-    expect(doc.blocks[0].children![0].sourceHeading!.depth).toBe(3);
-    expect(doc.blocks[1].sourceHeading!.depth).toBe(1);
-    expect(doc.blocks[1].contents).toHaveLength(1);
-  });
-});
-
-describe('flattenBlocks', () => {
-  it('flattens nested blocks depth-first', () => {
-    const md = parseMarkdown('# A\n\n## A1\n\n### A1a\n\n## A2\n\n# B');
-    const doc = markdownToDoc(md);
-    const flat = flattenBlocks(doc.blocks);
-
-    expect(flat.map((b) => b.id)).toEqual(['a', 'a1', 'a1a', 'a2', 'b']);
-  });
-});
-
-describe('countBlocks', () => {
-  it('counts all blocks including nested children', () => {
-    const md = parseMarkdown('# A\n\n## A1\n\n### A1a\n\n## A2\n\n# B');
-    const doc = markdownToDoc(md);
-
-    expect(countBlocks(doc.blocks)).toBe(5);
-  });
-});
-
-describe('getBlockDepth', () => {
-  it('returns heading depth for heading blocks', () => {
-    const md = parseMarkdown('# Title');
-    const doc = markdownToDoc(md);
-    expect(getBlockDepth(doc.blocks[0])).toBe(1);
-  });
-
-  it('returns 0 for preamble blocks', () => {
-    const md = parseMarkdown('Just text');
-    const doc = markdownToDoc(md);
-    expect(getBlockDepth(doc.blocks[0])).toBe(0);
-  });
-});
-
-describe('docToMarkdown (round-trip)', () => {
-  it('converts a doc back to equivalent markdown', () => {
-    const input = '# Hello\n\nWorld\n\n## Details\n\nMore content\n';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-    const roundTripped = docToMarkdown(doc);
-
-    // The resulting MarkdownDocument should have the same structure
-    expect(stripPositions(roundTripped)).toEqual(stripPositions(md));
-  });
-
-  it('round-trips through stringify', () => {
-    const input = '# Intro\n\nParagraph one.\n\n## Sub\n\nParagraph two.\n';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-    const markdown2 = docToMarkdown(doc);
-    const output = stringifyMarkdown(markdown2);
-    // Parse again and compare ASTs
-    const md2 = parseMarkdown(output);
-    expect(stripPositions(md2)).toEqual(stripPositions(md));
-  });
-
-  it('round-trips inline coerced template params, keeping overrides raw', () => {
-    const input = '# Downtown {[map center="47.6,-122.3" zoom=9 mapStyle="road"]}\n\nSome text.\n';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md, { generateCoverBlock: false });
-
-    // The overrides must stay RAW strings — coercion only ever touches the
-    // ephemeral render input, never the stored block, so round-trips are lossless.
-    expect(doc.blocks[0].templateOverrides).toEqual({
-      center: '47.6,-122.3',
-      zoom: '9',
-      mapStyle: 'road',
-    });
-
-    // Byte-stable: one full cycle reaches a fixed point that a second cycle
-    // reproduces exactly.
-    const once = stringifyMarkdown(docToMarkdown(doc));
-    const twice = stringifyMarkdown(
-      docToMarkdown(markdownToDoc(parseMarkdown(once), { generateCoverBlock: false })),
-    );
-    expect(twice).toBe(once);
-    // And the annotation with its raw values survives serialization.
-    expect(once).toContain('center=47.6,-122.3');
-    expect(once).toContain('zoom=9');
-  });
-
-  it('round-trips preamble content', () => {
-    const input = 'Preamble text\n\n# Heading\n\nBody\n';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-    const roundTripped = docToMarkdown(doc);
-    expect(stripPositions(roundTripped)).toEqual(stripPositions(md));
-  });
-
-  it('round-trips deeply nested headings', () => {
-    const input = '# L1\n\nT1\n\n## L2\n\nT2\n\n### L3\n\nT3\n\n#### L4\n\nT4\n';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-    const roundTripped = docToMarkdown(doc);
-    expect(stripPositions(roundTripped)).toEqual(stripPositions(md));
-  });
-
-  it('round-trips complex mixed content', () => {
-    const input = `# Title
-
-Intro paragraph.
-
-- List item 1
-- List item 2
-
-## Code Section
-
-\`\`\`js
-const x = 1;
-\`\`\`
-
-## Quote Section
-
-> A blockquote
-
----
-`;
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-    const roundTripped = docToMarkdown(doc);
-    expect(stripPositions(roundTripped)).toEqual(stripPositions(md));
-  });
-
-  it('handles empty doc → empty markdown', () => {
-    const md = parseMarkdown('');
-    const doc = markdownToDoc(md);
-    const roundTripped = docToMarkdown(doc);
-    expect(roundTripped.children).toEqual([]);
-  });
-});
-
-// ============================================
-// Template Annotation → Block mapping
-// ============================================
-
-describe('template annotation in markdownToDoc', () => {
-  it('sets block.template from heading annotation', () => {
-    const md = parseMarkdown('## Report {[chart]}\n\nSome data');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks).toHaveLength(1);
-    expect(doc.blocks[0].template).toBe('chart');
-  });
-
-  it('sets block.templateOverrides from key=value params', () => {
-    const md = parseMarkdown('## Stats {[statHighlight colorScheme=blue size=large]}\n\nContent');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks[0].template).toBe('statHighlight');
-    expect(doc.blocks[0].templateOverrides).toEqual({
-      colorScheme: 'blue',
-      size: 'large',
-    });
-  });
-
-  it('uses defaultTemplate when no annotation is present', () => {
-    const md = parseMarkdown('## Plain Heading\n\nBody');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks[0].template).toBe('sectionHeader');
-    expect(doc.blocks[0].templateOverrides).toBeUndefined();
-  });
-
-  it('annotation stripping does not affect heading display text in sourceHeading', () => {
-    const md = parseMarkdown('## My Section {[chart]}\n\nBody');
-    const doc = markdownToDoc(md);
-    const heading = doc.blocks[0].sourceHeading!;
-
-    // The heading children should have the annotation stripped
-    expect(heading.templateAnnotation).toEqual({ template: 'chart' });
-    const textChild = heading.children.find((c) => c.type === 'text') as MarkdownText;
-    expect(textChild.value).toBe('My Section');
-  });
-
-  it('round-trips annotation through markdownToDoc → docToMarkdown → stringify', () => {
-    const input = '## Data {[chart colorScheme=blue]}\n\nContent here';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-    const roundTripped = docToMarkdown(doc);
-    const output = stringifyMarkdown(roundTripped);
-
-    expect(output).toContain('{[chart colorScheme=blue]}');
-    expect(output).toContain('Data');
-  });
-
-  it('docToMarkdown injects annotation when block.template differs from default', () => {
-    // Create a doc programmatically with a non-default template
-    const md = parseMarkdown('## Section\n\nBody');
-    const doc = markdownToDoc(md);
-
-    // Programmatically set a custom template
-    doc.blocks[0].template = 'factCard';
-    doc.blocks[0].templateOverrides = { style: 'minimal' };
-
-    const roundTripped = docToMarkdown(doc);
-    const output = stringifyMarkdown(roundTripped);
-
-    expect(output).toContain('{[factCard style=minimal]}');
-  });
-
-  it('docToMarkdown injects transition params into the squiggly annotation', () => {
-    const md = parseMarkdown('## Section\n\nBody');
-    const doc = markdownToDoc(md);
-    doc.blocks[0].transition = { type: 'wipe', duration: 0.8, direction: 'left' };
-
-    const output = stringifyMarkdown(docToMarkdown(doc));
-
-    expect(output).toContain('{[transition=wipe transitionDuration=0.8 transitionDirection=left]}');
-    expect(output).not.toContain('{transition=wipe');
-  });
-
-  it('a programmatic transition survives the string round trip', () => {
-    const doc = markdownToDoc(parseMarkdown('## Section\n\nBody'));
-    doc.blocks[0].transition = { type: 'wipe', duration: 0.8, direction: 'left' };
-
-    const reparsed = markdownToDoc(parseMarkdown(stringifyMarkdown(docToMarkdown(doc))));
-
-    expect(reparsed.blocks[0].transition).toEqual({
-      type: 'wipe',
-      duration: 0.8,
-      direction: 'left',
-    });
-  });
-
-  it('a programmatic transition survives the in-memory round trip (no stringify)', () => {
-    // markdownToDoc reads heading.attributes.blockMeta directly — it never
-    // re-coerces params — so docToMarkdown must keep blockMeta in sync with
-    // the params it writes for stringifyMarkdown.
-    const doc = markdownToDoc(parseMarkdown('## Section\n\nBody'));
-    doc.blocks[0].transition = { type: 'wipe', duration: 0.8, direction: 'left' };
-
-    const reconverted = markdownToDoc(docToMarkdown(doc));
-
-    expect(reconverted.blocks[0].transition).toEqual({
-      type: 'wipe',
-      duration: 0.8,
-      direction: 'left',
-    });
-  });
-
-  it('an updated transition replaces a previously authored one in both round trips', () => {
-    // The heading already carries a parsed transition (params + blockMeta);
-    // a programmatic change must win over the stale blockMeta.
-    const doc = markdownToDoc(parseMarkdown('## Section {transition=fade}\n\nBody'));
-    expect(doc.blocks[0].transition).toEqual({ type: 'fade' });
-    doc.blocks[0].transition = { type: 'wipe', direction: 'left' };
-
-    const inMemory = markdownToDoc(docToMarkdown(doc));
-    expect(inMemory.blocks[0].transition).toEqual({ type: 'wipe', direction: 'left' });
-
-    const output = stringifyMarkdown(docToMarkdown(doc));
-    expect(output).toContain('transition=wipe');
-    expect(output).toContain('{[transition=wipe transitionDirection=left]}');
-    expect(output).not.toContain('{transition=wipe');
-    const reparsed = markdownToDoc(parseMarkdown(output));
-    expect(reparsed.blocks[0].transition).toEqual({ type: 'wipe', direction: 'left' });
-  });
-
-  it('nested headings preserve their own annotations', () => {
-    const input = '# Chapter {[title]}\n\nIntro\n\n## Section {[chart]}\n\nData';
-    const md = parseMarkdown(input);
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks[0].template).toBe('title');
-    expect(doc.blocks[0].children).toHaveLength(1);
-    expect(doc.blocks[0].children![0].template).toBe('chart');
-  });
-});
-
-// ============================================
-// Reading-time durations & caption generation
-// ============================================
-
-describe('reading-time durations', () => {
-  it('sets block duration based on body content reading time', () => {
-    // ~50 words at 200 WPM = 15 seconds
-    const body = Array.from({ length: 50 }, (_, i) => `word${i}`).join(' ');
-    const md = parseMarkdown(`# Title\n\n${body}`);
-    const doc = markdownToDoc(md);
-
-    const block = doc.blocks[0];
-    expect(block.duration).toBeGreaterThan(5); // more than default
-    expect(block.duration).toBe(15); // 50 words / 200 WPM * 60 = 15s
-  });
-
-  it('applies minimum 3s duration for very short content', () => {
-    const md = parseMarkdown('# Title\n\nHi.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks[0].duration).toBe(3);
-  });
-
-  it('uses defaultDuration for blocks with no body content', () => {
-    const md = parseMarkdown('# Title');
-    const doc = markdownToDoc(md);
-
-    expect(doc.blocks[0].duration).toBe(5); // default
-  });
-
-  it('doc.duration sums all reading-time block durations', () => {
-    // Block A: no body → 5s default. Block B: ~20 words → 6s
-    const body = Array.from({ length: 20 }, (_, i) => `word${i}`).join(' ');
-    const md = parseMarkdown(`# A\n\n# B\n\n${body}`);
-    const doc = markdownToDoc(md);
-
-    const flat = flattenBlocks(doc.blocks);
-    expect(flat[0].duration).toBe(5); // A: no body
-    expect(flat[1].duration).toBe(6); // B: 20 words / 200 WPM * 60 = 6s
-    expect(doc.duration).toBe(11);
-  });
-});
-
-describe('caption generation', () => {
-  it('generates captions from body content', () => {
-    const md = parseMarkdown('# Title\n\nThis is the first sentence. This is the second sentence.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.captions).toBeDefined();
-    expect(doc.captions!.phrases.length).toBeGreaterThanOrEqual(2);
-    expect(doc.captions!.phrases[0].text).toContain('first sentence');
-    expect(doc.captions!.phrases[1].text).toContain('second sentence');
-  });
-
-  it('caption times span the block duration', () => {
-    const md = parseMarkdown('# Section\n\nSome text here. More text follows.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.captions).toBeDefined();
-    const phrases = doc.captions!.phrases;
-    // First phrase starts at block start
-    expect(phrases[0].startTime).toBe(doc.blocks[0].startTime);
-    // Last phrase ends at block end
-    const last = phrases[phrases.length - 1];
-    expect(last.endTime).toBeCloseTo(doc.blocks[0].startTime + doc.blocks[0].duration, 1);
-  });
-
-  it('does not generate captions for blocks without body content', () => {
-    const md = parseMarkdown('# A\n\n# B\n\n# C');
-    const doc = markdownToDoc(md);
-
-    // No body content anywhere → no captions
-    expect(doc.captions).toBeUndefined();
-  });
-
-  it('generates captions version; timestamp only when supplied (deterministic default)', () => {
-    const md = parseMarkdown('# Title\n\nHello world and more text.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.captions!.version).toBe(1);
-    // No clock reads during conversion — generatedAt is opt-in.
-    expect(doc.captions!.generatedAt).toBeUndefined();
-
-    const stamped = markdownToDoc(md, { captionsGeneratedAt: '2026-01-01T00:00:00.000Z' });
-    expect(stamped.captions!.generatedAt).toBe('2026-01-01T00:00:00.000Z');
-  });
-
-  it('caption phrases have sequential non-overlapping times', () => {
-    const md = parseMarkdown(
-      '# A\n\nFirst sentence here. Second sentence here.\n\n# B\n\nThird sentence. Fourth sentence.',
-    );
-    const doc = markdownToDoc(md);
-
-    const phrases = doc.captions!.phrases;
-    for (let i = 1; i < phrases.length; i++) {
-      expect(phrases[i].startTime).toBeGreaterThanOrEqual(phrases[i - 1].endTime - 0.001);
-    }
-  });
-});
-
-// ============================================
-// Auto cover block (startBlock) generation
-// ============================================
-
-describe('auto cover block generation', () => {
-  it('creates startBlock from H1 title', () => {
-    const md = parseMarkdown('# My Great Article\n\nSome introduction text.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.title).toBe('My Great Article');
-  });
-
-  it('uses first paragraph after H1 as subtitle', () => {
-    const md = parseMarkdown('# Title\n\nThis is a subtitle paragraph.\n\n## Section\n\nBody');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.subtitle).toBe('This is a subtitle paragraph.');
-  });
-
-  it('picks first image as heroSrc', () => {
-    const md = parseMarkdown('# Title\n\n![photo](hero.jpg)\n\nSome text.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.heroSrc).toBe('hero.jpg');
-    expect(doc.startBlock!.heroAlt).toBe('photo');
-  });
-
-  it('picks image from deeper in document', () => {
-    const md = parseMarkdown(
-      '# Title\n\nIntro text.\n\n## Section\n\nBody text.\n\n![deep pic](deep.png)',
-    );
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.heroSrc).toBe('deep.png');
-  });
-
-  it('picks raw HTML <img> as heroSrc (WYSIWYG resize case)', () => {
-    // The WYSIWYG editor serializes resized images as raw `<img src width>`
-    // because markdown shorthand has no width syntax. The cover scanner
-    // must see through that, or every resized image silently drops out
-    // of exports.
-    const md = parseMarkdown(
-      '# Title\n\n<img alt="resized" src="resized.jpg" width="194">\n\nText.',
-    );
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.heroSrc).toBe('resized.jpg');
-    expect(doc.startBlock!.heroAlt).toBe('resized');
-  });
-
-  it('works without images (no heroSrc)', () => {
-    const md = parseMarkdown('# Title\n\nPlain text, no images.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.title).toBe('Title');
-    expect(doc.startBlock!.heroSrc).toBeUndefined();
-  });
-
-  it('sets ambientMotion to zoomIn by default', () => {
-    const md = parseMarkdown('# Title\n\nContent.');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock!.ambientMotion).toBe('zoomIn');
-  });
-
-  it('does not create startBlock when no H1 exists', () => {
-    const md = parseMarkdown('## Section A\n\nText A\n\n## Section B\n\nText B');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeUndefined();
-  });
-
-  it('does not create startBlock when generateCoverBlock is false', () => {
-    const md = parseMarkdown('# Title\n\nContent.');
-    const doc = markdownToDoc(md, { generateCoverBlock: false });
-
-    expect(doc.startBlock).toBeUndefined();
-  });
-
-  it('does not create startBlock for heading-only document with no content', () => {
-    const md = parseMarkdown('# Title');
-    const doc = markdownToDoc(md);
-
-    expect(doc.startBlock).toBeDefined();
-    expect(doc.startBlock!.title).toBe('Title');
-    expect(doc.startBlock!.subtitle).toBeUndefined();
-  });
-});
-
-describe('markdownToDoc with Pandoc attributes', () => {
-  it('overrides block id from {#id}', () => {
-    const block = firstHeadingBlock('## Section title {#intro}');
-    expect(block.id).toBe('intro');
-  });
-
-  it('applies x / y to typed Block fields', () => {
-    // `diagramNode` is a legacy alias for the canonical `diagram` template;
-    // the alias resolves at template-resolution time.
-    const block = firstHeadingBlock('## Step 1 {#step1 x=400 y=200} {[diagramNode]}');
-    expect(block.id).toBe('step1');
-    expect(block.x).toBe(400);
-    expect(block.y).toBe(200);
-    expect(block.template).toBe('diagram');
-  });
-
-  it('applies multiple connectsTo entries with mixed types', () => {
-    const block = firstHeadingBlock(
-      '## Architecture {#arch x=600 y=300 connectsTo=foo:veryImportant,bar:requires,baz:requires} {[diagramNode]}',
-    );
-    expect(block.connectsTo).toEqual([
-      { target: 'foo', type: 'veryImportant' },
-      { target: 'bar', type: 'requires' },
-      { target: 'baz', type: 'requires' },
-    ]);
-  });
-
-  it('parses connections without types', () => {
-    const block = firstHeadingBlock('## Summary {#summary connectsTo=intro,middle,end}');
-    expect(block.connectsTo).toEqual([
-      { target: 'intro' },
-      { target: 'middle' },
-      { target: 'end' },
-    ]);
-  });
-
-  it('parses mix of typed and untyped connections in one list', () => {
-    const block = firstHeadingBlock(
-      '## Decision {#decision connectsTo=alt1,alt2:rejected,alt3:chosen}',
-    );
-    expect(block.connectsTo).toEqual([
-      { target: 'alt1' },
-      { target: 'alt2', type: 'rejected' },
-      { target: 'alt3', type: 'chosen' },
-    ]);
-  });
-
-  it('overrides startTime / duration with attribute values (seconds)', () => {
-    const block = firstHeadingBlock('## Closing {#closing startTime=02:30 duration=00:45}');
-    expect(block.startTime).toBe(150);
-    expect(block.duration).toBe(45);
-  });
-
-  it('sets transition metadata from Pandoc attributes', () => {
-    const block = firstHeadingBlock(
-      '## Closing {#closing transition=checkerboard transitionDuration=1.2 transitionDirection=vertical}',
-    );
-    expect(block.transition).toEqual({
-      type: 'checkerboard',
-      duration: 1.2,
-      direction: 'vertical',
-    });
-  });
-
-  it('puts unknown keys into block.metadata', () => {
-    const block = firstHeadingBlock('## X {#x priority=high status=draft}');
-    expect(block.metadata).toEqual({ priority: 'high', status: 'draft' });
-  });
-
-  it('routes template params separately from block-level metadata', () => {
-    const block = firstHeadingBlock(
-      '## X {#big x=400 priority=high} {[diagramNode colorScheme=blue]}',
-    );
-    expect(block.templateOverrides).toEqual({ colorScheme: 'blue' });
-    expect(block.metadata).toEqual({ priority: 'high' });
-    expect(block.x).toBe(400);
-  });
-
-  it('stores Pandoc classes on block.classes', () => {
-    const block = firstHeadingBlock('## X {#x .alpha .beta}');
-    expect(block.classes).toEqual(['alpha', 'beta']);
-  });
-
-  it('backward compat: plain {[…]}-only heading is unchanged', () => {
-    const block = firstHeadingBlock('## X {[chart colorScheme=blue]}');
-    expect(block.template).toBe('chart');
-    expect(block.templateOverrides).toEqual({ colorScheme: 'blue' });
-    expect(block.x).toBeUndefined();
-    expect(block.metadata).toBeUndefined();
-    expect(block.classes).toBeUndefined();
-  });
-});
-
-describe('markdownToDoc block-meta in the squiggly {[…]} form', () => {
-  it('reads duration from a pure key-value {[duration=N]} annotation', () => {
-    const block = firstHeadingBlock('## Closing {[duration=8]}\n\nSome body text here.\n');
-    expect(block.duration).toBe(8);
-  });
-
-  it('does not let reading-time overwrite a squiggly-pinned duration', () => {
-    // Body long enough that the reading-time estimate would exceed 8s if it ran.
-    const body = Array(80).fill('word').join(' ');
-    const block = firstHeadingBlock(`## Closing {[duration=8]}\n\n${body}\n`);
-    expect(block.duration).toBe(8);
-  });
-
-  it('folds duration alongside a template name', () => {
-    const block = firstHeadingBlock('## Hero {[sectionHeader duration=6]}');
-    expect(block.template).toBe('sectionHeader');
-    expect(block.duration).toBe(6);
-  });
-
-  it('folds transition alongside a template name', () => {
-    const block = firstHeadingBlock(
-      '## Hero {[sectionHeader transition=fly-through transitionDuration=750ms]}',
-    );
-    expect(block.template).toBe('sectionHeader');
-    expect(block.transition).toEqual({
-      type: 'flyThrough',
-      duration: 0.75,
-    });
-  });
-
-  it('accepts startTime in the squiggly form too', () => {
-    const block = firstHeadingBlock('## Closing {[startTime=02:30 duration=45]}');
-    expect(block.startTime).toBe(150);
-    expect(block.duration).toBe(45);
-  });
-
-  it('Pandoc attrs win when a key appears in both forms', () => {
-    const block = firstHeadingBlock('## X {duration=3} {[duration=9]}');
-    expect(block.duration).toBe(3);
-  });
-});
-
-describe('auto template picking (autoTemplates, default on)', () => {
-  const toDocFromMd = (md: string, options?: Parameters<typeof markdownToDoc>[1]) =>
-    markdownToDoc(parseMarkdown(md), options);
-
-  it('picks quote for a blockquote-bearing section and derives the quote text', () => {
-    const doc = toDocFromMd('# Wisdom\n\n> The best template feels obvious.\n');
-    const block = doc.blocks[0];
-    expect(block.template).toBe('quote');
-    expect(block.autoTemplate).toBe(true);
-    expect(block.templateData?.quote).toBe('The best template feels obvious.');
-  });
-
-  it('picks dataTable for a table-bearing section with derived headers/rows', () => {
-    const doc = toDocFromMd('# Results\n\n| A | B |\n| - | - |\n| 1 | 2 |\n');
-    const block = doc.blocks[0];
-    expect(block.template).toBe('dataTable');
-    expect(block.templateData?.headers).toEqual(['A', 'B']);
-    expect(block.templateData?.rows).toEqual([['1', '2']]);
-  });
-
-  it('picks list for list-bearing sections and photoGrid for multi-image sections', () => {
-    const doc = toDocFromMd('# Steps\n\n- one\n- two\n\n# Gallery\n\n![a](a.jpg)\n\n![b](b.jpg)\n');
-    expect(doc.blocks[0].template).toBe('list');
-    expect(doc.blocks[0].templateData?.items).toEqual(['one', 'two']);
-    expect(doc.blocks[1].template).toBe('photoGrid');
-  });
-
-  it('alternates left/right feature for consecutive single-image sections', () => {
-    const doc = toDocFromMd('# One\n\n![a](a.jpg)\n\n# Two\n\n![b](b.jpg)\n');
-    expect(doc.blocks[0].template).toBe('leftFeature');
-    expect(doc.blocks[1].template).toBe('rightFeature');
-    expect(doc.blocks[0].templateData?.imageSrc).toBe('a.jpg');
-  });
-
-  it('leaves plain prose sections on the structural default', () => {
-    const doc = toDocFromMd('# About\n\nJust a paragraph of prose.\n');
-    expect(doc.blocks[0].template).toBe('sectionHeader');
-    expect(doc.blocks[0].autoTemplate).toBeUndefined();
-  });
-
-  it('never overrides an explicit annotation', () => {
-    const doc = toDocFromMd('# Wisdom {[factCard fact="F"]}\n\n> quoted\n');
-    expect(doc.blocks[0].template).toBe('factCard');
-  });
-
-  it('is disabled by the option and by frontmatter', () => {
-    const md = '# Wisdom\n\n> quoted\n';
-    const viaOption = toDocFromMd(md, { autoTemplates: false });
-    expect(viaOption.blocks[0].template).toBe('sectionHeader');
-
-    const viaFrontmatter = markdownToDoc(
-      parseMarkdown('---\nsquisq-auto-templates: false\n---\n\n' + md),
-    );
-    expect(viaFrontmatter.blocks[0].template).toBe('sectionHeader');
-  });
-
-  it('keeps the round-trip lossless (no materialized annotations)', () => {
-    const md = '# Wisdom\n\n> The best template feels obvious.\n';
-    const doc = toDocFromMd(md);
-    expect(doc.blocks[0].template).toBe('quote');
-    const roundTripped = stringifyMarkdown(docToMarkdown(doc));
-    expect(roundTripped).not.toContain('{[quote');
-  });
-});
-
-describe('standalone annotation blocks (S2)', () => {
-  const toDoc = (md: string, options?: Parameters<typeof markdownToDoc>[1]) =>
-    markdownToDoc(parseMarkdown(md), { articleId: 't', generateCoverBlock: false, ...options });
-
-  it('turns a standalone {[template]} paragraph into a heading-less block', () => {
-    const doc = toDoc('# Intro\n\nlead para\n\n{[quote]}\n\nquoted body\n');
-    // Containing block keeps only the leading content.
-    const intro = doc.blocks[0];
-    expect(intro.title).toBe('Intro');
-    expect(intro.contents?.map((n) => n.type)).toEqual(['paragraph']);
-    // The produced block is a sibling right after the containing block.
-    const q = doc.blocks[1];
-    expect(q.template).toBe('quote');
-    expect(q.standaloneAnnotation).toBe(true);
-    expect(q.sourceHeading).toBeUndefined();
-    expect(q.sourceAnnotation).toEqual({ template: 'quote' });
-    expect(q.contents?.map((n) => n.type)).toEqual(['paragraph']);
-  });
-
-  it('attaches trailing contents up to the next annotation; params → overrides + title', () => {
-    const doc = toDoc(
-      '# H\n\n{[statHighlight title="Q1 Revenue" colorScheme=blue]}\n\nbig number\n\n{[quote]}\n\nq\n',
-    );
-    const stat = doc.blocks[1];
-    expect(stat.template).toBe('statHighlight');
-    expect(stat.title).toBe('Q1 Revenue');
-    expect(stat.templateOverrides).toEqual({ title: 'Q1 Revenue', colorScheme: 'blue' });
-    expect(stat.contents?.length).toBe(1); // "big number", ended by the next annotation
-    const quote = doc.blocks[2];
-    expect(quote.template).toBe('quote');
-    expect(quote.contents?.length).toBe(1); // "q"
-  });
-
-  it('produces adjacent blocks for consecutive annotations (no content between)', () => {
-    const doc = toDoc('# H\n\n{[quote]}\n\n{[factCard]}\n\ntail\n');
-    expect(doc.blocks[1].template).toBe('quote');
-    expect(doc.blocks[1].contents ?? []).toHaveLength(0);
-    expect(doc.blocks[2].template).toBe('factCard');
-    expect(doc.blocks[2].contents?.length).toBe(1); // "tail"
-  });
-
-  it('handles an annotation as the last node (no trailing contents)', () => {
-    const doc = toDoc('# H\n\nbody\n\n{[quote]}\n');
-    expect(doc.blocks[1].template).toBe('quote');
-    expect(doc.blocks[1].contents ?? []).toHaveLength(0);
-  });
-
-  it('generates unique slug ids that dedupe against headings', () => {
-    const doc = toDoc('# Quote\n\n{[quote title=Quote]}\n\nbody\n');
-    expect(doc.blocks[0].id).toBe('quote');
-    expect(doc.blocks[1].id).toBe('quote-2');
-  });
-
-  it('lifts an annotation out of the preamble (before the first heading)', () => {
-    const doc = toDoc('intro\n\n{[quote]}\n\nquoted\n\n# Heading\n\nrest\n');
-    // preamble keeps "intro", quote block next, then the heading block.
-    expect(doc.blocks[0].sourceHeading).toBeUndefined();
-    expect(doc.blocks[0].contents?.length).toBe(1);
-    expect(doc.blocks[1].template).toBe('quote');
-    expect(doc.blocks[2].title).toBe('Heading');
-  });
-
-  it('drops a preamble that was entirely a standalone annotation', () => {
-    const doc = toDoc('{[quote]}\n\nquoted\n\n# Heading\n');
-    expect(doc.blocks[0].template).toBe('quote');
-    expect(doc.blocks[0].standaloneAnnotation).toBe(true);
-    expect(doc.blocks[1].title).toBe('Heading');
-  });
-
-  it('honors a pinned duration on a standalone annotation', () => {
-    const doc = toDoc('# H\n\n{[quote duration=9]}\n\nbody\n');
-    expect(doc.blocks[1].duration).toBe(9);
-  });
-
-  it('does not treat annotations nested inside a list as blocks', () => {
-    const doc = toDoc('# H\n\n- {[quote]}\n');
-    // Only the heading block — the list annotation stays in contents.
-    expect(doc.blocks).toHaveLength(1);
-    expect(doc.blocks[0].contents?.[0].type).toBe('list');
-  });
-
-  it('round-trips a standalone annotation block byte-for-byte', () => {
-    const md = '# Intro\n\nlead\n\n{[quote]}\n\nquoted body\n';
-    const doc = toDoc(md);
-    const out = stringifyMarkdown(docToMarkdown(doc));
-    expect(out).toBe(md);
-    // And re-parsing is stable.
-    const doc2 = toDoc(out);
-    expect(stringifyMarkdown(docToMarkdown(doc2))).toBe(md);
-  });
-
-  it('round-trips params (quoting) byte-for-byte', () => {
-    const md = '# H\n\n{[statHighlight title="Q1 Revenue" colorScheme=blue]}\n\nbody\n';
-    const out = stringifyMarkdown(docToMarkdown(toDoc(md)));
-    expect(out).toBe(md);
-  });
-});