@bendyline/squisq 2.13.14 → 2.13.16

package/dist/doc/index.d.ts

@@ -1,12 +1,12 @@
-import { a9 as Layer, k as Block, T as Doc, by as TemplateBlock, bz as TemplateContext, D as CustomTemplateDefinition, bB as TemplateRegistry, bH as Theme, cc as ViewportConfig, b3 as PersistentLayerConfig, ay as MotionSpec, U as DocBlock, cd as ViewportOrientation, b2 as PersistentLayer, bU as TitleBlockInput, bm as SectionHeaderInput, j as BigTextInput, w as ContentBlockInput, bs as StatHighlightInput, bg as QuoteBlockInput, $ as FactCardInput, c1 as TwoColumnInput, M as DateEventInput, a7 as ImageWithCaptionInput, ad as LeftFeatureInput, bj as RightFeatureInput, n as BottomFeatureInput, ar as MediaOnlyInput, bW as TopFeatureInput, ai as MapBlockInput, br as StartBlockConfig, a2 as FullBleedQuoteInput, ag as ListBlockInput, q as CardsBlockInput, H as CycleBlockInput, ab as LayersBlockInput, bc as ProcessBlockInput, b7 as PhotoGridInput, O as DefinitionCardInput, v as ComparisonBarInput, bf as PullQuoteInput, cb as VideoWithCaptionInput, ca as VideoPullQuoteInput, L as DataTableInput, P as DiagramBlockInput, bY as TreeBlockInput, bQ as TimelineBlockInput, X as DrawingBlockInput, am as MarkerStyle, A as AccentImage, a6 as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, az as MotionState, aw as MotionProfile, bJ as ThemeColorScheme, y as CountUpSpec, bL as ThemeRegistry, aW as PageEmphasis, bK as ThemePageStyle, V as DocDiagnostic, be as PromotedBodyAnnotation, S as DiagramTemplateNode, R as DiagramTemplateEdge, bT as TimelineTemplateTrack, bS as TimelineTemplateLink } from '../Doc-BhvotZx_.js';
-export { Y as FRONTMATTER_CUSTOM_TEMPLATES_KEY, Z as FRONTMATTER_CUSTOM_THEMES_KEY, ac as LayoutHints, bi as RenderStyle, bI as ThemeColorPalette, bO as ThemeStyle, bP as ThemeTypography, c2 as VIEWPORT_PRESETS, ce as ViewportPreset, cj as createTemplateContext, cq as getLayoutHints, ct as getTwoColumnPositions, cu as getViewport, cv as getViewportOrientation, cz as isTemplateBlock, cF as scaledFontSize } from '../Doc-BhvotZx_.js';
+import { ac as Layer, k as Block, U as Doc, bE as TemplateBlock, bF as TemplateContext, D as CustomTemplateDefinition, bH as TemplateRegistry, bN as Theme, cj as ViewportConfig, b7 as PersistentLayerConfig, aC as MotionSpec, V as DocBlock, ck as ViewportOrientation, b6 as PersistentLayer, b_ as TitleBlockInput, br as SectionHeaderInput, j as BigTextInput, w as ContentBlockInput, bx as StatHighlightInput, bl as QuoteBlockInput, a0 as FactCardInput, c7 as TwoColumnInput, M as DateEventInput, aa as ImageWithCaptionInput, ag as LeftFeatureInput, bo as RightFeatureInput, n as BottomFeatureInput, av as MediaOnlyInput, c0 as TopFeatureInput, al as MapBlockInput, bw as StartBlockConfig, a3 as FullBleedQuoteInput, aj as ListBlockInput, q as CardsBlockInput, H as CycleBlockInput, ae as LayersBlockInput, bg as ProcessBlockInput, a4 as FunnelBlockInput, a6 as HubBlockInput, aq as MatrixBlockInput, bk as PyramidBlockInput, by as StatsBlockInput, c9 as VennBlockInput, bb as PhotoGridInput, O as DefinitionCardInput, v as ComparisonBarInput, bj as PullQuoteInput, ci as VideoWithCaptionInput, ch as VideoPullQuoteInput, L as DataTableInput, P as DiagramBlockInput, c2 as TreeBlockInput, bW as TimelineBlockInput, Y as DrawingBlockInput, ap as MarkerStyle, A as AccentImage, a9 as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, aD as MotionState, aA as MotionProfile, bP as ThemeColorScheme, y as CountUpSpec, at as MediaCut, au as MediaEdits, bR as ThemeRegistry, a_ as PageEmphasis, bQ as ThemePageStyle, W as DocDiagnostic, bi as PromotedBodyAnnotation, S as DiagramTemplateNode, R as DiagramTemplateEdge, bZ as TimelineTemplateTrack, bY as TimelineTemplateLink } from '../Doc-DLfTam0R.js';
+export { Z as FRONTMATTER_CUSTOM_TEMPLATES_KEY, _ as FRONTMATTER_CUSTOM_THEMES_KEY, af as LayoutHints, bn as RenderStyle, bO as ThemeColorPalette, bU as ThemeStyle, bV as ThemeTypography, c8 as VIEWPORT_PRESETS, cl as ViewportPreset, cq as createTemplateContext, cx as getLayoutHints, cA as getTwoColumnPositions, cB as getViewport, cC as getViewportOrientation, cG as isTemplateBlock, cM as scaledFontSize } from '../Doc-DLfTam0R.js';
 import { g as BuildStep, M as MarkdownBlockNode, S as MarkdownListItem, f as BuildSpec, e as BuildCursor, h as BuildTiming, V as MarkdownNode, ae as TransitionType, ad as TransitionDirection, z as MarkdownHeading, v as MarkdownDocument, a2 as MarkdownTable, q as MarkdownCodeBlock, R as MarkdownList } from '../types-Zk8qYuaT.js';
 import { C as CoercedBlockMeta } from '../annotationCoercion-hTvELpIN.js';
-import { o as PresentationLayout, f as PageSection } from '../materializePageSection-CWxou4mX.js';
-export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, d as PageMedia, e as PageRichText, g as PageSectionDiagnostic, h as PageSectionItem, i as PageSectionMaterialization, j as PageSectionSource, k as PageSpatialKind, l as PageTransformHints, q as materializePageSection, r as materializePageSections, v as resolvePageStyle } from '../materializePageSection-CWxou4mX.js';
+import { w as PresentationLayout, g as ConceptTemplateName, m as PageSection } from '../materializePageSection-HIoRYiZu.js';
+export { C as CONCEPT_MAX_DRAWN, a as CONCEPT_SPECS, c as ConceptDowngrade, d as ConceptItemsOptions, e as ConceptSpec, f as ConceptSpecInput, M as MaterializePageSectionOptions, h as MaterializePageSectionsOptions, k as PageMedia, l as PageRichText, n as PageSectionDiagnostic, o as PageSectionItem, p as PageSectionMaterialization, q as PageSectionSource, r as PageSpatialKind, s as PageTransformHints, y as conceptDowngrade, z as conceptDrawsAs, B as conceptItemCount, D as conceptItemsProblem, F as materializePageSection, G as materializePageSections, O as resolvePageStyle } from '../materializePageSection-HIoRYiZu.js';
 import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
 import { V as ViewIssue } from '../viewState-lTZS-hP_.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BIYE6aLw.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-B2K-aAOy.js';
 
 /** Pure build planning and evaluation, shared by interactive slides and frame export. */
 
@@ -78,6 +78,10 @@ type LayerMaterializationDiagnostic = {
     code: 'unsupported-build';
     template: string;
     message: string;
+} | {
+    code: 'template-drew-nothing';
+    template: string;
+    message: string;
 } | {
     code: 'unknown-template';
     template: string;
@@ -318,6 +322,42 @@ declare const TEMPLATE_AUTHORING_METADATA: {
         readonly safeForContentFirst: false;
         readonly placement: "heading";
     };
+    readonly stats: {
+        readonly role: "highlight";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly pyramid: {
+        readonly role: "content";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly funnel: {
+        readonly role: "content";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly hub: {
+        readonly role: "content";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly venn: {
+        readonly role: "comparison";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly matrix: {
+        readonly role: "comparison";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
     readonly photoGrid: {
         readonly role: "media";
         readonly bodyPolicy: "structured";
@@ -475,7 +515,7 @@ interface TemplateGuide {
     use?: string;
 }
 /** The templates this guide describes for block-writing authors. */
-type GuidedTemplate = 'imageWithCaption' | 'pullQuote' | 'fullBleedQuote' | 'factCard' | 'dateEvent' | 'statHighlight' | 'comparisonBar' | 'columnChart' | 'barChart' | 'pieChart' | 'timeline' | 'diagram' | 'list' | 'photoGrid' | 'map' | 'sectionHeader' | 'cards' | 'process' | 'cycle' | 'layers';
+type GuidedTemplate = 'imageWithCaption' | 'pullQuote' | 'fullBleedQuote' | 'factCard' | 'dateEvent' | 'statHighlight' | 'comparisonBar' | 'columnChart' | 'barChart' | 'pieChart' | 'timeline' | 'diagram' | 'list' | 'photoGrid' | 'map' | 'sectionHeader' | 'cards' | 'process' | 'cycle' | 'layers' | 'stats' | 'pyramid' | 'funnel' | 'hub' | 'venn' | 'matrix';
 declare const TEMPLATE_GUIDES: Readonly<Record<GuidedTemplate, TemplateGuide>>;
 /** How a product names things in its prompts. */
 interface GuideWording {
@@ -504,6 +544,15 @@ declare function templateCatalog(entries: readonly TemplateCatalogEntry[], wordi
  * up to four points and pick the layout. Rendered as `"layout" (guide)`.
  */
 declare const PRESENTATION_LAYOUT_GUIDE: Readonly<Record<PresentationLayout, string>>;
+/**
+ * What to call each presentation layout in a picker, and one line on what it
+ * shows. Hosts that let a person choose a slide's layout render these rather
+ * than keeping their own copy, so a layout added here is named everywhere.
+ */
+declare const PRESENTATION_LAYOUT_LABELS: Readonly<Record<PresentationLayout, {
+    label: string;
+    description: string;
+}>>;
 /** A piece of craft an author can reuse. */
 interface AuthoringTrick {
     /** Stable id, for a product that picks tricks by name. */
@@ -515,6 +564,11 @@ interface AuthoringTrick {
      * or applies there at all.
      */
     summary?: string;
+    /**
+     * The advice for an author that only chooses each slide's layout, planning
+     * the whole deck before its slides are worded.
+     */
+    storyboard?: string;
     /** Templates (or presentation layouts) it concerns; omitted when it concerns every slide. */
     templates?: readonly string[];
 }
@@ -524,14 +578,17 @@ interface AuthoringTrickOptions {
     templates?: readonly string[];
     /** Only these tricks, in this order. */
     ids?: readonly string[];
-    /** Which text to render: for block authors (default) or summary authors. */
-    surface?: 'blocks' | 'summary';
+    /**
+     * Which text to render: for block authors (default), for summary authors,
+     * or for an author storyboarding a deck's layouts.
+     */
+    surface?: 'blocks' | 'summary' | 'storyboard';
     wording?: GuideWording;
 }
 /**
  * The tricks a prompt should carry, rendered. With `templates`, a trick is
- * kept when it concerns every slide or one of those templates; summary
- * authors get only tricks written for them.
+ * kept when it concerns every slide or one of those templates; summary and
+ * storyboard authors get only tricks written for them.
  */
 declare function authoringTricks(options?: AuthoringTrickOptions): string[];
 
@@ -775,6 +832,48 @@ declare const BLOCK_MEDIA_LAYOUT_POLICIES: {
         readonly unconsumedMedia: "reserved-slot";
         readonly variants: SupplementalMediaVariantMatrix;
     };
+    readonly stats: {
+        readonly summary: "Key figures by default; supplemental media is paired with the figures.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly pyramid: {
+        readonly summary: "A drawn pyramid by default; supplemental media is paired with the tiers.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly funnel: {
+        readonly summary: "A drawn funnel by default; supplemental media is paired with the stages.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly hub: {
+        readonly summary: "A drawn hub and spokes by default; supplemental media is paired with the ideas.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly venn: {
+        readonly summary: "Drawn overlapping circles by default; supplemental media is paired with the sets.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly matrix: {
+        readonly summary: "A two-by-two grid by default; supplemental media is paired with the grid.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
     readonly photoGrid: {
         readonly summary: "Requires a primary image collection and owns the complete tiled media field.";
         readonly noMedia: "unsupported";
@@ -1420,7 +1519,69 @@ declare function fullBleedQuote(input: FullBleedQuoteInput, context: TemplateCon
 declare function listBlock(input: ListBlockInput, context: TemplateContext): Layer[];
 
 /**
- * Concept templates — `cards`, `process` and `cycle`.
+ * Concept items — how the text of one idea is read.
+ *
+ * Every concept template (`cards`, `process`, `cycle`, `layers`, `stats`,
+ * `pyramid`, `funnel`, `hub`, `venn`, `matrix`) takes its ideas as plain
+ * strings, so a Markdown list, an AI author and a host's own script all feed
+ * them the same way. This module is the one place those strings are parsed:
+ * `Label: detail` for an idea, `Figure: what it measures` for a key number,
+ * and the item of a Venn diagram that names what its sets share.
+ *
+ * Pure text in, plain data out: the templates draw from it, and
+ * `conceptBuildStepTexts` names build steps from it, so the two agree.
+ *
+ * Related: `conceptBlocks.ts`, `conceptShapes.ts`, `recommend/listShape.ts`.
+ */
+/** One idea: an optional bold label and the words beneath it. */
+interface ConceptItem {
+    label: string;
+    detail: string;
+}
+/** Split `Label: detail` or `Label — detail`; anything else is all detail. */
+declare function splitConceptItem(text: string): ConceptItem;
+/** One key number: the figure, and the words that say what it measures. */
+interface StatItem {
+    /** The figure as written ("57 million", "95%", "$3.2B"); empty when the item has none. */
+    figure: string;
+    caption: string;
+}
+/** Whether `text` is nothing but a figure and, at most, a short unit ("2,400 km"). */
+declare function isFigureText(text: string): boolean;
+/**
+ * Read one item of a `stats` block. The figure may be the label
+ * ("57 million: deaths prevented"), the detail ("Coverage: 95%") or the
+ * item's opening words ("57 million deaths prevented"); an item without a
+ * figure is all caption.
+ */
+declare function splitStatItem(text: string): StatItem;
+/** The item that names what a Venn diagram's sets share, or -1. */
+declare function vennOverlapIndex(items: readonly ConceptItem[]): number;
+/** A matrix read from its four items: what its axes measure, and the items in reading order. */
+interface MatrixReading {
+    /** What grows from left to right. */
+    xAxis: string;
+    /** What grows from bottom to top. */
+    yAxis: string;
+    /** The items top left, top right, bottom left, bottom right. */
+    items: string[];
+    /** Whether the items had to be moved to sit where their own words put them. */
+    reordered: boolean;
+}
+/**
+ * Read a matrix's axes out of its own items. Four ideas that each say where
+ * they stand on the same two measures ("Quick wins: low effort, high impact")
+ * name the axes themselves, and say which panel each belongs in: low on the
+ * horizontal axis is left, high on the vertical axis is top. The items are
+ * returned in that order, so a panel is never drawn where its words say it
+ * is not. `undefined` when the items do not place themselves: other than
+ * four, no two shared measures, or two items claiming the same corner.
+ */
+declare function readMatrixItems(items: readonly string[]): MatrixReading | undefined;
+
+/**
+ * Concept templates — `cards`, `process`, `cycle` and `layers`, and the kit
+ * (lockup, type ramp, motion) the later ones in `conceptShapes.ts` share.
  *
  * Three ways to show a handful of related ideas as a picture of how they
  * relate rather than as a list: side-by-side cards for parallel ideas, a
@@ -1436,19 +1597,12 @@ declare function listBlock(input: ListBlockInput, context: TemplateContext): Lay
  * one at a time, and a dynamic deck times them to the narration.
  */
 
-/** One idea: an optional bold label and the words beneath it. */
-interface ConceptItem {
-    label: string;
-    detail: string;
-}
-/** Split `Label: detail` or `Label — detail`; anything else is all detail. */
-declare function splitConceptItem(text: string): ConceptItem;
 /**
  * The build steps a concept block's items become, named as `blockBuildSteps`
  * names them from the layers (a stage's number, then its label and detail),
  * so a caller can time the reveals before the block is drawn.
  */
-declare function conceptBuildStepTexts(template: 'cards' | 'process' | 'cycle' | 'layers', items: readonly string[]): string[];
+declare function conceptBuildStepTexts(template: ConceptTemplateName, items: readonly string[]): string[];
 /**
  * Parallel ideas as a row of cards (a 2×2 or 2×3 grid when there are many or
  * they run long; one column in portrait). A single unlabelled idea sets as a
@@ -1476,6 +1630,122 @@ declare function cycleBlock(input: CycleBlockInput, context: TemplateContext): L
  */
 declare function layersBlock(input: LayersBlockInput, context: TemplateContext): Layer[];
 
+/**
+ * Concept templates — `stats`, `pyramid`, `funnel`, `hub`, `venn` and `matrix`.
+ *
+ * More ways to draw how a handful of ideas relate, beside the four in
+ * `conceptBlocks.ts`: key numbers set side by side, a hierarchy stacked as a
+ * pyramid, stages that narrow as a funnel, ideas around the one thing they
+ * share, two sets and their overlap, and four ideas placed on two axes.
+ *
+ * They are built from the same kit as `cards`, `process`, `cycle` and
+ * `layers` — the headline lockup, the type ramp, the entrances — so a deck
+ * that mixes all ten reads as one design. Each item is still plain text,
+ * `Label: detail`, and still one build step.
+ *
+ * A template that cannot draw its picture from what it was given (a matrix
+ * without four ideas, a Venn diagram without two sets, key numbers without a
+ * figure) draws the same ideas as cards rather than a broken diagram.
+ *
+ * Related: `conceptBlocks.ts` (the kit), `conceptItems.ts` (how items are
+ * read), `recommend/listShape.ts` (which template a list suggests).
+ */
+
+/**
+ * Key numbers side by side: each figure large in the accent (counting up
+ * where the theme's motion counts), the word that scales it beneath
+ * ("million"), then what it measures. Up to four sit in a row, five or six
+ * three to a row; a portrait frame stacks them.
+ */
+declare function statsBlock(input: StatsBlockInput, context: TemplateContext): Layer[];
+/** A hierarchy as a pyramid: the apex first, the base last. */
+declare function pyramidBlock(input: PyramidBlockInput, context: TemplateContext): Layer[];
+/** Stages that narrow as a funnel: the widest first, the outcome last. */
+declare function funnelBlock(input: FunnelBlockInput, context: TemplateContext): Layer[];
+/**
+ * Ideas around the one thing they share: a hub (its `center` words inside
+ * it), a spoke out to each idea, and the idea's words at the end of its
+ * spoke. The ideas read down the left of the hub, then down the right; a
+ * portrait frame fans them all out to the right of it.
+ */
+declare function hubBlock(input: HubBlockInput, context: TemplateContext): Layer[];
+/**
+ * Two sets as overlapping circles: each set's label inside its own side, its
+ * detail beside it, and what the two share (an item labelled `Both:` or
+ * `Shared:`) beneath, tied to the overlap. A portrait frame lists the three
+ * under the circles.
+ */
+declare function vennBlock(input: VennBlockInput, context: TemplateContext): Layer[];
+/**
+ * Four ideas on two axes: a 2×2 of panels in reading order (top left, top
+ * right, bottom left, bottom right), with an arrow up the side for `yAxis`
+ * and one along the foot for `xAxis`.
+ */
+declare function matrixBlock(input: MatrixBlockInput, context: TemplateContext): Layer[];
+
+/**
+ * Markdown shape guide — how a Markdown author gets each drawing.
+ *
+ * An author who writes template blocks is told the fields (`TEMPLATE_GUIDES`);
+ * one who fills a headline and points is told the layouts
+ * (`PRESENTATION_LAYOUT_GUIDE`). A third kind of author writes plain Markdown
+ * and lets `markdownToDoc` choose: an agent drafting a deck for a converter,
+ * or a person who never learns an annotation. What they need to know is what
+ * in a heading and a list makes Squisq draw a picture, and that is what this
+ * module says:
+ *
+ * - {@link MARKDOWN_SHAPE_EXAMPLES}: one worked example per drawing, with the
+ *   cue that produces it. The tests run every example through
+ *   `classifyListShape`, so the guide cannot promise a drawing the classifier
+ *   does not make.
+ * - {@link markdownShapeGuide}: the lines a prompt or a tool description
+ *   carries.
+ * - {@link markdownShapeExample}: a template's example as Markdown, for a
+ *   catalog entry or a "describe this template" answer.
+ *
+ * Related: `recommend/listShape.ts` (the classifier), `conceptSpecs.ts` (what
+ * each template takes), `authoringGuide.ts` (the other two author surfaces).
+ */
+
+interface MarkdownShapeExample {
+    /** The template the example is drawn with. */
+    template: ConceptTemplateName;
+    /** What in the Markdown makes it so, as a guide line opens. */
+    cue: string;
+    /** What is drawn, as the guide line closes. */
+    drawn: string;
+    /** The same rule in a few words, for a one-paragraph summary: `[cue, drawn]`. */
+    brief: readonly [cue: string, drawn: string];
+    heading: string;
+    items: readonly string[];
+    /** Written as a numbered list. */
+    ordered?: boolean;
+    /** Annotation inputs the picture is better with; the list alone already draws. */
+    inputs?: Readonly<Record<string, string>>;
+}
+declare const MARKDOWN_SHAPE_EXAMPLES: readonly MarkdownShapeExample[];
+/**
+ * A template's worked example as Markdown: an annotated heading over the list
+ * it draws. Annotated, so it reads as "this is how you ask for it" and keeps
+ * working when the heading is changed to one that no longer names the shape.
+ * `headingLevel` sets the heading's depth (2 by default; a host that makes a
+ * slide of every level-one heading asks for 1).
+ */
+declare function markdownShapeExample(template: ConceptTemplateName, options?: {
+    headingLevel?: number;
+}): string;
+/**
+ * What a Markdown author is told about drawings, as prompt lines: the rule,
+ * what decides each picture, how to choose one outright, and what stops a
+ * list being drawn.
+ */
+declare function markdownShapeGuide(): string[];
+/**
+ * The same guide as one paragraph, for where a prompt has a sentence or two
+ * to spend (a tool's instructions, a starter prompt).
+ */
+declare function markdownShapeSummary(): string;
+
 /**
  * Photo Grid Template
  *
@@ -2475,6 +2745,10 @@ interface EmbeddedVideo {
     /** Source-media in/out points carried by inline video data attributes. */
     clipStart?: number;
     clipEnd?: number;
+    /** Source ranges the clip's edit recipe removes (`data-squisq-video-cuts`). */
+    cuts?: MediaCut[];
+    /** The clip's whole edit recipe (`data-squisq-video-*`), when it has one. */
+    edits?: MediaEdits;
 }
 /** A hosted video (YouTube, Vimeo, …) a block body stands for. */
 interface HostedVideo {
@@ -2499,12 +2773,22 @@ declare function extractHostedVideos(contents: readonly MarkdownBlockNode[] | un
  * captions and reading time must not speak diagram source or SVG markup.
  */
 declare function isPictureFence(node: MarkdownNode): boolean;
+/**
+ * A fence the author tagged ```diagram, ```tree or ```timeline whose art
+ * parses: `appendRichContentLayers` draws it as its own picture beside the
+ * block's words. Its source is box-drawing and marker art (`● Start {#start}
+ * ─────●`), so as prose it would print on the slide next to the picture it
+ * became and be read aloud by narration. An untagged fence stays code; one
+ * whose art does not parse stays visible rather than disappearing.
+ */
+declare function isSpatialPictureFence(node: MarkdownNode): boolean;
 /**
  * Body nodes that render as their own visual layer rather than as prose: a
- * picture fence ({@link isPictureFence}), a hosted-video paragraph and a
- * standalone `<video>` (players, via `appendRichContentLayers`). Repeating
- * them as body text would print the diagram source, the video's link or its
- * raw tag under the very thing they became.
+ * picture fence ({@link isPictureFence}), a tagged diagram, tree or timeline
+ * ({@link isSpatialPictureFence}), a hosted-video paragraph and a standalone
+ * `<video>` (players, via `appendRichContentLayers`). Repeating them as body
+ * text would print the diagram source, the video's link or its raw tag under
+ * the very thing they became.
  */
 declare function isMaterializedMediaNode(node: MarkdownBlockNode): boolean;
 /**
@@ -2518,6 +2802,13 @@ declare function isPictureParagraph(node: MarkdownBlockNode): boolean;
 declare function extractBodyPlainText(contents?: MarkdownBlockNode[]): string;
 /** Extract list items as plain text. */
 declare function extractListItems(contents?: MarkdownBlockNode[]): string[];
+/**
+ * List items as the ideas of a concept block. An item with sub-items reads as
+ * `Label: detail`: its own words are the label and its sub-items the detail
+ * ("Discover" over "Interview customers; Review existing data"), so a nested
+ * list draws as labelled ideas instead of one run-on line.
+ */
+declare function extractConceptItems(contents?: MarkdownBlockNode[]): string[];
 /** One authored Markdown list item with both plain and rich projections. */
 interface RichListItem {
     text: string;
@@ -2572,8 +2863,22 @@ declare function extractTableFromContents(contents?: MarkdownBlockNode[]): {
     rows: string[][];
     align?: (('left' | 'right' | 'center') | null)[];
 } | null;
-/** First blockquote's plain text, or ''. */
+/**
+ * First blockquote's plain text, or ''. Its paragraphs are joined by a
+ * space: read straight off the tree they ran together ("…moved on.— Ada").
+ */
 declare function extractBlockquoteText(contents?: MarkdownBlockNode[]): string;
+/**
+ * The first blockquote as what was said and who said it. Markdown has no
+ * syntax for an attribution, so authors write the convention: a last line (or
+ * the end of the last line) that opens with a dash. Read as part of the
+ * quote, it was set in the quote's own type and then repeated beneath it by
+ * a template's `attribution`.
+ */
+declare function extractBlockquote(contents?: MarkdownBlockNode[]): {
+    text: string;
+    attribution?: string;
+};
 interface DeriveTemplateInputsOptions {
     /**
      * Return visible placeholder values instead of `null` when an essential
@@ -2618,6 +2923,63 @@ declare function deriveTemplateInputs(templateName: string, headingText: string,
  */
 declare function coverRepeatsLeadingBlock(doc: Doc): boolean;
 
+/**
+ * A block's video sets the floor on its length.
+ *
+ * `markdownToDoc` estimates a block's duration from its text. That is right
+ * for prose and wrong for a slide that is a short caption over a clip: a
+ * heading, a line of text and a 1:40 screen recording read in three seconds,
+ * so the slide advanced — and its video, whose out-point is the block's end,
+ * stopped — three seconds in. A video plays to its own length, so the block's
+ * duration is at least the longest video it plays, measured from the block's
+ * start (a `startAt` delay counts) through the clip's played length (trim
+ * window minus cuts).
+ *
+ * ## Which videos count
+ *
+ * - Video in the block's body: a `<video>` tag, or a markdown link/image to a
+ *   video file (what {@link extractEmbeddedVideos} finds).
+ * - Video clips anchored to the block (`block.media`) that stop at its end —
+ *   not `spillover` clips (they run past the block on purpose) and not
+ *   unlocked clips (`lockToBlock: false`; those are document-timed).
+ *
+ * Audio does not count: a block over a long music bed should not hold for the
+ * whole track.
+ *
+ * ## Where a video's length comes from
+ *
+ * An authored out-point (`data-squisq-video-clip-end` / `clipEnd=`) is enough
+ * on its own. Otherwise the length is the media file's, which the pure model
+ * cannot read: hosts that can (a browser decoding the file's metadata) pass a
+ * {@link VideoDurationLookup}. Without either, the video sets no floor and the
+ * block keeps its text estimate.
+ *
+ * ## Precedence
+ *
+ * An author-pinned `duration=` wins outright. Recorded narration
+ * (`applyNarrationTiming`, run later by `resolveAudioMapping`) overwrites the
+ * blocks it times. Below both, a block lasts the longer of its reading time and
+ * its video.
+ */
+
+/**
+ * A media file's own length in seconds, keyed by the `src` the document
+ * names it with. Return undefined when the length is not known (yet).
+ */
+type VideoDurationLookup = (src: string) => number | undefined;
+/**
+ * The shortest duration that lets every video in `block` play to its end, or
+ * null when the block plays no video of known length. Ignores the block's own
+ * duration and any pin — callers decide whether the floor applies.
+ */
+declare function blockVideoLength(block: Block, lookup?: VideoDurationLookup): number | null;
+/**
+ * The video sources in `doc` whose length only the media file can tell — those
+ * with no authored out-point — in document order, without duplicates. A host
+ * measures these and passes the results to `applyVideoDurations`.
+ */
+declare function collectVideoDurationSources(doc: Doc): string[];
+
 /**
  * Markdown → Doc Conversion
  *
@@ -2685,8 +3047,15 @@ interface MarkdownToDocOptions {
      * instead of the structural `defaultTemplate`. Explicit `{[template]}`
      * annotations always win. Authors can also disable per document with
      * frontmatter `squisq-auto-templates: false`.
+     *
+     * A list is drawn as what it is a picture of when its shape is clear
+     * (`classifyListShape`): a numbered list as a `process`, dated items as a
+     * timeline, `Label: detail` items as `cards`, figures as `stats`, and a
+     * heading that says so as a `cycle`, `layers`, a `pyramid`, a `funnel`, a
+     * `hub`, a `venn` or a `matrix`. `'structural'` (frontmatter
+     * `squisq-auto-templates: structural`) keeps every list a plain `list`.
      */
-    autoTemplates?: boolean;
+    autoTemplates?: boolean | 'structural';
 }
 /**
  * Public accessor for {@link pinnedMeta}: the timing/meta values an author
@@ -2697,6 +3066,23 @@ interface MarkdownToDocOptions {
  */
 declare function getPinnedBlockMeta(block: Block): CoercedBlockMeta;
 declare function markdownToDoc(markdownDoc: MarkdownDocument, options?: MarkdownToDocOptions): Doc;
+/**
+ * Hold each block open for the videos it plays, using media lengths the pure
+ * conversion could not know (see `doc/videoTiming.ts`). `markdownToDoc`
+ * already floors blocks with an authored out-point; this adds the files'
+ * own lengths — typically measured in a browser — and re-lays the timeline
+ * (start times, caption phrases, document-timed videos, `doc.duration`)
+ * exactly as conversion does.
+ *
+ * Run it on `markdownToDoc` output, BEFORE `resolveAudioMapping`: recorded
+ * narration then re-times the blocks it covers and keeps precedence, and the
+ * re-layout here cannot disturb it. A block with a pinned `duration=` keeps it.
+ *
+ * Pure: returns `doc` itself when no block needs to grow (so memoized
+ * consumers see no change), otherwise a new Doc whose block tree is copied —
+ * the input is never mutated.
+ */
+declare function applyVideoDurations(doc: Doc, lookup: VideoDurationLookup): Doc;
 /**
  * Flatten a nested block tree into a depth-first ordered array.
  * Useful for calculating sequential timing or iterating all blocks.
@@ -4852,4 +5238,4 @@ declare function treeFromMarkdownList(list: MarkdownList): Tree;
 /** Find the first top-level markdown list in a block's body, if any. */
 declare function findFirstList(contents: MarkdownBlockNode[] | undefined): MarkdownList | undefined;
 
-export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, AUTHORING_TRICKS, type AccentLayout, type ArrangeAsciiDiagramOptions, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, type AuthoringTrick, type AuthoringTrickOptions, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, BUILTIN_DASHBOARD_LAYOUTS, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuildPreviewDocOptions, type BuildTimeline, type BuiltInTemplateName, CONTAINER_TEMPLATES, COVER_SLIDE_FRONTMATTER_KEYS, COVER_SLIDE_TEMPLATE_OPTIONS, type ChartData, type ChartTableData, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type ContentBuildPlan, type CoverBlockInput, type CoverSlidePlayback, type CoverSlideSettings, type CoverSlideTemplate, type CoverSlideTemplateOption, DASHBOARD_AUTO_LAYOUT_ID, DASHBOARD_FRONTMATTER_KEYS, DASHBOARD_STYLES, DASHBOARD_STYLE_IDS, DASHBOARD_ZOOM_LEVELS, DATA_FILE_EXTENSIONS, DEFAULT_COVER_SLIDE_SETTINGS, DEFAULT_DASHBOARD_SETTINGS, DEFAULT_DASHBOARD_STYLE, DEFAULT_LAYOUT, DEFAULT_WORD_STAGGER, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DashboardCell, type DashboardCellChrome, type DashboardCellDefinition, type DashboardCellFrame, type DashboardDiagnostic, type DashboardLayoutDefinition, type DashboardLayoutSummary, type DashboardLayoutValidationError, type DashboardLayoutValidationResult, type DashboardMaterialization, type DashboardRectPct, type DashboardSettings, type DashboardSettingsOverrides, type DashboardStyleId, type DashboardStyleSummary, type DashboardTitle, type DashboardTitleSlotDefinition, type DashboardZoomCandidate, type DashboardZoomLevel, type DashboardZoomMode, type DataFenceParseResult, type DataSourceReadOptions, type DataSourceReader, type DataSourceStats, type DataSourceTable, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, FRONTMATTER_DASHBOARD_LAYOUTS_KEY, type FirstImage, type Flashcard, type FlashcardChoice, type FlashcardDeck, type FlashcardDiagnostic, type FlashcardDiagnosticCode, type FlashcardFace, type FlashcardKind, type FlashcardSourceMode, type FrostedBigTextLayout, GEOMETRY_BOUND_TEMPLATES, type GuideWording, type GuidedTemplate, type HostedVideo, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, MAX_COVER_SLIDE_DURATION_SECONDS, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type MaterializeDashboardOptions, type MaterializeFlashcardsOptions, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PRESENTATION_LAYOUT_GUIDE, PageSection, type PageSectionContext, type PageSectionDraft, type ParsedAnnotation, type ParsedStat, PersistentLayerConfig, type PromotableDetection, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolveDataReferencesOptions, type ResolvedDashboardCell, type ResolvedDataReferences, type ResolvedPageBlock, type RichListItem, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TABLE_FED_TEMPLATES, TEMPLATE_AUTHORING_METADATA, TEMPLATE_GUIDES, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, type TemplateAuthoringMetadata, type TemplateAuthoringRole, TemplateBlock, type TemplateBodyPolicy, type TemplateCatalogEntry, TemplateContext, type TemplateGuide, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, ViewportConfig, ViewportOrientation, accentForViewport, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, arrangeAsciiDiagram, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, authoringTricks, autoTemplatePreservesContent, bigText, blockBuildSteps, bottomFeature, buildChartData, buildCursorAtTime, buildDashboardCellChrome, buildPageCss, buildPageCssVars, buildPreviewDoc, buildRegistry, buildSourceText, buildTargetState, canvasToAsciiCell, cardsBlock, chooseDashboardLayout, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, composeDashboardLayers, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, conceptBuildStepTexts, connectorPath, contentBlock, countBlocks, countUpSpecFor, coverBlock, coverRepeatsLeadingBlock, createAccentLayers, cssFilterForTreatment, cycleBlock, dashboardCanvasFill, dashboardCellAccent, dataSidecarPrefix, dataTable, dateEvent, definitionCard, deriveTemplateInputs, desiredCellZoom, detectAsciiDiagram, detectAsciiTimeline, detectPromotableBodyAnnotation, detectTree, diagramBlock, docToMarkdown, documentTitleFromFileName, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractHostedVideos, extractImages, extractListItems, extractRichListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitBigTextSize, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, formatCountUp, formatCountValue, frostedBigTextLayout, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDashboardLayoutSummaries, getDefaultAnimation, getDefaultAnimationDuration, getMotionProfile, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, guideText, hasBlockBuilds, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isDataFilePath, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isGeometryBoundTemplate, isMaterializedMediaNode, isMediaAnnotationName, isPictureFence, isPictureParagraph, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layersBlock, layoutBlock, layoutCapacity, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, listDashboardLayouts, mapBlock, markdownBlockSeparatorLines, markdownToDoc, markerPath, materializeBlockLayers, materializeDashboard, materializeFlashcards, mediaOnly, motionDelay, motionEntrance, motionStateTransform, nearestSnapPoint, normalizeChartTable, normalizeDashboardZoom, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseStandaloneAnnotation, parseStatNumber, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, planContentBuilds, previewBlockTemplate, processBlock, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, readDashboardLayoutsFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderMarkdownBlocksHtml, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveBuildTimeline, resolveColorScheme, resolveCoverSlideSettings, resolveDashboardLayoutDefinition, resolveDashboardSettings, resolveDashboardStyleId, resolveDashboardZooms, resolveDataReferences, resolveDocBuildTiming, resolveFlashcardMarker, resolveLayoutCells, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, splitConceptItem, statHighlight, stripBlockBackdropLayer, stripsBlockBackdrop, templateCatalog, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, topFeature, transformOriginFor, transposeCells, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateDashboardLayoutDefinition, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wordRevealDelay, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter, writeDashboardLayoutsToFrontmatter };
+export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, AUTHORING_TRICKS, type AccentLayout, type ArrangeAsciiDiagramOptions, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, type AuthoringTrick, type AuthoringTrickOptions, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, BUILTIN_DASHBOARD_LAYOUTS, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuildPreviewDocOptions, type BuildTimeline, type BuiltInTemplateName, CONTAINER_TEMPLATES, COVER_SLIDE_FRONTMATTER_KEYS, COVER_SLIDE_TEMPLATE_OPTIONS, type ChartData, type ChartTableData, type ClipBox, type ConceptItem, ConceptTemplateName, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type ContentBuildPlan, type CoverBlockInput, type CoverSlidePlayback, type CoverSlideSettings, type CoverSlideTemplate, type CoverSlideTemplateOption, DASHBOARD_AUTO_LAYOUT_ID, DASHBOARD_FRONTMATTER_KEYS, DASHBOARD_STYLES, DASHBOARD_STYLE_IDS, DASHBOARD_ZOOM_LEVELS, DATA_FILE_EXTENSIONS, DEFAULT_COVER_SLIDE_SETTINGS, DEFAULT_DASHBOARD_SETTINGS, DEFAULT_DASHBOARD_STYLE, DEFAULT_LAYOUT, DEFAULT_WORD_STAGGER, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DashboardCell, type DashboardCellChrome, type DashboardCellDefinition, type DashboardCellFrame, type DashboardDiagnostic, type DashboardLayoutDefinition, type DashboardLayoutSummary, type DashboardLayoutValidationError, type DashboardLayoutValidationResult, type DashboardMaterialization, type DashboardRectPct, type DashboardSettings, type DashboardSettingsOverrides, type DashboardStyleId, type DashboardStyleSummary, type DashboardTitle, type DashboardTitleSlotDefinition, type DashboardZoomCandidate, type DashboardZoomLevel, type DashboardZoomMode, type DataFenceParseResult, type DataSourceReadOptions, type DataSourceReader, type DataSourceStats, type DataSourceTable, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, FRONTMATTER_DASHBOARD_LAYOUTS_KEY, type FirstImage, type Flashcard, type FlashcardChoice, type FlashcardDeck, type FlashcardDiagnostic, type FlashcardDiagnosticCode, type FlashcardFace, type FlashcardKind, type FlashcardSourceMode, type FrostedBigTextLayout, GEOMETRY_BOUND_TEMPLATES, type GuideWording, type GuidedTemplate, type HostedVideo, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, MARKDOWN_SHAPE_EXAMPLES, MAX_COVER_SLIDE_DURATION_SECONDS, type MarkdownShapeExample, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type MaterializeDashboardOptions, type MaterializeFlashcardsOptions, type MatrixReading, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PRESENTATION_LAYOUT_GUIDE, PRESENTATION_LAYOUT_LABELS, PageSection, type PageSectionContext, type PageSectionDraft, type ParsedAnnotation, type ParsedStat, PersistentLayerConfig, type PromotableDetection, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolveDataReferencesOptions, type ResolvedDashboardCell, type ResolvedDataReferences, type ResolvedPageBlock, type RichListItem, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type StatItem, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TABLE_FED_TEMPLATES, TEMPLATE_AUTHORING_METADATA, TEMPLATE_GUIDES, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, type TemplateAuthoringMetadata, type TemplateAuthoringRole, TemplateBlock, type TemplateBodyPolicy, type TemplateCatalogEntry, TemplateContext, type TemplateGuide, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, type VideoDurationLookup, ViewportConfig, ViewportOrientation, accentForViewport, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, applyVideoDurations, arrangeAsciiDiagram, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, authoringTricks, autoTemplatePreservesContent, bigText, blockBuildSteps, blockVideoLength, bottomFeature, buildChartData, buildCursorAtTime, buildDashboardCellChrome, buildPageCss, buildPageCssVars, buildPreviewDoc, buildRegistry, buildSourceText, buildTargetState, canvasToAsciiCell, cardsBlock, chooseDashboardLayout, clipEndpoints, clipPoint, coerceTemplateParams, collectVideoDurationSources, comparisonBar, composeDashboardLayers, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, conceptBuildStepTexts, connectorPath, contentBlock, countBlocks, countUpSpecFor, coverBlock, coverRepeatsLeadingBlock, createAccentLayers, cssFilterForTreatment, cycleBlock, dashboardCanvasFill, dashboardCellAccent, dataSidecarPrefix, dataTable, dateEvent, definitionCard, deriveTemplateInputs, desiredCellZoom, detectAsciiDiagram, detectAsciiTimeline, detectPromotableBodyAnnotation, detectTree, diagramBlock, docToMarkdown, documentTitleFromFileName, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquote, extractBlockquoteText, extractBodyPlainText, extractConceptItems, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractHostedVideos, extractImages, extractListItems, extractRichListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitBigTextSize, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, formatCountUp, formatCountValue, frostedBigTextLayout, fullBleedQuote, funnelBlock, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDashboardLayoutSummaries, getDefaultAnimation, getDefaultAnimationDuration, getMotionProfile, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, guideText, hasBlockBuilds, hasTemplate, hubBlock, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isDataFilePath, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isFigureText, isGeometryBoundTemplate, isMaterializedMediaNode, isMediaAnnotationName, isPictureFence, isPictureParagraph, isRepairableDiagram, isShapeName, isSpatialPictureFence, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layersBlock, layoutBlock, layoutCapacity, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, listDashboardLayouts, mapBlock, markdownBlockSeparatorLines, markdownShapeExample, markdownShapeGuide, markdownShapeSummary, markdownToDoc, markerPath, materializeBlockLayers, materializeDashboard, materializeFlashcards, matrixBlock, mediaOnly, motionDelay, motionEntrance, motionStateTransform, nearestSnapPoint, normalizeChartTable, normalizeDashboardZoom, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseStandaloneAnnotation, parseStatNumber, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, planContentBuilds, previewBlockTemplate, processBlock, pullQuote, pyramidBlock, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, readDashboardLayoutsFromFrontmatter, readMatrixItems, renderAsciiDiagram, renderAsciiTimeline, renderMarkdownBlocksHtml, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveBuildTimeline, resolveColorScheme, resolveCoverSlideSettings, resolveDashboardLayoutDefinition, resolveDashboardSettings, resolveDashboardStyleId, resolveDashboardZooms, resolveDataReferences, resolveDocBuildTiming, resolveFlashcardMarker, resolveLayoutCells, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, splitConceptItem, splitStatItem, statHighlight, statsBlock, stripBlockBackdropLayer, stripsBlockBackdrop, templateCatalog, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, topFeature, transformOriginFor, transposeCells, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateDashboardLayoutDefinition, validateMarkdownDoc, validateMarkdownSource, vennBlock, vennOverlapIndex, videoPullQuote, videoWithCaption, wordRevealDelay, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter, writeDashboardLayoutsToFrontmatter };