@bendyline/squisq 2.11.12 → 2.11.14

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-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-BR7ZMDWW.js → chunk-6H2HBBFC.js}

@@ -1,7 +1,7 @@
 import {
   flattenRenderableBlocks,
   getBlockBodyText
-} from "./chunk-42IU2SJY.js";
+} from "./chunk-YPI2VJSB.js";
 import {
   estimateSpokenWordCount
 } from "./chunk-GHOPHGOK.js";

package/dist/{chunk-S4427XKY.js → chunk-GDF2FWL6.js}

@@ -1,7 +1,7 @@
 import {
   buildNarrationScript,
   parseNarrationTimingJson
-} from "./chunk-BR7ZMDWW.js";
+} from "./chunk-6H2HBBFC.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,
@@ -954,8 +954,10 @@ 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. Compact summaries
+    // also retain the children owned by a diagram/drawing feature.
+    ...block.children && (isCustomTemplate || block.summaryMode && 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 +1033,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";

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

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