♻️ (locale): Renombra L10n a Lc

Simplifica el nombre del tipo de localización. Actualiza todas las
referencias en el crate principal, extensiones, ejemplos y tests.
This commit is contained in:
Manuel Cillero 2026-08-12 22:56:09 +02:00
parent 3198b74399
commit be10dd28a1
65 changed files with 612 additions and 621 deletions

View file

@ -206,9 +206,9 @@ impl<C: Component> Embed<C> {
///
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// let mut embed = Embed::with(Block::new().with_title(L10n::n("Title")));
/// let mut embed = Embed::with(Block::new().with_title(Lc::n("Title")));
/// if let Some(component) = embed.get_mut() {
/// component.alter_title(L10n::n("New Title"));
/// component.alter_title(Lc::n("New Title"));
/// }
/// ```
pub fn get_mut(&mut self) -> Option<&mut C>

View file

@ -6,7 +6,7 @@ use crate::core::theme::{ChildrenInRegions, CoreRegions, CoreTemplates};
use crate::core::theme::{RegionRef, TemplateRef, ThemeRef};
use crate::html::{Assets, Favicon, JavaScript, Preload, StyleSheet};
use crate::html::{Markup, Props, PropsOp, RoutePath, html};
use crate::locale::L10n;
use crate::locale::Lc;
use crate::locale::{LangId, LanguageIdentifier, RequestLocale};
use crate::web::HttpRequest;
use crate::{builder_fn, util};
@ -509,9 +509,9 @@ impl Context {
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// # let mut cx = Context::default();
/// cx.push_message(MessageLevel::Warning, L10n::n("Session is not valid"));
/// cx.push_message(MessageLevel::Warning, Lc::n("Session is not valid"));
/// ```
pub fn push_message(&mut self, level: MessageLevel, text: L10n) {
pub fn push_message(&mut self, level: MessageLevel, text: Lc) {
self.messages.push(StatusMessage::new(level, text));
}
@ -532,13 +532,13 @@ impl Context {
/// global de idioma de la aplicación, la cabecera `Accept-Language` y/o el idioma de respaldo.
///
/// Todo ello según la negociación indicada en [`global::SETTINGS.app.lang_negotiation`]. Esto
/// permite que el [`Context`] se use como fuente de idioma coherente en [`L10n::lookup()`] o
/// [`L10n::using()`].
/// permite que el [`Context`] se use como fuente de idioma coherente en [`Lc::lookup()`] o
/// [`Lc::using()`].
///
/// [`Context`]: crate::core::component::Context
/// [`global::SETTINGS.app.lang_negotiation`]: crate::global::App::lang_negotiation
/// [`L10n::lookup()`]: crate::locale::L10n::lookup
/// [`L10n::using()`]: crate::locale::L10n::using
/// [`Lc::lookup()`]: crate::locale::Lc::lookup
/// [`Lc::using()`]: crate::locale::Lc::using
impl LangId for Context {
#[inline]
fn langid(&self) -> &'static LanguageIdentifier {

View file

@ -111,28 +111,33 @@ pub trait Component: AnyInfo + ComponentClone + ComponentRender + Send + Sync {
/// Genera el marcado HTML del componente cuando ningún tema lo sobrescribe.
///
/// Este es el cuarto paso del [ciclo de renderizado](ComponentRender) tras llamar al
/// [`setup()`](Self::setup) del componente y despachar la acción
/// [`BeforeRender`](crate::base::action::component::BeforeRender) que atiende los cambios de
/// [`setup()`] del componente y despachar la acción [`BeforeRender`] que atiende los cambios de
/// otras extensiones antes de renderizar. Se invoca sólo si ningún tema en la cadena devuelve
/// `Some` en [`Theme::handle_component()`](crate::core::theme::Theme::handle_component) para
/// este componente.
/// `Some` en [`Theme::handle_component()`] para este componente.
///
/// Es `async`, a diferencia de [`setup()`](Self::setup), para permitir a los componentes
/// realizar aquí sus llamadas asíncronas, como consultas a base de datos, peticiones a
/// servicios externos, o cualquier operación de E/S, que necesiten para preparar su contenido.
/// Es `async`, a diferencia de [`setup()`], para permitir a los componentes realizar aquí sus
/// llamadas asíncronas, como consultas a base de datos, peticiones a servicios externos, o
/// cualquier operación de E/S, que necesiten para preparar su contenido.
///
/// Se recomienda obtener los datos del componente a través de sus propios métodos para que los
/// temas puedan implementar `handle_component()` sin depender de los detalles internos.
///
/// Los campos que representen contenido no deben almacenar [`Markup`] ya generado, sino que
/// guardarán el dato en bruto, por ejemplo [`L10n`](crate::locale::L10n) para textos
/// traducibles, o un componente anidado como [`Html`](crate::base::component::Html), o
/// cualquier otro `Component`, normalmente a través de [`Embed`](crate::core::component::Embed)
/// o [`Child`](crate::core::component::Child); y será este método quien lo convierta en HTML en
/// el momento del renderizado, no quien construye la instancia.
/// guardarán el dato en bruto, por ejemplo [`Lc`] para textos traducibles, o un componente
/// anidado como [`Html`], o cualquier otro `Component`, normalmente a través de [`Embed`] o
/// [`Child`]; y será este método quien lo convierta en HTML en el momento del renderizado, no
/// quien construye la instancia.
///
/// Por defecto, devuelve un [`Markup`] vacío (`Ok(html! {})`). En caso de error, devuelve un
/// [`ComponentError`] que puede incluir un marcado alternativo (*fallback*).
///
/// [`setup()`]: Self::setup
/// [`BeforeRender`]: crate::base::action::component::BeforeRender
/// [`Theme::handle_component()`]: crate::core::theme::Theme::handle_component
/// [`Lc`]: crate::locale::Lc
/// [`Html`]: crate::base::component::Html
/// [`Embed`]: crate::core::component::Embed
/// [`Child`]: crate::core::component::Child
#[allow(unused_variables)]
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
Ok(html! {})

View file

@ -1,4 +1,4 @@
use crate::locale::L10n;
use crate::locale::Lc;
use crate::{AutoDefault, Getters};
/// Nivel de severidad de un [`StatusMessage`].
@ -20,30 +20,30 @@ pub enum MessageLevel {
/// puede generarse en cualquier punto del procesamiento de una petición web (handlers, renderizado,
/// lógica de negocio, etc.).
///
/// El texto se almacena como [`L10n`] para resolverse con el idioma del contexto en el momento de
/// la visualización.
/// El texto se almacena como [`Lc`] para resolverse con el idioma del contexto en el momento de la
/// visualización.
///
/// # Ejemplo
///
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// // Mensaje informativo con clave traducible.
/// let info = StatusMessage::new(MessageLevel::Info, L10n::l("saved-successfully"));
/// let info = StatusMessage::new(MessageLevel::Info, Lc::l("saved-successfully"));
///
/// // Aviso con texto literal sin traducción.
/// let warn = StatusMessage::new(MessageLevel::Warning, L10n::n("Incomplete form."));
/// let warn = StatusMessage::new(MessageLevel::Warning, Lc::n("Incomplete form."));
/// ```
#[derive(Debug, Getters)]
pub struct StatusMessage {
/// Nivel de severidad del mensaje.
level: MessageLevel,
/// Texto del mensaje.
text: L10n,
text: Lc,
}
impl StatusMessage {
/// Crea un nuevo mensaje de usuario con el nivel y texto indicados.
pub fn new(level: MessageLevel, text: L10n) -> Self {
pub fn new(level: MessageLevel, text: Lc) -> Self {
StatusMessage { level, text }
}
}