pagetop/CHANGELOG.md

CHANGELOG

Este archivo documenta los cambios más relevantes realizados en cada versión. El formato está basado en Keep a Changelog, y las versiones se numeran siguiendo las reglas del Versionado Semántico.

Resume la evolución del proyecto para usuarios y colaboradores, destacando nuevas funcionalidades, correcciones, mejoras durante el desarrollo o cambios en la documentación. Cambios menores o internos pueden omitirse si no afectan al uso del proyecto.

0.5.0 (2026-05-03)

PageTop 0.5.0 es la versión más ambiciosa hasta la fecha; concentra un largo periodo de trabajo en refactorizaciones, nuevas abstracciones y mejoras que sientan las bases para una API estable y robusta.

Algunos cambios pueden romper la compatibilidad con versiones anteriores. Se recomienda consultar la documentación de PageTop para actualizar el código a un entorno más expresivo y mejor preparado para crecer hacia la versión 1.0. Entre estos cambios destacan:

• Respuestas web completas: soporte para páginas HTML, redirecciones HTTP, respuestas JSON, cookies, y página de bienvenida integrada.
• API de componentes consolidada: ciclo de renderizado definitivo con is_renderable, manejo de errores con ComponentError o mensajes de estado con StatusMessage/MessageLevel.
• Temas hijo y macros de renderizado: los temas pueden extenderse entre sí para sobrescribir el renderizado de cualquier componente con render_component! y setup_component!.
• Nueva acción AlterMarkup: permite a extensiones y temas interceptar y transformar el HTML final de cualquier componente antes de entregarlo.
• Regiones y plantillas en temas: los componentes Region y Template formalizan la gestión de regiones, respaldados por una API de Children e InRegion completamente revisada.
• Sistema de localización refactorizado: nueva arquitectura interna con API más clara, mejor integración en el contexto y soporte robusto para múltiples idiomas.
• Tipos HTML consolidados: unidades CSS, clase Classes, atributos HTML refactorizados y cadenas internas optimizadas con CowStr.
• Nuevas macros y utilidades de API pública: macro Getters para exponer campos de componentes.
• Configuración tipada: nuevas opciones de configuración enumeradas para el log y otros parámetros del sistema, con una gestión más expresiva y segura.
• Recursos estáticos y trazabilidad: gestión de recursos estáticos integrada en el núcleo de PageTop y soporte para trazas y registro de eventos desde la propia librería.

0.4.0 (2025-09-20)

Añadido

• (app) Añade manejo de rutas no encontradas
• (context) Añade métodos auxiliares de parámetros
• (util) Añade indoc para indentar código bien
• Añade componente PoweredBy para copyright

Cambiado

• (html) Cambia tipos Option... por Attr...
• (html) Implementa Default en Context
• (welcome) Crea página de bienvenida desde intro
• (context) Generaliza los parámetros de contexto
• (context) Define un trait común de contexto
• Modifica tipos para atributos HTML a minúsculas
• Renombra with_component por add_child

Corregido

• (welcome) Corrige giro botón con ancho estrecho
• (welcome) Corrige centrado del pie de página
• Corrige nombre de función en prueba de Html
• Corrige doc y código por cambios en Page

Dependencias

• Actualiza dependencias para 0.4.0

Documentado

• (component) Amplía documentación de preparación
• Normaliza referencias al nombre PageTop
• Simplifica documentación de obsoletos
• Mejora la documentación de recursos y contexto

Otros cambios

• (theme) Mejora gestión de regiones en páginas
• (tests) Amplía pruebas para `PrepareMarkup'
• (locale) Mejora el uso de lookup / using
• (tools) Fuerza pulsar intro para confirmar input
• Unifica conversiones a String con to_string()
• Elimina Render para usar siempre el contexto

0.3.0 (2025-08-16)

Cambiado

• Redefine función para directorios absolutos
• Mejora la integración de archivos estáticos

Documentado

• Cambia el formato para la documentación

0.2.0 (2025-08-09)

Añadido

• Añade librería para gestionar recursos estáticos
• Añade soporte a changelog de pagetop-statics

Documentado

• Corrige enlace del botón de licencia en la documentación

Otros cambios

• Afina Cargo.toml para buscar la mejor categoría

0.1.0 (2025-08-06)

• Versión inicial