ywana-core8 0.1.96 → 0.1.98

package/README-PUBLISH.md

@@ -0,0 +1,166 @@
+# 🚀 Ywana Core8 Publisher
+
+Script automatizado para publicar nuevas versiones de `ywana-core8` con pipeline completo de CI/CD.
+
+## ✨ Características
+
+- 🎨 **Interfaz visual atractiva** con colores y barras de progreso
+- 🧪 **Ejecución automática de tests** antes de publicar
+- 🔨 **Build automático** con Vite
+- 📈 **Incremento automático de versión** (patch)
+- 🏷️ **Creación automática de tags** de Git
+- 📤 **Push automático** a GitHub con tags
+- 📦 **Publicación automática** a NPM
+- ✅ **Validaciones completas** en cada paso
+- 📊 **Resumen detallado** al final
+
+## 🚀 Uso
+
+### Uso Básico
+```bash
+./publish.sh
+```
+El script te pedirá que ingreses un mensaje de commit.
+
+### Uso con Mensaje
+```bash
+./publish.sh "Añadir nueva funcionalidad de exportación"
+```
+
+## 📋 Pipeline de Publicación
+
+El script ejecuta los siguientes pasos automáticamente:
+
+### 1. 📋 Verificaciones Previas
+- ✅ Verifica la rama actual
+- ✅ Detecta cambios sin commitear
+- ✅ Verifica conexión a internet
+
+### 2. 🧪 Ejecución de Tests
+- ✅ Ejecuta toda la suite de tests
+- ✅ Muestra spinner durante la ejecución
+- ✅ Falla si algún test no pasa
+
+### 3. 🔨 Build del Proyecto
+- ✅ Limpia build anterior
+- ✅ Ejecuta `npm run build` con Vite
+- ✅ Muestra tiempo de build
+- ✅ Lista archivos generados con tamaños
+
+### 4. 📈 Incremento de Versión
+- ✅ Muestra versión actual
+- ✅ Incrementa versión patch automáticamente
+- ✅ Actualiza package.json
+
+### 5. 📤 Git Commit y Push
+- ✅ Añade todos los archivos
+- ✅ Crea commit con formato: `v1.2.3: mensaje`
+- ✅ Crea tag de versión
+- ✅ Push a GitHub con tags
+
+### 6. 📦 Publicación a NPM
+- ✅ Verifica login de NPM
+- ✅ Publica nueva versión
+- ✅ Muestra enlaces útiles
+
+## 🎯 Ejemplo de Output
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                    🚀 YWANA CORE8 PUBLISHER                  ║
+║                  Automated Release Pipeline                  ║
+╚══════════════════════════════════════════════════════════════╝
+
+💬 Ingresa el mensaje de commit: Migración completa a Vite
+
+[13:45:12] Mensaje de commit: Migración completa a Vite
+[13:45:12] Iniciando pipeline de publicación...
+
+📋 PASO 1: Verificaciones Previas
+[13:45:12] Rama actual: main
+[13:45:12] ✓ Working directory limpio
+[13:45:13] ✓ Verificaciones previas completadas
+
+🧪 PASO 2: Ejecutando Tests
+[13:45:13] Ejecutando suite de tests...
+⠋ Procesando...
+[13:45:15] ✓ Todos los tests pasaron
+
+🔨 PASO 3: Building Proyecto
+[13:45:15] ✓ Build anterior eliminado
+[13:45:15] Iniciando build con Vite...
+⠙ Procesando...
+[13:45:17] ✓ Build completado en 2s
+
+📦 Archivos generados:
+  index.css (1.4M)
+  index.js (1.6M)
+  index.modern.js (1.6M)
+  index.umd.js (1.7M)
+
+📈 PASO 4: Incrementando Versión
+[13:45:17] Versión actual: v0.1.95
+[13:45:17] ✓ Nueva versión: v0.1.96
+
+📤 PASO 5: Git Commit y Push
+[13:45:17] Añadiendo archivos al staging...
+[==================================================] 100%
+[13:45:18] ✓ Commit creado
+[13:45:18] ✓ Tag v0.1.96 creado
+⠸ Procesando...
+[13:45:20] ✓ Push completado exitosamente
+
+📦 PASO 6: Publicando a NPM
+[13:45:20] Usuario NPM: ernesto
+⠴ Procesando...
+[13:45:25] ✓ Paquete publicado exitosamente
+
+╔══════════════════════════════════════════════════════════════╗
+║                    🎉 PUBLICACIÓN EXITOSA                   ║
+╚══════════════════════════════════════════════════════════════╝
+
+📊 Resumen de la publicación:
+  ✓ Versión:     v0.1.95 → v0.1.96
+  ✓ Commit:      v0.1.96: Migración completa a Vite
+  ✓ Rama:        main
+  ✓ Usuario NPM: ernesto
+  ✓ Build time:  2s
+
+🔗 Enlaces útiles:
+  📦 NPM:    https://www.npmjs.com/package/ywana-core8
+  🐙 GitHub: https://github.com/ywana/ywana-core8
+  📋 Tag:    https://github.com/ywana/ywana-core8/releases/tag/v0.1.96
+
+📥 Para instalar la nueva versión:
+  npm install ywana-core8@0.1.96
+
+🚀 ¡Publicación completada exitosamente!
+```
+
+## ⚠️ Requisitos
+
+- Node.js y npm instalados
+- Git configurado
+- Estar logueado en NPM (`npm login`)
+- Permisos de escritura en el repositorio
+
+## 🛠️ Troubleshooting
+
+### Error: "No estás logueado en NPM"
+```bash
+npm login
+```
+
+### Error: "Tests fallaron"
+Revisa el archivo `/tmp/test_output.log` para ver los detalles del error.
+
+### Error: "Build falló"
+Revisa el archivo `/tmp/build_output.log` para ver los detalles del error.
+
+## 🎨 Personalización
+
+Puedes modificar el script para:
+- Cambiar el tipo de incremento de versión (major, minor, patch)
+- Añadir más validaciones
+- Personalizar los mensajes de commit
+- Añadir notificaciones (Slack, Discord, etc.)