@bendyline/squisq 2.13.10 → 2.13.12

package/dist/{chunk-KRMAEYNM.js → chunk-OUSEEUEC.js}

@@ -1,10 +1,12 @@
 import {
   buildNarrationScript,
+  buildSourceText,
   coerceTemplateParams,
+  conceptBuildStepTexts,
   flattenRenderableBlocks,
   getPinnedBlockMeta,
   markdownToDoc
-} from "./chunk-LWNT6M4N.js";
+} from "./chunk-QJQQO3K4.js";
 import {
   deriveTemplateInputs,
   extractEmbeddedVideos,
@@ -19,7 +21,7 @@ import {
   isStandaloneHtmlVideo,
   isTreeFence,
   matchNumberHighlight
-} from "./chunk-DIY3NBIS.js";
+} from "./chunk-SGNWO7OF.js";
 import {
   extractContent,
   mapElementToBlock,
@@ -29,13 +31,13 @@ import {
   cloneAndFreezeData,
   cloneData,
   isTemplateBlock
-} from "./chunk-WNEH3BZP.js";
+} from "./chunk-JNUNNQ74.js";
 import {
   parseMarkdown
-} from "./chunk-XDOSE5M3.js";
+} from "./chunk-C4SB3NN4.js";
 import {
   isContainerTemplate
-} from "./chunk-DOOUVVOM.js";
+} from "./chunk-7MS26OXD.js";
 import {
   extractPlainText,
   findBlockVideoEmbed,
@@ -67,7 +69,11 @@ var PRESENTATION_LAYOUTS = [
   "list",
   "comparison",
   "steps",
-  "image"
+  "image",
+  "cards",
+  "process",
+  "cycle",
+  "layers"
 ];
 var AUTHORED_PRESENTATION_LAYOUT = "authored";
 var EMPHASIS_CHARACTERS = 60;
@@ -83,7 +89,12 @@ function presentationLayoutFits(layout, headline, points, passage) {
   switch (layout) {
     case "list":
     case "steps":
+    case "cards":
+    case "process":
       return points.length >= 2;
+    case "cycle":
+    case "layers":
+      return points.length >= 3;
     case "comparison":
       return points.length === 2;
     case "definition":
@@ -289,96 +300,6 @@ function usesDynamicPresentation(doc) {
   return typeof style === "string" && style.trim().toLowerCase().replace(/\s+/g, "-") === DYNAMIC_PRESENTATION_STYLE;
 }
 
-// src/transform/blockAnalyzer.ts
-function contentsToPlainText(contents) {
-  return contents.map((node) => extractPlainText(node)).join("\n");
-}
-var PROSE_NODE_TYPES = /* @__PURE__ */ new Set(["paragraph", "blockquote", "heading"]);
-function maskNonProse(stripped, contents) {
-  let masked = stripped;
-  let cursor = 0;
-  for (const node of contents) {
-    const text3 = stripMarkdown(extractPlainText(node));
-    if (!text3) continue;
-    const at = stripped.indexOf(text3, cursor);
-    if (at < 0) continue;
-    cursor = at + text3.length;
-    if (PROSE_NODE_TYPES.has(node.type)) continue;
-    masked = masked.slice(0, at) + text3.replace(/\S/g, " ") + masked.slice(cursor);
-  }
-  return masked;
-}
-function extractBlockImages(block, blockIndex) {
-  return extractImages(block.contents).map(({ src, alt }) => ({
-    src,
-    alt,
-    sourceBlockIndex: blockIndex
-  }));
-}
-function extractDocImages(blocks) {
-  const seen = /* @__PURE__ */ new Set();
-  const images = [];
-  function walk(blockList) {
-    for (const block of blockList) {
-      for (const img of extractImages(block.contents)) {
-        if (!seen.has(img.src)) {
-          seen.add(img.src);
-          images.push({ src: img.src, alt: img.alt });
-        }
-      }
-      if (block.children) {
-        walk(block.children);
-      }
-    }
-  }
-  walk(blocks);
-  return images;
-}
-function collectLeafBlocks(blocks) {
-  const result = [];
-  for (const block of blocks) {
-    if (block.children && block.children.length > 0) {
-      if (!block.contents || block.contents.length === 0) {
-        result.push(block);
-      }
-      result.push(...collectLeafBlocks(block.children));
-    } else {
-      result.push(block);
-    }
-  }
-  return result;
-}
-function analyzeBlocks(blocks, options) {
-  return analyzeFlatBlocks(collectLeafBlocks(blocks), options);
-}
-function analyzeFlatBlocks(flat, options) {
-  const results = [];
-  for (const block of flat) {
-    let plainText = "";
-    if (block.contents && block.contents.length > 0) {
-      plainText = contentsToPlainText(block.contents);
-    } else if (block.title) {
-      plainText = block.title;
-    }
-    const stripped = stripMarkdown(plainText);
-    const bodyWordCount = stripped.split(/\s+/).filter((w) => w.length > 0).length;
-    const extraction = extractContent(
-      block.contents && block.contents.length > 0 ? maskNonProse(stripped, block.contents) : stripped,
-      options
-    );
-    const images = extractBlockImages(block, results.length);
-    results.push({
-      block,
-      plainText: stripped,
-      extractions: extraction.elements,
-      hasChildren: !!(block.children && block.children.length > 0),
-      bodyWordCount,
-      images
-    });
-  }
-  return results;
-}
-
 // src/transform/styles/dynamicSlides.ts
 var dynamicSlidesStyle = {
   id: "dynamic-slides",
@@ -656,6 +577,96 @@ function getTransformStyleSummaries(registry) {
   });
 }
 
+// src/transform/blockAnalyzer.ts
+function contentsToPlainText(contents) {
+  return contents.map((node) => extractPlainText(node)).join("\n");
+}
+var PROSE_NODE_TYPES = /* @__PURE__ */ new Set(["paragraph", "blockquote", "heading"]);
+function maskNonProse(stripped, contents) {
+  let masked = stripped;
+  let cursor = 0;
+  for (const node of contents) {
+    const text3 = stripMarkdown(extractPlainText(node));
+    if (!text3) continue;
+    const at = stripped.indexOf(text3, cursor);
+    if (at < 0) continue;
+    cursor = at + text3.length;
+    if (PROSE_NODE_TYPES.has(node.type)) continue;
+    masked = masked.slice(0, at) + text3.replace(/\S/g, " ") + masked.slice(cursor);
+  }
+  return masked;
+}
+function extractBlockImages(block, blockIndex) {
+  return extractImages(block.contents).map(({ src, alt }) => ({
+    src,
+    alt,
+    sourceBlockIndex: blockIndex
+  }));
+}
+function extractDocImages(blocks) {
+  const seen = /* @__PURE__ */ new Set();
+  const images = [];
+  function walk(blockList) {
+    for (const block of blockList) {
+      for (const img of extractImages(block.contents)) {
+        if (!seen.has(img.src)) {
+          seen.add(img.src);
+          images.push({ src: img.src, alt: img.alt });
+        }
+      }
+      if (block.children) {
+        walk(block.children);
+      }
+    }
+  }
+  walk(blocks);
+  return images;
+}
+function collectLeafBlocks(blocks) {
+  const result = [];
+  for (const block of blocks) {
+    if (block.children && block.children.length > 0) {
+      if (!block.contents || block.contents.length === 0) {
+        result.push(block);
+      }
+      result.push(...collectLeafBlocks(block.children));
+    } else {
+      result.push(block);
+    }
+  }
+  return result;
+}
+function analyzeBlocks(blocks, options) {
+  return analyzeFlatBlocks(collectLeafBlocks(blocks), options);
+}
+function analyzeFlatBlocks(flat, options) {
+  const results = [];
+  for (const block of flat) {
+    let plainText = "";
+    if (block.contents && block.contents.length > 0) {
+      plainText = contentsToPlainText(block.contents);
+    } else if (block.title) {
+      plainText = block.title;
+    }
+    const stripped = stripMarkdown(plainText);
+    const bodyWordCount = stripped.split(/\s+/).filter((w) => w.length > 0).length;
+    const extraction = extractContent(
+      block.contents && block.contents.length > 0 ? maskNonProse(stripped, block.contents) : stripped,
+      options
+    );
+    const images = extractBlockImages(block, results.length);
+    results.push({
+      block,
+      plainText: stripped,
+      extractions: extraction.elements,
+      hasChildren: !!(block.children && block.children.length > 0),
+      bodyWordCount,
+      images
+    });
+  }
+  return results;
+}
+
 // src/transform/timingAllocator.ts
 var MIN_BLOCK_DURATION = 3;
 var MAX_BLOCK_DURATION = 20;
@@ -1708,7 +1719,23 @@ function videoBlock(video, index, segmentId, duration) {
 }
 
 // src/transform/presentationMedia.ts
+function presentationBlockImages(doc) {
+  const own = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  const claim = (block) => [
+    ...extractImages(block.contents).filter((image) => {
+      if (seen.has(image.src)) return false;
+      seen.add(image.src);
+      return true;
+    }),
+    ...(block.children ?? []).flatMap(claim)
+  ];
+  for (const block of [...flattenRenderableBlocks(doc.blocks)].reverse())
+    own.set(block.id, claim(block));
+  return own;
+}
 function mediaKind(node) {
+  if (node.type === "table") return { kind: "table", continuous: true };
   if (node.type === "code")
     return isPictureFence(node) || isExplicitDiagramLang(node.lang) || isExplicitTreeLang(node.lang) || isExplicitTimelineLang(node.lang) ? { kind: "diagram", continuous: true } : null;
   if (isStandaloneHtmlVideo(node)) return { kind: "video", continuous: true };
@@ -1719,17 +1746,39 @@ function mediaKind(node) {
 function collectPresentationMedia(doc, sectionIds) {
   const sections = new Set(sectionIds);
   const result = /* @__PURE__ */ new Map();
+  const pictures = presentationBlockImages(doc);
   let owner = sectionIds[0];
   for (const block of flattenRenderableBlocks(doc.blocks)) {
     if (sections.has(block.id)) owner = block.id;
     if (!owner) continue;
+    const items = result.get(owner) ?? [];
+    const count = (kind) => items.filter((item) => item.kind === kind).length;
     for (const node of block.contents ?? []) {
       const kind = mediaKind(node);
       if (!kind) continue;
-      const items = result.get(owner) ?? [];
-      items.push({ ...kind, ref: `${owner}#${items.length}`, node });
-      result.set(owner, items);
+      const ref = kind.kind === "table" ? `${owner}#table-${count("table")}` : `${owner}#${count("video") + count("diagram")}`;
+      items.push({ ...kind, ref, node });
     }
+    for (const { src, alt, width, height } of pictures.get(block.id) ?? [])
+      items.push({
+        kind: "image",
+        continuous: true,
+        ref: `${owner}#image-${count("image")}`,
+        src,
+        node: {
+          type: "paragraph",
+          children: [
+            {
+              type: "image",
+              url: src,
+              alt,
+              ...width !== void 0 ? { width } : {},
+              ...height !== void 0 ? { height } : {}
+            }
+          ]
+        }
+      });
+    if (items.length) result.set(owner, items);
   }
   return result;
 }
@@ -1759,7 +1808,23 @@ function presentationMediaNode(item, elapsed) {
 // src/transform/presentationPlanner.ts
 var SENTENCE_END = /[.!?][”"')\]]?$/u;
 var SENTENCE_START = /^[\p{Lu}\p{N}"“‘'([]/u;
-var SEQUENCE_CUE = /^(?:(?:first|second|third|fourth)(?:ly)?|then|next|after that|afterwards|finally|lastly)\b|^\d+[.)]\s/iu;
+var SEQUENCE_CUE = /^(?:(?:first|second|third|fourth)(?:ly)?|then|next|after\b|afterwards|at that point|eventually|finally|lastly)\b|^\d+[.)]\s/iu;
+var ORDINAL_OPENER = /^(?:(?:first|second|third|fourth)(?:ly)?|then|next|after that|afterwards|finally|lastly),?\s+/iu;
+function stagePoint(sentence) {
+  const rest = sentence.replace(ORDINAL_OPENER, "");
+  return pointText(rest === sentence ? sentence : `${rest[0].toUpperCase()}${rest.slice(1)}`);
+}
+var CYCLE_CUE = /\b(?:cycles?|cyclical|repeats?|over and over|again and again|loop)\b/iu;
+var DEFINES = /^(?:the |an? )?((?:[\p{Lu}][\p{L}'’-]*|[\p{Ll}][\p{L}'’-]*)(?: [\p{L}'’()-]+){0,3}?) (?:is|are|was|were) (?:an? |the )?(.{12,})$/u;
+var PRONOUN = /^(?:it|its|this|that|these|those|there|they|their|he|his|she|her|we|our|you|your|i|my|which|one|each|some|to|so|but|and|or)$/iu;
+function labelledPoint(sentence) {
+  const match = sentence.replace(/\s+/gu, " ").trim().match(DEFINES);
+  if (match && !PRONOUN.test(match[1].split(" ")[0])) {
+    const label = match[1];
+    return clip(`${label[0].toUpperCase()}${label.slice(1)}: ${match[2]}`, Infinity, 160);
+  }
+  return clip(sentence, Infinity, 160);
+}
 function clip(text3, words, characters) {
   const clean = text3.replace(/\s+/gu, " ").trim();
   const parts = clean.split(" ");
@@ -1774,6 +1839,17 @@ function clip(text3, words, characters) {
 var headlineText = (text3) => clip(text3, 12, 110);
 var pointText = (text3) => clip(text3, Infinity, 180);
 var captionText = (text3) => clip(text3, 18, 110);
+var FEATURE_POINTS = 2;
+var FEATURE_POINT_CHARACTERS = 100;
+function featurePointText(text3) {
+  const clean = text3.replace(/\s+/gu, " ").trim();
+  if (clean.length <= FEATURE_POINT_CHARACTERS) return clean;
+  const head = clean.slice(0, FEATURE_POINT_CHARACTERS);
+  const clause = Math.max(
+    ...[",", ";", ":", " \u2013", " \u2014", " - "].map((mark) => head.lastIndexOf(mark))
+  );
+  return clause > FEATURE_POINT_CHARACTERS * 0.4 ? clean.slice(0, clause).replace(/[\s,;:–—-]+$/u, "") + "\u2026" : clip(clean, Infinity, FEATURE_POINT_CHARACTERS);
+}
 function sentencesIn(sourceText, start, end) {
   const passage = sourceText.slice(start, end);
   const sentences = [];
@@ -1816,24 +1892,31 @@ function chunkWords(words, limit) {
   }
   return chunks;
 }
-function imagesBySection(doc, sectionIds) {
-  const flat = flattenRenderableBlocks(doc.blocks);
-  const own = /* @__PURE__ */ new Map();
-  const seen = /* @__PURE__ */ new Set();
-  for (const block of [...flat].reverse()) {
-    const images = extractDocImages([block]).filter((image) => !seen.has(image.src));
-    for (const image of images) seen.add(image.src);
-    own.set(block.id, images);
-  }
-  const sections = new Set(sectionIds);
-  const result = /* @__PURE__ */ new Map();
-  let owner = sectionIds[0];
-  for (const block of flat) {
-    if (sections.has(block.id)) owner = block.id;
-    if (!owner) continue;
-    result.set(owner, [...result.get(owner) ?? [], ...own.get(block.id) ?? []]);
+function chunkPassage(words, limit, feature) {
+  const prose = words.flatMap((word, index) => feature(word) ? [] : [index]);
+  if (!prose.length) return words.length ? [[0, words.length]] : [];
+  const chunks = chunkWords(
+    prose.map((index) => words[index]),
+    limit
+  ).map(([first, last]) => [prose[first], prose[last - 1] + 1]);
+  chunks[0][0] = 0;
+  chunks.forEach((chunk, index) => {
+    chunk[1] = chunks[index + 1]?.[0] ?? words.length;
+  });
+  return chunks;
+}
+function featureSpans(sourceText, from, to, items) {
+  const spans = [];
+  let cursor = from;
+  for (const item of items) {
+    if (item.kind === "image") continue;
+    const text3 = extractPlainText(item.node).trim();
+    const at = text3 ? sourceText.indexOf(text3, cursor) : -1;
+    if (at < 0 || at + text3.length > to) continue;
+    spans.push([at, at + text3.length]);
+    cursor = at + text3.length;
   }
-  return result;
+  return spans;
 }
 function field(block, key) {
   if (!block || typeof block !== "object") return void 0;
@@ -1848,7 +1931,7 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
     throw new Error(
       "This document is too long for one presentation. Split it into shorter documents."
     );
-  const sectionImages = imagesBySection(
+  const sectionMedia = collectPresentationMedia(
     doc,
     script.blocks.map((block) => block.blockId)
   );
@@ -1881,8 +1964,22 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
       continue;
     }
     const preferred = hint?.layout;
-    const chunks = chunkWords(words, wordLimit);
-    const images = sectionImages.get(block.blockId) ?? [];
+    const media = sectionMedia.get(block.blockId) ?? [];
+    const spans = featureSpans(script.sourceText, block.charStart, block.charEnd, media);
+    const inFeature = (from, to) => spans.some(([s, e]) => from < e && to > s);
+    const chunks = chunkPassage(
+      words,
+      wordLimit,
+      (word) => inFeature(block.charStart + word.index, block.charStart + word.index + word[0].length)
+    );
+    for (let k = chunks.length - 1; k > 0; k--) {
+      const opening = script.sourceText.slice(block.charStart + words[chunks[k][0]].index);
+      if (SEQUENCE_CUE.test(opening) && chunks[k][1] - chunks[k - 1][0] <= wordLimit * 2) {
+        chunks[k - 1][1] = chunks[k][1];
+        chunks.splice(k, 1);
+      }
+    }
+    const images = media.filter((item) => item.kind === "image");
     const opensDeck = beats.length === 0;
     for (const [chunk, [first, last]] of chunks.entries()) {
       const fromEnd = chunks.length - 1 - chunk;
@@ -1890,8 +1987,18 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
       const start = block.charStart + words[first].index;
       const end = block.charStart + words[last - 1].index + words[last - 1][0].length;
       const passage = script.sourceText.slice(start, end);
+      let prose = "";
+      let cursor = start;
+      for (const [s, e] of spans) {
+        if (e <= cursor || s >= end) continue;
+        prose += script.sourceText.slice(cursor, Math.max(cursor, s)) + "\n";
+        cursor = Math.min(end, e);
+      }
+      prose = (prose + script.sourceText.slice(cursor, end)).trim() || passage;
       const index = beats.length;
-      const sentences = sentencesIn(script.sourceText, start, end);
+      const sentences = sentencesIn(script.sourceText, start, end).filter(
+        (sentence) => !inFeature(sentence.start, sentence.end)
+      );
       const body = sentences.filter((sentence) => sentence.start >= headingEnd);
       let headline;
       let shown;
@@ -1899,12 +2006,12 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
         headline = headlineText(heading);
         shown = body.filter((sentence) => comparable(sentence.text) !== comparable(heading));
       } else {
-        const suggested = transformNarratedSegment(
+        const suggested2 = transformNarratedSegment(
           {
             articleId: doc.articleId,
             segmentId: `presentation-${index}`,
             title: "",
-            text: passage,
+            text: prose,
             duration: Math.max(4, (last - first) / 2.5),
             audioSrc: "",
             includeTitleBlock: false
@@ -1912,23 +2019,24 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
           { slidesPerMinute: 4, minConfidence: 0.25, style: "documentary" }
         ).doc.blocks[0];
         headline = headlineText(
-          field(suggested, "fact") ?? field(suggested, "description") ?? field(suggested, "quote") ?? sentences[0]?.text ?? passage
+          field(suggested2, "fact") ?? field(suggested2, "description") ?? field(suggested2, "quote") ?? sentences[0]?.text ?? prose
         );
-        if (!headline) headline = headlineText(passage);
+        if (!headline) headline = headlineText(prose);
         shown = body.filter((sentence) => !repeats(sentence.text, headline));
       }
       const steps = shown.filter((sentence) => SEQUENCE_CUE.test(sentence.text));
       const sequence = steps.length >= 2;
       const textPoints = shown.slice(0, 3).map((item) => pointText(item.text));
-      const stepPoints = sequence ? steps.slice(0, 3).map((item) => pointText(item.text)) : textPoints;
+      const stepPoints = sequence ? steps.slice(0, 4).map((item) => stagePoint(item.text)) : textPoints;
+      const cardPoints = shown.slice(0, 4).map((item) => labelledPoint(item.text));
       const custom = chunk === 0 ? wording : void 0;
       if (custom?.headline) headline = custom.headline;
-      const pointsFor = (layout2) => custom?.points ?? (layout2 === "steps" ? stepPoints : textPoints);
+      const pointsFor = (layout2) => custom?.points ?? (["steps", "process", "cycle"].includes(layout2) ? stepPoints : layout2 === "cards" ? cardPoints : textPoints);
       const quote = custom?.headline ? void 0 : body.find((sentence) => sentence.text.length <= 110)?.text;
       const headlineFor = (layout2) => layout2 === "quote" && quote ? quote : headline;
-      let layout = index === 0 ? "title" : textPoints.length >= 2 && index % 3 === 1 ? "list" : "statement";
-      if (sequence) layout = "steps";
-      else if (textPoints.length === 2 && /\b(versus|whereas|compared|instead)\b/iu.test(passage))
+      let layout = index === 0 ? "title" : textPoints.length >= 2 ? "cards" : "statement";
+      if (sequence) layout = steps.length >= 3 && CYCLE_CUE.test(prose) ? "cycle" : "steps";
+      else if (textPoints.length === 2 && /\b(versus|whereas|compared|instead)\b/iu.test(prose))
         layout = "comparison";
       if (image) layout = "image";
       if (preferred && (preferred === "image" ? !!image : presentationLayoutFits(
@@ -1945,7 +2053,7 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
         layout,
         headline: headlineFor(layout),
         points: pointsFor(layout),
-        ...layout === "image" && image ? { imageSrc: image.src } : {}
+        ...layout === "image" && image?.src ? { imageSrc: image.src } : {}
       };
       if (quote) quotes.set(beat.id, quote);
       let split;
@@ -1997,28 +2105,6 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
       ))
         beat.hidden = true;
   }
-  const sectionMedia = collectPresentationMedia(
-    doc,
-    script.blocks.map((block) => block.blockId)
-  );
-  for (const block of script.blocks) {
-    const items = sectionMedia.get(block.blockId);
-    if (!items?.length) continue;
-    const own = beats.filter(
-      (beat) => beat.sourceStart >= block.charStart && beat.sourceStart < block.charEnd && beat.layout !== AUTHORED_PRESENTATION_LAYOUT && !beat.hidden
-    );
-    if (!own.length) continue;
-    const open = own.filter((beat) => beat !== beats[0] && beat.layout !== "image");
-    const slots = open.length ? open : own;
-    const shown = /* @__PURE__ */ new Set();
-    slots.forEach((beat, slot) => {
-      const from = Math.floor(slot * items.length / slots.length);
-      const to = Math.max(from + 1, Math.floor((slot + 1) * items.length / slots.length));
-      const refs = items.slice(from, to).filter((item) => item.continuous || !shown.has(item.ref)).slice(0, PRESENTATION_LIMITS.mediaPerBeat).map((item) => item.ref);
-      for (const ref of refs) shown.add(ref);
-      if (refs.length) beat.media = refs;
-    });
-  }
   const closing = beats[beats.length - 1];
   if (beats.length > 2 && closing?.layout === "statement" && !hints.blocks.some(
     (hint) => hint.layout && script.blocks.some(
@@ -2026,19 +2112,24 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
     )
   ))
     closing.layout = "title";
+  const sectionOf = (beat) => script.blocks.find(
+    (block) => beat.sourceStart >= block.charStart && beat.sourceStart < block.charEnd
+  );
+  const hintFor = (beat) => hints.blocks.find((item) => item.blockId === sectionOf(beat)?.blockId);
+  const worded = /* @__PURE__ */ new Set();
+  const suggested = /* @__PURE__ */ new Set();
   let origin = "automatic";
   for (const beat of beats) {
     if (beat.layout === AUTHORED_PRESENTATION_LAYOUT) continue;
-    const section = script.blocks.find(
-      (block) => beat.sourceStart >= block.charStart && beat.sourceStart < block.charEnd
-    );
-    const hint = hints.blocks.find((item) => item.blockId === section?.blockId);
+    const section = sectionOf(beat);
+    const hint = hintFor(beat);
     const passage = script.sourceText.slice(beat.sourceStart, beat.sourceEnd);
     const cached = hint?.ai?.find((item) => item.source === passage);
     if (cached && (cached.layout !== "image" || beat.imageSrc)) {
       beat.headline = cached.headline;
       beat.points = [...cached.points];
       beat.layout = cached.layout;
+      suggested.add(beat.id);
       origin = "ai";
     }
     const preferred = hint?.layout === AUTHORED_PRESENTATION_LAYOUT ? void 0 : hint?.layout;
@@ -2052,12 +2143,49 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
     if (section && beat.sourceStart === section.charStart && hint?.wording?.source === script.sourceText.slice(section.charStart, section.charEnd)) {
       beat.headline = hint.wording.headline ?? beat.headline;
       beat.points = hint.wording.points ?? beat.points;
+      if (hint.wording.points) worded.add(beat.id);
     }
-    if (beat.media && beat.layout === "steps" && preferred !== "steps") beat.layout = "list";
     if (beat.layout !== "image" && !presentationLayoutFits(beat.layout, beat.headline, beat.points, passage))
       beat.layout = "statement";
     if (beat.layout !== "image") delete beat.imageSrc;
   }
+  const fullBleed = new Set(beats.flatMap((beat) => beat.imageSrc ? [beat.imageSrc] : []));
+  for (const block of script.blocks) {
+    const items = (sectionMedia.get(block.blockId) ?? []).filter(
+      (item) => item.kind !== "image" || !fullBleed.has(item.src)
+    );
+    if (!items.length) continue;
+    const own = beats.filter(
+      (beat) => beat.sourceStart >= block.charStart && beat.sourceStart < block.charEnd && beat.layout !== AUTHORED_PRESENTATION_LAYOUT && !beat.hidden
+    );
+    if (!own.length) continue;
+    const open = own.filter((beat) => beat !== beats[0] && beat.layout !== "image");
+    const slots = open.length ? open : own;
+    const shown = /* @__PURE__ */ new Set();
+    slots.forEach((beat, slot) => {
+      const from = Math.floor(slot * items.length / slots.length);
+      const to = Math.max(from + 1, Math.floor((slot + 1) * items.length / slots.length));
+      const refs = items.slice(from, to).filter((item) => item.continuous || !shown.has(item.ref)).slice(0, PRESENTATION_LIMITS.mediaPerBeat).map((item) => item.ref);
+      for (const ref of refs) shown.add(ref);
+      if (refs.length) beat.media = refs;
+    });
+  }
+  for (const beat of beats) {
+    if (!beat.media) continue;
+    if (!worded.has(beat.id)) {
+      const points = beat.points.slice(0, FEATURE_POINTS);
+      beat.points = suggested.has(beat.id) ? points : points.map(featurePointText);
+    }
+    if (beat.layout === "steps" && hintFor(beat)?.layout !== "steps") beat.layout = "list";
+    const passage = script.sourceText.slice(beat.sourceStart, beat.sourceEnd);
+    if (!presentationLayoutFits(
+      beat.layout,
+      beat.headline,
+      beat.points,
+      passage
+    ))
+      beat.layout = "statement";
+  }
   return { version: 1, sourceText: script.sourceText, origin, beats };
 }
 
@@ -2078,7 +2206,7 @@ function compilePresentationPlan(doc, plan) {
     );
   if (narration && narration.sourceText !== checked.sourceText)
     throw new Error(
-      "The narration no longer matches the document. Generate narration again before presenting."
+      "The narration no longer matches the document. Record or generate narration again before presenting."
     );
   if (narration && flattenRenderableBlocks(doc.blocks).some((block) => {
     const pin = getPinnedBlockMeta(block);
@@ -2102,7 +2230,7 @@ function compilePresentationPlan(doc, plan) {
   );
   if (checked.beats.some((beat) => beat.media?.some((ref) => !media.has(ref))))
     throw new Error(
-      "A presentation video or diagram is no longer in the document. Make the presentation again."
+      "A presentation table, picture, video or diagram is no longer in the document. Make the presentation again."
     );
   const duration = narration ? narration.startTime + narration.duration : Math.max(4, script.tokens.length / 2.5);
   const bookmarks = (narration?.bookmarks ?? []).filter(
@@ -2129,20 +2257,17 @@ function compilePresentationPlan(doc, plan) {
     const share = span > 0 ? (tokensBefore(offset) - tokensBefore(from.charOffset)) / span : 0;
     return from.time + share * Math.max(0, to.time - from.time);
   };
+  const timeAt = (offset) => {
+    const marked = markedTime(offset);
+    if (marked !== void 0) return marked;
+    if (narration && bookmarks.length)
+      return bookmarks.find((word) => word.charOffset >= offset)?.time ?? duration;
+    return (narration?.startTime ?? 0) + tokensBefore(offset) / Math.max(1, script.tokens.length) * (narration?.duration ?? duration);
+  };
   let previous = 0;
   const starts = checked.beats.map((beat, index) => {
     if (!index) return 0;
-    let time;
-    const marked = markedTime(beat.sourceStart);
-    if (marked !== void 0) {
-      time = marked;
-    } else if (narration && bookmarks.length) {
-      time = bookmarks.find((word) => word.charOffset >= beat.sourceStart)?.time ?? duration;
-    } else {
-      const before = script.tokens.filter((token) => token.charOffset < beat.sourceStart).length;
-      time = (narration?.startTime ?? 0) + before / Math.max(1, script.tokens.length) * (narration?.duration ?? duration);
-    }
-    previous = Math.min(duration, Math.max(previous, time));
+    previous = Math.min(duration, Math.max(previous, timeAt(beat.sourceStart)));
     return previous;
   });
   const authoredBlocks = flattenRenderableBlocks(doc.blocks);
@@ -2229,8 +2354,16 @@ function compilePresentationPlan(doc, plan) {
       });
       continue;
     }
-    const block = visualBlock(beat, beat.layout, base, index);
-    blocks.push(block);
+    const table = beat.layout !== "image" && (beat.media ?? []).some((ref) => media.get(ref).kind === "table");
+    const block = table ? tableFeatureBlock(beat, beat.layout, base, contents) : visualBlock(beat, beat.layout, base, index);
+    const concept = conceptTemplate(block.template);
+    blocks.push({
+      ...block,
+      ...contents.length ? { summaryMode: "brief" } : {},
+      // A concept slide reveals its ideas one at a time, each as the narration
+      // reaches the sentence it summarizes (`conceptReveal`).
+      ...concept && !build ? conceptReveal(concept, beat, start, end, script.sourceText, timeAt) : {}
+    });
   }
   return {
     ...doc,
@@ -2242,6 +2375,65 @@ function compilePresentationPlan(doc, plan) {
     audio: doc.audio.segments.some((segment) => segment.src) ? doc.audio : { segments: [{ src: "", name: "presentation-clock", startTime: 0, duration }] }
   };
 }
+var CONCEPT_TEMPLATES = ["cards", "process", "cycle", "layers"];
+function conceptTemplate(template) {
+  return CONCEPT_TEMPLATES.find((name) => name === template);
+}
+function stems(text3) {
+  return (text3.toLowerCase().match(/[\p{L}\p{N}][\p{L}\p{N}'-]*/gu) ?? []).filter((word) => word.length >= 4).map((word) => word.slice(0, 5));
+}
+function conceptReveal(template, beat, start, end, sourceText, timeAt) {
+  const build = { mode: "items", effect: "fadeInUp", previous: "keep" };
+  const steps = conceptBuildStepTexts(template, beat.points);
+  const passage = sourceText.slice(beat.sourceStart, beat.sourceEnd);
+  const sentences = [...passage.matchAll(/[^.!?\n]+[.!?]*/gu)].map((match) => ({
+    offset: beat.sourceStart + match.index,
+    words: new Set(stems(match[0]))
+  }));
+  let last = -1;
+  const offsets = [];
+  for (const point of beat.points.slice(0, steps.length)) {
+    const words = stems(point);
+    let best;
+    for (const sentence of sentences) {
+      const shared = words.filter((word) => sentence.words.has(word)).length;
+      if (shared > (best?.shared ?? 1)) best = { offset: sentence.offset, shared };
+    }
+    if (!best || best.offset < last) return { build };
+    offsets.push(last = best.offset);
+  }
+  if (offsets.length !== steps.length) return { build };
+  const lead = Math.min(0.5, (end - start) / 8);
+  const starts = offsets.map(
+    (offset) => Math.min(Math.max(0, end - start - 0.1), Math.max(lead, timeAt(offset) - start))
+  );
+  starts[0] = Math.min(starts[0], Math.max(lead, Math.min(1, (end - start) / 6)));
+  return {
+    build,
+    buildTiming: {
+      sourceText: buildSourceText(steps.map((text3, index) => ({ id: `build-${index}`, text: text3 }))),
+      starts
+    }
+  };
+}
+function tableFeatureBlock(beat, layout, base, features) {
+  const paragraph = (text3) => ({
+    type: "paragraph",
+    children: [{ type: "text", value: text3 }]
+  });
+  const words = ["list", "steps", "comparison"].includes(layout) && beat.points.length > 1 ? [
+    {
+      type: "list",
+      ordered: false,
+      children: beat.points.map((point) => ({
+        type: "listItem",
+        children: [paragraph(point)]
+      }))
+    }
+  ] : beat.points.map(paragraph);
+  const block = { ...base, template: "bottomFeature", title: beat.headline };
+  return Object.assign(block, { contents: [...words, ...features] });
+}
 function visualBlock(beat, layout, base, index) {
   const colorScheme = ["blue", "green", "orange"][index % 3];
   switch (layout) {
@@ -2250,52 +2442,40 @@ function visualBlock(beat, layout, base, index) {
     case "divider":
       return { ...base, template: "sectionHeader", title: beat.headline, colorScheme };
     case "emphasis":
-      return { ...base, template: "bigText", title: beat.headline };
+      return { ...base, template: "cards", items: [beat.headline] };
     case "quote":
       return { ...base, template: "fullBleedQuote", text: beat.headline, colorScheme };
     case "stat": {
       const { match, line, index: at } = presentationStat(beat.headline, beat.points);
-      const detail = beat.points.find((_, i) => i !== at) ?? (at < 0 ? void 0 : beat.headline);
+      const others = beat.points.filter((_, i) => i !== at);
+      const [description, detail] = at < 0 ? others : [line, others[0]];
       return {
         ...base,
         template: "statHighlight",
+        headline: beat.headline,
         stat: match.value,
-        description: line,
-        ...detail ? { detail } : {},
-        colorScheme
+        description: description ?? "",
+        ...detail ? { detail } : {}
       };
     }
     case "definition":
       return {
         ...base,
-        template: "definitionCard",
-        term: beat.headline,
-        definition: beat.points.join("\n\n"),
-        colorScheme
+        template: "cards",
+        title: beat.headline,
+        items: beat.points.length ? [beat.points.map((point) => point.trim().replace(/([^.!?])$/u, "$1.")).join(" ")] : []
       };
     case "statement":
-      return {
-        ...base,
-        template: "factCard",
-        fact: beat.headline,
-        explanation: beat.points.join("\n\n")
-      };
+      return beat.points.length ? { ...base, template: "cards", title: beat.headline, items: beat.points } : { ...base, template: "factCard", fact: beat.headline, explanation: "" };
     case "list":
+      return { ...base, template: "cards", title: beat.headline, items: beat.points };
+    case "comparison":
       return {
         ...base,
-        template: "list",
+        template: "cards",
         title: beat.headline,
         items: beat.points,
-        ordered: false,
-        colorScheme
-      };
-    case "comparison":
-      return {
-        ...base,
-        template: "twoColumn",
-        header: beat.headline,
-        left: { label: beat.points[0] },
-        right: { label: beat.points[1] }
+        ...beat.points.length === 2 ? { versus: true } : {}
       };
     case "image":
       return {
@@ -2308,22 +2488,14 @@ function visualBlock(beat, layout, base, index) {
         ambientMotion: "zoomIn"
       };
     case "steps":
-      return {
-        ...base,
-        template: "diagram",
-        background: "surface",
-        title: beat.headline,
-        colorScheme,
-        nodes: beat.points.map((point, i) => ({
-          id: `step-${i}`,
-          label: point,
-          x: i * 320,
-          y: 0,
-          w: 260,
-          h: 180
-        })),
-        edges: beat.points.slice(1).map((_, i) => ({ source: `step-${i}`, target: `step-${i + 1}`, directed: true }))
-      };
+    case "process":
+      return { ...base, template: "process", title: beat.headline, items: beat.points };
+    case "cards":
+      return { ...base, template: "cards", title: beat.headline, items: beat.points };
+    case "cycle":
+      return { ...base, template: "cycle", title: beat.headline, items: beat.points };
+    case "layers":
+      return { ...base, template: "layers", title: beat.headline, items: beat.points };
   }
 }
 function applySavedPresentation(doc) {
@@ -2371,13 +2543,13 @@ export {
   serializePresentationHints,
   presentationSections,
   usesDynamicPresentation,
-  extractDocImages,
-  analyzeBlocks,
   DEFAULT_TRANSFORM_STYLE_ID,
   createTransformStyleRegistry,
   resolveTransformStyle,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  extractDocImages,
+  analyzeBlocks,
   allocateTiming,
   applyTransform,
   transformNarratedSegment,