@bendyline/squisq 2.11.17 → 2.11.18

package/dist/transform/index.js

@@ -1,18 +1,33 @@
 import {
   DEFAULT_TRANSFORM_STYLE_ID,
+  DYNAMIC_PRESENTATION_STYLE,
+  PRESENTATION_HINTS_KEY,
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
+  PRESENTATION_LIMITS,
   allocateTiming,
   analyzeBlocks,
+  applySavedPresentation,
   applyTransform,
+  compilePresentationPlan,
+  createPresentationPlan,
   createTransformStyleRegistry,
+  defaultPresentationHints,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  parsePresentationHints,
+  parsePresentationPlan,
+  presentationSections,
   resolveTransformStyle,
-  transformNarratedSegment
-} from "../chunk-KNC4ZBQC.js";
-import "../chunk-SVN7T6BK.js";
-import "../chunk-L7IIFWWW.js";
+  serializePresentationHints,
+  serializePresentationPlan,
+  transformNarratedSegment,
+  usesDynamicPresentation
+} from "../chunk-NM747LUO.js";
+import "../chunk-7IGKCHDP.js";
 import "../chunk-A5QJJZ5S.js";
+import "../chunk-SVN7T6BK.js";
 import "../chunk-PUS54YU6.js";
 import "../chunk-PFH3WV6J.js";
 import "../chunk-L7QZORLB.js";
@@ -25,13 +40,28 @@ import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
+  DYNAMIC_PRESENTATION_STYLE,
+  PRESENTATION_HINTS_KEY,
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
+  PRESENTATION_LIMITS,
   allocateTiming,
   analyzeBlocks,
+  applySavedPresentation,
   applyTransform,
+  compilePresentationPlan,
+  createPresentationPlan,
   createTransformStyleRegistry,
+  defaultPresentationHints,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  parsePresentationHints,
+  parsePresentationPlan,
+  presentationSections,
   resolveTransformStyle,
-  transformNarratedSegment
+  serializePresentationHints,
+  serializePresentationPlan,
+  transformNarratedSegment,
+  usesDynamicPresentation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.11.17",
+  "version": "2.11.18",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",

package/dist/chunk-PNXBDMNS.js

@@ -1,337 +0,0 @@
-import {
-  flattenRenderableBlocks,
-  getBlockBodyText
-} from "./chunk-L7IIFWWW.js";
-import {
-  estimateSpokenWordCount
-} from "./chunk-GHOPHGOK.js";
-
-// 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 = getBlockBodyText(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 clamp(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 = clamp(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 = clamp(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;
-}
-
-// 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 {
-  estimateSyllables,
-  buildNarrationScript,
-  expectedSyllablesAt,
-  wordPosAtExpectedSyllables,
-  wordIndexAtChar,
-  wordIndexAtTime,
-  resolveNarrationTimingGenerator,
-  buildNarrationTimingJson,
-  parseNarrationTimingJson
-};