sergio
8204852e3a
Los atajos de teclado dejan de estar cableados: ahora son un Keymap
configurable que vive sólo en el Cerebro. El Cuerpo nunca lo ve — sólo
recibe la lista de cadenas a interceptar (GrabKeys) y devuelve la
pulsada; es Desktop quien la traduce. Esa separación (qué interceptar
vs. qué significa) hace innecesario cualquier candado o Arc.
mirada-brain:
- keymap.rs — Keymap: from_ron/to_ron, load/save, load_or_init (escribe
un archivo por defecto documentado si falta; default sin pisar si está
corrupto), default_path (~/.config/mirada/keymap.ron), y watch sobre
notify para la recarga en caliente (KeymapWatch).
- DesktopAction: Display + FromStr — vocabulario textual estable
("focus-next", "layout:grid", "workspace:3"); evita los guiones que
romperían el RON de un enum.
- Desktop: with_keymap, set_keymap (cambio en caliente -> nuevo GrabKeys).
- Ejemplo keymap-default: imprime el archivo por defecto en RON.
Apps: mirada y mirada-compositor (modo embebido) cargan el keymap del
usuario al arrancar y lo recargan en caliente cuando el archivo cambia.
Disco RON, cable postcard (sólo la lista de cadenas), sin ejecutable
configurador. mirada-brain: 17 -> 29 tests.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
99 lines
3.4 KiB
Markdown
99 lines
3.4 KiB
Markdown
# mirada-compositor — el Cuerpo de carmen
|
|
|
|
Un compositor Wayland teselante real, sobre [`smithay`]. Es el **Cuerpo**
|
|
de la arquitectura Cerebro↔Cuerpo de `mirada` (ver
|
|
`crates/modules/mirada/SDD.md`): habla el protocolo Wayland con los
|
|
clientes, compone sus superficies y aplica la geometría que decide el
|
|
Cerebro.
|
|
|
|
Backend `winit`: corre **anidado** — una ventana dentro de tu sesión
|
|
gráfica actual, X11 o Wayland. No toca DRM/KMS, así que es seguro de
|
|
arrancar sin dejar la sesión.
|
|
|
|
## Requisitos
|
|
|
|
Hace falta una **sesión gráfica anfitriona** (X11 o Wayland) donde
|
|
dibujar la ventana del compositor — es donde `winit` se anida. En un
|
|
servidor *headless* (SSH a una caja sin escritorio, `XDG_SESSION_TYPE=tty`,
|
|
sin `/dev/dri`) no hay dónde mostrar nada y el arranque aborta con un
|
|
mensaje que lo explica.
|
|
|
|
Para verlo en una caja headless: levanta un servidor X virtual y
|
|
conéctate por VNC.
|
|
|
|
```sh
|
|
Xvfb :99 -screen 0 1280x800x24 &
|
|
x11vnc -display :99 -localhost -nopw & # luego túnel SSH al :5900
|
|
DISPLAY=:99 cargo run -p mirada-compositor
|
|
```
|
|
|
|
El backend nativo DRM/KMS —que pintaría directo en la pantalla sin
|
|
sesión anfitriona— está pendiente (ver el SDD), y de todos modos
|
|
necesitaría un `/dev/dri`.
|
|
|
|
## Dos modos
|
|
|
|
- **Autónomo** (por defecto) — lleva un `Desktop` (de `mirada-brain`)
|
|
embebido. Es un compositor teselante completo en un solo proceso.
|
|
|
|
```sh
|
|
cargo run -p mirada-compositor
|
|
```
|
|
|
|
- **Enlazado** — el Cuerpo escucha en un socket y la app `mirada` (el
|
|
Cerebro GPUI) se conecta y decide la geometría.
|
|
|
|
```sh
|
|
# terminal 1 — el Cuerpo
|
|
MIRADA_SOCKET=/tmp/mirada.sock cargo run -p mirada-compositor
|
|
# terminal 2 — el Cerebro
|
|
MIRADA_SOCKET=/tmp/mirada.sock cargo run -p mirada
|
|
```
|
|
|
|
## Probarlo
|
|
|
|
Al arrancar imprime el `WAYLAND_DISPLAY` que abrió. Lanza cualquier
|
|
cliente Wayland contra él:
|
|
|
|
```sh
|
|
WAYLAND_DISPLAY=wayland-1 foot # o weston-terminal, alacritty, …
|
|
```
|
|
|
|
Las ventanas se teselan solas. El teclado, con la ventana del compositor
|
|
enfocada, maneja el escritorio con atajos `Super+…`: foco `Super+j/k`,
|
|
ciclar layout `Super+space`, escritorios `Super+1..9`, cerrar `Super+q`.
|
|
Cierra la ventana del compositor para salir.
|
|
|
|
## Atajos de teclado
|
|
|
|
Los atajos son configurables en RON: `~/.config/mirada/keymap.ron`. En
|
|
modo autónomo, el Cuerpo lo carga al arrancar (si no existe, escribe uno
|
|
por defecto documentado) y lo **recarga en caliente** — edita el archivo,
|
|
guarda, y los atajos cambian sin reiniciar. En modo enlazado el keymap es
|
|
asunto del Cerebro (la app `mirada`).
|
|
|
|
```sh
|
|
cargo run -p mirada-brain --example keymap-default # ver el formato
|
|
```
|
|
|
|
El compositor en sí no interpreta atajos: sólo intercepta las
|
|
combinaciones que el Cerebro le pide (`GrabKeys`) y le devuelve la
|
|
pulsada. *Qué significa* cada una lo decide `mirada-brain`. Ver el SDD.
|
|
|
|
## Qué implementa
|
|
|
|
`wl_compositor`, `xdg_shell` (toplevels y popups), `wl_shm`, `wl_seat`
|
|
(teclado) y `wl_data_device` (selección). Composición con `GlesRenderer`.
|
|
|
|
Reusa `mirada-body` para la contabilidad de salidas y superficies, y
|
|
`mirada-link` para el cable hacia un Cerebro externo. Toda la lógica
|
|
espacial es agnóstica de Wayland y vive en los crates de
|
|
`crates/modules/mirada/`.
|
|
|
|
## Pendiente
|
|
|
|
Backend nativo DRM/libinput (de ventana anidada a sesión real),
|
|
puntero/ratón completo y aislamiento de clientes. Ver el SDD.
|
|
|
|
[`smithay`]: https://github.com/Smithay/smithay
|