✨ Añade servidor web y primeras macros de PageTop

- Crea el crate raíz `pagetop` y configura el workspace con
  `helpers/pagetop-macros`.
- Añade las macros #[pagetop::main] y #[pagetop::test] que envuelven
  Actix-web para crear aplicaciones y pruebas asíncronas sin depender
  explícitamente del framework.
- Reexporta, mediante el módulo `service`, los tipos esenciales de
  Actix-web para gestionar servidores y servicios web.
- Implementa `Application::{new, run, test}` para simplificar el
  arranque y la ejecución de tests.
- Expone `pagetop::prelude` con las macros, `service` y `Application`
  para una API pública coherente.
- Incorpora ejemplo `examples/app-basic.rs` que levanta un servidor web
  vacío con el código mínimo para hacerlo.

helpers/pagetop-macros/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "pagetop-macros"
+version = "0.0.1"
+edition = "2021"
+
+description = """\
+    Una colección de macros que mejoran la experiencia de desarrollo con PageTop.\
+"""
+categories = ["development-tools::procedural-macro-helpers", "web-programming"]
+keywords = ["pagetop", "macros", "proc-macros", "codegen"]
+
+repository.workspace = true
+homepage.workspace = true
+license.workspace = true
+authors.workspace = true
+
+[lib]
+proc-macro = true
+
+[dependencies]
+quote = "1.0.40"

helpers/pagetop-macros/README.md

@@ -0,0 +1,36 @@
+<div align="center">
+
+<h1>PageTop Macros</h1>
+
+<p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
+
+[![Licencia](https://img.shields.io/badge/license-MIT%2FApache-blue.svg?label=Licencia&style=for-the-badge)](#-license)
+
+</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.
+
+
+# 🚧 Advertencia
+
+`PageTop` es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su
+ecosistema. Su API está sujeta a cambios frecuentes. No se recomienda su uso en producción, al menos
+hasta que se libere la versión **1.0.0**.
+
+
+# 📜 Licencia
+
+El código está disponible bajo una doble licencia:
+
+  * **Licencia MIT**
+    ([LICENSE-MIT](LICENSE-MIT) o también https://opensource.org/licenses/MIT)
+
+  * **Licencia Apache, Versión 2.0**
+    ([LICENSE-APACHE](LICENSE-APACHE) o también https://www.apache.org/licenses/LICENSE-2.0)
+
+Puedes elegir la licencia que prefieras. Este enfoque de doble licencia es el estándar de facto en
+el ecosistema Rust.

helpers/pagetop-macros/src/lib.rs

@@ -0,0 +1,60 @@
+//! <div align="center">
+//!
+//! <h1>PageTop Macros</h1>
+//!
+//! <p>Una colección de macros que mejoran la experiencia de desarrollo con <strong>PageTop</strong>.</p>
+//!
+//! [![Licencia](https://img.shields.io/badge/license-MIT%2FApache-blue.svg?label=Licencia&style=for-the-badge)](#-license)
+//!
+//! </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.
+
+use proc_macro::TokenStream;
+use quote::quote;
+
+/// Define una función `main` asíncrona como punto de entrada de `PageTop`.
+///
+/// # Ejemplos
+///
+/// ```rust#ignore
+/// #[pagetop::main]
+/// async fn main() {
+///     async { println!("Hello world!"); }.await
+/// }
+/// ```
+#[proc_macro_attribute]
+pub fn main(_: TokenStream, item: TokenStream) -> TokenStream {
+    let mut output: TokenStream = (quote! {
+        #[::pagetop::service::rt::main(system = "::pagetop::service::rt::System")]
+    })
+    .into();
+
+    output.extend(item);
+    output
+}
+
+/// Define funciones de prueba asíncronas para usar con `PageTop`.
+///
+/// # Ejemplos
+///
+/// ```rust#ignore
+/// #[pagetop::test]
+/// async fn test() {
+///     assert_eq!(async { "Hello world" }.await, "Hello world");
+/// }
+/// ```
+#[proc_macro_attribute]
+pub fn test(_: TokenStream, item: TokenStream) -> TokenStream {
+    let mut output: TokenStream = (quote! {
+        #[::pagetop::service::rt::test(system = "::pagetop::service::rt::System")]
+    })
+    .into();
+
+    output.extend(item);
+    output
+}