@bendyline/squisq 2.11.5 → 2.11.6

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "./chunk-2P44EZLI.js";
+} from "./chunk-UUI35INI.js";
 import {
   fenceRendererLangs
 } from "./chunk-PGI7HSWE.js";
@@ -47,21 +47,30 @@ import {
   readProofingSettings,
   resolveProofDialect
 } from "./chunk-B3AK7SLZ.js";
+import {
+  calculateKeywordAffinity,
+  extractKeywords,
+  matchByKeywordAffinity,
+  selectSafeZoneClips,
+  selectTranscriptClips
+} from "./chunk-ZP5F7LUH.js";
 import {
   DEFAULT_TRANSFORM_STYLE_ID,
+  allocateTiming,
   analyzeBlocks,
   applyTransform,
   createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  resolveTransformStyle
-} from "./chunk-ZSU5DJLX.js";
+  resolveTransformStyle,
+  transformNarratedSegment
+} from "./chunk-J2IPSQKP.js";
 import {
   extractContent,
   mapElementToBlock,
   stripMarkdown
-} from "./chunk-NKNMGIIN.js";
+} from "./chunk-SVN7T6BK.js";
 import {
   DATA_BACKUP_PREFIX,
   DocumentVersionManager,
@@ -94,7 +103,7 @@ import {
   resolveRef,
   setByPointer,
   toPointer
-} from "./chunk-DQRELU4S.js";
+} from "./chunk-VU4T74LI.js";
 import {
   IMAGE_EDIT_ASSETS_PREFIX,
   IMAGE_EDIT_DEFAULT_BASENAME,
@@ -142,7 +151,7 @@ import {
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "./chunk-XV4SF2N5.js";
+} from "./chunk-BUJ5RV2P.js";
 import {
   calculateBearing,
   decodeGeohash,
@@ -227,7 +236,17 @@ import {
   validateMarkdownDoc,
   validateMarkdownSource,
   writeDashboardLayoutsToFrontmatter
-} from "./chunk-NUS5YAI5.js";
+} from "./chunk-GRGLZF4A.js";
+import {
+  buildNarrationScript,
+  buildNarrationTimingJson,
+  estimateSyllables,
+  expectedSyllablesAt,
+  parseNarrationTimingJson,
+  wordIndexAtChar,
+  wordIndexAtTime,
+  wordPosAtExpectedSyllables
+} from "./chunk-764WHWKM.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -251,8 +270,6 @@ import {
   asciiTimelineToTemplateData,
   autoTemplatePreservesContent,
   bigText,
-  buildNarrationScript,
-  buildNarrationTimingJson,
   buildRegistry,
   canvasToAsciiCell,
   coerceTemplateParams,
@@ -270,11 +287,9 @@ import {
   deriveTemplateInputs,
   diagramBlock,
   drawingBlock,
-  estimateSyllables,
   expandCoverBlock,
   expandDocBlocks,
   expandPersistentLayers,
-  expectedSyllablesAt,
   extractBlockquoteText,
   extractBodyPlainText,
   extractEmbeddedVideos,
@@ -319,7 +334,6 @@ import {
   materializeBlockLayers,
   normalizeShapeKind,
   parseDataFence,
-  parseNarrationTimingJson,
   parseYamlSubset,
   photoGrid,
   pullQuote,
@@ -351,13 +365,10 @@ import {
   twoColumn,
   videoPullQuote,
   videoWithCaption,
-  wordIndexAtChar,
-  wordIndexAtTime,
-  wordPosAtExpectedSyllables,
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-AIB5WEK2.js";
+} from "./chunk-WAGJK36Q.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -411,8 +422,10 @@ import {
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
+  DEFAULT_DOC_FONT,
   DEFAULT_THEME,
   DEFAULT_THEME_ID,
+  DEFAULT_TITLE_FONT,
   FONT_FALLBACKS,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
@@ -437,21 +450,32 @@ import {
   PAGE_SHADOWS,
   THEMES,
   THEME_SCHEMA_VERSION,
+  VIEWPORT_PRESETS,
   applySurface,
   assertTheme,
   buildGoogleFontsUrl,
+  calculateFontScale,
   contrastRatio,
+  createTemplateContext,
   createTheme,
   createThemeRegistry,
   deriveScale,
   fontStack,
+  getAspectRatioString,
   getAvailableThemes,
   getFontStack,
+  getLayoutHints,
+  getSafeTextBounds,
   getThemeSummaries,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
   guessFontFallback,
   hexHueDegrees,
   isCustomTemplateDefinition,
   isHex,
+  isPersistentLayerTemplate,
+  isTemplateBlock,
   matchFontFamily,
   oklchDarken,
   oklchLighten,
@@ -460,27 +484,12 @@ import {
   relativeLuminance,
   resolveFontFamily,
   resolveTheme,
+  scaledFontSize,
+  scaledFontSize2,
   validateCustomTemplateDefinition,
   validateTheme,
   withAlpha
-} from "./chunk-RXYKU6EX.js";
-import {
-  DEFAULT_DOC_FONT,
-  DEFAULT_TITLE_FONT,
-  VIEWPORT_PRESETS,
-  calculateFontScale,
-  createTemplateContext,
-  getAspectRatioString,
-  getLayoutHints,
-  getSafeTextBounds,
-  getTwoColumnPositions,
-  getViewport,
-  getViewportOrientation,
-  isPersistentLayerTemplate,
-  isTemplateBlock,
-  scaledFontSize,
-  scaledFontSize2
-} from "./chunk-BAOV476U.js";
+} from "./chunk-Y4D6TDZT.js";
 import {
   LocalForageAdapter,
   LocalStorageAdapter,
@@ -576,17 +585,18 @@ import {
   resolveTransitionDuration
 } from "./chunk-4VOD55SX.js";
 import {
-  estimateNarrationTime,
-  estimateReadingTime
-} from "./chunk-XOFT65EX.js";
+  buildCaptionTrack
+} from "./chunk-44BJ42GT.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,
+  estimateNarrationTime,
+  estimateReadingTime,
   estimateSpokenWordCount,
   estimateTimeFromText
-} from "./chunk-67L6WRJN.js";
+} from "./chunk-GHOPHGOK.js";
 import {
   SeededRandom,
   hashString
@@ -706,6 +716,7 @@ export {
   adjustY,
   advanceCoverage,
   alignNarration,
+  allocateTiming,
   analyzeBlocks,
   anchorPoint,
   appendPointer,
@@ -729,6 +740,7 @@ export {
   bigText,
   blankProtectedSpans,
   buildAdvanceTimingJson,
+  buildCaptionTrack,
   buildDashboardCellChrome,
   buildDataBackupPath,
   buildGoogleFontsUrl,
@@ -747,6 +759,7 @@ export {
   calculateBearing,
   calculateDuration,
   calculateFontScale,
+  calculateKeywordAffinity,
   calculatePrefixDuration,
   canonicalIconToken,
   canvasToAsciiCell,
@@ -833,6 +846,7 @@ export {
   extractFirstImage,
   extractFrameFeatures,
   extractImages,
+  extractKeywords,
   extractListItems,
   extractPlainText,
   extractRichListItems,
@@ -951,6 +965,7 @@ export {
   markdownBlockSeparatorLines,
   markdownToDoc,
   markerPath,
+  matchByKeywordAffinity,
   matchFontFamily,
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
@@ -1064,6 +1079,8 @@ export {
   scoreTextSimilarity,
   sectionExtractors,
   sectionHeader,
+  selectSafeZoneClips,
+  selectTranscriptClips,
   serializePandocAttributes,
   serializeTheme,
   setByPointer,
@@ -1098,6 +1115,7 @@ export {
   tokenizeAttrTokens,
   touch,
   traceWordPosAt,
+  transformNarratedSegment,
   transposeCells,
   treeBlock,
   treeFromMarkdownList,

package/dist/jsonForm/index.js

@@ -15,11 +15,10 @@ import {
   resolveRef,
   setByPointer,
   toPointer
-} from "../chunk-DQRELU4S.js";
-import "../chunk-XV4SF2N5.js";
+} from "../chunk-VU4T74LI.js";
+import "../chunk-BUJ5RV2P.js";
 import "../chunk-GAZKTT4R.js";
-import "../chunk-RXYKU6EX.js";
-import "../chunk-BAOV476U.js";
+import "../chunk-Y4D6TDZT.js";
 import "../chunk-4VOD55SX.js";
 export {
   appendPointer,

package/dist/narration/index.js

@@ -27,7 +27,7 @@ import {
   recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "../chunk-2P44EZLI.js";
+} from "../chunk-UUI35INI.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -37,16 +37,15 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-AIB5WEK2.js";
+} from "../chunk-764WHWKM.js";
+import "../chunk-WAGJK36Q.js";
 import "../chunk-PUS54YU6.js";
 import "../chunk-C3NAY5YP.js";
-import "../chunk-RXYKU6EX.js";
-import "../chunk-BAOV476U.js";
+import "../chunk-Y4D6TDZT.js";
 import "../chunk-TMOHAFYE.js";
 import "../chunk-X7BNDUNI.js";
 import "../chunk-4VOD55SX.js";
-import "../chunk-XOFT65EX.js";
-import "../chunk-67L6WRJN.js";
+import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {
   DEFAULT_ALIGN_CONFIG,

package/dist/schemas/index.js

@@ -13,7 +13,7 @@ import {
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "../chunk-XV4SF2N5.js";
+} from "../chunk-BUJ5RV2P.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
@@ -22,8 +22,10 @@ import {
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
+  DEFAULT_DOC_FONT,
   DEFAULT_THEME,
   DEFAULT_THEME_ID,
+  DEFAULT_TITLE_FONT,
   FONT_FALLBACKS,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
@@ -48,21 +50,32 @@ import {
   PAGE_SHADOWS,
   THEMES,
   THEME_SCHEMA_VERSION,
+  VIEWPORT_PRESETS,
   applySurface,
   assertTheme,
   buildGoogleFontsUrl,
+  calculateFontScale,
   contrastRatio,
+  createTemplateContext,
   createTheme,
   createThemeRegistry,
   deriveScale,
   fontStack,
+  getAspectRatioString,
   getAvailableThemes,
   getFontStack,
+  getLayoutHints,
+  getSafeTextBounds,
   getThemeSummaries,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
   guessFontFallback,
   hexHueDegrees,
   isCustomTemplateDefinition,
   isHex,
+  isPersistentLayerTemplate,
+  isTemplateBlock,
   matchFontFamily,
   oklchDarken,
   oklchLighten,
@@ -71,27 +84,12 @@ import {
   relativeLuminance,
   resolveFontFamily,
   resolveTheme,
+  scaledFontSize,
+  scaledFontSize2,
   validateCustomTemplateDefinition,
   validateTheme,
   withAlpha
-} from "../chunk-RXYKU6EX.js";
-import {
-  DEFAULT_DOC_FONT,
-  DEFAULT_TITLE_FONT,
-  VIEWPORT_PRESETS,
-  calculateFontScale,
-  createTemplateContext,
-  getAspectRatioString,
-  getLayoutHints,
-  getSafeTextBounds,
-  getTwoColumnPositions,
-  getViewport,
-  getViewportOrientation,
-  isPersistentLayerTemplate,
-  isTemplateBlock,
-  scaledFontSize,
-  scaledFontSize2
-} from "../chunk-BAOV476U.js";
+} from "../chunk-Y4D6TDZT.js";
 import {
   DEFAULT_TRANSITION_DURATION_SECONDS,
   TRANSITION_DIRECTIONS,

package/dist/timing/index.d.ts

@@ -1,3 +1,6 @@
+import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-BkxT7G80.js';
+import '../types-Be6sBUBx.js';
+
 /**
  * Narration timing estimation.
  *
@@ -105,4 +108,29 @@ interface NarrationTimeOptions {
  */
 declare function estimateNarrationTime(text: string, options?: NarrationTimeOptions): NarrationTimeEstimate;
 
-export { DEFAULT_WORDS_PER_SECOND, type NarrationTimeEstimate, type NarrationTimeOptions, type ReadingTimeEstimate, type ReadingTimeOptions, calculatePrefixDuration, countSpokenWords, estimateNarrationDuration, estimateNarrationTime, estimateReadingTime, estimateSpokenWordCount, estimateTimeFromText };
+/**
+ * Caption Track Construction
+ *
+ * Converts narration segment text and optional word/bookmark timing into the
+ * canonical Doc CaptionTrack. Hosts retain responsibility for mapping their
+ * domain model and timing sidecars into CaptionSegmentSource records.
+ */
+
+interface CaptionSegmentSource {
+    segment: AudioSegment;
+    text?: string | null;
+    spokenPrefix?: string;
+    timing?: AudioTimingData | null;
+}
+interface BuildCaptionTrackOptions {
+    version?: number;
+    generatedAt?: string;
+    targetWordsPerPhrase?: number;
+    minPhraseDuration?: number;
+    maxPhraseDuration?: number;
+    wordsPerSecond?: number;
+    closePhraseGaps?: boolean;
+}
+declare function buildCaptionTrack(sources: CaptionSegmentSource[], options?: BuildCaptionTrackOptions): CaptionTrack;
+
+export { type BuildCaptionTrackOptions, type CaptionSegmentSource, DEFAULT_WORDS_PER_SECOND, type NarrationTimeEstimate, type NarrationTimeOptions, type ReadingTimeEstimate, type ReadingTimeOptions, buildCaptionTrack, calculatePrefixDuration, countSpokenWords, estimateNarrationDuration, estimateNarrationTime, estimateReadingTime, estimateSpokenWordCount, estimateTimeFromText };

package/dist/timing/index.js

@@ -1,17 +1,19 @@
 import {
-  estimateNarrationTime,
-  estimateReadingTime
-} from "../chunk-XOFT65EX.js";
+  buildCaptionTrack
+} from "../chunk-44BJ42GT.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,
+  estimateNarrationTime,
+  estimateReadingTime,
   estimateSpokenWordCount,
   estimateTimeFromText
-} from "../chunk-67L6WRJN.js";
+} from "../chunk-GHOPHGOK.js";
 export {
   DEFAULT_WORDS_PER_SECOND,
+  buildCaptionTrack,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,

package/dist/transform/index.d.ts

@@ -1,4 +1,4 @@
-import { r as ColorScheme, O as Doc, k as Block } from '../Doc-BkxT7G80.js';
+import { O as Doc, r as ColorScheme, k as Block, bb as TemplateBlock } from '../Doc-BkxT7G80.js';
 import { i as PageTransformHints } from '../materializePageSection-Dp2aHFbc.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import '../types-Be6sBUBx.js';
@@ -145,6 +145,67 @@ interface TransformResult {
  */
 declare function applyTransform(doc: Doc, style: TransformStyleInput, options?: TransformOptions): TransformResult;
 
+/**
+ * Narrated Segment Transformation
+ *
+ * Converts a narrated text segment and its media into a timed Doc using the
+ * canonical squisq transform pipeline. This is the reusable bridge for hosts
+ * that generate one visual sequence per narration segment.
+ */
+
+interface NarratedSegmentVideo {
+    src: string;
+    posterSrc?: string;
+    alt?: string;
+    clipStart: number;
+    clipEnd: number;
+    sourceDuration?: number;
+    credit?: string;
+    license?: string;
+}
+interface NarratedSegmentInput {
+    articleId: string;
+    segmentId: string;
+    title: string;
+    text: string;
+    duration: number;
+    audioSrc: string;
+    audioName?: string;
+    images?: TransformImage[];
+    videos?: NarratedSegmentVideo[];
+    includeTitleBlock?: boolean;
+}
+interface NarratedSegmentTransformOptions extends Pick<TransformOptions, 'themeId' | 'registry'> {
+    style?: TransformStyleInput;
+    seed?: number;
+    minConfidence?: number;
+    slidesPerMinute?: number;
+}
+interface NarratedSegmentResult extends TransformResult {
+    seed: number;
+}
+declare function transformNarratedSegment(input: NarratedSegmentInput, options?: NarratedSegmentTransformOptions): NarratedSegmentResult;
+
+/**
+ * Timing Allocator
+ *
+ * Distributes timing (startTime, duration) across transformed blocks.
+ * When the source Doc has audio, blocks are fitted to the overall duration.
+ * When no audio is present, uses reading-time estimation.
+ */
+
+/**
+ * Allocate startTime and duration across a mixed array of blocks and
+ * template blocks. Template blocks get timing assigned; existing blocks
+ * retain their original timing when possible.
+ *
+ * @param blocks - The output from templateSelector (mixed Block | TemplateBlock).
+ * @param totalDuration - The Doc's total duration (from audio or estimation).
+ * @returns A new array of Blocks with consistent timing. Template blocks
+ *          are returned as Blocks (with startTime/duration set, layers empty).
+ */
+declare function allocateTiming(blocks: Array<Block | TemplateBlock>, totalDuration: number): Block[];
+
 /**
  * Transform Style Registry
  *
@@ -220,4 +281,4 @@ declare function extractDocImages(blocks: Block[]): TransformImage[];
  */
 declare function analyzeBlocks(blocks: Block[], options?: ExtractionOptions): AnalyzedBlock[];
 
-export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, analyzeBlocks, applyTransform, createTransformStyleRegistry, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, resolveTransformStyle };
+export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, type NarratedSegmentInput, type NarratedSegmentResult, type NarratedSegmentTransformOptions, type NarratedSegmentVideo, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, allocateTiming, analyzeBlocks, applyTransform, createTransformStyleRegistry, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, resolveTransformStyle, transformNarratedSegment };

package/dist/transform/index.js

@@ -1,25 +1,36 @@
 import {
   DEFAULT_TRANSFORM_STYLE_ID,
+  allocateTiming,
   analyzeBlocks,
   applyTransform,
   createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  resolveTransformStyle
-} from "../chunk-ZSU5DJLX.js";
-import "../chunk-NKNMGIIN.js";
-import "../chunk-BAOV476U.js";
+  resolveTransformStyle,
+  transformNarratedSegment
+} from "../chunk-J2IPSQKP.js";
+import "../chunk-SVN7T6BK.js";
+import "../chunk-WAGJK36Q.js";
+import "../chunk-PUS54YU6.js";
+import "../chunk-C3NAY5YP.js";
+import "../chunk-Y4D6TDZT.js";
+import "../chunk-CW24CH7I.js";
+import "../chunk-TMOHAFYE.js";
+import "../chunk-7N4G32LG.js";
 import "../chunk-X7BNDUNI.js";
-import "../chunk-67L6WRJN.js";
+import "../chunk-4VOD55SX.js";
+import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
+  allocateTiming,
   analyzeBlocks,
   applyTransform,
   createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  resolveTransformStyle
+  resolveTransformStyle,
+  transformNarratedSegment
 };

package/package.json

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