@bendyline/squisq 2.4.4 → 2.5.0

package/dist/{Doc-BKKcPjfe.d.ts → Doc-DBadkoP4.d.ts}

@@ -456,6 +456,25 @@ interface SectionHeaderInput extends BaseTemplateBlock {
     /** Ambient motion for background image */
     ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';
 }
+/**
+ * Big text - thumbnail-style display card with the title in gigantic
+ * uppercase type, sized to fill the frame minus a small padding margin.
+ * With an image, the title sits over a full-bleed photo with a theme-tinted
+ * contrast bloom behind the text; without one, it sits on a clean theme
+ * surface. Shows nothing but the title — body content feeds narration only.
+ * Built for YouTube covers and social thumbnails.
+ */
+interface BigTextInput extends BaseTemplateBlock {
+    template: 'bigText';
+    /** The display text (rendered uppercase). */
+    title: string;
+    /** Optional full-bleed background image path. */
+    imageSrc?: string;
+    /** Alt text for the background image. */
+    imageAlt?: string;
+    /** Ambient motion for the background image. */
+    ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';
+}
 /**
  * Content block - loss-averse heading and body layout.
  *
@@ -1066,7 +1085,7 @@ type ChartTemplateInput = BarChartInput | ColumnChartInput | PieChartInput | Don
 /**
  * Union of all template block types.
  */
-type TemplateBlock = TitleBlockInput | SectionHeaderInput | ContentBlockInput | StatHighlightInput | QuoteBlockInput | FactCardInput | TwoColumnInput | DateEventInput | ImageWithCaptionInput | LeftFeatureInput | RightFeatureInput | MapBlockInput | FullBleedQuoteInput | ListBlockInput | PhotoGridInput | DefinitionCardInput | ComparisonBarInput | PullQuoteInput | VideoWithCaptionInput | VideoPullQuoteInput | DataTableInput | BarChartInput | ColumnChartInput | PieChartInput | DonutChartInput | LineChartInput | AreaChartInput | ScatterChartInput | DiagramBlockInput | TreeBlockInput | TimelineBlockInput | DrawingBlockInput | RawLayersInput;
+type TemplateBlock = TitleBlockInput | SectionHeaderInput | BigTextInput | ContentBlockInput | StatHighlightInput | QuoteBlockInput | FactCardInput | TwoColumnInput | DateEventInput | ImageWithCaptionInput | LeftFeatureInput | RightFeatureInput | MapBlockInput | FullBleedQuoteInput | ListBlockInput | PhotoGridInput | DefinitionCardInput | ComparisonBarInput | PullQuoteInput | VideoWithCaptionInput | VideoPullQuoteInput | DataTableInput | BarChartInput | ColumnChartInput | PieChartInput | DonutChartInput | LineChartInput | AreaChartInput | ScatterChartInput | DiagramBlockInput | TreeBlockInput | TimelineBlockInput | DrawingBlockInput | RawLayersInput;
 /**
  * A block can be either a raw Block or a TemplateBlock.
  */
@@ -2638,6 +2657,15 @@ interface TextStyle {
     padding?: number;
     /** Maximum number of lines before truncation (adds "..." to last line) */
     maxLines?: number;
+    /**
+     * Fit the rendered text to the layer's box: the renderer measures the
+     * real glyphs and scales the text down (never up) to stay inside the box,
+     * and — when vertically centered — centers the whole wrapped block on the
+     * anchor instead of hanging extra lines below it. For display type sized
+     * from estimates (e.g. the bigText template), where the actual font can
+     * run wider than any pure width model.
+     */
+    shrinkToFit?: boolean;
 }
 /**
  * Animation to apply to a layer.
@@ -2770,4 +2798,4 @@ declare function getBlockAtTime(blocks: Block[], time: number): Block | null;
  */
 declare function getCaptionAtTime(captions: CaptionTrack | undefined, time: number): CaptionPhrase | null;
 
-export { type ImageTreatment as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, DARK_SURFACE as D, DEFAULT_TITLE_FONT as E, type DataTableInput as F, type DateEventInput as G, type DeepPartial as H, type DefinitionCardInput as I, type DiagramBlockInput as J, type DiagramEdgeAnchor as K, type DiagramTemplateEdge as L, type DiagramTemplateNode as M, type Doc as N, type DocBlock as O, type DocDiagnostic as P, type DonutChartInput as Q, type DrawingBlockInput as R, FRONTMATTER_CUSTOM_TEMPLATES_KEY as S, FRONTMATTER_CUSTOM_THEMES_KEY as T, type FactCardInput as U, type FontFamily as V, type FontFamilyKind as W, type FullBleedQuoteInput as X, type GradientBackgroundConfig as Y, type ImageBackgroundConfig as Z, type ImageLayer as _, type AccentPosition as a, type SectionHeaderInput as a$, type ImageWithCaptionInput as a0, LIGHT_SURFACE as a1, type Layer as a2, type LayerRepeat as a3, type LayoutHints as a4, type LeftFeatureInput as a5, type LineChartInput as a6, type LinearGradient as a7, type ListBlockInput as a8, type MapBlockInput as a9, type PageBackground as aA, type PageDesignFamily as aB, type PageEmphasis as aC, type PageHeadingTreatment as aD, type PageSectionKind as aE, type PageSectionOverride as aF, type PageTokens as aG, type PathLayer as aH, type PatternBackgroundConfig as aI, type PersistentLayer as aJ, type PersistentLayerConfig as aK, type PersistentLayerTemplate as aL, type PersistentLayerTemplateConfig as aM, type PersistentLayerTemplateType as aN, type PhotoGridInput as aO, type PieChartInput as aP, type PipStyle as aQ, type Position as aR, type ProgressIndicatorConfig as aS, type PromotedBodyAnnotation as aT, type PullQuoteInput as aU, type QuoteBlockInput as aV, type RawLayersInput as aW, type RenderStyle as aX, type RightFeatureInput as aY, type ScatterChartInput as aZ, type ScheduledClip as a_, type MapLayer as aa, type MapMarker as ab, type MapTileStyle as ac, type MarkerStyle as ad, type MediaClip as ae, type MediaScheduleOptions as af, type MermaidLayer as ag, PAGE_ACCENT_STRATEGIES as ah, PAGE_BACKGROUNDS as ai, PAGE_BACKGROUND_RHYTHMS as aj, PAGE_DESIGN_FAMILIES as ak, PAGE_DIVIDERS as al, PAGE_EMPHASES as am, PAGE_EYEBROWS as an, PAGE_HEADING_CASES as ao, PAGE_HEADING_SCALES as ap, PAGE_HEADING_UNDERLINES as aq, PAGE_HERO_STYLES as ar, PAGE_IMAGE_FRAMINGS as as, PAGE_NUMERAL_STYLES as at, PAGE_PATTERNS as au, PAGE_QUOTE_MARKS as av, PAGE_SECTION_KINDS as aw, PAGE_SECTION_SPACINGS as ax, PAGE_SHADOWS as ay, type PageAccentRotation as az, type AmbientGradientConfig as b, getTwoColumnPositions as b$, type ShapeFilter as b0, type ShapeLayer as b1, type ShapePattern as b2, type SolidBackgroundConfig as b3, type StartBlockConfig as b4, type StatHighlightInput as b5, type SurfaceScheme as b6, THEME_SCHEMA_VERSION as b7, type TableLayer as b8, type TableLayerStyle as b9, type TwoColumnInput as bA, VIEWPORT_PRESETS as bB, type VideoLayer as bC, type VideoPipPosition as bD, type VideoPipShape as bE, type VideoPipSize as bF, type VideoPlacement as bG, type VideoPresentation as bH, type VideoPullQuoteInput as bI, type VideoWithCaptionInput as bJ, type ViewportConfig as bK, type ViewportOrientation as bL, type ViewportPreset as bM, type VignetteConfig as bN, applySurface as bO, calculateDuration as bP, calculateFontScale as bQ, createTemplateContext as bR, createTheme as bS, createThemeRegistry as bT, getAspectRatioString as bU, getBlockAtTime as bV, getCaptionAtTime as bW, getDocPlaybackDuration as bX, getLayoutHints as bY, getSafeTextBounds as bZ, getSegmentAtTime as b_, type TemplateBlock as ba, type TemplateContext as bb, type TemplateFunction as bc, type TemplateRegistry as bd, type TextLayer as be, type TextStyle as bf, type Theme as bg, type ThemeColorPalette as bh, type ThemeColorScheme as bi, type ThemePageStyle as bj, type ThemeRegistry as bk, type ThemeSchemaVersion as bl, type ThemeSeedColors as bm, type ThemeStyle as bn, type ThemeTypography as bo, type TimelineBlockInput as bp, type TimelineTemplateEvent as bq, type TimelineTemplateLink as br, type TimelineTemplateTrack as bs, type TitleBlockInput as bt, type TitleCaptionConfig as bu, type TreeBlockInput as bv, type TreeLayer as bw, type TreeLayerItem as bx, type TreeLayerStyle as by, type TreeTemplateItem as bz, type Animation as c, getViewport as c0, getViewportOrientation as c1, isCustomTemplateDefinition as c2, isPersistentLayerTemplate as c3, isTemplateBlock as c4, scaledFontSize$1 as c5, resolveMediaSchedule as c6, scaledFontSize as c7, validateCustomTemplateDefinition as c8, 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 Block as j, type BlockConnection as k, type BorderStyle as l, type CaptionTrack as m, type CaptionWord as n, type ChartBaseFields as o, type ChartTemplateInput as p, type ColorScheme as q, type ColumnChartInput as r, type ComparisonBarInput as s, type ContentBlockInput as t, type CornerBrandingConfig as u, type CustomTemplateDefinition as v, type CustomTemplateLayer as w, type CustomTemplateValidationError as x, type CustomTemplateValidationResult as y, DEFAULT_DOC_FONT as z };
+export { type ImageLayer as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, DARK_SURFACE as D, DEFAULT_DOC_FONT as E, DEFAULT_TITLE_FONT as F, type DataTableInput as G, type DateEventInput as H, type DeepPartial as I, type DefinitionCardInput as J, type DiagramBlockInput as K, type DiagramEdgeAnchor as L, type DiagramTemplateEdge as M, type DiagramTemplateNode as N, type Doc as O, type DocBlock as P, type DocDiagnostic as Q, type DonutChartInput as R, type DrawingBlockInput as S, FRONTMATTER_CUSTOM_TEMPLATES_KEY as T, FRONTMATTER_CUSTOM_THEMES_KEY as U, type FactCardInput as V, type FontFamily as W, type FontFamilyKind as X, type FullBleedQuoteInput as Y, type GradientBackgroundConfig as Z, type ImageBackgroundConfig as _, type AccentPosition as a, type ScheduledClip as a$, type ImageTreatment as a0, type ImageWithCaptionInput as a1, LIGHT_SURFACE as a2, type Layer as a3, type LayerRepeat as a4, type LayoutHints as a5, type LeftFeatureInput as a6, type LineChartInput as a7, type LinearGradient as a8, type ListBlockInput as a9, type PageAccentRotation as aA, type PageBackground as aB, type PageDesignFamily as aC, type PageEmphasis as aD, type PageHeadingTreatment as aE, type PageSectionKind as aF, type PageSectionOverride as aG, type PageTokens as aH, type PathLayer as aI, type PatternBackgroundConfig as aJ, type PersistentLayer as aK, type PersistentLayerConfig as aL, type PersistentLayerTemplate as aM, type PersistentLayerTemplateConfig as aN, type PersistentLayerTemplateType as aO, type PhotoGridInput as aP, type PieChartInput as aQ, type PipStyle as aR, type Position as aS, type ProgressIndicatorConfig as aT, type PromotedBodyAnnotation as aU, type PullQuoteInput as aV, type QuoteBlockInput as aW, type RawLayersInput as aX, type RenderStyle as aY, type RightFeatureInput as aZ, type ScatterChartInput as a_, type MapBlockInput as aa, type MapLayer as ab, type MapMarker as ac, type MapTileStyle as ad, type MarkerStyle as ae, type MediaClip as af, type MediaScheduleOptions as ag, type MermaidLayer as ah, PAGE_ACCENT_STRATEGIES as ai, PAGE_BACKGROUNDS as aj, PAGE_BACKGROUND_RHYTHMS as ak, PAGE_DESIGN_FAMILIES as al, PAGE_DIVIDERS as am, PAGE_EMPHASES as an, PAGE_EYEBROWS as ao, PAGE_HEADING_CASES as ap, PAGE_HEADING_SCALES as aq, PAGE_HEADING_UNDERLINES as ar, PAGE_HERO_STYLES as as, PAGE_IMAGE_FRAMINGS as at, PAGE_NUMERAL_STYLES as au, PAGE_PATTERNS as av, PAGE_QUOTE_MARKS as aw, PAGE_SECTION_KINDS as ax, PAGE_SECTION_SPACINGS as ay, PAGE_SHADOWS as az, type AmbientGradientConfig as b, getSegmentAtTime as b$, type SectionHeaderInput as b0, type ShapeFilter as b1, type ShapeLayer as b2, type ShapePattern as b3, type SolidBackgroundConfig as b4, type StartBlockConfig as b5, type StatHighlightInput as b6, type SurfaceScheme as b7, THEME_SCHEMA_VERSION as b8, type TableLayer as b9, type TreeTemplateItem as bA, type TwoColumnInput as bB, VIEWPORT_PRESETS as bC, type VideoLayer as bD, type VideoPipPosition as bE, type VideoPipShape as bF, type VideoPipSize as bG, type VideoPlacement as bH, type VideoPresentation as bI, type VideoPullQuoteInput as bJ, type VideoWithCaptionInput as bK, type ViewportConfig as bL, type ViewportOrientation as bM, type ViewportPreset as bN, type VignetteConfig as bO, applySurface as bP, calculateDuration as bQ, calculateFontScale as bR, createTemplateContext as bS, createTheme as bT, createThemeRegistry as bU, getAspectRatioString as bV, getBlockAtTime as bW, getCaptionAtTime as bX, getDocPlaybackDuration as bY, getLayoutHints as bZ, getSafeTextBounds as b_, type TableLayerStyle as ba, type TemplateBlock as bb, type TemplateContext as bc, type TemplateFunction as bd, type TemplateRegistry as be, type TextLayer as bf, type TextStyle as bg, type Theme as bh, type ThemeColorPalette as bi, type ThemeColorScheme as bj, type ThemePageStyle as bk, type ThemeRegistry as bl, type ThemeSchemaVersion as bm, type ThemeSeedColors as bn, type ThemeStyle as bo, type ThemeTypography as bp, type TimelineBlockInput as bq, type TimelineTemplateEvent as br, type TimelineTemplateLink as bs, type TimelineTemplateTrack as bt, type TitleBlockInput as bu, type TitleCaptionConfig as bv, type TreeBlockInput as bw, type TreeLayer as bx, type TreeLayerItem as by, type TreeLayerStyle as bz, type Animation as c, getTwoColumnPositions as c0, getViewport as c1, getViewportOrientation as c2, isCustomTemplateDefinition as c3, isPersistentLayerTemplate as c4, isTemplateBlock as c5, scaledFontSize$1 as c6, resolveMediaSchedule as c7, scaledFontSize as c8, validateCustomTemplateDefinition as c9, 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 CustomTemplateDefinition as w, type CustomTemplateLayer as x, type CustomTemplateValidationError as y, type CustomTemplateValidationResult as z };

package/dist/{ImageEditDoc-CU1cXxRd.d.ts → ImageEditDoc-Cq2a3c30.d.ts}

@@ -1,4 +1,4 @@
-import { _ as ImageLayer, be as TextLayer, b1 as ShapeLayer, aH as PathLayer } from './Doc-BKKcPjfe.js';
+import { $ as ImageLayer, bf as TextLayer, b2 as ShapeLayer, aI as PathLayer } from './Doc-DBadkoP4.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{chunk-YQW6AQBV.js → chunk-6MVWWZHL.js}

@@ -6,7 +6,7 @@ import {
   quoteAttrValue,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-O3LLD7HG.js";
+} from "./chunk-NBKAXPSX.js";
 import {
   resolveIcon
 } from "./chunk-7N4G32LG.js";

package/dist/{chunk-GGTDYLW4.js → chunk-7Z5T3CUI.js}

@@ -1,7 +1,7 @@
 import {
   expectedSyllablesAt,
   wordPosAtExpectedSyllables
-} from "./chunk-OIIIHI3Y.js";
+} from "./chunk-GSJEGMKF.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({

package/dist/{chunk-OIIIHI3Y.js → chunk-GSJEGMKF.js}

@@ -56,7 +56,7 @@ import {
   sanitizeUrl,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-O3LLD7HG.js";
+} from "./chunk-NBKAXPSX.js";
 import {
   extractPlainText,
   readFrontmatterThemeId,
@@ -934,6 +934,138 @@ function sectionHeader(input, context) {
   return layers;
 }
 
+// src/doc/templates/bigText.ts
+var BIG_TEXT_LINE_HEIGHT = 1.05;
+var BIG_TEXT_WIDTH_FRACTION = 0.92;
+var BIG_TEXT_HEIGHT_FRACTION = 0.86;
+var BIG_TEXT_CHAR_WIDTH = 0.62;
+var BIG_TEXT_MIN_PX = 48;
+function wrappedLineCount(wordLengths, charsPerLine) {
+  let lines = 1;
+  let current = 0;
+  for (const length of wordLengths) {
+    const withWord = current === 0 ? length : current + 1 + length;
+    if (withWord <= charsPerLine) {
+      current = withWord;
+    } else {
+      lines += 1;
+      current = length;
+    }
+  }
+  return lines;
+}
+function fitBigTextSize(title, viewport) {
+  const availWidth = viewport.width * BIG_TEXT_WIDTH_FRACTION;
+  const availHeight = viewport.height * BIG_TEXT_HEIGHT_FRACTION;
+  const wordLengths = title.trim().split(/\s+/).filter(Boolean).map((word) => word.length);
+  if (wordLengths.length === 0) return Math.floor(availHeight / BIG_TEXT_LINE_HEIGHT);
+  const longestWord = Math.max(...wordLengths);
+  const widthCap = availWidth / (BIG_TEXT_CHAR_WIDTH * longestWord);
+  const singleLineCap = availHeight / BIG_TEXT_LINE_HEIGHT;
+  const fits = (size) => {
+    const charsPerLine = Math.max(1, Math.floor(availWidth / (size * BIG_TEXT_CHAR_WIDTH)));
+    const lines = wrappedLineCount(wordLengths, charsPerLine);
+    return lines * size * BIG_TEXT_LINE_HEIGHT <= availHeight;
+  };
+  let low = BIG_TEXT_MIN_PX;
+  let high = Math.min(widthCap, singleLineCap);
+  if (high <= low) return Math.max(BIG_TEXT_MIN_PX, Math.floor(high));
+  if (!fits(low)) return BIG_TEXT_MIN_PX;
+  for (let i = 0; i < 24; i += 1) {
+    const mid = (low + high) / 2;
+    if (fits(mid)) low = mid;
+    else high = mid;
+  }
+  return Math.floor(low);
+}
+function bigTextBloom(background) {
+  return `radial-gradient(ellipse at 50% 50%, ${withAlpha(background, 0.92)} 0%, ${withAlpha(background, 0.78)} 38%, ${withAlpha(background, 0.32)} 66%, ${withAlpha(background, 0)} 88%)`;
+}
+function bigText(input, context) {
+  const { title = "", imageSrc, imageAlt, ambientMotion } = input;
+  const { theme, viewport } = context;
+  const treatment = themedImageTreatment(context, input.imageTreatment);
+  const displayTitle = title.toUpperCase();
+  const titleFontSize = fitBigTextSize(displayTitle, viewport);
+  const layers = [];
+  if (imageSrc) {
+    layers.push(
+      {
+        type: "image",
+        id: "bigtext-image",
+        content: {
+          src: imageSrc,
+          alt: imageAlt || title,
+          fit: "cover",
+          ...treatment ? { treatment } : {}
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" },
+        animation: mapAmbientMotion(ambientMotion, 8) ?? {
+          type: "slowZoom",
+          duration: 8,
+          direction: "in"
+        }
+      },
+      {
+        type: "shape",
+        id: "bigtext-bloom",
+        content: {
+          shape: "rect",
+          fill: bigTextBloom(theme.colors.background)
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" }
+      }
+    );
+  } else {
+    layers.push(
+      {
+        type: "shape",
+        id: "bigtext-bg",
+        content: {
+          shape: "rect",
+          fill: theme.colors.background
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" }
+      },
+      {
+        type: "shape",
+        id: "bigtext-tint",
+        content: {
+          shape: "rect",
+          fill: `radial-gradient(ellipse at 50% 50%, ${withAlpha(theme.colors.primary, 0.38)} 0%, ${withAlpha(theme.colors.primary, 0.14)} 48%, ${withAlpha(theme.colors.primary, 0)} 78%)`
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" }
+      }
+    );
+  }
+  layers.push({
+    type: "text",
+    id: "bigtext-title",
+    content: {
+      text: displayTitle,
+      style: {
+        fontSize: titleFontSize,
+        fontFamily: getThemeFont(context, "title"),
+        fontWeight: "bold",
+        color: theme.colors.text,
+        textAlign: "center",
+        lineHeight: BIG_TEXT_LINE_HEIGHT,
+        shadow: !!imageSrc,
+        shrinkToFit: true
+      }
+    },
+    position: {
+      x: "50%",
+      y: "50%",
+      anchor: "center",
+      width: `${BIG_TEXT_WIDTH_FRACTION * 100}%`,
+      height: `${BIG_TEXT_HEIGHT_FRACTION * 100}%`
+    },
+    animation: themedEntrance(context, "text", { type: "fadeIn", duration: 1 })
+  });
+  return layers;
+}
+
 // src/doc/templates/contentBlock.ts
 function completeBodyText(context) {
   return (context.block?.contents ?? []).filter((node) => !(node.type === "code" && node.lang?.trim().toLowerCase() === "mermaid")).map((node) => extractPlainText(node)).join("\n").trim();
@@ -2763,6 +2895,13 @@ function deriveTemplateInputs(templateName, headingText, contents, options = {})
       if (!img) return placeholders ? { caption: headingText } : null;
       return { imageSrc: img.src, imageAlt: img.alt || headingText, caption: headingText };
     }
+    case "bigText": {
+      const img = extractFirstImage(contents);
+      return {
+        title: headingText,
+        ...img ? { imageSrc: img.src, imageAlt: img.alt || headingText } : {}
+      };
+    }
     case "photoGrid": {
       const images = extractImages(contents, 4);
       if (images.length < 2) return placeholders ? {} : null;
@@ -3773,9 +3912,9 @@ function fitDiagramLabel(text, boxWidth, boxHeight, preferredFontSize) {
   };
 }
 function countWrappedLines(text, fontSize, maxWidth) {
-  return text.split("\n").reduce((count, line) => count + wrappedLineCount(line, fontSize, maxWidth), 0);
+  return text.split("\n").reduce((count, line) => count + wrappedLineCount2(line, fontSize, maxWidth), 0);
 }
-function wrappedLineCount(text, fontSize, maxWidth) {
+function wrappedLineCount2(text, fontSize, maxWidth) {
   if (!text.trim()) return 1;
   const charsPerLine = Math.floor(maxWidth / (fontSize * 0.5));
   if (charsPerLine <= 0) return 1;
@@ -6621,6 +6760,7 @@ function scatterChart(input, context) {
 var templateRegistry = {
   title: titleBlock,
   sectionHeader,
+  bigText,
   content: contentBlock,
   statHighlight,
   quote: quoteBlock,
@@ -6835,6 +6975,12 @@ var TEMPLATE_INPUT_DESCRIPTORS = {
     { key: "imageAlt", description: "Alt text for the background image" },
     { key: "ambientMotion", description: "Slow zoom/pan effect", values: AMBIENT_MOTION_VALUES }
   ],
+  bigText: [
+    { key: "title", description: "The display text (rendered uppercase)" },
+    { key: "imageSrc", description: "Optional full-bleed background image path" },
+    { key: "imageAlt", description: "Alt text for the background image" },
+    { key: "ambientMotion", description: "Slow zoom/pan effect", values: AMBIENT_MOTION_VALUES }
+  ],
   content: [{ key: "title", description: "Heading shown above the complete body" }],
   statHighlight: [
     { key: "stat", description: 'The statistic (e.g. "89%", "2x")' },
@@ -7251,6 +7397,15 @@ var BLOCK_MEDIA_LAYOUT_POLICIES = {
     unconsumedMedia: "reserve-when-no-native-media",
     variants: TITLE_VARIANTS
   },
+  bigText: {
+    summary: "Uses its authored background image (behind a contrast bloom) when present; otherwise renders gigantic text on the theme surface.",
+    noMedia: "template-without-optional-media",
+    ownership: "optional-native",
+    nativeLayout: "background-image",
+    additionalMediaLayout: "overlay-inset",
+    unconsumedMedia: "reserve-when-no-native-media",
+    variants: TITLE_VARIANTS
+  },
   content: {
     summary: "Preserves the complete heading and body; supplemental media receives a companion field.",
     noMedia: "template-default",
@@ -8392,6 +8547,10 @@ var TEMPLATE_METADATA = {
     label: "Section Header",
     description: "A clean section break with a prominent title and optional background image."
   },
+  bigText: {
+    label: "Big Text",
+    description: "Gigantic uppercase display text \u2014 thumbnail-style \u2014 on a theme surface or over an image with a contrast bloom."
+  },
   content: {
     label: "Content",
     description: "Shows a heading and the complete body in a loss-averse content-first layout."
@@ -8532,6 +8691,12 @@ var TEMPLATE_AUTHORING_METADATA = {
     safeForContentFirst: false,
     placement: "heading"
   },
+  bigText: {
+    role: "opener",
+    bodyPolicy: "ignored",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
   content: {
     role: "content",
     bodyPolicy: "complete",
@@ -8883,8 +9048,81 @@ function startBlockToCoverInput(config) {
     heroLicense: config.heroLicense
   };
 }
-function expandCoverBlock(config, context) {
+function expandCoverBlock(config, context, template = "cover") {
   const input = startBlockToCoverInput(config);
+  const base = {
+    id: "cover-block",
+    duration: 0,
+    audioSegment: -1
+  };
+  if (template === "title") {
+    return titleBlock(
+      {
+        ...base,
+        template: "title",
+        title: input.title,
+        subtitle: input.subtitle
+      },
+      context
+    );
+  }
+  if (template === "sectionHeader") {
+    return sectionHeader(
+      {
+        ...base,
+        template: "sectionHeader",
+        title: input.title,
+        imageSrc: input.heroSrc,
+        imageAlt: input.heroAlt,
+        ambientMotion: input.ambientMotion
+      },
+      context
+    );
+  }
+  if (template === "bigText" || template === "bigTextImage") {
+    const useHero = template === "bigTextImage" && !!input.heroSrc;
+    return bigText(
+      {
+        ...base,
+        template: "bigText",
+        title: input.title,
+        ...useHero ? {
+          imageSrc: input.heroSrc,
+          imageAlt: input.heroAlt ?? input.title,
+          ambientMotion: input.ambientMotion
+        } : {}
+      },
+      context
+    );
+  }
+  if (template === "imageWithCaption") {
+    if (!input.heroSrc) {
+      return titleBlock(
+        {
+          ...base,
+          template: "title",
+          title: input.title,
+          subtitle: input.subtitle
+        },
+        context
+      );
+    }
+    return imageWithCaption(
+      {
+        ...base,
+        template: "imageWithCaption",
+        imageSrc: input.heroSrc,
+        imageAlt: input.heroAlt ?? input.title,
+        caption: input.title,
+        subtitle: input.subtitle,
+        ambientMotion: input.ambientMotion,
+        imageCredit: input.heroCredit,
+        imageLicense: input.heroLicense,
+        isTitle: true
+      },
+      context
+    );
+  }
   return coverBlock(input, context);
 }
 
@@ -10141,7 +10379,7 @@ function markdownToDoc(markdownDoc, options) {
     ...documentMedia.length > 0 ? { documentMedia } : {}
   };
   if (options?.generateCoverBlock ?? true) {
-    const coverConfig = buildStartBlock(markdownDoc, rootBlocks);
+    const coverConfig = buildStartBlock(markdownDoc, rootBlocks, options?.fileName);
     if (coverConfig) {
       doc.startBlock = coverConfig;
     }
@@ -10391,12 +10629,35 @@ function findFirstImage(node) {
   }
   return void 0;
 }
-function buildStartBlock(markdownDoc, rootBlocks) {
-  const firstH1 = rootBlocks.find((b) => b.sourceHeading?.depth === 1);
-  if (!firstH1) return void 0;
-  const title = firstH1.title ?? extractPlainText(firstH1.sourceHeading);
+function shallowestHeadingBlock(rootBlocks) {
+  let best;
+  for (const block of rootBlocks) {
+    const depth = block.sourceHeading?.depth;
+    if (depth === void 0) continue;
+    const title = block.title ?? extractPlainText(block.sourceHeading);
+    if (!title) continue;
+    if (!best || depth < best.sourceHeading.depth) {
+      best = block;
+      if (depth === 1) break;
+    }
+  }
+  return best;
+}
+function fileNameCoverTitle(fileName) {
+  if (!fileName) return void 0;
+  const base = fileName.split(/[\\/]/).pop() ?? "";
+  const stem = base.replace(/\.[^.]+$/, "").replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+  if (!stem) return void 0;
+  return stem.charAt(0).toUpperCase() + stem.slice(1);
+}
+function buildStartBlock(markdownDoc, rootBlocks, fileName) {
+  const frontmatterTitle = typeof markdownDoc.frontmatter?.title === "string" ? markdownDoc.frontmatter.title.trim() : void 0;
+  const headingBlock = shallowestHeadingBlock(rootBlocks);
+  const headingTitle = headingBlock ? headingBlock.title ?? extractPlainText(headingBlock.sourceHeading) : void 0;
+  const title = frontmatterTitle || headingTitle || fileNameCoverTitle(fileName);
   if (!title) return void 0;
-  const subtitle = firstH1.contents?.[0]?.type === "paragraph" ? extractPlainText(firstH1.contents[0]) : void 0;
+  const subtitleBlock = headingBlock ?? rootBlocks[0];
+  const subtitle = subtitleBlock?.contents?.[0]?.type === "paragraph" ? extractPlainText(subtitleBlock.contents[0]) : void 0;
   const firstImage = findFirstImage(markdownDoc);
   const config = {
     title,
@@ -10744,6 +11005,8 @@ export {
   createAccentLayers,
   adjustY,
   sectionHeader,
+  fitBigTextSize,
+  bigText,
   contentBlock,
   statHighlight,
   quoteBlock,

package/dist/{chunk-CYRIVZTR.js → chunk-HXMV7WQB.js}

@@ -2,7 +2,7 @@ import {
   assertMarkdownDocumentWithinLimits,
   parseMarkdown,
   toMdast
-} from "./chunk-YQW6AQBV.js";
+} from "./chunk-6MVWWZHL.js";
 import {
   formatFrontmatterYaml,
   getChildren,

package/dist/{chunk-O3LLD7HG.js → chunk-NBKAXPSX.js}

@@ -34,6 +34,7 @@ function isContainerTemplate(name) {
 var TEMPLATE_TOKEN_NAMES = /* @__PURE__ */ new Set([
   "title",
   "sectionHeader",
+  "bigText",
   "content",
   "statHighlight",
   "quote",