@bendyline/squisq 2.11.16 → 2.11.18

package/dist/mediaEdit/index.d.ts

@@ -1,5 +1,5 @@
-import { al as MediaCut, Q as Doc, aj as MediaClip, cv as MediaFxOpId, cw as MediaFxChain } from '../Doc-Bd2kdzuy.js';
-export { cx as MEDIA_EDIT_PARAMS, cy as MEDIA_FX_ORDER, cz as MEDIA_FX_SPECS, ak as MediaCrop, cA as MediaEditParamKey, cB as MediaEditParamValues, am as MediaEdits, cC as MediaFxOp, cD as formatMediaNumber, cE as hasRenderableFx, cF as mediaEditHtmlAttribute, cG as mediaEditValuesFromAttributes, cH as mediaEditValuesFromParams, cI as mediaRenderKey, cJ as normalizeMediaCrop, cK as normalizeMediaCuts, cL as parseMediaCrop, cM as parseMediaCuts, cN as parseMediaEdits, cO as parseMediaFx, cP as serializeMediaCrop, cQ as serializeMediaCuts, cR as serializeMediaEdits, cS as serializeMediaFx } from '../Doc-Bd2kdzuy.js';
+import { al as MediaCut, Q as Doc, aj as MediaClip, cw as MediaFxOpId, cx as MediaFxChain } from '../Doc-B6TYHYGc.js';
+export { cy as MEDIA_EDIT_PARAMS, cz as MEDIA_FX_ORDER, cA as MEDIA_FX_SPECS, ak as MediaCrop, cB as MediaEditParamKey, cC as MediaEditParamValues, am as MediaEdits, cD as MediaFxOp, cE as formatMediaNumber, cF as hasRenderableFx, cG as mediaEditHtmlAttribute, cH as mediaEditValuesFromAttributes, cI as mediaEditValuesFromParams, cJ as mediaRenderKey, cK as normalizeMediaCrop, cL as normalizeMediaCuts, cM as parseMediaCrop, cN as parseMediaCuts, cO as parseMediaEdits, cP as parseMediaFx, cQ as serializeMediaCrop, cR as serializeMediaCuts, cS as serializeMediaEdits, cT as serializeMediaFx } from '../Doc-B6TYHYGc.js';
 import '../types-C6VvDDL2.js';
 
 /**

package/dist/narration/index.d.ts

@@ -1,4 +1,4 @@
-import { Q as Doc, f as AudioBookmark } from '../Doc-Bd2kdzuy.js';
+import { Q as Doc, f as AudioBookmark } from '../Doc-B6TYHYGc.js';
 import '../types-C6VvDDL2.js';
 
 /**

package/dist/narration/index.js

@@ -27,26 +27,27 @@ import {
   recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "../chunk-IRVXZUVU.js";
+} from "../chunk-RYO4QW6R.js";
 import "../chunk-NEWNNLWN.js";
 import {
-  buildNarrationScript,
   buildNarrationTimingJson,
+  parseNarrationTimingJson,
+  resolveNarrationTimingGenerator
+} from "../chunk-3XEABCT3.js";
+import {
+  buildNarrationScript,
   estimateSyllables,
   expectedSyllablesAt,
-  parseNarrationTimingJson,
-  resolveNarrationTimingGenerator,
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-5W7F46OO.js";
-import "../chunk-WMXQDP2C.js";
-import "../chunk-C3NAY5YP.js";
+} from "../chunk-7IGKCHDP.js";
+import "../chunk-A5QJJZ5S.js";
 import "../chunk-PUS54YU6.js";
 import "../chunk-PFH3WV6J.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-TMOHAFYE.js";
-import "../chunk-X7BNDUNI.js";
+import "../chunk-WSFXV5BT.js";
+import "../chunk-Q6ELOAOQ.js";
 import "../chunk-4VOD55SX.js";
 import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";

package/dist/recommend/index.js

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

package/dist/schemas/index.d.ts

@@ -1,10 +1,10 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { Q as Doc, bw as Theme, bz as ThemePageStyle, by as ThemeColorScheme, K as DeepPartial, bC as ThemeSeedColors, bx as ThemeColorPalette, _ as FontFamilyKind, Z as FontFamily } from '../Doc-Bd2kdzuy.js';
-export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as BigTextInput, k as Block, l as BlockConnection, m as BorderStyle, C as CaptionPhrase, n as CaptionTrack, o as CaptionWord, p as ChartBaseFields, q as ChartTemplateInput, r as ColorScheme, s as ColumnChartInput, t as ComparisonBarInput, u as ContentBlockInput, v as CornerBrandingConfig, w as CountUpSpec, x as CreateTemplateContextOptions, y as CustomTemplateDefinition, z as CustomTemplateLayer, D as CustomTemplateValidationError, E as CustomTemplateValidationResult, F as DARK_SURFACE, G as DEFAULT_DOC_FONT, H as DEFAULT_TITLE_FONT, I as DataTableInput, J as DateEventInput, L as DefinitionCardInput, M as DiagramBlockInput, N as DiagramEdgeAnchor, O as DiagramTemplateEdge, P as DiagramTemplateNode, R as DocBlock, S as DocDiagnostic, T as DonutChartInput, U as DrawingBlockInput, V as FRONTMATTER_CUSTOM_TEMPLATES_KEY, W as FRONTMATTER_CUSTOM_THEMES_KEY, X as FRONTMATTER_MOTION_KEY, Y as FactCardInput, $ as FullBleedQuoteInput, a0 as GradientBackgroundConfig, a1 as ImageBackgroundConfig, a2 as ImageLayer, a3 as ImageTreatment, a4 as ImageWithCaptionInput, a5 as LIGHT_SURFACE, a6 as Layer, a7 as LayerRepeat, a8 as LayoutHints, a9 as LeftFeatureInput, aa as LineChartInput, ab as LinearGradient, ac as ListBlockInput, ad as MOTION_PROFILES, ae as MapBlockInput, af as MapLayer, ag as MapMarker, ah as MapTileStyle, ai as MarkerStyle, aj as MediaClip, ak as MediaCrop, al as MediaCut, am as MediaEdits, an as MediaScheduleOptions, ao as MermaidLayer, ap as MotionEntrance, aq as MotionOrigin, ar as MotionProfile, as as MotionProfileName, at as MotionSpec, au as MotionState, av as PAGE_ACCENT_STRATEGIES, aw as PAGE_BACKGROUNDS, ax as PAGE_BACKGROUND_RHYTHMS, ay as PAGE_DESIGN_FAMILIES, az as PAGE_DIVIDERS, aA as PAGE_EMPHASES, aB as PAGE_EYEBROWS, aC as PAGE_HEADING_CASES, aD as PAGE_HEADING_SCALES, aE as PAGE_HEADING_UNDERLINES, aF as PAGE_HERO_STYLES, aG as PAGE_IMAGE_FRAMINGS, aH as PAGE_NUMERAL_STYLES, aI as PAGE_PATTERNS, aJ as PAGE_QUOTE_MARKS, aK as PAGE_SECTION_KINDS, aL as PAGE_SECTION_SPACINGS, aM as PAGE_SHADOWS, aN as PAGE_VARIANTS, aO as PageAccentRotation, aP as PageBackground, aQ as PageDesignFamily, aR as PageEmphasis, aS as PageHeadingTreatment, aT as PageSectionKind, aU as PageSectionOverride, aV as PageTokens, aW as PageVariant, aX as PathLayer, aY as PatternBackgroundConfig, aZ as PersistentLayer, a_ as PersistentLayerConfig, a$ as PersistentLayerTemplate, b0 as PersistentLayerTemplateConfig, b1 as PersistentLayerTemplateType, b2 as PhotoGridInput, b3 as PieChartInput, b4 as PipStyle, b5 as Position, b6 as ProgressIndicatorConfig, b7 as PromotedBodyAnnotation, b8 as PullQuoteInput, b9 as QuoteBlockInput, ba as RawLayersInput, bb as RenderStyle, bc as RightFeatureInput, bd as ScatterChartInput, be as ScheduledClip, bf as SectionHeaderInput, bg as ShapeFilter, bh as ShapeLayer, bi as ShapePattern, bj as SolidBackgroundConfig, bk as StartBlockConfig, bl as StatHighlightInput, bm as SurfaceScheme, bn as THEME_SCHEMA_VERSION, bo as TableLayer, bp as TableLayerStyle, bq as TemplateBlock, br as TemplateContext, bs as TemplateFunction, bt as TemplateRegistry, bu as TextLayer, bv as TextStyle, bA as ThemeRegistry, bB as ThemeSchemaVersion, bD as ThemeStyle, bE as ThemeTypography, bF as TimelineBlockInput, bG as TimelineTemplateEvent, bH as TimelineTemplateLink, bI as TimelineTemplateTrack, bJ as TitleBlockInput, bK as TitleCaptionConfig, bL as TranscriptBlockInput, bM as TreeBlockInput, bN as TreeLayer, bO as TreeLayerItem, bP as TreeLayerStyle, bQ as TreeTemplateItem, bR as TwoColumnInput, bS as VIEWPORT_PRESETS, bT as VideoLayer, bU as VideoPipPosition, bV as VideoPipShape, bW as VideoPipSize, bX as VideoPlacement, bY as VideoPresentation, bZ as VideoPullQuoteInput, b_ as VideoWithCaptionInput, b$ as ViewportConfig, c0 as ViewportOrientation, c1 as ViewportPreset, c2 as VignetteConfig, c3 as applySurface, c4 as calculateDuration, c5 as calculateFontScale, c6 as createTemplateContext, c7 as createTheme, c8 as createThemeRegistry, c9 as getAspectRatioString, ca as getBlockAtTime, cb as getCaptionAtTime, cc as getDocPlaybackDuration, cd as getLayoutHints, ce as getSafeTextBounds, cf as getSegmentAtTime, cg as getTwoColumnPositions, ch as getViewport, ci as getViewportOrientation, cj as isCustomTemplateDefinition, ck as isMotionProfileName, cl as isPersistentLayerTemplate, cm as isTemplateBlock, cn as layoutScaledFontSize, co as readFrontmatterMotion, cp as resolveMediaSchedule, cq as resolveMotionForDoc, cr as resolveMotionProfile, cs as scaledFontSize, ct as scheduleMediaClip, cu as validateCustomTemplateDefinition } from '../Doc-Bd2kdzuy.js';
+import { Q as Doc, bw as Theme, bz as ThemePageStyle, by as ThemeColorScheme, K as DeepPartial, bC as ThemeSeedColors, bx as ThemeColorPalette, _ as FontFamilyKind, Z as FontFamily } from '../Doc-B6TYHYGc.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as BigTextInput, k as Block, l as BlockConnection, m as BorderStyle, C as CaptionPhrase, n as CaptionTrack, o as CaptionWord, p as ChartBaseFields, q as ChartTemplateInput, r as ColorScheme, s as ColumnChartInput, t as ComparisonBarInput, u as ContentBlockInput, v as CornerBrandingConfig, w as CountUpSpec, x as CreateTemplateContextOptions, y as CustomTemplateDefinition, z as CustomTemplateLayer, D as CustomTemplateValidationError, E as CustomTemplateValidationResult, F as DARK_SURFACE, G as DEFAULT_DOC_FONT, H as DEFAULT_TITLE_FONT, I as DataTableInput, J as DateEventInput, L as DefinitionCardInput, M as DiagramBlockInput, N as DiagramEdgeAnchor, O as DiagramTemplateEdge, P as DiagramTemplateNode, R as DocBlock, S as DocDiagnostic, T as DonutChartInput, U as DrawingBlockInput, V as FRONTMATTER_CUSTOM_TEMPLATES_KEY, W as FRONTMATTER_CUSTOM_THEMES_KEY, X as FRONTMATTER_MOTION_KEY, Y as FactCardInput, $ as FullBleedQuoteInput, a0 as GradientBackgroundConfig, a1 as ImageBackgroundConfig, a2 as ImageLayer, a3 as ImageTreatment, a4 as ImageWithCaptionInput, a5 as LIGHT_SURFACE, a6 as Layer, a7 as LayerRepeat, a8 as LayoutHints, a9 as LeftFeatureInput, aa as LineChartInput, ab as LinearGradient, ac as ListBlockInput, ad as MOTION_PROFILES, ae as MapBlockInput, af as MapLayer, ag as MapMarker, ah as MapTileStyle, ai as MarkerStyle, aj as MediaClip, ak as MediaCrop, al as MediaCut, am as MediaEdits, an as MediaScheduleOptions, ao as MermaidLayer, ap as MotionEntrance, aq as MotionOrigin, ar as MotionProfile, as as MotionProfileName, at as MotionSpec, au as MotionState, av as PAGE_ACCENT_STRATEGIES, aw as PAGE_BACKGROUNDS, ax as PAGE_BACKGROUND_RHYTHMS, ay as PAGE_DESIGN_FAMILIES, az as PAGE_DIVIDERS, aA as PAGE_EMPHASES, aB as PAGE_EYEBROWS, aC as PAGE_HEADING_CASES, aD as PAGE_HEADING_SCALES, aE as PAGE_HEADING_UNDERLINES, aF as PAGE_HERO_STYLES, aG as PAGE_IMAGE_FRAMINGS, aH as PAGE_NUMERAL_STYLES, aI as PAGE_PATTERNS, aJ as PAGE_QUOTE_MARKS, aK as PAGE_SECTION_KINDS, aL as PAGE_SECTION_SPACINGS, aM as PAGE_SHADOWS, aN as PAGE_VARIANTS, aO as PageAccentRotation, aP as PageBackground, aQ as PageDesignFamily, aR as PageEmphasis, aS as PageHeadingTreatment, aT as PageSectionKind, aU as PageSectionOverride, aV as PageTokens, aW as PageVariant, aX as PathLayer, aY as PatternBackgroundConfig, aZ as PersistentLayer, a_ as PersistentLayerConfig, a$ as PersistentLayerTemplate, b0 as PersistentLayerTemplateConfig, b1 as PersistentLayerTemplateType, b2 as PhotoGridInput, b3 as PieChartInput, b4 as PipStyle, b5 as Position, b6 as ProgressIndicatorConfig, b7 as PromotedBodyAnnotation, b8 as PullQuoteInput, b9 as QuoteBlockInput, ba as RawLayersInput, bb as RenderStyle, bc as RightFeatureInput, bd as ScatterChartInput, be as ScheduledClip, bf as SectionHeaderInput, bg as ShapeFilter, bh as ShapeLayer, bi as ShapePattern, bj as SolidBackgroundConfig, bk as StartBlockConfig, bl as StatHighlightInput, bm as SurfaceScheme, bn as THEME_SCHEMA_VERSION, bo as TableLayer, bp as TableLayerStyle, bq as TemplateBlock, br as TemplateContext, bs as TemplateFunction, bt as TemplateRegistry, bu as TextLayer, bv as TextStyle, bA as ThemeRegistry, bB as ThemeSchemaVersion, bD as ThemeStyle, bE as ThemeTypography, bF as TimelineBlockInput, bG as TimelineTemplateEvent, bH as TimelineTemplateLink, bI as TimelineTemplateTrack, bJ as TitleBlockInput, bK as TitleCaptionConfig, bL as TranscriptBlockInput, bM as TreeBlockInput, bN as TreeLayer, bO as TreeLayerItem, bP as TreeLayerStyle, bQ as TreeTemplateItem, bR as TwoColumnInput, bS as VIEWPORT_PRESETS, bT as VideoEmbedLayer, bU as VideoLayer, bV as VideoPipPosition, bW as VideoPipShape, bX as VideoPipSize, bY as VideoPlacement, bZ as VideoPresentation, b_ as VideoPullQuoteInput, b$ as VideoWithCaptionInput, c0 as ViewportConfig, c1 as ViewportOrientation, c2 as ViewportPreset, c3 as VignetteConfig, c4 as applySurface, c5 as calculateDuration, c6 as calculateFontScale, c7 as createTemplateContext, c8 as createTheme, c9 as createThemeRegistry, ca as getAspectRatioString, cb as getBlockAtTime, cc as getCaptionAtTime, cd as getDocPlaybackDuration, ce as getLayoutHints, cf as getSafeTextBounds, cg as getSegmentAtTime, ch as getTwoColumnPositions, ci as getViewport, cj as getViewportOrientation, ck as isCustomTemplateDefinition, cl as isMotionProfileName, cm as isPersistentLayerTemplate, cn as isTemplateBlock, co as layoutScaledFontSize, cp as readFrontmatterMotion, cq as resolveMediaSchedule, cr as resolveMotionForDoc, cs as resolveMotionProfile, ct as scaledFontSize, cu as scheduleMediaClip, cv as validateCustomTemplateDefinition } from '../Doc-B6TYHYGc.js';
 export { a as DEFAULT_TRANSITION_DURATION_SECONDS, a1 as TRANSITION_DIRECTIONS, a2 as TRANSITION_TYPES, a3 as Transition, a4 as TransitionDirection, a5 as TransitionType, a8 as isTransitionType, a9 as normalizeTransitionDirection, aa as normalizeTransitionType, ab as resolveBlockTransition, ad as resolveTransitionDuration } from '../types-C6VvDDL2.js';
-export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BbF3EKWM.js';
+export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-_46saKYO.js';
 export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-C3HOltpW.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-CN_3Ysj5.js';
 
 /**
  * Runtime validation for the canonical {@link Doc} JSON shape.

package/dist/schemas/index.js

@@ -13,7 +13,7 @@ import {
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "../chunk-HVJ6VFDX.js";
+} from "../chunk-GB7OFYUK.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,

package/dist/{themeLibrary-BbF3EKWM.d.ts → themeLibrary-_46saKYO.d.ts}

@@ -1,4 +1,4 @@
-import { bw as Theme, bA as ThemeRegistry } from './Doc-Bd2kdzuy.js';
+import { bw as Theme, bA as ThemeRegistry } from './Doc-B6TYHYGc.js';
 
 /**
  * Built-in Theme Library

package/dist/timing/index.d.ts

@@ -1,4 +1,4 @@
-import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-Bd2kdzuy.js';
+import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-B6TYHYGc.js';
 import '../types-C6VvDDL2.js';
 
 /**

package/dist/transform/index.d.ts

@@ -1,5 +1,5 @@
-import { Q as Doc, r as ColorScheme, k as Block, bq as TemplateBlock } from '../Doc-Bd2kdzuy.js';
-import { i as PageTransformHints } from '../materializePageSection-FRv9whYy.js';
+import { Q as Doc, r as ColorScheme, k as Block, bq as TemplateBlock } from '../Doc-B6TYHYGc.js';
+import { i as PageTransformHints } from '../materializePageSection-IYXU3tDN.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import '../types-C6VvDDL2.js';
 
@@ -24,7 +24,7 @@ interface TransformStyleConfig {
      * `brief` bounds prose and highlights; `headings-and-features` keeps only
      * headings and visual content in each heading's own scope.
      */
-    contentMode?: 'brief' | 'headings-and-features';
+    contentMode?: 'brief' | 'headings-and-features' | 'presentation';
     /**
      * Minimum confidence for extracted elements to become template blocks (0–1).
      * Higher values = fewer but higher-quality transformations.
@@ -321,4 +321,84 @@ declare function extractDocImages(blocks: Block[]): TransformImage[];
  */
 declare function analyzeBlocks(blocks: Block[], options?: ExtractionOptions): AnalyzedBlock[];
 
-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 };
+/** A bounded presentation is a visual overlay on the canonical spoken script.
+ * It lives in frontmatter so undo, copy, DBK, and ordinary Markdown saves carry
+ * it atomically. Layout choices never replace the source prose or store seconds.
+ */
+declare const PRESENTATION_KEY = "squisq-presentation";
+declare const PRESENTATION_LAYOUTS: readonly ["title", "statement", "list", "comparison", "steps", "image"];
+type PresentationLayout = (typeof PRESENTATION_LAYOUTS)[number];
+interface PresentationBeat {
+    id: string;
+    sourceStart: number;
+    sourceEnd: number;
+    layout: PresentationLayout;
+    headline: string;
+    points: string[];
+    imageSrc?: string;
+}
+interface PresentationPlan {
+    version: 1;
+    sourceText: string;
+    origin: 'automatic' | 'ai';
+    beats: PresentationBeat[];
+}
+declare const PRESENTATION_LIMITS: {
+    readonly sourceCharacters: 40000;
+    readonly beats: 80;
+    readonly serializedCharacters: 160000;
+};
+declare function parsePresentationPlan(input: unknown): PresentationPlan | null;
+declare function serializePresentationPlan(plan: PresentationPlan): string;
+
+/** Durable author intent. Generated slides and their source offsets are never saved here. */
+
+declare const PRESENTATION_HINTS_KEY = "squisq-presentation-hints";
+declare const DYNAMIC_PRESENTATION_STYLE = "dynamic-slides";
+interface PresentationBlockHint {
+    blockId: string;
+    layout?: PresentationLayout;
+    inbetweens?: boolean;
+    /** Optional AI-authored display text, keyed to the exact passage it summarizes. */
+    ai?: Array<{
+        source: string;
+        layout: PresentationLayout;
+        headline: string;
+        points: string[];
+    }>;
+    /** Explicit user wording, applied only while this section's source still matches. */
+    wording?: {
+        source: string;
+        headline?: string;
+        points?: string[];
+    };
+}
+interface PresentationHints {
+    version: 1;
+    density: 'concise' | 'balanced' | 'detailed';
+    inbetweens: boolean;
+    blocks: PresentationBlockHint[];
+}
+declare function defaultPresentationHints(): PresentationHints;
+declare function parsePresentationHints(input: unknown): PresentationHints | null;
+declare function serializePresentationHints(hints: PresentationHints): string;
+declare function presentationSections(doc: Doc): {
+    blockId: string;
+    heading: string | undefined;
+    sourceStart: number;
+    sourceEnd: number;
+    text: string;
+}[];
+declare function usesDynamicPresentation(doc: Doc): boolean;
+
+/** Uses the same narrated-segment extractor/template selection as Qualla.
+ * Canonical source passages provide the anchors; the visual suggestions are
+ * deliberately separate from the text that the person hears.
+ */
+
+declare function createPresentationPlan(doc: Doc, hints?: PresentationHints): PresentationPlan;
+
+declare function compilePresentationPlan(doc: Doc, plan: PresentationPlan): Doc;
+declare function applySavedPresentation(doc: Doc): Doc;
+
+export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, DYNAMIC_PRESENTATION_STYLE, type NarratedSegmentInput, type NarratedSegmentResult, type NarratedSegmentTransformOptions, type NarratedSegmentVideo, PRESENTATION_HINTS_KEY, PRESENTATION_KEY, PRESENTATION_LAYOUTS, PRESENTATION_LIMITS, type PresentationBeat, type PresentationBlockHint, type PresentationHints, type PresentationLayout, type PresentationPlan, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, allocateTiming, analyzeBlocks, applySavedPresentation, applyTransform, compilePresentationPlan, createPresentationPlan, createTransformStyleRegistry, defaultPresentationHints, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, parsePresentationHints, parsePresentationPlan, presentationSections, resolveTransformStyle, serializePresentationHints, serializePresentationPlan, transformNarratedSegment, usesDynamicPresentation };

package/dist/transform/index.js

@@ -1,37 +1,67 @@
 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-IFJPPI63.js";
+  serializePresentationHints,
+  serializePresentationPlan,
+  transformNarratedSegment,
+  usesDynamicPresentation
+} from "../chunk-NM747LUO.js";
+import "../chunk-7IGKCHDP.js";
+import "../chunk-A5QJJZ5S.js";
 import "../chunk-SVN7T6BK.js";
-import "../chunk-WMXQDP2C.js";
-import "../chunk-C3NAY5YP.js";
 import "../chunk-PUS54YU6.js";
 import "../chunk-PFH3WV6J.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-GDHXT5Q7.js";
-import "../chunk-TMOHAFYE.js";
-import "../chunk-X7BNDUNI.js";
+import "../chunk-PGWYC3S2.js";
+import "../chunk-WSFXV5BT.js";
+import "../chunk-Q6ELOAOQ.js";
 import "../chunk-7N4G32LG.js";
 import "../chunk-4VOD55SX.js";
 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.16",
+  "version": "2.11.18",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",

package/dist/chunk-5W7F46OO.js

@@ -1,337 +0,0 @@
-import {
-  flattenRenderableBlocks,
-  getBlockBodyText
-} from "./chunk-WMXQDP2C.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
-};