@bendyline/squisq 2.11.5 → 2.11.7

package/dist/{chunk-ZSU5DJLX.js → chunk-IYZTF4VO.js}

@@ -2,18 +2,24 @@ import {
   extractContent,
   mapElementToBlock,
   stripMarkdown
-} from "./chunk-NKNMGIIN.js";
+} from "./chunk-SVN7T6BK.js";
+import {
+  markdownToDoc
+} from "./chunk-3YNFMFNK.js";
 import {
   cloneAndFreezeData,
   isTemplateBlock
-} from "./chunk-BAOV476U.js";
+} from "./chunk-Y4D6TDZT.js";
+import {
+  parseMarkdown
+} from "./chunk-CW24CH7I.js";
 import {
   extractPlainText,
   getChildren
 } from "./chunk-X7BNDUNI.js";
 import {
   estimateTimeFromText
-} from "./chunk-67L6WRJN.js";
+} from "./chunk-GHOPHGOK.js";
 import {
   SeededRandom,
   hashString
@@ -506,7 +512,7 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
       elementsSinceImage++;
       if (config.interleaveImages && imageIndex < images.length && elementsSinceImage >= imageInterval) {
         const img = images[imageIndex];
-        const imageBlock = {
+        const imageBlock2 = {
           template: "imageWithCaption",
           id: `transform-img-${blockIdCounter++}`,
           duration: 4,
@@ -516,7 +522,7 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
           ambientMotion: rng.pick(AMBIENT_MOTIONS) ?? "zoomIn",
           sourceBlockId: ab.block.id
         };
-        blocks.push(imageBlock);
+        blocks.push(imageBlock2);
         imageIndex++;
         insertedCount++;
         elementsSinceImage = 0;
@@ -839,6 +845,310 @@ function firstTitle(doc) {
   return void 0;
 }
 
+// src/transform/narratedSegment.ts
+var DEFAULT_SLIDES_PER_MINUTE = 5;
+var DEFAULT_MAX_SLIDE_DURATION = 15;
+var DEFAULT_MIN_SLIDE_DURATION = 6;
+var DEFAULT_MAX_VIDEOS = 2;
+var AMBIENT_MOTIONS2 = [
+  "zoomIn",
+  "zoomOut",
+  "panLeft",
+  "panRight"
+];
+function transformNarratedSegment(input, options = {}) {
+  const seed = options.seed ?? hashString(`${input.articleId}-${input.segmentId}`);
+  const heading = input.title.replace(/[\r\n]+/g, " ").trim() || input.segmentId;
+  const pacing = {
+    slidesPerMinute: options.slidesPerMinute ?? DEFAULT_SLIDES_PER_MINUTE,
+    maxSlideDuration: options.maxSlideDuration ?? DEFAULT_MAX_SLIDE_DURATION,
+    minSlideDuration: options.minSlideDuration ?? DEFAULT_MIN_SLIDE_DURATION,
+    maxVideos: options.maxVideos ?? DEFAULT_MAX_VIDEOS
+  };
+  const images = uniqueImages(input.images ?? []);
+  const videos = input.videos ?? [];
+  const contentTarget = contentSlotCount(
+    input.duration,
+    pacing,
+    images.length + Math.min(videos.length, pacing.maxVideos),
+    !!input.includeTitleBlock
+  );
+  const markdown = chunkNarration(input.text, contentTarget).map((chunk) => `# ${heading}
+
+${chunk}`).join("\n\n");
+  const source = markdownToDoc(parseMarkdown(markdown), {
+    articleId: `${input.articleId}:${input.segmentId}`,
+    defaultDuration: Math.max(3, input.duration)
+  });
+  const sourceDoc = {
+    ...source,
+    articleId: input.articleId,
+    duration: input.duration,
+    audio: {
+      segments: [
+        {
+          src: input.audioSrc,
+          name: input.audioName ?? input.segmentId,
+          duration: input.duration,
+          startTime: 0
+        }
+      ]
+    }
+  };
+  const transformed = applyTransform(sourceDoc, options.style ?? "documentary", {
+    seed,
+    images: input.images,
+    themeId: options.themeId,
+    registry: options.registry,
+    overrides: {
+      // The style's transformRatio is a share of source blocks, and a
+      // narrated segment is one block — so it would always cap promotion at
+      // a single extraction. Size the cap by content slots instead; the
+      // slides-per-minute budget and blocksPerSection still apply.
+      transformRatio: (contentTarget + 0.5) / Math.max(1, source.blocks.length),
+      ...options.minConfidence === void 0 ? {} : { minConfidence: options.minConfidence },
+      ...options.slidesPerMinute === void 0 ? {} : { budget: { slidesPerMinute: options.slidesPerMinute } }
+    }
+  });
+  const title = input.includeTitleBlock ? {
+    template: "title",
+    id: `${input.segmentId}-title`,
+    duration: 4,
+    audioSegment: 0,
+    title: input.title
+  } : void 0;
+  const transformedBlocks = transformed.doc.blocks;
+  const sourceIds = new Set(source.blocks.map((block) => block.id));
+  const promoted = transformedBlocks.filter((block) => !sourceIds.has(block.id));
+  const kept = promoted.length > 0 ? promoted : transformedBlocks.slice(0, 1);
+  const content = kept.map((block) => ({
+    ...block,
+    id: namespacedId(block.id, input.segmentId)
+  }));
+  const paced = paceSegment({
+    segmentId: input.segmentId,
+    duration: input.duration,
+    title,
+    content,
+    videos,
+    images,
+    pacing,
+    rng: new SeededRandom(seed ^ 1540483477)
+  });
+  const timedBlocks = allocateTiming(paced, input.duration).map((block) => ({
+    ...block,
+    audioSegment: 0
+  }));
+  return {
+    ...transformed,
+    seed,
+    doc: {
+      ...transformed.doc,
+      articleId: input.articleId,
+      duration: input.duration,
+      audio: sourceDoc.audio,
+      blocks: timedBlocks
+    }
+  };
+}
+function paceTarget(duration, pacing) {
+  return Math.max(
+    1,
+    Math.round(duration / 60 * pacing.slidesPerMinute),
+    Math.ceil(duration / pacing.maxSlideDuration)
+  );
+}
+function contentSlotCount(duration, pacing, visualCount, hasTitle) {
+  const target = paceTarget(duration, pacing);
+  const share = visualCount >= 3 ? 0.2 : 0.4;
+  return Math.max(1, Math.round(target * share), target - (hasTitle ? 1 : 0) - visualCount);
+}
+function paceSegment(args) {
+  const { segmentId, duration, title, content, pacing, rng } = args;
+  const fixedCount = (title ? 1 : 0) + content.length;
+  const maxCount = Math.max(1, Math.floor(duration / pacing.minSlideDuration));
+  const target = paceTarget(duration, pacing);
+  const videoCount = args.videos.length === 0 ? 0 : Math.min(
+    args.videos.length,
+    pacing.maxVideos,
+    Math.max(1, Math.floor(target * 0.3)),
+    Math.max(0, maxCount - fixedCount)
+  );
+  const videos = pickVideos(args.videos, videoCount);
+  const pool = standaloneImagePool(args.images, content);
+  let count = Math.max(target, fixedCount + videos.length);
+  let imageCount = 0;
+  for (; ; ) {
+    imageCount = Math.min(pool.length, Math.max(0, count - fixedCount - videos.length));
+    const longest = longestFittedSlide(duration, count, title, content, videos, imageCount, pacing);
+    if (longest <= pacing.maxSlideDuration || imageCount >= pool.length || count >= maxCount) {
+      break;
+    }
+    count++;
+  }
+  const slot = duration / Math.max(1, count);
+  const items = [];
+  if (title) {
+    items.push({
+      block: { ...title, duration: Math.min(slot, pacing.minSlideDuration) },
+      at: -1,
+      rank: 0
+    });
+  }
+  content.forEach((block, index) => {
+    const anchor = typeof block.sourceStartTime === "number" ? block.sourceStartTime : (index + 0.5) / content.length * duration;
+    items.push({ block: { ...unanchored(block), duration: slot }, at: anchor, rank: 1 });
+  });
+  videos.forEach((video, index) => {
+    items.push({
+      block: videoBlock(video, index, segmentId, videoNominal(video, slot, pacing)),
+      at: videoPosition(index, videos.length) * duration,
+      rank: 2
+    });
+  });
+  for (let index = 0; index < imageCount; index++) {
+    items.push({
+      block: imageBlock(pool[index], index, segmentId, slot, rng),
+      at: (index + 0.5) / imageCount * duration,
+      rank: 3
+    });
+  }
+  return items.map((item, order) => ({ ...item, order })).sort((a, b) => a.at - b.at || a.rank - b.rank || a.order - b.order).map((item) => item.block);
+}
+function longestFittedSlide(duration, count, title, content, videos, imageCount, pacing) {
+  const slot = duration / Math.max(1, count);
+  const nominal = [
+    ...title ? [Math.min(slot, pacing.minSlideDuration)] : [],
+    ...content.map(() => slot),
+    ...videos.map((video) => videoNominal(video, slot, pacing)),
+    ...Array.from({ length: imageCount }, () => slot)
+  ];
+  const total = nominal.reduce((sum, d) => sum + d, 0);
+  return total > 0 ? Math.max(...nominal) * (duration / total) : duration;
+}
+function videoNominal(video, slot, pacing) {
+  return Math.min(slot, Math.max(pacing.minSlideDuration, video.clipEnd - video.clipStart));
+}
+function videoPosition(index, count) {
+  if (count === 1) return 0.4;
+  if (count === 2) return index === 0 ? 0.3 : 0.7;
+  return (index + 1) / (count + 1);
+}
+function pickVideos(videos, count) {
+  const picked = [];
+  const seenSources = /* @__PURE__ */ new Set();
+  for (const video of videos) {
+    if (picked.length >= count) break;
+    if (seenSources.has(video.src)) continue;
+    seenSources.add(video.src);
+    picked.push(video);
+  }
+  for (const video of videos) {
+    if (picked.length >= count) break;
+    if (!picked.includes(video)) picked.push(video);
+  }
+  return picked;
+}
+function standaloneImagePool(images, content) {
+  const shown = /* @__PURE__ */ new Set();
+  const accents = /* @__PURE__ */ new Set();
+  for (const block of content) {
+    const media = block;
+    if (block.template === "imageWithCaption" && media.imageSrc) shown.add(media.imageSrc);
+    if (media.accentImage?.src) accents.add(media.accentImage.src);
+    if (media.backgroundImage?.src) accents.add(media.backgroundImage.src);
+  }
+  const available = images.filter((image) => !shown.has(image.src));
+  return [
+    ...available.filter((image) => !accents.has(image.src)),
+    ...available.filter((image) => accents.has(image.src))
+  ];
+}
+function chunkNarration(text, count) {
+  if (count <= 1) return [text];
+  const sentences = [];
+  const boundary = /[.!?]["'’”)\]]*\s+/g;
+  let start = 0;
+  let match;
+  while ((match = boundary.exec(text)) !== null) {
+    const end = match.index + match[0].length;
+    const sentence = text.slice(start, end).trim();
+    if (sentence) sentences.push(sentence);
+    start = end;
+  }
+  const tail = text.slice(start).trim();
+  if (tail) sentences.push(tail);
+  if (sentences.length < 2) return [text];
+  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);
+  const chunks = [];
+  let current = [];
+  let seenWords = 0;
+  sentences.forEach((sentence, index) => {
+    current.push(sentence);
+    seenWords += words[index];
+    const due = totalWords * (chunks.length + 1) / chunkCount;
+    if (seenWords >= due && chunks.length < chunkCount - 1) {
+      chunks.push(current);
+      current = [];
+    }
+  });
+  if (current.length > 0) chunks.push(current);
+  return chunks.map((chunk) => chunk.join(" "));
+}
+function uniqueImages(images) {
+  const seen = /* @__PURE__ */ new Set();
+  return images.filter((image) => {
+    if (!image.src || seen.has(image.src)) return false;
+    seen.add(image.src);
+    return true;
+  });
+}
+function namespacedId(id, segmentId) {
+  return id.startsWith(`${segmentId}-`) ? id : `${segmentId}-${id}`;
+}
+function unanchored(block) {
+  const { sourceStartTime: _start, sourceDuration: _duration, ...rest } = block;
+  return rest;
+}
+function imageBlock(image, index, segmentId, duration, rng) {
+  const caption = image.alt && !/\.(jpe?g|png|gif|svg|webp)/i.test(image.alt) ? image.alt : "";
+  return {
+    template: "imageWithCaption",
+    id: `${segmentId}-image-${index}`,
+    duration,
+    audioSegment: 0,
+    imageSrc: image.src,
+    imageAlt: image.alt ?? "",
+    caption,
+    captionPosition: "bottom",
+    ambientMotion: rng.pick(AMBIENT_MOTIONS2) ?? "zoomIn",
+    imageCredit: image.credit,
+    imageLicense: image.license
+  };
+}
+function videoBlock(video, index, segmentId, duration) {
+  return {
+    template: "videoWithCaption",
+    id: `${segmentId}-video-${index}`,
+    duration,
+    audioSegment: 0,
+    videoSrc: video.src,
+    posterSrc: video.posterSrc,
+    videoAlt: video.alt ?? "",
+    clipStart: video.clipStart,
+    clipEnd: video.clipEnd,
+    // The clip's source file length (VideoWithCaptionInput's meaning), not a
+    // narration timing hint.
+    sourceDuration: video.sourceDuration,
+    caption: video.alt,
+    captionPosition: "bottom",
+    videoCredit: video.credit,
+    videoLicense: video.license
+  };
+}
+
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
   createTransformStyleRegistry,
@@ -847,5 +1157,7 @@ export {
   getTransformStyleSummaries,
   extractDocImages,
   analyzeBlocks,
-  applyTransform
+  allocateTiming,
+  applyTransform,
+  transformNarratedSegment
 };

package/dist/{chunk-2P44EZLI.js → chunk-SKKBRLLM.js}

@@ -1,9 +1,11 @@
 import {
   buildNarrationScript,
   expectedSyllablesAt,
-  flattenRenderableBlocks,
   wordPosAtExpectedSyllables
-} from "./chunk-AIB5WEK2.js";
+} from "./chunk-EF353KGH.js";
+import {
+  flattenRenderableBlocks
+} from "./chunk-3YNFMFNK.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({

package/dist/{chunk-NUS5YAI5.js → chunk-SOIV7KDO.js}

@@ -1,7 +1,10 @@
+import {
+  buildNarrationScript,
+  parseNarrationTimingJson
+} from "./chunk-EF353KGH.js";
 import {
   SHAPE_NAMES,
   buildChartData,
-  buildNarrationScript,
   buildRegistry,
   coerceTemplateParams,
   deriveTemplateInputs,
@@ -22,7 +25,6 @@ import {
   nearestName,
   normalizeShapeKind,
   parseDataFence,
-  parseNarrationTimingJson,
   parseStandaloneAnnotation,
   placeLayersInRect,
   readCustomThemesFromFrontmatter,
@@ -30,7 +32,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-AIB5WEK2.js";
+} from "./chunk-3YNFMFNK.js";
 import {
   iconMarker
 } from "./chunk-7ZAAICW4.js";
@@ -59,21 +61,19 @@ import {
   DEFAULT_THEME,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
+  VIEWPORT_PRESETS,
+  calculateFontScale,
+  createTemplateContext,
+  getViewportOrientation,
   hexHueDegrees,
+  isTemplateBlock,
   oklchDarken,
   oklchLighten,
   relativeLuminance,
   resolveFontFamily,
   resolveTheme,
   withAlpha
-} from "./chunk-RXYKU6EX.js";
-import {
-  VIEWPORT_PRESETS,
-  calculateFontScale,
-  createTemplateContext,
-  getViewportOrientation,
-  isTemplateBlock
-} from "./chunk-BAOV476U.js";
+} from "./chunk-Y4D6TDZT.js";
 import {
   parseMarkdown
 } from "./chunk-CW24CH7I.js";
@@ -94,7 +94,7 @@ import {
 } from "./chunk-X7BNDUNI.js";
 import {
   estimateTimeFromText
-} from "./chunk-67L6WRJN.js";
+} from "./chunk-GHOPHGOK.js";
 
 // src/doc/utils/animationUtils.ts
 function getAnimationStyle(animation, _currentTime = 0) {
@@ -4216,6 +4216,7 @@ function autoMatchBlocks(blocks, audioFiles) {
 async function resolveAudioMapping(doc, container) {
   const narration = await applyNarrationTiming(doc, container);
   doc = narration.doc;
+  if (doc.audio?.segments?.length > 0) return doc;
   const audioFiles = await discoverNarrationAudio(container);
   const scheduledSrcs = new Set(resolveMediaSchedule(doc).map((clip) => clip.src));
   const available = audioFiles.filter((f) => !scheduledSrcs.has(f.path));

package/dist/{chunk-NKNMGIIN.js → chunk-SVN7T6BK.js}

@@ -538,9 +538,6 @@ function cleanDescription(sentence, value) {
   for (const pattern of prepositionPatterns) {
     desc = desc.replace(pattern, "");
   }
-  if (desc === sentence) {
-    desc = sentence.replace(value, "").trim();
-  }
   desc = desc.replace(/^[,:\-–—]+\s*/, "").replace(/\s*[,:\-–—]+$/, "");
   desc = desc.replace(
     /\s+(?:of|on|in|at|by|to|for|from|with|about|over|under|between|than|into|onto|upon)\s*([,.])/gi,

package/dist/{chunk-DQRELU4S.js → chunk-VU4T74LI.js}

@@ -2,7 +2,7 @@ import {
   DEFAULT_THEME,
   applySurface,
   resolveFontFamily
-} from "./chunk-RXYKU6EX.js";
+} from "./chunk-Y4D6TDZT.js";
 
 // src/jsonForm/chooseControl.ts
 var ENUM_SEGMENTED_LIMIT = 4;