✨ (htmx): Añade integración con HTMX 2

Constantes `hx-*`, `HtmxRequestExt` y `HtmxResponse` cubren el ciclo
completo: escribir atributos, leer la petición y construir la respuesta.
La extensión Htmx inyecta el script automáticamente.

Añade `IntoResponse` y `Response` al prelude de PageTop.

extensions/pagetop-htmx/src/lib.rs

@@ -0,0 +1,129 @@
+/*!
+<div align="center">
+
+<h1>PageTop HTMX</h1>
+
+<p>Extensión para <strong>PageTop</strong> que integra <a href="https://htmx.org">HTMX</a> para enriquecer las páginas con interacciones dinámicas.</p>
+
+[![Doc API](https://img.shields.io/docsrs/pagetop-htmx?label=Doc%20API&style=for-the-badge&logo=Docs.rs)](https://docs.rs/pagetop-htmx)
+[![Crates.io](https://img.shields.io/crates/v/pagetop-htmx.svg?style=for-the-badge&logo=ipfs)](https://crates.io/crates/pagetop-htmx)
+[![Descargas](https://img.shields.io/crates/d/pagetop-htmx.svg?label=Descargas&style=for-the-badge&logo=transmission)](https://crates.io/crates/pagetop-htmx)
+[![Licencia](https://img.shields.io/badge/license-MIT%2FApache-blue.svg?label=Licencia&style=for-the-badge)](https://git.cillero.es/manuelcillero/pagetop/src/branch/main/extensions/pagetop-htmx#licencia)
+
+</div>
+
+## Sobre PageTop
+
+[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la esencia de la web
+clásica para crear soluciones web SSR (*renderizadas en el servidor*) modulares, extensibles y
+configurables, basadas en HTML, CSS y JavaScript.
+
+## Guía rápida
+
+**Añade la dependencia** a tu `Cargo.toml`:
+
+```toml
+[dependencies]
+pagetop-htmx = { ... }
+```
+
+**Declara la extensión** en tu aplicación (o extensión que la requiera). Recuerda que el orden en
+`dependencies()` determina la prioridad relativa frente a las otras extensiones:
+
+```rust
+use pagetop::prelude::*;
+
+struct MyApp;
+
+impl Extension for MyApp {
+    fn dependencies(&self) -> Vec<ExtensionRef> {
+        vec![
+            // ...
+            &pagetop_htmx::Htmx
+            // ...
+        ]
+    }
+}
+```
+
+A partir de ese momento, todas las páginas de la aplicación incluirán automáticamente el script de
+HTMX 2. Puedes usar los atributos `hx-*` directamente en tus componentes o el código HTML generado:
+
+```rust
+use pagetop::prelude::*;
+
+async fn homepage(request: HttpRequest) -> Result<Markup, ErrorPage> {
+    Page::new(request)
+        .with_child(Html::with(|_| html! {
+            button hx-get="/api/hello" hx-target="#result" {
+                "Say hello"
+            }
+            div #result {}
+        }))
+        .render()
+}
+```
+*/
+
+use pagetop::prelude::*;
+
+pub mod hx;
+
+mod request;
+pub use request::HtmxRequestExt;
+
+mod response;
+pub use response::HtmxResponse;
+
+include_locales!(LOCALES_HTMX);
+
+/// Integra HTMX 2 en cualquier aplicación PageTop.
+///
+/// Poner esta extensión en [`dependencies()`](pagetop::core::extension::Extension::dependencies)
+/// hace que todas las páginas de la aplicación incluyan automáticamente el script de HTMX mediante
+/// un atributo [`defer`](pagetop::html::JavaScript::defer). No es necesaria ninguna configuración
+/// adicional.
+///
+/// # Ejemplo
+///
+/// ```rust,no_run
+/// use pagetop::prelude::*;
+///
+/// struct MyApp;
+///
+/// impl Extension for MyApp {
+///     fn dependencies(&self) -> Vec<ExtensionRef> {
+///         vec![
+///             // ...
+///             &pagetop_htmx::Htmx
+///             // ...
+///         ]
+///     }
+/// }
+/// ```
+pub struct Htmx;
+
+impl Extension for Htmx {
+    fn name(&self) -> L10n {
+        L10n::t("extension_name", &LOCALES_HTMX)
+    }
+
+    fn description(&self) -> L10n {
+        L10n::t("extension_description", &LOCALES_HTMX)
+    }
+
+    fn actions(&self) -> Vec<ActionBox> {
+        actions![action::page::BeforeRenderBody::new(add_htmx_script)]
+    }
+
+    fn configure_router(&self, router: Router) -> Router {
+        serve_static_files!(router, [htmx] => "/htmx");
+        router
+    }
+}
+
+fn add_htmx_script(page: &mut Page) {
+    page.alter_assets(AssetsOp::AddJavaScript(
+        JavaScript::defer("/htmx/js/htmx.min.js").with_version("2.0.10"),
+    ));
+}