UI SDK от Vercel Labs — библиотека поведения интерфейсов, а не готовая тема оформления. Она помогает собирать клавиатурную навигацию, фокус, выбор и всплывающие элементы. Красивую композицию, типографику и анимацию по-прежнему нужно проектировать отдельно. Ниже — как разделить эти задачи при работе с ИИ и не получить эффектный, но неудобный сайт.
Что находится внутри UI SDK
В официальном репозитории центральный пакет называется @ui-sdk/core. Поведения соединяются в примитивы, а адаптеры связывают их с React, Vue, Svelte, Solid или Web Components. В README проект обозначен как beta: перед внедрением нужно проверять текущий API и совместимость с приложением.
Представь поиск в каталоге. Визуально это строка, крестик и список. Но пользователю нужны разные действия: ввод, очистка, переход к результату, возврат фокуса. Если после нажатия на исчезающую кнопку очистки фокус теряется, красивый внешний вид проблему не решает. Именно на такие механизмы направлен UI SDK.
Это также не библиотека анимации. Она не заменяет CSS transitions, Web Animations API или GSAP. Не стоит устанавливать её ради появления заголовка при прокрутке.
Как выбрать инструмент под задачу
| Задача | От чего начать | Что проверить |
|---|---|---|
| Переход на страницу | Обычная ссылка | Адрес, новая вкладка, доступное имя |
| Раскрытие ответа | Кнопка и состояние раскрытия | Клавиатура, скрытая панель, expanded |
| Сложный выбор из списка | Примитив поведения | Стрелки, выбор, disabled, возврат фокуса |
| Появление секции | CSS или GSAP | Reduced motion, видимость без JavaScript |
| Дизайн лендинга | Сетка, текст, типографика | Иерархия, мобильная версия, следующий шаг |
Начинай с самого простого решения, которое полностью закрывает сценарий. Нативная кнопка уже умеет активироваться клавиатурой; самодельный кликабельный div потребует дополнительной работы. Библиотека оправданна там, где комбинация состояний становится сложнее.
Установка и задача для ИИ
Для React upstream показывает такую команду:
npm install @ui-sdk/react @ui-sdk/core
Навык разработчиков проекта устанавливается отдельно:
npx skills add vercel-labs/ui --skill ui-sdk
Перед запуском посмотри зависимости и инструкции в документации UI SDK. Файл навыка объясняет агенту подход, а npm-пакеты добавляют код в приложение. Это разные действия. Установка навыка не означает, что интерфейс уже переписан или протестирован.
Вместо запроса «сделай красивый dropdown» дай агенту конкретный сценарий:
Сделай выбор направления в существующей форме. Сначала проверь, достаточно ли нативного select. Если нужен составной компонент, изучи текущий UI SDK. Пользователь должен выбрать вариант клавиатурой, закрыть список Escape и вернуться к элементу управления. Сохрани отправляемое значение и покажи, как проверил поведение.
Этот запрос задаёт результат, не навязывая лишнюю зависимость. После реализации пройди сценарий самостоятельно: Tab до элемента, открытие, смена варианта, закрытие, повторное открытие. Отдельно проверь пустое состояние и ошибку загрузки вариантов, если список приходит с сервера.
Как мы разделили задачи в ZASLON
Для обновления нашего маркетингового сайта используются CSS и GSAP: композиция первых экранов, карточки сценариев и появление блоков. UI SDK runtime в сайт не добавлялся. В ZASLON Interface Kit включена инструкция по выбору и интеграции библиотеки там, где она действительно нужна.
В нашем наборе нет копии исходного кода UI SDK. Это отдельный оригинальный навык Кальтера с рекомендациями по дизайну, движению и проверке поведения. Исходный проект Vercel Labs распространяется под Apache-2.0; собственные инструкции набора — под MIT. У подключаемых библиотек сохраняются свои условия.
Ошибки, которые стоит поймать до релиза
Фокус потерялся после действия. Проверь, не удаляется ли активная кнопка из DOM. Нужен понятный следующий элемент, а не прыжок в начало документа.
Анимация скрыла содержание. Если текст изначально имеет opacity: 0 и открывается только скриптом, ошибка JavaScript может оставить пустой экран. Основной контент должен оставаться доступным.
Тестировали только мышью. Hover не заменяет клавиатуру, а красивое состояние не доказывает правильность ARIA. Для составных компонентов полезно сверяться с паттернами WAI-ARIA.
Назвали интерфейс доступным после одного теста. Ручной проход проверяет выбранный сценарий, а не всё соответствие стандарту. Запиши проверенные устройства, состояния и ограничения.
Частые вопросы
UI SDK сам сделает сайт красивым?
Нет. Он отвечает за поведение. Внешний вид зависит от композиции, текста, цветов, шрифтов и состояния компонентов.
Нужно ли переписывать весь готовый сайт?
Нет. Выбери один сложный компонент, сравни стоимость интеграции с текущим решением и проверь результат перед расширением.
Можно просто дать ИИ ссылку на эту статью?
Да. Попроси прочитать статью и инструкцию набора на GitHub, затем применить подход к конкретному проекту. Ссылка передаёт контекст, но не устанавливает плагин автоматически.
Если хочешь научиться собирать такие интерфейсы и проверять работу агентов в своих проектах, посмотри программу MK Ultra.
