topcoat-router 0.3.0

use std::borrow::Cow;

use crate::{LayoutFn, LayoutRenderFn, PageFn, PageRenderFn, Path};

/// A page discovered by the module router, produced by the `#[page]` macro.
///
/// Holds the module path (for deriving the URL path from the module tree)
/// and the render function. The module router converts each `ModulePageFn`
/// into a [`PageFn`] once the URL path has been computed.
#[doc(hidden)]
#[derive(Debug, Clone)]
pub struct ModulePageFn {
    /// Module path where `#[page]` was declared, used to derive the URL path.
    module_path: &'static str,
    /// The page's async render function, returning a [`Result`].
    pub(super) render: PageRenderFn,
}

impl ModulePageFn {
    /// Creates a new module page. Called by the expanded `#[page]` macro.
    pub const fn new(module_path: &'static str, render: PageRenderFn) -> Self {
        Self {
            module_path,
            render,
        }
    }

    /// Converts into a [`PageFn`] with the given resolved URL path.
    #[must_use]
    pub fn into_page(self, path: Cow<'static, Path>) -> PageFn {
        PageFn::new(path, self.render)
    }

    /// Returns the module path used to derive the URL.
    #[must_use]
    pub fn module_path(&self) -> &'static str {
        self.module_path
    }
}

#[cfg(feature = "discover")]
inventory::collect!(ModulePageFn);

/// A layout discovered by the module router, produced by the `#[layout]` macro.
///
/// Holds the module path (for deriving the URL prefix from the module tree)
/// and the render function. The module router converts each `ModuleLayoutFn`
/// into a [`LayoutFn`] once the URL path has been computed.
#[doc(hidden)]
#[derive(Debug, Clone)]
pub struct ModuleLayoutFn {
    /// Module path where `#[layout]` was declared, used to derive the URL path.
    module_path: &'static str,
    /// The layout's async render function, receiving a [`Slot`] and returning a [`Result`].
    render: LayoutRenderFn,
}

impl ModuleLayoutFn {
    /// Creates a new module layout. Called by the expanded `#[layout]` macro.
    pub const fn new(module_path: &'static str, render: LayoutRenderFn) -> Self {
        Self {
            module_path,
            render,
        }
    }

    /// Converts into a [`LayoutFn`] with the given resolved URL path.
    #[must_use]
    pub fn into_layout(self, path: Cow<'static, Path>) -> LayoutFn {
        LayoutFn::new(path, self.render)
    }

    /// Returns the module path used to derive the URL.
    #[must_use]
    pub fn module_path(&self) -> &'static str {
        self.module_path
    }
}

#[cfg(feature = "discover")]
inventory::collect!(ModuleLayoutFn);