@bendyline/squisq 2.11.16 → 2.11.18

package/dist/{Doc-Bd2kdzuy.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) */
@@ -2620,7 +2634,7 @@ interface Block {
  * A visual element within a block.
  * Layers are composited back-to-front (first layer is background).
  */
-type Layer = ImageLayer | TextLayer | ShapeLayer | PathLayer | MapLayer | VideoLayer | TableLayer | TreeLayer | MermaidLayer;
+type Layer = ImageLayer | TextLayer | ShapeLayer | PathLayer | MapLayer | VideoLayer | VideoEmbedLayer | TableLayer | TreeLayer | MermaidLayer;
 interface BaseLayer {
     /** Unique identifier for this layer */
     id: string;
@@ -2885,6 +2899,31 @@ interface VideoLayer extends BaseLayer {
         license?: string;
     };
 }
+/**
+ * Hosted video layer — the YouTube / Vimeo / Loom / Dailymotion / Wistia
+ * player for a paragraph that is only a link to the video's page.
+ *
+ * Carries the page URL, never a player URL: renderers re-derive the iframe
+ * `src` with `parseVideoEmbedUrl` (`@bendyline/squisq/markdown`), so an
+ * authored layer cannot smuggle in an arbitrary frame, and a URL that is not a
+ * supported video renders nothing. The player keeps the video's aspect ratio
+ * (16:9, or 9:16 for Shorts), letterboxed within the layer's bounds.
+ *
+ * Unlike {@link VideoLayer} this is not a clip on the document timeline: it
+ * does not follow play/pause, is never sought by frame capture, and adds no
+ * audio to exports. Live players appear only where a viewer can use them (the
+ * player's current slide); thumbnails, exports and frame capture draw a
+ * poster instead.
+ */
+interface VideoEmbedLayer extends BaseLayer {
+    type: 'videoEmbed';
+    content: {
+        /** The video's page URL — any form `parseVideoEmbedUrl` recognizes. */
+        url: string;
+        /** Names the player for assistive tech and labels the poster. */
+        title?: string;
+    };
+}
 /**
  * Table layer - renders a data table with themed styling.
  * Uses foreignObject inside SVG for HTML-based table layout.
@@ -3277,4 +3316,4 @@ declare function getBlockAtTime(blocks: Block[], time: number): Block | null;
  */
 declare function getCaptionAtTime(captions: CaptionTrack | undefined, time: number): CaptionPhrase | null;
 
-export { type FullBleedQuoteInput as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, type CustomTemplateValidationError as D, type CustomTemplateValidationResult as E, DARK_SURFACE as F, DEFAULT_DOC_FONT as G, DEFAULT_TITLE_FONT as H, type DataTableInput as I, type DateEventInput as J, type DeepPartial as K, type DefinitionCardInput as L, type DiagramBlockInput as M, type DiagramEdgeAnchor as N, type DiagramTemplateEdge as O, type DiagramTemplateNode as P, type Doc as Q, type DocBlock as R, type DocDiagnostic as S, type DonutChartInput as T, type DrawingBlockInput as U, FRONTMATTER_CUSTOM_TEMPLATES_KEY as V, FRONTMATTER_CUSTOM_THEMES_KEY as W, FRONTMATTER_MOTION_KEY as X, type FactCardInput as Y, type FontFamily as Z, type FontFamilyKind as _, type AccentPosition as a, type PersistentLayerTemplate as a$, type GradientBackgroundConfig as a0, type ImageBackgroundConfig as a1, type ImageLayer as a2, type ImageTreatment as a3, type ImageWithCaptionInput as a4, LIGHT_SURFACE as a5, type Layer as a6, type LayerRepeat as a7, type LayoutHints as a8, type LeftFeatureInput as a9, PAGE_EMPHASES as aA, PAGE_EYEBROWS as aB, PAGE_HEADING_CASES as aC, PAGE_HEADING_SCALES as aD, PAGE_HEADING_UNDERLINES as aE, PAGE_HERO_STYLES as aF, PAGE_IMAGE_FRAMINGS as aG, PAGE_NUMERAL_STYLES as aH, PAGE_PATTERNS as aI, PAGE_QUOTE_MARKS as aJ, PAGE_SECTION_KINDS as aK, PAGE_SECTION_SPACINGS as aL, PAGE_SHADOWS as aM, PAGE_VARIANTS as aN, type PageAccentRotation as aO, type PageBackground as aP, type PageDesignFamily as aQ, type PageEmphasis as aR, type PageHeadingTreatment as aS, type PageSectionKind as aT, type PageSectionOverride as aU, type PageTokens as aV, type PageVariant as aW, type PathLayer as aX, type PatternBackgroundConfig as aY, type PersistentLayer as aZ, type PersistentLayerConfig as a_, type LineChartInput as aa, type LinearGradient as ab, type ListBlockInput as ac, MOTION_PROFILES as ad, type MapBlockInput as ae, type MapLayer as af, type MapMarker as ag, type MapTileStyle as ah, type MarkerStyle as ai, type MediaClip as aj, type MediaCrop as ak, type MediaCut as al, type MediaEdits as am, type MediaScheduleOptions as an, type MermaidLayer as ao, type MotionEntrance as ap, type MotionOrigin as aq, type MotionProfile as ar, type MotionProfileName as as, type MotionSpec as at, type MotionState as au, PAGE_ACCENT_STRATEGIES as av, PAGE_BACKGROUNDS as aw, PAGE_BACKGROUND_RHYTHMS as ax, PAGE_DESIGN_FAMILIES as ay, PAGE_DIVIDERS as az, type AmbientGradientConfig as b, type ViewportConfig as b$, type PersistentLayerTemplateConfig as b0, type PersistentLayerTemplateType as b1, type PhotoGridInput as b2, type PieChartInput as b3, type PipStyle as b4, type Position as b5, type ProgressIndicatorConfig as b6, type PromotedBodyAnnotation as b7, type PullQuoteInput as b8, type QuoteBlockInput as b9, type ThemeRegistry as bA, type ThemeSchemaVersion as bB, type ThemeSeedColors as bC, type ThemeStyle as bD, type ThemeTypography as bE, type TimelineBlockInput as bF, type TimelineTemplateEvent as bG, type TimelineTemplateLink as bH, type TimelineTemplateTrack as bI, type TitleBlockInput as bJ, type TitleCaptionConfig as bK, type TranscriptBlockInput as bL, type TreeBlockInput as bM, type TreeLayer as bN, type TreeLayerItem as bO, type TreeLayerStyle as bP, type TreeTemplateItem as bQ, type TwoColumnInput as bR, VIEWPORT_PRESETS as bS, type VideoLayer as bT, type VideoPipPosition as bU, type VideoPipShape as bV, type VideoPipSize as bW, type VideoPlacement as bX, type VideoPresentation as bY, type VideoPullQuoteInput as bZ, type VideoWithCaptionInput as b_, type RawLayersInput as ba, type RenderStyle as bb, type RightFeatureInput as bc, type ScatterChartInput as bd, type ScheduledClip as be, type SectionHeaderInput as bf, type ShapeFilter as bg, type ShapeLayer as bh, type ShapePattern as bi, type SolidBackgroundConfig as bj, type StartBlockConfig as bk, type StatHighlightInput as bl, type SurfaceScheme as bm, THEME_SCHEMA_VERSION as bn, type TableLayer as bo, type TableLayerStyle as bp, type TemplateBlock as bq, type TemplateContext as br, type TemplateFunction as bs, type TemplateRegistry as bt, type TextLayer as bu, type TextStyle as bv, type Theme as bw, type ThemeColorPalette as bx, type ThemeColorScheme as by, type ThemePageStyle as bz, type Animation as c, type ViewportOrientation as c0, type ViewportPreset as c1, type VignetteConfig as c2, applySurface as c3, calculateDuration as c4, calculateFontScale as c5, createTemplateContext as c6, createTheme as c7, createThemeRegistry as c8, getAspectRatioString as c9, type MediaEditParamKey as cA, type MediaEditParamValues as cB, type MediaFxOp as cC, formatMediaNumber as cD, hasRenderableFx as cE, mediaEditHtmlAttribute as cF, mediaEditValuesFromAttributes as cG, mediaEditValuesFromParams as cH, mediaRenderKey as cI, normalizeMediaCrop as cJ, normalizeMediaCuts as cK, parseMediaCrop as cL, parseMediaCuts as cM, parseMediaEdits as cN, parseMediaFx as cO, serializeMediaCrop as cP, serializeMediaCuts as cQ, serializeMediaEdits as cR, serializeMediaFx as cS, getBlockAtTime as ca, getCaptionAtTime as cb, getDocPlaybackDuration as cc, getLayoutHints as cd, getSafeTextBounds as ce, getSegmentAtTime as cf, getTwoColumnPositions as cg, getViewport as ch, getViewportOrientation as ci, isCustomTemplateDefinition as cj, isMotionProfileName as ck, isPersistentLayerTemplate as cl, isTemplateBlock as cm, scaledFontSize$1 as cn, readFrontmatterMotion as co, resolveMediaSchedule as cp, resolveMotionForDoc as cq, resolveMotionProfile as cr, scaledFontSize as cs, scheduleMediaClip as ct, validateCustomTemplateDefinition as cu, type MediaFxOpId as cv, type MediaFxChain as cw, MEDIA_EDIT_PARAMS as cx, MEDIA_FX_ORDER as cy, MEDIA_FX_SPECS as cz, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type BigTextInput as j, type Block as k, type BlockConnection as l, type BorderStyle as m, type CaptionTrack as n, type CaptionWord as o, type ChartBaseFields as p, type ChartTemplateInput as q, type ColorScheme as r, type ColumnChartInput as s, type ComparisonBarInput as t, type ContentBlockInput as u, type CornerBrandingConfig as v, type CountUpSpec as w, type CreateTemplateContextOptions as x, type CustomTemplateDefinition as y, type CustomTemplateLayer as z };
+export { type FullBleedQuoteInput as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, type CustomTemplateValidationError as D, type CustomTemplateValidationResult as E, DARK_SURFACE as F, DEFAULT_DOC_FONT as G, DEFAULT_TITLE_FONT as H, type DataTableInput as I, type DateEventInput as J, type DeepPartial as K, type DefinitionCardInput as L, type DiagramBlockInput as M, type DiagramEdgeAnchor as N, type DiagramTemplateEdge as O, type DiagramTemplateNode as P, type Doc as Q, type DocBlock as R, type DocDiagnostic as S, type DonutChartInput as T, type DrawingBlockInput as U, FRONTMATTER_CUSTOM_TEMPLATES_KEY as V, FRONTMATTER_CUSTOM_THEMES_KEY as W, FRONTMATTER_MOTION_KEY as X, type FactCardInput as Y, type FontFamily as Z, type FontFamilyKind as _, type AccentPosition as a, type PersistentLayerTemplate as a$, type GradientBackgroundConfig as a0, type ImageBackgroundConfig as a1, type ImageLayer as a2, type ImageTreatment as a3, type ImageWithCaptionInput as a4, LIGHT_SURFACE as a5, type Layer as a6, type LayerRepeat as a7, type LayoutHints as a8, type LeftFeatureInput as a9, PAGE_EMPHASES as aA, PAGE_EYEBROWS as aB, PAGE_HEADING_CASES as aC, PAGE_HEADING_SCALES as aD, PAGE_HEADING_UNDERLINES as aE, PAGE_HERO_STYLES as aF, PAGE_IMAGE_FRAMINGS as aG, PAGE_NUMERAL_STYLES as aH, PAGE_PATTERNS as aI, PAGE_QUOTE_MARKS as aJ, PAGE_SECTION_KINDS as aK, PAGE_SECTION_SPACINGS as aL, PAGE_SHADOWS as aM, PAGE_VARIANTS as aN, type PageAccentRotation as aO, type PageBackground as aP, type PageDesignFamily as aQ, type PageEmphasis as aR, type PageHeadingTreatment as aS, type PageSectionKind as aT, type PageSectionOverride as aU, type PageTokens as aV, type PageVariant as aW, type PathLayer as aX, type PatternBackgroundConfig as aY, type PersistentLayer as aZ, type PersistentLayerConfig as a_, type LineChartInput as aa, type LinearGradient as ab, type ListBlockInput as ac, MOTION_PROFILES as ad, type MapBlockInput as ae, type MapLayer as af, type MapMarker as ag, type MapTileStyle as ah, type MarkerStyle as ai, type MediaClip as aj, type MediaCrop as ak, type MediaCut as al, type MediaEdits as am, type MediaScheduleOptions as an, type MermaidLayer as ao, type MotionEntrance as ap, type MotionOrigin as aq, type MotionProfile as ar, type MotionProfileName as as, type MotionSpec as at, type MotionState as au, PAGE_ACCENT_STRATEGIES as av, PAGE_BACKGROUNDS as aw, PAGE_BACKGROUND_RHYTHMS as ax, PAGE_DESIGN_FAMILIES as ay, PAGE_DIVIDERS as az, type AmbientGradientConfig as b, type VideoWithCaptionInput as b$, type PersistentLayerTemplateConfig as b0, type PersistentLayerTemplateType as b1, type PhotoGridInput as b2, type PieChartInput as b3, type PipStyle as b4, type Position as b5, type ProgressIndicatorConfig as b6, type PromotedBodyAnnotation as b7, type PullQuoteInput as b8, type QuoteBlockInput as b9, type ThemeRegistry as bA, type ThemeSchemaVersion as bB, type ThemeSeedColors as bC, type ThemeStyle as bD, type ThemeTypography as bE, type TimelineBlockInput as bF, type TimelineTemplateEvent as bG, type TimelineTemplateLink as bH, type TimelineTemplateTrack as bI, type TitleBlockInput as bJ, type TitleCaptionConfig as bK, type TranscriptBlockInput as bL, type TreeBlockInput as bM, type TreeLayer as bN, type TreeLayerItem as bO, type TreeLayerStyle as bP, type TreeTemplateItem as bQ, type TwoColumnInput as bR, VIEWPORT_PRESETS as bS, type VideoEmbedLayer as bT, type VideoLayer as bU, type VideoPipPosition as bV, type VideoPipShape as bW, type VideoPipSize as bX, type VideoPlacement as bY, type VideoPresentation as bZ, type VideoPullQuoteInput as b_, type RawLayersInput as ba, type RenderStyle as bb, type RightFeatureInput as bc, type ScatterChartInput as bd, type ScheduledClip as be, type SectionHeaderInput as bf, type ShapeFilter as bg, type ShapeLayer as bh, type ShapePattern as bi, type SolidBackgroundConfig as bj, type StartBlockConfig as bk, type StatHighlightInput as bl, type SurfaceScheme as bm, THEME_SCHEMA_VERSION as bn, type TableLayer as bo, type TableLayerStyle as bp, type TemplateBlock as bq, type TemplateContext as br, type TemplateFunction as bs, type TemplateRegistry as bt, type TextLayer as bu, type TextStyle as bv, type Theme as bw, type ThemeColorPalette as bx, type ThemeColorScheme as by, type ThemePageStyle as bz, type Animation as c, type ViewportConfig as c0, type ViewportOrientation as c1, type ViewportPreset as c2, type VignetteConfig as c3, applySurface as c4, calculateDuration as c5, calculateFontScale as c6, createTemplateContext as c7, createTheme as c8, createThemeRegistry as c9, MEDIA_FX_SPECS as cA, type MediaEditParamKey as cB, type MediaEditParamValues as cC, type MediaFxOp as cD, formatMediaNumber as cE, hasRenderableFx as cF, mediaEditHtmlAttribute as cG, mediaEditValuesFromAttributes as cH, mediaEditValuesFromParams as cI, mediaRenderKey as cJ, normalizeMediaCrop as cK, normalizeMediaCuts as cL, parseMediaCrop as cM, parseMediaCuts as cN, parseMediaEdits as cO, parseMediaFx as cP, serializeMediaCrop as cQ, serializeMediaCuts as cR, serializeMediaEdits as cS, serializeMediaFx as cT, getAspectRatioString as ca, getBlockAtTime as cb, getCaptionAtTime as cc, getDocPlaybackDuration as cd, getLayoutHints as ce, getSafeTextBounds as cf, getSegmentAtTime as cg, getTwoColumnPositions as ch, getViewport as ci, getViewportOrientation as cj, isCustomTemplateDefinition as ck, isMotionProfileName as cl, isPersistentLayerTemplate as cm, isTemplateBlock as cn, scaledFontSize$1 as co, readFrontmatterMotion as cp, resolveMediaSchedule as cq, resolveMotionForDoc as cr, resolveMotionProfile as cs, scaledFontSize as ct, scheduleMediaClip as cu, validateCustomTemplateDefinition as cv, type MediaFxOpId as cw, type MediaFxChain as cx, MEDIA_EDIT_PARAMS as cy, MEDIA_FX_ORDER as cz, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type BigTextInput as j, type Block as k, type BlockConnection as l, type BorderStyle as m, type CaptionTrack as n, type CaptionWord as o, type ChartBaseFields as p, type ChartTemplateInput as q, type ColorScheme as r, type ColumnChartInput as s, type ComparisonBarInput as t, type ContentBlockInput as u, type CornerBrandingConfig as v, type CountUpSpec as w, type CreateTemplateContextOptions as x, type CustomTemplateDefinition as y, type CustomTemplateLayer as z };

package/dist/{ImageEditDoc-C3HOltpW.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-Bd2kdzuy.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
+};