{
  "grammar": 3,
  "northStar": "Paste Markdown, get a deck. Add one line to make it beautiful. Never see a frame.",
  "mcp": {
    "endpoint": "https://explainplan.ai/mcp",
    "transport": "streamable-http"
  },
  "config": {
    "keys": [
      "accent",
      "align",
      "animate",
      "arrow",
      "audio",
      "background",
      "bg",
      "bgAnimation",
      "bullseye",
      "carry",
      "chrome",
      "color",
      "duck",
      "duration",
      "font",
      "frame",
      "heading",
      "height",
      "kicker",
      "layout",
      "motion",
      "notes",
      "pace",
      "scrim",
      "size",
      "source",
      "spacing",
      "speed",
      "stagger",
      "theme",
      "title",
      "transition",
      "volume",
      "weight",
      "width"
    ],
    "note": "`key: value` lines before the first `#` set deck defaults; under a `#` they set that scene. Unknown keys warn with a did-you-mean suggestion (never silently become slide content). `bgAnimation: <name>` sets a background animation (deck- or scene-level); see backgrounds.animations."
  },
  "defaults": {
    "cascade": "Highest precedence wins: a per-element {…} token → the scene's config (a `key: value` line under its `# heading`) → the deck's config (a `key: value` line before the first `#`) → the built-in default. Set it once at the deck level and every scene/element inherits it until overridden.",
    "scope": {
      "deckAndScene": [
        "theme",
        "bg",
        "background",
        "bgAnimation",
        "color",
        "font",
        "weight",
        "align",
        "motion",
        "speed",
        "duration",
        "stagger",
        "accent"
      ],
      "deckOnly": [
        "size",
        "title",
        "audio",
        "volume",
        "pace",
        "duck",
        "frame",
        "chrome"
      ],
      "sceneOnly": [
        "layout",
        "transition",
        "arrow",
        "notes",
        "carry",
        "kicker",
        "source",
        "heading"
      ],
      "elementToken": [
        "entrance verb (fly|fade|pop|rise|scale|slam|type|draw|none)",
        "from <left|right|top|bottom>",
        "color",
        "size",
        "align",
        "valign",
        "wait",
        "delay <s>",
        "duration <s>",
        "frames <start> <len>",
        "emphasis/loop (e.g. glow, pulse)",
        "zone (col1, center, …)",
        "bg",
        "card",
        "link",
        "id"
      ]
    },
    "values": {
      "entrance": "fly (slides in from the left)",
      "entranceDirection": "left",
      "entranceSpeed": "normal (~0.5s / 15 frames @30fps)",
      "sceneDurationSeconds": "auto-fit to content (base 3s)",
      "transition": "none",
      "theme": "none (built-in dark palette)",
      "background": "#0d1117",
      "textColor": "#f0f6fc",
      "fontSizePx": 48,
      "stagger": "off",
      "bgAnimation": "none",
      "chrome": "none (no global frame/master)"
    },
    "overrides": {
      "entrance": "deck/scene: `motion: fly|fade|pop|rise|scale|slam|type|draw|none` (`motion: none` disables); element: a `{fly}` token plus `{from top|right|bottom|left}` for direction.",
      "entranceSpeed": "deck/scene: `speed: instant|fast|normal|slow` or `speed: 0.8s`; element: `{duration 0.8s}` and/or `{delay 0.3s}`.",
      "theme": "deck: `theme: dark|editorial|midnight|parchment|spectrum|studio`.",
      "background": "deck/scene: `bg: #hex` or `background: <preset>`; animate with `bgAnimation: drift|aurora|bullseye`, optionally with a speed: `bgAnimation: aurora slow` (slow|fast|0.5x|2x).",
      "spacing": "deck/scene: `spacing: tight|normal|loose` (or a number, 1 = default) scales the gap between stacked lines — tighten a loose column stack or open up headline-to-body rhythm.",
      "scrim": "scene (cover with a photo): `scrim: bottom|top|full|none [0-1]` — the darkening behind text on the photo.",
      "bullseye": "scene (bullseye layout): `bullseye: <ring> [<highlight>] [<center>]` colours (#hex or names); tag the first line `{title}` for a straight headline.",
      "textColor": "deck/scene: `color: #hex|$brand|navy`; element: `{color #hex}`.",
      "fontSize": "deck: `size: <px>`; element: `{large}` / `{huge}` / `{size 64}`.",
      "font": "deck/scene: `font: <family>` (multi-word names OK, no quotes — e.g. `font: Dela Gothic One`); element: `{serif}` / `{sans}` / `{mono}`. Bundled: Inter, JetBrains Mono, Caveat, Kalam, Dela Gothic One; any web/system family also works (unknown names fall back). A theme also sets the font.",
      "align": "deck/scene: `align: left|center|right`; element: `{align center}` / `{valign middle}`.",
      "sceneDuration": "scene/deck: `duration: <frames>` — time is FRAMES at 30fps (90 = 3s); omit to auto-fit content. `stagger: <frames>` spaces entrances. Per element, `{delay 0.3s}`/`{duration 0.8s}` are in SECONDS; `{frames <start> <dur>}` pins absolute frames (escape hatch).",
      "transition": "scene: `transition: fade|zoom|slide|merge|…` (see transitions).",
      "stagger": "deck/scene: `stagger: <frames>` to offset successive element entrances.",
      "chrome": "deck: `chrome: editorial` draws a slide master on EVERY scene (accent kicker top-left, deck title top-right, footer source bottom-left, auto page number bottom-right, thin accent progress bar — accent follows the deck accent, else product red). Per scene, set `kicker:` (eyebrow) and `source:` (footer); and SUPPRESS chrome on that slide with a scene-level `chrome: none` (hide the whole frame — e.g. a clean title/cover) or `chrome: no-title no-page` (combinable: no-title · no-page · no-kicker · no-source · no-bar). `chrome: hud` draws the spec-sheet frame instead; deck `none` (default) draws nothing."
    },
    "placement": "Placement tokens attach as a TRAILING {…} block, PER element: `Your text {col1}`. A standalone `{col1}` line places nothing, and a LEADING `{col1}` prefix is not recognized; placement does NOT persist, so in a no-default-zone layout (split, thirds, feature-grid, title-thirds) every element needs its own trailing {zone}. Block regions ({note}, {code}, {chat}, {shapes}, {diagram}, {timeline}) are block-form only: the opener on its own line and {end} on its own line — text on the opener line is ignored (W_INLINE_REGION)."
  },
  "content": [
    {
      "feature": "paragraph",
      "syntax": "Plain line → text element"
    },
    {
      "feature": "list",
      "syntax": "`- item` / `1. item`"
    },
    {
      "feature": "inline",
      "syntax": "`**bold**` `*italic*` `__accent__` `~~strikethrough~~` `` `code` `` (before→after: `~~old~~ **new**`)"
    },
    {
      "feature": "line break",
      "syntax": "`\\n` (or `<br>`) forces a hard line break within a line, for manual wrapping — works in text and region cells (headline/body/quote)"
    },
    {
      "feature": "blockquote",
      "syntax": "`> quoted line` → quote layout"
    },
    {
      "feature": "image/logo",
      "syntax": "`![alt](url)` image · `![alt](github)` logo by name"
    },
    {
      "feature": "qr",
      "syntax": "`![alt](qr:https://…)`"
    },
    {
      "feature": "icon/emoji",
      "syntax": "`:sparkles:` (emoji-first, then Lucide); `:icon:name:` / `:emoji:name:` to force"
    },
    {
      "feature": "code block",
      "syntax": "```lang fenced  or  {code lang}…{end}"
    },
    {
      "feature": "speaker notes",
      "syntax": "{note}…{end}"
    }
  ],
  "tokens": [
    {
      "group": "Size",
      "tokens": [
        "huge",
        "l",
        "large",
        "m",
        "medium",
        "normal",
        "s",
        "small",
        "xl",
        "xxl",
        "size"
      ],
      "note": "bare alias, or `size 64`"
    },
    {
      "group": "Emphasis",
      "tokens": [
        "accent",
        "dim",
        "bold",
        "light",
        "mono",
        "serif",
        "sans"
      ]
    },
    {
      "group": "Editorial",
      "tokens": [
        "pullquote",
        "footnote"
      ],
      "note": "`{pullquote}` = large italic serif with an accent rule on the left (a pull-quote inside any layout); `{footnote}` = a small source/aside line pinned to the slide's bottom edge, outside the layout (alias `{fn}`)."
    },
    {
      "group": "Color",
      "tokens": [
        "color"
      ],
      "note": "`color #hex` · `color $brand` · `color navy` (validated)"
    },
    {
      "group": "Motion",
      "tokens": [
        "cascade",
        "decode",
        "draw",
        "fade",
        "flap",
        "fly",
        "none",
        "pop",
        "rise",
        "scale",
        "slam",
        "type"
      ]
    },
    {
      "group": "Speed",
      "tokens": [
        "fast",
        "instant",
        "normal",
        "slow"
      ]
    },
    {
      "group": "Timing",
      "tokens": [
        "wait",
        "delay",
        "duration",
        "frames"
      ],
      "note": "`{wait}` / `{wait 2s}` step break; `delay 0.3s`; `duration 0.6s`; `frames 34 20` escape hatch"
    },
    {
      "group": "Direction",
      "tokens": [
        "from",
        "bottom",
        "left",
        "right",
        "top"
      ],
      "note": "`from left|right|top|bottom` (for `fly`)"
    },
    {
      "group": "Loop",
      "tokens": [
        "bounce",
        "breathe",
        "float",
        "glow",
        "pulse",
        "shake",
        "swing",
        "wobble"
      ]
    },
    {
      "group": "Placement",
      "tokens": [
        "col1…col9",
        "r1c1",
        "center",
        "top",
        "bottom",
        "left",
        "right"
      ],
      "note": "plus the active layout's named zones; unknown zone → error with suggestion"
    },
    {
      "group": "Align",
      "tokens": [
        "align",
        "valign"
      ],
      "note": "`align left|center|right` · `valign top|middle|bottom`"
    },
    {
      "group": "Media",
      "tokens": [
        "w",
        "width",
        "h",
        "height",
        "wrap",
        "device",
        "volume",
        "pan",
        "kenburns",
        "kb",
        "seed",
        "facing",
        "thickness"
      ],
      "note": "device ∈ {browser|iphone|laptop}. An unsized image fills its zone (the largest it can be); `{small}` or `{medium}` shrink it, `w 300` pins a width. For a bigger photo than a zone allows, use the `cover` layout. Videos autoplay muted and loop; `{volume 0.6}` turns sound on; `{once}` plays through once and holds the last frame."
    },
    {
      "group": "Photo treatment",
      "tokens": [
        "grayscale",
        "greyscale",
        "bw",
        "sepia",
        "blur",
        "vivid",
        "darken",
        "faded"
      ],
      "note": "On image/video lines; stack them (`{grayscale darken}`). bw = high-contrast black & white, faded = washed-out film, vivid = saturated, darken = dimmed for text on top."
    },
    {
      "group": "Misc",
      "tokens": [
        "link",
        "arrow",
        "id",
        "bg",
        "border",
        "card"
      ]
    }
  ],
  "themes": [
    "dark",
    "editorial",
    "midnight",
    "noir",
    "parchment",
    "pastel",
    "playful",
    "poster",
    "spectrum",
    "studio"
  ],
  "themeGuide": [
    {
      "name": "midnight",
      "look": "Near-black ground, light Inter, periwinkle accent (the default palette, chosen deliberately).",
      "bestFor": "Technical talks, dashboards, anything on a dark projector.",
      "font": "'Inter', system-ui, sans-serif"
    },
    {
      "name": "editorial",
      "look": "Cream parchment, Georgia serif, burnt-orange accent — pairs with `chrome: editorial` for a slide master.",
      "bestFor": "Board updates, strategy reviews, reports, anything that should read like a magazine.",
      "font": "'Georgia', 'Times New Roman', serif"
    },
    {
      "name": "studio",
      "look": "Pure white, near-black Inter, blue accent — the clean product-demo look.",
      "bestFor": "Product demos, pitch decks, docs.",
      "font": "'Inter', system-ui, sans-serif"
    },
    {
      "name": "spectrum",
      "look": "Cool light grey, Inter, vivid blue — pairs with the named {color:…} palette on panels/donut.",
      "bestFor": "Research readouts, consumer insights, data-heavy decks.",
      "font": "'Inter', system-ui, sans-serif"
    },
    {
      "name": "playful",
      "look": "Warm cream ground, hand-lettered Caveat, a six-colour party palette.",
      "bestFor": "Kids' parties, celebrations, team socials, classroom, anything that should feel hand-made and fun.",
      "font": "'Caveat', cursive",
      "palette": [
        "#ff6b35",
        "#2ec4b6",
        "#8a4fff",
        "#ffbf47",
        "#ff4d8d",
        "#3dbb5c"
      ]
    },
    {
      "name": "poster",
      "look": "Saturated yellow ground, chunky Dela Gothic display type, loud primaries.",
      "bestFor": "Event posters, townhalls, launches, hype decks, anything that must be read from the back of the room.",
      "font": "'Dela Gothic One', 'Inter', sans-serif",
      "palette": [
        "#ff3d00",
        "#0b0b0b",
        "#1f5fff",
        "#ff2d95",
        "#00b37e",
        "#7a1fff"
      ]
    },
    {
      "name": "pastel",
      "look": "Soft lavender ground, gentle pastel palette, calm Inter.",
      "bestFor": "Wellness, education, onboarding, product tours, portfolios — friendly without being childish.",
      "font": "'Inter', system-ui, sans-serif",
      "palette": [
        "#9b6dff",
        "#5ec8d8",
        "#ff9f80",
        "#8fd18f",
        "#f48fb1",
        "#ffd36e"
      ]
    },
    {
      "name": "noir",
      "look": "True black, white type, a single cinematic red — pairs with bgAnimation: aurora and transition: zoom.",
      "bestFor": "Explainers, documentaries, keynotes, anything cinematic or dramatic.",
      "font": "'Inter', system-ui, sans-serif",
      "palette": [
        "#e50914",
        "#ffc107",
        "#03a9f4",
        "#8bc34a",
        "#ff6f00",
        "#b0bec5"
      ]
    }
  ],
  "styleGuide": [
    {
      "when": "Kids, a party, a celebration, a team social, a classroom — anything that should feel fun and hand-made",
      "use": "theme: playful (+ emoji in headings, `motion: pop`, `transition: zoom`)"
    },
    {
      "when": "An event poster, a townhall, a launch, a hype deck — must read from the back of the room",
      "use": "theme: poster (+ `motion: slam`, few words per slide, `layout: tenet` for the big lines)"
    },
    {
      "when": "Wellness, education, onboarding, a product tour, a portfolio — friendly but grown-up",
      "use": "theme: pastel (+ `motion: rise`, `transition: fade`)"
    },
    {
      "when": "An explainer, a documentary beat, a keynote, anything cinematic or dramatic",
      "use": "theme: noir (+ `bgAnimation: aurora`, `transition: zoom`, `motion: fade`)"
    },
    {
      "when": "A board update, a strategy review, a report — should read like a magazine",
      "use": "theme: editorial + `chrome: editorial` (kicker/source per scene)"
    },
    {
      "when": "A product demo, a pitch deck, documentation",
      "use": "theme: studio (white) or theme: spectrum (light grey, vivid data colours)"
    },
    {
      "when": "A technical talk, a dashboard, a dark projector",
      "use": "theme: midnight — the default palette, but SET IT so the choice is deliberate"
    },
    {
      "when": "A brand colour must show",
      "use": "any theme + `accent: #hex` (deck-level) and `{color:#hex}` on panels/donut/cards rows"
    },
    {
      "when": "A custom look",
      "use": "`bg: #hex|preset` + `font: 'Caveat', cursive` (any bundled font) + `color: #hex` + `accent: #hex`, all before the first `#`"
    }
  ],
  "fonts": {
    "bundled": [
      {
        "name": "Inter",
        "feel": "neutral sans — the default"
      },
      {
        "name": "JetBrains Mono",
        "feel": "monospace — code, labels, meta"
      },
      {
        "name": "Caveat",
        "feel": "hand-lettered marker — playful, personal"
      },
      {
        "name": "Kalam",
        "feel": "handwriting — notes, sketches, classroom"
      },
      {
        "name": "Dela Gothic One",
        "feel": "chunky display — posters, hype, headlines"
      },
      {
        "name": "Georgia",
        "feel": "system serif — editorial, reports"
      }
    ],
    "note": "Set deck-wide with `font: 'Caveat', cursive` before the first `#`, or per scene / per element with `{serif}`/`{mono}`/`{sans}`. Any installed web/system font name also works but only these are guaranteed in rendered stills."
  },
  "backgrounds": {
    "presets": [
      "apple",
      "charcoal",
      "cream",
      "dark",
      "forest",
      "ivory",
      "light",
      "midnight",
      "navy",
      "parchment",
      "slate",
      "warm",
      "white",
      "wine"
    ],
    "animations": [
      "aurora",
      "bullseye",
      "drift",
      "none"
    ]
  },
  "layouts": [
    {
      "name": "bars",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A proportional horizontal bar chart (then/now stages, a rollout ramp, any X-vs-Y). Built from a {bars} region: label | value | note.",
      "maxElements": 8,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "bullets",
      "zones": [
        "title",
        "content"
      ],
      "stability": "stable",
      "bestFor": "A title plus a short bulleted list. The `#` heading renders as the title; `- item` lines are the bullets (the default layout for Markdown lists).",
      "maxElements": 12,
      "densityBudgets": {
        "title": 160,
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "bullseye",
      "zones": [
        "title",
        "media",
        "subtitle"
      ],
      "stability": "stable",
      "bestFor": "A Looney-Tunes end card: a focal image in a disc framed by concentric rings. The first line arcs over the ring as curved text; tag it `{title}` for a straight headline instead. The second line is the caption. Colour it with the scene key `bullseye: <ring> [<highlight>] [<center>]` (#hex or names, e.g. `bullseye: #c62828 #ef9a9a #0d47a1`).",
      "maxElements": 8,
      "densityBudgets": {
        "title": 160,
        "media": 600,
        "subtitle": 240
      },
      "defaultZone": "subtitle"
    },
    {
      "name": "cards",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A row of styled cards (icon + title + body + meta, per-card border/fill/accent, chevron/stair decoration). Built from a {cards} region.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "center",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "One big statement centered on the slide. NOTE: the `# heading` is NOT shown as a separate title here (center has only a full-bleed content zone) — put the words in the body; a heading-only scene shows the heading as its statement instead of rendering blank. Use `title`/`bullets`/`hero` for a titled slide.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "chart",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A trend or time series — revenue by quarter, adoption over months, two metrics side by side on one axis. Built from a {chart} region: `{chart line|area|column X | Series A | Series B}` then `x | value | value` per line; values keep their unit ($, %, k). The last value of each line is labelled directly; `{accent}` on a row calls that point out. For a single comparison of magnitudes use bars; for parts of a whole use donut.",
      "maxElements": 3,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "chat",
      "zones": [
        "conversation"
      ],
      "stability": "stable",
      "bestFor": "A messaging transcript revealed one bubble per click.",
      "maxElements": 24,
      "densityBudgets": {
        "conversation": 2000
      },
      "defaultZone": "conversation"
    },
    {
      "name": "columns",
      "zones": [
        "title",
        "col1",
        "col2",
        "col3",
        "col4",
        "col5",
        "col6"
      ],
      "stability": "stable",
      "bestFor": "Up to six parallel columns of short content. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 24,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600,
        "col3": 600,
        "col4": 500,
        "col5": 500,
        "col6": 500
      },
      "defaultZone": "col1"
    },
    {
      "name": "compare",
      "zones": [
        "title",
        "before",
        "after"
      ],
      "stability": "stable",
      "bestFor": "Before / after, then / now, option A vs B: two halves under the `#` heading split by a centre divider. The first half of your lines goes in the before (left) half, the second half in the after (right) half — or tag lines `{before}` / `{after}`. A half with one photo + a caption line fills with the photo, caption beneath — so `![before](…)` `Before` `![after](…)` `After` is a photo comparison.",
      "maxElements": 8,
      "densityBudgets": {
        "title": 160,
        "before": 600,
        "after": 600
      },
      "defaultZone": "before"
    },
    {
      "name": "cover",
      "zones": [
        "media",
        "content"
      ],
      "stability": "stable",
      "bestFor": "An opening/section cover with a hero image and a line of text.",
      "maxElements": 6,
      "densityBudgets": {
        "media": 600,
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "defcolumns",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "Definition columns — parallel vertical stacks (eyebrow + big headline + body + meta) under hairlines. Built from a {columns} region.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "donut",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A segmented donut (market/audience split) with color-matched callout cards auto-placed around the ring and big center text. Built from a {donut center:“…”} region: label | title | value | quote per segment. The `#` heading is drawn in the ring center unless the opener sets center:“…”; body lines render as a caption under the ring.",
      "maxElements": 8,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "dots",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A unit/dot array (“waffle”) for an X-of-Y quantity. Built from a single-line {dots total:N filled:M} directive. `label` is appended to the auto caption (“184 of 200 <label>”); extra body lines render as a sub-caption under the title.",
      "maxElements": 2,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "easing",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A teaching demo that races one dot per easing curve. The first line (else the heading) is the title; lines naming curves (linear, ease-in, ease-out, ease-in-out, back, spring) choose which rows race, in your order; other lines render as a caption. No curve lines → all six.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "feature-grid",
      "zones": [
        "title",
        "a",
        "b",
        "c",
        "d"
      ],
      "stability": "stable",
      "bestFor": "Four framed feature tiles (2×2) under the `#` heading. Place lines with {a}/{b}/{c}/{d}; the first line in a tile is its bold headline, the next is body copy.",
      "maxElements": 12,
      "densityBudgets": {
        "title": 160,
        "a": 600,
        "b": 600,
        "c": 600,
        "d": 600
      },
      "defaultZone": null
    },
    {
      "name": "grid",
      "zones": [
        "r1c1"
      ],
      "stability": "stable",
      "bestFor": "Equal framed tiles in rows × columns (`layout: grid 2x3`) under the `#` heading — one short line per tile, filled in reading order.",
      "maxElements": 32,
      "densityBudgets": {
        "r1c1": 600
      },
      "defaultZone": "r1c1"
    },
    {
      "name": "hero",
      "zones": [
        "title",
        "media"
      ],
      "stability": "stable",
      "bestFor": "A bold title beside a single supporting image. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 4,
      "densityBudgets": {
        "title": 160,
        "media": 600
      },
      "defaultZone": "title"
    },
    {
      "name": "ledger",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A table with a right-aligned figure column — money, scores, counts (not only finance) — right-aligned figures, hairline rows, and bold ruled total line(s). The auditable cousin of `stats` (pricing, before/after costs, a P&L). Built from a {ledger} region: label | value | note per line, with `{total}` to rule a summary line and `{accent}` to tint a figure. Optional headers via `{ledger Item | Amount}`.",
      "maxElements": 14,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "panels",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A row of boxed accent cards (colored top bar + pill label + headline + body + optional highlighted callout), for a challenge/objective/scope-style comparison. Built from a {panels} region: label | headline | body | callout, with a per-panel {color:blue}/{accent}.",
      "maxElements": 4,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "persona",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "An editorial persona/audience hero card: a diagonally-cut photo, a black corner wedge, a big white name pill with a label chip, a side pull-quote, a bordered note, and a headline — configurable accent color + image. Built from a {persona} region of `key | value` rows (label/name/headline/quote/note/image/color). The `image` row fills the right-hand diagonal panel full-bleed; colours: color, pillColor, wedgeColor, chipColor, nameColor (named or #hex).",
      "maxElements": 2,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "pipeline",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A horizontal process pipeline: a row of stages (artifact label over a dot over an owner caption), joined by a line with an entry arrow, plus an optional dotted feedback loop back to the start. Built from a {pipeline loop:”…”} region: artifact | owner per stage.",
      "maxElements": 10,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "profile",
      "zones": [
        "photo",
        "info",
        "links"
      ],
      "stability": "stable",
      "bestFor": "A person/profile: photo, info, and links.",
      "maxElements": 8,
      "densityBudgets": {
        "photo": 600,
        "info": 500,
        "links": 300
      },
      "defaultZone": "info"
    },
    {
      "name": "quote",
      "zones": [
        "quote",
        "attribution"
      ],
      "stability": "stable",
      "bestFor": "A pull-quote with an attribution.",
      "maxElements": 3,
      "densityBudgets": {
        "quote": 500,
        "attribution": 140
      },
      "defaultZone": "quote"
    },
    {
      "name": "radial",
      "zones": [
        "hub",
        "spoke1",
        "spoke2",
        "spoke3",
        "spoke4",
        "spoke5",
        "spoke6",
        "spoke7",
        "spoke8",
        "spoke9",
        "spoke10",
        "spoke11",
        "spoke12"
      ],
      "stability": "stable",
      "bestFor": "A central hub with spokes radiating out. The first line is the hub, the rest become spoke cards joined by connectors (or place explicitly with `{hub}` / `{spoke1}`…); `arrow: <label>` labels every connector. Logos (`![github]`) make the strongest spokes.",
      "maxElements": 26,
      "densityBudgets": {
        "hub": 200,
        "spoke1": 600,
        "spoke2": 600,
        "spoke3": 600,
        "spoke4": 600,
        "spoke5": 600,
        "spoke6": 600,
        "spoke7": 600,
        "spoke8": 600,
        "spoke9": 600,
        "spoke10": 600,
        "spoke11": 600,
        "spoke12": 600
      },
      "defaultZone": "hub"
    },
    {
      "name": "rows",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "An ordered/labeled row list (label + statement + right meta), hairline-separated. Built from a {rows} or {steps} region. Rows shrink to fit between the title and the footer (slide-master aware); scene_report warns when even the smallest size can't fit. Good for scoreboards of up to ~8 rows.",
      "maxElements": 12,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "showcase",
      "zones": [
        "title",
        "content"
      ],
      "stability": "stable",
      "bestFor": "A big title on the left beside a framed white content panel on the right (title-left / card-right). Put the title in the `# heading`; body lines + an optional image render inside the framed panel. Great with `theme: spectrum`.",
      "maxElements": 8,
      "densityBudgets": {
        "title": 160,
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "sidebar",
      "zones": [
        "sidebar",
        "content"
      ],
      "stability": "stable",
      "bestFor": "A bold rail label beside a main content column: the first line (or {sidebar}) is the rail; the rest stack together, centred, in the content column ({content}).",
      "maxElements": 12,
      "densityBudgets": {
        "sidebar": 500,
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "split",
      "zones": [
        "title",
        "col1",
        "col2"
      ],
      "stability": "stable",
      "bestFor": "Two side-by-side columns. Place content in col1/col2. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 12,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600
      },
      "defaultZone": null
    },
    {
      "name": "split-left",
      "zones": [
        "title",
        "col1",
        "col2"
      ],
      "stability": "stable",
      "bestFor": "Split favouring the left column. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 12,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600
      },
      "defaultZone": "col1"
    },
    {
      "name": "split-right",
      "zones": [
        "title",
        "col1",
        "col2"
      ],
      "stability": "stable",
      "bestFor": "Split favouring the right column. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 12,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600
      },
      "defaultZone": "col1"
    },
    {
      "name": "spotlight",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "One pinned word/phrase in focus over a blurred echo of itself. Tag the focus line {pinned} (else the first line); other lines render as readable support text beneath it; {stream} lines become the blurred wallpaper instead; {caption} is a bottom subtitle.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "stats",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A row of big KPI/stat figures (value + label + sub). Built from a {stats} region. Values auto-fit on one line (”363 ft” is fine); put long units in the label. A body line renders as a sub-caption.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "tenet",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A single principle or tenet stated large. The FIRST body line is the statement, the SECOND (if any) renders ABOVE it as a small uppercase eyebrow, further lines are muted sub-statements — regardless of {dim}/{large} tokens. With no body, the `#` heading is the statement.",
      "maxElements": 6,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "thirds",
      "zones": [
        "col1",
        "col2",
        "col3"
      ],
      "stability": "stable",
      "bestFor": "Three equal columns. Place content in col1/col2/col3.",
      "maxElements": 18,
      "densityBudgets": {
        "col1": 600,
        "col2": 600,
        "col3": 600
      },
      "defaultZone": null
    },
    {
      "name": "timeline",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A growth/milestone curve over time — the `# heading` is the title, the plot sits below. Built from a {timeline} region: position | label | sublabel per point (curve: expo|linear|s|log in the opener). A trailing {accent} highlights a point.",
      "maxElements": 12,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "title",
      "zones": [
        "content"
      ],
      "stability": "stable",
      "bestFor": "A cover/section slide: the `# heading` renders as a big centered title, with content lines beneath as subtitle/attribution (unlike center/tenet, which hide the heading).",
      "maxElements": 4,
      "densityBudgets": {
        "content": 900
      },
      "defaultZone": "content"
    },
    {
      "name": "title-fifths",
      "zones": [
        "title",
        "col1",
        "col2",
        "col3",
        "col4",
        "col5"
      ],
      "stability": "stable",
      "bestFor": "A title over five slim columns. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 32,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600,
        "col3": 600,
        "col4": 500,
        "col5": 500
      },
      "defaultZone": "col1"
    },
    {
      "name": "title-thirds",
      "zones": [
        "title",
        "col1",
        "col2",
        "col3"
      ],
      "stability": "stable",
      "bestFor": "A title over three columns. Place content in col1/col2/col3. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 20,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600,
        "col3": 600
      },
      "defaultZone": null
    },
    {
      "name": "top-bottom",
      "zones": [
        "top",
        "bottom"
      ],
      "stability": "stable",
      "bestFor": "A stacked top/bottom split.",
      "maxElements": 8,
      "densityBudgets": {
        "top": 700,
        "bottom": 700
      },
      "defaultZone": "top"
    },
    {
      "name": "two-column",
      "zones": [
        "title",
        "col1",
        "col2"
      ],
      "stability": "stable",
      "bestFor": "A title over two columns. The `#` heading fills the title zone (set `heading: hide` to suppress it).",
      "maxElements": 16,
      "densityBudgets": {
        "title": 160,
        "col1": 600,
        "col2": 600
      },
      "defaultZone": "col1"
    }
  ],
  "layoutGuide": [
    {
      "when": "One short, bold statement / thesis / takeaway",
      "use": "tenet (or center for a plain centered line; title for a section cover)"
    },
    {
      "when": "A pull-quote with an attribution (optionally a portrait photo → add `![image]`)",
      "use": "quote"
    },
    {
      "when": "2–4 headline numbers / KPIs (value + label + sub)",
      "use": "stats"
    },
    {
      "when": "An ordered list or numbered key points — label + statement + optional right-aligned meta",
      "use": "rows ({rows} with labels, or {steps} to auto-number)"
    },
    {
      "when": "2–6 parallel definitions or a plain side-by-side comparison",
      "use": "defcolumns ({columns})"
    },
    {
      "when": "A challenge/objective/scope-style comparison in BOLD colored boxes",
      "use": "panels ({panels}) — colored card per point"
    },
    {
      "when": "A row of option/step cards, each with a leading icon",
      "use": "cards ({cards}, add connector:chevron for a flow)"
    },
    {
      "when": "A part-to-whole split — audience/market shares that sum to 100% (with %)",
      "use": "donut ({donut})"
    },
    {
      "when": "Proportional magnitudes, a then/now, or a rollout ramp (1%→10%→100%)",
      "use": "bars ({bars})"
    },
    {
      "when": "Before / after, then / now, or option A vs B — two photos or two short columns side by side",
      "use": "compare (`layout: compare`; first half of the lines → before (left), second half → after (right), or tag `{before}`/`{after}`; photo + caption per side)"
    },
    {
      "when": "A trend or time series — a metric over months/quarters, or 2–4 metrics on one axis",
      "use": "chart ({chart line|area|column X | A | B})"
    },
    {
      "when": "An 'X of Y' quantity — e.g. 120 of 384 documents",
      "use": "dots ({dots total:384 filled:120})"
    },
    {
      "when": "A process / pipeline of named stages, optionally with a feedback loop",
      "use": "pipeline ({pipeline loop:\"…\"})"
    },
    {
      "when": "A growth or milestone curve over time (dates/phases)",
      "use": "timeline ({timeline}, curve: expo|linear|s|log)"
    },
    {
      "when": "A persona / audience hero — a photo with a name, headline and quote",
      "use": "persona ({persona})"
    },
    {
      "when": "Line items with amounts and a total (a budget, a price breakdown, a cap table)",
      "use": "ledger ({ledger Item | Amount}, `{total}` on the sum row)"
    },
    {
      "when": "A scoreboard / comparison table: up to ~8 named rows, each with a short result and a status (sites × score × grade, vendors × price × verdict)",
      "use": "rows ({rows} label | statement | meta — rows shrink to fit above the footer; keep statements under ~60 characters) or ledger ({ledger Name | Score} for a right-aligned number column; it is not money-only)"
    },
    {
      "when": "A big title beside a framed content panel (title-left / card-right)",
      "use": "showcase"
    },
    {
      "when": "A messaging / chat transcript revealed one bubble per click",
      "use": "chat ({chat})"
    },
    {
      "when": "Hub-and-spoke relationships radiating from a center",
      "use": "radial"
    },
    {
      "when": "A grid / matrix of cells (rows × cols)",
      "use": "grid (`layout: grid 2x3`, place each with {r1c1})"
    },
    {
      "when": "A title plus a short bulleted list",
      "use": "bullets (`- item` lines)"
    },
    {
      "when": "A hero/section opener with a full-bleed image + a line of text",
      "use": "cover (or hero for image + title)"
    }
  ],
  "transitions": [
    "blur",
    "color-sweep",
    "cover",
    "dissolve-pixel",
    "fade",
    "fold",
    "glitch",
    "iris",
    "magic",
    "merge",
    "none",
    "parallax",
    "push",
    "reveal",
    "shutter",
    "slide",
    "split",
    "whip-pan",
    "wipe",
    "wipe-diagonal",
    "zoom"
  ],
  "motion": {
    "entrances": [
      "cascade",
      "decode",
      "draw",
      "fade",
      "flap",
      "fly",
      "none",
      "pop",
      "rise",
      "scale",
      "slam",
      "type"
    ],
    "entranceNotes": {
      "fly": "slides in from a side (default: from the left; `from right|top|bottom`) — the built-in default entrance",
      "fade": "fades in",
      "rise": "fades in while rising a few pixels — calm, the safe choice for body text",
      "pop": "springs in from small with a slight overshoot — playful",
      "scale": "grows from small, no overshoot",
      "slam": "drops in big and lands hard — headlines, posters, single words",
      "type": "typewriter, character by character with a cursor",
      "draw": "strokes itself in (shapes, diagrams, timelines); on text it behaves like a reveal",
      "cascade": "words fade and rise in one at a time, left to right — good for a tenet or a strong sentence",
      "flap": "airport split-flap board: each character flips through glyphs before settling — numbers, names, departures",
      "decode": "matrix-style scramble that resolves into the text — tech, secrets, reveals",
      "none": "no animation; the element is just there"
    },
    "countUp": "`{countup}` (alias `{count}`) on a text line animates its first number counting up from 0 during the entrance — prefix/suffix, decimals and thousands separators are kept (\"$1,240,000 raised {countup}\").",
    "speeds": [
      "fast",
      "instant",
      "normal",
      "slow"
    ],
    "speedFrames": {
      "instant": 3,
      "fast": 9,
      "normal": 15,
      "slow": 30
    },
    "loops": [
      "bounce",
      "breathe",
      "float",
      "glow",
      "pulse",
      "shake",
      "swing",
      "wobble"
    ]
  },
  "sizes": {
    "text": [
      "huge",
      "l",
      "large",
      "m",
      "medium",
      "normal",
      "s",
      "small",
      "xl",
      "xxl"
    ],
    "media": [
      "l",
      "large",
      "m",
      "medium",
      "s",
      "small",
      "xl",
      "xxl"
    ]
  },
  "emphasis": [
    "breathe",
    "glow",
    "float",
    "wobble",
    "shake",
    "swing",
    "pulse",
    "bounce",
    "none"
  ],
  "icons": {
    "syntax": ":name: — resolves to an emoji shortcode first, else a Lucide icon; if neither, it renders as literal text and validate_script emits a W_UNKNOWN_ICON warning with a suggestion.",
    "resolution": [
      ":name:",
      ":icon:name: (force Lucide)",
      ":emoji:name: (force emoji)"
    ],
    "emojiShortcodeCount": 1587,
    "emojiShortcodes": [
      "+1",
      "-1",
      "100",
      "1234",
      "1st_place_medal",
      "2nd_place_medal",
      "3rd_place_medal",
      "8ball",
      "a",
      "ab",
      "abacus",
      "abc",
      "abcd",
      "accept",
      "adult",
      "aerial_tramway",
      "afghanistan",
      "airplane",
      "aland_islands",
      "alarm_clock",
      "albania",
      "alembic",
      "algeria",
      "alien",
      "ambulance",
      "american_samoa",
      "amphora",
      "anchor",
      "andorra",
      "angel",
      "anger",
      "angola",
      "angry",
      "anguilla",
      "anguished",
      "ant",
      "antarctica",
      "antigua_barbuda",
      "apple",
      "aquarius",
      "argentina",
      "aries",
      "armenia",
      "arrow_backward",
      "arrow_double_down",
      "arrow_double_up",
      "arrow_down",
      "arrow_down_small",
      "arrow_forward",
      "arrow_heading_down",
      "arrow_heading_up",
      "arrow_left",
      "arrow_lower_left",
      "arrow_lower_right",
      "arrow_right",
      "arrow_right_hook",
      "arrow_up",
      "arrow_up_down",
      "arrow_up_small",
      "arrow_upper_left",
      "arrow_upper_right",
      "arrows_clockwise",
      "arrows_counterclockwise",
      "art",
      "articulated_lorry",
      "artificial_satellite",
      "aruba",
      "asterisk",
      "astonished",
      "athletic_shoe",
      "atm",
      "atom_symbol",
      "australia",
      "austria",
      "avocado",
      "azerbaijan",
      "b",
      "baby",
      "baby_bottle",
      "baby_chick",
      "baby_symbol",
      "back",
      "bacon",
      "badger",
      "badminton",
      "bagel",
      "baggage_claim",
      "baguette_bread",
      "bahamas",
      "bahrain",
      "balance_scale",
      "balloon",
      "ballot_box",
      "ballot_box_with_check",
      "bamboo",
      "banana",
      "bangbang",
      "bangladesh",
      "bank",
      "bar_chart",
      "barbados",
      "barber",
      "baseball",
      "basket",
      "basketball",
      "basketball_man",
      "basketball_woman",
      "bat",
      "bath",
      "bathtub",
      "battery",
      "beach_umbrella",
      "bear",
      "bearded_person",
      "bed",
      "beer",
      "beers",
      "beetle",
      "beginner",
      "belarus",
      "belgium",
      "belize",
      "bell",
      "bellhop_bell",
      "benin",
      "bento",
      "bermuda",
      "bhutan",
      "bike",
      "biking_man",
      "biking_woman",
      "bikini",
      "billed_hat",
      "biohazard",
      "bird",
      "birthday",
      "black_circle",
      "black_flag",
      "black_heart",
      "black_joker",
      "black_large_square",
      "black_medium_small_square",
      "black_medium_square",
      "black_nib",
      "black_small_square",
      "black_square_button",
      "blonde_man",
      "blonde_woman",
      "blossom",
      "blowfish",
      "blue_book",
      "blue_car",
      "blue_heart",
      "blush",
      "boar",
      "bolivia",
      "bomb",
      "bone",
      "book",
      "bookmark",
      "bookmark_tabs",
      "books",
      "boom",
      "boot",
      "bosnia_herzegovina",
      "botswana",
      "bouquet",
      "bow_and_arrow",
      "bowing_man",
      "bowing_woman",
      "bowl_with_spoon",
      "bowling",
      "boxing_glove",
      "boy",
      "brain",
      "brazil",
      "bread",
      "breastfeeding",
      "brick",
      "bride_with_veil",
      "bridge_at_night",
      "briefcase",
      "british_indian_ocean_territory",
      "british_virgin_islands",
      "broccoli",
      "broken_heart",
      "broom",
      "brunei",
      "bug",
      "building_construction",
      "bulb",
      "bulgaria",
      "bullettrain_front",
      "bullettrain_side",
      "burkina_faso",
      "burrito",
      "burundi",
      "bus",
      "business_suit_levitating",
      "busstop",
      "bust_in_silhouette",
      "busts_in_silhouette",
      "butterfly",
      "cactus",
      "cake",
      "calendar",
      "call_me_hand",
      "calling",
      "cambodia",
      "camel",
      "camera",
      "camera_flash",
      "cameroon",
      "camping",
      "canada",
      "canary_islands",
      "cancer",
      "candle",
      "candy",
      "canned_food",
      "canoe",
      "cape_verde",
      "capital_abcd",
      "capricorn",
      "car",
      "card_file_box",
      "card_index",
      "card_index_dividers",
      "caribbean_netherlands",
      "carousel_horse",
      "carrot",
      "cat",
      "cat2",
      "cayman_islands",
      "cd",
      "central_african_republic",
      "chad",
      "chains",
      "champagne",
      "chart",
      "chart_down",
      "chart_with_downwards_trend",
      "chart_with_upwards_trend",
      "check",
      "checkered_flag",
      "cheese",
      "cherries",
      "cherry_blossom",
      "chess_pawn",
      "chestnut",
      "chicken",
      "child",
      "children_crossing",
      "chile",
      "chipmunk",
      "chocolate_bar",
      "chopsticks",
      "christmas_island",
      "christmas_tree",
      "church",
      "cinema",
      "circus_tent",
      "city_sunrise",
      "city_sunset",
      "cityscape",
      "cl",
      "clamp",
      "clap",
      "clapper",
      "classical_building",
      "climbing_man",
      "climbing_woman",
      "clinking_glasses",
      "clipboard",
      "clock1",
      "clock10",
      "clock1030",
      "clock11",
      "clock1130",
      "clock12",
      "clock1230",
      "clock130",
      "clock2",
      "clock230",
      "clock3",
      "clock330",
      "clock4",
      "clock430",
      "clock5",
      "clock530",
      "clock6",
      "clock630",
      "clock7",
      "clock730",
      "clock8",
      "clock830",
      "clock9",
      "clock930",
      "closed_book",
      "closed_lock_with_key",
      "closed_umbrella",
      "cloud",
      "cloud_with_lightning",
      "cloud_with_lightning_and_rain",
      "cloud_with_rain",
      "cloud_with_snow",
      "clown_face",
      "clubs",
      "cn",
      "coat",
      "cocktail",
      "coconut",
      "cocos_islands",
      "coffee",
      "coffin",
      "cold",
      "cold_sweat",
      "colombia",
      "comet",
      "comoros",
      "compass",
      "computer",
      "computer_mouse",
      "confetti_ball",
      "confounded",
      "confused",
      "congo_brazzaville",
      "congo_kinshasa",
      "congratulations",
      "construction",
      "construction_worker_man",
      "construction_worker_woman",
      "control_knobs",
      "convenience_store",
      "cook_islands",
      "cookie",
      "cool",
      "copyright",
      "corn",
      "costa_rica",
      "cote_divoire",
      "couch_and_lamp",
      "couple",
      "couple_with_heart_man_man",
      "couple_with_heart_woman_man",
      "couple_with_heart_woman_woman",
      "couplekiss_man_man",
      "couplekiss_man_woman",
      "couplekiss_woman_woman",
      "cow",
      "cow2",
      "cowboy_hat_face",
      "crab",
      "crayon",
      "credit_card",
      "crescent_moon",
      "cricket",
      "croatia",
      "crocodile",
      "croissant",
      "crossed_fingers",
      "crossed_flags",
      "crossed_swords",
      "crown",
      "cry",
      "crying_cat_face",
      "crystal_ball",
      "cuba",
      "cucumber",
      "cup_with_straw",
      "cupcake",
      "cupid",
      "curacao",
      "curling_stone",
      "curly_loop",
      "currency_exchange",
      "curry",
      "custard",
      "customs",
      "cyclone",
      "cyprus",
      "czech_republic",
      "dagger",
      "dancer",
      "dancing_men",
      "dancing_women",
      "dango",
      "dark_sunglasses",
      "dart",
      "dash",
      "date",
      "de",
      "deciduous_tree",
      "deer",
      "denmark",
      "department_store",
      "derelict_house",
      "desert",
      "desert_island",
      "desktop_computer",
      "diamond_shape_with_a_dot_inside",
      "diamonds",
      "disappointed",
      "disappointed_relieved",
      "dizzy",
      "dizzy_face",
      "djibouti",
      "dna",
      "do_not_litter",
      "dog",
      "dog2",
      "dollar",
      "dolls",
      "dolphin",
      "dominica",
      "dominican_republic",
      "door",
      "doughnut",
      "dove",
      "dragon",
      "dragon_face",
      "dress",
      "dromedary_camel",
      "drooling_face",
      "droplet",
      "drum",
      "duck",
      "dumpling",
      "dvd",
      "e-mail",
      "eagle",
      "ear",
      "ear_of_rice",
      "earth",
      "earth_africa",
      "earth_americas",
      "earth_asia",
      "ecuador",
      "egg",
      "eggplant",
      "egypt",
      "eight",
      "eight_pointed_black_star",
      "eight_spoked_asterisk",
      "eject_button",
      "el_salvador",
      "electric_plug",
      "elephant",
      "email",
      "end",
      "england",
      "envelope_with_arrow",
      "equatorial_guinea",
      "eritrea",
      "es",
      "estonia",
      "ethiopia",
      "eu",
      "euro",
      "european_castle",
      "european_post_office",
      "evergreen_tree",
      "exclamation",
      "exploding_head",
      "expressionless",
      "eye",
      "eyeglasses",
      "eyes",
      "face_with_head_bandage",
      "face_with_thermometer",
      "facepunch",
      "factory",
      "falkland_islands",
      "fallen_leaf",
      "family_man_boy",
      "family_man_boy_boy",
      "family_man_girl",
      "family_man_girl_boy",
      "family_man_girl_girl",
      "family_man_man_boy",
      "family_man_man_boy_boy",
      "family_man_man_girl",
      "family_man_man_girl_boy",
      "family_man_man_girl_girl",
      "family_man_woman_boy",
      "family_man_woman_boy_boy",
      "family_man_woman_girl",
      "family_man_woman_girl_boy",
      "family_man_woman_girl_girl",
      "family_woman_boy",
      "family_woman_boy_boy",
      "family_woman_girl",
      "family_woman_girl_boy",
      "family_woman_girl_girl",
      "family_woman_woman_boy",
      "family_woman_woman_boy_boy",
      "family_woman_woman_girl",
      "family_woman_woman_girl_boy",
      "family_woman_woman_girl_girl",
      "faroe_islands",
      "fast_forward",
      "fax",
      "fearful",
      "feather",
      "female_detective",
      "ferris_wheel",
      "ferry",
      "field_hockey",
      "fiji",
      "file_cabinet",
      "file_folder",
      "film_projector",
      "film_strip",
      "finland",
      "fire",
      "fire_engine",
      "fire_extinguisher",
      "firecracker",
      "fireworks",
      "first_quarter_moon",
      "first_quarter_moon_with_face",
      "fish",
      "fish_cake",
      "fishing_pole_and_fish",
      "fist",
      "fist_left",
      "fist_right",
      "five",
      "flag",
      "flags",
      "flashlight",
      "flat_shoe",
      "fleur_de_lis",
      "flight_arrival",
      "flight_departure",
      "floppy_disk",
      "flower_playing_cards",
      "flushed",
      "flying_disc",
      "flying_saucer",
      "fog",
      "foggy",
      "foot",
      "football",
      "footprints",
      "fork_and_knife",
      "fortune_cookie",
      "fountain",
      "fountain_pen",
      "four",
      "four_leaf_clover",
      "fox_face",
      "fr",
      "framed_picture",
      "free",
      "french_guiana",
      "french_polynesia",
      "french_southern_territories",
      "fried_egg",
      "fried_shrimp",
      "fries",
      "frog",
      "frowning",
      "frowning_face",
      "frowning_man",
      "frowning_woman",
      "fu",
      "fuelpump",
      "full_moon",
      "full_moon_with_face",
      "funeral_urn",
      "gabon",
      "gambia",
      "game_die",
      "gear",
      "gem",
      "gemini",
      "georgia",
      "ghana",
      "ghost",
      "gibraltar",
      "gift",
      "gift_heart",
      "giraffe",
      "girl",
      "globe_with_meridians",
      "gloves",
      "goal_net",
      "goat",
      "goggles",
      "golf",
      "golfing_man",
      "golfing_woman",
      "gorilla",
      "grapes",
      "grasshopper",
      "greece",
      "green_apple",
      "green_book",
      "green_heart",
      "green_salad",
      "greenland",
      "grenada",
      "grey_exclamation",
      "grey_question",
      "grimacing",
      "grin",
      "grinning",
      "guadeloupe",
      "guam",
      "guardsman",
      "guardswoman",
      "guatemala",
      "guernsey",
      "guinea",
      "guinea_bissau",
      "guitar",
      "gun",
      "guyana",
      "haircut_man",
      "haircut_woman",
      "haiti",
      "hamburger",
      "hammer",
      "hammer_and_pick",
      "hammer_and_wrench",
      "hamster",
      "hand_over_mouth",
      "handbag",
      "handshake",
      "hash",
      "hatched_chick",
      "hatching_chick",
      "headphones",
      "hear_no_evil",
      "heart",
      "heart_decoration",
      "heart_eyes",
      "heart_eyes_cat",
      "heartbeat",
      "heartpulse",
      "hearts",
      "heavy_check_mark",
      "heavy_division_sign",
      "heavy_dollar_sign",
      "heavy_heart_exclamation",
      "heavy_minus_sign",
      "heavy_multiplication_x",
      "heavy_plus_sign",
      "hedgehog",
      "helicopter",
      "herb",
      "hibiscus",
      "high_brightness",
      "high_heel",
      "hiking_boot",
      "hippopotamus",
      "hocho",
      "hole",
      "honduras",
      "honey_pot",
      "honeybee",
      "hong_kong",
      "horse",
      "horse_racing",
      "hospital",
      "hot",
      "hot_pepper",
      "hotdog",
      "hotel",
      "hotsprings",
      "hourglass",
      "hourglass_flowing_sand",
      "house",
      "house_with_garden",
      "houses",
      "hugs",
      "hundred",
      "hungary",
      "hushed",
      "ice_cream",
      "ice_hockey",
      "ice_skate",
      "icecream",
      "iceland",
      "id",
      "ideograph_advantage",
      "imp",
      "inbox_tray",
      "incoming_envelope",
      "india",
      "indonesia",
      "infinity",
      "information_source",
      "innocent",
      "interrobang",
      "iphone",
      "iran",
      "iraq",
      "ireland",
      "isle_of_man",
      "israel",
      "it",
      "izakaya_lantern",
      "jack_o_lantern",
      "jamaica",
      "japan",
      "japanese_castle",
      "japanese_goblin",
      "japanese_ogre",
      "jeans",
      "jersey",
      "jigsaw",
      "jordan",
      "joy",
      "joy_cat",
      "joystick",
      "jp",
      "kaaba",
      "kangaroo",
      "kazakhstan",
      "kenya",
      "key",
      "keyboard",
      "keycap_ten",
      "kick_scooter",
      "kimono",
      "kiribati",
      "kiss",
      "kissing",
      "kissing_cat",
      "kissing_closed_eyes",
      "kissing_heart",
      "kissing_smiling_eyes",
      "kiwi_fruit",
      "koala",
      "koko",
      "kosovo",
      "kr",
      "kuwait",
      "kyrgyzstan",
      "labcoat",
      "label",
      "lacrosse",
      "laos",
      "large_blue_circle",
      "large_blue_diamond",
      "large_orange_diamond",
      "last_quarter_moon",
      "last_quarter_moon_with_face",
      "latin_cross",
      "latvia",
      "laughing",
      "leafy_greens",
      "leaves",
      "lebanon",
      "ledger",
      "left_luggage",
      "left_right_arrow",
      "left_speech_bubble",
      "leftwards_arrow_with_hook",
      "leg",
      "lemon",
      "leo",
      "leopard",
      "lesotho",
      "level_slider",
      "liberia",
      "libra",
      "libya",
      "liechtenstein",
      "light_rail",
      "link",
      "lion",
      "lips",
      "lipstick",
      "lithuania",
      "lizard",
      "llama",
      "lobster",
      "lock",
      "lock_with_ink_pen",
      "lollipop",
      "loop",
      "lotion_bottle",
      "loud_sound",
      "loudspeaker",
      "love_hotel",
      "love_letter",
      "love_you",
      "low_brightness",
      "luggage",
      "luxembourg",
      "lying_face",
      "m",
      "macau",
      "macedonia",
      "madagascar",
      "mag",
      "mag_right",
      "magnet",
      "mahjong",
      "mailbox",
      "mailbox_closed",
      "mailbox_with_mail",
      "mailbox_with_no_mail",
      "malawi",
      "malaysia",
      "maldives",
      "male_detective",
      "mali",
      "malta",
      "man",
      "man_artist",
      "man_astronaut",
      "man_cartwheeling",
      "man_cook",
      "man_dancing",
      "man_elf",
      "man_facepalming",
      "man_factory_worker",
      "man_fairy",
      "man_farmer",
      "man_firefighter",
      "man_genie",
      "man_health_worker",
      "man_in_lotus_position",
      "man_in_steamy_room",
      "man_in_tuxedo",
      "man_judge",
      "man_juggling",
      "man_mechanic",
      "man_office_worker",
      "man_pilot",
      "man_playing_handball",
      "man_playing_water_polo",
      "man_scientist",
      "man_shrugging",
      "man_singer",
      "man_student",
      "man_superhero",
      "man_supervillain",
      "man_teacher",
      "man_technologist",
      "man_vampire",
      "man_with_gua_pi_mao",
      "man_with_turban",
      "man_zombie",
      "mango",
      "mans_shoe",
      "mantelpiece_clock",
      "maple_leaf",
      "marshall_islands",
      "martial_arts_uniform",
      "martinique",
      "mask",
      "massage_man",
      "massage_woman",
      "mauritania",
      "mauritius",
      "mayotte",
      "meat_on_bone",
      "medal",
      "medal_military",
      "medal_sports",
      "mega",
      "melon",
      "memo",
      "men_wrestling",
      "menorah",
      "mens",
      "mermaid",
      "merman",
      "metal",
      "metro",
      "mexico",
      "microbe",
      "micronesia",
      "microphone",
      "microscope",
      "milk_glass",
      "milky_way",
      "minibus",
      "minidisc",
      "mobile_phone_off",
      "moldova",
      "monaco",
      "money_mouth_face",
      "money_with_wings",
      "moneybag",
      "mongolia",
      "monkey",
      "monkey_face",
      "monocle",
      "monorail",
      "montenegro",
      "montserrat",
      "moon",
      "moon_cake",
      "morocco",
      "mortar_board",
      "mosque",
      "mosquito",
      "motor_boat",
      "motor_scooter",
      "motorcycle",
      "motorway",
      "mount_fuji",
      "mountain",
      "mountain_biking_man",
      "mountain_biking_woman",
      "mountain_cableway",
      "mountain_railway",
      "mountain_snow",
      "mouse",
      "mouse2",
      "movie_camera",
      "moyai",
      "mozambique",
      "mrs_claus",
      "muscle",
      "mushroom",
      "musical_keyboard",
      "musical_note",
      "musical_score",
      "mute",
      "myanmar",
      "nail_care",
      "name_badge",
      "namibia",
      "national_park",
      "nauru",
      "nauseated_face",
      "nazar_amulet",
      "necktie",
      "negative_squared_cross_mark",
      "nepal",
      "nerd",
      "nerd_face",
      "netherlands",
      "neutral_face",
      "new",
      "new_caledonia",
      "new_moon",
      "new_moon_with_face",
      "new_zealand",
      "newspaper",
      "newspaper_roll",
      "next_track_button",
      "ng",
      "nicaragua",
      "niger",
      "nigeria",
      "night_with_stars",
      "nine",
      "niue",
      "no_bell",
      "no_bicycles",
      "no_entry",
      "no_entry_sign",
      "no_good_man",
      "no_good_woman",
      "no_mobile_phones",
      "no_mouth",
      "no_pedestrians",
      "no_smoking",
      "non-potable_water",
      "norfolk_island",
      "north_korea",
      "northern_mariana_islands",
      "norway",
      "nose",
      "notebook",
      "notebook_with_decorative_cover",
      "notes",
      "nut_and_bolt",
      "o",
      "o2",
      "ocean",
      "octopus",
      "oden",
      "office",
      "oil_drum",
      "ok",
      "ok_hand",
      "ok_man",
      "ok_woman",
      "old_key",
      "older_adult",
      "older_man",
      "older_woman",
      "om",
      "oman",
      "on",
      "oncoming_automobile",
      "oncoming_bus",
      "oncoming_police_car",
      "oncoming_taxi",
      "one",
      "open_book",
      "open_file_folder",
      "open_hands",
      "open_mouth",
      "open_umbrella",
      "ophiuchus",
      "orange_book",
      "orange_heart",
      "orthodox_cross",
      "outbox_tray",
      "owl",
      "ox",
      "package",
      "page_facing_up",
      "page_with_curl",
      "pager",
      "paintbrush",
      "pakistan",
      "palau",
      "palestinian_territories",
      "palm_tree",
      "palms_up",
      "panama",
      "pancakes",
      "panda_face",
      "paperclip",
      "paperclips",
      "papua_new_guinea",
      "paraguay",
      "parasol_on_ground",
      "parking",
      "parrot",
      "part_alternation_mark",
      "partly_sunny",
      "partying",
      "passenger_ship",
      "passport_control",
      "pause_button",
      "paw_prints",
      "peace_symbol",
      "peach",
      "peacock",
      "peanuts",
      "pear",
      "pen",
      "pencil",
      "pencil2",
      "penguin",
      "pensive",
      "performing_arts",
      "persevere",
      "person_fencing",
      "peru",
      "petri_dish",
      "philippines",
      "phone",
      "pick",
      "pie",
      "pig",
      "pig2",
      "pig_nose",
      "pill",
      "pineapple",
      "ping_pong",
      "pirate_flag",
      "pisces",
      "pitcairn_islands",
      "pizza",
      "place_of_worship",
      "plate_with_cutlery",
      "play_or_pause_button",
      "pleading",
      "plug",
      "point_down",
      "point_left",
      "point_right",
      "point_up",
      "point_up_2",
      "poland",
      "police_car",
      "policeman",
      "policewoman",
      "poodle",
      "poop",
      "popcorn",
      "portugal",
      "post_office",
      "postal_horn",
      "postbox",
      "potable_water",
      "potato",
      "pouch",
      "poultry_leg",
      "pound",
      "pouting_cat",
      "pouting_man",
      "pouting_woman",
      "pray",
      "prayer_beads",
      "pregnant_woman",
      "pretzel",
      "previous_track_button",
      "prince",
      "princess",
      "printer",
      "puerto_rico",
      "purple_heart",
      "purse",
      "pushpin",
      "put_litter_in_its_place",
      "qatar",
      "question",
      "rabbit",
      "rabbit2",
      "raccoon",
      "racehorse",
      "racing_car",
      "radio",
      "radio_button",
      "radioactive",
      "rage",
      "railway_car",
      "railway_track",
      "rainbow",
      "rainbow_flag",
      "raised_back_of_hand",
      "raised_eyebrow",
      "raised_hand",
      "raised_hand_with_fingers_splayed",
      "raised_hands",
      "raising_hand_man",
      "raising_hand_woman",
      "ram",
      "ramen",
      "rat",
      "receipt",
      "record_button",
      "recycle",
      "red_car",
      "red_circle",
      "red_envelope",
      "registered",
      "relaxed",
      "relieved",
      "reminder_ribbon",
      "repeat",
      "repeat_one",
      "rescue_worker_helmet",
      "restroom",
      "reunion",
      "revolving_hearts",
      "rewind",
      "rhinoceros",
      "ribbon",
      "rice",
      "rice_ball",
      "rice_cracker",
      "rice_scene",
      "right_anger_bubble",
      "ring",
      "ringed_planet",
      "robot",
      "rocket",
      "rofl",
      "roll_eyes",
      "roller_coaster",
      "romania",
      "rooster",
      "rose",
      "rosette",
      "rotating_light",
      "round_pushpin",
      "rowing_man",
      "rowing_woman",
      "ru",
      "rugby_football",
      "running_man",
      "running_shirt_with_sash",
      "running_woman",
      "rwanda",
      "sa",
      "safety_pin",
      "sagittarius",
      "sailboat",
      "sake",
      "salt",
      "samoa",
      "san_marino",
      "sandal",
      "sandwich",
      "santa",
      "sao_tome_principe",
      "satellite",
      "saudi_arabia",
      "sauropod",
      "saxophone",
      "scarf",
      "school",
      "school_satchel",
      "scissors",
      "scorpion",
      "scorpius",
      "scotland",
      "scream",
      "scream_cat",
      "scroll",
      "seat",
      "secret",
      "see_no_evil",
      "seedling",
      "selfie",
      "senegal",
      "serbia",
      "seven",
      "seychelles",
      "shallow_pan_of_food",
      "shamrock",
      "shark",
      "shaved_ice",
      "sheep",
      "shell",
      "shield",
      "shinto_shrine",
      "ship",
      "shopping",
      "shopping_cart",
      "shower",
      "shrimp",
      "shushing",
      "sierra_leone",
      "signal_strength",
      "singapore",
      "sint_maarten",
      "six",
      "six_pointed_star",
      "skateboard",
      "ski",
      "skier",
      "skull",
      "skull_and_crossbones",
      "sled",
      "sleeping",
      "sleeping_bed",
      "sleepy",
      "slightly_frowning_face",
      "slightly_smiling_face",
      "slot_machine",
      "slovakia",
      "slovenia",
      "small_airplane",
      "small_blue_diamond",
      "small_orange_diamond",
      "small_red_triangle",
      "small_red_triangle_down",
      "smile",
      "smile_cat",
      "smiley",
      "smiley_cat",
      "smiling_face_with_three_hearts",
      "smiling_imp",
      "smirk",
      "smirk_cat",
      "smoking",
      "snail",
      "snake",
      "sneezing_face",
      "snowboarder",
      "snowflake",
      "snowman",
      "snowman_with_snow",
      "soap",
      "sob",
      "soccer",
      "socks",
      "softball",
      "solomon_islands",
      "somalia",
      "soon",
      "sorceress",
      "sos",
      "sound",
      "south_africa",
      "south_georgia_south_sandwich_islands",
      "south_sudan",
      "space_invader",
      "spades",
      "spaghetti",
      "sparkle",
      "sparkler",
      "sparkles",
      "sparkling_heart",
      "speak_no_evil",
      "speaker",
      "speaking_head",
      "speech_balloon",
      "speedboat",
      "spider",
      "spider_web",
      "spiral_calendar",
      "spiral_notepad",
      "sponge",
      "spoon",
      "squid",
      "sri_lanka",
      "st_barthelemy",
      "st_helena",
      "st_kitts_nevis",
      "st_lucia",
      "st_pierre_miquelon",
      "st_vincent_grenadines",
      "stadium",
      "star",
      "star2",
      "star_and_crescent",
      "star_of_david",
      "star_struck",
      "stars",
      "station",
      "statue_of_liberty",
      "steak",
      "steam_locomotive",
      "stew",
      "stop_button",
      "stop_sign",
      "stopwatch",
      "straight_ruler",
      "strawberry",
      "stuck_out_tongue",
      "stuck_out_tongue_closed_eyes",
      "stuck_out_tongue_winking_eye",
      "studio_microphone",
      "stuffed_flatbread",
      "sudan",
      "sun",
      "sun_behind_large_cloud",
      "sun_behind_rain_cloud",
      "sun_behind_small_cloud",
      "sun_with_face",
      "sunflower",
      "sunglasses",
      "sunny",
      "sunrise",
      "sunrise_over_mountains",
      "surfing_man",
      "surfing_woman",
      "suriname",
      "sushi",
      "suspension_railway",
      "swan",
      "swaziland",
      "sweat",
      "sweat_drops",
      "sweat_smile",
      "sweden",
      "sweet_potato",
      "swimming_man",
      "swimming_woman",
      "switzerland",
      "symbols",
      "symbols_over_mouth",
      "synagogue",
      "syria",
      "syringe",
      "t-rex",
      "taco",
      "tada",
      "taiwan",
      "tajikistan",
      "takeout_box",
      "tanabata_tree",
      "tangerine",
      "tanzania",
      "taurus",
      "taxi",
      "tea",
      "teddy_bear",
      "telephone_receiver",
      "telescope",
      "tennis",
      "tent",
      "test_tube",
      "thailand",
      "thermometer",
      "thinking",
      "thought_balloon",
      "thread",
      "three",
      "thumbsdown",
      "thumbsup",
      "ticket",
      "tickets",
      "tiger",
      "tiger2",
      "timer_clock",
      "timor_leste",
      "tipping_hand_man",
      "tipping_hand_woman",
      "tired_face",
      "tm",
      "togo",
      "toilet",
      "toilet_paper",
      "tokelau",
      "tokyo_tower",
      "tomato",
      "tonga",
      "tongue",
      "toolbox",
      "tooth",
      "top",
      "tophat",
      "tornado",
      "tr",
      "trackball",
      "tractor",
      "traffic_light",
      "train",
      "train2",
      "tram",
      "triangular_flag_on_post",
      "triangular_ruler",
      "trident",
      "trinidad_tobago",
      "triumph",
      "trolleybus",
      "trophy",
      "tropical_drink",
      "tropical_fish",
      "truck",
      "trumpet",
      "tshirt",
      "tulip",
      "tumbler_glass",
      "tunisia",
      "turkey",
      "turkmenistan",
      "turks_caicos_islands",
      "turtle",
      "tuvalu",
      "tv",
      "twisted_rightwards_arrows",
      "two",
      "two_hearts",
      "two_men_holding_hands",
      "two_women_holding_hands",
      "u5272",
      "u5408",
      "u55b6",
      "u6307",
      "u6708",
      "u6709",
      "u6e80",
      "u7121",
      "u7533",
      "u7981",
      "u7a7a",
      "uganda",
      "uk",
      "ukraine",
      "umbrella",
      "unamused",
      "underage",
      "unicorn",
      "united_arab_emirates",
      "united_nations",
      "unlock",
      "up",
      "upside_down_face",
      "uruguay",
      "us",
      "us_virgin_islands",
      "uzbekistan",
      "v",
      "vanuatu",
      "vatican_city",
      "venezuela",
      "vertical_traffic_light",
      "vhs",
      "vibration_mode",
      "video_camera",
      "video_game",
      "vietnam",
      "violin",
      "virgo",
      "volcano",
      "volleyball",
      "vomiting",
      "vs",
      "vulcan_salute",
      "wales",
      "walking_man",
      "walking_woman",
      "wallis_futuna",
      "waning_crescent_moon",
      "waning_gibbous_moon",
      "warning",
      "wastebasket",
      "watch",
      "water_buffalo",
      "watermelon",
      "wave",
      "wavy_dash",
      "waxing_crescent_moon",
      "waxing_gibbous_moon",
      "wc",
      "weary",
      "wedding",
      "weight_lifting_man",
      "weight_lifting_woman",
      "western_sahara",
      "whale",
      "whale2",
      "wheel_of_dharma",
      "wheelchair",
      "white_check_mark",
      "white_circle",
      "white_flag",
      "white_flower",
      "white_large_square",
      "white_medium_small_square",
      "white_medium_square",
      "white_small_square",
      "white_square_button",
      "wilted_flower",
      "wind_chime",
      "wind_face",
      "wine_glass",
      "wink",
      "wizard",
      "wolf",
      "woman",
      "woman_artist",
      "woman_astronaut",
      "woman_cartwheeling",
      "woman_cook",
      "woman_elf",
      "woman_facepalming",
      "woman_factory_worker",
      "woman_fairy",
      "woman_farmer",
      "woman_firefighter",
      "woman_genie",
      "woman_health_worker",
      "woman_in_lotus_position",
      "woman_in_steamy_room",
      "woman_judge",
      "woman_juggling",
      "woman_mechanic",
      "woman_office_worker",
      "woman_pilot",
      "woman_playing_handball",
      "woman_playing_water_polo",
      "woman_scientist",
      "woman_shrugging",
      "woman_singer",
      "woman_student",
      "woman_superhero",
      "woman_supervillain",
      "woman_teacher",
      "woman_technologist",
      "woman_vampire",
      "woman_with_headscarf",
      "woman_with_turban",
      "woman_zombie",
      "womans_clothes",
      "womans_hat",
      "women_wrestling",
      "womens",
      "woozy",
      "world_map",
      "worried",
      "wrench",
      "writing_hand",
      "x",
      "yarn",
      "yellow_heart",
      "yemen",
      "yen",
      "yin_yang",
      "yum",
      "zambia",
      "zany",
      "zap",
      "zebra",
      "zero",
      "zimbabwe",
      "zipper_mouth_face",
      "zzz"
    ],
    "lucide": "Any Lucide icon name is also accepted (see lucide.dev/icons). A bare :name: prefers an emoji; use :icon:name: to force the Lucide icon."
  },
  "regions": [
    {
      "name": "code",
      "description": "Code block with syntax highlighting",
      "stability": "stable",
      "syntax": "```lang … ``` or {code lang} … {end}"
    },
    {
      "name": "note",
      "description": "Speaker notes (hidden from slides)",
      "stability": "stable",
      "syntax": "{note} … {end}"
    },
    {
      "name": "chat",
      "description": "Chat transcript: `<` lines are incoming (left), `>` lines outgoing (right). At render/present time it reveals one bubble per click (a per-bubble step is added by the layout pass); scene_report models that as step-per-bubble. Each side gets a plain coloured avatar — no initials or names are inferred. There is no speaker-name syntax yet: to label speakers, start the bubble text with the name (`< **Ana:** any blockers?`). The `# heading` is not drawn on chat slides.",
      "stability": "stable",
      "syntax": "{chat} then one line per bubble: `< incoming text` (left) or `> outgoing text` (right).",
      "example": "{chat}\n> Can you make me a deck?\n< Sure — just write it.\n{end}"
    },
    {
      "name": "columns",
      "description": "Definition columns — parallel vertical stacks, each under a top hairline. Sets the `defcolumns` layout; the scene's `# heading` becomes the title. (Distinct from the zone-based `columns` layout, which places free content in col1/col2/…)",
      "stability": "stable",
      "syntax": "{columns} then one column per line: `eyebrow | headline | body | meta` — all fields optional (at least one required), pipe-delimited. A trailing `{accent}` accents that column's headline + rule.",
      "example": "# Three plans, one platform\n{columns}\nStarter | Free | for solo makers | 1 project\nTeam | $20/mo | for small teams | 10 projects\nScale | Custom | for enterprises | unlimited {accent}\n{end}"
    },
    {
      "name": "diagram",
      "description": "Nodes + `->` connectors; draws itself.",
      "stability": "stable",
      "syntax": "{diagram [clean|sketch] [draw|fade|none] [cols] [zone]} then node lines and connector chains `A -> B -> C { from right label \"text\" }`. Refs match nodes by text (auto-created). `clean` = crisp rounded cards that BUILD ALONG THE FLOW (each node appears, its arrows stretch to the next nodes, loops draw last); default `sketch` = hand-drawn. Node line `Eyebrow | Title` adds a small uppercase eyebrow (edges refer to the Title); `{dark}` fills the node as the flow's destination; `{color #hex}` sets the eyebrow colour. Fan-in/fan-out graphs lay out in ranks automatically; a back edge (e.g. `Live -> Comment`) arcs underneath with its label below.",
      "example": "# How a request flows\n{diagram clean}\nYou | Comment\nAgent | Bureau\nGitHub | Pull request\nCheck | Validate\nCheck | Deck lane\nPodium | Live {dark}\nComment -> Bureau -> Pull request\nPull request -> Validate -> Live\nPull request -> Deck lane -> Live\nLive -> Comment { label \"reply posted, thread resolved\" }\n{end}"
    },
    {
      "name": "shapes",
      "description": "Geometry primitives with motion verbs.",
      "stability": "unstable",
      "syntax": "{shapes} then one line per shape: `<circle|square|rect|triangle|ellipse|line|arc|text> { size N color #hex <verb> }`. Verbs: morph <shape>, spin [deg], grow <factor>, orbit, move <left|right|up|down>, fadeout; append `at <s>` / `over <s>` to time the last verb.",
      "example": "{shapes}\ncircle { size 120 color #6366f1 spin over 2s }\n{end}"
    },
    {
      "name": "timeline",
      "description": "Horizontal timeline with curve easing. Labels follow the theme ink and the first/last labels anchor inward so they never clip.",
      "stability": "stable",
      "syntax": "{timeline [draw|fade|none] [expo|linear|s|log] [zone]} then one point per line: `position | label | sublabel?` (pipe-delimited), optional trailing `{ color #hex size N }`.",
      "example": "{timeline}\n2023 | Founded | three people\n2024 | Series A\n2025 | 1M users\n{end}"
    },
    {
      "name": "stats",
      "description": "A row of big KPI figures (value + label + sub). Sets the `stats` layout; the scene's `# heading` becomes the title.",
      "stability": "stable",
      "syntax": "{stats} then one figure per line: `value | label | sub` (label/sub optional, pipe-delimited); a trailing `{accent}` colors that figure.",
      "example": "# The quarter in three numbers\n{stats}\n2.4M | monthly active users | +38% YoY\n99.98% | uptime | last 90 days\n4.1x | faster onboarding | since the redesign {accent}\n{end}"
    },
    {
      "name": "rows",
      "description": "An ordered/labeled row list, hairline-separated. Sets the `rows` layout; the scene's `# heading` becomes the title. Use `{steps}` to auto-number instead of writing a label column.",
      "stability": "stable",
      "syntax": "{rows} (or {steps} to auto-number) then one row per line: `label | statement | meta` — statement required, label/meta optional, pipe-delimited. A single part (no pipes) is just the statement. A trailing `{accent}` colors that row.",
      "example": "# Release checklist\n{rows}\n01 | Cut the release branch | owner: release-eng\n02 | Run the full test suite | ~12 min\n03 | Sign off and tag | lead {accent}\n{end}"
    },
    {
      "name": "dots",
      "description": "A unit/dot array (\"waffle\") for an X-of-Y quantity. Sets the `dots` layout; the scene's `# heading` becomes the title. SINGLE-LINE — no {end}.",
      "stability": "stable",
      "syntax": "A single line: `{dots total:N filled:M cols:C label:\"…\"}`. `total` required; `filled` is the count of accented dots (default = total), `cols` sets dots per row (default auto-square), `label` is an optional caption noun.",
      "example": "# 500 beta testers, week one\n{dots total:500 filled:180 cols:40 label:\"activated\"}"
    },
    {
      "name": "cards",
      "description": "A row of styled cards. Sets the `cards` layout; the scene's `# heading` becomes the title. Subsumes the deck's \"N cards\" slides (4/9/11/14/20/22).",
      "stability": "stable",
      "syntax": "{cards [connector:chevron|arrow] [stair]} then one card per line: `[:icon:] title | body | meta` (body/meta optional). A trailing `{…}` styles that card: `border:dashed|solid|none`, `fill`, `accent`. Opener decorations: `connector:chevron` (or bare `chevron`/`arrow`) draws connectors between cards; `stair` ascends them.",
      "example": "# From idea to launch\n{cards connector:chevron}\n:bulb: Draft | shape the concept | week 1 {border:dashed}\n:hammer: Build | ship the MVP | week 3 {border:solid}\n:rocket: Launch | go to production | week 6 {fill accent}\n{end}"
    },
    {
      "name": "bars",
      "description": "A proportional horizontal bar chart (then/now stages, a rollout ramp, any X-vs-Y). Sets the `bars` layout; the scene's `# heading` becomes the title.",
      "stability": "stable",
      "syntax": "{bars} then one bar per line: `label | value | note` — `value` keeps its display string (80%, 10x, 30,401) and the leading number drives the bar width; `note` optional; a trailing `{accent}` colors that bar red.",
      "example": "# The rollout ramp\n{bars}\nInternal | 1% | dogfood\nBeta | 10%\nHalf | 50%\nEveryone | 100% {accent}\n{end}"
    },
    {
      "name": "panels",
      "description": "A row of boxed accent cards — a colored top bar, a pill label, a headline, body, and an optional highlighted callout. Sets the `panels` layout; the scene's `# heading` becomes the title. For challenge/objective/scope-style side-by-side framing.",
      "stability": "stable",
      "syntax": "{panels} then one panel per line: `label | headline | body | callout` — all optional (at least one required), pipe-delimited. A trailing `{color:<name|#hex>}` sets that panel's accent (top bar + pill + callout tint); `{accent}` uses the product red. Named colors: blue, cyan, teal, green, lime, yellow, orange, red, pink, magenta, purple, violet, slate, gray.",
      "example": "# Why we are redefining our strategy\n{panels}\nChallenge | Growth has stalled | Our old playbook leaned on demographics and existing members. {color:slate}\nObjective | Unlock new motivations | Find where future growth comes from. | Pivot from demographics to human motivations. {color:blue}\nStrategic scope | Consumer audiences for growth | These set our next-chapter priorities — not a retention plan. {color:green}\n{end}"
    },
    {
      "name": "donut",
      "description": "A segmented donut sized by value, with color-matched callout cards auto-placed left/right around the ring (leader lines never cross) and big center text. Sets the `donut` layout. For a market/audience split.",
      "stability": "stable",
      "syntax": "{donut center:\"big center text\"} then one segment per line: `label | title | value | quote` — title + value required; `value` keeps its display (28%) and the leading number sizes the arc; `label` is the small eyebrow, `quote` the supporting line. A trailing `{color:<name|#hex>}` sets the arc color (auto-cycled if unset). Center falls back to the scene `# heading`.",
      "example": "# Our audience\n{donut center:\"6 unique audience groups\"}\nSegment 1 | Go-getters | 28 | I only have to prove things to myself. {color:blue}\nSegment 2 | Me-Timers | 23 | Fitness is my therapy. {color:cyan}\nSegment 3 | Main Characters | 15 | I want props for the work. {color:green}\nSegment 4 | Reluctants | 15 | I work out begrudgingly. {color:orange}\nSegment 5 | Feel Strongs | 10 | It feels good to get stronger. {color:pink}\nSegment 6 | Here for the Vibes | 9 | Fitness like a fun night out. {color:purple}\n{end}"
    },
    {
      "name": "persona",
      "description": "An editorial persona/audience hero card — a diagonally-cut photo, a black corner wedge, a big white name pill with a label chip, a side pull-quote, a bordered note, and a headline. Sets the `persona` layout. The image fills the right-hand diagonal panel full-bleed (else that panel is a darker shade of the field color); the field color defaults to the deck's theme accent. Every text slot and five colours are configurable; all slots optional.",
      "stability": "stable",
      "syntax": "{persona [color:<name|#hex>] [image:<url|path>]} then one `key | value` row per field. Recognized keys: label (chip), name (big pill title), headline (top line), quote (side pull-quote), note (bordered note), image, color (dominant field), pillColor (name-pill bg), wedgeColor (corner wedge), chipColor (label chip bg), nameColor (big name text). All colors take a named palette value or #hex; text on the pill/chip auto-contrasts. color/image may also be set in the opener.",
      "example": "chrome: editorial\n\n# Meet the Vibes crowd\nsource: Photo: Pfc. Trinity Carter, public domain, Wikimedia Commons\n{persona}\nlabel | Audience 6\nname | VIBES\nheadline | Fitness has to be fun to keep me coming back\nquote | If it's boring, I drag through the workout.\nnote | Will try any new class once — and tell friends about the good ones.\nimage | https://thumb.wikimedia.org/wikipedia/commons/thumb/7/76/Ederle_Gym_Spin_Cycle_Class_Photo_2_%286382547%29.jpg/1280px-Ederle_Gym_Spin_Cycle_Class_Photo_2_%286382547%29.jpg\ncolor | #7c5cff\npillColor | #ffffff\nwedgeColor | #0e0e10\nchipColor | #ffbf47\n{end}"
    },
    {
      "name": "pipeline",
      "description": "A horizontal process pipeline — a row of stages (artifact label over a dot over an owner caption), joined by a line with an entry arrow, plus an optional dotted feedback loop from the last stage back to the first. Sets the `pipeline` layout; the `# heading` is the title. Body lines after the region become the caption (first bold, rest dimmed).",
      "stability": "stable",
      "syntax": "{pipeline [loop:\"loop label\"] [legend:\"legend line\"]} then one stage per line: `artifact | owner`. A trailing `{color:<name|#hex>}` sets that dot's color (default = deck accent); `{muted}` greys the dot + dims its caption (e.g. an automated step).",
      "example": "# Let each change carry its own record\n{pipeline loop:\"a problem in production becomes the next intent.md\"}\nintent.md | Product owner\nspec.md | Product owner\nplan.md | Engineer\ndiff + tests | its own checks {muted}\nPR + findings | Code owner\nincident record | Service owner\n{end}\nEach stage leaves one short record. The next stage starts from it."
    },
    {
      "name": "chart",
      "description": "A line, area or grouped-column chart on one y-axis — a time series or trend. Sets the `chart` layout; the `# heading` is the title. Two or more named series get a legend AND a direct label at each line's end. Body lines render as a caption.",
      "stability": "stable",
      "syntax": "{chart [line|area|column] [X | Series A | Series B…]} then one row per line: `x | value | value…`. Default kind is line. Values may carry a unit ($12k, 40%, 1,200) — the first value's prefix/suffix labels the axis; blank or non-numeric cells are gaps. Columns and areas start at zero. A trailing `{accent}` on a row calls out that x (guide line + values on line/area; the accent colour on a single-series column). Keep it to ≤6 series.",
      "example": "# Revenue is pulling away from cost\n{chart line Quarter | Revenue | Cost}\nQ1 | $12k | $9k\nQ2 | $15k | $10k\nQ3 | $21k | $11k {accent}\nQ4 | $28k | $12k\n{end}"
    },
    {
      "name": "ledger",
      "description": "A financial table: line items with right-aligned amounts, an optional note column, hairline rules and a bold total row. Sets the `ledger` layout; the `# heading` is the title. Body lines render as a caption.",
      "stability": "stable",
      "syntax": "{ledger [Header A | Header B]} then one row per line: `label | value | note?`. A trailing `{total}` styles the sum row (rule above, bold); `{accent}` highlights a row in the deck accent.",
      "example": "# Where the $400 goes\n{ledger Item | Cost}\nCake | $120 | bakery\nDecor | $90 | balloons + banners\nActivities | $140 | crafts {accent}\nFood | $50 | pizza\nTotal | $400 | {total}\n{end}"
    }
  ],
  "unstable": [
    "shapes region (on the pre-launch backlog)",
    "character tags [Name]",
    "spotlight ~…~",
    "arrow suffix -->dir",
    "separator ___"
  ],
  "examples": [
    {
      "name": "deck-playful-party",
      "description": "A COMPLETE styled deck: theme: playful (cream + Caveat + party palette), emoji in headings, pop motion, zoom transitions, cards cycling the palette. Start here for anything fun.",
      "script": "title: Milo turns seven\ntheme: playful\nmotion: pop\ntransition: zoom\n\n# Milo turns seven :t-rex: :birthday:\nlayout: title\n\nA dinosaur party for 14 kids, one very excited birthday boy.\nSaturday, June 12 · 2–5 PM · Maplewood\n\n# The party in numbers\n{stats}\n14 | kids invited | ages 6–8\n3 | hours of chaos | 2–5 PM\n1 | birthday boy | very excited {accent}\n{end}\n\n# Party stations :tada:\n{cards connector:chevron}\n:bone: Dig pit | Sandbox fossil hunt | 30 min\n:art: Craft table | Dino masks and tails | all afternoon\n:cake: Cake | T-rex cake, candles | 4 PM {fill accent}\n{end}\n\n# Who's coming\n{donut center:\"24 guests\"}\nSmall humans | Kids | 58% | juice boxes and cake\nBig humans | Grown-ups | 42% | coffee and small talk\n{end}\n\n# Rain plan :cloud_with_rain:\nlayout: split\n\nSunshine {col1, accent}\nBackyard games {col1}\nTreasure hunt {col1}\nIndoors {col2, accent}\nLiving-room obstacle course {col2}\nDino movie + popcorn {col2}\n\n# The rule\nlayout: tenet\n\nEvery kid leaves with a balloon and a fossil.\nMilo's law\n"
    },
    {
      "name": "deck-board-editorial",
      "description": "A COMPLETE corporate deck: theme: editorial + chrome: editorial (kicker + source on every scene), stats, panels, bars with a caption, rows, a closing tenet.",
      "script": "title: Q3 Board Update\ntheme: editorial\nchrome: editorial\nmotion: rise\ntransition: fade\n\n# Q3 board update\nlayout: title\n\nRevenue up, burn down, one decision needed.\nBoard meeting · November 2026\n\n# Q3 headline numbers\nkicker: Results\nsource: Finance · unaudited\n\n{stats}\n$2.4M | revenue | +18% YoY\n78% | gross margin | +2 pts\n14 | months runway | at current burn {accent}\n{end}\n\n# Two bets\nkicker: Decisions\n\n{panels}\nBet 1 | Expand to Europe | London office opens January. | Needs board approval {color:blue}\nBet 2 | Buy, don't build | Acquire the analytics team. | Term sheet ready {color:green}\n{end}\n\n# Burn multiple by quarter\nkicker: Efficiency\n\n{bars}\nQ1 | 3.2 | burn multiple\nQ2 | 2.6 | improving\nQ3 | 1.9 | best yet {accent}\n{end}\nBelow 2.0 for the first time.\n\n# Decisions needed\nkicker: The ask\n\n{rows}\nEurope | Approve the London office | vote today\nHire | Approve the CFO search | this month\nM&A | Approve the term sheet | this week {accent}\n{end}\n\n# The ask\nlayout: tenet\n\nApprove the Europe expansion and the term sheet.\nBoard ask\n"
    },
    {
      "name": "deck-explainer-noir",
      "description": "A COMPLETE cinematic explainer: theme: noir + bgAnimation: aurora + zoom transitions + fade motion, a quote, a timeline, stats, cards, a tenet payoff.",
      "script": "title: How GPS knows where you are\ntheme: noir\nbgAnimation: aurora\nmotion: fade\ntransition: zoom\n\n# How GPS knows where you are :satellite:\nlayout: title\n\nFour satellites, one clock, and a little bit of Einstein.\n\n# The system\n{stats}\n24 | satellites | minimum constellation\n20,200 km | altitude | above Earth\n4 | satellites to fix | your position {accent}\n{end}\n\n# Einstein, inconveniently\nlayout: quote\n\n> GPS would drift by 10 kilometres a day if relativity were ignored.\nNeil Ashby, GPS physicist {attribution}\n\n# The road to a fix\n{timeline curve:s}\n1978 | First launch | Block I satellites\n1995 | Full constellation | 24 birds\n2000 | Selective availability off | civilian accuracy jumps\n2020 | GPS III | metre-level {accent}\n{end}\n\n# What it enables\n{cards}\n:world_map: Maps | Turn-by-turn | everywhere\n:bank: Banking | Timestamped trades | to the microsecond\n:tractor: Farming | Tractor autopilot | centimetre rows {fill accent}\n{end}\n\n# The wonder\nlayout: tenet\n\nYour phone asks the sky what time it is, four times, and triangulates you.\nGPS, in one line\n"
    },
    {
      "name": "deck-townhall-poster",
      "description": "A COMPLETE loud deck: theme: poster (yellow + Dela Gothic), slam headlines, a count-up number, cards, rows, push transitions, a tenet close. For townhalls, launches, hype.",
      "script": "title: Q4 All-Hands\ntheme: poster\nmotion: slam\ntransition: push left\n\n# Q4 ALL-HANDS :loudspeaker:\nlayout: title\n\nThursday · 4 PM · every office + remote\n\n# We shipped\nlayout: center\n\n18 features   {huge countup}\nin one quarter   {l rise}\n\n# Four things to watch\n{cards}\n:mag: Hiring | 12 open roles | eng + design\n:shield: Security | SOC 2 audit | December\n:bulb: Ideas | 40 employee pitches | vote Friday\n:test_tube: Pricing | 3 experiments | results soon\n{end}\n\n# Questions we expect\n{rows}\nHiring | Are we still hiring in Q1? | Berlin\nOffices | Is Lisbon opening? | remote\nAI | What is our AI policy? | eng {accent}\n{end}\n\n# The rule\nlayout: tenet\n\nAsk the question. Someone else is wondering too.\nTownhall rule\n"
    },
    {
      "name": "minimal",
      "description": "Paste Markdown, get a deck. One slide, no directives.",
      "script": "title: Hello\ntheme: midnight\n\n# It just works\n\nWrite Markdown.\n- Bullets become bullets.\n- **Bold** stays bold.\n"
    },
    {
      "name": "styled",
      "description": "Add one `{…}` line to make it beautiful; `{wait}` breaks a build step.",
      "script": "# Before and after\nlayout: split\ntransition: zoom\n\nThe old way.                 {col1, dim}\nThe new way.                 {col2, accent, large}\n\nOne more thing.              {col2, wait, rise}\n"
    },
    {
      "name": "chat",
      "description": "A chat region reveals one bubble per click.",
      "script": "# The conversation\nlayout: chat\n\n{chat}\n> Can you make me a deck?\n< Sure — just write it.\n{end}\n"
    },
    {
      "name": "cover",
      "description": "A section/opening cover: a hero image plus one line.",
      "script": "# Our 2026 roadmap\nlayout: cover\n\n![Common octopus](https://thumb.wikimedia.org/wikipedia/commons/thumb/5/5c/Octopus_vulgaris_03.jpg/1280px-Octopus_vulgaris_03.jpg)\nWhere we're headed next.\n"
    },
    {
      "name": "bullets",
      "description": "A title and a short bulleted list — the default for prose.",
      "script": "# Why it works\nlayout: bullets\n\n- Markdown in, deck out\n- One line to make it beautiful\n- Share a live link\n"
    },
    {
      "name": "split",
      "description": "Two columns, placed explicitly in col1/col2.",
      "script": "# Before and after\nlayout: split\n\nThe old way.   {col1, dim}\nThe new way.   {col2, accent, large}\n"
    },
    {
      "name": "thirds",
      "description": "Three equal columns — place each in col1/col2/col3 (no default zone).",
      "script": "# Three pillars\nlayout: thirds\n\nFast        {col1}\nSimple      {col2}\nShareable   {col3}\n"
    },
    {
      "name": "title-thirds",
      "description": "A title over three columns.",
      "script": "# How it flows\nlayout: title-thirds\n\nAuthor      {col1}\nValidate    {col2}\nDeliver     {col3}\n"
    },
    {
      "name": "quote",
      "description": "A pull-quote with an attribution. The first line is the quote; a following line is the attribution — it renders on its own line with an em-dash prepended automatically (or tag it {attribution}). An optional `![image]` renders as a circular avatar to the left of the quote.",
      "script": "# In their words\nlayout: quote\n\n> The markup is the medium.\nTaq Karim   {attribution}\n"
    },
    {
      "name": "feature-grid",
      "description": "Four feature tiles (2×2) — place each in a/b/c/d (no default zone).",
      "script": "# Four features\nlayout: feature-grid\n\nAuthor     {a}\nValidate   {b}\nInspect    {c}\nDeliver    {d}\n"
    },
    {
      "name": "scene-transition-bg",
      "description": "Per-scene transition, background colour, and a background animation.",
      "script": "# Opener\n\nThe setup.\n\n# The reveal\ntransition: zoom\nbackground: #101826\nbgAnimation: aurora\n\nThe big idea.   {large, accent}\n"
    },
    {
      "name": "stats",
      "description": "A KPI/stat row — big value, label, and sub, from a {stats} region.",
      "script": "# The quarter in three numbers\n{stats}\n2.4M | monthly active users | +38% YoY\n99.98% | uptime | last 90 days\n4.1x | faster onboarding | since the redesign {accent}\n{end}\n"
    },
    {
      "name": "rows",
      "description": "An ordered/labeled row list — `{steps}` auto-numbers; `{rows}` uses a label column; hairline separators.",
      "script": "# Release checklist\n{steps}\nCut the release branch        | owner: release-eng\nRun the full test suite       | ~12 min\nSign off and tag              | lead {accent}\n{end}\n"
    },
    {
      "name": "columns",
      "description": "Definition columns — parallel stacks (eyebrow · big headline · body · meta) under hairlines.",
      "script": "# Three plans, one platform\n{columns}\nStarter | Free | for solo makers | 1 project\nTeam    | $20/mo | for small teams | 10 projects\nScale   | Custom | for enterprises | unlimited {accent}\n{end}\n"
    },
    {
      "name": "dots",
      "description": "A unit/dot array (\"waffle\") for an X-of-Y quantity — single-line, no {end}.",
      "script": "# 500 beta testers, week one\n{dots total:500 filled:180 cols:40 label:\"activated\"}\n"
    },
    {
      "name": "cards",
      "description": "A row of styled cards — per-card border/fill/accent + a leading icon, chevron connectors.",
      "script": "# From idea to launch\n{cards connector:chevron}\n:bulb: Draft | shape the concept | week 1 {border:dashed}\n:hammer: Build | ship the MVP | week 3 {border:solid}\n:rocket: Launch | go to production | week 6 {fill accent}\n{end}\n"
    },
    {
      "name": "editorial-chrome",
      "description": "The editorial slide master: `chrome: editorial` + per-scene kicker/source, drawn on every scene.",
      "script": "title: Q3 Product Review\nchrome: editorial\n\n# The quarter in three numbers\nkicker: Highlights\nsource: Product team · Q3 2026\n\n{stats}\n2.4M | monthly active users | +38% YoY\n99.98% | uptime | last 90 days\n4.1x | faster onboarding | since the redesign {accent}\n{end}\n"
    },
    {
      "name": "bars",
      "description": "A proportional bar chart — then/now stages, a rollout ramp, any X-vs-Y.",
      "script": "# The rollout ramp\n{bars}\nInternal | 1% | dogfood\nBeta | 10%\nHalf | 50%\nEveryone | 100% {accent}\n{end}\n"
    },
    {
      "name": "title",
      "description": "A cover/section slide — the # heading renders big, content lines beneath.",
      "script": "# The quarter in review\nlayout: title\n\nQ3 2026 — what shipped, what's next.\nProduct team\n"
    },
    {
      "name": "text-effects",
      "description": "Text entrance effects beyond fade/rise: `slam` (lands hard), `cascade` (word by word), `flap` (airport split-flap board), `decode` (scramble, then resolve). They only read in motion — present or play the deck to see them.",
      "script": "# Departures\nlayout: center\n\nLISBON 09:40   {flap xl}\nAccess granted   {decode l}\nEvery word lands one at a time.   {cascade l}\nBOARDING   {slam huge accent}\n"
    },
    {
      "name": "countup",
      "description": "`{countup}` (alias `{count}`) makes a line's first number count up from 0 as it enters — prefixes, suffixes, decimals and thousands separators are kept.",
      "script": "# Raised this year\nlayout: center\n\n$1,240,000   {countup huge accent}\nfrom 312 donors   {l}\n"
    },
    {
      "name": "transitions",
      "description": "Per-scene `transition:` — 21 kinds (fade, slide, zoom, blur, wipe, push, cover, reveal, iris, split, shutter, fold, glitch, whip-pan, dissolve-pixel, color-sweep, parallax, merge, magic, none). Directional ones take left|right|top|bottom.",
      "script": "theme: midnight\n\n# One\nlayout: center\n\nThe setup.   {xl}\n\n# Two\nlayout: center\ntransition: push left\n\nThe turn.   {xl}\n\n# Three\nlayout: center\ntransition: glitch\n\nThe payoff.   {xl accent}\n"
    },
    {
      "name": "tenet",
      "description": "One statement, stated large. The FIRST body line is the statement; the SECOND renders above it as a small uppercase eyebrow. The `#` heading is the slide's name, not drawn (with no body, the heading becomes the statement).",
      "script": "# The principle\nlayout: tenet\n\nNobody ever wished for more meetings.\nHouse rule\n"
    },
    {
      "name": "donut",
      "description": "A part-to-whole split: a segmented ring sized by value with color-matched callout cards. `label | title | value | quote` per segment; `center:\"…\"` sets the ring text (else the `#` heading is drawn there).",
      "script": "# Who pays for notes\n{donut center:\"3 segments\"}\nStudents | Free tier | 55% | I just need it to work\nTeams | Pro | 30% | We share everything\nEnterprise | Custom | 15% | Compliance first\n{end}\n"
    },
    {
      "name": "panels",
      "description": "Side-by-side framing in bold boxes: `label | headline | body | callout` per panel, `{color:name|#hex}` per panel. Panels size to their content.",
      "script": "# Two ways to get there\n{panels}\nOption A | Compressed | 4 × 10-hour days, same 40 hours | Longer days hurt parents {color:blue}\nOption B | Reduced | 4 × 8-hour days, same pay | Cut meetings by 40% {color:green}\n{end}\n"
    },
    {
      "name": "pipeline",
      "description": "A process of named stages: `artifact | owner` per stage, `loop:\"…\"` adds a feedback loop from the last stage back to the first, `{muted}` greys an automated step. A sentence after the block becomes the caption.",
      "script": "# How a change ships\n{pipeline loop:\"bug reports feed the backlog\"}\nCommit | engineer\nBuild | CI {muted}\nReview | team\nDeploy | release bot\n{end}\nEvery stage is automated except review.\n"
    },
    {
      "name": "chart",
      "description": "A trend over time: `{chart line|area|column X | Series…}` then `x | value | value` per row. Values keep their unit; the last point of each line is labelled; `{accent}` calls out a row.",
      "script": "# Revenue is pulling away from cost\n{chart line Quarter | Revenue | Cost}\nQ1 | $12k | $9k\nQ2 | $15k | $10k\nQ3 | $21k | $11k {accent}\nQ4 | $28k | $12k\n{end}\n"
    },
    {
      "name": "ledger",
      "description": "Line items with amounts: `{ledger Header | Header}` then `label | value | note` per row; `{total}` styles the sum row, `{accent}` highlights one.",
      "script": "# Where the $400 goes\n{ledger Item | Cost}\nCake | $120 | bakery\nDecor | $90 | balloons + banners\nActivities | $140 | crafts {accent}\nFood | $50 | pizza\nTotal | $400 | {total}\n{end}\n"
    },
    {
      "name": "persona",
      "description": "An audience/persona hero card from `key | value` rows: label, name, headline, quote, note, image, plus five colour knobs — color (the main field; defaults to the theme accent), pillColor (name pill), wedgeColor (corner wedge), chipColor (label chip), nameColor (name text; auto-contrasts if unset). `image` fills the right-hand diagonal panel edge to edge (use a URL from search_images or upload_asset); without one that panel is a darker shade of color.",
      "script": "chrome: editorial\n\n# Meet the Vibes crowd\nsource: Photo: Pfc. Trinity Carter, public domain, Wikimedia Commons\n{persona}\nlabel | Audience 6\nname | VIBES\nheadline | Fitness has to be fun to keep me coming back\nquote | If it's boring, I drag through the workout.\nnote | Will try any new class once — and tell friends about the good ones.\nimage | https://thumb.wikimedia.org/wikipedia/commons/thumb/7/76/Ederle_Gym_Spin_Cycle_Class_Photo_2_%286382547%29.jpg/1280px-Ederle_Gym_Spin_Cycle_Class_Photo_2_%286382547%29.jpg\ncolor | #7c5cff\npillColor | #ffffff\nwedgeColor | #0e0e10\nchipColor | #ffbf47\n{end}\n"
    },
    {
      "name": "showcase",
      "description": "A big title on the left beside a framed content panel on the right. Body lines (and an optional image) go inside the panel.",
      "script": "# Our members look different\nlayout: showcase\n\nMembers skew social and experiential.\nVibes and Feel Strongs are 2–3x overrepresented.\n"
    },
    {
      "name": "radial",
      "description": "Hub and spokes: the first line is the hub and the rest become spoke cards joined by connectors (or place explicitly with `{hub}` / `{spoke1}`…`{spoke12}`). Plain text or logos (`![github]`) both work; `arrow: <label>` labels every connector. The `#` heading is not drawn.",
      "script": "# The agent in the middle\nlayout: radial\narrow: MCP\n\n![claude]   {hub w 220}\n![jira]   {spoke1}\n![github]   {spoke2}\n![slack]   {spoke3}\n![figma]   {spoke4}\n![notion]   {spoke5}\n"
    },
    {
      "name": "grid",
      "description": "A matrix: `layout: grid RxC`, place each cell with `{r<row>c<col>}`.",
      "script": "# Pick two\nlayout: grid 2x2\n\nFast   {r1c1 l}\nCheap   {r1c2 l}\nGood   {r2c1 l}\n…pick two   {r2c2 l accent}\n"
    },
    {
      "name": "themes",
      "description": "`theme:` works per scene too — the same content in four looks. Set it once before the first `#` for a whole deck.",
      "script": "# Playful\ntheme: playful\nlayout: center\n\nHand-lettered and warm :tada:   {xl}\n\n# Poster\ntheme: poster\nlayout: center\n\nLOUD AND CLEAR   {xl}\n\n# Pastel\ntheme: pastel\nlayout: center\n\nSoft and friendly   {xl}\n\n# Noir\ntheme: noir\nlayout: center\n\nLights down.   {xl accent}\n"
    },
    {
      "name": "custom-look",
      "description": "Your own look without a theme: `bg:`, `color:`, `accent:` and `font:` before the first `#`. Bundled fonts: Inter, JetBrains Mono, Caveat, Kalam, Dela Gothic One (Georgia is a system serif).",
      "script": "bg: #0f3d3e\ncolor: #f4f1de\naccent: #e07a5f\nfont: Kalam\n\n# Our own colors\nlayout: center\n\nThe accent follows you   {xl accent}\nand so does the font   {l}\n"
    },
    {
      "name": "picture",
      "description": "A real photo: `![alt](url)`. Images load from two places: the user's ExplainPlan library (Firebase Storage — `upload_asset`, or the editor's Assets panel) and Wikimedia Commons (`search_images`). Other hosts are blocked by the site's security policy and show as a broken image — re-host them with `upload_asset {source_url}` and use the URL it returns. Credit the author + licence with `source:` (drawn with `chrome: editorial`) or a caption line.",
      "script": "chrome: editorial\n\n# The closest thing to aliens on Earth\nlayout: cover\nsource: Photo: H. Zell, CC BY-SA 3.0, Wikimedia Commons\n\n![Common octopus](https://thumb.wikimedia.org/wikipedia/commons/thumb/5/5c/Octopus_vulgaris_03.jpg/1280px-Octopus_vulgaris_03.jpg)\nThree hearts. Blue blood. Nine brains.\n"
    },
    {
      "name": "takeover",
      "description": "A full-bleed, title-free slide: `heading: hide` drops the visible title on any layout (the heading stays the scene's name); `chrome: none` removes the slide master on that scene.",
      "script": "# Interlude\nlayout: cover\nheading: hide\n\n![Common octopus](https://thumb.wikimedia.org/wikipedia/commons/thumb/5/5c/Octopus_vulgaris_03.jpg/1280px-Octopus_vulgaris_03.jpg)\n"
    },
    {
      "name": "motion",
      "description": "Element motion: `{wait}` breaks a build step; entrance + emphasis tokens.",
      "script": "# Build it up\nlayout: center\n\nFirst this.\nThen this.      {wait, rise}\nAnd this.       {wait, rise, accent}\n"
    }
  ]
}
