Files
brahman/crates/modules/pineal/SDD.md
T
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

36 lines
1.9 KiB
Markdown

# modules/pineal/ — Data-viz agnóstica (era lapaloma)
**Propósito.** Motor de gráficos con backends pluggables. Los crates
de visualización no conocen `gpui` ni `wgpu`: hablan contra el trait
`Canvas`, y producen un `RenderPlan` que cada backend ejecuta.
## Crates
| crate | tipo | rol |
| ------------------ | ---- | ---------------------------------------------------- |
| `pineal-core` | lib | Datos: Series, Point, Rect, Color, RingBuffer |
| `pineal-render` | lib | Trait `Canvas` + `RenderPlan` + backend GPUI (feat) |
| `pineal-cartesian` | lib | Axes + viewport + series sobre coord cartesiano |
| `pineal-financial` | lib | Candlestick, OHLC sobre cartesian |
| `pineal-stream` | lib | Streaming a 60Hz desde RingBuffer |
| `pineal-phosphor` | lib | Trail CRT con alpha decay sobre stream |
| `pineal-polar` | lib | Coord polar (stub) |
| `pineal-heatmap` | lib | Grid 2D color-mapped (stub) |
| `pineal-treemap` | lib | Rectangular treemap (stub) |
| `pineal-flow` | lib | Sankey/flow diagrams (stub) |
| `pineal-mesh` | lib | Triangle mesh + barycentric (stub) |
| `pineal-export` | lib | SVG/PNG export del RenderPlan |
| `pineal-umbrella` | lib | Re-export con features `core/render/cartesian/...` |
## Dependencias
- Todos ← `pineal-core`. Render-dependientes ← `pineal-render`.
- Backend GPUI: feature gate `gpui` en pineal-render activa
`gpui_backend.rs` (consumido por widgets en `apps/pineal-*-demo`).
## Estado
LOC ~3,900. 5 charts implementados (cartesian/financial/stream/phosphor
/export). 5 stubs (<50 LOC c/u: polar, heatmap, treemap, flow, mesh).
Roadmap: completar los 5 stubs en orden polar → heatmap → treemap.