@bendyline/squisq 2.12.5 → 2.13.1

package/dist/{Doc-CwmJZayl.d.ts → Doc-C7iCmmmF.d.ts}

@@ -1936,6 +1936,13 @@ interface ThemeTypography {
     titleLineHeight?: number;
     /** Default title font weight */
     titleWeight?: 'normal' | 'bold';
+    /** Font family for social (burned-in, word-by-word) captions (default: titleFont) */
+    captionFont?: FontFamily;
+    /**
+     * Letter case of social captions: `'upper'` (default) sets them in capitals;
+     * `'as-written'` keeps the narration's own casing, so names keep their capitals.
+     */
+    captionCase?: 'upper' | 'as-written';
 }
 /**
  * Global visual-style knobs that templates consult.
@@ -2708,10 +2715,58 @@ interface TextLayer extends BaseLayer {
         html?: string;
         /** Semantic steps targeted by generated data-squisq-build-step fragments. */
         buildSteps?: BuildStep[];
+        /**
+         * Optional paragraph structure, for consumers that write native
+         * paragraphs (PPTX text boxes): which paragraphs are list items, at what
+         * depth, with their text free of the marker. When present, `text` is its
+         * plain projection — each paragraph prefixed with its indent and marker
+         * (`  • item`, `2. item`), joined with `\n` — and must be kept in sync.
+         * Consumers that draw `text` as-is ignore it.
+         */
+        paragraphs?: TextParagraph[];
+        /**
+         * Marks this layer as one piece of a text flow split across layers for
+         * layout — a list drawn as a marker column beside a body column, so the
+         * SVG renderer gets a hanging indent. See {@link TextFlow}.
+         */
+        flow?: TextFlow;
         /** Text styling */
         style: TextStyle;
     };
 }
+/** One paragraph of a text layer's structured projection (`TextLayer.content.paragraphs`). */
+interface TextParagraph {
+    /**
+     * The paragraph's text, with any list marker and indent removed. May hold
+     * `\n` line breaks (they stay inside the paragraph); `''` is a blank line.
+     */
+    text: string;
+    /** Present when the paragraph is a list item. */
+    list?: TextParagraphList;
+    /** Extra space above the paragraph, in canvas px. */
+    spaceBefore?: number;
+}
+/** List-item facts for a {@link TextParagraph}. */
+interface TextParagraphList {
+    ordered: boolean;
+    /** Nesting depth; 0 is the top level. */
+    level: number;
+    /** The item's number, for an ordered item. */
+    number?: number;
+}
+/**
+ * Ties together text layers that render one flow of text. A consumer that
+ * lays text out natively (PPTX) draws the flow as ONE text box over the
+ * combined area of its layers, from the `paragraphs` of the non-marker
+ * layers in layer order, and drops the `marker` layers, whose job its own
+ * list bullets take over. Every other consumer renders each layer as usual.
+ */
+interface TextFlow {
+    /** Layers with the same id are one flow; unique within a block. */
+    id: string;
+    /** A layout-only list marker, replaced by native bullets. */
+    role?: 'marker';
+}
 /**
  * A two-stop linear gradient fill, shared by shape/path fills and text
  * backgrounds. When present it overrides the solid `fill` color.
@@ -3255,6 +3310,11 @@ interface CaptionWord {
     startTime: number;
     /** End time in seconds */
     endTime: number;
+    /**
+     * The narration text starts a new paragraph after this word, with no punctuation to
+     * show it (a spoken title or heading): captions break here as at a sentence end.
+     */
+    paragraphEnd?: boolean;
 }
 /**
  * A single caption phrase to display during playback.
@@ -3346,4 +3406,4 @@ declare function getBlockAtTime(blocks: Block[], time: number): Block | null;
  */
 declare function getCaptionAtTime(captions: CaptionTrack | undefined, time: number): CaptionPhrase | null;
 
-export { type FullBleedQuoteInput as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, type CustomTemplateValidationError as D, type CustomTemplateValidationResult as E, DARK_SURFACE as F, DEFAULT_DOC_FONT as G, DEFAULT_TITLE_FONT as H, type DataTableInput as I, type DateEventInput as J, type DeepPartial as K, type DefinitionCardInput as L, type DiagramBlockInput as M, type DiagramEdgeAnchor as N, type DiagramTemplateEdge as O, type DiagramTemplateNode as P, type Doc as Q, type DocBlock as R, type DocDiagnostic as S, type DonutChartInput as T, type DrawingBlockInput as U, FRONTMATTER_CUSTOM_TEMPLATES_KEY as V, FRONTMATTER_CUSTOM_THEMES_KEY as W, FRONTMATTER_MOTION_KEY as X, type FactCardInput as Y, type FontFamily as Z, type FontFamilyKind as _, type AccentPosition as a, type PersistentLayerTemplate as a$, type GradientBackgroundConfig as a0, type ImageBackgroundConfig as a1, type ImageLayer as a2, type ImageTreatment as a3, type ImageWithCaptionInput as a4, LIGHT_SURFACE as a5, type Layer as a6, type LayerRepeat as a7, type LayoutHints as a8, type LeftFeatureInput as a9, PAGE_EMPHASES as aA, PAGE_EYEBROWS as aB, PAGE_HEADING_CASES as aC, PAGE_HEADING_SCALES as aD, PAGE_HEADING_UNDERLINES as aE, PAGE_HERO_STYLES as aF, PAGE_IMAGE_FRAMINGS as aG, PAGE_NUMERAL_STYLES as aH, PAGE_PATTERNS as aI, PAGE_QUOTE_MARKS as aJ, PAGE_SECTION_KINDS as aK, PAGE_SECTION_SPACINGS as aL, PAGE_SHADOWS as aM, PAGE_VARIANTS as aN, type PageAccentRotation as aO, type PageBackground as aP, type PageDesignFamily as aQ, type PageEmphasis as aR, type PageHeadingTreatment as aS, type PageSectionKind as aT, type PageSectionOverride as aU, type PageTokens as aV, type PageVariant as aW, type PathLayer as aX, type PatternBackgroundConfig as aY, type PersistentLayer as aZ, type PersistentLayerConfig as a_, type LineChartInput as aa, type LinearGradient as ab, type ListBlockInput as ac, MOTION_PROFILES as ad, type MapBlockInput as ae, type MapLayer as af, type MapMarker as ag, type MapTileStyle as ah, type MarkerStyle as ai, type MediaClip as aj, type MediaCrop as ak, type MediaCut as al, type MediaEdits as am, type MediaScheduleOptions as an, type MermaidLayer as ao, type MotionEntrance as ap, type MotionOrigin as aq, type MotionProfile as ar, type MotionProfileName as as, type MotionSpec as at, type MotionState as au, PAGE_ACCENT_STRATEGIES as av, PAGE_BACKGROUNDS as aw, PAGE_BACKGROUND_RHYTHMS as ax, PAGE_DESIGN_FAMILIES as ay, PAGE_DIVIDERS as az, type AmbientGradientConfig as b, type VideoPullQuoteInput as b$, type PersistentLayerTemplateConfig as b0, type PersistentLayerTemplateType as b1, type PhotoGridInput as b2, type PieChartInput as b3, type PipStyle as b4, type Position as b5, type ProgressIndicatorConfig as b6, type PromotedBodyAnnotation as b7, type PullQuoteInput as b8, type QuoteBlockInput as b9, type ThemePageStyle as bA, type ThemeRegistry as bB, type ThemeSchemaVersion as bC, type ThemeSeedColors as bD, type ThemeStyle as bE, type ThemeTypography as bF, type TimelineBlockInput as bG, type TimelineTemplateEvent as bH, type TimelineTemplateLink as bI, type TimelineTemplateTrack as bJ, type TitleBlockInput as bK, type TitleCaptionConfig as bL, type TranscriptBlockInput as bM, type TreeBlockInput as bN, type TreeLayer as bO, type TreeLayerItem as bP, type TreeLayerStyle as bQ, type TreeTemplateItem as bR, type TwoColumnInput as bS, VIEWPORT_PRESETS as bT, type VideoEmbedLayer as bU, type VideoLayer as bV, type VideoPipPosition as bW, type VideoPipShape as bX, type VideoPipSize as bY, type VideoPlacement as bZ, type VideoPresentation as b_, type RawLayersInput as ba, type RenderStyle as bb, type RightFeatureInput as bc, type ScatterChartInput as bd, type ScheduledClip as be, type SectionHeaderInput as bf, type ShapeFilter as bg, type ShapeLayer as bh, type ShapePattern as bi, type SolidBackgroundConfig as bj, type StartBlockConfig as bk, type StatHighlightInput as bl, type SurfaceScheme as bm, type SvgLayer as bn, THEME_SCHEMA_VERSION as bo, type TableLayer as bp, type TableLayerStyle as bq, type TemplateBlock as br, type TemplateContext as bs, type TemplateFunction as bt, type TemplateRegistry as bu, type TextLayer as bv, type TextStyle as bw, type Theme as bx, type ThemeColorPalette as by, type ThemeColorScheme as bz, type Animation as c, type VideoWithCaptionInput as c0, type ViewportConfig as c1, type ViewportOrientation as c2, type ViewportPreset as c3, type VignetteConfig as c4, applySurface as c5, calculateDuration as c6, calculateFontScale as c7, createTemplateContext as c8, createTheme as c9, MEDIA_FX_ORDER as cA, MEDIA_FX_SPECS as cB, type MediaEditParamKey as cC, type MediaEditParamValues as cD, type MediaFxOp as cE, formatMediaNumber as cF, hasRenderableFx as cG, mediaEditHtmlAttribute as cH, mediaEditValuesFromAttributes as cI, mediaEditValuesFromParams as cJ, mediaRenderKey as cK, normalizeMediaCrop as cL, normalizeMediaCuts as cM, parseMediaCrop as cN, parseMediaCuts as cO, parseMediaEdits as cP, parseMediaFx as cQ, serializeMediaCrop as cR, serializeMediaCuts as cS, serializeMediaEdits as cT, serializeMediaFx as cU, createThemeRegistry as ca, getAspectRatioString as cb, getBlockAtTime as cc, getCaptionAtTime as cd, getDocPlaybackDuration as ce, getLayoutHints as cf, getSafeTextBounds as cg, getSegmentAtTime as ch, getTwoColumnPositions as ci, getViewport as cj, getViewportOrientation as ck, isCustomTemplateDefinition as cl, isMotionProfileName as cm, isPersistentLayerTemplate as cn, isTemplateBlock as co, scaledFontSize$1 as cp, readFrontmatterMotion as cq, resolveMediaSchedule as cr, resolveMotionForDoc as cs, resolveMotionProfile as ct, scaledFontSize as cu, scheduleMediaClip as cv, validateCustomTemplateDefinition as cw, type MediaFxOpId as cx, type MediaFxChain as cy, MEDIA_EDIT_PARAMS as cz, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type BigTextInput as j, type Block as k, type BlockConnection as l, type BorderStyle as m, type CaptionTrack as n, type CaptionWord as o, type ChartBaseFields as p, type ChartTemplateInput as q, type ColorScheme as r, type ColumnChartInput as s, type ComparisonBarInput as t, type ContentBlockInput as u, type CornerBrandingConfig as v, type CountUpSpec as w, type CreateTemplateContextOptions as x, type CustomTemplateDefinition as y, type CustomTemplateLayer as z };
+export { type FullBleedQuoteInput as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, type CustomTemplateValidationError as D, type CustomTemplateValidationResult as E, DARK_SURFACE as F, DEFAULT_DOC_FONT as G, DEFAULT_TITLE_FONT as H, type DataTableInput as I, type DateEventInput as J, type DeepPartial as K, type DefinitionCardInput as L, type DiagramBlockInput as M, type DiagramEdgeAnchor as N, type DiagramTemplateEdge as O, type DiagramTemplateNode as P, type Doc as Q, type DocBlock as R, type DocDiagnostic as S, type DonutChartInput as T, type DrawingBlockInput as U, FRONTMATTER_CUSTOM_TEMPLATES_KEY as V, FRONTMATTER_CUSTOM_THEMES_KEY as W, FRONTMATTER_MOTION_KEY as X, type FactCardInput as Y, type FontFamily as Z, type FontFamilyKind as _, type AccentPosition as a, type PersistentLayerTemplate as a$, type GradientBackgroundConfig as a0, type ImageBackgroundConfig as a1, type ImageLayer as a2, type ImageTreatment as a3, type ImageWithCaptionInput as a4, LIGHT_SURFACE as a5, type Layer as a6, type LayerRepeat as a7, type LayoutHints as a8, type LeftFeatureInput as a9, PAGE_EMPHASES as aA, PAGE_EYEBROWS as aB, PAGE_HEADING_CASES as aC, PAGE_HEADING_SCALES as aD, PAGE_HEADING_UNDERLINES as aE, PAGE_HERO_STYLES as aF, PAGE_IMAGE_FRAMINGS as aG, PAGE_NUMERAL_STYLES as aH, PAGE_PATTERNS as aI, PAGE_QUOTE_MARKS as aJ, PAGE_SECTION_KINDS as aK, PAGE_SECTION_SPACINGS as aL, PAGE_SHADOWS as aM, PAGE_VARIANTS as aN, type PageAccentRotation as aO, type PageBackground as aP, type PageDesignFamily as aQ, type PageEmphasis as aR, type PageHeadingTreatment as aS, type PageSectionKind as aT, type PageSectionOverride as aU, type PageTokens as aV, type PageVariant as aW, type PathLayer as aX, type PatternBackgroundConfig as aY, type PersistentLayer as aZ, type PersistentLayerConfig as a_, type LineChartInput as aa, type LinearGradient as ab, type ListBlockInput as ac, MOTION_PROFILES as ad, type MapBlockInput as ae, type MapLayer as af, type MapMarker as ag, type MapTileStyle as ah, type MarkerStyle as ai, type MediaClip as aj, type MediaCrop as ak, type MediaCut as al, type MediaEdits as am, type MediaScheduleOptions as an, type MermaidLayer as ao, type MotionEntrance as ap, type MotionOrigin as aq, type MotionProfile as ar, type MotionProfileName as as, type MotionSpec as at, type MotionState as au, PAGE_ACCENT_STRATEGIES as av, PAGE_BACKGROUNDS as aw, PAGE_BACKGROUND_RHYTHMS as ax, PAGE_DESIGN_FAMILIES as ay, PAGE_DIVIDERS as az, type AmbientGradientConfig as b, type VideoPipSize as b$, type PersistentLayerTemplateConfig as b0, type PersistentLayerTemplateType as b1, type PhotoGridInput as b2, type PieChartInput as b3, type PipStyle as b4, type Position as b5, type ProgressIndicatorConfig as b6, type PromotedBodyAnnotation as b7, type PullQuoteInput as b8, type QuoteBlockInput as b9, type Theme as bA, type ThemeColorPalette as bB, type ThemeColorScheme as bC, type ThemePageStyle as bD, type ThemeRegistry as bE, type ThemeSchemaVersion as bF, type ThemeSeedColors as bG, type ThemeStyle as bH, type ThemeTypography as bI, type TimelineBlockInput as bJ, type TimelineTemplateEvent as bK, type TimelineTemplateLink as bL, type TimelineTemplateTrack as bM, type TitleBlockInput as bN, type TitleCaptionConfig as bO, type TranscriptBlockInput as bP, type TreeBlockInput as bQ, type TreeLayer as bR, type TreeLayerItem as bS, type TreeLayerStyle as bT, type TreeTemplateItem as bU, type TwoColumnInput as bV, VIEWPORT_PRESETS as bW, type VideoEmbedLayer as bX, type VideoLayer as bY, type VideoPipPosition as bZ, type VideoPipShape as b_, type RawLayersInput as ba, type RenderStyle as bb, type RightFeatureInput as bc, type ScatterChartInput as bd, type ScheduledClip as be, type SectionHeaderInput as bf, type ShapeFilter as bg, type ShapeLayer as bh, type ShapePattern as bi, type SolidBackgroundConfig as bj, type StartBlockConfig as bk, type StatHighlightInput as bl, type SurfaceScheme as bm, type SvgLayer as bn, THEME_SCHEMA_VERSION as bo, type TableLayer as bp, type TableLayerStyle as bq, type TemplateBlock as br, type TemplateContext as bs, type TemplateFunction as bt, type TemplateRegistry as bu, type TextFlow as bv, type TextLayer as bw, type TextParagraph as bx, type TextParagraphList as by, type TextStyle as bz, type Animation as c, type VideoPlacement as c0, type VideoPresentation as c1, type VideoPullQuoteInput as c2, type VideoWithCaptionInput as c3, type ViewportConfig as c4, type ViewportOrientation as c5, type ViewportPreset as c6, type VignetteConfig as c7, applySurface as c8, calculateDuration as c9, type MediaFxOpId as cA, type MediaFxChain as cB, MEDIA_EDIT_PARAMS as cC, MEDIA_FX_ORDER as cD, MEDIA_FX_SPECS as cE, type MediaEditParamKey as cF, type MediaEditParamValues as cG, type MediaFxOp as cH, formatMediaNumber as cI, hasRenderableFx as cJ, mediaEditHtmlAttribute as cK, mediaEditValuesFromAttributes as cL, mediaEditValuesFromParams as cM, mediaRenderKey as cN, normalizeMediaCrop as cO, normalizeMediaCuts as cP, parseMediaCrop as cQ, parseMediaCuts as cR, parseMediaEdits as cS, parseMediaFx as cT, serializeMediaCrop as cU, serializeMediaCuts as cV, serializeMediaEdits as cW, serializeMediaFx as cX, calculateFontScale as ca, createTemplateContext as cb, createTheme as cc, createThemeRegistry as cd, getAspectRatioString as ce, getBlockAtTime as cf, getCaptionAtTime as cg, getDocPlaybackDuration as ch, getLayoutHints as ci, getSafeTextBounds as cj, getSegmentAtTime as ck, getTwoColumnPositions as cl, getViewport as cm, getViewportOrientation as cn, isCustomTemplateDefinition as co, isMotionProfileName as cp, isPersistentLayerTemplate as cq, isTemplateBlock as cr, scaledFontSize$1 as cs, readFrontmatterMotion as ct, resolveMediaSchedule as cu, resolveMotionForDoc as cv, resolveMotionProfile as cw, scaledFontSize as cx, scheduleMediaClip as cy, validateCustomTemplateDefinition as cz, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type BigTextInput as j, type Block as k, type BlockConnection as l, type BorderStyle as m, type CaptionTrack as n, type CaptionWord as o, type ChartBaseFields as p, type ChartTemplateInput as q, type ColorScheme as r, type ColumnChartInput as s, type ComparisonBarInput as t, type ContentBlockInput as u, type CornerBrandingConfig as v, type CountUpSpec as w, type CreateTemplateContextOptions as x, type CustomTemplateDefinition as y, type CustomTemplateLayer as z };

package/dist/{ImageEditDoc-CtRgL0wh.d.ts → ImageEditDoc-CxRHe41J.d.ts}

@@ -1,4 +1,4 @@
-import { a2 as ImageLayer, bv as TextLayer, bh as ShapeLayer, aX as PathLayer } from './Doc-CwmJZayl.js';
+import { a2 as ImageLayer, bw as TextLayer, bh as ShapeLayer, aX as PathLayer } from './Doc-C7iCmmmF.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{chunk-RHLRHRWY.js → chunk-2LTALYXX.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-FTN6SGW5.js";
 import {
   applySavedPresentation
-} from "./chunk-UN6S5OID.js";
+} from "./chunk-DCO5GYVW.js";
 import {
   SHAPE_NAMES,
   buildChartData,
@@ -32,7 +32,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-I3ENXLAN.js";
+} from "./chunk-ITLJQG7Z.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -50,10 +50,11 @@ import {
   isLineChar,
   isPictureFence,
   isVert,
+  parseAsciiDiagram,
   toCells,
   toGrid,
   traceBoxes
-} from "./chunk-GGZCJ2MS.js";
+} from "./chunk-HGCIIXHP.js";
 import {
   iconMarker
 } from "./chunk-7ZAAICW4.js";
@@ -77,7 +78,7 @@ import {
   resolveFontFamily,
   resolveTheme,
   withAlpha
-} from "./chunk-HYJ63N6V.js";
+} from "./chunk-WNEH3BZP.js";
 import {
   createMediaTimeMap
 } from "./chunk-JSGIWW35.js";
@@ -86,7 +87,7 @@ import {
 } from "./chunk-L7QZORLB.js";
 import {
   parseMarkdown
-} from "./chunk-PVFDR3XT.js";
+} from "./chunk-3A6YM375.js";
 import {
   TABLE_FED_TEMPLATES,
   TEMPLATE_ALIASES,
@@ -104,14 +105,14 @@ import {
   parseHtmlToNodes,
   parseVideoEmbedUrl,
   readFrontmatterThemeId
-} from "./chunk-MWSGNEH6.js";
+} from "./chunk-HE3HQZWU.js";
 import {
   BUILD_PARAM_KEYS,
   buildSpecParams
 } from "./chunk-P53Z4RYC.js";
 import {
   buildCaptionTrack
-} from "./chunk-4OQFLZ6G.js";
+} from "./chunk-5HWYSUXS.js";
 import {
   estimateTimeFromText
 } from "./chunk-GHOPHGOK.js";
@@ -5304,6 +5305,26 @@ function computeSideDegrees(nodes, edges) {
   }
   return deg;
 }
+function leafBoxSize(node, deg) {
+  const labelLines = normalizeLabelLines(node.label);
+  const innerW = labelLines.reduce((w, l) => Math.max(w, cellWidth(l)), 0);
+  const horizDeg = Math.max(deg.top, deg.bottom);
+  const vertDeg = Math.max(deg.left, deg.right);
+  return {
+    wCols: Math.max(node.wCols, innerW + 4, 3, horizDeg > 0 ? 2 * horizDeg + 1 : 0),
+    hRows: Math.max(node.hRows, labelLines.length + 2, 3, vertDeg > 0 ? 2 * vertDeg + 1 : 0)
+  };
+}
+function containerBoxMargins(label) {
+  const labelLines = normalizeLabelLines(label);
+  const titleLen = cellWidth(labelLines[0] ?? "");
+  const innerLinesW = labelLines.slice(1).reduce((w, l) => Math.max(w, cellWidth(l)), 0);
+  return {
+    top: 2 + Math.max(0, labelLines.length - 1),
+    side: 2,
+    minWidth: Math.max(titleLen > 0 ? titleLen + 6 : 3, innerLinesW > 0 ? innerLinesW + 4 : 3)
+  };
+}
 function layoutNodes(nodes, edges) {
   const byId = /* @__PURE__ */ new Map();
   for (const node of nodes) byId.set(node.id, node);
@@ -5357,17 +5378,8 @@ function layoutNodes(nodes, edges) {
     const labelLines = normalizeLabelLines(node.label);
     const children = childIds.get(id) ?? [];
     if (children.length === 0) {
-      const innerW = labelLines.reduce((w, l) => Math.max(w, cellWidth(l)), 0);
       const deg = sideDeg.get(id) ?? { top: 0, bottom: 0, left: 0, right: 0 };
-      const horizDeg = Math.max(deg.top, deg.bottom);
-      const vertDeg = Math.max(deg.left, deg.right);
-      const wCols = Math.max(node.wCols, innerW + 4, 3, horizDeg > 0 ? 2 * horizDeg + 1 : 0);
-      const hRows = Math.max(
-        node.hRows,
-        labelLines.length + 2,
-        3,
-        vertDeg > 0 ? 2 * vertDeg + 1 : 0
-      );
+      const { wCols, hRows } = leafBoxSize(node, deg);
       const rect2 = {
         r0: node.row,
         c0: node.col,
@@ -5379,17 +5391,14 @@ function layoutNodes(nodes, edges) {
     }
     const childRects = placeSiblings(children, (childId) => layoutSubtree(childId, depth + 1));
     const bbox = unionRects(childRects);
-    const extraRows = Math.max(0, labelLines.length - 1);
-    const titleLen = cellWidth(labelLines[0] ?? "");
+    const margins = containerBoxMargins(node.label);
     const rect = {
-      r0: bbox.r0 - 2 - extraRows,
-      c0: bbox.c0 - 2,
-      r1: bbox.r1 + 2,
-      c1: bbox.c1 + 2
+      r0: bbox.r0 - margins.top,
+      c0: bbox.c0 - margins.side,
+      r1: bbox.r1 + margins.side,
+      c1: bbox.c1 + margins.side
     };
-    const innerLinesW = labelLines.slice(1).reduce((w, l) => Math.max(w, cellWidth(l)), 0);
-    const minW = Math.max(titleLen > 0 ? titleLen + 6 : 3, innerLinesW > 0 ? innerLinesW + 4 : 3);
-    if (rect.c1 - rect.c0 + 1 < minW) rect.c1 = rect.c0 + minW - 1;
+    if (rect.c1 - rect.c0 + 1 < margins.minWidth) rect.c1 = rect.c0 + margins.minWidth - 1;
     if (rect.c1 - rect.c0 + 1 < node.wCols) rect.c1 = rect.c0 + node.wCols - 1;
     placed.set(id, { node, rect, labelLines, isContainer: true, depth });
     return rect;
@@ -6237,6 +6246,100 @@ function detectGridStyle(grid) {
   return ascii > unicode ? "ascii" : "unicode";
 }
 
+// src/doc/asciiDiagram/arrange.ts
+import { layoutGraph } from "@bendyline/squisq-graph";
+var CELL_ASPECT = 2;
+var TARGET_ASPECT = 1.6;
+function arrangeAsciiDiagram(diagram2, options = {}) {
+  if (diagram2.nodes.length === 0) return diagram2;
+  const first = options.direction ?? "down";
+  const meaning = diagramMeaning(diagram2);
+  const asRendered = diagramMeaning(parseAsciiDiagram(renderAsciiDiagram(diagram2)));
+  for (const direction of [first, first === "down" ? "right" : "down"]) {
+    const arranged = arrangeOnce(diagram2, direction);
+    const back = diagramMeaning(parseAsciiDiagram(renderAsciiDiagram(arranged)));
+    if (back === meaning || back === asRendered) return arranged;
+  }
+  return diagram2;
+}
+function diagramMeaning(d) {
+  const labelOf = new Map(d.nodes.map((n) => [n.id, n.label]));
+  const nodes = d.nodes.map((n) => JSON.stringify([n.label, n.containerId ? labelOf.get(n.containerId) : null])).sort();
+  const edges = d.edges.map((e) => {
+    const ends = [labelOf.get(e.source) ?? "", labelOf.get(e.target) ?? ""];
+    if (!e.directed) ends.sort();
+    return JSON.stringify([...ends, e.label ?? null, e.directed]);
+  }).sort();
+  return JSON.stringify([nodes, edges]);
+}
+function arrangeOnce(diagram2, direction) {
+  const ids = new Set(diagram2.nodes.map((n) => n.id));
+  const parentOf = (n) => n.containerId && n.containerId !== n.id && ids.has(n.containerId) ? n.containerId : void 0;
+  const containers = new Set(diagram2.nodes.map(parentOf).filter((p) => !!p));
+  const longestLabel = diagram2.edges.reduce((m, e) => Math.max(m, (e.label ?? "").length), 0);
+  const titleRows = diagram2.nodes.filter((n) => containers.has(n.id)).reduce((m, n) => Math.max(m, containerBoxMargins(n.label).top), 2);
+  const right = direction === "right";
+  const settings = {
+    direction,
+    integerCoordinates: true,
+    nodeSpacing: right ? 2 : 4,
+    layerSpacing: right ? Math.max(8, longestLabel + 6) : 3,
+    edgeSpacing: 2,
+    componentSpacing: right ? 4 : 2,
+    containerPadding: { top: titleRows, right: 2, bottom: 2, left: 2 },
+    aspectRatio: TARGET_ASPECT * CELL_ASPECT
+  };
+  const degrees = new Map(
+    diagram2.nodes.map((n) => [n.id, { top: 0, bottom: 0, left: 0, right: 0 }])
+  );
+  for (const e of diagram2.edges) {
+    if (e.source === e.target || !ids.has(e.source) || !ids.has(e.target)) continue;
+    degrees.get(e.source)[right ? "right" : "bottom"]++;
+    degrees.get(e.target)[right ? "left" : "top"]++;
+  }
+  let arranged = diagram2.nodes;
+  for (let pass = 0; pass < 3; pass++) {
+    const graph = {
+      nodes: diagram2.nodes.map((n) => {
+        const parent = parentOf(n);
+        if (containers.has(n.id)) {
+          return { id: n.id, width: containerBoxMargins(n.label).minWidth, height: 3, parent };
+        }
+        const size = leafBoxSize(n, degrees.get(n.id));
+        return { id: n.id, width: size.wCols, height: size.hRows, parent };
+      }),
+      edges: diagram2.edges.map((e, i) => ({ id: String(i), source: e.source, target: e.target }))
+    };
+    const result = layoutGraph(graph, settings);
+    arranged = diagram2.nodes.map((n, i) => {
+      const placed = result.nodes[i];
+      return containers.has(n.id) ? { ...n, col: placed.x, row: placed.y, wCols: graph.nodes[i].width, hRows: 3 } : { ...n, col: placed.x, row: placed.y, wCols: placed.width, hRows: placed.height };
+    });
+    let grew = false;
+    const actual = computeSideDegrees(arranged, diagram2.edges);
+    for (const n of arranged) {
+      if (containers.has(n.id)) continue;
+      const need = leafBoxSize(n, actual.get(n.id));
+      if (need.wCols > n.wCols || need.hRows > n.hRows) {
+        const d = degrees.get(n.id);
+        const a = actual.get(n.id);
+        degrees.set(n.id, {
+          top: Math.max(d.top, a.top),
+          bottom: Math.max(d.bottom, a.bottom),
+          left: Math.max(d.left, a.left),
+          right: Math.max(d.right, a.right)
+        });
+        grew = true;
+      }
+    }
+    if (!grew) break;
+  }
+  return {
+    ...diagram2,
+    nodes: [...arranged].sort((a, b) => a.row - b.row || a.col - b.col)
+  };
+}
+
 // src/doc/asciiTimeline/render.ts
 var UNICODE_VOCAB2 = {
   rail: "\u2500",
@@ -6589,6 +6692,7 @@ export {
   renderAsciiDiagram,
   isRepairableDiagram,
   repairAsciiDiagram,
+  arrangeAsciiDiagram,
   renderAsciiTimeline,
   renderTree
 };

package/dist/{chunk-PVFDR3XT.js → chunk-3A6YM375.js}

@@ -11,7 +11,7 @@ import {
   parseFrontmatter,
   parseHtmlToNodes,
   sanitizeUrl
-} from "./chunk-MWSGNEH6.js";
+} from "./chunk-HE3HQZWU.js";
 import {
   resolveIcon
 } from "./chunk-CZ7AUSLI.js";

package/dist/{chunk-4OQFLZ6G.js → chunk-5HWYSUXS.js}

@@ -8,6 +8,20 @@ var DEFAULT_TARGET_WORDS = 10;
 var DEFAULT_MIN_DURATION = 1.5;
 var DEFAULT_MAX_DURATION = 6;
 var DEFAULT_WORDS_PER_SECOND = 2.5;
+var CLOSING_MARKS = /^[.,;:!?…"'”’»)\]]+/;
+var OPENING_MARKS = /[“"‘'«([]+$/;
+function writtenWord(sourceText, bookmark, fragment) {
+  const at = bookmark.charOffset;
+  if (!sourceText || !(at >= 0)) return { text: fragment, paragraphEnd: false };
+  if (sourceText.slice(at, at + fragment.length).toLowerCase() !== fragment.toLowerCase()) {
+    return { text: fragment, paragraphEnd: false };
+  }
+  const end = at + fragment.length;
+  const before = OPENING_MARKS.exec(sourceText.slice(Math.max(0, at - 3), at))?.[0] ?? "";
+  const after = CLOSING_MARKS.exec(sourceText.slice(end, end + 4))?.[0] ?? "";
+  const paragraphEnd = /^[^\S\n]*\n/.test(sourceText.slice(end + after.length));
+  return { text: before + fragment + after, paragraphEnd };
+}
 function phrasesFromTiming(source, segmentIndex, targetWords) {
   const { segment, timing } = source;
   if (!timing || timing.bookmarks.length === 0) return [];
@@ -17,8 +31,9 @@ function phrasesFromTiming(source, segmentIndex, targetWords) {
   let phraseText = "";
   for (let index = 0; index < timing.bookmarks.length; index += 1) {
     const bookmark = timing.bookmarks[index];
-    const text = bookmark.textFragment?.trim() ?? "";
-    if (!text) continue;
+    const fragment = bookmark.textFragment?.trim() ?? "";
+    if (!fragment) continue;
+    const { text, paragraphEnd } = writtenWord(timing.sourceText, bookmark, fragment);
     const next = timing.bookmarks[index + 1];
     const startTime = Math.min(
       segmentEnd,
@@ -31,11 +46,12 @@ function phrasesFromTiming(source, segmentIndex, targetWords) {
     const word = {
       text,
       startTime,
-      endTime
+      endTime,
+      ...paragraphEnd ? { paragraphEnd: true } : {}
     };
     words.push(word);
     phraseText += `${phraseText ? " " : ""}${text}`;
-    const flush = /[.!?]$/.test(text) && words.length >= 4 || /[,;:]$/.test(text) && words.length >= targetWords - 2 || words.length >= targetWords + 3 || index === timing.bookmarks.length - 1;
+    const flush = paragraphEnd || /[.!?]$/.test(text) && words.length >= 4 || /[,;:]$/.test(text) && words.length >= targetWords - 2 || words.length >= targetWords + 3 || index === timing.bookmarks.length - 1;
     if (flush) {
       phrases.push({
         text: phraseText,

package/dist/{chunk-E2NFHYCB.js → chunk-5SVFLLOD.js}

@@ -15,7 +15,7 @@ import {
   relativeLuminance,
   resolveFontFamily,
   withAlpha
-} from "./chunk-HYJ63N6V.js";
+} from "./chunk-WNEH3BZP.js";
 import {
   SVG_ISLAND_LIMITS,
   parseBuildSpec
@@ -598,6 +598,9 @@ function compileTheme(partial, opts = {}) {
     if (partialTypography.monoFont !== void 0) {
       merged.typography.monoFont = partialTypography.monoFont;
     }
+    if (partialTypography.captionFont !== void 0) {
+      merged.typography.captionFont = partialTypography.captionFont;
+    }
   }
   if (partial.colorSchemes !== void 0) {
     merged.colorSchemes = partial.colorSchemes;

package/dist/{chunk-ILLLGZCE.js → chunk-7ZXCS3UU.js}

@@ -3,14 +3,14 @@ import {
   parseMarkdown,
   remarkWikiLinks,
   toMdast
-} from "./chunk-PVFDR3XT.js";
+} from "./chunk-3A6YM375.js";
 import {
   formatFrontmatterYaml,
   getChildren,
   splitFrontmatterBlock,
   stringifyHtmlNodes,
   walkMarkdownTree
-} from "./chunk-MWSGNEH6.js";
+} from "./chunk-HE3HQZWU.js";
 
 // src/markdown/stringify.ts
 import { unified } from "unified";

package/dist/{chunk-UN6S5OID.js → chunk-DCO5GYVW.js}

@@ -4,7 +4,7 @@ import {
   flattenRenderableBlocks,
   getPinnedBlockMeta,
   markdownToDoc
-} from "./chunk-I3ENXLAN.js";
+} from "./chunk-ITLJQG7Z.js";
 import {
   deriveTemplateInputs,
   extractImages,
@@ -12,7 +12,7 @@ import {
   isAsciiTimelineFence,
   isPictureFence,
   isTreeFence
-} from "./chunk-GGZCJ2MS.js";
+} from "./chunk-HGCIIXHP.js";
 import {
   extractContent,
   mapElementToBlock,
@@ -21,10 +21,10 @@ import {
 import {
   cloneAndFreezeData,
   isTemplateBlock
-} from "./chunk-HYJ63N6V.js";
+} from "./chunk-WNEH3BZP.js";
 import {
   parseMarkdown
-} from "./chunk-PVFDR3XT.js";
+} from "./chunk-3A6YM375.js";
 import {
   isContainerTemplate
 } from "./chunk-Y25EJEZN.js";
@@ -32,7 +32,7 @@ import {
   extractPlainText,
   getChildren,
   stringifyHtmlNodes
-} from "./chunk-MWSGNEH6.js";
+} from "./chunk-HE3HQZWU.js";
 import {
   parseBuildSpec
 } from "./chunk-P53Z4RYC.js";

package/dist/{chunk-GX3VSKYS.js → chunk-GLWQTZ4C.js}

@@ -2,7 +2,7 @@ import {
   DEFAULT_THEME,
   applySurface,
   resolveFontFamily
-} from "./chunk-HYJ63N6V.js";
+} from "./chunk-WNEH3BZP.js";
 
 // src/jsonForm/chooseControl.ts
 var ENUM_SEGMENTED_LIMIT = 4;

package/dist/{chunk-MWSGNEH6.js → chunk-HE3HQZWU.js}

@@ -176,6 +176,7 @@ function extractPlainText(node) {
   if ("value" in node && typeof node.value === "string") {
     return node.value;
   }
+  if (node.type === "break") return "\n";
   const children = getChildren(node);
   const separator = node.type === "list" || node.type === "listItem" || node.type === "table" ? "\n" : node.type === "tableRow" ? " " : "";
   return children.map(extractPlainText).join(separator);

package/dist/{chunk-GGZCJ2MS.js → chunk-HGCIIXHP.js}

@@ -8,7 +8,7 @@ import {
   parseTimeSeconds,
   sanitizeUrl,
   walkMarkdownTree
-} from "./chunk-MWSGNEH6.js";
+} from "./chunk-HE3HQZWU.js";
 
 // src/doc/asciiDiagram/chars.ts
 function toCells(s) {
@@ -1212,12 +1212,16 @@ function isLattice(diagram) {
 }
 
 // src/doc/templates/diagramLayout.ts
+import { layoutGraph } from "@bendyline/squisq-graph";
 var DEFAULT_OPTS = {
   gapX: 260,
   gapY: 140,
   gridPad: 80,
   gridOriginX: 80,
-  gridOriginY: 80
+  gridOriginY: 80,
+  nodeWidth: 180,
+  nodeHeight: 64,
+  direction: "right"
 };
 function computeDiagramLayout(children, options = {}) {
   const opts = { ...DEFAULT_OPTS, ...options };
@@ -1236,7 +1240,6 @@ function computeDiagramLayout(children, options = {}) {
     }
   }
   if (unpositionedIdx.length > 0) {
-    const cols = Math.max(1, Math.ceil(Math.sqrt(unpositionedIdx.length)));
     let baseX = opts.gridOriginX;
     let baseY = opts.gridOriginY;
     const pinned = entries.filter((e) => e.pinned);
@@ -1246,11 +1249,15 @@ function computeDiagramLayout(children, options = {}) {
       baseX = minX;
       baseY = maxY + opts.gridPad + opts.gapY;
     }
+    const placed = layeredPlacement(children, unpositionedIdx, opts);
+    const cols = Math.max(1, Math.ceil(Math.sqrt(unpositionedIdx.length)));
     unpositionedIdx.forEach((entryIdx, k) => {
-      const col = k % cols;
-      const row = Math.floor(k / cols);
-      entries[entryIdx].x = baseX + col * opts.gapX;
-      entries[entryIdx].y = baseY + row * opts.gapY;
+      const at = placed?.get(entryIdx) ?? {
+        x: k % cols * opts.gapX,
+        y: Math.floor(k / cols) * opts.gapY
+      };
+      entries[entryIdx].x = baseX + at.x;
+      entries[entryIdx].y = baseY + at.y;
     });
   }
   const nodes = entries.map((e) => ({
@@ -1284,6 +1291,44 @@ function computeDiagramLayout(children, options = {}) {
   }
   return { nodes, edges, warnings };
 }
+function layeredPlacement(children, unpositionedIdx, opts) {
+  const free = new Set(unpositionedIdx.map((i) => children[i].id));
+  const edges = [];
+  for (const i of unpositionedIdx) {
+    for (const conn of children[i].connectsTo ?? []) {
+      if (free.has(conn.target) && conn.target !== children[i].id) {
+        edges.push({ id: String(edges.length), source: children[i].id, target: conn.target });
+      }
+    }
+  }
+  if (edges.length === 0) return null;
+  const across = opts.direction === "right";
+  const result = layoutGraph(
+    {
+      nodes: unpositionedIdx.map((i) => ({
+        id: children[i].id,
+        width: opts.nodeWidth,
+        height: opts.nodeHeight
+      })),
+      edges
+    },
+    {
+      direction: opts.direction,
+      layerSpacing: Math.max(0, across ? opts.gapX - opts.nodeWidth : opts.gapY - opts.nodeHeight),
+      nodeSpacing: Math.max(0, across ? opts.gapY - opts.nodeHeight : opts.gapX - opts.nodeWidth),
+      componentSpacing: Math.max(0, opts.gapX - opts.nodeWidth),
+      // The template draws its own connectors between card sides; only the
+      // positions are used, so no room is reserved for routing tracks.
+      edgeSpacing: 1
+    }
+  );
+  const out = /* @__PURE__ */ new Map();
+  unpositionedIdx.forEach((entryIdx, k) => {
+    const n = result.nodes[k];
+    out.set(entryIdx, { x: Math.round(n.x), y: Math.round(n.y) });
+  });
+  return out;
+}
 function makeEdgeId(source, conn) {
   return conn.type ? `${source}->${conn.target}:${conn.type}` : `${source}->${conn.target}`;
 }