✨ Incorpora is_renderable en Component

src/core/component.rs

@@ -11,6 +11,59 @@ pub use children::{Typed, TypedOp};
 mod context;
 pub use context::{Context, ContextError, ContextOp, Contextual};
 
+/// Alias de función (*callback*) para **determinar si un componente se renderiza o no**.
+///
+/// Puede usarse para permitir que una instancia concreta de un tipo de componente dado decida
+/// dinámicamente durante el proceso de renderizado ([`Component::is_renderable()`]) si se renderiza
+/// o no.
+///
+/// # Ejemplo
+///
+/// ```rust
+/// # use pagetop::prelude::*;
+/// #[derive(AutoDefault)]
+/// struct SampleComponent {
+///     renderable: Option<FnIsRenderable>,
+/// }
+///
+/// impl Component for SampleComponent {
+///     fn new() -> Self {
+///         Self::default()
+///     }
+///
+///     fn is_renderable(&self, cx: &mut Context) -> bool {
+///         // Si hay callback, se usa; en caso contrario, se renderiza por defecto.
+///         self.renderable.map_or(true, |f| f(cx))
+///     }
+///
+///     fn prepare_component(&self, _cx: &mut Context) -> PrepareMarkup {
+///         PrepareMarkup::Escaped("Visible component".into())
+///     }
+/// }
+///
+/// impl SampleComponent {
+///     /// Asigna una función que decidirá si el componente se renderiza o no.
+///     #[builder_fn]
+///     pub fn with_renderable(mut self, f: Option<FnIsRenderable>) -> Self {
+///         self.renderable = f;
+///         self
+///     }
+/// }
+///
+/// fn sample() {
+///     let mut cx = Context::default().with_param("user_logged_in", true);
+///
+///     // Se instancia un componente que sólo se renderiza si `user_logged_in` es `true`.
+///     let mut component = SampleComponent::new().with_renderable(Some(|cx: &Context| {
+///         cx.param::<bool>("user_logged_in").copied().unwrap_or(false)
+///     }));
+///
+///     // Aquí simplemente se comprueba que compila y se puede invocar.
+///     let _markup = component.render(&mut cx);
+/// }
+/// ```
+pub type FnIsRenderable = fn(cx: &Context) -> bool;
+
 /// Alias de función (*callback*) para **resolver una URL** según el contexto de renderizado.
 ///
 /// Se usa para generar enlaces dinámicos en función del contexto (petición, idioma, etc.). Debe