UI SDK от Vercel Labs: headless-поведения для компонентов, которые собирают ИИ-агентыЗаметка · дайджест за 22 ноября
Изометрический разрез архитектуры UI SDK с разделением логики headless-ядра, слотов компонентов и автоматического возврата фокуса
Заметка3 раздела≈ 4 мин

UI SDK от Vercel Labs: headless-поведения для компонентов, которые собирают ИИ-агенты

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.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 5