Сборка 0.1.0-alpha · в разработке

UI-компоненты для Nuxt — предсказуемые и лёгкие

Личный UI-бандл вместо тяжёлых библиотек: обычные утилитарные классы, тема на CSS-переменных в три уровня, одна runtime-зависимость. Работает в Tailwind 3 и Tailwind 4 из одного пака.

3
уровня темы
3+4TW
Tailwind из одного пака
1
runtime-зависимость
Nuxt 4Vue 3.5TypeScriptTailwind 3Tailwind 4tailwind-mergevue-component-metavitestMCPNuxt 4Vue 3.5TypeScriptTailwind 3Tailwind 4tailwind-mergevue-component-metavitestMCP

Возможности

Что внутри skob-ui

Три кита: тема трёх уровней, поддержка двух мажоров Tailwind из одного пака и дока, которая собирается из кода компонентов.

Тема

Три уровня кастомизации

Словари внутри компонентов → глобальный файл темы потребителя → :ui-проп при вызове. tailwind-merge решает конфликты утилит, обычный class работает как обычно.

Уровень 1 · словари в компоненте

primaryghostdanger

Уровень 2 · файл темы потребителя

nuxt.config
skobUi: { theme: { skButton: { slots: { root: 'rounded-full' } } } }

Уровень 3 · :ui-проп при вызове

vue
<SkButton :ui="{ root: 'w-full' }">Ок</SkButton>

Совместимость

Tailwind 3 и 4 из одного пака

У проектов владельца есть и TW3, и TW4 — пак обязан работать в обоих. Значения токенов живут в CSS-переменных, смена скина — без пересборки.

bg
bg-warm
card
sidebar

Один и тот же клас-набор в TW3 (theme.extend) и TW4 (@theme): значения живут в CSS-переменных --sk-*.

Документация

Сайт и MCP из одного манифеста

JSDoc в коде компонента — обязательная дока. Скрипт собирает манифест, из него кормятся сайт, MCP-сервер и README-таблицы. Дока не может разойтись с кодом.

SFC + JSDocmanifest.json
Сайт документацииMCP-сервер

Один источник правды: vue-component-meta вытаскивает пропсы/события/слоты и JSDoc-текст, манифест кормит сайт, MCP и README.

Состав

Дорожная карта компонентов

Компоненты принимаются в сборку по одному: сначала витрина на этом сайте, потом твоя правка — и только потом npm-релиз.

Этап 0 · Фундамент

готово
  • Nuxt-модуль — регистрация компонентов, префикс, автоимпорт
  • Тема на CSS-переменных — токены, TW3 + TW4, 3 уровня темы
  • Манифест — vue-component-meta → JSON: дока для сайта и MCP

Этап 1 · Ядро форм

в работе
  • SkButton — варианты и размеры, :ui-проп
  • SkInput / SkTextarea / SkLabel — v-model, валидационный вид
  • SkCheckbox / SkToggle — переключатели
  • SkSelect + SkOption — составной, provide/inject

Этап 2 · Оверлеи

в плане
  • SkDialog — focus-trap + стек
  • SkConfirmDialog + useSkConfirm — подтверждения
  • SkPopover / SkTooltip — позиционирование
  • SkToaster + useSkToast — уведомления
  • SkDrawer — боковая панель

Этап 3 · Данные и навигация

в плане
  • SkTable — семейство: table + item
  • SkTabs / SkPagination / SkBadge — навигация и статусы
  • SkAlert / SkCard / SkSpinner / SkStatCard — витрина данных
  • SkSegmented / SkRating — выбор и оценка

Этап 4 · Расширенные формы

в плане
  • SkMultiSelect — множественный выбор
  • SkEmailInput / SkPhoneInput — маски и валидация
  • SkColorPicker — выбор цвета

Этап 5 · Пикеры

в плане · обязательный этап
  • SkDatePicker — самый жирный у донора — идёт последним
  • SkTimePicker — пара к дате

Быстрый старт

Два шага до первой темы

Пак подключается как Nuxt-модуль: тема, токены и source-пути он добавляет сам.

1 · установить
pnpm add skob-ui
# или: npm i skob-ui
2 · подключить модуль
// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['skob-ui']
})

Принципы

Три правила пака

skob-ui пишется как для публичной библиотеки, хотя живёт в личных проектах.

1

Лёгкий

Одна runtime-зависимость — tailwind-merge. Исходники .vue в дистрибутиве, компилирует Tailwind потребителя. Никаких прекомпилов и тяжёлых бандлов.

2

Предсказуемый

Обычные утилитарные классы из дизайн-токенов, никаких arbitrary-значений. Один радиус, одна шкала текста, единые состояния — компоненты выглядят семьёй.

3

Свой

Тема настраивается владельцем: токены → файл темы → :ui-проп. Никаких «пресетов из коробки» — только то, что ты сам решил.

FAQ

Частые вопросы

Личный: владелец один, решения принимаются без компромиссов под «широкую аудиторию». Компоненты добавляются по мере надобности, код и дока — как у публичной библиотеки. Легче, предсказуемее, без тяжёлой настройки.
Компоненты используют обычные утилитарные классы со значениями-переменными (bg-primary-500 → var(--sk-primary-500)). Для TW3 модуль подключает плагин theme.extend, для TW4 — вколачивает @theme и @source. Один пак, два мажора.

Три уровня: дефолтные словари внутри компонентов; глобальный файл темы у потребителя (токены + словари по слотам); :ui-проп при вызове. Смена скина — правка CSS-переменных без пересборки. Попробуй переключателем в шапке.

vue
<SkButton :ui="{ root: 'w-full rounded-none' }">
  Точечная правка слота
</SkButton>
SkIcon с подключаемым набором и сабсетами: в пак кладутся только используемые иконки, архитектура позволяет подменить набор темой. Дефолтный набор решается после первого компонента с иконкой.
Этот сайт — витрина из манифеста компонентов. Для агентов — MCP-сервер (stdio в паке и HTTP на этом домене): sk_list_components, sk_get_component, sk_search, sk_get_tokens, sk_get_setup. Дока и сайт кормятся из одного манифеста.