From bf3ea43b534fe47d0c41585604f1b41534fb0ecb Mon Sep 17 00:00:00 2001
From: Manuel Cillero <manuel@cillero.es>
Date: Sun, 3 Aug 2025 13:15:08 +0200
Subject: [PATCH 1/2] =?UTF-8?q?=F0=9F=8F=B7=EF=B8=8F=20Simplifica=20nombre?=
 =?UTF-8?q?s=20de=20traits=20esenciales?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Los traits `ExtensionTrait`, `ThemeTrait` y `ComponentTrait` pasan a ser
`Extension`, `Theme`y `Component`, respectivamente,
---
 helpers/pagetop-build/src/lib.rs               |  2 +-
 .../action/component/after_render_component.rs |  8 ++++----
 .../component/before_render_component.rs       |  8 ++++----
 src/base/action/component/is_renderable.rs     |  8 ++++----
 src/base/action/page/after_render_body.rs      |  2 +-
 src/base/action/page/before_render_body.rs     |  2 +-
 .../action/theme/after_render_component.rs     | 10 +++++-----
 .../action/theme/before_render_component.rs    | 10 +++++-----
 src/base/action/theme/prepare_render.rs        | 10 +++++-----
 src/base/component/html.rs                     |  2 +-
 src/base/extension/welcome.rs                  |  2 +-
 src/base/theme/basic.rs                        |  4 ++--
 src/core/action.rs                             |  4 ++--
 src/core/component.rs                          |  2 +-
 src/core/component/children.rs                 | 18 +++++++++---------
 src/core/component/definition.rs               |  4 ++--
 src/core/extension.rs                          |  4 ++--
 src/core/extension/definition.rs               | 16 ++++++++--------
 src/core/theme.rs                              |  9 ++++-----
 src/core/theme/definition.rs                   | 16 ++++++++--------
 src/html/opt_component.rs                      |  8 ++++----
 src/response/page.rs                           |  6 +++---
 src/service.rs                                 |  2 +-
 23 files changed, 78 insertions(+), 79 deletions(-)

diff --git a/helpers/pagetop-build/src/lib.rs b/helpers/pagetop-build/src/lib.rs
index b0a13f3..b18cf52 100644
--- a/helpers/pagetop-build/src/lib.rs
+++ b/helpers/pagetop-build/src/lib.rs
@@ -101,7 +101,7 @@
 //!
 //! pub struct MyExtension;
 //!
-//! impl ExtensionTrait for MyExtension {
+//! impl Extension for MyExtension {
 //!     // Servicio web que publica los recursos de `guides` en `/ruta/a/guides`.
 //!     fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
 //!         include_files_service!(scfg, guides => "/ruta/a/guides");
diff --git a/src/base/action/component/after_render_component.rs b/src/base/action/component/after_render_component.rs
index 48873f7..917f322 100644
--- a/src/base/action/component/after_render_component.rs
+++ b/src/base/action/component/after_render_component.rs
@@ -3,7 +3,7 @@ use crate::prelude::*;
 use crate::base::action::FnActionWithComponent;
 
 /// Ejecuta [`FnActionWithComponent`] después de renderizar un componente.
-pub struct AfterRender<C: ComponentTrait> {
+pub struct AfterRender<C: Component> {
     f: FnActionWithComponent<C>,
     referer_type_id: Option<UniqueId>,
     referer_id: OptionId,
@@ -11,7 +11,7 @@ pub struct AfterRender<C: ComponentTrait> {
 }
 
 /// Filtro para despachar [`FnActionWithComponent`] después de renderizar un componente `C`.
-impl<C: ComponentTrait> ActionDispatcher for AfterRender<C> {
+impl<C: Component> ActionDispatcher for AfterRender<C> {
     /// Devuelve el identificador de tipo ([`UniqueId`]) del componente `C`.
     fn referer_type_id(&self) -> Option<UniqueId> {
         self.referer_type_id
@@ -28,8 +28,8 @@ impl<C: ComponentTrait> ActionDispatcher for AfterRender<C> {
     }
 }
 
-impl<C: ComponentTrait> AfterRender<C> {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción [`FnActionWithComponent`].
+impl<C: Component> AfterRender<C> {
+    /// Permite [registrar](Extension::actions) una nueva acción [`FnActionWithComponent`].
     pub fn new(f: FnActionWithComponent<C>) -> Self {
         AfterRender {
             f,
diff --git a/src/base/action/component/before_render_component.rs b/src/base/action/component/before_render_component.rs
index 483b916..8c2e38d 100644
--- a/src/base/action/component/before_render_component.rs
+++ b/src/base/action/component/before_render_component.rs
@@ -3,7 +3,7 @@ use crate::prelude::*;
 use crate::base::action::FnActionWithComponent;
 
 /// Ejecuta [`FnActionWithComponent`] antes de renderizar el componente.
-pub struct BeforeRender<C: ComponentTrait> {
+pub struct BeforeRender<C: Component> {
     f: FnActionWithComponent<C>,
     referer_type_id: Option<UniqueId>,
     referer_id: OptionId,
@@ -11,7 +11,7 @@ pub struct BeforeRender<C: ComponentTrait> {
 }
 
 /// Filtro para despachar [`FnActionWithComponent`] antes de renderizar un componente `C`.
-impl<C: ComponentTrait> ActionDispatcher for BeforeRender<C> {
+impl<C: Component> ActionDispatcher for BeforeRender<C> {
     /// Devuelve el identificador de tipo ([`UniqueId`]) del componente `C`.
     fn referer_type_id(&self) -> Option<UniqueId> {
         self.referer_type_id
@@ -28,8 +28,8 @@ impl<C: ComponentTrait> ActionDispatcher for BeforeRender<C> {
     }
 }
 
-impl<C: ComponentTrait> BeforeRender<C> {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción [`FnActionWithComponent`].
+impl<C: Component> BeforeRender<C> {
+    /// Permite [registrar](Extension::actions) una nueva acción [`FnActionWithComponent`].
     pub fn new(f: FnActionWithComponent<C>) -> Self {
         BeforeRender {
             f,
diff --git a/src/base/action/component/is_renderable.rs b/src/base/action/component/is_renderable.rs
index 3f0f163..baa86f1 100644
--- a/src/base/action/component/is_renderable.rs
+++ b/src/base/action/component/is_renderable.rs
@@ -8,7 +8,7 @@ use crate::prelude::*;
 pub type FnIsRenderable<C> = fn(component: &C, cx: &Context) -> bool;
 
 /// Con la función [`FnIsRenderable`] se puede decidir si se renderiza o no un componente.
-pub struct IsRenderable<C: ComponentTrait> {
+pub struct IsRenderable<C: Component> {
     f: FnIsRenderable<C>,
     referer_type_id: Option<UniqueId>,
     referer_id: OptionId,
@@ -16,7 +16,7 @@ pub struct IsRenderable<C: ComponentTrait> {
 }
 
 /// Filtro para despachar [`FnIsRenderable`] para decidir si se renderiza o no un componente `C`.
-impl<C: ComponentTrait> ActionDispatcher for IsRenderable<C> {
+impl<C: Component> ActionDispatcher for IsRenderable<C> {
     /// Devuelve el identificador de tipo ([`UniqueId`]) del componente `C`.
     fn referer_type_id(&self) -> Option<UniqueId> {
         self.referer_type_id
@@ -33,8 +33,8 @@ impl<C: ComponentTrait> ActionDispatcher for IsRenderable<C> {
     }
 }
 
-impl<C: ComponentTrait> IsRenderable<C> {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción [`FnIsRenderable`].
+impl<C: Component> IsRenderable<C> {
+    /// Permite [registrar](Extension::actions) una nueva acción [`FnIsRenderable`].
     pub fn new(f: FnIsRenderable<C>) -> Self {
         IsRenderable {
             f,
diff --git a/src/base/action/page/after_render_body.rs b/src/base/action/page/after_render_body.rs
index 081b9aa..0bbfeab 100644
--- a/src/base/action/page/after_render_body.rs
+++ b/src/base/action/page/after_render_body.rs
@@ -22,7 +22,7 @@ impl ActionDispatcher for AfterRenderBody {
 }
 
 impl AfterRenderBody {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción
+    /// Permite [registrar](Extension::actions) una nueva acción
     /// [`FnActionWithPage`](crate::base::action::page::FnActionWithPage).
     pub fn new(f: FnActionWithPage) -> Self {
         AfterRenderBody { f, weight: 0 }
diff --git a/src/base/action/page/before_render_body.rs b/src/base/action/page/before_render_body.rs
index a6e5c56..68f4af7 100644
--- a/src/base/action/page/before_render_body.rs
+++ b/src/base/action/page/before_render_body.rs
@@ -22,7 +22,7 @@ impl ActionDispatcher for BeforeRenderBody {
 }
 
 impl BeforeRenderBody {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción
+    /// Permite [registrar](Extension::actions) una nueva acción
     /// [`FnActionWithPage`](crate::base::action::page::FnActionWithPage).
     pub fn new(f: FnActionWithPage) -> Self {
         BeforeRenderBody { f, weight: 0 }
diff --git a/src/base/action/theme/after_render_component.rs b/src/base/action/theme/after_render_component.rs
index d33e0d2..d0beeb4 100644
--- a/src/base/action/theme/after_render_component.rs
+++ b/src/base/action/theme/after_render_component.rs
@@ -3,7 +3,7 @@ use crate::prelude::*;
 use crate::base::action::FnActionWithComponent;
 
 /// Ejecuta [`FnActionWithComponent`] después de que un tema renderice el componente.
-pub struct AfterRender<C: ComponentTrait> {
+pub struct AfterRender<C: Component> {
     f: FnActionWithComponent<C>,
     theme_type_id: Option<UniqueId>,
     referer_type_id: Option<UniqueId>,
@@ -11,7 +11,7 @@ pub struct AfterRender<C: ComponentTrait> {
 
 /// Filtro para despachar [`FnActionWithComponent`] después de que un tema renderice el componente
 /// `C`.
-impl<C: ComponentTrait> ActionDispatcher for AfterRender<C> {
+impl<C: Component> ActionDispatcher for AfterRender<C> {
     /// Devuelve el identificador de tipo ([`UniqueId`]) del tema.
     fn theme_type_id(&self) -> Option<UniqueId> {
         self.theme_type_id
@@ -23,9 +23,9 @@ impl<C: ComponentTrait> ActionDispatcher for AfterRender<C> {
     }
 }
 
-impl<C: ComponentTrait> AfterRender<C> {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción [`FnActionWithComponent`] para
-    /// un tema dado.
+impl<C: Component> AfterRender<C> {
+    /// Permite [registrar](Extension::actions) una nueva acción [`FnActionWithComponent`] para un
+    /// tema dado.
     pub fn new(theme: ThemeRef, f: FnActionWithComponent<C>) -> Self {
         AfterRender {
             f,
diff --git a/src/base/action/theme/before_render_component.rs b/src/base/action/theme/before_render_component.rs
index 76f6cd2..ac5ee6b 100644
--- a/src/base/action/theme/before_render_component.rs
+++ b/src/base/action/theme/before_render_component.rs
@@ -3,7 +3,7 @@ use crate::prelude::*;
 use crate::base::action::FnActionWithComponent;
 
 /// Ejecuta [`FnActionWithComponent`] antes de que un tema renderice el componente.
-pub struct BeforeRender<C: ComponentTrait> {
+pub struct BeforeRender<C: Component> {
     f: FnActionWithComponent<C>,
     theme_type_id: Option<UniqueId>,
     referer_type_id: Option<UniqueId>,
@@ -11,7 +11,7 @@ pub struct BeforeRender<C: ComponentTrait> {
 
 /// Filtro para despachar [`FnActionWithComponent`] antes de que un tema renderice el componente
 /// `C`.
-impl<C: ComponentTrait> ActionDispatcher for BeforeRender<C> {
+impl<C: Component> ActionDispatcher for BeforeRender<C> {
     /// Devuelve el identificador de tipo ([`UniqueId`]) del tema.
     fn theme_type_id(&self) -> Option<UniqueId> {
         self.theme_type_id
@@ -23,9 +23,9 @@ impl<C: ComponentTrait> ActionDispatcher for BeforeRender<C> {
     }
 }
 
-impl<C: ComponentTrait> BeforeRender<C> {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción [`FnActionWithComponent`] para
-    /// un tema dado.
+impl<C: Component> BeforeRender<C> {
+    /// Permite [registrar](Extension::actions) una nueva acción [`FnActionWithComponent`] para un
+    /// tema dado.
     pub fn new(theme: ThemeRef, f: FnActionWithComponent<C>) -> Self {
         BeforeRender {
             f,
diff --git a/src/base/action/theme/prepare_render.rs b/src/base/action/theme/prepare_render.rs
index 9d3e261..4a1a2da 100644
--- a/src/base/action/theme/prepare_render.rs
+++ b/src/base/action/theme/prepare_render.rs
@@ -11,14 +11,14 @@ pub type FnPrepareRender<C> = fn(component: &C, cx: &mut Context) -> PrepareMark
 /// Ejecuta [`FnPrepareRender`] para preparar el renderizado de un componente.
 ///
 /// Permite a un tema hacer una implementación nueva del renderizado de un componente.
-pub struct PrepareRender<C: ComponentTrait> {
+pub struct PrepareRender<C: Component> {
     f: FnPrepareRender<C>,
     theme_type_id: Option<UniqueId>,
     referer_type_id: Option<UniqueId>,
 }
 
 /// Filtro para despachar [`FnPrepareRender`] que modifica el renderizado de un componente `C`.
-impl<C: ComponentTrait> ActionDispatcher for PrepareRender<C> {
+impl<C: Component> ActionDispatcher for PrepareRender<C> {
     /// Devuelve el identificador de tipo ([`UniqueId`]) del tema.
     fn theme_type_id(&self) -> Option<UniqueId> {
         self.theme_type_id
@@ -30,9 +30,9 @@ impl<C: ComponentTrait> ActionDispatcher for PrepareRender<C> {
     }
 }
 
-impl<C: ComponentTrait> PrepareRender<C> {
-    /// Permite [registrar](ExtensionTrait::actions) una nueva acción [`FnPrepareRender`] para un
-    /// tema dado.
+impl<C: Component> PrepareRender<C> {
+    /// Permite [registrar](Extension::actions) una nueva acción [`FnPrepareRender`] para un tema
+    /// dado.
     pub fn new(theme: ThemeRef, f: FnPrepareRender<C>) -> Self {
         PrepareRender {
             f,
diff --git a/src/base/component/html.rs b/src/base/component/html.rs
index 228bfe8..1f49b05 100644
--- a/src/base/component/html.rs
+++ b/src/base/component/html.rs
@@ -38,7 +38,7 @@ impl Default for Html {
         Html::with(|_| html! {})
     }
 }
-impl ComponentTrait for Html {
+impl Component for Html {
     fn new() -> Self {
         Html::default()
     }
diff --git a/src/base/extension/welcome.rs b/src/base/extension/welcome.rs
index 39edfd3..3dda43e 100644
--- a/src/base/extension/welcome.rs
+++ b/src/base/extension/welcome.rs
@@ -7,7 +7,7 @@ use crate::prelude::*;
 /// funcionando correctamente.
 pub struct Welcome;
 
-impl ExtensionTrait for Welcome {
+impl Extension for Welcome {
     fn name(&self) -> L10n {
         L10n::l("welcome_extension_name")
     }
diff --git a/src/base/theme/basic.rs b/src/base/theme/basic.rs
index 4ea2460..b02abfb 100644
--- a/src/base/theme/basic.rs
+++ b/src/base/theme/basic.rs
@@ -5,13 +5,13 @@ use crate::prelude::*;
 /// Tema básico por defecto.
 pub struct Basic;
 
-impl ExtensionTrait for Basic {
+impl Extension for Basic {
     fn theme(&self) -> Option<ThemeRef> {
         Some(&Self)
     }
 }
 
-impl ThemeTrait for Basic {
+impl Theme for Basic {
     fn after_render_page_body(&self, page: &mut Page) {
         page.alter_assets(AssetsOp::AddStyleSheet(
             StyleSheet::from("/css/normalize.css")
diff --git a/src/core/action.rs b/src/core/action.rs
index f5dc11c..91847b0 100644
--- a/src/core/action.rs
+++ b/src/core/action.rs
@@ -25,7 +25,7 @@ pub use all::dispatch_actions;
 /// ```rust,ignore
 /// use pagetop::prelude::*;
 ///
-/// impl ExtensionTrait for MyTheme {
+/// impl Extension for MyTheme {
 ///     fn actions(&self) -> Vec<ActionBox> {
 ///         actions_boxed![
 ///             action::theme::BeforeRender::<Button>::new(&Self, before_render_button),
@@ -34,7 +34,7 @@ pub use all::dispatch_actions;
 ///     }
 /// }
 ///
-/// impl ThemeTrait for MyTheme {}
+/// impl Theme for MyTheme {}
 ///
 /// fn before_render_button(c: &mut Button, cx: &mut Context) { todo!() }
 /// fn render_error404(c: &Error404, cx: &mut Context) -> PrepareMarkup { todo!() }
diff --git a/src/core/component.rs b/src/core/component.rs
index 36c789a..17b9b73 100644
--- a/src/core/component.rs
+++ b/src/core/component.rs
@@ -1,7 +1,7 @@
 //! API para construir nuevos componentes.
 
 mod definition;
-pub use definition::{ComponentRender, ComponentTrait};
+pub use definition::{Component, ComponentRender};
 
 mod children;
 pub use children::Children;
diff --git a/src/core/component/children.rs b/src/core/component/children.rs
index c5b65a2..fb85db7 100644
--- a/src/core/component/children.rs
+++ b/src/core/component/children.rs
@@ -1,4 +1,4 @@
-use crate::core::component::ComponentTrait;
+use crate::core::component::Component;
 use crate::html::{html, Context, Markup};
 use crate::{builder_fn, UniqueId};
 
@@ -9,14 +9,14 @@ use std::vec::IntoIter;
 
 /// Representa un componente encapsulado de forma segura y compartida.
 ///
-/// Esta estructura permite manipular y renderizar cualquier tipo que implemente [`ComponentTrait`],
+/// Esta estructura permite manipular y renderizar cualquier tipo que implemente [`Component`],
 /// garantizando acceso concurrente a través de [`Arc<RwLock<_>>`].
 #[derive(Clone)]
-pub struct Child(Arc<RwLock<dyn ComponentTrait>>);
+pub struct Child(Arc<RwLock<dyn Component>>);
 
 impl Child {
     /// Crea un nuevo [`Child`] a partir de un componente.
-    pub fn with(component: impl ComponentTrait) -> Self {
+    pub fn with(component: impl Component) -> Self {
         Child(Arc::new(RwLock::new(component)))
     }
 
@@ -47,15 +47,15 @@ impl Child {
 /// Variante tipada de [`Child`] para evitar conversiones durante el uso.
 ///
 /// Facilita el acceso a componentes del mismo tipo sin necesidad de hacer `downcast`.
-pub struct Typed<C: ComponentTrait>(Arc<RwLock<C>>);
+pub struct Typed<C: Component>(Arc<RwLock<C>>);
 
-impl<C: ComponentTrait> Clone for Typed<C> {
+impl<C: Component> Clone for Typed<C> {
     fn clone(&self) -> Self {
         Self(self.0.clone())
     }
 }
 
-impl<C: ComponentTrait> Typed<C> {
+impl<C: Component> Typed<C> {
     /// Crea un nuevo [`Typed`] a partir de un componente.
     pub fn with(component: C) -> Self {
         Typed(Arc::new(RwLock::new(component)))
@@ -97,7 +97,7 @@ pub enum ChildOp {
 }
 
 /// Operaciones con un componente hijo tipado [`Typed<C>`] en una lista [`Children`].
-pub enum TypedOp<C: ComponentTrait> {
+pub enum TypedOp<C: Component> {
     Add(Typed<C>),
     InsertAfterId(&'static str, Typed<C>),
     InsertBeforeId(&'static str, Typed<C>),
@@ -153,7 +153,7 @@ impl Children {
 
     /// Ejecuta una operación con [`TypedOp`] en la lista.
     #[builder_fn]
-    pub fn with_typed<C: ComponentTrait + Default>(mut self, op: TypedOp<C>) -> Self {
+    pub fn with_typed<C: Component + Default>(mut self, op: TypedOp<C>) -> Self {
         match op {
             TypedOp::Add(typed) => self.add(typed.into_child()),
             TypedOp::InsertAfterId(id, typed) => self.insert_after_id(id, typed.into_child()),
diff --git a/src/core/component/definition.rs b/src/core/component/definition.rs
index a9a4f81..e64e616 100644
--- a/src/core/component/definition.rs
+++ b/src/core/component/definition.rs
@@ -5,7 +5,7 @@ use crate::html::{html, Context, Markup, PrepareMarkup, Render};
 /// Define la función de renderizado para todos los componentes.
 ///
 /// Este *trait* se implementa automáticamente en cualquier tipo (componente) que implemente
-/// [`ComponentTrait`], por lo que no requiere ninguna codificación manual.
+/// [`Component`], por lo que no requiere ninguna codificación manual.
 pub trait ComponentRender {
     /// Renderiza el componente usando el contexto proporcionado.
     fn render(&mut self, cx: &mut Context) -> Markup;
@@ -86,7 +86,7 @@ pub trait ComponentTrait: AnyInfo + ComponentRender + Send + Sync {
 /// 7. Despacha [`action::component::AfterRender<C>`](crate::base::action::component::AfterRender)
 ///    para que otras extensiones puedan hacer sus últimos ajustes.
 /// 8. Finalmente devuelve un [`Markup`] del renderizado preparado en el paso 5.
-impl<C: ComponentTrait> ComponentRender for C {
+impl<C: Component> ComponentRender for C {
     fn render(&mut self, cx: &mut Context) -> Markup {
         // Si no es renderizable, devuelve un bloque HTML vacío.
         if !action::component::IsRenderable::dispatch(self, cx) {
diff --git a/src/core/extension.rs b/src/core/extension.rs
index c493cf5..cabae5c 100644
--- a/src/core/extension.rs
+++ b/src/core/extension.rs
@@ -1,9 +1,9 @@
 //! API para añadir nuevas funcionalidades usando extensiones.
 //!
 //! Cada funcionalidad adicional que quiera incorporarse a una aplicación `PageTop` se debe modelar
-//! como una **extensión**. Todas comparten la misma interfaz declarada en [`ExtensionTrait`].
+//! como una **extensión**. Todas comparten la misma interfaz declarada en [`Extension`].
 
 mod definition;
-pub use definition::{ExtensionRef, ExtensionTrait};
+pub use definition::{Extension, ExtensionRef};
 
 pub(crate) mod all;
diff --git a/src/core/extension/definition.rs b/src/core/extension/definition.rs
index 2d9f6dd..195e2e5 100644
--- a/src/core/extension/definition.rs
+++ b/src/core/extension/definition.rs
@@ -8,7 +8,7 @@ use crate::{actions_boxed, service};
 ///
 /// Las extensiones se definen como instancias estáticas globales para poder acceder a ellas desde
 /// cualquier hilo de la ejecución sin necesidad de sincronización adicional.
-pub type ExtensionRef = &'static dyn ExtensionTrait;
+pub type ExtensionRef = &'static dyn Extension;
 
 /// Interfaz común que debe implementar cualquier extensión de `PageTop`.
 ///
@@ -20,12 +20,12 @@ pub type ExtensionRef = &'static dyn ExtensionTrait;
 ///
 /// pub struct Blog;
 ///
-/// impl ExtensionTrait for Blog {
+/// impl Extension for Blog {
 ///     fn name(&self) -> L10n { L10n::n("Blog") }
 ///     fn description(&self) -> L10n { L10n::n("Sistema de blogs") }
 /// }
 /// ```
-pub trait ExtensionTrait: AnyInfo + Send + Sync {
+pub trait Extension: AnyInfo + Send + Sync {
     /// Nombre legible para el usuario.
     ///
     /// Predeterminado por el [`short_name`](AnyInfo::short_name) del tipo asociado a la extensión.
@@ -38,8 +38,8 @@ pub trait ExtensionTrait: AnyInfo + Send + Sync {
         L10n::default()
     }
 
-    /// Los temas son extensiones que implementan [`ExtensionTrait`] y también
-    /// [`ThemeTrait`](crate::core::theme::ThemeTrait).
+    /// Los temas son extensiones que implementan [`Extension`] y también
+    /// [`Theme`](crate::core::theme::Theme).
     ///
     /// Si la extensión no es un tema, este método devuelve `None` por defecto.
     ///
@@ -51,13 +51,13 @@ pub trait ExtensionTrait: AnyInfo + Send + Sync {
     ///
     /// pub struct MyTheme;
     ///
-    /// impl ExtensionTrait for MyTheme {
+    /// impl Extension for MyTheme {
     ///     fn theme(&self) -> Option<ThemeRef> {
     ///         Some(&Self)
     ///     }
     /// }
     ///
-    /// impl ThemeTrait for MyTheme {}
+    /// impl Theme for MyTheme {}
     /// ```
     fn theme(&self) -> Option<ThemeRef> {
         None
@@ -94,7 +94,7 @@ pub trait ExtensionTrait: AnyInfo + Send + Sync {
     ///
     /// pub struct ExtensionSample;
     ///
-    /// impl ExtensionTrait for ExtensionSample {
+    /// impl Extension for ExtensionSample {
     ///     fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
     ///         scfg.route("/sample", web::get().to(route_sample));
     ///     }
diff --git a/src/core/theme.rs b/src/core/theme.rs
index 35d9887..0a0f819 100644
--- a/src/core/theme.rs
+++ b/src/core/theme.rs
@@ -9,13 +9,12 @@
 //! tipografías, espaciados y cualquier otro detalle visual o de comportamiento (como animaciones,
 //! *scripts* de interfaz, etc.).
 //!
-//! Es una extensión más (implementando [`ExtensionTrait`](crate::core::extension::ExtensionTrait)).
-//! Se instala, activa y declara dependencias igual que el resto de extensiones; y se señala a sí
-//! misma como tema (implementando [`theme()`](crate::core::extension::ExtensionTrait::theme)
-//! y [`ThemeTrait`]).
+//! Es una extensión más (implementando [`Extension`](crate::core::extension::Extension)). Se
+//! instala, activa y declara dependencias igual que el resto de extensiones; y se señala a sí misma
+//! como tema (implementando [`theme()`](crate::core::extension::Extension::theme) y [`Theme`]).
 
 mod definition;
-pub use definition::{ThemeRef, ThemeTrait};
+pub use definition::{Theme, ThemeRef};
 
 mod regions;
 pub(crate) use regions::ChildrenInRegions;
diff --git a/src/core/theme/definition.rs b/src/core/theme/definition.rs
index 075ce20..8de88bd 100644
--- a/src/core/theme/definition.rs
+++ b/src/core/theme/definition.rs
@@ -1,4 +1,4 @@
-use crate::core::extension::ExtensionTrait;
+use crate::core::extension::Extension;
 use crate::core::theme::CONTENT_REGION_NAME;
 use crate::global;
 use crate::html::{html, Markup};
@@ -8,20 +8,20 @@ use crate::response::page::Page;
 /// Representa una referencia a un tema.
 ///
 /// Los temas son también extensiones. Por tanto se deben definir igual, es decir, como instancias
-/// estáticas globales que implementan [`ThemeTrait`], pero también [`ExtensionTrait`].
-pub type ThemeRef = &'static dyn ThemeTrait;
+/// estáticas globales que implementan [`Theme`], pero también [`Extension`].
+pub type ThemeRef = &'static dyn Theme;
 
 /// Interfaz común que debe implementar cualquier tema de `PageTop`.
 ///
-/// Un tema implementará [`ThemeTrait`] y los métodos que sean necesarios de [`ExtensionTrait`],
-/// aunque el único obligatorio es [`theme()`](ExtensionTrait::theme).
+/// Un tema implementará [`Theme`] y los métodos que sean necesarios de [`Extension`], aunque el
+/// único obligatorio es [`theme()`](Extension::theme).
 ///
 /// ```rust
 /// use pagetop::prelude::*;
 ///
 /// pub struct MyTheme;
 ///
-/// impl ExtensionTrait for MyTheme {
+/// impl Extension for MyTheme {
 ///     fn name(&self) -> L10n { L10n::n("My theme") }
 ///     fn description(&self) -> L10n { L10n::n("Un tema personal") }
 ///
@@ -30,9 +30,9 @@ pub type ThemeRef = &'static dyn ThemeTrait;
 ///     }
 /// }
 ///
-/// impl ThemeTrait for MyTheme {}
+/// impl Theme for MyTheme {}
 /// ```
-pub trait ThemeTrait: ExtensionTrait + Send + Sync {
+pub trait Theme: Extension + Send + Sync {
     fn regions(&self) -> Vec<(&'static str, L10n)> {
         vec![(CONTENT_REGION_NAME, L10n::l("content"))]
     }
diff --git a/src/html/opt_component.rs b/src/html/opt_component.rs
index 9e116cd..39106d9 100644
--- a/src/html/opt_component.rs
+++ b/src/html/opt_component.rs
@@ -1,5 +1,5 @@
 use crate::builder_fn;
-use crate::core::component::{ComponentTrait, Typed};
+use crate::core::component::{Component, Typed};
 use crate::html::{html, Context, Markup};
 
 /// Contenedor de componente para incluir en otros componentes.
@@ -16,15 +16,15 @@ use crate::html::{html, Context, Markup};
 /// let opt = OptionComponent::new(comp);
 /// assert!(opt.get().is_some());
 /// ```
-pub struct OptionComponent<C: ComponentTrait>(Option<Typed<C>>);
+pub struct OptionComponent<C: Component>(Option<Typed<C>>);
 
-impl<C: ComponentTrait> Default for OptionComponent<C> {
+impl<C: Component> Default for OptionComponent<C> {
     fn default() -> Self {
         OptionComponent(None)
     }
 }
 
-impl<C: ComponentTrait> OptionComponent<C> {
+impl<C: Component> OptionComponent<C> {
     /// Crea un nuevo [`OptionComponent`].
     ///
     /// El componente se envuelve automáticamente en un [`Typed`] y se almacena.
diff --git a/src/response/page.rs b/src/response/page.rs
index c1815d0..1b1c0de 100644
--- a/src/response/page.rs
+++ b/src/response/page.rs
@@ -5,7 +5,7 @@ pub use actix_web::Result as ResultPage;
 
 use crate::base::action;
 use crate::builder_fn;
-use crate::core::component::{Child, ChildOp, ComponentTrait};
+use crate::core::component::{Child, ChildOp, Component};
 use crate::core::theme::{ChildrenInRegions, ThemeRef, CONTENT_REGION_NAME};
 use crate::html::{html, AssetsOp, Context, Markup, DOCTYPE};
 use crate::html::{ClassesOp, OptionClasses, OptionId, OptionTranslated};
@@ -121,7 +121,7 @@ impl Page {
     }
 
     /// Añade un componente a la región de contenido por defecto.
-    pub fn with_component(mut self, component: impl ComponentTrait) -> Self {
+    pub fn with_component(mut self, component: impl Component) -> Self {
         self.regions
             .alter_child_in_region(CONTENT_REGION_NAME, ChildOp::Add(Child::with(component)));
         self
@@ -131,7 +131,7 @@ impl Page {
     pub fn with_component_in(
         mut self,
         region_name: &'static str,
-        component: impl ComponentTrait,
+        component: impl Component,
     ) -> Self {
         self.regions
             .alter_child_in_region(region_name, ChildOp::Add(Child::with(component)));
diff --git a/src/service.rs b/src/service.rs
index 68c8d5d..261955c 100644
--- a/src/service.rs
+++ b/src/service.rs
@@ -88,7 +88,7 @@ macro_rules! include_files {
 ///
 /// pub struct MyExtension;
 ///
-/// impl ExtensionTrait for MyExtension {
+/// impl Extension for MyExtension {
 ///     fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
 ///         include_files_service!(scfg, assets => "/public");
 ///     }

From 223a98569bb440572e0dbb05b9f85023fce6d22f Mon Sep 17 00:00:00 2001
From: Manuel Cillero <manuel@cillero.es>
Date: Sun, 3 Aug 2025 13:36:00 +0200
Subject: [PATCH 2/2] =?UTF-8?q?=F0=9F=92=A1=20Retoques=20menores=20en=20co?=
 =?UTF-8?q?mentarios=20para=20documentar?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 helpers/pagetop-macros/src/lib.rs |  2 +-
 src/app.rs                        |  8 ++++----
 src/base/component/html.rs        | 10 +++++-----
 src/core/action.rs                |  3 +--
 src/core/component/definition.rs  | 14 +++++++-------
 src/core/extension/definition.rs  |  3 ++-
 src/core/theme/all.rs             |  2 +-
 src/global.rs                     |  4 ++--
 src/html/assets/favicon.rs        |  4 ++--
 src/html/assets/javascript.rs     |  4 ++--
 src/html/assets/stylesheet.rs     |  4 ++--
 src/html/context.rs               |  6 +++---
 src/locale.rs                     |  4 ++--
 src/response/page.rs              |  6 +++---
 src/service.rs                    |  3 ++-
 15 files changed, 39 insertions(+), 38 deletions(-)

diff --git a/helpers/pagetop-macros/src/lib.rs b/helpers/pagetop-macros/src/lib.rs
index 301f483..b9be0be 100644
--- a/helpers/pagetop-macros/src/lib.rs
+++ b/helpers/pagetop-macros/src/lib.rs
@@ -175,7 +175,7 @@ pub fn builder_fn(_: TokenStream, item: TokenStream) -> TokenStream {
 
     // Genera el método alter_...() con el código del método with_...().
     let fn_alter_doc = format!(
-        "Igual que [`{0}()`](Self::{0}), pero sin usar el patrón *builder*.",
+        "Igual que [`Self::{0}()`](Self::{0}), pero sin usar el patrón *builder*.",
         fn_with_name_str,
     );
     let fn_alter = quote! {
diff --git a/src/app.rs b/src/app.rs
index 6b11c0f..c3576fc 100644
--- a/src/app.rs
+++ b/src/app.rs
@@ -16,10 +16,10 @@ use std::sync::LazyLock;
 
 /// Punto de entrada de una aplicación `PageTop`.
 ///
-/// No almacena datos, pero **encapsula** el ciclo completo de configuración y puesta en marcha.
-/// Para instanciarla se puede usar [`new`](Application::new) o [`prepare`](Application::prepare).
-/// Después sólo hay que llamar a [`run`](Application::run) (o a [`test`](Application::test) si se
-/// está preparando un entorno de pruebas).
+/// No almacena datos, **encapsula** el inicio completo de configuración y puesta en marcha. Para
+/// instanciarla se puede usar [`new()`](Application::new) o [`prepare()`](Application::prepare).
+/// Después sólo hay que llamar a [`run()`](Application::run) para ejecutar la aplicación (o a
+/// [`test()`](Application::test) si se está preparando un entorno de pruebas).
 pub struct Application;
 
 impl Default for Application {
diff --git a/src/base/component/html.rs b/src/base/component/html.rs
index 1f49b05..8f273ed 100644
--- a/src/base/component/html.rs
+++ b/src/base/component/html.rs
@@ -51,9 +51,9 @@ impl Component for Html {
 impl Html {
     /// Crea una instancia que generará el `Markup`, con acceso opcional al contexto.
     ///
-    /// El método [`prepare_component`](crate::core::component::ComponentTrait::prepare_component)
-    /// delega el renderizado en la función proporcionada, que recibe una referencia mutable
-    /// al contexto de renderizado ([`Context`]).
+    /// El método [`prepare_component()`](crate::core::component::Component::prepare_component)
+    /// delega el renderizado en la función proporcionada, que recibe una referencia mutable al
+    /// contexto de renderizado ([`Context`]).
     pub fn with<F>(f: F) -> Self
     where
         F: Fn(&mut Context) -> Markup + Send + Sync + 'static,
@@ -64,8 +64,8 @@ impl Html {
     /// Sustituye la función que genera el `Markup`.
     ///
     /// Permite a otras extensiones modificar la función de renderizado que se ejecutará cuando
-    /// [`prepare_component`](crate::core::component::ComponentTrait::prepare_component) invoque
-    /// esta instancia. La nueva función también recibe una referencia al contexto ([`Context`]).
+    /// [`prepare_component()`](crate::core::component::Component::prepare_component) invoque esta
+    /// instancia. La nueva función también recibe una referencia al contexto ([`Context`]).
     pub fn alter_html<F>(&mut self, f: F) -> &mut Self
     where
         F: Fn(&mut Context) -> Markup + Send + Sync + 'static,
diff --git a/src/core/action.rs b/src/core/action.rs
index 91847b0..cbbe79c 100644
--- a/src/core/action.rs
+++ b/src/core/action.rs
@@ -14,8 +14,7 @@ mod all;
 pub(crate) use all::add_action;
 pub use all::dispatch_actions;
 
-/// Facilita la implementación del método
-/// [`actions()`](crate::core::extension::ExtensionTrait::actions).
+/// Facilita la implementación del método [`actions()`](crate::core::extension::Extension::actions).
 ///
 /// Evita escribir repetidamente `Box::new(...)` para cada acción de la lista, manteniendo el código
 /// más limpio.
diff --git a/src/core/component/definition.rs b/src/core/component/definition.rs
index e64e616..2818570 100644
--- a/src/core/component/definition.rs
+++ b/src/core/component/definition.rs
@@ -14,9 +14,9 @@ pub trait ComponentRender {
 /// Interfaz común que debe implementar un componente renderizable en `PageTop`.
 ///
 /// Se recomienda que los componentes deriven [`AutoDefault`](crate::AutoDefault). También deben
-/// implementar explícitamente el método [`new`](Self::new) y pueden sobrescribir los otros métodos
-/// para personalizar su comportamiento.
-pub trait ComponentTrait: AnyInfo + ComponentRender + Send + Sync {
+/// implementar explícitamente el método [`new()`](Self::new) y pueden sobrescribir los otros
+/// métodos para personalizar su comportamiento.
+pub trait Component: AnyInfo + ComponentRender + Send + Sync {
     /// Crea una nueva instancia del componente.
     fn new() -> Self
     where
@@ -70,8 +70,8 @@ pub trait ComponentTrait: AnyInfo + ComponentRender + Send + Sync {
 ///
 /// 1. Despacha [`action::component::IsRenderable`](crate::base::action::component::IsRenderable)
 ///    para ver si se puede renderizar. Si no es así, devuelve un [`Markup`] vacío.
-/// 2. Ejecuta [`setup_before_prepare()`](ComponentTrait::setup_before_prepare) para que el
-///    componente pueda ajustar su estructura interna o modificar el contexto.
+/// 2. Ejecuta [`setup_before_prepare()`](Component::setup_before_prepare) para que el componente
+///    pueda ajustar su estructura interna o modificar el contexto.
 /// 3. Despacha [`action::theme::BeforeRender<C>`](crate::base::action::theme::BeforeRender) para
 ///    que el tema pueda hacer ajustes en el componente o el contexto.
 /// 4. Despacha [`action::component::BeforeRender<C>`](crate::base::action::component::BeforeRender)
@@ -79,8 +79,8 @@ pub trait ComponentTrait: AnyInfo + ComponentRender + Send + Sync {
 /// 5. **Prepara el renderizado del componente**:
 ///    - Despacha [`action::theme::PrepareRender<C>`](crate::base::action::theme::PrepareRender)
 ///      para permitir al tema preparar un renderizado diferente al predefinido.
-///    - Si no es así, ejecuta [`prepare_component()`](ComponentTrait::prepare_component) para
-///      preparar el renderizado predefinido del componente.
+///    - Si no es así, ejecuta [`prepare_component()`](Component::prepare_component) para preparar
+///      el renderizado predefinido del componente.
 /// 6. Despacha [`action::theme::AfterRender<C>`](crate::base::action::theme::AfterRender) para
 ///    que el tema pueda hacer sus últimos ajustes.
 /// 7. Despacha [`action::component::AfterRender<C>`](crate::base::action::component::AfterRender)
diff --git a/src/core/extension/definition.rs b/src/core/extension/definition.rs
index 195e2e5..ac29259 100644
--- a/src/core/extension/definition.rs
+++ b/src/core/extension/definition.rs
@@ -28,7 +28,8 @@ pub type ExtensionRef = &'static dyn Extension;
 pub trait Extension: AnyInfo + Send + Sync {
     /// Nombre legible para el usuario.
     ///
-    /// Predeterminado por el [`short_name`](AnyInfo::short_name) del tipo asociado a la extensión.
+    /// Predeterminado por el [`short_name()`](AnyInfo::short_name) del tipo asociado a la
+    /// extensión.
     fn name(&self) -> L10n {
         L10n::n(self.short_name())
     }
diff --git a/src/core/theme/all.rs b/src/core/theme/all.rs
index 787e0c9..ebb2848 100644
--- a/src/core/theme/all.rs
+++ b/src/core/theme/all.rs
@@ -19,7 +19,7 @@ pub static DEFAULT_THEME: LazyLock<ThemeRef> =
 
 // TEMA POR NOMBRE *********************************************************************************
 
-/// Devuelve el tema identificado por su [`short_name`](AnyInfo::short_name).
+// Devuelve el tema identificado por su [`short_name()`](AnyInfo::short_name).
 pub fn theme_by_short_name(short_name: &'static str) -> Option<ThemeRef> {
     let short_name = short_name.to_lowercase();
     match THEMES
diff --git a/src/global.rs b/src/global.rs
index 25a1781..ea659b8 100644
--- a/src/global.rs
+++ b/src/global.rs
@@ -53,8 +53,8 @@ pub struct App {
     /// Si no se especifica un valor válido, normalmente se usará el idioma devuelto por la
     /// implementación de [`LangId`](crate::locale::LangId) para [`Context`](crate::html::Context),
     /// en el siguiente orden: primero, el idioma establecido explícitamente con
-    /// [`Context::with_langid`](crate::html::Context::with_langid); si no se ha definido, se usará
-    /// el indicado en la cabecera `Accept-Language` del navegador; y, si ninguno aplica, se
+    /// [`Context::with_langid()`](crate::html::Context::with_langid); si no se ha definido, se
+    /// usará el indicado en la cabecera `Accept-Language` del navegador; y, si ninguno aplica, se
     /// empleará el idioma de respaldo ("en-US").
     pub language: String,
     /// Banner ASCII mostrado al inicio: *"Off"* (desactivado), *"Slant"*, *"Small"*, *"Speed"* o
diff --git a/src/html/assets/favicon.rs b/src/html/assets/favicon.rs
index d02794e..2af0173 100644
--- a/src/html/assets/favicon.rs
+++ b/src/html/assets/favicon.rs
@@ -12,8 +12,8 @@ use crate::AutoDefault;
 ///
 /// > **Nota**
 /// > Los archivos de los iconos deben estar disponibles en el servidor web de la aplicación. Pueden
-/// > incluirse en el proyecto utilizando [`include_files`](crate::include_files) y servirse con
-/// > [`include_files_service`](crate::include_files_service).
+/// > incluirse en el proyecto utilizando [`include_files!`](crate::include_files) y servirse con
+/// > [`include_files_service!`](crate::include_files_service).
 ///
 /// # Ejemplo
 ///
diff --git a/src/html/assets/javascript.rs b/src/html/assets/javascript.rs
index 882b3af..604e85a 100644
--- a/src/html/assets/javascript.rs
+++ b/src/html/assets/javascript.rs
@@ -30,8 +30,8 @@ enum Source {
 ///
 /// > **Nota**
 /// > Los archivos de los *scripts* deben estar disponibles en el servidor web de la aplicación.
-/// > Pueden incluirse en el proyecto utilizando [`include_files`](crate::include_files) y servirse
-/// > con [`include_files_service`](crate::include_files_service).
+/// > Pueden incluirse en el proyecto utilizando [`include_files!`](crate::include_files) y servirse
+/// > con [`include_files_service!`](crate::include_files_service).
 ///
 /// # Ejemplo
 ///
diff --git a/src/html/assets/stylesheet.rs b/src/html/assets/stylesheet.rs
index dca5d86..72a79a1 100644
--- a/src/html/assets/stylesheet.rs
+++ b/src/html/assets/stylesheet.rs
@@ -55,8 +55,8 @@ impl TargetMedia {
 ///
 /// > **Nota**
 /// > Las hojas de estilo CSS deben estar disponibles en el servidor web de la aplicación. Pueden
-/// > incluirse en el proyecto utilizando [`include_files`](crate::include_files) y servirse con
-/// > [`include_files_service`](crate::include_files_service).
+/// > incluirse en el proyecto utilizando [`include_files!`](crate::include_files) y servirse con
+/// > [`include_files_service!`](crate::include_files_service).
 ///
 /// # Ejemplo
 ///
diff --git a/src/html/context.rs b/src/html/context.rs
index 8aaeb4a..5fbb39b 100644
--- a/src/html/context.rs
+++ b/src/html/context.rs
@@ -163,7 +163,7 @@ impl Context {
 
     /// Modifica el tema que se usará para renderizar el documento.
     ///
-    /// Localiza el tema por su [`short_name`](crate::core::AnyInfo::short_name), y si no aplica
+    /// Localiza el tema por su [`short_name()`](crate::core::AnyInfo::short_name), y si no aplica
     /// ninguno entonces usará el tema por defecto.
     #[builder_fn]
     pub fn with_theme(mut self, theme_name: &'static str) -> Self {
@@ -301,8 +301,8 @@ impl Context {
 /// 4. Y si ninguna de las opciones anteriores aplica, se usa el idioma de respaldo (`"en-US"`).
 ///
 /// Resulta útil para usar un contexto ([`Context`]) como fuente de traducción en
-/// [`L10n::using`](crate::locale::L10n::using) o
-/// [`L10n::to_markup`](crate::locale::L10n::to_markup).
+/// [`L10n::using()`](crate::locale::L10n::using) o
+/// [`L10n::to_markup()`](crate::locale::L10n::to_markup).
 impl LangId for Context {
     fn langid(&self) -> &'static LanguageIdentifier {
         self.langid
diff --git a/src/locale.rs b/src/locale.rs
index d81243e..f23f51e 100644
--- a/src/locale.rs
+++ b/src/locale.rs
@@ -259,8 +259,8 @@ impl LangMatch {
 /// devuelve el idioma por defecto de la aplicación y, si tampoco está disponible, el idioma de
 /// respaldo ("en-US").
 ///
-/// Resulta útil para usar un valor de [`LangMatch`] como fuente de traducción en [`L10n::using`] o
-/// [`L10n::to_markup`].
+/// Resulta útil para usar un valor de [`LangMatch`] como fuente de traducción en [`L10n::using()`]
+/// o [`L10n::to_markup()`].
 impl LangId for LangMatch {
     fn langid(&self) -> &'static LanguageIdentifier {
         match self {
diff --git a/src/response/page.rs b/src/response/page.rs
index 1b1c0de..44cab72 100644
--- a/src/response/page.rs
+++ b/src/response/page.rs
@@ -78,21 +78,21 @@ impl Page {
         self
     }
 
-    /// Modifica la fuente de idioma de la página ([`Context::with_langid`]).
+    /// Modifica la fuente de idioma de la página ([`Context::with_langid()`]).
     #[builder_fn]
     pub fn with_langid(mut self, language: &impl LangId) -> Self {
         self.context.alter_langid(language);
         self
     }
 
-    /// Modifica el tema que se usará para renderizar la página ([`Context::with_theme`]).
+    /// Modifica el tema que se usará para renderizar la página ([`Context::with_theme()`]).
     #[builder_fn]
     pub fn with_theme(mut self, theme_name: &'static str) -> Self {
         self.context.alter_theme(theme_name);
         self
     }
 
-    /// Modifica la composición para renderizar la página ([`Context::with_layout`]).
+    /// Modifica la composición para renderizar la página ([`Context::with_layout()`]).
     #[builder_fn]
     pub fn with_layout(mut self, layout_name: &'static str) -> Self {
         self.context.alter_layout(layout_name);
diff --git a/src/service.rs b/src/service.rs
index 261955c..89ba496 100644
--- a/src/service.rs
+++ b/src/service.rs
@@ -77,7 +77,8 @@ macro_rules! include_files {
 /// * `$route` – Ruta URL de origen desde la que se servirán los archivos.
 /// * `[ $root, $relative ]` *(opcional)* – Directorio raíz y ruta relativa para construir la ruta
 ///   absoluta donde buscar los archivos en el sistema de ficheros (ver
-///   [`absolute_dir`](crate::util::absolute_dir)). Si no existe, se usarán los recursos embebidos.
+///   [`absolute_dir()`](crate::util::absolute_dir)). Si no existe, se usarán los recursos
+///   embebidos.
 ///
 /// # Ejemplos
 ///