Struct HeroShortcode 

pub struct HeroShortcode {
    pub image: Option<Url>,
    pub attrs: String,
    pub classes: String,
    pub overlay: Vec<Block>,
    pub overlay_text: String,
    pub width: Option<String>,
}

Arguments for Shortcode::Hero.

Fields

image: Option<Url>

Image source URL. None if neither the image attribute nor the first body line provided one — the renderer emits a section with no <img> in that case. Flows through resolver before rendering.

attrs: String

Pipe-suffix media attributes verbatim (e.g. “cover top”, “1.5:1 contain”). Empty if no pipe in the source.

classes: String

Extra CSS classes for the wrapping <section> (from {.foo .bar}).

overlay: Vec<Block>

Parsed block content for the overlay. Phase 4 PR4.5 (2026-05-28) promoted this from overlay_markdown: String to overlay: Vec<Block> (fully-typed AST). Nested shortcodes inside the overlay (::::buttons inside :::hero) extract through crate::ast::parser::parse recursion in [crate::ast::shortcode_extract::parse_hero].

overlay_text: String

Plain-text overlay source for downstream OG-fallback extraction.

PR4.5 (2026-05-28): captured at parse time alongside the typed overlay because crate::build::page::meta::extract_description (the homepage-hero rung in the description chain) operates on markdown source — round-tripping Vec<Block> to markdown would invite drift. The renderer uses overlay for HTML; downstream consumers read overlay_text for description-chain extraction.

Empty when the author wrote no overlay body.

TODO(phase4-cleanup): replace with a Vec-walking to_plain_text(blocks: &[Block]) -> String helper in moss-core

• consume overlay directly in meta.rs::extract_description, deleting this field. Carrying both overlay: Vec<Block> AND overlay_text: String makes the AST non-canonical (which is the source of truth?); per cross-SSG research, lossy or duplicate state is Gatsby’s mistake. This is transitional — flag if it survives past PR7a. (Architecture review caveat 2026-05-28.)

width: Option<String>

Spec § P9 width attribute: body | wide | page | screen (with full aliased to screen). None means the author did not set a width — the emitter omits data-width so the HTML stays sparse.

Trait Implementations

impl Clone for HeroShortcode

fn clone(&self) -> HeroShortcode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeroShortcode

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

Formats the value using the given formatter.

impl Default for HeroShortcode

fn default() -> HeroShortcode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HeroShortcode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for HeroShortcode

fn eq(&self, other: &HeroShortcode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for HeroShortcode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for HeroShortcode

impl StructuralPartialEq for HeroShortcode