maud-extensions-macros 0.6.7

// Semantic component model built from the user's struct declaration.
use syn::{Data, DataStruct, Fields, GenericParam, Generics, Ident, Result, spanned::Spanned};

use crate::component::field::ComponentField;
use crate::component::input::Input;

pub(crate) struct Component {
    pub(crate) name: Ident,
    pub(crate) generics: Generics,
    pub(crate) fields: Vec<ComponentField>,
}

impl Component {
    pub(crate) fn from_input(input: Input) -> Result<Self> {
        let data = match input.data {
            Data::Struct(data) => data,
            _ => {
                return Err(syn::Error::new(
                    input.ident.span(),
                    "component-only-structs",
                ));
            }
        };

        let fields = parse_fields(&input.ident, data)?;
        ensure_at_most_one_default_slot(&fields)?;
        ensure_default_slot_disambiguated(&fields)?;
        ensure_no_const_generics(&input.generics)?;

        Ok(Self {
            name: input.ident,
            generics: input.generics,
            fields,
        })
    }

    pub(crate) fn default_slot(&self) -> Option<&ComponentField> {
        self.fields
            .iter()
            .find(|field| field.slot().is_some_and(|slot| slot.default))
    }

    pub(crate) fn named_slots(&self) -> impl Iterator<Item = &ComponentField> {
        let default_slot_name = self.default_slot().map(|field| &field.name);

        self.fields
            .iter()
            .filter(move |field| field.is_slot() && Some(&field.name) != default_slot_name)
    }
}

fn parse_fields(component_name: &Ident, data: DataStruct) -> Result<Vec<ComponentField>> {
    let named = match data.fields {
        Fields::Named(named) => named,
        Fields::Unnamed(_) | Fields::Unit => {
            return Err(syn::Error::new(
                component_name.span(),
                "component-only-named-fields",
            ));
        }
    };

    named
        .named
        .into_iter()
        .map(ComponentField::from_syn)
        .collect()
}

fn ensure_at_most_one_default_slot(fields: &[ComponentField]) -> Result<()> {
    let mut default_slot_name: Option<&Ident> = None;

    for field in fields {
        let crate::component::field::FieldKind::Slot(slot) = &field.kind else {
            continue;
        };

        if !slot.default {
            continue;
        }

        if let Some(existing) = default_slot_name {
            return Err(syn::Error::new(
                field.name.span(),
                format!(
                    "component allows at most one default slot; `{}` is already the default slot",
                    existing
                ),
            ));
        }

        default_slot_name = Some(&field.name);
    }

    Ok(())
}

fn ensure_no_const_generics(generics: &Generics) -> Result<()> {
    for generic in &generics.params {
        if let GenericParam::Const(const_generic) = generic {
            return Err(syn::Error::new(
                const_generic.span(),
                "#[derive(Component)] does not support const generics yet",
            ));
        }
    }

    Ok(())
}

fn ensure_default_slot_disambiguated(fields: &[ComponentField]) -> Result<()> {
    let slot_fields = fields.iter().filter(|field| field.is_slot()).collect::<Vec<_>>();
    if slot_fields.len() <= 1 {
        return Ok(());
    }

    let has_default = slot_fields
        .iter()
        .any(|field| field.slot().is_some_and(|slot| slot.default));
    if has_default {
        return Ok(());
    }

    Err(syn::Error::new(
        slot_fields[0].name.span(),
        "multiple slot fields require one `#[mx(default)]` slot; for example `#[mx(default)] body: Slot<maud::Markup>`",
    ))
}