grmenu 4.1.0 → 5.0.0

data/grmenu/widgets/form.rb

@@ -0,0 +1,533 @@
+# frozen_string_literal: true
+
+# ==============================================================================
+# GRmenu::Widgets::Form - Formulario multi-campo interactivo para la terminal.
+# Permite capturar múltiples datos (texto, contraseñas, números, selectores y booleanos)
+# en una sola pantalla con navegación por Tab/flechas, sombra 3D y retorno como Hash.
+# ==============================================================================
+
+class GRmenu
+  class FormBuilder
+    attr_reader :fields
+
+    def initialize
+      @fields = []
+    end
+
+    def text(key, label, default: "", placeholder: "")
+      @fields << {
+        key: key.to_sym,
+        label: label.to_s,
+        type: :text,
+        value: String.new(default.to_s),
+        placeholder: placeholder.to_s,
+        cursor: default.to_s.length
+      }
+    end
+
+    def password(key, label, default: "", mask: "*")
+      @fields << {
+        key: key.to_sym,
+        label: label.to_s,
+        type: :password,
+        value: String.new(default.to_s),
+        mask: mask.to_s[0] || "*",
+        cursor: default.to_s.length
+      }
+    end
+
+    def number(key, label, default: 0, min: nil, max: nil, step: 1)
+      str = default.to_s
+      @fields << {
+        key: key.to_sym,
+        label: label.to_s,
+        type: :number,
+        value: default.to_i,
+        min: min,
+        max: max,
+        step: [step.to_i, 1].max,
+        raw_str: str,
+        cursor: str.length
+      }
+    end
+
+    def select(key, label, options = [], default: nil)
+      opts = options.is_a?(Array) ? options.map(&:to_s) : []
+      opts = ["(Sin opciones)"] if opts.empty?
+      initial_val = default ? default.to_s : opts.first
+      initial_val = opts.first unless opts.include?(initial_val)
+      @fields << {
+        key: key.to_sym,
+        label: label.to_s,
+        type: :select,
+        options: opts,
+        value: initial_val
+      }
+    end
+
+    def boolean(key, label, default: false)
+      @fields << {
+        key: key.to_sym,
+        label: label.to_s,
+        type: :boolean,
+        value: !!default
+      }
+    end
+    alias_method :checkbox, :boolean
+  end
+
+  # Despliega un formulario interactivo multi-campo unificado en la consola.
+  #
+  # @example Usando bloque DSL:
+  #   datos = GRmenu.form("Nuevo Usuario") do |f|
+  #     f.text :nombre, "Nombre:", placeholder: "Juan Pérez"
+  #     f.password :pass, "Contraseña:"
+  #     f.number :puerto, "Puerto:", default: 8080
+  #     f.select :rol, "Rol:", ["Admin", "Editor", "Lector"]
+  #     f.boolean :ssl, "¿Habilitar SSL?", default: true
+  #   end
+  #   # => { nombre: "...", pass: "...", puerto: 8080, rol: "Admin", ssl: true }
+  def self.form(title = "Formulario de Datos", fields: nil, color: nil, border_color: nil, title_color: nil, focus_color: nil, style: 3, width: nil, shadow: true, cursor_char: "│", submit_label: "Guardar", cancel_label: "Cancelar", center: true, &block)
+    builder = FormBuilder.new
+    if block_given?
+      block.call(builder)
+    elsif fields.is_a?(Array)
+      fields.each do |fld|
+        case (fld[:type] || :text).to_sym
+        when :password
+          builder.password(fld[:key], fld[:label], default: fld[:default] || "", mask: fld[:mask] || "*")
+        when :number
+          builder.number(fld[:key], fld[:label], default: fld[:default] || 0, min: fld[:min], max: fld[:max], step: fld[:step] || 1)
+        when :select
+          builder.select(fld[:key], fld[:label], fld[:options] || [], default: fld[:default])
+        when :boolean, :checkbox
+          builder.boolean(fld[:key], fld[:label], default: fld[:default] || false)
+        else
+          builder.text(fld[:key], fld[:label], default: fld[:default] || "", placeholder: fld[:placeholder] || "")
+        end
+      end
+    end
+
+    all_fields = builder.fields
+    return {} if all_fields.empty?
+
+    form_theme = (@@global_theme.is_a?(Hash) && (@@global_theme.dig(:sections, "form") || @@global_theme.dig(:sections, "input"))) || {}
+    style_num = (style || form_theme["style"] || 3).to_i
+    border_cfg = BORDERS[style_num] || BORDERS[3]
+
+    brd_col_name = (border_color || color || form_theme["border_color"] || form_theme["color"] || "cyan").to_s
+    tit_col_name = (title_color || form_theme["title_color"] || "yellow").to_s
+    foc_col_name = (focus_color || form_theme["focus_color"] || form_theme["focus"] || "green").to_s
+    cur_char     = (cursor_char || form_theme["cursor"] || "│").to_s[0] || "│"
+    is_rgb = (brd_col_name.downcase == "rgb" || brd_col_name.downcase == "rainbow" || brd_col_name.downcase == "chroma")
+
+    term_w = terminal_width
+    label_max_w = all_fields.map { |f| display_width(f[:label]) }.max || 10
+    label_col_w = [label_max_w, 24].min
+
+    title_w = display_width(title.to_s) + 8
+    hint_text = "Tab/↑↓: Mover | Enter: Siguiente | Esc: Cancelar"
+    hint_w = display_width(hint_text) + 6
+
+    min_inner = [title_w, label_col_w + 34, hint_w, 50].max
+    box_w = width ? width.to_i : min_inner + 2
+    box_w = [box_w, term_w - 6].min
+    inner_w = [box_w - 2, 36].max
+    input_box_w = [inner_w - label_col_w - 8, 14].max
+
+    # 0 .. (all_fields.length - 1) son campos, all_fields.length es Guardar, all_fields.length + 1 es Cancelar
+    total_targets = all_fields.length + 2
+    current_focus = 0
+
+    tl = border_cfg[:tl] || "╔"
+    tr = border_cfg[:tr] || "╗"
+    bl = border_cfg[:bl] || "╚"
+    br = border_cfg[:br] || "╝"
+    h_char = border_cfg[:ht] || border_cfg[:h] || "═"
+    v_char = border_cfg[:vl] || border_cfg[:v] || "║"
+
+    left_margin_len = center ? [((term_w - (box_w + (shadow ? 2 : 0))) / 2), 0].max : 0
+    margin = " " * left_margin_len
+
+    drawn_lines = 0
+
+    render_form = lambda do
+      brd_code = is_rgb ? "" : ansi_color(brd_col_name, 1)
+      tit_code = ansi_color(tit_col_name, 2)
+      foc_code = ansi_color(foc_col_name, 2)
+      shd_code = ansi_color("gray", 1)
+      shd_char = shadow ? "▒" : ""
+      rst      = ansi_reset
+
+      lines = []
+
+      # 1. Título superior
+      t_clean = " #{title} "
+      t_w = display_width(t_clean)
+      if t_w > inner_w
+        t_clean = " #{title[0...[inner_w - 6, 1].max]}... "
+        t_w = display_width(t_clean)
+      end
+      l_len = [(inner_w - t_w) / 2, 0].max
+      r_len = [inner_w - t_w - l_len, 0].max
+      top_title_bar = (h_char * l_len) + tit_code + t_clean + brd_code + (h_char * r_len)
+
+      top_line = if is_rgb
+                   Color.rgb("#{tl}#{top_title_bar}#{tr}")
+                 else
+                   "#{brd_code}#{tl}#{top_title_bar}#{tr}#{rst}"
+                 end
+      lines << "#{margin}#{top_line}"
+
+      # Espaciado superior
+      lines << "#{margin}#{brd_code}#{v_char}#{rst}#{' ' * inner_w}#{brd_code}#{v_char}#{rst}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+
+      # 2. Renderizado de cada campo
+      all_fields.each_with_index do |field, f_idx|
+        is_focused = (current_focus == f_idx)
+        raw_label = field[:label].to_s
+        l_pad_len = [label_col_w - display_width(raw_label), 0].max
+        formatted_label = (" " * l_pad_len) + raw_label
+
+        max_text_w = [input_box_w - 3, 1].max
+        val_out = nil
+
+        case field[:type]
+        when :text, :password, :number
+          full_str = case field[:type]
+                     when :password
+                       field[:value].empty? ? "" : (field[:mask] * field[:value].length)
+                     when :number
+                       (field[:raw_str] || field[:value]).to_s
+                     else
+                       field[:value].to_s
+                     end
+
+          cursor_pos = field[:cursor] || full_str.length
+          cursor_pos = [[cursor_pos, 0].max, full_str.length].min
+
+          placeholder = field[:placeholder].to_s
+          has_placeholder = full_str.empty? && !placeholder.empty?
+
+          if is_focused
+            cursor_bar = "\e[1m#{foc_code}#{cur_char}#{rst}"
+
+            if has_placeholder
+              vis_ph = placeholder
+              vis_ph = vis_ph[0...max_text_w] if display_width(vis_ph) > max_text_w
+              content = cursor_bar + Color.gray(vis_ph)
+              content_w = 1 + display_width(vis_ph)
+            else
+              if display_width(full_str) <= max_text_w
+                before = full_str[0...cursor_pos]
+                after  = full_str[cursor_pos..-1]
+                content = Color.bright_white(before) + cursor_bar + Color.bright_white(after)
+                content_w = display_width(full_str) + 1
+              else
+                w_start = [cursor_pos - (max_text_w / 2), 0].max
+                if w_start + max_text_w > full_str.length
+                  w_start = [full_str.length - max_text_w, 0].max
+                end
+                w_end = w_start + max_text_w
+                slice = full_str[w_start...w_end]
+                rel_c = cursor_pos - w_start
+                before = slice[0...rel_c]
+                after  = slice[rel_c..-1]
+                content = Color.bright_white(before) + cursor_bar + Color.bright_white(after)
+                content_w = display_width(slice) + 1
+              end
+            end
+
+            v_pad_len = [input_box_w - content_w - 2, 0].max
+            val_padded = " " + content + (" " * v_pad_len) + " "
+            val_out = "#{foc_code}[#{val_padded}#{foc_code}]#{rst}"
+          else
+            vis_str = has_placeholder ? placeholder : full_str
+            if display_width(vis_str) > (input_box_w - 2)
+              vis_str = vis_str[-[input_box_w - 2, 1].max..-1]
+            end
+            v_pad_len = [input_box_w - display_width(vis_str) - 2, 0].max
+            content = has_placeholder ? Color.gray(vis_str) : Color.bright_white(vis_str)
+            val_padded = " " + content + (" " * v_pad_len) + " "
+            val_out = "#{Color.gray('[')}#{val_padded}#{Color.gray(']')}"
+          end
+
+        when :select
+          val_str = "< #{field[:value]} >"
+          vis_val = val_str
+          if display_width(vis_val) > (input_box_w - 2)
+            vis_val = vis_val[0...[input_box_w - 2, 1].max]
+          end
+          v_pad_len = [input_box_w - display_width(vis_val) - 2, 0].max
+
+          if is_focused
+            content = "#{foc_code}<#{rst} #{Color.bright_white(field[:value])} #{foc_code}>#{rst}"
+            val_padded = " " + content + (" " * v_pad_len) + " "
+            val_out = "#{foc_code}[#{val_padded}#{foc_code}]#{rst}"
+          else
+            content = Color.gray(vis_val)
+            val_padded = " " + content + (" " * v_pad_len) + " "
+            val_out = "#{Color.gray('[')}#{val_padded}#{Color.gray(']')}"
+          end
+
+        when :boolean
+          val_str = field[:value] ? "[X] Sí" : "[ ] No"
+          v_pad_len = [input_box_w - display_width(val_str) - 2, 0].max
+
+          if is_focused
+            bool_text = field[:value] ? Color.bright_green("[X] Sí") : Color.bright_red("[ ] No")
+            val_padded = " " + bool_text + (" " * v_pad_len) + " "
+            val_out = "#{foc_code}[#{val_padded}#{foc_code}]#{rst}"
+          else
+            bool_text = field[:value] ? Color.green("[X] Sí") : Color.gray("[ ] No")
+            val_padded = " " + bool_text + (" " * v_pad_len) + " "
+            val_out = "#{Color.gray('[')}#{val_padded}#{Color.gray(']')}"
+          end
+        end
+
+        label_out = is_focused ? "#{foc_code}#{formatted_label}#{rst}" : Color.white(formatted_label)
+        field_rendered = "  #{label_out} #{val_out}"
+        field_vis_w = display_width(field_rendered)
+        right_pad = [inner_w - field_vis_w, 0].max
+        row_content = field_rendered + (" " * right_pad)
+
+        lines << "#{margin}#{brd_code}#{v_char}#{rst}#{row_content}#{brd_code}#{v_char}#{rst}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+      end
+
+      # Espaciado y divisor interior
+      lines << "#{margin}#{brd_code}#{v_char}#{rst}#{' ' * inner_w}#{brd_code}#{v_char}#{rst}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+      div_inner = "─" * (inner_w - 4)
+      lines << "#{margin}#{brd_code}#{v_char}#{rst}  #{Color.gray(div_inner)}  #{brd_code}#{v_char}#{rst}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+
+      # 3. Botones de acción
+      btn_save_focus = (current_focus == all_fields.length)
+      btn_canc_focus = (current_focus == (all_fields.length + 1))
+
+      btn_save = btn_save_focus ? Color.bright_green("> [ ✔ #{submit_label} ] <") : Color.gray("  [ ✔ #{submit_label} ]  ")
+      btn_canc = btn_canc_focus ? Color.bright_red("> [ ✖ #{cancel_label} ] <")   : Color.gray("  [ ✖ #{cancel_label} ]  ")
+
+      btns_row_raw = (btn_save_focus ? "> [ ✔ #{submit_label} ] <" : "  [ ✔ #{submit_label} ]  ") + "      " + (btn_canc_focus ? "> [ ✖ #{cancel_label} ] <" : "  [ ✖ #{cancel_label} ]  ")
+      btns_vis_w = display_width(btns_row_raw)
+      btns_pad_total = [inner_w - btns_vis_w, 0].max
+      btns_l_pad = " " * (btns_pad_total / 2)
+      btns_r_pad = " " * (btns_pad_total - (btns_pad_total / 2))
+
+      btns_line = "#{btns_l_pad}#{btn_save}      #{btn_canc}#{btns_r_pad}"
+      lines << "#{margin}#{brd_code}#{v_char}#{rst}#{btns_line}#{brd_code}#{v_char}#{rst}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+
+      # Guía de atajos rápida al pie
+      hint_vis_w = display_width(hint_text)
+      hint_pad_total = [inner_w - hint_vis_w, 0].max
+      hint_l_pad = " " * (hint_pad_total / 2)
+      hint_r_pad = " " * (hint_pad_total - (hint_pad_total / 2))
+      lines << "#{margin}#{brd_code}#{v_char}#{rst}#{hint_l_pad}#{Color.gray(hint_text)}#{hint_r_pad}#{brd_code}#{v_char}#{rst}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+
+      # 4. Marco inferior y sombra
+      bot_line = if is_rgb
+                   Color.rgb("#{bl}#{h_char * inner_w}#{br}")
+                 else
+                   "#{brd_code}#{bl}#{h_char * inner_w}#{br}#{rst}"
+                 end
+      lines << "#{margin}#{bot_line}#{shadow ? "#{shd_code}#{shd_char * 2}#{rst}" : ""}"
+
+      # Sombra inferior
+      if shadow
+        lines << "#{margin}  #{shd_code}#{shd_char * box_w}#{rst}"
+      end
+
+      frame = lines.join("\r\n") + "\r\n"
+      Kernel.print("\e[#{drawn_lines}A\e[J") if drawn_lines > 0
+      Kernel.print(frame)
+      $stdout.flush
+      drawn_lines = lines.length
+    end
+
+    is_tty = $stdin.respond_to?(:tty?) && $stdin.tty?
+    result = nil
+
+    begin
+      Kernel.print(HIDE_CURSOR)
+      render_form.call
+
+      reader = lambda do |stream|
+        while (key = GRmenu.read_key_raw(stream))
+          # Esc cancela el formulario completo
+          if key == "\e" || key == "\x03"
+            result = nil
+            break
+
+          # Tab o Flecha Abajo: Siguiente elemento
+          elsif key == "\t" || key == "\e[B" || key == "\eOB" || key == "\xe0P"
+            current_focus = (current_focus + 1) % total_targets
+            render_form.call
+
+          # Shift+Tab o Flecha Arriba: Elemento anterior
+          elsif key == "\e[Z" || key == "\e[A" || key == "\eOA" || key == "\xe0H"
+            current_focus = (current_focus - 1) % total_targets
+            render_form.call
+
+          # Si el foco está en el botón Guardar
+          elsif current_focus == all_fields.length
+            if key == "\r" || key == "\n" || key == " "
+              res_hash = {}
+              all_fields.each { |f| res_hash[f[:key]] = f[:value] }
+              result = res_hash
+              break
+            elsif key == "\e[C" || key == "\eOC" || key == "\xe0M"
+              current_focus = all_fields.length + 1
+              render_form.call
+            end
+
+          # Si el foco está en el botón Cancelar
+          elsif current_focus == (all_fields.length + 1)
+            if key == "\r" || key == "\n" || key == " "
+              result = nil
+              break
+            elsif key == "\e[D" || key == "\eOD" || key == "\xe0K"
+              current_focus = all_fields.length
+              render_form.call
+            end
+
+          # Si el foco está en un campo de entrada
+          else
+            field = all_fields[current_focus]
+
+            case field[:type]
+            when :text, :password
+              if key == "\r" || key == "\n"
+                current_focus = (current_focus + 1) % total_targets
+                render_form.call
+              elsif key == "\x7f" || key == "\b" || key == "\x08" # Backspace
+                if field[:cursor] > 0
+                  field[:value].slice!(field[:cursor] - 1)
+                  field[:cursor] -= 1
+                  render_form.call
+                end
+              elsif key == "\e[3~" # Delete
+                if field[:cursor] < field[:value].length
+                  field[:value].slice!(field[:cursor])
+                  render_form.call
+                end
+              elsif key == "\e[D" || key == "\eOD" || key == "\xe0K" # Flecha izquierda
+                field[:cursor] = [field[:cursor] - 1, 0].max
+                render_form.call
+              elsif key == "\e[C" || key == "\eOC" || key == "\xe0M" # Flecha derecha
+                field[:cursor] = [field[:cursor] + 1, field[:value].length].min
+                render_form.call
+              elsif key == "\x01" || key == "\e[H" || key == "\eOH" || key == "\e[1~" # Inicio / Home
+                field[:cursor] = 0
+                render_form.call
+              elsif key == "\x05" || key == "\e[F" || key == "\eOF" || key == "\e[4~" # Fin / End
+                field[:cursor] = field[:value].length
+                render_form.call
+              elsif key == "\x15" # Ctrl+U: limpiar campo
+                field[:value].clear
+                field[:cursor] = 0
+                render_form.call
+              elsif key =~ /^[[:print:]]$/ # Caracter imprimible
+                field[:value].insert(field[:cursor], key)
+                field[:cursor] += 1
+                render_form.call
+              end
+
+            when :number
+              field[:raw_str] ||= field[:value].to_s
+              field[:cursor]  ||= field[:raw_str].length
+
+              if key == "\r" || key == "\n"
+                current_focus = (current_focus + 1) % total_targets
+                render_form.call
+              elsif key == "+" || key == "="
+                val = field[:value] + field[:step]
+                val = [val, field[:max]].min if field[:max]
+                field[:value] = val
+                field[:raw_str] = val.to_s
+                field[:cursor] = field[:raw_str].length
+                render_form.call
+              elsif key == "-"
+                val = field[:value] - field[:step]
+                val = [val, field[:min]].max if field[:min]
+                field[:value] = val
+                field[:raw_str] = val.to_s
+                field[:cursor] = field[:raw_str].length
+                render_form.call
+              elsif key == "\e[D" || key == "\eOD" || key == "\xe0K" # Flecha izquierda
+                field[:cursor] = [field[:cursor] - 1, 0].max
+                render_form.call
+              elsif key == "\e[C" || key == "\eOC" || key == "\xe0M" # Flecha derecha
+                field[:cursor] = [field[:cursor] + 1, field[:raw_str].length].min
+                render_form.call
+              elsif key == "\x01" || key == "\e[H" || key == "\eOH" || key == "\e[1~" # Inicio / Home
+                field[:cursor] = 0
+                render_form.call
+              elsif key == "\x05" || key == "\e[F" || key == "\eOF" || key == "\e[4~" # Fin / End
+                field[:cursor] = field[:raw_str].length
+                render_form.call
+              elsif key == "\x15" # Ctrl+U: limpiar
+                field[:raw_str] = ""
+                field[:value] = field[:min] || 0
+                field[:cursor] = 0
+                render_form.call
+              elsif key =~ /^[0-9]$/
+                field[:raw_str].insert(field[:cursor], key)
+                field[:cursor] += 1
+                num_val = field[:raw_str].to_i
+                num_val = [num_val, field[:max]].min if field[:max]
+                field[:value] = num_val
+                render_form.call
+              elsif key == "\x7f" || key == "\b" || key == "\x08" # Backspace
+                if field[:cursor] > 0
+                  field[:raw_str].slice!(field[:cursor] - 1)
+                  field[:cursor] -= 1
+                  num_val = field[:raw_str].empty? ? (field[:min] || 0) : field[:raw_str].to_i
+                  field[:value] = num_val
+                  render_form.call
+                end
+              elsif key == "\e[3~" # Delete
+                if field[:cursor] < field[:raw_str].length
+                  field[:raw_str].slice!(field[:cursor])
+                  num_val = field[:raw_str].empty? ? (field[:min] || 0) : field[:raw_str].to_i
+                  field[:value] = num_val
+                  render_form.call
+                end
+              end
+
+            when :select
+              opts = field[:options]
+              cur_idx = opts.index(field[:value]) || 0
+              if key == "\r" || key == "\n"
+                current_focus = (current_focus + 1) % total_targets
+                render_form.call
+              elsif key == "\e[D" || key == "\eOD" || key == "\xe0K"
+                field[:value] = opts[(cur_idx - 1) % opts.length]
+                render_form.call
+              elsif key == "\e[C" || key == "\eOC" || key == "\xe0M" || key == " "
+                field[:value] = opts[(cur_idx + 1) % opts.length]
+                render_form.call
+              end
+
+            when :boolean
+              if key == " " || key == "s" || key == "S" || key == "y" || key == "Y"
+                field[:value] = !field[:value]
+                render_form.call
+              elsif key == "\r" || key == "\n"
+                current_focus = (current_focus + 1) % total_targets
+                render_form.call
+              end
+            end
+          end
+        end
+      end
+
+      if is_tty
+        $stdin.raw { |s| reader.call(s) }
+      else
+        reader.call($stdin)
+      end
+    ensure
+      Kernel.print(SHOW_CURSOR)
+    end
+
+    result
+  end
+end