Repository navigation
Releases
zuix 0.2.0
Versión 0.2.0 de la suite. Los cinco paquetes comparten número.
| Paquete | npm |
|---|---|
@zuccadev-labs/zuix-tokens |
0.2.0 |
@zuccadev-labs/zuix-zicon |
0.2.0 |
@zuccadev-labs/zuix-zui |
0.2.0 |
@zuccadev-labs/zuix-zout |
0.2.0 |
@zuccadev-labs/zuix |
0.2.0 |
npm install @zuccadev-labs/zuix@0.2.0
@zuccadev-labs/zuix-tokens
Ningún token se elimina ni se renombra. Cambian valores para cumplir el contraste de WCAG 2.2 AA, que ahora
se mide sobre los pares de color que las hojas usan de verdad. Qué revisar en una aplicación está en la
guía de actualización.
Cambios incompatibles
- Node 22.12 o posterior (antes, 20). Node 20 terminó su soporte el 2026-04-30.
--z-fg-subtlesube de opacidad en todas las marcas y temas para llegar a 4.5:1 como texto (oscuro: de
0.48 a entre 0.52 y 0.60; claro: de 0.50 a entre 0.59 y 0.64).--z-control-borderpasa de--z-line(1.2:1) a--z-fgal 50 % (3:1, WCAG 1.4.11) y
--z-control-border-hovera--z-fg-muted: los campos de formulario tienen un borde más marcado.--z-accent-ring(y con él--z-focus-ring) pasa de--z-accental 45 % (entre 1.4 y 2.2:1) a
--z-accent-text, opaco: el anillo de foco llega a 3:1 sobre cualquier superficie.--z-accent-solid-hoveroscurece en lugar de aclarar, para conservar 4.5:1 con el texto blanco.- Marca
zutool, tema oscuro: el degradado del fondo se atenúa (el texto blanco de la barra de título
quedaba a 2.5:1 sobre sus manchas claras; ahora 6.6:1),canvas-fg-mutedpasa de 0.72 a 0.80,fg-mutedde
0.70 a 0.74 y el cristal de 0.66 a 0.82 de opacidad. Marcadazlabs, tema oscuro: cristal de 0.66 a 0.72.
Son ajustes de valor dentro de la intención de cada token, pero cambian el aspecto de forma visible: por eso
van aquí.
Añadido
- Tokens de texto
--z-accent-text,--z-success-text,--z-warning-text,--z-danger-texty
--z-info-text: el color de marca o de estado mezclado con--z-fghasta llegar a 4.5:1 sobre todas las
superficies y sobre su propio fondo suave (-soft).--z-accent,--z-success… quedan para rellenos,
bordes, iconos e indicadores (3:1). - Tokens de fondo sólido
--z-success-solid,--z-warning-solid,--z-danger-solidy--z-info-solid:
fondos sobre los que--z-fg-on-accentllega a 4.5:1 en los dos temas, como ya hacía--z-accent-solid. - Tokens de escala
--z-space-1-5(6 px) y--z-space-2-5(10 px), y de capa--z-layer-belowy
--z-layer-raised, para el apilamiento local dentro de un componente. prefers-contrast: more:fg-mutedpasa afg, líneas y bordes de control se refuerzan y el cristal y el
degradado del fondo se vuelven opacos (secciónmoreContrastdesrc/base.json, también en
tokens.json).forced-colors: active: se retiran el degradado del fondo y el destello del cristal, que el sistema no
fuerza (secciónforcedColors).- Salida en formato Design Tokens (DTCG 2025.10):
@zuccadev-labs/zuix-tokens/dtcg/<marca>.<tema>.tokens.json,
un archivo autocontenido por marca y tema. Lo que el formato no expresa (clamp(),max(), degradados,
unidadesemych) va con su valor CSS en$extensions. - Validación al generar: cada marca se comprueba contra
schema/brand.schema.json; se detectan referencias
circulares, tokens que solo define un tema y claves descaleque no existen. El contraste se mide sobre
la matriz completa de texto por superficie, sobre los pares reales de las hojas dezuiyzout(texto
4.5:1; gráficos y bordes de control 3:1) y sobre el foco, componiendo las superficies translúcidas sobre
los extremos del degradado del fondo. Un par que no se puede resolver es un error. tailwind.css: utilidades para los tokens nuevos (text-accent-text,bg-success-solid…).- Entradas
./css/dazlabs.css,./css/zenith.cssy./css/zutool.cssexplícitas, además del comodín.
Corregido
- Validación de contraste: un color con un número que no lo es (
rgb(0 0 1e999), un porcentaje..%en
color-mix()) se rechaza como valor ilegible. Antes daba un contrasteNaN, que no es menor que ningún
umbral y pasaba. Un valor llamadoconstructoro__proto__ya no lanza una excepción. tailwind.css: la variantedark:sigue al tema de los tokens también sindata-theme, cuando manda el
sistema.- El umbral de la luminancia relativa usa el valor de WCAG 2.2 (0,04045).
@zuccadev-labs/zuix-zicon
Cambios incompatibles
- Node 22.12 o posterior (antes, 20). Node 20 terminó su soporte el 2026-04-30.
Añadido
iconElement(name, opciones)en@zuccadev-labs/zuix-zicon/dom: el icono como elemento SVG construido con
el DOM, sininnerHTML.onIconsRegistered(fn): avisa cuando se registran iconos.
Corregido
iconSvgno lanza con unlabelo unclassNameque no se puede convertir a texto (un objeto sin
prototipo): lo trata como vacío.<z-icon>funciona con Trusted Types (require-trusted-types-for 'script'): dibuja con el DOM, no con
innerHTML.<z-icon>conectado antes de registrar su icono se dibuja al registrarlo. Antes quedaba vacío para
siempre.<z-icon hidden>se oculta: eldisplay: contentsen línea ganaba al atributo.iconSvg()reducevariantaoutlineosolidy escapa los trazados: ningún valor llega al marcado sin
escapar.Iconconaria-labeloaria-labelledby, sinlabel, ya no llevaaria-hidden.sizeeniconSvg(),iconElement()y<z-icon>se valida en tiempo lineal. La expresión anterior
retrocedía de forma cuadrática con una cadena larga de cifras seguida de un carácter inválido: 80 000
caracteres en el atributosizebloqueaban la página unos doce segundos. Unsizede más de 32 caracteres, o
que no es número ni cadena, vale 16.iconSvg()escapa también la comilla simple (') y el valor dewidthyheight, y no lanza si
name,labeloclassNamellegan sin ser cadenas desde JavaScript sin tipos.sprite.svgoculta su raíz con el atributodisplay="none"en lugar destyle: incrustado en una página
con una política de seguridad de contenido sin estilos en línea, sigue oculto.- La generación valida cada icono (trazados dentro de la caja, identificador de módulo único y no reservado,
categoría existente) y que el sprite no repita ids.
@zuccadev-labs/zuix-zui
Esta versión trae cambios incompatibles. Qué hay que tocar en una aplicación está en la
guía de actualización.
El paquete ya no depende de ninguna biblioteca de UI: radix-ui se retira y el binding de React usa
primitivas propias sobre la plataforma (<dialog>, Popover API), con la misma lógica que
@zuccadev-labs/zuix-zui/dom. En ejecución solo necesita @zuccadev-labs/zuix-tokens;
@zuccadev-labs/zuix-zicon es un peer obligatorio y React y React DOM 19, peers opcionales. Un proyecto que
solo usa el contrato HTML y zui/dom deja de instalar los más de setenta paquetes que llegaban por esa
dependencia.
Cambios incompatibles
Entorno:
- Node 22.12 o posterior (antes, 20). Node 20 terminó su soporte el 2026-04-30.
- Navegadores admitidos: Chrome y Edge 116, Firefox 125, Safari 17 y Safari de iOS 18.3. Lo marca la Popover
API.
Marcado y CSS:
Modal,Drawer,ConfirmDialogyCommandPalettede React pintan un<dialog>abierto con
showModal()(antes undiv[role=dialog]y undiv.z-overlay-scrimaparte). La clasez-overlay-scrim
y sus modificadores desaparecen: el velo esdialog::backdrop. Un selector.z-modal[role=dialog]pasa
adialog.z-modal. Sintitle, el nombre va enaria-label(antes unh2.z-sr-only).- Variables CSS renombradas:
--radix-select-trigger-width→--z-anchor-width;
--radix-*-content-available-height→--z-available-height;--radix-*-content-available-width→
--z-available-width;--radix-toast-swipe-move-x|yy--radix-toast-swipe-end-x|y→
--z-toast-swipe-…;--radix-accordion-content-height→--z-accordion-content-height. No queda ningún
--radix-*,data-radix-*ni idradix-…. - Toast de React: la región es
div.z-toast-viewport[role=region]con nombre y cada aviso un
div.z-toast[role=status|alert](antesolyli).toast()del modo DOM genera el mismodiv. La
región solo existe mientras hay avisos. - Menús de React: cada entrada es un
button[role=menuitem](antesdiv), el separador lleva
role="separator"y el atributodata-elevateddesaparece: todo va en la capa superior. Popover modalde React es un<dialog>abierto conshowModal()(antes undiv[role=dialog]). Un
selector.z-popover[role=dialog]pasa adialog.z-popoverpara el modal; el no modal sigue siendo un
div.Selectde React:role="listbox"va en.z-listbox__viewport, dentro de.z-listbox, y las opciones
llevandata-value. Connameorequired, el campo de formulario es un<select>nativo oculto
(.z-native-input), no uninput[type=hidden].Checkbox,SwitchyRadio: el campo nativo oculto lleva la clasez-native-input(antes estilos en
línea) y está siempre en el marcado.RadioGroupySegmentedControlya no llevandirnitabindexen
el grupo.Tabs: los ids son…-tab-<valor>y…-panel-<valor>; cada pestaña llevadata-value.Accordion: la cabecera es unh2…h6real segúnheadingLevel(antesh3conaria-level); el
contenido de una sección cerrada sigue montado, oculto conhidden...
zuix 0.1.0
Versión 0.1.0 de la suite. Los cinco paquetes comparten número.
| Paquete | npm |
|---|---|
@zuccadev-labs/zuix-tokens |
0.1.0 |
@zuccadev-labs/zuix-zicon |
0.1.0 |
@zuccadev-labs/zuix-zui |
0.1.0 |
@zuccadev-labs/zuix-zout |
0.1.0 |
@zuccadev-labs/zuix |
0.1.0 |
npm install @zuccadev-labs/zuix@0.1.0
@zuccadev-labs/zuix-tokens
Primera versión publicada.
Añadido
- Contrato de tokens
--z-*en tres niveles: escala, semánticos y de componente. - Marcas como archivos en
brands/(una marca es un archivo), validadas conschema/brand.schema.json, y
dos temas (dark,light). - Salidas generadas en
dist/:tokens.css(todas las marcas, elegidas condata-brandydata-theme),
brands/<marca>.css(una sola marca),tailwind.css,docusaurus.cssytokens.json. - Validación al generar: tokens obligatorios por marca y tema, y contraste WCAG.
- Token de escala
--z-touch-target: objetivo táctil mínimo. Vale0pxy pasa a40pxbajo
@media (pointer: coarse)(seccióncoarsedesrc/base.json, que también sale entokens.json).
--z-control-height-smy--z-control-height-mdvalenmax(30px, …)ymax(36px, …)sobre ese token: con
ratón, 30 y 36 px; con el dedo como puntero principal, 40 px. Para desactivarlo:
:root { --z-touch-target: 0px }después detokens.css. - Capas de compatibilidad (
@zuccadev-labs/zuix-tokens/compat/<proyecto>.css): las variables antiguas de un
proyecto como alias de tokens, generadas desde un mapa declarativocompat/<proyecto>.jsonvalidado con
schema/compat.schema.json.source.envdel mapa es el nombre de una variable de entorno
(ZUIX_COMPAT_<PROYECTO>_ROOT) con la ruta del proyecto: el mapa no contiene rutas de la máquina de quien
lo escribió. Sin la variable se usa la instantáneacompat/<proyecto>.inventory.json, que no se publica. README.mden el paquete publicado.
@zuccadev-labs/zuix-zicon
Primera versión publicada.
Añadido
- 346 iconos en dos variantes (
outline,solid), caja de 24 × 24, color heredado concurrentColor. @zuccadev-labs/zuix-zicon: componenteIconde React con el set completo registrado.@zuccadev-labs/zuix-zicon/core:Icony el registro (registerIcons,getIcon,registeredIconNames) sin datos, para
incluir solo los iconos que se usen.@zuccadev-labs/zuix-zicon/icons/<nombre>: un módulo por icono.@zuccadev-labs/zuix-zicon/allregistra el set completo.@zuccadev-labs/zuix-zicon/dom:iconSvg(),iconPaths()ydefineIconElement(), sin React.@zuccadev-labs/zuix-zicon/element: define<z-icon name variant size label>con el set completo.sprite.svg(#nombrey#nombre-solid) y un archivo por icono ensvg/outline/ysvg/solid/.manifest.json: nombre, categoría y palabras clave en inglés y español de cada icono, y 152 emojis
mapeados a su icono.dist/zicon.element.js:<z-icon>listo para enlazar sin bundler.- Tipo
IconName: un nombre que no existe no compila. - Salida de publicación: ESM compilado módulo a módulo con declaraciones en
dist/esm/. README.mden el paquete publicado.
@zuccadev-labs/zuix-zui
Primera versión publicada.
Añadido
- 64 componentes en 8 grupos: acciones (5), formularios (17), datos (11), estado (7), contenido (7),
capas (9), navegación (7) y Carousel. La lista con props, tokens y clases está enmanifest.json. - Contrato HTML: clases
z-*, atributos de estado (data-state,data-size,aria-*) y el marcado de cada
ejemplo enhtml.json, generado desde el binding de React. - Estilos sobre tokens
--z-*:@zuccadev-labs/zuix-zui/styles.css(todo) y@zuccadev-labs/zuix-zui/styles/<grupo>.css. Material
liquid glass (.z-liquid,.z-solid). @zuccadev-labs/zuix-zui/dom: comportamiento sin framework. Diálogos, popovers, menús, menú contextual, tooltips,
avisos, confirmación, pestañas, acordeón, controles de formulario, Select, Combobox, Calendar,
DatePicker, Slider, OTPInput, FileUpload, CommandPalette, Tree, orden de DataTable, Pagination y
Carousel. Eventosz:open,z:close,z:change,z:selectyz:sort.@zuccadev-labs/zuix-zui: binding de React 19 sobre Radix. React es un peer opcional: el contrato ydomno lo usan.@zuccadev-labs/zuix-ziconespeerDependency: la aplicación lo instala junto a este paquete y hay una sola copia
del registro de iconos.dist/zui.cssydist/zui.dom.js: listos para enlazar sin bundler.- Salida de publicación: ESM compilado módulo a módulo con declaraciones en
dist/esm/, y"use client"
en los módulos con estado, eventos o Radix. - Carousel sin React en modo
gl: las zonas curvas se dibujan en WebGL2 cuando cada slide declara su imagen
(data-raster,data-raster="#selector",data-raster-src) o concarousel(el, { rasterize }). Cae a
csssin WebGL2 o si falta una imagen.carousel(el).refresh()rehace réplicas y texturas. @zuccadev-labs/zuix-zui/dom/carousel-glydist/zui.dom.carousel-gl.js: los shaders, que@zuccadev-labs/zuix-zui/domcarga bajo
demanda.zui.dom.jsno los incluye.README.mden el paquete publicado.
Táctil
- Objetivo táctil de 40 px. Con puntero principal grueso (
@media (pointer: coarse)) los controlessmymd
crecen hasta--z-touch-target(40 px; token de@zuccadev-labs/zuix-tokens): botones, campos, Select, pestañas,
filas de árbol y de menú, opciones de lista. Checkbox, Radio y Switch ganan aire vertical, el Slider crece en
su eje corto, y los botones de cierre (.z-overlay-close,.z-alert__dismiss), el botón del campo y las
opciones de SegmentedControl amplían su zona de pulsación sin cambiar el dibujo. Con ratón nada cambia.
--z-touch-target: 0pxlo desactiva. - Sin hover pegajoso. Todas las reglas
:hovervan dentro de@media (hover: hover): en una pantalla táctil
el último control tocado no se queda con el estilo de hover. @zuccadev-labs/zuix-zui/dom: los avisos (toast()) se descartan deslizando, con dedo, lápiz o ratón, igual que el Toast de
React (a la derecha, o hacia el borde en las posiciones centradas)..z-toastdeclaratouch-action. Al
descartarlo, el aviso conserva el desplazamiento mientras se desvanece.@zuccadev-labs/zuix-zui/dom: el menú contextual (data-z-context) se abre con una pulsación larga de 600 ms con dedo o
lápiz. iOS no emitecontextmenu, y un Chromium de escritorio con pantalla táctil tampoco. El menú sigue
abierto al levantar el dedo.- ContextMenu de React en ventanas estrechas: si el menú no cabe a ningún lado del puntero, se estrecha hasta
el hueco disponible en lugar de salirse de la ventana.
@zuccadev-labs/zuix-zout
Primera versión publicada.
Añadido
- 10 layouts:
Shell,Rail,SidePanel,Sidebar,SplitPane,TabStrip,TitleBar,ResizeHandle,
Page(conPageHeader,PageSection,Container,Stack,Inline) yGrid. La lista con props, tokens
y clases está enmanifest.json. - Contrato HTML de cada layout en
html.jsony estilos en@zuccadev-labs/zuix-zout/styles.css(capazout; requiere
antes los tokens y@zuccadev-labs/zuix-zui/styles.css). @zuccadev-labs/zuix-zout/dom:Shellresponsive,ResizeHandle,SplitPane,TabStripy secciones deSidebarsin
framework.@zuccadev-labs/zuix-zout: binding de React 19. React es un peer opcional.@zuccadev-labs/zuix-ziconespeerDependency: la aplicación lo instala junto a este paquete y hay una sola copia
del registro de iconos.dist/zout.cssydist/zout.dom.js: listos para enlazar sin bundler.- Salida de publicación: ESM compilado módulo a módulo con declaraciones en
dist/esm/, y"use client"
en los módulos con estado o eventos. README.mden el paquete publicado.
Táctil
- Con puntero principal grueso (
@media (pointer: coarse)), la zona de agarre deResizeHandley de los divisores
deSplitPanecrece hasta--z-touch-target(40 px) sin cambiar la línea dibujada, y las pestañas de
TabStripy su botón de alta llegan a ese alto. Los botones deTitleBar,RailySidebarcrecen con los
tokens de control. - Todas las reglas
:hovervan dentro de@media (hover: hover): sin hover pegajoso en pantallas táctiles.
@zuccadev-labs/zuix
Primera versión publicada.
Añadido
- Paquete paraguas: instala
@zuccadev-labs/zuix-tokens,@zuccadev-labs/zuix-zicon,
@zuccadev-labs/zuix-zuiy@zuccadev-labs/zuix-zouty los reexporta bajo subrutas (/zui,/zui/dom,/zout,
/zout/dom,/zicon,/zicon/core,/zicon/dom,/zicon/element,/zicon/all,/styles.css,
/tokens.css). La entrada raíz exporta los espacios de nombreszui,zoutyzicon. reactyreact-dom19 son peers opcionales: solo los necesitan/zui,/zout,/zicon,/zicon/corey
la entrada raíz.