# modules/nahual/ — Motor de UI GPUI (era yahweh)

**Propósito.** Framework de widgets sobre GPUI para apps de escritorio
nativas: theme persistente, meta-runtime declarativo, providers de
datos (fs+sqlite), bus de eventos, launcher de paneles.

## Estructura

```
nahual/
  libs/       — núcleo del framework
    core, theme, launcher, bus,
    meta-schema, meta-runtime,
    providers/{fs, sqlite}
  widgets/    — widgets reutilizables
    tree, container_core, splitter, tabs, tiled,
    text_input, meta-form, banner, card,
    stat-card, app-header, theme-switcher
```

## Dependencias

- Todos los crates `libs/*` y `widgets/*` ← `gpui` (acoplo intencional).
- `theme` ← `directories` (persistencia de preferencias).
- `meta-runtime` evalúa esquemas Nickel.
- Consumido por: `apps/nahual-*` (file/db/text/image explorer + shell)
  y `apps/cosmobiologia` (vía cosmobiologia-canvas/panel/tree),
  `apps/akasha-explorer`, `apps/nakui-*`, `apps/minga-explorer`.

## Patrón estándar de explorer

`nahual-shell` define el shell standard (sidebar + main + status panel
+ hot-reload). Cada app explorer la encarna con su backend custom.

## Estado

LOC 15,968 (sin contar pineal). Tests E2E con `gpui::TestAppContext`.
Maduro y estable; backbone visual del monorepo. Ver
`docs/changelog/nahual.md`.