Si llegaste desde Unpispas Guide → Libraries → upp-konva, esta subsite es la documentación propiedad de la librería bajo /upp-konva/. El hub principal del sitio enlaza aquí.
@unpispas/upp-konva
Biblioteca Angular para planos de sala (restauración y análogos): un host incrusta un lienzo Konva que solo se carga dentro del paquete. La aplicación suministra modelo y DTO en centímetros; no importa Konva en código de producto.
Paquete independiente: no depende de otras librerías @unpispas/*. El mapeo desde catálogo, POS o API propia hacia UppKonvaAreaSource (filas con kind) es trabajo de integración en tu feature.
Bundlers: el paquete declara sideEffects: true para que no se elimine la cadena que registra los pintores Konva. Si se tree-shakea, muchas figuras quedan solo con el rectángulo de hit invisible.
Fuera de alcance: usuarios, permisos y RBAC. La app decide active, mode y qué UI mostrar.
Integración del lienzo
| Selector | Modelo | Filas en DTO |
|---|---|---|
upp-konva | UppKonvaModel | kind (UppKonvaShapeSource) |
El motor Konva y el host interno upp-konva-floor-plan viven dentro del paquete y no forman parte del API público. La guía del integrador y la API del modelo (TypeDoc) describen plantillas, streams RxJS y persistencia.
Dónde seguir leyendo
| Página | Contenido |
|---|---|
| Integrator guide | Plantilla upp-konva, UppKonvaModel, onGrouped$, documento JSON, tipos de fila. |
| Public model API | Referencia TypeDoc (JSDoc) de lib/model/: clases, DTO, streams, grupo. |
| Host implementation | Cableado interno host ↔ modelo ↔ stage (mantenedores). |
| Lab demo | Cómo ejecutar la demo del monorepo. |
| Package README | Mismo contenido que libs/upp-konva/README.md (dependencias y manual rápido). |
Código en el monorepo
| Ruta | Rol |
|---|---|
libs/upp-konva/src/lib/model/ | API viva: UppKonvaModel, UppKonvaArea, figuras, DTO. |
libs/upp-konva/src/lib/component/ | UppKonvaComponent (upp-konva). |
libs/upp-konva/src/lib/stage/ | Motor Konva, hosts, serialización de documento (interno salvo exports acordados). |
libs/upp-konva/demo/ | Demo de laboratorio (@unpispas/upp-konva-demo). |
libs/upp-konva/src/lib/**/doc/ y libs/upp-konva/demo/doc/ | Páginas narrativas de esta subsite (se copian a src/doc/docs/ al construir). |
libs/upp-konva/src/doc/ | Configuración Docusaurus, cobertura (MDX) y salida TypeDoc (docs/model-api/). |
Especificaciones funcionales (español): libs/upp-konva/src/lib/stage/presentation/upp-floor-plan-presentation.mdc, libs/upp-konva/src/lib/stage/canvas/upp-floor-plan.mdc.