@bendyline/squisq 2.2.0 → 2.3.0

package/dist/{chunk-I2O6W7DX.js → chunk-QNTQIEIV.js}

@@ -24,7 +24,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-7ARJZYQY.js";
+} from "./chunk-GIIOY6XR.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -40,7 +40,7 @@ import {
   toCells,
   toGrid,
   traceBoxes
-} from "./chunk-FDYDYL77.js";
+} from "./chunk-QWCFK5FN.js";
 import {
   defaultPageStyle,
   resolveMediaSchedule
@@ -537,8 +537,12 @@ function resolvePageBlock(block) {
   };
   const coercedParams = coerceTemplateParams(rawName, rawParams).input;
   let base;
+  let derivedInputs = null;
   if (annotation) {
     const headingText = extractPlainText(block.sourceHeading);
+    derivedInputs = deriveTemplateInputs(rawName, headingText, block.contents, {
+      placeholders: true
+    });
     base = {
       id: block.id,
       template: rawName,
@@ -548,9 +552,7 @@ function resolvePageBlock(block) {
       title: headingText,
       contents: block.contents,
       children: block.children,
-      ...deriveTemplateInputs(rawName, headingText, block.contents, {
-        placeholders: true
-      }) ?? {}
+      ...derivedInputs ?? {}
     };
   } else {
     base = {
@@ -566,6 +568,14 @@ function resolvePageBlock(block) {
     ...block.templateData ?? {},
     ...coercedParams
   };
+  const explicitQuote = Object.prototype.hasOwnProperty.call(coercedParams, "quote") ? coercedParams.quote : block.templateData?.quote;
+  if (templateName === "quote" && derivedInputs && !Object.prototype.hasOwnProperty.call(derivedInputs, "title") && !(typeof explicitQuote === "string" && explicitQuote.trim())) {
+    const quoteInput = templateBlock;
+    quoteInput.quote = derivedInputs.quote;
+    if (!Object.prototype.hasOwnProperty.call(block.templateData ?? {}, "title") && !Object.prototype.hasOwnProperty.call(coercedParams, "title")) {
+      delete quoteInput.title;
+    }
+  }
   return { templated: true, templateName, templateBlock };
 }
 
@@ -642,6 +652,7 @@ var quote = (input) => {
     kind: "quote-band",
     variant: "plain",
     slots: {
+      title: q.title,
       body: { text: q.quote ?? "" },
       attribution: q.attribution,
       media: accentImageMedia(q.accentImage)

package/dist/{chunk-FDYDYL77.js → chunk-QWCFK5FN.js}

@@ -2457,6 +2457,7 @@ function pickAutoTemplate(profile, blockIndex = 0) {
   if (profile.hasTimeline) return "timeline";
   if (profile.hasTree) return "tree";
   if (profile.hasTable) return "dataTable";
+  if (profile.hasVideo) return "videoWithCaption";
   if (profile.imageCount >= 2) return "photoGrid";
   if (profile.hasImage) return blockIndex % 2 === 0 ? "leftFeature" : "rightFeature";
   if (profile.hasBlockquote) return "quote";

package/dist/{chunk-CB45YGAM.js → chunk-SPTY4C6F.js}

@@ -2,6 +2,7 @@ import {
   defaultPageStyle
 } from "./chunk-2ZWIXGAC.js";
 import {
+  FONT_FALLBACKS,
   THEME_SCHEMA_VERSION,
   assertTheme,
   createTheme,
@@ -11,7 +12,8 @@ import {
   oklchLighten,
   oklchSetChroma,
   pickContrastingText,
-  relativeLuminance
+  relativeLuminance,
+  resolveFontFamily
 } from "./chunk-C33GTPUZ.js";
 
 // src/schemas/Doc.ts
@@ -172,6 +174,135 @@ function serializeTheme(theme) {
   return JSON.stringify(theme, null, 2);
 }
 
+// src/schemas/mermaidTheme.ts
+var MERMAID_CHART_COLOR_COUNT = 12;
+function uniqueColors(colors) {
+  return colors.filter((color, index) => color && colors.indexOf(color) === index);
+}
+function chartPalette(theme) {
+  const schemes = Object.values(theme.colorSchemes);
+  const seeds = uniqueColors([
+    theme.colors.primary,
+    theme.colors.secondary,
+    theme.colors.highlight,
+    ...schemes.map((scheme) => scheme.accent),
+    theme.colors.warning,
+    ...schemes.map((scheme) => scheme.bg),
+    theme.colors.textMuted,
+    theme.colors.backgroundLight
+  ]);
+  const fallback = theme.colors.primary;
+  return Array.from(
+    { length: MERMAID_CHART_COLOR_COUNT },
+    (_, index) => seeds[index % Math.max(1, seeds.length)] ?? fallback
+  );
+}
+function textOn(theme, background) {
+  return pickContrastingText(background, theme.colors.text, theme.colors.background);
+}
+function buildMermaidThemeVariables(theme) {
+  const { colors } = theme;
+  const primaryText = textOn(theme, colors.primary);
+  const secondaryText = textOn(theme, colors.secondary);
+  const highlightText = textOn(theme, colors.highlight);
+  const palette = chartPalette(theme);
+  const variables = {
+    darkMode: relativeLuminance(colors.background) < 0.5,
+    background: colors.background,
+    fontFamily: resolveFontFamily(theme.typography.bodyFont, FONT_FALLBACKS.sans),
+    primaryColor: colors.primary,
+    primaryTextColor: primaryText,
+    primaryBorderColor: colors.highlight,
+    secondaryColor: colors.secondary,
+    secondaryTextColor: secondaryText,
+    secondaryBorderColor: colors.primary,
+    tertiaryColor: colors.backgroundLight,
+    tertiaryTextColor: colors.text,
+    tertiaryBorderColor: colors.textMuted,
+    textColor: colors.text,
+    titleColor: colors.text,
+    lineColor: colors.textMuted,
+    arrowheadColor: colors.textMuted,
+    defaultLinkColor: colors.textMuted,
+    mainBkg: colors.primary,
+    nodeBkg: colors.primary,
+    nodeTextColor: primaryText,
+    nodeBorder: colors.highlight,
+    clusterBkg: colors.backgroundLight,
+    clusterBorder: colors.secondary,
+    edgeLabelBackground: colors.background,
+    actorBkg: colors.backgroundLight,
+    actorBorder: colors.primary,
+    actorTextColor: colors.text,
+    actorLineColor: colors.textMuted,
+    signalColor: colors.textMuted,
+    signalTextColor: colors.text,
+    labelBoxBkgColor: colors.backgroundLight,
+    labelBoxBorderColor: colors.secondary,
+    labelTextColor: colors.text,
+    loopTextColor: colors.text,
+    activationBkgColor: colors.secondary,
+    activationBorderColor: colors.primary,
+    sequenceNumberColor: primaryText,
+    noteBkgColor: colors.highlight,
+    noteBorderColor: colors.primary,
+    noteTextColor: highlightText,
+    sectionBkgColor: colors.backgroundLight,
+    altSectionBkgColor: colors.background,
+    sectionBkgColor2: colors.primary,
+    taskBkgColor: colors.primary,
+    taskBorderColor: colors.highlight,
+    taskTextColor: primaryText,
+    taskTextLightColor: colors.text,
+    taskTextDarkColor: colors.text,
+    taskTextOutsideColor: colors.text,
+    taskTextClickableColor: colors.highlight,
+    activeTaskBkgColor: colors.secondary,
+    activeTaskBorderColor: colors.highlight,
+    doneTaskBkgColor: colors.backgroundLight,
+    doneTaskBorderColor: colors.textMuted,
+    critBkgColor: colors.warning,
+    critBorderColor: colors.highlight,
+    todayLineColor: colors.warning,
+    gridColor: colors.textMuted,
+    pieTitleTextColor: colors.text,
+    pieSectionTextColor: colors.text,
+    pieLegendTextColor: colors.text,
+    pieStrokeColor: colors.background,
+    pieOuterStrokeColor: colors.textMuted,
+    quadrantPointFill: colors.highlight,
+    quadrantPointTextFill: highlightText,
+    quadrantXAxisTextFill: colors.text,
+    quadrantYAxisTextFill: colors.text,
+    quadrantTitleFill: colors.text,
+    requirementBackground: colors.backgroundLight,
+    requirementBorderColor: colors.primary,
+    requirementTextColor: colors.text,
+    relationColor: colors.textMuted,
+    relationLabelBackground: colors.background,
+    relationLabelColor: colors.text,
+    commitLabelColor: colors.text,
+    commitLabelBackground: colors.backgroundLight,
+    tagLabelColor: primaryText,
+    tagLabelBackground: colors.primary,
+    tagLabelBorder: colors.highlight
+  };
+  palette.forEach((color, index) => {
+    const label = textOn(theme, color);
+    variables[`cScale${index}`] = color;
+    variables[`cScaleInv${index}`] = label;
+    variables[`cScaleLabel${index}`] = label;
+    variables[`cScalePeer${index}`] = label;
+    variables[`pie${index + 1}`] = color;
+    if (index < 8) {
+      variables[`git${index}`] = color;
+      variables[`gitInv${index}`] = label;
+      variables[`gitBranchLabel${index}`] = label;
+    }
+  });
+  return variables;
+}
+
 export {
   calculateDuration,
   getSegmentAtTime,
@@ -182,5 +313,6 @@ export {
   accentToColorScheme,
   compileTheme,
   parseTheme,
-  serializeTheme
+  serializeTheme,
+  buildMermaidThemeVariables
 };

package/dist/doc/index.d.ts

@@ -1,11 +1,11 @@
-import { aX as TemplateBlock, aY as TemplateContext, V as Layer, p as CustomTemplateDefinition, a_ as TemplateRegistry, b1 as Theme, bq as ViewportConfig, az as PersistentLayerConfig, G as DocBlock, ay as PersistentLayer, be as TitleBlockInput, aM as SectionHeaderInput, aS as StatHighlightInput, aH as QuoteBlockInput, L as FactCardInput, bl as TwoColumnInput, u as DateEventInput, T as ImageWithCaptionInput, Y as LeftFeatureInput, aK as RightFeatureInput, $ as MapBlockInput, aR as StartBlockConfig, O as FullBleedQuoteInput, _ as ListBlockInput, aD as PhotoGridInput, w as DefinitionCardInput, n as ComparisonBarInput, aG as PullQuoteInput, bp as VideoWithCaptionInput, bo as VideoPullQuoteInput, t as DataTableInput, x as DiagramBlockInput, bg as TreeBlockInput, ba as TimelineBlockInput, B as Block, I as DrawingBlockInput, a3 as MarkerStyle, A as AccentImage, S as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, b3 as ThemeColorScheme, F as Doc, b5 as ThemeRegistry, ar as PageEmphasis, b4 as ThemePageStyle, H as DocDiagnostic, E as DiagramTemplateNode, z as DiagramTemplateEdge, bd as TimelineTemplateTrack, bc as TimelineTemplateLink } from '../Doc-BubIpWsp.js';
-export { J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, X as LayoutHints, aJ as RenderStyle, b2 as ThemeColorPalette, b8 as ThemeStyle, b9 as ThemeTypography, bm as VIEWPORT_PRESETS, br as ViewportOrientation, bs as ViewportPreset, bx as createTemplateContext, bE as getLayoutHints, bH as getTwoColumnPositions, bI as getViewport, bJ as getViewportOrientation, bL as isTemplateBlock, bO as scaledFontSize } from '../Doc-BubIpWsp.js';
+import { aX as TemplateBlock, aY as TemplateContext, V as Layer, p as CustomTemplateDefinition, a_ as TemplateRegistry, b1 as Theme, bq as ViewportConfig, az as PersistentLayerConfig, G as DocBlock, br as ViewportOrientation, ay as PersistentLayer, be as TitleBlockInput, aM as SectionHeaderInput, aS as StatHighlightInput, aH as QuoteBlockInput, L as FactCardInput, bl as TwoColumnInput, u as DateEventInput, T as ImageWithCaptionInput, Y as LeftFeatureInput, aK as RightFeatureInput, $ as MapBlockInput, aR as StartBlockConfig, O as FullBleedQuoteInput, _ as ListBlockInput, aD as PhotoGridInput, w as DefinitionCardInput, n as ComparisonBarInput, aG as PullQuoteInput, bp as VideoWithCaptionInput, bo as VideoPullQuoteInput, t as DataTableInput, x as DiagramBlockInput, bg as TreeBlockInput, ba as TimelineBlockInput, B as Block, I as DrawingBlockInput, a3 as MarkerStyle, A as AccentImage, S as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, b3 as ThemeColorScheme, F as Doc, b5 as ThemeRegistry, ar as PageEmphasis, b4 as ThemePageStyle, H as DocDiagnostic, E as DiagramTemplateNode, z as DiagramTemplateEdge, bd as TimelineTemplateTrack, bc as TimelineTemplateLink } from '../Doc-COe-rPQB.js';
+export { J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, X as LayoutHints, aJ as RenderStyle, b2 as ThemeColorPalette, b8 as ThemeStyle, b9 as ThemeTypography, bm as VIEWPORT_PRESETS, bs as ViewportPreset, bx as createTemplateContext, bE as getLayoutHints, bH as getTwoColumnPositions, bI as getViewport, bJ as getViewportOrientation, bL as isTemplateBlock, bO as scaledFontSize } from '../Doc-COe-rPQB.js';
 import { K as MarkdownNode, a2 as TransitionType, a1 as TransitionDirection, M as MarkdownBlockNode, r as MarkdownHeading, n as MarkdownDocument, S as MarkdownTable, i as MarkdownCodeBlock, F as MarkdownList } from '../types-CUNc9biN.js';
 import { C as CoercedBlockMeta } from '../annotationCoercion-PtRQhk5V.js';
-import { c as PageSection } from '../materializePageSection-wSLA2A1g.js';
-export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-wSLA2A1g.js';
+import { c as PageSection } from '../materializePageSection-BSMOocve.js';
+export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-BSMOocve.js';
 import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-DU9mUmVl.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BUTWjufL.js';
 
 /** Runtime registry composition for built-in and document-scoped templates. */
 
@@ -107,6 +107,259 @@ interface TemplateMetadata {
 }
 declare const TEMPLATE_METADATA: Record<string, TemplateMetadata>;
 
+/**
+ * Exhaustive media-layout policy for every built-in block template.
+ *
+ * A template has two independent concerns:
+ * 1. what it renders when no external image/video/diagram is present, and
+ * 2. what happens when rich body media was not already consumed by it.
+ *
+ * Keeping that declaration here prevents misleading template names (for
+ * example, `fullBleedQuote` is text-only) from becoming layout behavior.
+ * `mediaLayoutPolicy.test.ts` keeps this map exactly 1:1 with the registry.
+ */
+
+type BuiltInTemplateName = TemplateBlock['template'];
+/** Shape of the supplemental media set after extraction. */
+type SupplementalMediaShape = 'wide' | 'tall' | 'square' | 'multiple';
+/** Designed compositions understood by the framework-free layout resolver. */
+type SupplementalMediaLayoutVariant = 'title-stack' | 'split' | 'text-stack' | 'dense-stack';
+type SupplementalMediaVariantMatrix = Record<ViewportOrientation, Record<SupplementalMediaShape, SupplementalMediaLayoutVariant>>;
+/** What the template does before supplemental rich media is considered. */
+type NoMediaLayout = 'template-default' | 'template-without-optional-media' | 'unsupported' | 'intrinsic-visual';
+/** Which part of the system owns the template's primary media geometry. */
+type TemplateMediaOwnership = 'supplemental' | 'optional-native' | 'required-native' | 'intrinsic-visual';
+/** Geometry already implemented by templates that own their primary media. */
+type NativeMediaLayout = 'full-bleed-image' | 'full-bleed-video' | 'background-image' | 'accent-strip-or-inset' | 'feature-left' | 'feature-right' | 'map-canvas' | 'photo-grid' | 'spatial-canvas' | 'freeform-canvas';
+/** How unconsumed body media behaves after the template renders. */
+type UnconsumedMediaBehavior = 'reserved-slot' | 'reserve-when-no-native-media' | 'retain-native-layout';
+interface BlockMediaLayoutPolicy {
+    /** Concise human-readable contract for reviewers and future template work. */
+    summary: string;
+    /** The composition used when the block has no external rich media. */
+    noMedia: NoMediaLayout;
+    /** Whether primary media is placed by this resolver or by the template. */
+    ownership: TemplateMediaOwnership;
+    /** Existing template-owned media geometry, when applicable. */
+    nativeLayout?: NativeMediaLayout;
+    /** Explicit geometry for extra media when the native composition must remain intact. */
+    additionalMediaLayout?: 'overlay-inset';
+    /** Placement policy for rich body media left over after template execution. */
+    unconsumedMedia: UnconsumedMediaBehavior;
+    /** Required whenever unconsumed media may receive a reserved rectangle. */
+    variants?: SupplementalMediaVariantMatrix;
+}
+/**
+ * Canonical media contract for all 25 built-in templates. Entries are kept
+ * in registry/gallery order to make policy reviews easy to scan.
+ */
+declare const BLOCK_MEDIA_LAYOUT_POLICIES: {
+    readonly title: {
+        readonly summary: "Text-only by default; supplemental media gets a title band plus a reserved field.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly sectionHeader: {
+        readonly summary: "Uses its authored background image when present; otherwise supplemental media receives a title composition.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "background-image";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly statHighlight: {
+        readonly summary: "Uses its optional accent image natively; otherwise supplemental media occupies a companion field.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly quote: {
+        readonly summary: "Uses its optional accent image natively; otherwise supplemental media is paired with the quote.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly factCard: {
+        readonly summary: "Uses its optional accent image natively; otherwise supplemental media is paired with the fact card.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly twoColumn: {
+        readonly summary: "Text comparison by default; supplemental media stacks below the dense two-column panel.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly dateEvent: {
+        readonly summary: "Uses its optional accent image natively; otherwise supplemental media is paired with the event.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly imageWithCaption: {
+        readonly summary: "Requires one primary image and owns its full-bleed image/caption geometry.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "full-bleed-image";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly leftFeature: {
+        readonly summary: "Requires a primary image in the left feature cell; text occupies the right cell.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "feature-left";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly rightFeature: {
+        readonly summary: "Requires a primary image in the right feature cell; text occupies the left cell.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "feature-right";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly map: {
+        readonly summary: "The map canvas is the primary visual; other media must not reflow its geography.";
+        readonly noMedia: "intrinsic-visual";
+        readonly ownership: "intrinsic-visual";
+        readonly nativeLayout: "map-canvas";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly fullBleedQuote: {
+        readonly summary: "Despite its name this is text-only; supplemental media receives the same dramatic title treatment.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly list: {
+        readonly summary: "Uses its optional accent image natively; otherwise supplemental media is paired with the list.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly photoGrid: {
+        readonly summary: "Requires a primary image collection and owns the complete tiled media field.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "photo-grid";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly definitionCard: {
+        readonly summary: "Uses its optional accent image natively; otherwise supplemental media is paired with the definition.";
+        readonly noMedia: "template-without-optional-media";
+        readonly ownership: "optional-native";
+        readonly nativeLayout: "accent-strip-or-inset";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "reserve-when-no-native-media";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly comparisonBar: {
+        readonly summary: "Data bars are primary; supplemental media stacks below to preserve horizontal scale.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly pullQuote: {
+        readonly summary: "Requires and owns a full-bleed background image behind the quote lockup.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "full-bleed-image";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly videoWithCaption: {
+        readonly summary: "Requires one primary video and owns its full-bleed video/caption geometry.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "full-bleed-video";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly videoPullQuote: {
+        readonly summary: "Requires and owns a full-bleed video behind the quote lockup.";
+        readonly noMedia: "unsupported";
+        readonly ownership: "required-native";
+        readonly nativeLayout: "full-bleed-video";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly dataTable: {
+        readonly summary: "The table remains wide; supplemental media stacks below the dense data region.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
+    readonly diagram: {
+        readonly summary: "The node-and-edge canvas is intrinsic media and retains its spatial coordinate system.";
+        readonly noMedia: "intrinsic-visual";
+        readonly ownership: "intrinsic-visual";
+        readonly nativeLayout: "spatial-canvas";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly tree: {
+        readonly summary: "The interactive tree canvas is intrinsic media and retains its full layout region.";
+        readonly noMedia: "intrinsic-visual";
+        readonly ownership: "intrinsic-visual";
+        readonly nativeLayout: "spatial-canvas";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly timeline: {
+        readonly summary: "The track canvas is intrinsic media and retains its shared horizontal time scale.";
+        readonly noMedia: "intrinsic-visual";
+        readonly ownership: "intrinsic-visual";
+        readonly nativeLayout: "spatial-canvas";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly layout: {
+        readonly summary: "The authored layer canvas is intrinsic media and must preserve absolute placement.";
+        readonly noMedia: "intrinsic-visual";
+        readonly ownership: "intrinsic-visual";
+        readonly nativeLayout: "freeform-canvas";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+    readonly drawing: {
+        readonly summary: "The drawing canvas is intrinsic media and must preserve authored geometry.";
+        readonly noMedia: "intrinsic-visual";
+        readonly ownership: "intrinsic-visual";
+        readonly nativeLayout: "freeform-canvas";
+        readonly additionalMediaLayout: "overlay-inset";
+        readonly unconsumedMedia: "retain-native-layout";
+    };
+};
+/** Safe runtime lookup for built-ins; custom template ids return undefined. */
+declare function getBlockMediaLayoutPolicy(template: string | undefined): BlockMediaLayoutPolicy | undefined;
+
 /** Resolve a historical template id to its canonical registry key. */
 declare function resolveTemplateName(name: string): string;
 /** Templates that consume their child headings rather than rendering them. */
@@ -1203,6 +1456,12 @@ interface FirstImage {
     width?: number;
     height?: number;
 }
+/** First-class video reference discovered in a block body. */
+interface EmbeddedVideo {
+    src: string;
+    posterSrc?: string;
+    alt: string;
+}
 /** Plain text of a block's body contents (excluding the heading). */
 declare function extractBodyPlainText(contents?: MarkdownBlockNode[]): string;
 /** Extract list items as plain text. */
@@ -1219,6 +1478,17 @@ declare function extractListItems(contents?: MarkdownBlockNode[]): string[];
 declare function extractImages(contents: MarkdownBlockNode[] | undefined, limit?: number): FirstImage[];
 /** First image in a block's body, or null. */
 declare function extractFirstImage(contents: MarkdownBlockNode[] | undefined): FirstImage | null;
+/**
+ * Find playable video references in block contents.
+ *
+ * Recorder output is raw HTML (`<video src="...">`), sometimes with a
+ * nested `<source>`. Direct markdown links/images to video files are also
+ * accepted. Hosted watch-page/iframe URLs are deliberately excluded: an
+ * HTML5 VideoLayer cannot play those URLs directly.
+ */
+declare function extractEmbeddedVideos(contents: MarkdownBlockNode[] | undefined, limit?: number): EmbeddedVideo[];
+/** First directly playable video in a block body, or null. */
+declare function extractFirstEmbeddedVideo(contents: MarkdownBlockNode[] | undefined): EmbeddedVideo | null;
 /** Extract table data (headers, rows, alignment) from block contents. */
 declare function extractTableFromContents(contents?: MarkdownBlockNode[]): {
     headers: string[];
@@ -1233,7 +1503,20 @@ interface DeriveTemplateInputsOptions {
      * input can't be derived (preview surfaces). Default false (strict).
      */
     placeholders?: boolean;
+    /**
+     * Keep the source heading visible when a template normally promotes only
+     * body content. Used by automatic templates; explicit annotations retain
+     * their historical input derivation.
+     */
+    preserveSourceHeading?: boolean;
 }
+/**
+ * Whether an automatically selected template can represent every authored
+ * node in the block. Auto-selection must be conservative: the source remains
+ * round-trippable either way, but a successful render may not hide sibling
+ * content that the chosen template has no slot for.
+ */
+declare function autoTemplatePreservesContent(templateName: string, contents: MarkdownBlockNode[] | undefined): boolean;
 /**
  * Derive a template's inputs from a block's heading text and body nodes.
  * Returns the input fields to merge onto the block, or `null` in strict
@@ -2485,4 +2768,4 @@ declare function treeFromMarkdownList(list: MarkdownList): Tree;
 /** Find the first top-level markdown list in a block's body, if any. */
 declare function findFirstList(contents: MarkdownBlockNode[] | undefined): MarkdownList | undefined;
 
-export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, type BlockLayerMaterialization, CONTAINER_TEMPLATES, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type NarrationResolution, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolvedPageBlock, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, TemplateBlock, TemplateContext, type TemplateInputDescriptor, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type ValidateOptions, ViewportConfig, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, buildPageCss, buildPageCssVars, buildRegistry, canvasToAsciiCell, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, definitionCard, deriveTemplateInputs, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, materializeBlockLayers, nearestSnapPoint, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };
+export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuiltInTemplateName, CONTAINER_TEMPLATES, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolvedPageBlock, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, TemplateBlock, TemplateContext, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, ViewportConfig, ViewportOrientation, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, autoTemplatePreservesContent, buildPageCss, buildPageCssVars, buildRegistry, canvasToAsciiCell, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, definitionCard, deriveTemplateInputs, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, materializeBlockLayers, nearestSnapPoint, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };