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:
parent
7abc87a4f5
commit
70448f96a8
1 changed files with 53 additions and 21 deletions
74
CLAUDE.md
74
CLAUDE.md
|
|
@ -42,7 +42,7 @@ Es el repositorio centralizado con todas las normas de trabajo del equipo:
|
||||||
## INFORMACIÓN DEL PROYECTO
|
## INFORMACIÓN DEL PROYECTO
|
||||||
|
|
||||||
**Nombre:** zcatui
|
**Nombre:** zcatui
|
||||||
**Versión:** v2.1 - FEATURE COMPLETE + INNOVATIONS
|
**Versión:** v2.2 - FEATURE COMPLETE
|
||||||
**Última actualización:** 2025-12-08
|
**Última actualización:** 2025-12-08
|
||||||
**Lenguaje:** Zig 0.15.2
|
**Lenguaje:** Zig 0.15.2
|
||||||
**Inspiración:** [ratatui](https://github.com/ratatui/ratatui) + [crossterm](https://github.com/crossterm-rs/crossterm) (Rust)
|
**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
|
### Estadísticas
|
||||||
| Métrica | Valor |
|
| Métrica | Valor |
|
||||||
|---------|-------|
|
|---------|-------|
|
||||||
| Archivos fuente | 67 archivos .zig |
|
| Archivos fuente | 70+ archivos .zig |
|
||||||
| Widgets | 34 widgets |
|
| Widgets | 35 widgets |
|
||||||
| Módulos core | 20 módulos |
|
| Módulos core | 30+ módulos |
|
||||||
| Tests | 250+ tests |
|
| Tests | 186+ tests |
|
||||||
| Examples | 11 demos ejecutables |
|
| Examples | 20 demos ejecutables |
|
||||||
|
|
||||||
### Funcionalidades Principales
|
### Funcionalidades Principales
|
||||||
- ✅ Renderizado immediate-mode con double buffering y diff
|
- ✅ 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
|
- ✅ Terminal capability detection
|
||||||
- ✅ Lazy rendering con cache
|
- ✅ 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
|
### Nuevos en v2.1
|
||||||
- ✅ **Spinner** - Indicadores de carga animados (17 estilos)
|
- ✅ **Spinner** - Indicadores de carga animados (17 estilos)
|
||||||
- ✅ **Help** - Auto-genera ayuda de keybindings
|
- ✅ **Help** - Auto-genera ayuda de keybindings
|
||||||
|
|
@ -213,12 +227,24 @@ zcatui/
|
||||||
│ │ ├── progress.zig # Progress (ETA, speed) [NEW v2.1]
|
│ │ ├── progress.zig # Progress (ETA, speed) [NEW v2.1]
|
||||||
│ │ ├── markdown.zig # Markdown renderer [NEW v2.1]
|
│ │ ├── markdown.zig # Markdown renderer [NEW v2.1]
|
||||||
│ │ ├── dirtree.zig # DirectoryTree [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 ───
|
||||||
│ └── tests/ # Test suite
|
│ └── tests/ # Test suite
|
||||||
│
|
│
|
||||||
├── examples/ # 11 demos
|
├── examples/ # 20 demos
|
||||||
├── docs/ # ARCHITECTURE.md, WIDGETS.md, API.md
|
├── docs/ # ARCHITECTURE.md, WIDGETS.md, API.md
|
||||||
├── build.zig
|
├── build.zig
|
||||||
├── README.md
|
├── README.md
|
||||||
|
|
@ -321,7 +347,8 @@ git.reugenio.com (Forgejo)
|
||||||
|
|
||||||
| Versión | Fecha | Cambios |
|
| 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 |
|
| v2.0 | 2025-12-08 | Focus, themes, unicode, termcap, 186+ tests |
|
||||||
| v1.4 | 2025-12-08 | Form widgets, panels, scroll, tree |
|
| v1.4 | 2025-12-08 | Form widgets, panels, scroll, tree |
|
||||||
| v1.3 | 2025-12-08 | Menus, modals, animation, clipboard |
|
| v1.3 | 2025-12-08 | Menus, modals, animation, clipboard |
|
||||||
|
|
@ -332,23 +359,28 @@ git.reugenio.com (Forgejo)
|
||||||
|
|
||||||
## ESTADO ACTUAL
|
## 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)
|
- ✅ 35 widgets implementados
|
||||||
- ✅ Todos los tests pasando (250+)
|
- ✅ 30+ módulos core
|
||||||
- ✅ Manual técnico completo (docs/TECHNICAL_REFERENCE.md)
|
- ✅ Todos los tests pasando (186+)
|
||||||
- ✅ Examples funcionando
|
- ✅ 20 demos ejecutables
|
||||||
- ✅ Flex Layout CSS-like
|
- ✅ Documentación completa
|
||||||
- ✅ Testing Framework para widgets
|
- ✅ build.zig.zon para package manager
|
||||||
- ✅ Theme hot-reload desde archivos
|
|
||||||
- ✅ Widget serialization (JSON, undo/redo)
|
**Nuevas capacidades en v2.2:**
|
||||||
- ✅ Accessibility básico (ARIA roles, announcements)
|
- ✅ 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):**
|
**Posibles mejoras futuras (opcionales):**
|
||||||
- Performance: SIMD para buffer
|
- Performance: SIMD para buffer
|
||||||
- Más examples específicos de v2.1 widgets
|
|
||||||
- Tutorial paso a paso
|
- Tutorial paso a paso
|
||||||
- Publicación en package registry
|
- Publicación en Zig package registry
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue