Vercel Labs выложила в открытый доступ UI SDK — за первый месяц репозиторий vercel-labs/ui собрал 6,3 тысячи звёзд при пяти контрибьюторах. Название намекает на очередной набор кнопок и модалок, но внутри совсем другая штука. Это headless-ядро @ui-sdk/core, куда вынесли сложную логику поведения без единой строчки CSS, чтобы ИИ-агенты не ломали доступность в кастомных компонентах.
Карточка проекта UI SDK от Vercel Labs (Источник: ui-sdk.dev)
Почему агентская вёрстка сыплется на мелочах
Попроси coding-агента собрать поле поиска с крестиком очистки или выпадающий список. Через полминуты на экране появится аккуратный компонент. А потом проверяешь его с клавиатуры — и магия заканчивается.
Пользователь набирает запрос, жмёт Tab и нажимает Enter на кнопке «Очистить». Поле обнуляется, кнопка исчезает из DOM, а фокус браузера проваливается в <body>. Чтобы напечатать новый запрос, приходится искать мышку. Вместе с фокусом сыплются ARIA-атрибуты (HTML-подсказки для скринридеров и клавиатуры), закрытие попапов по Escape и выделение.
Ядро @ui-sdk/core забирает эту рутину на себя: клавиатурную навигацию, фокус, выделение, закрытие, попапы, drag-and-drop и нужные ARIA-связки. Формат headless отдаёт только логику, а стили ты пишешь сам под любой дизайн.
Примитивы, слоты и скилл для агента
Подключается всё за две команды. Ставишь ядро с адаптером и даёшь агенту официальный скилл — файл с правилами SDK, чтобы модель писала по актуальному API, а не гадала.
# Вместо react подходят vue, svelte, solid или web
npm install @ui-sdk/react @ui-sdk/core
# Официальный скилл для ИИ-агента
npx skills@latest add vercel-labs/ui --skill ui-sdk
Дальше поведение описывается один раз через definePrimitive. Внутри три блока: состояние (state), методы (api) и слоты (slots) — именованные части компонента вроде поля ввода и кнопки очистки.
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 }),
// Если кнопка исчезнет, фокус вернётся в 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({
// Кнопка есть в DOM, пока поле не пустое
present: (state) => state.value !== "",
attrs: () => ({ type: "button" }),
press: ({ api }) => api.set(""),
bind: (el, part) => part.api.recovery.bind(el, part),
}),
}),
})
Вся соль — в createFocusRecovery внутри слота clear: когда кнопка пропадает после клика, фокус сам возвращается в input. В README шутят, что учить этот код не придётся — агенты освоят его сами. Но на ревью читать примитивы всё равно тебе.
Готовый файл search-field.ts подключается к React, Vue, Svelte, Solid и Web Components через createParts:
// Рендер того же примитива в 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>
)
}
В Vue, Svelte и Solid меняется только импорт адаптера. В @ui-sdk/web функция регистрирует теги <search-field>, <search-field-input> и <search-field-clear> с обёртками wrappedChild("input") и wrappedButton.
Бета-статус, требования и альтернативы
Проект открыт под Apache License 2.0, но живёт в публичной бете 0.1.0-beta.x по условиям Vercel beta terms: API может ломаться до 1.0.0. Адаптеры требуют свежих веток — React 19+, Vue 3.5+, Svelte 5.33+ и Solid 2.0, поэтому в старые проекты без апгрейда библиотека не встанет.
Если сравнивать с рынком, Radix UI и Base UI дают зрелые компоненты, но привязаны к React. Кросс-фреймворковые Zag.js и Ark UI строят готовые виджеты на конечных автоматах, а UI SDK предлагает конструктор низкоуровневых поведений под работу с агентом. Для прототипов на свежем стеке идея сильная, а для долгого продакшена разумнее дождаться релиза 1.0.


