🎨 [pagetop] Mejoras sencillas en doc. y código

src/base/component.rs

@@ -1,6 +1,6 @@
 //! Componentes nativos proporcionados por PageTop.
 
-use crate::AutoDefault;
+use crate::prelude::*;
 
 use std::fmt;
 

src/config.rs

@@ -23,9 +23,9 @@
 //!    * Si `PAGETOP_RUN_MODE` no está definida, se asume el valor `default`, y PageTop intentará
 //!      cargar *config/default.toml* si el archivo existe.
 //!
-//!    * Útil para definir configuraciones específicas por entorno, garantizando que cada uno (p.ej.
+//!    * Permite definir configuraciones específicas por entorno, garantizando que cada uno (p. ej.,
-//!      *dev*, *staging* o *production*) disponga de sus propias opciones, como claves de API,
+//!      *dev*, *staging* o *production*) disponga de sus propias opciones, como claves de API, URLs
-//!      URLs o ajustes de rendimiento, sin afectar a los demás.
+//!      o ajustes de rendimiento, sin afectar a los demás.
 //!
 //! 3. **config/local.{rm}.toml**, útil para configuraciones locales específicas de la máquina o de
 //!    la ejecución:
@@ -132,15 +132,15 @@ pub static CONFIG_VALUES: LazyLock<ConfigBuilder<DefaultState>> = LazyLock::new(
     let config_dir = util::resolve_absolute_dir(&dir).unwrap_or_else(|_| PathBuf::from(&dir));
 
     // Modo de ejecución según la variable de entorno PAGETOP_RUN_MODE. Si no está definida, se usa
-    // por defecto, DEFAULT_RUN_MODE (p.ej.: PAGETOP_RUN_MODE=production).
+    // por defecto DEFAULT_RUN_MODE (p. ej. PAGETOP_RUN_MODE=production).
     let rm = env::var("PAGETOP_RUN_MODE").unwrap_or_else(|_| DEFAULT_RUN_MODE.into());
 
     Config::builder()
         // 1. Configuración común para todos los entornos (common.toml).
         .add_source(File::from(config_dir.join("common.toml")).required(false))
-        // 2. Configuración específica del entorno (p.ej.: default.toml, production.toml).
+        // 2. Configuración específica del entorno (p. ej. default.toml o production.toml).
         .add_source(File::from(config_dir.join(format!("{rm}.toml"))).required(false))
-        // 3. Configuración local reservada para cada entorno (p.ej.: local.default.toml).
+        // 3. Configuración local reservada para cada entorno (p. ej. local.default.toml).
         .add_source(File::from(config_dir.join(format!("local.{rm}.toml"))).required(false))
         // 4. Configuración local común (local.toml).
         .add_source(File::from(config_dir.join("local.toml")).required(false))
@@ -229,9 +229,7 @@ pub static CONFIG_VALUES: LazyLock<ConfigBuilder<DefaultState>> = LazyLock::new(
 macro_rules! include_config {
     ( $SETTINGS_NAME:ident : $Settings_Type:ty => [ $( $k:literal => $v:expr ),* $(,)? ] ) => {
         #[doc = concat!(
-            "Referencia y valores por defecto de los ajustes de configuración para [`",
+            "Instancia los ajustes de configuración para [`", stringify!($Settings_Type), "`]."
-            stringify!($Settings_Type),
-            "`]."
         )]
         #[doc = ""]
         #[doc = "Valores por defecto:"]

src/core/action/definition.rs

@@ -24,7 +24,8 @@ impl ActionKey {
     /// - `action_type_id`: Tipo de la acción.
     /// - `theme_type_id`: Opcional, identificador de tipo ([`UniqueId`]) del tema asociado.
     /// - `referer_type_id`: Opcional, identificador de tipo ([`UniqueId`]) del componente referido.
-    /// - `referer_id`: Opcional, identificador de la instancia (p.ej. para un formulario concreto).
+    /// - `referer_id`: Opcional, identificador de la instancia (p. ej. para asociar la acción a un
+    ///   componente concreto).
     ///
     /// Esta clave permitirá seleccionar las funciones a ejecutar para ese tipo de acción, con
     /// filtros opcionales por tema, componente, o una instancia concreta según su identificador.

src/global.rs

@@ -30,7 +30,7 @@ include_config!(SETTINGS: Settings => [
 ]);
 
 #[derive(Debug, Deserialize)]
-/// Ajustes para las secciones globales [`[app]`](App), [`[dev]`](Dev), [`[log]`](Log) y
+/// Tipos para las secciones globales [`[app]`](App), [`[dev]`](Dev), [`[log]`](Log) y
 /// [`[server]`](Server) de [`SETTINGS`].
 pub struct Settings {
     pub app: App,
@@ -105,7 +105,7 @@ pub struct Server {
     pub bind_address: String,
     /// Puerto de escucha del servidor web.
     pub bind_port: u16,
-    /// Duración de la cookie de sesión en segundos (p.ej. `604_800` para una semana).
+    /// Duración de la cookie de sesión en segundos (p. ej., `604_800` para una semana).
     ///
     /// El valor `0` indica que la cookie permanecerá activa hasta que se cierre el navegador.
     pub session_lifetime: i64,

src/html/unit.rs

@@ -34,8 +34,8 @@ use std::str::FromStr;
 ///
 /// - Soporta unidades **absolutas** (`cm`, `in`, `mm`, `pc`, `pt`, `px`) y **relativas** (`em`,
 ///   `rem`, `%`, `vh`, `vw`).
-/// - `FromStr` para convertir desde texto (p.ej. `"12px"`, `"1.25rem"`, `"auto"`).
+/// - `FromStr` para convertir desde texto (p. ej., `"12px"`, `"1.25rem"`, `"auto"`).
-/// - `Display` para formatear a cadena (p.ej. `UnitValue::Px(12)` genera `"12px"`).
+/// - `Display` para formatear a cadena (p. ej., `UnitValue::Px(12)` genera `"12px"`).
 /// - `Deserialize` delega en `FromStr`, garantizando una gramática única.
 ///
 /// ## Ejemplos
@@ -107,26 +107,25 @@ pub enum UnitValue {
 }
 
 impl UnitValue {
-    /// Indica si el valor es **numérico**.
+    /// Indica si el valor es **medible**, incluyendo `Zero` sin unidad.
     ///
-    /// Devuelve `true` para `Zero` y las unidades absolutas/relativas, y `false` para
+    /// Devuelve `false` para [`UnitValue::None`] y [`UnitValue::Auto`].
-    /// [`UnitValue::None`] y [`UnitValue::Auto`].
     ///
     /// # Ejemplos
     ///
     /// ```rust
     /// # use pagetop::prelude::*;
     /// // Numéricos (incluido el cero sin unidad).
-    /// assert!(UnitValue::Zero.is_numeric());
+    /// assert!(UnitValue::Zero.is_measurable());
-    /// assert!(UnitValue::Px(0).is_numeric());
+    /// assert!(UnitValue::Px(0).is_measurable());
-    /// assert!(UnitValue::Px(10).is_numeric());
+    /// assert!(UnitValue::Px(10).is_measurable());
-    /// assert!(UnitValue::RelPct(33.0).is_numeric());
+    /// assert!(UnitValue::RelPct(33.0).is_measurable());
     /// // No numéricos.
-    /// assert!(!UnitValue::None.is_numeric());
+    /// assert!(!UnitValue::None.is_measurable());
-    /// assert!(!UnitValue::Auto.is_numeric());
+    /// assert!(!UnitValue::Auto.is_measurable());
     /// ```
     #[inline]
-    pub const fn is_numeric(&self) -> bool {
+    pub const fn is_measurable(&self) -> bool {
         !matches!(self, UnitValue::None | UnitValue::Auto)
     }
 }
@@ -173,9 +172,9 @@ impl fmt::Display for UnitValue {
 /// - `""` para `UnitValue::None`
 /// - `"auto"`
 /// - **Cero sin unidad**: `"0"`, `"+0"`, `"-0"`, `"0.0"`, `"0."`, `".0"` para `UnitValue::Zero`
-/// - Porcentaje: `"<n>%"` (p.ej. `"33%"`, `"33 %"`)
+/// - Porcentaje: `"<n>%"` (p. ej., `"33%"`, `"33 %"`)
-/// - Absolutas enteras: `"<entero><unidad>"`, p.ej. `"12px"`, `"-5pt"`
+/// - Absolutas enteras: `"<entero><unidad>"`, p. ej., `"12px"`, `"-5pt"`
-/// - Relativas decimales: `"<float><unidad>"`, p.ej. `"1.25rem"`, `"-0.5vh"`, `".5em"`, `"1.rem"`
+/// - Relativas decimales: `"<float><unidad>"`, p. ej., `"1.25rem"`, `"-0.5vh"`, `".5em"`, `"1.rem"`
 ///
 /// (Se toleran espacios entre número y unidad: `"12 px"`, `"1.5  rem"`).
 ///
@@ -191,9 +190,9 @@ impl fmt::Display for UnitValue {
 ///
 /// ## Errores de interpretación
 ///
-/// - Falta la unidad cuando es necesaria (p.ej. `"12"`, excepto para el valor cero).
+/// - Falta la unidad cuando es necesaria (p. ej., `"12"`, excepto para el valor cero).
 /// - Decimales en valores que deben ser absolutos (p. ej. `"1.5px"`).
-/// - Unidades desconocidas (p.ej. `"10ch"`, no soportada aún).
+/// - Unidades desconocidas (p. ej., `"10ch"`, no soportada aún).
 /// - Notación científica o bases no decimales: `"1e3vw"`, `"0x10px"` (no soportadas). Los ceros a
 ///   la izquierda (p. ej. `"020px"`) se interpretan en **base 10** (`20px`).
 ///

src/locale.rs

@@ -375,7 +375,7 @@ impl L10n {
         }
     }
 
-    /// Añade un argumento `{$arg}` → `value` a la traducción.
+    /// Añade un argumento `{$arg}` => `value` a la traducción.
     pub fn with_arg(mut self, arg: impl Into<String>, value: impl Into<String>) -> Self {
         self.args.insert(arg.into(), value.into());
         self

tests/html_unit.rs

@@ -217,7 +217,7 @@ async fn unit_value_display_keeps_minus_zero_for_relatives() {
 async fn unit_value_rejects_non_decimal_notations() {
     // Octal, los ceros a la izquierda (p. ej. `"020px"`) se interpretan en **base 10** (`20px`).
     assert_eq!(UnitValue::from_str("020px").unwrap(), UnitValue::Px(20));
-    // Notación científica y bases no decimales (p.ej. `"1e3vw"`, `"0x10px"`) no están soportadas.
+    // Notación científica y bases no decimales (p. ej., `"1e3vw"`, `"0x10px"`) no están soportadas.
     assert!(UnitValue::from_str("1e3vw").is_err());
     assert!(UnitValue::from_str("0x10px").is_err());
 }