Skip to content

Releases

zuix 0.2.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 16:58
97cc55d

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-subtle sube 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-border pasa de --z-line (1.2:1) a --z-fg al 50 % (3:1, WCAG 1.4.11) y
    --z-control-border-hover a --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-accent al 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-hover oscurece 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-muted pasa de 0.72 a 0.80, fg-muted de
    0.70 a 0.74 y el cristal de 0.66 a 0.82 de opacidad. Marca dazlabs, 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-text y
    --z-info-text: el color de marca o de estado mezclado con --z-fg hasta 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-solid y --z-info-solid:
    fondos sobre los que --z-fg-on-accent llega 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-below y
    --z-layer-raised, para el apilamiento local dentro de un componente.
  • prefers-contrast: more: fg-muted pasa a fg, líneas y bordes de control se refuerzan y el cristal y el
    degradado del fondo se vuelven opacos (sección moreContrast de src/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ón forcedColors).
  • 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,
    unidades em y ch) 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 de scale que no existen. El contraste se mide sobre
    la matriz completa de texto por superficie, sobre los pares reales de las hojas de zui y zout (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.css y ./css/zutool.css explí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 contraste NaN, que no es menor que ningún
    umbral y pasaba. Un valor llamado constructor o __proto__ ya no lanza una excepción.
  • tailwind.css: la variante dark: sigue al tema de los tokens también sin data-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, sin innerHTML.
  • onIconsRegistered(fn): avisa cuando se registran iconos.

Corregido

  • iconSvg no lanza con un label o un className que 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: el display: contents en línea ganaba al atributo.
  • iconSvg() reduce variant a outline o solid y escapa los trazados: ningún valor llega al marcado sin
    escapar.
  • Icon con aria-label o aria-labelledby, sin label, ya no lleva aria-hidden.
  • size en iconSvg(), 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 atributo size bloqueaban la página unos doce segundos. Un size de más de 32 caracteres, o
    que no es número ni cadena, vale 16.
  • iconSvg() escapa también la comilla simple (&#39;) y el valor de width y height, y no lanza si
    name, label o className llegan sin ser cadenas desde JavaScript sin tipos.
  • sprite.svg oculta su raíz con el atributo display="none" en lugar de style: 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, ConfirmDialog y CommandPalette de React pintan un <dialog> abierto con
    showModal() (antes un div[role=dialog] y un div.z-overlay-scrim aparte). La clase z-overlay-scrim
    y sus modificadores desaparecen
    : el velo es dialog::backdrop. Un selector .z-modal[role=dialog] pasa
    a dialog.z-modal. Sin title, el nombre va en aria-label (antes un h2.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|y y --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 id radix-….
  • 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] (antes ol y li). toast() del modo DOM genera el mismo div. La
    región solo existe mientras hay avisos.
  • Menús de React: cada entrada es un button[role=menuitem] (antes div), el separador lleva
    role="separator" y el atributo data-elevated desaparece: todo va en la capa superior.
  • Popover modal de React es un <dialog> abierto con showModal() (antes un div[role=dialog]). Un
    selector .z-popover[role=dialog] pasa a dialog.z-popover para el modal; el no modal sigue siendo un
    div.
  • Select de React: role="listbox" va en .z-listbox__viewport, dentro de .z-listbox, y las opciones
    llevan data-value. Con name o required, el campo de formulario es un <select> nativo oculto
    (.z-native-input), no un input[type=hidden].
  • Checkbox, Switch y Radio: el campo nativo oculto lleva la clase z-native-input (antes estilos en
    línea) y está siempre en el marcado. RadioGroup y SegmentedControl ya no llevan dir ni tabindex en
    el grupo.
  • Tabs: los ids son …-tab-<valor> y …-panel-<valor>; cada pestaña lleva data-value.
  • Accordion: la cabecera es un h2…h6 real según headingLevel (antes h3 con aria-level); el
    contenido de una sección cerrada sigue montado, oculto con hidden...
Read more

zuix 0.1.0

Choose a tag to compare

@devzucca devzucca released this 15 Nov 05:01

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 con schema/brand.schema.json, y
    dos temas (dark, light).
  • Salidas generadas en dist/: tokens.css (todas las marcas, elegidas con data-brand y data-theme),
    brands/<marca>.css (una sola marca), tailwind.css, docusaurus.css y tokens.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. Vale 0px y pasa a 40px bajo
    @media (pointer: coarse) (sección coarse de src/base.json, que también sale en tokens.json).
    --z-control-height-sm y --z-control-height-md valen max(30px, …) y max(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 de tokens.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 declarativo compat/<proyecto>.json validado con
    schema/compat.schema.json. source.env del 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ánea compat/<proyecto>.inventory.json, que no se publica.
  • README.md en 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 con currentColor.
  • @zuccadev-labs/zuix-zicon: componente Icon de React con el set completo registrado.
  • @zuccadev-labs/zuix-zicon/core: Icon y 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/all registra el set completo.
  • @zuccadev-labs/zuix-zicon/dom: iconSvg(), iconPaths() y defineIconElement(), sin React.
  • @zuccadev-labs/zuix-zicon/element: define <z-icon name variant size label> con el set completo.
  • sprite.svg (#nombre y #nombre-solid) y un archivo por icono en svg/outline/ y svg/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.md en 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á en manifest.json.
  • Contrato HTML: clases z-*, atributos de estado (data-state, data-size, aria-*) y el marcado de cada
    ejemplo en html.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. Eventos z:open, z:close, z:change, z:select y z:sort.
  • @zuccadev-labs/zuix-zui: binding de React 19 sobre Radix. React es un peer opcional: el contrato y dom no lo usan.
  • @zuccadev-labs/zuix-zicon es peerDependency: la aplicación lo instala junto a este paquete y hay una sola copia
    del registro de iconos.
  • dist/zui.css y dist/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 con carousel(el, { rasterize }). Cae a
    css sin WebGL2 o si falta una imagen. carousel(el).refresh() rehace réplicas y texturas.
  • @zuccadev-labs/zuix-zui/dom/carousel-gl y dist/zui.dom.carousel-gl.js: los shaders, que @zuccadev-labs/zuix-zui/dom carga bajo
    demanda. zui.dom.js no los incluye.
  • README.md en el paquete publicado.

Táctil

  • Objetivo táctil de 40 px. Con puntero principal grueso (@media (pointer: coarse)) los controles sm y md
    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: 0px lo desactiva.
  • Sin hover pegajoso. Todas las reglas :hover van 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-toast declara touch-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 emite contextmenu, 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 (con PageHeader, PageSection, Container, Stack, Inline) y Grid. La lista con props, tokens
    y clases está en manifest.json.
  • Contrato HTML de cada layout en html.json y estilos en @zuccadev-labs/zuix-zout/styles.css (capa zout; requiere
    antes los tokens y @zuccadev-labs/zuix-zui/styles.css).
  • @zuccadev-labs/zuix-zout/dom: Shell responsive, ResizeHandle, SplitPane, TabStrip y secciones de Sidebar sin
    framework.
  • @zuccadev-labs/zuix-zout: binding de React 19. React es un peer opcional.
  • @zuccadev-labs/zuix-zicon es peerDependency: la aplicación lo instala junto a este paquete y hay una sola copia
    del registro de iconos.
  • dist/zout.css y dist/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.md en el paquete publicado.

Táctil

  • Con puntero principal grueso (@media (pointer: coarse)), la zona de agarre de ResizeHandle y de los divisores
    de SplitPane crece hasta --z-touch-target (40 px) sin cambiar la línea dibujada, y las pestañas de
    TabStrip y su botón de alta llegan a ese alto. Los botones de TitleBar, Rail y Sidebar crecen con los
    tokens de control.
  • Todas las reglas :hover van 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-zui y @zuccadev-labs/zuix-zout y 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 nombres zui, zout y zicon.
  • react y react-dom 19 son peers opcionales: solo los necesitan /zui, /zout, /zicon, /zicon/core y
    la entrada raíz.