grmenu 4.1.0 → 5.0.0

data/data/help.txt

@@ -8,8 +8,8 @@
 {bright_cyan}╚═══════════════════════════════════════════════════════════════════════════════════╝{reset}
 
 {bright_cyan}╔═══════════════════════════════════════════════════════════════════════════════════╗{reset}
-{bright_cyan}║{bright_yellow}             DOCUMENTACION Y GUIA COMPLETA DE PARAMETROS (v4.1.0)                  {bright_cyan}║{reset}
-{bright_cyan}║{gray}  Soporte Raton SGR 1006, Submenus en Cascada 3 Niveles, Pestanas y CSS .gr        {bright_cyan}║{reset}
+{bright_cyan}║{bright_yellow}             DOCUMENTACION Y GUIA COMPLETA DE PARAMETROS (v5.0.0)                  {bright_cyan}║{reset}
+{bright_cyan}║{gray}  Formularios, Modales 3D, Window BG, Raton SGR 1006, Submenus y Temas CSS .gr      {bright_cyan}║{reset}
 {bright_cyan}╚═══════════════════════════════════════════════════════════════════════════════════╝{reset}
 
 {bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
@@ -143,7 +143,7 @@
     - {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}header_color:{reset} [String] Color del encabezado de columnas (soporta cromatico).
     - {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).
@@ -152,11 +152,11 @@
     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("Titulo Noticia", "Cuerpo del mensaje...", style: 3, border_color: "chromatic_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}border_color:{reset} [String] Color del marco (soporta hex, cromatico 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).
@@ -170,8 +170,121 @@
     - Acepta {cyan}pause: false{reset} para desvanecer sin bloquear.
     - Soporta colores personalizados con {cyan}border_color:{reset} y {cyan}title_color:{reset}.
 
+  {bright_green}* GRmenu.div(long = nil, color = "blue", level = 1, char = "─"){reset}
+    Dibuja una linea divisoria con soporte de colores ANSI o efecto arcoiris "rgb".
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[5] FORMULARIOS Y MODALES FLOTANTES 3D (WIDGETS NATIVOS){reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+
+  {bright_green}* GRmenu.form(titulo = "Formulario", **opciones, &bloque){reset}
+    Constructor interactivo de formularios multi-campo en una sola pantalla.
+    Soporta campos de texto, contrasenas, numeros con limites/pasos, selectores y booleanos.
+    Incluye barrita de cursor {bright_white}│{reset} en tiempo real, sombra proyectada 3D ({gray}▒▒{reset}),
+    navegacion por Tab/flechas y retorno estructurado como un {bright_yellow}Hash{reset} de Ruby ({white}{ key: valor, ... }{reset}).
+
+    {cyan}Sintaxis DSL por Bloque:{reset}
+    {bright_white}datos = GRmenu.form("Nuevo Usuario", color: "cyan", style: 3, shadow: true) do |f|{reset}
+    {bright_white}  f.text     :nombre,     "Nombre Completo:", placeholder: "Ej. Gabo Dev"{reset}
+    {bright_white}  f.password :password,   "Contrasena:",      mask: "*"{reset}
+    {bright_white}  f.number   :puerto,     "Puerto TCP:",      default: 8080, min: 1024, max: 65535, step: 1{reset}
+    {bright_white}  f.select   :entorno,    "Ambiente:",        ["Desarrollo", "Staging", "Produccion"]{reset}
+    {bright_white}  f.boolean  :activo,     "¿Habilitar SSL?",  default: true{reset}
+    {bright_white}end{reset}
+    {bright_white}# Retorna: { nombre: "Gabo Dev", password: "...", puerto: 8080, entorno: "...", activo: true }{reset}
+    {bright_white}# Si el usuario presiona Esc o [ Cancelar ], retorna nil.{reset}
+
+    {cyan}Tipos de Campos Disponibles en el Builder (f):{reset}
+    - {bright_white}f.text(key, label, default: "", placeholder: ""){reset}
+      Campo de entrada de texto editable con barrita indicadora de cursor {bright_white}│{reset}.
+    - {bright_white}f.password(key, label, default: "", mask: "*"){reset}
+      Campo protegido de contrasena. Oculta los caracteres reales tras la mascara especificada.
+    - {bright_white}f.number(key, label, default: 0, min: nil, max: nil, step: 1){reset}
+      Campo numerico con limites opcionales min/max. Permite escribir digitos directamente o usar
+      las teclas {yellow}+{reset} / {yellow}-{reset} y {yellow}←{reset} / {yellow}→{reset} para incrementar/decrementar por paso.
+    - {bright_white}f.select(key, label, opciones = [], default: nil){reset}
+      Selector interactivo inline {cyan}< Opcion >{reset}. Cicla opciones con {yellow}← / →{reset} o {yellow}Espacio{reset}.
+    - {bright_white}f.boolean(key, label, default: false){reset} (Alias: {bright_white}f.checkbox{reset})
+      Casilla interactiva {green}[X] Si{reset} / {red}[ ] No{reset}. Alterna con {yellow}Espacio{reset} o {yellow}s / n / y{reset}.
+
+    {cyan}Parametros de Configuracion de GRmenu.form:{reset}
+    - {cyan}title:{reset}        [String] Titulo centrado en el marco superior.
+    - {cyan}color / border_color:{reset} Color del marco exterior (soporta hex, cromatico o "rgb").
+    - {cyan}title_color:{reset}  Color del texto del titulo superior.
+    - {cyan}focus_color:{reset}  Color del campo y botones activos cuando tienen foco (default: "green").
+    - {cyan}cursor_char:{reset}  Caracter para la barrita de cursor activa (default: "│").
+    - {cyan}style:{reset}        Estilo de borde (1 al 20, default: 3).
+    - {cyan}shadow:{reset}       [Boolean] Proyeccion de sombra 3D lateral e inferior (default: true).
+    - {cyan}submit_label:{reset} Etiqueta del boton de confirmacion (default: "Guardar").
+    - {cyan}cancel_label:{reset} Etiqueta del boton de cancelacion (default: "Cancelar").
+
+    {cyan}Atajos y Navegacion en Formulario:{reset}
+    - {yellow}Tab / ↓{reset}: Avanzar al siguiente campo o boton.
+    - {yellow}Shift+Tab / ↑{reset}: Retroceder al campo o boton anterior.
+    - {yellow}Enter{reset}: En campos de texto/numero pasa al siguiente campo; en botones ejecuta Guardar o Cancelar.
+    - {yellow}← / →{reset}: Mover la barrita de cursor {bright_white}│{reset} dentro del texto, o cambiar opcion en selectores.
+    - {yellow}Home / Ctrl+A{reset}: Mover el cursor al inicio del texto.
+    - {yellow}End / Ctrl+E{reset}: Mover el cursor al final del texto.
+    - {yellow}Ctrl+U{reset}: Limpiar por completo el campo actual.
+    - {yellow}Backspace / Delete{reset}: Borrar el caracter anterior o posterior a la barrita de cursor.
+    - {yellow}Esc{reset}: Cancelar el formulario inmediatamente (retorna nil).
+
+  {bright_green}* GRmenu.modal(title_o_content, ...){reset} (Alias: {bright_white}GRmenu.popup{reset})
+    Ventana emergente flotante con sombra proyectada 3D ({gray}▒▒{reset}), auto-centrado en pantalla,
+    ajuste de texto automatico (word-wrapping) y botones de accion interactivos con foco navegable.
+
+    {cyan}Ejemplos de Uso:{reset}
+    {bright_white}boton = GRmenu.modal({reset}
+    {bright_white}  title: "Actualizacion de Servidor",{reset}
+    {bright_white}  content: "Se han descargado 42 paquetes nuevos.\n¿Deseas instalarlos ahora?",{reset}
+    {bright_white}  buttons: ["Instalar Ahora", "Posponer", "Cancelar"],{reset}
+    {bright_white}  color: "cyan",{reset}
+    {bright_white}  style: 3,{reset}
+    {bright_white}  shadow: true{reset}
+    {bright_white}){reset}
+    {bright_white}# Retorna el String del boton elegido: "Instalar Ahora", "Posponer", o nil si pulsa Esc.{reset}
+
+    {cyan}Parametros de Configuracion de GRmenu.modal:{reset}
+    - {cyan}title:{reset}         [String] Titulo del recuadro superior.
+    - {cyan}content:{reset}       [String] Mensaje interior (soporta saltos de linea y parrafos largos).
+    - {cyan}buttons:{reset}       [Array] Lista de etiquetas de botones (default: ["Aceptar"]).
+    - {cyan}color / border_color:{reset} Color del marco (soporta hex, cromatico o "rgb").
+    - {cyan}title_color:{reset}   Color del titulo.
+    - {cyan}content_color:{reset} Color del texto del cuerpo.
+    - {cyan}shadow:{reset}        [Boolean] Muestra sombra proyectada 3D {gray}▒▒{reset} (default: true).
+    - {cyan}style:{reset}         Estilo de borde (1 al 20, default: 3).
+    - {cyan}Teclas:{reset}        {yellow}← / → / Tab / Shift+Tab{reset} para alternar botones, {yellow}Enter / Espacio{reset} para pulsar boton, {yellow}Esc{reset} para cancelar.
+
 {bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
-{bright_yellow}[5] PESTANAS, ENTRADA DE DATOS (INPUT), MODALES Y CONTROLES{reset}
+{bright_yellow}[6] CONTROL DE COLOR Y FONDO DE VENTANA: GRmenu.window{reset}
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+  Permite pintar el fondo global de toda la terminal mediante secuencias de escape nativas
+  OSC 11 (`\e]11;#hex\a`) y borrado con extension de color de fondo (ANSI BCE `\e[2J\e[H`).
+
+  {cyan}Seguridad y Auto-Restauracion Limpia:{reset}
+  {bright_green}¡Totalmente seguro!{reset} GRmenu registra limpiadores automaticos con {bright_white}at_exit{reset} y trampa
+  de senales ({bright_white}SIGINT{reset}, {bright_white}SIGTERM{reset}, {bright_white}SIGHUP{reset}). Si el programa finaliza, falla con una excepcion,
+  o el usuario pulsa Ctrl+C, el fondo de la terminal {bright_yellow}siempre vuelve a su color natural original{reset}
+  mediante OSC 111 (`\e]111\a`) sin necesidad de llamar metodos de reseteo manualmente.
+
+  {cyan}Metodos del Modulo GRmenu.window:{reset}
+  {bright_green}* GRmenu.window.color(valor){reset} (Alias: {bright_white}GRmenu.window.bg(valor){reset})
+    Cambia el color de fondo de la ventana completa de la consola. Acepta:
+    - {bright_white}Hexadecimal directo:{reset} {cyan}GRmenu.window.color("#1a1b26"){reset}, {cyan}GRmenu.window.bg("#0f172a"){reset}
+    - {bright_white}Nombres integrados:{reset}   {cyan}GRmenu.window.color("red"){reset}, {cyan}GRmenu.window.bg("blue"){reset}
+    - {bright_white}Nuevo alias espanol:{reset}  {cyan}GRmenu.window.color("negro"){reset} (o "black")
+    - {bright_white}Arreglos RGB [R, G, B]:{reset}{cyan}GRmenu.window.bg([15, 32, 39]){reset}
+
+  {bright_green}* GRmenu.window.reset{reset}
+    Restaura de forma inmediata el color de fondo predeterminado de la terminal (OSC 111).
+    (Util si deseas volver al fondo normal en medio de la ejecucion de tu script).
+
+  {bright_green}* GRmenu.window.title(texto){reset}
+    Cambia el titulo superior de la ventana o pestana de la terminal (OSC 0).
+    Ejemplo: {bright_white}GRmenu.window.title("Panel de Control - v4.2"){reset}
+
+{bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
+{bright_yellow}[7] PESTANAS, ENTRADA DE DATOS (INPUT) Y CONTROLES INTERACTIVOS{reset}
 {bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
 
   {bright_green}* GRmenu.tabs(tabs_hash, title: nil, style: 3, mouse: false, ...){reset}
@@ -179,16 +292,16 @@
     {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}  "Ajustes"        => [["Tema Cromatico", -> {}]]{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.
+    Caja de captura de texto interactiva con titulo superior centrado en el marco,
+    etiqueta interna ({cyan}label:{reset}), cursor 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}token    = GRmenu.input(title: "Seguridad", label: "Token Secreto:", password: true, style: 3, border_color: "chromatic_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.
@@ -210,21 +323,21 @@
     - {cyan}Retorna:{reset} {bright_yellow}Numeric{reset} con el valor seleccionado.
 
   {bright_green}* GRmenu.confirm(pregunta, ...){reset}
-    Modal interactivo con botones [ Sí ] y [ No ].
+    Modal interactivo rapido 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_yellow}[8] 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}.
+    - Acepta {bright_white}GRmenu.progress(100, title: "Descargando") do |bar| ... bar.advance; bar.status = "Ok" end{reset}.
 
   {bright_green}* GRmenu.spinner(mensaje = "Cargando...", ... &bloque){reset}
-    Indicador giratorio animado en hilo de ejecucion secundario mientras el bloque corre.
+    Indicador giratorio animado en hilo secundario concurrente mientras el bloque se ejecuta.
     - 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}
@@ -234,26 +347,26 @@
     - 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.
+    Convierte cadenas de texto en arte ASCII 3D con bordes y fuentes seleccionables.
 
 {bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
-{bright_yellow}[7] SISTEMA DE TEMAS .gr (CSS PARA TUI) Y EXPORTACION{reset}
+{bright_yellow}[9] 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}
+     {bright_white}GRmenu.theme(:chromatic_red){reset}   # Rojo cromatico vibrante con bordes dobles
+     {bright_white}GRmenu.theme(:cyberpunk){reset}       # Cromaticos 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 fuego, naranja y dorado
+
+  {cyan}2. Especificacion Completa de Bloques en Archivos o Bloques CSS .gr:{reset}
      {gray}GRmenu::config<-1->{reset}
-     {white}@theme:: "CyberNeon"{reset}
+     {white}@theme:: "CyberChromatic"{reset}
      {white}@author:: "GRcode"{reset}
-     {white}@version:: "4.1"{reset}
+     {white}@version:: "4.2"{reset}
 
      {cyan}<<menu{reset}
        {white}style:: 3{reset}                # Estilo de marco 1..20
@@ -263,35 +376,28 @@
        {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}border:: chromatic_cyan:1{reset}     # color:brillo (soporta "rgb:2")
+       {white}title:: chromatic_yellow:2{reset}
+       {white}focus:: chromatic_red:2{reset}
        {white}options:: white:1{reset}
-       {white}banner:: neon_magenta:2{reset}
+       {white}banner:: chromatic_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}border:: chromatic_yellow:1{reset}   # Borde de las cajas laterales
+       {white}focus:: chromatic_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 ▶
+       {white}title:: chromatic_yellow:2{reset}    # Titulo de la caja del submenu
+       {white}arrow:: chromatic_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}active_tab:: chromatic_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
+       {white}indicator:: chromatic_cyan:2{reset}   # Color de los corchetes o separadores
      {cyan}>>{reset}
 
      {cyan}<<table{reset}
@@ -325,20 +431,43 @@
        {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.
+     {cyan}<<input{reset}
+       {white}style:: 3{reset}                # Estilo de marco de la caja de entrada
+       {white}border_color:: chromatic_cyan:1{reset}# Color del borde
+       {white}title_color:: chromatic_yellow:2{reset}# Color del titulo centrado superior
+       {white}label_color:: white:2{reset}    # Color de la etiqueta del campo
+     {cyan}>>{reset}
+
+     {cyan}<<modal{reset}
+       {white}style:: 3{reset}                # Estilo de marco de la ventana emergente 3D
+       {white}border_color:: chromatic_cyan:1{reset}# Color del borde
+       {white}title_color:: chromatic_yellow:2{reset}# Color del titulo centrado
+       {white}content_color:: white:1{reset}  # Color del texto del mensaje
+       {white}shadow:: true{reset}            # Proyeccion de sombra 3D
+     {cyan}>>{reset}
+
+     {cyan}<<form{reset}
+       {white}style:: 3{reset}                # Estilo de marco del formulario multi-campo
+       {white}border_color:: chromatic_cyan:1{reset}# Color del marco exterior
+       {white}title_color:: chromatic_yellow:2{reset}# Color del titulo del formulario
+       {white}focus_color:: green:2{reset}     # Color de resalto del campo y botones activos
+       {white}shadow:: true{reset}            # Proyeccion de sombra 3D
+     {cyan}>>{reset}
+
+  {cyan}3. Exportacion e Importacion de Temas:{reset}
+     - {bright_white}menu.style(<<-GR ... GR){reset} Inyeccion directa de CSS inline.
+     - {bright_white}menu.export_theme("mi_tema.gr"){reset} Exporta el tema activo a un archivo .gr.
      - {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_yellow}[10] 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:
+  {cyan}1. Como Usar Colores Personalizados (Hexadecimal y Cromatico):{reset}
+     El motor soporta TrueColor nativo de 24 bits en todas sus interfaces:
 
      {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}
+        {bright_white}menu.set_style.banner("chromatic_emerald").subtitle("#A6E3A1"){reset}
 
      {white}B) En CSS Inline tipo <style> (menu.style <<-GR ... GR):{reset}
         {bright_white}menu.style(<<-GR){reset}
@@ -349,43 +478,44 @@
 
      {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}
+        {bright_white}puts Color.chromatic_emerald("Texto Esmeralda Cromatico"){reset}
+        {bright_white}puts Color.bold("Texto en Negrita"){reset}
 
-  {cyan}2. Catalogo de 90+ Colores (Cada uno con version Normal y version Neon):{reset}
+  {cyan}2. Catalogo de 90+ Colores (Cada uno con version Normal y version Cromatica):{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
+     - gold / chromatic_gold         | silver / chromatic_silver     | platinum / chromatic_platinum
+     - bronze / chromatic_bronze     | copper / chromatic_copper     | ruby / chromatic_ruby
+     - emerald / chromatic_emerald   | sapphire / chromatic_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
+     - crimson / chromatic_crimson   | scarlet / chromatic_scarlet   | coral / chromatic_coral
+     - amber / chromatic_amber       | peach / chromatic_peach       | orange / chromatic_orange
+     - red / chromatic_red           | yellow / chromatic_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
+     - lime / chromatic_lime         | mint / chromatic_mint         | jade / chromatic_jade
+     - forest / chromatic_forest     | teal / chromatic_teal         | green / chromatic_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
+     - turquoise / chromatic_turquoise | sky / chromatic_sky         | azure / chromatic_azure
+     - cobalt / chromatic_cobalt     | ice / chromatic_ice           | cyan / chromatic_cyan
+     - aqua / chromatic_aqua         | blue / chromatic_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
+     - lavender / chromatic_lavender | mauve / chromatic_mauve       | violet / chromatic_violet
+     - indigo / chromatic_indigo     | fuchsia / chromatic_fuchsia   | rose / chromatic_rose
+     - hot_pink / chromatic_hot_pink | pink / chromatic_pink         | purple / chromatic_purple
+     - magenta / chromatic_magenta
 
      {bright_yellow}Terminal, Hacker y Monitores:{reset}
-     - matrix / neon_matrix     | charcoal / neon_charcoal | white / neon_white
-     - gray                     | black
+     - matrix / chromatic_matrix     | charcoal / chromatic_charcoal | white / chromatic_white
+     - gray / bright_gray            | black / negro
 
   {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_yellow}[11] 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
@@ -394,7 +524,7 @@
   {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_yellow}[12] 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)
@@ -408,25 +538,28 @@
   {yellow}10{reset} -> ▒▒▒▒▒ (Sombreado medio)    {yellow}20{reset} -> ★☆☆☆★ (Estrellas)
 
 {bright_magenta}═════════════════════════════════════════════════════════════════════════════════════{reset}
-{bright_yellow}[11] NAVEGACION POR TECLADO Y CONTROLES CON RATON{reset}
+{bright_yellow}[13] 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}↑ (Arriba):{reset}             Mover foco arriba. En formularios/pestanas retrocede al elemento anterior.
+  * {bright_yellow}↓ (Abajo):{reset}              Mover foco abajo. En formularios/pestanas avanza al elemento siguiente.
+  * {bright_yellow}Tab / Shift+Tab:{reset}        En pestanas y formularios, avanza o retrocede entre campos y botones.
+  * {bright_yellow}→ (Derecha):{reset}            En submenus despliega el siguiente nivel; en formularios mueve el cursor {bright_white}│{reset} a la derecha o incrementa selector.
+  * {bright_yellow}← (Izquierda):{reset}          En submenus regresa al nivel anterior; en formularios mueve el cursor {bright_white}│{reset} a la izquierda o retrocede selector.
+  * {bright_yellow}Home / Ctrl+A:{reset}          En campos de texto de formularios, salta al inicio de la linea.
+  * {bright_yellow}End / Ctrl+E:{reset}           En campos de texto de formularios, salta al final de la linea.
+  * {bright_yellow}Enter:{reset}                  Ejecuta la opcion activa, confirma formulario/modal/tabla o avanza de campo.
+  * {bright_yellow}Esc / q:{reset}                Cierra submenu, cancela formulario o modal (retorna nil), o sale del menu.
+  * {bright_yellow}Espacio:{reset}                Alterna casillas en checkbox y booleanos ([X] / [ ]), o cicla selectores.
+  * {bright_yellow}+ / -:{reset}                  En campos numericos de formularios, incrementa o decrementa el valor por paso.
+  * {bright_yellow}Backspace / Delete:{reset}     Borra caracteres a la izquierda o derecha de la barrita de cursor {bright_white}│{reset}.
+  * {bright_yellow}Ctrl+U:{reset}                 Limpia por completo el contenido del campo de texto o buscador actual.
+  * {bright_yellow}s:{reset}                      En tablas interactivas, ordena las filas por la columna activa.
+  * {bright_yellow}a / n / i:{reset}              En listas checkbox: (a) marcar todos, (n) ninguno, (i) invertir seleccion.
   * {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.
+    - {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 seleccionada con el puntero.
+    - {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_blue}─────────────────────────────────────────────────────────────────────────────────────{reset}

data/data/themes/chromatic_red.gr

@@ -0,0 +1,74 @@
+GRmenu::config<-1->
+
+@theme:: "Chromatic Red"
+@author:: "grcode"
+@version:: "1.0"
+
+<<menu
+  style:: 3
+  banner_style:: 3
+  font:: 1
+  animate:: diagonal
+  desc_prefix:: [!]
+  center:: true
+  border:: chromatic_red:2
+  title:: chromatic_red:2
+  focus:: chromatic_yellow:2
+  options:: white:1
+  banner:: chromatic_red:2
+  subtitle:: chromatic_pink:2
+  divider:: chromatic_red:1
+>>
+
+<<table
+  style:: 3
+  header_color:: chromatic_yellow:2
+  border_color:: chromatic_red:2
+  selected_row:: chromatic_red:2
+  row_color:: white:1
+  zebra_striping:: true
+>>
+
+<<card
+  style:: 7
+  border_color:: chromatic_red:2
+  title_color:: chromatic_yellow:2
+  content_color:: white:1
+>>
+
+<<slider
+  style:: 3
+  color:: chromatic_red:2
+  fill_char:: █
+  empty_char:: ░
+>>
+
+<<checkbox
+  style:: 3
+  color:: chromatic_red:2
+  checked_mark:: [X]
+  unchecked_mark:: [ ]
+>>
+
+<<input
+  style:: 3
+  border_color:: chromatic_red:2
+  title_color:: chromatic_yellow:2
+  label_color:: white:1
+>>
+
+<<modal
+  style:: 3
+  border_color:: chromatic_red:2
+  title_color:: chromatic_yellow:2
+  content_color:: white:1
+  shadow:: true
+>>
+
+<<form
+  style:: 3
+  border_color:: chromatic_red:2
+  title_color:: chromatic_yellow:2
+  focus_color:: chromatic_yellow:2
+  shadow:: true
+>>

data/data/themes/cyberpunk.gr

@@ -52,9 +52,25 @@ GRmenu::config<-1->
   unchecked_mark:: [ ]
 >>
 
+<<input
+  style:: 3
+  border_color:: rgb:2
+  title_color:: yellow:2
+  label_color:: cyan:2
+>>
+
 <<modal
   style:: 3
   border_color:: rgb:2
-  prompt_color:: yellow:2
-  mask_char:: *
+  title_color:: yellow:2
+  content_color:: white:1
+  shadow:: true
+>>
+
+<<form
+  style:: 3
+  border_color:: rgb:2
+  title_color:: yellow:2
+  focus_color:: cyan:2
+  shadow:: true
 >>

data/data/themes/dracula.gr

@@ -52,9 +52,25 @@ GRmenu::config<-1->
   unchecked_mark:: [ ]
 >>
 
+<<input
+  style:: 7
+  border_color:: purple:2
+  title_color:: pink:2
+  label_color:: cyan:2
+>>
+
 <<modal
   style:: 7
   border_color:: purple:2
-  prompt_color:: cyan:2
-  mask_char:: *
+  title_color:: pink:2
+  content_color:: white:1
+  shadow:: true
+>>
+
+<<form
+  style:: 7
+  border_color:: purple:2
+  title_color:: pink:2
+  focus_color:: green:2
+  shadow:: true
 >>

data/data/themes/matrix.gr

@@ -52,9 +52,25 @@ GRmenu::config<-1->
   unchecked_mark:: [ ]
 >>
 
+<<input
+  style:: 2
+  border_color:: green:2
+  title_color:: green:2
+  label_color:: green:2
+>>
+
 <<modal
   style:: 2
   border_color:: green:2
-  prompt_color:: green:2
-  mask_char:: *
+  title_color:: green:2
+  content_color:: green:1
+  shadow:: true
+>>
+
+<<form
+  style:: 2
+  border_color:: green:2
+  title_color:: green:2
+  focus_color:: green:2
+  shadow:: true
 >>