🚧 (theme): Renombra variantes de Intent

Renombra `Intent::Secondary`/`Danger` a `Neutral`/`Severe` y actualiza
Badge y su CSS por defecto (basic.css) al nuevo vocabulario.

Introduce el punto de extensión `Theme::intent_color()`, que traduce una
`Intent` al nombre de color de la paleta propia de cada tema, con
`Intent::color(cx)` como atajo de uso desde los componentes.
This commit is contained in:
Manuel Cillero 2026-08-28 01:10:45 +02:00
parent af53cd4b52
commit 56a6691c87
6 changed files with 116 additions and 61 deletions

View file

@ -3,7 +3,7 @@ use crate::base::component::{Html, Intro, IntroOpening, layout};
use crate::core::component::{ChildOp, Component, ComponentError, ComponentRender};
use crate::core::component::{Context, Contextual};
use crate::core::extension::Extension;
use crate::core::theme::CoreRegions;
use crate::core::theme::{CoreRegions, Intent};
use crate::global;
use crate::html::{Markup, html};
use crate::locale::Lc;
@ -65,6 +65,34 @@ pub trait Theme: Extension + Send + Sync {
None
}
/// Traduce una [`Intent`] al nombre de color de la paleta propia del tema.
///
/// `Intent` no define ninguna cadena propia. Cada tema decide qué nombre le corresponde a cada
/// variante en su paleta (p. ej. un tema basado en Bootstrap traduce `Severe` a `"danger"`).
/// Los componentes que generan clases CSS a partir de una `Intent` (`Button`, `Badge`,
/// `Dropdown`, etc.) no llaman a este método directamente en su `setup()`, usan mejor
/// [`Intent::color()`](crate::core::theme::Intent::color) como la forma más sencilla de obtener
/// este mismo valor a través de [`Context::theme()`](crate::core::component::Context::theme),
/// para que la clase resultante ya nazca en la paleta del tema activo.
///
/// La implementación por defecto devuelve el vocabulario semántico propio de PageTop
/// (`"primary"`, `"severe"`, etc.), que actúa como paleta base cuando ningún tema la
/// sobrescribe.
#[rustfmt::skip]
fn intent_color(&self, intent: Intent) -> &'static str {
if let Some(parent) = self.parent() {
return parent.intent_color(intent);
}
match intent {
Intent::Primary => "primary",
Intent::Neutral => "neutral",
Intent::Info => "info",
Intent::Success => "success",
Intent::Warning => "warning",
Intent::Severe => "severe",
}
}
/// Acciones específicas del tema antes de renderizar el `<body>` de la página.
///
/// Es un buen lugar para inicializar o ajustar recursos en función del contexto de la página,

View file

@ -1,31 +1,41 @@
use crate::AutoDefault;
use crate::core::component::{Context, Contextual};
/// Intención semántica de un componente visual.
///
/// Representa la intención que pretende comunicar un componente (énfasis principal, confirmación de
/// un evento exitoso, aviso, peligro, etc.). Cada tema decidirá cómo pintarlo.
/// Describe *qué comunica* un componente, y cada tema traduce la intención a su propia paleta de
/// colores. Define un vocabulario con variantes por énfasis (`Primary`, `Neutral`), un canal
/// informativo (`Info`) y una escala de severidad (`Success`, `Warning`, `Severe`).
#[derive(AutoDefault, Clone, Copy, Debug, PartialEq)]
pub enum Intent {
/// Énfasis principal, suele ser la acción que más destaca a la vista.
#[default]
Primary,
Secondary,
Success,
/// Presencia sin énfasis, una opción discreta o normal.
Neutral,
/// Informa de algo que merece leerse, ajeno a la escala de severidad. Encaja en notas o avisos
/// informativos.
Info,
/// Destaca algo que ha ido bien, un estado favorable o un camino afirmativo. En una alerta
/// podría indicar la confirmación de una operación correcta o un estado saludable; en un botón,
/// la acción que confirma o aprueba algo positivamente.
Success,
/// Precaución, representa algo que requiere atención o cuidado. En una alerta, sería un
/// problema no bloqueante o un aviso; en un botón, una acción que conviene meditar sin llegar a
/// ser destructiva.
Warning,
Danger,
/// Algo va mal, es peligroso o destructivo. En una alerta sería un error o un fallo bloqueante;
/// en un botón, la acción destructiva o irreversible (p. ej. eliminar).
Severe,
}
impl Intent {
/// Devuelve el nombre de la intención (`"primary"`, `"danger"`, etc.).
#[rustfmt::skip]
pub const fn as_str(&self) -> &'static str {
match self {
Self::Primary => "primary",
Self::Secondary => "secondary",
Self::Success => "success",
Self::Info => "info",
Self::Warning => "warning",
Self::Danger => "danger",
}
/// Devuelve el nombre del color asociado a la intención en el tema activo del contexto actual.
///
/// Atajo de [`Theme::intent_color()`](crate::core::theme::Theme::intent_color) a través de
/// [`Context::theme()`]. La intención no tiene una cadena propia, es el tema activo quien
/// decide su traducción.
pub fn color(&self, cx: &Context) -> &'static str {
cx.theme().intent_color(*self)
}
}