From 70448f96a8172aea4ae544109e42cd0fafc426f6 Mon Sep 17 00:00:00 2001 From: reugenio Date: Mon, 8 Dec 2025 22:47:36 +0100 Subject: [PATCH] docs: Update CLAUDE.md for v2.2 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Version bump v2.1 → v2.2 - Add v2.2 features section (13 new modules) - Update statistics (70+ files, 20 demos) - Update project structure with v2.2 modules - Update history and current state sections 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 74 +++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 53 insertions(+), 21 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 56dd5bb..ffbbb10 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -42,7 +42,7 @@ Es el repositorio centralizado con todas las normas de trabajo del equipo: ## INFORMACIÓN DEL PROYECTO **Nombre:** zcatui -**Versión:** v2.1 - FEATURE COMPLETE + INNOVATIONS +**Versión:** v2.2 - FEATURE COMPLETE **Última actualización:** 2025-12-08 **Lenguaje:** Zig 0.15.2 **Inspiración:** [ratatui](https://github.com/ratatui/ratatui) + [crossterm](https://github.com/crossterm-rs/crossterm) (Rust) @@ -54,11 +54,11 @@ Es el repositorio centralizado con todas las normas de trabajo del equipo: ### Estadísticas | Métrica | Valor | |---------|-------| -| Archivos fuente | 67 archivos .zig | -| Widgets | 34 widgets | -| Módulos core | 20 módulos | -| Tests | 250+ tests | -| Examples | 11 demos ejecutables | +| Archivos fuente | 70+ archivos .zig | +| Widgets | 35 widgets | +| Módulos core | 30+ módulos | +| Tests | 186+ tests | +| Examples | 20 demos ejecutables | ### Funcionalidades Principales - ✅ Renderizado immediate-mode con double buffering y diff @@ -75,6 +75,20 @@ Es el repositorio centralizado con todas las normas de trabajo del equipo: - ✅ Terminal capability detection - ✅ Lazy rendering con cache +### Nuevos en v2.2 +- ✅ **ResizeHandler** - Detección SIGWINCH de redimensión de terminal +- ✅ **DragState/Splitter** - Mouse drag & drop, paneles redimensionables +- ✅ **Diagnostic** - Mensajes de error estilo Elm con snippets +- ✅ **DebugOverlay** - Overlay de debug (FPS, timing, widgets) +- ✅ **Profiler** - Profiling de rendimiento con timers +- ✅ **SixelEncoder** - Codificación Sixel para imágenes +- ✅ **AsyncLoop** - Event loop async con epoll y timers +- ✅ **Compose** - Utilidades de composición de widgets +- ✅ **Shortcuts** - Registro de atajos de teclado +- ✅ **Logo** - Widget de logo ASCII art +- ✅ **Layout.ratio()** - Constraint proporcional +- ✅ **build.zig.zon** - Soporte package manager + ### Nuevos en v2.1 - ✅ **Spinner** - Indicadores de carga animados (17 estilos) - ✅ **Help** - Auto-genera ayuda de keybindings @@ -213,12 +227,24 @@ zcatui/ │ │ ├── progress.zig # Progress (ETA, speed) [NEW v2.1] │ │ ├── markdown.zig # Markdown renderer [NEW v2.1] │ │ ├── dirtree.zig # DirectoryTree [NEW v2.1] -│ │ └── syntax.zig # SyntaxHighlighter [NEW v2.1] +│ │ ├── syntax.zig # SyntaxHighlighter [NEW v2.1] +│ │ └── logo.zig # Logo ASCII art [NEW v2.2] +│ │ +│ ├── ─── V2.2 MODULES ─── +│ ├── resize.zig # SIGWINCH resize detection [NEW v2.2] +│ ├── drag.zig # DragState, Splitter [NEW v2.2] +│ ├── diagnostic.zig # Elm-style errors [NEW v2.2] +│ ├── debug.zig # Debug overlay [NEW v2.2] +│ ├── profile.zig # Performance profiler [NEW v2.2] +│ ├── sixel.zig # Sixel encoding [NEW v2.2] +│ ├── async_loop.zig # Async epoll loop [NEW v2.2] +│ ├── compose.zig # Widget composition [NEW v2.2] +│ └── shortcuts.zig # Shortcut registry [NEW v2.2] │ │ │ └── ─── TESTS ─── │ └── tests/ # Test suite │ -├── examples/ # 11 demos +├── examples/ # 20 demos ├── docs/ # ARCHITECTURE.md, WIDGETS.md, API.md ├── build.zig ├── README.md @@ -321,7 +347,8 @@ git.reugenio.com (Forgejo) | Versión | Fecha | Cambios | |---------|-------|---------| -| v2.1 | 2025-12-08 | 7 nuevos widgets, Flex Layout, Testing Framework, Theme Hot-Reload, Serialization, Accessibility, 250+ tests | +| v2.2 | 2025-12-08 | 13 módulos nuevos: resize, drag, diagnostic, debug, profile, sixel, async_loop, compose, shortcuts, logo, build.zig.zon | +| v2.1 | 2025-12-08 | 7 nuevos widgets, Flex Layout, Testing Framework, Theme Hot-Reload, Serialization, Accessibility | | v2.0 | 2025-12-08 | Focus, themes, unicode, termcap, 186+ tests | | v1.4 | 2025-12-08 | Form widgets, panels, scroll, tree | | v1.3 | 2025-12-08 | Menus, modals, animation, clipboard | @@ -332,23 +359,28 @@ git.reugenio.com (Forgejo) ## ESTADO ACTUAL -**El proyecto está FEATURE COMPLETE + INNOVATIONS (v2.1)** +**El proyecto está FEATURE COMPLETE (v2.2)** -- ✅ 34 widgets implementados (7 nuevos en v2.1) -- ✅ Todos los tests pasando (250+) -- ✅ Manual técnico completo (docs/TECHNICAL_REFERENCE.md) -- ✅ Examples funcionando -- ✅ Flex Layout CSS-like -- ✅ Testing Framework para widgets -- ✅ Theme hot-reload desde archivos -- ✅ Widget serialization (JSON, undo/redo) -- ✅ Accessibility básico (ARIA roles, announcements) +- ✅ 35 widgets implementados +- ✅ 30+ módulos core +- ✅ Todos los tests pasando (186+) +- ✅ 20 demos ejecutables +- ✅ Documentación completa +- ✅ build.zig.zon para package manager + +**Nuevas capacidades en v2.2:** +- ✅ Terminal resize detection (SIGWINCH) +- ✅ Mouse drag & drop, splitter panels +- ✅ Elm-style diagnostic messages +- ✅ Debug overlay (FPS, timing) +- ✅ Performance profiling +- ✅ Sixel graphics encoding +- ✅ Async event loop (epoll) **Posibles mejoras futuras (opcionales):** - Performance: SIMD para buffer -- Más examples específicos de v2.1 widgets - Tutorial paso a paso -- Publicación en package registry +- Publicación en Zig package registry ---