@bendyline/squisq 2.13.12 → 2.13.14

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   traceWordPosAt,
   transcriptWordKeys,
   vadStep
-} from "./chunk-CQSCYJQU.js";
+} from "./chunk-OIQ2GO2O.js";
 import {
   fenceRendererLangs
 } from "./chunk-PGI7HSWE.js";
@@ -58,6 +58,20 @@ import {
   selectSafeZoneClips,
   selectTranscriptClips
 } from "./chunk-ZP5F7LUH.js";
+import {
+  distinctiveStems,
+  groundingSentences,
+  isGroundedParaphrase,
+  isVerbatimQuote,
+  normalizeGroundingText,
+  numbersIn,
+  rangeEndOnly,
+  restatesHeadline,
+  sourceNumbers,
+  spelledNumbers,
+  statedRanges,
+  ungroundedNumber
+} from "./chunk-FCB6JLWB.js";
 import {
   DATA_BACKUP_PREFIX,
   DocumentVersionManager,
@@ -182,6 +196,7 @@ import {
   buildPreviewDoc,
   chooseDashboardLayout,
   composeDashboardLayers,
+  coverRepeatsLeadingBlock,
   cssFilterForTreatment,
   dashboardCanvasFill,
   dashboardCellAccent,
@@ -235,7 +250,7 @@ import {
   validateMarkdownSource,
   wordRevealDelay,
   writeDashboardLayoutsToFrontmatter
-} from "./chunk-IFZZI4XY.js";
+} from "./chunk-J2G6EOEJ.js";
 import {
   buildNarrationTimingJson,
   parseNarrationTimingJson,
@@ -243,6 +258,7 @@ import {
 } from "./chunk-HKHOFTGM.js";
 import {
   AUTHORED_PRESENTATION_LAYOUT,
+  CONCEPT_TEMPLATES,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
@@ -255,12 +271,16 @@ import {
   applyTransform,
   collectPresentationMedia,
   compilePresentationPlan,
+  conceptBuildSpec,
+  conceptRevealTiming,
+  conceptTemplate,
   createPresentationPlan,
   createTransformStyleRegistry,
   defaultPresentationHints,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
+  matchPointsToSentences,
   parsePresentationHints,
   parsePresentationPlan,
   presentationLayoutFits,
@@ -272,8 +292,9 @@ import {
   serializePresentationPlan,
   transformNarratedSegment,
   usesDynamicPresentation
-} from "./chunk-OUSEEUEC.js";
+} from "./chunk-YQQWE4HG.js";
 import {
+  AUTHORING_TRICKS,
   BASE_INPUT_DESCRIPTORS,
   BLOCK_MEDIA_LAYOUT_POLICIES,
   DEFAULT_LAYOUT,
@@ -282,13 +303,16 @@ import {
   DIAGRAM_LABEL_MIN_FONT_SIZE,
   DIAGRAM_LABEL_VERTICAL_PADDING,
   GEOMETRY_BOUND_TEMPLATES,
+  PRESENTATION_LAYOUT_GUIDE,
   SHAPE_NAMES,
   TEMPLATE_AUTHORING_METADATA,
+  TEMPLATE_GUIDES,
   TEMPLATE_INPUT_DESCRIPTORS,
   TEMPLATE_METADATA,
   accentForViewport,
   adjustY,
   applyRenderStyleToLayers,
+  authoringTricks,
   bigText,
   blockBuildSteps,
   bottomFeature,
@@ -345,6 +369,7 @@ import {
   getPinnedBlockMeta,
   getTemplateHint,
   getThemeFont,
+  guideText,
   hasBlockBuilds,
   hasTemplate,
   imageWithCaption,
@@ -385,6 +410,7 @@ import {
   shouldUseShadow,
   splitConceptItem,
   statHighlight,
+  templateCatalog,
   templateRegistry,
   themeWantsAmbientMotion,
   themedEntrance,
@@ -405,7 +431,7 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-QJQQO3K4.js";
+} from "./chunk-CTT4XAGO.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -704,6 +730,11 @@ import {
 import {
   buildCaptionTrack
 } from "./chunk-5HWYSUXS.js";
+import {
+  phraseOffset,
+  phraseStartTime,
+  wordTimeAt
+} from "./chunk-L4AFSOT3.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
@@ -724,6 +755,7 @@ export {
   ASCII_DIAGRAM_FENCE_LANGS,
   ASCII_TIMELINE_FENCE_LANGS,
   AUTHORED_PRESENTATION_LAYOUT,
+  AUTHORING_TRICKS,
   AVAILABLE_FONT_STACKS,
   BASE_INPUT_DESCRIPTORS,
   BLOCK_MEDIA_LAYOUT_POLICIES,
@@ -733,6 +765,7 @@ export {
   BUILD_PARAM_KEYS,
   BUILD_PREVIOUS,
   BUILTIN_DASHBOARD_LAYOUTS,
+  CONCEPT_TEMPLATES,
   CONTAINER_TEMPLATES,
   COVER_SLIDE_FRONTMATTER_KEYS,
   COVER_SLIDE_TEMPLATE_OPTIONS,
@@ -823,6 +856,7 @@ export {
   PRESENTATION_HINTS_KEY,
   PRESENTATION_KEY,
   PRESENTATION_LAYOUTS,
+  PRESENTATION_LAYOUT_GUIDE,
   PRESENTATION_LIMITS,
   PROOF_DIALECTS,
   PROOF_FRONTMATTER_KEYS,
@@ -835,6 +869,7 @@ export {
   SeededRandom,
   TABLE_FED_TEMPLATES,
   TEMPLATE_AUTHORING_METADATA,
+  TEMPLATE_GUIDES,
   TEMPLATE_INPUT_DESCRIPTORS,
   TEMPLATE_METADATA,
   THEMES,
@@ -875,6 +910,7 @@ export {
   assertMarkdownDocumentWithinLimits,
   assertMarkdownSourceWithinLimits,
   assertTheme,
+  authoringTricks,
   autoTemplatePreservesContent,
   bandpassRun,
   bigText,
@@ -928,7 +964,10 @@ export {
   computeDiagramLayout,
   computeDrawingLayout,
   computeLayoutLayers,
+  conceptBuildSpec,
   conceptBuildStepTexts,
+  conceptRevealTiming,
+  conceptTemplate,
   condenseMarkdownSource,
   connectorPath,
   contentBlock,
@@ -938,6 +977,7 @@ export {
   countSpokenWords,
   countUpSpecFor,
   coverBlock,
+  coverRepeatsLeadingBlock,
   createAccentLayers,
   createBandpass,
   createDocument,
@@ -976,6 +1016,7 @@ export {
   detectSyllableOnsets,
   detectTree,
   diagramBlock,
+  distinctiveStems,
   docToMarkdown,
   documentTitleFromFileName,
   downsampleTrace,
@@ -1077,7 +1118,9 @@ export {
   getTwoColumnPositions,
   getViewport,
   getViewportOrientation,
+  groundingSentences,
   guessFontFallback,
+  guideText,
   hasBlockBuilds,
   hasIconMarker,
   hasTemplate,
@@ -1105,6 +1148,7 @@ export {
   isExplicitTimelineLang,
   isExplicitTreeLang,
   isGeometryBoundTemplate,
+  isGroundedParaphrase,
   isHex,
   isHtmlLineBreak,
   isMaterializedMediaNode,
@@ -1124,6 +1168,7 @@ export {
   isTemplatedPageBlock,
   isTransitionType,
   isTreeFence,
+  isVerbatimQuote,
   isVideoEmbedUrl,
   isWrappedFlowTimelineSource,
   layersBlock,
@@ -1146,6 +1191,7 @@ export {
   markerPath,
   matchByKeywordAffinity,
   matchFontFamily,
+  matchPointsToSentences,
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
   materializeBlockLayers,
@@ -1165,10 +1211,12 @@ export {
   normalizeChartTable,
   normalizeDashboardZoom,
   normalizeDocfxMarkdown,
+  normalizeGroundingText,
   normalizeShapeKind,
   normalizeTransitionDirection,
   normalizeTransitionType,
   nucleiStep,
+  numbersIn,
   oklchDarken,
   oklchLighten,
   oklchSetChroma,
@@ -1203,6 +1251,8 @@ export {
   parseWrappedFlowTimeline,
   parseYamlSubset,
   photoGrid,
+  phraseOffset,
+  phraseStartTime,
   pickContrastingText,
   pipStyleVars,
   plainTextFromInlineHtml,
@@ -1221,6 +1271,7 @@ export {
   pullQuote,
   quoteAttrValue,
   quoteBlock,
+  rangeEndOnly,
   readCustomTemplatesFromFrontmatter,
   readCustomThemesFromFrontmatter,
   readDashboardLayoutsFromFrontmatter,
@@ -1279,6 +1330,7 @@ export {
   resolveTransformStyle,
   resolveTransitionDuration,
   resolveWikiLinks,
+  restatesHeadline,
   revertToImageEditVersion,
   revertToVersion,
   rewriteMarkdownReferences,
@@ -1308,11 +1360,14 @@ export {
   shouldUseShadow,
   snapEndpoints,
   snapPoints,
+  sourceNumbers,
+  spelledNumbers,
   splitConceptItem,
   splitFrontmatterBlock,
   splitIconMarkers,
   splitKeyValueToken,
   statHighlight,
+  statedRanges,
   stringifyHtmlNodes,
   stringifyMarkdown,
   stripBlockBackdropLayer,
@@ -1324,6 +1379,7 @@ export {
   svgIslandMarkup,
   svgSourceFromBytes,
   svgSourceFromDataUrl,
+  templateCatalog,
   templateRegistry,
   themeWantsAmbientMotion,
   themedEntrance,
@@ -1348,6 +1404,7 @@ export {
   treeFromTemplateData,
   treeToTemplateData,
   twoColumn,
+  ungroundedNumber,
   unquoteAttrValue,
   unwrapMarkdownSource,
   updateLayer,
@@ -1370,6 +1427,7 @@ export {
   wordIndexAtTime,
   wordPosAtExpectedSyllables,
   wordRevealDelay,
+  wordTimeAt,
   wrapMarkdownSource,
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,

package/dist/{materializePageSection-bLfqIy6j.d.ts → materializePageSection-CWxou4mX.d.ts}

@@ -1,6 +1,66 @@
 import { k as Block, aY as PageSectionKind, aW as PageEmphasis, bJ as ThemeColorScheme, aU as PageBackground, bH as Theme, cc as ViewportConfig, D as CustomTemplateDefinition, a$ as PageVariant, br as StartBlockConfig, T as Doc, bK as ThemePageStyle } from './Doc-BhvotZx_.js';
 import { M as MarkdownBlockNode } from './types-Zk8qYuaT.js';
 
+/** 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", "cards", "process", "cycle", "layers"];
+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,
+ * cards, a process, a cycle (three) 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;
+
 /**
  * PageSection — the framework-agnostic block model for Page (linear) mode.
  *
@@ -240,4 +300,4 @@ declare function materializePageSection(block: Block, options?: MaterializePageS
  */
 declare function materializePageSections(doc: Doc, options?: MaterializePageSectionsOptions): PageSectionMaterialization[];
 
-export { type MaterializePageSectionOptions as M, type PageMedia as P, type MaterializePageSectionsOptions as a, type PageRichText as b, type PageSection as c, type PageSectionDiagnostic as d, type PageSectionItem as e, type PageSectionMaterialization as f, type PageSectionSource as g, type PageSpatialKind as h, type PageTransformHints as i, materializePageSections as j, materializePageSection as m, resolvePageStyle as r };
+export { AUTHORED_PRESENTATION_LAYOUT as A, type MaterializePageSectionOptions as M, PRESENTATION_KEY as P, type MaterializePageSectionsOptions as a, PRESENTATION_LAYOUTS as b, PRESENTATION_LIMITS as c, type PageMedia as d, type PageRichText as e, type PageSection as f, type PageSectionDiagnostic as g, type PageSectionItem as h, type PageSectionMaterialization as i, type PageSectionSource as j, type PageSpatialKind as k, type PageTransformHints as l, type PresentationBeat as m, type PresentationBeatLayout as n, type PresentationLayout as o, type PresentationPlan as p, materializePageSection as q, materializePageSections as r, parsePresentationPlan as s, presentationLayoutFits as t, presentationStat as u, resolvePageStyle as v, serializePresentationPlan as w };

package/dist/narration/index.js

@@ -31,7 +31,7 @@ import {
   traceWordPosAt,
   transcriptWordKeys,
   vadStep
-} from "../chunk-CQSCYJQU.js";
+} from "../chunk-OIQ2GO2O.js";
 import "../chunk-NEWNNLWN.js";
 import {
   buildNarrationTimingJson,
@@ -45,7 +45,7 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-QJQQO3K4.js";
+} from "../chunk-CTT4XAGO.js";
 import "../chunk-SGNWO7OF.js";
 import "../chunk-FUBMT6SJ.js";
 import "../chunk-JNUNNQ74.js";

package/dist/timing/index.d.ts

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