Files
sergio 550c98f275 refactor(monorepo): reorganización lógica + renames + SDDs + split CHANGELOG
Reorganización física de crates/:
- core/ (mezclaba 6 propósitos) se divide en protocol/, init/, runtime/, compat/
- shared/ (3 crates) se redistribuye en protocol/ e init/
- lapaloma (sub-módulo de ui_engine) se promueve a modules/pineal/

Renames de proyectos:
- shipote → shuma (runtime de sandboxes)
- nouser → akasha (explorador de Mónadas)
- yahweh → nahual (motor GPUI, antes ui_engine/)
- lapaloma → pineal (data-viz agnóstica)

Fraccionamiento UI → core agnóstico:
- vista-core (DeckState + snap, 175 LOC, 5 tests verdes)
- barra-core (Task + render_html + sanitize, 90 LOC, 5 tests verdes)
- vista-web y barra-web ahora son thin DOM bindings

Documentación nueva:
- 16 SDDs por subdirectorio (≤80 LOC c/u): protocol/init/runtime/compat
  + 10 módulos + apps/
- docs/STATUS.md con cifras reales por proyecto
- docs/ROADMAP.md con plan a finalización (6 hitos, ~6-8 semanas)
- CHANGELOG.md particionado en docs/changelog/<proyecto>.md (7 buckets)

Automatización:
- scripts/reorg.py — script idempotente que: git mv directorios, renombra
  package names, recomputa path = refs, reescribe imports rust, actualiza
  workspace Cargo.toml. Soporta --dry-run.
- scripts/split-changelog.py — particiona CHANGELOG por componente.

Validación:
- cargo check --workspace pasa (124 crates + 2 nuevos cores).
- 10 tests adicionales (5 en vista-core + 5 en barra-core) verdes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 14:48:34 +00:00

40 lines
1.3 KiB
Markdown

# 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`.