feat: llimphi standalone — framework UI soberano extraído del monorepo

Motor gráfico Llimphi como workspace independiente: bucle Elm (input→update→view→layout→raster→present) sobre wgpu+vello+taffy+parley. Núcleo (hal/raster/layout/text/ui/theme/surface/motion/icons) + ~40 widgets + módulos, sin dependencias al resto del monorepo. cargo check --workspace pasa (64 crates). Puerta de entrada: cargo run -p llimphi-ui --example counter. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 04:23:42 +00:00
commit e65e9cc623
286 changed files with 46136 additions and 0 deletions
@@ -0,0 +1,270 @@
+//! `llimphi-widget-text-input` — input de texto single-line para Llimphi.
+//!
+//! Después del refactor 2026-05-25, [`TextInputState`] es un wrapper fino
+//! sobre [`llimphi_widget_text_editor::EditorState`] con
+//! `options.single_line = true` + un flag `masked` para passwords. La
+//! API pública (`new`, `masked`, `text`, `set_text`, `clear`, `apply_key`,
+//! `is_empty`, `push_str`, `pop`, `is_masked`) se mantiene salvo que
+//! `text()` ahora devuelve `String` (antes `&str`) — los callers que
+//! hacían `.text().trim().to_string()` siguen funcionando idénticos.
+//!
+//! Beneficios heredados del editor: selección con Shift+arrows, undo/
+//! redo con Ctrl+Z/Y, salto de palabra con Ctrl+arrows, Home/End,
+//! Delete (además de Backspace). Tab/Enter siguen ignorados (single_line).
+
+#![forbid(unsafe_code)]
+
+use llimphi_ui::llimphi_layout::taffy::{
+    prelude::{length, percent, Size, Style},
+    AlignItems, Rect,
+};
+use llimphi_ui::llimphi_raster::peniko::Color;
+use llimphi_ui::llimphi_text::Alignment;
+use llimphi_ui::{KeyEvent, View};
+use llimphi_widget_text_editor::{EditorOptions, EditorState};
+
+/// Paleta del input. Defaults son una variante dark con borde tenue que
+/// se enciende al focar, equivalente conceptual al `nahual-theme` dark.
+#[derive(Debug, Clone, Copy)]
+pub struct TextInputPalette {
+    pub bg: Color,
+    pub bg_focus: Color,
+    pub border: Color,
+    pub border_focus: Color,
+    pub fg_text: Color,
+    pub fg_placeholder: Color,
+}
+
+impl Default for TextInputPalette {
+    fn default() -> Self {
+        Self::from_theme(&llimphi_theme::Theme::dark())
+    }
+}
+
+impl TextInputPalette {
+    /// Construye la paleta desde un `Theme` semántico.
+    pub fn from_theme(t: &llimphi_theme::Theme) -> Self {
+        Self {
+            bg: t.bg_input,
+            bg_focus: t.bg_input_focus,
+            border: t.border,
+            border_focus: t.border_focus,
+            fg_text: t.fg_text,
+            fg_placeholder: t.fg_placeholder,
+        }
+    }
+}
+
+/// Estado del input. Wrappea un `EditorState` single-line.
+#[derive(Debug, Clone, Default)]
+pub struct TextInputState {
+    inner: EditorState,
+    masked: bool,
+}
+
+impl TextInputState {
+    /// Input vacío visible (texto plano).
+    pub fn new() -> Self {
+        Self {
+            inner: EditorState::with_options(EditorOptions {
+                single_line: true,
+                ..EditorOptions::default()
+            }),
+            masked: false,
+        }
+    }
+
+    /// Input enmascarado — para campos de contraseña.
+    pub fn masked() -> Self {
+        Self { masked: true, ..Self::new() }
+    }
+
+    /// Texto actual. Devuelve `String` (antes `&str` — el rope no expone
+    /// slice borrowed sin clone). Para evitar copias innecesarias, los
+    /// callers que sólo necesitan derivar `.trim()` o `.is_empty()`
+    /// pueden hacerlo directo sobre el `String` devuelto.
+    pub fn text(&self) -> String {
+        self.inner.text()
+    }
+
+    pub fn is_empty(&self) -> bool {
+        self.inner.is_empty()
+    }
+
+    pub fn is_masked(&self) -> bool {
+        self.masked
+    }
+
+    pub fn clear(&mut self) {
+        self.inner.set_text("");
+    }
+
+    pub fn set_text(&mut self, s: impl Into<String>) {
+        let s = s.into();
+        self.inner.set_text(&s);
+    }
+
+    pub fn push_str(&mut self, s: &str) {
+        let combined = format!("{}{}", self.inner.text(), s);
+        self.inner.set_text(&combined);
+    }
+
+    pub fn pop(&mut self) -> Option<char> {
+        let mut t = self.inner.text();
+        let ch = t.pop()?;
+        self.inner.set_text(&t);
+        Some(ch)
+    }
+
+    /// Aplica una tecla al estado. Devuelve `true` si cambió el contenido
+    /// **o** sólo se movió el cursor (cualquier cosa que requiera repintar).
+    pub fn apply_key(&mut self, event: &KeyEvent) -> bool {
+        self.inner.apply_key(event).touched()
+    }
+
+    /// Acceso de bajo nivel al editor interno — útil si el caller
+    /// quiere consultar cursor/selección o aplicar ops avanzadas.
+    pub fn editor(&self) -> &EditorState {
+        &self.inner
+    }
+    pub fn editor_mut(&mut self) -> &mut EditorState {
+        &mut self.inner
+    }
+}
+
+/// Compone el input box: borde de 1 px (rect padre coloreado), relleno
+/// interno, texto o placeholder, caret simulado al final si está focado.
+/// Click sobre el box emite `on_focus` (típicamente `Msg::Focus(Field)`).
+pub fn text_input_view<Msg: Clone + 'static>(
+    state: &TextInputState,
+    placeholder: &str,
+    focused: bool,
+    palette: &TextInputPalette,
+    on_focus: Msg,
+) -> View<Msg> {
+    let raw = state.text();
+    let is_empty = raw.is_empty();
+    let shown = if is_empty {
+        placeholder.to_string()
+    } else if state.masked {
+        "•".repeat(raw.chars().count())
+    } else {
+        raw
+    };
+    // El cambio de bg al focus ya transmite "este es el activo"; sin
+    // caret glyph (la fuente default rendea cuadrados de fallback).
+    let display = shown;
+    let text_color = if is_empty {
+        palette.fg_placeholder
+    } else {
+        palette.fg_text
+    };
+    let (bg, border) = if focused {
+        (palette.bg_focus, palette.border_focus)
+    } else {
+        (palette.bg, palette.border)
+    };
+
+    let inner = View::new(Style {
+        size: Size {
+            width: percent(1.0_f32),
+            height: percent(1.0_f32),
+        },
+        padding: Rect {
+            left: length(10.0_f32),
+            right: length(10.0_f32),
+            top: length(6.0_f32),
+            bottom: length(6.0_f32),
+        },
+        align_items: Some(AlignItems::Center),
+        ..Default::default()
+    })
+    .fill(bg)
+    .radius(3.0)
+    .text_aligned(display, 13.0, text_color, Alignment::Start);
+
+    View::new(Style {
+        size: Size {
+            width: percent(1.0_f32),
+            height: length(34.0_f32),
+        },
+        padding: Rect {
+            left: length(1.0_f32),
+            right: length(1.0_f32),
+            top: length(1.0_f32),
+            bottom: length(1.0_f32),
+        },
+        ..Default::default()
+    })
+    .fill(border)
+    .radius(4.0)
+    .on_click(on_focus)
+    .children(vec![inner])
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use llimphi_ui::{Key, KeyState, NamedKey};
+
+    fn key_press(key: Key, text: Option<&str>) -> KeyEvent {
+        KeyEvent {
+            key,
+            state: KeyState::Pressed,
+            text: text.map(|s| s.to_string()),
+            modifiers: Default::default(),
+            repeat: false,
+        }
+    }
+
+    #[test]
+    fn apply_key_inserts_printable_chars() {
+        let mut s = TextInputState::new();
+        let ev = key_press(Key::Character("a".into()), Some("a"));
+        assert!(s.apply_key(&ev));
+        assert_eq!(s.text(), "a");
+    }
+
+    #[test]
+    fn apply_key_backspace_pops() {
+        let mut s = TextInputState::new();
+        s.set_text("hola");
+        let ev = key_press(Key::Named(NamedKey::Backspace), None);
+        assert!(s.apply_key(&ev));
+        assert_eq!(s.text(), "hol");
+    }
+
+    #[test]
+    fn enter_ignorado_en_single_line() {
+        let mut s = TextInputState::new();
+        s.set_text("hola");
+        let enter = key_press(Key::Named(NamedKey::Enter), None);
+        assert!(!s.apply_key(&enter));
+        assert_eq!(s.text(), "hola");
+    }
+
+    #[test]
+    fn masked_state_is_masked() {
+        let s = TextInputState::masked();
+        assert!(s.is_masked());
+    }
+
+    #[test]
+    fn flecha_izquierda_mueve_cursor() {
+        // El refactor agrega esta capacidad — antes no había movimiento.
+        let mut s = TextInputState::new();
+        s.set_text("hola");
+        let arr = key_press(Key::Named(NamedKey::ArrowLeft), None);
+        assert!(s.apply_key(&arr));
+        assert_eq!(s.editor().cursor.caret.col, 3);
+    }
+
+    #[test]
+    fn push_str_y_pop_funcionan() {
+        let mut s = TextInputState::new();
+        s.push_str("hola");
+        assert_eq!(s.text(), "hola");
+        assert_eq!(s.pop(), Some('a'));
+        assert_eq!(s.text(), "hol");
+    }
+}