@bendyline/squisq 1.4.0 → 1.5.0

package/dist/chunk-TVSGLUID.js

@@ -0,0 +1,596 @@
+import {
+  extractContent,
+  mapElementToBlock,
+  stripMarkdown
+} from "./chunk-FR2RBTKO.js";
+import {
+  SeededRandom,
+  hashString
+} from "./chunk-FVTQSNR7.js";
+import {
+  isTemplateBlock
+} from "./chunk-DLXZMS5K.js";
+import {
+  extractPlainText,
+  getChildren
+} from "./chunk-OKJOQXK4.js";
+
+// src/transform/styles/documentary.ts
+var documentaryStyle = {
+  id: "documentary",
+  name: "Documentary",
+  description: "Conservative \u2014 highlights only the strongest stats, dates, and quotes",
+  minConfidence: 0.5,
+  transformRatio: 0.3,
+  preferredTypes: ["stat", "date", "quote", "fact"],
+  colorSchemes: ["blue", "green", "purple"],
+  insertSectionHeaders: false,
+  interleaveImages: true,
+  blocksPerSection: { max: 3 },
+  transitionStyle: "fade",
+  suggestedThemeId: "documentary"
+};
+
+// src/transform/styles/magazine.ts
+var magazineStyle = {
+  id: "magazine",
+  name: "Magazine",
+  description: "Visual variety with pull quotes, facts, and rich image layouts",
+  minConfidence: 0.4,
+  transformRatio: 0.6,
+  preferredTypes: ["quote", "fact", "list", "definition", "stat", "impactLine"],
+  colorSchemes: ["blue", "green", "purple", "orange", "red"],
+  insertSectionHeaders: true,
+  interleaveImages: true,
+  blocksPerSection: { max: 5 },
+  transitionStyle: "dissolve",
+  suggestedThemeId: "magazine",
+  templateMap: { quote: "pullQuote", impactLine: "fullBleedQuote" }
+};
+
+// src/transform/styles/dataDriven.ts
+var dataDrivenStyle = {
+  id: "data-driven",
+  name: "Data-Driven",
+  description: "Aggressively highlights statistics, comparisons, and timelines",
+  minConfidence: 0.3,
+  transformRatio: 0.8,
+  preferredTypes: ["stat", "comparison", "date", "list", "fact"],
+  colorSchemes: ["blue", "orange", "green", "purple", "red"],
+  insertSectionHeaders: true,
+  interleaveImages: false,
+  blocksPerSection: { max: 6 },
+  transitionStyle: "cut",
+  suggestedThemeId: "tech-dark"
+};
+
+// src/transform/styles/narrative.ts
+var narrativeStyle = {
+  id: "narrative",
+  name: "Narrative",
+  description: "Story-driven with timeline events, quotes, and impact moments",
+  minConfidence: 0.4,
+  transformRatio: 0.5,
+  preferredTypes: ["date", "quote", "impactLine", "fact", "stat"],
+  colorSchemes: ["blue", "purple", "green"],
+  insertSectionHeaders: true,
+  interleaveImages: true,
+  blocksPerSection: { max: 4 },
+  transitionStyle: "fade",
+  suggestedThemeId: "cinematic",
+  pacing: { intro: true, outro: true }
+};
+
+// src/transform/styles/minimal.ts
+var minimalStyle = {
+  id: "minimal",
+  name: "Minimal",
+  description: "Light touch \u2014 only the strongest highlights, mostly text",
+  minConfidence: 0.6,
+  transformRatio: 0.2,
+  preferredTypes: ["stat", "quote"],
+  colorSchemes: ["blue", "green"],
+  insertSectionHeaders: false,
+  interleaveImages: false,
+  blocksPerSection: { max: 2 },
+  transitionStyle: "fade",
+  suggestedThemeId: "minimalist"
+};
+
+// src/transform/registry.ts
+var TRANSFORM_STYLES = {
+  [documentaryStyle.id]: documentaryStyle,
+  [magazineStyle.id]: magazineStyle,
+  [dataDrivenStyle.id]: dataDrivenStyle,
+  [narrativeStyle.id]: narrativeStyle,
+  [minimalStyle.id]: minimalStyle
+};
+var STYLE_ALIASES = {
+  dataDriven: "data-driven"
+};
+var registeredStyles = /* @__PURE__ */ new Map();
+var DEFAULT_TRANSFORM_STYLE_ID = "documentary";
+function registerTransformStyle(style) {
+  registeredStyles.set(style.id, style);
+}
+function unregisterTransformStyle(id) {
+  registeredStyles.delete(id);
+}
+function resolveTransformStyle(id) {
+  const canonical = STYLE_ALIASES[id] ?? id;
+  return registeredStyles.get(canonical) ?? TRANSFORM_STYLES[canonical] ?? TRANSFORM_STYLES[DEFAULT_TRANSFORM_STYLE_ID];
+}
+function getTransformStyleIds() {
+  return Array.from(/* @__PURE__ */ new Set([...Object.keys(TRANSFORM_STYLES), ...registeredStyles.keys()]));
+}
+function getTransformStyleSummaries() {
+  return getTransformStyleIds().map((id) => {
+    const { name, description } = resolveTransformStyle(id);
+    return { id, name, description };
+  });
+}
+
+// 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) {
+  const flat = collectLeafBlocks(blocks);
+  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/templateSelector.ts
+var ACCENT_POSITIONS = [
+  "left-strip",
+  "right-strip",
+  "bottom-strip",
+  "corner-inset"
+];
+var AMBIENT_MOTIONS = [
+  "zoomIn",
+  "zoomOut",
+  "panLeft",
+  "panRight"
+];
+function selectAndBuild(analyzed, config, images, seed) {
+  const rng = new SeededRandom(seed);
+  const candidates = collectCandidates(analyzed, config);
+  const ratioCap = Math.max(1, Math.floor(analyzed.length * config.transformRatio));
+  const slidesPerMinute = config.budget?.slidesPerMinute;
+  const totalDurationSeconds = analyzed.reduce((sum, ab) => sum + (ab.block.duration || 0), 0);
+  const budgetCap = slidesPerMinute && totalDurationSeconds > 0 ? Math.max(1, Math.round(totalDurationSeconds / 60 * slidesPerMinute)) : Infinity;
+  const maxTransforms = Math.min(ratioCap, budgetCap);
+  const selected = candidates.slice(0, maxTransforms);
+  const result = buildBlockSequence(analyzed, selected, config, images, rng);
+  return result;
+}
+function collectCandidates(analyzed, config) {
+  const candidates = [];
+  for (let i = 0; i < analyzed.length; i++) {
+    const ab = analyzed[i];
+    if (ab.bodyWordCount < 5) continue;
+    for (const element of ab.extractions) {
+      if (element.confidence < config.minConfidence) continue;
+      candidates.push({
+        element,
+        sourceBlock: ab.block,
+        sourceIndex: i
+      });
+    }
+  }
+  const typeRank = new Map(config.preferredTypes.map((t, i) => [t, i]));
+  const maxRank = config.preferredTypes.length;
+  candidates.sort((a, b) => {
+    const rankA = typeRank.get(a.element.type) ?? maxRank;
+    const rankB = typeRank.get(b.element.type) ?? maxRank;
+    if (rankA !== rankB) return rankA - rankB;
+    return b.element.confidence - a.element.confidence;
+  });
+  const seenTexts = /* @__PURE__ */ new Set();
+  const deduplicated = [];
+  for (const candidate of candidates) {
+    const key = candidate.element.text.trim().toLowerCase();
+    if (seenTexts.has(key)) continue;
+    seenTexts.add(key);
+    deduplicated.push(candidate);
+  }
+  return deduplicated;
+}
+function buildBlockSequence(analyzed, selected, config, images, rng) {
+  const blockExtractions = /* @__PURE__ */ new Map();
+  for (const sel of selected) {
+    const list = blockExtractions.get(sel.sourceIndex) ?? [];
+    list.push(sel);
+    blockExtractions.set(sel.sourceIndex, list);
+  }
+  for (const [idx, list] of blockExtractions) {
+    const diverse = [];
+    const usedTypes = /* @__PURE__ */ new Set();
+    for (const sel of list) {
+      if (usedTypes.has(sel.element.type)) continue;
+      usedTypes.add(sel.element.type);
+      diverse.push(sel);
+      if (diverse.length >= config.blocksPerSection.max) break;
+    }
+    blockExtractions.set(idx, diverse);
+  }
+  const blocks = [];
+  let transformedCount = 0;
+  let insertedCount = 0;
+  let colorIndex = 0;
+  let blockIdCounter = 0;
+  let imageIndex = 0;
+  let accentPositionIndex = 0;
+  let elementsSinceImage = 0;
+  let prevTemplateType = "";
+  const totalTransformed = Array.from(blockExtractions.values()).reduce(
+    (sum, list) => sum + list.length,
+    0
+  );
+  const imageInterval = config.interleaveImages && images.length > 0 && totalTransformed > 0 ? Math.max(2, Math.floor(totalTransformed / (images.length + 1))) : Infinity;
+  for (let i = 0; i < analyzed.length; i++) {
+    const ab = analyzed[i];
+    const extractions = blockExtractions.get(i);
+    if (!extractions || extractions.length === 0) {
+      blocks.push(ab.block);
+      continue;
+    }
+    if (config.insertSectionHeaders && ab.block.title) {
+      const headerBlock = {
+        template: "sectionHeader",
+        id: `transform-header-${blockIdCounter++}`,
+        duration: ab.block.duration > 0 ? Math.min(3, ab.block.duration * 0.2) : 3,
+        audioSegment: ab.block.audioSegment,
+        title: ab.block.title,
+        colorScheme: config.colorSchemes[colorIndex % config.colorSchemes.length]
+      };
+      blocks.push(headerBlock);
+      insertedCount++;
+    }
+    for (const sel of extractions) {
+      const colorScheme = config.colorSchemes[colorIndex % config.colorSchemes.length];
+      let accentImage;
+      if (images.length > 0 && config.interleaveImages) {
+        const img = images[imageIndex % images.length];
+        accentImage = {
+          src: img.src,
+          alt: img.alt ?? "",
+          position: ACCENT_POSITIONS[accentPositionIndex % ACCENT_POSITIONS.length],
+          ambientMotion: rng.pick(AMBIENT_MOTIONS) ?? "zoomIn",
+          credit: img.credit,
+          license: img.license
+        };
+        accentPositionIndex++;
+      }
+      let templateBlock = mapElementToBlock(sel.element, {
+        id: `transform-${blockIdCounter++}`,
+        duration: ab.block.duration > 0 ? ab.block.duration / extractions.length : 6,
+        audioSegment: ab.block.audioSegment,
+        colorScheme,
+        accentImage,
+        sourceStartTime: sel.element.sourcePosition
+      });
+      const remapTarget = config.templateMap?.[sel.element.data.type];
+      if (remapTarget && remapTarget !== templateBlock.template) {
+        const translated = translateTemplateBlock(templateBlock, remapTarget);
+        if (translated) templateBlock = translated;
+      }
+      if (config.transitionStyle !== "cut") {
+        const transitionType = config.transitionStyle === "mixed" ? rng.pick(["fade", "dissolve"]) ?? "fade" : config.transitionStyle;
+        templateBlock.transition = {
+          type: transitionType,
+          duration: 0.5
+        };
+      }
+      if (templateBlock.template === prevTemplateType) {
+        colorIndex++;
+      }
+      prevTemplateType = templateBlock.template;
+      blocks.push(templateBlock);
+      transformedCount++;
+      colorIndex++;
+      elementsSinceImage++;
+      if (config.interleaveImages && imageIndex < images.length && elementsSinceImage >= imageInterval) {
+        const img = images[imageIndex];
+        const imageBlock = {
+          template: "imageWithCaption",
+          id: `transform-img-${blockIdCounter++}`,
+          duration: 4,
+          audioSegment: ab.block.audioSegment,
+          imageSrc: img.src,
+          imageAlt: img.alt ?? "",
+          ambientMotion: rng.pick(AMBIENT_MOTIONS) ?? "zoomIn"
+        };
+        blocks.push(imageBlock);
+        imageIndex++;
+        insertedCount++;
+        elementsSinceImage = 0;
+      }
+    }
+  }
+  return { blocks, transformedCount, insertedCount };
+}
+function translateTemplateBlock(block, target) {
+  const base = {
+    id: block.id,
+    duration: block.duration,
+    audioSegment: block.audioSegment,
+    sourceStartTime: block.sourceStartTime,
+    sourceDuration: block.sourceDuration
+  };
+  if (block.template === "quote") {
+    const quote = block;
+    if (target === "fullBleedQuote") {
+      return { ...base, template: "fullBleedQuote", text: quote.quote };
+    }
+    if (target === "pullQuote") {
+      const bg = quote.accentImage;
+      if (!bg) return null;
+      return {
+        ...base,
+        template: "pullQuote",
+        text: quote.quote,
+        attribution: quote.attribution,
+        backgroundImage: { src: bg.src, alt: bg.alt, credit: bg.credit, license: bg.license }
+      };
+    }
+    return null;
+  }
+  if (block.template === "fullBleedQuote" && target === "quote") {
+    const fbq = block;
+    return { ...base, template: "quote", quote: fbq.text };
+  }
+  if (block.template === "statHighlight" && target === "factCard") {
+    const stat = block;
+    return {
+      ...base,
+      template: "factCard",
+      fact: stat.stat,
+      explanation: stat.description,
+      accentImage: stat.accentImage
+    };
+  }
+  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 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) {
+    const scale = effectiveDuration / rawTotal;
+    for (let i = 0; i < durations.length; i++) {
+      durations[i] = clampDuration(durations[i] * scale);
+    }
+  }
+  let currentTime = 0;
+  const result = [];
+  for (let i = 0; i < blocks.length; i++) {
+    const block = blocks[i];
+    const duration = durations[i];
+    if (isTemplateBlock(block)) {
+      const outputBlock = {
+        ...block,
+        startTime: currentTime,
+        duration,
+        title: getTemplateTitle(block)
+      };
+      result.push(outputBlock);
+    } else {
+      result.push({
+        ...block,
+        startTime: currentTime,
+        duration
+      });
+    }
+    currentTime += duration;
+  }
+  return result;
+}
+function clampDuration(d) {
+  return Math.max(MIN_BLOCK_DURATION, Math.min(MAX_BLOCK_DURATION, d));
+}
+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);
+  }
+  return void 0;
+}
+
+// src/transform/applyTransform.ts
+function applyTransform(doc, styleId, options) {
+  const baseConfig = resolveTransformStyle(styleId);
+  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 hasContent = analyzed.some((ab) => ab.bodyWordCount >= 5);
+  if (!hasContent) {
+    return {
+      doc: { ...doc },
+      stats: {
+        totalInputBlocks: doc.blocks.length,
+        transformedBlocks: 0,
+        insertedBlocks: 0
+      }
+    };
+  }
+  const selection = selectAndBuild(analyzed, config, images, seed);
+  let paced = selection.blocks;
+  let pacingInserted = 0;
+  const docTitle = firstTitle(doc);
+  if (config.pacing?.intro && docTitle && !doc.startBlock) {
+    const intro = {
+      template: "title",
+      id: "transform-intro",
+      duration: 4,
+      audioSegment: 0,
+      title: docTitle
+    };
+    paced = [intro, ...paced];
+    pacingInserted++;
+  }
+  if (config.pacing?.outro && docTitle) {
+    const outro = {
+      template: "sectionHeader",
+      id: "transform-outro",
+      duration: 3,
+      audioSegment: 0,
+      title: docTitle,
+      colorScheme: config.colorSchemes[0]
+    };
+    paced = [...paced, outro];
+    pacingInserted++;
+  }
+  const timedBlocks = allocateTiming(paced, doc.duration);
+  const transformedDoc = {
+    ...doc,
+    blocks: timedBlocks,
+    themeId: options?.themeId ?? doc.themeId ?? config.suggestedThemeId
+  };
+  return {
+    doc: transformedDoc,
+    stats: {
+      totalInputBlocks: doc.blocks.length,
+      transformedBlocks: selection.transformedCount,
+      insertedBlocks: selection.insertedCount + pacingInserted
+    }
+  };
+}
+function firstTitle(doc) {
+  if (doc.startBlock?.title) return doc.startBlock.title;
+  for (const block of doc.blocks) {
+    if (block.title) return block.title;
+  }
+  return void 0;
+}
+
+export {
+  DEFAULT_TRANSFORM_STYLE_ID,
+  registerTransformStyle,
+  unregisterTransformStyle,
+  resolveTransformStyle,
+  getTransformStyleIds,
+  getTransformStyleSummaries,
+  extractDocImages,
+  analyzeBlocks,
+  applyTransform
+};
+//# sourceMappingURL=chunk-TVSGLUID.js.map