grmenu 4.1.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cfab6080b581db0dddff8e9285cb831f70f259bb9da2965761702829c07292f
-  data.tar.gz: 172214b97293124225a3f6eef3f9b71842d3e49a7159e3cc27bacc407ec6db66
+  metadata.gz: a82f3307793b324fb6df221851dd339ab65db676a7750563ab6b53d0e896e5d4
+  data.tar.gz: 0c853fc6d074a65006937912dc24f0917ce9ae9cd3af3b026b2ae47082336645
 SHA512:
-  metadata.gz: 2437295ff5176fc4ace40768e03e7cd25ecbfa0e1562ef625e348eac1f69c7e91c60b2cedf3d48c0f4a9285272978e8b0ae3ec8c1a81e3dbf2c47296b4ef7d0d
-  data.tar.gz: 021bf58afb13dce516963e7bb16b0fe5830498c2e88ab961a6dca0c4f7d5dc13e54fde83cf89b2b5a89a632f9a63a107539a462b82b65ec60f64e78f92eefee8
+  metadata.gz: 5fbf7e715f694d207ed59cc92d089bfc7e5960500e375125ab2b8c7012757f437521bc0bd338928596bec5d3d0251991b557ba87121a2ed65300b8d25f077cf0
+  data.tar.gz: b52ef0c04a2b5e90c334c4a7bc34d96eb542e1362be77b9d4a57c2beea8ad3481fa585fb23bed1da5be0f10caddcf359b7fdfaf4f57503cf09a65233927ee349

data/README.md

@@ -1,8 +1,8 @@
-# GRmenu (Ruby) v4.1.0
+# GRmenu (Ruby) v5.0.0
 
 **Suite TUI Profesional y Ligera para la Creación de Interfaces de Línea de Comandos en Terminales TTY.**
 
-Menús interactivos por teclado y ratón (ANSI SGR 1006), submenús laterales en cascada (hasta 3 niveles: *Sub del Sub*), menús por pestañas multitarea (`GRmenu.tabs`), rediseño de entrada de datos (`GRmenu.input`), tablas con ordenamiento y búsqueda en vivo, selección múltiple con casillas de verificación, controles deslizantes en tiempo real, renderizado de imágenes ANSI TrueColor de 24 bits, sistema de temas estilo CSS `.gr`, iluminación dinámica Living Neon a 30 FPS en vivo, colores hexadecimales directos (`#RRGGBB`), modales nativos de confirmación y texto, buscador instantáneo en vivo, cuadrículas bidimensionales, barras de progreso y banners 3D sin dependencias externas.
+Formularios multi-campo interactivos con barrita de cursor `│`, ventanas modales flotantes 3D (`GRmenu.modal`), control de fondo de ventana (`GRmenu.window`) con auto-restauración limpia, menús interactivos por teclado y ratón (ANSI SGR 1006), submenús laterales en cascada (hasta 3 niveles: *Sub del Sub*), menús por pestañas multitarea (`GRmenu.tabs`), rediseño de entrada de datos (`GRmenu.input`), tablas con ordenamiento y búsqueda en vivo, selección múltiple con casillas de verificación, controles deslizantes en tiempo real, renderizado de imágenes ANSI TrueColor de 24 bits, sistema de temas estilo CSS `.gr`, iluminación dinámica Cromática a 30 FPS en vivo, colores hexadecimales directos (`#RRGGBB`), modales nativos de confirmación y texto, buscador instantáneo en vivo, cuadrículas bidimensionales, barras de progreso y banners 3D sin dependencias externas.
 
 [![Gem Version](https://badge.fury.io/rb/grmenu.svg)](https://badge.fury.io/rb/grmenu)
 [![License: MIT](https://img.shields.io/github/license/JoseEduardoGR/GRmenu)](LICENSE)
@@ -31,12 +31,15 @@ Menús interactivos por teclado y ratón (ANSI SGR 1006), submenús laterales en
    - [10. Tarjetas Estilizadas y Alertas (GRmenu.card y GRmenu.alert)](#10-tarjetas-estilizadas-y-alertas-grmenucard-y-grmenualert)
    - [11. Renderizado Universal de Imágenes en Terminal (GRmenu.image)](#11-renderizado-universal-de-imágenes-en-terminal-grmenuimage)
    - [12. Barras de Progreso y Spinners de Carga](#12-barras-de-progreso-y-spinners-de-carga)
-   - [13. Iluminación Dinámica Living Neon a 30 FPS](#13-iluminación-dinámica-living-neon-a-30-fps)
+   - [13. Iluminación Dinámica Cromática a 30 FPS](#13-iluminación-dinámica-cromática-a-30-fps)
    - [14. Banners ASCII 3D y Módulo de Color (Color / C)](#14-banners-ascii-3d-y-módulo-de-color)
    - [15. Sistema de Temas .gr y CSS para TUI](#15-sistema-de-temas-gr-y-css-para-tui)
    - [16. Exportación de Temas desde Terminal / CLI (-theme)](#16-exportación-de-temas-desde-terminal--cli--theme)
    - [17. CSS Inline en el Código (<<-GR)](#17-css-inline-en-el-código--gr)
-5. [Laboratorio de Nuevas Funcionalidades (ruby/eaja.rb y ruby/e.rb)](#laboratorio-de-nuevas-funcionalidades)
+   - [18. Formularios Multi-Campo Interactivos (GRmenu.form)](#18-formularios-multi-campo-interactivos-grmenuform)
+   - [19. Ventanas Modales Flotantes 3D (GRmenu.modal)](#19-ventanas-modales-flotantes-3d-grmenumodal)
+   - [20. Control de Color y Fondo de Terminal (GRmenu.window)](#20-control-de-color-y-fondo-de-terminal-grmenuwindow)
+5. [Laboratorio de Nuevas Funcionalidades (ruby/j.rb, ruby/eaja.rb y ruby/e.rb)](#laboratorio-de-nuevas-funcionalidades)
 6. [Catálogo Visual de Fuentes 3D (1 al 10)](#catálogo-visual-de-fuentes-3d)
 7. [Catálogo Visual de Marcos y Bordes (1 al 20)](#catálogo-visual-de-marcos-y-bordes)
 8. [Referencia Exhaustiva de la API de Ruby](#referencia-exhaustiva-de-la-api-de-ruby)
@@ -54,7 +57,7 @@ Menús interactivos por teclado y ratón (ANSI SGR 1006), submenús laterales en
 - **Sistema de Temas CSS (.gr):** Diseña la estética visual de tu consola como si fuera una hoja de estilos web con bloques `<<menu`, `<<submenu`, `<<tabs`, `<<input`, `<<table`, `<<card`, `<<slider` y `<<checkbox`.
 - **Firmas Flexibles en Todos los Widgets:** Acepta tanto llamadas clásicas posicionales como llamadas por palabra clave (`title:`, `headers:`, `rows:`, `pause: false`).
 - **Colores Hexadecimales Directos:** Soporta valores `#FF0055`, `#00F5FF`, `#0FF` en cualquier marco, texto o banner con TrueColor de 24 bits nativo.
-- **Animaciones Living Neon a 30 FPS:** Olas de luz senoidal continuas y destellos de incandescencia en tiempo real sin introducir retraso en el teclado.
+- **Animaciones Cromática a 30 FPS:** Olas de luz senoidal continuas y destellos de incandescencia en tiempo real sin introducir retraso en el teclado.
 - **Modo TTY Crudo Instantáneo:** Control milimétrico de la consola sin parpadeo de pantalla y con captura instantánea de eventos de teclado (0 ms de latencia).
 - **Multiplataforma Real:** Totalmente compatible con Linux, macOS y Windows (Windows Terminal, PowerShell, CMD y terminal de VS Code).
 
@@ -92,7 +95,7 @@ Crea un archivo llamado `app.rb` y ejecútalo con `ruby app.rb`:
 require 'grmenu'
 
 # Cargar un tema integrado con estética neón
-GRmenu.theme(:neon_red)
+GRmenu.theme(:chromatic_red)
 
 def saludar
   GRmenu.alert(:success, "Bienvenido a GRmenu v4.1.0!")
@@ -246,7 +249,7 @@ tabs_data = {
     ["Redis Cache", -> { GRmenu.card("Redis", "Memoria: 14 MB", pause: false); sleep 1.2 }]
   ],
   "Configuración" => [
-    ["Cambiar Tema Neon", -> { GRmenu.theme(:cyberpunk) }]
+    ["Cambiar Tema Cromático", -> { GRmenu.theme(:cyberpunk) }]
   ]
 }
 
@@ -298,8 +301,8 @@ servidor = GRmenu.input(
   label: "URL del Servidor:",
   default: "http://localhost:8080",
   style: 3,
-  border_color: "neon_cyan",
-  title_color: "neon_yellow",
+  border_color: "chromatic_cyan",
+  title_color: "chromatic_yellow",
   label_color: "white"
 )
 
@@ -309,7 +312,7 @@ token = GRmenu.input(
   label: "Token Secreto:",
   password: true,
   style: 3,
-  border_color: "neon_red"
+  border_color: "chromatic_red"
 )
 
 # Uso rápido posicional
@@ -335,7 +338,7 @@ paquetes = [
 seleccionados = GRmenu.checkbox(
   paquetes,
   title: "Instalador de Paquetes",
-  color: "neon_cyan",
+  color: "chromatic_cyan",
   style: 3
 )
 
@@ -377,7 +380,7 @@ ram = GRmenu.slider(
 Cuadros emergentes Si / No con botones activos interactivos:
 
 ```ruby
-if GRmenu.confirm("¿Deseas aplicar los cambios en producción?", default: true, color: "neon_green", style: 3)
+if GRmenu.confirm("¿Deseas aplicar los cambios en producción?", default: true, color: "chromatic_green", style: 3)
   puts "Aplicando..."
 end
 ```
@@ -412,7 +415,7 @@ filas = [
 ]
 
 # Llamada posicional
-fila = GRmenu.table(headers, filas, style: 3, header_color: "neon_yellow")
+fila = GRmenu.table(headers, filas, style: 3, header_color: "chromatic_yellow")
 
 # Llamada por palabra clave
 fila = GRmenu.table(
@@ -444,7 +447,7 @@ GRmenu.alert(:error, "Fallo al conectar con el cluster.", pause: false)
 GRmenu.alert(:info, "Actualización disponible.")
 
 # Tarjeta informativa posicional (ideal para respuestas y logs)
-GRmenu.card("NGINX Web Server", "NGINX iniciado en el puerto 80 (PID 1024)", style: 3, border_color: "neon_green", pause: false)
+GRmenu.card("NGINX Web Server", "NGINX iniciado en el puerto 80 (PID 1024)", style: 3, border_color: "chromatic_green", pause: false)
 
 # Tarjeta informativa con keywords
 GRmenu.card(
@@ -465,7 +468,7 @@ Decodifica y renderiza cualquier formato de imagen (PNG, JPEG, JPG, WEBP, GIF, B
 
 ```ruby
 # 1. Renderizado directo en consola
-GRmenu.image("assets/logo.png", width: 40, style: 3, color: "neon_cyan", center: true)
+GRmenu.image("assets/logo.png", width: 40, style: 3, color: "chromatic_cyan", center: true)
 
 # 2. Como cabecera gráfica dentro de un menú interactivo
 menu = GRmenu.new(
@@ -483,7 +486,7 @@ menu.draw
 
 ```ruby
 # Barra de progreso con avance dinámico
-GRmenu.progress(100, title: "Descargando Paquetes", color: "neon_yellow", style: 3) do |bar|
+GRmenu.progress(100, title: "Descargando Paquetes", color: "chromatic_yellow", style: 3) do |bar|
   10.times do |i|
     sleep 0.1
     bar.advance(10, status: "Procesando bloque #{i + 1} de 10...")
@@ -491,7 +494,7 @@ GRmenu.progress(100, title: "Descargando Paquetes", color: "neon_yellow", style:
 end
 
 # Spinner animado no bloqueante en hilo secundario
-resultado = GRmenu.spinner("Conectando con el cluster remoto...", color: "neon_cyan") do
+resultado = GRmenu.spinner("Conectando con el cluster remoto...", color: "chromatic_cyan") do
   sleep 1.2
   "Conexión exitosa"
 end
@@ -499,7 +502,7 @@ end
 
 ---
 
-### 13. Iluminación Dinámica Living Neon a 30 FPS
+### 13. Iluminación Dinámica Cromática a 30 FPS
 
 Al configurar `animate: "diagonal"`, `"linear"`, `"fade"` o `"rgb"`, el motor proyecta una ola de luz senoidal continua en tiempo real a 30 FPS que barre los marcos y los banners con destellos de incandescencia (*glow*), sin introducir retraso en el teclado:
 
@@ -507,11 +510,11 @@ Al configurar `animate: "diagonal"`, `"linear"`, `"fade"` o `"rgb"`, el motor pr
 menu = GRmenu.new(
   opciones,
   banner: "THEMES",
-  title: "Efecto Neón Vivo",
+  title: "Efecto Cromático Vivo",
   style: 3,
   animate: "diagonal"
 )
-menu.set_style.border("neon_red").banner("neon_red").focus("neon_yellow")
+menu.set_style.border("chromatic_red").banner("chromatic_red").focus("chromatic_yellow")
 menu.draw
 ```
 
@@ -521,14 +524,14 @@ menu.draw
 
 ```ruby
 # Banners en arte ASCII 3D (fuentes del 1 al 10)
-GRmenu.banner("ADMIN", 0, color: "neon_red", style: 3, font: 1)
+GRmenu.banner("ADMIN", 0, color: "chromatic_red", style: 3, font: 1)
 
 # Módulo Color / C / Colors
 puts Color.rgb("Texto degradado en onda arcoíris continua")
 puts Color.hex("#FF0055", "Texto en Rojo Carmesí")
 puts Color.gold("Texto en Dorado")
-puts Color.neon_cyan("Texto en Cian Neón")
-puts Color.neon_emerald("Texto en Esmeralda Neón")
+puts Color.chromatic_cyan("Texto en Cian Cromático")
+puts Color.chromatic_emerald("Texto en Esmeralda Cromático")
 ```
 
 ---
@@ -539,8 +542,8 @@ GRmenu incluye un motor de temas declarativos en archivos `.gr` con sintaxis lim
 
 #### Cargar Temas Integrados:
 ```ruby
-GRmenu.theme(:neon_red)    # Rojos eléctricos incandescentes y foco amarillo
-GRmenu.theme(:cyberpunk)   # Neones cian, amarillo y efecto Chroma
+GRmenu.theme(:chromatic_red)    # Rojos eléctricos incandescentes y foco amarillo
+GRmenu.theme(:cyberpunk)   # Cromáticos cian, amarillo y efecto Chroma
 GRmenu.theme(:matrix)      # Verde fosforescente terminal hacker
 GRmenu.theme(:dracula)     # Morados, fucsias y cian
 GRmenu.theme(:nord)        # Azules árticos y paleta fría
@@ -552,7 +555,7 @@ GRmenu.theme(:sunset)      # Atardecer cálido en rojos, naranjas y dorados
 ```gr
 GRmenu::config<-1->
 
-@theme:: "CyberNeon"
+@theme:: "CyberChromatic"
 @author:: "GRcode"
 @version:: "4.1"
 
@@ -564,34 +567,34 @@ GRmenu::config<-1->
   desc_prefix:: ->
   center:: true
   mouse:: true
-  border:: neon_cyan:1
-  title:: neon_yellow:2
-  focus:: neon_red:2
+  border:: chromatic_cyan:1
+  title:: chromatic_yellow:2
+  focus:: chromatic_red:2
   options:: white:1
-  banner:: neon_magenta:2
+  banner:: chromatic_magenta:2
   subtitle:: cyan:1
   divider:: blue:1
 >>
 
 <<submenu
   style:: 3
-  border:: neon_yellow:1
-  focus:: neon_cyan:2
+  border:: chromatic_yellow:1
+  focus:: chromatic_cyan:2
   options:: white:1
-  title:: neon_yellow:2
-  arrow:: neon_cyan:2
+  title:: chromatic_yellow:2
+  arrow:: chromatic_cyan:2
 >>
 
 <<tabs
-  active_tab:: neon_yellow:2
+  active_tab:: chromatic_yellow:2
   tab_color:: gray:1
-  indicator:: neon_cyan:2
+  indicator:: chromatic_cyan:2
 >>
 
 <<input
   style:: 3
-  border_color:: neon_cyan:1
-  title_color:: neon_yellow:2
+  border_color:: chromatic_cyan:1
+  title_color:: chromatic_yellow:2
   label_color:: white:2
 >>
 
@@ -664,23 +667,23 @@ menu.style(<<-GR)
 <<menu
   style:: 3
   mouse:: true
-  border:: neon_cyan:1
-  title:: neon_yellow:2
-  focus:: neon_red:2
+  border:: chromatic_cyan:1
+  title:: chromatic_yellow:2
+  focus:: chromatic_red:2
 >>
 <<submenu
   style:: 3
-  border:: neon_yellow:1
-  focus:: neon_cyan:2
+  border:: chromatic_yellow:1
+  focus:: chromatic_cyan:2
 >>
 <<tabs
-  active_tab:: neon_yellow:2
+  active_tab:: chromatic_yellow:2
   tab_color:: gray:1
 >>
 <<input
   style:: 3
-  border_color:: neon_cyan:1
-  title_color:: neon_yellow:2
+  border_color:: chromatic_cyan:1
+  title_color:: chromatic_yellow:2
   label_color:: white:2
 >>
 GR
@@ -690,17 +693,147 @@ menu.draw
 
 ---
 
+### 18. Formularios Multi-Campo Interactivos (`GRmenu.form`)
+
+Permite capturar múltiples datos en una sola pantalla encapsulada con diseño profesional, sombra 3D proyectada (`▒▒`), navegación fluida con `Tab` o flechas `↑`/`↓`, **barrita de cursor activa `│`** en tiempo real y retorno estructurado como un `Hash` de Ruby:
+
+```text
+╔══════════════ Registro de Nueva Cuenta ══════════════╗
+║                                                      ║
+║   Nombre de Usuario: [ gabo_dev│                   ] ║▒▒
+║          Contraseña: [ **********                 ] ║▒▒
+║            Edad TCP: [ 25│                         ] ║▒▒
+║     Rol del Sistema: [ < Desarrollador >           ] ║▒▒
+║   ¿Habilitar HTTPS?: [ [X] Sí                      ] ║▒▒
+║                                                      ║
+║  ──────────────────────────────────────────────────  ║▒▒
+║             > [ ✔ Guardar ] <      [ ✖ Cancelar ]    ║▒▒
+║     Tab/↑↓: Mover | Enter: Siguiente | Esc: Cancelar ║▒▒
+╚══════════════════════════════════════════════════════╝▒▒
+  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
+```
+
+#### Uso mediante Bloque DSL:
+```ruby
+datos = GRmenu.form("Registro de Nueva Cuenta", color: "cyan", style: 3, shadow: true) do |f|
+  f.text     :usuario,  "Nombre de Usuario:", default: "gabo_dev", placeholder: "Ej. admin"
+  f.password :password, "Contraseña:",        mask: "*"
+  f.number   :edad,     "Edad:",              default: 25, min: 18, max: 99, step: 1
+  f.select   :rol,      "Rol del Sistema:",   ["Admin", "Desarrollador", "Auditor"], default: "Desarrollador"
+  f.boolean  :https,    "¿Habilitar HTTPS?",  default: true
+end
+
+if datos
+  puts "Datos recibidos: #{datos.inspect}"
+  # => {:usuario=>"gabo_dev", :password=>"...", :edad=>25, :rol=>"Desarrollador", :https=>true}
+else
+  puts "Formulario cancelado por el usuario"
+end
+```
+
+* **Tipos de campo soportados:**
+  - `f.text(key, label, default: "", placeholder: "")`: Texto con cursor `│`, soporte de `Home`, `End`, `Ctrl+U`, `Backspace` y desplazamiento horizontal si excede el ancho.
+  - `f.password(key, label, default: "", mask: "*")`: Contraseña con caracteres enmascarados y barrita de cursor.
+  - `f.number(key, label, default: 0, min: nil, max: nil, step: 1)`: Campo numérico editable con cursor `│`, límites y atajos `+`/`-`.
+  - `f.select(key, label, options = [], default: nil)`: Selector interactivo inline `< Opción >` ciclable con `←`/`→` o `Espacio`.
+  - `f.boolean(key, label, default: false)` (alias `f.checkbox`): Casilla booleana `[X] Sí` / `[ ] No` alternable con `Espacio` o `s`/`n`/`y`.
+* **Teclas y Atajos:**
+  - `Tab` / `↓`: Avanza al siguiente campo o botón.
+  - `Shift+Tab` / `↑`: Retrocede al campo o botón anterior.
+  - `←` / `→`: Mueve la barrita de cursor `│` a través del texto, o navega opciones en selectores.
+  - `Home` / `Ctrl+A`: Salta al inicio del campo.
+  - `End` / `Ctrl+E`: Salta al final del campo.
+  - `Ctrl+U`: Limpia todo el texto del campo activo.
+  - `Backspace` / `Delete`: Borra el carácter anterior o siguiente al cursor.
+  - `Enter`: Avanza al siguiente campo; sobre `[ ✔ Guardar ]` o `[ ✖ Cancelar ]` ejecuta la acción.
+  - `Esc`: Cancela el formulario inmediatamente (retorna `nil`).
+
+---
+
+### 19. Ventanas Modales Flotantes 3D (`GRmenu.modal` / `GRmenu.popup`)
+
+Despliega ventanas emergentes flotantes centradas en pantalla con **sombra proyectada 3D (`▒▒`)**, ajuste de texto automático (*word-wrapping*) y fila de botones de acción interactivos:
+
+```text
+       ╔═════════════════ Confirmación de Despliegue ═════════════════╗
+       ║                                                              ║
+       ║ Se aplicarán los cambios a la base de datos de producción.   ║▒▒
+       ║ Esta operación creará un snapshot de seguridad previo.       ║▒▒
+       ║ ¿Deseas continuar con la migración?                          ║▒▒
+       ║                                                              ║
+       ║         > [ ✔ Proceder ] <      [ Posponer ]      [ ✖ Cancelar ]       ║▒▒
+       ╚══════════════════════════════════════════════════════════════╝▒▒
+         ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
+```
+
+```ruby
+decision = GRmenu.modal(
+  title: "Confirmación de Despliegue",
+  content: "Se aplicarán los cambios a la base de datos de producción.\nEsta operación creará un snapshot de seguridad previo.\n¿Deseas continuar con la migración?",
+  buttons: ["Proceder", "Posponer", "Cancelar"],
+  color: "chromatic_yellow",
+  style: 3,
+  shadow: true
+)
+
+case decision
+when "Proceder"
+  puts "Iniciando despliegue..."
+when "Posponer"
+  puts "Despliegue aplazado 1 hora."
+else
+  puts "Operación cancelada."
+end
+```
+
+* **Características:**
+  - Auto-ajuste de párrafos largos (*word-wrapping*) sin desbordar la consola ni quebrar bordes.
+  - Botones interactivos con foco activo resaltado.
+  - `←` / `→` o `Tab` / `Shift+Tab` para navegar entre botones; `Enter` o `Espacio` para confirmar.
+  - `Esc` cierra la modal y retorna `nil`.
+
+---
+
+### 20. Control de Color y Fondo de Terminal (`GRmenu.window`)
+
+Permite pintar y personalizar el fondo global de toda la ventana de la terminal utilizando secuencias de escape nativas **OSC 11** (`\e]11;#hex\a`) combinadas con limpieza por extensión de color (*ANSI BCE*):
+
+```ruby
+# 1. Cambiar el color de fondo usando código Hexadecimal
+GRmenu.window.color("#0f172a") # Azul Marino profundo
+GRmenu.window.bg("#1a1b26")    # Tokyo Night
+
+# 2. Usar nombres integrados o alias en español
+GRmenu.window.color("negro")   # Negro puro (#000000)
+GRmenu.window.bg("red")        # Rojo vibrante
+
+# 3. Usar arreglo RGB directo [R, G, B]
+GRmenu.window.bg([15, 32, 39])
+
+# 4. Cambiar el título de la ventana de la consola (OSC 0)
+GRmenu.window.title("Panel de Control - v5.0")
+
+# 5. Restaurar el fondo natural de la terminal manualmente (OSC 111)
+GRmenu.window.reset
+```
+
+* **Auto-Restauración Limpia Garantizada:**
+  GRmenu registra limpiadores automáticos con `at_exit` y captura de señales del sistema (`SIGINT`, `SIGTERM`, `SIGHUP`). Si tu script termina normalmente, ocurre un error no controlado o el usuario presiona `Ctrl+C`, **el fondo de la terminal siempre vuelve a su estado original** automáticamente, sin dejar residuos visuales.
+
+---
+
 ## Laboratorio de Nuevas Funcionalidades
 
-Puedes ejecutar el archivo de laboratorio interactivo completo para probar en vivo los submenús de 3 niveles, las pestañas con ratón y el input rediseñado:
+Puedes ejecutar el laboratorio interactivo para probar en vivo los nuevos formularios multi-campo, las ventanas modales 3D y el fondo de terminal:
 
 ```bash
-ruby ruby/eaja.rb
+ruby ruby/j.rb
 ```
 
-O el laboratorio general de componentes:
+O los laboratorios de submenús de 3 niveles, pestañas y componentes generales:
 
 ```bash
+ruby ruby/eaja.rb
 ruby ruby/e.rb
 ```
 
@@ -779,6 +912,10 @@ Configura el diseño del marco mediante el parámetro `style: 1..20`:
 | `GRmenu.checkbox` | `(items, ...)` | Devuelve `Array` con elementos marcados (`[X]`). |
 | `GRmenu.slider` | `(prompt, ...)` | Devuelve valor numérico seleccionado en barra interactiva. |
 | `GRmenu.confirm` | `(pregunta, ...)` | Devuelve booleano (`true`/`false`) con botones interactivos. |
+| `GRmenu.modal` | `(title:, content:, buttons:, ...)` | Ventana flotante 3D emergente con sombra proyectada y botones (Alias: `popup`). |
+| `GRmenu.form` | `(title, **opts, &bloque)` | Formulario interactivo multi-campo con barrita de cursor y retorno Hash. |
+| `GRmenu.window.color`| `(color_o_hex)` | Cambia el fondo global de la terminal (OSC 11 + BCE) con auto-restauración limpia. |
+| `GRmenu.window.reset`| `()` | Restaura el fondo predeterminado original de la terminal (OSC 111). |
 | `GRmenu.input` | `(title: ..., label: ..., ...)` | Entrada de texto rediseñada con marco y cursor `█`. |
 | `GRmenu.image` | `(filepath, width:, style:, color:)` | Renderiza imagen en TrueColor 24-bit (Lanczos / Zlib). |
 | `GRmenu.progress` | `(total = 100, ... &bloque)` | Barra de progreso dinámica con bloque. |