@bendyline/squisq 2.13.13 → 2.13.15

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

@@ -1,4 +1,4 @@
-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 { k as Block, b0 as PageSectionKind, a_ as PageEmphasis, bP as ThemeColorScheme, aY as PageBackground, bN as Theme, cj as ViewportConfig, D as CustomTemplateDefinition, b3 as PageVariant, bw as StartBlockConfig, U as Doc, bQ as ThemePageStyle } from './Doc-C_Sh49ot.js';
 import { M as MarkdownBlockNode } from './types-Zk8qYuaT.js';
 
 /** A prominent number found inside a short stat-like string. */
@@ -15,7 +15,7 @@ interface NumberHighlightMatch {
 
 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"];
+declare const PRESENTATION_LAYOUTS: readonly ["title", "divider", "statement", "emphasis", "quote", "stat", "definition", "list", "comparison", "steps", "image", "cards", "process", "cycle", "layers", "stats", "pyramid", "funnel", "hub", "venn", "matrix"];
 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. */
@@ -27,12 +27,26 @@ declare function presentationStat(headline: string, points: readonly string[]):
     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. */
+/** Whether a summary can fill a layout: the items a drawn layout takes
+ * (`conceptItemsProblem`: three stages for a cycle, a figure in every key
+ * number, four ideas for a matrix…); 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;
+/** Why a summary cannot fill a layout, as a sentence its author can act on
+ * (a person reading a designer's help, a model reading a correction), or
+ * `undefined` when it can. */
+declare function presentationLayoutProblem(layout: PresentationLayout, headline: string, points: readonly string[], passage: string): string | undefined;
+/** What a slide must have for a layout to apply, as a designer's help says it
+ * ("at least 2 points", "exactly 4 points"), or `undefined` when any slide
+ * will do. It states what `presentationLayoutProblem` checks, so a picker's
+ * help and the plan agree. `points` names a slide's points in the host's own
+ * word ("highlights"). */
+declare function presentationLayoutNeeds(layout: PresentationLayout, wording?: {
+    points?: string;
+}): string | undefined;
 interface PresentationBeat {
     id: string;
     sourceStart: number;
@@ -45,7 +59,19 @@ interface PresentationBeat {
     media?: string[];
     /** Left out of the deck; the slide shown before it stays on screen instead. */
     hidden?: true;
+    /** A hub only: the one to three words its ideas share, written inside it. */
+    center?: string;
+    /** A matrix only: what grows from left to right, named along the foot. */
+    xAxis?: string;
+    /** A matrix only: what grows from bottom to top, named up the side. */
+    yAxis?: string;
 }
+/** What a layout draws beyond its headline and points. */
+type PresentationBeatExtras = Pick<PresentationBeat, 'center' | 'xAxis' | 'yAxis'>;
+/** The extras of `source` that `layout` draws, trimmed; ones it does not draw,
+ * empty ones and ones too long to set are left out. Read loosely, so a model's
+ * reply and a saved beat pass through the same door. */
+declare function presentationBeatExtras(layout: string, source: unknown): PresentationBeatExtras;
 interface PresentationPlan {
     version: 1;
     sourceText: string;
@@ -57,10 +83,97 @@ declare const PRESENTATION_LIMITS: {
     readonly beats: 80;
     readonly serializedCharacters: 160000;
     readonly mediaPerBeat: 4;
+    /** The most points a summary slide holds. */
+    readonly points: 4;
+    /** The longest a hub's centre or a matrix's axis name may be. */
+    readonly extraCharacters: 40;
 };
 declare function parsePresentationPlan(input: unknown): PresentationPlan | null;
 declare function serializePresentationPlan(plan: PresentationPlan): string;
 
+/**
+ * Concept specs — what each concept template takes, as data.
+ *
+ * The ten concept templates draw a handful of ideas, and every product that
+ * lets an author choose one has to say the same things about it: how many
+ * items it takes, how an item is written, what order they come in, and what
+ * the template draws when it is given something else. Those facts used to be
+ * restated wherever they were needed (a prompt's "3–5", a validator's table,
+ * a picker's help text, each template's own fallback) and the copies drifted.
+ * This module is the one statement of them:
+ *
+ * - {@link CONCEPT_SPECS}: per template, the items an author should write and
+ *   the inputs it takes beyond them. The authoring guide renders its counts
+ *   from here ({@link conceptItemCount}), so a prompt and a check agree.
+ * - {@link conceptItemsProblem}: whether a set of items meets that contract,
+ *   as a sentence an author or a repair prompt can act on.
+ * - {@link conceptDowngrade}: what a template draws instead when it cannot
+ *   draw its own picture. The templates call it, so it cannot disagree with
+ *   them, and `markdownToDoc` reports it (`template-shape-unmet`).
+ *
+ * Pure text in, plain data out.
+ *
+ * Related: `conceptItems.ts` (how one item is read), `conceptBlocks.ts` and
+ * `conceptShapes.ts` (the drawings), `authoringGuide.ts` (what authors are told).
+ */
+
+/** Every template that draws a handful of ideas. */
+declare const CONCEPT_TEMPLATES: readonly ["cards", "process", "cycle", "layers", "stats", "pyramid", "funnel", "hub", "venn", "matrix"];
+type ConceptTemplateName = (typeof CONCEPT_TEMPLATES)[number];
+/** The most ideas a concept template draws; more are shown as the list they are. */
+declare const CONCEPT_MAX_DRAWN = 6;
+/** An input a concept template takes beyond `title` and `items`. */
+interface ConceptSpecInput {
+    key: string;
+    /** What an author writes there, as a guide lists it. */
+    guide: string;
+}
+interface ConceptSpec {
+    /** The fewest and the most items an author should write. */
+    items: readonly [min: number, max: number];
+    /** How an item is written: a label and its detail, or a figure and what it measures. */
+    itemForm: 'label-detail' | 'figure-caption';
+    /** The order the items are written in, when the drawing depends on it. */
+    order?: string;
+    /** Inputs beyond `title` and `items`. */
+    inputs?: readonly ConceptSpecInput[];
+}
+declare const CONCEPT_SPECS: Readonly<Record<ConceptTemplateName, ConceptSpec>>;
+/** The concept template a name denotes, or `undefined`. */
+declare function conceptTemplate(template: string): ConceptTemplateName | undefined;
+interface ConceptItemsOptions {
+    /**
+     * The most items the author's surface holds, when that is fewer than the
+     * template takes (a summary slide holds four points).
+     */
+    max?: number;
+}
+/** How many items a template takes, as a guide says it: "2–4", or "exactly 4". */
+declare function conceptItemCount(template: ConceptTemplateName, options?: ConceptItemsOptions): string;
+/**
+ * Why `items` do not meet a template's contract, or `undefined` when they do:
+ * too few or too many, a key number without a figure, a Venn diagram without
+ * the item that names what its sets share. The sentence is written for the
+ * author, so a validator can log it and a repair prompt can quote it.
+ */
+declare function conceptItemsProblem(template: ConceptTemplateName, items: readonly unknown[] | undefined, options?: ConceptItemsOptions): string | undefined;
+/** What a concept template draws when it cannot draw its own picture, and why. */
+interface ConceptDowngrade {
+    drawsAs: ConceptTemplateName | 'list';
+    /** Completes "…, so it is drawn as <drawsAs>": "a matrix places exactly four items and this has three". */
+    reason: string;
+}
+/**
+ * What a template draws instead of its own picture for these items, or
+ * `undefined` when it draws itself. A template never draws a broken diagram:
+ * a matrix without four ideas, a Venn diagram without two sets and key
+ * numbers without a figure draw as cards; a cycle too short or too wordy for
+ * a ring draws as a process; more than six ideas are shown as a list.
+ */
+declare function conceptDowngrade(template: ConceptTemplateName, items: readonly unknown[] | undefined): ConceptDowngrade | undefined;
+/** The template that draws these items: `template` itself unless it is downgraded. */
+declare function conceptDrawsAs(template: ConceptTemplateName, items: readonly unknown[] | undefined): ConceptTemplateName | 'list';
+
 /**
  * PageSection — the framework-agnostic block model for Page (linear) mode.
  *
@@ -300,4 +413,4 @@ declare function materializePageSection(block: Block, options?: MaterializePageS
  */
 declare function materializePageSections(doc: Doc, options?: MaterializePageSectionsOptions): PageSectionMaterialization[];
 
-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 };
+export { AUTHORED_PRESENTATION_LAYOUT as A, conceptItemCount as B, CONCEPT_MAX_DRAWN as C, conceptItemsProblem as D, conceptTemplate as E, materializePageSection as F, materializePageSections as G, parsePresentationPlan as H, presentationBeatExtras as I, presentationLayoutFits as J, presentationLayoutNeeds as K, presentationLayoutProblem as L, type MaterializePageSectionOptions as M, presentationStat as N, resolvePageStyle as O, PRESENTATION_KEY as P, serializePresentationPlan as Q, CONCEPT_SPECS as a, CONCEPT_TEMPLATES as b, type ConceptDowngrade as c, type ConceptItemsOptions as d, type ConceptSpec as e, type ConceptSpecInput as f, type ConceptTemplateName as g, type MaterializePageSectionsOptions as h, PRESENTATION_LAYOUTS as i, PRESENTATION_LIMITS as j, type PageMedia as k, type PageRichText as l, type PageSection as m, type PageSectionDiagnostic as n, type PageSectionItem as o, type PageSectionMaterialization as p, type PageSectionSource as q, type PageSpatialKind as r, type PageTransformHints as s, type PresentationBeat as t, type PresentationBeatExtras as u, type PresentationBeatLayout as v, type PresentationLayout as w, type PresentationPlan as x, conceptDowngrade as y, conceptDrawsAs as z };

package/dist/mediaEdit/index.d.ts

@@ -1,5 +1,5 @@
-import { ap as MediaCut, T as Doc, an as MediaClip, cI as MediaFxOpId, cJ as MediaFxChain } from '../Doc-BhvotZx_.js';
-export { cK as MEDIA_EDIT_PARAMS, cL as MEDIA_FX_ORDER, cM as MEDIA_FX_SPECS, ao as MediaCrop, cN as MediaEditParamKey, cO as MediaEditParamValues, aq as MediaEdits, cP as MediaFxOp, cQ as formatMediaNumber, cR as hasRenderableFx, cS as mediaEditHtmlAttribute, cT as mediaEditValuesFromAttributes, cU as mediaEditValuesFromParams, cV as mediaRenderKey, cW as normalizeMediaCrop, cX as normalizeMediaCuts, cY as parseMediaCrop, cZ as parseMediaCuts, c_ as parseMediaEdits, c$ as parseMediaFx, d0 as serializeMediaCrop, d1 as serializeMediaCuts, d2 as serializeMediaEdits, d3 as serializeMediaFx } from '../Doc-BhvotZx_.js';
+import { at as MediaCut, U as Doc, ar as MediaClip, cP as MediaFxOpId, cQ as MediaFxChain } from '../Doc-C_Sh49ot.js';
+export { cR as MEDIA_EDIT_PARAMS, cS as MEDIA_FX_ORDER, cT as MEDIA_FX_SPECS, as as MediaCrop, cU as MediaEditParamKey, cV as MediaEditParamValues, au as MediaEdits, cW as MediaFxOp, cX as formatMediaNumber, cY as hasRenderableFx, cZ as mediaEditHtmlAttribute, c_ as mediaEditValuesFromAttributes, c$ as mediaEditValuesFromParams, d0 as mediaRenderKey, d1 as normalizeMediaCrop, d2 as normalizeMediaCuts, d3 as parseMediaCrop, d4 as parseMediaCuts, d5 as parseMediaEdits, d6 as parseMediaFx, d7 as serializeMediaCrop, d8 as serializeMediaCuts, d9 as serializeMediaEdits, da as serializeMediaFx } from '../Doc-C_Sh49ot.js';
 import '../types-Zk8qYuaT.js';
 
 /**

package/dist/narration/index.d.ts

@@ -1,4 +1,4 @@
-import { T as Doc, bb as PresentationSlideMark, f as AudioBookmark } from '../Doc-BhvotZx_.js';
+import { U as Doc, bf as PresentationSlideMark, f as AudioBookmark } from '../Doc-C_Sh49ot.js';
 import { d as BuildAdvance } from '../types-Zk8qYuaT.js';
 
 /**

package/dist/narration/index.js

@@ -31,7 +31,7 @@ import {
   traceWordPosAt,
   transcriptWordKeys,
   vadStep
-} from "../chunk-OIQ2GO2O.js";
+} from "../chunk-2CB37BOU.js";
 import "../chunk-NEWNNLWN.js";
 import {
   buildNarrationTimingJson,
@@ -45,12 +45,12 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-CTT4XAGO.js";
-import "../chunk-SGNWO7OF.js";
+} from "../chunk-4HQ7QZKB.js";
+import "../chunk-OFE5RZWW.js";
 import "../chunk-FUBMT6SJ.js";
 import "../chunk-JNUNNQ74.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-7MS26OXD.js";
+import "../chunk-UDPPWYYM.js";
 import "../chunk-L3KSFLTP.js";
 import "../chunk-P53Z4RYC.js";
 import "../chunk-GHOPHGOK.js";

package/dist/recommend/index.d.ts

@@ -1,5 +1,97 @@
 import { M as MarkdownBlockNode } from '../types-Zk8qYuaT.js';
 
+/**
+ * List shapes — what a list is a picture of.
+ *
+ * A bulleted list says only "here are some things". Its heading and its
+ * items usually say more: that the things happen in order, come round again,
+ * sit inside one another, narrow from many to few, stand against each other,
+ * or are numbers. `classifyListShape` reads those signals and names the
+ * relationship and the template that draws it, so a plain Markdown list can
+ * become a process, a cycle, concentric layers, a pyramid, a funnel, a Venn
+ * diagram, a row of key numbers — or stay a list when nothing says otherwise.
+ *
+ * It is deliberately a reader of evidence, not a guesser: a `strong` result
+ * rests on something the author wrote (a numbered list, dates in order, a
+ * heading that says "cycle", items written `Label: detail`) and is safe to
+ * apply automatically; a `weak` one is only worth offering as a suggestion.
+ * A drawing that misstates the relationship is worse than a list, so an
+ * ordering the items do not make clear (is the first layer the core or the
+ * crust?) is never applied automatically.
+ *
+ * Used by `markdownToDoc`'s automatic templates, the editor's template
+ * recommendations, and hosts that plan slides from their own outlines.
+ * Pure text in, plain data out.
+ *
+ * Related: `recommend/templates.ts`, `doc/templates/conceptItems.ts`,
+ * `doc/templates/conceptBlocks.ts`, `doc/templates/conceptShapes.ts`.
+ */
+/** The relationship a list's items have to one another. */
+type ListShape = 'figures' | 'timeline' | 'sequence' | 'cycle' | 'nested' | 'hierarchy' | 'funnel' | 'contrast' | 'overlap' | 'matrix' | 'hub' | 'parallel' | 'plain';
+interface ListShapeInput {
+    /** The heading over the list. */
+    heading?: string;
+    /** The items as text; write a nested item as `Label: detail`. */
+    items: readonly string[];
+    /** Whether the list was numbered. */
+    ordered?: boolean;
+    /** Prose that introduces the list, when there is some. */
+    intro?: string;
+}
+interface ListShapeResult {
+    shape: ListShape;
+    /** The template that draws the shape. */
+    template: string;
+    /**
+     * `strong`: the author's own words or structure say so; apply it.
+     * `weak`: plausible; offer it, but leave the choice to a person.
+     */
+    confidence: 'strong' | 'weak';
+    /** Inputs the template needs beyond the items (a reversed order, `versus`). */
+    inputs?: Record<string, unknown>;
+    /** What the classification rests on, for a tooltip or a log. */
+    reason: string;
+}
+/**
+ * Name the relationship among a list's items and the template that draws it.
+ * A list no concept template can hold (one item, more than six, or items the
+ * length of paragraphs) is `plain`.
+ */
+declare function classifyListShape(input: ListShapeInput): ListShapeResult;
+/** What says whether a relationship holds: the heading, the prose, the items. */
+interface ShapeEvidence {
+    /** The heading over the ideas. */
+    heading?: string;
+    /** The prose the ideas summarize or sit under. */
+    passage?: string;
+    /** The ideas as they would be drawn. */
+    items: readonly string[];
+    /** A matrix's axis names; naming both says what its panels are placed on. */
+    axes?: readonly [x?: string, y?: string];
+}
+/**
+ * Whether the source says its ideas have the relationship `template` draws.
+ *
+ * `classifyListShape` chooses a drawing for a list; this is the other
+ * direction, for an author (a model, usually) that has already chosen one.
+ * Cards, a process, a hub and key numbers claim little beyond what their
+ * items say, so they always pass. The shapes that assert how the ideas
+ * relate need the source to say so, in the heading, the prose or the items:
+ *
+ * - `cycle`: it comes round again ("cycle", "loop", "the cycle repeats");
+ * - `layers`: the parts are nested ("layers", "anatomy", a core and a crust);
+ * - `pyramid`: there is a hierarchy ("hierarchy", "tiers", a top and a base);
+ * - `funnel`: the stages narrow ("funnel", "conversion"), or their figures shrink;
+ * - `venn`: the two share something ("both", "in common", "overlap");
+ * - `matrix`: two named axes, or a source that calls it a matrix.
+ *
+ * A drawing that misstates the relationship is worse than cards, so a caller
+ * that gets `false` should draw the ideas as cards (or a process) instead.
+ */
+declare function shapeIsStated(template: string, evidence: ShapeEvidence): boolean;
+/** What to draw instead when the source does not state a shape: the same ideas, claiming less. */
+declare function unstatedShapeFallback(template: string): 'cards' | 'process' | undefined;
+
 /**
  * Block template recommendations.
  *
@@ -40,6 +132,17 @@ interface BlockContentProfile {
      * exclusive with `hasAsciiDiagram`.
      */
     hasTree?: boolean;
+    /**
+     * What the body's list is a picture of — a process, a cycle, key numbers…
+     * (see `classifyListShape`). Set when the body is one list of two to six
+     * items; a `strong` shape picks its template automatically.
+     */
+    listShape?: ListShapeResult;
+}
+/** What `profileBlockContents` may know beyond the body itself. */
+interface ProfileBlockOptions {
+    /** The heading over the body: "The water cycle" says more than its bullets do. */
+    heading?: string;
 }
 interface RecommendationResult {
     recommended: string[];
@@ -49,7 +152,31 @@ interface RecommendationResult {
  * Walk a slice of block nodes and summarize what kinds of content it
  * contains. Cheap to run — no markdown parsing, just AST traversal.
  */
-declare function profileBlockContents(nodes: MarkdownBlockNode[]): BlockContentProfile;
+declare function profileBlockContents(nodes: MarkdownBlockNode[], options?: ProfileBlockOptions): BlockContentProfile;
+/** How `pickAutoTemplate` chooses. */
+interface AutoTemplateOptions {
+    /**
+     * Draw a list as what it is a picture of (a process, a cycle, key
+     * numbers…) when its shape is clear. `false` keeps every list a `list`.
+     * Default true.
+     */
+    concepts?: boolean;
+}
+/**
+ * Deterministic single-template choice for an unannotated heading block,
+ * from strong content signals only. Returns `undefined` when no signal is
+ * decisive — the caller keeps its structural default (`sectionHeader`).
+ *
+ * Precedence favors the most specific/structured content: a table beats
+ * a video beats an image beats a blockquote beats a stat-looking line. `blockIndex`
+ * alternates left/right feature composition for single-image blocks so a
+ * run of image sections doesn't stack the same layout.
+ *
+ * Used by `markdownToDoc`'s auto template picking (see its `autoTemplates`
+ * option); the multi-candidate `recommendTemplatesForBlock` below serves
+ * the editor's template-picker UI instead.
+ */
+declare function pickAutoTemplate(profile: BlockContentProfile, blockIndex?: number, options?: AutoTemplateOptions): string | undefined;
 /**
  * Split a flat list of template names into a "Recommended" bucket
  * (matches the active block's content profile) and a "rest" bucket
@@ -59,4 +186,4 @@ declare function profileBlockContents(nodes: MarkdownBlockNode[]): BlockContentP
  */
 declare function recommendTemplatesForBlock(profile: BlockContentProfile, allNames: readonly string[]): RecommendationResult;
 
-export { type BlockContentProfile, type RecommendationResult, profileBlockContents, recommendTemplatesForBlock };
+export { type AutoTemplateOptions, type BlockContentProfile, type ListShape, type ListShapeInput, type ListShapeResult, type ProfileBlockOptions, type RecommendationResult, type ShapeEvidence, classifyListShape, pickAutoTemplate, profileBlockContents, recommendTemplatesForBlock, shapeIsStated, unstatedShapeFallback };

package/dist/recommend/index.js

@@ -1,11 +1,19 @@
 import {
+  classifyListShape,
+  pickAutoTemplate,
   profileBlockContents,
-  recommendTemplatesForBlock
-} from "../chunk-SGNWO7OF.js";
+  recommendTemplatesForBlock,
+  shapeIsStated,
+  unstatedShapeFallback
+} from "../chunk-OFE5RZWW.js";
 import "../chunk-L7QZORLB.js";
 import "../chunk-L3KSFLTP.js";
 import "../chunk-P53Z4RYC.js";
 export {
+  classifyListShape,
+  pickAutoTemplate,
   profileBlockContents,
-  recommendTemplatesForBlock
+  recommendTemplatesForBlock,
+  shapeIsStated,
+  unstatedShapeFallback
 };

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 { 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';
+import { U as Doc, bN as Theme, bQ as ThemePageStyle, bP as ThemeColorScheme, N as DeepPartial, bT as ThemeSeedColors, bO as ThemeColorPalette, a2 as FontFamilyKind, a1 as FontFamily } from '../Doc-C_Sh49ot.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, T as DiagramTemplateNodeInput, V as DocBlock, W as DocDiagnostic, X as DonutChartInput, Y as DrawingBlockInput, Z as FRONTMATTER_CUSTOM_TEMPLATES_KEY, _ as FRONTMATTER_CUSTOM_THEMES_KEY, $ as FRONTMATTER_MOTION_KEY, a0 as FactCardInput, a3 as FullBleedQuoteInput, a4 as FunnelBlockInput, a5 as GradientBackgroundConfig, a6 as HubBlockInput, a7 as ImageBackgroundConfig, a8 as ImageLayer, a9 as ImageTreatment, aa as ImageWithCaptionInput, ab as LIGHT_SURFACE, ac as Layer, ad as LayerRepeat, ae as LayersBlockInput, af as LayoutHints, ag as LeftFeatureInput, ah as LineChartInput, ai as LinearGradient, aj as ListBlockInput, ak as MOTION_PROFILES, al as MapBlockInput, am as MapLayer, an as MapMarker, ao as MapTileStyle, ap as MarkerStyle, aq as MatrixBlockInput, ar as MediaClip, as as MediaCrop, at as MediaCut, au as MediaEdits, av as MediaOnlyInput, aw as MediaScheduleOptions, ax as MermaidLayer, ay as MotionEntrance, az as MotionOrigin, aA as MotionProfile, aB as MotionProfileName, aC as MotionSpec, aD as MotionState, aE as PAGE_ACCENT_STRATEGIES, aF as PAGE_BACKGROUNDS, aG as PAGE_BACKGROUND_RHYTHMS, aH as PAGE_DESIGN_FAMILIES, aI as PAGE_DIVIDERS, aJ as PAGE_EMPHASES, aK as PAGE_EYEBROWS, aL as PAGE_HEADING_CASES, aM as PAGE_HEADING_SCALES, aN as PAGE_HEADING_UNDERLINES, aO as PAGE_HERO_STYLES, aP as PAGE_IMAGE_FRAMINGS, aQ as PAGE_NUMERAL_STYLES, aR as PAGE_PATTERNS, aS as PAGE_QUOTE_MARKS, aT as PAGE_SECTION_KINDS, aU as PAGE_SECTION_SPACINGS, aV as PAGE_SHADOWS, aW as PAGE_VARIANTS, aX as PageAccentRotation, aY as PageBackground, aZ as PageDesignFamily, a_ as PageEmphasis, a$ as PageHeadingTreatment, b0 as PageSectionKind, b1 as PageSectionOverride, b2 as PageTokens, b3 as PageVariant, b4 as PathLayer, b5 as PatternBackgroundConfig, b6 as PersistentLayer, b7 as PersistentLayerConfig, b8 as PersistentLayerTemplate, b9 as PersistentLayerTemplateConfig, ba as PersistentLayerTemplateType, bb as PhotoGridInput, bc as PieChartInput, bd as PipStyle, be as Position, bf as PresentationSlideMark, bg as ProcessBlockInput, bh as ProgressIndicatorConfig, bi as PromotedBodyAnnotation, bj as PullQuoteInput, bk as PyramidBlockInput, bl as QuoteBlockInput, bm as RawLayersInput, bn as RenderStyle, bo as RightFeatureInput, bp as ScatterChartInput, bq as ScheduledClip, br as SectionHeaderInput, bs as ShapeFilter, bt as ShapeLayer, bu as ShapePattern, bv as SolidBackgroundConfig, bw as StartBlockConfig, bx as StatHighlightInput, by as StatsBlockInput, bz as SurfaceScheme, bA as SvgLayer, bB as THEME_SCHEMA_VERSION, bC as TableLayer, bD as TableLayerStyle, bE as TemplateBlock, bF as TemplateContext, bG as TemplateFunction, bH as TemplateRegistry, bI as TextFlow, bJ as TextLayer, bK as TextParagraph, bL as TextParagraphList, bM as TextStyle, bR as ThemeRegistry, bS as ThemeSchemaVersion, bU as ThemeStyle, bV as ThemeTypography, bW as TimelineBlockInput, bX as TimelineTemplateEvent, bY as TimelineTemplateLink, bZ as TimelineTemplateTrack, b_ as TitleBlockInput, b$ as TitleCaptionConfig, c0 as TopFeatureInput, c1 as TranscriptBlockInput, c2 as TreeBlockInput, c3 as TreeLayer, c4 as TreeLayerItem, c5 as TreeLayerStyle, c6 as TreeTemplateItem, c7 as TwoColumnInput, c8 as VIEWPORT_PRESETS, c9 as VennBlockInput, ca as VideoEmbedLayer, cb as VideoLayer, cc as VideoPipPosition, cd as VideoPipShape, ce as VideoPipSize, cf as VideoPlacement, cg as VideoPresentation, ch as VideoPullQuoteInput, ci as VideoWithCaptionInput, cj as ViewportConfig, ck as ViewportOrientation, cl as ViewportPreset, cm as VignetteConfig, cn as applySurface, co as calculateDuration, cp as calculateFontScale, cq as createTemplateContext, cr as createTheme, cs as createThemeRegistry, ct as getAspectRatioString, cu as getBlockAtTime, cv as getCaptionAtTime, cw as getDocPlaybackDuration, cx as getLayoutHints, cy as getSafeTextBounds, cz as getSegmentAtTime, cA as getTwoColumnPositions, cB as getViewport, cC as getViewportOrientation, cD as isCustomTemplateDefinition, cE as isMotionProfileName, cF as isPersistentLayerTemplate, cG as isTemplateBlock, cH as layoutScaledFontSize, cI as readFrontmatterMotion, cJ as resolveMediaSchedule, cK as resolveMotionForDoc, cL as resolveMotionProfile, cM as scaledFontSize, cN as scheduleMediaClip, cO as validateCustomTemplateDefinition } from '../Doc-C_Sh49ot.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-B4VLovhW.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-D8hYio6b.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-Sqw3Tw-R.js';
 
 /**
  * Runtime validation for the canonical {@link Doc} JSON shape.

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

@@ -1,4 +1,4 @@
-import { bH as Theme, bL as ThemeRegistry } from './Doc-BhvotZx_.js';
+import { bN as Theme, bR as ThemeRegistry } from './Doc-C_Sh49ot.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-BhvotZx_.js';
+import { g as AudioSegment, h as AudioTimingData, o as CaptionTrack, U as Doc, k as Block } from '../Doc-C_Sh49ot.js';
 import '../types-Zk8qYuaT.js';
 
 /**
@@ -139,6 +139,70 @@ interface BuildCaptionTrackOptions {
 }
 declare function buildCaptionTrack(sources: CaptionSegmentSource[], options?: BuildCaptionTrackOptions): CaptionTrack;
 
+/**
+ * Caption and chapter files — a doc's timing as text other players read.
+ *
+ * A rendered video burns its captions into the picture, which is right for a
+ * silent autoplay feed and wrong for everything else: a viewer cannot turn
+ * them off, a platform cannot translate or index them, and a screen reader
+ * cannot read them. These writers turn the same `CaptionTrack` the player
+ * shows into the two sidecar formats every video host accepts, SubRip (`.srt`)
+ * and WebVTT (`.vtt`), and a doc's sections into a chapter list.
+ *
+ * All three are pure functions of the doc's own times, so a host that
+ * post-processes the audio (a pre-roll, a trimmed take) passes an `offset`
+ * rather than rewriting cues. A cue never runs past the start of the next
+ * one, and cues with no words, or that end before they start, are left out.
+ *
+ * Related: `timing/captions.ts` (`buildCaptionTrack`), `schemas/Doc.ts`
+ * (`CaptionTrack`), the CLI's `video --captions`.
+ */
+
+interface CaptionFileOptions {
+    /** Seconds added to every time, for a video that starts before the doc does (a cover pre-roll). */
+    offset?: number;
+}
+/** A caption track as a SubRip (`.srt`) file; empty when it has no cues. */
+declare function formatCaptionsSrt(track: Pick<CaptionTrack, 'phrases'> | undefined, options?: CaptionFileOptions): string;
+/**
+ * A caption track as a WebVTT (`.vtt`) file. The header is always written,
+ * so a track without cues is still a valid file.
+ */
+declare function formatCaptionsVtt(track: Pick<CaptionTrack, 'phrases'> | undefined, options?: CaptionFileOptions): string;
+/** One chapter of a doc: where a section starts, and what it is called. */
+interface DocChapter {
+    /** Seconds from the start of the video. */
+    startTime: number;
+    title: string;
+}
+interface DocChapterOptions extends CaptionFileOptions {
+    /**
+     * The shortest a chapter may be, in seconds (default 10). A section that
+     * starts sooner after the one before it is folded into it: players and
+     * platforms ignore chapter lists with very short entries.
+     */
+    minDuration?: number;
+}
+/**
+ * A doc's chapters: its titled blocks, in time order, from the blocks as a
+ * player schedules them (pass the doc after `resolveAudioMapping`, or the
+ * blocks `expandDocBlocks` returns). Consecutive blocks with one title — a
+ * section shown over several slides — are one chapter. The first chapter
+ * starts at zero, as chapter lists must.
+ */
+declare function docChapters(doc: Pick<Doc, 'blocks'> | readonly Block[], options?: DocChapterOptions): DocChapter[];
+/**
+ * Chapters as an FFmpeg metadata file (`ffmpeg -i video.mp4 -i chapters.txt
+ * -map_metadata 1 -codec copy out.mp4`), which is how a chapter list is
+ * written into an MP4. `duration` closes the last chapter.
+ */
+declare function formatChaptersFfmetadata(chapters: readonly DocChapter[], duration: number): string;
+/**
+ * Chapters as the timestamp list video platforms read from a description
+ * ("0:00 Introduction"). Hours appear only when the video runs past one.
+ */
+declare function formatChaptersText(chapters: readonly DocChapter[]): string;
+
 /**
  * Word timings: when narration speaks a given place in its script.
  *
@@ -195,4 +259,4 @@ declare function phraseOffset(timeline: WordTimeline, phrase: string, from?: num
  */
 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 };
+export { type BuildCaptionTrackOptions, type CaptionFileOptions, type CaptionSegmentSource, DEFAULT_WORDS_PER_SECOND, type DocChapter, type DocChapterOptions, type NarrationTimeEstimate, type NarrationTimeOptions, type PhraseTimeOptions, type ReadingTimeEstimate, type ReadingTimeOptions, type WordMark, type WordSnap, type WordTimeline, buildCaptionTrack, calculatePrefixDuration, countSpokenWords, docChapters, estimateNarrationDuration, estimateNarrationTime, estimateReadingTime, estimateSpokenWordCount, estimateTimeFromText, formatCaptionsSrt, formatCaptionsVtt, formatChaptersFfmetadata, formatChaptersText, phraseOffset, phraseStartTime, wordTimeAt };

package/dist/timing/index.js

@@ -1,3 +1,10 @@
+import {
+  docChapters,
+  formatCaptionsSrt,
+  formatCaptionsVtt,
+  formatChaptersFfmetadata,
+  formatChaptersText
+} from "../chunk-C7DKMO4H.js";
 import {
   buildCaptionTrack
 } from "../chunk-5HWYSUXS.js";
@@ -21,11 +28,16 @@ export {
   buildCaptionTrack,
   calculatePrefixDuration,
   countSpokenWords,
+  docChapters,
   estimateNarrationDuration,
   estimateNarrationTime,
   estimateReadingTime,
   estimateSpokenWordCount,
   estimateTimeFromText,
+  formatCaptionsSrt,
+  formatCaptionsVtt,
+  formatChaptersFfmetadata,
+  formatChaptersText,
   phraseOffset,
   phraseStartTime,
   wordTimeAt