Files
brahman/crates/modules/vista/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

41 lines
1.4 KiB
Markdown

# modules/vista/ — Deck horizontal swipe (PageView)
**Propósito.** Carousel/PageView estilo Flutter: gesto horizontal con
snap a página, distinción horizontal vs vertical, soporte mouse +
touch + pointer events. Lógica separada del binding DOM.
## Crates
| crate | tipo | rol |
| ------------- | ---- | --------------------------------------------------------- |
| `vista-core` | lib | `DeckState` agnóstico: pointer_down/move/end → outcomes |
| `vista-web` | lib | Binding DOM sobre `<strip>`: traduce eventos + aplica CSS |
## Dependencias
- `vista-core`: sin deps externas. Pura state machine.
- `vista-web``vista-core`, `wasm-bindgen`, `web-sys` (PointerEvent).
## API agnóstica (vista-core)
```rust
let mut deck = DeckState::new();
deck.pointer_down(x, y, pointer_id, viewport_width);
match deck.pointer_move(x, y) {
DragOutcome::StartHorizontal { pointer_id } => capture_pointer(),
DragOutcome::DragOffset(px) => apply_translate(px),
DragOutcome::CancelVertical => yield_to_scroll(),
DragOutcome::Idle => {}
}
if let Some(r) = deck.pointer_end(offset, width, n_pages) {
apply_translate(r.offset_px);
if r.changed { notify(r.target_index); }
}
```
## Estado
vista-core: 5 tests verdes (drag decision + snap + clamp + goto).
vista-web: binding DOM intacto, ahora delega toda la lógica a core.
LOC 530 (core 175 + web 355). Reutilizable en backends no-web.