@bendyline/squisq 2.13.14 → 2.13.16

package/dist/narration/index.js

@@ -31,7 +31,7 @@ import {
   traceWordPosAt,
   transcriptWordKeys,
   vadStep
-} from "../chunk-OIQ2GO2O.js";
+} from "../chunk-TXN23SG2.js";
 import "../chunk-NEWNNLWN.js";
 import {
   buildNarrationTimingJson,
@@ -45,12 +45,14 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-CTT4XAGO.js";
-import "../chunk-SGNWO7OF.js";
+} from "../chunk-BG2OYBGC.js";
+import "../chunk-MA7XUCSQ.js";
 import "../chunk-FUBMT6SJ.js";
 import "../chunk-JNUNNQ74.js";
-import "../chunk-L7QZORLB.js";
-import "../chunk-7MS26OXD.js";
+import "../chunk-4R3YZTPX.js";
+import "../chunk-MTIR5PWF.js";
+import "../chunk-37RLFDIT.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,20 @@
 import {
+  classifyListShape,
+  pickAutoTemplate,
   profileBlockContents,
-  recommendTemplatesForBlock
-} from "../chunk-SGNWO7OF.js";
-import "../chunk-L7QZORLB.js";
+  recommendTemplatesForBlock,
+  shapeIsStated,
+  unstatedShapeFallback
+} from "../chunk-MA7XUCSQ.js";
+import "../chunk-4R3YZTPX.js";
+import "../chunk-37RLFDIT.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-DLfTam0R.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 taskMarker, cP as validateCustomTemplateDefinition } from '../Doc-DLfTam0R.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-B2K-aAOy.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-DdSHb6sj.js';
 
 /**
  * Runtime validation for the canonical {@link Doc} JSON shape.
@@ -299,15 +299,34 @@ declare function deriveScale(seedHex: string, spread?: number): {
 };
 
 /**
- * Translate a Squisq Theme into Mermaid's `themeVariables` vocabulary.
+ * Translate a Squisq Theme into Mermaid's theming vocabulary: `themeVariables`,
+ * plus the little `themeCSS` that covers what the variables cannot express.
  *
  * This module deliberately has no Mermaid dependency. Both the editor and
- * read-only React renderers use the returned plain object immediately before
+ * read-only React renderers use the returned plain values immediately before
  * their queued Mermaid render, keeping the two surfaces visually identical.
  */
 
 type MermaidThemeVariables = Record<string, string | number | boolean>;
 /** Build complete, contrast-aware Mermaid theme variables from a Squisq theme. */
 declare function buildMermaidThemeVariables(theme: Theme): MermaidThemeVariables;
+/**
+ * Build the CSS Mermaid needs beyond its theme variables, for the config's
+ * `themeCSS`. Pass it wherever `buildMermaidThemeVariables` is passed.
+ *
+ * Flowcharts, ER, block and requirement diagrams have one text color for every
+ * label, `nodeTextColor`, and it is chosen to read on the node fill. An edge
+ * label, or the caption beside an icon or image node, sits on the page
+ * (`edgeLabelBackground`), where that color can be the page's own: white on
+ * white in the Standard theme. Mermaid has no variable for it, so those labels
+ * are given the page's text color here.
+ *
+ * The rules name only the elements Mermaid's own rule colors (`span` for an
+ * HTML label, `text` for an SVG one) and carry no `!important`. A color the
+ * author sets (`linkStyle 0 color:red`) is written inline on those elements
+ * and still wins, and so does a host stylesheet that retints the labels for
+ * its own surface.
+ */
+declare function buildMermaidThemeCss(theme: Theme): string;
 
-export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, Doc, type DocSchemaIssue, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, type MermaidThemeVariables, type PipStyleVars, STARTER_THEME, Theme, ThemeColorPalette, ThemeColorScheme, ThemePageStyle, ThemeSeedColors, type ValidationError, type ValidationResult, accentToColorScheme, assertDocSchema, assertTheme, buildGoogleFontsUrl, buildMermaidThemeVariables, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, pipStyleVars, relativeLuminance, resolveFontFamily, serializeTheme, validateDocSchema, validateTheme, withAlpha };
+export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, Doc, type DocSchemaIssue, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, type MermaidThemeVariables, type PipStyleVars, STARTER_THEME, Theme, ThemeColorPalette, ThemeColorScheme, ThemePageStyle, ThemeSeedColors, type ValidationError, type ValidationResult, accentToColorScheme, assertDocSchema, assertTheme, buildGoogleFontsUrl, buildMermaidThemeCss, buildMermaidThemeVariables, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, pipStyleVars, relativeLuminance, resolveFontFamily, serializeTheme, validateDocSchema, validateTheme, withAlpha };

package/dist/schemas/index.js

@@ -2,24 +2,21 @@ import {
   STARTER_THEME,
   accentToColorScheme,
   assertDocSchema,
+  buildMermaidThemeCss,
   buildMermaidThemeVariables,
-  calculateDuration,
   compileTheme,
   deriveColorPalette,
-  getBlockAtTime,
-  getCaptionAtTime,
-  getSegmentAtTime,
   parseTheme,
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "../chunk-DBVCSVNV.js";
+} from "../chunk-A4ZFYGU6.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
   resolveMediaSchedule,
   scheduleMediaClip
-} from "../chunk-2SRF5III.js";
+} from "../chunk-BVL3F64S.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -98,8 +95,15 @@ import {
   validateTheme,
   withAlpha
 } from "../chunk-JNUNNQ74.js";
-import "../chunk-JSGIWW35.js";
-import "../chunk-L7QZORLB.js";
+import {
+  calculateDuration,
+  getBlockAtTime,
+  getCaptionAtTime,
+  getSegmentAtTime,
+  taskMarker
+} from "../chunk-4R3YZTPX.js";
+import "../chunk-MTIR5PWF.js";
+import "../chunk-37RLFDIT.js";
 import {
   BUILD_EFFECTS,
   BUILD_MODES,
@@ -165,6 +169,7 @@ export {
   assertDocSchema,
   assertTheme,
   buildGoogleFontsUrl,
+  buildMermaidThemeCss,
   buildMermaidThemeVariables,
   buildSpecParams,
   calculateDuration,
@@ -223,6 +228,7 @@ export {
   scaledFontSize2 as scaledFontSize,
   scheduleMediaClip,
   serializeTheme,
+  taskMarker,
   validateCustomTemplateDefinition,
   validateDocSchema,
   validateTheme,

package/dist/{themeLibrary-BIYE6aLw.d.ts → themeLibrary-B2K-aAOy.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-DLfTam0R.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-DLfTam0R.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