@bendyline/squisq 2.3.1 → 2.3.3

package/dist/{chunk-3FRUQLQR.js → chunk-IZLKI3IL.js}

@@ -5,6 +5,7 @@ import {
   coerceTemplateParams,
   deriveTemplateInputs,
   extractBodyPlainText,
+  extractRichListItems,
   flattenBlocks,
   flattenRenderableBlocks,
   getBlockBodyText,
@@ -24,7 +25,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-E3RXZUNP.js";
+} from "./chunk-GQNH7PLN.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -59,12 +60,12 @@ import {
 } from "./chunk-BAOV476U.js";
 import {
   parseMarkdown
-} from "./chunk-ACZOVWX3.js";
+} from "./chunk-G3JOS25T.js";
 import {
   KNOWN_BLOCK_META_KEYS,
   coerceAnnotationValues,
   serializeAnnotation
-} from "./chunk-ZQKZSJAX.js";
+} from "./chunk-2VCNTDNZ.js";
 import {
   extractPlainText,
   getChildren,
@@ -633,6 +634,13 @@ var sectionHeader = (input) => {
     mediaBackground: !!s.imageSrc
   };
 };
+var content = (input) => {
+  const c = input;
+  return {
+    kind: "prose",
+    slots: { title: c.title, body: bodyRichText(input) }
+  };
+};
 var statHighlight = (input) => {
   const s = input;
   return {
@@ -756,11 +764,16 @@ var fullBleedQuote = (input) => {
 };
 var list = (input) => {
   const l = input;
+  const contents = input.contents;
+  const richItems = extractRichListItems(contents);
   return {
     kind: "item-list",
     slots: {
       title: l.title,
-      items: (l.items ?? []).map((item) => ({ body: item })),
+      items: (l.items ?? []).map((item, index) => ({
+        body: item,
+        ...richItems[index]?.text === item ? { markdown: richItems[index].markdown } : {}
+      })),
       media: accentImageMedia(l.accentImage)
     },
     colorScheme: l.colorScheme
@@ -899,6 +912,7 @@ var layout = (input, ctx) => canvasDraft("layout", ctx, input);
 var sectionExtractors = {
   title,
   sectionHeader,
+  content,
   statHighlight,
   quote,
   factCard,

package/dist/{chunk-3IGPAPQ7.js → chunk-UA5DTYAY.js}

@@ -1,7 +1,7 @@
 import {
   assertMarkdownDocumentWithinLimits,
   toMdast
-} from "./chunk-ACZOVWX3.js";
+} from "./chunk-G3JOS25T.js";
 import {
   formatFrontmatterYaml
 } from "./chunk-BCCXTMN5.js";
@@ -200,249 +200,6 @@ ${cleaned}`;
   return cleaned;
 }
 
-// src/markdown/sanitize.ts
-var SAFE_LINK_SCHEMES = /* @__PURE__ */ new Set(["http", "https", "mailto", "tel"]);
-var SAFE_MEDIA_SCHEMES = /* @__PURE__ */ new Set(["http", "https", "blob"]);
-var NEVER_ALLOWED_SCHEMES = /* @__PURE__ */ new Set(["javascript", "vbscript", "data"]);
-var SAFE_DATA_MEDIA_RE = /^data:(?:image\/(?!svg\+xml)[a-z0-9.+-]+|audio\/[a-z0-9.+-]+|video\/[a-z0-9.+-]+);/i;
-var SAFE_TAGS = /* @__PURE__ */ new Set([
-  "a",
-  "abbr",
-  "b",
-  "blockquote",
-  "br",
-  "caption",
-  "cite",
-  "code",
-  "col",
-  "colgroup",
-  "data",
-  "dd",
-  "del",
-  "details",
-  "dfn",
-  "div",
-  "dl",
-  "dt",
-  "em",
-  "figcaption",
-  "figure",
-  "h1",
-  "h2",
-  "h3",
-  "h4",
-  "h5",
-  "h6",
-  "hr",
-  "i",
-  "img",
-  "kbd",
-  "li",
-  "mark",
-  "ol",
-  "p",
-  "pre",
-  "q",
-  "s",
-  "samp",
-  "small",
-  "source",
-  "span",
-  "strong",
-  "sub",
-  "summary",
-  "sup",
-  "table",
-  "tbody",
-  "td",
-  "tfoot",
-  "th",
-  "thead",
-  "time",
-  "tr",
-  "track",
-  "u",
-  "ul",
-  "var",
-  "video",
-  "audio"
-]);
-var DROP_WITH_CONTENT_TAGS = /* @__PURE__ */ new Set([
-  "base",
-  "button",
-  "embed",
-  "form",
-  "iframe",
-  "input",
-  "link",
-  "meta",
-  "object",
-  "option",
-  "script",
-  "select",
-  "style",
-  "svg",
-  "template",
-  "textarea"
-]);
-var GLOBAL_ATTRS = /* @__PURE__ */ new Set(["class", "id", "title", "role"]);
-var TAG_ATTRS = {
-  a: /* @__PURE__ */ new Set(["href", "target", "rel"]),
-  audio: /* @__PURE__ */ new Set(["src", "controls", "preload", "muted", "loop"]),
-  col: /* @__PURE__ */ new Set(["span", "width"]),
-  colgroup: /* @__PURE__ */ new Set(["span"]),
-  data: /* @__PURE__ */ new Set(["value"]),
-  img: /* @__PURE__ */ new Set(["src", "alt", "width", "height", "loading", "decoding"]),
-  li: /* @__PURE__ */ new Set(["value"]),
-  ol: /* @__PURE__ */ new Set(["start", "type"]),
-  q: /* @__PURE__ */ new Set(["cite"]),
-  source: /* @__PURE__ */ new Set(["src", "type", "media"]),
-  td: /* @__PURE__ */ new Set(["colspan", "rowspan", "align"]),
-  th: /* @__PURE__ */ new Set(["colspan", "rowspan", "align", "scope"]),
-  time: /* @__PURE__ */ new Set(["datetime"]),
-  track: /* @__PURE__ */ new Set(["src", "kind", "label", "srclang", "default"]),
-  video: /* @__PURE__ */ new Set([
-    "src",
-    "poster",
-    "width",
-    "height",
-    "controls",
-    "preload",
-    "muted",
-    "loop",
-    "playsinline"
-  ])
-};
-var SAFE_ATTR_NAME_RE = /^[a-z][a-z0-9:_.-]*$/;
-var SAFE_OL_TYPES = /* @__PURE__ */ new Set(["1", "a", "A", "i", "I"]);
-var SAFE_PRELOAD_VALUES = /* @__PURE__ */ new Set(["none", "metadata", "auto"]);
-var SAFE_TRACK_KINDS = /* @__PURE__ */ new Set(["subtitles", "captions", "descriptions", "chapters", "metadata"]);
-function sanitizeUrl(url, kind = "link", options) {
-  if (typeof url !== "string") return null;
-  const trimmed = url.trim();
-  if (!trimmed) return null;
-  const compact = stripUrlSchemeNoise(trimmed);
-  const colon = compact.indexOf(":");
-  const firstPathChar = firstIndexOfAny(compact, ["/", "?", "#"]);
-  const hasScheme = colon >= 0 && (firstPathChar < 0 || colon < firstPathChar);
-  if (!hasScheme) return trimmed;
-  const scheme = compact.slice(0, colon).toLowerCase();
-  if (kind === "media") {
-    if (scheme === "data") return SAFE_DATA_MEDIA_RE.test(compact) ? trimmed : null;
-    return SAFE_MEDIA_SCHEMES.has(scheme) ? trimmed : null;
-  }
-  if (SAFE_LINK_SCHEMES.has(scheme)) return trimmed;
-  if (options?.extraLinkSchemes?.includes(scheme) && !NEVER_ALLOWED_SCHEMES.has(scheme)) {
-    return trimmed;
-  }
-  return null;
-}
-function sanitizeHtmlNodes(nodes) {
-  const out = [];
-  for (const node of nodes) {
-    out.push(...sanitizeHtmlNode(node));
-  }
-  return out;
-}
-function sanitizeHtmlNode(node) {
-  switch (node.type) {
-    case "htmlText":
-      return [node];
-    case "htmlComment":
-      return [];
-    case "htmlElement":
-      return sanitizeHtmlElement(node);
-  }
-}
-function sanitizeHtmlElement(node) {
-  const tag = node.tagName.toLowerCase();
-  if (DROP_WITH_CONTENT_TAGS.has(tag)) return [];
-  const children = sanitizeHtmlNodes(node.children);
-  if (!SAFE_TAGS.has(tag)) return children;
-  return [
-    {
-      type: "htmlElement",
-      tagName: tag,
-      attributes: sanitizeAttrs(tag, node.attributes),
-      children,
-      selfClosing: node.selfClosing
-    }
-  ];
-}
-function sanitizeAttrs(tag, attrs) {
-  const out = {};
-  for (const [rawName, rawValue] of Object.entries(attrs)) {
-    const name = rawName.toLowerCase();
-    if (!isAllowedAttr(tag, name)) continue;
-    const value = String(rawValue);
-    const safeValue = sanitizeAttrValue(tag, name, value);
-    if (safeValue === null) continue;
-    out[name] = safeValue;
-  }
-  if (tag === "a" && out.target === "_blank") {
-    out.rel = ensureRelTokens(out.rel, ["noopener", "noreferrer"]);
-  }
-  return out;
-}
-function isAllowedAttr(tag, name) {
-  if (!SAFE_ATTR_NAME_RE.test(name)) return false;
-  if (name.startsWith("on")) return false;
-  if (name.startsWith("aria-") || name.startsWith("data-")) return true;
-  if (GLOBAL_ATTRS.has(name)) return true;
-  return TAG_ATTRS[tag]?.has(name) ?? false;
-}
-function sanitizeAttrValue(tag, name, value) {
-  if (name === "href") return sanitizeUrl(value, "link");
-  if (name === "src" || name === "poster") return sanitizeUrl(value, "media");
-  if ((name === "width" || name === "height" || name === "span" || name === "colspan" || name === "rowspan" || name === "value") && !isNonNegativeInteger(value)) {
-    return null;
-  }
-  if (name === "start" && !isInteger(value)) return null;
-  if (name === "type" && tag === "ol" && !SAFE_OL_TYPES.has(value)) return null;
-  if (name === "preload" && !SAFE_PRELOAD_VALUES.has(value)) return null;
-  if (name === "kind" && tag === "track" && !SAFE_TRACK_KINDS.has(value)) return null;
-  if (name === "align" && value !== "left" && value !== "right" && value !== "center") return null;
-  if (name === "target")
-    return value === "_blank" || value === "_self" || value === "_parent" || value === "_top" ? value : null;
-  if (name === "rel") return sanitizeRel(value);
-  return value;
-}
-function sanitizeRel(value) {
-  return relTokens(value).join(" ");
-}
-function ensureRelTokens(value, required) {
-  const tokens = new Set(value ? relTokens(value) : []);
-  for (const token of required) tokens.add(token);
-  return Array.from(tokens).join(" ");
-}
-function relTokens(value) {
-  const tokens = value.split(/\s+/).map((token) => token.trim().toLowerCase()).filter(Boolean).filter((token) => /^[a-z0-9_-]+$/.test(token));
-  return Array.from(new Set(tokens));
-}
-function isInteger(value) {
-  return /^-?\d+$/.test(value.trim());
-}
-function isNonNegativeInteger(value) {
-  return /^\d+$/.test(value.trim());
-}
-function firstIndexOfAny(value, needles) {
-  let result = -1;
-  for (const needle of needles) {
-    const index = value.indexOf(needle);
-    if (index >= 0 && (result < 0 || index < result)) result = index;
-  }
-  return result;
-}
-function stripUrlSchemeNoise(value) {
-  let out = "";
-  for (const char of value) {
-    const code = char.charCodeAt(0);
-    if (code <= 32 || code === 127 || char.trim() === "") continue;
-    out += char;
-  }
-  return out;
-}
-
 // src/markdown/resourcePolicy.ts
 var DEFAULT_RESOURCE_MAX_BYTES = 64 * 1024 * 1024;
 var DEFAULT_RESOURCE_TIMEOUT_MS = 15e3;
@@ -633,8 +390,6 @@ function tooLarge(maxBytes) {
 
 export {
   stringifyMarkdown,
-  sanitizeUrl,
-  sanitizeHtmlNodes,
   DEFAULT_RESOURCE_MAX_BYTES,
   DEFAULT_RESOURCE_TIMEOUT_MS,
   DEFAULT_INTERACTIVE_RESOURCE_POLICY,

package/dist/doc/index.d.ts

@@ -1,11 +1,11 @@
-import { aX as TemplateBlock, aY as TemplateContext, V as Layer, p as CustomTemplateDefinition, a_ as TemplateRegistry, b1 as Theme, bq as ViewportConfig, az as PersistentLayerConfig, G as DocBlock, br as ViewportOrientation, ay as PersistentLayer, be as TitleBlockInput, aM as SectionHeaderInput, aS as StatHighlightInput, aH as QuoteBlockInput, L as FactCardInput, bl as TwoColumnInput, u as DateEventInput, T as ImageWithCaptionInput, Y as LeftFeatureInput, aK as RightFeatureInput, $ as MapBlockInput, aR as StartBlockConfig, O as FullBleedQuoteInput, _ as ListBlockInput, aD as PhotoGridInput, w as DefinitionCardInput, n as ComparisonBarInput, aG as PullQuoteInput, bp as VideoWithCaptionInput, bo as VideoPullQuoteInput, t as DataTableInput, x as DiagramBlockInput, bg as TreeBlockInput, ba as TimelineBlockInput, B as Block, I as DrawingBlockInput, a3 as MarkerStyle, A as AccentImage, S as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, b3 as ThemeColorScheme, F as Doc, b5 as ThemeRegistry, ar as PageEmphasis, b4 as ThemePageStyle, H as DocDiagnostic, E as DiagramTemplateNode, z as DiagramTemplateEdge, bd as TimelineTemplateTrack, bc as TimelineTemplateLink } from '../Doc-COe-rPQB.js';
-export { J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, X as LayoutHints, aJ as RenderStyle, b2 as ThemeColorPalette, b8 as ThemeStyle, b9 as ThemeTypography, bm as VIEWPORT_PRESETS, bs as ViewportPreset, bx as createTemplateContext, bE as getLayoutHints, bH as getTwoColumnPositions, bI as getViewport, bJ as getViewportOrientation, bL as isTemplateBlock, bO as scaledFontSize } from '../Doc-COe-rPQB.js';
+import { aY as TemplateBlock, aZ as TemplateContext, W as Layer, q as CustomTemplateDefinition, a$ as TemplateRegistry, b2 as Theme, br as ViewportConfig, aA as PersistentLayerConfig, H as DocBlock, bs as ViewportOrientation, az as PersistentLayer, bf as TitleBlockInput, aN as SectionHeaderInput, o as ContentBlockInput, aT as StatHighlightInput, aI as QuoteBlockInput, M as FactCardInput, bm as TwoColumnInput, v as DateEventInput, U as ImageWithCaptionInput, Z as LeftFeatureInput, aL as RightFeatureInput, a0 as MapBlockInput, aS as StartBlockConfig, P as FullBleedQuoteInput, $ as ListBlockInput, aE as PhotoGridInput, x as DefinitionCardInput, n as ComparisonBarInput, aH as PullQuoteInput, bq as VideoWithCaptionInput, bp as VideoPullQuoteInput, u as DataTableInput, y as DiagramBlockInput, bh as TreeBlockInput, bb as TimelineBlockInput, B as Block, J as DrawingBlockInput, a4 as MarkerStyle, A as AccentImage, T as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, b4 as ThemeColorScheme, G as Doc, b6 as ThemeRegistry, as as PageEmphasis, b5 as ThemePageStyle, I as DocDiagnostic, F as DiagramTemplateNode, E as DiagramTemplateEdge, be as TimelineTemplateTrack, bd as TimelineTemplateLink } from '../Doc-BrgZC7SE.js';
+export { K as FRONTMATTER_CUSTOM_TEMPLATES_KEY, L as FRONTMATTER_CUSTOM_THEMES_KEY, Y as LayoutHints, aK as RenderStyle, b3 as ThemeColorPalette, b9 as ThemeStyle, ba as ThemeTypography, bn as VIEWPORT_PRESETS, bt as ViewportPreset, by as createTemplateContext, bF as getLayoutHints, bI as getTwoColumnPositions, bJ as getViewport, bK as getViewportOrientation, bM as isTemplateBlock, bP as scaledFontSize } from '../Doc-BrgZC7SE.js';
 import { K as MarkdownNode, a2 as TransitionType, a1 as TransitionDirection, M as MarkdownBlockNode, r as MarkdownHeading, n as MarkdownDocument, S as MarkdownTable, i as MarkdownCodeBlock, F as MarkdownList } from '../types-CUNc9biN.js';
 import { C as CoercedBlockMeta } from '../annotationCoercion-PtRQhk5V.js';
-import { c as PageSection } from '../materializePageSection-BSMOocve.js';
-export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-BSMOocve.js';
+import { c as PageSection } from '../materializePageSection-CrZWYnXM.js';
+export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-CrZWYnXM.js';
 import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BUTWjufL.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-DJt89gyP.js';
 
 /** Runtime registry composition for built-in and document-scoped templates. */
 
@@ -107,6 +107,182 @@ interface TemplateMetadata {
 }
 declare const TEMPLATE_METADATA: Record<string, TemplateMetadata>;
 
+/** Agent-oriented behavior metadata for every built-in template. */
+type TemplateAuthoringRole = 'opener' | 'divider' | 'content' | 'highlight' | 'quote' | 'comparison' | 'event' | 'media' | 'data' | 'spatial';
+type TemplateBodyPolicy = 'complete' | 'derived' | 'ignored' | 'structured';
+interface TemplateAuthoringMetadata {
+    /** Broad semantic job, independent of visual theme. */
+    role: TemplateAuthoringRole;
+    /** How source body prose participates in the rendered result. */
+    bodyPolicy: TemplateBodyPolicy;
+    /** Whether this template is a loss-averse default before visual optimization. */
+    safeForContentFirst: boolean;
+    /** Preferred annotation placement. Standalone annotations remain supported for deliberate extra blocks. */
+    placement: 'heading';
+}
+/**
+ * Kept exhaustive over TemplateBlock so adding a template requires an explicit
+ * statement about content retention before it can ship.
+ */
+declare const TEMPLATE_AUTHORING_METADATA: {
+    readonly title: {
+        readonly role: "opener";
+        readonly bodyPolicy: "ignored";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly sectionHeader: {
+        readonly role: "divider";
+        readonly bodyPolicy: "ignored";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly content: {
+        readonly role: "content";
+        readonly bodyPolicy: "complete";
+        readonly safeForContentFirst: true;
+        readonly placement: "heading";
+    };
+    readonly statHighlight: {
+        readonly role: "highlight";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly quote: {
+        readonly role: "quote";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly factCard: {
+        readonly role: "highlight";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly twoColumn: {
+        readonly role: "comparison";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly dateEvent: {
+        readonly role: "event";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly imageWithCaption: {
+        readonly role: "media";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly leftFeature: {
+        readonly role: "media";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly rightFeature: {
+        readonly role: "media";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly map: {
+        readonly role: "spatial";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly fullBleedQuote: {
+        readonly role: "quote";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly list: {
+        readonly role: "content";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly photoGrid: {
+        readonly role: "media";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly definitionCard: {
+        readonly role: "content";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly comparisonBar: {
+        readonly role: "comparison";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly pullQuote: {
+        readonly role: "quote";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly videoWithCaption: {
+        readonly role: "media";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly videoPullQuote: {
+        readonly role: "media";
+        readonly bodyPolicy: "derived";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly dataTable: {
+        readonly role: "data";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly diagram: {
+        readonly role: "spatial";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly tree: {
+        readonly role: "spatial";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly timeline: {
+        readonly role: "spatial";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly drawing: {
+        readonly role: "spatial";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+    readonly layout: {
+        readonly role: "spatial";
+        readonly bodyPolicy: "structured";
+        readonly safeForContentFirst: false;
+        readonly placement: "heading";
+    };
+};
+
 /**
  * Exhaustive media-layout policy for every built-in block template.
  *
@@ -150,7 +326,7 @@ interface BlockMediaLayoutPolicy {
     variants?: SupplementalMediaVariantMatrix;
 }
 /**
- * Canonical media contract for all 25 built-in templates. Entries are kept
+ * Canonical media contract for all built-in templates. Entries are kept
  * in registry/gallery order to make policy reviews easy to scan.
  */
 declare const BLOCK_MEDIA_LAYOUT_POLICIES: {
@@ -170,6 +346,13 @@ declare const BLOCK_MEDIA_LAYOUT_POLICIES: {
         readonly unconsumedMedia: "reserve-when-no-native-media";
         readonly variants: SupplementalMediaVariantMatrix;
     };
+    readonly content: {
+        readonly summary: "Preserves the complete heading and body; supplemental media receives a companion field.";
+        readonly noMedia: "template-default";
+        readonly ownership: "supplemental";
+        readonly unconsumedMedia: "reserved-slot";
+        readonly variants: SupplementalMediaVariantMatrix;
+    };
     readonly statHighlight: {
         readonly summary: "Uses its optional accent image natively; otherwise supplemental media occupies a companion field.";
         readonly noMedia: "template-without-optional-media";
@@ -439,6 +622,17 @@ declare function titleBlock(input: TitleBlockInput, context: TemplateContext): L
 
 declare function sectionHeader(input: SectionHeaderInput, context: TemplateContext): Layer[];
 
+/**
+ * Content-first template.
+ *
+ * Unlike visual-summary templates, this template deliberately preserves the
+ * complete plain-text projection of a Markdown block. It is intended as the
+ * loss-averse first pass for generated decks; authors can replace it with a
+ * more visual template after validation and preview.
+ */
+
+declare function contentBlock(input: ContentBlockInput, context: TemplateContext): Layer[];
+
 /**
  * Stat Highlight Template
  *
@@ -1466,6 +1660,14 @@ interface EmbeddedVideo {
 declare function extractBodyPlainText(contents?: MarkdownBlockNode[]): string;
 /** Extract list items as plain text. */
 declare function extractListItems(contents?: MarkdownBlockNode[]): string[];
+/** One authored Markdown list item with both plain and rich projections. */
+interface RichListItem {
+    text: string;
+    markdown: MarkdownBlockNode[];
+    html?: string;
+}
+/** Extract list items without discarding their inline Markdown formatting. */
+declare function extractRichListItems(contents?: MarkdownBlockNode[]): RichListItem[];
 /**
  * Find images referenced anywhere in block contents — both markdown
  * shorthand `![alt](url)` (type `image`) and raw HTML `<img>` tags
@@ -2768,4 +2970,4 @@ declare function treeFromMarkdownList(list: MarkdownList): Tree;
 /** Find the first top-level markdown list in a block's body, if any. */
 declare function findFirstList(contents: MarkdownBlockNode[] | undefined): MarkdownList | undefined;
 
-export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuiltInTemplateName, CONTAINER_TEMPLATES, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolvedPageBlock, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, TemplateBlock, TemplateContext, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, ViewportConfig, ViewportOrientation, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, autoTemplatePreservesContent, buildPageCss, buildPageCssVars, buildRegistry, canvasToAsciiCell, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, definitionCard, deriveTemplateInputs, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, materializeBlockLayers, nearestSnapPoint, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };
+export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, type BlockLayerMaterialization, type BlockMediaLayoutPolicy, type BuiltInTemplateName, CONTAINER_TEMPLATES, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type EmbeddedVideo, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type NarrationResolution, type NativeMediaLayout, type NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolvedPageBlock, type RichListItem, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, type SupplementalMediaLayoutVariant, type SupplementalMediaShape, type SupplementalMediaVariantMatrix, TEMPLATE_AUTHORING_METADATA, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, type TemplateAuthoringMetadata, type TemplateAuthoringRole, TemplateBlock, type TemplateBodyPolicy, TemplateContext, type TemplateInputDescriptor, type TemplateMediaOwnership, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type UnconsumedMediaBehavior, type ValidateOptions, ViewportConfig, ViewportOrientation, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, autoTemplatePreservesContent, buildPageCss, buildPageCssVars, buildRegistry, canvasToAsciiCell, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, contentBlock, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, definitionCard, deriveTemplateInputs, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractImages, extractListItems, extractRichListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, materializeBlockLayers, nearestSnapPoint, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };