grmenu 2.0.0 → 4.0.1

data/data/help.txt

@@ -0,0 +1,432 @@
+{bright_cyan}╔═══════════════════════════════════════════════════════════════════════════════════╗{reset}
+{bright_cyan}║{bright_magenta}    ██████╗     ██████╗      ███╗   ███╗    ███████╗     ███╗   ██╗    ██╗  ██╗    {bright_cyan}║{reset}
+{bright_cyan}║{bright_magenta}   ██╔════╝     ██╔══██╗     ████╗ ████║    ██╔════╝     ████╗  ██║    ██║  ██║    {bright_cyan}║{reset}
+{bright_cyan}║{bright_magenta}   ██║  ███╗    ██████╔╝     ██╔████╔██║    █████╗       ██╔██╗ ██║    ██║  ██║    {bright_cyan}║{reset}
+{bright_cyan}║{bright_magenta}   ██║   ██║    ██╔══██╗     ██║╚██╔╝██║    ██╔══╝       ██║╚██╗██║    ██║  ██║    {bright_cyan}║{reset}
+{bright_cyan}║{bright_magenta}   ╚██████╔╝    ██║  ██║     ██║ ╚═╝ ██║    ███████╗     ██║ ╚████║    ╚█████╔╝    {bright_cyan}║{reset}
+{bright_cyan}║{bright_magenta}    ╚═════╝     ╚═╝  ╚═╝     ╚═╝     ╚═╝    ╚══════╝     ╚═╝  ╚═══╝     ╚════╝     {bright_cyan}║{reset}
+{bright_cyan}╚═══════════════════════════════════════════════════════════════════════════════════╝{reset}
+
+{bright_cyan}╔═══════════════════════════════════════════════════════════════════════════════════╗{reset}
+{bright_cyan}║{bright_yellow}             DOCUMENTACION Y GUIA COMPLETA DE PARAMETROS (v4.0.1)                  {bright_cyan}║{reset}
+{bright_cyan}║{gray}  Soporte Raton SGR 1006, Submenus en Cascada 3 Niveles, Pestanas y CSS .gr        {bright_cyan}║{reset}
+{bright_cyan}╚═══════════════════════════════════════════════════════════════════════════════════╝{reset}
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[1] CLASE PRINCIPAL: GRmenu.new(functions, **opciones){reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  Crea una nueva instancia de menu interactivo para la terminal.
+
+  {cyan}PARAMETROS DEL CONSTRUCTOR:{reset}
+  {bright_green}* functions:{reset}    {white}[Array]{reset}        -> Lista de opciones a ejecutar (ver seccion [2]).
+  {bright_green}* title:{reset}        {white}[String]{reset}       -> Titulo centrado en el marco del menu.
+  {bright_green}* banner:{reset}       {white}[String]{reset}       -> Texto convertido a arte ASCII 3D superior.
+  {bright_green}* subtitle:{reset}     {white}[String]{reset}       -> Descripcion o subtitulo (admite saltos de linea \n).
+  {bright_green}* search:{reset}       {white}[Boolean]{reset}      -> Buscador en vivo con filtro reactivo (default: false).
+  {bright_green}* columns:{reset}      {white}[Integer]{reset}      -> Cantidad de columnas para grid 2D (default: 1).
+  {bright_green}* page_size:{reset}    {white}[Integer]{reset}      -> Cantidad de filas visibles antes de scroll (default: auto).
+  {bright_green}* style:{reset}        {white}[Integer 1..20]{reset} -> Estilo de marco de opciones (default: 19).
+  {bright_green}* banner_style:{reset} {white}[Integer 1..20]{reset} -> Estilo de marco para el banner (default: 3).
+  {bright_green}* font:{reset}         {white}[Integer 1..10]{reset} -> Fuente tipografica ASCII 3D del banner (default: 1).
+  {bright_green}* image:{reset}        {white}[String]{reset}       -> Ruta a imagen (PNG/JPG/WEBP/GIF/BMP) de cabecera.
+  {bright_green}* image_width:{reset}  {white}[Integer]{reset}      -> Ancho en columnas para renderizar la imagen (default: 40).
+  {bright_green}* divider:{reset}      {white}[Boolean/Int]{reset}  -> Lineas divisorias horizontales o ancho especifico.
+  {bright_green}* center:{reset}       {white}[Boolean]{reset}      -> Centrado horizontal automatico en consola (default: true).
+  {bright_green}* animate:{reset}      {white}[String/Bool]{reset}  -> Animacion de entrada ("diagonal", "linear", "fade", "rgb", false).
+  {bright_green}* desc_prefix:{reset}  {white}[String]{reset}       -> Prefijo del pie de tooltip/descripcion (default: "[i]").
+  {bright_green}* mouse:{reset}        {white}[Boolean]{reset}      -> Habilita raton ANSI SGR 1006 (clic, scroll, submenus) (default: false).
+  {bright_green}* tabs:{reset}         {white}[Hash]{reset}         -> Menu multitarea por pestanas { "Pestana 1" => [...], ... }.
+
+  {cyan}CONSTRUCTOR ALTERNATIVO PARA PESTANAS:{reset}
+  {bright_white}* GRmenu.tabs(tabs_hash, **opciones){reset}
+    Crea directamente un menu organizado por pestanas horizontales:
+    {bright_white}menu = GRmenu.tabs({ "Web" => [...], "Bases" => [...] }, mouse: true, style: 3){reset}
+
+  {cyan}METODOS DE INSTANCIA:{reset}
+  {bright_white}* menu.draw(size_max: 40, min_width: nil){reset}
+    Inicia el bucle interactivo de terminal. Bloquea hasta que el usuario elija.
+    - {cyan}size_max:{reset} Ancho minimo visual garantizado en columnas.
+    - {cyan}Deteccion CLI:{reset} Si se ejecuta el script con {yellow}-theme{reset} o {yellow}-ex{reset}, exporta
+      automaticamente el tema configurado a un archivo .gr y termina la ejecucion.
+    - Retorna el valor devuelto por la accion seleccionada.
+
+  {bright_white}* menu.style(bloque_gr){reset}
+    Aplica configuracion CSS al menu usando un bloque de texto (ej: <<-GR ... GR).
+    Permite definir bordes, animaciones, prefijos, mouse y colores inline sin archivos externos.
+
+  {bright_white}* menu.export_theme(ruta = nil){reset} (Alias: {bright_white}menu.export_config{reset})
+    Guarda la configuracion actual de este menu en un archivo de tema .gr.
+
+  {bright_white}* menu.set_style{reset}
+    Acceso al objeto de personalizacion fluido por metodos (ver seccion [3]).
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[2] FORMATOS DE OPCIONES EN EL ARRAY functions{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  Puedes mezclar cualquiera de estos formatos en la lista de opciones:
+
+  {cyan}1. Method de Ruby:{reset}
+     {bright_white}method(:iniciar_servidor){reset}
+     -> Extrae el nombre, limpia guiones y capitaliza automaticamente.
+
+  {cyan}2. Symbol (Metodo global / Kernel):{reset}
+     {bright_white}:crear_respaldo{reset}
+     -> Invoca el metodo con ese nombre en el contexto actual.
+
+  {cyan}3. Arreglo [Nombre, Accion]:{reset}
+     {bright_white}["Iniciar Servidor Web", method(:iniciar_servidor)]{reset}
+     -> Muestra la etiqueta personalizada y ejecuta la accion con Enter o doble clic.
+
+  {cyan}4. Arreglo con Tooltip Dinamico [Nombre, Accion, Descripcion]:{reset}
+     {bright_white}["Crear Respaldo", :respaldo, "Copia de seguridad en S3"]{reset}
+     -> Muestra la descripcion en el pie del menu cuando la opcion tiene foco.
+
+  {cyan}5. Lambda o Proc:{reset}
+     {bright_white}["Limpiar Cache", -> { puts "Cache limpia!"; GRmenu.continue }]{reset}
+     {bright_white}["Test", -> { puts "OK" }, "Descripcion tooltip opcional"]{reset}
+
+  {cyan}6. Hash explicito:{reset}
+     {bright_white}{ name: "Configurar", action: method(:config), desc: "Ajustes del sistema" }{reset}
+
+  {cyan}7. Submenus anidados en cascada (Hasta 3 niveles: Original -> Sub 1 -> Sub 2):{reset}
+     {bright_white}[{reset}
+     {bright_white}  ["Servidores", [{reset}
+     {bright_white}    ["Servidores Web", [{reset}
+     {bright_white}      ["Iniciar NGINX", -> { puts "NGINX OK" }],{reset}
+     {bright_white}      ["Reiniciar Apache", -> { puts "Apache OK" }]{reset}
+     {bright_white}    ]],{reset}
+     {bright_white}    ["Bases de Datos", [{reset}
+     {bright_white}      ["PostgreSQL", -> { puts "PG OK" }],{reset}
+     {bright_white}      ["Redis", -> { puts "Redis OK" }]{reset}
+     {bright_white}    ]]{reset}
+     {bright_white}  ], "Administra servidores (hasta 3 niveles)"]{reset}
+     {bright_white}]{reset}
+
+     -> {yellow}Visual:{reset} Muestra el indicador {cyan}▶{reset} en opciones con submenus. Al pulsar {yellow}[->]{reset} o {yellow}Clic{reset},
+        despliega cajas unidas por puentes dobles {cyan}──{reset} ({bright_white}Box 0 ── Box 1 ── Box 2{reset}).
+     -> {yellow}Responsivo:{reset} Si la terminal no tiene espacio para las 3 cajas, desliza una ventana
+        fluida ({bright_white}Box 1 ── Box 2{reset}) para no romper la pantalla.
+     -> {yellow}Teclado:{reset} {yellow}→{reset} abre nivel siguiente, {yellow}← / Esc{reset} regresa al nivel anterior, {yellow}Enter{reset} ejecuta accion final.
+     -> {yellow}Raton:{reset} Clic en cualquier caja enfoca ese nivel; clic en la accion final la ejecuta. Scroll en el nivel activo.
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[3] PERSONALIZACION DE COLORES Y MODO RGB: menu.set_style{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  Acepta: {cyan}(nombre_color, nivel_brillo){reset}, {cyan}Hash { color:, level: }{reset},
+  o el modo dinamico {bright_yellow}"rgb"{reset} / {bright_yellow}"rainbow"{reset} para animacion multicolor fluida a 30 FPS.
+
+  {bright_green}* menu.set_style.font(id){reset}           -> [Integer 1..10] Fuente 3D del banner.
+  {bright_green}* menu.set_style.banner(color, lvl = 2){reset} -> Letras 3D del banner (soporta "rgb").
+  {bright_green}* menu.set_style.title(color, lvl = 2){reset}  -> Titulo de cabecera del menu.
+  {bright_green}* menu.set_style.subtitle(color, lvl = 2){reset}-> Texto del subtitulo / descripcion.
+  {bright_green}* menu.set_style.divider(color, lvl = 1){reset} -> Lineas divisorias horizontales.
+  {bright_green}* menu.set_style.border(color, lvl = 1){reset}  -> Marco y esquinas de la caja de opciones.
+  {bright_green}* menu.set_style.options(color, lvl = 1){reset} -> Opciones inactivas / sin foco.
+  {bright_green}* menu.set_style.focus(color, lvl = 2){reset}   -> Opcion activa / seleccionada (> Opcion).
+  {bright_green}* menu.set_style.desc_prefix(texto){reset}      -> Prefijo de descripciones (ej: "[i]", "*", "->").
+
+  {cyan}Configuracion Global por defecto:{reset}
+  {bright_white}GRmenu::SetStyle.border("cyan", 1){reset}
+  {bright_white}GRmenu::SetStyle.focus("green", 2){reset}
+  {bright_white}GRmenu::SetStyle.title("yellow", 2){reset}
+  {bright_white}GRmenu::SetStyle.desc_prefix("[i]"){reset}
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[4] TABLAS, TARJETAS Y ALERTAS EJECUTIVAS{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+
+  {bright_green}* GRmenu.table(headers, rows, ...){reset}
+    Renderiza una tabla interactiva con bordes blindados y auto-ajuste de columnas.
+    Acepta tanto argumentos posicionales como por palabra clave:
+    - {bright_white}GRmenu.table(["ID", "Servicio", "RAM"], [["1", "nginx", "12MB"]], style: 3, header_color: "yellow"){reset}
+    - {bright_white}GRmenu.table(headers: [...], rows: [...], search: true, sort: true, page_size: 8){reset}
+    - {cyan}search:{reset}       [Boolean] Activa buscador en vivo reactivo escribiendo texto.
+    - {cyan}sort:{reset}         [Boolean] Permite ordenar columnas en orden asc/desc pulsando 's'.
+    - {cyan}page_size:{reset}    [Integer] Limite de filas visibles con auto-scroll.
+    - {cyan}header_color:{reset} [String] Color del encabezado de columnas (soporta neon).
+    - {cyan}selected_row:{reset} [String] Color de la fila seleccionada.
+    - {cyan}Teclas:{reset}       {yellow}↑ / ↓{reset} (navegar), {yellow}s{reset} (ordenar), {yellow}Enter{reset} (elegir fila), {yellow}Esc / q{reset} (salir).
+    - {cyan}Retorna:{reset}      La fila seleccionada por el usuario (o nil si cancela).
+
+  {bright_green}* GRmenu.card(title, content, ...){reset}
+    Recuadro estilizado para reportes y mensajes. Incluye word-wrapping automatico
+    para parrafos largos sin deformar bordes ni desbordar la consola.
+    Acepta argumentos posicionales y por palabra clave:
+    - {bright_white}GRmenu.card("Titulo Noticia", "Cuerpo del mensaje...", style: 3, border_color: "neon_cyan"){reset}
+    - {bright_white}GRmenu.card("Solo Mensaje sin Titulo", pause: false){reset}
+    - {bright_white}GRmenu.card(title: "Status", content: "OK", style: 7, border_color: "green", pause: false){reset}
+    - {cyan}pause:{reset}        [Boolean] Si es true (default en standalone), espera Enter; si es false (ideal para sleep), no bloquea.
+    - {cyan}border_color:{reset} [String] Color del marco (soporta hex, neon y "rgb").
+    - {cyan}title_color:{reset}  [String] Color del texto del titulo.
+    - {cyan}content_color:{reset}[String] Color del contenido.
+    - {cyan}style:{reset}        [Integer 1..20] Estilo de marco (default: 7).
+
+  {bright_green}* GRmenu.alert(tipo, mensaje, ...){reset}
+    Emite una notificacion modal con tag visual y paleta correspondiente:
+    - {cyan}:success{reset} -> Verde  [✔ EXITO]
+    - {cyan}:error{reset}   -> Rojo   [✖ ERROR]
+    - {cyan}:warning{reset} -> Ambar  [⚠ AVISO]
+    - {cyan}:info{reset}    -> Cian   [ℹ INFO]
+    - Acepta {cyan}pause: false{reset} para desvanecer sin bloquear.
+    - Soporta colores personalizados con {cyan}border_color:{reset} y {cyan}title_color:{reset}.
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[5] PESTANAS, ENTRADA DE DATOS (INPUT), MODALES Y CONTROLES{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+
+  {bright_green}* GRmenu.tabs(tabs_hash, title: nil, style: 3, mouse: false, ...){reset}
+    Crea un panel multitarea dividido en pestanas horizontales superiores:
+    {bright_white}GRmenu.tabs({{reset}
+    {bright_white}  "Servidores"     => [["NGINX", -> {}], ["Apache", -> {}]],{reset}
+    {bright_white}  "Bases de Datos" => [["Postgres", -> {}], ["Redis", -> {}]],{reset}
+    {bright_white}  "Ajustes"        => [["Tema Neon", -> {}]]{reset}
+    {bright_white}}, title: "Panel Multitarea", style: 3, mouse: true).draw{reset}
+    - {cyan}Navegacion:{reset} Pulsa {yellow}Tab{reset} para avanzar de pestana, {yellow}Shift+Tab{reset} para retroceder, o haz {yellow}clic{reset} en el titulo de la pestana.
+
+  {bright_green}* GRmenu.input(prompt_o_titulo, ...){reset}
+    Rediseno de caja de texto con marco integrado, titulo superior centrado en el borde,
+    etiqueta interna ({cyan}label:{reset}), cursor de bloque en vivo {bright_white}█{reset} y soporte de contrasenas.
+    Acepta argumentos posicionales o por palabra clave:
+    - {bright_white}servidor = GRmenu.input(title: "Configuracion", label: "URL del Host:", default: "http://localhost:8080", style: 3){reset}
+    - {bright_white}token    = GRmenu.input(title: "Seguridad", label: "Token Secreto:", password: true, style: 3, border_color: "neon_red"){reset}
+    - {bright_white}nombre   = GRmenu.input("Ingresa tu Nombre:", default: "admin"){reset}
+    - {cyan}password:{reset}     [Boolean] Enmascara el texto con asteriscos (****).
+    - {cyan}default:{reset}      [String] Valor inicial pre-rellenado editable.
+    - {cyan}title_color:{reset}  [String] Color del titulo del marco superior.
+    - {cyan}label_color:{reset}  [String] Color de la etiqueta interna.
+    - {cyan}border_color:{reset} [String] Color del borde.
+    - {cyan}Teclas:{reset}       Escribir texto, {yellow}Backspace{reset} (borrar), {yellow}Ctrl+U{reset} (limpiar), {yellow}Enter{reset} (confirmar).
+
+  {bright_green}* GRmenu.checkbox(items, ...){reset} (Alias: {bright_white}GRmenu.select_multi{reset}, {bright_white}GRmenu.multiselect{reset})
+    Lista interactiva con casillas de verificacion [X] / [ ].
+    - Acepta {bright_white}GRmenu.checkbox(["Opcion A", "Opcion B"], title: "Permisos"){reset} o {bright_white}checkbox(items: [...], preselected: [0]){reset}.
+    - {cyan}Teclas:{reset}  {yellow}Espacio{reset} (marcar/desmarcar), {yellow}a{reset} (todos), {yellow}n{reset} (ninguno), {yellow}i{reset} (invertir), {yellow}Enter{reset} (confirmar).
+    - {cyan}Retorna:{reset} {bright_yellow}Array{reset} con los elementos seleccionados.
+
+  {bright_green}* GRmenu.slider(prompt, ...){reset} (Alias: {bright_white}GRmenu.range{reset})
+    Control deslizante horizontal en tiempo real con barra de nivel.
+    - Acepta {bright_white}GRmenu.slider("Volumen:", min: 0, max: 100, default: 75){reset} o {bright_white}slider(prompt: "Brillo:", min: 0, max: 50){reset}.
+    - {cyan}Teclas:{reset}  {yellow}← / →{reset} (paso normal), {yellow}↑ / ↓{reset} (paso x5), {yellow}Enter{reset} (guardar).
+    - {cyan}Retorna:{reset} {bright_yellow}Numeric{reset} con el valor seleccionado.
+
+  {bright_green}* GRmenu.confirm(pregunta, ...){reset}
+    Modal interactivo con botones [ Sí ] y [ No ].
+    - Acepta {bright_white}GRmenu.confirm("¿Deseas reiniciar?", default: true, style: 3){reset} o {bright_white}confirm(question: "...", default: false){reset}.
+    - {cyan}Teclas:{reset}  {yellow}← / → / Tab{reset}, {yellow}s / y{reset} (Si), {yellow}n{reset} (No), {yellow}Enter{reset}.
+    - {cyan}Retorna:{reset} {bright_yellow}true{reset} o {bright_yellow}false{reset}.
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[6] BARRA DE PROGRESO, SPINNER E IMAGENES ANSI TRUECOLOR{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+
+  {bright_green}* GRmenu.progress(total = 100, ... &bloque){reset}
+    Barra de progreso fluida con soporte de status dinamico protegido contra desbordes.
+    - Acepta {bright_white}GRmenu.progress(100, title: "Descargando") do |bar| ... end{reset} o con keyword {bright_white}progress(total: 50){reset}.
+
+  {bright_green}* GRmenu.spinner(mensaje = "Cargando...", ... &bloque){reset}
+    Indicador giratorio animado en hilo de ejecucion secundario mientras el bloque corre.
+    - Acepta {bright_white}GRmenu.spinner("Compilando assets...") { sleep 1.5 }{reset} o {bright_white}spinner(message: "..."){reset}.
+
+  {bright_green}* GRmenu.image(filepath, width: 40, height: nil, style: 3, color: "cyan", center: true){reset}
+    Decodifica y renderiza imagenes (PNG, JPG, WEBP, GIF, BMP) con micro-subpixeles
+    ANSI TrueColor de 24 bits usando medios bloques {bright_white}▀{reset} (2 pixeles reales verticales por caracter, proporcion 1:1).
+    - Remuestreo de alta fidelidad Lanczos con ImageMagick (Open3) o decodificador nativo de PNG puro (Zlib).
+    - Soporte completo para fondos transparentes (canal alfa PNG).
+
+  {bright_green}* GRmenu.banner(texto, delay = 0, color: "magenta", level: 2, style: 3, font: 1){reset}
+    Convierte cadenas en arte ASCII 3D con bordes y fuentes personalizables.
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[7] SISTEMA DE TEMAS .gr (CSS PARA TUI) Y EXPORTACION{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+
+  {cyan}1. Temas Predefinidos Disponibles:{reset}
+     {bright_white}GRmenu.theme(:neon_red){reset}   # Rojo neon vibrante con bordes dobles
+     {bright_white}GRmenu.theme(:cyberpunk){reset}  # Neones cian, amarillo y Chroma RGB animado
+     {bright_white}GRmenu.theme(:matrix){reset}     # Verdes fosforescentes estilo Hacker
+     {bright_white}GRmenu.theme(:dracula){reset}    # Morados oscuros, rosas y cian
+     {bright_white}GRmenu.theme(:nord){reset}       # Azules articos y tonos frios escandinavos
+     {bright_white}GRmenu.theme(:monokai){reset}    # Paleta calida amarilla, magenta y naranja
+     {bright_white}GRmenu.theme(:sunset){reset}     # Degradados rojo fuego, naranja y dorado
+
+  {cyan}2. Especificacion Completa de Bloques en un Archivo o Bloque CSS .gr:{reset}
+     {gray}GRmenu::config<-1->{reset}
+     {white}@theme:: "CyberNeon"{reset}
+     {white}@author:: "GRcode"{reset}
+     {white}@version:: "4.1"{reset}
+
+     {cyan}<<menu{reset}
+       {white}style:: 3{reset}                # Estilo de marco 1..20
+       {white}banner_style:: 3{reset}         # Estilo de marco del banner 1..20
+       {white}font:: 1{reset}                 # Fuente tipografica 3D 1..10
+       {white}animate:: diagonal{reset}       # diagonal, linear, fade, rgb o false
+       {white}center:: true{reset}            # Centrado en consola (true / false)
+       {white}mouse:: true{reset}             # Activa soporte de raton (true / false)
+       {white}desc_prefix:: [i]{reset}        # Prefijo de tooltip ("[i]", "*", "->")
+       {white}border:: neon_cyan:1{reset}     # color:brillo (soporta "rgb:2")
+       {white}title:: neon_yellow:2{reset}
+       {white}focus:: neon_red:2{reset}
+       {white}options:: white:1{reset}
+       {white}banner:: neon_magenta:2{reset}
+       {white}subtitle:: cyan:1{reset}
+       {white}divider:: blue:1{reset}
+     {cyan}>>{reset}
+
+     {cyan}<<submenu{reset}
+       {white}style:: 3{reset}                # Estilo de marco del submenu
+       {white}border:: neon_yellow:1{reset}   # Borde de las cajas laterales
+       {white}focus:: neon_cyan:2{reset}      # Opcion seleccionada en el submenu
+       {white}options:: white:1{reset}        # Opciones inactivas
+       {white}title:: neon_yellow:2{reset}    # Titulo de la caja del submenu
+       {white}arrow:: neon_cyan:2{reset}      # Color de la flecha indicadora ▶
+     {cyan}>>{reset}
+
+     {cyan}<<tabs{reset}
+       {white}active_tab:: neon_yellow:2{reset}# Color de la pestana seleccionada [ Tab ]
+       {white}tab_color:: gray:1{reset}        # Color de las pestanas inactivas
+       {white}indicator:: neon_cyan:2{reset}   # Color de los corchetes o separadores
+     {cyan}>>{reset}
+
+     {cyan}<<input{reset}
+       {white}style:: 3{reset}                # Estilo de marco del input
+       {white}border_color:: neon_cyan:1{reset}# Marco de la caja
+       {white}title_color:: neon_yellow:2{reset}# Titulo centrado en marco superior
+       {white}label_color:: white:2{reset}    # Etiqueta interior del campo
+     {cyan}>>{reset}
+
+     {cyan}<<table{reset}
+       {white}style:: 3{reset}
+       {white}border_color:: red:2{reset}
+       {white}header_color:: yellow:2{reset}
+       {white}selected_row:: green:2{reset}
+       {white}row_color:: white:1{reset}
+       {white}zebra_striping:: true{reset}
+       {white}page_size:: 8{reset}
+     {cyan}>>{reset}
+
+     {cyan}<<card{reset}
+       {white}style:: 7{reset}
+       {white}border_color:: cyan:2{reset}
+       {white}title_color:: yellow:2{reset}
+       {white}content_color:: white:1{reset}
+     {cyan}>>{reset}
+
+     {cyan}<<slider{reset}
+       {white}style:: 3{reset}
+       {white}color:: rgb:2{reset}
+       {white}fill_char:: █{reset}
+       {white}empty_char:: ░{reset}
+     {cyan}>>{reset}
+
+     {cyan}<<checkbox{reset}
+       {white}style:: 3{reset}
+       {white}color:: rgb:2{reset}
+       {white}checked_mark:: [X]{reset}
+       {white}unchecked_mark:: [ ]{reset}
+     {cyan}>>{reset}
+
+  {cyan}3. Exportacion e Importacion:{reset}
+     - {bright_white}menu.style(<<-GR ... GR){reset} Inyeccion directa de CSS.
+     - {bright_white}menu.export_theme("tema.gr"){reset} Exporta el tema activo.
+     - {bright_white}$ ruby app.rb -theme -o mi_tema.gr{reset} Exportacion automatica por CLI.
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[8] MODULO DE COLORES: Color / C Y PERSONALIZACION HEXADECIMAL{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  {cyan}1. Como Usar Colores Personalizados (Hexadecimal y Neon):{reset}
+     El motor soporta de forma 100% nativa TrueColor (24 bits) en tres vias:
+
+     {white}A) En Codigo Normal con menu.set_style:{reset}
+        {bright_white}menu.set_style.border("#FF0055").title("#00F5FF").focus("gold"){reset}
+        {bright_white}menu.set_style.banner("neon_emerald").subtitle("#A6E3A1"){reset}
+
+     {white}B) En CSS Inline tipo <style> (menu.style <<-GR ... GR):{reset}
+        {bright_white}menu.style(<<-GR){reset}
+          {white}border:: #FF0055:1{reset}
+          {white}title:: #00F5FF:2{reset}
+          {white}focus:: gold:2{reset}
+        {bright_white}GR{reset}
+
+     {white}C) Directamente con el modulo Color / C:{reset}
+        {bright_white}puts Color.hex("#FF0055", "Texto Carmesi Hex"){reset}
+        {bright_white}puts Color.neon_emerald("Texto Esmeralda Neon"){reset}
+
+  {cyan}2. Catalogo de 90+ Colores (Cada uno con version Normal y version Neon):{reset}
+     {bright_yellow}Metales y Joyas:{reset}
+     - gold / neon_gold         | silver / neon_silver     | platinum / neon_platinum
+     - bronze / neon_bronze     | copper / neon_copper     | ruby / neon_ruby
+     - emerald / neon_emerald   | sapphire / neon_sapphire
+
+     {bright_yellow}Fuego, Atardecer y Calidos:{reset}
+     - crimson / neon_crimson   | scarlet / neon_scarlet   | coral / neon_coral
+     - amber / neon_amber       | peach / neon_peach       | orange / neon_orange
+     - red / neon_red           | yellow / neon_yellow
+
+     {bright_yellow}Naturaleza, Menta y Verdes:{reset}
+     - lime / neon_lime         | mint / neon_mint         | jade / neon_jade
+     - forest / neon_forest     | teal / neon_teal         | green / neon_green
+
+     {bright_yellow}Agua, Cielo y Tonos Frios:{reset}
+     - turquoise / neon_turquoise | sky / neon_sky         | azure / neon_azure
+     - cobalt / neon_cobalt     | ice / neon_ice           | cyan / neon_cyan
+     - aqua / neon_aqua         | blue / neon_blue
+
+     {bright_yellow}Pasteles, Morados y Rosas:{reset}
+     - lavender / neon_lavender | mauve / neon_mauve       | violet / neon_violet
+     - indigo / neon_indigo     | fuchsia / neon_fuchsia   | rose / neon_rose
+     - hot_pink / neon_hot_pink | pink / neon_pink         | purple / neon_purple
+     - magenta / neon_magenta
+
+     {bright_yellow}Terminal, Hacker y Monitores:{reset}
+     - matrix / neon_matrix     | charcoal / neon_charcoal | white / neon_white
+     - gray                     | black
+
+  {cyan}3. Modo Dinamico Arcoiris (Chroma Loop):{reset}
+     - {bright_yellow}rgb{reset} / {bright_yellow}rainbow{reset} / {bright_yellow}chroma{reset} -> Espectro animado continuo a 30 FPS en vivo.
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[9] FUENTES ASCII 3D PARA BANNERS (font: 1 al 10){reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  {yellow} 1{reset} -> ANSI Shadow 3D (Default)   {yellow} 6{reset} -> Modular Pipe 3D
+  {yellow} 2{reset} -> Slant 3D (FIGlet)           {yellow} 7{reset} -> Bubble / Round Gothic
+  {yellow} 3{reset} -> Doom / Standard 3D         {yellow} 8{reset} -> Double-Line Wire 3D
+  {yellow} 4{reset} -> Graffiti Shadow 3D         {yellow} 9{reset} -> Solid Fat 3D Block
+  {yellow} 5{reset} -> Small Slant / Mini 3D      {yellow}10{reset} -> Arcade Stars Matrix
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[10] ESTILOS DE MARCO Y BORDES (style: 1 al 20){reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  {yellow} 1{reset} -> ##### (Hash)              {yellow}11{reset} -> ░░░░░ (Sombreado suave)
+  {yellow} 2{reset} -> ┌───┐ (Linea simple)       {yellow}12{reset} -> █████ (Bloque solido)
+  {yellow} 3{reset} -> ╔═══╗ (Doble linea)        {yellow}13{reset} -> ***** (Asteriscos)
+  {yellow} 4{reset} -> ┏━━━┓ (Linea gruesa)       {yellow}14{reset} -> +++++ (Cruces)
+  {yellow} 5{reset} -> ╒═══╕ (Doble horiz.)       {yellow}15{reset} -> ===== (Iguales)
+  {yellow} 6{reset} -> ╓───╖ (Simple horiz.)      {yellow}16{reset} -> ~~~~~ (Ondulado)
+  {yellow} 7{reset} -> ╭───╮ (Curvas)             {yellow}17{reset} -> ----- (Guiones)
+  {yellow} 8{reset} -> ▛▀▀▀▜ (Bloques)            {yellow}18{reset} -> ◆◆◆◆◆ (Diamantes)
+  {yellow} 9{reset} -> ▓▓▓▓▓ (Sombreado oscuro)   {yellow}19{reset} -> ●○○○● (Circulos)
+  {yellow}10{reset} -> ▒▒▒▒▒ (Sombreado medio)    {yellow}20{reset} -> ★☆☆☆★ (Estrellas)
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[11] NAVEGACION POR TECLADO Y CONTROLES CON RATON{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  * {bright_yellow}↑ (Arriba):{reset}      Mover foco arriba. En el tope salta al fondo (Snake loop).
+  * {bright_yellow}↓ (Abajo):{reset}       Mover foco abajo. En el fondo salta al tope (Snake loop).
+  * {bright_yellow}Tab / Shift+Tab:{reset} En menus con pestanas (tabs), cambia a la siguiente o anterior pestana.
+  * {bright_yellow}→ (Derecha):{reset}     En opciones con submenus (▶), despliega el submenu lateral (hasta 3 niveles).
+  * {bright_yellow}← / Esc:{reset}        En submenus laterales, cierra el nivel actual y regresa al nivel anterior.
+  * {bright_yellow}Enter:{reset}          Ejecuta la opcion seleccionada o confirma modal/tabla.
+  * {bright_yellow}Raton (mouse: true):{reset}
+    - {cyan}Clic izquierdo:{reset}  Enfoca la opcion pulsada; si ya esta enfocada, ejecuta inmediatamente.
+    - {cyan}Clic en submenus:{reset}Abre o enfoca la caja del submenu correspondiente.
+    - {cyan}Clic en pestanas:{reset}Cambia inmediatamente a la pestana sobre la que se hizo clic.
+    - {cyan}Rueda de scroll:{reset} Desplaza el foco arriba o abajo (↑ / ↓) fluidamente en el panel activo.
+    - {cyan}Clic en ▲ / ▼:{reset}    Avanza o retrocede de pagina cuando hay paginacion.
+  * {bright_yellow}s:{reset}              En tablas interactivas, ordena por la columna activa.
+  * {bright_yellow}Espacio:{reset}        En casillas de verificacion (checkbox), marca/desmarca.
+  * {bright_yellow}a / n / i:{reset}      En checkbox: (a) marcar todos, (n) ninguno, (i) invertir.
+  * {bright_yellow}q / Esc:{reset}        Sale del menu, cancela modal o limpia buscador.
+  * {bright_yellow}Backspace:{reset}      En buscadores e inputs, borra la ultima letra.
+  * {bright_yellow}Ctrl+U:{reset}         En buscadores e inputs, limpia toda la linea escrita.
+
+{bright_blue}─────────────────────────────────────────────────────────────────────────────────────{reset}

data/data/themes/cyberpunk.gr

@@ -0,0 +1,60 @@
+GRmenu::config<-1->
+
+@theme:: "Cyberpunk 2077"
+@author:: "grcode"
+@version:: "1.0"
+
+<<menu
+  style:: 3
+  banner_style:: 3
+  font:: 1
+  animate:: rgb
+  center:: true
+  border:: rgb:2
+  title:: yellow:2
+  subtitle:: cyan:1
+  banner:: rgb:2
+  divider:: cyan:1
+  options:: white:1
+  focus:: rgb:2
+  description:: pink:1
+>>
+
+<<table
+  style:: 3
+  header_color:: yellow:2
+  border_color:: rgb:2
+  row_color:: white:1
+  selected_row:: rgb:2
+  zebra_striping:: true
+  animate:: diagonal
+>>
+
+<<card
+  style:: 7
+  border_color:: rgb:2
+  title_color:: yellow:2
+  content_color:: white:1
+  icon_style:: brackets
+>>
+
+<<slider
+  style:: 3
+  color:: rgb:2
+  fill_char:: █
+  empty_char:: ░
+>>
+
+<<checkbox
+  style:: 3
+  color:: rgb:2
+  checked_mark:: [X]
+  unchecked_mark:: [ ]
+>>
+
+<<modal
+  style:: 3
+  border_color:: rgb:2
+  prompt_color:: yellow:2
+  mask_char:: *
+>>

data/data/themes/dracula.gr

@@ -0,0 +1,60 @@
+GRmenu::config<-1->
+
+@theme:: "Dracula Dark"
+@author:: "grcode"
+@version:: "1.0"
+
+<<menu
+  style:: 7
+  banner_style:: 7
+  font:: 1
+  animate:: fade
+  center:: true
+  border:: purple:2
+  title:: pink:2
+  subtitle:: cyan:1
+  banner:: purple:2
+  divider:: magenta:1
+  options:: white:1
+  focus:: green:2
+  description:: gray:1
+>>
+
+<<table
+  style:: 7
+  header_color:: pink:2
+  border_color:: purple:2
+  row_color:: white:1
+  selected_row:: green:2
+  zebra_striping:: true
+  animate:: fade
+>>
+
+<<card
+  style:: 7
+  border_color:: purple:2
+  title_color:: pink:2
+  content_color:: white:1
+  icon_style:: brackets
+>>
+
+<<slider
+  style:: 7
+  color:: pink:2
+  fill_char:: █
+  empty_char:: ░
+>>
+
+<<checkbox
+  style:: 7
+  color:: purple:2
+  checked_mark:: [X]
+  unchecked_mark:: [ ]
+>>
+
+<<modal
+  style:: 7
+  border_color:: purple:2
+  prompt_color:: cyan:2
+  mask_char:: *
+>>

data/data/themes/matrix.gr

@@ -0,0 +1,60 @@
+GRmenu::config<-1->
+
+@theme:: "Matrix Terminal"
+@author:: "grcode"
+@version:: "1.0"
+
+<<menu
+  style:: 2
+  banner_style:: 2
+  font:: 1
+  animate:: linear
+  center:: true
+  border:: green:2
+  title:: green:2
+  subtitle:: green:1
+  banner:: green:2
+  divider:: green:1
+  options:: green:1
+  focus:: green:2
+  description:: green:1
+>>
+
+<<table
+  style:: 2
+  header_color:: green:2
+  border_color:: green:1
+  row_color:: green:1
+  selected_row:: green:2
+  zebra_striping:: false
+  animate:: linear
+>>
+
+<<card
+  style:: 2
+  border_color:: green:2
+  title_color:: green:2
+  content_color:: green:1
+  icon_style:: brackets
+>>
+
+<<slider
+  style:: 2
+  color:: green:2
+  fill_char:: █
+  empty_char:: ░
+>>
+
+<<checkbox
+  style:: 2
+  color:: green:2
+  checked_mark:: [X]
+  unchecked_mark:: [ ]
+>>
+
+<<modal
+  style:: 2
+  border_color:: green:2
+  prompt_color:: green:2
+  mask_char:: *
+>>