openpencil/packages/docs/es/guide/tech-stack.md
2026-03-09 17:43:11 +03:00

70 lines
3.3 KiB
Markdown

# Stack tecnológico
## Tecnologías principales
| Capa | Tecnología | Por qué |
|------|-----------|---------|
| **Renderizado** | Skia CanvasKit WASM | Mismo motor que Figma — rendimiento probado, acelerado por GPU, píxel-perfecto |
| **Framework UI** | Vue 3 + VueUse | API de composición reactiva, excelente soporte TypeScript |
| **Componentes** | Reka UI | Primitivas UI headless y accesibles (tree, slider, etc.) |
| **Estilado** | Tailwind CSS 4 | Utility-first, iteración rápida, tema oscuro |
| **Layout** | Yoga WASM | Motor CSS flexbox de Meta, probado en React Native |
| **Formato de archivo** | Kiwi binario + Zstd | Formato propio de Figma — compacto, parseo rápido, compatible con .fig |
| **Colaboración** | Trystero + Yjs | P2P WebRTC vía señalización MQTT, sync CRDT, persistencia y-indexeddb |
| **Color** | culori | Conversiones de espacio de color (HSV, RGB, hex) |
| **IA/MCP** | MCP SDK + Hono | 90+ herramientas para codificación IA, transportes stdio + HTTP |
| **JSX Transform** | Sucrase | 201 KB JSX → JS, síncrono, compatible con navegador |
| **Eventos** | nanoevents | 108 bytes, emisor de eventos tipado para mutaciones de SceneGraph |
| **JSX Transform** | Sucrase | 201 KB JSX → JS, síncrono, compatible con navegador |
| **Eventos** | nanoevents | 108 bytes, emisor de eventos tipado para mutaciones de SceneGraph |
| **Desktop** | Tauri v2 | ~5 MB app nativa (vs ~100 MB de Electron), backend Rust |
| **Build** | Vite 7 | HMR rápido, módulos ES nativos |
| **Testing** | Playwright + bun:test | Regresión visual (E2E) + tests unitarios rápidos |
| **Linting** | oxlint | Basado en Rust, órdenes de magnitud más rápido que ESLint |
| **Formateo** | oxfmt | Formateador basado en Rust |
| **Verificación de tipos** | typescript-go (tsgo) | Implementación nativa en Go del verificador de tipos TypeScript |
## Dependencias principales
```json
{
"canvaskit-wasm": "^0.40.0",
"vue": "^3.5.29",
"yoga-layout": "npm:@open-pencil/yoga-layout@3.3.0-grid.2",
"nanoevents": "^9.1.0",
"sucrase": "^3.35.1",
"reka-ui": "^2.8.2",
"tailwindcss": "^4.2.1",
"culori": "^4.0.2",
"fzstd": "^0.1.1",
"fflate": "^0.8.2",
"trystero": "^0.20.0",
"yjs": "^13.6.24",
"y-indexeddb": "^9.0.12"
}
```
## ¿Por qué no...
### ¿Por qué no renderizado SVG?
SVG es lento para documentos complejos. Cada nodo es un elemento DOM — 10.000 nodos significan 10.000 elementos DOM con overhead de layout, pintado y composición. CanvasKit dibuja todo en una única superficie GPU.
### ¿Por qué no Electron (como Figma desktop)?
Tauri v2 usa el webview del sistema (~5 MB) en lugar de empaquetar Chromium (~100 MB). El backend Rust proporciona rendimiento nativo para E/S de archivos e integración con el sistema.
### ¿Por qué no React?
El proyecto migró de React a Vue 3 tempranamente. El sistema de reactividad de Vue y los composables de VueUse resultaron más ergonómicos.
### ¿Por qué no un motor de layout propio?
Yoga es mantenido por Meta, probado en miles de millones de dispositivos React Native e implementa la especificación CSS flexbox.
## Tecnologías planificadas
| Tecnología | Propósito | Fase |
|-----------|---------|-------|
| CSS Grid en Yoga | Auto layout basado en grid | ✅ Incluido vía [fork de Yoga](https://github.com/open-pencil/yoga/tree/grid) (`@open-pencil/yoga-layout`) |