@bendyline/squisq 1.3.0 → 1.4.0

package/dist/markdown/utils.js

@@ -140,6 +140,105 @@ export function parseFrontmatter(yaml) {
     }
     return Object.keys(result).length > 0 ? result : null;
 }
+const FRONTMATTER_BLOCK_RE = /^---\r?\n([\s\S]*?)\r?\n---(\r?\n)?/;
+/** Quote a frontmatter scalar so it round-trips cleanly through `parseFrontmatter`. */
+function formatFrontmatterValue(value) {
+    if (typeof value === 'boolean' || typeof value === 'number')
+        return String(value);
+    // Quote when needed: leading/trailing whitespace, leading punctuation that
+    // could trigger YAML modes, or values that look like reserved literals.
+    const needsQuote = /^\s|\s$/.test(value) ||
+        /^[!&*?|>%@`]/.test(value) ||
+        /[:#]/.test(value) ||
+        value === '' ||
+        value === 'true' ||
+        value === 'false' ||
+        /^-?\d+(\.\d+)?$/.test(value);
+    if (!needsQuote)
+        return value;
+    // Prefer double quotes; escape any embedded double-quote / backslash.
+    const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+/**
+ * Update a markdown source string's YAML frontmatter block, applying the
+ * given key/value updates. A `null` or `undefined` value removes the key.
+ * If no frontmatter block exists and any non-null update is supplied, a
+ * new block is prepended; if every update is a removal and no block
+ * exists, the source is returned unchanged.
+ *
+ * Existing key order is preserved; new keys are appended in the order
+ * they appear in `updates`. The simple parser used here handles plain
+ * `key: value` pairs only — comments, multi-line scalars, and nested
+ * structures are left untouched (we only rewrite lines whose key matches
+ * one in `updates`).
+ *
+ * @param source - The markdown source string.
+ * @param updates - Map of key → new value (or null/undefined to remove).
+ * @returns The updated markdown source string.
+ */
+export function setFrontmatterValues(source, updates) {
+    const updateKeys = Object.keys(updates);
+    if (updateKeys.length === 0)
+        return source;
+    const match = source.match(FRONTMATTER_BLOCK_RE);
+    const handled = new Set();
+    // Existing frontmatter block — rewrite line-by-line, preserving order.
+    if (match) {
+        const inner = match[1];
+        const lines = inner.split(/\r?\n/);
+        const newLines = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#')) {
+                newLines.push(line);
+                continue;
+            }
+            const colonIdx = trimmed.indexOf(':');
+            if (colonIdx < 1) {
+                newLines.push(line);
+                continue;
+            }
+            const key = trimmed.slice(0, colonIdx).trim();
+            if (!Object.prototype.hasOwnProperty.call(updates, key)) {
+                newLines.push(line);
+                continue;
+            }
+            handled.add(key);
+            const next = updates[key];
+            if (next === null || next === undefined)
+                continue; // remove
+            newLines.push(`${key}: ${formatFrontmatterValue(next)}`);
+        }
+        // Append any keys that weren't already present.
+        for (const key of updateKeys) {
+            if (handled.has(key))
+                continue;
+            const next = updates[key];
+            if (next === null || next === undefined)
+                continue;
+            newLines.push(`${key}: ${formatFrontmatterValue(next)}`);
+        }
+        // If every line got removed, drop the block entirely.
+        const nonEmpty = newLines.filter((l) => l.trim().length > 0);
+        const rest = source.slice(match[0].length);
+        if (nonEmpty.length === 0)
+            return rest;
+        return `---\n${newLines.join('\n')}\n---\n${rest}`;
+    }
+    // No existing block — only create one if there's at least one non-null
+    // value to write.
+    const fresh = [];
+    for (const key of updateKeys) {
+        const next = updates[key];
+        if (next === null || next === undefined)
+            continue;
+        fresh.push(`${key}: ${formatFrontmatterValue(next)}`);
+    }
+    if (fresh.length === 0)
+        return source;
+    return `---\n${fresh.join('\n')}\n---\n${source}`;
+}
 /**
  * Create a minimal MarkdownDocument from a list of block nodes.
  * Convenience function for programmatic document construction.
@@ -150,4 +249,60 @@ export function createDocument(...children) {
         children,
     };
 }
+/**
+ * Infer a human-readable title for a markdown document.
+ *
+ * Resolution order:
+ *   1. `title:` value in YAML frontmatter (when present and non-empty)
+ *   2. Text of the first heading found, walking top-level depth (H1, then
+ *      H2, etc.) — the shallowest heading wins regardless of source order
+ *
+ * Returns `undefined` when no usable title is found.
+ */
+export function inferDocumentTitle(doc) {
+    const fmTitle = doc.frontmatter?.title;
+    if (typeof fmTitle === 'string') {
+        const trimmed = fmTitle.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    let best = null;
+    for (const node of doc.children) {
+        if (node.type !== 'heading')
+            continue;
+        const text = extractPlainText(node).trim();
+        if (!text)
+            continue;
+        if (best === null || node.depth < best.depth) {
+            best = { depth: node.depth, text };
+            if (best.depth === 1)
+                break;
+        }
+    }
+    return best?.text;
+}
+/**
+ * Read a theme id from a markdown document's frontmatter.
+ *
+ * Checks the editor's canonical `squisq-theme` key first, then the
+ * shorter legacy aliases (`themeId`, `theme`). Returns `undefined`
+ * when none of them carry a non-empty string. Centralizing the lookup
+ * keeps the export pipelines (DOCX, PPTX, HTML, plain-HTML bundle) in
+ * sync with whatever the editor writes — adding a new frontmatter
+ * spelling later is a one-file change.
+ */
+export function readFrontmatterThemeId(frontmatter) {
+    if (!frontmatter)
+        return undefined;
+    const keys = ['squisq-theme', 'themeId', 'theme'];
+    for (const key of keys) {
+        const raw = frontmatter[key];
+        if (typeof raw === 'string') {
+            const trimmed = raw.trim();
+            if (trimmed)
+                return trimmed;
+        }
+    }
+    return undefined;
+}
 //# sourceMappingURL=utils.js.map

package/dist/markdown/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/markdown/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/markdown/utils.ts"],"names":[],"mappings":"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"}

package/dist/recommend/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Template recommendations for the editor's block template picker.
+ *
+ * @example
+ * ```ts
+ * import { parseMarkdown } from '@bendyline/squisq/markdown';
+ * import { profileBlockContents, recommendTemplatesForBlock } from '@bendyline/squisq/recommend';
+ *
+ * const doc = parseMarkdown(blockBodySource);
+ * const profile = profileBlockContents(doc.children);
+ * const { recommended, rest } = recommendTemplatesForBlock(profile, ALL_TEMPLATE_NAMES);
+ * ```
+ */
+export type { BlockContentProfile, RecommendationResult } from './templates.js';
+export { profileBlockContents, recommendTemplatesForBlock } from './templates.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/recommend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recommend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/recommend/index.js

@@ -0,0 +1,15 @@
+/**
+ * Template recommendations for the editor's block template picker.
+ *
+ * @example
+ * ```ts
+ * import { parseMarkdown } from '@bendyline/squisq/markdown';
+ * import { profileBlockContents, recommendTemplatesForBlock } from '@bendyline/squisq/recommend';
+ *
+ * const doc = parseMarkdown(blockBodySource);
+ * const profile = profileBlockContents(doc.children);
+ * const { recommended, rest } = recommendTemplatesForBlock(profile, ALL_TEMPLATE_NAMES);
+ * ```
+ */
+export { profileBlockContents, recommendTemplatesForBlock } from './templates.js';
+//# sourceMappingURL=index.js.map

package/dist/recommend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recommend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/recommend/templates.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Block template recommendations.
+ *
+ * Given a slice of markdown block nodes (the body underneath a heading),
+ * profile the content for image / video / quote / list / table / date /
+ * stat signals, then map that profile to the set of templates that make
+ * sense for the block. Used by the editor's template picker to surface a
+ * "Recommended for this block" section above the full template list.
+ */
+import type { MarkdownBlockNode } from '../markdown/types.js';
+export interface BlockContentProfile {
+    hasImage: boolean;
+    imageCount: number;
+    hasVideo: boolean;
+    hasBlockquote: boolean;
+    hasList: boolean;
+    hasTable: boolean;
+    hasDate: boolean;
+    hasNumberHighlight: boolean;
+    wordCount: number;
+}
+export interface RecommendationResult {
+    recommended: string[];
+    rest: string[];
+}
+/**
+ * Walk a slice of block nodes and summarize what kinds of content it
+ * contains. Cheap to run — no markdown parsing, just AST traversal.
+ */
+export declare function profileBlockContents(nodes: MarkdownBlockNode[]): BlockContentProfile;
+/**
+ * Split a flat list of template names into a "Recommended" bucket
+ * (matches the active block's content profile) and a "rest" bucket
+ * (everything else). Both buckets preserve the input ordering of
+ * `allNames`, so the visual layout stays predictable as templates are
+ * added.
+ */
+export declare function recommendTemplatesForBlock(profile: BlockContentProfile, allNames: readonly string[]): RecommendationResult;
+//# sourceMappingURL=templates.d.ts.map

package/dist/recommend/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/recommend/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAGV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA0DD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,CAwFpF;AAqED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,oBAAoB,CAStB"}

package/dist/recommend/templates.js

@@ -0,0 +1,235 @@
+/**
+ * Block template recommendations.
+ *
+ * Given a slice of markdown block nodes (the body underneath a heading),
+ * profile the content for image / video / quote / list / table / date /
+ * stat signals, then map that profile to the set of templates that make
+ * sense for the block. Used by the editor's template picker to surface a
+ * "Recommended for this block" section above the full template list.
+ */
+import { extractPlainText, findNodesByType, walkMarkdownTree } from '../markdown/utils.js';
+const EMPTY_PROFILE = Object.freeze({
+    hasImage: false,
+    imageCount: 0,
+    hasVideo: false,
+    hasBlockquote: false,
+    hasList: false,
+    hasTable: false,
+    hasDate: false,
+    hasNumberHighlight: false,
+    wordCount: 0,
+});
+const DATE_PATTERNS = [
+    /\b(January|February|March|April|May|June|July|August|September|October|November|December)\s+(\d{1,2},?\s+)?\d{4}\b/i,
+    /\b\d{1,2}\s+(January|February|March|April|May|June|July|August|September|October|November|December)\s+\d{4}\b/i,
+    /\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Sept|Oct|Nov|Dec)\.?\s+\d{1,2},?\s+\d{4}\b/i,
+    /\b\d{4}-\d{2}-\d{2}\b/,
+    /\b\d{1,2}\/\d{1,2}\/\d{2,4}\b/,
+    /\bQ[1-4]\s+\d{4}\b/,
+    /\b\d{4}s\b/,
+    /\b\d{1,2}(st|nd|rd|th)\s+century\b/i,
+];
+/**
+ * Matches a "highlight number" — a prominent figure suitable for a Stat
+ * Highlight block. Qualifies on any of:
+ *   - currency prefix:   `$2.3M`, `€500`, `¥1,234`
+ *   - unit suffix:       `50%`, `100 years`, `5×`, `2.3M`
+ *   - standalone large:  `1,234`, `5000`, `12,345`
+ * Plain small numbers (`42`) intentionally don't qualify.
+ */
+const NUMBER_HIGHLIGHT_RE = /(?:[$€£¥]\s?\d+(?:[.,]\d+)*(?:\s?(?:[MBK]|million|billion|thousand))?|\d+(?:[.,]\d+)*\s?(?:%|‰|x|×|[MBK]|million|billion|thousand|percent|years?|days?|hours?)|\d{3,}(?:[.,]\d+)*)/i;
+const VIDEO_HOST_RE = /(youtube\.com|youtu\.be|vimeo\.com|wistia\.|loom\.com)/i;
+function htmlElementsByTag(root, tagNames) {
+    const blocks = findNodesByType(root, 'htmlBlock');
+    // Inline HTML (htmlInline) also carries htmlChildren; include both.
+    const inline = findNodesByType(root, 'htmlInline');
+    const out = [];
+    const visit = (n) => {
+        if (n.type === 'htmlElement') {
+            if (tagNames.has(n.tagName.toLowerCase()))
+                out.push(n);
+            for (const c of n.children)
+                visit(c);
+        }
+    };
+    for (const b of blocks)
+        for (const c of b.htmlChildren)
+            visit(c);
+    for (const i of inline) {
+        if (Array.isArray(i.htmlChildren))
+            for (const c of i.htmlChildren)
+                visit(c);
+    }
+    return out;
+}
+/**
+ * Walk a slice of block nodes and summarize what kinds of content it
+ * contains. Cheap to run — no markdown parsing, just AST traversal.
+ */
+export function profileBlockContents(nodes) {
+    if (!nodes || nodes.length === 0)
+        return { ...EMPTY_PROFILE };
+    let imageCount = 0;
+    let hasBlockquote = false;
+    let hasList = false;
+    let hasTable = false;
+    const plainParts = [];
+    for (const node of nodes) {
+        imageCount += findNodesByType(node, 'image').length;
+        imageCount += findNodesByType(node, 'imageReference').length;
+        if (findNodesByType(node, 'blockquote').length > 0)
+            hasBlockquote = true;
+        if (findNodesByType(node, 'list').length > 0)
+            hasList = true;
+        if (findNodesByType(node, 'table').length > 0)
+            hasTable = true;
+        plainParts.push(extractPlainText(node));
+    }
+    // HTML embeds: <img>, <video>, <iframe src=…video host>
+    const root = { type: 'document', children: nodes };
+    const imgTags = htmlElementsByTag(root, new Set(['img']));
+    imageCount += imgTags.length;
+    const videoTags = htmlElementsByTag(root, new Set(['video', 'iframe', 'source']));
+    let hasVideo = false;
+    for (const el of videoTags) {
+        if (el.tagName.toLowerCase() === 'video') {
+            hasVideo = true;
+            break;
+        }
+        const src = el.attributes.src || el.attributes.href || '';
+        if (VIDEO_HOST_RE.test(src)) {
+            hasVideo = true;
+            break;
+        }
+    }
+    // Link-only video embeds (markdown link to a known video host).
+    if (!hasVideo) {
+        const links = findNodesByType(root, 'link');
+        for (const link of links) {
+            if (link.url && VIDEO_HOST_RE.test(link.url)) {
+                hasVideo = true;
+                break;
+            }
+        }
+    }
+    const plainText = plainParts.join(' ').trim();
+    const wordCount = plainText ? plainText.split(/\s+/).length : 0;
+    let hasDate = false;
+    for (const re of DATE_PATTERNS) {
+        if (re.test(plainText)) {
+            hasDate = true;
+            break;
+        }
+    }
+    // Number highlight: a paragraph that's mostly a single prominent figure.
+    let hasNumberHighlight = false;
+    walkMarkdownTree(root, (n) => {
+        if (hasNumberHighlight)
+            return true;
+        if (n.type !== 'paragraph')
+            return;
+        const text = extractPlainText(n).trim();
+        if (!text)
+            return true;
+        const m = text.match(NUMBER_HIGHLIGHT_RE);
+        if (!m)
+            return true;
+        // Paragraph qualifies when its word count is small AND a prominent
+        // number occupies a meaningful chunk of it. Keeps "the company grew
+        // 50% last year" from triggering, but accepts "$2.3M raised".
+        const words = text.split(/\s+/).length;
+        if (words <= 8)
+            hasNumberHighlight = true;
+        return true;
+    });
+    return {
+        hasImage: imageCount > 0,
+        imageCount,
+        hasVideo,
+        hasBlockquote,
+        hasList,
+        hasTable,
+        hasDate,
+        hasNumberHighlight,
+        wordCount,
+    };
+}
+// ── Recommendation rules ───────────────────────────────────────────
+const UNIVERSAL_DEFAULTS = ['title', 'sectionHeader', 'factCard', 'twoColumn'];
+/**
+ * Given a content profile, return the canonical template-name list that
+ * should appear in the "Recommended" bucket. Caller is responsible for
+ * preserving deduplication / ordering when intersecting with the full
+ * template list (see {@link recommendTemplatesForBlock}).
+ */
+function recommendedNamesForProfile(profile) {
+    const names = new Set();
+    let anyContentSignal = false;
+    if (profile.hasImage) {
+        anyContentSignal = true;
+        names.add('imageWithCaption');
+        names.add('leftFeature');
+        names.add('rightFeature');
+        if (profile.imageCount >= 2)
+            names.add('photoGrid');
+    }
+    if (profile.hasVideo) {
+        anyContentSignal = true;
+        names.add('videoWithCaption');
+        if (profile.hasBlockquote)
+            names.add('videoPullQuote');
+    }
+    if (profile.hasBlockquote) {
+        anyContentSignal = true;
+        names.add('quote');
+        names.add('pullQuote');
+        names.add('fullBleedQuote');
+    }
+    if (profile.hasList) {
+        anyContentSignal = true;
+        names.add('list');
+    }
+    if (profile.hasTable) {
+        anyContentSignal = true;
+        names.add('dataTable');
+        names.add('comparisonBar');
+    }
+    if (profile.hasDate) {
+        anyContentSignal = true;
+        names.add('dateEvent');
+    }
+    if (profile.hasNumberHighlight) {
+        anyContentSignal = true;
+        names.add('statHighlight');
+    }
+    if (anyContentSignal) {
+        // Universal pair only — keep recommended focused.
+        names.add('title');
+        names.add('sectionHeader');
+    }
+    else {
+        for (const n of UNIVERSAL_DEFAULTS)
+            names.add(n);
+    }
+    return Array.from(names);
+}
+/**
+ * Split a flat list of template names into a "Recommended" bucket
+ * (matches the active block's content profile) and a "rest" bucket
+ * (everything else). Both buckets preserve the input ordering of
+ * `allNames`, so the visual layout stays predictable as templates are
+ * added.
+ */
+export function recommendTemplatesForBlock(profile, allNames) {
+    const desired = new Set(recommendedNamesForProfile(profile));
+    const recommended = [];
+    const rest = [];
+    for (const name of allNames) {
+        if (desired.has(name))
+            recommended.push(name);
+        else
+            rest.push(name);
+    }
+    return { recommended, rest };
+}
+//# sourceMappingURL=templates.js.map

package/dist/recommend/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/recommend/templates.ts"],"names":[],"mappings":"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"}

package/dist/schemas/BlockTemplates.d.ts

@@ -3,17 +3,17 @@
  *
  * Defines a template system for AI-generated doc blocks. Instead of
  * specifying low-level layers, positions, and animations, AI can use
- * high-level templates like "titleBlock" or "statHighlight" with simple
+ * high-level templates like "title" or "statHighlight" with simple
  * content parameters.
  *
  * Templates are expanded into full Block structures at render time,
  * ensuring consistent styling and reducing AI generation errors.
  *
  * Template Types:
- * - titleBlock: Doc intro with title + subtitle
+ * - title: Doc intro with title + subtitle
  * - sectionHeader: Colored section divider
  * - statHighlight: Big number/stat with description
- * - quoteBlock: Large centered quote
+ * - quote: Large centered quote
  * - factCard: Key fact with explanation
  * - twoColumn: Side-by-side comparison
  * - dateEvent: Timeline-style date + description
@@ -94,7 +94,7 @@ interface BaseTemplateBlock {
  * Title block - doc intro with large title and subtitle.
  */
 export interface TitleBlockInput extends BaseTemplateBlock {
-    template: 'titleBlock';
+    template: 'title';
     /** Main title text */
     title: string;
     /** Subtitle or tagline (supports \n for line breaks) */
@@ -139,7 +139,7 @@ export interface StatHighlightInput extends BaseTemplateBlock {
  * Quote block - large centered quote text.
  */
 export interface QuoteBlockInput extends BaseTemplateBlock {
-    template: 'quoteBlock';
+    template: 'quote';
     /** The quote text (supports \n for line breaks) */
     quote: string;
     /** Attribution (author, source) */
@@ -222,6 +222,44 @@ export interface ImageWithCaptionInput extends BaseTemplateBlock {
     /** License identifier (e.g., 'CC BY-SA 4.0') */
     imageLicense?: string;
 }
+/**
+ * Shared fields for left/right feature blocks. A "feature" pairs an
+ * image on one side of the block with a title and body paragraph on
+ * the other — a common editorial layout for product highlights,
+ * profile callouts, or section intros.
+ */
+interface FeatureInputBase extends BaseTemplateBlock {
+    /** Path to the feature image. */
+    imageSrc: string;
+    /** Alt text for accessibility. */
+    imageAlt?: string;
+    /**
+     * Explicit display width of the image, in pixels (typically pulled
+     * from a `<img width>` attribute when the WYSIWYG editor resized it).
+     * When set, the renderer treats the image as a sized asset and
+     * centers it inside its half with padding instead of stretching it
+     * to fill the cell.
+     */
+    imageWidth?: number;
+    /** Explicit display height of the image, in pixels. */
+    imageHeight?: number;
+    /** Heading / title text shown next to the image. */
+    title?: string;
+    /** Body text shown below the title. */
+    body?: string;
+}
+/**
+ * Left feature — image on the left, title + body stacked on the right.
+ */
+export interface LeftFeatureInput extends FeatureInputBase {
+    template: 'leftFeature';
+}
+/**
+ * Right feature — image on the right, title + body stacked on the left.
+ */
+export interface RightFeatureInput extends FeatureInputBase {
+    template: 'rightFeature';
+}
 /**
  * Map block - geographic map showing article location.
  *
@@ -230,7 +268,7 @@ export interface ImageWithCaptionInput extends BaseTemplateBlock {
  * See docs/MAP_TILES.md for available tile styles and attribution.
  */
 export interface MapBlockInput extends BaseTemplateBlock {
-    template: 'mapBlock';
+    template: 'map';
     /** Map center coordinates */
     center: {
         lat: number;
@@ -267,7 +305,7 @@ export interface FullBleedQuoteInput extends BaseTemplateBlock {
  * Good for enumerations like "things to see" or "key features".
  */
 export interface ListBlockInput extends BaseTemplateBlock {
-    template: 'listBlock';
+    template: 'list';
     /** List items (3-5 recommended) */
     items: string[];
     /** Optional header above the list */
@@ -420,7 +458,7 @@ export interface DataTableInput extends BaseTemplateBlock {
 /**
  * Union of all template block types.
  */
-export type TemplateBlock = TitleBlockInput | SectionHeaderInput | StatHighlightInput | QuoteBlockInput | FactCardInput | TwoColumnInput | DateEventInput | ImageWithCaptionInput | MapBlockInput | FullBleedQuoteInput | ListBlockInput | PhotoGridInput | DefinitionCardInput | ComparisonBarInput | PullQuoteInput | VideoWithCaptionInput | VideoPullQuoteInput | DataTableInput;
+export type TemplateBlock = TitleBlockInput | SectionHeaderInput | StatHighlightInput | QuoteBlockInput | FactCardInput | TwoColumnInput | DateEventInput | ImageWithCaptionInput | LeftFeatureInput | RightFeatureInput | MapBlockInput | FullBleedQuoteInput | ListBlockInput | PhotoGridInput | DefinitionCardInput | ComparisonBarInput | PullQuoteInput | VideoWithCaptionInput | VideoPullQuoteInput | DataTableInput;
 /**
  * A block can be either a raw Block or a TemplateBlock.
  */