@bendyline/squisq 2.13.9 → 2.13.11

package/dist/timing/index.d.ts

@@ -1,4 +1,4 @@
-import { g as AudioSegment, h as AudioTimingData, o as CaptionTrack } from '../Doc-BCrrYAuK.js';
+import { g as AudioSegment, h as AudioTimingData, o as CaptionTrack } from '../Doc-DqYt_b2b.js';
 import '../types-Zk8qYuaT.js';
 
 /**

package/dist/transform/index.d.ts

@@ -1,5 +1,5 @@
-import { R as Doc, s as ColorScheme, k as Block, bt as TemplateBlock } from '../Doc-BCrrYAuK.js';
-import { i as PageTransformHints } from '../materializePageSection-FT1B5NOo.js';
+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 { 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,23 +321,50 @@ 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";
-declare const PRESENTATION_LAYOUTS: readonly ["title", "statement", "list", "comparison", "steps", "image"];
+/** 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: PresentationLayout;
+    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;
@@ -356,11 +383,18 @@ 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
+ * than the passage keeps the document text out of the hints. */
+declare function presentationPassageKey(passage: string): string;
 interface PresentationBlockHint {
     build?: BuildSpec;
     blockId: string;
-    layout?: PresentationLayout;
+    /** A summary layout to prefer, or `authored` to show the section's own block. */
+    layout?: PresentationBeatLayout;
     inbetweens?: boolean;
+    /** Slides left out of the deck, by `presentationPassageKey` of their passage.
+     * Changing a passage, or how the section is split, shows its slide again. */
+    hidden?: string[];
     /** Optional AI-authored display text, keyed to the exact passage it summarizes. */
     ai?: Array<{
         source: string;
@@ -377,7 +411,9 @@ interface PresentationBlockHint {
 }
 interface PresentationHints {
     version: 1;
-    density: 'concise' | 'balanced' | 'detailed';
+    /** How much of a section each slide covers; `section` is one slide per section,
+     * with no supporting slides. */
+    density: 'concise' | 'balanced' | 'detailed' | 'section';
     inbetweens: boolean;
     blocks: PresentationBlockHint[];
 }
@@ -421,4 +457,4 @@ interface PresentationMediaItem {
  * block's visuals belong to the nearest narrated section at or before it. */
 declare function collectPresentationMedia(doc: Doc, sectionIds: string[]): Map<string, PresentationMediaItem[]>;
 
-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 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, presentationSections, resolveTransformStyle, serializePresentationHints, serializePresentationPlan, transformNarratedSegment, usesDynamicPresentation };
+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 };

package/dist/transform/index.js

@@ -1,4 +1,5 @@
 import {
+  AUTHORED_PRESENTATION_LAYOUT,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
@@ -19,15 +20,18 @@ import {
   getTransformStyleSummaries,
   parsePresentationHints,
   parsePresentationPlan,
+  presentationLayoutFits,
+  presentationPassageKey,
   presentationSections,
+  presentationStat,
   resolveTransformStyle,
   serializePresentationHints,
   serializePresentationPlan,
   transformNarratedSegment,
   usesDynamicPresentation
-} from "../chunk-VMKRN7TB.js";
-import "../chunk-L3VQQ3WT.js";
-import "../chunk-R2J7CQJZ.js";
+} from "../chunk-N7I6JP6Q.js";
+import "../chunk-SKGMNBQX.js";
+import "../chunk-3WUI2N6C.js";
 import "../chunk-SVN7T6BK.js";
 import "../chunk-FUBMT6SJ.js";
 import "../chunk-WNEH3BZP.js";
@@ -40,6 +44,7 @@ import "../chunk-P53Z4RYC.js";
 import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {
+  AUTHORED_PRESENTATION_LAYOUT,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
@@ -60,7 +65,10 @@ export {
   getTransformStyleSummaries,
   parsePresentationHints,
   parsePresentationPlan,
+  presentationLayoutFits,
+  presentationPassageKey,
   presentationSections,
+  presentationStat,
   resolveTransformStyle,
   serializePresentationHints,
   serializePresentationPlan,

package/package.json

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