@saulwade/swl-ses 2.6.1 → 2.8.0

package/scripts/tui/componentes/selector-unico.js

@@ -1,158 +1,158 @@
-'use strict';
-
-/**
- * Selector único (single-select) para la TUI.
- * Más rico que `preguntarOpcion` de scripts/lib/ui.js: navegación con flechas,
- * descripciones largas con wrap, soporte para items con etiquetas (badges),
- * pie de página con atajos, indicador de cursor visible.
- *
- * Diseño:
- *   - Cada item: { valor, etiqueta, descripcion?, badge?, deshabilitado? }
- *   - El cursor se mueve solo entre items habilitados.
- *   - Enter resuelve con `items[cursor].valor`.
- *   - Escape resuelve con `null` (señal de "cancelado").
- *
- * No-TTY: resuelve inmediatamente con el item por defecto sin esperar input.
- */
-
-const render = require('../lib/render');
-const teclas = require('../lib/teclas');
-const { colores, semantico, iconos } = require('../lib/colores');
-
-/**
- * @param {object} opciones
- * @param {string} opciones.titulo - Título mostrado arriba de la lista.
- * @param {Array<{valor:string,etiqueta:string,descripcion?:string,badge?:string,deshabilitado?:boolean}>} opciones.items
- * @param {number} [opciones.indiceDefault=0]
- * @param {string} [opciones.hintAtajos] - Hint adicional en el pie (opcional).
- * @returns {Promise<string|null>} - Valor seleccionado o null si se canceló.
- */
-function selectorUnico(opciones) {
-  const items = opciones.items || [];
-  const titulo = opciones.titulo || 'Selecciona una opción:';
-  let cursor = opciones.indiceDefault || 0;
-
-  // Asegurar que el cursor inicial caiga en un item habilitado
-  while (cursor < items.length && items[cursor]?.deshabilitado) cursor++;
-  if (cursor >= items.length) cursor = 0;
-
-  return new Promise((resolve) => {
-    if (!render.ES_TTY || !process.stdin.isTTY) {
-      // No-TTY: devolver el item por defecto sin renderizar
-      const valor = items[cursor]?.valor ?? items[0]?.valor ?? null;
-      resolve(valor);
-      return;
-    }
-
-    function _renderizar() {
-      render.limpiarPantalla();
-      const { cols, rows } = render.obtenerDimensiones();
-
-      // Título
-      render.escribirEn(2, 3, semantico.titulo(titulo));
-
-      // Items
-      const filaInicio = 4;
-      const maxVisible = Math.min(items.length, rows - 6);
-      let scrollOffset = 0;
-      if (cursor < scrollOffset) scrollOffset = cursor;
-      if (cursor >= scrollOffset + maxVisible) scrollOffset = cursor - maxVisible + 1;
-
-      for (let i = scrollOffset; i < Math.min(items.length, scrollOffset + maxVisible); i++) {
-        const item = items[i];
-        const esCursor = i === cursor;
-        const filaItem = filaInicio + (i - scrollOffset);
-
-        let prefijo;
-        if (item.deshabilitado) {
-          prefijo = colores.dim('  ');
-        } else if (esCursor) {
-          prefijo = semantico.cursor(iconos.cursor + ' ');
-        } else {
-          prefijo = '  ';
-        }
-
-        // Etiqueta principal
-        let etiqueta = item.etiqueta;
-        if (item.deshabilitado) {
-          etiqueta = colores.dim(etiqueta);
-        } else if (esCursor) {
-          etiqueta = colores.negrita(etiqueta);
-        }
-
-        // Badge opcional
-        const badge = item.badge ? '  ' + semantico.badge(item.badge) : '';
-
-        render.escribirEn(filaItem, 3, prefijo + etiqueta + badge);
-
-        // Descripción solo del item bajo cursor (panel inferior)
-        if (esCursor && item.descripcion && !item.deshabilitado) {
-          const filaDesc = filaInicio + maxVisible + 1;
-          const maxAnchoDesc = cols - 6;
-          const desc = render.recortar(colores.dim(item.descripcion), maxAnchoDesc);
-          render.escribirEn(filaDesc, 3, desc);
-        }
-      }
-
-      // Indicador de scroll si hay más items abajo
-      if (scrollOffset + maxVisible < items.length) {
-        render.escribirEn(filaInicio + maxVisible, 3,
-          colores.dim(`${iconos.flechaAbajo} ${items.length - scrollOffset - maxVisible} más`));
-      }
-
-      // Pie con atajos
-      const atajos = [
-        ['↑↓', 'navegar'],
-        ['Enter', 'elegir'],
-        ['Esc', 'cancelar'],
-      ];
-      if (opciones.hintAtajos) atajos.push([opciones.hintAtajos, '']);
-      render.dibujarPiePagina(atajos);
-    }
-
-    render.iniciarModoTui();
-    _renderizar();
-
-    const onResize = () => _renderizar();
-    process.stdout.on('resize', onResize);
-
-    const teclado = teclas.crearTeclado();
-
-    function _moverArriba() {
-      // Saltar items deshabilitados
-      let nuevo = cursor;
-      do {
-        nuevo = nuevo > 0 ? nuevo - 1 : items.length - 1;
-      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
-      cursor = nuevo;
-      _renderizar();
-    }
-
-    function _moverAbajo() {
-      let nuevo = cursor;
-      do {
-        nuevo = nuevo < items.length - 1 ? nuevo + 1 : 0;
-      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
-      cursor = nuevo;
-      _renderizar();
-    }
-
-    function _finalizar(valor) {
-      teclado.desactivar();
-      process.stdout.removeListener('resize', onResize);
-      render.salirModoTui();
-      resolve(valor);
-    }
-
-    teclado.on('up', _moverArriba);
-    teclado.on('down', _moverAbajo);
-    teclado.on('return', () => {
-      const item = items[cursor];
-      if (item && !item.deshabilitado) _finalizar(item.valor);
-    });
-    teclado.on('escape', () => _finalizar(null));
-    teclado.activar();
-  });
-}
-
-module.exports = { selectorUnico };
+'use strict';
+
+/**
+ * Selector único (single-select) para la TUI.
+ * Más rico que `preguntarOpcion` de scripts/lib/ui.js: navegación con flechas,
+ * descripciones largas con wrap, soporte para items con etiquetas (badges),
+ * pie de página con atajos, indicador de cursor visible.
+ *
+ * Diseño:
+ *   - Cada item: { valor, etiqueta, descripcion?, badge?, deshabilitado? }
+ *   - El cursor se mueve solo entre items habilitados.
+ *   - Enter resuelve con `items[cursor].valor`.
+ *   - Escape resuelve con `null` (señal de "cancelado").
+ *
+ * No-TTY: resuelve inmediatamente con el item por defecto sin esperar input.
+ */
+
+const render = require('../lib/render');
+const teclas = require('../lib/teclas');
+const { colores, semantico, iconos } = require('../lib/colores');
+
+/**
+ * @param {object} opciones
+ * @param {string} opciones.titulo - Título mostrado arriba de la lista.
+ * @param {Array<{valor:string,etiqueta:string,descripcion?:string,badge?:string,deshabilitado?:boolean}>} opciones.items
+ * @param {number} [opciones.indiceDefault=0]
+ * @param {string} [opciones.hintAtajos] - Hint adicional en el pie (opcional).
+ * @returns {Promise<string|null>} - Valor seleccionado o null si se canceló.
+ */
+function selectorUnico(opciones) {
+  const items = opciones.items || [];
+  const titulo = opciones.titulo || 'Selecciona una opción:';
+  let cursor = opciones.indiceDefault || 0;
+
+  // Asegurar que el cursor inicial caiga en un item habilitado
+  while (cursor < items.length && items[cursor]?.deshabilitado) cursor++;
+  if (cursor >= items.length) cursor = 0;
+
+  return new Promise((resolve) => {
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      // No-TTY: devolver el item por defecto sin renderizar
+      const valor = items[cursor]?.valor ?? items[0]?.valor ?? null;
+      resolve(valor);
+      return;
+    }
+
+    function _renderizar() {
+      render.limpiarPantalla();
+      const { cols, rows } = render.obtenerDimensiones();
+
+      // Título
+      render.escribirEn(2, 3, semantico.titulo(titulo));
+
+      // Items
+      const filaInicio = 4;
+      const maxVisible = Math.min(items.length, rows - 6);
+      let scrollOffset = 0;
+      if (cursor < scrollOffset) scrollOffset = cursor;
+      if (cursor >= scrollOffset + maxVisible) scrollOffset = cursor - maxVisible + 1;
+
+      for (let i = scrollOffset; i < Math.min(items.length, scrollOffset + maxVisible); i++) {
+        const item = items[i];
+        const esCursor = i === cursor;
+        const filaItem = filaInicio + (i - scrollOffset);
+
+        let prefijo;
+        if (item.deshabilitado) {
+          prefijo = colores.dim('  ');
+        } else if (esCursor) {
+          prefijo = semantico.cursor(iconos.cursor + ' ');
+        } else {
+          prefijo = '  ';
+        }
+
+        // Etiqueta principal
+        let etiqueta = item.etiqueta;
+        if (item.deshabilitado) {
+          etiqueta = colores.dim(etiqueta);
+        } else if (esCursor) {
+          etiqueta = colores.negrita(etiqueta);
+        }
+
+        // Badge opcional
+        const badge = item.badge ? '  ' + semantico.badge(item.badge) : '';
+
+        render.escribirEn(filaItem, 3, prefijo + etiqueta + badge);
+
+        // Descripción solo del item bajo cursor (panel inferior)
+        if (esCursor && item.descripcion && !item.deshabilitado) {
+          const filaDesc = filaInicio + maxVisible + 1;
+          const maxAnchoDesc = cols - 6;
+          const desc = render.recortar(colores.dim(item.descripcion), maxAnchoDesc);
+          render.escribirEn(filaDesc, 3, desc);
+        }
+      }
+
+      // Indicador de scroll si hay más items abajo
+      if (scrollOffset + maxVisible < items.length) {
+        render.escribirEn(filaInicio + maxVisible, 3,
+          colores.dim(`${iconos.flechaAbajo} ${items.length - scrollOffset - maxVisible} más`));
+      }
+
+      // Pie con atajos
+      const atajos = [
+        ['↑↓', 'navegar'],
+        ['Enter', 'elegir'],
+        ['Esc', 'cancelar'],
+      ];
+      if (opciones.hintAtajos) atajos.push([opciones.hintAtajos, '']);
+      render.dibujarPiePagina(atajos);
+    }
+
+    render.iniciarModoTui();
+    _renderizar();
+
+    const onResize = () => _renderizar();
+    process.stdout.on('resize', onResize);
+
+    const teclado = teclas.crearTeclado();
+
+    function _moverArriba() {
+      // Saltar items deshabilitados
+      let nuevo = cursor;
+      do {
+        nuevo = nuevo > 0 ? nuevo - 1 : items.length - 1;
+      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
+      cursor = nuevo;
+      _renderizar();
+    }
+
+    function _moverAbajo() {
+      let nuevo = cursor;
+      do {
+        nuevo = nuevo < items.length - 1 ? nuevo + 1 : 0;
+      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
+      cursor = nuevo;
+      _renderizar();
+    }
+
+    function _finalizar(valor) {
+      teclado.desactivar();
+      process.stdout.removeListener('resize', onResize);
+      render.salirModoTui();
+      resolve(valor);
+    }
+
+    teclado.on('up', _moverArriba);
+    teclado.on('down', _moverAbajo);
+    teclado.on('return', () => {
+      const item = items[cursor];
+      if (item && !item.deshabilitado) _finalizar(item.valor);
+    });
+    teclado.on('escape', () => _finalizar(null));
+    teclado.activar();
+  });
+}
+
+module.exports = { selectorUnico };