@bendyline/squisq 2.3.2 → 2.4.0

package/dist/{chunk-CKZY6K5R.js → chunk-F2IEPSMA.js}

@@ -21,7 +21,7 @@ import {
   parseAsciiTimeline,
   pickAutoTemplate,
   profileBlockContents
-} from "./chunk-QWCFK5FN.js";
+} from "./chunk-CUYHFOFL.js";
 import {
   DEFAULT_THEME,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
@@ -49,14 +49,15 @@ import {
   matchTrailingTemplateAnnotation,
   parseNumber,
   parseTimeSeconds,
+  sanitizeUrl,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-ZQKZSJAX.js";
+} from "./chunk-2VCNTDNZ.js";
 import {
   extractPlainText,
   readFrontmatterThemeId,
   walkMarkdownTree
-} from "./chunk-BCCXTMN5.js";
+} from "./chunk-O7JILDEF.js";
 import {
   resolveBlockTransition
 } from "./chunk-4VOD55SX.js";
@@ -422,6 +423,16 @@ var TEMPLATE_ALIASES = Object.freeze({
 function resolveTemplateName(name) {
   return TEMPLATE_ALIASES[name] ?? name;
 }
+var TABLE_FED_TEMPLATES = /* @__PURE__ */ new Set([
+  "dataTable",
+  "barChart",
+  "columnChart",
+  "pieChart",
+  "donutChart",
+  "lineChart",
+  "areaChart",
+  "scatterChart"
+]);
 var CONTAINER_TEMPLATES = /* @__PURE__ */ new Set(["diagram", "drawing", "layout"]);
 function isContainerTemplate(name) {
   return !!name && CONTAINER_TEMPLATES.has(resolveTemplateName(name));
@@ -534,6 +545,8 @@ function titleBlock(input, context) {
   const baseBg = backgroundColor || theme.colors.primary;
   const maxWidthPx = parseFloat(layout.maxTextWidth) / 100 * viewport.width;
   const titleH = estimateTextHeight(title, titleFontSize, maxWidthPx, 1.15);
+  const titleLineCount = Math.max(1, Math.round(titleH / (titleFontSize * 1.15)));
+  const titleSubtitleGapPx = 56 + (titleLineCount > 1 ? titleFontSize * 0.25 : 0);
   const titleYPct = subtitle ? 42 : 48;
   const px = (v) => v / viewport.height * 100;
   const layers = [
@@ -618,7 +631,7 @@ function titleBlock(input, context) {
       },
       position: {
         x: "50%",
-        y: `${titleYPct + px(titleH / 2 + 56 + subH / 2)}%`,
+        y: `${titleYPct + px(titleH / 2 + titleSubtitleGapPx + subH / 2)}%`,
         anchor: "center",
         width: layout.maxTextWidth
       },
@@ -946,7 +959,7 @@ function sectionHeader(input, context) {
 
 // src/doc/templates/contentBlock.ts
 function completeBodyText(context) {
-  return (context.block?.contents ?? []).map((node) => extractPlainText(node)).join("\n").trim();
+  return (context.block?.contents ?? []).filter((node) => !(node.type === "code" && node.lang?.trim().toLowerCase() === "mermaid")).map((node) => extractPlainText(node)).join("\n").trim();
 }
 function bodyFontSize(body, context) {
   const base = body.length > 1800 ? 18 : body.length > 1100 ? 21 : body.length > 650 ? 24 : 28;
@@ -2021,6 +2034,821 @@ function fullBleedQuote(input, context) {
   ];
 }
 
+// src/doc/templates/diagramLayout.ts
+var DEFAULT_OPTS = {
+  gapX: 260,
+  gapY: 140,
+  gridPad: 80,
+  gridOriginX: 80,
+  gridOriginY: 80
+};
+function computeDiagramLayout(children, options = {}) {
+  const opts = { ...DEFAULT_OPTS, ...options };
+  const warnings = [];
+  const entries = [];
+  const unpositionedIdx = [];
+  for (let i = 0; i < children.length; i++) {
+    const c = children[i];
+    const hasX = typeof c.x === "number";
+    const hasY = typeof c.y === "number";
+    if (hasX && hasY) {
+      entries.push({ child: c, pinned: true, x: c.x, y: c.y });
+    } else {
+      entries.push({ child: c, pinned: false, x: 0, y: 0 });
+      unpositionedIdx.push(i);
+    }
+  }
+  if (unpositionedIdx.length > 0) {
+    const cols = Math.max(1, Math.ceil(Math.sqrt(unpositionedIdx.length)));
+    let baseX = opts.gridOriginX;
+    let baseY = opts.gridOriginY;
+    const pinned = entries.filter((e) => e.pinned);
+    if (pinned.length > 0) {
+      const minX = Math.min(...pinned.map((e) => e.x));
+      const maxY = Math.max(...pinned.map((e) => e.y));
+      baseX = minX;
+      baseY = maxY + opts.gridPad + opts.gapY;
+    }
+    unpositionedIdx.forEach((entryIdx, k) => {
+      const col = k % cols;
+      const row = Math.floor(k / cols);
+      entries[entryIdx].x = baseX + col * opts.gapX;
+      entries[entryIdx].y = baseY + row * opts.gapY;
+    });
+  }
+  const nodes = entries.map((e) => ({
+    id: e.child.id,
+    label: e.child.title ?? e.child.id,
+    x: e.x,
+    y: e.y,
+    pinned: e.pinned,
+    ...e.child.classes && e.child.classes.length > 0 ? { classes: e.child.classes } : {}
+  }));
+  const nodeIds = new Set(nodes.map((n) => n.id));
+  const edges = [];
+  const seenEdgeIds = /* @__PURE__ */ new Set();
+  for (const child of children) {
+    if (!child.connectsTo) continue;
+    for (const conn of child.connectsTo) {
+      if (!nodeIds.has(conn.target)) {
+        warnings.push(`Edge from "${child.id}" to "${conn.target}" dropped: no such sibling node`);
+        continue;
+      }
+      const edgeId = makeEdgeId(child.id, conn);
+      if (seenEdgeIds.has(edgeId)) continue;
+      seenEdgeIds.add(edgeId);
+      edges.push({
+        id: edgeId,
+        source: child.id,
+        target: conn.target,
+        ...conn.type ? { type: conn.type } : {}
+      });
+    }
+  }
+  return { nodes, edges, warnings };
+}
+function makeEdgeId(source, conn) {
+  return conn.type ? `${source}->${conn.target}:${conn.type}` : `${source}->${conn.target}`;
+}
+
+// src/doc/asciiDiagram/types.ts
+var ASCII_CHAR_W = 14;
+var ASCII_CHAR_H = 28;
+
+// src/doc/asciiDiagram/mapping.ts
+function asciiCellToCanvas(col, row) {
+  return { x: col * ASCII_CHAR_W, y: row * ASCII_CHAR_H };
+}
+function canvasToAsciiCell(x, y) {
+  return {
+    col: Math.max(0, Math.round(x / ASCII_CHAR_W)),
+    row: Math.max(0, Math.round(y / ASCII_CHAR_H))
+  };
+}
+function asciiDiagramToTemplateData(diagram) {
+  const nodes = diagram.nodes.map((n) => ({
+    id: n.id,
+    label: n.label,
+    ...asciiCellToCanvas(n.col, n.row),
+    w: n.wCols * ASCII_CHAR_W,
+    h: n.hRows * ASCII_CHAR_H,
+    ...n.containerId ? { container: n.containerId } : {}
+  }));
+  const anchors = inferEdgeAnchors(nodes, diagram.edges);
+  const edges = diagram.edges.map((e, index) => ({
+    source: e.source,
+    target: e.target,
+    ...e.label ? { label: e.label } : {},
+    ...e.directed ? {} : { directed: false },
+    ...anchors[index],
+    routing: "orthogonal"
+  }));
+  return { nodes, edges };
+}
+function inferEdgeAnchors(nodes, edges) {
+  const nodeById = new Map(nodes.map((node) => [node.id, node]));
+  const pairs = edges.map((edge) => {
+    const source = nodeById.get(edge.source);
+    const target = nodeById.get(edge.target);
+    if (!source || !target) {
+      return {
+        sourceAnchor: { side: "right", offset: 0.5 },
+        targetAnchor: { side: "left", offset: 0.5 }
+      };
+    }
+    const sourceW = source.w ?? ASCII_CHAR_W * 12;
+    const sourceH = source.h ?? ASCII_CHAR_H * 3;
+    const targetW = target.w ?? ASCII_CHAR_W * 12;
+    const targetH = target.h ?? ASCII_CHAR_H * 3;
+    const dx = target.x + targetW / 2 - (source.x + sourceW / 2);
+    const dy = target.y + targetH / 2 - (source.y + sourceH / 2);
+    const horizontalDistance = Math.abs(dx) / Math.max(1, (sourceW + targetW) / 2);
+    const verticalDistance = Math.abs(dy) / Math.max(1, (sourceH + targetH) / 2);
+    if (verticalDistance >= horizontalDistance) {
+      return dy >= 0 ? {
+        sourceAnchor: { side: "bottom", offset: 0.5 },
+        targetAnchor: { side: "top", offset: 0.5 }
+      } : {
+        sourceAnchor: { side: "top", offset: 0.5 },
+        targetAnchor: { side: "bottom", offset: 0.5 }
+      };
+    }
+    return dx >= 0 ? {
+      sourceAnchor: { side: "right", offset: 0.5 },
+      targetAnchor: { side: "left", offset: 0.5 }
+    } : {
+      sourceAnchor: { side: "left", offset: 0.5 },
+      targetAnchor: { side: "right", offset: 0.5 }
+    };
+  });
+  distributeOffsets(pairs, edges, nodes, "source");
+  distributeOffsets(pairs, edges, nodes, "target");
+  coalesceAlignedFanOutAnchors(pairs, edges, nodes);
+  return pairs;
+}
+function coalesceAlignedFanOutAnchors(pairs, edges, nodes) {
+  const nodeById = new Map(nodes.map((node) => [node.id, node]));
+  const groups = /* @__PURE__ */ new Map();
+  edges.forEach((edge, index) => {
+    const group = groups.get(edge.source) ?? [];
+    group.push(index);
+    groups.set(edge.source, group);
+  });
+  for (const [sourceId, indexes] of groups) {
+    if (indexes.length < 2) continue;
+    const source = nodeById.get(sourceId);
+    const targets = indexes.map((index) => nodeById.get(edges[index].target)).filter((node) => node !== void 0);
+    if (!source || targets.length !== indexes.length) continue;
+    const sourceW = source.w ?? ASCII_CHAR_W * 12;
+    const sourceH = source.h ?? ASCII_CHAR_H * 3;
+    const sourceRight = source.x + sourceW;
+    const sourceBottom = source.y + sourceH;
+    const targetRight = (target) => target.x + (target.w ?? ASCII_CHAR_W * 12);
+    const targetBottom = (target) => target.y + (target.h ?? ASCII_CHAR_H * 3);
+    let sourceSide;
+    let targetSide;
+    if (targets.every((target) => target.y >= sourceBottom)) {
+      sourceSide = "bottom";
+      targetSide = "top";
+    } else if (targets.every((target) => targetBottom(target) <= source.y)) {
+      sourceSide = "top";
+      targetSide = "bottom";
+    } else if (targets.every((target) => target.x >= sourceRight)) {
+      sourceSide = "right";
+      targetSide = "left";
+    } else if (targets.every((target) => targetRight(target) <= source.x)) {
+      sourceSide = "left";
+      targetSide = "right";
+    }
+    if (!sourceSide || !targetSide) continue;
+    for (const index of indexes) {
+      pairs[index] = {
+        sourceAnchor: { side: sourceSide, offset: 0.5 },
+        targetAnchor: { side: targetSide, offset: 0.5 }
+      };
+    }
+  }
+}
+function distributeOffsets(pairs, edges, nodes, endpoint) {
+  const nodeById = new Map(nodes.map((node) => [node.id, node]));
+  const groups = /* @__PURE__ */ new Map();
+  for (let index = 0; index < edges.length; index++) {
+    const edge = edges[index];
+    const anchor = endpoint === "source" ? pairs[index].sourceAnchor : pairs[index].targetAnchor;
+    const nodeId = endpoint === "source" ? edge.source : edge.target;
+    const key = `${nodeId}:${anchor.side}`;
+    const group = groups.get(key) ?? [];
+    group.push(index);
+    groups.set(key, group);
+  }
+  for (const indexes of groups.values()) {
+    if (indexes.length < 2) continue;
+    const side = endpoint === "source" ? pairs[indexes[0]].sourceAnchor.side : pairs[indexes[0]].targetAnchor.side;
+    indexes.sort((a, b) => {
+      const oppositeA = nodeById.get(endpoint === "source" ? edges[a].target : edges[a].source);
+      const oppositeB = nodeById.get(endpoint === "source" ? edges[b].target : edges[b].source);
+      const axisA = side === "top" || side === "bottom" ? oppositeA?.x ?? 0 : oppositeA?.y ?? 0;
+      const axisB = side === "top" || side === "bottom" ? oppositeB?.x ?? 0 : oppositeB?.y ?? 0;
+      return axisA - axisB || a - b;
+    });
+    indexes.forEach((edgeIndex, rank) => {
+      const anchor = endpoint === "source" ? pairs[edgeIndex].sourceAnchor : pairs[edgeIndex].targetAnchor;
+      anchor.offset = (rank + 1) / (indexes.length + 1);
+    });
+  }
+}
+function asciiDiagramFromTemplateData(nodes, edges, options = {}) {
+  const ids = new Set(nodes.map((n) => n.id));
+  const outNodes = nodes.map((n) => {
+    const { col, row } = canvasToAsciiCell(n.x, n.y);
+    const labelLines = n.label.length > 0 ? n.label.split("\n") : [];
+    const innerW = labelLines.reduce((w, l) => Math.max(w, l.length), 0);
+    const wCols = typeof n.w === "number" ? Math.max(3, Math.round(n.w / ASCII_CHAR_W)) : innerW + 4;
+    const hRows = typeof n.h === "number" ? Math.max(3, Math.round(n.h / ASCII_CHAR_H)) : labelLines.length + 2;
+    return {
+      id: n.id,
+      label: n.label,
+      col,
+      row,
+      wCols: Math.max(wCols, 3),
+      hRows: Math.max(hRows, 3),
+      ...n.container && ids.has(n.container) && n.container !== n.id ? { containerId: n.container } : {}
+    };
+  });
+  return {
+    nodes: outNodes,
+    edges: edges.filter((e) => ids.has(e.source) && ids.has(e.target)).map((e) => ({
+      source: e.source,
+      target: e.target,
+      ...e.label ? { label: e.label } : {},
+      directed: e.directed !== false
+    })),
+    style: options.style ?? "unicode",
+    warnings: []
+  };
+}
+function asciiDiagramFromBlocks(children, options = {}) {
+  const layout = computeDiagramLayout(children);
+  const nodes = layout.nodes.map((n) => ({
+    id: n.id,
+    label: n.label,
+    x: n.x,
+    y: n.y
+  }));
+  const edges = layout.edges.map((e) => ({
+    source: e.source,
+    target: e.target,
+    ...e.type ? { label: e.type } : {}
+  }));
+  const diagram = asciiDiagramFromTemplateData(nodes, edges, options);
+  diagram.warnings.push(...layout.warnings);
+  return diagram;
+}
+
+// src/doc/asciiTimeline/mapping.ts
+function asciiTimelineToTemplateData(timeline) {
+  const globalStart = timeline.tracks.length > 0 ? Math.min(...timeline.tracks.map((track) => track.startColumn)) : 0;
+  const globalEnd = timeline.tracks.length > 0 ? Math.max(...timeline.tracks.map((track) => track.endColumn)) : 1;
+  const span = Math.max(1, globalEnd - globalStart);
+  const tracks = timeline.tracks.map((track) => ({
+    id: track.id,
+    ...track.label ? { label: track.label } : {},
+    ...track.endLabel ? { endLabel: track.endLabel } : {},
+    events: track.events.map(
+      (event) => ({
+        id: event.id,
+        label: event.label,
+        ...event.description ? { description: event.description } : {},
+        position: clamp01((event.column - globalStart) / span),
+        ...event.side ? { side: event.side } : {},
+        ...event.descriptionSide ? { descriptionSide: event.descriptionSide } : {},
+        ...event.callout === false ? { callout: false } : {},
+        ...event.marker ? { marker: event.marker } : {}
+      })
+    )
+  }));
+  const links = timeline.links.map((link) => ({ ...link }));
+  return { tracks, links };
+}
+function clamp01(value) {
+  return Math.max(0, Math.min(1, value));
+}
+
+// src/doc/treeview/mapping.ts
+function treeToTemplateData(tree) {
+  return { items: tree.roots.map(toItem) };
+}
+function toItem(node) {
+  return {
+    id: node.id,
+    label: node.label,
+    ...node.isDir ? { isDir: true } : {},
+    ...node.comment ? { comment: node.comment } : {},
+    children: node.children.map(toItem)
+  };
+}
+function treeFromTemplateData(items, options = {}) {
+  const roots = items.map(fromItem);
+  return { roots, style: options.style ?? "unicode", warnings: [] };
+}
+function fromItem(item) {
+  const children = Array.isArray(item.children) ? item.children.map(fromItem) : [];
+  return {
+    id: typeof item.id === "string" && item.id ? item.id : "node",
+    label: typeof item.label === "string" ? item.label : "",
+    children,
+    isDir: item.isDir === true || children.length > 0,
+    ...item.comment ? { comment: item.comment } : {}
+  };
+}
+function treeFromMarkdownList(list) {
+  const usedIds = /* @__PURE__ */ new Map();
+  const slugify2 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "node";
+  const idFor = (label) => {
+    const base = slugify2(label.replace(/\/$/, ""));
+    const count = usedIds.get(base) ?? 0;
+    usedIds.set(base, count + 1);
+    return count === 0 ? base : `${base}-${count + 1}`;
+  };
+  const itemToNode = (item) => {
+    const labelNode = item.children.find((c) => c.type !== "list");
+    const label = labelNode ? extractPlainText(labelNode).trim() : "";
+    const childLists = item.children.filter((c) => c.type === "list");
+    const children = [];
+    for (const cl of childLists) for (const ci of cl.children) children.push(itemToNode(ci));
+    return {
+      id: idFor(label),
+      label,
+      children,
+      isDir: label.endsWith("/") || children.length > 0
+    };
+  };
+  return { roots: list.children.map(itemToNode), style: "unicode", warnings: [] };
+}
+function findFirstList(contents) {
+  return contents?.find((n) => n.type === "list");
+}
+
+// src/doc/templateInputs.ts
+var VIDEO_FILE_RE = /\.(?:webm|mp4|mov|m4v|ogv)(?:[?#].*)?$/i;
+function extractBodyPlainText(contents) {
+  if (!contents || contents.length === 0) return "";
+  return contents.filter((node) => !(node.type === "code" && node.lang?.trim().toLowerCase() === "mermaid")).map((n) => extractPlainText(n)).join("\n").trim();
+}
+function extractListItems(contents) {
+  return extractRichListItems(contents).map((item) => item.text);
+}
+function escapeInlineHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function renderInlineHtml(nodes) {
+  return nodes.map((node) => {
+    switch (node.type) {
+      case "text":
+        return escapeInlineHtml(node.value);
+      case "emphasis":
+        return `<em>${renderInlineHtml(node.children)}</em>`;
+      case "strong":
+        return `<strong>${renderInlineHtml(node.children)}</strong>`;
+      case "delete":
+        return `<del>${renderInlineHtml(node.children)}</del>`;
+      case "inlineCode":
+        return `<code>${escapeInlineHtml(node.value)}</code>`;
+      case "link": {
+        const label = renderInlineHtml(node.children);
+        const href = sanitizeUrl(node.url, "link");
+        if (!href) return label;
+        const title = node.title ? ` title="${escapeInlineHtml(node.title)}"` : "";
+        return `<a href="${escapeInlineHtml(href)}"${title}>${label}</a>`;
+      }
+      case "break":
+        return "<br>";
+      case "image":
+        return escapeInlineHtml(node.alt ?? "");
+      case "inlineMath":
+        return escapeInlineHtml(`$${node.value}$`);
+      case "footnoteReference":
+        return escapeInlineHtml(`[^${node.label ?? node.identifier}]`);
+      case "linkReference":
+      case "textDirective":
+        return renderInlineHtml(node.children);
+      case "imageReference":
+        return escapeInlineHtml(node.alt ?? "");
+      case "mention":
+        return escapeInlineHtml(`@${node.displayName}`);
+      case "inlineIcon":
+        return escapeInlineHtml(`{[${node.token}]}`);
+      case "htmlInline":
+        return escapeInlineHtml(node.rawHtml);
+    }
+  }).join("");
+}
+function renderListItemHtml(markdown) {
+  return markdown.map(
+    (node) => node.type === "paragraph" || node.type === "heading" ? renderInlineHtml(node.children) : escapeInlineHtml(extractPlainText(node))
+  ).join("<br>");
+}
+function extractRichListItems(contents) {
+  if (!contents) return [];
+  const items = [];
+  for (const node of contents) {
+    if (node.type !== "list") continue;
+    for (const item of node.children) {
+      const text = extractPlainText(item).trim();
+      if (!text) continue;
+      const html = renderListItemHtml(item.children);
+      const plainHtml = escapeInlineHtml(text).replace(/\r?\n/g, "<br>");
+      items.push({
+        text,
+        markdown: item.children,
+        ...html && html !== plainHtml ? { html } : {}
+      });
+    }
+  }
+  return items;
+}
+function parseDim(raw) {
+  if (raw === void 0) return void 0;
+  const n = parseFloat(raw);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+function extractImages(contents, limit = Infinity) {
+  if (!contents || contents.length === 0) return [];
+  const found = [];
+  function fromHtml(nodes) {
+    for (const node of nodes) {
+      if (found.length >= limit) return;
+      if (!node || typeof node !== "object") continue;
+      const n = node;
+      if (n.type === "htmlElement" && n.tagName === "img") {
+        const attrs = n.attributes;
+        if (attrs && typeof attrs.src === "string" && attrs.src) {
+          found.push({
+            src: attrs.src,
+            alt: typeof attrs.alt === "string" ? attrs.alt : "",
+            width: parseDim(attrs.width),
+            height: parseDim(attrs.height)
+          });
+        }
+      }
+      if (Array.isArray(n.children)) fromHtml(n.children);
+    }
+  }
+  function walk(node) {
+    if (found.length >= limit) return;
+    if (!node || typeof node !== "object") return;
+    const n = node;
+    if (n.type === "image" && typeof n.url === "string" && n.url) {
+      found.push({ src: n.url, alt: typeof n.alt === "string" ? n.alt : "" });
+      return;
+    }
+    if ((n.type === "htmlBlock" || n.type === "htmlInline") && Array.isArray(n.htmlChildren)) {
+      fromHtml(n.htmlChildren);
+    }
+    if (Array.isArray(n.children)) {
+      for (const child of n.children) walk(child);
+    }
+  }
+  for (const node of contents) {
+    if (found.length >= limit) break;
+    walk(node);
+  }
+  return found;
+}
+function extractFirstImage(contents) {
+  return extractImages(contents, 1)[0] ?? null;
+}
+function extractEmbeddedVideos(contents, limit = Infinity) {
+  if (!contents || contents.length === 0) return [];
+  const found = [];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (video) => {
+    if (!video.src || found.length >= limit || seen.has(video.src)) return;
+    seen.add(video.src);
+    found.push(video);
+  };
+  function nestedSource(children) {
+    if (!Array.isArray(children)) return void 0;
+    for (const child of children) {
+      if (!child || typeof child !== "object") continue;
+      const node = child;
+      if (node.tagName === "source") {
+        const attrs = node.attributes;
+        if (typeof attrs?.src === "string" && attrs.src) return attrs.src;
+      }
+      const nested = nestedSource(node.children);
+      if (nested) return nested;
+    }
+    return void 0;
+  }
+  function walk(node) {
+    if (found.length >= limit || !node || typeof node !== "object") return;
+    const n = node;
+    if (n.type === "htmlElement" && n.tagName === "video") {
+      const attrs = n.attributes;
+      const src = attrs?.src || nestedSource(n.children);
+      if (src) {
+        add({
+          src,
+          ...attrs?.poster ? { posterSrc: attrs.poster } : {},
+          alt: attrs?.["aria-label"] || attrs?.title || attrs?.alt || ""
+        });
+      }
+    } else if ((n.type === "link" || n.type === "image") && typeof n.url === "string" && VIDEO_FILE_RE.test(n.url)) {
+      add({
+        src: n.url,
+        alt: typeof n.alt === "string" ? n.alt : extractPlainText(n).trim()
+      });
+    }
+    if (Array.isArray(n.children)) n.children.forEach(walk);
+    if (Array.isArray(n.htmlChildren)) n.htmlChildren.forEach(walk);
+  }
+  contents.forEach(walk);
+  return found;
+}
+function extractFirstEmbeddedVideo(contents) {
+  return extractEmbeddedVideos(contents, 1)[0] ?? null;
+}
+function extractTableFromContents(contents) {
+  if (!contents) return null;
+  for (const node of contents) {
+    if (node.type === "table") {
+      const table = node;
+      const [headerRow, ...bodyRows] = table.children;
+      if (!headerRow) return null;
+      const headers = headerRow.children.map((cell) => extractPlainText(cell).trim());
+      const rows = bodyRows.map((row) => row.children.map((cell) => extractPlainText(cell).trim()));
+      return { headers, rows, align: table.align };
+    }
+  }
+  return null;
+}
+function extractBlockquoteText(contents) {
+  if (!contents) return "";
+  for (const node of contents) {
+    if (node.type === "blockquote") return extractPlainText(node).trim();
+  }
+  return "";
+}
+function firstParagraph(contents) {
+  if (!contents) return null;
+  const index = contents.findIndex((node) => node.type === "paragraph");
+  if (index < 0) return null;
+  return {
+    node: contents[index],
+    index
+  };
+}
+function leadingStrongStat(paragraph) {
+  for (const child of paragraph.children) {
+    if (child.type === "text" && child.value.trim() === "") continue;
+    if (child.type !== "strong") return null;
+    const text = extractPlainText(child).trim();
+    const match = text.match(/^(?:[$€£¥]\s*)?[+-]?\d+(?:[.,]\d+)*(?:\s?(?:[%‰x×]|[A-Za-z]+))?/);
+    return match?.[0].trim() || null;
+  }
+  return null;
+}
+function removeStatPhrase(text, start, end) {
+  const before = text.slice(0, start).trim();
+  let after = text.slice(end);
+  if (!before) after = after.replace(/^\s*(?:[-–—:]\s*)?/, "");
+  else after = after.trim();
+  return [before, after].filter(Boolean).join(" ").trim();
+}
+function bodyWithoutParagraphStat(contents, paragraphIndex, paragraphText, start, end) {
+  if (!contents) return "";
+  return contents.map(
+    (node, index) => index === paragraphIndex ? removeStatPhrase(paragraphText, start, end) : extractPlainText(node).trim()
+  ).filter(Boolean).join("\n").trim();
+}
+function deriveStatHighlightInputs(headingText, contents, bodyText3) {
+  const paragraph = firstParagraph(contents);
+  if (paragraph) {
+    const paragraphText = extractPlainText(paragraph.node).trim();
+    const strongStat = leadingStrongStat(paragraph.node);
+    if (strongStat) {
+      const start = paragraphText.indexOf(strongStat);
+      const description = bodyWithoutParagraphStat(
+        contents,
+        paragraph.index,
+        paragraphText,
+        start,
+        start + strongStat.length
+      );
+      return {
+        stat: strongStat,
+        description: description || headingText || strongStat
+      };
+    }
+  }
+  const trimmedHeading = headingText.trim();
+  const headingStat = matchNumberHighlight(trimmedHeading);
+  if (headingStat && headingStat.index === 0 && headingStat.end === trimmedHeading.length) {
+    return { stat: headingText, description: bodyText3 || headingText };
+  }
+  if (paragraph) {
+    const paragraphText = extractPlainText(paragraph.node).trim();
+    const bodyStat = matchNumberHighlight(paragraphText);
+    if (bodyStat) {
+      const description = bodyWithoutParagraphStat(
+        contents,
+        paragraph.index,
+        paragraphText,
+        bodyStat.index,
+        bodyStat.end
+      );
+      return {
+        stat: bodyStat.value,
+        description: description || headingText || bodyStat.value
+      };
+    }
+  }
+  return { stat: headingText, description: bodyText3 || headingText };
+}
+function normalizeCoverageText(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function autoTemplatePreservesContent(templateName, contents) {
+  const nodes = contents ?? [];
+  switch (templateName) {
+    case "quote":
+      return nodes.length === 1 && nodes[0]?.type === "blockquote";
+    case "dataTable":
+      return nodes.length === 1 && nodes[0]?.type === "table";
+    case "list":
+      return nodes.length === 1 && nodes[0]?.type === "list";
+    case "diagram":
+    case "timeline":
+      return nodes.length === 1 && nodes[0]?.type === "code";
+    case "tree":
+      return nodes.length === 1 && (nodes[0]?.type === "code" || nodes[0]?.type === "list");
+    case "photoGrid": {
+      const images = extractImages(nodes);
+      if (images.length < 2 || images.length > 4) return false;
+      const bodyText3 = normalizeCoverageText(extractBodyPlainText(nodes));
+      const representedText = normalizeCoverageText(
+        images.map((image) => image.alt).filter(Boolean).join(" ")
+      );
+      return bodyText3 === "" || bodyText3 === representedText;
+    }
+    case "videoWithCaption": {
+      const videos = extractEmbeddedVideos(nodes);
+      if (videos.length !== 1) return false;
+      const bodyText3 = normalizeCoverageText(extractBodyPlainText(nodes));
+      return bodyText3 === normalizeCoverageText(videos[0]?.alt ?? "");
+    }
+    case "leftFeature":
+    case "rightFeature":
+    case "statHighlight":
+      return true;
+    default:
+      return false;
+  }
+}
+function deriveTemplateInputs(templateName, headingText, contents, options = {}) {
+  const placeholders = options.placeholders === true;
+  const bodyText3 = extractBodyPlainText(contents);
+  switch (templateName) {
+    case "statHighlight": {
+      const inputs = deriveStatHighlightInputs(headingText, contents, bodyText3);
+      if (options.preserveSourceHeading && headingText && inputs.stat !== headingText && inputs.description !== headingText) {
+        return {
+          ...inputs,
+          description: headingText,
+          ...inputs.description ? { detail: inputs.description } : {}
+        };
+      }
+      return inputs;
+    }
+    case "quote": {
+      const quote = extractBlockquoteText(contents) || bodyText3;
+      if (quote) return { quote, ...headingText ? { title: headingText } : {} };
+      return { quote: headingText };
+    }
+    case "fullBleedQuote":
+    case "pullQuote": {
+      const text = extractBlockquoteText(contents) || bodyText3 || headingText;
+      return { text };
+    }
+    case "factCard":
+      return { fact: headingText, explanation: bodyText3 || headingText };
+    case "comparisonBar":
+      return placeholders ? { leftLabel: "A", leftValue: 60, rightLabel: "B", rightValue: 40 } : null;
+    case "list": {
+      const items = extractListItems(contents);
+      if (items.length > 0) return { items, ...headingText ? { title: headingText } : {} };
+      return placeholders ? { items: ["Item 1", "Item 2", "Item 3"] } : null;
+    }
+    case "definitionCard":
+      return { term: headingText, definition: bodyText3 || headingText };
+    case "dateEvent":
+      return { date: headingText, description: bodyText3 || headingText };
+    case "dataTable": {
+      const tableData = extractTableFromContents(contents);
+      if (tableData) return { ...tableData, ...headingText ? { title: headingText } : {} };
+      return placeholders ? { headers: ["Column"], rows: [["Data"]] } : null;
+    }
+    case "barChart":
+    case "columnChart":
+    case "pieChart":
+    case "donutChart":
+    case "lineChart":
+    case "areaChart":
+    case "scatterChart": {
+      const tableData = extractTableFromContents(contents);
+      if (tableData) {
+        return {
+          headers: tableData.headers,
+          rows: tableData.rows,
+          ...headingText ? { title: headingText } : {}
+        };
+      }
+      return placeholders && !bodyText3.trim() ? {
+        headers: ["Quarter", "Revenue", "Costs"],
+        rows: [
+          ["Q1", "40", "28"],
+          ["Q2", "55", "31"],
+          ["Q3", "48", "30"],
+          ["Q4", "62", "35"]
+        ],
+        ...headingText ? { title: headingText } : {}
+      } : null;
+    }
+    case "imageWithCaption": {
+      const img = extractFirstImage(contents);
+      if (!img) return placeholders ? { caption: headingText } : null;
+      return { imageSrc: img.src, imageAlt: img.alt || headingText, caption: headingText };
+    }
+    case "photoGrid": {
+      const images = extractImages(contents, 4);
+      if (images.length < 2) return placeholders ? {} : null;
+      return {
+        images: images.map((i) => ({ src: i.src, alt: i.alt })),
+        caption: headingText
+      };
+    }
+    case "videoWithCaption": {
+      const video = extractFirstEmbeddedVideo(contents);
+      if (!video) return placeholders ? { caption: headingText } : null;
+      return {
+        videoSrc: video.src,
+        posterSrc: video.posterSrc,
+        videoAlt: video.alt || headingText,
+        caption: headingText
+      };
+    }
+    case "leftFeature":
+    case "rightFeature": {
+      const img = extractFirstImage(contents);
+      if (!img && !placeholders) return null;
+      return {
+        imageSrc: img?.src ?? "",
+        imageAlt: img?.alt || headingText,
+        imageWidth: img?.width,
+        imageHeight: img?.height,
+        title: headingText,
+        body: bodyText3
+      };
+    }
+    case "diagram": {
+      const fences = (contents ?? []).filter((n) => n.type === "code");
+      const fence = fences.length === 1 && isEligibleAsciiFenceLang(fences[0].lang) ? fences[0] : void 0;
+      const detection = fence ? detectAsciiDiagram(fence.value, { explicit: isExplicitDiagramLang(fence.lang) }) : void 0;
+      if (!detection?.isDiagram || !detection.diagram) return placeholders ? {} : null;
+      const { nodes, edges } = asciiDiagramToTemplateData(detection.diagram);
+      return { nodes, edges, ...headingText ? { title: headingText } : {} };
+    }
+    case "timeline": {
+      const fences = (contents ?? []).filter((n) => n.type === "code");
+      const fence = fences.length === 1 && isEligibleAsciiTimelineFenceLang(fences[0].lang) ? fences[0] : void 0;
+      const detection = fence ? detectAsciiTimeline(fence.value, { explicit: true }) : void 0;
+      if (!detection?.isTimeline || !detection.timeline) return placeholders ? {} : null;
+      const { tracks, links } = asciiTimelineToTemplateData(detection.timeline);
+      return { tracks, links, ...headingText ? { title: headingText } : {} };
+    }
+    case "tree": {
+      const fences = (contents ?? []).filter((n) => n.type === "code");
+      const fence = fences.length === 1 && isEligibleTreeFenceLang(fences[0].lang) ? fences[0] : void 0;
+      if (fence) {
+        const detection = detectTree(fence.value, { explicit: isExplicitTreeLang(fence.lang) });
+        if (detection.isTree && detection.tree) {
+          const { items } = treeToTemplateData(detection.tree);
+          return { items, ...headingText ? { title: headingText } : {} };
+        }
+      }
+      const list = findFirstList(contents);
+      if (list) {
+        const { items } = treeToTemplateData(treeFromMarkdownList(list));
+        if (items.length > 0) return { items, ...headingText ? { title: headingText } : {} };
+      }
+      return placeholders ? {} : null;
+    }
+    default:
+      return placeholders ? {} : null;
+  }
+}
+
 // src/doc/templates/listBlock.ts
 var LIST_ITEM_LINE_HEIGHT = 1.2;
 var LIST_ITEM_GAP_PX = 18;
@@ -2049,6 +2877,7 @@ function estimateWrappedLineCount(text, fontSize, maxWidth) {
 function listBlock(input, context) {
   const { title, accentImage } = input;
   const items = Array.isArray(input.items) ? input.items : [];
+  const richItems = extractRichListItems(context.block?.contents);
   const { theme } = context;
   const accentLayout = accentImage ? getAccentLayout(accentImage.position) : DEFAULT_LAYOUT;
   const titleFontSize = themedFontSize(44, context, true);
@@ -2112,6 +2941,7 @@ function listBlock(input, context) {
   let itemY = startY;
   for (let i = 0; i < items.length; i++) {
     const itemText = items[i];
+    const itemHtml = richItems[i]?.text === itemText ? richItems[i]?.html : void 0;
     const lineCount = estimateWrappedLineCount(itemText, itemFontSize, bodyWidthPx);
     const animation = themedEntrance(context, "text", {
       type: "fadeIn",
@@ -2144,6 +2974,7 @@ function listBlock(input, context) {
       id: `item-${i}`,
       content: {
         text: itemText,
+        ...itemHtml ? { html: itemHtml } : {},
         style: {
           fontSize: itemFontSize,
           fontFamily: getThemeFont(context, "body"),
@@ -2985,83 +3816,6 @@ function wrappedLineCount(text, fontSize, maxWidth) {
   return Math.max(1, lines);
 }
 
-// src/doc/templates/diagramLayout.ts
-var DEFAULT_OPTS = {
-  gapX: 260,
-  gapY: 140,
-  gridPad: 80,
-  gridOriginX: 80,
-  gridOriginY: 80
-};
-function computeDiagramLayout(children, options = {}) {
-  const opts = { ...DEFAULT_OPTS, ...options };
-  const warnings = [];
-  const entries = [];
-  const unpositionedIdx = [];
-  for (let i = 0; i < children.length; i++) {
-    const c = children[i];
-    const hasX = typeof c.x === "number";
-    const hasY = typeof c.y === "number";
-    if (hasX && hasY) {
-      entries.push({ child: c, pinned: true, x: c.x, y: c.y });
-    } else {
-      entries.push({ child: c, pinned: false, x: 0, y: 0 });
-      unpositionedIdx.push(i);
-    }
-  }
-  if (unpositionedIdx.length > 0) {
-    const cols = Math.max(1, Math.ceil(Math.sqrt(unpositionedIdx.length)));
-    let baseX = opts.gridOriginX;
-    let baseY = opts.gridOriginY;
-    const pinned = entries.filter((e) => e.pinned);
-    if (pinned.length > 0) {
-      const minX = Math.min(...pinned.map((e) => e.x));
-      const maxY = Math.max(...pinned.map((e) => e.y));
-      baseX = minX;
-      baseY = maxY + opts.gridPad + opts.gapY;
-    }
-    unpositionedIdx.forEach((entryIdx, k) => {
-      const col = k % cols;
-      const row = Math.floor(k / cols);
-      entries[entryIdx].x = baseX + col * opts.gapX;
-      entries[entryIdx].y = baseY + row * opts.gapY;
-    });
-  }
-  const nodes = entries.map((e) => ({
-    id: e.child.id,
-    label: e.child.title ?? e.child.id,
-    x: e.x,
-    y: e.y,
-    pinned: e.pinned,
-    ...e.child.classes && e.child.classes.length > 0 ? { classes: e.child.classes } : {}
-  }));
-  const nodeIds = new Set(nodes.map((n) => n.id));
-  const edges = [];
-  const seenEdgeIds = /* @__PURE__ */ new Set();
-  for (const child of children) {
-    if (!child.connectsTo) continue;
-    for (const conn of child.connectsTo) {
-      if (!nodeIds.has(conn.target)) {
-        warnings.push(`Edge from "${child.id}" to "${conn.target}" dropped: no such sibling node`);
-        continue;
-      }
-      const edgeId = makeEdgeId(child.id, conn);
-      if (seenEdgeIds.has(edgeId)) continue;
-      seenEdgeIds.add(edgeId);
-      edges.push({
-        id: edgeId,
-        source: child.id,
-        target: conn.target,
-        ...conn.type ? { type: conn.type } : {}
-      });
-    }
-  }
-  return { nodes, edges, warnings };
-}
-function makeEdgeId(source, conn) {
-  return conn.type ? `${source}->${conn.target}:${conn.type}` : `${source}->${conn.target}`;
-}
-
 // src/doc/templates/diagramBlock.ts
 var NODE_WIDTH = 180;
 var NODE_HEIGHT = 64;
@@ -3135,7 +3889,7 @@ function nodesFromTemplateData(input) {
 }
 function diagramBlock(input, context) {
   const { theme, viewport, children = [] } = context;
-  const colors = resolveColorScheme(context, input.colorScheme ?? "blue");
+  const colors = input.colorScheme ? resolveColorScheme(context, input.colorScheme) : void 0;
   const resolved = children.length > 0 ? nodesFromChildren(context) : input.nodes && input.nodes.length > 0 ? nodesFromTemplateData(input) : { nodes: [], edges: [] };
   if (resolved.nodes.length === 0) {
     return [
@@ -3205,9 +3959,9 @@ function diagramBlock(input, context) {
       id: `node-card-${node.id}`,
       content: {
         shape: "rect",
-        fill: colors.bg ?? theme.colors.backgroundLight,
+        fill: colors?.bg ?? theme.colors.backgroundLight,
         fillOpacity: 0.25,
-        stroke: colors.text ?? theme.colors.primary,
+        stroke: colors?.text ?? theme.colors.primary,
         strokeWidth: Math.max(1, strokeW - 1),
         borderRadius: 10
       },
@@ -3236,7 +3990,7 @@ function diagramBlock(input, context) {
       id: `edge-${edge.id}`,
       content: {
         d: connectorPath(edge.routing ?? input.edgeStyle ?? "curved", start, end),
-        stroke: colors.text ?? theme.colors.primary,
+        stroke: colors?.text ?? theme.colors.primary,
         strokeWidth: strokeW,
         fill: "none",
         ...edgeDash ? { dasharray: edgeDash } : {},
@@ -3274,8 +4028,8 @@ function diagramBlock(input, context) {
       id: `node-card-${node.id}`,
       content: {
         shape: "rect",
-        fill: colors.bg ?? theme.colors.backgroundLight,
-        stroke: colors.text ?? theme.colors.primary,
+        fill: colors?.bg ?? theme.colors.backgroundLight,
+        stroke: colors?.text ?? theme.colors.primary,
         strokeWidth: strokeW,
         borderRadius: input.nodeShape === "pill" ? t.h / 2 : 10
       },
@@ -3293,7 +4047,7 @@ function diagramBlock(input, context) {
           fontSize: fit.fontSize,
           fontFamily: getThemeFont(context, "body"),
           fontWeight: "bold",
-          color: colors.text ?? theme.colors.text,
+          color: colors?.text ?? theme.colors.text,
           textAlign: "center",
           lineHeight: DIAGRAM_LABEL_LINE_HEIGHT
         }
@@ -3425,7 +4179,7 @@ function treeBlock(input, context) {
 }
 
 // src/doc/templates/timelineBlock.ts
-var clamp01 = (value) => Math.max(0, Math.min(1, value));
+var clamp012 = (value) => Math.max(0, Math.min(1, value));
 var clamp = (value, min, max) => Math.max(min, Math.min(max, value));
 function safeId(value) {
   return value.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "item";
@@ -3452,7 +4206,7 @@ function coerceTracks(raw) {
         events.push({
           id: eventId,
           label: event.label,
-          position: clamp01(position),
+          position: clamp012(position),
           ...typeof event.description === "string" && event.description.trim() ? { description: event.description.trim() } : {},
           ...side ? { side } : {},
           ...descriptionSide ? { descriptionSide } : {},
@@ -3583,7 +4337,7 @@ function timelineBlock(input, context) {
   const eventFontSize = Math.min(baseEventFontSize, 24 * minViewportScale);
   const descriptionFontSize = Math.min(baseDescriptionFontSize, 17 * minViewportScale);
   const trackMarkerRadii = tracks.map((track) => {
-    const positions = track.events.map((event) => clamp01(event.position)).sort((a, b) => a - b);
+    const positions = track.events.map((event) => clamp012(event.position)).sort((a, b) => a - b);
     let minGapPx = Number.POSITIVE_INFINITY;
     for (let index = 1; index < positions.length; index++) {
       minGapPx = Math.min(minGapPx, (positions[index] - positions[index - 1]) * axisWidth);
@@ -3662,7 +4416,7 @@ function timelineBlock(input, context) {
         event,
         trackIndex,
         eventIndex,
-        x: axisStartX + axisWidth * clamp01(event.position),
+        x: axisStartX + axisWidth * clamp012(event.position),
         y
       };
       eventPoints.push(point);
@@ -4860,1119 +5614,1580 @@ function resolveLayer(layer, block, images, item) {
 
 // src/doc/templates/customTemplate.ts
 function makeCustomTemplateFn(def) {
-  return (input, context) => {
-    const block = context.block ?? input;
-    if (!block) return def.layers.slice();
-    return resolveTokens(def.layers, block);
-  };
-}
-
-// src/doc/templates/registry.ts
-var templateRegistry = {
-  title: titleBlock,
-  sectionHeader,
-  content: contentBlock,
-  statHighlight,
-  quote: quoteBlock,
-  factCard,
-  twoColumn,
-  dateEvent,
-  imageWithCaption,
-  leftFeature,
-  rightFeature,
-  map: mapBlock,
-  fullBleedQuote,
-  list: listBlock,
-  photoGrid,
-  definitionCard,
-  comparisonBar,
-  pullQuote,
-  videoWithCaption,
-  videoPullQuote,
-  dataTable,
-  diagram: diagramBlock,
-  tree: treeBlock,
-  timeline: timelineBlock,
-  layout: layoutBlock,
-  drawing: drawingBlock
-};
-function buildRegistry(custom) {
-  const merged = {
-    ...templateRegistry
-  };
-  if (custom) {
-    for (const definition of custom) {
-      if (merged[definition.name]) continue;
-      merged[definition.name] = makeCustomTemplateFn(
-        definition
-      );
-    }
-  }
-  return merged;
-}
-
-// src/doc/utils/applyRenderStyle.ts
-var AMBIENT_VARIANTS = [
-  { type: "slowZoom", direction: "in" },
-  { type: "slowZoom", direction: "out" },
-  { type: "slowZoom", panDirection: "left" },
-  { type: "slowZoom", panDirection: "right" }
-];
-var MIN_AMBIENT_DURATION_SECONDS = 8;
-function isZeroish(v) {
-  return v === 0 || v === "0" || v === "0%";
-}
-function isFullBleedCoverMedia(layer) {
-  if (layer.type !== "image" && layer.type !== "video") return false;
-  const { position } = layer;
-  if (!isZeroish(position.x) || !isZeroish(position.y)) return false;
-  if (position.width !== "100%" || position.height !== "100%") return false;
-  const fit = layer.content.fit;
-  return fit === void 0 || fit === "cover";
-}
-function themeWantsAmbientMotion(theme) {
-  return theme.renderStyle.ambientMotion === true;
-}
-function applyRenderStyleToLayers(layers, block, theme) {
-  const speed = theme.style.animationSpeed ?? 1;
-  const ambient = themeWantsAmbientMotion(theme);
-  if (speed === 1 && !ambient) return layers;
-  return layers.map((layer) => {
-    let animation = layer.animation;
-    if (!animation && ambient && isFullBleedCoverMedia(layer)) {
-      const rng = new SeededRandom(hashString(`${block.id}:${layer.id}`));
-      const variant = rng.pickRequired(AMBIENT_VARIANTS);
-      animation = {
-        ...variant,
-        duration: Math.max(MIN_AMBIENT_DURATION_SECONDS, block.duration ?? 0)
-      };
-    }
-    if (!animation || animation.type === "none") {
-      return animation === layer.animation ? layer : { ...layer, animation };
-    }
-    if (speed !== 1) {
-      animation = {
-        ...animation,
-        ...animation.duration != null ? { duration: animation.duration * speed } : {},
-        ...animation.delay != null ? { delay: animation.delay * speed } : {}
-      };
-    }
-    return animation === layer.animation ? layer : { ...layer, animation };
-  });
-}
-
-// 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 (input, context) => {
+    const block = context.block ?? input;
+    if (!block) return def.layers.slice();
+    return resolveTokens(def.layers, block);
+  };
+}
+
+// src/doc/templates/chart/parse.ts
+var NUMERIC_COLUMN_THRESHOLD = 0.6;
+function parseCellNumber(raw) {
+  if (typeof raw !== "string") return null;
+  let text = raw.trim();
+  if (!text) return null;
+  let negative = false;
+  const accounting = /^\((.*)\)$/.exec(text);
+  if (accounting) {
+    negative = true;
+    text = accounting[1].trim();
+  }
+  text = text.replace(/^([+-]?)\s*[$€£¥]\s*/, "$1");
+  text = text.replace(/%$/, "").trim();
+  text = text.replace(/,/g, "");
+  if (/^[+-]?\d{1,3}(?: \d{3})+(?:\.\d+)?$/.test(text)) {
+    text = text.replace(/ /g, "");
+  }
+  if (!/^[+-]?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i.test(text)) return null;
+  const value = Number(text);
+  if (!Number.isFinite(value)) return null;
+  return negative ? -value : value;
+}
+function isNumericColumn(rows, colIndex) {
+  let nonEmpty = 0;
+  let numeric = 0;
+  for (const row of rows) {
+    const cell = (row[colIndex] ?? "").trim();
+    if (!cell) continue;
+    nonEmpty += 1;
+    if (parseCellNumber(cell) !== null) numeric += 1;
+  }
+  return numeric > 0 && numeric / Math.max(1, nonEmpty) >= NUMERIC_COLUMN_THRESHOLD;
+}
+function resolveColumnRef(ref, headers) {
+  const text = String(ref).trim();
+  if (!text) return null;
+  const lower = text.toLowerCase();
+  const byName = headers.findIndex((h) => h.trim().toLowerCase() === lower);
+  if (byName >= 0) return byName;
+  if (/^\d+$/.test(text)) {
+    const index = Number(text);
+    if (index < headers.length) return index;
   }
-  return prev[n];
+  return null;
 }
-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;
+function buildChartData(table, options = {}) {
+  const headers = Array.isArray(table.headers) ? table.headers : [];
+  const rows = Array.isArray(table.rows) ? table.rows : [];
+  if (headers.length === 0 || rows.length === 0) return null;
+  const warnings = [];
+  let labelIndex = 0;
+  if (options.labelColumn !== void 0 && String(options.labelColumn).trim() !== "") {
+    const resolved = resolveColumnRef(String(options.labelColumn), headers);
+    if (resolved === null) {
+      warnings.push(
+        `labelColumn "${options.labelColumn}" matches no column; using the first column`
+      );
+    } else {
+      labelIndex = resolved;
+    }
+  }
+  let valueIndexes = [];
+  const requested = (options.valueColumns ?? []).map((ref) => String(ref)).filter((ref) => ref.trim() !== "");
+  if (requested.length > 0) {
+    for (const ref of requested) {
+      const resolved = resolveColumnRef(ref, headers);
+      if (resolved === null) {
+        warnings.push(`valueColumns entry "${ref}" matches no column; skipped`);
+      } else if (!valueIndexes.includes(resolved)) {
+        valueIndexes.push(resolved);
+      }
     }
+  } else {
+    valueIndexes = headers.map((_, index) => index).filter((index) => index !== labelIndex && isNumericColumn(rows, index));
   }
-  if (best && (bestDist <= maxDistance || bestDist <= Math.ceil(input.length * 0.4))) {
-    return options?.map ? options.map(best) : best;
+  if (valueIndexes.length === 0) return null;
+  return {
+    labels: rows.map((row) => (row[labelIndex] ?? "").trim()),
+    labelHeader: headers[labelIndex] ?? "",
+    labelNumbers: rows.map((row) => parseCellNumber(row[labelIndex] ?? "")),
+    series: valueIndexes.map((index) => ({
+      name: (headers[index] ?? `Column ${index + 1}`).trim() || `Column ${index + 1}`,
+      values: rows.map((row) => parseCellNumber(row[index] ?? ""))
+    })),
+    warnings
+  };
+}
+
+// src/doc/templates/chart/scale.ts
+function niceNum(range, round4) {
+  const exponent = Math.floor(Math.log10(range));
+  const fraction = range / 10 ** exponent;
+  let niceFraction;
+  if (round4) {
+    if (fraction < 1.5) niceFraction = 1;
+    else if (fraction < 3) niceFraction = 2;
+    else if (fraction < 7) niceFraction = 5;
+    else niceFraction = 10;
+  } else {
+    if (fraction <= 1) niceFraction = 1;
+    else if (fraction <= 2) niceFraction = 2;
+    else if (fraction <= 5) niceFraction = 5;
+    else niceFraction = 10;
+  }
+  return niceFraction * 10 ** exponent;
+}
+function niceTicks(min, max, targetCount = 5) {
+  let lo = Number.isFinite(min) ? min : 0;
+  let hi = Number.isFinite(max) ? max : 0;
+  if (lo > hi) [lo, hi] = [hi, lo];
+  if (lo === hi) {
+    const pad = lo === 0 ? 1 : niceNum(Math.abs(lo), true);
+    lo -= pad;
+    hi += pad;
+    if (min >= 0 && lo < 0) lo = 0;
+  }
+  const count = Math.max(2, targetCount);
+  const range = niceNum(hi - lo, false);
+  const step = niceNum(range / (count - 1), true);
+  const niceMin = Math.floor(lo / step) * step;
+  const niceMax = Math.ceil(hi / step) * step;
+  const ticks = [];
+  for (let tick = niceMin; tick <= niceMax + step * 1e-6; tick += step) {
+    ticks.push(Math.abs(tick) < step * 1e-6 ? 0 : Number(tick.toPrecision(12)));
+  }
+  return { ticks, niceMin, niceMax, step };
+}
+function formatChartValue(value, unit) {
+  if (!Number.isFinite(value)) return "\u2014";
+  const sign = value < 0 ? "-" : "";
+  const abs = Math.abs(value);
+  let text;
+  if (abs >= 1e6) {
+    text = `${sign}${trimTrailingZero((abs / 1e6).toFixed(1))}M`;
+  } else if (abs >= 1e3) {
+    text = `${sign}${trimTrailingZero((abs / 1e3).toFixed(abs >= 1e4 ? 0 : 1))}K`;
+  } else {
+    text = `${sign}${abs.toLocaleString("en-US", { maximumFractionDigits: 2 })}`;
   }
-  return void 0;
+  return unit ? `${text} ${unit}` : text;
+}
+function trimTrailingZero(text) {
+  return text.replace(/\.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" }
-  ],
-  sectionHeader: [
-    { key: "title", description: "Section title" },
-    {
-      key: "colorScheme",
-      description: "Fallback background color scheme",
-      valueHint: COLOR_SCHEME_HINT
-    },
-    { key: "imageSrc", description: "Optional background image path" },
-    { key: "imageAlt", description: "Alt text for the background image" },
-    { key: "ambientMotion", description: "Slow zoom/pan effect", values: AMBIENT_MOTION_VALUES }
-  ],
-  content: [{ key: "title", description: "Heading shown above the complete body" }],
-  statHighlight: [
-    { key: "stat", description: 'The statistic (e.g. "89%", "2x")' },
-    { 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: "title", description: "Optional heading above the 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 }
-  ],
-  tree: [
-    { key: "title", description: "Optional title above the tree" },
-    { key: "colorScheme", description: "Folder-row color scheme", valueHint: COLOR_SCHEME_HINT },
-    // `items` is a nested structure derived from the tree fence, not an
-    // inline string — declared so it isn't flagged as unknown.
-    { key: "items", description: "Tree items (derived from the tree fence)" }
-  ],
-  timeline: [
-    { key: "title", description: "Optional title above the timeline" },
-    {
-      key: "colorScheme",
-      description: "Track and marker color scheme",
-      valueHint: COLOR_SCHEME_HINT
-    },
-    // Tracks/events and branch links are nested structures derived from the
-    // timeline source, not values that can be expressed as one inline string.
-    { key: "tracks", description: "Timeline tracks and events (supply via template data)" },
-    { key: "links", description: "Branch links between event ids (supply via template data)" }
-  ],
-  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() {
+// src/doc/templates/chart/geometry.ts
+function round3(value) {
+  return Math.round(value * 100) / 100;
+}
+function pointOnCircle(cx, cy, r, deg) {
+  const rad = (deg - 90) * Math.PI / 180;
+  return { x: round3(cx + r * Math.cos(rad)), y: round3(cy + r * Math.sin(rad)) };
+}
+function arcPath(cx, cy, rOuter, rInner, startDeg, endDeg) {
+  let sweep = endDeg - startDeg;
+  if (sweep <= 0) return "";
+  if (sweep >= 359.9) sweep = 359.9;
+  const end = startDeg + sweep;
+  const largeArc = sweep > 180 ? 1 : 0;
+  const o1 = pointOnCircle(cx, cy, rOuter, startDeg);
+  const o2 = pointOnCircle(cx, cy, rOuter, end);
+  if (rInner <= 0) {
+    return [
+      `M ${round3(cx)} ${round3(cy)}`,
+      `L ${o1.x} ${o1.y}`,
+      `A ${round3(rOuter)} ${round3(rOuter)} 0 ${largeArc} 1 ${o2.x} ${o2.y}`,
+      "Z"
+    ].join(" ");
+  }
+  const i1 = pointOnCircle(cx, cy, rInner, startDeg);
+  const i2 = pointOnCircle(cx, cy, rInner, end);
   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" }
-  ];
+    `M ${o1.x} ${o1.y}`,
+    `A ${round3(rOuter)} ${round3(rOuter)} 0 ${largeArc} 1 ${o2.x} ${o2.y}`,
+    `L ${i2.x} ${i2.y}`,
+    `A ${round3(rInner)} ${round3(rInner)} 0 ${largeArc} 0 ${i1.x} ${i1.y}`,
+    "Z"
+  ].join(" ");
+}
+function polylinePath(points) {
+  if (points.length === 0) return "";
+  return points.map((p, i) => `${i === 0 ? "M" : "L"} ${round3(p.x)} ${round3(p.y)}`).join(" ");
+}
+function areaPath(points, baselineY) {
+  if (points.length === 0) return "";
+  const open = polylinePath(points);
+  const first = points[0];
+  const last = points[points.length - 1];
+  return `${open} L ${round3(last.x)} ${round3(baselineY)} L ${round3(first.x)} ${round3(baselineY)} Z`;
+}
+
+// src/doc/templates/chart/layout.ts
+function computeChartFrame(options) {
+  const W = options.viewportWidth;
+  const H = options.viewportHeight;
+  const marginX = W * 0.06;
+  const marginY = H * 0.06;
+  const innerWidth = W - marginX * 2;
+  let cursor = marginY;
+  let titleBand;
+  if (options.hasTitle) {
+    titleBand = { x: marginX, y: cursor, width: innerWidth, height: options.titleFontSize * 2.2 };
+    cursor = titleBand.y + titleBand.height;
+  }
+  let tableBand;
+  let tableHeight = 0;
+  if (options.tableRowCount > 0) {
+    tableHeight = Math.min(H * 0.4, (options.tableRowCount + 1) * options.tableFontSize * 2.4);
+  }
+  const legendHeight = options.legendRows > 0 ? options.legendRows * options.legendRowHeight : 0;
+  const chartArea = {
+    x: marginX,
+    y: cursor,
+    width: innerWidth,
+    height: Math.max(40, H - marginY - cursor - legendHeight - tableHeight)
+  };
+  cursor = chartArea.y + chartArea.height;
+  let legendBand;
+  if (legendHeight > 0) {
+    legendBand = { x: marginX, y: cursor, width: innerWidth, height: legendHeight };
+    cursor += legendHeight;
+  }
+  if (tableHeight > 0) {
+    tableBand = { x: marginX, y: cursor, width: innerWidth, height: tableHeight };
+  }
+  const plot = {
+    x: chartArea.x + options.leftGutter,
+    y: chartArea.y,
+    width: Math.max(20, chartArea.width - options.leftGutter),
+    height: Math.max(20, chartArea.height - options.bottomGutter)
+  };
+  return { titleBand, chartArea, plot, legendBand, tableBand };
+}
+function stackSeries(series) {
+  const rowCount = series.reduce((max, s) => Math.max(max, s.values.length), 0);
+  const positive = new Array(rowCount).fill(0);
+  const negative = new Array(rowCount).fill(0);
+  return series.map(
+    (s) => Array.from({ length: rowCount }, (_, row) => {
+      const value = s.values[row];
+      if (value === null || value === void 0 || !Number.isFinite(value)) {
+        return { y0: positive[row], y1: positive[row] };
+      }
+      if (value >= 0) {
+        const y0 = positive[row];
+        positive[row] += value;
+        return { y0, y1: positive[row] };
+      }
+      const y1 = negative[row];
+      negative[row] += value;
+      return { y0: negative[row], y1 };
+    })
+  );
+}
+function layoutLegend(labels, fontSize, maxWidth) {
+  const swatchSize = fontSize * 0.9;
+  const gap = fontSize * 1.6;
+  const rowHeight = fontSize * 2;
+  const widths = labels.map(
+    (label) => swatchSize + fontSize * 0.5 + label.length * fontSize * 0.58
+  );
+  const rows = [];
+  let current = [];
+  let currentWidth = 0;
+  widths.forEach((width, index) => {
+    const extra = current.length > 0 ? gap : 0;
+    if (current.length > 0 && currentWidth + extra + width > maxWidth) {
+      rows.push(current);
+      current = [];
+      currentWidth = 0;
+    }
+    current.push(index);
+    currentWidth += (current.length > 1 ? gap : 0) + width;
+  });
+  if (current.length > 0) rows.push(current);
+  const items = [];
+  rows.forEach((rowIndexes, rowIndex) => {
+    const rowWidth = rowIndexes.reduce(
+      (sum, index, i) => sum + widths[index] + (i > 0 ? gap : 0),
+      0
+    );
+    let x = Math.max(0, (maxWidth - rowWidth) / 2);
+    rowIndexes.forEach((index) => {
+      items.push({ label: labels[index], index, x, y: rowIndex * rowHeight, swatchSize });
+      x += widths[index] + gap;
+    });
+  });
+  return { items, rows: rows.length, rowHeight };
+}
+function categoryLabelStep(categoryCount, axisLength, fontSize) {
+  if (categoryCount <= 1) return 1;
+  const minPitch = fontSize * 6;
+  const pitch = axisLength / categoryCount;
+  return Math.max(1, Math.ceil(minPitch / Math.max(1, pitch)));
+}
+
+// src/doc/templates/chart/render.ts
+var TEMPLATE_ID = {
+  bar: "barChart",
+  column: "columnChart",
+  pie: "pieChart",
+  donut: "donutChart",
+  line: "lineChart",
+  area: "areaChart",
+  scatter: "scatterChart"
+};
+function renderChart(kind, input, context) {
+  const table = resolveTable(input, context);
+  const data = table ? buildChartData(table, input) : null;
+  if (!table || !data) return contentFallback(input, context);
+  const { theme, viewport } = context;
+  const templateId = TEMPLATE_ID[kind];
+  const title = (input.title ?? "").trim();
+  const titleFontSize = themedFontSize(44, context, true);
+  const axisFontSize = themedFontSize(20, context, false);
+  const labelFontSize = themedFontSize(22, context, false);
+  const legendFontSize = themedFontSize(22, context, false);
+  const tableFontSize = themedFontSize(20, context, false);
+  const bodyFont = getThemeFont(context, "body");
+  const isRadial = kind === "pie" || kind === "donut";
+  const legendLabels = resolveLegendLabels(kind, input, data);
+  const colors = seriesColors(
+    context,
+    input.colorScheme,
+    isRadial ? data.labels.length : data.series.length
+  );
+  if (isRadial && !data.series[0].values.some((v) => v !== null && v > 0)) {
+    return contentFallback(input, context);
+  }
+  const innerWidth = viewport.width * 0.88;
+  const legend = legendLabels.length > 0 ? layoutLegend(legendLabels, legendFontSize, innerWidth) : null;
+  const gutters = computeGutters(kind, data, input, context, axisFontSize, labelFontSize);
+  const frame = computeChartFrame({
+    viewportWidth: viewport.width,
+    viewportHeight: viewport.height,
+    hasTitle: title.length > 0,
+    titleFontSize,
+    leftGutter: gutters.left,
+    bottomGutter: gutters.bottom,
+    legendRows: legend?.rows ?? 0,
+    legendRowHeight: legendFontSize * 2,
+    tableRowCount: input.showTable === true ? table.rows.length : 0,
+    tableFontSize
+  });
+  const entranceHint = getTemplateHint(context, templateId, "entrance", "staggered");
+  const entrance = (index) => ({
+    type: "fadeIn",
+    duration: 0.6,
+    delay: entranceHint === "subtle" ? 0.1 : Math.min(1.2, 0.2 + index * 0.08)
+  });
+  const paint = {
+    kind,
+    input,
+    context,
+    data,
+    frame,
+    colors,
+    axisFontSize,
+    labelFontSize,
+    bodyFont,
+    gridColor: withAlpha(theme.colors.text, 0.12),
+    axisTextColor: theme.colors.textMuted,
+    entrance
+  };
+  const layers = [createBackgroundLayer("bg", themedSurfaceGradient(context, 170))];
+  if (title && frame.titleBand) {
+    layers.push({
+      type: "text",
+      id: "title",
+      content: {
+        text: title,
+        style: {
+          fontSize: titleFontSize,
+          fontFamily: getThemeFont(context, "title"),
+          fontWeight: "bold",
+          color: theme.colors.text,
+          textAlign: "center",
+          shadow: shouldUseShadow(context)
+        }
+      },
+      position: {
+        x: frame.titleBand.x + frame.titleBand.width / 2,
+        y: frame.titleBand.y + frame.titleBand.height / 2,
+        width: frame.titleBand.width,
+        anchor: "center"
+      },
+      animation: { type: "fadeIn", duration: 0.8 }
+    });
+  }
+  switch (kind) {
+    case "bar":
+      layers.push(...paintBars(paint));
+      break;
+    case "column":
+      layers.push(...paintColumns(paint));
+      break;
+    case "pie":
+    case "donut":
+      layers.push(...paintRadial(paint));
+      break;
+    case "line":
+    case "area":
+      layers.push(...paintLines(paint));
+      break;
+    case "scatter":
+      layers.push(...paintScatter(paint));
+      break;
+  }
+  if (legend && frame.legendBand) {
+    layers.push(...paintLegend(paint, legend, frame.legendBand, legendFontSize));
+  }
+  if (input.showTable === true && frame.tableBand) {
+    layers.push(tableLayer(table, frame.tableBand, tableFontSize, input, context));
+  }
+  return layers;
 }
-function descriptorsFor(canonical) {
-  const specific = TEMPLATE_INPUT_DESCRIPTORS[canonical];
-  if (!specific) return void 0;
-  return [...specific, ...BASE_INPUT_DESCRIPTORS];
+function resolveTable(input, context) {
+  if (Array.isArray(input.headers) && input.headers.length > 0 && Array.isArray(input.rows) && input.rows.length > 0) {
+    return { headers: input.headers, rows: input.rows };
+  }
+  const contents = input.contents ?? context.block?.contents;
+  return extractTableFromContents(contents);
 }
-function descriptorMap(descriptors) {
-  return new Map(descriptors.map((d) => [d.key, d]));
+function contentFallback(input, context) {
+  const fallbackInput = {
+    ...input,
+    template: "content",
+    title: input.title ?? context.block?.title ?? ""
+  };
+  return contentBlock(fallbackInput, context);
 }
-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;
-    }
+function resolveLegendLabels(kind, input, data) {
+  if (input.showLegend === false) return [];
+  if (kind === "pie" || kind === "donut") return data.labels;
+  if (data.series.length > 1 || input.showLegend === true) {
+    return data.series.map((s) => s.name);
   }
-  return { input, warnings };
+  return [];
 }
-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 seriesColors(context, schemeName, count) {
+  const schemes = context.theme.colorSchemes;
+  const names = Object.keys(schemes);
+  const primary = resolveColorScheme(context, schemeName).accent;
+  const palette = [primary];
+  const start = schemeName && names.includes(schemeName) ? names.indexOf(schemeName) : 0;
+  for (let i = 1; i < names.length && palette.length < count; i++) {
+    const accent = schemes[names[(start + i) % names.length]].accent;
+    if (!palette.some((c) => c.toLowerCase() === accent.toLowerCase())) palette.push(accent);
+  }
+  const distinct = palette.length;
+  for (let i = 0; palette.length < count; i++) {
+    palette.push(withAlpha(palette[i % distinct], 0.55));
+  }
+  return palette.slice(0, Math.max(1, count));
+}
+function computeGutters(kind, data, input, context, axisFontSize, labelFontSize) {
+  if (kind === "pie" || kind === "donut") return { left: 0, bottom: 0 };
+  if (kind === "bar") {
+    const longest = data.labels.reduce((max, label) => Math.max(max, label.length), 0);
+    const left = Math.min(
+      context.viewport.width * 0.24,
+      Math.max(labelFontSize * 3, longest * labelFontSize * 0.58 + 16)
+    );
+    return { left, bottom: axisFontSize * 2.4 };
   }
+  const ticks = valueTicks(kind, data, input);
+  const longestTick = ticks.ticks.reduce(
+    (max, tick) => Math.max(max, formatChartValue(tick, input.unit).length),
+    0
+  );
+  return {
+    left: Math.max(axisFontSize * 2.5, longestTick * axisFontSize * 0.6 + 16),
+    bottom: labelFontSize * 2.6
+  };
 }
-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 } };
+function valueTicks(kind, data, input) {
+  let values;
+  if ((kind === "bar" || kind === "column") && input.stacked === true) {
+    const extents = stackSeries(data.series).flat();
+    values = extents.flatMap((e) => [e.y0, e.y1]);
+  } else {
+    values = data.series.flatMap((s) => s.values.filter((v) => v !== null));
   }
-  return { value: raw, warning: `not a "lat,lng" pair (${JSON.stringify(raw)})` };
+  if (values.length === 0) values = [0, 1];
+  let min = Math.min(...values);
+  let max = Math.max(...values);
+  if (kind !== "line" && kind !== "scatter") {
+    min = Math.min(0, min);
+    max = Math.max(0, max);
+  }
+  return niceTicks(min, max, 5);
 }
-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 paintValueAxisY(paint, scale, yFor) {
+  const { frame, gridColor, axisTextColor, axisFontSize, bodyFont, input } = paint;
+  const layers = [];
+  scale.ticks.forEach((tick, index) => {
+    const y = yFor(tick);
+    layers.push({
+      type: "shape",
+      id: `grid-${index}`,
+      content: {
+        shape: "rect",
+        fill: tick === 0 ? withAlpha(paint.context.theme.colors.text, 0.35) : gridColor
+      },
+      position: {
+        x: frame.plot.x,
+        y: y - (tick === 0 ? 1 : 0.5),
+        width: frame.plot.width,
+        height: tick === 0 ? 2 : 1
+      }
+    });
+    layers.push({
+      type: "text",
+      id: `tick-${index}`,
+      content: {
+        text: formatChartValue(tick, input.unit),
+        style: {
+          fontSize: axisFontSize,
+          fontFamily: bodyFont,
+          color: axisTextColor,
+          textAlign: "center"
+        }
+      },
+      position: {
+        x: frame.chartArea.x + (frame.plot.x - frame.chartArea.x) / 2,
+        y,
+        anchor: "center"
+      }
+    });
+  });
+  return layers;
 }
-function coerceStringList(raw) {
-  return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+function paintCategoryAxisX(paint, xForCenter) {
+  const { frame, data, labelFontSize, axisTextColor, bodyFont } = paint;
+  const step = categoryLabelStep(data.labels.length, frame.plot.width, labelFontSize);
+  const layers = [];
+  data.labels.forEach((label, index) => {
+    if (index % step !== 0 || !label) return;
+    layers.push({
+      type: "text",
+      id: `cat-${index}`,
+      content: {
+        text: label,
+        style: {
+          fontSize: labelFontSize,
+          fontFamily: bodyFont,
+          color: axisTextColor,
+          textAlign: "center"
+        }
+      },
+      position: {
+        x: xForCenter(index),
+        y: frame.plot.y + frame.plot.height + labelFontSize * 1.2,
+        anchor: "center"
+      }
+    });
+  });
+  return layers;
 }
-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 } : {}
+function paintColumns(paint) {
+  const { frame, data, colors, input, entrance } = paint;
+  const scale = valueTicks("column", data, input);
+  const yFor = (v) => frame.plot.y + frame.plot.height * (1 - (v - scale.niceMin) / (scale.niceMax - scale.niceMin));
+  const layers = paintValueAxisY(paint, scale, yFor);
+  const n = data.labels.length;
+  const band = frame.plot.width / Math.max(1, n);
+  const innerPad = band * 0.15;
+  layers.push(...paintCategoryAxisX(paint, (i) => frame.plot.x + (i + 0.5) * band));
+  const stacked = input.stacked === true && data.series.length > 1;
+  const extents = stacked ? stackSeries(data.series) : null;
+  const groupWidth = band - innerPad * 2;
+  const barWidth = stacked ? groupWidth : Math.max(2, (groupWidth - 4 * (data.series.length - 1)) / data.series.length);
+  data.series.forEach((series, s) => {
+    series.values.forEach((value, i) => {
+      if (i >= n) return;
+      const extent = extents ? extents[s][i] : value === null ? null : { y0: Math.min(0, value), y1: Math.max(0, value) };
+      if (!extent || extent.y0 === extent.y1) return;
+      const top = yFor(extent.y1);
+      const height = Math.max(1, yFor(extent.y0) - top);
+      const x = stacked ? frame.plot.x + i * band + innerPad : frame.plot.x + i * band + innerPad + s * (barWidth + 4);
+      layers.push({
+        type: "shape",
+        id: `mark-${s}-${i}`,
+        content: { shape: "rect", fill: colors[s], borderRadius: stacked ? 0 : 3 },
+        position: { x, y: top, width: barWidth, height },
+        animation: entrance(i + s)
+      });
+      if (input.showValues === true && value !== null && !stacked) {
+        layers.push(
+          valueLabel(
+            paint,
+            `val-${s}-${i}`,
+            value,
+            x + barWidth / 2,
+            value >= 0 ? top - paint.axisFontSize * 0.9 : top + height + paint.axisFontSize * 0.9
+          )
+        );
+      }
+    });
+  });
+  return layers;
+}
+function paintBars(paint) {
+  const {
+    frame,
+    data,
+    colors,
+    input,
+    entrance,
+    labelFontSize,
+    axisFontSize,
+    bodyFont,
+    axisTextColor,
+    gridColor
+  } = paint;
+  const scale = valueTicks("bar", data, input);
+  const labelGap = axisFontSize * 0.6;
+  const labelWidthPx = (value) => formatChartValue(value, input.unit).length * axisFontSize * 0.58;
+  const showValueLabels = input.showValues === true && !(input.stacked === true);
+  const reservedForLabels = showValueLabels ? data.series.flatMap((series) => series.values).filter((v) => v !== null).reduce((max, v) => Math.max(max, labelWidthPx(v)), 0) + labelGap : 0;
+  const axisWidth = Math.max(20, frame.plot.width - reservedForLabels);
+  const xFor = (v) => frame.plot.x + axisWidth * ((v - scale.niceMin) / (scale.niceMax - scale.niceMin));
+  const layers = [];
+  scale.ticks.forEach((tick, index) => {
+    const x = xFor(tick);
+    layers.push({
+      type: "shape",
+      id: `grid-${index}`,
+      content: {
+        shape: "rect",
+        fill: tick === 0 ? withAlpha(paint.context.theme.colors.text, 0.35) : gridColor
+      },
+      position: {
+        x: x - (tick === 0 ? 1 : 0.5),
+        y: frame.plot.y,
+        width: tick === 0 ? 2 : 1,
+        height: frame.plot.height
+      }
+    });
+    layers.push({
+      type: "text",
+      id: `tick-${index}`,
+      content: {
+        text: formatChartValue(tick, input.unit),
+        style: {
+          fontSize: axisFontSize,
+          fontFamily: bodyFont,
+          color: axisTextColor,
+          textAlign: "center"
+        }
+      },
+      position: { x, y: frame.plot.y + frame.plot.height + axisFontSize * 1.2, anchor: "center" }
+    });
+  });
+  const n = data.labels.length;
+  const band = frame.plot.height / Math.max(1, n);
+  const innerPad = band * 0.15;
+  const stacked = input.stacked === true && data.series.length > 1;
+  const extents = stacked ? stackSeries(data.series) : null;
+  const groupHeight = band - innerPad * 2;
+  const barHeight = stacked ? groupHeight : Math.max(2, (groupHeight - 4 * (data.series.length - 1)) / data.series.length);
+  data.labels.forEach((label, i) => {
+    if (!label) return;
+    layers.push({
+      type: "text",
+      id: `cat-${i}`,
+      content: {
+        text: label,
+        style: {
+          fontSize: labelFontSize,
+          fontFamily: bodyFont,
+          color: axisTextColor,
+          textAlign: "center"
+        }
+      },
+      position: {
+        x: frame.chartArea.x + (frame.plot.x - frame.chartArea.x) / 2,
+        y: frame.plot.y + (i + 0.5) * band,
+        anchor: "center"
+      }
+    });
+  });
+  data.series.forEach((series, s) => {
+    series.values.forEach((value, i) => {
+      if (i >= n) return;
+      const extent = extents ? extents[s][i] : value === null ? null : { y0: Math.min(0, value), y1: Math.max(0, value) };
+      if (!extent || extent.y0 === extent.y1) return;
+      const left = xFor(extent.y0);
+      const width = Math.max(1, xFor(extent.y1) - left);
+      const y = stacked ? frame.plot.y + i * band + innerPad : frame.plot.y + i * band + innerPad + s * (barHeight + 4);
+      layers.push({
+        type: "shape",
+        id: `mark-${s}-${i}`,
+        content: { shape: "rect", fill: colors[s], borderRadius: stacked ? 0 : 3 },
+        position: { x: left, y, width, height: barHeight },
+        animation: entrance(i + s)
+      });
+      if (showValueLabels && value !== null) {
+        const half = labelWidthPx(value) / 2;
+        const labelX = value >= 0 ? left + width + labelGap + half : left - labelGap - half;
+        layers.push(valueLabel(paint, `val-${s}-${i}`, value, labelX, y + barHeight / 2));
+      }
+    });
+  });
+  return layers;
+}
+function paintRadial(paint) {
+  const { kind, frame, data, colors, input, entrance, context } = paint;
+  const slices = data.labels.map((label, index) => ({ label, value: data.series[0].values[index], index })).filter(
+    (s) => s.value !== null && Number.isFinite(s.value) && s.value > 0
+  );
+  const total = slices.reduce((sum, s) => sum + s.value, 0);
+  const cx = frame.chartArea.x + frame.chartArea.width / 2;
+  const cy = frame.chartArea.y + frame.chartArea.height / 2;
+  const rOuter = Math.min(frame.chartArea.width, frame.chartArea.height) * 0.42;
+  const rInner = kind === "donut" ? rOuter * 0.55 : 0;
+  const layers = [];
+  let startDeg = 0;
+  slices.forEach((slice, order) => {
+    const sweep = slice.value / total * 360;
+    layers.push({
+      type: "path",
+      id: `mark-${slice.index}`,
+      content: {
+        d: arcPath(cx, cy, rOuter, rInner, startDeg, startDeg + sweep),
+        fill: colors[slice.index % colors.length],
+        stroke: context.theme.colors.background,
+        strokeWidth: 2
+      },
+      position: { x: cx - rOuter, y: cy - rOuter, width: rOuter * 2, height: rOuter * 2 },
+      animation: entrance(order)
+    });
+    if (input.showValues === true && sweep >= 14) {
+      const mid = startDeg + sweep / 2;
+      const rad = (mid - 90) * Math.PI / 180;
+      const rLabel = rInner > 0 ? (rInner + rOuter) / 2 : rOuter * 0.68;
+      const pctText = `${Math.round(slice.value / total * 100)}%`;
+      layers.push({
+        type: "text",
+        id: `val-${slice.index}`,
+        content: {
+          text: pctText,
+          style: {
+            fontSize: paint.axisFontSize,
+            fontFamily: paint.bodyFont,
+            fontWeight: "bold",
+            color: pickContrastingText(colors[slice.index % colors.length]),
+            textAlign: "center"
+          }
+        },
+        position: {
+          x: cx + rLabel * Math.cos(rad),
+          y: cy + rLabel * Math.sin(rad),
+          anchor: "center"
+        },
+        animation: entrance(order)
       });
-      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(", ")}`
+    startDeg += sweep;
+  });
+  return layers;
+}
+function paintLines(paint) {
+  const { kind, frame, data, colors, input, entrance } = paint;
+  const scale = valueTicks(kind, data, input);
+  const yFor = (v) => frame.plot.y + frame.plot.height * (1 - (v - scale.niceMin) / (scale.niceMax - scale.niceMin));
+  const n = data.labels.length;
+  const band = frame.plot.width / Math.max(1, n);
+  const xForCenter = (i) => frame.plot.x + (i + 0.5) * band;
+  const layers = paintValueAxisY(paint, scale, yFor);
+  layers.push(...paintCategoryAxisX(paint, xForCenter));
+  const baselineY = yFor(Math.max(scale.niceMin, Math.min(scale.niceMax, 0)));
+  const showPoints = n <= 30;
+  data.series.forEach((series, s) => {
+    const segments = [];
+    let current = [];
+    series.values.forEach((value, i) => {
+      if (i >= n) return;
+      if (value === null) {
+        if (current.length > 0) segments.push(current);
+        current = [];
+        return;
+      }
+      current.push({ x: xForCenter(i), y: yFor(value) });
+    });
+    if (current.length > 0) segments.push(current);
+    segments.forEach((segment, seg) => {
+      if (kind === "area" && segment.length > 1) {
+        layers.push({
+          type: "path",
+          id: `area-${s}-${seg}`,
+          content: {
+            d: areaPath(segment, baselineY),
+            fill: colors[s],
+            fillOpacity: 0.25,
+            stroke: "none",
+            strokeWidth: 0
+          },
+          position: {
+            x: frame.plot.x,
+            y: frame.plot.y,
+            width: frame.plot.width,
+            height: frame.plot.height
+          },
+          animation: entrance(s)
         });
       }
-    } 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}` });
+      if (segment.length > 1) {
+        layers.push({
+          type: "path",
+          id: `line-${s}-${seg}`,
+          content: { d: polylinePath(segment), stroke: colors[s], strokeWidth: 4, fill: "none" },
+          position: {
+            x: frame.plot.x,
+            y: frame.plot.y,
+            width: frame.plot.width,
+            height: frame.plot.height
+          },
+          animation: entrance(s)
+        });
       }
+    });
+    if (showPoints) {
+      series.values.forEach((value, i) => {
+        if (i >= n || value === null) return;
+        const r = 5;
+        layers.push({
+          type: "shape",
+          id: `pt-${s}-${i}`,
+          content: { shape: "circle", fill: colors[s] },
+          position: { x: xForCenter(i) - r, y: yFor(value) - r, width: r * 2, height: r * 2 },
+          animation: entrance(s)
+        });
+        if (input.showValues === true) {
+          layers.push(
+            valueLabel(
+              paint,
+              `val-${s}-${i}`,
+              value,
+              xForCenter(i),
+              yFor(value) - paint.axisFontSize
+            )
+          );
+        }
+      });
     }
-  }
-  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 layers;
+}
+function paintScatter(paint) {
+  const { frame, data, colors, input, entrance } = paint;
+  const scale = valueTicks("scatter", data, input);
+  const yFor = (v) => frame.plot.y + frame.plot.height * (1 - (v - scale.niceMin) / (scale.niceMax - scale.niceMin));
+  const layers = paintValueAxisY(paint, scale, yFor);
+  const numericCount = data.labelNumbers.filter((v) => v !== null).length;
+  const numericX = data.labels.length > 0 && numericCount / data.labels.length >= 0.6;
+  let xFor;
+  if (numericX) {
+    const xs = data.labelNumbers.filter((v) => v !== null);
+    const xScale = niceTicks(Math.min(...xs), Math.max(...xs), 5);
+    const span = xScale.niceMax - xScale.niceMin;
+    xFor = (i) => {
+      const v = data.labelNumbers[i];
+      return v === null ? null : frame.plot.x + frame.plot.width * ((v - xScale.niceMin) / span);
+    };
+    xScale.ticks.forEach((tick, index) => {
+      const x = frame.plot.x + frame.plot.width * ((tick - xScale.niceMin) / span);
+      layers.push({
+        type: "shape",
+        id: `xgrid-${index}`,
+        content: { shape: "rect", fill: paint.gridColor },
+        position: { x: x - 0.5, y: frame.plot.y, width: 1, height: frame.plot.height }
+      });
+      layers.push({
+        type: "text",
+        id: `xtick-${index}`,
+        content: {
+          text: formatChartValue(tick),
+          style: {
+            fontSize: paint.axisFontSize,
+            fontFamily: paint.bodyFont,
+            color: paint.axisTextColor,
+            textAlign: "center"
+          }
+        },
+        position: {
+          x,
+          y: frame.plot.y + frame.plot.height + paint.axisFontSize * 1.2,
+          anchor: "center"
+        }
+      });
+    });
+  } else {
+    const band = frame.plot.width / Math.max(1, data.labels.length);
+    xFor = (i) => frame.plot.x + (i + 0.5) * band;
+    layers.push(...paintCategoryAxisX(paint, (i) => frame.plot.x + (i + 0.5) * band));
+  }
+  const r = 7;
+  data.series.forEach((series, s) => {
+    series.values.forEach((value, i) => {
+      if (value === null) return;
+      const x = xFor(i);
+      if (x === null) return;
+      layers.push({
+        type: "shape",
+        id: `mark-${s}-${i}`,
+        content: { shape: "circle", fill: colors[s], fillOpacity: 0.85 },
+        position: { x: x - r, y: yFor(value) - r, width: r * 2, height: r * 2 },
+        animation: entrance(Math.floor(i / 3) + s)
       });
-    }
-  }
-  return findings;
+    });
+  });
+  return layers;
 }
-
-// src/doc/templates/fallbackBlock.ts
-var MAX_BODY_CHARS = 600;
-function fallbackBlockLayers(block, context, notice) {
-  const colors = resolveColorScheme(context, "blue");
-  const { layout } = context;
-  const title = block.title ?? block.id ?? "";
-  const body = extractBodyText(block);
-  const layers = [
-    {
-      type: "shape",
-      id: "fallback-bg",
-      content: { shape: "rect", fill: colors.bg },
-      position: { x: 0, y: 0, width: "100%", height: "100%" }
-    }
-  ];
-  if (title) {
+function paintLegend(paint, legend, band, fontSize) {
+  const layers = [];
+  legend.items.forEach((item, index) => {
+    const color = paint.colors[item.index % paint.colors.length];
+    const rowCenterY = band.y + item.y + legend.rowHeight / 2;
     layers.push({
-      type: "text",
-      id: "fallback-title",
-      content: {
-        text: title,
-        style: {
-          fontSize: themedFontSize(56, context, true),
-          fontFamily: getThemeFont(context, "title"),
-          fontWeight: "bold",
-          color: colors.text,
-          textAlign: "center"
-        }
-      },
+      type: "shape",
+      id: `legend-swatch-${index}`,
+      content: { shape: "rect", fill: color, borderRadius: 3 },
       position: {
-        x: "50%",
-        y: body ? "28%" : "50%",
-        anchor: "center",
-        width: layout.maxTextWidth
+        x: band.x + item.x,
+        y: rowCenterY - item.swatchSize / 2,
+        width: item.swatchSize,
+        height: item.swatchSize
       }
     });
-  }
-  if (body) {
     layers.push({
       type: "text",
-      id: "fallback-body",
+      id: `legend-label-${index}`,
       content: {
-        text: body,
-        style: {
-          fontSize: themedFontSize(28, context),
-          fontFamily: getThemeFont(context, "body"),
-          color: colors.text,
-          textAlign: "center"
-        }
+        text: item.label,
+        style: { fontSize, fontFamily: paint.bodyFont, color: paint.context.theme.colors.text }
       },
       position: {
-        x: "50%",
-        y: "55%",
-        anchor: "center",
-        width: layout.maxTextWidth
+        x: band.x + item.x + item.swatchSize + fontSize * 0.5,
+        y: rowCenterY - fontSize * 0.62
       }
     });
-  }
-  layers.push({
+  });
+  return layers;
+}
+function valueLabel(paint, id, value, x, y) {
+  return {
     type: "text",
-    id: "fallback-notice",
+    id,
     content: {
-      text: `\u26A0 ${notice}`,
+      text: formatChartValue(value, paint.input.unit),
       style: {
-        fontSize: themedFontSize(18, context),
-        fontFamily: getThemeFont(context, "body"),
-        color: withAlpha(colors.text, 0.6),
+        fontSize: paint.axisFontSize,
+        fontFamily: paint.bodyFont,
+        fontWeight: "bold",
+        color: paint.context.theme.colors.text,
         textAlign: "center"
       }
     },
-    position: { x: "50%", y: "92%", anchor: "center", width: layout.maxTextWidth }
-  });
-  return layers;
-}
-function extractBodyText(block) {
-  if (!block.contents || block.contents.length === 0) return "";
-  const text = block.contents.map((node) => extractPlainText(node)).join("\n").trim();
-  if (text.length <= MAX_BODY_CHARS) return text;
-  return `${text.slice(0, MAX_BODY_CHARS).trimEnd()}\u2026`;
-}
-
-// src/doc/asciiDiagram/types.ts
-var ASCII_CHAR_W = 14;
-var ASCII_CHAR_H = 28;
-
-// src/doc/asciiDiagram/mapping.ts
-function asciiCellToCanvas(col, row) {
-  return { x: col * ASCII_CHAR_W, y: row * ASCII_CHAR_H };
-}
-function canvasToAsciiCell(x, y) {
-  return {
-    col: Math.max(0, Math.round(x / ASCII_CHAR_W)),
-    row: Math.max(0, Math.round(y / ASCII_CHAR_H))
+    position: { x, y, anchor: "center" }
   };
 }
-function asciiDiagramToTemplateData(diagram) {
-  const nodes = diagram.nodes.map((n) => ({
-    id: n.id,
-    label: n.label,
-    ...asciiCellToCanvas(n.col, n.row),
-    w: n.wCols * ASCII_CHAR_W,
-    h: n.hRows * ASCII_CHAR_H,
-    ...n.containerId ? { container: n.containerId } : {}
-  }));
-  const anchors = inferEdgeAnchors(nodes, diagram.edges);
-  const edges = diagram.edges.map((e, index) => ({
-    source: e.source,
-    target: e.target,
-    ...e.label ? { label: e.label } : {},
-    ...e.directed ? {} : { directed: false },
-    ...anchors[index],
-    routing: "orthogonal"
-  }));
-  return { nodes, edges };
-}
-function inferEdgeAnchors(nodes, edges) {
-  const nodeById = new Map(nodes.map((node) => [node.id, node]));
-  const pairs = edges.map((edge) => {
-    const source = nodeById.get(edge.source);
-    const target = nodeById.get(edge.target);
-    if (!source || !target) {
-      return {
-        sourceAnchor: { side: "right", offset: 0.5 },
-        targetAnchor: { side: "left", offset: 0.5 }
-      };
-    }
-    const sourceW = source.w ?? ASCII_CHAR_W * 12;
-    const sourceH = source.h ?? ASCII_CHAR_H * 3;
-    const targetW = target.w ?? ASCII_CHAR_W * 12;
-    const targetH = target.h ?? ASCII_CHAR_H * 3;
-    const dx = target.x + targetW / 2 - (source.x + sourceW / 2);
-    const dy = target.y + targetH / 2 - (source.y + sourceH / 2);
-    const horizontalDistance = Math.abs(dx) / Math.max(1, (sourceW + targetW) / 2);
-    const verticalDistance = Math.abs(dy) / Math.max(1, (sourceH + targetH) / 2);
-    if (verticalDistance >= horizontalDistance) {
-      return dy >= 0 ? {
-        sourceAnchor: { side: "bottom", offset: 0.5 },
-        targetAnchor: { side: "top", offset: 0.5 }
-      } : {
-        sourceAnchor: { side: "top", offset: 0.5 },
-        targetAnchor: { side: "bottom", offset: 0.5 }
-      };
-    }
-    return dx >= 0 ? {
-      sourceAnchor: { side: "right", offset: 0.5 },
-      targetAnchor: { side: "left", offset: 0.5 }
-    } : {
-      sourceAnchor: { side: "left", offset: 0.5 },
-      targetAnchor: { side: "right", offset: 0.5 }
-    };
-  });
-  distributeOffsets(pairs, edges, nodes, "source");
-  distributeOffsets(pairs, edges, nodes, "target");
-  return pairs;
-}
-function distributeOffsets(pairs, edges, nodes, endpoint) {
-  const nodeById = new Map(nodes.map((node) => [node.id, node]));
-  const groups = /* @__PURE__ */ new Map();
-  for (let index = 0; index < edges.length; index++) {
-    const edge = edges[index];
-    const anchor = endpoint === "source" ? pairs[index].sourceAnchor : pairs[index].targetAnchor;
-    const nodeId = endpoint === "source" ? edge.source : edge.target;
-    const key = `${nodeId}:${anchor.side}`;
-    const group = groups.get(key) ?? [];
-    group.push(index);
-    groups.set(key, group);
-  }
-  for (const indexes of groups.values()) {
-    if (indexes.length < 2) continue;
-    const side = endpoint === "source" ? pairs[indexes[0]].sourceAnchor.side : pairs[indexes[0]].targetAnchor.side;
-    indexes.sort((a, b) => {
-      const oppositeA = nodeById.get(endpoint === "source" ? edges[a].target : edges[a].source);
-      const oppositeB = nodeById.get(endpoint === "source" ? edges[b].target : edges[b].source);
-      const axisA = side === "top" || side === "bottom" ? oppositeA?.x ?? 0 : oppositeA?.y ?? 0;
-      const axisB = side === "top" || side === "bottom" ? oppositeB?.x ?? 0 : oppositeB?.y ?? 0;
-      return axisA - axisB || a - b;
-    });
-    indexes.forEach((edgeIndex, rank) => {
-      const anchor = endpoint === "source" ? pairs[edgeIndex].sourceAnchor : pairs[edgeIndex].targetAnchor;
-      anchor.offset = (rank + 1) / (indexes.length + 1);
-    });
-  }
-}
-function asciiDiagramFromTemplateData(nodes, edges, options = {}) {
-  const ids = new Set(nodes.map((n) => n.id));
-  const outNodes = nodes.map((n) => {
-    const { col, row } = canvasToAsciiCell(n.x, n.y);
-    const labelLines = n.label.length > 0 ? n.label.split("\n") : [];
-    const innerW = labelLines.reduce((w, l) => Math.max(w, l.length), 0);
-    const wCols = typeof n.w === "number" ? Math.max(3, Math.round(n.w / ASCII_CHAR_W)) : innerW + 4;
-    const hRows = typeof n.h === "number" ? Math.max(3, Math.round(n.h / ASCII_CHAR_H)) : labelLines.length + 2;
-    return {
-      id: n.id,
-      label: n.label,
-      col,
-      row,
-      wCols: Math.max(wCols, 3),
-      hRows: Math.max(hRows, 3),
-      ...n.container && ids.has(n.container) && n.container !== n.id ? { containerId: n.container } : {}
-    };
-  });
+function tableLayer(table, band, fontSize, input, context) {
+  const { theme } = context;
+  const colors = resolveColorScheme(context, input.colorScheme);
   return {
-    nodes: outNodes,
-    edges: edges.filter((e) => ids.has(e.source) && ids.has(e.target)).map((e) => ({
-      source: e.source,
-      target: e.target,
-      ...e.label ? { label: e.label } : {},
-      directed: e.directed !== false
-    })),
-    style: options.style ?? "unicode",
-    warnings: []
-  };
-}
-function asciiDiagramFromBlocks(children, options = {}) {
-  const layout = computeDiagramLayout(children);
-  const nodes = layout.nodes.map((n) => ({
-    id: n.id,
-    label: n.label,
-    x: n.x,
-    y: n.y
-  }));
-  const edges = layout.edges.map((e) => ({
-    source: e.source,
-    target: e.target,
-    ...e.type ? { label: e.type } : {}
-  }));
-  const diagram = asciiDiagramFromTemplateData(nodes, edges, options);
-  diagram.warnings.push(...layout.warnings);
-  return diagram;
-}
-
-// src/doc/asciiTimeline/mapping.ts
-function asciiTimelineToTemplateData(timeline) {
-  const globalStart = timeline.tracks.length > 0 ? Math.min(...timeline.tracks.map((track) => track.startColumn)) : 0;
-  const globalEnd = timeline.tracks.length > 0 ? Math.max(...timeline.tracks.map((track) => track.endColumn)) : 1;
-  const span = Math.max(1, globalEnd - globalStart);
-  const tracks = timeline.tracks.map((track) => ({
-    id: track.id,
-    ...track.label ? { label: track.label } : {},
-    ...track.endLabel ? { endLabel: track.endLabel } : {},
-    events: track.events.map(
-      (event) => ({
-        id: event.id,
-        label: event.label,
-        ...event.description ? { description: event.description } : {},
-        position: clamp012((event.column - globalStart) / span),
-        ...event.side ? { side: event.side } : {},
-        ...event.descriptionSide ? { descriptionSide: event.descriptionSide } : {},
-        ...event.callout === false ? { callout: false } : {},
-        ...event.marker ? { marker: event.marker } : {}
-      })
-    )
-  }));
-  const links = timeline.links.map((link) => ({ ...link }));
-  return { tracks, links };
-}
-function clamp012(value) {
-  return Math.max(0, Math.min(1, value));
+    type: "table",
+    id: "table",
+    content: {
+      headers: table.headers,
+      rows: table.rows,
+      align: table.align,
+      style: {
+        headerBackground: colors.accent,
+        headerColor: pickContrastingText(colors.accent),
+        cellBackground: withAlpha(theme.colors.text, 0.04),
+        cellColor: theme.colors.text,
+        borderColor: withAlpha(theme.colors.text, 0.15),
+        fontSize,
+        fontFamily: getThemeFont(context, "body"),
+        headerFontFamily: getThemeFont(context, "title"),
+        borderRadius: 8
+      }
+    },
+    position: { x: band.x, y: band.y, width: band.width, height: band.height },
+    animation: { type: "fadeIn", duration: 1, delay: 0.4 }
+  };
 }
 
-// src/doc/treeview/mapping.ts
-function treeToTemplateData(tree) {
-  return { items: tree.roots.map(toItem) };
+// src/doc/templates/chartBlock.ts
+function barChart(input, context) {
+  return renderChart("bar", input, context);
 }
-function toItem(node) {
-  return {
-    id: node.id,
-    label: node.label,
-    ...node.isDir ? { isDir: true } : {},
-    ...node.comment ? { comment: node.comment } : {},
-    children: node.children.map(toItem)
-  };
+function columnChart(input, context) {
+  return renderChart("column", input, context);
 }
-function treeFromTemplateData(items, options = {}) {
-  const roots = items.map(fromItem);
-  return { roots, style: options.style ?? "unicode", warnings: [] };
+function pieChart(input, context) {
+  return renderChart("pie", input, context);
 }
-function fromItem(item) {
-  const children = Array.isArray(item.children) ? item.children.map(fromItem) : [];
-  return {
-    id: typeof item.id === "string" && item.id ? item.id : "node",
-    label: typeof item.label === "string" ? item.label : "",
-    children,
-    isDir: item.isDir === true || children.length > 0,
-    ...item.comment ? { comment: item.comment } : {}
-  };
+function donutChart(input, context) {
+  return renderChart("donut", input, context);
 }
-function treeFromMarkdownList(list) {
-  const usedIds = /* @__PURE__ */ new Map();
-  const slugify2 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "node";
-  const idFor = (label) => {
-    const base = slugify2(label.replace(/\/$/, ""));
-    const count = usedIds.get(base) ?? 0;
-    usedIds.set(base, count + 1);
-    return count === 0 ? base : `${base}-${count + 1}`;
-  };
-  const itemToNode = (item) => {
-    const labelNode = item.children.find((c) => c.type !== "list");
-    const label = labelNode ? extractPlainText(labelNode).trim() : "";
-    const childLists = item.children.filter((c) => c.type === "list");
-    const children = [];
-    for (const cl of childLists) for (const ci of cl.children) children.push(itemToNode(ci));
-    return {
-      id: idFor(label),
-      label,
-      children,
-      isDir: label.endsWith("/") || children.length > 0
-    };
-  };
-  return { roots: list.children.map(itemToNode), style: "unicode", warnings: [] };
+function lineChart(input, context) {
+  return renderChart("line", input, context);
 }
-function findFirstList(contents) {
-  return contents?.find((n) => n.type === "list");
+function areaChart(input, context) {
+  return renderChart("area", input, context);
 }
-
-// src/doc/templateInputs.ts
-var VIDEO_FILE_RE = /\.(?:webm|mp4|mov|m4v|ogv)(?:[?#].*)?$/i;
-function extractBodyPlainText(contents) {
-  if (!contents || contents.length === 0) return "";
-  return contents.filter((node) => !(node.type === "code" && node.lang?.trim().toLowerCase() === "mermaid")).map((n) => extractPlainText(n)).join("\n").trim();
+function scatterChart(input, context) {
+  return renderChart("scatter", input, context);
 }
-function extractListItems(contents) {
-  if (!contents) return [];
-  const items = [];
-  for (const node of contents) {
-    if (node.type === "list") {
-      for (const item of node.children) {
-        const text = extractPlainText(item).trim();
-        if (text) items.push(text);
-      }
+
+// src/doc/templates/registry.ts
+var templateRegistry = {
+  title: titleBlock,
+  sectionHeader,
+  content: contentBlock,
+  statHighlight,
+  quote: quoteBlock,
+  factCard,
+  twoColumn,
+  dateEvent,
+  imageWithCaption,
+  leftFeature,
+  rightFeature,
+  map: mapBlock,
+  fullBleedQuote,
+  list: listBlock,
+  photoGrid,
+  definitionCard,
+  comparisonBar,
+  pullQuote,
+  videoWithCaption,
+  videoPullQuote,
+  dataTable,
+  barChart,
+  columnChart,
+  pieChart,
+  donutChart,
+  lineChart,
+  areaChart,
+  scatterChart,
+  diagram: diagramBlock,
+  tree: treeBlock,
+  timeline: timelineBlock,
+  layout: layoutBlock,
+  drawing: drawingBlock
+};
+function buildRegistry(custom) {
+  const merged = {
+    ...templateRegistry
+  };
+  if (custom) {
+    for (const definition of custom) {
+      if (merged[definition.name]) continue;
+      merged[definition.name] = makeCustomTemplateFn(
+        definition
+      );
     }
   }
-  return items;
+  return merged;
 }
-function parseDim(raw) {
-  if (raw === void 0) return void 0;
-  const n = parseFloat(raw);
-  return Number.isFinite(n) && n > 0 ? n : void 0;
+
+// src/doc/utils/applyRenderStyle.ts
+var AMBIENT_VARIANTS = [
+  { type: "slowZoom", direction: "in" },
+  { type: "slowZoom", direction: "out" },
+  { type: "slowZoom", panDirection: "left" },
+  { type: "slowZoom", panDirection: "right" }
+];
+var MIN_AMBIENT_DURATION_SECONDS = 8;
+function isZeroish(v) {
+  return v === 0 || v === "0" || v === "0%";
 }
-function extractImages(contents, limit = Infinity) {
-  if (!contents || contents.length === 0) return [];
-  const found = [];
-  function fromHtml(nodes) {
-    for (const node of nodes) {
-      if (found.length >= limit) return;
-      if (!node || typeof node !== "object") continue;
-      const n = node;
-      if (n.type === "htmlElement" && n.tagName === "img") {
-        const attrs = n.attributes;
-        if (attrs && typeof attrs.src === "string" && attrs.src) {
-          found.push({
-            src: attrs.src,
-            alt: typeof attrs.alt === "string" ? attrs.alt : "",
-            width: parseDim(attrs.width),
-            height: parseDim(attrs.height)
-          });
-        }
-      }
-      if (Array.isArray(n.children)) fromHtml(n.children);
-    }
-  }
-  function walk(node) {
-    if (found.length >= limit) return;
-    if (!node || typeof node !== "object") return;
-    const n = node;
-    if (n.type === "image" && typeof n.url === "string" && n.url) {
-      found.push({ src: n.url, alt: typeof n.alt === "string" ? n.alt : "" });
-      return;
+function isFullBleedCoverMedia(layer) {
+  if (layer.type !== "image" && layer.type !== "video") return false;
+  const { position } = layer;
+  if (!isZeroish(position.x) || !isZeroish(position.y)) return false;
+  if (position.width !== "100%" || position.height !== "100%") return false;
+  const fit = layer.content.fit;
+  return fit === void 0 || fit === "cover";
+}
+function themeWantsAmbientMotion(theme) {
+  return theme.renderStyle.ambientMotion === true;
+}
+function applyRenderStyleToLayers(layers, block, theme) {
+  const speed = theme.style.animationSpeed ?? 1;
+  const ambient = themeWantsAmbientMotion(theme);
+  if (speed === 1 && !ambient) return layers;
+  return layers.map((layer) => {
+    let animation = layer.animation;
+    if (!animation && ambient && isFullBleedCoverMedia(layer)) {
+      const rng = new SeededRandom(hashString(`${block.id}:${layer.id}`));
+      const variant = rng.pickRequired(AMBIENT_VARIANTS);
+      animation = {
+        ...variant,
+        duration: Math.max(MIN_AMBIENT_DURATION_SECONDS, block.duration ?? 0)
+      };
     }
-    if ((n.type === "htmlBlock" || n.type === "htmlInline") && Array.isArray(n.htmlChildren)) {
-      fromHtml(n.htmlChildren);
+    if (!animation || animation.type === "none") {
+      return animation === layer.animation ? layer : { ...layer, animation };
     }
-    if (Array.isArray(n.children)) {
-      for (const child of n.children) walk(child);
+    if (speed !== 1) {
+      animation = {
+        ...animation,
+        ...animation.duration != null ? { duration: animation.duration * speed } : {},
+        ...animation.delay != null ? { delay: animation.delay * speed } : {}
+      };
     }
-  }
-  for (const node of contents) {
-    if (found.length >= limit) break;
-    walk(node);
-  }
-  return found;
-}
-function extractFirstImage(contents) {
-  return extractImages(contents, 1)[0] ?? null;
+    return animation === layer.animation ? layer : { ...layer, animation };
+  });
 }
-function extractEmbeddedVideos(contents, limit = Infinity) {
-  if (!contents || contents.length === 0) return [];
-  const found = [];
-  const seen = /* @__PURE__ */ new Set();
-  const add = (video) => {
-    if (!video.src || found.length >= limit || seen.has(video.src)) return;
-    seen.add(video.src);
-    found.push(video);
-  };
-  function nestedSource(children) {
-    if (!Array.isArray(children)) return void 0;
-    for (const child of children) {
-      if (!child || typeof child !== "object") continue;
-      const node = child;
-      if (node.tagName === "source") {
-        const attrs = node.attributes;
-        if (typeof attrs?.src === "string" && attrs.src) return attrs.src;
-      }
-      const nested = nestedSource(node.children);
-      if (nested) return nested;
-    }
-    return void 0;
-  }
-  function walk(node) {
-    if (found.length >= limit || !node || typeof node !== "object") return;
-    const n = node;
-    if (n.type === "htmlElement" && n.tagName === "video") {
-      const attrs = n.attributes;
-      const src = attrs?.src || nestedSource(n.children);
-      if (src) {
-        add({
-          src,
-          ...attrs?.poster ? { posterSrc: attrs.poster } : {},
-          alt: attrs?.["aria-label"] || attrs?.title || attrs?.alt || ""
-        });
-      }
-    } else if ((n.type === "link" || n.type === "image") && typeof n.url === "string" && VIDEO_FILE_RE.test(n.url)) {
-      add({
-        src: n.url,
-        alt: typeof n.alt === "string" ? n.alt : extractPlainText(n).trim()
-      });
+
+// 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);
     }
-    if (Array.isArray(n.children)) n.children.forEach(walk);
-    if (Array.isArray(n.htmlChildren)) n.htmlChildren.forEach(walk);
+    [prev, curr] = [curr, prev];
   }
-  contents.forEach(walk);
-  return found;
-}
-function extractFirstEmbeddedVideo(contents) {
-  return extractEmbeddedVideos(contents, 1)[0] ?? null;
+  return prev[n];
 }
-function extractTableFromContents(contents) {
-  if (!contents) return null;
-  for (const node of contents) {
-    if (node.type === "table") {
-      const table = node;
-      const [headerRow, ...bodyRows] = table.children;
-      if (!headerRow) return null;
-      const headers = headerRow.children.map((cell) => extractPlainText(cell).trim());
-      const rows = bodyRows.map((row) => row.children.map((cell) => extractPlainText(cell).trim()));
-      return { headers, rows, align: table.align };
+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;
     }
   }
-  return null;
-}
-function extractBlockquoteText(contents) {
-  if (!contents) return "";
-  for (const node of contents) {
-    if (node.type === "blockquote") return extractPlainText(node).trim();
+  if (best && (bestDist <= maxDistance || bestDist <= Math.ceil(input.length * 0.4))) {
+    return options?.map ? options.map(best) : best;
   }
-  return "";
+  return void 0;
 }
-function firstParagraph(contents) {
-  if (!contents) return null;
-  const index = contents.findIndex((node) => node.type === "paragraph");
-  if (index < 0) return null;
-  return {
-    node: contents[index],
-    index
-  };
+
+// 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'";
+function CHART_DESCRIPTORS(extra = []) {
+  return [
+    { key: "title", description: "Optional title above the chart" },
+    {
+      key: "labelColumn",
+      description: "Category/label column",
+      valueHint: "header name or 0-based index"
+    },
+    {
+      key: "valueColumns",
+      description: "Value columns to plot",
+      coerce: "stringList",
+      valueHint: "comma-separated header names or 0-based indexes"
+    },
+    {
+      key: "showTable",
+      description: "Render the source table beneath the chart",
+      coerce: "boolean"
+    },
+    { key: "showLegend", description: "Show a series legend", coerce: "boolean" },
+    { key: "showValues", description: "Print numeric value labels on marks", coerce: "boolean" },
+    { key: "unit", description: 'Unit suffix for tick/value labels (e.g. "km")' },
+    {
+      key: "colorScheme",
+      description: "Color scheme seeding the series color rotation",
+      valueHint: COLOR_SCHEME_HINT
+    },
+    // `headers`/`rows` are normally derived from the block's markdown table;
+    // declared so data-fence-supplied values aren't flagged as unknown.
+    {
+      key: "headers",
+      description: "Header cells (normally derived from the table)",
+      coerce: "stringList"
+    },
+    { key: "rows", description: "Table rows (supply via a data fence)" },
+    ...extra
+  ];
 }
-function leadingStrongStat(paragraph) {
-  for (const child of paragraph.children) {
-    if (child.type === "text" && child.value.trim() === "") continue;
-    if (child.type !== "strong") return null;
-    const text = extractPlainText(child).trim();
-    const match = text.match(/^(?:[$€£¥]\s*)?[+-]?\d+(?:[.,]\d+)*(?:\s?(?:[%‰x×]|[A-Za-z]+))?/);
-    return match?.[0].trim() || null;
-  }
-  return null;
+var STACKED_DESCRIPTOR = {
+  key: "stacked",
+  description: "Stack series instead of grouping them side by side",
+  coerce: "boolean"
+};
+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" }
+  ],
+  sectionHeader: [
+    { key: "title", description: "Section title" },
+    {
+      key: "colorScheme",
+      description: "Fallback background color scheme",
+      valueHint: COLOR_SCHEME_HINT
+    },
+    { key: "imageSrc", description: "Optional background image path" },
+    { key: "imageAlt", description: "Alt text for the background image" },
+    { key: "ambientMotion", description: "Slow zoom/pan effect", values: AMBIENT_MOTION_VALUES }
+  ],
+  content: [{ key: "title", description: "Heading shown above the complete body" }],
+  statHighlight: [
+    { key: "stat", description: 'The statistic (e.g. "89%", "2x")' },
+    { 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: "title", description: "Optional heading above the 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 }
+  ],
+  barChart: CHART_DESCRIPTORS([STACKED_DESCRIPTOR]),
+  columnChart: CHART_DESCRIPTORS([STACKED_DESCRIPTOR]),
+  pieChart: CHART_DESCRIPTORS(),
+  donutChart: CHART_DESCRIPTORS(),
+  lineChart: CHART_DESCRIPTORS(),
+  areaChart: CHART_DESCRIPTORS(),
+  scatterChart: CHART_DESCRIPTORS(),
+  tree: [
+    { key: "title", description: "Optional title above the tree" },
+    { key: "colorScheme", description: "Folder-row color scheme", valueHint: COLOR_SCHEME_HINT },
+    // `items` is a nested structure derived from the tree fence, not an
+    // inline string — declared so it isn't flagged as unknown.
+    { key: "items", description: "Tree items (derived from the tree fence)" }
+  ],
+  timeline: [
+    { key: "title", description: "Optional title above the timeline" },
+    {
+      key: "colorScheme",
+      description: "Track and marker color scheme",
+      valueHint: COLOR_SCHEME_HINT
+    },
+    // Tracks/events and branch links are nested structures derived from the
+    // timeline source, not values that can be expressed as one inline string.
+    { key: "tracks", description: "Timeline tracks and events (supply via template data)" },
+    { key: "links", description: "Branch links between event ids (supply via template data)" }
+  ],
+  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 removeStatPhrase(text, start, end) {
-  const before = text.slice(0, start).trim();
-  let after = text.slice(end);
-  if (!before) after = after.replace(/^\s*(?:[-–—:]\s*)?/, "");
-  else after = after.trim();
-  return [before, after].filter(Boolean).join(" ").trim();
+function descriptorsFor(canonical) {
+  const specific = TEMPLATE_INPUT_DESCRIPTORS[canonical];
+  if (!specific) return void 0;
+  return [...specific, ...BASE_INPUT_DESCRIPTORS];
 }
-function bodyWithoutParagraphStat(contents, paragraphIndex, paragraphText, start, end) {
-  if (!contents) return "";
-  return contents.map(
-    (node, index) => index === paragraphIndex ? removeStatPhrase(paragraphText, start, end) : extractPlainText(node).trim()
-  ).filter(Boolean).join("\n").trim();
+function descriptorMap(descriptors) {
+  return new Map(descriptors.map((d) => [d.key, d]));
 }
-function deriveStatHighlightInputs(headingText, contents, bodyText3) {
-  const paragraph = firstParagraph(contents);
-  if (paragraph) {
-    const paragraphText = extractPlainText(paragraph.node).trim();
-    const strongStat = leadingStrongStat(paragraph.node);
-    if (strongStat) {
-      const start = paragraphText.indexOf(strongStat);
-      const description = bodyWithoutParagraphStat(
-        contents,
-        paragraph.index,
-        paragraphText,
-        start,
-        start + strongStat.length
-      );
-      return {
-        stat: strongStat,
-        description: description || headingText || strongStat
-      };
+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;
     }
   }
-  const trimmedHeading = headingText.trim();
-  const headingStat = matchNumberHighlight(trimmedHeading);
-  if (headingStat && headingStat.index === 0 && headingStat.end === trimmedHeading.length) {
-    return { stat: headingText, description: bodyText3 || headingText };
-  }
-  if (paragraph) {
-    const paragraphText = extractPlainText(paragraph.node).trim();
-    const bodyStat = matchNumberHighlight(paragraphText);
-    if (bodyStat) {
-      const description = bodyWithoutParagraphStat(
-        contents,
-        paragraph.index,
-        paragraphText,
-        bodyStat.index,
-        bodyStat.end
-      );
-      return {
-        stat: bodyStat.value,
-        description: description || headingText || bodyStat.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 };
   }
-  return { stat: headingText, description: bodyText3 || headingText };
 }
-function normalizeCoverageText(value) {
-  return value.replace(/\s+/g, " ").trim();
+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 autoTemplatePreservesContent(templateName, contents) {
-  const nodes = contents ?? [];
-  switch (templateName) {
-    case "quote":
-      return nodes.length === 1 && nodes[0]?.type === "blockquote";
-    case "dataTable":
-      return nodes.length === 1 && nodes[0]?.type === "table";
-    case "list":
-      return nodes.length === 1 && nodes[0]?.type === "list";
-    case "diagram":
-    case "timeline":
-      return nodes.length === 1 && nodes[0]?.type === "code";
-    case "tree":
-      return nodes.length === 1 && (nodes[0]?.type === "code" || nodes[0]?.type === "list");
-    case "photoGrid": {
-      const images = extractImages(nodes);
-      if (images.length < 2 || images.length > 4) return false;
-      const bodyText3 = normalizeCoverageText(extractBodyPlainText(nodes));
-      const representedText = normalizeCoverageText(
-        images.map((image) => image.alt).filter(Boolean).join(" ")
-      );
-      return bodyText3 === "" || bodyText3 === representedText;
-    }
-    case "videoWithCaption": {
-      const videos = extractEmbeddedVideos(nodes);
-      if (videos.length !== 1) return false;
-      const bodyText3 = normalizeCoverageText(extractBodyPlainText(nodes));
-      return bodyText3 === normalizeCoverageText(videos[0]?.alt ?? "");
-    }
-    case "leftFeature":
-    case "rightFeature":
-    case "statHighlight":
-      return true;
-    default:
-      return 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 deriveTemplateInputs(templateName, headingText, contents, options = {}) {
-  const placeholders = options.placeholders === true;
-  const bodyText3 = extractBodyPlainText(contents);
-  switch (templateName) {
-    case "statHighlight": {
-      const inputs = deriveStatHighlightInputs(headingText, contents, bodyText3);
-      if (options.preserveSourceHeading && headingText && inputs.stat !== headingText && inputs.description !== headingText) {
-        return {
-          ...inputs,
-          description: headingText,
-          ...inputs.description ? { detail: inputs.description } : {}
-        };
-      }
-      return inputs;
-    }
-    case "quote": {
-      const quote = extractBlockquoteText(contents) || bodyText3;
-      if (quote) return { quote, ...headingText ? { title: headingText } : {} };
-      return { quote: headingText };
-    }
-    case "fullBleedQuote":
-    case "pullQuote": {
-      const text = extractBlockquoteText(contents) || bodyText3 || headingText;
-      return { text };
-    }
-    case "factCard":
-      return { fact: headingText, explanation: bodyText3 || headingText };
-    case "comparisonBar":
-      return placeholders ? { leftLabel: "A", leftValue: 60, rightLabel: "B", rightValue: 40 } : null;
-    case "list": {
-      const items = extractListItems(contents);
-      if (items.length > 0) return { items, ...headingText ? { title: headingText } : {} };
-      return placeholders ? { items: ["Item 1", "Item 2", "Item 3"] } : null;
-    }
-    case "definitionCard":
-      return { term: headingText, definition: bodyText3 || headingText };
-    case "dateEvent":
-      return { date: headingText, description: bodyText3 || headingText };
-    case "dataTable": {
-      const tableData = extractTableFromContents(contents);
-      if (tableData) return { ...tableData, ...headingText ? { title: headingText } : {} };
-      return placeholders ? { headers: ["Column"], rows: [["Data"]] } : null;
-    }
-    case "imageWithCaption": {
-      const img = extractFirstImage(contents);
-      if (!img) return placeholders ? { caption: headingText } : null;
-      return { imageSrc: img.src, imageAlt: img.alt || headingText, caption: headingText };
-    }
-    case "photoGrid": {
-      const images = extractImages(contents, 4);
-      if (images.length < 2) return placeholders ? {} : null;
-      return {
-        images: images.map((i) => ({ src: i.src, alt: i.alt })),
-        caption: headingText
-      };
-    }
-    case "videoWithCaption": {
-      const video = extractFirstEmbeddedVideo(contents);
-      if (!video) return placeholders ? { caption: headingText } : null;
-      return {
-        videoSrc: video.src,
-        posterSrc: video.posterSrc,
-        videoAlt: video.alt || headingText,
-        caption: headingText
-      };
+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;
     }
-    case "leftFeature":
-    case "rightFeature": {
-      const img = extractFirstImage(contents);
-      if (!img && !placeholders) return null;
-      return {
-        imageSrc: img?.src ?? "",
-        imageAlt: img?.alt || headingText,
-        imageWidth: img?.width,
-        imageHeight: img?.height,
-        title: headingText,
-        body: bodyText3
-      };
+    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}` });
+      }
     }
-    case "diagram": {
-      const fences = (contents ?? []).filter((n) => n.type === "code");
-      const fence = fences.length === 1 && isEligibleAsciiFenceLang(fences[0].lang) ? fences[0] : void 0;
-      const detection = fence ? detectAsciiDiagram(fence.value, { explicit: isExplicitDiagramLang(fence.lang) }) : void 0;
-      if (!detection?.isDiagram || !detection.diagram) return placeholders ? {} : null;
-      const { nodes, edges } = asciiDiagramToTemplateData(detection.diagram);
-      return { nodes, edges, ...headingText ? { title: headingText } : {} };
+  }
+  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}"`
+      });
     }
-    case "timeline": {
-      const fences = (contents ?? []).filter((n) => n.type === "code");
-      const fence = fences.length === 1 && isEligibleAsciiTimelineFenceLang(fences[0].lang) ? fences[0] : void 0;
-      const detection = fence ? detectAsciiTimeline(fence.value, { explicit: true }) : void 0;
-      if (!detection?.isTimeline || !detection.timeline) return placeholders ? {} : null;
-      const { tracks, links } = asciiTimelineToTemplateData(detection.timeline);
-      return { tracks, links, ...headingText ? { title: headingText } : {} };
+  }
+  return findings;
+}
+
+// src/doc/templates/fallbackBlock.ts
+var MAX_BODY_CHARS = 600;
+function fallbackBlockLayers(block, context, notice) {
+  const colors = resolveColorScheme(context, "blue");
+  const { layout } = context;
+  const title = block.title ?? block.id ?? "";
+  const body = extractBodyText(block);
+  const layers = [
+    {
+      type: "shape",
+      id: "fallback-bg",
+      content: { shape: "rect", fill: colors.bg },
+      position: { x: 0, y: 0, width: "100%", height: "100%" }
     }
-    case "tree": {
-      const fences = (contents ?? []).filter((n) => n.type === "code");
-      const fence = fences.length === 1 && isEligibleTreeFenceLang(fences[0].lang) ? fences[0] : void 0;
-      if (fence) {
-        const detection = detectTree(fence.value, { explicit: isExplicitTreeLang(fence.lang) });
-        if (detection.isTree && detection.tree) {
-          const { items } = treeToTemplateData(detection.tree);
-          return { items, ...headingText ? { title: headingText } : {} };
+  ];
+  if (title) {
+    layers.push({
+      type: "text",
+      id: "fallback-title",
+      content: {
+        text: title,
+        style: {
+          fontSize: themedFontSize(56, context, true),
+          fontFamily: getThemeFont(context, "title"),
+          fontWeight: "bold",
+          color: colors.text,
+          textAlign: "center"
         }
+      },
+      position: {
+        x: "50%",
+        y: body ? "28%" : "50%",
+        anchor: "center",
+        width: layout.maxTextWidth
       }
-      const list = findFirstList(contents);
-      if (list) {
-        const { items } = treeToTemplateData(treeFromMarkdownList(list));
-        if (items.length > 0) return { items, ...headingText ? { title: headingText } : {} };
+    });
+  }
+  if (body) {
+    layers.push({
+      type: "text",
+      id: "fallback-body",
+      content: {
+        text: body,
+        style: {
+          fontSize: themedFontSize(28, context),
+          fontFamily: getThemeFont(context, "body"),
+          color: colors.text,
+          textAlign: "center"
+        }
+      },
+      position: {
+        x: "50%",
+        y: "55%",
+        anchor: "center",
+        width: layout.maxTextWidth
       }
-      return placeholders ? {} : null;
-    }
-    default:
-      return placeholders ? {} : null;
+    });
   }
+  layers.push({
+    type: "text",
+    id: "fallback-notice",
+    content: {
+      text: `\u26A0 ${notice}`,
+      style: {
+        fontSize: themedFontSize(18, context),
+        fontFamily: getThemeFont(context, "body"),
+        color: withAlpha(colors.text, 0.6),
+        textAlign: "center"
+      }
+    },
+    position: { x: "50%", y: "92%", anchor: "center", width: layout.maxTextWidth }
+  });
+  return layers;
+}
+function extractBodyText(block) {
+  if (!block.contents || block.contents.length === 0) return "";
+  const text = block.contents.map((node) => extractPlainText(node)).join("\n").trim();
+  if (text.length <= MAX_BODY_CHARS) return text;
+  return `${text.slice(0, MAX_BODY_CHARS).trimEnd()}\u2026`;
 }
 
 // src/doc/templates/mediaLayoutPolicy.ts
@@ -6206,6 +7421,55 @@ var BLOCK_MEDIA_LAYOUT_POLICIES = {
     unconsumedMedia: "reserved-slot",
     variants: DENSE_VARIANTS
   },
+  barChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
+  columnChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
+  pieChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
+  donutChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
+  lineChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
+  areaChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
+  scatterChart: {
+    summary: "The chart remains wide; supplemental media stacks below the dense data region.",
+    noMedia: "template-default",
+    ownership: "supplemental",
+    unconsumedMedia: "reserved-slot",
+    variants: DENSE_VARIANTS
+  },
   diagram: {
     summary: "The node-and-edge canvas is intrinsic media and retains its spatial coordinate system.",
     noMedia: "intrinsic-visual",
@@ -7191,6 +8455,34 @@ var TEMPLATE_METADATA = {
     label: "Data Table",
     description: "Renders tabular data in a clean, styled table with a header row."
   },
+  barChart: {
+    label: "Bar Chart",
+    description: "Horizontal bars from the block's markdown table \u2014 one bar per row."
+  },
+  columnChart: {
+    label: "Column Chart",
+    description: "Vertical columns from the block's markdown table \u2014 one column per row."
+  },
+  pieChart: {
+    label: "Pie Chart",
+    description: "A pie of the block's markdown table \u2014 each row becomes a labeled slice."
+  },
+  donutChart: {
+    label: "Donut Chart",
+    description: "A donut of the block's markdown table \u2014 each row becomes a labeled slice."
+  },
+  lineChart: {
+    label: "Line Chart",
+    description: "Lines from the block's markdown table \u2014 one line per value column."
+  },
+  areaChart: {
+    label: "Area Chart",
+    description: "Filled area lines from the block's markdown table \u2014 one area per value column."
+  },
+  scatterChart: {
+    label: "Scatter Chart",
+    description: "An x/y scatter plot from the block's markdown table's numeric columns."
+  },
   diagram: {
     label: "Diagram",
     description: "Renders sub-headings as connected nodes \u2014 edit visually as a node-and-edge diagram."
@@ -7336,6 +8628,48 @@ var TEMPLATE_AUTHORING_METADATA = {
     safeForContentFirst: false,
     placement: "heading"
   },
+  barChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
+  columnChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
+  pieChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
+  donutChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
+  lineChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
+  areaChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
+  scatterChart: {
+    role: "data",
+    bodyPolicy: "structured",
+    safeForContentFirst: false,
+    placement: "heading"
+  },
   diagram: {
     role: "spatial",
     bodyPolicy: "structured",
@@ -8200,6 +9534,18 @@ function time(raw) {
   if (raw == null) return null;
   return parseTimeSeconds(raw);
 }
+function videoPlacement(params) {
+  const explicit = params.placement ?? params.presentation;
+  if (explicit === "content") return "content";
+  if (explicit === "pip" || explicit === "picture-in-picture") return "picture-in-picture";
+  if (explicit === "overlay" || explicit === "full-frame") return "overlay";
+  if (params.pip === "" || params.pip === "true") return "picture-in-picture";
+  if (params.overlay === "" || params.overlay === "true") return "overlay";
+  return void 0;
+}
+function lockToBlock(raw) {
+  return raw !== "false" && raw !== "0";
+}
 function toMediaClip(parsed, id) {
   const { template, params } = parsed;
   if (!template || !MEDIA_TEMPLATES.has(template)) return null;
@@ -8214,13 +9560,78 @@ function toMediaClip(parsed, id) {
     startAt: time(params.startAt ?? params.startTime) ?? 0,
     anchor
   };
+  const placement = kind === "video" ? videoPlacement(params) : void 0;
+  if (placement && placement !== "content") clip.placement = placement;
+  if (kind === "video" && placement && placement !== "content" && params.lockToBlock != null) {
+    const locked = lockToBlock(params.lockToBlock);
+    clip.lockToBlock = locked;
+    clip.anchor = locked ? "block" : "document";
+    if (locked) clip.startAt = 0;
+  }
   const clipStart = time(params.clipStart);
   const clipEnd = time(params.clipEnd);
   if (clipStart != null) clip.clipStart = clipStart;
   if (clipEnd != null) clip.clipEnd = clipEnd;
+  if (clip.lockToBlock === true) delete clip.clipEnd;
   if (params.spillover === "true" || params.spillover === "") clip.spillover = true;
   return clip;
 }
+function firstVideoElement(children) {
+  const visit = (nodes) => {
+    for (const child of nodes) {
+      if (child.type !== "htmlElement") continue;
+      if (child.tagName === "video") return child;
+      const nested = visit(child.children);
+      if (nested) return nested;
+    }
+    return null;
+  };
+  return visit(children);
+}
+function standaloneHtmlVideo(node) {
+  if (node.type === "htmlBlock") {
+    if (!/^\s*<video\b/i.test(node.rawHtml)) return null;
+    const element = firstVideoElement(node.htmlChildren);
+    return element ? { element, raw: node.rawHtml.trim() } : null;
+  }
+  if (node.type !== "paragraph" || !node.children.every((child) => child.type === "htmlInline")) {
+    return null;
+  }
+  const raw = node.children.map((child) => child.type === "htmlInline" ? child.rawHtml : "").join("");
+  if (!/^\s*<video\b[\s\S]*<\/video>\s*$/i.test(raw)) return null;
+  for (const child of node.children) {
+    if (child.type !== "htmlInline") continue;
+    const element = firstVideoElement(child.htmlChildren);
+    if (element) return { element, raw: raw.trim() };
+  }
+  return null;
+}
+function htmlVideoClip(node, id) {
+  const authored = standaloneHtmlVideo(node);
+  if (!authored) return null;
+  const { element } = authored;
+  const placement = videoPlacement({
+    placement: element.attributes["data-squisq-video-placement"] ?? ""
+  });
+  if (!placement || placement === "content") return null;
+  const src = element.attributes.src;
+  if (!src) return null;
+  const locked = lockToBlock(element.attributes["data-squisq-video-lock-to-block"]);
+  const clip = {
+    id,
+    src,
+    kind: "video",
+    placement,
+    lockToBlock: locked,
+    startAt: locked ? 0 : time(element.attributes["data-squisq-video-start-at"]) ?? 0,
+    anchor: locked ? "block" : "document"
+  };
+  const clipStart = time(element.attributes["data-squisq-video-clip-start"]);
+  const clipEnd = time(element.attributes["data-squisq-video-clip-end"]);
+  if (clipStart != null) clip.clipStart = clipStart;
+  if (!locked && clipEnd != null) clip.clipEnd = clipEnd;
+  return clip;
+}
 function extractMediaFromContents(contents, makeId, blockId) {
   const media = [];
   const documentMedia = [];
@@ -8229,17 +9640,19 @@ function extractMediaFromContents(contents, makeId, blockId) {
   let originalIndex = 0;
   for (const node of contents ?? []) {
     const parsed = parseStandaloneAnnotation(node);
-    const clip = parsed ? toMediaClip(parsed, "") : null;
-    if (parsed && clip) {
+    const clip = parsed ? toMediaClip(parsed, "") : htmlVideoClip(node, "");
+    if (clip) {
       clip.id = makeId(clip.src, index++);
       const line = node.position?.start.line;
       if (line != null) clip.sourceLine = line;
       if (blockId !== void 0) {
-        const rawText = node.type === "paragraph" && node.children?.[0]?.type === "text" ? node.children[0].value.trim() : void 0;
+        const authoredHtml = standaloneHtmlVideo(node);
+        const rawText = node.type === "paragraph" && node.children?.[0]?.type === "text" ? node.children[0].value.trim() : authoredHtml?.raw;
         clip.origin = {
           blockId,
           index: originalIndex,
-          ...rawText !== void 0 ? { raw: rawText } : {}
+          ...rawText !== void 0 ? { raw: rawText } : {},
+          ...authoredHtml ? { format: "html" } : {}
         };
       }
       (clip.anchor === "document" ? documentMedia : media).push(clip);
@@ -8576,6 +9989,12 @@ function markdownToDoc(markdownDoc, options) {
     }
     currentTime += block.duration;
   }
+  const blockById = new Map(allBlocks.map((block) => [block.id, block]));
+  for (const clip of documentMedia) {
+    if (clip.lockToBlock === false && clip.origin?.format === "html" && !/\bdata-squisq-video-start-at\s*=/i.test(clip.origin.raw ?? "")) {
+      clip.startAt = blockById.get(clip.origin.blockId)?.startTime ?? 0;
+    }
+  }
   const captions = phrases.length > 0 ? {
     phrases,
     ...options?.captionsGeneratedAt ? { generatedAt: options.captionsGeneratedAt } : {},
@@ -8661,7 +10080,7 @@ function applyStructuredData(block, diagnostics) {
     }
     data = { ...data, ...result.data };
   }
-  if (block.template === "dataTable") {
+  if (TABLE_FED_TEMPLATES.has(resolveTemplateName(block.template ?? ""))) {
     const provided = (key) => data && key in data || block.templateOverrides && key in block.templateOverrides;
     if (!provided("headers") && !provided("rows")) {
       const table = findFirstTable(block.contents);
@@ -9187,6 +10606,7 @@ export {
   wrapWithPersistentLayers,
   TEMPLATE_ALIASES,
   resolveTemplateName,
+  TABLE_FED_TEMPLATES,
   CONTAINER_TEMPLATES,
   isContainerTemplate,
   resolveColorScheme,
@@ -9218,6 +10638,30 @@ export {
   rightFeature,
   mapBlock,
   fullBleedQuote,
+  computeDiagramLayout,
+  ASCII_CHAR_W,
+  ASCII_CHAR_H,
+  asciiCellToCanvas,
+  canvasToAsciiCell,
+  asciiDiagramToTemplateData,
+  asciiDiagramFromTemplateData,
+  asciiDiagramFromBlocks,
+  asciiTimelineToTemplateData,
+  treeToTemplateData,
+  treeFromTemplateData,
+  treeFromMarkdownList,
+  findFirstList,
+  extractBodyPlainText,
+  extractListItems,
+  extractRichListItems,
+  extractImages,
+  extractFirstImage,
+  extractEmbeddedVideos,
+  extractFirstEmbeddedVideo,
+  extractTableFromContents,
+  extractBlockquoteText,
+  autoTemplatePreservesContent,
+  deriveTemplateInputs,
   listBlock,
   photoGrid,
   definitionCard,
@@ -9226,12 +10670,12 @@ export {
   videoWithCaption,
   videoPullQuote,
   dataTable,
+  buildChartData,
   DIAGRAM_LABEL_LINE_HEIGHT,
   DIAGRAM_LABEL_HORIZONTAL_PADDING,
   DIAGRAM_LABEL_VERTICAL_PADDING,
   DIAGRAM_LABEL_MIN_FONT_SIZE,
   fitDiagramLabel,
-  computeDiagramLayout,
   diagramBlock,
   treeBlock,
   timelineBlock,
@@ -9252,28 +10696,6 @@ export {
   coerceTemplateParams,
   lintTemplateParams,
   fallbackBlockLayers,
-  ASCII_CHAR_W,
-  ASCII_CHAR_H,
-  asciiCellToCanvas,
-  canvasToAsciiCell,
-  asciiDiagramToTemplateData,
-  asciiDiagramFromTemplateData,
-  asciiDiagramFromBlocks,
-  asciiTimelineToTemplateData,
-  treeToTemplateData,
-  treeFromTemplateData,
-  treeFromMarkdownList,
-  findFirstList,
-  extractBodyPlainText,
-  extractListItems,
-  extractImages,
-  extractFirstImage,
-  extractEmbeddedVideos,
-  extractFirstEmbeddedVideo,
-  extractTableFromContents,
-  extractBlockquoteText,
-  autoTemplatePreservesContent,
-  deriveTemplateInputs,
   BLOCK_MEDIA_LAYOUT_POLICIES,
   getBlockMediaLayoutPolicy,
   materializeBlockLayers,