✨ Añade ComponentError con HTML alternativo

`prepare_component()` ahora devuelve `Result<Markup, ComponentError>` en
lugar de `Markup`, para que los componentes señalen fallos durante el
renderizado de forma explícita.

`ComponentError` encapsula un mensaje de error y un marcado HTML
alternativo opcional (`fallback`). Si se produce un error, el ciclo de
renderizado registra la traza y muestra el `fallback` en lugar del
componente fallido, sin interrumpir el resto de la página.

Lo mismo aplica a los errores devueltos por la acción `PrepareRender` de
los temas, que siguen el mismo mecanismo.

src/base/action/theme/prepare_render.rs

@@ -6,7 +6,7 @@ use crate::prelude::*;
 /// los componentes.
 ///
 /// Recibe una referencia al componente `component` y una referencia mutable al contexto `cx`.
-pub type FnPrepareRender<C> = fn(component: &C, cx: &mut Context) -> Markup;
+pub type FnPrepareRender<C> = fn(component: &C, cx: &mut Context) -> Result<Markup, ComponentError>;
 
 /// Ejecuta [`FnPrepareRender`] para preparar el renderizado de un componente.
 ///
@@ -41,23 +41,25 @@ impl<C: Component> PrepareRender<C> {
         }
     }
 
-    /// Despacha las acciones. Se detiene en cuanto una renderiza.
+    /// Despacha las acciones. Se detiene en cuanto una renderiza o produce un error.
     #[inline]
-    pub(crate) fn dispatch(component: &C, cx: &mut Context) -> Markup {
-        let mut render_component = html! {};
-        dispatch_actions(
+    pub(crate) fn dispatch(component: &C, cx: &mut Context) -> Result<Markup, ComponentError> {
+        let mut render_result: Result<Markup, ComponentError> = Ok(html! {});
+        dispatch_actions_until(
             &ActionKey::new(
                 UniqueId::of::<Self>(),
                 Some(cx.theme().type_id()),
                 Some(UniqueId::of::<C>()),
                 None,
             ),
-            |action: &Self| {
-                if render_component.is_empty() {
-                    render_component = (action.f)(component, cx);
+            |action: &Self| match &render_result {
+                Ok(markup) if markup.is_empty() => {
+                    render_result = (action.f)(component, cx);
+                    std::ops::ControlFlow::Continue(())
                 }
+                _ => std::ops::ControlFlow::Break(()),
             },
         );
-        render_component
+        render_result
     }
 }

src/base/component/block.rs

@@ -29,23 +29,23 @@ impl Component for Block {
         self.alter_classes(ClassesOp::Prepend, "block");
     }
 
-    fn prepare_component(&self, cx: &mut Context) -> Markup {
+    fn prepare_component(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
         let block_body = self.children().render(cx);
 
         if block_body.is_empty() {
-            return html! {};
+            return Ok(html! {});
         }
 
         let id = cx.required_id::<Block>(self.id());
 
-        html! {
+        Ok(html! {
             div id=(id) class=[self.classes().get()] {
                 @if let Some(title) = self.title().lookup(cx) {
                     h2 class="block__title" { span { (title) } }
                 }
                 div class="block__body" { (block_body) }
             }
-        }
+        })
     }
 }
 

src/base/component/html.rs

@@ -52,8 +52,8 @@ impl Component for Html {
         Self::default()
     }
 
-    fn prepare_component(&self, cx: &mut Context) -> Markup {
-        self.html(cx)
+    fn prepare_component(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
+        Ok(self.html(cx))
     }
 }
 

src/base/component/intro.rs

@@ -115,7 +115,7 @@ impl Component for Intro {
         ));
     }
 
-    fn prepare_component(&self, cx: &mut Context) -> Markup {
+    fn prepare_component(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
         if *self.opening() == IntroOpening::PageTop {
             cx.alter_assets(AssetsOp::AddJavaScript(JavaScript::on_load_async("intro-js", |cx|
                 util::indoc!(r#"
@@ -135,7 +135,7 @@ impl Component for Intro {
             )));
         }
 
-        html! {
+        Ok(html! {
             div class="intro" {
                 div class="intro-header" {
                     section class="intro-header__body" {
@@ -206,7 +206,7 @@ impl Component for Intro {
                     }
                 }
             }
-        }
+        })
     }
 }
 

src/base/component/poweredby.rs

@@ -25,8 +25,8 @@ impl Component for PoweredBy {
         PoweredBy { copyright: Some(c) }
     }
 
-    fn prepare_component(&self, cx: &mut Context) -> Markup {
-        html! {
+    fn prepare_component(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
+        Ok(html! {
             div id=[self.id()] class="poweredby" {
                 @if let Some(c) = self.copyright() {
                     span class="poweredby__copyright" { (c) "." } " "
@@ -35,7 +35,7 @@ impl Component for PoweredBy {
                     (L10n::l("poweredby_pagetop").with_arg("pagetop_link", LINK).using(cx))
                 }
             }
-        }
+        })
     }
 }