@bendyline/squisq 2.11.17 → 2.11.19

package/NOTICE.md

@@ -11,7 +11,7 @@ Third-party components remain under their respective license terms.
 | genson-js                                 | 0.0.8   | Apache-2.0                    | https://github.com/aspecto-io/genson-js                                |
 | hast-util-from-html                       | 2.0.3   | MIT                           | https://github.com/syntax-tree/hast-util-from-html                     |
 | localforage                               | 1.10.0  | Apache-2.0                    | https://github.com/localForage/localForage                             |
-| ngeohash                                  | 0.6.3   | MIT                           | https://github.com/sunng87/node-geohash                                |
+| ngeohash                                  | 0.6.4   | MIT                           | https://github.com/sunng87/node-geohash                                |
 | remark-directive                          | 3.0.1   | MIT                           | https://github.com/remarkjs/remark-directive                           |
 | remark-frontmatter                        | 5.0.0   | MIT                           | https://github.com/remarkjs/remark-frontmatter                         |
 | remark-gfm                                | 4.0.1   | MIT                           | https://github.com/remarkjs/remark-gfm                                 |
@@ -19,7 +19,7 @@ Third-party components remain under their respective license terms.
 | remark-parse                              | 11.0.0  | MIT                           | https://github.com/remarkjs/remark/tree/main/packages/remark-parse     |
 | remark-stringify                          | 11.0.0  | MIT                           | https://github.com/remarkjs/remark/tree/main/packages/remark-stringify |
 | unified                                   | 11.0.5  | MIT                           | https://unifiedjs.com                                                  |
-| @fortawesome/fontawesome-free _(bundled)_ | 7.2.0   | CC-BY-4.0 AND OFL-1.1 AND MIT | https://github.com/FortAwesome/Font-Awesome                            |
+| @fortawesome/fontawesome-free _(bundled)_ | 7.3.1   | CC-BY-4.0 AND OFL-1.1 AND MIT | https://github.com/FortAwesome/Font-Awesome                            |
 
 The generated icon catalog incorporates Font Awesome Free metadata. Exact
 third-party license texts for bundled code and data are shipped in

package/THIRD_PARTY_LICENSES.txt

@@ -5,10 +5,10 @@ and notice files are reproduced verbatim. When an npm tarball omits its
 repository license, the pinned upstream copy is vendored and identified below.
 
 COMPONENTS
-- @fortawesome/fontawesome-free@7.2.0 ((CC-BY-4.0 AND OFL-1.1 AND MIT)); files: LICENSE.txt
+- @fortawesome/fontawesome-free@7.3.1 ((CC-BY-4.0 AND OFL-1.1 AND MIT)); files: LICENSE.txt
 
 ==============================================================================
-@fortawesome/fontawesome-free@7.2.0 - LICENSE.txt
+@fortawesome/fontawesome-free@7.3.1 - LICENSE.txt
 ==============================================================================
 Fonticons, Inc. (https://fontawesome.com)
 

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-54RU7TBZ.js → chunk-BA5MMBI6.js}

@@ -1,10 +1,13 @@
 import {
-  buildNarrationScript,
   parseNarrationTimingJson
-} from "./chunk-PNXBDMNS.js";
+} from "./chunk-3XEABCT3.js";
+import {
+  applySavedPresentation
+} from "./chunk-QKNFR55R.js";
 import {
   SHAPE_NAMES,
   buildChartData,
+  buildNarrationScript,
   buildRegistry,
   coerceTemplateParams,
   deriveTemplateInputs,
@@ -32,7 +35,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-L7IIFWWW.js";
+} from "./chunk-QLN6ILHM.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -82,7 +85,7 @@ import {
 } from "./chunk-L7QZORLB.js";
 import {
   parseMarkdown
-} from "./chunk-PGWYC3S2.js";
+} from "./chunk-Y4OZ5DSG.js";
 import {
   KNOWN_BLOCK_META_KEYS,
   TABLE_FED_TEMPLATES,
@@ -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] } : {}
     };