@saulwade/swl-ses 2.6.1 → 2.8.0

package/scripts/tui/pantallas/progreso.js

@@ -1,274 +1,274 @@
-'use strict';
-
-/**
- * Pantalla de progreso de la TUI.
- * Diseño:
- *   - Cabecera con título de la operación (Install / Update)
- *   - Barra global de progreso con porcentaje
- *   - Tabla de contadores por categoría (skills, hooks, agentes, reglas, etc.)
- *   - Panel inferior con log rotativo (últimas N líneas)
- *
- * Modelo de uso:
- *
- *   const ctrl = crearProgreso({ titulo, categorias });
- *   ctrl.iniciar();
- *
- *   // El instalador emite eventos:
- *   ctrl.onEvento({ tipo: 'archivo-copiado', componente: 'skills', archivo: '...' });
- *   ctrl.onEvento({ tipo: 'componente-completado', componente: 'skills' });
- *   ctrl.onEvento({ tipo: 'log', linea: 'Backup creado: ...' });
- *
- *   // Al terminar:
- *   ctrl.finalizar({ ok: true, mensaje: 'Instalación completa' });
- *
- * En no-TTY: imprime líneas simples a stdout sin esperar.
- */
-
-const render = require('../lib/render');
-const teclas = require('../lib/teclas');
-const { colores, semantico, iconos } = require('../lib/colores');
-
-const MAX_LOG_LINEAS_DEFAULT = 8;
-const MAX_LOG_LINEAS_VERBOSE = 24;
-
-// Compat: el contador histórico exportado seguía siendo MAX_LOG_LINEAS.
-// Lo mantenemos para no romper consumidores externos.
-const MAX_LOG_LINEAS = MAX_LOG_LINEAS_DEFAULT;
-
-/**
- * @param {object} opciones
- * @param {string} opciones.titulo - Encabezado (ej: "Instalando SWL en Claude Code...")
- * @param {Array<{nombre:string, etiqueta:string, total:number}>} opciones.categorias
- *        Categorías a contar. Ej: [{ nombre:'skills', etiqueta:'Skills', total:162 }, ...]
- * @param {boolean} [opciones.verbose=false] - Expande el panel de log para mostrar
- *        más líneas (24 vs 8) y deshabilita el truncado del log por archivo.
- *        Util cuando se quiere depurar qué hace exactamente el instalador.
- */
-function crearProgreso(opciones) {
-  const titulo = opciones.titulo || 'Procesando...';
-  const categorias = opciones.categorias || [];
-  const verbose = !!opciones.verbose;
-  const maxLogLineas = verbose ? MAX_LOG_LINEAS_VERBOSE : MAX_LOG_LINEAS_DEFAULT;
-
-  // Estado interno
-  const conteos = new Map(); // nombre → contador actual
-  for (const c of categorias) conteos.set(c.nombre, 0);
-  const logBuffer = []; // últimas N líneas
-  let finalizado = false;
-  let mensajeFinal = '';
-  let okFinal = true;
-  let onResize = null;
-  let teclado = null;
-  let resolverEspera = null;
-
-  function _porcentajeGlobal() {
-    let hecho = 0, total = 0;
-    for (const c of categorias) {
-      hecho += Math.min(conteos.get(c.nombre) || 0, c.total);
-      total += c.total;
-    }
-    return total > 0 ? hecho / total : 0;
-  }
-
-  function _renderizar() {
-    if (!render.ES_TTY) return;
-    render.limpiarPantalla();
-    const { cols, rows } = render.obtenerDimensiones();
-
-    // Cabecera
-    render.escribirEn(2, 3, semantico.titulo(titulo));
-
-    // Barra global
-    const filaBarra = 4;
-    render.escribirEn(filaBarra, 3, colores.dim('Progreso global'));
-    render.dibujarBarra(filaBarra + 1, 3, Math.min(cols - 6, 60), _porcentajeGlobal());
-
-    // Contadores por categoría
-    const filaCat = filaBarra + 4;
-    render.escribirEn(filaCat - 1, 3, colores.dim('Por categoría:'));
-    categorias.forEach((c, i) => {
-      const actual = conteos.get(c.nombre) || 0;
-      const pct = c.total > 0 ? actual / c.total : 0;
-      const completo = actual >= c.total && c.total > 0;
-      const icono = completo ? semantico.exito(iconos.check) : (actual > 0 ? semantico.info(iconos.arrow) : colores.dim(iconos.punto));
-      const linea =
-        `${icono} ` +
-        render.rellenarDer(colores.negrita(c.etiqueta), 14) +
-        render.rellenarDer(`${actual}/${c.total}`, 12);
-      render.escribirEn(filaCat + i, 5, linea);
-      // Mini-barra al lado
-      const anchoMini = Math.min(20, cols - 50);
-      if (anchoMini > 8) {
-        render.dibujarBarra(filaCat + i, 32, anchoMini, pct, {
-          colorLleno: completo ? colores.verde : colores.cyan,
-        });
-      }
-    });
-
-    // Panel inferior con log rotativo
-    const filaLog = filaCat + categorias.length + 2;
-    const altoLog = Math.min(maxLogLineas + 2, rows - filaLog - 2);
-    if (altoLog >= 3) {
-      const tituloLog = verbose
-        ? `Log detallado (verbose, ${maxLogLineas} líneas)`
-        : 'Log (últimas líneas)';
-      render.dibujarCaja(filaLog, 3, cols - 5, altoLog, {
-        titulo: tituloLog,
-        color: colores.dim,
-      });
-      const lineasMostradas = logBuffer.slice(-Math.max(1, altoLog - 2));
-      lineasMostradas.forEach((l, i) => {
-        render.escribirEn(filaLog + 1 + i, 5,
-          render.recortar(colores.dim(l), cols - 9));
-      });
-    }
-
-    // Pie
-    if (finalizado) {
-      const colorPie = okFinal ? semantico.exito : semantico.error;
-      const ico = okFinal ? iconos.check : iconos.cross;
-      render.escribirEn(rows - 2, 3,
-        colorPie(`${ico} ${mensajeFinal}  ${colores.dim('— Enter para continuar')}`));
-    } else {
-      render.dibujarPiePagina([
-        ['Esc', 'cancelar'],
-      ]);
-    }
-  }
-
-  // ── API pública ───────────────────────────────────────────────────────────
-
-  function iniciar() {
-    if (!render.ES_TTY) {
-      console.log('');
-      console.log(`  ${titulo}`);
-      return;
-    }
-    render.iniciarModoTui();
-    _renderizar();
-    onResize = () => _renderizar();
-    process.stdout.on('resize', onResize);
-    teclado = teclas.crearTeclado();
-    teclado.on('escape', () => {
-      // No interrumpimos directamente: el caller decide cómo manejar.
-      // Aquí solo registramos en el log.
-      onEvento({ tipo: 'log', linea: '[usuario presionó Esc — ignorado durante ejecución]' });
-    });
-    teclado.activar();
-  }
-
-  /**
-   * Recibe eventos del instalador.
-   * tipos soportados:
-   *   - 'archivo-copiado'      { componente, archivo? }
-   *   - 'componente-completado' { componente }
-   *   - 'log'                  { linea }
-   *   - 'set-total'            { componente, total }  — actualizar total dinámico
-   */
-  function onEvento(evento) {
-    if (!evento || !evento.tipo) return;
-
-    switch (evento.tipo) {
-      case 'archivo-copiado':
-        if (evento.componente) {
-          const actual = conteos.get(evento.componente) || 0;
-          conteos.set(evento.componente, actual + 1);
-        }
-        if (evento.archivo) {
-          logBuffer.push(`${semantico.exito('+')} ${evento.componente}: ${evento.archivo}`);
-          if (logBuffer.length > maxLogLineas * 2) logBuffer.splice(0, logBuffer.length - maxLogLineas * 2);
-        }
-        break;
-      case 'componente-completado':
-        if (evento.componente) {
-          const cat = categorias.find(c => c.nombre === evento.componente);
-          if (cat) conteos.set(evento.componente, cat.total);
-        }
-        break;
-      case 'log':
-        if (evento.linea) {
-          logBuffer.push(evento.linea);
-          if (logBuffer.length > maxLogLineas * 2) logBuffer.splice(0, logBuffer.length - maxLogLineas * 2);
-        }
-        break;
-      case 'set-total':
-        if (evento.componente && typeof evento.total === 'number') {
-          const cat = categorias.find(c => c.nombre === evento.componente);
-          if (cat) cat.total = evento.total;
-        }
-        break;
-    }
-
-    _renderizar();
-    if (!render.ES_TTY && evento.linea) {
-      // Modo no-TTY: imprimir log lineal
-      console.log(`  ${evento.linea}`);
-    }
-  }
-
-  /**
-   * Marca la pantalla como finalizada. El usuario debe presionar Enter para
-   * cerrar. Resuelve la promise devuelta por esperarSalida().
-   */
-  function finalizar(opts = {}) {
-    finalizado = true;
-    okFinal = opts.ok !== false;
-    mensajeFinal = opts.mensaje || (okFinal ? 'Completado' : 'Falló');
-    if (!render.ES_TTY) {
-      console.log('');
-      console.log(`  ${okFinal ? '[OK]' : '[ERROR]'} ${mensajeFinal}`);
-      if (resolverEspera) resolverEspera();
-      return;
-    }
-    _renderizar();
-
-    if (teclado) {
-      teclado.on('return', () => {
-        cerrar();
-        if (resolverEspera) {
-          const r = resolverEspera;
-          resolverEspera = null;
-          r();
-        }
-      });
-    }
-  }
-
-  function cerrar() {
-    if (teclado) teclado.desactivar();
-    if (onResize) process.stdout.removeListener('resize', onResize);
-    render.salirModoTui();
-  }
-
-  /**
-   * Devuelve una promise que se resuelve cuando el usuario presiona Enter
-   * después de finalizar(). En no-TTY se resuelve inmediatamente al finalizar.
-   */
-  function esperarSalida() {
-    return new Promise((resolve) => {
-      if (finalizado && !render.ES_TTY) {
-        resolve();
-        return;
-      }
-      resolverEspera = resolve;
-    });
-  }
-
-  return {
-    iniciar,
-    onEvento,
-    finalizar,
-    cerrar,
-    esperarSalida,
-    // exports auxiliares para tests
-    _getEstado: () => ({
-      conteos: Object.fromEntries(conteos),
-      logBuffer: [...logBuffer],
-      finalizado,
-      mensajeFinal,
-      okFinal,
-    }),
-  };
-}
-
-module.exports = { crearProgreso, MAX_LOG_LINEAS, MAX_LOG_LINEAS_DEFAULT, MAX_LOG_LINEAS_VERBOSE };
+'use strict';
+
+/**
+ * Pantalla de progreso de la TUI.
+ * Diseño:
+ *   - Cabecera con título de la operación (Install / Update)
+ *   - Barra global de progreso con porcentaje
+ *   - Tabla de contadores por categoría (skills, hooks, agentes, reglas, etc.)
+ *   - Panel inferior con log rotativo (últimas N líneas)
+ *
+ * Modelo de uso:
+ *
+ *   const ctrl = crearProgreso({ titulo, categorias });
+ *   ctrl.iniciar();
+ *
+ *   // El instalador emite eventos:
+ *   ctrl.onEvento({ tipo: 'archivo-copiado', componente: 'skills', archivo: '...' });
+ *   ctrl.onEvento({ tipo: 'componente-completado', componente: 'skills' });
+ *   ctrl.onEvento({ tipo: 'log', linea: 'Backup creado: ...' });
+ *
+ *   // Al terminar:
+ *   ctrl.finalizar({ ok: true, mensaje: 'Instalación completa' });
+ *
+ * En no-TTY: imprime líneas simples a stdout sin esperar.
+ */
+
+const render = require('../lib/render');
+const teclas = require('../lib/teclas');
+const { colores, semantico, iconos } = require('../lib/colores');
+
+const MAX_LOG_LINEAS_DEFAULT = 8;
+const MAX_LOG_LINEAS_VERBOSE = 24;
+
+// Compat: el contador histórico exportado seguía siendo MAX_LOG_LINEAS.
+// Lo mantenemos para no romper consumidores externos.
+const MAX_LOG_LINEAS = MAX_LOG_LINEAS_DEFAULT;
+
+/**
+ * @param {object} opciones
+ * @param {string} opciones.titulo - Encabezado (ej: "Instalando SWL en Claude Code...")
+ * @param {Array<{nombre:string, etiqueta:string, total:number}>} opciones.categorias
+ *        Categorías a contar. Ej: [{ nombre:'skills', etiqueta:'Skills', total:162 }, ...]
+ * @param {boolean} [opciones.verbose=false] - Expande el panel de log para mostrar
+ *        más líneas (24 vs 8) y deshabilita el truncado del log por archivo.
+ *        Util cuando se quiere depurar qué hace exactamente el instalador.
+ */
+function crearProgreso(opciones) {
+  const titulo = opciones.titulo || 'Procesando...';
+  const categorias = opciones.categorias || [];
+  const verbose = !!opciones.verbose;
+  const maxLogLineas = verbose ? MAX_LOG_LINEAS_VERBOSE : MAX_LOG_LINEAS_DEFAULT;
+
+  // Estado interno
+  const conteos = new Map(); // nombre → contador actual
+  for (const c of categorias) conteos.set(c.nombre, 0);
+  const logBuffer = []; // últimas N líneas
+  let finalizado = false;
+  let mensajeFinal = '';
+  let okFinal = true;
+  let onResize = null;
+  let teclado = null;
+  let resolverEspera = null;
+
+  function _porcentajeGlobal() {
+    let hecho = 0, total = 0;
+    for (const c of categorias) {
+      hecho += Math.min(conteos.get(c.nombre) || 0, c.total);
+      total += c.total;
+    }
+    return total > 0 ? hecho / total : 0;
+  }
+
+  function _renderizar() {
+    if (!render.ES_TTY) return;
+    render.limpiarPantalla();
+    const { cols, rows } = render.obtenerDimensiones();
+
+    // Cabecera
+    render.escribirEn(2, 3, semantico.titulo(titulo));
+
+    // Barra global
+    const filaBarra = 4;
+    render.escribirEn(filaBarra, 3, colores.dim('Progreso global'));
+    render.dibujarBarra(filaBarra + 1, 3, Math.min(cols - 6, 60), _porcentajeGlobal());
+
+    // Contadores por categoría
+    const filaCat = filaBarra + 4;
+    render.escribirEn(filaCat - 1, 3, colores.dim('Por categoría:'));
+    categorias.forEach((c, i) => {
+      const actual = conteos.get(c.nombre) || 0;
+      const pct = c.total > 0 ? actual / c.total : 0;
+      const completo = actual >= c.total && c.total > 0;
+      const icono = completo ? semantico.exito(iconos.check) : (actual > 0 ? semantico.info(iconos.arrow) : colores.dim(iconos.punto));
+      const linea =
+        `${icono} ` +
+        render.rellenarDer(colores.negrita(c.etiqueta), 14) +
+        render.rellenarDer(`${actual}/${c.total}`, 12);
+      render.escribirEn(filaCat + i, 5, linea);
+      // Mini-barra al lado
+      const anchoMini = Math.min(20, cols - 50);
+      if (anchoMini > 8) {
+        render.dibujarBarra(filaCat + i, 32, anchoMini, pct, {
+          colorLleno: completo ? colores.verde : colores.cyan,
+        });
+      }
+    });
+
+    // Panel inferior con log rotativo
+    const filaLog = filaCat + categorias.length + 2;
+    const altoLog = Math.min(maxLogLineas + 2, rows - filaLog - 2);
+    if (altoLog >= 3) {
+      const tituloLog = verbose
+        ? `Log detallado (verbose, ${maxLogLineas} líneas)`
+        : 'Log (últimas líneas)';
+      render.dibujarCaja(filaLog, 3, cols - 5, altoLog, {
+        titulo: tituloLog,
+        color: colores.dim,
+      });
+      const lineasMostradas = logBuffer.slice(-Math.max(1, altoLog - 2));
+      lineasMostradas.forEach((l, i) => {
+        render.escribirEn(filaLog + 1 + i, 5,
+          render.recortar(colores.dim(l), cols - 9));
+      });
+    }
+
+    // Pie
+    if (finalizado) {
+      const colorPie = okFinal ? semantico.exito : semantico.error;
+      const ico = okFinal ? iconos.check : iconos.cross;
+      render.escribirEn(rows - 2, 3,
+        colorPie(`${ico} ${mensajeFinal}  ${colores.dim('— Enter para continuar')}`));
+    } else {
+      render.dibujarPiePagina([
+        ['Esc', 'cancelar'],
+      ]);
+    }
+  }
+
+  // ── API pública ───────────────────────────────────────────────────────────
+
+  function iniciar() {
+    if (!render.ES_TTY) {
+      console.log('');
+      console.log(`  ${titulo}`);
+      return;
+    }
+    render.iniciarModoTui();
+    _renderizar();
+    onResize = () => _renderizar();
+    process.stdout.on('resize', onResize);
+    teclado = teclas.crearTeclado();
+    teclado.on('escape', () => {
+      // No interrumpimos directamente: el caller decide cómo manejar.
+      // Aquí solo registramos en el log.
+      onEvento({ tipo: 'log', linea: '[usuario presionó Esc — ignorado durante ejecución]' });
+    });
+    teclado.activar();
+  }
+
+  /**
+   * Recibe eventos del instalador.
+   * tipos soportados:
+   *   - 'archivo-copiado'      { componente, archivo? }
+   *   - 'componente-completado' { componente }
+   *   - 'log'                  { linea }
+   *   - 'set-total'            { componente, total }  — actualizar total dinámico
+   */
+  function onEvento(evento) {
+    if (!evento || !evento.tipo) return;
+
+    switch (evento.tipo) {
+      case 'archivo-copiado':
+        if (evento.componente) {
+          const actual = conteos.get(evento.componente) || 0;
+          conteos.set(evento.componente, actual + 1);
+        }
+        if (evento.archivo) {
+          logBuffer.push(`${semantico.exito('+')} ${evento.componente}: ${evento.archivo}`);
+          if (logBuffer.length > maxLogLineas * 2) logBuffer.splice(0, logBuffer.length - maxLogLineas * 2);
+        }
+        break;
+      case 'componente-completado':
+        if (evento.componente) {
+          const cat = categorias.find(c => c.nombre === evento.componente);
+          if (cat) conteos.set(evento.componente, cat.total);
+        }
+        break;
+      case 'log':
+        if (evento.linea) {
+          logBuffer.push(evento.linea);
+          if (logBuffer.length > maxLogLineas * 2) logBuffer.splice(0, logBuffer.length - maxLogLineas * 2);
+        }
+        break;
+      case 'set-total':
+        if (evento.componente && typeof evento.total === 'number') {
+          const cat = categorias.find(c => c.nombre === evento.componente);
+          if (cat) cat.total = evento.total;
+        }
+        break;
+    }
+
+    _renderizar();
+    if (!render.ES_TTY && evento.linea) {
+      // Modo no-TTY: imprimir log lineal
+      console.log(`  ${evento.linea}`);
+    }
+  }
+
+  /**
+   * Marca la pantalla como finalizada. El usuario debe presionar Enter para
+   * cerrar. Resuelve la promise devuelta por esperarSalida().
+   */
+  function finalizar(opts = {}) {
+    finalizado = true;
+    okFinal = opts.ok !== false;
+    mensajeFinal = opts.mensaje || (okFinal ? 'Completado' : 'Falló');
+    if (!render.ES_TTY) {
+      console.log('');
+      console.log(`  ${okFinal ? '[OK]' : '[ERROR]'} ${mensajeFinal}`);
+      if (resolverEspera) resolverEspera();
+      return;
+    }
+    _renderizar();
+
+    if (teclado) {
+      teclado.on('return', () => {
+        cerrar();
+        if (resolverEspera) {
+          const r = resolverEspera;
+          resolverEspera = null;
+          r();
+        }
+      });
+    }
+  }
+
+  function cerrar() {
+    if (teclado) teclado.desactivar();
+    if (onResize) process.stdout.removeListener('resize', onResize);
+    render.salirModoTui();
+  }
+
+  /**
+   * Devuelve una promise que se resuelve cuando el usuario presiona Enter
+   * después de finalizar(). En no-TTY se resuelve inmediatamente al finalizar.
+   */
+  function esperarSalida() {
+    return new Promise((resolve) => {
+      if (finalizado && !render.ES_TTY) {
+        resolve();
+        return;
+      }
+      resolverEspera = resolve;
+    });
+  }
+
+  return {
+    iniciar,
+    onEvento,
+    finalizar,
+    cerrar,
+    esperarSalida,
+    // exports auxiliares para tests
+    _getEstado: () => ({
+      conteos: Object.fromEntries(conteos),
+      logBuffer: [...logBuffer],
+      finalizado,
+      mensajeFinal,
+      okFinal,
+    }),
+  };
+}
+
+module.exports = { crearProgreso, MAX_LOG_LINEAS, MAX_LOG_LINEAS_DEFAULT, MAX_LOG_LINEAS_VERBOSE };