grmenu 4.1.0 → 5.0.0

data/grmenu/renderer.rb

@@ -0,0 +1,865 @@
+# frozen_string_literal: true
+
+class GRmenu
+  # Aplica color o animación a un fragmento de texto según la configuración de estilo.
+  #
+  # Soporta cuatro modos principales:
+  # 1. Modo Chroma / Rainbow / RGB: espectro multicolor animado caracter por caracter.
+  # 2. Modo Cromático (antes Neón) / Fade: pulso rítmico coordinado sobre el color base.
+  # 3. Colores ANSI indexados o nombres estándar resueltos mediante la paleta de la terminal.
+  # 4. Texto plano si la configuración es nula o vacía.
+  #
+  # @param text [String] El texto a colorear.
+  # @param color_config [Hash, nil] Diccionario con :color y opcionalmente :level.
+  # @param phase_offset [Float] Desfase angular para animaciones sincronizadas entre renglones.
+  # @return [String] Cadena con las secuencias de escape ANSI correspondientes.
+  def colorize(text, color_config, phase_offset = 0.0)
+    return text.to_s if color_config.nil? || color_config.empty?
+
+    color_name = (color_config[:color] || color_config["color"]).to_s.downcase.strip
+    brightness_level = (color_config[:level] || color_config["level"] || 1).to_i
+
+    # Soporte para sintaxis compacta tipo "color:nivel" (ej. "cyan:2")
+    if color_name.include?(":")
+      parts = color_name.split(":")
+      color_name = parts[0].strip
+      brightness_level = parts[1].to_i if parts[1] && !parts[1].empty?
+    end
+
+    is_chromatic_color = color_name.start_with?("chromatic") || color_name.start_with?("cromatico")
+    is_anim_active     = is_chromatic_color || (@animate && ["chromatic", "cromatico", "fade"].include?(@animate.to_s.downcase))
+    is_chroma          = color_name == "rgb" || color_name == "rainbow" || color_name == "chroma" || (@animate && ["rgb", "rainbow", "chroma"].include?(@animate.to_s.downcase))
+
+    # Efecto Chroma / Rainbow: recorremos caracter por caracter aplicando un color del espectro visible
+    if is_chroma
+      tick = @rgb_tick || 0.0
+      out = String.new("")
+      char_count = 0
+      in_escape = false
+      escape_buf = String.new("")
+
+      text.to_s.each_char do |ch|
+        # Si topamos con una secuencia ANSI existente, la conservamos sin romperla
+        if ch == "\e"
+          in_escape = true
+          escape_buf << ch
+          next
+        end
+        if in_escape
+          escape_buf << ch
+          if ch =~ /[a-zA-Z]/
+            in_escape = false
+            out << escape_buf
+            escape_buf.clear
+          end
+          next
+        end
+
+        # Espacios y saltos no necesitan color TrueColor pero avanzan la posicion de columna
+        w = (self.class.char_width(ch) rescue 1)
+        if ch == " " || ch == "\t" || ch == "\r" || ch == "\n"
+          out << ch
+          char_count += w
+        else
+          c_code = self.class.rgb_color(tick, char_count * 0.12 + phase_offset)
+          out << "#{c_code}#{ch}"
+          char_count += w
+        end
+      end
+      out << self.class.ansi_reset
+      return out
+    end
+
+    # Efecto Cromático / Fade: respiración senoidal sincronizada sobre el color base
+    if is_anim_active
+      tick = @rgb_tick || 0.0
+      lookup_name = color_name
+
+      base = if lookup_name =~ /\A#?([0-9a-f]{6})\z/i
+               h = $1
+               [h[0..1].to_i(16), h[2..3].to_i(16), h[4..5].to_i(16)]
+             elsif lookup_name =~ /\A#?([0-9a-f]{3})\z/i
+               h = $1
+               [(h[0] * 2).to_i(16), (h[1] * 2).to_i(16), (h[2] * 2).to_i(16)]
+             else
+               BASE_RGB[lookup_name] || [255, 255, 255]
+             end
+
+      factor = (Math.sin(tick + phase_offset) + 1.0) / 2.0
+      f = 0.35 + 0.65 * factor
+      r = (base[0] * f).clamp(0, 255).to_i
+      g = (base[1] * f).clamp(0, 255).to_i
+      b = (base[2] * f).clamp(0, 255).to_i
+      glow = (factor > 0.85) ? ";1" : ""
+      return "\e[38;2;#{r};#{g};#{b}#{glow}m#{text}#{self.class.ansi_reset}"
+    end
+
+    # Colores estáticos ANSI estándar
+    color_code = self.class.ansi_color(color_name, brightness_level)
+    return text.to_s unless color_code
+
+    "#{color_code}#{text}#{self.class.ansi_reset}"
+  end
+  alias_method :_colorize, :colorize
+
+  # Construye una línea horizontal repitiendo un patrón hasta completar el ancho solicitado.
+  #
+  # @param pattern [String] Caracter o caracteres que forman la línea (ej: "─" o "=").
+  # @param target_width [Integer] Cantidad total de caracteres deseada.
+  # @return [String] Cadena recortada al ancho exacto.
+  def build_horizontal_line(pattern, target_width)
+    return "" if target_width <= 0 || pattern.nil? || pattern.empty?
+
+    pattern_length = pattern.length
+    repetitions_needed = (target_width.to_f / pattern_length).ceil + 1
+    (pattern * repetitions_needed)[0...target_width]
+  end
+  alias_method :_hline, :build_horizontal_line
+
+  # Genera las líneas que componen el banner de título enmarcado (ASCII Art o texto simple).
+  #
+  # @param term_cols [Integer] Ancho actual de la consola para limitar el tamaño.
+  # @return [Array<Array<String>, Integer>] Arreglo con [líneas_generadas, ancho_del_banner].
+  def render_banner_lines(term_cols)
+    return [[], 0] if @banner.nil? || @banner.empty?
+
+    font_id = @style_config.font || 1
+    ascii_rows = self.class.build_ascii_lines(@banner, term_cols, font_id)
+    banner_border = BORDERS[@banner_style] || BORDERS[3]
+    banner_color_cfg = @style_config.banner
+
+    horizontal_top    = banner_border[:ht] || banner_border[:h]
+    horizontal_bottom = banner_border[:hb] || banner_border[:h]
+    vertical_left     = banner_border[:vl] || banner_border[:v]
+    vertical_right    = banner_border[:vr] || banner_border[:v]
+
+    lines = []
+    box_w = 0
+    if ascii_rows
+      content_w = ascii_rows.map { |r| GRmenu.display_width(r) }.max
+      box_w = content_w + 6
+      top_fill = build_horizontal_line(horizontal_top, content_w + 4)
+      bot_fill = build_horizontal_line(horizontal_bottom, content_w + 4)
+
+      lines << colorize("#{banner_border[:tl]}#{top_fill}#{banner_border[:tr]}", banner_color_cfg, 0.0)
+      ascii_rows.each do |row|
+        pad = " " * (content_w - GRmenu.display_width(row))
+        lines << colorize("#{vertical_left}  #{row}#{pad}  #{vertical_right}", banner_color_cfg, 0.0)
+      end
+      lines << colorize("#{banner_border[:bl]}#{bot_fill}#{banner_border[:br]}", banner_color_cfg, 0.0)
+    else
+      clean_b = @banner.strip
+      b_vis_w = GRmenu.display_width(clean_b)
+      box_w = [b_vis_w + 6, term_cols - 2].min
+      top_fill = build_horizontal_line(horizontal_top, box_w - 2)
+      bot_fill = build_horizontal_line(horizontal_bottom, box_w - 2)
+
+      pad_b = [box_w - 4 - b_vis_w, 0].max
+      l_p = " " * (pad_b / 2)
+      r_p = " " * (pad_b - (pad_b / 2))
+
+      lines << colorize("#{banner_border[:tl]}#{top_fill}#{banner_border[:tr]}", banner_color_cfg, 0.0)
+      lines << colorize("#{vertical_left} #{l_p}#{clean_b}#{r_p} #{vertical_right}", banner_color_cfg, 0.0)
+      lines << colorize("#{banner_border[:bl]}#{bot_fill}#{banner_border[:br]}", banner_color_cfg, 0.0)
+    end
+    [lines, box_w]
+  end
+
+  # Renderiza una imagen gráfica en la cabecera del menú enmarcada con los bordes de banner.
+  #
+  # @param term_cols [Integer] Ancho de la terminal.
+  # @return [Array<Array<String>, Integer>] [líneas_renderizadas, ancho_de_caja].
+  def render_image_lines(term_cols)
+    return @cached_image_lines if @cached_image_lines && @cached_image_cols == term_cols
+    return [[], 0] unless @image && File.exist?(@image)
+
+    raw_lines = self.class.load_and_render_image(@image, @image_width || 40, nil, term_cols)
+    return [[], 0] if raw_lines.empty?
+
+    img_w = self.class.display_width(raw_lines.first)
+    box_w = img_w + 4
+    banner_border = BORDERS[@banner_style] || BORDERS[3]
+    banner_color_cfg = @style_config.banner
+
+    horizontal_top    = banner_border[:ht] || banner_border[:h]
+    horizontal_bottom = banner_border[:hb] || banner_border[:h]
+    vertical_left     = banner_border[:vl] || banner_border[:v]
+    vertical_right    = banner_border[:vr] || banner_border[:v]
+
+    top_fill = build_horizontal_line(horizontal_top, img_w + 2)
+    bot_fill = build_horizontal_line(horizontal_bottom, img_w + 2)
+
+    b_col_name = (banner_color_cfg[:color] || banner_color_cfg["color"]).to_s.downcase
+    is_img_chroma = b_col_name == "rgb" || b_col_name == "rainbow" || b_col_name == "chroma" || (@animate && ["rgb", "rainbow", "chroma"].include?(@animate.to_s.downcase))
+    img_r_offset = is_img_chroma ? (box_w - 1) * 0.12 : 0.0
+
+    lines = []
+    lines << colorize("#{banner_border[:tl]}#{top_fill}#{banner_border[:tr]}", banner_color_cfg, 0.0)
+    raw_lines.each do |r_line|
+      lines << "#{colorize(vertical_left, banner_color_cfg, 0.0)} #{r_line} #{colorize(vertical_right, banner_color_cfg, img_r_offset)}"
+    end
+    lines << colorize("#{banner_border[:bl]}#{bot_fill}#{banner_border[:br]}", banner_color_cfg, 0.0)
+
+    @cached_image_cols = term_cols
+    @cached_image_lines = [lines, box_w]
+    @cached_image_lines
+  end
+
+  # Determina si una acción representa un submenú anidado.
+  #
+  # @param action [Object] Elemento del menú (Array, Hash, GRmenu, etc.).
+  # @return [Boolean] true si contiene subopciones.
+  def is_submenu_item?(action)
+    if action.is_a?(Array)
+      target = action[1]
+      return true if target.is_a?(Array) && (target.empty? || target.first.is_a?(Array) || target.first.is_a?(Proc) || target.first.is_a?(Method) || target.first.is_a?(Symbol))
+      return true if target.is_a?(GRmenu)
+    elsif action.is_a?(Hash)
+      return true if action[:submenu] || action["submenu"]
+    end
+    false
+  end
+
+  # Obtiene la lista de acciones hijas de un submenú.
+  #
+  # @param action [Object] Elemento del menú que contiene el submenú.
+  # @return [Array, nil] Las opciones anidadas.
+  def get_submenu_actions(action)
+    if action.is_a?(Array)
+      action[1].is_a?(GRmenu) ? action[1].instance_variable_get(:@functions) : action[1]
+    elsif action.is_a?(Hash)
+      action[:submenu] || action["submenu"]
+    end
+  end
+
+  # Dibuja la caja flotante lateral correspondiente a un nivel de submenú en cascada.
+  #
+  # @param sub_actions [Array] Lista de opciones dentro del submenú.
+  # @param parent_title [String] Título del menú padre que encabeza la cajita.
+  # @param is_active [Boolean] Si el foco del teclado se encuentra actualmente en este submenú.
+  # @param selected_idx [Integer] Índice de la opción seleccionada dentro del submenú.
+  # @return [Array<Array<String>, Integer, Integer>] [líneas, ancho_de_caja, renglón_del_item_activo].
+  def render_submenu_box(sub_actions, parent_title = "", is_active: false, selected_idx: 0)
+    sub_names = sub_actions.map { |a| extract_name_from_action(a) }
+    max_name_len = sub_names.empty? ? 10 : sub_names.map { |n| GRmenu.display_width(n) }.max
+    sub_title = parent_title.to_s
+    sub_w = [max_name_len + 8, GRmenu.display_width(sub_title) + 6, 20].max
+    sub_w = [sub_w, 36].min
+    inner_w = [sub_w - 2, 8].max
+
+    submenu_theme = (@@global_theme.is_a?(Hash) && @@global_theme.dig(:sections, "submenu")) || {}
+    sub_style = (submenu_theme["style"] || @style || 3).to_i
+    sub_border = BORDERS[sub_style] || BORDERS[3]
+    horizontal_top    = sub_border[:ht] || sub_border[:h]
+    horizontal_bottom = sub_border[:hb] || sub_border[:h]
+    vertical_left     = sub_border[:vl] || sub_border[:v]
+    vertical_right    = sub_border[:vr] || sub_border[:v]
+
+    border_color_val  = submenu_theme["border"] || submenu_theme["border_color"] || @style_config.border[:color] || "cyan"
+    focus_color_val   = submenu_theme["focus"] || submenu_theme["focus_color"] || @style_config.focus[:color] || "yellow"
+    options_color_val = submenu_theme["options"] || submenu_theme["options_color"] || @style_config.options[:color] || "white"
+
+    sub_border_cfg = { color: border_color_val, level: 1 }
+    sub_focus_cfg  = { color: focus_color_val, level: 2 }
+    sub_opt_cfg    = { color: options_color_val, level: 1 }
+    sub_held_cfg   = { color: "yellow", level: 1 }
+
+    sub_border_is_chroma = (border_color_val == "rgb" || border_color_val == "rainbow" || border_color_val == "chroma" || (@animate && ["rgb", "rainbow", "chroma"].include?(@animate.to_s.downcase)))
+    sub_r_offset = sub_border_is_chroma ? (sub_w - 1) * 0.12 : 0.0
+
+    lines = []
+    top_fill = build_horizontal_line(horizontal_top, inner_w)
+    bot_fill = build_horizontal_line(horizontal_bottom, inner_w)
+
+    top_border_line = sub_border[:tl] + top_fill + sub_border[:tr]
+    lines << colorize(top_border_line, sub_border_cfg, 0.0)
+
+    unless sub_title.empty?
+      pad_t = [inner_w - 2 - GRmenu.display_width(sub_title), 0].max
+      t_padded = " " * (pad_t / 2) + sub_title + " " * (pad_t - (pad_t / 2))
+      c_title  = colorize(t_padded, sub_focus_cfg, sub_border_is_chroma ? 2 * 0.12 : 0.0)
+      v_l_col  = colorize(vertical_left, sub_border_cfg, 0.0)
+      v_r_col  = colorize(vertical_right, sub_border_cfg, sub_r_offset)
+      lines << "#{v_l_col} #{c_title} #{v_r_col}"
+      mid_fill = build_horizontal_line(horizontal_top, inner_w)
+      lines << colorize(vertical_left + mid_fill + vertical_right, sub_border_cfg, 0.0)
+    end
+
+    parent_item_row = nil
+    sub_names.each_with_index do |s_name, s_idx|
+      is_sub = is_submenu_item?(sub_actions[s_idx])
+      arrow = is_sub ? "▶" : ""
+      is_selected = (s_idx == selected_idx)
+      parent_item_row = lines.length if is_selected
+
+      prefix = is_selected ? "> " : "  "
+      pad_s = [inner_w - 2 - prefix.length - GRmenu.display_width(s_name) - (is_sub ? 2 : 0), 0].max
+      raw_item = if is_sub
+                   "#{prefix}#{s_name}#{' ' * pad_s} #{arrow}"
+                 else
+                   "#{prefix}#{s_name}#{' ' * pad_s}"
+                 end
+
+      item_cfg = if is_selected
+                   is_active ? sub_focus_cfg : sub_held_cfg
+                 else
+                   sub_opt_cfg
+                 end
+
+      sub_item_phase = sub_border_is_chroma ? 2 * 0.12 : 0.0
+      colored_item = colorize(raw_item, item_cfg, sub_item_phase)
+      v_l_col = colorize(vertical_left, sub_border_cfg, 0.0)
+      v_r_col = colorize(vertical_right, sub_border_cfg, sub_r_offset)
+      lines << "#{v_l_col} #{colored_item} #{v_r_col}"
+    end
+
+    bot_border_line = sub_border[:bl] + bot_fill + sub_border[:br]
+    lines << colorize(bot_border_line, sub_border_cfg, 0.0)
+
+    [lines, sub_w, parent_item_row]
+  end
+
+  # Renderiza el menú completo (cabecera, pestañas, marco principal, submenús y descripción).
+  #
+  # Devuelve una lista de líneas de texto ya coloreadas y formateadas listas para imprimir.
+  # Todos los elementos del marco (bordes superior, inferior, laterales y separadores)
+  # se encuentran en fase sincronizada (fase 0.0) para garantizar que respiren o brillen en
+  # conjunto y ningún borde quede desfasado.
+  #
+  # @param size_max [Integer] Ancho sugerido para la caja.
+  # @return [Array<String>] Líneas finales del frame.
+  def render_lines(size_max = 20)
+    term_cols = self.class.terminal_width
+    term_rows = self.class.terminal_height
+    rendered_lines = []
+
+    # Reinicializamos mapas de impacto del ratón
+    @row_hit_map    = {}
+    @tab_ranges     = {}
+    @tabs_row       = nil
+    @up_arrow_row   = nil
+    @down_arrow_row = nil
+    @sub_hit_map    = {}
+    @sub_1_hit_map  = {}
+    @sub_2_hit_map  = {}
+    @sub_1_col_rng  = nil
+    @sub_2_col_rng  = nil
+
+    header_box_width = 0
+    header_lines_count = 0
+
+    # 1. Imagen superior si existe
+    if @image && File.exist?(@image)
+      img_lines, img_box_w = render_image_lines(term_cols)
+      unless img_lines.empty?
+        img_pad = (@center && term_cols > img_box_w) ? " " * ((term_cols - img_box_w) / 2) : ""
+        rendered_lines.concat(img_lines.map { |l| "#{img_pad}#{l}" })
+        rendered_lines << ""
+        header_lines_count += img_lines.length + 1
+        header_box_width = [header_box_width, img_box_w].max
+      end
+    end
+
+    # 2. Banner ASCII o título superior
+    if @banner && !@banner.empty?
+      banner_lines, banner_box_w = render_banner_lines(term_cols)
+      unless banner_lines.empty?
+        b_pad = (@center && term_cols > banner_box_w) ? " " * ((term_cols - banner_box_w) / 2) : ""
+        rendered_lines.concat(banner_lines.map { |l| "#{b_pad}#{l}" })
+        rendered_lines << ""
+        header_lines_count += banner_lines.length + 1
+        header_box_width = [header_box_width, banner_box_w].max
+      end
+    end
+
+    matching_indices = current_matching_indices
+    all_names = @functions.map { |func| extract_name_from_action(func) }
+    all_descriptions = @functions.map { |func| extract_description_from_action(func) }
+
+    active_desc = all_descriptions[@index] || ""
+
+    cols = @columns
+    max_item_len = all_names.empty? ? 10 : all_names.map { |n| GRmenu.display_width(n) }.max
+    grid_suggested_w = (max_item_len + 6) * cols + 4
+
+    calculated_width = [size_max, GRmenu.display_width(@title) + 4, grid_suggested_w].max
+    calculated_width = ([calculated_width, GRmenu.display_width(active_desc) + 8].max) unless active_desc.empty?
+    calculated_width = ([calculated_width, GRmenu.display_width(@query) + 16].max) if @search
+    if @tabs && !@tabs.empty?
+      tabs_min_w = @tabs.map { |t| GRmenu.display_width(t) + 4 }.sum + (@tabs.length - 1) * 3
+      calculated_width = [calculated_width, tabs_min_w + 4].max
+    end
+    total_width = [calculated_width, term_cols - 2].min
+
+    # Cálculo de anchos para submenús laterales (si están abiertos)
+    sub_1_preview_w = 0
+    sub_2_preview_w = 0
+    if @open_level >= 1 && is_submenu_item?(@functions[@index])
+      s1_acts = get_submenu_actions(@functions[@index])
+      if s1_acts && !s1_acts.empty?
+        s1_names = s1_acts.map { |a| extract_name_from_action(a) }
+        s1_max = s1_names.empty? ? 10 : s1_names.map { |n| GRmenu.display_width(n) }.max
+        s1_title = all_names[@index] || ""
+        sub_1_preview_w = [s1_max + 8, GRmenu.display_width(s1_title) + 6, 20].max
+        sub_1_preview_w = [sub_1_preview_w, 36].min
+
+        if @open_level >= 2 && is_submenu_item?(s1_acts[@sub_index_1])
+          s2_acts = get_submenu_actions(s1_acts[@sub_index_1])
+          if s2_acts && !s2_acts.empty?
+            s2_names = s2_acts.map { |a| extract_name_from_action(a) }
+            s2_max = s2_names.empty? ? 10 : s2_names.map { |n| GRmenu.display_width(n) }.max
+            s2_title = extract_name_from_action(s1_acts[@sub_index_1]) || ""
+            sub_2_preview_w = [s2_max + 8, GRmenu.display_width(s2_title) + 6, 20].max
+            sub_2_preview_w = [sub_2_preview_w, 36].min
+          end
+        end
+      end
+    end
+
+    total_chain_w = total_width
+    total_chain_w += 2 + sub_1_preview_w if sub_1_preview_w > 0
+    total_chain_w += 2 + sub_2_preview_w if sub_2_preview_w > 0
+
+    margin_left = if @center && term_cols > total_chain_w
+                    " " * ((term_cols - total_chain_w) / 2)
+                  elsif @center && term_cols > total_width
+                    " " * ((term_cols - total_width) / 2)
+                  else
+                    ""
+                  end
+
+    # 3. Subtítulo y divisores
+    subtitle_lines_count = 0
+    if @subtitle && !@subtitle.empty?
+      subtitle_lines = @subtitle.lines.map(&:chomp)
+      ref_sub_w = header_box_width > 0 ? header_box_width : total_chain_w
+      div_w = @divider.is_a?(Numeric) ? @divider.to_i : [ref_sub_w, term_cols - 2].min
+      sub_pad = (@center && term_cols > div_w) ? " " * ((term_cols - div_w) / 2) : ""
+
+      if @divider
+        rendered_lines << "#{sub_pad}#{colorize("─" * div_w, @style_config.divider, 0.0)}"
+        subtitle_lines_count += 1
+      end
+
+      subtitle_lines.each_with_index do |sub_line, s_i|
+        pad_sub = [div_w - GRmenu.display_width(sub_line), 0].max
+        formatted_sub = @center ? (" " * (pad_sub / 2) + sub_line + " " * (pad_sub - (pad_sub / 2))) : sub_line
+        rendered_lines << "#{sub_pad}#{colorize(formatted_sub, @style_config.subtitle, 0.0)}"
+        subtitle_lines_count += 1
+      end
+
+      if @divider
+        rendered_lines << "#{sub_pad}#{colorize("─" * div_w, @style_config.divider, 0.0)}"
+        subtitle_lines_count += 1
+      end
+      rendered_lines << ""
+      subtitle_lines_count += 1
+    end
+
+    border_color_cfg  = @style_config.border
+    options_color_cfg = @style_config.options
+    focus_color_cfg   = @style_config.focus
+    title_color_cfg   = @style_config.title
+
+    box_border = BORDERS[@style] || BORDERS[@style.to_i] || BORDERS[3]
+
+    overhead = header_lines_count + subtitle_lines_count + 6
+    overhead += 2 unless active_desc.empty?
+    overhead += 2 if @search
+    available_rows = [term_rows - overhead - 2, 2].max
+
+    rows_data = matching_indices.each_slice(cols).to_a
+    total_rows = rows_data.length
+
+    effective_page_rows = if @page_size && @page_size > 0
+                            [@page_size, total_rows, available_rows].min
+                          else
+                            [total_rows, available_rows].min
+                          end
+    effective_page_rows = [effective_page_rows, 1].max
+
+    curr_matching_pos = matching_indices.index(@index) || 0
+    curr_row = total_rows > 0 ? (curr_matching_pos / cols) : 0
+
+    start_row = 0
+    end_row = [total_rows - 1, 0].max
+    if total_rows > effective_page_rows
+      half_r = effective_page_rows / 2
+      start_row = [[curr_row - half_r, 0].max, total_rows - effective_page_rows].min
+      end_row = start_row + effective_page_rows - 1
+    end
+
+    visible_rows_data = rows_data[start_row..end_row] || []
+    has_more_above = start_row > 0
+    has_more_below = end_row < (total_rows - 1)
+
+    avail_w = [total_width - 4, 1].max
+    col_w = [(avail_w - (cols - 1) * 2) / cols, 1].max
+
+    # 4. Barra de pestañas (Tabs)
+    if @tabs && !@tabs.empty?
+      tab_strs = []
+      raw_tab_strs = []
+      @tab_ranges = {}
+      @tabs.each_with_index do |t_name, t_i|
+        is_active = (t_i == @active_tab_idx)
+        raw_t = is_active ? "[ #{t_name} ]" : "  #{t_name}  "
+        colored_t = if is_active
+                      colorize(raw_t, { color: @active_tab_color, level: 2 }, 0.0)
+                    else
+                      colorize(raw_t, { color: @tab_color, level: 1 }, 0.0)
+                    end
+        tab_strs << colored_t
+        raw_tab_strs << raw_t
+      end
+      raw_tabs_joined = raw_tab_strs.join("   ")
+      tabs_w = GRmenu.display_width(raw_tabs_joined)
+      l_tabs_pad = [(total_width - tabs_w) / 2, 0].max
+      formatted_tabs = (" " * l_tabs_pad) + tab_strs.join("   ")
+
+      start_col = margin_left.length + l_tabs_pad
+      cur_x = start_col
+      @tabs.each_with_index do |_t_name, t_i|
+        t_len = GRmenu.display_width(raw_tab_strs[t_i])
+        @tab_ranges[t_i] = (cur_x + 1)..(cur_x + t_len)
+        cur_x += t_len + 3
+      end
+
+      @tabs_row = rendered_lines.length + 1
+      rendered_lines << "#{margin_left}#{formatted_tabs}"
+      rendered_lines << ""
+    end
+
+    # 5. Caja principal de opciones: BORDES 100% SINCRONIZADOS
+    if box_border
+      horizontal_top    = box_border[:ht] || box_border[:h]
+      horizontal_bottom = box_border[:hb] || box_border[:h]
+      vertical_left_raw  = box_border[:vl] || box_border[:v]
+      vertical_right_raw = box_border[:vr] || box_border[:v]
+
+      top_fill = build_horizontal_line(horizontal_top, total_width - 2)
+      bot_fill = build_horizontal_line(horizontal_bottom, total_width - 2)
+      mid_fill = build_horizontal_line(horizontal_top, total_width - 2)
+
+      # Determinamos si el borde es Chroma espectral continuo para alinear geométricamente
+      # el borde derecho con la columna final, mientras que en modo cromático pulsante
+      # ambos lados respiran en fase 0.0 idéntica.
+      b_name = (border_color_cfg[:color] || border_color_cfg["color"]).to_s.downcase
+      is_border_chroma = (b_name == "rgb" || b_name == "rainbow" || b_name == "chroma" || (@animate && ["rgb", "rainbow", "chroma"].include?(@animate.to_s.downcase)))
+      v_r_offset = is_border_chroma ? (total_width - 1) * 0.12 : 0.0
+
+      v_left  = colorize(vertical_left_raw, border_color_cfg, 0.0)
+      v_right = colorize(vertical_right_raw, border_color_cfg, v_r_offset)
+
+      main_box_start = rendered_lines.length
+      top_border_line = box_border[:tl] + top_fill + box_border[:tr]
+      rendered_lines << "#{margin_left}#{colorize(top_border_line, border_color_cfg, 0.0)}"
+
+      unless @title.empty?
+        pad_t = [total_width - 4 - GRmenu.display_width(@title), 0].max
+        title_padded = " " * (pad_t / 2) + @title + " " * (pad_t - (pad_t / 2))
+        centered_title = colorize(title_padded, title_color_cfg, is_border_chroma ? 2 * 0.12 : 0.0)
+        rendered_lines << "#{margin_left}#{v_left} #{centered_title} #{v_right}"
+
+        separator_line = vertical_left_raw + mid_fill + vertical_right_raw
+        rendered_lines << "#{margin_left}#{colorize(separator_line, border_color_cfg, 0.0)}"
+      end
+
+      if @search
+        search_prompt = "Buscar: #{@query}█"
+        pad_s = [avail_w - GRmenu.display_width(search_prompt), 0].max
+        search_padded = search_prompt + (" " * pad_s)
+        search_colored = colorize(search_padded, { color: "bright_yellow" }, is_border_chroma ? 2 * 0.12 : 0.0)
+        rendered_lines << "#{margin_left}#{v_left} #{search_colored} #{v_right}"
+        separator_line = vertical_left_raw + mid_fill + vertical_right_raw
+        rendered_lines << "#{margin_left}#{colorize(separator_line, border_color_cfg, 0.0)}"
+      end
+
+      if has_more_above
+        @up_arrow_row = rendered_lines.length + 1
+        up_text = "▲ (+#{start_row} #{cols > 1 ? 'filas' : 'arriba'})"
+        pad_up = [avail_w - GRmenu.display_width(up_text), 0].max
+        up_indicator = colorize(" " * (pad_up / 2) + up_text + " " * (pad_up - (pad_up / 2)), { color: "gray", level: 2 }, is_border_chroma ? 2 * 0.12 : 0.0)
+        rendered_lines << "#{margin_left}#{v_left} #{up_indicator} #{v_right}"
+      end
+
+      parent_row_idx = nil
+      if rows_data.empty?
+        no_res_txt = "(Sin resultados)"
+        pad_no = [avail_w - GRmenu.display_width(no_res_txt), 0].max
+        no_res = colorize(" " * (pad_no / 2) + no_res_txt + " " * (pad_no - (pad_no / 2)), { color: "gray", level: 1 }, is_border_chroma ? 2 * 0.12 : 0.0)
+        rendered_lines << "#{margin_left}#{v_left} #{no_res} #{v_right}"
+      else
+        visible_rows_data.each_with_index do |row_indices, r_idx|
+          cells = []
+          cols.times do |c_idx|
+            item_idx = row_indices[c_idx]
+            col_offset = 2 + c_idx * (col_w + 2)
+            cell_phase = is_border_chroma ? (col_offset * 0.12) : 0.0
+            if item_idx
+              op_name = all_names[item_idx]
+              is_sub = is_submenu_item?(@functions[item_idx])
+              arrow = is_sub ? "▶" : ""
+              if @index == item_idx
+                parent_row_idx = rendered_lines.length
+                cell_raw = if is_sub
+                             pad_sub = [col_w - 2 - GRmenu.display_width(op_name) - 2, 0].max
+                             "> #{op_name}#{' ' * pad_sub}#{arrow}"
+                           else
+                             "> #{op_name}"
+                           end
+                pad_c = [col_w - GRmenu.display_width(cell_raw), 0].max
+                cells << colorize(cell_raw + (" " * pad_c), focus_color_cfg, cell_phase)
+              else
+                cell_raw = if is_sub
+                             pad_sub = [col_w - 2 - GRmenu.display_width(op_name) - 2, 0].max
+                             "  #{op_name}#{' ' * pad_sub}#{arrow}"
+                           else
+                             "  #{op_name}"
+                           end
+                pad_c = [col_w - GRmenu.display_width(cell_raw), 0].max
+                cells << colorize(cell_raw + (" " * pad_c), options_color_cfg, cell_phase)
+              end
+            else
+              cells << (" " * col_w)
+            end
+          end
+          row_str = cells.join("  ")
+          pad_r = [avail_w - (col_w * cols + (cols - 1) * 2), 0].max
+          row_padded = row_str + (" " * pad_r)
+          cur_line_num = rendered_lines.length + 1
+          @row_hit_map[cur_line_num] = { row_indices: row_indices, cols: cols, col_w: col_w, margin_left: margin_left.length }
+          rendered_lines << "#{margin_left}#{v_left} #{row_padded} #{v_right}"
+        end
+      end
+
+      if has_more_below
+        @down_arrow_row = rendered_lines.length + 1
+        remaining_below = total_rows - 1 - end_row
+        down_text = "▼ (+#{remaining_below} #{cols > 1 ? 'filas' : 'abajo'})"
+        pad_down = [avail_w - GRmenu.display_width(down_text), 0].max
+        down_indicator = colorize(" " * (pad_down / 2) + down_text + " " * (pad_down - (pad_down / 2)), { color: "gray", level: 2 }, is_border_chroma ? 2 * 0.12 : 0.0)
+        rendered_lines << "#{margin_left}#{v_left} #{down_indicator} #{v_right}"
+      end
+
+      unless active_desc.empty?
+        separator_line = vertical_left_raw + mid_fill + vertical_right_raw
+        rendered_lines << "#{margin_left}#{colorize(separator_line, border_color_cfg, 0.0)}"
+        pfx = (@style_config&.desc_prefix || @desc_prefix || SetStyle.desc_prefix || "[i]").to_s
+        pfx = "#{pfx} " unless pfx.end_with?(" ")
+        raw_desc = "#{pfx}#{active_desc}"
+        pad_d = [avail_w - GRmenu.display_width(raw_desc), 0].max
+        desc_text = colorize(raw_desc + (" " * pad_d), { color: "cyan", level: 1 }, is_border_chroma ? 2 * 0.12 : 0.0)
+        rendered_lines << "#{margin_left}#{v_left} #{desc_text} #{v_right}"
+      end
+
+      bottom_border_line = box_border[:bl] + bot_fill + box_border[:br]
+      rendered_lines << "#{margin_left}#{colorize(bottom_border_line, border_color_cfg, 0.0)}"
+    end
+
+    # 6. Costura lateral de submenús flotantes si están abiertos
+    if @open_level >= 1 && is_submenu_item?(@functions[@index]) && parent_row_idx
+      sub_1_acts = get_submenu_actions(@functions[@index])
+      if sub_1_acts && !sub_1_acts.empty?
+        sub_1_title = all_names[@index] || "Submenu"
+        sub_1_lines, sub_1_w, p_row_1 = render_submenu_box(sub_1_acts, sub_1_title, is_active: (@level == 1), selected_idx: @sub_index_1)
+
+        sub_2_acts = nil
+        sub_2_lines = nil
+        sub_2_w = 0
+        p_row_2 = nil
+        if @open_level >= 2 && is_submenu_item?(sub_1_acts[@sub_index_1])
+          sub_2_acts = get_submenu_actions(sub_1_acts[@sub_index_1])
+          if sub_2_acts && !sub_2_acts.empty?
+            sub_2_title = extract_name_from_action(sub_1_acts[@sub_index_1]) || "Submenu"
+            sub_2_lines, sub_2_w, p_row_2 = render_submenu_box(sub_2_acts, sub_2_title, is_active: (@level == 2), selected_idx: @sub_index_2)
+          end
+        end
+
+        # Si caben 3 cajas en la terminal horizontalmente
+        if sub_2_lines
+          total_3_w = margin_left.length + total_width + 2 + sub_1_w + 2 + sub_2_w
+          if total_3_w <= term_cols
+            sub_1_start = main_box_start
+            p1_abs_row = sub_1_start + (p_row_1 || 1)
+            sub_2_start = main_box_start
+            max_3_lines = [rendered_lines.length, sub_1_start + sub_1_lines.length, sub_2_start + sub_2_lines.length].max
+
+            x1_start = margin_left.length + total_width + 2
+            x1_end   = x1_start + sub_1_w
+            x2_start = x1_end + 2
+            x2_end   = x2_start + sub_2_w
+            @sub_1_col_rng = (x1_start..x1_end)
+            @sub_2_col_rng = (x2_start..x2_end)
+
+            sub_1_offset = sub_1_title.empty? ? 1 : 3
+            sub_2_offset = sub_2_title.empty? ? 1 : 3
+
+            stitched_lines = []
+            max_3_lines.times do |i|
+              l0 = rendered_lines[i] || ("#{margin_left}#{' ' * total_width}")
+
+              l1 = " " * sub_1_w
+              br1 = "  "
+              if i >= sub_1_start && i < (sub_1_start + sub_1_lines.length)
+                s1_idx = i - sub_1_start
+                l1 = sub_1_lines[s1_idx]
+                br1 = (i == parent_row_idx) ? "──" : "  "
+                s1_item = s1_idx - sub_1_offset
+                if s1_item >= 0 && s1_item < sub_1_acts.length
+                  @sub_1_hit_map[i + 1] = s1_item
+                  @sub_hit_map[i + 1] = s1_item
+                end
+              end
+
+              l2 = ""
+              br2 = ""
+              if i >= sub_2_start && i < (sub_2_start + sub_2_lines.length)
+                s2_idx = i - sub_2_start
+                l2 = sub_2_lines[s2_idx]
+                br2 = (i == p1_abs_row) ? "──" : "  "
+                s2_item = s2_idx - sub_2_offset
+                if s2_item >= 0 && s2_item < sub_2_acts.length
+                  @sub_2_hit_map[i + 1] = s2_item
+                end
+              end
+
+              stitched_lines << "#{l0}#{br1}#{l1}#{br2}#{l2}".rstrip
+            end
+            rendered_lines = stitched_lines
+          elsif (sub_1_w + 2 + sub_2_w) <= term_cols
+            p1_abs_row = (p_row_1 || 1)
+            sub_2_start = main_box_start
+            max_2_lines = [sub_1_lines.length, sub_2_start + sub_2_lines.length].max
+
+            x1_start = margin_left.length
+            x1_end   = x1_start + sub_1_w
+            x2_start = x1_end + 2
+            x2_end   = x2_start + sub_2_w
+            @sub_1_col_rng = (x1_start..x1_end)
+            @sub_2_col_rng = (x2_start..x2_end)
+
+            sub_1_offset = sub_1_title.empty? ? 1 : 3
+            sub_2_offset = sub_2_title.empty? ? 1 : 3
+
+            stitched_lines = []
+            max_2_lines.times do |i|
+              l1 = sub_1_lines[i] || (" " * sub_1_w)
+              l2 = ""
+              br2 = ""
+              if i >= sub_2_start && i < (sub_2_start + sub_2_lines.length)
+                s2_idx = i - sub_2_start
+                l2 = sub_2_lines[s2_idx]
+                br2 = (i == p1_abs_row) ? "──" : "  "
+                s2_item = s2_idx - sub_2_offset
+                @sub_2_hit_map[i + 1] = s2_item if s2_item >= 0 && s2_item < sub_2_acts.length
+              end
+              s1_item = i - sub_1_offset
+              if s1_item >= 0 && s1_item < sub_1_acts.length
+                @sub_1_hit_map[i + 1] = s1_item
+                @sub_hit_map[i + 1] = s1_item
+              end
+              stitched_lines << "#{margin_left}#{l1}#{br2}#{l2}".rstrip
+            end
+            rendered_lines = stitched_lines
+          else
+            active_box = (@level == 2) ? sub_2_lines : sub_1_lines
+            rendered_lines = active_box.map { |l| "#{margin_left}#{l}" }
+          end
+        else
+          # Si solo hay 1 submenú abierto
+          total_2_w = margin_left.length + total_width + 2 + sub_1_w
+          if total_2_w <= term_cols
+            sub_start_line = main_box_start
+            max_total_lines = [rendered_lines.length, sub_start_line + sub_1_lines.length].max
+
+            x1_start = margin_left.length + total_width + 2
+            x1_end   = x1_start + sub_1_w
+            @sub_1_col_rng = (x1_start..x1_end)
+
+            sub_item_offset = sub_1_title.empty? ? 1 : 3
+
+            stitched_lines = []
+            max_total_lines.times do |i|
+              main_line = rendered_lines[i] || ("#{margin_left}#{' ' * total_width}")
+              if i >= sub_start_line && i < (sub_start_line + sub_1_lines.length)
+                sub_idx = i - sub_start_line
+                sub_l = sub_1_lines[sub_idx]
+                bridge = (i == parent_row_idx) ? "──" : "  "
+                stitched_lines << "#{main_line}#{bridge}#{sub_l}"
+
+                s_item_idx = sub_idx - sub_item_offset
+                if s_item_idx >= 0 && s_item_idx < sub_1_acts.length
+                  @sub_1_hit_map[i + 1] = s_item_idx
+                  @sub_hit_map[i + 1] = s_item_idx
+                end
+              else
+                stitched_lines << main_line
+              end
+            end
+            rendered_lines = stitched_lines
+          else
+            active_box = (@level == 1) ? sub_1_lines : rendered_lines
+            rendered_lines = active_box.map { |l| "#{margin_left}#{l}" }
+          end
+        end
+      end
+    end
+
+    rendered_lines
+  end
+
+  # Comprueba si alguna de las secciones del menú utiliza el modo dinámico RGB, Rainbow o Chroma.
+  #
+  # @return [Boolean]
+  def has_rgb_animation?
+    configs = [
+      @style_config.border,
+      @style_config.options,
+      @style_config.focus,
+      @style_config.title,
+      @style_config.banner,
+      @style_config.subtitle,
+      @style_config.divider
+    ]
+    configs.any? do |c|
+      if c.is_a?(Hash)
+        val = (c[:color] || c["color"]).to_s.downcase.strip
+        val == "rgb" || val == "rainbow" || val == "chroma"
+      else
+        false
+      end
+    end
+  end
+
+  # Comprueba si hay alguna animación activa que requiera redibujado continuo en el loop interactivo.
+  #
+  # @return [Boolean]
+  def has_active_animation?
+    anim = @animate.to_s.downcase
+    return true if ["rgb", "rainbow", "chroma", "chromatic", "cromatico", "fade"].include?(anim)
+    return true if has_rgb_animation?
+    if @active_tab_color
+      atc = @active_tab_color.to_s.downcase
+      return true if atc.start_with?("chromatic") || atc.start_with?("cromatico") || ["rgb", "rainbow", "chroma"].include?(atc)
+    end
+
+    configs = [
+      @style_config.border,
+      @style_config.options,
+      @style_config.focus,
+      @style_config.title,
+      @style_config.banner,
+      @style_config.subtitle,
+      @style_config.divider
+    ]
+    configs.any? do |c|
+      if c.is_a?(Hash)
+        val = (c[:color] || c["color"]).to_s.downcase.strip
+        val.start_with?("chromatic") || val.start_with?("cromatico") || val == "rgb" || val == "rainbow" || val == "chroma"
+      else
+        false
+      end
+    end
+  end
+end