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>
This commit is contained in:
@@ -0,0 +1,208 @@
|
||||
//! `LapalomaStreamElement` — Element GPUI para visualización de
|
||||
//! telemetría con RingBuffer.
|
||||
//!
|
||||
//! Modo **sweep** (canónico del osciloscopio):
|
||||
//! - Los slots `[0, capacity)` tienen `x_norm` fijo precomputado.
|
||||
//! - El `head` marca el slot donde se va a escribir el próximo
|
||||
//! sample → visualmente, el "cursor" que separa la traza vieja
|
||||
//! (a la derecha del head) de la nueva (a la izquierda).
|
||||
//! - Render en **dos segmentos** split-at-head para evitar la
|
||||
//! línea horizontal del wraparound. Antes del fill (count <
|
||||
//! capacity), sólo se pinta `[0, head)`.
|
||||
|
||||
use std::panic;
|
||||
|
||||
use gpui::{
|
||||
App, Bounds, Element, ElementId, GlobalElementId, InspectorElementId, IntoElement, LayoutId,
|
||||
Pixels, Style, Window,
|
||||
};
|
||||
|
||||
use pineal_core::ring::RingBuffer;
|
||||
use pineal_render::{Canvas, Color, Rect, StrokeStyle, WindowCanvas};
|
||||
|
||||
/// Element que pinta un `RingBuffer` en modo sweep.
|
||||
pub struct LapalomaStreamElement {
|
||||
pub buffer: RingBuffer,
|
||||
pub stroke: StrokeStyle,
|
||||
pub background: Option<Color>,
|
||||
/// Rango Y para proyectar los samples a píxeles. Default `-1..1`.
|
||||
pub y_min: f32,
|
||||
pub y_max: f32,
|
||||
pub padding: f32,
|
||||
/// Scratch reusable entre los dos segmentos del frame.
|
||||
scratch: Vec<f32>,
|
||||
}
|
||||
|
||||
impl LapalomaStreamElement {
|
||||
pub fn new(buffer: RingBuffer, stroke: StrokeStyle) -> Self {
|
||||
Self {
|
||||
buffer,
|
||||
stroke,
|
||||
background: None,
|
||||
y_min: -1.0,
|
||||
y_max: 1.0,
|
||||
padding: 8.0,
|
||||
scratch: Vec::new(),
|
||||
}
|
||||
}
|
||||
|
||||
pub fn background(mut self, color: Color) -> Self {
|
||||
self.background = Some(color);
|
||||
self
|
||||
}
|
||||
|
||||
pub fn y_range(mut self, min: f32, max: f32) -> Self {
|
||||
debug_assert!(max > min);
|
||||
self.y_min = min;
|
||||
self.y_max = max;
|
||||
self
|
||||
}
|
||||
|
||||
pub fn padding(mut self, px: f32) -> Self {
|
||||
self.padding = px;
|
||||
self
|
||||
}
|
||||
|
||||
fn plot_rect(&self, bounds: Rect) -> Rect {
|
||||
Rect::new(
|
||||
bounds.x + self.padding,
|
||||
bounds.y + self.padding,
|
||||
(bounds.w - self.padding * 2.0).max(1.0),
|
||||
(bounds.h - self.padding * 2.0).max(1.0),
|
||||
)
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
/// Proyecta una slice de coords `[x_norm, y_value, …]` del
|
||||
/// RingBuffer al sistema de píxeles del plot. `out` se extiende
|
||||
/// (no se clearea acá; el caller decide).
|
||||
fn project_segment(segment: &[f32], plot: Rect, y_min: f32, y_max: f32, out: &mut Vec<f32>) {
|
||||
let y_span = y_max - y_min;
|
||||
if y_span.abs() < 1e-9 {
|
||||
return;
|
||||
}
|
||||
let inv_y_span = 1.0 / y_span;
|
||||
for chunk in segment.chunks_exact(2) {
|
||||
let xn = chunk[0];
|
||||
let yv = chunk[1];
|
||||
let py_norm = (yv - y_min) * inv_y_span;
|
||||
let px = plot.x + xn * plot.w;
|
||||
let py = plot.bottom() - py_norm * plot.h;
|
||||
out.push(px);
|
||||
out.push(py);
|
||||
}
|
||||
}
|
||||
|
||||
impl IntoElement for LapalomaStreamElement {
|
||||
type Element = Self;
|
||||
fn into_element(self) -> Self::Element {
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
impl Element for LapalomaStreamElement {
|
||||
type RequestLayoutState = ();
|
||||
type PrepaintState = ();
|
||||
|
||||
fn id(&self) -> Option<ElementId> {
|
||||
None
|
||||
}
|
||||
|
||||
fn source_location(&self) -> Option<&'static panic::Location<'static>> {
|
||||
None
|
||||
}
|
||||
|
||||
fn request_layout(
|
||||
&mut self,
|
||||
_id: Option<&GlobalElementId>,
|
||||
_inspector_id: Option<&InspectorElementId>,
|
||||
window: &mut Window,
|
||||
cx: &mut App,
|
||||
) -> (LayoutId, Self::RequestLayoutState) {
|
||||
let mut style = Style::default();
|
||||
style.size.width = gpui::Length::Definite(gpui::DefiniteLength::Fraction(1.0));
|
||||
style.size.height = gpui::Length::Definite(gpui::DefiniteLength::Fraction(1.0));
|
||||
let id = window.request_layout(style, [], cx);
|
||||
(id, ())
|
||||
}
|
||||
|
||||
fn prepaint(
|
||||
&mut self,
|
||||
_id: Option<&GlobalElementId>,
|
||||
_inspector_id: Option<&InspectorElementId>,
|
||||
_bounds: Bounds<Pixels>,
|
||||
_request_layout: &mut Self::RequestLayoutState,
|
||||
_window: &mut Window,
|
||||
_cx: &mut App,
|
||||
) -> Self::PrepaintState {
|
||||
}
|
||||
|
||||
fn paint(
|
||||
&mut self,
|
||||
_id: Option<&GlobalElementId>,
|
||||
_inspector_id: Option<&InspectorElementId>,
|
||||
bounds: Bounds<Pixels>,
|
||||
_request_layout: &mut Self::RequestLayoutState,
|
||||
_prepaint: &mut Self::PrepaintState,
|
||||
window: &mut Window,
|
||||
_cx: &mut App,
|
||||
) {
|
||||
let ox: f32 = bounds.origin.x.into();
|
||||
let oy: f32 = bounds.origin.y.into();
|
||||
let w: f32 = bounds.size.width.into();
|
||||
let h: f32 = bounds.size.height.into();
|
||||
let outer = Rect::new(ox, oy, w, h);
|
||||
let plot = self.plot_rect(outer);
|
||||
|
||||
let mut canvas = WindowCanvas::new(window);
|
||||
|
||||
if let Some(bg) = self.background {
|
||||
canvas.fill_rect(outer, bg);
|
||||
}
|
||||
|
||||
let coords = self.buffer.coords();
|
||||
let head = self.buffer.head();
|
||||
let cap = self.buffer.capacity();
|
||||
|
||||
if !self.buffer.is_full() {
|
||||
// Pre-fill: sólo [0, head). Evita la línea plana del
|
||||
// 1.0.2 fix del Flutter doc.
|
||||
let filled = head;
|
||||
if filled >= 2 {
|
||||
let slice = &coords[..filled * 2];
|
||||
self.scratch.clear();
|
||||
project_segment(slice, plot, self.y_min, self.y_max, &mut self.scratch);
|
||||
canvas.stroke_polyline(&self.scratch, self.stroke);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// Ya filled — dos segmentos split-at-head.
|
||||
let split = head * 2;
|
||||
// Segmento "viejo": [head*2 .. cap*2) — temporalmente más antiguo.
|
||||
if split < cap * 2 {
|
||||
let seg1 = &coords[split..];
|
||||
if seg1.len() >= 4 {
|
||||
self.scratch.clear();
|
||||
project_segment(seg1, plot, self.y_min, self.y_max, &mut self.scratch);
|
||||
canvas.stroke_polyline(&self.scratch, self.stroke);
|
||||
}
|
||||
}
|
||||
// Segmento "nuevo": [0 .. head*2) — más reciente, dibujado a
|
||||
// la izquierda del cursor.
|
||||
if split > 0 {
|
||||
let seg2 = &coords[..split];
|
||||
if seg2.len() >= 4 {
|
||||
self.scratch.clear();
|
||||
project_segment(seg2, plot, self.y_min, self.y_max, &mut self.scratch);
|
||||
canvas.stroke_polyline(&self.scratch, self.stroke);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Helper builder-style.
|
||||
pub fn pineal_stream(buffer: RingBuffer, stroke: StrokeStyle) -> LapalomaStreamElement {
|
||||
LapalomaStreamElement::new(buffer, stroke)
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
//! `pineal-stream` — telemetría streaming tipo osciloscopio.
|
||||
//!
|
||||
//! Núcleo: `pineal_core::ring::RingBuffer` + render en dos
|
||||
//! segmentos split-at-head (modo sweep). El emisor de samples vive
|
||||
//! afuera del Element — típicamente en el `Render` host con un
|
||||
//! timer `cx.background_executor().timer(...)` que llama a
|
||||
//! `buffer.push(value)` y `cx.notify()` cada N ms.
|
||||
//!
|
||||
//! El Element clona el RingBuffer por frame (para cap = 512 son
|
||||
//! 4 KB, irrelevante). Para capacidades grandes (100k+) la siguiente
|
||||
//! optimización es pasar `Arc<RingBuffer>` con shared read y
|
||||
//! mutación interna via `Mutex`/`AtomicU64` para el head.
|
||||
|
||||
#![forbid(unsafe_code)]
|
||||
#![allow(dead_code)]
|
||||
|
||||
pub mod envelope {}
|
||||
|
||||
#[cfg(feature = "gpui")]
|
||||
pub mod element;
|
||||
|
||||
#[cfg(feature = "gpui")]
|
||||
pub use element::{pineal_stream, LapalomaStreamElement};
|
||||
Reference in New Issue
Block a user