sergio
d2e0cf4830
Compositor Wayland teselante real sobre smithay, backend winit (corre anidado como ventana dentro de la sesión X11/Wayland actual). Habla wl_compositor/xdg_shell/wl_shm/wl_seat/wl_data_device y compone las superficies de los clientes con GlesRenderer. Dos modos: autónomo (Cerebro Desktop embebido, un solo proceso) o enlazado (MIRADA_SOCKET → la app mirada decide la geometría). Reusa mirada-body para la contabilidad y mirada-link para el cable. Actualiza el SDD: el Cuerpo deja de ser pendiente. Añade README. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
105 lines
5.5 KiB
Markdown
105 lines
5.5 KiB
Markdown
# modules/mirada/ — Compositor Wayland (carmen)
|
|
|
|
**Propósito.** Un compositor Wayland teselante. La decisión de diseño
|
|
central es partirlo en dos procesos, el **Cerebro** y el **Cuerpo**:
|
|
|
|
- **El Cuerpo** (`mirada-compositor`, sobre `smithay`) habla Wayland con
|
|
los clientes, posee el hardware (DRM/GPU/libinput) y compone las
|
|
superficies reales. Los píxeles nunca salen de él — composición
|
|
*zero-copy*.
|
|
- **El Cerebro** (la app `mirada`, GPUI) decide *dónde* va cada ventana
|
|
—pura aritmética de rectángulos— y orquesta el escritorio: layouts,
|
|
atajos, focos, escritorios virtuales.
|
|
|
|
Los dos hablan por un socket Unix con un contrato mínimo de enums. Así,
|
|
toda la lógica espacial es agnóstica de Wayland y se prueba sin un
|
|
servidor gráfico; el Cuerpo queda reducido a "habla el protocolo y
|
|
ejecuta operaciones de geometría".
|
|
|
|
## Crates
|
|
|
|
| crate | tipo | rol |
|
|
| ------------------ | -------- | ---------------------------------------------------------------------- |
|
|
| `mirada-layout` | lib | Motor de teselado: `Rect`, modos de layout, `Workspace` (ventanas, foco) |
|
|
| `mirada-protocol` | lib | Contrato Cerebro↔Cuerpo: `BrainCommand`/`BodyEvent` + marco de cable |
|
|
| `mirada-brain` | lib | Orquestador del escritorio: `Desktop`, eventos→comandos, atajos |
|
|
| `mirada-link` | lib | Transporte: el socket Unix con hilo lector + canal |
|
|
| `mirada-body` | lib | Contabilidad del Cuerpo: `BodyState`, traduce comandos a `BodyOp` |
|
|
| `mirada` (app) | bin/GPUI | El Cerebro: ventana que tesela el escritorio y manda geometría |
|
|
| `mirada-compositor`| bin/smithay | El Cuerpo: compositor Wayland real (backend `winit`, anidado) |
|
|
|
|
## Flujo
|
|
|
|
```text
|
|
mirada-layout ─► mirada-protocol ─► mirada-brain ─► [app mirada · Cerebro]
|
|
│ │
|
|
│ mirada-link
|
|
│ │
|
|
└────► mirada-body ─► [mirada-compositor · Cuerpo]
|
|
```
|
|
|
|
- El Cuerpo reporta hardware/clientes con `BodyEvent` (salida conectada,
|
|
ventana abierta, atajo pulsado…).
|
|
- El Cerebro (`Desktop::on_event`) recalcula y emite `BrainCommand`
|
|
(`Place` con la geometría completa, `Close`, `GrabKeys`…).
|
|
- El Cuerpo (`BodyState::apply`) traduce cada comando a `BodyOp`
|
|
concretas y sólo emite lo que de verdad cambia.
|
|
|
|
## Detalle por crate
|
|
|
|
- **`mirada-layout`** — `Rect` + `split` (reparto exacto de píxeles),
|
|
`LayoutMode` (`MasterStack`/`Monocle`/`Grid`/`Columns`), `Workspace`
|
|
con foco cíclico y reordenado. Determinista.
|
|
- **`mirada-protocol`** — `WindowPlacement`, los enums `BrainCommand` y
|
|
`BodyEvent`, el marco `postcard` con prefijo `u32` LE
|
|
(`write_frame`/`read_frame`, guard `MAX_FRAME`) y el puente
|
|
`placements(&Workspace, Rect)`.
|
|
- **`mirada-brain`** — `Desktop`: salidas, 9 escritorios virtuales,
|
|
registro de ventanas. `on_event(BodyEvent) -> Vec<BrainCommand>`;
|
|
`DesktopAction` + mapa de teclas estilo *tiling WM* (`Super`).
|
|
- **`mirada-link`** — `Link<Out,In>` sobre socket Unix; hilo lector de
|
|
fondo + canal `mpsc` para sondeo no bloqueante. `BrainLink`/`BodyLink`,
|
|
`connected_pair` (socketpair), `connect`/`listen` por ruta.
|
|
- **`mirada-body`** — `BodyState`: salidas + superficies; `apply` traduce
|
|
`BrainCommand`→`BodyOp` (idempotente), los mutadores del backend
|
|
devuelven los `BodyEvent` a mandar. Ejemplo `headless`: un Cuerpo sin
|
|
gráficos guiado por stdin para ejercitar el bucle entero.
|
|
- **`mirada` (app)** — envuelve `Desktop` y lo pinta (barra de
|
|
escritorios + modo + foco, lienzo teselado). Con `MIRADA_SOCKET`
|
|
conecta a un Cuerpo; sin él corre en **simulación** (ventanas
|
|
sintéticas, teclado de la propia ventana).
|
|
|
|
## Dependencias
|
|
|
|
- Todos los `lib` con `#![forbid(unsafe_code)]`. Cero Wayland, cero
|
|
`smithay` en los seis crates de arriba.
|
|
- El acoplamiento a Wayland/hardware vive sólo en `mirada-compositor`.
|
|
|
|
## Estado
|
|
|
|
Implementado y verde: `mirada-layout` (22 tests), `mirada-protocol`
|
|
(9), `mirada-brain` (17), `mirada-link` (7), `mirada-body` (13), y la
|
|
app `mirada` (compila; verificación visual manual).
|
|
|
|
El **Cuerpo** ya existe: `mirada-compositor` es un compositor Wayland
|
|
teselante real sobre `smithay`, con backend `winit` — corre **anidado**
|
|
como una ventana dentro de la sesión gráfica actual. Habla
|
|
`wl_compositor`/`xdg_shell`/`wl_shm`/`wl_seat`/`wl_data_device`, compone
|
|
las superficies de los clientes con `GlesRenderer` y aplica la geometría
|
|
del Cerebro. Reusa `mirada-body` (contabilidad) y `mirada-link` (cable).
|
|
Dos modos: **autónomo** (Cerebro `Desktop` embebido, un solo proceso) o
|
|
**enlazado** (`MIRADA_SOCKET` → la app `mirada` decide la geometría).
|
|
Compila y pasa clippy; verificación visual manual — ver
|
|
`crates/apps/mirada-compositor/README.md`.
|
|
|
|
**Pendiente** — refinamientos del Cuerpo, no verificables en modo
|
|
desatendido:
|
|
|
|
| capa pendiente | rol |
|
|
| -------------------- | -------------------------------------------------------- |
|
|
| backend DRM/libinput | de `winit` anidado a sesión nativa: superficies KMS, GPU |
|
|
| `mirada-input` | puntero/ratón completo, repetición de teclas, gestos |
|
|
| `mirada-sandbox` | aislamiento de clientes sobre `arje-incarnate` |
|
|
|
|
CRIU (congelar/restaurar ventanas) queda anotado como futuro.
|