@saulwade/swl-ses 2.3.0 → 2.3.1

package/scripts/tui/index.js

@@ -1,162 +1,162 @@
-'use strict';
-
-/**
- * Entry point del TUI de swl-ses.
- *
- * Flujo:
- *   1. Welcome (pantalla de bienvenida + detección de instalaciones)
- *   2. Menú principal (Install / Update / Inspect / Uninstall)
- *   3. Wizard correspondiente
- *   4. Ejecución con UI de progreso
- *   5. Resumen final
- *   6. Vuelve al menú principal (a menos que el usuario haya hecho Esc en el menú)
- *
- * En no-TTY, el TUI se desactiva automáticamente — cada pantalla devuelve
- * un valor por defecto sin esperar input. Los caller deben detectar esa
- * salida y caer al CLI clásico si quieren UX interactivo.
- */
-
-const { mostrarWelcome } = require('./pantallas/welcome');
-const { mostrarMenuPrincipal } = require('./pantallas/menu-principal');
-const { ejecutarWizardInstall } = require('./pantallas/install-wizard');
-const { ejecutarWizardUpdate } = require('./pantallas/update-wizard');
-const { ejecutarWizardUninstall } = require('./pantallas/uninstall-wizard');
-const { ejecutarInspect } = require('./pantallas/inspect');
-const { ejecutarInstall, ejecutarUpdate, ejecutarUninstall } = require('./ejecutores');
-const { mostrarResumen } = require('./pantallas/resumen');
-const render = require('./lib/render');
-
-/**
- * Lanza el flujo TUI completo. Devuelve cuando el usuario sale del menú
- * principal con Esc.
- *
- * @param {object} [opciones]
- * @param {string} [opciones.operacionInicial] - si está dado, salta el menú
- *        e inicia directamente en esa operación ('install' | 'update' | etc.)
- * @returns {Promise<{ ok, motivo?, ultimaOperacion? }>}
- */
-async function iniciarTui(opciones = {}) {
-  // Detección defensiva: si no hay TTY, no entrar al flujo interactivo
-  if (!render.ES_TTY || !process.stdin.isTTY) {
-    return { ok: false, motivo: 'no-tty', mensaje: 'TUI requiere terminal interactiva' };
-  }
-
-  // 1. Welcome (a menos que se haya pedido saltar)
-  if (!opciones.saltarWelcome) {
-    const w = await mostrarWelcome();
-    if (!w.continuar) {
-      return { ok: true, motivo: 'usuario-salio-welcome' };
-    }
-  }
-
-  // 2. Loop principal: menú → operación → vuelve al menú
-  let ultimaOperacion = null;
-  while (true) {
-    let operacion = opciones.operacionInicial;
-    opciones.operacionInicial = null; // solo aplica la primera vez
-
-    if (!operacion) {
-      operacion = await mostrarMenuPrincipal();
-      if (!operacion) {
-        return { ok: true, motivo: 'usuario-salio-menu', ultimaOperacion };
-      }
-    }
-
-    ultimaOperacion = operacion;
-
-    try {
-      await _ejecutarOperacion(operacion);
-    } catch (e) {
-      // Mostrar error como pantalla de resumen y continuar
-      await mostrarResumen({
-        operacion,
-        ok: false,
-        tituloPrincipal: `Error en operación "${operacion}"`,
-        mensajeFinal: e.message,
-        tabla: [['Tipo de error', e.name || 'Error']],
-        proximosPasos: [
-          'Revisa los logs anteriores',
-          'Intenta de nuevo desde el menú',
-          'Si el error persiste: swl-ses doctor',
-        ],
-      });
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Despacho de operaciones
-// ---------------------------------------------------------------------------
-
-async function _ejecutarOperacion(operacion) {
-  switch (operacion) {
-    case 'install':
-      return _flujoInstall();
-    case 'update':
-      return _flujoUpdate();
-    case 'inspect':
-      return ejecutarInspect();
-    case 'uninstall':
-      return _flujoUninstall();
-    default:
-      throw new Error(`Operación no soportada: ${operacion}`);
-  }
-}
-
-async function _flujoInstall() {
-  const w = await ejecutarWizardInstall();
-  if (!w.exito) {
-    if (w.cancelado) return { ok: true, cancelado: true };
-    if (w.error) {
-      await mostrarResumen({
-        operacion: 'install',
-        ok: false,
-        tituloPrincipal: 'No se pudo iniciar la instalación',
-        mensajeFinal: w.error,
-        tabla: [],
-      });
-    }
-    return { ok: false };
-  }
-  return ejecutarInstall(w.opciones);
-}
-
-async function _flujoUpdate() {
-  const w = await ejecutarWizardUpdate();
-  if (!w.exito) {
-    if (w.cancelado) return { ok: true, cancelado: true };
-    if (w.error || w.vacio) {
-      await mostrarResumen({
-        operacion: 'update',
-        ok: false,
-        tituloPrincipal: w.vacio ? 'Nada que actualizar' : 'No se pudo iniciar la actualización',
-        mensajeFinal: w.error || 'Selección vacía',
-        tabla: [],
-        proximosPasos: w.sugerencia ? [w.sugerencia] : [],
-      });
-    }
-    return { ok: false };
-  }
-  return ejecutarUpdate(w);
-}
-
-async function _flujoUninstall() {
-  const w = await ejecutarWizardUninstall();
-  if (!w.exito) {
-    if (w.cancelado) return { ok: true, cancelado: true };
-    if (w.error || w.vacio) {
-      await mostrarResumen({
-        operacion: 'uninstall',
-        ok: false,
-        tituloPrincipal: w.vacio ? 'Nada seleccionado para desinstalar' : 'No se pudo iniciar la desinstalación',
-        mensajeFinal: w.error,
-        tabla: [],
-        proximosPasos: w.sugerencia ? [w.sugerencia] : [],
-      });
-    }
-    return { ok: false };
-  }
-  return ejecutarUninstall(w);
-}
-
-module.exports = { iniciarTui };
+'use strict';
+
+/**
+ * Entry point del TUI de swl-ses.
+ *
+ * Flujo:
+ *   1. Welcome (pantalla de bienvenida + detección de instalaciones)
+ *   2. Menú principal (Install / Update / Inspect / Uninstall)
+ *   3. Wizard correspondiente
+ *   4. Ejecución con UI de progreso
+ *   5. Resumen final
+ *   6. Vuelve al menú principal (a menos que el usuario haya hecho Esc en el menú)
+ *
+ * En no-TTY, el TUI se desactiva automáticamente — cada pantalla devuelve
+ * un valor por defecto sin esperar input. Los caller deben detectar esa
+ * salida y caer al CLI clásico si quieren UX interactivo.
+ */
+
+const { mostrarWelcome } = require('./pantallas/welcome');
+const { mostrarMenuPrincipal } = require('./pantallas/menu-principal');
+const { ejecutarWizardInstall } = require('./pantallas/install-wizard');
+const { ejecutarWizardUpdate } = require('./pantallas/update-wizard');
+const { ejecutarWizardUninstall } = require('./pantallas/uninstall-wizard');
+const { ejecutarInspect } = require('./pantallas/inspect');
+const { ejecutarInstall, ejecutarUpdate, ejecutarUninstall } = require('./ejecutores');
+const { mostrarResumen } = require('./pantallas/resumen');
+const render = require('./lib/render');
+
+/**
+ * Lanza el flujo TUI completo. Devuelve cuando el usuario sale del menú
+ * principal con Esc.
+ *
+ * @param {object} [opciones]
+ * @param {string} [opciones.operacionInicial] - si está dado, salta el menú
+ *        e inicia directamente en esa operación ('install' | 'update' | etc.)
+ * @returns {Promise<{ ok, motivo?, ultimaOperacion? }>}
+ */
+async function iniciarTui(opciones = {}) {
+  // Detección defensiva: si no hay TTY, no entrar al flujo interactivo
+  if (!render.ES_TTY || !process.stdin.isTTY) {
+    return { ok: false, motivo: 'no-tty', mensaje: 'TUI requiere terminal interactiva' };
+  }
+
+  // 1. Welcome (a menos que se haya pedido saltar)
+  if (!opciones.saltarWelcome) {
+    const w = await mostrarWelcome();
+    if (!w.continuar) {
+      return { ok: true, motivo: 'usuario-salio-welcome' };
+    }
+  }
+
+  // 2. Loop principal: menú → operación → vuelve al menú
+  let ultimaOperacion = null;
+  while (true) {
+    let operacion = opciones.operacionInicial;
+    opciones.operacionInicial = null; // solo aplica la primera vez
+
+    if (!operacion) {
+      operacion = await mostrarMenuPrincipal();
+      if (!operacion) {
+        return { ok: true, motivo: 'usuario-salio-menu', ultimaOperacion };
+      }
+    }
+
+    ultimaOperacion = operacion;
+
+    try {
+      await _ejecutarOperacion(operacion);
+    } catch (e) {
+      // Mostrar error como pantalla de resumen y continuar
+      await mostrarResumen({
+        operacion,
+        ok: false,
+        tituloPrincipal: `Error en operación "${operacion}"`,
+        mensajeFinal: e.message,
+        tabla: [['Tipo de error', e.name || 'Error']],
+        proximosPasos: [
+          'Revisa los logs anteriores',
+          'Intenta de nuevo desde el menú',
+          'Si el error persiste: swl-ses doctor',
+        ],
+      });
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Despacho de operaciones
+// ---------------------------------------------------------------------------
+
+async function _ejecutarOperacion(operacion) {
+  switch (operacion) {
+    case 'install':
+      return _flujoInstall();
+    case 'update':
+      return _flujoUpdate();
+    case 'inspect':
+      return ejecutarInspect();
+    case 'uninstall':
+      return _flujoUninstall();
+    default:
+      throw new Error(`Operación no soportada: ${operacion}`);
+  }
+}
+
+async function _flujoInstall() {
+  const w = await ejecutarWizardInstall();
+  if (!w.exito) {
+    if (w.cancelado) return { ok: true, cancelado: true };
+    if (w.error) {
+      await mostrarResumen({
+        operacion: 'install',
+        ok: false,
+        tituloPrincipal: 'No se pudo iniciar la instalación',
+        mensajeFinal: w.error,
+        tabla: [],
+      });
+    }
+    return { ok: false };
+  }
+  return ejecutarInstall(w.opciones);
+}
+
+async function _flujoUpdate() {
+  const w = await ejecutarWizardUpdate();
+  if (!w.exito) {
+    if (w.cancelado) return { ok: true, cancelado: true };
+    if (w.error || w.vacio) {
+      await mostrarResumen({
+        operacion: 'update',
+        ok: false,
+        tituloPrincipal: w.vacio ? 'Nada que actualizar' : 'No se pudo iniciar la actualización',
+        mensajeFinal: w.error || 'Selección vacía',
+        tabla: [],
+        proximosPasos: w.sugerencia ? [w.sugerencia] : [],
+      });
+    }
+    return { ok: false };
+  }
+  return ejecutarUpdate(w);
+}
+
+async function _flujoUninstall() {
+  const w = await ejecutarWizardUninstall();
+  if (!w.exito) {
+    if (w.cancelado) return { ok: true, cancelado: true };
+    if (w.error || w.vacio) {
+      await mostrarResumen({
+        operacion: 'uninstall',
+        ok: false,
+        tituloPrincipal: w.vacio ? 'Nada seleccionado para desinstalar' : 'No se pudo iniciar la desinstalación',
+        mensajeFinal: w.error,
+        tabla: [],
+        proximosPasos: w.sugerencia ? [w.sugerencia] : [],
+      });
+    }
+    return { ok: false };
+  }
+  return ejecutarUninstall(w);
+}
+
+module.exports = { iniciarTui };

package/scripts/tui/lib/colores.js

@@ -1,129 +1,129 @@
-'use strict';
-
-/**
- * Paleta de colores ANSI para la TUI de swl-ses.
- * Zero-deps. Respeta NO_COLOR. Detecta TTY.
- *
- * Diseño: las funciones siempre devuelven string. Si no hay color, devuelven
- * el texto sin modificar — para que el caller pueda concatenar sin checks.
- */
-
-const SOPORTA_COLOR = !process.env.NO_COLOR && process.stdout.isTTY;
-
-function _wrap(codigo, texto) {
-  return SOPORTA_COLOR ? `\x1b[${codigo}m${texto}\x1b[0m` : String(texto);
-}
-
-const colores = {
-  // Texto
-  negro:     (t) => _wrap('30', t),
-  rojo:      (t) => _wrap('31', t),
-  verde:     (t) => _wrap('32', t),
-  amarillo:  (t) => _wrap('33', t),
-  azul:      (t) => _wrap('34', t),
-  magenta:   (t) => _wrap('35', t),
-  cyan:      (t) => _wrap('36', t),
-  blanco:    (t) => _wrap('37', t),
-  gris:      (t) => _wrap('90', t),
-
-  // Brillantes
-  rojoBr:     (t) => _wrap('91', t),
-  verdeBr:    (t) => _wrap('92', t),
-  amarilloBr: (t) => _wrap('93', t),
-  azulBr:     (t) => _wrap('94', t),
-  cyanBr:     (t) => _wrap('96', t),
-
-  // Estilos
-  negrita:    (t) => _wrap('1', t),
-  dim:        (t) => _wrap('2', t),
-  italica:    (t) => _wrap('3', t),
-  subrayado:  (t) => _wrap('4', t),
-  invertido:  (t) => _wrap('7', t),
-
-  // Fondos
-  fondoAzul:    (t) => _wrap('44', t),
-  fondoCyan:    (t) => _wrap('46', t),
-  fondoGris:    (t) => _wrap('100', t),
-};
-
-// Semánticos (para usar en lugar de colores directos)
-const semantico = {
-  exito:    colores.verde,
-  error:    colores.rojo,
-  warn:     colores.amarillo,
-  info:     colores.cyan,
-  hint:     colores.dim,
-  enfasis:  colores.negrita,
-  titulo:   (t) => colores.negrita(colores.cyan(t)),
-  cursor:   colores.cyanBr,
-  badge:    (t) => colores.invertido(` ${t} `),
-};
-
-// Iconos con fallback ASCII
-const iconos = SOPORTA_COLOR ? {
-  check:   '✓',
-  cross:   '✗',
-  warn:    '⚠',
-  arrow:   '→',
-  star:    '★',
-  info:    'ℹ',
-  punto:   '•',
-  cursor:  '❯',
-  cajaVacia: '○',
-  cajaLlena: '◉',
-  flechaArriba: '↑',
-  flechaAbajo: '↓',
-} : {
-  check:   '[OK]',
-  cross:   '[X]',
-  warn:    '[!]',
-  arrow:   '->',
-  star:    '*',
-  info:    '[i]',
-  punto:   '-',
-  cursor:  '>',
-  cajaVacia: '[ ]',
-  cajaLlena: '[x]',
-  flechaArriba: '^',
-  flechaAbajo: 'v',
-};
-
-// Caracteres de borde de caja (Unicode rounded fallback ASCII)
-const borde = SOPORTA_COLOR ? {
-  // Borde rounded
-  esquinaSupIzq:  '╭',
-  esquinaSupDer:  '╮',
-  esquinaInfIzq:  '╰',
-  esquinaInfDer:  '╯',
-  horizontal:     '─',
-  vertical:       '│',
-  cruz:           '┼',
-  tSup:           '┬',
-  tInf:           '┴',
-  tIzq:           '├',
-  tDer:           '┤',
-
-  // Borde doble (para énfasis)
-  dbHorizontal:   '═',
-  dbVertical:     '║',
-  dbEsqSupIzq:    '╔',
-  dbEsqSupDer:    '╗',
-  dbEsqInfIzq:    '╚',
-  dbEsqInfDer:    '╝',
-} : {
-  esquinaSupIzq: '+',  esquinaSupDer: '+',
-  esquinaInfIzq: '+',  esquinaInfDer: '+',
-  horizontal: '-',     vertical: '|',
-  cruz: '+',           tSup: '+', tInf: '+', tIzq: '+', tDer: '+',
-  dbHorizontal: '=',   dbVertical: '|',
-  dbEsqSupIzq: '+',    dbEsqSupDer: '+',
-  dbEsqInfIzq: '+',    dbEsqInfDer: '+',
-};
-
-module.exports = {
-  SOPORTA_COLOR,
-  colores,
-  semantico,
-  iconos,
-  borde,
-};
+'use strict';
+
+/**
+ * Paleta de colores ANSI para la TUI de swl-ses.
+ * Zero-deps. Respeta NO_COLOR. Detecta TTY.
+ *
+ * Diseño: las funciones siempre devuelven string. Si no hay color, devuelven
+ * el texto sin modificar — para que el caller pueda concatenar sin checks.
+ */
+
+const SOPORTA_COLOR = !process.env.NO_COLOR && process.stdout.isTTY;
+
+function _wrap(codigo, texto) {
+  return SOPORTA_COLOR ? `\x1b[${codigo}m${texto}\x1b[0m` : String(texto);
+}
+
+const colores = {
+  // Texto
+  negro:     (t) => _wrap('30', t),
+  rojo:      (t) => _wrap('31', t),
+  verde:     (t) => _wrap('32', t),
+  amarillo:  (t) => _wrap('33', t),
+  azul:      (t) => _wrap('34', t),
+  magenta:   (t) => _wrap('35', t),
+  cyan:      (t) => _wrap('36', t),
+  blanco:    (t) => _wrap('37', t),
+  gris:      (t) => _wrap('90', t),
+
+  // Brillantes
+  rojoBr:     (t) => _wrap('91', t),
+  verdeBr:    (t) => _wrap('92', t),
+  amarilloBr: (t) => _wrap('93', t),
+  azulBr:     (t) => _wrap('94', t),
+  cyanBr:     (t) => _wrap('96', t),
+
+  // Estilos
+  negrita:    (t) => _wrap('1', t),
+  dim:        (t) => _wrap('2', t),
+  italica:    (t) => _wrap('3', t),
+  subrayado:  (t) => _wrap('4', t),
+  invertido:  (t) => _wrap('7', t),
+
+  // Fondos
+  fondoAzul:    (t) => _wrap('44', t),
+  fondoCyan:    (t) => _wrap('46', t),
+  fondoGris:    (t) => _wrap('100', t),
+};
+
+// Semánticos (para usar en lugar de colores directos)
+const semantico = {
+  exito:    colores.verde,
+  error:    colores.rojo,
+  warn:     colores.amarillo,
+  info:     colores.cyan,
+  hint:     colores.dim,
+  enfasis:  colores.negrita,
+  titulo:   (t) => colores.negrita(colores.cyan(t)),
+  cursor:   colores.cyanBr,
+  badge:    (t) => colores.invertido(` ${t} `),
+};
+
+// Iconos con fallback ASCII
+const iconos = SOPORTA_COLOR ? {
+  check:   '✓',
+  cross:   '✗',
+  warn:    '⚠',
+  arrow:   '→',
+  star:    '★',
+  info:    'ℹ',
+  punto:   '•',
+  cursor:  '❯',
+  cajaVacia: '○',
+  cajaLlena: '◉',
+  flechaArriba: '↑',
+  flechaAbajo: '↓',
+} : {
+  check:   '[OK]',
+  cross:   '[X]',
+  warn:    '[!]',
+  arrow:   '->',
+  star:    '*',
+  info:    '[i]',
+  punto:   '-',
+  cursor:  '>',
+  cajaVacia: '[ ]',
+  cajaLlena: '[x]',
+  flechaArriba: '^',
+  flechaAbajo: 'v',
+};
+
+// Caracteres de borde de caja (Unicode rounded fallback ASCII)
+const borde = SOPORTA_COLOR ? {
+  // Borde rounded
+  esquinaSupIzq:  '╭',
+  esquinaSupDer:  '╮',
+  esquinaInfIzq:  '╰',
+  esquinaInfDer:  '╯',
+  horizontal:     '─',
+  vertical:       '│',
+  cruz:           '┼',
+  tSup:           '┬',
+  tInf:           '┴',
+  tIzq:           '├',
+  tDer:           '┤',
+
+  // Borde doble (para énfasis)
+  dbHorizontal:   '═',
+  dbVertical:     '║',
+  dbEsqSupIzq:    '╔',
+  dbEsqSupDer:    '╗',
+  dbEsqInfIzq:    '╚',
+  dbEsqInfDer:    '╝',
+} : {
+  esquinaSupIzq: '+',  esquinaSupDer: '+',
+  esquinaInfIzq: '+',  esquinaInfDer: '+',
+  horizontal: '-',     vertical: '|',
+  cruz: '+',           tSup: '+', tInf: '+', tIzq: '+', tDer: '+',
+  dbHorizontal: '=',   dbVertical: '|',
+  dbEsqSupIzq: '+',    dbEsqSupDer: '+',
+  dbEsqInfIzq: '+',    dbEsqInfDer: '+',
+};
+
+module.exports = {
+  SOPORTA_COLOR,
+  colores,
+  semantico,
+  iconos,
+  borde,
+};