@bendyline/squisq 2.11.4 → 2.11.6

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "./chunk-4UNTPQ4J.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-NV7LNKS2.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-LI547QHN.js";
+} from "./chunk-WAGJK36Q.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -402,7 +413,7 @@ import {
   parseWrappedFlowTimeline,
   profileBlockContents,
   recommendTemplatesForBlock
-} from "./chunk-PJRVODWW.js";
+} from "./chunk-C3NAY5YP.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
@@ -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-4UNTPQ4J.js";
+} from "../chunk-UUI35INI.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -37,16 +37,15 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-LI547QHN.js";
+} from "../chunk-764WHWKM.js";
+import "../chunk-WAGJK36Q.js";
 import "../chunk-PUS54YU6.js";
-import "../chunk-PJRVODWW.js";
-import "../chunk-RXYKU6EX.js";
-import "../chunk-BAOV476U.js";
+import "../chunk-C3NAY5YP.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/proof/index.d.ts

@@ -1,47 +1,5 @@
-/**
- * Plain-data types for the proofing (grammar + spellcheck) pipeline.
- *
- * These types are engine-agnostic: an editor host adapts a concrete
- * engine (harper.js, a service, a test fake) to produce `ProofFinding`s,
- * while this module stays pure and dependency-free so the mapping and
- * masking helpers can run in Node tests and any consumer bundle.
- */
-/** Severity/color tier of a finding: red, green, or blue squiggle. */
-type ProofCategory = 'spelling' | 'grammar' | 'style';
-/** How a suggestion is applied relative to the finding's span. */
-type ProofSuggestionKind = 'replace' | 'remove' | 'insertAfter';
-/** One candidate fix for a finding. */
-interface ProofSuggestion {
-    /** Replacement/insertion text (empty for `remove`). */
-    text: string;
-    kind: ProofSuggestionKind;
-}
-/** A half-open `[start, end)` range in UTF-16 code units. */
-interface ProofRange {
-    start: number;
-    end: number;
-}
-/**
- * One issue found in a linted text. Offsets index into the exact string
- * that was linted (UTF-16 code units — the same coordinate space as
- * ProseMirror, Monaco, and DOM Range).
- */
-interface ProofFinding extends ProofRange {
-    /** Stable within one lint pass; the provider maps id → engine handle. */
-    id: string;
-    category: ProofCategory;
-    /** Raw engine kind (e.g. `Typo`), for diagnostics and future filtering. */
-    kind: string;
-    /** Human-readable description of the issue. */
-    message: string;
-    /** Text at `[start, end)` when linted — staleness check before applying. */
-    originalText: string;
-    suggestions: ProofSuggestion[];
-}
-/** English dialects supported by the proofing engine. */
-type ProofDialect = 'American' | 'British' | 'Australian' | 'Canadian' | 'Indian';
-/** All supported dialects, in display order. */
-declare const PROOF_DIALECTS: readonly ProofDialect[];
+import { a as ProofCategory, d as ProofRange, b as ProofDialect } from '../types-BQWu0gzi.js';
+export { P as PROOF_DIALECTS, c as ProofFinding, e as ProofSuggestion, f as ProofSuggestionKind } from '../types-BQWu0gzi.js';
 
 /**
  * Mapping from harper's `LintKind` vocabulary to squisq's three proofing
@@ -195,4 +153,4 @@ declare function formatProofDictionary(words: readonly string[]): string | null;
 /** Read all proofing settings from a parsed frontmatter record. */
 declare function readProofingSettings(frontmatter: Record<string, unknown> | undefined): ProofingSettings;
 
-export { type BlankProtectedSpansOptions, type BlankedText, DEFAULT_PROOF_SETTINGS, type JoinedSegments, LINT_KIND_CATEGORIES, PROOF_DIALECTS, PROOF_FRONTMATTER_KEYS, PROOF_JOIN_SEPARATOR, type ProofCategory, type ProofDialect, type ProofFinding, type ProofRange, type ProofSuggestion, type ProofSuggestionKind, type ProofingSettings, type SegmentSpan, blankProtectedSpans, buildJoinedText, categorizeLintKind, dropMaskedFindings, formatProofDictionary, mapJoinedSpanToSegment, parseProofDictionary, readProofingSettings, resolveProofDialect };
+export { type BlankProtectedSpansOptions, type BlankedText, DEFAULT_PROOF_SETTINGS, type JoinedSegments, LINT_KIND_CATEGORIES, PROOF_FRONTMATTER_KEYS, PROOF_JOIN_SEPARATOR, ProofCategory, ProofDialect, ProofRange, type ProofingSettings, type SegmentSpan, blankProtectedSpans, buildJoinedText, categorizeLintKind, dropMaskedFindings, formatProofDictionary, mapJoinedSpanToSegment, parseProofDictionary, readProofingSettings, resolveProofDialect };

package/dist/recommend/index.d.ts

@@ -20,6 +20,12 @@ interface BlockContentProfile {
     hasDate: boolean;
     hasNumberHighlight: boolean;
     wordCount: number;
+    /**
+     * True when a structural body node (list, table, quote, fence, etc.) has
+     * top-level siblings. Specialized templates generally consume only one
+     * structure; the complete-body template is the safe recommendation.
+     */
+    hasCompoundBody?: boolean;
     /**
      * True when the body is dominated by exactly one code fence whose content
      * is an ASCII box-and-line diagram (see `doc/asciiDiagram/detect.ts`).

package/dist/recommend/index.js

@@ -1,7 +1,7 @@
 import {
   profileBlockContents,
   recommendTemplatesForBlock
-} from "../chunk-PJRVODWW.js";
+} from "../chunk-C3NAY5YP.js";
 import "../chunk-X7BNDUNI.js";
 export {
   profileBlockContents,

package/dist/review/index.d.ts

@@ -0,0 +1,141 @@
+import { c as ProofFinding } from '../types-BQWu0gzi.js';
+
+/**
+ * Plain-data types for the review pipeline.
+ *
+ * Review generalizes proofing. Spellcheck asks "is this word wrong?"; a
+ * reviewer may also ask "is this paragraph clear?", and the two differ in three
+ * ways the {@link ProofFinding} shape cannot express: a reviewer is slow enough
+ * that results must stream and be cancellable, it needs document structure
+ * rather than one flat string, and its suggestion is often a rewritten
+ * paragraph rather than a replaced word.
+ *
+ * `@bendyline/squisq/proof` is untouched and keeps working. A
+ * {@link ProofingProvider} is adapted into this pipeline by the editor, so
+ * there is one renderer rather than two.
+ */
+
+/**
+ * How much a finding matters.
+ *
+ * Separate from the hue a provider draws in: severity orders findings within a
+ * provider, while the hue says which provider they came from. Conflating them
+ * is what makes a style hint and a spelling mistake indistinguishable.
+ */
+type ReviewSeverity = 'info' | 'suggestion' | 'warning' | 'error';
+/** How a suggestion is applied relative to the finding. */
+type ReviewSuggestionKind = 'replace' | 'remove' | 'insertAfter' | 'replaceBlock';
+interface ReviewSuggestion {
+    /** Replacement text. Empty for `remove`. */
+    text: string;
+    /**
+     * `replaceBlock` swaps the whole owning block rather than the finding's span.
+     * A model asked to improve a sentence rewrites the sentence; forcing that
+     * into a span replacement is what produces the mangled half-edits.
+     */
+    kind: ReviewSuggestionKind;
+    /** Button label, e.g. "Tighten". Falls back to a kind-derived default. */
+    label?: string;
+}
+/**
+ * One issue in a reviewed document.
+ *
+ * Offsets are UTF-16 code units into {@link ReviewRequest.source} — the same
+ * coordinate space as ProseMirror, Monaco and DOM Range.
+ */
+interface ReviewFinding {
+    /** Unique within one pass of one provider. */
+    id: string;
+    /**
+     * Which provider produced this. Namespaces decorations and groups the panel,
+     * so two providers can report the same span without colliding.
+     */
+    source: string;
+    start: number;
+    end: number;
+    /**
+     * The block this finding is about.
+     *
+     * Present even when the span is exact, because a span goes stale as soon as
+     * the user types while the block does not — a finding that can still be
+     * navigated to is worth more than one that can only be discarded.
+     */
+    blockKey?: number;
+    severity: ReviewSeverity;
+    /** Provider-defined grouping, e.g. `spelling` or `clarity`. */
+    category: string;
+    /** One sentence. Shown inline. */
+    message: string;
+    /** The longer "why", shown on expand. A linter rarely has one; a model does. */
+    rationale?: string;
+    /** Text at `[start, end)` when reviewed — the staleness check before applying. */
+    originalText: string;
+    suggestions: ReviewSuggestion[];
+}
+/** One block handed to a provider. */
+interface ReviewBlockInput {
+    /** Matches the editor's block key, so a finding can navigate back. */
+    key: number;
+    /** 1-based line where the block starts in `source`. */
+    startLine: number;
+    /** Nearest enclosing heading, for context. Null at the top of a document. */
+    heading: string | null;
+    /** Block text, with machine vocabulary already masked. */
+    text: string;
+    /** UTF-16 offset of `text` within {@link ReviewRequest.source}. */
+    offset: number;
+}
+/** Identifies the document under review. */
+interface ReviewDocumentRef {
+    articleId: string;
+    fileName?: string;
+}
+interface ReviewRequest {
+    /** The whole document, for a provider that wants surrounding context. */
+    source: string;
+    blocks: readonly ReviewBlockInput[];
+    /**
+     * Blocks changed since this provider's last pass, when the editor knows.
+     *
+     * A hint, not a restriction: a cheap provider may ignore it and re-scan
+     * everything, while an expensive one can review only what moved. Absent on
+     * a first pass.
+     */
+    changedBlockKeys?: readonly number[];
+    language?: 'plaintext' | 'markdown';
+    documentRef: ReviewDocumentRef;
+}
+/**
+ * Progress from one provider pass.
+ *
+ * `findings` is additive and may arrive many times: a reviewer that takes
+ * seconds per block should show its first result immediately rather than
+ * holding everything until the last block returns.
+ */
+type ReviewEvent = {
+    type: 'findings';
+    findings: readonly ReviewFinding[];
+} | {
+    type: 'progress';
+    blockKey: number;
+} | {
+    type: 'done';
+} | {
+    type: 'error';
+    message: string;
+};
+/** The provider id the editor adapts harper under. */
+declare const PROOFING_REVIEW_SOURCE = "harper";
+/**
+ * Adapt one proofing finding into a review finding.
+ *
+ * `offset` shifts engine-relative offsets into document coordinates, for a
+ * provider that linted a block or a joined run rather than the whole source.
+ */
+declare function proofFindingToReviewFinding(finding: ProofFinding, options?: {
+    source?: string;
+    offset?: number;
+    blockKey?: number;
+}): ReviewFinding;
+
+export { PROOFING_REVIEW_SOURCE, type ReviewBlockInput, type ReviewDocumentRef, type ReviewEvent, type ReviewFinding, type ReviewRequest, type ReviewSeverity, type ReviewSuggestion, type ReviewSuggestionKind, proofFindingToReviewFinding };

package/dist/review/index.js

@@ -0,0 +1,29 @@
+// src/review/types.ts
+var PROOF_SEVERITY = Object.freeze({
+  spelling: "error",
+  grammar: "warning",
+  style: "suggestion"
+});
+var PROOFING_REVIEW_SOURCE = "harper";
+function proofFindingToReviewFinding(finding, options = {}) {
+  const offset = options.offset ?? 0;
+  return {
+    id: finding.id,
+    source: options.source ?? PROOFING_REVIEW_SOURCE,
+    start: finding.start + offset,
+    end: finding.end + offset,
+    ...options.blockKey === void 0 ? {} : { blockKey: options.blockKey },
+    severity: PROOF_SEVERITY[finding.category],
+    category: finding.category,
+    message: finding.message,
+    originalText: finding.originalText,
+    suggestions: finding.suggestions.map((suggestion) => ({
+      text: suggestion.text,
+      kind: suggestion.kind
+    }))
+  };
+}
+export {
+  PROOFING_REVIEW_SOURCE,
+  proofFindingToReviewFinding
+};

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 };