@bendyline/squisq 2.11.17 → 2.11.18

package/dist/{chunk-KNC4ZBQC.js → chunk-NM747LUO.js}

@@ -1,19 +1,21 @@
 import {
-  extractContent,
-  mapElementToBlock,
-  stripMarkdown
-} from "./chunk-SVN7T6BK.js";
-import {
+  buildNarrationScript,
   coerceTemplateParams,
   deriveTemplateInputs,
   flattenRenderableBlocks,
+  getPinnedBlockMeta,
   markdownToDoc
-} from "./chunk-L7IIFWWW.js";
+} from "./chunk-7IGKCHDP.js";
 import {
   isAsciiDiagramFence,
   isAsciiTimelineFence,
   isTreeFence
 } from "./chunk-A5QJJZ5S.js";
+import {
+  extractContent,
+  mapElementToBlock,
+  stripMarkdown
+} from "./chunk-SVN7T6BK.js";
 import {
   cloneAndFreezeData,
   isTemplateBlock
@@ -37,6 +39,288 @@ import {
   hashString
 } from "./chunk-XRW6P7IF.js";
 
+// src/transform/presentationPlan.ts
+var PRESENTATION_KEY = "squisq-presentation";
+var PRESENTATION_LAYOUTS = [
+  "title",
+  "statement",
+  "list",
+  "comparison",
+  "steps",
+  "image"
+];
+var PRESENTATION_LIMITS = {
+  sourceCharacters: 4e4,
+  beats: 80,
+  serializedCharacters: 16e4
+};
+function record(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function keys(value, required, optional = []) {
+  return required.every((key) => Object.prototype.hasOwnProperty.call(value, key)) && Object.keys(value).every((key) => required.includes(key) || optional.includes(key));
+}
+function text(value, max) {
+  return typeof value === "string" && value.trim().length > 0 && value.length <= max && !Array.from(value).some((character) => {
+    const code = character.charCodeAt(0);
+    return code < 32 && code !== 9 && code !== 10 && code !== 13;
+  });
+}
+function parsePresentationPlan(input) {
+  let value = input;
+  if (typeof value === "string") {
+    if (value.length > PRESENTATION_LIMITS.serializedCharacters) return null;
+    try {
+      value = JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  if (!record(value) || !keys(value, ["version", "sourceText", "origin", "beats"]) || value.version !== 1 || !text(value.sourceText, PRESENTATION_LIMITS.sourceCharacters) || typeof value.origin !== "string" || !["automatic", "ai"].includes(value.origin) || !Array.isArray(value.beats) || !value.beats.length || value.beats.length > PRESENTATION_LIMITS.beats)
+    return null;
+  const beats = [];
+  const ids = /* @__PURE__ */ new Set();
+  let end = 0;
+  for (const beat of value.beats) {
+    if (!record(beat) || !keys(
+      beat,
+      ["id", "sourceStart", "sourceEnd", "layout", "headline", "points"],
+      ["imageSrc"]
+    ) || !text(beat.id, 80) || ids.has(beat.id) || !Number.isInteger(beat.sourceStart) || !Number.isInteger(beat.sourceEnd) || typeof beat.sourceStart !== "number" || typeof beat.sourceEnd !== "number" || beat.sourceStart < end || beat.sourceEnd <= beat.sourceStart || beat.sourceEnd > value.sourceText.length || value.sourceText.slice(end, beat.sourceStart).trim() || !PRESENTATION_LAYOUTS.includes(beat.layout) || !text(beat.headline, 110) || !Array.isArray(beat.points) || beat.points.length > 4 || !beat.points.every((point) => text(point, 180)))
+      return null;
+    if (["comparison", "steps", "list"].includes(String(beat.layout)) && beat.points.length < 2)
+      return null;
+    if (beat.layout === "comparison" && beat.points.length !== 2) return null;
+    if (beat.layout === "image" ? !text(beat.imageSrc, 2048) : "imageSrc" in beat) return null;
+    ids.add(beat.id);
+    end = beat.sourceEnd;
+    beats.push({
+      id: beat.id,
+      sourceStart: beat.sourceStart,
+      sourceEnd: beat.sourceEnd,
+      layout: beat.layout,
+      headline: beat.headline,
+      points: [...beat.points],
+      ...beat.layout === "image" ? { imageSrc: beat.imageSrc } : {}
+    });
+  }
+  if (value.sourceText.slice(end).trim()) return null;
+  return {
+    version: 1,
+    sourceText: value.sourceText,
+    origin: value.origin,
+    beats
+  };
+}
+function serializePresentationPlan(plan) {
+  const parsed = parsePresentationPlan(plan);
+  if (!parsed) throw new Error("The presentation plan is invalid.");
+  const result = JSON.stringify(parsed);
+  if (result.length > PRESENTATION_LIMITS.serializedCharacters)
+    throw new Error("The presentation plan is too large.");
+  return result;
+}
+
+// src/transform/presentationHints.ts
+var PRESENTATION_HINTS_KEY = "squisq-presentation-hints";
+var DYNAMIC_PRESENTATION_STYLE = "dynamic-slides";
+function defaultPresentationHints() {
+  return { version: 1, density: "balanced", inbetweens: true, blocks: [] };
+}
+function record2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function exact(value, required, optional = []) {
+  return required.every((key) => Object.prototype.hasOwnProperty.call(value, key)) && Object.keys(value).every((key) => required.includes(key) || optional.includes(key));
+}
+function text2(value, max) {
+  return typeof value === "string" && !!value.trim() && value.length <= max && [...value].every((char) => char.charCodeAt(0) >= 32 || ["\n", "\r", "	"].includes(char));
+}
+function parsePresentationHints(input) {
+  let value = input;
+  if (typeof value === "string") {
+    if (value.length > 16e4) return null;
+    try {
+      value = JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  if (!record2(value) || !exact(value, ["version", "density", "inbetweens", "blocks"]) || value.version !== 1 || !["concise", "balanced", "detailed"].includes(String(value.density)) || typeof value.inbetweens !== "boolean" || !Array.isArray(value.blocks) || value.blocks.length > 80)
+    return null;
+  const ids = /* @__PURE__ */ new Set();
+  const blocks = [];
+  for (const entry of value.blocks) {
+    if (!record2(entry) || !exact(entry, ["blockId"], ["layout", "inbetweens", "wording", "ai"]) || !text2(entry.blockId, 1024) || ids.has(entry.blockId) || entry.layout !== void 0 && !PRESENTATION_LAYOUTS.includes(entry.layout) || entry.inbetweens !== void 0 && typeof entry.inbetweens !== "boolean")
+      return null;
+    const hint = { blockId: entry.blockId };
+    if (entry.layout !== void 0) hint.layout = entry.layout;
+    if (entry.inbetweens !== void 0) hint.inbetweens = entry.inbetweens;
+    if (entry.ai !== void 0) {
+      if (!Array.isArray(entry.ai) || entry.ai.length > 80) return null;
+      hint.ai = [];
+      for (const item of entry.ai) {
+        if (!record2(item) || !exact(item, ["source", "layout", "headline", "points"]) || !text2(item.source, 4e3) || !PRESENTATION_LAYOUTS.includes(item.layout) || !text2(item.headline, 110) || !Array.isArray(item.points) || item.points.length > 4 || !item.points.every((point) => text2(point, 180)) || ["list", "steps"].includes(String(item.layout)) && item.points.length < 2 || item.layout === "comparison" && item.points.length !== 2)
+          return null;
+        hint.ai.push({
+          source: item.source,
+          layout: item.layout,
+          headline: item.headline,
+          points: [...item.points]
+        });
+      }
+    }
+    if (entry.wording !== void 0) {
+      const wording = entry.wording;
+      if (!record2(wording) || !exact(wording, ["source"], ["headline", "points"]) || !text2(wording.source, 4e4) || wording.headline === void 0 && wording.points === void 0 || wording.headline !== void 0 && !text2(wording.headline, 110) || wording.points !== void 0 && (!Array.isArray(wording.points) || wording.points.length > 4 || !wording.points.every((point) => text2(point, 180))))
+        return null;
+      hint.wording = {
+        source: wording.source,
+        ...wording.headline !== void 0 ? { headline: wording.headline } : {},
+        ...wording.points !== void 0 ? { points: [...wording.points] } : {}
+      };
+    }
+    ids.add(entry.blockId);
+    blocks.push(hint);
+  }
+  return {
+    version: 1,
+    density: value.density,
+    inbetweens: value.inbetweens,
+    blocks
+  };
+}
+function serializePresentationHints(hints) {
+  const parsed = parsePresentationHints(hints);
+  if (!parsed) throw new Error("The slide hints are invalid.");
+  const json = JSON.stringify(parsed);
+  if (json.length > 16e4) throw new Error("The slide hints are too large.");
+  return json;
+}
+function presentationSections(doc) {
+  const script = buildNarrationScript(doc);
+  return script.blocks.map((block) => ({
+    blockId: block.blockId,
+    heading: block.heading,
+    sourceStart: block.charStart,
+    sourceEnd: block.charEnd,
+    text: script.sourceText.slice(block.charStart, block.charEnd)
+  }));
+}
+function usesDynamicPresentation(doc) {
+  const fm = doc.frontmatter ?? {};
+  const style = Object.prototype.hasOwnProperty.call(fm, "squisq-transform") ? fm["squisq-transform"] : fm["transform-style"];
+  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");
+}
+function collectImages(node) {
+  const results = [];
+  if ("type" in node && node.type === "image" && "url" in node) {
+    const img = node;
+    if (img.url) {
+      results.push({ src: img.url, alt: img.alt ?? "" });
+    }
+  }
+  for (const child of getChildren(node)) {
+    results.push(...collectImages(child));
+  }
+  return results;
+}
+function extractBlockImages(block, blockIndex) {
+  if (!block.contents || block.contents.length === 0) return [];
+  const images = [];
+  for (const node of block.contents) {
+    for (const img of collectImages(node)) {
+      images.push({ ...img, sourceBlockIndex: blockIndex });
+    }
+  }
+  return images;
+}
+function extractDocImages(blocks) {
+  const seen = /* @__PURE__ */ new Set();
+  const images = [];
+  function walk(blockList) {
+    for (const block of blockList) {
+      if (block.contents) {
+        for (const node of block.contents) {
+          for (const img of collectImages(node)) {
+            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(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",
+  name: "Dynamic slides",
+  description: "Advanced summarization: generate concise slides and diagrams from the current text and your hints",
+  contentMode: "presentation",
+  minConfidence: 0.25,
+  transformRatio: 1,
+  preferredTypes: [],
+  colorSchemes: ["blue", "green", "orange"],
+  insertSectionHeaders: false,
+  interleaveImages: false,
+  blocksPerSection: { max: 4 },
+  transitionStyle: "fade"
+};
+
 // src/transform/styles/documentary.ts
 var documentaryStyle = {
   id: "documentary",
@@ -144,6 +428,7 @@ var headingsAndFeaturesStyle = {
 
 // src/transform/registry.ts
 var TRANSFORM_STYLES = Object.freeze({
+  [dynamicSlidesStyle.id]: cloneAndFreezeData(dynamicSlidesStyle),
   [documentaryStyle.id]: cloneAndFreezeData(documentaryStyle),
   [magazineStyle.id]: cloneAndFreezeData(magazineStyle),
   [dataDrivenStyle.id]: cloneAndFreezeData(dataDrivenStyle),
@@ -179,8 +464,8 @@ function validateTransformStyle(style) {
       fail(`${key} must be a finite number between 0 and 1`);
     }
   }
-  if (candidate.contentMode !== void 0 && candidate.contentMode !== "brief" && candidate.contentMode !== "headings-and-features") {
-    fail("contentMode must be brief or headings-and-features");
+  if (candidate.contentMode !== void 0 && candidate.contentMode !== "brief" && candidate.contentMode !== "headings-and-features" && candidate.contentMode !== "presentation") {
+    fail("contentMode must be brief, headings-and-features, or presentation");
   }
   if (!Array.isArray(candidate.preferredTypes) || candidate.preferredTypes.some((type) => !EXTRACTION_TYPES.has(type))) {
     fail("preferredTypes contains an unknown extraction type");
@@ -297,96 +582,202 @@ function getTransformStyleSummaries(registry) {
   });
 }
 
-// src/transform/blockAnalyzer.ts
-function contentsToPlainText(contents) {
-  return contents.map((node) => extractPlainText(node)).join("\n");
+// src/transform/timingAllocator.ts
+var MIN_BLOCK_DURATION = 3;
+var MAX_BLOCK_DURATION = 20;
+var DEFAULT_BLOCK_DURATION = 6;
+function allocateTiming(blocks, totalDuration) {
+  if (blocks.length === 0) return [];
+  const hasAnchors = blocks.some(
+    (b) => isTemplateBlock(b) && typeof b.sourceStartTime === "number"
+  );
+  return hasAnchors ? allocateAnchored(blocks, totalDuration) : allocateRescaled(blocks, totalDuration);
 }
-function collectImages(node) {
-  const results = [];
-  if ("type" in node && node.type === "image" && "url" in node) {
-    const img = node;
-    if (img.url) {
-      results.push({ src: img.url, alt: img.alt ?? "" });
+function allocateRescaled(blocks, totalDuration) {
+  const effectiveDuration = totalDuration > 0 ? totalDuration : estimateDefaultDuration(blocks);
+  const durations = blocks.map((block) => {
+    if (!isTemplateBlock(block) && block.duration > 0) {
+      return block.duration;
+    }
+    if (isTemplateBlock(block) && block.duration > 0) {
+      return block.duration;
     }
+    return DEFAULT_BLOCK_DURATION;
+  });
+  const rawTotal = durations.reduce((sum, d) => sum + d, 0);
+  if (rawTotal > 0 && effectiveDuration > 0) {
+    fitDurations(durations, effectiveDuration);
   }
-  for (const child of getChildren(node)) {
-    results.push(...collectImages(child));
+  let currentTime = 0;
+  const result = [];
+  for (let i = 0; i < blocks.length; i++) {
+    result.push(toOutputBlock(blocks[i], currentTime, durations[i]));
+    currentTime += durations[i];
   }
-  return results;
+  return result;
 }
-function extractBlockImages(block, blockIndex) {
-  if (!block.contents || block.contents.length === 0) return [];
-  const images = [];
-  for (const node of block.contents) {
-    for (const img of collectImages(node)) {
-      images.push({ ...img, sourceBlockIndex: blockIndex });
+var MIN_FLOATING_DURATION = 1;
+function allocateAnchored(blocks, totalDuration) {
+  const entries = blocks.map((block) => {
+    if (isTemplateBlock(block)) {
+      return {
+        block,
+        anchorStart: typeof block.sourceStartTime === "number" ? block.sourceStartTime : null,
+        rawDuration: block.duration > 0 ? block.duration : DEFAULT_BLOCK_DURATION
+      };
     }
-  }
-  return images;
-}
-function extractDocImages(blocks) {
-  const seen = /* @__PURE__ */ new Set();
-  const images = [];
-  function walk(blockList) {
-    for (const block of blockList) {
-      if (block.contents) {
-        for (const node of block.contents) {
-          for (const img of collectImages(node)) {
-            if (!seen.has(img.src)) {
-              seen.add(img.src);
-              images.push({ src: img.src, alt: img.alt });
-            }
-          }
-        }
+    return {
+      block,
+      anchorStart: block.startTime,
+      rawDuration: block.duration > 0 ? block.duration : DEFAULT_BLOCK_DURATION
+    };
+  });
+  const starts = new Array(entries.length);
+  let cursor = 0;
+  let seenAnchor = false;
+  let i = 0;
+  while (i < entries.length) {
+    const entry = entries[i];
+    if (entry.anchorStart !== null) {
+      const start = Math.max(cursor, entry.anchorStart);
+      starts[i] = start;
+      const hint = isTemplateBlock(entry.block) ? entry.block.sourceDuration ?? entry.rawDuration : entry.rawDuration;
+      cursor = start + Math.max(MIN_FLOATING_DURATION, hint);
+      seenAnchor = true;
+      i++;
+      continue;
+    }
+    const runStart = i;
+    while (i < entries.length && entries[i].anchorStart === null) i++;
+    const run = entries.slice(runStart, i);
+    const rawSum = run.reduce((sum, e) => sum + e.rawDuration, 0);
+    const nextAnchorStart = i < entries.length ? Math.max(entries[i].anchorStart ?? cursor, cursor) : null;
+    if (nextAnchorStart === null) {
+      let acc = cursor;
+      for (let k = 0; k < run.length; k++) {
+        starts[runStart + k] = acc;
+        acc += run[k].rawDuration;
       }
-      if (block.children) {
-        walk(block.children);
+      cursor = acc;
+    } else if (!seenAnchor) {
+      const gap = nextAnchorStart - cursor;
+      let acc = cursor;
+      for (let k = 0; k < run.length; k++) {
+        starts[runStart + k] = acc;
+        acc += rawSum > 0 ? run[k].rawDuration / rawSum * gap : gap / run.length;
       }
+      cursor = nextAnchorStart;
+    } else {
+      const gap = Math.max(0, nextAnchorStart - cursor);
+      const scale = rawSum > 0 ? Math.min(1, gap / rawSum) : 0;
+      let acc = Math.max(cursor, nextAnchorStart - rawSum * scale);
+      for (let k = 0; k < run.length; k++) {
+        starts[runStart + k] = acc;
+        acc += run[k].rawDuration * scale;
+      }
+      cursor = nextAnchorStart;
     }
   }
-  walk(blocks);
-  return images;
-}
-function collectLeafBlocks(blocks) {
+  for (let k = 0; k < starts.length; k++) {
+    const floor = k > 0 ? starts[k - 1] + MIN_FLOATING_DURATION : 0;
+    if (starts[k] < floor) starts[k] = floor;
+  }
   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));
+  for (let k = 0; k < entries.length; k++) {
+    const entry = entries[k];
+    let duration;
+    if (k + 1 < entries.length) {
+      duration = Math.max(MIN_FLOATING_DURATION, starts[k + 1] - starts[k]);
     } else {
-      result.push(block);
+      const authored = isTemplateBlock(entry.block) ? entry.block.sourceDuration ?? entry.rawDuration : entry.rawDuration;
+      duration = Math.max(MIN_FLOATING_DURATION, authored, totalDuration - starts[k]);
     }
+    result.push(toOutputBlock(entry.block, starts[k], duration));
   }
   return result;
 }
-function analyzeBlocks(blocks, options) {
-  return analyzeFlatBlocks(collectLeafBlocks(blocks), options);
+function toOutputBlock(block, startTime, duration) {
+  if (isTemplateBlock(block)) {
+    return {
+      ...block,
+      startTime,
+      duration,
+      title: getTemplateTitle(block)
+    };
+  }
+  return { ...block, startTime, duration };
 }
-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;
+function clampDuration(d) {
+  return Math.max(MIN_BLOCK_DURATION, Math.min(MAX_BLOCK_DURATION, d));
+}
+var SCALE_SEARCH_ITERATIONS = 60;
+function totalAtScale(durations, scale) {
+  let sum = 0;
+  for (const d of durations) sum += clampDuration(d * scale);
+  return sum;
+}
+function fitDurations(durations, target) {
+  const rawTotal = durations.reduce((sum, d) => sum + d, 0);
+  if (rawTotal <= 0) return;
+  const plain = target / rawTotal;
+  const clampsNothing = durations.every((d) => {
+    const scaled = d * plain;
+    return scaled >= MIN_BLOCK_DURATION && scaled <= MAX_BLOCK_DURATION;
+  });
+  if (clampsNothing) {
+    for (let i = 0; i < durations.length; i++) durations[i] *= plain;
+    return;
+  }
+  let lo = 0;
+  let hi = 1;
+  for (let i = 0; i < SCALE_SEARCH_ITERATIONS && totalAtScale(durations, hi) < target; i++) {
+    hi *= 2;
+  }
+  for (let i = 0; i < SCALE_SEARCH_ITERATIONS; i++) {
+    const mid = (lo + hi) / 2;
+    if (totalAtScale(durations, mid) < target) lo = mid;
+    else hi = mid;
+  }
+  const scale = (lo + hi) / 2;
+  let clampedTotal = 0;
+  let freeRaw = 0;
+  for (const d of durations) {
+    const scaled = d * scale;
+    if (scaled < MIN_BLOCK_DURATION) clampedTotal += MIN_BLOCK_DURATION;
+    else if (scaled > MAX_BLOCK_DURATION) clampedTotal += MAX_BLOCK_DURATION;
+    else freeRaw += d;
+  }
+  const exact2 = freeRaw > 0 ? (target - clampedTotal) / freeRaw : scale;
+  const finalScale = Number.isFinite(exact2) && exact2 > 0 ? exact2 : scale;
+  for (let i = 0; i < durations.length; i++) {
+    durations[i] = clampDuration(durations[i] * finalScale);
+  }
+}
+function estimateDefaultDuration(blocks) {
+  let totalSeconds = 0;
+  for (const block of blocks) {
+    if (!isTemplateBlock(block) && block.duration > 0) {
+      totalSeconds += block.duration;
+    } else {
+      totalSeconds += DEFAULT_BLOCK_DURATION;
     }
-    const stripped = stripMarkdown(plainText);
-    const bodyWordCount = stripped.split(/\s+/).filter((w) => w.length > 0).length;
-    const extraction = extractContent(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;
+  return Math.max(totalSeconds, blocks.length * MIN_BLOCK_DURATION);
+}
+function getTemplateTitle(block) {
+  if ("title" in block && typeof block.title === "string") {
+    return block.title;
+  }
+  if ("stat" in block && typeof block.stat === "string") {
+    return block.stat;
+  }
+  if ("fact" in block && typeof block.fact === "string") {
+    return block.fact;
+  }
+  if ("quote" in block && typeof block.quote === "string") {
+    return block.quote.slice(0, 60);
+  }
+  return void 0;
 }
 
 // src/transform/contentSummary.ts
@@ -418,8 +809,8 @@ var PROSE_KEYS = /* @__PURE__ */ new Set([
   "quote",
   "text"
 ]);
-function briefText(text) {
-  const normalized = text.replace(/\s+/g, " ").trim();
+function briefText(text3) {
+  const normalized = text3.replace(/\s+/g, " ").trim();
   const sentence = normalized.match(/^.*?[.!?](?:["'”’])?(?=\s|$)/)?.[0] ?? normalized;
   const words = sentence.split(/\s+/).filter(Boolean);
   let brief = words.slice(0, 24).join(" ");
@@ -480,11 +871,11 @@ function extractFeatureContents(contents, keepData = false) {
   for (const node of contents ?? []) visit(node);
   return features;
 }
-function withoutProse(record) {
-  return record && Object.fromEntries(Object.entries(record).filter(([key]) => !PROSE_KEYS.has(key)));
+function withoutProse(record3) {
+  return record3 && Object.fromEntries(Object.entries(record3).filter(([key]) => !PROSE_KEYS.has(key)));
 }
 function typedMediaContents(block) {
-  const record = {
+  const record3 = {
     ...block,
     ...block.templateData,
     ...coerceTemplateParams(block.template ?? "", block.templateOverrides ?? {}).input
@@ -498,23 +889,23 @@ function typedMediaContents(block) {
       });
     }
   };
-  addImage(record.imageSrc, record.imageAlt);
+  addImage(record3.imageSrc, record3.imageAlt);
   for (const key of ["accentImage", "backgroundImage"]) {
-    const image = record[key];
+    const image = record3[key];
     if (image && typeof image === "object") {
       const data = image;
       addImage(data.src, data.alt);
     }
   }
-  if (Array.isArray(record.images)) {
-    for (const image of record.images) {
+  if (Array.isArray(record3.images)) {
+    for (const image of record3.images) {
       if (image && typeof image === "object") {
         const data = image;
         addImage(data.src, data.alt);
       }
     }
   }
-  if (typeof record.videoSrc === "string" && record.videoSrc) {
+  if (typeof record3.videoSrc === "string" && record3.videoSrc) {
     const htmlChildren = [
       {
         type: "htmlElement",
@@ -522,8 +913,8 @@ function typedMediaContents(block) {
         selfClosing: false,
         children: [],
         attributes: {
-          src: record.videoSrc,
-          ...typeof record.posterSrc === "string" ? { poster: record.posterSrc } : {}
+          src: record3.videoSrc,
+          ...typeof record3.posterSrc === "string" ? { poster: record3.posterSrc } : {}
         }
       }
     ];
@@ -833,207 +1224,27 @@ function translateTemplateBlock(block, target) {
   return null;
 }
 
-// src/transform/timingAllocator.ts
-var MIN_BLOCK_DURATION = 3;
-var MAX_BLOCK_DURATION = 20;
-var DEFAULT_BLOCK_DURATION = 6;
-function allocateTiming(blocks, totalDuration) {
-  if (blocks.length === 0) return [];
-  const hasAnchors = blocks.some(
-    (b) => isTemplateBlock(b) && typeof b.sourceStartTime === "number"
-  );
-  return hasAnchors ? allocateAnchored(blocks, totalDuration) : allocateRescaled(blocks, totalDuration);
-}
-function allocateRescaled(blocks, totalDuration) {
-  const effectiveDuration = totalDuration > 0 ? totalDuration : estimateDefaultDuration(blocks);
-  const durations = blocks.map((block) => {
-    if (!isTemplateBlock(block) && block.duration > 0) {
-      return block.duration;
-    }
-    if (isTemplateBlock(block) && block.duration > 0) {
-      return block.duration;
-    }
-    return DEFAULT_BLOCK_DURATION;
-  });
-  const rawTotal = durations.reduce((sum, d) => sum + d, 0);
-  if (rawTotal > 0 && effectiveDuration > 0) {
-    fitDurations(durations, effectiveDuration);
-  }
-  let currentTime = 0;
-  const result = [];
-  for (let i = 0; i < blocks.length; i++) {
-    result.push(toOutputBlock(blocks[i], currentTime, durations[i]));
-    currentTime += durations[i];
-  }
-  return result;
-}
-var MIN_FLOATING_DURATION = 1;
-function allocateAnchored(blocks, totalDuration) {
-  const entries = blocks.map((block) => {
-    if (isTemplateBlock(block)) {
-      return {
-        block,
-        anchorStart: typeof block.sourceStartTime === "number" ? block.sourceStartTime : null,
-        rawDuration: block.duration > 0 ? block.duration : DEFAULT_BLOCK_DURATION
-      };
-    }
+// src/transform/applyTransform.ts
+function applyTransform(doc, style, options) {
+  const baseConfig = resolveTransformStyle(style, options?.registry);
+  if (baseConfig.contentMode === "presentation") {
     return {
-      block,
-      anchorStart: block.startTime,
-      rawDuration: block.duration > 0 ? block.duration : DEFAULT_BLOCK_DURATION
+      doc: {
+        ...doc,
+        frontmatter: { ...doc.frontmatter, "squisq-transform": DYNAMIC_PRESENTATION_STYLE }
+      },
+      stats: { totalInputBlocks: doc.blocks.length, transformedBlocks: 0, insertedBlocks: 0 }
     };
-  });
-  const starts = new Array(entries.length);
-  let cursor = 0;
-  let seenAnchor = false;
-  let i = 0;
-  while (i < entries.length) {
-    const entry = entries[i];
-    if (entry.anchorStart !== null) {
-      const start = Math.max(cursor, entry.anchorStart);
-      starts[i] = start;
-      const hint = isTemplateBlock(entry.block) ? entry.block.sourceDuration ?? entry.rawDuration : entry.rawDuration;
-      cursor = start + Math.max(MIN_FLOATING_DURATION, hint);
-      seenAnchor = true;
-      i++;
-      continue;
-    }
-    const runStart = i;
-    while (i < entries.length && entries[i].anchorStart === null) i++;
-    const run = entries.slice(runStart, i);
-    const rawSum = run.reduce((sum, e) => sum + e.rawDuration, 0);
-    const nextAnchorStart = i < entries.length ? Math.max(entries[i].anchorStart ?? cursor, cursor) : null;
-    if (nextAnchorStart === null) {
-      let acc = cursor;
-      for (let k = 0; k < run.length; k++) {
-        starts[runStart + k] = acc;
-        acc += run[k].rawDuration;
-      }
-      cursor = acc;
-    } else if (!seenAnchor) {
-      const gap = nextAnchorStart - cursor;
-      let acc = cursor;
-      for (let k = 0; k < run.length; k++) {
-        starts[runStart + k] = acc;
-        acc += rawSum > 0 ? run[k].rawDuration / rawSum * gap : gap / run.length;
-      }
-      cursor = nextAnchorStart;
-    } else {
-      const gap = Math.max(0, nextAnchorStart - cursor);
-      const scale = rawSum > 0 ? Math.min(1, gap / rawSum) : 0;
-      let acc = Math.max(cursor, nextAnchorStart - rawSum * scale);
-      for (let k = 0; k < run.length; k++) {
-        starts[runStart + k] = acc;
-        acc += run[k].rawDuration * scale;
-      }
-      cursor = nextAnchorStart;
-    }
-  }
-  for (let k = 0; k < starts.length; k++) {
-    const floor = k > 0 ? starts[k - 1] + MIN_FLOATING_DURATION : 0;
-    if (starts[k] < floor) starts[k] = floor;
-  }
-  const result = [];
-  for (let k = 0; k < entries.length; k++) {
-    const entry = entries[k];
-    let duration;
-    if (k + 1 < entries.length) {
-      duration = Math.max(MIN_FLOATING_DURATION, starts[k + 1] - starts[k]);
-    } else {
-      const authored = isTemplateBlock(entry.block) ? entry.block.sourceDuration ?? entry.rawDuration : entry.rawDuration;
-      duration = Math.max(MIN_FLOATING_DURATION, authored, totalDuration - starts[k]);
-    }
-    result.push(toOutputBlock(entry.block, starts[k], duration));
   }
-  return result;
-}
-function toOutputBlock(block, startTime, duration) {
-  if (isTemplateBlock(block)) {
+  if (Object.prototype.hasOwnProperty.call(doc.frontmatter ?? {}, PRESENTATION_KEY) && !usesDynamicPresentation(doc)) {
     return {
-      ...block,
-      startTime,
-      duration,
-      title: getTemplateTitle(block)
+      doc,
+      stats: { totalInputBlocks: doc.blocks.length, transformedBlocks: 0, insertedBlocks: 0 }
     };
   }
-  return { ...block, startTime, duration };
-}
-function clampDuration(d) {
-  return Math.max(MIN_BLOCK_DURATION, Math.min(MAX_BLOCK_DURATION, d));
-}
-var SCALE_SEARCH_ITERATIONS = 60;
-function totalAtScale(durations, scale) {
-  let sum = 0;
-  for (const d of durations) sum += clampDuration(d * scale);
-  return sum;
-}
-function fitDurations(durations, target) {
-  const rawTotal = durations.reduce((sum, d) => sum + d, 0);
-  if (rawTotal <= 0) return;
-  const plain = target / rawTotal;
-  const clampsNothing = durations.every((d) => {
-    const scaled = d * plain;
-    return scaled >= MIN_BLOCK_DURATION && scaled <= MAX_BLOCK_DURATION;
-  });
-  if (clampsNothing) {
-    for (let i = 0; i < durations.length; i++) durations[i] *= plain;
-    return;
-  }
-  let lo = 0;
-  let hi = 1;
-  for (let i = 0; i < SCALE_SEARCH_ITERATIONS && totalAtScale(durations, hi) < target; i++) {
-    hi *= 2;
-  }
-  for (let i = 0; i < SCALE_SEARCH_ITERATIONS; i++) {
-    const mid = (lo + hi) / 2;
-    if (totalAtScale(durations, mid) < target) lo = mid;
-    else hi = mid;
-  }
-  const scale = (lo + hi) / 2;
-  let clampedTotal = 0;
-  let freeRaw = 0;
-  for (const d of durations) {
-    const scaled = d * scale;
-    if (scaled < MIN_BLOCK_DURATION) clampedTotal += MIN_BLOCK_DURATION;
-    else if (scaled > MAX_BLOCK_DURATION) clampedTotal += MAX_BLOCK_DURATION;
-    else freeRaw += d;
-  }
-  const exact = freeRaw > 0 ? (target - clampedTotal) / freeRaw : scale;
-  const finalScale = Number.isFinite(exact) && exact > 0 ? exact : scale;
-  for (let i = 0; i < durations.length; i++) {
-    durations[i] = clampDuration(durations[i] * finalScale);
-  }
-}
-function estimateDefaultDuration(blocks) {
-  let totalSeconds = 0;
-  for (const block of blocks) {
-    if (!isTemplateBlock(block) && block.duration > 0) {
-      totalSeconds += block.duration;
-    } else {
-      totalSeconds += DEFAULT_BLOCK_DURATION;
-    }
-  }
-  return Math.max(totalSeconds, blocks.length * MIN_BLOCK_DURATION);
-}
-function getTemplateTitle(block) {
-  if ("title" in block && typeof block.title === "string") {
-    return block.title;
-  }
-  if ("stat" in block && typeof block.stat === "string") {
-    return block.stat;
-  }
-  if ("fact" in block && typeof block.fact === "string") {
-    return block.fact;
-  }
-  if ("quote" in block && typeof block.quote === "string") {
-    return block.quote.slice(0, 60);
+  if (usesDynamicPresentation(doc)) {
+    doc = { ...doc, frontmatter: { ...doc.frontmatter, "squisq-transform": baseConfig.id } };
   }
-  return void 0;
-}
-
-// src/transform/applyTransform.ts
-function applyTransform(doc, style, options) {
-  const baseConfig = resolveTransformStyle(style, options?.registry);
   const config = options?.overrides ? { ...baseConfig, ...options.overrides, id: baseConfig.id } : baseConfig;
   const seed = options?.seed ?? hashString(doc.articleId || "transform");
   const images = options?.images ?? extractDocImages(doc.blocks);
@@ -1334,21 +1545,21 @@ function standaloneImagePool(images, content) {
     ...available.filter((image) => accents.has(image.src))
   ];
 }
-function chunkNarration(text, count) {
-  if (count <= 1) return [text];
+function chunkNarration(text3, count) {
+  if (count <= 1) return [text3];
   const sentences = [];
   const boundary = /[.!?]["'’”)\]]*\s+/g;
   let start = 0;
   let match;
-  while ((match = boundary.exec(text)) !== null) {
+  while ((match = boundary.exec(text3)) !== null) {
     const end = match.index + match[0].length;
-    const sentence = text.slice(start, end).trim();
+    const sentence = text3.slice(start, end).trim();
     if (sentence) sentences.push(sentence);
     start = end;
   }
-  const tail = text.slice(start).trim();
+  const tail = text3.slice(start).trim();
   if (tail) sentences.push(tail);
-  if (sentences.length < 2) return [text];
+  if (sentences.length < 2) return [text3];
   const chunkCount = Math.min(count, sentences.length);
   const words = sentences.map((sentence) => sentence.split(/\s+/).length);
   const totalWords = words.reduce((sum, n) => sum + n, 0);
@@ -1419,15 +1630,335 @@ function videoBlock(video, index, segmentId, duration) {
   };
 }
 
+// src/transform/presentationPlanner.ts
+function clip(text3, words = 12) {
+  const clean = text3.replace(/\s+/g, " ").trim();
+  const parts = clean.split(" ");
+  return (parts.length > words ? parts.slice(0, words).join(" ") + "\u2026" : clean).slice(
+    0,
+    words === 12 ? 110 : 180
+  );
+}
+function field(block, key) {
+  if (!block || typeof block !== "object") return void 0;
+  const value = block[key];
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function createPresentationPlan(doc, hints = defaultPresentationHints()) {
+  if (!parsePresentationHints(hints)) throw new Error("The slide hints are invalid.");
+  const script = buildNarrationScript(doc);
+  if (!script.sourceText.trim()) throw new Error("Add some text before making a presentation.");
+  if (script.sourceText.length > PRESENTATION_LIMITS.sourceCharacters)
+    throw new Error(
+      "This document is too long for one presentation. Split it into shorter documents."
+    );
+  const images = extractDocImages(doc.blocks);
+  const beats = [];
+  const supportingOpeners = /* @__PURE__ */ new Set();
+  const wordLimit = { concise: 28, balanced: 42, detailed: 64 }[hints.density];
+  for (const block of script.blocks) {
+    const source = script.sourceText.slice(block.charStart, block.charEnd);
+    const words = [...source.matchAll(/\S+/gu)];
+    const hint = hints.blocks.find((item) => item.blockId === block.blockId);
+    const wording = hint?.wording?.source === source ? hint.wording : void 0;
+    const inbetweens = hint?.inbetweens ?? hints.inbetweens;
+    let first = 0;
+    while (first < words.length) {
+      let last = Math.min(first + wordLimit, words.length);
+      if (last < words.length) {
+        for (let cursor = last; cursor > first + 18; cursor--) {
+          if (/[.!?][”"')\]]?$/u.test(words[cursor - 1][0])) {
+            last = cursor;
+            break;
+          }
+        }
+      }
+      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);
+      const index = beats.length;
+      const suggested = transformNarratedSegment(
+        {
+          articleId: doc.articleId,
+          segmentId: `presentation-${index}`,
+          title: block.heading ?? "",
+          text: passage,
+          duration: Math.max(4, (last - first) / 2.5),
+          audioSrc: "",
+          includeTitleBlock: false
+        },
+        { slidesPerMinute: 4, minConfidence: 0.25, style: "documentary" }
+      ).doc.blocks[0];
+      const sentences = passage.split(/(?<=[.!?])\s+|\n+/u).map((part) => part.trim()).filter(Boolean);
+      const bodySentences = sentences.filter((part) => part !== block.heading);
+      let points = (bodySentences.length ? bodySentences : sentences).slice(0, 3).map((part) => clip(part, 22));
+      let headline = clip(
+        first === 0 && block.heading ? block.heading : field(suggested, "fact") ?? field(suggested, "description") ?? field(suggested, "quote") ?? sentences[0] ?? passage
+      );
+      if (!headline) headline = clip(passage);
+      let layout = index === 0 ? "title" : points.length >= 2 && index % 3 === 1 ? "list" : "statement";
+      if (points.length >= 2 && /\b(first|then|finally|steps?|next)\b/iu.test(passage))
+        layout = "steps";
+      if (points.length === 2 && /\b(versus|whereas|compared|instead)\b/iu.test(passage))
+        layout = "comparison";
+      const image = images.length && index > 0 && index % 3 === 2 ? images[Math.floor(index / 3) % images.length] : void 0;
+      if (image) layout = "image";
+      if (first === 0 && wording) {
+        headline = wording.headline ?? headline;
+        points = wording.points ?? points;
+      }
+      if (hint?.layout) {
+        const eligible = hint.layout === "image" ? !!image : hint.layout === "comparison" ? points.length === 2 : ["steps", "list"].includes(hint.layout) ? points.length >= 2 : true;
+        if (eligible) layout = hint.layout;
+      }
+      const beat = {
+        id: `beat-${index + 1}`,
+        sourceStart: start,
+        sourceEnd: end,
+        layout,
+        headline,
+        points,
+        ...layout === "image" && image ? { imageSrc: image.src } : {}
+      };
+      const explainer = inbetweens && last - first >= 24 && (layout === "steps" || layout === "comparison" || !!image);
+      if (explainer) {
+        const split = block.charStart + words[first + Math.floor((last - first) / 2)].index;
+        const { imageSrc: _image, ...textBeat } = beat;
+        supportingOpeners.add(`beat-${beats.length + 1}`);
+        beats.push({
+          ...textBeat,
+          id: `beat-${beats.length + 1}`,
+          layout: "statement",
+          sourceEnd: split
+        });
+        beats.push({ ...beat, id: `beat-${beats.length + 1}`, sourceStart: split });
+      } else beats.push(beat);
+      first = last;
+    }
+  }
+  if (beats.length > PRESENTATION_LIMITS.beats)
+    throw new Error(
+      "This document has too many sections for one presentation. Split it into shorter documents."
+    );
+  const closing = beats[beats.length - 1];
+  if (beats.length > 2 && closing?.layout === "statement" && !hints.blocks.some(
+    (hint) => hint.layout && script.blocks.some(
+      (block) => block.blockId === hint.blockId && closing.sourceStart >= block.charStart && closing.sourceStart < block.charEnd
+    )
+  ))
+    closing.layout = "title";
+  let origin = "automatic";
+  for (const beat of beats) {
+    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 cached = hint?.ai?.find(
+      (item) => item.source === script.sourceText.slice(beat.sourceStart, beat.sourceEnd)
+    );
+    if (cached && (cached.layout !== "image" || beat.imageSrc)) {
+      beat.headline = cached.headline;
+      beat.points = [...cached.points];
+      beat.layout = cached.layout;
+      origin = "ai";
+    }
+    if (hint?.layout && !supportingOpeners.has(beat.id) && (hint.layout !== "image" || beat.imageSrc) && (hint.layout !== "comparison" || beat.points.length === 2) && (!["steps", "list"].includes(hint.layout) || beat.points.length >= 2))
+      beat.layout = hint.layout;
+    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 (["steps", "list", "comparison"].includes(beat.layout) && (beat.points.length < 2 || beat.layout === "comparison" && beat.points.length !== 2))
+      beat.layout = "statement";
+    if (beat.layout !== "image") delete beat.imageSrc;
+  }
+  return { version: 1, sourceText: script.sourceText, origin, beats };
+}
+
+// src/transform/presentationCompiler.ts
+function compilePresentationPlan(doc, plan) {
+  const checked = parsePresentationPlan(plan);
+  if (!checked) throw new Error("The saved presentation is invalid. Make the presentation again.");
+  const script = buildNarrationScript(doc);
+  if (script.sourceText !== checked.sourceText)
+    throw new Error("The document text has changed. Make the presentation again to match it.");
+  const narration = doc.presentationNarration;
+  const hasNarration = (doc.documentMedia ?? []).some(
+    (clip2) => clip2.anchor === "document" && clip2.src
+  );
+  if (hasNarration && !narration)
+    throw new Error(
+      "Narration timings are unavailable. Restore the timing file or generate narration again."
+    );
+  if (narration && narration.sourceText !== checked.sourceText)
+    throw new Error(
+      "The narration no longer matches the document. Generate narration again before presenting."
+    );
+  if (narration && flattenRenderableBlocks(doc.blocks).some((block) => {
+    const pin = getPinnedBlockMeta(block);
+    return pin.duration !== void 0 || pin.startTime !== void 0;
+  }))
+    throw new Error(
+      "Remove manually pinned slide times before fitting a presentation to narration."
+    );
+  const images = new Set(extractDocImages(doc.blocks).map((image) => image.src));
+  if (checked.beats.some((beat) => beat.imageSrc && !images.has(beat.imageSrc)))
+    throw new Error(
+      "A presentation image 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(
+    (word) => Number.isFinite(word.time) && word.time >= 0 && word.time <= duration && Number.isInteger(word.charOffset) && word.charOffset >= 0 && word.charOffset < script.sourceText.length
+  ).sort((a, b) => a.charOffset - b.charOffset);
+  let previous = 0;
+  const starts = checked.beats.map((beat, index) => {
+    if (!index) return 0;
+    let time;
+    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));
+    return previous;
+  });
+  const blocks = [];
+  checked.beats.forEach((beat, index) => {
+    const start = starts[index];
+    const end = starts[index + 1] ?? duration;
+    if (end <= start) return;
+    const source = script.blocks.find(
+      (block2) => beat.sourceStart >= block2.charStart && beat.sourceStart < block2.charEnd
+    );
+    const base = {
+      id: beat.id,
+      duration: end - start,
+      startTime: start,
+      audioSegment: 0,
+      sourceStartTime: start,
+      sourceDuration: end - start,
+      timelineLocked: true,
+      sourceBlockId: source?.blockId,
+      sourceCharOffset: beat.sourceStart,
+      transition: { type: "fade", duration: Math.min(0.3, (end - start) / 5) }
+    };
+    const block = visualBlock(beat, base, index);
+    blocks.push(block);
+  });
+  return {
+    ...doc,
+    blocks,
+    duration,
+    presentationApplied: true,
+    // The plan supplies its own opening. Preserve an explicit author override.
+    frontmatter: { "squisq-cover-slide": false, ...doc.frontmatter },
+    audio: doc.audio.segments.some((segment) => segment.src) ? doc.audio : { segments: [{ src: "", name: "presentation-clock", startTime: 0, duration }] }
+  };
+}
+function visualBlock(beat, base, index) {
+  const colorScheme = ["blue", "green", "orange"][index % 3];
+  switch (beat.layout) {
+    case "title":
+      return { ...base, template: "title", title: beat.headline, subtitle: beat.points[0] ?? "" };
+    case "statement":
+      return {
+        ...base,
+        template: "factCard",
+        fact: beat.headline,
+        explanation: beat.points.join("\n\n")
+      };
+    case "list":
+      return { ...base, template: "list", title: beat.headline, items: beat.points, colorScheme };
+    case "comparison":
+      return {
+        ...base,
+        template: "twoColumn",
+        header: beat.headline,
+        left: { label: beat.points[0] },
+        right: { label: beat.points[1] }
+      };
+    case "image":
+      return {
+        ...base,
+        template: "imageWithCaption",
+        imageSrc: beat.imageSrc,
+        imageAlt: beat.headline,
+        caption: beat.headline,
+        captionPosition: "bottom",
+        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 }))
+      };
+  }
+}
+function applySavedPresentation(doc) {
+  if (doc.presentationApplied) return doc;
+  const dynamic = usesDynamicPresentation(doc);
+  if (!dynamic && !Object.prototype.hasOwnProperty.call(doc.frontmatter ?? {}, PRESENTATION_KEY))
+    return doc;
+  try {
+    const rawHints = doc.frontmatter?.[PRESENTATION_HINTS_KEY];
+    const hints = rawHints === void 0 ? defaultPresentationHints() : parsePresentationHints(rawHints);
+    if (dynamic && !hints)
+      throw new Error("The slide hints are invalid. Review the summarization settings.");
+    const plan = dynamic ? createPresentationPlan(doc, hints) : parsePresentationPlan(doc.frontmatter?.[PRESENTATION_KEY]);
+    if (!plan) throw new Error("The saved presentation is invalid. Make the presentation again.");
+    return compilePresentationPlan(doc, plan);
+  } catch (error) {
+    return {
+      ...doc,
+      diagnostics: [
+        ...doc.diagnostics ?? [],
+        {
+          severity: "error",
+          code: "presentation-invalid",
+          message: error instanceof Error ? error.message : "The presentation could not be loaded."
+        }
+      ]
+    };
+  }
+}
+
 export {
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
+  PRESENTATION_LIMITS,
+  parsePresentationPlan,
+  serializePresentationPlan,
+  PRESENTATION_HINTS_KEY,
+  DYNAMIC_PRESENTATION_STYLE,
+  defaultPresentationHints,
+  parsePresentationHints,
+  serializePresentationHints,
+  presentationSections,
+  usesDynamicPresentation,
+  extractDocImages,
+  analyzeBlocks,
   DEFAULT_TRANSFORM_STYLE_ID,
   createTransformStyleRegistry,
   resolveTransformStyle,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  extractDocImages,
-  analyzeBlocks,
   allocateTiming,
   applyTransform,
-  transformNarratedSegment
+  transformNarratedSegment,
+  createPresentationPlan,
+  compilePresentationPlan,
+  applySavedPresentation
 };