@bendyline/squisq 2.11.13 → 2.11.15

package/README.md

@@ -67,6 +67,26 @@ console.log(doc.children); // AST nodes
 const md = stringifyMarkdown(doc);
 ```
 
+### Condense imported Markdown
+
+`condenseMarkdownSource(source)` removes table alignment padding, shortens
+GFM delimiter rows, and reduces decorative thematic breaks to three markers.
+It preserves table cells and alignment, code, math, HTML, links, footnotes,
+prose, and frontmatter. The output is reparsed and structurally compared with
+the original before returning; the API throws if equivalence cannot be proven.
+It is idempotent and does not summarize articles or remove citations.
+
+Run condensation after link/image edits, which can re-serialize padded tables.
+
+```ts
+import { condenseMarkdownSource } from '@bendyline/squisq/markdown';
+
+const compactMarkdown = condenseMarkdownSource(importedMarkdown);
+```
+
+The shared source-transform registry also exposes `condense`, available from
+the editor's Transform menu and `squisq transform file.md --ops condense`.
+
 ### Author an ASCII Timeline
 
 Timeline fences are source-of-truth markdown. Unicode marker rails are

package/dist/{Doc-BWtfp7dT.d.ts → Doc-C-cv1g4G.d.ts}

@@ -739,6 +739,10 @@ interface BaseTemplateBlock {
      * Provenance only — NOT a time (see sourceStartTime for seconds).
      */
     sourceCharOffset?: number;
+    /** Projection-only summary policy; keeps visual features on their owning slide. */
+    summaryMode?: 'brief' | 'headings-and-features';
+    /** Automatic title-and-feature composition; omitted for authored templates. */
+    summaryLayout?: 'feature';
     /**
      * Per-block override for the theme's photographic image grade
      * (`theme.style.imageTreatment`). `'none'` opts this block's imagery out;
@@ -2482,6 +2486,10 @@ interface Block {
     sourceBlockIds?: string[];
     /** Char offset of the extraction inside the source block's plain text. */
     sourceCharOffset?: number;
+    /** Projection-only summary policy; keeps visual features on their owning slide. */
+    summaryMode?: 'brief' | 'headings-and-features';
+    /** Automatic title-and-feature composition; omitted for authored templates. */
+    summaryLayout?: 'feature';
     /**
      * Pre-computed visual layers, rendered back-to-front.
      *

package/dist/{ImageEditDoc-CYRQK8so.d.ts → ImageEditDoc-3J4PRw8N.d.ts}

@@ -1,4 +1,4 @@
-import { a2 as ImageLayer, bu as TextLayer, bh as ShapeLayer, aX as PathLayer } from './Doc-BWtfp7dT.js';
+import { a2 as ImageLayer, bu as TextLayer, bh as ShapeLayer, aX as PathLayer } from './Doc-C-cv1g4G.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{chunk-S4427XKY.js → chunk-4IQ2DHCI.js}

@@ -1,7 +1,7 @@
 import {
   buildNarrationScript,
   parseNarrationTimingJson
-} from "./chunk-BR7ZMDWW.js";
+} from "./chunk-Z35TG4WR.js";
 import {
   SHAPE_NAMES,
   buildChartData,
@@ -32,7 +32,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-42IU2SJY.js";
+} from "./chunk-YPI2VJSB.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -98,6 +98,9 @@ import {
   parseHtmlToNodes,
   readFrontmatterThemeId
 } from "./chunk-X7BNDUNI.js";
+import {
+  buildCaptionTrack
+} from "./chunk-4OQFLZ6G.js";
 import {
   estimateTimeFromText
 } from "./chunk-GHOPHGOK.js";
@@ -954,8 +957,12 @@ function blockToSlide(block, index, knownTemplates, documentTitle) {
     // authored rich elements (Mermaid fences today; other media can follow)
     // independently of the selected visual template.
     ...block.contents ? { contents: block.contents } : {},
-    // Custom templates additionally consume child blocks through tokens.
-    ...isCustomTemplate && block.children ? { children: block.children } : {},
+    // Custom templates consume child blocks through tokens, and container
+    // templates (diagram, drawing, layout) draw their children as the canvas:
+    // without them a drawing renders as an empty frame in the slideshow,
+    // video export, and PPTX. They are never flattened into their own slides.
+    ...block.children && (isCustomTemplate || isContainerTemplate(template)) ? { children: block.children } : {},
+    ...block.summaryMode && block.layers ? { layers: block.layers } : {},
     ...defaults,
     ...extraFields,
     // Structured body data (```json data fences, GFM tables for dataTable)
@@ -1031,7 +1038,9 @@ function buildPreviewDoc(doc, options) {
     const block = flat[i];
     const blockImages = extractBlockImages(block.contents);
     const slide = blockToSlide(block, i, knownTemplates, documentTitle);
-    if (blockImages.length > 0 && slide.template === "sectionHeader") {
+    if (block.summaryMode) {
+      for (const img of blockImages) usedImageSrcs.add(img.src);
+    } else if (blockImages.length > 0 && slide.template === "sectionHeader") {
       const img = blockImages[0];
       usedImageSrcs.add(img.src);
       slide.template = "imageWithCaption";
@@ -4293,6 +4302,34 @@ function mapRangesToPlayed(ranges, map2) {
   }
   return mapped;
 }
+function narrationCaptions(doc, clip, timing, timeMap, playedDuration) {
+  if (timing.bookmarks.length === 0 || !(playedDuration > 0)) return null;
+  const bookmarks = [];
+  for (const bookmark of timing.bookmarks) {
+    if (!timeMap) {
+      if (bookmark.time <= playedDuration) bookmarks.push(bookmark);
+    } else if (timeMap.sourceToPlayed(bookmark.time) !== null) {
+      bookmarks.push({ ...bookmark, time: timeMap.snapSourceToPlayed(bookmark.time) });
+    }
+  }
+  if (bookmarks.length === 0) return null;
+  bookmarks.sort((a, b) => a.time - b.time);
+  const track = buildCaptionTrack(
+    [
+      {
+        segment: {
+          src: clip.src,
+          name: "narration",
+          startTime: clip.startAt,
+          duration: playedDuration
+        },
+        timing: { sourceText: timing.sourceText, bookmarks, duration: playedDuration }
+      }
+    ],
+    doc.captions?.generatedAt ? { generatedAt: doc.captions.generatedAt } : {}
+  );
+  return track.phrases.length > 0 ? track : null;
+}
 function retimeBlocks(blocks, ctx) {
   return blocks.map((block) => {
     const range = ctx.ranges.get(block.id);
@@ -4349,10 +4386,12 @@ async function applyNarrationTiming(doc, container) {
     };
     const blocks = retimeBlocks(doc.blocks, ctx);
     const duration = Math.max(clip.startAt + playedDuration, ctx.cursor);
+    const captions = narrationCaptions(doc, clip, timing, timeMap, playedDuration);
     const retimed = {
       ...doc,
       blocks,
       duration,
+      ...captions ? { captions } : {},
       ...ctx.diagnostics.length > 0 ? { diagnostics: [...doc.diagnostics ?? [], ...ctx.diagnostics] } : {}
     };
     return { doc: retimed, applied: true, clipSrc: clip.src };
@@ -4809,6 +4848,10 @@ function collectKnownTemplates(doc, options) {
 function isDrawingBlock(block) {
   return resolveTemplateName(block.template ?? "") === "drawing";
 }
+function isLayoutBlock(block) {
+  return resolveTemplateName(block.template ?? "") === "layout";
+}
+var LAYOUT_IMAGE_LAYERS = /* @__PURE__ */ new Set(["image", "img"]);
 function checkTemplate(block, parent, known, diagnostics) {
   const requested = block.sourceHeading?.templateAnnotation?.template ?? block.sourceAnnotation?.template;
   if (!requested) return;
@@ -4826,11 +4869,37 @@ function checkTemplate(block, parent, known, diagnostics) {
     });
     return;
   }
+  if (parent && isLayoutBlock(parent)) {
+    if (LAYOUT_IMAGE_LAYERS.has(requested.toLowerCase())) {
+      if (!block.templateOverrides?.src) {
+        diagnostics.push({
+          severity: "warning",
+          code: "layout-image-missing-src",
+          message: `Layout image "${block.id}" has no src= \u2014 the layer will be skipped`,
+          blockId: block.id,
+          ...lineOf(block)
+        });
+      }
+      return;
+    }
+    if (normalizeShapeKind(block.template ?? requested) || normalizeShapeKind(requested)) return;
+    const suggestion2 = nearestName(requested, /* @__PURE__ */ new Set([...SHAPE_NAMES, "image"]), {
+      map: resolveTemplateName
+    });
+    diagnostics.push({
+      severity: "warning",
+      code: "unknown-layer",
+      message: `"${requested}" is not a layout layer \u2014 the child will be skipped. Layers are text, image, or a drawing shape` + (suggestion2 ? `. Did you mean "${suggestion2}"?` : ""),
+      blockId: block.id,
+      ...lineOf(block)
+    });
+    return;
+  }
   if (isShapeName(requested)) {
     diagnostics.push({
       severity: "warning",
       code: "shape-outside-drawing",
-      message: `Shape "${requested}" is only recognized on a child heading of a {[drawing]} block`,
+      message: `Shape "${requested}" is only recognized on a child heading of a {[drawing]} or {[layout]} block`,
       blockId: block.id,
       ...lineOf(block)
     });
@@ -4849,7 +4918,7 @@ function checkTemplate(block, parent, known, diagnostics) {
 function checkTemplateInputs(block, parent, customNames, diagnostics) {
   const requested = block.sourceHeading?.templateAnnotation?.template;
   if (!requested) return;
-  if (parent && isDrawingBlock(parent)) return;
+  if (parent && (isDrawingBlock(parent) || isLayoutBlock(parent))) return;
   if (isShapeName(requested)) return;
   const canonical = resolveTemplateName(requested);
   if (customNames.has(requested) || customNames.has(canonical)) return;
@@ -4874,6 +4943,7 @@ function isInputSatisfiable(canonical, block, key) {
   return derived != null && key in derived;
 }
 var NUMERIC_SHAPE_KEYS = ["x", "y", "width", "height", "w", "h", "strokeWidth", "borderRadius"];
+var NUMERIC_LAYER_KEYS = [...NUMERIC_SHAPE_KEYS, "fontSize", "lineHeight", "padding"];
 function checkAttributeCoercion(block, parent, diagnostics) {
   const params = block.sourceHeading?.attributes?.params;
   if (params) {
@@ -4888,9 +4958,12 @@ function checkAttributeCoercion(block, parent, diagnostics) {
       });
     }
   }
-  if (parent && isDrawingBlock(parent) && isShapeName(block.template)) {
+  const inDrawing = parent !== void 0 && isDrawingBlock(parent) && isShapeName(block.template);
+  const inLayout = parent !== void 0 && isLayoutBlock(parent);
+  if (inDrawing || inLayout) {
     const overrides = block.templateOverrides ?? {};
-    for (const key of NUMERIC_SHAPE_KEYS) {
+    const label = inLayout ? "Layout layer" : "Drawing shape";
+    for (const key of inLayout ? NUMERIC_LAYER_KEYS : NUMERIC_SHAPE_KEYS) {
       const raw = overrides[key];
       if (raw == null) continue;
       const value = raw.replace(/,\s*$/, "").trim();
@@ -4898,7 +4971,7 @@ function checkAttributeCoercion(block, parent, diagnostics) {
         diagnostics.push({
           severity: "warning",
           code: "invalid-attribute",
-          message: `Drawing shape "${block.id}": "${key}" is not a number (${JSON.stringify(raw)})`,
+          message: `${label} "${block.id}": "${key}" is not a number (${JSON.stringify(raw)})`,
           blockId: block.id,
           ...lineOf(block)
         });

package/dist/{chunk-EWO2VLOS.js → chunk-4P557IPH.js}

@@ -4,8 +4,16 @@ import {
   stripMarkdown
 } from "./chunk-SVN7T6BK.js";
 import {
+  coerceTemplateParams,
+  deriveTemplateInputs,
+  flattenRenderableBlocks,
   markdownToDoc
-} from "./chunk-42IU2SJY.js";
+} from "./chunk-YPI2VJSB.js";
+import {
+  isAsciiDiagramFence,
+  isAsciiTimelineFence,
+  isTreeFence
+} from "./chunk-C3NAY5YP.js";
 import {
   cloneAndFreezeData,
   isTemplateBlock
@@ -13,9 +21,13 @@ import {
 import {
   parseMarkdown
 } from "./chunk-HUXK7EOT.js";
+import {
+  isContainerTemplate
+} from "./chunk-TMOHAFYE.js";
 import {
   extractPlainText,
-  getChildren
+  getChildren,
+  stringifyHtmlNodes
 } from "./chunk-X7BNDUNI.js";
 import {
   estimateTimeFromText
@@ -99,26 +111,45 @@ var narrativeStyle = {
 var minimalStyle = {
   id: "minimal",
   name: "Minimal",
-  description: "Light touch \u2014 only the strongest highlights, mostly text",
+  description: "Short highlights and a single brief line per section",
+  contentMode: "brief",
   minConfidence: 0.6,
   transformRatio: 0.2,
   preferredTypes: ["stat", "quote"],
   colorSchemes: ["blue", "green"],
   insertSectionHeaders: false,
   interleaveImages: false,
-  blocksPerSection: { max: 2 },
+  blocksPerSection: { max: 1 },
   transitionStyle: "fade",
   suggestedThemeId: "minimalist",
   page: { spacing: "generous", emphasisCurve: "even" }
 };
 
+// src/transform/styles/headingsAndFeatures.ts
+var headingsAndFeaturesStyle = {
+  id: "headings-and-features",
+  name: "Headings and features",
+  description: "Headings with their images, videos, and diagrams; no body prose",
+  contentMode: "headings-and-features",
+  minConfidence: 1,
+  transformRatio: 0,
+  preferredTypes: [],
+  colorSchemes: ["blue", "green"],
+  insertSectionHeaders: false,
+  interleaveImages: false,
+  blocksPerSection: { max: 1 },
+  transitionStyle: "fade",
+  page: { spacing: "generous", emphasisCurve: "even" }
+};
+
 // src/transform/registry.ts
 var TRANSFORM_STYLES = Object.freeze({
   [documentaryStyle.id]: cloneAndFreezeData(documentaryStyle),
   [magazineStyle.id]: cloneAndFreezeData(magazineStyle),
   [dataDrivenStyle.id]: cloneAndFreezeData(dataDrivenStyle),
   [narrativeStyle.id]: cloneAndFreezeData(narrativeStyle),
-  [minimalStyle.id]: cloneAndFreezeData(minimalStyle)
+  [minimalStyle.id]: cloneAndFreezeData(minimalStyle),
+  [headingsAndFeaturesStyle.id]: cloneAndFreezeData(headingsAndFeaturesStyle)
 });
 var DEFAULT_TRANSFORM_STYLE_ID = "documentary";
 var EXTRACTION_TYPES = /* @__PURE__ */ new Set([
@@ -148,6 +179,9 @@ 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 (!Array.isArray(candidate.preferredTypes) || candidate.preferredTypes.some((type) => !EXTRACTION_TYPES.has(type))) {
     fail("preferredTypes contains an unknown extraction type");
   }
@@ -328,7 +362,9 @@ function collectLeafBlocks(blocks) {
   return result;
 }
 function analyzeBlocks(blocks, options) {
-  const flat = collectLeafBlocks(blocks);
+  return analyzeFlatBlocks(collectLeafBlocks(blocks), options);
+}
+function analyzeFlatBlocks(flat, options) {
   const results = [];
   for (const block of flat) {
     let plainText = "";
@@ -353,6 +389,223 @@ function analyzeBlocks(blocks, options) {
   return results;
 }
 
+// src/transform/contentSummary.ts
+var NATIVE_FEATURE_TEMPLATES = /* @__PURE__ */ new Set([
+  "diagram",
+  "tree",
+  "timeline",
+  "map",
+  "drawing",
+  "layout",
+  "dataTable",
+  "barChart",
+  "columnChart",
+  "pieChart",
+  "donutChart",
+  "lineChart",
+  "areaChart",
+  "scatterChart"
+]);
+var VIDEO_FILE_RE = /\.(?:webm|mp4|mov|m4v|ogv)(?:[?#].*)?$/i;
+var PROSE_KEYS = /* @__PURE__ */ new Set([
+  "body",
+  "subtitle",
+  "description",
+  "explanation",
+  "definition",
+  "detail",
+  "caption",
+  "quote",
+  "text"
+]);
+function briefText(text) {
+  const normalized = text.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(" ");
+  const truncated = words.length > 24 || brief.length > 180;
+  if (brief.length > 179 && truncated) {
+    brief = brief.slice(0, 179).replace(/\s+\S*$/, "").trimEnd();
+  }
+  return truncated ? `${brief.replace(/[.,;:!?]+$/, "")}\u2026` : brief;
+}
+function htmlFeatures(nodes) {
+  return nodes.flatMap((node) => {
+    if (node.type !== "htmlElement") return [];
+    const tag = node.tagName.toLowerCase();
+    if (tag === "img") return [node];
+    if (tag === "video") {
+      return [
+        {
+          ...node,
+          children: node.children.filter(
+            (child) => child.type === "htmlElement" && ["source", "track"].includes(child.tagName.toLowerCase())
+          )
+        }
+      ];
+    }
+    return htmlFeatures(node.children);
+  });
+}
+function extractFeatureContents(contents, keepData = false) {
+  const features = [];
+  const visit = (node) => {
+    if (node.type === "code") {
+      if (node.lang?.trim().toLowerCase() === "mermaid" || isAsciiDiagramFence(node) || isTreeFence(node) || isAsciiTimelineFence(node) || keepData && /^(json|ya?ml)$/i.test(node.lang ?? "") && /\bdata\b/i.test(node.meta ?? ""))
+        features.push(node);
+      return;
+    }
+    if (node.type === "table") {
+      if (keepData) features.push(node);
+      else for (const child of getChildren(node)) visit(child);
+      return;
+    }
+    if (node.type === "image" || node.type === "link" && VIDEO_FILE_RE.test(node.url)) {
+      features.push({ type: "paragraph", children: [node] });
+      return;
+    }
+    if (node.type === "htmlBlock" || node.type === "htmlInline") {
+      const htmlChildren = htmlFeatures(node.htmlChildren);
+      if (htmlChildren.length) {
+        features.push({
+          type: "htmlBlock",
+          htmlChildren,
+          rawHtml: stringifyHtmlNodes(htmlChildren)
+        });
+      }
+      return;
+    }
+    for (const child of getChildren(node)) visit(child);
+  };
+  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 typedMediaContents(block) {
+  const record = {
+    ...block,
+    ...block.templateData,
+    ...coerceTemplateParams(block.template ?? "", block.templateOverrides ?? {}).input
+  };
+  const contents = [];
+  const addImage = (src, alt) => {
+    if (typeof src === "string" && src) {
+      contents.push({
+        type: "paragraph",
+        children: [{ type: "image", url: src, alt: typeof alt === "string" ? alt : "" }]
+      });
+    }
+  };
+  addImage(record.imageSrc, record.imageAlt);
+  for (const key of ["accentImage", "backgroundImage"]) {
+    const image = record[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 (image && typeof image === "object") {
+        const data = image;
+        addImage(data.src, data.alt);
+      }
+    }
+  }
+  if (typeof record.videoSrc === "string" && record.videoSrc) {
+    const htmlChildren = [
+      {
+        type: "htmlElement",
+        tagName: "video",
+        selfClosing: false,
+        children: [],
+        attributes: {
+          src: record.videoSrc,
+          ...typeof record.posterSrc === "string" ? { poster: record.posterSrc } : {}
+        }
+      }
+    ];
+    contents.push({ type: "htmlBlock", htmlChildren, rawHtml: stringifyHtmlNodes(htmlChildren) });
+  }
+  return contents;
+}
+function summarizeBlock(block, mode) {
+  const title = block.sourceHeading ? extractPlainText(block.sourceHeading) : block.title ?? "";
+  const nativeFeature = NATIVE_FEATURE_TEMPLATES.has(block.template ?? "");
+  const authoredTemplate = mode === "headings-and-features" && !!block.template && !block.autoTemplate && (!block.sourceHeading || !!block.sourceHeading.templateAnnotation || !!block.promotedBodyAnnotation);
+  const keepTemplate = nativeFeature || authoredTemplate;
+  const tableInputs = keepTemplate ? null : deriveTemplateInputs("dataTable", title, block.contents);
+  const featureContents = extractFeatureContents(block.contents, keepTemplate || !!tableInputs);
+  const brief = mode === "brief" ? briefText(
+    (block.contents ?? []).filter((node) => ["paragraph", "list", "blockquote"].includes(node.type)).map(extractPlainText).join(" ")
+  ) : "";
+  const template = keepTemplate ? block.template : tableInputs ? "dataTable" : brief ? "content" : "sectionHeader";
+  const contents = [
+    ...brief && !nativeFeature && !tableInputs ? [{ type: "paragraph", children: [{ type: "text", value: brief }] }] : [],
+    ...featureContents,
+    ...typedMediaContents(block)
+  ];
+  const base = {
+    id: block.id,
+    startTime: block.startTime,
+    duration: block.duration,
+    audioSegment: block.audioSegment,
+    title,
+    template,
+    contents,
+    summaryMode: mode,
+    ...mode === "headings-and-features" && !keepTemplate && !tableInputs && contents.length ? { summaryLayout: "feature" } : {},
+    sourceBlockId: block.id,
+    sourceCharOffset: 0,
+    sourceStartTime: block.startTime,
+    sourceDuration: block.duration,
+    transition: block.transition,
+    media: block.media,
+    ...block.sourceHeading ? { sourceHeading: { ...block.sourceHeading, templateAnnotation: { template } } } : {}
+  };
+  if (!keepTemplate && !tableInputs) return base;
+  const headingInputs = authoredTemplate ? {
+    body: "",
+    subtitle: "",
+    description: template === "statHighlight" ? title : "",
+    explanation: "",
+    definition: "",
+    detail: "",
+    ...template === "list" ? { items: [] } : {},
+    ...template === "imageWithCaption" || template === "videoWithCaption" ? { caption: title } : {},
+    ...template === "quote" ? { quote: title } : {},
+    ...template === "pullQuote" || template === "fullBleedQuote" ? { text: title } : {}
+  } : {};
+  return {
+    ...keepTemplate ? withoutProse(block) : {},
+    ...base,
+    ...headingInputs,
+    children: keepTemplate && isContainerTemplate(template) ? block.children : void 0,
+    templateData: tableInputs ?? { ...withoutProse(block.templateData), ...headingInputs },
+    templateOverrides: keepTemplate ? withoutProse(
+      template === "list" ? Object.fromEntries(
+        Object.entries(block.templateOverrides ?? {}).filter(([key]) => key !== "items")
+      ) : block.templateOverrides
+    ) : void 0
+  };
+}
+function summarizeHighlight(block, source) {
+  const summary = {
+    ...block,
+    summaryMode: "brief",
+    contents: [...extractFeatureContents(source.contents), ...typedMediaContents(source)],
+    media: source.media
+  };
+  if (summary.template === "quote") return { ...summary, quote: briefText(summary.quote) };
+  if (summary.template === "statHighlight")
+    return { ...summary, description: briefText(summary.description), detail: void 0 };
+  if (summary.template === "fullBleedQuote" || summary.template === "pullQuote")
+    return { ...summary, text: briefText(summary.text) };
+  return summary;
+}
+
 // src/transform/templateSelector.ts
 var ACCENT_POSITIONS = [
   "left-strip",
@@ -446,7 +699,8 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
     const ab = analyzed[i];
     const extractions = blockExtractions.get(i);
     if (!extractions || extractions.length === 0) {
-      blocks.push(ab.block);
+      blocks.push(config.contentMode === "brief" ? summarizeBlock(ab.block, "brief") : ab.block);
+      if (config.contentMode === "brief") transformedCount++;
       continue;
     }
     if (config.insertSectionHeaders && ab.block.title) {
@@ -495,6 +749,9 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
         const translated = translateTemplateBlock(templateBlock, remapTarget);
         if (translated) templateBlock = translated;
       }
+      if (config.contentMode === "brief") {
+        templateBlock = summarizeHighlight(templateBlock, ab.block);
+      }
       if (config.transitionStyle !== "cut") {
         const transitionType = config.transitionStyle === "mixed" ? rng.pick(["fade", "dissolve"]) ?? "fade" : config.transitionStyle;
         templateBlock.transition = {
@@ -780,12 +1037,15 @@ function applyTransform(doc, style, options) {
   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);
-  const analyzed = analyzeBlocks(doc.blocks, {
-    minConfidence: config.minConfidence,
-    types: config.preferredTypes
-  });
+  const analyzed = (config.contentMode ? analyzeFlatBlocks : analyzeBlocks)(
+    config.contentMode ? flattenRenderableBlocks(doc.blocks) : doc.blocks,
+    {
+      minConfidence: config.minConfidence,
+      types: config.preferredTypes
+    }
+  );
   const hasContent = analyzed.some((ab) => ab.bodyWordCount >= 5);
-  if (!hasContent) {
+  if (!hasContent && !config.contentMode) {
     return {
       doc: { ...doc },
       stats: {
@@ -795,7 +1055,11 @@ function applyTransform(doc, style, options) {
       }
     };
   }
-  const selection = selectAndBuild(analyzed, config, images, seed);
+  const selection = config.contentMode === "headings-and-features" ? {
+    blocks: analyzed.filter((ab) => ab.block.sourceHeading || ab.block.title).map((ab) => summarizeBlock(ab.block, "headings-and-features")),
+    transformedCount: analyzed.filter((ab) => ab.block.sourceHeading || ab.block.title).length,
+    insertedCount: 0
+  } : selectAndBuild(analyzed, config, images, seed);
   let paced = selection.blocks;
   let pacingInserted = 0;
   const docTitle = firstTitle(doc);
@@ -826,7 +1090,13 @@ function applyTransform(doc, style, options) {
   const transformedDoc = {
     ...doc,
     blocks: timedBlocks,
-    themeId: options?.themeId ?? doc.themeId ?? config.suggestedThemeId
+    themeId: options?.themeId ?? doc.themeId ?? config.suggestedThemeId,
+    ...config.contentMode && doc.startBlock ? {
+      startBlock: {
+        ...doc.startBlock,
+        subtitle: config.contentMode === "brief" ? briefText(doc.startBlock.subtitle ?? "") : void 0
+      }
+    } : {}
   };
   return {
     doc: transformedDoc,

package/dist/{chunk-X2TDC4E5.js → chunk-GQWIUBJU.js}

@@ -7,10 +7,10 @@ import {
   buildNarrationScript,
   expectedSyllablesAt,
   wordPosAtExpectedSyllables
-} from "./chunk-BR7ZMDWW.js";
+} from "./chunk-Z35TG4WR.js";
 import {
   flattenRenderableBlocks
-} from "./chunk-42IU2SJY.js";
+} from "./chunk-YPI2VJSB.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({