🔥 Elimina Render para usar siempre el contexto

src/core/component/definition.rs

@@ -1,6 +1,6 @@
 use crate::base::action;
 use crate::core::{AnyInfo, TypeInfo};
-use crate::html::{html, Context, Markup, PrepareMarkup, Render};
+use crate::html::{html, Context, Markup, PrepareMarkup};
 
 /// Define la función de renderizado para todos los componentes.
 ///

src/core/theme.rs

@@ -7,7 +7,7 @@
 //! Un tema **declara las regiones** (*cabecera*, *barra lateral*, *pie*, etc.) que estarán
 //! disponibles para colocar contenido. Los temas son responsables últimos de los estilos,
 //! tipografías, espaciados y cualquier otro detalle visual o de comportamiento (como animaciones,
-//! *scripts* de interfaz, etc.).
+//! scripts de interfaz, etc.).
 //!
 //! Los temas son extensiones que implementan [`Extension`](crate::core::extension::Extension); por
 //! lo que se instancian, declaran sus dependencias y se inician igual que el resto de extensiones;

src/html.rs

@@ -1,7 +1,7 @@
 //! HTML en código.
 
 mod maud;
-pub use maud::{display, html, html_private, Escaper, Markup, PreEscaped, Render, DOCTYPE};
+pub use maud::{display, html, html_private, Escaper, Markup, PreEscaped, DOCTYPE};
 
 // HTML DOCUMENT ASSETS ****************************************************************************
 
@@ -119,11 +119,9 @@ impl PrepareMarkup {
             PrepareMarkup::With(markup) => markup.is_empty(),
         }
     }
-}
 
-impl Render for PrepareMarkup {
     /// Integra el renderizado fácilmente en la macro [`html!`].
-    fn render(&self) -> Markup {
+    pub fn render(&self) -> Markup {
         match self {
             PrepareMarkup::None => html! {},
             PrepareMarkup::Escaped(text) => html! { (text) },

src/html/assets.rs

@@ -2,10 +2,10 @@ pub mod favicon;
 pub mod javascript;
 pub mod stylesheet;
 
-use crate::html::{html, Markup, Render};
+use crate::html::{html, Context, Markup};
 use crate::{AutoDefault, Weight};
 
-/// Representación genérica de un *script* [`JavaScript`](crate::html::JavaScript) o una hoja de
+/// Representación genérica de un script [`JavaScript`](crate::html::JavaScript) o una hoja de
 /// estilos [`StyleSheet`](crate::html::StyleSheet).
 ///
 /// Estos recursos se incluyen en los conjuntos de recursos ([`Assets`]) que suelen renderizarse en
@@ -13,12 +13,15 @@ use crate::{AutoDefault, Weight};
 ///
 /// Cada recurso se identifica por un **nombre único** ([`Asset::name()`]), usado como clave; y un
 /// **peso** ([`Asset::weight()`]), que determina su orden relativo de renderizado.
-pub trait Asset: Render {
+pub trait Asset {
     /// Devuelve el nombre del recurso, utilizado como clave única.
     fn name(&self) -> &str;
 
     /// Devuelve el peso del recurso, usado para ordenar el renderizado de menor a mayor peso.
     fn weight(&self) -> Weight;
+
+    /// Renderiza el recurso en el contexto proporcionado.
+    fn render(&self, cx: &mut Context) -> Markup;
 }
 
 /// Gestión común para conjuntos de recursos como [`JavaScript`](crate::html::JavaScript) y
@@ -77,16 +80,13 @@ impl<T: Asset> Assets<T> {
             false
         }
     }
-}
 
-impl<T: Asset> Render for Assets<T> {
+    pub fn render(&self, cx: &mut Context) -> Markup {
-    fn render(&self) -> Markup {
         let mut assets = self.0.iter().collect::<Vec<_>>();
         assets.sort_by_key(|a| a.weight());
-
         html! {
             @for a in assets {
-                (a)
+                (a.render(cx))
             }
         }
     }

src/html/assets/favicon.rs

@@ -1,4 +1,4 @@
-use crate::html::{html, Markup, Render};
+use crate::html::{html, Context, Markup};
 use crate::AutoDefault;
 
 /// Un **Favicon** es un recurso gráfico que usa el navegador como icono asociado al sitio.
@@ -151,10 +151,12 @@ impl Favicon {
         });
         self
     }
-}
 
-impl Render for Favicon {
+    /// Renderiza el **Favicon** completo con todas las etiquetas declaradas.
-    fn render(&self) -> Markup {
+    ///
+    /// El parámetro `Context` se acepta por coherencia con el resto de *assets*, aunque en este
+    /// caso es ignorado.
+    pub fn render(&self, _cx: &mut Context) -> Markup {
         html! {
             @for item in &self.0 {
                 (item)

src/html/assets/javascript.rs

@@ -1,35 +1,45 @@
 use crate::html::assets::Asset;
-use crate::html::{html, Markup, Render};
+use crate::html::{html, Context, Markup, PreEscaped};
 use crate::{join, join_pair, AutoDefault, Weight};
 
 // Define el origen del recurso JavaScript y cómo debe cargarse en el navegador.
 //
 // Los distintos modos de carga permiten optimizar el rendimiento y controlar el comportamiento del
-// script.
+// script en relación con el análisis del documento HTML y la ejecución del resto de scripts.
 //
-// - [`From`]   – Carga el script de forma estándar con la etiqueta `<script src="...">`.
+// - [`From`]        – Carga estándar con la etiqueta `<script src="...">`.
-// - [`Defer`]  – Igual que [`From`], pero con el atributo `defer`.
+// - [`Defer`]       – Igual que [`From`], pero con el atributo `defer`, descarga en paralelo y se
-// - [`Async`]  – Igual que [`From`], pero con el atributo `async`.
+//                     ejecuta tras el análisis del documento HTML, respetando el orden de
-// - [`Inline`] – Inserta el código directamente en la etiqueta `<script>`.
+//                     aparición.
-// - [`OnLoad`] – Inserta el código JavaScript y lo ejecuta tras el evento `DOMContentLoaded`.
+// - [`Async`]       – Igual que [`From`], pero con el atributo `async`, descarga en paralelo y se
+//                     ejecuta en cuanto esté listo, **sin garantizar** el orden relativo respecto a
+//                     otros scripts.
+// - [`Inline`]      – Inserta el código directamente en la etiqueta `<script>`.
+// - [`OnLoad`]      – Inserta el código JavaScript y lo ejecuta tras el evento `DOMContentLoaded`.
+// - [`OnLoadAsync`] – Igual que [`OnLoad`], pero con manejador asíncrono (`async`), útil si dentro
+//                     del código JavaScript se utiliza `await`.
 #[derive(AutoDefault)]
 enum Source {
     #[default]
     From(String),
     Defer(String),
     Async(String),
-    Inline(String, String),
+    // `name`, `closure(Context) -> String`.
-    OnLoad(String, String),
+    Inline(String, Box<dyn Fn(&mut Context) -> String + Send + Sync>),
+    // `name`, `closure(Context) -> String` (se ejecuta tras `DOMContentLoaded`).
+    OnLoad(String, Box<dyn Fn(&mut Context) -> String + Send + Sync>),
+    // `name`, `closure(Context) -> String` (manejador `async` tras `DOMContentLoaded`).
+    OnLoadAsync(String, Box<dyn Fn(&mut Context) -> String + Send + Sync>),
 }
 
 /// Define un recurso **JavaScript** para incluir en un documento HTML.
 ///
-/// Este tipo permite añadir *scripts* externos o embebidos con distintas estrategias de carga
+/// Este tipo permite añadir scripts externos o embebidos con distintas estrategias de carga
 /// (`defer`, `async`, *inline*, etc.) y [pesos](crate::Weight) para controlar el orden de inserción
 /// en el documento.
 ///
 /// > **Nota**
-/// > Los archivos de los *scripts* deben estar disponibles en el servidor web de la aplicación.
+/// > Los archivos de los scripts deben estar disponibles en el servidor web de la aplicación.
 /// > Pueden servirse usando [`static_files_service!`](crate::static_files_service).
 ///
 /// # Ejemplo
@@ -37,23 +47,37 @@ enum Source {
 /// ```rust
 /// use pagetop::prelude::*;
 ///
-/// // Script externo con carga diferida, versión para control de caché y prioriza el renderizado.
+/// // Script externo con carga diferida, versión de caché y prioridad en el renderizado.
 /// let script = JavaScript::defer("/assets/js/app.js")
 ///     .with_version("1.2.3")
 ///     .with_weight(-10);
 ///
 /// // Script embebido que se ejecuta tras la carga del documento.
-/// let script = JavaScript::on_load("init_tooltips", r#"
+/// let script = JavaScript::on_load("init_tooltips", |_| r#"
 ///     const tooltips = document.querySelectorAll('[data-tooltip]');
 ///     for (const el of tooltips) {
 ///         el.addEventListener('mouseenter', showTooltip);
 ///     }
-/// "#);
+/// "#.to_string());
+///
+/// // Script embebido con manejador asíncrono (`async`) que puede usar `await`.
+/// let mut cx = Context::new(None).with_param("user_id", 7u32);
+///
+/// let js = JavaScript::on_load_async("hydrate", |cx| {
+///     // Ejemplo: lectura de un parámetro del contexto para inyectarlo en el código.
+///     let uid: u32 = cx.param_or_default("user_id");
+///     format!(r#"
+///         const USER_ID = {};
+///         await Promise.resolve(USER_ID);
+///         // Aquí se podría hidratar la interfaz o cargar módulos dinámicos:
+///         // await import('/assets/js/hydrate.js');
+///     "#, uid)
+/// });
 /// ```
 #[rustfmt::skip]
 #[derive(AutoDefault)]
 pub struct JavaScript {
-    source : Source, // Fuente y modo de carga del script.
+    source : Source, // Fuente y estrategia de carga del script.
     version: String, // Versión del recurso para la caché del navegador.
     weight : Weight, // Peso que determina el orden.
 }
@@ -70,11 +94,11 @@ impl JavaScript {
         }
     }
 
-    /// Crea un **script externo** con el atributo `defer`, que se carga en segundo plano y se
+    /// Crea un **script externo** con el atributo `defer`, que se descarga en paralelo y se ejecuta
-    /// ejecuta tras analizar completamente el documento HTML.
+    /// tras analizar completamente el documento HTML, **respetando el orden** de inserción.
     ///
-    /// Equivale a `<script src="..." defer>`. Útil para mantener el orden de ejecución y evitar
+    /// Equivale a `<script src="..." defer>`. Suele ser la opción recomendada para scripts no
-    /// bloquear el análisis del documento HTML.
+    /// críticos.
     pub fn defer(path: impl Into<String>) -> Self {
         JavaScript {
             source: Source::Defer(path.into()),
@@ -82,11 +106,10 @@ impl JavaScript {
         }
     }
 
-    /// Crea un **script externo** con el atributo `async`, que se carga y ejecuta de forma
+    /// Crea un **script externo** con el atributo `async`, que se descarga en paralelo y se ejecuta
-    /// asíncrona tan pronto como esté disponible.
+    /// tan pronto como esté disponible.
     ///
-    /// Equivale a `<script src="..." async>`. La ejecución puede producirse fuera de orden respecto
+    /// Equivale a `<script src="..." async>`. **No garantiza** el orden relativo con otros scripts.
-    /// a otros *scripts*.
     pub fn asynchronous(path: impl Into<String>) -> Self {
         JavaScript {
             source: Source::Async(path.into()),
@@ -97,37 +120,68 @@ impl JavaScript {
     /// Crea un **script embebido** directamente en el documento HTML.
     ///
     /// Equivale a `<script>...</script>`. El parámetro `name` se usa como identificador interno del
-    /// *script*.
+    /// script.
-    pub fn inline(name: impl Into<String>, script: impl Into<String>) -> Self {
+    ///
+    /// La función *closure* recibirá el [`Context`] por si se necesita durante el renderizado.
+    pub fn inline<F>(name: impl Into<String>, f: F) -> Self
+    where
+        F: Fn(&mut Context) -> String + Send + Sync + 'static,
+    {
         JavaScript {
-            source: Source::Inline(name.into(), script.into()),
+            source: Source::Inline(name.into(), Box::new(f)),
             ..Default::default()
         }
     }
 
-    /// Crea un **script embebido** que se ejecuta automáticamente al terminar de cargarse el
+    /// Crea un **script embebido** que se ejecuta cuando **el DOM está listo**.
-    /// documento HTML.
     ///
-    /// El código se envuelve automáticamente en un `addEventListener('DOMContentLoaded', ...)`. El
+    /// El código se envuelve en un `addEventListener('DOMContentLoaded',function(){...})` que lo
-    /// parámetro `name` se usa como identificador interno del *script*.
+    /// ejecuta tras analizar el documento HTML, **no** espera imágenes ni otros recursos externos.
-    pub fn on_load(name: impl Into<String>, script: impl Into<String>) -> Self {
+    /// Útil para inicializaciones que no dependen de `await`. El parámetro `name` se usa como
+    /// identificador interno del script.
+    ///
+    /// Los scripts con `defer` se ejecutan antes de `DOMContentLoaded`.
+    ///
+    /// La función *closure* recibirá el [`Context`] por si se necesita durante el renderizado.
+    pub fn on_load<F>(name: impl Into<String>, f: F) -> Self
+    where
+        F: Fn(&mut Context) -> String + Send + Sync + 'static,
+    {
         JavaScript {
-            source: Source::OnLoad(name.into(), script.into()),
+            source: Source::OnLoad(name.into(), Box::new(f)),
+            ..Default::default()
+        }
+    }
+
+    /// Crea un **script embebido** con un **manejador asíncrono**.
+    ///
+    /// El código se envuelve en un `addEventListener('DOMContentLoaded',async()=>{...})`, que
+    /// emplea una función `async` para que el cuerpo devuelto por la función *closure* pueda usar
+    /// `await`. Ideal para hidratar la interfaz, cargar módulos dinámicos o realizar lecturas
+    /// iniciales.
+    ///
+    /// La función *closure* recibirá el [`Context`] por si se necesita durante el renderizado.
+    pub fn on_load_async<F>(name: impl Into<String>, f: F) -> Self
+    where
+        F: Fn(&mut Context) -> String + Send + Sync + 'static,
+    {
+        JavaScript {
+            source: Source::OnLoadAsync(name.into(), Box::new(f)),
             ..Default::default()
         }
     }
 
     // JavaScript BUILDER **************************************************************************
 
-    /// Asocia una versión al recurso (usada para control de la caché del navegador).
+    /// Asocia una **versión** al recurso (usada para control de la caché del navegador).
     ///
-    /// Si `version` está vacío, no se añade ningún parámetro a la URL.
+    /// Si `version` está vacío, **no** se añade ningún parámetro a la URL.
     pub fn with_version(mut self, version: impl Into<String>) -> Self {
         self.version = version.into();
         self
     }
 
-    /// Modifica el peso del recurso.
+    /// Modifica el **peso** del recurso.
     ///
     /// Los recursos se renderizan de menor a mayor peso. Por defecto es `0`, que respeta el orden
     /// de creación.
@@ -140,7 +194,7 @@ impl JavaScript {
 impl Asset for JavaScript {
     /// Devuelve el nombre del recurso, utilizado como clave única.
     ///
-    /// Para *scripts* externos es la ruta del recurso; para *scripts* embebidos, un identificador.
+    /// Para scripts externos es la ruta del recurso; para scripts embebidos, un identificador.
     fn name(&self) -> &str {
         match &self.source {
             Source::From(path) => path,
@@ -148,16 +202,15 @@ impl Asset for JavaScript {
             Source::Async(path) => path,
             Source::Inline(name, _) => name,
             Source::OnLoad(name, _) => name,
+            Source::OnLoadAsync(name, _) => name,
         }
     }
 
     fn weight(&self) -> Weight {
         self.weight
     }
-}
 
-impl Render for JavaScript {
+    fn render(&self, cx: &mut Context) -> Markup {
-    fn render(&self) -> Markup {
         match &self.source {
             Source::From(path) => html! {
                 script src=(join_pair!(path, "?v=", self.version.as_str())) {};
@@ -168,12 +221,15 @@ impl Render for JavaScript {
             Source::Async(path) => html! {
                 script src=(join_pair!(path, "?v=", self.version.as_str())) async {};
             },
-            Source::Inline(_, code) => html! {
+            Source::Inline(_, f) => html! {
-                script { (code) };
+                script { (PreEscaped((f)(cx))) };
             },
-            Source::OnLoad(_, code) => html! { (join!(
+            Source::OnLoad(_, f) => html! { script { (PreEscaped(join!(
-                "document.addEventListener('DOMContentLoaded',function(){", code, "});"
+                "document.addEventListener(\"DOMContentLoaded\",function(){", (f)(cx), "});"
-            )) },
+            ))) } },
+            Source::OnLoadAsync(_, f) => html! { script { (PreEscaped(join!(
+                "document.addEventListener(\"DOMContentLoaded\",async()=>{", (f)(cx), "});"
+            ))) } },
         }
     }
 }

src/html/assets/stylesheet.rs

@@ -1,5 +1,5 @@
 use crate::html::assets::Asset;
-use crate::html::{html, Markup, PreEscaped, Render};
+use crate::html::{html, Context, Markup, PreEscaped};
 use crate::{join_pair, AutoDefault, Weight};
 
 // Define el origen del recurso CSS y cómo se incluye en el documento.
@@ -14,7 +14,8 @@ use crate::{join_pair, AutoDefault, Weight};
 enum Source {
     #[default]
     From(String),
-    Inline(String, String),
+    // `name`, `closure(Context) -> String`.
+    Inline(String, Box<dyn Fn(&mut Context) -> String + Send + Sync>),
 }
 
 /// Define el medio objetivo para la hoja de estilos.
@@ -34,7 +35,7 @@ pub enum TargetMedia {
     Speech,
 }
 
-/// Devuelve el texto asociado al punto de interrupción usado por Bootstrap.
+/// Devuelve el valor para el atributo `media` (`Some(...)`) o `None` para `Default`.
 #[rustfmt::skip]
 impl TargetMedia {
     fn as_str_opt(&self) -> Option<&str> {
@@ -69,12 +70,12 @@ impl TargetMedia {
 ///     .with_weight(-10);
 ///
 /// // Crea una hoja de estilos embebida en el documento HTML.
-/// let embedded = StyleSheet::inline("custom_theme", r#"
+/// let embedded = StyleSheet::inline("custom_theme", |_| r#"
 ///     body {
 ///         background-color: #f5f5f5;
 ///         font-family: 'Segoe UI', sans-serif;
 ///     }
-/// "#);
+/// "#.to_string());
 /// ```
 #[rustfmt::skip]
 #[derive(AutoDefault)]
@@ -100,9 +101,14 @@ impl StyleSheet {
     ///
     /// Equivale a `<style>...</style>`. El parámetro `name` se usa como identificador interno del
     /// recurso.
-    pub fn inline(name: impl Into<String>, styles: impl Into<String>) -> Self {
+    ///
+    /// La función *closure* recibirá el [`Context`] por si se necesita durante el renderizado.
+    pub fn inline<F>(name: impl Into<String>, f: F) -> Self
+    where
+        F: Fn(&mut Context) -> String + Send + Sync + 'static,
+    {
         StyleSheet {
-            source: Source::Inline(name.into(), styles.into()),
+            source: Source::Inline(name.into(), Box::new(f)),
             ..Default::default()
         }
     }
@@ -133,9 +139,9 @@ impl StyleSheet {
     /// Según el argumento `media`:
     ///
     /// - `TargetMedia::Default` - Se aplica en todos los casos (medio por defecto).
-    /// - `TargetMedia::Print`   - Se aplican cuando el documento se imprime.
+    /// - `TargetMedia::Print`   - Se aplica cuando el documento se imprime.
-    /// - `TargetMedia::Screen`  - Se aplican en pantallas.
+    /// - `TargetMedia::Screen`  - Se aplica en pantallas.
-    /// - `TargetMedia::Speech`  - Se aplican en dispositivos que convierten el texto a voz.
+    /// - `TargetMedia::Speech`  - Se aplica en dispositivos que convierten el texto a voz.
     pub fn for_media(mut self, media: TargetMedia) -> Self {
         self.media = media;
         self
@@ -156,10 +162,8 @@ impl Asset for StyleSheet {
     fn weight(&self) -> Weight {
         self.weight
     }
-}
 
-impl Render for StyleSheet {
+    fn render(&self, cx: &mut Context) -> Markup {
-    fn render(&self) -> Markup {
         match &self.source {
             Source::From(path) => html! {
                 link
@@ -167,8 +171,8 @@ impl Render for StyleSheet {
                     href=(join_pair!(path, "?v=", self.version.as_str()))
                     media=[self.media.as_str_opt()];
             },
-            Source::Inline(_, code) => html! {
+            Source::Inline(_, f) => html! {
-                style { (PreEscaped(code)) };
+                style { (PreEscaped((f)(cx))) };
             },
         }
     }

src/html/context.rs

@@ -25,9 +25,9 @@ pub enum AssetsOp {
     RemoveStyleSheet(&'static str),
 
     // JavaScripts.
-    /// Añade un *script* JavaScript al documento.
+    /// Añade un script JavaScript al documento.
     AddJavaScript(JavaScript),
-    /// Elimina un *script* por su ruta o identificador.
+    /// Elimina un script por su ruta o identificador.
     RemoveJavaScript(&'static str),
 }
 
@@ -55,7 +55,7 @@ pub enum ErrorParam {
 /// - Almacenar la **solicitud HTTP** de origen.
 /// - Seleccionar **tema** y **composición** (*layout*) de renderizado.
 /// - Administrar **recursos** del documento como el icono [`Favicon`], las hojas de estilo
-///   [`StyleSheet`] o los *scripts* [`JavaScript`] mediante [`AssetsOp`].
+///   [`StyleSheet`] o los scripts [`JavaScript`] mediante [`AssetsOp`].
 /// - Leer y mantener **parámetros dinámicos tipados** de contexto.
 /// - Generar **identificadores únicos** por tipo de componente.
 ///
@@ -139,7 +139,7 @@ pub trait Contextual: LangId {
     /// Devuelve las hojas de estilo de los recursos del contexto.
     fn stylesheets(&self) -> &Assets<StyleSheet>;
 
-    /// Devuelve los *scripts* JavaScript de los recursos del contexto.
+    /// Devuelve los scripts JavaScript de los recursos del contexto.
     fn javascripts(&self) -> &Assets<JavaScript>;
 
     // Contextual HELPERS **************************************************************************
@@ -155,7 +155,7 @@ pub trait Contextual: LangId {
 ///
 /// Extiende [`Contextual`] con métodos para **instanciar** y configurar un nuevo contexto,
 /// **renderizar los recursos** del documento (incluyendo el [`Favicon`], las hojas de estilo
-/// [`StyleSheet`] y los *scripts* [`JavaScript`]), o extender el uso de **parámetros dinámicos
+/// [`StyleSheet`] y los scripts [`JavaScript`]), o extender el uso de **parámetros dinámicos
 /// tipados** con nuevos métodos.
 ///
 /// # Ejemplos
@@ -258,14 +258,29 @@ impl Context {
     // Context RENDER ******************************************************************************
 
     /// Renderiza los recursos del contexto.
-    pub fn render_assets(&self) -> Markup {
+    pub fn render_assets(&mut self) -> Markup {
-        html! {
+        use std::mem::take as mem_take;
-            @if let Some(favicon) = &self.favicon {
+
-                (favicon)
+        // Extrae temporalmente los recursos.
+        let favicon = mem_take(&mut self.favicon); // Deja valor por defecto (None) en self.
+        let stylesheets = mem_take(&mut self.stylesheets); // Assets<StyleSheet>::default() en self.
+        let javascripts = mem_take(&mut self.javascripts); // Assets<JavaScript>::default() en self.
+
+        // Renderiza con `&mut self` como contexto.
+        let markup = html! {
+            @if let Some(fi) = &favicon {
+                (fi.render(self))
             }
-            (self.stylesheets)
+            (stylesheets.render(self))
-            (self.javascripts)
+            (javascripts.render(self))
-        }
+        };
+
+        // Restaura los campos tal y como estaban.
+        self.favicon = favicon;
+        self.stylesheets = stylesheets;
+        self.javascripts = javascripts;
+
+        markup
     }
 
     // Context PARAMS ******************************************************************************

src/html/maud.rs

@@ -69,23 +69,6 @@ impl fmt::Write for Escaper<'_> {
 /// `.render()` or `.render_to()`. Since the default definitions of
 /// these methods call each other, not doing this will result in
 /// infinite recursion.
-///
-/// # Example
-///
-/// ```rust
-/// use pagetop::prelude::*;
-///
-/// /// Provides a shorthand for linking to a CSS stylesheet.
-/// pub struct Stylesheet(&'static str);
-///
-/// impl Render for Stylesheet {
-///     fn render(&self) -> Markup {
-///         html! {
-///             link rel="stylesheet" type="text/css" href=(self.0);
-///         }
-///     }
-/// }
-/// ```
 pub trait Render {
     /// Renders `self` as a block of `Markup`.
     fn render(&self) -> Markup {
@@ -238,6 +221,10 @@ impl Markup {
     pub fn is_empty(&self) -> bool {
         self.0.is_empty()
     }
+
+    pub fn as_str(&self) -> &str {
+        self.0.as_str()
+    }
 }
 
 impl<T: Into<String>> PreEscaped<T> {

src/response/page.rs

@@ -202,7 +202,7 @@ impl Page {
     }
 
     /// Renderiza los recursos de la página.
-    pub fn render_assets(&self) -> Markup {
+    pub fn render_assets(&mut self) -> Markup {
         self.context.render_assets()
     }
 

tests/component_poweredby.rs

@@ -8,10 +8,10 @@ async fn poweredby_default_shows_only_pagetop_recognition() {
     let html = render_component(&p);
 
     // Debe mostrar el bloque de reconocimiento a PageTop.
-    assert!(html.contains("poweredby__pagetop"));
+    assert!(html.as_str().contains("poweredby__pagetop"));
 
     // Y NO debe mostrar el bloque de copyright.
-    assert!(!html.contains("poweredby__copyright"));
+    assert!(!html.as_str().contains("poweredby__copyright"));
 }
 
 #[pagetop::test]
@@ -22,17 +22,20 @@ async fn poweredby_new_includes_current_year_and_app_name() {
     let html = render_component(&p);
 
     let year = Utc::now().format("%Y").to_string();
-    assert!(html.contains(&year), "HTML should include the current year");
+    assert!(
+        html.as_str().contains(&year),
+        "HTML should include the current year"
+    );
 
     // El nombre de la app proviene de `global::SETTINGS.app.name`.
     let app_name = &global::SETTINGS.app.name;
     assert!(
-        html.contains(app_name),
+        html.as_str().contains(app_name),
         "HTML should include the application name"
     );
 
     // Debe existir el span de copyright.
-    assert!(html.contains("poweredby__copyright"));
+    assert!(html.as_str().contains("poweredby__copyright"));
 }
 
 #[pagetop::test]
@@ -43,8 +46,8 @@ async fn poweredby_with_copyright_overrides_text() {
     let p = PoweredBy::default().with_copyright(Some(custom));
     let html = render_component(&p);
 
-    assert!(html.contains(custom));
+    assert!(html.as_str().contains(custom));
-    assert!(html.contains("poweredby__copyright"));
+    assert!(html.as_str().contains("poweredby__copyright"));
 }
 
 #[pagetop::test]
@@ -54,9 +57,9 @@ async fn poweredby_with_copyright_none_hides_text() {
     let p = PoweredBy::new().with_copyright(None::<String>);
     let html = render_component(&p);
 
-    assert!(!html.contains("poweredby__copyright"));
+    assert!(!html.as_str().contains("poweredby__copyright"));
     // El reconocimiento a PageTop siempre debe aparecer.
-    assert!(html.contains("poweredby__pagetop"));
+    assert!(html.as_str().contains("poweredby__pagetop"));
 }
 
 #[pagetop::test]
@@ -67,7 +70,7 @@ async fn poweredby_link_points_to_crates_io() {
     let html = render_component(&p);
 
     assert!(
-        html.contains("https://pagetop.cillero.es"),
+        html.as_str().contains("https://pagetop.cillero.es"),
         "Link should point to pagetop.cillero.es"
     );
 }
@@ -89,12 +92,8 @@ async fn poweredby_getter_reflects_internal_state() {
 
 // HELPERS *****************************************************************************************
 
-fn render(x: &impl Render) -> String {
+fn render_component<C: Component>(c: &C) -> Markup {
-    x.render().into_string()
-}
-
-fn render_component<C: Component>(c: &C) -> String {
     let mut cx = Context::default();
     let pm = c.prepare_component(&mut cx);
-    render(&pm)
+    pm.render()
 }

tests/html.rs

@@ -2,19 +2,19 @@ use pagetop::prelude::*;
 
 #[pagetop::test]
 async fn prepare_markup_render_none_is_empty_string() {
-    assert_eq!(render(&PrepareMarkup::None), "");
+    assert_eq!(PrepareMarkup::None.render().as_str(), "");
 }
 
 #[pagetop::test]
 async fn prepare_markup_render_escaped_escapes_html_and_ampersands() {
-    let pm = PrepareMarkup::Escaped(String::from("<b>& \" ' </b>"));
+    let pm = PrepareMarkup::Escaped("<b>& \" ' </b>".to_string());
-    assert_eq!(render(&pm), "&lt;b&gt;&amp; &quot; ' &lt;/b&gt;");
+    assert_eq!(pm.render().as_str(), "&lt;b&gt;&amp; &quot; ' &lt;/b&gt;");
 }
 
 #[pagetop::test]
 async fn prepare_markup_render_raw_is_inserted_verbatim() {
-    let pm = PrepareMarkup::Raw(String::from("<b>bold</b><script>1<2</script>"));
+    let pm = PrepareMarkup::Raw("<b>bold</b><script>1<2</script>".to_string());
-    assert_eq!(render(&pm), "<b>bold</b><script>1<2</script>");
+    assert_eq!(pm.render().as_str(), "<b>bold</b><script>1<2</script>");
 }
 
 #[pagetop::test]
@@ -24,7 +24,7 @@ async fn prepare_markup_render_with_keeps_structure() {
         p { "This is a paragraph." }
     });
     assert_eq!(
-        render(&pm),
+        pm.render().as_str(),
         "<h2>Sample title</h2><p>This is a paragraph.</p>"
     );
 }
@@ -33,7 +33,7 @@ async fn prepare_markup_render_with_keeps_structure() {
 async fn prepare_markup_does_not_double_escape_when_wrapped_in_html_macro() {
     // Escaped: dentro de `html!` no debe volver a escaparse.
     let escaped = PrepareMarkup::Escaped("<i>x</i>".into());
-    let wrapped_escaped = html! { div { (escaped) } };
+    let wrapped_escaped = html! { div { (escaped.render()) } };
     assert_eq!(
         wrapped_escaped.into_string(),
         "<div>&lt;i&gt;x&lt;/i&gt;</div>"
@@ -41,12 +41,12 @@ async fn prepare_markup_does_not_double_escape_when_wrapped_in_html_macro() {
 
     // Raw: tampoco debe escaparse al integrarlo.
     let raw = PrepareMarkup::Raw("<i>x</i>".into());
-    let wrapped_raw = html! { div { (raw) } };
+    let wrapped_raw = html! { div { (raw.render()) } };
     assert_eq!(wrapped_raw.into_string(), "<div><i>x</i></div>");
 
     // With: debe incrustar el Markup tal cual.
     let with = PrepareMarkup::With(html! { span.title { "ok" } });
-    let wrapped_with = html! { div { (with) } };
+    let wrapped_with = html! { div { (with.render()) } };
     assert_eq!(
         wrapped_with.into_string(),
         "<div><span class=\"title\">ok</span></div>"
@@ -57,11 +57,14 @@ async fn prepare_markup_does_not_double_escape_when_wrapped_in_html_macro() {
 async fn prepare_markup_unicode_is_preserved() {
     // Texto con acentos y emojis debe conservarse (salvo el escape HTML de signos).
     let esc = PrepareMarkup::Escaped("Hello, tomorrow coffee ☕ & donuts!".into());
-    assert_eq!(render(&esc), "Hello, tomorrow coffee ☕ &amp; donuts!");
+    assert_eq!(
+        esc.render().as_str(),
+        "Hello, tomorrow coffee ☕ &amp; donuts!"
+    );
 
     // Raw debe pasar íntegro.
     let raw = PrepareMarkup::Raw("Title — section © 2025".into());
-    assert_eq!(render(&raw), "Title — section © 2025");
+    assert_eq!(raw.render().as_str(), "Title — section © 2025");
 }
 
 #[pagetop::test]
@@ -69,11 +72,11 @@ async fn prepare_markup_is_empty_semantics() {
     assert!(PrepareMarkup::None.is_empty());
 
     assert!(PrepareMarkup::Escaped(String::new()).is_empty());
-    assert!(PrepareMarkup::Escaped(String::from("")).is_empty());
+    assert!(PrepareMarkup::Escaped("".to_string()).is_empty());
-    assert!(!PrepareMarkup::Escaped(String::from("x")).is_empty());
+    assert!(!PrepareMarkup::Escaped("x".to_string()).is_empty());
 
     assert!(PrepareMarkup::Raw(String::new()).is_empty());
-    assert!(PrepareMarkup::Raw(String::from("")).is_empty());
+    assert!(PrepareMarkup::Raw("".to_string()).is_empty());
     assert!(!PrepareMarkup::Raw("a".into()).is_empty());
 
     assert!(PrepareMarkup::With(html! {}).is_empty());
@@ -94,17 +97,12 @@ async fn prepare_markup_equivalence_between_render_and_inline_in_html_macro() {
     ];
 
     for pm in cases {
-        let rendered = render(&pm);
+        let rendered = pm.render();
-        let in_macro = html! { (pm) }.into_string();
+        let in_macro = html! { (rendered) }.into_string();
         assert_eq!(
-            rendered, in_macro,
+            rendered.as_str(),
+            in_macro,
             "The output of Render and (pm) inside html! must match"
         );
     }
 }
-
-// HELPERS *****************************************************************************************
-
-fn render(x: &impl Render) -> String {
-    x.render().into_string()
-}