UI SDK de Vercel Labs: comportamientos headless para componentes creados por agentes de IANota · digest del 22 de noviembre
Corte isométrico de la arquitectura de UI SDK separando la lógica del núcleo headless, los slots de componentes y la recuperación automática del foco
Nota3 secciones≈ 5 min

UI SDK de Vercel Labs: comportamientos headless para componentes creados por agentes de IA

Vercel Labs publicó en código abierto UI SDK, y en su primer mes el repositorio vercel-labs/ui reunió 6,300 estrellas con apenas cinco colaboradores. El nombre suena a otro paquete más de botones y modales, pero por dentro es algo muy distinto. Se trata de un núcleo headless llamado @ui-sdk/core, donde aislaron la lógica compleja de interacción sin una sola línea de CSS para que los agentes de IA no rompan la accesibilidad en componentes personalizados.

Tarjeta del proyecto UI SDK de Vercel Labs (Fuente: ui-sdk.dev)

Por qué el maquetado de los agentes falla en los detalles

Pídele a un agente de programación que construya un campo de búsqueda con botón de limpiar o una lista desplegable. En medio minuto tendrás un componente prolijo en pantalla. Luego lo pruebas con el teclado y se acaba la magia.

El usuario escribe una consulta, pulsa Tab y presiona Enter sobre el botón «Limpiar». El campo se vacía, el botón desaparece del DOM y el foco del navegador cae al <body>. Para escribir una nueva búsqueda toca buscar el ratón. Junto con el foco se rompen los atributos ARIA (pistas HTML para lectores de pantalla y teclado), el cierre de popups con Escape y la selección.

El núcleo @ui-sdk/core asume esa rutina: navegación por teclado, gestión del foco, selección, cierre, ventanas emergentes, drag-and-drop y las relaciones ARIA necesarias. Al ser headless, entrega solo el comportamiento; tú escribes los estilos para cualquier sistema de diseño.

Primitivas, slots y una skill para el agente

Se integra con dos comandos. Instalas el núcleo junto al adaptador y entregas al agente la skill oficial, un archivo con las reglas del SDK para que el modelo escriba según la API actual en lugar de adivinar.

# En lugar de react sirven vue, svelte, solid o web
npm install @ui-sdk/react @ui-sdk/core

# Skill oficial para el agente de IA
npx skills@latest add vercel-labs/ui --skill ui-sdk

Después el comportamiento se define una sola vez con definePrimitive. Dentro hay tres bloques: estado (state), métodos (api) y ranuras (slots), que representan partes con nombre del componente como el campo de entrada y el botón de limpiar.

import { createFocusRecovery, definePrimitive } from "@ui-sdk/core"

export const searchField = definePrimitive({
  name: "search-field",
  state: () => ({ value: "" }),
  api: (ctx) => ({
    set: (value: string) => ctx.store.set({ value }),
    // Si el botón desaparece, el foco vuelve al input
    recovery: createFocusRecovery({
      fallback: () => ctx.element("input"),
    }),
  }),
  slots: (slot) => ({
    input: slot({
      attrs: (state) => ({ value: state.value }),
      on: {
        input: (e, { api }) =>
          api.set((e.target as HTMLInputElement).value),
      },
    }),
    clear: slot({
      // El botón existe en el DOM mientras el campo no esté vacío
      present: (state) => state.value !== "",
      attrs: () => ({ type: "button" }),
      press: ({ api }) => api.set(""),
      bind: (el, part) => part.api.recovery.bind(el, part),
    }),
  }),
})

La clave está en createFocusRecovery dentro del slot clear: cuando el botón desaparece tras el clic, el foco regresa solo al input. En el README bromean con que no hace falta aprender este código porque los agentes lo dominarán solos. Aun así, en la revisión de código te tocará leer las primitivas.

El archivo search-field.ts ya listo se conecta a React, Vue, Svelte, Solid y Web Components mediante createParts:

// Renderizado de la misma primitiva en React
import { createParts } from "@ui-sdk/react/primitive"
import { searchField } from "./search-field"

const parts = createParts(searchField, { input: "input", clear: "button" })
const { Root, Input, Clear } = parts

export function Search() {
  return (
    <Root>
      <Input placeholder="Search" />
      <Clear>Clear</Clear>
    </Root>
  )
}

En Vue, Svelte y Solid solo cambia la importación del adaptador. En @ui-sdk/web, la función registra las etiquetas <search-field>, <search-field-input> y <search-field-clear> usando los envoltorios wrappedChild("input") y wrappedButton.

Estado beta, requisitos y alternativas

El proyecto está publicado bajo Apache License 2.0, pero vive en beta pública 0.1.0-beta.x bajo los términos beta de Vercel: la API puede cambiar con rupturas hasta la 1.0.0. Los adaptadores exigen ramas recientes (React 19+, Vue 3.5+, Svelte 5.33+ y Solid 2.0), así que no encajará en proyectos antiguos sin actualizar dependencias.

Frente al mercado, Radix UI y Base UI ofrecen componentes maduros pero atados a React. Los multi-framework Zag.js y Ark UI construyen widgets completos sobre máquinas de estado, mientras que UI SDK propone un constructor de comportamientos de bajo nivel pensado para trabajar con agentes. Para prototipos sobre un stack moderno la idea es potente; para producción a largo plazo es más prudente esperar a la versión 1.0.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 5