Skip to content

🚀 v0.14.0-alpha.1: Documentación JSDoc Completa en Castellano

Pre-release
Pre-release

Choose a tag to compare

@MKS2508 MKS2508 released this 08 Sep 18:26
· 19 commits to main since this release

✨ Nuevas Características

📝 Documentación JSDoc Completa en Castellano

  • ~500 líneas de JSDoc actualizada para todos los métodos principales del Logger
  • Ejemplos prácticos con la nueva API v0.3.0+ en cada método
  • Documentación de tipos completa para todas las interfaces TypeScript
  • Guías de uso detalladas para presets, badges y contextos

🎯 Características Documentadas

Presets Inteligentes

logger.preset('cyberpunk');     // Efectos neón y brillantes
logger.preset('glassmorphism'); // Efectos de blur modernos
logger.preset('minimal');       // Diseño limpio y elegante

Loggers con Scope

const auth = logger.component('Auth');
auth.info('Usuario autenticando...');
// [COMPONENT] [Auth] Usuario autenticando...

const api = logger.api('GraphQL');
api.badges(['v2', 'cached']).info('Query ejecutada');
// [API] [v2] [cached] [GraphQL] Query ejecutada

Sistema de Badges Automáticos

  • ComponentLogger: Badges automáticos para eventos de ciclo de vida
  • APILogger: Badges para operaciones lentas, rate limiting, auth
  • Badges personalizados: Sistema flexible de etiquetas contextuales

Contextos Temporales

dbLogger.context('Migration').run(() => {
  dbLogger.info('Iniciando migración');
  dbLogger.success('Tablas creadas');
});
// Contexto automáticamente limpiado

🛠️ Archivos Actualizados

  • src/Logger.ts: Documentación completa de ~40 métodos públicos
  • src/types/core.ts: Todos los tipos TypeScript documentados con ejemplos
  • src/ScopedLogger.ts: Sistema de badges y contextos explicado
  • src/index.ts: Ejemplos de uso actualizados a la nueva API
  • package.json: Descripción y keywords en castellano

🎨 Mejoras en Developer Experience

  • IntelliSense mejorado con descripciones en castellano
  • Ejemplos reales para cada método y configuración
  • Tipos explícitos con documentación de parámetros
  • Casos de uso prácticos para todas las características

🌐 Package Updates

  • Descripción actualizada en castellano
  • Keywords adicionales para mejor descubrimiento
  • Metadatos optimizados para desarrolladores hispanohablantes

Esta versión marca un hito importante en la documentación del proyecto, proporcionando una experiencia completa para desarrolladores que prefieren documentación en castellano.