docs: Update CLAUDE.md for v2.2

- 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 <noreply@anthropic.com>
This commit is contained in:
reugenio 2025-12-08 22:47:36 +01:00
parent 7abc87a4f5
commit 70448f96a8

View file

@ -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
---