Enum Block 

pub enum Block {
    Unknown {
        name: String,
        attrs: Attrs,
        content: String,
        span: Span,
    },
    Markdown {
        content: String,
        span: Span,
    },
    Callout {
        callout_type: CalloutType,
        title: Option<String>,
        content: String,
        span: Span,
    },
    Data {
        id: Option<String>,
        format: DataFormat,
        sortable: bool,
        headers: Vec<String>,
        rows: Vec<Vec<String>>,
        raw_content: String,
        span: Span,
    },
    Code {
        lang: Option<String>,
        file: Option<String>,
        highlight: Vec<String>,
        content: String,
        span: Span,
    },
    Tasks {
        items: Vec<TaskItem>,
        span: Span,
    },
    Decision {
        status: DecisionStatus,
        date: Option<String>,
        deciders: Vec<String>,
        content: String,
        span: Span,
    },
    Metric {
        label: String,
        value: String,
        trend: Option<Trend>,
        unit: Option<String>,
        span: Span,
    },
    Summary {
        content: String,
        span: Span,
    },
    Cite {
        reference: Reference,
        span: Span,
    },
    Bibliography {
        style: Option<Format>,
        span: Span,
    },
    Figure {
        src: String,
        caption: Option<String>,
        alt: Option<String>,
        width: Option<String>,
        span: Span,
    },
    Diagram {
        diagram_type: String,
        title: Option<String>,
        content: String,
        span: Span,
    },
    Tabs {
        tabs: Vec<TabPanel>,
        span: Span,
    },
    Columns {
        columns: Vec<ColumnContent>,
        span: Span,
    },
    Quote {
        content: String,
        attribution: Option<String>,
        cite: Option<String>,
        span: Span,
    },
    Cta {
        label: String,
        href: String,
        primary: bool,
        icon: Option<String>,
        span: Span,
    },
    Nav {
        items: Vec<NavItem>,
        logo: Option<String>,
        groups: Vec<NavGroup>,
        brand: Option<String>,
        brand_reg: bool,
        cta: Option<NavItem>,
        drawer: bool,
        minimal: bool,
        span: Span,
    },
    HeroImage {
        src: String,
        alt: Option<String>,
        span: Span,
    },
    Testimonial {
        content: String,
        author: Option<String>,
        role: Option<String>,
        company: Option<String>,
        span: Span,
    },
    Style {
        properties: Vec<StyleProperty>,
        span: Span,
    },
    Faq {
        items: Vec<FaqItem>,
        span: Span,
    },
    PricingTable {
        headers: Vec<String>,
        rows: Vec<Vec<String>>,
        span: Span,
    },
    Site {
        domain: Option<String>,
        properties: Vec<StyleProperty>,
        span: Span,
    },
    Page {
        route: String,
        layout: Option<String>,
        title: Option<String>,
        sidebar: bool,
        content: String,
        children: Vec<Block>,
        span: Span,
    },
    Deck {
        properties: Vec<StyleProperty>,
        span: Span,
    },
    Slide {
        layout: Option<SlideLayout>,
        kicker: Option<String>,
        notes: Option<String>,
        content: String,
        children: Vec<Block>,
        span: Span,
    },
    Embed {
        src: String,
        embed_type: Option<EmbedType>,
        width: Option<String>,
        height: Option<String>,
        title: Option<String>,
        span: Span,
    },
    Form {
        fields: Vec<FormField>,
        submit_label: Option<String>,
        action: Option<String>,
        method: Option<String>,
        honeypot: bool,
        span: Span,
    },
    Banner {
        headline: Option<String>,
        subtitle: Option<String>,
        buttons: Vec<HeroButton>,
        id: Option<String>,
        content: String,
        span: Span,
    },
    ProductGrid {
        groups: Vec<ProductGroup>,
        tiles: bool,
        span: Span,
    },
    PostGrid {
        title: Option<String>,
        subtitle: Option<String>,
        items: Vec<PostItem>,
        span: Span,
    },
    Gate {
        title: Option<String>,
        subtitle: Option<String>,
        action: String,
        field_label: Option<String>,
        submit_label: Option<String>,
        error: Option<String>,
        span: Span,
    },
    Gallery {
        items: Vec<GalleryItem>,
        columns: Option<u32>,
        span: Span,
    },
    Footer {
        sections: Vec<FooterSection>,
        copyright: Option<String>,
        social: Vec<SocialLink>,
        brand: Option<String>,
        brand_reg: bool,
        brand_logo: Option<String>,
        tagline: Option<String>,
        span: Span,
    },
    Details {
        title: Option<String>,
        open: bool,
        content: String,
        span: Span,
    },
    Divider {
        label: Option<String>,
        span: Span,
    },
    Hero {
        headline: Option<String>,
        subtitle: Option<String>,
        badge: Option<String>,
        align: String,
        image: Option<String>,
        image_alt: Option<String>,
        layout: Option<String>,
        transparent: bool,
        buttons: Vec<HeroButton>,
        content: String,
        span: Span,
    },
    Features {
        cards: Vec<FeatureCard>,
        cols: Option<u32>,
        span: Span,
    },
    Steps {
        steps: Vec<StepItem>,
        span: Span,
    },
    Stats {
        items: Vec<StatItem>,
        span: Span,
    },
    Comparison {
        headers: Vec<String>,
        rows: Vec<Vec<String>>,
        highlight: Option<String>,
        span: Span,
    },
    Logo {
        src: String,
        alt: Option<String>,
        size: Option<u32>,
        span: Span,
    },
    Toc {
        depth: u32,
        entries: Vec<TocEntry>,
        span: Span,
    },
    BeforeAfter {
        before_items: Vec<BeforeAfterItem>,
        after_items: Vec<BeforeAfterItem>,
        transition: Option<String>,
        span: Span,
    },
    Pipeline {
        steps: Vec<PipelineStep>,
        span: Span,
    },
    Section {
        bg: Option<String>,
        headline: Option<String>,
        subtitle: Option<String>,
        content: String,
        children: Vec<Block>,
        span: Span,
    },
    ProductCard {
        title: String,
        subtitle: Option<String>,
        badge: Option<String>,
        badge_color: Option<String>,
        body: String,
        features: Vec<String>,
        cta_label: Option<String>,
        cta_href: Option<String>,
        span: Span,
    },
    List {
        source: String,
        display: ListDisplay,
        item_template: String,
        filters: Vec<ListFilter>,
        sort: Option<SortSpec>,
        preload: bool,
        span: Span,
    },
    Board {
        source: String,
        columns: Vec<String>,
        card_template: Option<String>,
        preload: bool,
        span: Span,
    },
    Action {
        method: HttpMethod,
        target: String,
        label: String,
        fields: Vec<FormField>,
        confirm: Option<String>,
        span: Span,
    },
    FilterBar {
        target_selector: String,
        fields: Vec<FilterField>,
        span: Span,
    },
    Search {
        source: String,
        placeholder: Option<String>,
        span: Span,
    },
    Dashboard {
        source: String,
        refresh: Option<u32>,
        span: Span,
    },
    ChatInput {
        action: String,
        placeholder: Option<String>,
        modes: Vec<String>,
        span: Span,
    },
    Feed {
        source: String,
        stream: bool,
        span: Span,
    },
    Store {
        title: Option<String>,
        currency: Option<String>,
        items: Vec<StoreItem>,
        span: Span,
    },
    Booking {
        title: Option<String>,
        service_label: Option<String>,
        services: Vec<BookingService>,
        days: Vec<BookingDay>,
        span: Span,
    },
    Editor {
        source: Option<String>,
        lang: Option<String>,
        preview: bool,
        span: Span,
    },
    Chart {
        chart_type: ChartType,
        source: String,
        period: Option<String>,
        title: Option<String>,
        data: Option<ChartData>,
        span: Span,
    },
    SplitPane {
        ratio: String,
        span: Span,
    },
    App {
        name: String,
        binary: Option<String>,
        region: Option<String>,
        port: Option<u32>,
        platform: Option<String>,
        auth: Option<String>,
        content: String,
        children: Vec<Block>,
        span: Span,
    },
    Build {
        base: Option<String>,
        runtime: Option<String>,
        edition: Option<String>,
        properties: Vec<StyleProperty>,
        span: Span,
    },
    InfraDatabase {
        name: Option<String>,
        shared_auth: bool,
        volume_gb: Option<u32>,
        properties: Vec<StyleProperty>,
        span: Span,
    },
    Deploy {
        env: Option<String>,
        app: Option<String>,
        machines: Option<u32>,
        memory: Option<u32>,
        auto_stop: Option<String>,
        min_machines: Option<u32>,
        strategy: Option<String>,
        properties: Vec<StyleProperty>,
        span: Span,
    },
    InfraEnv {
        tier: Option<String>,
        entries: Vec<EnvEntry>,
        span: Span,
    },
    Health {
        path: Option<String>,
        method: Option<String>,
        grace: Option<String>,
        interval: Option<String>,
        timeout: Option<String>,
        span: Span,
    },
    Concurrency {
        concurrency_type: Option<String>,
        hard_limit: Option<u32>,
        soft_limit: Option<u32>,
        force_https: bool,
        span: Span,
    },
    Cicd {
        provider: Option<String>,
        properties: Vec<StyleProperty>,
        span: Span,
    },
    Smoke {
        script: Option<String>,
        checks: Vec<SmokeCheck>,
        span: Span,
    },
    Domains {
        entries: Vec<DomainEntry>,
        span: Span,
    },
    Crates {
        entries: Vec<CrateEntry>,
        span: Span,
    },
    DeployUrls {
        entries: Vec<StyleProperty>,
        span: Span,
    },
    Volumes {
        entries: Vec<VolumeEntry>,
        span: Span,
    },
    Model {
        name: String,
        fields: Vec<ModelField>,
        span: Span,
    },
    Route {
        method: HttpMethod,
        path: String,
        auth: Option<String>,
        returns: Option<String>,
        body: Option<String>,
        handler: Option<String>,
        content: String,
        span: Span,
    },
    Auth {
        provider: AuthProvider,
        session: Option<String>,
        roles: Vec<String>,
        default_role: Option<String>,
        span: Span,
    },
    Binding {
        source: String,
        target: String,
        events: Vec<BindingEvent>,
        span: Span,
    },
    Schema {
        name: String,
        fields: Vec<SchemaField>,
        span: Span,
    },
    Use {
        crates: Vec<CrateDep>,
        span: Span,
    },
    AppEnv {
        vars: Vec<EnvVar>,
        span: Span,
    },
    AppDeploy {
        region: Option<String>,
        scale: Option<u32>,
        domain: Option<String>,
        memory: Option<String>,
        properties: Vec<(String, String)>,
        span: Span,
    },
    Row {
        icon: String,
        title: String,
        description: String,
        href: Option<String>,
        state: RowState,
        span: Span,
    },
    InfoCard {
        intent: String,
        title: String,
        subtitle: String,
        summary: String,
        image: Option<String>,
        facts: Vec<[String; 2]>,
        steps: Vec<String>,
        state: RowState,
        span: Span,
    },
    AppShell {
        layout: String,
        children: Vec<Block>,
        span: Span,
    },
    Sidebar {
        position: String,
        collapsible: bool,
        width: Option<u32>,
        children: Vec<Block>,
        span: Span,
    },
    Panel {
        position: String,
        resizable: bool,
        height: Option<u32>,
        desktop_only: bool,
        children: Vec<Block>,
        span: Span,
    },
    TabBar {
        active: Option<String>,
        items: Vec<TabBarItem>,
        span: Span,
    },
    TabContent {
        tab: String,
        children: Vec<Block>,
        span: Span,
    },
    Toolbar {
        items: Vec<ToolbarItem>,
        span: Span,
    },
    Drawer {
        name: String,
        position: String,
        width: Option<u32>,
        trigger: Option<String>,
        children: Vec<Block>,
        span: Span,
    },
    Modal {
        name: String,
        title: Option<String>,
        children: Vec<Block>,
        span: Span,
    },
    CommandPalette {
        trigger: Option<String>,
        items: Vec<CommandItem>,
        span: Span,
    },
    CodeEditor {
        lang: Option<String>,
        source: Option<String>,
        line_numbers: bool,
        content: String,
        span: Span,
    },
    BlockEditor {
        source: Option<String>,
        span: Span,
    },
    Terminal {
        shell: Option<String>,
        cwd: Option<String>,
        span: Span,
    },
    NavTree {
        source: Option<String>,
        on_select: Option<String>,
        on_rename: Option<String>,
        on_delete: Option<String>,
        span: Span,
    },
    Badge {
        value: String,
        color: Option<String>,
        span: Span,
    },
    SuggestionChips {
        source: Option<String>,
        max: Option<u32>,
        dismissible: bool,
        span: Span,
    },
    ChatThread {
        source: Option<String>,
        on_action: Option<String>,
        span: Span,
    },
    ChatInputSimple {
        placeholder: Option<String>,
        action: Option<String>,
        span: Span,
    },
    Progress {
        source: Option<String>,
        steps: Vec<ProgressStep>,
        span: Span,
    },
    LogStream {
        source: Option<String>,
        tail: Option<u32>,
        span: Span,
    },
    ProblemList {
        source: Option<String>,
        span: Span,
    },
}

A parsed block in the document body.

Variants

Unknown

A block directive that has not yet been typed (Chunk 1 catch-all).

Fields

name: String

attrs: Attrs

content: String

span: Span

Markdown

Plain markdown content between directives.

Fields

content: String

span: Span

Callout

Callout/admonition box.

Fields

callout_type: CalloutType

title: Option<String>

content: String

span: Span

Data

Structured data table (CSV/JSON/inline rows).

Fields

id: Option<String>

format: DataFormat

sortable: bool

headers: Vec<String>

rows: Vec<Vec<String>>

raw_content: String

span: Span

Code

Code block with optional language and file path.

Fields

lang: Option<String>

file: Option<String>

highlight: Vec<String>

content: String

span: Span

Tasks

Task list with checkbox items.

Fields

items: Vec<TaskItem>

span: Span

Decision

Decision record.

Fields

status: DecisionStatus

date: Option<String>

deciders: Vec<String>

content: String

span: Span

Metric

Single metric display.

Fields

label: String

value: String

trend: Option<Trend>

unit: Option<String>

span: Span

Summary

Executive summary block.

Fields

content: String

span: Span

Cite

A bibliographic reference definition (::cite). Renders nothing on its own; it registers a Reference consumed by inline [@key] citations and the ::bibliography list. See crate::citation.

Fields

reference: Reference

The parsed reference (carries its own key).

span: Span

Bibliography

A rendered reference list (::bibliography / ::references). Collects every ::cite-defined reference and formats them per the active citation style (or the optional per-block style= override).

Fields

style: Option<Format>

Optional style override; defaults to the document’s format: (or APA).

span: Span

Figure

Figure with image source and caption.

Fields

src: String

caption: Option<String>

alt: Option<String>

width: Option<String>

span: Span

Diagram

Native diagram block (::diagram) — architecture diagrams + ERDs. content is the raw DSL source, preserved verbatim for lossless round-trip; unknown diagram_type values degrade to prose at render.

Fields

diagram_type: String

Raw type attr value, lowercased; "" if absent.

title: Option<String>

content: String

span: Span

Tabs

Tabbed content with named panels.

Fields

tabs: Vec<TabPanel>

span: Span

Columns

Multi-column layout.

Fields

columns: Vec<ColumnContent>

span: Span

Quote

Attributed quote with optional source.

Fields

content: String

attribution: Option<String>

cite: Option<String>

span: Span

Cta

Call-to-action button.

Fields

label: String

href: String

primary: bool

icon: Option<String>

span: Span

Nav

Navigation bar with links.

Fields

items: Vec<NavItem>

logo: Option<String>

groups: Vec<NavGroup>

Labelled link groups for the rich-shell drawer (e.g. Explore / Company / Products). Empty for a plain flat nav (the legacy form, which uses items).

brand: Option<String>

Brand wordmark text shown beside the logo (e.g. “CloudSurf”).

brand_reg: bool

Append a ® superscript to the brand wordmark.

cta: Option<NavItem>

Trailing primary call-to-action link (per-page “Get in touch” etc.).

drawer: bool

Opt into the rich shell layout: a JS-driven slide-in drawer + scrim, grouped/iconned links, brand wordmark, and a head-provided theme toggle. When false (and no groups/brand), renders the legacy checkbox-drawer nav so existing consumers are unchanged.

minimal: bool

Render a stripped topbar only: brand/logo + theme toggle, no hamburger, drawer, or scrim. Backward compatible (defaults false).

span: Span

HeroImage

Hero image visual.

Fields

src: String

alt: Option<String>

span: Span

Testimonial

Customer testimonial.

Fields

content: String

author: Option<String>

role: Option<String>

company: Option<String>

span: Span

Style

Presentation style overrides (key-value pairs).

Fields

properties: Vec<StyleProperty>

span: Span

Faq

FAQ accordion with question/answer pairs.

Fields

items: Vec<FaqItem>

span: Span

PricingTable

Pricing comparison table.

Fields

headers: Vec<String>

rows: Vec<Vec<String>>

span: Span

Site

Site-level configuration (one per document).

Fields

domain: Option<String>

properties: Vec<StyleProperty>

span: Span

Page

Page/route definition — container block with child blocks.

Fields

route: String

layout: Option<String>

title: Option<String>

sidebar: bool

content: String

Raw content for degradation renderers.

children: Vec<Block>

Parsed child blocks (leaf directives resolved, rest as Markdown).

span: Span

Deck

Deck-level configuration (one per document) — the ::deck block.

Peer of Block::Site: a leaf config block holding presentation properties (theme, aspect, transition, accent, font). The slides themselves are top-level Block::Slide siblings, exactly as ::page blocks are siblings of ::site.

Fields

properties: Vec<StyleProperty>

span: Span

Slide

A single slide — container block with child blocks.

Peer of Block::Page: its children reuse the existing content block families (Hero/Features/Stats/Comparison/Quote/Code/…), so a slide is an arrangement of blocks that already exist, never a new content primitive.

Fields

layout: Option<SlideLayout>

kicker: Option<String>

notes: Option<String>

content: String

Raw content for degradation renderers.

children: Vec<Block>

span: Span

Embed

Embedded external content (iframe).

Fields

src: String

embed_type: Option<EmbedType>

width: Option<String>

height: Option<String>

title: Option<String>

span: Span

Form

Form with arbitrary fields that submits to the inbox.

Fields

fields: Vec<FormField>

submit_label: Option<String>

action: Option<String>

Form submission target. When Some, the rendered <form> carries a real action/method so it can POST to a server route.

method: Option<String>

HTTP method (post/get). Defaults to post when action is set.

honeypot: bool

Emit a hidden _honey honeypot field for spam mitigation.

span: Span

Banner

Centered call-to-action band: heading + subtext + optional buttons.

Fields

headline: Option<String>

subtitle: Option<String>

buttons: Vec<HeroButton>

id: Option<String>

Optional anchor id for in-page links (e.g. #contact).

content: String

span: Span

ProductGrid

Grid of product link-cards, optionally split into labelled groups.

Fields

groups: Vec<ProductGroup>

tiles: bool

[tiles] — apple.com-style promo tiles (full-bleed 2-up band, centered headline/tagline/CTA over a per-card background) instead of the compact emblem link-cards.

span: Span

PostGrid

Card grid for a blog/news/events index.

Fields

title: Option<String>

subtitle: Option<String>

items: Vec<PostItem>

span: Span

Gate

Access-code card: password field + submit button.

Fields

title: Option<String>

subtitle: Option<String>

action: String

Form POST target. Defaults to “”.

field_label: Option<String>

submit_label: Option<String>

error: Option<String>

span: Span

Gallery

Image gallery with optional categories.

Fields

items: Vec<GalleryItem>

columns: Option<u32>

span: Span

Footer

Structured footer with sections, copyright, and social links.

Fields

sections: Vec<FooterSection>

copyright: Option<String>

social: Vec<SocialLink>

brand: Option<String>

Brand wordmark for the footer brand column (e.g. “CloudSurf”).

brand_reg: bool

Append a ® superscript to the footer brand wordmark.

brand_logo: Option<String>

Logo image src for the footer brand column.

tagline: Option<String>

Tagline under the brand (e.g. “Innovate • Simplify • Scale”).

span: Span

Details

Collapsible content section.

Fields

title: Option<String>

open: bool

content: String

span: Span

Divider

Labeled thematic break.

Fields

label: Option<String>

span: Span

Hero

Full hero section with headline, subtitle, CTA buttons.

Fields

headline: Option<String>

subtitle: Option<String>

badge: Option<String>

align: String

image: Option<String>

image_alt: Option<String>

Alt text for image (accessibility). None → decorative (alt="").

layout: Option<String>

Explicit layout hint: stacked (image above headline). When absent, the legacy align-driven behavior applies (centered → above, left → side).

transparent: bool

Drop the hero’s card background/shadow so it blends into the page (text over the page background instead of a gradient card).

buttons: Vec<HeroButton>

content: String

span: Span

Features

Card grid for features, products, or values.

Fields

cards: Vec<FeatureCard>

cols: Option<u32>

span: Span

Steps

Numbered process/timeline steps.

Fields

steps: Vec<StepItem>

span: Span

Stats

Row of metric/stat cards.

Fields

items: Vec<StatItem>

span: Span

Comparison

Feature comparison matrix with check/dash rendering.

Fields

headers: Vec<String>

rows: Vec<Vec<String>>

highlight: Option<String>

span: Span

Logo

Centered brand/logo display.

Fields

src: String

alt: Option<String>

size: Option<u32>

span: Span

Toc

Auto-generated table of contents from document headings.

Fields

depth: u32

entries: Vec<TocEntry>

span: Span

BeforeAfter

Before/After problem→solution visualization.

Fields

before_items: Vec<BeforeAfterItem>

after_items: Vec<BeforeAfterItem>

transition: Option<String>

span: Span

Pipeline

Horizontal flow pipeline with arrows between steps.

Fields

steps: Vec<PipelineStep>

span: Span

Section

Page section container with background control and child blocks.

Fields

bg: Option<String>

headline: Option<String>

subtitle: Option<String>

content: String

children: Vec<Block>

span: Span

ProductCard

Rich product card with badge, body, features, and CTA.

Fields

title: String

subtitle: Option<String>

badge: Option<String>

badge_color: Option<String>

body: String

features: Vec<String>

cta_label: Option<String>

cta_href: Option<String>

span: Span

List

Dynamic data list with filtering and sorting.

Fields

source: String

display: ListDisplay

item_template: String

filters: Vec<ListFilter>

sort: Option<SortSpec>

preload: bool

span: Span

Board

Kanban board with draggable cards.

Fields

source: String

columns: Vec<String>

card_template: Option<String>

preload: bool

span: Span

Action

CRUD form that submits via HTMX (extends ::form with action).

Fields

method: HttpMethod

target: String

label: String

fields: Vec<FormField>

confirm: Option<String>

span: Span

FilterBar

Filter controls for data views.

Fields

target_selector: String

fields: Vec<FilterField>

span: Span

Search

Search input with typeahead results.

Fields

source: String

placeholder: Option<String>

span: Span

Dashboard

Metrics dashboard with auto-refresh.

Fields

source: String

refresh: Option<u32>

span: Span

ChatInput

Smart-routed chat input.

Fields

action: String

placeholder: Option<String>

modes: Vec<String>

span: Span

Feed

Real-time content feed (SSE or polling).

Fields

source: String

stream: bool

span: Span

Store

Self-contained storefront widget: category-filtered product grid with add-to-cart, a live cart (qty steppers + line totals), and a checkout form that resolves to an order-confirmation card. Static data-bound (no backend; payment links out). Drives the commerce examples (Marketplace, Delivery, Local-service, …).

Fields

title: Option<String>

currency: Option<String>

Currency symbol prefixed to prices (e.g. “$”). Defaults to “$”.

items: Vec<StoreItem>

span: Span

Booking

Self-contained appointment/booking widget: optional service selector + month calendar driven by per-day availability + slot picker + booking confirmation. Static data-bound (no backend); the inlined client script renders the calendar and drives selection → confirmation entirely in the browser. Drives the scheduling examples (Scheduler, Restaurant-reserve, Local-service-book, …).

Fields

title: Option<String>

service_label: Option<String>

Heading shown above the service radios (e.g. “Service”, “Treatment”).

services: Vec<BookingService>

days: Vec<BookingDay>

span: Span

Editor

Code/SurfDoc editor mount point.

Fields

source: Option<String>

lang: Option<String>

preview: bool

span: Span

Chart

Data visualization mount point.

Fields

chart_type: ChartType

source: String

period: Option<String>

title: Option<String>

Optional chart title (from the title= attribute).

data: Option<ChartData>

Inline dataset parsed from the block body. When Some, the chart is rendered as real deterministic SVG; when None it falls back to the source= live-data mount point / static placeholder.

span: Span

SplitPane

Resizable side-by-side layout mount point.

Fields

ratio: String

span: Span

App

Top-level app manifest container (like Page — recursively parses children).

Fields

name: String

binary: Option<String>

region: Option<String>

port: Option<u32>

platform: Option<String>

auth: Option<String>

App-level auth marker from the auth= attribute (e.g. auth=password). Free-form; distinct from the structured child ::auth block.

content: String

children: Vec<Block>

span: Span

Build

Build configuration (base image, runtime, edition).

Fields

base: Option<String>

runtime: Option<String>

edition: Option<String>

properties: Vec<StyleProperty>

span: Span

InfraDatabase

Infrastructure database configuration.

Fields

name: Option<String>

shared_auth: bool

volume_gb: Option<u32>

properties: Vec<StyleProperty>

span: Span

Deploy

Deployment environment configuration.

Fields

env: Option<String>

app: Option<String>

machines: Option<u32>

memory: Option<u32>

auto_stop: Option<String>

min_machines: Option<u32>

strategy: Option<String>

properties: Vec<StyleProperty>

span: Span

InfraEnv

Environment variable group (required/recommended/optional/defaults).

Fields

tier: Option<String>

entries: Vec<EnvEntry>

span: Span

Health

Health check configuration.

Fields

path: Option<String>

method: Option<String>

grace: Option<String>

interval: Option<String>

timeout: Option<String>

span: Span

Concurrency

Concurrency/connection limits.

Fields

concurrency_type: Option<String>

hard_limit: Option<u32>

soft_limit: Option<u32>

force_https: bool

span: Span

Cicd

CI/CD pipeline configuration.

Fields

provider: Option<String>

properties: Vec<StyleProperty>

span: Span

Smoke

Smoke test checks (HTTP method + path + expected status).

Fields

script: Option<String>

checks: Vec<SmokeCheck>

span: Span

Domains

Domain entries for the app.

Fields

entries: Vec<DomainEntry>

span: Span

Crates

Shared crate dependencies.

Fields

entries: Vec<CrateEntry>

span: Span

DeployUrls

Per-environment deploy URLs.

Fields

entries: Vec<StyleProperty>

span: Span

Volumes

Named volume mounts.

Fields

entries: Vec<VolumeEntry>

span: Span

Model

Data model definition with typed fields and constraints.

Fields

name: String

fields: Vec<ModelField>

span: Span

Route

API route/endpoint definition with optional embedded Rust handler.

Fields

method: HttpMethod

path: String

auth: Option<String>

returns: Option<String>

body: Option<String>

handler: Option<String>

content: String

span: Span

Auth

Authentication configuration.

Fields

provider: AuthProvider

session: Option<String>

roles: Vec<String>

default_role: Option<String>

span: Span

Binding

Data-to-UI binding connecting a route/model to a UI block.

Fields

source: String

target: String

events: Vec<BindingEvent>

span: Span

Schema

Data schema definition with typed fields and constraints.

Fields

name: String

fields: Vec<SchemaField>

span: Span

Use

Crate/dependency declarations for an app.

Fields

crates: Vec<CrateDep>

span: Span

AppEnv

App-level environment variable declarations with descriptions.

Fields

vars: Vec<EnvVar>

span: Span

AppDeploy

App-level deployment configuration.

Fields

region: Option<String>

scale: Option<u32>

domain: Option<String>

memory: Option<String>

properties: Vec<(String, String)>

span: Span

Row

A compact row component with icon, title, description, and optional link. Three states: default (content), loading (skeleton), empty (placeholder). ::row[icon=sparkle, href=/wiki/article, state=loading]

Fields

icon: String

title: String

description: String

href: Option<String>

state: RowState

span: Span

InfoCard

A knowledge/info card with title, subtitle, summary, facts, and optional image. ::infocard[intent=who, image=https://...]

Fields

intent: String

title: String

subtitle: String

summary: String

image: Option<String>

facts: Vec<[String; 2]>

steps: Vec<String>

state: RowState

span: Span

AppShell

Root app container with layout mode.

Fields

layout: String

children: Vec<Block>

span: Span

Sidebar

Collapsible side panel.

Fields

position: String

collapsible: bool

width: Option<u32>

children: Vec<Block>

span: Span

Panel

Resizable bottom/side panel.

Fields

position: String

resizable: bool

height: Option<u32>

desktop_only: bool

children: Vec<Block>

span: Span

TabBar

Tab strip navigation.

Fields

active: Option<String>

items: Vec<TabBarItem>

span: Span

TabContent

Tab-associated content pane.

Fields

tab: String

children: Vec<Block>

span: Span

Toolbar

Horizontal toolbar with buttons, separators, badges, etc.

Fields

items: Vec<ToolbarItem>

span: Span

Drawer

Slide-out drawer panel.

Fields

name: String

position: String

width: Option<u32>

trigger: Option<String>

children: Vec<Block>

span: Span

Modal

Dialog overlay.

Fields

name: String

title: Option<String>

children: Vec<Block>

span: Span

CommandPalette

Searchable command picker.

Fields

trigger: Option<String>

items: Vec<CommandItem>

span: Span

CodeEditor

Syntax-highlighted code editor.

Fields

lang: Option<String>

source: Option<String>

line_numbers: bool

content: String

span: Span

BlockEditor

Visual block editor mount point.

Fields

source: Option<String>

span: Span

Terminal

Shell/terminal panel.

Fields

shell: Option<String>

cwd: Option<String>

span: Span

NavTree

File/navigation tree.

Fields

source: Option<String>

on_select: Option<String>

on_rename: Option<String>

on_delete: Option<String>

span: Span

Badge

Status badge pill.

Fields

value: String

color: Option<String>

span: Span

SuggestionChips

Clickable suggestion chips.

Fields

source: Option<String>

max: Option<u32>

dismissible: bool

span: Span

ChatThread

Chat conversation thread display.

Fields

source: Option<String>

on_action: Option<String>

span: Span

ChatInputSimple

Simple chat message input (distinct from app-bound ChatInput).

Fields

placeholder: Option<String>

action: Option<String>

span: Span

Progress

Step/progress indicator.

Fields

source: Option<String>

steps: Vec<ProgressStep>

span: Span

LogStream

Live log output stream.

Fields

source: Option<String>

tail: Option<u32>

span: Span

ProblemList

Error/warning problem list.

Fields

source: Option<String>

span: Span

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Block

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Block

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Block

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.