1# modules/nahual/ — Motor de UI GPUI (era yahweh)
2
3**Propósito.** Framework de widgets sobre GPUI para apps de escritorio
4nativas: theme persistente, meta-runtime declarativo, providers de
5datos (fs+sqlite), bus de eventos, launcher de paneles.
6
7## Estructura
8
9```
10nahual/
11  libs/       — núcleo del framework
12    core, theme, launcher, bus,
13    meta-schema, meta-runtime,
14    providers/{fs, sqlite}
15  widgets/    — widgets reutilizables
16    tree, container_core, splitter, tabs, tiled,
17    text_input, meta-form, banner, card,
18    stat-card, app-header, theme-switcher
19```
20
21## Dependencias
22
23- Todos los crates `libs/*` y `widgets/*` ← `gpui` (acoplo intencional).
24- `theme` ← `directories` (persistencia de preferencias).
25- `meta-runtime` evalúa esquemas Nickel.
26- Consumido por: `apps/nahual-*` (file/db/text/image explorer + shell)
27  y `apps/cosmobiologia` (vía cosmobiologia-canvas/panel/tree),
28  `apps/akasha-explorer`, `apps/nakui-*`, `apps/minga-explorer`.
29
30## Patrón estándar de explorer
31
32`nahual-shell` define el shell standard (sidebar + main + status panel
33+ hot-reload). Cada app explorer la encarna con su backend custom.
34
35## Estado
36
37LOC 15,968 (sin contar pineal). Tests E2E con `gpui::TestAppContext`.
38Maduro y estable; backbone visual del monorepo. Ver
39`docs/changelog/nahual.md`.