@bendyline/squisq 2.13.14 → 2.13.15

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   traceWordPosAt,
   transcriptWordKeys,
   vadStep
-} from "./chunk-OIQ2GO2O.js";
+} from "./chunk-2CB37BOU.js";
 import {
   fenceRendererLangs
 } from "./chunk-PGI7HSWE.js";
@@ -59,19 +59,35 @@ import {
   selectTranscriptClips
 } from "./chunk-ZP5F7LUH.js";
 import {
+  PRESENTATION_AUTHOR_LIMITS,
+  PRESENTATION_SLIDE_FORMAT,
+  PRESENTATION_STORYBOARD_FORMAT,
+  addressesAModel,
   distinctiveStems,
+  groundPresentationBeat,
   groundingSentences,
   isGroundedParaphrase,
   isVerbatimQuote,
   normalizeGroundingText,
   numbersIn,
+  presentationCorrection,
+  presentationRetryContext,
+  presentationSlidePrompt,
+  presentationSlideRequest,
+  presentationSlidesToWord,
+  presentationStoryboardPrompt,
+  presentationStoryboardRequest,
+  presentationStoryboardTokens,
+  presentationUsesStoryboard,
   rangeEndOnly,
+  readPresentationSlideReply,
+  readPresentationStoryboardReply,
   restatesHeadline,
   sourceNumbers,
   spelledNumbers,
   statedRanges,
   ungroundedNumber
-} from "./chunk-FCB6JLWB.js";
+} from "./chunk-N3FQSUVT.js";
 import {
   DATA_BACKUP_PREFIX,
   DocumentVersionManager,
@@ -250,21 +266,16 @@ import {
   validateMarkdownSource,
   wordRevealDelay,
   writeDashboardLayoutsToFrontmatter
-} from "./chunk-J2G6EOEJ.js";
+} from "./chunk-FYP7GNER.js";
 import {
   buildNarrationTimingJson,
   parseNarrationTimingJson,
   resolveNarrationTimingGenerator
 } from "./chunk-HKHOFTGM.js";
 import {
-  AUTHORED_PRESENTATION_LAYOUT,
-  CONCEPT_TEMPLATES,
   DEFAULT_TRANSFORM_STYLE_ID,
   DYNAMIC_PRESENTATION_STYLE,
   PRESENTATION_HINTS_KEY,
-  PRESENTATION_KEY,
-  PRESENTATION_LAYOUTS,
-  PRESENTATION_LIMITS,
   allocateTiming,
   analyzeBlocks,
   applySavedPresentation,
@@ -273,7 +284,6 @@ import {
   compilePresentationPlan,
   conceptBuildSpec,
   conceptRevealTiming,
-  conceptTemplate,
   createPresentationPlan,
   createTransformStyleRegistry,
   defaultPresentationHints,
@@ -282,28 +292,33 @@ import {
   getTransformStyleSummaries,
   matchPointsToSentences,
   parsePresentationHints,
-  parsePresentationPlan,
-  presentationLayoutFits,
   presentationPassageKey,
   presentationSections,
-  presentationStat,
   resolveTransformStyle,
   serializePresentationHints,
-  serializePresentationPlan,
   transformNarratedSegment,
   usesDynamicPresentation
-} from "./chunk-YQQWE4HG.js";
+} from "./chunk-OJCAKUHW.js";
 import {
+  AUTHORED_PRESENTATION_LAYOUT,
   AUTHORING_TRICKS,
   BASE_INPUT_DESCRIPTORS,
   BLOCK_MEDIA_LAYOUT_POLICIES,
+  CONCEPT_MAX_DRAWN,
+  CONCEPT_SPECS,
+  CONCEPT_TEMPLATES,
   DEFAULT_LAYOUT,
   DIAGRAM_LABEL_HORIZONTAL_PADDING,
   DIAGRAM_LABEL_LINE_HEIGHT,
   DIAGRAM_LABEL_MIN_FONT_SIZE,
   DIAGRAM_LABEL_VERTICAL_PADDING,
   GEOMETRY_BOUND_TEMPLATES,
+  MARKDOWN_SHAPE_EXAMPLES,
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
   PRESENTATION_LAYOUT_GUIDE,
+  PRESENTATION_LAYOUT_LABELS,
+  PRESENTATION_LIMITS,
   SHAPE_NAMES,
   TEMPLATE_AUTHORING_METADATA,
   TEMPLATE_GUIDES,
@@ -328,6 +343,11 @@ import {
   computeDrawingLayout,
   computeLayoutLayers,
   conceptBuildStepTexts,
+  conceptDowngrade,
+  conceptDrawsAs,
+  conceptItemCount,
+  conceptItemsProblem,
+  conceptTemplate,
   contentBlock,
   countBlocks,
   countUpSpecFor,
@@ -357,6 +377,7 @@ import {
   formatCountValue,
   frostedBigTextLayout,
   fullBleedQuote,
+  funnelBlock,
   getAccentLayout,
   getAvailableTemplates,
   getBlockBodyText,
@@ -372,6 +393,7 @@ import {
   guideText,
   hasBlockBuilds,
   hasTemplate,
+  hubBlock,
   imageWithCaption,
   isDataFence,
   isGeometryBoundTemplate,
@@ -382,20 +404,31 @@ import {
   lintTemplateParams,
   listBlock,
   mapBlock,
+  markdownShapeExample,
+  markdownShapeGuide,
+  markdownShapeSummary,
   markdownToDoc,
   materializeBlockLayers,
+  matrixBlock,
   mediaOnly,
   motionDelay,
   motionEntrance,
   normalizeChartTable,
   normalizeShapeKind,
   parseDataFence,
+  parsePresentationPlan,
   parseStatNumber,
   parseYamlSubset,
   photoGrid,
   planContentBuilds,
+  presentationBeatExtras,
+  presentationLayoutFits,
+  presentationLayoutNeeds,
+  presentationLayoutProblem,
+  presentationStat,
   processBlock,
   pullQuote,
+  pyramidBlock,
   quoteBlock,
   readCustomTemplatesFromFrontmatter,
   readCustomThemesFromFrontmatter,
@@ -407,9 +440,10 @@ import {
   rightFeature,
   scaleAnimationDuration,
   sectionHeader,
+  serializePresentationPlan,
   shouldUseShadow,
-  splitConceptItem,
   statHighlight,
+  statsBlock,
   templateCatalog,
   templateRegistry,
   themeWantsAmbientMotion,
@@ -423,6 +457,7 @@ import {
   topFeature,
   treeBlock,
   twoColumn,
+  vennBlock,
   videoPullQuote,
   videoWithCaption,
   wordIndexAtChar,
@@ -431,7 +466,7 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-CTT4XAGO.js";
+} from "./chunk-4HQ7QZKB.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -445,13 +480,16 @@ import {
   asciiTimelineToTemplateData,
   autoTemplatePreservesContent,
   canvasToAsciiCell,
+  classifyListShape,
   computeDiagramLayout,
   deriveTemplateInputs,
   detectAsciiDiagram,
   detectAsciiTimeline,
   detectTree,
+  extractBlockquote,
   extractBlockquoteText,
   extractBodyPlainText,
+  extractConceptItems,
   extractEmbeddedVideos,
   extractFirstEmbeddedVideo,
   extractFirstImage,
@@ -469,6 +507,7 @@ import {
   isExplicitDiagramLang,
   isExplicitTimelineLang,
   isExplicitTreeLang,
+  isFigureText,
   isMaterializedMediaNode,
   isMediaAnnotationName,
   isPictureFence,
@@ -482,13 +521,20 @@ import {
   parseStandaloneAnnotation,
   parseTree,
   parseWrappedFlowTimeline,
+  pickAutoTemplate,
   profileBlockContents,
+  readMatrixItems,
   recommendTemplatesForBlock,
   renderMarkdownBlocksHtml,
+  shapeIsStated,
+  splitConceptItem,
+  splitStatItem,
   treeFromMarkdownList,
   treeFromTemplateData,
-  treeToTemplateData
-} from "./chunk-SGNWO7OF.js";
+  treeToTemplateData,
+  unstatedShapeFallback,
+  vennOverlapIndex
+} from "./chunk-OFE5RZWW.js";
 import {
   extractContent,
   mapElementToBlock,
@@ -629,7 +675,7 @@ import {
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "./chunk-5DFFVW75.js";
+} from "./chunk-Y34KYMAS.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -644,13 +690,13 @@ import {
   serializePandocAttributes,
   toMdast,
   wikiLinkPath
-} from "./chunk-C4SB3NN4.js";
+} from "./chunk-DDJHIZED.js";
 import {
   CONTAINER_TEMPLATES,
   TABLE_FED_TEMPLATES,
   isContainerTemplate,
   resolveTemplateName
-} from "./chunk-7MS26OXD.js";
+} from "./chunk-UDPPWYYM.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   KNOWN_BLOCK_META_KEYS,
@@ -727,6 +773,13 @@ import {
   resolveBlockTransition,
   resolveTransitionDuration
 } from "./chunk-P53Z4RYC.js";
+import {
+  docChapters,
+  formatCaptionsSrt,
+  formatCaptionsVtt,
+  formatChaptersFfmetadata,
+  formatChaptersText
+} from "./chunk-C7DKMO4H.js";
 import {
   buildCaptionTrack
 } from "./chunk-5HWYSUXS.js";
@@ -765,6 +818,8 @@ export {
   BUILD_PARAM_KEYS,
   BUILD_PREVIOUS,
   BUILTIN_DASHBOARD_LAYOUTS,
+  CONCEPT_MAX_DRAWN,
+  CONCEPT_SPECS,
   CONCEPT_TEMPLATES,
   CONTAINER_TEMPLATES,
   COVER_SLIDE_FRONTMATTER_KEYS,
@@ -826,6 +881,7 @@ export {
   LOCAL_ONLY_RESOURCE_POLICY,
   LocalForageAdapter,
   LocalStorageAdapter,
+  MARKDOWN_SHAPE_EXAMPLES,
   MARKDOWN_SOURCE_TRANSFORMS,
   MAX_COVER_SLIDE_DURATION_SECONDS,
   MOTION_PROFILES,
@@ -853,11 +909,15 @@ export {
   PAGE_SHADOWS,
   PAGE_VARIANTS,
   PATH_SHAPE_KINDS,
+  PRESENTATION_AUTHOR_LIMITS,
   PRESENTATION_HINTS_KEY,
   PRESENTATION_KEY,
   PRESENTATION_LAYOUTS,
   PRESENTATION_LAYOUT_GUIDE,
+  PRESENTATION_LAYOUT_LABELS,
   PRESENTATION_LIMITS,
+  PRESENTATION_SLIDE_FORMAT,
+  PRESENTATION_STORYBOARD_FORMAT,
   PROOF_DIALECTS,
   PROOF_FRONTMATTER_KEYS,
   PROOF_JOIN_SEPARATOR,
@@ -885,6 +945,7 @@ export {
   accentForViewport,
   accentToColorScheme,
   addLayer,
+  addressesAModel,
   adjustY,
   advanceCoverage,
   alignNarration,
@@ -950,6 +1011,7 @@ export {
   categorizeLintKind,
   chooseControl,
   chooseDashboardLayout,
+  classifyListShape,
   cleanupMarkdownSource,
   clipEndpoints,
   clipPoint,
@@ -966,6 +1028,10 @@ export {
   computeLayoutLayers,
   conceptBuildSpec,
   conceptBuildStepTexts,
+  conceptDowngrade,
+  conceptDrawsAs,
+  conceptItemCount,
+  conceptItemsProblem,
   conceptRevealTiming,
   conceptTemplate,
   condenseMarkdownSource,
@@ -1017,6 +1083,7 @@ export {
   detectTree,
   diagramBlock,
   distinctiveStems,
+  docChapters,
   docToMarkdown,
   documentTitleFromFileName,
   downsampleTrace,
@@ -1036,8 +1103,10 @@ export {
   expandPersistentLayers,
   expectedSyllablesAt,
   exportImageEditDoc,
+  extractBlockquote,
   extractBlockquoteText,
   extractBodyPlainText,
+  extractConceptItems,
   extractContent,
   extractDocImages,
   extractEmbeddedVideos,
@@ -1068,6 +1137,10 @@ export {
   flattenRenderableBlocks,
   fontStack,
   formatBlockScalar,
+  formatCaptionsSrt,
+  formatCaptionsVtt,
+  formatChaptersFfmetadata,
+  formatChaptersText,
   formatCountUp,
   formatCountValue,
   formatFrontmatterValue,
@@ -1077,6 +1150,7 @@ export {
   fromMdast,
   frostedBigTextLayout,
   fullBleedQuote,
+  funnelBlock,
   geohashOverlapsBounds,
   geohashToHierarchicalPath,
   getAccentLayout,
@@ -1118,6 +1192,7 @@ export {
   getTwoColumnPositions,
   getViewport,
   getViewportOrientation,
+  groundPresentationBeat,
   groundingSentences,
   guessFontFallback,
   guideText,
@@ -1127,6 +1202,7 @@ export {
   hashString,
   haversineDistance,
   hexHueDegrees,
+  hubBlock,
   iconClass,
   iconGlyph,
   iconMarker,
@@ -1147,6 +1223,7 @@ export {
   isExplicitDiagramLang,
   isExplicitTimelineLang,
   isExplicitTreeLang,
+  isFigureText,
   isGeometryBoundTemplate,
   isGroundedParaphrase,
   isHex,
@@ -1187,6 +1264,9 @@ export {
   mapElementToBlock,
   mapJoinedSpanToSegment,
   markdownBlockSeparatorLines,
+  markdownShapeExample,
+  markdownShapeGuide,
+  markdownShapeSummary,
   markdownToDoc,
   markerPath,
   matchByKeywordAffinity,
@@ -1199,6 +1279,7 @@ export {
   materializeFlashcards,
   materializePageSection,
   materializePageSections,
+  matrixBlock,
   mayBeAnimatedImage,
   mediaKindForUrl,
   mediaOnly,
@@ -1253,15 +1334,28 @@ export {
   photoGrid,
   phraseOffset,
   phraseStartTime,
+  pickAutoTemplate,
   pickContrastingText,
   pipStyleVars,
   plainTextFromInlineHtml,
   planContentBuilds,
   pointerSegments,
+  presentationBeatExtras,
+  presentationCorrection,
   presentationLayoutFits,
+  presentationLayoutNeeds,
+  presentationLayoutProblem,
   presentationPassageKey,
+  presentationRetryContext,
   presentationSections,
+  presentationSlidePrompt,
+  presentationSlideRequest,
+  presentationSlidesToWord,
   presentationStat,
+  presentationStoryboardPrompt,
+  presentationStoryboardRequest,
+  presentationStoryboardTokens,
+  presentationUsesStoryboard,
   previewBlockTemplate,
   primaryType,
   processBlock,
@@ -1269,6 +1363,7 @@ export {
   pruneImageEditVersions,
   pruneVersions,
   pullQuote,
+  pyramidBlock,
   quoteAttrValue,
   quoteBlock,
   rangeEndOnly,
@@ -1280,6 +1375,9 @@ export {
   readImageEditDoc,
   readImageEditVersion,
   readImageEditVersionText,
+  readMatrixItems,
+  readPresentationSlideReply,
+  readPresentationStoryboardReply,
   readProofingSettings,
   readVersion,
   reanchorPacing,
@@ -1356,6 +1454,7 @@ export {
   setByPointer,
   setCanvas,
   setFrontmatterValues,
+  shapeIsStated,
   shapePath,
   shouldUseShadow,
   snapEndpoints,
@@ -1366,8 +1465,10 @@ export {
   splitFrontmatterBlock,
   splitIconMarkers,
   splitKeyValueToken,
+  splitStatItem,
   statHighlight,
   statedRanges,
+  statsBlock,
   stringifyHtmlNodes,
   stringifyMarkdown,
   stripBlockBackdropLayer,
@@ -1406,6 +1507,7 @@ export {
   twoColumn,
   ungroundedNumber,
   unquoteAttrValue,
+  unstatedShapeFallback,
   unwrapMarkdownSource,
   updateLayer,
   usesDynamicPresentation,
@@ -1416,6 +1518,8 @@ export {
   validateMarkdownDoc,
   validateMarkdownSource,
   validateTheme,
+  vennBlock,
+  vennOverlapIndex,
   videoEmbedFromIframe,
   videoEmbedIframeAttributes,
   videoPullQuote,

package/dist/jsonForm/index.d.ts

@@ -1,4 +1,4 @@
-import { bH as Theme, bt as SurfaceScheme } from '../Doc-BhvotZx_.js';
+import { bN as Theme, bz as SurfaceScheme } from '../Doc-C_Sh49ot.js';
 import '../types-Zk8qYuaT.js';
 
 /**

package/dist/markdown/index.js

@@ -17,7 +17,7 @@ import {
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "../chunk-5DFFVW75.js";
+} from "../chunk-Y34KYMAS.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -32,8 +32,8 @@ import {
   serializePandocAttributes,
   toMdast,
   wikiLinkPath
-} from "../chunk-C4SB3NN4.js";
-import "../chunk-7MS26OXD.js";
+} from "../chunk-DDJHIZED.js";
+import "../chunk-UDPPWYYM.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   KNOWN_BLOCK_META_KEYS,

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