@bendyline/squisq 1.5.0 → 1.5.2

package/dist/{chunk-4ZFRZBU2.js → chunk-5TYS5V3G.js}

@@ -1,17 +1,17 @@
 import {
   pickAutoTemplate,
   profileBlockContents
-} from "./chunk-LRCV7N7F.js";
+} from "./chunk-UY7KGQ5R.js";
 import {
   SeededRandom,
   hashString
 } from "./chunk-FVTQSNR7.js";
 import {
-  clipEndpoints,
   connectorPath,
   lineStyleDasharray,
-  shapePath
-} from "./chunk-RUDYOTA6.js";
+  shapePath,
+  snapEndpoints
+} from "./chunk-LTN6I7QW.js";
 import {
   DEFAULT_THEME,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
@@ -24,7 +24,7 @@ import {
   resolveTheme,
   validateTheme,
   withAlpha
-} from "./chunk-4AKUQPEE.js";
+} from "./chunk-KKNUBQ6Y.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -34,25 +34,28 @@ import {
   scaledFontSize2 as scaledFontSize
 } from "./chunk-DLXZMS5K.js";
 import {
+  KNOWN_BLOCK_META_KEYS,
   coerceAnnotationValues,
   matchTrailingTemplateAnnotation,
   parseMarkdown,
+  parseNumber,
   parseTimeSeconds,
+  serializeAnnotation,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-OH43RPTP.js";
+} from "./chunk-BEQODJWV.js";
 import {
   extractPlainText,
   getChildren,
   readFrontmatterThemeId,
   walkMarkdownTree
-} from "./chunk-OKJOQXK4.js";
+} from "./chunk-HWVFJAAH.js";
 import {
   resolveBlockTransition
 } from "./chunk-QE7TWGVT.js";
 import {
   estimateReadingTime
-} from "./chunk-4X3JQXNM.js";
+} from "./chunk-VWUFZ6ZG.js";
 
 // src/doc/templates/persistentLayers.ts
 var GRADIENT_PRESETS = {
@@ -530,6 +533,10 @@ function applyRenderStyleToLayers(layers, block, theme) {
 }
 
 // src/doc/templates/tokens/resolveTokens.ts
+var TOKEN_RE = /\{(\w+)(?::([^}|]+))?(?:\|([^}]*))?\}/g;
+var ESCAPE_RE = /\{\{([^{}]*)\}\}/g;
+var ESCAPED_OPEN = " ESC_OPEN ";
+var ESCAPED_CLOSE = " ESC_CLOSE ";
 function collectImages(block) {
   if (!block.contents) return [];
   const out = [];
@@ -547,6 +554,21 @@ function collectImages(block) {
   }
   return out;
 }
+function collectListItems(block) {
+  if (!block.contents) return [];
+  const out = [];
+  for (const node of block.contents) {
+    walkMarkdownTree(node, (n) => {
+      if (n.type === "listItem") {
+        const text = extractPlainText(n).replace(/\s+/g, " ").trim();
+        if (text) out.push(text);
+        return true;
+      }
+      return;
+    });
+  }
+  return out;
+}
 function getBlockBodyText(block) {
   if (!block.contents) return "";
   return block.contents.map((node) => extractPlainText(node).trim()).filter((s) => s.length > 0).join(" ");
@@ -555,22 +577,26 @@ function getChildrenSummary(block) {
   if (!block.children || block.children.length === 0) return "";
   return block.children.map((c) => c.title?.trim()).filter((t) => Boolean(t)).join(", ");
 }
-function substituteText(text, block, images) {
-  const ESCAPED_OPEN = "\0ESC_OPEN\0";
-  const ESCAPED_CLOSE = "\0ESC_CLOSE\0";
-  const escaped = text.replace(/\{\{([^{}]*)\}\}/g, (_match, inner) => {
-    return ESCAPED_OPEN + inner + ESCAPED_CLOSE;
-  });
+function escapeBraces(text) {
+  return text.replace(ESCAPE_RE, (_match, inner) => ESCAPED_OPEN + inner + ESCAPED_CLOSE);
+}
+function unescapeBraces(text) {
+  return text.replace(new RegExp(ESCAPED_OPEN, "g"), "{").replace(new RegExp(ESCAPED_CLOSE, "g"), "}");
+}
+function substitute(text, resolve) {
+  const escaped = escapeBraces(text);
   const tokenized = escaped.replace(
-    /\{(\w+)(?::([^}]+))?\}/g,
-    (match, name, arg) => {
-      const value = resolveToken(name, arg, block, images);
-      return value ?? match;
+    TOKEN_RE,
+    (match, name, arg, def) => {
+      const value = resolve(name, arg);
+      if (value == null) return match;
+      if (value === "" && def !== void 0) return def;
+      return value;
     }
   );
-  return tokenized.replace(new RegExp(ESCAPED_OPEN, "g"), "{").replace(new RegExp(ESCAPED_CLOSE, "g"), "}");
+  return unescapeBraces(tokenized);
 }
-function resolveToken(name, arg, block, images) {
+function resolveToken(name, arg, block, images, item) {
   switch (name) {
     case "title":
       return block.title ?? "";
@@ -578,49 +604,148 @@ function resolveToken(name, arg, block, images) {
       return getBlockBodyText(block);
     case "children":
       return getChildrenSummary(block);
+    case "attr": {
+      if (!arg) return "";
+      const raw = block.templateOverrides?.[arg] ?? block.templateData?.[arg] ?? block.metadata?.[arg];
+      return raw == null ? "" : String(raw);
+    }
     case "image": {
       const idx = arg ? parseInt(arg, 10) : 0;
       if (!Number.isFinite(idx) || idx < 0 || idx >= images.length) return "";
       return images[idx].alt;
     }
+    case "item": {
+      if (!item) return null;
+      if (!arg) return item.text;
+      if (arg === "src") return item.src ?? "";
+      if (arg === "label") return item.label ?? "";
+      return "";
+    }
+    case "index":
+      return item ? String(item.index) : null;
     default:
       return null;
   }
 }
-function resolveImageSrc(src, images) {
-  if (!/\{image:?[^}]*\}/.test(src)) return src;
+function substituteText(text, block, images, item) {
+  return substitute(text, (name, arg) => resolveToken(name, arg, block, images, item));
+}
+function resolveImageSrc(src, block, images, item) {
+  if (!src.includes("{")) return src;
   let dropped = false;
-  const resolved = src.replace(/\{image(?::([^}]+))?\}/g, (_match, arg) => {
-    const idx = arg ? parseInt(arg, 10) : 0;
-    if (!Number.isFinite(idx) || idx < 0 || idx >= images.length) {
-      dropped = true;
-      return "";
+  const escaped = escapeBraces(src);
+  const tokenized = escaped.replace(
+    TOKEN_RE,
+    (match, name, arg, def) => {
+      if (name === "image") {
+        const idx = arg ? parseInt(arg, 10) : 0;
+        const ok = Number.isFinite(idx) && idx >= 0 && idx < images.length;
+        if (ok) return images[idx].url;
+        if (def !== void 0) return def;
+        dropped = true;
+        return "";
+      }
+      const value = resolveToken(name, arg, block, images, item);
+      if (value == null) return match;
+      if (value === "" && def !== void 0) return def;
+      return value;
     }
-    return images[idx].url;
-  });
-  return dropped ? null : resolved;
+  );
+  if (dropped) return null;
+  return unescapeBraces(tokenized);
+}
+function parseMagnitude(value) {
+  if (typeof value === "number") return value;
+  if (typeof value === "string") {
+    const m = value.match(/-?\d*\.?\d+/);
+    if (m) return parseFloat(m[0]);
+  }
+  return 0;
+}
+function offsetCoord(base, delta) {
+  if (base == null) return delta;
+  if (typeof base === "number") return base + delta;
+  const m = base.match(/^(\s*)(-?\d*\.?\d+)(.*)$/);
+  if (m) {
+    const next = parseFloat(m[2]) + delta;
+    return `${m[1]}${next}${m[3]}`;
+  }
+  return base;
+}
+function collectRepeatItems(source, block, images) {
+  switch (source) {
+    case "images":
+      return images.map((img, i) => ({
+        text: img.alt,
+        src: img.url,
+        label: img.alt,
+        index: i + 1
+      }));
+    case "children":
+      return (block.children ?? []).map((child, i) => ({
+        text: child.title ?? "",
+        label: child.title ?? "",
+        index: i + 1
+      }));
+    case "listItems":
+      return collectListItems(block).map((text, i) => ({ text, label: text, index: i + 1 }));
+    default:
+      return [];
+  }
+}
+function expandRepeat(layer, block, images) {
+  const repeat = layer.repeat;
+  if (!repeat) {
+    const resolved = resolveLayer(layer, block, images, void 0);
+    return resolved ? [resolved] : [];
+  }
+  const items = collectRepeatItems(repeat.source, block, images);
+  const direction = repeat.direction ?? "column";
+  const gap = repeat.gap ?? 24;
+  const limit = repeat.max != null && repeat.max >= 0 ? Math.min(repeat.max, items.length) : items.length;
+  const out = [];
+  let cursor = 0;
+  for (let i = 0; i < limit; i++) {
+    const position = { ...layer.position };
+    if (direction === "row") {
+      position.x = offsetCoord(position.x, cursor);
+    } else {
+      position.y = offsetCoord(position.y, cursor);
+    }
+    const clone = { ...layer, position, id: `${layer.id}-${i}` };
+    delete clone.repeat;
+    const resolved = resolveLayer(clone, block, images, items[i]);
+    if (resolved) out.push(resolved);
+    const dim = direction === "row" ? layer.position.width : layer.position.height;
+    cursor += parseMagnitude(dim) + gap;
+  }
+  return out;
 }
 function resolveTokens(layers, block) {
   const images = collectImages(block);
   const out = [];
   for (const layer of layers) {
-    const resolved = resolveLayer(layer, block, images);
-    if (resolved) out.push(resolved);
+    if (layer.repeat) {
+      out.push(...expandRepeat(layer, block, images));
+    } else {
+      const resolved = resolveLayer(layer, block, images, void 0);
+      if (resolved) out.push(resolved);
+    }
   }
   return out;
 }
-function resolveLayer(layer, block, images) {
+function resolveLayer(layer, block, images, item) {
   switch (layer.type) {
     case "text":
       return {
         ...layer,
         content: {
           ...layer.content,
-          text: substituteText(layer.content.text, block, images)
+          text: substituteText(layer.content.text, block, images, item)
         }
       };
     case "image": {
-      const nextSrc = resolveImageSrc(layer.content.src, images);
+      const nextSrc = resolveImageSrc(layer.content.src, block, images, item);
       if (nextSrc == null) return null;
       const next = {
         ...layer,
@@ -630,7 +755,7 @@ function resolveLayer(layer, block, images) {
         }
       };
       if (layer.content.alt && layer.content.alt.includes("{")) {
-        next.content.alt = substituteText(layer.content.alt, block, images);
+        next.content.alt = substituteText(layer.content.alt, block, images, item);
       }
       return next;
     }
@@ -641,12 +766,305 @@ function resolveLayer(layer, block, images) {
 
 // src/doc/templates/customTemplate.ts
 function makeCustomTemplateFn(def) {
-  return (_input, context) => {
-    if (!context.block) return def.layers.slice();
-    return resolveTokens(def.layers, context.block);
+  return (input, context) => {
+    const block = context.block ?? input;
+    if (!block) return def.layers.slice();
+    return resolveTokens(def.layers, block);
   };
 }
 
+// src/doc/utils/nearest.ts
+function levenshtein(a, b) {
+  if (a === b) return 0;
+  const m = a.length;
+  const n = b.length;
+  if (m === 0) return n;
+  if (n === 0) return m;
+  let prev = new Array(n + 1);
+  let curr = new Array(n + 1);
+  for (let j = 0; j <= n; j++) prev[j] = j;
+  for (let i = 1; i <= m; i++) {
+    curr[0] = i;
+    for (let j = 1; j <= n; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[n];
+}
+function nearestName(input, candidates, options) {
+  const maxDistance = options?.maxDistance ?? 2;
+  let best;
+  let bestDist = Infinity;
+  const lower = input.toLowerCase();
+  for (const candidate of candidates) {
+    const dist = levenshtein(lower, candidate.toLowerCase());
+    if (dist < bestDist) {
+      bestDist = dist;
+      best = candidate;
+    }
+  }
+  if (best && (bestDist <= maxDistance || bestDist <= Math.ceil(input.length * 0.4))) {
+    return options?.map ? options.map(best) : best;
+  }
+  return void 0;
+}
+
+// src/doc/templates/inputDescriptors.ts
+var AMBIENT_MOTION_VALUES = ["zoomIn", "zoomOut", "panLeft", "panRight"];
+var CAPTION_POSITION_VALUES = ["bottom", "top", "center"];
+var MAP_STYLE_VALUES = ["terrain", "satellite", "road", "toner", "watercolor"];
+var DATE_EVENT_MOOD_VALUES = ["neutral", "somber", "celebratory"];
+var COLOR_SCHEME_HINT = "theme color-scheme name \u2014 e.g. 'blue', 'green'";
+var BASE_INPUT_DESCRIPTORS = [
+  {
+    key: "imageTreatment",
+    description: "Per-block photographic grade override ('none' opts out)",
+    values: ["none", "mono", "duotone", "warm", "cool"]
+  },
+  {
+    key: "useBottomLayer",
+    description: "Show the doc's bottom persistent layers",
+    coerce: "boolean"
+  },
+  { key: "useTopLayer", description: "Show the doc's top persistent layers", coerce: "boolean" }
+];
+var TEMPLATE_INPUT_DESCRIPTORS = {
+  title: [
+    { key: "title", description: "Main title text" },
+    { key: "subtitle", description: "Subtitle or tagline" },
+    { key: "backgroundColor", description: "Background color", valueHint: "CSS color" }
+  ],
+  statHighlight: [
+    { key: "stat", description: 'The statistic (e.g. "89%", "2x")' },
+    { key: "description", description: "What the stat means" },
+    { key: "detail", description: "Additional detail or context" },
+    { key: "colorScheme", description: "Color scheme for the stat", valueHint: COLOR_SCHEME_HINT }
+  ],
+  quote: [
+    { key: "quote", description: "The quote text" },
+    { key: "attribution", description: "Attribution (author, source)" }
+  ],
+  pullQuote: [
+    { key: "text", description: "Quote text" },
+    { key: "attribution", description: "Attribution" }
+  ],
+  twoColumn: [
+    {
+      key: "left",
+      description: 'Left column, as "label|sublabel"',
+      coerce: "labeledPair",
+      required: true
+    },
+    {
+      key: "right",
+      description: 'Right column, as "label|sublabel"',
+      coerce: "labeledPair",
+      required: true
+    },
+    { key: "header", description: "Optional header above the columns" },
+    { key: "leftColor", description: "Left column color scheme", valueHint: COLOR_SCHEME_HINT },
+    { key: "rightColor", description: "Right column color scheme", valueHint: COLOR_SCHEME_HINT }
+  ],
+  dateEvent: [
+    { key: "date", description: 'The date (e.g. "July 14, 1974")' },
+    { key: "description", description: "What happened" },
+    { key: "footer", description: "Optional footer text" },
+    { key: "mood", description: "Emotional tone", values: DATE_EVENT_MOOD_VALUES }
+  ],
+  imageWithCaption: [
+    { key: "imageSrc", description: "Path to the image file", required: true },
+    { key: "imageAlt", description: "Alt text for accessibility" },
+    { key: "caption", description: "Caption text" },
+    { key: "captionPosition", description: "Caption placement", values: CAPTION_POSITION_VALUES },
+    { key: "ambientMotion", description: "Slow zoom/pan effect", values: AMBIENT_MOTION_VALUES },
+    { key: "isTitle", description: "Style the caption as a title", coerce: "boolean" },
+    { key: "subtitle", description: "Subtitle (only when isTitle)" },
+    { key: "imageCredit", description: "Photo credit / artist name" },
+    { key: "imageLicense", description: "License identifier" }
+  ],
+  leftFeature: FEATURE_DESCRIPTORS(),
+  rightFeature: FEATURE_DESCRIPTORS(),
+  map: [
+    {
+      key: "center",
+      description: 'Map center as "lat,lng"',
+      coerce: "latLng",
+      required: true
+    },
+    { key: "zoom", description: "Zoom level (4-16)", coerce: "number" },
+    { key: "mapStyle", description: "Map tile style", values: MAP_STYLE_VALUES },
+    { key: "title", description: "Optional title overlay" },
+    { key: "caption", description: "Optional caption" }
+  ],
+  photoGrid: [
+    { key: "images", description: "Comma-separated image paths", coerce: "stringList" },
+    { key: "caption", description: "Optional caption below the grid" },
+    {
+      key: "ambientMotion",
+      description: "Slow zoom/pan on the largest image",
+      values: AMBIENT_MOTION_VALUES
+    }
+  ],
+  comparisonBar: [
+    { key: "leftLabel", description: "Left bar label", required: true },
+    { key: "leftValue", description: "Left bar numeric value", coerce: "number", required: true },
+    { key: "rightLabel", description: "Right bar label", required: true },
+    { key: "rightValue", description: "Right bar numeric value", coerce: "number", required: true },
+    { key: "unit", description: 'Unit label (e.g. "km")' },
+    { key: "colorScheme", description: "Color scheme", valueHint: COLOR_SCHEME_HINT }
+  ],
+  dataTable: [
+    { key: "title", description: "Optional title above the table" },
+    { key: "headers", description: "Comma-separated header cells", coerce: "stringList" },
+    // `rows`/`align` are structured (string[][] / alignment[]) and can't be
+    // expressed as a single inline string — declared so they aren't flagged
+    // as unknown when supplied via a data fence's overriding params.
+    { key: "rows", description: "Table rows (supply via a data fence)" },
+    { key: "align", description: "Per-column alignment (supply via a data fence)" },
+    { key: "colorScheme", description: "Header color scheme", valueHint: COLOR_SCHEME_HINT }
+  ],
+  videoWithCaption: [
+    { key: "videoSrc", description: "Path to the video file", required: true },
+    { key: "posterSrc", description: "Poster frame path" },
+    { key: "videoAlt", description: "Alt text for accessibility" },
+    { key: "clipStart", description: "Clip start time (seconds)", coerce: "number" },
+    { key: "clipEnd", description: "Clip end time (seconds)", coerce: "number" },
+    { key: "caption", description: "Caption text" },
+    { key: "captionPosition", description: "Caption placement", values: CAPTION_POSITION_VALUES },
+    { key: "videoCredit", description: "Video credit / artist name" },
+    { key: "videoLicense", description: "License identifier" }
+  ]
+};
+function FEATURE_DESCRIPTORS() {
+  return [
+    { key: "imageSrc", description: "Path to the feature image", required: true },
+    { key: "imageAlt", description: "Alt text for accessibility" },
+    { key: "imageWidth", description: "Explicit display width in px", coerce: "number" },
+    { key: "imageHeight", description: "Explicit display height in px", coerce: "number" },
+    { key: "title", description: "Heading text next to the image" },
+    { key: "body", description: "Body text below the title" }
+  ];
+}
+function descriptorsFor(canonical) {
+  const specific = TEMPLATE_INPUT_DESCRIPTORS[canonical];
+  if (!specific) return void 0;
+  return [...specific, ...BASE_INPUT_DESCRIPTORS];
+}
+function descriptorMap(descriptors) {
+  return new Map(descriptors.map((d) => [d.key, d]));
+}
+function coerceTemplateParams(template, params) {
+  const input = {};
+  const warnings = [];
+  const descriptors = template ? descriptorsFor(resolveTemplateName(template)) : void 0;
+  const byKey = descriptors ? descriptorMap(descriptors) : void 0;
+  for (const [key, raw] of Object.entries(params)) {
+    const coerce = byKey?.get(key)?.coerce ?? "string";
+    const { value, warning } = coerceValue(coerce, raw);
+    if (warning) {
+      warnings.push(`"${key}": ${warning}`);
+      input[key] = raw;
+    } else {
+      input[key] = value;
+    }
+  }
+  return { input, warnings };
+}
+function coerceValue(coerce, raw) {
+  switch (coerce) {
+    case "number": {
+      const n = parseNumber(raw);
+      return n == null ? { value: raw, warning: `not a number (${JSON.stringify(raw)})` } : { value: n };
+    }
+    case "boolean":
+      return coerceBoolean(raw);
+    case "latLng":
+      return coerceLatLng(raw);
+    case "labeledPair":
+      return { value: coerceLabeledPair(raw) };
+    case "stringList":
+      return { value: coerceStringList(raw) };
+    case "string":
+    default:
+      return { value: raw };
+  }
+}
+function coerceBoolean(raw) {
+  const t = raw.trim().toLowerCase();
+  if (t === "true" || t === "") return { value: true };
+  if (t === "false") return { value: false };
+  return { value: raw, warning: `not a boolean (${JSON.stringify(raw)}) \u2014 expected true or false` };
+}
+function coerceLatLng(raw) {
+  const parts = raw.split(",");
+  if (parts.length === 2) {
+    const lat = parseNumber(parts[0]);
+    const lng = parseNumber(parts[1]);
+    if (lat != null && lng != null) return { value: { lat, lng } };
+  }
+  return { value: raw, warning: `not a "lat,lng" pair (${JSON.stringify(raw)})` };
+}
+function coerceLabeledPair(raw) {
+  const sep = raw.indexOf("|");
+  if (sep < 0) return { label: raw.trim() };
+  const label = raw.slice(0, sep).trim();
+  const sublabel = raw.slice(sep + 1).trim();
+  return sublabel ? { label, sublabel } : { label };
+}
+function coerceStringList(raw) {
+  return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function lintTemplateParams(template, params) {
+  const canonical = resolveTemplateName(template);
+  const specific = TEMPLATE_INPUT_DESCRIPTORS[canonical];
+  if (!specific) return [];
+  const findings = [];
+  const allDescriptors = [...specific, ...BASE_INPUT_DESCRIPTORS];
+  const byKey = descriptorMap(allDescriptors);
+  const knownKeys = /* @__PURE__ */ new Set([...byKey.keys(), ...Object.keys(KNOWN_BLOCK_META_KEYS)]);
+  for (const [key, raw] of Object.entries(params)) {
+    const descriptor = byKey.get(key);
+    if (!descriptor) {
+      if (knownKeys.has(key)) continue;
+      const suggestion = nearestName(key, knownKeys);
+      findings.push({
+        kind: "unknown-input",
+        key,
+        message: `Unknown input "${key}" for template "${canonical}"` + (suggestion ? `. Did you mean "${suggestion}"?` : ""),
+        ...suggestion ? { suggestion } : {}
+      });
+      continue;
+    }
+    if (descriptor.values) {
+      const v = raw.trim();
+      if (v !== "" && !descriptor.values.includes(v)) {
+        findings.push({
+          kind: "invalid-input-value",
+          key,
+          message: `Invalid value ${JSON.stringify(raw)} for "${key}" \u2014 expected one of: ${descriptor.values.join(", ")}`
+        });
+      }
+    } else if (descriptor.coerce && descriptor.coerce !== "string") {
+      const { warning } = coerceValue(descriptor.coerce, raw);
+      if (warning) {
+        findings.push({ kind: "invalid-input-value", key, message: `"${key}": ${warning}` });
+      }
+    }
+  }
+  for (const descriptor of specific) {
+    if (descriptor.required && params[descriptor.key] == null) {
+      findings.push({
+        kind: "missing-input",
+        key: descriptor.key,
+        message: `Missing required input "${descriptor.key}" for template "${canonical}"`
+      });
+    }
+  }
+  return findings;
+}
+
 // src/doc/templates/metadata.ts
 var TEMPLATE_METADATA = {
   title: {
@@ -1440,7 +1858,7 @@ function factCard(input, context) {
   const { theme, viewport } = context;
   const accentLayout = accentImage ? getAccentLayout(accentImage.position) : DEFAULT_LAYOUT;
   const factFontSize = themedFontSize(56, context, true);
-  const explainFontSize = themedFontSize(28, context, false);
+  const explainFontSize = themedFontSize(34, context, false);
   const sourceFontSize = themedFontSize(20, context, false);
   const layers = [createBackgroundLayer("bg", themedSurfaceGradient(context, 170))];
   if (accentImage) {
@@ -1854,7 +2272,7 @@ function imageWithCaption(input, context) {
   const caption = rawCaption ? cleanCaption(rawCaption) : rawCaption;
   const { theme, layout } = context;
   const treatment = themedImageTreatment(context, input.imageTreatment);
-  const captionFontSize = themedFontSize(36, context, false);
+  const captionFontSize = themedFontSize(30, context, false);
   const titleFontSize = themedFontSize(96, context, true);
   const subtitleFontSize = themedFontSize(36, context, false);
   const legacyKenBurns = input.kenBurns;
@@ -1941,13 +2359,13 @@ function imageWithCaption(input, context) {
       id: "caption-gradient",
       content: {
         shape: "rect",
-        fill: `linear-gradient(0deg, ${withAlpha(bg, 0.8)} 0%, ${withAlpha(bg, 0.35)} 60%, ${withAlpha(bg, 0)} 100%)`
+        fill: `linear-gradient(90deg, ${withAlpha(bg, 0)}, ${withAlpha(bg, 0.78)} 16%, ${withAlpha(bg, 0.78)} 84%, ${withAlpha(bg, 0)})`
       },
       position: {
         x: 0,
-        y: "65%",
+        y: "68%",
         width: "100%",
-        height: "35%"
+        height: "16%"
       }
     });
     layers.push({
@@ -1960,14 +2378,16 @@ function imageWithCaption(input, context) {
           fontFamily: getThemeFont(context, "body"),
           color: theme.colors.text,
           textAlign: "center",
-          shadow: shouldUseShadow(context)
+          shadow: shouldUseShadow(context),
+          lineHeight: 1.18,
+          maxLines: 2
         }
       },
       position: {
         x: "50%",
-        y: "82%",
+        y: "74%",
         anchor: "center",
-        width: layout.maxTextWidth
+        width: "78%"
       },
       animation: { type: "fadeIn", duration: 1.5, delay: 0.5 }
     });
@@ -2351,10 +2771,8 @@ function photoGrid(input, context) {
       position: { x: 0, y: 0, width: "100%", height: "100%" }
     }
   ];
-  const captionHeight = caption ? layout.stackColumns ? 16 : 14 : 0;
-  const gridHeight = 100 - captionHeight;
+  const gridHeight = 100;
   const positions = getGridPositions(images.length, gridHeight, layout.stackColumns);
-  const altFontSize = themedFontSize(24, context, false);
   for (let i = 0; i < Math.min(images.length, 4); i++) {
     const img = images[i];
     const pos = positions[i];
@@ -2364,22 +2782,6 @@ function photoGrid(input, context) {
       content: { shape: "rect", fill: theme.colors.background },
       position: { x: `${pos.x}%`, y: `${pos.y}%`, width: `${pos.w}%`, height: `${pos.h}%` }
     });
-    if (img.alt) {
-      layers.push({
-        type: "text",
-        id: `grid-alt-${i}`,
-        content: {
-          text: img.alt,
-          style: {
-            fontSize: altFontSize,
-            fontFamily: getThemeFont(context, "body"),
-            color: theme.colors.textMuted,
-            textAlign: "center"
-          }
-        },
-        position: { x: `${pos.x + pos.w / 2}%`, y: `${pos.y + pos.h / 2}%`, anchor: "center" }
-      });
-    }
     layers.push({
       type: "image",
       id: `grid-img-${i}`,
@@ -2402,15 +2804,19 @@ function photoGrid(input, context) {
     });
   }
   if (caption) {
-    const captionFontSize = themedFontSize(layout.stackColumns ? 28 : 32, context, false);
+    const captionFontSize = themedFontSize(layout.stackColumns ? 24 : 26, context, false);
+    const captionY = layout.stackColumns ? "78%" : "74%";
+    const captionBgY = layout.stackColumns ? "72%" : "68%";
+    const captionHeight = layout.stackColumns ? "13%" : "16%";
+    const bg = theme.colors.background;
     layers.push({
       type: "shape",
       id: "caption-bg",
       content: {
         shape: "rect",
-        fill: `linear-gradient(${withAlpha(theme.colors.background, 0)}, ${withAlpha(theme.colors.background, 0.85)})`
+        fill: `linear-gradient(90deg, ${withAlpha(bg, 0)}, ${withAlpha(bg, 0.78)} 16%, ${withAlpha(bg, 0.78)} 84%, ${withAlpha(bg, 0)})`
       },
-      position: { x: 0, y: `${gridHeight - 4}%`, width: "100%", height: `${captionHeight + 4}%` }
+      position: { x: 0, y: captionBgY, width: "100%", height: captionHeight }
     });
     layers.push({
       type: "text",
@@ -2422,14 +2828,16 @@ function photoGrid(input, context) {
           fontFamily: getThemeFont(context, "body"),
           color: theme.colors.text,
           textAlign: "center",
-          shadow: shouldUseShadow(context)
+          shadow: true,
+          lineHeight: 1.18,
+          maxLines: layout.stackColumns ? 2 : 1
         }
       },
       position: {
         x: "50%",
-        y: `${gridHeight + captionHeight / 2}%`,
+        y: captionY,
         anchor: "center",
-        width: "90%"
+        width: "78%"
       },
       animation: { type: "fadeIn", duration: 1, delay: 0.5 }
     });
@@ -2585,12 +2993,15 @@ function definitionCard(input, context) {
 
 // src/doc/templates/comparisonBar.ts
 function comparisonBar(input, context) {
-  const { leftLabel, leftValue, rightLabel, rightValue, unit, colorScheme = "blue" } = input;
+  const { leftLabel, rightLabel, unit, colorScheme = "blue" } = input;
   const { theme, viewport } = context;
   const colors = resolveColorScheme(context, colorScheme);
+  const leftValue = Number.isFinite(input.leftValue) ? input.leftValue : 0;
+  const rightValue = Number.isFinite(input.rightValue) ? input.rightValue : 0;
   const labelFontSize = themedFontSize(28, context, false);
   const valueFontSize = themedFontSize(48, context, true);
   const formatValue = (v) => {
+    if (!Number.isFinite(v)) return "\u2014";
     if (v >= 1e6) return `${(v / 1e6).toFixed(1)}M`;
     if (v >= 1e3) return `${(v / 1e3).toFixed(v >= 1e4 ? 0 : 1)}K`;
     return v.toLocaleString();
@@ -2841,8 +3252,8 @@ function videoWithCaption(input, context) {
     videoLicense
   } = input;
   const caption = rawCaption ? cleanCaption(rawCaption) : rawCaption;
-  const { theme, layout } = context;
-  const captionFontSize = themedFontSize(36, context, false);
+  const { theme } = context;
+  const captionFontSize = themedFontSize(30, context, false);
   const creditFontSize = themedFontSize(16, context, false);
   const layers = [
     // Background video clip
@@ -2865,22 +3276,22 @@ function videoWithCaption(input, context) {
   ];
   if (caption) {
     const bg = theme.colors.background;
-    const scrimAngle = captionPosition === "top" ? 180 : 0;
+    const captionBgY = captionPosition === "top" ? "7%" : captionPosition === "center" ? "42%" : "68%";
+    const captionY = captionPosition === "top" ? "13%" : captionPosition === "center" ? "48%" : "74%";
     layers.push({
       type: "shape",
       id: "caption-gradient",
       content: {
         shape: "rect",
-        fill: `linear-gradient(${scrimAngle}deg, ${withAlpha(bg, 0.8)} 0%, ${withAlpha(bg, 0.35)} 60%, ${withAlpha(bg, 0)} 100%)`
+        fill: `linear-gradient(90deg, ${withAlpha(bg, 0)}, ${withAlpha(bg, 0.78)} 16%, ${withAlpha(bg, 0.78)} 84%, ${withAlpha(bg, 0)})`
       },
       position: {
         x: 0,
-        y: captionPosition === "top" ? 0 : "65%",
+        y: captionBgY,
         width: "100%",
-        height: "35%"
+        height: "16%"
       }
     });
-    const captionY = captionPosition === "top" ? "15%" : captionPosition === "center" ? "50%" : "82%";
     layers.push({
       type: "text",
       id: "caption",
@@ -2891,14 +3302,16 @@ function videoWithCaption(input, context) {
           fontFamily: getThemeFont(context, "body"),
           color: theme.colors.text,
           textAlign: "center",
-          shadow: shouldUseShadow(context)
+          shadow: shouldUseShadow(context),
+          lineHeight: 1.18,
+          maxLines: 2
         }
       },
       position: {
         x: "50%",
         y: captionY,
         anchor: "center",
-        width: layout.maxTextWidth
+        width: "78%"
       },
       animation: { type: "fadeIn", duration: 1.5, delay: 0.5 }
     });
@@ -3259,7 +3672,7 @@ function diagramBlock(input, context) {
     const a = positions.get(edge.source);
     const b = positions.get(edge.target);
     if (!a || !b) continue;
-    const { start, end } = clipEndpoints(a, b);
+    const { start, end } = snapEndpoints(a, b);
     const pathLayer = {
       type: "path",
       id: `edge-${edge.id}`,
@@ -3695,7 +4108,7 @@ function drawingBlock(input, context) {
     const a = boxes.get(conn.from);
     const b = boxes.get(conn.to);
     if (!a || !b) continue;
-    const { start, end } = clipEndpoints(a, b);
+    const { start, end } = snapEndpoints(a, b);
     const path = {
       type: "path",
       id: `connector-${conn.id}`,
@@ -4050,11 +4463,25 @@ function emptyHint2(input, context) {
 }
 
 // src/doc/templates/coverBlock.ts
+var COVER_TITLE_BASE_PX = 120;
+var COVER_TITLE_COMFORTABLE_CHARS = 26;
+var COVER_TITLE_MIN_BASE_PX = 62;
+function fitCoverTitleSize(title) {
+  const len = title.trim().length;
+  if (len <= COVER_TITLE_COMFORTABLE_CHARS) return COVER_TITLE_BASE_PX;
+  const scaled = COVER_TITLE_BASE_PX * Math.sqrt(COVER_TITLE_COMFORTABLE_CHARS / len);
+  return Math.max(COVER_TITLE_MIN_BASE_PX, Math.round(scaled));
+}
+function isStandardLightCover(context) {
+  const { theme } = context;
+  return theme.id === "standard" && relativeLuminance(theme.colors.background) > 0.85;
+}
 function coverBlock(input, context) {
   const treatment = themedImageTreatment(context, input.imageTreatment);
   const { heroSrc, heroAlt, title, subtitle, ambientMotion, heroCredit, heroLicense } = input;
   const { theme, layout } = context;
-  const titleFontSize = themedFontSize(120, context, true);
+  const standardLightCover = !heroSrc && isStandardLightCover(context);
+  const titleFontSize = themedFontSize(fitCoverTitleSize(title), context, true);
   const subtitleFontSize = themedFontSize(40, context, false);
   const layers = [];
   if (heroSrc) {
@@ -4085,21 +4512,44 @@ function coverBlock(input, context) {
       }
     );
   } else {
-    layers.push({
-      type: "shape",
-      id: "cover-bg",
-      content: {
-        shape: "rect",
-        fill: `radial-gradient(ellipse at 50% 40%, ${theme.colors.primary} 0%, ${theme.colors.background} 100%)`
-      },
-      position: { x: 0, y: 0, width: "100%", height: "100%" }
-    });
+    if (standardLightCover) {
+      layers.push(
+        {
+          type: "shape",
+          id: "cover-bg",
+          content: {
+            shape: "rect",
+            fill: theme.colors.background
+          },
+          position: { x: 0, y: 0, width: "100%", height: "100%" }
+        },
+        {
+          type: "shape",
+          id: "cover-bg-tint",
+          content: {
+            shape: "rect",
+            fill: `radial-gradient(ellipse at 50% 40%, ${withAlpha(theme.colors.primary, 0.16)} 0%, ${withAlpha(theme.colors.primary, 0.07)} 38%, ${withAlpha(theme.colors.primary, 0)} 78%)`
+          },
+          position: { x: 0, y: 0, width: "100%", height: "100%" }
+        }
+      );
+    } else {
+      layers.push({
+        type: "shape",
+        id: "cover-bg",
+        content: {
+          shape: "rect",
+          fill: `radial-gradient(ellipse at 50% 40%, ${theme.colors.primary} 0%, ${theme.colors.background} 100%)`
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" }
+      });
+    }
     layers.push({
       type: "shape",
       id: "cover-accent",
       content: {
         shape: "rect",
-        fill: "rgba(255, 255, 255, 0.2)"
+        fill: standardLightCover ? withAlpha(theme.colors.primary, 0.24) : "rgba(255, 255, 255, 0.2)"
       },
       position: {
         x: "35%",
@@ -4120,7 +4570,7 @@ function coverBlock(input, context) {
         fontWeight: "bold",
         color: theme.colors.text,
         textAlign: "center",
-        shadow: true
+        shadow: !standardLightCover
       }
     },
     position: {
@@ -4141,7 +4591,8 @@ function coverBlock(input, context) {
         style: {
           fontSize: subtitleFontSize,
           fontFamily: getThemeFont(context, "body"),
-          color: theme.colors.textMuted,
+          fontWeight: standardLightCover ? "bold" : "normal",
+          color: standardLightCover ? withAlpha(theme.colors.text, 0.78) : theme.colors.textMuted,
           textAlign: "center",
           lineHeight: 1.5
         }
@@ -4243,7 +4694,11 @@ function expandTemplateBlock(templateBlock, context, registry = templateRegistry
     };
   }
   const { templateData, templateOverrides } = templateBlock;
-  const input = templateData || templateOverrides ? { ...templateBlock, ...templateData, ...templateOverrides } : templateBlock;
+  const input = templateData || templateOverrides ? {
+    ...templateBlock,
+    ...templateData,
+    ...coerceTemplateParams(templateBlock.template, templateOverrides ?? {}).input
+  } : templateBlock;
   let layers;
   try {
     layers = templateFn(input, context);
@@ -5047,7 +5502,7 @@ function readCustomTemplatesFromFrontmatter(frontmatter) {
   }
   return out.length > 0 ? out : void 0;
 }
-function writeCustomTemplatesToFrontmatter(templates) {
+function writeCustomTemplatesToFrontmatter(templates, options) {
   if (!templates || templates.length === 0) return void 0;
   const map = {};
   for (const def of templates) {
@@ -5057,7 +5512,7 @@ function writeCustomTemplatesToFrontmatter(templates) {
     entry.ly = renameKeys(def.layers, LONG_TO_SHORT);
     map[def.name] = entry;
   }
-  return JSON.stringify(map);
+  return JSON.stringify(map, null, options?.pretty ? 2 : void 0);
 }
 function readViewport(raw) {
   if (raw && typeof raw === "object") {
@@ -5139,11 +5594,11 @@ function readCustomThemesFromFrontmatter(frontmatter) {
   }
   return out.length > 0 ? out : void 0;
 }
-function writeCustomThemesToFrontmatter(themes) {
+function writeCustomThemesToFrontmatter(themes, options) {
   if (!themes || themes.length === 0) return void 0;
   const map = {};
   for (const theme of themes) map[theme.id] = theme;
-  return JSON.stringify(map);
+  return JSON.stringify(map, null, options?.pretty ? 2 : void 0);
 }
 
 // src/doc/structuredData.ts
@@ -5172,6 +5627,17 @@ function parseDataFence(node) {
     return { error: `invalid YAML: ${err instanceof Error ? err.message : String(err)}` };
   }
 }
+function replaceDataFence(contents, data) {
+  const value = JSON.stringify(data, null, 2);
+  const index = contents.findIndex((node) => node.type === "code" && isDataFence(node));
+  if (index < 0) {
+    const fence = { type: "code", lang: "json", meta: "data", value };
+    return [...contents, fence];
+  }
+  const next = [...contents];
+  next[index] = { ...contents[index], value };
+  return next;
+}
 function parseScalar(raw) {
   const trimmed = raw.trim();
   if (trimmed.length >= 2) {
@@ -5217,25 +5683,59 @@ function parseInlineValue(raw) {
 function parseYamlSubset(src) {
   const result = {};
   const lines = src.split("\n");
-  let pendingListKey = null;
+  let pendingKey = null;
+  let pendingKind = null;
+  let childIndent = -1;
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i];
     const trimmed = line.trim();
     if (!trimmed || trimmed.startsWith("#")) continue;
-    const indented = /^\s/.test(line);
-    if (indented && trimmed.startsWith("- ")) {
-      if (!pendingListKey) {
-        throw new Error(`line ${i + 1}: list item without a preceding "key:" line`);
+    const indent = line.length - line.trimStart().length;
+    if (indent > 0) {
+      if (!pendingKey) {
+        throw new Error(`line ${i + 1}: unexpected indented line without a preceding "key:" line`);
+      }
+      if (childIndent < 0) childIndent = indent;
+      if (indent > childIndent) {
+        throw new Error(
+          `line ${i + 1}: nesting deeper than one level is not supported \u2014 use a \`\`\`json data fence for nested input`
+        );
       }
-      result[pendingListKey].push(parseInlineValue(trimmed.slice(2)));
+      if (trimmed.startsWith("- ")) {
+        if (pendingKind === "map") {
+          throw new Error(
+            `line ${i + 1}: cannot mix list items and mapping keys under "${pendingKey}"`
+          );
+        }
+        pendingKind = "list";
+        result[pendingKey].push(parseInlineValue(trimmed.slice(2)));
+        continue;
+      }
+      if (pendingKind === "list") {
+        throw new Error(
+          `line ${i + 1}: cannot mix mapping keys and list items under "${pendingKey}"`
+        );
+      }
+      const subColon = trimmed.indexOf(":");
+      if (subColon < 1) {
+        throw new Error(`line ${i + 1}: expected "key: value"`);
+      }
+      const subValue = trimmed.slice(subColon + 1).trim();
+      if (subValue === "") {
+        throw new Error(
+          `line ${i + 1}: nesting deeper than one level is not supported \u2014 use a \`\`\`json data fence for nested input`
+        );
+      }
+      if (pendingKind !== "map") {
+        pendingKind = "map";
+        result[pendingKey] = {};
+      }
+      result[pendingKey][trimmed.slice(0, subColon).trim()] = parseInlineValue(subValue);
       continue;
     }
-    if (indented) {
-      throw new Error(
-        `line ${i + 1}: nested mappings are not supported \u2014 use a \`\`\`json data fence for nested input`
-      );
-    }
-    pendingListKey = null;
+    pendingKey = null;
+    pendingKind = null;
+    childIndent = -1;
     const colonIdx = trimmed.indexOf(":");
     if (colonIdx < 1) {
       throw new Error(`line ${i + 1}: expected "key: value"`);
@@ -5244,7 +5744,7 @@ function parseYamlSubset(src) {
     const rawValue = trimmed.slice(colonIdx + 1).trim();
     if (rawValue === "") {
       result[key] = [];
-      pendingListKey = key;
+      pendingKey = key;
     } else {
       result[key] = parseInlineValue(rawValue);
     }
@@ -5264,8 +5764,7 @@ function extractTableData(table) {
   };
 }
 
-// src/doc/mediaAnnotations.ts
-var MEDIA_TEMPLATES = /* @__PURE__ */ new Set(["audio", "video", "media"]);
+// src/doc/standaloneAnnotation.ts
 function parseStandaloneAnnotation(node) {
   if (node.type !== "paragraph") return null;
   const children = node.children ?? [];
@@ -5284,6 +5783,12 @@ function parseStandaloneAnnotation(node) {
   }
   return { template, params };
 }
+
+// src/doc/mediaAnnotations.ts
+var MEDIA_TEMPLATES = /* @__PURE__ */ new Set(["audio", "video", "media"]);
+function isMediaAnnotationName(name) {
+  return name != null && MEDIA_TEMPLATES.has(name);
+}
 function time(raw) {
   if (raw == null) return null;
   return parseTimeSeconds(raw);
@@ -5295,7 +5800,13 @@ function toMediaClip(parsed, id) {
   if (!src) return null;
   const kind = template === "video" ? "video" : "audio";
   const anchor = params.anchor === "document" || params.span === "document" ? "document" : "block";
-  const clip = { id, src, kind, startAt: time(params.startAt) ?? 0, anchor };
+  const clip = {
+    id,
+    src,
+    kind,
+    startAt: time(params.startAt ?? params.startTime) ?? 0,
+    anchor
+  };
   const clipStart = time(params.clipStart);
   const clipEnd = time(params.clipEnd);
   if (clipStart != null) clip.clipStart = clipStart;
@@ -5323,6 +5834,58 @@ function extractMediaFromContents(contents, makeId) {
   return { media, documentMedia, remaining };
 }
 
+// src/doc/annotationBlocks.ts
+function applyBlockMeta(block, m) {
+  if (m.x != null) block.x = m.x;
+  if (m.y != null) block.y = m.y;
+  if (m.startTime != null) block.startTime = m.startTime;
+  if (m.duration != null) block.duration = m.duration;
+  if (m.connectsTo) block.connectsTo = m.connectsTo;
+  if (m.transition) block.transition = m.transition;
+}
+function makeStandaloneBlock(parsed, options) {
+  const rawTemplate = parsed.template;
+  const params = parsed.params;
+  const hasParams = Object.keys(params).length > 0;
+  const block = {
+    id: options.makeId(parsed),
+    startTime: 0,
+    duration: options.defaultDuration,
+    audioSegment: 0,
+    template: resolveTemplateName(rawTemplate),
+    standaloneAnnotation: true,
+    // Keep the raw (un-resolved) name so validation can report the exact
+    // requested name — symmetric with `sourceHeading.templateAnnotation`.
+    sourceAnnotation: { template: rawTemplate, ...hasParams ? { params } : {} },
+    // Only carry a display title when the author supplied one.
+    ...params.title ? { title: params.title } : {}
+  };
+  if (hasParams) {
+    block.templateOverrides = params;
+    applyBlockMeta(block, coerceAnnotationValues(params).blockMeta);
+  }
+  return block;
+}
+function extractTemplateBlocksFromContents(contents, options) {
+  const leading = [];
+  const blocks = [];
+  let current = null;
+  for (const node of contents ?? []) {
+    const parsed = parseStandaloneAnnotation(node);
+    const isTemplateAnnotation = parsed != null && parsed.template != null && !isMediaAnnotationName(parsed.template);
+    if (isTemplateAnnotation) {
+      const block = makeStandaloneBlock(parsed, options);
+      blocks.push(block);
+      current = block;
+    } else if (current) {
+      (current.contents ?? (current.contents = [])).push(node);
+    } else {
+      leading.push(node);
+    }
+  }
+  return { leading, blocks };
+}
+
 // src/doc/markdownToDoc.ts
 var SLUG_NON_WORD_RE = /[^\w\s-]/g;
 var SLUG_SPACES_RE = /[\s_]+/g;
@@ -5345,9 +5908,15 @@ function createIdGenerator() {
   generate.reserve = (id) => {
     used.set(id, Math.max(used.get(id) ?? 0, 1));
   };
+  generate.fromText = (text) => {
+    const base = slugify(text);
+    const count = used.get(base) ?? 0;
+    used.set(base, count + 1);
+    return count === 0 ? base : `${base}-${count + 1}`;
+  };
   return generate;
 }
-function applyBlockMeta(block, m) {
+function applyBlockMeta2(block, m) {
   if (m.x != null) block.x = m.x;
   if (m.y != null) block.y = m.y;
   if (m.startTime != null) block.startTime = m.startTime;
@@ -5361,13 +5930,37 @@ function pinnedHeadingMeta(heading) {
   const fromPandoc = heading.attributes?.blockMeta ?? {};
   return { ...fromAnnotation, ...fromPandoc };
 }
+function pinnedMeta(block) {
+  if (block.sourceHeading) return pinnedHeadingMeta(block.sourceHeading);
+  if (block.sourceAnnotation?.params) {
+    return coerceAnnotationValues(block.sourceAnnotation.params).blockMeta;
+  }
+  return {};
+}
+function expandStandaloneAnnotations(blocks, makeId, defaultDuration) {
+  const out = [];
+  for (const block of blocks) {
+    if (block.children && block.children.length > 0) {
+      block.children = expandStandaloneAnnotations(block.children, makeId, defaultDuration);
+    }
+    const { leading, blocks: produced } = extractTemplateBlocksFromContents(block.contents, {
+      makeId,
+      defaultDuration
+    });
+    if (produced.length > 0) {
+      block.contents = leading;
+    }
+    out.push(block, ...produced);
+  }
+  return out;
+}
 function markdownToDoc(markdownDoc, options) {
   const articleId = options?.articleId ?? "markdown-doc";
   const defaultTemplate = options?.defaultTemplate ?? "sectionHeader";
   const defaultDuration = options?.defaultDuration ?? 5;
   const idGenerator = options?.generateId ? null : createIdGenerator();
   const generateId = options?.generateId ?? idGenerator;
-  const rootBlocks = [];
+  let rootBlocks = [];
   const diagnostics = [];
   let headingIndex = 0;
   const stack = [];
@@ -5400,12 +5993,12 @@ function markdownToDoc(markdownDoc, options) {
     };
     if (annotation?.params) {
       block.templateOverrides = annotation.params;
-      applyBlockMeta(block, coerceAnnotationValues(annotation.params).blockMeta);
+      applyBlockMeta2(block, coerceAnnotationValues(annotation.params).blockMeta);
     }
     const attrs = heading?.attributes;
     if (attrs) {
       if (attrs.blockMeta) {
-        applyBlockMeta(block, attrs.blockMeta);
+        applyBlockMeta2(block, attrs.blockMeta);
       }
       if (attrs.classes && attrs.classes.length > 0) {
         block.classes = attrs.classes;
@@ -5471,6 +6064,14 @@ function markdownToDoc(markdownDoc, options) {
   if (rootBlocks.length > 0 && !rootBlocks[0].sourceHeading && (rootBlocks[0].contents?.length ?? 0) === 0 && (rootBlocks[0].children?.length ?? 0) === 0 && !rootBlocks[0].media) {
     rootBlocks.shift();
   }
+  const makeStandaloneId = (parsed) => {
+    const base = parsed.params.title ?? parsed.template ?? "block";
+    return idGenerator ? idGenerator.fromText(base) : slugify(base);
+  };
+  rootBlocks = expandStandaloneAnnotations(rootBlocks, makeStandaloneId, defaultDuration);
+  if (rootBlocks.length > 0 && !rootBlocks[0].sourceHeading && !rootBlocks[0].standaloneAnnotation && (rootBlocks[0].contents?.length ?? 0) === 0 && (rootBlocks[0].children?.length ?? 0) === 0 && !rootBlocks[0].media) {
+    rootBlocks.shift();
+  }
   const allBlocks = flattenBlocks(rootBlocks);
   for (const block of allBlocks) {
     applyStructuredData(block, diagnostics);
@@ -5508,7 +6109,7 @@ function markdownToDoc(markdownDoc, options) {
   const minDuration = 3;
   const phrases = [];
   for (const block of allBlocks) {
-    if (pinnedHeadingMeta(block.sourceHeading).duration != null) continue;
+    if (pinnedMeta(block).duration != null) continue;
     const bodyText3 = getBlockBodyText2(block);
     if (bodyText3.length > 0) {
       const estimate = estimateReadingTime(bodyText3);
@@ -5519,7 +6120,7 @@ function markdownToDoc(markdownDoc, options) {
   }
   let currentTime = 0;
   for (const block of allBlocks) {
-    const explicitStart = pinnedHeadingMeta(block.sourceHeading).startTime;
+    const explicitStart = pinnedMeta(block).startTime;
     if (explicitStart == null) {
       block.startTime = currentTime;
     }
@@ -5759,12 +6360,15 @@ function buildStartBlock(markdownDoc, rootBlocks) {
 }
 
 // src/doc/docToMarkdown.ts
+var TRANSITION_PARAM_KEYS = ["transition", "transitionDuration", "transitionDirection"];
 function docToMarkdown(doc) {
   const children = [];
   function emitBlock(block) {
     if (block.sourceHeading) {
       const heading = ensureAnnotation(block, block.sourceHeading);
       children.push(heading);
+    } else if (block.standaloneAnnotation) {
+      children.push(synthesizeAnnotationParagraph(block));
     }
     if (block.contents) {
       children.push(...block.contents);
@@ -5801,43 +6405,65 @@ function docToMarkdown(doc) {
     ...frontmatter && Object.keys(frontmatter).length > 0 ? { frontmatter } : {}
   };
 }
+function synthesizeAnnotationParagraph(block) {
+  const text = serializeAnnotation(block.sourceAnnotation?.template, block.templateOverrides);
+  return { type: "paragraph", children: [{ type: "text", value: text }] };
+}
 function ensureAnnotation(block, heading) {
-  const attrs = ensureTransitionAttributes(block, heading);
+  const { attributes, transitionParams } = ensureTransitionMetadata(block, heading);
   const hasExplicitTemplate = block.template && block.template !== "sectionHeader" && block.autoTemplate !== true;
   const hasOverrides = block.templateOverrides && Object.keys(block.templateOverrides).length > 0;
-  if (heading.templateAnnotation) {
-    return attrs === heading.attributes ? heading : { ...heading, attributes: attrs };
+  let templateAnnotation = heading.templateAnnotation;
+  if (!templateAnnotation && (hasExplicitTemplate || hasOverrides || transitionParams)) {
+    templateAnnotation = {
+      ...hasExplicitTemplate ? { template: block.template ?? "sectionHeader" } : {},
+      ...hasOverrides ? { params: block.templateOverrides } : {}
+    };
   }
-  if (!hasExplicitTemplate && !hasOverrides) {
-    return attrs === heading.attributes ? heading : { ...heading, attributes: attrs };
+  if (transitionParams) {
+    templateAnnotation = {
+      ...templateAnnotation ?? {},
+      params: {
+        ...templateAnnotation?.params ?? {},
+        ...transitionParams
+      }
+    };
   }
-  return {
-    ...heading,
-    children: [...heading.children],
-    attributes: attrs,
-    templateAnnotation: {
-      template: block.template ?? "sectionHeader",
-      ...hasOverrides ? { params: block.templateOverrides } : {}
-    }
-  };
+  if (attributes === heading.attributes && templateAnnotation === heading.templateAnnotation) {
+    return heading;
+  }
+  return { ...heading, children: [...heading.children], attributes, templateAnnotation };
 }
-function ensureTransitionAttributes(block, heading) {
+function ensureTransitionMetadata(block, heading) {
   const transition = block.transition;
-  if (!transition) return heading.attributes;
-  const attrs = heading.attributes ?? {};
-  return {
+  if (!transition) {
+    return { attributes: heading.attributes, transitionParams: void 0 };
+  }
+  const attrs = removeTransitionParams(heading.attributes) ?? {};
+  const attributes = {
     ...attrs,
-    params: {
-      ...attrs.params ?? {},
-      transition: transition.type,
-      ...transition.duration !== void 0 ? { transitionDuration: String(transition.duration) } : {},
-      ...transition.direction ? { transitionDirection: transition.direction } : {}
-    },
     blockMeta: {
       ...attrs.blockMeta ?? {},
       transition
     }
   };
+  return {
+    attributes,
+    transitionParams: {
+      transition: transition.type,
+      ...transition.duration !== void 0 ? { transitionDuration: String(transition.duration) } : {},
+      ...transition.direction ? { transitionDirection: transition.direction } : {}
+    }
+  };
+}
+function removeTransitionParams(attrs) {
+  if (!attrs?.params) return attrs;
+  const params = { ...attrs.params };
+  for (const key of TRANSITION_PARAM_KEYS) delete params[key];
+  return {
+    ...attrs,
+    ...Object.keys(params).length > 0 ? { params } : { params: void 0 }
+  };
 }
 
 // src/doc/resolveDocTheme.ts
@@ -5950,7 +6576,11 @@ function getLayers(block, context = {}) {
         templateCtx.children = maybeChildren;
       }
       const { templateData, templateOverrides } = block;
-      const input = templateData || templateOverrides ? { ...block, ...templateData, ...templateOverrides } : block;
+      const input = templateData || templateOverrides ? {
+        ...block,
+        ...templateData,
+        ...coerceTemplateParams(block.template, templateOverrides ?? {}).input
+      } : block;
       let layers;
       try {
         const templateFn = templateRegistry[templateName];
@@ -6215,9 +6845,13 @@ function validateMarkdownDoc(markdownDoc, options) {
   const diagnostics = [...doc.diagnostics ?? []];
   const blocks = flattenBlocks(doc.blocks);
   const knownTemplates = collectKnownTemplates(doc, options);
+  const customNames = new Set(doc.customTemplates?.map((t) => t.name) ?? []);
   const visit = (block, parent) => {
     checkTemplate(block, parent, knownTemplates, diagnostics);
     checkAttributeCoercion(block, parent, diagnostics);
+    checkConflictingAnnotationKeys(block, diagnostics);
+    checkTemplateInputs(block, parent, customNames, diagnostics);
+    checkPossibleDataFences(block, diagnostics);
     if (isDrawingBlock(block)) checkDrawingConnectors(block, diagnostics);
     for (const child of block.children ?? []) visit(child, block);
   };
@@ -6234,6 +6868,7 @@ function validateMarkdownDoc(markdownDoc, options) {
     diagnostics,
     errorCount: diagnostics.filter((d) => d.severity === "error").length,
     warningCount: diagnostics.filter((d) => d.severity === "warning").length,
+    infoCount: diagnostics.filter((d) => d.severity === "info").length,
     doc
   };
 }
@@ -6249,11 +6884,13 @@ function isDrawingBlock(block) {
   return resolveTemplateName(block.template ?? "") === "drawing";
 }
 function checkTemplate(block, parent, known, diagnostics) {
-  const requested = block.sourceHeading?.templateAnnotation?.template;
+  const requested = block.sourceHeading?.templateAnnotation?.template ?? block.sourceAnnotation?.template;
   if (!requested) return;
   if (parent && isDrawingBlock(parent)) {
     if (isShapeName(requested)) return;
-    const suggestion2 = nearestName(requested, new Set(SHAPE_NAMES));
+    const suggestion2 = nearestName(requested, new Set(SHAPE_NAMES), {
+      map: resolveTemplateName
+    });
     diagnostics.push({
       severity: "warning",
       code: "unknown-shape",
@@ -6274,7 +6911,7 @@ function checkTemplate(block, parent, known, diagnostics) {
     return;
   }
   if (known.has(requested) || known.has(resolveTemplateName(requested))) return;
-  const suggestion = nearestName(requested, known);
+  const suggestion = nearestName(requested, known, { map: resolveTemplateName });
   diagnostics.push({
     severity: "warning",
     code: "unknown-template",
@@ -6283,6 +6920,33 @@ function checkTemplate(block, parent, known, diagnostics) {
     ...lineOf2(block)
   });
 }
+function checkTemplateInputs(block, parent, customNames, diagnostics) {
+  const requested = block.sourceHeading?.templateAnnotation?.template;
+  if (!requested) return;
+  if (parent && isDrawingBlock(parent)) return;
+  if (isShapeName(requested)) return;
+  const canonical = resolveTemplateName(requested);
+  if (customNames.has(requested) || customNames.has(canonical)) return;
+  const params = block.sourceHeading?.templateAnnotation?.params ?? {};
+  for (const finding of lintTemplateParams(canonical, params)) {
+    if (finding.kind === "missing-input" && isInputSatisfiable(canonical, block, finding.key)) {
+      continue;
+    }
+    diagnostics.push({
+      severity: "warning",
+      code: finding.kind,
+      message: `Block "${block.id}": ${finding.message}`,
+      blockId: block.id,
+      ...lineOf2(block)
+    });
+  }
+}
+function isInputSatisfiable(canonical, block, key) {
+  if (block.templateData && key in block.templateData) return true;
+  if (block[key] != null) return true;
+  const derived = deriveTemplateInputs(canonical, block.title ?? "", block.contents);
+  return derived != null && key in derived;
+}
 var NUMERIC_SHAPE_KEYS = ["x", "y", "width", "height", "w", "h", "strokeWidth", "borderRadius"];
 function checkAttributeCoercion(block, parent, diagnostics) {
   const params = block.sourceHeading?.attributes?.params;
@@ -6316,6 +6980,23 @@ function checkAttributeCoercion(block, parent, diagnostics) {
     }
   }
 }
+function checkConflictingAnnotationKeys(block, diagnostics) {
+  const annotationParams = block.sourceHeading?.templateAnnotation?.params;
+  const pandocParams = block.sourceHeading?.attributes?.params;
+  if (!annotationParams || !pandocParams) return;
+  for (const key of Object.keys(KNOWN_BLOCK_META_KEYS)) {
+    const fromAnnotation = annotationParams[key];
+    const fromPandoc = pandocParams[key];
+    if (fromAnnotation == null || fromPandoc == null || fromAnnotation === fromPandoc) continue;
+    diagnostics.push({
+      severity: "info",
+      code: "conflicting-annotation-key",
+      message: `"${key}" is set in both {[\u2026]} (${fromAnnotation}) and {\u2026} (${fromPandoc}) \u2014 the {\u2026} value wins.`,
+      blockId: block.id,
+      ...lineOf2(block)
+    });
+  }
+}
 function checkDrawingConnectors(block, diagnostics) {
   const children = block.children ?? [];
   const ids = new Set(children.map((c) => c.id));
@@ -6339,9 +7020,28 @@ function checkDrawingConnectors(block, diagnostics) {
     }
   }
 }
+function checkPossibleDataFences(block, diagnostics) {
+  const annotated = !!(block.sourceHeading?.templateAnnotation?.template || block.sourceAnnotation?.template);
+  if (!annotated) return;
+  for (const node of block.contents ?? []) {
+    if (node.type !== "code") continue;
+    const lang = node.lang?.toLowerCase();
+    if (lang !== "json" && lang !== "yaml" && lang !== "yml") continue;
+    if (isDataFence(node)) continue;
+    const result = parseDataFence(node);
+    if (!result.data || Object.keys(result.data).length === 0) continue;
+    diagnostics.push({
+      severity: "info",
+      code: "possible-data-fence",
+      message: `This ${lang} block renders as code \u2014 add "data" to the fence (\`\`\`${lang} data) if it's meant as template input.`,
+      blockId: block.id,
+      ...node.position ? { line: node.position.start.line } : lineOf2(block)
+    });
+  }
+}
 var ANNOTATION_LIKE_RE = /\{\[/;
 function checkUnrecognizedAnnotations(markdownDoc, diagnostics) {
-  const walk = (node, headingLine) => {
+  const walk = (node, headingLine, topLevel) => {
     if (node.type === "heading") {
       const heading = node;
       const text = extractPlainText(heading);
@@ -6355,22 +7055,26 @@ function checkUnrecognizedAnnotations(markdownDoc, diagnostics) {
       }
       return;
     }
+    if (node.type === "paragraph" && topLevel) {
+      const parsed = parseStandaloneAnnotation(node);
+      if (parsed && parsed.template != null) return;
+    }
     if (node.type === "text" && ANNOTATION_LIKE_RE.test(node.value)) {
       diagnostics.push({
         severity: "warning",
         code: "unparsed-annotation",
-        message: `Body text contains "{[\u2026]}" \u2014 template annotations are only recognized on headings (or the token is not a known inline icon)`,
+        message: `Body text contains "{[\u2026]}" \u2014 template annotations are recognized on headings and as standalone paragraphs (or the token is not a known inline icon)`,
         ...node.position ? { line: node.position.start.line } : headingLine != null ? { line: headingLine } : {}
       });
       return;
     }
     if (node.type === "code") return;
     for (const child of getChildren(node)) {
-      walk(child, headingLine);
+      walk(child, headingLine, false);
     }
   };
   for (const child of markdownDoc.children) {
-    walk(child, child.position?.start.line);
+    walk(child, child.position?.start.line, true);
   }
 }
 function normalizeAssetCheck(assets) {
@@ -6433,41 +7137,6 @@ function walkHtmlImages(nodes, report) {
     walkHtmlImages(node.children, report);
   }
 }
-function nearestName(input, candidates) {
-  let best;
-  let bestDist = Infinity;
-  const lower = input.toLowerCase();
-  for (const candidate of candidates) {
-    const dist = levenshtein(lower, candidate.toLowerCase());
-    if (dist < bestDist) {
-      bestDist = dist;
-      best = candidate;
-    }
-  }
-  if (best && (bestDist <= 2 || bestDist <= Math.ceil(input.length * 0.4))) {
-    return resolveTemplateName(best);
-  }
-  return void 0;
-}
-function levenshtein(a, b) {
-  if (a === b) return 0;
-  const m = a.length;
-  const n = b.length;
-  if (m === 0) return n;
-  if (n === 0) return m;
-  let prev = new Array(n + 1);
-  let curr = new Array(n + 1);
-  for (let j = 0; j <= n; j++) prev[j] = j;
-  for (let i = 1; i <= m; i++) {
-    curr[0] = i;
-    for (let j = 1; j <= n; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
-    }
-    [prev, curr] = [curr, prev];
-  }
-  return prev[n];
-}
 function lineOf2(block) {
   const line = block.sourceHeading?.position?.start.line;
   return line != null ? { line } : {};
@@ -6484,6 +7153,10 @@ export {
   wrapWithPersistentLayers,
   themeWantsAmbientMotion,
   applyRenderStyleToLayers,
+  BASE_INPUT_DESCRIPTORS,
+  TEMPLATE_INPUT_DESCRIPTORS,
+  coerceTemplateParams,
+  lintTemplateParams,
   TEMPLATE_METADATA,
   resolveColorScheme,
   getThemeFont,
@@ -6562,6 +7235,7 @@ export {
   writeCustomThemesToFrontmatter,
   isDataFence,
   parseDataFence,
+  replaceDataFence,
   parseYamlSubset,
   findFirstTable,
   extractTableData,
@@ -6579,4 +7253,4 @@ export {
   validateMarkdownSource,
   validateMarkdownDoc
 };
-//# sourceMappingURL=chunk-4ZFRZBU2.js.map
+//# sourceMappingURL=chunk-5TYS5V3G.js.map