Saltar al contenido principal

Componentes de referencia

Notas del 2026-11-12, antes de construir zui. Qué miré para decidir qué componentes hacer y cómo: un carousel propio que quería rescatar, las bibliotecas que tenía apuntadas como inspiración y el código que ya tenía escrito en otros proyectos.

Sale de la página de presentación del proyecto de origen (privado; no cito su nombre ni su ruta). Quería traerlo a la suite sin su dominio.

ArchivoLíneasPapel
Componente principal953Estado, gestos, animación, accesibilidad
lensRenderer.ts396Dibujo WebGL2 de las zonas curvas
cardRaster.ts216Copia cada tarjeta HTML a una textura
lens.ts146Geometría pura de la lente

Comportamiento​

  • Tira infinita con tres copias del contenido.
  • El centro queda plano y los bordes se curvan en S, con ampliación horizontal y refracción.
  • Arrastre con inercia y avance ligado al desplazamiento de la página.
  • Flechas, contador y anuncio para lectores de pantalla.

Modos de dibujo​

ModoCuándoCómo
glHay WebGL2 y las texturas cargaronCentro en HTML real; bordes en WebGL
cssSin WebGL2 o mientras cargaCada tarjeta se deforma con matrix3d
flatprefers-reduced-motionTira plana sin animación

Acoplamientos que tenía​

  • Una biblioteca de animación para la inercia y el desplazamiento.
  • Los iconos y las clases del proyecto de origen, y un tipo de datos de su dominio.
  • React 18.

Cómo lo extraje​

PlanResultado
Un Carousel base: pista, bucle, arrastre, ajuste, teclado y anuncioszui/src/components/carousel/, con el motor en un módulo sin React (engine.ts) que también usa el modo sin framework
El efecto lente como capa opcional; lens.ts tal cualeffect="lens" o "none". La geometría pura se quedó casi igual y tiene pruebas unitarias
Contenido por slotsrenderItem: la tarjeta la define quien lo usa
Estilos sobre tokens de la suiteHecho; sin la biblioteca de animación ni dependencias del dominio

Lo que no traje: el cursor propio y la apertura de la tarjeta a pantalla de sección, que eran de aquella página.

B. Las referencias que tenía apuntadas​

Tenía apuntados unos enlaces a bibliotecas que me parecían bien resueltas. Estaban en un archivo suelto en la raíz del repositorio; los dejo aquí, que es donde tienen sentido.

ReferenciaQué esQué me aportó
Shark UIBiblioteca de componentes con tokens semánticos para varios frameworksLista de control de qué es un "sistema completo"
NeonBlade UIComponentes de React con estética neón, por CLI o copiar y pegarEfectos y variantes
Dot MatrixColección de loaders de matriz de puntos, distribuida como registro copiableLa idea de un paquete de loaders, que no he hecho
remocnComponentes de movimiento para vídeo programáticoMovimiento para vídeo, no interfaz de aplicación
ArrowJSUn framework reactivo mínimo, sin paso de compilaciónLa alternativa a React que consideré para el núcleo
Radix PrimitivesPrimitivos headless accesibles para ReactLa capa de lógica de zui en la 0.1.0. La sustituí en la 0.2.0 (Primitivas propias)

Qué hice con ellas​

No copié código de ninguna. Me sirvieron de catálogo y de vara de medida: qué componentes tiene un sistema completo y cómo se comporta cada uno. Los componentes de zui están reimplementados sobre los tokens de la suite. Copiar código habría exigido revisar la licencia de cada una, y varias no la declaran con claridad en su página.

Dos de ellas distribuyen sus componentes como un registro del que el código se copia al proyecto y se edita. Lo consideré para los componentes con estilo de zui y al final lo distribuí todo por npm, con versión (cómo quedó cada decisión).

De la 0.1.0 queda una deuda reconocida con una de estas referencias: la zona de gracia del puntero en los submenús sigue la técnica de Radix Primitives, con código propio. Su aviso de licencia está en THIRD_PARTY_NOTICES.md, dentro de zui.

C. Código propio que ya existía​

FuenteQué aportó
zutool: apps/desktop/src/ui/primitivesPrimitivos liquid glass y un Popover
zutool: apps/desktop/src/ui/layoutEl shell: rail, sidebar, área principal, inspector, cajones
zutool: apps/desktop/src/styles/zutool.cssPestañas, paneles divididos, divisores, cabecera de panel
analizador-trafico: packages/ui-glassPanel de cristal, StatTile, Badge, DataTable
El design system del proyecto de origenButton, Input, Select, DateInput, Card, Avatar, Badge, Modal, Spinner, Tooltip, Toast, Skeleton, EmptyState, ErrorState, Rating

No traje los componentes de dominio de ese design system (pagos, reservas, clima, visor 3D, chat).