@bendyline/squisq 2.11.17 → 2.11.18

package/dist/{Doc-CXx1WL8G.d.ts → Doc-B6TYHYGc.d.ts}

@@ -703,6 +703,8 @@ interface AccentImage {
  * Base properties shared by all template blocks.
  */
 interface BaseTemplateBlock {
+    /** Compiled presentation timing is authoritative; pacing must not merge or split it. */
+    timelineLocked?: boolean;
     /** Unique block ID */
     id: string;
     /** Block duration in seconds */
@@ -1310,6 +1312,8 @@ interface DiagramTemplateEdge {
  */
 interface DiagramBlockInput extends BaseTemplateBlock {
     template: 'diagram';
+    /** Paint an opaque themed surface for standalone slides; omitted stays transparent. */
+    background?: 'surface';
     /** Optional diagram title displayed above the canvas. */
     title?: string;
     /** Color scheme for nodes and edges. */
@@ -2330,6 +2334,16 @@ interface DocDiagnostic {
  * A complete visual doc for an article.
  */
 interface Doc {
+    /** Projection-only source/timing metadata from the document narration take. */
+    presentationNarration?: {
+        sourceText: string;
+        src: string;
+        startTime: number;
+        duration: number;
+        bookmarks: AudioBookmark[];
+    };
+    /** Projection-only guard: never compile an accepted plan twice. */
+    presentationApplied?: boolean;
     /** Article ID this doc belongs to */
     articleId: string;
     /** Total duration in seconds (sum of all audio segments) */

package/dist/{ImageEditDoc-BVLXI-Zd.d.ts → ImageEditDoc-CN_3Ysj5.d.ts}

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

package/dist/chunk-3XEABCT3.js

@@ -0,0 +1,114 @@
+// src/narration/sidecar.ts
+function resolveNarrationTimingGenerator(options) {
+  const baseWpm = options?.generator?.baseWpm ?? options?.baseWpm;
+  return {
+    name: options?.generator?.name ?? "squisq-teleprompter",
+    method: options?.generator?.method ?? "dsp-align",
+    ...baseWpm !== void 0 ? { baseWpm } : {}
+  };
+}
+function buildNarrationTimingJson(script, alignment, durationSec, options) {
+  const bookmarks = alignment.words.map((word) => {
+    const token = script.tokens[word.tokenIndex];
+    return {
+      id: `word-${word.tokenIndex}`,
+      time: word.tSec,
+      charOffset: token?.charOffset ?? 0,
+      textFragment: token?.text ?? ""
+    };
+  });
+  const blocks = alignment.blocks.map((range) => ({
+    ...range.blockId ? { blockId: range.blockId } : {},
+    ...range.heading !== void 0 ? { heading: range.heading } : {},
+    blockIndex: range.blockIndex,
+    charStart: range.charStart,
+    charEnd: range.charEnd,
+    startSec: range.startSec,
+    endSec: range.endSec
+  }));
+  return {
+    version: 3,
+    sourceText: script.sourceText,
+    duration: Number.isFinite(durationSec) && durationSec >= 0 ? durationSec : 0,
+    bookmarks,
+    blocks,
+    // Write only what `parseNarrationTimingJson` will read back, so the codec
+    // is a round-trip pair. A non-finite value would serialize to `null`
+    // (JSON has no NaN) and be dropped on parse anyway — omitting it here
+    // keeps the emitted sidecar honest rather than carrying a dead field.
+    ...finiteNumber(options?.cameraOffsetSec) ? { cameraOffsetSec: options.cameraOffsetSec } : {},
+    generator: resolveNarrationTimingGenerator(options)
+  };
+}
+function finiteNonNegative(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function parseNarrationTimingJson(data) {
+  try {
+    const text = typeof data === "string" ? data : new TextDecoder().decode(data instanceof Uint8Array ? data : new Uint8Array(data));
+    const parsed = JSON.parse(text);
+    if (typeof parsed !== "object" || parsed === null) return null;
+    const raw = parsed;
+    if (typeof raw.sourceText !== "string" || !finiteNonNegative(raw.duration)) return null;
+    const bookmarks = Array.isArray(raw.bookmarks) ? raw.bookmarks.flatMap((b) => {
+      if (typeof b !== "object" || b === null) return [];
+      const bookmark = b;
+      if (!finiteNonNegative(bookmark.time) || !finiteNonNegative(bookmark.charOffset)) {
+        return [];
+      }
+      return [
+        {
+          id: typeof bookmark.id === "string" ? bookmark.id : `bookmark-${bookmark.charOffset}`,
+          time: bookmark.time,
+          charOffset: bookmark.charOffset,
+          ...typeof bookmark.textFragment === "string" ? { textFragment: bookmark.textFragment } : {}
+        }
+      ];
+    }) : [];
+    let blocks = Array.isArray(raw.blocks) ? raw.blocks.flatMap((b) => {
+      if (typeof b !== "object" || b === null) return [];
+      const block = b;
+      if (!finiteNonNegative(block.startSec) || !finiteNonNegative(block.endSec) || !finiteNonNegative(block.charStart) || !finiteNonNegative(block.charEnd)) {
+        return [];
+      }
+      return [
+        {
+          ...typeof block.blockId === "string" ? { blockId: block.blockId } : {},
+          ...typeof block.heading === "string" ? { heading: block.heading } : {},
+          blockIndex: finiteNonNegative(block.blockIndex) ? block.blockIndex : 0,
+          charStart: block.charStart,
+          charEnd: block.charEnd,
+          startSec: block.startSec,
+          endSec: Math.max(block.startSec, block.endSec)
+        }
+      ];
+    }) : [];
+    blocks = blocks.sort((a, b) => a.startSec - b.startSec);
+    let cursor = 0;
+    for (const block of blocks) {
+      if (block.startSec < cursor) block.startSec = cursor;
+      if (block.endSec < block.startSec) block.endSec = block.startSec;
+      cursor = block.startSec;
+    }
+    return {
+      version: 3,
+      sourceText: raw.sourceText,
+      duration: raw.duration,
+      bookmarks,
+      blocks,
+      ...finiteNumber(raw.cameraOffsetSec) ? { cameraOffsetSec: raw.cameraOffsetSec } : {},
+      ...typeof raw.generator === "object" && raw.generator !== null ? { generator: raw.generator } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+
+export {
+  resolveNarrationTimingGenerator,
+  buildNarrationTimingJson,
+  parseNarrationTimingJson
+};

package/dist/{chunk-L7IIFWWW.js → chunk-7IGKCHDP.js}

@@ -75,7 +75,8 @@ import {
   resolveBlockTransition
 } from "./chunk-4VOD55SX.js";
 import {
-  estimateReadingTime
+  estimateReadingTime,
+  estimateSpokenWordCount
 } from "./chunk-GHOPHGOK.js";
 import {
   SeededRandom,
@@ -6048,9 +6049,11 @@ function nodesFromTemplateData(input) {
 function diagramBlock(input, context) {
   const { theme, viewport, children = [] } = context;
   const colors = input.colorScheme ? resolveColorScheme(context, input.colorScheme) : void 0;
+  const background = input.background === "surface" ? [createBackgroundLayer("diagram-bg", themedSurfaceGradient(context, 170))] : [];
   const resolved = children.length > 0 ? nodesFromChildren(context) : input.nodes && input.nodes.length > 0 ? nodesFromTemplateData(input) : { nodes: [], edges: [] };
   if (resolved.nodes.length === 0) {
     return [
+      ...background,
       {
         type: "text",
         id: "diagram-empty",
@@ -6091,7 +6094,7 @@ function diagramBlock(input, context) {
     w: n.w * scale,
     h: n.h * scale
   });
-  const layers = [];
+  const layers = [...background];
   if (input.title) {
     const titleLayer = canvasTitleLayer("diagram-title", input.title, frame, placement, context);
     if (titleLayer) layers.push(titleLayer);
@@ -11005,6 +11008,28 @@ function expandDocBlocks(blocks, options = {}) {
   const splitParts = /* @__PURE__ */ new Map();
   for (const [segmentIndex, segmentBlocks] of blocksBySegment) {
     const audioSegment = audioSegments[segmentIndex];
+    if (segmentBlocks.every(({ block }) => block.timelineLocked === true)) {
+      for (const { block, originalIndex } of segmentBlocks) {
+        const expanded = materializeScheduledBlock(
+          block,
+          originalIndex,
+          totalBlocks,
+          theme,
+          viewport,
+          effectivePersistentLayers,
+          expandedPersistentLayers,
+          registry,
+          failureMode,
+          onDiagnostic,
+          motion,
+          opts.mediaAspectRatios
+        );
+        expanded.startTime = block.sourceStartTime ?? 0;
+        expanded.duration = block.duration;
+        expandedBlocks[originalIndex] = expanded;
+      }
+      continue;
+    }
     if (!audioSegment) {
       let offsetTime = 0;
       for (const { block, originalIndex } of segmentBlocks) {
@@ -12485,6 +12510,215 @@ function buildStartBlock(markdownDoc, rootBlocks, fileName) {
   return config;
 }
 
+// src/narration/syllables.ts
+var BOUNDARY_PUNCT = /^[.,!?;:'"()[\]{}]+|[.,!?;:'"()[\]{}]+$/g;
+var SYLLABLES_PER_SPOKEN_WORD = 1.4;
+function estimateSyllables(token) {
+  const stripped = token.replace(BOUNDARY_PUNCT, "");
+  if (!stripped) return 1;
+  if (/^[-+]?[\d.,]+$/.test(stripped)) {
+    const num = parseFloat(stripped.replace(/,/g, ""));
+    if (!Number.isNaN(num) && Number.isFinite(num)) {
+      return Math.max(1, Math.round(estimateSpokenWordCount(stripped) * SYLLABLES_PER_SPOKEN_WORD));
+    }
+  }
+  if (/^[A-Z]{2,5}$/.test(stripped) && !/[AEIOUY]/.test(stripped)) {
+    return stripped.length;
+  }
+  const parts = stripped.toLowerCase().split(/[^a-z']+/).filter((p) => p.length > 0);
+  if (parts.length === 0) return 1;
+  let total = 0;
+  for (const part of parts) {
+    total += countAlphaSyllables(part.replace(/'/g, ""));
+  }
+  return Math.max(1, total);
+}
+function countAlphaSyllables(word) {
+  if (!word) return 0;
+  const groups = word.match(/[aeiouy]+/g);
+  let count = groups ? groups.length : 0;
+  if (count === 0) return 1;
+  if (count > 1 && /[^aeiouy]e$/.test(word)) {
+    count -= 1;
+  }
+  if (count > 1 && /[^aeiouy]ed$/.test(word) && !/[td]ed$/.test(word)) {
+    count -= 1;
+  }
+  if (count > 1 && /[^aeiouy]es$/.test(word) && !/(?:[sxz]|[cs]h)es$/.test(word)) {
+    count -= 1;
+  }
+  if (/[^aeiouy]le$/.test(word)) {
+    count += 1;
+  }
+  return Math.max(1, count);
+}
+
+// src/narration/script.ts
+function blockSpokenText(block, includeTitles) {
+  const title = includeTitles && block.title ? block.title.trim() : "";
+  const body = getBlockBodyText2(block);
+  if (title && body) return `${title}
+${body}`;
+  return title || body;
+}
+function buildNarrationScript(doc, options) {
+  const includeTitles = options?.includeTitles ?? true;
+  const separator = options?.blockSeparator ?? "\n\n";
+  const pieces = [];
+  for (const block of flattenRenderableBlocks(doc.blocks)) {
+    const text = blockSpokenText(block, includeTitles);
+    if (!text) continue;
+    pieces.push({
+      blockId: block.id,
+      heading: block.title || void 0,
+      text
+    });
+  }
+  let sourceText = "";
+  const blocks = [];
+  for (let i = 0; i < pieces.length; i++) {
+    if (i > 0) sourceText += separator;
+    const charStart = sourceText.length;
+    sourceText += pieces[i].text;
+    blocks.push({
+      blockId: pieces[i].blockId,
+      ...pieces[i].heading !== void 0 ? { heading: pieces[i].heading } : {},
+      tokenStart: 0,
+      tokenEnd: 0,
+      charStart,
+      charEnd: sourceText.length
+    });
+  }
+  const tokens = [];
+  const tokenRe = /\S+/g;
+  let blockIndex = 0;
+  let match;
+  while ((match = tokenRe.exec(sourceText)) !== null) {
+    const charOffset = match.index;
+    const charEnd = charOffset + match[0].length;
+    while (blockIndex < blocks.length - 1 && charOffset >= blocks[blockIndex].charEnd) {
+      blockIndex++;
+    }
+    const spoken = hasSpokenContent(match[0]);
+    tokens.push({
+      text: match[0],
+      charOffset,
+      charEnd,
+      blockId: blocks[blockIndex]?.blockId ?? "",
+      blockIndex,
+      syllables: spoken ? estimateSyllables(match[0]) : 0,
+      spokenWordEquiv: spoken ? estimateSpokenWordCount(stripBoundaryPunct(match[0])) : 0,
+      pauseAfter: 0,
+      spoken
+    });
+  }
+  for (const range of blocks) {
+    range.tokenStart = tokens.length;
+    range.tokenEnd = 0;
+  }
+  for (let i = 0; i < tokens.length; i++) {
+    const range = blocks[tokens[i].blockIndex];
+    if (range) {
+      if (i < range.tokenStart) range.tokenStart = i;
+      range.tokenEnd = i + 1;
+    }
+  }
+  for (const range of blocks) {
+    if (range.tokenStart > range.tokenEnd) {
+      range.tokenStart = range.tokenEnd;
+    }
+  }
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    const next = tokens[i + 1];
+    if (!next || next.blockIndex !== token.blockIndex) {
+      token.pauseAfter = 3;
+    } else if (sourceText.slice(token.charEnd, next.charOffset).includes("\n")) {
+      token.pauseAfter = 2;
+    } else if (endsWithClausePunctuation(token.text)) {
+      token.pauseAfter = 1;
+    }
+  }
+  const cumulativeSyllables = new Array(tokens.length + 1);
+  cumulativeSyllables[0] = 0;
+  for (let i = 0; i < tokens.length; i++) {
+    cumulativeSyllables[i + 1] = cumulativeSyllables[i] + tokens[i].syllables;
+  }
+  return {
+    sourceText,
+    tokens,
+    blocks,
+    totalSyllables: cumulativeSyllables[tokens.length],
+    cumulativeSyllables
+  };
+}
+var TRAILING_CLOSERS = /["')\]}»”’]+$/;
+function hasSpokenContent(token) {
+  return /[\p{L}\p{N}]/u.test(token);
+}
+function stripBoundaryPunct(token) {
+  return token.replace(/^[.,!?;:'"()[\]{}]+|[.,!?;:'"()[\]{}]+$/g, "");
+}
+function endsWithClausePunctuation(token) {
+  const bare = token.replace(TRAILING_CLOSERS, "");
+  const last = bare.charAt(bare.length - 1);
+  if (!last) return false;
+  if (last === ",") {
+    return true;
+  }
+  return last === "." || last === ";" || last === ":" || last === "!" || last === "?";
+}
+function clamp2(value, min, max) {
+  return value < min ? min : value > max ? max : value;
+}
+function expectedSyllablesAt(script, wordPos) {
+  const n = script.tokens.length;
+  if (n === 0) return 0;
+  const pos = clamp2(wordPos, 0, n);
+  const idx = Math.floor(pos);
+  if (idx >= n) return script.totalSyllables;
+  return script.cumulativeSyllables[idx] + (pos - idx) * script.tokens[idx].syllables;
+}
+function wordPosAtExpectedSyllables(script, syllables) {
+  const n = script.tokens.length;
+  if (n === 0) return 0;
+  const target = clamp2(syllables, 0, script.totalSyllables);
+  let lo = 0;
+  let hi = n;
+  while (lo < hi) {
+    const mid = lo + hi + 1 >> 1;
+    if (script.cumulativeSyllables[mid] <= target) lo = mid;
+    else hi = mid - 1;
+  }
+  if (lo >= n) return n;
+  const within = target - script.cumulativeSyllables[lo];
+  const sylls = script.tokens[lo].syllables;
+  return lo + (sylls > 0 ? within / sylls : 0);
+}
+function wordIndexAtChar(script, charOffset) {
+  const tokens = script.tokens;
+  if (tokens.length === 0) return 0;
+  let lo = 0;
+  let hi = tokens.length - 1;
+  while (lo < hi) {
+    const mid = lo + hi >> 1;
+    if (tokens[mid].charEnd <= charOffset) lo = mid + 1;
+    else hi = mid;
+  }
+  return lo;
+}
+function wordIndexAtTime(words, tSec) {
+  if (words.length === 0) return 0;
+  let lo = 0;
+  let hi = words.length - 1;
+  while (lo < hi) {
+    const mid = lo + hi + 1 >> 1;
+    if (words[mid].tSec <= tSec) lo = mid;
+    else hi = mid - 1;
+  }
+  return words[lo].tSec <= tSec ? lo : 0;
+}
+
 export {
   expandPersistentLayers,
   getPersistentLayersFromTheme,
@@ -12622,5 +12856,11 @@ export {
   flattenRenderableBlocks,
   countBlocks,
   getBlockDepth,
-  getBlockBodyText2 as getBlockBodyText
+  getBlockBodyText2 as getBlockBodyText,
+  estimateSyllables,
+  buildNarrationScript,
+  expectedSyllablesAt,
+  wordPosAtExpectedSyllables,
+  wordIndexAtChar,
+  wordIndexAtTime
 };

package/dist/{chunk-54RU7TBZ.js → chunk-J4ACZBO4.js}

@@ -1,10 +1,13 @@
 import {
-  buildNarrationScript,
   parseNarrationTimingJson
-} from "./chunk-PNXBDMNS.js";
+} from "./chunk-3XEABCT3.js";
+import {
+  applySavedPresentation
+} from "./chunk-NM747LUO.js";
 import {
   SHAPE_NAMES,
   buildChartData,
+  buildNarrationScript,
   buildRegistry,
   coerceTemplateParams,
   deriveTemplateInputs,
@@ -32,7 +35,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-L7IIFWWW.js";
+} from "./chunk-7IGKCHDP.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -1033,6 +1036,8 @@ function resolveDocumentTitle(doc, provided) {
   return provided?.trim() ?? "";
 }
 function buildPreviewDoc(doc, options) {
+  doc = applySavedPresentation(doc);
+  if (doc.presentationApplied) options = { ...options, interleaveImages: false };
   const flat = flattenRenderableBlocks(doc.blocks);
   const allImages = collectAllDocImages(doc.blocks);
   const usedImageSrcs = /* @__PURE__ */ new Set();
@@ -4418,6 +4423,16 @@ async function applyNarrationTiming(doc, container) {
       ...doc,
       blocks,
       duration,
+      presentationNarration: {
+        sourceText: timing.sourceText,
+        src: clip.src,
+        startTime: clip.startAt,
+        duration: playedDuration,
+        bookmarks: timing.bookmarks.flatMap((bookmark) => {
+          const time = timeMap ? timeMap.sourceToPlayed(bookmark.time) : bookmark.time;
+          return time !== null && time >= 0 && time <= playedDuration ? [{ ...bookmark, time: clip.startAt + time }] : [];
+        })
+      },
       ...captions ? { captions } : {},
       ...ctx.diagnostics.length > 0 ? { diagnostics: [...doc.diagnostics ?? [], ...ctx.diagnostics] } : {}
     };