@bendyline/squisq 2.13.11 → 2.13.13

package/dist/narration/index.js

@@ -31,7 +31,7 @@ import {
   traceWordPosAt,
   transcriptWordKeys,
   vadStep
-} from "../chunk-65WL5ILB.js";
+} from "../chunk-OIQ2GO2O.js";
 import "../chunk-NEWNNLWN.js";
 import {
   buildNarrationTimingJson,
@@ -45,12 +45,12 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-SKGMNBQX.js";
-import "../chunk-3WUI2N6C.js";
+} from "../chunk-CTT4XAGO.js";
+import "../chunk-SGNWO7OF.js";
 import "../chunk-FUBMT6SJ.js";
-import "../chunk-WNEH3BZP.js";
+import "../chunk-JNUNNQ74.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-DOOUVVOM.js";
+import "../chunk-7MS26OXD.js";
 import "../chunk-L3KSFLTP.js";
 import "../chunk-P53Z4RYC.js";
 import "../chunk-GHOPHGOK.js";

package/dist/recommend/index.js

@@ -1,7 +1,7 @@
 import {
   profileBlockContents,
   recommendTemplatesForBlock
-} from "../chunk-3WUI2N6C.js";
+} from "../chunk-SGNWO7OF.js";
 import "../chunk-L7QZORLB.js";
 import "../chunk-L3KSFLTP.js";
 import "../chunk-P53Z4RYC.js";

package/dist/schemas/index.d.ts

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

package/dist/{themeLibrary-CFJbeItn.d.ts → themeLibrary-BIYE6aLw.d.ts}

@@ -1,4 +1,4 @@
-import { bD as Theme, bH as ThemeRegistry } from './Doc-DqYt_b2b.js';
+import { bH as Theme, bL as ThemeRegistry } from './Doc-BhvotZx_.js';
 
 /**
  * Built-in Theme Library

package/dist/timing/index.d.ts

@@ -1,4 +1,4 @@
-import { g as AudioSegment, h as AudioTimingData, o as CaptionTrack } from '../Doc-DqYt_b2b.js';
+import { g as AudioSegment, h as AudioTimingData, o as CaptionTrack } from '../Doc-BhvotZx_.js';
 import '../types-Zk8qYuaT.js';
 
 /**
@@ -139,4 +139,60 @@ interface BuildCaptionTrackOptions {
 }
 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 };
+/**
+ * Word timings: when narration speaks a given place in its script.
+ *
+ * Narration that comes with word timings — TTS bookmarks, an aligned
+ * recording (`NarrationTimingJsonV3`), any `{ sourceText, bookmarks }` pair —
+ * lets a slide appear as its words are spoken instead of at an estimated
+ * moment. These helpers answer the two questions every caller asks: what time
+ * is it at this character of the script, and when does this phrase start?
+ *
+ * Two snapping rules, because callers place things differently:
+ * - `containing` (default) — the word being spoken at that character: the last
+ *   bookmark at or before it. A phrase that starts mid-word starts with that
+ *   word.
+ * - `next` — the first bookmark at or after it: the next word to be spoken.
+ *   A span with no word of its own collapses onto what follows.
+ * The two agree whenever a bookmark sits on the character, as word bookmarks
+ * do at the start of each word.
+ *
+ * Related: `narration/sidecar.ts` (the v3 timing file), `doc/builds.ts`
+ * (build steps timed to narration), `transform/conceptReveal.ts`.
+ */
+/** One timed place in a script: the word starting at `charOffset` is spoken at `time` seconds. */
+interface WordMark {
+    charOffset: number;
+    time: number;
+}
+/** A script and the times its words are spoken, bookmarks in script order. */
+interface WordTimeline {
+    sourceText: string;
+    bookmarks: readonly WordMark[];
+}
+type WordSnap = 'containing' | 'next';
+/**
+ * Seconds at which the narration reaches `offset`, or `undefined` when no
+ * bookmark answers (an empty timeline; with `next`, an offset past the last
+ * word). With `containing`, an offset before the first bookmark takes the
+ * first bookmark's time.
+ */
+declare function wordTimeAt(bookmarks: readonly WordMark[], offset: number, snap?: WordSnap): number | undefined;
+interface PhraseTimeOptions {
+    /** Script offset to search from (default 0, the first occurrence). */
+    from?: number;
+    /** Seconds to start ahead of the word, so a visual lands with it (default 0). */
+    lead?: number;
+    /** How a phrase that starts between bookmarks is placed (default `containing`). */
+    snap?: WordSnap;
+}
+/** Offset of `phrase` in the timeline's script at or after `from`, or -1. */
+declare function phraseOffset(timeline: WordTimeline, phrase: string, from?: number): number;
+/**
+ * Seconds at which `phrase` starts being spoken, `lead` seconds early and
+ * never before 0; `null` when the phrase is not in the script or no bookmark
+ * times it.
+ */
+declare function phraseStartTime(timeline: WordTimeline, phrase: string, options?: PhraseTimeOptions): number | null;
+
+export { type BuildCaptionTrackOptions, type CaptionSegmentSource, DEFAULT_WORDS_PER_SECOND, type NarrationTimeEstimate, type NarrationTimeOptions, type PhraseTimeOptions, type ReadingTimeEstimate, type ReadingTimeOptions, type WordMark, type WordSnap, type WordTimeline, buildCaptionTrack, calculatePrefixDuration, countSpokenWords, estimateNarrationDuration, estimateNarrationTime, estimateReadingTime, estimateSpokenWordCount, estimateTimeFromText, phraseOffset, phraseStartTime, wordTimeAt };

package/dist/timing/index.js

@@ -1,6 +1,11 @@
 import {
   buildCaptionTrack
 } from "../chunk-5HWYSUXS.js";
+import {
+  phraseOffset,
+  phraseStartTime,
+  wordTimeAt
+} from "../chunk-L4AFSOT3.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
@@ -20,5 +25,8 @@ export {
   estimateNarrationTime,
   estimateReadingTime,
   estimateSpokenWordCount,
-  estimateTimeFromText
+  estimateTimeFromText,
+  phraseOffset,
+  phraseStartTime,
+  wordTimeAt
 };

package/dist/transform/index.d.ts

@@ -1,5 +1,6 @@
-import { R as Doc, s as ColorScheme, k as Block, bu as TemplateBlock } from '../Doc-DqYt_b2b.js';
-import { i as PageTransformHints } from '../materializePageSection-S2hxZ_lO.js';
+import { T as Doc, t as ColorScheme, k as Block, by as TemplateBlock } from '../Doc-BhvotZx_.js';
+import { l as PageTransformHints, n as PresentationBeatLayout, o as PresentationLayout, p as PresentationPlan } from '../materializePageSection-CWxou4mX.js';
+export { A as AUTHORED_PRESENTATION_LAYOUT, P as PRESENTATION_KEY, b as PRESENTATION_LAYOUTS, c as PRESENTATION_LIMITS, m as PresentationBeat, s as parsePresentationPlan, t as presentationLayoutFits, u as presentationStat, w as serializePresentationPlan } from '../materializePageSection-CWxou4mX.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import { f as BuildSpec, M as MarkdownBlockNode } from '../types-Zk8qYuaT.js';
 
@@ -321,66 +322,6 @@ declare function extractDocImages(blocks: Block[]): TransformImage[];
  */
 declare function analyzeBlocks(blocks: Block[], options?: ExtractionOptions): AnalyzedBlock[];
 
-/** A prominent number found inside a short stat-like string. */
-interface NumberHighlightMatch {
-    value: string;
-    index: number;
-    end: number;
-}
-
-/** 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";
-/** The layouts a summary (a headline and up to four points) can fill. */
-declare const PRESENTATION_LAYOUTS: readonly ["title", "divider", "statement", "emphasis", "quote", "stat", "definition", "list", "comparison", "steps", "image"];
-type PresentationLayout = (typeof PRESENTATION_LAYOUTS)[number];
-/** Shows a section's own block, with the template its author chose, instead of
- * a summary. A section shown this way is one slide for its whole narration. */
-declare const AUTHORED_PRESENTATION_LAYOUT = "authored";
-type PresentationBeatLayout = PresentationLayout | typeof AUTHORED_PRESENTATION_LAYOUT;
-/** The prominent number a key-number slide shows, and the line that states it. */
-declare function presentationStat(headline: string, points: readonly string[]): {
-    match: NumberHighlightMatch;
-    line: string;
-    index: number;
-} | null;
-/** Whether a summary can fill a layout: enough points for a list, steps or a
- * comparison; a prominent number for a key number; a short headline for a big
- * statement; and, for a quote, a headline found word for word in
- * `passage`, the source text the slide summarizes. An image slide also needs a
- * picture, which callers check. */
-declare function presentationLayoutFits(layout: PresentationLayout, headline: string, points: readonly string[], passage: string): boolean;
-interface PresentationBeat {
-    id: string;
-    sourceStart: number;
-    sourceEnd: number;
-    layout: PresentationBeatLayout;
-    headline: string;
-    points: string[];
-    imageSrc?: string;
-    /** The section's videos and diagrams shown beside this slide's text (`presentationMedia`). */
-    media?: string[];
-    /** Left out of the deck; the slide shown before it stays on screen instead. */
-    hidden?: true;
-}
-interface PresentationPlan {
-    version: 1;
-    sourceText: string;
-    origin: 'automatic' | 'ai';
-    beats: PresentationBeat[];
-}
-declare const PRESENTATION_LIMITS: {
-    readonly sourceCharacters: 40000;
-    readonly beats: 80;
-    readonly serializedCharacters: 160000;
-    readonly mediaPerBeat: 4;
-};
-declare function parsePresentationPlan(input: unknown): PresentationPlan | null;
-declare function serializePresentationPlan(plan: PresentationPlan): string;
-
 declare const PRESENTATION_HINTS_KEY = "squisq-presentation-hints";
 declare const DYNAMIC_PRESENTATION_STYLE = "dynamic-slides";
 /** A short, stable name for one slide's exact source passage. Saving it rather
@@ -439,22 +380,182 @@ declare function createPresentationPlan(doc: Doc, hints?: PresentationHints): Pr
 declare function compilePresentationPlan(doc: Doc, plan: PresentationPlan): Doc;
 declare function applySavedPresentation(doc: Doc): Doc;
 
-/** The videos and diagrams a narrated section embeds, which dynamic slides show
- * beside its summaries. Images keep their own full-bleed slides; these are the
- * visuals rich-media layout places next to slide text (`appendRichContentLayers`).
+/** The features a narrated section embeds (videos, diagrams, tables and
+ * pictures), which dynamic slides show beside its summaries: the visuals
+ * rich-media layout places next to slide text (`appendRichContentLayers`).
+ * A picture usually has its own full-bleed slide; it rides beside the text
+ * only when no slide shows it that way.
  */
 
 interface PresentationMediaItem {
-    /** `<section block id>#<index>`, stable while the section's visuals are unchanged. */
+    /** `<section block id>#<index>` for videos and diagrams, `#table-<index>` and
+     * `#image-<index>` for tables and pictures; stable while the section's
+     * visuals are unchanged. */
     ref: string;
-    kind: 'video' | 'diagram';
-    /** The body node exactly as authored; slides render it through rich-media layout. */
+    kind: 'video' | 'diagram' | 'table' | 'image';
+    /** The body node exactly as authored (a picture gets a paragraph of its
+     * own); slides render it through rich-media layout. */
     node: MarkdownBlockNode;
-    /** A diagram, or an HTML video that can resume mid-clip on a following slide. */
+    /** A diagram, table, picture, or an HTML video that can resume mid-clip on a
+     * following slide. */
     continuous: boolean;
+    /** A picture's source, matched against the slides that show it full-bleed. */
+    src?: string;
 }
-/** Each section's visuals in source order, claimed like images: a nested
- * block's visuals belong to the nearest narrated section at or before it. */
+/** Each section's visuals in source order (a block's pictures after its other
+ * visuals), claimed like images: a nested block's visuals belong to the
+ * nearest narrated section at or before it. */
 declare function collectPresentationMedia(doc: Doc, sectionIds: string[]): Map<string, PresentationMediaItem[]>;
 
-export { AUTHORED_PRESENTATION_LAYOUT, 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 PresentationBeatLayout, type PresentationBlockHint, type PresentationHints, type PresentationLayout, type PresentationMediaItem, type PresentationPlan, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, allocateTiming, analyzeBlocks, applySavedPresentation, applyTransform, collectPresentationMedia, compilePresentationPlan, createPresentationPlan, createTransformStyleRegistry, defaultPresentationHints, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, parsePresentationHints, parsePresentationPlan, presentationLayoutFits, presentationPassageKey, presentationSections, presentationStat, resolveTransformStyle, serializePresentationHints, serializePresentationPlan, transformNarratedSegment, usesDynamicPresentation };
+/**
+ * Grounding checks: does what an author put on a slide come from the source
+ * it illustrates?
+ *
+ * An AI author (a deck refiner, a video director) rewords and arranges; it must
+ * never add a fact. These pure checks are the gate its output passes before a
+ * slide ships, shared so every product holds generated slides to the same
+ * standard:
+ *
+ * - {@link ungroundedNumber}: every number shown is one the source states,
+ *   in digits or words (commas ignored, so "1400" matches "1,400" and "10"
+ *   matches "ten").
+ * - {@link isVerbatimQuote}: a quotation is the source's own words.
+ * - {@link isGroundedParaphrase}: a short label or point may trim and reorder,
+ *   but its numbers and most of its distinctive words come from the source.
+ * - {@link restatesHeadline}: a point that only repeats its headline.
+ * - {@link rangeEndOnly}: a number the source gives only as one end of a range
+ *   ("3 to 7 miles deep"). Shown as a single value — a count-up, one bar — it
+ *   misstates the source, though the number itself appears there.
+ *
+ * Checks report; callers decide what to drop. None of them can tell whether
+ * a slide is good, only whether it is faithful.
+ *
+ * Related: `doc/templates/authoringGuide.ts` (what authors are told),
+ * `transform/conceptReveal.ts` (matching points to the sentences that say them).
+ */
+/**
+ * Lowercased text with typographic quotes and dashes folded and other
+ * punctuation spaced out; apostrophes, percent signs and hyphens survive.
+ */
+declare function normalizeGroundingText(text: string): string;
+/** The numbers a value shows, commas dropped: "1,500 to 2,500 feet" → ["1500", "2500"]. */
+declare function numbersIn(value: string | number): string[];
+/**
+ * Numbers a source spells out, two to ninety-nine ("ten peaks", "twenty-five
+ * years"), with where each starts. "One" is left out: it is more often a
+ * pronoun than a count.
+ */
+declare function spelledNumbers(source: string): Array<{
+    value: string;
+    index: number;
+}>;
+/** Every number a source states, in digits or spelled out, for repeated lookups. */
+declare function sourceNumbers(source: string): Set<string>;
+/**
+ * The first number among `values` that the source does not state, or
+ * `undefined` when every one is grounded.
+ */
+declare function ungroundedNumber(values: string | number | ReadonlyArray<string | number>, source: string | ReadonlySet<string>): string | undefined;
+/** Sentences of a text, split after ., ! or ? and at line breaks. */
+declare function groundingSentences(text: string): string[];
+interface VerbatimQuoteOptions {
+    /** The source's sentences, when the caller splits them its own way. */
+    sentences?: readonly string[];
+    /** Share of the quote's words one sentence must hold (default 0.9). */
+    minShare?: number;
+}
+/**
+ * Whether `quote` is the source's own words: a span of the source once both
+ * are normalized, or a sentence of it holding nearly all of the quote's words
+ * (a dropped comma or a trimmed clause still passes; a paraphrase does not).
+ */
+declare function isVerbatimQuote(quote: string, source: string, options?: VerbatimQuoteOptions): boolean;
+/**
+ * Distinctive words of a text — four letters or longer and not a common
+ * word — by their first four letters, so "writing" matches "write" and a
+ * possessive matches its noun.
+ */
+declare function distinctiveStems(text: string): string[];
+interface ParaphraseOptions {
+    /** Share of the text's distinctive words the source must use (default ⅔). */
+    minShare?: number;
+}
+/**
+ * Whether a short paraphrase (a label, a point, a list item) is grounded:
+ * every number it shows is stated in the source, and at least `minShare` of
+ * its distinctive words come from the source. A text with no distinctive
+ * words ("Then", "By 1900") passes on its numbers alone.
+ */
+declare function isGroundedParaphrase(text: string, source: string, options?: ParaphraseOptions): boolean;
+/**
+ * Whether a point mostly repeats its headline (most of its words are the
+ * headline's) or merely continues it (it holds every word of a headline of
+ * three or more), so it adds nothing to the slide.
+ */
+declare function restatesHeadline(point: string, headline: string): boolean;
+/** A range a source states, such as "3 to 7", "1,500–2,500" or "between 10 and 12". */
+interface StatedRange {
+    /** The lower end as written, commas dropped. */
+    low: string;
+    /** The upper end as written, commas dropped. */
+    high: string;
+    /** The range as it appears in the source. */
+    text: string;
+    /** Where it starts in the source. */
+    index: number;
+}
+/** Every range the source states, in order. */
+declare function statedRanges(source: string): StatedRange[];
+/**
+ * When every place the source states `value` is one end of a range, the
+ * first such range; otherwise `undefined`. Use it on numbers a slide shows
+ * as one value — a count-up, a single bar, a comparison — where "3 to 7 miles
+ * deep" drawn as 7 says something the source does not. Dates are ranges of
+ * a different kind ("1939–1945" names two years); don't check them here.
+ */
+declare function rangeEndOnly(value: string | number, source: string): StatedRange | undefined;
+
+/**
+ * Concept reveals: a concept slide (`cards`, `process`, `cycle`, `layers`)
+ * that shows its ideas one at a time, each as the narration reaches it.
+ *
+ * Two steps, so any host with narration can use them: find where in the
+ * script each idea is spoken ({@link matchPointsToSentences}), then turn
+ * those moments into the slide's build ({@link conceptRevealTiming}). The
+ * presentation compiler does both from a plan; a host with its own script
+ * format (a video director's beats) can time ideas by phrase instead and use
+ * only the second step.
+ *
+ * The build's `sourceText` guard is named from the same step texts the
+ * template draws (`conceptBuildStepTexts`), so the renderer accepts the
+ * timing without drawing the block first; ideas the narration cannot place
+ * reveal evenly over the slide instead.
+ *
+ * Related: `doc/templates/conceptBlocks.ts`, `doc/builds.ts`
+ * (`resolveBuildTimeline`), `transform/presentationCompiler.ts`.
+ */
+
+declare const CONCEPT_TEMPLATES: readonly ["cards", "process", "cycle", "layers"];
+type ConceptTemplate = (typeof CONCEPT_TEMPLATES)[number];
+/** The concept template a name denotes, or `undefined`. */
+declare function conceptTemplate(template: string): ConceptTemplate | undefined;
+/**
+ * Where in `sourceText[start, end)` each point is spoken: the offset of the
+ * sentence it shares the most words with (at least two). Points must land
+ * in order (two may share a sentence); `undefined` when one cannot be placed
+ * or would land before the point ahead of it.
+ */
+declare function matchPointsToSentences(points: readonly string[], sourceText: string, start: number, end: number): number[] | undefined;
+/** How a concept slide reveals its ideas unless its author says otherwise. */
+declare function conceptBuildSpec(): BuildSpec;
+/**
+ * A concept slide's build: its ideas appear at `itemTimes` (seconds on the
+ * same clock as `start` and `end`, the slide's span). Each reveal waits for a
+ * short lead into the slide and lands before its end; the first idea lands
+ * as the headline settles even when its words come later, so the slide never
+ * sits on its headline alone. Without one time per idea, the build reveals
+ * the ideas evenly.
+ */
+declare function conceptRevealTiming(template: ConceptTemplate, items: readonly string[], itemTimes: readonly number[] | undefined, start: number, end: number): Pick<Block, 'build' | 'buildTiming'>;
+
+export { type AnalyzedBlock, type BlockImage, CONCEPT_TEMPLATES, type ConceptTemplate, DEFAULT_TRANSFORM_STYLE_ID, DYNAMIC_PRESENTATION_STYLE, type NarratedSegmentInput, type NarratedSegmentResult, type NarratedSegmentTransformOptions, type NarratedSegmentVideo, PRESENTATION_HINTS_KEY, type ParaphraseOptions, PresentationBeatLayout, type PresentationBlockHint, type PresentationHints, PresentationLayout, type PresentationMediaItem, PresentationPlan, type StatedRange, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, type VerbatimQuoteOptions, allocateTiming, analyzeBlocks, applySavedPresentation, applyTransform, collectPresentationMedia, compilePresentationPlan, conceptBuildSpec, conceptRevealTiming, conceptTemplate, createPresentationPlan, createTransformStyleRegistry, defaultPresentationHints, distinctiveStems, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, groundingSentences, isGroundedParaphrase, isVerbatimQuote, matchPointsToSentences, normalizeGroundingText, numbersIn, parsePresentationHints, presentationPassageKey, presentationSections, rangeEndOnly, resolveTransformStyle, restatesHeadline, serializePresentationHints, sourceNumbers, spelledNumbers, statedRanges, transformNarratedSegment, ungroundedNumber, usesDynamicPresentation };

package/dist/transform/index.js

@@ -1,5 +1,20 @@
+import {
+  distinctiveStems,
+  groundingSentences,
+  isGroundedParaphrase,
+  isVerbatimQuote,
+  normalizeGroundingText,
+  numbersIn,
+  rangeEndOnly,
+  restatesHeadline,
+  sourceNumbers,
+  spelledNumbers,
+  statedRanges,
+  ungroundedNumber
+} from "../chunk-FCB6JLWB.js";
 import {
   AUTHORED_PRESENTATION_LAYOUT,
+  CONCEPT_TEMPLATES,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
@@ -12,12 +27,16 @@ import {
   applyTransform,
   collectPresentationMedia,
   compilePresentationPlan,
+  conceptBuildSpec,
+  conceptRevealTiming,
+  conceptTemplate,
   createPresentationPlan,
   createTransformStyleRegistry,
   defaultPresentationHints,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  matchPointsToSentences,
   parsePresentationHints,
   parsePresentationPlan,
   presentationLayoutFits,
@@ -29,22 +48,24 @@ import {
   serializePresentationPlan,
   transformNarratedSegment,
   usesDynamicPresentation
-} from "../chunk-N7I6JP6Q.js";
-import "../chunk-SKGMNBQX.js";
-import "../chunk-3WUI2N6C.js";
+} from "../chunk-YQQWE4HG.js";
+import "../chunk-CTT4XAGO.js";
+import "../chunk-SGNWO7OF.js";
 import "../chunk-SVN7T6BK.js";
 import "../chunk-FUBMT6SJ.js";
-import "../chunk-WNEH3BZP.js";
+import "../chunk-JNUNNQ74.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-XDOSE5M3.js";
-import "../chunk-DOOUVVOM.js";
+import "../chunk-C4SB3NN4.js";
+import "../chunk-7MS26OXD.js";
 import "../chunk-L3KSFLTP.js";
 import "../chunk-CZ7AUSLI.js";
 import "../chunk-P53Z4RYC.js";
+import "../chunk-L4AFSOT3.js";
 import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {
   AUTHORED_PRESENTATION_LAYOUT,
+  CONCEPT_TEMPLATES,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
@@ -57,21 +78,37 @@ export {
   applyTransform,
   collectPresentationMedia,
   compilePresentationPlan,
+  conceptBuildSpec,
+  conceptRevealTiming,
+  conceptTemplate,
   createPresentationPlan,
   createTransformStyleRegistry,
   defaultPresentationHints,
+  distinctiveStems,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  groundingSentences,
+  isGroundedParaphrase,
+  isVerbatimQuote,
+  matchPointsToSentences,
+  normalizeGroundingText,
+  numbersIn,
   parsePresentationHints,
   parsePresentationPlan,
   presentationLayoutFits,
   presentationPassageKey,
   presentationSections,
   presentationStat,
+  rangeEndOnly,
   resolveTransformStyle,
+  restatesHeadline,
   serializePresentationHints,
   serializePresentationPlan,
+  sourceNumbers,
+  spelledNumbers,
+  statedRanges,
   transformNarratedSegment,
+  ungroundedNumber,
   usesDynamicPresentation
 };

package/package.json

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